@lessonkit/core 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# `@lessonkit/core`
+
+Core types and runtime primitives shared across LessonKit packages.
+
+## Install
+
+```bash
+npm install @lessonkit/core
+```
+
+## What’s inside (0.1.x)
+
+- Telemetry event types (`TelemetryEvent`)
+- A minimal tracking client (`createTrackingClient`)
+

package/dist/index.cjs

@@ -0,0 +1,42 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createTrackingClient: () => createTrackingClient,
+  nowIso: () => nowIso
+});
+module.exports = __toCommonJS(index_exports);
+function createTrackingClient(opts) {
+  const sink = opts?.sink;
+  return {
+    track: (event) => {
+      void sink?.(event);
+    }
+  };
+}
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createTrackingClient,
+  nowIso
+});

package/dist/index.d.cts

@@ -0,0 +1,20 @@
+type CourseId = string;
+type LessonId = string;
+type TelemetryEventName = "course_started" | "course_completed" | "lesson_started" | "lesson_completed" | "quiz_answered" | "quiz_completed" | "interaction";
+type TelemetryEvent = {
+    name: TelemetryEventName;
+    timestamp: string;
+    courseId?: CourseId;
+    lessonId?: LessonId;
+    data?: Record<string, unknown>;
+};
+type TelemetrySink = (event: TelemetryEvent) => void | Promise<void>;
+type TrackingClient = {
+    track: (event: TelemetryEvent) => void;
+};
+declare function createTrackingClient(opts?: {
+    sink?: TelemetrySink;
+}): TrackingClient;
+declare function nowIso(): string;
+
+export { type CourseId, type LessonId, type TelemetryEvent, type TelemetryEventName, type TelemetrySink, type TrackingClient, createTrackingClient, nowIso };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+type CourseId = string;
+type LessonId = string;
+type TelemetryEventName = "course_started" | "course_completed" | "lesson_started" | "lesson_completed" | "quiz_answered" | "quiz_completed" | "interaction";
+type TelemetryEvent = {
+    name: TelemetryEventName;
+    timestamp: string;
+    courseId?: CourseId;
+    lessonId?: LessonId;
+    data?: Record<string, unknown>;
+};
+type TelemetrySink = (event: TelemetryEvent) => void | Promise<void>;
+type TrackingClient = {
+    track: (event: TelemetryEvent) => void;
+};
+declare function createTrackingClient(opts?: {
+    sink?: TelemetrySink;
+}): TrackingClient;
+declare function nowIso(): string;
+
+export { type CourseId, type LessonId, type TelemetryEvent, type TelemetryEventName, type TelemetrySink, type TrackingClient, createTrackingClient, nowIso };

package/dist/index.js

@@ -0,0 +1,16 @@
+// src/index.ts
+function createTrackingClient(opts) {
+  const sink = opts?.sink;
+  return {
+    track: (event) => {
+      void sink?.(event);
+    }
+  };
+}
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+export {
+  createTrackingClient,
+  nowIso
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@lessonkit/core",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Shared types and telemetry primitives for LessonKit.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eddiethedean/lessonkit.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/eddiethedean/lessonkit",
+  "bugs": {
+    "url": "https://github.com/eddiethedean/lessonkit/issues"
+  },
+  "keywords": [
+    "lessonkit",
+    "telemetry",
+    "analytics",
+    "learning",
+    "training"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run --passWithNoTests",
+    "lint": "echo \"(no lint configured yet)\""
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}