@kitledger/server 0.0.5 → 0.0.6

package/dist/main.d.ts

@@ -1,12 +1,39 @@
 import { type KitledgerConfig } from "@kitledger/core";
 import { StaticUIConfig } from "@kitledger/core/ui";
 import { Hono } from "hono";
+type ServerConfig = ServerOptions;
+type KitledgerContext = {
+    Variables: {
+        config: KitledgerConfig;
+    };
+};
+/**
+ * Options for configuring the Kitledger server.
+ */
 export type ServerOptions = {
     systemConfig: KitledgerConfig;
     staticPaths?: string[];
     staticUIs?: StaticUIConfig[];
 };
-type ServerConfig = ServerOptions;
+/**
+ * Factory function to define the server configuration.
+ */
 export declare function defineServerConfig(options: ServerOptions): ServerConfig;
-export declare function createServer(config: ServerConfig): Promise<Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">>;
+/**
+ * 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.
+ * @returns A Promise that resolves to the configured Hono application instance.
+ * * @example
+ * ```ts
+ * // Basic usage with Bun
+ * const server = await createServer({
+ * systemConfig: myConfig,
+ * staticPaths: ['/public']
+ * });
+ * * export default { fetch: server.fetch };
+ * ```
+ */
+export declare function createServer(config: ServerConfig): Promise<Hono<KitledgerContext, import("hono/types").BlankSchema, "/">>;
 export {};

package/dist/main.js

@@ -1,5 +1,4 @@
 import { Hono } from "hono";
-// 3. The Auto-Detection Logic
 function detectRuntime() {
     // @ts-ignore: Deno global detection
     if (typeof Deno !== "undefined")
@@ -11,11 +10,37 @@ function detectRuntime() {
         return "node";
     return "unknown";
 }
+/**
+ * Factory function to define the server configuration.
+ */
 export function defineServerConfig(options) {
     return options;
 }
+/**
+ * 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.
+ * @returns A Promise that resolves to the configured Hono application instance.
+ * * @example
+ * ```ts
+ * // Basic usage with Bun
+ * const server = await createServer({
+ * systemConfig: myConfig,
+ * staticPaths: ['/public']
+ * });
+ * * export default { fetch: server.fetch };
+ * ```
+ */
 export async function createServer(config) {
     const server = new Hono();
+    /**
+     * Ensure all requests have access to the system config.
+     */
+    server.use("*", (c, next) => {
+        c.set("config", config.systemConfig);
+        return next();
+    });
     const runtime = detectRuntime();
     // 4. Type-Safe Variable Definition
     let serveStatic;
@@ -45,16 +70,16 @@ export async function createServer(config) {
     if (config.staticUIs) {
         for (const staticUI of config.staticUIs) {
             server.get(`${staticUI.serverPath}/transactions/models`, (c) => {
-                return c.json(config.systemConfig.transactionModels);
+                return c.json(c.get("config").transactionModels);
             });
             server.get(`${staticUI.serverPath}/entities/models`, (c) => {
-                return c.json(config.systemConfig.entityModels);
+                return c.json(c.get("config").entityModels);
             });
             const cleanPath = staticUI.basePath.endsWith("/") ? staticUI.basePath.slice(0, -1) : staticUI.basePath;
             server.use(`${cleanPath}/*`, serveStatic({
                 root: staticUI.assetsPath,
                 rewriteRequestPath: (path) => {
-                    const p = path.replace(new RegExp(`^${cleanPath}`), "").replace(/^\//, "");
+                    const p = path.slice(cleanPath.length).replace(/^\//, "");
                     if (p === "" || p === "index.html")
                         return "__404__";
                     return p;
@@ -70,7 +95,7 @@ export async function createServer(config) {
         for (const staticPath of config.staticPaths) {
             server.use(staticPath, serveStatic({
                 root: ".",
-                rewriteRequestPath: (path) => path.replace(new RegExp(`^${staticPath}`), "").replace(/^\//, ""),
+                rewriteRequestPath: (path) => path.slice(staticPath.length).replace(/^\//, ""),
             }));
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitledger/server",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "private": false,
   "license": "Apache-2.0",
   "type": "module",