@techspokes/typescript-wsdl-client 0.30.3 → 0.32.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/compiler/schemaCompiler.d.ts.map +1 -1
- package/dist/compiler/schemaCompiler.js +74 -0
- package/docs/releases/v0.31.0.md +33 -0
- package/docs/releases/v0.32.0.md +33 -0
- package/docs/roadmap/README.md +7 -7
- package/docs/roadmap/v1.0-capability-conformance-framework.md +194 -15
- package/docs/roadmap/v1.0-wsdl-coverage-matrix.md +103 -11
- package/docs/supported-patterns.md +6 -6
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schemaCompiler.d.ts","sourceRoot":"","sources":["../../src/compiler/schemaCompiler.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"schemaCompiler.d.ts","sourceRoot":"","sources":["../../src/compiler/schemaCompiler.ts"],"names":[],"mappings":"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"}
|
|
@@ -143,6 +143,79 @@ function extractAnnotationDocumentation(node) {
|
|
|
143
143
|
.join(" ");
|
|
144
144
|
return normalizeDocText(merged);
|
|
145
145
|
}
|
|
146
|
+
function localName(name) {
|
|
147
|
+
return name.includes(":") ? name.split(":").pop() : name;
|
|
148
|
+
}
|
|
149
|
+
function isTruthyXmlBoolean(value) {
|
|
150
|
+
return String(value).trim().toLowerCase() === "true" || String(value).trim() === "1";
|
|
151
|
+
}
|
|
152
|
+
function getAttributeByLocalName(node, name) {
|
|
153
|
+
if (!node || typeof node !== "object") {
|
|
154
|
+
return undefined;
|
|
155
|
+
}
|
|
156
|
+
for (const [key, value] of Object.entries(node)) {
|
|
157
|
+
if (key.startsWith("@_") && localName(key.slice(2)) === name) {
|
|
158
|
+
return value;
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
return undefined;
|
|
162
|
+
}
|
|
163
|
+
function hasAttributeByLocalName(node, name) {
|
|
164
|
+
if (Array.isArray(node)) {
|
|
165
|
+
return node.some(child => hasAttributeByLocalName(child, name));
|
|
166
|
+
}
|
|
167
|
+
if (!node || typeof node !== "object") {
|
|
168
|
+
return false;
|
|
169
|
+
}
|
|
170
|
+
if (getAttributeByLocalName(node, name) !== undefined) {
|
|
171
|
+
return true;
|
|
172
|
+
}
|
|
173
|
+
return Object.entries(node)
|
|
174
|
+
.filter(([key]) => !key.startsWith("@_"))
|
|
175
|
+
.some(([, value]) => hasAttributeByLocalName(value, name));
|
|
176
|
+
}
|
|
177
|
+
function rejectUnsupportedSchemaConstructs(cat) {
|
|
178
|
+
for (const schema of cat.schemas) {
|
|
179
|
+
for (const element of getChildrenWithLocalName(schema.xml, "element")) {
|
|
180
|
+
const substitutionGroup = getAttributeByLocalName(element, "substitutionGroup");
|
|
181
|
+
if (substitutionGroup) {
|
|
182
|
+
throw new WsdlCompilationError(`Unsupported XSD substitution group on element "${element["@_name"] ?? "(anonymous)"}".`, {
|
|
183
|
+
element: String(element["@_name"] ?? ""),
|
|
184
|
+
namespace: schema.targetNS,
|
|
185
|
+
file: cat.wsdlUri,
|
|
186
|
+
suggestion: "Substitution groups require polymorphic element expansion. Remove the substitution group or model the accepted concrete element explicitly before generation.",
|
|
187
|
+
});
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
for (const complexType of getChildrenWithLocalName(schema.xml, "complexType")) {
|
|
191
|
+
if (isTruthyXmlBoolean(getAttributeByLocalName(complexType, "abstract"))) {
|
|
192
|
+
throw new WsdlCompilationError(`Unsupported abstract complex type "${complexType["@_name"] ?? "(anonymous)"}".`, {
|
|
193
|
+
element: String(complexType["@_name"] ?? ""),
|
|
194
|
+
namespace: schema.targetNS,
|
|
195
|
+
file: cat.wsdlUri,
|
|
196
|
+
suggestion: "Abstract complex types require polymorphic instance handling. Use a concrete type or add support for explicit abstract type diagnostics before generation.",
|
|
197
|
+
});
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
for (const element of getChildrenWithLocalName(schema.xml, "element")) {
|
|
201
|
+
if (isTruthyXmlBoolean(getAttributeByLocalName(element, "abstract"))) {
|
|
202
|
+
throw new WsdlCompilationError(`Unsupported abstract element "${element["@_name"] ?? "(anonymous)"}".`, {
|
|
203
|
+
element: String(element["@_name"] ?? ""),
|
|
204
|
+
namespace: schema.targetNS,
|
|
205
|
+
file: cat.wsdlUri,
|
|
206
|
+
suggestion: "Abstract elements require substitution or polymorphic element handling. Use a concrete element before generation.",
|
|
207
|
+
});
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
if (hasAttributeByLocalName(schema.xml, "expectedContentTypes")) {
|
|
211
|
+
throw new WsdlCompilationError("Unsupported MTOM/XOP or XML MIME attachment metadata.", {
|
|
212
|
+
namespace: schema.targetNS,
|
|
213
|
+
file: cat.wsdlUri,
|
|
214
|
+
suggestion: "Attachment payloads require MIME or binary transport semantics that are outside the typed SOAP-to-REST generation contract.",
|
|
215
|
+
});
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
}
|
|
146
219
|
/**
|
|
147
220
|
* Compile a WSDL catalog into an internal representation (CompiledCatalog).
|
|
148
221
|
* Steps:
|
|
@@ -154,6 +227,7 @@ function extractAnnotationDocumentation(node) {
|
|
|
154
227
|
* portType reference, then enumerate operations and their soapAction URIs.
|
|
155
228
|
*/
|
|
156
229
|
export function compileCatalog(cat, options, streamConfig) {
|
|
230
|
+
rejectUnsupportedSchemaConstructs(cat);
|
|
157
231
|
// symbol tables discovered across all schemas
|
|
158
232
|
const complexTypes = new Map();
|
|
159
233
|
const simpleTypes = new Map();
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# TypeScript WSDL Client v0.31.0
|
|
2
|
+
|
|
3
|
+
## Conformance Evidence Moves Downstream
|
|
4
|
+
|
|
5
|
+
This release extends the WSDL capability conformance framework beyond compile-only checks and adds diagnostics for unsupported schema constructs that previously risked silent miscompilation.
|
|
6
|
+
|
|
7
|
+
## What This Improves
|
|
8
|
+
|
|
9
|
+
Maintainers can now prove supported and partial WSDL capability rows through generated TypeScript clients and validated OpenAPI specs, not only through catalog compilation. This makes the support matrix more trustworthy and gives future gateway-runtime work a stronger base.
|
|
10
|
+
|
|
11
|
+
Unsupported abstract types, substitution groups, and MTOM/XOP-style attachment metadata now fail with structured diagnostics instead of compiling into misleading contracts.
|
|
12
|
+
|
|
13
|
+
## Highlights
|
|
14
|
+
|
|
15
|
+
- Adds generated client type-check evidence for supported and partial WSDL conformance rows.
|
|
16
|
+
- Adds OpenAPI validation and targeted schema assertions for supported and partial WSDL conformance rows.
|
|
17
|
+
- Rejects abstract complex types, substitution groups, and XML MIME attachment metadata with diagnostics.
|
|
18
|
+
- Updates the roadmap so the next 1.0 slice is gateway runtime conformance evidence.
|
|
19
|
+
|
|
20
|
+
## Upgrade Notes
|
|
21
|
+
|
|
22
|
+
WSDLs that declare abstract complex types, substitution groups, or XML MIME attachment metadata now fail during compilation with a diagnostic. This is intentional because those constructs require polymorphic or attachment transport semantics that are not part of the current typed SOAP-to-REST contract.
|
|
23
|
+
|
|
24
|
+
## Validation
|
|
25
|
+
|
|
26
|
+
- CI passed.
|
|
27
|
+
- NPM package contents were validated.
|
|
28
|
+
- Agent skill artifact was validated and packaged.
|
|
29
|
+
- Release preflight passed against the target tag.
|
|
30
|
+
|
|
31
|
+
## Notes
|
|
32
|
+
|
|
33
|
+
Release tag: `v0.31.0`.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# TypeScript WSDL Client v0.32.0
|
|
2
|
+
|
|
3
|
+
## Gateway Conformance Evidence
|
|
4
|
+
|
|
5
|
+
This release extends the WSDL capability conformance framework through generated Fastify gateway artifacts and runtime request checks for the current supported and partial capability rows.
|
|
6
|
+
|
|
7
|
+
## What This Improves
|
|
8
|
+
|
|
9
|
+
Maintainers can now verify that documented WSDL support survives the full downstream path from fixture compilation to generated client code, OpenAPI output, generated gateway code, and Fastify request handling. This makes the public support matrix more trustworthy before the project moves into the remaining generated-test and app evidence needed for 1.0.
|
|
10
|
+
|
|
11
|
+
Conformance mini-projects now run under `tmp/conformance/` inside the repository, which keeps TypeScript and Node module resolution aligned with a consumer-style project while avoiding machine-specific temporary-directory behavior.
|
|
12
|
+
|
|
13
|
+
## Highlights
|
|
14
|
+
|
|
15
|
+
- Adds generated gateway type-check evidence for supported and partial WSDL conformance rows.
|
|
16
|
+
- Adds Fastify runtime injection checks for generated gateway routes.
|
|
17
|
+
- Documents `tmp/conformance/` as the architecture boundary for generated conformance projects.
|
|
18
|
+
- Updates the roadmap so the next 1.0 slice is generated-test and app conformance evidence.
|
|
19
|
+
|
|
20
|
+
## Upgrade Notes
|
|
21
|
+
|
|
22
|
+
No special upgrade steps.
|
|
23
|
+
|
|
24
|
+
## Validation
|
|
25
|
+
|
|
26
|
+
- CI passed.
|
|
27
|
+
- NPM package contents were validated.
|
|
28
|
+
- Agent skill artifact was validated and packaged.
|
|
29
|
+
- Release preflight passed against the target tag.
|
|
30
|
+
|
|
31
|
+
## Notes
|
|
32
|
+
|
|
33
|
+
Release tag: `v0.32.0`.
|
package/docs/roadmap/README.md
CHANGED
|
@@ -18,8 +18,8 @@ The plan is optimized for preserving quality. The contract and compatibility bas
|
|
|
18
18
|
| OpenAPI compatibility | [OpenAPI Fastify Compatibility](v1.0-openapi-fastify-compatibility.md) | baseline complete | Schema strategy is proven |
|
|
19
19
|
| Choice union mode | [Choice Union Mode](v1.0-choice-union-mode.md) | complete | Implemented in `0.26.0` |
|
|
20
20
|
| JSON array streaming | [JSON Array Streaming](v1.0-json-array-streaming.md) | complete | Implemented in `0.28.0` |
|
|
21
|
-
| Conformance framework | [Capability Conformance Framework](v1.0-capability-conformance-framework.md) |
|
|
22
|
-
| WSDL coverage matrix | [WSDL Coverage Matrix](v1.0-wsdl-coverage-matrix.md) |
|
|
21
|
+
| Conformance framework | [Capability Conformance Framework](v1.0-capability-conformance-framework.md) | phase 3 shipped | Pipeline claims are test-backed |
|
|
22
|
+
| WSDL coverage matrix | [WSDL Coverage Matrix](v1.0-wsdl-coverage-matrix.md) | gateway evidence shipped | Feature support is test-backed |
|
|
23
23
|
| Release candidate | [Release Candidate Gates](v1.0-release-candidate-gates.md) | remaining | 1.0 release is repeatable |
|
|
24
24
|
|
|
25
25
|
## Execution Order
|
|
@@ -42,11 +42,11 @@ JSON array streaming is complete in `0.28.0`. The default `ndjson` format remain
|
|
|
42
42
|
|
|
43
43
|
### Slice 5: Capability Conformance Framework
|
|
44
44
|
|
|
45
|
-
|
|
45
|
+
The registry, fixture strategy, compile runner, client evidence, OpenAPI evidence, gateway runtime evidence, documentation drift check, and generated support matrix are shipped. The next work is to extend relevant rows into generated-test and app evidence without expanding public APIs.
|
|
46
46
|
|
|
47
47
|
### Slice 6: WSDL Coverage Matrix
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
The first WSDL matrix rows now exist as conformance registry entries with compile, client, OpenAPI, gateway runtime, and documentation evidence. The next work is to prove relevant rows through generated-test and app artifacts where those stages apply.
|
|
50
50
|
|
|
51
51
|
### Slice 7: Release Candidate Gates
|
|
52
52
|
|
|
@@ -54,9 +54,9 @@ Run the release candidate gates after feature work and documentation have conver
|
|
|
54
54
|
|
|
55
55
|
## Remaining Before 1.0
|
|
56
56
|
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
- Turn unsupported or partial matrix rows into diagnostics, documentation, or scoped fixes.
|
|
57
|
+
- Extend the capability registry beyond gateway runtime evidence into generated-test and app evidence.
|
|
58
|
+
- Add generated-test and app checks for supported and partial WSDL rows where those surfaces are part of the contract.
|
|
59
|
+
- Turn remaining unsupported, diagnostic, or partial matrix rows into diagnostics, documentation, or scoped fixes.
|
|
60
60
|
- Confirm `docs/supported-patterns.md` matches the matrix.
|
|
61
61
|
- Run the release-candidate gates.
|
|
62
62
|
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
# Version 1.0 Capability Conformance Framework
|
|
2
2
|
|
|
3
|
-
Status:
|
|
3
|
+
Status: Phase 3 shipped; generated-test and app evidence remaining before `1.0.0`.
|
|
4
4
|
|
|
5
5
|
Plan for turning SOAP, WSDL, OpenAPI, gateway, app, generated-test, and documentation support claims into fixture-backed conformance evidence.
|
|
6
6
|
|
|
7
|
+
Phase 1 shipped a TypeScript registry, reusable WSDL fixtures, compile-stage runner, documentation drift tests, and generated public support matrix. Phase 2 added generated client type-checking, OpenAPI validation, and executable diagnostics for terminal rows. Phase 3 added generated gateway type-checking and Fastify runtime evidence for current supported and partial rows.
|
|
8
|
+
|
|
7
9
|
See the root [README.md](../../README.md) for project overview and [Version 1.0 Roadmap Plan](README.md) for the complete 1.0 route.
|
|
8
10
|
|
|
9
11
|
## Goal
|
|
@@ -172,6 +174,8 @@ When full support is clearly local, deterministic, and representable, implement
|
|
|
172
174
|
|
|
173
175
|
## Phase 1 Decisions
|
|
174
176
|
|
|
177
|
+
Phase 1 shipped in the `0.30.x` line. Keep this section as the historical baseline and as guardrails for future registry changes.
|
|
178
|
+
|
|
175
179
|
Phase 1 is internal test infrastructure. It must not add exports from `src/index.ts`, new public CLI commands, or new consumer-facing APIs.
|
|
176
180
|
|
|
177
181
|
The first registry should live under `test/conformance/registry.ts`. It should export types and data for repository tests only. Public package exports can be reconsidered after the inspector has a stable use case.
|
|
@@ -188,19 +192,21 @@ The public evidence matrix should be generated from the registry with `npm run d
|
|
|
188
192
|
|
|
189
193
|
## Phase 1 File Map
|
|
190
194
|
|
|
191
|
-
|
|
195
|
+
The Phase 1 file map is implemented. Keep these ownership boundaries in place while extending the framework.
|
|
192
196
|
|
|
193
|
-
|
|
197
|
+
`test/conformance/types.ts` owns shared registry types. Keep these types out of `src/` until a public API is justified.
|
|
194
198
|
|
|
195
|
-
|
|
199
|
+
`test/conformance/registry.ts` owns the initial capability rows. Include new priority features from the WSDL coverage matrix here before changing generator behavior.
|
|
196
200
|
|
|
197
|
-
|
|
201
|
+
`test/conformance/runner.ts` owns compile-stage execution helpers. Resolve fixture paths relative to `test/conformance/fixtures/` and create one temporary output directory per case under the OS temp directory.
|
|
198
202
|
|
|
199
|
-
|
|
203
|
+
`test/conformance/conformance.test.ts` owns manifest-driven compile tests. Supported and partial rows should compile successfully; diagnostic rows should assert the error shape or explicit warning behavior.
|
|
200
204
|
|
|
201
|
-
|
|
205
|
+
`test/conformance/docs.test.ts` owns registry-to-docs alignment. It should validate existing heading anchors and prove that the public evidence matrix matches generated registry output.
|
|
202
206
|
|
|
203
|
-
|
|
207
|
+
`test/conformance/fixtures/` contains minimal WSDL fixtures. Keep each fixture synthetic, deterministic, and scoped to one capability.
|
|
208
|
+
|
|
209
|
+
`package.json` exposes `test:conformance` with `vitest run test/conformance`.
|
|
204
210
|
|
|
205
211
|
Modify `docs/supported-patterns.md` only when the registry reveals a real mismatch. Generate only the evidence matrix from the registry in Phase 1; do not rewrite the explanatory sections from registry data.
|
|
206
212
|
|
|
@@ -299,7 +305,7 @@ The inspector should not be treated as proof that generation will succeed. It is
|
|
|
299
305
|
|
|
300
306
|
## Phase 1: Registry And Compile Matrix
|
|
301
307
|
|
|
302
|
-
|
|
308
|
+
The capability registry, fixture directory, and Vitest runner for compile-stage expectations are implemented. Keep unsupported rows diagnostic or research-only until behavior is proven.
|
|
303
309
|
|
|
304
310
|
Start with these capability IDs:
|
|
305
311
|
|
|
@@ -327,6 +333,8 @@ Acceptance criteria:
|
|
|
327
333
|
|
|
328
334
|
## Phase 2: Client And OpenAPI Evidence
|
|
329
335
|
|
|
336
|
+
Phase 2 is implemented for the current supported and partial WSDL rows. Keep this section as the baseline for future client and OpenAPI evidence.
|
|
337
|
+
|
|
330
338
|
Extend supported rows to generate clients and OpenAPI specs. Add type-check verification for generated clients and schema assertions for OpenAPI output.
|
|
331
339
|
|
|
332
340
|
Acceptance criteria:
|
|
@@ -336,16 +344,187 @@ Acceptance criteria:
|
|
|
336
344
|
- Capability-specific schema strategies are asserted where they matter.
|
|
337
345
|
- Diagnostic rows stop before downstream stages.
|
|
338
346
|
|
|
347
|
+
Recommended scope:
|
|
348
|
+
|
|
349
|
+
- Add optional `client` and `openapi` expectation blocks to `CapabilityCase`.
|
|
350
|
+
- Generate artifacts into a temporary directory owned by each capability row.
|
|
351
|
+
- Emit a temporary `tsconfig.json` that includes generated client artifacts and uses repository NodeNext settings.
|
|
352
|
+
- Validate OpenAPI documents through the same validator used by existing OpenAPI tests.
|
|
353
|
+
- Assert public schema contracts for rows that already claim support or partial support.
|
|
354
|
+
|
|
355
|
+
Skeptical review notes:
|
|
356
|
+
|
|
357
|
+
- A `supported` status should not rely on compile-only evidence after this phase.
|
|
358
|
+
- `diagnostic` rows currently using `research` compile expectations need either real diagnostics or clearer deferral language.
|
|
359
|
+
- Whole-file snapshots would make conformance brittle; prefer targeted assertions on generated types, schemas, paths, and operation metadata.
|
|
360
|
+
- The support matrix generator should remain limited to the public evidence table, not the human-authored explanatory sections.
|
|
361
|
+
- Keep the inspector out of this slice unless the stage evidence reveals a stable detection model.
|
|
362
|
+
|
|
339
363
|
## Phase 3: Gateway Runtime Evidence
|
|
340
364
|
|
|
341
|
-
|
|
365
|
+
Phase 3 is implemented for the current supported and partial WSDL rows. Keep this section as the baseline for future gateway conformance rows.
|
|
342
366
|
|
|
343
|
-
|
|
367
|
+
Extend current supported and partial rows to generate gateways, type-check generated gateway artifacts, and test Fastify runtime behavior through `fastify.inject`. Add mock operations clients and request/response fixtures as part of each row's registry evidence.
|
|
368
|
+
|
|
369
|
+
### Phase 3 Goal
|
|
370
|
+
|
|
371
|
+
A supported or partial row should no longer stop at compile, client, and OpenAPI evidence when gateway behavior is relevant. The row should prove that the generated Fastify plugin can be imported, registered with a mock operations client, and exercised through HTTP injection.
|
|
372
|
+
|
|
373
|
+
Diagnostic and unsupported rows must continue to stop at compile. They must not generate client, OpenAPI, or gateway artifacts after the expected diagnostic.
|
|
374
|
+
|
|
375
|
+
### Phase 3 Source Files
|
|
376
|
+
|
|
377
|
+
- `test/conformance/types.ts`
|
|
378
|
+
- `test/conformance/registry.ts`
|
|
379
|
+
- `test/conformance/runner.ts`
|
|
380
|
+
- `test/conformance/conformance.test.ts`
|
|
381
|
+
- `src/gateway/generateGateway.ts`
|
|
382
|
+
- `test/integration/gateway-routes.test.ts`
|
|
383
|
+
|
|
384
|
+
Use `test/integration/gateway-routes.test.ts` as the runtime pattern for generated plugin imports, mock clients, Fastify registration, and `fastify.inject` assertions. Keep conformance-specific helpers in `test/conformance/runner.ts`.
|
|
385
|
+
|
|
386
|
+
### Phase 3 Type Model
|
|
387
|
+
|
|
388
|
+
Add a small optional `gateway` expectation block to `CapabilityCase`. Keep it internal to `test/conformance/types.ts`; do not export it from `src/index.ts` and do not add a public CLI command.
|
|
389
|
+
|
|
390
|
+
The initial model should stay close to the current `client` and `openapi` expectations:
|
|
391
|
+
|
|
392
|
+
```ts
|
|
393
|
+
export interface GatewayArtifacts {
|
|
394
|
+
clientDir: string;
|
|
395
|
+
gatewayDir: string;
|
|
396
|
+
openapiFile: string;
|
|
397
|
+
catalogFile: string;
|
|
398
|
+
compiled: CompiledCatalog;
|
|
399
|
+
doc: any;
|
|
400
|
+
routeFor: (operationId: string) => {method: string; path: string};
|
|
401
|
+
readGatewayFile: (relativePath: string) => string;
|
|
402
|
+
}
|
|
403
|
+
|
|
404
|
+
export interface GatewayRequestExpectation {
|
|
405
|
+
operationId: string;
|
|
406
|
+
payload: unknown;
|
|
407
|
+
mockClient: Record<string, (args: unknown) => Promise<{response: unknown; headers: unknown}>>;
|
|
408
|
+
expectedStatus: number;
|
|
409
|
+
assertBody?: (body: any) => void;
|
|
410
|
+
assertClientArgs?: (args: unknown) => void;
|
|
411
|
+
}
|
|
412
|
+
|
|
413
|
+
export interface GatewayExpectation {
|
|
414
|
+
outcome: "success";
|
|
415
|
+
requests?: GatewayRequestExpectation[];
|
|
416
|
+
sourceIncludes?: Array<{file: string; text: string}>;
|
|
417
|
+
assert?: (artifacts: GatewayArtifacts) => void | Promise<void>;
|
|
418
|
+
}
|
|
419
|
+
```
|
|
420
|
+
|
|
421
|
+
This shape is a starting contract, not a generic assertion language. If implementation reveals a simpler local helper, prefer the simpler helper as long as a fresh agent can still understand how to add a new row.
|
|
422
|
+
|
|
423
|
+
### Phase 3 Runner Flow
|
|
424
|
+
|
|
425
|
+
`runGatewayCase` should use one temporary output root per capability row and remove it after success. If a row fails, the thrown error should include the capability ID and the generated path involved.
|
|
426
|
+
|
|
427
|
+
Generated conformance projects should live under `tmp/conformance/`, not the OS temp directory. Gateway conformance generates a small TypeScript project that imports `soap`, `fastify`, `fastify-plugin`, generated JSON schemas, and generated sibling modules. Keeping that project under the repository lets normal Node and TypeScript ancestor lookup find `node_modules`, package metadata, and tool caches without brittle `paths` shims. OS temp directories remain acceptable for unit probes that do not type-check or import generated project graphs.
|
|
428
|
+
|
|
429
|
+
The runner should perform these steps:
|
|
430
|
+
|
|
431
|
+
1. Compile the row fixture with `loadWsdl`, `resolveCompilerOptions`, and `compileCatalog`.
|
|
432
|
+
2. Generate client artifacts into `<temp>/client`.
|
|
433
|
+
3. Write `<temp>/client/catalog.json` with `generateCatalog`.
|
|
434
|
+
4. Type-check generated client artifacts using the existing temporary `tsconfig.json` pattern.
|
|
435
|
+
5. Generate OpenAPI into `<temp>/openapi.json` with validation enabled.
|
|
436
|
+
6. Generate gateway artifacts into `<temp>/gateway` with `generateGateway`.
|
|
437
|
+
7. Pass `clientDir`, `catalogFile`, `versionSlug`, and `serviceSlug` to `generateGateway`.
|
|
438
|
+
8. Type-check generated client and gateway artifacts together.
|
|
439
|
+
9. Dynamically import `<temp>/gateway/plugin.ts`.
|
|
440
|
+
10. Register the plugin with `Fastify({logger: false})` and the row's mock operations client.
|
|
441
|
+
11. Resolve each request path from the generated OpenAPI operation when possible.
|
|
442
|
+
12. Execute `fastify.inject` and run row-specific status and body assertions.
|
|
443
|
+
|
|
444
|
+
Use stable gateway options unless a row declares a reason to override them:
|
|
445
|
+
|
|
446
|
+
```ts
|
|
447
|
+
await generateGateway({
|
|
448
|
+
openapiFile,
|
|
449
|
+
outDir: gatewayDir,
|
|
450
|
+
clientDir,
|
|
451
|
+
catalogFile,
|
|
452
|
+
versionSlug: "v1",
|
|
453
|
+
serviceSlug: "conformance",
|
|
454
|
+
});
|
|
455
|
+
```
|
|
456
|
+
|
|
457
|
+
Keep service and version slugs deterministic. Do not derive slugs from temporary paths.
|
|
458
|
+
|
|
459
|
+
### Phase 3 Registry Scope
|
|
460
|
+
|
|
461
|
+
Add `gateway` expectations only to rows that already have successful compile, client, and OpenAPI expectations.
|
|
462
|
+
|
|
463
|
+
Rows expected to receive gateway evidence in this slice:
|
|
464
|
+
|
|
465
|
+
- `choice-union-simple`
|
|
466
|
+
- `xs-union-simple-type`
|
|
467
|
+
- `multi-binding-first-soap`
|
|
468
|
+
- `external-policy-reference`
|
|
469
|
+
- `deep-composition-sequence`
|
|
470
|
+
- `xs-anyattribute`
|
|
471
|
+
|
|
472
|
+
Rows that must not receive gateway evidence in this slice:
|
|
473
|
+
|
|
474
|
+
- `abstract-complex-type`
|
|
475
|
+
- `substitution-group-element`
|
|
476
|
+
- `mtom-xop-attachment`
|
|
477
|
+
|
|
478
|
+
### Phase 3 Assertion Guidance
|
|
479
|
+
|
|
480
|
+
Every row with a `gateway` expectation should at least prove plugin import and registration. Add request assertions when HTTP behavior is part of the row's public contract.
|
|
481
|
+
|
|
482
|
+
For supported rows, prefer one accepted request with a SOAP-wrapper-shaped mock response and an assertion on the generated success envelope. Add one rejected request only when the generated OpenAPI schema can express a meaningful invalid payload for that capability.
|
|
483
|
+
|
|
484
|
+
For partial rows, prove the documented subset and avoid implying full support. For `xs-anyattribute`, gateway evidence should prove generation and runtime do not emit or require wildcard attribute bags. For external `PolicyReference`, gateway evidence should prove no generated inbound security requirement appears unless configured elsewhere.
|
|
485
|
+
|
|
486
|
+
For multi-binding rows, assert that the gateway route calls the operation selected by the deterministic first SOAP binding behavior. Do not implement explicit binding selection in this slice.
|
|
487
|
+
|
|
488
|
+
### Phase 3 Non-Goals
|
|
489
|
+
|
|
490
|
+
- Do not add new WSDL feature rows.
|
|
491
|
+
- Do not add a public inspector command.
|
|
492
|
+
- Do not change generated gateway public APIs unless gateway evidence exposes a real bug.
|
|
493
|
+
- Do not snapshot whole generated files.
|
|
494
|
+
- Do not treat plugin generation alone as runtime support.
|
|
495
|
+
- Do not proceed past compile for diagnostic or unsupported rows.
|
|
496
|
+
|
|
497
|
+
### Phase 3 Acceptance Criteria
|
|
498
|
+
|
|
499
|
+
- `CapabilityCase` supports optional gateway expectations.
|
|
500
|
+
- `test/conformance/conformance.test.ts` requires gateway expectations for supported and partial rows.
|
|
501
|
+
- `runGatewayCase` generates client, catalog, OpenAPI, and gateway artifacts in a row-local temp directory.
|
|
502
|
+
- Generated client and gateway artifacts type-check together.
|
|
503
|
+
- Generated plugins import and register successfully in Fastify.
|
|
504
|
+
- Gateway request expectations run through `fastify.inject`.
|
|
505
|
+
- Diagnostic and unsupported rows remain compile-terminal.
|
|
506
|
+
- `npm run test:conformance` passes.
|
|
507
|
+
- `npm run typecheck` passes.
|
|
508
|
+
- `npm run docs:validate` passes after any support matrix or roadmap updates.
|
|
509
|
+
|
|
510
|
+
### Phase 3 Test-First Sequence
|
|
511
|
+
|
|
512
|
+
Start by adding the type fields, the downstream declaration guard, and the `runGatewayCase` test call. The first focused run of `npm run test:conformance` should fail because registry rows do not yet declare gateway expectations or because the runner is not implemented.
|
|
513
|
+
|
|
514
|
+
Then implement the runner helper and add the smallest gateway expectations per row. Keep failures local: if one row exposes a real gateway bug, either fix the bug with focused tests or downgrade the row's public contract only when the decision framework supports that change.
|
|
515
|
+
|
|
516
|
+
### Phase 3 Verification Commands
|
|
517
|
+
|
|
518
|
+
Run these commands before concluding the slice:
|
|
519
|
+
|
|
520
|
+
```bash
|
|
521
|
+
npm run test:conformance
|
|
522
|
+
npm run typecheck
|
|
523
|
+
npm run docs:validate
|
|
524
|
+
npm test
|
|
525
|
+
```
|
|
344
526
|
|
|
345
|
-
-
|
|
346
|
-
- Valid request fixtures return expected envelopes or streams.
|
|
347
|
-
- Invalid request fixtures fail with expected status codes.
|
|
348
|
-
- Stream rows prove NDJSON and JSON array behavior separately.
|
|
527
|
+
Run `npm run smoke:pipeline` as a final end-to-end guard if gateway generator behavior changes outside the conformance runner.
|
|
349
528
|
|
|
350
529
|
## Phase 4: Generated Test And App Evidence
|
|
351
530
|
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
# Version 1.0 WSDL Coverage Matrix
|
|
2
2
|
|
|
3
|
-
Status: remaining before `1.0.0`.
|
|
3
|
+
Status: gateway runtime evidence shipped; generated-test and app evidence remaining before `1.0.0`.
|
|
4
4
|
|
|
5
5
|
Plan for turning WSDL and XSD support claims into automated, fixture-backed evidence before 1.0. This is the first domain under the [Capability Conformance Framework](v1.0-capability-conformance-framework.md).
|
|
6
6
|
|
|
7
|
+
The initial fixture-backed compile matrix shipped in `0.30.2` and `0.30.3`. Client, OpenAPI, and gateway runtime evidence now prove the current supported and partial rows, and terminal rows have executable diagnostics. The remaining work is to prove generated-test and app artifacts where those surfaces are part of the contract.
|
|
8
|
+
|
|
7
9
|
See the root [README.md](../../README.md) for project overview and [Version 1.0 Roadmap Plan](README.md) for the complete 1.0 route.
|
|
8
10
|
|
|
9
11
|
## Goal
|
|
@@ -14,19 +16,32 @@ The project should have an automated WSDL and XSD feature matrix that proves whi
|
|
|
14
16
|
|
|
15
17
|
Each matrix row should have a minimal fixture, an expected support status, and a test that proves the status. A supported feature must compile and generate aligned client, OpenAPI, and gateway artifacts where applicable. An unsupported feature must fail with a clear diagnostic or be documented as intentionally out of scope.
|
|
16
18
|
|
|
17
|
-
##
|
|
19
|
+
## Shipped Baseline
|
|
20
|
+
|
|
21
|
+
- `test/conformance/fixtures/` contains the first priority WSDL fixture set.
|
|
22
|
+
- `test/conformance/registry.ts` lists priority rows with status, decision, provenance, and public contract text.
|
|
23
|
+
- `test/conformance/conformance.test.ts` runs compile-stage expectations for runnable rows.
|
|
24
|
+
- Supported and partial rows generate client artifacts that type-check.
|
|
25
|
+
- Supported and partial rows generate validated OpenAPI specs with targeted contract assertions.
|
|
26
|
+
- Supported and partial rows generate gateway artifacts that type-check and run through Fastify injection.
|
|
27
|
+
- Diagnostic and unsupported rows have executable compiler error expectations.
|
|
28
|
+
- `docs/supported-patterns.md` includes a generated capability evidence matrix.
|
|
29
|
+
- `npm run docs:support-matrix:check` prevents support matrix drift.
|
|
18
30
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
- Add
|
|
22
|
-
-
|
|
23
|
-
-
|
|
31
|
+
## Remaining Scope
|
|
32
|
+
|
|
33
|
+
- Add stage expectations for generated tests and app scaffolds where those surfaces are part of a capability contract.
|
|
34
|
+
- Add generated request and response fixtures for generated-test coverage where HTTP behavior is part of a capability contract.
|
|
35
|
+
- Keep diagnostics executable as more unsupported rows are added.
|
|
36
|
+
- Keep fixture metadata useful for a future public conformance fixture corpus.
|
|
37
|
+
- Preserve the weather smoke fixture as the canonical end-to-end happy path.
|
|
24
38
|
|
|
25
39
|
## Out Of Scope
|
|
26
40
|
|
|
27
41
|
- Do not implement every unsupported WSDL feature in this slice.
|
|
28
42
|
- Do not replace the existing weather fixture for smoke tests.
|
|
29
|
-
- Do not
|
|
43
|
+
- Do not generate the explanatory supported-pattern sections from the registry.
|
|
44
|
+
- Do not add public CLI commands for the inspector until the registry evidence model stabilizes.
|
|
30
45
|
|
|
31
46
|
## Priority Feature Rows
|
|
32
47
|
|
|
@@ -63,16 +78,20 @@ The manifest should be small and reviewable. A JSON or TypeScript manifest is ac
|
|
|
63
78
|
|
|
64
79
|
### Matrix Runner
|
|
65
80
|
|
|
66
|
-
|
|
81
|
+
The existing Vitest suite reads the TypeScript registry and runs compile expectations through programmatic APIs. The next runner should generate artifacts into per-case temporary directories and avoid shelling out where direct generator APIs give better diagnostics.
|
|
67
82
|
|
|
68
83
|
### Supported Feature Tests
|
|
69
84
|
|
|
70
85
|
For supported rows, assert successful compilation, generated TypeScript type-checking, OpenAPI validation, and gateway schema generation when applicable.
|
|
71
86
|
|
|
87
|
+
Generated client checks should verify that emitted `client.ts`, `types.ts`, `utils.ts`, and `operations.ts` type-check together. OpenAPI checks should validate the full spec and assert capability-specific schema shapes only where the shape is part of the public contract.
|
|
88
|
+
|
|
72
89
|
### Diagnostic Feature Tests
|
|
73
90
|
|
|
74
91
|
For diagnostic rows, assert the exact error class or user-facing message shape. Avoid brittle full-message assertions unless the message is part of the public contract.
|
|
75
92
|
|
|
93
|
+
Rows marked `diagnostic` should not remain permanent `research` placeholders. If full diagnostics are not implemented in the next slice, the row should say `defer` or carry a clear unresolved decision rather than implying that diagnostic behavior already exists.
|
|
94
|
+
|
|
76
95
|
### Documentation Tests
|
|
77
96
|
|
|
78
97
|
Ensure every documented unsupported or partial feature has a corresponding matrix row. This can be a lightweight consistency test that compares feature IDs with anchors or explicit markers in `docs/supported-patterns.md`.
|
|
@@ -80,12 +99,85 @@ Ensure every documented unsupported or partial feature has a corresponding matri
|
|
|
80
99
|
## Acceptance Criteria
|
|
81
100
|
|
|
82
101
|
- The matrix includes every roadmap priority feature.
|
|
83
|
-
- Supported rows have
|
|
84
|
-
- Unsupported rows fail with clear diagnostics.
|
|
102
|
+
- Supported rows have compile, client, and OpenAPI evidence when those stages apply.
|
|
103
|
+
- Unsupported or diagnostic rows fail with clear diagnostics, or are explicitly deferred without support claims.
|
|
85
104
|
- `docs/supported-patterns.md` reflects the matrix.
|
|
86
105
|
- No known feature silently miscompiles in matrix coverage.
|
|
87
106
|
- The matrix can run in CI or release preflight without network access.
|
|
88
107
|
|
|
108
|
+
## Gateway Runtime Evidence
|
|
109
|
+
|
|
110
|
+
Phase 3 gateway runtime evidence is shipped for the current supported and partial rows. The current matrix now proves the WSDL to client to OpenAPI to Fastify path for rows that claim support or partial support.
|
|
111
|
+
|
|
112
|
+
Use [Capability Conformance Framework](v1.0-capability-conformance-framework.md) as the detailed implementation baseline. This section defines the WSDL-matrix-specific shipped scope.
|
|
113
|
+
|
|
114
|
+
### Phase 3 Shipped Scope
|
|
115
|
+
|
|
116
|
+
- Optional `gateway` expectations exist in the conformance type model.
|
|
117
|
+
- Gateway artifacts are generated from each relevant row's OpenAPI document.
|
|
118
|
+
- The generated `catalog.json` is written before gateway generation.
|
|
119
|
+
- Generated gateway artifacts type-check with the generated client artifacts.
|
|
120
|
+
- Mock operations clients and `fastify.inject` assertions cover HTTP behavior.
|
|
121
|
+
- Diagnostic and unsupported rows stop at compile.
|
|
122
|
+
- The generated public support matrix remains status-focused.
|
|
123
|
+
|
|
124
|
+
### Phase 3 Row Scope
|
|
125
|
+
|
|
126
|
+
Rows that should gain gateway evidence:
|
|
127
|
+
|
|
128
|
+
- `choice-union-simple`
|
|
129
|
+
- `xs-union-simple-type`
|
|
130
|
+
- `multi-binding-first-soap`
|
|
131
|
+
- `external-policy-reference`
|
|
132
|
+
- `deep-composition-sequence`
|
|
133
|
+
- `xs-anyattribute`
|
|
134
|
+
|
|
135
|
+
Rows that should stay compile-terminal:
|
|
136
|
+
|
|
137
|
+
- `abstract-complex-type`
|
|
138
|
+
- `substitution-group-element`
|
|
139
|
+
- `mtom-xop-attachment`
|
|
140
|
+
|
|
141
|
+
### Phase 3 Runtime Expectations
|
|
142
|
+
|
|
143
|
+
Each gateway-enabled row should prove plugin import, plugin registration, and at least one `fastify.inject` request when route behavior is relevant. Assertions should inspect the generated success or error envelope, not just the existence of generated files.
|
|
144
|
+
|
|
145
|
+
Partial rows must prove only the documented subset. `xs:anyAttribute` should not imply generated wildcard attribute bags. External `PolicyReference` should not imply fetched or enforced external policy.
|
|
146
|
+
|
|
147
|
+
### Phase 3 Gotchas
|
|
148
|
+
|
|
149
|
+
- Do not overclaim `supported` when gateway behavior is relevant but unproven.
|
|
150
|
+
- Do not snapshot whole generated files for conformance rows; assert stable contract surfaces instead.
|
|
151
|
+
- Do not share temporary output directories across rows.
|
|
152
|
+
- Do not let diagnostic or unsupported rows proceed to client, OpenAPI, or gateway generation.
|
|
153
|
+
- Do not add a public inspector command in this slice.
|
|
154
|
+
|
|
155
|
+
### Next Slice
|
|
156
|
+
|
|
157
|
+
The next slice is Phase 4 generated-test and app evidence. Implement it before adding more feature rows unless a production bug requires a focused diagnostic or support decision.
|
|
158
|
+
|
|
159
|
+
Work items:
|
|
160
|
+
|
|
161
|
+
- Add optional generated-test expectations for rows where `--test-dir` behavior is part of the contract.
|
|
162
|
+
- Generate app scaffolds for rows where app wiring is affected by the capability.
|
|
163
|
+
- Type-check generated app artifacts when an app expectation is present.
|
|
164
|
+
- Run generated tests only for rows that request generated-test evidence.
|
|
165
|
+
- Keep diagnostic and unsupported rows stopped at compile.
|
|
166
|
+
- Update public docs only when a row status or public contract changes.
|
|
167
|
+
|
|
168
|
+
### Verification
|
|
169
|
+
|
|
170
|
+
Run these commands before the slice is considered ready:
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
npm run test:conformance
|
|
174
|
+
npm run typecheck
|
|
175
|
+
npm run docs:validate
|
|
176
|
+
npm test
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
Run `npm run smoke:pipeline` if the gateway generator or pipeline behavior changes.
|
|
180
|
+
|
|
89
181
|
## Release Implications
|
|
90
182
|
|
|
91
183
|
This slice may reveal features that should be implemented before 1.0. It may also justify explicit post-1.0 deferrals if diagnostics and documentation are strong enough.
|
|
@@ -11,13 +11,13 @@ The rows below are backed by committed conformance fixtures under `test/conforma
|
|
|
11
11
|
|---|---|---|
|
|
12
12
|
| `choice-union-simple` | supported | `xs:choice` union mode retains choice metadata and drives generated TypeScript/OpenAPI constraints. |
|
|
13
13
|
| `xs-union-simple-type` | supported | Simple `xs:union` aliases compile to TypeScript unions and OpenAPI `oneOf` schemas. |
|
|
14
|
-
| `abstract-complex-type` | diagnostic | Abstract complex
|
|
15
|
-
| `substitution-group-element` | diagnostic | Substitution groups are
|
|
14
|
+
| `abstract-complex-type` | diagnostic | Abstract complex types are rejected with a diagnostic instead of being treated as concrete. |
|
|
15
|
+
| `substitution-group-element` | diagnostic | Substitution groups are rejected with a diagnostic instead of being silently omitted. |
|
|
16
16
|
| `multi-binding-first-soap` | partial | Multiple bindings are deterministic: the first SOAP binding is selected and all ports are documented. |
|
|
17
17
|
| `external-policy-reference` | partial | Inline policy hints are detected; external `PolicyReference` documents are not fetched or resolved. |
|
|
18
18
|
| `deep-composition-sequence` | supported | Deep nested sequences compile into deterministic type metadata. |
|
|
19
19
|
| `xs-anyattribute` | partial | `xs:anyAttribute` is retained as catalog metadata, but generated wildcard attributes are not emitted. |
|
|
20
|
-
| `mtom-xop-attachment` | unsupported | MTOM/XOP binary attachment transport is outside the 1.0 typed SOAP-to-REST contract. |
|
|
20
|
+
| `mtom-xop-attachment` | unsupported | MTOM/XOP binary attachment metadata is rejected because attachment transport is outside the 1.0 typed SOAP-to-REST contract. |
|
|
21
21
|
<!-- support-matrix:end -->
|
|
22
22
|
|
|
23
23
|
## Fully Supported
|
|
@@ -97,9 +97,9 @@ Attribute wildcards are retained as catalog metadata on the enclosing compiled t
|
|
|
97
97
|
These features are not currently handled. Contributions are welcome.
|
|
98
98
|
|
|
99
99
|
- Full `xs:any` serialization: arbitrary wildcard content is not emitted as a typed contract
|
|
100
|
-
- Abstract types:
|
|
101
|
-
- Substitution groups:
|
|
102
|
-
- MTOM/XOP binary attachments:
|
|
100
|
+
- Abstract types: rejected with a diagnostic; no polymorphic instance handling
|
|
101
|
+
- Substitution groups: rejected with a diagnostic; no polymorphic element expansion
|
|
102
|
+
- MTOM/XOP binary attachments: rejected with a diagnostic; no binary part handling
|
|
103
103
|
- WS-ReliableMessaging, WS-Addressing beyond basic headers
|
|
104
104
|
- Custom serialization hooks for non-standard XML patterns
|
|
105
105
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@techspokes/typescript-wsdl-client",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.32.0",
|
|
4
4
|
"description": "Turn legacy WSDL/SOAP services into typed TypeScript clients, OpenAPI 3.1 specs, and production-ready Fastify REST gateways. Built for enterprise SOAP modernization.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"wsdl",
|