@justscale/core 0.1.0

package/dist/runtime/process/timer-scheduler.js

@@ -0,0 +1,192 @@
+/**
+ * @justscale/process - Timer Scheduler
+ *
+ * Abstraction for scheduling and managing process timers.
+ */
+// ============================================================================
+// In-Memory Implementation
+// ============================================================================
+/**
+ * In-memory timer scheduler using setTimeout.
+ *
+ * Suitable for testing and single-node development.
+ * Not suitable for production - timers lost on restart.
+ */
+export class InMemoryTimerScheduler {
+    // Node's setTimeout silently clamps delays above 2^31 - 1 ms to 1 ms
+    // and emits a TimeoutOverflowWarning. Longer durable delays are armed
+    // in chunks of this size and re-armed until expiresAt is reached.
+    static TIMEOUT_MAX_MS = 2_147_483_647;
+    timers = new Map();
+    timeoutHandles = new Map();
+    fireCallbacks = new Set();
+    nextId = 1;
+    running = false;
+    generateId() {
+        return `timer_${this.nextId++}`;
+    }
+    async schedule(instanceId, expiresAt, branchId) {
+        const id = this.generateId();
+        const timer = {
+            id,
+            instanceId,
+            expiresAt,
+            branchId,
+            scheduledAt: new Date(),
+        };
+        this.timers.set(id, timer);
+        if (this.running) {
+            this.scheduleTimeout(timer);
+        }
+        return id;
+    }
+    async cancel(timerId) {
+        this.timers.delete(timerId);
+        const handle = this.timeoutHandles.get(timerId);
+        if (handle) {
+            clearTimeout(handle);
+            this.timeoutHandles.delete(timerId);
+        }
+    }
+    async cancelAll(instanceId) {
+        for (const [id, timer] of this.timers) {
+            if (timer.instanceId === instanceId) {
+                await this.cancel(id);
+            }
+        }
+    }
+    onFire(callback) {
+        this.fireCallbacks.add(callback);
+        return () => this.fireCallbacks.delete(callback);
+    }
+    receiveFire(fired) {
+        // Remove the timer if it exists (prevents double-fire)
+        this.timers.delete(fired.timerId);
+        const handle = this.timeoutHandles.get(fired.timerId);
+        if (handle) {
+            clearTimeout(handle);
+            this.timeoutHandles.delete(fired.timerId);
+        }
+        this.notifyFire(fired);
+    }
+    async checkExpired(now = new Date()) {
+        const fired = [];
+        for (const [id, timer] of this.timers) {
+            if (timer.expiresAt <= now) {
+                const result = {
+                    timerId: id,
+                    instanceId: timer.instanceId,
+                    branchId: timer.branchId,
+                };
+                fired.push(result);
+                this.timers.delete(id);
+                this.notifyFire(result);
+            }
+        }
+        return fired;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        // Schedule timeouts for existing timers
+        for (const timer of this.timers.values()) {
+            this.scheduleTimeout(timer);
+        }
+    }
+    stop() {
+        this.running = false;
+        for (const handle of this.timeoutHandles.values()) {
+            clearTimeout(handle);
+        }
+        this.timeoutHandles.clear();
+    }
+    scheduleTimeout(timer) {
+        const fire = () => {
+            // Cancelled or scheduler stopped - drop silently.
+            if (!this.timers.has(timer.id))
+                return;
+            if (!this.running)
+                return;
+            const remaining = timer.expiresAt.getTime() - Date.now();
+            if (remaining > 0) {
+                // Re-arm for the remainder. Node's setTimeout clamps delays above
+                // TIMEOUT_MAX_MS to 1ms, so we chunk long waits into multiple
+                // iterations of this callback.
+                const chunk = Math.min(remaining, InMemoryTimerScheduler.TIMEOUT_MAX_MS);
+                const next = setTimeout(fire, chunk);
+                this.timeoutHandles.set(timer.id, next);
+                return;
+            }
+            this.timers.delete(timer.id);
+            this.timeoutHandles.delete(timer.id);
+            const fired = {
+                timerId: timer.id,
+                instanceId: timer.instanceId,
+                branchId: timer.branchId,
+            };
+            this.notifyFire(fired);
+        };
+        const total = Math.max(0, timer.expiresAt.getTime() - Date.now());
+        const chunk = Math.min(total, InMemoryTimerScheduler.TIMEOUT_MAX_MS);
+        const handle = setTimeout(fire, chunk);
+        this.timeoutHandles.set(timer.id, handle);
+    }
+    notifyFire(fired) {
+        for (const callback of this.fireCallbacks) {
+            try {
+                callback(fired);
+            }
+            catch (e) {
+                console.error('[InMemoryTimerScheduler] Fire callback error:', e);
+            }
+        }
+    }
+    // === Testing Utilities ===
+    /** Clear all timers */
+    clear() {
+        this.stop();
+        this.timers.clear();
+        this.fireCallbacks.clear();
+        this.nextId = 1;
+    }
+    /** Clear all timers without removing fire callbacks (for test cleanup between tests) */
+    clearTimers() {
+        for (const handle of this.timeoutHandles.values()) {
+            clearTimeout(handle);
+        }
+        this.timeoutHandles.clear();
+        this.timers.clear();
+    }
+    /** Get timer count */
+    get timerCount() {
+        return this.timers.size;
+    }
+    /** Get pending timer count (alias for timerCount) */
+    get pendingCount() {
+        return this.timers.size;
+    }
+    /** Advance time and fire expired timers (for testing) */
+    async advanceTo(time) {
+        return this.checkExpired(time);
+    }
+    /** Fire the next timer immediately (for testing) */
+    fireNext() {
+        const timer = this.timers.values().next().value;
+        if (!timer)
+            return;
+        this.timers.delete(timer.id);
+        this.timeoutHandles.delete(timer.id);
+        const fired = {
+            timerId: timer.id,
+            instanceId: timer.instanceId,
+            branchId: timer.branchId,
+        };
+        this.notifyFire(fired);
+    }
+    /** Get all timers (for debugging) */
+    getTimers() {
+        return Array.from(this.timers.values());
+    }
+}
+//# sourceMappingURL=timer-scheduler.js.map

package/dist/runtime/process/timer-scheduler.js.map

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

package/dist/runtime/process/trace.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Process Runtime Trace Logging
+ *
+ * Lightweight tracing for the process runtime.
+ * Enable with JUSTSCALE_TRACE=1 environment variable.
+ */
+/**
+ * Trace log a message (only when JUSTSCALE_TRACE is enabled).
+ */
+export declare function trace(component: string, message: string, data?: Record<string, unknown>): void;
+/**
+ * Create a tracer for a specific component.
+ */
+export declare function createTracer(component: string): {
+    trace: (message: string, data?: Record<string, unknown>) => void;
+};
+//# sourceMappingURL=trace.d.ts.map

package/dist/runtime/process/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/runtime/process/trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAM9F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM;qBAEzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAE1D"}

package/dist/runtime/process/trace.js

@@ -0,0 +1,26 @@
+/**
+ * Process Runtime Trace Logging
+ *
+ * Lightweight tracing for the process runtime.
+ * Enable with JUSTSCALE_TRACE=1 environment variable.
+ */
+const TRACE_ENABLED = process.env.JUSTSCALE_TRACE === '1' || process.env.JUSTSCALE_TRACE === 'true';
+/**
+ * Trace log a message (only when JUSTSCALE_TRACE is enabled).
+ */
+export function trace(component, message, data) {
+    if (!TRACE_ENABLED)
+        return;
+    const timestamp = new Date().toISOString();
+    const dataStr = data ? ' ' + JSON.stringify(data) : '';
+    console.debug(`[${timestamp}] [TRACE] [${component}] ${message}${dataStr}`);
+}
+/**
+ * Create a tracer for a specific component.
+ */
+export function createTracer(component) {
+    return {
+        trace: (message, data) => trace(component, message, data),
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/runtime/process/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/runtime/process/trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,CAAC;AAEpG;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,SAAiB,EAAE,OAAe,EAAE,IAA8B;IACtF,IAAI,CAAC,aAAa;QAAE,OAAO;IAE3B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,cAAc,SAAS,KAAK,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO;QACL,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC;KAC5F,CAAC;AACJ,CAAC"}

package/dist/runtime/protobuf/encoding/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Protobuf Binary Encoding
+ *
+ * This module provides utilities for encoding and decoding protobuf wire format.
+ *
+ * @example
+ * ```typescript
+ * import { BufferWriter, BufferReader, WireType } from '@justscale/protobuf/encoding'
+ *
+ * // Encode a message
+ * const writer = new BufferWriter()
+ * writer.writeTag(1, WireType.LengthDelimited)
+ * writer.writeString('hello')
+ * const bytes = writer.finish()
+ *
+ * // Decode a message
+ * const reader = new BufferReader(bytes)
+ * const { fieldNumber, wireType } = reader.readTag()
+ * const value = reader.readString()
+ * ```
+ */
+export { WireType, type WireTypeValue, makeFieldKey, parseFieldKey, getWireTypeForScalar, usesZigZag, is64BitType, } from './wire-types.js';
+export { encodeVarint, decodeVarint, encodeZigZag, decodeZigZag, encodeZigZag32, decodeZigZag32, varintSize, } from './varint.js';
+export { BufferWriter } from './writer.js';
+export { BufferReader } from './reader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/protobuf/encoding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/protobuf/encoding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EACL,QAAQ,EACR,KAAK,aAAa,EAClB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/protobuf/encoding/index.js

@@ -0,0 +1,30 @@
+/**
+ * Protobuf Binary Encoding
+ *
+ * This module provides utilities for encoding and decoding protobuf wire format.
+ *
+ * @example
+ * ```typescript
+ * import { BufferWriter, BufferReader, WireType } from '@justscale/protobuf/encoding'
+ *
+ * // Encode a message
+ * const writer = new BufferWriter()
+ * writer.writeTag(1, WireType.LengthDelimited)
+ * writer.writeString('hello')
+ * const bytes = writer.finish()
+ *
+ * // Decode a message
+ * const reader = new BufferReader(bytes)
+ * const { fieldNumber, wireType } = reader.readTag()
+ * const value = reader.readString()
+ * ```
+ */
+// Wire types and field key utilities
+export { WireType, makeFieldKey, parseFieldKey, getWireTypeForScalar, usesZigZag, is64BitType, } from './wire-types.js';
+// Varint encoding utilities
+export { encodeVarint, decodeVarint, encodeZigZag, decodeZigZag, encodeZigZag32, decodeZigZag32, varintSize, } from './varint.js';
+// Buffer writer
+export { BufferWriter } from './writer.js';
+// Buffer reader
+export { BufferReader } from './reader.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/protobuf/encoding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/protobuf/encoding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,qCAAqC;AACrC,OAAO,EACL,QAAQ,EAER,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,4BAA4B;AAC5B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/protobuf/encoding/reader.d.ts

@@ -0,0 +1,182 @@
+/**
+ * BufferReader - Protobuf Binary Reader
+ *
+ * A utility class for reading protobuf wire format data.
+ */
+/**
+ * A reader for parsing protobuf binary messages.
+ */
+export declare class BufferReader {
+    private readonly data;
+    private readonly view;
+    private pos;
+    /**
+     * Create a new BufferReader.
+     *
+     * @param buffer - The buffer to read from
+     */
+    constructor(buffer: Uint8Array);
+    /**
+     * Get the current position in the buffer.
+     */
+    get position(): number;
+    /**
+     * Get the number of remaining bytes.
+     */
+    get remaining(): number;
+    /**
+     * Check if there are more bytes to read.
+     */
+    get hasMore(): boolean;
+    /**
+     * Read a varint (variable-length integer).
+     *
+     * @returns The decoded value as bigint
+     */
+    readVarint(): bigint;
+    /**
+     * Read a varint as a 32-bit number.
+     * Truncates the value if it exceeds 32 bits.
+     *
+     * @returns The decoded value as number
+     */
+    readVarint32(): number;
+    /**
+     * Read a field tag and return the field number and wire type.
+     *
+     * @returns Object with fieldNumber and wireType
+     */
+    readTag(): {
+        fieldNumber: number;
+        wireType: number;
+    };
+    /**
+     * Read a signed 32-bit integer with ZigZag decoding (sint32).
+     *
+     * @returns The decoded signed value
+     */
+    readSint32(): number;
+    /**
+     * Read a signed 64-bit integer with ZigZag decoding (sint64).
+     *
+     * @returns The decoded signed value as bigint
+     */
+    readSint64(): bigint;
+    /**
+     * Read a boolean value.
+     *
+     * @returns The decoded boolean
+     */
+    readBool(): boolean;
+    /**
+     * Read a 32-bit fixed integer (little-endian).
+     *
+     * @returns The decoded value
+     */
+    readFixed32(): number;
+    /**
+     * Read a 32-bit signed fixed integer (little-endian).
+     *
+     * @returns The decoded signed value
+     */
+    readSfixed32(): number;
+    /**
+     * Read a 64-bit fixed integer (little-endian).
+     *
+     * @returns The decoded value as bigint
+     */
+    readFixed64(): bigint;
+    /**
+     * Read a 64-bit signed fixed integer (little-endian).
+     *
+     * @returns The decoded signed value as bigint
+     */
+    readSfixed64(): bigint;
+    /**
+     * Read a 32-bit float (IEEE 754).
+     *
+     * @returns The decoded float value
+     */
+    readFloat(): number;
+    /**
+     * Read a 64-bit double (IEEE 754).
+     *
+     * @returns The decoded double value
+     */
+    readDouble(): number;
+    /**
+     * Read raw bytes of a specific length.
+     *
+     * @param length - The number of bytes to read
+     * @returns The bytes as Uint8Array
+     */
+    readBytes(length: number): Uint8Array;
+    /**
+     * Read a length-delimited field (length prefix + data).
+     *
+     * @returns The data as Uint8Array
+     */
+    readLengthDelimited(): Uint8Array;
+    /**
+     * Read a string (UTF-8 encoded, length-delimited).
+     *
+     * @returns The decoded string
+     */
+    readString(): string;
+    /**
+     * Skip a field based on its wire type.
+     * Used for handling unknown fields.
+     *
+     * @param wireType - The wire type of the field to skip
+     */
+    skip(wireType: number): void;
+    /**
+     * Advance the read cursor by `n` bytes, throwing if that would
+     * pass the buffer end. Mirrors readBytes's bounds check so skip
+     * paths fail at the actual problem rather than several reads later.
+     */
+    private advance;
+    /**
+     * Skip a group (deprecated protobuf feature).
+     * Groups are nested structures delimited by StartGroup/EndGroup tags.
+     */
+    private skipGroup;
+    /**
+     * Create a sub-reader for a length-delimited field.
+     * The sub-reader operates on a slice of the buffer.
+     *
+     * @returns A new BufferReader for the sub-message
+     */
+    readSubMessage(): BufferReader;
+    /**
+     * Read packed repeated values as varints.
+     *
+     * @returns Array of decoded values as bigint
+     */
+    readPackedVarint(): bigint[];
+    /**
+     * Read packed repeated values as 32-bit fixed integers.
+     *
+     * @returns Array of decoded values
+     */
+    readPackedFixed32(): number[];
+    /**
+     * Read packed repeated values as 64-bit fixed integers.
+     *
+     * @returns Array of decoded values as bigint
+     */
+    readPackedFixed64(): bigint[];
+    /**
+     * Read packed repeated values as floats.
+     *
+     * @returns Array of decoded float values
+     */
+    readPackedFloat(): number[];
+    /**
+     * Read packed repeated values as doubles.
+     *
+     * @returns Array of decoded double values
+     */
+    readPackedDouble(): number[];
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/runtime/protobuf/encoding/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../../src/runtime/protobuf/encoding/reader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,GAAG,CAAK;IAEhB;;;;OAIG;gBACS,MAAM,EAAE,UAAU;IAS9B;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAMpB;;;;;OAKG;IACH,YAAY,IAAI,MAAM;IAItB;;;;OAIG;IACH,OAAO,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAKpD;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,WAAW,IAAI,MAAM;IASrB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAStB;;;;OAIG;IACH,WAAW,IAAI,MAAM;IAUrB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAUtB;;;;OAIG;IACH,SAAS,IAAI,MAAM;IASnB;;;;OAIG;IACH,UAAU,IAAI,MAAM;IASpB;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IASrC;;;;OAIG;IACH,mBAAmB,IAAI,UAAU;IAKjC;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAMpB;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAmC5B;;;;OAIG;IACH,OAAO,CAAC,OAAO;IASf;;;OAGG;IACH,OAAO,CAAC,SAAS;IAWjB;;;;;OAKG;IACH,cAAc,IAAI,YAAY;IAK9B;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAU5B;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAU7B;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAU7B;;;;OAIG;IACH,eAAe,IAAI,MAAM,EAAE;IAU3B;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE;CAS7B"}