@mokup/shared 1.1.0 → 1.1.2

package/dist/define-config.cjs

@@ -0,0 +1,168 @@
+'use strict';
+
+const configCore = require('./config-core.cjs');
+
+function normalizeHookError(policy) {
+  if (policy === "throw" || policy === "silent") {
+    return policy;
+  }
+  return "warn";
+}
+function createDefineConfig(options) {
+  const contextStack = [];
+  function getActiveContext() {
+    const context = contextStack[contextStack.length - 1];
+    if (!context) {
+      throw new Error("onBeforeAll/onAfterAll must be called inside defineConfig()");
+    }
+    return context;
+  }
+  function runWithContext(context, fn) {
+    contextStack.push(context);
+    try {
+      const result = fn();
+      if (configCore.isPromise(result)) {
+        return result.finally(() => {
+          contextStack.pop();
+        });
+      }
+      contextStack.pop();
+      return result;
+    } catch (error) {
+      contextStack.pop();
+      throw error;
+    }
+  }
+  function reportHookError(error, policy) {
+    if (policy === "silent") {
+      return;
+    }
+    if (policy === "warn") {
+      console.warn(`${options.logPrefix} defineConfig hook failed:`, error);
+    }
+  }
+  function runHookSequence(stage, hooks, policy, setStage) {
+    if (hooks.length === 0) {
+      return;
+    }
+    setStage(stage);
+    let chain = null;
+    const runHook = (hook) => {
+      try {
+        const result = hook();
+        if (configCore.isPromise(result)) {
+          return result.catch((error) => {
+            if (policy === "throw") {
+              throw error;
+            }
+            reportHookError(error, policy);
+          });
+        }
+        return void 0;
+      } catch (error) {
+        if (policy === "throw") {
+          throw error;
+        }
+        reportHookError(error, policy);
+        return void 0;
+      }
+    };
+    for (const hook of hooks) {
+      if (chain) {
+        chain = chain.then(() => runHook(hook));
+        continue;
+      }
+      const result = runHook(hook);
+      if (configCore.isPromise(result)) {
+        chain = result;
+      }
+    }
+    if (!chain) {
+      setStage("normal");
+      return;
+    }
+    return chain.finally(() => {
+      setStage("normal");
+    });
+  }
+  function attachMetadata(config, meta) {
+    Object.defineProperty(config, configCore.middlewareSymbol, {
+      value: meta,
+      enumerable: false
+    });
+    return config;
+  }
+  function normalizeConfig(value) {
+    return value && typeof value === "object" ? value : {};
+  }
+  function onBeforeAll(handler) {
+    if (typeof handler !== "function") {
+      throw new TypeError("onBeforeAll expects a function");
+    }
+    const context = getActiveContext();
+    context.hooks.pre.push(handler);
+  }
+  function onAfterAll(handler) {
+    if (typeof handler !== "function") {
+      throw new TypeError("onAfterAll expects a function");
+    }
+    const context = getActiveContext();
+    context.hooks.post.push(handler);
+  }
+  function defineConfig(input) {
+    if (typeof input === "function") {
+      const pre = [];
+      const normal = [];
+      const post = [];
+      let stage = "normal";
+      const app = {
+        use: (...handlers) => {
+          if (stage === "pre") {
+            pre.push(...handlers);
+            return;
+          }
+          if (stage === "post") {
+            post.push(...handlers);
+            return;
+          }
+          normal.push(...handlers);
+        }
+      };
+      const context = {
+        app,
+        hooks: { pre: [], post: [] },
+        setStage: (next) => {
+          stage = next;
+        }
+      };
+      const result = runWithContext(context, () => input({ app }));
+      const finalize = (value) => {
+        const config2 = normalizeConfig(value);
+        const policy = normalizeHookError(config2.hookError);
+        const preResult = runHookSequence("pre", context.hooks.pre, policy, context.setStage);
+        const runPost = () => runHookSequence("post", context.hooks.post, policy, context.setStage);
+        if (configCore.isPromise(preResult)) {
+          return preResult.then(runPost).then(() => attachMetadata(config2, { pre, normal, post }));
+        }
+        const postResult = runPost();
+        if (configCore.isPromise(postResult)) {
+          return postResult.then(() => attachMetadata(config2, { pre, normal, post }));
+        }
+        return attachMetadata(config2, { pre, normal, post });
+      };
+      if (configCore.isPromise(result)) {
+        return result.then(finalize);
+      }
+      return finalize(result);
+    }
+    const config = normalizeConfig(input);
+    return attachMetadata(config, { pre: [], normal: [], post: [] });
+  }
+  return {
+    defineConfig,
+    onBeforeAll,
+    onAfterAll
+  };
+}
+
+exports.createDefineConfig = createDefineConfig;

package/dist/define-config.d.cts

@@ -0,0 +1,20 @@
+type HookErrorPolicy = 'warn' | 'silent' | 'throw';
+type HookHandler = () => void | Promise<void>;
+interface ConfigApp<TMiddleware> {
+    use: (...handlers: TMiddleware[]) => void;
+}
+type DefineConfigFactory<TConfig, TMiddleware> = (context: {
+    app: ConfigApp<TMiddleware>;
+}) => TConfig | void | Promise<TConfig | void>;
+declare function createDefineConfig<TConfig extends {
+    hookError?: HookErrorPolicy;
+}, TMiddleware>(options: {
+    logPrefix: string;
+}): {
+    defineConfig: (input: TConfig | DefineConfigFactory<TConfig, TMiddleware>) => TConfig | Promise<TConfig>;
+    onBeforeAll: (handler: HookHandler) => void;
+    onAfterAll: (handler: HookHandler) => void;
+};
+
+export { createDefineConfig };
+export type { ConfigApp, DefineConfigFactory, HookErrorPolicy, HookHandler };

package/dist/define-config.d.mts

@@ -0,0 +1,20 @@
+type HookErrorPolicy = 'warn' | 'silent' | 'throw';
+type HookHandler = () => void | Promise<void>;
+interface ConfigApp<TMiddleware> {
+    use: (...handlers: TMiddleware[]) => void;
+}
+type DefineConfigFactory<TConfig, TMiddleware> = (context: {
+    app: ConfigApp<TMiddleware>;
+}) => TConfig | void | Promise<TConfig | void>;
+declare function createDefineConfig<TConfig extends {
+    hookError?: HookErrorPolicy;
+}, TMiddleware>(options: {
+    logPrefix: string;
+}): {
+    defineConfig: (input: TConfig | DefineConfigFactory<TConfig, TMiddleware>) => TConfig | Promise<TConfig>;
+    onBeforeAll: (handler: HookHandler) => void;
+    onAfterAll: (handler: HookHandler) => void;
+};
+
+export { createDefineConfig };
+export type { ConfigApp, DefineConfigFactory, HookErrorPolicy, HookHandler };

package/dist/define-config.d.ts

@@ -0,0 +1,20 @@
+type HookErrorPolicy = 'warn' | 'silent' | 'throw';
+type HookHandler = () => void | Promise<void>;
+interface ConfigApp<TMiddleware> {
+    use: (...handlers: TMiddleware[]) => void;
+}
+type DefineConfigFactory<TConfig, TMiddleware> = (context: {
+    app: ConfigApp<TMiddleware>;
+}) => TConfig | void | Promise<TConfig | void>;
+declare function createDefineConfig<TConfig extends {
+    hookError?: HookErrorPolicy;
+}, TMiddleware>(options: {
+    logPrefix: string;
+}): {
+    defineConfig: (input: TConfig | DefineConfigFactory<TConfig, TMiddleware>) => TConfig | Promise<TConfig>;
+    onBeforeAll: (handler: HookHandler) => void;
+    onAfterAll: (handler: HookHandler) => void;
+};
+
+export { createDefineConfig };
+export type { ConfigApp, DefineConfigFactory, HookErrorPolicy, HookHandler };

package/dist/define-config.mjs

@@ -0,0 +1,166 @@
+import { isPromise, middlewareSymbol } from './config-core.mjs';
+
+function normalizeHookError(policy) {
+  if (policy === "throw" || policy === "silent") {
+    return policy;
+  }
+  return "warn";
+}
+function createDefineConfig(options) {
+  const contextStack = [];
+  function getActiveContext() {
+    const context = contextStack[contextStack.length - 1];
+    if (!context) {
+      throw new Error("onBeforeAll/onAfterAll must be called inside defineConfig()");
+    }
+    return context;
+  }
+  function runWithContext(context, fn) {
+    contextStack.push(context);
+    try {
+      const result = fn();
+      if (isPromise(result)) {
+        return result.finally(() => {
+          contextStack.pop();
+        });
+      }
+      contextStack.pop();
+      return result;
+    } catch (error) {
+      contextStack.pop();
+      throw error;
+    }
+  }
+  function reportHookError(error, policy) {
+    if (policy === "silent") {
+      return;
+    }
+    if (policy === "warn") {
+      console.warn(`${options.logPrefix} defineConfig hook failed:`, error);
+    }
+  }
+  function runHookSequence(stage, hooks, policy, setStage) {
+    if (hooks.length === 0) {
+      return;
+    }
+    setStage(stage);
+    let chain = null;
+    const runHook = (hook) => {
+      try {
+        const result = hook();
+        if (isPromise(result)) {
+          return result.catch((error) => {
+            if (policy === "throw") {
+              throw error;
+            }
+            reportHookError(error, policy);
+          });
+        }
+        return void 0;
+      } catch (error) {
+        if (policy === "throw") {
+          throw error;
+        }
+        reportHookError(error, policy);
+        return void 0;
+      }
+    };
+    for (const hook of hooks) {
+      if (chain) {
+        chain = chain.then(() => runHook(hook));
+        continue;
+      }
+      const result = runHook(hook);
+      if (isPromise(result)) {
+        chain = result;
+      }
+    }
+    if (!chain) {
+      setStage("normal");
+      return;
+    }
+    return chain.finally(() => {
+      setStage("normal");
+    });
+  }
+  function attachMetadata(config, meta) {
+    Object.defineProperty(config, middlewareSymbol, {
+      value: meta,
+      enumerable: false
+    });
+    return config;
+  }
+  function normalizeConfig(value) {
+    return value && typeof value === "object" ? value : {};
+  }
+  function onBeforeAll(handler) {
+    if (typeof handler !== "function") {
+      throw new TypeError("onBeforeAll expects a function");
+    }
+    const context = getActiveContext();
+    context.hooks.pre.push(handler);
+  }
+  function onAfterAll(handler) {
+    if (typeof handler !== "function") {
+      throw new TypeError("onAfterAll expects a function");
+    }
+    const context = getActiveContext();
+    context.hooks.post.push(handler);
+  }
+  function defineConfig(input) {
+    if (typeof input === "function") {
+      const pre = [];
+      const normal = [];
+      const post = [];
+      let stage = "normal";
+      const app = {
+        use: (...handlers) => {
+          if (stage === "pre") {
+            pre.push(...handlers);
+            return;
+          }
+          if (stage === "post") {
+            post.push(...handlers);
+            return;
+          }
+          normal.push(...handlers);
+        }
+      };
+      const context = {
+        app,
+        hooks: { pre: [], post: [] },
+        setStage: (next) => {
+          stage = next;
+        }
+      };
+      const result = runWithContext(context, () => input({ app }));
+      const finalize = (value) => {
+        const config2 = normalizeConfig(value);
+        const policy = normalizeHookError(config2.hookError);
+        const preResult = runHookSequence("pre", context.hooks.pre, policy, context.setStage);
+        const runPost = () => runHookSequence("post", context.hooks.post, policy, context.setStage);
+        if (isPromise(preResult)) {
+          return preResult.then(runPost).then(() => attachMetadata(config2, { pre, normal, post }));
+        }
+        const postResult = runPost();
+        if (isPromise(postResult)) {
+          return postResult.then(() => attachMetadata(config2, { pre, normal, post }));
+        }
+        return attachMetadata(config2, { pre, normal, post });
+      };
+      if (isPromise(result)) {
+        return result.then(finalize);
+      }
+      return finalize(result);
+    }
+    const config = normalizeConfig(input);
+    return attachMetadata(config, { pre: [], normal: [], post: [] });
+  }
+  return {
+    defineConfig,
+    onBeforeAll,
+    onAfterAll
+  };
+}
+
+export { createDefineConfig };

package/dist/index.cjs

@@ -1,2 +1,50 @@
 'use strict';
 
+const configCore = require('./config-core.cjs');
+const configUtils = require('./config-utils.cjs');
+const defineConfig = require('./define-config.cjs');
+const jsoncUtils = require('./jsonc-utils.cjs');
+const loadRules = require('./load-rules.cjs');
+const mockFiles = require('./mock-files.cjs');
+const moduleLoader = require('./module-loader.cjs');
+const routeConstants = require('./route-constants.cjs');
+const routeUtils = require('./route-utils.cjs');
+const scanUtils = require('./scan-utils.cjs');
+require('node:fs');
+require('pathe');
+require('jsonc-parser');
+require('node:module');
+require('node:os');
+require('node:process');
+require('node:url');
+require('./path-utils.cjs');
+
+
+
+exports.isPromise = configCore.isPromise;
+exports.middlewareSymbol = configCore.middlewareSymbol;
+exports.buildConfigChain = configUtils.buildConfigChain;
+exports.findConfigFile = configUtils.findConfigFile;
+exports.getConfigFileCandidates = configUtils.getConfigFileCandidates;
+exports.normalizeMiddlewareList = configUtils.normalizeMiddlewareList;
+exports.readMiddlewareMeta = configUtils.readMiddlewareMeta;
+exports.resolveDirectoryConfig = configUtils.resolveDirectoryConfig;
+exports.createDefineConfig = defineConfig.createDefineConfig;
+exports.readJsoncFile = jsoncUtils.readJsoncFile;
+exports.loadRules = loadRules.loadRules;
+exports.collectFiles = mockFiles.collectFiles;
+exports.isConfigFile = mockFiles.isConfigFile;
+exports.isSupportedFile = mockFiles.isSupportedFile;
+exports.createTsxConfigFile = moduleLoader.createTsxConfigFile;
+exports.ensureTsxRegister = moduleLoader.ensureTsxRegister;
+exports.loadModule = moduleLoader.loadModule;
+exports.configExtensions = routeConstants.configExtensions;
+exports.jsonExtensions = routeConstants.jsonExtensions;
+exports.methodSet = routeConstants.methodSet;
+exports.methodSuffixSet = routeConstants.methodSuffixSet;
+exports.supportedExtensions = routeConstants.supportedExtensions;
+exports.createRouteUtils = routeUtils.createRouteUtils;
+exports.normalizeIgnorePrefix = scanUtils.normalizeIgnorePrefix;
+exports.normalizeMethod = scanUtils.normalizeMethod;
+exports.normalizePrefix = scanUtils.normalizePrefix;
+exports.resolveDirs = scanUtils.resolveDirs;

package/dist/index.d.cts

@@ -1,98 +1,10 @@
-/**
- * Directory input for mock scanning.
- *
- * @example
- * import type { DirInput } from '@mokup/shared'
- *
- * const dir: DirInput = ['mock', 'fixtures']
- */
-type DirInput = string | string[] | ((root: string) => string | string[]) | undefined;
-/**
- * Shared entry options for mokup scanners and plugins.
- *
- * @example
- * import type { MockEntryOptions } from '@mokup/shared'
- *
- * const entry: MockEntryOptions = {
- *   dir: 'mock',
- *   prefix: '/api',
- *   watch: true,
- * }
- */
-interface MockEntryOptions {
-    /**
-     * Directory (or directories) to scan for mock routes.
-     *
-     * @default "mock" (resolved by Vite/webpack plugins)
-     */
-    dir?: DirInput;
-    /**
-     * Request path prefix to mount mock routes under.
-     *
-     * @default ""
-     */
-    prefix?: string;
-    /**
-     * Include filter for files to scan.
-     *
-     * @default undefined
-     */
-    include?: RegExp | RegExp[];
-    /**
-     * Exclude filter for files to scan.
-     *
-     * @default undefined
-     */
-    exclude?: RegExp | RegExp[];
-    /**
-     * Ignore file or folder prefixes when scanning.
-     *
-     * @default ["."]
-     */
-    ignorePrefix?: string | string[];
-    /**
-     * Enable file watching for live route updates.
-     *
-     * @default true
-     */
-    watch?: boolean;
-    /**
-     * Enable mokup logging.
-     *
-     * @default true
-     */
-    log?: boolean;
-}
-/**
- * Playground configuration input.
- *
- * @example
- * import type { PlaygroundOptionsInput } from '@mokup/shared'
- *
- * const playground: PlaygroundOptionsInput = {
- *   path: '/__mokup',
- *   enabled: true,
- * }
- */
-type PlaygroundOptionsInput = boolean | {
-    /**
-     * Base path for the playground UI.
-     *
-     * @default "/__mokup"
-     */
-    path?: string;
-    /**
-     * Emit playground assets during production builds.
-     *
-     * @default false
-     */
-    build?: boolean;
-    /**
-     * Enable or disable the playground routes.
-     *
-     * @default true
-     */
-    enabled?: boolean;
-} | undefined;
-
-export type { DirInput, MockEntryOptions, PlaygroundOptionsInput };
+export { isPromise, middlewareSymbol } from './config-core.cjs';
+export { ConfigSourceMap, MiddlewareMeta, MiddlewarePosition, buildConfigChain, findConfigFile, getConfigFileCandidates, normalizeMiddlewareList, readMiddlewareMeta, resolveDirectoryConfig } from './config-utils.cjs';
+export { ConfigApp, DefineConfigFactory, HookErrorPolicy, HookHandler, createDefineConfig } from './define-config.cjs';
+export { readJsoncFile } from './jsonc-utils.cjs';
+export { loadRules } from './load-rules.cjs';
+export { collectFiles, isConfigFile, isSupportedFile } from './mock-files.cjs';
+export { createTsxConfigFile, ensureTsxRegister, loadModule } from './module-loader.cjs';
+export { configExtensions, jsonExtensions, methodSet, methodSuffixSet, supportedExtensions } from './route-constants.cjs';
+export { DerivedRoute, RouteParser, RouteParserResult, RouteScoreComparator, createRouteUtils } from './route-utils.cjs';
+export { D as DirInput, M as MockEntryOptions, P as PlaygroundOptionsInput, normalizeIgnorePrefix, normalizeMethod, normalizePrefix, resolveDirs } from './scan-utils.cjs';

package/dist/index.d.mts

@@ -1,98 +1,10 @@
-/**
- * Directory input for mock scanning.
- *
- * @example
- * import type { DirInput } from '@mokup/shared'
- *
- * const dir: DirInput = ['mock', 'fixtures']
- */
-type DirInput = string | string[] | ((root: string) => string | string[]) | undefined;
-/**
- * Shared entry options for mokup scanners and plugins.
- *
- * @example
- * import type { MockEntryOptions } from '@mokup/shared'
- *
- * const entry: MockEntryOptions = {
- *   dir: 'mock',
- *   prefix: '/api',
- *   watch: true,
- * }
- */
-interface MockEntryOptions {
-    /**
-     * Directory (or directories) to scan for mock routes.
-     *
-     * @default "mock" (resolved by Vite/webpack plugins)
-     */
-    dir?: DirInput;
-    /**
-     * Request path prefix to mount mock routes under.
-     *
-     * @default ""
-     */
-    prefix?: string;
-    /**
-     * Include filter for files to scan.
-     *
-     * @default undefined
-     */
-    include?: RegExp | RegExp[];
-    /**
-     * Exclude filter for files to scan.
-     *
-     * @default undefined
-     */
-    exclude?: RegExp | RegExp[];
-    /**
-     * Ignore file or folder prefixes when scanning.
-     *
-     * @default ["."]
-     */
-    ignorePrefix?: string | string[];
-    /**
-     * Enable file watching for live route updates.
-     *
-     * @default true
-     */
-    watch?: boolean;
-    /**
-     * Enable mokup logging.
-     *
-     * @default true
-     */
-    log?: boolean;
-}
-/**
- * Playground configuration input.
- *
- * @example
- * import type { PlaygroundOptionsInput } from '@mokup/shared'
- *
- * const playground: PlaygroundOptionsInput = {
- *   path: '/__mokup',
- *   enabled: true,
- * }
- */
-type PlaygroundOptionsInput = boolean | {
-    /**
-     * Base path for the playground UI.
-     *
-     * @default "/__mokup"
-     */
-    path?: string;
-    /**
-     * Emit playground assets during production builds.
-     *
-     * @default false
-     */
-    build?: boolean;
-    /**
-     * Enable or disable the playground routes.
-     *
-     * @default true
-     */
-    enabled?: boolean;
-} | undefined;
-
-export type { DirInput, MockEntryOptions, PlaygroundOptionsInput };
+export { isPromise, middlewareSymbol } from './config-core.mjs';
+export { ConfigSourceMap, MiddlewareMeta, MiddlewarePosition, buildConfigChain, findConfigFile, getConfigFileCandidates, normalizeMiddlewareList, readMiddlewareMeta, resolveDirectoryConfig } from './config-utils.mjs';
+export { ConfigApp, DefineConfigFactory, HookErrorPolicy, HookHandler, createDefineConfig } from './define-config.mjs';
+export { readJsoncFile } from './jsonc-utils.mjs';
+export { loadRules } from './load-rules.mjs';
+export { collectFiles, isConfigFile, isSupportedFile } from './mock-files.mjs';
+export { createTsxConfigFile, ensureTsxRegister, loadModule } from './module-loader.mjs';
+export { configExtensions, jsonExtensions, methodSet, methodSuffixSet, supportedExtensions } from './route-constants.mjs';
+export { DerivedRoute, RouteParser, RouteParserResult, RouteScoreComparator, createRouteUtils } from './route-utils.mjs';
+export { D as DirInput, M as MockEntryOptions, P as PlaygroundOptionsInput, normalizeIgnorePrefix, normalizeMethod, normalizePrefix, resolveDirs } from './scan-utils.mjs';