autotel-subscribers 33.0.0 → 34.0.0

package/dist/file.cjs

@@ -0,0 +1,262 @@
+'use strict';
+
+var promises = require('fs/promises');
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+// src/file.ts
+
+// src/event-subscriber-base.ts
+var EventSubscriber = class {
+  /**
+   * Subscriber version (optional)
+   */
+  version;
+  /**
+   * Enable/disable the subscriber (default: true)
+   */
+  enabled = true;
+  /**
+   * Track pending requests for graceful shutdown
+   */
+  pendingRequests = /* @__PURE__ */ new Set();
+  /**
+   * Optional: Handle errors
+   *
+   * Override this to customize error handling (logging, retries, etc.).
+   * Default behavior: log to console.error
+   *
+   * @param error - Error that occurred
+   * @param payload - Event payload that failed
+   */
+  handleError(error, payload) {
+    console.error(
+      `[${this.name}] Failed to send ${payload.type}:`,
+      error,
+      payload
+    );
+  }
+  /**
+   * Filter out undefined and null values from attributes
+   *
+   * This improves DX by allowing callers to pass objects with optional properties
+   * without having to manually filter them first.
+   *
+   * @param attributes - Input attributes (may contain undefined/null)
+   * @returns Filtered attributes with only defined values, or undefined if empty
+   *
+   * @example
+   * ```typescript
+   * const filtered = this.filterAttributes({
+   *   userId: user.id,
+   *   email: user.email,      // might be undefined
+   *   plan: null,             // will be filtered out
+   * });
+   * // Result: { userId: 'abc', email: 'test@example.com' } or { userId: 'abc' }
+   * ```
+   */
+  filterAttributes(attributes) {
+    if (!attributes) return void 0;
+    const filtered = {};
+    for (const [key, value] of Object.entries(attributes)) {
+      if (value !== void 0 && value !== null) {
+        filtered[key] = value;
+      }
+    }
+    return Object.keys(filtered).length > 0 ? filtered : void 0;
+  }
+  /**
+   * Track an event
+   */
+  async trackEvent(name, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "event",
+      name,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel,
+      schema: options?.schema
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track a funnel step
+   */
+  async trackFunnelStep(funnelName, step, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "funnel",
+      name: `${funnelName}.${step}`,
+      funnel: funnelName,
+      step,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track an outcome
+   */
+  async trackOutcome(operationName, outcome, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "outcome",
+      name: `${operationName}.${outcome}`,
+      operation: operationName,
+      outcome,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track a value/metric
+   */
+  async trackValue(name, value, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "value",
+      name,
+      value,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track funnel progression with custom step names
+   *
+   * Unlike trackFunnelStep which uses FunnelStatus enum values,
+   * this method allows any string as the step name for flexible funnel tracking.
+   *
+   * @param funnelName - Name of the funnel (e.g., "checkout", "onboarding")
+   * @param stepName - Custom step name (e.g., "cart_viewed", "payment_entered")
+   * @param stepNumber - Optional numeric position in the funnel
+   * @param attributes - Optional event attributes
+   * @param options - Optional tracking options including autotel context
+   */
+  async trackFunnelProgression(funnelName, stepName, stepNumber, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "funnel",
+      name: `${funnelName}.${stepName}`,
+      funnel: funnelName,
+      step: stepName,
+      stepName,
+      stepNumber,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel
+    };
+    await this.send(payload);
+  }
+  /**
+   * Flush pending requests and clean up
+   *
+   * CRITICAL: Prevents race condition during shutdown
+   * 1. Disables subscriber to stop new events
+   * 2. Drains all pending requests (with retry logic)
+   * 3. Ensures flush guarantee
+   *
+   * Override this if you need custom cleanup logic (close connections, flush buffers, etc.),
+   * but ALWAYS call super.shutdown() first to drain pending requests.
+   */
+  async shutdown() {
+    this.enabled = false;
+    const maxDrainAttempts = 10;
+    const drainIntervalMs = 50;
+    for (let attempt = 0; attempt < maxDrainAttempts; attempt++) {
+      if (this.pendingRequests.size === 0) {
+        break;
+      }
+      await Promise.allSettled(this.pendingRequests);
+      if (this.pendingRequests.size > 0 && attempt < maxDrainAttempts - 1) {
+        await new Promise((resolve) => setTimeout(resolve, drainIntervalMs));
+      }
+    }
+    if (this.pendingRequests.size > 0) {
+      console.warn(
+        `[${this.name}] Shutdown completed with ${this.pendingRequests.size} pending requests still in-flight. This may indicate a bug in the subscriber or extremely slow destination.`
+      );
+    }
+  }
+  /**
+   * Internal: Send payload and track request
+   */
+  async send(payload) {
+    const request = this.sendWithErrorHandling(payload);
+    this.pendingRequests.add(request);
+    void request.finally(() => {
+      this.pendingRequests.delete(request);
+    });
+    return request;
+  }
+  /**
+   * Internal: Send with error handling
+   */
+  async sendWithErrorHandling(payload) {
+    try {
+      await this.sendToDestination(payload);
+    } catch (error) {
+      this.handleError(error, payload);
+    }
+  }
+};
+
+// src/file.ts
+var FileSubscriber = class extends EventSubscriber {
+  name = "FileSubscriber";
+  version = "1.0.0";
+  filePath;
+  pretty;
+  ensureDir;
+  transform;
+  /** Serializes writes so concurrent events never interleave on disk. */
+  writeChain = Promise.resolve();
+  dirEnsured = false;
+  constructor(config) {
+    super();
+    this.filePath = config.path;
+    this.enabled = config.enabled ?? true;
+    this.pretty = config.pretty ?? false;
+    this.ensureDir = config.mkdir ?? true;
+    this.transform = config.transform;
+  }
+  async sendToDestination(payload) {
+    if (!this.enabled) return;
+    const record = this.transform ? this.transform(payload) : payload;
+    if (record === null) return;
+    const json = this.pretty ? JSON.stringify(record, null, 2) : JSON.stringify(record);
+    const line = `${json}
+`;
+    const run = this.writeChain.then(() => this.write(line));
+    this.writeChain = run.catch(() => {
+    });
+    await run;
+  }
+  async write(line) {
+    if (this.ensureDir && !this.dirEnsured) {
+      const dir = path__default.default.dirname(this.filePath);
+      if (dir && dir !== ".") {
+        await promises.mkdir(dir, { recursive: true });
+      }
+      this.dirEnsured = true;
+    }
+    await promises.appendFile(this.filePath, line, "utf8");
+  }
+  async shutdown() {
+    await this.writeChain;
+    await super.shutdown();
+  }
+};
+
+exports.FileSubscriber = FileSubscriber;
+//# sourceMappingURL=file.cjs.map
+//# sourceMappingURL=file.cjs.map

package/dist/file.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event-subscriber-base.ts","../src/file.ts"],"names":["path","mkdir","appendFile"],"mappings":"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","file":"file.cjs","sourcesContent":["/**\n * EventSubscriber - Standard base class for building custom subscribers\n *\n * This is the recommended base class for creating custom events subscribers.\n * It provides production-ready features out of the box:\n *\n * **Built-in Features:**\n * - **Error Handling**: Automatic error catching with customizable handlers\n * - **Pending Request Tracking**: Ensures all requests complete during shutdown\n * - **Graceful Shutdown**: Drains pending requests before closing\n * - **Enable/Disable**: Runtime control to turn subscriber on/off\n * - **Normalized Payload**: Consistent event structure across all event types\n *\n * **When to use:**\n * - Building custom subscribers for any platform\n * - Production deployments requiring reliability\n * - Need graceful shutdown and error handling\n *\n * @example Basic usage\n * ```typescript\n * import { EventSubscriber, EventPayload } from 'autotel-subscribers';\n *\n * class SnowflakeSubscriber extends EventSubscriber {\n *   name = 'SnowflakeSubscriber';\n *   version = '1.0.0';\n *\n *   protected async sendToDestination(payload: EventPayload): Promise<void> {\n *     await snowflakeClient.execute(\n *       `INSERT INTO events VALUES (?, ?, ?)`,\n *       [payload.type, payload.name, JSON.stringify(payload.attributes)]\n *     );\n *   }\n * }\n * ```\n *\n * @example With buffering\n * ```typescript\n * class BufferedSubscriber extends EventSubscriber {\n *   name = 'BufferedSubscriber';\n *   private buffer: EventPayload[] = [];\n *\n *   protected async sendToDestination(payload: EventPayload): Promise<void> {\n *     this.buffer.push(payload);\n *\n *     if (this.buffer.length >= 100) {\n *       await this.flush();\n *     }\n *   }\n *\n *   async shutdown(): Promise<void> {\n *     await super.shutdown(); // Drain pending requests first\n *     await this.flush(); // Then flush buffer\n *   }\n *\n *   private async flush(): Promise<void> {\n *     if (this.buffer.length === 0) return;\n *\n *     const batch = [...this.buffer];\n *     this.buffer = [];\n *\n *     await apiClient.sendBatch(batch);\n *   }\n * }\n * ```\n */\n\nimport type {\n  EventSubscriber as IEventSubscriber,\n  EventAttributes,\n  EventAttributesInput,\n  FunnelStatus,\n  OutcomeStatus,\n  AutotelEventContext,\n  EventTrackingOptions,\n} from 'autotel/event-subscriber';\n\n// Re-export types for convenience\nexport type { AutotelEventContext, EventTrackingOptions } from 'autotel/event-subscriber';\n\n/**\n * Payload sent to destination\n */\nexport interface EventPayload {\n  /** Event type: 'event', 'funnel', 'outcome', or 'value' */\n  type: 'event' | 'funnel' | 'outcome' | 'value';\n\n  /** Event name or metric name */\n  name: string;\n\n  /** Optional attributes */\n  attributes?: EventAttributes;\n\n  /** For funnel events: funnel name */\n  funnel?: string;\n\n  /** For funnel events: step status (from FunnelStatus enum) */\n  step?: FunnelStatus | string;\n\n  /** For funnel events: custom step name (from trackFunnelProgression) */\n  stepName?: string;\n\n  /** For funnel events: numeric position in funnel */\n  stepNumber?: number;\n\n  /** For outcome events: operation name */\n  operation?: string;\n\n  /** For outcome events: outcome status */\n  outcome?: OutcomeStatus;\n\n  /** For value events: numeric value */\n  value?: number;\n\n  /** Timestamp (ISO 8601) */\n  timestamp: string;\n\n  /**\n   * Autotel trace context (present when events.includeTraceContext is enabled)\n   *\n   * Subscribers should map these to platform-specific field names:\n   * - PostHog: autotel.trace_id → $trace_id\n   * - Mixpanel: autotel.trace_id → trace_id\n   */\n  autotel?: AutotelEventContext;\n  /** Optional schema metadata for contract-aware subscribers. */\n  schema?: EventTrackingOptions['schema'];\n}\n\n/**\n * Standard base class for building custom events subscribers\n *\n * **What it provides:**\n * - Consistent payload structure (normalized across all event types)\n * - Enable/disable flag (runtime control)\n * - Automatic error handling (with customizable error handlers)\n * - Pending requests tracking (ensures no lost events during shutdown)\n * - Graceful shutdown (drains pending requests before closing)\n *\n * **Usage:**\n * Extend this class and implement `sendToDestination()`. All other methods\n * (trackEvent, trackFunnelStep, trackOutcome, trackValue, shutdown) are handled automatically.\n *\n * For high-throughput streaming platforms (Kafka, Kinesis, Pub/Sub), use `StreamingEventSubscriber` instead.\n */\nexport abstract class EventSubscriber implements IEventSubscriber {\n  /**\n   * Subscriber name (required for debugging)\n   */\n  abstract readonly name: string;\n\n  /**\n   * Subscriber version (optional)\n   */\n  readonly version?: string;\n\n  /**\n   * Enable/disable the subscriber (default: true)\n   */\n  protected enabled: boolean = true;\n\n  /**\n   * Track pending requests for graceful shutdown\n   */\n  private pendingRequests: Set<Promise<void>> = new Set();\n\n  /**\n   * Send payload to destination\n   *\n   * Override this method to implement your destination-specific logic.\n   * This is called for all event types (event, funnel, outcome, value).\n   *\n   * @param payload - Normalized event payload\n   */\n  protected abstract sendToDestination(payload: EventPayload): Promise<void>;\n\n  /**\n   * Optional: Handle errors\n   *\n   * Override this to customize error handling (logging, retries, etc.).\n   * Default behavior: log to console.error\n   *\n   * @param error - Error that occurred\n   * @param payload - Event payload that failed\n   */\n  protected handleError(error: Error, payload: EventPayload): void {\n    console.error(\n      `[${this.name}] Failed to send ${payload.type}:`,\n      error,\n      payload,\n    );\n  }\n\n  /**\n   * Filter out undefined and null values from attributes\n   *\n   * This improves DX by allowing callers to pass objects with optional properties\n   * without having to manually filter them first.\n   *\n   * @param attributes - Input attributes (may contain undefined/null)\n   * @returns Filtered attributes with only defined values, or undefined if empty\n   *\n   * @example\n   * ```typescript\n   * const filtered = this.filterAttributes({\n   *   userId: user.id,\n   *   email: user.email,      // might be undefined\n   *   plan: null,             // will be filtered out\n   * });\n   * // Result: { userId: 'abc', email: 'test@example.com' } or { userId: 'abc' }\n   * ```\n   */\n  protected filterAttributes(\n    attributes?: EventAttributesInput,\n  ): EventAttributes | undefined {\n    if (!attributes) return undefined;\n\n    const filtered: EventAttributes = {};\n    for (const [key, value] of Object.entries(attributes)) {\n      if (value !== undefined && value !== null) {\n        filtered[key] = value;\n      }\n    }\n\n    // Return undefined if no attributes remain after filtering\n    return Object.keys(filtered).length > 0 ? filtered : undefined;\n  }\n\n  /**\n   * Track an event\n   */\n  async trackEvent(\n    name: string,\n    attributes?: EventAttributes,\n    options?: EventTrackingOptions,\n  ): Promise<void> {\n    if (!this.enabled) return;\n\n    const payload: EventPayload = {\n      type: 'event',\n      name,\n      attributes,\n      timestamp: new Date().toISOString(),\n      autotel: options?.autotel,\n      schema: options?.schema,\n    };\n\n    await this.send(payload);\n  }\n\n  /**\n   * Track a funnel step\n   */\n  async trackFunnelStep(\n    funnelName: string,\n    step: FunnelStatus,\n    attributes?: EventAttributes,\n    options?: EventTrackingOptions,\n  ): Promise<void> {\n    if (!this.enabled) return;\n\n    const payload: EventPayload = {\n      type: 'funnel',\n      name: `${funnelName}.${step}`,\n      funnel: funnelName,\n      step,\n      attributes,\n      timestamp: new Date().toISOString(),\n      autotel: options?.autotel,\n    };\n\n    await this.send(payload);\n  }\n\n  /**\n   * Track an outcome\n   */\n  async trackOutcome(\n    operationName: string,\n    outcome: OutcomeStatus,\n    attributes?: EventAttributes,\n    options?: EventTrackingOptions,\n  ): Promise<void> {\n    if (!this.enabled) return;\n\n    const payload: EventPayload = {\n      type: 'outcome',\n      name: `${operationName}.${outcome}`,\n      operation: operationName,\n      outcome,\n      attributes,\n      timestamp: new Date().toISOString(),\n      autotel: options?.autotel,\n    };\n\n    await this.send(payload);\n  }\n\n  /**\n   * Track a value/metric\n   */\n  async trackValue(\n    name: string,\n    value: number,\n    attributes?: EventAttributes,\n    options?: EventTrackingOptions,\n  ): Promise<void> {\n    if (!this.enabled) return;\n\n    const payload: EventPayload = {\n      type: 'value',\n      name,\n      value,\n      attributes,\n      timestamp: new Date().toISOString(),\n      autotel: options?.autotel,\n    };\n\n    await this.send(payload);\n  }\n\n  /**\n   * Track funnel progression with custom step names\n   *\n   * Unlike trackFunnelStep which uses FunnelStatus enum values,\n   * this method allows any string as the step name for flexible funnel tracking.\n   *\n   * @param funnelName - Name of the funnel (e.g., \"checkout\", \"onboarding\")\n   * @param stepName - Custom step name (e.g., \"cart_viewed\", \"payment_entered\")\n   * @param stepNumber - Optional numeric position in the funnel\n   * @param attributes - Optional event attributes\n   * @param options - Optional tracking options including autotel context\n   */\n  async trackFunnelProgression(\n    funnelName: string,\n    stepName: string,\n    stepNumber?: number,\n    attributes?: EventAttributes,\n    options?: EventTrackingOptions,\n  ): Promise<void> {\n    if (!this.enabled) return;\n\n    const payload: EventPayload = {\n      type: 'funnel',\n      name: `${funnelName}.${stepName}`,\n      funnel: funnelName,\n      step: stepName,\n      stepName,\n      stepNumber,\n      attributes,\n      timestamp: new Date().toISOString(),\n      autotel: options?.autotel,\n    };\n\n    await this.send(payload);\n  }\n\n  /**\n   * Flush pending requests and clean up\n   *\n   * CRITICAL: Prevents race condition during shutdown\n   * 1. Disables subscriber to stop new events\n   * 2. Drains all pending requests (with retry logic)\n   * 3. Ensures flush guarantee\n   *\n   * Override this if you need custom cleanup logic (close connections, flush buffers, etc.),\n   * but ALWAYS call super.shutdown() first to drain pending requests.\n   */\n  async shutdown(): Promise<void> {\n    // 1. Stop accepting new events (prevents race condition)\n    this.enabled = false;\n\n    // 2. Drain pending requests with retry logic\n    // Loop until empty to handle race where new requests added during Promise.allSettled\n    const maxDrainAttempts = 10;\n    const drainIntervalMs = 50;\n\n    for (let attempt = 0; attempt < maxDrainAttempts; attempt++) {\n      if (this.pendingRequests.size === 0) {\n        break;\n      }\n\n      // Wait for current batch\n      await Promise.allSettled(this.pendingRequests);\n\n      // Small delay to catch any stragglers added during allSettled\n      if (this.pendingRequests.size > 0 && attempt < maxDrainAttempts - 1) {\n        await new Promise((resolve) => setTimeout(resolve, drainIntervalMs));\n      }\n    }\n\n    // 3. Warn if we still have pending requests (shouldn't happen, but be defensive)\n    if (this.pendingRequests.size > 0) {\n      console.warn(\n        `[${this.name}] Shutdown completed with ${this.pendingRequests.size} pending requests still in-flight. ` +\n        `This may indicate a bug in the subscriber or extremely slow destination.`\n      );\n    }\n  }\n\n  /**\n   * Internal: Send payload and track request\n   */\n  private async send(payload: EventPayload): Promise<void> {\n    const request = this.sendWithErrorHandling(payload);\n    this.pendingRequests.add(request);\n\n    void request.finally(() => {\n      this.pendingRequests.delete(request);\n    });\n\n    return request;\n  }\n\n  /**\n   * Internal: Send with error handling\n   */\n  private async sendWithErrorHandling(\n    payload: EventPayload,\n  ): Promise<void> {\n    try {\n      await this.sendToDestination(payload);\n    } catch (error) {\n      this.handleError(error as Error, payload);\n    }\n  }\n}\n\nexport {\n  type EventAttributes,\n  type EventAttributesInput,\n  type FunnelStatus,\n  type OutcomeStatus,\n} from 'autotel/event-subscriber';\n","/**\n * File subscriber for autotel.\n *\n * Appends each tracked event to a file as newline-delimited JSON (NDJSON).\n * Useful for AI agents, scripts, evals, and local debugging that want\n * structured events on disk without a hosted backend. Query the file with\n * `jq`, load it into a notebook, or feed it to an agent.\n *\n * @example\n * ```typescript\n * import { Event } from 'autotel/events';\n * import { FileSubscriber } from 'autotel-subscribers/file';\n *\n * const events = new Event('worker', {\n *   subscribers: [new FileSubscriber({ path: './telemetry/events.ndjson' })],\n * });\n * ```\n */\n\nimport { appendFile, mkdir } from 'node:fs/promises';\nimport path from 'node:path';\nimport { EventSubscriber, type EventPayload } from './event-subscriber-base';\n\nexport interface FileSubscriberConfig {\n  /** File path to append newline-delimited JSON events to. */\n  path: string;\n  /** Enable or disable the subscriber. Default `true`. */\n  enabled?: boolean;\n  /** Pretty-print each event as indented JSON instead of one line. Default `false`. */\n  pretty?: boolean;\n  /** Create parent directories if they do not exist. Default `true`. */\n  mkdir?: boolean;\n  /**\n   * Transform a payload before writing. Return `null` to skip the event.\n   * Defaults to writing the normalized payload unchanged.\n   */\n  transform?: (payload: EventPayload) => Record<string, unknown> | null;\n}\n\nexport class FileSubscriber extends EventSubscriber {\n  readonly name = 'FileSubscriber';\n  readonly version = '1.0.0';\n\n  private readonly filePath: string;\n  private readonly pretty: boolean;\n  private readonly ensureDir: boolean;\n  private readonly transform?: (\n    payload: EventPayload,\n  ) => Record<string, unknown> | null;\n\n  /** Serializes writes so concurrent events never interleave on disk. */\n  private writeChain: Promise<void> = Promise.resolve();\n  private dirEnsured = false;\n\n  constructor(config: FileSubscriberConfig) {\n    super();\n    this.filePath = config.path;\n    this.enabled = config.enabled ?? true;\n    this.pretty = config.pretty ?? false;\n    this.ensureDir = config.mkdir ?? true;\n    this.transform = config.transform;\n  }\n\n  protected async sendToDestination(payload: EventPayload): Promise<void> {\n    if (!this.enabled) return;\n\n    const record = this.transform ? this.transform(payload) : payload;\n    if (record === null) return;\n\n    const json = this.pretty\n      ? JSON.stringify(record, null, 2)\n      : JSON.stringify(record);\n    const line = `${json}\\n`;\n\n    const run = this.writeChain.then(() => this.write(line));\n    // Keep the chain ordered and alive even if one write rejects; the failed\n    // write still rejects `run` so the base class can report it.\n    this.writeChain = run.catch(() => {});\n    await run;\n  }\n\n  private async write(line: string): Promise<void> {\n    if (this.ensureDir && !this.dirEnsured) {\n      const dir = path.dirname(this.filePath);\n      if (dir && dir !== '.') {\n        await mkdir(dir, { recursive: true });\n      }\n      this.dirEnsured = true;\n    }\n    await appendFile(this.filePath, line, 'utf8');\n  }\n\n  override async shutdown(): Promise<void> {\n    await this.writeChain;\n    await super.shutdown();\n  }\n}\n"]}

package/dist/file.d.cts

@@ -0,0 +1,54 @@
+import { E as EventSubscriber, a as EventPayload } from './event-subscriber-base-C5NlyV_O.cjs';
+import 'autotel/event-subscriber';
+
+/**
+ * File subscriber for autotel.
+ *
+ * Appends each tracked event to a file as newline-delimited JSON (NDJSON).
+ * Useful for AI agents, scripts, evals, and local debugging that want
+ * structured events on disk without a hosted backend. Query the file with
+ * `jq`, load it into a notebook, or feed it to an agent.
+ *
+ * @example
+ * ```typescript
+ * import { Event } from 'autotel/events';
+ * import { FileSubscriber } from 'autotel-subscribers/file';
+ *
+ * const events = new Event('worker', {
+ *   subscribers: [new FileSubscriber({ path: './telemetry/events.ndjson' })],
+ * });
+ * ```
+ */
+
+interface FileSubscriberConfig {
+    /** File path to append newline-delimited JSON events to. */
+    path: string;
+    /** Enable or disable the subscriber. Default `true`. */
+    enabled?: boolean;
+    /** Pretty-print each event as indented JSON instead of one line. Default `false`. */
+    pretty?: boolean;
+    /** Create parent directories if they do not exist. Default `true`. */
+    mkdir?: boolean;
+    /**
+     * Transform a payload before writing. Return `null` to skip the event.
+     * Defaults to writing the normalized payload unchanged.
+     */
+    transform?: (payload: EventPayload) => Record<string, unknown> | null;
+}
+declare class FileSubscriber extends EventSubscriber {
+    readonly name = "FileSubscriber";
+    readonly version = "1.0.0";
+    private readonly filePath;
+    private readonly pretty;
+    private readonly ensureDir;
+    private readonly transform?;
+    /** Serializes writes so concurrent events never interleave on disk. */
+    private writeChain;
+    private dirEnsured;
+    constructor(config: FileSubscriberConfig);
+    protected sendToDestination(payload: EventPayload): Promise<void>;
+    private write;
+    shutdown(): Promise<void>;
+}
+
+export { FileSubscriber, type FileSubscriberConfig };

package/dist/file.d.ts

@@ -0,0 +1,54 @@
+import { E as EventSubscriber, a as EventPayload } from './event-subscriber-base-C5NlyV_O.js';
+import 'autotel/event-subscriber';
+
+/**
+ * File subscriber for autotel.
+ *
+ * Appends each tracked event to a file as newline-delimited JSON (NDJSON).
+ * Useful for AI agents, scripts, evals, and local debugging that want
+ * structured events on disk without a hosted backend. Query the file with
+ * `jq`, load it into a notebook, or feed it to an agent.
+ *
+ * @example
+ * ```typescript
+ * import { Event } from 'autotel/events';
+ * import { FileSubscriber } from 'autotel-subscribers/file';
+ *
+ * const events = new Event('worker', {
+ *   subscribers: [new FileSubscriber({ path: './telemetry/events.ndjson' })],
+ * });
+ * ```
+ */
+
+interface FileSubscriberConfig {
+    /** File path to append newline-delimited JSON events to. */
+    path: string;
+    /** Enable or disable the subscriber. Default `true`. */
+    enabled?: boolean;
+    /** Pretty-print each event as indented JSON instead of one line. Default `false`. */
+    pretty?: boolean;
+    /** Create parent directories if they do not exist. Default `true`. */
+    mkdir?: boolean;
+    /**
+     * Transform a payload before writing. Return `null` to skip the event.
+     * Defaults to writing the normalized payload unchanged.
+     */
+    transform?: (payload: EventPayload) => Record<string, unknown> | null;
+}
+declare class FileSubscriber extends EventSubscriber {
+    readonly name = "FileSubscriber";
+    readonly version = "1.0.0";
+    private readonly filePath;
+    private readonly pretty;
+    private readonly ensureDir;
+    private readonly transform?;
+    /** Serializes writes so concurrent events never interleave on disk. */
+    private writeChain;
+    private dirEnsured;
+    constructor(config: FileSubscriberConfig);
+    protected sendToDestination(payload: EventPayload): Promise<void>;
+    private write;
+    shutdown(): Promise<void>;
+}
+
+export { FileSubscriber, type FileSubscriberConfig };

package/dist/file.js

@@ -0,0 +1,256 @@
+import { mkdir, appendFile } from 'fs/promises';
+import path from 'path';
+
+// src/file.ts
+
+// src/event-subscriber-base.ts
+var EventSubscriber = class {
+  /**
+   * Subscriber version (optional)
+   */
+  version;
+  /**
+   * Enable/disable the subscriber (default: true)
+   */
+  enabled = true;
+  /**
+   * Track pending requests for graceful shutdown
+   */
+  pendingRequests = /* @__PURE__ */ new Set();
+  /**
+   * Optional: Handle errors
+   *
+   * Override this to customize error handling (logging, retries, etc.).
+   * Default behavior: log to console.error
+   *
+   * @param error - Error that occurred
+   * @param payload - Event payload that failed
+   */
+  handleError(error, payload) {
+    console.error(
+      `[${this.name}] Failed to send ${payload.type}:`,
+      error,
+      payload
+    );
+  }
+  /**
+   * Filter out undefined and null values from attributes
+   *
+   * This improves DX by allowing callers to pass objects with optional properties
+   * without having to manually filter them first.
+   *
+   * @param attributes - Input attributes (may contain undefined/null)
+   * @returns Filtered attributes with only defined values, or undefined if empty
+   *
+   * @example
+   * ```typescript
+   * const filtered = this.filterAttributes({
+   *   userId: user.id,
+   *   email: user.email,      // might be undefined
+   *   plan: null,             // will be filtered out
+   * });
+   * // Result: { userId: 'abc', email: 'test@example.com' } or { userId: 'abc' }
+   * ```
+   */
+  filterAttributes(attributes) {
+    if (!attributes) return void 0;
+    const filtered = {};
+    for (const [key, value] of Object.entries(attributes)) {
+      if (value !== void 0 && value !== null) {
+        filtered[key] = value;
+      }
+    }
+    return Object.keys(filtered).length > 0 ? filtered : void 0;
+  }
+  /**
+   * Track an event
+   */
+  async trackEvent(name, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "event",
+      name,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel,
+      schema: options?.schema
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track a funnel step
+   */
+  async trackFunnelStep(funnelName, step, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "funnel",
+      name: `${funnelName}.${step}`,
+      funnel: funnelName,
+      step,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track an outcome
+   */
+  async trackOutcome(operationName, outcome, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "outcome",
+      name: `${operationName}.${outcome}`,
+      operation: operationName,
+      outcome,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track a value/metric
+   */
+  async trackValue(name, value, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "value",
+      name,
+      value,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel
+    };
+    await this.send(payload);
+  }
+  /**
+   * Track funnel progression with custom step names
+   *
+   * Unlike trackFunnelStep which uses FunnelStatus enum values,
+   * this method allows any string as the step name for flexible funnel tracking.
+   *
+   * @param funnelName - Name of the funnel (e.g., "checkout", "onboarding")
+   * @param stepName - Custom step name (e.g., "cart_viewed", "payment_entered")
+   * @param stepNumber - Optional numeric position in the funnel
+   * @param attributes - Optional event attributes
+   * @param options - Optional tracking options including autotel context
+   */
+  async trackFunnelProgression(funnelName, stepName, stepNumber, attributes, options) {
+    if (!this.enabled) return;
+    const payload = {
+      type: "funnel",
+      name: `${funnelName}.${stepName}`,
+      funnel: funnelName,
+      step: stepName,
+      stepName,
+      stepNumber,
+      attributes,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      autotel: options?.autotel
+    };
+    await this.send(payload);
+  }
+  /**
+   * Flush pending requests and clean up
+   *
+   * CRITICAL: Prevents race condition during shutdown
+   * 1. Disables subscriber to stop new events
+   * 2. Drains all pending requests (with retry logic)
+   * 3. Ensures flush guarantee
+   *
+   * Override this if you need custom cleanup logic (close connections, flush buffers, etc.),
+   * but ALWAYS call super.shutdown() first to drain pending requests.
+   */
+  async shutdown() {
+    this.enabled = false;
+    const maxDrainAttempts = 10;
+    const drainIntervalMs = 50;
+    for (let attempt = 0; attempt < maxDrainAttempts; attempt++) {
+      if (this.pendingRequests.size === 0) {
+        break;
+      }
+      await Promise.allSettled(this.pendingRequests);
+      if (this.pendingRequests.size > 0 && attempt < maxDrainAttempts - 1) {
+        await new Promise((resolve) => setTimeout(resolve, drainIntervalMs));
+      }
+    }
+    if (this.pendingRequests.size > 0) {
+      console.warn(
+        `[${this.name}] Shutdown completed with ${this.pendingRequests.size} pending requests still in-flight. This may indicate a bug in the subscriber or extremely slow destination.`
+      );
+    }
+  }
+  /**
+   * Internal: Send payload and track request
+   */
+  async send(payload) {
+    const request = this.sendWithErrorHandling(payload);
+    this.pendingRequests.add(request);
+    void request.finally(() => {
+      this.pendingRequests.delete(request);
+    });
+    return request;
+  }
+  /**
+   * Internal: Send with error handling
+   */
+  async sendWithErrorHandling(payload) {
+    try {
+      await this.sendToDestination(payload);
+    } catch (error) {
+      this.handleError(error, payload);
+    }
+  }
+};
+
+// src/file.ts
+var FileSubscriber = class extends EventSubscriber {
+  name = "FileSubscriber";
+  version = "1.0.0";
+  filePath;
+  pretty;
+  ensureDir;
+  transform;
+  /** Serializes writes so concurrent events never interleave on disk. */
+  writeChain = Promise.resolve();
+  dirEnsured = false;
+  constructor(config) {
+    super();
+    this.filePath = config.path;
+    this.enabled = config.enabled ?? true;
+    this.pretty = config.pretty ?? false;
+    this.ensureDir = config.mkdir ?? true;
+    this.transform = config.transform;
+  }
+  async sendToDestination(payload) {
+    if (!this.enabled) return;
+    const record = this.transform ? this.transform(payload) : payload;
+    if (record === null) return;
+    const json = this.pretty ? JSON.stringify(record, null, 2) : JSON.stringify(record);
+    const line = `${json}
+`;
+    const run = this.writeChain.then(() => this.write(line));
+    this.writeChain = run.catch(() => {
+    });
+    await run;
+  }
+  async write(line) {
+    if (this.ensureDir && !this.dirEnsured) {
+      const dir = path.dirname(this.filePath);
+      if (dir && dir !== ".") {
+        await mkdir(dir, { recursive: true });
+      }
+      this.dirEnsured = true;
+    }
+    await appendFile(this.filePath, line, "utf8");
+  }
+  async shutdown() {
+    await this.writeChain;
+    await super.shutdown();
+  }
+};
+
+export { FileSubscriber };
+//# sourceMappingURL=file.js.map
+//# sourceMappingURL=file.js.map