@asenajs/ergenecore 1.0.0

package/dist/lib/types/Handler.js

@@ -0,0 +1,10 @@
+/**
+ * Ergenecore handler type definitions
+ *
+ * Type aliases for route handlers and other function signatures
+ * specific to the Ergenecore adapter.
+ *
+ * @module types/Handler
+ */
+export {};
+//# sourceMappingURL=Handler.js.map

package/dist/lib/types/Handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Handler.js","sourceRoot":"","sources":["../../../lib/types/Handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/lib/types/StaticServeExtras.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Configuration options for static file serving with Ergenecore adapter.
+ * These options are passed via the `extra` field in BaseStaticServeParams.
+ */
+export interface StaticServeExtras {
+    /**
+     * Enable serving precompressed files (.br, .gz) if available.
+     * When true, adapter will look for .br and .gz variants before serving the original file.
+     * @default false
+     */
+    precompressed?: boolean;
+    /**
+     * Custom MIME type mappings for file extensions.
+     * Overrides Bun's default MIME type detection.
+     * @example { '.ts': 'text/typescript' }
+     */
+    mimes?: Record<string, string>;
+    /**
+     * Cache-Control header value for static files.
+     * @example 'public, max-age=31536000, immutable'
+     */
+    cacheControl?: string;
+    /**
+     * Custom headers to include in static file responses.
+     * These headers are added to all static file responses.
+     * @example { 'X-Custom-Header': 'value' }
+     */
+    headers?: Record<string, string>;
+}

package/dist/lib/types/StaticServeExtras.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=StaticServeExtras.js.map

package/dist/lib/types/StaticServeExtras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StaticServeExtras.js","sourceRoot":"","sources":["../../../lib/types/StaticServeExtras.ts"],"names":[],"mappings":""}

package/dist/lib/types/Validation.d.ts

@@ -0,0 +1,7 @@
+import type z from 'zod';
+import type { Context } from '../ErgenecoreContextWrapper';
+export type ValidationSchema = z.ZodType<any, any, any>;
+export interface ValidationSchemaWithHook {
+    schema: ValidationSchema;
+    hook?: (result: any, context: Context) => any;
+}

package/dist/lib/types/Validation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Validation.js.map

package/dist/lib/types/Validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validation.js","sourceRoot":"","sources":["../../../lib/types/Validation.ts"],"names":[],"mappings":""}

package/dist/lib/types/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Ergenecore type definitions
+ *
+ * Centralized export point for all Ergenecore-specific types.
+ * Provides type definitions for handlers, static serve configuration,
+ * validation schemas, and more.
+ *
+ * Note: Router types are not needed as we use Bun's native router
+ *
+ * @module types
+ *
+ * @example
+ * ```typescript
+ * import type {
+ *   ErgenecoreHandler,
+ *   StaticServeExtras,
+ *   ValidationSchemaWithHook
+ * } from '@asenajs/ergenecore/types';
+ * ```
+ */
+export type { ErgenecoreHandler, ErgenecoreNext } from './Handler';
+export * from './StaticServeExtras';
+export * from './Validation';
+export type { Context } from '../ErgenecoreContextWrapper';

package/dist/lib/types/index.js

@@ -0,0 +1,25 @@
+/**
+ * Ergenecore type definitions
+ *
+ * Centralized export point for all Ergenecore-specific types.
+ * Provides type definitions for handlers, static serve configuration,
+ * validation schemas, and more.
+ *
+ * Note: Router types are not needed as we use Bun's native router
+ *
+ * @module types
+ *
+ * @example
+ * ```typescript
+ * import type {
+ *   ErgenecoreHandler,
+ *   StaticServeExtras,
+ *   ValidationSchemaWithHook
+ * } from '@asenajs/ergenecore/types';
+ * ```
+ */
+// Static serve types
+export * from './StaticServeExtras';
+// Validation types
+export * from './Validation';
+//# sourceMappingURL=index.js.map

package/dist/lib/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,qBAAqB;AACrB,cAAc,qBAAqB,CAAC;AAEpC,mBAAmB;AACnB,cAAc,cAAc,CAAC"}

package/dist/lib/utils/factory.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Factory functions for creating Ergenecore instances
+ *
+ * Provides convenient factory functions for creating pre-configured
+ * Ergenecore adapter instances with sensible defaults.
+ *
+ * @module factory
+ *
+ * @example
+ * ```typescript
+ * import { createErgenecoreAdapter } from '@asenajs/ergenecore/factory';
+ *
+ * const adapter = createErgenecoreAdapter({
+ *   port: 3000,
+ *   hostname: 'localhost'
+ * });
+ * ```
+ */
+import type { ServerLogger } from '@asenajs/asena/logger';
+import { ErgenecoreWebsocketAdapter } from '../ErgenecoreWebsocketAdapter';
+import { Ergenecore } from '../Ergenecore';
+/**
+ * Configuration options for creating an Ergenecore adapter
+ */
+export interface ErgenecoreOptions {
+    /**
+     * Server port
+     * @default 3000
+     */
+    port?: number;
+    /**
+     * Server hostname
+     * @default undefined (binds to all interfaces)
+     */
+    hostname?: string;
+    /**
+     * Custom logger instance
+     * If not provided, a default logger will be used
+     */
+    logger?: ServerLogger;
+    /**
+     * Enable WebSocket support
+     * @default true
+     */
+    enableWebSocket?: boolean;
+    /**
+     * Custom WebSocket adapter instance
+     * Only used if enableWebSocket is true
+     */
+    websocketAdapter?: ErgenecoreWebsocketAdapter;
+}
+/**
+ * Creates a new Ergenecore adapter instance with optional configuration
+ *
+ * @param options - Configuration options
+ * @returns Configured Ergenecore adapter instance
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with defaults
+ * const adapter = createErgenecoreAdapter();
+ *
+ * // Custom port and hostname
+ * const adapter = createErgenecoreAdapter({
+ *   port: 8080,
+ *   hostname: '0.0.0.0'
+ * });
+ *
+ * // With custom logger
+ * const adapter = createErgenecoreAdapter({
+ *   logger: customLogger,
+ *   port: 3000
+ * });
+ *
+ * // Disable WebSocket support
+ * const adapter = createErgenecoreAdapter({
+ *   enableWebSocket: false
+ * });
+ * ```
+ */
+export declare function createErgenecoreAdapter(options?: ErgenecoreOptions): Ergenecore;
+/**
+ * Creates a production-ready Ergenecore adapter with optimized settings
+ *
+ * This factory includes:
+ * - Performance-optimized defaults
+ * - WebSocket support enabled
+ * - Production logging
+ *
+ * @param options - Configuration options
+ * @returns Production-configured Ergenecore adapter
+ *
+ * @example
+ * ```typescript
+ * const adapter = createProductionAdapter({
+ *   port: 8080,
+ *   hostname: '0.0.0.0',
+ *   logger: productionLogger
+ * });
+ * ```
+ */
+export declare function createProductionAdapter(options?: ErgenecoreOptions): Ergenecore;
+/**
+ * Creates a development-friendly Ergenecore adapter
+ *
+ * This factory includes:
+ * - Verbose console logging
+ * - WebSocket support enabled
+ * - Default port 3000
+ *
+ * @param options - Configuration options
+ * @returns Development-configured Ergenecore adapter
+ *
+ * @example
+ * ```typescript
+ * const adapter = createDevelopmentAdapter({
+ *   port: 3000
+ * });
+ * ```
+ */
+export declare function createDevelopmentAdapter(options?: ErgenecoreOptions): Ergenecore;

package/dist/lib/utils/factory.js

@@ -0,0 +1,144 @@
+/**
+ * Factory functions for creating Ergenecore instances
+ *
+ * Provides convenient factory functions for creating pre-configured
+ * Ergenecore adapter instances with sensible defaults.
+ *
+ * @module factory
+ *
+ * @example
+ * ```typescript
+ * import { createErgenecoreAdapter } from '@asenajs/ergenecore/factory';
+ *
+ * const adapter = createErgenecoreAdapter({
+ *   port: 3000,
+ *   hostname: 'localhost'
+ * });
+ * ```
+ */
+import { ErgenecoreWebsocketAdapter } from '../ErgenecoreWebsocketAdapter';
+import { Ergenecore } from '../Ergenecore';
+/**
+ * Creates a new Ergenecore adapter instance with optional configuration
+ *
+ * @param options - Configuration options
+ * @returns Configured Ergenecore adapter instance
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with defaults
+ * const adapter = createErgenecoreAdapter();
+ *
+ * // Custom port and hostname
+ * const adapter = createErgenecoreAdapter({
+ *   port: 8080,
+ *   hostname: '0.0.0.0'
+ * });
+ *
+ * // With custom logger
+ * const adapter = createErgenecoreAdapter({
+ *   logger: customLogger,
+ *   port: 3000
+ * });
+ *
+ * // Disable WebSocket support
+ * const adapter = createErgenecoreAdapter({
+ *   enableWebSocket: false
+ * });
+ * ```
+ */
+export function createErgenecoreAdapter(options = {}) {
+    const { port = 3000, hostname, logger, enableWebSocket = true, websocketAdapter } = options;
+    // Create default logger if not provided
+    const adapterLogger = logger || createDefaultLogger();
+    // Create WebSocket adapter if enabled
+    const wsAdapter = enableWebSocket ? websocketAdapter || new ErgenecoreWebsocketAdapter(adapterLogger) : undefined;
+    // Create Ergenecore instance
+    const adapter = new Ergenecore(adapterLogger, wsAdapter);
+    // Configure port and hostname
+    adapter.setPort(port);
+    if (hostname) {
+        adapter.hostname = hostname;
+    }
+    return adapter;
+}
+/**
+ * Creates a default logger implementation
+ *
+ * Provides basic console logging for development purposes.
+ * In production, you should provide your own logger instance.
+ *
+ * @returns Default ServerLogger implementation
+ *
+ * @internal
+ */
+function createDefaultLogger() {
+    return {
+        info: (message, ...args) => {
+            console.log(`[INFO]: ${message}`, ...args);
+        },
+        error: (message, ...args) => {
+            console.error(`[ERROR]: ${message}`, ...args);
+        },
+        warn: (message, ...args) => {
+            console.warn(`[WARN]: ${message}`, ...args);
+        },
+        profile: (message) => {
+            console.time(message);
+            return () => console.timeEnd(message);
+        },
+    };
+}
+/**
+ * Creates a production-ready Ergenecore adapter with optimized settings
+ *
+ * This factory includes:
+ * - Performance-optimized defaults
+ * - WebSocket support enabled
+ * - Production logging
+ *
+ * @param options - Configuration options
+ * @returns Production-configured Ergenecore adapter
+ *
+ * @example
+ * ```typescript
+ * const adapter = createProductionAdapter({
+ *   port: 8080,
+ *   hostname: '0.0.0.0',
+ *   logger: productionLogger
+ * });
+ * ```
+ */
+export function createProductionAdapter(options = {}) {
+    return createErgenecoreAdapter({
+        ...options,
+        enableWebSocket: options.enableWebSocket ?? true,
+    });
+}
+/**
+ * Creates a development-friendly Ergenecore adapter
+ *
+ * This factory includes:
+ * - Verbose console logging
+ * - WebSocket support enabled
+ * - Default port 3000
+ *
+ * @param options - Configuration options
+ * @returns Development-configured Ergenecore adapter
+ *
+ * @example
+ * ```typescript
+ * const adapter = createDevelopmentAdapter({
+ *   port: 3000
+ * });
+ * ```
+ */
+export function createDevelopmentAdapter(options = {}) {
+    return createErgenecoreAdapter({
+        port: 3000,
+        ...options,
+        logger: options.logger || createDefaultLogger(),
+        enableWebSocket: true,
+    });
+}
+//# sourceMappingURL=factory.js.map

package/dist/lib/utils/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../lib/utils/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAqC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAA6B,EAAE;IACrE,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAE5F,wCAAwC;IACxC,MAAM,aAAa,GAAG,MAAM,IAAI,mBAAmB,EAAE,CAAC;IAEtD,sCAAsC;IACtC,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,gBAAgB,IAAI,IAAI,0BAA0B,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElH,6BAA6B;IAC7B,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAEzD,8BAA8B;IAC9B,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,mBAAmB;IAC1B,OAAO;QACL,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;YACxC,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;YACzC,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;YACxC,OAAO,CAAC,IAAI,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,CAAC,OAAe,EAAE,EAAE;YAC3B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAA6B,EAAE;IACrE,OAAO,uBAAuB,CAAC;QAC7B,GAAG,OAAO;QACV,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;KACjD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAA6B,EAAE;IACtE,OAAO,uBAAuB,CAAC;QAC7B,IAAI,EAAE,IAAI;QACV,GAAG,OAAO;QACV,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,mBAAmB,EAAE;QAC/C,eAAe,EAAE,IAAI;KACtB,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@asenajs/ergenecore",
+  "module": "index.ts",
+  "description": "Ergenecore is native bun server adapter for asenajs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "version": "1.0.0",
+  "author": "LibirSoft",
+  "license": "MIT",
+  "scripts": {
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "build": "bun run clean && tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build",
+    "benchmark": "bun run benchmark/run-benchmark.ts",
+    "benchmark:native": "bun run benchmark/native-bun.ts",
+    "benchmark:ergenecore": "bun run benchmark/ergenecore.ts"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.7",
+    "@types/bun": "latest",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "eslint": "^8.57.1",
+    "eslint-config-alloy": "^5.1.2",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-plugin-alloy": "^1.2.1",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-n": "^16.6.2",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-promise": "^6.6.0",
+    "prettier": "^3.6.2"
+  },
+  "peerDependencies": {
+    "@asenajs/asena": "^0.4.0",
+    "typescript": "^5.8.2"
+  },
+  "dependencies": {
+    "zod": "^4.1.12"
+  }
+}