pixivflow 2.12.3 → 2.13.0

package/dist/storage/DatabaseMigration.js

@@ -96,6 +96,9 @@ class DatabaseMigration {
             trigger_source TEXT,
             slot_date TEXT NOT NULL DEFAULT '',
             slot_name TEXT NOT NULL DEFAULT '',
+            lease_owner TEXT,
+            lease_until INTEGER,
+            heartbeat_at INTEGER,
             created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
             started_at DATETIME,
             completed_at DATETIME,
@@ -117,6 +120,61 @@ class DatabaseMigration {
             updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
             completed_at DATETIME,
             UNIQUE(slot_id, target_id)
+          )`,
+                // Delivery ledger: confirmed downstream submissions. This is separate
+                // from downloads (local file facts). The natural idempotency key makes
+                // ACK-lost retries converge to one row; (target, type, pixiv_id) marks
+                // which works are already CONFIRMED delivered to which target.
+                `CREATE TABLE IF NOT EXISTS deliveries (
+            id TEXT PRIMARY KEY,
+            delivery_target TEXT NOT NULL,
+            work_type TEXT NOT NULL,
+            pixiv_id TEXT NOT NULL,
+            slot_id TEXT,
+            target_id TEXT,
+            idempotency_key TEXT NOT NULL UNIQUE,
+            status TEXT NOT NULL DEFAULT 'pending',
+            remote_id TEXT,
+            remote_status TEXT,
+            reuse_reason TEXT,
+            attempts INTEGER NOT NULL DEFAULT 0,
+            last_error TEXT,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            delivered_at DATETIME
+          )`,
+                // Durable transactional outbox: every external side effect (content
+                // delivery or notification) originates from one row here. The worker
+                // leases due rows; crashes leave an expired lease that a restart claims.
+                `CREATE TABLE IF NOT EXISTS outbox (
+            id TEXT PRIMARY KEY,
+            kind TEXT NOT NULL,
+            idempotency_key TEXT,
+            delivery_id TEXT,
+            delivery_target TEXT NOT NULL,
+            payload_json TEXT NOT NULL,
+            status TEXT NOT NULL DEFAULT 'pending',
+            attempts INTEGER NOT NULL DEFAULT 0,
+            max_attempts INTEGER NOT NULL DEFAULT 12,
+            next_attempt_at INTEGER NOT NULL,
+            lease_owner TEXT,
+            lease_until INTEGER,
+            last_error TEXT,
+            created_at INTEGER NOT NULL,
+            updated_at INTEGER NOT NULL,
+            completed_at INTEGER
+          )`,
+                // Lightweight Pixiv metadata cache (novel language, rating) to cut
+                // repeated detail/full-text requests and 429 amplification.
+                `CREATE TABLE IF NOT EXISTS pixiv_metadata (
+            pixiv_id TEXT NOT NULL,
+            work_type TEXT NOT NULL,
+            language TEXT,
+            x_restrict INTEGER,
+            published_at TEXT,
+            title TEXT,
+            checked_at INTEGER NOT NULL,
+            PRIMARY KEY (pixiv_id, work_type)
           )`,
             ];
             // Phase 1: create tables (idempotent). Must run before any PRAGMA-based
@@ -139,6 +197,9 @@ class DatabaseMigration {
                 occurrence_label: `ALTER TABLE schedule_slots ADD COLUMN occurrence_label TEXT NOT NULL DEFAULT ''`,
                 timezone: `ALTER TABLE schedule_slots ADD COLUMN timezone TEXT NOT NULL DEFAULT 'UTC'`,
                 target_ids: 'ALTER TABLE schedule_slots ADD COLUMN target_ids TEXT',
+                lease_owner: 'ALTER TABLE schedule_slots ADD COLUMN lease_owner TEXT',
+                lease_until: 'ALTER TABLE schedule_slots ADD COLUMN lease_until INTEGER',
+                heartbeat_at: 'ALTER TABLE schedule_slots ADD COLUMN heartbeat_at INTEGER',
             };
             const columnAlters = [];
             for (const [col, sql] of Object.entries(slotColumnMigrations)) {
@@ -160,6 +221,11 @@ class DatabaseMigration {
                 `CREATE INDEX IF NOT EXISTS idx_slots_schedule_occ ON schedule_slots(schedule_id, occurrence_at DESC)`,
                 `CREATE INDEX IF NOT EXISTS idx_slot_items_slot ON schedule_slot_items(slot_id)`,
                 `CREATE INDEX IF NOT EXISTS idx_slot_items_work ON schedule_slot_items(work_id, work_type)`,
+                `CREATE INDEX IF NOT EXISTS idx_deliveries_dedupe ON deliveries(delivery_target, work_type, pixiv_id, status)`,
+                `CREATE UNIQUE INDEX IF NOT EXISTS idx_outbox_key ON outbox(kind, idempotency_key) WHERE idempotency_key IS NOT NULL`,
+                `CREATE INDEX IF NOT EXISTS idx_outbox_due ON outbox(status, next_attempt_at)`,
+                `CREATE INDEX IF NOT EXISTS idx_outbox_delivery ON outbox(delivery_id)`,
+                `CREATE INDEX IF NOT EXISTS idx_slots_lease ON schedule_slots(lease_until)`,
             ];
             const postMigration = this.db.transaction((stmts) => {
                 for (const sql of stmts) {

package/dist/storage/DatabaseMigration.js.map

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

package/dist/storage/repositories/DeliveryRepository.d.ts

@@ -0,0 +1,73 @@
+import { BaseRepository } from './BaseRepository';
+export type DeliveryStatus = 'pending' | 'delivered' | 'duplicate' | 'failed';
+export interface DeliveryRow {
+    id: string;
+    deliveryTarget: string;
+    workType: string;
+    pixivId: string;
+    slotId: string | null;
+    targetId: string | null;
+    idempotencyKey: string;
+    status: DeliveryStatus;
+    remoteId: string | null;
+    remoteStatus: string | null;
+    reuseReason: string | null;
+    attempts: number;
+    lastError: string | null;
+    createdAt: string;
+    updatedAt: string;
+    deliveredAt: string | null;
+}
+export interface NewDelivery {
+    id: string;
+    deliveryTarget: string;
+    workType: string;
+    pixivId: string;
+    slotId?: string | null;
+    targetId?: string | null;
+    idempotencyKey: string;
+}
+/**
+ * The delivery ledger. Answers "has this work actually been CONFIRMED delivered
+ * to this target?" — distinct from the downloads table ("was the file cached
+ * locally?"). downloaded != delivered.
+ *
+ * Dedup scope is (delivery_target, work_type, pixiv_id): bot1 having posted a
+ * work does not forbid bot2 posting it.
+ */
+export declare class DeliveryRepository extends BaseRepository {
+    /** Insert a pending intent. No-op if the idempotency key already exists. */
+    insertIntent(input: NewDelivery): {
+        row: DeliveryRow;
+        created: boolean;
+    };
+    getById(id: string): DeliveryRow | null;
+    getByIdempotencyKey(key: string): DeliveryRow | null;
+    /**
+     * True when this exact work is already CONFIRMED (delivered, or an attested
+     * historical duplicate) for this target. Pending/failed intents do not block
+     * selection — they are retried, not treated as a delivered fact.
+     */
+    isDelivered(deliveryTarget: string, workType: string, pixivId: string): boolean;
+    /** Batch form for candidate-pipeline pre-lock dedupe. */
+    deliveredIds(deliveryTarget: string, workType: string, pixivIds: string[]): Set<string>;
+    recordAck(id: string, ack: {
+        status: DeliveryStatus;
+        remoteId?: string;
+        remoteStatus?: string;
+        reuseReason?: string;
+        error?: string;
+    }): void;
+    /** Backfill a delivery fact discovered during downstream reconciliation. */
+    backfill(input: NewDelivery & {
+        remoteId?: string;
+        remoteStatus?: string;
+    }): {
+        row: DeliveryRow;
+        created: boolean;
+    };
+    pending(limit?: number): DeliveryRow[];
+    countByStatus(): Record<DeliveryStatus, number>;
+    private toRow;
+}
+//# sourceMappingURL=DeliveryRepository.d.ts.map

package/dist/storage/repositories/DeliveryRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeliveryRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/DeliveryRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,4EAA4E;IAC5E,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG;QAAE,GAAG,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAsBxE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAKvC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAKpD;;;;OAIG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAY/E,yDAAyD;IACzD,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAmBvF,SAAS,CACP,EAAE,EAAE,MAAM,EACV,GAAG,EAAE;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9G,IAAI;IAwBP,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAYnH,OAAO,CAAC,KAAK,SAAM,GAAG,WAAW,EAAE;IAOnC,aAAa,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC;IAS/C,OAAO,CAAC,KAAK;CAoBd"}

package/dist/storage/repositories/DeliveryRepository.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryRepository = void 0;
+const BaseRepository_1 = require("./BaseRepository");
+/**
+ * The delivery ledger. Answers "has this work actually been CONFIRMED delivered
+ * to this target?" — distinct from the downloads table ("was the file cached
+ * locally?"). downloaded != delivered.
+ *
+ * Dedup scope is (delivery_target, work_type, pixiv_id): bot1 having posted a
+ * work does not forbid bot2 posting it.
+ */
+class DeliveryRepository extends BaseRepository_1.BaseRepository {
+    /** Insert a pending intent. No-op if the idempotency key already exists. */
+    insertIntent(input) {
+        const info = this.db
+            .prepare(`INSERT INTO deliveries
+           (id, delivery_target, work_type, pixiv_id, slot_id, target_id, idempotency_key, status)
+         VALUES
+           (@id, @deliveryTarget, @workType, @pixivId, @slotId, @targetId, @idempotencyKey, 'pending')
+         ON CONFLICT(idempotency_key) DO NOTHING`)
+            .run({
+            id: input.id,
+            deliveryTarget: input.deliveryTarget,
+            workType: input.workType,
+            pixivId: input.pixivId,
+            slotId: input.slotId ?? null,
+            targetId: input.targetId ?? null,
+            idempotencyKey: input.idempotencyKey,
+        });
+        const created = info.changes > 0;
+        return { row: created ? this.getById(input.id) : this.getByIdempotencyKey(input.idempotencyKey), created };
+    }
+    getById(id) {
+        const row = this.db.prepare(`SELECT * FROM deliveries WHERE id = ?`).get(id);
+        return row ? this.toRow(row) : null;
+    }
+    getByIdempotencyKey(key) {
+        const row = this.db.prepare(`SELECT * FROM deliveries WHERE idempotency_key = ?`).get(key);
+        return row ? this.toRow(row) : null;
+    }
+    /**
+     * True when this exact work is already CONFIRMED (delivered, or an attested
+     * historical duplicate) for this target. Pending/failed intents do not block
+     * selection — they are retried, not treated as a delivered fact.
+     */
+    isDelivered(deliveryTarget, workType, pixivId) {
+        const row = this.db
+            .prepare(`SELECT 1 FROM deliveries
+         WHERE delivery_target = ? AND work_type = ? AND pixiv_id = ?
+           AND status IN ('delivered','duplicate')
+         LIMIT 1`)
+            .get(deliveryTarget, workType, String(pixivId));
+        return Boolean(row);
+    }
+    /** Batch form for candidate-pipeline pre-lock dedupe. */
+    deliveredIds(deliveryTarget, workType, pixivIds) {
+        const out = new Set();
+        if (pixivIds.length === 0)
+            return out;
+        const CHUNK = 400;
+        for (let i = 0; i < pixivIds.length; i += CHUNK) {
+            const slice = pixivIds.slice(i, i + CHUNK);
+            const placeholders = slice.map(() => '?').join(',');
+            const rows = this.db
+                .prepare(`SELECT DISTINCT pixiv_id FROM deliveries
+           WHERE delivery_target = ? AND work_type = ? AND status IN ('delivered','duplicate')
+             AND pixiv_id IN (${placeholders})`)
+                .all(deliveryTarget, workType, ...slice);
+            for (const r of rows)
+                out.add(r.pixiv_id);
+        }
+        return out;
+    }
+    recordAck(id, ack) {
+        const terminal = ack.status === 'delivered' || ack.status === 'duplicate' || ack.status === 'failed';
+        const sets = [
+            'status = @status',
+            'remote_id = COALESCE(@remoteId, remote_id)',
+            'remote_status = @remoteStatus',
+            'reuse_reason = @reuseReason',
+            'last_error = @error',
+            'attempts = attempts + 1',
+            'updated_at = CURRENT_TIMESTAMP',
+        ];
+        if (terminal)
+            sets.push(`delivered_at = COALESCE(delivered_at, CASE WHEN @status IN ('delivered','duplicate') THEN CURRENT_TIMESTAMP ELSE NULL END)`);
+        this.db
+            .prepare(`UPDATE deliveries SET ${sets.join(', ')} WHERE id = @id`)
+            .run({
+            id,
+            status: ack.status,
+            remoteId: ack.remoteId ?? null,
+            remoteStatus: ack.remoteStatus ?? null,
+            reuseReason: ack.reuseReason ?? null,
+            error: ack.error ?? null,
+        });
+    }
+    /** Backfill a delivery fact discovered during downstream reconciliation. */
+    backfill(input) {
+        const { row, created } = this.insertIntent(input);
+        if (created || row.status !== 'delivered') {
+            this.recordAck(input.id, {
+                status: 'delivered',
+                remoteId: input.remoteId,
+                remoteStatus: input.remoteStatus ?? 'reconciled',
+            });
+        }
+        return { row: this.getById(input.id), created };
+    }
+    pending(limit = 200) {
+        const rows = this.db
+            .prepare(`SELECT * FROM deliveries WHERE status = 'pending' ORDER BY created_at ASC LIMIT ?`)
+            .all(limit);
+        return rows.map((r) => this.toRow(r));
+    }
+    countByStatus() {
+        const rows = this.db
+            .prepare(`SELECT status, COUNT(*) AS n FROM deliveries GROUP BY status`)
+            .all();
+        const out = { pending: 0, delivered: 0, duplicate: 0, failed: 0 };
+        for (const r of rows)
+            out[r.status] = r.n;
+        return out;
+    }
+    toRow(row) {
+        return {
+            id: row.id,
+            deliveryTarget: row.delivery_target,
+            workType: row.work_type,
+            pixivId: row.pixiv_id,
+            slotId: row.slot_id,
+            targetId: row.target_id,
+            idempotencyKey: row.idempotency_key,
+            status: row.status,
+            remoteId: row.remote_id,
+            remoteStatus: row.remote_status,
+            reuseReason: row.reuse_reason,
+            attempts: row.attempts,
+            lastError: row.last_error,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            deliveredAt: row.delivered_at,
+        };
+    }
+}
+exports.DeliveryRepository = DeliveryRepository;
+//# sourceMappingURL=DeliveryRepository.js.map

package/dist/storage/repositories/DeliveryRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeliveryRepository.js","sourceRoot":"","sources":["../../../src/storage/repositories/DeliveryRepository.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAiClD;;;;;;;GAOG;AACH,MAAa,kBAAmB,SAAQ,+BAAc;IACpD,4EAA4E;IAC5E,YAAY,CAAC,KAAkB;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN;;;;iDAIyC,CAC1C;aACA,GAAG,CAAC;YACH,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC,CAAC,CAAC;QACL,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAE,EAAE,OAAO,EAAE,CAAC;IAC/G,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAQ,CAAC;QACpF,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAED,mBAAmB,CAAC,GAAW;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC,GAAG,CAAC,GAAG,CAAQ,CAAC;QAClG,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,cAAsB,EAAE,QAAgB,EAAE,OAAe;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CACN;;;iBAGS,CACV;aACA,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,yDAAyD;IACzD,YAAY,CAAC,cAAsB,EAAE,QAAgB,EAAE,QAAkB;QACvE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QACtC,MAAM,KAAK,GAAG,GAAG,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;YAC3C,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;iBACjB,OAAO,CACN;;gCAEsB,YAAY,GAAG,CACtC;iBACA,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAgC,CAAC;YAC1E,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,CACP,EAAU,EACV,GAA+G;QAE/G,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC;QACrG,MAAM,IAAI,GAAG;YACX,kBAAkB;YAClB,4CAA4C;YAC5C,+BAA+B;YAC/B,6BAA6B;YAC7B,qBAAqB;YACrB,yBAAyB;YACzB,gCAAgC;SACjC,CAAC;QACF,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,4HAA4H,CAAC,CAAC;QACtJ,IAAI,CAAC,EAAE;aACJ,OAAO,CAAC,yBAAyB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC;aAClE,GAAG,CAAC;YACH,EAAE;YACF,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI;YAC9B,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;YACtC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;YACpC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI;SACzB,CAAC,CAAC;IACP,CAAC;IAED,4EAA4E;IAC5E,QAAQ,CAAC,KAAiE;QACxE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,OAAO,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC1C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE;gBACvB,MAAM,EAAE,WAAW;gBACnB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,YAAY;aACjD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAE,EAAE,OAAO,EAAE,CAAC;IACnD,CAAC;IAED,OAAO,CAAC,KAAK,GAAG,GAAG;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,mFAAmF,CAAC;aAC5F,GAAG,CAAC,KAAK,CAAU,CAAC;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,aAAa;QACX,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,8DAA8D,CAAC;aACvE,GAAG,EAAkD,CAAC;QACzD,MAAM,GAAG,GAAmC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAClG,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,GAAQ;QACpB,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,cAAc,EAAE,GAAG,CAAC,eAAe;YACnC,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,OAAO,EAAE,GAAG,CAAC,QAAQ;YACrB,MAAM,EAAE,GAAG,CAAC,OAAO;YACnB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,cAAc,EAAE,GAAG,CAAC,eAAe;YACnC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,YAAY,EAAE,GAAG,CAAC,aAAa;YAC/B,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,WAAW,EAAE,GAAG,CAAC,YAAY;SAC9B,CAAC;IACJ,CAAC;CACF;AAnJD,gDAmJC"}

package/dist/storage/repositories/MetadataRepository.d.ts

@@ -0,0 +1,27 @@
+import { BaseRepository } from './BaseRepository';
+export interface PixivMetadata {
+    pixivId: string;
+    workType: string;
+    language: string | null;
+    xRestrict: number | null;
+    publishedAt: string | null;
+    title: string | null;
+    checkedAt: number;
+}
+/**
+ * Lightweight SQLite metadata cache. Novel language filtering otherwise issues
+ * a full detail + full-text request for every candidate on every fallback run;
+ * caching the classified result bounds request volume and reduces 429 storms.
+ * Entries expire after a TTL so fresh classifications still happen eventually.
+ */
+export declare class MetadataRepository extends BaseRepository {
+    get(pixivId: string, workType: string): PixivMetadata | null;
+    fresh(pixivId: string, workType: string, ttlMs: number, now?: number): PixivMetadata | null;
+    put(pixivId: string, workType: string, data: {
+        language?: string | null;
+        xRestrict?: number | null;
+        publishedAt?: string | null;
+        title?: string | null;
+    }, now?: number): void;
+}
+//# sourceMappingURL=MetadataRepository.d.ts.map

package/dist/storage/repositories/MetadataRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/MetadataRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAgB5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,aAAa,GAAG,IAAI;IAOvG,GAAG,CACD,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EACjH,GAAG,GAAE,MAAmB,GACvB,IAAI;CAsBR"}

package/dist/storage/repositories/MetadataRepository.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataRepository = void 0;
+const BaseRepository_1 = require("./BaseRepository");
+/**
+ * Lightweight SQLite metadata cache. Novel language filtering otherwise issues
+ * a full detail + full-text request for every candidate on every fallback run;
+ * caching the classified result bounds request volume and reduces 429 storms.
+ * Entries expire after a TTL so fresh classifications still happen eventually.
+ */
+class MetadataRepository extends BaseRepository_1.BaseRepository {
+    get(pixivId, workType) {
+        const row = this.db
+            .prepare(`SELECT * FROM pixiv_metadata WHERE pixiv_id = ? AND work_type = ?`)
+            .get(String(pixivId), workType);
+        if (!row)
+            return null;
+        return {
+            pixivId: row.pixiv_id,
+            workType: row.work_type,
+            language: row.language,
+            xRestrict: row.x_restrict,
+            publishedAt: row.published_at,
+            title: row.title,
+            checkedAt: row.checked_at,
+        };
+    }
+    fresh(pixivId, workType, ttlMs, now = Date.now()) {
+        const row = this.get(pixivId, workType);
+        if (!row)
+            return null;
+        if (now - row.checkedAt > ttlMs)
+            return null;
+        return row;
+    }
+    put(pixivId, workType, data, now = Date.now()) {
+        this.db
+            .prepare(`INSERT INTO pixiv_metadata (pixiv_id, work_type, language, x_restrict, published_at, title, checked_at)
+         VALUES (@pixivId, @workType, @language, @xRestrict, @publishedAt, @title, @now)
+         ON CONFLICT(pixiv_id, work_type) DO UPDATE SET
+           language=excluded.language,
+           x_restrict=excluded.x_restrict,
+           published_at=excluded.published_at,
+           title=excluded.title,
+           checked_at=excluded.checked_at`)
+            .run({
+            pixivId: String(pixivId),
+            workType,
+            language: data.language ?? null,
+            xRestrict: data.xRestrict ?? null,
+            publishedAt: data.publishedAt ?? null,
+            title: data.title ?? null,
+            now,
+        });
+    }
+}
+exports.MetadataRepository = MetadataRepository;
+//# sourceMappingURL=MetadataRepository.js.map

package/dist/storage/repositories/MetadataRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataRepository.js","sourceRoot":"","sources":["../../../src/storage/repositories/MetadataRepository.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAYlD;;;;;GAKG;AACH,MAAa,kBAAmB,SAAQ,+BAAc;IACpD,GAAG,CAAC,OAAe,EAAE,QAAgB;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,mEAAmE,CAAC;aAC5E,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAQ,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,QAAQ;YACrB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE,GAAG,CAAC,UAAU;SAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,QAAgB,EAAE,KAAa,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,GAAG,GAAG,GAAG,CAAC,SAAS,GAAG,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,GAAG,CACD,OAAe,EACf,QAAgB,EAChB,IAAiH,EACjH,MAAc,IAAI,CAAC,GAAG,EAAE;QAExB,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;;;;;;;0CAOkC,CACnC;aACA,GAAG,CAAC;YACH,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;YACxB,QAAQ;YACR,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;YACzB,GAAG;SACJ,CAAC,CAAC;IACP,CAAC;CACF;AAnDD,gDAmDC"}

package/dist/storage/repositories/OutboxRepository.d.ts

@@ -0,0 +1,70 @@
+import { BaseRepository } from './BaseRepository';
+export type OutboxKind = 'delivery' | 'notification';
+export type OutboxStatus = 'pending' | 'processing' | 'retry_wait' | 'done' | 'dead';
+export interface OutboxRow {
+    id: string;
+    kind: OutboxKind;
+    idempotencyKey: string | null;
+    deliveryId: string | null;
+    deliveryTarget: string;
+    payloadJson: string;
+    status: OutboxStatus;
+    attempts: number;
+    maxAttempts: number;
+    nextAttemptAt: number;
+    leaseOwner: string | null;
+    leaseUntil: number | null;
+    lastError: string | null;
+    createdAt: number;
+    updatedAt: number;
+    completedAt: number | null;
+}
+export interface NewOutboxItem {
+    kind: OutboxKind;
+    deliveryTarget: string;
+    idempotencyKey?: string | null;
+    deliveryId?: string | null;
+    payload: unknown;
+    /** Initial due time (epoch ms). Default now. */
+    dueAt?: number;
+    maxAttempts?: number;
+}
+/**
+ * SQLite transactional outbox. One durable row per intended external side
+ * effect (a content delivery or a notification). A single OutboxWorker claims
+ * due rows with a short lease, performs the effect, and marks them done. Rows
+ * survive process kill / machine stop; a restart simply resumes due rows.
+ */
+export declare class OutboxRepository extends BaseRepository {
+    static owner(): string;
+    /** Insert an intent. Returns the row. Idempotent on (kind, idempotency_key). */
+    enqueue(input: NewOutboxItem, now?: number): OutboxRow;
+    get(id: string): OutboxRow | null;
+    getByKey(kind: OutboxKind, key: string): OutboxRow | null;
+    /**
+     * Claim up to `limit` due rows for `owner`. Due = pending/retry_wait whose
+     * next_attempt_at has passed, OR processing rows whose lease expired (a
+     * crashed prior worker). The claim is a compare-and-set inside one
+     * statement, so two workers/processes never grab the same row.
+     */
+    claimDue(owner: string, leaseMs: number, limit: number, now?: number): OutboxRow[];
+    markDone(id: string, now?: number): void;
+    /** Schedule a later retry, or flip to dead once attempts are exhausted. */
+    markRetry(id: string, nextAt: number, error: string, now?: number): OutboxStatus;
+    /** Release a processing row back to pending without counting a retry. */
+    release(id: string, now?: number): void;
+    /** Reopen a dead row for one more attempt (operator / reconcile action). */
+    requeue(id: string, dueAt?: number): void;
+    counts(now?: number): {
+        pending: number;
+        retryWait: number;
+        processing: number;
+        dead: number;
+        done24h: number;
+        oldestPendingMs: number | null;
+    };
+    /** Rows still non-terminal (used by reconcile/doctor). */
+    staleProcessing(now?: number): OutboxRow[];
+    private toRow;
+}
+//# sourceMappingURL=OutboxRepository.d.ts.map

package/dist/storage/repositories/OutboxRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutboxRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/OutboxRepository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,cAAc,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAErF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,MAAM,CAAC,KAAK,IAAI,MAAM;IAItB,gFAAgF;IAChF,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,GAAE,MAAmB,GAAG,SAAS;IAgClE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAKjC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAOzD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,SAAS,EAAE;IAiC9F,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IAWpD,2EAA2E;IAC3E,SAAS,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAmB,GACvB,YAAY;IA0Bf,yEAAyE;IACzE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IASnD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,IAAI;IAUrD,MAAM,CAAC,GAAG,GAAE,MAAmB,GAAG;QAChC,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC;IAqBD,0DAA0D;IAC1D,eAAe,CAAC,GAAG,GAAE,MAAmB,GAAG,SAAS,EAAE;IAOtD,OAAO,CAAC,KAAK;CAoBd"}