@mokup/shared 1.1.0 → 1.1.2

package/dist/index.d.ts

@@ -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.js';
+export { ConfigSourceMap, MiddlewareMeta, MiddlewarePosition, buildConfigChain, findConfigFile, getConfigFileCandidates, normalizeMiddlewareList, readMiddlewareMeta, resolveDirectoryConfig } from './config-utils.js';
+export { ConfigApp, DefineConfigFactory, HookErrorPolicy, HookHandler, createDefineConfig } from './define-config.js';
+export { readJsoncFile } from './jsonc-utils.js';
+export { loadRules } from './load-rules.js';
+export { collectFiles, isConfigFile, isSupportedFile } from './mock-files.js';
+export { createTsxConfigFile, ensureTsxRegister, loadModule } from './module-loader.js';
+export { configExtensions, jsonExtensions, methodSet, methodSuffixSet, supportedExtensions } from './route-constants.js';
+export { DerivedRoute, RouteParser, RouteParserResult, RouteScoreComparator, createRouteUtils } from './route-utils.js';
+export { D as DirInput, M as MockEntryOptions, P as PlaygroundOptionsInput, normalizeIgnorePrefix, normalizeMethod, normalizePrefix, resolveDirs } from './scan-utils.js';

package/dist/index.mjs

@@ -1 +1,18 @@
-
+export { isPromise, middlewareSymbol } from './config-core.mjs';
+export { buildConfigChain, findConfigFile, getConfigFileCandidates, normalizeMiddlewareList, readMiddlewareMeta, resolveDirectoryConfig } from './config-utils.mjs';
+export { 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 { createRouteUtils } from './route-utils.mjs';
+export { normalizeIgnorePrefix, normalizeMethod, normalizePrefix, resolveDirs } from './scan-utils.mjs';
+import 'node:fs';
+import 'pathe';
+import 'jsonc-parser';
+import 'node:module';
+import 'node:os';
+import 'node:process';
+import 'node:url';
+import './path-utils.mjs';

package/dist/jsonc-utils.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+const node_fs = require('node:fs');
+const jsoncParser = require('jsonc-parser');
+
+async function readJsoncFile(file, logger) {
+  try {
+    const content = await node_fs.promises.readFile(file, "utf8");
+    const errors = [];
+    const data = jsoncParser.parse(content, errors, {
+      allowTrailingComma: true,
+      disallowComments: false
+    });
+    if (errors.length > 0) {
+      logger?.warn?.(`Invalid JSONC in ${file}`);
+      return void 0;
+    }
+    return data;
+  } catch (error) {
+    logger?.warn?.(`Failed to read ${file}: ${String(error)}`);
+    return void 0;
+  }
+}
+
+exports.readJsoncFile = readJsoncFile;

package/dist/jsonc-utils.d.cts

@@ -0,0 +1,7 @@
+interface JsoncLogger {
+    warn?: (message: string) => void;
+}
+declare function readJsoncFile(file: string, logger?: JsoncLogger): Promise<any>;
+
+export { readJsoncFile };
+export type { JsoncLogger };

package/dist/jsonc-utils.d.mts

@@ -0,0 +1,7 @@
+interface JsoncLogger {
+    warn?: (message: string) => void;
+}
+declare function readJsoncFile(file: string, logger?: JsoncLogger): Promise<any>;
+
+export { readJsoncFile };
+export type { JsoncLogger };

package/dist/jsonc-utils.d.ts

@@ -0,0 +1,7 @@
+interface JsoncLogger {
+    warn?: (message: string) => void;
+}
+declare function readJsoncFile(file: string, logger?: JsoncLogger): Promise<any>;
+
+export { readJsoncFile };
+export type { JsoncLogger };

package/dist/jsonc-utils.mjs

@@ -0,0 +1,23 @@
+import { promises } from 'node:fs';
+import { parse } from 'jsonc-parser';
+
+async function readJsoncFile(file, logger) {
+  try {
+    const content = await promises.readFile(file, "utf8");
+    const errors = [];
+    const data = parse(content, errors, {
+      allowTrailingComma: true,
+      disallowComments: false
+    });
+    if (errors.length > 0) {
+      logger?.warn?.(`Invalid JSONC in ${file}`);
+      return void 0;
+    }
+    return data;
+  } catch (error) {
+    logger?.warn?.(`Failed to read ${file}: ${String(error)}`);
+    return void 0;
+  }
+}
+
+export { readJsoncFile };

package/dist/load-rules.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+const jsoncUtils = require('./jsonc-utils.cjs');
+const pathe = require('pathe');
+require('node:fs');
+require('jsonc-parser');
+
+async function loadRules(file, options) {
+  const ext = pathe.extname(file).toLowerCase();
+  if (ext === ".json" || ext === ".jsonc") {
+    const json = await jsoncUtils.readJsoncFile(file, options.logger);
+    if (typeof json === "undefined") {
+      return [];
+    }
+    return [
+      {
+        handler: json
+      }
+    ];
+  }
+  const mod = await options.loadModule(file);
+  const value = mod?.default ?? mod;
+  if (!value) {
+    return [];
+  }
+  if (Array.isArray(value)) {
+    return value;
+  }
+  if (typeof value === "function") {
+    return [
+      {
+        handler: value
+      }
+    ];
+  }
+  return [value];
+}
+
+exports.loadRules = loadRules;

package/dist/load-rules.d.cts

@@ -0,0 +1,14 @@
+interface LoadRulesOptions {
+    loadModule: (file: string) => Promise<unknown | null>;
+    logger?: {
+        warn?: (message: string) => void;
+    };
+}
+declare function loadRules<T extends {
+    handler: unknown;
+} = {
+    handler: unknown;
+}>(file: string, options: LoadRulesOptions): Promise<T[]>;
+
+export { loadRules };
+export type { LoadRulesOptions };

package/dist/load-rules.d.mts

@@ -0,0 +1,14 @@
+interface LoadRulesOptions {
+    loadModule: (file: string) => Promise<unknown | null>;
+    logger?: {
+        warn?: (message: string) => void;
+    };
+}
+declare function loadRules<T extends {
+    handler: unknown;
+} = {
+    handler: unknown;
+}>(file: string, options: LoadRulesOptions): Promise<T[]>;
+
+export { loadRules };
+export type { LoadRulesOptions };

package/dist/load-rules.d.ts

@@ -0,0 +1,14 @@
+interface LoadRulesOptions {
+    loadModule: (file: string) => Promise<unknown | null>;
+    logger?: {
+        warn?: (message: string) => void;
+    };
+}
+declare function loadRules<T extends {
+    handler: unknown;
+} = {
+    handler: unknown;
+}>(file: string, options: LoadRulesOptions): Promise<T[]>;
+
+export { loadRules };
+export type { LoadRulesOptions };

package/dist/load-rules.mjs

@@ -0,0 +1,37 @@
+import { readJsoncFile } from './jsonc-utils.mjs';
+import { extname } from 'pathe';
+import 'node:fs';
+import 'jsonc-parser';
+
+async function loadRules(file, options) {
+  const ext = extname(file).toLowerCase();
+  if (ext === ".json" || ext === ".jsonc") {
+    const json = await readJsoncFile(file, options.logger);
+    if (typeof json === "undefined") {
+      return [];
+    }
+    return [
+      {
+        handler: json
+      }
+    ];
+  }
+  const mod = await options.loadModule(file);
+  const value = mod?.default ?? mod;
+  if (!value) {
+    return [];
+  }
+  if (Array.isArray(value)) {
+    return value;
+  }
+  if (typeof value === "function") {
+    return [
+      {
+        handler: value
+      }
+    ];
+  }
+  return [value];
+}
+
+export { loadRules };

package/dist/mock-files.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+const node_fs = require('node:fs');
+const pathe = require('pathe');
+const routeConstants = require('./route-constants.cjs');
+
+async function walkDir(dir, rootDir, files) {
+  const entries = await node_fs.promises.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === "node_modules" || entry.name === ".git") {
+      continue;
+    }
+    const fullPath = pathe.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await walkDir(fullPath, rootDir, files);
+      continue;
+    }
+    if (entry.isFile()) {
+      files.push({ file: fullPath, rootDir });
+    }
+  }
+}
+async function exists(path) {
+  try {
+    await node_fs.promises.stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function collectFiles(dirs) {
+  const files = [];
+  for (const dir of dirs) {
+    if (!await exists(dir)) {
+      continue;
+    }
+    await walkDir(dir, dir, files);
+  }
+  return files;
+}
+function isConfigFile(file) {
+  if (file.endsWith(".d.ts")) {
+    return false;
+  }
+  const base = pathe.basename(file);
+  if (!base.startsWith("index.config.")) {
+    return false;
+  }
+  const ext = pathe.extname(file).toLowerCase();
+  return routeConstants.configExtensions.includes(ext);
+}
+function isSupportedFile(file) {
+  if (file.endsWith(".d.ts")) {
+    return false;
+  }
+  if (isConfigFile(file)) {
+    return false;
+  }
+  const ext = pathe.extname(file).toLowerCase();
+  return routeConstants.supportedExtensions.has(ext);
+}
+
+exports.collectFiles = collectFiles;
+exports.isConfigFile = isConfigFile;
+exports.isSupportedFile = isSupportedFile;

package/dist/mock-files.d.cts

@@ -0,0 +1,10 @@
+interface FileInfo {
+    file: string;
+    rootDir: string;
+}
+declare function collectFiles(dirs: string[]): Promise<FileInfo[]>;
+declare function isConfigFile(file: string): boolean;
+declare function isSupportedFile(file: string): boolean;
+
+export { collectFiles, isConfigFile, isSupportedFile };
+export type { FileInfo };

package/dist/mock-files.d.mts

@@ -0,0 +1,10 @@
+interface FileInfo {
+    file: string;
+    rootDir: string;
+}
+declare function collectFiles(dirs: string[]): Promise<FileInfo[]>;
+declare function isConfigFile(file: string): boolean;
+declare function isSupportedFile(file: string): boolean;
+
+export { collectFiles, isConfigFile, isSupportedFile };
+export type { FileInfo };

package/dist/mock-files.d.ts

@@ -0,0 +1,10 @@
+interface FileInfo {
+    file: string;
+    rootDir: string;
+}
+declare function collectFiles(dirs: string[]): Promise<FileInfo[]>;
+declare function isConfigFile(file: string): boolean;
+declare function isSupportedFile(file: string): boolean;
+
+export { collectFiles, isConfigFile, isSupportedFile };
+export type { FileInfo };

package/dist/mock-files.mjs

@@ -0,0 +1,61 @@
+import { promises } from 'node:fs';
+import { basename, extname, join } from 'pathe';
+import { configExtensions, supportedExtensions } from './route-constants.mjs';
+
+async function walkDir(dir, rootDir, files) {
+  const entries = await promises.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === "node_modules" || entry.name === ".git") {
+      continue;
+    }
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await walkDir(fullPath, rootDir, files);
+      continue;
+    }
+    if (entry.isFile()) {
+      files.push({ file: fullPath, rootDir });
+    }
+  }
+}
+async function exists(path) {
+  try {
+    await promises.stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function collectFiles(dirs) {
+  const files = [];
+  for (const dir of dirs) {
+    if (!await exists(dir)) {
+      continue;
+    }
+    await walkDir(dir, dir, files);
+  }
+  return files;
+}
+function isConfigFile(file) {
+  if (file.endsWith(".d.ts")) {
+    return false;
+  }
+  const base = basename(file);
+  if (!base.startsWith("index.config.")) {
+    return false;
+  }
+  const ext = extname(file).toLowerCase();
+  return configExtensions.includes(ext);
+}
+function isSupportedFile(file) {
+  if (file.endsWith(".d.ts")) {
+    return false;
+  }
+  if (isConfigFile(file)) {
+    return false;
+  }
+  const ext = extname(file).toLowerCase();
+  return supportedExtensions.has(ext);
+}
+
+export { collectFiles, isConfigFile, isSupportedFile };

package/dist/module-loader.cjs

@@ -0,0 +1,93 @@
+'use strict';
+
+const node_fs = require('node:fs');
+const node_module = require('node:module');
+const node_os = require('node:os');
+const process = require('node:process');
+const node_url = require('node:url');
+const pathe = require('pathe');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const process__default = /*#__PURE__*/_interopDefaultCompat(process);
+
+function createTsxConfigFile(options) {
+  const config = {
+    compilerOptions: {
+      baseUrl: options.baseUrl,
+      paths: options.paths
+    }
+  };
+  const configPath = options.fileName ?? pathe.resolve(node_os.tmpdir(), `mokup-tsx-${process__default.pid}.json`);
+  node_fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+  return configPath;
+}
+let sourceMapsEnabled = false;
+let tsxRegisterPromise = null;
+let tsxRegisteredConfig = null;
+function resetModuleLoaderForTests() {
+  sourceMapsEnabled = false;
+  tsxRegisterPromise = null;
+  tsxRegisteredConfig = null;
+}
+function ensureSourceMapsEnabled() {
+  if (sourceMapsEnabled) {
+    return;
+  }
+  const setSourceMapsEnabled = process__default.setSourceMapsEnabled;
+  if (typeof setSourceMapsEnabled === "function") {
+    setSourceMapsEnabled(true);
+  }
+  sourceMapsEnabled = true;
+}
+async function ensureTsxRegister(tsconfigPath) {
+  const desired = tsconfigPath ?? null;
+  if (tsxRegisterPromise) {
+    await tsxRegisterPromise;
+    if (desired && tsxRegisteredConfig !== desired) {
+      tsxRegisterPromise = (async () => {
+        ensureSourceMapsEnabled();
+        const { register } = await import('tsx/esm/api');
+        register({ tsconfig: desired });
+        tsxRegisteredConfig = desired;
+      })();
+      await tsxRegisterPromise;
+    }
+    return tsxRegisterPromise;
+  }
+  tsxRegisterPromise = (async () => {
+    ensureSourceMapsEnabled();
+    const { register } = await import('tsx/esm/api');
+    if (desired) {
+      register({ tsconfig: desired });
+      tsxRegisteredConfig = desired;
+    } else {
+      register();
+      tsxRegisteredConfig = null;
+    }
+  })();
+  return tsxRegisterPromise;
+}
+async function loadModule(file, options) {
+  const ext = pathe.extname(file).toLowerCase();
+  if (ext === ".cjs") {
+    const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('module-loader.cjs', document.baseURI).href)));
+    delete require$1.cache[file];
+    return require$1(file);
+  }
+  if (ext === ".js" || ext === ".mjs") {
+    return import(`${node_url.pathToFileURL(file).href}?t=${Date.now()}`);
+  }
+  if (ext === ".ts") {
+    await ensureTsxRegister(options?.tsconfigPath ?? null);
+    return import(`${node_url.pathToFileURL(file).href}?t=${Date.now()}`);
+  }
+  return null;
+}
+
+exports.createTsxConfigFile = createTsxConfigFile;
+exports.ensureTsxRegister = ensureTsxRegister;
+exports.loadModule = loadModule;
+exports.resetModuleLoaderForTests = resetModuleLoaderForTests;

package/dist/module-loader.d.cts

@@ -0,0 +1,13 @@
+interface TsxConfigOptions {
+    baseUrl: string;
+    paths: Record<string, string[]>;
+    fileName?: string;
+}
+declare function createTsxConfigFile(options: TsxConfigOptions): string;
+declare function resetModuleLoaderForTests(): void;
+declare function ensureTsxRegister(tsconfigPath?: string | null): Promise<void>;
+declare function loadModule(file: string, options?: {
+    tsconfigPath?: string | null;
+}): Promise<any>;
+
+export { createTsxConfigFile, ensureTsxRegister, loadModule, resetModuleLoaderForTests };

package/dist/module-loader.d.mts

@@ -0,0 +1,13 @@
+interface TsxConfigOptions {
+    baseUrl: string;
+    paths: Record<string, string[]>;
+    fileName?: string;
+}
+declare function createTsxConfigFile(options: TsxConfigOptions): string;
+declare function resetModuleLoaderForTests(): void;
+declare function ensureTsxRegister(tsconfigPath?: string | null): Promise<void>;
+declare function loadModule(file: string, options?: {
+    tsconfigPath?: string | null;
+}): Promise<any>;
+
+export { createTsxConfigFile, ensureTsxRegister, loadModule, resetModuleLoaderForTests };

package/dist/module-loader.d.ts

@@ -0,0 +1,13 @@
+interface TsxConfigOptions {
+    baseUrl: string;
+    paths: Record<string, string[]>;
+    fileName?: string;
+}
+declare function createTsxConfigFile(options: TsxConfigOptions): string;
+declare function resetModuleLoaderForTests(): void;
+declare function ensureTsxRegister(tsconfigPath?: string | null): Promise<void>;
+declare function loadModule(file: string, options?: {
+    tsconfigPath?: string | null;
+}): Promise<any>;
+
+export { createTsxConfigFile, ensureTsxRegister, loadModule, resetModuleLoaderForTests };