@siglo/scheduler 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Jerico de guzman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,86 @@
-# Temporary Holding Version
+# @siglo/scheduler
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> Background timer polling, distributed lock claiming, and cloud-native webhook dispatchers for Siglo durable workflows.
+
+[![NPM Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://www.npmjs.com/package/@siglo/scheduler)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+---
+
+## Features
+
+- **PostgresWaitPoller**: Selects due timers and recoverable accepted events from `siglo_wait_records`; PostgresStorageAdapter serializes continuation execution with database-session locks.
+- **MemoryWaitPoller**: Zero-daemon poller for in-memory and local development environments.
+- **CloudSchedulerWebhookHandler**: Cloud-native webhook handler for serverless event dispatchers (AWS EventBridge Scheduler, Google Cloud Tasks, Cloudflare Queues).
+- **Graceful Lifecycle**: Bounded polling loops with cooperative cancellation and `SIGTERM` handlers.
+
+---
+
+## Installation
+
+```bash
+npm install @siglo/scheduler @siglo/core @siglo/postgres pg
+```
+
+---
+
+## Quickstart
+
+### 1. PostgreSQL Background Poller Daemon
+
+```typescript
+import { Pool } from 'pg';
+import { PostgresWaitPoller } from '@siglo/scheduler';
+import { useStorage } from '@siglo/core';
+import { PostgresStorageAdapter } from '@siglo/postgres';
+import { myFlow } from './workflows';
+
+const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+const storage = new PostgresStorageAdapter({ client: pool });
+await storage.ensureTables();
+useStorage(storage);
+
+const poller = new PostgresWaitPoller({
+    client: pool,
+    pollIntervalMs: 1000,
+    batchSize: 50,
+    flowLookup: (workflowId, stackId) => myFlow
+});
+
+// Ensure tables exist and start poller loop
+await poller.ensureTable();
+poller.start();
+
+process.on('SIGTERM', async () => {
+    await poller.stop();
+    await pool.end();
+    process.exit(0);
+});
+```
+
+### 2. Cloud Webhook Dispatcher (AWS EventBridge / GCP Cloud Tasks)
+
+```typescript
+import http from 'http';
+import { createSchedulerWebhookHandler } from '@siglo/scheduler';
+import { myFlow } from './workflows';
+
+const handler = createSchedulerWebhookHandler({
+    secretToken: process.env.SCHEDULER_SECRET_TOKEN,
+    flowLookup: () => myFlow
+});
+
+http.createServer(handler).listen(8080);
+```
+
+---
+
+## Documentation
+
+For full operational runbooks and schema migration guides, see the [Scheduler Adapter Documentation](../../docs/adapters/scheduler.md).
+
+---
+
+## License
+
+MIT © Jerico de Guzman

package/dist/cloud-dispatcher.d.ts

@@ -0,0 +1,7 @@
+import { CloudSchedulerWebhookOptions, WebhookHandler } from './types';
+/**
+ * Creates an HTTP request handler for webhook-based schedulers such as
+ * AWS EventBridge Scheduler, Google Cloud Tasks, or Cloudflare Queues.
+ */
+export declare function createSchedulerWebhookHandler(options: CloudSchedulerWebhookOptions): WebhookHandler;
+//# sourceMappingURL=cloud-dispatcher.d.ts.map

package/dist/cloud-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-dispatcher.d.ts","sourceRoot":"","sources":["../src/cloud-dispatcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,4BAA4B,GAAG,cAAc,CA0EnG"}

package/dist/cloud-dispatcher.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSchedulerWebhookHandler = createSchedulerWebhookHandler;
+const core_1 = require("@siglo/core");
+/**
+ * Creates an HTTP request handler for webhook-based schedulers such as
+ * AWS EventBridge Scheduler, Google Cloud Tasks, or Cloudflare Queues.
+ */
+function createSchedulerWebhookHandler(options) {
+    return async (req, res) => {
+        if (req.method !== 'POST') {
+            res.writeHead(405, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Method Not Allowed' }));
+            return;
+        }
+        // Validate auth token if configured
+        if (options.secretToken) {
+            const authHeader = req.headers['authorization'];
+            const customToken = req.headers['x-siglo-token'];
+            let provided = typeof customToken === 'string' ? customToken.trim() : undefined;
+            if (!provided && authHeader) {
+                provided = authHeader.startsWith('Bearer ') ? authHeader.slice(7).trim() : authHeader.trim();
+            }
+            if (provided !== options.secretToken) {
+                res.writeHead(401, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Unauthorized: invalid scheduler token' }));
+                return;
+            }
+        }
+        let body = '';
+        req.on('data', chunk => {
+            body += chunk;
+        });
+        req.on('end', async () => {
+            try {
+                const parsed = body ? JSON.parse(body) : {};
+                const stackId = parsed.stackId || parsed.correlationKey;
+                if (!stackId) {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Missing required stackId or correlationKey in dispatch payload' }));
+                    return;
+                }
+                const flow = options.flowLookup(parsed.workflowId, stackId);
+                if (!flow) {
+                    res.writeHead(404, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: `Workflow definition for '${stackId}' not found` }));
+                    return;
+                }
+                if (!core_1.defaultDurableManager.getWaitingByStack(stackId) && !core_1.defaultDurableManager.getWaiting(stackId)) {
+                    core_1.defaultDurableManager.registerWait({
+                        correlationKey: stackId,
+                        stackId,
+                        eventName: 'timer',
+                        stepId: 'timer',
+                        status: 'waiting',
+                        createdAt: Date.now(),
+                        continuationStepIndex: 0
+                    });
+                }
+                const result = await (0, core_1.resumeWorkflow)(flow, stackId, parsed.payload || {
+                    event: { type: 'timer:expired', timestamp: Date.now() }
+                }, { allowExpired: true });
+                if (options.onResumed) {
+                    await options.onResumed(stackId, result);
+                }
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true, stackId }));
+            }
+            catch (err) {
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: err?.message || String(err) }));
+            }
+        });
+    };
+}
+//# sourceMappingURL=cloud-dispatcher.js.map

package/dist/cloud-dispatcher.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export * from './postgres-poller';
+export * from './memory-poller';
+export * from './cloud-dispatcher';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./postgres-poller"), exports);
+__exportStar(require("./memory-poller"), exports);
+__exportStar(require("./cloud-dispatcher"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,oDAAkC;AAClC,kDAAgC;AAChC,qDAAmC"}

package/dist/memory-poller.d.ts

@@ -0,0 +1,19 @@
+import { MemoryPollerOptions, PollerReport } from './types';
+export declare class MemoryWaitPoller {
+    private pollIntervalMs;
+    private flowLookup?;
+    private onResumed?;
+    private onFailed?;
+    private timer?;
+    private running;
+    private inFlight;
+    constructor(options?: MemoryPollerOptions);
+    /**
+     * Executes a single poll over in-memory waiting workflows and expired checkpoints.
+     */
+    pollOnce(): Promise<PollerReport>;
+    start(): void;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+}
+//# sourceMappingURL=memory-poller.d.ts.map

package/dist/memory-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-poller.d.ts","sourceRoot":"","sources":["../src/memory-poller.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,mBAAmB,EAAE,YAAY,EAAa,MAAM,SAAS,CAAC;AAEtE,qBAAa,gBAAgB;IACzB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAC,CAAoC;IACvD,OAAO,CAAC,SAAS,CAAC,CAAmC;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAkC;IACnD,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,OAAO,GAAE,mBAAwB;IAO7C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAmDvC,KAAK,IAAI,IAAI;IAwBP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,SAAS,IAAI,OAAO;CAGvB"}

package/dist/memory-poller.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryWaitPoller = void 0;
+const core_1 = require("@siglo/core");
+class MemoryWaitPoller {
+    pollIntervalMs;
+    flowLookup;
+    onResumed;
+    onFailed;
+    timer;
+    running = false;
+    inFlight = false;
+    constructor(options = {}) {
+        this.pollIntervalMs = options.pollIntervalMs && options.pollIntervalMs > 0 ? options.pollIntervalMs : 1000;
+        this.flowLookup = options.flowLookup;
+        this.onResumed = options.onResumed;
+        this.onFailed = options.onFailed;
+    }
+    /**
+     * Executes a single poll over in-memory waiting workflows and expired checkpoints.
+     */
+    async pollOnce() {
+        const report = {
+            claimed: 0,
+            resumed: 0,
+            failed: 0
+        };
+        const now = Date.now();
+        const waitingRecords = typeof core_1.defaultDurableManager.getAllWaiting === "function" ? core_1.defaultDurableManager.getAllWaiting() : [];
+        for (const waiting of waitingRecords) {
+            if (waiting.expiresAt && waiting.expiresAt <= now) {
+                report.claimed++;
+                const waitRec = {
+                    correlationKey: waiting.correlationKey,
+                    stackId: waiting.stackId,
+                    namespace: waiting.namespace,
+                    eventName: waiting.eventName,
+                    status: 'RESUMING',
+                    expiresAt: waiting.expiresAt,
+                    continuationStepIndex: waiting.continuationStepIndex,
+                    version: waiting.version
+                };
+                try {
+                    const targetFlow = this.flowLookup?.(waiting.version, waiting.stackId);
+                    let result;
+                    if (targetFlow) {
+                        result = await (0, core_1.resumeWorkflow)(targetFlow, waiting.stackId, {
+                            event: { type: 'timer:expired', timestamp: now }
+                        }, { allowExpired: true });
+                    }
+                    else {
+                        result = core_1.defaultDurableManager.resumeWait(waiting.correlationKey, true);
+                    }
+                    if (this.onResumed) {
+                        await this.onResumed(waitRec, result);
+                    }
+                    report.resumed++;
+                }
+                catch (err) {
+                    if (this.onFailed) {
+                        await this.onFailed(waitRec, err);
+                    }
+                    report.failed++;
+                }
+            }
+        }
+        return report;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        const loop = async () => {
+            if (!this.running)
+                return;
+            if (!this.inFlight) {
+                this.inFlight = true;
+                try {
+                    await this.pollOnce();
+                }
+                catch {
+                    // Swallow transient polling errors
+                }
+                finally {
+                    this.inFlight = false;
+                }
+            }
+            if (this.running) {
+                this.timer = setTimeout(loop, this.pollIntervalMs);
+            }
+        };
+        this.timer = setTimeout(loop, this.pollIntervalMs);
+    }
+    async stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        while (this.inFlight) {
+            await new Promise(r => setTimeout(r, 10));
+        }
+    }
+    isRunning() {
+        return this.running;
+    }
+}
+exports.MemoryWaitPoller = MemoryWaitPoller;
+//# sourceMappingURL=memory-poller.js.map

package/dist/memory-poller.js.map

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

package/dist/postgres-poller.d.ts

@@ -0,0 +1,28 @@
+import { PostgresPollerOptions, PollerReport } from './types';
+export declare class PostgresWaitPoller {
+    private client;
+    private waitRecordsTable;
+    private pollIntervalMs;
+    private batchSize;
+    private workerId;
+    private flowLookup?;
+    private onResumed?;
+    private onFailed?;
+    private timer?;
+    private running;
+    private inFlight;
+    constructor(options: PostgresPollerOptions);
+    /**
+     * Initializes the wait records table and performance indexes if not already present.
+     */
+    ensureTable(): Promise<void>;
+    /**
+     * Selects due timers and accepted events. The storage adapter serializes execution
+     * with a database-session lock; accepted events survive process death.
+     */
+    pollOnce(): Promise<PollerReport>;
+    start(): void;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+}
+//# sourceMappingURL=postgres-poller.d.ts.map

package/dist/postgres-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-poller.d.ts","sourceRoot":"","sources":["../src/postgres-poller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAc,MAAM,SAAS,CAAC;AAY1E,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAC,CAAsC;IACzD,OAAO,CAAC,SAAS,CAAC,CAAqC;IACvD,OAAO,CAAC,QAAQ,CAAC,CAAoC;IACrD,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,OAAO,EAAE,qBAAqB;IAc1C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BlC;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IA6FvC,KAAK,IAAI,IAAI;IAwBP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,SAAS,IAAI,OAAO;CAGvB"}

package/dist/postgres-poller.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresWaitPoller = void 0;
+const core_1 = require("@siglo/core");
+function validateIdentifier(name, label) {
+    if (!name || typeof name !== 'string') {
+        throw new Error(`${label} must be a valid identifier string.`);
+    }
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {
+        throw new Error(`Invalid SQL identifier for ${label}: "${name}". Identifier contains forbidden characters.`);
+    }
+    return name;
+}
+class PostgresWaitPoller {
+    client;
+    waitRecordsTable;
+    pollIntervalMs;
+    batchSize;
+    workerId;
+    flowLookup;
+    onResumed;
+    onFailed;
+    timer;
+    running = false;
+    inFlight = false;
+    constructor(options) {
+        if (!options || !options.client) {
+            throw new Error('PostgresWaitPoller requires a valid PostgreSQL client with a .query() method.');
+        }
+        this.client = options.client;
+        this.waitRecordsTable = validateIdentifier(options.waitRecordsTable || 'siglo_wait_records', 'waitRecordsTable');
+        this.pollIntervalMs = options.pollIntervalMs && options.pollIntervalMs > 0 ? options.pollIntervalMs : 1000;
+        this.batchSize = options.batchSize && options.batchSize > 0 ? options.batchSize : 50;
+        this.workerId = options.workerId || `worker-${process.pid}-${Math.random().toString(36).slice(2, 8)}`;
+        this.flowLookup = options.flowLookup;
+        this.onResumed = options.onResumed;
+        this.onFailed = options.onFailed;
+    }
+    /**
+     * Initializes the wait records table and performance indexes if not already present.
+     */
+    async ensureTable() {
+        await this.client.query(`
+            CREATE TABLE IF NOT EXISTS ${this.waitRecordsTable} (
+                correlation_key VARCHAR(255) PRIMARY KEY,
+                stack_id VARCHAR(255) NOT NULL,
+                namespace VARCHAR(255),
+                event_name VARCHAR(255),
+                status VARCHAR(50) NOT NULL DEFAULT 'WAITING',
+                continuation_step_index INT NOT NULL DEFAULT 0,
+                version VARCHAR(50),
+                data JSONB,
+                locked_by VARCHAR(255),
+                locked_at TIMESTAMPTZ,
+                resume_payload JSONB,
+                resumed_by VARCHAR(255),
+                resumed_at TIMESTAMPTZ,
+                expires_at TIMESTAMPTZ,
+                created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+                updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+            );
+            ALTER TABLE ${this.waitRecordsTable} ADD COLUMN IF NOT EXISTS resume_payload JSONB;
+            CREATE INDEX IF NOT EXISTS idx_${this.waitRecordsTable}_due 
+                ON ${this.waitRecordsTable}(status, expires_at);
+        `);
+    }
+    /**
+     * Selects due timers and accepted events. The storage adapter serializes execution
+     * with a database-session lock; accepted events survive process death.
+     */
+    async pollOnce() {
+        const storage = (0, core_1.getStorageAdapter)();
+        if (!storage?.withWorkflowLock || !storage.claimWaitRecord || !storage.completeWaitRecord) {
+            throw new Error('PostgresWaitPoller requires a storage adapter with workflow locks and durable claim completion');
+        }
+        const report = {
+            claimed: 0,
+            resumed: 0,
+            failed: 0
+        };
+        // Selection is advisory. resumeWorkflow obtains the per-stack database-session lock
+        // and atomically accepts the timer or replays an already persisted decision.
+        // Never fall back to a non-atomic SELECT/UPDATE claim on SQL errors.
+        const claimResult = await this.client.query(`
+            WITH due_records AS (
+                SELECT * FROM ${this.waitRecordsTable}
+                WHERE (status = 'WAITING' AND expires_at IS NOT NULL AND expires_at <= NOW())
+                   OR (status = 'RESUMING' AND resume_payload IS NOT NULL)
+                ORDER BY updated_at ASC
+                LIMIT $1
+            ) SELECT * FROM due_records`, [this.batchSize]);
+        const rows = claimResult.rows || [];
+        report.claimed = rows.length;
+        for (const row of rows) {
+            const record = {
+                correlationKey: row.correlation_key,
+                stackId: row.stack_id,
+                namespace: row.namespace,
+                eventName: row.event_name,
+                status: row.status,
+                continuationStepIndex: row.continuation_step_index !== undefined ? Number(row.continuation_step_index) : 0,
+                version: row.version,
+                data: typeof row.data === 'string' ? JSON.parse(row.data) : row.data,
+                lockedAt: row.locked_at ? new Date(row.locked_at) : undefined,
+                lockedBy: row.locked_by,
+                resumedAt: row.resumed_at ? new Date(row.resumed_at) : undefined,
+                resumedBy: row.resumed_by,
+                expiresAt: row.expires_at ? new Date(row.expires_at) : null
+            };
+            try {
+                let targetFlow;
+                if (this.flowLookup) {
+                    targetFlow = this.flowLookup(record.version, record.stackId);
+                }
+                let result;
+                if (targetFlow) {
+                    if (!core_1.defaultDurableManager.getWaitingByStack(record.stackId) && !core_1.defaultDurableManager.getWaiting(record.correlationKey)) {
+                        core_1.defaultDurableManager.registerWait({
+                            correlationKey: record.correlationKey,
+                            stackId: record.stackId,
+                            namespace: record.namespace,
+                            eventName: record.eventName || 'timer',
+                            continuationStepIndex: record.continuationStepIndex ?? 0,
+                            version: record.version,
+                            stepId: 'timer',
+                            status: 'waiting',
+                            createdAt: Date.now(),
+                            expiresAt: record.expiresAt ? (record.expiresAt instanceof Date ? record.expiresAt.getTime() : Number(record.expiresAt)) : undefined
+                        });
+                    }
+                    const savedEvent = typeof row.resume_payload === 'string' ? JSON.parse(row.resume_payload) : row.resume_payload;
+                    try {
+                        result = await (0, core_1.resumeWorkflow)(targetFlow, record.correlationKey, savedEvent ?? {
+                            ...record.data, event: { type: 'timer:expired', timestamp: Date.now() }
+                        }, { allowExpired: !savedEvent, stackId: this.workerId });
+                    }
+                    catch (error) {
+                        if (!(error instanceof core_1.WorkflowSuspendedException))
+                            throw error;
+                    }
+                }
+                else {
+                    throw new Error('No workflow registered for durable continuation');
+                }
+                if (this.onResumed) {
+                    await this.onResumed(record, result);
+                }
+                report.resumed++;
+            }
+            catch (err) {
+                if (err instanceof core_1.DuplicateEventException || err instanceof core_1.WorkflowAlreadyResumedException)
+                    continue;
+                // Leave accepted decisions recoverable; never turn them into timer events.
+                if (this.onFailed) {
+                    await this.onFailed(record, err);
+                }
+                report.failed++;
+            }
+        }
+        return report;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        const loop = async () => {
+            if (!this.running)
+                return;
+            if (!this.inFlight) {
+                this.inFlight = true;
+                try {
+                    await this.pollOnce();
+                }
+                catch {
+                    // Swallow transient polling errors to keep daemon running
+                }
+                finally {
+                    this.inFlight = false;
+                }
+            }
+            if (this.running) {
+                this.timer = setTimeout(loop, this.pollIntervalMs);
+            }
+        };
+        this.timer = setTimeout(loop, this.pollIntervalMs);
+    }
+    async stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        // Wait until currently in-flight poll loop finishes
+        while (this.inFlight) {
+            await new Promise(r => setTimeout(r, 10));
+        }
+    }
+    isRunning() {
+        return this.running;
+    }
+}
+exports.PostgresWaitPoller = PostgresWaitPoller;
+//# sourceMappingURL=postgres-poller.js.map

package/dist/postgres-poller.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+import { IncomingMessage, ServerResponse } from 'http';
+export interface WaitRecord {
+    correlationKey: string;
+    stackId: string;
+    namespace?: string;
+    eventName?: string;
+    status: 'WAITING' | 'RESUMING' | 'RESUMED' | 'FAILED' | 'EXPIRED';
+    expiresAt?: Date | string | number | null;
+    continuationStepIndex?: number;
+    version?: string;
+    data?: any;
+    lockedAt?: Date;
+    lockedBy?: string;
+    resumedAt?: Date;
+    resumedBy?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+export interface PollerReport {
+    claimed: number;
+    resumed: number;
+    failed: number;
+}
+export interface PostgresPollerOptions {
+    /** PostgreSQL Client or Pool instance */
+    client: {
+        query: (sql: string, params?: any[]) => Promise<{
+            rows: any[];
+            rowCount?: number;
+        }>;
+    };
+    /** Table name for wait records (default: 'siglo_wait_records') */
+    waitRecordsTable?: string;
+    /** Poll interval in milliseconds (default: 1000) */
+    pollIntervalMs?: number;
+    /** Max batch size of due records to claim per poll iteration (default: 50) */
+    batchSize?: number;
+    /** Unique identifier for this poller instance/worker (default: auto-generated) */
+    workerId?: string;
+    /** Deprecated for PostgresStorageAdapter: recovery now uses database-session locks, released on disconnect */
+    lockTimeoutMs?: number;
+    /** Resolver function to look up the workflow definition by workflowId or stackId */
+    flowLookup?: (workflowId?: string, stackId?: string) => any;
+    /** Optional callback invoked when a workflow is successfully resumed */
+    onResumed?: (record: WaitRecord, result: any) => void | Promise<void>;
+    /** Optional callback invoked when resumption fails */
+    onFailed?: (record: WaitRecord, error: any) => void | Promise<void>;
+}
+export interface MemoryPollerOptions {
+    /** Poll interval in milliseconds (default: 1000) */
+    pollIntervalMs?: number;
+    /** Resolver function to look up the workflow definition by workflowId or stackId */
+    flowLookup?: (workflowId?: string, stackId?: string) => any;
+    /** Optional callback invoked when a workflow is successfully resumed */
+    onResumed?: (record: WaitRecord, result: any) => void | Promise<void>;
+    /** Optional callback invoked when resumption fails */
+    onFailed?: (record: WaitRecord, error: any) => void | Promise<void>;
+}
+export interface CloudSchedulerWebhookOptions {
+    /** Shared secret token or API key expected in Authorization or X-Siglo-Token header */
+    secretToken?: string;
+    /** Resolver function to look up workflow definition */
+    flowLookup: (workflowId?: string, stackId?: string) => any;
+    /** Optional callback invoked upon successful resumption */
+    onResumed?: (stackId: string, result: any) => void | Promise<void>;
+}
+export type WebhookHandler = (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@siglo/scheduler",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Background durable timer poller and cloud scheduler dispatcher for Siglo workflows",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && mocha -r tsx --exit 'src/**/*.test.ts'"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsoftgem/siglo.git",
+    "directory": "packages/scheduler"
+  },
+  "author": "Jerico de Guzman",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jsoftgem/siglo/issues"
+  },
+  "homepage": "https://github.com/jsoftgem/siglo#readme",
+  "dependencies": {
+    "@siglo/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.3",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^26.6.5",
+    "chai": "^3.5.0",
+    "mocha": "^12.0.3",
+    "tsx": "^4.23.15",
+    "typescript": "~5.7.0"
+  }
+}