@sxh62/dynamo 0.1.1 → 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.
Files changed (45) hide show
  1. package/dist/conventions.d.ts +49 -0
  2. package/dist/conventions.d.ts.map +1 -0
  3. package/dist/conventions.js +33 -0
  4. package/dist/conventions.js.map +1 -0
  5. package/dist/errors.d.ts +13 -2
  6. package/dist/errors.d.ts.map +1 -1
  7. package/dist/errors.js +34 -4
  8. package/dist/errors.js.map +1 -1
  9. package/dist/index.d.ts +2 -6
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +2 -6
  12. package/dist/index.js.map +1 -1
  13. package/dist/pagination.d.ts +16 -0
  14. package/dist/pagination.d.ts.map +1 -0
  15. package/dist/pagination.js +23 -0
  16. package/dist/pagination.js.map +1 -0
  17. package/package.json +9 -4
  18. package/dist/base-repository.d.ts +0 -36
  19. package/dist/base-repository.d.ts.map +0 -1
  20. package/dist/base-repository.js +0 -141
  21. package/dist/base-repository.js.map +0 -1
  22. package/dist/batch-processor.d.ts +0 -27
  23. package/dist/batch-processor.d.ts.map +0 -1
  24. package/dist/batch-processor.js +0 -73
  25. package/dist/batch-processor.js.map +0 -1
  26. package/dist/client.d.ts +0 -15
  27. package/dist/client.d.ts.map +0 -1
  28. package/dist/client.js +0 -14
  29. package/dist/client.js.map +0 -1
  30. package/dist/config.d.ts +0 -30
  31. package/dist/config.d.ts.map +0 -1
  32. package/dist/config.js +0 -21
  33. package/dist/config.js.map +0 -1
  34. package/dist/query-engine.d.ts +0 -31
  35. package/dist/query-engine.d.ts.map +0 -1
  36. package/dist/query-engine.js +0 -122
  37. package/dist/query-engine.js.map +0 -1
  38. package/dist/update-builder.d.ts +0 -14
  39. package/dist/update-builder.d.ts.map +0 -1
  40. package/dist/update-builder.js +0 -27
  41. package/dist/update-builder.js.map +0 -1
  42. package/dist/validation.d.ts +0 -7
  43. package/dist/validation.d.ts.map +0 -1
  44. package/dist/validation.js +0 -37
  45. package/dist/validation.js.map +0 -1
@@ -0,0 +1,49 @@
1
+ import type { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
2
+ import { Table } from "dynamodb-toolbox";
3
+ import type { GlobalIndex } from "dynamodb-toolbox";
4
+ export interface DefineTableOptions {
5
+ /** Table name (or a resolver, e.g. an SST `Resource` lookup). */
6
+ name: string | (() => string);
7
+ /** Injected document client; omit to attach it later. */
8
+ documentClient?: DynamoDBDocumentClient;
9
+ /** Additional global secondary indexes beyond the standard GSI1 (e.g. GSI2). */
10
+ indexes?: Record<string, GlobalIndex>;
11
+ }
12
+ /**
13
+ * Create a dynamodb-toolbox `Table` using the family's single-table conventions:
14
+ * primary key `pk`/`sk` (both string) and a `GSI1` global index over
15
+ * `gsi1pk`/`gsi1sk`. Extra indexes can be supplied but the convention is stable.
16
+ */
17
+ export declare function defineTable(options: DefineTableOptions): Table<{
18
+ name: "pk";
19
+ type: "string";
20
+ }, {
21
+ name: "sk";
22
+ type: "string";
23
+ }, {
24
+ GSI1: {
25
+ readonly type: "global";
26
+ readonly partitionKey: {
27
+ readonly name: "gsi1pk";
28
+ readonly type: "string";
29
+ };
30
+ readonly sortKey: {
31
+ readonly name: "gsi1sk";
32
+ readonly type: "string";
33
+ };
34
+ };
35
+ }, "_et">;
36
+ /**
37
+ * Family entity conventions. Items are discriminated by their `pk`/`sk` prefixes,
38
+ * not by a stored `_et` entity attribute, so entities disable it. Spread this into
39
+ * entity construction to keep dynamodb-toolbox's full type inference:
40
+ *
41
+ * ```ts
42
+ * new Entity({ name: "Encounter", table, schema, ...FAMILY_ENTITY_OPTIONS })
43
+ * ```
44
+ */
45
+ export declare const FAMILY_ENTITY_OPTIONS: {
46
+ readonly entityAttribute: false;
47
+ readonly timestamps: false;
48
+ };
49
+ //# sourceMappingURL=conventions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"conventions.d.ts","sourceRoot":"","sources":["../src/conventions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAC9B,yDAAyD;IACzD,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACvC;AAUD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;UAQtD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;CAAyD,CAAC"}
@@ -0,0 +1,33 @@
1
+ import { Table } from "dynamodb-toolbox";
2
+ const STANDARD_INDEXES = {
3
+ GSI1: {
4
+ type: "global",
5
+ partitionKey: { name: "gsi1pk", type: "string" },
6
+ sortKey: { name: "gsi1sk", type: "string" },
7
+ },
8
+ };
9
+ /**
10
+ * Create a dynamodb-toolbox `Table` using the family's single-table conventions:
11
+ * primary key `pk`/`sk` (both string) and a `GSI1` global index over
12
+ * `gsi1pk`/`gsi1sk`. Extra indexes can be supplied but the convention is stable.
13
+ */
14
+ export function defineTable(options) {
15
+ return new Table({
16
+ ...(options.documentClient !== undefined ? { documentClient: options.documentClient } : {}),
17
+ name: options.name,
18
+ partitionKey: { name: "pk", type: "string" },
19
+ sortKey: { name: "sk", type: "string" },
20
+ indexes: { ...STANDARD_INDEXES, ...options.indexes },
21
+ });
22
+ }
23
+ /**
24
+ * Family entity conventions. Items are discriminated by their `pk`/`sk` prefixes,
25
+ * not by a stored `_et` entity attribute, so entities disable it. Spread this into
26
+ * entity construction to keep dynamodb-toolbox's full type inference:
27
+ *
28
+ * ```ts
29
+ * new Entity({ name: "Encounter", table, schema, ...FAMILY_ENTITY_OPTIONS })
30
+ * ```
31
+ */
32
+ export const FAMILY_ENTITY_OPTIONS = { entityAttribute: false, timestamps: false };
33
+ //# sourceMappingURL=conventions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"conventions.js","sourceRoot":"","sources":["../src/conventions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAYzC,MAAM,gBAAgB,GAAG;IACvB,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC5C;CACO,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,OAAO,IAAI,KAAK,CAAC;QACf,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5C,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvC,OAAO,EAAE,EAAE,GAAG,gBAAgB,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE;KACrD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAW,CAAC"}
package/dist/errors.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  /**
2
- * Typed error hierarchy for the persistence library (behaviour B-OPS-4).
3
- * Every failure is a `RepositoryError` subclass carrying the operation context.
2
+ * Typed error hierarchy for the family's repository layer, preserved from
3
+ * `@sxh62/dynamo` so consumers' HTTP layers keep working across the migration.
4
4
  */
5
5
  export interface RepositoryErrorOptions {
6
6
  cause?: unknown;
@@ -30,4 +30,15 @@ export declare class BatchProcessingError extends RepositoryError {
30
30
  readonly unprocessed: unknown[];
31
31
  constructor(operation: string, unprocessed: unknown[]);
32
32
  }
33
+ /**
34
+ * Map a raw dynamodb-toolbox / DynamoDB error onto the family taxonomy.
35
+ *
36
+ * - an existing `RepositoryError` passes through unchanged;
37
+ * - `ConditionalCheckFailedException` means a write condition was not met (item
38
+ * absent) → `NotFoundError`;
39
+ * - a `DynamoDBToolboxError` is a schema/parse/format/option problem →
40
+ * `RepositoryValidationError`;
41
+ * - anything else is wrapped as `RepositoryError`, preserving the cause.
42
+ */
43
+ export declare function mapToolboxError(error: unknown, operation: string): RepositoryError;
33
44
  //# sourceMappingURL=errors.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB;CAKjF;AAED,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;CAMrF;AAED,qBAAa,aAAc,SAAQ,eAAe;CAAG;AAErD,qBAAa,4BAA6B,SAAQ,eAAe;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAIhD;AAED,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;gBAEpB,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE;CAItD"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB;CAKjF;AAED,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;CAMrF;AAED,qBAAa,aAAc,SAAQ,eAAe;CAAG;AAErD,qBAAa,4BAA6B,SAAQ,eAAe;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAIhD;AAED,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;gBAEpB,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE;CAItD;AAYD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAclF"}
package/dist/errors.js CHANGED
@@ -1,7 +1,4 @@
1
- /**
2
- * Typed error hierarchy for the persistence library (behaviour B-OPS-4).
3
- * Every failure is a `RepositoryError` subclass carrying the operation context.
4
- */
1
+ import { DynamoDBToolboxError } from "dynamodb-toolbox/errors";
5
2
  export class RepositoryError extends Error {
6
3
  operation;
7
4
  constructor(message, operation, options) {
@@ -37,4 +34,37 @@ export class BatchProcessingError extends RepositoryError {
37
34
  this.unprocessed = unprocessed;
38
35
  }
39
36
  }
37
+ const CONDITIONAL_CHECK_FAILED = "ConditionalCheckFailedException";
38
+ function errorName(error) {
39
+ if (typeof error !== "object" || error === null || !("name" in error)) {
40
+ return undefined;
41
+ }
42
+ const name = error.name;
43
+ return typeof name === "string" ? name : undefined;
44
+ }
45
+ /**
46
+ * Map a raw dynamodb-toolbox / DynamoDB error onto the family taxonomy.
47
+ *
48
+ * - an existing `RepositoryError` passes through unchanged;
49
+ * - `ConditionalCheckFailedException` means a write condition was not met (item
50
+ * absent) → `NotFoundError`;
51
+ * - a `DynamoDBToolboxError` is a schema/parse/format/option problem →
52
+ * `RepositoryValidationError`;
53
+ * - anything else is wrapped as `RepositoryError`, preserving the cause.
54
+ */
55
+ export function mapToolboxError(error, operation) {
56
+ if (error instanceof RepositoryError) {
57
+ return error;
58
+ }
59
+ if (errorName(error) === CONDITIONAL_CHECK_FAILED) {
60
+ return new NotFoundError(`Condition not met for ${operation} (item absent)`, operation, {
61
+ cause: error,
62
+ });
63
+ }
64
+ if (DynamoDBToolboxError.match(error)) {
65
+ return new RepositoryValidationError(error.message, operation, { cause: error });
66
+ }
67
+ const message = error instanceof Error ? error.message : String(error);
68
+ return new RepositoryError(message, operation, { cause: error });
69
+ }
40
70
  //# sourceMappingURL=errors.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,SAAS,CAAS;IAE3B,YAAY,OAAe,EAAE,SAAiB,EAAE,OAAgC;QAC9E,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAQD,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IACnD,EAAE,CAAqB;IACvB,EAAE,CAAqB;IACvB,MAAM,CAAqB;IAEpC,YAAY,OAAe,EAAE,SAAiB,EAAE,UAAkC,EAAE;QAClF,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,eAAe;CAAG;AAErD,MAAM,OAAO,4BAA6B,SAAQ,eAAe;IACtD,QAAQ,CAAS;IAE1B,YAAY,SAAiB,EAAE,QAAgB;QAC7C,KAAK,CAAC,uBAAuB,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAC9C,WAAW,CAAY;IAEhC,YAAY,SAAiB,EAAE,WAAsB;QACnD,KAAK,CAAC,4BAA4B,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC;QAC/F,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,8 +1,4 @@
1
- export * from "./base-repository.js";
2
- export * from "./batch-processor.js";
3
- export * from "./client.js";
4
- export * from "./config.js";
1
+ export * from "./conventions.js";
5
2
  export * from "./errors.js";
6
- export * from "./query-engine.js";
7
- export * from "./update-builder.js";
3
+ export * from "./pagination.js";
8
4
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}
package/dist/index.js CHANGED
@@ -1,8 +1,4 @@
1
- export * from "./base-repository.js";
2
- export * from "./batch-processor.js";
3
- export * from "./client.js";
4
- export * from "./config.js";
1
+ export * from "./conventions.js";
5
2
  export * from "./errors.js";
6
- export * from "./query-engine.js";
7
- export * from "./update-builder.js";
3
+ export * from "./pagination.js";
8
4
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}
@@ -0,0 +1,16 @@
1
+ export interface PaginateOptions {
2
+ /** Upper bound on pages fetched. Use `Infinity` to paginate to completion. */
3
+ maxPages: number;
4
+ /** Operation name recorded on a thrown `PaginationLimitExceededError`. */
5
+ operation: string;
6
+ }
7
+ /**
8
+ * Run an auto-paginating toolbox query/scan and **throw** `PaginationLimitExceededError`
9
+ * when `maxPages` is reached with pages still remaining.
10
+ *
11
+ * dynamodb-toolbox's own `maxPages` option silently stops at the cap, returning a
12
+ * truncated result set with a dangling `LastEvaluatedKey`; this wrapper turns that
13
+ * silent truncation into a loud, typed failure.
14
+ */
15
+ export declare function paginate<RESPONSE>(run: (maxPages: number) => Promise<RESPONSE>, options: PaginateOptions): Promise<RESPONSE>;
16
+ //# sourceMappingURL=pagination.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CACnB;AASD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EACrC,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAC5C,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,CAAC,CAMnB"}
@@ -0,0 +1,23 @@
1
+ import { PaginationLimitExceededError } from "./errors.js";
2
+ function morePagesRemain(response) {
3
+ if (typeof response !== "object" || response === null) {
4
+ return false;
5
+ }
6
+ return response.LastEvaluatedKey !== undefined;
7
+ }
8
+ /**
9
+ * Run an auto-paginating toolbox query/scan and **throw** `PaginationLimitExceededError`
10
+ * when `maxPages` is reached with pages still remaining.
11
+ *
12
+ * dynamodb-toolbox's own `maxPages` option silently stops at the cap, returning a
13
+ * truncated result set with a dangling `LastEvaluatedKey`; this wrapper turns that
14
+ * silent truncation into a loud, typed failure.
15
+ */
16
+ export async function paginate(run, options) {
17
+ const response = await run(options.maxPages);
18
+ if (morePagesRemain(response)) {
19
+ throw new PaginationLimitExceededError(options.operation, options.maxPages);
20
+ }
21
+ return response;
22
+ }
23
+ //# sourceMappingURL=pagination.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAS3D,SAAS,eAAe,CAAC,QAAiB;IACxC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAQ,QAA2C,CAAC,gBAAgB,KAAK,SAAS,CAAC;AACrF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAA4C,EAC5C,OAAwB;IAExB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,4BAA4B,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "@sxh62/dynamo",
3
- "version": "0.1.1",
3
+ "version": "0.2.0",
4
+ "description": "Family conventions and shared extensions over dynamodb-toolbox for the sxh DynamoDB apps.",
4
5
  "type": "module",
5
6
  "main": "./dist/index.js",
6
7
  "types": "./dist/index.d.ts",
@@ -10,7 +11,7 @@
10
11
  "repository": {
11
12
  "type": "git",
12
13
  "url": "git+https://github.com/sxh/dynamo_persistence.git",
13
- "directory": "server"
14
+ "directory": "toolbox"
14
15
  },
15
16
  "publishConfig": {
16
17
  "access": "public"
@@ -23,17 +24,21 @@
23
24
  "test": "vitest run",
24
25
  "coverage": "vitest run --coverage",
25
26
  "build": "tsc -p tsconfig.build.json",
26
- "prepack": "npm run build",
27
- "integration": "vitest run --config vitest.integration.config.ts"
27
+ "prepack": "npm run build"
28
28
  },
29
29
  "peerDependencies": {
30
30
  "@aws-sdk/client-dynamodb": "^3.700.0",
31
31
  "@aws-sdk/lib-dynamodb": "^3.700.0",
32
+ "@aws-sdk/util-dynamodb": "^3.700.0",
32
33
  "zod": "^3.24.0"
33
34
  },
35
+ "dependencies": {
36
+ "dynamodb-toolbox": "^2.11.0"
37
+ },
34
38
  "devDependencies": {
35
39
  "@aws-sdk/client-dynamodb": "^3.700.0",
36
40
  "@aws-sdk/lib-dynamodb": "^3.700.0",
41
+ "@aws-sdk/util-dynamodb": "^3.700.0",
37
42
  "@eslint/js": "^9.17.0",
38
43
  "@types/node": "^22.10.0",
39
44
  "@vitest/coverage-v8": "5.0.3",
@@ -1,36 +0,0 @@
1
- import { type TransactWriteCommandInput } from "@aws-sdk/lib-dynamodb";
2
- import type { ZodType } from "zod";
3
- import { type WriteRequests } from "./batch-processor.js";
4
- import { type Logger, type RepositoryConfig } from "./config.js";
5
- import { type QueryParams, type ScanParams } from "./query-engine.js";
6
- /**
7
- * Shared DynamoDB access primitives over an injected document client (DESIGN §5.3).
8
- * All collaborators (client, table name, limits) are injected — no `sst`/`Resource` coupling.
9
- */
10
- export declare abstract class BaseRepository {
11
- protected readonly tableName: string;
12
- protected readonly logger: Logger;
13
- private readonly docClient;
14
- private readonly maxPages;
15
- private readonly batchSize;
16
- private readonly maxBatchRetries;
17
- private readonly concurrencyLimit;
18
- private queryEngineInstance?;
19
- protected constructor(config: RepositoryConfig);
20
- private get queryEngine();
21
- protected putItem<T>(item: T, schema?: ZodType<T>): Promise<T>;
22
- protected getItem<T>(pk: string, sk: string, schema?: ZodType<T>): Promise<T | null>;
23
- protected deleteItem(pk: string, sk: string): Promise<void>;
24
- protected updateItem<T>(pk: string, sk: string, attributes: Partial<T>, schema?: ZodType<T>): Promise<T>;
25
- protected query<T>(params: QueryParams, schema?: ZodType<T>): Promise<{
26
- items: T[];
27
- nextToken?: string;
28
- }>;
29
- protected queryAll<T>(params: QueryParams, schema?: ZodType<T>): Promise<T[]>;
30
- protected scanAll<T>(params: ScanParams, schema?: ZodType<T>): Promise<T[]>;
31
- protected queryIterator<T>(params: QueryParams, schema?: ZodType<T>): AsyncGenerator<T[]>;
32
- protected transactWrite(items: TransactWriteCommandInput["TransactItems"], operationName: string): Promise<void>;
33
- protected batchWrite(requests: WriteRequests): Promise<void>;
34
- private wrap;
35
- }
36
- //# sourceMappingURL=base-repository.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"base-repository.d.ts","sourceRoot":"","sources":["../src/base-repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAA2B,KAAK,MAAM,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE1F,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAInF;;;GAGG;AACH,8BAAsB,cAAc;IAClC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,mBAAmB,CAAC,CAAc;IAE1C,SAAS,aAAa,MAAM,EAAE,gBAAgB;IAU9C,OAAO,KAAK,WAAW,GAOtB;cAEe,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;cAcpD,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;cAiB1E,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAQjD,UAAU,CAAC,CAAC,EAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC;IAwCb,SAAS,CAAC,KAAK,CAAC,CAAC,EACf,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9C,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAI7E,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAI3E,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC;cAIzE,aAAa,CAC3B,KAAK,EAAE,yBAAyB,CAAC,eAAe,CAAC,EACjD,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;cAQA,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlE,OAAO,CAAC,IAAI;CAQb"}
@@ -1,141 +0,0 @@
1
- import { DeleteCommand, GetCommand, PutCommand, TransactWriteCommand, UpdateCommand, } from "@aws-sdk/lib-dynamodb";
2
- import { BatchProcessor } from "./batch-processor.js";
3
- import { consoleLogger, DEFAULTS } from "./config.js";
4
- import { RepositoryError, RepositoryValidationError } from "./errors.js";
5
- import { QueryEngine } from "./query-engine.js";
6
- import { UpdateBuilder } from "./update-builder.js";
7
- import { parseForWrite, validateItem } from "./validation.js";
8
- /**
9
- * Shared DynamoDB access primitives over an injected document client (DESIGN §5.3).
10
- * All collaborators (client, table name, limits) are injected — no `sst`/`Resource` coupling.
11
- */
12
- export class BaseRepository {
13
- tableName;
14
- logger;
15
- docClient;
16
- maxPages;
17
- batchSize;
18
- maxBatchRetries;
19
- concurrencyLimit;
20
- queryEngineInstance;
21
- constructor(config) {
22
- this.tableName = config.tableName;
23
- this.docClient = config.docClient;
24
- this.logger = config.logger ?? consoleLogger;
25
- this.maxPages = config.maxPages ?? DEFAULTS.maxPages;
26
- this.batchSize = config.batchSize ?? DEFAULTS.batchSize;
27
- this.maxBatchRetries = config.maxBatchRetries ?? DEFAULTS.maxBatchRetries;
28
- this.concurrencyLimit = config.concurrencyLimit ?? DEFAULTS.concurrencyLimit;
29
- }
30
- get queryEngine() {
31
- this.queryEngineInstance ??= new QueryEngine(this.docClient, {
32
- tableName: this.tableName,
33
- maxPages: this.maxPages,
34
- logger: this.logger,
35
- });
36
- return this.queryEngineInstance;
37
- }
38
- async putItem(item, schema) {
39
- if (schema) {
40
- parseForWrite(item, schema, "putItem", this.logger);
41
- }
42
- try {
43
- await this.docClient.send(new PutCommand({ TableName: this.tableName, Item: item }));
44
- }
45
- catch (error) {
46
- throw this.wrap("putItem", error);
47
- }
48
- return item;
49
- }
50
- async getItem(pk, sk, schema) {
51
- let result;
52
- try {
53
- result = await this.docClient.send(new GetCommand({ TableName: this.tableName, Key: { pk, sk } }));
54
- }
55
- catch (error) {
56
- throw this.wrap("getItem", error);
57
- }
58
- if (!result.Item) {
59
- return null;
60
- }
61
- return schema
62
- ? validateItem(result.Item, schema, "getItem", this.logger)
63
- : result.Item;
64
- }
65
- async deleteItem(pk, sk) {
66
- try {
67
- await this.docClient.send(new DeleteCommand({ TableName: this.tableName, Key: { pk, sk } }));
68
- }
69
- catch (error) {
70
- throw this.wrap("deleteItem", error);
71
- }
72
- }
73
- async updateItem(pk, sk, attributes, schema) {
74
- const { updateExpression, expressionAttributeNames, expressionAttributeValues, hasChanges } = UpdateBuilder.build(attributes);
75
- if (!hasChanges) {
76
- throw new RepositoryValidationError("No attributes provided for update", "updateItem", {
77
- pk,
78
- sk,
79
- });
80
- }
81
- let result;
82
- try {
83
- result = await this.docClient.send(new UpdateCommand({
84
- TableName: this.tableName,
85
- Key: { pk, sk },
86
- UpdateExpression: updateExpression,
87
- ExpressionAttributeNames: expressionAttributeNames,
88
- ExpressionAttributeValues: expressionAttributeValues,
89
- ReturnValues: "ALL_NEW",
90
- }));
91
- }
92
- catch (error) {
93
- throw this.wrap("updateItem", error);
94
- }
95
- if (!result.Attributes) {
96
- throw new RepositoryError("updateItem: result.Attributes is undefined", "updateItem");
97
- }
98
- return schema
99
- ? validateItem(result.Attributes, schema, "updateItem", this.logger)
100
- : result.Attributes;
101
- }
102
- query(params, schema) {
103
- return this.queryEngine.query(params, schema);
104
- }
105
- queryAll(params, schema) {
106
- return this.queryEngine.queryAll(params, schema);
107
- }
108
- scanAll(params, schema) {
109
- return this.queryEngine.scanAll(params, schema);
110
- }
111
- queryIterator(params, schema) {
112
- return this.queryEngine.queryIterator(params, schema);
113
- }
114
- async transactWrite(items, operationName) {
115
- try {
116
- await this.docClient.send(new TransactWriteCommand({ TransactItems: items }));
117
- }
118
- catch (error) {
119
- throw this.wrap(operationName, error);
120
- }
121
- }
122
- async batchWrite(requests) {
123
- const processor = new BatchProcessor(this.docClient, {
124
- tableName: this.tableName,
125
- batchSize: this.batchSize,
126
- maxRetries: this.maxBatchRetries,
127
- concurrencyLimit: this.concurrencyLimit,
128
- logger: this.logger,
129
- });
130
- await processor.execute(requests);
131
- }
132
- wrap(operation, error) {
133
- if (error instanceof RepositoryError) {
134
- return error;
135
- }
136
- const message = error instanceof Error ? error.message : String(error);
137
- this.logger.error(`BaseRepository.${operation}: error`, { operation });
138
- return new RepositoryError(message, operation, { cause: error });
139
- }
140
- }
141
- //# sourceMappingURL=base-repository.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"base-repository.js","sourceRoot":"","sources":["../src/base-repository.ts"],"names":[],"mappings":"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"}
@@ -1,27 +0,0 @@
1
- import { type BatchWriteCommandInput, type DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
2
- import { type Logger } from "./config.js";
3
- export type WriteRequests = NonNullable<BatchWriteCommandInput["RequestItems"]>[string];
4
- export interface BatchProcessorOptions {
5
- tableName: string;
6
- batchSize?: number;
7
- maxRetries?: number;
8
- concurrencyLimit?: number;
9
- logger?: Logger;
10
- }
11
- /**
12
- * Chunked, bounded-concurrency batch writer with retry/backoff on `UnprocessedItems`
13
- * (behaviours B-BAT-1/5).
14
- */
15
- export declare class BatchProcessor {
16
- private readonly docClient;
17
- private readonly tableName;
18
- private readonly batchSize;
19
- private readonly maxRetries;
20
- private readonly concurrencyLimit;
21
- private readonly logger;
22
- constructor(docClient: DynamoDBDocumentClient, options: BatchProcessorOptions);
23
- execute(requests: WriteRequests): Promise<void>;
24
- private processChunk;
25
- private wait;
26
- }
27
- //# sourceMappingURL=batch-processor.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"batch-processor.d.ts","sourceRoot":"","sources":["../src/batch-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAA2B,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAGnE,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAExF,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAQvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,SAAS,EAAE,sBAAsB,EAClD,OAAO,EAAE,qBAAqB;IAS1B,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;YAiBvC,YAAY;YAiCZ,IAAI;CAMnB"}
@@ -1,73 +0,0 @@
1
- import { BatchWriteCommand, } from "@aws-sdk/lib-dynamodb";
2
- import { consoleLogger, DEFAULTS } from "./config.js";
3
- import { BatchProcessingError, RepositoryError } from "./errors.js";
4
- /**
5
- * Chunked, bounded-concurrency batch writer with retry/backoff on `UnprocessedItems`
6
- * (behaviours B-BAT-1/5).
7
- */
8
- export class BatchProcessor {
9
- docClient;
10
- tableName;
11
- batchSize;
12
- maxRetries;
13
- concurrencyLimit;
14
- logger;
15
- constructor(docClient, options) {
16
- this.docClient = docClient;
17
- this.tableName = options.tableName;
18
- this.batchSize = options.batchSize ?? DEFAULTS.batchSize;
19
- this.maxRetries = options.maxRetries ?? DEFAULTS.maxBatchRetries;
20
- this.concurrencyLimit = options.concurrencyLimit ?? DEFAULTS.concurrencyLimit;
21
- this.logger = options.logger ?? consoleLogger;
22
- }
23
- async execute(requests) {
24
- if (requests.length === 0) {
25
- return;
26
- }
27
- const chunks = [];
28
- for (let i = 0; i < requests.length; i += this.batchSize) {
29
- chunks.push(requests.slice(i, i + this.batchSize));
30
- }
31
- for (let i = 0; i < chunks.length; i += this.concurrencyLimit) {
32
- await Promise.all(chunks.slice(i, i + this.concurrencyLimit).map((chunk) => this.processChunk(chunk)));
33
- }
34
- }
35
- async processChunk(chunk) {
36
- let pending = chunk;
37
- let attempt = 0;
38
- while (pending.length > 0) {
39
- if (attempt >= this.maxRetries) {
40
- this.logger.error("BatchProcessor: unprocessed items after retries", {
41
- operation: "batchWrite",
42
- remaining: pending.length,
43
- });
44
- throw new BatchProcessingError("batchWrite", pending);
45
- }
46
- let result;
47
- try {
48
- result = await this.docClient.send(new BatchWriteCommand({ RequestItems: { [this.tableName]: pending } }));
49
- }
50
- catch (error) {
51
- this.logger.error("BatchProcessor: batch write failed", { operation: "batchWrite" });
52
- throw error instanceof RepositoryError
53
- ? error
54
- : new RepositoryError(errorMessage(error), "batchWrite", { cause: error });
55
- }
56
- pending = result.UnprocessedItems?.[this.tableName] ?? [];
57
- if (pending.length > 0) {
58
- attempt++;
59
- await this.wait(attempt);
60
- }
61
- }
62
- }
63
- async wait(attempt) {
64
- const delay = Math.pow(2, attempt) * 50;
65
- await new Promise((resolve) => {
66
- setTimeout(resolve, delay);
67
- });
68
- }
69
- }
70
- function errorMessage(error) {
71
- return error instanceof Error ? error.message : String(error);
72
- }
73
- //# sourceMappingURL=batch-processor.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"batch-processor.js","sourceRoot":"","sources":["../src/batch-processor.ts"],"names":[],"mappings":"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"}
package/dist/client.d.ts DELETED
@@ -1,15 +0,0 @@
1
- /**
2
- * Injectable DynamoDB document client factory (behaviour B-OPS-2).
3
- * No `sst`/`Resource` coupling: region/endpoint/marshall options are injected.
4
- */
5
- import { type DynamoDBClientConfig } from "@aws-sdk/client-dynamodb";
6
- import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
7
- export interface DocClientOptions {
8
- region: string;
9
- endpoint?: string;
10
- removeUndefinedValues?: boolean;
11
- maxAttempts?: number;
12
- credentials?: DynamoDBClientConfig["credentials"];
13
- }
14
- export declare function createDocClient(options: DocClientOptions): DynamoDBDocumentClient;
15
- //# sourceMappingURL=client.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAC;CACnD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,sBAAsB,CAMjF"}
package/dist/client.js DELETED
@@ -1,14 +0,0 @@
1
- /**
2
- * Injectable DynamoDB document client factory (behaviour B-OPS-2).
3
- * No `sst`/`Resource` coupling: region/endpoint/marshall options are injected.
4
- */
5
- import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
6
- import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
7
- export function createDocClient(options) {
8
- const { removeUndefinedValues = true, ...clientOptions } = options;
9
- const client = new DynamoDBClient(clientOptions);
10
- return DynamoDBDocumentClient.from(client, {
11
- marshallOptions: { removeUndefinedValues },
12
- });
13
- }
14
- //# sourceMappingURL=client.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAA6B,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAU/D,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,EAAE,qBAAqB,GAAG,IAAI,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;IACnE,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;IACjD,OAAO,sBAAsB,CAAC,IAAI,CAAC,MAAM,EAAE;QACzC,eAAe,EAAE,EAAE,qBAAqB,EAAE;KAC3C,CAAC,CAAC;AACL,CAAC"}
package/dist/config.d.ts DELETED
@@ -1,30 +0,0 @@
1
- import type { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
2
- /**
3
- * Read-validation policy (behaviour B-VAL-3). Only `strict` is implemented in this slice;
4
- * `tolerant` / `env-aware` land in Phase 2 (DESIGN §9.6, decision §4.3).
5
- */
6
- export type ReadValidationPolicy = "strict" | "tolerant" | "env-aware";
7
- export interface Logger {
8
- debug(message: string, meta?: Record<string, unknown>): void;
9
- info(message: string, meta?: Record<string, unknown>): void;
10
- warn(message: string, meta?: Record<string, unknown>): void;
11
- error(message: string, meta?: Record<string, unknown>): void;
12
- }
13
- export declare const consoleLogger: Logger;
14
- /** Configuration injected into a repository (no `sst`/`Resource` coupling: B-OPS-1). */
15
- export interface RepositoryConfig {
16
- tableName: string;
17
- docClient: DynamoDBDocumentClient;
18
- maxPages?: number;
19
- batchSize?: number;
20
- maxBatchRetries?: number;
21
- concurrencyLimit?: number;
22
- logger?: Logger;
23
- }
24
- export declare const DEFAULTS: {
25
- readonly maxPages: 50;
26
- readonly batchSize: 25;
27
- readonly maxBatchRetries: 3;
28
- readonly concurrencyLimit: 5;
29
- };
30
- //# sourceMappingURL=config.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED,eAAO,MAAM,aAAa,EAAE,MAa3B,CAAC;AAEF,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,sBAAsB,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC"}
package/dist/config.js DELETED
@@ -1,21 +0,0 @@
1
- export const consoleLogger = {
2
- debug: (message, meta) => {
3
- console.debug(message, meta);
4
- },
5
- info: (message, meta) => {
6
- console.info(message, meta);
7
- },
8
- warn: (message, meta) => {
9
- console.warn(message, meta);
10
- },
11
- error: (message, meta) => {
12
- console.error(message, meta);
13
- },
14
- };
15
- export const DEFAULTS = {
16
- maxPages: 50,
17
- batchSize: 25,
18
- maxBatchRetries: 3,
19
- concurrencyLimit: 5,
20
- };
21
- //# sourceMappingURL=config.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;QACtB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;QACtB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC;AAaF,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,eAAe,EAAE,CAAC;IAClB,gBAAgB,EAAE,CAAC;CACX,CAAC"}
@@ -1,31 +0,0 @@
1
- import { type DynamoDBDocumentClient, type QueryCommandInput, type ScanCommandInput } from "@aws-sdk/lib-dynamodb";
2
- import type { ZodType } from "zod";
3
- import { type Logger } from "./config.js";
4
- export type QueryParams = Omit<QueryCommandInput, "TableName" | "ExclusiveStartKey"> & {
5
- ExclusiveStartKey?: string | Record<string, unknown>;
6
- };
7
- export type ScanParams = Omit<ScanCommandInput, "TableName" | "ExclusiveStartKey">;
8
- export interface QueryEngineOptions {
9
- tableName: string;
10
- maxPages?: number;
11
- logger?: Logger;
12
- }
13
- /**
14
- * Pagination and (strict) read validation over a document client (behaviours B-QRY-*, B-VAL-*).
15
- * `nextToken` is base64(JSON(LastEvaluatedKey)); `maxPages` caps `queryAll`/`scanAll`.
16
- */
17
- export declare class QueryEngine {
18
- private readonly docClient;
19
- private readonly tableName;
20
- private readonly maxPages;
21
- private readonly logger;
22
- constructor(docClient: DynamoDBDocumentClient, options: QueryEngineOptions);
23
- query<T>(params: QueryParams, schema?: ZodType<T>): Promise<{
24
- items: T[];
25
- nextToken?: string;
26
- }>;
27
- queryAll<T>(params: QueryParams, schema?: ZodType<T>): Promise<T[]>;
28
- scanAll<T>(params: ScanParams, schema?: ZodType<T>): Promise<T[]>;
29
- queryIterator<T>(params: QueryParams, schema?: ZodType<T>): AsyncGenerator<T[]>;
30
- }
31
- //# sourceMappingURL=query-engine.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"query-engine.d.ts","sourceRoot":"","sources":["../src/query-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EAEtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,EAA2B,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAInE,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,mBAAmB,CAAC,GAAG;IACrF,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtD,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,mBAAmB,CAAC,CAAC;AAEnF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,SAAS,EAAE,sBAAsB,EAClD,OAAO,EAAE,kBAAkB;IAOvB,KAAK,CAAC,CAAC,EACX,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAwCxC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA4BnE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAsChE,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC;CAkBvF"}
@@ -1,122 +0,0 @@
1
- import { QueryCommand, ScanCommand, } from "@aws-sdk/lib-dynamodb";
2
- import { consoleLogger, DEFAULTS } from "./config.js";
3
- import { RepositoryValidationError } from "./errors.js";
4
- import { validateItem } from "./validation.js";
5
- /**
6
- * Pagination and (strict) read validation over a document client (behaviours B-QRY-*, B-VAL-*).
7
- * `nextToken` is base64(JSON(LastEvaluatedKey)); `maxPages` caps `queryAll`/`scanAll`.
8
- */
9
- export class QueryEngine {
10
- docClient;
11
- tableName;
12
- maxPages;
13
- logger;
14
- constructor(docClient, options) {
15
- this.docClient = docClient;
16
- this.tableName = options.tableName;
17
- this.maxPages = options.maxPages ?? DEFAULTS.maxPages;
18
- this.logger = options.logger ?? consoleLogger;
19
- }
20
- async query(params, schema) {
21
- let exclusiveStartKey = params.ExclusiveStartKey;
22
- if (typeof params.ExclusiveStartKey === "string") {
23
- try {
24
- exclusiveStartKey = JSON.parse(Buffer.from(params.ExclusiveStartKey, "base64").toString());
25
- }
26
- catch (error) {
27
- this.logger.error("QueryEngine.query: failed to parse pagination token", {
28
- operation: "query",
29
- });
30
- throw new RepositoryValidationError("Invalid pagination token", "query", { cause: error });
31
- }
32
- }
33
- let result;
34
- try {
35
- result = await this.docClient.send(new QueryCommand({
36
- ...params,
37
- TableName: this.tableName,
38
- ExclusiveStartKey: exclusiveStartKey,
39
- }));
40
- }
41
- catch (error) {
42
- this.logger.error("QueryEngine.query: DynamoDB error", { operation: "query" });
43
- throw error;
44
- }
45
- const rawItems = (result.Items ?? []);
46
- const items = schema
47
- ? rawItems.map((item) => validateItem(item, schema, "query", this.logger))
48
- : rawItems;
49
- const nextToken = result.LastEvaluatedKey
50
- ? Buffer.from(JSON.stringify(result.LastEvaluatedKey)).toString("base64")
51
- : undefined;
52
- return { items, nextToken };
53
- }
54
- async queryAll(params, schema) {
55
- let items = [];
56
- let lastEvaluatedKey = typeof params.ExclusiveStartKey === "string" ? params.ExclusiveStartKey : undefined;
57
- if (params.ExclusiveStartKey && typeof params.ExclusiveStartKey !== "string") {
58
- lastEvaluatedKey = Buffer.from(JSON.stringify(params.ExclusiveStartKey)).toString("base64");
59
- }
60
- let pageCount = 0;
61
- do {
62
- const result = await this.query({ ...params, ExclusiveStartKey: lastEvaluatedKey }, schema);
63
- items = items.concat(result.items);
64
- lastEvaluatedKey = result.nextToken;
65
- pageCount++;
66
- if (pageCount >= this.maxPages && lastEvaluatedKey) {
67
- this.logger.error(`QueryEngine.queryAll: reached maxPages (${String(this.maxPages)})`, {
68
- operation: "queryAll",
69
- });
70
- lastEvaluatedKey = undefined;
71
- }
72
- } while (lastEvaluatedKey);
73
- return items;
74
- }
75
- async scanAll(params, schema) {
76
- let items = [];
77
- let lastEvaluatedKey;
78
- let pageCount = 0;
79
- do {
80
- let result;
81
- try {
82
- result = await this.docClient.send(new ScanCommand({
83
- ...params,
84
- TableName: this.tableName,
85
- ExclusiveStartKey: lastEvaluatedKey,
86
- }));
87
- }
88
- catch (error) {
89
- this.logger.error("QueryEngine.scanAll: DynamoDB error", { operation: "scanAll" });
90
- throw error;
91
- }
92
- if (result.Items) {
93
- items = items.concat(result.Items);
94
- }
95
- lastEvaluatedKey = result.LastEvaluatedKey;
96
- pageCount++;
97
- if (pageCount >= this.maxPages && lastEvaluatedKey) {
98
- this.logger.error(`QueryEngine.scanAll: reached maxPages (${String(this.maxPages)})`, {
99
- operation: "scanAll",
100
- });
101
- lastEvaluatedKey = undefined;
102
- }
103
- } while (lastEvaluatedKey);
104
- return schema
105
- ? items.map((item) => validateItem(item, schema, "scanAll", this.logger))
106
- : items;
107
- }
108
- async *queryIterator(params, schema) {
109
- let lastEvaluatedKey = typeof params.ExclusiveStartKey === "string" ? params.ExclusiveStartKey : undefined;
110
- if (params.ExclusiveStartKey && typeof params.ExclusiveStartKey !== "string") {
111
- lastEvaluatedKey = Buffer.from(JSON.stringify(params.ExclusiveStartKey)).toString("base64");
112
- }
113
- do {
114
- const result = await this.query({ ...params, ExclusiveStartKey: lastEvaluatedKey }, schema);
115
- if (result.items.length > 0) {
116
- yield result.items;
117
- }
118
- lastEvaluatedKey = result.nextToken;
119
- } while (lastEvaluatedKey);
120
- }
121
- }
122
- //# sourceMappingURL=query-engine.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"query-engine.js","sourceRoot":"","sources":["../src/query-engine.ts"],"names":[],"mappings":"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"}
@@ -1,14 +0,0 @@
1
- export interface UpdateExpressionResult {
2
- updateExpression: string;
3
- expressionAttributeNames: Record<string, string>;
4
- expressionAttributeValues: Record<string, unknown>;
5
- hasChanges: boolean;
6
- }
7
- /**
8
- * Builds a DynamoDB `SET` update expression (and its name/value maps) from a plain object.
9
- * `undefined` attributes are skipped (behaviour B-UPD-1/2).
10
- */
11
- export declare const UpdateBuilder: {
12
- build(attributes: Record<string, unknown>): UpdateExpressionResult;
13
- };
14
- //# sourceMappingURL=update-builder.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"update-builder.d.ts","sourceRoot":"","sources":["../src/update-builder.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;sBACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,sBAAsB;CAuBnE,CAAC"}
@@ -1,27 +0,0 @@
1
- /**
2
- * Builds a DynamoDB `SET` update expression (and its name/value maps) from a plain object.
3
- * `undefined` attributes are skipped (behaviour B-UPD-1/2).
4
- */
5
- export const UpdateBuilder = {
6
- build(attributes) {
7
- const updateExpressionParts = [];
8
- const expressionAttributeNames = {};
9
- const expressionAttributeValues = {};
10
- for (const [key, value] of Object.entries(attributes)) {
11
- if (value !== undefined) {
12
- const attrName = `#${key}`;
13
- const attrVal = `:${key}`;
14
- updateExpressionParts.push(`${attrName} = ${attrVal}`);
15
- expressionAttributeNames[attrName] = key;
16
- expressionAttributeValues[attrVal] = value;
17
- }
18
- }
19
- return {
20
- updateExpression: updateExpressionParts.length > 0 ? `SET ${updateExpressionParts.join(", ")}` : "",
21
- expressionAttributeNames,
22
- expressionAttributeValues,
23
- hasChanges: updateExpressionParts.length > 0,
24
- };
25
- },
26
- };
27
- //# sourceMappingURL=update-builder.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"update-builder.js","sourceRoot":"","sources":["../src/update-builder.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,CAAC,UAAmC;QACvC,MAAM,qBAAqB,GAAa,EAAE,CAAC;QAC3C,MAAM,wBAAwB,GAA2B,EAAE,CAAC;QAC5D,MAAM,yBAAyB,GAA4B,EAAE,CAAC;QAE9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;gBAC1B,qBAAqB,CAAC,IAAI,CAAC,GAAG,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;gBACvD,wBAAwB,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;gBACzC,yBAAyB,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,OAAO;YACL,gBAAgB,EACd,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YACnF,wBAAwB;YACxB,yBAAyB;YACzB,UAAU,EAAE,qBAAqB,CAAC,MAAM,GAAG,CAAC;SAC7C,CAAC;IACJ,CAAC;CACF,CAAC"}
@@ -1,7 +0,0 @@
1
- import type { ZodType } from "zod";
2
- import type { Logger } from "./config.js";
3
- /** Strictly parses a stored item against a schema (read boundary, behaviour B-VAL-1/3). */
4
- export declare function validateItem<T>(item: Record<string, unknown>, schema: ZodType<T>, operation: string, logger: Logger): T;
5
- /** Strictly parses an item before writing it (write boundary, behaviour B-VAL-1). */
6
- export declare function parseForWrite<T>(item: T, schema: ZodType<T>, operation: string, logger: Logger): T;
7
- //# sourceMappingURL=validation.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAW1C,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,CAAC,CAiBH;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,CAAC,CAQH"}
@@ -1,37 +0,0 @@
1
- import { RepositoryValidationError } from "./errors.js";
2
- function asString(value) {
3
- return typeof value === "string" ? value : undefined;
4
- }
5
- function issueSummary(issues) {
6
- return issues.map((issue) => issue.message).join("; ");
7
- }
8
- /** Strictly parses a stored item against a schema (read boundary, behaviour B-VAL-1/3). */
9
- export function validateItem(item, schema, operation, logger) {
10
- const parsed = schema.safeParse(item);
11
- if (!parsed.success) {
12
- const issues = issueSummary(parsed.error.issues);
13
- logger.error(`${operation}: validation failed`, {
14
- operation,
15
- pk: asString(item.pk),
16
- sk: asString(item.sk),
17
- issues,
18
- });
19
- throw new RepositoryValidationError(`${operation}: validation failed`, operation, {
20
- pk: asString(item.pk),
21
- sk: asString(item.sk),
22
- issues,
23
- });
24
- }
25
- return parsed.data;
26
- }
27
- /** Strictly parses an item before writing it (write boundary, behaviour B-VAL-1). */
28
- export function parseForWrite(item, schema, operation, logger) {
29
- const parsed = schema.safeParse(item);
30
- if (!parsed.success) {
31
- const issues = issueSummary(parsed.error.issues);
32
- logger.error(`${operation}: validation failed`, { operation, issues });
33
- throw new RepositoryValidationError(`${operation}: validation failed`, operation, { issues });
34
- }
35
- return parsed.data;
36
- }
37
- //# sourceMappingURL=validation.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,YAAY,CAAC,MAA6B;IACjD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,YAAY,CAC1B,IAA6B,EAC7B,MAAkB,EAClB,SAAiB,EACjB,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,qBAAqB,EAAE;YAC9C,SAAS;YACT,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM;SACP,CAAC,CAAC;QACH,MAAM,IAAI,yBAAyB,CAAC,GAAG,SAAS,qBAAqB,EAAE,SAAS,EAAE;YAChF,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAC3B,IAAO,EACP,MAAkB,EAClB,SAAiB,EACjB,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,qBAAqB,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACvE,MAAM,IAAI,yBAAyB,CAAC,GAAG,SAAS,qBAAqB,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}