@kensio/yulin 0.0.2 → 0.1.1

package/dist/util/sleep.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Async sleep for an approximate number of milliseconds.
+ */
+export declare function sleep(ms?: number): Promise<void>;
+/**
+ * Sleep for a random but short length of time, e.g. to simulate asynchronous
+ * operations completing in a non-deterministic order.
+ */
+export declare function jitter(): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/util/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/util/sleep.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,KAAK,CAAC,EAAE,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjD;AAED;;;GAGG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5C"}

package/dist/util/sleep.js

@@ -0,0 +1,16 @@
+/**
+ * Async sleep for an approximate number of milliseconds.
+ */
+export async function sleep(ms = 0) {
+    await new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * Sleep for a random but short length of time, e.g. to simulate asynchronous
+ * operations completing in a non-deterministic order.
+ */
+export async function jitter() {
+    await sleep(Math.random());
+}
+//# sourceMappingURL=sleep.js.map

package/dist/util/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/util/sleep.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAE,GAAG,CAAC;IAChC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@kensio/yulin",
-  "version": "0.0.2",
+  "version": "0.1.1",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": "https://github.com/KensioSoftware/yulin",
   "type": "module",
-  "main": "index.js",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "keywords": [
     "aws",
     "test",
@@ -13,32 +14,49 @@
     "simulator",
     "isolated"
   ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cloudfront": {
+      "types": "./dist/service/cloudfront/index.d.ts",
+      "import": "./dist/service/cloudfront/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "author": "Kensio Software",
   "license": "AGPL-3.0",
   "devDependencies": {
-    "@aws-sdk/client-dynamodb": "^3.1001.0",
-    "@aws-sdk/client-s3": "^3.1001.0",
+    "@aws-sdk/client-dynamodb": "^3.1056.0",
+    "@aws-sdk/client-s3": "^3.1056.0",
     "@eslint/js": "^10.0.1",
-    "@kensio/smartass": "^0.1.4",
-    "@smithy/smithy-client": "^4.12.1",
-    "@smithy/types": "^4.13.0",
+    "@faker-js/faker": "^10.4.0",
+    "@kensio/smartass": "^1.0.0",
+    "@smithy/smithy-client": "^4.13.5",
+    "@smithy/types": "^4.14.2",
     "@types/eslint-plugin-security": "^3.0.1",
     "@types/lodash-es": "^4.17.12",
-    "@types/node": "^25.3.0",
-    "@vitest/coverage-v8": "4.0.18",
-    "@vitest/eslint-plugin": "^1.6.9",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
+    "@vitest/eslint-plugin": "^1.6.18",
     "aws-sdk-client-mock": "^4.1.0",
-    "eslint": "^10.0.1",
+    "eslint": "^10.4.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-jsdoc": "^62.7.1",
-    "eslint-plugin-no-secrets": "^2.2.2",
+    "eslint-plugin-jsdoc": "^62.9.0",
+    "eslint-plugin-no-secrets": "^2.3.3",
     "eslint-plugin-security": "^4.0.0",
     "eslint-plugin-unicorn": "^63.0.0",
-    "globals": "^17.3.0",
-    "jiti": "^2.6.1",
-    "prettier": "^3.8.1",
-    "typescript-eslint": "^8.56.0",
-    "vitest": "^4.0.18"
+    "globals": "^17.6.0",
+    "jiti": "^2.7.0",
+    "prettier": "^3.8.3",
+    "typescript-eslint": "^8.60.0",
+    "vitest": "^4.1.7"
   },
   "peerDependencies": {
     "@aws-sdk/client-dynamodb": "^3.1001.0",
@@ -57,7 +75,8 @@
     }
   },
   "dependencies": {
-    "lodash-es": "^4.17.23"
+    "@kensio/part-factory": "^0.1.1",
+    "lodash-es": "^4.18.1"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/.github/workflows/pr.yml

@@ -1,54 +0,0 @@
----
-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

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

package/.idea/inspectionProfiles/Project_Default.xml

@@ -1,6 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <profile version="1.0">
-    <option name="myName" value="Project Default" />
-    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
-  </profile>
-</component>

package/.idea/jsLinters/eslint.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="EslintConfiguration">
-    <option name="fix-on-save" value="true" />
-  </component>
-</project>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/yulin.iml" filepath="$PROJECT_DIR$/.idea/yulin.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/prettier.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="PrettierConfiguration">
-    <option name="myConfigurationMode" value="AUTOMATIC" />
-    <option name="myRunOnSave" value="true" />
-  </component>
-</project>

package/.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="" vcs="Git" />
-  </component>
-</project>

package/.idea/yulin.iml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="WEB_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$" />
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>

package/.nvmrc

@@ -1 +0,0 @@
-v24.14.0

package/.prettierrc

@@ -1,4 +0,0 @@
-{
-  "trailingComma": "all",
-  "tabWidth": 2
-}

package/eslint.config.ts

@@ -1,208 +0,0 @@
-import { dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-
-import eslint from "@eslint/js";
-import vitest from "@vitest/eslint-plugin";
-import { defineConfig } from "eslint/config";
-import prettier from "eslint-config-prettier";
-import { jsdoc } from "eslint-plugin-jsdoc";
-import noSecrets from "eslint-plugin-no-secrets";
-import security from "eslint-plugin-security";
-import unicorn from "eslint-plugin-unicorn";
-import globals from "globals";
-import tseslint from "typescript-eslint";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-export default defineConfig(
-  // ── Global ignores ──────────────────────────────────────
-  {
-    ignores: ["dist/", "**/.coverage/*", "node_modules/", "*.config.ts"],
-  },
-
-  // ── Base ESLint recommended ─────────────────────────────
-  eslint.configs.recommended,
-
-  // ── TypeScript (strictest level + type-aware) ───────────
-  ...tseslint.configs.strictTypeChecked,
-  ...tseslint.configs.stylisticTypeChecked,
-
-  // ── General settings for all TS files ───────────────────
-  {
-    languageOptions: {
-      ecmaVersion: "latest",
-      sourceType: "module",
-      globals: {
-        ...globals.node,
-      },
-      parserOptions: {
-        projectService: true,
-        tsconfigRootDir: __dirname,
-      },
-    },
-    rules: {
-      // ── TypeScript overrides & additions ──────────────
-      "@typescript-eslint/explicit-function-return-type": "error",
-      "@typescript-eslint/explicit-module-boundary-types": "error",
-      "@typescript-eslint/no-explicit-any": "error",
-      "@typescript-eslint/consistent-type-imports": [
-        "error",
-        { prefer: "type-imports", fixStyle: "inline-type-imports" },
-      ],
-      "@typescript-eslint/consistent-type-exports": [
-        "error",
-        { fixMixedExportsWithInlineTypeSpecifier: true },
-      ],
-      "@typescript-eslint/no-import-type-side-effects": "error",
-      "@typescript-eslint/switch-exhaustiveness-check": "error",
-      "@typescript-eslint/no-unnecessary-condition": "error",
-      "@typescript-eslint/prefer-nullish-coalescing": "error",
-      "@typescript-eslint/strict-boolean-expressions": "error",
-      "no-await-in-loop": "error", // catches sequential awaits that should be Promise.all()
-      "no-template-curly-in-string": "error", // catches '${name}' in regular strings (missing backticks)
-      "no-promise-executor-return": "error", // catches accidental return in new Promise((resolve) => return ...)
-      "no-unreachable-loop": "error", // catches loops that only ever run once
-      "no-param-reassign": "error", // prevents mutating function parameters (major bug source)
-      "prefer-const": "error", // const over let when never reassigned
-      "object-shorthand": ["error", "always"], // { foo: foo } → { foo }
-      "prefer-template": "error", // template literals over string concatenation
-      "@typescript-eslint/prefer-readonly": "error", // flags private fields that are never reassigned
-      "@typescript-eslint/require-array-sort-compare": "error", // prevents [1, 10, 2].sort() (lexicographic surprise)
-      "@typescript-eslint/naming-convention": [
-        "error",
-        {
-          selector: ["property", "objectLiteralProperty", "typeProperty"],
-          format: ["camelCase", "PascalCase"],
-          leadingUnderscore: "allow",
-        },
-        {
-          selector: "default",
-          format: ["camelCase"],
-          leadingUnderscore: "allow",
-        },
-        {
-          selector: "typeLike",
-          format: ["PascalCase"],
-        },
-        {
-          selector: "enumMember",
-          format: ["PascalCase"],
-        },
-        {
-          selector: "variable",
-          modifiers: ["const", "exported"],
-          format: ["camelCase", "UPPER_CASE"],
-        },
-      ],
-
-      // ── General quality ──────────────────────────────
-      "no-console": "warn",
-      eqeqeq: ["error", "always"],
-      curly: ["error", "all"],
-      "@typescript-eslint/only-throw-error": "error",
-    },
-  },
-
-  // ── Security (low cost security checks) ────────────────
-  // TODO: Remove cast when eslint-plugin-security fixes defineConfig() types
-  // https://github.com/eslint-community/eslint-plugin-security/issues/175
-  security.configs.recommended as any,
-
-  // ── Unicorn (modern JS best practices) ──────────────────
-  // https://github.com/sindresorhus/eslint-plugin-unicorn?tab=readme-ov-file#recommended-config
-  unicorn.configs.recommended,
-  {
-    rules: {
-      "unicorn/better-regex": "warn",
-      "unicorn/prevent-abbreviations": "off",
-    },
-  },
-
-  // ── Vitest (test files only) ────────────────────────────
-  {
-    files: ["**/*.test.ts"],
-    plugins: {
-      vitest,
-    },
-    rules: {
-      ...vitest.configs.recommended.rules,
-      "vitest/consistent-test-it": ["error", { fn: "it" }],
-      "vitest/no-focused-tests": "error",
-      "vitest/no-disabled-tests": "warn",
-      "vitest/no-duplicate-hooks": "error",
-      "vitest/prefer-to-be": "error",
-      "vitest/prefer-to-have-length": "error",
-      "vitest/prefer-strict-equal": "error",
-      "vitest/require-top-level-describe": "error",
-      "vitest/expect-expect": "off",
-
-      // Relax some rules that are too strict for test files
-      "@typescript-eslint/no-explicit-any": "off",
-      "@typescript-eslint/no-unsafe-assignment": "off",
-      "@typescript-eslint/no-unsafe-member-access": "off",
-      "@typescript-eslint/explicit-function-return-type": "off",
-      "import-x/no-default-export": "off",
-    },
-  },
-
-  // ── Config files (allow default exports) ────────────────
-  {
-    files: ["*.config.ts", "*.config.js"],
-    rules: {
-      "import-x/no-default-export": "off",
-    },
-  },
-
-  // ── No Secrets (detect accidental secret inclusion) ────────
-  {
-    plugins: { "no-secrets": noSecrets },
-    rules: {
-      "no-secrets/no-secrets": "error",
-    },
-  },
-
-  // ── JSDoc (enforce minimal doc commenting) ────────────────
-  jsdoc({
-    config: "flat/recommended-error",
-  }),
-  {
-    rules: {
-      "jsdoc/require-param": "off",
-      "jsdoc/require-returns": "off",
-      "jsdoc/require-param-description": "off",
-      "jsdoc/require-returns-description": "off",
-      "jsdoc/require-yields": "off",
-      "jsdoc/require-description": [
-        "error",
-        {
-          descriptionStyle: "body",
-          checkConstructors: false,
-          checkGetters: false,
-          checkSetters: false,
-        },
-      ],
-      "jsdoc/require-jsdoc": [
-        "error",
-        {
-          contexts: [
-            "ClassDeclaration",
-            "ExportNamedDeclaration > VariableDeclaration[kind='const'] > VariableDeclarator[init.type='ObjectExpression']",
-            "ExportNamedDeclaration > VariableDeclaration[kind='const'] > VariableDeclarator[init.type='ArrayExpression']",
-            "ExportNamedDeclaration > VariableDeclaration[kind='const'] > VariableDeclarator[init.type='NewExpression']",
-            "ExportNamedDeclaration > VariableDeclaration[kind='const'] > VariableDeclarator[init.type='CallExpression']",
-          ],
-          publicOnly: true,
-          checkConstructors: false,
-          require: {
-            FunctionDeclaration: true,
-            MethodDefinition: true,
-            ClassDeclaration: true,
-          },
-        },
-      ],
-    },
-  },
-
-  // ── Prettier (must be last — disables conflicting rules)
-  prettier,
-);

package/pnpm-workspace.yaml

@@ -1 +0,0 @@
-useNodeVersion: 24.13.1

package/src/command/command-handler.ts

@@ -1,3 +0,0 @@
-export interface CommandHandler<TCommand, TOutput> {
-  handle(cmd: TCommand): Promise<TOutput>;
-}

package/src/service/dynamodb/command/create-table/create-table.handler.ts

@@ -1,59 +0,0 @@
-import type { DynamoDbTableName } from "../../dynamodb-table.js";
-import { SimDynamoDbTable } from "../../dynamodb-table.js";
-import {
-  type CreateTableCommand,
-  type CreateTableCommandOutput,
-  ResourceInUseException,
-} from "@aws-sdk/client-dynamodb";
-import type { BackgroundScheduler } from "../../../../util/background/background.js";
-import type { CommandHandler } from "../../../../command/command-handler.js";
-import { jitter } from "../../../../util/sleep.js";
-
-/**
- * DynamoDB CreateTableCommand handler.
- */
-export class CreateTableCommandHandler implements CommandHandler<
-  CreateTableCommand,
-  CreateTableCommandOutput
-> {
-  constructor(
-    private readonly tables: Map<DynamoDbTableName, SimDynamoDbTable>,
-    private readonly background: BackgroundScheduler,
-  ) {}
-
-  /**
-   * Handle creation of a new DynamoDB Table.
-   */
-  async handle(cmd: CreateTableCommand): Promise<CreateTableCommandOutput> {
-    if (cmd.input.TableName === undefined) {
-      throw new Error("CreateTableCommand.input.TableName is required");
-    }
-
-    const tableName = cmd.input.TableName as DynamoDbTableName;
-    if (this.tables.has(tableName)) {
-      throw new ResourceInUseException({
-        message: `DynamoDB Table ${tableName} already exists`,
-        $metadata: {},
-      });
-    }
-
-    await jitter();
-
-    const table = new SimDynamoDbTable(cmd);
-    this.tables.set(tableName, table);
-
-    this.background.schedule(() => table.activate());
-
-    return {
-      TableDescription: {
-        AttributeDefinitions: [],
-        TableName: tableName,
-        KeySchema: [],
-        TableStatus: table.status,
-        CreationDateTime: table.creationDateTime,
-        GlobalSecondaryIndexes: [],
-      },
-      $metadata: {},
-    };
-  }
-}

package/src/service/dynamodb/command/create-table/create-table.iso.test.ts

@@ -1,67 +0,0 @@
-import { describe, it } from "vitest";
-import {
-  CreateTableCommand,
-  ListTablesCommand,
-  ResourceInUseException,
-} from "@aws-sdk/client-dynamodb";
-import { SimAwsAccount } from "../../../organizations/sim-aws-account.js";
-import {
-  assertArrayLength,
-  assertIdentical,
-  assertInstanceOf,
-  assertNonNullable,
-  assertThrowsErrorAsync,
-} from "@kensio/smartass";
-
-describe("DynamoDB CreateTableCommand", () => {
-  it("creates new DynamoDB Table", async () => {
-    const simAccount = new SimAwsAccount();
-    const simDynamoDb = simAccount.getDynamoDb();
-
-    const createTableOutput = await simDynamoDb.createTable(
-      new CreateTableCommand({ TableName: "FoobarTable" }),
-    );
-
-    assertNonNullable(createTableOutput.TableDescription);
-    assertIdentical(
-      createTableOutput.TableDescription.TableName,
-      "FoobarTable",
-    );
-    assertIdentical(createTableOutput.TableDescription.TableStatus, "CREATING");
-
-    const listTablesOutput = await simDynamoDb.listTables(
-      new ListTablesCommand(),
-    );
-
-    assertArrayLength(listTablesOutput.TableNames, 1);
-    assertIdentical(listTablesOutput.TableNames[0], "FoobarTable");
-
-    await simAccount.backgroundTasksComplete();
-  });
-
-  it("throws on undefined Table name", async () => {
-    const simAccount = new SimAwsAccount();
-    const simDynamoDb = simAccount.getDynamoDb();
-
-    await assertThrowsErrorAsync(async () =>
-      simDynamoDb.createTable(new CreateTableCommand({ TableName: undefined })),
-    );
-  });
-
-  it("throws on duplicate Table name", async () => {
-    const simAccount = new SimAwsAccount();
-    const simDynamoDb = simAccount.getDynamoDb();
-
-    await simDynamoDb.createTable(
-      new CreateTableCommand({ TableName: "FoobarTable" }),
-    );
-
-    const error = await assertThrowsErrorAsync(async () =>
-      simDynamoDb.createTable(
-        new CreateTableCommand({ TableName: "FoobarTable" }),
-      ),
-    );
-    assertInstanceOf(error, ResourceInUseException);
-    assertIdentical(error.$fault, "client");
-  });
-});

package/src/service/dynamodb/command/describe-table/describe-table.handler.ts

@@ -1,50 +0,0 @@
-import {
-  ResourceNotFoundException,
-  type DescribeTableCommand,
-  type DescribeTableOutput,
-} from "@aws-sdk/client-dynamodb";
-import type { CommandHandler } from "../../../../command/command-handler.js";
-import type {
-  DynamoDbTableName,
-  SimDynamoDbTable,
-} from "../../dynamodb-table.js";
-import { jitter } from "../../../../util/sleep.js";
-
-/**
- * DynamoDB DescribeTableCommand handler.
- */
-export class DescribeTableCommandHandler implements CommandHandler<
-  DescribeTableCommand,
-  DescribeTableOutput
-> {
-  constructor(
-    private readonly tables: Map<DynamoDbTableName, SimDynamoDbTable>,
-  ) {}
-
-  /**
-   * Simulate describing DynamoDB Table.
-   */
-  async handle(cmd: DescribeTableCommand): Promise<DescribeTableOutput> {
-    if (cmd.input.TableName === undefined) {
-      throw new Error("DescribeTableCommand.input.TableName is required");
-    }
-    const tableName = cmd.input.TableName as DynamoDbTableName;
-
-    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,
-      },
-    };
-  }
-}