@lessonkit/xapi 1.3.0 → 1.3.1

package/README.md

@@ -17,27 +17,41 @@ npm install @lessonkit/xapi @lessonkit/core
 ## Usage
 
 ```typescript
-import { createXAPIClient, telemetryEventToXAPIStatement } from "@lessonkit/xapi";
+import { createFetchTransport, createXAPIClient, telemetryEventToXAPIStatement } from "@lessonkit/xapi";
+
+const { transport, exitTransport } = createFetchTransport({
+  url: "/api/xapi/statements",
+  timeoutMs: 30_000,
+});
 
 const xapi = createXAPIClient({
   courseId: "my-course",
-  transport: async (statement) => {
-    await fetch("/xapi/statements", { method: "POST", body: JSON.stringify(statement) });
-  },
+  transport,
+  exitTransport,
 });
 
 xapi.completeLesson({ lessonId: "lesson-1", durationMs: 1200, success: true });
 await xapi.flush();
+xapi.flushOnExit?.(); // pagehide keepalive delivery
 ```
 
 Map from telemetry events: `telemetryEventToXAPIStatement(event)` — uses canonical LessonKit URNs.
 
+Batch analytics sink:
+
+```typescript
+import { createFetchBatchSink } from "@lessonkit/xapi";
+
+const { batchSink, exitBatchSink } = createFetchBatchSink({ url: "/api/telemetry/batch" });
+```
+
 ## Behavior
 
 - No transport → statements queue in memory (dev warns once).
 - Transport failure → re-queue; call `flush()` to retry.
 - Queue capped at **1000** statements by default; oldest dropped when full (`onCap` / `createInMemoryXAPIQueue({ onCap })`).
 - Concurrent `flush()` calls are coalesced.
+- `createFetchTransport` retries with exponential backoff and uses `AbortSignal.timeout` when available.
 
 ## Docs
 

package/dist/index.cjs

@@ -20,6 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  createFetchBatchSink: () => createFetchBatchSink,
+  createFetchTransport: () => createFetchTransport,
   createInMemoryXAPIQueue: () => createInMemoryXAPIQueue,
   createXAPIClient: () => createXAPIClient,
   telemetryEventToXAPIStatement: () => telemetryEventToXAPIStatement
@@ -52,6 +54,13 @@ function createInMemoryXAPIQueue(opts) {
   const notifyDepth = () => {
     opts?.onDepth?.(buffer.length);
   };
+  const removeById = (id) => {
+    const idx = buffer.findIndex((s) => s.id === id);
+    if (idx >= 0) {
+      buffer.splice(idx, 1);
+      notifyDepth();
+    }
+  };
   const runFlush = async (transport) => {
     while (buffer.length) {
       const statement = buffer[0];
@@ -86,6 +95,7 @@ function createInMemoryXAPIQueue(opts) {
       buffer.push(normalized);
       notifyDepth();
     },
+    removeById,
     size: () => buffer.length,
     flush: async (transport) => {
       if (flushInFlight) return flushInFlight;
@@ -94,6 +104,22 @@ function createInMemoryXAPIQueue(opts) {
         flushInFlight = null;
       });
       return flushInFlight;
+    },
+    flushOnExit: (exitTransport) => {
+      const startIdx = headInFlight && buffer.length > 0 ? 1 : 0;
+      for (let i = startIdx; i < buffer.length; i++) {
+        const statement = buffer[i];
+        try {
+          exitTransport(statement);
+        } catch {
+        }
+      }
+      if (startIdx === 0) {
+        buffer.length = 0;
+      } else if (buffer.length > 1) {
+        buffer.splice(1);
+      }
+      notifyDepth();
     }
   };
 }
@@ -273,6 +299,7 @@ function isDevEnvironment() {
 }
 function createXAPIClient(opts) {
   const transport = opts?.transport;
+  const exitTransport = opts?.exitTransport;
   const courseId = opts?.courseId;
   const queue = opts?.queue ?? createInMemoryXAPIQueue({
     maxSize: opts?.maxQueueSize,
@@ -282,6 +309,7 @@ function createXAPIClient(opts) {
   let warnedNoTransport = false;
   let warnedTransportFailure = false;
   const inflightById = /* @__PURE__ */ new Map();
+  const inflightStatements = /* @__PURE__ */ new Map();
   const sendOrQueue = (statement) => {
     const normalized = withStatementId2(statement);
     if (!transport) {
@@ -304,7 +332,11 @@ function createXAPIClient(opts) {
       );
       return;
     }
-    const flight = Promise.resolve().then(() => transport(normalized)).catch(() => {
+    inflightStatements.set(normalized.id, normalized);
+    const flight = Promise.resolve().then(async () => {
+      await transport(normalized);
+      queue.removeById(normalized.id);
+    }).catch(() => {
       queue.enqueue(normalized);
       if (isDevEnvironment() && !warnedTransportFailure) {
         warnedTransportFailure = true;
@@ -315,6 +347,7 @@ function createXAPIClient(opts) {
       throw new Error("xAPI transport failed");
     }).finally(() => {
       inflightById.delete(normalized.id);
+      inflightStatements.delete(normalized.id);
     });
     inflightById.set(normalized.id, flight);
     void flight.catch(() => {
@@ -347,6 +380,22 @@ function createXAPIClient(opts) {
         await Promise.allSettled(flights);
       }
     },
+    flushOnExit: exitTransport ? () => {
+      const exitSentIds = /* @__PURE__ */ new Set();
+      for (const statement of inflightStatements.values()) {
+        if (exitSentIds.has(statement.id)) continue;
+        try {
+          exitTransport(statement);
+          exitSentIds.add(statement.id);
+        } catch {
+        }
+      }
+      queue.flushOnExit((statement) => {
+        if (exitSentIds.has(statement.id)) return;
+        exitTransport(statement);
+        exitSentIds.add(statement.id);
+      });
+    } : void 0,
     startedLesson: ({ lessonId }) => {
       if (!courseId) return;
       emit({
@@ -383,8 +432,123 @@ function createXAPIClient(opts) {
     }
   };
 }
+
+// src/fetchTransport.ts
+function resolveHeaders(headers) {
+  if (!headers) return { "Content-Type": "application/json" };
+  const resolved = typeof headers === "function" ? headers() : headers;
+  return { "Content-Type": "application/json", ...resolved };
+}
+function createAbortSignal(timeoutMs) {
+  if (timeoutMs <= 0) return void 0;
+  const timeout = AbortSignal;
+  if (typeof timeout.timeout === "function") {
+    return timeout.timeout(timeoutMs);
+  }
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  timer.unref?.();
+  return controller.signal;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function postStatement(url, statement, init) {
+  return fetch(url, {
+    method: "POST",
+    body: JSON.stringify(statement),
+    ...init
+  }).then((res) => {
+    if (!res.ok) {
+      throw new Error(`xAPI fetch failed: ${res.status} ${res.statusText}`);
+    }
+  });
+}
+function createFetchTransport(opts) {
+  const timeoutMs = opts.timeoutMs ?? 3e4;
+  const retries = opts.retries ?? 2;
+  const initialBackoffMs = opts.backoffMs ?? 250;
+  const maxBackoffMs = opts.maxBackoffMs ?? 5e3;
+  const transport = async (statement) => {
+    let attempt = 0;
+    let backoff = initialBackoffMs;
+    for (; ; ) {
+      try {
+        await postStatement(opts.url, statement, {
+          ...opts.init,
+          headers: resolveHeaders(opts.headers),
+          signal: createAbortSignal(timeoutMs)
+        });
+        return;
+      } catch (err) {
+        if (attempt >= retries) throw err;
+        await sleep(backoff);
+        backoff = Math.min(backoff * 2, maxBackoffMs);
+        attempt += 1;
+      }
+    }
+  };
+  const exitTransport = (statement) => {
+    try {
+      void postStatement(opts.url, statement, {
+        ...opts.init,
+        headers: resolveHeaders(opts.headers),
+        keepalive: true
+      }).catch(() => void 0);
+    } catch {
+    }
+  };
+  return { transport, exitTransport };
+}
+function createFetchBatchSink(opts) {
+  const timeoutMs = opts.timeoutMs ?? 3e4;
+  const retries = opts.retries ?? 2;
+  const initialBackoffMs = opts.backoffMs ?? 250;
+  const maxBackoffMs = opts.maxBackoffMs ?? 5e3;
+  const postBatch = async (events, init) => {
+    let attempt = 0;
+    let backoff = initialBackoffMs;
+    for (; ; ) {
+      try {
+        const res = await fetch(opts.url, {
+          method: "POST",
+          body: JSON.stringify(events),
+          ...init,
+          headers: resolveHeaders(opts.headers),
+          signal: createAbortSignal(timeoutMs)
+        });
+        if (!res.ok) {
+          throw new Error(`telemetry batch fetch failed: ${res.status} ${res.statusText}`);
+        }
+        return;
+      } catch (err) {
+        if (attempt >= retries) throw err;
+        await sleep(backoff);
+        backoff = Math.min(backoff * 2, maxBackoffMs);
+        attempt += 1;
+      }
+    }
+  };
+  return {
+    batchSink: (events) => postBatch(events, opts.init ?? {}),
+    exitBatchSink: (events) => {
+      try {
+        void fetch(opts.url, {
+          method: "POST",
+          body: JSON.stringify(events),
+          ...opts.init,
+          headers: resolveHeaders(opts.headers),
+          keepalive: true
+        }).catch(() => void 0);
+      } catch {
+      }
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createFetchBatchSink,
+  createFetchTransport,
   createInMemoryXAPIQueue,
   createXAPIClient,
   telemetryEventToXAPIStatement

package/dist/index.d.cts

@@ -32,12 +32,18 @@ type XAPIStatement = {
 type XAPITransport = (statement: XAPIStatement) => void | Promise<void>;
 type XAPIQueue = {
     enqueue: (statement: XAPIStatement) => void;
+    /** Remove a queued statement by id (e.g. after successful direct transport). */
+    removeById: (id: string) => void;
     flush: (transport: XAPITransport) => Promise<void>;
+    flushOnExit: (exitTransport: XAPIExitTransport) => void;
     size: () => number;
 };
+type XAPIExitTransport = (statement: XAPIStatement) => void;
 type XAPIClient = {
     send: (statement: XAPIStatement) => void;
     flush: () => Promise<void>;
+    /** Best-effort synchronous flush for pagehide using keepalive transport when configured. */
+    flushOnExit?: () => void;
     queueSize: () => number;
     startedLesson: (opts: {
         lessonId: LessonId;
@@ -64,6 +70,8 @@ declare function createInMemoryXAPIQueue(opts?: InMemoryXAPIQueueOptions): XAPIQ
 
 declare function createXAPIClient(opts?: {
     transport?: XAPITransport;
+    /** Keepalive transport for pagehide flush (e.g. from createFetchTransport). */
+    exitTransport?: XAPIExitTransport;
     courseId?: CourseId;
     queue?: XAPIQueue;
     /** When creating the default in-memory queue (max size 1000 unless overridden). */
@@ -72,10 +80,47 @@ declare function createXAPIClient(opts?: {
     onQueueCap?: () => void;
 }): XAPIClient;
 
+type CreateFetchTransportOptions = {
+    /** LRS or proxy endpoint (POST). */
+    url: string;
+    /** Per-request timeout (default 30_000 ms). Uses AbortSignal.timeout when available. */
+    timeoutMs?: number;
+    /** Static headers merged into each request (e.g. Authorization from a short-lived token). */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** Retries after transport failure (default 2). */
+    retries?: number;
+    /** Initial backoff in ms (default 250). Doubles each retry up to maxBackoffMs. */
+    backoffMs?: number;
+    /** Maximum backoff in ms (default 5_000). */
+    maxBackoffMs?: number;
+    /** Extra fetch init merged into each request. */
+    init?: Omit<RequestInit, "method" | "body" | "signal" | "keepalive">;
+};
+type FetchTransportBundle = {
+    transport: XAPITransport;
+    /** Best-effort synchronous delivery for pagehide (keepalive fetch). */
+    exitTransport: (statement: XAPIStatement) => void;
+};
+/**
+ * Creates an xAPI transport backed by fetch with timeout, retry backoff, and a
+ * keepalive exit transport for pagehide delivery.
+ */
+declare function createFetchTransport(opts: CreateFetchTransportOptions): FetchTransportBundle;
+type CreateFetchBatchSinkOptions = CreateFetchTransportOptions;
+type FetchBatchSinkBundle = {
+    batchSink: (events: unknown[]) => Promise<void>;
+    /** Best-effort keepalive POST for pagehide (JSON array body). */
+    exitBatchSink: (events: unknown[]) => void;
+};
+/**
+ * Batch analytics sink with timeout, retry backoff, and keepalive exit delivery.
+ */
+declare function createFetchBatchSink(opts: CreateFetchBatchSinkOptions): FetchBatchSinkBundle;
+
 /**
  * Map a LessonKit telemetry event to an xAPI statement, or null if the event should not emit xAPI.
  * `lesson_time_on_task` returns null (companion metric; lesson_completed carries duration).
  */
 declare function telemetryEventToXAPIStatement(event: TelemetryEvent): XAPIStatement | null;
 
-export { type InMemoryXAPIQueueOptions, type XAPIClient, type XAPIObjectDefinition, type XAPIQueue, type XAPIResult, type XAPIScore, type XAPIStatement, type XAPITransport, type XAPIVerbIri, createInMemoryXAPIQueue, createXAPIClient, telemetryEventToXAPIStatement };
+export { type CreateFetchBatchSinkOptions, type CreateFetchTransportOptions, type FetchBatchSinkBundle, type FetchTransportBundle, type InMemoryXAPIQueueOptions, type XAPIClient, type XAPIExitTransport, type XAPIObjectDefinition, type XAPIQueue, type XAPIResult, type XAPIScore, type XAPIStatement, type XAPITransport, type XAPIVerbIri, createFetchBatchSink, createFetchTransport, createInMemoryXAPIQueue, createXAPIClient, telemetryEventToXAPIStatement };

package/dist/index.d.ts

@@ -32,12 +32,18 @@ type XAPIStatement = {
 type XAPITransport = (statement: XAPIStatement) => void | Promise<void>;
 type XAPIQueue = {
     enqueue: (statement: XAPIStatement) => void;
+    /** Remove a queued statement by id (e.g. after successful direct transport). */
+    removeById: (id: string) => void;
     flush: (transport: XAPITransport) => Promise<void>;
+    flushOnExit: (exitTransport: XAPIExitTransport) => void;
     size: () => number;
 };
+type XAPIExitTransport = (statement: XAPIStatement) => void;
 type XAPIClient = {
     send: (statement: XAPIStatement) => void;
     flush: () => Promise<void>;
+    /** Best-effort synchronous flush for pagehide using keepalive transport when configured. */
+    flushOnExit?: () => void;
     queueSize: () => number;
     startedLesson: (opts: {
         lessonId: LessonId;
@@ -64,6 +70,8 @@ declare function createInMemoryXAPIQueue(opts?: InMemoryXAPIQueueOptions): XAPIQ
 
 declare function createXAPIClient(opts?: {
     transport?: XAPITransport;
+    /** Keepalive transport for pagehide flush (e.g. from createFetchTransport). */
+    exitTransport?: XAPIExitTransport;
     courseId?: CourseId;
     queue?: XAPIQueue;
     /** When creating the default in-memory queue (max size 1000 unless overridden). */
@@ -72,10 +80,47 @@ declare function createXAPIClient(opts?: {
     onQueueCap?: () => void;
 }): XAPIClient;
 
+type CreateFetchTransportOptions = {
+    /** LRS or proxy endpoint (POST). */
+    url: string;
+    /** Per-request timeout (default 30_000 ms). Uses AbortSignal.timeout when available. */
+    timeoutMs?: number;
+    /** Static headers merged into each request (e.g. Authorization from a short-lived token). */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** Retries after transport failure (default 2). */
+    retries?: number;
+    /** Initial backoff in ms (default 250). Doubles each retry up to maxBackoffMs. */
+    backoffMs?: number;
+    /** Maximum backoff in ms (default 5_000). */
+    maxBackoffMs?: number;
+    /** Extra fetch init merged into each request. */
+    init?: Omit<RequestInit, "method" | "body" | "signal" | "keepalive">;
+};
+type FetchTransportBundle = {
+    transport: XAPITransport;
+    /** Best-effort synchronous delivery for pagehide (keepalive fetch). */
+    exitTransport: (statement: XAPIStatement) => void;
+};
+/**
+ * Creates an xAPI transport backed by fetch with timeout, retry backoff, and a
+ * keepalive exit transport for pagehide delivery.
+ */
+declare function createFetchTransport(opts: CreateFetchTransportOptions): FetchTransportBundle;
+type CreateFetchBatchSinkOptions = CreateFetchTransportOptions;
+type FetchBatchSinkBundle = {
+    batchSink: (events: unknown[]) => Promise<void>;
+    /** Best-effort keepalive POST for pagehide (JSON array body). */
+    exitBatchSink: (events: unknown[]) => void;
+};
+/**
+ * Batch analytics sink with timeout, retry backoff, and keepalive exit delivery.
+ */
+declare function createFetchBatchSink(opts: CreateFetchBatchSinkOptions): FetchBatchSinkBundle;
+
 /**
  * Map a LessonKit telemetry event to an xAPI statement, or null if the event should not emit xAPI.
  * `lesson_time_on_task` returns null (companion metric; lesson_completed carries duration).
  */
 declare function telemetryEventToXAPIStatement(event: TelemetryEvent): XAPIStatement | null;
 
-export { type InMemoryXAPIQueueOptions, type XAPIClient, type XAPIObjectDefinition, type XAPIQueue, type XAPIResult, type XAPIScore, type XAPIStatement, type XAPITransport, type XAPIVerbIri, createInMemoryXAPIQueue, createXAPIClient, telemetryEventToXAPIStatement };
+export { type CreateFetchBatchSinkOptions, type CreateFetchTransportOptions, type FetchBatchSinkBundle, type FetchTransportBundle, type InMemoryXAPIQueueOptions, type XAPIClient, type XAPIExitTransport, type XAPIObjectDefinition, type XAPIQueue, type XAPIResult, type XAPIScore, type XAPIStatement, type XAPITransport, type XAPIVerbIri, createFetchBatchSink, createFetchTransport, createInMemoryXAPIQueue, createXAPIClient, telemetryEventToXAPIStatement };

package/dist/index.js

@@ -24,6 +24,13 @@ function createInMemoryXAPIQueue(opts) {
   const notifyDepth = () => {
     opts?.onDepth?.(buffer.length);
   };
+  const removeById = (id) => {
+    const idx = buffer.findIndex((s) => s.id === id);
+    if (idx >= 0) {
+      buffer.splice(idx, 1);
+      notifyDepth();
+    }
+  };
   const runFlush = async (transport) => {
     while (buffer.length) {
       const statement = buffer[0];
@@ -58,6 +65,7 @@ function createInMemoryXAPIQueue(opts) {
       buffer.push(normalized);
       notifyDepth();
     },
+    removeById,
     size: () => buffer.length,
     flush: async (transport) => {
       if (flushInFlight) return flushInFlight;
@@ -66,6 +74,22 @@ function createInMemoryXAPIQueue(opts) {
         flushInFlight = null;
       });
       return flushInFlight;
+    },
+    flushOnExit: (exitTransport) => {
+      const startIdx = headInFlight && buffer.length > 0 ? 1 : 0;
+      for (let i = startIdx; i < buffer.length; i++) {
+        const statement = buffer[i];
+        try {
+          exitTransport(statement);
+        } catch {
+        }
+      }
+      if (startIdx === 0) {
+        buffer.length = 0;
+      } else if (buffer.length > 1) {
+        buffer.splice(1);
+      }
+      notifyDepth();
     }
   };
 }
@@ -245,6 +269,7 @@ function isDevEnvironment() {
 }
 function createXAPIClient(opts) {
   const transport = opts?.transport;
+  const exitTransport = opts?.exitTransport;
   const courseId = opts?.courseId;
   const queue = opts?.queue ?? createInMemoryXAPIQueue({
     maxSize: opts?.maxQueueSize,
@@ -254,6 +279,7 @@ function createXAPIClient(opts) {
   let warnedNoTransport = false;
   let warnedTransportFailure = false;
   const inflightById = /* @__PURE__ */ new Map();
+  const inflightStatements = /* @__PURE__ */ new Map();
   const sendOrQueue = (statement) => {
     const normalized = withStatementId2(statement);
     if (!transport) {
@@ -276,7 +302,11 @@ function createXAPIClient(opts) {
       );
       return;
     }
-    const flight = Promise.resolve().then(() => transport(normalized)).catch(() => {
+    inflightStatements.set(normalized.id, normalized);
+    const flight = Promise.resolve().then(async () => {
+      await transport(normalized);
+      queue.removeById(normalized.id);
+    }).catch(() => {
       queue.enqueue(normalized);
       if (isDevEnvironment() && !warnedTransportFailure) {
         warnedTransportFailure = true;
@@ -287,6 +317,7 @@ function createXAPIClient(opts) {
       throw new Error("xAPI transport failed");
     }).finally(() => {
       inflightById.delete(normalized.id);
+      inflightStatements.delete(normalized.id);
     });
     inflightById.set(normalized.id, flight);
     void flight.catch(() => {
@@ -319,6 +350,22 @@ function createXAPIClient(opts) {
         await Promise.allSettled(flights);
       }
     },
+    flushOnExit: exitTransport ? () => {
+      const exitSentIds = /* @__PURE__ */ new Set();
+      for (const statement of inflightStatements.values()) {
+        if (exitSentIds.has(statement.id)) continue;
+        try {
+          exitTransport(statement);
+          exitSentIds.add(statement.id);
+        } catch {
+        }
+      }
+      queue.flushOnExit((statement) => {
+        if (exitSentIds.has(statement.id)) return;
+        exitTransport(statement);
+        exitSentIds.add(statement.id);
+      });
+    } : void 0,
     startedLesson: ({ lessonId }) => {
       if (!courseId) return;
       emit({
@@ -355,7 +402,122 @@ function createXAPIClient(opts) {
     }
   };
 }
+
+// src/fetchTransport.ts
+function resolveHeaders(headers) {
+  if (!headers) return { "Content-Type": "application/json" };
+  const resolved = typeof headers === "function" ? headers() : headers;
+  return { "Content-Type": "application/json", ...resolved };
+}
+function createAbortSignal(timeoutMs) {
+  if (timeoutMs <= 0) return void 0;
+  const timeout = AbortSignal;
+  if (typeof timeout.timeout === "function") {
+    return timeout.timeout(timeoutMs);
+  }
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  timer.unref?.();
+  return controller.signal;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function postStatement(url, statement, init) {
+  return fetch(url, {
+    method: "POST",
+    body: JSON.stringify(statement),
+    ...init
+  }).then((res) => {
+    if (!res.ok) {
+      throw new Error(`xAPI fetch failed: ${res.status} ${res.statusText}`);
+    }
+  });
+}
+function createFetchTransport(opts) {
+  const timeoutMs = opts.timeoutMs ?? 3e4;
+  const retries = opts.retries ?? 2;
+  const initialBackoffMs = opts.backoffMs ?? 250;
+  const maxBackoffMs = opts.maxBackoffMs ?? 5e3;
+  const transport = async (statement) => {
+    let attempt = 0;
+    let backoff = initialBackoffMs;
+    for (; ; ) {
+      try {
+        await postStatement(opts.url, statement, {
+          ...opts.init,
+          headers: resolveHeaders(opts.headers),
+          signal: createAbortSignal(timeoutMs)
+        });
+        return;
+      } catch (err) {
+        if (attempt >= retries) throw err;
+        await sleep(backoff);
+        backoff = Math.min(backoff * 2, maxBackoffMs);
+        attempt += 1;
+      }
+    }
+  };
+  const exitTransport = (statement) => {
+    try {
+      void postStatement(opts.url, statement, {
+        ...opts.init,
+        headers: resolveHeaders(opts.headers),
+        keepalive: true
+      }).catch(() => void 0);
+    } catch {
+    }
+  };
+  return { transport, exitTransport };
+}
+function createFetchBatchSink(opts) {
+  const timeoutMs = opts.timeoutMs ?? 3e4;
+  const retries = opts.retries ?? 2;
+  const initialBackoffMs = opts.backoffMs ?? 250;
+  const maxBackoffMs = opts.maxBackoffMs ?? 5e3;
+  const postBatch = async (events, init) => {
+    let attempt = 0;
+    let backoff = initialBackoffMs;
+    for (; ; ) {
+      try {
+        const res = await fetch(opts.url, {
+          method: "POST",
+          body: JSON.stringify(events),
+          ...init,
+          headers: resolveHeaders(opts.headers),
+          signal: createAbortSignal(timeoutMs)
+        });
+        if (!res.ok) {
+          throw new Error(`telemetry batch fetch failed: ${res.status} ${res.statusText}`);
+        }
+        return;
+      } catch (err) {
+        if (attempt >= retries) throw err;
+        await sleep(backoff);
+        backoff = Math.min(backoff * 2, maxBackoffMs);
+        attempt += 1;
+      }
+    }
+  };
+  return {
+    batchSink: (events) => postBatch(events, opts.init ?? {}),
+    exitBatchSink: (events) => {
+      try {
+        void fetch(opts.url, {
+          method: "POST",
+          body: JSON.stringify(events),
+          ...opts.init,
+          headers: resolveHeaders(opts.headers),
+          keepalive: true
+        }).catch(() => void 0);
+      } catch {
+      }
+    }
+  };
+}
 export {
+  createFetchBatchSink,
+  createFetchTransport,
   createInMemoryXAPIQueue,
   createXAPIClient,
   telemetryEventToXAPIStatement

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessonkit/xapi",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "private": false,
   "description": "xAPI statement generation primitives for LessonKit.",
   "license": "Apache-2.0",
@@ -48,7 +48,7 @@
     "lint": "echo \"(no lint configured yet)\""
   },
   "dependencies": {
-    "@lessonkit/core": "1.3.0"
+    "@lessonkit/core": "1.3.1"
   },
   "devDependencies": {
     "tsup": "^8.5.0",