@dsqlbase/core 0.2.1 → 0.3.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 +27 -0
- package/dist/definition/base.d.ts +3 -30
- package/dist/definition/base.d.ts.map +1 -1
- package/dist/definition/base.js +3 -14
- package/dist/definition/base.js.map +1 -1
- package/dist/definition/column.d.ts +22 -14
- package/dist/definition/column.d.ts.map +1 -1
- package/dist/definition/column.js +11 -37
- package/dist/definition/column.js.map +1 -1
- package/dist/definition/constraint.d.ts +9 -9
- package/dist/definition/constraint.d.ts.map +1 -1
- package/dist/definition/constraint.js.map +1 -1
- package/dist/definition/domain.d.ts +2 -1
- package/dist/definition/domain.d.ts.map +1 -1
- package/dist/definition/domain.js +2 -1
- package/dist/definition/domain.js.map +1 -1
- package/dist/definition/index.d.ts +5 -6
- package/dist/definition/index.d.ts.map +1 -1
- package/dist/definition/index.js +3 -4
- package/dist/definition/index.js.map +1 -1
- package/dist/definition/indexes.d.ts +9 -20
- package/dist/definition/indexes.d.ts.map +1 -1
- package/dist/definition/indexes.js +3 -6
- package/dist/definition/indexes.js.map +1 -1
- package/dist/definition/namespace.d.ts +2 -2
- package/dist/definition/namespace.d.ts.map +1 -1
- package/dist/definition/namespace.js.map +1 -1
- package/dist/definition/policy.d.ts +35 -0
- package/dist/definition/policy.d.ts.map +1 -0
- package/dist/definition/policy.js +42 -0
- package/dist/definition/policy.js.map +1 -0
- package/dist/definition/relations.d.ts +28 -33
- package/dist/definition/relations.d.ts.map +1 -1
- package/dist/definition/relations.js +1 -4
- package/dist/definition/relations.js.map +1 -1
- package/dist/definition/table.d.ts +39 -32
- package/dist/definition/table.d.ts.map +1 -1
- package/dist/definition/table.js +57 -67
- package/dist/definition/table.js.map +1 -1
- package/dist/definition/union.d.ts +18 -61
- package/dist/definition/union.d.ts.map +1 -1
- package/dist/definition/union.js +8 -69
- package/dist/definition/union.js.map +1 -1
- package/dist/index.d.ts +5 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -3
- package/dist/index.js.map +1 -1
- package/dist/resolvers/codec.d.ts +16 -0
- package/dist/resolvers/codec.d.ts.map +1 -0
- package/dist/resolvers/codec.js +9 -0
- package/dist/resolvers/codec.js.map +1 -0
- package/dist/resolvers/hooks.d.ts +39 -0
- package/dist/resolvers/hooks.d.ts.map +1 -0
- package/dist/resolvers/hooks.js +2 -0
- package/dist/resolvers/hooks.js.map +1 -0
- package/dist/resolvers/index.d.ts +5 -0
- package/dist/resolvers/index.d.ts.map +1 -0
- package/dist/resolvers/index.js +2 -0
- package/dist/resolvers/index.js.map +1 -0
- package/dist/resolvers/policy.d.ts +31 -0
- package/dist/resolvers/policy.d.ts.map +1 -0
- package/dist/resolvers/policy.js +2 -0
- package/dist/resolvers/policy.js.map +1 -0
- package/dist/resolvers/validator.d.ts +14 -0
- package/dist/resolvers/validator.d.ts.map +1 -0
- package/dist/resolvers/validator.js +2 -0
- package/dist/resolvers/validator.js.map +1 -0
- package/dist/runtime/base.d.ts +7 -4
- package/dist/runtime/base.d.ts.map +1 -1
- package/dist/runtime/base.js.map +1 -1
- package/dist/runtime/build.d.ts +22 -0
- package/dist/runtime/build.d.ts.map +1 -0
- package/dist/runtime/build.js +184 -0
- package/dist/runtime/build.js.map +1 -0
- package/dist/runtime/column.d.ts +40 -23
- package/dist/runtime/column.d.ts.map +1 -1
- package/dist/runtime/column.js +120 -28
- package/dist/runtime/column.js.map +1 -1
- package/dist/runtime/context.d.ts +17 -26
- package/dist/runtime/context.d.ts.map +1 -1
- package/dist/runtime/context.js +4 -6
- package/dist/runtime/context.js.map +1 -1
- package/dist/runtime/errors.d.ts +31 -9
- package/dist/runtime/errors.d.ts.map +1 -1
- package/dist/runtime/errors.js +54 -11
- package/dist/runtime/errors.js.map +1 -1
- package/dist/runtime/executor.d.ts.map +1 -1
- package/dist/runtime/executor.js +10 -1
- package/dist/runtime/executor.js.map +1 -1
- package/dist/runtime/index.d.ts +10 -6
- package/dist/runtime/index.d.ts.map +1 -1
- package/dist/runtime/index.js +5 -3
- package/dist/runtime/index.js.map +1 -1
- package/dist/runtime/operation.d.ts +62 -83
- package/dist/runtime/operation.d.ts.map +1 -1
- package/dist/runtime/operation.js +194 -260
- package/dist/runtime/operation.js.map +1 -1
- package/dist/runtime/policy.d.ts +35 -0
- package/dist/runtime/policy.d.ts.map +1 -0
- package/dist/runtime/policy.js +72 -0
- package/dist/runtime/policy.js.map +1 -0
- package/dist/runtime/reference.d.ts +87 -0
- package/dist/runtime/reference.d.ts.map +1 -0
- package/dist/runtime/reference.js +68 -0
- package/dist/runtime/reference.js.map +1 -0
- package/dist/runtime/registry.d.ts +26 -95
- package/dist/runtime/registry.d.ts.map +1 -1
- package/dist/runtime/registry.js +29 -408
- package/dist/runtime/registry.js.map +1 -1
- package/dist/runtime/relation.d.ts +45 -0
- package/dist/runtime/relation.d.ts.map +1 -0
- package/dist/runtime/relation.js +2 -0
- package/dist/runtime/relation.js.map +1 -0
- package/dist/runtime/table.d.ts +31 -35
- package/dist/runtime/table.d.ts.map +1 -1
- package/dist/runtime/table.js +78 -47
- package/dist/runtime/table.js.map +1 -1
- package/dist/runtime/union.d.ts +11 -4
- package/dist/runtime/union.d.ts.map +1 -1
- package/dist/runtime/union.js +18 -7
- package/dist/runtime/union.js.map +1 -1
- package/dist/sql/index.d.ts +2 -2
- package/dist/sql/index.d.ts.map +1 -1
- package/dist/sql/index.js +1 -1
- package/dist/sql/index.js.map +1 -1
- package/dist/sql/nodes.d.ts +22 -0
- package/dist/sql/nodes.d.ts.map +1 -1
- package/dist/sql/nodes.js +21 -0
- package/dist/sql/nodes.js.map +1 -1
- package/dist/sql/tag.d.ts +3 -15
- package/dist/sql/tag.d.ts.map +1 -1
- package/dist/sql/tag.js +5 -71
- package/dist/sql/tag.js.map +1 -1
- package/dist/utils/index.d.ts +1 -1
- package/dist/utils/index.d.ts.map +1 -1
- package/dist/utils/index.js.map +1 -1
- package/dist/utils/types.d.ts +2 -14
- package/dist/utils/types.d.ts.map +1 -1
- package/dist/utils/types.js.map +1 -1
- package/dist/validation/index.d.ts +2 -0
- package/dist/validation/index.d.ts.map +1 -0
- package/dist/validation/index.js +2 -0
- package/dist/validation/index.js.map +1 -0
- package/dist/validation/references.d.ts +23 -0
- package/dist/validation/references.d.ts.map +1 -0
- package/dist/validation/references.js +240 -0
- package/dist/validation/references.js.map +1 -0
- package/dist/validation/validate.d.ts +40 -0
- package/dist/validation/validate.d.ts.map +1 -0
- package/dist/validation/validate.js +354 -0
- package/dist/validation/validate.js.map +1 -0
- package/package.json +13 -4
- package/dist/definition/embedded.d.ts +0 -131
- package/dist/definition/embedded.d.ts.map +0 -1
- package/dist/definition/embedded.js +0 -133
- package/dist/definition/embedded.js.map +0 -1
- package/dist/definition/tenant.d.ts +0 -50
- package/dist/definition/tenant.d.ts.map +0 -1
- package/dist/definition/tenant.js +0 -73
- package/dist/definition/tenant.js.map +0 -1
- package/dist/runtime/group.d.ts +0 -54
- package/dist/runtime/group.d.ts.map +0 -1
- package/dist/runtime/group.js +0 -96
- package/dist/runtime/group.js.map +0 -1
|
@@ -1,133 +0,0 @@
|
|
|
1
|
-
import { DefinitionNode, Kind, NodeRef, RESERVED_FIELD_NAMES } from "./base.js";
|
|
2
|
-
import { ColumnDefinition } from "./column.js";
|
|
3
|
-
/**
|
|
4
|
-
* A reusable set of columns — a value object such as `Money` or `Address` — that a table embeds
|
|
5
|
-
* as real columns through {@link EmbeddedObjectDefinition.column}.
|
|
6
|
-
*
|
|
7
|
-
* The object itself is never placed in a table and produces no DDL. Its members are templates:
|
|
8
|
-
* each `.column()` copies them under a prefixed name, so one object placed twice, on one table
|
|
9
|
-
* or several, never shares a definition.
|
|
10
|
-
*/
|
|
11
|
-
export class EmbeddedObjectDefinition extends DefinitionNode {
|
|
12
|
-
kind = Kind.EMBEDDED_OBJECT;
|
|
13
|
-
columns;
|
|
14
|
-
constructor(columns) {
|
|
15
|
-
super("embedded");
|
|
16
|
-
for (const [field, member] of Object.entries(columns)) {
|
|
17
|
-
if (RESERVED_FIELD_NAMES.includes(field)) {
|
|
18
|
-
throw new Error(`An embedded object declares a member named "${field}", which is reserved. ` +
|
|
19
|
-
`The runtime writes ${RESERVED_FIELD_NAMES.join(" and ")} onto every result row.`);
|
|
20
|
-
}
|
|
21
|
-
if (member instanceof ColumnGroupDefinition) {
|
|
22
|
-
continue;
|
|
23
|
-
}
|
|
24
|
-
if (!(member instanceof ColumnDefinition)) {
|
|
25
|
-
throw new Error(`Embedded object member "${field}" is neither a column nor a group.`);
|
|
26
|
-
}
|
|
27
|
-
if (member["_primaryKey"]) {
|
|
28
|
-
throw new Error(`Embedded object member "${field}" is a primary key. A key belongs to the table, ` +
|
|
29
|
-
`not to an object that may be embedded several times.`);
|
|
30
|
-
}
|
|
31
|
-
if (member["_tenantKey"]) {
|
|
32
|
-
throw new Error(`Embedded object member "${field}" is a tenant claim. A claim column belongs to the ` +
|
|
33
|
-
`table's tenant scope, not to an embedded object.`);
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
this.columns = Object.freeze({ ...columns });
|
|
37
|
-
}
|
|
38
|
-
/**
|
|
39
|
-
* Embeds this object in a table as the group `name`: one real column per member, named
|
|
40
|
-
* `<name>_<member>` — `money.column("net_value")` gives `net_value_amount` and
|
|
41
|
-
* `net_value_currency`. A nested group chains the prefix: `billing_geo_lat`.
|
|
42
|
-
*/
|
|
43
|
-
column(name) {
|
|
44
|
-
return new ColumnGroupDefinition(name, this);
|
|
45
|
-
}
|
|
46
|
-
}
|
|
47
|
-
/**
|
|
48
|
-
* An embedded object placed in a table: its own copies of the object's members, named with the
|
|
49
|
-
* group's prefix. A table's `columns` may hold one wherever it holds a column.
|
|
50
|
-
*
|
|
51
|
-
* A group has no nullability of its own. Each member keeps its own `.notNull()` as its column's
|
|
52
|
-
* `NOT NULL`; a group whose members are all nullable can be absent, which it is when all of
|
|
53
|
-
* them are `NULL`.
|
|
54
|
-
*/
|
|
55
|
-
export class ColumnGroupDefinition extends DefinitionNode {
|
|
56
|
-
kind = Kind.COLUMN_GROUP;
|
|
57
|
-
object;
|
|
58
|
-
columns;
|
|
59
|
-
_default;
|
|
60
|
-
constructor(name, object) {
|
|
61
|
-
super(name);
|
|
62
|
-
this.object = object;
|
|
63
|
-
const columns = {};
|
|
64
|
-
for (const [field, member] of Object.entries(object.columns)) {
|
|
65
|
-
columns[field] =
|
|
66
|
-
member instanceof ColumnGroupDefinition
|
|
67
|
-
? member._renamed(`${name}_${member.name}`)
|
|
68
|
-
: member._renamed(`${name}_${member.name}`, name);
|
|
69
|
-
}
|
|
70
|
-
this.columns = Object.freeze(columns);
|
|
71
|
-
}
|
|
72
|
-
/**
|
|
73
|
-
* Defaults for the group's members — `address.column("billing").default({ city: "-" })` is
|
|
74
|
-
* `.default("-")` on `billing_city`. Members not named keep their own default, if any.
|
|
75
|
-
*/
|
|
76
|
-
default(value) {
|
|
77
|
-
for (const [field, memberValue] of Object.entries(value)) {
|
|
78
|
-
const member = this.columns[field];
|
|
79
|
-
if (!member) {
|
|
80
|
-
throw new Error(`Group "${this.name}" has no member "${field}" to default.`);
|
|
81
|
-
}
|
|
82
|
-
if (memberValue === undefined) {
|
|
83
|
-
continue;
|
|
84
|
-
}
|
|
85
|
-
if (member instanceof ColumnGroupDefinition) {
|
|
86
|
-
member.default(memberValue);
|
|
87
|
-
}
|
|
88
|
-
else {
|
|
89
|
-
member.default(memberValue);
|
|
90
|
-
}
|
|
91
|
-
}
|
|
92
|
-
this._default = { ...this._default, ...value };
|
|
93
|
-
return this;
|
|
94
|
-
}
|
|
95
|
-
/**
|
|
96
|
-
* A copy of this group under another name, defaults included — a group nested in an
|
|
97
|
-
* embedded object, placed in a table under its parent's prefix.
|
|
98
|
-
*
|
|
99
|
-
* @internal
|
|
100
|
-
*/
|
|
101
|
-
_renamed(name) {
|
|
102
|
-
const copy = new ColumnGroupDefinition(name, this.object);
|
|
103
|
-
if (this._default) {
|
|
104
|
-
copy.default(this._default);
|
|
105
|
-
}
|
|
106
|
-
return copy;
|
|
107
|
-
}
|
|
108
|
-
/** @internal */
|
|
109
|
-
_getColumnRefs() {
|
|
110
|
-
return Object.fromEntries(Object.entries(this.columns).map(([field, member]) => [
|
|
111
|
-
field,
|
|
112
|
-
member instanceof ColumnGroupDefinition ? member._getColumnRefs() : new NodeRef(member),
|
|
113
|
-
]));
|
|
114
|
-
}
|
|
115
|
-
toJSON() {
|
|
116
|
-
return {
|
|
117
|
-
kind: this.kind,
|
|
118
|
-
name: this.name,
|
|
119
|
-
columns: columnEntries(this.columns).map(([, column]) => column.toJSON()),
|
|
120
|
-
};
|
|
121
|
-
}
|
|
122
|
-
}
|
|
123
|
-
/**
|
|
124
|
-
* Every real column under `columns`, groups walked depth first, each with its field path —
|
|
125
|
-
* `["netValue", "amount"]`. What reaches the database: DDL, the duplicate-name check, tenant
|
|
126
|
-
* claims.
|
|
127
|
-
*/
|
|
128
|
-
export function columnEntries(columns, path = []) {
|
|
129
|
-
return Object.entries(columns).flatMap(([field, member]) => member instanceof ColumnGroupDefinition
|
|
130
|
-
? columnEntries(member.columns, [...path, field])
|
|
131
|
-
: [[[...path, field], member]]);
|
|
132
|
-
}
|
|
133
|
-
//# sourceMappingURL=embedded.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"embedded.js","sourceRoot":"","sources":["../../src/definition/embedded.ts"],"names":[],"mappings":"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","sourcesContent":["import { HasDefault } from \"../utils/index.js\";\nimport { DefinitionNode, Kind, NodeRef, RESERVED_FIELD_NAMES } from \"./base.js\";\nimport { AnyColumnDefinition, ColumnDefinition } from \"./column.js\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyColumnGroupDefinition = ColumnGroupDefinition<string, any, any>;\n\n/**\n * Matches a column group by its `kind` rather than by class: comparing a column against the\n * class structurally is costly enough, across a schema's tables, to exhaust the checker.\n */\nexport type GroupOf<TColumns extends TableColumnDefinitions> = {\n readonly kind: \"COLUMN_GROUP\";\n readonly columns: Readonly<TColumns>;\n};\n\n/** What a table's `columns` — and an embedded object's — hold: a column, or a group of them. */\nexport type AnyTableColumnDefinition = AnyColumnDefinition | AnyColumnGroupDefinition;\n\nexport type TableColumnDefinitions = Record<string, AnyTableColumnDefinition>;\n\n/**\n * Column refs for a table's — or a group's — columns, as the `check`, `unique`, `primaryKey`\n * and `index` callbacks receive them: a column is a ref, a group the refs of its own columns,\n * so a member reads `c.netValue.amount`.\n */\nexport type ColumnRefs<TColumns extends TableColumnDefinitions> = {\n readonly [K in keyof TColumns]: TColumns[K] extends GroupOf<infer TGroupColumns>\n ? ColumnRefs<TGroupColumns>\n : NodeRef<TColumns[K]>;\n};\n\n/** Any one column ref in {@link ColumnRefs}, however deep. */\nexport type ColumnRefOf<TColumns extends TableColumnDefinitions> = {\n [K in keyof TColumns]: TColumns[K] extends GroupOf<infer TGroupColumns>\n ? ColumnRefOf<TGroupColumns>\n : NodeRef<TColumns[K]>;\n}[keyof TColumns];\n\ntype MemberDefaultOf<TMember> =\n TMember extends GroupOf<infer TColumns>\n ? GroupDefaultOf<TColumns>\n : TMember extends { __type: { inputType: infer TInput } }\n ? TInput\n : never;\n\n/** What `.default()` on a group takes: a value for any of its members, nested groups included. */\nexport type GroupDefaultOf<TColumns extends TableColumnDefinitions> = {\n [K in keyof TColumns]?: MemberDefaultOf<TColumns[K]>;\n};\n\nexport type ColumnGroupConfig<\n TColumns extends TableColumnDefinitions,\n THasDefault extends boolean,\n> = {\n columns: TColumns;\n hasDefault: THasDefault;\n};\n\n/**\n * A reusable set of columns — a value object such as `Money` or `Address` — that a table embeds\n * as real columns through {@link EmbeddedObjectDefinition.column}.\n *\n * The object itself is never placed in a table and produces no DDL. Its members are templates:\n * each `.column()` copies them under a prefixed name, so one object placed twice, on one table\n * or several, never shares a definition.\n */\nexport class EmbeddedObjectDefinition<\n TColumns extends TableColumnDefinitions,\n> extends DefinitionNode<\"embedded\", { columns: TColumns }> {\n readonly kind = Kind.EMBEDDED_OBJECT;\n\n readonly columns: Readonly<TColumns>;\n\n constructor(columns: TColumns) {\n super(\"embedded\");\n\n for (const [field, member] of Object.entries(columns)) {\n if (RESERVED_FIELD_NAMES.includes(field)) {\n throw new Error(\n `An embedded object declares a member named \"${field}\", which is reserved. ` +\n `The runtime writes ${RESERVED_FIELD_NAMES.join(\" and \")} onto every result row.`\n );\n }\n\n if (member instanceof ColumnGroupDefinition) {\n continue;\n }\n\n if (!(member instanceof ColumnDefinition)) {\n throw new Error(`Embedded object member \"${field}\" is neither a column nor a group.`);\n }\n\n if (member[\"_primaryKey\"]) {\n throw new Error(\n `Embedded object member \"${field}\" is a primary key. A key belongs to the table, ` +\n `not to an object that may be embedded several times.`\n );\n }\n\n if (member[\"_tenantKey\"]) {\n throw new Error(\n `Embedded object member \"${field}\" is a tenant claim. A claim column belongs to the ` +\n `table's tenant scope, not to an embedded object.`\n );\n }\n }\n\n this.columns = Object.freeze({ ...columns });\n }\n\n /**\n * Embeds this object in a table as the group `name`: one real column per member, named\n * `<name>_<member>` — `money.column(\"net_value\")` gives `net_value_amount` and\n * `net_value_currency`. A nested group chains the prefix: `billing_geo_lat`.\n */\n public column<TName extends string>(name: TName): ColumnGroupDefinition<TName, TColumns, false> {\n return new ColumnGroupDefinition(name, this);\n }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyEmbeddedObjectDefinition = EmbeddedObjectDefinition<any>;\n\n/**\n * An embedded object placed in a table: its own copies of the object's members, named with the\n * group's prefix. A table's `columns` may hold one wherever it holds a column.\n *\n * A group has no nullability of its own. Each member keeps its own `.notNull()` as its column's\n * `NOT NULL`; a group whose members are all nullable can be absent, which it is when all of\n * them are `NULL`.\n */\nexport class ColumnGroupDefinition<\n TName extends string,\n TColumns extends TableColumnDefinitions,\n THasDefault extends boolean = false,\n> extends DefinitionNode<TName, ColumnGroupConfig<TColumns, THasDefault>> {\n readonly kind = Kind.COLUMN_GROUP;\n\n readonly object: EmbeddedObjectDefinition<TColumns>;\n readonly columns: Readonly<TColumns>;\n\n protected _default?: GroupDefaultOf<TColumns>;\n\n constructor(name: TName, object: EmbeddedObjectDefinition<TColumns>) {\n super(name);\n\n this.object = object;\n\n const columns: Record<string, AnyTableColumnDefinition> = {};\n\n for (const [field, member] of Object.entries<AnyTableColumnDefinition>(object.columns)) {\n columns[field] =\n member instanceof ColumnGroupDefinition\n ? member._renamed(`${name}_${member.name}`)\n : member._renamed(`${name}_${member.name}`, name);\n }\n\n this.columns = Object.freeze(columns) as Readonly<TColumns>;\n }\n\n /**\n * Defaults for the group's members — `address.column(\"billing\").default({ city: \"-\" })` is\n * `.default(\"-\")` on `billing_city`. Members not named keep their own default, if any.\n */\n public default(\n value: GroupDefaultOf<TColumns>\n ): HasDefault<ColumnGroupDefinition<TName, TColumns, true>> {\n for (const [field, memberValue] of Object.entries(value)) {\n const member = (this.columns as TableColumnDefinitions)[field];\n\n if (!member) {\n throw new Error(`Group \"${this.name}\" has no member \"${field}\" to default.`);\n }\n\n if (memberValue === undefined) {\n continue;\n }\n\n if (member instanceof ColumnGroupDefinition) {\n member.default(memberValue as GroupDefaultOf<TableColumnDefinitions>);\n } else {\n member.default(memberValue);\n }\n }\n\n this._default = { ...this._default, ...value };\n\n return this as unknown as HasDefault<ColumnGroupDefinition<TName, TColumns, true>>;\n }\n\n /**\n * A copy of this group under another name, defaults included — a group nested in an\n * embedded object, placed in a table under its parent's prefix.\n *\n * @internal\n */\n public _renamed(name: string): this {\n const copy = new ColumnGroupDefinition(name, this.object);\n\n if (this._default) {\n copy.default(this._default);\n }\n\n return copy as unknown as this;\n }\n\n /** @internal */\n _getColumnRefs(): ColumnRefs<TColumns> {\n return Object.fromEntries(\n Object.entries<AnyTableColumnDefinition>(this.columns).map(([field, member]) => [\n field,\n member instanceof ColumnGroupDefinition ? member._getColumnRefs() : new NodeRef(member),\n ])\n ) as ColumnRefs<TColumns>;\n }\n\n public toJSON() {\n return {\n kind: this.kind,\n name: this.name,\n columns: columnEntries(this.columns).map(([, column]) => column.toJSON()),\n };\n }\n}\n\n/**\n * Every real column under `columns`, groups walked depth first, each with its field path —\n * `[\"netValue\", \"amount\"]`. What reaches the database: DDL, the duplicate-name check, tenant\n * claims.\n */\nexport function columnEntries(\n columns: Readonly<TableColumnDefinitions>,\n path: string[] = []\n): [path: string[], column: AnyColumnDefinition][] {\n return Object.entries(columns).flatMap(([field, member]) =>\n member instanceof ColumnGroupDefinition\n ? columnEntries(member.columns, [...path, field])\n : [[[...path, field], member as AnyColumnDefinition]]\n );\n}\n"]}
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
import { Prettify, ReadOnly, TenantKey } from "../utils/index.js";
|
|
2
|
-
import { DefinitionNode } from "./base.js";
|
|
3
|
-
import { TableColumnDefinitions } from "./embedded.js";
|
|
4
|
-
import { AnyColumnDefinition } from "./column.js";
|
|
5
|
-
import { AnyNamespaceDefinition } from "./namespace.js";
|
|
6
|
-
import { TableDefinition } from "./table.js";
|
|
7
|
-
export type AnyTenantScopeDefinition = TenantScopeDefinition<any>;
|
|
8
|
-
/** The claim columns as a table receives them: system-managed and marked as claim keys. */
|
|
9
|
-
export type TenantClaimColumns<TClaims extends Record<string, AnyColumnDefinition>> = {
|
|
10
|
-
[K in keyof TClaims]: TenantKey<ReadOnly<TClaims[K]>>;
|
|
11
|
-
};
|
|
12
|
-
/** A table's own columns with the scope's claim columns merged in front of them. */
|
|
13
|
-
export type WithClaims<TClaims extends Record<string, AnyColumnDefinition>, TColumns extends TableColumnDefinitions> = Prettify<TenantClaimColumns<TClaims> & TColumns>;
|
|
14
|
-
export type TenantScopeConfig<TClaims extends Record<string, AnyColumnDefinition>> = {
|
|
15
|
-
claims: TClaims;
|
|
16
|
-
};
|
|
17
|
-
/**
|
|
18
|
-
* A named set of claim columns shared by every table in one tenant boundary.
|
|
19
|
-
*
|
|
20
|
-
* The scope is the only producer of the `tenantKey` marker: a column carries it by being
|
|
21
|
-
* declared here, never by a builder of its own. That is deliberate — a per-column marker would
|
|
22
|
-
* leave no single place that says "these are the claims", which is what
|
|
23
|
-
* `ExecutionContext.identity` has to be matched against.
|
|
24
|
-
*
|
|
25
|
-
* It is a definition node so it may be exported from a schema module beside the tables that use
|
|
26
|
-
* it; the registry keeps only tables and relations, and it is not a schema object, so no
|
|
27
|
-
* migration ever sees it.
|
|
28
|
-
*/
|
|
29
|
-
export declare class TenantScopeDefinition<TClaims extends Record<string, AnyColumnDefinition>> extends DefinitionNode<string, TenantScopeConfig<TClaims>> {
|
|
30
|
-
readonly kind: "TENANT_SCOPE";
|
|
31
|
-
private readonly _claims;
|
|
32
|
-
constructor(claims: TClaims, name?: string);
|
|
33
|
-
/** The claim field names, in declaration order. */
|
|
34
|
-
get claims(): (keyof TClaims & string)[];
|
|
35
|
-
/**
|
|
36
|
-
* A fresh copy of every claim column, marked as a claim key and system-managed.
|
|
37
|
-
*
|
|
38
|
-
* Fresh on every call: the builders mutate a `ColumnDefinition` in place, so handing the same
|
|
39
|
-
* instance to two tables would let a later change on one reach the other.
|
|
40
|
-
*/
|
|
41
|
-
columns(): TenantClaimColumns<TClaims>;
|
|
42
|
-
/**
|
|
43
|
-
* A table inside this scope: sugar for spreading {@link columns} into `table(name, { … })`.
|
|
44
|
-
*
|
|
45
|
-
* Use the spread form directly when the table needs a different constructor — a namespaced
|
|
46
|
-
* table is built by `namespace().table()`, which this cannot stand in for.
|
|
47
|
-
*/
|
|
48
|
-
table<TName extends string, TColumns extends TableColumnDefinitions>(name: TName, columns: TColumns): TableDefinition<TName, WithClaims<TClaims, TColumns>, AnyNamespaceDefinition>;
|
|
49
|
-
}
|
|
50
|
-
//# sourceMappingURL=tenant.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../../src/definition/tenant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAQ,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM7C,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;AAElE,2FAA2F;AAC3F,MAAM,MAAM,kBAAkB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,IAAI;KACnF,CAAC,IAAI,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACtD,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,UAAU,CACpB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACnD,QAAQ,SAAS,sBAAsB,IACrC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AAErD,MAAM,MAAM,iBAAiB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,IAAI;IACnF,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAqB,CAChC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CACnD,SAAQ,cAAc,CAAC,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,IAAI,iBAAqB;IAElC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,MAAM,EAAE,OAAO,EAAE,IAAI,GAAE,MAA2B;IAqB9D,mDAAmD;IACnD,IAAW,MAAM,IAAI,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAE9C;IAED;;;;;OAKG;IACI,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC;IAe7C;;;;;OAKG;IACI,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,SAAS,sBAAsB,EACxE,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,QAAQ,GAChB,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CAgBjF"}
|
|
@@ -1,73 +0,0 @@
|
|
|
1
|
-
import { DefinitionNode, Kind } from "./base.js";
|
|
2
|
-
import { TableDefinition } from "./table.js";
|
|
3
|
-
/** The name a scope carries when none is given. It names nothing in the database. */
|
|
4
|
-
const DEFAULT_SCOPE_NAME = "tenant_scope";
|
|
5
|
-
/**
|
|
6
|
-
* A named set of claim columns shared by every table in one tenant boundary.
|
|
7
|
-
*
|
|
8
|
-
* The scope is the only producer of the `tenantKey` marker: a column carries it by being
|
|
9
|
-
* declared here, never by a builder of its own. That is deliberate — a per-column marker would
|
|
10
|
-
* leave no single place that says "these are the claims", which is what
|
|
11
|
-
* `ExecutionContext.identity` has to be matched against.
|
|
12
|
-
*
|
|
13
|
-
* It is a definition node so it may be exported from a schema module beside the tables that use
|
|
14
|
-
* it; the registry keeps only tables and relations, and it is not a schema object, so no
|
|
15
|
-
* migration ever sees it.
|
|
16
|
-
*/
|
|
17
|
-
export class TenantScopeDefinition extends DefinitionNode {
|
|
18
|
-
kind = Kind.TENANT_SCOPE;
|
|
19
|
-
_claims;
|
|
20
|
-
constructor(claims, name = DEFAULT_SCOPE_NAME) {
|
|
21
|
-
super(name);
|
|
22
|
-
const fields = Object.keys(claims);
|
|
23
|
-
if (fields.length === 0) {
|
|
24
|
-
throw new Error(`Tenant scope "${name}" declares no claim columns.`);
|
|
25
|
-
}
|
|
26
|
-
for (const field of fields) {
|
|
27
|
-
if (!claims[field]["_notNull"]) {
|
|
28
|
-
throw new Error(`Claim "${field}" on tenant scope "${name}" must be notNull. ` +
|
|
29
|
-
`A claim column is filled by the runtime on every insert, so it is never null.`);
|
|
30
|
-
}
|
|
31
|
-
}
|
|
32
|
-
this._claims = claims;
|
|
33
|
-
}
|
|
34
|
-
/** The claim field names, in declaration order. */
|
|
35
|
-
get claims() {
|
|
36
|
-
return Object.keys(this._claims);
|
|
37
|
-
}
|
|
38
|
-
/**
|
|
39
|
-
* A fresh copy of every claim column, marked as a claim key and system-managed.
|
|
40
|
-
*
|
|
41
|
-
* Fresh on every call: the builders mutate a `ColumnDefinition` in place, so handing the same
|
|
42
|
-
* instance to two tables would let a later change on one reach the other.
|
|
43
|
-
*/
|
|
44
|
-
columns() {
|
|
45
|
-
const columns = {};
|
|
46
|
-
for (const [field, claim] of Object.entries(this._claims)) {
|
|
47
|
-
const column = claim.clone();
|
|
48
|
-
column["_tenantKey"] = true;
|
|
49
|
-
column["_readOnly"] = true;
|
|
50
|
-
columns[field] = column;
|
|
51
|
-
}
|
|
52
|
-
return columns;
|
|
53
|
-
}
|
|
54
|
-
/**
|
|
55
|
-
* A table inside this scope: sugar for spreading {@link columns} into `table(name, { … })`.
|
|
56
|
-
*
|
|
57
|
-
* Use the spread form directly when the table needs a different constructor — a namespaced
|
|
58
|
-
* table is built by `namespace().table()`, which this cannot stand in for.
|
|
59
|
-
*/
|
|
60
|
-
table(name, columns) {
|
|
61
|
-
const claims = this.columns();
|
|
62
|
-
for (const field of Object.keys(columns)) {
|
|
63
|
-
if (Object.hasOwn(claims, field)) {
|
|
64
|
-
throw new Error(`Table "${name}" redeclares claim "${field}" from tenant scope "${this.name}". ` +
|
|
65
|
-
`A claim column is declared once, on the scope.`);
|
|
66
|
-
}
|
|
67
|
-
}
|
|
68
|
-
return new TableDefinition(name, {
|
|
69
|
-
columns: { ...claims, ...columns },
|
|
70
|
-
});
|
|
71
|
-
}
|
|
72
|
-
}
|
|
73
|
-
//# sourceMappingURL=tenant.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"tenant.js","sourceRoot":"","sources":["../../src/definition/tenant.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,qFAAqF;AACrF,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAoB1C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,qBAEX,SAAQ,cAAkD;IACjD,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;IAEjB,OAAO,CAAU;IAElC,YAAY,MAAe,EAAE,OAAe,kBAAkB;QAC5D,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,8BAA8B,CAAC,CAAC;QACvE,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,UAAU,KAAK,sBAAsB,IAAI,qBAAqB;oBAC5D,+EAA+E,CAClF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,mDAAmD;IACnD,IAAW,MAAM;QACf,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAA+B,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACI,OAAO;QACZ,MAAM,OAAO,GAAG,EAAyC,CAAC;QAE1D,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAsB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/E,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAE7B,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;YAC5B,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;YAE3B,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;QAC1B,CAAC;QAED,OAAO,OAAsC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACI,KAAK,CACV,IAAW,EACX,OAAiB;QAEjB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAyC,CAAC;QAErE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,uBAAuB,KAAK,wBAAwB,IAAI,CAAC,IAAI,KAAK;oBAC9E,gDAAgD,CACnD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,eAAe,CAAC,IAAI,EAAE;YAC/B,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,EAAmC;SACpE,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { Prettify, ReadOnly, TenantKey } from \"../utils/index.js\";\nimport { DefinitionNode, Kind } from \"./base.js\";\nimport { TableColumnDefinitions } from \"./embedded.js\";\nimport { AnyColumnDefinition } from \"./column.js\";\nimport { AnyNamespaceDefinition } from \"./namespace.js\";\nimport { TableDefinition } from \"./table.js\";\n\n/** The name a scope carries when none is given. It names nothing in the database. */\nconst DEFAULT_SCOPE_NAME = \"tenant_scope\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyTenantScopeDefinition = TenantScopeDefinition<any>;\n\n/** The claim columns as a table receives them: system-managed and marked as claim keys. */\nexport type TenantClaimColumns<TClaims extends Record<string, AnyColumnDefinition>> = {\n [K in keyof TClaims]: TenantKey<ReadOnly<TClaims[K]>>;\n};\n\n/** A table's own columns with the scope's claim columns merged in front of them. */\nexport type WithClaims<\n TClaims extends Record<string, AnyColumnDefinition>,\n TColumns extends TableColumnDefinitions,\n> = Prettify<TenantClaimColumns<TClaims> & TColumns>;\n\nexport type TenantScopeConfig<TClaims extends Record<string, AnyColumnDefinition>> = {\n claims: TClaims;\n};\n\n/**\n * A named set of claim columns shared by every table in one tenant boundary.\n *\n * The scope is the only producer of the `tenantKey` marker: a column carries it by being\n * declared here, never by a builder of its own. That is deliberate — a per-column marker would\n * leave no single place that says \"these are the claims\", which is what\n * `ExecutionContext.identity` has to be matched against.\n *\n * It is a definition node so it may be exported from a schema module beside the tables that use\n * it; the registry keeps only tables and relations, and it is not a schema object, so no\n * migration ever sees it.\n */\nexport class TenantScopeDefinition<\n TClaims extends Record<string, AnyColumnDefinition>,\n> extends DefinitionNode<string, TenantScopeConfig<TClaims>> {\n readonly kind = Kind.TENANT_SCOPE;\n\n private readonly _claims: TClaims;\n\n constructor(claims: TClaims, name: string = DEFAULT_SCOPE_NAME) {\n super(name);\n\n const fields = Object.keys(claims);\n\n if (fields.length === 0) {\n throw new Error(`Tenant scope \"${name}\" declares no claim columns.`);\n }\n\n for (const field of fields) {\n if (!claims[field][\"_notNull\"]) {\n throw new Error(\n `Claim \"${field}\" on tenant scope \"${name}\" must be notNull. ` +\n `A claim column is filled by the runtime on every insert, so it is never null.`\n );\n }\n }\n\n this._claims = claims;\n }\n\n /** The claim field names, in declaration order. */\n public get claims(): (keyof TClaims & string)[] {\n return Object.keys(this._claims) as (keyof TClaims & string)[];\n }\n\n /**\n * A fresh copy of every claim column, marked as a claim key and system-managed.\n *\n * Fresh on every call: the builders mutate a `ColumnDefinition` in place, so handing the same\n * instance to two tables would let a later change on one reach the other.\n */\n public columns(): TenantClaimColumns<TClaims> {\n const columns = {} as Record<string, AnyColumnDefinition>;\n\n for (const [field, claim] of Object.entries<AnyColumnDefinition>(this._claims)) {\n const column = claim.clone();\n\n column[\"_tenantKey\"] = true;\n column[\"_readOnly\"] = true;\n\n columns[field] = column;\n }\n\n return columns as TenantClaimColumns<TClaims>;\n }\n\n /**\n * A table inside this scope: sugar for spreading {@link columns} into `table(name, { … })`.\n *\n * Use the spread form directly when the table needs a different constructor — a namespaced\n * table is built by `namespace().table()`, which this cannot stand in for.\n */\n public table<TName extends string, TColumns extends TableColumnDefinitions>(\n name: TName,\n columns: TColumns\n ): TableDefinition<TName, WithClaims<TClaims, TColumns>, AnyNamespaceDefinition> {\n const claims = this.columns() as Record<string, AnyColumnDefinition>;\n\n for (const field of Object.keys(columns)) {\n if (Object.hasOwn(claims, field)) {\n throw new Error(\n `Table \"${name}\" redeclares claim \"${field}\" from tenant scope \"${this.name}\". ` +\n `A claim column is declared once, on the scope.`\n );\n }\n }\n\n return new TableDefinition(name, {\n columns: { ...claims, ...columns } as WithClaims<TClaims, TColumns>,\n });\n }\n}\n"]}
|
package/dist/runtime/group.d.ts
DELETED
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
import { TypedObject } from "../utils/index.js";
|
|
2
|
-
import { ColumnGroupConfig, ColumnGroupDefinition, TableColumnDefinitions } from "../definition/index.js";
|
|
3
|
-
import { SQLNode } from "../sql/index.js";
|
|
4
|
-
import { AnyColumn } from "./column.js";
|
|
5
|
-
import type { AnyTable } from "./table.js";
|
|
6
|
-
export type AnyColumnGroup = ColumnGroup<any, any, any>;
|
|
7
|
-
/** A member of a group, or of a table: a column, or a group of them. */
|
|
8
|
-
export type AnyField = AnyColumn | AnyColumnGroup;
|
|
9
|
-
/**
|
|
10
|
-
* Which members of a group a read selects, as the operation receives it: each member with the
|
|
11
|
-
* column or group it resolves to, and for a group the members selected within it — none meaning
|
|
12
|
-
* all of them.
|
|
13
|
-
*/
|
|
14
|
-
export type GroupSelection = [field: string, member: AnyField, selection?: GroupSelection][];
|
|
15
|
-
/** How a group is read: the columns to project, and how a row becomes the group's value. */
|
|
16
|
-
export type GroupReader = {
|
|
17
|
-
readonly columns: AnyColumn[];
|
|
18
|
-
resolve(row: Record<string, unknown>): Record<string, unknown> | null;
|
|
19
|
-
};
|
|
20
|
-
/**
|
|
21
|
-
* An embedded object placed in a table, at runtime: its members as built columns and groups.
|
|
22
|
-
*
|
|
23
|
-
* The group owns how it is read. Its columns are projected like any others, and the value is
|
|
24
|
-
* built from the row by {@link ColumnGroup.reader} — a resolver beside the column ones, not a
|
|
25
|
-
* column. A group is `null` exactly when it is {@link ColumnGroup.nullable} and every one of its
|
|
26
|
-
* columns is `NULL`; deciding that needs all of them, so a nullable group projects every column
|
|
27
|
-
* whatever the selection, and emits only the selected ones.
|
|
28
|
-
*/
|
|
29
|
-
export declare class ColumnGroup<TName extends string, TColumns extends TableColumnDefinitions, TTable extends AnyTable> implements TypedObject<ColumnGroupConfig<TColumns, boolean>> {
|
|
30
|
-
readonly __type: ColumnGroupConfig<TColumns, boolean>;
|
|
31
|
-
readonly table: TTable;
|
|
32
|
-
/** The prefix of the group's columns — `net_value` for `net_value_amount`. */
|
|
33
|
-
readonly name: TName;
|
|
34
|
-
readonly columns: Readonly<Record<string, AnyField>>;
|
|
35
|
-
/** True when every member, nested groups included, is nullable: the group can be absent. */
|
|
36
|
-
readonly nullable: boolean;
|
|
37
|
-
constructor(table: TTable, definition: ColumnGroupDefinition<TName, TColumns, boolean>);
|
|
38
|
-
hasColumn(field: string): boolean;
|
|
39
|
-
getColumn(field: string): AnyField | undefined;
|
|
40
|
-
/** Every column under the group, nested groups walked depth first. */
|
|
41
|
-
leafColumns(): AnyColumn[];
|
|
42
|
-
/**
|
|
43
|
-
* The filter for whether the group is present — any of its columns not `NULL` — or absent,
|
|
44
|
-
* every one `NULL`. The same rule {@link ColumnGroup.reader} reads it `null` by, so a filter
|
|
45
|
-
* and a read never disagree.
|
|
46
|
-
*/
|
|
47
|
-
exists(present: boolean): SQLNode;
|
|
48
|
-
/**
|
|
49
|
-
* How to read the group under `selection` — every member when it names none. A member column
|
|
50
|
-
* with a row decoder brings the columns it reads, as it does at table level.
|
|
51
|
-
*/
|
|
52
|
-
reader(selection?: GroupSelection): GroupReader;
|
|
53
|
-
}
|
|
54
|
-
//# sourceMappingURL=group.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../src/runtime/group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAEL,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAO,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAU,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAExD,wEAAwE;AACxE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,cAAc,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC;AAE7F,4FAA4F;AAC5F,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACvE,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,WAAW,CACtB,KAAK,SAAS,MAAM,EACpB,QAAQ,SAAS,sBAAsB,EACvC,MAAM,SAAS,QAAQ,CACvB,YAAW,WAAW,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5D,SAAiB,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErD,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAEf,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC;IAmB/E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIrD,sEAAsE;IAC/D,WAAW,IAAI,SAAS,EAAE;IAMjC;;;;OAIG;IACI,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAQxC;;;OAGG;IACI,MAAM,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,WAAW;CA8CvD"}
|
package/dist/runtime/group.js
DELETED
|
@@ -1,96 +0,0 @@
|
|
|
1
|
-
import { ColumnGroupDefinition, } from "../definition/index.js";
|
|
2
|
-
import { sql } from "../sql/index.js";
|
|
3
|
-
import { Column } from "./column.js";
|
|
4
|
-
/**
|
|
5
|
-
* An embedded object placed in a table, at runtime: its members as built columns and groups.
|
|
6
|
-
*
|
|
7
|
-
* The group owns how it is read. Its columns are projected like any others, and the value is
|
|
8
|
-
* built from the row by {@link ColumnGroup.reader} — a resolver beside the column ones, not a
|
|
9
|
-
* column. A group is `null` exactly when it is {@link ColumnGroup.nullable} and every one of its
|
|
10
|
-
* columns is `NULL`; deciding that needs all of them, so a nullable group projects every column
|
|
11
|
-
* whatever the selection, and emits only the selected ones.
|
|
12
|
-
*/
|
|
13
|
-
export class ColumnGroup {
|
|
14
|
-
table;
|
|
15
|
-
/** The prefix of the group's columns — `net_value` for `net_value_amount`. */
|
|
16
|
-
name;
|
|
17
|
-
columns;
|
|
18
|
-
/** True when every member, nested groups included, is nullable: the group can be absent. */
|
|
19
|
-
nullable;
|
|
20
|
-
constructor(table, definition) {
|
|
21
|
-
this.table = table;
|
|
22
|
-
this.name = definition.name;
|
|
23
|
-
const columns = {};
|
|
24
|
-
for (const [field, member] of Object.entries(definition.columns)) {
|
|
25
|
-
columns[field] =
|
|
26
|
-
member instanceof ColumnGroupDefinition
|
|
27
|
-
? new ColumnGroup(table, member)
|
|
28
|
-
: new Column(table, member);
|
|
29
|
-
}
|
|
30
|
-
this.columns = Object.freeze(columns);
|
|
31
|
-
this.nullable = Object.values(columns).every((member) => member instanceof ColumnGroup ? member.nullable : !member.notNull);
|
|
32
|
-
}
|
|
33
|
-
hasColumn(field) {
|
|
34
|
-
return Object.hasOwn(this.columns, field);
|
|
35
|
-
}
|
|
36
|
-
getColumn(field) {
|
|
37
|
-
return this.hasColumn(field) ? this.columns[field] : undefined;
|
|
38
|
-
}
|
|
39
|
-
/** Every column under the group, nested groups walked depth first. */
|
|
40
|
-
leafColumns() {
|
|
41
|
-
return Object.values(this.columns).flatMap((member) => member instanceof ColumnGroup ? member.leafColumns() : [member]);
|
|
42
|
-
}
|
|
43
|
-
/**
|
|
44
|
-
* The filter for whether the group is present — any of its columns not `NULL` — or absent,
|
|
45
|
-
* every one `NULL`. The same rule {@link ColumnGroup.reader} reads it `null` by, so a filter
|
|
46
|
-
* and a read never disagree.
|
|
47
|
-
*/
|
|
48
|
-
exists(present) {
|
|
49
|
-
const columns = this.leafColumns();
|
|
50
|
-
return present
|
|
51
|
-
? sql.wrap(sql.or(columns.map((column) => sql.isNotNull(column))))
|
|
52
|
-
: sql.and(columns.map((column) => sql.isNull(column)));
|
|
53
|
-
}
|
|
54
|
-
/**
|
|
55
|
-
* How to read the group under `selection` — every member when it names none. A member column
|
|
56
|
-
* with a row decoder brings the columns it reads, as it does at table level.
|
|
57
|
-
*/
|
|
58
|
-
reader(selection) {
|
|
59
|
-
const entries = selection && selection.length > 0
|
|
60
|
-
? selection
|
|
61
|
-
: Object.entries(this.columns).map(([field, member]) => [field, member]);
|
|
62
|
-
const columns = [];
|
|
63
|
-
const fields = [];
|
|
64
|
-
const project = (column) => {
|
|
65
|
-
if (!columns.includes(column)) {
|
|
66
|
-
columns.push(column);
|
|
67
|
-
}
|
|
68
|
-
};
|
|
69
|
-
for (const [field, member, nested] of entries) {
|
|
70
|
-
if (this.columns[field] !== member) {
|
|
71
|
-
throw new Error(`Group "${this.name}" on "${this.table.name}" has no member "${field}".`);
|
|
72
|
-
}
|
|
73
|
-
if (member instanceof ColumnGroup) {
|
|
74
|
-
const reader = member.reader(nested);
|
|
75
|
-
reader.columns.forEach(project);
|
|
76
|
-
fields.push([field, (row) => reader.resolve(row)]);
|
|
77
|
-
continue;
|
|
78
|
-
}
|
|
79
|
-
project(member);
|
|
80
|
-
member.rowDecoder?.dependsOn.forEach(project);
|
|
81
|
-
fields.push([field, (row) => member.resolveRow(row)]);
|
|
82
|
-
}
|
|
83
|
-
const presence = this.nullable ? this.leafColumns() : [];
|
|
84
|
-
presence.forEach(project);
|
|
85
|
-
return {
|
|
86
|
-
columns,
|
|
87
|
-
resolve: (row) => {
|
|
88
|
-
if (this.nullable && presence.every((column) => row[column.name] == null)) {
|
|
89
|
-
return null;
|
|
90
|
-
}
|
|
91
|
-
return Object.fromEntries(fields.map(([field, read]) => [field, read(row)]));
|
|
92
|
-
},
|
|
93
|
-
};
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
//# sourceMappingURL=group.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"group.js","sourceRoot":"","sources":["../../src/runtime/group.ts"],"names":[],"mappings":"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","sourcesContent":["import { TypedObject } from \"../utils/index.js\";\nimport {\n AnyColumnGroupDefinition,\n ColumnGroupConfig,\n ColumnGroupDefinition,\n TableColumnDefinitions,\n} from \"../definition/index.js\";\nimport { sql, SQLNode } from \"../sql/index.js\";\nimport { AnyColumn, Column } from \"./column.js\";\nimport type { AnyTable } from \"./table.js\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyColumnGroup = ColumnGroup<any, any, any>;\n\n/** A member of a group, or of a table: a column, or a group of them. */\nexport type AnyField = AnyColumn | AnyColumnGroup;\n\n/**\n * Which members of a group a read selects, as the operation receives it: each member with the\n * column or group it resolves to, and for a group the members selected within it — none meaning\n * all of them.\n */\nexport type GroupSelection = [field: string, member: AnyField, selection?: GroupSelection][];\n\n/** How a group is read: the columns to project, and how a row becomes the group's value. */\nexport type GroupReader = {\n readonly columns: AnyColumn[];\n resolve(row: Record<string, unknown>): Record<string, unknown> | null;\n};\n\n/**\n * An embedded object placed in a table, at runtime: its members as built columns and groups.\n *\n * The group owns how it is read. Its columns are projected like any others, and the value is\n * built from the row by {@link ColumnGroup.reader} — a resolver beside the column ones, not a\n * column. A group is `null` exactly when it is {@link ColumnGroup.nullable} and every one of its\n * columns is `NULL`; deciding that needs all of them, so a nullable group projects every column\n * whatever the selection, and emits only the selected ones.\n */\nexport class ColumnGroup<\n TName extends string,\n TColumns extends TableColumnDefinitions,\n TTable extends AnyTable,\n> implements TypedObject<ColumnGroupConfig<TColumns, boolean>> {\n declare readonly __type: ColumnGroupConfig<TColumns, boolean>;\n\n readonly table: TTable;\n /** The prefix of the group's columns — `net_value` for `net_value_amount`. */\n readonly name: TName;\n readonly columns: Readonly<Record<string, AnyField>>;\n\n /** True when every member, nested groups included, is nullable: the group can be absent. */\n readonly nullable: boolean;\n\n constructor(table: TTable, definition: ColumnGroupDefinition<TName, TColumns, boolean>) {\n this.table = table;\n this.name = definition.name;\n\n const columns: Record<string, AnyField> = {};\n\n for (const [field, member] of Object.entries(definition.columns)) {\n columns[field] =\n member instanceof ColumnGroupDefinition\n ? new ColumnGroup(table, member as AnyColumnGroupDefinition)\n : new Column(table, member);\n }\n\n this.columns = Object.freeze(columns);\n this.nullable = Object.values(columns).every((member) =>\n member instanceof ColumnGroup ? member.nullable : !member.notNull\n );\n }\n\n public hasColumn(field: string): boolean {\n return Object.hasOwn(this.columns, field);\n }\n\n public getColumn(field: string): AnyField | undefined {\n return this.hasColumn(field) ? this.columns[field] : undefined;\n }\n\n /** Every column under the group, nested groups walked depth first. */\n public leafColumns(): AnyColumn[] {\n return Object.values(this.columns).flatMap((member) =>\n member instanceof ColumnGroup ? member.leafColumns() : [member]\n );\n }\n\n /**\n * The filter for whether the group is present — any of its columns not `NULL` — or absent,\n * every one `NULL`. The same rule {@link ColumnGroup.reader} reads it `null` by, so a filter\n * and a read never disagree.\n */\n public exists(present: boolean): SQLNode {\n const columns = this.leafColumns();\n\n return present\n ? sql.wrap(sql.or(columns.map((column) => sql.isNotNull(column))))\n : sql.and(columns.map((column) => sql.isNull(column)));\n }\n\n /**\n * How to read the group under `selection` — every member when it names none. A member column\n * with a row decoder brings the columns it reads, as it does at table level.\n */\n public reader(selection?: GroupSelection): GroupReader {\n const entries: GroupSelection =\n selection && selection.length > 0\n ? selection\n : Object.entries(this.columns).map(([field, member]) => [field, member]);\n\n const columns: AnyColumn[] = [];\n const fields: [string, (row: Record<string, unknown>) => unknown][] = [];\n\n const project = (column: AnyColumn) => {\n if (!columns.includes(column)) {\n columns.push(column);\n }\n };\n\n for (const [field, member, nested] of entries) {\n if (this.columns[field] !== member) {\n throw new Error(`Group \"${this.name}\" on \"${this.table.name}\" has no member \"${field}\".`);\n }\n\n if (member instanceof ColumnGroup) {\n const reader = member.reader(nested);\n reader.columns.forEach(project);\n fields.push([field, (row) => reader.resolve(row)]);\n continue;\n }\n\n project(member);\n member.rowDecoder?.dependsOn.forEach(project);\n fields.push([field, (row) => member.resolveRow(row)]);\n }\n\n const presence = this.nullable ? this.leafColumns() : [];\n presence.forEach(project);\n\n return {\n columns,\n resolve: (row) => {\n if (this.nullable && presence.every((column) => row[column.name] == null)) {\n return null;\n }\n\n return Object.fromEntries(fields.map(([field, read]) => [field, read(row)]));\n },\n };\n }\n}\n"]}
|