ts-procedures 8.5.0 → 9.0.0

package/build/adapters/hono/types.d.ts

@@ -0,0 +1,55 @@
+import type { Context, Hono } from 'hono';
+import type { ErrorTaxonomy, UnknownErrorConfig } from '../../server/errors/taxonomy.js';
+import type { OnRequestErrorObserver, OnMidStreamError, PreStreamOnError, PreStreamErrorConfig, MidStreamErrorConfig } from '../../server/errors/dispatch.js';
+import type { QueryParser } from '../../server/request/query.js';
+import type { FactoryContextInit } from '../../server/context.js';
+import type { ProceduresFactory, ExtractContext, StreamMode, AnyHttpRouteDoc, RPCHttpRouteDoc, APIHttpRouteDoc, StreamHttpRouteDoc, HttpStreamRouteDoc } from '../../server/types.js';
+import type { AnyProcedureRegistration, TProcedureRegistration, TStreamProcedureRegistration, THttpProcedureRegistration, THttpStreamProcedureRegistration } from '../../core/types.js';
+export type { QueryParser } from '../../server/request/query.js';
+export type OnRequestErrorContext = {
+    err: unknown;
+    procedure: AnyProcedureRegistration<any, any>;
+    raw: Context;
+};
+export type ExtendProcedureDoc = (params: {
+    base: RPCHttpRouteDoc | APIHttpRouteDoc | StreamHttpRouteDoc | HttpStreamRouteDoc;
+    procedure: AnyProcedureRegistration<any, any>;
+}) => Record<string, unknown>;
+export type HonoFactoryItem<TFactory extends ProceduresFactory = ProceduresFactory> = {
+    factory: TFactory;
+    factoryContext: FactoryContextInit<ExtractContext<TFactory>, Context>;
+    streamMode?: StreamMode;
+    extendProcedureDoc?: ExtendProcedureDoc;
+};
+export type HonoAppBuilderConfig<TStreamErrorData = unknown> = {
+    /** Existing Hono app. If omitted, a new instance is created. */
+    app?: Hono;
+    /** Path prefix applied to every route across all kinds. */
+    pathPrefix?: string;
+    errors?: ErrorTaxonomy;
+    unknownError?: UnknownErrorConfig;
+    onError?: PreStreamOnError<Context, Response>;
+    /** Cross-cutting observer — fires for every caught error before dispatch. */
+    onRequestError?: OnRequestErrorObserver<Context>;
+    onRequestStart?: (c: Context) => void;
+    onRequestEnd?: (c: Context) => void;
+    rpc?: {
+        onSuccess?: (procedure: TProcedureRegistration<any, any>, c: Context) => void;
+    };
+    api?: {
+        queryParser?: QueryParser;
+        onSuccess?: (procedure: THttpProcedureRegistration<any>, c: Context) => void;
+    };
+    stream?: {
+        /** Default for both rpc-stream and http-stream. */
+        defaultStreamMode?: StreamMode;
+        onStreamStart?: (procedure: TStreamProcedureRegistration<any, any> | THttpStreamProcedureRegistration<any>, c: Context, streamMode: StreamMode) => void;
+        onStreamEnd?: (procedure: TStreamProcedureRegistration<any, any> | THttpStreamProcedureRegistration<any>, c: Context, streamMode: StreamMode) => void;
+        onMidStreamError?: OnMidStreamError<TStreamErrorData, Context>;
+    };
+};
+export type DocAccumulator = AnyHttpRouteDoc[];
+/** The pre-stream slice of the builder config, passed to dispatch. */
+export declare function preStreamErrorConfig(cfg: HonoAppBuilderConfig<any>): PreStreamErrorConfig<Context, Response>;
+/** The mid-stream slice of the builder config, passed to dispatch. */
+export declare function midStreamErrorConfig<TStreamErrorData>(cfg: HonoAppBuilderConfig<TStreamErrorData>): MidStreamErrorConfig<TStreamErrorData, Context>;

package/build/adapters/hono/types.js

@@ -0,0 +1,19 @@
+/** The pre-stream slice of the builder config, passed to dispatch. */
+export function preStreamErrorConfig(cfg) {
+    return {
+        errors: cfg.errors,
+        unknownError: cfg.unknownError,
+        onError: cfg.onError,
+        onRequestError: cfg.onRequestError,
+    };
+}
+/** The mid-stream slice of the builder config, passed to dispatch. */
+export function midStreamErrorConfig(cfg) {
+    return {
+        errors: cfg.errors,
+        unknownError: cfg.unknownError,
+        onMidStreamError: cfg.stream?.onMidStreamError,
+        onRequestError: cfg.onRequestError,
+    };
+}
+//# sourceMappingURL=types.js.map

package/build/adapters/hono/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/hono/types.ts"],"names":[],"mappings":"AA6FA,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAClC,GAA8B;IAE9B,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,cAAc,EAAE,GAAG,CAAC,cAAc;KACnC,CAAA;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAClC,GAA2C;IAE3C,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB;QAC9C,cAAc,EAAE,GAAG,CAAC,cAAc;KACnC,CAAA;AACH,CAAC"}

package/build/client/freeze.test.js

@@ -0,0 +1,39 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+/**
+ * The client runtime is CONTENT-FROZEN for v9.
+ *
+ * Self-contained codegen (the default) bundles these source files verbatim
+ * (imports stripped) into the generated `_client.ts` / `_types.ts`. The v9
+ * hard requirement is byte-identical generated output vs v8.6.0, so these
+ * files must not change. If you intentionally change one, you are changing
+ * generated output for every downstream app: re-capture the codegen goldens,
+ * verify the diff is wanted, and update the hash here.
+ *
+ * Hashes recorded from v8.6.0 `src/client/*.ts`.
+ */
+const FROZEN_FILES = [
+    ['errors.ts', 'abcdee64e22e748d870efdac68f03a05cd0666c65ec3f3b5217acd9c22f72a4d'],
+    ['classify-error.ts', '28062fdc3be39461eeec4cc96e3edcf46377922bac6fb3cc7b54111b42199773'],
+    ['error-dispatch.ts', '1bdd89319239e8aca0f186714c15b77ae5f4a9ac2c257416ddaf36d965dbe141'],
+    ['request-builder.ts', 'ac15485e6786de00386e6c4a425dbab503589bc012af6ef6515b1c3e4176a51e'],
+    ['resolve-options.ts', 'a0e6d745a630176696c0221f5166958bfc5255e50168e5f3cf021bbf4a8aaffc'],
+    ['hooks.ts', '15d67ba827dbb6e38407af606c05a459ec27e3b1e738aac868233d0f10478aa7'],
+    ['call.ts', 'b7afeadb3b338cb45ab09273a1729c25ea0f6429670664d197d91ee47cc0a3dc'],
+    ['stream.ts', '655af96f789150e3fedb7b345aae70d58b1d3b3cad9eb8b341d5a4780d5760ce'],
+    ['fetch-adapter.ts', 'c5a6ebdeecac3a5efc3d77f346135609e23c5eebc671a08456175901106655a2'],
+    ['index.ts', '8e33080aba85ba9af52f8b7232c01c82fae167742facb250f5d6800d51544d65'],
+    ['types.ts', 'e236213020290fd187a80cdf060fcb3d67e734e94aa060c736f142cbefd4ced7'],
+];
+const clientDir = dirname(fileURLToPath(import.meta.url));
+describe('client runtime freeze (codegen bundling contract)', () => {
+    it.each(FROZEN_FILES)('%s matches its v8.6.0 content hash', async (file, expected) => {
+        const content = await readFile(resolve(clientDir, file), 'utf-8');
+        const actual = createHash('sha256').update(content).digest('hex');
+        expect(actual, `${file} diverged from the frozen v8.6.0 content — this changes generated _client.ts/_types.ts output`).toBe(expected);
+    });
+});
+//# sourceMappingURL=freeze.test.js.map

package/build/client/freeze.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeze.test.js","sourceRoot":"","sources":["../../src/client/freeze.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C;;;;;;;;;;;GAWG;AACH,MAAM,YAAY,GAA2D;IAC3E,CAAC,WAAW,EAAE,kEAAkE,CAAC;IACjF,CAAC,mBAAmB,EAAE,kEAAkE,CAAC;IACzF,CAAC,mBAAmB,EAAE,kEAAkE,CAAC;IACzF,CAAC,oBAAoB,EAAE,kEAAkE,CAAC;IAC1F,CAAC,oBAAoB,EAAE,kEAAkE,CAAC;IAC1F,CAAC,UAAU,EAAE,kEAAkE,CAAC;IAChF,CAAC,SAAS,EAAE,kEAAkE,CAAC;IAC/E,CAAC,WAAW,EAAE,kEAAkE,CAAC;IACjF,CAAC,kBAAkB,EAAE,kEAAkE,CAAC;IACxF,CAAC,UAAU,EAAE,kEAAkE,CAAC;IAChF,CAAC,UAAU,EAAE,kEAAkE,CAAC;CACjF,CAAA;AAED,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAEzD,QAAQ,CAAC,mDAAmD,EAAE,GAAG,EAAE;IACjE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,oCAAoC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QACnF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;QACjE,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACjE,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,+FAA+F,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACvI,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/client/typed-error-dispatch.test.js

@@ -1,7 +1,7 @@
 import { describe, expect, test } from 'vitest';
 import { Type } from 'typebox';
-import { Procedures } from '../index.js';
-import { HonoAppBuilder, defineErrorTaxonomy } from '../implementations/http/hono/index.js';
+import { Procedures } from '../core/procedures.js';
+import { HonoAppBuilder, defineErrorTaxonomy } from '../adapters/hono/index.js';
 import { createClient } from './index.js';
 import { ClientRequestError } from './errors.js';
 // ---------------------------------------------------------------------------

package/build/client/typed-error-dispatch.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"typed-error-dispatch.test.js","sourceRoot":"","sources":["../../src/client/typed-error-dispatch.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"typed-error-dispatch.test.js","sourceRoot":"","sources":["../../src/client/typed-error-dispatch.test.ts"],"names":[],"mappings":"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"}

package/build/codegen/__fixtures__/make-envelope.d.ts

@@ -1,4 +1,4 @@
-import type { APIHttpRouteDoc, DocEnvelope, ErrorDoc, HeaderDoc, HttpMethod, RPCHttpRouteDoc } from '../../implementations/types.js';
+import type { APIHttpRouteDoc, DocEnvelope, ErrorDoc, HeaderDoc, HttpMethod, RPCHttpRouteDoc } from '../../server/types.js';
 /**
  * Typed builders for codegen test envelopes.
  *

package/build/codegen/bin/cli.d.ts

@@ -62,6 +62,11 @@ export interface ParsedArgs {
  * Throws on parse errors.
  */
 export declare function loadConfigFile(configPath?: string): Promise<CodegenConfig | undefined>;
+/**
+ * The set of flags parseArgs can dispatch — exported so a test can pin it
+ * equal to KNOWN_FLAGS (i.e. FLAG_SPECS), keeping catalog and parser in sync.
+ */
+export declare const PARSE_HANDLED_FLAGS: readonly string[];
 /**
  * Parses CLI argv (pass process.argv.slice(2)).
  * Throws with a descriptive message on validation errors.

package/build/codegen/bin/cli.js

@@ -3,7 +3,7 @@ import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { createHash } from 'node:crypto';
 import { generateClient } from '../index.js';
-import { KNOWN_FLAGS, formatHelp } from './flag-specs.js';
+import { KNOWN_FLAGS, FLAG_SPEC_BY_NAME, formatHelp } from './flag-specs.js';
 // ---------------------------------------------------------------------------
 // Config file loading
 // ---------------------------------------------------------------------------
@@ -87,9 +87,79 @@ function closestKnownFlag(unknown) {
     }
     return best != null && best.distance <= 3 ? best.flag : undefined;
 }
-// ---------------------------------------------------------------------------
-// parseArgs
-// ---------------------------------------------------------------------------
+/** Renders an allowed-values list the way the CLI errors phrase it: `'a' or 'b'` / `'a', 'b', or 'c'`. */
+function humanizeAllowed(allowed) {
+    const quoted = allowed.map((v) => `'${v}'`);
+    if (quoted.length === 2)
+        return `${quoted[0]} or ${quoted[1]}`;
+    return `${quoted.slice(0, -1).join(', ')}, or ${quoted[quoted.length - 1]}`;
+}
+/** Builds a handler for a value flag restricted to a closed set; invalid/missing values throw. */
+function enumValueFlag(flag, allowed, assign) {
+    return (state, value) => {
+        if (value !== undefined && allowed.includes(value)) {
+            assign(state, value);
+        }
+        else {
+            throw new Error(`Invalid ${flag} value: ${value ?? '(missing)'} (expected ${humanizeAllowed(allowed)})`);
+        }
+    };
+}
+/**
+ * Per-flag parse behavior, keyed by flag name. Arity (does the flag consume a
+ * value token?) comes from FLAG_SPECS.takesValue — this table only says what to
+ * do with the flag once recognized. Every key here MUST have a FLAG_SPECS entry
+ * and vice versa; parseArgs refuses to dispatch a flag missing from either
+ * side, and a test pins the two sets equal.
+ */
+const FLAG_HANDLERS = {
+    '--url': (s, v) => { s.url = v; },
+    '--file': (s, v) => { s.file = v; },
+    '--out': (s, v) => { s.outDir = v; },
+    '--watch': (s) => { s.watch = true; },
+    '--interval': (s, v) => { s.interval = parseInt(v ?? '3000', 10); },
+    // Invalid --enum-style values are silently ignored (legacy lenience), unlike
+    // the enumValueFlag flags below which throw.
+    '--enum-style': (s, v) => {
+        if (v === 'union' || v === 'enum') {
+            s.ajsc.enumStyle = v;
+        }
+    },
+    '--depluralize': (s) => { s.ajsc.depluralize = true; },
+    '--array-item-naming': (s, v) => { s.ajsc.arrayItemNaming = v === 'false' ? false : v; },
+    '--uncountable-words': (s, v) => {
+        s.ajsc.uncountableWords = (v ?? '').split(',').map((w) => w.trim()).filter(Boolean);
+    },
+    '--jsdoc': (s) => { s.ajsc.jsdoc = true; },
+    '--no-jsdoc': (s) => { s.ajsc.jsdoc = false; },
+    '--client-import-path': (s, v) => { s.clientImportPath = v; },
+    '--dry-run': (s) => { s.dryRun = true; },
+    '--namespace-types': (s) => { s.namespaceTypes = true; },
+    '--no-namespace-types': (s) => { s.namespaceTypes = false; },
+    '--self-contained': (s) => { s.selfContained = true; },
+    '--no-self-contained': (s) => { s.selfContained = false; },
+    '--service-name': (s, v) => { s.serviceName = v; },
+    '--clean-out-dir': (s) => { s.cleanOutDir = true; },
+    '--no-clean-out-dir': (s) => { s.cleanOutDir = false; },
+    '--target': enumValueFlag('--target', ['ts', 'kotlin', 'swift'], (s, v) => { s.target = v; }),
+    '--kotlin-package': (s, v) => { s.kotlinPackage = v; },
+    '--kotlin-serializer': enumValueFlag('--kotlin-serializer', ['kotlinx', 'none'], (s, v) => { s.kotlinSerializer = v; }),
+    '--swift-serializer': enumValueFlag('--swift-serializer', ['codable', 'none'], (s, v) => { s.swiftSerializer = v; }),
+    '--swift-access-level': enumValueFlag('--swift-access-level', ['public', 'internal'], (s, v) => { s.swiftAccessLevel = v; }),
+    '--unsupported-unions': enumValueFlag('--unsupported-unions', ['throw', 'fallback'], (s, v) => { s.unsupportedUnions = v; }),
+    '--share-models': (s) => { s.shareModels = true; },
+    '--no-share-models': (s) => { s.shareModels = false; },
+    '--shared-models-module': (s, v) => { s.sharedModelsModule = v; },
+    '--strict-shared-models': (s) => { s.strictSharedModels = true; },
+    // configPath is consumed by the caller (main) before parseArgs is called with the loaded config.
+    // When called from main, config is already loaded. When called directly (tests), configPath is ignored.
+    '--config': (s, v) => { s.configPath = v; },
+};
+/**
+ * The set of flags parseArgs can dispatch — exported so a test can pin it
+ * equal to KNOWN_FLAGS (i.e. FLAG_SPECS), keeping catalog and parser in sync.
+ */
+export const PARSE_HANDLED_FLAGS = Object.keys(FLAG_HANDLERS);
 /**
  * Parses CLI argv (pass process.argv.slice(2)).
  * Throws with a descriptive message on validation errors.
@@ -98,159 +168,40 @@ function closestKnownFlag(unknown) {
  * and CLI flags override them.
  */
 export function parseArgs(argv, config) {
-    let url = config?.url;
-    let file = config?.file;
-    let outDir = config?.outDir;
-    let watch = config?.watch ?? false;
-    let interval = config?.interval ?? 3000;
-    const ajsc = { jsdoc: true, ...config?.ajsc };
-    let clientImportPath = config?.clientImportPath;
-    let dryRun = config?.dryRun ?? false;
-    let namespaceTypes = config?.namespaceTypes ?? true;
-    let selfContained = config?.selfContained ?? true;
-    let serviceName = config?.serviceName;
-    let cleanOutDir = config?.cleanOutDir ?? true;
-    let target = config?.target;
-    let kotlinPackage = config?.kotlin?.package;
-    let kotlinSerializer = config?.kotlin?.serializer;
-    let swiftSerializer = config?.swift?.serializer;
-    let swiftAccessLevel = config?.swift?.accessLevel;
-    let unsupportedUnions = config?.unsupportedUnions;
-    let shareModels = config?.shareModels ?? true;
+    const state = {
+        url: config?.url,
+        file: config?.file,
+        outDir: config?.outDir,
+        watch: config?.watch ?? false,
+        interval: config?.interval ?? 3000,
+        ajsc: { jsdoc: true, ...config?.ajsc },
+        clientImportPath: config?.clientImportPath,
+        dryRun: config?.dryRun ?? false,
+        namespaceTypes: config?.namespaceTypes ?? true,
+        selfContained: config?.selfContained ?? true,
+        serviceName: config?.serviceName,
+        cleanOutDir: config?.cleanOutDir ?? true,
+        target: config?.target,
+        kotlinPackage: config?.kotlin?.package,
+        kotlinSerializer: config?.kotlin?.serializer,
+        swiftSerializer: config?.swift?.serializer,
+        swiftAccessLevel: config?.swift?.accessLevel,
+        unsupportedUnions: config?.unsupportedUnions,
+        shareModels: config?.shareModels ?? true,
+        sharedModelsModule: config?.sharedModelsModule,
+        strictSharedModels: config?.strictSharedModels ?? false,
+        configPath: undefined,
+    };
     const sharedTypesImport = config?.sharedTypesImport;
-    let sharedModelsModule = config?.sharedModelsModule;
-    let strictSharedModels = config?.strictSharedModels ?? false;
-    let configPath;
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
-        if (arg === '--url') {
-            url = argv[++i];
-        }
-        else if (arg === '--file') {
-            file = argv[++i];
-        }
-        else if (arg === '--out') {
-            outDir = argv[++i];
-        }
-        else if (arg === '--watch') {
-            watch = true;
-        }
-        else if (arg === '--interval') {
-            interval = parseInt(argv[++i] ?? '3000', 10);
-        }
-        else if (arg === '--enum-style') {
-            const val = argv[++i];
-            if (val === 'union' || val === 'enum') {
-                ajsc.enumStyle = val;
-            }
-        }
-        else if (arg === '--depluralize') {
-            ajsc.depluralize = true;
-        }
-        else if (arg === '--array-item-naming') {
-            const val = argv[++i];
-            ajsc.arrayItemNaming = val === 'false' ? false : val;
-        }
-        else if (arg === '--uncountable-words') {
-            ajsc.uncountableWords = (argv[++i] ?? '').split(',').map((w) => w.trim()).filter(Boolean);
-        }
-        else if (arg === '--jsdoc') {
-            ajsc.jsdoc = true;
-        }
-        else if (arg === '--no-jsdoc') {
-            ajsc.jsdoc = false;
-        }
-        else if (arg === '--client-import-path') {
-            clientImportPath = argv[++i];
-        }
-        else if (arg === '--dry-run') {
-            dryRun = true;
-        }
-        else if (arg === '--namespace-types') {
-            namespaceTypes = true;
-        }
-        else if (arg === '--no-namespace-types') {
-            namespaceTypes = false;
-        }
-        else if (arg === '--self-contained') {
-            selfContained = true;
-        }
-        else if (arg === '--no-self-contained') {
-            selfContained = false;
-        }
-        else if (arg === '--service-name') {
-            serviceName = argv[++i];
-        }
-        else if (arg === '--clean-out-dir') {
-            cleanOutDir = true;
-        }
-        else if (arg === '--no-clean-out-dir') {
-            cleanOutDir = false;
-        }
-        else if (arg === '--target') {
-            const val = argv[++i];
-            if (val === 'ts' || val === 'kotlin' || val === 'swift') {
-                target = val;
-            }
-            else {
-                throw new Error(`Invalid --target value: ${val ?? '(missing)'} (expected 'ts', 'kotlin', or 'swift')`);
-            }
-        }
-        else if (arg === '--kotlin-package') {
-            kotlinPackage = argv[++i];
-        }
-        else if (arg === '--kotlin-serializer') {
-            const val = argv[++i];
-            if (val === 'kotlinx' || val === 'none') {
-                kotlinSerializer = val;
-            }
-            else {
-                throw new Error(`Invalid --kotlin-serializer value: ${val ?? '(missing)'} (expected 'kotlinx' or 'none')`);
-            }
-        }
-        else if (arg === '--swift-serializer') {
-            const val = argv[++i];
-            if (val === 'codable' || val === 'none') {
-                swiftSerializer = val;
-            }
-            else {
-                throw new Error(`Invalid --swift-serializer value: ${val ?? '(missing)'} (expected 'codable' or 'none')`);
-            }
-        }
-        else if (arg === '--swift-access-level') {
-            const val = argv[++i];
-            if (val === 'public' || val === 'internal') {
-                swiftAccessLevel = val;
-            }
-            else {
-                throw new Error(`Invalid --swift-access-level value: ${val ?? '(missing)'} (expected 'public' or 'internal')`);
-            }
-        }
-        else if (arg === '--unsupported-unions') {
-            const val = argv[++i];
-            if (val === 'throw' || val === 'fallback') {
-                unsupportedUnions = val;
-            }
-            else {
-                throw new Error(`Invalid --unsupported-unions value: ${val ?? '(missing)'} (expected 'throw' or 'fallback')`);
-            }
-        }
-        else if (arg === '--share-models') {
-            shareModels = true;
-        }
-        else if (arg === '--no-share-models') {
-            shareModels = false;
-        }
-        else if (arg === '--shared-models-module') {
-            sharedModelsModule = argv[++i];
-        }
-        else if (arg === '--strict-shared-models') {
-            strictSharedModels = true;
-        }
-        else if (arg === '--config') {
-            configPath = argv[++i];
-        }
-        else if (arg !== undefined && arg.startsWith('--')) {
+        // Non-flag tokens (positionals) are silently ignored, matching the
+        // historical behavior. Value tokens never reach this check — they are
+        // consumed via ++i by the flag that owns them.
+        if (arg === undefined || !arg.startsWith('--'))
+            continue;
+        const spec = FLAG_SPEC_BY_NAME.get(arg);
+        if (spec === undefined) {
             // Reject unknown flags loudly. Silently ignoring them led to a downstream
             // bug where a misspelled `--targt` produced an empty envelope with no
             // user-visible cause. Suggest the closest known flag when the typo is
@@ -261,9 +212,15 @@ export function parseArgs(argv, config) {
                 : ' See the README for the supported flag set.';
             throw new Error(`[ts-procedures-codegen] Unknown CLI flag: ${arg}.${tail}`);
         }
+        const handler = FLAG_HANDLERS[arg];
+        if (handler === undefined) {
+            // Drift guard: the flag is cataloged (so --help and did-you-mean know it)
+            // but nobody taught parseArgs what it does. The parity test catches this
+            // in CI; this throw catches it if the test is skipped.
+            throw new Error(`[ts-procedures-codegen] Internal error: ${arg} is cataloged in FLAG_SPECS but has no parseArgs handler.`);
+        }
+        handler(state, spec.takesValue ? argv[++i] : undefined);
     }
-    // configPath is consumed by the caller (main) before parseArgs is called with the loaded config.
-    // When called from main, config is already loaded. When called directly (tests), configPath is ignored.
     // ---------------------------------------------------------------------------
     // Validation — fails fast on user-controllable errors before envelope resolve.
     // Runtime checks (emitter availability, etc.) happen later in pipeline.ts;
@@ -271,54 +228,54 @@ export function parseArgs(argv, config) {
     // The CLI resolves emitters before invoking `runPipeline`, so users only ever
     // see flag-shape errors from this block, not pipeline-internal throws.
     // ---------------------------------------------------------------------------
-    if (outDir === undefined) {
+    if (state.outDir === undefined) {
         throw new Error('Missing required argument: --out <dir>');
     }
-    if (url === undefined && file === undefined) {
+    if (state.url === undefined && state.file === undefined) {
         throw new Error('Missing required input source: provide --url <url> or --file <path>');
     }
     // Kotlin target requires a package; surface this before any I/O happens.
-    if (target === 'kotlin' && (kotlinPackage === undefined || kotlinPackage === '')) {
+    if (state.target === 'kotlin' && (state.kotlinPackage === undefined || state.kotlinPackage === '')) {
         throw new Error('Missing required argument: --kotlin-package <pkg> (required when --target kotlin)');
     }
     // Swift target currently has no required flags. If that changes, add the
     // guard here so the failure mode stays consistent (flag-shape errors fire
     // from parseArgs; runtime/emitter wiring errors fire from pipeline.ts).
     return {
-        url,
-        file,
-        outDir,
-        watch,
-        interval,
-        ajsc,
-        ...(clientImportPath !== undefined ? { clientImportPath } : {}),
-        dryRun,
-        namespaceTypes,
-        selfContained,
-        ...(serviceName !== undefined ? { serviceName } : {}),
-        cleanOutDir,
-        ...(target !== undefined ? { target } : {}),
-        ...(kotlinPackage !== undefined
+        url: state.url,
+        file: state.file,
+        outDir: state.outDir,
+        watch: state.watch,
+        interval: state.interval,
+        ajsc: state.ajsc,
+        ...(state.clientImportPath !== undefined ? { clientImportPath: state.clientImportPath } : {}),
+        dryRun: state.dryRun,
+        namespaceTypes: state.namespaceTypes,
+        selfContained: state.selfContained,
+        ...(state.serviceName !== undefined ? { serviceName: state.serviceName } : {}),
+        cleanOutDir: state.cleanOutDir,
+        ...(state.target !== undefined ? { target: state.target } : {}),
+        ...(state.kotlinPackage !== undefined
             ? {
                 kotlin: {
-                    package: kotlinPackage,
-                    ...(kotlinSerializer !== undefined ? { serializer: kotlinSerializer } : {}),
+                    package: state.kotlinPackage,
+                    ...(state.kotlinSerializer !== undefined ? { serializer: state.kotlinSerializer } : {}),
                 },
             }
             : {}),
-        ...(swiftSerializer !== undefined || swiftAccessLevel !== undefined
+        ...(state.swiftSerializer !== undefined || state.swiftAccessLevel !== undefined
             ? {
                 swift: {
-                    ...(swiftSerializer !== undefined ? { serializer: swiftSerializer } : {}),
-                    ...(swiftAccessLevel !== undefined ? { accessLevel: swiftAccessLevel } : {}),
+                    ...(state.swiftSerializer !== undefined ? { serializer: state.swiftSerializer } : {}),
+                    ...(state.swiftAccessLevel !== undefined ? { accessLevel: state.swiftAccessLevel } : {}),
                 },
             }
             : {}),
-        ...(unsupportedUnions !== undefined ? { unsupportedUnions } : {}),
-        shareModels,
+        ...(state.unsupportedUnions !== undefined ? { unsupportedUnions: state.unsupportedUnions } : {}),
+        shareModels: state.shareModels,
         ...(sharedTypesImport !== undefined ? { sharedTypesImport } : {}),
-        ...(sharedModelsModule !== undefined ? { sharedModelsModule } : {}),
-        strictSharedModels,
+        ...(state.sharedModelsModule !== undefined ? { sharedModelsModule: state.sharedModelsModule } : {}),
+        strictSharedModels: state.strictSharedModels,
     };
 }
 /**