viell-effect-schema-http 0.4.0 → 0.6.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/README.md CHANGED
@@ -54,11 +54,11 @@ In an existing Node.js 24 or 26 ESM project with Effect `^4.0.7`, add the librar
54
54
  npm install viell-effect-schema-http
55
55
  ```
56
56
 
57
- `0.4.0` is the current release. The same package is available as a checksummed [GitHub release
58
- tarball](https://github.com/viell-dev/slop-effect-schema-http/releases/tag/0.4.0). It changes
57
+ `0.6.0` is the current release. The same package is available as a checksummed [GitHub release
58
+ tarball](https://github.com/viell-dev/slop-effect-schema-http/releases/tag/0.6.0). It changes
59
59
  existing behavior, so read [What's in
60
- 0.4](https://viell-dev.github.io/slop-effect-schema-http/release-notes/0.4) before you update from
61
- `0.3`.
60
+ 0.6](https://viell-dev.github.io/slop-effect-schema-http/release-notes/0.6) before you update from
61
+ `0.5`.
62
62
 
63
63
  TypeScript declarations and editor documentation are included. The supported environments are Node
64
64
  24 or 26 on Windows/Linux and browser Fetch in Chromium. See [compatibility and
@@ -77,8 +77,10 @@ versions and provider boundaries.
77
77
  Operation, Policy, Interaction, UrlEncoding and Transport, from basic use to advanced behavior.
78
78
  - [Limits and recovery](https://viell-dev.github.io/slop-effect-schema-http/limits): compatibility,
79
79
  where the library's promise stops, failure stages and bug reporting.
80
- - [What's in 0.4](https://viell-dev.github.io/slop-effect-schema-http/release-notes/0.4) introduces
80
+ - [What's in 0.6](https://viell-dev.github.io/slop-effect-schema-http/release-notes/0.6) introduces
81
81
  the release and how to update, and [What's in
82
+ 0.5](https://viell-dev.github.io/slop-effect-schema-http/release-notes/0.5), [What's in
83
+ 0.4](https://viell-dev.github.io/slop-effect-schema-http/release-notes/0.4), [What's in
82
84
  0.3](https://viell-dev.github.io/slop-effect-schema-http/release-notes/0.3), [What's in
83
85
  0.2](https://viell-dev.github.io/slop-effect-schema-http/release-notes/0.2) and [What's in
84
86
  0.1](https://viell-dev.github.io/slop-effect-schema-http/release-notes/0.1) the earlier ones;
@@ -162,7 +162,9 @@ export type Shape = Shapes.Shape;
162
162
  * @remarks
163
163
  * This is a low-level extension type. A field a union would lose is not lost if another schema in
164
164
  * the group took it, and `settled` is never an answer to that: a schema can allow a name it did not
165
- * take.
165
+ * take. Optional `certificates` records actual claims per applied binding, allowing a union to
166
+ * replace its claim without removing another binding's evidence. Custom drafts with only `fields`
167
+ * and `settled` keep the earlier behavior and skip union recovery.
166
168
  */
167
169
  export type Taken = Shapes.Taken;
168
170
  /** A part of a request that a binding can supply, and that {@link unbind} can clear. */
@@ -367,7 +369,7 @@ type Edit = <I, E, R>(self: Request<I, E, R>) => Request<I, E, R>;
367
369
  * With a {@link headers} schema bound, in either order, the name has to be one a schema allows, and
368
370
  * the value is a default that goes through the schema. Setting a name the schema always writes,
369
371
  * after that schema, is an {@link InvalidRequest}, because the value could never reach the client.
370
- * A direct struct's constructor-filled optional field is also refused when this preparation
372
+ * A direct struct's schema-supplied optional field is also refused when this preparation
371
373
  * supplies and encodes it after the caller leaves it out, as {@link headers} describes.
372
374
  *
373
375
  * In the object form each key replaces its name as above, in key order, and other names stay. A key
@@ -394,7 +396,7 @@ export declare const appendHeader: (name: string, value: FieldValue) => Edit;
394
396
  * Names compare without case. Value functions are never evaluated to compare with `value`. Removing
395
397
  * a name a {@link headers} schema always writes, after that schema, is an {@link InvalidRequest},
396
398
  * because the schema puts the value back. Removing an optional field clears its default.
397
- * A constructor-filled optional field can also put it back and be refused, as {@link headers}
399
+ * A schema-supplied optional field can also put it back and be refused, as {@link headers}
398
400
  * describes.
399
401
  *
400
402
  * Without a value, this also stops the library's automatic value for that name: an operation's
@@ -425,7 +427,7 @@ export declare const removeHeader: (name: string, value?: string) => Edit;
425
427
  * With a {@link query} schema bound, in either order, the name has to be one a schema allows, and
426
428
  * the value is a default that goes through the schema. Setting a name the schema always writes,
427
429
  * after that schema, is an {@link InvalidRequest}, because the value could never reach the client.
428
- * A direct struct's constructor-filled optional field is also refused when this preparation
430
+ * A direct struct's schema-supplied optional field is also refused when this preparation
429
431
  * supplies and encodes it after the caller leaves it out, as {@link query} describes.
430
432
  *
431
433
  * The object form takes {@link QueryFields}. Each key replaces its name as above, in key order, and
@@ -451,7 +453,7 @@ export declare const appendQuery: (name: string, value: FieldValue<string | null
451
453
  * functions are not evaluated for comparison. Removing a name a {@link query} schema always writes,
452
454
  * after that schema, is an {@link InvalidRequest}, because the schema puts the value back. Removing
453
455
  * an optional field clears its default.
454
- * A constructor-filled optional field can also put it back and be refused, as {@link query}
456
+ * A schema-supplied optional field can also put it back and be refused, as {@link query}
455
457
  * describes.
456
458
  */
457
459
  export declare const removeQuery: (name: string, value?: string | null) => Edit;
@@ -472,11 +474,14 @@ type GroupInput<K extends "query" | "headers", A> = Record<never, never> extends
472
474
  * `undefined` still has to fit `Input`. Stacked schemas allow omission only when each one does;
473
475
  * a raw default does not make a required group optional. The invocation object is still required.
474
476
  *
475
- * In a direct struct, a constructor default can supply an omitted optional field. A raw edit
476
- * after that binding is an {@link InvalidRequest} when this preparation successfully constructs
477
- * the group and encodes a non-`undefined` value for that field. This reads the preparation's result;
478
- * it never reruns a default. Construction proof is unavailable after decoder fallback, for group
479
- * transformations, classes or unions, or for an accessor or inherited input property.
477
+ * In a direct struct, schema preparation can supply an omitted optional field. A raw edit after
478
+ * that binding is an {@link InvalidRequest} when successful preparation writes an own enumerable
479
+ * data property with a non-`undefined` value under that name in a non-iterable record. This reads
480
+ * the preparation's result without repeating schema work. A transformed group also qualifies when
481
+ * its decoded and encoded endpoints are closed structs and the ordinary or null-prototype caller
482
+ * object has no own keys of any kind and none of either endpoint's names exists on its prototype
483
+ * chain. Only an edited, declared encoded string name is checked. Nonempty transformed groups,
484
+ * classes, unions and iterable output remain outside this proof.
480
485
  *
481
486
  * The input is an {@link Input} of the schema. Encoding produces ordered header lines. The schema
482
487
  * states the shape of the group, whatever the order of the calls: once any schema is bound, every
@@ -495,6 +500,13 @@ type GroupInput<K extends "query" | "headers", A> = Record<never, never> extends
495
500
  * one of them takes stays with it, whatever a union beside it leaves out. Use {@link unbind} to
496
501
  * start again.
497
502
  *
503
+ * If a bare anyOf union would otherwise refuse uncovered root fields, it can retry the whole union
504
+ * with each member first, using the complete original input. Recovery needs actual other-binding
505
+ * claims for remaining losses and preserves every previously certified name. Parent metadata,
506
+ * transformed, open or iterable members, nested losses and joint backtracking are excluded. Existing
507
+ * successful reads do not retry. Recovery adds at most one whole-union read per other member; those
508
+ * attempts can repeat schema effects and can fail.
509
+ *
498
510
  * A field the schema produces wins over an automatic `Accept`, `Content-Type` or `Content-Length`,
499
511
  * whether the schema is bound before or after the body, and so does a default. An optional field
500
512
  * left out with no default declares nothing, so the automatic value still applies.
@@ -524,11 +536,14 @@ export declare const headers: <S extends Schema.Top & Schema.ConstraintCodec<unk
524
536
  * `undefined` still has to fit `Input`. Stacked schemas allow omission only when each one does;
525
537
  * a raw default does not make a required group optional. The invocation object is still required.
526
538
  *
527
- * In a direct struct, a constructor default can supply an omitted optional field. A raw edit
528
- * after that binding is an {@link InvalidRequest} when this preparation successfully constructs
529
- * the group and encodes a non-`undefined` value for that field. This reads the preparation's result;
530
- * it never reruns a default. Construction proof is unavailable after decoder fallback, for group
531
- * transformations, classes or unions, or for an accessor or inherited input property.
539
+ * In a direct struct, schema preparation can supply an omitted optional field. A raw edit after
540
+ * that binding is an {@link InvalidRequest} when successful preparation writes an own enumerable
541
+ * data property with a non-`undefined` value under that name in a non-iterable record. This reads
542
+ * the preparation's result without repeating schema work. A transformed group also qualifies when
543
+ * its decoded and encoded endpoints are closed structs and the ordinary or null-prototype caller
544
+ * object has no own keys of any kind and none of either endpoint's names exists on its prototype
545
+ * chain. Only an edited, declared encoded string name is checked. Nonempty transformed groups,
546
+ * classes, unions and iterable output remain outside this proof.
532
547
  *
533
548
  * The input is an {@link Input} of the schema. The schema encodes to `UrlEncoding.QueryInput` and
534
549
  * states the shape of the group, whatever the order of the calls: once any schema is bound, every
@@ -552,6 +567,13 @@ export declare const headers: <S extends Schema.Top & Schema.ConstraintCodec<unk
552
567
  * Query schemas stack: a second one adds its fields, and together they state the shape. A field one
553
568
  * of them takes stays with it, whatever a union beside it leaves out. Use {@link unbind} to start
554
569
  * again, and {@link mapInput} to supply a required field's value.
570
+ *
571
+ * If a bare anyOf union would otherwise refuse uncovered root fields, it can retry the whole union
572
+ * with each member first, using the complete original input. Recovery needs actual other-binding
573
+ * claims for remaining losses and preserves every previously certified name. Parent metadata,
574
+ * transformed, open or iterable members, nested losses and joint backtracking are excluded. Existing
575
+ * successful reads do not retry. Recovery adds at most one whole-union read per other member; those
576
+ * attempts can repeat schema effects and can fail.
555
577
  */
556
578
  export declare const query: <S extends Schema.Top & Schema.ConstraintCodec<unknown, UrlEncoding.QueryInput, unknown, unknown>>(contract: S) => <I, E, R>(self: Request<I, E, R>) => Request<I & GroupInput<"query", Input<S>>, E | Schema.SchemaError | InvalidRequest, R | S["EncodingServices"] | S["DecodingServices"]>;
557
579
  /** What a {@link PathValue}'s schema may encode to: one value with an obvious URL text. */
@@ -1 +1 @@
1
- {"version":3,"file":"Request.d.ts","sourceRoot":"","sources":["../../src/http/Request.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"Request.d.ts","sourceRoot":"","sources":["../../src/http/Request.ts"],"names":[],"mappings":"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"}
@@ -2,6 +2,7 @@ import { Data, Effect, Option, Pipeable, Redacted, Schema } from "effect";
2
2
  import { Headers, HttpClientRequest, UrlParams, } from "effect/http";
3
3
  import * as Fields from "./internal/fields.js";
4
4
  import * as Inputs from "./internal/input.js";
5
+ import * as Groups from "./internal/group.js";
5
6
  import * as Shapes from "./internal/shape.js";
6
7
  import * as Transport from "./Transport.js";
7
8
  import * as UrlEncoding from "./UrlEncoding.js";
@@ -238,7 +239,7 @@ const editQuery = (names, edit) => (self) => construct({
238
239
  * With a {@link headers} schema bound, in either order, the name has to be one a schema allows, and
239
240
  * the value is a default that goes through the schema. Setting a name the schema always writes,
240
241
  * after that schema, is an {@link InvalidRequest}, because the value could never reach the client.
241
- * A direct struct's constructor-filled optional field is also refused when this preparation
242
+ * A direct struct's schema-supplied optional field is also refused when this preparation
242
243
  * supplies and encodes it after the caller leaves it out, as {@link headers} describes.
243
244
  *
244
245
  * In the object form each key replaces its name as above, in key order, and other names stay. A key
@@ -267,7 +268,7 @@ export const appendHeader = (name, value) => editHeaders([name], (fields) => Fie
267
268
  * Names compare without case. Value functions are never evaluated to compare with `value`. Removing
268
269
  * a name a {@link headers} schema always writes, after that schema, is an {@link InvalidRequest},
269
270
  * because the schema puts the value back. Removing an optional field clears its default.
270
- * A constructor-filled optional field can also put it back and be refused, as {@link headers}
271
+ * A schema-supplied optional field can also put it back and be refused, as {@link headers}
271
272
  * describes.
272
273
  *
273
274
  * Without a value, this also stops the library's automatic value for that name: an operation's
@@ -298,7 +299,7 @@ export const removeHeader = (name, value) => editHeaders([name], (fields) => Fie
298
299
  * With a {@link query} schema bound, in either order, the name has to be one a schema allows, and
299
300
  * the value is a default that goes through the schema. Setting a name the schema always writes,
300
301
  * after that schema, is an {@link InvalidRequest}, because the value could never reach the client.
301
- * A direct struct's constructor-filled optional field is also refused when this preparation
302
+ * A direct struct's schema-supplied optional field is also refused when this preparation
302
303
  * supplies and encodes it after the caller leaves it out, as {@link query} describes.
303
304
  *
304
305
  * The object form takes {@link QueryFields}. Each key replaces its name as above, in key order, and
@@ -326,7 +327,7 @@ export const appendQuery = (name, value) => editQuery([name], (fields) => Fields
326
327
  * functions are not evaluated for comparison. Removing a name a {@link query} schema always writes,
327
328
  * after that schema, is an {@link InvalidRequest}, because the schema puts the value back. Removing
328
329
  * an optional field clears its default.
329
- * A constructor-filled optional field can also put it back and be refused, as {@link query}
330
+ * A schema-supplied optional field can also put it back and be refused, as {@link query}
330
331
  * describes.
331
332
  */
332
333
  export const removeQuery = (name, value) => editQuery([name], (fields) => Fields.remove(fields, name, value));
@@ -373,9 +374,9 @@ const misfit = (group, defaults) => new InvalidRequest({
373
374
  const lostFields = (group, names) => new InvalidRequest({
374
375
  message: `The ${group} group cannot be built against its schema: with the rest of the group, these fields would be lost: ${listNames(names)}.`,
375
376
  });
376
- /** Names only: the caller's omitted fields were actually supplied and written by construction. */
377
- const constructorConflict = (group, names) => new InvalidRequest({
378
- message: `A constructor supplied these omitted ${group} fields and their schema wrote them, so a later raw edit would be lost: ${listNames(names)}. Supply the value as input, set it with Request.mapInput, or use Request.unbind("${group}") first.`,
377
+ /** Names only: schema preparation supplied the caller's omitted fields and wrote them. */
378
+ const preparationConflict = (group, names) => new InvalidRequest({
379
+ message: `Schema preparation supplied and wrote these omitted ${group} fields, so a later raw edit would be lost: ${listNames(names)}. Supply the value as input, set it with Request.mapInput, or use Request.unbind("${group}") first.`,
379
380
  });
380
381
  /** Fields a body's encoder supplies unless the request says otherwise. */
381
382
  const bodyFields = ["content-type", "content-length"];
@@ -403,11 +404,14 @@ const applyDeclaredBodyFields = (encoded, prepared) => {
403
404
  * `undefined` still has to fit `Input`. Stacked schemas allow omission only when each one does;
404
405
  * a raw default does not make a required group optional. The invocation object is still required.
405
406
  *
406
- * In a direct struct, a constructor default can supply an omitted optional field. A raw edit
407
- * after that binding is an {@link InvalidRequest} when this preparation successfully constructs
408
- * the group and encodes a non-`undefined` value for that field. This reads the preparation's result;
409
- * it never reruns a default. Construction proof is unavailable after decoder fallback, for group
410
- * transformations, classes or unions, or for an accessor or inherited input property.
407
+ * In a direct struct, schema preparation can supply an omitted optional field. A raw edit after
408
+ * that binding is an {@link InvalidRequest} when successful preparation writes an own enumerable
409
+ * data property with a non-`undefined` value under that name in a non-iterable record. This reads
410
+ * the preparation's result without repeating schema work. A transformed group also qualifies when
411
+ * its decoded and encoded endpoints are closed structs and the ordinary or null-prototype caller
412
+ * object has no own keys of any kind and none of either endpoint's names exists on its prototype
413
+ * chain. Only an edited, declared encoded string name is checked. Nonempty transformed groups,
414
+ * classes, unions and iterable output remain outside this proof.
411
415
  *
412
416
  * The input is an {@link Input} of the schema. Encoding produces ordered header lines. The schema
413
417
  * states the shape of the group, whatever the order of the calls: once any schema is bound, every
@@ -426,6 +430,13 @@ const applyDeclaredBodyFields = (encoded, prepared) => {
426
430
  * one of them takes stays with it, whatever a union beside it leaves out. Use {@link unbind} to
427
431
  * start again.
428
432
  *
433
+ * If a bare anyOf union would otherwise refuse uncovered root fields, it can retry the whole union
434
+ * with each member first, using the complete original input. Recovery needs actual other-binding
435
+ * claims for remaining losses and preserves every previously certified name. Parent metadata,
436
+ * transformed, open or iterable members, nested losses and joint backtracking are excluded. Existing
437
+ * successful reads do not retry. Recovery adds at most one whole-union read per other member; those
438
+ * attempts can repeat schema effects and can fail.
439
+ *
429
440
  * A field the schema produces wins over an automatic `Accept`, `Content-Type` or `Content-Length`,
430
441
  * whether the schema is bound before or after the body, and so does a default. An optional field
431
442
  * left out with no default declares nothing, so the automatic value still applies.
@@ -435,56 +446,67 @@ const applyDeclaredBodyFields = (encoded, prepared) => {
435
446
  */
436
447
  export const headers = (contract) => {
437
448
  const read = Inputs.reader(contract, Schema.encodeEffect(contract));
449
+ const recover = Groups.recovery(contract);
438
450
  const { shape, settle, taken, candidates, filled } = Shapes.bind(contract, foldHeader);
439
- return (self) => construct({
440
- ...self.declaration,
441
- headerShapes: [...self.declaration.headerShapes, shape],
442
- }, Effect.fnUntraced(function* (input, draft) {
443
- if (draft.unbound.has("headers"))
444
- return yield* self.prepare(input, draft);
445
- const value = (input.headers === undefined ? {} : input.headers);
446
- const edited = candidates(value, draft.editedFields.get(shape));
447
- const { output, lost: lostFromInput, constructed } = yield* read(value);
448
- const conflicts = filled(edited, constructed, output);
449
- const own = draft.takenHeaders && taken(value, output, lostFromInput);
450
- const prepared = yield* self.prepare(input, own === undefined
451
- ? draft
452
- : {
453
- ...draft,
454
- takenHeaders: Shapes.taking(draft.takenHeaders, own),
455
- });
456
- if (lostFromInput.length > 0)
457
- yield* Inputs.refuseLost(contract, lostFromInput, prepared.takenHeaders?.fields);
458
- if (conflicts.length > 0)
459
- return yield* constructorConflict("headers", conflicts);
460
- const names = Shapes.written(output, foldHeader);
461
- const elsewhere = Shapes.others(shape, prepared.takenHeaders, foldHeader);
462
- const defaults = prepared.headerLines.filter(([name]) => !names.has(foldHeader(name)) &&
463
- !elsewhere.has(foldHeader(name)) &&
464
- Shapes.allows(shape, foldHeader(name)));
465
- const settled = yield* Effect.mapError(settle(output, defaults), () => misfit("header", defaults));
466
- // A field the schema does not write back would be lost, as a union member can lose one.
467
- const lost = Shapes.lost(output, defaults, settled, foldHeader);
468
- if (lost.length > 0)
469
- return yield* lostFields("header", lost);
470
- const lines = Transport.entries(settled);
471
- const replaced = new Set([
472
- ...names,
473
- ...defaults.map(([name]) => foldHeader(name)),
474
- ]);
475
- const cleared = HttpClientRequest.updateHeaders(prepared.request, (fields) => prepared.headerLines
476
- .map(([name]) => foldHeader(name))
477
- .filter((name) => replaced.has(name))
478
- .reduce((result, name) => Headers.remove(result, name), fields));
479
- return {
480
- ...prepared,
481
- request: HttpClientRequest.setHeaders(cleared, Transport.toHeaders(lines)),
482
- headerLines: [
483
- ...prepared.headerLines.filter(([name]) => !replaced.has(foldHeader(name))),
484
- ...lines,
485
- ],
486
- };
487
- }));
451
+ return (self) => {
452
+ const token = {};
453
+ return construct({
454
+ ...self.declaration,
455
+ headerShapes: [...self.declaration.headerShapes, shape],
456
+ }, Effect.fnUntraced(function* (input, draft) {
457
+ if (draft.unbound.has("headers"))
458
+ return yield* self.prepare(input, draft);
459
+ const value = (input.headers === undefined ? {} : input.headers);
460
+ const edited = candidates(value, draft.editedFields.get(shape));
461
+ let { output, lost: lostFromInput } = yield* read(value);
462
+ let conflicts = filled(edited, output);
463
+ const own = draft.takenHeaders && taken(value, output, lostFromInput);
464
+ let prepared = yield* self.prepare(input, own === undefined
465
+ ? draft
466
+ : {
467
+ ...draft,
468
+ takenHeaders: Shapes.taking(draft.takenHeaders, own, token),
469
+ });
470
+ if (lostFromInput.length > 0) {
471
+ const recovered = yield* recover(value, { output, lost: lostFromInput }, prepared.takenHeaders, token, taken);
472
+ if (recovered !== undefined) {
473
+ ({ output, lost: lostFromInput } = recovered.reading);
474
+ conflicts = filled(edited, output);
475
+ prepared = { ...prepared, takenHeaders: recovered.taken };
476
+ }
477
+ yield* Inputs.refuseLost(contract, lostFromInput, prepared.takenHeaders?.fields);
478
+ }
479
+ if (conflicts.length > 0)
480
+ return yield* preparationConflict("headers", conflicts);
481
+ const names = Shapes.written(output, foldHeader);
482
+ const elsewhere = Shapes.others(shape, prepared.takenHeaders, foldHeader);
483
+ const defaults = prepared.headerLines.filter(([name]) => !names.has(foldHeader(name)) &&
484
+ !elsewhere.has(foldHeader(name)) &&
485
+ Shapes.allows(shape, foldHeader(name)));
486
+ const settled = yield* Effect.mapError(settle(output, defaults), () => misfit("header", defaults));
487
+ // A field the schema does not write back would be lost, as a union member can lose one.
488
+ const lost = Shapes.lost(output, defaults, settled, foldHeader);
489
+ if (lost.length > 0)
490
+ return yield* lostFields("header", lost);
491
+ const lines = Transport.entries(settled);
492
+ const replaced = new Set([
493
+ ...names,
494
+ ...defaults.map(([name]) => foldHeader(name)),
495
+ ]);
496
+ const cleared = HttpClientRequest.updateHeaders(prepared.request, (fields) => prepared.headerLines
497
+ .map(([name]) => foldHeader(name))
498
+ .filter((name) => replaced.has(name))
499
+ .reduce((result, name) => Headers.remove(result, name), fields));
500
+ return {
501
+ ...prepared,
502
+ request: HttpClientRequest.setHeaders(cleared, Transport.toHeaders(lines)),
503
+ headerLines: [
504
+ ...prepared.headerLines.filter(([name]) => !replaced.has(foldHeader(name))),
505
+ ...lines,
506
+ ],
507
+ };
508
+ }));
509
+ };
488
510
  };
489
511
  /**
490
512
  * Bind a schema to the call's `{ query }` input.
@@ -507,11 +529,14 @@ export const headers = (contract) => {
507
529
  * `undefined` still has to fit `Input`. Stacked schemas allow omission only when each one does;
508
530
  * a raw default does not make a required group optional. The invocation object is still required.
509
531
  *
510
- * In a direct struct, a constructor default can supply an omitted optional field. A raw edit
511
- * after that binding is an {@link InvalidRequest} when this preparation successfully constructs
512
- * the group and encodes a non-`undefined` value for that field. This reads the preparation's result;
513
- * it never reruns a default. Construction proof is unavailable after decoder fallback, for group
514
- * transformations, classes or unions, or for an accessor or inherited input property.
532
+ * In a direct struct, schema preparation can supply an omitted optional field. A raw edit after
533
+ * that binding is an {@link InvalidRequest} when successful preparation writes an own enumerable
534
+ * data property with a non-`undefined` value under that name in a non-iterable record. This reads
535
+ * the preparation's result without repeating schema work. A transformed group also qualifies when
536
+ * its decoded and encoded endpoints are closed structs and the ordinary or null-prototype caller
537
+ * object has no own keys of any kind and none of either endpoint's names exists on its prototype
538
+ * chain. Only an edited, declared encoded string name is checked. Nonempty transformed groups,
539
+ * classes, unions and iterable output remain outside this proof.
515
540
  *
516
541
  * The input is an {@link Input} of the schema. The schema encodes to `UrlEncoding.QueryInput` and
517
542
  * states the shape of the group, whatever the order of the calls: once any schema is bound, every
@@ -535,47 +560,65 @@ export const headers = (contract) => {
535
560
  * Query schemas stack: a second one adds its fields, and together they state the shape. A field one
536
561
  * of them takes stays with it, whatever a union beside it leaves out. Use {@link unbind} to start
537
562
  * again, and {@link mapInput} to supply a required field's value.
563
+ *
564
+ * If a bare anyOf union would otherwise refuse uncovered root fields, it can retry the whole union
565
+ * with each member first, using the complete original input. Recovery needs actual other-binding
566
+ * claims for remaining losses and preserves every previously certified name. Parent metadata,
567
+ * transformed, open or iterable members, nested losses and joint backtracking are excluded. Existing
568
+ * successful reads do not retry. Recovery adds at most one whole-union read per other member; those
569
+ * attempts can repeat schema effects and can fail.
538
570
  */
539
571
  export const query = (contract) => {
540
572
  const read = Inputs.reader(contract, Schema.encodeEffect(contract));
573
+ const recover = Groups.recovery(contract);
541
574
  const { shape, settle, taken, candidates, filled } = Shapes.bind(contract, foldQuery);
542
- return (self) => construct({
543
- ...self.declaration,
544
- queryShapes: [...self.declaration.queryShapes, shape],
545
- }, Effect.fnUntraced(function* (input, draft) {
546
- if (draft.unbound.has("query"))
547
- return yield* self.prepare(input, draft);
548
- const value = (input.query === undefined ? {} : input.query);
549
- const edited = candidates(value, draft.editedFields.get(shape));
550
- const { output, lost: lostFromInput, constructed } = yield* read(value);
551
- const conflicts = filled(edited, constructed, output);
552
- const own = draft.takenQuery && taken(value, output, lostFromInput);
553
- const prepared = yield* self.prepare(input, own === undefined
554
- ? draft
555
- : {
556
- ...draft,
557
- takenQuery: Shapes.taking(draft.takenQuery, own),
558
- });
559
- if (lostFromInput.length > 0)
560
- yield* Inputs.refuseLost(contract, lostFromInput, prepared.takenQuery?.fields);
561
- if (conflicts.length > 0)
562
- return yield* constructorConflict("query", conflicts);
563
- const names = Shapes.written(output, foldQuery);
564
- const elsewhere = Shapes.others(shape, prepared.takenQuery, foldQuery);
565
- const defaults = prepared.request.urlParams.params
566
- .filter((param) => prepared.declaredQuery.has(param) &&
567
- !isEmptySegment(prepared, param) &&
568
- !names.has(param[0]) &&
569
- !elsewhere.has(param[0]) &&
570
- Shapes.allows(shape, param[0]))
571
- .map((param) => [param[0], queryValue(prepared, param)]);
572
- const settled = yield* Effect.mapError(settle(output, defaults), () => misfit("query", defaults));
573
- // A field the schema does not write back would be lost, as a union member can lose one.
574
- const lost = Shapes.lost(output, defaults, settled, foldQuery);
575
- if (lost.length > 0)
576
- return yield* lostFields("query", lost);
577
- return replaceQuery(prepared, UrlEncoding.queryEntries(settled), new Set([...names, ...defaults.map(([name]) => name)]));
578
- }));
575
+ return (self) => {
576
+ const token = {};
577
+ return construct({
578
+ ...self.declaration,
579
+ queryShapes: [...self.declaration.queryShapes, shape],
580
+ }, Effect.fnUntraced(function* (input, draft) {
581
+ if (draft.unbound.has("query"))
582
+ return yield* self.prepare(input, draft);
583
+ const value = (input.query === undefined ? {} : input.query);
584
+ const edited = candidates(value, draft.editedFields.get(shape));
585
+ let { output, lost: lostFromInput } = yield* read(value);
586
+ let conflicts = filled(edited, output);
587
+ const own = draft.takenQuery && taken(value, output, lostFromInput);
588
+ let prepared = yield* self.prepare(input, own === undefined
589
+ ? draft
590
+ : {
591
+ ...draft,
592
+ takenQuery: Shapes.taking(draft.takenQuery, own, token),
593
+ });
594
+ if (lostFromInput.length > 0) {
595
+ const recovered = yield* recover(value, { output, lost: lostFromInput }, prepared.takenQuery, token, taken);
596
+ if (recovered !== undefined) {
597
+ ({ output, lost: lostFromInput } = recovered.reading);
598
+ conflicts = filled(edited, output);
599
+ prepared = { ...prepared, takenQuery: recovered.taken };
600
+ }
601
+ yield* Inputs.refuseLost(contract, lostFromInput, prepared.takenQuery?.fields);
602
+ }
603
+ if (conflicts.length > 0)
604
+ return yield* preparationConflict("query", conflicts);
605
+ const names = Shapes.written(output, foldQuery);
606
+ const elsewhere = Shapes.others(shape, prepared.takenQuery, foldQuery);
607
+ const defaults = prepared.request.urlParams.params
608
+ .filter((param) => prepared.declaredQuery.has(param) &&
609
+ !isEmptySegment(prepared, param) &&
610
+ !names.has(param[0]) &&
611
+ !elsewhere.has(param[0]) &&
612
+ Shapes.allows(shape, param[0]))
613
+ .map((param) => [param[0], queryValue(prepared, param)]);
614
+ const settled = yield* Effect.mapError(settle(output, defaults), () => misfit("query", defaults));
615
+ // A field the schema does not write back would be lost, as a union member can lose one.
616
+ const lost = Shapes.lost(output, defaults, settled, foldQuery);
617
+ if (lost.length > 0)
618
+ return yield* lostFields("query", lost);
619
+ return replaceQuery(prepared, UrlEncoding.queryEntries(settled), new Set([...names, ...defaults.map(([name]) => name)]));
620
+ }));
621
+ };
579
622
  };
580
623
  /** Put text after the path so far, exactly as written. */
581
624
  const extendPath = (draft, text) => ({
@@ -819,6 +862,7 @@ export const mapEffect = (f) => (self) => construct(self.declaration, (input, dr
819
862
  const takenRecord = (shapes) => shapes.length > 1 && shapes.some(({ chooses }) => chooses)
820
863
  ? {
821
864
  fields: new Set(),
865
+ certificates: new Map(),
822
866
  settled: new Set(shapes.flatMap(({ chooses, names }) => chooses ? [] : Array.from(names))),
823
867
  }
824
868
  : undefined;