@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 +1 @@
1
- {"version":3,"file":"relations.js","sourceRoot":"","sources":["../../src/definition/relations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,IAAI,EAAgB,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAuC,eAAe,EAAE,MAAM,YAAY,CAAC;AAkDlF,MAAM,OAAO,mBAGX,SAAQ,cAAuF;IAC/E,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;IAE7B,KAAK,CAAS;IACd,SAAS,CAAa;IAE/B,YAAY,KAAa,EAAE,SAAqB;QAC9C,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,YAAY,CAAC,CAAC;QAEjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;gBACrB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;aACtB;YACD,SAAS,EAAE,MAAM,CAAC,WAAW,CAC3B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACvD,IAAI;gBACJ;oBACE,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,MAAM,EACJ,QAAQ,CAAC,MAAM,YAAY,eAAe;wBACxC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;wBAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;oBAChE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;oBACrC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC5B,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC;wBAC/B,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;4BACpD,KAAK;4BACL,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;yBAC1B,CAAC,CACH;oBACL,GAAG,CAAC,QAAQ,CAAC,aAAa,IAAI;wBAC5B,aAAa,EAAE,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC;qBACpD,CAAC;iBACM;aACX,CAAC,CACH;SACO,CAAC;IACb,CAAC;CACF;AAED,SAAS,YAAY,CAAC,MAAsB;IAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC","sourcesContent":["import { DefinitionNode, Kind, RelationType } from \"./base.js\";\nimport { AnyTableDefinition } from \"./table.js\";\nimport { AnyUnionDefinition, AnyUnionMembers, UnionDefinition } from \"./union.js\";\n\nexport type TableDefinitionColumn<TTable extends AnyTableDefinition> = {\n [K in keyof TTable[\"__type\"][\"columns\"]]: TTable[\"__type\"][\"columns\"][K];\n}[keyof TTable[\"__type\"][\"columns\"]];\n\n/** What a relation can point at: one table, or a union of tables. */\nexport type AnyRelationTarget = AnyTableDefinition | AnyUnionDefinition;\n\n/**\n * The `to` side of a relation to a union: either shared fields taken from `union.columns`,\n * which resolve to each member's own column, or one column list per member for members that\n * store the key under different fields.\n */\nexport type UnionTargetColumns<TMembers extends AnyUnionMembers> =\n | UnionDefinition<TMembers>[\"columns\"][keyof UnionDefinition<TMembers>[\"columns\"]][]\n | { [A in keyof TMembers]: TableDefinitionColumn<TMembers[A]>[] };\n\nexport type RelationTargetColumns<TTarget extends AnyRelationTarget> =\n TTarget extends AnyTableDefinition\n ? TableDefinitionColumn<TTarget>[]\n : TTarget extends UnionDefinition<infer TMembers>\n ? UnionTargetColumns<TMembers>\n : never;\n\nexport type FieldRelation<\n TSource extends AnyTableDefinition,\n TTarget extends AnyRelationTarget = AnyRelationTarget,\n TType extends RelationType = RelationType,\n> = {\n target: TTarget;\n type: TType;\n from: TSource extends AnyTableDefinition ? TableDefinitionColumn<TSource>[] : never;\n to: RelationTargetColumns<TTarget>;\n /**\n * The source column naming which member of a union a belongs-to row points at. Required on\n * a belongs-to whose target is a union, refused everywhere else — see the registry.\n */\n discriminator?: TSource extends AnyTableDefinition ? TableDefinitionColumn<TSource> : never;\n};\n\nexport type RelationsConfig<TTable extends AnyTableDefinition = AnyTableDefinition> = {\n table: TTable;\n relations: Record<string, FieldRelation<TTable, AnyRelationTarget, RelationType>>;\n};\n\nexport type AnyFieldRelation = FieldRelation<AnyTableDefinition, AnyRelationTarget, RelationType>;\nexport type AnyTableRelations = Record<string, AnyFieldRelation>;\nexport type AnyRelationDefinition = RelationsDefinition<AnyTableDefinition, AnyTableRelations>;\n\nexport class RelationsDefinition<\n TTable extends AnyTableDefinition,\n TRelations extends Record<string, FieldRelation<TTable, AnyRelationTarget, RelationType>>,\n> extends DefinitionNode<`${TTable[\"name\"]}_relations`, { table: TTable; relations: TRelations }> {\n public readonly kind = Kind.RELATIONS;\n\n readonly table: TTable;\n readonly relations: TRelations;\n\n constructor(table: TTable, relations: TRelations) {\n super(`${table.name}_relations`);\n\n this.table = table;\n this.relations = relations;\n }\n\n public toJSON() {\n return {\n kind: this.kind,\n name: this.name,\n table: {\n kind: this.table.kind,\n name: this.table.name,\n },\n relations: Object.fromEntries(\n Object.entries(this.relations).map(([name, relation]) => [\n name,\n {\n type: relation.type,\n target:\n relation.target instanceof UnionDefinition\n ? relation.target.toJSON()\n : { kind: relation.target.kind, name: relation.target.name },\n from: relation.from.map(toColumnJSON),\n to: Array.isArray(relation.to)\n ? relation.to.map(toColumnJSON)\n : Object.fromEntries(\n Object.entries(relation.to).map(([alias, columns]) => [\n alias,\n columns.map(toColumnJSON),\n ])\n ),\n ...(relation.discriminator && {\n discriminator: toColumnJSON(relation.discriminator),\n }),\n } as const,\n ])\n ),\n } as const;\n }\n}\n\nfunction toColumnJSON(column: DefinitionNode) {\n return { kind: column.kind, name: column.name };\n}\n"]}
1
+ {"version":3,"file":"relations.js","sourceRoot":"","sources":["../../src/definition/relations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,IAAI,EAAgB,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAsB,eAAe,EAAE,MAAM,YAAY,CAAC;AAkDjE,MAAM,OAAO,mBAGX,SAAQ,cAGT;IACiB,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;IAE7B,KAAK,CAAU;IACf,SAAS,CAAa;IAE/B,YAAY,KAAc,EAAE,SAAqB;QAC/C,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,YAAY,CAAC,CAAC;QAEjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;gBACrB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;aACtB;YACD,SAAS,EAAE,MAAM,CAAC,WAAW,CAC3B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACvD,IAAI;gBACJ;oBACE,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,MAAM,EACJ,QAAQ,CAAC,MAAM,YAAY,eAAe;wBACxC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;wBAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;oBAChE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;oBACrC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC5B,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC;wBAC/B,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CACZ,QAAQ,CAAC,EAAgE,CAC1E,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAChE;oBACL,GAAG,CAAC,QAAQ,CAAC,aAAa,IAAI;wBAC5B,aAAa,EAAE,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC;qBACpD,CAAC;iBACM;aACX,CAAC,CACH;SACO,CAAC;IACb,CAAC;CACF;AAED,SAAS,YAAY,CAAC,MAAsB;IAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC","sourcesContent":["import { DefinitionNode, Kind, RelationType } from \"./base.js\";\nimport { AnyTableDefinition } from \"./table.js\";\nimport { AnyUnionDefinition, UnionDefinition } from \"./union.js\";\n\n/** What a relation can point at: one table, or a union of tables. */\nexport type AnyRelationObject = AnyTableDefinition | AnyUnionDefinition;\n\nexport type RelationObjectColumn<TObject extends AnyRelationObject> = {\n [K in keyof TObject[\"__type\"][\"columns\"]]: TObject[\"__type\"][\"columns\"][K];\n}[keyof TObject[\"__type\"][\"columns\"]];\n\nexport type RelationTargetColumn<TObject extends AnyRelationObject> =\n TObject extends AnyTableDefinition\n ? RelationObjectColumn<TObject>[]\n : TObject extends AnyUnionDefinition\n ?\n | RelationObjectColumn<TObject>[]\n | {\n [K in keyof TObject[\"__type\"][\"members\"]]: TObject[\"__type\"][\"members\"][K] extends AnyTableDefinition\n ? RelationObjectColumn<TObject[\"__type\"][\"members\"][K]>[]\n : never;\n }\n : never;\n\nexport type FieldRelation<\n TType extends RelationType,\n TSource extends AnyRelationObject,\n out TTarget extends AnyRelationObject,\n> = {\n type: TType;\n target: TTarget;\n from: RelationObjectColumn<TSource>[];\n to: RelationTargetColumn<TTarget>;\n /**\n * The source column naming which member of a union a belongs-to row points at. Optional on\n * a belongs-to whose target is a union — without one, the member is computed when the query\n * runs — and refused everywhere else; see the registry.\n */\n discriminator?: RelationObjectColumn<TSource>;\n};\n\nexport type RelationsConfig<TSource extends AnyRelationObject = AnyRelationObject> = {\n table: TSource;\n relations: Record<string, FieldRelation<RelationType, TSource, AnyRelationObject>>;\n};\n\nexport type AnyFieldRelation = FieldRelation<RelationType, AnyTableDefinition, AnyRelationObject>;\nexport type AnyTableRelations = Record<string, AnyFieldRelation>;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyRelationDefinition = RelationsDefinition<any, any>;\n\nexport class RelationsDefinition<\n TSource extends AnyRelationObject,\n TRelations extends Record<string, FieldRelation<RelationType, TSource, AnyRelationObject>>,\n> extends DefinitionNode<\n `${TSource[\"name\"]}_relations`,\n { table: TSource; relations: TRelations }\n> {\n public readonly kind = Kind.RELATIONS;\n\n readonly table: TSource;\n readonly relations: TRelations;\n\n constructor(table: TSource, relations: TRelations) {\n super(`${table.name}_relations`);\n\n this.table = table;\n this.relations = relations;\n }\n\n public toJSON() {\n return {\n kind: this.kind,\n name: this.name,\n table: {\n kind: this.table.kind,\n name: this.table.name,\n },\n relations: Object.fromEntries(\n Object.entries(this.relations).map(([name, relation]) => [\n name,\n {\n type: relation.type,\n target:\n relation.target instanceof UnionDefinition\n ? relation.target.toJSON()\n : { kind: relation.target.kind, name: relation.target.name },\n from: relation.from.map(toColumnJSON),\n to: Array.isArray(relation.to)\n ? relation.to.map(toColumnJSON)\n : Object.fromEntries(\n Object.entries(\n relation.to as Record<string, RelationObjectColumn<AnyTableDefinition>[]>\n ).map(([alias, columns]) => [alias, columns.map(toColumnJSON)])\n ),\n ...(relation.discriminator && {\n discriminator: toColumnJSON(relation.discriminator),\n }),\n } as const,\n ])\n ),\n } as const;\n }\n}\n\nfunction toColumnJSON(column: DefinitionNode) {\n return { kind: column.kind, name: column.name };\n}\n"]}
@@ -1,11 +1,12 @@
1
1
  import { WithMeta } from "../utils/types.js";
2
2
  import { SQLNode } from "../sql/nodes.js";
3
3
  import { DefinitionNode, NodeRef } from "./base.js";
4
- import { ColumnRefOf, ColumnRefs, TableColumnDefinitions } from "./embedded.js";
4
+ import { AnyColumnDefinition } from "./column.js";
5
5
  import { AnyConstraintDefinition, PrimaryKeyConstraintDefinition, UniqueConstraintDefinition } from "./constraint.js";
6
6
  import { AnyIndexDefinition, IndexConfig, IndexDefinition } from "./indexes.js";
7
7
  import { AnyNamespaceDefinition } from "./namespace.js";
8
- export type TableConfig<TColumns extends TableColumnDefinitions, TSchema extends AnyNamespaceDefinition> = {
8
+ import { AnyPolicyDefinition, PolicyConfig, PolicyDefinition } from "./policy.js";
9
+ export type TableConfig<TColumns extends Record<string, AnyColumnDefinition>, TSchema extends AnyNamespaceDefinition> = {
9
10
  namespace?: NodeRef<TSchema>;
10
11
  columns: TColumns;
11
12
  /**
@@ -16,12 +17,15 @@ export type TableConfig<TColumns extends TableColumnDefinitions, TSchema extends
16
17
  meta?: unknown;
17
18
  };
18
19
  export type AnyTableDefinition = TableDefinition<any, any, any>;
19
- export type { ColumnRefOf, ColumnRefs };
20
- export declare class TableDefinition<TName extends string, TColumns extends TableColumnDefinitions, TNamespace extends AnyNamespaceDefinition> extends DefinitionNode<TName, TableConfig<TColumns, TNamespace>> {
20
+ export type ColumnRefs<TColumns extends Record<string, AnyColumnDefinition>> = {
21
+ readonly [K in keyof TColumns]: NodeRef<TColumns[K]>;
22
+ };
23
+ export declare class TableDefinition<TName extends string, TColumns extends Record<string, AnyColumnDefinition>, TNamespace extends AnyNamespaceDefinition> extends DefinitionNode<TName, TableConfig<TColumns, TNamespace>> {
21
24
  readonly kind: "TABLE";
22
25
  protected _namespace?: NodeRef<TNamespace>;
23
26
  protected _indexes: AnyIndexDefinition[];
24
27
  protected _constraints: AnyConstraintDefinition[];
28
+ protected _policies: AnyPolicyDefinition[];
25
29
  protected _meta?: Record<string, unknown>;
26
30
  protected _renamedFrom?: string;
27
31
  readonly columns: Readonly<TColumns>;
@@ -32,30 +36,44 @@ export declare class TableDefinition<TName extends string, TColumns extends Tabl
32
36
  * error names the definition the author wrote.
33
37
  */
34
38
  private _assertReservedFieldNames;
39
+ /**
40
+ * A deprecated column must be one the table can do without: not part of the primary key.
41
+ */
42
+ private _assertDeprecations;
35
43
  /**
36
44
  * Two fields mapping to one database column is always a mistake, and a silent one: the
37
45
  * result resolver reads a row by column name (`packages/core/src/runtime/operation.ts`),
38
- * so one field would shadow the other, and `toJSON` would emit the column twice. A group's
39
- * members count by their full path, so `netValue.amount` against a plain `net_value_amount`
40
- * is caught too.
46
+ * so one field would shadow the other, and `toJSON` would emit the column twice.
41
47
  */
48
+ private _assertDistinctColumnNames;
49
+ index<TIdxName extends string, TIdxConfig extends IndexConfig>(name: TIdxName, config?: Partial<Omit<TIdxConfig, "table">>): IndexDefinition<TIdxName, this>;
50
+ check(cb: (columns: ColumnRefs<this["columns"]>) => SQLNode, name?: string): this;
51
+ unique(cb: (columns: ColumnRefs<this["columns"]>) => ColumnRefs<this["columns"]>[keyof this["columns"]][]): UniqueConstraintDefinition<string, this>;
52
+ primaryKey(cb: (columns: ColumnRefs<this["columns"]>) => ColumnRefs<this["columns"]>[keyof this["columns"]][]): PrimaryKeyConstraintDefinition<string, this>;
42
53
  /**
43
- * A deprecated column must be one the table can do without: not part of the primary key, and
44
- * not a member of an embedded object (which the client reads as a whole).
54
+ * Declares a row policy, shaped like `CREATE POLICY <name> ON <table> AS … FOR … USING (…)
55
+ * WITH CHECK (…)` — DSQL has no RLS, so the runtime enforces it while it builds each
56
+ * statement. A table with any policy denies by default: a command no permissive policy covers
57
+ * reads nothing and writes nothing.
58
+ *
59
+ * `using` and `check` may be functions of the table's runtime columns, run once, when the client is built.
60
+ * Policies are not DDL: they never reach `toJSON` or a migration.
61
+ *
62
+ * @example
63
+ * ```ts
64
+ * documents.policy("workspace_isolation", {
65
+ * as: "restrictive",
66
+ * using: (t) => sql`${t.workspaceId} = ${sql.claim("workspaceId")}`,
67
+ * });
68
+ * ```
45
69
  */
46
- private _assertDeprecations;
47
- private _assertDistinctColumnNames;
70
+ policy(name: string, config: Omit<PolicyConfig<this>, "table">): PolicyDefinition<string, this>;
48
71
  /**
49
- * A tenant claim column is filled by the runtime on every insert and AND-ed into every read,
50
- * so it can be neither null nor writable by the caller. `tenantScope()` sets both flags when
51
- * it hands the column over; this catches a column configured as a claim key any other way,
52
- * and catches it here — where the error can name the definition the author wrote.
72
+ * The table's previous name: the migration renames it (`ALTER TABLE … RENAME TO`) instead of
73
+ * dropping one table and creating another. Once the database has the new name the hint does
74
+ * nothing, so it can stay for a release before it is removed.
53
75
  */
54
- private _assertTenantKeys;
55
- index<TIdxName extends string, TIdxConfig extends IndexConfig>(name: TIdxName, config?: Partial<Omit<TIdxConfig, "table">>): IndexDefinition<TIdxName, this>;
56
- check(cb: (columns: ColumnRefs<this["columns"]>) => SQLNode, name?: string): this;
57
- unique(cb: (columns: ColumnRefs<this["columns"]>) => ColumnRefOf<this["columns"]>[]): UniqueConstraintDefinition<string, this>;
58
- primaryKey(cb: (columns: ColumnRefs<this["columns"]>) => ColumnRefOf<this["columns"]>[]): PrimaryKeyConstraintDefinition<string, this>;
76
+ renamedFrom(previous: string): this;
59
77
  /**
60
78
  * Attaches arbitrary metadata to the table, surfaced on every result row under `$$meta`
61
79
  * alongside the built-in `key`, `table` and `schema`.
@@ -71,13 +89,7 @@ export declare class TableDefinition<TName extends string, TColumns extends Tabl
71
89
  * // row.$$meta.__typename === "User"
72
90
  * ```
73
91
  */
74
- /**
75
- * The table's previous name: the migration renames it (`ALTER TABLE … RENAME TO`) instead of
76
- * dropping one table and creating another. Once the database has the new name the hint does
77
- * nothing, so it can stay for a release before it is removed.
78
- */
79
- renamedFrom(previous: string): this;
80
- meta<M extends Record<string, unknown>>(meta: M): WithMeta<this, M>;
92
+ meta<const M extends Record<string, unknown>>(meta: M): WithMeta<this, M>;
81
93
  toJSON(): {
82
94
  readonly kind: "TABLE";
83
95
  readonly name: TName;
@@ -125,11 +137,6 @@ export declare class TableDefinition<TName extends string, TColumns extends Tabl
125
137
  readonly unique: boolean;
126
138
  readonly distinctNulls: boolean | undefined;
127
139
  readonly columns: ({
128
- readonly kind: "INDEX_COLUMN";
129
- readonly name: `${any}_column_${string}`;
130
- readonly nulls: "FIRST" | "LAST";
131
- readonly column: string;
132
- } | {
133
140
  readonly kind: "INDEX_COLUMN";
134
141
  readonly name: `${any}_column_${any}`;
135
142
  readonly nulls: "FIRST" | "LAST";
@@ -1 +1 @@
1
- {"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/definition/table.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/definition/table.ts"],"names":[],"mappings":"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"}
@@ -1,13 +1,14 @@
1
1
  import { SQLQuery } from "../sql/nodes.js";
2
2
  import { DefinitionNode, Kind, NodeRef, RESERVED_FIELD_NAMES } from "./base.js";
3
- import { ColumnGroupDefinition, columnEntries, } from "./embedded.js";
4
3
  import { CheckConstraintDefinition, PrimaryKeyConstraintDefinition, UniqueConstraintDefinition, } from "./constraint.js";
5
4
  import { IndexDefinition } from "./indexes.js";
5
+ import { PolicyDefinition } from "./policy.js";
6
6
  export class TableDefinition extends DefinitionNode {
7
7
  kind = Kind.TABLE;
8
8
  _namespace;
9
9
  _indexes = [];
10
10
  _constraints = [];
11
+ _policies = [];
11
12
  _meta;
12
13
  _renamedFrom;
13
14
  columns;
@@ -19,7 +20,6 @@ export class TableDefinition extends DefinitionNode {
19
20
  this._assertReservedFieldNames();
20
21
  this._assertDistinctColumnNames();
21
22
  this._assertDeprecations();
22
- this._assertTenantKeys();
23
23
  }
24
24
  /**
25
25
  * Field names the runtime writes onto result records itself cannot also be columns —
@@ -35,34 +35,24 @@ export class TableDefinition extends DefinitionNode {
35
35
  }
36
36
  }
37
37
  /**
38
- * Two fields mapping to one database column is always a mistake, and a silent one: the
39
- * result resolver reads a row by column name (`packages/core/src/runtime/operation.ts`),
40
- * so one field would shadow the other, and `toJSON` would emit the column twice. A group's
41
- * members count by their full path, so `netValue.amount` against a plain `net_value_amount`
42
- * is caught too.
43
- */
44
- /**
45
- * A deprecated column must be one the table can do without: not part of the primary key, and
46
- * not a member of an embedded object (which the client reads as a whole).
38
+ * A deprecated column must be one the table can do without: not part of the primary key.
47
39
  */
48
40
  _assertDeprecations() {
49
- for (const [path, column] of columnEntries(this.columns)) {
50
- if (!column["_deprecated"])
51
- continue;
52
- if (path.length > 1) {
53
- throw new Error(`Table "${this.name}" deprecates "${path.join(".")}", a member of an embedded object. ` +
54
- `Only a table's own columns can be deprecated.`);
55
- }
56
- if (column["_primaryKey"]) {
57
- throw new Error(`Table "${this.name}" deprecates "${path.join(".")}", part of its primary key, which ` +
41
+ for (const [field, column] of Object.entries(this.columns)) {
42
+ if (column["_deprecated"] && column["_primaryKey"]) {
43
+ throw new Error(`Table "${this.name}" deprecates "${field}", part of its primary key, which ` +
58
44
  `can't be dropped.`);
59
45
  }
60
46
  }
61
47
  }
48
+ /**
49
+ * Two fields mapping to one database column is always a mistake, and a silent one: the
50
+ * result resolver reads a row by column name (`packages/core/src/runtime/operation.ts`),
51
+ * so one field would shadow the other, and `toJSON` would emit the column twice.
52
+ */
62
53
  _assertDistinctColumnNames() {
63
54
  const fieldsByColumn = new Map();
64
- for (const [path, column] of columnEntries(this.columns)) {
65
- const field = path.join(".");
55
+ for (const [field, column] of Object.entries(this.columns)) {
66
56
  const existing = fieldsByColumn.get(column.name);
67
57
  if (existing !== undefined) {
68
58
  throw new Error(`Table "${this.name}" maps fields "${existing}" and "${field}" to the same column ` +
@@ -71,34 +61,9 @@ export class TableDefinition extends DefinitionNode {
71
61
  fieldsByColumn.set(column.name, field);
72
62
  }
73
63
  }
74
- /**
75
- * A tenant claim column is filled by the runtime on every insert and AND-ed into every read,
76
- * so it can be neither null nor writable by the caller. `tenantScope()` sets both flags when
77
- * it hands the column over; this catches a column configured as a claim key any other way,
78
- * and catches it here — where the error can name the definition the author wrote.
79
- */
80
- _assertTenantKeys() {
81
- for (const [path, column] of columnEntries(this.columns)) {
82
- const field = path.join(".");
83
- if (!column["_tenantKey"]) {
84
- continue;
85
- }
86
- if (!column["_notNull"]) {
87
- throw new Error(`Table "${this.name}" declares claim "${field}" as nullable. A claim column is ` +
88
- `filled by the runtime on every insert, so it is never null.`);
89
- }
90
- if (!column["_readOnly"]) {
91
- throw new Error(`Table "${this.name}" declares claim "${field}" as writable. A claim column's value ` +
92
- `comes from the identity on the client, never from the caller.`);
93
- }
94
- }
95
- }
96
64
  /** @internal */
97
65
  _getColumnRefs() {
98
- return Object.fromEntries(Object.entries(this.columns).map(([field, column]) => [
99
- field,
100
- column instanceof ColumnGroupDefinition ? column._getColumnRefs() : new NodeRef(column),
101
- ]));
66
+ return Object.fromEntries(Object.entries(this.columns).map(([field, column]) => [field, new NodeRef(column)]));
102
67
  }
103
68
  index(name, config = {}) {
104
69
  const idx = new IndexDefinition(name, { ...config, table: this });
@@ -121,20 +86,13 @@ export class TableDefinition extends DefinitionNode {
121
86
  }
122
87
  primaryKey(cb) {
123
88
  const cols = cb(this._getColumnRefs());
124
- const members = new Set(columnEntries(this.columns)
125
- .filter(([path]) => path.length > 1)
126
- .map(([, column]) => column.name));
127
- const deprecated = new Set(columnEntries(this.columns)
128
- .filter(([, column]) => column["_deprecated"])
129
- .map(([, column]) => column.name));
89
+ const deprecated = new Set(Object.values(this.columns)
90
+ .filter((column) => column["_deprecated"])
91
+ .map((column) => column.name));
130
92
  for (const ref of cols) {
131
93
  if (deprecated.has(ref.name)) {
132
94
  throw new Error(`Table "${this.name}" declares a primary key on "${ref.name}", which is deprecated.`);
133
95
  }
134
- if (members.has(ref.name)) {
135
- throw new Error(`Table "${this.name}" declares a primary key on "${ref.name}", a member of an ` +
136
- `embedded object. A primary key spans plain columns only.`);
137
- }
138
96
  }
139
97
  const constraint = new PrimaryKeyConstraintDefinition(`${this.name}_primary_key`, {
140
98
  table: this,
@@ -144,20 +102,37 @@ export class TableDefinition extends DefinitionNode {
144
102
  return constraint;
145
103
  }
146
104
  /**
147
- * Attaches arbitrary metadata to the table, surfaced on every result row under `$$meta`
148
- * alongside the built-in `key`, `table` and `schema`.
105
+ * Declares a row policy, shaped like `CREATE POLICY <name> ON <table> AS … FOR … USING (…)
106
+ * WITH CHECK (…)` — DSQL has no RLS, so the runtime enforces it while it builds each
107
+ * statement. A table with any policy denies by default: a command no permissive policy covers
108
+ * reads nothing and writes nothing.
149
109
  *
150
- * Metadata describes the table to the application — a GraphQL typename, a display label —
151
- * and never to the database: it is absent from {@link TableDefinition.toJSON}, so it does
152
- * not participate in migrations. Built-in keys may not be overwritten; that throws when the
153
- * runtime `Table` is built.
110
+ * `using` and `check` may be functions of the table's runtime columns, run once, when the client is built.
111
+ * Policies are not DDL: they never reach `toJSON` or a migration.
154
112
  *
155
113
  * @example
156
114
  * ```ts
157
- * const users = table("users", { id: uuid("id").primaryKey() }).meta({ __typename: "User" });
158
- * // row.$$meta.__typename === "User"
115
+ * documents.policy("workspace_isolation", {
116
+ * as: "restrictive",
117
+ * using: (t) => sql`${t.workspaceId} = ${sql.claim("workspaceId")}`,
118
+ * });
159
119
  * ```
160
120
  */
121
+ policy(name, config) {
122
+ // TODO: move this to runtime / migration validation
123
+ // if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
124
+ // throw new Error(
125
+ // `Table "${this.name}" declares policy "${name}": a policy name is a SQL-style ` +
126
+ // `identifier — letters, digits and underscores, not starting with a digit.`
127
+ // );
128
+ // }
129
+ if (this._policies.some((policy) => policy.name === name)) {
130
+ throw new Error(`Table "${this.name}" declares policy "${name}" twice.`);
131
+ }
132
+ const policy = new PolicyDefinition(name, { table: this, ...config });
133
+ this._policies.push(policy);
134
+ return policy;
135
+ }
161
136
  /**
162
137
  * The table's previous name: the migration renames it (`ALTER TABLE … RENAME TO`) instead of
163
138
  * dropping one table and creating another. Once the database has the new name the hint does
@@ -167,6 +142,21 @@ export class TableDefinition extends DefinitionNode {
167
142
  this._renamedFrom = previous;
168
143
  return this;
169
144
  }
145
+ /**
146
+ * Attaches arbitrary metadata to the table, surfaced on every result row under `$$meta`
147
+ * alongside the built-in `key`, `table` and `schema`.
148
+ *
149
+ * Metadata describes the table to the application — a GraphQL typename, a display label —
150
+ * and never to the database: it is absent from {@link TableDefinition.toJSON}, so it does
151
+ * not participate in migrations. Built-in keys may not be overwritten; that throws when the
152
+ * runtime `Table` is built.
153
+ *
154
+ * @example
155
+ * ```ts
156
+ * const users = table("users", { id: uuid("id").primaryKey() }).meta({ __typename: "User" });
157
+ * // row.$$meta.__typename === "User"
158
+ * ```
159
+ */
170
160
  meta(meta) {
171
161
  this._meta = meta;
172
162
  return this;
@@ -179,7 +169,7 @@ export class TableDefinition extends DefinitionNode {
179
169
  kind: this.kind,
180
170
  name: this.name,
181
171
  namespace: this._namespace?.name ?? "public",
182
- columns: columnEntries(this.columns).map(([, column]) => {
172
+ columns: Object.values(this.columns).map((column) => {
183
173
  const json = column.toJSON();
184
174
  return keyColumns.has(json.name) ? { ...json, notNull: true } : json;
185
175
  }),
@@ -1 +1 @@
1
- {"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/definition/table.ts"],"names":[],"mappings":"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","sourcesContent":["import { WithMeta } from \"../utils/types.js\";\nimport { SQLNode, SQLQuery } from \"../sql/nodes.js\";\nimport { DefinitionNode, Kind, NodeRef, RESERVED_FIELD_NAMES } from \"./base.js\";\nimport {\n ColumnGroupDefinition,\n ColumnRefOf,\n ColumnRefs,\n columnEntries,\n TableColumnDefinitions,\n} from \"./embedded.js\";\nimport {\n AnyConstraintDefinition,\n CheckConstraintDefinition,\n PrimaryKeyConstraintDefinition,\n UniqueConstraintDefinition,\n} from \"./constraint.js\";\nimport { AnyIndexDefinition, IndexConfig, IndexDefinition } from \"./indexes.js\";\nimport { AnyNamespaceDefinition } from \"./namespace.js\";\n\nexport type TableConfig<\n TColumns extends TableColumnDefinitions,\n TSchema extends AnyNamespaceDefinition,\n> = {\n namespace?: NodeRef<TSchema>;\n columns: TColumns;\n /**\n * Arbitrary per-table metadata, surfaced on every result row as part of `$$meta`.\n * Describes the table to the application, never to the database: it is not DDL and is\n * deliberately absent from {@link TableDefinition.toJSON}, so it never reaches a migration.\n */\n meta?: unknown;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyTableDefinition = TableDefinition<any, any, any>;\n\nexport type { ColumnRefOf, ColumnRefs };\n\nexport class TableDefinition<\n TName extends string,\n TColumns extends TableColumnDefinitions,\n TNamespace extends AnyNamespaceDefinition,\n> extends DefinitionNode<TName, TableConfig<TColumns, TNamespace>> {\n readonly kind = Kind.TABLE;\n\n protected _namespace?: NodeRef<TNamespace>;\n protected _indexes: AnyIndexDefinition[] = [];\n protected _constraints: AnyConstraintDefinition[] = [];\n protected _meta?: Record<string, unknown>;\n protected _renamedFrom?: string;\n\n readonly columns: Readonly<TColumns>;\n\n constructor(name: TName, config: TableConfig<TColumns, TNamespace>) {\n super(name);\n\n this._namespace = config.namespace;\n this.columns = config.columns as Readonly<TColumns>;\n this._meta = config.meta as Record<string, unknown> | undefined;\n\n this._assertReservedFieldNames();\n this._assertDistinctColumnNames();\n this._assertDeprecations();\n this._assertTenantKeys();\n }\n\n /**\n * Field names the runtime writes onto result records itself cannot also be columns —\n * one would overwrite the other. Checked here rather than at `Table` build time so the\n * error names the definition the author wrote.\n */\n private _assertReservedFieldNames(): void {\n for (const field of Object.keys(this.columns)) {\n if (RESERVED_FIELD_NAMES.includes(field)) {\n throw new Error(\n `Table \"${this.name}\" declares a column named \"${field}\", which is reserved. ` +\n `The runtime writes ${RESERVED_FIELD_NAMES.join(\" and \")} onto every result row.`\n );\n }\n }\n }\n\n /**\n * Two fields mapping to one database column is always a mistake, and a silent one: the\n * result resolver reads a row by column name (`packages/core/src/runtime/operation.ts`),\n * so one field would shadow the other, and `toJSON` would emit the column twice. A group's\n * members count by their full path, so `netValue.amount` against a plain `net_value_amount`\n * is caught too.\n */\n /**\n * A deprecated column must be one the table can do without: not part of the primary key, and\n * not a member of an embedded object (which the client reads as a whole).\n */\n private _assertDeprecations(): void {\n for (const [path, column] of columnEntries(this.columns)) {\n if (!column[\"_deprecated\"]) continue;\n\n if (path.length > 1) {\n throw new Error(\n `Table \"${this.name}\" deprecates \"${path.join(\".\")}\", a member of an embedded object. ` +\n `Only a table's own columns can be deprecated.`\n );\n }\n\n if (column[\"_primaryKey\"]) {\n throw new Error(\n `Table \"${this.name}\" deprecates \"${path.join(\".\")}\", part of its primary key, which ` +\n `can't be dropped.`\n );\n }\n }\n }\n\n private _assertDistinctColumnNames(): void {\n const fieldsByColumn = new Map<string, string>();\n\n for (const [path, column] of columnEntries(this.columns)) {\n const field = path.join(\".\");\n const existing = fieldsByColumn.get(column.name);\n\n if (existing !== undefined) {\n throw new Error(\n `Table \"${this.name}\" maps fields \"${existing}\" and \"${field}\" to the same column ` +\n `\"${column.name}\". Every field must map to a distinct column.`\n );\n }\n\n fieldsByColumn.set(column.name, field);\n }\n }\n\n /**\n * A tenant claim column is filled by the runtime on every insert and AND-ed into every read,\n * so it can be neither null nor writable by the caller. `tenantScope()` sets both flags when\n * it hands the column over; this catches a column configured as a claim key any other way,\n * and catches it here — where the error can name the definition the author wrote.\n */\n private _assertTenantKeys(): void {\n for (const [path, column] of columnEntries(this.columns)) {\n const field = path.join(\".\");\n if (!column[\"_tenantKey\"]) {\n continue;\n }\n\n if (!column[\"_notNull\"]) {\n throw new Error(\n `Table \"${this.name}\" declares claim \"${field}\" as nullable. A claim column is ` +\n `filled by the runtime on every insert, so it is never null.`\n );\n }\n\n if (!column[\"_readOnly\"]) {\n throw new Error(\n `Table \"${this.name}\" declares claim \"${field}\" as writable. A claim column's value ` +\n `comes from the identity on the client, never from the caller.`\n );\n }\n }\n }\n\n /** @internal */\n _getColumnRefs(): ColumnRefs<this[\"columns\"]> {\n return Object.fromEntries(\n Object.entries(this.columns).map(([field, column]) => [\n field,\n column instanceof ColumnGroupDefinition ? column._getColumnRefs() : new NodeRef(column),\n ])\n ) as ColumnRefs<this[\"columns\"]>;\n }\n\n public index<TIdxName extends string, TIdxConfig extends IndexConfig>(\n name: TIdxName,\n config: Partial<Omit<TIdxConfig, \"table\">> = {}\n ): IndexDefinition<TIdxName, this> {\n const idx = new IndexDefinition(name, { ...config, table: this });\n this._indexes.push(idx);\n\n return idx as IndexDefinition<TIdxName, this>;\n }\n\n public check(cb: (columns: ColumnRefs<this[\"columns\"]>) => SQLNode, name?: string): this {\n const expression = new SQLQuery(cb(this._getColumnRefs()));\n this._constraints?.push(\n new CheckConstraintDefinition(name ?? `${this.name}_check`, { expression })\n );\n\n return this;\n }\n\n public unique(\n cb: (columns: ColumnRefs<this[\"columns\"]>) => ColumnRefOf<this[\"columns\"]>[]\n ): UniqueConstraintDefinition<string, this> {\n const cols = cb(this._getColumnRefs());\n\n const constraint = new UniqueConstraintDefinition(`${this.name}_unique`, {\n table: this,\n columns: cols,\n });\n this._constraints?.push(constraint);\n\n return constraint;\n }\n\n public primaryKey(\n cb: (columns: ColumnRefs<this[\"columns\"]>) => ColumnRefOf<this[\"columns\"]>[]\n ): PrimaryKeyConstraintDefinition<string, this> {\n const cols = cb(this._getColumnRefs());\n const members = new Set(\n columnEntries(this.columns)\n .filter(([path]) => path.length > 1)\n .map(([, column]) => column.name)\n );\n\n const deprecated = new Set(\n columnEntries(this.columns)\n .filter(([, column]) => column[\"_deprecated\"])\n .map(([, column]) => column.name)\n );\n\n for (const ref of cols) {\n if (deprecated.has(ref.name)) {\n throw new Error(\n `Table \"${this.name}\" declares a primary key on \"${ref.name}\", which is deprecated.`\n );\n }\n\n if (members.has(ref.name)) {\n throw new Error(\n `Table \"${this.name}\" declares a primary key on \"${ref.name}\", a member of an ` +\n `embedded object. A primary key spans plain columns only.`\n );\n }\n }\n\n const constraint = new PrimaryKeyConstraintDefinition(`${this.name}_primary_key`, {\n table: this,\n columns: cols,\n });\n\n this._constraints?.push(constraint);\n\n return constraint;\n }\n\n /**\n * Attaches arbitrary metadata to the table, surfaced on every result row under `$$meta`\n * alongside the built-in `key`, `table` and `schema`.\n *\n * Metadata describes the table to the application — a GraphQL typename, a display label —\n * and never to the database: it is absent from {@link TableDefinition.toJSON}, so it does\n * not participate in migrations. Built-in keys may not be overwritten; that throws when the\n * runtime `Table` is built.\n *\n * @example\n * ```ts\n * const users = table(\"users\", { id: uuid(\"id\").primaryKey() }).meta({ __typename: \"User\" });\n * // row.$$meta.__typename === \"User\"\n * ```\n */\n /**\n * The table's previous name: the migration renames it (`ALTER TABLE … RENAME TO`) instead of\n * dropping one table and creating another. Once the database has the new name the hint does\n * nothing, so it can stay for a release before it is removed.\n */\n public renamedFrom(previous: string): this {\n this._renamedFrom = previous;\n return this;\n }\n\n public meta<M extends Record<string, unknown>>(meta: M): WithMeta<this, M> {\n this._meta = meta;\n\n return this as WithMeta<this, M>;\n }\n\n public toJSON() {\n const constraints = this._constraints?.map((constraint) => constraint.toJSON());\n // PostgreSQL makes every primary-key column NOT NULL; a composite key's columns say so here.\n const keyColumns = new Set<string>(\n constraints.flatMap((constraint) =>\n constraint.kind === Kind.PRIMARY_KEY_CONSTRAINT ? constraint.columns : []\n )\n );\n\n return {\n kind: this.kind,\n name: this.name,\n namespace: this._namespace?.name ?? \"public\",\n columns: columnEntries(this.columns).map(([, column]) => {\n const json = column.toJSON();\n return keyColumns.has(json.name) ? { ...json, notNull: true } : json;\n }),\n indexes: this._indexes.map((idx) => idx.toJSON()),\n constraints,\n renamedFrom: this._renamedFrom ?? null,\n } as const;\n }\n}\n"]}
1
+ {"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/definition/table.ts"],"names":[],"mappings":"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","sourcesContent":["import { WithMeta } from \"../utils/types.js\";\nimport { SQLNode, SQLQuery } from \"../sql/nodes.js\";\nimport { DefinitionNode, Kind, NodeRef, RESERVED_FIELD_NAMES } from \"./base.js\";\nimport { AnyColumnDefinition } from \"./column.js\";\nimport {\n AnyConstraintDefinition,\n CheckConstraintDefinition,\n PrimaryKeyConstraintDefinition,\n UniqueConstraintDefinition,\n} from \"./constraint.js\";\nimport { AnyIndexDefinition, IndexConfig, IndexDefinition } from \"./indexes.js\";\nimport { AnyNamespaceDefinition } from \"./namespace.js\";\nimport { AnyPolicyDefinition, PolicyConfig, PolicyDefinition } from \"./policy.js\";\n\nexport type TableConfig<\n TColumns extends Record<string, AnyColumnDefinition>,\n TSchema extends AnyNamespaceDefinition,\n> = {\n namespace?: NodeRef<TSchema>;\n columns: TColumns;\n /**\n * Arbitrary per-table metadata, surfaced on every result row as part of `$$meta`.\n * Describes the table to the application, never to the database: it is not DDL and is\n * deliberately absent from {@link TableDefinition.toJSON}, so it never reaches a migration.\n */\n meta?: unknown;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyTableDefinition = TableDefinition<any, any, any>;\n\nexport type ColumnRefs<TColumns extends Record<string, AnyColumnDefinition>> = {\n readonly [K in keyof TColumns]: NodeRef<TColumns[K]>;\n};\n\nexport class TableDefinition<\n TName extends string,\n TColumns extends Record<string, AnyColumnDefinition>,\n TNamespace extends AnyNamespaceDefinition,\n> extends DefinitionNode<TName, TableConfig<TColumns, TNamespace>> {\n readonly kind = Kind.TABLE;\n\n protected _namespace?: NodeRef<TNamespace>;\n protected _indexes: AnyIndexDefinition[] = [];\n protected _constraints: AnyConstraintDefinition[] = [];\n protected _policies: AnyPolicyDefinition[] = [];\n protected _meta?: Record<string, unknown>;\n protected _renamedFrom?: string;\n\n readonly columns: Readonly<TColumns>;\n\n constructor(name: TName, config: TableConfig<TColumns, TNamespace>) {\n super(name);\n\n this._namespace = config.namespace;\n this.columns = config.columns as Readonly<TColumns>;\n this._meta = config.meta as Record<string, unknown> | undefined;\n\n this._assertReservedFieldNames();\n this._assertDistinctColumnNames();\n this._assertDeprecations();\n }\n\n /**\n * Field names the runtime writes onto result records itself cannot also be columns —\n * one would overwrite the other. Checked here rather than at `Table` build time so the\n * error names the definition the author wrote.\n */\n private _assertReservedFieldNames(): void {\n for (const field of Object.keys(this.columns)) {\n if (RESERVED_FIELD_NAMES.includes(field)) {\n throw new Error(\n `Table \"${this.name}\" declares a column named \"${field}\", which is reserved. ` +\n `The runtime writes ${RESERVED_FIELD_NAMES.join(\" and \")} onto every result row.`\n );\n }\n }\n }\n\n /**\n * A deprecated column must be one the table can do without: not part of the primary key.\n */\n private _assertDeprecations(): void {\n for (const [field, column] of Object.entries<AnyColumnDefinition>(this.columns)) {\n if (column[\"_deprecated\"] && column[\"_primaryKey\"]) {\n throw new Error(\n `Table \"${this.name}\" deprecates \"${field}\", part of its primary key, which ` +\n `can't be dropped.`\n );\n }\n }\n }\n\n /**\n * Two fields mapping to one database column is always a mistake, and a silent one: the\n * result resolver reads a row by column name (`packages/core/src/runtime/operation.ts`),\n * so one field would shadow the other, and `toJSON` would emit the column twice.\n */\n private _assertDistinctColumnNames(): void {\n const fieldsByColumn = new Map<string, string>();\n\n for (const [field, column] of Object.entries(this.columns)) {\n const existing = fieldsByColumn.get(column.name);\n\n if (existing !== undefined) {\n throw new Error(\n `Table \"${this.name}\" maps fields \"${existing}\" and \"${field}\" to the same column ` +\n `\"${column.name}\". Every field must map to a distinct column.`\n );\n }\n\n fieldsByColumn.set(column.name, field);\n }\n }\n\n /** @internal */\n _getColumnRefs(): ColumnRefs<this[\"columns\"]> {\n return Object.fromEntries(\n Object.entries(this.columns).map(([field, column]) => [field, new NodeRef(column)])\n ) as ColumnRefs<this[\"columns\"]>;\n }\n\n public index<TIdxName extends string, TIdxConfig extends IndexConfig>(\n name: TIdxName,\n config: Partial<Omit<TIdxConfig, \"table\">> = {}\n ): IndexDefinition<TIdxName, this> {\n const idx = new IndexDefinition(name, { ...config, table: this });\n this._indexes.push(idx);\n\n return idx as IndexDefinition<TIdxName, this>;\n }\n\n public check(cb: (columns: ColumnRefs<this[\"columns\"]>) => SQLNode, name?: string): this {\n const expression = new SQLQuery(cb(this._getColumnRefs()));\n this._constraints?.push(\n new CheckConstraintDefinition(name ?? `${this.name}_check`, { expression })\n );\n\n return this;\n }\n\n public unique(\n cb: (\n columns: ColumnRefs<this[\"columns\"]>\n ) => ColumnRefs<this[\"columns\"]>[keyof this[\"columns\"]][]\n ): UniqueConstraintDefinition<string, this> {\n const cols = cb(this._getColumnRefs());\n\n const constraint = new UniqueConstraintDefinition(`${this.name}_unique`, {\n table: this,\n columns: cols,\n });\n this._constraints?.push(constraint);\n\n return constraint;\n }\n\n public primaryKey(\n cb: (\n columns: ColumnRefs<this[\"columns\"]>\n ) => ColumnRefs<this[\"columns\"]>[keyof this[\"columns\"]][]\n ): PrimaryKeyConstraintDefinition<string, this> {\n const cols = cb(this._getColumnRefs());\n const deprecated = new Set(\n Object.values<AnyColumnDefinition>(this.columns)\n .filter((column) => column[\"_deprecated\"])\n .map((column) => column.name)\n );\n\n for (const ref of cols) {\n if (deprecated.has(ref.name)) {\n throw new Error(\n `Table \"${this.name}\" declares a primary key on \"${ref.name}\", which is deprecated.`\n );\n }\n }\n\n const constraint = new PrimaryKeyConstraintDefinition(`${this.name}_primary_key`, {\n table: this,\n columns: cols,\n });\n\n this._constraints?.push(constraint);\n\n return constraint;\n }\n\n /**\n * Declares a row policy, shaped like `CREATE POLICY <name> ON <table> AS … FOR … USING (…)\n * WITH CHECK (…)` — DSQL has no RLS, so the runtime enforces it while it builds each\n * statement. A table with any policy denies by default: a command no permissive policy covers\n * reads nothing and writes nothing.\n *\n * `using` and `check` may be functions of the table's runtime columns, run once, when the client is built.\n * Policies are not DDL: they never reach `toJSON` or a migration.\n *\n * @example\n * ```ts\n * documents.policy(\"workspace_isolation\", {\n * as: \"restrictive\",\n * using: (t) => sql`${t.workspaceId} = ${sql.claim(\"workspaceId\")}`,\n * });\n * ```\n */\n public policy(name: string, config: Omit<PolicyConfig<this>, \"table\">) {\n // TODO: move this to runtime / migration validation\n // if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {\n // throw new Error(\n // `Table \"${this.name}\" declares policy \"${name}\": a policy name is a SQL-style ` +\n // `identifier — letters, digits and underscores, not starting with a digit.`\n // );\n // }\n\n if (this._policies.some((policy) => policy.name === name)) {\n throw new Error(`Table \"${this.name}\" declares policy \"${name}\" twice.`);\n }\n\n const policy = new PolicyDefinition(name, { table: this, ...config });\n this._policies.push(policy);\n\n return policy;\n }\n\n /**\n * The table's previous name: the migration renames it (`ALTER TABLE … RENAME TO`) instead of\n * dropping one table and creating another. Once the database has the new name the hint does\n * nothing, so it can stay for a release before it is removed.\n */\n public renamedFrom(previous: string): this {\n this._renamedFrom = previous;\n return this;\n }\n\n /**\n * Attaches arbitrary metadata to the table, surfaced on every result row under `$$meta`\n * alongside the built-in `key`, `table` and `schema`.\n *\n * Metadata describes the table to the application — a GraphQL typename, a display label —\n * and never to the database: it is absent from {@link TableDefinition.toJSON}, so it does\n * not participate in migrations. Built-in keys may not be overwritten; that throws when the\n * runtime `Table` is built.\n *\n * @example\n * ```ts\n * const users = table(\"users\", { id: uuid(\"id\").primaryKey() }).meta({ __typename: \"User\" });\n * // row.$$meta.__typename === \"User\"\n * ```\n */\n public meta<const M extends Record<string, unknown>>(meta: M): WithMeta<this, M> {\n this._meta = meta;\n\n return this as WithMeta<this, M>;\n }\n\n public toJSON() {\n const constraints = this._constraints?.map((constraint) => constraint.toJSON());\n // PostgreSQL makes every primary-key column NOT NULL; a composite key's columns say so here.\n const keyColumns = new Set<string>(\n constraints.flatMap((constraint) =>\n constraint.kind === Kind.PRIMARY_KEY_CONSTRAINT ? constraint.columns : []\n )\n );\n\n return {\n kind: this.kind,\n name: this.name,\n namespace: this._namespace?.name ?? \"public\",\n columns: Object.values<AnyColumnDefinition>(this.columns).map((column) => {\n const json = column.toJSON();\n return keyColumns.has(json.name) ? { ...json, notNull: true } : json;\n }),\n indexes: this._indexes.map((idx) => idx.toJSON()),\n constraints,\n renamedFrom: this._renamedFrom ?? null,\n } as const;\n }\n}\n"]}
@@ -2,83 +2,40 @@ import { DefinitionNode } from "./base.js";
2
2
  import { AnyColumnDefinition } from "./column.js";
3
3
  import { AnyTableDefinition } from "./table.js";
4
4
  export type AnyUnionMembers = Record<string, AnyTableDefinition>;
5
- /** A member's plain columns. A column group is not shared across a union (yet). */
6
- type PlainColumnsOf<TColumns> = {
7
- [K in keyof TColumns as TColumns[K] extends AnyColumnDefinition ? K : never]: TColumns[K];
8
- };
9
- type MemberColumnsOf<TMembers extends AnyUnionMembers> = {
10
- [A in keyof TMembers]: PlainColumnsOf<TMembers[A]["__type"]["columns"]>;
11
- }[keyof TMembers];
12
- type MemberValueOf<TColumn> = TColumn extends {
13
- __type: {
14
- valueType: infer V;
15
- };
16
- } ? V : never;
17
- type ValueUnionOf<TMembers extends AnyUnionMembers, K extends PropertyKey> = {
18
- [A in keyof TMembers]: MemberValueOf<TMembers[A]["__type"]["columns"][K]>;
19
- }[keyof TMembers];
20
- /**
21
- * The fields every member of a union declares with the same value type.
22
- *
23
- * `keyof` over a union of column maps is already the intersection of their keys; a key then
24
- * survives only when no member's value type is narrower than the union of all of them. The
25
- * database type cannot be compared here — `dataType` is a runtime string on every column — so
26
- * the registry repeats the check against it when the client is built.
27
- */
28
- export type SharedFieldsOf<TMembers extends AnyUnionMembers> = {
29
- [K in keyof MemberColumnsOf<TMembers> & string]: {
30
- [A in keyof TMembers]: [ValueUnionOf<TMembers, K>] extends [
31
- MemberValueOf<TMembers[A]["__type"]["columns"][K]>
32
- ] ? never : A;
33
- }[keyof TMembers] extends never ? K : never;
34
- }[keyof MemberColumnsOf<TMembers> & string];
35
5
  /**
36
- * A field every member of a union shares, addressed on the union rather than on one member —
37
- * `posts.columns.userId` in `hasMany(posts, { to: [posts.columns.userId] })`.
38
- *
39
- * It names a field, not a database column: members may store the same field under different
40
- * column names, so `name` is the field alias and `members` holds the real column per member.
41
- * Typed as the first member's column, which is what every member agrees on.
6
+ * The fields every member of a union declares — `keyof` over a union of column maps is the
7
+ * intersection of their keys. A union's declared columns are drawn from these.
42
8
  */
43
- export declare class UnionColumnDefinition<TField extends string = string, TColumn extends AnyColumnDefinition = AnyColumnDefinition> extends DefinitionNode<TField, TColumn["__type"]> {
44
- readonly kind: "UNION_COLUMN";
45
- readonly members: Readonly<Record<string, AnyColumnDefinition>>;
46
- constructor(field: TField, members: Record<string, AnyColumnDefinition>);
47
- }
48
- export type AnyUnionColumnDefinition = UnionColumnDefinition<string, AnyColumnDefinition>;
49
- export type UnionColumns<TMembers extends AnyUnionMembers> = {
50
- readonly [K in SharedFieldsOf<TMembers>]: UnionColumnDefinition<K, TMembers[keyof TMembers]["__type"]["columns"][K]>;
51
- };
52
- export type UnionConfig<TMembers extends AnyUnionMembers> = {
9
+ export type CommonFieldsOf<TMembers extends AnyUnionMembers> = keyof {
10
+ [A in keyof TMembers]: TMembers[A]["__type"]["columns"];
11
+ }[keyof TMembers] & string;
12
+ /** What `union()` declares: shared field → the column every member stores it in. */
13
+ export type UnionColumnsConfig<TMembers extends AnyUnionMembers> = Partial<Record<CommonFieldsOf<TMembers>, AnyColumnDefinition>>;
14
+ export type UnionConfig<TMembers extends AnyUnionMembers, TColumns extends UnionColumnsConfig<TMembers>> = {
53
15
  members: TMembers;
16
+ columns: TColumns;
54
17
  };
55
18
  /**
56
19
  * A set of tables that can stand in for one another — a GraphQL union or interface.
57
20
  *
58
21
  * Each member is keyed by its schema alias, which the registry checks when the client is
59
- * built, because only there are aliases known. A union is not a table and produces no DDL:
60
- * relations target it, and the client reads it as one `UNION ALL` over its members.
22
+ * built, because only there are aliases known. The fields that work across the union — in a
23
+ * relation's `to`, and in shared `select` / `where` / `orderBy` — are the ones it declares. A
24
+ * union is not a table and produces no DDL: relations target it, and the client reads it as one
25
+ * `UNION ALL` over its members.
61
26
  */
62
- export declare class UnionDefinition<TMembers extends AnyUnionMembers = AnyUnionMembers> extends DefinitionNode<string, UnionConfig<TMembers>> {
27
+ export declare class UnionDefinition<TName extends string, TMembers extends AnyUnionMembers, TColumns extends UnionColumnsConfig<TMembers>> extends DefinitionNode<TName, UnionConfig<TMembers, TColumns>> {
63
28
  readonly kind: "UNION";
64
29
  readonly members: Readonly<TMembers>;
65
- /** The shared fields — see {@link SharedFieldsOf}. */
66
- readonly columns: UnionColumns<TMembers>;
67
- constructor(members: TMembers);
68
- /**
69
- * The fields present on every member with the same `dataType`. A field whose type differs
70
- * on one member is dropped rather than refused: it is still usable per member through `on`,
71
- * just not across the union.
72
- */
73
- private _buildColumns;
30
+ readonly columns: Readonly<TColumns>;
31
+ constructor(name: TName, config: UnionConfig<TMembers, TColumns>);
74
32
  toJSON(): {
75
33
  readonly kind: "UNION";
76
- readonly name: string;
34
+ readonly name: TName;
77
35
  readonly members: {
78
36
  [k: string]: any;
79
37
  };
80
38
  };
81
39
  }
82
- export type AnyUnionDefinition = UnionDefinition<any>;
83
- export {};
40
+ export type AnyUnionDefinition = UnionDefinition<any, any, any>;
84
41
  //# sourceMappingURL=union.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../../src/definition/union.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../../src/definition/union.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAQ,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,SAAS,eAAe,IAAI,MAAM;KAClE,CAAC,IAAI,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC;CACxD,CAAC,MAAM,QAAQ,CAAC,GACf,MAAM,CAAC;AAET,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,CAAC,QAAQ,SAAS,eAAe,IAAI,OAAO,CACxE,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,CACtD,CAAC;AAEF,MAAM,MAAM,WAAW,CACrB,QAAQ,SAAS,eAAe,EAChC,QAAQ,SAAS,kBAAkB,CAAC,QAAQ,CAAC,IAC3C;IACF,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,eAAe,CAC1B,KAAK,SAAS,MAAM,EACpB,QAAQ,SAAS,eAAe,EAChC,QAAQ,SAAS,kBAAkB,CAAC,QAAQ,CAAC,CAC7C,SAAQ,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9D,QAAQ,CAAC,IAAI,UAAc;IAE3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAEzB,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAOzD,MAAM;;;;;;;CASd;AAGD,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC"}