effect-dynamodb 0.1.0

package/dist/Query.js

@@ -0,0 +1,397 @@
+/**
+ * Query — Pure description of a DynamoDB query.
+ *
+ * `Query<A>` is a lazy, immutable data type that describes a query. No DynamoDB
+ * calls happen until a terminal (`execute`, `collect`, or `paginate`) is called. All
+ * combinators return a new Query — the original is unchanged.
+ *
+ * Implements Pipeable for ergonomic composition.
+ */
+import { Effect, Function, Option, Pipeable, Stream } from "effect";
+import { DynamoClient } from "./DynamoClient.js";
+import { compileExpr } from "./internal/Expr.js";
+import { compilePath } from "./internal/PathBuilder.js";
+import { fromAttributeMap, toAttributeValue } from "./Marshaller.js";
+import * as Projection from "./Projection.js";
+// ---------------------------------------------------------------------------
+// Query<A> interface
+// ---------------------------------------------------------------------------
+const QueryTypeId = Symbol.for("effect-dynamodb/Query");
+// ---------------------------------------------------------------------------
+// Internal: Query implementation
+// ---------------------------------------------------------------------------
+class QueryImpl {
+    _state;
+    [QueryTypeId] = QueryTypeId;
+    constructor(_state) {
+        this._state = _state;
+    }
+    pipe() {
+        // eslint-disable-next-line prefer-rest-params
+        return Pipeable.pipeArguments(this, arguments);
+    }
+}
+// ---------------------------------------------------------------------------
+// Constructor (internal — used by Entity and Collection)
+// ---------------------------------------------------------------------------
+export const make = (config) => new QueryImpl({
+    tableName: config.tableName,
+    indexName: config.indexName,
+    pkField: config.pkField,
+    pkValue: config.pkValue,
+    skField: config.skField,
+    skConditions: [],
+    exprFilters: [],
+    entityTypes: config.entityTypes,
+    limitValue: undefined,
+    maxPagesValue: undefined,
+    scanForward: true,
+    consistentRead: false,
+    ignoreOwnershipFlag: false,
+    exclusiveStartKey: undefined,
+    isScan: false,
+    projection: undefined,
+    projectionPaths: undefined,
+    decoder: config.decoder,
+    resolveTableName: config.resolveTableName,
+});
+/**
+ * Create a scan-mode Query. Shares all combinators and terminals with Query
+ * but uses DynamoDB Scan instead of Query at execution time.
+ * No key condition — only filter expressions and entity type filter.
+ */
+export const makeScan = (config) => new QueryImpl({
+    tableName: config.tableName,
+    indexName: config.indexName,
+    pkField: "",
+    pkValue: "",
+    skField: undefined,
+    skConditions: [],
+    exprFilters: [],
+    entityTypes: config.entityTypes,
+    limitValue: undefined,
+    maxPagesValue: undefined,
+    scanForward: true,
+    consistentRead: false,
+    ignoreOwnershipFlag: false,
+    exclusiveStartKey: undefined,
+    isScan: true,
+    projection: undefined,
+    projectionPaths: undefined,
+    decoder: config.decoder,
+    resolveTableName: config.resolveTableName,
+});
+// ---------------------------------------------------------------------------
+// Cursor encoding (internal)
+// ---------------------------------------------------------------------------
+const encodeCursor = (key) => btoa(JSON.stringify(key));
+const decodeCursor = (cursor) => JSON.parse(atob(cursor));
+// ---------------------------------------------------------------------------
+// Combinators (all dual for data-first and data-last)
+// ---------------------------------------------------------------------------
+/**
+ * Add a sort key condition to the query.
+ * Only one SK condition is supported (last one wins if multiple are added).
+ */
+export const where = Function.dual(2, (self, condition) => {
+    const state = self._state;
+    if (!state.skField)
+        return self;
+    return new QueryImpl({
+        ...state,
+        skConditions: [{ field: state.skField, condition }],
+    });
+});
+/**
+ * Set the maximum number of items per DynamoDB page.
+ */
+export const limit = Function.dual(2, (self, n) => new QueryImpl({
+    ...self._state,
+    limitValue: n,
+}));
+/**
+ * Reverse the sort order (sets ScanIndexForward = false).
+ */
+export const reverse = (self) => new QueryImpl({
+    ...self._state,
+    scanForward: false,
+});
+/**
+ * Enable consistent reads for this query (or scan).
+ */
+export const consistentRead = Function.dual((args) => isQuery(args[0]), (self) => new QueryImpl({
+    ...self._state,
+    consistentRead: true,
+}));
+/**
+ * Set the maximum number of DynamoDB pages to fetch.
+ * Pagination stops after this many pages even if `LastEvaluatedKey` is present.
+ */
+export const maxPages = Function.dual(2, (self, n) => new QueryImpl({
+    ...self._state,
+    maxPagesValue: n,
+}));
+/**
+ * Skip the `__edd_e__` entity type filter on this query.
+ * Useful for cross-entity queries or when you know the partition only contains
+ * items of the expected type.
+ */
+export const ignoreOwnership = (self) => new QueryImpl({
+    ...self._state,
+    ignoreOwnershipFlag: true,
+});
+/**
+ * Set the starting cursor for pagination. The cursor is an opaque string
+ * returned by {@link execute} that encodes the DynamoDB `ExclusiveStartKey`.
+ * Pass an empty string to start from the beginning.
+ */
+export const startFrom = Function.dual(2, (self, cursor) => cursor === ""
+    ? self
+    : new QueryImpl({
+        ...self._state,
+        exclusiveStartKey: decodeCursor(cursor),
+    }));
+/**
+ * Select specific attributes to return (ProjectionExpression).
+ * Reduces read capacity and network transfer. When projection is active,
+ * items are returned as raw `Record<string, unknown>` instead of decoded
+ * schema instances, since projected items may be partial.
+ */
+export const select = Function.dual(2, (self, attributes) => new QueryImpl({
+    ...self._state,
+    projection: attributes,
+    decoder: (raw) => Effect.succeed(raw),
+}));
+/**
+ * Add an Expr-based filter expression to the query.
+ * Multiple filterExpr calls are ANDed together.
+ */
+export const filterExpr = Function.dual(2, (self, expr) => new QueryImpl({
+    ...self._state,
+    exprFilters: [...self._state.exprFilters, expr],
+}));
+/**
+ * Apply path-based projections. Compiles path segments to ProjectionExpression.
+ * When projection is active, items are returned as raw `Record<string, unknown>`.
+ */
+export const selectPaths = Function.dual(2, (self, paths) => new QueryImpl({
+    ...self._state,
+    projectionPaths: paths,
+    decoder: (raw) => Effect.succeed(raw),
+}));
+// ---------------------------------------------------------------------------
+// Internal: shared filter clause builder (entity type + user filters)
+// ---------------------------------------------------------------------------
+const buildFilterClauses = (state) => {
+    const names = {};
+    const values = {};
+    const filterClauses = [];
+    // Entity type filter (skipped when ignoreOwnership is set)
+    if (!state.ignoreOwnershipFlag && state.entityTypes.length > 0) {
+        const etPlaceholders = state.entityTypes.map((_, i) => `:et${i}`);
+        filterClauses.push(`#eddE IN (${etPlaceholders.join(", ")})`);
+        names["#eddE"] = "__edd_e__";
+        state.entityTypes.forEach((et, i) => {
+            values[`:et${i}`] = toAttributeValue(et);
+        });
+    }
+    // Expr-based filters (compiled from Entity.filter() callback/shorthand API)
+    for (const expr of state.exprFilters) {
+        const compiled = compileExpr(expr);
+        filterClauses.push(compiled.expression);
+        Object.assign(names, compiled.names);
+        Object.assign(values, compiled.values);
+    }
+    return { filterClauses, names, values };
+};
+// ---------------------------------------------------------------------------
+// Internal: build projection expression from state
+// ---------------------------------------------------------------------------
+const buildProjection = (state, names) => {
+    if (state.projectionPaths && state.projectionPaths.length > 0) {
+        const counter = { value: 0 };
+        const projParts = [];
+        for (const segments of state.projectionPaths) {
+            projParts.push(compilePath(segments, names, "proj", counter));
+        }
+        return projParts.join(", ");
+    }
+    if (state.projection && state.projection.length > 0) {
+        const proj = Projection.projection(state.projection);
+        Object.assign(names, proj.names);
+        return proj.expression;
+    }
+    return undefined;
+};
+const buildCommandInput = (state) => {
+    const fc = buildFilterClauses(state);
+    const names = { ...fc.names };
+    const values = { ...fc.values };
+    let keyCondition;
+    // Key condition (query mode only)
+    if (!state.isScan) {
+        names["#pk"] = state.pkField;
+        values[":pk"] = toAttributeValue(state.pkValue);
+        keyCondition = "#pk = :pk";
+        if (state.skConditions.length > 0) {
+            const skCond = state.skConditions[0];
+            names["#sk"] = skCond.field;
+            const cond = skCond.condition;
+            if ("eq" in cond) {
+                keyCondition += " AND #sk = :sk";
+                values[":sk"] = toAttributeValue(cond.eq);
+            }
+            else if ("lt" in cond) {
+                keyCondition += " AND #sk < :sk";
+                values[":sk"] = toAttributeValue(cond.lt);
+            }
+            else if ("lte" in cond) {
+                keyCondition += " AND #sk <= :sk";
+                values[":sk"] = toAttributeValue(cond.lte);
+            }
+            else if ("gt" in cond) {
+                keyCondition += " AND #sk > :sk";
+                values[":sk"] = toAttributeValue(cond.gt);
+            }
+            else if ("gte" in cond) {
+                keyCondition += " AND #sk >= :sk";
+                values[":sk"] = toAttributeValue(cond.gte);
+            }
+            else if ("between" in cond) {
+                keyCondition += " AND #sk BETWEEN :sk1 AND :sk2";
+                values[":sk1"] = toAttributeValue(cond.between[0]);
+                values[":sk2"] = toAttributeValue(cond.between[1]);
+            }
+            else if ("beginsWith" in cond) {
+                keyCondition += " AND begins_with(#sk, :sk)";
+                values[":sk"] = toAttributeValue(cond.beginsWith);
+            }
+        }
+    }
+    const projectionExpression = buildProjection(state, names);
+    return {
+        KeyConditionExpression: keyCondition,
+        FilterExpression: fc.filterClauses.length > 0 ? fc.filterClauses.join(" AND ") : undefined,
+        ProjectionExpression: projectionExpression,
+        ExpressionAttributeNames: Object.keys(names).length > 0 ? names : undefined,
+        ExpressionAttributeValues: Object.keys(values).length > 0 ? values : undefined,
+        ConsistentRead: state.consistentRead || undefined,
+    };
+};
+/**
+ * @internal Build the full DynamoDB command parameters from state and table name.
+ */
+const buildDynamoCommand = (state, tableName, overrides) => {
+    const input = buildCommandInput(state);
+    return {
+        TableName: tableName,
+        IndexName: state.indexName,
+        KeyConditionExpression: input.KeyConditionExpression,
+        FilterExpression: input.FilterExpression,
+        ProjectionExpression: input.ProjectionExpression,
+        ExpressionAttributeNames: input.ExpressionAttributeNames,
+        ExpressionAttributeValues: input.ExpressionAttributeValues,
+        ConsistentRead: input.ConsistentRead,
+        Limit: state.limitValue,
+        ScanIndexForward: state.isScan ? undefined : state.scanForward,
+        ...overrides,
+    };
+};
+// ---------------------------------------------------------------------------
+// Terminals
+// ---------------------------------------------------------------------------
+/**
+ * Execute the query and collect all pages into a single array.
+ */
+export const collect = (self) => Effect.gen(function* () {
+    const stream = yield* paginateInternal(self);
+    const pages = yield* Stream.runCollect(stream);
+    return pages.flat();
+});
+/**
+ * Execute a single DynamoDB page and return a {@link Page} with an opaque cursor.
+ * Combine with {@link startFrom} to iterate through pages:
+ *
+ * ```ts
+ * const first = yield* query.pipe(Query.limit(25), Query.execute)
+ * if (first.cursor) {
+ *   const second = yield* query.pipe(Query.limit(25), Query.startFrom(first.cursor), Query.execute)
+ * }
+ * ```
+ */
+export const execute = (self) => Effect.gen(function* () {
+    const client = yield* DynamoClient;
+    const state = self._state;
+    const tableName = state.resolveTableName ? yield* state.resolveTableName : state.tableName;
+    const cmd = buildDynamoCommand(state, tableName, {
+        ExclusiveStartKey: state.exclusiveStartKey,
+    });
+    const result = state.isScan ? yield* client.scan(cmd) : yield* client.query(cmd);
+    const rawItems = (result.Items ?? []).map((item) => fromAttributeMap(item));
+    const items = yield* Effect.forEach(rawItems, (raw) => state.decoder(raw));
+    const cursor = result.LastEvaluatedKey != null
+        ? encodeCursor(result.LastEvaluatedKey)
+        : null;
+    return { items, cursor };
+});
+/**
+ * Execute the query and return a Stream of page arrays.
+ */
+export const paginate = (self) => paginateInternal(self);
+const paginateInternal = (self) => Effect.gen(function* () {
+    const client = yield* DynamoClient;
+    const state = self._state;
+    const tableName = state.resolveTableName ? yield* state.resolveTableName : state.tableName;
+    let pageCount = 0;
+    return Stream.paginate(state.exclusiveStartKey, (exclusiveStartKey) => Effect.gen(function* () {
+        pageCount++;
+        const cmd = buildDynamoCommand(state, tableName, { ExclusiveStartKey: exclusiveStartKey });
+        const result = state.isScan ? yield* client.scan(cmd) : yield* client.query(cmd);
+        const rawItems = (result.Items ?? []).map((item) => fromAttributeMap(item));
+        const decoded = yield* Effect.forEach(rawItems, (raw) => state.decoder(raw));
+        // Stop pagination if maxPages reached or no more pages
+        const hasMorePages = result.LastEvaluatedKey != null;
+        const maxPagesReached = state.maxPagesValue != null && pageCount >= state.maxPagesValue;
+        const nextKey = hasMorePages && !maxPagesReached ? Option.some(result.LastEvaluatedKey) : Option.none();
+        return [[decoded], nextKey];
+    }));
+});
+/**
+ * Execute a count query. Uses `Select: "COUNT"` on DynamoDB — no items are returned.
+ * Returns the total count across all pages (respects maxPages).
+ */
+export const count = (self) => Effect.gen(function* () {
+    const client = yield* DynamoClient;
+    const state = self._state;
+    const tableName = state.resolveTableName ? yield* state.resolveTableName : state.tableName;
+    let total = 0;
+    let pageCount = 0;
+    let exclusiveStartKey;
+    do {
+        pageCount++;
+        const cmd = buildDynamoCommand(state, tableName, {
+            ExclusiveStartKey: exclusiveStartKey,
+            Select: "COUNT",
+        });
+        const result = state.isScan ? yield* client.scan(cmd) : yield* client.query(cmd);
+        total += result.Count ?? 0;
+        exclusiveStartKey = result.LastEvaluatedKey;
+        if (state.maxPagesValue != null && pageCount >= state.maxPagesValue)
+            break;
+    } while (exclusiveStartKey != null);
+    return total;
+});
+/**
+ * Return the built DynamoDB command input without executing.
+ * Useful for debugging, logging, or passing to DynamoClient directly.
+ */
+export const asParams = (self) => Effect.gen(function* () {
+    const state = self._state;
+    const tableName = state.resolveTableName ? yield* state.resolveTableName : state.tableName;
+    return buildDynamoCommand(state, tableName);
+});
+// ---------------------------------------------------------------------------
+// Type guard
+// ---------------------------------------------------------------------------
+export const isQuery = (u) => typeof u === "object" && u !== null && QueryTypeId in u;
+//# sourceMappingURL=Query.js.map

package/dist/Query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Query.js","sourceRoot":"","sources":["../src/Query.ts"],"names":[],"mappings":"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"}

package/dist/Table.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Table — Groups entities sharing a physical DynamoDB table and application namespace.
+ *
+ * The Table holds a DynamoSchema reference for key prefix generation and
+ * a record of named entities (and optionally aggregates).
+ * The physical table name is provided at runtime via Effect Layers.
+ *
+ * Use `DynamoClient.make()` to get a typed client with bound entity operations.
+ */
+import type { DescribeTableCommandOutput } from "@aws-sdk/client-dynamodb";
+import { type Config, Context, Effect, Layer } from "effect";
+import type { DynamoClientError } from "./DynamoClient.js";
+import type * as DynamoSchema from "./DynamoSchema.js";
+import type { IndexDefinition } from "./KeyComposer.js";
+/** Runtime table configuration injected via Effect Layer. */
+export interface TableConfig {
+    /** Physical DynamoDB table name. */
+    readonly name: string;
+}
+/** Minimal entity shape for Table membership (avoids circular import with Entity.ts) */
+interface EntityLike {
+    readonly _tag: "Entity";
+    readonly indexes: Record<string, IndexDefinition>;
+    readonly _configure: (schema: DynamoSchema.DynamoSchema, tableTag: Context.Service<TableConfig, TableConfig>) => void;
+}
+/** Minimal aggregate shape for Table membership (avoids circular import with Aggregate.ts) */
+interface AggregateLike {
+    readonly _tag: "Aggregate";
+    readonly pkField: string;
+    readonly collection: {
+        readonly index: string;
+        readonly sk: {
+            readonly field: string;
+        };
+    };
+    readonly listIndex: {
+        readonly index: string;
+        readonly pk: {
+            readonly field: string;
+        };
+        readonly sk: {
+            readonly field: string;
+        };
+    } | undefined;
+}
+/**
+ * A Table groups entities sharing a physical DynamoDB table and application namespace.
+ * Created via {@link make}. The physical table name is provided at runtime via
+ * {@link Table.layer} or {@link Table.layerConfig}.
+ *
+ * @typeParam TEntities - Named entity record (e.g., `{ Users: typeof Users }`)
+ * @typeParam TAggregates - Named aggregate record (e.g., `{ Matches: typeof Matches }`)
+ */
+export interface Table<TEntities extends Record<string, EntityLike> = Record<string, EntityLike>, TAggregates extends Record<string, AggregateLike> = Record<string, AggregateLike>> {
+    readonly _tag: "Table";
+    readonly schema: DynamoSchema.DynamoSchema;
+    /** Named entity members registered on this table. */
+    readonly entities: TEntities;
+    /** Named aggregate members registered on this table. */
+    readonly aggregates: TAggregates;
+    /** Effect Context.Service tag for this table's runtime config */
+    readonly Tag: Context.Service<TableConfig, TableConfig>;
+    /** Provide the physical table name */
+    readonly layer: (config: TableConfig) => Layer.Layer<TableConfig>;
+    /** Provide the physical table name from Effect Config */
+    readonly layerConfig: (config: {
+        readonly name: Config.Config<string>;
+    }) => Layer.Layer<TableConfig, Config.ConfigError>;
+}
+/**
+ * Create a new Table definition with optional entity and aggregate members.
+ *
+ * Each call to `make` creates a new unique Context.Service, so different tables
+ * produce independent runtime configurations even when sharing the same schema.
+ *
+ * Entities are automatically configured with the table's schema and tag.
+ *
+ * @example
+ * ```typescript
+ * const MainTable = Table.make({
+ *   schema: AppSchema,
+ *   entities: { Users, Tasks },
+ *   aggregates: { Matches },
+ * })
+ *
+ * // Provide physical table name at the edge
+ * MainTable.layer({ name: "my-prod-table" })
+ *
+ * // Or from environment variables via Effect Config
+ * MainTable.layerConfig({ name: Config.string("TABLE_NAME") })
+ * ```
+ */
+export declare const make: <const TEntities extends Record<string, EntityLike> = {}, const TAggregates extends Record<string, AggregateLike> = {}>(config: {
+    readonly schema: DynamoSchema.DynamoSchema;
+    readonly entities?: TEntities;
+    readonly aggregates?: TAggregates;
+}) => Table<TEntities, TAggregates>;
+/** A single key schema element for CreateTable input. */
+export interface KeySchemaElement {
+    readonly AttributeName: string;
+    readonly KeyType: "HASH" | "RANGE";
+}
+/** A single attribute definition for CreateTable input. */
+export interface AttributeDefinition {
+    readonly AttributeName: string;
+    readonly AttributeType: "S" | "N" | "B";
+}
+/** GSI definition for CreateTable input. */
+export interface GlobalSecondaryIndex {
+    readonly IndexName: string;
+    readonly KeySchema: Array<KeySchemaElement>;
+    readonly Projection: {
+        readonly ProjectionType: "ALL";
+    };
+}
+/** LSI definition for CreateTable input. */
+export interface LocalSecondaryIndex {
+    readonly IndexName: string;
+    readonly KeySchema: Array<KeySchemaElement>;
+    readonly Projection: {
+        readonly ProjectionType: "ALL";
+    };
+}
+/**
+ * Derived CreateTable input (minus TableName) computed from entity index definitions.
+ * Produced by {@link definition}. Mutable arrays for direct compatibility with
+ * the AWS SDK's `CreateTableCommandInput`.
+ */
+export interface TableDefinition {
+    readonly KeySchema: Array<KeySchemaElement>;
+    readonly AttributeDefinitions: Array<AttributeDefinition>;
+    readonly GlobalSecondaryIndexes?: Array<GlobalSecondaryIndex> | undefined;
+    readonly LocalSecondaryIndexes?: Array<LocalSecondaryIndex> | undefined;
+}
+/**
+ * Derive CreateTable input from a table's registered members.
+ *
+ * Scans all entity index definitions and aggregate GSI configs to produce:
+ * - KeySchema (from primary index)
+ * - AttributeDefinitions (all unique key attributes)
+ * - GlobalSecondaryIndexes (from non-primary entity indexes + aggregate list indexes,
+ *   plus aggregate collection indexes whose PK does not match the base table PK)
+ * - LocalSecondaryIndexes (from aggregate collection indexes whose PK equals the base
+ *   table PK — DynamoDB LSIs by definition share the base table's partition key)
+ *
+ * The physical table name is omitted — that's deployment config.
+ * All key attributes are typed as "S" (String) since generated keys are always strings.
+ *
+ * LSI auto-detection: an aggregate's `collection` GSI config is emitted as an LSI
+ * iff `agg.pkField` equals the table's primary PK field (determined from the first
+ * entity's primary index). This matches DynamoDB semantics — any index that shares
+ * the base table's partition key IS an LSI — and makes `lsi1`..`lsi5`-style indexes
+ * on aggregates work transparently with `db.tables.*.create()`.
+ */
+export declare const definition: (table: Table) => TableDefinition;
+/** Options for table creation. */
+export interface CreateTableOptions {
+    readonly billingMode?: "PAY_PER_REQUEST" | "PROVISIONED" | undefined;
+}
+/**
+ * A bound table with executable operations (`R = never`).
+ *
+ * @internal Used by `DynamoClient.make()`.
+ */
+export interface BoundTable {
+    /** Physical table name. */
+    readonly name: string;
+    /**
+     * Create the physical DynamoDB table from the table's registered members.
+     */
+    readonly create: (options?: CreateTableOptions) => Effect.Effect<void, DynamoClientError>;
+    /** Delete the physical DynamoDB table. */
+    readonly delete: Effect.Effect<void, DynamoClientError>;
+    /** Describe the table (status, stream specification, item count, etc.). */
+    readonly describe: Effect.Effect<DescribeTableCommandOutput, DynamoClientError>;
+}
+export {};
+//# sourceMappingURL=Table.d.ts.map

package/dist/Table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../src/Table.ts"],"names":[],"mappings":"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"}