Dynamodb Toolbox Patterns

# Context7 References: DynamoDB-Toolbox v2

Curated documentation links retrieved via Context7 for this skill.

## Core

- Context7 LLM reference: https://context7.com/dynamodb-toolbox/dynamodb-toolbox/llms.txt
- Getting started overview: https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/1-getting-started/1-overview/index.md
- KV store example (`.build()` workflow): https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/1-getting-started/4-examples/1-kv-store.md

## Table and Entity usage

- Table `.build()` usage: https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/2-tables/1-usage/index.md
- Query action docs: https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/2-tables/2-actions/2-query/index.md
- Scan action docs: https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/2-tables/2-actions/1-scan/index.md
- Scans and queries example: https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/1-getting-started/4-examples/2-scans-and-queries.md

## Schema modeling

- Schema usage (`item`, `string`, `number`, etc.): https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/4-schemas/1-usage/index.md
- Schema parse/actions and advanced modifiers (`key`, `default`, `required`, `transform`, `link`): https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/4-schemas/17-actions/1-parse.md

## Commands and operations

- `GetItemCommand` docs: https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/3-entities/4-actions/1-get-item/index.md
- Batch write table action: https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/2-tables/2-actions/7-batch-write/index.md
- Transaction patterns: https://github.com/dynamodb-toolbox/dynamodb-toolbox/blob/main/docs/docs/3-entities/4-actions/11-transactions/index.md

## Single-table design

- Access patterns and computed keys example (Context7): https://context7.com/dynamodb-toolbox/dynamodb-toolbox/llms.txt


---
name: dynamodb-toolbox-patterns
description: Provides TypeScript patterns for DynamoDB-Toolbox v2 including schema/table/entity modeling, .build() command workflow, query/scan access patterns, batch and transaction operations, and single-table design with computed keys. Use when implementing type-safe DynamoDB access layers with DynamoDB-Toolbox v2 in TypeScript services or serverless applications.
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
---

# DynamoDB-Toolbox v2 Patterns (TypeScript)

## Overview

This skill provides practical TypeScript patterns for using DynamoDB-Toolbox v2 with AWS SDK v3 DocumentClient. It focuses on type-safe schema modeling, `.build()` command usage, and production-ready single-table design.

## When to Use

- Defining DynamoDB tables and entities with strict TypeScript inference
- Modeling schemas with `item`, `string`, `number`, `list`, `set`, `map`, and `record`
- Implementing `GetItem`, `PutItem`, `UpdateItem`, `DeleteItem` via `.build()`
- Building query and scan access paths with primary keys and GSIs
- Handling batch and transactional operations
- Designing single-table systems with computed keys and entity patterns

## Instructions

1. **Start from access patterns**: identify read/write queries first, then design keys.
2. **Create table + entity boundaries**: one table, multiple entities if using single-table design.
3. **Define schemas with constraints**: apply `.key()`, `.required()`, `.default()`, `.transform()`, `.link()`.
4. **Use `.build()` commands everywhere**: avoid ad-hoc command construction for consistency and type safety.
5. **Add query/index coverage**: validate GSI/LSI paths for each required access pattern.
6. **Use batch/transactions intentionally**: batch for throughput, transactions for atomicity.
7. **Keep items evolvable**: use optional fields, defaults, and derived attributes for schema evolution.

## Examples

### Install and Setup

```bash
npm in