@stratum-hq/create 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @stratum-hq/create
 
+## 0.3.1
+
+### Patch Changes
+
+- b55ae70: Correct and complete package metadata for the npm registry listing.
+
+  Every published package now declares `license` (MIT), `author`, `homepage`, and
+  `bugs`. Runtime packages declare `engines` (Node >=20) to match the project's
+  support policy; this fixes `@stratum-hq/cli`, which previously declared Node >=18.
+  `@stratum-hq/mysql` and `@stratum-hq/mongodb` gain the `keywords` array they were
+  missing. No runtime code changes.
+
+- c17b1a5: Point `@stratum-hq/create`'s `exports["./matrix"]` at built output instead of raw source (#219, from the #133 v1.0 surface review).
+
+  The `./matrix` subpath previously resolved (and shipped) `./src/matrix.ts` for both the `import` and `types` conditions, blessing a raw-source subpath unlike every other package. The build now emits `dist/matrix.js` and `./matrix` resolves there, matching the package's `.` entry. The stack-combination matrix API is unchanged.
+
+- c17b1a5: Give the `@stratum-hq/db-adapters` barrel one consistent naming scheme for the tenant-context helpers (#219, from the #133 v1.0 surface review).
+
+  The barrel previously exposed the same "run in tenant context" concept under colliding names patched over with `as` aliases. The 1.0 names use an `<orm>` prefix so no export is an alias workaround:
+  - `withTenant` (Prisma) -> `prismaWithTenant`
+  - `withDrizzleTenant` -> `drizzleWithTenant`
+  - `withTenantScope` (Sequelize) -> `sequelizeWithTenantScope`
+  - `withDrizzleTenantScope` -> `drizzleWithTenantScope`
+  - `enableRLSMigration` (migration helper) -> `enableRLSForMigration` (distinct from the runtime `enableRLS`)
+
+  Behavior is identical; only the exported names change. The `@stratum-hq/cli` and `@stratum-hq/create` scaffolding templates emit the new `prismaWithTenant` name. Update your imports to the new names.
+
+- 4adcbb5: Stop shipping test files in published tarballs. tsc-built packages now exclude **tests** directories and .test/.spec files from compilation, so dist and the tarball contain only real package output. The create package, which ships source for its ./matrix export, excludes tests via .npmignore instead. The vitest runner is unaffected and still runs tests from src.
+
 ## 0.3.0
 
 ### Minor Changes

package/dist/index.js

@@ -283,7 +283,7 @@ model Tenant {
       content: `// Prisma client with Stratum tenant-scoped queries
 import { PrismaClient } from "@prisma/client";
 import { Pool } from "pg";
-import { withTenant } from "@stratum-hq/db-adapters";
+import { prismaWithTenant } from "@stratum-hq/db-adapters";
 
 const prisma = new PrismaClient();
 const pool = new Pool({
@@ -293,7 +293,7 @@ const pool = new Pool({
 // Create a tenant-scoped Prisma client.
 // All queries through this client are automatically filtered by RLS.
 export function createTenantPrisma(getTenantId: () => string) {
-  return withTenant(prisma, getTenantId, pool);
+  return prismaWithTenant(prisma, getTenantId, pool);
 }
 
 // Usage:
@@ -330,7 +330,7 @@ export const db = drizzle(connection);
       content: `// Drizzle ORM with Stratum tenant-scoped queries
 import { drizzle } from "drizzle-orm/node-postgres";
 import { Pool } from "pg";
-import { withTenantDrizzle } from "@stratum-hq/db-adapters";
+import { drizzleWithTenant } from "@stratum-hq/db-adapters";
 
 const pool = new Pool({
   connectionString: process.env.DATABASE_URL,
@@ -341,7 +341,7 @@ export const db = drizzle(pool);
 // Create a tenant-scoped Drizzle instance.
 // Queries are automatically filtered by RLS policy.
 export function createTenantDb(getTenantId: () => string) {
-  return withTenantDrizzle(db, getTenantId, pool);
+  return drizzleWithTenant(db, getTenantId, pool);
 }
 
 // Usage:

package/dist/matrix.js

@@ -0,0 +1,131 @@
+// src/matrix.ts
+var POSTGRES_STRATEGIES = ["rls", "schema", "database"];
+var POSTGRES_ORMS = ["prisma", "drizzle", "sequelize", "knex", "pg"];
+var MONGODB_STRATEGIES = ["database", "collection"];
+var MONGODB_ORMS = ["mongoose"];
+var MYSQL_STRATEGIES = ["database", "table-prefix"];
+var MYSQL_ORMS = ["sequelize", "knex", "pg"];
+var ALL_FRAMEWORKS = ["express", "fastify", "nextjs", "hono", "nestjs", "none"];
+var VALID_COMBINATIONS = {
+  postgres: {
+    strategies: POSTGRES_STRATEGIES,
+    orms: POSTGRES_ORMS,
+    frameworks: ALL_FRAMEWORKS
+  },
+  mongodb: {
+    strategies: MONGODB_STRATEGIES,
+    orms: MONGODB_ORMS,
+    frameworks: ALL_FRAMEWORKS
+  },
+  mysql: {
+    strategies: MYSQL_STRATEGIES,
+    orms: MYSQL_ORMS,
+    frameworks: ALL_FRAMEWORKS
+  }
+};
+var ALL_DATABASES = ["postgres", "mongodb", "mysql"];
+var ALL_STRATEGIES = ["rls", "schema", "database", "collection", "table-prefix"];
+var ALL_ORMS = ["prisma", "drizzle", "sequelize", "knex", "mongoose", "pg"];
+function isValidPreset(preset) {
+  const config = VALID_COMBINATIONS[preset.database];
+  if (!config)
+    return false;
+  if (!config.strategies.includes(preset.strategy))
+    return false;
+  if (!config.orms.includes(preset.orm))
+    return false;
+  if (!config.frameworks.includes(preset.framework))
+    return false;
+  return true;
+}
+function parsePresetString(s) {
+  if (!s || typeof s !== "string")
+    return null;
+  const parts = s.toLowerCase().split("-");
+  let database;
+  let strategy;
+  let orm;
+  let framework;
+  if (parts.length === 4) {
+    [database, strategy, orm, framework] = parts;
+  } else if (parts.length === 5) {
+    database = parts[0];
+    strategy = `${parts[1]}-${parts[2]}`;
+    orm = parts[3];
+    framework = parts[4];
+  } else {
+    return null;
+  }
+  if (!ALL_DATABASES.includes(database))
+    return null;
+  if (!ALL_STRATEGIES.includes(strategy))
+    return null;
+  if (!ALL_ORMS.includes(orm))
+    return null;
+  if (!ALL_FRAMEWORKS.includes(framework))
+    return null;
+  return {
+    database,
+    strategy,
+    orm,
+    framework
+  };
+}
+function formatPresetString(preset) {
+  return `${preset.database}-${preset.strategy}-${preset.orm}-${preset.framework}`;
+}
+function getValidOptions(partial) {
+  let databases = [...ALL_DATABASES];
+  let strategies = [];
+  let orms = [];
+  let frameworks = [];
+  if (partial.database) {
+    databases = [partial.database];
+  }
+  const strategySet = /* @__PURE__ */ new Set();
+  const ormSet = /* @__PURE__ */ new Set();
+  const frameworkSet = /* @__PURE__ */ new Set();
+  for (const db of databases) {
+    const config = VALID_COMBINATIONS[db];
+    if (partial.strategy && !config.strategies.includes(partial.strategy))
+      continue;
+    if (partial.orm && !config.orms.includes(partial.orm))
+      continue;
+    for (const s of config.strategies)
+      strategySet.add(s);
+    for (const o of config.orms)
+      ormSet.add(o);
+    for (const f of config.frameworks)
+      frameworkSet.add(f);
+  }
+  strategies = [...strategySet];
+  orms = [...ormSet];
+  frameworks = [...frameworkSet];
+  if (partial.strategy) {
+    strategies = strategies.filter((s) => s === partial.strategy);
+  }
+  if (partial.orm) {
+    orms = orms.filter((o) => o === partial.orm);
+  }
+  if (partial.framework) {
+    frameworks = frameworks.filter((f) => f === partial.framework);
+  }
+  if (partial.strategy || partial.orm) {
+    databases = databases.filter((db) => {
+      const config = VALID_COMBINATIONS[db];
+      if (partial.strategy && !config.strategies.includes(partial.strategy))
+        return false;
+      if (partial.orm && !config.orms.includes(partial.orm))
+        return false;
+      return true;
+    });
+  }
+  return { databases, strategies, orms, frameworks };
+}
+export {
+  VALID_COMBINATIONS,
+  formatPresetString,
+  getValidOptions,
+  isValidPreset,
+  parsePresetString
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratum-hq/create",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Create a new Stratum multi-tenancy project",
   "keywords": [
     "multi-tenancy",
@@ -20,14 +20,13 @@
   },
   "exports": {
     ".": "./dist/index.js",
-    "./matrix": {
-      "import": "./src/matrix.ts",
-      "types": "./src/matrix.ts"
-    }
+    "./matrix": "./dist/matrix.js"
   },
   "type": "module",
   "scripts": {
-    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --external:@stratum-hq/*",
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --external:@stratum-hq/* && esbuild src/matrix.ts --bundle --platform=node --format=esm --outfile=dist/matrix.js --external:@stratum-hq/*",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
     "test": "vitest run"
   },
   "devDependencies": {
@@ -40,6 +39,12 @@
     "registry": "https://registry.npmjs.org/"
   },
   "license": "MIT",
+  "author": "Christian Crank",
+  "homepage": "https://github.com/stratum-hq/Stratum/tree/main/packages/create#readme",
+  "bugs": "https://github.com/stratum-hq/Stratum/issues",
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/stratum-hq/Stratum.git",

package/src/generators/db-setup.ts

@@ -58,7 +58,7 @@ model Tenant {
       content: `// Prisma client with Stratum tenant-scoped queries
 import { PrismaClient } from "@prisma/client";
 import { Pool } from "pg";
-import { withTenant } from "@stratum-hq/db-adapters";
+import { prismaWithTenant } from "@stratum-hq/db-adapters";
 
 const prisma = new PrismaClient();
 const pool = new Pool({
@@ -68,7 +68,7 @@ const pool = new Pool({
 // Create a tenant-scoped Prisma client.
 // All queries through this client are automatically filtered by RLS.
 export function createTenantPrisma(getTenantId: () => string) {
-  return withTenant(prisma, getTenantId, pool);
+  return prismaWithTenant(prisma, getTenantId, pool);
 }
 
 // Usage:
@@ -107,7 +107,7 @@ export const db = drizzle(connection);
       content: `// Drizzle ORM with Stratum tenant-scoped queries
 import { drizzle } from "drizzle-orm/node-postgres";
 import { Pool } from "pg";
-import { withTenantDrizzle } from "@stratum-hq/db-adapters";
+import { drizzleWithTenant } from "@stratum-hq/db-adapters";
 
 const pool = new Pool({
   connectionString: process.env.DATABASE_URL,
@@ -118,7 +118,7 @@ export const db = drizzle(pool);
 // Create a tenant-scoped Drizzle instance.
 // Queries are automatically filtered by RLS policy.
 export function createTenantDb(getTenantId: () => string) {
-  return withTenantDrizzle(db, getTenantId, pool);
+  return drizzleWithTenant(db, getTenantId, pool);
 }
 
 // Usage:

package/src/__tests__/create.test.ts

@@ -1,217 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
-import { parseArgs, createProject, validateProjectName } from "../index.js";
-
-// ─── parseArgs tests ──────────────────────────────────────────────────────────
-
-describe("parseArgs", () => {
-  it("extracts project name from positional arg", () => {
-    const result = parseArgs(["my-app"]);
-    expect(result.projectName).toBe("my-app");
-  });
-
-  it("defaults template to express", () => {
-    const result = parseArgs(["my-app"]);
-    expect(result.template).toBe("express");
-  });
-
-  it("parses --template flag", () => {
-    const result = parseArgs(["my-app", "--template", "fastify"]);
-    expect(result.template).toBe("fastify");
-  });
-
-  it("parses --template=value syntax", () => {
-    const result = parseArgs(["my-app", "--template=nextjs"]);
-    expect(result.template).toBe("nextjs");
-  });
-
-  it("parses --skip-install flag", () => {
-    const result = parseArgs(["my-app", "--skip-install"]);
-    expect(result.skipInstall).toBe(true);
-  });
-
-  it("parses --force flag", () => {
-    const result = parseArgs(["my-app", "--force"]);
-    expect(result.force).toBe(true);
-  });
-
-  it("returns null projectName when no positional arg given", () => {
-    const result = parseArgs(["--template", "express"]);
-    expect(result.projectName).toBeNull();
-  });
-
-  it("skipInstall defaults to false", () => {
-    const result = parseArgs(["my-app"]);
-    expect(result.skipInstall).toBe(false);
-  });
-
-  it("force defaults to false", () => {
-    const result = parseArgs(["my-app"]);
-    expect(result.force).toBe(false);
-  });
-});
-
-// ─── Error cases ──────────────────────────────────────────────────────────────
-
-describe("main arg validation", () => {
-  it("errors when no project name given", () => {
-    // parseArgs returns null projectName, which main() would exit on
-    const result = parseArgs([]);
-    expect(result.projectName).toBeNull();
-  });
-});
-
-// ─── File generation tests ────────────────────────────────────────────────────
-
-describe("createProject", () => {
-  let tmpDir: string;
-  let projectDir: string;
-
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "stratum-create-test-"));
-    projectDir = path.join(tmpDir, "test-project");
-    fs.mkdirSync(projectDir, { recursive: true });
-  });
-
-  afterEach(() => {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-  });
-
-  it("generates correct files for express template", () => {
-    createProject("test-project", "express", projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "package.json"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "docker-compose.yml"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, ".env.example"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "index.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "README.md"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "init.sql"))).toBe(true);
-  });
-
-  it("generates correct files for fastify template", () => {
-    createProject("test-project", "fastify", projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "src", "index.ts"))).toBe(true);
-    const serverContent = fs.readFileSync(
-      path.join(projectDir, "src", "index.ts"),
-      "utf8",
-    );
-    expect(serverContent).toContain("Fastify");
-  });
-
-  it("generates correct files for nextjs template", () => {
-    createProject("test-project", "nextjs", projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "src", "app", "page.tsx"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "middleware.ts"))).toBe(true);
-  });
-
-  it("package.json contains @stratum-hq/lib dependency", () => {
-    createProject("test-project", "express", projectDir, true);
-
-    const pkgContent = fs.readFileSync(path.join(projectDir, "package.json"), "utf8");
-    const pkg = JSON.parse(pkgContent);
-    expect(pkg.dependencies["@stratum-hq/lib"]).toBeDefined();
-  });
-
-  it("package.json contains pg dependency", () => {
-    createProject("test-project", "express", projectDir, true);
-
-    const pkgContent = fs.readFileSync(path.join(projectDir, "package.json"), "utf8");
-    const pkg = JSON.parse(pkgContent);
-    expect(pkg.dependencies["pg"]).toBeDefined();
-  });
-
-  it("package.json contains express dependency for express template", () => {
-    createProject("test-project", "express", projectDir, true);
-
-    const pkgContent = fs.readFileSync(path.join(projectDir, "package.json"), "utf8");
-    const pkg = JSON.parse(pkgContent);
-    expect(pkg.dependencies["express"]).toBeDefined();
-  });
-
-  it("docker-compose.yml contains PostgreSQL 16", () => {
-    createProject("test-project", "express", projectDir, true);
-
-    const dockerContent = fs.readFileSync(
-      path.join(projectDir, "docker-compose.yml"),
-      "utf8",
-    );
-    expect(dockerContent).toContain("postgres:16-alpine");
-  });
-
-  it("init.sql enables uuid-ossp and ltree extensions", () => {
-    createProject("test-project", "express", projectDir, true);
-
-    const sqlContent = fs.readFileSync(path.join(projectDir, "init.sql"), "utf8");
-    expect(sqlContent).toContain("uuid-ossp");
-    expect(sqlContent).toContain("ltree");
-  });
-
-  it(".env.example contains DATABASE_URL", () => {
-    createProject("test-project", "express", projectDir, true);
-
-    const envContent = fs.readFileSync(path.join(projectDir, ".env.example"), "utf8");
-    expect(envContent).toContain("DATABASE_URL");
-  });
-
-  it("default template is express", () => {
-    const result = parseArgs(["my-app"]);
-    expect(result.template).toBe("express");
-  });
-});
-
-// ─── Project name validation ──────────────────────────────────────────────────
-
-describe("validateProjectName", () => {
-  it("accepts a valid name", () => {
-    expect(validateProjectName("valid-name")).toBeNull();
-  });
-
-  it("accepts names with dots and underscores", () => {
-    expect(validateProjectName("my.app_1")).toBeNull();
-  });
-
-  it("rejects empty string", () => {
-    expect(validateProjectName("")).not.toBeNull();
-  });
-
-  it("rejects name with spaces", () => {
-    expect(validateProjectName("name with spaces")).not.toBeNull();
-  });
-
-  it("rejects path traversal with ../", () => {
-    expect(validateProjectName("../escape")).not.toBeNull();
-  });
-
-  it("rejects absolute path", () => {
-    expect(validateProjectName("/absolute/path")).not.toBeNull();
-  });
-
-  it("rejects name starting with a dot", () => {
-    expect(validateProjectName(".hidden")).not.toBeNull();
-  });
-
-  it("rejects name with path separator embedded", () => {
-    expect(validateProjectName("foo/bar")).not.toBeNull();
-  });
-});
-
-// ─── Directory existence error ────────────────────────────────────────────────
-
-describe("directory existence check", () => {
-  it("errors when directory exists without --force", () => {
-    // parseArgs doesn't control this — main() does the fs.existsSync check.
-    // We verify that parseArgs returns force=false by default, which triggers the error.
-    const result = parseArgs(["existing-dir"]);
-    expect(result.force).toBe(false);
-    // When force is false and dir exists, main() calls process.exit(1)
-  });
-
-  it("--force flag allows overwriting existing directory", () => {
-    const result = parseArgs(["existing-dir", "--force"]);
-    expect(result.force).toBe(true);
-  });
-});

package/src/__tests__/matrix.test.ts

@@ -1,283 +0,0 @@
-import { describe, it, expect } from "vitest";
-import {
-  parsePresetString,
-  formatPresetString,
-  isValidPreset,
-  getValidOptions,
-  VALID_COMBINATIONS,
-  type StackPreset,
-} from "../matrix.js";
-
-// ─── parsePresetString ───────────────────────────────────────────────────────
-
-describe("parsePresetString", () => {
-  it("parses a valid postgres preset", () => {
-    const result = parsePresetString("postgres-rls-prisma-express");
-    expect(result).toEqual({
-      database: "postgres",
-      strategy: "rls",
-      orm: "prisma",
-      framework: "express",
-    });
-  });
-
-  it("parses a valid mongodb preset", () => {
-    const result = parsePresetString("mongodb-database-mongoose-hono");
-    expect(result).toEqual({
-      database: "mongodb",
-      strategy: "database",
-      orm: "mongoose",
-      framework: "hono",
-    });
-  });
-
-  it("parses mysql with table-prefix (hyphenated strategy)", () => {
-    const result = parsePresetString("mysql-table-prefix-sequelize-nestjs");
-    expect(result).toEqual({
-      database: "mysql",
-      strategy: "table-prefix",
-      orm: "sequelize",
-      framework: "nestjs",
-    });
-  });
-
-  it("parses preset with none framework", () => {
-    const result = parsePresetString("postgres-schema-drizzle-none");
-    expect(result).toEqual({
-      database: "postgres",
-      strategy: "schema",
-      orm: "drizzle",
-      framework: "none",
-    });
-  });
-
-  it("handles uppercase input by lowering", () => {
-    const result = parsePresetString("POSTGRES-RLS-PRISMA-EXPRESS");
-    expect(result).toEqual({
-      database: "postgres",
-      strategy: "rls",
-      orm: "prisma",
-      framework: "express",
-    });
-  });
-
-  it("returns null for empty string", () => {
-    expect(parsePresetString("")).toBeNull();
-  });
-
-  it("returns null for garbage input", () => {
-    expect(parsePresetString("invalid-garbage")).toBeNull();
-  });
-
-  it("returns null for too few parts", () => {
-    expect(parsePresetString("postgres-rls")).toBeNull();
-  });
-
-  it("returns null for too many parts (non table-prefix)", () => {
-    expect(parsePresetString("postgres-rls-prisma-express-extra-stuff")).toBeNull();
-  });
-
-  it("returns null for unknown database", () => {
-    expect(parsePresetString("redis-rls-prisma-express")).toBeNull();
-  });
-
-  it("returns null for unknown orm", () => {
-    expect(parsePresetString("postgres-rls-typeorm-express")).toBeNull();
-  });
-
-  it("returns null for unknown framework", () => {
-    expect(parsePresetString("postgres-rls-prisma-koa")).toBeNull();
-  });
-
-  it("returns null for unknown strategy", () => {
-    expect(parsePresetString("postgres-sharding-prisma-express")).toBeNull();
-  });
-});
-
-// ─── formatPresetString ──────────────────────────────────────────────────────
-
-describe("formatPresetString", () => {
-  it("formats a simple preset", () => {
-    const preset: StackPreset = {
-      database: "postgres",
-      strategy: "rls",
-      orm: "prisma",
-      framework: "express",
-    };
-    expect(formatPresetString(preset)).toBe("postgres-rls-prisma-express");
-  });
-
-  it("formats a table-prefix preset", () => {
-    const preset: StackPreset = {
-      database: "mysql",
-      strategy: "table-prefix",
-      orm: "sequelize",
-      framework: "nestjs",
-    };
-    expect(formatPresetString(preset)).toBe("mysql-table-prefix-sequelize-nestjs");
-  });
-
-  it("round-trips with parsePresetString", () => {
-    const original = "mongodb-collection-mongoose-fastify";
-    const parsed = parsePresetString(original)!;
-    expect(parsed).not.toBeNull();
-    expect(formatPresetString(parsed)).toBe(original);
-  });
-
-  it("round-trips table-prefix", () => {
-    const original = "mysql-table-prefix-knex-hono";
-    const parsed = parsePresetString(original)!;
-    expect(parsed).not.toBeNull();
-    expect(formatPresetString(parsed)).toBe(original);
-  });
-});
-
-// ─── isValidPreset ───────────────────────────────────────────────────────────
-
-describe("isValidPreset", () => {
-  // Valid PostgreSQL combos
-  it("accepts postgres-rls-prisma-express", () => {
-    expect(isValidPreset({ database: "postgres", strategy: "rls", orm: "prisma", framework: "express" })).toBe(true);
-  });
-
-  it("accepts postgres-schema-drizzle-fastify", () => {
-    expect(isValidPreset({ database: "postgres", strategy: "schema", orm: "drizzle", framework: "fastify" })).toBe(true);
-  });
-
-  it("accepts postgres-database-pg-none", () => {
-    expect(isValidPreset({ database: "postgres", strategy: "database", orm: "pg", framework: "none" })).toBe(true);
-  });
-
-  it("accepts postgres-rls-knex-hono", () => {
-    expect(isValidPreset({ database: "postgres", strategy: "rls", orm: "knex", framework: "hono" })).toBe(true);
-  });
-
-  it("accepts postgres-rls-sequelize-nestjs", () => {
-    expect(isValidPreset({ database: "postgres", strategy: "rls", orm: "sequelize", framework: "nestjs" })).toBe(true);
-  });
-
-  // Valid MongoDB combos
-  it("accepts mongodb-database-mongoose-express", () => {
-    expect(isValidPreset({ database: "mongodb", strategy: "database", orm: "mongoose", framework: "express" })).toBe(true);
-  });
-
-  it("accepts mongodb-collection-mongoose-hono", () => {
-    expect(isValidPreset({ database: "mongodb", strategy: "collection", orm: "mongoose", framework: "hono" })).toBe(true);
-  });
-
-  // Valid MySQL combos
-  it("accepts mysql-database-sequelize-express", () => {
-    expect(isValidPreset({ database: "mysql", strategy: "database", orm: "sequelize", framework: "express" })).toBe(true);
-  });
-
-  it("accepts mysql-table-prefix-knex-nextjs", () => {
-    expect(isValidPreset({ database: "mysql", strategy: "table-prefix", orm: "knex", framework: "nextjs" })).toBe(true);
-  });
-
-  it("accepts mysql-database-pg-fastify", () => {
-    expect(isValidPreset({ database: "mysql", strategy: "database", orm: "pg", framework: "fastify" })).toBe(true);
-  });
-
-  // Invalid combos
-  it("rejects mongodb-rls-prisma-express (rls not valid for mongodb)", () => {
-    expect(isValidPreset({ database: "mongodb", strategy: "rls", orm: "prisma", framework: "express" })).toBe(false);
-  });
-
-  it("rejects mongodb-database-prisma-express (prisma not valid for mongodb)", () => {
-    expect(isValidPreset({ database: "mongodb", strategy: "database", orm: "prisma", framework: "express" })).toBe(false);
-  });
-
-  it("rejects postgres-collection-prisma-express (collection not valid for postgres)", () => {
-    expect(isValidPreset({ database: "postgres", strategy: "collection", orm: "prisma", framework: "express" })).toBe(false);
-  });
-
-  it("rejects mysql-rls-sequelize-express (rls not valid for mysql)", () => {
-    expect(isValidPreset({ database: "mysql", strategy: "rls", orm: "sequelize", framework: "express" })).toBe(false);
-  });
-
-  it("rejects mysql-database-mongoose-express (mongoose not valid for mysql)", () => {
-    expect(isValidPreset({ database: "mysql", strategy: "database", orm: "mongoose", framework: "express" })).toBe(false);
-  });
-
-  it("rejects postgres-rls-mongoose-express (mongoose not valid for postgres)", () => {
-    expect(isValidPreset({ database: "postgres", strategy: "rls", orm: "mongoose", framework: "express" })).toBe(false);
-  });
-});
-
-// ─── getValidOptions ─────────────────────────────────────────────────────────
-
-describe("getValidOptions", () => {
-  it("returns all options when no selection made", () => {
-    const opts = getValidOptions({});
-    expect(opts.databases).toContain("postgres");
-    expect(opts.databases).toContain("mongodb");
-    expect(opts.databases).toContain("mysql");
-    expect(opts.orms.length).toBeGreaterThan(0);
-    expect(opts.strategies.length).toBeGreaterThan(0);
-    expect(opts.frameworks.length).toBeGreaterThan(0);
-  });
-
-  it("narrows orms to mongoose when mongodb selected", () => {
-    const opts = getValidOptions({ database: "mongodb" });
-    expect(opts.orms).toEqual(["mongoose"]);
-  });
-
-  it("narrows strategies when mongodb selected", () => {
-    const opts = getValidOptions({ database: "mongodb" });
-    expect(opts.strategies).toEqual(["database", "collection"]);
-  });
-
-  it("narrows databases when mongoose selected", () => {
-    const opts = getValidOptions({ orm: "mongoose" });
-    expect(opts.databases).toEqual(["mongodb"]);
-  });
-
-  it("narrows databases when rls strategy selected", () => {
-    const opts = getValidOptions({ strategy: "rls" });
-    expect(opts.databases).toEqual(["postgres"]);
-  });
-
-  it("includes all frameworks for any database", () => {
-    for (const db of ["postgres", "mongodb", "mysql"] as const) {
-      const opts = getValidOptions({ database: db });
-      expect(opts.frameworks).toContain("express");
-      expect(opts.frameworks).toContain("none");
-    }
-  });
-
-  it("narrows databases when table-prefix selected", () => {
-    const opts = getValidOptions({ strategy: "table-prefix" });
-    expect(opts.databases).toEqual(["mysql"]);
-  });
-
-  it("includes postgres and mysql for sequelize", () => {
-    const opts = getValidOptions({ orm: "sequelize" });
-    expect(opts.databases).toContain("postgres");
-    expect(opts.databases).toContain("mysql");
-    expect(opts.databases).not.toContain("mongodb");
-  });
-});
-
-// ─── VALID_COMBINATIONS structure ────────────────────────────────────────────
-
-describe("VALID_COMBINATIONS", () => {
-  it("has all three databases", () => {
-    expect(Object.keys(VALID_COMBINATIONS)).toEqual(["postgres", "mongodb", "mysql"]);
-  });
-
-  it("postgres has rls, schema, database strategies", () => {
-    expect(VALID_COMBINATIONS.postgres.strategies).toEqual(["rls", "schema", "database"]);
-  });
-
-  it("mongodb has database, collection strategies", () => {
-    expect(VALID_COMBINATIONS.mongodb.strategies).toEqual(["database", "collection"]);
-  });
-
-  it("mysql has database, table-prefix strategies", () => {
-    expect(VALID_COMBINATIONS.mysql.strategies).toEqual(["database", "table-prefix"]);
-  });
-
-  it("mongodb only supports mongoose", () => {
-    expect(VALID_COMBINATIONS.mongodb.orms).toEqual(["mongoose"]);
-  });
-});

package/src/__tests__/preset.test.ts

@@ -1,266 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
-import { parseArgs, createProject } from "../index.js";
-import { createPresetProject } from "../preset-project.js";
-import type { StackPreset } from "../matrix.js";
-
-// ─── parseArgs --preset tests ────────────────────────────────────────────────
-
-describe("parseArgs --preset", () => {
-  it("parses --preset flag", () => {
-    const result = parseArgs(["my-app", "--preset", "postgres-rls-prisma-express"]);
-    expect(result.preset).toBe("postgres-rls-prisma-express");
-  });
-
-  it("parses --preset=value syntax", () => {
-    const result = parseArgs(["my-app", "--preset=mongodb-database-mongoose-hono"]);
-    expect(result.preset).toBe("mongodb-database-mongoose-hono");
-  });
-
-  it("preset defaults to null", () => {
-    const result = parseArgs(["my-app"]);
-    expect(result.preset).toBeNull();
-  });
-
-  it("existing --template still works when no preset", () => {
-    const result = parseArgs(["my-app", "--template", "fastify"]);
-    expect(result.template).toBe("fastify");
-    expect(result.preset).toBeNull();
-  });
-});
-
-// ─── Regression: existing template tests ─────────────────────────────────────
-
-describe("regression: --template path unchanged", () => {
-  let tmpDir: string;
-  let projectDir: string;
-
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "stratum-preset-regress-"));
-    projectDir = path.join(tmpDir, "test-project");
-    fs.mkdirSync(projectDir, { recursive: true });
-  });
-
-  afterEach(() => {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-  });
-
-  it("--template express still generates correct files", () => {
-    createProject("test-project", "express", projectDir, true);
-    expect(fs.existsSync(path.join(projectDir, "package.json"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "docker-compose.yml"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "index.ts"))).toBe(true);
-
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
-    expect(pkg.dependencies["express"]).toBeDefined();
-    expect(pkg.dependencies["@stratum-hq/lib"]).toBeDefined();
-  });
-
-  it("--template nextjs still generates correct files", () => {
-    createProject("test-project", "nextjs", projectDir, true);
-    expect(fs.existsSync(path.join(projectDir, "src", "app", "page.tsx"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "middleware.ts"))).toBe(true);
-  });
-});
-
-// ─── Preset project generation ───────────────────────────────────────────────
-
-describe("createPresetProject", () => {
-  let tmpDir: string;
-  let projectDir: string;
-
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "stratum-preset-test-"));
-    projectDir = path.join(tmpDir, "test-project");
-    fs.mkdirSync(projectDir, { recursive: true });
-  });
-
-  afterEach(() => {
-    fs.rmSync(tmpDir, { recursive: true, force: true });
-  });
-
-  // ── PostgreSQL presets ──
-
-  it("generates postgres-rls-prisma-express project", () => {
-    const preset: StackPreset = { database: "postgres", strategy: "rls", orm: "prisma", framework: "express" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "package.json"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "docker-compose.yml"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "init.sql"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, ".env.example"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "index.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "prisma", "schema.prisma"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "stratum-prisma.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "README.md"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "tsconfig.json"))).toBe(true);
-
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
-    expect(pkg.dependencies["@prisma/client"]).toBeDefined();
-    expect(pkg.dependencies["express"]).toBeDefined();
-    expect(pkg.dependencies["@stratum-hq/lib"]).toBeDefined();
-    expect(pkg.dependencies["@stratum-hq/db-adapters"]).toBeDefined();
-
-    const docker = fs.readFileSync(path.join(projectDir, "docker-compose.yml"), "utf8");
-    expect(docker).toContain("postgres:16-alpine");
-
-    const sql = fs.readFileSync(path.join(projectDir, "init.sql"), "utf8");
-    expect(sql).toContain("uuid-ossp");
-    expect(sql).toContain("ltree");
-    expect(sql).toContain("Row-Level Security");
-  });
-
-  it("generates postgres-schema-drizzle-fastify project", () => {
-    const preset: StackPreset = { database: "postgres", strategy: "schema", orm: "drizzle", framework: "fastify" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "src", "stratum-drizzle.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "drizzle.config.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "index.ts"))).toBe(true);
-
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
-    expect(pkg.dependencies["drizzle-orm"]).toBeDefined();
-    expect(pkg.dependencies["fastify"]).toBeDefined();
-
-    const server = fs.readFileSync(path.join(projectDir, "src", "index.ts"), "utf8");
-    expect(server).toContain("Fastify");
-  });
-
-  it("generates postgres-database-pg-express project", () => {
-    const preset: StackPreset = { database: "postgres", strategy: "database", orm: "pg", framework: "express" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "src", "stratum-db.ts"))).toBe(true);
-
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
-    expect(pkg.dependencies["pg"]).toBeDefined();
-    expect(pkg.dependencies["@stratum-hq/db-adapters"]).toBeDefined();
-  });
-
-  // ── MongoDB presets ──
-
-  it("generates mongodb-database-mongoose-hono project", () => {
-    const preset: StackPreset = { database: "mongodb", strategy: "database", orm: "mongoose", framework: "hono" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "docker-compose.yml"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "stratum-mongoose.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "index.ts"))).toBe(true);
-    // MongoDB should NOT have init.sql
-    expect(fs.existsSync(path.join(projectDir, "init.sql"))).toBe(false);
-
-    const docker = fs.readFileSync(path.join(projectDir, "docker-compose.yml"), "utf8");
-    expect(docker).toContain("mongo:7");
-
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
-    expect(pkg.dependencies["mongoose"]).toBeDefined();
-    expect(pkg.dependencies["hono"]).toBeDefined();
-    expect(pkg.dependencies["@stratum-hq/mongodb"]).toBeDefined();
-
-    const env = fs.readFileSync(path.join(projectDir, ".env.example"), "utf8");
-    expect(env).toContain("MONGODB_URI");
-  });
-
-  // ── MySQL presets ──
-
-  it("generates mysql-table-prefix-sequelize-nestjs project", () => {
-    const preset: StackPreset = { database: "mysql", strategy: "table-prefix", orm: "sequelize", framework: "nestjs" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "docker-compose.yml"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "init.sql"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "stratum-sequelize.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "main.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "app.module.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "tenant.guard.ts"))).toBe(true);
-
-    const docker = fs.readFileSync(path.join(projectDir, "docker-compose.yml"), "utf8");
-    expect(docker).toContain("mysql:8");
-
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
-    expect(pkg.dependencies["sequelize"]).toBeDefined();
-    expect(pkg.dependencies["@nestjs/core"]).toBeDefined();
-    expect(pkg.dependencies["@stratum-hq/mysql"]).toBeDefined();
-    expect(pkg.dependencies["@stratum-hq/nestjs"]).toBeDefined();
-  });
-
-  it("generates mysql-database-knex-express project", () => {
-    const preset: StackPreset = { database: "mysql", strategy: "database", orm: "knex", framework: "express" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "knexfile.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "stratum-knex.ts"))).toBe(true);
-
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
-    expect(pkg.dependencies["knex"]).toBeDefined();
-    expect(pkg.dependencies["express"]).toBeDefined();
-  });
-
-  // ── Next.js preset ──
-
-  it("generates postgres-rls-prisma-nextjs project", () => {
-    const preset: StackPreset = { database: "postgres", strategy: "rls", orm: "prisma", framework: "nextjs" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "middleware.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "app", "page.tsx"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "prisma", "schema.prisma"))).toBe(true);
-
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
-    expect(pkg.dependencies["next"]).toBeDefined();
-    expect(pkg.dependencies["react"]).toBeDefined();
-    expect(pkg.scripts.dev).toBe("next dev");
-  });
-
-  // ── "none" framework ──
-
-  it("generates postgres-rls-pg-none project", () => {
-    const preset: StackPreset = { database: "postgres", strategy: "rls", orm: "pg", framework: "none" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    expect(fs.existsSync(path.join(projectDir, "src", "index.ts"))).toBe(true);
-    expect(fs.existsSync(path.join(projectDir, "src", "stratum-db.ts"))).toBe(true);
-
-    const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
-    // Should not have any framework dependency
-    expect(pkg.dependencies["express"]).toBeUndefined();
-    expect(pkg.dependencies["fastify"]).toBeUndefined();
-    expect(pkg.dependencies["next"]).toBeUndefined();
-    expect(pkg.dependencies["hono"]).toBeUndefined();
-    expect(pkg.dependencies["@nestjs/core"]).toBeUndefined();
-  });
-
-  // ── README content ──
-
-  it("README mentions the preset stack", () => {
-    const preset: StackPreset = { database: "postgres", strategy: "rls", orm: "prisma", framework: "express" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    const readme = fs.readFileSync(path.join(projectDir, "README.md"), "utf8");
-    expect(readme).toContain("postgres");
-    expect(readme).toContain("rls");
-    expect(readme).toContain("prisma");
-    expect(readme).toContain("Row-Level Security");
-  });
-
-  // ── tsconfig.json ──
-
-  it("generates tsconfig with decorators for nestjs", () => {
-    const preset: StackPreset = { database: "postgres", strategy: "rls", orm: "prisma", framework: "nestjs" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    const tsconfig = JSON.parse(fs.readFileSync(path.join(projectDir, "tsconfig.json"), "utf8"));
-    expect(tsconfig.compilerOptions.experimentalDecorators).toBe(true);
-    expect(tsconfig.compilerOptions.emitDecoratorMetadata).toBe(true);
-  });
-
-  it("generates tsconfig with jsx for nextjs", () => {
-    const preset: StackPreset = { database: "postgres", strategy: "rls", orm: "prisma", framework: "nextjs" };
-    createPresetProject("test-project", preset, projectDir, true);
-
-    const tsconfig = JSON.parse(fs.readFileSync(path.join(projectDir, "tsconfig.json"), "utf8"));
-    expect(tsconfig.compilerOptions.jsx).toBe("preserve");
-  });
-});