firebase-contract 0.1.0-rc.6 → 0.1.0-rc.7

package/README.md

@@ -69,6 +69,50 @@ generators:
   (REST path with `{param}` segments dropped).
 - Entries reference declarations by name — nearest first (same yml → root).
 
+#### Output settings: `file`, `split`, `options`, `header`
+
+Every declaration (and any entry-level application) can reshape the output —
+the defaults reproduce each generator's built-in layout, so omitting them
+changes nothing:
+
+```yaml
+generators:
+  - generator: api-dto
+    out: "src/entries/{path}/dto"
+    file: "{api-name}.dto.ts"   # file-name template (default shown)
+    split: true                 # one file per api (api-dto's default)
+  - generator: api-types
+    out: "#contracts/api-types"
+    file: "{api-name}.types.ts" # override the bundled default with per-api files
+    split: true
+    options:
+      typesImport: "../types"   # where `import type { … } from '…'` points
+  - generator: typescript
+    out: "#contracts"
+    file: models.ts             # rename a single-file/barrel output
+    split: true                 # document scope: switches to typescript-split
+```
+
+- **`file`** — output file name. Api scope: a template (`{api-name}`/`{path}`
+  allowed when `split: true`). Document scope: renames the single output file,
+  or the barrel for `-split` variants.
+- **`split`** — api scope: `true` emits one file per api (the `file` template
+  must contain a placeholder), `false` bundles everything into one `file`.
+  Document scope: `true` swaps to the generator's `-split` variant
+  (`typescript` → `typescript-split`, …) and errors when none exists.
+- **`options`** — free-form string map passed through to the generator.
+  Currently: `typesImport` (api-types, task-payloads, data-connect-operations)
+  overrides the `./types` import path.
+- **`header`** — per-generator banner override: `default` for the built-in
+  AUTO-GENERATED banner, any text for a custom comment, `""` to suppress the
+  banner for this generator. Wins over the contract-level `header:` and the
+  CLI `--header` flag.
+- Defaults per generator: `api-types` → `api-types.ts` bundled, `api-validation`
+  → `api-validation.ts` bundled, `task-payloads` → `task-payloads.ts` bundled,
+  `api-dto` → `{api-name}.dto.ts` split.
+- Entry-level settings override the declaration, which overrides the
+  generator's default (same nearest-first rule as `out`).
+
 `fbc generate contract.yml` materializes **all** declared outputs across the
 whole import graph in one run. Passing `-o`/`-g` switches to single-target mode
 (`fbc generate <entry> -o <dir> -g typescript,zod`), and
@@ -360,8 +404,8 @@ apis:                                      # https/callable, keyed by REST path
 Generator application resolves in two tiers — the section `defaults`
 (`apis:/tasks:/events:` → `defaults.generators`) and the entry's own
 `generators:` (which replaces the defaults). `apis:` keys must be REST paths
-(`/...`) with an `operationId`; tasks and Pub/Sub events live in their own
-sections.
+(`/...` or `METHOD /...` so the same route can appear once per verb) with an
+`operationId`; tasks and Pub/Sub events live in their own sections.
 
 For `createCatalog` this yields `CreateCatalogTaskData`, `CreateCatalogTaskPayload =
 RetryTaskPayload<CreateCatalogTaskData>`, and `CREATE_CATALOG_MAX_ATTEMPTS`, plus the
@@ -516,7 +560,7 @@ project:
 | `firestore-split`        | document | `firestore/<collection>.ts` + `firestore.ts` barrel | one file per projection; `_meta_` under `firestore/_/`; DC-schema `.pick()` reuse; `FIRESTORE_DATABASES` constants in the barrel |
 | `api-types`              | api | `api-types.ts`                | endpoint request/response types                        |
 | `api-validation`         | api | `api-validation.ts`           | endpoint request-validation Zod                        |
-| `api-dto`                | api | `api-dtos.ts`                 | class-validator DTO classes                            |
+| `api-dto`                | api | `<operation>.dto.ts` per api  | class-validator DTO classes (NestJS `dto/` convention) |
 | `task-payloads`          | api | `task-payloads.ts`            | envelopes + `*TaskData`/`*TaskPayload` + constants     |
 | `sql-migrations`         | document | `migrations/constraints.sql`  | composite FK / CHECK / index SQL                       |
 | `id-codecs`              | document | `id-codecs.ts` (+ `id-core.ts`) | typed per-entity id encode/decode wrappers; emits the Sqids primitives when `project.idCodec` is set |

package/dist/lib/_internal/compiler/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/compiler/compiler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAChC,OAAO,EAAU,WAAW,EAAqC,MAAM,2BAA2B,CAAA;AAElG,OAAO,EAAkB,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAG3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,EAAE,CAAA;IACN,SAAS,EAAE,WAAW,EAAE,CAAA;IACxB,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,MAAM,EAAE,UAAS,cAAmB,KAAG,aAUzE,CAAA;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,oBAAoB,EAAE,CAAA;IAC/B,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,EAAE,EAAE,OAAO,CAAA;CACZ;AAwJD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,UAAS;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAO,KACjH,iBA0CF,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,aAAa,EAAE,KAAG,SAUlD,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,EAAE,CAAA;IACN,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,oFAAoF;IACpF,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,0DAA0D;IAC1D,EAAE,EAAE,OAAO,CAAA;CACZ;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,MAAM,EAAE,SAAS,eAAe,KAAG,cAuCtE,CAAA"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/compiler/compiler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAChC,OAAO,EAAU,WAAW,EAAqC,MAAM,2BAA2B,CAAA;AAElG,OAAO,EAAkB,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAG3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAI5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,EAAE,CAAA;IACN,SAAS,EAAE,WAAW,EAAE,CAAA;IACxB,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,MAAM,EAAE,UAAS,cAAmB,KAAG,aAUzE,CAAA;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,oBAAoB,EAAE,CAAA;IAC/B,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,EAAE,EAAE,OAAO,CAAA;CACZ;AAmND;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,UAAS;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAO,KACjH,iBAuDF,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,aAAa,EAAE,KAAG,SAUlD,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,EAAE,CAAA;IACN,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,oFAAoF;IACpF,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,0DAA0D;IAC1D,EAAE,EAAE,OAAO,CAAA;CACZ;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,MAAM,EAAE,SAAS,eAAe,KAAG,cAuCtE,CAAA"}

package/dist/lib/_internal/compiler/compiler.js

@@ -7,7 +7,7 @@ import { createFsLoader } from '../resolver/module-loader.js';
 import { validateIr } from '../validation/validate.js';
 import { createDefaultRegistry } from '../generators/index.js';
 import { toHeaderComment } from '../generators/support/header.js';
-import { kebabCase } from '../generators/support/naming.js';
+import { API_PLACEHOLDER_RE, expandApiPlaceholders } from '../generators/support/templates.js';
 /**
  * Run the front end of the pipeline: resolve imports, build the IR, and run
  * semantic validation. Generators are intentionally not involved here — the CLI
@@ -25,7 +25,6 @@ export const compile = (entryPath, options = {}) => {
         diagnostics: [...importDiagnostics, ...buildDiagnostics, ...validationDiagnostics],
     };
 };
-const OUT_PLACEHOLDER_RE = /\{(api-name|path)\}/;
 /** `apis:/tasks:/events:` section a raw api belongs to (drives the section defaults lookup). */
 const sectionOf = (api) => {
     if (api.kind === 'task')
@@ -34,25 +33,16 @@ const sectionOf = (api) => {
         return 'events';
     return 'apis';
 };
-/** Drop `{param}` segments from a REST path and join the rest (`/ai-models/{id}` → `ai-models`). */
-const pathSegments = (apiPath) => apiPath
-    .split('/')
-    .filter(segment => segment.length > 0 && !(segment.startsWith('{') && segment.endsWith('}')))
-    .join('/');
 const expandOutTemplate = (template, api, diagnostics, source) => {
-    if (!OUT_PLACEHOLDER_RE.test(template))
+    if (!API_PLACEHOLDER_RE.test(template))
         return template;
     if (!api) {
         diagnostics.push(error('INVALID_OUT_TEMPLATE', `"${template}" uses api placeholders but the generator is document-scoped (${source})`));
         return undefined;
     }
-    let out = template.replaceAll('{api-name}', kebabCase(api.name));
-    if (out.includes('{path}')) {
-        if (!api.path) {
-            diagnostics.push(error('INVALID_OUT_TEMPLATE', `"${template}" uses {path} but api "${api.name}" has no REST path (${source})`));
-            return undefined;
-        }
-        out = out.replaceAll('{path}', pathSegments(api.path));
+    const out = expandApiPlaceholders(template, api);
+    if (out === undefined) {
+        diagnostics.push(error('INVALID_OUT_TEMPLATE', `"${template}" uses {path} but api "${api.name}" has no REST path (${source})`));
     }
     return out;
 };
@@ -101,6 +91,30 @@ const buildGeneratorJobs = (doc, rootDoc, registry, diagnostics) => {
                 diagnostics.push(error('UNKNOWN_GENERATOR_DECL', `Api "${apiName}" applies generator "${use.generator}" but no declaration with an "out" was found (${doc.filePath})`));
                 continue;
             }
+            // Output settings resolve nearest-first: entry use → declaration → the
+            // generator's built-in default (applied by the generator itself).
+            const generator = registry.get(use.generator);
+            const output = {};
+            const file = use.file ?? decl?.file;
+            const split = use.split ?? decl?.split ?? generator?.defaultOutput?.split;
+            const options = use.options ?? decl?.options;
+            const header = use.header ?? decl?.header;
+            if (file !== undefined)
+                output.file = file;
+            if (split !== undefined)
+                output.split = split;
+            if (options !== undefined)
+                output.options = options;
+            // Split mode needs a per-api file name; bundled mode cannot expand one.
+            const effectiveFile = file ?? generator?.defaultOutput?.file;
+            if (effectiveFile !== undefined && split === false && API_PLACEHOLDER_RE.test(effectiveFile)) {
+                diagnostics.push(error('INVALID_OUT_TEMPLATE', `file "${effectiveFile}" uses api placeholders but split is false for generator "${use.generator}" — set a plain file name (${doc.filePath})`));
+                continue;
+            }
+            if (effectiveFile !== undefined && split === true && !API_PLACEHOLDER_RE.test(effectiveFile)) {
+                diagnostics.push(error('INVALID_OUT_TEMPLATE', `split is true for generator "${use.generator}" but file "${effectiveFile}" has no {api-name}/{path} placeholder, so per-api files would overwrite each other (${doc.filePath})`));
+                continue;
+            }
             const api = { name: apiName, ...(rawApi.path !== undefined ? { path: rawApi.path } : {}) };
             const expanded = expandOutTemplate(template, api, diagnostics, doc.filePath);
             if (expanded === undefined)
@@ -108,13 +122,15 @@ const buildGeneratorJobs = (doc, rootDoc, registry, diagnostics) => {
             const outDir = resolveOutDir(expanded, doc, rootDoc, diagnostics);
             if (outDir === undefined)
                 continue;
-            const key = `${use.generator}\u0000${outDir}`;
+            const key = [use.generator, outDir, file ?? '', String(split ?? ''), JSON.stringify(options ?? null), header ?? '\u0001'].join('\u0000');
             const existing = grouped.get(key);
             if (existing) {
                 existing.apiNames?.push(apiName);
             }
             else {
-                const job = { source: doc.filePath, generatorName: use.generator, outDir, apiNames: [apiName] };
+                const job = { source: doc.filePath, generatorName: use.generator, outDir, apiNames: [apiName], output };
+                if (header !== undefined)
+                    job.header = header;
                 grouped.set(key, job);
                 jobs.push(job);
             }
@@ -128,13 +144,47 @@ const buildGeneratorJobs = (doc, rootDoc, registry, diagnostics) => {
         }
         if ((generator.scope ?? 'document') === 'api')
             continue; // applied via entries, not by declaration
+        // Document-scoped `split` toggles between a generator and its `-split`
+        // variant (e.g. typescript ⇄ typescript-split) instead of reshaping output.
+        let generatorName = decl.generator;
+        if (decl.split === true && !generatorName.endsWith('-split')) {
+            const splitName = `${generatorName}-split`;
+            if (registry.get(splitName)) {
+                generatorName = splitName;
+            }
+            else {
+                diagnostics.push(error('UNSUPPORTED_SPLIT', `Generator "${decl.generator}" has no split variant (${doc.filePath})`));
+                continue;
+            }
+        }
+        else if (decl.split === false && generatorName.endsWith('-split')) {
+            const baseName = generatorName.slice(0, -'-split'.length);
+            if (registry.get(baseName))
+                generatorName = baseName;
+        }
+        const output = {};
+        if (decl.file !== undefined) {
+            if (API_PLACEHOLDER_RE.test(decl.file)) {
+                diagnostics.push(error('INVALID_OUT_TEMPLATE', `file "${decl.file}" uses api placeholders but generator "${decl.generator}" is document-scoped (${doc.filePath})`));
+                continue;
+            }
+            output.file = decl.file;
+        }
+        if (decl.options !== undefined)
+            output.options = decl.options;
         const expanded = expandOutTemplate(decl.out, undefined, diagnostics, doc.filePath);
         if (expanded === undefined)
             continue;
         const outDir = resolveOutDir(expanded, doc, rootDoc, diagnostics);
         if (outDir === undefined)
             continue;
-        jobs.push({ source: doc.filePath, generatorName: decl.generator, outDir });
+        jobs.push({
+            source: doc.filePath,
+            generatorName,
+            outDir,
+            ...(Object.keys(output).length > 0 ? { output } : {}),
+            ...(decl.header !== undefined ? { header: decl.header } : {}),
+        });
     }
     return jobs;
 };
@@ -164,13 +214,19 @@ export const generateAll = (entryPath, options = {}) => {
             }
         }
     };
-    const runTarget = (doc, outDir, generators, apiNames) => {
+    const runTarget = (doc, outDir, generators, apiNames, output, header) => {
         const result = generate(doc.filePath, {
             outDir,
             generators,
             registry,
             write: options.write,
-            context: { ...options.context, ...(apiNames ? { apiNames } : {}) },
+            context: {
+                ...options.context,
+                ...(apiNames ? { apiNames } : {}),
+                ...(output ? { output } : {}),
+                // Per-generator header beats the CLI/contract-level one ('' disables it).
+                ...(header !== undefined ? { header: toHeaderComment(header) } : {}),
+            },
             ...(options.loader ? { loader: options.loader } : {}),
         });
         mergeDiagnostics(result.diagnostics);
@@ -182,7 +238,7 @@ export const generateAll = (entryPath, options = {}) => {
         // Declaration/application DSL (`generators:` + section defaults / entry `generators:`).
         const jobDiagnostics = [];
         for (const job of buildGeneratorJobs(doc, rootDoc, registry, jobDiagnostics)) {
-            runTarget(doc, job.outDir, [job.generatorName], job.apiNames);
+            runTarget(doc, job.outDir, [job.generatorName], job.apiNames, job.output, job.header);
         }
         mergeDiagnostics(jobDiagnostics);
         if (hasErrors(jobDiagnostics))

package/dist/lib/_internal/generators/api/api-dto-generator.d.ts

@@ -1,8 +1,3 @@
 import { Generator } from '../generator.js';
-/**
- * Generates class-validator DTO classes for API endpoint requests, mirroring the
- * hand-written NestJS DTOs (decorators derived from field type +
- * constraints). Complements the Zod request schemas for a NestJS ValidationPipe.
- */
 export declare const createApiDtoGenerator: () => Generator;
 //# sourceMappingURL=api-dto-generator.d.ts.map

package/dist/lib/_internal/generators/api/api-dto-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-dto-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-dto-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AA0GxF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,SAmBvC,CAAA"}
+{"version":3,"file":"api-dto-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-dto-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AAoHxF,eAAO,MAAM,qBAAqB,QAAO,SAuBvC,CAAA"}

package/dist/lib/_internal/generators/api/api-dto-generator.js

@@ -3,6 +3,7 @@ import { pascalCase, singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName } from '../support/relations.js';
 import { selectApis } from '../generator.js';
 import { headerBlocks } from '../support/header.js';
+import { emitApiFiles, resolveOutput } from '../support/templates.js';
 const SCALAR_TS = {
     string: 'string',
     int: 'number',
@@ -126,23 +127,30 @@ const renderDto = (ir, api, used) => {
  * hand-written NestJS DTOs (decorators derived from field type +
  * constraints). Complements the Zod request schemas for a NestJS ValidationPipe.
  */
+// Default mirrors the NestJS convention: one `dto/create-thing.dto.ts` per
+// endpoint next to its controller (the out template decides the directory).
+const DEFAULT_OUTPUT = { file: '{api-name}.dto.ts', split: true };
 export const createApiDtoGenerator = () => ({
     name: 'api-dto',
     scope: 'api',
     description: 'class-validator DTO classes for API requests',
+    defaultOutput: DEFAULT_OUTPUT,
     generate(ir, context) {
-        // DTO は HTTP リクエストボディ用 — task / pubsub のペイロードは task-payloads が担う。
+        // DTOs cover HTTP request bodies — task / pubsub payloads belong to task-payloads.
         const httpApis = selectApis(ir.apis, context).filter(api => api.kind === 'https' || api.kind === 'callable');
-        if (httpApis.length === 0) {
-            return [];
-        }
-        const used = new Set();
-        const dtoBlocks = httpApis.map(api => renderDto(ir, api, used));
-        const blocks = [...headerBlocks(context)];
-        if (used.size > 0) {
-            blocks.push(`import { ${[...used].sort().join(', ')} } from 'class-validator'`);
-        }
-        blocks.push(...dtoBlocks);
-        return [{ path: 'api-dtos.ts', content: `${blocks.join('\n\n')}\n` }];
+        const output = resolveOutput(context, DEFAULT_OUTPUT);
+        return emitApiFiles(httpApis, output, subset => {
+            if (subset.length === 0) {
+                return undefined;
+            }
+            const used = new Set();
+            const dtos = subset.map(api => renderDto(ir, api, used));
+            const blocks = [...headerBlocks(context)];
+            if (used.size > 0) {
+                blocks.push(`import { ${[...used].sort().join(', ')} } from 'class-validator'`);
+            }
+            blocks.push(...dtos);
+            return `${blocks.join('\n\n')}\n`;
+        });
     },
 });

package/dist/lib/_internal/generators/api/api-types-generator.d.ts

@@ -1,8 +1,3 @@
 import { Generator } from '../generator.js';
-/**
- * Generates request/response TypeScript types for each API endpoint. A payload
- * can reference an existing model or declare inline fields; a void response maps
- * to `void`. This mirrors the shared producer/consumer contract pattern.
- */
 export declare const createApiTypesGenerator: () => Generator;
 //# sourceMappingURL=api-types-generator.d.ts.map

package/dist/lib/_internal/generators/api/api-types-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-types-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-types-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AA8ExF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAO,SA0BzC,CAAA"}
+{"version":3,"file":"api-types-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-types-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AAsFxF,eAAO,MAAM,uBAAuB,QAAO,SA+BzC,CAAA"}

package/dist/lib/_internal/generators/api/api-types-generator.js

@@ -2,6 +2,7 @@ import { pascalCase } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
 import { selectApis } from '../generator.js';
 import { headerBlocks } from '../support/header.js';
+import { emitApiFiles, resolveOutput } from '../support/templates.js';
 const SCALAR_TS = {
     string: 'string',
     int: 'number',
@@ -82,28 +83,34 @@ const apiComment = (api) => {
  * can reference an existing model or declare inline fields; a void response maps
  * to `void`. This mirrors the shared producer/consumer contract pattern.
  */
+const DEFAULT_OUTPUT = { file: 'api-types.ts', split: false };
 export const createApiTypesGenerator = () => ({
     name: 'api-types',
     description: 'API request/response TypeScript types',
     scope: 'api',
+    defaultOutput: DEFAULT_OUTPUT,
     generate(ir, context) {
         const apis = selectApis(ir.apis, context);
         if (apis.length === 0) {
             return [];
         }
-        const blocks = [...headerBlocks(context)];
-        const imports = collectImports(ir, apis);
-        if (imports.length > 0) {
-            blocks.push(`import type { ${imports.join(', ')} } from './types'`);
-        }
-        for (const api of apis) {
-            const pascal = pascalCase(api.name);
-            blocks.push([
-                apiComment(api),
-                renderPayloadType(ir, api.request, `${pascal}Request`),
-                renderPayloadType(ir, api.response, `${pascal}Response`),
-            ].join('\n'));
-        }
-        return [{ path: 'api-types.ts', content: `${blocks.join('\n\n')}\n` }];
+        const output = resolveOutput(context, DEFAULT_OUTPUT);
+        const typesImport = output.options['typesImport'] ?? './types';
+        return emitApiFiles(apis, output, subset => {
+            const blocks = [...headerBlocks(context)];
+            const imports = collectImports(ir, subset);
+            if (imports.length > 0) {
+                blocks.push(`import type { ${imports.join(', ')} } from '${typesImport}'`);
+            }
+            for (const api of subset) {
+                const pascal = pascalCase(api.name);
+                blocks.push([
+                    apiComment(api),
+                    renderPayloadType(ir, api.request, `${pascal}Request`),
+                    renderPayloadType(ir, api.response, `${pascal}Response`),
+                ].join('\n'));
+            }
+            return `${blocks.join('\n\n')}\n`;
+        });
     },
 });

package/dist/lib/_internal/generators/api/api-validation-generator.d.ts

@@ -1,7 +1,3 @@
 import { Generator } from '../generator.js';
-/**
- * Generates Zod schemas that validate each endpoint's *request*. Model-backed
- * requests are expanded to the model's fields so the schema is self-contained.
- */
 export declare const createApiValidationGenerator: () => Generator;
 //# sourceMappingURL=api-validation-generator.d.ts.map

package/dist/lib/_internal/generators/api/api-validation-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-validation-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-validation-generator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AAuExF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAO,SAe9C,CAAA"}
+{"version":3,"file":"api-validation-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-validation-generator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AA8ExF,eAAO,MAAM,4BAA4B,QAAO,SAmB9C,CAAA"}

package/dist/lib/_internal/generators/api/api-validation-generator.js

@@ -4,6 +4,7 @@ import { isRelation, relationFkName, relationFkType } from '../support/relations
 import { zodConstraints } from '../support/constraints.js';
 import { selectApis } from '../generator.js';
 import { headerBlocks } from '../support/header.js';
+import { emitApiFiles, resolveOutput } from '../support/templates.js';
 const SCALAR_ZOD = {
     string: 'z.string()',
     int: 'z.number().int()',
@@ -78,19 +79,24 @@ const renderRequestSchema = (ir, api) => {
  * Generates Zod schemas that validate each endpoint's *request*. Model-backed
  * requests are expanded to the model's fields so the schema is self-contained.
  */
+const DEFAULT_OUTPUT = { file: 'api-validation.ts', split: false };
 export const createApiValidationGenerator = () => ({
     name: 'api-validation',
     description: 'API request-validation Zod schemas',
     scope: 'api',
+    defaultOutput: DEFAULT_OUTPUT,
     generate(ir, context) {
         const apis = selectApis(ir.apis, context);
         if (apis.length === 0) {
             return [];
         }
-        const blocks = [...headerBlocks(context), "import { z } from 'zod'"];
-        for (const api of apis) {
-            blocks.push(renderRequestSchema(ir, api));
-        }
-        return [{ path: 'api-validation.ts', content: `${blocks.join('\n\n')}\n` }];
+        const output = resolveOutput(context, DEFAULT_OUTPUT);
+        return emitApiFiles(apis, output, subset => {
+            const blocks = [...headerBlocks(context), "import { z } from 'zod'"];
+            for (const api of subset) {
+                blocks.push(renderRequestSchema(ir, api));
+            }
+            return `${blocks.join('\n\n')}\n`;
+        });
     },
 });

package/dist/lib/_internal/generators/api/task-payload-generator.d.ts

@@ -1,9 +1,3 @@
 import { Generator } from '../generator.js';
-/**
- * Generates Cloud Task / Pub/Sub payload contracts: a generic envelope type per
- * declared envelope (`RetryTaskPayload<T> = T & { … }`), plus per-task
- * `<Name>TaskData` + `<Name>TaskPayload` and delivery constants (max attempts,
- * timeout, topic) — the shared payload contracts an app otherwise hand-writes.
- */
 export declare const createTaskPayloadGenerator: () => Generator;
 //# sourceMappingURL=task-payload-generator.d.ts.map

package/dist/lib/_internal/generators/api/task-payload-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-payload-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/task-payload-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AAyExF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAO,SAsB5C,CAAA"}
+{"version":3,"file":"task-payload-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/task-payload-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AAkFxF,eAAO,MAAM,0BAA0B,QAAO,SAgC5C,CAAA"}

package/dist/lib/_internal/generators/api/task-payload-generator.js

@@ -3,6 +3,7 @@ import { constantCase, pascalCase, singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
 import { selectApis } from '../generator.js';
 import { headerBlocks } from '../support/header.js';
+import { emitApiFiles, resolveOutput } from '../support/templates.js';
 const SCALAR_TS = {
     string: 'string',
     int: 'number',
@@ -75,26 +76,37 @@ const collectImports = (ir, tasks) => {
  * `<Name>TaskData` + `<Name>TaskPayload` and delivery constants (max attempts,
  * timeout, topic) — the shared payload contracts an app otherwise hand-writes.
  */
+const DEFAULT_OUTPUT = { file: 'task-payloads.ts', split: false };
 export const createTaskPayloadGenerator = () => ({
     name: 'task-payloads',
     scope: 'api',
     description: 'Cloud Task/Pub-Sub payload envelopes, data/payload types, and constants',
+    defaultOutput: DEFAULT_OUTPUT,
     generate(ir, context) {
-        const tasks = selectApis(ir.apis, context).filter(isTask);
-        if (ir.envelopes.length === 0 && tasks.length === 0) {
-            return [];
-        }
-        const blocks = [...headerBlocks(context)];
-        const imports = collectImports(ir, tasks);
-        if (imports.length > 0) {
-            blocks.push(`import type { ${imports.join(', ')} } from './types'`);
-        }
-        for (const env of ir.envelopes) {
-            blocks.push(renderEnvelope(env));
-        }
-        for (const api of tasks) {
-            blocks.push(renderTask(ir, api));
-        }
-        return [{ path: 'task-payloads.ts', content: `${blocks.join('\n\n')}\n` }];
+        const output = resolveOutput(context, DEFAULT_OUTPUT);
+        const typesImport = output.options['typesImport'] ?? './types';
+        return emitApiFiles(selectApis(ir.apis, context), output, subset => {
+            const tasks = subset.filter(isTask);
+            // Bundled mode keeps the envelope-only output; split mode inlines only
+            // the envelopes each per-task file actually references.
+            const envelopes = output.split
+                ? ir.envelopes.filter(env => tasks.some(api => api.task?.envelope === env.name))
+                : ir.envelopes;
+            if (envelopes.length === 0 && tasks.length === 0) {
+                return undefined;
+            }
+            const blocks = [...headerBlocks(context)];
+            const imports = collectImports(ir, tasks);
+            if (imports.length > 0) {
+                blocks.push(`import type { ${imports.join(', ')} } from '${typesImport}'`);
+            }
+            for (const env of envelopes) {
+                blocks.push(renderEnvelope(env));
+            }
+            for (const api of tasks) {
+                blocks.push(renderTask(ir, api));
+            }
+            return `${blocks.join('\n\n')}\n`;
+        });
     },
 });

package/dist/lib/_internal/generators/config/config-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/config/config-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAqD5E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAO,SAuBvC,CAAA"}
+{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/config/config-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAsD5E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAO,SAuBvC,CAAA"}

package/dist/lib/_internal/generators/config/config-generator.js

@@ -1,5 +1,6 @@
 import { constantCase, singleQuote } from '../support/naming.js';
 import { headerFor } from '../support/header.js';
+import { outputFile } from '../support/templates.js';
 const DEFAULT_LOCATION = 'asia-northeast1';
 const dataconnectYaml = (service) => {
     const connectorDirs = service.connectors.map(c => `./connectors/${c}`);
@@ -64,7 +65,7 @@ export const createConfigGenerator = () => ({
             }
         }
         if (project.services.length > 0 || project.codebases.length > 0) {
-            files.push({ path: 'constants.ts', content: constantsTs(project, headerFor(context)) });
+            files.push({ path: outputFile(context, 'constants.ts'), content: constantsTs(project, headerFor(context)) });
         }
         return files;
     },

package/dist/lib/_internal/generators/data-connect/adapter-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/data-connect/adapter-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAsI5E;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,QAAO,SAmBnD,CAAA"}
+{"version":3,"file":"adapter-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/data-connect/adapter-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAuI5E;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,QAAO,SAmBnD,CAAA"}

package/dist/lib/_internal/generators/data-connect/adapter-generator.js

@@ -1,6 +1,7 @@
 import { camelCase } from '../support/naming.js';
 import { headerBlocks } from '../support/header.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
+import { outputFile } from '../support/templates.js';
 const SCALAR_TS = {
     string: 'string',
     int: 'number',
@@ -137,6 +138,6 @@ export const createDataConnectAdapterGenerator = () => ({
             blocks.push(renderRowInterface(model, ir));
             blocks.push(renderAdapter(model));
         }
-        return [{ path: 'data-connect-adapters.ts', content: `${blocks.join('\n\n')}\n` }];
+        return [{ path: outputFile(context, 'data-connect-adapters.ts'), content: `${blocks.join('\n\n')}\n` }];
     },
 });

package/dist/lib/_internal/generators/data-connect/graphql-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphql-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/data-connect/graphql-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AA8I5E;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,QAAO,SA+BnD,CAAA;AAaF;;;;;GAKG;AACH,eAAO,MAAM,sCAAsC,QAAO,SAmCxD,CAAA"}
+{"version":3,"file":"graphql-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/data-connect/graphql-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AA+I5E;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,QAAO,SA+BnD,CAAA;AAaF;;;;;GAKG;AACH,eAAO,MAAM,sCAAsC,QAAO,SAmCxD,CAAA"}

package/dist/lib/_internal/generators/data-connect/graphql-generator.js

@@ -1,6 +1,7 @@
 import { headerBlocks } from '../support/header.js';
 import { constantCase, pluralize, snakeCase } from '../support/naming.js';
 import { isRelation } from '../support/relations.js';
+import { outputFile } from '../support/templates.js';
 // Data Connect built-in scalars. `json` and embedded model objects are stored
 // as `Any` — the logical type is preserved in a comment and restored by the
 // Data Connect adapter generator.
@@ -151,7 +152,7 @@ export const createDataConnectGraphqlGenerator = () => ({
             if (model.footer)
                 blocks.push(commentLines(model.footer, '').join('\n'));
         }
-        return [{ path: 'schema.gql', content: `${blocks.join('\n\n')}\n` }];
+        return [{ path: outputFile(context, 'schema.gql'), content: `${blocks.join('\n\n')}\n` }];
     },
 });
 const renderEnumGql = (irEnum, rename) => {

package/dist/lib/_internal/generators/data-connect/operations-generator.js

@@ -487,7 +487,7 @@ export const createDataConnectOperationsGenerator = () => ({
         for (const [connector, entries] of groupByConnector(resolvable)) {
             const dir = connector ? `${connector}/` : '';
             // types.ts lives at the output root; connector files sit one level deeper.
-            const typesImport = connector ? '../types' : './types';
+            const typesImport = context?.output?.options?.['typesImport'] ?? (connector ? '../types' : './types');
             files.push({ path: `${dir}operations.gql`, content: renderGqlFile(ir, entries, context) });
             files.push({ path: `${dir}operations-types.ts`, content: renderTsFile(ir, entries, typesImport, context) });
         }

package/dist/lib/_internal/generators/firestore/firestore-projection-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firestore-projection-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-projection-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAuF5E;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,QAAO,SAgBpD,CAAA"}
+{"version":3,"file":"firestore-projection-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-projection-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAwF5E;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,QAAO,SAgBpD,CAAA"}

package/dist/lib/_internal/generators/firestore/firestore-projection-generator.js

@@ -2,6 +2,7 @@ import { findModel } from '../../ir/ir.js';
 import { singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName } from '../support/relations.js';
 import { headerBlocks } from '../support/header.js';
+import { outputFile } from '../support/templates.js';
 // Firestore stores timestamps as dates and represents relations as resolved
 // (hashids-encoded) string ids, regardless of the Data Connect id's type.
 const SCALAR_ZOD = {
@@ -107,6 +108,6 @@ export const createFirestoreProjectionGenerator = () => ({
         for (const doc of ir.firestore) {
             blocks.push(renderDoc(ir, doc));
         }
-        return [{ path: 'firestore.ts', content: `${blocks.join('\n\n')}\n` }];
+        return [{ path: outputFile(context, 'firestore.ts'), content: `${blocks.join('\n\n')}\n` }];
     },
 });

package/dist/lib/_internal/generators/firestore/firestore-split-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firestore-split-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-split-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAwO5E;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,QAAO,SAqI/C,CAAA"}
+{"version":3,"file":"firestore-split-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-split-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAyO5E;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,QAAO,SAqI/C,CAAA"}

package/dist/lib/_internal/generators/firestore/firestore-split-generator.js

@@ -4,6 +4,7 @@ import { headerBlocks } from '../support/header.js';
 import { camelCase, constantCase, pluralize, singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName } from '../support/relations.js';
 import { collectDeps, kebabCase, tableNameOf } from '../support/split.js';
+import { outputFile } from '../support/templates.js';
 // Projection-level scalars: timestamps become dates, ids/relations become
 // resolved (hashids-encoded) string ids.
 const SCALAR_FS = {
@@ -369,7 +370,7 @@ export const createFirestoreSplitGenerator = () => ({
         if (ir.firestore.some(doc => doc.meta))
             exportLines.push(`export * from './firestore/_'`);
         barrel.push(['// Zod schema / TypeScript 型のエクスポート', ...exportLines].join('\n'));
-        files.push({ path: 'firestore.ts', content: `${barrel.join('\n\n')}\n` });
+        files.push({ path: outputFile(context, 'firestore.ts'), content: `${barrel.join('\n\n')}\n` });
         return files;
     },
 });

package/dist/lib/_internal/generators/firestore/firestore-type-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firestore-type-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-type-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAI5E,MAAM,WAAW,yBAAyB;IACxC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AA0DD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GAAI,UAAS,yBAA8B,KAAG,SAiCtF,CAAA"}
+{"version":3,"file":"firestore-type-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-type-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAK5E,MAAM,WAAW,yBAAyB;IACxC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AA0DD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GAAI,UAAS,yBAA8B,KAAG,SAiCtF,CAAA"}

package/dist/lib/_internal/generators/firestore/firestore-type-generator.js

@@ -1,5 +1,6 @@
 import { headerBlocks } from '../support/header.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
+import { outputFile } from '../support/templates.js';
 const scalarMap = () => ({
     string: 'string',
     int: 'number',
@@ -75,7 +76,7 @@ export const createFirestoreTypeGenerator = (options = {}) => {
                 const fields = model.fields.map(field => renderField(field, scalars, ir)).join('\n');
                 blocks.push(`${doc}export interface ${model.name} {\n${fields}\n}`);
             }
-            return [{ path: 'firestore-types.ts', content: `${blocks.join('\n\n')}\n` }];
+            return [{ path: outputFile(context, 'firestore-types.ts'), content: `${blocks.join('\n\n')}\n` }];
         },
     };
 };

package/dist/lib/_internal/generators/generator.d.ts

@@ -13,6 +13,21 @@ export interface GeneratorContext {
      * entries opt into a generator via section defaults / entry `generators:`.
      */
     apiNames?: string[];
+    /**
+     * Resolved output settings (declaration → entry override → generator
+     * default). Generators fall back to their own `defaultOutput` when absent
+     * (e.g. direct programmatic `generate()` calls).
+     */
+    output?: GeneratorOutputSettings;
+}
+/** How an api-scoped generator materializes files — all declarable in YAML. */
+export interface GeneratorOutputSettings {
+    /** File name template; `{api-name}` / `{path}` allowed when `split` is true. */
+    file?: string;
+    /** true: one file per api. false: one bundled file per job. */
+    split?: boolean;
+    /** Free-form generator-specific tweaks (e.g. api-types `typesImport`). */
+    options?: Record<string, string>;
 }
 /**
  * A code generator turns the IR into one or more output files. Implementations
@@ -30,6 +45,11 @@ export interface Generator {
      * block runs it once for that yml.
      */
     readonly scope?: 'api' | 'document';
+    /** Built-in output defaults (api-scoped generators); overridable per declaration. */
+    readonly defaultOutput?: {
+        file: string;
+        split: boolean;
+    };
     generate(ir: Ir, context?: GeneratorContext): GeneratedFile[];
 }
 /** Narrow `ir.apis` to the compiler-selected subset (no-op without a filter). */

package/dist/lib/_internal/generators/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/generators/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAEhC,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IACnC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAAA;CAC9D;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,gBAAgB,KAAG,CAAC,EAI/F,CAAA"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/generators/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAEhC,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,uBAAuB,CAAA;CACjC;AAED,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IACnC,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;IACzD,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAAA;CAC9D;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,gBAAgB,KAAG,CAAC,EAI/F,CAAA"}

package/dist/lib/_internal/generators/id/id-codec-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id-codec-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/id/id-codec-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAG5E,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA2GD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,UAAS,uBAA4B,KAAG,SA8B9E,CAAA"}
+{"version":3,"file":"id-codec-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/id/id-codec-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAI5E,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA2GD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,UAAS,uBAA4B,KAAG,SA8B9E,CAAA"}

package/dist/lib/_internal/generators/id/id-codec-generator.js

@@ -1,5 +1,6 @@
 import { pascalCase } from '../support/naming.js';
 import { headerBlocks } from '../support/header.js';
+import { outputFile } from '../support/templates.js';
 const idFieldOf = (model) => {
     const ids = model.fields.filter(field => field.isId);
     return ids.length === 1 ? ids[0] : undefined;
@@ -129,7 +130,7 @@ export const createIdCodecGenerator = (options = {}) => {
             for (const { model, field } of entries) {
                 blocks.push(renderCodec(model, field));
             }
-            const files = [{ path: 'id-codecs.ts', content: `${blocks.join('\n\n')}\n` }];
+            const files = [{ path: outputFile(context, 'id-codecs.ts'), content: `${blocks.join('\n\n')}\n` }];
             // Emit the primitives too when the contract pins the Sqids settings.
             if (ir.project?.idCodec && core === './id-core') {
                 files.push({ path: 'id-core.ts', content: idCoreFile(ir.project.idCodec) });

package/dist/lib/_internal/generators/sql/sql-migration-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-migration-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/sql/sql-migration-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AA+B5E;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAO,SAY7C,CAAA"}
+{"version":3,"file":"sql-migration-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/sql/sql-migration-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAgC5E;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAO,SAY7C,CAAA"}

package/dist/lib/_internal/generators/sql/sql-migration-generator.js

@@ -1,5 +1,6 @@
 import { pluralize, snakeCase } from '../support/naming.js';
 import { headerBlocks } from '../support/header.js';
+import { outputFile } from '../support/templates.js';
 const tableName = (model) => model.table ?? pluralize(snakeCase(model.name));
 const renderModelSql = (model) => {
     const sql = model.sql;
@@ -39,6 +40,6 @@ export const createSqlMigrationGenerator = () => ({
         }
         const banner = headerBlocks(context, header => header.replace(/^\/\/ ?/gm, '-- '));
         const content = `${[...banner, blocks.join('\n')].join('\n\n')}\n`;
-        return [{ path: 'migrations/constraints.sql', content }];
+        return [{ path: outputFile(context, 'migrations/constraints.sql'), content }];
     },
 });

package/dist/lib/_internal/generators/support/templates.d.ts

@@ -0,0 +1,36 @@
+/** Shared output-settings resolution + placeholder expansion for generators. Pure functions only. */
+import { GeneratedFile, GeneratorContext } from '../generator.js';
+export declare const API_PLACEHOLDER_RE: RegExp;
+/** Drop `{param}` segments from a REST path and join the rest (`/ai-models/{id}` → `ai-models`). */
+export declare const pathSegments: (apiPath: string) => string;
+/**
+ * Expand `{api-name}` / `{path}` in an output template for one api. Returns
+ * undefined when `{path}` is used but the api has no REST path.
+ */
+export declare const expandApiPlaceholders: (template: string, api: {
+    name: string;
+    path?: string;
+}) => string | undefined;
+/** Output settings after merging the compiler-resolved values over the generator's defaults. */
+export interface ResolvedOutput {
+    file: string;
+    split: boolean;
+    options: Record<string, string>;
+}
+export declare const resolveOutput: (context: GeneratorContext | undefined, defaults: {
+    file: string;
+    split: boolean;
+}) => ResolvedOutput;
+/** `file` override for generators with a single (or barrel) output file. */
+export declare const outputFile: (context: GeneratorContext | undefined, fallback: string) => string;
+/**
+ * Materialize api-scoped output according to the resolved settings: `split`
+ * emits one file per api (expanding `{api-name}`/`{path}` in `file`), otherwise
+ * one bundled file named `file`. `render` returns the full content for the
+ * given api subset, or undefined to emit nothing for it.
+ */
+export declare const emitApiFiles: <A extends {
+    name: string;
+    path?: string;
+}>(apis: A[], output: ResolvedOutput, render: (subset: A[]) => string | undefined) => GeneratedFile[];
+//# sourceMappingURL=templates.d.ts.map

package/dist/lib/_internal/generators/support/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/support/templates.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGjE,eAAO,MAAM,kBAAkB,QAAwB,CAAA;AAEvD,oGAAoG;AACpG,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAIjC,CAAA;AAEd;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,EAAE,KAAK;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,MAAM,GAAG,SAOvG,CAAA;AAED,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,eAAO,MAAM,aAAa,GACxB,SAAS,gBAAgB,GAAG,SAAS,EACrC,UAAU;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,KACzC,cAID,CAAA;AAEF,4EAA4E;AAC5E,eAAO,MAAM,UAAU,GAAI,SAAS,gBAAgB,GAAG,SAAS,EAAE,UAAU,MAAM,KAAG,MAClD,CAAA;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACpE,MAAM,CAAC,EAAE,EACT,QAAQ,cAAc,EACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,MAAM,GAAG,SAAS,KAC1C,aAAa,EAcf,CAAA"}

package/dist/lib/_internal/generators/support/templates.js

@@ -0,0 +1,50 @@
+import { kebabCase } from './naming.js';
+export const API_PLACEHOLDER_RE = /\{(api-name|path)\}/;
+/** Drop `{param}` segments from a REST path and join the rest (`/ai-models/{id}` → `ai-models`). */
+export const pathSegments = (apiPath) => apiPath
+    .split('/')
+    .filter(segment => segment.length > 0 && !(segment.startsWith('{') && segment.endsWith('}')))
+    .join('/');
+/**
+ * Expand `{api-name}` / `{path}` in an output template for one api. Returns
+ * undefined when `{path}` is used but the api has no REST path.
+ */
+export const expandApiPlaceholders = (template, api) => {
+    let out = template.replaceAll('{api-name}', kebabCase(api.name));
+    if (out.includes('{path}')) {
+        if (!api.path)
+            return undefined;
+        out = out.replaceAll('{path}', pathSegments(api.path));
+    }
+    return out;
+};
+export const resolveOutput = (context, defaults) => ({
+    file: context?.output?.file ?? defaults.file,
+    split: context?.output?.split ?? defaults.split,
+    options: context?.output?.options ?? {},
+});
+/** `file` override for generators with a single (or barrel) output file. */
+export const outputFile = (context, fallback) => context?.output?.file ?? fallback;
+/**
+ * Materialize api-scoped output according to the resolved settings: `split`
+ * emits one file per api (expanding `{api-name}`/`{path}` in `file`), otherwise
+ * one bundled file named `file`. `render` returns the full content for the
+ * given api subset, or undefined to emit nothing for it.
+ */
+export const emitApiFiles = (apis, output, render) => {
+    if (!output.split) {
+        const content = render(apis);
+        return content === undefined ? [] : [{ path: output.file, content }];
+    }
+    const files = [];
+    for (const api of apis) {
+        const content = render([api]);
+        if (content === undefined)
+            continue;
+        const path = expandApiPlaceholders(output.file, api);
+        if (path === undefined)
+            continue;
+        files.push({ path, content });
+    }
+    return files;
+};

package/dist/lib/_internal/generators/typescript/typescript-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescript-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/typescript/typescript-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAK5E,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;CAC9B;AA+ED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAS,0BAA+B,KAAG,SAyBpF,CAAA"}
+{"version":3,"file":"typescript-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/typescript/typescript-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAM5E,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;CAC9B;AA+ED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAS,0BAA+B,KAAG,SAyBpF,CAAA"}

package/dist/lib/_internal/generators/typescript/typescript-generator.js

@@ -1,6 +1,7 @@
 import { headerBlocks } from '../support/header.js';
 import { constantCase, singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
+import { outputFile } from '../support/templates.js';
 const SCALAR_TS = {
     string: 'string',
     int: 'number',
@@ -93,7 +94,7 @@ export const createTypeScriptGenerator = (options = {}) => {
                 const fields = model.fields.map(field => renderField(field, ir)).join('\n');
                 blocks.push(`${doc}export interface ${model.name} {\n${fields}\n}`);
             }
-            return [{ path: 'types.ts', content: `${blocks.join('\n\n')}\n` }];
+            return [{ path: outputFile(context, 'types.ts'), content: `${blocks.join('\n\n')}\n` }];
         },
     };
 };

package/dist/lib/_internal/generators/typescript/typescript-split-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescript-split-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/typescript/typescript-split-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AA2F5E;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,QAAO,SA0EhD,CAAA"}
+{"version":3,"file":"typescript-split-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/typescript/typescript-split-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AA4F5E;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,QAAO,SA0EhD,CAAA"}

package/dist/lib/_internal/generators/typescript/typescript-split-generator.js

@@ -3,6 +3,7 @@ import { headerBlocks } from '../support/header.js';
 import { constantCase, singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
 import { assignModuleNames, collectDeps, splitGroups } from '../support/split.js';
+import { outputFile } from '../support/templates.js';
 const SCALAR_TS = {
     string: 'string',
     int: 'number',
@@ -170,7 +171,7 @@ export const createTypeScriptSplitGenerator = () => ({
             emit(moduleName, enums, [...models, table], false);
         }
         const exports = files.map(file => `export * from './${file.path.replace(/^types\//, 'types/').replace(/\.ts$/, '')}'`);
-        files.push({ path: 'types.ts', content: `${[...headerBlocks(context), exports.join('\n')].join('\n\n')}\n` });
+        files.push({ path: outputFile(context, 'types.ts'), content: `${[...headerBlocks(context), exports.join('\n')].join('\n\n')}\n` });
         return files;
     },
 });

package/dist/lib/_internal/generators/union/union-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"union-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/union/union-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAgB5E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,SAkBtC,CAAA"}
+{"version":3,"file":"union-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/union/union-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAiB5E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,SAkBtC,CAAA"}

package/dist/lib/_internal/generators/union/union-generator.js

@@ -1,5 +1,6 @@
 import { singleQuote } from '../support/naming.js';
 import { headerBlocks } from '../support/header.js';
+import { outputFile } from '../support/templates.js';
 const schemaName = (name) => `${name}Schema`;
 const renderUnion = (union) => {
     const variantSchemas = union.variants.map(schemaName).join(', ');
@@ -32,6 +33,6 @@ export const createUnionGenerator = () => ({
         for (const union of ir.unions) {
             blocks.push(renderUnion(union));
         }
-        return [{ path: 'unions.ts', content: `${blocks.join('\n\n')}\n` }];
+        return [{ path: outputFile(context, 'unions.ts'), content: `${blocks.join('\n\n')}\n` }];
     },
 });

package/dist/lib/_internal/generators/zod/zod-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/zod/zod-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAoD5E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAO,SAwBpC,CAAA"}
+{"version":3,"file":"zod-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/zod/zod-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAqD5E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAO,SAwBpC,CAAA"}

package/dist/lib/_internal/generators/zod/zod-generator.js

@@ -2,6 +2,7 @@ import { headerBlocks } from '../support/header.js';
 import { singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
 import { zodConstraints } from '../support/constraints.js';
+import { outputFile } from '../support/templates.js';
 const SCALAR_ZOD = {
     string: 'z.string()',
     int: 'z.number().int()',
@@ -63,6 +64,6 @@ export const createZodGenerator = () => ({
             blocks.push(`export const ${schemaName(model.name)} = z.object({\n${fields}\n})\n` +
                 `export type ${model.name} = z.infer<typeof ${schemaName(model.name)}>`);
         }
-        return [{ path: 'schemas.ts', content: `${blocks.join('\n\n')}\n` }];
+        return [{ path: outputFile(context, 'schemas.ts'), content: `${blocks.join('\n\n')}\n` }];
     },
 });

package/dist/lib/_internal/generators/zod/zod-split-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zod-split-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/zod/zod-split-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAkE5E;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAO,SAmEzC,CAAA"}
+{"version":3,"file":"zod-split-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/zod/zod-split-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAmE5E;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAO,SAmEzC,CAAA"}

package/dist/lib/_internal/generators/zod/zod-split-generator.js

@@ -4,6 +4,7 @@ import { headerBlocks } from '../support/header.js';
 import { singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
 import { assignModuleNames, collectDeps, splitGroups } from '../support/split.js';
+import { outputFile } from '../support/templates.js';
 const SCALAR_ZOD = {
     string: 'z.string()',
     int: 'z.number().int()',
@@ -131,7 +132,7 @@ export const createZodSplitGenerator = () => ({
             emit(moduleName, enums, [...models, table]);
         }
         const exports = files.map(file => `export * from './${file.path.replace(/\.ts$/, '')}'`);
-        files.push({ path: 'schemas.ts', content: `${[...headerBlocks(context), exports.join('\n')].join('\n\n')}\n` });
+        files.push({ path: outputFile(context, 'schemas.ts'), content: `${[...headerBlocks(context), exports.join('\n')].join('\n\n')}\n` });
         return files;
     },
 });

package/dist/lib/_internal/parser/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/parser/parse.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,WAAW,EAaZ,MAAM,mBAAmB,CAAA;AA2hB1B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,UAAU,MAAM,KAAG,WA4MjE,CAAA"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/parser/parse.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,WAAW,EAaZ,MAAM,mBAAmB,CAAA;AA4jB1B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,UAAU,MAAM,KAAG,WAmNjE,CAAA"}

package/dist/lib/_internal/parser/parse.js

@@ -396,15 +396,33 @@ const normalizeApiPayload = (raw, filePath, path) => {
     }
     return payload;
 };
+const normalizeGeneratorOptions = (raw, filePath, path) => {
+    if (!isObject(raw)) {
+        return fail(`"${path}" must be a mapping of string options`, filePath, path);
+    }
+    const options = {};
+    for (const [key, value] of Object.entries(raw)) {
+        options[key] = String(value);
+    }
+    return options;
+};
 const normalizeGeneratorUse = (raw, filePath, path) => {
     if (typeof raw === 'string')
         return { generator: raw };
     if (!isObject(raw) || typeof raw.generator !== 'string') {
-        return fail(`"${path}" must be a generator name or { generator, out? }`, filePath, path);
+        return fail(`"${path}" must be a generator name or { generator, out?, file?, split?, options?, header? }`, filePath, path);
     }
     const use = { generator: raw.generator };
     if (raw.out !== undefined)
         use.out = String(raw.out);
+    if (raw.file !== undefined)
+        use.file = String(raw.file);
+    if (raw.split !== undefined)
+        use.split = Boolean(raw.split);
+    if (raw.options !== undefined)
+        use.options = normalizeGeneratorOptions(raw.options, filePath, `${path}.options`);
+    if (raw.header !== undefined)
+        use.header = String(raw.header);
     return use;
 };
 const normalizeGeneratorUses = (raw, filePath, path) => {
@@ -423,9 +441,15 @@ const normalizeSectionDefaults = (raw, filePath, section) => {
         return [];
     return normalizeGeneratorUses(raw.generators, filePath, `${section}.${SECTION_DEFAULTS_KEY}.generators`);
 };
+/** `METHOD /path` keys let the same route appear once per verb (`PUT /x` + `DELETE /x`). */
+const METHOD_PREFIXED_KEY_RE = /^([A-Z]+) (\/.*)$/;
+/** True when an `apis:` key is a route form this parser accepts (`/path` or `METHOD /path`). */
+const isPathApiKey = (key) => key.startsWith('/') || METHOD_PREFIXED_KEY_RE.test(key);
 /**
- * Path-keyed api entry (`apis:` section, key starts with `/`): kind defaults to
- * `https` (or `callable` when declared), `operationId` names the generated types.
+ * Path-keyed api entry (`apis:` section, key `/path` or `METHOD /path`): kind
+ * defaults to `https` (or `callable` when declared), `operationId` names the
+ * generated types. A method prefix in the key wins over a `method:` field —
+ * declaring both with different values is an error.
  */
 const normalizePathApi = (raw, filePath, pathKey) => {
     if (!isObject(raw)) {
@@ -438,9 +462,19 @@ const normalizePathApi = (raw, filePath, pathKey) => {
     if (kind !== 'https' && kind !== 'callable') {
         return fail(`Api "${pathKey}" kind must be https|callable (tasks/events have their own sections)`, filePath, `apis.${pathKey}.kind`);
     }
-    const api = { kind, path: pathKey };
-    if (raw.method !== undefined)
+    const prefixed = METHOD_PREFIXED_KEY_RE.exec(pathKey);
+    const keyMethod = prefixed?.[1];
+    const routePath = prefixed?.[2] ?? pathKey;
+    const api = { kind, path: routePath };
+    if (keyMethod !== undefined) {
+        if (raw.method !== undefined && String(raw.method) !== keyMethod) {
+            return fail(`Api "${pathKey}" declares method "${String(raw.method)}" but the key says "${keyMethod}"`, filePath, `apis.${pathKey}.method`);
+        }
+        api.method = keyMethod;
+    }
+    else if (raw.method !== undefined) {
         api.method = String(raw.method);
+    }
     if (raw.description !== undefined)
         api.description = String(raw.description);
     api.request = normalizeApiPayload(raw.request, filePath, `apis.${pathKey}.request`);
@@ -711,13 +745,13 @@ export const parseContract = (content, filePath) => {
             if (key === SECTION_DEFAULTS_KEY) {
                 sectionDefaults.apis = normalizeSectionDefaults(raw, filePath, 'apis');
             }
-            else if (key.startsWith('/')) {
-                // Path-keyed REST form: the key is the route, `operationId` names the api.
+            else if (isPathApiKey(key)) {
+                // Path-keyed REST form (`/path` or `METHOD /path`); `operationId` names the api.
                 const { name, api } = normalizePathApi(raw, filePath, key);
                 addApi(name, api, 'apis');
             }
             else {
-                fail(`"apis" keys must be REST paths starting with "/" (tasks/events have their own sections): "${key}"`, filePath, `apis.${key}`);
+                fail(`"apis" keys must be REST paths ("/path" or "METHOD /path"; tasks/events have their own sections): "${key}"`, filePath, `apis.${key}`);
             }
         }
     }
@@ -805,7 +839,17 @@ export const parseContract = (content, filePath) => {
             if (typeof entry.out !== 'string') {
                 return fail(`generators[${i}] needs a string "out"`, filePath, `generators[${i}].out`);
             }
-            return { generator: entry.generator, out: entry.out };
+            const decl = { generator: entry.generator, out: entry.out };
+            if (entry.file !== undefined)
+                decl.file = String(entry.file);
+            if (entry.split !== undefined)
+                decl.split = Boolean(entry.split);
+            if (entry.options !== undefined) {
+                decl.options = normalizeGeneratorOptions(entry.options, filePath, `generators[${i}].options`);
+            }
+            if (entry.header !== undefined)
+                decl.header = String(entry.header);
+            return decl;
         });
     }
     if (Object.keys(sectionDefaults).length > 0) {

package/dist/lib/_internal/parser/raw-document.d.ts

@@ -177,11 +177,23 @@ export interface RawGeneratorDecl {
      * resolved through the root document's `project.aliases`.
      */
     out: string;
+    /** File name template (api-scoped; `{api-name}`/`{path}` allowed with split). */
+    file?: string;
+    /** true: one file per api. false: one bundled file. Default: the generator's own. */
+    split?: boolean;
+    /** Free-form generator-specific tweaks (string values). */
+    options?: Record<string, string>;
+    /** Header override for this generator (`default` = built-in banner, `''` = none). */
+    header?: string;
 }
-/** Generator application on a section default or an entry (name ref + optional out override). */
+/** Generator application on a section default or an entry (name ref + optional overrides). */
 export interface RawGeneratorUse {
     generator: string;
     out?: string;
+    file?: string;
+    split?: boolean;
+    options?: Record<string, string>;
+    header?: string;
 }
 /** Per-section generator defaults (`apis:/tasks:/events:` → `defaults.generators`). */
 export interface RawSectionDefaults {

package/dist/lib/_internal/parser/raw-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"raw-document.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/parser/raw-document.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACxE,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CACnE;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAChC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAA;IACpB,GAAG,CAAC,EAAE,iBAAiB,CAAA;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IACvK,8DAA8D;IAC9D,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IACjI,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACrG,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAC/C,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzC,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACvC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1I;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mGAAmG;IACnG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;CAC/B;AAED,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,iGAAiG;AACjG,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,eAAe,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,2EAA2E;IAC3E,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAA;IACnC,8EAA8E;IAC9E,eAAe,CAAC,EAAE,kBAAkB,CAAA;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACvC"}
+{"version":3,"file":"raw-document.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/parser/raw-document.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-contract",
-  "version": "0.1.0-rc.6",
+  "version": "0.1.0-rc.7",
   "type": "module",
   "bin": {
     "firebase-contract": "./dist/lib/cli/index.js",