@more-ink/irt-edge 2.1.3 → 3.0.0

package/CHANGELOG.md

@@ -1,108 +1,154 @@
-# @more-ink/irt-edge
-
-## 2.1.2
-
-### Patch Changes
-
-- Require `timestamp` in `recordAnswer` / `recordAnswerOnly` requests and enforce validation in the API + SDK typings.
-- Keep `lastSeenAt` monotonic in bulk item updates (use max of existing vs. event timestamp).
-- Resetting an item now removes it from all skill item index sets.
-- Re-enabled Redis repo tests with updated MockRedis coverage.
-
-## 2.0.1
-
-### Patch Changes
-
-- Fix Redis diagnostics endpoint to accept both verbs and ship runtime deps in FC layer.
-
-## 2.0.0
-
-### Minor Changes
-
-- 8d8c76b: Add multi-skill recording support: the core engine now ingests multiple skill scores from a single item interaction, and irt-edge exposes a matching `/api/irt/answer-multi` endpoint plus SDK helpers.
-
-### Patch Changes
-
-- Updated dependencies [8d8c76b]
-  - @more-ink/irt-core@1.1.0
-
-## Unreleased
-
-### Minor Changes
-
-- Add `POST /api/irt/answer-multi` route plus SDK support (`recordMultiSkillAnswers`) to record several skill scores for the same item in one call, including docs and examples.
-
-## 1.3.0
-
-### Minor Changes
-
-- Add `recordAnswerOnly` endpoint + SDK method to record responses without requesting a next item, including updated REST route, types, and README docs.
-
-## 1.2.1
-
-### Patch Changes
-
-- Improve SDK typings with comprehensive JSDoc on every request and response shape, clarifying field semantics for IDE hovers and generated docs.
-
-## 1.2.0
-
-### Minor Changes
-
-- Add generic type parameter support for type-safe skill identifiers
-
-  The SDK now supports generic type parameters (`TSkillId`) for compile-time type safety, following the same pattern as @more-ink/irt-core. This enables:
-
-  - Type-safe skill identifiers with TypeScript union types or enums
-  - IDE autocomplete for skill names
-  - Compile-time validation preventing invalid skill identifiers
-  - 100% backward compatible (defaults to `string`)
-
-  Example usage:
-
-  ```typescript
-  type MySkills = "grammar" | "vocabulary" | "listening";
-  const client = new IrtClient<MySkills>({ baseUrl: "..." });
-
-  // TypeScript ensures skillId is valid at compile time
-  await client.recordAnswer({
-    userId: "user123",
-    skillId: "grammar", // ✅ Type-checked
-    itemId: "item456",
-    score: 0.8,
-  });
-  ```
-
-  All SDK types now support the generic parameter:
-
-  - `IrtClient<TSkillId>`
-  - `RecordAnswerRequest<TSkillId>`
-  - `RecordAnswerResponse<TSkillId>`
-  - `SelectNextItemRequest<TSkillId>`
-  - `SelectNextItemResponse<TSkillId>`
-  - `UserStateResponse<TSkillId>`
-  - `ItemStateResponse<TSkillId>`
-  - And all other related types
-
-## 1.1.0
-
-### Minor Changes
-
-- Initial SDK release: Add lightweight API client for JavaScript/TypeScript frontends
-
-  - New `IrtClient` class for consuming IRT Edge API
-  - Full TypeScript support with type definitions
-  - Complete API methods: recordAnswer, selectNextItem, getUserState, getItemState, health
-  - Zero runtime dependencies (only peer dependency on @more-ink/irt-core)
-  - Comprehensive documentation and examples
-  - Backend server code remains private (not published to npm)
-
-## 1.0.0
-
-### Major Changes
-
-- First major release
-
-### Patch Changes
-
-- Updated dependencies
-  - @more-ink/irt-core@1.0.0
+# @more-ink/irt-edge
+
+## 3.0.0
+
+### Breaking Changes
+
+- PTE routes moved from `/api/irt/pte/*` to `/api/pte/*`.
+- PTE processing no longer relies on `X-IRT-Namespace` exam typing from headers.
+- `PteClient` no longer inherits `IrtClient`.
+- `createPteClient` no longer accepts constructor `ttp`; `ttp` is provided per practice payload.
+- Generic IRT calls from `PteClient` now use `pte.irt(namespace)` explicitly.
+
+### Minor Changes
+
+- PTE namespace resolution is now part-aware:
+  - Subjective parts write to one namespace (`pte-a` or `pte-c`).
+  - Objective parts mirror writes to both `pte-a` and `pte-c`.
+  - `ttp='u'` is normalized to `a`.
+- Redis repositories now implement required bulk methods for user/item reads and writes.
+
+### Patch Changes
+
+- Updated dependencies:
+  - `@more-ink/irt-core@^2.0.0`
+
+## 2.2.0
+
+### Breaking Changes
+
+- `IrtClientConfig` now requires a mandatory `namespace` field. All SDK calls must include a namespace to isolate data by exam type.
+- `X-IRT-Namespace` header is enforced on every API request; requests without it return 400.
+
+### How to migrate
+
+```ts
+// Before
+const client = new IrtClient({ baseUrl: '...' })
+
+// After
+const client = new IrtClient({ namespace: 'pte', baseUrl: '...' })
+```
+
+### Internal Changes
+
+- Redis keys are namespaced as `irt:{namespace}:...` for full data isolation per exam type.
+- Postgres models include `namespace` with composite primary keys.
+- Engine instances are created and cached per namespace on the server.
+
+## 2.1.2
+
+### Patch Changes
+
+- Require `timestamp` in `recordAnswer` / `recordAnswerOnly` requests and enforce validation in the API + SDK typings.
+- Keep `lastSeenAt` monotonic in bulk item updates (use max of existing vs. event timestamp).
+- Resetting an item now removes it from all skill item index sets.
+- Re-enabled Redis repo tests with updated MockRedis coverage.
+
+## 2.0.1
+
+### Patch Changes
+
+- Fix Redis diagnostics endpoint to accept both verbs and ship runtime deps in FC layer.
+
+## 2.0.0
+
+### Minor Changes
+
+- 8d8c76b: Add multi-skill recording support: the core engine now ingests multiple skill scores from a single item interaction, and irt-edge exposes a matching `/api/irt/answer-multi` endpoint plus SDK helpers.
+
+### Patch Changes
+
+- Updated dependencies [8d8c76b]
+  - @more-ink/irt-core@1.1.0
+
+## Unreleased
+
+### Minor Changes
+
+- Add `POST /api/irt/answer-multi` route plus SDK support (`recordMultiSkillAnswers`) to record several skill scores for the same item in one call, including docs and examples.
+
+## 1.3.0
+
+### Minor Changes
+
+- Add `recordAnswerOnly` endpoint + SDK method to record responses without requesting a next item, including updated REST route, types, and README docs.
+
+## 1.2.1
+
+### Patch Changes
+
+- Improve SDK typings with comprehensive JSDoc on every request and response shape, clarifying field semantics for IDE hovers and generated docs.
+
+## 1.2.0
+
+### Minor Changes
+
+- Add generic type parameter support for type-safe skill identifiers
+
+  The SDK now supports generic type parameters (`TSkillId`) for compile-time type safety, following the same pattern as @more-ink/irt-core. This enables:
+
+  - Type-safe skill identifiers with TypeScript union types or enums
+  - IDE autocomplete for skill names
+  - Compile-time validation preventing invalid skill identifiers
+  - 100% backward compatible (defaults to `string`)
+
+  Example usage:
+
+  ```typescript
+  type MySkills = "grammar" | "vocabulary" | "listening";
+  const client = new IrtClient<MySkills>({ baseUrl: "..." });
+
+  // TypeScript ensures skillId is valid at compile time
+  await client.recordAnswer({
+    userId: "user123",
+    skillId: "grammar", // ✅ Type-checked
+    itemId: "item456",
+    score: 0.8,
+  });
+  ```
+
+  All SDK types now support the generic parameter:
+
+  - `IrtClient<TSkillId>`
+  - `RecordAnswerRequest<TSkillId>`
+  - `RecordAnswerResponse<TSkillId>`
+  - `SelectNextItemRequest<TSkillId>`
+  - `SelectNextItemResponse<TSkillId>`
+  - `UserStateResponse<TSkillId>`
+  - `ItemStateResponse<TSkillId>`
+  - And all other related types
+
+## 1.1.0
+
+### Minor Changes
+
+- Initial SDK release: Add lightweight API client for JavaScript/TypeScript frontends
+
+  - New `IrtClient` class for consuming IRT Edge API
+  - Full TypeScript support with type definitions
+  - Complete API methods: recordAnswer, selectNextItem, getUserState, getItemState, health
+  - Zero runtime dependencies (only peer dependency on @more-ink/irt-core)
+  - Comprehensive documentation and examples
+  - Backend server code remains private (not published to npm)
+
+## 1.0.0
+
+### Major Changes
+
+- First major release
+
+### Patch Changes
+
+- Updated dependencies
+  - @more-ink/irt-core@1.0.0