@typokit/core 0.1.4

package/dist/adapters/database.d.ts

@@ -0,0 +1,28 @@
+import type { GeneratedOutput, MigrationDraft, SchemaTypeMap } from "@typokit/types";
+/**
+ * Represents the current state of a database schema,
+ * used by adapters to compute diffs against TypoKit types.
+ */
+export interface DatabaseState {
+    tables: Record<string, TableState>;
+}
+export interface TableState {
+    columns: Record<string, ColumnState>;
+}
+export interface ColumnState {
+    type: string;
+    nullable: boolean;
+}
+/**
+ * Every database adapter implements this interface.
+ * See typokit-arch.md Section 7.3.
+ */
+export interface DatabaseAdapter {
+    /** Generate DB schema artifacts from TypoKit types */
+    generate(types: SchemaTypeMap): GeneratedOutput[];
+    /** Diff current DB state against types, produce migration draft */
+    diff(types: SchemaTypeMap, currentState: DatabaseState): MigrationDraft;
+    /** Generate typed repository helpers (optional — adapters can skip this) */
+    generateRepositories?(types: SchemaTypeMap): GeneratedOutput[];
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/adapters/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/adapters/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,EAAE,CAAC;IAElD,mEAAmE;IACnE,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,GAAG,cAAc,CAAC;IAExE,4EAA4E;IAC5E,oBAAoB,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,EAAE,CAAC;CAChE"}

package/dist/adapters/database.js

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

package/dist/adapters/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/adapters/database.ts"],"names":[],"mappings":""}

package/dist/adapters/server.d.ts

@@ -0,0 +1,35 @@
+import type { CompiledRouteTable, HandlerMap, MiddlewareChain, SerializerMap, ServerHandle, TypoKitRequest, TypoKitResponse, ValidatorMap } from "@typokit/types";
+export interface ServerAdapter {
+    /** Adapter name for logging and diagnostics */
+    name: string;
+    /**
+     * Register TypoKit's compiled routes into the server framework.
+     * The adapter translates the route table into framework-native registrations.
+     * Each route handler receives a normalized TypoKitRequest and must return
+     * a TypoKitResponse.
+     */
+    registerRoutes(routeTable: CompiledRouteTable, handlerMap: HandlerMap, middlewareChain: MiddlewareChain, validatorMap?: ValidatorMap, serializerMap?: SerializerMap): void;
+    /**
+     * Start the server. Returns a handle for shutdown.
+     */
+    listen(port: number): Promise<ServerHandle>;
+    /**
+     * Normalize the framework's native request into TypoKit's standard format.
+     * This is where Fastify's `req`, Hono's `c`, or raw `http.IncomingMessage`
+     * get normalized into a consistent shape for TypoKit's validation/handler
+     * pipeline.
+     */
+    normalizeRequest(raw: unknown): TypoKitRequest;
+    /**
+     * Write TypoKit's response back through the framework's native response
+     * mechanism.
+     */
+    writeResponse(raw: unknown, response: TypoKitResponse): void;
+    /**
+     * Optional: expose the underlying framework instance for escape hatches.
+     * e.g., the raw Fastify instance so users can register Fastify-native plugins.
+     * Returns `unknown` — consumers cast to the specific framework type.
+     */
+    getNativeServer?(): unknown;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/adapters/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/adapters/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,EACf,YAAY,EACb,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,cAAc,CACZ,UAAU,EAAE,kBAAkB,EAC9B,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,eAAe,EAChC,YAAY,CAAC,EAAE,YAAY,EAC3B,aAAa,CAAC,EAAE,aAAa,GAC5B,IAAI,CAAC;IAER;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAAC;IAE/C;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAE7D;;;;OAIG;IACH,eAAe,CAAC,IAAI,OAAO,CAAC;CAC7B"}

package/dist/adapters/server.js

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

package/dist/adapters/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/adapters/server.ts"],"names":[],"mappings":""}

package/dist/app.d.ts

@@ -0,0 +1,36 @@
+import type { ServerHandle, Logger, TypoKitRequest, RequestContext, TypoKitResponse } from "@typokit/types";
+import type { ServerAdapter } from "./adapters/server.js";
+import type { TypoKitPlugin } from "./plugin.js";
+import type { MiddlewareEntry } from "./middleware.js";
+/** A group of route handlers registered under a common prefix */
+export interface RouteGroup {
+    prefix: string;
+    handlers: Record<string, unknown>;
+    middleware?: MiddlewareEntry[];
+}
+/** Options accepted by the createApp() factory function */
+export interface CreateAppOptions {
+    server: ServerAdapter;
+    middleware?: MiddlewareEntry[];
+    routes: RouteGroup[];
+    plugins?: TypoKitPlugin[];
+    logging?: Partial<Logger>;
+    telemetry?: Record<string, unknown>;
+}
+/** The application instance returned by createApp() */
+export interface TypoKitApp {
+    /** Start the server on the given port */
+    listen(port: number): Promise<ServerHandle>;
+    /** Expose the underlying server framework instance */
+    getNativeServer(): unknown;
+    /** Gracefully shut down the application */
+    close(): Promise<void>;
+    /** The auto-registered error middleware for use by server adapters */
+    errorMiddleware: (req: TypoKitRequest, ctx: RequestContext, next: () => Promise<TypoKitResponse>) => Promise<TypoKitResponse>;
+}
+/**
+ * Create a TypoKit application from a server adapter, middleware,
+ * routes, and plugins.
+ */
+export declare function createApp(options: CreateAppOptions): TypoKitApp;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,MAAM,EACN,cAAc,EACd,cAAc,EACd,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKvD,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAID,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAID,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,sDAAsD;IACtD,eAAe,IAAI,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sEAAsE;IACtE,eAAe,EAAE,CACf,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,KACjC,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/B;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,CA0D/D"}

package/dist/app.js

@@ -0,0 +1,55 @@
+// @typokit/core — App Factory (createApp)
+import { createErrorMiddleware } from "./error-middleware.js";
+// ─── createApp Factory ──────────────────────────────────────
+/**
+ * Create a TypoKit application from a server adapter, middleware,
+ * routes, and plugins.
+ */
+export function createApp(options) {
+    const { server, plugins = [] } = options;
+    const appInstance = {
+        name: server.name,
+        plugins,
+        services: {},
+    };
+    // Auto-register error middleware for the request pipeline
+    const errorMiddleware = createErrorMiddleware();
+    let serverHandle = null;
+    const app = {
+        errorMiddleware,
+        async listen(port) {
+            // 1. Call plugin onStart hooks
+            for (const plugin of plugins) {
+                if (plugin.onStart) {
+                    await plugin.onStart(appInstance);
+                }
+            }
+            // 2. Delegate to server adapter
+            serverHandle = await server.listen(port);
+            // 3. Call plugin onReady hooks
+            for (const plugin of plugins) {
+                if (plugin.onReady) {
+                    await plugin.onReady(appInstance);
+                }
+            }
+            return serverHandle;
+        },
+        getNativeServer() {
+            return server.getNativeServer?.() ?? null;
+        },
+        async close() {
+            // Call plugin onStop hooks
+            for (const plugin of plugins) {
+                if (plugin.onStop) {
+                    await plugin.onStop(appInstance);
+                }
+            }
+            if (serverHandle) {
+                await serverHandle.close();
+                serverHandle = null;
+            }
+        },
+    };
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAY1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAyC9D,+DAA+D;AAE/D;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEzC,MAAM,WAAW,GAAgB;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO;QACP,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,0DAA0D;IAC1D,MAAM,eAAe,GAAG,qBAAqB,EAAE,CAAC;IAEhD,IAAI,YAAY,GAAwB,IAAI,CAAC;IAE7C,MAAM,GAAG,GAAe;QACtB,eAAe;QAEf,KAAK,CAAC,MAAM,CAAC,IAAY;YACvB,+BAA+B;YAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;YAED,gCAAgC;YAChC,YAAY,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAEzC,+BAA+B;YAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;YAED,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,eAAe;YACb,OAAO,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,KAAK;YACT,2BAA2B;YAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClB,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YAED,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;gBAC3B,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;QACH,CAAC;KACF,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/error-middleware.d.ts

@@ -0,0 +1,17 @@
+import type { TypoKitRequest, RequestContext, TypoKitResponse } from "@typokit/types";
+/** Options for configuring the error middleware */
+export interface ErrorMiddlewareOptions {
+    /** Override dev mode detection (defaults to NODE_ENV === "development") */
+    isDev?: boolean;
+}
+/**
+ * Built-in error middleware — catches all thrown errors and serializes
+ * them into the ErrorResponse schema.
+ *
+ * - AppError: serialized with correct status, code, message, details, traceId
+ * - Typia validation errors: 400 with field-level failure details
+ * - Unknown errors (prod): 500 generic message, full details logged
+ * - Unknown errors (dev): 500 with stack trace and message exposed
+ */
+export declare function createErrorMiddleware(options?: ErrorMiddlewareOptions): (req: TypoKitRequest, ctx: RequestContext, next: () => Promise<TypoKitResponse>) => Promise<TypoKitResponse>;
+//# sourceMappingURL=error-middleware.d.ts.map

package/dist/error-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-middleware.d.ts","sourceRoot":"","sources":["../src/error-middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EAGhB,MAAM,gBAAgB,CAAC;AAKxB,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA8DD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,CACD,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,KACjC,OAAO,CAAC,eAAe,CAAC,CAiF5B"}

package/dist/error-middleware.js

@@ -0,0 +1,138 @@
+// @typokit/core — Error Middleware
+import { AppError } from "@typokit/errors";
+/** Duck-type check for Typia TypeGuardError (thrown by typia.assert) */
+function isTypiaTypeGuardError(error) {
+    if (!(error instanceof Error))
+        return false;
+    return error.name === "TypeGuardError";
+}
+/** Duck-type check for objects with Typia-style errors array */
+function hasTypiaErrors(error) {
+    if (!(error instanceof Error))
+        return false;
+    const candidate = error;
+    return (Array.isArray(candidate.errors) &&
+        candidate.errors.length > 0 &&
+        typeof candidate.errors[0].path === "string");
+}
+/** Extract field-level details from a Typia validation error */
+function extractTypiaDetails(error) {
+    if (hasTypiaErrors(error)) {
+        return {
+            fields: error.errors.map((e) => ({
+                path: e.path,
+                expected: e.expected,
+                value: e.value,
+            })),
+        };
+    }
+    const guard = error;
+    if (guard.path !== undefined) {
+        return {
+            fields: [
+                {
+                    path: guard.path,
+                    expected: guard.expected,
+                    value: guard.value,
+                },
+            ],
+        };
+    }
+    return {};
+}
+// ─── Error Middleware Factory ─────────────────────────────────
+/**
+ * Built-in error middleware — catches all thrown errors and serializes
+ * them into the ErrorResponse schema.
+ *
+ * - AppError: serialized with correct status, code, message, details, traceId
+ * - Typia validation errors: 400 with field-level failure details
+ * - Unknown errors (prod): 500 generic message, full details logged
+ * - Unknown errors (dev): 500 with stack trace and message exposed
+ */
+export function createErrorMiddleware(options) {
+    const isDev = options?.isDev ??
+        (typeof globalThis !== "undefined" &&
+            globalThis
+                .process?.env?.NODE_ENV === "development");
+    return async (_req, ctx, next) => {
+        try {
+            return await next();
+        }
+        catch (error) {
+            const traceId = ctx.requestId;
+            // ── AppError instances ──
+            if (error instanceof AppError) {
+                const json = error.toJSON();
+                json.error.traceId = traceId;
+                return {
+                    status: error.status,
+                    headers: { "content-type": "application/json" },
+                    body: json,
+                };
+            }
+            // ── Typia validation errors ──
+            if (isTypiaTypeGuardError(error) || hasTypiaErrors(error)) {
+                const details = extractTypiaDetails(error);
+                const body = {
+                    error: {
+                        code: "VALIDATION_ERROR",
+                        message: error.message || "Validation failed",
+                        details,
+                        traceId,
+                    },
+                };
+                return {
+                    status: 400,
+                    headers: { "content-type": "application/json" },
+                    body,
+                };
+            }
+            // ── Unknown errors ──
+            const err = error instanceof Error ? error : new Error(String(error));
+            if (isDev) {
+                // Development: expose stack trace and message
+                const body = {
+                    error: {
+                        code: "INTERNAL_SERVER_ERROR",
+                        message: err.message,
+                        details: {
+                            stack: err.stack,
+                            name: err.name,
+                        },
+                        traceId,
+                    },
+                };
+                return {
+                    status: 500,
+                    headers: { "content-type": "application/json" },
+                    body,
+                };
+            }
+            // Production: log full details, return redacted response
+            logUnknownError(ctx.log, err, traceId);
+            const body = {
+                error: {
+                    code: "INTERNAL_SERVER_ERROR",
+                    message: "Internal Server Error",
+                    traceId,
+                },
+            };
+            return {
+                status: 500,
+                headers: { "content-type": "application/json" },
+                body,
+            };
+        }
+    };
+}
+/** Log full error details in production mode */
+function logUnknownError(log, err, traceId) {
+    log.error("Unhandled error", {
+        traceId,
+        name: err.name,
+        message: err.message,
+        stack: err.stack,
+    });
+}
+//# sourceMappingURL=error-middleware.js.map

package/dist/error-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-middleware.js","sourceRoot":"","sources":["../src/error-middleware.ts"],"names":[],"mappings":"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"}

package/dist/handler.d.ts

@@ -0,0 +1,41 @@
+import type { RouteContract, RequestContext } from "@typokit/types";
+/**
+ * Input received by each handler function.
+ * Types are inferred from the corresponding RouteContract.
+ */
+export type HandlerInput<TContract extends RouteContract<unknown, unknown, unknown, unknown>> = {
+    params: TContract["params"];
+    query: TContract["query"];
+    body: TContract["body"];
+    ctx: RequestContext;
+};
+/**
+ * A handler function that receives typed input and returns the contract's response type.
+ */
+export type HandlerFn<TContract extends RouteContract<unknown, unknown, unknown, unknown>> = (input: HandlerInput<TContract>) => Promise<TContract["response"]> | TContract["response"];
+/**
+ * Maps each route key in TRoutes to a handler function whose input/output
+ * types are inferred from the corresponding RouteContract.
+ */
+export type HandlerDefs<TRoutes extends Record<string, RouteContract<unknown, unknown, unknown, unknown>>> = {
+    [K in keyof TRoutes]: HandlerFn<TRoutes[K]>;
+};
+/**
+ * Define typed handler implementations for a set of route contracts.
+ * The type system enforces that every route key has a handler and that
+ * each handler's signature matches its contract.
+ *
+ * @example
+ * ```typescript
+ * export default defineHandlers<UsersRoutes>({
+ *   "GET /users": async ({ query, ctx }) => {
+ *     return userService.list(query, ctx);
+ *   },
+ *   "POST /users": async ({ body, ctx }) => {
+ *     return userService.create(body, ctx);
+ *   },
+ * });
+ * ```
+ */
+export declare function defineHandlers<TRoutes extends Record<string, RouteContract<unknown, unknown, unknown, unknown>>>(handlers: HandlerDefs<TRoutes>): HandlerDefs<TRoutes>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,YAAY,CACtB,SAAS,SAAS,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IACjE;IACF,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5B,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,GAAG,EAAE,cAAc,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,CACnB,SAAS,SAAS,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IACjE,CACF,KAAK,EAAE,YAAY,CAAC,SAAS,CAAC,KAC3B,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,WAAW,CACrB,OAAO,SAAS,MAAM,CACpB,MAAM,EACN,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAClD,IACC;KACD,CAAC,IAAI,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,SAAS,MAAM,CACpB,MAAM,EACN,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAClD,EACD,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAEtD"}

package/dist/handler.js

@@ -0,0 +1,22 @@
+// @typokit/core — Handler System
+/**
+ * Define typed handler implementations for a set of route contracts.
+ * The type system enforces that every route key has a handler and that
+ * each handler's signature matches its contract.
+ *
+ * @example
+ * ```typescript
+ * export default defineHandlers<UsersRoutes>({
+ *   "GET /users": async ({ query, ctx }) => {
+ *     return userService.list(query, ctx);
+ *   },
+ *   "POST /users": async ({ body, ctx }) => {
+ *     return userService.create(body, ctx);
+ *   },
+ * });
+ * ```
+ */
+export function defineHandlers(handlers) {
+    return handlers;
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAuCjC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAK5B,QAA8B;IAC9B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,48 @@
+import type { BuildContext, BuildResult, CompiledRouteTable, GeneratedOutput, SchemaTypeMap } from "@typokit/types";
+/** A tap registration entry */
+export interface TapEntry<T extends unknown[]> {
+    name: string;
+    fn: (...args: T) => void | Promise<void>;
+}
+/**
+ * Tapable-style async series hook.
+ * Hooks execute in registration order; each receives the same args.
+ */
+export declare class AsyncSeriesHookImpl<T extends unknown[]> {
+    readonly taps: TapEntry<T>[];
+    /** Register a named tap */
+    tap(name: string, fn: (...args: T) => void | Promise<void>): void;
+    /** Execute all taps in series, in registration order */
+    call(...args: T): Promise<void>;
+}
+/** Concrete build pipeline with all 6 hook phases */
+export interface BuildPipelineInstance {
+    hooks: {
+        beforeTransform: AsyncSeriesHookImpl<[BuildContext]>;
+        afterTypeParse: AsyncSeriesHookImpl<[SchemaTypeMap, BuildContext]>;
+        afterValidators: AsyncSeriesHookImpl<[GeneratedOutput[], BuildContext]>;
+        afterRouteTable: AsyncSeriesHookImpl<[CompiledRouteTable, BuildContext]>;
+        emit: AsyncSeriesHookImpl<[GeneratedOutput[], BuildContext]>;
+        done: AsyncSeriesHookImpl<[BuildResult]>;
+    };
+}
+/**
+ * Create a new build pipeline with empty hooks for all 6 phases.
+ * Plugins call `onBuild(pipeline)` to tap into specific phases.
+ */
+export declare function createBuildPipeline(): BuildPipelineInstance;
+/** Hook phase names in execution order */
+export declare const BUILD_HOOK_PHASES: readonly ["beforeTransform", "afterTypeParse", "afterValidators", "afterRouteTable", "emit", "done"];
+export type BuildHookPhase = (typeof BUILD_HOOK_PHASES)[number];
+/** Metadata about a registered tap for introspection */
+export interface TapInfo {
+    hookName: string;
+    tapName: string;
+    order: number;
+}
+/**
+ * Get introspection info about all registered taps in a build pipeline.
+ * Used by `typokit inspect build-pipeline --json`.
+ */
+export declare function getPipelineTaps(pipeline: BuildPipelineInstance): TapInfo[];
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAIxB,+BAA+B;AAC/B,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,mBAAmB,CAAC,CAAC,SAAS,OAAO,EAAE;IAClD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAM;IAElC,2BAA2B;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIjE,wDAAwD;IAClD,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtC;AAID,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE;QACL,eAAe,EAAE,mBAAmB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QACrD,cAAc,EAAE,mBAAmB,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;QACnE,eAAe,EAAE,mBAAmB,CAAC,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QACxE,eAAe,EAAE,mBAAmB,CAAC,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC,CAAC;QACzE,IAAI,EAAE,mBAAmB,CAAC,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAC7D,IAAI,EAAE,mBAAmB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;KAC1C,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,qBAAqB,CAe3D;AAED,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,sGAOpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,wDAAwD;AACxD,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,EAAE,CAiB1E"}

package/dist/hooks.js

@@ -0,0 +1,64 @@
+// @typokit/core — Tapable Hook System Implementation
+/**
+ * Tapable-style async series hook.
+ * Hooks execute in registration order; each receives the same args.
+ */
+export class AsyncSeriesHookImpl {
+    taps = [];
+    /** Register a named tap */
+    tap(name, fn) {
+        this.taps.push({ name, fn });
+    }
+    /** Execute all taps in series, in registration order */
+    async call(...args) {
+        for (const entry of this.taps) {
+            await entry.fn(...args);
+        }
+    }
+}
+/**
+ * Create a new build pipeline with empty hooks for all 6 phases.
+ * Plugins call `onBuild(pipeline)` to tap into specific phases.
+ */
+export function createBuildPipeline() {
+    return {
+        hooks: {
+            beforeTransform: new AsyncSeriesHookImpl(),
+            afterTypeParse: new AsyncSeriesHookImpl(),
+            afterValidators: new AsyncSeriesHookImpl(),
+            afterRouteTable: new AsyncSeriesHookImpl(),
+            emit: new AsyncSeriesHookImpl(),
+            done: new AsyncSeriesHookImpl(),
+        },
+    };
+}
+/** Hook phase names in execution order */
+export const BUILD_HOOK_PHASES = [
+    "beforeTransform",
+    "afterTypeParse",
+    "afterValidators",
+    "afterRouteTable",
+    "emit",
+    "done",
+];
+/**
+ * Get introspection info about all registered taps in a build pipeline.
+ * Used by `typokit inspect build-pipeline --json`.
+ */
+export function getPipelineTaps(pipeline) {
+    const taps = [];
+    for (const phase of BUILD_HOOK_PHASES) {
+        const hook = pipeline.hooks[phase];
+        // Use type assertion since AsyncSeriesHookImpl always has taps
+        const hookImpl = hook;
+        for (let i = 0; i < hookImpl.taps.length; i++) {
+            taps.push({
+                hookName: phase,
+                tapName: hookImpl.taps[i].name,
+                order: i,
+            });
+        }
+    }
+    return taps;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAkBrD;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACrB,IAAI,GAAkB,EAAE,CAAC;IAElC,2BAA2B;IAC3B,GAAG,CAAC,IAAY,EAAE,EAAwC;QACxD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAO;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;CACF;AAgBD;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,KAAK,EAAE;YACL,eAAe,EAAE,IAAI,mBAAmB,EAAkB;YAC1D,cAAc,EAAE,IAAI,mBAAmB,EAAiC;YACxE,eAAe,EAAE,IAAI,mBAAmB,EAErC;YACH,eAAe,EAAE,IAAI,mBAAmB,EAErC;YACH,IAAI,EAAE,IAAI,mBAAmB,EAAqC;YAClE,IAAI,EAAE,IAAI,mBAAmB,EAAiB;SAC/C;KACF,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,MAAM;IACN,MAAM;CACE,CAAC;AAWX;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAA+B;IAC7D,MAAM,IAAI,GAAc,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnC,+DAA+D;QAC/D,MAAM,QAAQ,GAAG,IAAsC,CAAC;QACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC;gBACR,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC9B,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { type ServerAdapter } from "./adapters/server.js";
+export { type DatabaseAdapter, type DatabaseState, type TableState, type ColumnState, } from "./adapters/database.js";
+export { type AsyncSeriesHook, type BuildPipeline, type CliCommand, type InspectEndpoint, type AppInstance, type TypoKitPlugin, } from "./plugin.js";
+export { AsyncSeriesHookImpl, createBuildPipeline, getPipelineTaps, BUILD_HOOK_PHASES, type BuildPipelineInstance, type TapEntry, type TapInfo, type BuildHookPhase, } from "./hooks.js";
+export { type MiddlewareInput, type Middleware, type MiddlewareEntry, defineMiddleware, createPlaceholderLogger, createRequestContext, executeMiddlewareChain, } from "./middleware.js";
+export { type HandlerInput, type HandlerFn, type HandlerDefs, defineHandlers, } from "./handler.js";
+export { type RouteGroup, type CreateAppOptions, type TypoKitApp, createApp, } from "./app.js";
+export { type ErrorMiddlewareOptions, createErrorMiddleware, } from "./error-middleware.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,sBAAsB,EAC3B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { AsyncSeriesHookImpl, createBuildPipeline, getPipelineTaps, BUILD_HOOK_PHASES, } from "./hooks.js";
+export { defineMiddleware, createPlaceholderLogger, createRequestContext, executeMiddlewareChain, } from "./middleware.js";
+export { defineHandlers, } from "./handler.js";
+export { createApp, } from "./app.js";
+export { createErrorMiddleware, } from "./error-middleware.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,GAKlB,MAAM,YAAY,CAAC;AACpB,OAAO,EAIL,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAIL,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAIL,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,OAAO,EAEL,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,35 @@
+import type { TypoKitRequest, RequestContext, Logger } from "@typokit/types";
+/** Input received by a defineMiddleware handler */
+export interface MiddlewareInput {
+    headers: TypoKitRequest["headers"];
+    body: TypoKitRequest["body"];
+    query: TypoKitRequest["query"];
+    params: TypoKitRequest["params"];
+    ctx: RequestContext;
+}
+/** A typed middleware created by defineMiddleware */
+export interface Middleware<TAdded extends Record<string, unknown> = Record<string, unknown>> {
+    handler: (input: MiddlewareInput) => Promise<TAdded>;
+}
+/** An entry in the middleware chain with name and optional priority */
+export interface MiddlewareEntry {
+    name: string;
+    middleware: Middleware;
+    priority?: number;
+}
+/**
+ * Define a typed middleware that receives request properties and returns
+ * additional context properties. Supports context type narrowing.
+ */
+export declare function defineMiddleware<TAdded extends Record<string, unknown>>(handler: (input: MiddlewareInput) => Promise<TAdded>): Middleware<TAdded>;
+/** Create a no-op placeholder logger (actual implementation in observability phase) */
+export declare function createPlaceholderLogger(): Logger;
+/** Create a RequestContext with ctx.fail() and ctx.log placeholder */
+export declare function createRequestContext(overrides?: Partial<RequestContext>): RequestContext;
+/**
+ * Execute a middleware chain in priority order (lower priority runs first).
+ * Each middleware's returned properties are accumulated onto the context.
+ * Middleware can short-circuit by throwing an error.
+ */
+export declare function executeMiddlewareChain(req: TypoKitRequest, ctx: RequestContext, entries: MiddlewareEntry[]): Promise<RequestContext>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7E,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,GAAG,EAAE,cAAc,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEhE,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,GACnD,UAAU,CAAC,MAAM,CAAC,CAEpB;AAED,uFAAuF;AACvF,wBAAgB,uBAAuB,IAAI,MAAM,CAUhD;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAClC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAClC,cAAc,CAgBhB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,eAAe,EAAE,GACzB,OAAO,CAAC,cAAc,CAAC,CAkBzB"}