@sxh62/dynamo 0.1.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 (50) hide show
  1. package/README.md +187 -0
  2. package/dist/conformance.d.ts +26 -0
  3. package/dist/conformance.d.ts.map +1 -0
  4. package/dist/conformance.js +74 -0
  5. package/dist/conformance.js.map +1 -0
  6. package/dist/conventions.d.ts +49 -0
  7. package/dist/conventions.d.ts.map +1 -0
  8. package/dist/conventions.js +33 -0
  9. package/dist/conventions.js.map +1 -0
  10. package/dist/errors.d.ts +13 -2
  11. package/dist/errors.d.ts.map +1 -1
  12. package/dist/errors.js +34 -4
  13. package/dist/errors.js.map +1 -1
  14. package/dist/index.d.ts +3 -6
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +3 -6
  17. package/dist/index.js.map +1 -1
  18. package/dist/pagination.d.ts +16 -0
  19. package/dist/pagination.d.ts.map +1 -0
  20. package/dist/pagination.js +23 -0
  21. package/dist/pagination.js.map +1 -0
  22. package/package.json +9 -4
  23. package/dist/base-repository.d.ts +0 -36
  24. package/dist/base-repository.d.ts.map +0 -1
  25. package/dist/base-repository.js +0 -141
  26. package/dist/base-repository.js.map +0 -1
  27. package/dist/batch-processor.d.ts +0 -27
  28. package/dist/batch-processor.d.ts.map +0 -1
  29. package/dist/batch-processor.js +0 -73
  30. package/dist/batch-processor.js.map +0 -1
  31. package/dist/client.d.ts +0 -15
  32. package/dist/client.d.ts.map +0 -1
  33. package/dist/client.js +0 -14
  34. package/dist/client.js.map +0 -1
  35. package/dist/config.d.ts +0 -30
  36. package/dist/config.d.ts.map +0 -1
  37. package/dist/config.js +0 -21
  38. package/dist/config.js.map +0 -1
  39. package/dist/query-engine.d.ts +0 -31
  40. package/dist/query-engine.d.ts.map +0 -1
  41. package/dist/query-engine.js +0 -122
  42. package/dist/query-engine.js.map +0 -1
  43. package/dist/update-builder.d.ts +0 -14
  44. package/dist/update-builder.d.ts.map +0 -1
  45. package/dist/update-builder.js +0 -27
  46. package/dist/update-builder.js.map +0 -1
  47. package/dist/validation.d.ts +0 -7
  48. package/dist/validation.d.ts.map +0 -1
  49. package/dist/validation.js +0 -37
  50. package/dist/validation.js.map +0 -1
@@ -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"}