Install & Host Integration

Install the get-dotenv host (optional peer) and wire the DynamoDB plugin.

npm i -D @karmaniverous/get-dotenv
Copy

Create a host CLI

// mycli.ts
import { createCli } from '@karmaniverous/get-dotenv';
import { awsPlugin } from '@karmaniverous/get-dotenv/plugins';
import { dynamodbPlugin } from '@karmaniverous/entity-client-dynamodb/get-dotenv';

const run = createCli({
  alias: 'mycli',
  compose: (p) => p.use(awsPlugin().use(dynamodbPlugin())),
});

await run(process.argv.slice(2));
Copy

Notes

• The expected composition is as a child of the shipped aws plugin, so commands live under the aws dynamodb path.
• Plugin config is keyed by realized mount path; when nested under aws, the config key is "aws/dynamodb" (not "dynamodb").

Minimal config (getdotenv.config.json; aws parent)

{
  "plugins": {
    "aws/dynamodb": {
      "tablesPath": "./tables",
      "tokens": {
        "table": "table",
        "entityManager": "entityManager",
        "transform": "transform"
      }
    }
  }
}
Copy

Next

• See Versioned layout and tokens for the files under tables/NNN.
• See Table lifecycle for generate/validate/create/delete/purge flows.
• See Data migration for step discovery, transforms, and progress.