@xemahq/api-client-generator 0.1.1

package/dist/lib/default-stubs.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyDefaultOpenApiStubs = applyDefaultOpenApiStubs;
+const node_path_1 = require("node:path");
+function tryResolveExport(fromDir, request, exportName) {
+    try {
+        const resolved = require.resolve(request, { paths: [fromDir] });
+        const mod = require(resolved);
+        return mod[exportName];
+    }
+    catch {
+        return undefined;
+    }
+}
+function createPrismaStub() {
+    const handler = {
+        get: (_t, prop) => {
+            if (prop === 'then')
+                return undefined;
+            if (prop === '$connect' || prop === '$disconnect' || prop === '$on') {
+                return () => Promise.resolve();
+            }
+            return new Proxy((() => Promise.resolve([])), handler);
+        },
+        apply: () => Promise.resolve([]),
+    };
+    return new Proxy({}, handler);
+}
+const IDENTITY_STUB = {
+    waitForReady: async () => true,
+    getAccessToken: async () => 'dummy-token',
+    getKeycloakBaseUrl: () => 'http://localhost:8180',
+    getAllowedRealms: () => ['master'],
+    getClientId: () => 'openapi-extraction',
+};
+const EVENT_HUB_BOOTSTRAP_STUB = {
+    onModuleInit: async () => { },
+    onModuleDestroy: async () => { },
+    isEventHubRegistered: () => true,
+    waitForRegistration: async () => true,
+};
+const EVENT_HUB_CLIENT_STUB = {
+    getAuthInfo: () => ({
+        jwksUrl: 'http://localhost:8180/realms/dummy/protocol/openid-connect/certs',
+        issuer: 'http://localhost:8180/realms/dummy',
+    }),
+};
+function applyDefaultOpenApiStubs(builder, serviceDir) {
+    const PrismaService = tryResolveExport(serviceDir, (0, node_path_1.join)(serviceDir, 'src', 'prisma', 'prisma.service'), 'PrismaService');
+    if (PrismaService) {
+        builder.overrideProvider(PrismaService).useValue(createPrismaStub());
+    }
+    const IdentityBootstrapService = tryResolveExport(serviceDir, '@xemahq/identity-client', 'IdentityBootstrapService');
+    if (IdentityBootstrapService) {
+        builder
+            .overrideProvider(IdentityBootstrapService)
+            .useValue(IDENTITY_STUB);
+    }
+    const EventHubBootstrapService = tryResolveExport(serviceDir, '@xemahq/event-hub-client', 'EventHubBootstrapService');
+    if (EventHubBootstrapService) {
+        builder
+            .overrideProvider(EventHubBootstrapService)
+            .useValue(EVENT_HUB_BOOTSTRAP_STUB);
+    }
+    const EventHubClient = tryResolveExport(serviceDir, '@xemahq/event-hub-client', 'EventHubClient');
+    if (EventHubClient) {
+        builder
+            .overrideProvider(EventHubClient)
+            .useValue(EVENT_HUB_CLIENT_STUB);
+    }
+    const ServiceTokenGuard = tryResolveExport(serviceDir, '@xemahq/platform-common', 'ServiceTokenGuard');
+    if (ServiceTokenGuard) {
+        builder
+            .overrideGuard(ServiceTokenGuard)
+            .useValue({ canActivate: () => true });
+    }
+    const XemaRuntimeScanner = tryResolveExport(serviceDir, '@xemahq/xema-decorators', 'XemaRuntimeScanner');
+    if (XemaRuntimeScanner) {
+        builder.overrideProvider(XemaRuntimeScanner).useValue({
+            onApplicationBootstrap: async () => { },
+        });
+    }
+    const discoveryStub = { getProviders: () => [], getControllers: () => [] };
+    const coreRoots = new Set([serviceDir]);
+    try {
+        coreRoots.add((0, node_path_1.dirname)(require.resolve('@xemahq/xema-decorators', { paths: [serviceDir] })));
+    }
+    catch {
+    }
+    const seenDiscovery = new Set();
+    for (const root of coreRoots) {
+        const DiscoveryService = tryResolveExport(root, '@nestjs/core', 'DiscoveryService');
+        if (DiscoveryService && !seenDiscovery.has(DiscoveryService)) {
+            seenDiscovery.add(DiscoveryService);
+            builder.overrideProvider(DiscoveryService).useValue(discoveryStub);
+        }
+    }
+    const SERVICE_REGISTRY_TOKEN = tryResolveExport(serviceDir, '@xemahq/service-registry-nest', 'SERVICE_REGISTRY_TOKEN');
+    const createOpenApiStubRegistry = tryResolveExport(serviceDir, '@xemahq/service-registry-nest', 'createOpenApiStubRegistry');
+    if (SERVICE_REGISTRY_TOKEN && createOpenApiStubRegistry) {
+        builder
+            .overrideProvider(SERVICE_REGISTRY_TOKEN)
+            .useValue(createOpenApiStubRegistry());
+    }
+    return builder;
+}
+//# sourceMappingURL=default-stubs.js.map

package/dist/lib/default-stubs.js.map

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

package/dist/lib/extract-openapi.d.ts

@@ -0,0 +1,4 @@
+import { ApiSurface } from '@xemahq/xema-decorators';
+export declare function extractOpenApiForService(serviceDir?: string): Promise<ApiSurface[]>;
+export declare function runOpenApiCli(): void;
+//# sourceMappingURL=extract-openapi.d.ts.map

package/dist/lib/extract-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-openapi.d.ts","sourceRoot":"","sources":["../../src/lib/extract-openapi.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,UAAU,EAGX,MAAM,yBAAyB,CAAC;AAqFjC,wBAAsB,wBAAwB,CAC5C,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC,CAgGvB;AAGD,wBAAgB,aAAa,IAAI,IAAI,CAQpC"}

package/dist/lib/extract-openapi.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractOpenApiForService = extractOpenApiForService;
+exports.runOpenApiCli = runOpenApiCli;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const xema_decorators_1 = require("@xemahq/xema-decorators");
+const default_stubs_1 = require("./default-stubs");
+const overrides_1 = require("./overrides");
+const prune_spec_1 = require("./prune-spec");
+const seed_openapi_env_1 = require("./seed-openapi-env");
+const service_nest_1 = require("./service-nest");
+const service_config_1 = require("./service-config");
+const HTTP_METHODS = new Set([
+    'get',
+    'post',
+    'put',
+    'patch',
+    'delete',
+    'options',
+    'head',
+    'trace',
+]);
+function collectDocOperationIds(doc) {
+    const ids = new Set();
+    for (const pathItem of Object.values(doc.paths ?? {})) {
+        if (!pathItem)
+            continue;
+        for (const [method, op] of Object.entries(pathItem)) {
+            if (!HTTP_METHODS.has(method.toLowerCase()))
+                continue;
+            const id = op?.operationId;
+            if (typeof id === 'string')
+                ids.add(id);
+        }
+    }
+    return ids;
+}
+async function buildApp(ctx, nest) {
+    const appModuleMod = require((0, node_path_1.join)(ctx.serviceDir, 'src', 'app.module'));
+    if (!appModuleMod.AppModule) {
+        throw new Error(`api-client-generator: ${(0, node_path_1.join)(ctx.serviceDir, 'src/app.module')} does not ` +
+            `export \`AppModule\`.`);
+    }
+    let builder = nest.Test.createTestingModule({
+        imports: [appModuleMod.AppModule],
+    });
+    builder = (0, default_stubs_1.applyDefaultOpenApiStubs)(builder, ctx.serviceDir);
+    const overrides = (0, overrides_1.loadServiceOverrides)(ctx.serviceDir);
+    if (overrides?.applyOverrides) {
+        builder = overrides.applyOverrides(builder) ?? builder;
+    }
+    const moduleRef = await builder.compile();
+    return moduleRef.createNestApplication();
+}
+async function extractOpenApiForService(serviceDir = process.cwd()) {
+    (0, seed_openapi_env_1.seedOpenApiEnv)();
+    const ctx = (0, service_config_1.resolveServiceContext)(serviceDir);
+    const overrides = (0, overrides_1.loadServiceOverrides)(ctx.serviceDir);
+    if (overrides?.env) {
+        for (const [k, v] of Object.entries(overrides.env)) {
+            if (process.env[k] === undefined)
+                process.env[k] = v;
+        }
+    }
+    const nest = (0, service_nest_1.loadServiceNest)(ctx.serviceDir);
+    const app = await buildApp(ctx, nest);
+    try {
+        const builder = new nest.DocumentBuilder()
+            .setTitle(ctx.api.title)
+            .setVersion(ctx.version)
+            .addBearerAuth();
+        if (ctx.api.description) {
+            builder.setDescription(ctx.api.description);
+        }
+        const fullDoc = nest.SwaggerModule.createDocument(app, builder.build(), {
+            operationIdFactory: (controllerKey, methodKey) => `${controllerKey}_${methodKey}`,
+        });
+        const modulesContainer = app.get(nest.ModulesContainer, { strict: false });
+        const discovery = new nest.DiscoveryService(modulesContainer);
+        const metadataScanner = new nest.MetadataScanner();
+        const scan = (0, xema_decorators_1.scanApiSurfaces)(discovery, metadataScanner);
+        const docOps = collectDocOperationIds(fullDoc);
+        const unclassifiedInDoc = scan.unclassified.filter((u) => docOps.has(u.operationId));
+        if (unclassifiedInDoc.length > 0) {
+            (0, xema_decorators_1.assertNoUnclassifiedSurfaces)(ctx.api.serviceId, {
+                surfaces: scan.surfaces,
+                excluded: scan.excluded,
+                unclassified: unclassifiedInDoc,
+            });
+        }
+        const seen = new Set([
+            ...scan.surfaces.keys(),
+            ...scan.excluded,
+            ...scan.unclassified.map((u) => u.operationId),
+        ]);
+        const unaccounted = [...docOps].filter((id) => !seen.has(id));
+        if (unaccounted.length > 0) {
+            throw new Error(`api-client-generator: ${ctx.api.serviceId} has ${unaccounted.length} ` +
+                `OpenAPI operation(s) the surface scan never saw ` +
+                `(${unaccounted.join(', ')}). A controller is emitted into the spec ` +
+                `but unreachable from the DiscoveryService scan.`);
+        }
+        const written = [];
+        for (const surface of prune_spec_1.ALL_SURFACES) {
+            const keep = new Set([...scan.surfaces.entries()]
+                .filter(([, s]) => s === surface)
+                .map(([id]) => id));
+            const specPath = (0, service_config_1.surfaceSpecPath)(ctx, surface);
+            const { doc, pathCount } = (0, prune_spec_1.pruneSpecForSurface)(fullDoc, keep);
+            if (pathCount === 0) {
+                if ((0, node_fs_1.existsSync)(specPath))
+                    (0, node_fs_1.rmSync)(specPath);
+                continue;
+            }
+            (0, node_fs_1.writeFileSync)(specPath, `${JSON.stringify(doc, null, 2)}\n`, 'utf8');
+            written.push(surface);
+        }
+        console.log(`[xema-openapi] ${ctx.api.serviceId}: wrote ${written.length} surface spec(s) → ${written.join(', ') || '(none)'}`);
+        return written;
+    }
+    finally {
+        await app.close().catch(() => { });
+    }
+}
+function runOpenApiCli() {
+    extractOpenApiForService()
+        .then(() => process.exit(0))
+        .catch((err) => {
+        console.error('[xema-openapi] extraction failed:', err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=extract-openapi.js.map

package/dist/lib/extract-openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-openapi.js","sourceRoot":"","sources":["../../src/lib/extract-openapi.ts"],"names":[],"mappings":";;AA6FA,4DAkGC;AAGD,sCAQC;AA1MD,qCAA4D;AAC5D,yCAAiC;AAGjC,6DAIiC;AAEjC,mDAA2D;AAC3D,2CAAmD;AACnD,6CAAiE;AACjE,yDAAoD;AACpD,iDAAmE;AACnE,qDAI0B;AAO1B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAGH,SAAS,sBAAsB,CAAC,GAAe;IAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,KAAK,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBAAE,SAAS;YACtD,MAAM,EAAE,GAAI,EAAgC,EAAE,WAAW,CAAC;YAC1D,IAAI,OAAO,EAAE,KAAK,QAAQ;gBAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,GAA2B,EAC3B,IAAiB;IAKjB,MAAM,YAAY,GAAG,OAAO,CAAC,IAAA,gBAAI,EAAC,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC,CAErE,CAAC;IACF,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAA,gBAAI,EAAC,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,YAAY;YACzE,uBAAuB,CAC1B,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC;QAC1C,OAAO,EAAE,CAAC,YAAY,CAAC,SAAkB,CAAC;KAC3C,CAAC,CAAC;IACH,OAAO,GAAG,IAAA,wCAAwB,EAAC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,IAAA,gCAAoB,EAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,SAAS,EAAE,cAAc,EAAE,CAAC;QAC9B,OAAO,GAAG,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;IACzD,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAG1C,OAAO,SAAS,CAAC,qBAAqB,EAAE,CAAC;AAC3C,CAAC;AAcM,KAAK,UAAU,wBAAwB,CAC5C,aAAqB,OAAO,CAAC,GAAG,EAAE;IAGlC,IAAA,iCAAc,GAAE,CAAC;IACjB,MAAM,GAAG,GAAG,IAAA,sCAAqB,EAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAA,gCAAoB,EAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,SAAS,EAAE,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAA,8BAAe,EAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,eAAe,EAAE;aACvC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;aACvB,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC;aACvB,aAAa,EAAE,CAAC;QACnB,IAAI,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE;YACtE,kBAAkB,EAAE,CAAC,aAAqB,EAAE,SAAiB,EAAE,EAAE,CAC/D,GAAG,aAAa,IAAI,SAAS,EAAE;SAClC,CAA0B,CAAC;QAM5B,MAAM,gBAAgB,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QAC9D,MAAM,eAAe,GAAG,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,IAAA,iCAAe,EAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAMzD,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACvD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAC1B,CAAC;QACF,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,IAAA,8CAA4B,EAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE;gBAC9C,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,YAAY,EAAE,iBAAiB;aAChC,CAAC,CAAC;QACL,CAAC;QAID,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS;YAC3B,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YACvB,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;SAC/C,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,CAAC,GAAG,CAAC,SAAS,QAAQ,WAAW,CAAC,MAAM,GAAG;gBACrE,kDAAkD;gBAClD,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,2CAA2C;gBACrE,iDAAiD,CACpD,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,KAAK,MAAM,OAAO,IAAI,yBAAY,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;iBACzB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC;iBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CACrB,CAAC;YACF,MAAM,QAAQ,GAAG,IAAA,gCAAe,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAA,gCAAmB,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC9D,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;gBAEpB,IAAI,IAAA,oBAAU,EAAC,QAAQ,CAAC;oBAAE,IAAA,gBAAM,EAAC,QAAQ,CAAC,CAAC;gBAC3C,SAAS;YACX,CAAC;YACD,IAAA,uBAAa,EAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAGD,OAAO,CAAC,GAAG,CACT,kBAAkB,GAAG,CAAC,GAAG,CAAC,SAAS,WACjC,OAAO,CAAC,MACV,sBAAsB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CACvD,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAGD,SAAgB,aAAa;IAC3B,wBAAwB,EAAE;SACvB,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAEtB,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/lib/generate-clients.d.ts

@@ -0,0 +1,4 @@
+import { ApiSurface } from '@xemahq/xema-decorators';
+export declare function generateClientsForService(serviceDir?: string): Promise<ApiSurface[]>;
+export declare function runClientGenerateCli(): void;
+//# sourceMappingURL=generate-clients.d.ts.map

package/dist/lib/generate-clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-clients.d.ts","sourceRoot":"","sources":["../../src/lib/generate-clients.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA6ErD,wBAAsB,yBAAyB,CAC7C,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC,CAwCvB;AAGD,wBAAgB,oBAAoB,IAAI,IAAI,CAQ3C"}

package/dist/lib/generate-clients.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateClientsForService = generateClientsForService;
+exports.runClientGenerateCli = runClientGenerateCli;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const client_package_1 = require("./client-package");
+const client_readme_1 = require("./client-readme");
+const repo_post_process_1 = require("./repo-post-process");
+const prune_spec_1 = require("./prune-spec");
+const service_config_1 = require("./service-config");
+async function importFromService(serviceDir, request) {
+    const resolved = require.resolve(request, { paths: [serviceDir] });
+    const dynamicImport = new Function('u', 'return import(u)');
+    return dynamicImport((0, node_url_1.pathToFileURL)(resolved).href);
+}
+async function resolveOrvalGenerate(serviceDir) {
+    const mod = await importFromService(serviceDir, 'orval');
+    const generate = mod.generate ??
+        (mod.default?.generate);
+    if (typeof generate !== 'function') {
+        throw new Error('api-client-generator: could not resolve orval `generate` from the service.');
+    }
+    return generate;
+}
+function orvalConfigFor(specPath, clientSrc) {
+    return {
+        input: { target: specPath },
+        output: {
+            mode: 'tags-split',
+            target: `${clientSrc}/endpoints`,
+            schemas: `${clientSrc}/models`,
+            client: 'fetch',
+            override: {
+                fetch: { includeHttpResponseReturnType: false },
+                mutator: {
+                    path: `${clientSrc}/custom-fetch.ts`,
+                    name: 'customFetch',
+                },
+            },
+        },
+    };
+}
+async function generateClientsForService(serviceDir = process.cwd()) {
+    const ctx = (0, service_config_1.resolveServiceContext)(serviceDir);
+    const generate = await resolveOrvalGenerate(ctx.serviceDir);
+    const generated = [];
+    for (const surface of prune_spec_1.ALL_SURFACES) {
+        const specPath = (0, service_config_1.surfaceSpecPath)(ctx, surface);
+        if (!(0, node_fs_1.existsSync)(specPath)) {
+            continue;
+        }
+        const { clientDir, clientSrc } = (0, client_package_1.ensureClientPackage)(ctx, surface);
+        (0, client_readme_1.ensureClientReadme)({
+            clientDir,
+            packageName: (0, service_config_1.surfaceClientPackageName)(ctx.api.serviceId, surface),
+            serviceTitle: ctx.api.title,
+            surface,
+            repoRoot: ctx.repoRoot,
+        });
+        (0, node_fs_1.rmSync)((0, node_path_1.join)(clientSrc, 'endpoints'), { recursive: true, force: true });
+        (0, node_fs_1.rmSync)((0, node_path_1.join)(clientSrc, 'models'), { recursive: true, force: true });
+        await generate(orvalConfigFor(specPath, clientSrc));
+        (0, repo_post_process_1.postProcessClient)(ctx.repoRoot, ctx.serviceDir, clientSrc);
+        (0, node_child_process_1.execFileSync)('pnpm', ['exec', 'tsc', '-p', 'tsconfig.json'], {
+            cwd: clientDir,
+            stdio: 'inherit',
+        });
+        generated.push(surface);
+    }
+    console.log(`[xema-client-generate] ${ctx.api.serviceId}: generated ${generated.length} client(s) → ${generated.join(', ') || '(none)'}`);
+    return generated;
+}
+function runClientGenerateCli() {
+    generateClientsForService()
+        .then(() => process.exit(0))
+        .catch((err) => {
+        console.error('[xema-client-generate] generation failed:', err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=generate-clients.js.map

package/dist/lib/generate-clients.js.map

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

package/dist/lib/overrides.d.ts

@@ -0,0 +1,7 @@
+import type { TestingModuleBuilder } from '@nestjs/testing';
+export interface OpenApiOverrides {
+    readonly env?: Record<string, string>;
+    readonly applyOverrides?: (builder: TestingModuleBuilder) => TestingModuleBuilder | void;
+}
+export declare function loadServiceOverrides(serviceDir: string): OpenApiOverrides | undefined;
+//# sourceMappingURL=overrides.d.ts.map

package/dist/lib/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../src/lib/overrides.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAiB5D,MAAM,WAAW,gBAAgB;IAE/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAMtC,QAAQ,CAAC,cAAc,CAAC,EAAE,CACxB,OAAO,EAAE,oBAAoB,KAC1B,oBAAoB,GAAG,IAAI,CAAC;CAClC;AASD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GACjB,gBAAgB,GAAG,SAAS,CA6B9B"}

package/dist/lib/overrides.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadServiceOverrides = loadServiceOverrides;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const OVERRIDES_BASENAME = 'openapi.overrides';
+function loadServiceOverrides(serviceDir) {
+    const candidate = [`${OVERRIDES_BASENAME}.ts`, `${OVERRIDES_BASENAME}.js`]
+        .map((f) => (0, node_path_1.join)(serviceDir, f))
+        .find((p) => (0, node_fs_1.existsSync)(p));
+    if (!candidate) {
+        return undefined;
+    }
+    const mod = require(candidate);
+    const overrides = mod.default ?? mod;
+    if (overrides.env !== undefined &&
+        (typeof overrides.env !== 'object' || overrides.env === null)) {
+        throw new Error(`api-client-generator: ${candidate} \`env\` must be a Record<string,string>.`);
+    }
+    if (overrides.applyOverrides !== undefined &&
+        typeof overrides.applyOverrides !== 'function') {
+        throw new Error(`api-client-generator: ${candidate} \`applyOverrides\` must be a function.`);
+    }
+    return overrides;
+}
+//# sourceMappingURL=overrides.js.map

package/dist/lib/overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.js","sourceRoot":"","sources":["../../src/lib/overrides.ts"],"names":[],"mappings":";;AAwCA,oDA+BC;AAvED,qCAAqC;AACrC,yCAAiC;AAgCjC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAO/C,SAAgB,oBAAoB,CAClC,UAAkB;IAElB,MAAM,SAAS,GAAG,CAAC,GAAG,kBAAkB,KAAK,EAAE,GAAG,kBAAkB,KAAK,CAAC;SACvE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,gBAAI,EAAC,UAAU,EAAE,CAAC,CAAC,CAAC;SAC/B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,oBAAU,EAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAET,CAAC;IACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;IACrC,IACE,SAAS,CAAC,GAAG,KAAK,SAAS;QAC3B,CAAC,OAAO,SAAS,CAAC,GAAG,KAAK,QAAQ,IAAI,SAAS,CAAC,GAAG,KAAK,IAAI,CAAC,EAC7D,CAAC;QACD,MAAM,IAAI,KAAK,CACb,yBAAyB,SAAS,2CAA2C,CAC9E,CAAC;IACJ,CAAC;IACD,IACE,SAAS,CAAC,cAAc,KAAK,SAAS;QACtC,OAAO,SAAS,CAAC,cAAc,KAAK,UAAU,EAC9C,CAAC;QACD,MAAM,IAAI,KAAK,CACb,yBAAyB,SAAS,yCAAyC,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/prune-spec.d.ts

@@ -0,0 +1,16 @@
+import { ApiSurface } from '@xemahq/xema-decorators';
+interface OpenApiDoc {
+    paths?: Record<string, Record<string, unknown> | undefined>;
+    components?: {
+        schemas?: Record<string, unknown>;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+export declare function pruneSpecForSurface(fullDoc: OpenApiDoc, keepOperationIds: ReadonlySet<string>): {
+    doc: OpenApiDoc;
+    pathCount: number;
+};
+export declare const ALL_SURFACES: readonly ApiSurface[];
+export {};
+//# sourceMappingURL=prune-spec.d.ts.map

package/dist/lib/prune-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-spec.d.ts","sourceRoot":"","sources":["../../src/lib/prune-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;IACF,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAkDD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EACnB,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,GACpC;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAiExC;AAGD,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAI7C,CAAC"}

package/dist/lib/prune-spec.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_SURFACES = void 0;
+exports.pruneSpecForSurface = pruneSpecForSurface;
+const xema_decorators_1 = require("@xemahq/xema-decorators");
+const HTTP_METHODS = new Set([
+    'get',
+    'post',
+    'put',
+    'patch',
+    'delete',
+    'options',
+    'head',
+    'trace',
+]);
+const SCHEMA_REF_PREFIX = '#/components/schemas/';
+function collectSchemaRefs(node, out) {
+    if (Array.isArray(node)) {
+        for (const item of node) {
+            collectSchemaRefs(item, out);
+        }
+        return;
+    }
+    if (node && typeof node === 'object') {
+        for (const [key, value] of Object.entries(node)) {
+            if (key === '$ref' && typeof value === 'string') {
+                if (value.startsWith(SCHEMA_REF_PREFIX)) {
+                    out.add(value.slice(SCHEMA_REF_PREFIX.length));
+                }
+            }
+            else {
+                collectSchemaRefs(value, out);
+            }
+        }
+    }
+}
+function pruneSpecForSurface(fullDoc, keepOperationIds) {
+    const clone = JSON.parse(JSON.stringify(fullDoc));
+    const paths = clone.paths ?? {};
+    let pathCount = 0;
+    for (const [pathKey, pathItem] of Object.entries(paths)) {
+        if (!pathItem || typeof pathItem !== 'object') {
+            delete paths[pathKey];
+            continue;
+        }
+        for (const [method, operation] of Object.entries(pathItem)) {
+            if (!HTTP_METHODS.has(method.toLowerCase())) {
+                continue;
+            }
+            const operationId = operation?.operationId;
+            if (typeof operationId !== 'string' ||
+                !keepOperationIds.has(operationId)) {
+                delete pathItem[method];
+            }
+        }
+        const remainingMethods = Object.keys(pathItem).filter((k) => HTTP_METHODS.has(k.toLowerCase()));
+        if (remainingMethods.length === 0) {
+            delete paths[pathKey];
+        }
+        else {
+            pathCount += remainingMethods.length;
+        }
+    }
+    clone.paths = paths;
+    const allSchemas = clone.components?.schemas;
+    if (allSchemas && typeof allSchemas === 'object') {
+        const reachable = new Set();
+        collectSchemaRefs(clone.paths, reachable);
+        const queue = [...reachable];
+        while (queue.length > 0) {
+            const name = queue.pop();
+            const schema = allSchemas[name];
+            if (schema === undefined) {
+                continue;
+            }
+            const nested = new Set();
+            collectSchemaRefs(schema, nested);
+            for (const ref of nested) {
+                if (!reachable.has(ref)) {
+                    reachable.add(ref);
+                    queue.push(ref);
+                }
+            }
+        }
+        const pruned = {};
+        for (const [name, schema] of Object.entries(allSchemas)) {
+            if (reachable.has(name)) {
+                pruned[name] = schema;
+            }
+        }
+        clone.components = { ...clone.components, schemas: pruned };
+    }
+    return { doc: clone, pathCount };
+}
+exports.ALL_SURFACES = [
+    xema_decorators_1.ApiSurface.Public,
+    xema_decorators_1.ApiSurface.Internal,
+    xema_decorators_1.ApiSurface.Operator,
+];
+//# sourceMappingURL=prune-spec.js.map

package/dist/lib/prune-spec.js.map

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

package/dist/lib/repo-post-process.d.ts

@@ -0,0 +1,9 @@
+interface PostProcessors {
+    regenerateModelsBarrel: (clientSrc: string) => number;
+    fixOrvalResponseTypes: (serviceRoot: string) => number;
+    fixOrvalArrayParams: (clientSrc: string) => number;
+}
+export declare function loadRepoPostProcessors(repoRoot: string): PostProcessors;
+export declare function postProcessClient(repoRoot: string, serviceRoot: string, clientSrc: string): void;
+export {};
+//# sourceMappingURL=repo-post-process.d.ts.map

package/dist/lib/repo-post-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-post-process.d.ts","sourceRoot":"","sources":["../../src/lib/repo-post-process.ts"],"names":[],"mappings":"AAeA,UAAU,cAAc;IACtB,sBAAsB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACtD,qBAAqB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACpD;AAcD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAcvE;AAmDD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CAMN"}

package/dist/lib/repo-post-process.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadRepoPostProcessors = loadRepoPostProcessors;
+exports.postProcessClient = postProcessClient;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function requireRepoTool(repoRoot, file) {
+    const path = (0, node_path_1.join)(repoRoot, 'tooling', 'codegen', file);
+    if (!(0, node_fs_1.existsSync)(path)) {
+        throw new Error(`api-client-generator: required post-processor ${path} not found. The ` +
+            `repo must ship tooling/codegen/${file}.`);
+    }
+    return require(path);
+}
+function loadRepoPostProcessors(repoRoot) {
+    const { regenerateModelsBarrel } = requireRepoTool(repoRoot, 'regenerate-models-barrel.js');
+    const { fixOrvalResponseTypes } = requireRepoTool(repoRoot, 'fix-orval-response-types.js');
+    const { fixOrvalArrayParams } = requireRepoTool(repoRoot, 'fix-orval-array-params.js');
+    return { regenerateModelsBarrel, fixOrvalResponseTypes, fixOrvalArrayParams };
+}
+function rebuildIndexBarrel(clientSrc) {
+    const lines = [
+        '// Auto-generated by @xemahq/api-client-generator — do not edit manually.',
+        "export { configureClient, getClientConfig, ClientError, customFetch, type ClientConfig } from './custom-fetch';",
+    ];
+    const modelsIndex = (0, node_path_1.join)(clientSrc, 'models', 'index.ts');
+    if ((0, node_fs_1.existsSync)(modelsIndex)) {
+        const content = (0, node_fs_1.readFileSync)(modelsIndex, 'utf8');
+        if (/^export /m.test(content)) {
+            lines.push("export * from './models';");
+        }
+    }
+    const endpointsDir = (0, node_path_1.join)(clientSrc, 'endpoints');
+    if ((0, node_fs_1.existsSync)(endpointsDir)) {
+        for (const entry of (0, node_fs_1.readdirSync)(endpointsDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const files = (0, node_fs_1.readdirSync)((0, node_path_1.join)(endpointsDir, entry.name));
+            const tsFile = files.find((f) => f.endsWith('.ts') && !f.endsWith('.d.ts'));
+            if (tsFile) {
+                lines.push(`export * from './endpoints/${entry.name}/${tsFile.replace('.ts', '')}';`);
+            }
+        }
+    }
+    lines.push('');
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(clientSrc, 'index.ts'), lines.join('\n'));
+    return lines.length - 2;
+}
+function postProcessClient(repoRoot, serviceRoot, clientSrc) {
+    const tools = loadRepoPostProcessors(repoRoot);
+    tools.regenerateModelsBarrel(clientSrc);
+    rebuildIndexBarrel(clientSrc);
+    tools.fixOrvalResponseTypes(serviceRoot);
+    tools.fixOrvalArrayParams(clientSrc);
+}
+//# sourceMappingURL=repo-post-process.js.map

package/dist/lib/repo-post-process.js.map

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

package/dist/lib/seed-openapi-env.d.ts

@@ -0,0 +1,2 @@
+export declare function seedOpenApiEnv(): void;
+//# sourceMappingURL=seed-openapi-env.d.ts.map

package/dist/lib/seed-openapi-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-openapi-env.d.ts","sourceRoot":"","sources":["../../src/lib/seed-openapi-env.ts"],"names":[],"mappings":"AA6BA,wBAAgB,cAAc,IAAI,IAAI,CAkFrC"}