@redocly/client-generator 0.0.0-snapshot.1784554531

package/lib/intermediate-representation/sanitize-identifiers.js

@@ -0,0 +1,153 @@
+import { logger } from '@redocly/openapi-core';
+import { isSafeIdentifier, uniqueIdent } from '../emitters/identifier.js';
+/**
+ * Coerce every document-derived name that lands in a TypeScript *declaration*
+ * slot — schema type names, operation (function) names — into a valid, unique JS
+ * identifier, and rewrite every reference to a renamed schema to match.
+ *
+ * This is a security boundary, not a nicety. `ts.factory.createIdentifier` prints
+ * its text verbatim with no validation, so a spec name like
+ * `foo(){};globalThis.x=1;export async function bar` would emit as executable
+ * top-level code in every consumer of the generated client. Sanitizing here, once,
+ * means no raw name reaches the printer regardless of which emitter consumes it.
+ *
+ * Valid identifiers pass through unchanged, so well-formed specs are byte-for-byte
+ * unaffected; only `-`/`.`/space/reserved-word/hostile names are rewritten (with a
+ * warning). `assertSafeIdentifiers` is the belt-and-suspenders gate that fails the
+ * build if any name still slips through — it should never fire after this pass.
+ */
+export function sanitizeIdentifiers(model) {
+    // Schema names share TypeScript's *type* namespace; operation names its *value*
+    // namespace. Keep separate `used` sets so a function and a type may share a name.
+    const schemaNames = new Set();
+    const renamed = new Map();
+    for (const schema of model.schemas) {
+        const safe = uniqueIdent(schema.name, schemaNames);
+        if (safe !== schema.name) {
+            renamed.set(schema.name, safe);
+            warnRename('schema', schema.name, safe);
+            schema.name = safe;
+        }
+    }
+    // Security-scheme keys feed the apiKey setter name (`setApiKey<Key>`, built with a
+    // first-char-only pascalCase) and the runtime's security-matching string literals.
+    // Sanitize so the setter is a valid identifier, then rewrite each operation's
+    // `security` list with the same map so the literals still match.
+    const schemeKeys = new Set();
+    const renamedKeys = new Map();
+    for (const scheme of model.securitySchemes) {
+        const safe = uniqueIdent(scheme.key, schemeKeys);
+        if (safe !== scheme.key) {
+            renamedKeys.set(scheme.key, safe);
+            warnRename('security scheme', scheme.key, safe);
+            scheme.key = safe;
+        }
+    }
+    // A reference to a renamed schema/scheme must follow it; an unknown/dangling name is
+    // still sanitized standalone so it can never carry an injection payload.
+    const fixRef = (name) => renamed.get(name) ?? sanitizeRef(name);
+    const fixKey = (key) => renamedKeys.get(key) ?? sanitizeRef(key);
+    for (const schema of model.schemas)
+        rewriteRefs(schema.schema, fixRef);
+    const operationNames = new Set();
+    for (const service of model.services) {
+        for (const op of service.operations) {
+            const safe = uniqueIdent(op.name, operationNames);
+            if (safe !== op.name) {
+                warnRename('operation', op.name, safe);
+                op.specName = op.name;
+                op.name = safe;
+            }
+            rewriteOperationRefs(op, fixRef);
+            op.security = op.security.map((alternative) => alternative.map(fixKey));
+        }
+    }
+}
+/**
+ * Throw if any declaration name is still not a safe identifier — a generator bug, not
+ * bad input.
+ *
+ * This gates the three names that land *directly* in a binding slot from the model:
+ * schema names, security-scheme keys, and operation names. Identifiers an emitter
+ * *derives* from these — path-parameter binding names (`uniqueIdent`) and enum
+ * const-object keys (`isIdentifier`-gated) — are sanitized at their point of use,
+ * not here, so they stay safe even though this gate does not re-check them.
+ */
+export function assertSafeIdentifiers(model) {
+    for (const schema of model.schemas) {
+        if (!isSafeIdentifier(schema.name))
+            throw unsafe('schema', schema.name);
+    }
+    for (const scheme of model.securitySchemes) {
+        // The key drives `setApiKey<Key>`, so it must be a safe identifier.
+        if (!isSafeIdentifier(scheme.key))
+            throw unsafe('security scheme', scheme.key);
+    }
+    for (const service of model.services) {
+        for (const op of service.operations) {
+            if (!isSafeIdentifier(op.name))
+                throw unsafe('operation', op.name);
+        }
+    }
+}
+function unsafe(kind, name) {
+    return new Error(`Internal error: ${kind} name ${JSON.stringify(name)} is not a safe identifier after sanitization.`);
+}
+/** Sanitize a ref/`omit` target that has no matching declaration (rare: a dangling $ref). */
+function sanitizeRef(name) {
+    // No uniqueness context here; a throwaway set yields a pure, deterministic sanitize.
+    return uniqueIdent(name, new Set());
+}
+function warnRename(kind, from, to) {
+    logger.warn(`generate-client: ${kind} name ${JSON.stringify(from)} is not a valid TypeScript identifier; using ${JSON.stringify(to)}.\n`);
+}
+/** Rewrite `ref`/`omit`/discriminator targets in a schema subtree via `fixRef` (mutates). */
+function rewriteRefs(schema, fixRef) {
+    switch (schema.kind) {
+        case 'ref':
+            schema.name = fixRef(schema.name);
+            break;
+        case 'omit':
+            schema.base = fixRef(schema.base);
+            break;
+        case 'array':
+            rewriteRefs(schema.items, fixRef);
+            break;
+        case 'record':
+            rewriteRefs(schema.value, fixRef);
+            break;
+        case 'object':
+            for (const prop of schema.properties)
+                rewriteRefs(prop.schema, fixRef);
+            break;
+        case 'union':
+            for (const member of schema.members)
+                rewriteRefs(member, fixRef);
+            if (schema.discriminator) {
+                for (const entry of schema.discriminator.mapping)
+                    entry.schemaName = fixRef(entry.schemaName);
+            }
+            break;
+        case 'intersection':
+            for (const member of schema.members)
+                rewriteRefs(member, fixRef);
+            break;
+        // scalar / literal / enum / null / unknown carry no schema references.
+    }
+}
+function rewriteOperationRefs(op, fixRef) {
+    for (const p of op.pathParams)
+        rewriteRefs(p.schema, fixRef);
+    for (const p of op.queryParams)
+        rewriteRefs(p.schema, fixRef);
+    for (const p of op.headerParams)
+        rewriteRefs(p.schema, fixRef);
+    if (op.requestBody)
+        rewriteRefs(op.requestBody.schema, fixRef);
+    for (const r of [...op.successResponses, ...op.errorResponses]) {
+        rewriteRefs(r.schema, fixRef);
+        if (r.itemSchema)
+            rewriteRefs(r.itemSchema, fixRef);
+    }
+}
+//# sourceMappingURL=sanitize-identifiers.js.map

package/lib/intermediate-representation/sanitize-identifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-identifiers.js","sourceRoot":"","sources":["../../src/intermediate-representation/sanitize-identifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG1E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAe;IACjD,gFAAgF;IAChF,kFAAkF;IAClF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACnD,IAAI,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/B,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,mFAAmF;IACnF,8EAA8E;IAC9E,iEAAiE;IACjE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,IAAI,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC;YACxB,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClC,UAAU,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,yEAAyE;IACzE,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IACjF,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO;QAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAClD,IAAI,IAAI,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;gBACrB,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACvC,EAAE,CAAC,QAAQ,GAAG,EAAE,CAAC,IAAI,CAAC;gBACtB,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,CAAC;YACD,oBAAoB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACjC,EAAE,CAAC,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACnD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3C,oEAAoE;QACpE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC;YAAE,MAAM,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACpC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC;gBAAE,MAAM,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,IAAY;IACxC,OAAO,IAAI,KAAK,CACd,mBAAmB,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,+CAA+C,CACpG,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,SAAS,WAAW,CAAC,IAAY;IAC/B,qFAAqF;IACrF,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,IAAY,EAAE,EAAU;IACxD,MAAM,CAAC,IAAI,CACT,oBAAoB,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gDAAgD,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAC7H,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,SAAS,WAAW,CAAC,MAAmB,EAAE,MAAgC;IACxE,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,KAAK;YACR,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM;QACR,KAAK,MAAM;YACT,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM;QACR,KAAK,OAAO;YACV,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAClC,MAAM;QACR,KAAK,QAAQ;YACX,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAClC,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU;gBAAE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvE,MAAM;QACR,KAAK,OAAO;YACV,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO;gBAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjE,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO;oBAC9C,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAChD,CAAC;YACD,MAAM;QACR,KAAK,cAAc;YACjB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO;gBAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjE,MAAM;QACR,uEAAuE;IACzE,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,EAAkB,EAAE,MAAgC;IAChF,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU;QAAE,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW;QAAE,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,YAAY;QAAE,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/D,IAAI,EAAE,CAAC,WAAW;QAAE,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/D,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC,UAAU;YAAE,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/lib/loader.d.ts

@@ -0,0 +1,4 @@
+import { type Config } from '@redocly/openapi-core';
+import type { LoadResult } from './types.js';
+export declare function loadSpec(ref: string, config?: Config): Promise<LoadResult>;
+//# sourceMappingURL=loader.d.ts.map

package/lib/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EAEZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAWhF"}

package/lib/loader.js

@@ -0,0 +1,14 @@
+import { bundle, createConfig, detectSpec, } from '@redocly/openapi-core';
+export async function loadSpec(ref, config) {
+    const cfg = config ?? (await createConfig({}));
+    // We do NOT pass `dereference: true` — the IR builder needs `$ref` preserved so it can map
+    // response/parameter schemas back to named `components.schemas` entries.
+    // Validation (shape, OpenAPI version) is delegated to `bundle()`, which throws clear messages.
+    const result = await bundle({ ref, config: cfg });
+    const parsed = result.bundle.parsed;
+    return {
+        document: parsed,
+        version: detectSpec(parsed),
+    };
+}
+//# sourceMappingURL=loader.js.map

package/lib/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,YAAY,EACZ,UAAU,GAGX,MAAM,uBAAuB,CAAC;AAI/B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAe;IACzD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,2FAA2F;IAC3F,yEAAyE;IACzE,+FAA+F;IAC/F,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,OAAO;QACL,QAAQ,EAAE,MAAmC;QAC7C,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/lib/plugin.d.ts

@@ -0,0 +1,19 @@
+import type { CustomGenerator } from './generators/types.js';
+/**
+ * Identity helper for authoring a custom generator with full type inference and one validation
+ * choke-point. `export default defineGenerator({ name, run, … })`. Returns its argument unchanged.
+ *
+ * @experimental The plugin API may change between minor versions until stabilized.
+ */
+export declare function defineGenerator(generator: CustomGenerator): CustomGenerator;
+export type { CustomGenerator, GeneratedFile, Generator, GeneratorInput, GeneratorName, OutputMode, } from './generators/types.js';
+export type { ArgsStyle, ErrorMode } from './emitters/operations.js';
+export type { DateType } from './emitters/types.js';
+export type { ApiModel, NamedSchemaModel, OperationModel, ParamModel, PropertyModel, RequestBodyModel, ResponseBodyModel, ScalarKind, SchemaMetadata, SchemaModel, ServiceModel, } from './intermediate-representation/model.js';
+export { arrow, constArray, exportConstStatement, jsdoc, parseStatements, printNodes, printStatements, ts, } from './emitters/ts.js';
+export { operationSignature } from './emitters/operation-signature.js';
+export type { OperationSignature } from './emitters/operation-signature.js';
+export { schemaToTypeNode } from './emitters/types.js';
+export { pascalCase } from './emitters/support.js';
+export { safeIdent } from './emitters/identifier.js';
+//# sourceMappingURL=plugin.d.ts.map

package/lib/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,eAAe,GAAG,eAAe,CAE3E;AAGD,YAAY,EACV,eAAe,EACf,aAAa,EACb,SAAS,EACT,cAAc,EACd,aAAa,EACb,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EACL,KAAK,EACL,UAAU,EACV,oBAAoB,EACpB,KAAK,EACL,eAAe,EACf,UAAU,EACV,eAAe,EACf,EAAE,GACH,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/plugin.js

@@ -0,0 +1,41 @@
+// The custom-generator authoring API — the EXPERIMENTAL plugin surface, re-exported from the
+// package root (`@redocly/client-generator`).
+//
+// ⚠️ Experimental: this surface (the IR types and the codegen toolkit re-exported here) may change
+// between minor versions until it is stabilized. Pin your version if you depend on it.
+//
+// A custom generator is `(GeneratorInput) => GeneratedFile[]` plus a `name`; select it in
+// `generators` by name (inline via `customGenerators`) or by import specifier (path/package). It
+// receives the same spec-agnostic IR (`model`) the built-in generators consume, and may use the same
+// TypeScript-emitting toolkit re-exported below, so a plugin is a first-class peer of `sdk`/`zod`/…
+// The generated client stays dependency-free: a plugin's output is its own file(s), and its runtime
+// libraries are peers of the consumer's app, never of the client.
+//
+//   // my-generator.ts
+//   import { defineGenerator, ts, printStatements } from '@redocly/client-generator';
+//   export default defineGenerator({
+//     name: 'route-map',
+//     requires: ['sdk'],
+//     run({ model, outputPath }) {
+//       const routes = model.services.flatMap((s) => s.operations)
+//         .map((op) => `  ${op.name}: '${op.method.toUpperCase()} ${op.path}',`).join('\n');
+//       return [{ path: outputPath.replace(/\.ts$/, '.routes.ts'),
+//                 content: `export const routes = {\n${routes}\n} as const;\n` }];
+//     },
+//   });
+/**
+ * Identity helper for authoring a custom generator with full type inference and one validation
+ * choke-point. `export default defineGenerator({ name, run, … })`. Returns its argument unchanged.
+ *
+ * @experimental The plugin API may change between minor versions until stabilized.
+ */
+export function defineGenerator(generator) {
+    return generator;
+}
+// --- Codegen toolkit: build TypeScript the same way the built-in generators do -----------------
+export { arrow, constArray, exportConstStatement, jsdoc, parseStatements, printNodes, printStatements, ts, } from './emitters/ts.js';
+export { operationSignature } from './emitters/operation-signature.js';
+export { schemaToTypeNode } from './emitters/types.js';
+export { pascalCase } from './emitters/support.js';
+export { safeIdent } from './emitters/identifier.js';
+//# sourceMappingURL=plugin.js.map

package/lib/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8CAA8C;AAC9C,EAAE;AACF,mGAAmG;AACnG,uFAAuF;AACvF,EAAE;AACF,0FAA0F;AAC1F,iGAAiG;AACjG,qGAAqG;AACrG,oGAAoG;AACpG,oGAAoG;AACpG,kEAAkE;AAClE,EAAE;AACF,uBAAuB;AACvB,sFAAsF;AACtF,qCAAqC;AACrC,yBAAyB;AACzB,yBAAyB;AACzB,mCAAmC;AACnC,mEAAmE;AACnE,6FAA6F;AAC7F,mEAAmE;AACnE,mFAAmF;AACnF,SAAS;AACT,QAAQ;AAIR;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAA0B;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AA6BD,kGAAkG;AAClG,OAAO,EACL,KAAK,EACL,UAAU,EACV,oBAAoB,EACpB,KAAK,EACL,eAAe,EACf,UAAU,EACV,eAAe,EACf,EAAE,GACH,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/runtime/auth.d.ts

@@ -0,0 +1,15 @@
+import type { ClientConfig, SecuritySpec } from './types.js';
+/**
+ * Build the auth headers/query for one operation's `security` OR-alternatives from the
+ * instance credentials (`config.auth`) — capability module, wired into `createClient`.
+ * The first alternative whose schemes (an AND-set) are all configured is applied, so
+ * "bearer OR apiKey" works with either credential and never sends both. When none is
+ * fully configured, the first alternative's configured schemes are still sent (the
+ * server rejects the request, mirroring the previous behavior).
+ * Cookie-borne apiKeys fold into a single `Cookie` header joined with `; `.
+ */
+export declare function resolveAuth(security: readonly (readonly SecuritySpec[])[], config: ClientConfig): Promise<{
+    headers: Record<string, string>;
+    query: Record<string, string>;
+}>;
+//# sourceMappingURL=auth.d.ts.map

package/lib/runtime/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/runtime/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAqB5E;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,SAAS,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,EAC9C,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CA8B7E"}

package/lib/runtime/auth.js

@@ -0,0 +1,67 @@
+/** Resolve a credential: a literal passes through; a function is awaited per request. */
+async function resolveToken(provider) {
+    return typeof provider === 'function' ? await provider() : provider;
+}
+/** UTF-8-safe base64: bare `btoa` throws on non-Latin-1 credentials (RFC 7617 allows UTF-8). */
+function encodeBase64(text) {
+    let binary = '';
+    for (const byte of new TextEncoder().encode(text))
+        binary += String.fromCharCode(byte);
+    return btoa(binary);
+}
+/** Whether a credential for this scheme is configured on the instance. */
+function isConfigured(scheme, config) {
+    if (scheme.kind === 'apiKey')
+        return config.auth?.apiKey?.[scheme.scheme] !== undefined;
+    if (scheme.kind === 'bearer')
+        return config.auth?.bearer !== undefined;
+    return config.auth?.basic !== undefined;
+}
+/**
+ * Build the auth headers/query for one operation's `security` OR-alternatives from the
+ * instance credentials (`config.auth`) — capability module, wired into `createClient`.
+ * The first alternative whose schemes (an AND-set) are all configured is applied, so
+ * "bearer OR apiKey" works with either credential and never sends both. When none is
+ * fully configured, the first alternative's configured schemes are still sent (the
+ * server rejects the request, mirroring the previous behavior).
+ * Cookie-borne apiKeys fold into a single `Cookie` header joined with `; `.
+ */
+export async function resolveAuth(security, config) {
+    const alternative = security.find((schemes) => schemes.every((scheme) => isConfigured(scheme, config))) ??
+        security[0] ??
+        [];
+    const headers = {};
+    const query = {};
+    const cookies = [];
+    for (const scheme of alternative) {
+        if (scheme.kind === 'apiKey') {
+            const provider = config.auth?.apiKey?.[scheme.scheme];
+            if (provider === undefined)
+                continue;
+            const value = await resolveToken(provider);
+            if (scheme.in === 'header')
+                headers[scheme.name] = value;
+            else if (scheme.in === 'query')
+                query[scheme.name] = value;
+            // Cookie values may contain reserved characters (`;`, `=`, space, …); percent-encode
+            // so the credential can't break the `Cookie` header syntax.
+            else
+                cookies.push(`${scheme.name}=${encodeURIComponent(value)}`);
+        }
+        else if (scheme.kind === 'bearer') {
+            const provider = config.auth?.bearer;
+            if (provider !== undefined)
+                headers.Authorization = `Bearer ${await resolveToken(provider)}`;
+        }
+        else {
+            const basic = config.auth?.basic;
+            if (basic !== undefined) {
+                headers.Authorization = `Basic ${encodeBase64(`${basic.username}:${basic.password}`)}`;
+            }
+        }
+    }
+    if (cookies.length > 0)
+        headers.Cookie = cookies.join('; ');
+    return { headers, query };
+}
+//# sourceMappingURL=auth.js.map

package/lib/runtime/auth.js.map

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

package/lib/runtime/create-client.d.ts

@@ -0,0 +1,35 @@
+import { type SendCapabilities } from './send.js';
+import type { Client, ClientConfig, OperationContext, OperationDescriptor, OpsShape, PaginationSpec, QueryValue, RequestOptions, SecuritySpec, ServerSentEvent, SseOptions } from './types.js';
+/**
+ * The optional behaviors `createClientCore` can dispatch to but never statically
+ * imports. The package's public `createClient` wires the full set; the future
+ * inline-mode assembler wires only the capabilities a spec needs.
+ */
+export type Capabilities = SendCapabilities & {
+    resolveAuth?: (security: readonly (readonly SecuritySpec[])[], config: ClientConfig) => Promise<{
+        headers: Record<string, string>;
+        query: Record<string, string>;
+    }>;
+    sse?: (config: ClientConfig, op: OperationContext, prepare: () => Promise<{
+        url: string;
+        init: SseOptions;
+    }>, dataKind: 'json' | 'text') => AsyncGenerator<ServerSentEvent<unknown>>;
+    paginate?: {
+        pages: (call: (args?: OperationArgs, init?: RequestOptions) => Promise<unknown>, spec: PaginationSpec, args?: OperationArgs, init?: RequestOptions) => AsyncGenerator<unknown>;
+        items: (call: (args?: OperationArgs, init?: RequestOptions) => Promise<unknown>, spec: PaginationSpec, args?: OperationArgs, init?: RequestOptions) => AsyncGenerator<unknown>;
+    };
+};
+/** The grouped args wire shape: path params by name plus the `params`/`body`/`headers` slots. */
+export type OperationArgs = {
+    params?: Record<string, QueryValue>;
+    body?: unknown;
+    headers?: Record<string, unknown>;
+} & Record<string, unknown>;
+/**
+ * Build a typed instance client over operation descriptors: one real bound method per
+ * operation (attached by a construction-time loop — no Proxy), plus the core members
+ * (`configure`/`use`/`auth`), which are assigned AFTER the loop so they win any name
+ * collision with an operation. All behavior dispatches through the capability seam.
+ */
+export declare function createClientCore<Ops extends OpsShape, Id extends string = string, Path extends string = string, Tag extends string = string>(operations: Record<string, OperationDescriptor>, initial?: ClientConfig<OperationContext<Id, Path, Tag>>, caps?: Capabilities): Client<Ops, OperationContext<Id, Path, Tag>>;
+//# sourceMappingURL=create-client.d.ts.map

package/lib/runtime/create-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../../src/runtime/create-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyC,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,KAAK,EAEV,MAAM,EACN,YAAY,EAEZ,gBAAgB,EAChB,mBAAmB,EACnB,QAAQ,EACR,cAAc,EAEd,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,UAAU,EAEX,MAAM,YAAY,CAAC;AAGpB;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG;IAC5C,WAAW,CAAC,EAAE,CACZ,QAAQ,EAAE,SAAS,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,EAC9C,MAAM,EAAE,YAAY,KACjB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;IACjF,GAAG,CAAC,EAAE,CACJ,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,gBAAgB,EAGpB,OAAO,EAAE,MAAM,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,EACzD,QAAQ,EAAE,MAAM,GAAG,MAAM,KACtB,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,CACL,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,EACvE,IAAI,EAAE,cAAc,EACpB,IAAI,CAAC,EAAE,aAAa,EACpB,IAAI,CAAC,EAAE,cAAc,KAClB,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7B,KAAK,EAAE,CACL,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,EACvE,IAAI,EAAE,cAAc,EACpB,IAAI,CAAC,EAAE,aAAa,EACpB,IAAI,CAAC,EAAE,cAAc,KAClB,cAAc,CAAC,OAAO,CAAC,CAAC;KAC9B,CAAC;CACH,CAAC;AAEF,iGAAiG;AACjG,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAuK5B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,SAAS,QAAQ,EACpB,EAAE,SAAS,MAAM,GAAG,MAAM,EAC1B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,GAAG,SAAS,MAAM,GAAG,MAAM,EAE3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC/C,OAAO,GAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAM,EAC3D,IAAI,GAAE,YAAiB,GACtB,MAAM,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAoF9C"}

package/lib/runtime/create-client.js

@@ -0,0 +1,215 @@
+import { ApiError } from './errors.js';
+import { parse, readError } from './parse.js';
+import { middlewareChain, send, toHeaderRecord } from './send.js';
+import { buildUrl, substitutePath } from './url.js';
+/** The response reader implied by the descriptor (before any per-call `parseAs` override). */
+function kindFor(op) {
+    if (op.responseKind === 'void' || op.responseKind === 'blob' || op.responseKind === 'text') {
+        return op.responseKind;
+    }
+    return 'auto';
+}
+/** Route the grouped args by the descriptor: path values, query object, body, extra headers. */
+function splitArgs(op, args) {
+    const path = {};
+    for (const param of op.params ?? []) {
+        if (param.in === 'path')
+            path[param.name] = args[param.name];
+    }
+    return { path, query: args.params, body: args.body, headers: args.headers };
+}
+/**
+ * The query-serialization hints for the descriptor's query params. A spec is built only
+ * when the param deviates from the OpenAPI defaults (`form` + `explode: true`, encoded),
+ * and always fully resolved — so `explode: false` or `allowReserved` alone (no `style`)
+ * are honored, and an omitted `explode` keeps the exploded default.
+ */
+function queryStyles(op) {
+    let styles;
+    for (const param of op.params ?? []) {
+        if (param.in !== 'query')
+            continue;
+        const deviates = (param.style !== undefined && param.style !== 'form') ||
+            param.explode === false ||
+            param.allowReserved === true;
+        if (!deviates)
+            continue;
+        styles ??= {};
+        styles[param.name] = {
+            style: param.style ?? 'form',
+            explode: param.explode ?? true,
+            allowReserved: param.allowReserved,
+        };
+    }
+    return styles;
+}
+/** Stringify caller-supplied extra headers, skipping empty entries. */
+function stringHeaders(headers) {
+    const out = {};
+    for (const [key, value] of Object.entries(headers ?? {})) {
+        if (value !== undefined && value !== null)
+            out[key] = String(value);
+    }
+    return out;
+}
+/** Build the request pieces an attempt needs: the final URL and the merged per-call init. */
+async function prepareRequest(config, op, args, init, caps) {
+    const { path, query, body, headers } = splitArgs(op, args);
+    const authed = op.security?.length && caps.resolveAuth
+        ? await caps.resolveAuth(op.security, config)
+        : { headers: {}, query: {} };
+    const fullQuery = { ...query, ...authed.query };
+    const url = buildUrl(config.serverUrl ?? '', substitutePath(op.path, path), Object.keys(fullQuery).length > 0 ? fullQuery : undefined, queryStyles(op));
+    const mergedInit = {
+        ...init,
+        method: op.method.toUpperCase(),
+        // Precedence, lowest → highest (later spreads win): injected auth → explicit
+        // header params → caller `init.headers` — the caller always overrides both.
+        headers: {
+            ...authed.headers,
+            ...stringHeaders(headers),
+            ...toHeaderRecord(init.headers),
+        },
+    };
+    return { url, init: mergedInit, body };
+}
+/** One non-SSE call: send, then branch on the configured error mode. */
+async function execute(config, op, args, init, caps) {
+    const prepared = await prepareRequest(config, op, args, init, caps);
+    const opCtx = { id: op.id, path: op.path, tags: [...(op.tags ?? [])] };
+    const { parseAs, ...sendInit } = prepared.init;
+    const { response, context } = await send(config, opCtx, prepared.url, sendInit, prepared.body, op.body?.multipart === true, caps);
+    const readKind = parseAs ?? kindFor(op);
+    if (config.errorMode === 'result') {
+        if (!response.ok) {
+            return { data: undefined, error: await readError(response), response };
+        }
+        return { data: await parse(response, readKind), error: undefined, response };
+    }
+    if (!response.ok) {
+        let error = new ApiError(context.url, response.status, response.statusText, await readError(response));
+        // Thread the error through each middleware's onError in turn (each may replace it).
+        for (const mw of middlewareChain(config)) {
+            if (mw.onError)
+                error = await mw.onError(error, context);
+        }
+        throw error;
+    }
+    return parse(response, readKind);
+}
+/** The paginate capability, or a descriptive throw when a paginated op is iterated unwired. */
+function paginateCapability(caps, op) {
+    if (!caps.paginate) {
+        throw new Error(`Pagination capability not wired: cannot iterate operation "${op.id}"`);
+    }
+    return caps.paginate;
+}
+/**
+ * The per-page call the iterators drive: the method itself in throw mode; in result
+ * mode a wrapper that unwraps the `{ data, error, response }` envelope — the page
+ * pointers are data-rooted — rethrowing a failed page as `ApiError` (iteration is
+ * error-mode-agnostic; the throw-mode-only `onError` middleware hook is not invoked).
+ */
+function pageCall(method, config) {
+    if (config.errorMode !== 'result')
+        return method;
+    return async (args, init) => {
+        const envelope = (await method(args, init));
+        // Failure is `!response.ok` — NOT `data === undefined`: a successful bodyless page
+        // (204/void) also parses to undefined data, and a failed page's `error` can be
+        // undefined too (unreadable body). The pointers then miss on the undefined data
+        // and iteration stops cleanly, which is the correct semantics for an empty page.
+        if (!envelope.response.ok) {
+            const { response } = envelope;
+            throw new ApiError(response.url, response.status, response.statusText, envelope.error);
+        }
+        return envelope.data;
+    };
+}
+/**
+ * Build a typed instance client over operation descriptors: one real bound method per
+ * operation (attached by a construction-time loop — no Proxy), plus the core members
+ * (`configure`/`use`/`auth`), which are assigned AFTER the loop so they win any name
+ * collision with an operation. All behavior dispatches through the capability seam.
+ */
+export function createClientCore(operations, initial = {}, caps = {}) {
+    // The literal-union narrowing is a compile-time DX contract only; internally the
+    // runtime works with the base (string-typed) context. One cast at this boundary —
+    // `ClientConfig<Narrow>` is not assignable to `ClientConfig` (middleware ctx
+    // params are contravariant).
+    const given = initial;
+    // Private mutable config; the middleware array is copied so `use()` never mutates the caller's.
+    const config = { ...given, middleware: [...(given.middleware ?? [])] };
+    const client = {};
+    for (const [name, op] of Object.entries(operations)) {
+        if (op.responseKind === 'sse') {
+            client[name] = (args = {}, init = {}) => {
+                if (!caps.sse) {
+                    throw new Error(`SSE capability not wired: cannot stream operation "${op.id}"`);
+                }
+                const stream = caps.sse;
+                return (async function* () {
+                    const opCtx = { id: op.id, path: op.path, tags: [...(op.tags ?? [])] };
+                    // A thunk the stream re-runs on every (re)connect, so auth (which `prepareRequest`
+                    // resolves) is refreshed per attempt rather than frozen at the first connect.
+                    const prepare = async () => {
+                        const prepared = await prepareRequest(config, op, args, init, caps);
+                        return { url: prepared.url, init: prepared.init };
+                    };
+                    yield* stream(config, opCtx, prepare, op.sseDataKind ?? 'text');
+                })();
+            };
+        }
+        else {
+            const method = (args = {}, init = {}) => execute(config, op, args, init, caps);
+            const spec = op.pagination;
+            // Paginated ops keep their one-shot call and gain `.pages`/`.items`, dispatching
+            // through the capability seam (like SSE: absent capability throws descriptively).
+            // Iteration is error-mode-agnostic: the iterators' pointers are data-rooted, so on
+            // a result-mode client (`errorMode` is fixed at construction — `configure()`
+            // ignores it) each page's envelope is unwrapped before it reaches the capability.
+            // A failed page aborts iteration by throwing ApiError, even on result-mode
+            // clients; the `onError` middleware hook (throw-mode-only) is not invoked.
+            client[name] = spec
+                ? Object.assign(method, {
+                    pages: (args, init) => paginateCapability(caps, op).pages(pageCall(method, config), spec, args, init),
+                    items: (args, init) => paginateCapability(caps, op).items(pageCall(method, config), spec, args, init),
+                })
+                : method;
+        }
+    }
+    // Core members are assigned AFTER the operation loop — they win over colliding op names.
+    client.configure = (next) => {
+        // `errorMode` is fixed at generate time (it shapes the static types); flipping it at
+        // runtime would silently desync return shapes from `Client<Ops>`, so it is ignored.
+        const { errorMode: _fixed, auth, ...rest } = next;
+        Object.assign(config, rest);
+        // `auth` merges into existing credentials (like the `auth.*` setters) rather than
+        // replacing wholesale — so `configure({ auth: { bearer } })` keeps a previously set
+        // basic/apiKey. `apiKey` merges per scheme.
+        if (auth) {
+            config.auth = {
+                ...config.auth,
+                ...auth,
+                ...(auth.apiKey ? { apiKey: { ...config.auth?.apiKey, ...auth.apiKey } } : {}),
+            };
+        }
+    };
+    client.use = (...middleware) => {
+        // Reassign (don't push) so a caller-provided `middleware` array isn't mutated.
+        config.middleware = [...(config.middleware ?? []), ...middleware];
+    };
+    client.auth = {
+        bearer(token) {
+            config.auth = { ...config.auth, bearer: token };
+        },
+        basic(username, password) {
+            config.auth = { ...config.auth, basic: { username, password } };
+        },
+        apiKey(scheme, value) {
+            config.auth = { ...config.auth, apiKey: { ...config.auth?.apiKey, [scheme]: value } };
+        },
+    };
+    return client;
+}
+//# sourceMappingURL=create-client.js.map

package/lib/runtime/create-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.js","sourceRoot":"","sources":["../../src/runtime/create-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAyB,MAAM,WAAW,CAAC;AAkBzF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAmB,MAAM,UAAU,CAAC;AA2CrE,8FAA8F;AAC9F,SAAS,OAAO,CAAC,EAAuB;IACtC,IAAI,EAAE,CAAC,YAAY,KAAK,MAAM,IAAI,EAAE,CAAC,YAAY,KAAK,MAAM,IAAI,EAAE,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QAC3F,OAAO,EAAE,CAAC,YAAY,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gGAAgG;AAChG,SAAS,SAAS,CAAC,EAAuB,EAAE,IAAmB;IAC7D,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,EAAuB;IAC1C,IAAI,MAA8C,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,EAAE,KAAK,OAAO;YAAE,SAAS;QACnC,MAAM,QAAQ,GACZ,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC;YACrD,KAAK,CAAC,OAAO,KAAK,KAAK;YACvB,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;QAC/B,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,KAAK,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,MAAM;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;YAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uEAAuE;AACvE,SAAS,aAAa,CAAC,OAA4C;IACjE,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QACzD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6FAA6F;AAC7F,KAAK,UAAU,cAAc,CAC3B,MAAoB,EACpB,EAAuB,EACvB,IAAmB,EACnB,IAAiC,EACjC,IAAkB;IAElB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,MAAM,GACV,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,IAAI,CAAC,WAAW;QACrC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC7C,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACjC,MAAM,SAAS,GAA+B,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,QAAQ,CAClB,MAAM,CAAC,SAAS,IAAI,EAAE,EACtB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAC7B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EACzD,WAAW,CAAC,EAAE,CAAC,CAChB,CAAC;IACF,MAAM,UAAU,GAAmB;QACjC,GAAG,IAAI;QACP,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;QAC/B,6EAA6E;QAC7E,4EAA4E;QAC5E,OAAO,EAAE;YACP,GAAG,MAAM,CAAC,OAAO;YACjB,GAAG,aAAa,CAAC,OAAO,CAAC;YACzB,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;SAChC;KACF,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,wEAAwE;AACxE,KAAK,UAAU,OAAO,CACpB,MAAoB,EACpB,EAAuB,EACvB,IAAmB,EACnB,IAAoB,EACpB,IAAkB;IAElB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACpE,MAAM,KAAK,GAAqB,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACzF,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC/C,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CACtC,MAAM,EACN,KAAK,EACL,QAAQ,CAAC,GAAG,EACZ,QAAQ,EACR,QAAQ,CAAC,IAAI,EACb,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,EAC3B,IAAI,CACL,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;QACzE,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAI,KAAK,GAAqB,IAAI,QAAQ,CACxC,OAAO,CAAC,GAAG,EACX,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,UAAU,EACnB,MAAM,SAAS,CAAC,QAAQ,CAAC,CAC1B,CAAC;QACF,oFAAoF;QACpF,KAAK,MAAM,EAAE,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;YACzC,IAAI,EAAE,CAAC,OAAO;gBAAE,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,KAAqB,EAAE,OAAO,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,+FAA+F;AAC/F,SAAS,kBAAkB,CAAC,IAAkB,EAAE,EAAuB;IACrE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,8DAA8D,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CACf,MAAyE,EACzE,MAAoB;IAEpB,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACjD,OAAO,KAAK,EAAE,IAAoB,EAAE,IAAqB,EAAE,EAAE;QAC3D,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAIzC,CAAC;QACF,mFAAmF;QACnF,+EAA+E;QAC/E,gFAAgF;QAChF,iFAAiF;QACjF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAC1B,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;YAC9B,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAM9B,UAA+C,EAC/C,UAAyD,EAAE,EAC3D,OAAqB,EAAE;IAEvB,iFAAiF;IACjF,kFAAkF;IAClF,6EAA6E;IAC7E,6BAA6B;IAC7B,MAAM,KAAK,GAAG,OAAuB,CAAC;IACtC,gGAAgG;IAChG,MAAM,MAAM,GAAiB,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACrF,MAAM,MAAM,GAAG,EAA6B,CAAC;IAE7C,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,IAAI,EAAE,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAsB,EAAE,EAAE,OAAmB,EAAE,EAAE,EAAE;gBACjE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;oBACd,MAAM,IAAI,KAAK,CAAC,sDAAsD,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAClF,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC;gBACxB,OAAO,CAAC,KAAK,SAAS,CAAC;oBACrB,MAAM,KAAK,GAAqB,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;oBACzF,mFAAmF;oBACnF,8EAA8E;oBAC9E,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;wBACzB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;wBACpE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAkB,EAAE,CAAC;oBAClE,CAAC,CAAC;oBACF,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC;gBAClE,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,CAAC,OAAsB,EAAE,EAAE,OAAuB,EAAE,EAAE,EAAE,CACrE,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACxC,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC;YAC3B,iFAAiF;YACjF,kFAAkF;YAClF,mFAAmF;YACnF,6EAA6E;YAC7E,kFAAkF;YAClF,2EAA2E;YAC3E,2EAA2E;YAC3E,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI;gBACjB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;oBACpB,KAAK,EAAE,CAAC,IAAoB,EAAE,IAAqB,EAAE,EAAE,CACrD,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;oBAChF,KAAK,EAAE,CAAC,IAAoB,EAAE,IAAqB,EAAE,EAAE,CACrD,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;iBACjF,CAAC;gBACJ,CAAC,CAAC,MAAM,CAAC;QACb,CAAC;IACH,CAAC;IAED,yFAAyF;IACzF,MAAM,CAAC,SAAS,GAAG,CAAC,IAAkB,EAAQ,EAAE;QAC9C,qFAAqF;QACrF,oFAAoF;QACpF,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5B,kFAAkF;QAClF,oFAAoF;QACpF,4CAA4C;QAC5C,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,GAAG;gBACZ,GAAG,MAAM,CAAC,IAAI;gBACd,GAAG,IAAI;gBACP,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IACF,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,UAAwB,EAAQ,EAAE;QACjD,+EAA+E;QAC/E,MAAM,CAAC,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC;IACpE,CAAC,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,MAAM,CAAC,KAAoB;YACzB,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,QAAgB,EAAE,QAAgB;YACtC,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC;QAClE,CAAC;QACD,MAAM,CAAC,MAAc,EAAE,KAAoB;YACzC,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACxF,CAAC;KACF,CAAC;IAEF,OAAO,MAAsD,CAAC;AAChE,CAAC"}