@lessonkit/xapi 0.5.0 → 0.6.0

package/README.md

@@ -1,6 +1,6 @@
 # `@lessonkit/xapi`
 
-[![CI](https://github.com/eddiethedean/lessonkit/actions/workflows/checks.yml/badge.svg)](https://github.com/eddiethedean/lessonkit/actions/workflows/checks.yml)
+[![CI](https://github.com/eddiethedean/lessonkit/actions/workflows/ci.yml/badge.svg)](https://github.com/eddiethedean/lessonkit/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@lessonkit/xapi.svg)](https://www.npmjs.com/package/@lessonkit/xapi)
 [![License](https://img.shields.io/github/license/eddiethedean/lessonkit)](../../LICENSE)
 
@@ -29,7 +29,7 @@ xapi.completeLesson({ lessonId: "phishing-101", durationMs: 1500, success: true,
 
 Prefer mapping from telemetry: `telemetryEventToXAPIStatement(event)` (canonical object URNs).
 
-## Notes (0.5.0)
+## Notes (0.6.0)
 
 - `createXAPIClient` requires `courseId` for lifecycle helpers; React uses the mapper after each `track()`.
 - If the transport throws/rejects, statements are queued in-memory.

package/dist/index.cjs

@@ -172,17 +172,35 @@ function statementFor(objectId, verb, timestamp, extra) {
 }
 
 // src/client.ts
+function isDevEnvironment() {
+  const g = globalThis;
+  return typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production";
+}
 function createXAPIClient(opts) {
   const transport = opts?.transport;
   const courseId = opts?.courseId;
   const queue = opts?.queue ?? createInMemoryXAPIQueue();
+  let warnedNoTransport = false;
+  let warnedTransportFailure = false;
   const sendOrQueue = (statement) => {
     if (!transport) {
       queue.enqueue(statement);
+      if (isDevEnvironment() && !warnedNoTransport) {
+        warnedNoTransport = true;
+        console.warn(
+          "[lessonkit] xAPI statements are queued but no transport is configured; pass config.xapi.transport or config.xapi.client"
+        );
+      }
       return;
     }
     void Promise.resolve().then(() => transport(statement)).catch(() => {
       queue.enqueue(statement);
+      if (isDevEnvironment() && !warnedTransportFailure) {
+        warnedTransportFailure = true;
+        console.warn(
+          "[lessonkit] xAPI transport failed; statement re-queued. Check your LRS endpoint or transport implementation."
+        );
+      }
     });
   };
   const emit = (event) => {

package/dist/index.js

@@ -144,17 +144,35 @@ function statementFor(objectId, verb, timestamp, extra) {
 }
 
 // src/client.ts
+function isDevEnvironment() {
+  const g = globalThis;
+  return typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production";
+}
 function createXAPIClient(opts) {
   const transport = opts?.transport;
   const courseId = opts?.courseId;
   const queue = opts?.queue ?? createInMemoryXAPIQueue();
+  let warnedNoTransport = false;
+  let warnedTransportFailure = false;
   const sendOrQueue = (statement) => {
     if (!transport) {
       queue.enqueue(statement);
+      if (isDevEnvironment() && !warnedNoTransport) {
+        warnedNoTransport = true;
+        console.warn(
+          "[lessonkit] xAPI statements are queued but no transport is configured; pass config.xapi.transport or config.xapi.client"
+        );
+      }
       return;
     }
     void Promise.resolve().then(() => transport(statement)).catch(() => {
       queue.enqueue(statement);
+      if (isDevEnvironment() && !warnedTransportFailure) {
+        warnedTransportFailure = true;
+        console.warn(
+          "[lessonkit] xAPI transport failed; statement re-queued. Check your LRS endpoint or transport implementation."
+        );
+      }
     });
   };
   const emit = (event) => {

package/package.json

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