pixivflow 2.12.2 → 2.13.0

package/dist/delivery/LegacyOutboxMigration.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.legacyOutboxDir = legacyOutboxDir;
+exports.migrateLegacyOutbox = migrateLegacyOutbox;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const logger_1 = require("../logger");
+function legacyOutboxDir(databasePath) {
+    return (0, node_path_1.join)((0, node_path_1.dirname)(databasePath), 'delivery-outbox');
+}
+function migrateLegacyOutbox(database, outboxDir = legacyOutboxDir(database.getDatabasePath())) {
+    const result = { scanned: 0, imported: 0, delivered: 0, skipped: 0, failed: 0 };
+    if (!(0, node_fs_1.existsSync)(outboxDir))
+        return result;
+    const files = (0, node_fs_1.readdirSync)(outboxDir).filter((f) => f.endsWith('.json'));
+    const archiveDir = (0, node_path_1.join)(outboxDir, 'migrated');
+    for (const file of files) {
+        result.scanned++;
+        const full = (0, node_path_1.join)(outboxDir, file);
+        let manifest;
+        try {
+            manifest = JSON.parse((0, node_fs_1.readFileSync)(full, 'utf8'));
+        }
+        catch (error) {
+            logger_1.logger.warn('Legacy outbox manifest unreadable; leaving in place', {
+                file,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            result.failed++;
+            continue;
+        }
+        try {
+            const kind = manifest.kind ?? (manifest.notification ? 'notification' : 'delivery');
+            const target = manifest.deliveryTarget ?? 'default';
+            if (kind === 'notification') {
+                const key = manifest.notification?.idempotencyKey ?? `legacy-notify:${manifest.id ?? file}`;
+                if (manifest.status === 'delivered') {
+                    result.delivered++;
+                }
+                else {
+                    database.outbox.enqueue({
+                        kind: 'notification',
+                        deliveryTarget: target,
+                        idempotencyKey: key,
+                        payload: { text: manifest.notification?.text ?? '' },
+                    });
+                    result.imported++;
+                }
+            }
+            else {
+                const artifact = manifest.artifact;
+                if (!artifact) {
+                    result.skipped++;
+                }
+                else if (manifest.status === 'delivered') {
+                    // Backfill the ledger fact so delivery dedupe survives the migration.
+                    const key = `legacy-delivery:${target}:${artifact.type}:${artifact.pixivId}:${manifest.id ?? file}`;
+                    if (!database.deliveries.isDelivered(target, artifact.type, String(artifact.pixivId))) {
+                        database.deliveries.backfill({
+                            id: require('node:crypto').randomUUID(),
+                            deliveryTarget: target,
+                            workType: artifact.type,
+                            pixivId: String(artifact.pixivId),
+                            idempotencyKey: key,
+                            remoteStatus: 'legacy_delivered',
+                        });
+                    }
+                    result.delivered++;
+                }
+                else {
+                    const idemKey = `legacy-delivery:${target}:${artifact.type}:${artifact.pixivId}:${manifest.id ?? file}`;
+                    // Create the ledger intent + outbox row atomically.
+                    const { row, created } = database.deliveries.insertIntent({
+                        id: require('node:crypto').randomUUID(),
+                        deliveryTarget: target,
+                        workType: artifact.type,
+                        pixivId: String(artifact.pixivId),
+                        idempotencyKey: idemKey,
+                    });
+                    if (created) {
+                        const due = manifest.nextAttemptAt ? Date.parse(manifest.nextAttemptAt) : Date.now();
+                        database.outbox.enqueue({
+                            kind: 'delivery',
+                            deliveryTarget: target,
+                            idempotencyKey: `outbox:${idemKey}`,
+                            deliveryId: row.id,
+                            dueAt: Number.isFinite(due) ? due : Date.now(),
+                            payload: {
+                                files: artifact.files,
+                                cleanupFiles: artifact.cleanupFiles ?? [],
+                                fields: manifest.request?.fields ?? null,
+                                context: {
+                                    title: artifact.title,
+                                    pixivId: artifact.pixivId,
+                                    type: artifact.type,
+                                    workTags: artifact.tags,
+                                    ...(manifest.request?.context ?? {}),
+                                },
+                            },
+                        });
+                        result.imported++;
+                    }
+                    else {
+                        result.skipped++;
+                    }
+                }
+            }
+            // Commit succeeded (better-sqlite3 is synchronous): archive the manifest.
+            (0, node_fs_1.mkdirSync)(archiveDir, { recursive: true });
+            (0, node_fs_1.renameSync)(full, (0, node_path_1.join)(archiveDir, file));
+        }
+        catch (error) {
+            result.failed++;
+            logger_1.logger.warn('Legacy outbox manifest migration failed; will retry next start', {
+                file,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    if (result.imported > 0 || result.delivered > 0) {
+        logger_1.logger.info('Legacy JSON outbox migrated to SQLite', result);
+    }
+    return result;
+}
+//# sourceMappingURL=LegacyOutboxMigration.js.map

package/dist/delivery/LegacyOutboxMigration.js.map

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

package/dist/delivery/OutboxWorker.d.ts

@@ -0,0 +1,69 @@
+import { Database } from '../storage/Database';
+import { OutboxRow } from '../storage/repositories/OutboxRepository';
+import { DeliveryDispatcher } from './DeliveryDispatcher';
+import { DeliveryAck } from './DeliveryAck';
+export interface OutboxWorkerOptions {
+    /** How often to scan for due rows. */
+    pollIntervalMs?: number;
+    /** Row lease duration while one attempt is in flight. */
+    leaseMs?: number;
+    /** Rows claimed per scan. */
+    batchSize?: number;
+    retryBaseMs?: number;
+    retryMaxMs?: number;
+    /** Fired when a delivery reaches a terminal business state (for the Slot ledger). */
+    onDeliveryTerminal?: (deliveryId: string, ack: DeliveryAck, payload: DeliveryPayload) => void;
+    /** Fired when a delivery is permanently dead (for notifications/doctor). */
+    onDead?: (row: OutboxRow, error: string) => void;
+}
+/** Delivery side-effect payload (frozen at enqueue time). */
+export interface DeliveryPayload {
+    files: string[];
+    /** Sidecars + cached media removed after confirmed delivery (cache mode). */
+    cleanupFiles?: string[];
+    deleteAfterDelivery?: boolean;
+    fields?: Record<string, unknown>;
+    context: Record<string, unknown>;
+}
+/** Notification side-effect payload. */
+export interface NotificationPayload {
+    text: string;
+}
+/** Exponential backoff with jitter, capped. */
+export declare function backoffDelayMs(attempt: number, base: number, max: number): number;
+/**
+ * Independently pumps the SQLite outbox so deliveries and notifications retry
+ * promptly instead of piggy-backing on the next scheduled download run.
+ * Survives crashes: an in-flight row keeps an expiring lease; a restart claims
+ * it once the lease is stale and retries the SAME idempotent intent.
+ */
+export declare class OutboxWorker {
+    private readonly database;
+    private readonly dispatcher;
+    private timer;
+    private running;
+    private stopped;
+    private readonly owner;
+    private readonly pollIntervalMs;
+    private readonly leaseMs;
+    private readonly batchSize;
+    private readonly retryBaseMs;
+    private readonly retryMaxMs;
+    constructor(database: Database, dispatcher: DeliveryDispatcher, options?: OutboxWorkerOptions);
+    private onDeliveryTerminal;
+    private onDead;
+    start(): void;
+    stop(): void;
+    /** Drain all currently-due rows once (used by CLI / watchdog wake). */
+    drainOnce(maxRounds?: number): Promise<{
+        processed: number;
+        done: number;
+        retried: number;
+        dead: number;
+    }>;
+    private pump;
+    private process;
+    private handleDeliveryAck;
+    private cleanup;
+}
+//# sourceMappingURL=OutboxWorker.d.ts.map

package/dist/delivery/OutboxWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutboxWorker.d.ts","sourceRoot":"","sources":["../../src/delivery/OutboxWorker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAgB,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAC9F,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKjF;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAYrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAZ7B,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuD;IAC7E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,kBAAkB,EAC/C,OAAO,GAAE,mBAAwB;IAWnC,OAAO,CAAC,kBAAkB,CAAwD;IAClF,OAAO,CAAC,MAAM,CAA4C;IAE1D,KAAK,IAAI,IAAI;IAUb,IAAI,IAAI,IAAI;IAQZ,uEAAuE;IACjE,SAAS,CAAC,SAAS,SAAK,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;YAmB9F,IAAI;YAmBJ,OAAO;YAyCP,iBAAiB;YA+BjB,OAAO;CAWtB"}

package/dist/delivery/OutboxWorker.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboxWorker = void 0;
+exports.backoffDelayMs = backoffDelayMs;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const logger_1 = require("../logger");
+/** Exponential backoff with jitter, capped. */
+function backoffDelayMs(attempt, base, max) {
+    const exp = base * 2 ** Math.min(Math.max(0, attempt - 1), 18);
+    const capped = Math.min(max, exp);
+    // Full jitter: 0.5..1.0 of the delay spreads synchronized workers/retries.
+    return Math.round(capped * (0.5 + Math.random() * 0.5));
+}
+/**
+ * Independently pumps the SQLite outbox so deliveries and notifications retry
+ * promptly instead of piggy-backing on the next scheduled download run.
+ * Survives crashes: an in-flight row keeps an expiring lease; a restart claims
+ * it once the lease is stale and retries the SAME idempotent intent.
+ */
+class OutboxWorker {
+    database;
+    dispatcher;
+    timer = null;
+    running = false;
+    stopped = false;
+    owner = `worker-${process.pid}-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+    pollIntervalMs;
+    leaseMs;
+    batchSize;
+    retryBaseMs;
+    retryMaxMs;
+    constructor(database, dispatcher, options = {}) {
+        this.database = database;
+        this.dispatcher = dispatcher;
+        this.pollIntervalMs = options.pollIntervalMs ?? 10_000;
+        this.leaseMs = options.leaseMs ?? 120_000;
+        this.batchSize = options.batchSize ?? 4;
+        this.retryBaseMs = options.retryBaseMs ?? 30_000;
+        this.retryMaxMs = options.retryMaxMs ?? 6 * 60 * 60_000;
+        if (options.onDeliveryTerminal)
+            this.onDeliveryTerminal = options.onDeliveryTerminal;
+        if (options.onDead)
+            this.onDead = options.onDead;
+    }
+    onDeliveryTerminal = undefined;
+    onDead = undefined;
+    start() {
+        if (this.timer)
+            return;
+        logger_1.logger.info('Outbox worker started', { pollMs: this.pollIntervalMs, owner: this.owner });
+        // Pump immediately on start so a crash-resume drains without waiting.
+        void this.pump();
+        this.timer = setInterval(() => void this.pump(), this.pollIntervalMs);
+        // Don't keep the event loop alive solely for the pump during shutdown.
+        this.timer.unref?.();
+    }
+    stop() {
+        this.stopped = true;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Drain all currently-due rows once (used by CLI / watchdog wake). */
+    async drainOnce(maxRounds = 50) {
+        let processed = 0;
+        let done = 0;
+        let retried = 0;
+        let dead = 0;
+        for (let round = 0; round < maxRounds; round++) {
+            const rows = this.database.outbox.claimDue(this.owner, this.leaseMs, this.batchSize);
+            if (rows.length === 0)
+                break;
+            for (const row of rows) {
+                processed++;
+                const result = await this.process(row);
+                if (result === 'done')
+                    done++;
+                else if (result === 'dead')
+                    dead++;
+                else
+                    retried++;
+            }
+        }
+        return { processed, done, retried, dead };
+    }
+    async pump() {
+        if (this.running || this.stopped)
+            return;
+        this.running = true;
+        try {
+            const rows = this.database.outbox.claimDue(this.owner, this.leaseMs, this.batchSize);
+            for (const row of rows) {
+                if (this.stopped) {
+                    this.database.outbox.release(row.id);
+                    continue;
+                }
+                await this.process(row);
+            }
+        }
+        catch (error) {
+            logger_1.logger.warn('Outbox pump failed', { error: error instanceof Error ? error.message : String(error) });
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    async process(row) {
+        try {
+            if (row.kind === 'notification') {
+                const payload = JSON.parse(row.payloadJson);
+                await this.dispatcher.notify(row.deliveryTarget, {
+                    text: payload.text,
+                    idempotencyKey: row.idempotencyKey ?? row.id,
+                });
+            }
+            else {
+                const payload = JSON.parse(row.payloadJson);
+                const result = await this.dispatcher.deliver(row.deliveryTarget, {
+                    files: payload.files,
+                    fields: payload.fields,
+                    context: payload.context,
+                });
+                const ack = result.ack ?? {
+                    kind: result.status && result.status >= 200 && result.status < 300 ? 'accepted' : 'retryable_failure',
+                    error: `no ack (HTTP ${result.status})`,
+                };
+                await this.handleDeliveryAck(row, ack, payload);
+            }
+            this.database.outbox.markDone(row.id);
+            return 'done';
+        }
+        catch (error) {
+            // Transport-level error (fetch threw): retryable.
+            const message = error instanceof Error ? error.message : String(error);
+            const delay = backoffDelayMs(row.attempts + 1, this.retryBaseMs, this.retryMaxMs);
+            const status = this.database.outbox.markRetry(row.id, Date.now() + delay, message);
+            if (status === 'dead') {
+                logger_1.logger.error('Outbox item dead after max attempts', { outboxId: row.id, kind: row.kind, error: message });
+                this.onDead?.(row, message);
+                if (row.deliveryId) {
+                    this.database.deliveries.recordAck(row.deliveryId, { status: 'failed', error: message });
+                }
+            }
+            else {
+                logger_1.logger.warn('Outbox item will retry', { outboxId: row.id, kind: row.kind, attempt: row.attempts + 1, delayMs: delay });
+            }
+            return status;
+        }
+    }
+    async handleDeliveryAck(row, ack, payload) {
+        if (!row.deliveryId)
+            return;
+        switch (ack.kind) {
+            case 'accepted':
+            case 'idempotent_replay':
+                this.database.deliveries.recordAck(row.deliveryId, {
+                    status: 'delivered',
+                    remoteId: ack.remoteId,
+                    remoteStatus: ack.remoteStatus ?? (ack.kind === 'idempotent_replay' ? 'idempotent_replay' : 'accepted'),
+                });
+                this.onDeliveryTerminal?.(row.deliveryId, ack, payload);
+                await this.cleanup(payload);
+                break;
+            case 'duplicate_existing':
+                this.database.deliveries.recordAck(row.deliveryId, {
+                    status: 'duplicate',
+                    remoteId: ack.remoteId,
+                    remoteStatus: ack.remoteStatus ?? 'duplicate_existing',
+                    reuseReason: 'historical_duplicate',
+                });
+                this.onDeliveryTerminal?.(row.deliveryId, ack, payload);
+                break;
+            case 'permanent_failure':
+                // Deterministic rejection: still retry a couple times to survive a
+                // misconfigured blip, the outbox max-attempts then dead-letters it.
+                throw new Error(`permanent delivery failure: ${ack.error}`);
+            case 'retryable_failure':
+                throw new Error(`retryable delivery failure: ${ack.error}`);
+        }
+    }
+    async cleanup(payload) {
+        if (payload.deleteAfterDelivery === false)
+            return;
+        const files = [...(payload.files ?? []), ...(payload.cleanupFiles ?? [])];
+        await Promise.all([...new Set(files)].map((file) => (0, promises_1.unlink)(file).catch((error) => {
+            if (error.code !== 'ENOENT')
+                logger_1.logger.debug('cache cleanup failed', { file, error: error.message });
+        })));
+    }
+}
+exports.OutboxWorker = OutboxWorker;
+//# sourceMappingURL=OutboxWorker.js.map

package/dist/delivery/OutboxWorker.js.map

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

package/dist/delivery/types.d.ts

@@ -58,6 +58,13 @@ export interface DeliveryContext {
     occurrenceAt?: string;
     /** Why the run started: cron | http | manual | catchup. */
     triggerSource?: string;
+    /**
+     * Occurrence-scoped intent key (e.g. pixivflow:<target>:<type>:<id>:<slot>:<targetId>).
+     * Sent downstream as idempotency_key so an ACK-loss retry carrying the SAME
+     * key converges to one remote record (idempotent_replay), distinct from a
+     * historical duplicate of the same work from a different occurrence.
+     */
+    idempotencyKey?: string;
     /** Schedule slot provenance for review-source labelling (external/scheduled runs). */
     slotId?: string;
     slotName?: string;
@@ -68,9 +75,12 @@ export interface DeliveryRequest {
     fields?: Record<string, DeliveryFieldValue>;
     context: DeliveryContext;
 }
+import type { DeliveryAck } from './DeliveryAck';
 export interface DeliveryResult {
     status?: number;
     body?: unknown;
+    /** Normalized business acknowledgement (present on delivery attempts). */
+    ack?: DeliveryAck;
 }
 export interface DeliveryNotificationRequest {
     text: string;
@@ -78,6 +88,7 @@ export interface DeliveryNotificationRequest {
 }
 export interface DeliveryProvider {
     deliver(request: DeliveryRequest): Promise<DeliveryResult>;
+    /** One notification attempt; the durable outbox owns retries. */
     notify?(request: DeliveryNotificationRequest): Promise<DeliveryResult>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/delivery/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/delivery/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,OAAO,CAAC;AAExD,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5C,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,MAAM,CAAC,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACxE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/delivery/types.ts"],"names":[],"mappings":"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"}

package/dist/download/DownloadManager.d.ts

@@ -3,6 +3,8 @@ import { IDownloadManager } from '../interfaces/IDownloadManager';
 import { IPixivClient } from '../interfaces/IPixivClient';
 import { IDatabase } from '../interfaces/IDatabase';
 import { IFileService } from '../interfaces/IFileService';
+import { DeliveryService } from '../delivery/DeliveryService';
+import { TargetOutcome } from '../scheduler/TargetOutcome';
 /**
  * Download Manager with Concurrency Control
  *
@@ -41,18 +43,22 @@ export declare class DownloadManager implements IDownloadManager {
     private readonly novelHandler;
     private cancelled;
     private cancelReason;
-    private readonly deliveryOutbox;
-    /** Per-target outcome hook (used by the Slot ledger to record cell results). */
+    private readonly deliveryService;
+    /** Per-target TYPED outcome hook (the Slot ledger maps it to cell transitions). */
     private onTargetOutcome;
-    /** Fired when a work is locked for delivery (fresh or outbox replay). */
-    private onWorkLocked;
-    /** Register a callback fired after each target with the error if it failed. */
-    setTargetOutcomeHook(fn: (target: TargetConfig, error?: string) => void): void;
-    /** Register a callback fired when a Pixiv work is selected and locked for a target. */
-    setWorkLockedHook(fn: (artifact: {
-        pixivId: string;
-        type: string;
-    }, target: TargetConfig) => void): void;
+    /** Register a callback fired after each target with its explicit business outcome. */
+    setTargetOutcomeHook(fn: (target: TargetConfig, outcome: TargetOutcome) => void): void;
+    /** Expose delivery service for handlers (preflight + intent creation). */
+    get deliveries(): DeliveryService;
+    /** Slot context propagated to delivery templates/outcomes for scheduled runs. */
+    slotContext?: {
+        slotId: string;
+        scheduleId: string;
+        occurrenceAtIso: string;
+        triggerSource: string;
+        slotName: string;
+        slotDate: string;
+    };
     /**
      * Request cooperative cancellation of the current run. In-flight item
      * finishes; no further targets/items are started. runAllTargets() will
@@ -66,6 +72,5 @@ export declare class DownloadManager implements IDownloadManager {
     runAllTargets(): Promise<void>;
     private dispatchTarget;
     private updateProgress;
-    private buildProxyUrl;
 }
 //# sourceMappingURL=DownloadManager.d.ts.map

package/dist/download/DownloadManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DownloadManager.d.ts","sourceRoot":"","sources":["../../src/download/DownloadManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAiB1D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAiDpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAGvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAnD9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAGlD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,gFAAgF;IAChF,OAAO,CAAC,eAAe,CAAiE;IACxF,yEAAyE;IACzE,OAAO,CAAC,YAAY,CAA8F;IAElH,+EAA+E;IACxE,oBAAoB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrF,uFAAuF;IAChF,iBAAiB,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI/G;;;;OAIG;IACI,MAAM,CAAC,MAAM,GAAE,MAAoB,GAAG,IAAI;IAQ1C,WAAW,IAAI,OAAO;gBAKV,MAAM,EAAE,gBAAgB,EACzC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,SAAS,EACF,WAAW,EAAE,YAAY;IAqF5C,mBAAmB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIlF,UAAU;IAIV,aAAa;YA0DZ,cAAc;IAa5B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,aAAa;CAetB"}
+{"version":3,"file":"DownloadManager.d.ts","sourceRoot":"","sources":["../../src/download/DownloadManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAU1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAK3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAyDpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAGvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IA3D9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAGlD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;IACnD,mFAAmF;IACnF,OAAO,CAAC,eAAe,CAAyE;IAEhG,sFAAsF;IAC/E,oBAAoB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAI7F,0EAA0E;IAC1E,IAAW,UAAU,IAAI,eAAe,CAEvC;IAED,iFAAiF;IAC1E,WAAW,CAAC,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF;;;;OAIG;IACI,MAAM,CAAC,MAAM,GAAE,MAAoB,GAAG,IAAI;IAQ1C,WAAW,IAAI,OAAO;gBAKV,MAAM,EAAE,gBAAgB,EACzC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,SAAS,EACF,WAAW,EAAE,YAAY;IAoF5C,mBAAmB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIlF,UAAU;IAIV,aAAa;YAyDZ,cAAc;IAY5B,OAAO,CAAC,cAAc;CAIvB"}