@kitledger/server 0.0.7 → 0.0.9

package/dist/main.d.ts

@@ -1,7 +1,14 @@
 import { type KitledgerConfig } from "@kitledger/core";
 import { StaticUIConfig } from "@kitledger/core/ui";
 import { Hono } from "hono";
-type ServerConfig = ServerOptions;
+type CorsConfig = {
+    origin: string | string[];
+    allowMethods: string[];
+    allowHeaders: string[];
+    maxAge: number;
+    credentials: boolean;
+    exposeHeaders: string[];
+};
 type KitledgerContext = {
     Variables: {
         config: KitledgerConfig;
@@ -14,30 +21,81 @@ export type ServerOptions = {
     systemConfig: KitledgerConfig;
     staticPaths?: string[];
     staticUIs?: StaticUIConfig[];
+    corsConfig?: CorsConfig;
 };
-/**
- * Factory function to define the server configuration.
- */
-export declare function defineServerConfig(options: ServerOptions): ServerConfig;
 /**
  * Prints the Kitledger ASCII logo to the console.
  */
 export declare function printAsciiLogo(): void;
 /**
- * Factory function to create a Hono server based on the detected runtime.
- * * This is the main entry point for the server package. It returns an initialized
- * Hono instance that has the system configuration injected into its context.
- * * @param config - The {@link ServerConfig} object containing system settings, static paths, and UI definitions.
+ * Factory function that initializes the Kitledger server engine based on Hono.
+ *
+ * This function injects the provided {@link ServerConfig} (business logic, UI definitions,
+ * and database connections) into the application context and returns a fully configured
+ * Hono instance.
+ *
+ * @remarks
+ * **Universal Web Standards**
+ * The returned application relies on native Web Standard `Request` and `Response` objects.
+ * This makes the server runtime-agnostic and allows it to be mounted within existing
+ * full-stack frameworks (like Next.js Route Handlers, Astro, or React Router 7) simply
+ * by exporting the `fetch` handler.
+ *
+ * @param config - The {@link ServerConfig} object containing system settings, static paths, and UI definitions.
  * @returns A Promise that resolves to the configured Hono application instance.
- * * @example
+ *
+ * @example
+ * ```ts
+ * // 1. Standalone Usage (Bun)
+ * const server = await createServer({
+ * systemConfig: myConfig,
+ * staticPaths: ['/public']
+ * });
+ *
+ * export default {
+ * fetch: server.fetch,
+ * port: 3000
+ * };
+ * ```
+ *
+ * @example
  * ```ts
- * // Basic usage with Bun
+ * // 2. Standalone Usage (Deno)
  * const server = await createServer({
  * systemConfig: myConfig,
  * staticPaths: ['/public']
  * });
- * * export default { fetch: server.fetch };
+ *
+ * Deno.serve({ port: 8000 }, server.fetch);
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 3. Standalone Usage (Node.js)
+ * import { serve } from '@hono/node-server';
+ *
+ * const server = await createServer({
+ * systemConfig: myConfig,
+ * staticPaths: ['/public']
+ * });
+ *
+ * serve({
+ * fetch: server.fetch,
+ * port: 3000
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 4. Framework Integration (Next.js / Astro / React Router 7)
+ * // Because 'server' follows standard Web APIs, you can use it in route handlers.
+ *
+ * const server = await createServer({ ... });
+ *
+ * // Next.js App Router (route.ts)
+ * export const GET = server.fetch;
+ * export const POST = server.fetch;
  * ```
  */
-export declare function createServer(config: ServerConfig): Promise<Hono<KitledgerContext, import("hono/types").BlankSchema, "/">>;
+export declare function createServer(options: ServerOptions): Promise<Hono<KitledgerContext, import("hono/types").BlankSchema, "/">>;
 export {};

package/dist/main.js

@@ -14,8 +14,26 @@ function detectRuntime() {
 /**
  * Factory function to define the server configuration.
  */
-export function defineServerConfig(options) {
-    return options;
+function defineServerConfig(options) {
+    /**
+     * CORS configuration values and defaults.
+     */
+    const defaultCorsConfig = {
+        origin: "*",
+        allowMethods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
+        allowHeaders: ["Content-Type", "Authorization", "X-Requested-With"],
+        exposeHeaders: [],
+        credentials: false,
+        maxAge: 86400,
+    };
+    const corsConfig = {
+        ...defaultCorsConfig,
+        ...options.corsConfig,
+    };
+    return {
+        ...options,
+        corsConfig,
+    };
 }
 /**
  * Prints the Kitledger ASCII logo to the console.
@@ -24,22 +42,77 @@ export function printAsciiLogo() {
     console.log(getAsciiLogo());
 }
 /**
- * Factory function to create a Hono server based on the detected runtime.
- * * This is the main entry point for the server package. It returns an initialized
- * Hono instance that has the system configuration injected into its context.
- * * @param config - The {@link ServerConfig} object containing system settings, static paths, and UI definitions.
+ * Factory function that initializes the Kitledger server engine based on Hono.
+ *
+ * This function injects the provided {@link ServerConfig} (business logic, UI definitions,
+ * and database connections) into the application context and returns a fully configured
+ * Hono instance.
+ *
+ * @remarks
+ * **Universal Web Standards**
+ * The returned application relies on native Web Standard `Request` and `Response` objects.
+ * This makes the server runtime-agnostic and allows it to be mounted within existing
+ * full-stack frameworks (like Next.js Route Handlers, Astro, or React Router 7) simply
+ * by exporting the `fetch` handler.
+ *
+ * @param config - The {@link ServerConfig} object containing system settings, static paths, and UI definitions.
  * @returns A Promise that resolves to the configured Hono application instance.
- * * @example
+ *
+ * @example
  * ```ts
- * // Basic usage with Bun
+ * // 1. Standalone Usage (Bun)
  * const server = await createServer({
  * systemConfig: myConfig,
  * staticPaths: ['/public']
  * });
- * * export default { fetch: server.fetch };
+ *
+ * export default {
+ * fetch: server.fetch,
+ * port: 3000
+ * };
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 2. Standalone Usage (Deno)
+ * const server = await createServer({
+ * systemConfig: myConfig,
+ * staticPaths: ['/public']
+ * });
+ *
+ * Deno.serve({ port: 8000 }, server.fetch);
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 3. Standalone Usage (Node.js)
+ * import { serve } from '@hono/node-server';
+ *
+ * const server = await createServer({
+ * systemConfig: myConfig,
+ * staticPaths: ['/public']
+ * });
+ *
+ * serve({
+ * fetch: server.fetch,
+ * port: 3000
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 4. Framework Integration (Next.js / Astro / React Router 7)
+ * // Because 'server' follows standard Web APIs, you can use it in route handlers.
+ *
+ * const server = await createServer({ ... });
+ *
+ * // Next.js App Router (route.ts)
+ * export const GET = server.fetch;
+ * export const POST = server.fetch;
  * ```
  */
-export async function createServer(config) {
+export async function createServer(options) {
+    const config = defineServerConfig(options);
     const server = new Hono();
     /**
      * Ensure all requests have access to the system config.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitledger/server",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "private": false,
   "license": "Apache-2.0",
   "type": "module",
@@ -18,7 +18,7 @@
     "@hono/node-server": "^1.19.6",
     "hono": "^4.10.7",
     "valibot": "^1.1.0",
-    "@kitledger/core": "0.0.8"
+    "@kitledger/core": "0.0.9"
   },
   "devDependencies": {
     "@kitledger/admin": "0.0.5"