mokup 2.3.0 → 2.3.1

package/dist/shared/mokup.Dkqu10Hk.d.ts

@@ -1,379 +0,0 @@
-import { RouteToken } from '@mokup/runtime';
-import { MockEntryOptions, PlaygroundOptionsInput } from '@mokup/shared';
-import { Context, MiddlewareHandler } from '@mokup/shared/hono';
-
-/**
- * Supported HTTP methods for mokup routes.
- *
- * @example
- * import type { HttpMethod } from 'mokup/vite'
- *
- * 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/vite'
- *
- * 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/vite'
- *
- * const result: RouteHandlerResult = 'ok'
- */
-type RouteHandlerResult = RouteStaticResponse | Response;
-/**
- * Request handler signature for mokup routes.
- *
- * @example
- * import type { RequestHandler } from 'mokup/vite'
- *
- * 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/vite'
- *
- * const response: RouteResponse = { ok: true }
- */
-type RouteResponse = RouteStaticResponse | RequestHandler;
-/**
- * Rule metadata for a route handler.
- *
- * @example
- * import type { RouteRule } from 'mokup/vite'
- *
- * const rule: RouteRule = {
- *   handler: () => ({ ok: true }),
- *   status: 200,
- * }
- */
-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;
-}
-/**
- * Runtime mode for Vite integration.
- *
- * @example
- * import type { RuntimeMode } from 'mokup/vite'
- *
- * const mode: RuntimeMode = 'sw'
- */
-type RuntimeMode = 'server' | 'sw';
-/**
- * Execution runtime for the Vite plugin.
- *
- * @example
- * import type { ViteRuntime } from 'mokup/vite'
- *
- * const runtime: ViteRuntime = 'vite'
- */
-type ViteRuntime = 'vite' | 'worker';
-/**
- * Service worker behavior options for mokup.
- *
- * @example
- * import type { ServiceWorkerOptions } from 'mokup/vite'
- *
- * const sw: ServiceWorkerOptions = {
- *   path: '/mokup-sw.js',
- *   scope: '/',
- * }
- */
-interface ServiceWorkerOptions {
-    /**
-     * Service worker script path.
-     *
-     * @default "/mokup-sw.js"
-     */
-    path?: string;
-    /**
-     * Service worker scope.
-     *
-     * @default "/"
-     */
-    scope?: string;
-    /**
-     * Auto-register the service worker.
-     *
-     * @default true
-     */
-    register?: boolean;
-    /**
-     * Auto-unregister when no SW entries exist.
-     *
-     * @default false
-     */
-    unregister?: boolean;
-    /**
-     * Allow SW fallback to direct network when not matched.
-     *
-     * @default true
-     */
-    fallback?: boolean;
-    /**
-     * Base paths the service worker should handle.
-     *
-     * @default []
-     */
-    basePath?: string | string[];
-}
-
-/**
- * Directory-level route configuration loaded from index.config.* files.
- *
- * @example
- * import type { RouteDirectoryConfig } from 'mokup/vite'
- *
- * const config: RouteDirectoryConfig = {
- *   headers: { 'x-mokup': 'dir' },
- * }
- */
-interface RouteDirectoryConfig {
-    /**
-     * Headers applied to routes under this directory.
-     *
-     * @default {}
-     */
-    headers?: Record<string, string>;
-    /**
-     * Default status code override.
-     *
-     * @default 200
-     */
-    status?: number;
-    /**
-     * Delay in milliseconds.
-     *
-     * @default 0
-     */
-    delay?: number;
-    /**
-     * Enable or disable routes under this directory.
-     *
-     * @default true
-     */
-    enabled?: boolean;
-    /**
-     * Ignore prefixes within the directory.
-     *
-     * @default ["."]
-     */
-    ignorePrefix?: string | string[];
-    /**
-     * Include filter for route files.
-     *
-     * @default undefined
-     */
-    include?: RegExp | RegExp[];
-    /**
-     * Exclude filter for route files.
-     *
-     * @default undefined
-     */
-    exclude?: RegExp | RegExp[];
-    /**
-     * Middleware for this directory.
-     *
-     * @default undefined
-     */
-    middleware?: MiddlewareHandler | MiddlewareHandler[];
-    /**
-     * Error handling policy for defineConfig hooks.
-     *
-     * @default "warn"
-     */
-    hookError?: HookErrorPolicy;
-}
-/**
- * Middleware execution position.
- *
- * @example
- * import type { MiddlewarePosition } from 'mokup/vite'
- *
- * const position: MiddlewarePosition = 'pre'
- */
-type MiddlewarePosition = 'pre' | 'normal' | 'post';
-/**
- * Error handling policy for config hooks.
- */
-type HookErrorPolicy = 'throw' | 'warn' | 'silent';
-/**
- * Middleware registry used by defineConfig.
- *
- * @example
- * import type { MiddlewareRegistry } from 'mokup/vite'
- *
- * const registry: MiddlewareRegistry = { use: () => {} }
- */
-interface MiddlewareRegistry {
-    use: (...handlers: MiddlewareHandler[]) => void;
-}
-/**
- * Normalized middleware metadata.
- *
- * @example
- * import type { ResolvedMiddleware } from 'mokup/vite'
- *
- * 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;
-}
-/**
- * Options for a single Vite entry.
- *
- * @example
- * import type { VitePluginOptions } from 'mokup/vite'
- *
- * const options: VitePluginOptions = {
- *   dir: 'mock',
- *   prefix: '/api',
- * }
- */
-interface VitePluginOptions extends MockEntryOptions {
-    /**
-     * Runtime mode per entry.
-     *
-     * @default "server"
-     */
-    mode?: RuntimeMode;
-    /**
-     * Service worker options for this entry.
-     *
-     * @default undefined
-     */
-    sw?: ServiceWorkerOptions;
-}
-/**
- * Top-level plugin options for mokup/vite.
- *
- * @example
- * import type { MokupPluginOptions } from 'mokup/vite'
- *
- * const options: MokupPluginOptions = {
- *   entries: { dir: 'mock' },
- *   playground: true,
- * }
- */
-interface MokupPluginOptions {
-    /**
-     * One or more entries to scan for mocks.
-     *
-     * @default [{ }]
-     */
-    entries?: VitePluginOptions | VitePluginOptions[];
-    /**
-     * Playground configuration.
-     *
-     * @default { enabled: true, path: "/__mokup" }
-     */
-    playground?: PlaygroundOptionsInput;
-    /**
-     * Runtime for the Vite plugin.
-     *
-     * @default "vite"
-     */
-    runtime?: ViteRuntime;
-}
-/**
- * Alias for Vite plugin options.
- *
- * @example
- * import type { VitePluginOptionsInput } from 'mokup/vite'
- *
- * const options: VitePluginOptionsInput = { entries: { dir: 'mock' } }
- */
-type VitePluginOptionsInput = MokupPluginOptions;
-/**
- * Fully resolved route metadata.
- *
- * @example
- * import type { ResolvedRoute } from 'mokup/vite'
- *
- * 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[];
-    /**
-     * Ordered config file chain applied to this route (root to leaf).
-     *
-     * @default []
-     */
-    configChain?: string[];
-    status?: number;
-    headers?: Record<string, string>;
-    delay?: number;
-    ruleIndex?: number;
-}
-/**
- * List of resolved routes.
- *
- * @example
- * import type { RouteTable } from 'mokup/vite'
- *
- * const table: RouteTable = []
- */
-type RouteTable = ResolvedRoute[];
-
-export type { HttpMethod as H, MokupPluginOptions as M, RouteTable as R, ServiceWorkerOptions as S, VitePluginOptions as V, ResolvedRoute as a, MiddlewarePosition as b, MiddlewareRegistry as c, RequestHandler as d, RouteDirectoryConfig as e, RouteResponse as f, RouteRule as g, RuntimeMode as h, VitePluginOptionsInput as i, ViteRuntime as j, HookErrorPolicy as k };

package/dist/shared/mokup.Dy9VDphS.cjs

@@ -1,181 +0,0 @@
-'use strict';
-
-const pathe = require('@mokup/shared/pathe');
-const pathUtils = require('@mokup/shared/path-utils');
-require('@mokup/shared/timing');
-
-const methodSet = /* @__PURE__ */ new Set([
-  "GET",
-  "POST",
-  "PUT",
-  "PATCH",
-  "DELETE",
-  "OPTIONS",
-  "HEAD"
-]);
-const methodSuffixSet = new Set(
-  Array.from(methodSet, (method) => method.toLowerCase())
-);
-const supportedExtensions = /* @__PURE__ */ new Set([
-  ".json",
-  ".jsonc",
-  ".ts",
-  ".js",
-  ".mjs",
-  ".cjs"
-]);
-const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
-
-function toViteImportPath(file, root) {
-  const absolute = pathe.isAbsolute(file) ? file : pathe.resolve(root, file);
-  const rel = pathe.relative(root, absolute);
-  if (!rel.startsWith("..") && !pathe.isAbsolute(rel)) {
-    return `/${pathUtils.toPosix(rel)}`;
-  }
-  return `/@fs/${pathUtils.toPosix(absolute)}`;
-}
-function shouldModuleize(handler) {
-  if (typeof handler === "function") {
-    return true;
-  }
-  if (typeof Response !== "undefined" && handler instanceof Response) {
-    return true;
-  }
-  return false;
-}
-const BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
-function getNodeBuffer() {
-  if (typeof globalThis === "undefined") {
-    return null;
-  }
-  const buffer = globalThis.Buffer;
-  return buffer ?? null;
-}
-function getBtoa() {
-  if (typeof globalThis === "undefined") {
-    return null;
-  }
-  const btoaFn = globalThis.btoa;
-  return typeof btoaFn === "function" ? btoaFn : null;
-}
-function encodeBase64(bytes) {
-  const buffer = getNodeBuffer();
-  if (buffer) {
-    return buffer.from(bytes).toString("base64");
-  }
-  const btoaFn = getBtoa();
-  if (btoaFn) {
-    let binary = "";
-    const chunkSize = 32768;
-    for (let i = 0; i < bytes.length; i += chunkSize) {
-      const chunk = bytes.subarray(i, i + chunkSize);
-      binary += String.fromCharCode(...chunk);
-    }
-    return btoaFn(binary);
-  }
-  let output = "";
-  for (let i = 0; i < bytes.length; i += 3) {
-    const a = bytes[i] ?? 0;
-    const b = i + 1 < bytes.length ? bytes[i + 1] ?? 0 : 0;
-    const c = i + 2 < bytes.length ? bytes[i + 2] ?? 0 : 0;
-    const triple = a << 16 | b << 8 | c;
-    output += BASE64_ALPHABET[triple >> 18 & 63];
-    output += BASE64_ALPHABET[triple >> 12 & 63];
-    output += i + 1 < bytes.length ? BASE64_ALPHABET[triple >> 6 & 63] : "=";
-    output += i + 2 < bytes.length ? BASE64_ALPHABET[triple & 63] : "=";
-  }
-  return output;
-}
-function toBinaryBody(handler) {
-  if (handler instanceof ArrayBuffer) {
-    return encodeBase64(new Uint8Array(handler));
-  }
-  if (handler instanceof Uint8Array) {
-    return encodeBase64(handler);
-  }
-  return null;
-}
-function buildManifestResponse(route, moduleId) {
-  if (moduleId) {
-    const response = {
-      type: "module",
-      module: moduleId
-    };
-    if (typeof route.ruleIndex === "number") {
-      response.ruleIndex = route.ruleIndex;
-    }
-    return response;
-  }
-  const handler = route.handler;
-  if (typeof handler === "string") {
-    return {
-      type: "text",
-      body: handler
-    };
-  }
-  const binary = toBinaryBody(handler);
-  if (binary) {
-    return {
-      type: "binary",
-      body: binary,
-      encoding: "base64"
-    };
-  }
-  return {
-    type: "json",
-    body: handler
-  };
-}
-function buildManifestData(params) {
-  const { routes, root } = params;
-  const resolveModulePath = params.resolveModulePath ?? toViteImportPath;
-  const ruleModules = /* @__PURE__ */ new Map();
-  const middlewareModules = /* @__PURE__ */ new Map();
-  const manifestRoutes = routes.map((route) => {
-    const moduleId = shouldModuleize(route.handler) ? resolveModulePath(route.file, root) : null;
-    if (moduleId && !ruleModules.has(moduleId)) {
-      ruleModules.set(moduleId, { id: moduleId, kind: "rule" });
-    }
-    const middleware = route.middlewares?.map((entry) => {
-      const modulePath = resolveModulePath(entry.source, root);
-      if (!middlewareModules.has(modulePath)) {
-        middlewareModules.set(modulePath, { id: modulePath, kind: "middleware" });
-      }
-      return {
-        module: modulePath,
-        ruleIndex: entry.index
-      };
-    });
-    const response = buildManifestResponse(route, moduleId);
-    const manifestRoute = {
-      method: route.method,
-      url: route.template,
-      ...route.tokens ? { tokens: route.tokens } : {},
-      ...route.score ? { score: route.score } : {},
-      ...route.status ? { status: route.status } : {},
-      ...route.headers ? { headers: route.headers } : {},
-      ...route.delay ? { delay: route.delay } : {},
-      ...middleware && middleware.length > 0 ? { middleware } : {},
-      response
-    };
-    return manifestRoute;
-  });
-  const manifest = {
-    version: 1,
-    routes: manifestRoutes
-  };
-  return {
-    manifest,
-    modules: [
-      ...ruleModules.values(),
-      ...middlewareModules.values()
-    ]
-  };
-}
-
-exports.buildManifestData = buildManifestData;
-exports.configExtensions = configExtensions;
-exports.methodSet = methodSet;
-exports.methodSuffixSet = methodSuffixSet;
-exports.supportedExtensions = supportedExtensions;
-exports.toViteImportPath = toViteImportPath;