@redocly/client-generator 0.0.0-snapshot.1784554531

package/lib/emitters/sse.d.ts

@@ -0,0 +1,10 @@
+import type { OperationModel } from '../intermediate-representation/model.js';
+import { ts } from './ts.js';
+import { type DateType } from './types.js';
+/** Whether an operation streams Server-Sent Events. */
+export declare function isSseOp(op: OperationModel): boolean;
+/** The TS type of a streamed event payload (`string` when no schema is declared). */
+export declare function sseEventType(op: OperationModel, dateType: DateType): ts.TypeNode;
+/** Whether the streamed `data:` payload should be `JSON.parse`d (`'json'`) or passed raw (`'text'`). */
+export declare function sseDataKind(op: OperationModel): 'json' | 'text';
+//# sourceMappingURL=sse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/emitters/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,KAAK,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAc7D,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAEnD;AAWD,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAKhF;AAED,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,CAW/D"}

package/lib/emitters/sse.js

@@ -0,0 +1,46 @@
+import { ts } from './ts.js';
+import { schemaToTypeNode } from './types.js';
+const { factory } = ts;
+/** The media type that marks an operation as a Server-Sent Events stream. */
+const SSE_CONTENT_TYPE = 'text/event-stream';
+/** The event-stream success response of an operation, if it declares one. */
+function sseResponse(op) {
+    return op.successResponses.find((r) => r.contentType.split(';')[0].trim().toLowerCase() === SSE_CONTENT_TYPE);
+}
+/** Whether an operation streams Server-Sent Events. */
+export function isSseOp(op) {
+    return sseResponse(op) !== undefined;
+}
+/** The per-event schema: `itemSchema` → the response `schema` → undefined (typeless slots skipped). */
+function eventSchema(op) {
+    const r = sseResponse(op);
+    if (!r)
+        return undefined;
+    if (r.itemSchema && r.itemSchema.kind !== 'unknown')
+        return r.itemSchema;
+    if (r.schema.kind !== 'unknown')
+        return r.schema;
+    return undefined;
+}
+/** The TS type of a streamed event payload (`string` when no schema is declared). */
+export function sseEventType(op, dateType) {
+    const schema = eventSchema(op);
+    return schema
+        ? schemaToTypeNode(schema, dateType)
+        : factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword);
+}
+/** Whether the streamed `data:` payload should be `JSON.parse`d (`'json'`) or passed raw (`'text'`). */
+export function sseDataKind(op) {
+    const schema = eventSchema(op);
+    if (!schema)
+        return 'text';
+    return schema.kind === 'object' ||
+        schema.kind === 'ref' ||
+        schema.kind === 'array' ||
+        schema.kind === 'record' ||
+        schema.kind === 'union' ||
+        schema.kind === 'intersection'
+        ? 'json'
+        : 'text';
+}
+//# sourceMappingURL=sse.js.map

package/lib/emitters/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/emitters/sse.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAiB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAEvB,6EAA6E;AAC7E,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAE7C,6EAA6E;AAC7E,SAAS,WAAW,CAAC,EAAkB;IACrC,OAAO,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,gBAAgB,CAC7E,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,EAAkB;IACxC,OAAO,WAAW,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;AACvC,CAAC;AAED,uGAAuG;AACvG,SAAS,WAAW,CAAC,EAAkB;IACrC,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,UAAU,CAAC;IACzE,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,EAAkB,EAAE,QAAkB;IACjE,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC/B,OAAO,MAAM;QACX,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC;QACpC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACjE,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,WAAW,CAAC,EAAkB;IAC5C,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAC3B,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC7B,MAAM,CAAC,IAAI,KAAK,KAAK;QACrB,MAAM,CAAC,IAAI,KAAK,OAAO;QACvB,MAAM,CAAC,IAAI,KAAK,QAAQ;QACxB,MAAM,CAAC,IAAI,KAAK,OAAO;QACvB,MAAM,CAAC,IAAI,KAAK,cAAc;QAC9B,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,CAAC;AACb,CAAC"}

package/lib/emitters/support.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Upper-case the first character of an operation name. We don't normalize the
+ * rest because almost every spec uses camelCase or PascalCase, and names that
+ * contain digits or `_` are passed through unchanged — the user named them that
+ * way for a reason.
+ *
+ * `op.name` reaches here already sanitized into a non-empty, valid TS identifier
+ * by the IR builder (see `intermediate-representation/sanitize-identifiers.ts`), so no empty-string or
+ * unsafe-character guard is needed.
+ */
+export declare function pascalCase(name: string): string;
+export declare function splitLines(text: string): string[];
+//# sourceMappingURL=support.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../src/emitters/support.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD"}

package/lib/emitters/support.js

@@ -0,0 +1,21 @@
+// Low-level text helpers shared across the emitters. Private to `emitters/`.
+/**
+ * Upper-case the first character of an operation name. We don't normalize the
+ * rest because almost every spec uses camelCase or PascalCase, and names that
+ * contain digits or `_` are passed through unchanged — the user named them that
+ * way for a reason.
+ *
+ * `op.name` reaches here already sanitized into a non-empty, valid TS identifier
+ * by the IR builder (see `intermediate-representation/sanitize-identifiers.ts`), so no empty-string or
+ * unsafe-character guard is needed.
+ */
+export function pascalCase(name) {
+    return name[0].toUpperCase() + name.slice(1);
+}
+export function splitLines(text) {
+    return text
+        .replace(/\r\n/g, '\n')
+        .split('\n')
+        .map((line) => line.trimEnd());
+}
+//# sourceMappingURL=support.js.map

package/lib/emitters/support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support.js","sourceRoot":"","sources":["../../src/emitters/support.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI;SACR,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/lib/emitters/swr.d.ts

@@ -0,0 +1,10 @@
+import type { ApiModel } from '../intermediate-representation/model.js';
+export type SwrOptions = {
+    /** Import specifier for the sdk entry the operation functions/types live in. */
+    sdkModule: string;
+    /** How the sdk function takes its inputs — must match the generated client. */
+    argsStyle: 'flat' | 'grouped';
+};
+/** Render the full SWR module source. `''` when there are no wrappable operations. */
+export declare function renderSwrModule(model: ApiModel, opts: SwrOptions): string;
+//# sourceMappingURL=swr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"swr.d.ts","sourceRoot":"","sources":["../../src/emitters/swr.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,yCAAyC,CAAC;AAsBxF,MAAM,MAAM,UAAU,GAAG;IACvB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAIzE"}

package/lib/emitters/swr.js

@@ -0,0 +1,88 @@
+// Emits an idiomatic SWR module wrapping the sdk operation functions. Per query
+// operation (GET/HEAD) a `<op>Key(vars)` tuple factory + a `use<Op>(vars, init?)`
+// hook returning `useSWR(key, fetcher)`; per mutation (everything else) a
+// `use<Op>()` hook returning `useSWRMutation(key, (key, { arg }) => <op>(arg))`.
+// The fetcher forwards args per the configured args style (grouped `<op>(vars, init)`
+// or flat `<op>(vars.petId, …, init)`) via the shared `operationSignature`, so the
+// call type-checks against the generated sdk.
+// `swr`/`swr/mutation` are the consumer's peer; the sdk stays dependency-free.
+// AST-native via `ts.factory`.
+import { pascalCase } from './support.js';
+import { arrow, constArray, exportConstStatement as exportConst, printStatements, ts, } from './ts.js';
+import { hasInputs, initParam, isQuery, sdkCall, sdkNamedImport, variablesName, varsParam, wrappableOperations, } from './wrapper-support.js';
+const { factory } = ts;
+/** Render the full SWR module source. `''` when there are no wrappable operations. */
+export function renderSwrModule(model, opts) {
+    const ops = wrappableOperations(model, 'swr');
+    if (ops.length === 0)
+        return '';
+    return printStatements(swrStatements(ops, opts));
+}
+/** The SWR module statements: the import header followed by per-op hooks. */
+function swrStatements(ops, opts) {
+    const hasQuery = ops.some(isQuery);
+    const hasMutation = ops.some((op) => !isQuery(op));
+    const statements = [];
+    for (const op of ops) {
+        statements.push(...(isQuery(op) ? queryStatements(op, opts) : [mutationStatement(op, opts)]));
+    }
+    return [...importHeader(ops, opts, hasQuery, hasMutation), ...statements];
+}
+/** An exported `function use<Op>(<params>) { <body> }` declaration. */
+function exportHook(op, params, ret) {
+    const name = `use${pascalCase(op.name)}`;
+    return factory.createFunctionDeclaration([factory.createModifier(ts.SyntaxKind.ExportKeyword)], undefined, name, undefined, params, undefined, factory.createBlock([factory.createReturnStatement(ret)], true));
+}
+/** A query op's `<op>Key` factory + `use<Op>` hook calling `useSWR`. */
+function queryStatements(op, opts) {
+    const inputs = hasInputs(op);
+    const keyId = factory.createStringLiteral(op.name);
+    const keyParams = inputs ? [varsParam(op)] : [];
+    const keyElements = inputs ? [keyId, factory.createIdentifier('vars')] : [keyId];
+    const key = exportConst(`${op.name}Key`, arrow(keyParams, constArray(keyElements)));
+    const keyCall = factory.createCallExpression(factory.createIdentifier(`${op.name}Key`), undefined, inputs ? [factory.createIdentifier('vars')] : []);
+    const useSwr = factory.createCallExpression(factory.createIdentifier('useSWR'), undefined, [
+        keyCall,
+        arrow([], sdkCall(op, opts.argsStyle, 'vars', true)),
+    ]);
+    const params = inputs ? [varsParam(op), initParam()] : [initParam()];
+    return [key, exportHook(op, params, useSwr)];
+}
+/** A mutation op's `use<Op>` hook calling `useSWRMutation`. */
+function mutationStatement(op, opts) {
+    const inputs = hasInputs(op);
+    const key = factory.createStringLiteral(op.name);
+    // `(_key: string, { arg }: { arg: <Op>Variables }) => <op>(…arg)` when the op has inputs;
+    // a no-arg `() => <op>()` when it has none (`arg` would be unused).
+    const trigger = inputs
+        ? triggerWithArg(op, opts)
+        : arrow([], sdkCall(op, opts.argsStyle, 'arg', false));
+    const useSwrMutation = factory.createCallExpression(factory.createIdentifier('useSWRMutation'), undefined, [key, trigger]);
+    return exportHook(op, [], useSwrMutation);
+}
+/** `(_key: string, { arg }: { arg: <Op>Variables }) => <op>(…arg)`. */
+function triggerWithArg(op, opts) {
+    const keyParam = factory.createParameterDeclaration(undefined, undefined, '_key', undefined, factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword));
+    const argParam = factory.createParameterDeclaration(undefined, undefined, factory.createObjectBindingPattern([factory.createBindingElement(undefined, undefined, 'arg')]), undefined, factory.createTypeLiteralNode([
+        factory.createPropertySignature(undefined, 'arg', undefined, factory.createTypeReferenceNode(variablesName(op))),
+    ]));
+    return arrow([keyParam, argParam], sdkCall(op, opts.argsStyle, 'arg', false));
+}
+/**
+ * The import header: `useSWR` from `swr` (when any query op), `useSWRMutation` from
+ * `swr/mutation` (when any mutation op), then the shared sdk named import.
+ */
+function importHeader(ops, opts, hasQuery, hasMutation) {
+    const imports = [];
+    if (hasQuery)
+        imports.push(defaultImport('useSWR', 'swr'));
+    if (hasMutation)
+        imports.push(defaultImport('useSWRMutation', 'swr/mutation'));
+    imports.push(sdkNamedImport(ops, opts.sdkModule, hasQuery));
+    return imports;
+}
+/** `import <name> from "<module>";` (default import). */
+function defaultImport(name, module) {
+    return factory.createImportDeclaration(undefined, factory.createImportClause(false, factory.createIdentifier(name), undefined), factory.createStringLiteral(module));
+}
+//# sourceMappingURL=swr.js.map

package/lib/emitters/swr.js.map

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

package/lib/emitters/tanstack-query.d.ts

@@ -0,0 +1,11 @@
+import type { ApiModel } from '../intermediate-representation/model.js';
+export type TanstackOptions = {
+    argsStyle: 'flat' | 'grouped';
+    /** Import specifier for the sdk entry the operation functions/types live in. */
+    sdkModule: string;
+    /** TanStack adapter to import `queryOptions` from (`@tanstack/${framework}-query`). */
+    framework: 'react' | 'vue' | 'svelte' | 'solid';
+};
+/** 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

package/lib/emitters/tanstack-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-query.d.ts","sourceRoot":"","sources":["../../src/emitters/tanstack-query.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,yCAAyC,CAAC;AAoBxF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;CACjD,CAAC;AAEF,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAInF"}

package/lib/emitters/tanstack-query.js

@@ -0,0 +1,68 @@
+// Emits an idiomatic TanStack Query v5 (React) module wrapping the sdk operation
+// functions. Per query operation (GET/HEAD) a `<op>QueryKey(vars)` +
+// `<op>Options(vars, init?)` (`queryOptions({ queryKey, queryFn })`); per mutation
+// (everything else) a `<op>Mutation()` (`{ mutationKey, mutationFn }`). Each
+// factory forwards to the sdk function per the configured args style — grouped
+// (`getPet(vars, init)`) or flat (`getPet(vars.petId, vars.params, …, init)`),
+// matching `operations.ts` positional order so the call type-checks against the
+// generated sdk. AST-native via `ts.factory`.
+import { arrow, constArray, exportConstStatement as exportConst, printStatements, ts, } from './ts.js';
+import { hasInputs, initParam, isQuery, sdkCall, sdkNamedImport, varsParam, wrappableOperations, } from './wrapper-support.js';
+const { factory } = ts;
+/** 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 '';
+    return printStatements(tanstackStatements(ops, opts));
+}
+/** The TanStack module statements: the import header followed by per-op factories. */
+function tanstackStatements(ops, opts) {
+    const hasQuery = ops.some(isQuery);
+    const statements = [];
+    for (const op of ops) {
+        statements.push(...(isQuery(op) ? queryStatements(op, opts) : [mutationStatement(op, opts)]));
+    }
+    return [...importHeader(ops, opts, hasQuery), ...statements];
+}
+/** A query op's `<op>QueryKey` + `<op>Options` statements. */
+function queryStatements(op, opts) {
+    const inputs = hasInputs(op);
+    const keyId = factory.createStringLiteral(op.name);
+    const keyParams = inputs ? [varsParam(op)] : [];
+    const keyElements = inputs ? [keyId, factory.createIdentifier('vars')] : [keyId];
+    const queryKey = exportConst(`${op.name}QueryKey`, arrow(keyParams, constArray(keyElements)));
+    const keyCall = factory.createCallExpression(factory.createIdentifier(`${op.name}QueryKey`), undefined, inputs ? [factory.createIdentifier('vars')] : []);
+    const queryOptionsCall = factory.createCallExpression(factory.createIdentifier('queryOptions'), undefined, [
+        factory.createObjectLiteralExpression([
+            factory.createPropertyAssignment('queryKey', keyCall),
+            factory.createPropertyAssignment('queryFn', arrow([], sdkCall(op, opts.argsStyle, 'vars', true))),
+        ], true),
+    ]);
+    const optionsParams = inputs ? [varsParam(op), initParam()] : [initParam()];
+    const options = exportConst(`${op.name}Options`, arrow(optionsParams, queryOptionsCall));
+    return [queryKey, options];
+}
+/** A mutation op's `<op>Mutation` statement. */
+function mutationStatement(op, opts) {
+    const inputs = hasInputs(op);
+    const mutationFn = arrow(inputs ? [varsParam(op)] : [], sdkCall(op, opts.argsStyle, 'vars', false));
+    const obj = factory.createObjectLiteralExpression([
+        factory.createPropertyAssignment('mutationKey', constArray([factory.createStringLiteral(op.name)])),
+        factory.createPropertyAssignment('mutationFn', mutationFn),
+    ], true);
+    // Wrap in parens so the arrow body is an object literal, not a block.
+    return exportConst(`${op.name}Mutation`, arrow([], factory.createParenthesizedExpression(obj)));
+}
+/**
+ * The import header: `queryOptions` from `@tanstack/${framework}-query` (when any
+ * query op), then the shared sdk named import.
+ */
+function importHeader(ops, opts, hasQuery) {
+    const tanstack = factory.createImportDeclaration(undefined, factory.createImportClause(false, undefined, factory.createNamedImports([
+        factory.createImportSpecifier(false, undefined, factory.createIdentifier('queryOptions')),
+    ])), factory.createStringLiteral(`@tanstack/${opts.framework}-query`));
+    const sdkImport = sdkNamedImport(ops, opts.sdkModule, hasQuery);
+    return hasQuery ? [tanstack, sdkImport] : [sdkImport];
+}
+//# sourceMappingURL=tanstack-query.js.map

package/lib/emitters/tanstack-query.js.map

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

package/lib/emitters/transformers.d.ts

@@ -0,0 +1,11 @@
+import type { ApiModel } from '../intermediate-representation/model.js';
+/**
+ * Render the transformers module. Emits one `transform<Name>` per named schema
+ * that carries a date field; `''` when none do. `opts.sdkModule` is the import
+ * specifier the schema TYPES are pulled from (the transformers call each other
+ * as siblings, so only the types need importing).
+ */
+export declare function renderTransformersModule(model: ApiModel, opts: {
+    sdkModule: string;
+}): string;
+//# sourceMappingURL=transformers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transformers.d.ts","sourceRoot":"","sources":["../../src/emitters/transformers.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,QAAQ,EAGT,MAAM,yCAAyC,CAAC;AAqbjD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAU7F"}