dynamodb-reactive 0.1.21 → 0.2.1

package/dist/{table-tN3D4Tm-.d.ts → table-BijJ73pX.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { S as SupportedSchema, I as IndexDefinition, F as FieldRef, D as DynamoTableConfig } from './types-ISMJfyIv.js';
+import { S as SupportedSchema, I as IndexDefinition, F as FieldRef, D as DynamoTableConfig } from './types-LMLk8JVC.js';
 
 /**
  * Creates field references for type-safe query building
@@ -56,42 +56,10 @@ declare class DynamoTable<TSchema extends SupportedSchema, TPk extends keyof z.i
      * Safely validate an item, returning a result object
      */
     safeParse(item: unknown): z.ZodSafeParseResult<z.infer<TSchema>>;
-    /**
-     * Get the partition key value from an item
-     */
-    getPk(item: z.infer<TSchema>): z.infer<TSchema>[TPk];
-    /**
-     * Get the sort key value from an item (if defined)
-     */
-    getSk(item: z.infer<TSchema>): TSk extends keyof z.infer<TSchema> ? z.infer<TSchema>[TSk] : undefined;
     /**
      * Get the list of field names in the schema
      */
     getFieldNames(): (keyof z.infer<TSchema>)[];
-    /**
-     * Check if a field exists in the schema
-     */
-    hasField(fieldName: string): fieldName is keyof z.infer<TSchema> & string;
 }
-/**
- * Helper type to extract the shape from a Zod schema
- */
-type InferSchema<T> = T extends DynamoTable<infer TSchema, any, any, any> ? z.infer<TSchema> : never;
-/**
- * Helper type to extract field names from a table
- */
-type TableFields<T> = T extends DynamoTable<infer TSchema, any, any, any> ? keyof z.infer<TSchema> : never;
-/**
- * Helper type to get the pk field name
- */
-type TablePk<T> = T extends DynamoTable<any, infer TPk, any, any> ? TPk : never;
-/**
- * Helper type to get the sk field name
- */
-type TableSk<T> = T extends DynamoTable<any, any, infer TSk, any> ? TSk : never;
-/**
- * Helper type to get indexes
- */
-type TableIndexes<T> = T extends DynamoTable<any, any, any, infer TIndexes> ? TIndexes : never;
 
-export { DynamoTable as D, type InferSchema as I, type TableFields as T, type TableIndexes as a, type TablePk as b, type TableSk as c };
+export { DynamoTable as D };

package/dist/{types-ISMJfyIv.d.ts → types-LMLk8JVC.d.ts}

@@ -13,10 +13,6 @@ interface IndexDefinition {
  * Accepts both ZodObject and ZodDiscriminatedUnion
  */
 type SupportedSchema = z.ZodObject<z.ZodRawShape> | z.ZodDiscriminatedUnion;
-/**
- * Extract the inferred type from a supported schema
- */
-type InferSupportedSchema<T extends SupportedSchema> = z.infer<T>;
 /**
  * Base interface for any DynamoTable - used for generic constraints
  * Defines the minimal shape that all DynamoTable instances satisfy
@@ -33,10 +29,7 @@ interface AnyDynamoTable {
     }>;
     validate(item: unknown): unknown;
     safeParse(item: unknown): z.ZodSafeParseResult<unknown>;
-    getPk(item: unknown): unknown;
-    getSk(item: unknown): unknown;
     getFieldNames(): string[];
-    hasField(fieldName: string): boolean;
 }
 /**
  * Configuration for DynamoTable
@@ -56,17 +49,6 @@ interface FieldRef<TName extends string, TType> {
     fieldName: TName;
     _type: TType;
 }
-/**
- * Subscription message types for WebSocket communication
- */
-interface SubscriptionMessage {
-    type: 'subscribe' | 'unsubscribe' | 'patch' | 'snapshot' | 'error';
-    subscriptionId: string;
-    path?: string;
-    input?: unknown;
-    data?: unknown;
-    patches?: JsonPatch[];
-}
 /**
  * JSON Patch operation (RFC 6902)
  */
@@ -87,6 +69,8 @@ interface DependencyEntry {
     tableName: string;
     fieldName: string;
     fieldValue: string;
+    generation: number;
+    registrationId: string;
     ttl: number;
 }
 /**
@@ -94,7 +78,13 @@ interface DependencyEntry {
  */
 interface ConnectionEntry {
     connectionId: string;
+    status: 'open' | 'closed';
+    /** Context explicitly supplied by application-side registration. */
     context?: Record<string, unknown>;
+    /** API Gateway authorizer values captured by the WebSocket connect adapter. */
+    authorizerContext?: Record<string, unknown>;
+    /** API Gateway request identity captured for IAM-authorized connections. */
+    requestIdentity?: Record<string, unknown>;
     connectedAt: number;
     ttl: number;
 }
@@ -102,23 +92,42 @@ interface ConnectionEntry {
  * Filter condition for query subscriptions (serializable)
  * Used to evaluate whether a record matches the subscription's query
  */
-interface FilterCondition {
-    type: 'comparison' | 'logical' | 'function';
-    operator: string;
-    field?: string;
-    value?: unknown;
-    value2?: unknown;
-    conditions?: FilterCondition[];
-}
+type FilterCondition = {
+    type: 'comparison';
+    operator: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte';
+    field: string;
+    value: unknown;
+} | {
+    type: 'function';
+    operator: 'between';
+    field: string;
+    value: unknown;
+    value2: unknown;
+} | {
+    type: 'function';
+    operator: 'beginsWith' | 'contains';
+    field: string;
+    value: unknown;
+} | {
+    type: 'logical';
+    operator: 'and' | 'or' | 'not';
+    conditions: FilterCondition[];
+};
 /**
  * Query metadata for subscription state (serializable, no router code needed)
  * Contains all information needed to evaluate stream changes
  */
 interface QueryMetadata {
+    /** Stored plan format. Unknown versions must be rejected. */
+    planVersion: 1;
     /** Table name being queried */
     tableName: string;
     /** Index name if using a GSI */
     indexName?: string;
+    /** Partition key field of the selected sparse index. */
+    indexPkField?: string;
+    /** Sort key field of the selected sparse index. */
+    indexSkField?: string;
     /** Filter conditions to evaluate against records */
     filterConditions: FilterCondition[];
     /** Field to sort by */
@@ -128,6 +137,18 @@ interface QueryMetadata {
     /** Maximum number of results */
     limit?: number;
 }
+interface PendingDeliveryVersion {
+    generation: number;
+    fromVersion: number;
+    toVersion: number;
+    messageId: string;
+}
+type PendingDelivery = (PendingDeliveryVersion & {
+    type: 'patch';
+    patches: JsonPatch[];
+}) | (PendingDeliveryVersion & {
+    type: 'resync';
+});
 /**
  * Query entry for storing subscription state
  * Stores all metadata needed to evaluate stream changes without router code
@@ -137,17 +158,22 @@ interface QueryEntry {
     sk: string;
     connectionId: string;
     subscriptionId: string;
+    status: 'registering' | 'active' | 'cancelled' | 'faulted';
+    generation: number;
+    registrationId: string;
     /** Query metadata for evaluating stream changes */
     queryMetadata: QueryMetadata;
-    /** Last query result - can be array or single item depending on procedure */
-    lastResult: unknown;
+    /** Subscription results are always arrays. */
+    lastResult: unknown[];
     /** Dependency keys for the inverted index */
     dependencies: string[];
     /** Optimistic locking version - incremented on each update to prevent race conditions */
-    version?: number;
+    version: number;
+    /** Delivery is cleared only after its versioned message was sent. */
+    pendingDelivery?: PendingDelivery;
     createdAt: number;
     updatedAt: number;
     ttl: number;
 }
 
-export type { AnyDynamoTable as A, ConnectionEntry as C, DynamoTableConfig as D, FieldRef as F, IndexDefinition as I, JsonPatch as J, QueryMetadata as Q, SupportedSchema as S, FilterCondition as a, DependencyEntry as b, InferSupportedSchema as c, QueryEntry as d, SubscriptionMessage as e };
+export type { AnyDynamoTable as A, ConnectionEntry as C, DynamoTableConfig as D, FieldRef as F, IndexDefinition as I, JsonPatch as J, PendingDelivery as P, QueryMetadata as Q, SupportedSchema as S, FilterCondition as a, DependencyEntry as b, QueryEntry as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dynamodb-reactive",
-  "version": "0.1.21",
+  "version": "0.2.1",
   "type": "module",
   "description": "A Serverless, Reactive tRPC replacement for AWS DynamoDB",
   "keywords": [
@@ -17,69 +17,106 @@
   "author": "andreigec@gmail.com",
   "repository": {
     "type": "git",
-    "url": ""
+    "url": "git+https://github.com/andreigec/dynamodb-reactive.git",
+    "directory": "packages/dynamodb-reactive"
   },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "bugs": {
+    "url": "https://github.com/andreigec/dynamodb-reactive/issues"
+  },
+  "homepage": "https://github.com/andreigec/dynamodb-reactive#readme",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./client": {
-      "types": "./dist/client.d.ts",
-      "import": "./dist/client.js",
-      "default": "./dist/client.js"
+      "import": {
+        "types": "./dist/client.d.ts",
+        "default": "./dist/client.js"
+      },
+      "require": {
+        "types": "./dist/client.d.cts",
+        "default": "./dist/client.cjs"
+      }
     },
     "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js",
-      "default": "./dist/react.js"
+      "import": {
+        "types": "./dist/react.d.ts",
+        "default": "./dist/react.js"
+      },
+      "require": {
+        "types": "./dist/react.d.cts",
+        "default": "./dist/react.cjs"
+      }
     },
     "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js",
-      "default": "./dist/server.js"
+      "import": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      },
+      "require": {
+        "types": "./dist/server.d.cts",
+        "default": "./dist/server.cjs"
+      }
     },
     "./core": {
-      "types": "./dist/core.d.ts",
-      "import": "./dist/core.js",
-      "default": "./dist/core.js"
+      "import": {
+        "types": "./dist/core.d.ts",
+        "default": "./dist/core.js"
+      },
+      "require": {
+        "types": "./dist/core.d.cts",
+        "default": "./dist/core.cjs"
+      }
     },
     "./infra": {
-      "types": "./dist/infra.d.ts",
-      "import": "./dist/infra.js",
-      "default": "./dist/infra.js"
+      "import": {
+        "types": "./dist/infra.d.ts",
+        "default": "./dist/infra.js"
+      },
+      "require": {
+        "types": "./dist/infra.d.cts",
+        "default": "./dist/infra.cjs"
+      }
     }
   },
   "files": [
     "dist",
     "!**/*.spec.*",
     "!**/*.test.*",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "dependencies": {
-    "@aws-sdk/client-apigatewaymanagementapi": "^3.983.0",
-    "@aws-sdk/client-dynamodb": "^3.983.0",
-    "@aws-sdk/lib-dynamodb": "^3.983.0",
-    "@aws-sdk/util-dynamodb": "^3.983.0",
-    "ag-common": "^0.0.871",
+    "@aws-sdk/client-apigatewaymanagementapi": "^3.1121.0",
+    "@aws-sdk/client-dynamodb": "^3.1121.0",
+    "@aws-sdk/lib-dynamodb": "^3.1121.0",
+    "@aws-sdk/util-dynamodb": "^3.996.9",
+    "@types/aws-lambda": "^8.10.162",
     "fast-json-patch": "^3.1.1"
   },
   "devDependencies": {
-    "@types/react": "^19.2.11",
-    "eslint": "^9.39.2",
-    "rimraf": "^6.1.2",
+    "@typescript/typescript6": "^6.0.2",
+    "@types/react": "^19.2.18",
+    "eslint": "^10.9.1",
+    "rimraf": "^6.1.3",
+    "rollup": "^4.55.1",
+    "rollup-plugin-dts": "^6.5.1",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^7.0.2"
   },
   "peerDependencies": {
-    "aws-cdk-lib": "^2.237.1",
-    "constructs": "^10.4.5",
-    "react": "^19.2.4",
-    "zod": "^4.3.6"
+    "aws-cdk-lib": "^2.267.0",
+    "constructs": "^10.8.1",
+    "esbuild": ">=0.21.0",
+    "react": "^18.2.0 || ^19.0.0",
+    "zod": "^4.5.4"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -90,19 +127,20 @@
     },
     "constructs": {
       "optional": true
+    },
+    "esbuild": {
+      "optional": true
     }
   },
   "publishConfig": {
     "access": "public"
   },
-  "engines": {
-    "node": ">=18.0.0"
-  },
   "sideEffects": false,
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && rollup --config rollup.config.mjs",
     "dev": "tsup --watch src ../core/src ../client/src ../server/src ../infra/src",
     "clean": "rimraf dist",
+    "test": "pnpm --dir ../.. test",
     "typecheck": "tsc --noEmit",
     "format": "eslint src --fix && tsc --noEmit"
   }