ts-procedures 8.3.0 → 8.4.0

package/build/codegen/model-refs.js

@@ -0,0 +1,49 @@
+/**
+ * Shared-`$id` model referencing via ajsc's `x-named-type` keyword (ajsc ≥7.3.0).
+ *
+ * ajsc inlines plain `$ref`s, so to make a route reference a hoisted model by
+ * name instead of re-inlining its shape, {@link substituteModelRefs} rewrites
+ * each `$id` subschema (BEFORE ajsc runs) into `{ 'x-named-type': '<Name>' }`.
+ * ajsc then emits a bare verbatim reference to `<Name>` (surviving arrays and
+ * both `inlineTypes` modes, never extracted as a sub-type) and reports it via
+ * the converter's `referencedNamedTypes` — which the emitter uses to add the
+ * `import type { … } from './_models'` line.
+ */
+/**
+ * Returns a deep-cloned schema where every object node carrying a `$id` present
+ * in `idToName` is replaced by `{ 'x-named-type': '<Name>' }`. The input is
+ * never mutated.
+ *
+ * - Replaced nodes are NOT recursed into (they're gone).
+ * - A node whose `$id === skipSelfId` is left in place (used when emitting that
+ *   model itself), but its CHILDREN are still recursed so nested OTHER models are
+ *   still referenced.
+ *
+ * @returns the rewritten schema and the set of referenced model names.
+ */
+export function substituteModelRefs(schema, idToName, skipSelfId) {
+    const referenced = new Set();
+    const walk = (node) => {
+        if (Array.isArray(node)) {
+            return node.map((item) => walk(item));
+        }
+        if (!node || typeof node !== 'object')
+            return node;
+        const obj = node;
+        const id = typeof obj.$id === 'string' ? obj.$id : undefined;
+        if (id !== undefined && id !== skipSelfId && idToName.has(id)) {
+            const name = idToName.get(id);
+            referenced.add(name);
+            // Replace entirely — do not recurse into a node that's being swapped out.
+            return { 'x-named-type': name };
+        }
+        // Either no $id, or the self node we're emitting: deep-clone children and recurse.
+        const out = {};
+        for (const [k, v] of Object.entries(obj)) {
+            out[k] = walk(v);
+        }
+        return out;
+    };
+    return { schema: walk(structuredClone(schema)), referenced };
+}
+//# sourceMappingURL=model-refs.js.map

package/build/codegen/model-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-refs.js","sourceRoot":"","sources":["../../src/codegen/model-refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA+B,EAC/B,QAA6B,EAC7B,UAAmB;IAEnB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAA;IAEpC,MAAM,IAAI,GAAG,CAAC,IAAa,EAAW,EAAE;QACtC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACvC,CAAC;QACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QAElD,MAAM,GAAG,GAAG,IAA+B,CAAA;QAC3C,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;QAE5D,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,UAAU,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAE,CAAA;YAC9B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACpB,0EAA0E;YAC1E,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAA;QACjC,CAAC;QAED,mFAAmF;QACnF,MAAM,GAAG,GAA4B,EAAE,CAAA;QACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QAClB,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAA4B,EAAE,UAAU,EAAE,CAAA;AACzF,CAAC"}

package/build/codegen/model-refs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/model-refs.test.js

@@ -0,0 +1,33 @@
+import { describe, it, expect } from 'vitest';
+import { substituteModelRefs } from './model-refs.js';
+const message = { type: 'object', $id: 'urn:msg', title: 'Message', properties: { id: { type: 'string' } } };
+describe('substituteModelRefs', () => {
+    it('replaces an $id subschema with an x-named-type node keyed by model name', () => {
+        const schema = { type: 'object', properties: { author: message, tags: { type: 'array', items: message } } };
+        const idToName = new Map([['urn:msg', 'Message']]);
+        const { schema: out, referenced } = substituteModelRefs(schema, idToName);
+        expect(out.properties.author).toEqual({ 'x-named-type': 'Message' });
+        expect(out.properties.tags.items).toEqual({ 'x-named-type': 'Message' });
+        expect([...referenced]).toEqual(['Message']);
+    });
+    it('does not mutate the input schema', () => {
+        const schema = { type: 'object', properties: { author: message } };
+        const before = JSON.stringify(schema);
+        substituteModelRefs(schema, new Map([['urn:msg', 'Message']]));
+        expect(JSON.stringify(schema)).toBe(before);
+    });
+    it('leaves the schema untouched when no $id is in the registry', () => {
+        const schema = { type: 'object', properties: { author: message } };
+        const { schema: out, referenced } = substituteModelRefs(schema, new Map());
+        expect(out).toEqual(schema);
+        expect(referenced.size).toBe(0);
+    });
+    it('does NOT replace the node when its own $id is the registry root being emitted (optional skipSelfId)', () => {
+        // When emitting the Message model itself, we don't want Message to become a ref to itself.
+        const idToName = new Map([['urn:msg', 'Message']]);
+        const { schema: out } = substituteModelRefs(message, idToName, 'urn:msg');
+        expect(out).not.toHaveProperty('x-named-type');
+        expect(out.$id).toBe('urn:msg');
+    });
+});
+//# sourceMappingURL=model-refs.test.js.map

package/build/codegen/model-refs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-refs.test.js","sourceRoot":"","sources":["../../src/codegen/model-refs.test.ts"],"names":[],"mappings":"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"}

package/build/codegen/pipeline.d.ts

@@ -1,5 +1,6 @@
 import type { DocEnvelope } from '../implementations/types.js';
 import type { AjscOptions } from './emit-types.js';
+import type { SharedTypesImportMap } from './collect-models.js';
 import type { GeneratedFile } from './targets/_shared/write-files.js';
 import type { KotlinEmitter } from './targets/kotlin/ajsc-adapter.js';
 import type { SwiftEmitter } from './targets/swift/ajsc-adapter.js';
@@ -13,6 +14,8 @@ export interface PipelineOptions {
     selfContained?: boolean;
     serviceName?: string;
     cleanOutDir?: boolean;
+    shareModels?: boolean;
+    sharedTypesImport?: SharedTypesImportMap;
     target?: 'ts' | 'kotlin' | 'swift';
     kotlinPackage?: string;
     kotlinSerializer?: 'kotlinx' | 'none';

package/build/codegen/pipeline.js

@@ -13,7 +13,7 @@ import { runTsPipeline } from './targets/ts/run.js';
  * `_shared/write-files.ts`).
  */
 export async function runPipeline(options) {
-    const { envelope, outDir, ajsc: ajscOpts, dryRun = false, namespaceTypes = false, selfContained = false, cleanOutDir = true } = options;
+    const { envelope, outDir, ajsc: ajscOpts, dryRun = false, namespaceTypes = false, selfContained = false, cleanOutDir = true, shareModels = true } = options;
     const serviceName = options.serviceName ?? 'Api';
     validateServiceName(serviceName);
     const clientImportPath = selfContained ? './_types' : options.clientImportPath;
@@ -34,6 +34,8 @@ export async function runPipeline(options) {
         namespaceTypes,
         selfContained,
         cleanOutDir,
+        shareModels,
+        sharedTypesImport: options.sharedTypesImport,
     };
     switch (options.target) {
         case 'kotlin':

package/build/codegen/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/codegen/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA0BnD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAwB;IACxD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,cAAc,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;IACvI,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAA;IAChD,mBAAmB,CAAC,WAAW,CAAC,CAAA;IAEhC,MAAM,gBAAgB,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAA;IAC9E,IAAI,aAAa,IAAI,OAAO,CAAC,gBAAgB,IAAI,IAAI,EAAE,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAA;IACzG,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;IAEvE,MAAM,IAAI,GAAG;QACX,QAAQ;QACR,MAAM;QACN,IAAI;QACJ,MAAM;QACN,WAAW;QACX,IAAI,EAAE,QAAQ;QACd,gBAAgB;QAChB,MAAM;QACN,cAAc;QACd,aAAa;QACb,WAAW;KACZ,CAAA;IAED,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,iBAAiB,CAAC;gBACvB,GAAG,IAAI;gBACP,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC,CAAA;QACJ,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;gBACtB,GAAG,IAAI;gBACP,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAA;QACJ,KAAK,IAAI,CAAC;QACV,KAAK,SAAS,CAAC;QACf;YACE,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;AACH,CAAC"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/codegen/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA4BnD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAwB;IACxD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,cAAc,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;IAC3J,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAA;IAChD,mBAAmB,CAAC,WAAW,CAAC,CAAA;IAEhC,MAAM,gBAAgB,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAA;IAC9E,IAAI,aAAa,IAAI,OAAO,CAAC,gBAAgB,IAAI,IAAI,EAAE,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAA;IACzG,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;IAEvE,MAAM,IAAI,GAAG;QACX,QAAQ;QACR,MAAM;QACN,IAAI;QACJ,MAAM;QACN,WAAW;QACX,IAAI,EAAE,QAAQ;QACd,gBAAgB;QAChB,MAAM;QACN,cAAc;QACd,aAAa;QACb,WAAW;QACX,WAAW;QACX,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC7C,CAAA;IAED,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,iBAAiB,CAAC;gBACvB,GAAG,IAAI;gBACP,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC,CAAA;QACJ,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;gBACtB,GAAG,IAAI;gBACP,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAA;QACJ,KAAK,IAAI,CAAC;QACV,KAAK,SAAS,CAAC;QACf;YACE,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;AACH,CAAC"}

package/build/codegen/schema-walk.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Read-only recursive traversal of a JSON-Schema-shaped value.
+ *
+ * Recurses into arrays and into the values of plain objects, invoking `visit`
+ * on every plain-object node encountered (including the root, if it is one).
+ * Arrays are not passed to `visit` — only object nodes are. The traversal does
+ * not mutate the tree and does not prune: a visited node's children are always
+ * recursed.
+ *
+ * For mutation/substitution semantics (deep-clone, replace-and-prune), see
+ * `substituteModelRefs` in `model-refs.ts`, which keeps its own bespoke walk.
+ */
+export declare function walkSubschemas(node: unknown, visit: (obj: Record<string, unknown>) => void): void;

package/build/codegen/schema-walk.js

@@ -0,0 +1,26 @@
+/**
+ * Read-only recursive traversal of a JSON-Schema-shaped value.
+ *
+ * Recurses into arrays and into the values of plain objects, invoking `visit`
+ * on every plain-object node encountered (including the root, if it is one).
+ * Arrays are not passed to `visit` — only object nodes are. The traversal does
+ * not mutate the tree and does not prune: a visited node's children are always
+ * recursed.
+ *
+ * For mutation/substitution semantics (deep-clone, replace-and-prune), see
+ * `substituteModelRefs` in `model-refs.ts`, which keeps its own bespoke walk.
+ */
+export function walkSubschemas(node, visit) {
+    if (Array.isArray(node)) {
+        for (const item of node)
+            walkSubschemas(item, visit);
+        return;
+    }
+    if (!node || typeof node !== 'object')
+        return;
+    const obj = node;
+    visit(obj);
+    for (const value of Object.values(obj))
+        walkSubschemas(value, visit);
+}
+//# sourceMappingURL=schema-walk.js.map

package/build/codegen/schema-walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-walk.js","sourceRoot":"","sources":["../../src/codegen/schema-walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,KAA6C;IACzF,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,IAAI;YAAE,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACpD,OAAM;IACR,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAM;IAE7C,MAAM,GAAG,GAAG,IAA+B,CAAA;IAC3C,KAAK,CAAC,GAAG,CAAC,CAAA;IACV,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;QAAE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AACtE,CAAC"}

package/build/codegen/schema-walk.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/schema-walk.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest';
+import { walkSubschemas } from './schema-walk.js';
+describe('walkSubschemas', () => {
+    it('visits every plain-object node, including nested and array-nested ones', () => {
+        const tree = {
+            type: 'object',
+            properties: {
+                a: { type: 'string' },
+                b: { type: 'array', items: { type: 'number' } },
+            },
+            anyOf: [{ const: 1 }, { const: 2 }],
+        };
+        const seen = [];
+        walkSubschemas(tree, (obj) => seen.push(obj));
+        // root + properties + a + b + items + 2 anyOf entries = 7 object nodes
+        expect(seen).toHaveLength(7);
+        expect(seen[0]).toBe(tree);
+        expect(seen).toContainEqual({ type: 'number' });
+        expect(seen).toContainEqual({ const: 1 });
+    });
+    it('does not invoke visit on arrays or primitives', () => {
+        const seen = [];
+        walkSubschemas([1, 'two', { x: 1 }], (obj) => seen.push(obj));
+        expect(seen).toEqual([{ x: 1 }]);
+    });
+    it('is a no-op for null, primitives, and bare arrays of primitives', () => {
+        const seen = [];
+        walkSubschemas(null, (obj) => seen.push(obj));
+        walkSubschemas('str', (obj) => seen.push(obj));
+        walkSubschemas(42, (obj) => seen.push(obj));
+        walkSubschemas(['a', 'b'], (obj) => seen.push(obj));
+        expect(seen).toEqual([]);
+    });
+});
+//# sourceMappingURL=schema-walk.test.js.map

package/build/codegen/schema-walk.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-walk.test.js","sourceRoot":"","sources":["../../src/codegen/schema-walk.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;aAChD;YACD,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;SACpC,CAAA;QACD,MAAM,IAAI,GAAmC,EAAE,CAAA;QAC/C,cAAc,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAC7C,uEAAuE;QACvE,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1B,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAmC,EAAE,CAAA;QAC/C,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAC7D,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,IAAI,GAAmC,EAAE,CAAA;QAC/C,cAAc,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAC7C,cAAc,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAC9C,cAAc,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAC3C,cAAc,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/codegen/targets/_shared/target-run.d.ts

@@ -1,6 +1,7 @@
 import type { DocEnvelope } from '../../../implementations/types.js';
 import type { ScopeGroup } from '../../group-routes.js';
 import type { AjscOptions } from '../../emit-types.js';
+import type { SharedTypesImportMap } from '../../collect-models.js';
 /**
  * Inputs the dispatcher prepares once and forwards to every per-target
  * `run*Pipeline` module. Each target module reads only the fields it needs.
@@ -24,4 +25,8 @@ export interface TargetRunInput {
     namespaceTypes?: boolean;
     selfContained?: boolean;
     cleanOutDir?: boolean;
+    /** Hoist `$id`-bearing schemas into a shared `_models.ts` (TS target only). */
+    shareModels?: boolean;
+    /** Maps a model `$id` to an external import (re-exported instead of generated). */
+    sharedTypesImport?: SharedTypesImportMap;
 }

package/build/codegen/targets/ts/run.js

@@ -12,8 +12,11 @@ import { emitIndexFile } from '../../emit-index.js';
 import { emitErrorsFile } from '../../emit-errors.js';
 import { emitClientTypesFile } from '../../emit-client-types.js';
 import { emitClientRuntimeFile } from '../../emit-client-runtime.js';
+import { collectModels, resolveModelImports } from '../../collect-models.js';
+import { emitModelsFile } from '../../emit-models.js';
 export async function runTsPipeline(input) {
-    const { envelope, outDir, hash, groups, serviceName, ajsc: ajscOpts, clientImportPath, dryRun = false, namespaceTypes = false, selfContained = false, cleanOutDir = false, } = input;
+    const { envelope, outDir, hash, groups, serviceName, ajsc: ajscOpts, clientImportPath, dryRun = false, namespaceTypes = false, selfContained = false, cleanOutDir = false, sharedTypesImport, } = input;
+    const shareModels = input.shareModels ?? false;
     const hashComment = `// Source hash: ${hash}`;
     // Error keys that will be emitted in `_errors.ts` — only those with a schema.
     // Scope emit uses this to filter `route.errors` so generated code never
@@ -26,6 +29,21 @@ export async function runTsPipeline(input) {
             }
         }
     }
+    // Shared models: hoist every `$id`-bearing schema into `_models.ts` and pass an
+    // id→name map so scope emission references them instead of inlining. The map
+    // covers ALL models (generated AND externally-imported) since scopes always
+    // import shared types from `./_models`.
+    const models = shareModels
+        ? resolveModelImports(collectModels(envelope.routes), sharedTypesImport)
+        : [];
+    const idToModelName = new Map(models.map((m) => [m.id, m.name]));
+    if (shareModels) {
+        for (const group of groups) {
+            if (group.scopeKey === '_models') {
+                throw new Error(`[ts-procedures-codegen] Scope "_models" conflicts with shared-models reserved filename "_models.ts". Rename the scope to avoid collision.`);
+            }
+        }
+    }
     const files = [];
     for (const group of groups) {
         const rawCode = await emitScopeFile(group, {
@@ -34,12 +52,21 @@ export async function runTsPipeline(input) {
             namespaceTypes,
             serviceName,
             errorKeys: errorKeys.size > 0 ? errorKeys : undefined,
+            idToModelName,
         });
         const lines = rawCode.split('\n');
         lines.splice(1, 0, hashComment);
         const code = lines.join('\n');
         files.push({ path: join(outDir, `${group.scopeKey}.ts`), code });
     }
+    if (models.length > 0) {
+        const modelsCode = await emitModelsFile(models, { ajsc: ajscOpts });
+        if (modelsCode != null) {
+            const ml = modelsCode.split('\n');
+            ml.splice(1, 0, hashComment);
+            files.push({ path: join(outDir, '_models.ts'), code: ml.join('\n') });
+        }
+    }
     const errorsCode = await emitErrorsFile(envelope.errors, {
         ajsc: ajscOpts,
         clientImportPath,

package/build/codegen/targets/ts/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../src/codegen/targets/ts/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../src/codegen/targets/ts/run.ts"],"names":[],"mappings":"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"}

package/build/codegen/targets/ts/shared-models.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/targets/ts/shared-models.test.js

@@ -0,0 +1,258 @@
+import { describe, it, expect } from 'vitest';
+import { runPipeline } from '../../pipeline.js';
+import { makeApiRoute, makeEnvelope } from '../../__fixtures__/make-envelope.js';
+// ---------------------------------------------------------------------------
+// Fixtures
+// ---------------------------------------------------------------------------
+/** A reusable `$id`-bearing schema — appears verbatim in multiple routes/scopes. */
+const messageModel = {
+    $id: 'urn:msg',
+    title: 'Message',
+    type: 'object',
+    properties: {
+        id: { type: 'string' },
+        body: { type: 'string' },
+    },
+    required: ['id', 'body'],
+};
+/**
+ * The same `urn:msg` model appears as a nested property in two scopes
+ * (`messages`, `threads`), and once as the WHOLE response body of a route
+ * (top-level `$id`).
+ */
+function modelEnvelope() {
+    return makeEnvelope([
+        makeApiRoute({
+            name: 'GetMessage',
+            scope: 'messages',
+            fullPath: '/messages/:id',
+            jsonSchema: {
+                req: {
+                    pathParams: {
+                        type: 'object',
+                        properties: { id: { type: 'string' } },
+                        required: ['id'],
+                    },
+                },
+                // Whole response body IS the model (top-level $id) → `Response = Message`.
+                res: { body: { ...messageModel } },
+            },
+        }),
+        makeApiRoute({
+            name: 'ListMessages',
+            scope: 'messages',
+            fullPath: '/messages',
+            jsonSchema: {
+                res: {
+                    body: {
+                        type: 'object',
+                        properties: {
+                            // Model nested inside an array → referenced, not inlined.
+                            items: { type: 'array', items: { ...messageModel } },
+                        },
+                        required: ['items'],
+                    },
+                },
+            },
+        }),
+        makeApiRoute({
+            name: 'GetThread',
+            scope: 'threads',
+            fullPath: '/threads/:id',
+            jsonSchema: {
+                res: {
+                    body: {
+                        type: 'object',
+                        properties: {
+                            // Same model in a SECOND scope.
+                            latest: { ...messageModel },
+                        },
+                        required: ['latest'],
+                    },
+                },
+            },
+        }),
+    ]);
+}
+/** Identical to {@link modelEnvelope} but with every `$id`/`title` stripped. */
+function noModelEnvelope() {
+    return makeEnvelope([
+        makeApiRoute({
+            name: 'GetMessage',
+            scope: 'messages',
+            fullPath: '/messages/:id',
+            jsonSchema: {
+                req: {
+                    pathParams: {
+                        type: 'object',
+                        properties: { id: { type: 'string' } },
+                        required: ['id'],
+                    },
+                },
+                res: {
+                    body: {
+                        type: 'object',
+                        properties: { id: { type: 'string' }, body: { type: 'string' } },
+                        required: ['id', 'body'],
+                    },
+                },
+            },
+        }),
+    ]);
+}
+function findFile(files, suffix) {
+    return files.find((f) => f.path.endsWith(suffix));
+}
+const countMatches = (haystack, re) => (haystack.match(re) ?? []).length;
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('shared models (TS target, ajsc x-named-type)', () => {
+    it('shareModels:true emits _models.ts with exactly one Message type; scopes reference it', async () => {
+        const files = await runPipeline({
+            envelope: modelEnvelope(),
+            outDir: 'out',
+            dryRun: true,
+            shareModels: true,
+            namespaceTypes: true,
+            selfContained: false,
+        });
+        const modelsFile = findFile(files, '_models.ts');
+        expect(modelsFile).toBeDefined();
+        expect(countMatches(modelsFile.code, /export type Message =/g)).toBe(1);
+        // Both scopes that use the model import it and reference Message by name.
+        const messages = findFile(files, 'messages.ts');
+        const threads = findFile(files, 'threads.ts');
+        for (const scope of [messages, threads]) {
+            expect(scope.code).toContain("from './_models'");
+            expect(scope.code).toContain('Message');
+            // No inlined model object literal — the body shape lives only in _models.ts.
+            expect(scope.code).not.toMatch(/body:\s*string;[^}]*}\s*\)/);
+        }
+    });
+    it('a route whose entire response IS the model emits `Response = Message`', async () => {
+        const files = await runPipeline({
+            envelope: modelEnvelope(),
+            outDir: 'out',
+            dryRun: true,
+            shareModels: true,
+            namespaceTypes: true,
+        });
+        const messages = findFile(files, 'messages.ts');
+        // GetMessage's response body IS the whole model (top-level $id) → the Body
+        // alias is exactly `Message`, the single token replacing the whole schema.
+        expect(messages.code).toMatch(/export type Body = Message\b/);
+        // And the nested-array case references the same model inside Array<…>.
+        expect(messages.code).toMatch(/Array<Message>/);
+    });
+    it('shareModels:false emits NO _models.ts and inlines as before', async () => {
+        const files = await runPipeline({
+            envelope: modelEnvelope(),
+            outDir: 'out',
+            dryRun: true,
+            shareModels: false,
+            namespaceTypes: true,
+        });
+        expect(findFile(files, '_models.ts')).toBeUndefined();
+        const messages = findFile(files, 'messages.ts');
+        // The model is inlined: its properties appear in the scope, no _models import.
+        expect(messages.code).not.toContain("from './_models'");
+        expect(messages.code).toContain('body');
+    });
+    it('regression: a no-$id envelope produces byte-identical scope output for true vs false', async () => {
+        const on = await runPipeline({
+            envelope: noModelEnvelope(),
+            outDir: 'out',
+            dryRun: true,
+            shareModels: true,
+            namespaceTypes: true,
+        });
+        const off = await runPipeline({
+            envelope: noModelEnvelope(),
+            outDir: 'out',
+            dryRun: true,
+            shareModels: false,
+            namespaceTypes: true,
+        });
+        // No models exist, so neither run emits _models.ts.
+        expect(findFile(on, '_models.ts')).toBeUndefined();
+        expect(findFile(off, '_models.ts')).toBeUndefined();
+        const onScope = findFile(on, 'messages.ts');
+        const offScope = findFile(off, 'messages.ts');
+        expect(onScope.code).toBe(offScope.code);
+    });
+    it('sharedTypesImport re-exports the model and skips generating its body', async () => {
+        const files = await runPipeline({
+            envelope: modelEnvelope(),
+            outDir: 'out',
+            dryRun: true,
+            shareModels: true,
+            namespaceTypes: true,
+            sharedTypesImport: { 'urn:msg': { module: '@shared/schemas', name: 'Message' } },
+        });
+        const modelsFile = findFile(files, '_models.ts');
+        expect(modelsFile.code).toContain("export { Message } from '@shared/schemas'");
+        // No generated body when the model is externally imported.
+        expect(modelsFile.code).not.toMatch(/export type Message =/);
+        // Scopes still import Message from ./_models (the single hub).
+        const messages = findFile(files, 'messages.ts');
+        expect(messages.code).toContain("from './_models'");
+        expect(messages.code).toContain('Message');
+    });
+    it('flat mode (namespaceTypes:false) imports Message from ./_models', async () => {
+        const files = await runPipeline({
+            envelope: modelEnvelope(),
+            outDir: 'out',
+            dryRun: true,
+            shareModels: true,
+            namespaceTypes: false,
+        });
+        const messages = findFile(files, 'messages.ts');
+        expect(messages.code).toContain("import type { Message } from './_models'");
+    });
+    it('fails loudly when a shared model name collides with a property-derived sub-type', async () => {
+        // `latest` references the Message model; a sibling property literally named
+        // `message` would make ajsc extract a structural sub-type ALSO named
+        // `Message`. ajsc silently merges the two (the model reference resolves to
+        // the unrelated structural type), so codegen must reject this rather than
+        // emit a silently-wrong type. See assertNoModelNameCollision in emit-scope.
+        const collision = makeEnvelope([
+            makeApiRoute({
+                name: 'GetThread',
+                scope: 'chat',
+                fullPath: '/thread',
+                jsonSchema: {
+                    res: {
+                        body: {
+                            type: 'object',
+                            required: ['latest', 'message'],
+                            properties: {
+                                latest: {
+                                    type: 'object',
+                                    $id: 'urn:msg',
+                                    title: 'Message',
+                                    required: ['id'],
+                                    properties: { id: { type: 'string' } },
+                                },
+                                message: {
+                                    type: 'object',
+                                    required: ['unread'],
+                                    properties: { unread: { type: 'boolean' } },
+                                },
+                            },
+                        },
+                    },
+                },
+            }),
+        ]);
+        await expect(runPipeline({
+            envelope: collision,
+            outDir: 'out',
+            dryRun: true,
+            shareModels: true,
+            namespaceTypes: true,
+            selfContained: false,
+        })).rejects.toThrow(/shared model 'Message' collides/);
+    });
+});
+//# sourceMappingURL=shared-models.test.js.map

package/build/codegen/targets/ts/shared-models.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-models.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/ts/shared-models.test.ts"],"names":[],"mappings":"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"}

package/build/doc-envelope.d.ts

@@ -0,0 +1,13 @@
+import type { DocEnvelope } from './implementations/types.js';
+export type DocEnvelopeSource = DocEnvelope | {
+    toDocEnvelope(): DocEnvelope;
+} | {
+    toJSON(): DocEnvelope;
+};
+/**
+ * Serializes a doc envelope to disk as pretty JSON so codegen can run offline
+ * via `--file <path>` without a running server. Accepts a plain `DocEnvelope`,
+ * a builder exposing `toDocEnvelope()`, or a `DocRegistry` exposing `toJSON()`.
+ * Parent directories are created as needed.
+ */
+export declare function writeDocEnvelope(source: DocEnvelopeSource, path: string): Promise<void>;