keryx 0.30.0 → 0.31.1

package/classes/API.ts

@@ -26,7 +26,7 @@ export enum RUN_MODE {
 export class API {
   /** The root directory of the user's application. Set this before calling `initialize()`. */
   rootDir: string;
-  /** The root directory of the keryx package itself (auto-resolved from `import.meta.path`). */
+  /** The root directory of the keryx package itself (auto-resolved from `import.meta.filename`). */
   packageDir: string;
   /** Whether `initialize()` has completed successfully. */
   initialized: boolean;
@@ -50,7 +50,7 @@ export class API {
 
   constructor() {
     this.bootTime = new Date().getTime();
-    this.packageDir = path.join(import.meta.path, "..", "..");
+    this.packageDir = path.join(import.meta.filename, "..", "..");
     this.rootDir = this.packageDir;
     this.logger = new Logger(config.logger);
 

package/initializers/channels.ts

@@ -10,7 +10,7 @@ import { globLoader } from "../util/glob";
 
 const namespace = "channels";
 const PRESENCE_KEY_PREFIX = "presence:";
-const LUA_DIR = join(import.meta.dir, "..", "lua");
+const LUA_DIR = join(import.meta.dirname, "..", "lua");
 
 const ADD_PRESENCE_LUA = await Bun.file(
   join(LUA_DIR, "add-presence.lua"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keryx",
-  "version": "0.30.0",
+  "version": "0.31.1",
   "module": "index.ts",
   "type": "module",
   "license": "MIT",
@@ -77,7 +77,7 @@
     "start": "bun keryx.ts start",
     "dev": "bun --watch keryx.ts start",
     "migrations": "bun run migrations.ts",
-    "test": "tsc && bun test",
+    "test": "tsc && bunx --bun vitest run",
     "compile": "bun build keryx.ts --compile --outfile keryx",
     "lint": "tsc && biome check .",
     "format": "tsc && biome check --write .",
@@ -100,11 +100,18 @@
   "peerDependencies": {
     "drizzle-orm": "^0.45.2",
     "drizzle-zod": "^0.8.3",
+    "vitest": "^4.1.9",
     "zod": "^4.3.6"
   },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/bun": "^1.3.12",
     "drizzle-kit": "^0.31.10",
-    "drizzle-zod": "^0.8.3"
+    "drizzle-zod": "^0.8.3",
+    "vitest": "^4.1.9"
   }
 }

package/templates/generate/test.ts.mustache

@@ -1,4 +1,4 @@
-import { afterAll, beforeAll, describe, expect, test } from "bun:test";
+import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { api } from "keryx";
 
 beforeAll(async () => {

package/templates/scaffold/index.ts.mustache

@@ -4,7 +4,7 @@ import { api } from "keryx";
 // actions, initializers, channels, etc. from this directory.
 // Every entry point (keryx.ts, migrations.ts, test setup) should
 // `import "./index"` to ensure rootDir is set before anything runs.
-api.rootDir = import.meta.dir;
+api.rootDir = import.meta.dirname;
 
 // Re-export everything from keryx for convenience
 export * from "keryx";

package/templates/scaffold/vitest.config.ts.mustache

@@ -0,0 +1,18 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    include: ["__tests__/**/*.test.ts"],
+    globals: false,
+    // Run on the Bun runtime via `bunx --bun vitest`. The forks pool keeps
+    // Node/Bun process APIs available; file parallelism is disabled so test
+    // files that boot the server don't race on the shared database/Redis.
+    pool: "forks",
+    fileParallelism: false,
+    testTimeout: 15_000,
+    hookTimeout: 60_000,
+    // zod (and other CJS deps consumed via named imports) must be transformed
+    // by Vite so the named-export interop works under the Bun runtime.
+    server: { deps: { inline: ["zod"] } },
+  },
+});

package/testing/index.ts

@@ -1,4 +1,4 @@
-import { afterAll, beforeAll } from "bun:test";
+import { afterAll, beforeAll } from "vitest";
 import { api } from "../api";
 import type { WebServer } from "../servers/web";
 

package/testing/websocket.ts

@@ -1,4 +1,4 @@
-import { expect } from "bun:test";
+import { expect } from "vitest";
 import { api } from "../api";
 import type { WebServer } from "../servers/web";
 

package/util/componentRegistry.ts

@@ -24,13 +24,13 @@ export interface ComponentDef {
 }
 
 const generateTemplatesDir = path.join(
-  import.meta.dir,
+  import.meta.dirname,
   "..",
   "templates",
   "generate",
 );
 const scaffoldTemplatesDir = path.join(
-  import.meta.dir,
+  import.meta.dirname,
   "..",
   "templates",
   "scaffold",

package/util/oauthTemplates.ts

@@ -20,7 +20,7 @@ export type OAuthTemplates = {
   lionSvg: string;
 };
 
-const frameworkTemplatesDir = import.meta.dir + "/../templates";
+const frameworkTemplatesDir = import.meta.dirname + "/../templates";
 
 /**
  * Resolve a template file, checking the user's rootDir first, then falling back

package/util/scaffold.ts

@@ -66,7 +66,7 @@ export async function generateOAuthTemplateContents(): Promise<
     "oauth-common.css",
     "lion.svg",
   ];
-  const sourceDir = path.join(import.meta.dir, "..", "templates");
+  const sourceDir = path.join(import.meta.dirname, "..", "templates");
 
   for (const file of oauthTemplates) {
     const content = await Bun.file(path.join(sourceDir, file)).text();
@@ -85,7 +85,7 @@ export async function generateConfigFileContents(): Promise<
   Map<string, string>
 > {
   const result = new Map<string, string>();
-  const configDir = path.join(import.meta.dir, "..", "config");
+  const configDir = path.join(import.meta.dirname, "..", "config");
   const glob = new Glob("**/*.ts");
 
   for await (const file of glob.scan(configDir)) {
@@ -140,7 +140,7 @@ export async function generateBuiltinActionContents(): Promise<
 > {
   const result = new Map<string, string>();
   const builtinActions = ["status.ts", "swagger.ts"];
-  const actionsDir = path.join(import.meta.dir, "..", "actions");
+  const actionsDir = path.join(import.meta.dirname, "..", "actions");
 
   for (const file of builtinActions) {
     let content = await Bun.file(path.join(actionsDir, file)).text();
@@ -318,6 +318,7 @@ export async function scaffoldProject(
           start: "bun keryx.ts start",
           dev: "bun --watch keryx.ts start",
           ...(options.includeDb ? { migrations: "bun run migrations.ts" } : {}),
+          test: "tsc && bunx --bun vitest run",
           lint: "tsc && biome check .",
           format: "tsc && biome check --write .",
         },
@@ -334,6 +335,7 @@ export async function scaffoldProject(
         devDependencies: {
           "@biomejs/biome": "^2.4.8",
           "@types/bun": "latest",
+          vitest: "^4.1.9",
           ...(options.includeDb ? { "drizzle-kit": "^0.20.18" } : {}),
         },
       },
@@ -343,6 +345,7 @@ export async function scaffoldProject(
   );
 
   await write("tsconfig.json", generateTsconfigContents());
+  await writeTemplate("vitest.config.ts", "vitest.config.ts.mustache");
   await write(
     "biome.json",
     JSON.stringify(