keryx 0.1.2 → 0.2.1

package/classes/API.ts

@@ -1,5 +1,8 @@
+import { Glob } from "bun";
+import fs from "fs";
 import path from "path";
 import { config } from "../config";
+import { deepMerge } from "../util/config";
 import { globLoader } from "../util/glob";
 import type { Initializer, InitializerSortKeys } from "./Initializer";
 import { Logger } from "./Logger";
@@ -43,6 +46,7 @@ export class API {
     this.logger.warn("--- 🔄  Initializing process ---");
     this.initialized = false;
 
+    await this.loadLocalConfig();
     await this.findInitializers();
     this.sortInitializers("loadPriority");
 
@@ -138,6 +142,26 @@ export class API {
     flapPreventer = false;
   }
 
+  private async loadLocalConfig() {
+    if (this.rootDir === this.packageDir) return;
+
+    const configDir = path.join(this.rootDir, "config");
+    if (!fs.existsSync(configDir)) return;
+
+    const glob = new Glob("**/*.ts");
+    for await (const file of glob.scan(configDir)) {
+      if (file.startsWith(".")) continue;
+
+      const fullPath = path.join(configDir, file);
+      const mod = await import(fullPath);
+      const overrides = mod.default ?? mod;
+      if (overrides && typeof overrides === "object") {
+        deepMerge(config, overrides);
+        this.logger.debug(`Loaded user config from config/${file}`);
+      }
+    }
+  }
+
   private async findInitializers() {
     // Load framework initializers from the package directory
     const frameworkInitializers = await globLoader<Initializer>(

package/config/index.ts

@@ -21,3 +21,5 @@ export const config = {
   server: { cli: configServerCli, web: configServerWeb, mcp: configServerMcp },
   tasks: configTasks,
 };
+
+export type KeryxConfig = typeof config;

package/index.ts

@@ -19,7 +19,8 @@ import "./initializers/swagger";
 export * from "./api";
 export type { ActionMiddleware } from "./classes/Action";
 export { ErrorStatusCodes, ErrorType, TypedError } from "./classes/TypedError";
-export { loadFromEnvIfSet } from "./util/config";
+export type { KeryxConfig } from "./config";
+export { deepMerge, loadFromEnvIfSet } from "./util/config";
 export { globLoader } from "./util/glob";
 export {
   isSecret,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keryx",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "module": "index.ts",
   "type": "module",
   "license": "MIT",
@@ -61,6 +61,7 @@
     "start": "bun keryx.ts start",
     "dev": "bun --watch keryx.ts start",
     "migrations": "bun run migrations.ts",
+    "test": "tsc && bun test",
     "compile": "bun build keryx.ts --compile --outfile keryx",
     "lint": "tsc && prettier --check .",
     "format": "tsc && prettier --write ."

package/util/config.ts

@@ -1,3 +1,32 @@
+/**
+Deep-merges source into target, mutating target in place.
+Only plain objects are recursively merged; arrays and primitives are overwritten.
+*/
+export function deepMerge<T extends Record<string, any>>(
+  target: T,
+  source: Record<string, any>,
+): T {
+  for (const key of Object.keys(source)) {
+    const targetVal = target[key];
+    const sourceVal = source[key];
+
+    if (
+      targetVal &&
+      sourceVal &&
+      typeof targetVal === "object" &&
+      typeof sourceVal === "object" &&
+      !Array.isArray(targetVal) &&
+      !Array.isArray(sourceVal)
+    ) {
+      deepMerge(targetVal, sourceVal);
+    } else {
+      (target as any)[key] = sourceVal;
+    }
+  }
+
+  return target;
+}
+
 /**
 Loads a value from the environment, if it's set, otherwise returns the default value.
 */

package/util/scaffold.ts

@@ -1,3 +1,4 @@
+import { Glob } from "bun";
 import fs from "fs";
 import Mustache from "mustache";
 import path from "path";
@@ -152,6 +153,38 @@ export async function scaffoldProject(
   await writeTemplate("keryx.ts", "keryx.ts.mustache");
   await writeTemplate(".env.example", "env.example.mustache");
   await writeTemplate(".gitignore", "gitignore.mustache");
+  // Copy config files from the framework, adjusting imports for user projects
+  const configDir = path.join(import.meta.dir, "..", "config");
+  const glob = new Glob("**/*.ts");
+  for await (const file of glob.scan(configDir)) {
+    let content = await Bun.file(path.join(configDir, file)).text();
+
+    // Rewrite relative imports to package imports
+    content = content.replace(
+      /from ["']\.\.\/\.\.\/util\/config["']/g,
+      'from "keryx"',
+    );
+    content = content.replace(
+      /from ["']\.\.\/util\/config["']/g,
+      'from "keryx"',
+    );
+    content = content.replace(
+      /from ["']\.\.\/classes\/Logger["']/g,
+      'from "keryx/classes/Logger.ts"',
+    );
+
+    // In index.ts, change `export const config` to `export default`
+    // and remove the KeryxConfig type 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/,
+        "\n",
+      );
+    }
+
+    await write(`config/${file}`, content);
+  }
 
   // Create empty directories with .gitkeep
   await write("initializers/.gitkeep", "");