@apollo-deploy/tesseract 1.9.0 → 2.0.0

package/dist/adapters/documentation.js

@@ -0,0 +1,268 @@
+import { posix } from 'node:path';
+export function createDocumentationFiles({ meta, groups, schemas, naming, }) {
+    return [
+        {
+            relativePath: 'LICENSE',
+            content: renderLicense(meta),
+        },
+        {
+            relativePath: 'docs/README.md',
+            content: renderDocumentationIndex(meta, groups, naming),
+        },
+        {
+            relativePath: 'docs/types.md',
+            content: renderTypesReference(meta, schemas, naming),
+        },
+        ...groups.map((group) => ({
+            relativePath: posix.join('docs', 'domains', `${group.fileName}.md`),
+            content: renderDomainReference(meta, group, naming),
+        })),
+    ];
+}
+function renderLicense(meta) {
+    return `MIT License
+
+Copyright (c) ${meta.title} SDK contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+`;
+}
+function renderDocumentationIndex(meta, groups, naming) {
+    const lines = [
+        `# ${meta.title} SDK documentation`,
+        '',
+        meta.description ?? `Reference documentation for the ${meta.title} SDK.`,
+        '',
+        '[Back to the SDK overview](../README.md)',
+        '',
+        '## API domains',
+        '',
+        '| Domain | Client accessor | Operations | Description |',
+        '|---|---|---:|---|',
+    ];
+    if (groups.length === 0) {
+        lines.push('| _No public domains_ | — | 0 | This SDK has no exposed operations. |');
+    }
+    else {
+        for (const group of groups) {
+            lines.push(`| [${escapeMarkdown(group.interfaceName)}](./domains/${group.fileName}.md) | \`${escapeCode(resolveGroupAccessor(group, naming))}\` | ${group.operations.length} | ${escapeTableCell(group.description ?? `${group.name} operations`)} |`);
+        }
+    }
+    lines.push('', '## Models and types', '', '- [Generated types reference](./types.md)', '', '## Reliability behavior', '', 'Generated clients use bounded request timeouts, structured SDK errors, request ID propagation, and retry transient failures with exponential backoff. Unsafe requests are not retried unless the generated client can establish idempotency or the caller explicitly enables it.', '');
+    return `${lines.join('\n')}\n`;
+}
+function renderDomainReference(meta, group, naming) {
+    const accessor = resolveGroupAccessor(group, naming);
+    const sourcePath = naming.sourcePath(group).replaceAll('\\', '/');
+    const lines = [
+        `# ${group.interfaceName}`,
+        '',
+        group.description ?? `${group.name} API operations.`,
+        '',
+        `[Documentation index](../README.md) · [SDK overview](../../README.md) · [Generated source](../../${sourcePath})`,
+        '',
+        `Client accessor: \`${escapeCode(accessor)}\``,
+        '',
+        '## Operations',
+        '',
+        '| Method | HTTP | Path | Returns | Description |',
+        '|---|---|---|---|---|',
+    ];
+    for (const operation of group.operations) {
+        const method = resolveMethodName(operation, naming);
+        lines.push(`| [\`${escapeCode(method)}\`](#${markdownAnchor(method)}) | \`${escapeCode(operation.httpMethod.toUpperCase())}\` | \`${escapeCode(documentedPath(operation))}\` | \`${escapeCode(resolveType(operation.responseType, naming))}\` | ${escapeTableCell(operation.summary ?? operation.description ?? '—')} |`);
+    }
+    for (const operation of group.operations) {
+        lines.push('', ...renderOperation(operation, naming));
+    }
+    lines.push('', '---', '', `Generated from the ${meta.title} manifest by Tesseract.`, '');
+    return `${lines.join('\n')}\n`;
+}
+function renderOperation(operation, naming) {
+    const method = resolveMethodName(operation, naming);
+    const lines = [
+        `## ${method}`,
+        '',
+        `\`${operation.httpMethod.toUpperCase()} ${escapeCode(documentedPath(operation))}\``,
+        '',
+    ];
+    if (operation.deprecated) {
+        lines.push(`> **Deprecated:** ${operation.deprecationMessage ?? 'This operation may be removed in a future release.'}`, '');
+    }
+    if (operation.summary)
+        lines.push(operation.summary, '');
+    if (operation.description && operation.description !== operation.summary) {
+        lines.push(operation.description, '');
+    }
+    if (operation.timeoutMs !== undefined) {
+        lines.push(`Default operation timeout: **${operation.timeoutMs} ms**`, '');
+    }
+    const parameters = collectParameters(operation);
+    if (parameters.length) {
+        lines.push('### Parameters', '', '| Name | Location | Type | Required | Description |', '|---|---|---|:---:|---|');
+        for (const { parameter, location } of parameters) {
+            lines.push(`| \`${escapeCode(parameter.originalName)}\` | ${location} | \`${escapeCode(resolveType(parameter.type, naming))}\` | ${parameter.required ? 'Yes' : 'No'} | ${escapeTableCell(parameter.description ?? (parameter.deprecated ? 'Deprecated parameter.' : '—'))} |`);
+        }
+        lines.push('');
+    }
+    if (operation.requestBody) {
+        lines.push('### Request body', '', `- Type: \`${escapeCode(resolveType(operation.requestBody.type, naming))}\``, `- Required: ${operation.requestBody.required ? 'Yes' : 'No'}`, `- Content type: \`${escapeCode(operation.requestBody.contentType)}\``, '');
+    }
+    lines.push('### Response', '', `- Success status: \`${operation.statusCode}\``, `- Type: \`${escapeCode(resolveType(operation.responseType, naming))}\``);
+    if (operation.isEventStream) {
+        lines.push(`- Streaming: Server-Sent Events${operation.eventSchema ? ` with payload \`${escapeCode(resolveType(operation.eventSchema, naming))}\`` : ''}`);
+    }
+    lines.push('');
+    return lines;
+}
+function renderTypesReference(meta, schemas, naming) {
+    const lines = [
+        `# ${meta.title} generated types`,
+        '',
+        '[Documentation index](./README.md) · [SDK overview](../README.md)',
+        '',
+    ];
+    if (!schemas.length) {
+        lines.push('This SDK does not generate local models. Types are supplied by an external schema package.', '');
+        return `${lines.join('\n')}\n`;
+    }
+    lines.push('## Index', '', '| Type | Kind | Description |', '|---|---|---|');
+    for (const schema of schemas) {
+        lines.push(`| [\`${escapeCode(schema.name)}\`](#${markdownAnchor(schema.name)}) | ${schemaKind(schema)} | ${escapeTableCell(schema.description ?? '—')} |`);
+    }
+    for (const schema of schemas) {
+        lines.push('', `## ${schema.name}`, '');
+        if (schema.description)
+            lines.push(schema.description, '');
+        if (schema.ownership?.kind === 'external') {
+            lines.push(`Imported from \`${escapeCode(schema.ownership.externalImport?.importPath ?? schema.ownership.externalImport?.packageName ?? 'external schema package')}\`.`, '');
+            continue;
+        }
+        if (schema.isEnum) {
+            lines.push('Allowed values:', '');
+            for (const value of schema.enumValues ?? []) {
+                lines.push(`- \`${escapeCode(JSON.stringify(value))}\``);
+            }
+            lines.push('');
+            continue;
+        }
+        if (schema.aliasType) {
+            lines.push(`Alias of \`${escapeCode(resolveType(schema.aliasType, naming))}\`.`, '');
+            continue;
+        }
+        if (schema.isUnionType) {
+            lines.push(`Union of ${formatTypeList(schema.unionMembers ?? [], naming)}.`, '');
+            continue;
+        }
+        if (schema.isIntersectionType) {
+            lines.push(`Intersection of ${formatTypeList(schema.intersectionMembers ?? [], naming)}.`, '');
+            continue;
+        }
+        if (schema.extends) {
+            lines.push(`Extends \`${escapeCode(resolveType(schema.extends, naming))}\`.`, '');
+        }
+        if (schema.properties.length) {
+            lines.push('| Property | Type | Required | Description |', '|---|---|:---:|---|');
+            for (const property of schema.properties) {
+                const nullable = property.nullable ? ' | null' : '';
+                lines.push(`| \`${escapeCode(property.name)}\` | \`${escapeCode(resolveType(property.type, naming))}${nullable}\` | ${property.required ? 'Yes' : 'No'} | ${escapeTableCell(property.description ?? (property.deprecated ? 'Deprecated property.' : '—'))} |`);
+            }
+            lines.push('');
+        }
+        else {
+            lines.push('This model has no declared properties.', '');
+        }
+        if (schema.additionalPropertiesType) {
+            lines.push(`Additional properties use \`${escapeCode(resolveType(schema.additionalPropertiesType, naming))}\`.`, '');
+        }
+    }
+    return `${lines.join('\n')}\n`;
+}
+function documentedPath(operation) {
+    let path = operation.path;
+    for (const parameter of operation.pathParams) {
+        const replacement = `{${parameter.originalName}}`;
+        const placeholders = [
+            `\${${parameter.name}}`,
+            `:${parameter.name}`,
+            `{${parameter.name}}`,
+            `\${${parameter.originalName}}`,
+            `:${parameter.originalName}`,
+            `{${parameter.originalName}}`,
+        ];
+        for (const placeholder of placeholders) {
+            path = path.replaceAll(placeholder, replacement);
+        }
+    }
+    return path;
+}
+function collectParameters(operation) {
+    return [
+        ...operation.pathParams.map((parameter) => ({ parameter, location: 'Path' })),
+        ...operation.queryParams.map((parameter) => ({ parameter, location: 'Query' })),
+        ...operation.headerParams.map((parameter) => ({ parameter, location: 'Header' })),
+        ...operation.cookieParams.map((parameter) => ({ parameter, location: 'Cookie' })),
+    ];
+}
+function resolveGroupAccessor(group, naming) {
+    return naming.groupAccessor?.(group) ?? `client.${group.name}`;
+}
+function resolveMethodName(operation, naming) {
+    return naming.methodName?.(operation) ?? operation.name;
+}
+function resolveType(type, naming) {
+    return naming.typeName?.(type) ?? type;
+}
+function formatTypeList(types, naming) {
+    if (!types.length)
+        return '`unknown`';
+    return types
+        .map((type) => `\`${escapeCode(resolveType(type, naming))}\``)
+        .join(', ');
+}
+function schemaKind(schema) {
+    if (schema.ownership?.kind === 'external')
+        return 'External';
+    if (schema.isEnum)
+        return 'Enum';
+    if (schema.aliasType)
+        return 'Alias';
+    if (schema.isUnionType)
+        return 'Union';
+    if (schema.isIntersectionType)
+        return 'Intersection';
+    return 'Model';
+}
+function markdownAnchor(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9 _-]/g, '')
+        .replace(/[ _]+/g, '-');
+}
+function escapeCode(value) {
+    return value.replaceAll('`', '\\`');
+}
+function escapeMarkdown(value) {
+    return value.replace(/([\\*_{}\[\]()#+.!|-])/g, '\\$1');
+}
+function escapeTableCell(value) {
+    return value.replaceAll('|', '\\|').replace(/\s+/g, ' ').trim();
+}
+//# sourceMappingURL=documentation.js.map

package/dist/adapters/documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation.js","sourceRoot":"","sources":["../../src/adapters/documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AA0BlC,MAAM,UAAU,wBAAwB,CAAC,EACvC,IAAI,EACJ,MAAM,EACN,OAAO,EACP,MAAM,GACe;IACrB,OAAO;QACL;YACE,YAAY,EAAE,SAAS;YACvB,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;SAC7B;QACD;YACE,YAAY,EAAE,gBAAgB;YAC9B,OAAO,EAAE,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;SACxD;QACD;YACE,YAAY,EAAE,eAAe;YAC7B,OAAO,EAAE,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;SACrD;QACD,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxB,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,QAAQ,KAAK,CAAC;YACnE,OAAO,EAAE,qBAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC;SACpD,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAa;IAClC,OAAO;;gBAEO,IAAI,CAAC,KAAK;;;;;;;;;;;;;;;;;;;CAmBzB,CAAC;AACF,CAAC;AAED,SAAS,wBAAwB,CAC/B,IAAa,EACb,MAAwB,EACxB,MAA2B;IAE3B,MAAM,KAAK,GAAG;QACZ,KAAK,IAAI,CAAC,KAAK,oBAAoB;QACnC,EAAE;QACF,IAAI,CAAC,WAAW,IAAI,mCAAmC,IAAI,CAAC,KAAK,OAAO;QACxE,EAAE;QACF,0CAA0C;QAC1C,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,yDAAyD;QACzD,oBAAoB;KACrB,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CACR,MAAM,cAAc,CAAC,KAAK,CAAC,aAAa,CAAC,eAAe,KAAK,CAAC,QAAQ,YAAY,UAAU,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,UAAU,CAAC,MAAM,MAAM,eAAe,CAAC,KAAK,CAAC,WAAW,IAAI,GAAG,KAAK,CAAC,IAAI,aAAa,CAAC,IAAI,CAC3O,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,qBAAqB,EACrB,EAAE,EACF,2CAA2C,EAC3C,EAAE,EACF,yBAAyB,EACzB,EAAE,EACF,kRAAkR,EAClR,EAAE,CACH,CAAC;IAEF,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAa,EACb,KAAqB,EACrB,MAA2B;IAE3B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG;QACZ,KAAK,KAAK,CAAC,aAAa,EAAE;QAC1B,EAAE;QACF,KAAK,CAAC,WAAW,IAAI,GAAG,KAAK,CAAC,IAAI,kBAAkB;QACpD,EAAE;QACF,oGAAoG,UAAU,GAAG;QACjH,EAAE;QACF,sBAAsB,UAAU,CAAC,QAAQ,CAAC,IAAI;QAC9C,EAAE;QACF,eAAe;QACf,EAAE;QACF,kDAAkD;QAClD,uBAAuB;KACxB,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CACR,QAAQ,UAAU,CAAC,MAAM,CAAC,QAAQ,cAAc,CAAC,MAAM,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,UAAU,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,QAAQ,eAAe,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAC9S,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,KAAK,EACL,EAAE,EACF,sBAAsB,IAAI,CAAC,KAAK,yBAAyB,EACzD,EAAE,CACH,CAAC;IAEF,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,eAAe,CACtB,SAAoB,EACpB,MAA2B;IAE3B,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG;QACZ,MAAM,MAAM,EAAE;QACd,EAAE;QACF,KAAK,SAAS,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,IAAI;QACpF,EAAE;KACH,CAAC;IAEF,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CACR,qBAAqB,SAAS,CAAC,kBAAkB,IAAI,oDAAoD,EAAE,EAC3G,EAAE,CACH,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,gCAAgC,SAAS,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CACR,gBAAgB,EAChB,EAAE,EACF,qDAAqD,EACrD,yBAAyB,CAC1B,CAAC;QAEF,KAAK,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,UAAU,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CACR,OAAO,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,QAAQ,QAAQ,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,eAAe,CAAC,SAAS,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CACpQ,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CACR,kBAAkB,EAClB,EAAE,EACF,aAAa,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAC5E,eAAe,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAC9D,qBAAqB,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,EACtE,EAAE,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CACR,cAAc,EACd,EAAE,EACF,uBAAuB,SAAS,CAAC,UAAU,IAAI,EAC/C,aAAa,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,IAAI,CACzE,CAAC;IAEF,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CACR,kCAAkC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,mBAAmB,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/I,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAa,EACb,OAA2B,EAC3B,MAA2B;IAE3B,MAAM,KAAK,GAAG;QACZ,KAAK,IAAI,CAAC,KAAK,kBAAkB;QACjC,EAAE;QACF,mEAAmE;QACnE,EAAE;KACH,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,4FAA4F,EAAE,EAAE,CAAC,CAAC;QAC7G,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,+BAA+B,EAAE,eAAe,CAAC,CAAC;IAC7E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CACR,QAAQ,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAChJ,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAE3D,IAAI,MAAM,CAAC,SAAS,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CACR,mBAAmB,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,IAAI,yBAAyB,CAAC,KAAK,EAC5J,EAAE,CACH,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrF,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CACR,YAAY,cAAc,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,MAAM,CAAC,GAAG,EAChE,EAAE,CACH,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CACR,mBAAmB,cAAc,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,EAAE,MAAM,CAAC,GAAG,EAC9E,EAAE,CACH,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,aAAa,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CACR,8CAA8C,EAC9C,qBAAqB,CACtB,CAAC;YACF,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,KAAK,CAAC,IAAI,CACR,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,QAAQ,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,eAAe,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CACnP,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,MAAM,CAAC,wBAAwB,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CACR,+BAA+B,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC,KAAK,EACpG,EAAE,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,cAAc,CAAC,SAAoB;IAC1C,IAAI,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IAE1B,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,IAAI,SAAS,CAAC,YAAY,GAAG,CAAC;QAClD,MAAM,YAAY,GAAG;YACnB,MAAM,SAAS,CAAC,IAAI,GAAG;YACvB,IAAI,SAAS,CAAC,IAAI,EAAE;YACpB,IAAI,SAAS,CAAC,IAAI,GAAG;YACrB,MAAM,SAAS,CAAC,YAAY,GAAG;YAC/B,IAAI,SAAS,CAAC,YAAY,EAAE;YAC5B,IAAI,SAAS,CAAC,YAAY,GAAG;SAC9B,CAAC;QAEF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CACxB,SAAoB;IAEpB,OAAO;QACL,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7E,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/E,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjF,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;KAClF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAqB,EACrB,MAA2B;IAE3B,OAAO,MAAM,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,iBAAiB,CACxB,SAAoB,EACpB,MAA2B;IAE3B,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,MAA2B;IAC5D,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACzC,CAAC;AAED,SAAS,cAAc,CACrB,KAAe,EACf,MAA2B;IAE3B,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,WAAW,CAAC;IACtC,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC;SAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,MAAwB;IAC1C,IAAI,MAAM,CAAC,SAAS,EAAE,IAAI,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC7D,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IACjC,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC;IACrC,IAAI,MAAM,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,MAAM,CAAC,kBAAkB;QAAE,OAAO,cAAc,CAAC;IACrD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC"}

package/dist/adapters/go/index.d.ts

@@ -1,12 +1,9 @@
-/**
- * Go language adapter.
- * Generates an idiomatic Go SDK package using net/http.
- */
-import type { EnrichedSDKIR } from "../../types/ir.js";
-import type { LanguageAdapter, EmitResult } from "../types.js";
-import type { ResolvedConfig } from "../../types/config.js";
+/** Go language adapter. */
+import type { EnrichedSDKIR } from '../../types/ir.js';
+import type { ResolvedConfig } from '../../types/config.js';
+import type { EmitResult, LanguageAdapter } from '../types.js';
 export declare class GoAdapter implements LanguageAdapter {
     readonly language = "go";
-    emit(enriched: EnrichedSDKIR, outputDir: string, config?: ResolvedConfig): Promise<EmitResult>;
+    emit(enriched: EnrichedSDKIR, _outputDir: string, config?: ResolvedConfig): Promise<EmitResult>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/go/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/go/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAoD5D,qBAAa,SAAU,YAAW,eAAe;IAC/C,QAAQ,CAAC,QAAQ,QAAQ;IAEnB,IAAI,CACR,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;CA+GvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/go/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAG3B,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA+I/D,qBAAa,SAAU,YAAW,eAAe;IAC/C,QAAQ,CAAC,QAAQ,QAAQ;IAEnB,IAAI,CACR,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;CAsIvB"}

package/dist/adapters/go/index.js

@@ -1,135 +1,231 @@
-/**
- * Go language adapter.
- * Generates an idiomatic Go SDK package using net/http.
- */
-import { getTemplate, registerHelpers, collectImports, } from "../../helpers/handlebars.js";
-import Handlebars from "handlebars";
-function goTypeExpr(tsType) {
-    if (!tsType)
-        return "interface{}";
-    // If it's a simple identifier (alphanumeric), pass through
-    if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(tsType))
-        return "*" + tsType;
-    // If it's a TypeScript inline type with braces, use interface{}
-    return "interface{}";
+/** Go language adapter. */
+import { pascalCase } from 'change-case';
+import { collectImports, getTemplate, registerHelpers, } from '../../helpers/handlebars.js';
+import { genericArgument, genericArguments, isBooleanLiteral, isInlineObject, isNumberLiteral, isStringLiteral, splitTopLevel, stripOuterParens, unwrapNullable, } from '../type-utils.js';
+import { getPackageVersion, getVisibleGroups, getVisibleSchemas, hasEventStreams, } from '../shared.js';
+import { createDocumentationFiles } from '../documentation.js';
+const GO_PRIMITIVES = {
+    string: 'string',
+    number: 'float64',
+    integer: 'int',
+    boolean: 'bool',
+    any: 'interface{}',
+    unknown: 'interface{}',
+    void: 'struct{}',
+    never: 'interface{}',
+};
+function goType(value) {
+    const { type } = unwrapNullable(value);
+    const normalized = stripOuterParens(type);
+    const union = splitTopLevel(normalized, '|');
+    if (union.length > 1) {
+        if (union.every(isStringLiteral))
+            return 'string';
+        if (union.every(isNumberLiteral))
+            return 'float64';
+        if (union.every(isBooleanLiteral))
+            return 'bool';
+        return 'interface{}';
+    }
+    const intersection = splitTopLevel(normalized, '&');
+    if (intersection.length > 1 || isInlineObject(normalized))
+        return 'map[string]interface{}';
+    if (isStringLiteral(normalized))
+        return 'string';
+    if (isNumberLiteral(normalized))
+        return 'float64';
+    if (isBooleanLiteral(normalized))
+        return 'bool';
+    if (GO_PRIMITIVES[normalized])
+        return GO_PRIMITIVES[normalized];
+    const array = genericArgument(normalized, 'Array');
+    if (array !== undefined)
+        return `[]${goType(array)}`;
+    const record = genericArguments(normalized, 'Record');
+    if (record?.length === 2)
+        return `map[string]${goType(record[1])}`;
+    const map = genericArgument(normalized, 'Map');
+    if (map !== undefined)
+        return `map[string]${goType(map)}`;
+    return normalized;
+}
+const GO_KEYWORDS = new Set([
+    'break',
+    'default',
+    'func',
+    'interface',
+    'select',
+    'case',
+    'defer',
+    'go',
+    'map',
+    'struct',
+    'chan',
+    'else',
+    'goto',
+    'package',
+    'switch',
+    'const',
+    'fallthrough',
+    'if',
+    'range',
+    'type',
+    'continue',
+    'for',
+    'import',
+    'return',
+    'var',
+]);
+function goIdentifier(value) {
+    const name = value.replace(/[^a-zA-Z0-9_]/g, '_');
+    const valid = /^[A-Za-z_]/.test(name) ? name : `value_${name}`;
+    return GO_KEYWORDS.has(valid) ? `${valid}_` : valid;
 }
-function goPropertyType(tsType) {
-    const t = tsType.trim();
-    const MAP = {
-        string: "string",
-        number: "float64",
-        integer: "int",
-        boolean: "bool",
-        any: "interface{}",
-        unknown: "interface{}",
+function transformParameter(parameter) {
+    const targetType = goType(parameter.type);
+    return {
+        ...parameter,
+        name: goIdentifier(parameter.name),
+        targetType,
+        inputType: parameter.required ? targetType : `*${targetType}`,
     };
-    if (MAP[t])
-        return MAP[t];
-    // Array<T>
-    const arr = t.match(/^Array<(.+)>$/);
-    if (arr)
-        return `[]${goPropertyType(arr[1])}`;
-    // Record<K, V>
-    const rec = t.match(/^Record<(.+),\s*(.+)>$/);
-    if (rec)
-        return `map[${goPropertyType(rec[1])}]${goPropertyType(rec[2])}`;
-    // TypeScript union literals → string
-    if (/^["']/.test(t))
-        return "string";
-    return t;
 }
-let goHelpersRegistered = false;
-function registerGoHelpers() {
-    if (goHelpersRegistered)
-        return;
-    goHelpersRegistered = true;
-    Handlebars.registerHelper("goQueryType", (tsType) => goTypeExpr(tsType));
-    Handlebars.registerHelper("goPropertyType", (tsType) => goPropertyType(tsType));
+function transformSchema(schema) {
+    const enumValues = schema.enumValues ?? [];
+    const enumType = enumValues.every((value) => typeof value === 'number')
+        ? 'float64'
+        : 'string';
+    return {
+        ...schema,
+        external: schema.ownership?.kind === 'external',
+        enumType,
+        enumValues: enumValues.map((value, index) => ({
+            name: typeof value === 'string' ? value : `Value${index + 1}`,
+            value: typeof value === 'string' ? JSON.stringify(value) : String(value),
+        })),
+        aliasType: schema.aliasType
+            ? goType(schema.aliasType)
+            : schema.additionalPropertiesType
+                ? goType(`Record<string, ${schema.additionalPropertiesType}>`)
+                : 'interface{}',
+        properties: schema.properties.map((property) => ({
+            ...property,
+            targetType: property.type === 'string' &&
+                (property.format === 'date' || property.format === 'date-time')
+                ? 'time.Time'
+                : goType(property.type),
+            optional: !!property.nullable || !property.required,
+        })),
+    };
 }
 export class GoAdapter {
-    language = "go";
-    async emit(enriched, outputDir, config) {
+    language = 'go';
+    async emit(enriched, _outputDir, config) {
         registerHelpers();
-        registerGoHelpers();
         const files = [];
-        const warnings = [];
-        const schemaNames = new Set(enriched.schemas.map((s) => s.name));
-        const clientType = config?.clientType ?? "internal";
-        // ── Visibility filtering ───────────────────────────────────────────────
-        const visibleGroups = [];
-        for (const g of enriched.groups) {
-            if (clientType === "public" && g.visibility === "internal")
-                continue;
-            const ops = clientType === "public"
-                ? g.operations.filter((op) => op.visibility !== "internal")
-                : g.operations;
-            if (ops.length === 0)
-                continue;
-            visibleGroups.push(ops === g.operations ? g : { ...g, operations: ops });
-        }
-        const hasSSE = visibleGroups.some((g) => g.operations.some((op) => op.isEventStream));
-        const pkgName = (enriched.meta.packageName.split("/").pop() || "sdk")
-            .replace(/[^a-zA-Z0-9_]/g, "_")
-            .replace(/^[^a-zA-Z_]/, "sdk");
-        // ── Emit helper ────────────────────────────────────────────────────────
-        const emit = (relativePath, templateName, ctx) => {
-            try {
-                const tpl = getTemplate("go", templateName);
-                files.push({ relativePath, content: tpl(ctx) });
-            }
-            catch (err) {
-                warnings.push(`${relativePath}: ${err instanceof Error ? err.message : String(err)}`);
-            }
+        const clientType = config?.clientType ?? 'internal';
+        const visibleGroups = getVisibleGroups(enriched, clientType);
+        const visibleSchemas = getVisibleSchemas(enriched, visibleGroups, clientType);
+        const schemaNames = new Set(visibleSchemas.map((schema) => schema.name));
+        const schemas = visibleSchemas.map(transformSchema);
+        const packageVersion = getPackageVersion(enriched);
+        const hasSSE = hasEventStreams(visibleGroups);
+        const moduleName = enriched.meta.packageName
+            .replace(/^@/, '')
+            .split('/')
+            .filter(Boolean)
+            .map((part) => part.replace(/[^a-zA-Z0-9._~-]/g, '-'))
+            .join('/') || 'sdk';
+        const pkgName = (moduleName.split('/').pop() || 'sdk')
+            .replace(/[^a-zA-Z0-9_]/g, '_')
+            .replace(/^[^a-zA-Z_]/, 'sdk');
+        const emit = (relativePath, templateName, context) => {
+            files.push({
+                relativePath,
+                content: getTemplate('go', templateName)(context),
+            });
         };
-        // ── Root files ─────────────────────────────────────────────────────────
-        emit("go.mod", "go-mod", {
-            ...enriched.meta,
-            pkgName,
-        });
-        emit("README.md", "readme", {
+        emit('go.mod', 'go-mod', { ...enriched.meta, packageVersion, moduleName });
+        emit('README.md', 'readme', {
             ...enriched.meta,
+            packageVersion,
             groups: visibleGroups,
-            schemas: enriched.schemas,
+            schemas,
             securitySchemes: enriched.securitySchemes,
             hasSSE,
             pkgName,
         });
-        // ── Core package files ─────────────────────────────────────────────────
-        emit("client.go", "client", {
+        emit('client.go', 'client', {
             ...enriched.meta,
+            packageVersion,
             groups: visibleGroups,
             securitySchemes: enriched.securitySchemes,
             hasSSE,
             pkgName,
-            clientType,
+            clientType: config?.clientType ?? 'internal',
         });
-        emit("transport.go", "transport", {
+        emit('transport.go', 'transport', {
             securitySchemes: enriched.securitySchemes,
+            packageVersion,
             pkgName,
         });
-        emit("errors.go", "errors", {
-            pkgName,
-        });
-        emit("types.go", "types", {
-            schemas: enriched.schemas,
+        emit('errors.go', 'errors', { pkgName });
+        emit('types.go', 'types', {
+            schemas,
             pkgName,
+            needsTime: schemas.some((schema) => schema.properties.some((property) => property.targetType === 'time.Time')),
         });
-        emit("utils.go", "utils", {
-            pkgName,
-        });
-        // ── Domain files ───────────────────────────────────────────────────────
+        emit('utils.go', 'utils', { pkgName });
         for (const group of visibleGroups) {
-            const imports = collectImports(group.operations, schemaNames);
-            const groupHasSSE = group.operations.some((op) => op.isEventStream);
-            emit(`${group.fileName}.go`, "domain", {
+            const operations = group.operations.map((operation) => {
+                const pathParams = operation.pathParams.map(transformParameter);
+                const queryParams = operation.queryParams.map(transformParameter);
+                const headerParams = operation.headerParams.map(transformParameter);
+                const requestBody = operation.requestBody
+                    ? {
+                        ...operation.requestBody,
+                        targetType: goType(operation.requestBody.type),
+                        inputType: operation.requestBody.required
+                            ? goType(operation.requestBody.type)
+                            : `*${goType(operation.requestBody.type)}`,
+                    }
+                    : undefined;
+                return {
+                    ...operation,
+                    pathParams,
+                    queryParams,
+                    headerParams,
+                    requestBody,
+                    goResponseType: goType(operation.responseType),
+                    hasQueryParams: queryParams.length > 0,
+                    hasHeaderParams: headerParams.length > 0,
+                    needsFormatting: queryParams.length > 0 || headerParams.length > 0,
+                };
+            });
+            emit(`${group.fileName}.go`, 'domain', {
                 ...group,
-                imports,
-                hasSSE: groupHasSSE,
+                operations,
+                imports: collectImports(group.operations, schemaNames),
+                hasSSE: operations.some((operation) => operation.isEventStream),
+                hasQueryParams: operations.some((operation) => operation.hasQueryParams),
+                needsFormatting: operations.some((operation) => operation.needsFormatting),
                 securitySchemes: enriched.securitySchemes,
                 pkgName,
             });
         }
-        return { files, warnings };
+        files.push(...createDocumentationFiles({
+            meta: enriched.meta,
+            groups: visibleGroups,
+            schemas: visibleSchemas,
+            naming: {
+                language: 'Go',
+                groupAccessor: (group) => `client.${pascalCase(group.name)}`,
+                methodName: (operation) => pascalCase(operation.name),
+                typeName: goType,
+                sourcePath: (group) => `${group.fileName}.go`,
+            },
+        }));
+        return { files, warnings: [] };
     }
 }
 //# sourceMappingURL=index.js.map