@prefactor/core 0.1.0 → 0.2.0

package/dist/transport/stdio.d.ts

@@ -1,4 +1,4 @@
-import type { Span } from '../tracing/span.js';
+import type { QueueAction } from '../queue/actions.js';
 import type { Transport } from './base.js';
 /**
  * STDIO transport emits spans as newline-delimited JSON to stdout.
@@ -21,23 +21,11 @@ export declare class StdioTransport implements Transport {
     private closed;
     private writeLock;
     /**
-     * Emit a span to stdout as JSON
+     * Emit a batch of queue actions to stdout as newline-delimited JSON
      *
-     * @param span - The span to emit
+     * @param items - The queue actions to emit
      */
-    emit(span: Span): void;
-    /**
-     * No-op for stdio transport (not applicable)
-     */
-    finishSpan(): void;
-    /**
-     * No-op for stdio transport (not applicable)
-     */
-    startAgentInstance(): void;
-    /**
-     * No-op for stdio transport (not applicable)
-     */
-    finishAgentInstance(): void;
+    processBatch(items: QueueAction[]): Promise<void>;
     /**
      * Close the transport and wait for pending writes to complete
      *

package/dist/transport/stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/transport/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqB;IAEtC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAiBtB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/transport/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqB;IAEtC;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvD;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/transport/stdio.js

@@ -20,43 +20,28 @@ export class StdioTransport {
     closed = false;
     writeLock = Promise.resolve();
     /**
-     * Emit a span to stdout as JSON
+     * Emit a batch of queue actions to stdout as newline-delimited JSON
      *
-     * @param span - The span to emit
+     * @param items - The queue actions to emit
      */
-    emit(span) {
-        if (this.closed) {
+    async processBatch(items) {
+        if (this.closed || items.length === 0) {
             return;
         }
         // Queue write to maintain ordering
         this.writeLock = this.writeLock.then(async () => {
-            try {
-                const serialized = serializeValue(span);
-                const json = JSON.stringify(serialized);
-                await Bun.write(Bun.stdout, `${json}\n`);
-            }
-            catch (error) {
-                console.error('Failed to emit span to stdout:', error);
+            for (const item of items) {
+                try {
+                    const serialized = serializeValue(item);
+                    const json = JSON.stringify(serialized);
+                    await Bun.write(Bun.stdout, `${json}\n`);
+                }
+                catch (error) {
+                    console.error('Failed to emit queue action to stdout:', error);
+                }
             }
         });
-    }
-    /**
-     * No-op for stdio transport (not applicable)
-     */
-    finishSpan() {
-        // No-op for stdio transport
-    }
-    /**
-     * No-op for stdio transport (not applicable)
-     */
-    startAgentInstance() {
-        // No-op for stdio transport
-    }
-    /**
-     * No-op for stdio transport (not applicable)
-     */
-    finishAgentInstance() {
-        // No-op for stdio transport
+        await this.writeLock;
     }
     /**
      * Close the transport and wait for pending writes to complete

package/dist/transport/stdio.js.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/transport/stdio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,GAAG,KAAK,CAAC;IACf,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtC;;;;OAIG;IACH,IAAI,CAAC,IAAU;QACb,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC9C,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;gBACxC,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU;QACR,4BAA4B;IAC9B,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,4BAA4B;IAC9B,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,4BAA4B;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;CACF"}
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/transport/stdio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,GAAG,KAAK,CAAC;IACf,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtC;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,KAAoB;QACrC,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;oBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;oBACxC,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;gBAC3C,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;CACF"}

package/dist/transport/worker.d.ts

@@ -0,0 +1,22 @@
+import type { QueueAction } from '../queue/actions.js';
+import type { Queue } from '../queue/base.js';
+import type { Transport } from './base.js';
+type WorkerConfig = {
+    batchSize: number;
+    intervalMs: number;
+};
+export declare class TransportWorker {
+    private queue;
+    private transport;
+    private config;
+    private closed;
+    private inFlightPromise;
+    private loopPromise;
+    private pendingBatch;
+    constructor(queue: Queue<QueueAction>, transport: Transport, config: WorkerConfig);
+    private start;
+    flush(timeoutMs: number): Promise<void>;
+    close(timeoutMs?: number): Promise<void>;
+}
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/transport/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/transport/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,KAAK,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,qBAAa,eAAe;IAOxB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM;IARhB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,YAAY,CAA8B;gBAGxC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,EACzB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,YAAY;YAKhB,KAAK;IAuBb,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvC,KAAK,CAAC,SAAS,SAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;CAmDpE"}

package/dist/transport/worker.js

@@ -0,0 +1,85 @@
+export class TransportWorker {
+    queue;
+    transport;
+    config;
+    closed = false;
+    inFlightPromise = null;
+    loopPromise;
+    pendingBatch = null;
+    constructor(queue, transport, config) {
+        this.queue = queue;
+        this.transport = transport;
+        this.config = config;
+        this.loopPromise = this.start();
+    }
+    async start() {
+        while (!this.closed || this.pendingBatch || this.queue.size() > 0 || this.inFlightPromise) {
+            const batch = this.pendingBatch ?? this.queue.dequeueBatch(this.config.batchSize);
+            if (batch.length === 0) {
+                await new Promise((resolve) => setTimeout(resolve, this.config.intervalMs));
+                continue;
+            }
+            try {
+                const inFlight = this.transport.processBatch(batch);
+                this.inFlightPromise = inFlight;
+                await inFlight;
+                this.pendingBatch = null;
+            }
+            catch (error) {
+                this.pendingBatch = batch;
+                console.error('TransportWorker.processBatch failed', error);
+                await new Promise((resolve) => setTimeout(resolve, this.config.intervalMs));
+            }
+            finally {
+                this.inFlightPromise = null;
+            }
+        }
+    }
+    async flush(timeoutMs) {
+        const start = Date.now();
+        while ((this.queue.size() > 0 || this.pendingBatch || this.inFlightPromise) &&
+            Date.now() - start < timeoutMs) {
+            await new Promise((resolve) => setTimeout(resolve, this.config.intervalMs));
+        }
+    }
+    async close(timeoutMs = this.config.intervalMs * 50) {
+        this.closed = true;
+        const deadline = Date.now() + timeoutMs;
+        const awaitWithTimeout = async (promise, label, timeoutMs, warnOnTimeout = true) => {
+            if (timeoutMs <= 0) {
+                if (warnOnTimeout) {
+                    console.warn(`TransportWorker.close timed out waiting for ${label}`);
+                }
+                return false;
+            }
+            const resolvedPromise = Promise.resolve(promise);
+            let timeoutId = null;
+            const timeoutPromise = new Promise((resolve) => {
+                timeoutId = setTimeout(() => resolve(false), timeoutMs);
+            });
+            const completed = await Promise.race([resolvedPromise.then(() => true), timeoutPromise]);
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            if (!completed && warnOnTimeout) {
+                console.warn(`TransportWorker.close timed out waiting for ${label}`);
+            }
+            return completed;
+        };
+        const remainingTime = () => Math.max(0, deadline - Date.now());
+        const loopCompleted = await awaitWithTimeout(this.loopPromise, 'loop to finish', remainingTime(), false);
+        if (!loopCompleted) {
+            console.warn('TransportWorker.close timed out waiting for loop to finish; closing transport now may cause potential data loss');
+        }
+        const safeTransportClose = async () => {
+            try {
+                await this.transport.close();
+            }
+            catch (error) {
+                console.error('TransportWorker.close failed', error);
+            }
+        };
+        await awaitWithTimeout(safeTransportClose(), 'transport to close', remainingTime());
+    }
+}
+//# sourceMappingURL=worker.js.map

package/dist/transport/worker.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prefactor/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Framework-agnostic observability primitives for Prefactor",
   "type": "module",
   "main": "dist/index.cjs",