dynamodb-reactive 0.1.0 → 0.1.3

package/dist/infra.js

@@ -1,18 +1,361 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
+import { SystemTableNames } from './chunk-HZ6JHAJJ.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as cdk2 from 'aws-cdk-lib';
+import * as apigatewayv2 from 'aws-cdk-lib/aws-apigatewayv2';
+import * as apigatewayv2Integrations from 'aws-cdk-lib/aws-apigatewayv2-integrations';
+import * as iam from 'aws-cdk-lib/aws-iam';
+import * as lambda from 'aws-cdk-lib/aws-lambda';
+import * as nodejs from 'aws-cdk-lib/aws-lambda-nodejs';
+import * as logs from 'aws-cdk-lib/aws-logs';
+import { Construct } from 'constructs';
+import * as dynamodb from 'aws-cdk-lib/aws-dynamodb';
+
+// ../infra/src/handlers/lambda-handlers.ts
+function generateEntryPointCode() {
+  return `// Auto-generated entry point for reactive Lambda handlers
+// No user code required - all configuration comes from environment variables
+import { createLambdaHandlers } from 'dynamodb-reactive/server';
+
+const handlers = createLambdaHandlers();
+
+export const connectHandler = handlers.connectHandler;
+export const disconnectHandler = handlers.disconnectHandler;
+export const messageHandler = handlers.messageHandler;
+export const streamHandler = handlers.streamHandler;
+`;
+}
+var ReactiveSystemTables = class extends Construct {
+  /**
+   * ReactiveConnections table - tracks WebSocket connections
+   */
+  connectionsTable;
+  /**
+   * ReactiveDependencies table - the inverted index
+   */
+  dependenciesTable;
+  /**
+   * ReactiveConnectionQueries table - stores subscription state
+   */
+  queriesTable;
+  constructor(scope, id, props = {}) {
+    super(scope, id);
+    const prefix = props.tablePrefix ? `${props.tablePrefix}-` : "";
+    const removalPolicy = props.removalPolicy ?? cdk2.RemovalPolicy.RETAIN;
+    const pointInTimeRecovery = props.pointInTimeRecovery ?? false;
+    this.connectionsTable = new dynamodb.Table(this, "ConnectionsTable", {
+      tableName: `${prefix}${SystemTableNames.connections}`,
+      partitionKey: {
+        name: "connectionId",
+        type: dynamodb.AttributeType.STRING
+      },
+      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,
+      removalPolicy,
+      pointInTimeRecovery,
+      timeToLiveAttribute: "ttl"
+    });
+    this.dependenciesTable = new dynamodb.Table(this, "DependenciesTable", {
+      tableName: `${prefix}${SystemTableNames.dependencies}`,
+      partitionKey: {
+        name: "pk",
+        // Format: "TableName#FieldName#FieldValue"
+        type: dynamodb.AttributeType.STRING
+      },
+      sortKey: {
+        name: "sk",
+        // Format: "ConnectionID#SubscriptionID"
+        type: dynamodb.AttributeType.STRING
+      },
+      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,
+      removalPolicy,
+      pointInTimeRecovery,
+      timeToLiveAttribute: "ttl"
+    });
+    this.dependenciesTable.addGlobalSecondaryIndex({
+      indexName: "byConnectionId",
+      partitionKey: {
+        name: "connectionId",
+        type: dynamodb.AttributeType.STRING
+      },
+      projectionType: dynamodb.ProjectionType.KEYS_ONLY
+    });
+    this.queriesTable = new dynamodb.Table(this, "QueriesTable", {
+      tableName: `${prefix}${SystemTableNames.queries}`,
+      partitionKey: {
+        name: "pk",
+        // ConnectionID
+        type: dynamodb.AttributeType.STRING
+      },
+      sortKey: {
+        name: "sk",
+        // SubscriptionID
+        type: dynamodb.AttributeType.STRING
+      },
+      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,
+      removalPolicy,
+      pointInTimeRecovery,
+      timeToLiveAttribute: "ttl"
+    });
+  }
+};
+
+// ../infra/src/engine.ts
+var ReactiveEngine = class extends Construct {
+  systemTables;
+  webSocketApi;
+  webSocketStage;
+  connectHandler;
+  disconnectHandler;
+  messageHandler;
+  streamHandler;
+  webSocketUrl;
+  callbackUrl;
+  constructor(scope, id, props) {
+    super(scope, id);
+    const prefix = props.resourcePrefix ?? "";
+    const memorySize = props.memorySize ?? 256;
+    const timeout = props.timeout ?? cdk2.Duration.seconds(30);
+    const logRetention = props.logRetention ?? logs.RetentionDays.ONE_WEEK;
+    this.systemTables = new ReactiveSystemTables(this, "SystemTables", {
+      tablePrefix: prefix,
+      ...props.systemTablesProps
+    });
+    this.webSocketApi = new apigatewayv2.WebSocketApi(this, "WebSocketApi", {
+      apiName: `${prefix}ReactiveWebSocket`
+    });
+    this.webSocketStage = new apigatewayv2.WebSocketStage(
+      this,
+      "WebSocketStage",
+      {
+        webSocketApi: this.webSocketApi,
+        stageName: "prod",
+        autoDeploy: true
+      }
+    );
+    this.webSocketUrl = this.webSocketStage.url;
+    this.callbackUrl = this.webSocketStage.callbackUrl;
+    const entryPointCode = generateEntryPointCode();
+    const cdkOutDir = path.join(process.cwd(), "cdk.out", ".generated");
+    fs.mkdirSync(cdkOutDir, { recursive: true });
+    const entryPointPath = path.join(
+      cdkOutDir,
+      `reactive-entry-${id}-${Date.now()}.ts`
+    );
+    fs.writeFileSync(entryPointPath, entryPointCode);
+    const environment = {
+      CONNECTIONS_TABLE: this.systemTables.connectionsTable.tableName,
+      DEPENDENCIES_TABLE: this.systemTables.dependenciesTable.tableName,
+      QUERIES_TABLE: this.systemTables.queriesTable.tableName,
+      WEBSOCKET_ENDPOINT: this.callbackUrl,
+      ...props.environment
+    };
+    this.connectHandler = new nodejs.NodejsFunction(this, "ConnectHandler", {
+      functionName: `${prefix}ReactiveConnect`,
+      runtime: lambda.Runtime.NODEJS_LATEST,
+      handler: "connectHandler",
+      entry: entryPointPath,
+      environment,
+      memorySize,
+      timeout,
+      logRetention,
+      tracing: props.tracing ? lambda.Tracing.ACTIVE : lambda.Tracing.DISABLED
+    });
+    this.disconnectHandler = new nodejs.NodejsFunction(
+      this,
+      "DisconnectHandler",
+      {
+        functionName: `${prefix}ReactiveDisconnect`,
+        runtime: lambda.Runtime.NODEJS_LATEST,
+        handler: "disconnectHandler",
+        entry: entryPointPath,
+        environment,
+        memorySize,
+        timeout,
+        logRetention,
+        tracing: props.tracing ? lambda.Tracing.ACTIVE : lambda.Tracing.DISABLED
+      }
+    );
+    this.messageHandler = new nodejs.NodejsFunction(this, "MessageHandler", {
+      functionName: `${prefix}ReactiveMessage`,
+      runtime: lambda.Runtime.NODEJS_LATEST,
+      handler: "messageHandler",
+      entry: entryPointPath,
+      environment,
+      memorySize,
+      timeout,
+      logRetention,
+      tracing: props.tracing ? lambda.Tracing.ACTIVE : lambda.Tracing.DISABLED
+    });
+    this.streamHandler = new nodejs.NodejsFunction(this, "StreamHandler", {
+      functionName: `${prefix}ReactiveStream`,
+      runtime: lambda.Runtime.NODEJS_LATEST,
+      handler: "streamHandler",
+      entry: entryPointPath,
+      environment: {
+        ...environment,
+        USER_TABLES: props.tables.map((t) => t.tableName).join(",")
+      },
+      memorySize,
+      timeout,
+      logRetention,
+      tracing: props.tracing ? lambda.Tracing.ACTIVE : lambda.Tracing.DISABLED
+    });
+    this.systemTables.connectionsTable.grantReadWriteData(this.connectHandler);
+    this.systemTables.connectionsTable.grantReadWriteData(
+      this.disconnectHandler
+    );
+    this.systemTables.connectionsTable.grantReadWriteData(this.messageHandler);
+    this.systemTables.connectionsTable.grantReadData(this.streamHandler);
+    this.systemTables.dependenciesTable.grantReadWriteData(this.messageHandler);
+    this.systemTables.dependenciesTable.grantReadWriteData(this.streamHandler);
+    this.systemTables.queriesTable.grantReadWriteData(this.messageHandler);
+    this.systemTables.queriesTable.grantReadWriteData(this.streamHandler);
+    const managementPolicy = new iam.PolicyStatement({
+      actions: ["execute-api:ManageConnections"],
+      resources: [
+        `arn:aws:execute-api:${cdk2.Stack.of(this).region}:${cdk2.Stack.of(this).account}:${this.webSocketApi.apiId}/${this.webSocketStage.stageName}/POST/@connections/*`
+      ]
+    });
+    this.messageHandler.addToRolePolicy(managementPolicy);
+    this.streamHandler.addToRolePolicy(managementPolicy);
+    this.webSocketApi.addRoute("$connect", {
+      integration: new apigatewayv2Integrations.WebSocketLambdaIntegration(
+        "ConnectIntegration",
+        this.connectHandler
+      )
+    });
+    this.webSocketApi.addRoute("$disconnect", {
+      integration: new apigatewayv2Integrations.WebSocketLambdaIntegration(
+        "DisconnectIntegration",
+        this.disconnectHandler
+      )
+    });
+    this.webSocketApi.addRoute("$default", {
+      integration: new apigatewayv2Integrations.WebSocketLambdaIntegration(
+        "DefaultIntegration",
+        this.messageHandler
+      )
+    });
+    for (const table of props.tables) {
+      this.setupStreamProcessing(table);
+    }
+    new cdk2.CfnOutput(this, "WebSocketUrl", {
+      value: this.webSocketUrl,
+      description: "WebSocket URL for reactive connections"
+    });
+  }
+  setupStreamProcessing(table) {
+    const tableArn = `arn:aws:dynamodb:${cdk2.Stack.of(this).region}:${cdk2.Stack.of(this).account}:table/${table.tableName}`;
+    const streamArn = `${tableArn}/stream/*`;
+    this.streamHandler.addToRolePolicy(
+      new iam.PolicyStatement({
+        actions: [
+          "dynamodb:GetRecords",
+          "dynamodb:GetShardIterator",
+          "dynamodb:DescribeStream",
+          "dynamodb:ListStreams"
+        ],
+        resources: [streamArn]
+      })
+    );
+    const tableReadPolicy = new iam.PolicyStatement({
+      actions: [
+        "dynamodb:Query",
+        "dynamodb:Scan",
+        "dynamodb:GetItem",
+        "dynamodb:BatchGetItem",
+        "dynamodb:PartiQLSelect"
+      ],
+      resources: [tableArn, `${tableArn}/index/*`]
+    });
+    this.streamHandler.addToRolePolicy(tableReadPolicy);
+    this.messageHandler.addToRolePolicy(tableReadPolicy);
+    this.messageHandler.addToRolePolicy(
+      new iam.PolicyStatement({
+        actions: [
+          "dynamodb:PutItem",
+          "dynamodb:UpdateItem",
+          "dynamodb:DeleteItem",
+          "dynamodb:BatchWriteItem",
+          "dynamodb:PartiQLInsert",
+          "dynamodb:PartiQLUpdate",
+          "dynamodb:PartiQLDelete"
+        ],
+        resources: [tableArn, `${tableArn}/index/*`]
+      })
+    );
+  }
+  addTable(table) {
+    if (!table.tableStreamArn) {
+      throw new Error(`Table ${table.tableName} does not have streams enabled`);
+    }
+    table.grantStreamRead(this.streamHandler);
+    table.grantReadData(this.streamHandler);
+    new lambda.EventSourceMapping(this, `Stream-${table.tableName}`, {
+      target: this.streamHandler,
+      eventSourceArn: table.tableStreamArn,
+      startingPosition: lambda.StartingPosition.TRIM_HORIZON,
+      batchSize: 100,
+      maxBatchingWindow: cdk2.Duration.seconds(5)
+    });
+  }
+};
+var DynamoDBStreamSource = class extends Construct {
+  eventSourceMapping;
+  constructor(scope, id, props) {
+    super(scope, id);
+    const {
+      table,
+      target,
+      batchSize = 100,
+      maxBatchingWindow = cdk2.Duration.seconds(5),
+      startingPosition = lambda.StartingPosition.TRIM_HORIZON,
+      parallelizationFactor = 1,
+      maxRecordAge = cdk2.Duration.days(1),
+      retryAttempts = 3,
+      filters
+    } = props;
+    if (!table.tableStreamArn) {
+      throw new Error(
+        `Table ${table.tableName} does not have DynamoDB Streams enabled. Enable streams with streamSpecification when creating the table.`
+      );
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+    table.grantStreamRead(target);
+    this.eventSourceMapping = new lambda.EventSourceMapping(
+      this,
+      "EventSource",
+      {
+        target,
+        eventSourceArn: table.tableStreamArn,
+        startingPosition,
+        batchSize,
+        maxBatchingWindow,
+        parallelizationFactor,
+        maxRecordAge,
+        retryAttempts,
+        bisectBatchOnError: true,
+        reportBatchItemFailures: true,
+        filters
+      }
+    );
+  }
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("@dynamodb-reactive/infra"), exports);
+function createStreamFilter(options) {
+  const filters = [];
+  if (options.eventName) {
+    filters.push({
+      eventName: options.eventName
+    });
+  }
+  if (options.patterns) {
+    filters.push(...options.patterns);
+  }
+  if (filters.length === 0) {
+    return [];
+  }
+  return [lambda.FilterCriteria.filter({ filters })];
+}
+
+export { DynamoDBStreamSource, ReactiveEngine, ReactiveSystemTables, createStreamFilter, generateEntryPointCode };
+//# sourceMappingURL=infra.js.map
 //# sourceMappingURL=infra.js.map

package/dist/infra.js.map

@@ -1 +1 @@
-{"version":3,"file":"infra.js","sourceRoot":"","sources":["../src/infra.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC"}
+{"version":3,"sources":["../../infra/src/handlers/lambda-handlers.ts","../../infra/src/tables.ts","../../infra/src/engine.ts","../../infra/src/stream-source.ts"],"names":["cdk","Construct","cdk3","lambda2"],"mappings":"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","file":"infra.js","sourcesContent":["/**\n * Entry point code generator for the reactive Lambda handlers.\n *\n * No user code is imported - the handlers use only environment variables\n * and stored query metadata for all operations.\n */\n\n/**\n * Generate the entry point code for Lambda functions.\n * This is called by the CDK construct to create the bundled entry file.\n */\nexport function generateEntryPointCode(): string {\n  return `// Auto-generated entry point for reactive Lambda handlers\n// No user code required - all configuration comes from environment variables\nimport { createLambdaHandlers } from 'dynamodb-reactive/server';\n\nconst handlers = createLambdaHandlers();\n\nexport const connectHandler = handlers.connectHandler;\nexport const disconnectHandler = handlers.disconnectHandler;\nexport const messageHandler = handlers.messageHandler;\nexport const streamHandler = handlers.streamHandler;\n`;\n}\n","import { SystemTableNames } from '@dynamodb-reactive/core';\nimport * as cdk from 'aws-cdk-lib';\nimport * as dynamodb from 'aws-cdk-lib/aws-dynamodb';\nimport { Construct } from 'constructs';\n\n/**\n * Props for ReactiveSystemTables\n */\nexport interface ReactiveSystemTablesProps {\n  /**\n   * Prefix for table names\n   * @default - no prefix\n   */\n  tablePrefix?: string;\n\n  /**\n   * Removal policy for tables\n   * @default - cdk.RemovalPolicy.RETAIN\n   */\n  removalPolicy?: cdk.RemovalPolicy;\n\n  /**\n   * Enable point-in-time recovery\n   * @default false\n   */\n  pointInTimeRecovery?: boolean;\n}\n\n/**\n * Creates the three system tables for the reactive engine\n */\nexport class ReactiveSystemTables extends Construct {\n  /**\n   * ReactiveConnections table - tracks WebSocket connections\n   */\n  public readonly connectionsTable: dynamodb.Table;\n\n  /**\n   * ReactiveDependencies table - the inverted index\n   */\n  public readonly dependenciesTable: dynamodb.Table;\n\n  /**\n   * ReactiveConnectionQueries table - stores subscription state\n   */\n  public readonly queriesTable: dynamodb.Table;\n\n  constructor(\n    scope: Construct,\n    id: string,\n    props: ReactiveSystemTablesProps = {},\n  ) {\n    super(scope, id);\n\n    const prefix = props.tablePrefix ? `${props.tablePrefix}-` : '';\n    const removalPolicy = props.removalPolicy ?? cdk.RemovalPolicy.RETAIN;\n    const pointInTimeRecovery = props.pointInTimeRecovery ?? false;\n\n    // ReactiveConnections Table\n    // Tracks active WebSocket connections and user context\n    this.connectionsTable = new dynamodb.Table(this, 'ConnectionsTable', {\n      tableName: `${prefix}${SystemTableNames.connections}`,\n      partitionKey: {\n        name: 'connectionId',\n        type: dynamodb.AttributeType.STRING,\n      },\n      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,\n      removalPolicy,\n      pointInTimeRecovery,\n      timeToLiveAttribute: 'ttl',\n    });\n\n    // ReactiveDependencies Table (The Inverted Index)\n    // Maps Field#Value -> ConnectionID for O(1) lookups\n    this.dependenciesTable = new dynamodb.Table(this, 'DependenciesTable', {\n      tableName: `${prefix}${SystemTableNames.dependencies}`,\n      partitionKey: {\n        name: 'pk', // Format: \"TableName#FieldName#FieldValue\"\n        type: dynamodb.AttributeType.STRING,\n      },\n      sortKey: {\n        name: 'sk', // Format: \"ConnectionID#SubscriptionID\"\n        type: dynamodb.AttributeType.STRING,\n      },\n      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,\n      removalPolicy,\n      pointInTimeRecovery,\n      timeToLiveAttribute: 'ttl',\n    });\n\n    // Add GSI for querying by connectionId (for cleanup)\n    this.dependenciesTable.addGlobalSecondaryIndex({\n      indexName: 'byConnectionId',\n      partitionKey: {\n        name: 'connectionId',\n        type: dynamodb.AttributeType.STRING,\n      },\n      projectionType: dynamodb.ProjectionType.KEYS_ONLY,\n    });\n\n    // ReactiveConnectionQueries Table\n    // Stores subscription state for diffing\n    this.queriesTable = new dynamodb.Table(this, 'QueriesTable', {\n      tableName: `${prefix}${SystemTableNames.queries}`,\n      partitionKey: {\n        name: 'pk', // ConnectionID\n        type: dynamodb.AttributeType.STRING,\n      },\n      sortKey: {\n        name: 'sk', // SubscriptionID\n        type: dynamodb.AttributeType.STRING,\n      },\n      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,\n      removalPolicy,\n      pointInTimeRecovery,\n      timeToLiveAttribute: 'ttl',\n    });\n  }\n}\n","import * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nimport type { AnyDynamoTable } from '@dynamodb-reactive/core';\nimport * as cdk from 'aws-cdk-lib';\nimport * as apigatewayv2 from 'aws-cdk-lib/aws-apigatewayv2';\nimport * as apigatewayv2Integrations from 'aws-cdk-lib/aws-apigatewayv2-integrations';\nimport type * as dynamodb from 'aws-cdk-lib/aws-dynamodb';\nimport * as iam from 'aws-cdk-lib/aws-iam';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\nimport * as nodejs from 'aws-cdk-lib/aws-lambda-nodejs';\nimport * as logs from 'aws-cdk-lib/aws-logs';\nimport { Construct } from 'constructs';\n\nimport { generateEntryPointCode } from './handlers/lambda-handlers.js';\nimport {\n  ReactiveSystemTables,\n  type ReactiveSystemTablesProps,\n} from './tables.js';\n\n/**\n * Props for ReactiveEngine construct\n */\nexport interface ReactiveEngineProps {\n  /**\n   * User-defined DynamoDB tables to enable reactive updates on\n   */\n  tables: AnyDynamoTable[];\n\n  /**\n   * Prefix for all resource names\n   * @default - no prefix\n   */\n  resourcePrefix?: string;\n\n  /**\n   * System tables configuration\n   */\n  systemTablesProps?: ReactiveSystemTablesProps;\n\n  /**\n   * Lambda function memory size in MB\n   * @default 256\n   */\n  memorySize?: number;\n\n  /**\n   * Lambda function timeout\n   * @default Duration.seconds(30)\n   */\n  timeout?: cdk.Duration;\n\n  /**\n   * Log retention period\n   * @default logs.RetentionDays.ONE_WEEK\n   */\n  logRetention?: logs.RetentionDays;\n\n  /**\n   * Environment variables for Lambda functions\n   */\n  environment?: Record<string, string>;\n\n  /**\n   * Enable tracing with X-Ray\n   * @default false\n   */\n  tracing?: boolean;\n}\n\n/**\n * ReactiveEngine - Main CDK construct for the reactive DynamoDB system\n */\nexport class ReactiveEngine extends Construct {\n  public readonly systemTables: ReactiveSystemTables;\n  public readonly webSocketApi: apigatewayv2.WebSocketApi;\n  public readonly webSocketStage: apigatewayv2.WebSocketStage;\n  public readonly connectHandler: lambda.Function;\n  public readonly disconnectHandler: lambda.Function;\n  public readonly messageHandler: lambda.Function;\n  public readonly streamHandler: lambda.Function;\n  public readonly webSocketUrl: string;\n  public readonly callbackUrl: string;\n\n  constructor(scope: Construct, id: string, props: ReactiveEngineProps) {\n    super(scope, id);\n\n    const prefix = props.resourcePrefix ?? '';\n    const memorySize = props.memorySize ?? 256;\n    const timeout = props.timeout ?? cdk.Duration.seconds(30);\n    const logRetention = props.logRetention ?? logs.RetentionDays.ONE_WEEK;\n\n    // Create system tables\n    this.systemTables = new ReactiveSystemTables(this, 'SystemTables', {\n      tablePrefix: prefix,\n      ...props.systemTablesProps,\n    });\n\n    // Create WebSocket API\n    this.webSocketApi = new apigatewayv2.WebSocketApi(this, 'WebSocketApi', {\n      apiName: `${prefix}ReactiveWebSocket`,\n    });\n\n    this.webSocketStage = new apigatewayv2.WebSocketStage(\n      this,\n      'WebSocketStage',\n      {\n        webSocketApi: this.webSocketApi,\n        stageName: 'prod',\n        autoDeploy: true,\n      },\n    );\n\n    this.webSocketUrl = this.webSocketStage.url;\n    this.callbackUrl = this.webSocketStage.callbackUrl;\n\n    // Generate the entry point file (no user code required)\n    // Write to cdk.out directory to avoid path resolution issues with temp directories\n    const entryPointCode = generateEntryPointCode();\n    const cdkOutDir = path.join(process.cwd(), 'cdk.out', '.generated');\n    fs.mkdirSync(cdkOutDir, { recursive: true });\n    const entryPointPath = path.join(\n      cdkOutDir,\n      `reactive-entry-${id}-${Date.now()}.ts`,\n    );\n    fs.writeFileSync(entryPointPath, entryPointCode);\n\n    // Common environment variables\n    const environment: Record<string, string> = {\n      CONNECTIONS_TABLE: this.systemTables.connectionsTable.tableName,\n      DEPENDENCIES_TABLE: this.systemTables.dependenciesTable.tableName,\n      QUERIES_TABLE: this.systemTables.queriesTable.tableName,\n      WEBSOCKET_ENDPOINT: this.callbackUrl,\n      ...props.environment,\n    };\n\n    // Create handlers using NodejsFunction with the generated entry point\n    this.connectHandler = new nodejs.NodejsFunction(this, 'ConnectHandler', {\n      functionName: `${prefix}ReactiveConnect`,\n      runtime: lambda.Runtime.NODEJS_LATEST,\n      handler: 'connectHandler',\n      entry: entryPointPath,\n      environment,\n      memorySize,\n      timeout,\n      logRetention,\n      tracing: props.tracing ? lambda.Tracing.ACTIVE : lambda.Tracing.DISABLED,\n    });\n\n    this.disconnectHandler = new nodejs.NodejsFunction(\n      this,\n      'DisconnectHandler',\n      {\n        functionName: `${prefix}ReactiveDisconnect`,\n        runtime: lambda.Runtime.NODEJS_LATEST,\n        handler: 'disconnectHandler',\n        entry: entryPointPath,\n        environment,\n        memorySize,\n        timeout,\n        logRetention,\n        tracing: props.tracing\n          ? lambda.Tracing.ACTIVE\n          : lambda.Tracing.DISABLED,\n      },\n    );\n\n    this.messageHandler = new nodejs.NodejsFunction(this, 'MessageHandler', {\n      functionName: `${prefix}ReactiveMessage`,\n      runtime: lambda.Runtime.NODEJS_LATEST,\n      handler: 'messageHandler',\n      entry: entryPointPath,\n      environment,\n      memorySize,\n      timeout,\n      logRetention,\n      tracing: props.tracing ? lambda.Tracing.ACTIVE : lambda.Tracing.DISABLED,\n    });\n\n    this.streamHandler = new nodejs.NodejsFunction(this, 'StreamHandler', {\n      functionName: `${prefix}ReactiveStream`,\n      runtime: lambda.Runtime.NODEJS_LATEST,\n      handler: 'streamHandler',\n      entry: entryPointPath,\n      environment: {\n        ...environment,\n        USER_TABLES: props.tables.map((t) => t.tableName).join(','),\n      },\n      memorySize,\n      timeout,\n      logRetention,\n      tracing: props.tracing ? lambda.Tracing.ACTIVE : lambda.Tracing.DISABLED,\n    });\n\n    // Grant permissions for system tables\n    this.systemTables.connectionsTable.grantReadWriteData(this.connectHandler);\n    this.systemTables.connectionsTable.grantReadWriteData(\n      this.disconnectHandler,\n    );\n    this.systemTables.connectionsTable.grantReadWriteData(this.messageHandler);\n    this.systemTables.connectionsTable.grantReadData(this.streamHandler);\n\n    this.systemTables.dependenciesTable.grantReadWriteData(this.messageHandler);\n    this.systemTables.dependenciesTable.grantReadWriteData(this.streamHandler);\n\n    this.systemTables.queriesTable.grantReadWriteData(this.messageHandler);\n    this.systemTables.queriesTable.grantReadWriteData(this.streamHandler);\n\n    // Grant WebSocket management permissions\n    const managementPolicy = new iam.PolicyStatement({\n      actions: ['execute-api:ManageConnections'],\n      resources: [\n        `arn:aws:execute-api:${cdk.Stack.of(this).region}:${cdk.Stack.of(this).account}:${this.webSocketApi.apiId}/${this.webSocketStage.stageName}/POST/@connections/*`,\n      ],\n    });\n\n    this.messageHandler.addToRolePolicy(managementPolicy);\n    this.streamHandler.addToRolePolicy(managementPolicy);\n\n    // Set up WebSocket routes\n    this.webSocketApi.addRoute('$connect', {\n      integration: new apigatewayv2Integrations.WebSocketLambdaIntegration(\n        'ConnectIntegration',\n        this.connectHandler,\n      ),\n    });\n\n    this.webSocketApi.addRoute('$disconnect', {\n      integration: new apigatewayv2Integrations.WebSocketLambdaIntegration(\n        'DisconnectIntegration',\n        this.disconnectHandler,\n      ),\n    });\n\n    this.webSocketApi.addRoute('$default', {\n      integration: new apigatewayv2Integrations.WebSocketLambdaIntegration(\n        'DefaultIntegration',\n        this.messageHandler,\n      ),\n    });\n\n    // Set up DynamoDB stream processing for user tables\n    for (const table of props.tables) {\n      this.setupStreamProcessing(table);\n    }\n\n    // Output the WebSocket URL\n    new cdk.CfnOutput(this, 'WebSocketUrl', {\n      value: this.webSocketUrl,\n      description: 'WebSocket URL for reactive connections',\n    });\n  }\n\n  private setupStreamProcessing(table: AnyDynamoTable): void {\n    const tableArn = `arn:aws:dynamodb:${cdk.Stack.of(this).region}:${cdk.Stack.of(this).account}:table/${table.tableName}`;\n    const streamArn = `${tableArn}/stream/*`;\n\n    // Stream handler needs stream access\n    this.streamHandler.addToRolePolicy(\n      new iam.PolicyStatement({\n        actions: [\n          'dynamodb:GetRecords',\n          'dynamodb:GetShardIterator',\n          'dynamodb:DescribeStream',\n          'dynamodb:ListStreams',\n        ],\n        resources: [streamArn],\n      }),\n    );\n\n    // Both handlers need read access to user tables (including PartiQL for queries)\n    const tableReadPolicy = new iam.PolicyStatement({\n      actions: [\n        'dynamodb:Query',\n        'dynamodb:Scan',\n        'dynamodb:GetItem',\n        'dynamodb:BatchGetItem',\n        'dynamodb:PartiQLSelect',\n      ],\n      resources: [tableArn, `${tableArn}/index/*`],\n    });\n\n    this.streamHandler.addToRolePolicy(tableReadPolicy);\n    this.messageHandler.addToRolePolicy(tableReadPolicy);\n\n    // Message handler also needs write access for mutations\n    this.messageHandler.addToRolePolicy(\n      new iam.PolicyStatement({\n        actions: [\n          'dynamodb:PutItem',\n          'dynamodb:UpdateItem',\n          'dynamodb:DeleteItem',\n          'dynamodb:BatchWriteItem',\n          'dynamodb:PartiQLInsert',\n          'dynamodb:PartiQLUpdate',\n          'dynamodb:PartiQLDelete',\n        ],\n        resources: [tableArn, `${tableArn}/index/*`],\n      }),\n    );\n  }\n\n  public addTable(table: dynamodb.ITable): void {\n    if (!table.tableStreamArn) {\n      throw new Error(`Table ${table.tableName} does not have streams enabled`);\n    }\n\n    table.grantStreamRead(this.streamHandler);\n    table.grantReadData(this.streamHandler);\n\n    new lambda.EventSourceMapping(this, `Stream-${table.tableName}`, {\n      target: this.streamHandler,\n      eventSourceArn: table.tableStreamArn,\n      startingPosition: lambda.StartingPosition.TRIM_HORIZON,\n      batchSize: 100,\n      maxBatchingWindow: cdk.Duration.seconds(5),\n    });\n  }\n}\n","import * as cdk from 'aws-cdk-lib';\nimport type * as dynamodb from 'aws-cdk-lib/aws-dynamodb';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\nimport { Construct } from 'constructs';\n\n/**\n * Props for DynamoDBStreamSource\n */\nexport interface DynamoDBStreamSourceProps {\n  /**\n   * The DynamoDB table to create a stream source for\n   */\n  table: dynamodb.ITable;\n\n  /**\n   * The Lambda function to receive stream events\n   */\n  target: lambda.IFunction;\n\n  /**\n   * Batch size for stream processing\n   * @default 100\n   */\n  batchSize?: number;\n\n  /**\n   * Maximum batching window\n   * @default Duration.seconds(5)\n   */\n  maxBatchingWindow?: cdk.Duration;\n\n  /**\n   * Starting position for reading the stream\n   * @default TRIM_HORIZON\n   */\n  startingPosition?: lambda.StartingPosition;\n\n  /**\n   * Enable parallel processing with multiple batches\n   * @default 1\n   */\n  parallelizationFactor?: number;\n\n  /**\n   * Maximum record age to process\n   * @default Duration.days(1)\n   */\n  maxRecordAge?: cdk.Duration;\n\n  /**\n   * Number of retries on failure\n   * @default 3\n   */\n  retryAttempts?: number;\n\n  /**\n   * Filter patterns for the event source\n   */\n  filters?: lambda.FilterCriteria[];\n}\n\n/**\n * Helper construct for setting up DynamoDB stream event sources\n */\nexport class DynamoDBStreamSource extends Construct {\n  public readonly eventSourceMapping: lambda.EventSourceMapping;\n\n  constructor(scope: Construct, id: string, props: DynamoDBStreamSourceProps) {\n    super(scope, id);\n\n    const {\n      table,\n      target,\n      batchSize = 100,\n      maxBatchingWindow = cdk.Duration.seconds(5),\n      startingPosition = lambda.StartingPosition.TRIM_HORIZON,\n      parallelizationFactor = 1,\n      maxRecordAge = cdk.Duration.days(1),\n      retryAttempts = 3,\n      filters,\n    } = props;\n\n    if (!table.tableStreamArn) {\n      throw new Error(\n        `Table ${table.tableName} does not have DynamoDB Streams enabled. ` +\n          'Enable streams with streamSpecification when creating the table.',\n      );\n    }\n\n    // Grant stream read permissions\n    table.grantStreamRead(target);\n\n    // Create the event source mapping\n    this.eventSourceMapping = new lambda.EventSourceMapping(\n      this,\n      'EventSource',\n      {\n        target,\n        eventSourceArn: table.tableStreamArn,\n        startingPosition,\n        batchSize,\n        maxBatchingWindow,\n        parallelizationFactor,\n        maxRecordAge,\n        retryAttempts,\n        bisectBatchOnError: true,\n        reportBatchItemFailures: true,\n        filters,\n      },\n    );\n  }\n}\n\n/**\n * Create a filter criteria for DynamoDB streams\n */\nexport function createStreamFilter(options: {\n  /**\n   * Filter by event name (INSERT, MODIFY, REMOVE)\n   */\n  eventName?: ('INSERT' | 'MODIFY' | 'REMOVE')[];\n\n  /**\n   * Custom filter patterns\n   */\n  patterns?: Record<string, unknown>[];\n}): lambda.FilterCriteria[] {\n  const filters: Record<string, unknown>[] = [];\n\n  if (options.eventName) {\n    filters.push({\n      eventName: options.eventName,\n    });\n  }\n\n  if (options.patterns) {\n    filters.push(...options.patterns);\n  }\n\n  if (filters.length === 0) {\n    return [];\n  }\n\n  return [lambda.FilterCriteria.filter({ filters })];\n}\n"]}