qstd 0.3.18 → 0.3.19

package/dist/server/aws/lambda/domain.d.ts

@@ -13,5 +13,54 @@ export declare const createRestHandler: (fn: (event: import("aws-lambda").APIGat
  * @returns
  */
 export declare const createWebsocketHandler: (fn: (event: import("aws-lambda").APIGatewayProxyEvent) => Promise<_t.ApigwResult> | _t.ApigwResult) => (event: import("aws-lambda").APIGatewayProxyEvent) => Promise<_t.Response | _t.ApigwResult>;
-export declare const createSqsHandler: (fn: _t.SQSHandler) => (event: _t.SqsEvent, context: _t.SqsContext, callback: _t.SqsCallback) => void | Promise<void | import("aws-lambda").SQSBatchResponse>;
+/**
+ * Creates a batch failures tracker for SQS handlers.
+ * Provides a simple `add(id)` method instead of pushing objects.
+ *
+ * @example
+ * ```ts
+ * const failures = Lambda.withBatchFailures();
+ *
+ * for (const record of event.Records) {
+ *   try {
+ *     // process record
+ *   } catch (err) {
+ *     failures.add(record.messageId);
+ *   }
+ * }
+ *
+ * return { batchItemFailures: failures.items };
+ * ```
+ */
+export declare const withBatchFailures: () => {
+    /** Add a failed message by its ID */
+    add: (itemIdentifier: string) => void;
+    /** The failures array for the response */
+    items: import("aws-lambda").SQSBatchItemFailure[];
+};
+/**
+ * Creates a type-safe SQS handler that enforces returning `{ batchItemFailures }`.
+ *
+ * Provides:
+ * - **Compile-time safety**: TypeScript enforces the return type
+ * - **Runtime safety**: Validates response shape before returning
+ *
+ * @example
+ * ```ts
+ * export const handler = Lambda.createSqsHandler(async (event) => {
+ *   const failures = Lambda.withBatchFailures();
+ *
+ *   for (const record of event.Records) {
+ *     try {
+ *       // process record
+ *     } catch (err) {
+ *       failures.add(record.messageId);
+ *     }
+ *   }
+ *
+ *   return { batchItemFailures: failures.items };
+ * });
+ * ```
+ */
+export declare const createSqsHandler: (fn: _t.SqsHandlerFn) => _t.SqsHandlerFn;
 //# sourceMappingURL=domain.d.ts.map

package/dist/server/aws/lambda/domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAG9B;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,6GAeujD,kDAAQ,0CAfphD,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,2GAQkjD,gDAAQ,0CAP/iD,CAAC;AAE/C,eAAO,MAAM,gBAAgB,GAC1B,IAAI,EAAE,CAAC,UAAU,MACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,WAAW,iEAEpE,CAAC"}
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAG9B;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,6GA+E5B,kDACA,0CAhFuE,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,2GAwEjC,gDACA,0CAxE4C,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB;IAG1B,qCAAqC;0BACf,MAAM;IAG5B,0CAA0C;;CAG7C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,gBAAgB,GAC1B,IAAI,EAAE,CAAC,YAAY,KAAG,EAAE,CAAC,YAazB,CAAC"}

package/dist/server/aws/lambda/types.d.ts

@@ -1,4 +1,13 @@
-import type { APIGatewayProxyEvent, APIGatewayProxyEventV2, APIGatewayProxyResultV2, SQSHandler as AwsSqsHandler, SQSBatchResponse, Callback, Context, SQSEvent } from "aws-lambda";
+import type { APIGatewayProxyEvent, APIGatewayProxyEventV2, APIGatewayProxyResultV2, SQSHandler as AwsSqsHandler, SQSBatchItemFailure, SQSBatchResponse, Callback, Context, SQSEvent } from "aws-lambda";
+/** SQS batch response - return this from SQS handlers */
+export type SqsBatchResponse = SQSBatchResponse;
+/** Individual failure item - add to batchItemFailures array */
+export type SqsBatchItemFailure = SQSBatchItemFailure;
+/**
+ * Type-safe SQS handler that enforces returning { batchItemFailures }.
+ * Use with Lambda.createSqsHandler for compile + runtime safety.
+ */
+export type SqsHandlerFn = (event: SQSEvent) => Promise<SQSBatchResponse>;
 export type Response = {
     statusCode: number;
     headers: {

package/dist/server/aws/lambda/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,IAAI,aAAa,EAC3B,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,QAAQ,GAAG;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,6BAA6B,EAAE,MAAM,CAAC;QACtC,8BAA8B,EAAE,MAAM,CAAC;QACvC,8BAA8B,EAAE,MAAM,CAAC;QACvC,kCAAkC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtD,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAChC,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACzE,iBAAiB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAE9C,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAE/B,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;SAGK;IACL,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uGAAuG;IACvG,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,IAAI,aAAa,EAC3B,mBAAmB,EACnB,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEhD,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE1E,MAAM,MAAM,QAAQ,GAAG;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,6BAA6B,EAAE,MAAM,CAAC;QACtC,8BAA8B,EAAE,MAAM,CAAC;QACvC,8BAA8B,EAAE,MAAM,CAAC;QACvC,kCAAkC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtD,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAChC,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACzE,iBAAiB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAE9C,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAE/B,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;SAGK;IACL,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uGAAuG;IACvG,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC"}

package/dist/server/index.cjs

@@ -659,7 +659,8 @@ __export(lambda_exports, {
   createRestHandler: () => createRestHandler,
   createSqsHandler: () => createSqsHandler,
   createWebsocketHandler: () => createWebsocketHandler,
-  response: () => response
+  response: () => response,
+  withBatchFailures: () => withBatchFailures
 });
 
 // src/server/aws/lambda/literals.ts
@@ -728,8 +729,25 @@ var createHandlerFactory = () => (fn) => async (event) => {
 // src/server/aws/lambda/domain.ts
 var createRestHandler = createHandlerFactory();
 var createWebsocketHandler = createHandlerFactory();
-var createSqsHandler = (fn) => (event, context, callback) => {
-  return fn(event, context, callback);
+var withBatchFailures = () => {
+  const items = [];
+  return {
+    /** Add a failed message by its ID */
+    add: (itemIdentifier) => {
+      items.push({ itemIdentifier });
+    },
+    /** The failures array for the response */
+    items
+  };
+};
+var createSqsHandler = (fn) => async (event) => {
+  const result = await fn(event);
+  if (!result || !Array.isArray(result.batchItemFailures)) {
+    throw new Error(
+      "SQS handler must return { batchItemFailures: [] }. Return an empty array for success, or include failed messageIds for partial failures."
+    );
+  }
+  return result;
 };
 
 // src/server/aws/ddb/index.ts

package/dist/server/index.js

@@ -657,7 +657,8 @@ __export(lambda_exports, {
   createRestHandler: () => createRestHandler,
   createSqsHandler: () => createSqsHandler,
   createWebsocketHandler: () => createWebsocketHandler,
-  response: () => response
+  response: () => response,
+  withBatchFailures: () => withBatchFailures
 });
 
 // src/server/aws/lambda/literals.ts
@@ -726,8 +727,25 @@ var createHandlerFactory = () => (fn) => async (event) => {
 // src/server/aws/lambda/domain.ts
 var createRestHandler = createHandlerFactory();
 var createWebsocketHandler = createHandlerFactory();
-var createSqsHandler = (fn) => (event, context, callback) => {
-  return fn(event, context, callback);
+var withBatchFailures = () => {
+  const items = [];
+  return {
+    /** Add a failed message by its ID */
+    add: (itemIdentifier) => {
+      items.push({ itemIdentifier });
+    },
+    /** The failures array for the response */
+    items
+  };
+};
+var createSqsHandler = (fn) => async (event) => {
+  const result = await fn(event);
+  if (!result || !Array.isArray(result.batchItemFailures)) {
+    throw new Error(
+      "SQS handler must return { batchItemFailures: [] }. Return an empty array for success, or include failed messageIds for partial failures."
+    );
+  }
+  return result;
 };
 
 // src/server/aws/ddb/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qstd",
-  "version": "0.3.18",
+  "version": "0.3.19",
   "description": "Standard Block component and utilities library with Panda CSS",
   "author": "malin1",
   "license": "MIT",