dsqlbase 0.1.6 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +201 -0
- package/LICENSE +21 -0
- package/README.md +206 -2
- package/dist/client/create.d.ts +24 -4
- package/dist/client/create.d.ts.map +1 -1
- package/dist/client/create.js +21 -9
- package/dist/client/create.js.map +1 -1
- package/dist/client/database/base.d.ts +92 -1
- package/dist/client/database/base.d.ts.map +1 -1
- package/dist/client/database/base.js +196 -1
- package/dist/client/database/base.js.map +1 -1
- package/dist/client/database/client.d.ts +21 -5
- package/dist/client/database/client.d.ts.map +1 -1
- package/dist/client/database/client.js +39 -1
- package/dist/client/database/client.js.map +1 -1
- package/dist/client/database/index.d.ts +60 -4
- package/dist/client/database/index.d.ts.map +1 -1
- package/dist/client/database/index.js.map +1 -1
- package/dist/client/index.d.ts +4 -2
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +4 -2
- package/dist/client/index.js.map +1 -1
- package/dist/client/model/base.d.ts +553 -136
- package/dist/client/model/base.d.ts.map +1 -1
- package/dist/client/model/base.js +1 -6
- package/dist/client/model/base.js.map +1 -1
- package/dist/client/model/client.d.ts +45 -8
- package/dist/client/model/client.d.ts.map +1 -1
- package/dist/client/model/client.js +58 -2
- package/dist/client/model/client.js.map +1 -1
- package/dist/client/model/filters.d.ts +276 -0
- package/dist/client/model/filters.d.ts.map +1 -0
- package/dist/client/model/filters.js +470 -0
- package/dist/client/model/filters.js.map +1 -0
- package/dist/client/model/normalizer.d.ts +127 -3
- package/dist/client/model/normalizer.d.ts.map +1 -1
- package/dist/client/model/normalizer.js +526 -106
- package/dist/client/model/normalizer.js.map +1 -1
- package/dist/client/nodes.d.ts +62 -0
- package/dist/client/nodes.d.ts.map +1 -0
- package/dist/client/nodes.js +378 -0
- package/dist/client/nodes.js.map +1 -0
- package/dist/client/pagination/cursor.d.ts +40 -0
- package/dist/client/pagination/cursor.d.ts.map +1 -0
- package/dist/client/pagination/cursor.js +79 -0
- package/dist/client/pagination/cursor.js.map +1 -0
- package/dist/client/pagination/page.d.ts +23 -0
- package/dist/client/pagination/page.d.ts.map +1 -0
- package/dist/client/pagination/page.js +37 -0
- package/dist/client/pagination/page.js.map +1 -0
- package/dist/client/transaction/index.js.map +1 -1
- package/dist/client/transaction/occ-retry.d.ts +2 -2
- package/dist/client/transaction/occ-retry.d.ts.map +1 -1
- package/dist/client/transaction/occ-retry.js.map +1 -1
- package/dist/client/transaction/transaction-client.d.ts +4 -6
- package/dist/client/transaction/transaction-client.d.ts.map +1 -1
- package/dist/client/transaction/transaction-client.js +7 -18
- package/dist/client/transaction/transaction-client.js.map +1 -1
- package/dist/client/union/client.d.ts +55 -0
- package/dist/client/union/client.d.ts.map +1 -0
- package/dist/client/union/client.js +74 -0
- package/dist/client/union/client.js.map +1 -0
- package/dist/index.d.ts +5 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -2
- package/dist/index.js.map +1 -1
- package/dist/pg/index.d.ts +13 -1
- package/dist/pg/index.d.ts.map +1 -1
- package/dist/pg/index.js +52 -5
- package/dist/pg/index.js.map +1 -1
- package/dist/pglite/index.d.ts +7 -6
- package/dist/pglite/index.d.ts.map +1 -1
- package/dist/pglite/index.js +18 -4
- package/dist/pglite/index.js.map +1 -1
- package/dist/schema/columns/array.d.ts +12 -8
- package/dist/schema/columns/array.d.ts.map +1 -1
- package/dist/schema/columns/array.js +11 -14
- package/dist/schema/columns/array.js.map +1 -1
- package/dist/schema/columns/bigint.d.ts +1 -1
- package/dist/schema/columns/bigint.d.ts.map +1 -1
- package/dist/schema/columns/bigint.js +1 -0
- package/dist/schema/columns/bigint.js.map +1 -1
- package/dist/schema/columns/boolean.d.ts +1 -1
- package/dist/schema/columns/boolean.d.ts.map +1 -1
- package/dist/schema/columns/boolean.js +1 -0
- package/dist/schema/columns/boolean.js.map +1 -1
- package/dist/schema/columns/bytea.d.ts +1 -1
- package/dist/schema/columns/bytea.d.ts.map +1 -1
- package/dist/schema/columns/bytea.js +1 -0
- package/dist/schema/columns/bytea.js.map +1 -1
- package/dist/schema/columns/char.d.ts +1 -1
- package/dist/schema/columns/char.d.ts.map +1 -1
- package/dist/schema/columns/char.js +1 -0
- package/dist/schema/columns/char.js.map +1 -1
- package/dist/schema/columns/date.d.ts +3 -3
- package/dist/schema/columns/date.d.ts.map +1 -1
- package/dist/schema/columns/date.js +1 -0
- package/dist/schema/columns/date.js.map +1 -1
- package/dist/schema/columns/double.d.ts +1 -1
- package/dist/schema/columns/double.d.ts.map +1 -1
- package/dist/schema/columns/double.js +1 -0
- package/dist/schema/columns/double.js.map +1 -1
- package/dist/schema/columns/guid.d.ts +57 -0
- package/dist/schema/columns/guid.d.ts.map +1 -0
- package/dist/schema/columns/guid.js +53 -0
- package/dist/schema/columns/guid.js.map +1 -0
- package/dist/schema/columns/identity.d.ts +6 -6
- package/dist/schema/columns/identity.d.ts.map +1 -1
- package/dist/schema/columns/identity.js +2 -0
- package/dist/schema/columns/identity.js.map +1 -1
- package/dist/schema/columns/int.d.ts +1 -1
- package/dist/schema/columns/int.d.ts.map +1 -1
- package/dist/schema/columns/int.js +1 -0
- package/dist/schema/columns/int.js.map +1 -1
- package/dist/schema/columns/interval.d.ts +4 -3
- package/dist/schema/columns/interval.d.ts.map +1 -1
- package/dist/schema/columns/interval.js +1 -0
- package/dist/schema/columns/interval.js.map +1 -1
- package/dist/schema/columns/json.d.ts +79 -2
- package/dist/schema/columns/json.d.ts.map +1 -1
- package/dist/schema/columns/json.js +158 -8
- package/dist/schema/columns/json.js.map +1 -1
- package/dist/schema/columns/numeric.d.ts +20 -3
- package/dist/schema/columns/numeric.d.ts.map +1 -1
- package/dist/schema/columns/numeric.js +60 -4
- package/dist/schema/columns/numeric.js.map +1 -1
- package/dist/schema/columns/real.d.ts +1 -1
- package/dist/schema/columns/real.d.ts.map +1 -1
- package/dist/schema/columns/real.js +1 -0
- package/dist/schema/columns/real.js.map +1 -1
- package/dist/schema/columns/record.d.ts +20 -0
- package/dist/schema/columns/record.d.ts.map +1 -0
- package/dist/schema/columns/record.js +21 -0
- package/dist/schema/columns/record.js.map +1 -0
- package/dist/schema/columns/smallint.d.ts +1 -1
- package/dist/schema/columns/smallint.d.ts.map +1 -1
- package/dist/schema/columns/smallint.js +1 -0
- package/dist/schema/columns/smallint.js.map +1 -1
- package/dist/schema/columns/text.d.ts +1 -1
- package/dist/schema/columns/text.d.ts.map +1 -1
- package/dist/schema/columns/text.js +1 -0
- package/dist/schema/columns/text.js.map +1 -1
- package/dist/schema/columns/time.d.ts +3 -3
- package/dist/schema/columns/time.d.ts.map +1 -1
- package/dist/schema/columns/time.js +1 -0
- package/dist/schema/columns/time.js.map +1 -1
- package/dist/schema/columns/timestamp.d.ts +6 -6
- package/dist/schema/columns/timestamp.d.ts.map +1 -1
- package/dist/schema/columns/timestamp.js +1 -0
- package/dist/schema/columns/timestamp.js.map +1 -1
- package/dist/schema/columns/uuid.d.ts +1 -1
- package/dist/schema/columns/uuid.d.ts.map +1 -1
- package/dist/schema/columns/uuid.js +1 -0
- package/dist/schema/columns/uuid.js.map +1 -1
- package/dist/schema/columns/varchar.d.ts +1 -1
- package/dist/schema/columns/varchar.d.ts.map +1 -1
- package/dist/schema/columns/varchar.js +1 -0
- package/dist/schema/columns/varchar.js.map +1 -1
- package/dist/schema/domain.d.ts +2 -2
- package/dist/schema/domain.d.ts.map +1 -1
- package/dist/schema/domain.js +2 -0
- package/dist/schema/domain.js.map +1 -1
- package/dist/schema/embedded.d.ts +31 -0
- package/dist/schema/embedded.d.ts.map +1 -0
- package/dist/schema/embedded.js +33 -0
- package/dist/schema/embedded.js.map +1 -0
- package/dist/schema/index.d.ts +8 -1
- package/dist/schema/index.d.ts.map +1 -1
- package/dist/schema/index.js +6 -1
- package/dist/schema/index.js.map +1 -1
- package/dist/schema/namespace.js.map +1 -1
- package/dist/schema/relations.d.ts +17 -5
- package/dist/schema/relations.d.ts.map +1 -1
- package/dist/schema/relations.js +9 -0
- package/dist/schema/relations.js.map +1 -1
- package/dist/schema/sequence.js.map +1 -1
- package/dist/schema/table.d.ts +2 -2
- package/dist/schema/table.d.ts.map +1 -1
- package/dist/schema/table.js.map +1 -1
- package/dist/schema/tenant.d.ts +31 -0
- package/dist/schema/tenant.d.ts.map +1 -0
- package/dist/schema/tenant.js +33 -0
- package/dist/schema/tenant.js.map +1 -0
- package/dist/schema/union.d.ts +25 -0
- package/dist/schema/union.d.ts.map +1 -0
- package/dist/schema/union.js +27 -0
- package/dist/schema/union.js.map +1 -0
- package/dist/schema/utils/column-validation.d.ts +19 -0
- package/dist/schema/utils/column-validation.d.ts.map +1 -0
- package/dist/schema/utils/column-validation.js +37 -0
- package/dist/schema/utils/column-validation.js.map +1 -0
- package/dist/schema/utils/date.js.map +1 -1
- package/dist/schema/utils/duration.d.ts +2 -2
- package/dist/schema/utils/duration.d.ts.map +1 -1
- package/dist/schema/utils/duration.js.map +1 -1
- package/dist/schema/utils/global-id.d.ts +67 -0
- package/dist/schema/utils/global-id.d.ts.map +1 -0
- package/dist/schema/utils/global-id.js +99 -0
- package/dist/schema/utils/global-id.js.map +1 -0
- package/dist/schema/utils/standard-schema.d.ts +30 -0
- package/dist/schema/utils/standard-schema.d.ts.map +1 -0
- package/dist/schema/utils/standard-schema.js +2 -0
- package/dist/schema/utils/standard-schema.js.map +1 -0
- package/package.json +21 -16
- package/dist/schema/utils/json.d.ts +0 -2
- package/dist/schema/utils/json.d.ts.map +0 -1
- package/dist/schema/utils/json.js +0 -12
- package/dist/schema/utils/json.js.map +0 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/client/nodes.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n AnyColumn,\n AnyColumnDefinition,\n AnyFieldRelation,\n AnyTable,\n AnyTableDefinition,\n ColumnCodec,\n DefinitionSchema,\n SchemaRegistry,\n TableDefinition,\n UnionDefinition,\n} from \"@dsqlbase/core\";\nimport { AnyUnionColumnDefinition, columnEntries } from \"@dsqlbase/core/definition\";\nimport { GuidColumnDefinition } from \"../schema/columns/guid.js\";\nimport {\n GlobalIdError,\n decodeGlobalId,\n encodeGlobalId,\n isGlobalId,\n} from \"../schema/utils/global-id.js\";\n\n/**\n * Stamped on every runtime column declared with `guid()`, carrying what its values need in\n * order to name a row.\n *\n * A `Column` copies a fixed set of fields off its definition and the guid marker is not one of\n * them — global ids are a client concern, and `@dsqlbase/core` has no opinion about the shape\n * of an id. So the client marks the columns itself, once, when it builds the registry.\n */\nexport const GUID_BINDING: unique symbol = Symbol.for(\"dsqlbase.guid.binding\");\n\nexport type GuidBinding = {\n /** The node this column's values name. */\n readonly key: string;\n\n /** The field the target node's primary key is addressed by (`id`, `membershipId`, …). */\n readonly keyField: string;\n};\n\n/**\n * Stamped on a keyless `guid()` column that is the `from` side of a belongs-to a union: its node\n * key is not fixed but read, row by row, from the relation's discriminator.\n */\nexport const DYNAMIC_GUID_BINDING: unique symbol = Symbol.for(\"dsqlbase.guid.dynamic\");\n\nexport type DynamicGuidBinding = {\n /** The source column holding the member alias — the node key — of each row. */\n readonly discriminator: AnyColumn;\n\n /** The discriminator's field name, as `create` / `update` data names it. */\n readonly discriminatorField: string;\n\n /** Member alias → the field its key is addressed by in a payload (`id`, …). */\n readonly members: Readonly<Record<string, string>>;\n};\n\n/** A table addressable by global id: one whose primary key is exactly one `guid()` column. */\nexport type NodeTable = {\n /** The node key ids carry — the table's schema alias, unless its key column overrode it. */\n readonly key: string;\n\n /** The key the client addresses this table by (`dsql.members`). */\n readonly alias: string;\n\n readonly table: AnyTable;\n\n /** The field name of the primary key (`id`), as the payload names it. */\n readonly keyField: string;\n\n readonly keyColumn: AnyColumn;\n};\n\n/**\n * Node tables per registry rather than per client.\n *\n * A transaction client and an identity client are derived from their parent's\n * `ExecutionContext`, so they share one `SchemaRegistry` — keying off it is what makes\n * `$findByGlobalId` work the same on all three without threading anything through.\n */\nconst NODES = new WeakMap<SchemaRegistry<DefinitionSchema>, Map<string, NodeTable>>();\n\n/** A guid column found in the schema, before its target has been resolved. */\ntype GuidColumn = {\n readonly table: AnyTable;\n readonly field: string;\n readonly column: AnyColumn;\n /** The declaration, kept only to key relation pairs by identity. */\n readonly definition: object;\n readonly key: string;\n};\n\nexport function getGuidBinding(column: AnyColumn): GuidBinding | undefined {\n return (column as unknown as Record<symbol, GuidBinding | undefined>)[GUID_BINDING];\n}\n\nexport function getDynamicGuidBinding(column: AnyColumn): DynamicGuidBinding | undefined {\n return (column as unknown as Record<symbol, DynamicGuidBinding | undefined>)[\n DYNAMIC_GUID_BINDING\n ];\n}\n\nfunction setGuidBinding(column: AnyColumn, binding: GuidBinding): void {\n Object.defineProperty(column, GUID_BINDING, {\n value: binding,\n enumerable: false,\n writable: false,\n configurable: true,\n });\n}\n\n/** The node tables of a registry, empty for one that was never registered. */\nexport function getNodes(registry: SchemaRegistry<DefinitionSchema>): Map<string, NodeTable> {\n return NODES.get(registry) ?? new Map();\n}\n\n/**\n * Resolves every `guid()` column in a schema against the tables it can reach, and marks it.\n *\n * Runs once, when the client is built, because this is the first point at which the whole\n * schema exists: a column that references another table needs that table's key *field* name,\n * and a column that is its own table's key needs the alias it is exported under. Neither is\n * knowable where the column is declared.\n */\nexport function registerNodes(\n registry: SchemaRegistry<DefinitionSchema>,\n schema: DefinitionSchema\n): Map<string, NodeTable> {\n const dynamic = collectDynamicColumns(registry, schema);\n const guidColumns = collectGuidColumns(registry, schema, dynamic);\n const nodes = collectNodes(guidColumns);\n\n for (const guidColumn of guidColumns) {\n const node = nodes.get(guidColumn.key);\n\n if (!node) {\n throw new Error(\n `Column \"${guidColumn.table.alias}.${guidColumn.field}\" carries global ids for \"${guidColumn.key}\", ` +\n `which is not a node in this schema. A node is a table whose primary key is exactly one guid() column` +\n (nodes.size > 0\n ? `; this schema has ${[...nodes.keys()].map((key) => `\"${key}\"`).join(\", \")}.`\n : \".\")\n );\n }\n\n const binding: GuidBinding = { key: node.key, keyField: node.keyField };\n\n setGuidBinding(guidColumn.column, binding);\n bindGuidCodec(guidColumn.column, binding);\n }\n\n for (const { column, binding } of dynamic.values()) {\n for (const [member, keyField] of Object.entries(binding.members)) {\n if (nodes.get(member)?.keyField !== keyField) {\n throw new Error(\n `Column \"${column.table.alias}.${column.name}\" reads its node from a discriminator, ` +\n `but union member \"${member}\" is not a node keyed by \"${keyField}\". Every member a ` +\n `polymorphic guid() can name must be a node, related through its own key.`\n );\n }\n }\n\n bindDynamicGuid(column, binding);\n }\n\n validateRelationPairs(registry, new Map(guidColumns.map((c) => [c.definition, c.key])), dynamic);\n\n NODES.set(registry, nodes);\n\n return nodes;\n}\n\n/**\n * Refuses a relation that pairs a guid column with something it cannot agree with.\n *\n * `article.authorId === article.author.id` is the promise a keyed guid column makes, and it\n * only holds if both sides of every pair wrap with the same node. A guid paired with a plain\n * uuid leaves one side wrapped and the other raw; two guids with different keys produce two\n * different strings for one row. Neither breaks the SQL — a join correlates on raw columns —\n * which is exactly why it has to be caught when the client is built rather than in production.\n */\nfunction validateRelationPairs(\n registry: SchemaRegistry<DefinitionSchema>,\n keys: Map<object, string>,\n dynamic: Map<object, DynamicColumn>\n): void {\n for (const [alias] of registry.getTableEntries()) {\n if (!registry.hasRelations(alias)) {\n continue;\n }\n\n const relations = registry.getRelations(alias) as Record<string, AnyFieldRelation>;\n\n for (const [field, relation] of Object.entries(relations)) {\n const label = `Relation \"${field}\" on table \"${alias}\"`;\n\n for (const [target, to, member] of targetColumnLists(relation)) {\n for (const [index, fromColumn] of relation.from.entries()) {\n const toColumn = to[index];\n\n if (!toColumn) {\n continue;\n }\n\n // A polymorphic column names whichever member its discriminator says, so it agrees\n // with any member — and with nothing that is not one.\n const fromDynamic = dynamic.get(fromColumn);\n const toDynamic = dynamic.get(toColumn);\n const fromKey = fromDynamic ? (member ?? POLYMORPHIC) : keys.get(fromColumn);\n const toKey = toDynamic ? agreeWith(toDynamic, fromKey) : keys.get(toColumn);\n\n if (fromKey === undefined && toKey === undefined) {\n continue;\n }\n\n const pair = `\"${alias}.${fromColumn.name}\" and \"${target}.${toColumn.name}\"`;\n\n if (fromKey === undefined || toKey === undefined) {\n throw new Error(\n `${label} pairs ${pair}, but only one of them carries global ids. ` +\n `Both sides of a pair must be guid() columns, or neither.`\n );\n }\n\n if (fromKey !== toKey) {\n throw new Error(\n `${label} pairs ${pair}, which carry global ids for \"${fromKey}\" and \"${toKey}\". ` +\n `Both sides of a pair must name the same node.`\n );\n }\n }\n }\n }\n }\n}\n\n/**\n * A relation's `to` side as one column list per target table: the table itself, or every\n * member of a union target — through a shared field or a per-member list.\n */\nfunction targetColumnLists(\n relation: AnyFieldRelation\n): [target: string, to: AnyColumnDefinition[], member?: string][] {\n const { target, to } = relation;\n\n if (!(target instanceof UnionDefinition)) {\n return [[target.name, to as AnyColumnDefinition[]]];\n }\n\n return Object.entries<AnyTableDefinition>(target.members).map(([alias, member]) => [\n member.name,\n Array.isArray(to)\n ? (to as AnyUnionColumnDefinition[]).map((column) => column.members[alias])\n : (to as Record<string, AnyColumnDefinition[]>)[alias],\n alias,\n ]);\n}\n\n/** How a polymorphic column is named in a pair error when no single node fits. */\nconst POLYMORPHIC = \"(any member, per its discriminator)\";\n\n/** The key a polymorphic `to` column agrees on with `fromKey`: that key when it is a member. */\nfunction agreeWith(column: DynamicColumn, fromKey: string | undefined): string {\n return fromKey !== undefined && Object.hasOwn(column.binding.members, fromKey)\n ? fromKey\n : POLYMORPHIC;\n}\n\n/** A keyless `guid()` found on the `from` side of a belongs-to a union. */\ntype DynamicColumn = {\n readonly column: AnyColumn;\n readonly binding: DynamicGuidBinding;\n};\n\n/**\n * Finds every `guid()` column whose node is named per row by a discriminator — the `from` side of\n * a belongs-to a union — keyed by its declaration.\n *\n * Such a column must be declared keyless: a static key would say \"always this node\" while the\n * discriminator says \"whichever member this row names\", and only one of them can be true.\n */\nfunction collectDynamicColumns(\n registry: SchemaRegistry<DefinitionSchema>,\n schema: DefinitionSchema\n): Map<object, DynamicColumn> {\n const dynamic = new Map<object, DynamicColumn>();\n\n for (const [alias, node] of Object.entries(schema)) {\n if (!(node instanceof TableDefinition) || !registry.hasRelations(alias)) {\n continue;\n }\n\n const table = registry.getTable(alias);\n const relations = registry.getRelations(alias) as Record<string, AnyFieldRelation>;\n\n for (const [field, relation] of Object.entries(relations)) {\n const discriminator = registry.getRelationDiscriminator(alias, field);\n\n if (!discriminator) {\n continue;\n }\n\n const pairs = registry.getUnionRelationColumns(alias, field);\n const discriminatorField = fieldOf(table, discriminator);\n\n for (const [index, definition] of relation.from.entries()) {\n if (!(definition instanceof GuidColumnDefinition)) {\n continue;\n }\n\n const label = `Column \"${alias}.${fieldOf(table, table.getColumn(definition.name) as AnyColumn)}\"`;\n\n if (definition[\"_guidKey\"] !== undefined) {\n throw new Error(\n `${label} names node \"${definition[\"_guidKey\"] as string}\", but relation \"${field}\" ` +\n `reads its node from discriminator \"${discriminatorField}\". Declare it keyless — ` +\n `guid(\"${definition.name}\") — so the discriminator decides.`\n );\n }\n\n if (dynamic.has(definition)) {\n throw new Error(\n `${label} is the polymorphic side of two relations; a discriminated guid() can ` +\n `belong to only one.`\n );\n }\n\n const members = Object.fromEntries(\n Object.entries(pairs).map(([member, to]) => [\n member,\n fieldOf(registry.getTable(member), to[index]),\n ])\n );\n\n dynamic.set(definition, {\n column: table.getColumn(definition.name) as AnyColumn,\n binding: { discriminator, discriminatorField, members },\n });\n }\n }\n }\n\n return dynamic;\n}\n\n/** The field a runtime column is declared under on its table. */\nfunction fieldOf(table: AnyTable, column: AnyColumn): string {\n const entry = table.getColumnEntries().find(([, candidate]) => candidate === column);\n\n return entry?.[0] ?? column.name;\n}\n\n/**\n * Binds a polymorphic guid column: reads wrap with the node its row's discriminator names, and\n * writes and filters accept an id for any member, down to the raw key.\n *\n * Reading needs the discriminator, which the codec never sees — it decodes one value — so the\n * wrap is a row decoder instead, which core projects the discriminator for. A row whose\n * discriminator is `NULL`, or names no member, reads its id raw.\n */\nfunction bindDynamicGuid(column: AnyColumn, binding: DynamicGuidBinding): void {\n const base = column.codec as ColumnCodec<unknown, unknown>;\n const { discriminator, members } = binding;\n\n Object.defineProperty(column, DYNAMIC_GUID_BINDING, {\n value: binding,\n enumerable: false,\n writable: false,\n configurable: true,\n });\n\n Object.defineProperty(column, \"codec\", {\n value: {\n decode: base.decode,\n encode: (value: unknown) => base.encode(unwrapMember(value, members)),\n } satisfies ColumnCodec<unknown, unknown>,\n enumerable: true,\n writable: false,\n configurable: true,\n });\n\n Object.defineProperty(column, \"rowDecoder\", {\n value: {\n dependsOn: [discriminator],\n decode: (raw: unknown, row: Record<string, unknown>) => {\n const key = row[discriminator.name];\n const value = base.decode(raw);\n\n if (typeof key !== \"string\" || !Object.hasOwn(members, key)) {\n return value;\n }\n\n return encodeGlobalId(key, { [members[key]]: value as string });\n },\n },\n enumerable: false,\n writable: false,\n configurable: true,\n });\n}\n\n/**\n * The member a wrapped id names, checked against the union: its key must be a member, and its\n * payload must carry that member's key field. `undefined` for a value that is not a global id.\n */\nexport function decodeMemberId(\n value: unknown,\n members: Readonly<Record<string, string>>\n): { key: string; value: string } | undefined {\n if (!isGlobalId(value)) {\n return undefined;\n }\n\n const { key, pk } = decodeGlobalId(value);\n const keyField = members[key];\n\n if (keyField === undefined) {\n throw new GlobalIdError(\n \"key_mismatch\",\n `Global id for \"${key}\" cannot be stored here: this column holds ids for ` +\n `${Object.keys(members).map((member) => `\"${member}\"`).join(\", \")}.`\n );\n }\n\n if (!Object.hasOwn(pk, keyField)) {\n throw new GlobalIdError(\n \"key_mismatch\",\n `Global id for \"${key}\" carries ${Object.keys(pk)\n .map((field) => `\"${field}\"`)\n .join(\", \")} rather than its key \"${keyField}\".`\n );\n }\n\n return { key, value: pk[keyField] };\n}\n\nfunction unwrapMember(value: unknown, members: Readonly<Record<string, string>>): unknown {\n return decodeMemberId(value, members)?.value ?? value;\n}\n\n/**\n * Replaces a guid column's codec with one that wraps on the way out and unwraps on the way in.\n *\n * `Column` funnels every direction through this one object — `resolve` decodes a row value,\n * `getInsertValue` / `getUpdateValue` encode a written one, and `param` encodes a filter value —\n * so swapping it here covers reads, writes and `where` without touching the pipeline.\n *\n * Written onto the built column rather than onto the definition. The definition is the user's\n * object and may be shared by two clients; a binding depends on the alias it was exported\n * under, so binding there would let one client silently re-key the other's ids.\n */\nfunction bindGuidCodec(column: AnyColumn, binding: GuidBinding): void {\n const { key, keyField } = binding;\n const base = column.codec as ColumnCodec<unknown, unknown>;\n\n const codec: ColumnCodec<unknown, unknown> = {\n decode: (raw) => encodeGlobalId(key, { [keyField]: base.decode(raw) as string }),\n encode: (value) => base.encode(unwrap(value, key, keyField)),\n };\n\n // `codec` is declared readonly on `Column`, which is a compile-time rule; the property\n // itself is an ordinary own property. Same escape hatch as the `column[\"_tenantKey\"]`\n // writes in `tenantScope().columns()`.\n Object.defineProperty(column, \"codec\", {\n value: codec,\n enumerable: true,\n writable: false,\n configurable: true,\n });\n}\n\n/**\n * Reads a written or filtered value back down to what the column stores.\n *\n * Lenient by design: a raw uuid is accepted, because ids reach an application from places\n * that never went through the ORM. A *wrapped* id, though, is checked — that is the whole\n * point of carrying the table in the value. `decodeGlobalId` catches the wrong table; the\n * field check below catches a payload that names the right table but the wrong key.\n */\nfunction unwrap(value: unknown, key: string, keyField: string): unknown {\n if (!isGlobalId(value)) {\n return value;\n }\n\n const { pk } = decodeGlobalId(value, key);\n\n if (!Object.hasOwn(pk, keyField)) {\n throw new GlobalIdError(\n \"key_mismatch\",\n `Global id for \"${key}\" carries ${Object.keys(pk)\n .map((field) => `\"${field}\"`)\n .join(\", \")} rather than its key \"${keyField}\".`\n );\n }\n\n return pk[keyField];\n}\n\nfunction collectGuidColumns(\n registry: SchemaRegistry<DefinitionSchema>,\n schema: DefinitionSchema,\n dynamic: Map<object, DynamicColumn>\n): GuidColumn[] {\n const guidColumns: GuidColumn[] = [];\n\n // Walked over the *definitions* rather than the registry's tables, because `guid()` is a\n // subclass of `ColumnDefinition` and nothing about it survives into the runtime column. The\n // definition object's keys are the aliases, which is also what a node key defaults to.\n for (const [alias, node] of Object.entries(schema)) {\n if (!(node instanceof TableDefinition)) {\n continue;\n }\n\n const table = registry.getTable(alias);\n // A column group's members are walked too, by field path: a `guid()` member carries ids\n // like any other column, and is reached through its group on both sides.\n const columns = new Map(\n table.getLeafEntries().map(([path, column]) => [path.join(\".\"), column])\n );\n\n for (const [path, definition] of columnEntries(node.columns)) {\n // A polymorphic column has no fixed node; it is bound separately.\n if (!(definition instanceof GuidColumnDefinition) || dynamic.has(definition)) {\n continue;\n }\n\n const field = path.join(\".\");\n const column = columns.get(field);\n\n if (!column) {\n continue;\n }\n\n guidColumns.push({\n table,\n field,\n column,\n definition,\n key: (definition[\"_guidKey\"] as string | undefined) ?? alias,\n });\n }\n }\n\n return guidColumns;\n}\n\nfunction collectNodes(guidColumns: GuidColumn[]): Map<string, NodeTable> {\n const nodes = new Map<string, NodeTable>();\n\n for (const guidColumn of guidColumns) {\n const { table, field, column, key } = guidColumn;\n\n // A node is addressed by a single value, so a composite key cannot be one: `guid()` has no\n // way to declare the other half. Such a table is simply not a node, and a column pointing\n // at it fails the \"not a node in this schema\" check above.\n if (table.primaryKey.length !== 1 || table.primaryKey[0] !== column) {\n continue;\n }\n\n const existing = nodes.get(key);\n\n if (existing) {\n throw new Error(\n `Tables \"${existing.alias}\" and \"${table.alias}\" both claim the node key \"${key}\". ` +\n `A global id names exactly one table, so two nodes cannot share a key; pass a distinct ` +\n `key to guid() on one of them.`\n );\n }\n\n nodes.set(key, { key, alias: table.alias, table, keyField: field, keyColumn: column });\n }\n\n return nodes;\n}\n"]}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/** What was wrong with a cursor. */
|
|
2
|
+
export type InvalidCursorCode =
|
|
3
|
+
/** Not a readable cursor at all. */
|
|
4
|
+
"format"
|
|
5
|
+
/** A cursor from another version of the format. */
|
|
6
|
+
| "version"
|
|
7
|
+
/** A readable cursor taken under another table or another order. */
|
|
8
|
+
| "mismatch";
|
|
9
|
+
/**
|
|
10
|
+
* A cursor could not be used for this page.
|
|
11
|
+
*
|
|
12
|
+
* Thrown before any SQL is built. `mismatch` is the one a caller is most likely to meet: a
|
|
13
|
+
* cursor reused after the `orderBy` changed, or handed to another model.
|
|
14
|
+
*/
|
|
15
|
+
export declare class InvalidCursorError extends Error {
|
|
16
|
+
readonly code: InvalidCursorCode;
|
|
17
|
+
constructor(code: InvalidCursorCode, message: string);
|
|
18
|
+
}
|
|
19
|
+
/** The format version every cursor this build writes starts with. */
|
|
20
|
+
export declare const CURSOR_PREFIX = "c1.";
|
|
21
|
+
/** One key of the total order a cursor is taken under. */
|
|
22
|
+
export type CursorKey = {
|
|
23
|
+
field: string;
|
|
24
|
+
direction: "asc" | "desc";
|
|
25
|
+
};
|
|
26
|
+
/**
|
|
27
|
+
* The first 8 hex characters of SHA-256 over the table alias and the ordered keys.
|
|
28
|
+
*
|
|
29
|
+
* Enough to tell one order from another by accident; not a secret, and not meant to be — a
|
|
30
|
+
* forged cursor is only another position, and tenancy predicates apply to it regardless.
|
|
31
|
+
*/
|
|
32
|
+
export declare function keysetSignature(alias: string, keys: CursorKey[]): string;
|
|
33
|
+
/** `c1.` + base64url of the JSON `[signature, ...values]`. */
|
|
34
|
+
export declare function encodeCursor(signature: string, values: (string | null)[]): string;
|
|
35
|
+
/**
|
|
36
|
+
* Reads a cursor back into its key values, refusing one taken under any order other than
|
|
37
|
+
* `signature` or carrying a different number of keys.
|
|
38
|
+
*/
|
|
39
|
+
export declare function decodeCursor(cursor: string, signature: string, keyCount: number): (string | null)[];
|
|
40
|
+
//# sourceMappingURL=cursor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/client/pagination/cursor.ts"],"names":[],"mappings":"AAUA,oCAAoC;AACpC,MAAM,MAAM,iBAAiB;AAC3B,oCAAoC;AAClC,QAAQ;AACV,mDAAmD;GACjD,SAAS;AACX,oEAAoE;GAClE,UAAU,CAAC;AAEf;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAMrD;AAED,qEAAqE;AACrE,eAAO,MAAM,aAAa,QAAQ,CAAC;AAInC,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAIxE;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM,CAIjF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAqCnB"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Keyset cursors: the position of one row under one total order.
|
|
3
|
+
*
|
|
4
|
+
* A cursor carries the database's own text for each order key — never a decoded JS value,
|
|
5
|
+
* which may have lost precision the database still compares on — plus a signature of the
|
|
6
|
+
* order it was taken under. It carries no `where`, `select` or `join`: the caller supplies those
|
|
7
|
+
* again on every page, so a cursor grants nothing a `where` value could not.
|
|
8
|
+
*/
|
|
9
|
+
import { createHash } from "node:crypto";
|
|
10
|
+
/**
|
|
11
|
+
* A cursor could not be used for this page.
|
|
12
|
+
*
|
|
13
|
+
* Thrown before any SQL is built. `mismatch` is the one a caller is most likely to meet: a
|
|
14
|
+
* cursor reused after the `orderBy` changed, or handed to another model.
|
|
15
|
+
*/
|
|
16
|
+
export class InvalidCursorError extends Error {
|
|
17
|
+
code;
|
|
18
|
+
constructor(code, message) {
|
|
19
|
+
super(message);
|
|
20
|
+
this.name = "InvalidCursorError";
|
|
21
|
+
this.code = code;
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
/** The format version every cursor this build writes starts with. */
|
|
25
|
+
export const CURSOR_PREFIX = "c1.";
|
|
26
|
+
const VERSIONED = /^c\d+\./;
|
|
27
|
+
/**
|
|
28
|
+
* The first 8 hex characters of SHA-256 over the table alias and the ordered keys.
|
|
29
|
+
*
|
|
30
|
+
* Enough to tell one order from another by accident; not a secret, and not meant to be — a
|
|
31
|
+
* forged cursor is only another position, and tenancy predicates apply to it regardless.
|
|
32
|
+
*/
|
|
33
|
+
export function keysetSignature(alias, keys) {
|
|
34
|
+
const order = keys.map(({ field, direction }) => `${field}:${direction}`).join(",");
|
|
35
|
+
return createHash("sha256").update(`${alias}|${order}`).digest("hex").slice(0, 8);
|
|
36
|
+
}
|
|
37
|
+
/** `c1.` + base64url of the JSON `[signature, ...values]`. */
|
|
38
|
+
export function encodeCursor(signature, values) {
|
|
39
|
+
const payload = JSON.stringify([signature, ...values]);
|
|
40
|
+
return `${CURSOR_PREFIX}${Buffer.from(payload, "utf8").toString("base64url")}`;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Reads a cursor back into its key values, refusing one taken under any order other than
|
|
44
|
+
* `signature` or carrying a different number of keys.
|
|
45
|
+
*/
|
|
46
|
+
export function decodeCursor(cursor, signature, keyCount) {
|
|
47
|
+
if (typeof cursor !== "string" || !VERSIONED.test(cursor)) {
|
|
48
|
+
throw new InvalidCursorError("format", `"${String(cursor)}" is not a cursor.`);
|
|
49
|
+
}
|
|
50
|
+
if (!cursor.startsWith(CURSOR_PREFIX)) {
|
|
51
|
+
throw new InvalidCursorError("version", `"${cursor}" is from another cursor format; this client reads "${CURSOR_PREFIX}".`);
|
|
52
|
+
}
|
|
53
|
+
const payload = decodePayload(cursor);
|
|
54
|
+
if (!Array.isArray(payload) || typeof payload[0] !== "string") {
|
|
55
|
+
throw new InvalidCursorError("format", `"${cursor}" does not carry a [signature, ...] payload.`);
|
|
56
|
+
}
|
|
57
|
+
const [taken, ...values] = payload;
|
|
58
|
+
if (taken !== signature || values.length !== keyCount) {
|
|
59
|
+
throw new InvalidCursorError("mismatch", `"${cursor}" was taken under another table or order; pass the same orderBy it came from.`);
|
|
60
|
+
}
|
|
61
|
+
for (const value of values) {
|
|
62
|
+
if (typeof value !== "string" && value !== null) {
|
|
63
|
+
throw new InvalidCursorError("format", `"${cursor}" carries a key that is not text.`);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
return values;
|
|
67
|
+
}
|
|
68
|
+
function decodePayload(cursor) {
|
|
69
|
+
// `Buffer.from(..., "base64url")` never throws — it drops whatever it cannot read — so
|
|
70
|
+
// malformed base64 surfaces here as JSON that does not parse.
|
|
71
|
+
const json = Buffer.from(cursor.slice(CURSOR_PREFIX.length), "base64url").toString("utf8");
|
|
72
|
+
try {
|
|
73
|
+
return JSON.parse(json);
|
|
74
|
+
}
|
|
75
|
+
catch {
|
|
76
|
+
throw new InvalidCursorError("format", `"${cursor}" does not decode to a JSON payload.`);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
//# sourceMappingURL=cursor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/client/pagination/cursor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Keyset cursors: the position of one row under one total order.\n *\n * A cursor carries the database's own text for each order key — never a decoded JS value,\n * which may have lost precision the database still compares on — plus a signature of the\n * order it was taken under. It carries no `where`, `select` or `join`: the caller supplies those\n * again on every page, so a cursor grants nothing a `where` value could not.\n */\nimport { createHash } from \"node:crypto\";\n\n/** What was wrong with a cursor. */\nexport type InvalidCursorCode =\n /** Not a readable cursor at all. */\n | \"format\"\n /** A cursor from another version of the format. */\n | \"version\"\n /** A readable cursor taken under another table or another order. */\n | \"mismatch\";\n\n/**\n * A cursor could not be used for this page.\n *\n * Thrown before any SQL is built. `mismatch` is the one a caller is most likely to meet: a\n * cursor reused after the `orderBy` changed, or handed to another model.\n */\nexport class InvalidCursorError extends Error {\n readonly code: InvalidCursorCode;\n\n constructor(code: InvalidCursorCode, message: string) {\n super(message);\n\n this.name = \"InvalidCursorError\";\n this.code = code;\n }\n}\n\n/** The format version every cursor this build writes starts with. */\nexport const CURSOR_PREFIX = \"c1.\";\n\nconst VERSIONED = /^c\\d+\\./;\n\n/** One key of the total order a cursor is taken under. */\nexport type CursorKey = {\n field: string;\n direction: \"asc\" | \"desc\";\n};\n\n/**\n * The first 8 hex characters of SHA-256 over the table alias and the ordered keys.\n *\n * Enough to tell one order from another by accident; not a secret, and not meant to be — a\n * forged cursor is only another position, and tenancy predicates apply to it regardless.\n */\nexport function keysetSignature(alias: string, keys: CursorKey[]): string {\n const order = keys.map(({ field, direction }) => `${field}:${direction}`).join(\",\");\n\n return createHash(\"sha256\").update(`${alias}|${order}`).digest(\"hex\").slice(0, 8);\n}\n\n/** `c1.` + base64url of the JSON `[signature, ...values]`. */\nexport function encodeCursor(signature: string, values: (string | null)[]): string {\n const payload = JSON.stringify([signature, ...values]);\n\n return `${CURSOR_PREFIX}${Buffer.from(payload, \"utf8\").toString(\"base64url\")}`;\n}\n\n/**\n * Reads a cursor back into its key values, refusing one taken under any order other than\n * `signature` or carrying a different number of keys.\n */\nexport function decodeCursor(\n cursor: string,\n signature: string,\n keyCount: number\n): (string | null)[] {\n if (typeof cursor !== \"string\" || !VERSIONED.test(cursor)) {\n throw new InvalidCursorError(\"format\", `\"${String(cursor)}\" is not a cursor.`);\n }\n\n if (!cursor.startsWith(CURSOR_PREFIX)) {\n throw new InvalidCursorError(\n \"version\",\n `\"${cursor}\" is from another cursor format; this client reads \"${CURSOR_PREFIX}\".`\n );\n }\n\n const payload = decodePayload(cursor);\n\n if (!Array.isArray(payload) || typeof payload[0] !== \"string\") {\n throw new InvalidCursorError(\n \"format\",\n `\"${cursor}\" does not carry a [signature, ...] payload.`\n );\n }\n\n const [taken, ...values] = payload as [string, ...unknown[]];\n\n if (taken !== signature || values.length !== keyCount) {\n throw new InvalidCursorError(\n \"mismatch\",\n `\"${cursor}\" was taken under another table or order; pass the same orderBy it came from.`\n );\n }\n\n for (const value of values) {\n if (typeof value !== \"string\" && value !== null) {\n throw new InvalidCursorError(\"format\", `\"${cursor}\" carries a key that is not text.`);\n }\n }\n\n return values as (string | null)[];\n}\n\nfunction decodePayload(cursor: string): unknown {\n // `Buffer.from(..., \"base64url\")` never throws — it drops whatever it cannot read — so\n // malformed base64 surfaces here as JSON that does not parse.\n const json = Buffer.from(cursor.slice(CURSOR_PREFIX.length), \"base64url\").toString(\"utf8\");\n\n try {\n return JSON.parse(json);\n } catch {\n throw new InvalidCursorError(\"format\", `\"${cursor}\" does not decode to a JSON payload.`);\n }\n}\n"]}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { PagePlan } from "../model/normalizer.js";
|
|
2
|
+
/** A page before `totalCount` is attached. */
|
|
3
|
+
export type Page<TItem> = {
|
|
4
|
+
items: TItem[];
|
|
5
|
+
hasNextPage: boolean;
|
|
6
|
+
hasPreviousPage: boolean;
|
|
7
|
+
startCursor: string | null;
|
|
8
|
+
endCursor: string | null;
|
|
9
|
+
};
|
|
10
|
+
type ResolvedRecord = Record<string, unknown> & {
|
|
11
|
+
$$meta: Record<string, unknown>;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Turns the rows of a keyset select into a page.
|
|
15
|
+
*
|
|
16
|
+
* The select read one row more than the page holds, so whether another page follows in the
|
|
17
|
+
* direction of travel is whether that row came back. It is dropped before resolving. Each kept
|
|
18
|
+
* row's cursor is built from its hidden `__k<n>` columns — the database's own text — which the
|
|
19
|
+
* resolver never sees, so they are read off the raw rows here.
|
|
20
|
+
*/
|
|
21
|
+
export declare function shapePage(rows: unknown[], resolve: (rows: unknown[]) => unknown, plan: PagePlan): Page<ResolvedRecord>;
|
|
22
|
+
export {};
|
|
23
|
+
//# sourceMappingURL=page.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/client/pagination/page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,8CAA8C;AAC9C,MAAM,MAAM,IAAI,CAAC,KAAK,IAAI;IACxB,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAEpF;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACrC,IAAI,EAAE,QAAQ,GACb,IAAI,CAAC,cAAc,CAAC,CAgCtB"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { encodeCursor } from "./cursor.js";
|
|
2
|
+
/**
|
|
3
|
+
* Turns the rows of a keyset select into a page.
|
|
4
|
+
*
|
|
5
|
+
* The select read one row more than the page holds, so whether another page follows in the
|
|
6
|
+
* direction of travel is whether that row came back. It is dropped before resolving. Each kept
|
|
7
|
+
* row's cursor is built from its hidden `__k<n>` columns — the database's own text — which the
|
|
8
|
+
* resolver never sees, so they are read off the raw rows here.
|
|
9
|
+
*/
|
|
10
|
+
export function shapePage(rows, resolve, plan) {
|
|
11
|
+
const more = rows.length > plan.take;
|
|
12
|
+
const kept = (more ? rows.slice(0, plan.take) : rows);
|
|
13
|
+
const records = resolve(kept);
|
|
14
|
+
const items = records.map((record, index) => {
|
|
15
|
+
const values = plan.keys.map((_, key) => kept[index][`__k${key}`]);
|
|
16
|
+
const cursor = encodeCursor(plan.signature, values);
|
|
17
|
+
// `$$meta` is the table's frozen, shared meta object: copied, never written to.
|
|
18
|
+
return { ...record, $$meta: { ...record.$$meta, cursor } };
|
|
19
|
+
});
|
|
20
|
+
// `before` is only ever the bound when a cursor was passed with it.
|
|
21
|
+
const backward = plan.bound === "before";
|
|
22
|
+
// Read backwards, the page arrives nearest-the-cursor first; put it back in order.
|
|
23
|
+
if (backward) {
|
|
24
|
+
items.reverse();
|
|
25
|
+
}
|
|
26
|
+
// Only the direction of travel is known exactly. The other side is known to hold at least
|
|
27
|
+
// the cursor row whenever a cursor was passed.
|
|
28
|
+
const hasCursor = plan.cursor !== undefined;
|
|
29
|
+
return {
|
|
30
|
+
items,
|
|
31
|
+
hasNextPage: backward ? hasCursor : more,
|
|
32
|
+
hasPreviousPage: backward ? more : hasCursor,
|
|
33
|
+
startCursor: items[0]?.$$meta.cursor ?? null,
|
|
34
|
+
endCursor: items.at(-1)?.$$meta.cursor ?? null,
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=page.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../src/client/pagination/page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAa3C;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,IAAe,EACf,OAAqC,EACrC,IAAc;IAEd,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC;IACrC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAA8B,CAAC;IACnF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAqB,CAAC;IAElD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE,CAAkB,CAAC,CAAC;QACpF,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAEpD,gFAAgF;QAChF,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,oEAAoE;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC;IAEzC,mFAAmF;IACnF,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAED,0FAA0F;IAC1F,+CAA+C;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IAE5C,OAAO;QACL,KAAK;QACL,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;QACxC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC5C,WAAW,EAAG,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAA6B,IAAI,IAAI;QACpE,SAAS,EAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAA6B,IAAI,IAAI;KACvE,CAAC;AACJ,CAAC","sourcesContent":["import type { PagePlan } from \"../model/normalizer.js\";\nimport { encodeCursor } from \"./cursor.js\";\n\n/** A page before `totalCount` is attached. */\nexport type Page<TItem> = {\n items: TItem[];\n hasNextPage: boolean;\n hasPreviousPage: boolean;\n startCursor: string | null;\n endCursor: string | null;\n};\n\ntype ResolvedRecord = Record<string, unknown> & { $$meta: Record<string, unknown> };\n\n/**\n * Turns the rows of a keyset select into a page.\n *\n * The select read one row more than the page holds, so whether another page follows in the\n * direction of travel is whether that row came back. It is dropped before resolving. Each kept\n * row's cursor is built from its hidden `__k<n>` columns — the database's own text — which the\n * resolver never sees, so they are read off the raw rows here.\n */\nexport function shapePage(\n rows: unknown[],\n resolve: (rows: unknown[]) => unknown,\n plan: PagePlan\n): Page<ResolvedRecord> {\n const more = rows.length > plan.take;\n const kept = (more ? rows.slice(0, plan.take) : rows) as Record<string, unknown>[];\n const records = resolve(kept) as ResolvedRecord[];\n\n const items = records.map((record, index) => {\n const values = plan.keys.map((_, key) => kept[index][`__k${key}`] as string | null);\n const cursor = encodeCursor(plan.signature, values);\n\n // `$$meta` is the table's frozen, shared meta object: copied, never written to.\n return { ...record, $$meta: { ...record.$$meta, cursor } };\n });\n\n // `before` is only ever the bound when a cursor was passed with it.\n const backward = plan.bound === \"before\";\n\n // Read backwards, the page arrives nearest-the-cursor first; put it back in order.\n if (backward) {\n items.reverse();\n }\n\n // Only the direction of travel is known exactly. The other side is known to hold at least\n // the cursor row whenever a cursor was passed.\n const hasCursor = plan.cursor !== undefined;\n\n return {\n items,\n hasNextPage: backward ? hasCursor : more,\n hasPreviousPage: backward ? more : hasCursor,\n startCursor: (items[0]?.$$meta.cursor as string | undefined) ?? null,\n endCursor: (items.at(-1)?.$$meta.cursor as string | undefined) ?? null,\n };\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAiB,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/transaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAiB,uBAAuB,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["export { TransactionClient, type TxClient, createTransactionRunner } from \"./transaction-client.js\";\n"]}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
export
|
|
1
|
+
export type OCCRetryOptions = {
|
|
2
2
|
maxRetries?: number;
|
|
3
3
|
delay?: number;
|
|
4
4
|
maxDelay?: number;
|
|
5
|
-
}
|
|
5
|
+
};
|
|
6
6
|
export declare function backoffDelay(attempt: number, baseDelay: number, maxDelay: number): number;
|
|
7
7
|
export declare function sleep(ms: number): Promise<void>;
|
|
8
8
|
export declare function isOccError(error: unknown): boolean;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"occ-retry.d.ts","sourceRoot":"","sources":["../../../src/client/transaction/occ-retry.ts"],"names":[],"mappings":"AAAA,MAAM,
|
|
1
|
+
{"version":3,"file":"occ-retry.d.ts","sourceRoot":"","sources":["../../../src/client/transaction/occ-retry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIzF;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGlD"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"occ-retry.js","sourceRoot":"","sources":["../../../src/client/transaction/occ-retry.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,SAAiB,EAAE,QAAgB;IAC/E,MAAM,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,OAAQ,KAA2B,CAAC,IAAI,KAAK,OAAO,CAAC;AACvD,CAAC"}
|
|
1
|
+
{"version":3,"file":"occ-retry.js","sourceRoot":"","sources":["../../../src/client/transaction/occ-retry.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,SAAiB,EAAE,QAAgB;IAC/E,MAAM,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,OAAQ,KAA2B,CAAC,IAAI,KAAK,OAAO,CAAC;AACvD,CAAC","sourcesContent":["export type OCCRetryOptions = {\n maxRetries?: number;\n delay?: number;\n maxDelay?: number;\n};\n\nexport function backoffDelay(attempt: number, baseDelay: number, maxDelay: number): number {\n const delay = baseDelay * Math.pow(2, attempt);\n const jitter = Math.random() * delay * 0.1;\n return Math.min(delay + jitter, maxDelay);\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport function isOccError(error: unknown): boolean {\n if (!error || typeof error !== \"object\") return false;\n return (error as { code?: string }).code === \"40001\";\n}\n"]}
|
|
@@ -1,11 +1,9 @@
|
|
|
1
|
-
import { DefinitionSchema,
|
|
1
|
+
import { DefinitionSchema, Executable, ExecutionContext } from "@dsqlbase/core";
|
|
2
2
|
import { BaseClient } from "../database/base.js";
|
|
3
|
-
import { Models } from "../database/index.js";
|
|
3
|
+
import { Models, VisibleFor } from "../database/index.js";
|
|
4
4
|
import { OCCRetryOptions } from "./occ-retry.js";
|
|
5
5
|
export declare class TransactionClient<TDefinition extends DefinitionSchema> extends BaseClient<TDefinition> {
|
|
6
|
-
private readonly _session;
|
|
7
|
-
constructor(ctx: ExecutionContext<TDefinition>, session: TransactionSession);
|
|
8
6
|
}
|
|
9
|
-
export type TxClient<T extends DefinitionSchema> = TransactionClient<T> & Models<T
|
|
10
|
-
export declare function createTransactionRunner<TDefinition extends DefinitionSchema>(ctx: ExecutionContext<TDefinition>, options?: OCCRetryOptions): Promise<(<TReturn = unknown>(opsOrCallback:
|
|
7
|
+
export type TxClient<T extends DefinitionSchema, TClaims = never, TEnforce extends boolean = true> = ([TClaims] extends [never] ? TransactionClient<T> : Omit<TransactionClient<T>, "$query" | "$execute">) & Models<T, VisibleFor<T, TClaims, TEnforce>>;
|
|
8
|
+
export declare function createTransactionRunner<TDefinition extends DefinitionSchema, TClaims = never, TEnforce extends boolean = true>(ctx: ExecutionContext<TDefinition>, options?: OCCRetryOptions): Promise<(<TReturn = unknown>(opsOrCallback: Executable<unknown>[] | ((client: TxClient<TDefinition, TClaims, TEnforce>) => Promise<TReturn>), attempt?: number) => Promise<TReturn>)>;
|
|
11
9
|
//# sourceMappingURL=transaction-client.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transaction-client.d.ts","sourceRoot":"","sources":["../../../src/client/transaction/transaction-client.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"transaction-client.d.ts","sourceRoot":"","sources":["../../../src/client/transaction/transaction-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAA4B,eAAe,EAAS,MAAM,gBAAgB,CAAC;AAElF,qBAAa,iBAAiB,CAC5B,WAAW,SAAS,gBAAgB,CACpC,SAAQ,UAAU,CAAC,WAAW,CAAC;CAAG;AAEpC,MAAM,MAAM,QAAQ,CAClB,CAAC,SAAS,gBAAgB,EAC1B,OAAO,GAAG,KAAK,EACf,QAAQ,SAAS,OAAO,GAAG,IAAI,IAC7B,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,GAC1B,iBAAiB,CAAC,CAAC,CAAC,GACpB,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC,GACpD,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9C,wBAAsB,uBAAuB,CAC3C,WAAW,SAAS,gBAAgB,EACpC,OAAO,GAAG,KAAK,EACf,QAAQ,SAAS,OAAO,GAAG,IAAI,EAC/B,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE,OAAO,GAAE,eAAoB,aAcnD,OAAO,2BAEf,UAAU,CAAC,OAAO,CAAC,EAAE,GACrB,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,uBAE3E,OAAO,CAAC,OAAO,CAAC,GAmCpB"}
|
|
@@ -1,13 +1,7 @@
|
|
|
1
|
-
import { ExecutionContext
|
|
2
|
-
import { BaseClient } from "../database/base.js";
|
|
3
|
-
import { ModelClient } from "../model/client.js";
|
|
1
|
+
import { ExecutionContext } from "@dsqlbase/core";
|
|
2
|
+
import { attachModels, BaseClient } from "../database/base.js";
|
|
4
3
|
import { backoffDelay, isOccError, sleep } from "./occ-retry.js";
|
|
5
4
|
export class TransactionClient extends BaseClient {
|
|
6
|
-
_session;
|
|
7
|
-
constructor(ctx, session) {
|
|
8
|
-
super(ctx);
|
|
9
|
-
this._session = session;
|
|
10
|
-
}
|
|
11
5
|
}
|
|
12
6
|
export async function createTransactionRunner(ctx, options = {}) {
|
|
13
7
|
if (typeof ctx.session.beginTransaction !== "function") {
|
|
@@ -18,15 +12,8 @@ export async function createTransactionRunner(ctx, options = {}) {
|
|
|
18
12
|
...ctx,
|
|
19
13
|
session: session,
|
|
20
14
|
});
|
|
21
|
-
const txClient = new TransactionClient(context
|
|
22
|
-
|
|
23
|
-
const modelClient = new ModelClient(context, table);
|
|
24
|
-
Object.defineProperty(txClient, tableName, {
|
|
25
|
-
value: modelClient,
|
|
26
|
-
writable: false,
|
|
27
|
-
enumerable: true,
|
|
28
|
-
});
|
|
29
|
-
}
|
|
15
|
+
const txClient = new TransactionClient(context);
|
|
16
|
+
attachModels(txClient, context);
|
|
30
17
|
return async (opsOrCallback, attempt = 1) => {
|
|
31
18
|
const { maxRetries = 3, delay = 50, maxDelay = 1000 } = options;
|
|
32
19
|
try {
|
|
@@ -44,7 +31,9 @@ export async function createTransactionRunner(ctx, options = {}) {
|
|
|
44
31
|
return result;
|
|
45
32
|
}
|
|
46
33
|
catch (error) {
|
|
47
|
-
|
|
34
|
+
// The error that made it roll back is the one that counts: a rollback that fails too (the
|
|
35
|
+
// connection broke) must not replace it, or a `40001` would no longer be retried.
|
|
36
|
+
await session.rollback().catch(() => undefined);
|
|
48
37
|
if (isOccError(error) && attempt < maxRetries) {
|
|
49
38
|
await sleep(backoffDelay(attempt, delay, maxDelay));
|
|
50
39
|
const runner = await createTransactionRunner(ctx, options);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transaction-client.js","sourceRoot":"","sources":["../../../src/client/transaction/transaction-client.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"transaction-client.js","sourceRoot":"","sources":["../../../src/client/transaction/transaction-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAmB,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAElF,MAAM,OAAO,iBAEX,SAAQ,UAAuB;CAAG;AAWpC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAI3C,GAAkC,EAAE,UAA2B,EAAE;IACjE,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAc;QAChD,GAAG,GAAG;QACN,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAc,OAAO,CAAC,CAAC;IAC7D,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEhC,OAAO,KAAK,EACV,aAE4E,EAC5E,OAAO,GAAG,CAAC,EACO,EAAE;QACpB,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAEhE,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAc,EAAE,CAAC;gBAE9B,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;oBAC/B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;oBACjD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACvB,CAAC;gBAED,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvB,OAAO,OAAkB,CAAC;YAC5B,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC,QAA+D,CAChE,CAAC;YACF,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0FAA0F;YAC1F,kFAAkF;YAClF,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAEhD,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBAC9C,MAAM,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACpD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAiC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAC3F,OAAO,MAAM,CAAC,aAAa,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { DefinitionSchema, Executable, ExecutionContext } from \"@dsqlbase/core\";\nimport { attachModels, BaseClient } from \"../database/base.js\";\nimport { Models, VisibleFor } from \"../database/index.js\";\nimport { backoffDelay, isOccError, OCCRetryOptions, sleep } from \"./occ-retry.js\";\n\nexport class TransactionClient<\n TDefinition extends DefinitionSchema,\n> extends BaseClient<TDefinition> {}\n\nexport type TxClient<\n T extends DefinitionSchema,\n TClaims = never,\n TEnforce extends boolean = true,\n> = ([TClaims] extends [never]\n ? TransactionClient<T>\n : Omit<TransactionClient<T>, \"$query\" | \"$execute\">) &\n Models<T, VisibleFor<T, TClaims, TEnforce>>;\n\nexport async function createTransactionRunner<\n TDefinition extends DefinitionSchema,\n TClaims = never,\n TEnforce extends boolean = true,\n>(ctx: ExecutionContext<TDefinition>, options: OCCRetryOptions = {}) {\n if (typeof ctx.session.beginTransaction !== \"function\") {\n throw new Error(\"Session does not support transactions\");\n }\n\n const session = await ctx.session.beginTransaction();\n const context = new ExecutionContext<TDefinition>({\n ...ctx,\n session: session,\n });\n\n const txClient = new TransactionClient<TDefinition>(context);\n attachModels(txClient, context);\n\n return async <TReturn = unknown>(\n opsOrCallback:\n | Executable<unknown>[]\n | ((client: TxClient<TDefinition, TClaims, TEnforce>) => Promise<TReturn>),\n attempt = 1\n ): Promise<TReturn> => {\n const { maxRetries = 3, delay = 50, maxDelay = 1000 } = options;\n\n try {\n if (Array.isArray(opsOrCallback)) {\n const results: unknown[] = [];\n\n for (const op of opsOrCallback) {\n const result = await op.clone(session).execute();\n results.push(result);\n }\n\n await session.commit();\n return results as TReturn;\n }\n\n const result = await opsOrCallback(\n txClient as unknown as TxClient<TDefinition, TClaims, TEnforce>\n );\n await session.commit();\n return result;\n } catch (error) {\n // The error that made it roll back is the one that counts: a rollback that fails too (the\n // connection broke) must not replace it, or a `40001` would no longer be retried.\n await session.rollback().catch(() => undefined);\n\n if (isOccError(error) && attempt < maxRetries) {\n await sleep(backoffDelay(attempt, delay, maxDelay));\n const runner = await createTransactionRunner<TDefinition, TClaims, TEnforce>(ctx, options);\n return runner(opsOrCallback, attempt + 1);\n }\n\n throw error;\n }\n };\n}\n"]}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { DefinitionSchema } from "@dsqlbase/core";
|
|
2
|
+
import { AnyUnionMembers } from "@dsqlbase/core/definition";
|
|
3
|
+
import { Executable, ExecutableQuery, ExecutionContext, Schema, Union } from "@dsqlbase/core/runtime";
|
|
4
|
+
import { TypedObject } from "@dsqlbase/core/utils";
|
|
5
|
+
import { UnionCountArgs, UnionFindOneArgs, UnionPageOf, UnionPaginateArgs, UnionQueryArgs, UnionResultOf } from "../model/base.js";
|
|
6
|
+
/**
|
|
7
|
+
* Reads a `union()` as one set of rows: `dsql.<unionAlias>.findMany(...)` and friends. Read-only —
|
|
8
|
+
* a row is written through its member's own model.
|
|
9
|
+
*
|
|
10
|
+
* Every read is one `UNION ALL` over the members, each branch passing the same `WHERE` seam a
|
|
11
|
+
* table read does, so a tenant-scoped member is filtered, or refused, on its own terms.
|
|
12
|
+
*/
|
|
13
|
+
export declare class UnionClient<TMembers extends AnyUnionMembers, TDefinition extends DefinitionSchema> implements TypedObject<Schema<TDefinition>> {
|
|
14
|
+
readonly __type: Schema<TDefinition>;
|
|
15
|
+
private readonly _ctx;
|
|
16
|
+
private readonly _union;
|
|
17
|
+
private readonly _normalizer;
|
|
18
|
+
constructor(ctx: ExecutionContext<TDefinition>, union: Union);
|
|
19
|
+
/**
|
|
20
|
+
* Reads the first row, across every member, that `where` selects — in `orderBy` order when
|
|
21
|
+
* one is given.
|
|
22
|
+
*
|
|
23
|
+
* @example
|
|
24
|
+
* ```ts
|
|
25
|
+
* const post = await dsql.posts.findOne({ where: { id: { eq: postId } } });
|
|
26
|
+
* if (post?.$$key === "photos") post.photoUrl;
|
|
27
|
+
* ```
|
|
28
|
+
*/
|
|
29
|
+
findOne<TArgs extends UnionFindOneArgs<TMembers, this["__type"]>>(args: TArgs): ExecutableQuery<UnionResultOf<TMembers, this["__type"], TArgs> | null>;
|
|
30
|
+
/**
|
|
31
|
+
* Reads rows from every member, as one list.
|
|
32
|
+
*
|
|
33
|
+
* @example
|
|
34
|
+
* ```ts
|
|
35
|
+
* const feed = await dsql.posts.findMany({
|
|
36
|
+
* where: { userId: { eq: userId }, $$key: { in: types } },
|
|
37
|
+
* orderBy: { createdAt: "desc" },
|
|
38
|
+
* limit: 20,
|
|
39
|
+
* on: { photos: { select: { photoUrl: true } } },
|
|
40
|
+
* });
|
|
41
|
+
* ```
|
|
42
|
+
*/
|
|
43
|
+
findMany<TArgs extends UnionQueryArgs<TMembers, this["__type"]>>(args?: TArgs): ExecutableQuery<UnionResultOf<TMembers, this["__type"], TArgs>[]>;
|
|
44
|
+
/**
|
|
45
|
+
* One page across every member, ordered by `orderBy`, then `$$key`, then the primary key —
|
|
46
|
+
* with a cursor on each record to continue from. The same cursors as a table's, signed
|
|
47
|
+
* against the union.
|
|
48
|
+
*
|
|
49
|
+
* @throws {InvalidCursorError} when `after` or `before` is not a cursor for this order.
|
|
50
|
+
*/
|
|
51
|
+
paginate<TArgs extends UnionPaginateArgs<TMembers, this["__type"]>>(args: TArgs): Executable<UnionPageOf<TMembers, this["__type"], TArgs>>;
|
|
52
|
+
/** Counts the rows `where` selects, across every member. */
|
|
53
|
+
count(args?: UnionCountArgs<TMembers>): ExecutableQuery<number>;
|
|
54
|
+
}
|
|
55
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/union/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAEL,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,KAAK,EACN,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAEL,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,aAAa,EACd,MAAM,kBAAkB,CAAC;AAI1B;;;;;;GAMG;AACH,qBAAa,WAAW,CACtB,QAAQ,SAAS,eAAe,EAChC,WAAW,SAAS,gBAAgB,CACpC,YAAW,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,SAAiB,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;gBAEjD,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK;IAM5D;;;;;;;;;OASG;IACI,OAAO,CAAC,KAAK,SAAS,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EACrE,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;IAazE;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,KAAK,SAAS,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EACpE,IAAI,CAAC,EAAE,KAAK,GACX,eAAe,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;IAapE;;;;;;OAMG;IACI,QAAQ,CAAC,KAAK,SAAS,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EACvE,IAAI,EAAE,KAAK,GACV,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;IAyB3D,4DAA4D;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC;CAQvE"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { CompositeQuery, ExecutableQuery, } from "@dsqlbase/core/runtime";
|
|
2
|
+
import { RequestNormalizer } from "../model/normalizer.js";
|
|
3
|
+
import { shapePage } from "../pagination/page.js";
|
|
4
|
+
/**
|
|
5
|
+
* Reads a `union()` as one set of rows: `dsql.<unionAlias>.findMany(...)` and friends. Read-only —
|
|
6
|
+
* a row is written through its member's own model.
|
|
7
|
+
*
|
|
8
|
+
* Every read is one `UNION ALL` over the members, each branch passing the same `WHERE` seam a
|
|
9
|
+
* table read does, so a tenant-scoped member is filtered, or refused, on its own terms.
|
|
10
|
+
*/
|
|
11
|
+
export class UnionClient {
|
|
12
|
+
_ctx;
|
|
13
|
+
_union;
|
|
14
|
+
_normalizer;
|
|
15
|
+
constructor(ctx, union) {
|
|
16
|
+
this._ctx = ctx;
|
|
17
|
+
this._union = union;
|
|
18
|
+
this._normalizer = new RequestNormalizer(ctx);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Reads the first row, across every member, that `where` selects — in `orderBy` order when
|
|
22
|
+
* one is given.
|
|
23
|
+
*
|
|
24
|
+
* @example
|
|
25
|
+
* ```ts
|
|
26
|
+
* const post = await dsql.posts.findOne({ where: { id: { eq: postId } } });
|
|
27
|
+
* if (post?.$$key === "photos") post.photoUrl;
|
|
28
|
+
* ```
|
|
29
|
+
*/
|
|
30
|
+
findOne(args) {
|
|
31
|
+
const request = this._normalizer.normalizeUnionSelect(this._union, args, "one");
|
|
32
|
+
return new ExecutableQuery(this._ctx.operations.createUnionSelectOperation(this._union, request), this._ctx.session);
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Reads rows from every member, as one list.
|
|
36
|
+
*
|
|
37
|
+
* @example
|
|
38
|
+
* ```ts
|
|
39
|
+
* const feed = await dsql.posts.findMany({
|
|
40
|
+
* where: { userId: { eq: userId }, $$key: { in: types } },
|
|
41
|
+
* orderBy: { createdAt: "desc" },
|
|
42
|
+
* limit: 20,
|
|
43
|
+
* on: { photos: { select: { photoUrl: true } } },
|
|
44
|
+
* });
|
|
45
|
+
* ```
|
|
46
|
+
*/
|
|
47
|
+
findMany(args) {
|
|
48
|
+
const request = this._normalizer.normalizeUnionSelect(this._union, (args ?? {}), "many");
|
|
49
|
+
return new ExecutableQuery(this._ctx.operations.createUnionSelectOperation(this._union, request), this._ctx.session);
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* One page across every member, ordered by `orderBy`, then `$$key`, then the primary key —
|
|
53
|
+
* with a cursor on each record to continue from. The same cursors as a table's, signed
|
|
54
|
+
* against the union.
|
|
55
|
+
*
|
|
56
|
+
* @throws {InvalidCursorError} when `after` or `before` is not a cursor for this order.
|
|
57
|
+
*/
|
|
58
|
+
paginate(args) {
|
|
59
|
+
const plan = this._normalizer.normalizeUnionPaginate(this._union, args);
|
|
60
|
+
const select = this._ctx.operations.createUnionSelectOperation(this._union, plan.request);
|
|
61
|
+
const page = new ExecutableQuery({ ...select, resolve: (rows) => shapePage(rows, select.resolve, plan) }, this._ctx.session);
|
|
62
|
+
if (!args.count) {
|
|
63
|
+
return page;
|
|
64
|
+
}
|
|
65
|
+
const count = new ExecutableQuery(this._ctx.operations.createUnionCountOperation(this._union, plan.count), this._ctx.session);
|
|
66
|
+
return new CompositeQuery([page, count], ([result, totalCount]) => ({ ...result, totalCount }));
|
|
67
|
+
}
|
|
68
|
+
/** Counts the rows `where` selects, across every member. */
|
|
69
|
+
count(args) {
|
|
70
|
+
const request = this._normalizer.normalizeUnionCount(this._union, args);
|
|
71
|
+
return new ExecutableQuery(this._ctx.operations.createUnionCountOperation(this._union, request), this._ctx.session);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client/union/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { DefinitionSchema } from \"@dsqlbase/core\";\nimport { AnyUnionMembers } from \"@dsqlbase/core/definition\";\nimport {\n CompositeQuery,\n Executable,\n ExecutableQuery,\n ExecutionContext,\n Schema,\n Union,\n} from \"@dsqlbase/core/runtime\";\nimport { TypedObject } from \"@dsqlbase/core/utils\";\nimport {\n AnyUnionQuery,\n UnionCountArgs,\n UnionFindOneArgs,\n UnionPageOf,\n UnionPaginateArgs,\n UnionQueryArgs,\n UnionResultOf,\n} from \"../model/base.js\";\nimport { RequestNormalizer } from \"../model/normalizer.js\";\nimport { shapePage } from \"../pagination/page.js\";\n\n/**\n * Reads a `union()` as one set of rows: `dsql.<unionAlias>.findMany(...)` and friends. Read-only —\n * a row is written through its member's own model.\n *\n * Every read is one `UNION ALL` over the members, each branch passing the same `WHERE` seam a\n * table read does, so a tenant-scoped member is filtered, or refused, on its own terms.\n */\nexport class UnionClient<\n TMembers extends AnyUnionMembers,\n TDefinition extends DefinitionSchema,\n> implements TypedObject<Schema<TDefinition>> {\n declare readonly __type: Schema<TDefinition>;\n\n private readonly _ctx: ExecutionContext<TDefinition>;\n private readonly _union: Union;\n private readonly _normalizer: RequestNormalizer<TDefinition>;\n\n constructor(ctx: ExecutionContext<TDefinition>, union: Union) {\n this._ctx = ctx;\n this._union = union;\n this._normalizer = new RequestNormalizer<TDefinition>(ctx);\n }\n\n /**\n * Reads the first row, across every member, that `where` selects — in `orderBy` order when\n * one is given.\n *\n * @example\n * ```ts\n * const post = await dsql.posts.findOne({ where: { id: { eq: postId } } });\n * if (post?.$$key === \"photos\") post.photoUrl;\n * ```\n */\n public findOne<TArgs extends UnionFindOneArgs<TMembers, this[\"__type\"]>>(\n args: TArgs\n ): ExecutableQuery<UnionResultOf<TMembers, this[\"__type\"], TArgs> | null> {\n const request = this._normalizer.normalizeUnionSelect(\n this._union,\n args as AnyUnionQuery,\n \"one\"\n );\n\n return new ExecutableQuery(\n this._ctx.operations.createUnionSelectOperation(this._union, request),\n this._ctx.session\n );\n }\n\n /**\n * Reads rows from every member, as one list.\n *\n * @example\n * ```ts\n * const feed = await dsql.posts.findMany({\n * where: { userId: { eq: userId }, $$key: { in: types } },\n * orderBy: { createdAt: \"desc\" },\n * limit: 20,\n * on: { photos: { select: { photoUrl: true } } },\n * });\n * ```\n */\n public findMany<TArgs extends UnionQueryArgs<TMembers, this[\"__type\"]>>(\n args?: TArgs\n ): ExecutableQuery<UnionResultOf<TMembers, this[\"__type\"], TArgs>[]> {\n const request = this._normalizer.normalizeUnionSelect(\n this._union,\n (args ?? {}) as AnyUnionQuery,\n \"many\"\n );\n\n return new ExecutableQuery(\n this._ctx.operations.createUnionSelectOperation(this._union, request),\n this._ctx.session\n );\n }\n\n /**\n * One page across every member, ordered by `orderBy`, then `$$key`, then the primary key —\n * with a cursor on each record to continue from. The same cursors as a table's, signed\n * against the union.\n *\n * @throws {InvalidCursorError} when `after` or `before` is not a cursor for this order.\n */\n public paginate<TArgs extends UnionPaginateArgs<TMembers, this[\"__type\"]>>(\n args: TArgs\n ): Executable<UnionPageOf<TMembers, this[\"__type\"], TArgs>> {\n const plan = this._normalizer.normalizeUnionPaginate(this._union, args as AnyUnionQuery);\n const select = this._ctx.operations.createUnionSelectOperation(this._union, plan.request);\n\n const page = new ExecutableQuery<UnionPageOf<TMembers, this[\"__type\"], TArgs>>(\n { ...select, resolve: (rows) => shapePage(rows, select.resolve, plan) as never },\n this._ctx.session\n );\n\n if (!args.count) {\n return page;\n }\n\n const count = new ExecutableQuery<number>(\n this._ctx.operations.createUnionCountOperation(this._union, plan.count),\n this._ctx.session\n );\n\n return new CompositeQuery(\n [page, count] as const,\n ([result, totalCount]) =>\n ({ ...result, totalCount }) as UnionPageOf<TMembers, this[\"__type\"], TArgs>\n );\n }\n\n /** Counts the rows `where` selects, across every member. */\n public count(args?: UnionCountArgs<TMembers>): ExecutableQuery<number> {\n const request = this._normalizer.normalizeUnionCount(this._union, args as AnyUnionQuery);\n\n return new ExecutableQuery(\n this._ctx.operations.createUnionCountOperation(this._union, request),\n this._ctx.session\n );\n }\n}\n"]}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,7 @@
|
|
|
1
|
-
export { sql, SQLQuery } from "@dsqlbase/core";
|
|
1
|
+
export { sql, SQLQuery, TenancyError } from "@dsqlbase/core";
|
|
2
2
|
export type { Session, SQLStatement } from "@dsqlbase/core";
|
|
3
|
-
export {
|
|
3
|
+
export { GLOBAL_ID_PREFIX, GlobalIdError, decodeGlobalId, encodeGlobalId, isGlobalId, type GlobalId, type GlobalIdErrorCode, } from "./schema/utils/global-id.js";
|
|
4
|
+
export { ColumnValidationError, type ColumnValidationErrorCode, } from "./schema/utils/column-validation.js";
|
|
5
|
+
export { CURSOR_PREFIX, InvalidCursorError, type InvalidCursorCode, } from "./client/pagination/cursor.js";
|
|
6
|
+
export { createClient, type ClaimsOf, type ClientOptions, type IdentityClient, type QueryClient, } from "./client/index.js";
|
|
4
7
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -1,3 +1,6 @@
|
|
|
1
|
-
export { sql, SQLQuery } from "@dsqlbase/core";
|
|
2
|
-
export {
|
|
1
|
+
export { sql, SQLQuery, TenancyError } from "@dsqlbase/core";
|
|
2
|
+
export { GLOBAL_ID_PREFIX, GlobalIdError, decodeGlobalId, encodeGlobalId, isGlobalId, } from "./schema/utils/global-id.js";
|
|
3
|
+
export { ColumnValidationError, } from "./schema/utils/column-validation.js";
|
|
4
|
+
export { CURSOR_PREFIX, InvalidCursorError, } from "./client/pagination/cursor.js";
|
|
5
|
+
export { createClient, } from "./client/index.js";
|
|
3
6
|
//# sourceMappingURL=index.js.map
|