@ir-kit/openapi 0.1.0 → 0.2.0

package/dist/spec/normalize/objects.d.ts

@@ -0,0 +1,14 @@
+import type { NamingConfig } from "./name.js";
+export interface ObjectPassOptions {
+    naming?: NamingConfig;
+    /** Skip shapes with fewer than this many properties. Default: 3. */
+    minProperties?: number;
+}
+/**
+ * Hoist structurally identical inline objects to `components.schemas`.
+ * Inline-only — never merges with existing roots, since structural
+ * equality is too weak a signal for object identity. Returns the set
+ * of newly-added schema names.
+ */
+export declare function dedupeInlineObjects(spec: unknown, opts?: ObjectPassOptions): Set<string>;
+//# sourceMappingURL=objects.d.ts.map

package/dist/spec/normalize/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../../src/spec/normalize/objects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAS9C,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAOD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,IAAI,GAAE,iBAAsB,GAC3B,GAAG,CAAC,MAAM,CAAC,CAyEb"}

package/dist/spec/normalize/objects.js

@@ -0,0 +1,229 @@
+import { preserveMetadata } from "./metadata.js";
+import { applyNaming, uniqueComponentName } from "./name.js";
+import { getSchemasObject, isRootSchemaPath, schemasPointerPrefix, walkSchemas, } from "./walk.js";
+const DEFAULT_NAMING = {
+    case: "PascalCase",
+    name: "{{name}}Object",
+};
+/**
+ * Hoist structurally identical inline objects to `components.schemas`.
+ * Inline-only — never merges with existing roots, since structural
+ * equality is too weak a signal for object identity. Returns the set
+ * of newly-added schema names.
+ */
+export function dedupeInlineObjects(spec, opts = {}) {
+    const hoisted = new Set();
+    const schemas = getSchemasObject(spec);
+    if (!schemas)
+        return hoisted;
+    const pointerPrefix = schemasPointerPrefix(spec);
+    if (!pointerPrefix)
+        return hoisted;
+    const naming = opts.naming ?? DEFAULT_NAMING;
+    const minProperties = Math.max(1, opts.minProperties ?? 3);
+    const groups = new Map();
+    walkSchemas(spec, ({ key, node, parent, path }) => {
+        if (key === null || parent === null)
+            return;
+        if (isRootSchemaPath(path))
+            return;
+        const signature = objectSignature(node, minProperties);
+        if (!signature)
+            return;
+        const hit = {
+            parent: parent,
+            key: key,
+            signature,
+            schema: node,
+        };
+        const arr = groups.get(signature);
+        if (arr)
+            arr.push(hit);
+        else
+            groups.set(signature, [hit]);
+    });
+    if (groups.size === 0)
+        return hoisted;
+    const nameBySignature = new Map();
+    const schemaBySignature = new Map();
+    const reservedNames = new Set();
+    for (const [signature, hits] of groups) {
+        if (hits.length < 2)
+            continue;
+        const first = hits[0];
+        if (!first)
+            continue;
+        const baseSource = canonicalBase(first.schema, first.key);
+        if (!hasUsableName(first.schema, baseSource))
+            continue;
+        const base = applyNaming(baseSource, naming);
+        const name = uniqueComponentName(base, schemas, reservedNames);
+        reservedNames.add(name);
+        nameBySignature.set(signature, name);
+        schemaBySignature.set(signature, first.schema);
+    }
+    for (const [signature, name] of nameBySignature) {
+        if (name in schemas)
+            continue;
+        const schema = schemaBySignature.get(signature);
+        if (schema && typeof schema === "object") {
+            const target = schema;
+            preserveMetadata(groups.get(signature) ?? [], target);
+            schemas[name] = target;
+            hoisted.add(name);
+        }
+    }
+    for (const [signature, hits] of groups) {
+        const name = nameBySignature.get(signature);
+        if (!name)
+            continue;
+        for (const { parent, key } of hits) {
+            const ref = { $ref: `${pointerPrefix}${name}` };
+            if (Array.isArray(parent))
+                parent[key] = ref;
+            else
+                parent[key] = ref;
+        }
+    }
+    return hoisted;
+}
+function objectSignature(schema, minProperties) {
+    if (!schema || typeof schema !== "object")
+        return undefined;
+    const s = schema;
+    if (s.$ref)
+        return undefined;
+    if (Array.isArray(s.enum))
+        return undefined;
+    if (s.type !== undefined && s.type !== "object")
+        return undefined;
+    // Composition / conditional keywords change semantics if folded.
+    if ("allOf" in s ||
+        "anyOf" in s ||
+        "oneOf" in s ||
+        "not" in s ||
+        "if" in s ||
+        "then" in s ||
+        "else" in s) {
+        return undefined;
+    }
+    const properties = s.properties;
+    if (!properties ||
+        typeof properties !== "object" ||
+        Array.isArray(properties)) {
+        return undefined;
+    }
+    const propNames = Object.keys(properties).sort();
+    if (propNames.length < minProperties)
+        return undefined;
+    const required = Array.isArray(s.required)
+        ? [...s.required].sort()
+        : [];
+    const propsForSig = propNames.map((name) => [
+        name,
+        propertySignature(properties[name]),
+    ]);
+    return JSON.stringify({
+        properties: propsForSig,
+        required,
+        additionalProperties: additionalPropertiesSignature(s.additionalProperties),
+    });
+}
+/** Recursive structural hash of a property's shape. */
+function propertySignature(node) {
+    if (!node || typeof node !== "object")
+        return "?";
+    const s = node;
+    if (typeof s.$ref === "string")
+        return `ref:${s.$ref}`;
+    if (Array.isArray(s.enum)) {
+        return `enum:${JSON.stringify({
+            type: s.type ?? "",
+            format: s.format ?? "",
+            values: [...s.enum].sort(),
+        })}`;
+    }
+    const type = (s.type ?? "any");
+    if (type === "array") {
+        const items = s.items;
+        return `array<${propertySignature(items ?? null)}>`;
+    }
+    if (type === "object" || s.properties) {
+        const props = s.properties;
+        const propPairs = props
+            ? Object.keys(props)
+                .sort()
+                .map((k) => [k, propertySignature(props[k])])
+            : [];
+        const required = Array.isArray(s.required)
+            ? [...s.required].sort()
+            : [];
+        return `object:${JSON.stringify({
+            properties: propPairs,
+            required,
+            additionalProperties: additionalPropertiesSignature(s.additionalProperties),
+        })}`;
+    }
+    const format = s.format ? `:${s.format}` : "";
+    return `${type}${format}`;
+}
+function additionalPropertiesSignature(value) {
+    if (value === undefined)
+        return "u";
+    if (value === false)
+        return "false";
+    if (value === true)
+        return "true";
+    return propertySignature(value);
+}
+function canonicalBase(schema, key) {
+    if (schema && typeof schema === "object" && "title" in schema) {
+        const title = schema.title;
+        if (typeof title === "string" && title)
+            return title;
+    }
+    return String(key);
+}
+/** Reject numeric / generic keys that would yield meaningless type names like `0Object` or `DataObject`. Title overrides. */
+const GENERIC_KEYS = new Set([
+    "attributes",
+    "body",
+    "config",
+    "content",
+    "data",
+    "details",
+    "fields",
+    "info",
+    "item",
+    "items",
+    "key",
+    "metadata",
+    "name",
+    "options",
+    "params",
+    "parameters",
+    "payload",
+    "properties",
+    "props",
+    "request",
+    "response",
+    "result",
+    "results",
+    "schema",
+    "settings",
+    "value",
+    "values",
+]);
+function hasUsableName(schema, base) {
+    if (schema && typeof schema === "object" && "title" in schema) {
+        const title = schema.title;
+        if (typeof title === "string" && title)
+            return true;
+    }
+    if (!base)
+        return false;
+    if (/^\d+$/.test(base))
+        return false;
+    return !GENERIC_KEYS.has(base.toLowerCase());
+}
+//# sourceMappingURL=objects.js.map

package/dist/spec/normalize/objects.js.map

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

package/dist/spec/normalize/prune.d.ts

@@ -0,0 +1,15 @@
+export interface PruneOptions {
+    /**
+     * When set, only schemas whose name is in this set are eligible for
+     * deletion. Pass the union of names hoisted by earlier passes to
+     * keep user-authored schemas untouched. Omit for a global sweep.
+     */
+    targets?: ReadonlySet<string>;
+}
+/**
+ * Drop unreferenced `components.schemas` entries. Scoped to `targets`
+ * when supplied; otherwise performs a global reachability sweep
+ * (operations + non-schema components, then transitive closure).
+ */
+export declare function pruneUnusedSchemas(spec: unknown, opts?: PruneOptions): void;
+//# sourceMappingURL=prune.d.ts.map

package/dist/spec/normalize/prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../../src/spec/normalize/prune.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,IAAI,GAAE,YAAiB,GACtB,IAAI,CAuDN"}

package/dist/spec/normalize/prune.js

@@ -0,0 +1,87 @@
+import { refToName } from "@hey-api/shared";
+import { getSchemasObject, schemasPointerPrefix } from "./walk.js";
+/**
+ * Drop unreferenced `components.schemas` entries. Scoped to `targets`
+ * when supplied; otherwise performs a global reachability sweep
+ * (operations + non-schema components, then transitive closure).
+ */
+export function pruneUnusedSchemas(spec, opts = {}) {
+    if (opts.targets && opts.targets.size === 0)
+        return;
+    const schemas = getSchemasObject(spec);
+    if (!schemas)
+        return;
+    const pointerPrefix = schemasPointerPrefix(spec);
+    if (!pointerPrefix)
+        return;
+    const reachable = new Set();
+    if (opts.targets) {
+        // Any reference anywhere — even from a dead authored schema — keeps
+        // a hoisted target alive, otherwise the surviving authored schema
+        // would carry a dangling `$ref`.
+        collectRefs(spec, reachable, 
+        /* skipComponentsSchemas */ false, pointerPrefix);
+    }
+    else {
+        collectRefs(spec, reachable, 
+        /* skipComponentsSchemas */ true, pointerPrefix);
+        let frontier = new Set(reachable);
+        while (frontier.size > 0) {
+            const next = new Set();
+            for (const name of frontier) {
+                const schema = schemas[name];
+                if (!schema)
+                    continue;
+                const refs = new Set();
+                collectRefs(schema, refs, 
+                /* skipComponentsSchemas */ false, pointerPrefix);
+                for (const ref of refs) {
+                    if (!reachable.has(ref)) {
+                        reachable.add(ref);
+                        next.add(ref);
+                    }
+                }
+            }
+            frontier = next;
+        }
+    }
+    for (const name of Object.keys(schemas)) {
+        if (reachable.has(name))
+            continue;
+        if (opts.targets && !opts.targets.has(name))
+            continue;
+        delete schemas[name];
+    }
+}
+function collectRefs(node, out, skipComponentsSchemas, pointerPrefix, inComponents = false) {
+    if (!node || typeof node !== "object")
+        return;
+    if (Array.isArray(node)) {
+        for (const item of node) {
+            collectRefs(item, out, skipComponentsSchemas, pointerPrefix, inComponents);
+        }
+        return;
+    }
+    const value = node;
+    for (const [k, v] of Object.entries(value)) {
+        if (k === "$ref" && typeof v === "string" && v.startsWith(pointerPrefix)) {
+            out.add(refToName(v));
+            continue;
+        }
+        if (skipComponentsSchemas && !inComponents && k === "components") {
+            collectRefsInComponents(v, out, pointerPrefix);
+            continue;
+        }
+        collectRefs(v, out, skipComponentsSchemas, pointerPrefix, inComponents);
+    }
+}
+function collectRefsInComponents(node, out, pointerPrefix) {
+    if (!node || typeof node !== "object" || Array.isArray(node))
+        return;
+    for (const [k, v] of Object.entries(node)) {
+        if (k === "schemas")
+            continue;
+        collectRefs(v, out, /* skip */ false, pointerPrefix, true);
+    }
+}
+//# sourceMappingURL=prune.js.map

package/dist/spec/normalize/prune.js.map

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

package/dist/spec/normalize/walk.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pattern adapted from @hey-api/openapi-ts (MIT) —
+ * `packages/shared/src/openApi/shared/transforms/enums.ts`.
+ * Walker, root-path detection, and pointer-prefix logic mirror the
+ * upstream private helpers, which aren't re-exported.
+ */
+export interface SchemaNode {
+    key: string | number | null;
+    node: unknown;
+    parent: unknown;
+    path: ReadonlyArray<string | number>;
+}
+/** Visit every schema-shaped object in `spec`. */
+export declare function walkSchemas(spec: unknown, visit: (n: SchemaNode) => void): void;
+/** True when `path` points at `components.schemas.<X>` or `definitions.<X>`. */
+export declare function isRootSchemaPath(path: ReadonlyArray<string | number>): boolean;
+/** Pointer prefix for shared schemas (OpenAPI 3.x or Swagger 2.0). */
+export declare function schemasPointerPrefix(spec: unknown): string;
+/** Live handle on the spec's shared-schema map; creates containers if absent. */
+export declare function getSchemasObject(spec: unknown): Record<string, unknown> | undefined;
+//# sourceMappingURL=walk.d.ts.map

package/dist/spec/normalize/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../../src/spec/normalize/walk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACtC;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAC7B,IAAI,CAEN;AAgCD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,GACnC,OAAO,CAKT;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAK1D;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAgBrC"}

package/dist/spec/normalize/walk.js

@@ -0,0 +1,91 @@
+/**
+ * Pattern adapted from @hey-api/openapi-ts (MIT) —
+ * `packages/shared/src/openApi/shared/transforms/enums.ts`.
+ * Walker, root-path detection, and pointer-prefix logic mirror the
+ * upstream private helpers, which aren't re-exported.
+ */
+/** JSON Schema keywords that hold child schemas. */
+const CHILD_SCHEMA_KEYWORDS = [
+    "additionalProperties",
+    "allOf",
+    "anyOf",
+    "contains",
+    "dependentSchemas",
+    "else",
+    "if",
+    "items",
+    "oneOf",
+    "patternProperties",
+    "properties",
+    "propertyNames",
+    "then",
+    "unevaluatedProperties",
+];
+/** Visit every schema-shaped object in `spec`. */
+export function walkSchemas(spec, visit) {
+    walk({ key: null, node: spec, parent: null, path: [] }, visit);
+}
+function walk(n, visit) {
+    const { node, path } = n;
+    if (!node || typeof node !== "object" || Array.isArray(node))
+        return;
+    const value = node;
+    if (isSchemaShaped(value))
+        visit(n);
+    for (const [k, v] of Object.entries(value)) {
+        if (v === null || typeof v !== "object")
+            continue;
+        if (Array.isArray(v)) {
+            v.forEach((item, index) => walk({ key: index, node: item, parent: v, path: [...path, k, index] }, visit));
+        }
+        else {
+            walk({ key: k, node: v, parent: node, path: [...path, k] }, visit);
+        }
+    }
+}
+function isSchemaShaped(value) {
+    if ("type" in value || "enum" in value)
+        return true;
+    for (const keyword of CHILD_SCHEMA_KEYWORDS) {
+        if (keyword in value)
+            return true;
+    }
+    return false;
+}
+/** True when `path` points at `components.schemas.<X>` or `definitions.<X>`. */
+export function isRootSchemaPath(path) {
+    if (path.length === 3 && path[0] === "components" && path[1] === "schemas") {
+        return true;
+    }
+    return path.length === 2 && path[0] === "definitions";
+}
+/** Pointer prefix for shared schemas (OpenAPI 3.x or Swagger 2.0). */
+export function schemasPointerPrefix(spec) {
+    if (!spec || typeof spec !== "object")
+        return "";
+    if ("openapi" in spec)
+        return "#/components/schemas/";
+    if ("swagger" in spec)
+        return "#/definitions/";
+    return "";
+}
+/** Live handle on the spec's shared-schema map; creates containers if absent. */
+export function getSchemasObject(spec) {
+    if (!spec || typeof spec !== "object")
+        return undefined;
+    const s = spec;
+    if ("openapi" in s) {
+        const components = (s.components ?? {});
+        s.components = components;
+        const schemas = (components.schemas ?? {});
+        components.schemas = schemas;
+        return schemas;
+    }
+    if ("swagger" in s) {
+        const defs = (s.definitions ?? {});
+        s.definitions = defs;
+        return defs;
+    }
+    return undefined;
+}
+//# sourceMappingURL=walk.js.map

package/dist/spec/normalize/walk.js.map

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

package/dist/spec/ref.d.ts

@@ -0,0 +1,17 @@
+import type { IR } from "@hey-api/shared";
+/**
+ * Extract the type name from a `$ref` pointing into
+ * `#/components/schemas`. Non-schema refs pass through unchanged so
+ * the caller can decide how to surface them; in practice generators
+ * only see schema refs because hey-api's ref-parser inlines other
+ * pointer types (parameters, requestBodies, responses) before the IR
+ * stage.
+ */
+export declare function refName(ref: string): string;
+/**
+ * Empty / unknown / void schemas — used to short-circuit a 2xx response
+ * to a no-payload return type (Kotlin `Unit`, Swift `Void`, Go's
+ * absence of a return type).
+ */
+export declare function isMeaningless(s: IR.SchemaObject): boolean;
+//# sourceMappingURL=ref.d.ts.map

package/dist/spec/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/spec/ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAI1C;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,GAAG,OAAO,CAUzD"}

package/dist/spec/ref.js

@@ -0,0 +1,32 @@
+const REF_SCHEMA_PREFIX = "#/components/schemas/";
+/**
+ * Extract the type name from a `$ref` pointing into
+ * `#/components/schemas`. Non-schema refs pass through unchanged so
+ * the caller can decide how to surface them; in practice generators
+ * only see schema refs because hey-api's ref-parser inlines other
+ * pointer types (parameters, requestBodies, responses) before the IR
+ * stage.
+ */
+export function refName(ref) {
+    return ref.startsWith(REF_SCHEMA_PREFIX)
+        ? ref.slice(REF_SCHEMA_PREFIX.length)
+        : ref;
+}
+/**
+ * Empty / unknown / void schemas — used to short-circuit a 2xx response
+ * to a no-payload return type (Kotlin `Unit`, Swift `Void`, Go's
+ * absence of a return type).
+ */
+export function isMeaningless(s) {
+    if (s.$ref || s.const !== undefined)
+        return false;
+    if (s.items && s.items.length > 0)
+        return false;
+    if (s.properties && Object.keys(s.properties).length > 0)
+        return false;
+    return (s.type === undefined ||
+        s.type === "unknown" ||
+        s.type === "void" ||
+        s.type === "never");
+}
+//# sourceMappingURL=ref.js.map

package/dist/spec/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../src/spec/ref.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;QACtC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACrC,CAAC,CAAC,GAAG,CAAC;AACV,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAkB;IAC9C,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACvE,OAAO,CACL,CAAC,CAAC,IAAI,KAAK,SAAS;QACpB,CAAC,CAAC,IAAI,KAAK,SAAS;QACpB,CAAC,CAAC,IAAI,KAAK,MAAM;QACjB,CAAC,CAAC,IAAI,KAAK,OAAO,CACnB,CAAC;AACJ,CAAC"}

package/dist/spec/security.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Per-operation security-scheme NAME extraction. hey-api's IR drops
+ * scheme names from `op.security` (it inlines the resolved scheme
+ * objects into a different shape), leaving downstream generators with
+ * no way to wire `client.auth["<name>"]`. So we walk the raw bundled
+ * spec instead and key results by `${path}|${method}` for fast
+ * lookups during the IR pass.
+ *
+ * Map shape: `"/me|get" → ["bearerAuth", "apiKeyAuth"]`.
+ *
+ * An operation with `security: [{a: []}, {b: []}]` (logical OR — any
+ * scheme satisfies the requirement) and an operation with
+ * `security: [{a: [], b: []}]` (logical AND — both required) both
+ * collapse to the same name set here. Generators currently apply
+ * every scheme that has a matching `client.auth` entry; if we ever
+ * need to honour OR/AND semantics, this map needs to grow shape.
+ */
+export declare function extractSecuritySchemeNames(spec: Record<string, unknown>): Map<string, ReadonlyArray<string>>;
+/** Key used in the security-scheme map for one (path, method) pair.
+ *  The pipe is non-URL-safe so it can't collide with a path segment. */
+export declare const securityKey: (path: string, method: string) => string;
+//# sourceMappingURL=security.d.ts.map

package/dist/spec/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/spec/security.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAuBpC;AAED;wEACwE;AACxE,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MACtC,CAAC"}

package/dist/spec/security.js

@@ -0,0 +1,47 @@
+/**
+ * Per-operation security-scheme NAME extraction. hey-api's IR drops
+ * scheme names from `op.security` (it inlines the resolved scheme
+ * objects into a different shape), leaving downstream generators with
+ * no way to wire `client.auth["<name>"]`. So we walk the raw bundled
+ * spec instead and key results by `${path}|${method}` for fast
+ * lookups during the IR pass.
+ *
+ * Map shape: `"/me|get" → ["bearerAuth", "apiKeyAuth"]`.
+ *
+ * An operation with `security: [{a: []}, {b: []}]` (logical OR — any
+ * scheme satisfies the requirement) and an operation with
+ * `security: [{a: [], b: []}]` (logical AND — both required) both
+ * collapse to the same name set here. Generators currently apply
+ * every scheme that has a matching `client.auth` entry; if we ever
+ * need to honour OR/AND semantics, this map needs to grow shape.
+ */
+export function extractSecuritySchemeNames(spec) {
+    const map = new Map();
+    const paths = (spec.paths ?? {});
+    for (const [pathStr, pathItem] of Object.entries(paths)) {
+        if (!pathItem || typeof pathItem !== "object")
+            continue;
+        for (const [method, op] of Object.entries(pathItem)) {
+            if (!op || typeof op !== "object")
+                continue;
+            const security = op.security;
+            if (!Array.isArray(security))
+                continue;
+            const names = new Set();
+            for (const requirement of security) {
+                if (requirement && typeof requirement === "object") {
+                    for (const name of Object.keys(requirement))
+                        names.add(name);
+                }
+            }
+            if (names.size > 0) {
+                map.set(securityKey(pathStr, method), [...names]);
+            }
+        }
+    }
+    return map;
+}
+/** Key used in the security-scheme map for one (path, method) pair.
+ *  The pipe is non-URL-safe so it can't collide with a path segment. */
+export const securityKey = (path, method) => `${path}|${method}`;
+//# sourceMappingURL=security.js.map

package/dist/spec/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/spec/security.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAA6B;IAE7B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAiC,CAAC;IACrD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;IAC5D,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,SAAS;QACxD,KAAK,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CACvC,QAAmC,CACpC,EAAE,CAAC;YACF,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;gBAAE,SAAS;YAC5C,MAAM,QAAQ,GAAI,EAA6B,CAAC,QAAQ,CAAC;YACzD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACvC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;YAChC,KAAK,MAAM,WAAW,IAAI,QAAQ,EAAE,CAAC;gBACnC,IAAI,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;oBACnD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;wBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACnB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;wEACwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAc,EAAU,EAAE,CAClE,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC"}

package/dist/type/dispatch.js

@@ -1,4 +1,4 @@
-import { refName } from "@ir-kit/openapi-core";
+import { refName } from "../spec/ref.js";
 import { assertNoEnumCollisions, classifyEnumLiterals, } from "./enum.js";
 import { classifyObjectShape, iterateObjectProperties, } from "./object.js";
 import { classifyUnion } from "./union.js";