@zintrust/core 0.1.40 → 0.1.42

package/src/tools/queue/QueueTracing.d.ts

@@ -0,0 +1,32 @@
+export type QueueTraceOperation = 'enqueue' | 'dequeue' | 'ack' | 'length' | 'drain';
+export type QueueTraceStatus = 'ok' | 'error';
+export type QueueTraceEvent = {
+    traceId: string;
+    spanId: string;
+    queueName: string;
+    operation: QueueTraceOperation;
+    status: QueueTraceStatus;
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    error?: string;
+    attributes?: Record<string, unknown>;
+};
+export type QueueTraceExporter = (events: ReadonlyArray<QueueTraceEvent>) => void | Promise<void>;
+export declare const QueueTracing: Readonly<{
+    isEnabled: () => boolean;
+    registerExporter(exporter: QueueTraceExporter): void;
+    unregisterExporter(exporter: QueueTraceExporter): void;
+    flush(): Promise<number>;
+    snapshot(limit?: number): QueueTraceEvent[];
+    prune(): void;
+    reset(): void;
+    traceOperation<T>(input: {
+        queueName: string;
+        operation: QueueTraceOperation;
+        attributes?: Record<string, unknown>;
+        execute: () => Promise<T>;
+    }): Promise<T>;
+}>;
+export default QueueTracing;
+//# sourceMappingURL=QueueTracing.d.ts.map

package/src/tools/queue/QueueTracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueTracing.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/QueueTracing.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErF,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAiFlG,eAAO,MAAM,YAAY;qBArEH,OAAO;+BAwEA,kBAAkB,GAAG,IAAI;iCAIvB,kBAAkB,GAAG,IAAI;aAIvC,OAAO,CAAC,MAAM,CAAC;8BAuBP,eAAe,EAAE;aAO/B,IAAI;aAIJ,IAAI;mBAMQ,CAAC,SAAS;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,mBAAmB,CAAC;QAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;KAC3B,GAAG,OAAO,CAAC,CAAC,CAAC;EAiDd,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/src/tools/queue/QueueTracing.js

@@ -0,0 +1,151 @@
+import { OpenTelemetry } from '../../observability/OpenTelemetry.js';
+import { generateUuid } from '../../common/utility.js';
+import { Env } from '../../config/env.js';
+import { Logger } from '../../config/logger.js';
+const storedEvents = [];
+const pendingEvents = [];
+const exporters = new Set();
+const normalizeSampleRate = () => {
+    const value = Env.getFloat('QUEUE_TRACING_SAMPLE_RATE', 1);
+    if (Number.isFinite(value) === false)
+        return 1;
+    return Math.max(0, Math.min(1, value));
+};
+const isEnabled = () => Env.getBool('QUEUE_TRACING_ENABLED', false);
+const shouldSample = () => {
+    const rate = normalizeSampleRate();
+    if (rate >= 1)
+        return true;
+    if (rate <= 0)
+        return false;
+    return Math.random() <= rate; // NOSONAR - Math.random() is sufficient for sampling decisions in this context.
+};
+const maxEvents = () => Math.max(1, Env.getInt('QUEUE_TRACING_MAX_EVENTS', 5000));
+const retentionMs = () => Math.max(1000, Env.getInt('QUEUE_TRACING_RETENTION_MS', 86400000));
+const exportBatchSize = () => Math.max(1, Env.getInt('QUEUE_TRACING_EXPORT_BATCH_SIZE', 20));
+const shouldExportToOtel = () => Env.getBool('QUEUE_TRACING_EXPORT_OTEL', true);
+const pruneStored = () => {
+    const cutoff = Date.now() - retentionMs();
+    const filtered = storedEvents.filter((event) => {
+        const ended = new Date(event.endedAt).getTime();
+        if (Number.isNaN(ended))
+            return false;
+        return ended >= cutoff;
+    });
+    storedEvents.splice(0, storedEvents.length, ...filtered);
+    const keep = maxEvents();
+    if (storedEvents.length > keep) {
+        storedEvents.splice(0, storedEvents.length - keep);
+    }
+};
+const finalize = (event) => {
+    storedEvents.push(event);
+    pendingEvents.push(event);
+    pruneStored();
+};
+const normalizeError = (error) => {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+};
+const tryExportToOpenTelemetry = (batch) => {
+    if (shouldExportToOtel() === false)
+        return;
+    const recordQueueSpan = OpenTelemetry.recordQueueOperationSpan;
+    if (recordQueueSpan === undefined)
+        return;
+    batch.forEach((event) => {
+        recordQueueSpan({
+            queueName: event.queueName,
+            operation: event.operation,
+            durationMs: event.durationMs,
+            status: event.status,
+        });
+    });
+};
+export const QueueTracing = Object.freeze({
+    isEnabled,
+    registerExporter(exporter) {
+        exporters.add(exporter);
+    },
+    unregisterExporter(exporter) {
+        exporters.delete(exporter);
+    },
+    async flush() {
+        if (pendingEvents.length === 0)
+            return 0;
+        const batch = pendingEvents.splice(0, pendingEvents.length);
+        tryExportToOpenTelemetry(batch);
+        if (exporters.size > 0) {
+            const settled = await Promise.allSettled(Array.from(exporters).map(async (exporter) => exporter(batch)));
+            settled.forEach((result) => {
+                if (result.status === 'rejected') {
+                    Logger.warn('Queue trace exporter failed', {
+                        error: String(result.reason),
+                    });
+                }
+            });
+        }
+        return batch.length;
+    },
+    snapshot(limit = 100) {
+        const safeLimit = Math.max(1, Math.floor(limit));
+        pruneStored();
+        if (storedEvents.length <= safeLimit)
+            return [...storedEvents];
+        return storedEvents.slice(storedEvents.length - safeLimit);
+    },
+    prune() {
+        pruneStored();
+    },
+    reset() {
+        storedEvents.splice(0, storedEvents.length);
+        pendingEvents.splice(0, pendingEvents.length);
+        exporters.clear();
+    },
+    async traceOperation(input) {
+        if (isEnabled() === false || shouldSample() === false) {
+            return input.execute();
+        }
+        const startedAtMs = Date.now();
+        const traceId = generateUuid();
+        const spanId = generateUuid();
+        try {
+            const result = await input.execute();
+            finalize({
+                traceId,
+                spanId,
+                queueName: input.queueName,
+                operation: input.operation,
+                status: 'ok',
+                startedAt: new Date(startedAtMs).toISOString(),
+                endedAt: new Date().toISOString(),
+                durationMs: Math.max(0, Date.now() - startedAtMs),
+                attributes: input.attributes,
+            });
+            if (pendingEvents.length >= exportBatchSize()) {
+                void this.flush();
+            }
+            return result;
+        }
+        catch (error) {
+            finalize({
+                traceId,
+                spanId,
+                queueName: input.queueName,
+                operation: input.operation,
+                status: 'error',
+                startedAt: new Date(startedAtMs).toISOString(),
+                endedAt: new Date().toISOString(),
+                durationMs: Math.max(0, Date.now() - startedAtMs),
+                error: normalizeError(error),
+                attributes: input.attributes,
+            });
+            if (pendingEvents.length >= exportBatchSize()) {
+                void this.flush();
+            }
+            throw error;
+        }
+    },
+});
+export default QueueTracing;

package/src/tools/queue/StalledJobMonitor.d.ts

@@ -0,0 +1,5 @@
+export declare const StalledJobMonitor: Readonly<{
+    scanOnce(): Promise<number>;
+}>;
+export default StalledJobMonitor;
+//# sourceMappingURL=StalledJobMonitor.d.ts.map

package/src/tools/queue/StalledJobMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StalledJobMonitor.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/StalledJobMonitor.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB;gBACV,OAAO,CAAC,MAAM,CAAC;EAoBjC,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/src/tools/queue/StalledJobMonitor.js

@@ -0,0 +1,21 @@
+import { Logger } from '../../config/logger.js';
+import { JobHeartbeatStore } from './JobHeartbeatStore.js';
+import { JobStateTracker } from './JobStateTracker.js';
+export const StalledJobMonitor = Object.freeze({
+    async scanOnce() {
+        const expired = await JobHeartbeatStore.listExpired();
+        await Promise.all(expired.map(async (row) => {
+            await JobStateTracker.stalled({
+                queueName: row.queueName,
+                jobId: row.jobId,
+                reason: 'Heartbeat expired',
+            });
+            await JobHeartbeatStore.remove(row.queueName, row.jobId);
+        }));
+        if (expired.length > 0) {
+            Logger.warn('Stalled jobs detected from heartbeat store', { count: expired.length });
+        }
+        return expired.length;
+    },
+});
+export default StalledJobMonitor;

package/src/tools/queue/TimeoutManager.d.ts

@@ -0,0 +1,14 @@
+export type TimeoutRetryConfig = {
+    timeoutMs: number;
+    maxRetries: number;
+    retryDelayMs: number;
+    operationName?: string;
+};
+export declare const TimeoutManager: Readonly<{
+    getQueueJobTimeoutMs(): number;
+    withTimeout<T>(operation: () => Promise<T>, timeoutMs: number, operationName: string, timeoutHandler?: () => Promise<T>): Promise<T>;
+    withTimeoutRetry<T>(operation: () => Promise<T>, config: TimeoutRetryConfig): Promise<T>;
+    isTimeoutError: (error: unknown) => boolean;
+}>;
+export default TimeoutManager;
+//# sourceMappingURL=TimeoutManager.d.ts.map

package/src/tools/queue/TimeoutManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutManager.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/TimeoutManager.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AA8BF,eAAO,MAAM,cAAc;4BACD,MAAM;gBAKZ,CAAC,aACN,MAAM,OAAO,CAAC,CAAC,CAAC,aAChB,MAAM,iBACF,MAAM,mBACJ,MAAM,OAAO,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,CAAC,CAAC;qBA0BU,CAAC,aAAa,MAAM,OAAO,CAAC,CAAC,CAAC,UAAU,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;4BAhDjE,OAAO,KAAG,OAAO;EAwE9C,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/tools/queue/TimeoutManager.js

@@ -0,0 +1,77 @@
+import { Env } from '../../config/env.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+const sleep = async (ms) => {
+    if (ms <= 0)
+        return;
+    await new Promise((resolve) => {
+        const timeoutRef = globalThis.setTimeout(() => {
+            clearTimeout(timeoutRef);
+            resolve();
+        }, ms);
+    });
+};
+const createTimeoutError = (operationName, timeoutMs) => ErrorFactory.createTryCatchError(`Operation timed out: ${operationName}`, {
+    code: 'QUEUE_TIMEOUT',
+    operationName,
+    timeoutMs,
+});
+const isTimeoutError = (error) => {
+    if (error === null || error === undefined || typeof error !== 'object')
+        return false;
+    const code = error.code;
+    if (code === 'QUEUE_TIMEOUT')
+        return true;
+    const details = error.details;
+    if (details !== null && details !== undefined && typeof details === 'object') {
+        return details.code === 'QUEUE_TIMEOUT';
+    }
+    return false;
+};
+export const TimeoutManager = Object.freeze({
+    getQueueJobTimeoutMs() {
+        const timeoutSeconds = Env.getInt('QUEUE_JOB_TIMEOUT', 60);
+        return Math.max(1000, timeoutSeconds * 1000);
+    },
+    async withTimeout(operation, timeoutMs, operationName, timeoutHandler) {
+        let timeoutId;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = globalThis.setTimeout(() => {
+                reject(createTimeoutError(operationName, timeoutMs));
+            }, Math.max(1, timeoutMs));
+        });
+        try {
+            return await Promise.race([operation(), timeoutPromise]);
+        }
+        catch (error) {
+            if (timeoutHandler !== undefined && isTimeoutError(error)) {
+                return await timeoutHandler();
+            }
+            throw error;
+        }
+        finally {
+            if (timeoutId !== undefined) {
+                clearTimeout(timeoutId);
+            }
+        }
+    },
+    async withTimeoutRetry(operation, config) {
+        const retries = Math.max(0, Math.floor(config.maxRetries));
+        const attemptRun = async (attempt) => {
+            try {
+                return await this.withTimeout(operation, config.timeoutMs, config.operationName ?? 'queue-operation');
+            }
+            catch (error) {
+                const shouldRetry = isTimeoutError(error) && attempt < retries;
+                if (!shouldRetry) {
+                    throw error;
+                }
+                const delay = Math.max(0, Math.floor(config.retryDelayMs * 2 ** attempt));
+                await sleep(delay);
+                return attemptRun(attempt + 1);
+            }
+        };
+        return attemptRun(0);
+    },
+    isTimeoutError,
+});
+export default TimeoutManager;

package/src/tools/queue/drivers/Redis.d.ts

@@ -1,5 +1,6 @@
 import type { QueueMessage } from '../../queue/Queue';
 export declare const RedisQueue: {
+    readonly __zintrustCoreRedisQueue: true;
     readonly enqueue: <T = unknown>(queue: string, payload: T) => Promise<string>;
     readonly dequeue: <T = unknown>(queue: string) => Promise<QueueMessage<T> | undefined>;
     readonly ack: (_queue: string, _id: string) => Promise<void>;

package/src/tools/queue/drivers/Redis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Redis.d.ts","sourceRoot":"","sources":["../../../../../src/tools/queue/drivers/Redis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,UAAU;uBAEL,CAAC,mBAAmB,MAAM,WAAW,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC;uBAKxD,CAAC,mBAAmB,MAAM,KAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;2BAK7D,MAAM,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;6BAKjC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;4BAKzB,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;CAKzC,CAAC;AAEL,eAAe,UAAU,CAAC"}
+{"version":3,"file":"Redis.d.ts","sourceRoot":"","sources":["../../../../../src/tools/queue/drivers/Redis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,UAAU;;uBAGL,CAAC,mBAAmB,MAAM,WAAW,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC;uBAKxD,CAAC,mBAAmB,MAAM,KAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;2BAK7D,MAAM,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;6BAKjC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;4BAKzB,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;CAKzC,CAAC;AAEL,eAAe,UAAU,CAAC"}

package/src/tools/queue/drivers/Redis.js

@@ -1,6 +1,7 @@
 import { ensureDriver } from '../../../config/redis.js';
 export const RedisQueue = (() => {
     return {
+        __zintrustCoreRedisQueue: true,
         async enqueue(queue, payload) {
             const driver = await ensureDriver();
             return driver.enqueue(queue, payload);

package/src/tools/queue/index.d.ts

@@ -4,6 +4,16 @@
  */
 export { createAdvancedQueue, type AdvancedQueue } from './AdvancedQueue';
 export { createDeduplicationBuilder, type DeduplicationBuilder } from './DeduplicationBuilder';
+export { IdempotencyManager } from './IdempotencyManager';
+export { JobHeartbeatStore } from './JobHeartbeatStore';
+export { JobReconciliationRunner } from './JobReconciliationRunner';
+export { JobRecoveryDaemon } from './JobRecoveryDaemon';
 export { createLockProvider, createMemoryLockProvider, createRedisLockProvider, getLockProvider, registerLockProvider, } from './LockProvider';
+export { QueueDataRedactor } from './QueueDataRedactor';
+export { QueueReliabilityMetrics } from './QueueReliabilityMetrics';
+export { QueueReliabilityOrchestrator } from './QueueReliabilityOrchestrator';
+export { QueueTracing } from './QueueTracing';
+export { StalledJobMonitor } from './StalledJobMonitor';
+export { TimeoutManager } from './TimeoutManager';
 export type { AdvancedJobOptions, DeduplicationOptions, JobResult, Lock, LockOptions, LockProvider, LockProviderConfig, LockStatus, QueueConfig, ReleaseCondition, } from '../../types/Queue';
 //# sourceMappingURL=index.d.ts.map

package/src/tools/queue/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,gBAAgB,GACjB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/src/tools/queue/index.js

@@ -4,4 +4,14 @@
  */
 export { createAdvancedQueue } from './AdvancedQueue.js';
 export { createDeduplicationBuilder } from './DeduplicationBuilder.js';
+export { IdempotencyManager } from './IdempotencyManager.js';
+export { JobHeartbeatStore } from './JobHeartbeatStore.js';
+export { JobReconciliationRunner } from './JobReconciliationRunner.js';
+export { JobRecoveryDaemon } from './JobRecoveryDaemon.js';
 export { createLockProvider, createMemoryLockProvider, createRedisLockProvider, getLockProvider, registerLockProvider, } from './LockProvider.js';
+export { QueueDataRedactor } from './QueueDataRedactor.js';
+export { QueueReliabilityMetrics } from './QueueReliabilityMetrics.js';
+export { QueueReliabilityOrchestrator } from './QueueReliabilityOrchestrator.js';
+export { QueueTracing } from './QueueTracing.js';
+export { StalledJobMonitor } from './StalledJobMonitor.js';
+export { TimeoutManager } from './TimeoutManager.js';

package/src/tools/storage/drivers/R2.d.ts

@@ -4,8 +4,21 @@ export type R2Config = {
     accessKeyId: string;
     secretAccessKey: string;
     endpoint?: string;
+    binding?: string;
+};
+export type R2MultipartUploadInfo = {
+    key: string;
+    uploadId: string;
+};
+export type R2UploadedPart = {
+    partNumber: number;
+    etag: string;
 };
 export declare const R2Driver: Readonly<{
+    createMultipartUpload(config: R2Config, key: string, options?: unknown): Promise<R2MultipartUploadInfo>;
+    uploadPart(config: R2Config, key: string, uploadId: string, partNumber: number, value: unknown, options?: unknown): Promise<R2UploadedPart>;
+    completeMultipartUpload(config: R2Config, key: string, uploadId: string, uploadedParts: R2UploadedPart[]): Promise<string>;
+    abortMultipartUpload(config: R2Config, key: string, uploadId: string): Promise<void>;
     put(config: R2Config, key: string, content: string | Buffer): Promise<string>;
     get(config: R2Config, key: string): Promise<Buffer>;
     exists(config: R2Config, key: string): Promise<boolean>;

package/src/tools/storage/drivers/R2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"R2.d.ts","sourceRoot":"","sources":["../../../../../src/tools/storage/drivers/R2.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,QAAQ;gBACD,QAAQ,OAAO,MAAM,WAAW,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBAkBjE,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;mBAapC,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;mBAaxC,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBAa9C,QAAQ,OAAO,MAAM,GAAG,MAAM;oBAQhC,QAAQ,OACX,MAAM,YACD;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;KAAE,GACvD,MAAM;EAgBT,CAAC;AAEH,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"R2.d.ts","sourceRoot":"","sources":["../../../../../src/tools/storage/drivers/R2.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAyBF,eAAO,MAAM,QAAQ;kCAET,QAAQ,OACX,MAAM,YACD,OAAO,GAChB,OAAO,CAAC,qBAAqB,CAAC;uBAOvB,QAAQ,OACX,MAAM,YACD,MAAM,cACJ,MAAM,SACX,OAAO,YACJ,OAAO,GAChB,OAAO,CAAC,cAAc,CAAC;oCAOhB,QAAQ,OACX,MAAM,YACD,MAAM,iBACD,cAAc,EAAE,GAC9B,OAAO,CAAC,MAAM,CAAC;iCAOiB,QAAQ,OAAO,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBAMxE,QAAQ,OAAO,MAAM,WAAW,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBAkBjE,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;mBAapC,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;mBAaxC,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBAa9C,QAAQ,OAAO,MAAM,GAAG,MAAM;oBAQhC,QAAQ,OACX,MAAM,YACD;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;KAAE,GACvD,MAAM;EAgBT,CAAC;AAEH,eAAe,QAAQ,CAAC"}

package/src/tools/storage/drivers/R2.js

@@ -1,6 +1,35 @@
 import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
+import { Cloudflare } from '../../../config/cloudflare.js';
 import { S3Driver } from '../drivers/S3.js';
+const resolveWorkersBucket = (config) => {
+    const binding = Cloudflare.getR2Binding(config.binding);
+    if (binding === null || typeof binding.createMultipartUpload !== 'function') {
+        throw ErrorFactory.createConfigError('R2 multipart requires a Workers R2 binding (set config.binding or R2_BUCKET/R2/BUCKET).');
+    }
+    return binding;
+};
 export const R2Driver = Object.freeze({
+    async createMultipartUpload(config, key, options) {
+        const bucket = resolveWorkersBucket(config);
+        const upload = await bucket.createMultipartUpload(key, options);
+        return { key: upload.key ?? key, uploadId: upload.uploadId };
+    },
+    async uploadPart(config, key, uploadId, partNumber, value, options) {
+        const bucket = resolveWorkersBucket(config);
+        const upload = bucket.resumeMultipartUpload(key, uploadId);
+        return upload.uploadPart(partNumber, value, options);
+    },
+    async completeMultipartUpload(config, key, uploadId, uploadedParts) {
+        const bucket = resolveWorkersBucket(config);
+        const upload = bucket.resumeMultipartUpload(key, uploadId);
+        await upload.complete(uploadedParts);
+        return R2Driver.url(config, key);
+    },
+    async abortMultipartUpload(config, key, uploadId) {
+        const bucket = resolveWorkersBucket(config);
+        const upload = bucket.resumeMultipartUpload(key, uploadId);
+        await upload.abort();
+    },
     async put(config, key, content) {
         if (typeof config.endpoint !== 'string' || config.endpoint.trim() === '') {
             throw ErrorFactory.createConfigError('R2: missing endpoint');

package/src/zintrust.plugins.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Auto-generated fallback module.
+ * This file is created by scripts/ensure-worker-plugins.mjs when missing.
+ * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
+ */
+export declare const __zintrustGeneratedPluginStub = "zintrust.plugins.ts";
+declare const _default: {};
+export default _default;
+//# sourceMappingURL=zintrust.plugins.d.ts.map

package/src/zintrust.plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}

package/src/zintrust.plugins.js

@@ -0,0 +1,7 @@
+/**
+ * Auto-generated fallback module.
+ * This file is created by scripts/ensure-worker-plugins.mjs when missing.
+ * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
+ */
+export const __zintrustGeneratedPluginStub = 'zintrust.plugins.ts';
+export default {};

package/src/zintrust.plugins.wg.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Auto-generated fallback module.
+ * This file is created by scripts/ensure-worker-plugins.mjs when missing.
+ * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
+ */
+export declare const __zintrustGeneratedPluginStub = "zintrust.plugins.wg.ts";
+declare const _default: {};
+export default _default;
+//# sourceMappingURL=zintrust.plugins.wg.d.ts.map

package/src/zintrust.plugins.wg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zintrust.plugins.wg.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.wg.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;;AACtE,wBAAkB"}

package/src/zintrust.plugins.wg.js

@@ -0,0 +1,7 @@
+/**
+ * Auto-generated fallback module.
+ * This file is created by scripts/ensure-worker-plugins.mjs when missing.
+ * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
+ */
+export const __zintrustGeneratedPluginStub = 'zintrust.plugins.wg.ts';
+export default {};