glasswork 1.1.0 → 1.3.0

package/dist/sse/sse-broadcaster.js

@@ -0,0 +1,118 @@
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 15_000;
+const DEFAULT_MAX_BUFFERED_BYTES = 65_536;
+const CONNECTED_FRAME = 'retry: 3000\n: connected\n\n';
+const HEARTBEAT_FRAME = ': heartbeat\n\n';
+/**
+ * In-process, best-effort notifications for a single authorized audience.
+ * Mount stream() behind application middleware. Clients must refresh state on
+ * every connection: events are not persisted or replayed across reconnects.
+ */
+export class SseBroadcaster {
+    connections = new Set();
+    encoder = new TextEncoder();
+    heartbeatIntervalMs;
+    maxBufferedBytes;
+    isStopped = false;
+    constructor(options = {}) {
+        this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
+        this.maxBufferedBytes = options.maxBufferedBytes ?? DEFAULT_MAX_BUFFERED_BYTES;
+        if (!Number.isFinite(this.heartbeatIntervalMs) || this.heartbeatIntervalMs < 0) {
+            throw new RangeError('heartbeatIntervalMs must be a finite non-negative number');
+        }
+        if (!Number.isSafeInteger(this.maxBufferedBytes) || this.maxBufferedBytes < 64) {
+            throw new RangeError('maxBufferedBytes must be an integer of at least 64');
+        }
+    }
+    get clientCount() {
+        return this.connections.size;
+    }
+    /** Open an ordinary HTTP response; authentication/authorization belongs to the route. */
+    stream(context) {
+        if (this.isStopped) {
+            return context.body(null, 503);
+        }
+        let connection;
+        const body = new ReadableStream({
+            start: (controller) => {
+                connection = this.createConnection(controller, context.req.raw.signal);
+            },
+            cancel: () => connection?.cancel(),
+        }, { highWaterMark: this.maxBufferedBytes, size: (chunk) => chunk.byteLength });
+        context.header('Content-Type', 'text/event-stream; charset=utf-8');
+        context.header('Cache-Control', 'no-cache, no-transform');
+        context.header('X-Accel-Buffering', 'no');
+        return context.newResponse(body);
+    }
+    /** Serialize once and deliver without letting slow consumers block the publisher. */
+    broadcast(event, payload) {
+        if (!event || /[\r\n\0]/.test(event)) {
+            throw new TypeError('SSE event names must be non-empty and contain no CR, LF or NUL');
+        }
+        const data = JSON.stringify(payload);
+        if (data === undefined) {
+            throw new TypeError('SSE payload must be JSON serializable');
+        }
+        const frame = this.encoder.encode(`event: ${event}\ndata: ${data}\n\n`);
+        if (frame.byteLength > this.maxBufferedBytes) {
+            throw new RangeError('SSE event exceeds maxBufferedBytes');
+        }
+        for (const connection of this.connections) {
+            connection.send(frame);
+        }
+    }
+    /** Synchronous cleanup also works when a consumer never reads its response. */
+    onModuleDestroy() {
+        this.isStopped = true;
+        for (const connection of this.connections) {
+            connection.close();
+        }
+    }
+    createConnection(controller, signal) {
+        let isClosed = false;
+        let heartbeat;
+        const connection = {
+            cancel: () => {
+                if (isClosed) {
+                    return;
+                }
+                isClosed = true;
+                clearInterval(heartbeat);
+                signal.removeEventListener('abort', connection.close);
+                this.connections.delete(connection);
+            },
+            close: () => {
+                if (isClosed) {
+                    return;
+                }
+                connection.cancel();
+                // Close synchronously without waiting for the bounded queue to drain.
+                controller.close();
+            },
+            send: (frame) => {
+                if (isClosed) {
+                    return;
+                }
+                if ((controller.desiredSize ?? 0) < frame.byteLength) {
+                    connection.cancel();
+                    controller.error(new Error('SSE client exceeded its buffer limit'));
+                    return;
+                }
+                controller.enqueue(frame);
+            },
+        };
+        this.connections.add(connection);
+        signal.addEventListener('abort', connection.close, { once: true });
+        if (signal.aborted) {
+            connection.close();
+            return connection;
+        }
+        // Flush response headers and tell native EventSource how long to wait before retrying.
+        connection.send(this.encoder.encode(CONNECTED_FRAME));
+        if (this.heartbeatIntervalMs > 0) {
+            const frame = this.encoder.encode(HEARTBEAT_FRAME);
+            heartbeat = setInterval(() => connection.send(frame), this.heartbeatIntervalMs);
+        }
+        return connection;
+    }
+}
+//# sourceMappingURL=sse-broadcaster.js.map

package/dist/sse/sse-broadcaster.js.map

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

package/dist/utils/get-client-ip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-client-ip.d.ts","sourceRoot":"","sources":["../../src/utils/get-client-ip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAgC9C"}
+{"version":3,"file":"get-client-ip.d.ts","sourceRoot":"","sources":["../../src/utils/get-client-ip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAyB9C"}

package/dist/utils/get-client-ip.js

@@ -20,6 +20,9 @@
  * ```
  */
 export function getClientIp(c) {
+    const lambdaIp = getLambdaClientIp(c.env);
+    if (lambdaIp)
+        return lambdaIp;
     const trustProxy = c.get('trustProxy') === true;
     // Only honor proxy headers when explicitly trusted
     if (trustProxy) {
@@ -36,19 +39,25 @@ export function getClientIp(c) {
                 return trimmed;
         }
     }
-    // Try to get connection info (Node.js server)
-    try {
-        // Dynamic import to avoid bundling @hono/node-server in Lambda
-        // This will throw in non-Node environments
-        const { getConnInfo } = require('@hono/node-server/conninfo');
-        const info = getConnInfo(c);
-        if (info?.remote?.address) {
-            return info.remote.address;
-        }
-    }
-    catch {
-        // Not in Node.js environment or module not available
-    }
+    const nodeIp = getNodeClientIp(c.env);
+    if (nodeIp)
+        return nodeIp;
     return 'unknown';
 }
+function getLambdaClientIp(environment) {
+    if (!environment || typeof environment !== 'object')
+        return undefined;
+    const env = environment;
+    const sourceIp = env.requestContext?.http?.sourceIp ?? env.requestContext?.identity?.sourceIp;
+    return typeof sourceIp === 'string' && sourceIp.trim() ? sourceIp.trim() : undefined;
+}
+function getNodeClientIp(environment) {
+    if (!environment || typeof environment !== 'object')
+        return undefined;
+    const remoteAddress = environment
+        .incoming?.socket?.remoteAddress;
+    return typeof remoteAddress === 'string' && remoteAddress.trim()
+        ? remoteAddress.trim()
+        : undefined;
+}
 //# sourceMappingURL=get-client-ip.js.map

package/dist/utils/get-client-ip.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-client-ip.js","sourceRoot":"","sources":["../../src/utils/get-client-ip.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAEhD,mDAAmD;IACnD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACtD,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YAC/C,IAAI,EAAE;gBAAE,OAAO,EAAE,CAAC;QACpB,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,IAAI,CAAC;QACH,+DAA+D;QAC/D,2CAA2C;QAC3C,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"get-client-ip.js","sourceRoot":"","sources":["../../src/utils/get-client-ip.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAEhD,mDAAmD;IACnD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACtD,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YAC/C,IAAI,EAAE;gBAAE,OAAO,EAAE,CAAC;QACpB,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAoB;IAC7C,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEtE,MAAM,GAAG,GAAG,WAKX,CAAC;IACF,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC9F,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACvF,CAAC;AAED,SAAS,eAAe,CAAC,WAAoB;IAC3C,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEtE,MAAM,aAAa,GAAI,WAAuE;SAC3F,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC;IACnC,OAAO,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,EAAE;QAC9D,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE;QACtB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glasswork",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "A transparent, Lambda-optimized web framework for building OpenAPI-compliant REST APIs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -61,7 +61,12 @@
       "import": "./dist/audit/index.js",
       "default": "./dist/audit/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./sse": {
+      "types": "./dist/sse/index.d.ts",
+      "import": "./dist/sse/index.js",
+      "default": "./dist/sse/index.js"
+    }
   },
   "files": [
     "dist",
@@ -204,11 +209,13 @@
     "@types/node": "^26.5.0",
     "@vitest/coverage-v8": "^4.1.11",
     "awilix": "^13.0.5",
+    "better-auth": "^1.7.5",
     "dotenv": "^17.4.2",
     "hono": "^4.13.7",
     "hono-openapi": "^1.3.2",
     "mermaid": "^11.17.2",
     "mjml": "^5.4.0",
+    "postal-mime": "^2.7.6",
     "prisma": "7.10.0",
     "typescript": "^7.0.2",
     "valibot": "^1.4.2",
@@ -216,7 +223,8 @@
     "vitepress-plugin-llms": "^1.13.5",
     "vitepress-plugin-mermaid": "^2.0.17",
     "vitest": "^4.1.11",
-    "vue": "^3.5.42"
+    "vue": "^3.5.42",
+    "yaml": "^2.9.1"
   },
   "dependencies": {
     "@hono/standard-validator": "^0.2.3",

package/dist/jobs/observability/client.d.ts

@@ -1,26 +0,0 @@
-import type { FailedJobDTO, GetFailedJobsOptions, GetJobSummaryOptions, JobStatsSummaryDTO, JobsObservabilityClientOptions, JobTypeStatsDTO } from './types.js';
-/**
- * Interface for the background jobs observability client.
- */
-export interface JobsObservabilityClient {
-    /**
-     * Fetch an aggregated summary of background jobs over a time window.
-     */
-    getSummary(options?: GetJobSummaryOptions): Promise<JobStatsSummaryDTO>;
-    /**
-     * Fetch recent failed and dead-letter jobs with their error details.
-     */
-    getFailedJobs(options?: GetFailedJobsOptions): Promise<FailedJobDTO[]>;
-    /**
-     * Fetch detailed statistics for a specific job name.
-     */
-    getJobTypeStats(jobName: string, options?: GetJobSummaryOptions): Promise<JobTypeStatsDTO>;
-}
-/**
- * Create an observability client for querying background job metrics and execution logs.
- *
- * @param options - Configuration options including namespace, logGroupName, and region.
- * @returns A JobsObservabilityClient instance.
- */
-export declare function createJobsObservabilityClient(options?: JobsObservabilityClientOptions): JobsObservabilityClient;
-//# sourceMappingURL=client.d.ts.map

package/dist/jobs/observability/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/jobs/observability/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,8BAA8B,EAC9B,eAAe,EAChB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAExE;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEvE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5F;AAoND;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CA+JzB"}

package/dist/jobs/observability/client.js

@@ -1,286 +0,0 @@
-function createJobMetricStat(namespace, jobName, metricName, id, period, stat) {
-    return {
-        Id: id,
-        MetricStat: {
-            Metric: {
-                Namespace: namespace,
-                MetricName: metricName,
-                Dimensions: [{ Name: 'JobName', Value: jobName }],
-            },
-            Period: period,
-            Stat: stat,
-        },
-        ReturnData: true,
-    };
-}
-function buildMetricDataQueries(namespace, periodSeconds, jobNames) {
-    const queries = [
-        {
-            Id: 'm_total',
-            MetricStat: {
-                Metric: { Namespace: namespace, MetricName: 'JobCount' },
-                Period: periodSeconds,
-                Stat: 'Sum',
-            },
-            ReturnData: true,
-        },
-        {
-            Id: 'm_errors',
-            MetricStat: {
-                Metric: { Namespace: namespace, MetricName: 'JobErrorCount' },
-                Period: periodSeconds,
-                Stat: 'Sum',
-            },
-            ReturnData: true,
-        },
-        {
-            Id: 'm_retries',
-            MetricStat: {
-                Metric: { Namespace: namespace, MetricName: 'RetryCount' },
-                Period: periodSeconds,
-                Stat: 'Sum',
-            },
-            ReturnData: true,
-        },
-        {
-            Id: 'm_duration_avg',
-            MetricStat: {
-                Metric: { Namespace: namespace, MetricName: 'JobDuration' },
-                Period: periodSeconds,
-                Stat: 'Average',
-            },
-            ReturnData: true,
-        },
-        {
-            Id: 'm_duration_p95',
-            MetricStat: {
-                Metric: { Namespace: namespace, MetricName: 'JobDuration' },
-                Period: periodSeconds,
-                Stat: 'p95',
-            },
-            ReturnData: true,
-        },
-    ];
-    for (let i = 0; i < jobNames.length; i++) {
-        const name = jobNames[i];
-        if (!name)
-            continue;
-        queries.push(createJobMetricStat(namespace, name, 'JobCount', `j_${i}_total`, periodSeconds, 'Sum'), createJobMetricStat(namespace, name, 'JobErrorCount', `j_${i}_errors`, periodSeconds, 'Sum'), createJobMetricStat(namespace, name, 'RetryCount', `j_${i}_retries`, periodSeconds, 'Sum'), createJobMetricStat(namespace, name, 'JobDuration', `j_${i}_duration_avg`, periodSeconds, 'Average'), createJobMetricStat(namespace, name, 'JobDuration', `j_${i}_duration_p95`, periodSeconds, 'p95'));
-    }
-    return queries;
-}
-function extractJobTypeStats(resultMap, jobNames) {
-    const byJob = {};
-    for (let i = 0; i < jobNames.length; i++) {
-        const name = jobNames[i];
-        if (!name)
-            continue;
-        const count = resultMap.get(`j_${i}_total`) ?? 0;
-        const failedCount = resultMap.get(`j_${i}_errors`) ?? 0;
-        byJob[name] = {
-            jobName: name,
-            count,
-            succeededCount: Math.max(0, count - failedCount),
-            failedCount,
-            retryCount: resultMap.get(`j_${i}_retries`) ?? 0,
-            avgDurationMs: Math.round(resultMap.get(`j_${i}_duration_avg`) ?? 0),
-            p95DurationMs: Math.round(resultMap.get(`j_${i}_duration_p95`) ?? 0),
-        };
-    }
-    return byJob;
-}
-function parseMetricResults(metricResults, jobNames) {
-    const resultMap = new Map();
-    for (const res of metricResults ?? []) {
-        const val = res.Values && res.Values.length > 0 ? res.Values.reduce((a, b) => a + b, 0) : 0;
-        resultMap.set(res.Id, val);
-    }
-    const totalExecuted = resultMap.get('m_total') ?? 0;
-    const totalFailed = resultMap.get('m_errors') ?? 0;
-    const totalRetried = resultMap.get('m_retries') ?? 0;
-    const totalSucceeded = Math.max(0, totalExecuted - totalFailed);
-    const avgDurationMs = Math.round(resultMap.get('m_duration_avg') ?? 0);
-    const p95DurationMs = Math.round(resultMap.get('m_duration_p95') ?? 0);
-    const successRate = totalExecuted > 0
-        ? Math.round(((totalExecuted - totalFailed) / totalExecuted) * 10000) / 100
-        : 100;
-    return {
-        totalExecuted,
-        totalSucceeded,
-        totalFailed,
-        totalRetried,
-        successRate,
-        avgDurationMs,
-        p95DurationMs,
-        byJob: extractJobTypeStats(resultMap, jobNames),
-    };
-}
-async function pollLogsQuery(client, queryId, 
-// biome-ignore lint/suspicious/noExplicitAny: Dynamic command class constructor
-GetQueryResultsClass) {
-    for (let i = 0; i < 10; i++) {
-        const res = (await client.send(new GetQueryResultsClass({ queryId })));
-        if (res.status === 'Complete') {
-            return res.results ?? [];
-        }
-        if (res.status === 'Failed' || res.status === 'Cancelled') {
-            break;
-        }
-        await new Promise((resolve) => setTimeout(resolve, 300));
-    }
-    return [];
-}
-function mapFailedJobRow(row) {
-    const map = new Map();
-    for (const cell of row) {
-        if (cell.field && cell.value) {
-            map.set(cell.field, cell.value);
-        }
-    }
-    const timestampStr = map.get('@timestamp') ?? new Date().toISOString();
-    const durationStr = map.get('JobDuration');
-    const queueWaitStr = map.get('QueueWaitTime');
-    return {
-        jobId: map.get('JobId') ?? '',
-        jobName: map.get('JobName') ?? '',
-        attemptNumber: Number(map.get('AttemptNumber') ?? '1'),
-        errorMessage: map.get('ErrorMessage') ?? '',
-        errorName: map.get('ErrorName'),
-        errorStack: map.get('ErrorStack'),
-        failedAt: new Date(timestampStr),
-        durationMs: durationStr ? Number(durationStr) : undefined,
-        queueWaitTimeMs: queueWaitStr ? Number(queueWaitStr) : undefined,
-    };
-}
-/**
- * Create an observability client for querying background job metrics and execution logs.
- *
- * @param options - Configuration options including namespace, logGroupName, and region.
- * @returns A JobsObservabilityClient instance.
- */
-export function createJobsObservabilityClient(options = {}) {
-    const { namespace = 'Glasswork/Jobs', logGroupName, region = process.env.AWS_REGION || 'eu-west-1', } = options;
-    let cwClient = options.cloudWatchClient ?? null;
-    let cwLogsClient = options.cloudWatchLogsClient ?? null;
-    async function getCloudWatchClient() {
-        if (cwClient)
-            return cwClient;
-        try {
-            const sdk = (await import('@aws-sdk/client-cloudwatch'));
-            const CloudWatchClient = sdk.CloudWatchClient;
-            cwClient = new CloudWatchClient({ region });
-            return cwClient;
-        }
-        catch {
-            throw new Error('Package "@aws-sdk/client-cloudwatch" is required to query metrics. Please install it or inject a cloudWatchClient.');
-        }
-    }
-    async function getCloudWatchLogsClient() {
-        if (cwLogsClient)
-            return cwLogsClient;
-        try {
-            const sdk = (await import('@aws-sdk/client-cloudwatch-logs'));
-            const CloudWatchLogsClient = sdk.CloudWatchLogsClient;
-            cwLogsClient = new CloudWatchLogsClient({ region });
-            return cwLogsClient;
-        }
-        catch {
-            throw new Error('Package "@aws-sdk/client-cloudwatch-logs" is required to query logs. Please install it or inject a cloudWatchLogsClient.');
-        }
-    }
-    return {
-        async getSummary(queryOptions = {}) {
-            const client = await getCloudWatchClient();
-            const hours = queryOptions.hours ?? 24;
-            const endTime = queryOptions.endTime ?? new Date();
-            const startTime = queryOptions.startTime ?? new Date(endTime.getTime() - hours * 60 * 60 * 1000);
-            const period = Math.max(60, Math.floor((endTime.getTime() - startTime.getTime()) / 1000));
-            const jobNames = queryOptions.jobNames ?? [];
-            const metricDataQueries = buildMetricDataQueries(namespace, period, jobNames);
-            // biome-ignore lint/suspicious/noExplicitAny: Dynamic command invocation
-            let CommandClass;
-            try {
-                const sdk = (await import('@aws-sdk/client-cloudwatch'));
-                CommandClass = sdk.GetMetricDataCommand;
-            }
-            catch {
-                CommandClass = class GetMetricDataCommand {
-                    input;
-                    constructor(input) {
-                        this.input = input;
-                    }
-                };
-            }
-            const response = (await client.send(new CommandClass({
-                StartTime: startTime,
-                EndTime: endTime,
-                MetricDataQueries: metricDataQueries,
-            })));
-            return parseMetricResults(response.MetricDataResults, jobNames);
-        },
-        async getJobTypeStats(jobName, queryOptions = {}) {
-            const summary = await this.getSummary({
-                ...queryOptions,
-                jobNames: [jobName],
-            });
-            return (summary.byJob[jobName] ?? {
-                jobName,
-                count: 0,
-                succeededCount: 0,
-                failedCount: 0,
-                retryCount: 0,
-                avgDurationMs: 0,
-                p95DurationMs: 0,
-            });
-        },
-        async getFailedJobs(failedOptions = {}) {
-            if (!logGroupName) {
-                throw new Error('Option "logGroupName" is required to query failed jobs from CloudWatch Logs.');
-            }
-            const client = await getCloudWatchLogsClient();
-            const limit = failedOptions.limit ?? 25;
-            const endTime = failedOptions.endTime ?? new Date();
-            const startTime = failedOptions.startTime ?? new Date(endTime.getTime() - 24 * 60 * 60 * 1000);
-            const jobNameFilter = failedOptions.jobName ? `and JobName = "${failedOptions.jobName}"` : '';
-            const queryString = `fields @timestamp, JobName, JobId, AttemptNumber, ErrorName, ErrorMessage, ErrorStack, JobDuration, QueueWaitTime
-| filter Status in ["failed", "dead_letter"] ${jobNameFilter}
-| sort @timestamp desc
-| limit ${limit}`;
-            // biome-ignore lint/suspicious/noExplicitAny: Dynamic command invocation
-            let StartQueryCommandClass;
-            // biome-ignore lint/suspicious/noExplicitAny: Dynamic command invocation
-            let GetQueryResultsCommandClass;
-            try {
-                const sdk = (await import('@aws-sdk/client-cloudwatch-logs'));
-                StartQueryCommandClass = sdk.StartQueryCommand;
-                GetQueryResultsCommandClass = sdk.GetQueryResultsCommand;
-            }
-            catch {
-                StartQueryCommandClass = class StartQueryCommand {
-                    input;
-                    constructor(input) {
-                        this.input = input;
-                    }
-                };
-                GetQueryResultsCommandClass = class GetQueryResultsCommand {
-                    input;
-                    constructor(input) {
-                        this.input = input;
-                    }
-                };
-            }
-            const startRes = (await client.send(new StartQueryCommandClass({
-                logGroupName,
-                startTime: Math.floor(startTime.getTime() / 1000),
-                endTime: Math.floor(endTime.getTime() / 1000),
-                queryString,
-            })));
-            if (!startRes.queryId) {
-                return [];
-            }
-            const rows = await pollLogsQuery(client, startRes.queryId, GetQueryResultsCommandClass);
-            return rows.map(mapFailedJobRow);
-        },
-    };
-}
-//# sourceMappingURL=client.js.map

package/dist/jobs/observability/client.js.map

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

package/dist/jobs/observability/dashboard.d.ts

@@ -1,19 +0,0 @@
-import type { CloudWatchDashboardDefinition, GenerateJobsDashboardOptions, GetJobsInsightsQueriesOptions, JobsInsightsQueries } from './types.js';
-/**
- * Generate a production-ready AWS CloudWatch Dashboard JSON definition for background jobs.
- *
- * Can be deployed via AWS CLI (`aws cloudwatch put-dashboard`), AWS CDK (`CfnDashboard`),
- * or Terraform (`aws_cloudwatch_dashboard`).
- *
- * @param options - Dashboard configuration options (names, widgets, region).
- * @returns An object with dashboardName and serialized dashboardBody JSON.
- */
-export declare function generateJobsDashboard(options: GenerateJobsDashboardOptions): CloudWatchDashboardDefinition;
-/**
- * Returns a set of pre-canned CloudWatch Logs Insights queries for monitoring and troubleshooting jobs.
- *
- * @param options - Optional configuration for logGroupName and namespace filter.
- * @returns Queries for recent failures, slowest jobs, retries, and job tracing.
- */
-export declare function getJobsInsightsQueries(options?: GetJobsInsightsQueriesOptions): JobsInsightsQueries;
-//# sourceMappingURL=dashboard.d.ts.map

package/dist/jobs/observability/dashboard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../src/jobs/observability/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,6BAA6B,CAqI/B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,6BAAkC,GAC1C,mBAAmB,CAerB"}