keryx 0.10.7 → 0.11.1

package/api.ts

@@ -1,5 +1,6 @@
 import { API } from "./classes/API";
 import type { Logger } from "./classes/Logger";
+import type { KeryxConfig } from "./config";
 import { config as Config } from "./config";
 
 export {
@@ -30,7 +31,7 @@ export type {
 declare namespace globalThis {
   let api: API;
   let logger: Logger;
-  let config: typeof Config;
+  let config: KeryxConfig;
 }
 
 if (!globalThis.api) {

package/config/index.ts

@@ -26,4 +26,32 @@ export const config = {
   tasks: configTasks,
 };
 
-export type KeryxConfig = typeof config;
+/**
+ * The type of the merged configuration object. Applications can extend this
+ * via module augmentation to add custom config sections:
+ *
+ * ```typescript
+ * declare module "keryx" {
+ *   interface KeryxConfig {
+ *     audit: { retentionDays: number };
+ *   }
+ * }
+ * ```
+ */
+export interface KeryxConfig {
+  actions: typeof configActions;
+  channels: typeof configChannels;
+  process: typeof configProcess;
+  logger: typeof configLogger;
+  database: typeof configDatabase;
+  observability: typeof configObservability;
+  redis: typeof configRedis;
+  rateLimit: typeof configRateLimit;
+  session: typeof configSession;
+  server: {
+    cli: typeof configServerCli;
+    web: typeof configServerWeb;
+    mcp: typeof configServerMcp;
+  };
+  tasks: typeof configTasks;
+}

package/index.ts

@@ -18,9 +18,17 @@ import "./initializers/signals";
 import "./initializers/swagger";
 
 export * from "./api";
+export { HTTP_METHOD } from "./classes/Action";
 export type { ActionMiddleware } from "./classes/Action";
+export { CHANNEL_NAME_PATTERN } from "./classes/Channel";
+export type { ChannelMiddleware } from "./classes/Channel";
+export { LogLevel } from "./classes/Logger";
 export { ErrorStatusCodes, ErrorType, TypedError } from "./classes/TypedError";
 export type { KeryxConfig } from "./config";
+export type { SessionData } from "./initializers/session";
+export { RateLimitMiddleware, checkRateLimit } from "./middleware/rateLimit";
+export type { WebServer } from "./servers/web";
+export { buildProgram } from "./util/cli";
 export { deepMerge, loadFromEnvIfSet } from "./util/config";
 export { globLoader } from "./util/glob";
 export {

package/initializers/mcp.ts

@@ -321,7 +321,6 @@ export class McpInitializer extends Initializer {
 
   async stop() {
     if (!config.server.mcp.enabled) return;
-    if (!api.mcp) return;
 
     // Close all transports
     for (const transport of api.mcp.transports.values()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keryx",
-  "version": "0.10.7",
+  "version": "0.11.1",
   "module": "index.ts",
   "type": "module",
   "license": "MIT",

package/templates/generate/action-middleware.ts.mustache

@@ -1,4 +1,4 @@
-import type { ActionMiddleware } from "keryx/classes/Action.ts";
+import type { ActionMiddleware } from "keryx";
 
 export const {{className}}: ActionMiddleware = {
   runBefore: async (params, connection) => {

package/templates/generate/action.ts.mustache

@@ -1,6 +1,5 @@
 import { z } from "zod";
-import { Action, type ActionParams } from "keryx";
-import { HTTP_METHOD } from "keryx/classes/Action.ts";
+import { Action, type ActionParams, HTTP_METHOD } from "keryx";
 
 export class {{className}} implements Action {
   name = "{{name}}";

package/templates/scaffold/hello-action.ts.mustache

@@ -1,6 +1,5 @@
 import { z } from "zod";
-import { Action, type ActionParams } from "keryx";
-import { HTTP_METHOD } from "keryx/classes/Action.ts";
+import { Action, type ActionParams, HTTP_METHOD } from "keryx";
 
 export class Hello implements Action {
   name = "hello";

package/templates/scaffold/keryx.ts.mustache

@@ -3,7 +3,7 @@
 // Set rootDir before any framework code loads actions
 import "./index";
 
-import { buildProgram } from "keryx/util/cli.ts";
+import { buildProgram } from "keryx";
 import pkg from "./package.json";
 
 const program = await buildProgram({

package/util/glob.ts

@@ -25,26 +25,8 @@ export async function globLoader<T>(searchDir: string) {
       const fullPath = path.join(dir, file);
       const modules = (await import(fullPath)) as Record<string, unknown>;
 
-      // Object.entries() can throw ReferenceError if an export is still in
-      // TDZ (temporal dead zone) due to circular imports. Fall back to
-      // per-key access so one TDZ export doesn't block the entire module.
-      let entries: [string, unknown][];
-      try {
-        entries = Object.entries(modules);
-      } catch {
-        const keys = Object.getOwnPropertyNames(modules);
-        entries = [];
-        for (const key of keys) {
-          try {
-            entries.push([key, modules[key]]);
-          } catch {
-            // Skip TDZ exports — they'll be loaded by their own initializer
-          }
-        }
-      }
-
-      for (const [name, klass] of entries) {
-        // Skip non-class exports (constants, functions, type remnants)
+      for (const [name, klass] of Object.entries(modules)) {
+        // Skip non-class exports (constants, enums, functions)
         if (typeof klass !== "function" || klass.prototype === undefined) {
           continue;
         }

package/util/scaffold.ts

@@ -101,15 +101,15 @@ export async function generateConfigFileContents(): Promise<
     );
     content = content.replace(
       /from ["']\.\.\/classes\/Logger["']/g,
-      'from "keryx/classes/Logger.ts"',
+      'from "keryx"',
     );
 
     // In index.ts, change `export const config` to `export default`
-    // and remove the KeryxConfig type export (it comes from the package)
+    // and remove the KeryxConfig interface export (it comes from the package)
     if (file === "index.ts") {
       content = content.replace("export const config =", "export default");
       content = content.replace(
-        /\nexport type KeryxConfig = typeof config;\n/,
+        /\nexport interface KeryxConfig \{[\s\S]*?\}\n/,
         "\n",
       );
     }
@@ -139,7 +139,7 @@ export async function generateBuiltinActionContents(): Promise<
     content = content.replace(/from ["']\.\.\/api["']/g, 'from "keryx"');
     content = content.replace(
       /from ["']\.\.\/classes\/Action["']/g,
-      'from "keryx/classes/Action.ts"',
+      'from "keryx"',
     );
     content = content.replace(
       /from ["']\.\.\/package\.json["']/g,