@mokup/server 1.1.6 → 1.2.0

package/dist/index.cjs

@@ -6,12 +6,90 @@ require('@mokup/runtime');
 require('./shared/server.aaygIV2Q.cjs');
 
 const middlewareSymbol = Symbol.for("mokup.config.middlewares");
-function createRegistry(list) {
-  return {
-    use: (...handlers) => {
-      list.push(...handlers);
+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 isPromise(value) {
+  return !!value && typeof value.then === "function";
+}
+function normalizeHookError(policy) {
+  if (policy === "throw" || policy === "silent") {
+    return policy;
+  }
+  return "warn";
+}
+function reportHookError(error, policy) {
+  if (policy === "silent") {
+    return;
+  }
+  if (policy === "warn") {
+    console.warn("[@mokup/server] 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, {
@@ -20,24 +98,75 @@ function attachMetadata(config, meta) {
   });
   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 = {
-      pre: createRegistry(pre),
-      normal: createRegistry(normal),
-      post: createRegistry(post)
+      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 });
     };
-    const result = input(context);
-    const config2 = result && typeof result === "object" ? result : {};
-    return attachMetadata(config2, { pre, normal, post });
+    if (isPromise(result)) {
+      return result.then(finalize);
+    }
+    return finalize(result);
   }
-  const config = input && typeof input === "object" ? input : {};
+  const config = normalizeConfig(input);
   return attachMetadata(config, { pre: [], normal: [], post: [] });
 }
 
 exports.createFetchHandler = fetch.createFetchHandler;
 exports.createMokupWorker = worker.createMokupWorker;
 exports.defineConfig = defineConfig;
+exports.onAfterAll = onAfterAll;
+exports.onBeforeAll = onBeforeAll;

package/dist/index.d.cts

@@ -1,43 +1,52 @@
-import { R as RouteDirectoryConfig, M as MiddlewareRegistry } from './shared/server.CyVIKPsp.cjs';
-export { a as MiddlewarePosition, b as ResolvedMiddleware, c as RouteRule } from './shared/server.CyVIKPsp.cjs';
+import { R as RouteDirectoryConfig } from './shared/server.DLPB_I9q.cjs';
+export { H as HookErrorPolicy, M as MiddlewarePosition, a as MiddlewareRegistry, b as ResolvedMiddleware, c as RouteRule } from './shared/server.DLPB_I9q.cjs';
+import { MiddlewareHandler } from '@mokup/shared/hono';
+export { MiddlewareHandler } from '@mokup/shared/hono';
 export { createFetchHandler } from './fetch.cjs';
 export { F as FetchHandler, S as ServerOptions, W as WorkerBundle, a as WorkerInput } from './shared/server.LMr0or7K.cjs';
 export { createMokupWorker } from './worker.cjs';
 export { Manifest, ManifestRoute, ModuleMap, RuntimeOptions } from '@mokup/runtime';
-export { MiddlewareHandler } from '@mokup/shared/hono';
 
+type HookHandler = () => void | Promise<void>;
+interface ConfigApp {
+    use: (...handlers: MiddlewareHandler[]) => void;
+}
 type DefineConfigFactory = (context: {
-    pre: MiddlewareRegistry;
-    normal: MiddlewareRegistry;
-    post: MiddlewareRegistry;
-}) => RouteDirectoryConfig | void;
+    app: ConfigApp;
+}) => RouteDirectoryConfig | void | Promise<RouteDirectoryConfig | void>;
+declare function onBeforeAll(handler: HookHandler): void;
+declare function onAfterAll(handler: HookHandler): void;
 /**
- * Define a directory config with Hono-style middleware registration.
+ * Define a directory config with hook-based middleware registration.
  *
  * @param input - Config object or factory callback.
  * @returns Route directory config with middleware metadata.
  *
  * @example
- * import { defineConfig } from '@mokup/server'
+ * import { defineConfig, onBeforeAll, onAfterAll } from '@mokup/server'
  *
- * export default defineConfig(({ pre, normal, post }) => {
- *   pre.use(async (c, next) => {
- *     c.header('x-before', '1')
- *     await next()
+ * export default defineConfig(({ app }) => {
+ *   onBeforeAll(() => {
+ *     app.use(async (c, next) => {
+ *       c.header('x-before', '1')
+ *       await next()
+ *     })
  *   })
  *
- *   normal.use(async (_c, next) => {
+ *   app.use(async (_c, next) => {
  *     await next()
  *   })
  *
- *   post.use(async (c, next) => {
- *     await next()
- *     c.header('x-after', '1')
+ *   onAfterAll(() => {
+ *     app.use(async (c, next) => {
+ *       await next()
+ *       c.header('x-after', '1')
+ *     })
  *   })
  *
  *   return { delay: 120 }
  * })
  */
-declare function defineConfig(input: RouteDirectoryConfig | DefineConfigFactory): RouteDirectoryConfig;
+declare function defineConfig(input: RouteDirectoryConfig | DefineConfigFactory): RouteDirectoryConfig | Promise<RouteDirectoryConfig>;
 
-export { MiddlewareRegistry, RouteDirectoryConfig, defineConfig };
+export { RouteDirectoryConfig, defineConfig, onAfterAll, onBeforeAll };

package/dist/index.d.mts

@@ -1,43 +1,52 @@
-import { R as RouteDirectoryConfig, M as MiddlewareRegistry } from './shared/server.CyVIKPsp.mjs';
-export { a as MiddlewarePosition, b as ResolvedMiddleware, c as RouteRule } from './shared/server.CyVIKPsp.mjs';
+import { R as RouteDirectoryConfig } from './shared/server.DLPB_I9q.mjs';
+export { H as HookErrorPolicy, M as MiddlewarePosition, a as MiddlewareRegistry, b as ResolvedMiddleware, c as RouteRule } from './shared/server.DLPB_I9q.mjs';
+import { MiddlewareHandler } from '@mokup/shared/hono';
+export { MiddlewareHandler } from '@mokup/shared/hono';
 export { createFetchHandler } from './fetch.mjs';
 export { F as FetchHandler, S as ServerOptions, W as WorkerBundle, a as WorkerInput } from './shared/server.LMr0or7K.mjs';
 export { createMokupWorker } from './worker.mjs';
 export { Manifest, ManifestRoute, ModuleMap, RuntimeOptions } from '@mokup/runtime';
-export { MiddlewareHandler } from '@mokup/shared/hono';
 
+type HookHandler = () => void | Promise<void>;
+interface ConfigApp {
+    use: (...handlers: MiddlewareHandler[]) => void;
+}
 type DefineConfigFactory = (context: {
-    pre: MiddlewareRegistry;
-    normal: MiddlewareRegistry;
-    post: MiddlewareRegistry;
-}) => RouteDirectoryConfig | void;
+    app: ConfigApp;
+}) => RouteDirectoryConfig | void | Promise<RouteDirectoryConfig | void>;
+declare function onBeforeAll(handler: HookHandler): void;
+declare function onAfterAll(handler: HookHandler): void;
 /**
- * Define a directory config with Hono-style middleware registration.
+ * Define a directory config with hook-based middleware registration.
  *
  * @param input - Config object or factory callback.
  * @returns Route directory config with middleware metadata.
  *
  * @example
- * import { defineConfig } from '@mokup/server'
+ * import { defineConfig, onBeforeAll, onAfterAll } from '@mokup/server'
  *
- * export default defineConfig(({ pre, normal, post }) => {
- *   pre.use(async (c, next) => {
- *     c.header('x-before', '1')
- *     await next()
+ * export default defineConfig(({ app }) => {
+ *   onBeforeAll(() => {
+ *     app.use(async (c, next) => {
+ *       c.header('x-before', '1')
+ *       await next()
+ *     })
  *   })
  *
- *   normal.use(async (_c, next) => {
+ *   app.use(async (_c, next) => {
  *     await next()
  *   })
  *
- *   post.use(async (c, next) => {
- *     await next()
- *     c.header('x-after', '1')
+ *   onAfterAll(() => {
+ *     app.use(async (c, next) => {
+ *       await next()
+ *       c.header('x-after', '1')
+ *     })
  *   })
  *
  *   return { delay: 120 }
  * })
  */
-declare function defineConfig(input: RouteDirectoryConfig | DefineConfigFactory): RouteDirectoryConfig;
+declare function defineConfig(input: RouteDirectoryConfig | DefineConfigFactory): RouteDirectoryConfig | Promise<RouteDirectoryConfig>;
 
-export { MiddlewareRegistry, RouteDirectoryConfig, defineConfig };
+export { RouteDirectoryConfig, defineConfig, onAfterAll, onBeforeAll };

package/dist/index.d.ts

@@ -1,43 +1,52 @@
-import { R as RouteDirectoryConfig, M as MiddlewareRegistry } from './shared/server.CyVIKPsp.js';
-export { a as MiddlewarePosition, b as ResolvedMiddleware, c as RouteRule } from './shared/server.CyVIKPsp.js';
+import { R as RouteDirectoryConfig } from './shared/server.DLPB_I9q.js';
+export { H as HookErrorPolicy, M as MiddlewarePosition, a as MiddlewareRegistry, b as ResolvedMiddleware, c as RouteRule } from './shared/server.DLPB_I9q.js';
+import { MiddlewareHandler } from '@mokup/shared/hono';
+export { MiddlewareHandler } from '@mokup/shared/hono';
 export { createFetchHandler } from './fetch.js';
 export { F as FetchHandler, S as ServerOptions, W as WorkerBundle, a as WorkerInput } from './shared/server.LMr0or7K.js';
 export { createMokupWorker } from './worker.js';
 export { Manifest, ManifestRoute, ModuleMap, RuntimeOptions } from '@mokup/runtime';
-export { MiddlewareHandler } from '@mokup/shared/hono';
 
+type HookHandler = () => void | Promise<void>;
+interface ConfigApp {
+    use: (...handlers: MiddlewareHandler[]) => void;
+}
 type DefineConfigFactory = (context: {
-    pre: MiddlewareRegistry;
-    normal: MiddlewareRegistry;
-    post: MiddlewareRegistry;
-}) => RouteDirectoryConfig | void;
+    app: ConfigApp;
+}) => RouteDirectoryConfig | void | Promise<RouteDirectoryConfig | void>;
+declare function onBeforeAll(handler: HookHandler): void;
+declare function onAfterAll(handler: HookHandler): void;
 /**
- * Define a directory config with Hono-style middleware registration.
+ * Define a directory config with hook-based middleware registration.
  *
  * @param input - Config object or factory callback.
  * @returns Route directory config with middleware metadata.
  *
  * @example
- * import { defineConfig } from '@mokup/server'
+ * import { defineConfig, onBeforeAll, onAfterAll } from '@mokup/server'
  *
- * export default defineConfig(({ pre, normal, post }) => {
- *   pre.use(async (c, next) => {
- *     c.header('x-before', '1')
- *     await next()
+ * export default defineConfig(({ app }) => {
+ *   onBeforeAll(() => {
+ *     app.use(async (c, next) => {
+ *       c.header('x-before', '1')
+ *       await next()
+ *     })
  *   })
  *
- *   normal.use(async (_c, next) => {
+ *   app.use(async (_c, next) => {
  *     await next()
  *   })
  *
- *   post.use(async (c, next) => {
- *     await next()
- *     c.header('x-after', '1')
+ *   onAfterAll(() => {
+ *     app.use(async (c, next) => {
+ *       await next()
+ *       c.header('x-after', '1')
+ *     })
  *   })
  *
  *   return { delay: 120 }
  * })
  */
-declare function defineConfig(input: RouteDirectoryConfig | DefineConfigFactory): RouteDirectoryConfig;
+declare function defineConfig(input: RouteDirectoryConfig | DefineConfigFactory): RouteDirectoryConfig | Promise<RouteDirectoryConfig>;
 
-export { MiddlewareRegistry, RouteDirectoryConfig, defineConfig };
+export { RouteDirectoryConfig, defineConfig, onAfterAll, onBeforeAll };

package/dist/index.mjs

@@ -4,12 +4,90 @@ import '@mokup/runtime';
 import './shared/server.LbftO9Jh.mjs';
 
 const middlewareSymbol = Symbol.for("mokup.config.middlewares");
-function createRegistry(list) {
-  return {
-    use: (...handlers) => {
-      list.push(...handlers);
+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 isPromise(value) {
+  return !!value && typeof value.then === "function";
+}
+function normalizeHookError(policy) {
+  if (policy === "throw" || policy === "silent") {
+    return policy;
+  }
+  return "warn";
+}
+function reportHookError(error, policy) {
+  if (policy === "silent") {
+    return;
+  }
+  if (policy === "warn") {
+    console.warn("[@mokup/server] 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, {
@@ -18,22 +96,71 @@ function attachMetadata(config, meta) {
   });
   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 = {
-      pre: createRegistry(pre),
-      normal: createRegistry(normal),
-      post: createRegistry(post)
+      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 });
     };
-    const result = input(context);
-    const config2 = result && typeof result === "object" ? result : {};
-    return attachMetadata(config2, { pre, normal, post });
+    if (isPromise(result)) {
+      return result.then(finalize);
+    }
+    return finalize(result);
   }
-  const config = input && typeof input === "object" ? input : {};
+  const config = normalizeConfig(input);
   return attachMetadata(config, { pre: [], normal: [], post: [] });
 }
 
-export { defineConfig };
+export { defineConfig, onAfterAll, onBeforeAll };

package/dist/node.cjs

@@ -13,13 +13,17 @@ require('./shared/server.aaygIV2Q.cjs');
 require('@mokup/shared/pathe');
 require('node:fs');
 require('node:module');
-require('node:process');
+require('@mokup/shared/playground-grouping');
+require('@mokup/shared/path-utils');
+require('@mokup/shared/timing');
 require('node:buffer');
 require('node:url');
 require('@mokup/shared/esbuild');
+require('node:process');
 require('@mokup/shared/jsonc-parser');
 require('@mokup/shared/hono');
 require('./fetch.cjs');
+require('node:path');
 
 
 

package/dist/node.d.cts

@@ -9,6 +9,6 @@ export { serve } from '@hono/node-server';
 import './shared/server.D0gAciOr.cjs';
 import './shared/server.LMr0or7K.cjs';
 import '@mokup/runtime';
-import './shared/server.CyVIKPsp.cjs';
+import './shared/server.DLPB_I9q.cjs';
 import '@mokup/shared/hono';
 import '@mokup/shared';

package/dist/node.d.mts

@@ -9,6 +9,6 @@ export { serve } from '@hono/node-server';
 import './shared/server.D0gAciOr.mjs';
 import './shared/server.LMr0or7K.mjs';
 import '@mokup/runtime';
-import './shared/server.CyVIKPsp.mjs';
+import './shared/server.DLPB_I9q.mjs';
 import '@mokup/shared/hono';
 import '@mokup/shared';

package/dist/node.d.ts

@@ -9,6 +9,6 @@ export { serve } from '@hono/node-server';
 import './shared/server.D0gAciOr.js';
 import './shared/server.LMr0or7K.js';
 import '@mokup/runtime';
-import './shared/server.CyVIKPsp.js';
+import './shared/server.DLPB_I9q.js';
 import '@mokup/shared/hono';
 import '@mokup/shared';

package/dist/node.mjs

@@ -11,10 +11,14 @@ import './shared/server.LbftO9Jh.mjs';
 import '@mokup/shared/pathe';
 import 'node:fs';
 import 'node:module';
-import 'node:process';
+import '@mokup/shared/playground-grouping';
+import '@mokup/shared/path-utils';
+import '@mokup/shared/timing';
 import 'node:buffer';
 import 'node:url';
 import '@mokup/shared/esbuild';
+import 'node:process';
 import '@mokup/shared/jsonc-parser';
 import '@mokup/shared/hono';
 import './fetch.mjs';
+import 'node:path';

package/dist/shared/{server.CyVIKPsp.d.cts → server.DLPB_I9q.d.cts}

@@ -141,6 +141,12 @@ interface RouteDirectoryConfig {
      * @default undefined
      */
     middleware?: MiddlewareHandler | MiddlewareHandler[];
+    /**
+     * Error handling policy for defineConfig hooks.
+     *
+     * @default "warn"
+     */
+    hookError?: HookErrorPolicy;
 }
 /**
  * Middleware execution position.
@@ -151,6 +157,10 @@ interface RouteDirectoryConfig {
  * 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.
  *
@@ -211,4 +221,4 @@ interface ResolvedRoute {
 }
 type RouteTable = ResolvedRoute[];
 
-export type { MiddlewareRegistry as M, RouteDirectoryConfig as R, MiddlewarePosition as a, ResolvedMiddleware as b, RouteRule as c, RouteTable as d };
+export type { HookErrorPolicy as H, MiddlewarePosition as M, RouteDirectoryConfig as R, MiddlewareRegistry as a, ResolvedMiddleware as b, RouteRule as c, RouteTable as d };