@lessonkit/core 0.9.2 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,13 +1,10 @@
1
- # `@lessonkit/core`
1
+ # @lessonkit/core
2
2
 
3
- [![CI](https://github.com/eddiethedean/lessonkit/actions/workflows/ci.yml/badge.svg)](https://github.com/eddiethedean/lessonkit/actions/workflows/ci.yml)
4
- [![Documentation](https://readthedocs.org/projects/lessonkit/badge/?version=latest)](https://lessonkit.readthedocs.io/en/latest/)
5
3
  [![npm](https://img.shields.io/npm/v/@lessonkit/core.svg)](https://www.npmjs.com/package/@lessonkit/core)
4
+ [![Documentation](https://readthedocs.org/projects/lessonkit/badge/?version=latest)](https://lessonkit.readthedocs.io/en/latest/reference/core.html)
6
5
  [![License](https://img.shields.io/github/license/eddiethedean/lessonkit)](https://github.com/eddiethedean/lessonkit/blob/main/LICENSE)
7
6
 
8
- Core types and runtime primitives shared across LessonKit packages.
9
-
10
- **Docs:** [Identity reference](https://lessonkit.readthedocs.io/en/latest/reference/identity.html) · [Telemetry reference](https://lessonkit.readthedocs.io/en/latest/reference/telemetry.html) · [Telemetry & xAPI guide](https://lessonkit.readthedocs.io/en/latest/guides/react-developers/telemetry-and-xapi.html)
7
+ Headless types, identity helpers, telemetry pipeline, and runtime primitives shared across LessonKit.
11
8
 
12
9
  ## Install
13
10
 
@@ -15,11 +12,33 @@ Core types and runtime primitives shared across LessonKit packages.
15
12
  npm install @lessonkit/core
16
13
  ```
17
14
 
18
- ## What's inside (0.6.0)
15
+ ## Usage
16
+
17
+ ```typescript
18
+ import {
19
+ buildTelemetryEvent,
20
+ createLessonkitRuntime,
21
+ createTelemetryPipeline,
22
+ createPluginRegistry,
23
+ buildLessonkitUrn,
24
+ } from "@lessonkit/core";
25
+ ```
26
+
27
+ ## Exports
28
+
29
+ | Area | Key APIs |
30
+ | --- | --- |
31
+ | Identity | `validateId`, `slugifyId`, `buildLessonkitUrn` |
32
+ | Telemetry | `buildTelemetryEvent`, `createTrackingClient`, `createTelemetryPipeline` |
33
+ | Runtime | `createLessonkitRuntime`, progress and session helpers |
34
+ | Plugins | `createPluginRegistry`, `defineTelemetryPlugin`, `defineAssessmentPlugin` |
35
+
36
+ Machine-readable: `@lessonkit/core/telemetry-catalog.v1.json`, `identity-contract.v1.json`
37
+
38
+ ## Docs
39
+
40
+ [Core reference](https://lessonkit.readthedocs.io/en/latest/reference/core.html) · [Identity](https://lessonkit.readthedocs.io/en/latest/reference/identity.html) · [Telemetry](https://lessonkit.readthedocs.io/en/latest/reference/telemetry.html) · [Plugins](https://lessonkit.readthedocs.io/en/latest/reference/plugins.html)
19
41
 
20
- - Identity helpers: `validateId`, `slugifyId`, `deriveId`, `buildLessonkitUrn`
21
- - Typed telemetry events (`TelemetryEvent`) and `telemetry-catalog.v1.json`
22
- - Tracking client (`createTrackingClient`) with optional batching
23
- - Session id helper (`createSessionId`)
42
+ ## License
24
43
 
25
- See the [identity](https://lessonkit.readthedocs.io/en/latest/reference/identity.html) and [telemetry](https://lessonkit.readthedocs.io/en/latest/reference/telemetry.html) references on Read the Docs.
44
+ Apache-2.0