@fallow-cli/beacon 0.1.0 → 0.1.1

package/dist/browser.d.ts

@@ -0,0 +1,8 @@
+import type { BeaconConfig, CoveragePayload, FunctionCoverage } from "./types";
+type BrowserBeacon = {
+    start: () => void;
+    stop: () => void;
+    flush: () => Promise<void>;
+};
+export declare const createBrowserBeacon: (config: BeaconConfig) => BrowserBeacon;
+export type { BeaconConfig, BrowserBeacon, CoveragePayload, FunctionCoverage };

package/dist/node.d.ts

@@ -0,0 +1,8 @@
+import type { BeaconConfig, CoveragePayload, FunctionCoverage } from "./types";
+type NodeBeacon = {
+    start: () => void;
+    stop: () => Promise<void>;
+    flush: () => Promise<void>;
+};
+export declare const createNodeBeacon: (config: BeaconConfig) => NodeBeacon;
+export type { BeaconConfig, CoveragePayload, FunctionCoverage, NodeBeacon };

package/dist/transport.d.ts

@@ -0,0 +1,21 @@
+import type { BeaconConfig, CoveragePayload, TransportState } from "./types";
+/**
+ * Generates a unique payload ID. Prefers `crypto.randomUUID()` (Node 14.17+, modern browsers),
+ * falling back to a timestamp + random suffix for older runtimes.
+ */
+export declare const generatePayloadId: () => string;
+export type Transport = {
+    enqueue: (payload: CoveragePayload) => void;
+    flush: () => Promise<void>;
+    destroy: () => void;
+    state: () => TransportState;
+    pendingCount: () => number;
+};
+export declare const createTransport: (config: BeaconConfig) => Transport;
+/**
+ * Best-effort send via navigator.sendBeacon() for browser unload scenarios.
+ * No auth header is sent (sendBeacon does not support custom headers).
+ * The server will reject with 401 — this is fire-and-forget with no delivery guarantee.
+ * Returns true if the browser accepted the beacon into its send queue.
+ */
+export declare const sendBeaconFallback: (endpoint: string, payload: CoveragePayload) => boolean;

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+export type SnapshotSchedule = "idle" | "interval" | "manual";
+export type BeaconConfig = {
+    apiKey: string;
+    projectId: string;
+    endpoint: string;
+    sampleRate?: number;
+    snapshotSchedule?: SnapshotSchedule;
+    environment?: string;
+    commitSha?: string;
+    flushIntervalMs?: number;
+    maxQueueSize?: number;
+    maxBatchSize?: number;
+    enabled?: boolean;
+    beforeSend?: (data: CoveragePayload) => CoveragePayload | null;
+    denyPaths?: RegExp[];
+    onFallback?: () => void;
+};
+export type TrackingState = "called" | "never_called" | "untracked";
+export type FunctionCoverage = {
+    filePath: string;
+    functionName: string;
+    lineNumber: number | null;
+    hitCount: number;
+    trackingState: TrackingState;
+};
+export type CoveragePayload = {
+    payloadId: string;
+    projectId: string;
+    environment: string | undefined;
+    commitSha: string | undefined;
+    timestamp: string;
+    functions: FunctionCoverage[];
+};
+export type IngestResponse = {
+    data: {
+        ingestIds: string[];
+        accepted: boolean;
+    };
+};
+export type TransportState = "active" | "backoff" | "shutdown";
+export type ClientReportReason = "queue_overflow" | "ratelimit_backoff" | "network_error" | "auth_failure";
+export type ClientReport = {
+    reason: ClientReportReason;
+    droppedCount: number;
+    timestamp: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fallow-cli/beacon",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Lightweight production coverage beacon for fallow cloud",
   "keywords": [
     "coverage",
@@ -29,7 +29,7 @@
     }
   },
   "scripts": {
-    "build": "bun build src/node.ts src/browser.ts --outdir dist --target node",
+    "build": "bun build src/node.ts src/browser.ts --outdir dist --target node && tsc --emitDeclarationOnly --outDir dist",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },