@ultimabase/http 0.4.0-canary.20261104141426 → 0.4.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/CHANGELOG.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @ultimabase/http
2
2
 
3
- ## 0.4.0-canary.20261104141426
3
+ ## 0.4.0
4
4
 
5
5
  ### Minor Changes
6
6
 
@@ -47,9 +47,20 @@
47
47
  `cors` lists it. The start refuses a `bodyLimit` that is not a whole number
48
48
  of bytes above 0, as `NaN`, which lifted the limit, and a `drain` that is
49
49
  not a whole number of milliseconds.
50
+ - b65eb74: A `many` facing a `one` takes `size: { min, max }` (D-242): each parent a
51
+ write or a transaction touches holds `min` to `max` rows at its end, or the
52
+ write is refused with `RELATION_SIZE`, `details: { model, field, id, min,
53
+ max, size }`, and nothing of it is kept. Every path counts: nested and bulk
54
+ writes, moves from either side, deletes, cascades and `setNull`; deleting
55
+ the parent is never refused by its own bound. Each write locks the parents
56
+ it touches, so concurrent writes cannot pass the bound together. A
57
+ many-to-many or a view with a `size` is refused by the types and at startup.
58
+ HTTP sends `RELATION_SIZE` as 409, and the GraphQL and OpenAPI schemas state
59
+ the bound in the field's description: `Holds 2 to 4 rows.`
50
60
  - Updated dependencies [67d5152]
51
61
  - Updated dependencies [4c2d462]
52
62
  - Updated dependencies [7accc26]
63
+ - Updated dependencies [783fc4b]
53
64
  - Updated dependencies [f38d1fb]
54
65
  - Updated dependencies [8dca2cf]
55
66
  - Updated dependencies [4e1a966]
@@ -58,9 +69,13 @@
58
69
  - Updated dependencies [6f37f70]
59
70
  - Updated dependencies [9b491fb]
60
71
  - Updated dependencies [9b491fb]
72
+ - Updated dependencies [b65eb74]
61
73
  - Updated dependencies [1354efd]
74
+ - Updated dependencies [b994e6e]
62
75
  - Updated dependencies [fb807e1]
63
76
  - Updated dependencies [69699b2]
77
+ - Updated dependencies [4b37376]
78
+ - Updated dependencies [d76e882]
64
79
  - Updated dependencies [ebdf8a0]
65
80
  - Updated dependencies [b5c22b0]
66
81
  - Updated dependencies [1d7fda8]
@@ -72,9 +87,10 @@
72
87
  - Updated dependencies [eb6dbbf]
73
88
  - Updated dependencies [c9a8228]
74
89
  - Updated dependencies [501c0cb]
90
+ - Updated dependencies [644a24f]
75
91
  - Updated dependencies [efc4303]
76
92
  - Updated dependencies [6c1cfe5]
77
- - ultimabase@0.4.0-canary.20261104141426
93
+ - ultimabase@0.4.0
78
94
 
79
95
  ## 0.3.0
80
96
 
package/dist/app.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAM3B,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,EAAE,MAAM,YAAY,CAAA;AAG3D,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAKzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAGxC;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IAAE,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAA;AAExE,uEAAuE;AACvE,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAA;AAElC,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC3B;AAED,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,kHAAkH;IAClH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,KAAK,CAAA;CACtC;AAmED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAI1E;AAgBD;;;GAGG;AACH,wBAAgB,KAAK,CACpB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,EACC,MAAM,EACN,KAAK,EACL,SAAS,GACT,EAAE;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC3B,EACD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,EAC/C,MAAM,EAAE,MAAM,GACZ,IAAI,CAAC,OAAO,CAAC,CAqIf"}
1
+ {"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAM3B,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,EAAE,MAAM,YAAY,CAAA;AAG3D,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAKzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAGxC;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IAAE,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAA;AAExE,uEAAuE;AACvE,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAA;AAElC,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC3B;AAED,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,kHAAkH;IAClH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,KAAK,CAAA;CACtC;AAoED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAI1E;AAgBD;;;GAGG;AACH,wBAAgB,KAAK,CACpB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,EACC,MAAM,EACN,KAAK,EACL,SAAS,GACT,EAAE;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC3B,EACD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,EAC/C,MAAM,EAAE,MAAM,GACZ,IAAI,CAAC,OAAO,CAAC,CAqIf"}
package/dist/app.js CHANGED
@@ -23,6 +23,7 @@ const statuses = new Map([
23
23
  ['VALIDATION_FAILED', 400],
24
24
  ['UNIQUE_VIOLATION', 409],
25
25
  ['RELATION_RESTRICTED', 409],
26
+ ['RELATION_SIZE', 409],
26
27
  ['UNAUTHENTICATED', 401],
27
28
  ['INVALID_CREDENTIALS', 401],
28
29
  ['TOO_MANY_ATTEMPTS', 429],
@@ -1,5 +1,5 @@
1
1
  export type { Args, At, Change, Limits, Page, Pagination, Relay, } from './pages.ts';
2
2
  export { applied, connection, countedPage, pageArgs, pageOf, readsNoRow, rowOf, rowsOf, } from './pages.ts';
3
- export type { Node, Served } from './transport.ts';
4
- export { badInput, isNode, jsonSchemaOf, plural, readable, readableVirtuals, run, } from './transport.ts';
3
+ export type { Node, Served, ServedOneOf } from './transport.ts';
4
+ export { badInput, backOf, declared, isNode, jsonSchemaOf, oneOfsOf, plural, readable, readableOneOfs, readableVirtuals, run, } from './transport.ts';
5
5
  //# sourceMappingURL=internal.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAEA,YAAY,EACX,IAAI,EACJ,EAAE,EACF,MAAM,EACN,MAAM,EACN,IAAI,EACJ,UAAU,EACV,KAAK,GACL,MAAM,YAAY,CAAA;AACnB,OAAO,EACN,OAAO,EACP,UAAU,EACV,WAAW,EACX,QAAQ,EACR,MAAM,EACN,UAAU,EACV,KAAK,EACL,MAAM,GACN,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EACN,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,gBAAgB,EAChB,GAAG,GACH,MAAM,gBAAgB,CAAA"}
1
+ {"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAEA,YAAY,EACX,IAAI,EACJ,EAAE,EACF,MAAM,EACN,MAAM,EACN,IAAI,EACJ,UAAU,EACV,KAAK,GACL,MAAM,YAAY,CAAA;AACnB,OAAO,EACN,OAAO,EACP,UAAU,EACV,WAAW,EACX,QAAQ,EACR,MAAM,EACN,UAAU,EACV,KAAK,EACL,MAAM,GACN,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EACN,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,GAAG,GACH,MAAM,gBAAgB,CAAA"}
package/dist/internal.js CHANGED
@@ -1,2 +1,2 @@
1
1
  export { applied, connection, countedPage, pageArgs, pageOf, readsNoRow, rowOf, rowsOf, } from './pages.js';
2
- export { badInput, isNode, jsonSchemaOf, plural, readable, readableVirtuals, run, } from './transport.js';
2
+ export { badInput, backOf, declared, isNode, jsonSchemaOf, oneOfsOf, plural, readable, readableOneOfs, readableVirtuals, run, } from './transport.js';
@@ -20,6 +20,30 @@ export type Served = {
20
20
  };
21
21
  /** The fields a client reads: no `private` one, for Master too (D-44). */
22
22
  export declare const readable: (served: Served) => readonly SchemaField[];
23
+ type One = Extract<SchemaField, {
24
+ readonly kind: 'one';
25
+ }>;
26
+ /** A `oneOf` as transports serve it: each kind with its hidden `one`. */
27
+ export type ServedOneOf = {
28
+ readonly name: string;
29
+ readonly optional: boolean;
30
+ readonly kinds: readonly [Kind, ...Kind[]];
31
+ };
32
+ type Kind = {
33
+ readonly kind: string;
34
+ readonly field: One;
35
+ };
36
+ /** A model's `oneOf`s, gathered from their kinds' keys (D-247). */
37
+ export declare function oneOfsOf(model: SchemaModel): readonly ServedOneOf[];
38
+ /** The `oneOf`s a client reads, as `readable`. */
39
+ export declare const readableOneOfs: (served: Served) => readonly ServedOneOf[];
40
+ /** The field a developer declared: a hidden `one`'s `oneOf`, else itself. */
41
+ export declare const declared: (field: SchemaField) => string;
42
+ /**
43
+ * A relation's way back as declared: its target's `oneOf` when the inverse
44
+ * is a kind's key (D-247), `undefined` for a `one` without one (D-237).
45
+ */
46
+ export declare const backOf: (field: SchemaField, target: SchemaModel) => string | undefined;
23
47
  /** The virtual fields a client reads, as `readable` (D-151). */
24
48
  export declare const readableVirtuals: (served: Served) => readonly ExposedVirtual[];
25
49
  /** A JSON Schema, or one of its nodes. */
@@ -29,4 +53,5 @@ export type Node = {
29
53
  export declare const isNode: (value: unknown) => value is Node;
30
54
  /** A schema's JSON Schema, or startup stops naming `where` (D-45). */
31
55
  export declare function jsonSchemaOf(schema: object, side: 'input' | 'output', where: string): Node;
56
+ export {};
32
57
  //# sourceMappingURL=transport.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG1E,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,YAAa,MAAM,UAAU,OAAO,KAAG,KACN,CAAA;AAEtD;;;GAGG;AACH,wBAAsB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAYhE;AAED,oEAAoE;AACpE,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,+DAA+D;AAC/D,MAAM,MAAM,MAAM,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE;QACjB,QAAQ,CAAC,SAAS,EAAE;YAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;SAAE,CAAA;QACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;KAC5C,CAAA;CACD,CAAA;AAED,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,WAAY,MAAM,KAAG,SAAS,WAAW,EAG5D,CAAA;AAEF,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,WAAY,MAAM,KAAG,SAAS,cAAc,EAGvE,CAAA;AAEF,0CAA0C;AAC1C,MAAM,MAAM,IAAI,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAA;AAEtD,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,KAAK,IAAI,IACoB,CAAA;AAErE,sEAAsE;AACtE,wBAAgB,YAAY,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GAAG,QAAQ,EACxB,KAAK,EAAE,MAAM,GACX,IAAI,CAiBN"}
1
+ {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG1E,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,YAAa,MAAM,UAAU,OAAO,KAAG,KACN,CAAA;AAEtD;;;GAGG;AACH,wBAAsB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAYhE;AAED,oEAAoE;AACpE,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,+DAA+D;AAC/D,MAAM,MAAM,MAAM,GAAG;IACpB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE;QACjB,QAAQ,CAAC,SAAS,EAAE;YAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;SAAE,CAAA;QACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;KAC5C,CAAA;CACD,CAAA;AAED,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,WAAY,MAAM,KAAG,SAAS,WAAW,EAM5D,CAAA;AAEF,KAAK,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AAEzD,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;CAC1C,CAAA;AACD,KAAK,IAAI,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAA;CAAE,CAAA;AAE1D,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,WAAW,EAAE,CAWnE;AAED,kDAAkD;AAClD,eAAO,MAAM,cAAc,WAAY,MAAM,KAAG,SAAS,WAAW,EAGlE,CAAA;AAEF,6EAA6E;AAC7E,eAAO,MAAM,QAAQ,UAAW,WAAW,KAAG,MAC+B,CAAA;AAE7E;;;GAGG;AACH,eAAO,MAAM,MAAM,UACX,WAAW,UACV,WAAW,KACjB,MAAM,GAAG,SAKS,CAAA;AAErB,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,WAAY,MAAM,KAAG,SAAS,cAAc,EAGvE,CAAA;AAEF,0CAA0C;AAC1C,MAAM,MAAM,IAAI,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAA;AAEtD,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,KAAK,IAAI,IACoB,CAAA;AAErE,sEAAsE;AACtE,wBAAgB,YAAY,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GAAG,QAAQ,EACxB,KAAK,EAAE,MAAM,GACX,IAAI,CAiBN"}
package/dist/transport.js CHANGED
@@ -28,7 +28,38 @@ export function plural(name) {
28
28
  return `${name}s`;
29
29
  }
30
30
  /** The fields a client reads: no `private` one, for Master too (D-44). */
31
- export const readable = (served) => served.model.fields.filter((field) => served.exposed.readRules[field.name] !== 'private');
31
+ export const readable = (served) => served.model.fields.filter((field) => served.exposed.readRules[field.name] !== 'private' &&
32
+ // A `oneOf`'s kinds are read through it (D-247).
33
+ !(field.kind === 'one' && field.of !== undefined));
34
+ /** A model's `oneOf`s, gathered from their kinds' keys (D-247). */
35
+ export function oneOfsOf(model) {
36
+ const found = new Map();
37
+ for (const field of model.fields) {
38
+ if (field.kind !== 'one' || field.of === undefined)
39
+ continue;
40
+ const { field: name, kind, optional } = field.of;
41
+ const known = found.get(name);
42
+ if (known === undefined) {
43
+ found.set(name, { name, optional, kinds: [{ kind, field }] });
44
+ }
45
+ else
46
+ known.kinds.push({ kind, field });
47
+ }
48
+ return [...found.values()];
49
+ }
50
+ /** The `oneOf`s a client reads, as `readable`. */
51
+ export const readableOneOfs = (served) => oneOfsOf(served.model).filter(({ name }) => served.exposed.readRules[name] !== 'private');
52
+ /** The field a developer declared: a hidden `one`'s `oneOf`, else itself. */
53
+ export const declared = (field) => field.kind === 'one' && field.of !== undefined ? field.of.field : field.name;
54
+ /**
55
+ * A relation's way back as declared: its target's `oneOf` when the inverse
56
+ * is a kind's key (D-247), `undefined` for a `one` without one (D-237).
57
+ */
58
+ export const backOf = (field, target) => field.kind === 'scalar'
59
+ ? undefined
60
+ : target.fields
61
+ .filter(({ name }) => name === field.inverse)
62
+ .map(declared)[0];
32
63
  /** The virtual fields a client reads, as `readable` (D-151). */
33
64
  export const readableVirtuals = (served) => served.exposed.virtuals.filter((virtual) => served.exposed.readRules[virtual.name] !== 'private');
34
65
  export const isNode = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ultimabase/http",
3
- "version": "0.4.0-canary.20261104141426",
3
+ "version": "0.4.0",
4
4
  "description": "An HTTP server for UltimaBase: Hono routes that read the caller, CORS and a body limit.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
@@ -38,10 +38,10 @@
38
38
  "ipaddr.js": "2.5.0"
39
39
  },
40
40
  "peerDependencies": {
41
- "ultimabase": "0.4.0-canary.20261104141426"
41
+ "ultimabase": "^0.4.0"
42
42
  },
43
43
  "devDependencies": {
44
- "ultimabase": "0.4.0-canary.20261104141426",
44
+ "ultimabase": "0.4.0",
45
45
  "vite": "8.3.4",
46
46
  "vitest": "5.0.5"
47
47
  }
package/src/app.ts CHANGED
@@ -77,6 +77,7 @@ const statuses: ReadonlyMap<string, ContentfulStatusCode> = new Map<
77
77
  ['VALIDATION_FAILED', 400],
78
78
  ['UNIQUE_VIOLATION', 409],
79
79
  ['RELATION_RESTRICTED', 409],
80
+ ['RELATION_SIZE', 409],
80
81
  ['UNAUTHENTICATED', 401],
81
82
  ['INVALID_CREDENTIALS', 401],
82
83
  ['TOO_MANY_ATTEMPTS', 429],
package/src/internal.ts CHANGED
@@ -19,13 +19,17 @@ export {
19
19
  rowOf,
20
20
  rowsOf,
21
21
  } from './pages.ts'
22
- export type { Node, Served } from './transport.ts'
22
+ export type { Node, Served, ServedOneOf } from './transport.ts'
23
23
  export {
24
24
  badInput,
25
+ backOf,
26
+ declared,
25
27
  isNode,
26
28
  jsonSchemaOf,
29
+ oneOfsOf,
27
30
  plural,
28
31
  readable,
32
+ readableOneOfs,
29
33
  readableVirtuals,
30
34
  run,
31
35
  } from './transport.ts'
package/src/transport.ts CHANGED
@@ -44,9 +44,60 @@ export type Served = {
44
44
  /** The fields a client reads: no `private` one, for Master too (D-44). */
45
45
  export const readable = (served: Served): readonly SchemaField[] =>
46
46
  served.model.fields.filter(
47
- (field) => served.exposed.readRules[field.name] !== 'private',
47
+ (field) =>
48
+ served.exposed.readRules[field.name] !== 'private' &&
49
+ // A `oneOf`'s kinds are read through it (D-247).
50
+ !(field.kind === 'one' && field.of !== undefined),
48
51
  )
49
52
 
53
+ type One = Extract<SchemaField, { readonly kind: 'one' }>
54
+
55
+ /** A `oneOf` as transports serve it: each kind with its hidden `one`. */
56
+ export type ServedOneOf = {
57
+ readonly name: string
58
+ readonly optional: boolean
59
+ readonly kinds: readonly [Kind, ...Kind[]]
60
+ }
61
+ type Kind = { readonly kind: string; readonly field: One }
62
+
63
+ /** A model's `oneOf`s, gathered from their kinds' keys (D-247). */
64
+ export function oneOfsOf(model: SchemaModel): readonly ServedOneOf[] {
65
+ const found = new Map<string, ServedOneOf & { kinds: [Kind, ...Kind[]] }>()
66
+ for (const field of model.fields) {
67
+ if (field.kind !== 'one' || field.of === undefined) continue
68
+ const { field: name, kind, optional } = field.of
69
+ const known = found.get(name)
70
+ if (known === undefined) {
71
+ found.set(name, { name, optional, kinds: [{ kind, field }] })
72
+ } else known.kinds.push({ kind, field })
73
+ }
74
+ return [...found.values()]
75
+ }
76
+
77
+ /** The `oneOf`s a client reads, as `readable`. */
78
+ export const readableOneOfs = (served: Served): readonly ServedOneOf[] =>
79
+ oneOfsOf(served.model).filter(
80
+ ({ name }) => served.exposed.readRules[name] !== 'private',
81
+ )
82
+
83
+ /** The field a developer declared: a hidden `one`'s `oneOf`, else itself. */
84
+ export const declared = (field: SchemaField): string =>
85
+ field.kind === 'one' && field.of !== undefined ? field.of.field : field.name
86
+
87
+ /**
88
+ * A relation's way back as declared: its target's `oneOf` when the inverse
89
+ * is a kind's key (D-247), `undefined` for a `one` without one (D-237).
90
+ */
91
+ export const backOf = (
92
+ field: SchemaField,
93
+ target: SchemaModel,
94
+ ): string | undefined =>
95
+ field.kind === 'scalar'
96
+ ? undefined
97
+ : target.fields
98
+ .filter(({ name }) => name === field.inverse)
99
+ .map(declared)[0]
100
+
50
101
  /** The virtual fields a client reads, as `readable` (D-151). */
51
102
  export const readableVirtuals = (served: Served): readonly ExposedVirtual[] =>
52
103
  served.exposed.virtuals.filter(