@redocly/client-generator 0.0.0-snapshot.1784554531

package/lib/emitters/operation-signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-signature.js","sourceRoot":"","sources":["../../src/emitters/operation-signature.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,oFAAoF;AACpF,qFAAqF;AACrF,4FAA4F;AAG5F,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAoB1C,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,EAAkB;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAU,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7F,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9C,OAAO;QACL,UAAU;QACV,QAAQ;QACR,OAAO;QACP,UAAU;QACV,SAAS,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,IAAI,OAAO,IAAI,UAAU;QACrE,YAAY,EACV,UAAU,CAAC,MAAM,GAAG,CAAC;YACrB,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YACtC,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,IAAI,KAAK,CAAC;YACnC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QACzC,iBAAiB,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW;KACrD,CAAC;AACJ,CAAC"}

package/lib/emitters/operation-types.d.ts

@@ -0,0 +1,32 @@
+import type { ParamModel, RequestBodyModel, ResponseBodyModel } from '../intermediate-representation/model.js';
+import { ts } from './ts.js';
+import { type DateType } from './types.js';
+/** A `<name>: <type>` parameter, defaulting to `= {}` when `withDefault`. */
+export declare function simpleParam(name: string, type: ts.TypeNode, withDefault: boolean): ts.ParameterDeclaration;
+/**
+ * A `<slot>: { … }` argument bundling `params` into one object, each property
+ * carrying its own JSDoc (description + metadata). Defaults to `= {}` when every
+ * property is optional. Shared by the query `params` and the operation `headers`
+ * slots, which have the identical layout.
+ */
+export declare function renderParamsObjectArg(slot: string, params: ParamModel[], dateType: DateType): ts.ParameterDeclaration;
+/** The `{ … }` type literal for a params object (query or headers), with per-prop JSDoc. */
+export declare function paramsTypeLiteral(params: ParamModel[], dateType: DateType): ts.TypeLiteralNode;
+/** A bare identifier key when valid, a quoted string-literal key otherwise. */
+export declare function propertyKey(safe: string): ts.PropertyName;
+/**
+ * A multipart body whose schema is a concrete object — the case worth typing. Such a body
+ * is emitted as its object shape (binary fields → `Blob`); the runtime serializes it to
+ * `FormData` (`runtime/multipart.ts`) after the onRequest chain. Multipart bodies with a
+ * non-object schema can't be typed field-by-field, so they keep the raw `FormData` escape hatch.
+ */
+export declare function isTypedMultipart(rb: RequestBodyModel): boolean;
+/** The request-body TS type: special wrapper types per content-type, else the schema. */
+export declare function bodyTypeNode(rb: RequestBodyModel, dateType: DateType): ts.TypeNode;
+/** The deduped error-response body type nodes (by printed form), or `[]` when none. */
+export declare function errorTypeNodes(responses: ResponseBodyModel[], dateType: DateType): ts.TypeNode[];
+export declare function computeResponse(responses: ResponseBodyModel[], dateType: DateType): {
+    responseType: ts.TypeNode;
+    responseKind: 'json' | 'blob' | 'text' | 'void';
+};
+//# sourceMappingURL=operation-types.d.ts.map

package/lib/emitters/operation-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.d.ts","sourceRoot":"","sources":["../../src/emitters/operation-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAqB,EAAE,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,KAAK,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAI7D,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,EAAE,CAAC,QAAQ,EACjB,WAAW,EAAE,OAAO,GACnB,EAAE,CAAC,oBAAoB,CASzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAAE,EACpB,QAAQ,EAAE,QAAQ,GACjB,EAAE,CAAC,oBAAoB,CAEzB;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,EAAE,CAAC,eAAe,CAa9F;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC,YAAY,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAE9D;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAelF;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,SAAS,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAWhG;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,iBAAiB,EAAE,EAC9B,QAAQ,EAAE,QAAQ,GACjB;IACD,YAAY,EAAE,EAAE,CAAC,QAAQ,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACjD,CAqCA"}

package/lib/emitters/operation-types.js

@@ -0,0 +1,117 @@
+// TypeScript type/parameter builders shared by the operation emitter and the operation-alias
+// builders: turn an operation's params / body / responses into `ts` type and parameter nodes.
+// Leaf module — depends only on the IR types and the codegen foundation, never back on operations.ts.
+import { safeIdent } from './identifier.js';
+import { jsdocText } from './jsdoc.js';
+import { jsdoc, printNodes, ts } from './ts.js';
+import { schemaToTypeNode } from './types.js';
+const { factory } = ts;
+/** A `<name>: <type>` parameter, defaulting to `= {}` when `withDefault`. */
+export function simpleParam(name, type, withDefault) {
+    return factory.createParameterDeclaration(undefined, undefined, name, undefined, type, withDefault ? factory.createObjectLiteralExpression([], false) : undefined);
+}
+/**
+ * A `<slot>: { … }` argument bundling `params` into one object, each property
+ * carrying its own JSDoc (description + metadata). Defaults to `= {}` when every
+ * property is optional. Shared by the query `params` and the operation `headers`
+ * slots, which have the identical layout.
+ */
+export function renderParamsObjectArg(slot, params, dateType) {
+    return simpleParam(slot, paramsTypeLiteral(params, dateType), !params.some((p) => p.required));
+}
+/** The `{ … }` type literal for a params object (query or headers), with per-prop JSDoc. */
+export function paramsTypeLiteral(params, dateType) {
+    return factory.createTypeLiteralNode(params.map((p) => {
+        const sig = factory.createPropertySignature(undefined, propertyKey(safeIdent(p.name)), p.required ? undefined : factory.createToken(ts.SyntaxKind.QuestionToken), schemaToTypeNode(p.schema, dateType));
+        const doc = jsdocText(p.description, p.schema.metadata);
+        return doc === undefined ? sig : jsdoc(sig, doc);
+    }));
+}
+/** A bare identifier key when valid, a quoted string-literal key otherwise. */
+export function propertyKey(safe) {
+    return safe.startsWith('"')
+        ? factory.createStringLiteral(JSON.parse(safe))
+        : factory.createIdentifier(safe);
+}
+/**
+ * A multipart body whose schema is a concrete object — the case worth typing. Such a body
+ * is emitted as its object shape (binary fields → `Blob`); the runtime serializes it to
+ * `FormData` (`runtime/multipart.ts`) after the onRequest chain. Multipart bodies with a
+ * non-object schema can't be typed field-by-field, so they keep the raw `FormData` escape hatch.
+ */
+export function isTypedMultipart(rb) {
+    return rb.contentType === 'multipart/form-data' && rb.schema.kind === 'object';
+}
+/** The request-body TS type: special wrapper types per content-type, else the schema. */
+export function bodyTypeNode(rb, dateType) {
+    if (isTypedMultipart(rb))
+        return schemaToTypeNode(rb.schema, dateType);
+    switch (rb.contentType) {
+        case 'multipart/form-data':
+            return factory.createTypeReferenceNode('FormData');
+        case 'application/x-www-form-urlencoded':
+            return factory.createTypeReferenceNode('URLSearchParams');
+        case 'application/octet-stream':
+            return factory.createUnionTypeNode([
+                factory.createTypeReferenceNode('Blob'),
+                factory.createTypeReferenceNode('ArrayBuffer'),
+            ]);
+        default:
+            return schemaToTypeNode(rb.schema, dateType);
+    }
+}
+/** The deduped error-response body type nodes (by printed form), or `[]` when none. */
+export function errorTypeNodes(responses, dateType) {
+    const seen = new Set();
+    const nodes = [];
+    for (const r of responses) {
+        const node = schemaToTypeNode(r.schema, dateType);
+        const key = printNodes([node]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        nodes.push(node);
+    }
+    return nodes;
+}
+export function computeResponse(responses, dateType) {
+    if (responses.length === 0)
+        return {
+            responseType: factory.createKeywordTypeNode(ts.SyntaxKind.VoidKeyword),
+            responseKind: 'void',
+        };
+    // Prefer JSON; fall back to other content types.
+    const jsonResponse = responses.find((r) => r.contentType.toLowerCase().includes('json'));
+    if (jsonResponse) {
+        return { responseType: schemaToTypeNode(jsonResponse.schema, dateType), responseKind: 'json' };
+    }
+    // No JSON — handle binary/text gracefully.
+    const nodes = [];
+    const seen = new Set();
+    let hasBinary = false;
+    let hasText = false;
+    for (const r of responses) {
+        let node;
+        if (r.contentType.startsWith('image/') || r.contentType === 'application/octet-stream') {
+            node = factory.createTypeReferenceNode('Blob');
+            hasBinary = true;
+        }
+        else if (r.contentType.startsWith('text/')) {
+            node = factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword);
+            hasText = true;
+        }
+        else {
+            node = schemaToTypeNode(r.schema, dateType);
+        }
+        const key = printNodes([node]);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        nodes.push(node);
+    }
+    // `nodes` is guaranteed non-empty here: each iteration above always builds one.
+    const responseType = nodes.length === 1 ? nodes[0] : factory.createUnionTypeNode(nodes);
+    const responseKind = hasBinary ? 'blob' : hasText ? 'text' : 'json';
+    return { responseType, responseKind };
+}
+//# sourceMappingURL=operation-types.js.map

package/lib/emitters/operation-types.js.map

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

package/lib/emitters/operations.d.ts

@@ -0,0 +1,39 @@
+import type { OperationModel, ParamModel } from '../intermediate-representation/model.js';
+import type { ModelPagination } from './pagination.js';
+import { ts } from './ts.js';
+import { type DateType } from './types.js';
+/** Error-handling shape of the generated client: throw on non-2xx, or return a result union. */
+export type ErrorMode = 'throw' | 'result';
+/**
+ * How an operation's inputs are passed to the generated call.
+ * - `'flat'` (default): path params spread as positional args, then the
+ *   `params`/`body`/`headers` slots — one exported sugar arrow per operation.
+ * - `'grouped'`: the client methods' own shape — a single `args` object bundling
+ *   every input; the sugar is a plain destructure of the client. The per-call
+ *   `init: RequestOptions` stays a separate trailing argument in both styles.
+ */
+export type ArgsStyle = 'flat' | 'grouped';
+/**
+ * The emit configuration every operation shares. Bundling it into one value keeps
+ * it out of the positional parameter lists of the operation emitters (which would
+ * otherwise thread the same arguments through every layer, inviting transposition
+ * bugs). Per-call structural data (response type, ordered path params, …) stays an
+ * explicit argument; only this cross-cutting config travels as `ctx`.
+ */
+export type EmitContext = {
+    argsStyle: ArgsStyle;
+    errorMode: ErrorMode;
+    dateType: DateType;
+    /** Names of every exported schema, used for `<Op>*` alias collision suppression. */
+    schemaNames: Set<string>;
+    /** Resolved auto-pagination per operation name (absent ⇒ nothing paginates). */
+    pagination?: ModelPagination;
+};
+/**
+ * The flat sugar's parameter list: path params spread as positional args (in URL
+ * template order), then the `params`/`body`/`headers` slots, ending with the
+ * trailing `init: RequestOptions` (`SseOptions` for streams). Optional slots
+ * default to `= {}` so trailing arguments can be omitted.
+ */
+export declare function renderArgList(op: OperationModel, orderedPathParams: ParamModel[], pathParamIdent: Map<string, string>, ctx: EmitContext): ts.ParameterDeclaration[];
+//# sourceMappingURL=operations.d.ts.map

package/lib/emitters/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/emitters/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAE1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,KAAK,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAI7D,gGAAgG;AAChG,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,oFAAoF;IACpF,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,gFAAgF;IAChF,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,cAAc,EAClB,iBAAiB,EAAE,UAAU,EAAE,EAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,GAAG,EAAE,WAAW,GACf,EAAE,CAAC,oBAAoB,EAAE,CAoC3B"}

package/lib/emitters/operations.js

@@ -0,0 +1,33 @@
+import { bodyTypeNode, renderParamsObjectArg, simpleParam } from './operation-types.js';
+import { isSseOp } from './sse.js';
+import { ts } from './ts.js';
+import { schemaToTypeNode } from './types.js';
+const { factory } = ts;
+/**
+ * The flat sugar's parameter list: path params spread as positional args (in URL
+ * template order), then the `params`/`body`/`headers` slots, ending with the
+ * trailing `init: RequestOptions` (`SseOptions` for streams). Optional slots
+ * default to `= {}` so trailing arguments can be omitted.
+ */
+export function renderArgList(op, orderedPathParams, pathParamIdent, ctx) {
+    const { dateType } = ctx;
+    const args = [];
+    for (const p of orderedPathParams) {
+        args.push(simpleParam(pathParamIdent.get(p.name), schemaToTypeNode(p.schema, dateType), false));
+    }
+    if (op.queryParams.length > 0)
+        args.push(renderParamsObjectArg('params', op.queryParams, dateType));
+    if (op.requestBody) {
+        const type = bodyTypeNode(op.requestBody, dateType);
+        args.push(factory.createParameterDeclaration(undefined, undefined, 'body', op.requestBody.required ? undefined : factory.createToken(ts.SyntaxKind.QuestionToken), type));
+    }
+    // Operation header params are explicit, typed inputs; security-scheme headers
+    // are injected by the runtime and live underneath them.
+    if (op.headerParams.length > 0)
+        args.push(renderParamsObjectArg('headers', op.headerParams, dateType));
+    // SSE ops take per-stream `SseOptions` (reconnect knobs); everyone else the
+    // standard per-call `RequestOptions`.
+    args.push(simpleParam('init', factory.createTypeReferenceNode(isSseOp(op) ? 'SseOptions' : 'RequestOptions'), true));
+    return args;
+}
+//# sourceMappingURL=operations.js.map

package/lib/emitters/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/emitters/operations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAiB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAgCvB;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,EAAkB,EAClB,iBAA+B,EAC/B,cAAmC,EACnC,GAAgB;IAEhB,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;IACzB,MAAM,IAAI,GAA8B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CACP,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,CACtF,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CACP,OAAO,CAAC,0BAA0B,CAChC,SAAS,EACT,SAAS,EACT,MAAM,EACN,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EACtF,IAAI,CACL,CACF,CAAC;IACJ,CAAC;IACD,8EAA8E;IAC9E,wDAAwD;IACxD,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,4EAA4E;IAC5E,sCAAsC;IACtC,IAAI,CAAC,IAAI,CACP,WAAW,CACT,MAAM,EACN,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAC9E,IAAI,CACL,CACF,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/emitters/pagination.d.ts

@@ -0,0 +1,69 @@
+import { type ApiModel, type OperationModel, type SchemaModel } from '../intermediate-representation/model.js';
+import type { PaginationSpec } from '../runtime/types.js';
+/** The pagination styles the generated runtime can drive. */
+export type PaginationStyle = 'cursor' | 'offset' | 'page';
+/**
+ * One user-facing pagination rule — the shared shape of the `x-pagination` operation
+ * extension and every `pagination` config rule. `nextCursor` and `items` are RFC 6901
+ * JSON pointers (starting with `/`) into the operation's success response.
+ */
+export type PaginationRule = {
+    /** `cursor` follows a response cursor; `offset`/`page` increment a numeric param. */
+    style: PaginationStyle;
+    /** Cursor style: the request query param that receives the cursor. */
+    cursorParam?: string;
+    /** Cursor style: JSON pointer to the next cursor in the response. */
+    nextCursor?: string;
+    /** Offset/page styles: the request query param the iterator advances. */
+    offsetParam?: string;
+    /** Optional page-size query param (any style; recorded for tooling). */
+    limitParam?: string;
+    /** JSON pointer to the page's item array in the response. */
+    items: string;
+};
+/**
+ * The `pagination` config block: an optional convention rule (the top-level rule
+ * fields, applied to every operation it structurally fits when `style` is set), plus
+ * per-operation overrides and exclusions. Precedence per operation:
+ * `operations[id]` > the spec's `x-pagination` extension > the convention rule.
+ */
+export type PaginationConfig = Partial<PaginationRule> & {
+    /** operationIds no source may paginate. */
+    exclude?: string[];
+    /** Per-operation rules, keyed by operationId (beat `x-pagination` and the convention). */
+    operations?: Record<string, PaginationRule>;
+};
+/** One operation's resolution: the normalized spec + item element schema, or an error. */
+export type ResolvedPagination = {
+    spec?: PaginationSpec;
+    itemSchema?: SchemaModel;
+    error?: string;
+};
+/** Every paginated operation's spec + item schema, keyed by operation name. */
+export type ModelPagination = Map<string, {
+    spec: PaginationSpec;
+    itemSchema: SchemaModel;
+}>;
+/**
+ * Resolve one operation's pagination across the three sources (per-op config >
+ * `x-pagination` > convention); `config.exclude` kills all of them. Returns the
+ * normalized spec + the item element schema, `{}` when the operation doesn't paginate
+ * (no source, or a convention that doesn't fit), or an `error` for a malformed rule
+ * (any source) and for an explicit rule that doesn't fit the operation.
+ */
+export declare function resolveOperationPagination(op: OperationModel, model: ApiModel, config: PaginationConfig | undefined): ResolvedPagination;
+/**
+ * Resolve pagination for every operation of the model. Errors (malformed rules,
+ * explicit rules that don't fit) are aggregated into ONE throw listing every
+ * failing operation, so a generate run reports the whole problem set at once.
+ */
+export declare function resolveModelPagination(model: ApiModel, config: PaginationConfig | undefined): ModelPagination;
+/**
+ * Resolve an RFC 6901 JSON pointer (`~1` → `/`, `~0` → `~`) over a schema, walking the
+ * VALUE shape it describes: object property steps by name, record values for any token,
+ * array items for numeric tokens, with `ref` steps resolved through the model's named
+ * schemas (cycle-guarded). Unions and intersections bail (v1 is strict). Returns
+ * `undefined` on any miss — the caller decides whether that is an error.
+ */
+export declare function resolveSchemaPointer(schema: SchemaModel, pointer: string, model: ApiModel): SchemaModel | undefined;
+//# sourceMappingURL=pagination.d.ts.map

package/lib/emitters/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/emitters/pagination.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,qFAAqF;IACrF,KAAK,EAAE,eAAe,CAAC;IACvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG;IACvD,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AAE7F;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,kBAAkB,CAepB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,eAAe,CAcjB;AA+GD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,GACd,WAAW,GAAG,SAAS,CAmBzB"}

package/lib/emitters/pagination.js

@@ -0,0 +1,223 @@
+// Auto-pagination resolution: turns config rules and `x-pagination` extensions into the
+// normalized descriptor `PaginationSpec`, statically VERIFYING each rule fits its
+// operation (the advance param is a declared query param whose schema fits the style —
+// string-ish for `cursor`, a numeric scalar for `offset`/`page`; the JSON pointers
+// resolve over the success response schema). A convention rule that doesn't fit silently skips the
+// operation; an explicit rule (per-op config or extension) that doesn't fit — and a
+// malformed rule from ANY source — is a generate-time error. No heuristics, ever.
+import { isPlainObject } from '@redocly/openapi-core';
+import { allOperations, } from '../intermediate-representation/model.js';
+import { isSseOp } from './sse.js';
+/**
+ * Resolve one operation's pagination across the three sources (per-op config >
+ * `x-pagination` > convention); `config.exclude` kills all of them. Returns the
+ * normalized spec + the item element schema, `{}` when the operation doesn't paginate
+ * (no source, or a convention that doesn't fit), or an `error` for a malformed rule
+ * (any source) and for an explicit rule that doesn't fit the operation.
+ */
+export function resolveOperationPagination(op, model, config) {
+    const configName = op.specName ?? op.name;
+    if (config?.exclude?.includes(configName))
+        return {};
+    const perOp = config?.operations?.[configName];
+    if (perOp !== undefined) {
+        return applyRule(op, model, perOp, `pagination.operations["${configName}"]`, true);
+    }
+    if (op.paginationExtension !== undefined) {
+        return applyRule(op, model, op.paginationExtension, 'x-pagination', true);
+    }
+    if (config?.style !== undefined) {
+        const { exclude: _exclude, operations: _operations, ...convention } = config;
+        return applyRule(op, model, convention, 'pagination convention', false);
+    }
+    return {};
+}
+/**
+ * Resolve pagination for every operation of the model. Errors (malformed rules,
+ * explicit rules that don't fit) are aggregated into ONE throw listing every
+ * failing operation, so a generate run reports the whole problem set at once.
+ */
+export function resolveModelPagination(model, config) {
+    const resolved = new Map();
+    const errors = [];
+    for (const op of allOperations(model.services)) {
+        const result = resolveOperationPagination(op, model, config);
+        if (result.error !== undefined)
+            errors.push(result.error);
+        else if (result.spec !== undefined) {
+            resolved.set(op.name, { spec: result.spec, itemSchema: result.itemSchema });
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(['Invalid pagination configuration:', ...errors].join('\n  - '));
+    }
+    return resolved;
+}
+/** Validate the rule's shape and fit, then normalize it into a descriptor spec. */
+function applyRule(op, model, rule, source, explicit) {
+    const label = `Pagination for operation "${op.name}" (${source})`;
+    // Shape problems are errors from EVERY source — a malformed convention is a config bug.
+    const shapeProblem = ruleShapeProblem(rule);
+    if (shapeProblem !== undefined)
+        return { error: `${label}: ${shapeProblem}` };
+    const valid = rule;
+    // Fit problems: explicit declarations fail generation; a convention silently skips.
+    const misfit = (problem) => explicit ? { error: `${label}: ${problem}` } : {};
+    if (isSseOp(op))
+        return misfit('the operation is a Server-Sent Events stream');
+    const paramField = valid.style === 'cursor' ? 'cursorParam' : 'offsetParam';
+    const param = valid.style === 'cursor' ? valid.cursorParam : valid.offsetParam;
+    const advance = op.queryParams.find((p) => p.name === param);
+    if (!advance) {
+        return misfit(`query parameter "${param}" is not declared on the operation`);
+    }
+    // The advance param must accept what the runtime sends: the response's cursor
+    // (string-ish, same predicate as nextCursor) or the incremented number.
+    const advanceSchema = deref(advance.schema, model);
+    const advanceFits = advanceSchema !== undefined &&
+        (valid.style === 'cursor'
+            ? isStringish(advanceSchema, model)
+            : advanceSchema.kind === 'scalar' &&
+                (advanceSchema.scalar === 'number' || advanceSchema.scalar === 'integer'));
+    if (!advanceFits) {
+        const expected = valid.style === 'cursor' ? 'a string' : 'a number';
+        return misfit(`the "${paramField}" query parameter "${param}" must accept ${expected} (got ${describeSchema(advanceSchema)})`);
+    }
+    // The page the pointers address is the operation's primary JSON success response —
+    // the same response `computeResponse` types (JSON preferred over other content types).
+    const page = op.successResponses.find((r) => r.contentType.toLowerCase().includes('json'));
+    if (!page)
+        return misfit('the operation has no JSON success response');
+    const itemsTarget = resolveSchemaPointer(page.schema, valid.items, model);
+    if (itemsTarget === undefined) {
+        return misfit(`the "items" pointer "${valid.items}" does not resolve in the success response schema`);
+    }
+    if (itemsTarget.kind !== 'array') {
+        return misfit(`the "items" pointer "${valid.items}" must point at an array (got ${itemsTarget.kind})`);
+    }
+    if (valid.style === 'cursor') {
+        const cursorTarget = resolveSchemaPointer(page.schema, valid.nextCursor, model);
+        if (cursorTarget === undefined) {
+            return misfit(`the "nextCursor" pointer "${valid.nextCursor}" does not resolve in the success response schema`);
+        }
+        if (!isStringish(cursorTarget, model)) {
+            return misfit(`the "nextCursor" pointer "${valid.nextCursor}" must point at a string (got ${cursorTarget.kind})`);
+        }
+    }
+    return {
+        spec: {
+            style: valid.style,
+            param,
+            ...(valid.limitParam !== undefined ? { limitParam: valid.limitParam } : {}),
+            ...(valid.style === 'cursor' ? { nextCursor: valid.nextCursor } : {}),
+            items: valid.items,
+        },
+        itemSchema: itemsTarget.items,
+    };
+}
+/**
+ * The rule's structural problem, or `undefined` when it is a well-formed
+ * `PaginationRule`. Works over `unknown` — the extension is arbitrary spec data and
+ * config arrives from YAML, so both are checked field-by-field.
+ */
+function ruleShapeProblem(rule) {
+    if (!isPlainObject(rule))
+        return 'the rule must be an object';
+    const { style, cursorParam, nextCursor, offsetParam, limitParam, items } = rule;
+    if (style !== 'cursor' && style !== 'offset' && style !== 'page') {
+        return `"style" must be one of "cursor" | "offset" | "page" (got ${JSON.stringify(style)})`;
+    }
+    if (typeof items !== 'string' || !items.startsWith('/')) {
+        return '"items" must be a JSON pointer starting with "/"';
+    }
+    if (style === 'cursor') {
+        if (typeof cursorParam !== 'string' || cursorParam === '') {
+            return 'cursor style requires a "cursorParam" query parameter name';
+        }
+        if (typeof nextCursor !== 'string' || !nextCursor.startsWith('/')) {
+            return 'cursor style requires a "nextCursor" JSON pointer starting with "/"';
+        }
+    }
+    else if (typeof offsetParam !== 'string' || offsetParam === '') {
+        return `${style} style requires an "offsetParam" query parameter name`;
+    }
+    if (limitParam !== undefined && typeof limitParam !== 'string') {
+        return '"limitParam" must be a query parameter name';
+    }
+    return undefined;
+}
+/**
+ * Resolve an RFC 6901 JSON pointer (`~1` → `/`, `~0` → `~`) over a schema, walking the
+ * VALUE shape it describes: object property steps by name, record values for any token,
+ * array items for numeric tokens, with `ref` steps resolved through the model's named
+ * schemas (cycle-guarded). Unions and intersections bail (v1 is strict). Returns
+ * `undefined` on any miss — the caller decides whether that is an error.
+ */
+export function resolveSchemaPointer(schema, pointer, model) {
+    let current = deref(schema, model);
+    if (current === undefined || (pointer !== '' && !pointer.startsWith('/')))
+        return undefined;
+    if (pointer === '')
+        return current;
+    for (const token of pointer.slice(1).split('/')) {
+        const key = token.replaceAll('~1', '/').replaceAll('~0', '~');
+        let next;
+        if (current.kind === 'object') {
+            next = current.properties.find((p) => p.name === key)?.schema;
+        }
+        else if (current.kind === 'record') {
+            next = current.value;
+        }
+        else if (current.kind === 'array' && /^(0|[1-9]\d*)$/.test(key)) {
+            next = current.items;
+        }
+        if (next === undefined)
+            return undefined;
+        current = deref(next, model);
+        if (current === undefined)
+            return undefined;
+    }
+    return current;
+}
+/** A (dereferenced) schema named for a fit-error message; scalars/enums by their scalar. */
+function describeSchema(schema) {
+    if (schema === undefined)
+        return 'an unresolvable ref';
+    return schema.kind === 'scalar' || schema.kind === 'enum' ? schema.scalar : schema.kind;
+}
+/** Follow a `ref` chain through the model's named schemas; `undefined` on a miss or cycle. */
+function deref(schema, model) {
+    const seen = new Set();
+    let current = schema;
+    while (current.kind === 'ref') {
+        const { name } = current;
+        if (seen.has(name))
+            return undefined;
+        seen.add(name);
+        const named = model.schemas.find((s) => s.name === name);
+        if (named === undefined)
+            return undefined;
+        current = named.schema;
+    }
+    return current;
+}
+/**
+ * Whether a (dereferenced) schema is string-ish per the cursor contract: a string
+ * scalar, an enum of strings, or a literal string — nullable ok (a union whose members
+ * are `null` or string-ish leaves; nested unions stay out, v1 is strict).
+ */
+function isStringish(schema, model) {
+    if (schema.kind === 'scalar' || schema.kind === 'enum')
+        return schema.scalar === 'string';
+    if (schema.kind === 'literal')
+        return typeof schema.value === 'string';
+    if (schema.kind === 'union') {
+        return schema.members.every((member) => {
+            const resolved = deref(member, model);
+            return (resolved !== undefined &&
+                (resolved.kind === 'null' || (resolved.kind !== 'union' && isStringish(resolved, model))));
+        });
+    }
+    return false;
+}
+//# sourceMappingURL=pagination.js.map

package/lib/emitters/pagination.js.map

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