dsqlbase 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +41 -60
  3. package/dist/client/clients/base.d.ts +20 -0
  4. package/dist/client/clients/base.d.ts.map +1 -0
  5. package/dist/client/clients/base.js +52 -0
  6. package/dist/client/clients/base.js.map +1 -0
  7. package/dist/client/clients/dsql.d.ts +24 -0
  8. package/dist/client/clients/dsql.d.ts.map +1 -0
  9. package/dist/client/clients/dsql.js +31 -0
  10. package/dist/client/clients/dsql.js.map +1 -0
  11. package/dist/client/clients/index.d.ts +6 -0
  12. package/dist/client/clients/index.d.ts.map +1 -0
  13. package/dist/client/clients/index.js +6 -0
  14. package/dist/client/clients/index.js.map +1 -0
  15. package/dist/client/clients/model.d.ts +169 -0
  16. package/dist/client/clients/model.d.ts.map +1 -0
  17. package/dist/client/{model/client.js → clients/model.js} +82 -53
  18. package/dist/client/clients/model.js.map +1 -0
  19. package/dist/client/clients/transaction.d.ts +9 -0
  20. package/dist/client/clients/transaction.d.ts.map +1 -0
  21. package/dist/client/{transaction/transaction-client.js → clients/transaction.js} +7 -7
  22. package/dist/client/clients/transaction.js.map +1 -0
  23. package/dist/client/clients/union.d.ts +39 -0
  24. package/dist/client/clients/union.d.ts.map +1 -0
  25. package/dist/client/clients/union.js +54 -0
  26. package/dist/client/clients/union.js.map +1 -0
  27. package/dist/client/create.d.ts +15 -18
  28. package/dist/client/create.d.ts.map +1 -1
  29. package/dist/client/create.js +10 -27
  30. package/dist/client/create.js.map +1 -1
  31. package/dist/client/index.d.ts +4 -8
  32. package/dist/client/index.d.ts.map +1 -1
  33. package/dist/client/index.js +3 -6
  34. package/dist/client/index.js.map +1 -1
  35. package/dist/client/normalizers/base.d.ts +467 -0
  36. package/dist/client/normalizers/base.d.ts.map +1 -0
  37. package/dist/client/normalizers/base.js.map +1 -0
  38. package/dist/client/normalizers/context.d.ts +14 -0
  39. package/dist/client/normalizers/context.d.ts.map +1 -0
  40. package/dist/client/normalizers/context.js +16 -0
  41. package/dist/client/normalizers/context.js.map +1 -0
  42. package/dist/client/normalizers/index.d.ts +8 -0
  43. package/dist/client/normalizers/index.d.ts.map +1 -0
  44. package/dist/client/normalizers/index.js +8 -0
  45. package/dist/client/normalizers/index.js.map +1 -0
  46. package/dist/client/normalizers/pagination.d.ts +87 -0
  47. package/dist/client/normalizers/pagination.d.ts.map +1 -0
  48. package/dist/client/normalizers/pagination.js +245 -0
  49. package/dist/client/normalizers/pagination.js.map +1 -0
  50. package/dist/client/normalizers/request.d.ts +41 -0
  51. package/dist/client/normalizers/request.d.ts.map +1 -0
  52. package/dist/client/normalizers/request.js +346 -0
  53. package/dist/client/normalizers/request.js.map +1 -0
  54. package/dist/client/normalizers/rules.d.ts +132 -0
  55. package/dist/client/normalizers/rules.d.ts.map +1 -0
  56. package/dist/client/normalizers/rules.js +82 -0
  57. package/dist/client/normalizers/rules.js.map +1 -0
  58. package/dist/client/normalizers/utils.d.ts +6 -0
  59. package/dist/client/normalizers/utils.d.ts.map +1 -0
  60. package/dist/client/normalizers/utils.js +18 -0
  61. package/dist/client/normalizers/utils.js.map +1 -0
  62. package/dist/client/normalizers/where.d.ts +39 -0
  63. package/dist/client/normalizers/where.d.ts.map +1 -0
  64. package/dist/client/normalizers/where.js +230 -0
  65. package/dist/client/normalizers/where.js.map +1 -0
  66. package/dist/client/utils/occ-retry.d.ts.map +1 -0
  67. package/dist/client/utils/occ-retry.js.map +1 -0
  68. package/dist/index.d.ts +2 -3
  69. package/dist/index.d.ts.map +1 -1
  70. package/dist/index.js +2 -3
  71. package/dist/index.js.map +1 -1
  72. package/dist/schema/columns/guid.d.ts +21 -21
  73. package/dist/schema/columns/guid.d.ts.map +1 -1
  74. package/dist/schema/columns/guid.js +24 -25
  75. package/dist/schema/columns/guid.js.map +1 -1
  76. package/dist/schema/index.d.ts +0 -2
  77. package/dist/schema/index.d.ts.map +1 -1
  78. package/dist/schema/index.js +0 -2
  79. package/dist/schema/index.js.map +1 -1
  80. package/dist/schema/relations.d.ts +22 -13
  81. package/dist/schema/relations.d.ts.map +1 -1
  82. package/dist/schema/relations.js +9 -1
  83. package/dist/schema/relations.js.map +1 -1
  84. package/dist/schema/table.d.ts +2 -2
  85. package/dist/schema/table.d.ts.map +1 -1
  86. package/dist/schema/table.js.map +1 -1
  87. package/dist/schema/union.d.ts +13 -8
  88. package/dist/schema/union.d.ts.map +1 -1
  89. package/dist/schema/union.js +14 -9
  90. package/dist/schema/union.js.map +1 -1
  91. package/dist/schema/utils/global-id.d.ts +3 -3
  92. package/dist/schema/utils/global-id.js +3 -3
  93. package/dist/schema/utils/global-id.js.map +1 -1
  94. package/dist/schema/utils/guid-hooks.d.ts +49 -0
  95. package/dist/schema/utils/guid-hooks.d.ts.map +1 -0
  96. package/dist/schema/utils/guid-hooks.js +155 -0
  97. package/dist/schema/utils/guid-hooks.js.map +1 -0
  98. package/package.json +8 -6
  99. package/dist/client/database/base.d.ts +0 -99
  100. package/dist/client/database/base.d.ts.map +0 -1
  101. package/dist/client/database/base.js +0 -216
  102. package/dist/client/database/base.js.map +0 -1
  103. package/dist/client/database/client.d.ts +0 -26
  104. package/dist/client/database/client.d.ts.map +0 -1
  105. package/dist/client/database/client.js +0 -47
  106. package/dist/client/database/client.js.map +0 -1
  107. package/dist/client/database/index.d.ts +0 -65
  108. package/dist/client/database/index.d.ts.map +0 -1
  109. package/dist/client/database/index.js +0 -3
  110. package/dist/client/database/index.js.map +0 -1
  111. package/dist/client/model/base.d.ts +0 -747
  112. package/dist/client/model/base.d.ts.map +0 -1
  113. package/dist/client/model/base.js.map +0 -1
  114. package/dist/client/model/client.d.ts +0 -139
  115. package/dist/client/model/client.d.ts.map +0 -1
  116. package/dist/client/model/client.js.map +0 -1
  117. package/dist/client/model/filters.d.ts +0 -276
  118. package/dist/client/model/filters.d.ts.map +0 -1
  119. package/dist/client/model/filters.js +0 -470
  120. package/dist/client/model/filters.js.map +0 -1
  121. package/dist/client/model/normalizer.d.ts +0 -143
  122. package/dist/client/model/normalizer.d.ts.map +0 -1
  123. package/dist/client/model/normalizer.js +0 -641
  124. package/dist/client/model/normalizer.js.map +0 -1
  125. package/dist/client/nodes.d.ts +0 -62
  126. package/dist/client/nodes.d.ts.map +0 -1
  127. package/dist/client/nodes.js +0 -378
  128. package/dist/client/nodes.js.map +0 -1
  129. package/dist/client/pagination/cursor.d.ts +0 -40
  130. package/dist/client/pagination/cursor.d.ts.map +0 -1
  131. package/dist/client/pagination/cursor.js +0 -79
  132. package/dist/client/pagination/cursor.js.map +0 -1
  133. package/dist/client/pagination/page.d.ts +0 -23
  134. package/dist/client/pagination/page.d.ts.map +0 -1
  135. package/dist/client/pagination/page.js +0 -37
  136. package/dist/client/pagination/page.js.map +0 -1
  137. package/dist/client/transaction/index.d.ts +0 -2
  138. package/dist/client/transaction/index.d.ts.map +0 -1
  139. package/dist/client/transaction/index.js +0 -2
  140. package/dist/client/transaction/index.js.map +0 -1
  141. package/dist/client/transaction/occ-retry.d.ts.map +0 -1
  142. package/dist/client/transaction/occ-retry.js.map +0 -1
  143. package/dist/client/transaction/transaction-client.d.ts +0 -9
  144. package/dist/client/transaction/transaction-client.d.ts.map +0 -1
  145. package/dist/client/transaction/transaction-client.js.map +0 -1
  146. package/dist/client/union/client.d.ts +0 -55
  147. package/dist/client/union/client.d.ts.map +0 -1
  148. package/dist/client/union/client.js +0 -74
  149. package/dist/client/union/client.js.map +0 -1
  150. package/dist/schema/embedded.d.ts +0 -31
  151. package/dist/schema/embedded.d.ts.map +0 -1
  152. package/dist/schema/embedded.js +0 -33
  153. package/dist/schema/embedded.js.map +0 -1
  154. package/dist/schema/tenant.d.ts +0 -31
  155. package/dist/schema/tenant.d.ts.map +0 -1
  156. package/dist/schema/tenant.js +0 -33
  157. package/dist/schema/tenant.js.map +0 -1
  158. /package/dist/client/{model → normalizers}/base.js +0 -0
  159. /package/dist/client/{transaction → utils}/occ-retry.d.ts +0 -0
  160. /package/dist/client/{transaction → utils}/occ-retry.js +0 -0
@@ -0,0 +1,8 @@
1
+ export * from "./base.js";
2
+ export { ClientContext, type ClientContextOptions } from "./context.js";
3
+ export { CURSOR_PREFIX, DEFAULT_PAGE_SIZE, type InvalidCursorCode, InvalidCursorError, PaginationHandler, type PaginationOptions, type PaginationPlan, encodeCursor, } from "./pagination.js";
4
+ export { type ParsedQuerySelection, RequestNormalizer } from "./request.js";
5
+ export { COMPARISON, type ColumnRules, FILTER_OPERATORS, type FilterOperator, JSONB_RUNTIME_TYPES, NESTED, type OperatorsOf, type OrderableRuntimeType, PATTERN, PLAIN_OBJECT_VALUES, RUNTIME_COLUMN_RULES, type RuntimeColumnRules, type ShorthandRuntimeType, allowPlainObjectFilter, comparable, document, getColumnRules, isFilterObject, isNestedFilter, isRuleOperator, jsonbDocument, } from "./rules.js";
6
+ export { escapeLike, isDefined, isEmptyObject, isNullOrFalse, isPlainObject } from "./utils.js";
7
+ export { WhereBuilder, isAndEntry, isNotEntry, isOrEntry } from "./where.js";
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/normalizers/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,gBAAgB,EAChB,KAAK,cAAc,EACnB,mBAAmB,EACnB,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,OAAO,EACP,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,8 @@
1
+ export * from "./base.js";
2
+ export { ClientContext } from "./context.js";
3
+ export { CURSOR_PREFIX, DEFAULT_PAGE_SIZE, InvalidCursorError, PaginationHandler, encodeCursor, } from "./pagination.js";
4
+ export { RequestNormalizer } from "./request.js";
5
+ export { COMPARISON, FILTER_OPERATORS, JSONB_RUNTIME_TYPES, NESTED, PATTERN, PLAIN_OBJECT_VALUES, RUNTIME_COLUMN_RULES, allowPlainObjectFilter, comparable, document, getColumnRules, isFilterObject, isNestedFilter, isRuleOperator, jsonbDocument, } from "./rules.js";
6
+ export { escapeLike, isDefined, isEmptyObject, isNullOrFalse, isPlainObject } from "./utils.js";
7
+ export { WhereBuilder, isAndEntry, isNotEntry, isOrEntry } from "./where.js";
8
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/normalizers/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,aAAa,EAA6B,MAAM,cAAc,CAAC;AACxE,OAAO,EACL,aAAa,EACb,iBAAiB,EAEjB,kBAAkB,EAClB,iBAAiB,EAGjB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAA6B,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EACL,UAAU,EAEV,gBAAgB,EAEhB,mBAAmB,EACnB,MAAM,EAGN,OAAO,EACP,mBAAmB,EACnB,oBAAoB,EAGpB,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export * from \"./base.js\";\n\nexport { ClientContext, type ClientContextOptions } from \"./context.js\";\nexport {\n CURSOR_PREFIX,\n DEFAULT_PAGE_SIZE,\n type InvalidCursorCode,\n InvalidCursorError,\n PaginationHandler,\n type PaginationOptions,\n type PaginationPlan,\n encodeCursor,\n} from \"./pagination.js\";\nexport { type ParsedQuerySelection, RequestNormalizer } from \"./request.js\";\nexport {\n COMPARISON,\n type ColumnRules,\n FILTER_OPERATORS,\n type FilterOperator,\n JSONB_RUNTIME_TYPES,\n NESTED,\n type OperatorsOf,\n type OrderableRuntimeType,\n PATTERN,\n PLAIN_OBJECT_VALUES,\n RUNTIME_COLUMN_RULES,\n type RuntimeColumnRules,\n type ShorthandRuntimeType,\n allowPlainObjectFilter,\n comparable,\n document,\n getColumnRules,\n isFilterObject,\n isNestedFilter,\n isRuleOperator,\n jsonbDocument,\n} from \"./rules.js\";\nexport { escapeLike, isDefined, isEmptyObject, isNullOrFalse, isPlainObject } from \"./utils.js\";\nexport { WhereBuilder, isAndEntry, isNotEntry, isOrEntry } from \"./where.js\";\n"]}
@@ -0,0 +1,87 @@
1
+ import { AnyTable, AnyUnion, DefinitionSchema, OperationRequest, OrderByEntry, Schema, SelectOperation, SelectOperationArgs, UnionSelectOperation, UnionSelectOperationArgs } from "@dsqlbase/core";
2
+ import { ClientContext } from "./context.js";
3
+ import { PaginatedQueryArgs, PaginatedUnionQueryArgs } from "./base.js";
4
+ /** Page-size bounds for keyset pagination. Carried here for the client; core reads neither. */
5
+ export type PaginationOptions = {
6
+ /** The page size when a call names none. */
7
+ defaultLimit?: number;
8
+ /** The largest page size a call may ask for. Unbounded when absent. */
9
+ maxLimit?: number;
10
+ };
11
+ export declare const DEFAULT_PAGE_SIZE = 100;
12
+ export declare class PaginationHandler<TDefinition extends DefinitionSchema> {
13
+ readonly __type: Schema<TDefinition>;
14
+ private readonly _ctx;
15
+ private readonly _defaultPageSize;
16
+ private readonly _maxPageSize;
17
+ readonly options: PaginationOptions;
18
+ constructor(context: ClientContext<TDefinition>, options?: PaginationOptions);
19
+ private _assertCursors;
20
+ private _assertUnionTiebreaker;
21
+ private _getPageSize;
22
+ private _getOrderKeyset;
23
+ private _createKeysetSignature;
24
+ private _getCursorValues;
25
+ private _getUnionMemberFieldName;
26
+ private _getPaginationPlan;
27
+ private _createPageResolver;
28
+ paginateRequest<TTable extends AnyTable, TArgs extends PaginatedQueryArgs<TTable, this["__type"]>>(table: TTable, query: TArgs, request: OperationRequest<SelectOperationArgs, "many">): <TResult>(operation: SelectOperation<"many", SelectOperationArgs, TResult>) => {
29
+ resolve: (rows: unknown[]) => {
30
+ items: {
31
+ [x: string]: never;
32
+ __cursor: string;
33
+ }[];
34
+ hasMore: boolean;
35
+ nextCursor: string | null;
36
+ };
37
+ type: "select";
38
+ mode: "many";
39
+ name: string;
40
+ args: SelectOperationArgs;
41
+ query: import("@dsqlbase/core").SQLStatement;
42
+ };
43
+ paginateUnionRequest<TUnion extends AnyUnion>(union: TUnion, args: PaginatedUnionQueryArgs<TUnion, this["__type"]>, request: OperationRequest<UnionSelectOperationArgs, "many">): <TResult>(operation: UnionSelectOperation<"many", UnionSelectOperationArgs, TResult>) => {
44
+ resolve: (rows: unknown[]) => {
45
+ items: {
46
+ [x: string]: never;
47
+ __cursor: string;
48
+ }[];
49
+ hasMore: boolean;
50
+ nextCursor: string | null;
51
+ };
52
+ type: "select";
53
+ mode: "many";
54
+ name: string;
55
+ args: UnionSelectOperationArgs;
56
+ query: import("@dsqlbase/core").SQLStatement;
57
+ };
58
+ }
59
+ export type PaginationPlan = {
60
+ readonly pageSize: number;
61
+ readonly signature: string;
62
+ readonly projection: "before" | "after";
63
+ readonly direction: "asc" | "desc";
64
+ readonly keyset: OrderByEntry[];
65
+ readonly cursor?: string;
66
+ };
67
+ /** What was wrong with a cursor. */
68
+ export type InvalidCursorCode =
69
+ /** Not a readable cursor at all. */
70
+ "format"
71
+ /** A cursor from another version of the format. */
72
+ | "version"
73
+ /** A readable cursor taken under another table or another order. */
74
+ | "mismatch";
75
+ /**
76
+ * A cursor could not be used for this page.
77
+ *
78
+ * Thrown before any SQL is built. `mismatch` is the one a caller is most likely to meet: a
79
+ * cursor reused after the `orderBy` changed, or handed to another model.
80
+ */
81
+ export declare class InvalidCursorError extends Error {
82
+ readonly code: InvalidCursorCode;
83
+ constructor(code: InvalidCursorCode, message: string);
84
+ }
85
+ export declare const CURSOR_PREFIX = "c1.";
86
+ export declare function encodeCursor(signature: string, values: (string | null)[]): string;
87
+ //# sourceMappingURL=pagination.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/client/normalizers/pagination.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,245 @@
1
+ import { Union, } from "@dsqlbase/core";
2
+ import { isDefined, isPlainObject } from "./utils.js";
3
+ import { hash } from "node:crypto";
4
+ import { KEY_FIELD } from "@dsqlbase/core/definition";
5
+ export const DEFAULT_PAGE_SIZE = 100;
6
+ export class PaginationHandler {
7
+ _ctx;
8
+ _defaultPageSize;
9
+ _maxPageSize;
10
+ options;
11
+ constructor(context, options) {
12
+ this.options = options ?? {};
13
+ this._ctx = context;
14
+ this._defaultPageSize = options?.defaultLimit ?? DEFAULT_PAGE_SIZE;
15
+ this._maxPageSize = options?.maxLimit ?? DEFAULT_PAGE_SIZE;
16
+ }
17
+ _assertCursors(query) {
18
+ if (isDefined(query.before) && isDefined(query.after)) {
19
+ throw new Error("Pass either after or before, not both.");
20
+ }
21
+ }
22
+ _assertUnionTiebreaker(union) {
23
+ if (union.tiebreakers === 0) {
24
+ throw new Error(`Cannot page union "${union.alias}": its members' primary keys differ in arity or type, ` +
25
+ `so nothing can break a tie between two members' rows.`);
26
+ }
27
+ }
28
+ _getPageSize(limit) {
29
+ const size = limit ?? this._defaultPageSize;
30
+ if (!Number.isInteger(size) || size <= 0) {
31
+ throw new Error(`A page size must be a positive integer (got ${String(size)}).`);
32
+ }
33
+ if (size > this._maxPageSize) {
34
+ throw new Error(`A page size must not exceed the maximum limit of ${this._maxPageSize} (got ${String(size)}).`);
35
+ }
36
+ return size;
37
+ }
38
+ _getOrderKeyset(table, entries, direction) {
39
+ const keys = entries ?? [];
40
+ if (table instanceof Union) {
41
+ if (!keys.some(([field]) => field === KEY_FIELD)) {
42
+ keys.push([KEY_FIELD, [direction]]);
43
+ }
44
+ for (const [index] of Array.from({ length: table.tiebreakers }).entries()) {
45
+ keys.push([`$$pk${index}`, [direction]]);
46
+ }
47
+ return keys;
48
+ }
49
+ const fields = new Map(table.getColumnEntries().map(([field, column]) => [column, field]));
50
+ for (const column of table.primaryKey) {
51
+ if (!keys.some((key) => table.getColumn(key[0]) === column)) {
52
+ keys.push([fields.get(column), [direction]]);
53
+ }
54
+ }
55
+ return keys;
56
+ }
57
+ _createKeysetSignature(table, keyset) {
58
+ const order = keyset.map(([field, [direction]]) => `${field}:${direction}`).join(",");
59
+ return hash("sha256", `${table.alias}|${order}`, "hex").slice(0, 8);
60
+ }
61
+ _getCursorValues(cursor, signature, keyset) {
62
+ if (typeof cursor !== "string" || !VERSIONED.test(cursor)) {
63
+ throw new InvalidCursorError("format", `"${String(cursor)}" is not a cursor.`);
64
+ }
65
+ if (!cursor.startsWith(CURSOR_PREFIX)) {
66
+ throw new InvalidCursorError("version", `"${cursor}" is from another cursor format; this client reads "${CURSOR_PREFIX}".`);
67
+ }
68
+ const payload = decodeCursor(cursor);
69
+ if (!Array.isArray(payload) || typeof payload[0] !== "string") {
70
+ throw new InvalidCursorError("format", `"${cursor}" does not carry a [signature, ...] payload.`);
71
+ }
72
+ const [checksum, ...values] = payload;
73
+ if (checksum !== signature || values.length !== keyset.length) {
74
+ throw new InvalidCursorError("mismatch", `"${cursor}" was taken under another table or order; pass the same orderBy it came from.`);
75
+ }
76
+ for (const [index, value] of values.entries()) {
77
+ if (typeof value !== "string" && value !== null) {
78
+ throw new InvalidCursorError("format", `"${cursor}" carries a key that is not text.`);
79
+ }
80
+ if (value === null && !isDefined(keyset[index][1][1])) {
81
+ throw new InvalidCursorError("format", `"${cursor}" carries a null for a key that cannot hold one.`);
82
+ }
83
+ }
84
+ return values;
85
+ }
86
+ _getUnionMemberFieldName(union, alias, key) {
87
+ if (key === KEY_FIELD) {
88
+ return alias;
89
+ }
90
+ const member = union.getMember(alias);
91
+ const fields = new Map(member.getColumnEntries().map(([field, column]) => [column, field]));
92
+ if (key.startsWith("$$pk")) {
93
+ const column = member.primaryKey[Number(key.slice(4))];
94
+ if (!column) {
95
+ throw new Error(`Invalid primary key index in key "${key}".`);
96
+ }
97
+ return fields.get(column);
98
+ }
99
+ return key;
100
+ }
101
+ _getPaginationPlan(table, query, request) {
102
+ this._assertCursors(query);
103
+ const pageSize = this._getPageSize(query.limit);
104
+ const direction = request.args.orderBy?.at(-1)?.[1][0] ?? "asc";
105
+ const keyset = this._getOrderKeyset(table, request.args.orderBy, direction);
106
+ const signature = this._createKeysetSignature(table, keyset);
107
+ const cursor = query.after ?? query.before ?? undefined;
108
+ const projection = isDefined(query.before) ? "before" : "after";
109
+ return {
110
+ pageSize,
111
+ direction,
112
+ projection,
113
+ signature,
114
+ keyset,
115
+ cursor,
116
+ };
117
+ }
118
+ _createPageResolver(plan, rowResolver) {
119
+ return (rows) => {
120
+ const hasMore = rows.length > plan.pageSize;
121
+ const records = hasMore ? rows.slice(0, plan.pageSize) : rows;
122
+ const resolved = rowResolver(records);
123
+ const items = resolved.map((record, index) => {
124
+ const values = plan.keyset.map((_, key) => {
125
+ if (!isPlainObject(records[index])) {
126
+ throw new Error(`Expected record at index ${index} to be a plain object.`);
127
+ }
128
+ return records[index][`__k${key}`];
129
+ });
130
+ const cursor = encodeCursor(plan.signature, values);
131
+ return { ...record, __cursor: cursor };
132
+ });
133
+ // Read backwards, the page arrives nearest-the-cursor first; put it back in order.
134
+ if (plan.projection === "before") {
135
+ items.reverse();
136
+ }
137
+ return {
138
+ items,
139
+ hasMore,
140
+ nextCursor: hasMore ? items[items.length - 1].__cursor : null,
141
+ };
142
+ };
143
+ }
144
+ paginateRequest(table, query, request) {
145
+ const plan = this._getPaginationPlan(table, query, request);
146
+ request.args.orderBy = plan.keyset;
147
+ request.args.limit = plan.pageSize + 1;
148
+ request.args.keys = plan.keyset.map(([field]) => table.getColumn(field)).filter(isDefined);
149
+ // A page before the cursor is read backwards — every direction flipped — and put back in
150
+ // order once it is resolved, so the rows nearest the cursor are the ones kept.
151
+ if (plan.projection === "before") {
152
+ request.args.orderBy = plan.keyset.map(([field, [direction, nulls]]) => [field, [direction === "asc" ? "desc" : "asc", nulls]]);
153
+ }
154
+ if (isDefined(plan.cursor)) {
155
+ const values = this._getCursorValues(plan.cursor, plan.signature, plan.keyset);
156
+ const clause = this._ctx.where.buildKeyset(table, plan.keyset, values, plan.projection);
157
+ request.args.where = Array.isArray(request.args.where)
158
+ ? [...request.args.where, clause]
159
+ : [request.args.where, clause].filter(isDefined);
160
+ }
161
+ return (operation) => {
162
+ const { resolve, ...rest } = operation;
163
+ return {
164
+ ...rest,
165
+ resolve: this._createPageResolver(plan, resolve),
166
+ };
167
+ };
168
+ }
169
+ paginateUnionRequest(union, args, request) {
170
+ this._assertUnionTiebreaker(union);
171
+ const plan = this._getPaginationPlan(union, args, request);
172
+ let orderBy = plan.keyset;
173
+ request.args.orderBy = orderBy;
174
+ request.args.limit = plan.pageSize + 1;
175
+ request.args.keys = true;
176
+ request.args.tiebreak = plan.direction;
177
+ if (plan.projection === "before") {
178
+ orderBy = plan.keyset.map(([field, [direction, nulls]]) => [field, [direction === "asc" ? "desc" : "asc", nulls]]);
179
+ request.args.orderBy = orderBy;
180
+ }
181
+ let values = undefined;
182
+ if (isDefined(plan.cursor)) {
183
+ values = this._getCursorValues(plan.cursor, plan.signature, plan.keyset);
184
+ request.args.keyset = { values, bound: plan.projection };
185
+ }
186
+ for (const [index, [member, subquery]] of request.args.members.entries()) {
187
+ const memberOrderBy = orderBy
188
+ .filter(([field]) => field !== KEY_FIELD)
189
+ .map(([field, options]) => [
190
+ this._getUnionMemberFieldName(union, member, field),
191
+ options,
192
+ ]);
193
+ request.args.members[index][1].orderBy = memberOrderBy;
194
+ if (values) {
195
+ const memberKeyset = orderBy.map(([field, options]) => [
196
+ this._getUnionMemberFieldName(union, member, field),
197
+ options,
198
+ ]);
199
+ const clause = this._ctx.where.buildKeyset(union.getMember(member), memberKeyset, values, plan.projection);
200
+ request.args.members[index][1].where = Array.isArray(subquery.where)
201
+ ? [...subquery.where, clause]
202
+ : [subquery.where, clause].filter(isDefined);
203
+ }
204
+ }
205
+ return (operation) => {
206
+ const { resolve, ...rest } = operation;
207
+ return {
208
+ ...rest,
209
+ resolve: this._createPageResolver(plan, resolve),
210
+ };
211
+ };
212
+ }
213
+ }
214
+ /**
215
+ * A cursor could not be used for this page.
216
+ *
217
+ * Thrown before any SQL is built. `mismatch` is the one a caller is most likely to meet: a
218
+ * cursor reused after the `orderBy` changed, or handed to another model.
219
+ */
220
+ export class InvalidCursorError extends Error {
221
+ code;
222
+ constructor(code, message) {
223
+ super(message);
224
+ this.name = "InvalidCursorError";
225
+ this.code = code;
226
+ }
227
+ }
228
+ export const CURSOR_PREFIX = "c1.";
229
+ const VERSIONED = /^c\d+\./;
230
+ function decodeCursor(cursor) {
231
+ // `Buffer.from(..., "base64url")` never throws — it drops whatever it cannot read — so
232
+ // malformed base64 surfaces here as JSON that does not parse.
233
+ const json = Buffer.from(cursor.slice(CURSOR_PREFIX.length), "base64url").toString("utf8");
234
+ try {
235
+ return JSON.parse(json);
236
+ }
237
+ catch {
238
+ throw new InvalidCursorError("format", `"${cursor}" does not decode to a JSON payload.`);
239
+ }
240
+ }
241
+ export function encodeCursor(signature, values) {
242
+ const payload = JSON.stringify([signature, ...values]);
243
+ return `${CURSOR_PREFIX}${Buffer.from(payload, "utf8").toString("base64url")}`;
244
+ }
245
+ //# sourceMappingURL=pagination.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/client/normalizers/pagination.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n AnyTable,\n AnyUnion,\n DefinitionSchema,\n OperationRequest,\n OperationResult,\n OrderByEntry,\n Schema,\n SelectOperation,\n SelectOperationArgs,\n Union,\n UnionSelectOperation,\n UnionSelectOperationArgs,\n} from \"@dsqlbase/core\";\nimport { ClientContext } from \"./context.js\";\nimport {\n PaginatedQueryArgs,\n PaginatedQueryResultOf,\n PaginatedUnionQueryArgs,\n RuntimeObject,\n} from \"./base.js\";\nimport { isDefined, isPlainObject } from \"./utils.js\";\nimport { hash } from \"node:crypto\";\nimport { KEY_FIELD } from \"@dsqlbase/core/definition\";\n\n/** Page-size bounds for keyset pagination. Carried here for the client; core reads neither. */\nexport type PaginationOptions = {\n /** The page size when a call names none. */\n defaultLimit?: number;\n /** The largest page size a call may ask for. Unbounded when absent. */\n maxLimit?: number;\n};\n\nexport const DEFAULT_PAGE_SIZE = 100;\n\nexport class PaginationHandler<TDefinition extends DefinitionSchema> {\n declare readonly __type: Schema<TDefinition>;\n\n private readonly _ctx: ClientContext<TDefinition>;\n\n private readonly _defaultPageSize: number;\n private readonly _maxPageSize: number;\n public readonly options: PaginationOptions;\n\n constructor(context: ClientContext<TDefinition>, options?: PaginationOptions) {\n this.options = options ?? {};\n this._ctx = context;\n this._defaultPageSize = options?.defaultLimit ?? DEFAULT_PAGE_SIZE;\n this._maxPageSize = options?.maxLimit ?? DEFAULT_PAGE_SIZE;\n }\n\n private _assertCursors(query: PaginatedQueryArgs<AnyTable, this[\"__type\"]>) {\n if (isDefined(query.before) && isDefined(query.after)) {\n throw new Error(\"Pass either after or before, not both.\");\n }\n }\n\n private _assertUnionTiebreaker<T extends AnyUnion>(union: T) {\n if (union.tiebreakers === 0) {\n throw new Error(\n `Cannot page union \"${union.alias}\": its members' primary keys differ in arity or type, ` +\n `so nothing can break a tie between two members' rows.`\n );\n }\n }\n\n private _getPageSize(limit?: number | null): number {\n const size = limit ?? this._defaultPageSize;\n if (!Number.isInteger(size) || size <= 0) {\n throw new Error(`A page size must be a positive integer (got ${String(size)}).`);\n }\n\n if (size > this._maxPageSize) {\n throw new Error(\n `A page size must not exceed the maximum limit of ${this._maxPageSize} (got ${String(size)}).`\n );\n }\n\n return size;\n }\n\n private _getOrderKeyset(\n table: RuntimeObject,\n entries: OrderByEntry[] | null | undefined,\n direction: \"asc\" | \"desc\"\n ) {\n const keys = entries ?? [];\n\n if (table instanceof Union) {\n if (!keys.some(([field]) => field === KEY_FIELD)) {\n keys.push([KEY_FIELD, [direction]]);\n }\n\n for (const [index] of Array.from({ length: table.tiebreakers }).entries()) {\n keys.push([`$$pk${index}`, [direction]]);\n }\n\n return keys;\n }\n\n const fields = new Map(table.getColumnEntries().map(([field, column]) => [column, field]));\n\n for (const column of table.primaryKey) {\n if (!keys.some((key) => table.getColumn(key[0]) === column)) {\n keys.push([fields.get(column) as string, [direction]]);\n }\n }\n\n return keys;\n }\n\n private _createKeysetSignature(table: RuntimeObject, keyset: OrderByEntry[]) {\n const order = keyset.map(([field, [direction]]) => `${field}:${direction}`).join(\",\");\n return hash(\"sha256\", `${table.alias}|${order}`, \"hex\").slice(0, 8);\n }\n\n private _getCursorValues(\n cursor: string,\n signature: string,\n keyset: OrderByEntry[]\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 = decodeCursor(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 [checksum, ...values] = payload as [string, ...unknown[]];\n\n if (checksum !== signature || values.length !== keyset.length) {\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 [index, value] of values.entries()) {\n if (typeof value !== \"string\" && value !== null) {\n throw new InvalidCursorError(\"format\", `\"${cursor}\" carries a key that is not text.`);\n }\n\n if (value === null && !isDefined(keyset[index][1][1])) {\n throw new InvalidCursorError(\n \"format\",\n `\"${cursor}\" carries a null for a key that cannot hold one.`\n );\n }\n }\n\n return values as (string | null)[];\n }\n\n private _getUnionMemberFieldName(union: AnyUnion, alias: string, key: string) {\n if (key === KEY_FIELD) {\n return alias;\n }\n\n const member = union.getMember(alias);\n const fields = new Map(member.getColumnEntries().map(([field, column]) => [column, field]));\n\n if (key.startsWith(\"$$pk\")) {\n const column = member.primaryKey[Number(key.slice(4))];\n\n if (!column) {\n throw new Error(`Invalid primary key index in key \"${key}\".`);\n }\n\n return fields.get(column) as string;\n }\n\n return key;\n }\n\n private _getPaginationPlan<TTable extends RuntimeObject>(\n table: TTable,\n query: TTable extends AnyUnion\n ? PaginatedUnionQueryArgs<TTable, this[\"__type\"]>\n : PaginatedQueryArgs<TTable, this[\"__type\"]>,\n request:\n | OperationRequest<SelectOperationArgs, \"many\">\n | OperationRequest<UnionSelectOperationArgs, \"many\">\n ): PaginationPlan {\n this._assertCursors(query);\n\n const pageSize = this._getPageSize(query.limit);\n const direction = request.args.orderBy?.at(-1)?.[1][0] ?? \"asc\";\n const keyset = this._getOrderKeyset(table, request.args.orderBy, direction);\n const signature = this._createKeysetSignature(table, keyset);\n const cursor = query.after ?? query.before ?? undefined;\n const projection = isDefined(query.before) ? \"before\" : \"after\";\n\n return {\n pageSize,\n direction,\n projection,\n signature,\n keyset,\n cursor,\n };\n }\n\n private _createPageResolver<\n TTable extends AnyTable,\n TArgs extends PaginatedQueryArgs<TTable, this[\"__type\"]>,\n TResult,\n >(plan: PaginationPlan, rowResolver: (rows: unknown[]) => OperationResult<\"many\", TResult>) {\n return (rows: unknown[]): PaginatedQueryResultOf<TTable, Schema<TDefinition>, TArgs> => {\n const hasMore = rows.length > plan.pageSize;\n const records = hasMore ? rows.slice(0, plan.pageSize) : rows;\n const resolved = rowResolver(records);\n\n const items = resolved.map((record, index) => {\n const values = plan.keyset.map((_, key) => {\n if (!isPlainObject(records[index])) {\n throw new Error(`Expected record at index ${index} to be a plain object.`);\n }\n\n return records[index][`__k${key}`] as string | null;\n });\n\n const cursor = encodeCursor(plan.signature, values);\n\n return { ...record, __cursor: cursor };\n });\n\n // Read backwards, the page arrives nearest-the-cursor first; put it back in order.\n if (plan.projection === \"before\") {\n items.reverse();\n }\n\n return {\n items,\n hasMore,\n nextCursor: hasMore ? items[items.length - 1].__cursor : null,\n } as PaginatedQueryResultOf<TTable, Schema<TDefinition>, TArgs>;\n };\n }\n\n public paginateRequest<\n TTable extends AnyTable,\n TArgs extends PaginatedQueryArgs<TTable, this[\"__type\"]>,\n >(table: TTable, query: TArgs, request: OperationRequest<SelectOperationArgs, \"many\">) {\n const plan = this._getPaginationPlan(table, query, request);\n\n request.args.orderBy = plan.keyset;\n request.args.limit = plan.pageSize + 1;\n request.args.keys = plan.keyset.map(([field]) => table.getColumn(field)).filter(isDefined);\n\n // A page before the cursor is read backwards — every direction flipped — and put back in\n // order once it is resolved, so the rows nearest the cursor are the ones kept.\n if (plan.projection === \"before\") {\n request.args.orderBy = plan.keyset.map(\n ([field, [direction, nulls]]) =>\n [field, [direction === \"asc\" ? \"desc\" : \"asc\", nulls]] as OrderByEntry\n );\n }\n\n if (isDefined(plan.cursor)) {\n const values = this._getCursorValues(plan.cursor, plan.signature, plan.keyset);\n const clause = this._ctx.where.buildKeyset(table, plan.keyset, values, plan.projection);\n\n request.args.where = Array.isArray(request.args.where)\n ? [...request.args.where, clause]\n : [request.args.where, clause].filter(isDefined);\n }\n\n return <TResult>(operation: SelectOperation<\"many\", SelectOperationArgs, TResult>) => {\n const { resolve, ...rest } = operation;\n\n return {\n ...rest,\n resolve: this._createPageResolver(plan, resolve),\n };\n };\n }\n\n public paginateUnionRequest<TUnion extends AnyUnion>(\n union: TUnion,\n args: PaginatedUnionQueryArgs<TUnion, this[\"__type\"]>,\n request: OperationRequest<UnionSelectOperationArgs, \"many\">\n ) {\n this._assertUnionTiebreaker(union);\n\n const plan = this._getPaginationPlan<AnyUnion>(union, args, request);\n\n let orderBy = plan.keyset;\n\n request.args.orderBy = orderBy;\n request.args.limit = plan.pageSize + 1;\n request.args.keys = true;\n request.args.tiebreak = plan.direction;\n\n if (plan.projection === \"before\") {\n orderBy = plan.keyset.map(\n ([field, [direction, nulls]]) =>\n [field, [direction === \"asc\" ? \"desc\" : \"asc\", nulls]] as OrderByEntry\n );\n request.args.orderBy = orderBy;\n }\n\n let values: (string | null)[] | undefined = undefined;\n\n if (isDefined(plan.cursor)) {\n values = this._getCursorValues(plan.cursor, plan.signature, plan.keyset);\n request.args.keyset = { values, bound: plan.projection };\n }\n\n for (const [index, [member, subquery]] of request.args.members.entries()) {\n const memberOrderBy = orderBy\n .filter(([field]) => field !== KEY_FIELD)\n .map<OrderByEntry>(([field, options]) => [\n this._getUnionMemberFieldName(union, member, field),\n options,\n ]);\n\n request.args.members[index][1].orderBy = memberOrderBy;\n\n if (values) {\n const memberKeyset = orderBy.map<OrderByEntry>(([field, options]) => [\n this._getUnionMemberFieldName(union, member, field),\n options,\n ]);\n\n const clause = this._ctx.where.buildKeyset(\n union.getMember(member),\n memberKeyset,\n values,\n plan.projection\n );\n\n request.args.members[index][1].where = Array.isArray(subquery.where)\n ? [...subquery.where, clause]\n : [subquery.where, clause].filter(isDefined);\n }\n }\n\n return <TResult>(\n operation: UnionSelectOperation<\"many\", UnionSelectOperationArgs, TResult>\n ) => {\n const { resolve, ...rest } = operation;\n\n return {\n ...rest,\n resolve: this._createPageResolver(plan, resolve),\n };\n };\n }\n}\n\nexport type PaginationPlan = {\n readonly pageSize: number;\n readonly signature: string;\n readonly projection: \"before\" | \"after\";\n readonly direction: \"asc\" | \"desc\";\n readonly keyset: OrderByEntry[];\n readonly cursor?: string;\n};\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\nexport const CURSOR_PREFIX = \"c1.\";\n\nconst VERSIONED = /^c\\d+\\./;\n\nfunction decodeCursor(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\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"]}
@@ -0,0 +1,41 @@
1
+ import { TypedObject } from "@dsqlbase/core/utils";
2
+ import { AnyTable, DefinitionSchema, ExecutionContext, OperationMode, OperationRequest, Schema, SelectOperationArgs, CountOperationArgs, InsertOperationArgs, UpdateOperationArgs, DeleteOperationArgs, AnyUnion, UnionSelectOperationArgs } from "@dsqlbase/core";
3
+ import { UnionCountOperationArgs } from "@dsqlbase/core/runtime";
4
+ import { CountArgs, CreateArgs, DeleteArgs, DeleteUniqueArgs, GetArgs, JoinExpressionOf, PaginatedQueryArgs, QueryArgs, RuntimeObject, SelectableFieldsOf, UnionQueryArgs, UpdateArgs, UpdateUniqueArgs } from "./base.js";
5
+ export declare class RequestNormalizer<TDefinition extends DefinitionSchema> implements TypedObject<Schema<TDefinition>> {
6
+ readonly __type: Schema<TDefinition>;
7
+ private readonly _ctx;
8
+ private readonly _where;
9
+ constructor(context: ExecutionContext<TDefinition>);
10
+ private _assertUniqueKeys;
11
+ /** `distinct` compares whole rows, so every column it reads needs an equality operator. */
12
+ private _assertDistinct;
13
+ private _parseQuerySelection;
14
+ private _mergeMemberQuery;
15
+ private _resolveMutationValues;
16
+ private _getSelectEntries;
17
+ private _getJoinEntries;
18
+ private _getOrderByEntries;
19
+ private _getMutationEntries;
20
+ private _getSelectArgs;
21
+ private _getUnionSelectArgs;
22
+ createSelectRequest<TTable extends AnyTable, TMode extends OperationMode>(table: TTable, query: QueryArgs<TTable, this["__type"]> | PaginatedQueryArgs<TTable, this["__type"]>, mode: TMode): OperationRequest<SelectOperationArgs, TMode>;
23
+ createGetRequest<TTable extends AnyTable>(table: TTable, query: GetArgs<TTable, this["__type"]>): OperationRequest<SelectOperationArgs, "one">;
24
+ createCountRequest<TTable extends AnyTable>(table: TTable, args: CountArgs<TTable>): OperationRequest<CountOperationArgs, "one">;
25
+ createInsertRequest<TTable extends AnyTable, TMode extends OperationMode>(table: TTable, args: CreateArgs<TTable>, mode: TMode): OperationRequest<InsertOperationArgs, TMode>;
26
+ createUpdateRequest<TTable extends AnyTable, TMode extends OperationMode>(table: TTable, args: UpdateArgs<TTable>, mode: TMode): OperationRequest<UpdateOperationArgs, TMode>;
27
+ createUpdateUniqueRequest<TTable extends AnyTable>(table: TTable, args: UpdateUniqueArgs<TTable>): OperationRequest<UpdateOperationArgs, "one">;
28
+ createDeleteRequest<TTable extends AnyTable, TMode extends OperationMode>(table: TTable, args: DeleteArgs<TTable>, mode: TMode): OperationRequest<DeleteOperationArgs, TMode>;
29
+ createDeleteUniqueRequest<TTable extends AnyTable>(table: TTable, args: DeleteUniqueArgs<TTable>): OperationRequest<DeleteOperationArgs, "one">;
30
+ createUnionSelectRequest<TUnion extends AnyUnion, TMode extends OperationMode>(union: TUnion, query: UnionQueryArgs<TUnion, this["__type"]>, mode: TMode): OperationRequest<UnionSelectOperationArgs, TMode>;
31
+ createUnionCountRequest<TUnion extends AnyUnion>(union: TUnion, args?: CountArgs<TUnion>): OperationRequest<UnionCountOperationArgs, "one">;
32
+ resolveGlobalId<TTable extends AnyTable>(guid: string): {
33
+ table: TTable;
34
+ request: OperationRequest<SelectOperationArgs, "one">;
35
+ };
36
+ }
37
+ export type ParsedQuerySelection<TTable extends RuntimeObject, TSchema extends Schema<DefinitionSchema>> = {
38
+ select: SelectableFieldsOf<TTable>;
39
+ join: JoinExpressionOf<TTable, TSchema>;
40
+ };
41
+ //# sourceMappingURL=request.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/client/normalizers/request.ts"],"names":[],"mappings":"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"}