micro-contracts 0.18.10 → 0.18.12

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.
Files changed (202) hide show
  1. package/README.md +7 -14
  2. package/cli-contract.yaml +15 -27
  3. package/dist/agents/context-builder.d.ts +5 -0
  4. package/dist/agents/context-builder.d.ts.map +1 -0
  5. package/dist/agents/context-builder.js +239 -0
  6. package/dist/agents/context-builder.js.map +1 -0
  7. package/dist/agents/formatter.d.ts +9 -0
  8. package/dist/agents/formatter.d.ts.map +1 -0
  9. package/dist/agents/formatter.js +124 -0
  10. package/dist/agents/formatter.js.map +1 -0
  11. package/dist/agents/index.d.ts +6 -0
  12. package/dist/agents/index.d.ts.map +1 -0
  13. package/dist/agents/index.js +4 -0
  14. package/dist/agents/index.js.map +1 -0
  15. package/dist/agents/orchestrator.d.ts +5 -0
  16. package/dist/agents/orchestrator.d.ts.map +1 -0
  17. package/dist/agents/orchestrator.js +46 -0
  18. package/dist/agents/orchestrator.js.map +1 -0
  19. package/dist/agents/types.d.ts +29 -0
  20. package/dist/agents/types.d.ts.map +1 -0
  21. package/dist/agents/types.js +7 -0
  22. package/dist/agents/types.js.map +1 -0
  23. package/dist/cli/templates.d.ts +15 -0
  24. package/dist/cli/templates.d.ts.map +1 -0
  25. package/dist/cli/templates.js +445 -0
  26. package/dist/cli/templates.js.map +1 -0
  27. package/dist/cli.d.ts +3 -0
  28. package/dist/cli.d.ts.map +1 -0
  29. package/dist/cli.js +1201 -0
  30. package/dist/cli.js.map +1 -0
  31. package/dist/commands/audit-guardrails.d.ts +15 -0
  32. package/dist/commands/audit-guardrails.d.ts.map +1 -0
  33. package/dist/commands/audit-guardrails.js +33 -0
  34. package/dist/commands/audit-guardrails.js.map +1 -0
  35. package/dist/commands/audit-openapi.d.ts +15 -0
  36. package/dist/commands/audit-openapi.d.ts.map +1 -0
  37. package/dist/commands/audit-openapi.js +33 -0
  38. package/dist/commands/audit-openapi.js.map +1 -0
  39. package/dist/commands/insights.d.ts +8 -0
  40. package/dist/commands/insights.d.ts.map +1 -0
  41. package/dist/commands/insights.js +13 -0
  42. package/dist/commands/insights.js.map +1 -0
  43. package/dist/commands/propose-overlays.d.ts +15 -0
  44. package/dist/commands/propose-overlays.d.ts.map +1 -0
  45. package/dist/commands/propose-overlays.js +33 -0
  46. package/dist/commands/propose-overlays.js.map +1 -0
  47. package/dist/commands/review-published.d.ts +15 -0
  48. package/dist/commands/review-published.d.ts.map +1 -0
  49. package/dist/commands/review-published.js +33 -0
  50. package/dist/commands/review-published.js.map +1 -0
  51. package/dist/external/insight-provider.d.ts.map +1 -0
  52. package/dist/external/insight-provider.js.map +1 -0
  53. package/dist/generated/commands.d.ts +2 -0
  54. package/dist/generated/commands.d.ts.map +1 -0
  55. package/dist/generated/commands.js +2 -0
  56. package/dist/generated/commands.js.map +1 -0
  57. package/dist/generated/contract.d.ts +3 -0
  58. package/dist/generated/contract.d.ts.map +1 -0
  59. package/dist/generated/contract.js +5 -0
  60. package/dist/generated/contract.js.map +1 -0
  61. package/dist/generated/dsl/agents.d.ts +34 -0
  62. package/dist/generated/dsl/agents.d.ts.map +1 -0
  63. package/dist/generated/dsl/agents.js +98 -0
  64. package/dist/generated/dsl/agents.js.map +1 -0
  65. package/dist/generated/dsl/dsl-data.d.ts +7 -0
  66. package/dist/generated/dsl/dsl-data.d.ts.map +1 -0
  67. package/dist/generated/dsl/dsl-data.js +1041 -0
  68. package/dist/generated/dsl/dsl-data.js.map +1 -0
  69. package/dist/generated/dsl/handoffs.d.ts +457 -0
  70. package/dist/generated/dsl/handoffs.d.ts.map +1 -0
  71. package/dist/generated/dsl/handoffs.js +205 -0
  72. package/dist/generated/dsl/handoffs.js.map +1 -0
  73. package/dist/generated/dsl/index.d.ts +14 -0
  74. package/dist/generated/dsl/index.d.ts.map +1 -0
  75. package/dist/generated/dsl/index.js +11 -0
  76. package/dist/generated/dsl/index.js.map +1 -0
  77. package/dist/generated/dsl/tasks.d.ts +28 -0
  78. package/dist/generated/dsl/tasks.d.ts.map +1 -0
  79. package/dist/generated/dsl/tasks.js +137 -0
  80. package/dist/generated/dsl/tasks.js.map +1 -0
  81. package/dist/generated/dsl/workflows.d.ts +34 -0
  82. package/dist/generated/dsl/workflows.d.ts.map +1 -0
  83. package/dist/generated/dsl/workflows.js +84 -0
  84. package/dist/generated/dsl/workflows.js.map +1 -0
  85. package/dist/generated/index.d.ts +8 -0
  86. package/dist/generated/index.d.ts.map +1 -0
  87. package/dist/generated/index.js +8 -0
  88. package/dist/generated/index.js.map +1 -0
  89. package/dist/generated/policy-runtime.d.ts +114 -0
  90. package/dist/generated/policy-runtime.d.ts.map +1 -0
  91. package/dist/generated/policy-runtime.js +195 -0
  92. package/dist/generated/policy-runtime.js.map +1 -0
  93. package/dist/generated/policy.d.ts +658 -0
  94. package/dist/generated/policy.d.ts.map +1 -0
  95. package/dist/generated/policy.js +844 -0
  96. package/dist/generated/policy.js.map +1 -0
  97. package/dist/generated/program.d.ts +120 -0
  98. package/dist/generated/program.d.ts.map +1 -0
  99. package/dist/generated/program.js +370 -0
  100. package/dist/generated/program.js.map +1 -0
  101. package/dist/generated/schemas.d.ts +779 -0
  102. package/dist/generated/schemas.d.ts.map +1 -0
  103. package/dist/generated/schemas.js +1006 -0
  104. package/dist/generated/schemas.js.map +1 -0
  105. package/dist/generated/types.d.ts +786 -0
  106. package/dist/generated/types.d.ts.map +1 -0
  107. package/dist/generated/types.js +3 -0
  108. package/dist/generated/types.js.map +1 -0
  109. package/dist/generator/dependencyGenerator.d.ts +16 -0
  110. package/dist/generator/dependencyGenerator.d.ts.map +1 -0
  111. package/dist/generator/dependencyGenerator.js +25 -0
  112. package/dist/generator/dependencyGenerator.js.map +1 -0
  113. package/dist/generator/index.d.ts +47 -0
  114. package/dist/generator/index.d.ts.map +1 -0
  115. package/dist/generator/index.js +707 -0
  116. package/dist/generator/index.js.map +1 -0
  117. package/dist/generator/inputHash.d.ts +23 -0
  118. package/dist/generator/inputHash.d.ts.map +1 -0
  119. package/dist/generator/inputHash.js +138 -0
  120. package/dist/generator/inputHash.js.map +1 -0
  121. package/dist/generator/linter.d.ts +26 -0
  122. package/dist/generator/linter.d.ts.map +1 -0
  123. package/dist/generator/linter.js +441 -0
  124. package/dist/generator/linter.js.map +1 -0
  125. package/dist/generator/overlayProcessor.d.ts +71 -0
  126. package/dist/generator/overlayProcessor.d.ts.map +1 -0
  127. package/dist/generator/overlayProcessor.js +500 -0
  128. package/dist/generator/overlayProcessor.js.map +1 -0
  129. package/dist/generator/schemaGenerator.d.ts +10 -0
  130. package/dist/generator/schemaGenerator.d.ts.map +1 -0
  131. package/dist/generator/schemaGenerator.js +296 -0
  132. package/dist/generator/schemaGenerator.js.map +1 -0
  133. package/dist/generator/serviceGenerator.d.ts +20 -0
  134. package/dist/generator/serviceGenerator.d.ts.map +1 -0
  135. package/dist/generator/serviceGenerator.js +293 -0
  136. package/dist/generator/serviceGenerator.js.map +1 -0
  137. package/dist/generator/templateProcessor.d.ts +208 -0
  138. package/dist/generator/templateProcessor.d.ts.map +1 -0
  139. package/dist/generator/templateProcessor.js +604 -0
  140. package/dist/generator/templateProcessor.js.map +1 -0
  141. package/dist/generator/typeGenerator.d.ts +22 -0
  142. package/dist/generator/typeGenerator.d.ts.map +1 -0
  143. package/dist/generator/typeGenerator.js +439 -0
  144. package/dist/generator/typeGenerator.js.map +1 -0
  145. package/dist/generator/typeGenerator.test.d.ts +2 -0
  146. package/dist/generator/typeGenerator.test.d.ts.map +1 -0
  147. package/dist/generator/typeGenerator.test.js +155 -0
  148. package/dist/generator/typeGenerator.test.js.map +1 -0
  149. package/dist/glob.d.ts +22 -0
  150. package/dist/glob.d.ts.map +1 -0
  151. package/dist/glob.js +103 -0
  152. package/dist/glob.js.map +1 -0
  153. package/dist/guardrails/allowlist.d.ts +30 -0
  154. package/dist/guardrails/allowlist.d.ts.map +1 -0
  155. package/dist/guardrails/allowlist.js +174 -0
  156. package/dist/guardrails/allowlist.js.map +1 -0
  157. package/dist/guardrails/config.d.ts +40 -0
  158. package/dist/guardrails/config.d.ts.map +1 -0
  159. package/dist/guardrails/config.js +177 -0
  160. package/dist/guardrails/config.js.map +1 -0
  161. package/dist/guardrails/drift.d.ts +19 -0
  162. package/dist/guardrails/drift.d.ts.map +1 -0
  163. package/dist/guardrails/drift.js +115 -0
  164. package/dist/guardrails/drift.js.map +1 -0
  165. package/dist/guardrails/index.d.ts +18 -0
  166. package/dist/guardrails/index.d.ts.map +1 -0
  167. package/dist/guardrails/index.js +21 -0
  168. package/dist/guardrails/index.js.map +1 -0
  169. package/dist/guardrails/lint.d.ts +16 -0
  170. package/dist/guardrails/lint.d.ts.map +1 -0
  171. package/dist/guardrails/lint.js +172 -0
  172. package/dist/guardrails/lint.js.map +1 -0
  173. package/dist/guardrails/manifest.d.ts +63 -0
  174. package/dist/guardrails/manifest.d.ts.map +1 -0
  175. package/dist/guardrails/manifest.js +310 -0
  176. package/dist/guardrails/manifest.js.map +1 -0
  177. package/dist/guardrails/runner.d.ts +53 -0
  178. package/dist/guardrails/runner.d.ts.map +1 -0
  179. package/dist/guardrails/runner.js +387 -0
  180. package/dist/guardrails/runner.js.map +1 -0
  181. package/dist/guardrails/types.d.ts +196 -0
  182. package/dist/guardrails/types.d.ts.map +1 -0
  183. package/dist/guardrails/types.js +8 -0
  184. package/dist/guardrails/types.js.map +1 -0
  185. package/dist/index.d.ts +21 -4
  186. package/dist/index.d.ts.map +1 -0
  187. package/dist/index.js +21 -4
  188. package/dist/index.js.map +1 -0
  189. package/dist/micro-contracts.bundle.mjs +349 -374
  190. package/dist/micro-contracts.bundle.mjs.map +3 -3
  191. package/dist/types.d.ts +502 -0
  192. package/dist/types.d.ts.map +1 -0
  193. package/dist/types.js +409 -0
  194. package/dist/types.js.map +1 -0
  195. package/dist/version.d.ts +10 -0
  196. package/dist/version.d.ts.map +1 -0
  197. package/dist/version.js +31 -0
  198. package/dist/version.js.map +1 -0
  199. package/docs/cli-reference.md +13 -15
  200. package/docs/development-guardrails.md +3 -3
  201. package/docs/screen-spec.md +3 -3
  202. package/package.json +13 -12
@@ -0,0 +1,500 @@
1
+ /**
2
+ * OpenAPI Overlay Processor
3
+ *
4
+ * Implements OpenAPI Overlay Specification for cross-cutting concerns.
5
+ * Parses overlays and applies transformations to OpenAPI specs.
6
+ */
7
+ import fs from 'fs';
8
+ import path from 'path';
9
+ import yaml from 'js-yaml';
10
+ // =============================================================================
11
+ // Overlay Processor
12
+ // =============================================================================
13
+ /**
14
+ * Process overlays and apply to OpenAPI spec
15
+ *
16
+ * @param spec - Source OpenAPI spec
17
+ * @param overlayConfig - Overlay configuration
18
+ * @param basePath - Base path for resolving overlay file paths
19
+ * @param specPath - Path to the source spec file (for $ref rebasing)
20
+ */
21
+ export function processOverlays(spec, overlayConfig, basePath = process.cwd(), specPath) {
22
+ const result = {
23
+ spec: JSON.parse(JSON.stringify(spec)), // Deep clone
24
+ extensionInfo: new Map(),
25
+ appliedOverlays: [],
26
+ log: [],
27
+ };
28
+ const collision = overlayConfig.collision || 'error';
29
+ const injectedKeys = new Map();
30
+ // Target directory for $ref rebasing (where transformed spec will be written)
31
+ const targetDir = specPath ? path.dirname(path.resolve(basePath, specPath)) : undefined;
32
+ for (const overlayFile of overlayConfig.files) {
33
+ const overlayPath = path.resolve(basePath, overlayFile);
34
+ if (!fs.existsSync(overlayPath)) {
35
+ // Skipping would generate artifacts without the overlay's injections
36
+ // (middleware, auth, headers) and still report success.
37
+ throw new Error(`Overlay file not found: ${overlayFile} (resolved to ${overlayPath})`);
38
+ }
39
+ const overlayContent = fs.readFileSync(overlayPath, 'utf-8');
40
+ const overlay = yaml.load(overlayContent);
41
+ const overlayDir = path.dirname(overlayPath);
42
+ result.appliedOverlays.push(overlayFile);
43
+ for (const action of overlay.actions) {
44
+ applyAction(result, overlay, action, overlayFile, collision, injectedKeys, overlayDir, targetDir);
45
+ }
46
+ }
47
+ return result;
48
+ }
49
+ /**
50
+ * Apply a single overlay action
51
+ */
52
+ function applyAction(result, _overlay, action, overlayFile, collision, injectedKeys, overlayDir, targetDir) {
53
+ const { target, update, remove } = action;
54
+ // Parse the target JSONPath pattern
55
+ const parsed = parseTarget(target);
56
+ if (!parsed) {
57
+ // Returning here would apply nothing for this action and still succeed.
58
+ throw new Error(`Overlay '${overlayFile}' has an unsupported target: ${target}. ` +
59
+ `Supported form: $.paths[*][*][?(@.x-<marker> contains '<value>')]`);
60
+ }
61
+ // Find matching operations
62
+ const matches = findMatchingOperations(result.spec, parsed);
63
+ for (const match of matches) {
64
+ const { path: apiPath, method, operation } = match;
65
+ const changes = [];
66
+ if (update) {
67
+ // Apply updates (parameters, responses)
68
+ if (update.parameters) {
69
+ const params = update.parameters;
70
+ for (const param of params) {
71
+ // Rebase $ref paths in parameter
72
+ const rebasedParam = rebaseRefs(param, overlayDir, targetDir);
73
+ const key = `${apiPath}:${method}:param:${rebasedParam.name}`;
74
+ checkCollision(key, rebasedParam, overlayFile, collision, injectedKeys);
75
+ if (!operation.parameters) {
76
+ operation.parameters = [];
77
+ }
78
+ // Avoid duplicates
79
+ const existing = operation.parameters.findIndex(p => !('$ref' in p) && p.name === rebasedParam.name && p.in === rebasedParam.in);
80
+ if (existing >= 0) {
81
+ operation.parameters[existing] = rebasedParam;
82
+ }
83
+ else {
84
+ operation.parameters.push(rebasedParam);
85
+ }
86
+ changes.push(`+${rebasedParam.name} (${rebasedParam.in})`);
87
+ }
88
+ }
89
+ if (update.responses) {
90
+ const responses = update.responses;
91
+ for (const [statusCode, response] of Object.entries(responses)) {
92
+ // Rebase $ref paths in response
93
+ const rebasedResponse = rebaseRefs(response, overlayDir, targetDir);
94
+ const key = `${apiPath}:${method}:response:${statusCode}`;
95
+ checkCollision(key, rebasedResponse, overlayFile, collision, injectedKeys);
96
+ operation.responses[statusCode] = rebasedResponse;
97
+ changes.push(`+${statusCode}`);
98
+ }
99
+ }
100
+ for (const [key, value] of Object.entries(update)) {
101
+ if (key === 'parameters' || key === 'responses')
102
+ continue;
103
+ const rebasedValue = rebaseRefs(value, overlayDir, targetDir);
104
+ const collisionKey = `${apiPath}:${method}:${key}`;
105
+ checkCollision(collisionKey, rebasedValue, overlayFile, collision, injectedKeys);
106
+ operation[key] = rebasedValue;
107
+ changes.push(`+${key}`);
108
+ }
109
+ }
110
+ if (remove) {
111
+ // Remove the operation (not commonly used, but supported)
112
+ changes.push('REMOVED');
113
+ }
114
+ // Log the application
115
+ result.log.push({
116
+ overlay: overlayFile,
117
+ target,
118
+ path: apiPath,
119
+ method,
120
+ changes,
121
+ });
122
+ // Extract extension info
123
+ extractExtensionInfo(result.extensionInfo, parsed, action);
124
+ }
125
+ }
126
+ function parseTarget(target) {
127
+ // Pattern: $.paths[*][*][?(@.x-ext contains 'value')]
128
+ const containsMatch = target.match(/\$\.paths\[\*\]\[\*\]\[\?\(@\.(x-[a-z-]+)\s+contains\s+'([^']+)'\)\]/);
129
+ if (containsMatch) {
130
+ return {
131
+ extensionMarker: containsMatch[1],
132
+ extensionValue: containsMatch[2],
133
+ };
134
+ }
135
+ // Pattern: $.paths[*][*][?(@.x-ext)]
136
+ const existsMatch = target.match(/\$\.paths\[\*\]\[\*\]\[\?\(@\.(x-[a-z-]+)\)\]/);
137
+ if (existsMatch) {
138
+ return {
139
+ extensionMarker: existsMatch[1],
140
+ };
141
+ }
142
+ // Simple pattern: $.paths[*][*]
143
+ if (target === '$.paths[*][*]') {
144
+ return {};
145
+ }
146
+ return null;
147
+ }
148
+ function findMatchingOperations(spec, parsed) {
149
+ const matches = [];
150
+ const methods = ['get', 'post', 'put', 'patch', 'delete'];
151
+ for (const [apiPath, pathItem] of Object.entries(spec.paths)) {
152
+ for (const method of methods) {
153
+ const operation = pathItem[method];
154
+ if (!operation)
155
+ continue;
156
+ // Check if operation matches the target
157
+ if (parsed.extensionMarker) {
158
+ const extValue = operation[parsed.extensionMarker];
159
+ if (!extValue)
160
+ continue;
161
+ if (parsed.extensionValue) {
162
+ // Check if array contains the value
163
+ if (Array.isArray(extValue)) {
164
+ if (!extValue.includes(parsed.extensionValue))
165
+ continue;
166
+ }
167
+ else if (extValue !== parsed.extensionValue) {
168
+ continue;
169
+ }
170
+ }
171
+ }
172
+ matches.push({ path: apiPath, method, operation });
173
+ }
174
+ }
175
+ return matches;
176
+ }
177
+ /**
178
+ * Rebase $ref paths in an object from source directory to target directory
179
+ *
180
+ * @param obj - Object that may contain $ref properties
181
+ * @param sourceDir - Directory where the source file is located (e.g., overlay or OpenAPI source)
182
+ * @param targetDir - Directory where the output file will be written
183
+ * @returns Object with rebased $ref paths
184
+ */
185
+ export function rebaseRefs(obj, sourceDir, targetDir) {
186
+ if (!sourceDir || !targetDir) {
187
+ return obj;
188
+ }
189
+ // Deep clone and rebase
190
+ return rebaseRefsRecursive(JSON.parse(JSON.stringify(obj)), sourceDir, targetDir);
191
+ }
192
+ function rebaseRefsRecursive(obj, overlayDir, targetDir) {
193
+ if (obj === null || obj === undefined) {
194
+ return obj;
195
+ }
196
+ if (Array.isArray(obj)) {
197
+ return obj.map(item => rebaseRefsRecursive(item, overlayDir, targetDir));
198
+ }
199
+ if (typeof obj === 'object') {
200
+ const result = {};
201
+ for (const [key, value] of Object.entries(obj)) {
202
+ if (key === '$ref' && typeof value === 'string') {
203
+ // Rebase the $ref path
204
+ result[key] = rebaseRefPath(value, overlayDir, targetDir);
205
+ }
206
+ else {
207
+ result[key] = rebaseRefsRecursive(value, overlayDir, targetDir);
208
+ }
209
+ }
210
+ return result;
211
+ }
212
+ return obj;
213
+ }
214
+ /**
215
+ * Rebase a single $ref path from overlay directory to target directory
216
+ *
217
+ * @param refPath - The $ref value (e.g., '../openapi/problem-details.yaml#/components/schemas/X')
218
+ * @param overlayDir - Directory where the overlay file is located
219
+ * @param targetDir - Directory where the transformed spec will be written
220
+ * @returns Rebased $ref path
221
+ */
222
+ function rebaseRefPath(refPath, overlayDir, targetDir) {
223
+ // Handle internal references (start with #)
224
+ if (refPath.startsWith('#')) {
225
+ return refPath;
226
+ }
227
+ // Split $ref into file path and JSON pointer
228
+ const [filePath, jsonPointer] = refPath.split('#');
229
+ // If no file path, it's a pure JSON pointer
230
+ if (!filePath) {
231
+ return refPath;
232
+ }
233
+ // Resolve the absolute path of the referenced file
234
+ const absoluteRefPath = path.resolve(overlayDir, filePath);
235
+ // Calculate the relative path from target directory
236
+ const relativePath = path.relative(targetDir, absoluteRefPath);
237
+ // Normalize to forward slashes (for cross-platform compatibility)
238
+ const normalizedPath = relativePath.split(path.sep).join('/');
239
+ // Reconstruct the $ref
240
+ return jsonPointer ? `${normalizedPath}#${jsonPointer}` : normalizedPath;
241
+ }
242
+ /**
243
+ * Check for collision and handle according to policy
244
+ */
245
+ function checkCollision(key, content, overlayFile, collision, injectedKeys) {
246
+ const existing = injectedKeys.get(key);
247
+ if (existing) {
248
+ const contentStr = JSON.stringify(content);
249
+ const existingStr = JSON.stringify(existing.content);
250
+ if (contentStr === existingStr) {
251
+ // Identical content - idempotent, allow
252
+ return;
253
+ }
254
+ const message = `Overlay collision at ${key}: ${existing.overlay} vs ${overlayFile}`;
255
+ switch (collision) {
256
+ case 'error':
257
+ throw new Error(message);
258
+ case 'warn':
259
+ console.warn(`Warning: ${message}`);
260
+ break;
261
+ case 'last-wins':
262
+ // Just overwrite
263
+ break;
264
+ }
265
+ }
266
+ injectedKeys.set(key, { overlay: overlayFile, content });
267
+ }
268
+ /**
269
+ * Extract extension information from overlay action
270
+ */
271
+ function extractExtensionInfo(extensionInfo, parsed, action) {
272
+ const { update } = action;
273
+ if (!parsed.extensionMarker || !update)
274
+ return;
275
+ // Use explicit x-micro-contracts-overlay-name if provided, otherwise fall back to parsed value
276
+ const overlayName = action['x-micro-contracts-overlay-name'] || parsed.extensionValue;
277
+ if (!overlayName)
278
+ return;
279
+ const key = `${parsed.extensionMarker}:${overlayName}`;
280
+ if (!extensionInfo.has(key)) {
281
+ extensionInfo.set(key, {
282
+ name: overlayName,
283
+ marker: parsed.extensionMarker,
284
+ injectedParameters: [],
285
+ injectedResponses: {},
286
+ });
287
+ }
288
+ const info = extensionInfo.get(key);
289
+ if (update.parameters) {
290
+ const params = update.parameters;
291
+ for (const param of params) {
292
+ // Avoid duplicates
293
+ if (!info.injectedParameters.find(p => p.name === param.name)) {
294
+ info.injectedParameters.push(param);
295
+ }
296
+ }
297
+ }
298
+ if (update.responses) {
299
+ const responses = update.responses;
300
+ Object.assign(info.injectedResponses, responses);
301
+ }
302
+ }
303
+ // =============================================================================
304
+ // Overlay Interface Generation
305
+ // =============================================================================
306
+ /**
307
+ * Generate TypeScript interfaces for overlays
308
+ *
309
+ * These interfaces are HTTP-agnostic. The HTTP layer (routes template)
310
+ * extracts parameters from the request and passes them to overlay handlers.
311
+ */
312
+ export function generateExtensionInterfaces(extensionInfo) {
313
+ const lines = [];
314
+ lines.push('/**');
315
+ lines.push(' * Overlay Interfaces');
316
+ lines.push(' * Auto-generated from overlay specifications');
317
+ lines.push(' * DO NOT EDIT MANUALLY');
318
+ lines.push(' * ');
319
+ lines.push(' * These interfaces are HTTP-agnostic. Overlay handlers receive');
320
+ lines.push(' * extracted parameters and return success/failure with optional context.');
321
+ lines.push(' */');
322
+ lines.push('');
323
+ // Generate common result type
324
+ lines.push('// =============================================================================');
325
+ lines.push('// Common Types');
326
+ lines.push('// =============================================================================');
327
+ lines.push('');
328
+ lines.push('/**');
329
+ lines.push(' * Result returned by overlay handlers');
330
+ lines.push(' * - success: true → continue to next handler/service');
331
+ lines.push(' * - success: false → return error response');
332
+ lines.push(' */');
333
+ lines.push('export interface OverlayResult<TContext = unknown> {');
334
+ lines.push(' success: boolean;');
335
+ lines.push(' error?: {');
336
+ lines.push(' status: number;');
337
+ lines.push(' message: string;');
338
+ lines.push(' code?: string;');
339
+ lines.push(' };');
340
+ lines.push(' /** Context passed to subsequent handlers and service */');
341
+ lines.push(' context?: TContext;');
342
+ lines.push('}');
343
+ lines.push('');
344
+ // Group by marker
345
+ const byMarker = new Map();
346
+ for (const info of extensionInfo.values()) {
347
+ if (!byMarker.has(info.marker)) {
348
+ byMarker.set(info.marker, []);
349
+ }
350
+ byMarker.get(info.marker).push(info);
351
+ }
352
+ // Generate interfaces for each marker
353
+ for (const [marker, extensions] of byMarker) {
354
+ const markerName = markerToTypeName(marker);
355
+ lines.push(`// =============================================================================`);
356
+ lines.push(`// ${markerName} Overlays`);
357
+ lines.push(`// =============================================================================`);
358
+ lines.push('');
359
+ // Generate value type
360
+ const values = extensions.map(e => `'${e.name}'`).join(' | ');
361
+ lines.push(`export type ${markerName}Value = ${values};`);
362
+ lines.push('');
363
+ // Generate input and handler types for each extension
364
+ for (const ext of extensions) {
365
+ const inputName = `${capitalize(ext.name)}OverlayInput`;
366
+ const handlerName = `${capitalize(ext.name)}Overlay`;
367
+ // Generate input type from injected parameters
368
+ lines.push(`/**`);
369
+ lines.push(` * Input for ${ext.name} overlay`);
370
+ lines.push(` * Parameters extracted from HTTP request by the routes layer`);
371
+ lines.push(` */`);
372
+ lines.push(`export interface ${inputName} {`);
373
+ if (ext.injectedParameters.length > 0) {
374
+ for (const param of ext.injectedParameters) {
375
+ const optional = param.required ? '' : '?';
376
+ const tsType = parameterToTsType(param);
377
+ if (param.description) {
378
+ lines.push(` /** ${param.description} */`);
379
+ }
380
+ // Use OpenAPI parameter name as-is (quoted for names with special chars)
381
+ lines.push(` '${param.name}'${optional}: ${tsType};`);
382
+ }
383
+ }
384
+ else {
385
+ // No parameters - empty input
386
+ lines.push(` // No parameters required`);
387
+ }
388
+ lines.push(`}`);
389
+ lines.push('');
390
+ // Generate handler type
391
+ lines.push(`/**`);
392
+ lines.push(` * Handler for ${ext.name} overlay`);
393
+ if (Object.keys(ext.injectedResponses).length > 0) {
394
+ lines.push(` * May return errors: ${Object.keys(ext.injectedResponses).join(', ')}`);
395
+ }
396
+ lines.push(` */`);
397
+ lines.push(`export type ${handlerName} = (input: ${inputName}) => Promise<OverlayResult>;`);
398
+ lines.push('');
399
+ }
400
+ // Generate registry interface
401
+ const registryName = `${markerName}Registry`;
402
+ lines.push(`/**`);
403
+ lines.push(` * Registry interface for ${marker} overlay handlers`);
404
+ lines.push(` */`);
405
+ lines.push(`export interface ${registryName} {`);
406
+ for (const ext of extensions) {
407
+ const handlerName = `${capitalize(ext.name)}Overlay`;
408
+ lines.push(` ${ext.name}: ${handlerName};`);
409
+ }
410
+ lines.push(`}`);
411
+ lines.push('');
412
+ }
413
+ // Generate unified OverlayRegistry (combines all markers)
414
+ lines.push('// =============================================================================');
415
+ lines.push('// Unified Overlay Registry');
416
+ lines.push('// =============================================================================');
417
+ lines.push('');
418
+ lines.push('/**');
419
+ lines.push(' * Combined registry interface for all overlay handlers');
420
+ lines.push(' * Use this when a single handler registry is needed');
421
+ lines.push(' */');
422
+ lines.push('export interface OverlayRegistry {');
423
+ for (const extensions of byMarker.values()) {
424
+ for (const ext of extensions) {
425
+ const handlerName = `${capitalize(ext.name)}Overlay`;
426
+ lines.push(` ${ext.name}: ${handlerName};`);
427
+ }
428
+ }
429
+ lines.push('}');
430
+ lines.push('');
431
+ // Generate combined extension info type
432
+ lines.push('// =============================================================================');
433
+ lines.push('// Overlay Info (for templates)');
434
+ lines.push('// =============================================================================');
435
+ lines.push('');
436
+ lines.push('export interface OverlayInfoMap {');
437
+ for (const [key, info] of extensionInfo) {
438
+ lines.push(` '${key}': {`);
439
+ lines.push(` name: '${info.name}';`);
440
+ lines.push(` marker: '${info.marker}';`);
441
+ lines.push(` injectedParameters: ${JSON.stringify(info.injectedParameters.map(p => p.name))};`);
442
+ lines.push(` injectedResponses: ${JSON.stringify(Object.keys(info.injectedResponses))};`);
443
+ lines.push(` };`);
444
+ }
445
+ lines.push('}');
446
+ lines.push('');
447
+ return lines.join('\n');
448
+ }
449
+ /**
450
+ * Convert parameter to TypeScript type
451
+ */
452
+ function parameterToTsType(param) {
453
+ if (!param.schema)
454
+ return 'unknown';
455
+ const schema = param.schema;
456
+ switch (schema.type) {
457
+ case 'string':
458
+ return 'string';
459
+ case 'integer':
460
+ case 'number':
461
+ return 'number';
462
+ case 'boolean':
463
+ return 'boolean';
464
+ case 'array':
465
+ return 'unknown[]';
466
+ default:
467
+ return 'unknown';
468
+ }
469
+ }
470
+ /**
471
+ * Convert marker like 'x-middleware' to type name like 'Middleware'
472
+ */
473
+ function markerToTypeName(marker) {
474
+ return marker
475
+ .replace(/^x-/, '')
476
+ .split('-')
477
+ .map(capitalize)
478
+ .join('');
479
+ }
480
+ function capitalize(str) {
481
+ return str.charAt(0).toUpperCase() + str.slice(1);
482
+ }
483
+ // =============================================================================
484
+ // Utility Functions
485
+ // =============================================================================
486
+ /**
487
+ * Format overlay application log for console output
488
+ */
489
+ export function formatOverlayLog(result) {
490
+ const lines = [];
491
+ for (const overlay of result.appliedOverlays) {
492
+ lines.push(`[overlay] Applying ${overlay}`);
493
+ const overlayLogs = result.log.filter(l => l.overlay === overlay);
494
+ for (const log of overlayLogs) {
495
+ lines.push(` → ${log.path} ${log.method.toUpperCase()}: ${log.changes.join(', ')}`);
496
+ }
497
+ }
498
+ return lines.join('\n');
499
+ }
500
+ //# sourceMappingURL=overlayProcessor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"overlayProcessor.js","sourceRoot":"","sources":["../../src/generator/overlayProcessor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * JSON Schema generator from OpenAPI schemas
3
+ * Generates Fastify-compatible JSON Schema objects
4
+ */
5
+ import type { OpenAPISpec } from '../types.js';
6
+ /**
7
+ * Generate JSON Schema TypeScript file from OpenAPI spec
8
+ */
9
+ export declare function generateSchemas(spec: OpenAPISpec): string;
10
+ //# sourceMappingURL=schemaGenerator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schemaGenerator.d.ts","sourceRoot":"","sources":["../../src/generator/schemaGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,aAAa,CAAC;AAsBrB;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA6DzD"}