@raiyyan/brisk 0.1.0 → 0.2.0

package/starters/sqlite-auth/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "es2024",
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "strict": true,
+    "exactOptionalPropertyTypes": true,
+    "noUncheckedIndexedAccess": true,
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "erasableSyntaxOnly": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src", "test", "vitest.config.ts"]
+}

package/starters/sqlite-auth/vitest.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    // templates/ holds the files `brisk g` renders; they are not tests until rendered.
+    include: ["test/**/*.test.ts"],
+    env: {
+      NODE_ENV: "test",
+      DATABASE_PATH: ":memory:",
+      AUTH_SECRET: "test-secret-that-is-at-least-32-characters-long",
+      ADMIN_EMAIL: "admin@example.com",
+      ADMIN_PASSWORD: "admin-password-for-tests",
+    },
+  },
+});

package/dist/src/cli/generate.d.ts

@@ -1,9 +0,0 @@
-import type { Names } from "./names.ts";
-/**
- * Writes a feature folder (schema, repository, service, controller) and its test, and registers the controller
- * in `src/features/index.ts` under its camel-case name, which becomes its key in the typed client.
- */
-export declare function generateFeature(root: string, names: Names): string[];
-/** Writes a typed middleware to `src/middlewares/<name>.ts`. */
-export declare function generateMiddleware(root: string, names: Names): string[];
-//# sourceMappingURL=generate.d.ts.map

package/dist/src/cli/generate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/generate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAYxC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CA2BpE;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAIvE"}

package/dist/src/cli/generate.js

@@ -1,39 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { CliError, write } from "./system.js";
-import { controllerTemplate, middlewareTemplate, repositoryTemplate, schemaTemplate, serviceTemplate, testTemplate, } from "./templates/feature.js";
-import { CONTROLLERS_MARKER, IMPORTS_MARKER, REGISTRY } from "./templates/project.js";
-/**
- * Writes a feature folder (schema, repository, service, controller) and its test, and registers the controller
- * in `src/features/index.ts` under its camel-case name, which becomes its key in the typed client.
- */
-export function generateFeature(root, names) {
-    const { kebab, camel } = names;
-    const dir = join(root, "src/features", kebab);
-    if (existsSync(dir))
-        throw new CliError(`src/features/${kebab} already exists`);
-    const registry = join(root, REGISTRY);
-    const source = existsSync(registry) ? readFileSync(registry, "utf8") : "";
-    if (!source.includes(IMPORTS_MARKER) || !source.includes(CONTROLLERS_MARKER)) {
-        throw new CliError(`${REGISTRY} must contain "${IMPORTS_MARKER}" and "${CONTROLLERS_MARKER}"`);
-    }
-    const created = [
-        write(join(dir, `${kebab}.schema.ts`), schemaTemplate(names)),
-        write(join(dir, `${kebab}.repository.ts`), repositoryTemplate(names)),
-        write(join(dir, `${kebab}.service.ts`), serviceTemplate(names)),
-        write(join(dir, `${kebab}.controller.ts`), controllerTemplate(names)),
-        write(join(root, "test", `${kebab}.test.ts`), testTemplate(names)),
-    ];
-    writeFileSync(registry, source
-        .replace(IMPORTS_MARKER, `import { ${camel}Controller } from "./${kebab}/${kebab}.controller.ts";\n${IMPORTS_MARKER}`)
-        .replace(/^(\s*)\/\/ @brisk:controllers/m, `$1${camel}: ${camel}Controller,\n$1${CONTROLLERS_MARKER}`));
-    return created;
-}
-/** Writes a typed middleware to `src/middlewares/<name>.ts`. */
-export function generateMiddleware(root, names) {
-    const path = join(root, "src/middlewares", `${names.kebab}.ts`);
-    if (existsSync(path))
-        throw new CliError(`src/middlewares/${names.kebab}.ts already exists`);
-    return [write(path, middlewareTemplate(names))];
-}
-//# sourceMappingURL=generate.js.map

package/dist/src/cli/generate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/cli/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEtF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAY;IACxD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,KAAK,iBAAiB,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,QAAQ,CAAC,GAAG,QAAQ,kBAAkB,cAAc,UAAU,kBAAkB,GAAG,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,OAAO,GAAG;QACd,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,YAAY,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,aAAa,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,UAAU,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;KACnE,CAAC;IACF,aAAa,CACX,QAAQ,EACR,MAAM;SACH,OAAO,CACN,cAAc,EACd,YAAY,KAAK,wBAAwB,KAAK,IAAI,KAAK,qBAAqB,cAAc,EAAE,CAC7F;SACA,OAAO,CAAC,gCAAgC,EAAE,KAAK,KAAK,KAAK,KAAK,kBAAkB,kBAAkB,EAAE,CAAC,CACzG,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,KAAY;IAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,mBAAmB,KAAK,CAAC,KAAK,oBAAoB,CAAC,CAAC;IAC7F,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/src/cli/templates/auth.d.ts

@@ -1,4 +0,0 @@
-import type { Plan } from "./project.ts";
-/** Bearer-token auth with HS256 tokens from `node:crypto`: no dependency, constant-time checks, expiry. */
-export declare function authFiles(): Partial<Plan>;
-//# sourceMappingURL=auth.d.ts.map

package/dist/src/cli/templates/auth.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,2GAA2G;AAC3G,wBAAgB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAuFzC"}

package/dist/src/cli/templates/auth.js

@@ -1,90 +0,0 @@
-/** Bearer-token auth with HS256 tokens from `node:crypto`: no dependency, constant-time checks, expiry. */
-export function authFiles() {
-    return {
-        files: {
-            "src/auth/tokens.ts": `import { createHmac, timingSafeEqual } from "node:crypto";
-import { z } from "@raiyyan/brisk";
-import { env } from "../env.ts";
-
-export const Role = z.enum(["user", "admin"]);
-export type Role = z.infer<typeof Role>;
-
-const Claims = z.object({ sub: z.string(), role: Role, exp: z.number() });
-export type Claims = z.infer<typeof Claims>;
-
-const HEADER = Buffer.from(JSON.stringify({ alg: "HS256", typ: "JWT" })).toString("base64url");
-
-/** Signs and verifies HS256 JSON Web Tokens with \`AUTH_SECRET\`. */
-export class Tokens {
-  readonly #key = Buffer.from(env.AUTH_SECRET);
-
-  sign(subject: string, role: Role, ttlSeconds = env.AUTH_TOKEN_TTL_SECONDS): string {
-    const claims: Claims = { sub: subject, role, exp: Math.floor(Date.now() / 1000) + ttlSeconds };
-    const body = \`\${HEADER}.\${Buffer.from(JSON.stringify(claims)).toString("base64url")}\`;
-    return \`\${body}.\${this.#signature(body)}\`;
-  }
-
-  /** The token's claims, or \`undefined\` when it is malformed, forged or expired. */
-  verify(token: string): Claims | undefined {
-    const [header, payload, signature, ...rest] = token.split(".");
-    if (!header || !payload || !signature || rest.length > 0 || header !== HEADER) return undefined;
-    const expected = Buffer.from(this.#signature(\`\${header}.\${payload}\`));
-    const actual = Buffer.from(signature);
-    if (actual.length !== expected.length || !timingSafeEqual(actual, expected)) return undefined;
-    try {
-      const claims = Claims.parse(JSON.parse(Buffer.from(payload, "base64url").toString("utf8")));
-      return claims.exp > Date.now() / 1000 ? claims : undefined;
-    } catch {
-      return undefined;
-    }
-  }
-
-  #signature(body: string): string {
-    return createHmac("sha256", this.#key).update(body).digest("base64url");
-  }
-}
-`,
-            "src/middlewares/authenticate.ts": `import { defineMiddleware, ForbiddenError, inject, UnauthorizedError } from "@raiyyan/brisk";
-import { Tokens, type Role } from "../auth/tokens.ts";
-
-/** Requires \`Authorization: Bearer <token>\` and adds \`user\` to ctx; request logs gain the user id. */
-export const authenticate = defineMiddleware(({ req, log }) => {
-  const header = req.get("authorization");
-  const token = header?.startsWith("Bearer ") ? header.slice(7) : undefined;
-  const claims = token ? inject(Tokens).verify(token) : undefined;
-  if (!claims) throw new UnauthorizedError("Valid bearer token required", { challenge: "Bearer" });
-  const user = { id: claims.sub, role: claims.role };
-  return { user, log: log.child({ userId: user.id }) };
-}, "authenticate");
-
-/** Requires an authenticated user with \`role\`; use it after or instead of \`authenticate\`. */
-export const requireRole = (role: Role) =>
-  defineMiddleware(async (ctx) => {
-    const { user } = await authenticate.run(ctx);
-    if (user.role !== role) throw new ForbiddenError(\`Requires the \${role} role\`);
-    return { user };
-  }, \`requireRole(\${role})\`);
-`,
-            "test/auth.test.ts": `import { describe, expect, it } from "vitest";
-import { Container } from "@raiyyan/brisk";
-import { Tokens } from "../src/auth/tokens.ts";
-
-const tokens = new Container().get(Tokens);
-
-describe("tokens", () => {
-  it("round-trips claims", () => {
-    expect(tokens.verify(tokens.sign("u1", "admin"))).toMatchObject({ sub: "u1", role: "admin" });
-  });
-
-  it("rejects forged, malformed and expired tokens", () => {
-    const [header, payload] = tokens.sign("u1", "user").split(".");
-    expect(tokens.verify(\`\${header}.\${payload}.forged\`)).toBeUndefined();
-    expect(tokens.verify("not-a-token")).toBeUndefined();
-    expect(tokens.verify(tokens.sign("u1", "user", -1))).toBeUndefined();
-  });
-});
-`,
-        },
-    };
-}
-//# sourceMappingURL=auth.js.map

package/dist/src/cli/templates/auth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../../src/cli/templates/auth.ts"],"names":[],"mappings":"AAEA,2GAA2G;AAC3G,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,KAAK,EAAE;YACL,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC3B;YACK,iCAAiC,EAAE;;;;;;;;;;;;;;;;;;;;CAoBxC;YACK,mBAAmB,EAAE;;;;;;;;;;;;;;;;;;CAkB1B;SACI;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cli/templates/database.d.ts

@@ -1,4 +0,0 @@
-import type { Plan } from "./project.ts";
-/** A database provider with its lifecycle, a unique-violation mapper, and what the engine needs. */
-export declare function databaseFiles(db: "sqlite" | "postgres"): Partial<Plan>;
-//# sourceMappingURL=database.d.ts.map

package/dist/src/cli/templates/database.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE"}

package/dist/src/cli/templates/database.js

@@ -1,107 +0,0 @@
-/** A database provider with its lifecycle, a unique-violation mapper, and what the engine needs. */
-export function databaseFiles(db) {
-    return db === "sqlite" ? sqlite() : postgres();
-}
-const errorsTemplate = (check) => `import { ConflictError, type ErrorMapper } from "@raiyyan/brisk";
-
-/** A unique constraint failed, here or in an error the driver wrapped: answer 409 instead of 500. */
-export const uniqueViolation: ErrorMapper = (error) => {
-  for (let current: unknown = error; current instanceof Error; current = current.cause) {
-    if (${check}) {
-      return new ConflictError("Already exists", { code: "ALREADY_EXISTS", cause: error });
-    }
-  }
-  return undefined;
-};
-`;
-function sqlite() {
-    return {
-        files: {
-            "src/database/database.ts": `import { DatabaseSync } from "node:sqlite";
-import { inject, Logger, type OnInit, type OnShutdown } from "@raiyyan/brisk";
-import { env } from "../env.ts";
-
-/**
- * The app's SQLite connection (Node's built-in \`node:sqlite\`), opened at boot and closed on shutdown.
- * Repositories inject it: \`readonly #db = inject(Database)\`, then \`this.#db.sql.prepare(...)\`.
- */
-export class Database implements OnInit, OnShutdown {
-  readonly #log = inject(Logger);
-  #connection: DatabaseSync | undefined;
-
-  get sql(): DatabaseSync {
-    if (!this.#connection) throw new Error("Database used before the app booted");
-    return this.#connection;
-  }
-
-  onInit(): void {
-    this.#connection = new DatabaseSync(env.DATABASE_PATH);
-    this.#connection.exec("PRAGMA journal_mode = WAL; PRAGMA foreign_keys = ON; PRAGMA busy_timeout = 5000;");
-    this.#log.info({ path: env.DATABASE_PATH }, "database opened");
-  }
-
-  onShutdown(): void {
-    this.#connection?.close();
-  }
-}
-`,
-            "src/database/errors.ts": errorsTemplate(`"errcode" in current && (current.errcode === 2067 || current.errcode === 1555)`),
-        },
-    };
-}
-function postgres() {
-    return {
-        files: {
-            "src/database/database.ts": `import { inject, Logger, type OnInit, type OnShutdown } from "@raiyyan/brisk";
-import { drizzle, type NodePgDatabase } from "drizzle-orm/node-postgres";
-import { Pool } from "pg";
-import { env } from "../env.ts";
-import * as schema from "./schema.ts";
-
-/**
- * The app's PostgreSQL pool with Drizzle on top. Connections open lazily; \`onInit\` checks the database is
- * reachable before the server listens, and \`onShutdown\` closes the pool after the last request.
- * Repositories inject it: \`readonly #db = inject(Database).db\`.
- */
-export class Database implements OnInit, OnShutdown {
-  readonly #log = inject(Logger);
-  readonly pool = new Pool({ connectionString: env.DATABASE_URL, max: env.DATABASE_POOL_SIZE });
-  readonly db: NodePgDatabase<typeof schema> = drizzle(this.pool, { schema });
-
-  async onInit(): Promise<void> {
-    await this.pool.query("select 1");
-    this.#log.info("database connected");
-  }
-
-  async onShutdown(): Promise<void> {
-    await this.pool.end();
-  }
-}
-`,
-            "src/database/schema.ts": `// Drizzle tables. Define them here, then \`npm run db:generate\` and \`npm run db:migrate\`.
-// import { pgTable, text, timestamp, uuid } from "drizzle-orm/pg-core";
-//
-// export const users = pgTable("users", {
-//   id: uuid().primaryKey().defaultRandom(),
-//   email: text().notNull().unique(),
-//   createdAt: timestamp().notNull().defaultNow(),
-// });
-export {};
-`,
-            "src/database/errors.ts": errorsTemplate(`"code" in current && current.code === "23505"`),
-            "drizzle.config.ts": `import { defineConfig } from "drizzle-kit";
-
-export default defineConfig({
-  dialect: "postgresql",
-  schema: "./src/database/schema.ts",
-  out: "./drizzle",
-  dbCredentials: { url: process.env["DATABASE_URL"] ?? "" },
-});
-`,
-        },
-        dependencies: ["pg", "drizzle-orm"],
-        devDependencies: ["drizzle-kit", "@types/pg"],
-        scripts: { "db:generate": "drizzle-kit generate", "db:migrate": "drizzle-kit migrate" },
-    };
-}
-//# sourceMappingURL=database.js.map

package/dist/src/cli/templates/database.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../../../src/cli/templates/database.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAAC,EAAyB;IACrD,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,cAAc,GAAG,CACrB,KAAa,EACL,EAAE,CAAC;;;;;UAKH,KAAK;;;;;;CAMd,CAAC;AAEF,SAAS,MAAM;IACb,OAAO;QACL,KAAK,EAAE;YACL,0BAA0B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BjC;YACK,wBAAwB,EAAE,cAAc,CACtC,gFAAgF,CACjF;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ;IACf,OAAO;QACL,KAAK,EAAE;YACL,0BAA0B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;CAyBjC;YACK,wBAAwB,EAAE;;;;;;;;;CAS/B;YACK,wBAAwB,EAAE,cAAc,CAAC,+CAA+C,CAAC;YACzF,mBAAmB,EAAE;;;;;;;;CAQ1B;SACI;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC;QACnC,eAAe,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;QAC7C,OAAO,EAAE,EAAE,aAAa,EAAE,sBAAsB,EAAE,YAAY,EAAE,qBAAqB,EAAE;KACxF,CAAC;AACJ,CAAC"}

package/dist/src/cli/templates/docker.d.ts

@@ -1,4 +0,0 @@
-import type { InitOptions, Plan } from "./project.ts";
-/** Dockerfile and compose for `docker`, a GitHub Actions workflow for `ci`. */
-export declare function dockerFiles({ pm, db, docker, ci }: InitOptions): Partial<Plan>;
-//# sourceMappingURL=docker.d.ts.map

package/dist/src/cli/templates/docker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/docker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAgBtD,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB9E"}

package/dist/src/cli/templates/docker.js

@@ -1,102 +0,0 @@
-const INSTALL = {
-    pnpm: {
-        lock: "pnpm-lock.yaml",
-        prod: "pnpm install --prod --frozen-lockfile",
-        ci: "pnpm install --frozen-lockfile",
-    },
-    npm: { lock: "package-lock.json", prod: "npm ci --omit=dev", ci: "npm ci" },
-    yarn: {
-        lock: "yarn.lock",
-        prod: "yarn install --production --frozen-lockfile",
-        ci: "yarn install --frozen-lockfile",
-    },
-};
-/** Dockerfile and compose for `docker`, a GitHub Actions workflow for `ci`. */
-export function dockerFiles({ pm, db, docker, ci }) {
-    const install = INSTALL[pm];
-    const files = {};
-    if (docker) {
-        files["Dockerfile"] = `# Node runs the TypeScript sources directly: no build step.
-FROM node:26-slim
-WORKDIR /app
-ENV NODE_ENV=production
-${pm === "npm" ? "" : "RUN corepack enable\n"}COPY package.json ${install.lock} ./
-RUN ${install.prod}
-COPY tsconfig.json ./
-COPY src ./src
-${db === "sqlite" ? "RUN mkdir -p /app/data && chown node:node /app/data\n" : ""}USER node
-EXPOSE 3000
-HEALTHCHECK --interval=10s --timeout=3s --start-period=10s \\
-  CMD node -e "fetch('http://127.0.0.1:' + (process.env.PORT ?? 3000) + '/health').then((r) => process.exit(r.ok ? 0 : 1), () => process.exit(1))"
-# SIGTERM from \`docker stop\` starts brisk's graceful shutdown.
-CMD ["node", "src/main.ts"]
-`;
-        files[".dockerignore"] = "node_modules\n.env\ncoverage\n.git\n*.db\n*.db-*\n";
-        files["compose.yaml"] = composeTemplate(db);
-    }
-    if (ci)
-        files[".github/workflows/ci.yml"] = ciTemplate(pm, install.ci);
-    return { files };
-}
-function composeTemplate(db) {
-    const app = [
-        "  app:",
-        "    build: .",
-        "    env_file: .env",
-        "    ports:",
-        '      - "3000:3000"',
-        "    stop_grace_period: 30s",
-    ];
-    if (db === "postgres") {
-        app.push("    environment:", "      DATABASE_URL: postgres://app:app@db:5432/app", "    depends_on:", "      db:", "        condition: service_healthy");
-        return `services:
-${app.join("\n")}
-  db:
-    image: postgres:17-alpine
-    environment:
-      POSTGRES_USER: app
-      POSTGRES_PASSWORD: app
-      POSTGRES_DB: app
-    ports:
-      - "5432:5432"
-    volumes:
-      - db:/var/lib/postgresql/data
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U app"]
-      interval: 5s
-      retries: 10
-
-volumes:
-  db:
-`;
-    }
-    if (db === "sqlite") {
-        app.push("    environment:", "      DATABASE_PATH: /app/data/app.db", "    volumes:", "      - data:/app/data");
-        return `services:\n${app.join("\n")}\n\nvolumes:\n  data:\n`;
-    }
-    return `services:\n${app.join("\n")}\n`;
-}
-function ciTemplate(pm, install) {
-    const setup = pm === "pnpm" ? "      - uses: pnpm/action-setup@v4\n" : "";
-    return `name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-
-jobs:
-  check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-${setup}      - uses: actions/setup-node@v4
-        with:
-          node-version: 26
-          cache: ${pm}
-      - run: ${install}
-      - run: ${pm} run typecheck
-      - run: ${pm} test
-`;
-}
-//# sourceMappingURL=docker.js.map

package/dist/src/cli/templates/docker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../../../src/cli/templates/docker.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG;IACd,IAAI,EAAE;QACJ,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,uCAAuC;QAC7C,EAAE,EAAE,gCAAgC;KACrC;IACD,GAAG,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,QAAQ,EAAE;IAC3E,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,6CAA6C;QACnD,EAAE,EAAE,gCAAgC;KACrC;CACO,CAAC;AAEX,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAe;IAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,YAAY,CAAC,GAAG;;;;EAIxB,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,qBAAqB,OAAO,CAAC,IAAI;MACxE,OAAO,CAAC,IAAI;;;EAGhB,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,uDAAuD,CAAC,CAAC,CAAC,EAAE;;;;;;CAM/E,CAAC;QACE,KAAK,CAAC,eAAe,CAAC,GAAG,oDAAoD,CAAC;QAC9E,KAAK,CAAC,cAAc,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,EAAE;QAAE,KAAK,CAAC,0BAA0B,CAAC,GAAG,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACvE,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,EAAqB;IAC5C,MAAM,GAAG,GAAG;QACV,QAAQ;QACR,cAAc;QACd,oBAAoB;QACpB,YAAY;QACZ,qBAAqB;QACrB,4BAA4B;KAC7B,CAAC;IACF,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CACN,kBAAkB,EAClB,oDAAoD,EACpD,iBAAiB,EACjB,WAAW,EACX,oCAAoC,CACrC,CAAC;QACF,OAAO;EACT,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;CAkBf,CAAC;IACA,CAAC;IACD,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CACN,kBAAkB,EAClB,uCAAuC,EACvC,cAAc,EACd,wBAAwB,CACzB,CAAC;QACF,OAAO,cAAc,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC;IAC/D,CAAC;IACD,OAAO,cAAc,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,SAAS,UAAU,CAAC,EAAqB,EAAE,OAAe;IACxD,MAAM,KAAK,GAAG,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,OAAO;;;;;;;;;;;;EAYP,KAAK;;;mBAGY,EAAE;eACN,OAAO;eACP,EAAE;eACF,EAAE;CAChB,CAAC;AACF,CAAC"}

package/dist/src/cli/templates/feature.d.ts

@@ -1,8 +0,0 @@
-import type { Names } from "../names.ts";
-export declare const schemaTemplate: ({ entity }: Names) => string;
-export declare const repositoryTemplate: ({ pascal, entity }: Names) => string;
-export declare const serviceTemplate: ({ kebab, pascal, entity, }: Names) => string;
-export declare const controllerTemplate: ({ kebab, camel, pascal, entity, }: Names) => string;
-export declare const testTemplate: ({ kebab, camel, }: Names) => string;
-export declare const middlewareTemplate: ({ kebab, camel, }: Names) => string;
-//# sourceMappingURL=feature.d.ts.map

package/dist/src/cli/templates/feature.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,eAAO,MAAM,cAAc,eAAgB,KAAK,KAAG,MAkBlD,CAAC;AAEF,eAAO,MAAM,kBAAkB,uBAAwB,KAAK,KAAG,MA0B9D,CAAC;AAEF,eAAO,MAAM,eAAe,+BAIzB,KAAK,KAAG,MA+BV,CAAC;AAEF,eAAO,MAAM,kBAAkB,sCAK5B,KAAK,KAAG,MA6BV,CAAC;AAEF,eAAO,MAAM,YAAY,sBAGtB,KAAK,KAAG,MAuBV,CAAC;AAEF,eAAO,MAAM,kBAAkB,sBAG5B,KAAK,KAAG,MAWV,CAAC"}

package/dist/src/cli/templates/feature.js

@@ -1,145 +0,0 @@
-export const schemaTemplate = ({ entity }) => `import { z } from "@raiyyan/brisk";
-
-export const Create${entity}Body = z.object({
-  name: z.string().trim().min(1),
-});
-
-// Keep .default() out of the create schema: .partial() keeps defaults, and a PATCH would reset omitted fields.
-export const Update${entity}Body = Create${entity}Body.partial();
-
-export const ${entity}IdParams = z.object({ id: z.uuid() });
-
-export const ${entity}Response = z.object({
-  id: z.string(),
-  name: z.string(),
-});
-
-export type Create${entity}Body = z.infer<typeof Create${entity}Body>;
-export type Update${entity}Body = z.infer<typeof Update${entity}Body>;
-`;
-export const repositoryTemplate = ({ pascal, entity }) => `export interface ${entity} {
-  id: string;
-  name: string;
-}
-
-/** In-memory storage. Swap the map for your database; the service does not change. */
-export class ${pascal}Repository {
-  readonly #rows = new Map<string, ${entity}>();
-
-  findAll(): ${entity}[] {
-    return [...this.#rows.values()];
-  }
-
-  findById(id: string): ${entity} | undefined {
-    return this.#rows.get(id);
-  }
-
-  save(row: ${entity}): ${entity} {
-    this.#rows.set(row.id, row);
-    return row;
-  }
-
-  delete(id: string): boolean {
-    return this.#rows.delete(id);
-  }
-}
-`;
-export const serviceTemplate = ({ kebab, pascal, entity, }) => `import { randomUUID } from "node:crypto";
-import { inject, NotFoundError } from "@raiyyan/brisk";
-import { ${pascal}Repository, type ${entity} } from "./${kebab}.repository.ts";
-import type { Create${entity}Body, Update${entity}Body } from "./${kebab}.schema.ts";
-
-export class ${pascal}Service {
-  readonly #repository = inject(${pascal}Repository);
-
-  list(): ${entity}[] {
-    return this.#repository.findAll();
-  }
-
-  get(id: string): ${entity} {
-    const row = this.#repository.findById(id);
-    if (!row) throw new NotFoundError("${entity} not found", { details: { id } });
-    return row;
-  }
-
-  create(input: Create${entity}Body): ${entity} {
-    return this.#repository.save({ id: randomUUID(), ...input });
-  }
-
-  update(id: string, { name }: Update${entity}Body): ${entity} {
-    const row = this.get(id);
-    return this.#repository.save({ ...row, name: name ?? row.name });
-  }
-
-  remove(id: string): void {
-    if (!this.#repository.delete(id)) throw new NotFoundError("${entity} not found", { details: { id } });
-  }
-}
-`;
-export const controllerTemplate = ({ kebab, camel, pascal, entity, }) => `import { defineController, inject } from "@raiyyan/brisk";
-import { Create${entity}Body, ${entity}IdParams, ${entity}Response, Update${entity}Body } from "./${kebab}.schema.ts";
-import { ${pascal}Service } from "./${kebab}.service.ts";
-
-export const ${camel}Controller = defineController({ prefix: "/${kebab}" }, (route) => {
-  const ${camel} = inject(${pascal}Service);
-
-  return {
-    list: route.get("/", { response: ${entity}Response.array() }, () => ${camel}.list()),
-
-    get: route.get("/:id", { params: ${entity}IdParams, response: ${entity}Response }, ({ params }) =>
-      ${camel}.get(params.id),
-    ),
-
-    create: route.post("/", { body: Create${entity}Body, response: ${entity}Response }, ({ body }) =>
-      ${camel}.create(body),
-    ),
-
-    update: route.patch(
-      "/:id",
-      { params: ${entity}IdParams, body: Update${entity}Body, response: ${entity}Response },
-      ({ params, body }) => ${camel}.update(params.id, body),
-    ),
-
-    remove: route.delete("/:id", { params: ${entity}IdParams }, ({ params }) => {
-      ${camel}.remove(params.id);
-    }),
-  };
-});
-`;
-export const testTemplate = ({ kebab, camel, }) => `import { afterAll, describe, expect, it } from "vitest";
-import { createTestClient } from "@raiyyan/brisk/testing";
-import { app } from "../src/app.ts";
-
-const api = await createTestClient(app);
-afterAll(() => api.close());
-
-describe("${kebab}", () => {
-  it("creates, reads, updates and deletes", async () => {
-    const created = await api.call.${camel}.create({ body: { name: "first" } });
-    const { id } = created;
-
-    expect(await api.call.${camel}.get({ params: { id } })).toEqual(created);
-    expect(await api.call.${camel}.update({ params: { id }, body: { name: "second" } })).toEqual({ id, name: "second" });
-    await api.call.${camel}.remove({ params: { id } });
-    await expect(api.call.${camel}.get({ params: { id } })).rejects.toMatchObject({ status: 404 });
-  });
-
-  it("rejects invalid input with field issues", async () => {
-    const res = await api.post("/api/${kebab}", { body: { name: "" } });
-    expect(res.status).toBe(400);
-  });
-});
-`;
-export const middlewareTemplate = ({ kebab, camel, }) => `import { BadRequestError, defineMiddleware } from "@raiyyan/brisk";
-
-/**
- * Reads the \`x-${kebab}\` header and adds \`${camel}\` to the ctx of every route that uses it.
- * Replace the check with your own logic; return nothing for a check-only middleware.
- */
-export const ${camel} = defineMiddleware(({ req }) => {
-  const value = req.get("x-${kebab}");
-  if (!value) throw new BadRequestError("Missing x-${kebab} header", { code: "MISSING_${kebab.toUpperCase().replaceAll("-", "_")}" });
-  return { ${camel}: value };
-}, "${camel}");
-`;
-//# sourceMappingURL=feature.js.map

package/dist/src/cli/templates/feature.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/cli/templates/feature.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAE,MAAM,EAAS,EAAU,EAAE,CAAC;;qBAExC,MAAM;;;;;qBAKN,MAAM,gBAAgB,MAAM;;eAElC,MAAM;;eAEN,MAAM;;;;;oBAKD,MAAM,+BAA+B,MAAM;oBAC3C,MAAM,+BAA+B,MAAM;CAC9D,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAS,EAAU,EAAE,CAAC,oBAAoB,MAAM;;;;;;eAMpF,MAAM;qCACgB,MAAM;;eAE5B,MAAM;;;;0BAIK,MAAM;;;;cAIlB,MAAM,MAAM,MAAM;;;;;;;;;CAS/B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC9B,KAAK,EACL,MAAM,EACN,MAAM,GACA,EAAU,EAAE,CAAC;;WAEV,MAAM,oBAAoB,MAAM,cAAc,KAAK;sBACxC,MAAM,eAAe,MAAM,kBAAkB,KAAK;;eAEzD,MAAM;kCACa,MAAM;;YAE5B,MAAM;;;;qBAIG,MAAM;;yCAEc,MAAM;;;;wBAIvB,MAAM,UAAU,MAAM;;;;uCAIP,MAAM,UAAU,MAAM;;;;;;iEAMI,MAAM;;;CAGtE,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EACjC,KAAK,EACL,KAAK,EACL,MAAM,EACN,MAAM,GACA,EAAU,EAAE,CAAC;iBACJ,MAAM,SAAS,MAAM,aAAa,MAAM,mBAAmB,MAAM,kBAAkB,KAAK;WAC9F,MAAM,qBAAqB,KAAK;;eAE5B,KAAK,6CAA6C,KAAK;UAC5D,KAAK,aAAa,MAAM;;;uCAGK,MAAM,6BAA6B,KAAK;;uCAExC,MAAM,uBAAuB,MAAM;QAClE,KAAK;;;4CAG+B,MAAM,mBAAmB,MAAM;QACnE,KAAK;;;;;kBAKK,MAAM,yBAAyB,MAAM,mBAAmB,MAAM;8BAClD,KAAK;;;6CAGU,MAAM;QAC3C,KAAK;;;;CAIZ,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAC3B,KAAK,EACL,KAAK,GACC,EAAU,EAAE,CAAC;;;;;;;YAOT,KAAK;;qCAEoB,KAAK;;;4BAGd,KAAK;4BACL,KAAK;qBACZ,KAAK;4BACE,KAAK;;;;uCAIM,KAAK;;;;CAI3C,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EACjC,KAAK,EACL,KAAK,GACC,EAAU,EAAE,CAAC;;;mBAGF,KAAK,wBAAwB,KAAK;;;eAGtC,KAAK;6BACS,KAAK;qDACmB,KAAK,8BAA8B,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;aACnH,KAAK;MACZ,KAAK;CACV,CAAC"}

package/dist/src/cli/templates/project.d.ts

@@ -1,24 +0,0 @@
-import type { PackageManager } from "../system.ts";
-export declare const PACKAGE = "@raiyyan/brisk";
-export declare const IMPORTS_MARKER = "// @brisk:imports";
-export declare const CONTROLLERS_MARKER = "// @brisk:controllers";
-export declare const REGISTRY = "src/features/index.ts";
-/** What `brisk init` was asked to set up. */
-export interface InitOptions {
-    db: "none" | "sqlite" | "postgres";
-    auth: boolean;
-    docker: boolean;
-    ci: boolean;
-    web: boolean;
-    pm: PackageManager;
-}
-/** Everything a set of options adds to a project. */
-export interface Plan {
-    files: Record<string, string>;
-    dependencies: string[];
-    devDependencies: string[];
-    scripts: Record<string, string>;
-}
-/** Composes the base project with every chosen option. */
-export declare function projectPlan(options: InitOptions): Plan;
-//# sourceMappingURL=project.d.ts.map

package/dist/src/cli/templates/project.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAKnD,eAAO,MAAM,OAAO,mBAAmB,CAAC;AACxC,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAClD,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAC1D,eAAO,MAAM,QAAQ,0BAA0B,CAAC;AAEhD,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,OAAO,CAAC;IACb,EAAE,EAAE,cAAc,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CA+BtD"}