@kravc/dos-dynamodb 1.0.0-alpha.7 → 1.0.1

package/.github/workflows/ci.yaml

@@ -0,0 +1,26 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - run: npm ci
+
+      - run: npm test
+        env:
+          AWS_ACCESS_KEY_ID: local
+          AWS_SECRET_ACCESS_KEY: local
+          AWS_REGION: us-east-1

package/.github/workflows/publish.yaml

@@ -0,0 +1,32 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          registry-url: https://registry.npmjs.org
+
+      - run: npm ci
+
+      - run: npm test
+        env:
+          AWS_ACCESS_KEY_ID: local
+          AWS_SECRET_ACCESS_KEY: local
+          AWS_REGION: us-east-1
+
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/AGENTS.md

@@ -0,0 +1,14 @@
+# Agents
+
+## Commands
+
+- `npm run test` to run tests
+
+## Requirements
+
+- 100% code coverage is required
+
+## DynamoDB Local
+
+- **macOS**: requires [`apple/container`](https://github.com/apple/container) installed and `container system start` running
+- **Linux**: requires Docker

package/README.md

@@ -20,11 +20,62 @@ List supported DynamoDB table commands:
 npx table
 ```
 
+## Development
+
+Tests require DynamoDB Local to be running on port 8000.
+
+**macOS** — uses [apple/container](https://github.com/apple/container) (requires macOS 26+):
+
+Install `container` via Homebrew:
+
+```sh
+brew install apple/apple/container
+```
+
+Then start the service and run tests:
+
+```sh
+container system start
+npm test
+```
+
+To start the container service automatically at login:
+
+```sh
+cat > ~/Library/LaunchAgents/com.apple.container.start.plist << 'EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.apple.container.start</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/local/bin/container</string>
+    <string>system</string>
+    <string>start</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+</dict>
+</plist>
+EOF
+launchctl load ~/Library/LaunchAgents/com.apple.container.start.plist
+```
+
+**Linux** — uses Docker:
+
+```sh
+npm test
+```
+
+`npm run db:up` starts the container (skips if already running). `npm run db:down` stops and removes it.
+
 ## License
 
 ISC
 
 ---
 
-Revision: February 21, 2026<br/>
+Revision: March 23, 2026<br/>
 By: Oleksandr Kravets (@alexkravets)

package/bin/db-down.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const { execSync } = require('child_process');
+
+const CONTAINER_NAME = 'dynamo';
+
+const isMac = process.platform === 'darwin';
+
+if (isMac) {
+  execSync(`container stop ${CONTAINER_NAME}`, { stdio: 'inherit' });
+  execSync(`container rm ${CONTAINER_NAME}`, { stdio: 'inherit' });
+
+} else {
+  execSync(
+    'docker compose --project-name dos -f ./docker-compose.yaml down',
+    { stdio: 'inherit' }
+  );
+}

package/bin/db-up.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const http = require('http');
+const { execSync, spawnSync } = require('child_process');
+
+const CONTAINER_NAME = 'dynamo';
+const IMAGE = 'amazon/dynamodb-local:latest';
+const DYNAMO_PORT = 8000;
+
+const isMac = process.platform === 'darwin';
+
+/** Resolves true when DynamoDB Local is accepting connections, false on timeout. */
+const waitForDynamo = (timeout = 10000) => new Promise(resolve => {
+  const deadline = Date.now() + timeout;
+
+  const poll = () => {
+    const req = http.request({ hostname: 'localhost', port: DYNAMO_PORT, method: 'GET', path: '/' }, () => resolve(true));
+    req.on('error', () => {
+      if (Date.now() < deadline) setTimeout(poll, 100);
+      else resolve(false);
+    });
+    req.end();
+  };
+
+  poll();
+});
+
+const main = async () => {
+  if (isMac) {
+    const serviceCheck = spawnSync('container', ['system', 'status'], { encoding: 'utf8' });
+    const isServiceRunning = serviceCheck.stdout?.includes('running');
+
+    if (!isServiceRunning) {
+      console.error('Error: Apple container system service is not running.');
+      console.error('Start it with: container system start');
+      process.exit(1);
+    }
+
+    const result = spawnSync('container', ['inspect', CONTAINER_NAME], { encoding: 'utf8' });
+    const [info] = JSON.parse(result.stdout || '[]');
+
+    if (info) {
+      if (info.status === 'running') {
+        console.info(`Container "${CONTAINER_NAME}" is already running`);
+        return;
+      }
+
+      execSync(`container rm ${CONTAINER_NAME}`, { stdio: 'inherit' });
+    }
+
+    execSync(
+      `container run --detach --name ${CONTAINER_NAME} --publish 8000:8000 ${IMAGE}`,
+      { stdio: 'inherit' }
+    );
+
+  } else {
+    execSync(
+      'docker compose --project-name dos -f ./docker-compose.yaml up -d',
+      { stdio: 'inherit' }
+    );
+  }
+
+  const ready = await waitForDynamo();
+
+  if (!ready) {
+    console.error('Error: DynamoDB Local did not become ready in time.');
+    process.exit(1);
+  }
+};
+
+main();

package/dist/src/Table/helpers/getRawClientConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getRawClientConfig.d.ts","sourceRoot":"","sources":["../../../../src/Table/helpers/getRawClientConfig.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAQrE,8CAA8C;AAC9C,QAAA,MAAM,kBAAkB,GAAI,QAAQ,MAAM,EAAE,SAAS,MAAM,KAAG,oBAmB7D,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"getRawClientConfig.d.ts","sourceRoot":"","sources":["../../../../src/Table/helpers/getRawClientConfig.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAQrE,8CAA8C;AAC9C,QAAA,MAAM,kBAAkB,GAAI,QAAQ,MAAM,EAAE,SAAS,MAAM,KAAG,oBAiB7D,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/src/Table/helpers/getRawClientConfig.js

@@ -18,9 +18,9 @@ const getRawClientConfig = (region, profile) => {
     /* istanbul ignore else */
     if (isLocal) {
         config.endpoint = LOCAL_ENDPOINT;
+        config.credentials = { accessKeyId: 'local', secretAccessKey: 'local' };
     }
-    /* istanbul ignore else */
-    if (hasAwsCredentials) {
+    else if (hasAwsCredentials) {
         config.credentials = (0, credential_providers_1.fromIni)({ profile });
     }
     return config;

package/dist/src/Table/helpers/getRawClientConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"getRawClientConfig.js","sourceRoot":"","sources":["../../../../src/Table/helpers/getRawClientConfig.ts"],"names":[],"mappings":";;AAAA,2BAA6B;AAC7B,wEAAwD;AACxD,2BAAgC;AAChC,uDAAiD;AAGjD,MAAM,IAAI,GAAG,IAAA,YAAO,GAAE,CAAC;AACvB,MAAM,iBAAiB,GAAG,IAAA,eAAU,EAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;AAEjE,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAC7C,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,8CAA8C;AAC9C,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAE,OAAe,EAAwB,EAAE;IACnF,MAAM,MAAM,GAAG;QACb,WAAW,EAAE,oBAAoB;QACjC,MAAM;KACiB,CAAC;IAE1B,MAAM,OAAO,GAAG,MAAM,KAAK,8BAAY,CAAC;IAExC,0BAA0B;IAC1B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,QAAQ,GAAG,cAAc,CAAC;IACnC,CAAC;IAED,0BAA0B;IAC1B,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,CAAC,WAAW,GAAG,IAAA,8BAAO,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,kBAAe,kBAAkB,CAAC"}
+{"version":3,"file":"getRawClientConfig.js","sourceRoot":"","sources":["../../../../src/Table/helpers/getRawClientConfig.ts"],"names":[],"mappings":";;AAAA,2BAA6B;AAC7B,wEAAwD;AACxD,2BAAgC;AAChC,uDAAiD;AAGjD,MAAM,IAAI,GAAG,IAAA,YAAO,GAAE,CAAC;AACvB,MAAM,iBAAiB,GAAG,IAAA,eAAU,EAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;AAEjE,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAC7C,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,8CAA8C;AAC9C,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAE,OAAe,EAAwB,EAAE;IACnF,MAAM,MAAM,GAAG;QACb,WAAW,EAAE,oBAAoB;QACjC,MAAM;KACiB,CAAC;IAE1B,MAAM,OAAO,GAAG,MAAM,KAAK,8BAAY,CAAC;IAExC,0BAA0B;IAC1B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,QAAQ,GAAG,cAAc,CAAC;QACjC,MAAM,CAAC,WAAW,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC;IAC1E,CAAC;SAAM,IAAI,iBAAiB,EAAE,CAAC;QAC7B,MAAM,CAAC,WAAW,GAAG,IAAA,8BAAO,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,kBAAe,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kravc/dos-dynamodb",
-  "version": "1.0.0-alpha.7",
+  "version": "1.0.1",
   "description": "CRUD interface for DynamoDB table to be used with @kravc/dos service.",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -12,12 +12,13 @@
     "src": "src"
   },
   "scripts": {
-    "test": "eslint --fix src/ example/ && npm run db:up && sleep 2 && jest --coverage",
+    "test": "eslint --fix src/ example/ && npm run db:up && NODE_OPTIONS=--experimental-vm-modules jest --coverage",
     "prebuild": "rimraf dist",
     "build": "tsc",
     "prepare": "npm run build",
     "prepublishOnly": "npm run build",
-    "db:up": "docker compose --project-name dos -f ./docker-compose.yaml up -d"
+    "db:up": "node bin/db-up.js",
+    "db:down": "node bin/db-down.js"
   },
   "bin": {
     "table": "bin/table.js"

package/src/Document/__tests__/Document.test.ts

@@ -196,12 +196,12 @@ describe('Document', () => {
     beforeAll(async () => {
       await Asset.table.reset();
 
-      for (let i = 0; i < 600 + 15; i++) {
-        await createAsset({ name: `Text Document ${i + 1}` });
-      }
+      await Promise.all(
+        Array.from({ length: 600 + 15 }, (_, i) => createAsset({ name: `Text Document ${i + 1}` }))
+      );
 
       await createActivity();
-    });
+    }, 30000);
 
     describe('Document._indexAll(query, options)', () => {
       it('gets all documents from a table', async () => {

package/src/Table/helpers/getRawClientConfig.ts

@@ -22,10 +22,8 @@ const getRawClientConfig = (region: string, profile: string): DynamoDBClientConf
   /* istanbul ignore else */
   if (isLocal) {
     config.endpoint = LOCAL_ENDPOINT;
-  }
-
-  /* istanbul ignore else */
-  if (hasAwsCredentials) {
+    config.credentials = { accessKeyId: 'local', secretAccessKey: 'local' };
+  } else if (hasAwsCredentials) {
     config.credentials = fromIni({ profile });
   }