@kensio/yulin 0.0.1 → 0.1.0

package/.github/workflows/pr.yml

@@ -0,0 +1,54 @@
+---
+name: PR
+
+on:
+  pull_request:
+    branches:
+      - main
+
+defaults:
+  run:
+    shell: bash
+
+env:
+  CI: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    steps:
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm lint
+
+  test:
+    name: Test
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    steps:
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm test:coverage
+
+  build:
+    name: Build
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    steps:
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build

package/.idea/codeStyles/codeStyleConfig.xml

@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default" />
+  </state>
+</component>

package/.nvmrc

@@ -1 +1 @@
-v24.13.1
+v24.16.0

package/README.md

@@ -1,6 +1,49 @@
 # yulin
 
-AWS system behaviour simulation for isolated unit testing
+AWS system behaviour simulation for isolated unit testing, local development and CI.
+
+## Installation
+
+```bash
+npm i -D @kensio/yulin
+```
+
+## Usage
+
+Still in alpha!
+
+## What is yulin?
+
+TLDR: yulin is an AWS simulator for testing Node.js applications.
+
+The simulation is not only local to the machine, but in the same single process
+with the test and application under test. No network or external i/o is
+involved. This is what "isolated" refers to.
+
+This "isolated system" approach to testing has a few advantages:
+
+ - Tests run fast as everything is in memory with no real networking.
+ - Test set-up is fast and uncomplicated, as there are no containers or extra
+   dependencies to manage.
+ - It's straightforward to use multiple other mocks and simulators alongside
+   yulin, such as [nock](https://github.com/nock/nock), as yulin makes no
+   assumptions about the environment.
+ - You can control everything in each isolated test process, such as controlling
+   the current time, even when multiple different AWS services are simulated.
+ - One test can cover **meaningful system behaviour** across multiple AWS
+   services and applications, such as Lambdas sending events to SQS queues to be
+   picked up by other Lambdas, or DynamoDB streams triggering Lambdas.
+
+That last point is the most important. The motivation behind yulin is to enable
+efficient tests that cover the logical behaviour of a system. That is in
+contrast to less valuable microscopic unit tests with fiddly mocks and brittle
+assertions. The goal of yulin is to allow you to test system behaviours that are
+meaningful to users and stakeholders.
+
+## What's in a name?
+
+The word yǔlín (雨林) is Chinese for "rainforest". This is a roundabout reference
+to "Amazon" as in Amazon Web Services.
 
 ## Development
 

package/dist/command/command-handler.d.ts

@@ -0,0 +1,4 @@
+export interface CommandHandler<TCommand, TOutput> {
+    handle(cmd: TCommand): Promise<TOutput>;
+}
+//# sourceMappingURL=command-handler.d.ts.map

package/dist/command/command-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../src/command/command-handler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc,CAAC,QAAQ,EAAE,OAAO;IAC/C,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC"}

package/dist/command/command-handler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-handler.js.map

package/dist/command/command-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.js","sourceRoot":"","sources":["../../src/command/command-handler.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/service/cloudfront/factory/cloudfront-functions.factory.d.ts

@@ -0,0 +1,7 @@
+import type { CloudFrontRequest } from "../typings/cloudfront-functions.js";
+import { StaticFactory } from "@kensio/part-factory";
+/**
+ * Makes instances of the CloudFrontRequest object structure.
+ */
+export declare const cloudFrontRequestFactory: StaticFactory<CloudFrontRequest>;
+//# sourceMappingURL=cloudfront-functions.factory.d.ts.map

package/dist/service/cloudfront/factory/cloudfront-functions.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudfront-functions.factory.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudfront/factory/cloudfront-functions.factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,wBAAwB,kCA2BnC,CAAC"}

package/dist/service/cloudfront/factory/cloudfront-functions.factory.js

@@ -0,0 +1,33 @@
+import { StaticFactory } from "@kensio/part-factory";
+/**
+ * Makes instances of the CloudFrontRequest object structure.
+ */
+export const cloudFrontRequestFactory = new StaticFactory({
+    cookies: {
+        sessionId: {
+            value: "test-session-id",
+        },
+    },
+    headers: {
+        accept: {
+            value: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        },
+        "accept-language": {
+            value: "en-GB,en;q=0.9",
+        },
+        host: {
+            value: "yulin.test",
+        },
+        "user-agent": {
+            value: "Mozilla/5.0",
+        },
+    },
+    method: "GET",
+    querystring: {
+        page: {
+            value: "1",
+        },
+    },
+    uri: "/cloudfront/",
+});
+//# sourceMappingURL=cloudfront-functions.factory.js.map

package/dist/service/cloudfront/factory/cloudfront-functions.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudfront-functions.factory.js","sourceRoot":"","sources":["../../../../src/service/cloudfront/factory/cloudfront-functions.factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,aAAa,CAAoB;IAC3E,OAAO,EAAE;QACP,SAAS,EAAE;YACT,KAAK,EAAE,iBAAiB;SACzB;KACF;IACD,OAAO,EAAE;QACP,MAAM,EAAE;YACN,KAAK,EAAE,iEAAiE;SACzE;QACD,iBAAiB,EAAE;YACjB,KAAK,EAAE,gBAAgB;SACxB;QACD,IAAI,EAAE;YACJ,KAAK,EAAE,YAAY;SACpB;QACD,YAAY,EAAE;YACZ,KAAK,EAAE,aAAa;SACrB;KACF;IACD,MAAM,EAAE,KAAK;IACb,WAAW,EAAE;QACX,IAAI,EAAE;YACJ,KAAK,EAAE,GAAG;SACX;KACF;IACD,GAAG,EAAE,cAAc;CACpB,CAAC,CAAC"}

package/dist/service/cloudfront/index.d.ts

@@ -0,0 +1,3 @@
+export { cloudFrontRequestFactory } from "./factory/cloudfront-functions.factory.js";
+export type { CloudFrontCookies, CloudFrontEvent, CloudFrontEventContext, CloudFrontHeaders, CloudFrontMultiValue, CloudFrontQueryString, CloudFrontRequest, CloudFrontResponse, CloudFrontValue, CloudFrontViewer, } from "./typings/cloudfront-functions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/service/cloudfront/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/service/cloudfront/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,mCAAmC,CAAC"}

package/dist/service/cloudfront/index.js

@@ -0,0 +1,2 @@
+export { cloudFrontRequestFactory } from "./factory/cloudfront-functions.factory.js";
+//# sourceMappingURL=index.js.map

package/dist/service/cloudfront/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/service/cloudfront/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/service/cloudfront/typings/cloudfront-functions.d.ts

@@ -0,0 +1,37 @@
+export interface CloudFrontValue {
+    value: string;
+}
+export interface CloudFrontMultiValue {
+    multiValue: CloudFrontValue[];
+}
+export type CloudFrontHeaders = Record<string, CloudFrontValue>;
+export type CloudFrontQueryString = Record<string, CloudFrontValue | CloudFrontMultiValue>;
+export type CloudFrontCookies = Record<string, CloudFrontValue>;
+export interface CloudFrontRequest {
+    method: string;
+    uri: string;
+    headers: CloudFrontHeaders;
+    querystring: CloudFrontQueryString;
+    cookies: CloudFrontCookies;
+}
+export interface CloudFrontResponse {
+    statusCode: number;
+    statusDescription?: string;
+    headers?: CloudFrontHeaders;
+}
+export interface CloudFrontEventContext {
+    distributionDomainName?: string;
+    endpoint?: string;
+    distributionId?: string;
+    eventType: "viewer-request" | "viewer-response";
+    requestId: string;
+}
+export interface CloudFrontViewer {
+    ip: string;
+}
+export interface CloudFrontEvent {
+    context: CloudFrontEventContext;
+    viewer: CloudFrontViewer;
+    request: CloudFrontRequest;
+}
+//# sourceMappingURL=cloudfront-functions.d.ts.map

package/dist/service/cloudfront/typings/cloudfront-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudfront-functions.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudfront/typings/cloudfront-functions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEhE,MAAM,MAAM,qBAAqB,GAAG,MAAM,CACxC,MAAM,EACN,eAAe,GAAG,oBAAoB,CACvC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,EAAE,qBAAqB,CAAC;IACnC,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,sBAAsB,CAAC;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B"}

package/dist/service/cloudfront/typings/cloudfront-functions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cloudfront-functions.js.map

package/dist/service/cloudfront/typings/cloudfront-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudfront-functions.js","sourceRoot":"","sources":["../../../../src/service/cloudfront/typings/cloudfront-functions.ts"],"names":[],"mappings":""}

package/dist/service/dynamodb/command/create-table/create-table.handler.d.ts

@@ -0,0 +1,20 @@
+import type { DynamoDbTableName } from "../../table/dynamodb-table.js";
+import { SimDynamoDbTable } from "../../table/dynamodb-table.js";
+import { type CreateTableCommand, type CreateTableCommandOutput } from "@aws-sdk/client-dynamodb";
+import type { BackgroundScheduler } from "../../../../util/background/background.js";
+import type { CommandHandler } from "../../../../command/command-handler.js";
+/**
+ * DynamoDB CreateTableCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/dynamodb/command/CreateTableCommand/
+ */
+export declare class CreateTableCommandHandler implements CommandHandler<CreateTableCommand, CreateTableCommandOutput> {
+    private readonly tables;
+    private readonly background;
+    constructor(tables: Map<DynamoDbTableName, SimDynamoDbTable>, background: BackgroundScheduler);
+    /**
+     * Handle creation of a new DynamoDB Table.
+     */
+    handle(cmd: CreateTableCommand): Promise<CreateTableCommandOutput>;
+}
+//# sourceMappingURL=create-table.handler.d.ts.map

package/dist/service/dynamodb/command/create-table/create-table.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-table.handler.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/create-table/create-table.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAE9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAG7E;;;;GAIG;AACH,qBAAa,yBAA0B,YAAW,cAAc,CAC9D,kBAAkB,EAClB,wBAAwB,CACzB;IAEG,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,EAChD,UAAU,EAAE,mBAAmB;IAGlD;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAgCzE"}

package/dist/service/dynamodb/command/create-table/create-table.handler.js

@@ -0,0 +1,47 @@
+import { SimDynamoDbTable } from "../../table/dynamodb-table.js";
+import { ResourceInUseException, } from "@aws-sdk/client-dynamodb";
+import { jitter } from "../../../../util/sleep.js";
+/**
+ * DynamoDB CreateTableCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/dynamodb/command/CreateTableCommand/
+ */
+export class CreateTableCommandHandler {
+    tables;
+    background;
+    constructor(tables, background) {
+        this.tables = tables;
+        this.background = background;
+    }
+    /**
+     * Handle creation of a new DynamoDB Table.
+     */
+    async handle(cmd) {
+        if (cmd.input.TableName === undefined) {
+            throw new Error("CreateTableCommand.input.TableName is required");
+        }
+        const tableName = cmd.input.TableName;
+        if (this.tables.has(tableName)) {
+            throw new ResourceInUseException({
+                message: `DynamoDB Table ${tableName} already exists`,
+                $metadata: {},
+            });
+        }
+        await jitter();
+        const table = new SimDynamoDbTable(cmd, this.background);
+        this.tables.set(tableName, table);
+        this.background.schedule(() => table.activate());
+        return {
+            TableDescription: {
+                AttributeDefinitions: [],
+                TableName: tableName,
+                KeySchema: [],
+                TableStatus: table.status,
+                CreationDateTime: table.creationDateTime,
+                GlobalSecondaryIndexes: [],
+            },
+            $metadata: {},
+        };
+    }
+}
+//# sourceMappingURL=create-table.handler.js.map

package/dist/service/dynamodb/command/create-table/create-table.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-table.handler.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/create-table/create-table.handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAGL,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD;;;;GAIG;AACH,MAAM,OAAO,yBAAyB;IAKjB;IACA;IAFnB,YACmB,MAAgD,EAChD,UAA+B;QAD/B,WAAM,GAAN,MAAM,CAA0C;QAChD,eAAU,GAAV,UAAU,CAAqB;IAC/C,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,GAAuB;QAClC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAA8B,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,sBAAsB,CAAC;gBAC/B,OAAO,EAAE,kBAAkB,SAAS,iBAAiB;gBACrD,SAAS,EAAE,EAAE;aACd,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,EAAE,CAAC;QAEf,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAElC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEjD,OAAO;YACL,gBAAgB,EAAE;gBAChB,oBAAoB,EAAE,EAAE;gBACxB,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,EAAE;gBACb,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,sBAAsB,EAAE,EAAE;aAC3B;YACD,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/service/dynamodb/command/describe-table/describe-table.handler.d.ts

@@ -0,0 +1,17 @@
+import { type DescribeTableCommand, type DescribeTableOutput } from "@aws-sdk/client-dynamodb";
+import type { CommandHandler } from "../../../../command/command-handler.js";
+import type { DynamoDbTableName, SimDynamoDbTable } from "../../table/dynamodb-table.js";
+/**
+ * DynamoDB DescribeTableCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/dynamodb/command/DescribeTableCommand/
+ */
+export declare class DescribeTableCommandHandler implements CommandHandler<DescribeTableCommand, DescribeTableOutput> {
+    private readonly tables;
+    constructor(tables: Map<DynamoDbTableName, SimDynamoDbTable>);
+    /**
+     * Simulate describing DynamoDB Table.
+     */
+    handle(cmd: DescribeTableCommand): Promise<DescribeTableOutput>;
+}
+//# sourceMappingURL=describe-table.handler.d.ts.map

package/dist/service/dynamodb/command/describe-table/describe-table.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-table.handler.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/describe-table/describe-table.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAGvC;;;;GAIG;AACH,qBAAa,2BAA4B,YAAW,cAAc,CAChE,oBAAoB,EACpB,mBAAmB,CACpB;IAEG,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAGnE;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAuBtE"}

package/dist/service/dynamodb/command/describe-table/describe-table.handler.js

@@ -0,0 +1,37 @@
+import { ResourceNotFoundException, } from "@aws-sdk/client-dynamodb";
+import { jitter } from "../../../../util/sleep.js";
+/**
+ * DynamoDB DescribeTableCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/dynamodb/command/DescribeTableCommand/
+ */
+export class DescribeTableCommandHandler {
+    tables;
+    constructor(tables) {
+        this.tables = tables;
+    }
+    /**
+     * Simulate describing DynamoDB Table.
+     */
+    async handle(cmd) {
+        if (cmd.input.TableName === undefined) {
+            throw new Error("DescribeTableCommand.input.TableName is required");
+        }
+        const tableName = cmd.input.TableName;
+        await jitter();
+        const table = this.tables.get(tableName);
+        if (table === undefined) {
+            throw new ResourceNotFoundException({
+                message: `No DynamoDB Table named ${tableName}`,
+                $metadata: {},
+            });
+        }
+        return {
+            Table: {
+                TableName: table.tableName,
+                TableStatus: table.status,
+            },
+        };
+    }
+}
+//# sourceMappingURL=describe-table.handler.js.map

package/dist/service/dynamodb/command/describe-table/describe-table.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-table.handler.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/describe-table/describe-table.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,GAG1B,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD;;;;GAIG;AACH,MAAM,OAAO,2BAA2B;IAKnB;IADnB,YACmB,MAAgD;QAAhD,WAAM,GAAN,MAAM,CAA0C;IAChE,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,GAAyB;QACpC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAA8B,CAAC;QAE3D,MAAM,MAAM,EAAE,CAAC;QAEf,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,yBAAyB,CAAC;gBAClC,OAAO,EAAE,2BAA2B,SAAS,EAAE;gBAC/C,SAAS,EAAE,EAAE;aACd,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,WAAW,EAAE,KAAK,CAAC,MAAM;aAC1B;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/service/dynamodb/command/list-tables/list-tables.handler.d.ts

@@ -0,0 +1,17 @@
+import type { CommandHandler } from "../../../../command/command-handler.js";
+import type { ListTablesCommand, ListTablesOutput } from "@aws-sdk/client-dynamodb";
+import type { DynamoDbTableName, SimDynamoDbTable } from "../../table/dynamodb-table.js";
+/**
+ * Simulated DynamoDB ListTablesCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/dynamodb/command/ListTablesCommand/
+ */
+export declare class ListTablesCommandHandler implements CommandHandler<ListTablesCommand, ListTablesOutput> {
+    private readonly tables;
+    constructor(tables: Map<DynamoDbTableName, SimDynamoDbTable>);
+    /**
+     * Simulate listing DynamoDB Tables.
+     */
+    handle(cmd: ListTablesCommand): Promise<ListTablesOutput>;
+}
+//# sourceMappingURL=list-tables.handler.d.ts.map

package/dist/service/dynamodb/command/list-tables/list-tables.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tables.handler.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/list-tables/list-tables.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAGvC;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,cAAc,CAC7D,iBAAiB,EACjB,gBAAgB,CACjB;IAEG,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAGnE;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAyBhE"}

package/dist/service/dynamodb/command/list-tables/list-tables.handler.js

@@ -0,0 +1,32 @@
+import { jitter } from "../../../../util/sleep.js";
+/**
+ * Simulated DynamoDB ListTablesCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/dynamodb/command/ListTablesCommand/
+ */
+export class ListTablesCommandHandler {
+    tables;
+    constructor(tables) {
+        this.tables = tables;
+    }
+    /**
+     * Simulate listing DynamoDB Tables.
+     */
+    async handle(cmd) {
+        await jitter();
+        const tables = [...this.tables.values()];
+        tables.sort((a, b) => a.tableName.localeCompare(b.tableName));
+        const exclusiveStartTableName = cmd.input.ExclusiveStartTableName;
+        const limit = cmd.input.Limit ?? 100;
+        const startIndex = exclusiveStartTableName === undefined
+            ? 0
+            : Math.max(0, tables.findIndex((t) => t.tableName === exclusiveStartTableName) +
+                1);
+        const page = tables.slice(startIndex, startIndex + limit);
+        return {
+            TableNames: page.map((table) => table.tableName),
+            LastEvaluatedTableName: page.at(-1)?.tableName,
+        };
+    }
+}
+//# sourceMappingURL=list-tables.handler.js.map

package/dist/service/dynamodb/command/list-tables/list-tables.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tables.handler.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/list-tables/list-tables.handler.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IAKhB;IADnB,YACmB,MAAgD;QAAhD,WAAM,GAAN,MAAM,CAA0C;IAChE,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,GAAsB;QACjC,MAAM,MAAM,EAAE,CAAC;QAEf,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAE9D,MAAM,uBAAuB,GAAG,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC;QAClE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC;QAErC,MAAM,UAAU,GACd,uBAAuB,KAAK,SAAS;YACnC,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,IAAI,CAAC,GAAG,CACN,CAAC,EACD,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,uBAAuB,CAAC;gBAC9D,CAAC,CACJ,CAAC;QAER,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;QAE1D,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;YAChD,sBAAsB,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS;SAC/C,CAAC;IACJ,CAAC;CACF"}

package/dist/service/dynamodb/command/put-item/put-item.handler.d.ts

@@ -0,0 +1,17 @@
+import type { CommandHandler } from "../../../../command/command-handler.js";
+import { type PutItemCommand, type PutItemCommandOutput } from "@aws-sdk/client-dynamodb";
+import type { DynamoDbTableName, SimDynamoDbTable } from "../../table/dynamodb-table.js";
+/**
+ * DynamoDB PutItemCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/dynamodb/command/PutItemCommand/
+ */
+export declare class PutItemCommandHandler implements CommandHandler<PutItemCommand, PutItemCommandOutput> {
+    private readonly tables;
+    constructor(tables: Map<DynamoDbTableName, SimDynamoDbTable>);
+    /**
+     * Put an Item into a DynamoDB Table.
+     */
+    handle(cmd: PutItemCommand): Promise<PutItemCommandOutput>;
+}
+//# sourceMappingURL=put-item.handler.d.ts.map

package/dist/service/dynamodb/command/put-item/put-item.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"put-item.handler.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/put-item/put-item.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAE1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAGvC;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,cAAc,CAC1D,cAAc,EACd,oBAAoB,CACrB;IAEG,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAGnE;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA2BjE"}

package/dist/service/dynamodb/command/put-item/put-item.handler.js

@@ -0,0 +1,39 @@
+import { ResourceNotFoundException, } from "@aws-sdk/client-dynamodb";
+import { DynamoDbItem } from "../../item/dynamodb-item.js";
+/**
+ * DynamoDB PutItemCommand handler.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/dynamodb/command/PutItemCommand/
+ */
+export class PutItemCommandHandler {
+    tables;
+    constructor(tables) {
+        this.tables = tables;
+    }
+    /**
+     * Put an Item into a DynamoDB Table.
+     */
+    async handle(cmd) {
+        const tableName = cmd.input.TableName;
+        if (tableName === undefined) {
+            throw new Error("PutItemCommand.input.TableName is required");
+        }
+        const table = this.tables.get(tableName);
+        if (table === undefined) {
+            throw new ResourceNotFoundException({
+                message: `No DynamoDB Table named ${tableName}`,
+                $metadata: {},
+            });
+        }
+        if (cmd.input.Item === undefined) {
+            throw new Error("PutItemCommand.input.Item is required");
+        }
+        const item = DynamoDbItem.fromAttributeValues(cmd.input.Item);
+        await table.putItem(item);
+        return {
+            Attributes: item.toAttributeValues(),
+            $metadata: {},
+        };
+    }
+}
+//# sourceMappingURL=put-item.handler.js.map

package/dist/service/dynamodb/command/put-item/put-item.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"put-item.handler.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/command/put-item/put-item.handler.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,OAAO,qBAAqB;IAKb;IADnB,YACmB,MAAgD;QAAhD,WAAM,GAAN,MAAM,CAA0C;IAChE,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,GAAmB;QAC9B,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAA0C,CAAC;QACvE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,yBAAyB,CAAC;gBAClC,OAAO,EAAE,2BAA2B,SAAS,EAAE;gBAC/C,SAAS,EAAE,EAAE;aACd,CAAC,CAAC;QACL,CAAC;QAED,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE9D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE1B,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE;YACpC,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/service/dynamodb/dynamodb.d.ts

@@ -0,0 +1,27 @@
+import type { CreateTableCommand, CreateTableOutput, DescribeTableCommand, DescribeTableOutput, ListTablesCommand, ListTablesOutput, PutItemCommand, PutItemCommandOutput } from "@aws-sdk/client-dynamodb";
+import type { BackgroundScheduler } from "../../util/background/background.js";
+/**
+ * Simulated DynamoDB. Handles SDK commands. Emulates AWS behaviour and state.
+ */
+export declare class SimDynamoDb {
+    private readonly background;
+    private readonly tables;
+    constructor(background: BackgroundScheduler);
+    /**
+     * Handle a Create Table Command from the SDK.
+     */
+    createTable(cmd: CreateTableCommand): Promise<CreateTableOutput>;
+    /**
+     * Handle a List Tables Command from the SDK.
+     */
+    listTables(cmd: ListTablesCommand): Promise<ListTablesOutput>;
+    /**
+     * Handle a Describe Table Command from the SDK.
+     */
+    describeTable(cmd: DescribeTableCommand): Promise<DescribeTableOutput>;
+    /**
+     * Handle a Put Item Command from the SDK.
+     */
+    putItem(cmd: PutItemCommand): Promise<PutItemCommandOutput>;
+}
+//# sourceMappingURL=dynamodb.d.ts.map

package/dist/service/dynamodb/dynamodb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb.d.ts","sourceRoot":"","sources":["../../../src/service/dynamodb/dynamodb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAK/E;;GAEG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,QAAQ,CAAC,UAAU;IAFvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;gBAE5C,UAAU,EAAE,mBAAmB;IAE5D;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKtE;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKnE;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAK5E;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAIlE"}

package/dist/service/dynamodb/dynamodb.js

@@ -0,0 +1,43 @@
+import { CreateTableCommandHandler } from "./command/create-table/create-table.handler.js";
+import { ListTablesCommandHandler } from "./command/list-tables/list-tables.handler.js";
+import { DescribeTableCommandHandler } from "./command/describe-table/describe-table.handler.js";
+import { PutItemCommandHandler } from "./command/put-item/put-item.handler.js";
+/**
+ * Simulated DynamoDB. Handles SDK commands. Emulates AWS behaviour and state.
+ */
+export class SimDynamoDb {
+    background;
+    tables = new Map();
+    constructor(background) {
+        this.background = background;
+    }
+    /**
+     * Handle a Create Table Command from the SDK.
+     */
+    async createTable(cmd) {
+        const handler = new CreateTableCommandHandler(this.tables, this.background);
+        return await handler.handle(cmd);
+    }
+    /**
+     * Handle a List Tables Command from the SDK.
+     */
+    async listTables(cmd) {
+        const handler = new ListTablesCommandHandler(this.tables);
+        return await handler.handle(cmd);
+    }
+    /**
+     * Handle a Describe Table Command from the SDK.
+     */
+    async describeTable(cmd) {
+        const handler = new DescribeTableCommandHandler(this.tables);
+        return await handler.handle(cmd);
+    }
+    /**
+     * Handle a Put Item Command from the SDK.
+     */
+    async putItem(cmd) {
+        const handler = new PutItemCommandHandler(this.tables);
+        return await handler.handle(cmd);
+    }
+}
+//# sourceMappingURL=dynamodb.js.map

package/dist/service/dynamodb/dynamodb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamodb.js","sourceRoot":"","sources":["../../../src/service/dynamodb/dynamodb.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAE3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E;;GAEG;AACH,MAAM,OAAO,WAAW;IAGO;IAFZ,MAAM,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEzE,YAA6B,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEhE;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,GAAuB;QACvC,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5E,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,GAAsB;QACrC,MAAM,OAAO,GAAG,IAAI,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,GAAyB;QAC3C,MAAM,OAAO,GAAG,IAAI,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7D,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,GAAmB;QAC/B,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/service/dynamodb/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/service/dynamodb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/service/dynamodb/index.ts"],"names":[],"mappings":""}

package/dist/service/dynamodb/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map