@xemahq/api-client-generator 0.1.5 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +0 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +0 -1
- package/dist/index.js.map +1 -1
- package/dist/lib/extract-openapi.d.ts.map +1 -1
- package/dist/lib/extract-openapi.js +20 -33
- package/dist/lib/extract-openapi.js.map +1 -1
- package/dist/lib/generate-clients.d.ts.map +1 -1
- package/dist/lib/generate-clients.js +32 -5
- package/dist/lib/generate-clients.js.map +1 -1
- package/dist/lib/seed-openapi-env.d.ts +2 -1
- package/dist/lib/seed-openapi-env.d.ts.map +1 -1
- package/dist/lib/seed-openapi-env.js +14 -4
- package/dist/lib/seed-openapi-env.js.map +1 -1
- package/package.json +3 -3
- package/dist/lib/prune-spec.d.ts +0 -16
- package/dist/lib/prune-spec.d.ts.map +0 -1
- package/dist/lib/prune-spec.js +0 -100
- package/dist/lib/prune-spec.js.map +0 -1
package/dist/index.d.ts
CHANGED
|
@@ -2,7 +2,6 @@ export * from './lib/service-config';
|
|
|
2
2
|
export * from './lib/overrides';
|
|
3
3
|
export * from './lib/seed-openapi-env';
|
|
4
4
|
export * from './lib/default-stubs';
|
|
5
|
-
export * from './lib/prune-spec';
|
|
6
5
|
export * from './lib/extract-openapi';
|
|
7
6
|
export * from './lib/repo-post-process';
|
|
8
7
|
export * from './lib/client-package';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -18,7 +18,6 @@ __exportStar(require("./lib/service-config"), exports);
|
|
|
18
18
|
__exportStar(require("./lib/overrides"), exports);
|
|
19
19
|
__exportStar(require("./lib/seed-openapi-env"), exports);
|
|
20
20
|
__exportStar(require("./lib/default-stubs"), exports);
|
|
21
|
-
__exportStar(require("./lib/prune-spec"), exports);
|
|
22
21
|
__exportStar(require("./lib/extract-openapi"), exports);
|
|
23
22
|
__exportStar(require("./lib/repo-post-process"), exports);
|
|
24
23
|
__exportStar(require("./lib/client-package"), exports);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,uDAAqC;AACrC,kDAAgC;AAChC,yDAAuC;AACvC,sDAAoC;AACpC,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,uDAAqC;AACrC,kDAAgC;AAChC,yDAAuC;AACvC,sDAAoC;AACpC,wDAAsC;AACtC,0DAAwC;AACxC,uDAAqC;AACrC,yDAAuC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extract-openapi.d.ts","sourceRoot":"","sources":["../../src/lib/extract-openapi.ts"],"names":[],"mappings":"AAIA,OAAO,
|
|
1
|
+
{"version":3,"file":"extract-openapi.d.ts","sourceRoot":"","sources":["../../src/lib/extract-openapi.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,UAAU,EAQX,MAAM,yBAAyB,CAAC;AAsDjC,wBAAsB,wBAAwB,CAC5C,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC,CAuIvB;AAGD,wBAAgB,aAAa,IAAI,IAAI,CAQpC"}
|
|
@@ -7,35 +7,9 @@ const node_path_1 = require("node:path");
|
|
|
7
7
|
const xema_decorators_1 = require("@xemahq/xema-decorators");
|
|
8
8
|
const default_stubs_1 = require("./default-stubs");
|
|
9
9
|
const overrides_1 = require("./overrides");
|
|
10
|
-
const prune_spec_1 = require("./prune-spec");
|
|
11
10
|
const seed_openapi_env_1 = require("./seed-openapi-env");
|
|
12
11
|
const service_nest_1 = require("./service-nest");
|
|
13
12
|
const service_config_1 = require("./service-config");
|
|
14
|
-
const HTTP_METHODS = new Set([
|
|
15
|
-
'get',
|
|
16
|
-
'post',
|
|
17
|
-
'put',
|
|
18
|
-
'patch',
|
|
19
|
-
'delete',
|
|
20
|
-
'options',
|
|
21
|
-
'head',
|
|
22
|
-
'trace',
|
|
23
|
-
]);
|
|
24
|
-
function collectDocOperationIds(doc) {
|
|
25
|
-
const ids = new Set();
|
|
26
|
-
for (const pathItem of Object.values(doc.paths ?? {})) {
|
|
27
|
-
if (!pathItem)
|
|
28
|
-
continue;
|
|
29
|
-
for (const [method, op] of Object.entries(pathItem)) {
|
|
30
|
-
if (!HTTP_METHODS.has(method.toLowerCase()))
|
|
31
|
-
continue;
|
|
32
|
-
const id = op?.operationId;
|
|
33
|
-
if (typeof id === 'string')
|
|
34
|
-
ids.add(id);
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
return ids;
|
|
38
|
-
}
|
|
39
13
|
async function buildApp(ctx, nest) {
|
|
40
14
|
const appModuleMod = require((0, node_path_1.join)(ctx.serviceDir, 'src', 'app.module'));
|
|
41
15
|
if (!appModuleMod.AppModule) {
|
|
@@ -54,8 +28,8 @@ async function buildApp(ctx, nest) {
|
|
|
54
28
|
return moduleRef.createNestApplication();
|
|
55
29
|
}
|
|
56
30
|
async function extractOpenApiForService(serviceDir = process.cwd()) {
|
|
57
|
-
(0, seed_openapi_env_1.seedOpenApiEnv)();
|
|
58
31
|
const ctx = (0, service_config_1.resolveServiceContext)(serviceDir);
|
|
32
|
+
(0, seed_openapi_env_1.seedOpenApiEnv)(ctx.api.serviceId);
|
|
59
33
|
const overrides = (0, overrides_1.loadServiceOverrides)(ctx.serviceDir);
|
|
60
34
|
if (overrides?.env) {
|
|
61
35
|
for (const [k, v] of Object.entries(overrides.env)) {
|
|
@@ -80,12 +54,10 @@ async function extractOpenApiForService(serviceDir = process.cwd()) {
|
|
|
80
54
|
const discovery = new nest.DiscoveryService(modulesContainer);
|
|
81
55
|
const metadataScanner = new nest.MetadataScanner();
|
|
82
56
|
const scan = (0, xema_decorators_1.scanApiSurfaces)(discovery, metadataScanner);
|
|
83
|
-
const docOps =
|
|
57
|
+
const docOps = (0, xema_decorators_1.collectOperationIds)(fullDoc);
|
|
84
58
|
const unclassifiedInDoc = scan.unclassified.filter((u) => docOps.has(u.operationId));
|
|
85
59
|
if (unclassifiedInDoc.length > 0) {
|
|
86
60
|
(0, xema_decorators_1.assertNoUnclassifiedSurfaces)(ctx.api.serviceId, {
|
|
87
|
-
surfaces: scan.surfaces,
|
|
88
|
-
excluded: scan.excluded,
|
|
89
61
|
unclassified: unclassifiedInDoc,
|
|
90
62
|
});
|
|
91
63
|
}
|
|
@@ -101,22 +73,37 @@ async function extractOpenApiForService(serviceDir = process.cwd()) {
|
|
|
101
73
|
`(${unaccounted.join(', ')}). A controller is emitted into the spec ` +
|
|
102
74
|
`but unreachable from the DiscoveryService scan.`);
|
|
103
75
|
}
|
|
76
|
+
const coverage = (0, xema_decorators_1.stampRouteExtensions)(fullDoc, scan.projections);
|
|
104
77
|
const written = [];
|
|
105
|
-
|
|
78
|
+
const emitted = new Set();
|
|
79
|
+
for (const surface of xema_decorators_1.ALL_SURFACES) {
|
|
106
80
|
const keep = new Set([...scan.surfaces.entries()]
|
|
107
81
|
.filter(([, s]) => s === surface)
|
|
108
82
|
.map(([id]) => id));
|
|
109
83
|
const specPath = (0, service_config_1.surfaceSpecPath)(ctx, surface);
|
|
110
|
-
const { doc, pathCount } = (0,
|
|
84
|
+
const { doc, pathCount } = (0, xema_decorators_1.pruneSpecForSurface)(fullDoc, keep);
|
|
111
85
|
if (pathCount === 0) {
|
|
112
86
|
if ((0, node_fs_1.existsSync)(specPath))
|
|
113
87
|
(0, node_fs_1.rmSync)(specPath);
|
|
114
88
|
continue;
|
|
115
89
|
}
|
|
90
|
+
for (const id of (0, xema_decorators_1.collectOperationIds)(doc))
|
|
91
|
+
emitted.add(id);
|
|
116
92
|
(0, node_fs_1.writeFileSync)(specPath, `${JSON.stringify(doc, null, 2)}\n`, 'utf8');
|
|
117
93
|
written.push(surface);
|
|
118
94
|
}
|
|
119
|
-
|
|
95
|
+
const expected = [...docOps].filter((id) => scan.surfaces.has(id) && !scan.excluded.has(id));
|
|
96
|
+
const lost = expected.filter((id) => !emitted.has(id));
|
|
97
|
+
if (lost.length > 0) {
|
|
98
|
+
throw new Error(`api-client-generator: ${ctx.api.serviceId} classified ` +
|
|
99
|
+
`${expected.length} OpenAPI operation(s) but only wrote ` +
|
|
100
|
+
`${emitted.size} — ${lost.length} operation(s) were lost between the ` +
|
|
101
|
+
`document and the per-surface spec(s) (${lost.join(', ')}). The ` +
|
|
102
|
+
`emitted spec would be incomplete and would truncate the generated ` +
|
|
103
|
+
`client.`);
|
|
104
|
+
}
|
|
105
|
+
console.log(`[xema-openapi] ${ctx.api.serviceId}: wrote ${written.length} surface spec(s) → ${written.join(', ') || '(none)'} ` +
|
|
106
|
+
`[${(0, xema_decorators_1.formatRouteExtensionCoverage)(coverage)}]`);
|
|
120
107
|
return written;
|
|
121
108
|
}
|
|
122
109
|
finally {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extract-openapi.js","sourceRoot":"","sources":["../../src/lib/extract-openapi.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"extract-openapi.js","sourceRoot":"","sources":["../../src/lib/extract-openapi.ts"],"names":[],"mappings":";;AAoEA,4DAyIC;AAGD,sCAQC;AAxND,qCAA4D;AAC5D,yCAAiC;AAGjC,6DAUiC;AAEjC,mDAA2D;AAC3D,2CAAmD;AACnD,yDAAoD;AACpD,iDAAmE;AACnE,qDAI0B;AAE1B,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;IAMlC,MAAM,GAAG,GAAG,IAAA,sCAAqB,EAAC,UAAU,CAAC,CAAC;IAC9C,IAAA,iCAAc,EAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,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,IAAA,qCAAmB,EAAC,OAAO,CAAC,CAAC;QAC5C,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,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;QAcD,MAAM,QAAQ,GAAG,IAAA,sCAAoB,EAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAEjE,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,OAAO,IAAI,8BAAY,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,qCAAmB,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,KAAK,MAAM,EAAE,IAAI,IAAA,qCAAmB,EAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3D,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;QAQD,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CACjC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CACxD,CAAC;QACF,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,CAAC,GAAG,CAAC,SAAS,cAAc;gBACtD,GAAG,QAAQ,CAAC,MAAM,uCAAuC;gBACzD,GAAG,OAAO,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,sCAAsC;gBACtE,yCAAyC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;gBACjE,oEAAoE;gBACpE,SAAS,CACZ,CAAC;QACJ,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,GAAG;YACrD,IAAI,IAAA,8CAA4B,EAAC,QAAQ,CAAC,GAAG,CAChD,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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generate-clients.d.ts","sourceRoot":"","sources":["../../src/lib/generate-clients.ts"],"names":[],"mappings":"AAKA,OAAO,
|
|
1
|
+
{"version":3,"file":"generate-clients.d.ts","sourceRoot":"","sources":["../../src/lib/generate-clients.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAoKnE,wBAAsB,yBAAyB,CAC7C,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC,CAqDvB;AAGD,wBAAgB,oBAAoB,IAAI,IAAI,CAQ3C"}
|
|
@@ -6,10 +6,10 @@ const node_child_process_1 = require("node:child_process");
|
|
|
6
6
|
const node_fs_1 = require("node:fs");
|
|
7
7
|
const node_path_1 = require("node:path");
|
|
8
8
|
const node_url_1 = require("node:url");
|
|
9
|
+
const xema_decorators_1 = require("@xemahq/xema-decorators");
|
|
9
10
|
const client_package_1 = require("./client-package");
|
|
10
11
|
const client_readme_1 = require("./client-readme");
|
|
11
12
|
const repo_post_process_1 = require("./repo-post-process");
|
|
12
|
-
const prune_spec_1 = require("./prune-spec");
|
|
13
13
|
const service_config_1 = require("./service-config");
|
|
14
14
|
async function importFromService(serviceDir, request) {
|
|
15
15
|
const resolved = require.resolve(request, { paths: [serviceDir] });
|
|
@@ -43,15 +43,41 @@ function orvalConfigFor(specPath, clientSrc) {
|
|
|
43
43
|
},
|
|
44
44
|
};
|
|
45
45
|
}
|
|
46
|
+
const KNOWN_ORPHANED_SURFACE_CLIENTS = Object.freeze({});
|
|
47
|
+
function assertNoOrphanedSurfaceClients(ctx, surfacesWithSpec) {
|
|
48
|
+
if (surfacesWithSpec.length === 0) {
|
|
49
|
+
return;
|
|
50
|
+
}
|
|
51
|
+
const orphans = xema_decorators_1.ALL_SURFACES.filter((surface) => !surfacesWithSpec.includes(surface) &&
|
|
52
|
+
(0, node_fs_1.existsSync)((0, node_path_1.join)((0, service_config_1.surfaceClientDir)(ctx, surface), 'src', 'endpoints')));
|
|
53
|
+
if (orphans.length === 0) {
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
const baselined = orphans.filter((surface) => Object.hasOwn(KNOWN_ORPHANED_SURFACE_CLIENTS, `${ctx.api.serviceId}:${surface}`));
|
|
57
|
+
const blocking = orphans.filter((surface) => !baselined.includes(surface));
|
|
58
|
+
for (const surface of baselined) {
|
|
59
|
+
const key = `${ctx.api.serviceId}:${surface}`;
|
|
60
|
+
console.warn(`[xema-client-generate] KNOWN ORPHAN ${key} — ${(0, service_config_1.surfaceClientDir)(ctx, surface)} ` +
|
|
61
|
+
`is stale and will not be regenerated. ${KNOWN_ORPHANED_SURFACE_CLIENTS[key]}`);
|
|
62
|
+
}
|
|
63
|
+
if (blocking.length === 0) {
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
throw new Error(`api-client-generator: ${ctx.api.serviceId} emits no spec for surface(s) ` +
|
|
67
|
+
`${blocking.join(', ')}, but a generated client package still exists at ` +
|
|
68
|
+
`${blocking.map((s) => (0, service_config_1.surfaceClientDir)(ctx, s)).join(', ')}. That client ` +
|
|
69
|
+
`is orphaned — it would keep exporting operations the surface no longer ` +
|
|
70
|
+
`has. Delete the package (and its workspace consumers) or restore the ` +
|
|
71
|
+
`surface classification.`);
|
|
72
|
+
}
|
|
46
73
|
async function generateClientsForService(serviceDir = process.cwd()) {
|
|
47
74
|
const ctx = (0, service_config_1.resolveServiceContext)(serviceDir);
|
|
48
75
|
const generate = await resolveOrvalGenerate(ctx.serviceDir);
|
|
76
|
+
const surfacesWithSpec = xema_decorators_1.ALL_SURFACES.filter((s) => (0, node_fs_1.existsSync)((0, service_config_1.surfaceSpecPath)(ctx, s)));
|
|
77
|
+
assertNoOrphanedSurfaceClients(ctx, surfacesWithSpec);
|
|
49
78
|
const generated = [];
|
|
50
|
-
for (const surface of
|
|
79
|
+
for (const surface of surfacesWithSpec) {
|
|
51
80
|
const specPath = (0, service_config_1.surfaceSpecPath)(ctx, surface);
|
|
52
|
-
if (!(0, node_fs_1.existsSync)(specPath)) {
|
|
53
|
-
continue;
|
|
54
|
-
}
|
|
55
81
|
const { clientDir, clientSrc } = (0, client_package_1.ensureClientPackage)(ctx, surface);
|
|
56
82
|
(0, client_readme_1.ensureClientReadme)({
|
|
57
83
|
clientDir,
|
|
@@ -64,6 +90,7 @@ async function generateClientsForService(serviceDir = process.cwd()) {
|
|
|
64
90
|
(0, node_fs_1.rmSync)((0, node_path_1.join)(clientSrc, 'models'), { recursive: true, force: true });
|
|
65
91
|
await generate(orvalConfigFor(specPath, clientSrc));
|
|
66
92
|
(0, repo_post_process_1.postProcessClient)(ctx.repoRoot, ctx.serviceDir, clientSrc);
|
|
93
|
+
(0, node_fs_1.rmSync)((0, node_path_1.join)(clientDir, 'dist'), { recursive: true, force: true });
|
|
67
94
|
(0, node_child_process_1.execFileSync)('pnpm', ['exec', 'tsc', '-p', 'tsconfig.json'], {
|
|
68
95
|
cwd: clientDir,
|
|
69
96
|
stdio: 'inherit',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generate-clients.js","sourceRoot":"","sources":["../../src/lib/generate-clients.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"generate-clients.js","sourceRoot":"","sources":["../../src/lib/generate-clients.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"seed-openapi-env.d.ts","sourceRoot":"","sources":["../../src/lib/seed-openapi-env.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"seed-openapi-env.d.ts","sourceRoot":"","sources":["../../src/lib/seed-openapi-env.ts"],"names":[],"mappings":"AA0CA,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI9D;AAMD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CA0GtD"}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.openApiScratchSchema = openApiScratchSchema;
|
|
3
4
|
exports.seedOpenApiEnv = seedOpenApiEnv;
|
|
4
5
|
const DUMMY_ENCRYPTION_KEY_HEX = '0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef';
|
|
5
6
|
const DUMMY_BASE64_KEY = 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=';
|
|
@@ -10,14 +11,22 @@ function seed(vars) {
|
|
|
10
11
|
}
|
|
11
12
|
}
|
|
12
13
|
}
|
|
13
|
-
|
|
14
|
+
const SCRATCH_DB_NAME = 'dummy_openapi';
|
|
15
|
+
function openApiScratchSchema(serviceId) {
|
|
16
|
+
return `extract_${serviceId.replace(/[^a-zA-Z0-9]+/g, '_')}`
|
|
17
|
+
.toLowerCase()
|
|
18
|
+
.slice(0, 63);
|
|
19
|
+
}
|
|
20
|
+
function seedOpenApiEnv(serviceId) {
|
|
21
|
+
const schema = openApiScratchSchema(serviceId);
|
|
14
22
|
seed({
|
|
15
23
|
NODE_ENV: 'development',
|
|
16
24
|
XEMA_OPENAPI_EXTRACTION: '1',
|
|
17
|
-
DATABASE_URL:
|
|
25
|
+
DATABASE_URL: `postgresql://dummy:dummy@localhost:5432/${SCRATCH_DB_NAME}?schema=${schema}`,
|
|
18
26
|
DB_HOST: 'localhost',
|
|
19
27
|
DB_PORT: '5432',
|
|
20
|
-
DB_NAME:
|
|
28
|
+
DB_NAME: SCRATCH_DB_NAME,
|
|
29
|
+
DB_SCHEMA: schema,
|
|
21
30
|
DB_USER: 'dummy',
|
|
22
31
|
DB_PASSWORD: 'dummy',
|
|
23
32
|
REDIS_URL: 'redis://localhost:6379',
|
|
@@ -31,6 +40,7 @@ function seedOpenApiEnv() {
|
|
|
31
40
|
OPENCODE_WORKER_PASSWORD: 'dummy-worker-password',
|
|
32
41
|
XEMA_ETCD_ENDPOINTS: 'localhost:2379',
|
|
33
42
|
EVENT_HUB_URL: 'http://localhost:3128',
|
|
43
|
+
WEBHOOK_URL: 'http://localhost:3000/webhooks/events',
|
|
34
44
|
USER_API_URL: 'http://localhost:3050',
|
|
35
45
|
BACKLOG_API_URL: 'http://localhost:3100',
|
|
36
46
|
MEMORY_API_URL: 'http://localhost:3060',
|
|
@@ -40,7 +50,7 @@ function seedOpenApiEnv() {
|
|
|
40
50
|
ARTIFACT_STORE_API_URL: 'http://localhost:3130',
|
|
41
51
|
KNOWLEDGE_BASE_API_URL: 'http://localhost:3200',
|
|
42
52
|
PROJECT_REGISTRY_API_URL: 'http://localhost:3300',
|
|
43
|
-
|
|
53
|
+
CONNECTOR_GATEWAY_API_URL: 'http://localhost:3900',
|
|
44
54
|
DESIGN_SYSTEM_BUILDER_API_URL: 'http://localhost:3210',
|
|
45
55
|
SEARCH_API_URL: 'http://localhost:3220',
|
|
46
56
|
BILLING_API_URL: 'http://localhost:3140',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"seed-openapi-env.js","sourceRoot":"","sources":["../../src/lib/seed-openapi-env.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"seed-openapi-env.js","sourceRoot":"","sources":["../../src/lib/seed-openapi-env.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xemahq/api-client-generator",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Layer 1 — the single, central OpenAPI + ORVAL client generator for every Xema NestJS service. Replaces the per-service orval.config.ts / scripts/extract-openapi.ts / scripts/build-client-index.js trio with two bins (xema-openapi, xema-client-generate). Extracts one OpenAPI document per ApiSurface (public/internal/operator) using the @XemaApiSurface decorator metadata, generates one ORVAL client package per non-empty surface (all sharing the owning service's version), and stamps deterministic `xema` provenance metadata into each generated client package.json. No heuristics: a route ships in a surface only if it (or its controller) is explicitly classified.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"xema",
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
"@nestjs/core": "^10 || ^11",
|
|
38
38
|
"@nestjs/swagger": "^7 || ^8 || ^11",
|
|
39
39
|
"@nestjs/testing": "^10 || ^11",
|
|
40
|
-
"@xemahq/xema-decorators": "
|
|
40
|
+
"@xemahq/xema-decorators": ">=0.4.0",
|
|
41
41
|
"orval": "^8",
|
|
42
42
|
"reflect-metadata": "^0.2",
|
|
43
43
|
"ts-node": ">=10",
|
|
@@ -62,7 +62,7 @@
|
|
|
62
62
|
"prettier": "3.6.2",
|
|
63
63
|
"reflect-metadata": "0.2.2",
|
|
64
64
|
"typescript": "5.9.3",
|
|
65
|
-
"@xemahq/xema-decorators": "0.
|
|
65
|
+
"@xemahq/xema-decorators": "0.4.1"
|
|
66
66
|
},
|
|
67
67
|
"exports": {
|
|
68
68
|
".": {
|
package/dist/lib/prune-spec.d.ts
DELETED
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
import { ApiSurface } from '@xemahq/xema-decorators';
|
|
2
|
-
interface OpenApiDoc {
|
|
3
|
-
paths?: Record<string, Record<string, unknown> | undefined>;
|
|
4
|
-
components?: {
|
|
5
|
-
schemas?: Record<string, unknown>;
|
|
6
|
-
[k: string]: unknown;
|
|
7
|
-
};
|
|
8
|
-
[k: string]: unknown;
|
|
9
|
-
}
|
|
10
|
-
export declare function pruneSpecForSurface(fullDoc: OpenApiDoc, keepOperationIds: ReadonlySet<string>): {
|
|
11
|
-
doc: OpenApiDoc;
|
|
12
|
-
pathCount: number;
|
|
13
|
-
};
|
|
14
|
-
export declare const ALL_SURFACES: readonly ApiSurface[];
|
|
15
|
-
export {};
|
|
16
|
-
//# sourceMappingURL=prune-spec.d.ts.map
|
|
@@ -1 +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
DELETED
|
@@ -1,100 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.ALL_SURFACES = void 0;
|
|
4
|
-
exports.pruneSpecForSurface = pruneSpecForSurface;
|
|
5
|
-
const xema_decorators_1 = require("@xemahq/xema-decorators");
|
|
6
|
-
const HTTP_METHODS = new Set([
|
|
7
|
-
'get',
|
|
8
|
-
'post',
|
|
9
|
-
'put',
|
|
10
|
-
'patch',
|
|
11
|
-
'delete',
|
|
12
|
-
'options',
|
|
13
|
-
'head',
|
|
14
|
-
'trace',
|
|
15
|
-
]);
|
|
16
|
-
const SCHEMA_REF_PREFIX = '#/components/schemas/';
|
|
17
|
-
function collectSchemaRefs(node, out) {
|
|
18
|
-
if (Array.isArray(node)) {
|
|
19
|
-
for (const item of node) {
|
|
20
|
-
collectSchemaRefs(item, out);
|
|
21
|
-
}
|
|
22
|
-
return;
|
|
23
|
-
}
|
|
24
|
-
if (node && typeof node === 'object') {
|
|
25
|
-
for (const [key, value] of Object.entries(node)) {
|
|
26
|
-
if (key === '$ref' && typeof value === 'string') {
|
|
27
|
-
if (value.startsWith(SCHEMA_REF_PREFIX)) {
|
|
28
|
-
out.add(value.slice(SCHEMA_REF_PREFIX.length));
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
else {
|
|
32
|
-
collectSchemaRefs(value, out);
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
function pruneSpecForSurface(fullDoc, keepOperationIds) {
|
|
38
|
-
const clone = JSON.parse(JSON.stringify(fullDoc));
|
|
39
|
-
const paths = clone.paths ?? {};
|
|
40
|
-
let pathCount = 0;
|
|
41
|
-
for (const [pathKey, pathItem] of Object.entries(paths)) {
|
|
42
|
-
if (!pathItem || typeof pathItem !== 'object') {
|
|
43
|
-
delete paths[pathKey];
|
|
44
|
-
continue;
|
|
45
|
-
}
|
|
46
|
-
for (const [method, operation] of Object.entries(pathItem)) {
|
|
47
|
-
if (!HTTP_METHODS.has(method.toLowerCase())) {
|
|
48
|
-
continue;
|
|
49
|
-
}
|
|
50
|
-
const operationId = operation?.operationId;
|
|
51
|
-
if (typeof operationId !== 'string' ||
|
|
52
|
-
!keepOperationIds.has(operationId)) {
|
|
53
|
-
delete pathItem[method];
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
const remainingMethods = Object.keys(pathItem).filter((k) => HTTP_METHODS.has(k.toLowerCase()));
|
|
57
|
-
if (remainingMethods.length === 0) {
|
|
58
|
-
delete paths[pathKey];
|
|
59
|
-
}
|
|
60
|
-
else {
|
|
61
|
-
pathCount += remainingMethods.length;
|
|
62
|
-
}
|
|
63
|
-
}
|
|
64
|
-
clone.paths = paths;
|
|
65
|
-
const allSchemas = clone.components?.schemas;
|
|
66
|
-
if (allSchemas && typeof allSchemas === 'object') {
|
|
67
|
-
const reachable = new Set();
|
|
68
|
-
collectSchemaRefs(clone.paths, reachable);
|
|
69
|
-
const queue = [...reachable];
|
|
70
|
-
while (queue.length > 0) {
|
|
71
|
-
const name = queue.pop();
|
|
72
|
-
const schema = allSchemas[name];
|
|
73
|
-
if (schema === undefined) {
|
|
74
|
-
continue;
|
|
75
|
-
}
|
|
76
|
-
const nested = new Set();
|
|
77
|
-
collectSchemaRefs(schema, nested);
|
|
78
|
-
for (const ref of nested) {
|
|
79
|
-
if (!reachable.has(ref)) {
|
|
80
|
-
reachable.add(ref);
|
|
81
|
-
queue.push(ref);
|
|
82
|
-
}
|
|
83
|
-
}
|
|
84
|
-
}
|
|
85
|
-
const pruned = {};
|
|
86
|
-
for (const [name, schema] of Object.entries(allSchemas)) {
|
|
87
|
-
if (reachable.has(name)) {
|
|
88
|
-
pruned[name] = schema;
|
|
89
|
-
}
|
|
90
|
-
}
|
|
91
|
-
clone.components = { ...clone.components, schemas: pruned };
|
|
92
|
-
}
|
|
93
|
-
return { doc: clone, pathCount };
|
|
94
|
-
}
|
|
95
|
-
exports.ALL_SURFACES = [
|
|
96
|
-
xema_decorators_1.ApiSurface.Public,
|
|
97
|
-
xema_decorators_1.ApiSurface.Internal,
|
|
98
|
-
xema_decorators_1.ApiSurface.Operator,
|
|
99
|
-
];
|
|
100
|
-
//# sourceMappingURL=prune-spec.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"prune-spec.js","sourceRoot":"","sources":["../../src/lib/prune-spec.ts"],"names":[],"mappings":"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"}
|