@zintrust/core 0.1.42 → 0.1.43

package/packages/workers/src/NotificationWorker.d.ts

@@ -0,0 +1,24 @@
+/**
+ * NotificationWorker - Processes queued notifications
+ *
+ * This worker dequeues notification messages and sends them using the Notification service.
+ * Use with Queue.dequeue() in a background process or cron job.
+ */
+export declare const NotificationWorker: Readonly<{
+    processOne: (queueName?: string, driverName?: string) => Promise<boolean>;
+    processAll: (queueName?: string, driverName?: string) => Promise<number>;
+    runOnce: (opts?: {
+        queueName?: string;
+        driverName?: string;
+        maxItems?: number;
+        maxDurationMs?: number;
+    }) => Promise<number>;
+    startWorker: (opts?: {
+        queueName?: string;
+        driverName?: string;
+        signal?: AbortSignal;
+        maxDurationMs?: number;
+    }) => Promise<number>;
+}>;
+export default NotificationWorker;
+//# sourceMappingURL=NotificationWorker.d.ts.map

package/packages/workers/src/NotificationWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationWorker.d.ts","sourceRoot":"","sources":["../../../../packages/workers/src/NotificationWorker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,eAAO,MAAM,kBAAkB;0BAgB09E,CAAC,oBAAoB,CAAC;0BAAuD,CAAC,oBAAoB,CAAC;kBAA8C,CAAC;iBAAiB,CAAC;kBAAwB,CAAC;gBAAsB,CAAC;qBAA2B,CAAC;;sBAAuD,CAAC;iBAAiB,CAAC;kBAAwB,CAAC;cAAoB,CAAC;qBAAgC,CAAC;;EAHh4F,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/packages/workers/src/NotificationWorker.js

@@ -0,0 +1,23 @@
+/**
+ * NotificationWorker - Processes queued notifications
+ *
+ * This worker dequeues notification messages and sends them using the Notification service.
+ * Use with Queue.dequeue() in a background process or cron job.
+ */
+import { Notification } from '../../../src/index.js';
+import { createQueueWorker } from './createQueueWorker.js';
+export const NotificationWorker = Object.freeze({
+    ...createQueueWorker({
+        kindLabel: 'notification',
+        defaultQueueName: 'notifications',
+        maxAttempts: 3,
+        getLogFields: (payload) => ({
+            recipient: payload.recipient,
+            queuedAt: payload.timestamp,
+        }),
+        handle: async (payload) => {
+            await Notification.send(payload.recipient, payload.message, payload.options);
+        },
+    }),
+});
+export default NotificationWorker;

package/packages/workers/src/Observability.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Observability Manager
+ * Integrations for Prometheus, OpenTelemetry, and Datadog
+ * Sealed namespace for immutability
+ */
+import type { Tracer } from '@opentelemetry/api';
+import type { Registry } from 'prom-client';
+export type ObservabilityConfig = {
+    prometheus: {
+        enabled: boolean;
+        port?: number;
+        path?: string;
+        defaultLabels?: Record<string, string>;
+    };
+    openTelemetry: {
+        enabled: boolean;
+        serviceName: string;
+        exporterUrl?: string;
+        sampleRate?: number;
+    };
+    datadog: {
+        enabled: boolean;
+        host?: string;
+        port?: number;
+        prefix?: string;
+        tags?: string[];
+    };
+};
+export type MetricType = 'counter' | 'gauge' | 'histogram' | 'summary';
+export type MetricDefinition = {
+    name: string;
+    type: MetricType;
+    help: string;
+    labels?: string[];
+};
+export type TraceContext = {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    baggage?: Record<string, string>;
+};
+export type SpanAttributes = Record<string, string | number | boolean>;
+type DatadogClient = {
+    increment: (name: string, value?: number, tags?: string[]) => void;
+    gauge: (name: string, value: number, tags?: string[]) => void;
+    histogram: (name: string, value: number, tags?: string[]) => void;
+    timing: (name: string, value: number, tags?: string[]) => void;
+    close: (callback?: () => void) => void;
+};
+/**
+ * Observability Manager - Sealed namespace
+ */
+export declare const Observability: Readonly<{
+    /**
+     * Initialize observability with configuration
+     */
+    initialize(observabilityConfig: ObservabilityConfig): Promise<void>;
+    /**
+     * Register a metric
+     */
+    registerMetric(definition: MetricDefinition): Promise<void>;
+    /**
+     * Increment a counter
+     */
+    incrementCounter(name: string, value?: number, labels?: Record<string, string>): void;
+    /**
+     * Set a gauge value
+     */
+    setGauge(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Record a histogram observation
+     */
+    recordHistogram(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * Record timing (histogram for duration)
+     */
+    recordTiming(name: string, durationMs: number, labels?: Record<string, string>): void;
+    /**
+     * Start a span (OpenTelemetry)
+     */
+    startSpan(name: string, options?: {
+        attributes?: SpanAttributes;
+        parentSpanId?: string;
+    }): string | null;
+    /**
+     * End a span
+     */
+    endSpan(spanId: string, attributes?: SpanAttributes): void;
+    /**
+     * Record an error on a span
+     */
+    recordSpanError(spanId: string, error: Error): void;
+    /**
+     * Add event to span
+     */
+    addSpanEvent(spanId: string, name: string, attributes?: SpanAttributes): void;
+    /**
+     * Get Prometheus metrics (for HTTP endpoint)
+     */
+    getPrometheusMetrics(): Promise<string>;
+    /**
+     * Get Prometheus registry (for advanced usage)
+     */
+    getPrometheusRegistry(): Registry | null;
+    /**
+     * Get Datadog client (for advanced usage)
+     */
+    getDatadogClient(): DatadogClient | null;
+    /**
+     * Get OpenTelemetry tracer (for advanced usage)
+     */
+    getTracer(): Tracer | null;
+    /**
+     * Record worker job metrics
+     */
+    recordJobMetrics(workerName: string, jobName: string, metrics: {
+        processed?: number;
+        failed?: number;
+        durationMs?: number;
+        queueSize?: number;
+    }): void;
+    /**
+     * Record worker resource metrics
+     */
+    recordResourceMetrics(workerName: string, resources: {
+        cpuUsage?: number;
+        memoryUsage?: number;
+        activeJobs?: number;
+    }): void;
+    /**
+     * Create a traced function wrapper
+     */
+    traced<T extends (...args: unknown[]) => unknown>(name: string, fn: T, options?: {
+        attributes?: SpanAttributes;
+    }): T;
+    /**
+     * Get configuration
+     */
+    getConfig(): ObservabilityConfig | null;
+    /**
+     * Check if observability is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Clear metrics for a specific worker
+     */
+    clearWorkerMetrics(workerName: string): Promise<void>;
+    /**
+     * Shutdown
+     */
+    shutdown(): void;
+}>;
+export {};
+//# sourceMappingURL=Observability.d.ts.map

package/packages/workers/src/Observability.d.ts.map

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