@justscale/core 0.1.0

package/dist/runtime/process/signal-bus.d.ts

@@ -0,0 +1,186 @@
+/**
+ * @justscale/process - Signal Bus
+ *
+ * Abstraction for routing signals between emitters and waiting processes.
+ */
+/**
+ * A signal waiting to be delivered.
+ */
+export interface PendingSignal {
+    /** Signal name (e.g., 'orders.complete') */
+    signal: string;
+    /** Identity values for routing (e.g., { orderId: '123' }) */
+    identity: Record<string, string>;
+    /** Optional payload data */
+    payload: unknown;
+    /** When the signal was emitted */
+    emittedAt: Date;
+}
+/**
+ * A subscription to wait for signals.
+ */
+export interface SignalSubscription {
+    /** Unique subscription ID */
+    id: string;
+    /** Process instance ID waiting for this signal */
+    instanceId: string;
+    /** Signal name to wait for */
+    signal: string;
+    /** Identity filter (process params) */
+    identity: Record<string, string>;
+    /** When the subscription was created */
+    subscribedAt: Date;
+}
+/**
+ * Result of a race between multiple signals.
+ */
+export interface RaceSubscription {
+    /** Unique subscription ID */
+    id: string;
+    /** Process instance ID */
+    instanceId: string;
+    /** Branches in the race */
+    branches: RaceBranch[];
+    /** When the subscription was created */
+    subscribedAt: Date;
+}
+export interface RaceBranch {
+    /** Branch identifier */
+    branchId: string;
+    /** Signal to wait for (if signal branch) */
+    signal?: string;
+    /** Identity filter (if signal branch) */
+    identity?: Record<string, string>;
+    /** Timer expiration (if timer branch) */
+    expiresAt?: Date;
+}
+/**
+ * Result when a signal is matched.
+ */
+export interface SignalMatch {
+    /** The subscription that was matched */
+    subscriptionId: string;
+    /** Process instance ID to resume */
+    instanceId: string;
+    /** Signal payload */
+    payload: unknown;
+    /** For races, which branch won */
+    branchId?: string;
+}
+/**
+ * Signal bus interface for routing signals to processes.
+ *
+ * Implementations:
+ * - InMemorySignalBus (testing/development)
+ * - PgSignalBus (production - uses LISTEN/NOTIFY + table storage)
+ */
+export interface SignalBus {
+    /**
+     * Emit a signal to be delivered to waiting processes.
+     *
+     * @returns Number of processes that received the signal
+     */
+    emit(signal: string, identity: Record<string, string>, payload?: unknown): Promise<number>;
+    /**
+     * Subscribe to wait for a single signal.
+     * Returns subscription ID for cancellation.
+     */
+    subscribe(instanceId: string, signal: string, identity: Record<string, string>): Promise<string>;
+    /**
+     * Subscribe to a race between multiple signals/timers.
+     * Returns subscription ID for cancellation.
+     */
+    subscribeRace(instanceId: string, branches: RaceBranch[]): Promise<string>;
+    /**
+     * Cancel a subscription (signal or race).
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /**
+     * Check if a signal subscription has been matched.
+     * Returns the match if found, null otherwise.
+     */
+    checkSignal(subscriptionId: string): Promise<SignalMatch | null>;
+    /**
+     * Check if a race subscription has been resolved.
+     * Returns the winning match if found, null otherwise.
+     */
+    checkRace(subscriptionId: string): Promise<SignalMatch | null>;
+    /**
+     * Register a callback for when signals are matched.
+     * Called when emit() matches a waiting subscription.
+     * Async callbacks are awaited before emit() returns.
+     */
+    onMatch(callback: (match: SignalMatch) => void | Promise<void>): () => void;
+    /**
+     * Find subscriptions that would match the given signal and identity.
+     * Used for lock acquisition before signal emission.
+     */
+    findSubscriptions(signal: string, identity: Record<string, string>): Promise<{
+        instanceId: string;
+    }[]>;
+}
+/**
+ * Abstract signal bus for DI injection.
+ *
+ * Use this as the DI token to inject a signal bus implementation:
+ * - InMemorySignalBus (default, for single-instance apps)
+ * - PgSignalBus (for multi-instance apps using postgres)
+ *
+ * @example
+ * ```typescript
+ * // In your feature/cluster setup:
+ * .add(bindService(AbstractSignalBus, PgSignalBusService))
+ * ```
+ */
+export declare abstract class AbstractSignalBus implements SignalBus {
+    abstract emit(signal: string, identity: Record<string, string>, payload?: unknown): Promise<number>;
+    abstract subscribe(instanceId: string, signal: string, identity: Record<string, string>): Promise<string>;
+    abstract subscribeRace(instanceId: string, branches: RaceBranch[]): Promise<string>;
+    abstract unsubscribe(subscriptionId: string): Promise<void>;
+    abstract checkSignal(subscriptionId: string): Promise<SignalMatch | null>;
+    abstract checkRace(subscriptionId: string): Promise<SignalMatch | null>;
+    abstract onMatch(callback: (match: SignalMatch) => void | Promise<void>): () => void;
+    abstract findSubscriptions(signal: string, identity: Record<string, string>): Promise<{
+        instanceId: string;
+    }[]>;
+}
+/**
+ * In-memory signal bus for testing and development.
+ */
+export declare class InMemorySignalBus extends AbstractSignalBus implements SignalBus {
+    private subscriptions;
+    private races;
+    private matches;
+    private matchCallbacks;
+    private nextId;
+    private consumedRaces;
+    private processingInstances;
+    private signalQueue;
+    private generateId;
+    emit(signal: string, identity: Record<string, string>, payload?: unknown): Promise<number>;
+    subscribe(instanceId: string, signal: string, identity: Record<string, string>): Promise<string>;
+    subscribeRace(instanceId: string, branches: RaceBranch[]): Promise<string>;
+    unsubscribe(subscriptionId: string): Promise<void>;
+    checkSignal(subscriptionId: string): Promise<SignalMatch | null>;
+    checkRace(subscriptionId: string): Promise<SignalMatch | null>;
+    onMatch(callback: (match: SignalMatch) => void | Promise<void>): () => void;
+    findSubscriptions(signal: string, identity: Record<string, string>): Promise<{
+        instanceId: string;
+    }[]>;
+    private matchesIdentity;
+    private notifyMatch;
+    /**
+     * Check for expired timers in race subscriptions.
+     * Returns matches for any expired timer branches.
+     */
+    checkExpiredTimers(now?: Date): Promise<SignalMatch[]>;
+    /** Clear all state */
+    clear(): void;
+    /** Get subscription count */
+    get subscriptionCount(): number;
+    /** Get race subscription count */
+    get raceCount(): number;
+    /** Get pending match count */
+    get matchCount(): number;
+}
+//# sourceMappingURL=signal-bus.d.ts.map

package/dist/runtime/process/signal-bus.d.ts.map

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

package/dist/runtime/process/signal-bus.js

@@ -0,0 +1,256 @@
+/**
+ * @justscale/process - Signal Bus
+ *
+ * Abstraction for routing signals between emitters and waiting processes.
+ */
+// ============================================================================
+// Abstract DI Token
+// ============================================================================
+/**
+ * Abstract signal bus for DI injection.
+ *
+ * Use this as the DI token to inject a signal bus implementation:
+ * - InMemorySignalBus (default, for single-instance apps)
+ * - PgSignalBus (for multi-instance apps using postgres)
+ *
+ * @example
+ * ```typescript
+ * // In your feature/cluster setup:
+ * .add(bindService(AbstractSignalBus, PgSignalBusService))
+ * ```
+ */
+export class AbstractSignalBus {
+}
+// ============================================================================
+// In-Memory Implementation
+// ============================================================================
+/**
+ * In-memory signal bus for testing and development.
+ */
+export class InMemorySignalBus extends AbstractSignalBus {
+    subscriptions = new Map();
+    races = new Map();
+    matches = new Map();
+    matchCallbacks = new Set();
+    nextId = 1;
+    // Track races that are consumed (matched but not yet processed)
+    consumedRaces = new Set();
+    // Track instances currently being processed (to queue additional signals)
+    processingInstances = new Set();
+    // Queue signals per instance to replay after current processing completes
+    signalQueue = new Map();
+    generateId() {
+        return `sub_${this.nextId++}`;
+    }
+    async emit(signal, identity, payload) {
+        let matchCount = 0;
+        // Snapshot subscriptions before iterating. notifyMatch awaits the match
+        // callback which can resume a process that re-subscribes to the same
+        // signal - without a snapshot that new subscription is visited in the
+        // same emit() pass and receives the SAME payload a second time.
+        const subsSnapshot = [...this.subscriptions.entries()];
+        for (const [id, sub] of subsSnapshot) {
+            if (sub.signal !== signal)
+                continue;
+            if (!this.matchesIdentity(sub.identity, identity))
+                continue;
+            // Subscription may have been cancelled during a previous
+            // notifyMatch in this same emit - skip it.
+            if (!this.subscriptions.has(id))
+                continue;
+            const match = {
+                subscriptionId: id,
+                instanceId: sub.instanceId,
+                payload,
+            };
+            this.matches.set(id, match);
+            this.subscriptions.delete(id);
+            await this.notifyMatch(match);
+            matchCount++;
+        }
+        // Check race subscriptions
+        // Snapshot races to avoid iterating over newly added entries during notifyMatch
+        const racesSnapshot = [...this.races.entries()];
+        for (const [id, race] of racesSnapshot) {
+            for (const branch of race.branches) {
+                if (!branch.signal)
+                    continue;
+                if (branch.signal !== signal)
+                    continue;
+                if (branch.identity && !this.matchesIdentity(branch.identity, identity))
+                    continue;
+                const instanceId = race.instanceId;
+                // If race is consumed OR instance is processing, queue the signal
+                if (this.consumedRaces.has(id) || this.processingInstances.has(instanceId)) {
+                    const queue = this.signalQueue.get(instanceId) ?? [];
+                    queue.push({ signal, identity, payload });
+                    this.signalQueue.set(instanceId, queue);
+                    // Don't count as matched yet - will be replayed later
+                    break;
+                }
+                const match = {
+                    subscriptionId: id,
+                    instanceId,
+                    payload,
+                    branchId: branch.branchId,
+                };
+                this.matches.set(id, match);
+                // Mark as consumed AND processing BEFORE calling notifyMatch
+                // This ensures other signals for this instance get queued
+                this.consumedRaces.add(id);
+                this.processingInstances.add(instanceId);
+                try {
+                    await this.notifyMatch(match);
+                }
+                finally {
+                    this.processingInstances.delete(instanceId);
+                    // Now safe to delete the race
+                    this.consumedRaces.delete(id);
+                    this.races.delete(id);
+                }
+                // After processing, replay any queued signals for this instance
+                const queued = this.signalQueue.get(instanceId);
+                if (queued && queued.length > 0) {
+                    this.signalQueue.delete(instanceId);
+                    for (const q of queued) {
+                        await this.emit(q.signal, q.identity, q.payload);
+                    }
+                }
+                matchCount++;
+                break; // Only one branch can win
+            }
+        }
+        return matchCount;
+    }
+    async subscribe(instanceId, signal, identity) {
+        const id = this.generateId();
+        this.subscriptions.set(id, {
+            id,
+            instanceId,
+            signal,
+            identity,
+            subscribedAt: new Date(),
+        });
+        return id;
+    }
+    async subscribeRace(instanceId, branches) {
+        const id = this.generateId();
+        this.races.set(id, {
+            id,
+            instanceId,
+            branches,
+            subscribedAt: new Date(),
+        });
+        return id;
+    }
+    async unsubscribe(subscriptionId) {
+        this.subscriptions.delete(subscriptionId);
+        this.races.delete(subscriptionId);
+        this.matches.delete(subscriptionId);
+    }
+    async checkSignal(subscriptionId) {
+        return this.matches.get(subscriptionId) ?? null;
+    }
+    async checkRace(subscriptionId) {
+        return this.matches.get(subscriptionId) ?? null;
+    }
+    onMatch(callback) {
+        this.matchCallbacks.add(callback);
+        return () => this.matchCallbacks.delete(callback);
+    }
+    async findSubscriptions(signal, identity) {
+        const results = [];
+        // Check simple subscriptions
+        for (const sub of this.subscriptions.values()) {
+            if (sub.signal !== signal)
+                continue;
+            if (!this.matchesIdentity(sub.identity, identity))
+                continue;
+            results.push({ instanceId: sub.instanceId });
+        }
+        // Check race subscriptions
+        for (const race of this.races.values()) {
+            for (const branch of race.branches) {
+                if (!branch.signal)
+                    continue;
+                if (branch.signal !== signal)
+                    continue;
+                if (branch.identity && !this.matchesIdentity(branch.identity, identity))
+                    continue;
+                results.push({ instanceId: race.instanceId });
+                break; // Only need to find one matching branch per race
+            }
+        }
+        return results;
+    }
+    matchesIdentity(subscriptionIdentity, emitIdentity) {
+        for (const [key, value] of Object.entries(subscriptionIdentity)) {
+            if (emitIdentity[key] !== value)
+                return false;
+        }
+        return true;
+    }
+    async notifyMatch(match) {
+        for (const callback of this.matchCallbacks) {
+            try {
+                await callback(match);
+            }
+            catch (e) {
+                console.error('[InMemorySignalBus] Match callback error:', e);
+            }
+        }
+    }
+    // === Timer Support ===
+    /**
+     * Check for expired timers in race subscriptions.
+     * Returns matches for any expired timer branches.
+     */
+    async checkExpiredTimers(now = new Date()) {
+        const expired = [];
+        for (const [id, race] of this.races) {
+            for (const branch of race.branches) {
+                if (!branch.expiresAt)
+                    continue;
+                if (branch.expiresAt > now)
+                    continue;
+                const match = {
+                    subscriptionId: id,
+                    instanceId: race.instanceId,
+                    payload: undefined,
+                    branchId: branch.branchId,
+                };
+                this.matches.set(id, match);
+                this.races.delete(id);
+                await this.notifyMatch(match);
+                expired.push(match);
+                break; // Only one branch can win
+            }
+        }
+        return expired;
+    }
+    // === Testing Utilities ===
+    /** Clear all state */
+    clear() {
+        this.subscriptions.clear();
+        this.races.clear();
+        this.matches.clear();
+        this.matchCallbacks.clear();
+        this.consumedRaces.clear();
+        this.processingInstances.clear();
+        this.signalQueue.clear();
+        this.nextId = 1;
+    }
+    /** Get subscription count */
+    get subscriptionCount() {
+        return this.subscriptions.size;
+    }
+    /** Get race subscription count */
+    get raceCount() {
+        return this.races.size;
+    }
+    /** Get pending match count */
+    get matchCount() {
+        return this.matches.size;
+    }
+}
+//# sourceMappingURL=signal-bus.js.map

package/dist/runtime/process/signal-bus.js.map

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

package/dist/runtime/process/state-serializer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * State serializer for durable process vars.
+ *
+ * Wraps non-JSON types (Map, Set, Date, BigInt, undefined) with type tags
+ * so they survive JSONB round-trips. Uses `__$type` as the tag key to avoid
+ * collisions with user data.
+ *
+ * Types implementing the Processable protocol (Symbol.process) get automatic
+ * custom serialization. The `__types` metadata map tracks which variables
+ * used Processable descriptors, enabling correct deserialization via the
+ * runtime type registry.
+ */
+/**
+ * Deep-serialize process vars for JSONB storage.
+ * Non-JSON types are wrapped with `{__$type, v}` tags.
+ *
+ * Variables whose values implement Processable (Symbol.process) are
+ * serialized using their custom descriptor. A `__types` metadata map
+ * is added to track which variables used Processable serialization.
+ */
+export declare function serializeState(vars: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Deep-deserialize process vars from JSONB storage.
+ * Reconstructs tagged types back to their native JS equivalents.
+ *
+ * If `__types` metadata is present, variables are deserialized using
+ * their registered Processable descriptors from the type registry.
+ */
+export declare function deserializeState(vars: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=state-serializer.d.ts.map

package/dist/runtime/process/state-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-serializer.d.ts","sourceRoot":"","sources":["../../../src/runtime/process/state-serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA2KH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCrF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BvF"}