@bywaretech/bysentinel-aws-lambda 0.1.0

package/dist/withBySentinel.js

@@ -0,0 +1,78 @@
+import { consumeColdStart, finishPerf, startPerf } from "./context.js";
+import { isCaptured } from "./dedupe.js";
+import { buildEvent } from "./event.js";
+import { resolveOptions } from "./options.js";
+import { runWithScope } from "./scope.js";
+import { deliver } from "./transport.js";
+/**
+ * Wrap a Lambda handler with BySentinel. On an unhandled exception it captures
+ * a sanitized event, then re-throws so the Lambda still fails as expected. On
+ * success it optionally reports performance metadata (timeout risk / memory).
+ *
+ * The wrapper never changes the handler's return value and never swallows the
+ * business error.
+ */
+export function withBySentinel(handler, options) {
+    const resolved = resolveOptions(options);
+    return async function bySentinelHandler(event, context) {
+        const coldStart = consumeColdStart();
+        const probe = startPerf(context);
+        const scope = {
+            options: resolved,
+            lambdaEvent: event,
+            lambdaContext: context,
+            coldStart,
+        };
+        return runWithScope(scope, async () => {
+            try {
+                const result = await handler(event, context);
+                // Success path: only emit an event when performance capture is on and a
+                // risk was detected, to avoid flooding the collector with healthy runs.
+                if (resolved.capture.performance) {
+                    const performance = finishPerf(probe, context, context?.memoryLimitInMB);
+                    if (performance.timeoutRisk) {
+                        const perfEvent = buildEvent({
+                            options: resolved,
+                            lambdaEvent: event,
+                            lambdaContext: context,
+                            coldStart,
+                            performance,
+                            timeline: scope.timeline?.hasSteps ? scope.timeline.finish() : undefined,
+                            customContext: { kind: "performance-warning" },
+                        });
+                        await deliver(resolved, perfEvent);
+                    }
+                }
+                return result;
+            }
+            catch (error) {
+                // Already reported by a manual captureException in the handler — don't
+                // double-count. Re-throw so the Lambda still fails.
+                if (isCaptured(error))
+                    throw error;
+                const performance = resolved.capture.performance
+                    ? finishPerf(probe, context, context?.memoryLimitInMB)
+                    : undefined;
+                // Finalize the timeline as aborted so the failed step is visible.
+                const timeline = scope.timeline?.hasSteps
+                    ? (scope.timeline.fail(), scope.timeline.toJSON(true))
+                    : undefined;
+                const errorEvent = buildEvent({
+                    options: resolved,
+                    lambdaEvent: event,
+                    lambdaContext: context,
+                    coldStart,
+                    error,
+                    performance,
+                    timeline,
+                });
+                // Bounded, fail-silent delivery. We await so the event actually leaves
+                // the container before Lambda freezes it, but delivery is time-capped.
+                await deliver(resolved, errorEvent);
+                // Never swallow the business error.
+                throw error;
+            }
+        });
+    };
+}
+//# sourceMappingURL=withBySentinel.js.map

package/dist/withBySentinel.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@bywaretech/bysentinel-aws-lambda",
+  "version": "0.1.0",
+  "description": "AI Runtime Monitoring SDK for AWS Lambda",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bywaretech/bysentinel.git",
+    "directory": "packages/aws-lambda"
+  },
+  "homepage": "https://github.com/bywaretech/bysentinel/tree/main/packages/aws-lambda#readme",
+  "bugs": {
+    "url": "https://github.com/bywaretech/bysentinel/issues"
+  },
+  "keywords": [
+    "bysentinel",
+    "aws-lambda",
+    "lambda",
+    "serverless",
+    "observability",
+    "ai-debugging",
+    "error-tracking",
+    "security"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@bywaretech/bysentinel-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/aws-lambda": "^8.10.140",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist .turbo coverage"
+  }
+}