@pgflow/edge-worker 0.1.14 → 0.1.15

package/dist/README.md

@@ -1,46 +0,0 @@
-<div align="center">
-  <h1>Edge Worker</h1>
-  <a href="https://pgflow.dev">
-    <h3>📚 Documentation @ pgflow.dev</h3>
-  </a>
-  
-  <h4>⚠️ <strong>ADVANCED PROOF of CONCEPT - NOT PRODUCTION READY</strong> ⚠️</h4>
-</div>
-
-A task queue worker for Supabase Edge Functions that extends background tasks with useful features.
-
-> [!NOTE]
-> This project is licensed under [AGPL v3](./LICENSE.md) license and is part of **pgflow** stack.
-> See [LICENSING_OVERVIEW.md](../../LICENSING_OVERVIEW.md) in root of this monorepo for more details.
-
-## What is Edge Worker?
-
-Edge Worker processes messages from a queue and executes user-defined functions with their payloads. It builds upon [Supabase Background Tasks](https://supabase.com/docs/guides/functions/background-tasks) to add reliability features like retries, concurrency control and monitoring.
-
-## Key Features
-
-- ⚡ **Reliable Processing**: Retries with configurable delays
-- 🔄 **Concurrency Control**: Limit parallel task execution
-- 📊 **Observability**: Built-in heartbeats and logging
-- 📈 **Horizontal Scaling**: Deploy multiple edge functions for the same queue
-- 🛡️ **Edge-Native**: Designed for Edge Functions' CPU/clock limits
-
-## How It Works
-
-[![Architecture Diagram](https://mermaid.ink/img/pako:eNplkcFugzAMhl8lyrl9AQ47VLBxqdSqlZAGHEziASokyEkmTaXvvoR0o1VziGL_n_9Y9pULLZEnvFItwdSxc1op5o9xTUxU_OQmaMAgy2SL7N0pYXutTMUjGU5WlItYaLog1VFAJSv14paCXdweyw8f-2MZLnZ06LBelXxXRk_DztAM-Gp9KA-kpRP-W7bdvs3Ga4aNaAy0OC_WdzD4B4IQVsLMvvkIZMUiA4mu_8ZHYjW5MxNp4dUnKC9zUHJA-h9R_VQTG-sQyDYINlTs-IaPSCP00q_gGvCK2w5HP53EPyXQJczp5jlwVp9-lOCJJYcbTtq13V_gJgkW0x78lEeefMFgfHYC9an1GqPsraZ9XPiy99svlAqmtA?type=png)](https://mermaid.live/edit#pako:eNplkcFugzAMhl8lyrl9AQ47VLBxqdSqlZAGHEziASokyEkmTaXvvoR0o1VziGL_n_9Y9pULLZEnvFItwdSxc1op5o9xTUxU_OQmaMAgy2SL7N0pYXutTMUjGU5WlItYaLog1VFAJSv14paCXdweyw8f-2MZLnZ06LBelXxXRk_DztAM-Gp9KA-kpRP-W7bdvs3Ga4aNaAy0OC_WdzD4B4IQVsLMvvkIZMUiA4mu_8ZHYjW5MxNp4dUnKC9zUHJA-h9R_VQTG-sQyDYINlTs-IaPSCP00q_gGvCK2w5HP53EPyXQJczp5jlwVp9-lOCJJYcbTtq13V_gJgkW0x78lEeefMFgfHYC9an1GqPsraZ9XPiy99svlAqmtA)
-
-## Edge Function Optimization
-
-Edge Worker is specifically designed to handle Edge Function limitations:
-
-- Stops polling near CPU/clock limits
-- Gracefully aborts pending tasks
-- Uses PGMQ's visibility timeout to prevent message loss
-- Auto-spawns new instances for continuous operation
-- Monitors worker health with database heartbeats
-
-
-## Documentation
-
-For detailed documentation and getting started guide, visit [pgflow.dev](https://pgflow.dev).
-

package/dist/core/BatchProcessor.d.ts

@@ -1,13 +0,0 @@
-import type { ExecutionController } from './ExecutionController.js';
-import type { IMessage, IPoller } from './types.js';
-import type { Logger } from '../platform/types.js';
-export declare class BatchProcessor<TMessage extends IMessage> {
-    private executionController;
-    private poller;
-    private signal;
-    private logger;
-    constructor(executionController: ExecutionController<TMessage>, poller: IPoller<TMessage>, signal: AbortSignal, logger: Logger);
-    processBatch(): Promise<void>;
-    awaitCompletion(): Promise<void>;
-}
-//# sourceMappingURL=BatchProcessor.d.ts.map

package/dist/core/BatchProcessor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BatchProcessor.d.ts","sourceRoot":"","sources":["../../src/core/BatchProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qBAAa,cAAc,CAAC,QAAQ,SAAS,QAAQ;IAIjD,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,MAAM,CAAS;gBAGb,mBAAmB,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EAClD,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,EACzB,MAAM,EAAE,WAAW,EAC3B,MAAM,EAAE,MAAM;IAQV,YAAY;IAiBZ,eAAe;CAGtB"}

package/dist/core/BatchProcessor.js

@@ -1,29 +0,0 @@
-export class BatchProcessor {
-    executionController;
-    poller;
-    signal;
-    logger;
-    constructor(executionController, poller, signal, logger) {
-        this.executionController = executionController;
-        this.poller = poller;
-        this.signal = signal;
-        this.executionController = executionController;
-        this.signal = signal;
-        this.poller = poller;
-        this.logger = logger;
-    }
-    async processBatch() {
-        this.logger.debug('Polling for new batch of messages...');
-        const messageRecords = await this.poller.poll();
-        if (this.signal.aborted) {
-            this.logger.info('Discarding messageRecords because worker is stopping');
-            return;
-        }
-        this.logger.debug(`Starting ${messageRecords.length} messages`);
-        const startPromises = messageRecords.map((message) => this.executionController.start(message));
-        await Promise.all(startPromises);
-    }
-    async awaitCompletion() {
-        return await this.executionController.awaitCompletion();
-    }
-}

package/dist/core/ExecutionController.d.ts

@@ -1,15 +0,0 @@
-import type { IExecutor, IMessage } from './types.js';
-import type { Logger } from '../platform/types.js';
-export interface ExecutionConfig {
-    maxConcurrent: number;
-}
-export declare class ExecutionController<TMessage extends IMessage> {
-    private logger;
-    private promiseQueue;
-    private signal;
-    private createExecutor;
-    constructor(executorFactory: (record: TMessage, signal: AbortSignal) => IExecutor, abortSignal: AbortSignal, config: ExecutionConfig, logger: Logger);
-    start(record: TMessage): Promise<void>;
-    awaitCompletion(): Promise<void>;
-}
-//# sourceMappingURL=ExecutionController.d.ts.map

package/dist/core/ExecutionController.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExecutionController.d.ts","sourceRoot":"","sources":["../../src/core/ExecutionController.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,mBAAmB,CAAC,QAAQ,SAAS,QAAQ;IACxD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAAuD;gBAG3E,eAAe,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,KAAK,SAAS,EACrE,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM;IAQV,KAAK,CAAC,MAAM,EAAE,QAAQ;IAiBtB,eAAe;CAStB"}

package/dist/core/ExecutionController.js

@@ -1,34 +0,0 @@
-import { newQueue } from '@henrygd/queue';
-export class ExecutionController {
-    logger;
-    promiseQueue;
-    signal;
-    createExecutor;
-    constructor(executorFactory, abortSignal, config, logger) {
-        this.signal = abortSignal;
-        this.createExecutor = executorFactory;
-        this.promiseQueue = newQueue(config.maxConcurrent);
-        this.logger = logger;
-    }
-    async start(record) {
-        const executor = this.createExecutor(record, this.signal);
-        this.logger.info(`Scheduling execution of task ${executor.msgId}`);
-        return await this.promiseQueue.add(async () => {
-            try {
-                this.logger.debug(`Executing task ${executor.msgId}...`);
-                await executor.execute();
-                this.logger.debug(`Execution successful for ${executor.msgId}`);
-            }
-            catch (error) {
-                this.logger.error(`Execution failed for ${executor.msgId}:`, error);
-                throw error;
-            }
-        });
-    }
-    async awaitCompletion() {
-        const active = this.promiseQueue.active();
-        const all = this.promiseQueue.size();
-        this.logger.debug(`Awaiting completion of all tasks... (active/all: ${active}}/${all})`);
-        await this.promiseQueue.done();
-    }
-}

package/dist/core/Heartbeat.d.ts

@@ -1,13 +0,0 @@
-import type { Queries } from './Queries.js';
-import type { WorkerRow } from './types.js';
-import type { Logger } from '../platform/types.js';
-export declare class Heartbeat {
-    private interval;
-    private queries;
-    private workerRow;
-    private logger;
-    private lastHeartbeat;
-    constructor(interval: number, queries: Queries, workerRow: WorkerRow, logger: Logger);
-    send(): Promise<void>;
-}
-//# sourceMappingURL=Heartbeat.d.ts.map

package/dist/core/Heartbeat.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Heartbeat.d.ts","sourceRoot":"","sources":["../../src/core/Heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qBAAa,SAAS;IAKlB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,SAAS;IANnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAK;gBAGhB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EAC5B,MAAM,EAAE,MAAM;IAKV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B"}

package/dist/core/Heartbeat.js

@@ -1,21 +0,0 @@
-export class Heartbeat {
-    interval;
-    queries;
-    workerRow;
-    logger;
-    lastHeartbeat = 0;
-    constructor(interval, queries, workerRow, logger) {
-        this.interval = interval;
-        this.queries = queries;
-        this.workerRow = workerRow;
-        this.logger = logger;
-    }
-    async send() {
-        const now = Date.now();
-        if (now - this.lastHeartbeat >= this.interval) {
-            await this.queries.sendHeartbeat(this.workerRow);
-            this.logger.debug('OK');
-            this.lastHeartbeat = now;
-        }
-    }
-}

package/dist/core/Queries.d.ts

@@ -1,14 +0,0 @@
-import type postgres from 'postgres';
-import type { WorkerRow } from './types.js';
-export declare class Queries {
-    private readonly sql;
-    constructor(sql: postgres.Sql);
-    onWorkerStarted({ queueName, workerId, edgeFunctionName, }: {
-        queueName: string;
-        workerId: string;
-        edgeFunctionName: string;
-    }): Promise<WorkerRow>;
-    onWorkerStopped(workerRow: WorkerRow): Promise<WorkerRow>;
-    sendHeartbeat(workerRow: WorkerRow): Promise<void>;
-}
-//# sourceMappingURL=Queries.d.ts.map

package/dist/core/Queries.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Queries.d.ts","sourceRoot":"","sources":["../../src/core/Queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,QAAQ,CAAC,GAAG;IAExC,eAAe,CAAC,EACpB,SAAS,EACT,QAAQ,EACR,gBAAgB,GACjB,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,SAAS,CAAC;IAUhB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAWzD,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAQzD"}

package/dist/core/Queries.js

@@ -1,31 +0,0 @@
-export class Queries {
-    sql;
-    constructor(sql) {
-        this.sql = sql;
-    }
-    async onWorkerStarted({ queueName, workerId, edgeFunctionName, }) {
-        const [worker] = await this.sql `
-      INSERT INTO edge_worker.workers (queue_name, worker_id, function_name)
-      VALUES (${queueName}, ${workerId}, ${edgeFunctionName})
-      RETURNING *;
-    `;
-        return worker;
-    }
-    async onWorkerStopped(workerRow) {
-        const [worker] = await this.sql `
-      UPDATE edge_worker.workers AS w
-      SET stopped_at = clock_timestamp(), last_heartbeat_at = clock_timestamp()
-      WHERE w.worker_id = ${workerRow.worker_id}
-      RETURNING *;
-    `;
-        return worker;
-    }
-    async sendHeartbeat(workerRow) {
-        await this.sql `
-      UPDATE edge_worker.workers AS w
-      SET last_heartbeat_at = clock_timestamp()
-      WHERE w.worker_id = ${workerRow.worker_id}
-      RETURNING *;
-    `;
-    }
-}

package/dist/core/Worker.d.ts

@@ -1,21 +0,0 @@
-import type postgres from 'postgres';
-import type { IBatchProcessor, ILifecycle, WorkerBootstrap } from './types.js';
-import type { Logger } from '../platform/types.js';
-export declare class Worker {
-    private lifecycle;
-    private logger;
-    private abortController;
-    private batchProcessor;
-    private sql;
-    constructor(batchProcessor: IBatchProcessor, lifecycle: ILifecycle, sql: postgres.Sql, logger: Logger);
-    startOnlyOnce(workerBootstrap: WorkerBootstrap): Promise<void>;
-    private start;
-    stop(): Promise<void>;
-    get edgeFunctionName(): string | undefined;
-    /**
-     * Returns true if worker state is Running and worker was not stopped
-     */
-    private get isMainLoopActive();
-    private get isAborted();
-}
-//# sourceMappingURL=Worker.d.ts.map

package/dist/core/Worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Worker.d.ts","sourceRoot":"","sources":["../../src/core/Worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qBAAa,MAAM;IACjB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAyB;IAEhD,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,GAAG,CAAe;gBAGxB,cAAc,EAAE,eAAe,EAC/B,SAAS,EAAE,UAAU,EACrB,GAAG,EAAE,QAAQ,CAAC,GAAG,EACjB,MAAM,EAAE,MAAM;IAQV,aAAa,CAAC,eAAe,EAAE,eAAe;YAStC,KAAK;IAyBb,IAAI;IA2BV,IAAI,gBAAgB,uBAEnB;IAED;;OAEG;IACH,OAAO,KAAK,gBAAgB,GAE3B;IAED,OAAO,KAAK,SAAS,GAEpB;CACF"}

package/dist/core/Worker.js

@@ -1,79 +0,0 @@
-export class Worker {
-    lifecycle;
-    logger;
-    abortController = new AbortController();
-    batchProcessor;
-    sql;
-    constructor(batchProcessor, lifecycle, sql, logger) {
-        this.sql = sql;
-        this.lifecycle = lifecycle;
-        this.batchProcessor = batchProcessor;
-        this.logger = logger;
-    }
-    async startOnlyOnce(workerBootstrap) {
-        if (this.lifecycle.isRunning) {
-            this.logger.debug('Worker already running, ignoring start request');
-            return;
-        }
-        await this.start(workerBootstrap);
-    }
-    async start(workerBootstrap) {
-        try {
-            await this.lifecycle.acknowledgeStart(workerBootstrap);
-            while (this.isMainLoopActive) {
-                try {
-                    await this.lifecycle.sendHeartbeat();
-                }
-                catch (error) {
-                    this.logger.error(`Error sending heartbeat: ${error}`);
-                    // Continue execution - a failed heartbeat shouldn't stop processing
-                }
-                try {
-                    await this.batchProcessor.processBatch();
-                }
-                catch (error) {
-                    this.logger.error(`Error processing batch: ${error}`);
-                    // Continue to next iteration - failed batch shouldn't stop the worker
-                }
-            }
-        }
-        catch (error) {
-            this.logger.error(`Error in worker main loop: ${error}`);
-            throw error;
-        }
-    }
-    async stop() {
-        // If the worker is already stopping or stopped, do nothing
-        if (this.lifecycle.isStopping || this.lifecycle.isStopped) {
-            return;
-        }
-        this.lifecycle.transitionToStopping();
-        try {
-            this.logger.info('-> Stopped accepting new messages');
-            this.abortController.abort();
-            this.logger.info('-> Waiting for pending tasks to complete...');
-            await this.batchProcessor.awaitCompletion();
-            this.logger.info('-> Pending tasks completed!');
-            this.lifecycle.acknowledgeStop();
-            this.logger.info('-> Closing SQL connection...');
-            await this.sql.end();
-            this.logger.info('-> SQL connection closed!');
-        }
-        catch (error) {
-            this.logger.info(`Error during worker stop: ${error}`);
-            throw error;
-        }
-    }
-    get edgeFunctionName() {
-        return this.lifecycle.edgeFunctionName;
-    }
-    /**
-     * Returns true if worker state is Running and worker was not stopped
-     */
-    get isMainLoopActive() {
-        return this.lifecycle.isRunning && !this.isAborted;
-    }
-    get isAborted() {
-        return this.abortController.signal.aborted;
-    }
-}

package/dist/core/WorkerLifecycle.d.ts

@@ -1,26 +0,0 @@
-import type { Queries } from './Queries.js';
-import type { Queue } from '../queue/Queue.js';
-import type { ILifecycle, Json, WorkerBootstrap } from './types.js';
-import type { Logger } from '../platform/types.js';
-export interface LifecycleConfig {
-    queueName: string;
-}
-export declare class WorkerLifecycle<IMessage extends Json> implements ILifecycle {
-    private workerState;
-    private heartbeat?;
-    private logger;
-    private queries;
-    private queue;
-    private workerRow?;
-    constructor(queries: Queries, queue: Queue<IMessage>, logger: Logger);
-    acknowledgeStart(workerBootstrap: WorkerBootstrap): Promise<void>;
-    acknowledgeStop(): void;
-    get edgeFunctionName(): string | undefined;
-    get queueName(): string;
-    sendHeartbeat(): Promise<void>;
-    get isRunning(): boolean;
-    get isStopping(): boolean;
-    get isStopped(): boolean;
-    transitionToStopping(): void;
-}
-//# sourceMappingURL=WorkerLifecycle.d.ts.map

package/dist/core/WorkerLifecycle.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WorkerLifecycle.d.ts","sourceRoot":"","sources":["../../src/core/WorkerLifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAa,MAAM,YAAY,CAAC;AAE/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAe,CAAC,QAAQ,SAAS,IAAI,CAAE,YAAW,UAAU;IACvE,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAY;gBAElB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM;IAO9D,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE,eAAe;IAyBf,IAAI,gBAAgB,uBAEnB;IAED,IAAI,SAAS,WAEZ;IAEK,aAAa;IAInB,IAAI,SAAS,YAEZ;IAED,IAAI,UAAU,YAEb;IAED,IAAI,SAAS,YAEZ;IAED,oBAAoB;CAGrB"}

package/dist/core/WorkerLifecycle.js

@@ -1,69 +0,0 @@
-import { Heartbeat } from './Heartbeat.js';
-import { States, WorkerState } from './WorkerState.js';
-export class WorkerLifecycle {
-    workerState;
-    heartbeat;
-    logger;
-    queries;
-    queue;
-    workerRow;
-    constructor(queries, queue, logger) {
-        this.queries = queries;
-        this.queue = queue;
-        this.logger = logger;
-        this.workerState = new WorkerState(logger);
-    }
-    async acknowledgeStart(workerBootstrap) {
-        this.workerState.transitionTo(States.Starting);
-        this.logger.info(`Ensuring queue '${this.queue.queueName}' exists...`);
-        await this.queue.safeCreate();
-        this.workerRow = await this.queries.onWorkerStarted({
-            queueName: this.queueName,
-            ...workerBootstrap,
-        });
-        this.heartbeat = new Heartbeat(5000, this.queries, this.workerRow, this.logger);
-        this.workerState.transitionTo(States.Running);
-    }
-    acknowledgeStop() {
-        this.workerState.transitionTo(States.Stopping);
-        if (!this.workerRow) {
-            throw new Error('Cannot stop worker: workerRow not set');
-        }
-        try {
-            this.logger.debug('Acknowledging worker stop...');
-            // TODO: commented out because we can live without this
-            //       but it is causing problems with DbHandler - workes does not have
-            //       enough time to fire this query before hard-terimnated
-            //       We can always check the heartbeat to see if it is still running
-            //
-            // await this.queries.onWorkerStopped(this.workerRow);
-            this.workerState.transitionTo(States.Stopped);
-            this.logger.debug('Worker stop acknowledged');
-        }
-        catch (error) {
-            this.logger.debug(`Error acknowledging worker stop: ${error}`);
-            throw error;
-        }
-    }
-    get edgeFunctionName() {
-        return this.workerRow?.function_name;
-    }
-    get queueName() {
-        return this.queue.queueName;
-    }
-    async sendHeartbeat() {
-        await this.heartbeat?.send();
-    }
-    get isRunning() {
-        return this.workerState.isRunning;
-    }
-    get isStopping() {
-        return this.workerState.isStopping;
-    }
-    get isStopped() {
-        return this.workerState.isStopped;
-    }
-    transitionToStopping() {
-        this.workerState.transitionTo(States.Stopping);
-    }
-}

package/dist/core/WorkerState.d.ts

@@ -1,37 +0,0 @@
-import type { Logger } from '../platform/types.js';
-export declare enum States {
-    /** The worker has been created but has not yet started. */
-    Created = "created",
-    /** The worker is starting but has not yet started processing messages. */
-    Starting = "starting",
-    /** The worker is processing messages. */
-    Running = "running",
-    /** The worker stopped processing messages but is still releasing resources. */
-    Stopping = "stopping",
-    /** The worker has stopped processing messages and released resources
-     * and can be discarded. */
-    Stopped = "stopped"
-}
-export declare const Transitions: Record<States, States[]>;
-export declare class TransitionError extends Error {
-    constructor(options: {
-        from: States;
-        to: States;
-    });
-}
-/**
- * Represents the state of a worker and exposes method for doing allowed transitions
- */
-export declare class WorkerState {
-    private logger;
-    private state;
-    constructor(logger: Logger);
-    get current(): States;
-    get isCreated(): boolean;
-    get isStarting(): boolean;
-    get isRunning(): boolean;
-    get isStopping(): boolean;
-    get isStopped(): boolean;
-    transitionTo(state: States): void;
-}
-//# sourceMappingURL=WorkerState.d.ts.map

package/dist/core/WorkerState.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WorkerState.d.ts","sourceRoot":"","sources":["../../src/core/WorkerState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,oBAAY,MAAM;IAChB,2DAA2D;IAC3D,OAAO,YAAY;IAEnB,0EAA0E;IAC1E,QAAQ,aAAa;IAErB,yCAAyC;IACzC,OAAO,YAAY;IAEnB,+EAA+E;IAC/E,QAAQ,aAAa;IAErB;+BAC2B;IAC3B,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAMhD,CAAC;AAEF,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;CAGlD;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAA0B;gBAE3B,MAAM,EAAE,MAAM;IAI1B,IAAI,OAAO,WAEV;IAED,IAAI,SAAS,YAEZ;IAED,IAAI,UAAU,YAEb;IAED,IAAI,SAAS,YAEZ;IAED,IAAI,UAAU,YAEb;IAED,IAAI,SAAS,YAEZ;IAED,YAAY,CAAC,KAAK,EAAE,MAAM;CAmB3B"}

package/dist/core/WorkerState.js

@@ -1,70 +0,0 @@
-export var States;
-(function (States) {
-    /** The worker has been created but has not yet started. */
-    States["Created"] = "created";
-    /** The worker is starting but has not yet started processing messages. */
-    States["Starting"] = "starting";
-    /** The worker is processing messages. */
-    States["Running"] = "running";
-    /** The worker stopped processing messages but is still releasing resources. */
-    States["Stopping"] = "stopping";
-    /** The worker has stopped processing messages and released resources
-     * and can be discarded. */
-    States["Stopped"] = "stopped";
-})(States || (States = {}));
-export const Transitions = {
-    [States.Created]: [States.Starting],
-    [States.Starting]: [States.Running],
-    [States.Running]: [States.Stopping],
-    [States.Stopping]: [States.Stopped],
-    [States.Stopped]: [], // Terminal state - no valid transitions from here
-};
-export class TransitionError extends Error {
-    constructor(options) {
-        super(`Cannot transition from ${options.from} to ${options.to}`);
-    }
-}
-/**
- * Represents the state of a worker and exposes method for doing allowed transitions
- */
-export class WorkerState {
-    logger;
-    state = States.Created;
-    constructor(logger) {
-        this.logger = logger;
-    }
-    get current() {
-        return this.state;
-    }
-    get isCreated() {
-        return this.state === States.Created;
-    }
-    get isStarting() {
-        return this.state === States.Starting;
-    }
-    get isRunning() {
-        return this.state === States.Running;
-    }
-    get isStopping() {
-        return this.state === States.Stopping;
-    }
-    get isStopped() {
-        return this.state === States.Stopped;
-    }
-    transitionTo(state) {
-        this.logger.debug(`[WorkerState] Starting transition to '${state}' (current state: ${this.state})`);
-        if (this.state === state) {
-            return;
-        }
-        if (Transitions[this.state].includes(state)) {
-            this.state = state;
-            this.logger.debug(`[WorkerState] Transitioned to '${state}'`);
-        }
-        else {
-            throw new TransitionError({
-                from: this.state,
-                to: state,
-            });
-        }
-    }
-}

package/dist/core/types.d.ts

@@ -1,39 +0,0 @@
-export type { Json } from '@pgflow/core';
-export interface IPoller<IMessage> {
-    poll(): Promise<IMessage[]>;
-}
-export interface IExecutor {
-    get msgId(): number;
-    execute(): Promise<unknown>;
-}
-export interface IMessage {
-    msg_id: number;
-}
-export interface ILifecycle {
-    acknowledgeStart(workerBootstrap: WorkerBootstrap): Promise<void>;
-    acknowledgeStop(): void;
-    sendHeartbeat(): Promise<void>;
-    get edgeFunctionName(): string | undefined;
-    get queueName(): string;
-    get isRunning(): boolean;
-    get isStopping(): boolean;
-    get isStopped(): boolean;
-    transitionToStopping(): void;
-}
-export interface IBatchProcessor {
-    processBatch(): Promise<void>;
-    awaitCompletion(): Promise<void>;
-}
-export type WorkerRow = {
-    last_heartbeat_at: string;
-    queue_name: string;
-    started_at: string;
-    stopped_at: string | null;
-    worker_id: string;
-    function_name: string;
-};
-export interface WorkerBootstrap {
-    edgeFunctionName: string;
-    workerId: string;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,OAAO,CAAC,QAAQ;IAC/B,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,KAAK,IAAI,MAAM,CAAC;IACpB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,eAAe,IAAI,IAAI,CAAC;IACxB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAAC;IAC3C,IAAI,SAAS,IAAI,MAAM,CAAC;IACxB,IAAI,SAAS,IAAI,OAAO,CAAC;IACzB,IAAI,UAAU,IAAI,OAAO,CAAC;IAC1B,IAAI,SAAS,IAAI,OAAO,CAAC;IAEzB,oBAAoB,IAAI,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/core/types.js

@@ -1 +0,0 @@
-export {};

package/dist/flow/FlowWorkerLifecycle.d.ts

@@ -1,26 +0,0 @@
-import type { Queries } from '../core/Queries.js';
-import type { ILifecycle, WorkerBootstrap } from '../core/types.js';
-import type { Logger } from '../platform/types.js';
-import type { AnyFlow } from '@pgflow/dsl';
-/**
- * A specialized WorkerLifecycle for Flow-based workers that is aware of the Flow's step types
- */
-export declare class FlowWorkerLifecycle<TFlow extends AnyFlow> implements ILifecycle {
-    private workerState;
-    private heartbeat?;
-    private logger;
-    private queries;
-    private workerRow?;
-    private flow;
-    constructor(queries: Queries, flow: TFlow, logger: Logger);
-    acknowledgeStart(workerBootstrap: WorkerBootstrap): Promise<void>;
-    acknowledgeStop(): void;
-    get edgeFunctionName(): string | undefined;
-    get queueName(): string;
-    sendHeartbeat(): Promise<void>;
-    get isRunning(): boolean;
-    get isStopping(): boolean;
-    get isStopped(): boolean;
-    transitionToStopping(): void;
-}
-//# sourceMappingURL=FlowWorkerLifecycle.d.ts.map

package/dist/flow/FlowWorkerLifecycle.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FlowWorkerLifecycle.d.ts","sourceRoot":"","sources":["../../src/flow/FlowWorkerLifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAa,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,qBAAa,mBAAmB,CAAC,KAAK,SAAS,OAAO,CAAE,YAAW,UAAU;IAC3E,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,IAAI,CAAQ;gBAER,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IAOnD,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvE,eAAe;IAiBf,IAAI,gBAAgB,uBAEnB;IAED,IAAI,SAAS,WAEZ;IAEK,aAAa;IAInB,IAAI,SAAS,YAEZ;IAED,IAAI,UAAU,YAEb;IAED,IAAI,SAAS,YAEZ;IAED,oBAAoB;CAGrB"}