@mokup/server 1.1.2 → 1.1.4

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

@@ -0,0 +1,46 @@
+/**
+ * Minimal readable stream shape used by adapters.
+ *
+ * @example
+ * import type { ReadableStreamLike } from '@mokup/server'
+ *
+ * const stream: ReadableStreamLike = {
+ *   on: () => {},
+ * }
+ */
+interface ReadableStreamLike {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+}
+/**
+ * Minimal Node request shape used by adapters.
+ *
+ * @example
+ * import type { NodeRequestLike } from '@mokup/server'
+ *
+ * const req: NodeRequestLike = { method: 'GET', url: '/api/ping' }
+ */
+interface NodeRequestLike extends ReadableStreamLike {
+    method?: string;
+    url?: string;
+    originalUrl?: string;
+    headers?: Record<string, string | string[] | undefined>;
+    body?: unknown;
+}
+/**
+ * Minimal Node response shape used by adapters.
+ *
+ * @example
+ * import type { NodeResponseLike } from '@mokup/server'
+ *
+ * const res: NodeResponseLike = {
+ *   setHeader: () => {},
+ *   end: () => {},
+ * }
+ */
+interface NodeResponseLike {
+    statusCode?: number;
+    setHeader: (name: string, value: string) => void;
+    end: (data?: string | Uint8Array | ArrayBuffer | null) => void;
+}
+
+export type { NodeRequestLike as N, NodeResponseLike as a };

package/dist/shared/server.D0gAciOr.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Minimal readable stream shape used by adapters.
+ *
+ * @example
+ * import type { ReadableStreamLike } from '@mokup/server'
+ *
+ * const stream: ReadableStreamLike = {
+ *   on: () => {},
+ * }
+ */
+interface ReadableStreamLike {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+}
+/**
+ * Minimal Node request shape used by adapters.
+ *
+ * @example
+ * import type { NodeRequestLike } from '@mokup/server'
+ *
+ * const req: NodeRequestLike = { method: 'GET', url: '/api/ping' }
+ */
+interface NodeRequestLike extends ReadableStreamLike {
+    method?: string;
+    url?: string;
+    originalUrl?: string;
+    headers?: Record<string, string | string[] | undefined>;
+    body?: unknown;
+}
+/**
+ * Minimal Node response shape used by adapters.
+ *
+ * @example
+ * import type { NodeResponseLike } from '@mokup/server'
+ *
+ * const res: NodeResponseLike = {
+ *   setHeader: () => {},
+ *   end: () => {},
+ * }
+ */
+interface NodeResponseLike {
+    statusCode?: number;
+    setHeader: (name: string, value: string) => void;
+    end: (data?: string | Uint8Array | ArrayBuffer | null) => void;
+}
+
+export type { NodeRequestLike as N, NodeResponseLike as a };

package/dist/shared/server.DkerfsA-.d.cts

@@ -0,0 +1,73 @@
+import { RuntimeOptions, Manifest, ModuleMap } from '@mokup/runtime';
+
+/**
+ * Options for server adapters built on top of the runtime.
+ *
+ * @example
+ * import type { ServerOptions } from '@mokup/server'
+ *
+ * const options: ServerOptions = {
+ *   manifest: { version: 1, routes: [] },
+ *   onNotFound: 'next',
+ * }
+ */
+interface ServerOptions extends RuntimeOptions {
+    /**
+     * Behavior when no route matches.
+     *
+     * @default "next"
+     */
+    onNotFound?: 'next' | 'response';
+}
+/**
+ * Fetch handler signature used by server adapters.
+ *
+ * @example
+ * import type { FetchHandler } from '@mokup/server'
+ *
+ * const handler: FetchHandler = async (request) => new Response('ok')
+ */
+type FetchHandler = (request: Request) => Promise<Response | null>;
+/**
+ * Bundle input for Worker helpers.
+ *
+ * @example
+ * import type { WorkerBundle } from '@mokup/server'
+ *
+ * const bundle: WorkerBundle = {
+ *   manifest: { version: 1, routes: [] },
+ * }
+ */
+interface WorkerBundle {
+    /** Manifest for runtime execution. */
+    manifest: Manifest;
+    /**
+     * In-memory module map for handler execution.
+     *
+     * @default undefined
+     */
+    moduleMap?: ModuleMap;
+    /**
+     * Base directory for module resolution.
+     *
+     * @default undefined
+     */
+    moduleBase?: string | URL;
+    /**
+     * Behavior when no route matches.
+     *
+     * @default "response"
+     */
+    onNotFound?: 'next' | 'response';
+}
+/**
+ * Worker input accepted by createMokupWorker.
+ *
+ * @example
+ * import type { WorkerInput } from '@mokup/server'
+ *
+ * const input: WorkerInput = { version: 1, routes: [] }
+ */
+type WorkerInput = Manifest | WorkerBundle;
+
+export type { FetchHandler as F, ServerOptions as S, WorkerBundle as W, WorkerInput as a };

package/dist/shared/server.DkerfsA-.d.mts

@@ -0,0 +1,73 @@
+import { RuntimeOptions, Manifest, ModuleMap } from '@mokup/runtime';
+
+/**
+ * Options for server adapters built on top of the runtime.
+ *
+ * @example
+ * import type { ServerOptions } from '@mokup/server'
+ *
+ * const options: ServerOptions = {
+ *   manifest: { version: 1, routes: [] },
+ *   onNotFound: 'next',
+ * }
+ */
+interface ServerOptions extends RuntimeOptions {
+    /**
+     * Behavior when no route matches.
+     *
+     * @default "next"
+     */
+    onNotFound?: 'next' | 'response';
+}
+/**
+ * Fetch handler signature used by server adapters.
+ *
+ * @example
+ * import type { FetchHandler } from '@mokup/server'
+ *
+ * const handler: FetchHandler = async (request) => new Response('ok')
+ */
+type FetchHandler = (request: Request) => Promise<Response | null>;
+/**
+ * Bundle input for Worker helpers.
+ *
+ * @example
+ * import type { WorkerBundle } from '@mokup/server'
+ *
+ * const bundle: WorkerBundle = {
+ *   manifest: { version: 1, routes: [] },
+ * }
+ */
+interface WorkerBundle {
+    /** Manifest for runtime execution. */
+    manifest: Manifest;
+    /**
+     * In-memory module map for handler execution.
+     *
+     * @default undefined
+     */
+    moduleMap?: ModuleMap;
+    /**
+     * Base directory for module resolution.
+     *
+     * @default undefined
+     */
+    moduleBase?: string | URL;
+    /**
+     * Behavior when no route matches.
+     *
+     * @default "response"
+     */
+    onNotFound?: 'next' | 'response';
+}
+/**
+ * Worker input accepted by createMokupWorker.
+ *
+ * @example
+ * import type { WorkerInput } from '@mokup/server'
+ *
+ * const input: WorkerInput = { version: 1, routes: [] }
+ */
+type WorkerInput = Manifest | WorkerBundle;
+
+export type { FetchHandler as F, ServerOptions as S, WorkerBundle as W, WorkerInput as a };

package/dist/shared/server.DkerfsA-.d.ts

@@ -0,0 +1,73 @@
+import { RuntimeOptions, Manifest, ModuleMap } from '@mokup/runtime';
+
+/**
+ * Options for server adapters built on top of the runtime.
+ *
+ * @example
+ * import type { ServerOptions } from '@mokup/server'
+ *
+ * const options: ServerOptions = {
+ *   manifest: { version: 1, routes: [] },
+ *   onNotFound: 'next',
+ * }
+ */
+interface ServerOptions extends RuntimeOptions {
+    /**
+     * Behavior when no route matches.
+     *
+     * @default "next"
+     */
+    onNotFound?: 'next' | 'response';
+}
+/**
+ * Fetch handler signature used by server adapters.
+ *
+ * @example
+ * import type { FetchHandler } from '@mokup/server'
+ *
+ * const handler: FetchHandler = async (request) => new Response('ok')
+ */
+type FetchHandler = (request: Request) => Promise<Response | null>;
+/**
+ * Bundle input for Worker helpers.
+ *
+ * @example
+ * import type { WorkerBundle } from '@mokup/server'
+ *
+ * const bundle: WorkerBundle = {
+ *   manifest: { version: 1, routes: [] },
+ * }
+ */
+interface WorkerBundle {
+    /** Manifest for runtime execution. */
+    manifest: Manifest;
+    /**
+     * In-memory module map for handler execution.
+     *
+     * @default undefined
+     */
+    moduleMap?: ModuleMap;
+    /**
+     * Base directory for module resolution.
+     *
+     * @default undefined
+     */
+    moduleBase?: string | URL;
+    /**
+     * Behavior when no route matches.
+     *
+     * @default "response"
+     */
+    onNotFound?: 'next' | 'response';
+}
+/**
+ * Worker input accepted by createMokupWorker.
+ *
+ * @example
+ * import type { WorkerInput } from '@mokup/server'
+ *
+ * const input: WorkerInput = { version: 1, routes: [] }
+ */
+type WorkerInput = Manifest | WorkerBundle;
+
+export type { FetchHandler as F, ServerOptions as S, WorkerBundle as W, WorkerInput as a };

package/dist/shared/{server.tZ4R8aB2.mjs → server.LbftO9Jh.mjs}

@@ -1,51 +1,5 @@
 const textDecoder = new TextDecoder();
 const textEncoder = new TextEncoder();
-function toRuntimeOptions(options) {
-  const runtimeOptions = {
-    manifest: options.manifest
-  };
-  if (typeof options.moduleBase !== "undefined") {
-    runtimeOptions.moduleBase = options.moduleBase;
-  }
-  if (typeof options.moduleMap !== "undefined") {
-    runtimeOptions.moduleMap = options.moduleMap;
-  }
-  return runtimeOptions;
-}
-function normalizeQuery(params) {
-  const query = {};
-  for (const [key, value] of params.entries()) {
-    const current = query[key];
-    if (typeof current === "undefined") {
-      query[key] = value;
-    } else if (Array.isArray(current)) {
-      current.push(value);
-    } else {
-      query[key] = [current, value];
-    }
-  }
-  return query;
-}
-function normalizeHeaders(headers) {
-  const record = {};
-  headers.forEach((value, key) => {
-    record[key.toLowerCase()] = value;
-  });
-  return record;
-}
-function normalizeNodeHeaders(headers) {
-  if (!headers) {
-    return {};
-  }
-  const record = {};
-  for (const [key, value] of Object.entries(headers)) {
-    if (typeof value === "undefined") {
-      continue;
-    }
-    record[key.toLowerCase()] = Array.isArray(value) ? value.join(",") : String(value);
-  }
-  return record;
-}
 function parseBody(rawText, contentType) {
   if (!rawText) {
     return void 0;
@@ -78,14 +32,6 @@ function toArrayBuffer(body) {
   copy.set(body);
   return copy.buffer;
 }
-function resolveUrl(input, headers) {
-  if (/^https?:\/\//.test(input)) {
-    return new URL(input);
-  }
-  const host = headers.host;
-  const base = host ? `http://${host}` : "http://localhost";
-  return new URL(input, base);
-}
 function concatChunks(chunks) {
   if (chunks.length === 1) {
     return chunks[0] ?? new Uint8Array();
@@ -173,6 +119,50 @@ async function resolveBody(body, contentType, stream) {
     rawBody: rawText
   };
 }
+
+function normalizeQuery(params) {
+  const query = {};
+  for (const [key, value] of params.entries()) {
+    const current = query[key];
+    if (typeof current === "undefined") {
+      query[key] = value;
+    } else if (Array.isArray(current)) {
+      current.push(value);
+    } else {
+      query[key] = [current, value];
+    }
+  }
+  return query;
+}
+function normalizeHeaders(headers) {
+  const record = {};
+  headers.forEach((value, key) => {
+    record[key.toLowerCase()] = value;
+  });
+  return record;
+}
+function normalizeNodeHeaders(headers) {
+  if (!headers) {
+    return {};
+  }
+  const record = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (typeof value === "undefined") {
+      continue;
+    }
+    record[key.toLowerCase()] = Array.isArray(value) ? value.join(",") : String(value);
+  }
+  return record;
+}
+function resolveUrl(input, headers) {
+  if (/^https?:\/\//.test(input)) {
+    return new URL(input);
+  }
+  const host = headers.host;
+  const base = host ? `http://${host}` : "http://localhost";
+  return new URL(input, base);
+}
+
 function buildRuntimeRequest(url, method, headers, body, rawBody) {
   const request = {
     method,
@@ -217,6 +207,19 @@ async function toRuntimeRequestFromNode(req, bodyOverride) {
     resolvedBody.rawBody
   );
 }
+
+function toRuntimeOptions(options) {
+  const runtimeOptions = {
+    manifest: options.manifest
+  };
+  if (typeof options.moduleBase !== "undefined") {
+    runtimeOptions.moduleBase = options.moduleBase;
+  }
+  if (typeof options.moduleMap !== "undefined") {
+    runtimeOptions.moduleMap = options.moduleMap;
+  }
+  return runtimeOptions;
+}
 function applyRuntimeResultToNode(res, result) {
   res.statusCode = result.status;
   for (const [key, value] of Object.entries(result.headers)) {

package/dist/shared/{server.3GcmR3Ev.cjs → server.aaygIV2Q.cjs}

@@ -2,52 +2,6 @@
 
 const textDecoder = new TextDecoder();
 const textEncoder = new TextEncoder();
-function toRuntimeOptions(options) {
-  const runtimeOptions = {
-    manifest: options.manifest
-  };
-  if (typeof options.moduleBase !== "undefined") {
-    runtimeOptions.moduleBase = options.moduleBase;
-  }
-  if (typeof options.moduleMap !== "undefined") {
-    runtimeOptions.moduleMap = options.moduleMap;
-  }
-  return runtimeOptions;
-}
-function normalizeQuery(params) {
-  const query = {};
-  for (const [key, value] of params.entries()) {
-    const current = query[key];
-    if (typeof current === "undefined") {
-      query[key] = value;
-    } else if (Array.isArray(current)) {
-      current.push(value);
-    } else {
-      query[key] = [current, value];
-    }
-  }
-  return query;
-}
-function normalizeHeaders(headers) {
-  const record = {};
-  headers.forEach((value, key) => {
-    record[key.toLowerCase()] = value;
-  });
-  return record;
-}
-function normalizeNodeHeaders(headers) {
-  if (!headers) {
-    return {};
-  }
-  const record = {};
-  for (const [key, value] of Object.entries(headers)) {
-    if (typeof value === "undefined") {
-      continue;
-    }
-    record[key.toLowerCase()] = Array.isArray(value) ? value.join(",") : String(value);
-  }
-  return record;
-}
 function parseBody(rawText, contentType) {
   if (!rawText) {
     return void 0;
@@ -80,14 +34,6 @@ function toArrayBuffer(body) {
   copy.set(body);
   return copy.buffer;
 }
-function resolveUrl(input, headers) {
-  if (/^https?:\/\//.test(input)) {
-    return new URL(input);
-  }
-  const host = headers.host;
-  const base = host ? `http://${host}` : "http://localhost";
-  return new URL(input, base);
-}
 function concatChunks(chunks) {
   if (chunks.length === 1) {
     return chunks[0] ?? new Uint8Array();
@@ -175,6 +121,50 @@ async function resolveBody(body, contentType, stream) {
     rawBody: rawText
   };
 }
+
+function normalizeQuery(params) {
+  const query = {};
+  for (const [key, value] of params.entries()) {
+    const current = query[key];
+    if (typeof current === "undefined") {
+      query[key] = value;
+    } else if (Array.isArray(current)) {
+      current.push(value);
+    } else {
+      query[key] = [current, value];
+    }
+  }
+  return query;
+}
+function normalizeHeaders(headers) {
+  const record = {};
+  headers.forEach((value, key) => {
+    record[key.toLowerCase()] = value;
+  });
+  return record;
+}
+function normalizeNodeHeaders(headers) {
+  if (!headers) {
+    return {};
+  }
+  const record = {};
+  for (const [key, value] of Object.entries(headers)) {
+    if (typeof value === "undefined") {
+      continue;
+    }
+    record[key.toLowerCase()] = Array.isArray(value) ? value.join(",") : String(value);
+  }
+  return record;
+}
+function resolveUrl(input, headers) {
+  if (/^https?:\/\//.test(input)) {
+    return new URL(input);
+  }
+  const host = headers.host;
+  const base = host ? `http://${host}` : "http://localhost";
+  return new URL(input, base);
+}
+
 function buildRuntimeRequest(url, method, headers, body, rawBody) {
   const request = {
     method,
@@ -219,6 +209,19 @@ async function toRuntimeRequestFromNode(req, bodyOverride) {
     resolvedBody.rawBody
   );
 }
+
+function toRuntimeOptions(options) {
+  const runtimeOptions = {
+    manifest: options.manifest
+  };
+  if (typeof options.moduleBase !== "undefined") {
+    runtimeOptions.moduleBase = options.moduleBase;
+  }
+  if (typeof options.moduleMap !== "undefined") {
+    runtimeOptions.moduleMap = options.moduleMap;
+  }
+  return runtimeOptions;
+}
 function applyRuntimeResultToNode(res, result) {
   res.statusCode = result.status;
   for (const [key, value] of Object.entries(result.headers)) {

package/dist/worker-node.cjs

@@ -2,7 +2,7 @@
 
 const fetch = require('./fetch.cjs');
 require('@mokup/runtime');
-require('./shared/server.3GcmR3Ev.cjs');
+require('./shared/server.aaygIV2Q.cjs');
 
 function isManifest(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) && "version" in value && "routes" in value;

package/dist/worker-node.d.cts

@@ -1,10 +1,38 @@
-import { a as WorkerInput } from './shared/server.B82hrXoo.cjs';
+import { a as WorkerInput } from './shared/server.DkerfsA-.cjs';
 import '@mokup/runtime';
 
+/**
+ * Minimal Worker-style fetch interface for Node helpers.
+ *
+ * @example
+ * import type { FetchWorker } from '@mokup/server/node'
+ *
+ * const worker: FetchWorker = { fetch: async () => new Response('ok') }
+ */
 interface FetchWorker {
+    /** Fetch handler for the Worker runtime. */
     fetch: (request: Request) => Promise<Response>;
 }
+/**
+ * Input accepted by the Node worker helper.
+ *
+ * @example
+ * import type { NodeWorkerInput } from '@mokup/server/node'
+ *
+ * const input: NodeWorkerInput = '.mokup'
+ */
 type NodeWorkerInput = string | WorkerInput;
+/**
+ * Create a Worker-compatible fetch handler for Node.
+ *
+ * @param input - Directory path, manifest, or bundle.
+ * @returns Worker handler or a promise when input is a directory.
+ *
+ * @example
+ * import { createMokupWorker } from '@mokup/server/node'
+ *
+ * const worker = await createMokupWorker('.mokup')
+ */
 declare function createMokupWorker(input: string): Promise<FetchWorker>;
 declare function createMokupWorker(input: WorkerInput): FetchWorker;
 

package/dist/worker-node.d.mts

@@ -1,10 +1,38 @@
-import { a as WorkerInput } from './shared/server.B82hrXoo.mjs';
+import { a as WorkerInput } from './shared/server.DkerfsA-.mjs';
 import '@mokup/runtime';
 
+/**
+ * Minimal Worker-style fetch interface for Node helpers.
+ *
+ * @example
+ * import type { FetchWorker } from '@mokup/server/node'
+ *
+ * const worker: FetchWorker = { fetch: async () => new Response('ok') }
+ */
 interface FetchWorker {
+    /** Fetch handler for the Worker runtime. */
     fetch: (request: Request) => Promise<Response>;
 }
+/**
+ * Input accepted by the Node worker helper.
+ *
+ * @example
+ * import type { NodeWorkerInput } from '@mokup/server/node'
+ *
+ * const input: NodeWorkerInput = '.mokup'
+ */
 type NodeWorkerInput = string | WorkerInput;
+/**
+ * Create a Worker-compatible fetch handler for Node.
+ *
+ * @param input - Directory path, manifest, or bundle.
+ * @returns Worker handler or a promise when input is a directory.
+ *
+ * @example
+ * import { createMokupWorker } from '@mokup/server/node'
+ *
+ * const worker = await createMokupWorker('.mokup')
+ */
 declare function createMokupWorker(input: string): Promise<FetchWorker>;
 declare function createMokupWorker(input: WorkerInput): FetchWorker;