@supacloud/compiler 0.54.0 → 0.55.1

package/README.md

@@ -85,6 +85,11 @@ attempts. The default policy requires `requireRouteEffects`,
 
 ## Unified Database Contracts
 
+Database contracts are protocol-aware: configure only the database sources the
+application uses (`postgrestTypes`, `drizzleSchema`, or `graphql`). The generated
+`database.manifest.json` is a TypeBox-validated, fingerprinted build boundary;
+consumers must reject it when its schema or migration fingerprint is stale.
+
 `supacloud-compiler database-contracts database-contracts.json` generates a shared
 type entry point while preserving PostgREST, Drizzle and GraphQL native types:
 

package/dist/cli.js

@@ -2123,6 +2123,9 @@ class ModuleGenerator {
         const idempotency = route.idempotency ?? command?.idempotency ?? featureTransition?.idempotency;
         const responseEntries = normalizedResponseEntries(route.responses);
         const hasResponseMap = responseEntries.length > 0;
+        const handlerParams = route.handlerParams ?? [];
+        const needsContext = handlerParams.some((parameter) => parameter.kind === "context");
+        const direct = factoryOfScope(controller.scope) === "services" && route.command === undefined && route.effect === undefined && (this.module.aspects?.length ?? 0) === 0 && !handlerParams.some((parameter) => parameter.kind === "cookie") && (route.aspects?.length ?? 0) === 0 && !hasResponseMap && route.parse !== "none" && !needsContext && (route.guards?.length ?? 0) === 0 && (route.canMatch?.length ?? 0) === 0 && (route.canDeactivate?.length ?? 0) === 0 && (route.resolvers === undefined || Object.keys(route.resolvers).length === 0) && (route.paramTransforms === undefined || Object.keys(route.paramTransforms).length === 0) && (route.queryTransforms === undefined || Object.keys(route.queryTransforms).length === 0) && (route.paramDefaults === undefined || Object.keys(route.paramDefaults).length === 0) && (route.queryDefaults === undefined || Object.keys(route.queryDefaults).length === 0);
         const fields = [
           `method: ${JSON.stringify(route.method)}`,
           `path: ${JSON.stringify(route.path)}`,
@@ -2192,7 +2195,7 @@ class ModuleGenerator {
           fields.push(`aspects: ${this.renderAspects(route.aspects)}`);
           fields.push(`aspectPipeline: ${this.renderAspectPipeline(route.aspects)}`);
         }
-        const invokerArgs = (route.handlerParams ?? []).map((hp) => {
+        const invokerArgs = handlerParams.map((hp) => {
           if (hp.kind === "param") {
             const accessor = `req.params?.[${JSON.stringify(hp.bindingName ?? hp.name)}]`;
             const fallback = hp.default !== undefined ? JSON.stringify(hp.default) : "undefined";
@@ -2232,7 +2235,17 @@ class ModuleGenerator {
           return "undefined";
         });
         const callArgs = invokerArgs.length > 0 ? invokerArgs.join(", ") : "req";
-        fields.push(`invoker: async (ctrl: unknown, req: { params?: Record<string, unknown>; query?: Record<string, unknown>; body?: unknown; headers?: Record<string, unknown>; cookie?: Record<string, unknown>; context?: unknown }) => { ` + `if (!isRecord(ctrl)) throw new TypeError("Route controller is not an object"); ` + `const handler = ctrl[${JSON.stringify(route.handler)}]; ` + `if (!isFunction(handler)) throw new TypeError("Route handler ${route.handler} is not callable"); ` + `return await Reflect.apply(handler, ctrl, [${callArgs}]); }`);
+        fields.push(`invoker: (ctrl: unknown, req: { params?: Record<string, unknown>; query?: Record<string, unknown>; body?: unknown; headers?: Record<string, unknown>; cookie?: Record<string, unknown>; context?: unknown }) => { ` + `if (!isRecord(ctrl)) throw new TypeError("Route controller is not an object"); ` + `const handler = ctrl[${JSON.stringify(route.handler)}]; ` + `if (!isFunction(handler)) throw new TypeError("Route handler ${route.handler} is not callable"); ` + `return handler.call(ctrl, ${callArgs}); }`);
+        if (direct) {
+          const directArgs = invokerArgs.map((argument) => argument.replaceAll("req.", "context.").replaceAll("req)", "context)"));
+          const directCallArgs = directArgs.length > 0 ? directArgs.join(", ") : "";
+          const directContext = directArgs.length > 0 ? "const context = ctx as { params?: Record<string, unknown>; query?: Record<string, unknown>; body?: unknown; headers?: Record<string, unknown>; cookie?: Record<string, unknown>; context?: unknown }; " : "";
+          fields.push(`directInvoker: (ctrl: unknown, ctx: unknown) => { ` + `if (!isRecord(ctrl)) throw new TypeError("Route controller is not an object"); ` + `const handler = ctrl[${JSON.stringify(route.handler)}]; ` + `if (!isFunction(handler)) throw new TypeError("Route handler ${route.handler} is not callable"); ` + `${directContext}return handler.call(ctrl, ${directCallArgs}); }`);
+          fields.push(`directInvokerFast: (ctrl: Record<string, unknown>, handler: (...args: unknown[]) => unknown, ctx: unknown) => { ` + `${directContext}return handler.call(ctrl, ${directCallArgs}); }`);
+          fields.push('executionMode: "direct"');
+        } else {
+          fields.push('executionMode: "pipeline"');
+        }
         if (route.contract !== undefined) {
           fields.push(`contract: ${JSON.stringify(route.contract)}`);
         }
@@ -4068,7 +4081,7 @@ var HEADER = "// GENERATED BY @supacloud/compiler — do not edit", INTERFACES =
   data?: Record<string, unknown>;
   aspects?: CompiledAspect[];
   aspectPipeline?: CompiledAspectPipeline;
-  invoker?: (
+  invoker: (
     controller: unknown,
     request: {
       params?: Record<string, unknown>;
@@ -4079,6 +4092,9 @@ var HEADER = "// GENERATED BY @supacloud/compiler — do not edit", INTERFACES =
       context?: unknown;
     },
   ) => Promise<unknown> | unknown;
+  directInvoker?: (controller: unknown, context: unknown) => Promise<unknown> | unknown;
+  directInvokerFast?: (controller: Record<string, unknown>, handler: (...args: unknown[]) => unknown, context: unknown) => Promise<unknown> | unknown;
+  executionMode?: "direct" | "pipeline";
 }
 
 export interface CompiledCommand {
@@ -18187,6 +18203,27 @@ var init_release_evidence_cli = __esm(() => {
   init_release_evidence();
 });
 
+// src/database-contract-manifest.ts
+function parseDatabaseContractManifest(value) {
+  if (!Check2(databaseContractManifestSchema, value)) {
+    throw new TypeError("Invalid database contract manifest");
+  }
+  return value;
+}
+var databaseContractManifestSchema;
+var init_database_contract_manifest = __esm(() => {
+  init_build();
+  init_value2();
+  databaseContractManifestSchema = _Object_({
+    version: Literal(1),
+    role: String2({ minLength: 1 }),
+    fingerprint: String2({ pattern: "^[a-f0-9]{64}$" }),
+    inputs: Record(String2({ minLength: 1 }), String2({ pattern: "^[a-f0-9]{64}$" })),
+    migrationOrder: _Array_(String2({ minLength: 1 })),
+    outputs: Record(String2({ minLength: 1 }), String2({ pattern: "^[a-f0-9]{64}$" }))
+  });
+});
+
 // src/database-contracts.ts
 import { createHash as createHash13 } from "node:crypto";
 import { mkdir as mkdir5, readFile as readFile14 } from "node:fs/promises";
@@ -18211,8 +18248,23 @@ function parseDatabaseContractsOptions(value, directory) {
       throw new TypeError(`Missing database contracts ${name}`);
     return result;
   };
-  const graphql = Reflect.get(value, "graphql");
-  assertGraphqlOptions(graphql);
+  const optionalPath = (name) => {
+    if (!Object.hasOwn(value, name))
+      return;
+    return field(name);
+  };
+  const postgrestTypes = optionalPath("postgrestTypes");
+  const drizzleSchema = optionalPath("drizzleSchema");
+  const graphqlPresent = Object.hasOwn(value, "graphql");
+  if (!postgrestTypes && !drizzleSchema && !graphqlPresent) {
+    throw new TypeError("Database contracts require postgrestTypes, drizzleSchema, or graphql");
+  }
+  let graphql;
+  if (graphqlPresent) {
+    const candidate = Reflect.get(value, "graphql");
+    assertGraphqlOptions(candidate);
+    graphql = { ...candidate, schema: resolve25(directory, candidate.schema) };
+  }
   const migrations = Reflect.get(value, "migrations");
   if (!Array.isArray(migrations) || !migrations.every((entry) => typeof entry === "string" && entry.endsWith(".sql"))) {
     throw new TypeError("migrations must be an ordered list of SQL files");
@@ -18220,22 +18272,20 @@ function parseDatabaseContractsOptions(value, directory) {
   return {
     rootDir: resolve25(directory, field("rootDir")),
     outDir: resolve25(directory, field("outDir")),
-    postgrestTypes: resolve25(directory, field("postgrestTypes")),
-    drizzleSchema: resolve25(directory, field("drizzleSchema")),
+    ...postgrestTypes ? { postgrestTypes: resolve25(directory, postgrestTypes) } : {},
+    ...drizzleSchema ? { drizzleSchema: resolve25(directory, drizzleSchema) } : {},
     role: field("role"),
-    graphql: { ...graphql, schema: resolve25(directory, graphql.schema) },
+    ...graphql ? { graphql } : {},
     migrations: migrations.map((file) => resolve25(directory, file))
   };
 }
-async function generateDatabaseContracts(options, check = false) {
-  const rootDir = resolve25(options.rootDir), outDir = resolve25(options.outDir);
-  const postgrestTypes = resolve25(rootDir, options.postgrestTypes), drizzleSchema = resolve25(rootDir, options.drizzleSchema);
-  const snapshot = await readFile14(postgrestTypes, "utf8");
-  const syntax = ts18.createSourceFile(postgrestTypes, snapshot, ts18.ScriptTarget.Latest, true);
+async function assertPostgrestSnapshot(path) {
+  const snapshot = await readFile14(path, "utf8");
+  const syntax = ts18.createSourceFile(path, snapshot, ts18.ScriptTarget.Latest, true);
   const database = syntax.statements.find((node) => (ts18.isTypeAliasDeclaration(node) || ts18.isInterfaceDeclaration(node)) && node.name.text === "Database" && node.modifiers?.some((modifier) => modifier.kind === ts18.SyntaxKind.ExportKeyword));
   if (!database)
     throw new Error("PostgREST snapshot must export Database from the official type generator");
-  const program = ts18.createProgram([postgrestTypes], {
+  const program = ts18.createProgram([path], {
     strict: true,
     noEmit: true,
     skipLibCheck: true,
@@ -18246,11 +18296,17 @@ async function generateDatabaseContracts(options, check = false) {
   });
   if (ts18.getPreEmitDiagnostics(program).length)
     throw new Error("PostgREST snapshot has TypeScript errors");
-  const artifacts = await renderGraphql({
-    rootDir,
-    outDir,
-    graphql: options.graphql
-  });
+}
+async function generateDatabaseContracts(options, check = false) {
+  const rootDir = resolve25(options.rootDir), outDir = resolve25(options.outDir);
+  const postgrestTypes = options.postgrestTypes ? resolve25(rootDir, options.postgrestTypes) : undefined;
+  const drizzleSchema = options.drizzleSchema ? resolve25(rootDir, options.drizzleSchema) : undefined;
+  if (!postgrestTypes && !drizzleSchema && !options.graphql) {
+    throw new TypeError("Database contracts require postgrestTypes, drizzleSchema, or graphql");
+  }
+  if (postgrestTypes)
+    await assertPostgrestSnapshot(postgrestTypes);
+  const artifacts = options.graphql ? await renderGraphql({ rootDir, outDir, graphql: options.graphql }) : { diagnostics: [], files: {} };
   if (artifacts.diagnostics.some((item) => item.severity === "error")) {
     throw new Error(artifacts.diagnostics.map((item) => item.message).join(`
 `));
@@ -18260,38 +18316,42 @@ async function generateDatabaseContracts(options, check = false) {
     const absolute = resolve25(rootDir, path);
     inputs[relative13(rootDir, absolute).replaceAll("\\", "/")] = hash4(await readFile14(absolute, "utf8"));
   };
-  await addInput(postgrestTypes);
-  await addInput(drizzleSchema);
-  const drizzleProgram = ts18.createProgram([drizzleSchema], {
-    noEmit: true,
-    moduleResolution: ts18.ModuleResolutionKind.Bundler,
-    module: ts18.ModuleKind.ESNext,
-    target: ts18.ScriptTarget.ES2022,
-    types: [],
-    skipLibCheck: true
-  });
-  for (const source of drizzleProgram.getSourceFiles()) {
-    if (!source.isDeclarationFile && !source.fileName.includes("/node_modules/"))
-      await addInput(source.fileName);
+  if (postgrestTypes)
+    await addInput(postgrestTypes);
+  if (drizzleSchema) {
+    await addInput(drizzleSchema);
+    const drizzleProgram = ts18.createProgram([drizzleSchema], {
+      noEmit: true,
+      moduleResolution: ts18.ModuleResolutionKind.Bundler,
+      module: ts18.ModuleKind.ESNext,
+      target: ts18.ScriptTarget.ES2022,
+      types: [],
+      skipLibCheck: true
+    });
+    for (const source of drizzleProgram.getSourceFiles()) {
+      if (!source.isDeclarationFile && !source.fileName.includes("/node_modules/"))
+        await addInput(source.fileName);
+    }
   }
-  await addInput(resolve25(rootDir, options.graphql.schema));
+  if (options.graphql)
+    await addInput(resolve25(rootDir, options.graphql.schema));
   if (new Set(options.migrations.map((path) => resolve25(rootDir, path))).size !== options.migrations.length) {
     throw new Error("Duplicate migration in database contracts configuration");
   }
   for (const path of options.migrations)
     await addInput(path);
-  const files = {
-    ...artifacts.files,
-    "database.ts": [
-      "// GENERATED BY @supacloud/compiler database-contracts. Do not edit.",
-      `export type { Database } from ${JSON.stringify(importPath(outDir, postgrestTypes))};`,
-      'export type { QueryData, QueryResult, QueryError } from "@supabase/supabase-js";',
-      `export type DrizzleSchema = typeof import(${JSON.stringify(importPath(outDir, drizzleSchema))});`,
-      'export * from "./graphql";',
-      ""
-    ].join(`
-`)
-  };
+  const barrel = ["// GENERATED BY @supacloud/compiler database-contracts. Do not edit."];
+  if (postgrestTypes) {
+    barrel.push(`export type { Database } from ${JSON.stringify(importPath(outDir, postgrestTypes))};`);
+    barrel.push('export type { QueryData, QueryResult, QueryError } from "@supabase/supabase-js";');
+  }
+  if (drizzleSchema)
+    barrel.push(`export type DrizzleSchema = typeof import(${JSON.stringify(importPath(outDir, drizzleSchema))});`);
+  if (options.graphql)
+    barrel.push('export * from "./graphql";');
+  barrel.push("");
+  const files = { ...artifacts.files, "database.ts": barrel.join(`
+`) };
   const manifest = {
     version: 1,
     role: options.role,
@@ -18299,7 +18359,12 @@ async function generateDatabaseContracts(options, check = false) {
     migrationOrder: options.migrations.map((path) => relative13(rootDir, resolve25(rootDir, path)).replaceAll("\\", "/")),
     outputs: Object.fromEntries(Object.entries(files).sort(([a], [b]) => a.localeCompare(b)).map(([file, text]) => [file, hash4(text)]))
   };
-  files["database.manifest.json"] = JSON.stringify(manifest, null, 2) + `
+  const fingerprint = hash4(JSON.stringify({
+    inputs: manifest.inputs,
+    migrationOrder: manifest.migrationOrder
+  }));
+  const typedManifest = parseDatabaseContractManifest({ ...manifest, fingerprint });
+  files["database.manifest.json"] = JSON.stringify(typedManifest, null, 2) + `
 `;
   const mismatches = [];
   for (const [file, content] of Object.entries(files)) {
@@ -18319,7 +18384,7 @@ async function generateDatabaseContracts(options, check = false) {
     for (const [file, content] of Object.entries(files))
       await writeFileIfChanged(resolve25(outDir, file), content);
   }
-  return { upToDate: mismatches.length === 0, mismatches, written: check ? [] : mismatches, manifest };
+  return { upToDate: mismatches.length === 0, mismatches, written: check ? [] : mismatches, manifest: typedManifest };
 }
 async function runDatabaseContractsFile(path, check = false) {
   const absolute = resolve25(path);
@@ -18330,6 +18395,7 @@ var init_database_contracts = __esm(() => {
   init_graphql();
   init_generate();
   init_graphql_options();
+  init_database_contract_manifest();
 });
 
 // src/graphql-schema.ts
@@ -25818,10 +25884,10 @@ import { readFileSync as readFileSync4 } from "node:fs";
 import { resolve as resolve19 } from "node:path";
 
 // src/migration-app-version.ts
-var MIGRATION_APP_VERSION = "0.36.0";
+var MIGRATION_APP_VERSION = "0.36.1";
 
 // src/migration-elysia-version.ts
-var MIGRATION_ELYSIA_VERSION = "0.38.0";
+var MIGRATION_ELYSIA_VERSION = "0.38.2";
 
 // src/migration-policy.ts
 var cachedCompilerVersion;

package/dist/database-contract-manifest.d.ts

@@ -0,0 +1,9 @@
+export interface DatabaseContractManifest {
+    readonly version: 1;
+    readonly role: string;
+    readonly fingerprint: string;
+    readonly inputs: Readonly<Record<string, string>>;
+    readonly migrationOrder: readonly string[];
+    readonly outputs: Readonly<Record<string, string>>;
+}
+export declare function parseDatabaseContractManifest(value: unknown): DatabaseContractManifest;

package/dist/database-contracts.d.ts

@@ -1,14 +1,16 @@
+import { type DatabaseContractManifest } from "./database-contract-manifest";
 import type { GraphqlOptions } from "./types";
 export interface DatabaseContractsOptions {
     rootDir: string;
     outDir: string;
-    /** Generated by the official Supabase/Postgres Meta exporter, not a handwritten table map. */
-    postgrestTypes: string;
-    /** Source module defining Drizzle tables; imported as types, never executed by this generator. */
-    drizzleSchema: string;
+    /** Official PostgREST snapshot. Omit when the project does not use PostgREST. */
+    postgrestTypes?: string;
+    /** Drizzle query-builder module. Omit when the project does not use Drizzle. */
+    drizzleSchema?: string;
     /** Explicit identity/role label for reviewing snapshot provenance. Not an authorization proof. */
     role: string;
-    graphql: GraphqlOptions;
+    /** Role-scoped pg_graphql snapshot exported by graphql-schema. Omit when GraphQL is unused. */
+    graphql?: GraphqlOptions;
     /** Ordered complete migration history. */
     migrations: readonly string[];
 }
@@ -18,31 +20,11 @@ export declare function generateDatabaseContracts(options: DatabaseContractsOpti
     upToDate: boolean;
     mismatches: string[];
     written: string[];
-    manifest: {
-        version: number;
-        role: string;
-        inputs: {
-            [k: string]: string;
-        };
-        migrationOrder: string[];
-        outputs: {
-            [k: string]: string;
-        };
-    };
+    manifest: DatabaseContractManifest;
 }>;
 export declare function runDatabaseContractsFile(path: string, check?: boolean): Promise<{
     upToDate: boolean;
     mismatches: string[];
     written: string[];
-    manifest: {
-        version: number;
-        role: string;
-        inputs: {
-            [k: string]: string;
-        };
-        migrationOrder: string[];
-        outputs: {
-            [k: string]: string;
-        };
-    };
+    manifest: DatabaseContractManifest;
 }>;

package/dist/index.d.ts

@@ -60,3 +60,5 @@ export type { PullGraphqlSchemaOptions } from "./graphql-schema";
 export { checkGraphqlCompatibility, createRoleSnapshotReport, diffGraphqlSchemas, graphqlFeatureMatrix, introspectionQuery, readGraphqlSchema, schemaFromSource, } from "./graphql-governance";
 export type { GraphqlCompatibilityReport, GraphqlFeatureMatrix, GraphqlGovernanceDiagnostic, GraphqlGovernancePolicy, GraphqlOperationReport, GraphqlRoleSnapshot, GraphqlRoleSnapshotReport, GraphqlSchemaChange, GraphqlSchemaDiff, } from "./graphql-governance";
 export { generateDatabaseContracts, parseDatabaseContractsOptions, runDatabaseContractsFile, type DatabaseContractsOptions } from "./database-contracts";
+export { parseDatabaseContractManifest } from "./database-contract-manifest";
+export type { DatabaseContractManifest } from "./database-contract-manifest";

package/dist/index.js

@@ -2122,6 +2122,9 @@ class ModuleGenerator {
         const idempotency = route.idempotency ?? command?.idempotency ?? featureTransition?.idempotency;
         const responseEntries = normalizedResponseEntries(route.responses);
         const hasResponseMap = responseEntries.length > 0;
+        const handlerParams = route.handlerParams ?? [];
+        const needsContext = handlerParams.some((parameter) => parameter.kind === "context");
+        const direct = factoryOfScope(controller.scope) === "services" && route.command === undefined && route.effect === undefined && (this.module.aspects?.length ?? 0) === 0 && !handlerParams.some((parameter) => parameter.kind === "cookie") && (route.aspects?.length ?? 0) === 0 && !hasResponseMap && route.parse !== "none" && !needsContext && (route.guards?.length ?? 0) === 0 && (route.canMatch?.length ?? 0) === 0 && (route.canDeactivate?.length ?? 0) === 0 && (route.resolvers === undefined || Object.keys(route.resolvers).length === 0) && (route.paramTransforms === undefined || Object.keys(route.paramTransforms).length === 0) && (route.queryTransforms === undefined || Object.keys(route.queryTransforms).length === 0) && (route.paramDefaults === undefined || Object.keys(route.paramDefaults).length === 0) && (route.queryDefaults === undefined || Object.keys(route.queryDefaults).length === 0);
         const fields = [
           `method: ${JSON.stringify(route.method)}`,
           `path: ${JSON.stringify(route.path)}`,
@@ -2191,7 +2194,7 @@ class ModuleGenerator {
           fields.push(`aspects: ${this.renderAspects(route.aspects)}`);
           fields.push(`aspectPipeline: ${this.renderAspectPipeline(route.aspects)}`);
         }
-        const invokerArgs = (route.handlerParams ?? []).map((hp) => {
+        const invokerArgs = handlerParams.map((hp) => {
           if (hp.kind === "param") {
             const accessor = `req.params?.[${JSON.stringify(hp.bindingName ?? hp.name)}]`;
             const fallback = hp.default !== undefined ? JSON.stringify(hp.default) : "undefined";
@@ -2231,7 +2234,17 @@ class ModuleGenerator {
           return "undefined";
         });
         const callArgs = invokerArgs.length > 0 ? invokerArgs.join(", ") : "req";
-        fields.push(`invoker: async (ctrl: unknown, req: { params?: Record<string, unknown>; query?: Record<string, unknown>; body?: unknown; headers?: Record<string, unknown>; cookie?: Record<string, unknown>; context?: unknown }) => { ` + `if (!isRecord(ctrl)) throw new TypeError("Route controller is not an object"); ` + `const handler = ctrl[${JSON.stringify(route.handler)}]; ` + `if (!isFunction(handler)) throw new TypeError("Route handler ${route.handler} is not callable"); ` + `return await Reflect.apply(handler, ctrl, [${callArgs}]); }`);
+        fields.push(`invoker: (ctrl: unknown, req: { params?: Record<string, unknown>; query?: Record<string, unknown>; body?: unknown; headers?: Record<string, unknown>; cookie?: Record<string, unknown>; context?: unknown }) => { ` + `if (!isRecord(ctrl)) throw new TypeError("Route controller is not an object"); ` + `const handler = ctrl[${JSON.stringify(route.handler)}]; ` + `if (!isFunction(handler)) throw new TypeError("Route handler ${route.handler} is not callable"); ` + `return handler.call(ctrl, ${callArgs}); }`);
+        if (direct) {
+          const directArgs = invokerArgs.map((argument) => argument.replaceAll("req.", "context.").replaceAll("req)", "context)"));
+          const directCallArgs = directArgs.length > 0 ? directArgs.join(", ") : "";
+          const directContext = directArgs.length > 0 ? "const context = ctx as { params?: Record<string, unknown>; query?: Record<string, unknown>; body?: unknown; headers?: Record<string, unknown>; cookie?: Record<string, unknown>; context?: unknown }; " : "";
+          fields.push(`directInvoker: (ctrl: unknown, ctx: unknown) => { ` + `if (!isRecord(ctrl)) throw new TypeError("Route controller is not an object"); ` + `const handler = ctrl[${JSON.stringify(route.handler)}]; ` + `if (!isFunction(handler)) throw new TypeError("Route handler ${route.handler} is not callable"); ` + `${directContext}return handler.call(ctrl, ${directCallArgs}); }`);
+          fields.push(`directInvokerFast: (ctrl: Record<string, unknown>, handler: (...args: unknown[]) => unknown, ctx: unknown) => { ` + `${directContext}return handler.call(ctrl, ${directCallArgs}); }`);
+          fields.push('executionMode: "direct"');
+        } else {
+          fields.push('executionMode: "pipeline"');
+        }
         if (route.contract !== undefined) {
           fields.push(`contract: ${JSON.stringify(route.contract)}`);
         }
@@ -4067,7 +4080,7 @@ var HEADER = "// GENERATED BY @supacloud/compiler — do not edit", INTERFACES =
   data?: Record<string, unknown>;
   aspects?: CompiledAspect[];
   aspectPipeline?: CompiledAspectPipeline;
-  invoker?: (
+  invoker: (
     controller: unknown,
     request: {
       params?: Record<string, unknown>;
@@ -4078,6 +4091,9 @@ var HEADER = "// GENERATED BY @supacloud/compiler — do not edit", INTERFACES =
       context?: unknown;
     },
   ) => Promise<unknown> | unknown;
+  directInvoker?: (controller: unknown, context: unknown) => Promise<unknown> | unknown;
+  directInvokerFast?: (controller: Record<string, unknown>, handler: (...args: unknown[]) => unknown, context: unknown) => Promise<unknown> | unknown;
+  executionMode?: "direct" | "pipeline";
 }
 
 export interface CompiledCommand {
@@ -18219,6 +18235,27 @@ var init_graphql_schema = __esm(() => {
   init_graphql_schema_hashes();
 });
 
+// src/database-contract-manifest.ts
+function parseDatabaseContractManifest(value) {
+  if (!Check2(databaseContractManifestSchema, value)) {
+    throw new TypeError("Invalid database contract manifest");
+  }
+  return value;
+}
+var databaseContractManifestSchema;
+var init_database_contract_manifest = __esm(() => {
+  init_build();
+  init_value2();
+  databaseContractManifestSchema = _Object_({
+    version: Literal(1),
+    role: String2({ minLength: 1 }),
+    fingerprint: String2({ pattern: "^[a-f0-9]{64}$" }),
+    inputs: Record(String2({ minLength: 1 }), String2({ pattern: "^[a-f0-9]{64}$" })),
+    migrationOrder: _Array_(String2({ minLength: 1 })),
+    outputs: Record(String2({ minLength: 1 }), String2({ pattern: "^[a-f0-9]{64}$" }))
+  });
+});
+
 // src/database-contracts.ts
 import { createHash as createHash12 } from "node:crypto";
 import { mkdir as mkdir6, readFile as readFile14 } from "node:fs/promises";
@@ -18243,8 +18280,23 @@ function parseDatabaseContractsOptions(value, directory) {
       throw new TypeError(`Missing database contracts ${name}`);
     return result;
   };
-  const graphql = Reflect.get(value, "graphql");
-  assertGraphqlOptions(graphql);
+  const optionalPath = (name) => {
+    if (!Object.hasOwn(value, name))
+      return;
+    return field(name);
+  };
+  const postgrestTypes = optionalPath("postgrestTypes");
+  const drizzleSchema = optionalPath("drizzleSchema");
+  const graphqlPresent = Object.hasOwn(value, "graphql");
+  if (!postgrestTypes && !drizzleSchema && !graphqlPresent) {
+    throw new TypeError("Database contracts require postgrestTypes, drizzleSchema, or graphql");
+  }
+  let graphql;
+  if (graphqlPresent) {
+    const candidate = Reflect.get(value, "graphql");
+    assertGraphqlOptions(candidate);
+    graphql = { ...candidate, schema: resolve24(directory, candidate.schema) };
+  }
   const migrations = Reflect.get(value, "migrations");
   if (!Array.isArray(migrations) || !migrations.every((entry) => typeof entry === "string" && entry.endsWith(".sql"))) {
     throw new TypeError("migrations must be an ordered list of SQL files");
@@ -18252,22 +18304,20 @@ function parseDatabaseContractsOptions(value, directory) {
   return {
     rootDir: resolve24(directory, field("rootDir")),
     outDir: resolve24(directory, field("outDir")),
-    postgrestTypes: resolve24(directory, field("postgrestTypes")),
-    drizzleSchema: resolve24(directory, field("drizzleSchema")),
+    ...postgrestTypes ? { postgrestTypes: resolve24(directory, postgrestTypes) } : {},
+    ...drizzleSchema ? { drizzleSchema: resolve24(directory, drizzleSchema) } : {},
     role: field("role"),
-    graphql: { ...graphql, schema: resolve24(directory, graphql.schema) },
+    ...graphql ? { graphql } : {},
     migrations: migrations.map((file) => resolve24(directory, file))
   };
 }
-async function generateDatabaseContracts(options, check = false) {
-  const rootDir = resolve24(options.rootDir), outDir = resolve24(options.outDir);
-  const postgrestTypes = resolve24(rootDir, options.postgrestTypes), drizzleSchema = resolve24(rootDir, options.drizzleSchema);
-  const snapshot = await readFile14(postgrestTypes, "utf8");
-  const syntax = ts18.createSourceFile(postgrestTypes, snapshot, ts18.ScriptTarget.Latest, true);
+async function assertPostgrestSnapshot(path) {
+  const snapshot = await readFile14(path, "utf8");
+  const syntax = ts18.createSourceFile(path, snapshot, ts18.ScriptTarget.Latest, true);
   const database = syntax.statements.find((node) => (ts18.isTypeAliasDeclaration(node) || ts18.isInterfaceDeclaration(node)) && node.name.text === "Database" && node.modifiers?.some((modifier) => modifier.kind === ts18.SyntaxKind.ExportKeyword));
   if (!database)
     throw new Error("PostgREST snapshot must export Database from the official type generator");
-  const program = ts18.createProgram([postgrestTypes], {
+  const program = ts18.createProgram([path], {
     strict: true,
     noEmit: true,
     skipLibCheck: true,
@@ -18278,11 +18328,17 @@ async function generateDatabaseContracts(options, check = false) {
   });
   if (ts18.getPreEmitDiagnostics(program).length)
     throw new Error("PostgREST snapshot has TypeScript errors");
-  const artifacts = await renderGraphql({
-    rootDir,
-    outDir,
-    graphql: options.graphql
-  });
+}
+async function generateDatabaseContracts(options, check = false) {
+  const rootDir = resolve24(options.rootDir), outDir = resolve24(options.outDir);
+  const postgrestTypes = options.postgrestTypes ? resolve24(rootDir, options.postgrestTypes) : undefined;
+  const drizzleSchema = options.drizzleSchema ? resolve24(rootDir, options.drizzleSchema) : undefined;
+  if (!postgrestTypes && !drizzleSchema && !options.graphql) {
+    throw new TypeError("Database contracts require postgrestTypes, drizzleSchema, or graphql");
+  }
+  if (postgrestTypes)
+    await assertPostgrestSnapshot(postgrestTypes);
+  const artifacts = options.graphql ? await renderGraphql({ rootDir, outDir, graphql: options.graphql }) : { diagnostics: [], files: {} };
   if (artifacts.diagnostics.some((item) => item.severity === "error")) {
     throw new Error(artifacts.diagnostics.map((item) => item.message).join(`
 `));
@@ -18292,38 +18348,42 @@ async function generateDatabaseContracts(options, check = false) {
     const absolute = resolve24(rootDir, path);
     inputs[relative12(rootDir, absolute).replaceAll("\\", "/")] = hash4(await readFile14(absolute, "utf8"));
   };
-  await addInput(postgrestTypes);
-  await addInput(drizzleSchema);
-  const drizzleProgram = ts18.createProgram([drizzleSchema], {
-    noEmit: true,
-    moduleResolution: ts18.ModuleResolutionKind.Bundler,
-    module: ts18.ModuleKind.ESNext,
-    target: ts18.ScriptTarget.ES2022,
-    types: [],
-    skipLibCheck: true
-  });
-  for (const source of drizzleProgram.getSourceFiles()) {
-    if (!source.isDeclarationFile && !source.fileName.includes("/node_modules/"))
-      await addInput(source.fileName);
+  if (postgrestTypes)
+    await addInput(postgrestTypes);
+  if (drizzleSchema) {
+    await addInput(drizzleSchema);
+    const drizzleProgram = ts18.createProgram([drizzleSchema], {
+      noEmit: true,
+      moduleResolution: ts18.ModuleResolutionKind.Bundler,
+      module: ts18.ModuleKind.ESNext,
+      target: ts18.ScriptTarget.ES2022,
+      types: [],
+      skipLibCheck: true
+    });
+    for (const source of drizzleProgram.getSourceFiles()) {
+      if (!source.isDeclarationFile && !source.fileName.includes("/node_modules/"))
+        await addInput(source.fileName);
+    }
   }
-  await addInput(resolve24(rootDir, options.graphql.schema));
+  if (options.graphql)
+    await addInput(resolve24(rootDir, options.graphql.schema));
   if (new Set(options.migrations.map((path) => resolve24(rootDir, path))).size !== options.migrations.length) {
     throw new Error("Duplicate migration in database contracts configuration");
   }
   for (const path of options.migrations)
     await addInput(path);
-  const files = {
-    ...artifacts.files,
-    "database.ts": [
-      "// GENERATED BY @supacloud/compiler database-contracts. Do not edit.",
-      `export type { Database } from ${JSON.stringify(importPath(outDir, postgrestTypes))};`,
-      'export type { QueryData, QueryResult, QueryError } from "@supabase/supabase-js";',
-      `export type DrizzleSchema = typeof import(${JSON.stringify(importPath(outDir, drizzleSchema))});`,
-      'export * from "./graphql";',
-      ""
-    ].join(`
-`)
-  };
+  const barrel = ["// GENERATED BY @supacloud/compiler database-contracts. Do not edit."];
+  if (postgrestTypes) {
+    barrel.push(`export type { Database } from ${JSON.stringify(importPath(outDir, postgrestTypes))};`);
+    barrel.push('export type { QueryData, QueryResult, QueryError } from "@supabase/supabase-js";');
+  }
+  if (drizzleSchema)
+    barrel.push(`export type DrizzleSchema = typeof import(${JSON.stringify(importPath(outDir, drizzleSchema))});`);
+  if (options.graphql)
+    barrel.push('export * from "./graphql";');
+  barrel.push("");
+  const files = { ...artifacts.files, "database.ts": barrel.join(`
+`) };
   const manifest = {
     version: 1,
     role: options.role,
@@ -18331,7 +18391,12 @@ async function generateDatabaseContracts(options, check = false) {
     migrationOrder: options.migrations.map((path) => relative12(rootDir, resolve24(rootDir, path)).replaceAll("\\", "/")),
     outputs: Object.fromEntries(Object.entries(files).sort(([a], [b]) => a.localeCompare(b)).map(([file, text]) => [file, hash4(text)]))
   };
-  files["database.manifest.json"] = JSON.stringify(manifest, null, 2) + `
+  const fingerprint = hash4(JSON.stringify({
+    inputs: manifest.inputs,
+    migrationOrder: manifest.migrationOrder
+  }));
+  const typedManifest = parseDatabaseContractManifest({ ...manifest, fingerprint });
+  files["database.manifest.json"] = JSON.stringify(typedManifest, null, 2) + `
 `;
   const mismatches = [];
   for (const [file, content] of Object.entries(files)) {
@@ -18351,7 +18416,7 @@ async function generateDatabaseContracts(options, check = false) {
     for (const [file, content] of Object.entries(files))
       await writeFileIfChanged(resolve24(outDir, file), content);
   }
-  return { upToDate: mismatches.length === 0, mismatches, written: check ? [] : mismatches, manifest };
+  return { upToDate: mismatches.length === 0, mismatches, written: check ? [] : mismatches, manifest: typedManifest };
 }
 async function runDatabaseContractsFile(path, check = false) {
   const absolute = resolve24(path);
@@ -18362,6 +18427,7 @@ var init_database_contracts = __esm(() => {
   init_graphql();
   init_generate();
   init_graphql_options();
+  init_database_contract_manifest();
 });
 
 // src/analyze.ts
@@ -25070,10 +25136,10 @@ import { readFileSync as readFileSync4 } from "node:fs";
 import { resolve as resolve17 } from "node:path";
 
 // src/migration-app-version.ts
-var MIGRATION_APP_VERSION = "0.36.0";
+var MIGRATION_APP_VERSION = "0.36.1";
 
 // src/migration-elysia-version.ts
-var MIGRATION_ELYSIA_VERSION = "0.38.0";
+var MIGRATION_ELYSIA_VERSION = "0.38.2";
 
 // src/migration-policy.ts
 var cachedCompilerVersion;
@@ -26869,6 +26935,7 @@ function introspectionQuery() {
 
 // src/index.ts
 init_database_contracts();
+init_database_contract_manifest();
 export {
   ANGULAR_ENTERPRISE_RULES,
   APPLICATION_DEVELOPMENT_ARCHIVE_MAX_BYTES2 as APPLICATION_DEVELOPMENT_ARCHIVE_MAX_BYTES,
@@ -26955,6 +27022,7 @@ export {
   migrateProject,
   migrateRouteResponse,
   parseApplicationDevelopmentContext,
+  parseDatabaseContractManifest,
   parseDatabaseContractsOptions,
   parseDeliveryBuildManifest,
   parseDeliveryBuildResult,

package/dist/migration-app-version.d.ts

@@ -1 +1 @@
-export declare const MIGRATION_APP_VERSION = "0.36.0";
+export declare const MIGRATION_APP_VERSION = "0.36.1";

package/dist/migration-elysia-version.d.ts

@@ -1 +1 @@
-export declare const MIGRATION_ELYSIA_VERSION = "0.38.0";
+export declare const MIGRATION_ELYSIA_VERSION = "0.38.2";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.54.0",
+  "version": "0.55.1",
   "description": "Static compiler for @supacloud/app metadata: builds the application graph from AST, validates it, and generates reflection-free factory code",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,7 +57,7 @@
     "directory": "packages/compiler"
   },
   "dependencies": {
-    "@supacloud/db": "0.20.4",
+    "@supacloud/db": "0.20.5",
     "@supacloud/delivery": "0.24.0",
     "typebox": "1.4.3",
     "@graphql-codegen/core": "^6.2.2",