effortless-aws 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -600,4 +600,43 @@ type HttpHandler<T = undefined, C = undefined, D = undefined, P = undefined> = {
  */
 declare const defineHttp: <T = undefined, C = undefined, D extends Record<string, AnyTableHandler> | undefined = undefined, P extends Record<string, AnyParamRef> | undefined = undefined>(options: DefineHttpOptions<T, C, D, P>) => HttpHandler<T, C, D, P>;
 
-export { type DefineHttpOptions, type DefineTableOptions, type EffortlessConfig, type FailedRecord, type HttpConfig, type HttpHandler, type HttpHandlerFn, type HttpMethod, type HttpRequest, type HttpResponse, type KeyType, type ParamRef, type QueryParams, type ResolveDeps, type ResolveParams, type StreamView, type TableBatchCompleteFn, type TableBatchFn, type TableClient, type TableConfig, type TableHandler, type TableKey, type TableRecord, type TableRecordFn, defineConfig, defineHttp, defineTable, param };
+type BasePlatformEntity = {
+    pk: string;
+    sk: string;
+    type: string;
+    ttl?: number;
+};
+type ExecutionEntry = {
+    id: string;
+    ts: string;
+    ms: number;
+    in: unknown;
+    out?: unknown;
+};
+type ErrorEntry = {
+    id: string;
+    ts: string;
+    ms: number;
+    in: unknown;
+    err: string;
+};
+type ExecutionLogEntity = BasePlatformEntity & {
+    type: "execution-log";
+    handlerName: string;
+    handlerType: "http" | "table";
+    executions: ExecutionEntry[];
+    errors: ErrorEntry[];
+};
+type PlatformEntity = ExecutionLogEntity;
+
+type PlatformClient = {
+    appendExecution(handlerName: string, handlerType: "http" | "table", entry: ExecutionEntry): Promise<void>;
+    appendError(handlerName: string, handlerType: "http" | "table", entry: ErrorEntry): Promise<void>;
+    get<T extends PlatformEntity>(pk: string, sk: string): Promise<T | undefined>;
+    query<T extends PlatformEntity>(pk: string, skPrefix?: string): Promise<T[]>;
+    put(entity: PlatformEntity): Promise<void>;
+    tableName: string;
+};
+declare const createPlatformClient: () => PlatformClient | undefined;
+
+export { type BasePlatformEntity, type DefineHttpOptions, type DefineTableOptions, type EffortlessConfig, type ErrorEntry, type ExecutionEntry, type ExecutionLogEntity, type FailedRecord, type HttpConfig, type HttpHandler, type HttpHandlerFn, type HttpMethod, type HttpRequest, type HttpResponse, type KeyType, type ParamRef, type PlatformClient, type PlatformEntity, type QueryParams, type ResolveDeps, type ResolveParams, type StreamView, type TableBatchCompleteFn, type TableBatchFn, type TableClient, type TableConfig, type TableHandler, type TableKey, type TableRecord, type TableRecordFn, createPlatformClient, defineConfig, defineHttp, defineTable, param };

package/dist/index.js

@@ -39,7 +39,99 @@ var param = (key, transform) => ({
   key,
   ...transform ? { transform } : {}
 });
+
+// src/runtime/platform-client.ts
+import { DynamoDB } from "@aws-sdk/client-dynamodb";
+import { marshall, unmarshall } from "@aws-sdk/util-dynamodb";
+
+// src/runtime/platform-types.ts
+var ENV_PLATFORM_TABLE = "EFF_PLATFORM_TABLE";
+var DEFAULT_TTL_SECONDS = 7 * 24 * 60 * 60;
+var dateBucket = (date = /* @__PURE__ */ new Date()) => date.toISOString().slice(0, 10);
+var computeTtl = (ttlSeconds = DEFAULT_TTL_SECONDS) => Math.floor(Date.now() / 1e3) + ttlSeconds;
+
+// src/runtime/platform-client.ts
+var createPlatformClient = () => {
+  const tableName = process.env[ENV_PLATFORM_TABLE];
+  if (!tableName) return void 0;
+  let client = null;
+  const getClient = () => client ??= new DynamoDB({});
+  const appendToList = async (handlerName, handlerType, listAttr, entry) => {
+    const sk = `EXEC#${dateBucket()}`;
+    try {
+      await getClient().updateItem({
+        TableName: tableName,
+        Key: marshall({ pk: `HANDLER#${handlerName}`, sk }),
+        UpdateExpression: "SET #list = list_append(if_not_exists(#list, :empty), :entry), #type = :type, #hn = :hn, #ht = :ht, #ttl = :ttl",
+        ExpressionAttributeNames: {
+          "#list": listAttr,
+          "#type": "type",
+          "#hn": "handlerName",
+          "#ht": "handlerType",
+          "#ttl": "ttl"
+        },
+        ExpressionAttributeValues: marshall(
+          {
+            ":entry": [entry],
+            ":empty": [],
+            ":type": "execution-log",
+            ":hn": handlerName,
+            ":ht": handlerType,
+            ":ttl": computeTtl()
+          },
+          { removeUndefinedValues: true }
+        )
+      });
+    } catch (err) {
+      console.error("[effortless] Failed to write platform record:", err);
+    }
+  };
+  return {
+    tableName,
+    async appendExecution(handlerName, handlerType, entry) {
+      await appendToList(handlerName, handlerType, "executions", entry);
+    },
+    async appendError(handlerName, handlerType, entry) {
+      await appendToList(handlerName, handlerType, "errors", entry);
+    },
+    async get(pk, sk) {
+      const result = await getClient().getItem({
+        TableName: tableName,
+        Key: marshall({ pk, sk })
+      });
+      return result.Item ? unmarshall(result.Item) : void 0;
+    },
+    async query(pk, skPrefix) {
+      const names = { "#pk": "pk" };
+      const values = { ":pk": pk };
+      let keyCondition = "#pk = :pk";
+      if (skPrefix) {
+        names["#sk"] = "sk";
+        values[":sk"] = skPrefix;
+        keyCondition += " AND begins_with(#sk, :sk)";
+      }
+      const result = await getClient().query({
+        TableName: tableName,
+        KeyConditionExpression: keyCondition,
+        ExpressionAttributeNames: names,
+        ExpressionAttributeValues: marshall(values, { removeUndefinedValues: true })
+      });
+      return (result.Items ?? []).map((item) => unmarshall(item));
+    },
+    async put(entity) {
+      try {
+        await getClient().putItem({
+          TableName: tableName,
+          Item: marshall(entity, { removeUndefinedValues: true })
+        });
+      } catch (err) {
+        console.error("[effortless] Failed to write platform record:", err);
+      }
+    }
+  };
+};
 export {
+  createPlatformClient,
   defineConfig,
   defineHttp,
   defineTable,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config.ts","../src/handlers/define-http.ts","../src/handlers/define-table.ts","../src/handlers/param.ts"],"sourcesContent":["/**\n * Configuration for an Effortless project.\n *\n * @example\n * ```typescript\n * // effortless.config.ts\n * import { defineConfig } from \"effortless-aws\";\n *\n * export default defineConfig({\n *   name: \"my-service\",\n *   region: \"eu-central-1\",\n *   handlers: \"src\",\n * });\n * ```\n */\nexport type EffortlessConfig = {\n  /**\n   * Project name used for resource naming and tagging.\n   * This becomes part of Lambda function names, IAM roles, etc.\n   */\n  name: string;\n\n  /**\n   * Default AWS region for all handlers.\n   * Can be overridden per-handler or via CLI `--region` flag.\n   * @default \"eu-central-1\"\n   */\n  region?: string;\n\n  /**\n   * Deployment stage (e.g., \"dev\", \"staging\", \"prod\").\n   * Used for resource isolation and tagging.\n   * @default \"dev\"\n   */\n  stage?: string;\n\n  /**\n   * Glob patterns or directory paths to scan for handlers.\n   * Used by `eff deploy` (without file argument) to auto-discover handlers.\n   *\n   * @example\n   * ```typescript\n   * // Single directory - scans for all .ts files\n   * handlers: \"src\"\n   *\n   * // Glob patterns\n   * handlers: [\"src/**\\/*.ts\", \"lib/**\\/*.handler.ts\"]\n   * ```\n   */\n  handlers?: string | string[];\n\n  /**\n   * Default settings applied to all handlers unless overridden.\n   */\n  defaults?: {\n    /**\n     * Lambda memory in MB.\n     * @default 256\n     */\n    memory?: number;\n\n    /**\n     * Lambda timeout as a human-readable string.\n     * @example \"30 seconds\", \"5 minutes\"\n     */\n    timeout?: string;\n\n    /**\n     * Lambda runtime.\n     * @default \"nodejs22.x\"\n     */\n    runtime?: string;\n  };\n};\n\n/**\n * Helper function for type-safe configuration.\n * Returns the config object as-is, but provides TypeScript autocompletion.\n *\n * @example\n * ```typescript\n * import { defineConfig } from \"effortless-aws\";\n *\n * export default defineConfig({\n *   name: \"my-service\",\n *   region: \"eu-central-1\",\n *   handlers: \"src\",\n * });\n * ```\n */\nexport const defineConfig = (config: EffortlessConfig): EffortlessConfig => config;\n","import type { Permission } from \"./permissions\";\nimport type { TableHandler } from \"./define-table\";\nimport type { TableClient } from \"../runtime/table-client\";\nimport type { AnyParamRef, ResolveParams } from \"./param\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyTableHandler = TableHandler<any, any, any, any, any>;\n\n/** Maps a deps declaration to resolved runtime client types */\nexport type ResolveDeps<D> = {\n  [K in keyof D]: D[K] extends TableHandler<infer T, any, any, any, any> ? TableClient<T> : never;\n};\n\n/** HTTP methods supported by API Gateway */\nexport type HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n\n/**\n * Incoming HTTP request object passed to the handler\n */\nexport type HttpRequest = {\n  /** HTTP method (GET, POST, etc.) */\n  method: string;\n  /** Request path (e.g., \"/users/123\") */\n  path: string;\n  /** Request headers */\n  headers: Record<string, string | undefined>;\n  /** Query string parameters */\n  query: Record<string, string | undefined>;\n  /** Path parameters extracted from route (e.g., {id} -> params.id) */\n  params: Record<string, string | undefined>;\n  /** Parsed request body (JSON parsed if Content-Type is application/json) */\n  body: unknown;\n  /** Raw unparsed request body */\n  rawBody?: string;\n};\n\n/**\n * HTTP response returned from the handler\n */\nexport type HttpResponse = {\n  /** HTTP status code (e.g., 200, 404, 500) */\n  status: number;\n  /** Response body (will be JSON serialized) */\n  body?: unknown;\n  /** Response headers */\n  headers?: Record<string, string>;\n};\n\n/**\n * Configuration options extracted from DefineHttpOptions (without onRequest callback)\n */\nexport type HttpConfig = {\n  /** Handler name. Defaults to export name if not specified */\n  name?: string;\n  /** HTTP method for the route */\n  method: HttpMethod;\n  /** Route path (e.g., \"/api/users\", \"/api/users/{id}\") */\n  path: string;\n  /** Lambda memory in MB (default: 256) */\n  memory?: number;\n  /** Lambda timeout in seconds (default: 30) */\n  timeout?: number;\n  /** Additional IAM permissions for the Lambda */\n  permissions?: Permission[];\n};\n\n/**\n * Handler function type for HTTP endpoints\n *\n * @typeParam T - Type of the validated request body (from schema function)\n * @typeParam C - Type of the context/dependencies (from context function)\n * @typeParam D - Type of the deps (from deps declaration)\n * @typeParam P - Type of the params (from params declaration)\n */\nexport type HttpHandlerFn<T = undefined, C = undefined, D = undefined, P = undefined> =\n  (args: { req: HttpRequest }\n    & ([T] extends [undefined] ? {} : { data: T })\n    & ([C] extends [undefined] ? {} : { ctx: C })\n    & ([D] extends [undefined] ? {} : { deps: ResolveDeps<D> })\n    & ([P] extends [undefined] ? {} : { params: ResolveParams<P> })\n  ) => Promise<HttpResponse>;\n\n/**\n * Context factory type — conditional on whether params are declared.\n * Without params: `() => C | Promise<C>`\n * With params: `(args: { params: ResolveParams<P> }) => C | Promise<C>`\n */\ntype ContextFactory<C, P> = [P] extends [undefined]\n  ? () => C | Promise<C>\n  : (args: { params: ResolveParams<P & {}> }) => C | Promise<C>;\n\n/**\n * Options for defining an HTTP endpoint\n *\n * @typeParam T - Type of the validated request body (inferred from schema function)\n * @typeParam C - Type of the context/dependencies returned by context function\n * @typeParam D - Type of the deps (from deps declaration)\n * @typeParam P - Type of the params (from params declaration)\n */\nexport type DefineHttpOptions<\n  T = undefined,\n  C = undefined,\n  D extends Record<string, AnyTableHandler> | undefined = undefined,\n  P extends Record<string, AnyParamRef> | undefined = undefined\n> = HttpConfig & {\n  /**\n   * Decode/validate function for the request body.\n   * Called with the parsed body; should return typed data or throw on validation failure.\n   * When provided, the handler receives validated `data` and invalid requests get a 400 response.\n   *\n   * Works with any validation library:\n   * - Effect: `S.decodeUnknownSync(MySchema)`\n   * - Zod: `(body) => myZodSchema.parse(body)`\n   */\n  schema?: (input: unknown) => T;\n  /**\n   * Error handler called when schema validation or onRequest throws.\n   * Receives the error and request, returns an HttpResponse.\n   * If not provided, defaults to 400 for validation errors and 500 for handler errors.\n   */\n  onError?: (error: unknown, req: HttpRequest) => HttpResponse;\n  /**\n   * Factory function to create context/dependencies for the request handler.\n   * Called once on cold start, result is cached and reused across invocations.\n   * When params are declared, receives resolved params as argument.\n   * Supports both sync and async return values.\n   */\n  context?: ContextFactory<C, P>;\n  /**\n   * Dependencies on other handlers (tables, queues, etc.).\n   * Typed clients are injected into the handler via the `deps` argument.\n   */\n  deps?: D;\n  /**\n   * SSM Parameter Store parameters.\n   * Declare with `param()` helper. Values are fetched and cached at cold start.\n   * Typed values are injected into the handler via the `params` argument.\n   */\n  params?: P;\n  /** HTTP request handler function */\n  onRequest: HttpHandlerFn<T, C, D, P>;\n};\n\n/**\n * Internal handler object created by defineHttp\n * @internal\n */\nexport type HttpHandler<T = undefined, C = undefined, D = undefined, P = undefined> = {\n  readonly __brand: \"effortless-http\";\n  readonly config: HttpConfig;\n  readonly schema?: (input: unknown) => T;\n  readonly onError?: (error: unknown, req: HttpRequest) => HttpResponse;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly context?: (...args: any[]) => C | Promise<C>;\n  readonly deps?: D;\n  readonly params?: P;\n  readonly onRequest: HttpHandlerFn<T, C, D, P>;\n};\n\n/**\n * Define an HTTP endpoint that creates an API Gateway route + Lambda function\n *\n * @typeParam T - Type of the validated request body (inferred from schema function)\n * @typeParam C - Type of the context/dependencies (inferred from context function)\n * @typeParam D - Type of the deps (from deps declaration)\n * @typeParam P - Type of the params (from params declaration)\n * @param options - Configuration, optional schema, optional context factory, and request handler\n * @returns Handler object used by the deployment system\n *\n * @example Basic GET endpoint\n * ```typescript\n * export const hello = defineHttp({\n *   method: \"GET\",\n *   path: \"/hello\",\n *   onRequest: async ({ req }) => ({\n *     status: 200,\n *     body: { message: \"Hello World!\" }\n *   })\n * });\n * ```\n *\n * @example With SSM parameters\n * ```typescript\n * import { param } from \"effortless-aws\";\n *\n * export const api = defineHttp({\n *   method: \"GET\",\n *   path: \"/orders\",\n *   params: {\n *     dbUrl: param(\"database-url\"),\n *   },\n *   context: async ({ params }) => ({\n *     pool: createPool(params.dbUrl),\n *   }),\n *   onRequest: async ({ req, ctx, params }) => ({\n *     status: 200,\n *     body: { dbUrl: params.dbUrl }\n *   })\n * });\n * ```\n */\nexport const defineHttp = <\n  T = undefined,\n  C = undefined,\n  D extends Record<string, AnyTableHandler> | undefined = undefined,\n  P extends Record<string, AnyParamRef> | undefined = undefined\n>(\n  options: DefineHttpOptions<T, C, D, P>\n): HttpHandler<T, C, D, P> => {\n  const { onRequest, onError, context, schema, deps, params, ...config } = options;\n  return {\n    __brand: \"effortless-http\",\n    config,\n    ...(schema ? { schema } : {}),\n    ...(onError ? { onError } : {}),\n    ...(context ? { context } : {}),\n    ...(deps ? { deps } : {}),\n    ...(params ? { params } : {}),\n    onRequest\n  } as HttpHandler<T, C, D, P>;\n};\n","import type { Permission } from \"./permissions\";\nimport type { TableClient } from \"../runtime/table-client\";\nimport type { AnyParamRef, ResolveParams } from \"./param\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyTableHandler = TableHandler<any, any, any, any, any>;\n\n/** Maps a deps declaration to resolved runtime client types */\ntype ResolveDeps<D> = {\n  [K in keyof D]: D[K] extends TableHandler<infer T, any, any, any, any> ? TableClient<T> : never;\n};\n\n/** DynamoDB attribute types for keys */\nexport type KeyType = \"string\" | \"number\" | \"binary\";\n\n/**\n * DynamoDB table key definition\n */\nexport type TableKey = {\n  /** Attribute name */\n  name: string;\n  /** Attribute type */\n  type: KeyType;\n};\n\n/** DynamoDB Streams view type - determines what data is captured in stream records */\nexport type StreamView = \"NEW_AND_OLD_IMAGES\" | \"NEW_IMAGE\" | \"OLD_IMAGE\" | \"KEYS_ONLY\";\n\n/**\n * Configuration options extracted from DefineTableOptions (without onRecord/context)\n */\nexport type TableConfig = {\n  /** Table/handler name. Defaults to export name if not specified */\n  name?: string;\n  /** Partition key definition */\n  pk: TableKey;\n  /** Sort key definition (optional) */\n  sk?: TableKey;\n  /** DynamoDB billing mode (default: \"PAY_PER_REQUEST\") */\n  billingMode?: \"PAY_PER_REQUEST\" | \"PROVISIONED\";\n  /** TTL attribute name for automatic item expiration */\n  ttlAttribute?: string;\n  /** Stream view type - what data to include in stream records (default: \"NEW_AND_OLD_IMAGES\") */\n  streamView?: StreamView;\n  /** Number of records to process in each Lambda invocation (1-10000, default: 100) */\n  batchSize?: number;\n  /** Maximum time in seconds to gather records before invoking (0-300, default: 2) */\n  batchWindow?: number;\n  /** Where to start reading the stream (default: \"LATEST\") */\n  startingPosition?: \"LATEST\" | \"TRIM_HORIZON\";\n  /** Lambda memory in MB (default: 256) */\n  memory?: number;\n  /** Lambda timeout in seconds (default: 30) */\n  timeout?: number;\n  /** Additional IAM permissions for the Lambda */\n  permissions?: Permission[];\n};\n\n/**\n * DynamoDB stream record passed to onRecord callback\n *\n * @typeParam T - Type of the table items (new/old values)\n */\nexport type TableRecord<T = Record<string, unknown>> = {\n  /** Type of modification: INSERT, MODIFY, or REMOVE */\n  eventName: \"INSERT\" | \"MODIFY\" | \"REMOVE\";\n  /** New item value (present for INSERT and MODIFY) */\n  new?: T;\n  /** Old item value (present for MODIFY and REMOVE) */\n  old?: T;\n  /** Primary key of the affected item */\n  keys: Record<string, unknown>;\n  /** Sequence number for ordering */\n  sequenceNumber?: string;\n  /** Approximate timestamp when the modification occurred */\n  timestamp?: number;\n};\n\n/**\n * Information about a failed record during batch processing\n *\n * @typeParam T - Type of the table items\n */\nexport type FailedRecord<T = Record<string, unknown>> = {\n  /** The record that failed to process */\n  record: TableRecord<T>;\n  /** The error that occurred */\n  error: unknown;\n};\n\n/**\n * Context factory type — conditional on whether params are declared.\n * Without params: `() => C | Promise<C>`\n * With params: `(args: { params: ResolveParams<P> }) => C | Promise<C>`\n */\ntype ContextFactory<C, P> = [P] extends [undefined]\n  ? () => C | Promise<C>\n  : (args: { params: ResolveParams<P & {}> }) => C | Promise<C>;\n\n/**\n * Callback function type for processing a single DynamoDB stream record\n */\nexport type TableRecordFn<T = Record<string, unknown>, C = undefined, R = void, D = undefined, P = undefined> =\n  (args: { record: TableRecord<T>; table: TableClient<T> }\n    & ([C] extends [undefined] ? {} : { ctx: C })\n    & ([D] extends [undefined] ? {} : { deps: ResolveDeps<D> })\n    & ([P] extends [undefined] ? {} : { params: ResolveParams<P> })\n  ) => Promise<R>;\n\n/**\n * Callback function type for processing accumulated batch results\n */\nexport type TableBatchCompleteFn<T = Record<string, unknown>, C = undefined, R = void, D = undefined, P = undefined> =\n  (args: { results: R[]; failures: FailedRecord<T>[]; table: TableClient<T> }\n    & ([C] extends [undefined] ? {} : { ctx: C })\n    & ([D] extends [undefined] ? {} : { deps: ResolveDeps<D> })\n    & ([P] extends [undefined] ? {} : { params: ResolveParams<P> })\n  ) => Promise<void>;\n\n/**\n * Callback function type for processing all records in a batch at once\n */\nexport type TableBatchFn<T = Record<string, unknown>, C = undefined, D = undefined, P = undefined> =\n  (args: { records: TableRecord<T>[]; table: TableClient<T> }\n    & ([C] extends [undefined] ? {} : { ctx: C })\n    & ([D] extends [undefined] ? {} : { deps: ResolveDeps<D> })\n    & ([P] extends [undefined] ? {} : { params: ResolveParams<P> })\n  ) => Promise<void>;\n\n/** Base options shared by all defineTable variants */\ntype DefineTableBase<T = Record<string, unknown>, C = undefined, D = undefined, P = undefined> = TableConfig & {\n  /**\n   * Decode/validate function for stream record items (new/old images).\n   * Called with the unmarshalled DynamoDB item; should return typed data or throw on validation failure.\n   * When provided, T is inferred from the return type — no need to specify generic parameters.\n   */\n  schema?: (input: unknown) => T;\n  /**\n   * Error handler called when onRecord, onBatch, or onBatchComplete throws.\n   * Receives the error. If not provided, defaults to `console.error`.\n   */\n  onError?: (error: unknown) => void;\n  /**\n   * Factory function to create context/dependencies for callbacks.\n   * Called once on cold start, result is cached and reused across invocations.\n   * When params are declared, receives resolved params as argument.\n   * Supports both sync and async return values.\n   */\n  context?: ContextFactory<C, P>;\n  /**\n   * Dependencies on other handlers (tables, queues, etc.).\n   * Typed clients are injected into the handler via the `deps` argument.\n   */\n  deps?: D;\n  /**\n   * SSM Parameter Store parameters.\n   * Declare with `param()` helper. Values are fetched and cached at cold start.\n   * Typed values are injected into the handler via the `params` argument.\n   */\n  params?: P;\n};\n\n/** Per-record processing: onRecord with optional onBatchComplete */\ntype DefineTableWithOnRecord<T = Record<string, unknown>, C = undefined, R = void, D = undefined, P = undefined> = DefineTableBase<T, C, D, P> & {\n  onRecord: TableRecordFn<T, C, R, D, P>;\n  onBatchComplete?: TableBatchCompleteFn<T, C, R, D, P>;\n  onBatch?: never;\n};\n\n/** Batch processing: onBatch processes all records at once */\ntype DefineTableWithOnBatch<T = Record<string, unknown>, C = undefined, D = undefined, P = undefined> = DefineTableBase<T, C, D, P> & {\n  onBatch: TableBatchFn<T, C, D, P>;\n  onRecord?: never;\n  onBatchComplete?: never;\n};\n\n/** Resource-only: no handler, just creates the table */\ntype DefineTableResourceOnly<T = Record<string, unknown>, C = undefined, D = undefined, P = undefined> = DefineTableBase<T, C, D, P> & {\n  onRecord?: never;\n  onBatch?: never;\n  onBatchComplete?: never;\n};\n\nexport type DefineTableOptions<\n  T = Record<string, unknown>,\n  C = undefined,\n  R = void,\n  D extends Record<string, AnyTableHandler> | undefined = undefined,\n  P extends Record<string, AnyParamRef> | undefined = undefined\n> =\n  | DefineTableWithOnRecord<T, C, R, D, P>\n  | DefineTableWithOnBatch<T, C, D, P>\n  | DefineTableResourceOnly<T, C, D, P>;\n\n/**\n * Internal handler object created by defineTable\n * @internal\n */\nexport type TableHandler<T = Record<string, unknown>, C = undefined, R = void, D = undefined, P = undefined> = {\n  readonly __brand: \"effortless-table\";\n  readonly config: TableConfig;\n  readonly schema?: (input: unknown) => T;\n  readonly onError?: (error: unknown) => void;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly context?: (...args: any[]) => C | Promise<C>;\n  readonly deps?: D;\n  readonly params?: P;\n  readonly onRecord?: TableRecordFn<T, C, R, D, P>;\n  readonly onBatchComplete?: TableBatchCompleteFn<T, C, R, D, P>;\n  readonly onBatch?: TableBatchFn<T, C, D, P>;\n};\n\n/**\n * Define a DynamoDB table with optional stream handler\n *\n * Creates:\n * - DynamoDB table with specified key schema\n * - (If onRecord or onBatch provided) DynamoDB Stream + Lambda + Event Source Mapping\n *\n * @example Table with stream handler (typed)\n * ```typescript\n * type Order = { id: string; amount: number; status: string };\n *\n * export const orders = defineTable<Order>({\n *   pk: { name: \"id\", type: \"string\" },\n *   streamView: \"NEW_AND_OLD_IMAGES\",\n *   batchSize: 10,\n *   onRecord: async ({ record }) => {\n *     if (record.eventName === \"INSERT\") {\n *       console.log(\"New order:\", record.new?.amount);\n *     }\n *   }\n * });\n * ```\n *\n * @example Table only (no Lambda)\n * ```typescript\n * export const users = defineTable({\n *   pk: { name: \"id\", type: \"string\" },\n *   sk: { name: \"email\", type: \"string\" }\n * });\n * ```\n */\nexport const defineTable = <\n  T = Record<string, unknown>,\n  C = undefined,\n  R = void,\n  D extends Record<string, AnyTableHandler> | undefined = undefined,\n  P extends Record<string, AnyParamRef> | undefined = undefined\n>(\n  options: DefineTableOptions<T, C, R, D, P>\n): TableHandler<T, C, R, D, P> => {\n  const { onRecord, onBatchComplete, onBatch, onError, schema, context, deps, params, ...config } = options;\n  return {\n    __brand: \"effortless-table\",\n    config,\n    ...(schema ? { schema } : {}),\n    ...(onError ? { onError } : {}),\n    ...(context ? { context } : {}),\n    ...(deps ? { deps } : {}),\n    ...(params ? { params } : {}),\n    ...(onRecord ? { onRecord } : {}),\n    ...(onBatchComplete ? { onBatchComplete } : {}),\n    ...(onBatch ? { onBatch } : {})\n  } as TableHandler<T, C, R, D, P>;\n};\n","// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyParamRef = ParamRef<any>;\n\n/**\n * Reference to an SSM Parameter Store parameter.\n *\n * @typeParam T - The resolved type after optional transform (default: string)\n */\nexport type ParamRef<T = string> = {\n  readonly __brand: \"effortless-param\";\n  readonly key: string;\n  readonly transform?: (raw: string) => T;\n};\n\n/**\n * Maps a params declaration to resolved value types.\n *\n * @typeParam P - Record of param names to ParamRef instances\n */\nexport type ResolveParams<P> = {\n  [K in keyof P]: P[K] extends ParamRef<infer T> ? T : never;\n};\n\n/**\n * Declare an SSM Parameter Store parameter.\n *\n * The key is combined with project and stage at deploy time to form the full\n * SSM path: `/${project}/${stage}/${key}`.\n *\n * @param key - Parameter key (e.g., \"database-url\")\n * @param transform - Optional function to transform the raw string value\n * @returns A ParamRef used by the deployment and runtime systems\n *\n * @example Simple string parameter\n * ```typescript\n * params: {\n *   dbUrl: param(\"database-url\"),\n * }\n * ```\n *\n * @example With transform (e.g., TOML parsing)\n * ```typescript\n * import TOML from \"smol-toml\";\n *\n * params: {\n *   config: param(\"app-config\", TOML.parse),\n * }\n * ```\n */\nexport const param = <T = string>(\n  key: string,\n  transform?: (raw: string) => T\n): ParamRef<T> => ({\n  __brand: \"effortless-param\",\n  key,\n  ...(transform ? { transform } : {}),\n});\n"],"mappings":";AA0FO,IAAM,eAAe,CAAC,WAA+C;;;AC+GrE,IAAM,aAAa,CAMxB,YAC4B;AAC5B,QAAM,EAAE,WAAW,SAAS,SAAS,QAAQ,MAAM,QAAQ,GAAG,OAAO,IAAI;AACzE,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,IAC3B,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7B,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7B,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,IACvB,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,IAC3B;AAAA,EACF;AACF;;;ACuBO,IAAM,cAAc,CAOzB,YACgC;AAChC,QAAM,EAAE,UAAU,iBAAiB,SAAS,SAAS,QAAQ,SAAS,MAAM,QAAQ,GAAG,OAAO,IAAI;AAClG,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,IAC3B,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7B,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7B,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,IACvB,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,IAC3B,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;AAAA,IAC/B,GAAI,kBAAkB,EAAE,gBAAgB,IAAI,CAAC;AAAA,IAC7C,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EAC/B;AACF;;;ACxNO,IAAM,QAAQ,CACnB,KACA,eACiB;AAAA,EACjB,SAAS;AAAA,EACT;AAAA,EACA,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;AACnC;","names":[]}
+{"version":3,"sources":["../src/config.ts","../src/handlers/define-http.ts","../src/handlers/define-table.ts","../src/handlers/param.ts","../src/runtime/platform-client.ts","../src/runtime/platform-types.ts"],"sourcesContent":["/**\n * Configuration for an Effortless project.\n *\n * @example\n * ```typescript\n * // effortless.config.ts\n * import { defineConfig } from \"effortless-aws\";\n *\n * export default defineConfig({\n *   name: \"my-service\",\n *   region: \"eu-central-1\",\n *   handlers: \"src\",\n * });\n * ```\n */\nexport type EffortlessConfig = {\n  /**\n   * Project name used for resource naming and tagging.\n   * This becomes part of Lambda function names, IAM roles, etc.\n   */\n  name: string;\n\n  /**\n   * Default AWS region for all handlers.\n   * Can be overridden per-handler or via CLI `--region` flag.\n   * @default \"eu-central-1\"\n   */\n  region?: string;\n\n  /**\n   * Deployment stage (e.g., \"dev\", \"staging\", \"prod\").\n   * Used for resource isolation and tagging.\n   * @default \"dev\"\n   */\n  stage?: string;\n\n  /**\n   * Glob patterns or directory paths to scan for handlers.\n   * Used by `eff deploy` (without file argument) to auto-discover handlers.\n   *\n   * @example\n   * ```typescript\n   * // Single directory - scans for all .ts files\n   * handlers: \"src\"\n   *\n   * // Glob patterns\n   * handlers: [\"src/**\\/*.ts\", \"lib/**\\/*.handler.ts\"]\n   * ```\n   */\n  handlers?: string | string[];\n\n  /**\n   * Default settings applied to all handlers unless overridden.\n   */\n  defaults?: {\n    /**\n     * Lambda memory in MB.\n     * @default 256\n     */\n    memory?: number;\n\n    /**\n     * Lambda timeout as a human-readable string.\n     * @example \"30 seconds\", \"5 minutes\"\n     */\n    timeout?: string;\n\n    /**\n     * Lambda runtime.\n     * @default \"nodejs22.x\"\n     */\n    runtime?: string;\n  };\n};\n\n/**\n * Helper function for type-safe configuration.\n * Returns the config object as-is, but provides TypeScript autocompletion.\n *\n * @example\n * ```typescript\n * import { defineConfig } from \"effortless-aws\";\n *\n * export default defineConfig({\n *   name: \"my-service\",\n *   region: \"eu-central-1\",\n *   handlers: \"src\",\n * });\n * ```\n */\nexport const defineConfig = (config: EffortlessConfig): EffortlessConfig => config;\n","import type { Permission } from \"./permissions\";\nimport type { TableHandler } from \"./define-table\";\nimport type { TableClient } from \"../runtime/table-client\";\nimport type { AnyParamRef, ResolveParams } from \"./param\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyTableHandler = TableHandler<any, any, any, any, any>;\n\n/** Maps a deps declaration to resolved runtime client types */\nexport type ResolveDeps<D> = {\n  [K in keyof D]: D[K] extends TableHandler<infer T, any, any, any, any> ? TableClient<T> : never;\n};\n\n/** HTTP methods supported by API Gateway */\nexport type HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n\n/**\n * Incoming HTTP request object passed to the handler\n */\nexport type HttpRequest = {\n  /** HTTP method (GET, POST, etc.) */\n  method: string;\n  /** Request path (e.g., \"/users/123\") */\n  path: string;\n  /** Request headers */\n  headers: Record<string, string | undefined>;\n  /** Query string parameters */\n  query: Record<string, string | undefined>;\n  /** Path parameters extracted from route (e.g., {id} -> params.id) */\n  params: Record<string, string | undefined>;\n  /** Parsed request body (JSON parsed if Content-Type is application/json) */\n  body: unknown;\n  /** Raw unparsed request body */\n  rawBody?: string;\n};\n\n/**\n * HTTP response returned from the handler\n */\nexport type HttpResponse = {\n  /** HTTP status code (e.g., 200, 404, 500) */\n  status: number;\n  /** Response body (will be JSON serialized) */\n  body?: unknown;\n  /** Response headers */\n  headers?: Record<string, string>;\n};\n\n/**\n * Configuration options extracted from DefineHttpOptions (without onRequest callback)\n */\nexport type HttpConfig = {\n  /** Handler name. Defaults to export name if not specified */\n  name?: string;\n  /** HTTP method for the route */\n  method: HttpMethod;\n  /** Route path (e.g., \"/api/users\", \"/api/users/{id}\") */\n  path: string;\n  /** Lambda memory in MB (default: 256) */\n  memory?: number;\n  /** Lambda timeout in seconds (default: 30) */\n  timeout?: number;\n  /** Additional IAM permissions for the Lambda */\n  permissions?: Permission[];\n};\n\n/**\n * Handler function type for HTTP endpoints\n *\n * @typeParam T - Type of the validated request body (from schema function)\n * @typeParam C - Type of the context/dependencies (from context function)\n * @typeParam D - Type of the deps (from deps declaration)\n * @typeParam P - Type of the params (from params declaration)\n */\nexport type HttpHandlerFn<T = undefined, C = undefined, D = undefined, P = undefined> =\n  (args: { req: HttpRequest }\n    & ([T] extends [undefined] ? {} : { data: T })\n    & ([C] extends [undefined] ? {} : { ctx: C })\n    & ([D] extends [undefined] ? {} : { deps: ResolveDeps<D> })\n    & ([P] extends [undefined] ? {} : { params: ResolveParams<P> })\n  ) => Promise<HttpResponse>;\n\n/**\n * Context factory type — conditional on whether params are declared.\n * Without params: `() => C | Promise<C>`\n * With params: `(args: { params: ResolveParams<P> }) => C | Promise<C>`\n */\ntype ContextFactory<C, P> = [P] extends [undefined]\n  ? () => C | Promise<C>\n  : (args: { params: ResolveParams<P & {}> }) => C | Promise<C>;\n\n/**\n * Options for defining an HTTP endpoint\n *\n * @typeParam T - Type of the validated request body (inferred from schema function)\n * @typeParam C - Type of the context/dependencies returned by context function\n * @typeParam D - Type of the deps (from deps declaration)\n * @typeParam P - Type of the params (from params declaration)\n */\nexport type DefineHttpOptions<\n  T = undefined,\n  C = undefined,\n  D extends Record<string, AnyTableHandler> | undefined = undefined,\n  P extends Record<string, AnyParamRef> | undefined = undefined\n> = HttpConfig & {\n  /**\n   * Decode/validate function for the request body.\n   * Called with the parsed body; should return typed data or throw on validation failure.\n   * When provided, the handler receives validated `data` and invalid requests get a 400 response.\n   *\n   * Works with any validation library:\n   * - Effect: `S.decodeUnknownSync(MySchema)`\n   * - Zod: `(body) => myZodSchema.parse(body)`\n   */\n  schema?: (input: unknown) => T;\n  /**\n   * Error handler called when schema validation or onRequest throws.\n   * Receives the error and request, returns an HttpResponse.\n   * If not provided, defaults to 400 for validation errors and 500 for handler errors.\n   */\n  onError?: (error: unknown, req: HttpRequest) => HttpResponse;\n  /**\n   * Factory function to create context/dependencies for the request handler.\n   * Called once on cold start, result is cached and reused across invocations.\n   * When params are declared, receives resolved params as argument.\n   * Supports both sync and async return values.\n   */\n  context?: ContextFactory<C, P>;\n  /**\n   * Dependencies on other handlers (tables, queues, etc.).\n   * Typed clients are injected into the handler via the `deps` argument.\n   */\n  deps?: D;\n  /**\n   * SSM Parameter Store parameters.\n   * Declare with `param()` helper. Values are fetched and cached at cold start.\n   * Typed values are injected into the handler via the `params` argument.\n   */\n  params?: P;\n  /** HTTP request handler function */\n  onRequest: HttpHandlerFn<T, C, D, P>;\n};\n\n/**\n * Internal handler object created by defineHttp\n * @internal\n */\nexport type HttpHandler<T = undefined, C = undefined, D = undefined, P = undefined> = {\n  readonly __brand: \"effortless-http\";\n  readonly config: HttpConfig;\n  readonly schema?: (input: unknown) => T;\n  readonly onError?: (error: unknown, req: HttpRequest) => HttpResponse;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly context?: (...args: any[]) => C | Promise<C>;\n  readonly deps?: D;\n  readonly params?: P;\n  readonly onRequest: HttpHandlerFn<T, C, D, P>;\n};\n\n/**\n * Define an HTTP endpoint that creates an API Gateway route + Lambda function\n *\n * @typeParam T - Type of the validated request body (inferred from schema function)\n * @typeParam C - Type of the context/dependencies (inferred from context function)\n * @typeParam D - Type of the deps (from deps declaration)\n * @typeParam P - Type of the params (from params declaration)\n * @param options - Configuration, optional schema, optional context factory, and request handler\n * @returns Handler object used by the deployment system\n *\n * @example Basic GET endpoint\n * ```typescript\n * export const hello = defineHttp({\n *   method: \"GET\",\n *   path: \"/hello\",\n *   onRequest: async ({ req }) => ({\n *     status: 200,\n *     body: { message: \"Hello World!\" }\n *   })\n * });\n * ```\n *\n * @example With SSM parameters\n * ```typescript\n * import { param } from \"effortless-aws\";\n *\n * export const api = defineHttp({\n *   method: \"GET\",\n *   path: \"/orders\",\n *   params: {\n *     dbUrl: param(\"database-url\"),\n *   },\n *   context: async ({ params }) => ({\n *     pool: createPool(params.dbUrl),\n *   }),\n *   onRequest: async ({ req, ctx, params }) => ({\n *     status: 200,\n *     body: { dbUrl: params.dbUrl }\n *   })\n * });\n * ```\n */\nexport const defineHttp = <\n  T = undefined,\n  C = undefined,\n  D extends Record<string, AnyTableHandler> | undefined = undefined,\n  P extends Record<string, AnyParamRef> | undefined = undefined\n>(\n  options: DefineHttpOptions<T, C, D, P>\n): HttpHandler<T, C, D, P> => {\n  const { onRequest, onError, context, schema, deps, params, ...config } = options;\n  return {\n    __brand: \"effortless-http\",\n    config,\n    ...(schema ? { schema } : {}),\n    ...(onError ? { onError } : {}),\n    ...(context ? { context } : {}),\n    ...(deps ? { deps } : {}),\n    ...(params ? { params } : {}),\n    onRequest\n  } as HttpHandler<T, C, D, P>;\n};\n","import type { Permission } from \"./permissions\";\nimport type { TableClient } from \"../runtime/table-client\";\nimport type { AnyParamRef, ResolveParams } from \"./param\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyTableHandler = TableHandler<any, any, any, any, any>;\n\n/** Maps a deps declaration to resolved runtime client types */\ntype ResolveDeps<D> = {\n  [K in keyof D]: D[K] extends TableHandler<infer T, any, any, any, any> ? TableClient<T> : never;\n};\n\n/** DynamoDB attribute types for keys */\nexport type KeyType = \"string\" | \"number\" | \"binary\";\n\n/**\n * DynamoDB table key definition\n */\nexport type TableKey = {\n  /** Attribute name */\n  name: string;\n  /** Attribute type */\n  type: KeyType;\n};\n\n/** DynamoDB Streams view type - determines what data is captured in stream records */\nexport type StreamView = \"NEW_AND_OLD_IMAGES\" | \"NEW_IMAGE\" | \"OLD_IMAGE\" | \"KEYS_ONLY\";\n\n/**\n * Configuration options extracted from DefineTableOptions (without onRecord/context)\n */\nexport type TableConfig = {\n  /** Table/handler name. Defaults to export name if not specified */\n  name?: string;\n  /** Partition key definition */\n  pk: TableKey;\n  /** Sort key definition (optional) */\n  sk?: TableKey;\n  /** DynamoDB billing mode (default: \"PAY_PER_REQUEST\") */\n  billingMode?: \"PAY_PER_REQUEST\" | \"PROVISIONED\";\n  /** TTL attribute name for automatic item expiration */\n  ttlAttribute?: string;\n  /** Stream view type - what data to include in stream records (default: \"NEW_AND_OLD_IMAGES\") */\n  streamView?: StreamView;\n  /** Number of records to process in each Lambda invocation (1-10000, default: 100) */\n  batchSize?: number;\n  /** Maximum time in seconds to gather records before invoking (0-300, default: 2) */\n  batchWindow?: number;\n  /** Where to start reading the stream (default: \"LATEST\") */\n  startingPosition?: \"LATEST\" | \"TRIM_HORIZON\";\n  /** Lambda memory in MB (default: 256) */\n  memory?: number;\n  /** Lambda timeout in seconds (default: 30) */\n  timeout?: number;\n  /** Additional IAM permissions for the Lambda */\n  permissions?: Permission[];\n};\n\n/**\n * DynamoDB stream record passed to onRecord callback\n *\n * @typeParam T - Type of the table items (new/old values)\n */\nexport type TableRecord<T = Record<string, unknown>> = {\n  /** Type of modification: INSERT, MODIFY, or REMOVE */\n  eventName: \"INSERT\" | \"MODIFY\" | \"REMOVE\";\n  /** New item value (present for INSERT and MODIFY) */\n  new?: T;\n  /** Old item value (present for MODIFY and REMOVE) */\n  old?: T;\n  /** Primary key of the affected item */\n  keys: Record<string, unknown>;\n  /** Sequence number for ordering */\n  sequenceNumber?: string;\n  /** Approximate timestamp when the modification occurred */\n  timestamp?: number;\n};\n\n/**\n * Information about a failed record during batch processing\n *\n * @typeParam T - Type of the table items\n */\nexport type FailedRecord<T = Record<string, unknown>> = {\n  /** The record that failed to process */\n  record: TableRecord<T>;\n  /** The error that occurred */\n  error: unknown;\n};\n\n/**\n * Context factory type — conditional on whether params are declared.\n * Without params: `() => C | Promise<C>`\n * With params: `(args: { params: ResolveParams<P> }) => C | Promise<C>`\n */\ntype ContextFactory<C, P> = [P] extends [undefined]\n  ? () => C | Promise<C>\n  : (args: { params: ResolveParams<P & {}> }) => C | Promise<C>;\n\n/**\n * Callback function type for processing a single DynamoDB stream record\n */\nexport type TableRecordFn<T = Record<string, unknown>, C = undefined, R = void, D = undefined, P = undefined> =\n  (args: { record: TableRecord<T>; table: TableClient<T> }\n    & ([C] extends [undefined] ? {} : { ctx: C })\n    & ([D] extends [undefined] ? {} : { deps: ResolveDeps<D> })\n    & ([P] extends [undefined] ? {} : { params: ResolveParams<P> })\n  ) => Promise<R>;\n\n/**\n * Callback function type for processing accumulated batch results\n */\nexport type TableBatchCompleteFn<T = Record<string, unknown>, C = undefined, R = void, D = undefined, P = undefined> =\n  (args: { results: R[]; failures: FailedRecord<T>[]; table: TableClient<T> }\n    & ([C] extends [undefined] ? {} : { ctx: C })\n    & ([D] extends [undefined] ? {} : { deps: ResolveDeps<D> })\n    & ([P] extends [undefined] ? {} : { params: ResolveParams<P> })\n  ) => Promise<void>;\n\n/**\n * Callback function type for processing all records in a batch at once\n */\nexport type TableBatchFn<T = Record<string, unknown>, C = undefined, D = undefined, P = undefined> =\n  (args: { records: TableRecord<T>[]; table: TableClient<T> }\n    & ([C] extends [undefined] ? {} : { ctx: C })\n    & ([D] extends [undefined] ? {} : { deps: ResolveDeps<D> })\n    & ([P] extends [undefined] ? {} : { params: ResolveParams<P> })\n  ) => Promise<void>;\n\n/** Base options shared by all defineTable variants */\ntype DefineTableBase<T = Record<string, unknown>, C = undefined, D = undefined, P = undefined> = TableConfig & {\n  /**\n   * Decode/validate function for stream record items (new/old images).\n   * Called with the unmarshalled DynamoDB item; should return typed data or throw on validation failure.\n   * When provided, T is inferred from the return type — no need to specify generic parameters.\n   */\n  schema?: (input: unknown) => T;\n  /**\n   * Error handler called when onRecord, onBatch, or onBatchComplete throws.\n   * Receives the error. If not provided, defaults to `console.error`.\n   */\n  onError?: (error: unknown) => void;\n  /**\n   * Factory function to create context/dependencies for callbacks.\n   * Called once on cold start, result is cached and reused across invocations.\n   * When params are declared, receives resolved params as argument.\n   * Supports both sync and async return values.\n   */\n  context?: ContextFactory<C, P>;\n  /**\n   * Dependencies on other handlers (tables, queues, etc.).\n   * Typed clients are injected into the handler via the `deps` argument.\n   */\n  deps?: D;\n  /**\n   * SSM Parameter Store parameters.\n   * Declare with `param()` helper. Values are fetched and cached at cold start.\n   * Typed values are injected into the handler via the `params` argument.\n   */\n  params?: P;\n};\n\n/** Per-record processing: onRecord with optional onBatchComplete */\ntype DefineTableWithOnRecord<T = Record<string, unknown>, C = undefined, R = void, D = undefined, P = undefined> = DefineTableBase<T, C, D, P> & {\n  onRecord: TableRecordFn<T, C, R, D, P>;\n  onBatchComplete?: TableBatchCompleteFn<T, C, R, D, P>;\n  onBatch?: never;\n};\n\n/** Batch processing: onBatch processes all records at once */\ntype DefineTableWithOnBatch<T = Record<string, unknown>, C = undefined, D = undefined, P = undefined> = DefineTableBase<T, C, D, P> & {\n  onBatch: TableBatchFn<T, C, D, P>;\n  onRecord?: never;\n  onBatchComplete?: never;\n};\n\n/** Resource-only: no handler, just creates the table */\ntype DefineTableResourceOnly<T = Record<string, unknown>, C = undefined, D = undefined, P = undefined> = DefineTableBase<T, C, D, P> & {\n  onRecord?: never;\n  onBatch?: never;\n  onBatchComplete?: never;\n};\n\nexport type DefineTableOptions<\n  T = Record<string, unknown>,\n  C = undefined,\n  R = void,\n  D extends Record<string, AnyTableHandler> | undefined = undefined,\n  P extends Record<string, AnyParamRef> | undefined = undefined\n> =\n  | DefineTableWithOnRecord<T, C, R, D, P>\n  | DefineTableWithOnBatch<T, C, D, P>\n  | DefineTableResourceOnly<T, C, D, P>;\n\n/**\n * Internal handler object created by defineTable\n * @internal\n */\nexport type TableHandler<T = Record<string, unknown>, C = undefined, R = void, D = undefined, P = undefined> = {\n  readonly __brand: \"effortless-table\";\n  readonly config: TableConfig;\n  readonly schema?: (input: unknown) => T;\n  readonly onError?: (error: unknown) => void;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly context?: (...args: any[]) => C | Promise<C>;\n  readonly deps?: D;\n  readonly params?: P;\n  readonly onRecord?: TableRecordFn<T, C, R, D, P>;\n  readonly onBatchComplete?: TableBatchCompleteFn<T, C, R, D, P>;\n  readonly onBatch?: TableBatchFn<T, C, D, P>;\n};\n\n/**\n * Define a DynamoDB table with optional stream handler\n *\n * Creates:\n * - DynamoDB table with specified key schema\n * - (If onRecord or onBatch provided) DynamoDB Stream + Lambda + Event Source Mapping\n *\n * @example Table with stream handler (typed)\n * ```typescript\n * type Order = { id: string; amount: number; status: string };\n *\n * export const orders = defineTable<Order>({\n *   pk: { name: \"id\", type: \"string\" },\n *   streamView: \"NEW_AND_OLD_IMAGES\",\n *   batchSize: 10,\n *   onRecord: async ({ record }) => {\n *     if (record.eventName === \"INSERT\") {\n *       console.log(\"New order:\", record.new?.amount);\n *     }\n *   }\n * });\n * ```\n *\n * @example Table only (no Lambda)\n * ```typescript\n * export const users = defineTable({\n *   pk: { name: \"id\", type: \"string\" },\n *   sk: { name: \"email\", type: \"string\" }\n * });\n * ```\n */\nexport const defineTable = <\n  T = Record<string, unknown>,\n  C = undefined,\n  R = void,\n  D extends Record<string, AnyTableHandler> | undefined = undefined,\n  P extends Record<string, AnyParamRef> | undefined = undefined\n>(\n  options: DefineTableOptions<T, C, R, D, P>\n): TableHandler<T, C, R, D, P> => {\n  const { onRecord, onBatchComplete, onBatch, onError, schema, context, deps, params, ...config } = options;\n  return {\n    __brand: \"effortless-table\",\n    config,\n    ...(schema ? { schema } : {}),\n    ...(onError ? { onError } : {}),\n    ...(context ? { context } : {}),\n    ...(deps ? { deps } : {}),\n    ...(params ? { params } : {}),\n    ...(onRecord ? { onRecord } : {}),\n    ...(onBatchComplete ? { onBatchComplete } : {}),\n    ...(onBatch ? { onBatch } : {})\n  } as TableHandler<T, C, R, D, P>;\n};\n","// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyParamRef = ParamRef<any>;\n\n/**\n * Reference to an SSM Parameter Store parameter.\n *\n * @typeParam T - The resolved type after optional transform (default: string)\n */\nexport type ParamRef<T = string> = {\n  readonly __brand: \"effortless-param\";\n  readonly key: string;\n  readonly transform?: (raw: string) => T;\n};\n\n/**\n * Maps a params declaration to resolved value types.\n *\n * @typeParam P - Record of param names to ParamRef instances\n */\nexport type ResolveParams<P> = {\n  [K in keyof P]: P[K] extends ParamRef<infer T> ? T : never;\n};\n\n/**\n * Declare an SSM Parameter Store parameter.\n *\n * The key is combined with project and stage at deploy time to form the full\n * SSM path: `/${project}/${stage}/${key}`.\n *\n * @param key - Parameter key (e.g., \"database-url\")\n * @param transform - Optional function to transform the raw string value\n * @returns A ParamRef used by the deployment and runtime systems\n *\n * @example Simple string parameter\n * ```typescript\n * params: {\n *   dbUrl: param(\"database-url\"),\n * }\n * ```\n *\n * @example With transform (e.g., TOML parsing)\n * ```typescript\n * import TOML from \"smol-toml\";\n *\n * params: {\n *   config: param(\"app-config\", TOML.parse),\n * }\n * ```\n */\nexport const param = <T = string>(\n  key: string,\n  transform?: (raw: string) => T\n): ParamRef<T> => ({\n  __brand: \"effortless-param\",\n  key,\n  ...(transform ? { transform } : {}),\n});\n","import { DynamoDB } from \"@aws-sdk/client-dynamodb\";\nimport { marshall, unmarshall } from \"@aws-sdk/util-dynamodb\";\nimport type {\n  PlatformEntity,\n  ExecutionEntry,\n  ErrorEntry,\n} from \"./platform-types\";\nimport {\n  ENV_PLATFORM_TABLE,\n  dateBucket,\n  computeTtl,\n} from \"./platform-types\";\n\nexport type PlatformClient = {\n  appendExecution(handlerName: string, handlerType: \"http\" | \"table\", entry: ExecutionEntry): Promise<void>;\n  appendError(handlerName: string, handlerType: \"http\" | \"table\", entry: ErrorEntry): Promise<void>;\n  get<T extends PlatformEntity>(pk: string, sk: string): Promise<T | undefined>;\n  query<T extends PlatformEntity>(pk: string, skPrefix?: string): Promise<T[]>;\n  put(entity: PlatformEntity): Promise<void>;\n  tableName: string;\n};\n\nexport const createPlatformClient = (): PlatformClient | undefined => {\n  const tableName = process.env[ENV_PLATFORM_TABLE];\n  if (!tableName) return undefined;\n\n  let client: DynamoDB | null = null;\n  const getClient = () => (client ??= new DynamoDB({}));\n\n  const appendToList = async (\n    handlerName: string,\n    handlerType: \"http\" | \"table\",\n    listAttr: \"executions\" | \"errors\",\n    entry: ExecutionEntry | ErrorEntry\n  ): Promise<void> => {\n    const sk = `EXEC#${dateBucket()}`;\n\n    try {\n      await getClient().updateItem({\n        TableName: tableName,\n        Key: marshall({ pk: `HANDLER#${handlerName}`, sk }),\n        UpdateExpression:\n          \"SET #list = list_append(if_not_exists(#list, :empty), :entry), \" +\n          \"#type = :type, #hn = :hn, #ht = :ht, #ttl = :ttl\",\n        ExpressionAttributeNames: {\n          \"#list\": listAttr,\n          \"#type\": \"type\",\n          \"#hn\": \"handlerName\",\n          \"#ht\": \"handlerType\",\n          \"#ttl\": \"ttl\",\n        },\n        ExpressionAttributeValues: marshall(\n          {\n            \":entry\": [entry],\n            \":empty\": [],\n            \":type\": \"execution-log\",\n            \":hn\": handlerName,\n            \":ht\": handlerType,\n            \":ttl\": computeTtl(),\n          },\n          { removeUndefinedValues: true }\n        ),\n      });\n    } catch (err) {\n      console.error(\"[effortless] Failed to write platform record:\", err);\n    }\n  };\n\n  return {\n    tableName,\n\n    async appendExecution(handlerName, handlerType, entry) {\n      await appendToList(handlerName, handlerType, \"executions\", entry);\n    },\n\n    async appendError(handlerName, handlerType, entry) {\n      await appendToList(handlerName, handlerType, \"errors\", entry);\n    },\n\n    async get<T extends PlatformEntity>(pk: string, sk: string): Promise<T | undefined> {\n      const result = await getClient().getItem({\n        TableName: tableName,\n        Key: marshall({ pk, sk }),\n      });\n      return result.Item ? (unmarshall(result.Item) as T) : undefined;\n    },\n\n    async query<T extends PlatformEntity>(pk: string, skPrefix?: string): Promise<T[]> {\n      const names: Record<string, string> = { \"#pk\": \"pk\" };\n      const values: Record<string, unknown> = { \":pk\": pk };\n      let keyCondition = \"#pk = :pk\";\n\n      if (skPrefix) {\n        names[\"#sk\"] = \"sk\";\n        values[\":sk\"] = skPrefix;\n        keyCondition += \" AND begins_with(#sk, :sk)\";\n      }\n\n      const result = await getClient().query({\n        TableName: tableName,\n        KeyConditionExpression: keyCondition,\n        ExpressionAttributeNames: names,\n        ExpressionAttributeValues: marshall(values, { removeUndefinedValues: true }),\n      });\n\n      return (result.Items ?? []).map(item => unmarshall(item) as T);\n    },\n\n    async put(entity: PlatformEntity) {\n      try {\n        await getClient().putItem({\n          TableName: tableName,\n          Item: marshall(entity as Record<string, unknown>, { removeUndefinedValues: true }),\n        });\n      } catch (err) {\n        console.error(\"[effortless] Failed to write platform record:\", err);\n      }\n    },\n  };\n};\n","export const ENV_PLATFORM_TABLE = \"EFF_PLATFORM_TABLE\";\n\nexport const DEFAULT_TTL_SECONDS = 7 * 24 * 60 * 60; // 7 days\n\n// ============ Base ============\n\nexport type BasePlatformEntity = {\n  pk: string;\n  sk: string;\n  type: string;\n  ttl?: number;\n};\n\n// ============ Execution Log ============\n\nexport type ExecutionEntry = {\n  id: string;\n  ts: string;\n  ms: number;\n  in: unknown;\n  out?: unknown;\n};\n\nexport type ErrorEntry = {\n  id: string;\n  ts: string;\n  ms: number;\n  in: unknown;\n  err: string;\n};\n\nexport type ExecutionLogEntity = BasePlatformEntity & {\n  type: \"execution-log\";\n  handlerName: string;\n  handlerType: \"http\" | \"table\";\n  executions: ExecutionEntry[];\n  errors: ErrorEntry[];\n};\n\n// ============ Discriminated Union ============\n\nexport type PlatformEntity =\n  | ExecutionLogEntity;\n  // future: | IdempotencyEntity | HandlerMetaEntity\n\n// ============ Helpers ============\n\nexport const truncateForStorage = (value: unknown, maxLength = 4096): unknown => {\n  if (value === undefined || value === null) return value;\n  const str = typeof value === \"string\" ? value : JSON.stringify(value);\n  if (str.length <= maxLength) return value;\n  return str.slice(0, maxLength) + \"...[truncated]\";\n};\n\nexport const dateBucket = (date = new Date()): string =>\n  date.toISOString().slice(0, 10);\n\nexport const computeTtl = (ttlSeconds = DEFAULT_TTL_SECONDS): number =>\n  Math.floor(Date.now() / 1000) + ttlSeconds;\n"],"mappings":"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","names":[]}

package/dist/runtime/wrap-http.js

@@ -1,7 +1,7 @@
 import {
-  buildDeps,
-  buildParams
-} from "../chunk-I5TS7O5S.js";
+  createHandlerRuntime,
+  truncateForStorage
+} from "../chunk-7JVA4742.js";
 
 // src/runtime/wrap-http.ts
 var parseBody = (body, isBase64) => {
@@ -14,24 +14,25 @@ var parseBody = (body, isBase64) => {
   }
 };
 var wrapHttp = (handler) => {
-  let ctx = null;
-  let resolvedDeps;
-  let resolvedParams = null;
-  const getDeps = () => resolvedDeps ??= buildDeps(handler.deps);
-  const getParams = async () => {
-    if (resolvedParams !== null) return resolvedParams;
-    resolvedParams = await buildParams(handler.params);
-    return resolvedParams;
-  };
-  const getCtx = async () => {
-    if (ctx !== null) return ctx;
-    if (handler.context) {
-      const params = await getParams();
-      ctx = params ? await handler.context({ params }) : await handler.context();
-    }
-    return ctx;
+  const rt = createHandlerRuntime(handler, "http");
+  const toResult = (r) => ({
+    statusCode: r.status,
+    headers: { "Content-Type": "application/json", ...r.headers },
+    body: JSON.stringify(r.body)
+  });
+  const defaultError = (error, status) => {
+    console.error(`[effortless:${rt.handlerName}]`, error);
+    return {
+      statusCode: status,
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        error: status === 400 ? "Validation failed" : "Internal server error",
+        details: error instanceof Error ? error.message : String(error)
+      })
+    };
   };
   return async (event) => {
+    const startTime = Date.now();
     const req = {
       method: event.requestContext?.http?.method ?? event.httpMethod ?? "GET",
       path: event.requestContext?.http?.path ?? event.path ?? "/",
@@ -41,42 +42,23 @@ var wrapHttp = (handler) => {
       body: parseBody(event.body, event.isBase64Encoded ?? false),
       rawBody: event.body
     };
-    const toResult = (r) => ({
-      statusCode: r.status,
-      headers: { "Content-Type": "application/json", ...r.headers },
-      body: JSON.stringify(r.body)
-    });
-    const defaultError = (error, status) => ({
-      statusCode: status,
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        error: status === 400 ? "Validation failed" : "Internal server error",
-        details: error instanceof Error ? error.message : String(error)
-      })
-    });
+    const input = truncateForStorage({ method: req.method, path: req.path, query: req.query, body: req.body });
     const args = { req };
     if (handler.schema) {
       try {
         args.data = handler.schema(req.body);
       } catch (error) {
+        rt.logError(startTime, input, error);
         return handler.onError ? toResult(handler.onError(error, req)) : defaultError(error, 400);
       }
     }
-    if (handler.context) {
-      args.ctx = await getCtx();
-    }
-    const deps = getDeps();
-    if (deps) {
-      args.deps = deps;
-    }
-    const params = await getParams();
-    if (params) {
-      args.params = params;
-    }
+    Object.assign(args, await rt.commonArgs());
     try {
       const response = await handler.onRequest(args);
+      rt.logExecution(startTime, input, response.body);
       return toResult(response);
     } catch (error) {
+      rt.logError(startTime, input, error);
       return handler.onError ? toResult(handler.onError(error, req)) : defaultError(error, 500);
     }
   };

package/dist/runtime/wrap-table-stream.js

@@ -1,8 +1,8 @@
 import {
-  buildDeps,
-  buildParams,
-  createTableClient
-} from "../chunk-I5TS7O5S.js";
+  createHandlerRuntime,
+  createTableClient,
+  truncateForStorage
+} from "../chunk-7JVA4742.js";
 
 // src/runtime/wrap-table-stream.ts
 import { unmarshall } from "@aws-sdk/util-dynamodb";
@@ -29,29 +29,21 @@ var parseRecords = (rawRecords, schema) => {
   }
   return { records, sequenceNumbers };
 };
+var collectFailures = (records, sequenceNumbers) => {
+  const failures = [];
+  for (const record of records) {
+    const seq = sequenceNumbers.get(record);
+    if (seq) failures.push({ itemIdentifier: seq });
+  }
+  return failures;
+};
 var ENV_TABLE_SELF = "EFF_TABLE_SELF";
 var wrapTableStream = (handler) => {
   if (!handler.onRecord && !handler.onBatch) {
     throw new Error("wrapTableStream requires a handler with onRecord or onBatch defined");
   }
-  const handleError = handler.onError ?? ((e) => console.error(e));
-  let ctx = null;
-  let resolvedDeps;
-  let resolvedParams = null;
-  const getDeps = () => resolvedDeps ??= buildDeps(handler.deps);
-  const getParams = async () => {
-    if (resolvedParams !== null) return resolvedParams;
-    resolvedParams = await buildParams(handler.params);
-    return resolvedParams;
-  };
-  const getCtx = async () => {
-    if (ctx !== null) return ctx;
-    if (handler.context) {
-      const params = await getParams();
-      ctx = params ? await handler.context({ params }) : await handler.context();
-    }
-    return ctx;
-  };
+  const rt = createHandlerRuntime(handler, "table");
+  const handleError = handler.onError ?? ((e) => console.error(`[effortless:${rt.handlerName}]`, e));
   let selfClient = null;
   const getSelfClient = () => {
     if (selfClient) return selfClient;
@@ -60,81 +52,62 @@ var wrapTableStream = (handler) => {
     selfClient = createTableClient(tableName);
     return selfClient;
   };
-  const commonArgs = async () => {
-    const args = {};
-    if (handler.context) args.ctx = await getCtx();
-    const deps = getDeps();
-    if (deps) args.deps = deps;
-    const params = await getParams();
-    if (params) args.params = params;
-    const table = getSelfClient();
-    if (table) args.table = table;
-    return args;
-  };
   return async (event) => {
+    const startTime = Date.now();
     const rawRecords = event.Records ?? [];
+    const input = truncateForStorage({ recordCount: rawRecords.length });
     let records;
     let sequenceNumbers;
     try {
       ({ records, sequenceNumbers } = parseRecords(rawRecords, handler.schema));
     } catch (error) {
       handleError(error);
-      return {
-        batchItemFailures: rawRecords.map((r) => r.dynamodb?.SequenceNumber).filter((s) => !!s).map((seq) => ({ itemIdentifier: seq }))
-      };
+      rt.logError(startTime, input, error);
+      return { batchItemFailures: rawRecords.map((r) => r.dynamodb?.SequenceNumber).filter((s) => !!s).map((seq) => ({ itemIdentifier: seq })) };
     }
+    const shared = { ...await rt.commonArgs(), table: getSelfClient() };
     const batchItemFailures = [];
     if (handler.onBatch) {
       try {
-        const onBatch = handler.onBatch;
-        await onBatch({ records, ...await commonArgs() });
+        await handler.onBatch({ records, ...shared });
       } catch (error) {
         handleError(error);
-        for (const record of records) {
-          const seq = sequenceNumbers.get(record);
-          if (seq) {
-            batchItemFailures.push({ itemIdentifier: seq });
-          }
-        }
+        batchItemFailures.push(...collectFailures(records, sequenceNumbers));
       }
-      return { batchItemFailures };
-    }
-    const results = [];
-    const failures = [];
-    const onRecord = handler.onRecord;
-    const shared = await commonArgs();
-    for (const record of records) {
-      try {
-        const result = await onRecord({ record, ...shared });
-        if (result !== void 0) {
-          results.push(result);
-        }
-      } catch (error) {
-        handleError(error);
-        failures.push({ record, error });
-        const seq = sequenceNumbers.get(record);
-        if (seq) {
-          batchItemFailures.push({ itemIdentifier: seq });
+    } else {
+      const results = [];
+      const failures = [];
+      const onRecord = handler.onRecord;
+      for (const record of records) {
+        try {
+          const result = await onRecord({ record, ...shared });
+          if (result !== void 0) results.push(result);
+        } catch (error) {
+          handleError(error);
+          failures.push({ record, error });
+          const seq = sequenceNumbers.get(record);
+          if (seq) batchItemFailures.push({ itemIdentifier: seq });
         }
       }
-    }
-    if (handler.onBatchComplete) {
-      try {
-        const onBatchComplete = handler.onBatchComplete;
-        await onBatchComplete({ results, failures, ...shared });
-      } catch (error) {
-        handleError(error);
-        for (const record of records) {
-          const seq = sequenceNumbers.get(record);
-          if (seq) {
-            const alreadyFailed = batchItemFailures.some((f) => f.itemIdentifier === seq);
-            if (!alreadyFailed) {
+      if (handler.onBatchComplete) {
+        try {
+          await handler.onBatchComplete({ results, failures, ...shared });
+        } catch (error) {
+          handleError(error);
+          for (const record of records) {
+            const seq = sequenceNumbers.get(record);
+            if (seq && !batchItemFailures.some((f) => f.itemIdentifier === seq)) {
               batchItemFailures.push({ itemIdentifier: seq });
             }
           }
         }
       }
     }
+    if (batchItemFailures.length > 0) {
+      rt.logError(startTime, input, `${batchItemFailures.length} record(s) failed`);
+    } else {
+      rt.logExecution(startTime, input, { processedCount: records.length });
+    }
     return { batchItemFailures };
   };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effortless-aws",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "type": "module",
   "description": "Code-first AWS Lambda framework",
@@ -39,7 +39,6 @@
     "@aws-sdk/client-resource-groups-tagging-api": "^3.975.0",
     "@aws-sdk/client-ssm": "^3.985.0",
     "@aws-sdk/util-dynamodb": "^3.975.0",
-    "@vercel/nft": "^1.3.0",
     "archiver": "^7.0.1",
     "esbuild": "^0.25.0",
     "glob": "^13.0.0",