@dsqlbase/core 0.2.0 → 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.
Files changed (164) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/dist/definition/base.d.ts +3 -30
  3. package/dist/definition/base.d.ts.map +1 -1
  4. package/dist/definition/base.js +3 -14
  5. package/dist/definition/base.js.map +1 -1
  6. package/dist/definition/column.d.ts +22 -14
  7. package/dist/definition/column.d.ts.map +1 -1
  8. package/dist/definition/column.js +11 -37
  9. package/dist/definition/column.js.map +1 -1
  10. package/dist/definition/constraint.d.ts +9 -9
  11. package/dist/definition/constraint.d.ts.map +1 -1
  12. package/dist/definition/constraint.js.map +1 -1
  13. package/dist/definition/domain.d.ts +2 -1
  14. package/dist/definition/domain.d.ts.map +1 -1
  15. package/dist/definition/domain.js +2 -1
  16. package/dist/definition/domain.js.map +1 -1
  17. package/dist/definition/index.d.ts +5 -6
  18. package/dist/definition/index.d.ts.map +1 -1
  19. package/dist/definition/index.js +3 -4
  20. package/dist/definition/index.js.map +1 -1
  21. package/dist/definition/indexes.d.ts +9 -20
  22. package/dist/definition/indexes.d.ts.map +1 -1
  23. package/dist/definition/indexes.js +3 -6
  24. package/dist/definition/indexes.js.map +1 -1
  25. package/dist/definition/namespace.d.ts +2 -2
  26. package/dist/definition/namespace.d.ts.map +1 -1
  27. package/dist/definition/namespace.js.map +1 -1
  28. package/dist/definition/policy.d.ts +35 -0
  29. package/dist/definition/policy.d.ts.map +1 -0
  30. package/dist/definition/policy.js +42 -0
  31. package/dist/definition/policy.js.map +1 -0
  32. package/dist/definition/relations.d.ts +28 -33
  33. package/dist/definition/relations.d.ts.map +1 -1
  34. package/dist/definition/relations.js +1 -4
  35. package/dist/definition/relations.js.map +1 -1
  36. package/dist/definition/table.d.ts +39 -32
  37. package/dist/definition/table.d.ts.map +1 -1
  38. package/dist/definition/table.js +57 -67
  39. package/dist/definition/table.js.map +1 -1
  40. package/dist/definition/union.d.ts +18 -61
  41. package/dist/definition/union.d.ts.map +1 -1
  42. package/dist/definition/union.js +8 -69
  43. package/dist/definition/union.js.map +1 -1
  44. package/dist/index.d.ts +5 -3
  45. package/dist/index.d.ts.map +1 -1
  46. package/dist/index.js +5 -3
  47. package/dist/index.js.map +1 -1
  48. package/dist/resolvers/codec.d.ts +16 -0
  49. package/dist/resolvers/codec.d.ts.map +1 -0
  50. package/dist/resolvers/codec.js +9 -0
  51. package/dist/resolvers/codec.js.map +1 -0
  52. package/dist/resolvers/hooks.d.ts +39 -0
  53. package/dist/resolvers/hooks.d.ts.map +1 -0
  54. package/dist/resolvers/hooks.js +2 -0
  55. package/dist/resolvers/hooks.js.map +1 -0
  56. package/dist/resolvers/index.d.ts +5 -0
  57. package/dist/resolvers/index.d.ts.map +1 -0
  58. package/dist/resolvers/index.js +2 -0
  59. package/dist/resolvers/index.js.map +1 -0
  60. package/dist/resolvers/policy.d.ts +31 -0
  61. package/dist/resolvers/policy.d.ts.map +1 -0
  62. package/dist/resolvers/policy.js +2 -0
  63. package/dist/resolvers/policy.js.map +1 -0
  64. package/dist/resolvers/validator.d.ts +14 -0
  65. package/dist/resolvers/validator.d.ts.map +1 -0
  66. package/dist/resolvers/validator.js +2 -0
  67. package/dist/resolvers/validator.js.map +1 -0
  68. package/dist/runtime/base.d.ts +7 -4
  69. package/dist/runtime/base.d.ts.map +1 -1
  70. package/dist/runtime/base.js.map +1 -1
  71. package/dist/runtime/build.d.ts +22 -0
  72. package/dist/runtime/build.d.ts.map +1 -0
  73. package/dist/runtime/build.js +184 -0
  74. package/dist/runtime/build.js.map +1 -0
  75. package/dist/runtime/column.d.ts +40 -23
  76. package/dist/runtime/column.d.ts.map +1 -1
  77. package/dist/runtime/column.js +120 -28
  78. package/dist/runtime/column.js.map +1 -1
  79. package/dist/runtime/context.d.ts +17 -26
  80. package/dist/runtime/context.d.ts.map +1 -1
  81. package/dist/runtime/context.js +4 -6
  82. package/dist/runtime/context.js.map +1 -1
  83. package/dist/runtime/errors.d.ts +31 -9
  84. package/dist/runtime/errors.d.ts.map +1 -1
  85. package/dist/runtime/errors.js +54 -11
  86. package/dist/runtime/errors.js.map +1 -1
  87. package/dist/runtime/executor.d.ts.map +1 -1
  88. package/dist/runtime/executor.js +10 -1
  89. package/dist/runtime/executor.js.map +1 -1
  90. package/dist/runtime/index.d.ts +10 -6
  91. package/dist/runtime/index.d.ts.map +1 -1
  92. package/dist/runtime/index.js +5 -3
  93. package/dist/runtime/index.js.map +1 -1
  94. package/dist/runtime/operation.d.ts +62 -83
  95. package/dist/runtime/operation.d.ts.map +1 -1
  96. package/dist/runtime/operation.js +194 -260
  97. package/dist/runtime/operation.js.map +1 -1
  98. package/dist/runtime/policy.d.ts +35 -0
  99. package/dist/runtime/policy.d.ts.map +1 -0
  100. package/dist/runtime/policy.js +72 -0
  101. package/dist/runtime/policy.js.map +1 -0
  102. package/dist/runtime/reference.d.ts +87 -0
  103. package/dist/runtime/reference.d.ts.map +1 -0
  104. package/dist/runtime/reference.js +68 -0
  105. package/dist/runtime/reference.js.map +1 -0
  106. package/dist/runtime/registry.d.ts +26 -95
  107. package/dist/runtime/registry.d.ts.map +1 -1
  108. package/dist/runtime/registry.js +29 -408
  109. package/dist/runtime/registry.js.map +1 -1
  110. package/dist/runtime/relation.d.ts +45 -0
  111. package/dist/runtime/relation.d.ts.map +1 -0
  112. package/dist/runtime/relation.js +2 -0
  113. package/dist/runtime/relation.js.map +1 -0
  114. package/dist/runtime/table.d.ts +31 -35
  115. package/dist/runtime/table.d.ts.map +1 -1
  116. package/dist/runtime/table.js +78 -47
  117. package/dist/runtime/table.js.map +1 -1
  118. package/dist/runtime/union.d.ts +11 -4
  119. package/dist/runtime/union.d.ts.map +1 -1
  120. package/dist/runtime/union.js +18 -7
  121. package/dist/runtime/union.js.map +1 -1
  122. package/dist/sql/index.d.ts +2 -2
  123. package/dist/sql/index.d.ts.map +1 -1
  124. package/dist/sql/index.js +1 -1
  125. package/dist/sql/index.js.map +1 -1
  126. package/dist/sql/nodes.d.ts +22 -0
  127. package/dist/sql/nodes.d.ts.map +1 -1
  128. package/dist/sql/nodes.js +21 -0
  129. package/dist/sql/nodes.js.map +1 -1
  130. package/dist/sql/tag.d.ts +3 -15
  131. package/dist/sql/tag.d.ts.map +1 -1
  132. package/dist/sql/tag.js +5 -71
  133. package/dist/sql/tag.js.map +1 -1
  134. package/dist/utils/index.d.ts +1 -1
  135. package/dist/utils/index.d.ts.map +1 -1
  136. package/dist/utils/index.js.map +1 -1
  137. package/dist/utils/types.d.ts +2 -14
  138. package/dist/utils/types.d.ts.map +1 -1
  139. package/dist/utils/types.js.map +1 -1
  140. package/dist/validation/index.d.ts +2 -0
  141. package/dist/validation/index.d.ts.map +1 -0
  142. package/dist/validation/index.js +2 -0
  143. package/dist/validation/index.js.map +1 -0
  144. package/dist/validation/references.d.ts +23 -0
  145. package/dist/validation/references.d.ts.map +1 -0
  146. package/dist/validation/references.js +240 -0
  147. package/dist/validation/references.js.map +1 -0
  148. package/dist/validation/validate.d.ts +40 -0
  149. package/dist/validation/validate.d.ts.map +1 -0
  150. package/dist/validation/validate.js +354 -0
  151. package/dist/validation/validate.js.map +1 -0
  152. package/package.json +13 -4
  153. package/dist/definition/embedded.d.ts +0 -131
  154. package/dist/definition/embedded.d.ts.map +0 -1
  155. package/dist/definition/embedded.js +0 -133
  156. package/dist/definition/embedded.js.map +0 -1
  157. package/dist/definition/tenant.d.ts +0 -50
  158. package/dist/definition/tenant.d.ts.map +0 -1
  159. package/dist/definition/tenant.js +0 -73
  160. package/dist/definition/tenant.js.map +0 -1
  161. package/dist/runtime/group.d.ts +0 -54
  162. package/dist/runtime/group.d.ts.map +0 -1
  163. package/dist/runtime/group.js +0 -96
  164. package/dist/runtime/group.js.map +0 -1
@@ -1,4 +1,6 @@
1
- import { AnyUnionDefinition } from "../definition/index.js";
1
+ import { AnyTableRelations, AnyUnionDefinition, AnyUnionMembers, UnionColumnsConfig, UnionConfig, UnionDefinition } from "../definition/index.js";
2
+ import { TypedObject } from "../utils/types.js";
3
+ import { WithRelations } from "./base.js";
2
4
  import { AnyColumn } from "./column.js";
3
5
  import { AnyTable } from "./table.js";
4
6
  /**
@@ -7,16 +9,19 @@ import { AnyTable } from "./table.js";
7
9
  *
8
10
  * Built by the registry once every table exists, since a member is only a `Table` from then.
9
11
  */
10
- export declare class Union {
12
+ export declare class Union<TName extends string, TMembers extends AnyUnionMembers, TColumns extends UnionColumnsConfig<TMembers>, TRelations extends AnyTableRelations> implements TypedObject<WithRelations<UnionConfig<TMembers, TColumns>, TRelations>> {
13
+ readonly __type: WithRelations<UnionConfig<TMembers, TColumns>, TRelations>;
14
+ readonly name: TName;
11
15
  /** The schema key the union was exported under. */
12
16
  readonly alias: string;
13
17
  readonly definition: AnyUnionDefinition;
14
18
  readonly members: Readonly<Record<string, AnyTable>>;
15
19
  /** Shared field → member alias → that member's column for the field. */
16
20
  readonly sharedColumns: Readonly<Record<string, Readonly<Record<string, AnyColumn>>>>;
17
- constructor(definition: AnyUnionDefinition, members: Record<string, AnyTable>, alias: string);
21
+ constructor(definition: UnionDefinition<TName, TMembers, TColumns>, members: Record<string, AnyTable>, alias?: string);
18
22
  /** The member aliases, in declaration order. */
19
23
  get memberAliases(): string[];
24
+ private _buildSharedColumns;
20
25
  hasMember(alias: string): boolean;
21
26
  getMember(alias: string): AnyTable;
22
27
  /**
@@ -26,8 +31,10 @@ export declare class Union {
26
31
  */
27
32
  get tiebreakers(): number;
28
33
  isShared(field: string): boolean;
34
+ hasColumn(field: string): boolean;
35
+ getColumn(field: string): AnyColumn | undefined;
29
36
  /** The column a shared field resolves to on one member. */
30
37
  getMemberColumn(alias: string, field: string): AnyColumn;
31
38
  }
32
- export type AnyUnion = Union;
39
+ export type AnyUnion = Union<any, any, any, any>;
33
40
  //# sourceMappingURL=union.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../../src/runtime/union.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;GAKG;AACH,qBAAa,KAAK;IAChB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAExC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErD,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBAE1E,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM;IAqB5F,gDAAgD;IAChD,IAAW,aAAa,IAAI,MAAM,EAAE,CAEnC;IAEM,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAUzC;;;;OAIG;IACH,IAAW,WAAW,IAAI,MAAM,CAe/B;IAEM,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIvC,2DAA2D;IACpD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;CAYhE;AAED,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC"}
1
+ {"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../../src/runtime/union.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;GAKG;AACH,qBAAa,KAAK,CAChB,KAAK,SAAS,MAAM,EACpB,QAAQ,SAAS,eAAe,EAChC,QAAQ,SAAS,kBAAkB,CAAC,QAAQ,CAAC,EAC7C,UAAU,SAAS,iBAAiB,CACpC,YAAW,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;IAClF,SAAiB,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;IAEpF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErD,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBAGpF,UAAU,EAAE,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACjC,KAAK,CAAC,EAAE,MAAM;IAShB,gDAAgD;IAChD,IAAW,aAAa,IAAI,MAAM,EAAE,CAEnC;IAED,OAAO,CAAC,mBAAmB;IAiBpB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAUzC;;;;OAIG;IACH,IAAW,WAAW,IAAI,MAAM,CAe/B;IAEM,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIhC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItD,2DAA2D;IACpD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;CAYhE;AAGD,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC"}
@@ -5,6 +5,7 @@
5
5
  * Built by the registry once every table exists, since a member is only a `Table` from then.
6
6
  */
7
7
  export class Union {
8
+ name;
8
9
  /** The schema key the union was exported under. */
9
10
  alias;
10
11
  definition;
@@ -12,21 +13,25 @@ export class Union {
12
13
  /** Shared field → member alias → that member's column for the field. */
13
14
  sharedColumns;
14
15
  constructor(definition, members, alias) {
15
- this.alias = alias;
16
+ this.name = definition.name;
17
+ this.alias = alias ?? definition.name;
16
18
  this.definition = definition;
17
19
  this.members = Object.freeze({ ...members });
20
+ this.sharedColumns = this._buildSharedColumns();
21
+ }
22
+ /** The member aliases, in declaration order. */
23
+ get memberAliases() {
24
+ return Object.keys(this.members);
25
+ }
26
+ _buildSharedColumns() {
18
27
  const shared = {};
19
- for (const field of Object.keys(definition.columns)) {
28
+ for (const field of Object.keys(this.definition.columns)) {
20
29
  shared[field] = Object.freeze(Object.fromEntries(Object.entries(this.members).map(([key, member]) => [
21
30
  key,
22
31
  member.getColumn(field),
23
32
  ])));
24
33
  }
25
- this.sharedColumns = Object.freeze(shared);
26
- }
27
- /** The member aliases, in declaration order. */
28
- get memberAliases() {
29
- return Object.keys(this.members);
34
+ return Object.freeze(shared);
30
35
  }
31
36
  hasMember(alias) {
32
37
  return Object.hasOwn(this.members, alias);
@@ -56,6 +61,12 @@ export class Union {
56
61
  isShared(field) {
57
62
  return Object.hasOwn(this.sharedColumns, field);
58
63
  }
64
+ hasColumn(field) {
65
+ return Object.hasOwn(this.sharedColumns, field);
66
+ }
67
+ getColumn(field) {
68
+ return this.sharedColumns[field]?.[this.memberAliases[0]];
69
+ }
59
70
  /** The column a shared field resolves to on one member. */
60
71
  getMemberColumn(alias, field) {
61
72
  const column = this.sharedColumns[field]?.[alias];
@@ -1 +1 @@
1
- {"version":3,"file":"union.js","sourceRoot":"","sources":["../../src/runtime/union.ts"],"names":[],"mappings":"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","sourcesContent":["import { AnyUnionDefinition } from \"../definition/index.js\";\nimport { AnyColumn } from \"./column.js\";\nimport { AnyTable } from \"./table.js\";\n\n/**\n * The runtime form of a `union()`: its members as built tables, keyed by schema alias, and\n * each shared field resolved to the real column on every member.\n *\n * Built by the registry once every table exists, since a member is only a `Table` from then.\n */\nexport class Union {\n /** The schema key the union was exported under. */\n readonly alias: string;\n\n readonly definition: AnyUnionDefinition;\n\n readonly members: Readonly<Record<string, AnyTable>>;\n\n /** Shared field → member alias → that member's column for the field. */\n readonly sharedColumns: Readonly<Record<string, Readonly<Record<string, AnyColumn>>>>;\n\n constructor(definition: AnyUnionDefinition, members: Record<string, AnyTable>, alias: string) {\n this.alias = alias;\n this.definition = definition;\n this.members = Object.freeze({ ...members });\n\n const shared: Record<string, Record<string, AnyColumn>> = {};\n\n for (const field of Object.keys(definition.columns)) {\n shared[field] = Object.freeze(\n Object.fromEntries(\n Object.entries(this.members).map(([key, member]) => [\n key,\n member.getColumn(field) as AnyColumn,\n ])\n )\n );\n }\n\n this.sharedColumns = Object.freeze(shared);\n }\n\n /** The member aliases, in declaration order. */\n public get memberAliases(): string[] {\n return Object.keys(this.members);\n }\n\n public hasMember(alias: string): boolean {\n return Object.hasOwn(this.members, alias);\n }\n\n public getMember(alias: string): AnyTable {\n const member = this.members[alias];\n\n if (!member) {\n throw new Error(`Union \"${this.alias}\" has no member \"${alias}\".`);\n }\n\n return member;\n }\n\n /**\n * How many primary-key columns can break ties across the union: all of them when every\n * member's key has the same arity and the same types position by position, none otherwise —\n * a `UNION ALL` column must have one type across branches.\n */\n public get tiebreakers(): number {\n const keys = Object.values(this.members).map((member) => member.primaryKey);\n const [first] = keys;\n\n if (!first || first.length === 0) {\n return 0;\n }\n\n const aligned = keys.every(\n (key) =>\n key.length === first.length &&\n key.every((column, index) => column.dataType === first[index].dataType)\n );\n\n return aligned ? first.length : 0;\n }\n\n public isShared(field: string): boolean {\n return Object.hasOwn(this.sharedColumns, field);\n }\n\n /** The column a shared field resolves to on one member. */\n public getMemberColumn(alias: string, field: string): AnyColumn {\n const column = this.sharedColumns[field]?.[alias];\n\n if (!column) {\n throw new Error(\n `Field \"${field}\" is not shared by every member of union \"${this.alias}\", so it cannot ` +\n `be used across the union.`\n );\n }\n\n return column;\n }\n}\n\nexport type AnyUnion = Union;\n"]}
1
+ {"version":3,"file":"union.js","sourceRoot":"","sources":["../../src/runtime/union.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n AnyTableRelations,\n AnyUnionDefinition,\n AnyUnionMembers,\n UnionColumnsConfig,\n UnionConfig,\n UnionDefinition,\n} from \"../definition/index.js\";\nimport { TypedObject } from \"../utils/types.js\";\nimport { WithRelations } from \"./base.js\";\nimport { AnyColumn } from \"./column.js\";\nimport { AnyTable } from \"./table.js\";\n\n/**\n * The runtime form of a `union()`: its members as built tables, keyed by schema alias, and\n * each shared field resolved to the real column on every member.\n *\n * Built by the registry once every table exists, since a member is only a `Table` from then.\n */\nexport class Union<\n TName extends string,\n TMembers extends AnyUnionMembers,\n TColumns extends UnionColumnsConfig<TMembers>,\n TRelations extends AnyTableRelations,\n> implements TypedObject<WithRelations<UnionConfig<TMembers, TColumns>, TRelations>> {\n declare readonly __type: WithRelations<UnionConfig<TMembers, TColumns>, TRelations>;\n\n readonly name: TName;\n /** The schema key the union was exported under. */\n readonly alias: string;\n readonly definition: AnyUnionDefinition;\n readonly members: Readonly<Record<string, AnyTable>>;\n\n /** Shared field → member alias → that member's column for the field. */\n readonly sharedColumns: Readonly<Record<string, Readonly<Record<string, AnyColumn>>>>;\n\n constructor(\n definition: UnionDefinition<TName, TMembers, TColumns>,\n members: Record<string, AnyTable>,\n alias?: string\n ) {\n this.name = definition.name;\n this.alias = alias ?? definition.name;\n this.definition = definition;\n this.members = Object.freeze({ ...members });\n this.sharedColumns = this._buildSharedColumns();\n }\n\n /** The member aliases, in declaration order. */\n public get memberAliases(): string[] {\n return Object.keys(this.members);\n }\n\n private _buildSharedColumns(): Record<string, Readonly<Record<string, AnyColumn>>> {\n const shared: Record<string, Record<string, AnyColumn>> = {};\n\n for (const field of Object.keys(this.definition.columns)) {\n shared[field] = Object.freeze(\n Object.fromEntries(\n Object.entries(this.members).map(([key, member]) => [\n key,\n member.getColumn(field) as AnyColumn,\n ])\n )\n );\n }\n\n return Object.freeze(shared);\n }\n\n public hasMember(alias: string): boolean {\n return Object.hasOwn(this.members, alias);\n }\n\n public getMember(alias: string): AnyTable {\n const member = this.members[alias];\n\n if (!member) {\n throw new Error(`Union \"${this.alias}\" has no member \"${alias}\".`);\n }\n\n return member;\n }\n\n /**\n * How many primary-key columns can break ties across the union: all of them when every\n * member's key has the same arity and the same types position by position, none otherwise —\n * a `UNION ALL` column must have one type across branches.\n */\n public get tiebreakers(): number {\n const keys = Object.values(this.members).map((member) => member.primaryKey);\n const [first] = keys;\n\n if (!first || first.length === 0) {\n return 0;\n }\n\n const aligned = keys.every(\n (key) =>\n key.length === first.length &&\n key.every((column, index) => column.dataType === first[index].dataType)\n );\n\n return aligned ? first.length : 0;\n }\n\n public isShared(field: string): boolean {\n return Object.hasOwn(this.sharedColumns, field);\n }\n\n public hasColumn(field: string): boolean {\n return Object.hasOwn(this.sharedColumns, field);\n }\n\n public getColumn(field: string): AnyColumn | undefined {\n return this.sharedColumns[field]?.[this.memberAliases[0]];\n }\n\n /** The column a shared field resolves to on one member. */\n public getMemberColumn(alias: string, field: string): AnyColumn {\n const column = this.sharedColumns[field]?.[alias];\n\n if (!column) {\n throw new Error(\n `Field \"${field}\" is not shared by every member of union \"${this.alias}\", so it cannot ` +\n `be used across the union.`\n );\n }\n\n return column;\n }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyUnion = Union<any, any, any, any>;\n"]}
@@ -1,4 +1,4 @@
1
- export { type SQLNode, type SQLStatement, type SQLContext, SQLRaw, SQLParam, SQLIdentifier, SQLQuery, SQLWrapper, isSQLNode, type SQLValue, type ValueSerializer, } from "./nodes.js";
2
- export { sql, type KeysetKey, type KeysetBound } from "./tag.js";
1
+ export { type SQLNode, type SQLStatement, type SQLContext, SQLRaw, SQLParam, SQLClaim, SQLIdentifier, SQLQuery, SQLWrapper, SQLScope, isSQLNode, type SQLValue, type ValueSerializer, } from "./nodes.js";
2
+ export { sql } from "./tag.js";
3
3
  export { counter, escapeValue, escapeIdentifier, type ParamIndexCounter } from "./utils.js";
4
4
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sql/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,MAAM,EACN,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,UAAU,EACV,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,GAAG,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sql/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
package/dist/sql/index.js CHANGED
@@ -1,4 +1,4 @@
1
- export { SQLRaw, SQLParam, SQLIdentifier, SQLQuery, SQLWrapper, isSQLNode, } from "./nodes.js";
1
+ export { SQLRaw, SQLParam, SQLClaim, SQLIdentifier, SQLQuery, SQLWrapper, SQLScope, isSQLNode, } from "./nodes.js";
2
2
  export { sql } from "./tag.js";
3
3
  export { counter, escapeValue, escapeIdentifier } from "./utils.js";
4
4
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sql/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,MAAM,EACN,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,UAAU,EACV,SAAS,GAGV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,GAAG,EAAoC,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC","sourcesContent":["export {\n type SQLNode,\n type SQLStatement,\n type SQLContext,\n SQLRaw,\n SQLParam,\n SQLIdentifier,\n SQLQuery,\n SQLWrapper,\n isSQLNode,\n type SQLValue,\n type ValueSerializer,\n} from \"./nodes.js\";\nexport { sql, type KeysetKey, type KeysetBound } from \"./tag.js\";\nexport { counter, escapeValue, escapeIdentifier, type ParamIndexCounter } from \"./utils.js\";\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sql/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,SAAS,GAGV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC","sourcesContent":["export {\n type SQLNode,\n type SQLStatement,\n type SQLContext,\n SQLRaw,\n SQLParam,\n SQLClaim,\n SQLIdentifier,\n SQLQuery,\n SQLWrapper,\n SQLScope,\n isSQLNode,\n type SQLValue,\n type ValueSerializer,\n} from \"./nodes.js\";\nexport { sql } from \"./tag.js\";\nexport { counter, escapeValue, escapeIdentifier, type ParamIndexCounter } from \"./utils.js\";\n"]}
@@ -16,6 +16,11 @@ export type SQLContext = {
16
16
  * the keys are, which keeps this layer independent of the runtime.
17
17
  */
18
18
  aliases?: ReadonlyMap<unknown, string>;
19
+ /**
20
+ * The per-request values {@link SQLClaim} nodes render, keyed by claim name. Absent, or
21
+ * missing a key, renders that claim as `NULL`.
22
+ */
23
+ claims?: Readonly<Record<string, unknown>>;
19
24
  };
20
25
  export type SQLValue = string | number | boolean | bigint | null | object;
21
26
  export type ValueSerializer<T> = (value: T) => unknown;
@@ -35,6 +40,23 @@ export declare class SQLParam<TValue> implements SQLNode {
35
40
  private _serializeInlineParam;
36
41
  toSQL(ctx: SQLContext): SQLStatement;
37
42
  }
43
+ /**
44
+ * A per-request value, read from {@link SQLContext.claims} when the statement is rendered and
45
+ * bound as a parameter. Claims are typically used to represent authenticated user attributes or
46
+ * other request-scoped metadata.
47
+ *
48
+ * Unset renders `NULL`, exactly as `current_setting(key, true)` does. Nothing refuses a missing
49
+ * value: a comparison with `NULL` is never true, so a policy reading one denies by itself.
50
+ */
51
+ export declare class SQLClaim<TValue = unknown> implements SQLNode {
52
+ readonly __type: {
53
+ valueType: TValue;
54
+ };
55
+ readonly key: string;
56
+ private readonly _encode;
57
+ constructor(key: string, encode?: ValueSerializer<TValue>);
58
+ toSQL(ctx: SQLContext): SQLStatement;
59
+ }
38
60
  export declare class SQLWrapper implements SQLNode {
39
61
  private readonly _node;
40
62
  constructor(node: SQLNode);
@@ -1 +1 @@
1
- {"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/sql/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5F,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;AAE1E,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;AAEvD,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAOnD,CAAC;AAEF,qBAAa,MAAO,YAAW,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,IAAI,EAAE,MAAM;IAIxB,KAAK,IAAI,YAAY;CAGtB;AAED,qBAAa,QAAQ,CAAC,MAAM,CAAE,YAAW,OAAO;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;gBAEzC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,eAAe,CAAC,MAAM,CAAoB;IAKjF,OAAO,CAAC,qBAAqB;IAqB7B,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY;CAcrC;AAED,qBAAa,UAAW,YAAW,OAAO;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,IAAI,EAAE,OAAO;IAIzB,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY;CAQrC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,QAAS,YAAW,OAAO;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO;IAKjE,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY;CAKrC;AAED,qBAAa,aAAc,YAAW,OAAO;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;IAIxB,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY;CAGrC;AAED,qBAAa,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,OAAO;IAC3C,MAAM,EAAE,CAAC,CAAC;IAElB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,KAAK,GAAE,OAAO,GAAG,OAAO,EAAO;IAI3C,OAAO,CAAC,YAAY;IAOb,MAAM,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IAKjC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,YAAY;IAShD,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY;CAI5C"}
1
+ {"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/sql/nodes.ts"],"names":[],"mappings":"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"}
package/dist/sql/nodes.js CHANGED
@@ -50,6 +50,26 @@ export class SQLParam {
50
50
  return { text: `$${paramIndex}`, params: [encodedValue] };
51
51
  }
52
52
  }
53
+ /**
54
+ * A per-request value, read from {@link SQLContext.claims} when the statement is rendered and
55
+ * bound as a parameter. Claims are typically used to represent authenticated user attributes or
56
+ * other request-scoped metadata.
57
+ *
58
+ * Unset renders `NULL`, exactly as `current_setting(key, true)` does. Nothing refuses a missing
59
+ * value: a comparison with `NULL` is never true, so a policy reading one denies by itself.
60
+ */
61
+ export class SQLClaim {
62
+ key;
63
+ _encode;
64
+ constructor(key, encode = (value) => value) {
65
+ this.key = key;
66
+ this._encode = encode;
67
+ }
68
+ toSQL(ctx) {
69
+ const value = ctx.claims?.[this.key];
70
+ return new SQLParam((value ?? null), this._encode).toSQL(ctx);
71
+ }
72
+ }
53
73
  export class SQLWrapper {
54
74
  _node;
55
75
  constructor(node) {
@@ -117,6 +137,7 @@ export class SQLQuery {
117
137
  paramCounter: ctx?.paramCounter ?? counter(),
118
138
  escapeValue: ctx?.escapeValue ?? escapeValue,
119
139
  escapeIdentifier: ctx?.escapeIdentifier ?? escapeIdentifier,
140
+ claims: ctx?.claims,
120
141
  });
121
142
  }
122
143
  toSQL(ctx) {
@@ -1 +1 @@
1
- {"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/sql/nodes.ts"],"names":[],"mappings":"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","sourcesContent":["import { counter, escapeIdentifier, escapeValue, type ParamIndexCounter } from \"./utils.js\";\n\nexport type SQLStatement = {\n text: string;\n params: unknown[];\n};\n\nexport type SQLContext = {\n inlineParams: boolean;\n paramCounter: ParamIndexCounter;\n escapeValue(str: string): string;\n escapeIdentifier(str: string): string;\n\n /**\n * Alias bindings in effect for the subtree being rendered, set by {@link SQLScope}.\n *\n * Keys are opaque to this module — a node that wants to be referenced by an alias looks\n * itself up here and falls back to its own name when absent. Nothing in `sql/` knows what\n * the keys are, which keeps this layer independent of the runtime.\n */\n aliases?: ReadonlyMap<unknown, string>;\n};\n\nexport type SQLValue = string | number | boolean | bigint | null | object;\n\nexport type ValueSerializer<T> = (value: T) => unknown;\n\nexport type SQLNode = {\n toSQL(ctx: SQLContext): SQLStatement;\n};\n\nexport const isSQLNode = (value: unknown): value is SQLNode => {\n return (\n typeof value === \"object\" &&\n value !== null &&\n \"toSQL\" in value &&\n typeof value.toSQL === \"function\"\n );\n};\n\nexport class SQLRaw implements SQLNode {\n private readonly _text: string;\n\n constructor(text: string) {\n this._text = text;\n }\n\n toSQL(): SQLStatement {\n return { text: this._text, params: [] };\n }\n}\n\nexport class SQLParam<TValue> implements SQLNode {\n private readonly _value: TValue;\n private readonly _serialize: ValueSerializer<TValue>;\n\n constructor(value: TValue, serializer: ValueSerializer<TValue> = (value) => value) {\n this._value = value;\n this._serialize = serializer as ValueSerializer<TValue>;\n }\n\n private _serializeInlineParam(value: unknown, ctx: SQLContext): string {\n if (value === null) return \"null\";\n\n if (typeof value === \"number\" || typeof value === \"boolean\" || typeof value === \"bigint\") {\n return value.toString();\n }\n\n if (typeof value === \"string\") {\n return ctx.escapeValue(value);\n }\n\n if (typeof value === \"object\") {\n const str = value.toString();\n return str === \"[object Object]\"\n ? ctx.escapeValue(JSON.stringify(value))\n : ctx.escapeValue(str);\n }\n\n throw new Error(`Unsupported parameter type: ${typeof value}`);\n }\n\n toSQL(ctx: SQLContext): SQLStatement {\n const encodedValue = this._value === null ? this._value : this._serialize(this._value);\n\n if (isSQLNode(encodedValue)) {\n return encodedValue.toSQL(ctx);\n }\n\n if (ctx.inlineParams) {\n return { text: this._serializeInlineParam(encodedValue, ctx), params: [] };\n }\n\n const paramIndex = ctx.paramCounter.next();\n return { text: `$${paramIndex}`, params: [encodedValue] };\n }\n}\n\nexport class SQLWrapper implements SQLNode {\n private readonly _node: SQLNode;\n\n constructor(node: SQLNode) {\n this._node = node;\n }\n\n toSQL(ctx: SQLContext): SQLStatement {\n const contents = this._node.toSQL(ctx);\n\n return {\n text: `(${contents.text})`,\n params: contents.params,\n };\n }\n}\n\n/**\n * Renders a subtree with extra alias bindings in scope.\n *\n * Query-builder machinery, deliberately absent from the `sql` tag and the `./sql` barrel:\n * the bindings are keyed by the very node objects the builder threads through a select\n * tree, which is not knowledge a caller can be expected to have. A user-facing way to\n * alias a table in hand-written SQL is a separate thing to design.\n *\n * Scopes nest by rendering with a derived context rather than by mutating a stack, so the\n * innermost binding for a key wins. That is what lets one correlated predicate reference the\n * same table under two different aliases — wrap the outer side in its own scope and it keeps\n * the outer alias even though it is rendered inside the inner query.\n */\nexport class SQLScope implements SQLNode {\n private readonly _bindings: ReadonlyMap<unknown, string>;\n private readonly _node: SQLNode;\n\n constructor(bindings: ReadonlyMap<unknown, string>, node: SQLNode) {\n this._bindings = bindings;\n this._node = node;\n }\n\n toSQL(ctx: SQLContext): SQLStatement {\n const aliases = ctx.aliases ? new Map([...ctx.aliases, ...this._bindings]) : this._bindings;\n\n return this._node.toSQL({ ...ctx, aliases });\n }\n}\n\nexport class SQLIdentifier implements SQLNode {\n readonly name: string;\n\n constructor(name: string) {\n this.name = name;\n }\n\n toSQL(ctx: SQLContext): SQLStatement {\n return { text: ctx.escapeIdentifier(this.name), params: [] };\n }\n}\n\nexport class SQLQuery<T = unknown> implements SQLNode {\n declare __type: T;\n\n private readonly _nodes: SQLNode[] = [];\n\n constructor(nodes: SQLNode | SQLNode[] = []) {\n this._nodes = Array.isArray(nodes) ? nodes : [nodes];\n }\n\n private _mergeChunks(chunks: SQLStatement[]): SQLStatement {\n const text = chunks.map((chunk) => chunk.text).join(\"\");\n const params = chunks.flatMap((chunk) => chunk.params);\n\n return { text, params };\n }\n\n public append(...nodes: SQLNode[]): this {\n this._nodes.push(...nodes);\n return this;\n }\n\n public toQuery(ctx?: Partial<SQLContext>): SQLStatement {\n return this.toSQL({\n inlineParams: ctx?.inlineParams ?? false,\n paramCounter: ctx?.paramCounter ?? counter(),\n escapeValue: ctx?.escapeValue ?? escapeValue,\n escapeIdentifier: ctx?.escapeIdentifier ?? escapeIdentifier,\n });\n }\n\n public toSQL(ctx: SQLContext): SQLStatement {\n const chunks: SQLStatement[] = this._nodes.map((node) => node.toSQL(ctx));\n return this._mergeChunks(chunks);\n }\n}\n"]}
1
+ {"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/sql/nodes.ts"],"names":[],"mappings":"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","sourcesContent":["import { counter, escapeIdentifier, escapeValue, type ParamIndexCounter } from \"./utils.js\";\n\nexport type SQLStatement = {\n text: string;\n params: unknown[];\n};\n\nexport type SQLContext = {\n inlineParams: boolean;\n paramCounter: ParamIndexCounter;\n escapeValue(str: string): string;\n escapeIdentifier(str: string): string;\n\n /**\n * Alias bindings in effect for the subtree being rendered, set by {@link SQLScope}.\n *\n * Keys are opaque to this module — a node that wants to be referenced by an alias looks\n * itself up here and falls back to its own name when absent. Nothing in `sql/` knows what\n * the keys are, which keeps this layer independent of the runtime.\n */\n aliases?: ReadonlyMap<unknown, string>;\n\n /**\n * The per-request values {@link SQLClaim} nodes render, keyed by claim name. Absent, or\n * missing a key, renders that claim as `NULL`.\n */\n claims?: Readonly<Record<string, unknown>>;\n};\n\nexport type SQLValue = string | number | boolean | bigint | null | object;\n\nexport type ValueSerializer<T> = (value: T) => unknown;\n\nexport type SQLNode = {\n toSQL(ctx: SQLContext): SQLStatement;\n};\n\nexport const isSQLNode = (value: unknown): value is SQLNode => {\n return (\n typeof value === \"object\" &&\n value !== null &&\n \"toSQL\" in value &&\n typeof value.toSQL === \"function\"\n );\n};\n\nexport class SQLRaw implements SQLNode {\n private readonly _text: string;\n\n constructor(text: string) {\n this._text = text;\n }\n\n toSQL(): SQLStatement {\n return { text: this._text, params: [] };\n }\n}\n\nexport class SQLParam<TValue> implements SQLNode {\n private readonly _value: TValue;\n private readonly _serialize: ValueSerializer<TValue>;\n\n constructor(value: TValue, serializer: ValueSerializer<TValue> = (value) => value) {\n this._value = value;\n this._serialize = serializer as ValueSerializer<TValue>;\n }\n\n private _serializeInlineParam(value: unknown, ctx: SQLContext): string {\n if (value === null) return \"null\";\n\n if (typeof value === \"number\" || typeof value === \"boolean\" || typeof value === \"bigint\") {\n return value.toString();\n }\n\n if (typeof value === \"string\") {\n return ctx.escapeValue(value);\n }\n\n if (typeof value === \"object\") {\n const str = value.toString();\n return str === \"[object Object]\"\n ? ctx.escapeValue(JSON.stringify(value))\n : ctx.escapeValue(str);\n }\n\n throw new Error(`Unsupported parameter type: ${typeof value}`);\n }\n\n toSQL(ctx: SQLContext): SQLStatement {\n const encodedValue = this._value === null ? this._value : this._serialize(this._value);\n\n if (isSQLNode(encodedValue)) {\n return encodedValue.toSQL(ctx);\n }\n\n if (ctx.inlineParams) {\n return { text: this._serializeInlineParam(encodedValue, ctx), params: [] };\n }\n\n const paramIndex = ctx.paramCounter.next();\n return { text: `$${paramIndex}`, params: [encodedValue] };\n }\n}\n\n/**\n * A per-request value, read from {@link SQLContext.claims} when the statement is rendered and\n * bound as a parameter. Claims are typically used to represent authenticated user attributes or\n * other request-scoped metadata.\n *\n * Unset renders `NULL`, exactly as `current_setting(key, true)` does. Nothing refuses a missing\n * value: a comparison with `NULL` is never true, so a policy reading one denies by itself.\n */\nexport class SQLClaim<TValue = unknown> implements SQLNode {\n declare readonly __type: { valueType: TValue };\n\n readonly key: string;\n\n private readonly _encode: ValueSerializer<TValue>;\n\n constructor(key: string, encode: ValueSerializer<TValue> = (value) => value) {\n this.key = key;\n this._encode = encode;\n }\n\n toSQL(ctx: SQLContext): SQLStatement {\n const value = ctx.claims?.[this.key];\n\n return new SQLParam((value ?? null) as TValue, this._encode).toSQL(ctx);\n }\n}\n\nexport class SQLWrapper implements SQLNode {\n private readonly _node: SQLNode;\n\n constructor(node: SQLNode) {\n this._node = node;\n }\n\n toSQL(ctx: SQLContext): SQLStatement {\n const contents = this._node.toSQL(ctx);\n\n return {\n text: `(${contents.text})`,\n params: contents.params,\n };\n }\n}\n\n/**\n * Renders a subtree with extra alias bindings in scope.\n *\n * Query-builder machinery, deliberately absent from the `sql` tag and the `./sql` barrel:\n * the bindings are keyed by the very node objects the builder threads through a select\n * tree, which is not knowledge a caller can be expected to have. A user-facing way to\n * alias a table in hand-written SQL is a separate thing to design.\n *\n * Scopes nest by rendering with a derived context rather than by mutating a stack, so the\n * innermost binding for a key wins. That is what lets one correlated predicate reference the\n * same table under two different aliases — wrap the outer side in its own scope and it keeps\n * the outer alias even though it is rendered inside the inner query.\n */\nexport class SQLScope implements SQLNode {\n private readonly _bindings: ReadonlyMap<unknown, string>;\n private readonly _node: SQLNode;\n\n constructor(bindings: ReadonlyMap<unknown, string>, node: SQLNode) {\n this._bindings = bindings;\n this._node = node;\n }\n\n toSQL(ctx: SQLContext): SQLStatement {\n const aliases = ctx.aliases ? new Map([...ctx.aliases, ...this._bindings]) : this._bindings;\n\n return this._node.toSQL({ ...ctx, aliases });\n }\n}\n\nexport class SQLIdentifier implements SQLNode {\n readonly name: string;\n\n constructor(name: string) {\n this.name = name;\n }\n\n toSQL(ctx: SQLContext): SQLStatement {\n return { text: ctx.escapeIdentifier(this.name), params: [] };\n }\n}\n\nexport class SQLQuery<T = unknown> implements SQLNode {\n declare __type: T;\n\n private readonly _nodes: SQLNode[] = [];\n\n constructor(nodes: SQLNode | SQLNode[] = []) {\n this._nodes = Array.isArray(nodes) ? nodes : [nodes];\n }\n\n private _mergeChunks(chunks: SQLStatement[]): SQLStatement {\n const text = chunks.map((chunk) => chunk.text).join(\"\");\n const params = chunks.flatMap((chunk) => chunk.params);\n\n return { text, params };\n }\n\n public append(...nodes: SQLNode[]): this {\n this._nodes.push(...nodes);\n return this;\n }\n\n public toQuery(ctx?: Partial<SQLContext>): SQLStatement {\n return this.toSQL({\n inlineParams: ctx?.inlineParams ?? false,\n paramCounter: ctx?.paramCounter ?? counter(),\n escapeValue: ctx?.escapeValue ?? escapeValue,\n escapeIdentifier: ctx?.escapeIdentifier ?? escapeIdentifier,\n claims: ctx?.claims,\n });\n }\n\n public toSQL(ctx: SQLContext): SQLStatement {\n const chunks: SQLStatement[] = this._nodes.map((node) => node.toSQL(ctx));\n return this._mergeChunks(chunks);\n }\n}\n"]}
package/dist/sql/tag.d.ts CHANGED
@@ -1,5 +1,6 @@
1
- import { type SQLNode, SQLRaw, SQLQuery, SQLParam, SQLIdentifier, SQLWrapper, SQLValue } from "./nodes.js";
1
+ import { type SQLNode, SQLRaw, SQLQuery, SQLParam, SQLIdentifier, SQLWrapper, SQLValue, SQLClaim } from "./nodes.js";
2
2
  export declare const asNode: (value: SQLValue) => SQLNode;
3
+ export declare const escapeLike: (value: unknown) => string;
3
4
  declare function sql<T>(strings: TemplateStringsArray, ...params: any[]): SQLQuery<T>;
4
5
  declare namespace sql {
5
6
  export var raw: (text: string) => SQLRaw;
@@ -8,6 +9,7 @@ declare namespace sql {
8
9
  export var literal: (value: string) => SQLRaw;
9
10
  export var wrap: (node: SQLNode) => SQLWrapper;
10
11
  export var join: (nodes: SQLNode[], separator?: string | SQLNode) => SQLQuery<unknown>;
12
+ export var claim: <TValue extends SQLValue>(key: string, serialize?: (value: unknown) => unknown) => SQLClaim<TValue>;
11
13
  export var eq: (left: SQLNode, right: SQLValue) => SQLQuery<unknown>;
12
14
  export var ne: (left: SQLNode, right: SQLValue) => SQLQuery<unknown>;
13
15
  export var gt: (left: SQLNode, right: SQLValue) => SQLQuery<unknown>;
@@ -32,21 +34,7 @@ declare namespace sql {
32
34
  export var notInQuery: (name: string | SQLNode, query: SQLQuery) => SQLQuery<unknown>;
33
35
  export var exists: (query: SQLQuery) => SQLQuery<unknown>;
34
36
  export var notExists: (query: SQLQuery) => SQLQuery<unknown>;
35
- export var keyset: (keys: KeysetKey[], values: (string | null)[], bound: KeysetBound) => SQLNode;
36
37
  export { _a as in };
37
38
  }
38
- /** One order key of a keyset: the expression it sorts by and which way. */
39
- export type KeysetKey = {
40
- node: SQLNode;
41
- direction: "asc" | "desc";
42
- /**
43
- * Whether the key can hold `NULL`. A nullable key sorts its nulls where Postgres does by
44
- * default — last ascending, first descending — and the order it is read under must say so
45
- * explicitly (`ASC NULLS LAST`, `DESC NULLS FIRST`) for the predicate to agree with it.
46
- */
47
- nullable?: boolean;
48
- };
49
- /** Which side of the cursor row a page reads: rows sorting after it, or before it. */
50
- export type KeysetBound = "after" | "before";
51
39
  export { sql };
52
40
  //# sourceMappingURL=tag.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/sql/tag.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EAER,aAAa,EACb,UAAU,EACV,QAAQ,EACT,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,MAAM,GAAI,OAAO,QAAQ,KAAG,OAMxC,CAAC;AAGF,iBAAS,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;kBAArE,GAAG;2BAgBK,MAAM;uBACV,MAAM,SAAS,QAAQ,SAAS,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM;kCAElE,MAAM;gCAMR,MAAM;4BACV,OAAO;6BAEN,OAAO,EAAE,cAAa,MAAM,GAAG,OAAO;0BAczC,OAAO,SAAS,QAAQ;0BAIxB,OAAO,SAAS,QAAQ;0BAIxB,OAAO,SAAS,QAAQ;0BAIxB,OAAO,SAAS,QAAQ;2BAIvB,OAAO,SAAS,QAAQ;2BAIxB,OAAO,SAAS,QAAQ;iCAIlB,OAAO,EAAE;gCAIV,OAAO,EAAE;gCAIT,OAAO;8BAIT,OAAO;iCAIJ,OAAO;4BAIZ,OAAO,WAAW,QAAQ;+BAIvB,OAAO,WAAW,QAAQ;6BAI5B,OAAO,WAAW,QAAQ;gCAIvB,OAAO,WAAW,QAAQ;qCASrB,OAAO,SAAS,QAAQ;mCAK1B,OAAO,OAAO,QAAQ;+BAI1B,OAAO,SAAS,QAAQ,SAAS,QAAQ;mBAM9C,MAAM,GAAG,OAAO,UAAU,QAAQ,EAAE;6BAMjC,MAAM,GAAG,OAAO,UAAU,QAAQ,EAAE;+BAMlC,MAAM,GAAG,OAAO,SAAS,QAAQ;kCAK9B,MAAM,GAAG,OAAO,SAAS,QAAQ;+BAKpC,QAAQ;kCAIL,QAAQ;8BA4CZ,SAAS,EAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,SAAS,WAAW,KAAG,OAAO;;;AAxCxF,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAyF7C,OAAO,EAAE,GAAG,EAAE,CAAC"}
1
+ {"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/sql/tag.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EAER,aAAa,EACb,UAAU,EACV,QAAQ,EACR,QAAQ,EACT,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,MAAM,GAAI,OAAO,QAAQ,KAAG,OAMxC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,MAE3C,CAAC;AAGF,iBAAS,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;kBAArE,GAAG;2BAgBK,MAAM;uBACV,MAAM,SAAS,QAAQ,SAAS,MAAM,cAAc,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM;kCAElE,MAAM;gCAMR,MAAM;4BACV,OAAO;6BAEN,OAAO,EAAE,cAAa,MAAM,GAAG,OAAO;uBAc5C,MAAM,SAAS,QAAQ,OAAO,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO;0BAG1E,OAAO,SAAS,QAAQ;0BAIxB,OAAO,SAAS,QAAQ;0BAIxB,OAAO,SAAS,QAAQ;0BAIxB,OAAO,SAAS,QAAQ;2BAIvB,OAAO,SAAS,QAAQ;2BAIxB,OAAO,SAAS,QAAQ;iCAIlB,OAAO,EAAE;gCAIV,OAAO,EAAE;gCAIT,OAAO;8BAIT,OAAO;iCAIJ,OAAO;4BAIZ,OAAO,WAAW,QAAQ;+BAIvB,OAAO,WAAW,QAAQ;6BAI5B,OAAO,WAAW,QAAQ;gCAIvB,OAAO,WAAW,QAAQ;qCASrB,OAAO,SAAS,QAAQ;mCAK1B,OAAO,OAAO,QAAQ;+BAI1B,OAAO,SAAS,QAAQ,SAAS,QAAQ;mBAM9C,MAAM,GAAG,OAAO,UAAU,QAAQ,EAAE;6BAMjC,MAAM,GAAG,OAAO,UAAU,QAAQ,EAAE;+BAMlC,MAAM,GAAG,OAAO,SAAS,QAAQ;kCAK9B,MAAM,GAAG,OAAO,SAAS,QAAQ;+BAKpC,QAAQ;kCAIL,QAAQ;;;AAIhC,OAAO,EAAE,GAAG,EAAE,CAAC"}
package/dist/sql/tag.js CHANGED
@@ -1,4 +1,4 @@
1
- import { SQLRaw, SQLQuery, SQLParam, isSQLNode, SQLIdentifier, SQLWrapper, } from "./nodes.js";
1
+ import { SQLRaw, SQLQuery, SQLParam, isSQLNode, SQLIdentifier, SQLWrapper, SQLClaim, } from "./nodes.js";
2
2
  import { escapeValue } from "./utils.js";
3
3
  export const asNode = (value) => {
4
4
  if (isSQLNode(value)) {
@@ -8,6 +8,9 @@ export const asNode = (value) => {
8
8
  return new SQLParam(value);
9
9
  }
10
10
  };
11
+ export const escapeLike = (value) => {
12
+ return String(value).replace(/[\\%_]/g, "\\$&");
13
+ };
11
14
  function sql(strings, ...params) {
12
15
  const node = new SQLQuery();
13
16
  if (params.length > 0 || (strings.length > 0 && strings[0] !== "")) {
@@ -39,6 +42,7 @@ sql.join = (nodes, separator = " ") => {
39
42
  }
40
43
  return node;
41
44
  };
45
+ sql.claim = (key, serialize) => new SQLClaim(key, serialize);
42
46
  sql.eq = (left, right) => {
43
47
  return sql.join([left, sql.raw("="), asNode(right)]);
44
48
  };
@@ -127,75 +131,5 @@ sql.exists = (query) => {
127
131
  sql.notExists = (query) => {
128
132
  return sql `NOT EXISTS ${sql.wrap(query)}`;
129
133
  };
130
- /**
131
- * The predicate selecting every row that sorts strictly after (or before) a cursor row, under
132
- * the total order `keys`.
133
- *
134
- * Expanded key by key — `k0 > $a OR (k0 = $a AND (k1 > $b OR ...))` — rather than written as a
135
- * row-value comparison, so mixed directions and nullable keys need no special case and nothing
136
- * depends on DSQL supporting `(a, b) > ($1, $2)`.
137
- *
138
- * `values` are the database's own text for each key, bound as bare parameters: the server
139
- * parses them against the column's type, so no codec may touch them. A codec that decodes to a
140
- * JS value can lose precision (a `Date` has milliseconds, a `timestamptz` microseconds), and a
141
- * cursor rebuilt from the lossy value skips rows. A `null` value is only valid for a nullable key.
142
- *
143
- * Per key, in the direction of travel (`before` reads every direction flipped, and flipping an
144
- * order also flips where its nulls sort, so the table holds for both bounds):
145
- *
146
- * | travelling | cursor value | strictly past it | tied with it |
147
- * | ---------- | ------------ | -------------------------- | ------------- |
148
- * | ascending | `v` | `k > v`, or `k IS NULL`\* | `k = v` |
149
- * | ascending | `NULL` | nothing (nulls are last) | `k IS NULL` |
150
- * | descending | `v` | `k < v` | `k = v` |
151
- * | descending | `NULL` | `k IS NOT NULL`\* | `k IS NULL` |
152
- *
153
- * \* nullable keys only.
154
- */
155
- sql.keyset = (keys, values, bound) => {
156
- if (keys.length === 0) {
157
- throw new Error("A keyset needs at least one order key.");
158
- }
159
- if (keys.length !== values.length) {
160
- throw new Error(`A keyset pairs every key with one value (got ${keys.length} keys, ${values.length} values).`);
161
- }
162
- for (const [index, key] of keys.entries()) {
163
- if (!key.nullable && (values[index] === null || values[index] === undefined)) {
164
- throw new Error(`Keyset value ${index} is null, but its key is not nullable.`);
165
- }
166
- }
167
- /** The conditions a row satisfies when it sorts strictly past the cursor on key `index`. */
168
- const past = (index) => {
169
- const { node, direction, nullable } = keys[index];
170
- const value = values[index];
171
- const ascending = (direction === "asc") === (bound === "after");
172
- if (value === null) {
173
- return ascending ? [] : [sql.isNotNull(node)];
174
- }
175
- if (!ascending) {
176
- return [sql.lt(node, value)];
177
- }
178
- return nullable ? [sql.gt(node, value), sql.isNull(node)] : [sql.gt(node, value)];
179
- };
180
- const tie = (index) => values[index] === null ? sql.isNull(keys[index].node) : sql.eq(keys[index].node, values[index]);
181
- // Built from the last key outwards, so each level wraps the one after it. `inner` is the
182
- // predicate for the keys after this one; `undefined` means no row can satisfy it.
183
- let inner;
184
- let innerIsOr = false;
185
- for (let index = keys.length - 1; index >= 0; index--) {
186
- const terms = past(index);
187
- if (inner) {
188
- // An `OR` below needs parentheses to keep its precedence inside this `AND`.
189
- const tied = sql.and([tie(index), innerIsOr ? sql.wrap(inner) : inner]);
190
- // Alone, the tie needs none: it is an `AND` joining whatever `AND` sits above it.
191
- terms.push(terms.length > 0 ? sql.wrap(tied) : tied);
192
- }
193
- inner = terms.length === 0 ? undefined : terms.length === 1 ? terms[0] : sql.or(terms);
194
- innerIsOr = terms.length > 1;
195
- }
196
- // Nothing can sort past the cursor — only possible when the last key is a nullable one read
197
- // ascending from a null. A primary key, which every page ends on, is never nullable.
198
- return inner ?? sql.raw("FALSE");
199
- };
200
134
  export { sql };
201
135
  //# sourceMappingURL=tag.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"tag.js","sourceRoot":"","sources":["../../src/sql/tag.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n type SQLNode,\n SQLRaw,\n SQLQuery,\n SQLParam,\n isSQLNode,\n SQLIdentifier,\n SQLWrapper,\n SQLValue,\n} from \"./nodes.js\";\nimport { escapeValue } from \"./utils.js\";\n\nexport const asNode = (value: SQLValue): SQLNode => {\n if (isSQLNode(value)) {\n return value;\n } else {\n return new SQLParam(value);\n }\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction sql<T>(strings: TemplateStringsArray, ...params: any[]): SQLQuery<T>;\nfunction sql(strings: TemplateStringsArray, ...params: SQLNode[]): SQLQuery {\n const node = new SQLQuery();\n\n if (params.length > 0 || (strings.length > 0 && strings[0] !== \"\")) {\n node.append(new SQLRaw(strings[0]));\n }\n\n for (const [paramIndex, param] of params.entries()) {\n node.append(isSQLNode(param) ? param : new SQLParam(param));\n node.append(new SQLRaw(strings[paramIndex + 1]));\n }\n\n return node;\n}\n\nsql.raw = (text: string) => new SQLRaw(text);\nsql.param = <TValue extends SQLValue>(value: TValue, serialize?: (value: TValue) => TValue) =>\n new SQLParam<TValue>(value, serialize);\nsql.identifier = (name: string) => new SQLIdentifier(name);\n/**\n * A string written into the statement as a quoted literal rather than bound as a parameter.\n * For values the schema owns — a union member's alias projected as its `$$key` — never for\n * anything a caller passed in: a literal is part of the query text, a parameter is not.\n */\nsql.literal = (value: string) => new SQLRaw(escapeValue(value));\nsql.wrap = (node: SQLNode) => new SQLWrapper(node);\n\nsql.join = (nodes: SQLNode[], separator: string | SQLNode = \" \") => {\n const node = new SQLQuery();\n\n for (const [index, childNode] of nodes.entries()) {\n if (index > 0) {\n node.append(typeof separator === \"string\" ? new SQLRaw(separator) : separator);\n }\n\n node.append(childNode);\n }\n\n return node;\n};\n\nsql.eq = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\"=\"), asNode(right)]);\n};\n\nsql.ne = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\"<>\"), asNode(right)]);\n};\n\nsql.gt = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\">\"), asNode(right)]);\n};\n\nsql.lt = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\"<\"), asNode(right)]);\n};\n\nsql.gte = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\">=\"), asNode(right)]);\n};\n\nsql.lte = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\"<=\"), asNode(right)]);\n};\n\nsql.and = (conditions: SQLNode[]) => {\n return sql.join(conditions, sql.raw(\" AND \"));\n};\n\nsql.or = (conditions: SQLNode[]) => {\n return sql.join(conditions, sql.raw(\" OR \"));\n};\n\nsql.not = (condition: SQLNode) => {\n return sql.join([sql.raw(\"NOT\"), sql.wrap(condition)]);\n};\n\nsql.isNull = (node: SQLNode) => {\n return sql.join([node, sql.raw(\"IS NULL\")]);\n};\n\nsql.isNotNull = (node: SQLNode) => {\n return sql.join([node, sql.raw(\"IS NOT NULL\")]);\n};\n\nsql.like = (node: SQLNode, pattern: SQLValue) => {\n return sql.join([node, sql.raw(\"LIKE\"), asNode(pattern)]);\n};\n\nsql.notLike = (node: SQLNode, pattern: SQLValue) => {\n return sql.join([node, sql.raw(\"NOT LIKE\"), asNode(pattern)]);\n};\n\nsql.iLike = (node: SQLNode, pattern: SQLValue) => {\n return sql.join([node, sql.raw(\"ILIKE\"), asNode(pattern)]);\n};\n\nsql.notILike = (node: SQLNode, pattern: SQLValue) => {\n return sql.join([node, sql.raw(\"NOT ILIKE\"), asNode(pattern)]);\n};\n\n/**\n * `jsonb` containment, `node @> value`: the document holds `value`, matched recursively — objects\n * by the keys `value` names, arrays as a subset in any order. `value` is the JSON text of a\n * fragment.\n */\nsql.jsonbContains = (node: SQLNode, value: SQLValue) => {\n return sql.join([node, sql.raw(\"@>\"), asNode(value)]);\n};\n\n/** `jsonb` key existence, `node ? key`: the object has `key` at its top level. */\nsql.jsonbHasKey = (node: SQLNode, key: SQLValue) => {\n return sql.join([node, sql.raw(\"?\"), asNode(key)]);\n};\n\nsql.between = (node: SQLNode, lower: SQLValue, upper: SQLValue) => {\n return sql.join([node, sql.raw(\"BETWEEN\"), asNode(lower), sql.raw(\"AND\"), asNode(upper)]);\n};\n\n// An empty list has no SQL form — `IN ()` is a syntax error — so it renders as the answer:\n// nothing is in an empty list, everything is outside it.\nsql.in = (name: string | SQLNode, values: SQLValue[]) => {\n if (values.length === 0) return sql`FALSE`;\n const identifier = typeof name === \"string\" ? new SQLIdentifier(name) : name;\n return sql`${identifier} IN ${sql.wrap(sql.join(values.map(asNode), \", \"))}`;\n};\n\nsql.notIn = (name: string | SQLNode, values: SQLValue[]) => {\n if (values.length === 0) return sql`TRUE`;\n const identifier = typeof name === \"string\" ? new SQLIdentifier(name) : name;\n return sql`${identifier} NOT IN ${sql.wrap(sql.join(values.map(asNode), \", \"))}`;\n};\n\nsql.inQuery = (name: string | SQLNode, query: SQLQuery) => {\n const identifier = typeof name === \"string\" ? new SQLIdentifier(name) : name;\n return sql`${identifier} IN ${sql.wrap(query)}`;\n};\n\nsql.notInQuery = (name: string | SQLNode, query: SQLQuery) => {\n const identifier = typeof name === \"string\" ? new SQLIdentifier(name) : name;\n return sql`${identifier} NOT IN ${sql.wrap(query)}`;\n};\n\nsql.exists = (query: SQLQuery) => {\n return sql`EXISTS ${sql.wrap(query)}`;\n};\n\nsql.notExists = (query: SQLQuery) => {\n return sql`NOT EXISTS ${sql.wrap(query)}`;\n};\n\n/** One order key of a keyset: the expression it sorts by and which way. */\nexport type KeysetKey = {\n node: SQLNode;\n direction: \"asc\" | \"desc\";\n /**\n * Whether the key can hold `NULL`. A nullable key sorts its nulls where Postgres does by\n * default — last ascending, first descending — and the order it is read under must say so\n * explicitly (`ASC NULLS LAST`, `DESC NULLS FIRST`) for the predicate to agree with it.\n */\n nullable?: boolean;\n};\n\n/** Which side of the cursor row a page reads: rows sorting after it, or before it. */\nexport type KeysetBound = \"after\" | \"before\";\n\n/**\n * The predicate selecting every row that sorts strictly after (or before) a cursor row, under\n * the total order `keys`.\n *\n * Expanded key by key — `k0 > $a OR (k0 = $a AND (k1 > $b OR ...))` — rather than written as a\n * row-value comparison, so mixed directions and nullable keys need no special case and nothing\n * depends on DSQL supporting `(a, b) > ($1, $2)`.\n *\n * `values` are the database's own text for each key, bound as bare parameters: the server\n * parses them against the column's type, so no codec may touch them. A codec that decodes to a\n * JS value can lose precision (a `Date` has milliseconds, a `timestamptz` microseconds), and a\n * cursor rebuilt from the lossy value skips rows. A `null` value is only valid for a nullable key.\n *\n * Per key, in the direction of travel (`before` reads every direction flipped, and flipping an\n * order also flips where its nulls sort, so the table holds for both bounds):\n *\n * | travelling | cursor value | strictly past it | tied with it |\n * | ---------- | ------------ | -------------------------- | ------------- |\n * | ascending | `v` | `k > v`, or `k IS NULL`\\* | `k = v` |\n * | ascending | `NULL` | nothing (nulls are last) | `k IS NULL` |\n * | descending | `v` | `k < v` | `k = v` |\n * | descending | `NULL` | `k IS NOT NULL`\\* | `k IS NULL` |\n *\n * \\* nullable keys only.\n */\nsql.keyset = (keys: KeysetKey[], values: (string | null)[], bound: KeysetBound): SQLNode => {\n if (keys.length === 0) {\n throw new Error(\"A keyset needs at least one order key.\");\n }\n\n if (keys.length !== values.length) {\n throw new Error(\n `A keyset pairs every key with one value (got ${keys.length} keys, ${values.length} values).`\n );\n }\n\n for (const [index, key] of keys.entries()) {\n if (!key.nullable && (values[index] === null || values[index] === undefined)) {\n throw new Error(`Keyset value ${index} is null, but its key is not nullable.`);\n }\n }\n\n /** The conditions a row satisfies when it sorts strictly past the cursor on key `index`. */\n const past = (index: number): SQLNode[] => {\n const { node, direction, nullable } = keys[index];\n const value = values[index];\n const ascending = (direction === \"asc\") === (bound === \"after\");\n\n if (value === null) {\n return ascending ? [] : [sql.isNotNull(node)];\n }\n\n if (!ascending) {\n return [sql.lt(node, value)];\n }\n\n return nullable ? [sql.gt(node, value), sql.isNull(node)] : [sql.gt(node, value)];\n };\n\n const tie = (index: number) =>\n values[index] === null ? sql.isNull(keys[index].node) : sql.eq(keys[index].node, values[index]);\n\n // Built from the last key outwards, so each level wraps the one after it. `inner` is the\n // predicate for the keys after this one; `undefined` means no row can satisfy it.\n let inner: SQLNode | undefined;\n let innerIsOr = false;\n\n for (let index = keys.length - 1; index >= 0; index--) {\n const terms = past(index);\n\n if (inner) {\n // An `OR` below needs parentheses to keep its precedence inside this `AND`.\n const tied = sql.and([tie(index), innerIsOr ? sql.wrap(inner) : inner]);\n\n // Alone, the tie needs none: it is an `AND` joining whatever `AND` sits above it.\n terms.push(terms.length > 0 ? sql.wrap(tied) : tied);\n }\n\n inner = terms.length === 0 ? undefined : terms.length === 1 ? terms[0] : sql.or(terms);\n innerIsOr = terms.length > 1;\n }\n\n // Nothing can sort past the cursor — only possible when the last key is a nullable one read\n // ascending from a null. A primary key, which every page ends on, is never nullable.\n return inner ?? sql.raw(\"FALSE\");\n};\n\nexport { sql };\n"]}
1
+ {"version":3,"file":"tag.js","sourceRoot":"","sources":["../../src/sql/tag.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n type SQLNode,\n SQLRaw,\n SQLQuery,\n SQLParam,\n isSQLNode,\n SQLIdentifier,\n SQLWrapper,\n SQLValue,\n SQLClaim,\n} from \"./nodes.js\";\nimport { escapeValue } from \"./utils.js\";\n\nexport const asNode = (value: SQLValue): SQLNode => {\n if (isSQLNode(value)) {\n return value;\n } else {\n return new SQLParam(value);\n }\n};\n\nexport const escapeLike = (value: unknown): string => {\n return String(value).replace(/[\\\\%_]/g, \"\\\\$&\");\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction sql<T>(strings: TemplateStringsArray, ...params: any[]): SQLQuery<T>;\nfunction sql(strings: TemplateStringsArray, ...params: SQLNode[]): SQLQuery {\n const node = new SQLQuery();\n\n if (params.length > 0 || (strings.length > 0 && strings[0] !== \"\")) {\n node.append(new SQLRaw(strings[0]));\n }\n\n for (const [paramIndex, param] of params.entries()) {\n node.append(isSQLNode(param) ? param : new SQLParam(param));\n node.append(new SQLRaw(strings[paramIndex + 1]));\n }\n\n return node;\n}\n\nsql.raw = (text: string) => new SQLRaw(text);\nsql.param = <TValue extends SQLValue>(value: TValue, serialize?: (value: TValue) => TValue) =>\n new SQLParam<TValue>(value, serialize);\nsql.identifier = (name: string) => new SQLIdentifier(name);\n/**\n * A string written into the statement as a quoted literal rather than bound as a parameter.\n * For values the schema owns — a union member's alias projected as its `$$key` — never for\n * anything a caller passed in: a literal is part of the query text, a parameter is not.\n */\nsql.literal = (value: string) => new SQLRaw(escapeValue(value));\nsql.wrap = (node: SQLNode) => new SQLWrapper(node);\n\nsql.join = (nodes: SQLNode[], separator: string | SQLNode = \" \") => {\n const node = new SQLQuery();\n\n for (const [index, childNode] of nodes.entries()) {\n if (index > 0) {\n node.append(typeof separator === \"string\" ? new SQLRaw(separator) : separator);\n }\n\n node.append(childNode);\n }\n\n return node;\n};\n\nsql.claim = <TValue extends SQLValue>(key: string, serialize?: (value: unknown) => unknown) =>\n new SQLClaim<TValue>(key, serialize);\n\nsql.eq = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\"=\"), asNode(right)]);\n};\n\nsql.ne = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\"<>\"), asNode(right)]);\n};\n\nsql.gt = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\">\"), asNode(right)]);\n};\n\nsql.lt = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\"<\"), asNode(right)]);\n};\n\nsql.gte = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\">=\"), asNode(right)]);\n};\n\nsql.lte = (left: SQLNode, right: SQLValue) => {\n return sql.join([left, sql.raw(\"<=\"), asNode(right)]);\n};\n\nsql.and = (conditions: SQLNode[]) => {\n return sql.join(conditions, sql.raw(\" AND \"));\n};\n\nsql.or = (conditions: SQLNode[]) => {\n return sql.join(conditions, sql.raw(\" OR \"));\n};\n\nsql.not = (condition: SQLNode) => {\n return sql.join([sql.raw(\"NOT\"), sql.wrap(condition)]);\n};\n\nsql.isNull = (node: SQLNode) => {\n return sql.join([node, sql.raw(\"IS NULL\")]);\n};\n\nsql.isNotNull = (node: SQLNode) => {\n return sql.join([node, sql.raw(\"IS NOT NULL\")]);\n};\n\nsql.like = (node: SQLNode, pattern: SQLValue) => {\n return sql.join([node, sql.raw(\"LIKE\"), asNode(pattern)]);\n};\n\nsql.notLike = (node: SQLNode, pattern: SQLValue) => {\n return sql.join([node, sql.raw(\"NOT LIKE\"), asNode(pattern)]);\n};\n\nsql.iLike = (node: SQLNode, pattern: SQLValue) => {\n return sql.join([node, sql.raw(\"ILIKE\"), asNode(pattern)]);\n};\n\nsql.notILike = (node: SQLNode, pattern: SQLValue) => {\n return sql.join([node, sql.raw(\"NOT ILIKE\"), asNode(pattern)]);\n};\n\n/**\n * `jsonb` containment, `node @> value`: the document holds `value`, matched recursively — objects\n * by the keys `value` names, arrays as a subset in any order. `value` is the JSON text of a\n * fragment.\n */\nsql.jsonbContains = (node: SQLNode, value: SQLValue) => {\n return sql.join([node, sql.raw(\"@>\"), asNode(value)]);\n};\n\n/** `jsonb` key existence, `node ? key`: the object has `key` at its top level. */\nsql.jsonbHasKey = (node: SQLNode, key: SQLValue) => {\n return sql.join([node, sql.raw(\"?\"), asNode(key)]);\n};\n\nsql.between = (node: SQLNode, lower: SQLValue, upper: SQLValue) => {\n return sql.join([node, sql.raw(\"BETWEEN\"), asNode(lower), sql.raw(\"AND\"), asNode(upper)]);\n};\n\n// An empty list has no SQL form — `IN ()` is a syntax error — so it renders as the answer:\n// nothing is in an empty list, everything is outside it.\nsql.in = (name: string | SQLNode, values: SQLValue[]) => {\n if (values.length === 0) return sql`FALSE`;\n const identifier = typeof name === \"string\" ? new SQLIdentifier(name) : name;\n return sql`${identifier} IN ${sql.wrap(sql.join(values.map(asNode), \", \"))}`;\n};\n\nsql.notIn = (name: string | SQLNode, values: SQLValue[]) => {\n if (values.length === 0) return sql`TRUE`;\n const identifier = typeof name === \"string\" ? new SQLIdentifier(name) : name;\n return sql`${identifier} NOT IN ${sql.wrap(sql.join(values.map(asNode), \", \"))}`;\n};\n\nsql.inQuery = (name: string | SQLNode, query: SQLQuery) => {\n const identifier = typeof name === \"string\" ? new SQLIdentifier(name) : name;\n return sql`${identifier} IN ${sql.wrap(query)}`;\n};\n\nsql.notInQuery = (name: string | SQLNode, query: SQLQuery) => {\n const identifier = typeof name === \"string\" ? new SQLIdentifier(name) : name;\n return sql`${identifier} NOT IN ${sql.wrap(query)}`;\n};\n\nsql.exists = (query: SQLQuery) => {\n return sql`EXISTS ${sql.wrap(query)}`;\n};\n\nsql.notExists = (query: SQLQuery) => {\n return sql`NOT EXISTS ${sql.wrap(query)}`;\n};\n\nexport { sql };\n"]}
@@ -1,3 +1,3 @@
1
1
  export { Thenable } from "./thenable.js";
2
- export type { Generated, HasDefault, Identity, NotNull, Optional, Prettify, PrimaryKey, ReadOnly, Deprecated, TenantKey, TypedObject, Unique, UnionToIntersection, ValueType, WithDomain, WithMeta, WithNamespace, } from "./types.js";
2
+ export type { Generated, HasDefault, Identity, NotNull, Optional, Prettify, PrimaryKey, ReadOnly, Deprecated, TypedObject, Unique, UnionToIntersection, ValueType, WithDomain, WithMeta, WithNamespace, } from "./types.js";
3
3
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EACX,MAAM,EACN,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,GACd,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,MAAM,EACN,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,GACd,MAAM,YAAY,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC","sourcesContent":["export { Thenable } from \"./thenable.js\";\nexport type {\n Generated,\n HasDefault,\n Identity,\n NotNull,\n Optional,\n Prettify,\n PrimaryKey,\n ReadOnly,\n Deprecated,\n TenantKey,\n TypedObject,\n Unique,\n UnionToIntersection,\n ValueType,\n WithDomain,\n WithMeta,\n WithNamespace,\n} from \"./types.js\";\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC","sourcesContent":["export { Thenable } from \"./thenable.js\";\nexport type {\n Generated,\n HasDefault,\n Identity,\n NotNull,\n Optional,\n Prettify,\n PrimaryKey,\n ReadOnly,\n Deprecated,\n TypedObject,\n Unique,\n UnionToIntersection,\n ValueType,\n WithDomain,\n WithMeta,\n WithNamespace,\n} from \"./types.js\";\n"]}
@@ -7,10 +7,8 @@ export type Optional<T, K extends keyof T> = {
7
7
  /**
8
8
  * Collapses a union of object types into their intersection.
9
9
  *
10
- * Used to gather one claim object out of the per-table claim objects a schema yields: a table
11
- * with no claims contributes `{}` and drops out, and two tables declaring the same claim with
12
- * different value types collapse it to `never`, which is the type-level mirror of the
13
- * registry's data-type check.
10
+ * A member contributing `{}` drops out; two members giving one key different types collapse
11
+ * it to `never`.
14
12
  */
15
13
  export type UnionToIntersection<T> = (T extends unknown ? (arg: T) => void : never) extends (arg: infer I) => void ? I : never;
16
14
  export type TypedObject<T = unknown> = {
@@ -55,16 +53,6 @@ export type Deprecated<T extends TypedObject> = T & {
55
53
  deprecated: true;
56
54
  };
57
55
  };
58
- /**
59
- * Marks a column as a tenant claim key: the runtime fills it on insert and filters every read
60
- * by it, from the identity on the execution context. Always set together with {@link ReadOnly},
61
- * and only by `tenantScope()` — there is no public builder for it.
62
- */
63
- export type TenantKey<T extends TypedObject> = T & {
64
- __type: {
65
- tenantKey: true;
66
- };
67
- };
68
56
  /** Narrows what a column reads and writes to one type — `$type<T>()`. */
69
57
  export type ValueType<T extends TypedObject, TValue> = T & {
70
58
  __type: {
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Prettify<T extends object> = {\n [K in keyof T]: T[K];\n} & {};\n\nexport type Optional<T, K extends keyof T> = {\n [P in K]?: T[P];\n} & Omit<T, K>;\n\n/**\n * Collapses a union of object types into their intersection.\n *\n * Used to gather one claim object out of the per-table claim objects a schema yields: a table\n * with no claims contributes `{}` and drops out, and two tables declaring the same claim with\n * different value types collapse it to `never`, which is the type-level mirror of the\n * registry's data-type check.\n */\nexport type UnionToIntersection<T> = (T extends unknown ? (arg: T) => void : never) extends (\n arg: infer I\n) => void\n ? I\n : never;\n\nexport type TypedObject<T = unknown> = {\n readonly __type: T;\n};\n\nexport type NotNull<T extends TypedObject> = T & { __type: { notNull: true } };\n\nexport type PrimaryKey<T extends TypedObject> = T & {\n __type: { primaryKey: true; notNull: true };\n};\n\nexport type Unique<T extends TypedObject> = T & {\n __type: { unique: true };\n};\n\nexport type HasDefault<T extends TypedObject> = T & {\n __type: { hasDefault: true };\n};\n\n/**\n * Marks a column as system-managed: readable, selectable, filterable and orderable, but never\n * written through `create` or `update`. The value comes from the runtime, not from the caller.\n */\nexport type ReadOnly<T extends TypedObject> = T & {\n __type: { readOnly: true };\n};\n\n/**\n * Marks a column as deprecated: kept in the database until a later release removes it, but gone\n * from the client — not selectable, filterable, orderable or writable.\n */\nexport type Deprecated<T extends TypedObject> = T & {\n __type: { deprecated: true };\n};\n\n/**\n * Marks a column as a tenant claim key: the runtime fills it on insert and filters every read\n * by it, from the identity on the execution context. Always set together with {@link ReadOnly},\n * and only by `tenantScope()` — there is no public builder for it.\n */\nexport type TenantKey<T extends TypedObject> = T & {\n __type: { tenantKey: true };\n};\n\n/** Narrows what a column reads and writes to one type — `$type<T>()`. */\nexport type ValueType<T extends TypedObject, TValue> = T & {\n __type: { valueType: TValue; inputType: TValue };\n};\n\nexport type Generated<T extends TypedObject, TGeneration> = T & {\n __type: { generated: TGeneration };\n};\n\nexport type Identity<T extends TypedObject, TOptions> = T & {\n __type: {\n notNull: true;\n hasDefault: true;\n identity: TOptions;\n };\n};\n\nexport type WithNamespace<T extends TypedObject, TSchema extends TypedObject> = T & {\n __type: { namespace: TSchema };\n};\n\nexport type WithDomain<T extends TypedObject, TDomain extends TypedObject> = T & {\n __type: { domain: TDomain };\n};\n\n/**\n * Attaches arbitrary per-table metadata to a definition's `__type`, so `table().meta({ … })`\n * is visible to the result types (`$$meta` on every row).\n */\nexport type WithMeta<T extends TypedObject, TMeta> = T & { __type: { meta: TMeta } };\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"","sourcesContent":["export type Prettify<T extends object> = {\n [K in keyof T]: T[K];\n} & {};\n\nexport type Optional<T, K extends keyof T> = {\n [P in K]?: T[P];\n} & Omit<T, K>;\n\n/**\n * Collapses a union of object types into their intersection.\n *\n * A member contributing `{}` drops out; two members giving one key different types collapse\n * it to `never`.\n */\nexport type UnionToIntersection<T> = (T extends unknown ? (arg: T) => void : never) extends (\n arg: infer I\n) => void\n ? I\n : never;\n\nexport type TypedObject<T = unknown> = {\n readonly __type: T;\n};\n\nexport type NotNull<T extends TypedObject> = T & { __type: { notNull: true } };\n\nexport type PrimaryKey<T extends TypedObject> = T & {\n __type: { primaryKey: true; notNull: true };\n};\n\nexport type Unique<T extends TypedObject> = T & {\n __type: { unique: true };\n};\n\nexport type HasDefault<T extends TypedObject> = T & {\n __type: { hasDefault: true };\n};\n\n/**\n * Marks a column as system-managed: readable, selectable, filterable and orderable, but never\n * written through `create` or `update`. The value comes from the runtime, not from the caller.\n */\nexport type ReadOnly<T extends TypedObject> = T & {\n __type: { readOnly: true };\n};\n\n/**\n * Marks a column as deprecated: kept in the database until a later release removes it, but gone\n * from the client — not selectable, filterable, orderable or writable.\n */\nexport type Deprecated<T extends TypedObject> = T & {\n __type: { deprecated: true };\n};\n\n/** Narrows what a column reads and writes to one type — `$type<T>()`. */\nexport type ValueType<T extends TypedObject, TValue> = T & {\n __type: { valueType: TValue; inputType: TValue };\n};\n\nexport type Generated<T extends TypedObject, TGeneration> = T & {\n __type: { generated: TGeneration };\n};\n\nexport type Identity<T extends TypedObject, TOptions> = T & {\n __type: {\n notNull: true;\n hasDefault: true;\n identity: TOptions;\n };\n};\n\nexport type WithNamespace<T extends TypedObject, TSchema extends TypedObject> = T & {\n __type: { namespace: TSchema };\n};\n\nexport type WithDomain<T extends TypedObject, TDomain extends TypedObject> = T & {\n __type: { domain: TDomain };\n};\n\n/**\n * Attaches arbitrary per-table metadata to a definition's `__type`, so `table().meta({ … })`\n * is visible to the result types (`$$meta` on every row).\n */\nexport type WithMeta<T extends TypedObject, TMeta> = T & { __type: { meta: TMeta } };\n"]}