@orbytautomation/engine 0.8.3 → 0.9.0

package/dist/usage/FileSpoolUsageCollector.d.ts

@@ -0,0 +1,74 @@
+import type { UsageCollector, UsageEvent } from '@dev-ecosystem/core';
+/**
+ * Transport contract for shipping usage batches to an external ingestion endpoint.
+ */
+export interface UsageBatchTransport {
+    sendBatch(events: UsageEvent[]): Promise<void>;
+}
+export interface HttpUsageBatchTransportOptions {
+    endpoint: string;
+    apiKey?: string;
+    timeoutMs?: number;
+}
+/**
+ * Minimal HTTP transport used by the file spool collector.
+ *
+ * The collector remains durable even if this transport is down because pending
+ * files are retried later.
+ */
+export declare class HttpUsageBatchTransport implements UsageBatchTransport {
+    private readonly endpoint;
+    private readonly apiKey?;
+    private readonly timeoutMs;
+    constructor(options: HttpUsageBatchTransportOptions);
+    sendBatch(events: UsageEvent[]): Promise<void>;
+}
+export interface FileSpoolUsageCollectorOptions {
+    baseDir: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+    maxRetryAttempts?: number;
+    transport?: UsageBatchTransport;
+}
+/**
+ * Durable usage collector backed by filesystem spool directories.
+ *
+ * Storage layout under baseDir:
+ * - pending/: unsent envelopes
+ * - sent/: successfully delivered envelopes
+ * - failed/: envelopes that exceeded retry attempts
+ * - events/: append-only raw JSONL archive by day
+ *
+ * All operations are intentionally non-fatal so billing telemetry never blocks
+ * workflow execution.
+ */
+export declare class FileSpoolUsageCollector implements UsageCollector {
+    readonly contractVersion: "1.0";
+    readonly target: "billing-engine";
+    private readonly baseDir;
+    private readonly pendingDir;
+    private readonly sentDir;
+    private readonly failedDir;
+    private readonly eventsDir;
+    private readonly batchSize;
+    private readonly flushIntervalMs;
+    private readonly maxRetryAttempts;
+    private readonly transport?;
+    private flushTimer?;
+    private isFlushing;
+    private lastSuccessAt?;
+    constructor(options: FileSpoolUsageCollectorOptions);
+    record(event: UsageEvent): Promise<void>;
+    recordBatch(events: UsageEvent[]): Promise<void>;
+    flush(): Promise<void>;
+    healthCheck(): Promise<{
+        healthy: boolean;
+        detail?: string;
+        lastSuccessAt?: number;
+    }>;
+    close(): Promise<void>;
+    private ensureDirs;
+    private fileNameForEvent;
+    private readEnvelope;
+}
+//# sourceMappingURL=FileSpoolUsageCollector.d.ts.map

package/dist/usage/FileSpoolUsageCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSpoolUsageCollector.d.ts","sourceRoot":"","sources":["../../src/usage/FileSpoolUsageCollector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,8BAA8B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,8BAA8B;IAM7C,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAsBvD;AASD,MAAM,WAAW,8BAA8B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IAC1D,QAAQ,CAAC,eAAe,EAAG,KAAK,CAAU;IAC1C,QAAQ,CAAC,MAAM,EAAG,gBAAgB,CAAU;IAE5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAsB;IAEjD,OAAO,CAAC,UAAU,CAAC,CAAiC;IACpD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAC,CAAS;gBAEnB,OAAO,EAAE,8BAA8B;IAsB7C,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxC,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwEtB,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBrF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,YAAY;CAQvB"}

package/dist/usage/FileSpoolUsageCollector.js

@@ -0,0 +1,225 @@
+import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Minimal HTTP transport used by the file spool collector.
+ *
+ * The collector remains durable even if this transport is down because pending
+ * files are retried later.
+ */
+export class HttpUsageBatchTransport {
+    endpoint;
+    apiKey;
+    timeoutMs;
+    constructor(options) {
+        this.endpoint = options.endpoint;
+        this.apiKey = options.apiKey;
+        this.timeoutMs = options.timeoutMs ?? 10_000;
+    }
+    async sendBatch(events) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    ...(this.apiKey ? { authorization: `Bearer ${this.apiKey}` } : {}),
+                },
+                body: JSON.stringify({ events }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Billing ingestion failed (${response.status})`);
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+/**
+ * Durable usage collector backed by filesystem spool directories.
+ *
+ * Storage layout under baseDir:
+ * - pending/: unsent envelopes
+ * - sent/: successfully delivered envelopes
+ * - failed/: envelopes that exceeded retry attempts
+ * - events/: append-only raw JSONL archive by day
+ *
+ * All operations are intentionally non-fatal so billing telemetry never blocks
+ * workflow execution.
+ */
+export class FileSpoolUsageCollector {
+    contractVersion = '1.0';
+    target = 'billing-engine';
+    baseDir;
+    pendingDir;
+    sentDir;
+    failedDir;
+    eventsDir;
+    batchSize;
+    flushIntervalMs;
+    maxRetryAttempts;
+    transport;
+    flushTimer;
+    isFlushing = false;
+    lastSuccessAt;
+    constructor(options) {
+        this.baseDir = options.baseDir;
+        this.pendingDir = join(this.baseDir, 'pending');
+        this.sentDir = join(this.baseDir, 'sent');
+        this.failedDir = join(this.baseDir, 'failed');
+        this.eventsDir = join(this.baseDir, 'events');
+        this.batchSize = options.batchSize ?? 200;
+        this.flushIntervalMs = options.flushIntervalMs ?? 60_000;
+        this.maxRetryAttempts = options.maxRetryAttempts ?? 10;
+        this.transport = options.transport;
+        this.ensureDirs();
+        if (this.transport) {
+            // Background flush is best-effort; explicit close() also triggers a flush.
+            this.flushTimer = setInterval(() => {
+                void this.flush();
+            }, this.flushIntervalMs);
+            this.flushTimer.unref?.();
+        }
+    }
+    async record(event) {
+        try {
+            this.ensureDirs();
+            const envelope = {
+                event,
+                retries: 0,
+                firstSeenAt: Date.now(),
+            };
+            const pendingFile = join(this.pendingDir, this.fileNameForEvent(event));
+            writeFileSync(pendingFile, JSON.stringify(envelope, null, 2), 'utf8');
+            // Keep an immutable day-partitioned archive for audits/reconciliation.
+            const day = new Date(event.timestamp).toISOString().slice(0, 10);
+            const archiveFile = join(this.eventsDir, `${day}.jsonl`);
+            appendFileSync(archiveFile, `${JSON.stringify(event)}\n`, 'utf8');
+        }
+        catch {
+            // Non-fatal by design
+        }
+    }
+    async recordBatch(events) {
+        for (const event of events) {
+            await this.record(event);
+        }
+    }
+    async flush() {
+        if (!this.transport || this.isFlushing) {
+            return;
+        }
+        this.isFlushing = true;
+        try {
+            this.ensureDirs();
+            const files = readdirSync(this.pendingDir)
+                .filter((name) => name.endsWith('.json'))
+                .sort();
+            for (let i = 0; i < files.length; i += this.batchSize) {
+                const chunk = files.slice(i, i + this.batchSize);
+                const envelopes = chunk
+                    .map((name) => ({
+                    name,
+                    path: join(this.pendingDir, name),
+                }))
+                    .map(({ name, path }) => ({
+                    name,
+                    path,
+                    envelope: this.readEnvelope(path),
+                }))
+                    .filter((entry) => entry.envelope !== null);
+                if (envelopes.length === 0) {
+                    continue;
+                }
+                const events = envelopes.map((entry) => entry.envelope.event);
+                try {
+                    await this.transport.sendBatch(events);
+                    this.lastSuccessAt = Date.now();
+                    // Move successfully sent files out of pending atomically.
+                    for (const entry of envelopes) {
+                        const target = join(this.sentDir, entry.name);
+                        renameSync(entry.path, target);
+                    }
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    for (const entry of envelopes) {
+                        const retries = entry.envelope.retries + 1;
+                        const updated = {
+                            ...entry.envelope,
+                            retries,
+                            lastError: errorMessage,
+                        };
+                        if (retries >= this.maxRetryAttempts) {
+                            // Preserve terminal failure context for manual replay.
+                            const failedPath = join(this.failedDir, `${Date.now()}-${entry.name}`);
+                            writeFileSync(failedPath, JSON.stringify(updated, null, 2), 'utf8');
+                            unlinkSync(entry.path);
+                        }
+                        else {
+                            writeFileSync(entry.path, JSON.stringify(updated, null, 2), 'utf8');
+                        }
+                    }
+                    break;
+                }
+            }
+        }
+        catch {
+            // Non-fatal by design
+        }
+        finally {
+            this.isFlushing = false;
+        }
+    }
+    async healthCheck() {
+        try {
+            this.ensureDirs();
+            const pending = readdirSync(this.pendingDir).filter((f) => f.endsWith('.json')).length;
+            const failed = readdirSync(this.failedDir).filter((f) => f.endsWith('.json')).length;
+            return {
+                healthy: true,
+                detail: `pending=${pending}, failed=${failed}`,
+                lastSuccessAt: this.lastSuccessAt,
+            };
+        }
+        catch {
+            return {
+                healthy: false,
+                detail: 'Unable to inspect usage spool directories',
+                lastSuccessAt: this.lastSuccessAt,
+            };
+        }
+    }
+    async close() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+        await this.flush();
+    }
+    ensureDirs() {
+        for (const dir of [this.baseDir, this.pendingDir, this.sentDir, this.failedDir, this.eventsDir]) {
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+        }
+    }
+    fileNameForEvent(event) {
+        // Keep names filesystem-safe and mostly time-ordered.
+        const ts = String(event.timestamp);
+        const id = event.id.replace(/[^a-zA-Z0-9._-]/g, '_');
+        return `${ts}-${id}.json`;
+    }
+    readEnvelope(path) {
+        try {
+            const raw = readFileSync(path, 'utf8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=FileSpoolUsageCollector.js.map

package/dist/usage/FileSpoolUsageCollector.js.map

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

package/dist/usage/NoOpUsageCollector.d.ts

@@ -0,0 +1,35 @@
+/**
+ * No-Op Usage Collector
+ *
+ * Default usage collector that silently drops all events.
+ * Used when no collector is configured.
+ *
+ * This ensures:
+ * - No execution blocking
+ * - No external dependencies required
+ * - Zero cost if usage tracking is not enabled
+ *
+ * @module usage
+ */
+import type { UsageCollector, UsageEvent } from '@dev-ecosystem/core';
+/**
+ * No-operation usage collector
+ *
+ * Implements the UsageCollector interface but does nothing with events.
+ * Used as the default collector when none is explicitly configured.
+ */
+export declare class NoOpUsageCollector implements UsageCollector {
+    /**
+     * Record a single usage event (does nothing)
+     */
+    record(_event: UsageEvent): Promise<void>;
+    /**
+     * Record multiple usage events in batch (does nothing)
+     */
+    recordBatch(_events: UsageEvent[]): Promise<void>;
+    /**
+     * Flush pending events (does nothing)
+     */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=NoOpUsageCollector.d.ts.map

package/dist/usage/NoOpUsageCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoOpUsageCollector.d.ts","sourceRoot":"","sources":["../../src/usage/NoOpUsageCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/usage/NoOpUsageCollector.js

@@ -0,0 +1,40 @@
+/**
+ * No-Op Usage Collector
+ *
+ * Default usage collector that silently drops all events.
+ * Used when no collector is configured.
+ *
+ * This ensures:
+ * - No execution blocking
+ * - No external dependencies required
+ * - Zero cost if usage tracking is not enabled
+ *
+ * @module usage
+ */
+/**
+ * No-operation usage collector
+ *
+ * Implements the UsageCollector interface but does nothing with events.
+ * Used as the default collector when none is explicitly configured.
+ */
+export class NoOpUsageCollector {
+    /**
+     * Record a single usage event (does nothing)
+     */
+    async record(_event) {
+        // No-op
+    }
+    /**
+     * Record multiple usage events in batch (does nothing)
+     */
+    async recordBatch(_events) {
+        // No-op
+    }
+    /**
+     * Flush pending events (does nothing)
+     */
+    async flush() {
+        // No-op
+    }
+}
+//# sourceMappingURL=NoOpUsageCollector.js.map

package/dist/usage/NoOpUsageCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoOpUsageCollector.js","sourceRoot":"","sources":["../../src/usage/NoOpUsageCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAC7B;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAkB;QAC7B,QAAQ;IACV,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAqB;QACrC,QAAQ;IACV,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,QAAQ;IACV,CAAC;CACF"}

package/dist/usage/UsageEventFactory.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Usage Event Factory
+ *
+ * Helper utilities for creating consistent usage events.
+ * Handles ID generation, timestamps, and defaults.
+ *
+ * @module usage
+ */
+import type { UsageEvent, UsageEventMetadata } from '@dev-ecosystem/core';
+/**
+ * Generate a unique event ID
+ *
+ * Uses random UUID-like format for distributed uniqueness.
+ * Format: timestamp-random (millisecond precision + random suffix)
+ */
+export declare function generateUsageEventId(): string;
+/**
+ * Create a workflow run usage event
+ */
+export declare function createWorkflowRunEvent(options: {
+    executionId: string;
+    workflowId?: string;
+    userId?: string;
+    workspaceId?: string;
+    metadata?: UsageEventMetadata;
+    executionMode?: string;
+    pricingTier?: string;
+    billable?: boolean;
+}): UsageEvent;
+/**
+ * Create a step execution usage event
+ */
+export declare function createStepExecuteEvent(options: {
+    executionId: string;
+    stepId: string;
+    workflowId?: string;
+    userId?: string;
+    workspaceId?: string;
+    adapterType?: string;
+    adapterName?: string;
+    durationMs?: number;
+    success?: boolean;
+    retries?: number;
+    error?: string;
+    metadata?: UsageEventMetadata;
+    pricingTier?: string;
+    billable?: boolean;
+}): UsageEvent;
+/**
+ * Create an adapter call usage event
+ */
+export declare function createAdapterCallEvent(options: {
+    executionId: string;
+    stepId?: string;
+    adapterType: string;
+    adapterName?: string;
+    workflowId?: string;
+    userId?: string;
+    workspaceId?: string;
+    durationMs?: number;
+    success?: boolean;
+    retries?: number;
+    error?: string;
+    metadata?: UsageEventMetadata;
+    pricingTier?: string;
+    billable?: boolean;
+}): UsageEvent;
+/**
+ * Create a trigger fire usage event
+ */
+export declare function createTriggerFireEvent(options: {
+    executionId: string;
+    workflowId?: string;
+    userId?: string;
+    workspaceId?: string;
+    metadata?: UsageEventMetadata;
+    pricingTier?: string;
+    billable?: boolean;
+}): UsageEvent;
+//# sourceMappingURL=UsageEventFactory.d.ts.map

package/dist/usage/UsageEventFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageEventFactory.d.ts","sourceRoot":"","sources":["../../src/usage/UsageEventFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG1E;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,UAAU,CAiBb;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,UAAU,CAuBb;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,UAAU,CAuBb;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,UAAU,CAgBb"}

package/dist/usage/UsageEventFactory.js

@@ -0,0 +1,117 @@
+/**
+ * Usage Event Factory
+ *
+ * Helper utilities for creating consistent usage events.
+ * Handles ID generation, timestamps, and defaults.
+ *
+ * @module usage
+ */
+import { randomBytes } from 'node:crypto';
+import { UsageEventType as CoreUsageEventType } from '@dev-ecosystem/core';
+/**
+ * Generate a unique event ID
+ *
+ * Uses random UUID-like format for distributed uniqueness.
+ * Format: timestamp-random (millisecond precision + random suffix)
+ */
+export function generateUsageEventId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(8).toString('hex');
+    return `${timestamp}-${random}`;
+}
+/**
+ * Create a workflow run usage event
+ */
+export function createWorkflowRunEvent(options) {
+    return {
+        id: generateUsageEventId(),
+        type: CoreUsageEventType.WORKFLOW_RUN,
+        timestamp: Date.now(),
+        product: 'orbyt',
+        executionId: options.executionId,
+        workflowId: options.workflowId,
+        userId: options.userId,
+        workspaceId: options.workspaceId,
+        executionMode: options.executionMode,
+        pricingTier: options.pricingTier,
+        billable: options.billable ?? true,
+        metadata: options.metadata ?? {
+            success: true,
+        },
+    };
+}
+/**
+ * Create a step execution usage event
+ */
+export function createStepExecuteEvent(options) {
+    return {
+        id: generateUsageEventId(),
+        type: CoreUsageEventType.STEP_EXECUTE,
+        timestamp: Date.now(),
+        product: 'orbyt',
+        executionId: options.executionId,
+        stepId: options.stepId,
+        workflowId: options.workflowId,
+        userId: options.userId,
+        workspaceId: options.workspaceId,
+        adapterType: options.adapterType,
+        adapterName: options.adapterName,
+        pricingTier: options.pricingTier,
+        billable: options.billable ?? true,
+        metadata: {
+            ...options.metadata,
+            durationMs: options.durationMs,
+            success: options.success ?? true,
+            retries: options.retries ?? 0,
+            ...(options.error && { error: options.error }),
+        },
+    };
+}
+/**
+ * Create an adapter call usage event
+ */
+export function createAdapterCallEvent(options) {
+    return {
+        id: generateUsageEventId(),
+        type: CoreUsageEventType.ADAPTER_CALL,
+        timestamp: Date.now(),
+        product: 'orbyt',
+        executionId: options.executionId,
+        stepId: options.stepId,
+        workflowId: options.workflowId,
+        userId: options.userId,
+        workspaceId: options.workspaceId,
+        adapterType: options.adapterType,
+        adapterName: options.adapterName,
+        pricingTier: options.pricingTier,
+        billable: options.billable ?? true,
+        metadata: {
+            ...options.metadata,
+            durationMs: options.durationMs,
+            success: options.success ?? true,
+            retries: options.retries ?? 0,
+            ...(options.error && { error: options.error }),
+        },
+    };
+}
+/**
+ * Create a trigger fire usage event
+ */
+export function createTriggerFireEvent(options) {
+    return {
+        id: generateUsageEventId(),
+        type: CoreUsageEventType.TRIGGER_FIRE,
+        timestamp: Date.now(),
+        product: 'orbyt',
+        executionId: options.executionId,
+        workflowId: options.workflowId,
+        userId: options.userId,
+        workspaceId: options.workspaceId,
+        pricingTier: options.pricingTier,
+        billable: options.billable ?? true,
+        metadata: options.metadata ?? {
+            success: true,
+        },
+    };
+}
+//# sourceMappingURL=UsageEventFactory.js.map

package/dist/usage/UsageEventFactory.js.map

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

package/dist/usage/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Usage Event Collection and Emission
+ *
+ * Implements canonical usage event recording for billing, analytics, and quotas.
+ *
+ * @module usage
+ */
+export { NoOpUsageCollector } from './NoOpUsageCollector.js';
+export { FileSpoolUsageCollector, HttpUsageBatchTransport, type UsageBatchTransport } from './FileSpoolUsageCollector.js';
+export { generateUsageEventId, createWorkflowRunEvent, createStepExecuteEvent, createAdapterCallEvent, createTriggerFireEvent, } from './UsageEventFactory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/usage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/usage/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC1H,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}

package/dist/usage/index.js

@@ -0,0 +1,11 @@
+/**
+ * Usage Event Collection and Emission
+ *
+ * Implements canonical usage event recording for billing, analytics, and quotas.
+ *
+ * @module usage
+ */
+export { NoOpUsageCollector } from './NoOpUsageCollector.js';
+export { FileSpoolUsageCollector, HttpUsageBatchTransport } from './FileSpoolUsageCollector.js';
+export { generateUsageEventId, createWorkflowRunEvent, createStepExecuteEvent, createAdapterCallEvent, createTriggerFireEvent, } from './UsageEventFactory.js';
+//# sourceMappingURL=index.js.map

package/dist/usage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/usage/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAA4B,MAAM,8BAA8B,CAAC;AAC1H,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}