@mokup/server 1.1.1 → 1.1.3

package/dist/koa.cjs

@@ -0,0 +1,38 @@
+'use strict';
+
+const runtime = require('@mokup/runtime');
+const runtime$1 = require('./shared/server.aaygIV2Q.cjs');
+
+function createKoaMiddleware(options) {
+  const runtime$2 = runtime.createRuntime(runtime$1.toRuntimeOptions(options));
+  const onNotFound = options.onNotFound ?? "next";
+  return async (ctx, next) => {
+    const runtimeRequest = await runtime$1.toRuntimeRequestFromNode(
+      ctx.req,
+      ctx.request?.body
+    );
+    const result = await runtime$2.handle(runtimeRequest);
+    if (!result) {
+      if (onNotFound === "response") {
+        ctx.status = 404;
+        ctx.body = null;
+        return;
+      }
+      await next();
+      return;
+    }
+    ctx.status = result.status;
+    ctx.set(result.headers);
+    if (result.body === null) {
+      ctx.body = null;
+      return;
+    }
+    if (typeof result.body === "string") {
+      ctx.body = result.body;
+      return;
+    }
+    ctx.body = runtime$1.toBinaryBody(result.body);
+  };
+}
+
+exports.createKoaMiddleware = createKoaMiddleware;

package/dist/koa.d.cts

@@ -0,0 +1,29 @@
+import { N as NodeRequestLike } from './shared/server.D0gAciOr.cjs';
+import { S as ServerOptions } from './shared/server.DkerfsA-.cjs';
+import '@mokup/runtime';
+
+interface KoaContextLike {
+    req: NodeRequestLike;
+    request?: {
+        body?: unknown;
+        headers?: Record<string, string | string[] | undefined>;
+    };
+    status?: number;
+    body?: unknown;
+    set: (header: Record<string, string>) => void;
+}
+type KoaNext = () => Promise<unknown>;
+/**
+ * Create a Koa middleware from server options.
+ *
+ * @param options - Server options.
+ * @returns Koa middleware handler.
+ *
+ * @example
+ * import { createKoaMiddleware } from '@mokup/server'
+ *
+ * const middleware = createKoaMiddleware({ manifest: { version: 1, routes: [] } })
+ */
+declare function createKoaMiddleware(options: ServerOptions): (ctx: KoaContextLike, next: KoaNext) => Promise<void>;
+
+export { createKoaMiddleware };

package/dist/koa.d.mts

@@ -0,0 +1,29 @@
+import { N as NodeRequestLike } from './shared/server.D0gAciOr.mjs';
+import { S as ServerOptions } from './shared/server.DkerfsA-.mjs';
+import '@mokup/runtime';
+
+interface KoaContextLike {
+    req: NodeRequestLike;
+    request?: {
+        body?: unknown;
+        headers?: Record<string, string | string[] | undefined>;
+    };
+    status?: number;
+    body?: unknown;
+    set: (header: Record<string, string>) => void;
+}
+type KoaNext = () => Promise<unknown>;
+/**
+ * Create a Koa middleware from server options.
+ *
+ * @param options - Server options.
+ * @returns Koa middleware handler.
+ *
+ * @example
+ * import { createKoaMiddleware } from '@mokup/server'
+ *
+ * const middleware = createKoaMiddleware({ manifest: { version: 1, routes: [] } })
+ */
+declare function createKoaMiddleware(options: ServerOptions): (ctx: KoaContextLike, next: KoaNext) => Promise<void>;
+
+export { createKoaMiddleware };

package/dist/koa.d.ts

@@ -0,0 +1,29 @@
+import { N as NodeRequestLike } from './shared/server.D0gAciOr.js';
+import { S as ServerOptions } from './shared/server.DkerfsA-.js';
+import '@mokup/runtime';
+
+interface KoaContextLike {
+    req: NodeRequestLike;
+    request?: {
+        body?: unknown;
+        headers?: Record<string, string | string[] | undefined>;
+    };
+    status?: number;
+    body?: unknown;
+    set: (header: Record<string, string>) => void;
+}
+type KoaNext = () => Promise<unknown>;
+/**
+ * Create a Koa middleware from server options.
+ *
+ * @param options - Server options.
+ * @returns Koa middleware handler.
+ *
+ * @example
+ * import { createKoaMiddleware } from '@mokup/server'
+ *
+ * const middleware = createKoaMiddleware({ manifest: { version: 1, routes: [] } })
+ */
+declare function createKoaMiddleware(options: ServerOptions): (ctx: KoaContextLike, next: KoaNext) => Promise<void>;
+
+export { createKoaMiddleware };

package/dist/koa.mjs

@@ -0,0 +1,36 @@
+import { createRuntime } from '@mokup/runtime';
+import { t as toRuntimeOptions, a as toRuntimeRequestFromNode, c as toBinaryBody } from './shared/server.LbftO9Jh.mjs';
+
+function createKoaMiddleware(options) {
+  const runtime = createRuntime(toRuntimeOptions(options));
+  const onNotFound = options.onNotFound ?? "next";
+  return async (ctx, next) => {
+    const runtimeRequest = await toRuntimeRequestFromNode(
+      ctx.req,
+      ctx.request?.body
+    );
+    const result = await runtime.handle(runtimeRequest);
+    if (!result) {
+      if (onNotFound === "response") {
+        ctx.status = 404;
+        ctx.body = null;
+        return;
+      }
+      await next();
+      return;
+    }
+    ctx.status = result.status;
+    ctx.set(result.headers);
+    if (result.body === null) {
+      ctx.body = null;
+      return;
+    }
+    if (typeof result.body === "string") {
+      ctx.body = result.body;
+      return;
+    }
+    ctx.body = toBinaryBody(result.body);
+  };
+}
+
+export { createKoaMiddleware };

package/dist/node.cjs

@@ -1,7 +1,33 @@
 'use strict';
 
+const connect = require('./connect.cjs');
+const express = require('./express.cjs');
+const fastify = require('./fastify.cjs');
+const fetchServer = require('./fetch-server.cjs');
+const hono = require('./hono.cjs');
+const koa = require('./koa.cjs');
+const workerNode = require('./worker-node.cjs');
 const nodeServer = require('@hono/node-server');
+require('@mokup/runtime');
+require('./shared/server.aaygIV2Q.cjs');
+require('@mokup/shared/pathe');
+require('node:fs');
+require('node:module');
+require('node:process');
+require('node:buffer');
+require('node:url');
+require('@mokup/shared/esbuild');
+require('@mokup/shared/jsonc-parser');
+require('@mokup/shared/hono');
+require('./fetch.cjs');
 
 
 
+exports.createConnectMiddleware = connect.createConnectMiddleware;
+exports.createExpressMiddleware = express.createExpressMiddleware;
+exports.createFastifyPlugin = fastify.createFastifyPlugin;
+exports.createFetchServer = fetchServer.createFetchServer;
+exports.createHonoMiddleware = hono.createHonoMiddleware;
+exports.createKoaMiddleware = koa.createKoaMiddleware;
+exports.createMokupWorker = workerNode.createMokupWorker;
 exports.serve = nodeServer.serve;

package/dist/node.d.cts

@@ -1 +1,14 @@
+export { createConnectMiddleware } from './connect.cjs';
+export { createExpressMiddleware } from './express.cjs';
+export { createFastifyPlugin } from './fastify.cjs';
+export { FetchServer, FetchServerOptions, FetchServerOptionsConfig, FetchServerOptionsInput, createFetchServer } from './fetch-server.cjs';
+export { createHonoMiddleware } from './hono.cjs';
+export { createKoaMiddleware } from './koa.cjs';
+export { NodeWorkerInput, createMokupWorker } from './worker-node.cjs';
 export { serve } from '@hono/node-server';
+import './shared/server.D0gAciOr.cjs';
+import './shared/server.DkerfsA-.cjs';
+import '@mokup/runtime';
+import './shared/server.CyVIKPsp.cjs';
+import '@mokup/shared/hono';
+import '@mokup/shared';

package/dist/node.d.mts

@@ -1 +1,14 @@
+export { createConnectMiddleware } from './connect.mjs';
+export { createExpressMiddleware } from './express.mjs';
+export { createFastifyPlugin } from './fastify.mjs';
+export { FetchServer, FetchServerOptions, FetchServerOptionsConfig, FetchServerOptionsInput, createFetchServer } from './fetch-server.mjs';
+export { createHonoMiddleware } from './hono.mjs';
+export { createKoaMiddleware } from './koa.mjs';
+export { NodeWorkerInput, createMokupWorker } from './worker-node.mjs';
 export { serve } from '@hono/node-server';
+import './shared/server.D0gAciOr.mjs';
+import './shared/server.DkerfsA-.mjs';
+import '@mokup/runtime';
+import './shared/server.CyVIKPsp.mjs';
+import '@mokup/shared/hono';
+import '@mokup/shared';

package/dist/node.d.ts

@@ -1 +1,14 @@
+export { createConnectMiddleware } from './connect.js';
+export { createExpressMiddleware } from './express.js';
+export { createFastifyPlugin } from './fastify.js';
+export { FetchServer, FetchServerOptions, FetchServerOptionsConfig, FetchServerOptionsInput, createFetchServer } from './fetch-server.js';
+export { createHonoMiddleware } from './hono.js';
+export { createKoaMiddleware } from './koa.js';
+export { NodeWorkerInput, createMokupWorker } from './worker-node.js';
 export { serve } from '@hono/node-server';
+import './shared/server.D0gAciOr.js';
+import './shared/server.DkerfsA-.js';
+import '@mokup/runtime';
+import './shared/server.CyVIKPsp.js';
+import '@mokup/shared/hono';
+import '@mokup/shared';

package/dist/node.mjs

@@ -1 +1,20 @@
+export { createConnectMiddleware } from './connect.mjs';
+export { createExpressMiddleware } from './express.mjs';
+export { createFastifyPlugin } from './fastify.mjs';
+export { createFetchServer } from './fetch-server.mjs';
+export { createHonoMiddleware } from './hono.mjs';
+export { createKoaMiddleware } from './koa.mjs';
+export { createMokupWorker } from './worker-node.mjs';
 export { serve } from '@hono/node-server';
+import '@mokup/runtime';
+import './shared/server.LbftO9Jh.mjs';
+import '@mokup/shared/pathe';
+import 'node:fs';
+import 'node:module';
+import 'node:process';
+import 'node:buffer';
+import 'node:url';
+import '@mokup/shared/esbuild';
+import '@mokup/shared/jsonc-parser';
+import '@mokup/shared/hono';
+import './fetch.mjs';

package/dist/shared/server.CyVIKPsp.d.cts

@@ -0,0 +1,214 @@
+import { RouteToken } from '@mokup/runtime';
+import { MiddlewareHandler, Context } from '@mokup/shared/hono';
+
+/**
+ * Supported HTTP methods for server dev routes.
+ *
+ * @example
+ * import type { HttpMethod } from '@mokup/server'
+ *
+ * const method: HttpMethod = 'GET'
+ */
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+/**
+ * Static response payloads supported by route rules.
+ *
+ * @example
+ * import type { RouteStaticResponse } from '@mokup/server'
+ *
+ * const value: RouteStaticResponse = { ok: true }
+ */
+type RouteStaticResponse = string | number | boolean | bigint | symbol | null | undefined | object;
+/**
+ * Allowed return value from a route handler.
+ *
+ * @example
+ * import type { RouteHandlerResult } from '@mokup/server'
+ *
+ * const result: RouteHandlerResult = 'ok'
+ */
+type RouteHandlerResult = RouteStaticResponse | Response;
+/**
+ * Request handler signature for server dev routes.
+ *
+ * @example
+ * import type { RequestHandler } from '@mokup/server'
+ *
+ * const handler: RequestHandler = (c) => c.json({ ok: true })
+ */
+type RequestHandler = (context: Context) => RouteHandlerResult | Promise<RouteHandlerResult>;
+/**
+ * Route response as a static value or handler.
+ *
+ * @example
+ * import type { RouteResponse } from '@mokup/server'
+ *
+ * const response: RouteResponse = { ok: true }
+ */
+type RouteResponse = RouteStaticResponse | RequestHandler;
+/**
+ * Rule metadata for a route handler.
+ *
+ * @example
+ * import type { RouteRule } from '@mokup/server'
+ *
+ * const rule: RouteRule = {
+ *   handler: () => ({ ok: true }),
+ * }
+ */
+interface RouteRule {
+    /** Handler for the route. */
+    handler: RouteResponse;
+    /**
+     * Enable or disable this rule.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Override response status code.
+     *
+     * @default 200
+     */
+    status?: number;
+    /**
+     * Additional response headers.
+     *
+     * @default {}
+     */
+    headers?: Record<string, string>;
+    /**
+     * Delay in milliseconds before responding.
+     *
+     * @default 0
+     */
+    delay?: number;
+}
+/**
+ * Directory-level config for server dev scanning.
+ *
+ * @example
+ * import type { RouteDirectoryConfig } from '@mokup/server'
+ *
+ * const config: RouteDirectoryConfig = { headers: { 'x-mokup': 'dir' } }
+ */
+interface RouteDirectoryConfig {
+    /**
+     * Headers applied to routes in this directory.
+     *
+     * @default {}
+     */
+    headers?: Record<string, string>;
+    /**
+     * Default status code override.
+     *
+     * @default 200
+     */
+    status?: number;
+    /**
+     * Default delay in milliseconds.
+     *
+     * @default 0
+     */
+    delay?: number;
+    /**
+     * Enable or disable this directory.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Ignore prefixes for files.
+     *
+     * @default ["."]
+     */
+    ignorePrefix?: string | string[];
+    /**
+     * Include filter.
+     *
+     * @default undefined
+     */
+    include?: RegExp | RegExp[];
+    /**
+     * Exclude filter.
+     *
+     * @default undefined
+     */
+    exclude?: RegExp | RegExp[];
+    /**
+     * Middleware for this directory.
+     *
+     * @default undefined
+     */
+    middleware?: MiddlewareHandler | MiddlewareHandler[];
+}
+/**
+ * Middleware execution position.
+ *
+ * @example
+ * import type { MiddlewarePosition } from '@mokup/server'
+ *
+ * const position: MiddlewarePosition = 'pre'
+ */
+type MiddlewarePosition = 'pre' | 'normal' | 'post';
+/**
+ * Middleware registry used by defineConfig.
+ *
+ * @example
+ * import type { MiddlewareRegistry } from '@mokup/server'
+ *
+ * const registry: MiddlewareRegistry = { use: () => {} }
+ */
+interface MiddlewareRegistry {
+    use: (...handlers: MiddlewareHandler[]) => void;
+}
+/**
+ * Normalized middleware metadata.
+ *
+ * @example
+ * import type { ResolvedMiddleware } from '@mokup/server'
+ *
+ * const item: ResolvedMiddleware = { handle: () => {}, source: 'index.config.ts', index: 0 }
+ */
+interface ResolvedMiddleware {
+    handle: MiddlewareHandler;
+    source: string;
+    index: number;
+    /**
+     * Position in the middleware chain.
+     *
+     * @default "normal"
+     */
+    position: MiddlewarePosition;
+}
+/**
+ * Fully resolved route metadata.
+ *
+ * @example
+ * import type { ResolvedRoute } from '@mokup/server'
+ *
+ * const route: ResolvedRoute = {
+ *   file: '/mock/ping.get.ts',
+ *   template: '/ping',
+ *   method: 'GET',
+ *   tokens: [{ type: 'static', value: 'ping' }],
+ *   score: [4],
+ *   handler: () => ({ ok: true }),
+ * }
+ */
+interface ResolvedRoute {
+    file: string;
+    template: string;
+    method: HttpMethod;
+    tokens: RouteToken[];
+    score: number[];
+    handler: RouteResponse;
+    middlewares?: ResolvedMiddleware[];
+    status?: number;
+    headers?: Record<string, string>;
+    delay?: number;
+    ruleIndex?: number;
+}
+type RouteTable = ResolvedRoute[];
+
+export type { MiddlewareRegistry as M, RouteDirectoryConfig as R, MiddlewarePosition as a, ResolvedMiddleware as b, RouteRule as c, RouteTable as d };

package/dist/shared/server.CyVIKPsp.d.mts

@@ -0,0 +1,214 @@
+import { RouteToken } from '@mokup/runtime';
+import { MiddlewareHandler, Context } from '@mokup/shared/hono';
+
+/**
+ * Supported HTTP methods for server dev routes.
+ *
+ * @example
+ * import type { HttpMethod } from '@mokup/server'
+ *
+ * const method: HttpMethod = 'GET'
+ */
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+/**
+ * Static response payloads supported by route rules.
+ *
+ * @example
+ * import type { RouteStaticResponse } from '@mokup/server'
+ *
+ * const value: RouteStaticResponse = { ok: true }
+ */
+type RouteStaticResponse = string | number | boolean | bigint | symbol | null | undefined | object;
+/**
+ * Allowed return value from a route handler.
+ *
+ * @example
+ * import type { RouteHandlerResult } from '@mokup/server'
+ *
+ * const result: RouteHandlerResult = 'ok'
+ */
+type RouteHandlerResult = RouteStaticResponse | Response;
+/**
+ * Request handler signature for server dev routes.
+ *
+ * @example
+ * import type { RequestHandler } from '@mokup/server'
+ *
+ * const handler: RequestHandler = (c) => c.json({ ok: true })
+ */
+type RequestHandler = (context: Context) => RouteHandlerResult | Promise<RouteHandlerResult>;
+/**
+ * Route response as a static value or handler.
+ *
+ * @example
+ * import type { RouteResponse } from '@mokup/server'
+ *
+ * const response: RouteResponse = { ok: true }
+ */
+type RouteResponse = RouteStaticResponse | RequestHandler;
+/**
+ * Rule metadata for a route handler.
+ *
+ * @example
+ * import type { RouteRule } from '@mokup/server'
+ *
+ * const rule: RouteRule = {
+ *   handler: () => ({ ok: true }),
+ * }
+ */
+interface RouteRule {
+    /** Handler for the route. */
+    handler: RouteResponse;
+    /**
+     * Enable or disable this rule.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Override response status code.
+     *
+     * @default 200
+     */
+    status?: number;
+    /**
+     * Additional response headers.
+     *
+     * @default {}
+     */
+    headers?: Record<string, string>;
+    /**
+     * Delay in milliseconds before responding.
+     *
+     * @default 0
+     */
+    delay?: number;
+}
+/**
+ * Directory-level config for server dev scanning.
+ *
+ * @example
+ * import type { RouteDirectoryConfig } from '@mokup/server'
+ *
+ * const config: RouteDirectoryConfig = { headers: { 'x-mokup': 'dir' } }
+ */
+interface RouteDirectoryConfig {
+    /**
+     * Headers applied to routes in this directory.
+     *
+     * @default {}
+     */
+    headers?: Record<string, string>;
+    /**
+     * Default status code override.
+     *
+     * @default 200
+     */
+    status?: number;
+    /**
+     * Default delay in milliseconds.
+     *
+     * @default 0
+     */
+    delay?: number;
+    /**
+     * Enable or disable this directory.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Ignore prefixes for files.
+     *
+     * @default ["."]
+     */
+    ignorePrefix?: string | string[];
+    /**
+     * Include filter.
+     *
+     * @default undefined
+     */
+    include?: RegExp | RegExp[];
+    /**
+     * Exclude filter.
+     *
+     * @default undefined
+     */
+    exclude?: RegExp | RegExp[];
+    /**
+     * Middleware for this directory.
+     *
+     * @default undefined
+     */
+    middleware?: MiddlewareHandler | MiddlewareHandler[];
+}
+/**
+ * Middleware execution position.
+ *
+ * @example
+ * import type { MiddlewarePosition } from '@mokup/server'
+ *
+ * const position: MiddlewarePosition = 'pre'
+ */
+type MiddlewarePosition = 'pre' | 'normal' | 'post';
+/**
+ * Middleware registry used by defineConfig.
+ *
+ * @example
+ * import type { MiddlewareRegistry } from '@mokup/server'
+ *
+ * const registry: MiddlewareRegistry = { use: () => {} }
+ */
+interface MiddlewareRegistry {
+    use: (...handlers: MiddlewareHandler[]) => void;
+}
+/**
+ * Normalized middleware metadata.
+ *
+ * @example
+ * import type { ResolvedMiddleware } from '@mokup/server'
+ *
+ * const item: ResolvedMiddleware = { handle: () => {}, source: 'index.config.ts', index: 0 }
+ */
+interface ResolvedMiddleware {
+    handle: MiddlewareHandler;
+    source: string;
+    index: number;
+    /**
+     * Position in the middleware chain.
+     *
+     * @default "normal"
+     */
+    position: MiddlewarePosition;
+}
+/**
+ * Fully resolved route metadata.
+ *
+ * @example
+ * import type { ResolvedRoute } from '@mokup/server'
+ *
+ * const route: ResolvedRoute = {
+ *   file: '/mock/ping.get.ts',
+ *   template: '/ping',
+ *   method: 'GET',
+ *   tokens: [{ type: 'static', value: 'ping' }],
+ *   score: [4],
+ *   handler: () => ({ ok: true }),
+ * }
+ */
+interface ResolvedRoute {
+    file: string;
+    template: string;
+    method: HttpMethod;
+    tokens: RouteToken[];
+    score: number[];
+    handler: RouteResponse;
+    middlewares?: ResolvedMiddleware[];
+    status?: number;
+    headers?: Record<string, string>;
+    delay?: number;
+    ruleIndex?: number;
+}
+type RouteTable = ResolvedRoute[];
+
+export type { MiddlewareRegistry as M, RouteDirectoryConfig as R, MiddlewarePosition as a, ResolvedMiddleware as b, RouteRule as c, RouteTable as d };