✨ feat(all): fix issues and update builder

docs/guide/builder/index.md

@@ -57,7 +57,10 @@ All of these options are available with the `backan-builder` command by adding t
 ```ts
 type BuilderParams = {
  /**
-  * The input file for the build process.
+  * The app server input file.
+  *
+  * The input can be provided without an extension. 
+  * If the extension is omitted, the system will automatically look for the following extensions: `.ts`, `.js`, `.mjs`, `.mts`.
   */
  input: string, 
  /**
@@ -104,7 +107,7 @@ export type BuilderSchemaParams = {
  /**
   * The instance of the Backan application used to generate the OpenAPI schema.
   */
- app: App<object>,
+ app: App<Env>,
  /**
   * The path where the resulting `json` file will be saved.
   */
@@ -131,7 +134,7 @@ type BuilderMDParams = {
  /**
   * The instance of the Backan application used to generate the OpenAPI schema.
   */
- app: App<object>,
+ app: App<Env>,
  /**
   * The path where the resulting `Markdown` file will be saved.
   */

packages/backan/CHANGELOG.md

@@ -1,5 +1,12 @@
 # backan
 
+## 0.0.15
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @backan/core@0.0.15
+
 ## 0.0.14
 
 ### Patch Changes

packages/backan/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "backan",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"type": "module",
 	"license": "GPL-3.0",
 	"homepage": "https://backan.pigeonposse.com",

packages/builder/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @backan/builder
 
+## 0.0.15
+
+### Patch Changes
+
+- fix issues and update builder for detect input without extensions
+
 ## 0.0.14
 
 ## 0.0.13

packages/builder/examples/app.ts

@@ -1,5 +1,7 @@
 import { App } from '@backan/core'
-export const app = new App( {
+
+type AppEnv = {DB: object}
+export const app = new App<AppEnv>( {
 	version     : '1.0.0',
 	title       : 'BACKAN Example app',
 	description : 'API documentation for BACKAN Example',

packages/builder/examples/build.ts

@@ -1,9 +1,8 @@
-import { resolve } from 'node:path'
-import { build }   from '../src/main'
+import { build } from '../src/main'
 // import { build } from '../dist/main'
 
 build( {
-	input : resolve( 'examples/server.ts' ),
+	input : 'examples/server',
 	// name   : 'backan',
 	// outDir : resolve( 'build' ),
 	// type   : 'all',

packages/builder/examples/md.ts

@@ -1,6 +1,7 @@
 import { buildMD } from '../src/md'
 import { app }     from './app'
+
 buildMD( {
 	app    : app,
-	output : 'example-openapi.md',
+	output : 'openapi.md',
 } )

packages/builder/examples/schema.ts

@@ -1,6 +1,7 @@
 import { buildSchema } from '../src/schema'
 import { app }         from './app'
+
 buildSchema( {
-	app    : app,
-	output : 'example-openapi.json',
+	app,
+	output : 'openapi.json',
 } )

packages/builder/examples/server.ts

@@ -1,11 +1,6 @@
-import { App }    from '@backan/core'
-import { server } from '@backan/server'
 
-export const app = new App( {
-	version     : '1.0.0',
-	title       : 'BACKAN Example app',
-	description : 'API documentation for BACKAN Example',
-} )
+import { server } from '@backan/server'
+import { app }    from './app'
 
 server( {
 	app,

packages/builder/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@backan/builder",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"type": "module",
 	"license": "GPL-3.0",
 	"homepage": "https://backan.pigeonposse.com/",

packages/builder/src/main.ts

@@ -77,7 +77,7 @@ export const buildConstructor = async ( {
 	if( flags.onlyOs ) onlyOs = flags.onlyOs
 	if( flags.outDir ) outDir = flags.outDir
 	if( flags.type && Object.values( BUILDER_TYPE ).includes( flags.type ) ) type = flags.type 
-	
+
 	if( !name ) name = getFilename( input )
 
 	const opts = {
@@ -128,8 +128,34 @@ export const buildConstructor = async ( {
 	}, null, 2 ) )
 
 	// EXIST INPUT
-	const exists = await existsPath( input )
+	const getInput = async ( path: string ) => {
+
+		const validExtensions = [
+			'.ts', '.js', '.mjs', '.mts',
+		]
+
+		if( !validExtensions.some( ext => path.endsWith( ext ) ) ){
+
+			for ( let index = 0; index < validExtensions.length; index++ ) {
+
+				const input = path + validExtensions[index]
+
+				const exists = await existsPath( input )
+				if( exists ) return input
+
+			}
+			return undefined
+
+		}
+		const exists = await existsPath( path )
+		if( exists ) return path
+		return undefined
+
+	}
+
+	const exists = await getInput( input )
 	if( !exists ) throw new BuildError( ERROR_ID.NO_INPUT, data )
+	else input = exists
 
 	if( plat === 'unknown' ) throw new BuildError( ERROR_ID.PLATFORM_UNKWON, data )
 

packages/builder/src/md.ts

@@ -18,7 +18,7 @@ import type { BuilderMDParams } from './types'
  * @throws {Error} Throws an error if any of the operations fail, including schema generation, file execution, or file removal.
  * @see https://backan.pigeonposse.com/guide/builder/
  */
-export const buildMD = async ( { app, output }: BuilderMDParams ) => {
+export const buildMD = async <Env extends object>( { app, output }: BuilderMDParams<Env> ) => {
 
 	try {
 

packages/builder/src/schema.ts

@@ -12,7 +12,7 @@ import type { BuilderSchemaParams } from './types'
  * @throws {Error} Throws an error if there is a problem during the file writing operation.
  * @see https://backan.pigeonposse.com/guide/builder/
  */
-export const buildSchema = async ( { app, output }: BuilderSchemaParams ) => {
+export const buildSchema = async <Env extends object> ( { app, output }: BuilderSchemaParams<Env> ) => {
 
 	try{
 

packages/builder/src/types.ts

@@ -4,31 +4,35 @@ import type {
 	ERROR_ID, 
 } from './const'
 
-export type BuilderMDParams = {
+export type BuilderMDParams<Env extends object> = {
 	/**
 	 * The instance of the Backan application used to generate the OpenAPI schema.
 	 */
-	app: App<object>,
+	app: App<Env>,
 	/**
 	 * The path where the resulting `Markdown` file will be saved.
 	 */
 	output: string 
 }
-export type BuilderSchemaParams = {
+export type BuilderSchemaParams<Env extends object> = {
 	/**
 	 * The instance of the Backan application used to generate the OpenAPI schema.
 	 */
-	app: App<object>,
+	app: App<Env>,
 	/**
 	 * The path where the resulting `json` file will be saved.
 	 */
 	output: string 
 }
+
 export type BuilderParams = {
 	/**
-	 * The input file for the build process or app.
+	 * The app server input file.
+	 *
+	 * The input can be provided without an extension. 
+	 * If the extension is omitted, the system will automatically look for the following extensions: `.ts`, `.js`, `.mjs`, `.mts`.
 	 */
-	input: string , 
+	input: string, 
 	/**
 	 *
 	 */

packages/core/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @backan/core
 
+## 0.0.15
+
+### Patch Changes
+
+- fix issues and update builder for detect input without extensions
+
 ## 0.0.14
 
 ## 0.0.13

packages/core/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@backan/core",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"type": "module",
 	"license": "GPL-3.0",
 	"homepage": "https://backan.pigeonposse.com",

packages/core/src/lib/super.ts

@@ -66,6 +66,7 @@ export class AppSuper<Env extends object> {
 
 		},
 	}
+
 	protected app = new OpenAPIHono<Env>( {
 		defaultHook : ( res, c ) => {
 

packages/create/CHANGELOG.md

@@ -1,5 +1,7 @@
 # create-backan
 
+## 0.0.15
+
 ## 0.0.14
 
 ### Patch Changes

packages/create/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-backan",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"type": "module",
 	"license": "GPL-3.0",
 	"homepage": "https://backan.pigeonposse.com",

packages/docs/CHANGELOG.md

@@ -1,5 +1,7 @@
 # @backan/docs
 
+## 0.0.15
+
 ## 0.0.14
 
 ## 0.0.13

packages/docs/package.json

@@ -1,7 +1,7 @@
 {
 	"private": true,
 	"name": "@backan/docs",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"description": "Documentation for backan",
 	"type": "module",
 	"repository": {

packages/server/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @backan/server
 
+## 0.0.15
+
+### Patch Changes
+
+- fix issues and update builder for detect input without extensions
+
 ## 0.0.14
 
 ### Patch Changes

packages/server/examples/app.ts

@@ -7,7 +7,8 @@ import {
 import { bugs }    from '../../../package.json'
 import { version } from '../package.json'
 
-const app = new App( {
+type AppEnv = {DB: object}
+const app = new App<AppEnv>( {
 	version,
 	title       : 'BACKAN Example app',
 	description : 'API documentation for BACKAN Example',
@@ -34,7 +35,7 @@ const app = new App( {
 } )
 
 const id                                = 'random'
-const healthRoute                       = new Route( {
+const healthRoute                       = new Route<AppEnv, typeof id>( {
 	path : id,
 } )
 healthRoute.RESPONSE_MESSAGES.ERROR_400 = 'Error getting random data'

packages/server/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@backan/server",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"type": "module",
 	"license": "GPL-3.0",
 	"homepage": "https://backan.pigeonposse.com",

packages/server/src/main.ts

@@ -89,7 +89,7 @@ const tryServe = async <Env extends object>(
 }
 
 /**
- * Starts a node server with BACKAN.
+ * Start a server for BACKAN.
  *
  * @template Env - The environment type.
  * @param   {ServerOpts<Env>} opts - The server options.

packages/server/src/types.ts

@@ -34,7 +34,7 @@ export type ServerOpts<Env extends object> = {
 	 * The fetch handler for the server.
 	 *
 	 */
-	app: App<Env>,
+	app: InstanceType<typeof App> | App<Env>,
 	/**
 	 * The port to start the server on.
 	 *