@nr1e/aws 0.0.0-snapshot-20251228154426 → 0.0.0-snapshot-20251228155206

package/dist/dynamodb.d.mts

@@ -0,0 +1,104 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocumentClient, QueryCommand, QueryCommandInput, QueryCommandOutput, ScanCommand, ScanCommandOutput, PutCommand, PutCommandOutput } from '@aws-sdk/lib-dynamodb';
+export { QueryCommand, QueryCommandOutput, ScanCommand, ScanCommandOutput, PutCommand, PutCommandOutput, };
+export declare function getDynamoDBClient(region?: string): DynamoDBClient;
+export declare function getDynamoDBDocumentClient(region?: string): DynamoDBDocumentClient;
+export interface PaginationParams {
+    cursor?: string | null | undefined;
+    direction?: 'next' | 'prev' | null | undefined;
+    limit?: number | null | undefined;
+}
+export interface PaginatedResult<T> {
+    items: T[];
+    cursor: string;
+    hasNext: boolean;
+    page: number;
+}
+/**
+ * Executes a paginated DynamoDB query with full cursor-based pagination support.
+ *
+ * This helper encapsulates all pagination logic including:
+ * - Cursor encoding/decoding
+ * - ExclusiveStartKey calculation
+ * - Bidirectional pagination (next/prev)
+ * - First/last key tracking
+ * - Automatic item ordering
+ *
+ * @param params Configuration for the query and item mapping
+ * @param params.client DynamoDB Document Client instance
+ * @param params.query QueryCommand input (without ExclusiveStartKey, Limit, ScanIndexForward)
+ * @param params.keyAttributes Array of key attribute names for the table/index being queried
+ * @param params.mapItem Function to transform raw DynamoDB items into desired format
+ * @param pagination Pagination parameters from the client
+ * @param pagination.cursor Base64-encoded cursor from previous request
+ * @param pagination.direction Direction to paginate ('next' or 'prev')
+ * @param pagination.limit Number of items per page (locked after first request)
+ * @param defaultScanForward Controls the default scan direction. When true, 'next' scans forward (ascending) and 'prev' scans backward (descending). When false, the behavior is inverted.
+ * @returns Paginated result with items, cursor, hasNext flag, and page number
+ *
+ * @example
+ * ```typescript
+ * return executePaginatedQuery(
+ *   {
+ *     client: getDynamoDBDocumentClient(),
+ *     query: {
+ *       TableName: 'MyTable',
+ *       IndexName: 'Gs1',
+ *       KeyConditionExpression: 'Gs1Pk = :pk',
+ *       ExpressionAttributeValues: { ':pk': 'Agency#123' },
+ *     },
+ *     keyAttributes: ['Pk', 'Sk', 'Gs1Pk', 'Gs1Sk'],
+ *     mapItem: (item) => item.Detail,
+ *   },
+ *   { cursor: '...', direction: 'next', limit: 10 },
+ *   true // defaultScanForward
+ * );
+ * ```
+ */
+export declare function executePaginatedQuery<T = any>(params: {
+    client: DynamoDBDocumentClient;
+    query: Omit<QueryCommandInput, 'ExclusiveStartKey' | 'Limit' | 'ScanIndexForward'>;
+    keyAttributes: string[];
+    mapItem: (item: Record<string, any>) => T;
+}, pagination: PaginationParams, defaultScanForward?: boolean): Promise<PaginatedResult<T>>;
+/**
+ * Executes a paginated DynamoDB scan with cursor-based pagination support.
+ *
+ * Similar to executePaginatedQuery but for Scan operations. Note that Scan operations
+ * are unordered by nature and do not support scan direction control (unlike Query operations).
+ * Scan operations only support forward pagination (no bidirectional navigation).
+ *
+ * @param params Configuration for the scan and item mapping
+ * @param params.client DynamoDB Document Client instance
+ * @param params.scan ScanCommand input (without ExclusiveStartKey or Limit)
+ * @param params.keyNames Array of key attribute names for the table
+ * @param params.mapItem Function to transform raw DynamoDB items into desired format
+ * @param pagination Pagination parameters from the client
+ * @param pagination.cursor Base64-encoded cursor from previous request
+ * @param pagination.limit Number of items per page (locked after first request)
+ * @returns Paginated result with items, cursor, hasNext flag, and page number
+ *
+ * @example
+ * ```typescript
+ * return executePaginatedScan(
+ *   {
+ *     client: getDynamoDBDocumentClient(),
+ *     scan: {
+ *       TableName: 'MyTable',
+ *       FilterExpression: 'attribute_exists(#attr)',
+ *       ExpressionAttributeNames: { '#attr': 'myAttribute' },
+ *     },
+ *     keyNames: ['Pk', 'Sk'],
+ *     mapItem: (item) => item.Detail,
+ *   },
+ *   { cursor: '...', limit: 10 }
+ * );
+ * ```
+ */
+export declare function executePaginatedScan<T = any>(params: {
+    client: DynamoDBDocumentClient;
+    scan: Omit<QueryCommandInput, 'ExclusiveStartKey' | 'Limit'>;
+    keyNames: string[];
+    mapItem: (item: Record<string, any>) => T;
+}, pagination: PaginationParams): Promise<PaginatedResult<T>>;
+//# sourceMappingURL=dynamodb.d.mts.map

package/dist/dynamodb.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb.d.mts","sourceRoot":"","sources":["../src/dynamodb.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,0BAA0B,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,gBAAgB,GACjB,CAAC;AAKF,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,kBAQhD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,0BAYxD;AAwJD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,GAAG,GAAG,EACjD,MAAM,EAAE;IACN,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,IAAI,CACT,iBAAiB,EACjB,mBAAmB,GAAG,OAAO,GAAG,kBAAkB,CACnD,CAAC;IACF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;CAC3C,EACD,UAAU,EAAE,gBAAgB,EAC5B,kBAAkB,CAAC,EAAE,OAAO,GAC3B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAkD7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAChD,MAAM,EAAE;IACN,MAAM,EAAE,sBAAsB,CAAC;IAC/B,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;CAC3C,EACD,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CA4C7B"}

package/dist/dynamodb.mjs

@@ -0,0 +1,297 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocumentClient, QueryCommand, ScanCommand, PutCommand, } from '@aws-sdk/lib-dynamodb';
+import { getAwsRegion } from './region.mjs';
+export { QueryCommand, ScanCommand, PutCommand, };
+const dynamoDBClients = new Map();
+const dynamoDBDocumentClients = new Map();
+export function getDynamoDBClient(region) {
+    const regionKey = region || getAwsRegion();
+    let client = dynamoDBClients.get(regionKey);
+    if (!client) {
+        client = new DynamoDBClient({ region: regionKey });
+        dynamoDBClients.set(regionKey, client);
+    }
+    return client;
+}
+export function getDynamoDBDocumentClient(region) {
+    const regionKey = region || getAwsRegion();
+    let client = dynamoDBDocumentClients.get(regionKey);
+    if (!client) {
+        client = DynamoDBDocumentClient.from(getDynamoDBClient(regionKey), {
+            marshallOptions: {
+                removeUndefinedValues: true,
+            },
+        });
+        dynamoDBDocumentClients.set(regionKey, client);
+    }
+    return client;
+}
+function dedupe(arr) {
+    return Array.from(new Set(arr));
+}
+/**
+ * Builds a DynamoDB `ExclusiveStartKey` or `LastEvaluatedKey` object
+ * from a given item and a list of key attribute names.
+ *
+ * This is useful when performing paginated `Query` or `Scan` operations
+ * and you only have the last returned item from the previous page rather
+ * than the full `LastEvaluatedKey` returned by DynamoDB.
+ *
+ * The function copies the specified key attributes from the provided item
+ * into a new object suitable for use as `ExclusiveStartKey` in a
+ * subsequent query. For Global Secondary Index (GSI) queries, include
+ * both the table’s primary key attributes and the index’s key attributes.
+ *
+ * @param item - The DynamoDB item (from a previous page) to extract key values from.
+ * @param keyNames - The list of key attribute names that uniquely identify an item
+ *                   (e.g., `["Pk", "Sk"]` for a table, or
+ *                   `["Pk", "Sk", "Gs1Pk", "Gs1Sk"]` for a GSI).
+ * @returns A plain JavaScript object representing the `ExclusiveStartKey`.
+ *
+ * @throws {Error} If any specified key attribute is missing on the provided item.
+ *
+ * @example
+ * ```ts
+ * const lastItem = { Pk: "User#123", Sk: "Order#456", Gs1Pk: "User#123", Gs1Sk: "Order#456" };
+ * const keyNames = ["Pk", "Sk", "Gs1Pk", "Gs1Sk"];
+ * const eks = makeExclusiveStartKeyFromItem(lastItem, keyNames);
+ *
+ * await ddbDoc.query({
+ *   TableName: "MyTable",
+ *   IndexName: "GSI1",
+ *   Limit: 100,
+ *   ExclusiveStartKey: eks,
+ * });
+ * ```
+ */
+function makeExclusiveStartKeyFromItem(item, keyNames) {
+    if (item) {
+        const eks = {};
+        for (const name of dedupe(keyNames)) {
+            if (!(name in item)) {
+                throw new Error(`ExclusiveStartKey: item is missing key attribute "${name}"`);
+            }
+            eks[name] = item[name];
+        }
+        return eks;
+    }
+    return undefined;
+}
+function encodeCursor(cursor) {
+    return Buffer.from(JSON.stringify(cursor)).toString('base64url');
+}
+function decodeCursor(encoded) {
+    if (encoded) {
+        return JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8'));
+    }
+    return undefined;
+}
+function getExclusiveStartKey(previous, direction) {
+    if (!direction) {
+        direction = 'next';
+    }
+    if (previous) {
+        if (previous.d === 'p' && previous.p === 1) {
+            return undefined;
+        }
+        if (previous.p === 1 && direction === 'prev') {
+            return undefined;
+        }
+        if (previous.d === 'n' && direction === 'next') {
+            // If trying to go next but there's no LastEvaluatedKey, we're past the last page
+            // Return the first key to query from there with ScanIndexForward=true
+            // This will return an empty result set instead of wrapping to page 1
+            if (previous.l === undefined) {
+                return previous.f;
+            }
+            return previous.l;
+        }
+        if (previous.d === 'n' && direction === 'prev') {
+            return previous.f;
+        }
+        if (previous.d === 'p' && direction === 'prev') {
+            return previous.l;
+        }
+        if (previous.d === 'p' && direction === 'next') {
+            return previous.f;
+        }
+    }
+    return undefined;
+}
+function getNextPage(previous, direction) {
+    if (previous) {
+        if (direction === 'next') {
+            return previous.p + 1;
+        }
+        if (direction === 'prev') {
+            return previous.p - 1;
+        }
+    }
+    return 1;
+}
+function encodeDirection(direction) {
+    if (direction === 'prev') {
+        return 'p';
+    }
+    return 'n';
+}
+function getDirection(previous, direction) {
+    if (direction === 'prev' && previous?.p === 1) {
+        return 'next';
+    }
+    if (direction === 'prev') {
+        return 'prev';
+    }
+    return 'next';
+}
+/**
+ * Executes a paginated DynamoDB query with full cursor-based pagination support.
+ *
+ * This helper encapsulates all pagination logic including:
+ * - Cursor encoding/decoding
+ * - ExclusiveStartKey calculation
+ * - Bidirectional pagination (next/prev)
+ * - First/last key tracking
+ * - Automatic item ordering
+ *
+ * @param params Configuration for the query and item mapping
+ * @param params.client DynamoDB Document Client instance
+ * @param params.query QueryCommand input (without ExclusiveStartKey, Limit, ScanIndexForward)
+ * @param params.keyAttributes Array of key attribute names for the table/index being queried
+ * @param params.mapItem Function to transform raw DynamoDB items into desired format
+ * @param pagination Pagination parameters from the client
+ * @param pagination.cursor Base64-encoded cursor from previous request
+ * @param pagination.direction Direction to paginate ('next' or 'prev')
+ * @param pagination.limit Number of items per page (locked after first request)
+ * @param defaultScanForward Controls the default scan direction. When true, 'next' scans forward (ascending) and 'prev' scans backward (descending). When false, the behavior is inverted.
+ * @returns Paginated result with items, cursor, hasNext flag, and page number
+ *
+ * @example
+ * ```typescript
+ * return executePaginatedQuery(
+ *   {
+ *     client: getDynamoDBDocumentClient(),
+ *     query: {
+ *       TableName: 'MyTable',
+ *       IndexName: 'Gs1',
+ *       KeyConditionExpression: 'Gs1Pk = :pk',
+ *       ExpressionAttributeValues: { ':pk': 'Agency#123' },
+ *     },
+ *     keyAttributes: ['Pk', 'Sk', 'Gs1Pk', 'Gs1Sk'],
+ *     mapItem: (item) => item.Detail,
+ *   },
+ *   { cursor: '...', direction: 'next', limit: 10 },
+ *   true // defaultScanForward
+ * );
+ * ```
+ */
+export async function executePaginatedQuery(params, pagination, defaultScanForward) {
+    const { client, query, keyAttributes, mapItem } = params;
+    // Decode cursor and calculate pagination parameters
+    const decodedCursor = decodeCursor(pagination?.cursor);
+    const limit = decodedCursor?.i ?? pagination?.limit ?? 25;
+    // Validate limit
+    if (limit <= 0) {
+        throw new Error('Pagination limit must be a positive number');
+    }
+    const exclusiveStartKey = getExclusiveStartKey(decodedCursor, pagination?.direction);
+    const direction = getDirection(decodedCursor, pagination?.direction);
+    // Execute query with calculated pagination parameters
+    const result = await client.send(new QueryCommand({
+        ...query,
+        Limit: limit,
+        ScanIndexForward: defaultScanForward
+            ? direction === 'next'
+            : direction === 'prev',
+        ExclusiveStartKey: exclusiveStartKey,
+    }));
+    // Build cursor for next request
+    const page = getNextPage(decodedCursor, direction);
+    const firstItem = result.Items?.[0];
+    const newCursor = {
+        l: result.LastEvaluatedKey,
+        f: makeExclusiveStartKeyFromItem(firstItem, keyAttributes),
+        p: page,
+        d: encodeDirection(direction),
+        i: limit,
+    };
+    // Map and order items
+    const items = (result.Items ?? []).map(mapItem);
+    return {
+        items: direction === 'next' ? items : items.reverse(),
+        cursor: encodeCursor(newCursor),
+        hasNext: !!result.LastEvaluatedKey,
+        page,
+    };
+}
+/**
+ * Executes a paginated DynamoDB scan with cursor-based pagination support.
+ *
+ * Similar to executePaginatedQuery but for Scan operations. Note that Scan operations
+ * are unordered by nature and do not support scan direction control (unlike Query operations).
+ * Scan operations only support forward pagination (no bidirectional navigation).
+ *
+ * @param params Configuration for the scan and item mapping
+ * @param params.client DynamoDB Document Client instance
+ * @param params.scan ScanCommand input (without ExclusiveStartKey or Limit)
+ * @param params.keyNames Array of key attribute names for the table
+ * @param params.mapItem Function to transform raw DynamoDB items into desired format
+ * @param pagination Pagination parameters from the client
+ * @param pagination.cursor Base64-encoded cursor from previous request
+ * @param pagination.limit Number of items per page (locked after first request)
+ * @returns Paginated result with items, cursor, hasNext flag, and page number
+ *
+ * @example
+ * ```typescript
+ * return executePaginatedScan(
+ *   {
+ *     client: getDynamoDBDocumentClient(),
+ *     scan: {
+ *       TableName: 'MyTable',
+ *       FilterExpression: 'attribute_exists(#attr)',
+ *       ExpressionAttributeNames: { '#attr': 'myAttribute' },
+ *     },
+ *     keyNames: ['Pk', 'Sk'],
+ *     mapItem: (item) => item.Detail,
+ *   },
+ *   { cursor: '...', limit: 10 }
+ * );
+ * ```
+ */
+export async function executePaginatedScan(params, pagination) {
+    const { client, scan, keyNames, mapItem } = params;
+    // Decode cursor and calculate pagination parameters
+    const decodedCursor = decodeCursor(pagination?.cursor);
+    const limit = decodedCursor?.i ?? pagination?.limit ?? 25;
+    // Validate limit
+    if (limit <= 0) {
+        throw new Error('Pagination limit must be a positive number');
+    }
+    // For scans, only forward pagination is supported
+    const exclusiveStartKey = decodedCursor?.l;
+    // Execute scan with calculated pagination parameters
+    const result = await client.send(new ScanCommand({
+        ...scan,
+        Limit: limit,
+        ExclusiveStartKey: exclusiveStartKey,
+    }));
+    // Build cursor for next request
+    const page = (decodedCursor?.p ?? 0) + 1;
+    const firstItem = result.Items?.[0];
+    const newCursor = {
+        l: result.LastEvaluatedKey,
+        f: makeExclusiveStartKeyFromItem(firstItem, keyNames),
+        p: page,
+        d: 'n', // Scans only support forward direction
+        i: limit,
+    };
+    // Map items
+    const items = (result.Items ?? []).map(mapItem);
+    return {
+        items,
+        cursor: encodeCursor(newCursor),
+        hasNext: !!result.LastEvaluatedKey,
+        page,
+    };
+}
+//# sourceMappingURL=dynamodb.mjs.map

package/dist/dynamodb.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb.mjs","sourceRoot":"","sources":["../src/dynamodb.mts"],"names":[],"mappings":"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"}

package/dist/event-bridge.d.mts

@@ -0,0 +1,10 @@
+import { EventBridgeClient } from '@aws-sdk/client-eventbridge';
+export declare function getEventBridgeClient(region?: string): EventBridgeClient;
+export declare function sendEvent(eventBusName: string, source: string, detailType: string, detail: unknown, region?: string): Promise<import("@aws-sdk/client-eventbridge").PutEventsCommandOutput>;
+export interface EventBridgeEvent {
+    source: string;
+    detailType: string;
+    detail: unknown;
+}
+export declare function sendEvents(eventBusName: string, events: EventBridgeEvent[], region?: string): Promise<import("@aws-sdk/client-eventbridge").PutEventsCommandOutput>;
+//# sourceMappingURL=event-bridge.d.mts.map

package/dist/event-bridge.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bridge.d.mts","sourceRoot":"","sources":["../src/event-bridge.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAmB,MAAM,6BAA6B,CAAC;AAIhF,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAIvE;AAED,wBAAsB,SAAS,CAC7B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,MAAM,yEAchB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,gBAAgB,EAAE,EAC1B,MAAM,CAAC,EAAE,MAAM,yEAYhB"}

package/dist/event-bridge.mjs

@@ -0,0 +1,35 @@
+import { EventBridgeClient, PutEventsCommand } from '@aws-sdk/client-eventbridge';
+let eventBridgeClient = undefined;
+export function getEventBridgeClient(region) {
+    if (eventBridgeClient)
+        return eventBridgeClient;
+    eventBridgeClient = new EventBridgeClient({ region });
+    return eventBridgeClient;
+}
+export async function sendEvent(eventBusName, source, detailType, detail, region) {
+    const client = getEventBridgeClient(region);
+    const command = new PutEventsCommand({
+        Entries: [
+            {
+                Source: source,
+                DetailType: detailType,
+                Detail: JSON.stringify(detail),
+                EventBusName: eventBusName,
+            },
+        ],
+    });
+    return await client.send(command);
+}
+export async function sendEvents(eventBusName, events, region) {
+    const client = getEventBridgeClient(region);
+    const command = new PutEventsCommand({
+        Entries: events.map((event) => ({
+            Source: event.source,
+            DetailType: event.detailType,
+            Detail: JSON.stringify(event.detail),
+            EventBusName: eventBusName,
+        })),
+    });
+    return await client.send(command);
+}
+//# sourceMappingURL=event-bridge.mjs.map

package/dist/event-bridge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bridge.mjs","sourceRoot":"","sources":["../src/event-bridge.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAE,gBAAgB,EAAC,MAAM,6BAA6B,CAAC;AAEhF,IAAI,iBAAiB,GAAkC,SAAS,CAAC;AAEjE,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,IAAI,iBAAiB;QAAE,OAAO,iBAAiB,CAAC;IAChD,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC;IACpD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,YAAoB,EACpB,MAAc,EACd,UAAkB,EAClB,MAAe,EACf,MAAe;IAEf,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;QACnC,OAAO,EAAE;YACP;gBACE,MAAM,EAAE,MAAM;gBACd,UAAU,EAAE,UAAU;gBACtB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBAC9B,YAAY,EAAE,YAAY;aAC3B;SACF;KACF,CAAC,CAAC;IACH,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,YAAoB,EACpB,MAA0B,EAC1B,MAAe;IAEf,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;YACpC,YAAY,EAAE,YAAY;SAC3B,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/index.d.mts

@@ -1,4 +1,8 @@
+export * from './event-bridge.mjs';
+export * from './dynamodb.mjs';
 export * from './region.mjs';
+export * from './s3.mjs';
 export * from './secrets-manager.mjs';
 export * from './ses.mjs';
+export * from './sqs.mjs';
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/index.mjs

@@ -1,4 +1,8 @@
+export * from './event-bridge.mjs';
+export * from './dynamodb.mjs';
 export * from './region.mjs';
+export * from './s3.mjs';
 export * from './secrets-manager.mjs';
 export * from './ses.mjs';
+export * from './sqs.mjs';
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/s3.d.mts

@@ -0,0 +1,55 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { S3Client } from '@aws-sdk/client-s3';
+export declare function getS3Client(region?: string): S3Client;
+export interface PutFileInput {
+    bucketName: string;
+    key: string;
+    data: Buffer;
+    contentType: string;
+    region?: string;
+}
+export declare function putFile(input: PutFileInput): Promise<void>;
+export interface GetSignedGetObjectUrlInput {
+    bucketName: string;
+    key: string;
+    region?: string;
+    expiresIn?: number;
+}
+export declare function getSignedGetObjectUrl(input: GetSignedGetObjectUrlInput): Promise<string>;
+export interface GetSignedPutObjectUrlInput {
+    bucketName: string;
+    key: string;
+    contentType: string;
+    region?: string;
+    expiresIn?: number;
+    metadata?: Record<string, string>;
+}
+export declare function getSignedPutObjectUrl(input: GetSignedPutObjectUrlInput): Promise<string>;
+export interface GetObjectInput {
+    bucketName: string;
+    key: string;
+    region?: string;
+}
+export interface GetObjectOutput {
+    buffer: Buffer;
+    fileName: string;
+    contentType?: string;
+    metadata?: Record<string, string>;
+}
+export declare function getFile(input: GetObjectInput): Promise<GetObjectOutput | null>;
+export interface ListObjectsInput {
+    bucketName: string;
+    prefix: string;
+    region?: string;
+}
+export interface S3ObjectInfo {
+    key: string;
+    fileName: string;
+    contentType?: string;
+    metadata?: Record<string, string>;
+    lastModified?: Date;
+    size?: number;
+}
+export declare function listObjectsWithMetadata(input: ListObjectsInput): Promise<S3ObjectInfo[]>;
+//# sourceMappingURL=s3.d.mts.map

package/dist/s3.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.mts","sourceRoot":"","sources":["../src/s3.mts"],"names":[],"mappings":";;AAAA,OAAO,EAGL,QAAQ,EAGT,MAAM,oBAAoB,CAAC;AAK5B,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,YAO1C;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,iBAShD;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAsB,OAAO,CAC3B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiCjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CA8CzB"}

package/dist/s3.mjs

@@ -0,0 +1,110 @@
+import { GetObjectCommand, PutObjectCommand, S3Client, S3ServiceException, ListObjectsV2Command, } from '@aws-sdk/client-s3';
+import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+const clients = {};
+export function getS3Client(region) {
+    let client = clients[region ?? 'unspecified'];
+    if (!client) {
+        client = new S3Client({ region });
+        clients[region ?? 'unspecified'] = client;
+    }
+    return client;
+}
+export async function putFile(input) {
+    await getS3Client(input.region).send(new PutObjectCommand({
+        Bucket: input.bucketName,
+        Key: input.key,
+        Body: input.data,
+        ContentType: input.contentType,
+    }));
+}
+export async function getSignedGetObjectUrl(input) {
+    const client = getS3Client(input.region);
+    const command = new GetObjectCommand({
+        Bucket: input.bucketName,
+        Key: input.key,
+    });
+    return await getSignedUrl(client, command, {
+        expiresIn: input.expiresIn ?? 300, // Default is 5 minutes
+    });
+}
+export async function getSignedPutObjectUrl(input) {
+    const client = getS3Client(input.region);
+    const comment = new PutObjectCommand({
+        Bucket: input.bucketName,
+        Key: input.key,
+        Metadata: input.metadata,
+        ContentType: input.contentType,
+    });
+    return await getSignedUrl(client, comment, {
+        expiresIn: input.expiresIn ?? 300, // Default is 5 minutes
+    });
+}
+export async function getFile(input) {
+    try {
+        const response = await getS3Client(input.region).send(new GetObjectCommand({
+            Bucket: input.bucketName,
+            Key: input.key,
+        }));
+        // stream the body into a Buffer
+        const stream = response.Body;
+        const chunks = [];
+        for await (const chunk of stream) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        const fileName = input.key.split('/').pop() || input.key;
+        return {
+            fileName,
+            buffer: Buffer.concat(chunks),
+            contentType: response.ContentType ?? undefined,
+            metadata: response.Metadata,
+        };
+    }
+    catch (err) {
+        // err may be an S3ServiceException
+        if (err instanceof S3ServiceException && err.name === 'NoSuchKey') {
+            // not found — return null or handle as you like
+            return null;
+        }
+        // re-throw other errors
+        throw err;
+    }
+}
+export async function listObjectsWithMetadata(input) {
+    const client = getS3Client(input.region);
+    // First, list all objects with the prefix
+    const listResponse = await client.send(new ListObjectsV2Command({
+        Bucket: input.bucketName,
+        Prefix: input.prefix,
+    }));
+    if (!listResponse.Contents || listResponse.Contents.length === 0) {
+        return [];
+    }
+    // For each object, get its metadata by making a HEAD request (GetObjectCommand without Body)
+    const objectInfoPromises = listResponse.Contents.map(async (obj) => {
+        if (!obj.Key)
+            return null;
+        try {
+            const headResponse = await client.send(new GetObjectCommand({
+                Bucket: input.bucketName,
+                Key: obj.Key,
+            }));
+            const fileName = obj.Key.split('/').pop() || obj.Key;
+            return {
+                key: obj.Key,
+                fileName,
+                contentType: headResponse.ContentType,
+                metadata: headResponse.Metadata,
+                lastModified: obj.LastModified,
+                size: obj.Size,
+            };
+        }
+        catch (err) {
+            // If we can't get metadata for an object, skip it
+            console.warn(`Failed to get metadata for ${obj.Key}:`, err);
+            return null;
+        }
+    });
+    const results = await Promise.all(objectInfoPromises);
+    return results.filter((result) => result !== null);
+}
+//# sourceMappingURL=s3.mjs.map

package/dist/s3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.mjs","sourceRoot":"","sources":["../src/s3.mts"],"names":[],"mappings":"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"}

package/dist/sqs.d.mts

@@ -0,0 +1,4 @@
+import { SQSClient } from '@aws-sdk/client-sqs';
+export declare function getSQSClient(region?: string): SQSClient;
+export declare function sendMessage(queueUrl: string, messageBody: string, region?: string): Promise<void>;
+//# sourceMappingURL=sqs.d.mts.map

package/dist/sqs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqs.d.mts","sourceRoot":"","sources":["../src/sqs.mts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAIlE,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,aAO3C;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,iBAQhB"}

package/dist/sqs.mjs

@@ -0,0 +1,17 @@
+import { SendMessageCommand, SQSClient } from '@aws-sdk/client-sqs';
+const clients = {};
+export function getSQSClient(region) {
+    let client = clients[region ?? 'unspecified'];
+    if (!client) {
+        client = new SQSClient({ region });
+        clients[region ?? 'unspecified'] = client;
+    }
+    return client;
+}
+export async function sendMessage(queueUrl, messageBody, region) {
+    await getSQSClient(region).send(new SendMessageCommand({
+        QueueUrl: queueUrl,
+        MessageBody: messageBody,
+    }));
+}
+//# sourceMappingURL=sqs.mjs.map

package/dist/sqs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqs.mjs","sourceRoot":"","sources":["../src/sqs.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAE,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAElE,MAAM,OAAO,GAA8B,EAAE,CAAC;AAE9C,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,IAAI,SAAS,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC;QACjC,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,GAAG,MAAM,CAAC;IAC5C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,WAAmB,EACnB,MAAe;IAEf,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAC7B,IAAI,kBAAkB,CAAC;QACrB,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,WAAW;KACzB,CAAC,CACH,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nr1e/aws",
   "description": "Provides common AWS utilities",
-  "version": "0.0.0-snapshot-20251228154426",
+  "version": "0.0.0-snapshot-20251228155206",
   "type": "module",
   "author": "NR1E, Inc.",
   "publishConfig": {
@@ -25,9 +25,15 @@
     "vitest": "4.0.6"
   },
   "dependencies": {
+    "@aws-sdk/client-dynamodb": "^3.839.0",
+    "@aws-sdk/client-eventbridge": "^3.839.0",
+    "@aws-sdk/client-s3": "^3.839.0",
     "@aws-sdk/client-secrets-manager": "^3.839.0",
     "@aws-sdk/client-ses": "^3.839.0",
-    "@nr1e/commons": "0.0.0-snapshot-20251228154426"
+    "@aws-sdk/client-sqs": "^3.839.0",
+    "@aws-sdk/lib-dynamodb": "^3.839.0",
+    "@aws-sdk/s3-request-presigner": "^3.839.0",
+    "@nr1e/commons": "0.0.0-snapshot-20251228155206"
   },
   "exports": {
     ".": {