@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.
- package/README.md +187 -0
- package/dist/conformance.d.ts +26 -0
- package/dist/conformance.d.ts.map +1 -0
- package/dist/conformance.js +74 -0
- package/dist/conformance.js.map +1 -0
- package/dist/conventions.d.ts +49 -0
- package/dist/conventions.d.ts.map +1 -0
- package/dist/conventions.js +33 -0
- package/dist/conventions.js.map +1 -0
- package/dist/errors.d.ts +13 -2
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +34 -4
- package/dist/errors.js.map +1 -1
- package/dist/index.d.ts +3 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -6
- package/dist/index.js.map +1 -1
- package/dist/pagination.d.ts +16 -0
- package/dist/pagination.d.ts.map +1 -0
- package/dist/pagination.js +23 -0
- package/dist/pagination.js.map +1 -0
- package/package.json +9 -4
- package/dist/base-repository.d.ts +0 -36
- package/dist/base-repository.d.ts.map +0 -1
- package/dist/base-repository.js +0 -141
- package/dist/base-repository.js.map +0 -1
- package/dist/batch-processor.d.ts +0 -27
- package/dist/batch-processor.d.ts.map +0 -1
- package/dist/batch-processor.js +0 -73
- package/dist/batch-processor.js.map +0 -1
- package/dist/client.d.ts +0 -15
- package/dist/client.d.ts.map +0 -1
- package/dist/client.js +0 -14
- package/dist/client.js.map +0 -1
- package/dist/config.d.ts +0 -30
- package/dist/config.d.ts.map +0 -1
- package/dist/config.js +0 -21
- package/dist/config.js.map +0 -1
- package/dist/query-engine.d.ts +0 -31
- package/dist/query-engine.d.ts.map +0 -1
- package/dist/query-engine.js +0 -122
- package/dist/query-engine.js.map +0 -1
- package/dist/update-builder.d.ts +0 -14
- package/dist/update-builder.d.ts.map +0 -1
- package/dist/update-builder.js +0 -27
- package/dist/update-builder.js.map +0 -1
- package/dist/validation.d.ts +0 -7
- package/dist/validation.d.ts.map +0 -1
- package/dist/validation.js +0 -37
- 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"}
|
package/dist/base-repository.js
DELETED
|
@@ -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"}
|
package/dist/batch-processor.js
DELETED
|
@@ -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
|
package/dist/client.d.ts.map
DELETED
|
@@ -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
|
package/dist/client.js.map
DELETED
|
@@ -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
|
package/dist/config.d.ts.map
DELETED
|
@@ -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
|
package/dist/config.js.map
DELETED
|
@@ -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"}
|
package/dist/query-engine.d.ts
DELETED
|
@@ -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"}
|
package/dist/query-engine.js
DELETED
|
@@ -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
|
package/dist/query-engine.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"query-engine.js","sourceRoot":"","sources":["../src/query-engine.ts"],"names":[],"mappings":"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"}
|
package/dist/update-builder.d.ts
DELETED
|
@@ -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"}
|
package/dist/update-builder.js
DELETED
|
@@ -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"}
|
package/dist/validation.d.ts
DELETED
|
@@ -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
|
package/dist/validation.d.ts.map
DELETED
|
@@ -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"}
|