@redocly/client-generator 0.3.8 → 0.4.0

package/lib/generators/{tanstack-query.d.ts → tanstack-query/index.d.ts}

@@ -1,4 +1,4 @@
-import type { Generator } from './types.js';
+import type { Generator } from '@redocly/client-generator';
 /**
  * The tanstack-query generator: a standalone `<stem>.tanstack.ts` module of
  * TanStack Query v5 factories over the generated client — `<op>QueryKey`/`<op>Options`
@@ -6,7 +6,7 @@ import type { Generator } from './types.js';
  * mutation, all built by `createQueryFactories(c)` (bindable to any client instance)
  * with the module-level exports bound to the sdk's default `client`. It imports the
  * `client` instance + the `<Op>Variables` types from the sdk entry (`./<stem>.js`), so
- * it requires the `sdk` generator and its throw-mode client. The option helpers are
+ * it requires the `typescript` generator and its throw-mode client. The option helpers are
  * imported from `@tanstack/<framework>-query` (the consumer's peer); the registry binds
  * one framework per generator name, and the emitted body is byte-identical across them.
  *
@@ -15,4 +15,4 @@ import type { Generator } from './types.js';
  * no operations.
  */
 export declare function tanstackQueryGenerator(framework: 'react' | 'vue' | 'svelte' | 'solid'): Generator;
-//# sourceMappingURL=tanstack-query.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/lib/generators/tanstack-query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/tanstack-query/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAejG"}

package/lib/generators/{tanstack-query.js → tanstack-query/index.js}

@@ -1,7 +1,5 @@
 import { join } from 'node:path';
-import { HEADER } from '../emitters/emit-options.js';
-import { renderTanstackModule } from '../emitters/tanstack-query.js';
-import { anchor } from './anchor.js';
+import { renderTanstackModule } from "./render.js";
 /**
  * The tanstack-query generator: a standalone `<stem>.tanstack.ts` module of
  * TanStack Query v5 factories over the generated client — `<op>QueryKey`/`<op>Options`
@@ -9,7 +7,7 @@ import { anchor } from './anchor.js';
  * mutation, all built by `createQueryFactories(c)` (bindable to any client instance)
  * with the module-level exports bound to the sdk's default `client`. It imports the
  * `client` instance + the `<Op>Variables` types from the sdk entry (`./<stem>.js`), so
- * it requires the `sdk` generator and its throw-mode client. The option helpers are
+ * it requires the `typescript` generator and its throw-mode client. The option helpers are
  * imported from `@tanstack/<framework>-query` (the consumer's peer); the registry binds
  * one framework per generator name, and the emitted body is byte-identical across them.
  *
@@ -18,17 +16,20 @@ import { anchor } from './anchor.js';
  * no operations.
  */
 export function tanstackQueryGenerator(framework) {
-    return ({ model, outputPath, emit }) => {
-        const { dir, stem } = anchor(outputPath);
+    return ({ model, output, banner, emit, pagination }) => {
         const content = renderTanstackModule(model, {
-            sdkModule: `./${stem}.${emit.importExt ?? 'js'}`,
+            argsStyle: emit.argsStyle ?? 'grouped',
+            sdkModule: `./${output.stem}.${emit.importExt ?? 'js'}`,
             framework,
-            pagination: emit.pagination,
+            pagination,
             queryKeyPrefix: emit.queryKeyPrefix,
         });
         if (content === '')
             return [];
-        return [{ path: join(dir, `${stem}.tanstack.ts`), content: `${HEADER}\n\n${content}` }];
+        const header = banner.map((line) => `// ${line}`).join('\n');
+        return [
+            { path: join(output.dir, `${output.stem}.tanstack.ts`), content: `${header}\n\n${content}` },
+        ];
     };
 }
-//# sourceMappingURL=tanstack-query.js.map
+//# sourceMappingURL=index.js.map

package/lib/generators/tanstack-query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/tanstack-query/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAA+C;IACpF,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;QACrD,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,EAAE;YAC1C,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS;YACtC,SAAS,EAAE,KAAK,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE;YACvD,SAAS;YACT,UAAU;YACV,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC,CAAC;QACH,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO;YACL,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,cAAc,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,OAAO,EAAE,EAAE;SAC7F,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/lib/{emitters/tanstack-query.d.ts → generators/tanstack-query/render.d.ts}

@@ -1,16 +1,17 @@
-import type { ApiModel } from '../intermediate-representation/model.js';
-import { type PaginationConfig } from './pagination.js';
+import { type ApiModel, type ModelPagination } from '@redocly/client-generator';
 export type TanstackOptions = {
     /** Import specifier for the sdk entry the `client` instance and types live in. */
     sdkModule: string;
     /** TanStack adapter to import the option helpers from (`@tanstack/${framework}-query`). */
     framework: 'react' | 'vue' | 'svelte' | 'solid';
-    /** Auto-pagination rules — paginated query ops gain `<op>InfiniteOptions`. */
-    pagination?: PaginationConfig;
+    /** The run's RESOLVED pagination — paginated query ops gain `<op>InfiniteOptions`. */
+    pagination?: ModelPagination;
     /** Leading element for every query/mutation key — namespaces the cache when several
      * generated APIs share one QueryClient (operationIds may collide across APIs). */
     queryKeyPrefix?: string;
+    /** The sdk's call shape — the infinite query overrides the cursor inside it. */
+    argsStyle?: 'grouped' | 'flat';
 };
 /** Render the full TanStack Query module source. `''` when there are no wrappable operations. */
 export declare function renderTanstackModule(model: ApiModel, opts: TanstackOptions): string;
-//# sourceMappingURL=tanstack-query.d.ts.map
+//# sourceMappingURL=render.d.ts.map

package/lib/generators/tanstack-query/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/generators/tanstack-query/render.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EAIrB,MAAM,2BAA2B,CAAC;AAanC,MAAM,MAAM,eAAe,GAAG;IAC5B,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IAChD,sFAAsF;IACtF,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B;sFACkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAChC,CAAC;AAEF,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAWnF"}

package/lib/{emitters/tanstack-query.js → generators/tanstack-query/render.js}

@@ -6,31 +6,29 @@
 // TanStack's abort `signal`. A paginated query op additionally gets
 // `<op>InfiniteOptions(vars, init?)` with `initialPageParam`/`getNextPageParam` compiled
 // from the pagination rule's JSON pointers. Per mutation: `<op>Mutation(init?)`. Calls go
-// through the client instance's grouped methods, so the module is independent of the
-// sdk's `--args-style`.
+// through the client instance's methods, which take one input object in either
+// `--args-style`; only the infinite query's cursor override differs between them.
 //
-// The factory bodies are authored as source text and round-tripped through
-// `parseStatements` → `printStatements`, which validates the syntax at generation time
+// The factory bodies are authored as source text — the emitted module verbatim
 // and normalizes everything to the printer's canonical style. Every interpolated piece
 // is generator-derived (sanitized operation names, JSON-pointer property chains built
 // here) — never raw spec text.
-import { codeString, isSafeIdentifier, safeIdent } from './identifier.js';
-import { resolveModelPagination, resolveSchemaPointer, } from './pagination.js';
-import { parseStatements, printStatements } from './ts.js';
-import { hasInputs, isQuery, variablesName, wrappableOperations } from './wrapper-support.js';
+import { resolveSchemaPointer, } from '@redocly/client-generator';
+import { hasInputs, isQuery, variablesName, wrappableOperations, } from '@redocly/client-generator/contracts/typescript';
+import { codeString, isSafeIdentifier, safeIdent, } from '@redocly/client-generator/printers/typescript';
 /** Render the full TanStack Query module source. `''` when there are no wrappable operations. */
 export function renderTanstackModule(model, opts) {
     const ops = wrappableOperations(model, 'tanstack-query');
     if (ops.length === 0)
         return '';
-    const pagination = resolveModelPagination(model, opts.pagination);
+    const pagination = opts.pagination ?? new Map();
     const source = [
         importHeader(ops, opts, pagination),
         ...ops.filter(isQuery).map((op) => queryKeySource(op, opts.queryKeyPrefix)),
-        factoriesSource(model, ops, pagination, opts.queryKeyPrefix),
+        factoriesSource(model, ops, pagination, opts.queryKeyPrefix, opts.argsStyle),
         ...defaultBindings(ops, pagination),
     ].join('\n');
-    return printStatements(parseStatements(source));
+    return source;
 }
 /**
  * Whether the op gets an `<op>InfiniteOptions` factory: a paginated query operation.
@@ -82,19 +80,19 @@ function keyElements(op, prefix) {
     return prefix === undefined ? `"${op.name}"` : `${codeString(prefix)}, "${op.name}"`;
 }
 /** The `createQueryFactories(instance)` declaration wrapping every option/mutation factory. */
-function factoriesSource(model, ops, pagination, prefix) {
+function factoriesSource(model, ops, pagination, prefix, argsStyle) {
     const members = ops.flatMap((op) => {
         if (!isQuery(op))
             return [mutationMember(op, prefix)];
         const paginated = pagination.get(op.name);
         return paginated !== undefined && paginated.spec.style !== 'link'
-            ? [optionsMember(op), infiniteMember(model, op, paginated.spec)]
+            ? [optionsMember(op), infiniteMember(model, op, paginated.spec, argsStyle)]
             : [optionsMember(op)];
     });
     return ('/**\n' +
         ' * Build the factories over a specific client instance — its config, middleware, and\n' +
         ' * retry apply to every call (`createQueryFactories(createClient(OPERATIONS, config))`).\n' +
-        " * The module-level exports below are these factories bound to the sdk's default `client`.\n" +
+        " * The module-level exports below are these factories bound to the generated module's default `client`.\n" +
         ' */\n' +
         'export const createQueryFactories = (instance: typeof client = client) => ({\n' +
         members.join(',\n') +
@@ -125,18 +123,25 @@ function mutationMember(op, prefix) {
  * conditions (cursor: absent/`null`/`''`, plus the optional `hasMore === false`;
  * offset/page: an empty items page).
  */
-function infiniteMember(model, op, spec) {
+function infiniteMember(model, op, spec, argsStyle) {
     const { params, keyArg } = varsPieces(op);
-    const override = `{ ...vars, params: { ...vars.params, ${safeIdent(spec.param)}: pageParam } }`;
+    // The cursor is a query parameter, so it lands in the sdk's own spelling for one:
+    // inside the `query` layer, or at the top level of a merged call.
+    const cursor = safeIdent(spec.param);
+    const override = argsStyle === 'flat'
+        ? `{ ...vars, ${cursor}: pageParam }`
+        : `{ ...vars, query: { ...vars.query, ${cursor}: pageParam } }`;
     return (`    ${op.name}InfiniteOptions: (${params}) => infiniteQueryOptions({\n` +
         `        queryKey: [...${op.name}QueryKey(${keyArg}), "infinite"] as const,\n` +
         `        queryFn: ({ pageParam, signal }) => instance.${op.name}(${override}, { ...init, signal, envelope: undefined }),\n` +
-        nextPageSource(model, op, spec) +
+        nextPageSource(model, op, spec, argsStyle) +
         `    })`);
 }
 /** The `initialPageParam` + `getNextPageParam` pair for one pagination style. */
-function nextPageSource(model, op, spec) {
+function nextPageSource(model, op, spec, argsStyle) {
     const advance = paramsAccess(spec.param);
+    // Where the caller's own starting value lives, in the sdk's spelling for a query param.
+    const given = argsStyle === 'flat' ? memberAccess('vars', spec.param) : `vars.query?.${advance}`;
     if (spec.style === 'cursor') {
         const stopEarly = spec.hasMore === undefined
             ? ''
@@ -150,7 +155,7 @@ function nextPageSource(model, op, spec) {
             ? `            return lastPage${pointerChain(spec.nextCursor)};\n`
             : `            const next = lastPage${pointerChain(spec.nextCursor)};\n` +
                 `            return ${checks.join(' || ')} ? undefined : next;\n`;
-        return (`        initialPageParam: vars.params?.${advance},\n` +
+        return (`        initialPageParam: ${given},\n` +
             `        getNextPageParam: (lastPage) => {\n` +
             stopEarly +
             body +
@@ -158,7 +163,7 @@ function nextPageSource(model, op, spec) {
     }
     const step = spec.style === 'offset' ? 'lastPageParam + count' : 'lastPageParam + 1';
     const start = spec.style === 'offset' ? '0' : '1';
-    return (`        initialPageParam: vars.params?.${advance} ?? ${start},\n` +
+    return (`        initialPageParam: ${given} ?? ${start},\n` +
         `        getNextPageParam: (lastPage, _allPages, lastPageParam) => {\n` +
         `            const count = ${itemsLength(spec.items)};\n` +
         `            return count === 0 ? undefined : ${step};\n` +
@@ -210,6 +215,13 @@ function varsPieces(op) {
 function paramsAccess(name) {
     return isSafeIdentifier(name) ? name : `[${safeIdent(name)}]`;
 }
+/**
+ * `<base>.name`, or `<base>["wire-name"]` when the name is not an identifier — the dot form
+ * would be a syntax error there. (After `?.` either form appends directly.)
+ */
+function memberAccess(base, name) {
+    return isSafeIdentifier(name) ? `${base}.${name}` : `${base}[${safeIdent(name)}]`;
+}
 /** An RFC 6901 pointer as an optional property chain: `/page/endCursor` → `.page?.endCursor`. */
 function pointerChain(pointer) {
     const keys = pointer
@@ -245,4 +257,4 @@ function defaultBindings(ops, pagination) {
         ...names.map((name) => `export const ${name} = defaultFactories.${name};`),
     ];
 }
-//# sourceMappingURL=tanstack-query.js.map
+//# sourceMappingURL=render.js.map

package/lib/generators/tanstack-query/render.js.map

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

package/lib/generators/{transformers.d.ts → transformers/index.d.ts}

@@ -1,4 +1,4 @@
-import type { Generator } from './types.js';
+import type { Generator } from '@redocly/client-generator';
 /**
  * The transformers generator: a standalone `<stem>.transformers.ts` module of
  * `transform<Name>(data: <Name>): <Name>` functions, one per IR named schema
@@ -16,4 +16,4 @@ import type { Generator } from './types.js';
  * nothing when no schema has a date field (nothing to transform).
  */
 export declare const transformersGenerator: Generator;
-//# sourceMappingURL=transformers.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/lib/generators/transformers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/transformers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAYnC,CAAC"}

package/lib/generators/{transformers.js → transformers/index.js}

@@ -1,7 +1,5 @@
 import { join } from 'node:path';
-import { HEADER } from '../emitters/emit-options.js';
-import { renderTransformersModule } from '../emitters/transformers.js';
-import { anchor } from './anchor.js';
+import { renderTransformersModule } from "./render.js";
 /**
  * The transformers generator: a standalone `<stem>.transformers.ts` module of
  * `transform<Name>(data: <Name>): <Name>` functions, one per IR named schema
@@ -18,13 +16,18 @@ import { anchor } from './anchor.js';
  * beside the client regardless of how the sdk partitions its files. Emits
  * nothing when no schema has a date field (nothing to transform).
  */
-export const transformersGenerator = ({ model, outputPath, emit }) => {
-    const { dir, stem } = anchor(outputPath);
+export const transformersGenerator = ({ model, output, banner, emit }) => {
     const content = renderTransformersModule(model, {
-        sdkModule: `./${stem}.${emit.importExt ?? 'js'}`,
+        sdkModule: `./${output.stem}.${emit.importExt ?? 'js'}`,
     });
     if (content === '')
         return [];
-    return [{ path: join(dir, `${stem}.transformers.ts`), content: `${HEADER}\n\n${content}` }];
+    const header = banner.map((line) => `// ${line}`).join('\n');
+    return [
+        {
+            path: join(output.dir, `${output.stem}.transformers.ts`),
+            content: `${header}\n\n${content}`,
+        },
+    ];
 };
-//# sourceMappingURL=transformers.js.map
+//# sourceMappingURL=index.js.map

package/lib/generators/transformers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/transformers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;IAClF,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,EAAE;QAC9C,SAAS,EAAE,KAAK,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE;KACxD,CAAC,CAAC;IACH,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,OAAO;QACL;YACE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,kBAAkB,CAAC;YACxD,OAAO,EAAE,GAAG,MAAM,OAAO,OAAO,EAAE;SACnC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/lib/{emitters/transformers.d.ts → generators/transformers/render.d.ts}

@@ -1,4 +1,4 @@
-import type { ApiModel } from '../intermediate-representation/model.js';
+import type { ApiModel } from '@redocly/client-generator';
 /**
  * Render the transformers module. Emits one `transform<Name>` per named schema
  * that carries a date field; `''` when none do. `opts.sdkModule` is the import
@@ -8,4 +8,4 @@ import type { ApiModel } from '../intermediate-representation/model.js';
 export declare function renderTransformersModule(model: ApiModel, opts: {
     sdkModule: string;
 }): string;
-//# sourceMappingURL=transformers.d.ts.map
+//# sourceMappingURL=render.d.ts.map

package/lib/generators/transformers/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/generators/transformers/render.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAiC,MAAM,2BAA2B,CAAC;AAudzF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAa7F"}