@superbuilders/primer-tives 0.0.1

package/README.md

@@ -0,0 +1,344 @@
+# @superbuilders/primer-tives
+
+Client SDK for the Primer adaptive learning engine. Drives a state machine over HTTP POST — the client renders frames, the server controls all routing and assessment.
+
+The SDK has no concept of routines, curricula, or backend storage structure. It advances a student through whatever the server decides to serve next.
+
+## Install
+
+```sh
+bun add @superbuilders/primer-tives
+```
+
+Dependency: `@superbuilders/errors` is installed automatically.
+
+## Quick start
+
+```ts
+import { create } from "@superbuilders/primer-tives/client"
+import * as errors from "@superbuilders/errors"
+import { ErrNetwork, ErrRateLimited } from "@superbuilders/primer-tives/errors"
+
+const client = create({
+  publishableKey: "pk_live_abc123",
+  supportedPcis: ["urn:primer:pci:division-remainder"],
+})
+
+let state = await client.start("student-uuid")
+
+while (state.phase !== "completed" && state.phase !== "fatal") {
+  switch (state.phase) {
+    case "observation":
+      renderStimulus(state.stimulus)
+      state = await state.advance()
+      break
+
+    case "interaction":
+      switch (state.kind) {
+        case "choice":
+          state = await state.submitChoice(["option-a"])
+          break
+        case "text-entry":
+          state = await state.submitText("42")
+          break
+        case "extended-text":
+          if (state.cardinality === "single") {
+            state = await state.submitText("answer")
+          } else {
+            state = await state.submitTexts(["a", "b"])
+          }
+          break
+        case "portable-custom":
+          state = await state.submit({ quotient: "3", remainder: "1" })
+          break
+      }
+      break
+
+    case "feedback":
+      renderFeedback(state.isCorrect, state.feedbackContent, state.correctAnswer)
+      state = await state.advance()
+      break
+
+    case "errored":
+      if (errors.is(state.error, ErrRateLimited)) {
+        await delay(1000)
+      }
+      state = await state.retry()
+      break
+  }
+}
+```
+
+## Wire protocol
+
+Every request is a POST to `https://${origin}/api/v0/advance`:
+
+```
+POST /api/v0/advance
+Header: X-Primer-Publishable-Key: pk_...
+Body: { studentId, supportedPcis, intent }
+```
+
+When `origin` is omitted, the SDK uses a relative path (`/api/v0/advance`) for same-origin requests. For cross-origin integrations, set `origin` to the Primer API host (e.g., `https://sb-primer.vercel.app`). The path constant `ADVANCE_PATH` is exported for reference.
+
+The server identifies the student, determines which content to serve, evaluates submissions, and returns the next frame. The client never sends routing information — it only sends:
+
+- `studentId` — who is being advanced
+- `supportedPcis` — which custom interaction types the renderer can handle
+- `intent` — `{ kind: "observation" }` or `{ kind: "interaction", submission: ... }`
+
+## Configuration
+
+```ts
+interface Config<Pcis extends PciId = PciId> {
+  readonly publishableKey: string
+  readonly supportedPcis: readonly Pcis[]
+  readonly origin?: string
+  readonly fetch?: typeof globalThis.fetch
+  readonly abort?: AbortController
+  readonly logger?: PrimerLogger
+}
+```
+
+| Field | Required | Description |
+|---|---|---|
+| `publishableKey` | yes | Must start with `pk_`. Sent as `X-Primer-Publishable-Key` header |
+| `supportedPcis` | yes | PCI URNs the renderer handles. `[]` if none |
+| `origin` | no | Origin URL for cross-origin requests. Omit for same-origin (relative fetch). Required for third-party integrations |
+| `fetch` | no | Custom fetch. Defaults to `globalThis.fetch` |
+| `abort` | no | AbortController for cancelling in-flight requests |
+| `logger` | no | Structured logger (`debug`, `info`, `warn`, `error`) |
+
+`create()` validates the key prefix immediately — throws `ErrMalformedPublishableKey` if invalid.
+
+## State machine
+
+`PrimerState` is a discriminated union on `phase`:
+
+```
+observation → interaction → feedback → observation → ... → completed
+                  ↓              ↓
+               errored        errored
+                  ↓
+               (retry) → back to failed phase
+```
+
+### `observation`
+
+Display-only frame. Show the stimulus, call `advance()`.
+
+```ts
+state.stimulus  // RendererStimulus | null
+state.advance() // Promise<PrimerState>
+```
+
+Stimulus is a discriminated union on `type`:
+- `BodyStimulus` — `{ type: "body", body: ContentBlock[] }` — text-only
+- `ImageStimulus` — `{ type: "image", description: ContentInline[], src: string }` — image-backed
+- `null` — no stimulus
+
+### `interaction`
+
+Student must respond. Discriminate on `state.kind`:
+
+| `state.kind` | Submit | Key fields |
+|---|---|---|
+| `"choice"` | `submitChoice(keys: string[])` | `options`, `maxChoices`, `minChoices` |
+| `"text-entry"` | `submitText(value: string)` | — |
+| `"extended-text"` (single) | `submitText(value: string)` | `cardinality: "single"` |
+| `"extended-text"` (multiple) | `submitTexts(values: string[])` | `cardinality: "multiple"`, `maxStrings`, `minStrings` |
+| `"portable-custom"` | `submit(value: PciValue<K>)` | `pciId`, `properties` |
+
+All submit methods return `Promise<PrimerState>`.
+
+### `feedback`
+
+Server evaluated the submission. Show result, call `advance()`.
+
+```ts
+state.stimulus         // RendererStimulus | null
+state.interaction      // the original interaction
+state.submission       // the student's submission
+state.isCorrect        // boolean
+state.feedbackContent  // ContentInline[]
+state.correctAnswer    // RendererCorrectAnswer | null
+state.advance()        // Promise<PrimerState>
+```
+
+`correctAnswer` carries the canonical correct response, or `null` when unavailable:
+
+```ts
+type RendererCorrectScalarValue =
+  | { kind: "identifier"; value: string }
+  | { kind: "string"; value: string }
+  | { kind: "integer"; value: number }
+  | { kind: "float"; value: number }
+
+type RendererCorrectAnswer =
+  | { kind: "single"; value: RendererCorrectScalarValue | null }
+  | { kind: "multiple"; values: RendererCorrectScalarValue[] }
+  | {
+      kind: "record"
+      fields: Array<{
+        fieldIdentifier: string
+        baseType: "identifier" | "string" | "integer" | "float"
+        value: RendererCorrectScalarValue | null
+      }>
+    }
+```
+
+For choice interactions, extract correct option identifiers from `kind: "identifier"` scalars. For text-entry, check `kind: "string"` or `kind: "integer"`. For PCI record responses, iterate `fields`. `null` means the server could not determine a correct response.
+
+### `completed`
+
+Session finished. No further actions.
+
+### `errored`
+
+Retryable error (network, timeout, rate limit, 5xx). Remembers the failed intent.
+
+```ts
+state.error        // Error sentinel (use errors.is())
+state.failedPhase  // "observation" | "interaction"
+state.retry()      // Promise<PrimerState> — replays exact failed intent
+```
+
+### `fatal`
+
+Terminal. Unsupported PCI or unknown interaction type. Session is broken.
+
+## Stimulus & Interaction
+
+Every state carries a `stimulus: RendererStimulus | null` directly:
+
+```ts
+state.stimulus  // RendererStimulus | null
+```
+
+Stimulus is a discriminated union on `type`:
+- `BodyStimulus` — `{ type: "body", body: ContentBlock[] }` — text-only
+- `ImageStimulus` — `{ type: "image", description: ContentInline[], src: string }` — image-backed
+- `null` — no stimulus
+
+Interaction states also carry `interaction` directly:
+
+```ts
+state.interaction.prompt  // ContentInline[]
+state.interaction.type    // "choice" | "text-entry" | "extended-text" | "portable-custom"
+```
+
+## Client-side validation
+
+The SDK validates submissions before sending them to the server:
+
+**Choice:** rejects fewer than `minChoices`, more than `maxChoices`, duplicates, unknown option identifiers.
+
+**Extended text (multiple):** rejects fewer than `minStrings`, more than `maxStrings`.
+
+Failed validation returns an `errored` state with `ErrInvalidSubmission`.
+
+## Error sentinels
+
+```ts
+import * as errors from "@superbuilders/errors"
+import { ErrNetwork, ErrRateLimited } from "@superbuilders/primer-tives/errors"
+
+if (errors.is(state.error, ErrNetwork)) { /* handle */ }
+```
+
+| Sentinel | Cause |
+|---|---|
+| `ErrNetwork` | Fetch failed (offline, DNS, CORS) |
+| `ErrTimeout` | Request aborted or timed out |
+| `ErrJsonParse` | Response not valid JSON |
+| `ErrBadRequest` | 400 |
+| `ErrInvalidPublishableKey` | 401 |
+| `ErrForbidden` | 403 |
+| `ErrNotFound` | 404 |
+| `ErrConflict` | 409 |
+| `ErrUnsupportedPci` | 422 — server sent a PCI the client can't handle |
+| `ErrRateLimited` | 429 |
+| `ErrServerError` | 5xx |
+| `ErrServiceUnavailable` | 502/503/504 |
+| `ErrInvalidSubmission` | Client-side validation failed |
+| `ErrNotSerializable` | Attempted to JSON.stringify PrimerState |
+| `ErrMalformedPublishableKey` | Key doesn't start with `pk_` |
+
+**`errored`** = retryable (call `retry()`). **`fatal`** = terminal.
+
+## Submission payloads
+
+```ts
+type RendererSubmission<K extends PciId = PciId> =
+  | { type: "choice"; selectedKeys: string[] }
+  | { type: "text-entry"; value: string }
+  | { type: "extended-text"; values: string[] }
+  | { type: "portable-custom"; pciId: K; value: PciValue<K> }
+```
+
+See `/types` for the full type surface.
+
+## Content format
+
+Minimal example of the content format:
+
+```ts
+type ContentInline =
+  | { type: "text"; value: string }
+  | { type: "italic"; children: ContentInline[] }
+
+type ContentBlock = { type: "paragraph"; children: ContentInline[] }
+```
+
+`inlinesToPlainText(nodes)` strips inline formatting for accessibility labels. `blocksToPlainText(blocks)` flattens blocks to plain text. See `/content` for the complete type surface.
+
+## PCI system
+
+Portable Custom Interactions handle domain-specific input types with full type safety.
+
+### Registry
+
+```ts
+interface PciRegistry {
+  "urn:primer:pci:division-remainder": {
+    props: { dividend: number; divisor: number }
+    value: { quotient: string; remainder: string }
+  }
+  "urn:primer:pci:fraction-addition": {
+    props: {
+      left: { numerator: number; denominator: number }
+      right: { numerator: number; denominator: number }
+    }
+    value: { numerator: string; denominator: string }
+  }
+}
+```
+
+### Type helpers
+
+```ts
+type PciId = keyof PciRegistry & string
+type PciProps<K extends PciId>   // server-provided props
+type PciValue<K extends PciId>   // submission value
+```
+
+### Adding a PCI
+
+1. Add entry to `PciRegistry` in `src/pci.ts`
+2. URN format: `urn:primer:pci:<name>`
+3. Include in `supportedPcis` when calling `create()`
+4. Build renderer with `PciRenderProps<"urn:primer:pci:your-pci">`
+
+## Subpath exports
+
+| Path | JS | Description |
+|---|---|---|
+| `/client` | yes | `create()`, transport, state machine |
+| `/types` | yes | States, interactions, submissions, `PciRenderProps` |
+| `/content` | yes | `ContentInline`, `inlinesToPlainText()` |
+| `/errors` | yes | 15 sentinel error constants |
+| `/pci` | yes | `PciId`, `PciProps`, `PciValue`, `PciRegistry` |
+
+## Non-serializable state
+
+`PrimerState` contains closures. Every state object has a poisoned `toJSON()` that throws `ErrNotSerializable`. Do not persist, stringify, or transfer `PrimerState` — it is ephemeral in-memory state.

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+import type { PciId } from "./pci";
+import type { PrimerState } from "./types";
+interface PrimerLogger {
+    debug(message: string, attributes?: Record<string, unknown>): void;
+    info(message: string, attributes?: Record<string, unknown>): void;
+    warn(message: string, attributes?: Record<string, unknown>): void;
+    error(message: string, attributes?: Record<string, unknown>): void;
+}
+declare const DEFAULT_ORIGIN = "https://sb-primer.vercel.app";
+declare const ADVANCE_PATH = "/api/v0/advance";
+interface Config<Pcis extends PciId = PciId> {
+    readonly publishableKey: string;
+    readonly supportedPcis: readonly Pcis[];
+    readonly origin?: string;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly abort?: AbortController;
+    readonly logger?: PrimerLogger;
+}
+interface Client<Pcis extends PciId = PciId> {
+    start(studentId: string): Promise<PrimerState<Pcis>>;
+}
+declare function create<const Pcis extends PciId>(config: Config<Pcis>): Client<Pcis>;
+export { ADVANCE_PATH, DEFAULT_ORIGIN, create };
+export type { Client, Config, PrimerLogger };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,KAAK,EAAY,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAIX,WAAW,EAMX,MAAM,mCAAmC,CAAA;AAG1C,UAAU,YAAY;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAClE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACjE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAClE;AAiCD,QAAA,MAAM,cAAc,iCAAiC,CAAA;AACrD,QAAA,MAAM,YAAY,oBAAoB,CAAA;AAEtC,UAAU,MAAM,CAAC,IAAI,SAAS,KAAK,GAAG,KAAK;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,SAAS,IAAI,EAAE,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAC9B;AAED,UAAU,MAAM,CAAC,IAAI,SAAS,KAAK,GAAG,KAAK;IAC1C,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;CACpD;AA+CD,iBAAS,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAmb5E;AAED,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,CAAA;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA"}

package/dist/client.js

@@ -0,0 +1,383 @@
+// src/errors.ts
+import * as errors from "@superbuilders/errors";
+var ErrNetwork = errors.new("network");
+var ErrJsonParse = errors.new("json parse");
+var ErrUnsupportedPci = errors.new("unsupported pci");
+var ErrInvalidPublishableKey = errors.new("invalid publishable key");
+var ErrBadRequest = errors.new("bad request");
+var ErrServerError = errors.new("server error");
+var ErrTimeout = errors.new("timeout");
+var ErrForbidden = errors.new("forbidden");
+var ErrNotFound = errors.new("not found");
+var ErrConflict = errors.new("conflict");
+var ErrRateLimited = errors.new("rate limited");
+var ErrServiceUnavailable = errors.new("service unavailable");
+var ErrNotSerializable = errors.new("PrimerState is live in-memory state and must not be serialized or stored");
+var ErrInvalidSubmission = errors.new("invalid submission");
+var ErrMalformedPublishableKey = errors.new("malformed publishable key");
+// src/client.ts
+import * as errors2 from "@superbuilders/errors";
+var DEFAULT_ORIGIN = "https://sb-primer.vercel.app";
+var ADVANCE_PATH = "/api/v0/advance";
+function poisonToJSON() {
+  throw ErrNotSerializable;
+}
+function httpSentinel(status) {
+  if (status === 400) {
+    return ErrBadRequest;
+  }
+  if (status === 401) {
+    return ErrInvalidPublishableKey;
+  }
+  if (status === 403) {
+    return ErrForbidden;
+  }
+  if (status === 404) {
+    return ErrNotFound;
+  }
+  if (status === 409) {
+    return ErrConflict;
+  }
+  if (status === 422) {
+    return ErrUnsupportedPci;
+  }
+  if (status === 429) {
+    return ErrRateLimited;
+  }
+  if (status === 502 || status === 503 || status === 504) {
+    return ErrServiceUnavailable;
+  }
+  return ErrServerError;
+}
+function isAbortError(err) {
+  if (err instanceof DOMException && err.name === "AbortError") {
+    return true;
+  }
+  if (err instanceof DOMException && err.name === "TimeoutError") {
+    return true;
+  }
+  return false;
+}
+var PK_PREFIX = "pk_";
+function create(config) {
+  const configFetch = config.fetch;
+  const fetchFn = configFetch ? configFetch : globalThis.fetch;
+  const log = config.logger;
+  if (!config.publishableKey.startsWith(PK_PREFIX)) {
+    log?.error("malformed publishable key", { prefix: PK_PREFIX });
+    throw errors2.wrap(ErrMalformedPublishableKey, `key must start with '${PK_PREFIX}'`);
+  }
+  function transportSignal() {
+    if (config.abort) {
+      return config.abort.signal;
+    }
+    return;
+  }
+  async function transport(body) {
+    log?.debug("transport request", {
+      studentId: body.studentId,
+      intentKind: body.intent.kind
+    });
+    const url = config.origin ? `${config.origin}${ADVANCE_PATH}` : ADVANCE_PATH;
+    const fetchResult = await fetchFn(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Primer-Publishable-Key": config.publishableKey
+      },
+      body: JSON.stringify(body),
+      signal: transportSignal()
+    }).then(function ok(r) {
+      return { ok: true, response: r };
+    }, function fail(err) {
+      return { ok: false, error: err };
+    });
+    if (!fetchResult.ok) {
+      if (isAbortError(fetchResult.error)) {
+        log?.error("transport timeout", {
+          studentId: body.studentId,
+          intentKind: body.intent.kind
+        });
+        return { ok: false, error: errors2.wrap(ErrTimeout, fetchResult.error.message) };
+      }
+      log?.error("transport network error", {
+        studentId: body.studentId,
+        error: fetchResult.error
+      });
+      return { ok: false, error: errors2.wrap(ErrNetwork, fetchResult.error.message) };
+    }
+    const res = fetchResult.response;
+    if (!res.ok) {
+      const text = await res.text().catch(function fallback() {
+        return "";
+      });
+      const sentinel = httpSentinel(res.status);
+      log?.error("transport http error", {
+        studentId: body.studentId,
+        status: res.status
+      });
+      return { ok: false, error: errors2.wrap(sentinel, text) };
+    }
+    const jsonResult = await res.json().then(function ok(data) {
+      return { ok: true, data };
+    }, function fail(err) {
+      return { ok: false, error: err };
+    });
+    if (!jsonResult.ok) {
+      log?.error("transport json parse failed", {
+        studentId: body.studentId,
+        error: jsonResult.error
+      });
+      return { ok: false, error: errors2.wrap(ErrJsonParse, jsonResult.error.message) };
+    }
+    log?.debug("transport success", {
+      studentId: body.studentId,
+      intentKind: body.intent.kind
+    });
+    return { ok: true, data: jsonResult.data };
+  }
+  function makeSession(studentId) {
+    function resolve(result) {
+      switch (result.outcome) {
+        case "advanced":
+          return fromAdvanced(result.stimulus, result.interaction);
+        case "submitted":
+          return feedbackState(result.stimulus, result.interaction, result.submission, result.isCorrect, result.feedbackContent, result.correctAnswer);
+        case "completed":
+          return { phase: "completed", toJSON: poisonToJSON };
+      }
+    }
+    function errored(error, failedPhase, intent) {
+      return {
+        phase: "errored",
+        error,
+        failedPhase,
+        retry: function retry() {
+          log?.debug("retrying from errored state", { failedPhase });
+          return execute(intent, failedPhase);
+        },
+        toJSON: poisonToJSON
+      };
+    }
+    async function execute(intent, phase) {
+      const body = {
+        studentId,
+        supportedPcis: config.supportedPcis,
+        intent
+      };
+      const result = await transport(body);
+      if (!result.ok) {
+        return errored(result.error, phase, intent);
+      }
+      return resolve(result.data);
+    }
+    function isPciSupported(pciId) {
+      for (const id of config.supportedPcis) {
+        if (id === pciId) {
+          return true;
+        }
+      }
+      return false;
+    }
+    function fromAdvanced(stimulus, interaction) {
+      if (interaction === null) {
+        return observationState(stimulus);
+      }
+      if (interaction.type === "portable-custom") {
+        if (!isPciSupported(interaction.pciId)) {
+          log?.error("unsupported pci in frame", { pciId: interaction.pciId });
+          return {
+            phase: "fatal",
+            error: errors2.wrap(ErrUnsupportedPci, `pci '${interaction.pciId}'`),
+            toJSON: poisonToJSON
+          };
+        }
+      }
+      return pendingInteractionState(stimulus, interaction);
+    }
+    function observationState(stimulus) {
+      return {
+        phase: "observation",
+        stimulus,
+        advance: function advance() {
+          return execute({ kind: "observation" }, "observation");
+        },
+        toJSON: poisonToJSON
+      };
+    }
+    function pendingInteractionState(stimulus, interaction) {
+      switch (interaction.type) {
+        case "choice":
+          return choiceState(stimulus, interaction, interaction.options, interaction.maxChoices, interaction.minChoices);
+        case "text-entry":
+          return textEntryState(stimulus, interaction);
+        case "extended-text":
+          return extendedTextState(stimulus, interaction);
+        case "portable-custom":
+          return pciInteractionState(stimulus, interaction);
+      }
+    }
+    function findUnknownKey(selectedKeys, options) {
+      const optionIds = new Set(options.map(function getId(o) {
+        return o.identifier;
+      }));
+      for (const key of selectedKeys) {
+        if (!optionIds.has(key)) {
+          return key;
+        }
+      }
+      return null;
+    }
+    function validateChoiceSubmission(selectedKeys, options, maxChoices, minChoices) {
+      if (selectedKeys.length < minChoices) {
+        log?.error("choice submit below minChoices", { selectedKeys, minChoices });
+        return errors2.wrap(ErrInvalidSubmission, `need at least ${minChoices} selections`);
+      }
+      if (selectedKeys.length > maxChoices) {
+        log?.error("choice submit above maxChoices", { selectedKeys, maxChoices });
+        return errors2.wrap(ErrInvalidSubmission, `at most ${maxChoices} selections`);
+      }
+      const uniqueKeys = new Set(selectedKeys);
+      if (uniqueKeys.size !== selectedKeys.length) {
+        log?.error("choice submit has duplicates", { selectedKeys });
+        return errors2.wrap(ErrInvalidSubmission, "duplicate selections");
+      }
+      const unknownKey = findUnknownKey(selectedKeys, options);
+      if (unknownKey) {
+        log?.error("choice submit has unknown key", { key: unknownKey });
+        return errors2.wrap(ErrInvalidSubmission, `unknown option '${unknownKey}'`);
+      }
+      return null;
+    }
+    function choiceState(stimulus, interaction, options, maxChoices, minChoices) {
+      return {
+        phase: "interaction",
+        kind: "choice",
+        stimulus,
+        interaction,
+        options,
+        maxChoices,
+        minChoices,
+        submitChoice: function submitChoice(selectedKeys) {
+          const validationError = validateChoiceSubmission(selectedKeys, options, maxChoices, minChoices);
+          if (validationError) {
+            return Promise.resolve(errored(validationError, "interaction", {
+              kind: "interaction",
+              submission: { type: "choice", selectedKeys }
+            }));
+          }
+          return execute({ kind: "interaction", submission: { type: "choice", selectedKeys } }, "interaction");
+        },
+        toJSON: poisonToJSON
+      };
+    }
+    function textEntryState(stimulus, interaction) {
+      return {
+        phase: "interaction",
+        kind: "text-entry",
+        stimulus,
+        interaction,
+        submitText: function submitText(value) {
+          return execute({ kind: "interaction", submission: { type: "text-entry", value } }, "interaction");
+        },
+        toJSON: poisonToJSON
+      };
+    }
+    function validateExtendedTextSubmission(values, minStrings, maxStrings) {
+      if (values.length < minStrings) {
+        log?.error("extended-text submit below minStrings", { count: values.length, minStrings });
+        return errors2.wrap(ErrInvalidSubmission, `need at least ${minStrings} values`);
+      }
+      if (values.length > maxStrings) {
+        log?.error("extended-text submit above maxStrings", { count: values.length, maxStrings });
+        return errors2.wrap(ErrInvalidSubmission, `at most ${maxStrings} values`);
+      }
+      return null;
+    }
+    function extendedTextState(stimulus, interaction) {
+      const maxStrings = interaction.maxStrings;
+      const minStrings = interaction.minStrings;
+      if (maxStrings === 1) {
+        return {
+          phase: "interaction",
+          kind: "extended-text",
+          cardinality: "single",
+          stimulus,
+          interaction,
+          submitText: function submitText(value) {
+            return execute({ kind: "interaction", submission: { type: "extended-text", values: [value] } }, "interaction");
+          },
+          toJSON: poisonToJSON
+        };
+      }
+      return {
+        phase: "interaction",
+        kind: "extended-text",
+        cardinality: "multiple",
+        stimulus,
+        interaction,
+        maxStrings,
+        minStrings,
+        submitTexts: function submitTexts(values) {
+          const validationError = validateExtendedTextSubmission(values, minStrings, maxStrings);
+          if (validationError) {
+            return Promise.resolve(errored(validationError, "interaction", {
+              kind: "interaction",
+              submission: { type: "extended-text", values }
+            }));
+          }
+          return execute({ kind: "interaction", submission: { type: "extended-text", values } }, "interaction");
+        },
+        toJSON: poisonToJSON
+      };
+    }
+    function pciInteractionState(stimulus, interaction) {
+      const { pciId, properties } = interaction;
+      function submit(value) {
+        log?.debug("pci submit", { pciId });
+        const submission = { type: "portable-custom", pciId, value };
+        return execute({ kind: "interaction", submission }, "interaction");
+      }
+      return {
+        phase: "interaction",
+        kind: "portable-custom",
+        stimulus,
+        interaction,
+        pciId,
+        properties,
+        submit,
+        toJSON: poisonToJSON
+      };
+    }
+    function feedbackState(stimulus, interaction, submission, isCorrect, feedbackContent, correctAnswer) {
+      return {
+        phase: "feedback",
+        stimulus,
+        interaction,
+        submission,
+        isCorrect,
+        feedbackContent,
+        correctAnswer,
+        advance: function advance() {
+          return execute({ kind: "observation" }, "observation");
+        },
+        toJSON: poisonToJSON
+      };
+    }
+    return { execute };
+  }
+  return {
+    async start(studentId) {
+      log?.debug("start", { studentId });
+      const s = makeSession(studentId);
+      return s.execute({ kind: "observation" }, "observation");
+    }
+  };
+}
+export {
+  create,
+  DEFAULT_ORIGIN,
+  ADVANCE_PATH
+};
+
+//# debugId=B2799CD48726B75C64756E2164756E21

package/dist/client.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts", "../src/client.ts"],
+  "sourcesContent": [
+    "import * as errors from \"@superbuilders/errors\"\n\nconst ErrNetwork = errors.new(\"network\")\nconst ErrJsonParse = errors.new(\"json parse\")\nconst ErrUnsupportedPci = errors.new(\"unsupported pci\")\nconst ErrInvalidPublishableKey = errors.new(\"invalid publishable key\")\nconst ErrBadRequest = errors.new(\"bad request\")\nconst ErrServerError = errors.new(\"server error\")\nconst ErrTimeout = errors.new(\"timeout\")\nconst ErrForbidden = errors.new(\"forbidden\")\nconst ErrNotFound = errors.new(\"not found\")\nconst ErrConflict = errors.new(\"conflict\")\nconst ErrRateLimited = errors.new(\"rate limited\")\nconst ErrServiceUnavailable = errors.new(\"service unavailable\")\nconst ErrNotSerializable = errors.new(\n\t\"PrimerState is live in-memory state and must not be serialized or stored\"\n)\nconst ErrInvalidSubmission = errors.new(\"invalid submission\")\nconst ErrMalformedPublishableKey = errors.new(\"malformed publishable key\")\n\nexport {\n\tErrBadRequest,\n\tErrConflict,\n\tErrForbidden,\n\tErrInvalidPublishableKey,\n\tErrInvalidSubmission,\n\tErrMalformedPublishableKey,\n\tErrJsonParse,\n\tErrNetwork,\n\tErrNotFound,\n\tErrNotSerializable,\n\tErrRateLimited,\n\tErrServerError,\n\tErrServiceUnavailable,\n\tErrTimeout,\n\tErrUnsupportedPci\n}\n",
+    "import * as errors from \"@superbuilders/errors\"\nimport {\n\tErrBadRequest,\n\tErrConflict,\n\tErrForbidden,\n\tErrInvalidPublishableKey,\n\tErrJsonParse,\n\tErrMalformedPublishableKey,\n\tErrNetwork,\n\tErrNotFound,\n\tErrNotSerializable,\n\tErrRateLimited,\n\tErrServerError,\n\tErrServiceUnavailable,\n\tErrTimeout,\n\tErrUnsupportedPci,\n\tErrInvalidSubmission\n} from \"@superbuilders/primer-tives/errors\"\nimport type { PciId, PciValue } from \"@superbuilders/primer-tives/pci\"\nimport type {\n\tErroredState,\n\tPciInteraction,\n\tPciInteractionState,\n\tPrimerState,\n\tRendererChoice,\n\tRendererCorrectAnswer,\n\tRendererInteraction,\n\tRendererStimulus,\n\tRendererSubmission\n} from \"@superbuilders/primer-tives/types\"\nimport type { ContentInline } from \"@superbuilders/primer-tives/content\"\n\ninterface PrimerLogger {\n\tdebug(message: string, attributes?: Record<string, unknown>): void\n\tinfo(message: string, attributes?: Record<string, unknown>): void\n\twarn(message: string, attributes?: Record<string, unknown>): void\n\terror(message: string, attributes?: Record<string, unknown>): void\n}\n\ntype WireIntent<Pcis extends PciId = PciId> =\n\t| { kind: \"observation\" }\n\t| { kind: \"interaction\"; submission: RendererSubmission<Pcis> }\n\ntype WireResult<Pcis extends PciId = PciId> =\n\t| {\n\t\t\toutcome: \"advanced\"\n\t\t\tstimulus: RendererStimulus | null\n\t\t\tinteraction: RendererInteraction<Pcis> | null\n\t  }\n\t| {\n\t\t\toutcome: \"submitted\"\n\t\t\tstimulus: RendererStimulus | null\n\t\t\tinteraction: RendererInteraction<Pcis>\n\t\t\tsubmission: RendererSubmission<Pcis>\n\t\t\tisCorrect: boolean\n\t\t\tfeedbackContent: ContentInline[]\n\t\t\tcorrectAnswer: RendererCorrectAnswer | null\n\t  }\n\t| { outcome: \"completed\" }\n\ninterface WireRequestBody<Pcis extends PciId = PciId> {\n\tstudentId: string\n\tsupportedPcis: readonly PciId[]\n\tintent: WireIntent<Pcis>\n}\n\ntype TransportResult<Pcis extends PciId = PciId> =\n\t| { ok: true; data: WireResult<Pcis> }\n\t| { ok: false; error: Error }\n\nconst DEFAULT_ORIGIN = \"https://sb-primer.vercel.app\"\nconst ADVANCE_PATH = \"/api/v0/advance\"\n\ninterface Config<Pcis extends PciId = PciId> {\n\treadonly publishableKey: string\n\treadonly supportedPcis: readonly Pcis[]\n\treadonly origin?: string\n\treadonly fetch?: typeof globalThis.fetch\n\treadonly abort?: AbortController\n\treadonly logger?: PrimerLogger\n}\n\ninterface Client<Pcis extends PciId = PciId> {\n\tstart(studentId: string): Promise<PrimerState<Pcis>>\n}\n\nfunction poisonToJSON(): never {\n\t// biome-ignore lint/plugin: intentional toJSON trap — logging here would spam on every accidental serialize attempt\n\tthrow ErrNotSerializable\n}\n\nfunction httpSentinel(status: number): Error {\n\tif (status === 400) {\n\t\treturn ErrBadRequest\n\t}\n\tif (status === 401) {\n\t\treturn ErrInvalidPublishableKey\n\t}\n\tif (status === 403) {\n\t\treturn ErrForbidden\n\t}\n\tif (status === 404) {\n\t\treturn ErrNotFound\n\t}\n\tif (status === 409) {\n\t\treturn ErrConflict\n\t}\n\tif (status === 422) {\n\t\treturn ErrUnsupportedPci\n\t}\n\tif (status === 429) {\n\t\treturn ErrRateLimited\n\t}\n\tif (status === 502 || status === 503 || status === 504) {\n\t\treturn ErrServiceUnavailable\n\t}\n\treturn ErrServerError\n}\n\nfunction isAbortError(err: unknown): boolean {\n\tif (err instanceof DOMException && err.name === \"AbortError\") {\n\t\treturn true\n\t}\n\tif (err instanceof DOMException && err.name === \"TimeoutError\") {\n\t\treturn true\n\t}\n\treturn false\n}\n\nconst PK_PREFIX = \"pk_\"\n\nfunction create<const Pcis extends PciId>(config: Config<Pcis>): Client<Pcis> {\n\tconst configFetch = config.fetch\n\tconst fetchFn = configFetch ? configFetch : globalThis.fetch\n\tconst log = config.logger\n\n\tif (!config.publishableKey.startsWith(PK_PREFIX)) {\n\t\tlog?.error(\"malformed publishable key\", { prefix: PK_PREFIX })\n\t\t// biome-ignore lint/plugin: client SDK — log is optional config.logger, not slog\n\t\tthrow errors.wrap(ErrMalformedPublishableKey, `key must start with '${PK_PREFIX}'`)\n\t}\n\n\tfunction transportSignal(): AbortSignal | undefined {\n\t\tif (config.abort) {\n\t\t\treturn config.abort.signal\n\t\t}\n\t\treturn undefined\n\t}\n\n\tasync function transport(body: WireRequestBody<Pcis>): Promise<TransportResult<Pcis>> {\n\t\tlog?.debug(\"transport request\", {\n\t\t\tstudentId: body.studentId,\n\t\t\tintentKind: body.intent.kind\n\t\t})\n\n\t\tconst url = config.origin ? `${config.origin}${ADVANCE_PATH}` : ADVANCE_PATH\n\t\tconst fetchResult = await fetchFn(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\"X-Primer-Publishable-Key\": config.publishableKey\n\t\t\t},\n\t\t\tbody: JSON.stringify(body),\n\t\t\tsignal: transportSignal()\n\t\t}).then(\n\t\t\tfunction ok(r: Response) {\n\t\t\t\treturn { ok: true, response: r } as const\n\t\t\t},\n\t\t\tfunction fail(err: Error) {\n\t\t\t\treturn { ok: false, error: err } as const\n\t\t\t}\n\t\t)\n\n\t\tif (!fetchResult.ok) {\n\t\t\tif (isAbortError(fetchResult.error)) {\n\t\t\t\tlog?.error(\"transport timeout\", {\n\t\t\t\t\tstudentId: body.studentId,\n\t\t\t\t\tintentKind: body.intent.kind\n\t\t\t\t})\n\t\t\t\treturn { ok: false, error: errors.wrap(ErrTimeout, fetchResult.error.message) }\n\t\t\t}\n\t\t\tlog?.error(\"transport network error\", {\n\t\t\t\tstudentId: body.studentId,\n\t\t\t\terror: fetchResult.error\n\t\t\t})\n\t\t\treturn { ok: false, error: errors.wrap(ErrNetwork, fetchResult.error.message) }\n\t\t}\n\n\t\tconst res = fetchResult.response\n\n\t\tif (!res.ok) {\n\t\t\tconst text = await res.text().catch(function fallback() {\n\t\t\t\treturn \"\"\n\t\t\t})\n\t\t\tconst sentinel = httpSentinel(res.status)\n\t\t\tlog?.error(\"transport http error\", {\n\t\t\t\tstudentId: body.studentId,\n\t\t\t\tstatus: res.status\n\t\t\t})\n\t\t\treturn { ok: false, error: errors.wrap(sentinel, text) }\n\t\t}\n\n\t\tconst jsonResult = await res.json().then(\n\t\t\tfunction ok(data: WireResult<Pcis>) {\n\t\t\t\treturn { ok: true, data } as const\n\t\t\t},\n\t\t\tfunction fail(err: Error) {\n\t\t\t\treturn { ok: false, error: err } as const\n\t\t\t}\n\t\t)\n\n\t\tif (!jsonResult.ok) {\n\t\t\tlog?.error(\"transport json parse failed\", {\n\t\t\t\tstudentId: body.studentId,\n\t\t\t\terror: jsonResult.error\n\t\t\t})\n\t\t\treturn { ok: false, error: errors.wrap(ErrJsonParse, jsonResult.error.message) }\n\t\t}\n\n\t\tlog?.debug(\"transport success\", {\n\t\t\tstudentId: body.studentId,\n\t\t\tintentKind: body.intent.kind\n\t\t})\n\n\t\treturn { ok: true, data: jsonResult.data }\n\t}\n\n\tfunction makeSession(studentId: string) {\n\t\tfunction resolve(result: WireResult<Pcis>): PrimerState<Pcis> {\n\t\t\tswitch (result.outcome) {\n\t\t\t\tcase \"advanced\":\n\t\t\t\t\treturn fromAdvanced(result.stimulus, result.interaction)\n\t\t\t\tcase \"submitted\":\n\t\t\t\t\treturn feedbackState(\n\t\t\t\t\t\tresult.stimulus,\n\t\t\t\t\t\tresult.interaction,\n\t\t\t\t\t\tresult.submission,\n\t\t\t\t\t\tresult.isCorrect,\n\t\t\t\t\t\tresult.feedbackContent,\n\t\t\t\t\t\tresult.correctAnswer\n\t\t\t\t\t)\n\t\t\t\tcase \"completed\":\n\t\t\t\t\treturn { phase: \"completed\", toJSON: poisonToJSON }\n\t\t\t}\n\t\t}\n\n\t\tfunction errored(\n\t\t\terror: Error,\n\t\t\tfailedPhase: \"observation\" | \"interaction\",\n\t\t\tintent: WireIntent<Pcis>\n\t\t): ErroredState<Pcis> {\n\t\t\treturn {\n\t\t\t\tphase: \"errored\",\n\t\t\t\terror,\n\t\t\t\tfailedPhase,\n\t\t\t\tretry: function retry() {\n\t\t\t\t\tlog?.debug(\"retrying from errored state\", { failedPhase })\n\t\t\t\t\treturn execute(intent, failedPhase)\n\t\t\t\t},\n\t\t\t\ttoJSON: poisonToJSON\n\t\t\t}\n\t\t}\n\n\t\tasync function execute(\n\t\t\tintent: WireIntent<Pcis>,\n\t\t\tphase: \"observation\" | \"interaction\"\n\t\t): Promise<PrimerState<Pcis>> {\n\t\t\tconst body: WireRequestBody<Pcis> = {\n\t\t\t\tstudentId,\n\t\t\t\tsupportedPcis: config.supportedPcis,\n\t\t\t\tintent\n\t\t\t}\n\n\t\t\tconst result = await transport(body)\n\t\t\tif (!result.ok) {\n\t\t\t\treturn errored(result.error, phase, intent)\n\t\t\t}\n\n\t\t\treturn resolve(result.data)\n\t\t}\n\n\t\tfunction isPciSupported(pciId: string): boolean {\n\t\t\tfor (const id of config.supportedPcis) {\n\t\t\t\tif (id === pciId) {\n\t\t\t\t\treturn true\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn false\n\t\t}\n\n\t\tfunction fromAdvanced(\n\t\t\tstimulus: RendererStimulus | null,\n\t\t\tinteraction: RendererInteraction<Pcis> | null\n\t\t): PrimerState<Pcis> {\n\t\t\tif (interaction === null) {\n\t\t\t\treturn observationState(stimulus)\n\t\t\t}\n\t\t\tif (interaction.type === \"portable-custom\") {\n\t\t\t\tif (!isPciSupported(interaction.pciId)) {\n\t\t\t\t\tlog?.error(\"unsupported pci in frame\", { pciId: interaction.pciId })\n\t\t\t\t\treturn {\n\t\t\t\t\t\tphase: \"fatal\",\n\t\t\t\t\t\terror: errors.wrap(ErrUnsupportedPci, `pci '${interaction.pciId}'`),\n\t\t\t\t\t\ttoJSON: poisonToJSON\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn pendingInteractionState(stimulus, interaction)\n\t\t}\n\n\t\tfunction observationState(stimulus: RendererStimulus | null): PrimerState<Pcis> {\n\t\t\treturn {\n\t\t\t\tphase: \"observation\",\n\t\t\t\tstimulus,\n\t\t\t\tadvance: function advance() {\n\t\t\t\t\treturn execute({ kind: \"observation\" }, \"observation\")\n\t\t\t\t},\n\t\t\t\ttoJSON: poisonToJSON\n\t\t\t}\n\t\t}\n\n\t\tfunction pendingInteractionState(\n\t\t\tstimulus: RendererStimulus | null,\n\t\t\tinteraction: RendererInteraction<Pcis>\n\t\t): PrimerState<Pcis> {\n\t\t\tswitch (interaction.type) {\n\t\t\t\tcase \"choice\":\n\t\t\t\t\treturn choiceState(\n\t\t\t\t\t\tstimulus,\n\t\t\t\t\t\tinteraction,\n\t\t\t\t\t\tinteraction.options,\n\t\t\t\t\t\tinteraction.maxChoices,\n\t\t\t\t\t\tinteraction.minChoices\n\t\t\t\t\t)\n\t\t\t\tcase \"text-entry\":\n\t\t\t\t\treturn textEntryState(stimulus, interaction)\n\t\t\t\tcase \"extended-text\":\n\t\t\t\t\treturn extendedTextState(stimulus, interaction)\n\t\t\t\tcase \"portable-custom\":\n\t\t\t\t\treturn pciInteractionState(stimulus, interaction)\n\t\t\t}\n\t\t}\n\n\t\tfunction findUnknownKey(selectedKeys: string[], options: RendererChoice[]): string | null {\n\t\t\tconst optionIds = new Set(\n\t\t\t\toptions.map(function getId(o) {\n\t\t\t\t\treturn o.identifier\n\t\t\t\t})\n\t\t\t)\n\t\t\tfor (const key of selectedKeys) {\n\t\t\t\tif (!optionIds.has(key)) {\n\t\t\t\t\treturn key\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn null\n\t\t}\n\n\t\tfunction validateChoiceSubmission(\n\t\t\tselectedKeys: string[],\n\t\t\toptions: RendererChoice[],\n\t\t\tmaxChoices: number,\n\t\t\tminChoices: number\n\t\t): Error | null {\n\t\t\tif (selectedKeys.length < minChoices) {\n\t\t\t\tlog?.error(\"choice submit below minChoices\", { selectedKeys, minChoices })\n\t\t\t\treturn errors.wrap(ErrInvalidSubmission, `need at least ${minChoices} selections`)\n\t\t\t}\n\t\t\tif (selectedKeys.length > maxChoices) {\n\t\t\t\tlog?.error(\"choice submit above maxChoices\", { selectedKeys, maxChoices })\n\t\t\t\treturn errors.wrap(ErrInvalidSubmission, `at most ${maxChoices} selections`)\n\t\t\t}\n\t\t\tconst uniqueKeys = new Set(selectedKeys)\n\t\t\tif (uniqueKeys.size !== selectedKeys.length) {\n\t\t\t\tlog?.error(\"choice submit has duplicates\", { selectedKeys })\n\t\t\t\treturn errors.wrap(ErrInvalidSubmission, \"duplicate selections\")\n\t\t\t}\n\t\t\tconst unknownKey = findUnknownKey(selectedKeys, options)\n\t\t\tif (unknownKey) {\n\t\t\t\tlog?.error(\"choice submit has unknown key\", { key: unknownKey })\n\t\t\t\treturn errors.wrap(ErrInvalidSubmission, `unknown option '${unknownKey}'`)\n\t\t\t}\n\t\t\treturn null\n\t\t}\n\n\t\tfunction choiceState(\n\t\t\tstimulus: RendererStimulus | null,\n\t\t\tinteraction: Extract<RendererInteraction<Pcis>, { type: \"choice\" }>,\n\t\t\toptions: RendererChoice[],\n\t\t\tmaxChoices: number,\n\t\t\tminChoices: number\n\t\t): PrimerState<Pcis> {\n\t\t\treturn {\n\t\t\t\tphase: \"interaction\",\n\t\t\t\tkind: \"choice\",\n\t\t\t\tstimulus,\n\t\t\t\tinteraction,\n\t\t\t\toptions,\n\t\t\t\tmaxChoices,\n\t\t\t\tminChoices,\n\t\t\t\tsubmitChoice: function submitChoice(selectedKeys: string[]) {\n\t\t\t\t\tconst validationError = validateChoiceSubmission(\n\t\t\t\t\t\tselectedKeys,\n\t\t\t\t\t\toptions,\n\t\t\t\t\t\tmaxChoices,\n\t\t\t\t\t\tminChoices\n\t\t\t\t\t)\n\t\t\t\t\tif (validationError) {\n\t\t\t\t\t\treturn Promise.resolve(\n\t\t\t\t\t\t\terrored(validationError, \"interaction\", {\n\t\t\t\t\t\t\t\tkind: \"interaction\",\n\t\t\t\t\t\t\t\tsubmission: { type: \"choice\", selectedKeys }\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t)\n\t\t\t\t\t}\n\t\t\t\t\treturn execute(\n\t\t\t\t\t\t{ kind: \"interaction\", submission: { type: \"choice\", selectedKeys } },\n\t\t\t\t\t\t\"interaction\"\n\t\t\t\t\t)\n\t\t\t\t},\n\t\t\t\ttoJSON: poisonToJSON\n\t\t\t}\n\t\t}\n\n\t\tfunction textEntryState(\n\t\t\tstimulus: RendererStimulus | null,\n\t\t\tinteraction: Extract<RendererInteraction<Pcis>, { type: \"text-entry\" }>\n\t\t): PrimerState<Pcis> {\n\t\t\treturn {\n\t\t\t\tphase: \"interaction\",\n\t\t\t\tkind: \"text-entry\",\n\t\t\t\tstimulus,\n\t\t\t\tinteraction,\n\t\t\t\tsubmitText: function submitText(value: string) {\n\t\t\t\t\treturn execute(\n\t\t\t\t\t\t{ kind: \"interaction\", submission: { type: \"text-entry\", value } },\n\t\t\t\t\t\t\"interaction\"\n\t\t\t\t\t)\n\t\t\t\t},\n\t\t\t\ttoJSON: poisonToJSON\n\t\t\t}\n\t\t}\n\n\t\tfunction validateExtendedTextSubmission(\n\t\t\tvalues: string[],\n\t\t\tminStrings: number,\n\t\t\tmaxStrings: number\n\t\t): Error | null {\n\t\t\tif (values.length < minStrings) {\n\t\t\t\tlog?.error(\"extended-text submit below minStrings\", { count: values.length, minStrings })\n\t\t\t\treturn errors.wrap(ErrInvalidSubmission, `need at least ${minStrings} values`)\n\t\t\t}\n\t\t\tif (values.length > maxStrings) {\n\t\t\t\tlog?.error(\"extended-text submit above maxStrings\", { count: values.length, maxStrings })\n\t\t\t\treturn errors.wrap(ErrInvalidSubmission, `at most ${maxStrings} values`)\n\t\t\t}\n\t\t\treturn null\n\t\t}\n\n\t\tfunction extendedTextState(\n\t\t\tstimulus: RendererStimulus | null,\n\t\t\tinteraction: RendererInteraction<Pcis> & { type: \"extended-text\" }\n\t\t): PrimerState<Pcis> {\n\t\t\tconst maxStrings = interaction.maxStrings\n\t\t\tconst minStrings = interaction.minStrings\n\t\t\tif (maxStrings === 1) {\n\t\t\t\treturn {\n\t\t\t\t\tphase: \"interaction\",\n\t\t\t\t\tkind: \"extended-text\",\n\t\t\t\t\tcardinality: \"single\",\n\t\t\t\t\tstimulus,\n\t\t\t\t\tinteraction,\n\t\t\t\t\tsubmitText: function submitText(value: string) {\n\t\t\t\t\t\treturn execute(\n\t\t\t\t\t\t\t{ kind: \"interaction\", submission: { type: \"extended-text\", values: [value] } },\n\t\t\t\t\t\t\t\"interaction\"\n\t\t\t\t\t\t)\n\t\t\t\t\t},\n\t\t\t\t\ttoJSON: poisonToJSON\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tphase: \"interaction\",\n\t\t\t\tkind: \"extended-text\",\n\t\t\t\tcardinality: \"multiple\",\n\t\t\t\tstimulus,\n\t\t\t\tinteraction,\n\t\t\t\tmaxStrings,\n\t\t\t\tminStrings,\n\t\t\t\tsubmitTexts: function submitTexts(values: string[]) {\n\t\t\t\t\tconst validationError = validateExtendedTextSubmission(values, minStrings, maxStrings)\n\t\t\t\t\tif (validationError) {\n\t\t\t\t\t\treturn Promise.resolve(\n\t\t\t\t\t\t\terrored(validationError, \"interaction\", {\n\t\t\t\t\t\t\t\tkind: \"interaction\",\n\t\t\t\t\t\t\t\tsubmission: { type: \"extended-text\", values }\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t)\n\t\t\t\t\t}\n\t\t\t\t\treturn execute(\n\t\t\t\t\t\t{ kind: \"interaction\", submission: { type: \"extended-text\", values } },\n\t\t\t\t\t\t\"interaction\"\n\t\t\t\t\t)\n\t\t\t\t},\n\t\t\t\ttoJSON: poisonToJSON\n\t\t\t}\n\t\t}\n\n\t\t// Safe cast: TS cannot verify mapped-union construction from generic Pcis.\n\t\t// The input `interaction: PciInteraction<Pcis>` guarantees pciId↔properties\n\t\t// correlation; destructuring loses TS tracking but runtime is correct.\n\t\tfunction pciInteractionState(\n\t\t\tstimulus: RendererStimulus | null,\n\t\t\tinteraction: PciInteraction<Pcis>\n\t\t): PciInteractionState<Pcis> {\n\t\t\tconst { pciId, properties } = interaction\n\t\t\tfunction submit(value: PciValue<typeof pciId>): Promise<PrimerState<Pcis>> {\n\t\t\t\tlog?.debug(\"pci submit\", { pciId })\n\t\t\t\tconst submission = { type: \"portable-custom\" as const, pciId, value }\n\t\t\t\treturn execute({ kind: \"interaction\", submission }, \"interaction\")\n\t\t\t}\n\t\t\t// biome-ignore lint/plugin: TS cannot verify mapped-union construction from generic Pcis — pciId↔properties correlation preserved by input\n\t\t\treturn {\n\t\t\t\tphase: \"interaction\",\n\t\t\t\tkind: \"portable-custom\",\n\t\t\t\tstimulus,\n\t\t\t\tinteraction,\n\t\t\t\tpciId,\n\t\t\t\tproperties,\n\t\t\t\tsubmit,\n\t\t\t\ttoJSON: poisonToJSON\n\t\t\t} as PciInteractionState<Pcis>\n\t\t}\n\n\t\tfunction feedbackState(\n\t\t\tstimulus: RendererStimulus | null,\n\t\t\tinteraction: RendererInteraction<Pcis>,\n\t\t\tsubmission: RendererSubmission<Pcis>,\n\t\t\tisCorrect: boolean,\n\t\t\tfeedbackContent: ContentInline[],\n\t\t\tcorrectAnswer: RendererCorrectAnswer | null\n\t\t): PrimerState<Pcis> {\n\t\t\treturn {\n\t\t\t\tphase: \"feedback\",\n\t\t\t\tstimulus,\n\t\t\t\tinteraction,\n\t\t\t\tsubmission,\n\t\t\t\tisCorrect,\n\t\t\t\tfeedbackContent,\n\t\t\t\tcorrectAnswer,\n\t\t\t\tadvance: function advance() {\n\t\t\t\t\treturn execute({ kind: \"observation\" }, \"observation\")\n\t\t\t\t},\n\t\t\t\ttoJSON: poisonToJSON\n\t\t\t}\n\t\t}\n\n\t\treturn { execute }\n\t}\n\n\treturn {\n\t\tasync start(studentId: string): Promise<PrimerState<Pcis>> {\n\t\t\tlog?.debug(\"start\", { studentId })\n\t\t\tconst s = makeSession(studentId)\n\t\t\treturn s.execute({ kind: \"observation\" }, \"observation\")\n\t\t}\n\t}\n}\n\nexport { ADVANCE_PATH, DEFAULT_ORIGIN, create }\nexport type { Client, Config, PrimerLogger }\n"
+  ],
+  "mappings": "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",
+  "debugId": "B2799CD48726B75C64756E2164756E21",
+  "names": []
+}

package/dist/content.d.ts

@@ -0,0 +1,16 @@
+type ContentInline = {
+    type: "text";
+    value: string;
+} | {
+    type: "italic";
+    children: ContentInline[];
+};
+type ContentBlock = {
+    type: "paragraph";
+    children: ContentInline[];
+};
+declare function inlinesToPlainText(nodes: ContentInline[]): string;
+declare function blocksToPlainText(blocks: ContentBlock[]): string;
+export type { ContentBlock, ContentInline };
+export { blocksToPlainText, inlinesToPlainText };
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AAEpG,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AAEpE,iBAAS,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAa1D;AAED,iBAAS,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAMzD;AAED,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA;AAC3C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/content.js

@@ -0,0 +1,27 @@
+// src/content.ts
+function inlinesToPlainText(nodes) {
+  const parts = [];
+  for (const node of nodes) {
+    switch (node.type) {
+      case "text":
+        parts.push(node.value);
+        break;
+      case "italic":
+        parts.push(inlinesToPlainText(node.children));
+        break;
+    }
+  }
+  return parts.join("");
+}
+function blocksToPlainText(blocks) {
+  return blocks.map(function blockText(block) {
+    return inlinesToPlainText(block.children);
+  }).join(`
+`);
+}
+export {
+  inlinesToPlainText,
+  blocksToPlainText
+};
+
+//# debugId=B2FEC3DAAEEB30A564756E2164756E21

package/dist/content.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/content.ts"],
+  "sourcesContent": [
+    "type ContentInline = { type: \"text\"; value: string } | { type: \"italic\"; children: ContentInline[] }\n\ntype ContentBlock = { type: \"paragraph\"; children: ContentInline[] }\n\nfunction inlinesToPlainText(nodes: ContentInline[]): string {\n\tconst parts: string[] = []\n\tfor (const node of nodes) {\n\t\tswitch (node.type) {\n\t\t\tcase \"text\":\n\t\t\t\tparts.push(node.value)\n\t\t\t\tbreak\n\t\t\tcase \"italic\":\n\t\t\t\tparts.push(inlinesToPlainText(node.children))\n\t\t\t\tbreak\n\t\t}\n\t}\n\treturn parts.join(\"\")\n}\n\nfunction blocksToPlainText(blocks: ContentBlock[]): string {\n\treturn blocks\n\t\t.map(function blockText(block) {\n\t\t\treturn inlinesToPlainText(block.children)\n\t\t})\n\t\t.join(\"\\n\")\n}\n\nexport type { ContentBlock, ContentInline }\nexport { blocksToPlainText, inlinesToPlainText }\n"
+  ],
+  "mappings": ";AAIA,SAAS,kBAAkB,CAAC,OAAgC;AAAA,EAC3D,MAAM,QAAkB,CAAC;AAAA,EACzB,WAAW,QAAQ,OAAO;AAAA,IACzB,QAAQ,KAAK;AAAA,WACP;AAAA,QACJ,MAAM,KAAK,KAAK,KAAK;AAAA,QACrB;AAAA,WACI;AAAA,QACJ,MAAM,KAAK,mBAAmB,KAAK,QAAQ,CAAC;AAAA,QAC5C;AAAA;AAAA,EAEH;AAAA,EACA,OAAO,MAAM,KAAK,EAAE;AAAA;AAGrB,SAAS,iBAAiB,CAAC,QAAgC;AAAA,EAC1D,OAAO,OACL,IAAI,SAAS,SAAS,CAAC,OAAO;AAAA,IAC9B,OAAO,mBAAmB,MAAM,QAAQ;AAAA,GACxC,EACA,KAAK;AAAA,CAAI;AAAA;",
+  "debugId": "B2FEC3DAAEEB30A564756E2164756E21",
+  "names": []
+}

package/dist/errors.d.ts

@@ -0,0 +1,17 @@
+declare const ErrNetwork: Error;
+declare const ErrJsonParse: Error;
+declare const ErrUnsupportedPci: Error;
+declare const ErrInvalidPublishableKey: Error;
+declare const ErrBadRequest: Error;
+declare const ErrServerError: Error;
+declare const ErrTimeout: Error;
+declare const ErrForbidden: Error;
+declare const ErrNotFound: Error;
+declare const ErrConflict: Error;
+declare const ErrRateLimited: Error;
+declare const ErrServiceUnavailable: Error;
+declare const ErrNotSerializable: Error;
+declare const ErrInvalidSubmission: Error;
+declare const ErrMalformedPublishableKey: Error;
+export { ErrBadRequest, ErrConflict, ErrForbidden, ErrInvalidPublishableKey, ErrInvalidSubmission, ErrMalformedPublishableKey, ErrJsonParse, ErrNetwork, ErrNotFound, ErrNotSerializable, ErrRateLimited, ErrServerError, ErrServiceUnavailable, ErrTimeout, ErrUnsupportedPci };
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,UAAU,OAAwB,CAAA;AACxC,QAAA,MAAM,YAAY,OAA2B,CAAA;AAC7C,QAAA,MAAM,iBAAiB,OAAgC,CAAA;AACvD,QAAA,MAAM,wBAAwB,OAAwC,CAAA;AACtE,QAAA,MAAM,aAAa,OAA4B,CAAA;AAC/C,QAAA,MAAM,cAAc,OAA6B,CAAA;AACjD,QAAA,MAAM,UAAU,OAAwB,CAAA;AACxC,QAAA,MAAM,YAAY,OAA0B,CAAA;AAC5C,QAAA,MAAM,WAAW,OAA0B,CAAA;AAC3C,QAAA,MAAM,WAAW,OAAyB,CAAA;AAC1C,QAAA,MAAM,cAAc,OAA6B,CAAA;AACjD,QAAA,MAAM,qBAAqB,OAAoC,CAAA;AAC/D,QAAA,MAAM,kBAAkB,OAEvB,CAAA;AACD,QAAA,MAAM,oBAAoB,OAAmC,CAAA;AAC7D,QAAA,MAAM,0BAA0B,OAA0C,CAAA;AAE1E,OAAO,EACN,aAAa,EACb,WAAW,EACX,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,YAAY,EACZ,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,CAAA"}

package/dist/errors.js

@@ -0,0 +1,36 @@
+// src/errors.ts
+import * as errors from "@superbuilders/errors";
+var ErrNetwork = errors.new("network");
+var ErrJsonParse = errors.new("json parse");
+var ErrUnsupportedPci = errors.new("unsupported pci");
+var ErrInvalidPublishableKey = errors.new("invalid publishable key");
+var ErrBadRequest = errors.new("bad request");
+var ErrServerError = errors.new("server error");
+var ErrTimeout = errors.new("timeout");
+var ErrForbidden = errors.new("forbidden");
+var ErrNotFound = errors.new("not found");
+var ErrConflict = errors.new("conflict");
+var ErrRateLimited = errors.new("rate limited");
+var ErrServiceUnavailable = errors.new("service unavailable");
+var ErrNotSerializable = errors.new("PrimerState is live in-memory state and must not be serialized or stored");
+var ErrInvalidSubmission = errors.new("invalid submission");
+var ErrMalformedPublishableKey = errors.new("malformed publishable key");
+export {
+  ErrUnsupportedPci,
+  ErrTimeout,
+  ErrServiceUnavailable,
+  ErrServerError,
+  ErrRateLimited,
+  ErrNotSerializable,
+  ErrNotFound,
+  ErrNetwork,
+  ErrMalformedPublishableKey,
+  ErrJsonParse,
+  ErrInvalidSubmission,
+  ErrInvalidPublishableKey,
+  ErrForbidden,
+  ErrConflict,
+  ErrBadRequest
+};
+
+//# debugId=DC88F476D6E45CE664756E2164756E21

package/dist/errors.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts"],
+  "sourcesContent": [
+    "import * as errors from \"@superbuilders/errors\"\n\nconst ErrNetwork = errors.new(\"network\")\nconst ErrJsonParse = errors.new(\"json parse\")\nconst ErrUnsupportedPci = errors.new(\"unsupported pci\")\nconst ErrInvalidPublishableKey = errors.new(\"invalid publishable key\")\nconst ErrBadRequest = errors.new(\"bad request\")\nconst ErrServerError = errors.new(\"server error\")\nconst ErrTimeout = errors.new(\"timeout\")\nconst ErrForbidden = errors.new(\"forbidden\")\nconst ErrNotFound = errors.new(\"not found\")\nconst ErrConflict = errors.new(\"conflict\")\nconst ErrRateLimited = errors.new(\"rate limited\")\nconst ErrServiceUnavailable = errors.new(\"service unavailable\")\nconst ErrNotSerializable = errors.new(\n\t\"PrimerState is live in-memory state and must not be serialized or stored\"\n)\nconst ErrInvalidSubmission = errors.new(\"invalid submission\")\nconst ErrMalformedPublishableKey = errors.new(\"malformed publishable key\")\n\nexport {\n\tErrBadRequest,\n\tErrConflict,\n\tErrForbidden,\n\tErrInvalidPublishableKey,\n\tErrInvalidSubmission,\n\tErrMalformedPublishableKey,\n\tErrJsonParse,\n\tErrNetwork,\n\tErrNotFound,\n\tErrNotSerializable,\n\tErrRateLimited,\n\tErrServerError,\n\tErrServiceUnavailable,\n\tErrTimeout,\n\tErrUnsupportedPci\n}\n"
+  ],
+  "mappings": ";AAAA;AAEA,IAAM,aAAoB,WAAI,SAAS;AACvC,IAAM,eAAsB,WAAI,YAAY;AAC5C,IAAM,oBAA2B,WAAI,iBAAiB;AACtD,IAAM,2BAAkC,WAAI,yBAAyB;AACrE,IAAM,gBAAuB,WAAI,aAAa;AAC9C,IAAM,iBAAwB,WAAI,cAAc;AAChD,IAAM,aAAoB,WAAI,SAAS;AACvC,IAAM,eAAsB,WAAI,WAAW;AAC3C,IAAM,cAAqB,WAAI,WAAW;AAC1C,IAAM,cAAqB,WAAI,UAAU;AACzC,IAAM,iBAAwB,WAAI,cAAc;AAChD,IAAM,wBAA+B,WAAI,qBAAqB;AAC9D,IAAM,qBAA4B,WACjC,0EACD;AACA,IAAM,uBAA8B,WAAI,oBAAoB;AAC5D,IAAM,6BAAoC,WAAI,2BAA2B;",
+  "debugId": "DC88F476D6E45CE664756E2164756E21",
+  "names": []
+}

package/dist/pci.d.ts

@@ -0,0 +1,38 @@
+interface DivisionRemainderProps {
+    dividend: number;
+    divisor: number;
+}
+interface DivisionRemainderSubmission {
+    quotient: string;
+    remainder: string;
+}
+interface FractionAdditionProps {
+    left: {
+        numerator: number;
+        denominator: number;
+    };
+    right: {
+        numerator: number;
+        denominator: number;
+    };
+}
+interface FractionAdditionSubmission {
+    numerator: string;
+    denominator: string;
+}
+type PciUrn = `urn:primer:pci:${string}`;
+interface PciRegistry {
+    "urn:primer:pci:division-remainder": {
+        props: DivisionRemainderProps;
+        value: DivisionRemainderSubmission;
+    };
+    "urn:primer:pci:fraction-addition": {
+        props: FractionAdditionProps;
+        value: FractionAdditionSubmission;
+    };
+}
+type PciId = keyof PciRegistry & string;
+type PciProps<K extends PciId> = PciRegistry[K]["props"];
+type PciValue<K extends PciId> = PciRegistry[K]["value"];
+export type { DivisionRemainderProps, DivisionRemainderSubmission, FractionAdditionProps, FractionAdditionSubmission, PciId, PciProps, PciRegistry, PciUrn, PciValue };
+//# sourceMappingURL=pci.d.ts.map

package/dist/pci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pci.d.ts","sourceRoot":"","sources":["../src/pci.ts"],"names":[],"mappings":"AAAA,UAAU,sBAAsB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CACf;AAED,UAAU,2BAA2B;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,UAAU,qBAAqB;IAC9B,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;CACjD;AAED,UAAU,0BAA0B;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;CACnB;AAED,KAAK,MAAM,GAAG,kBAAkB,MAAM,EAAE,CAAA;AAExC,UAAU,WAAW;IACpB,mCAAmC,EAAE;QACpC,KAAK,EAAE,sBAAsB,CAAA;QAC7B,KAAK,EAAE,2BAA2B,CAAA;KAClC,CAAA;IACD,kCAAkC,EAAE;QACnC,KAAK,EAAE,qBAAqB,CAAA;QAC5B,KAAK,EAAE,0BAA0B,CAAA;KACjC,CAAA;CACD;AAMD,KAAK,KAAK,GAAG,MAAM,WAAW,GAAG,MAAM,CAAA;AACvC,KAAK,QAAQ,CAAC,CAAC,SAAS,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AACxD,KAAK,QAAQ,CAAC,CAAC,SAAS,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAExD,YAAY,EACX,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,EACL,QAAQ,EACR,WAAW,EACX,MAAM,EACN,QAAQ,EACR,CAAA"}

package/dist/pci.js

@@ -0,0 +1,2 @@
+
+//# debugId=A38864BFD31DF2F664756E2164756E21

package/dist/pci.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "A38864BFD31DF2F664756E2164756E21",
+  "names": []
+}

package/dist/types.d.ts

@@ -0,0 +1,188 @@
+import type { ContentBlock, ContentInline } from "./content";
+import type { PciId, PciProps, PciValue } from "./pci";
+type RendererCorrectScalarValue = {
+    kind: "identifier";
+    value: string;
+} | {
+    kind: "string";
+    value: string;
+} | {
+    kind: "integer";
+    value: number;
+} | {
+    kind: "float";
+    value: number;
+};
+type RendererCorrectAnswer = {
+    kind: "single";
+    value: RendererCorrectScalarValue | null;
+} | {
+    kind: "multiple";
+    values: RendererCorrectScalarValue[];
+} | {
+    kind: "record";
+    fields: Array<{
+        fieldIdentifier: string;
+        baseType: "identifier" | "string" | "integer" | "float";
+        value: RendererCorrectScalarValue | null;
+    }>;
+};
+interface NonSerializable {
+    toJSON(): never;
+}
+interface BodyStimulus {
+    type: "body";
+    body: ContentBlock[];
+}
+interface ImageStimulus {
+    type: "image";
+    description: ContentInline[];
+    src: string;
+}
+type RendererStimulus = BodyStimulus | ImageStimulus;
+interface RendererChoice {
+    identifier: string;
+    content: ContentInline[];
+}
+type PciInteraction<Pcis extends PciId = PciId> = {
+    [K in Pcis]: {
+        type: "portable-custom";
+        prompt: ContentInline[];
+        pciId: K;
+        properties: PciProps<K>;
+    };
+}[Pcis];
+type RendererInteraction<Pcis extends PciId = PciId> = {
+    type: "choice";
+    prompt: ContentInline[];
+    options: RendererChoice[];
+    shuffle: boolean;
+    maxChoices: number;
+    minChoices: number;
+} | {
+    type: "text-entry";
+    prompt: ContentInline[];
+    base: 10;
+    expectedLength?: number;
+    patternMask?: string;
+    placeholderText?: string;
+} | {
+    type: "extended-text";
+    prompt: ContentInline[];
+    format: "plain";
+    expectedLines?: number;
+    expectedLength?: number;
+    patternMask?: string;
+    placeholderText?: string;
+    maxStrings: number;
+    minStrings: number;
+} | PciInteraction<Pcis>;
+type PciSubmission<Pcis extends PciId = PciId> = {
+    [K in Pcis]: {
+        type: "portable-custom";
+        pciId: K;
+        value: PciValue<K>;
+    };
+}[Pcis];
+type RendererSubmission<Pcis extends PciId = PciId> = {
+    type: "choice";
+    selectedKeys: string[];
+} | {
+    type: "text-entry";
+    value: string;
+} | {
+    type: "extended-text";
+    values: string[];
+} | PciSubmission<Pcis>;
+interface ObservationState<Pcis extends PciId = PciId> extends NonSerializable {
+    readonly phase: "observation";
+    readonly stimulus: RendererStimulus | null;
+    advance(): Promise<PrimerState<Pcis>>;
+}
+interface ChoiceState<Pcis extends PciId = PciId> extends NonSerializable {
+    readonly phase: "interaction";
+    readonly kind: "choice";
+    readonly stimulus: RendererStimulus | null;
+    readonly interaction: Extract<RendererInteraction<Pcis>, {
+        type: "choice";
+    }>;
+    readonly options: RendererChoice[];
+    readonly maxChoices: number;
+    readonly minChoices: number;
+    submitChoice(selectedKeys: string[]): Promise<PrimerState<Pcis>>;
+}
+interface TextEntryState<Pcis extends PciId = PciId> extends NonSerializable {
+    readonly phase: "interaction";
+    readonly kind: "text-entry";
+    readonly stimulus: RendererStimulus | null;
+    readonly interaction: Extract<RendererInteraction<Pcis>, {
+        type: "text-entry";
+    }>;
+    submitText(value: string): Promise<PrimerState<Pcis>>;
+}
+interface ExtendedTextSingleState<Pcis extends PciId = PciId> extends NonSerializable {
+    readonly phase: "interaction";
+    readonly kind: "extended-text";
+    readonly cardinality: "single";
+    readonly stimulus: RendererStimulus | null;
+    readonly interaction: Extract<RendererInteraction<Pcis>, {
+        type: "extended-text";
+    }>;
+    submitText(value: string): Promise<PrimerState<Pcis>>;
+}
+interface ExtendedTextMultipleState<Pcis extends PciId = PciId> extends NonSerializable {
+    readonly phase: "interaction";
+    readonly kind: "extended-text";
+    readonly cardinality: "multiple";
+    readonly stimulus: RendererStimulus | null;
+    readonly interaction: Extract<RendererInteraction<Pcis>, {
+        type: "extended-text";
+    }>;
+    readonly maxStrings: number;
+    readonly minStrings: number;
+    submitTexts(values: string[]): Promise<PrimerState<Pcis>>;
+}
+type ExtendedTextState<Pcis extends PciId = PciId> = ExtendedTextSingleState<Pcis> | ExtendedTextMultipleState<Pcis>;
+type PciInteractionState<Pcis extends PciId = PciId> = {
+    [K in Pcis]: NonSerializable & {
+        readonly phase: "interaction";
+        readonly kind: "portable-custom";
+        readonly stimulus: RendererStimulus | null;
+        readonly interaction: PciInteraction<K>;
+        readonly pciId: K;
+        readonly properties: PciProps<K>;
+        submit(value: PciValue<K>): Promise<PrimerState<Pcis>>;
+    };
+}[Pcis];
+type InteractionState<Pcis extends PciId = PciId> = ChoiceState<Pcis> | TextEntryState<Pcis> | ExtendedTextState<Pcis> | PciInteractionState<Pcis>;
+interface FeedbackState<Pcis extends PciId = PciId> extends NonSerializable {
+    readonly phase: "feedback";
+    readonly stimulus: RendererStimulus | null;
+    readonly interaction: RendererInteraction<Pcis>;
+    readonly submission: RendererSubmission<Pcis>;
+    readonly isCorrect: boolean;
+    readonly feedbackContent: ContentInline[];
+    readonly correctAnswer: RendererCorrectAnswer | null;
+    advance(): Promise<PrimerState<Pcis>>;
+}
+interface CompletedState extends NonSerializable {
+    readonly phase: "completed";
+}
+interface ErroredState<Pcis extends PciId = PciId> extends NonSerializable {
+    readonly phase: "errored";
+    readonly error: Error;
+    readonly failedPhase: "observation" | "interaction";
+    retry(): Promise<PrimerState<Pcis>>;
+}
+interface FatalState extends NonSerializable {
+    readonly phase: "fatal";
+    readonly error: Error;
+}
+type PrimerState<Pcis extends PciId = PciId> = ObservationState<Pcis> | InteractionState<Pcis> | FeedbackState<Pcis> | CompletedState | ErroredState<Pcis> | FatalState;
+interface PciRenderProps<K extends PciId> {
+    properties: PciProps<K>;
+    submitted: boolean;
+    onValueChange: (value: PciValue<K> | null) => void;
+}
+export type { BodyStimulus, ChoiceState, CompletedState, ErroredState, ExtendedTextMultipleState, ExtendedTextSingleState, ExtendedTextState, FatalState, FeedbackState, ImageStimulus, InteractionState, NonSerializable, ObservationState, PciInteraction, PciInteractionState, PciRenderProps, PciSubmission, PrimerState, RendererChoice, RendererCorrectAnswer, RendererCorrectScalarValue, RendererInteraction, RendererStimulus, RendererSubmission, TextEntryState };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+
+//# debugId=9FCB033A2878230664756E2164756E21

package/dist/types.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "9FCB033A2878230664756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+	"name": "@superbuilders/primer-tives",
+	"version": "0.0.1",
+	"type": "module",
+	"exports": {
+		"./client": {
+			"types": "./dist/client.d.ts",
+			"import": "./dist/client.js"
+		},
+		"./types": {
+			"types": "./dist/types.d.ts",
+			"import": "./dist/types.js"
+		},
+		"./content": {
+			"types": "./dist/content.d.ts",
+			"import": "./dist/content.js"
+		},
+		"./errors": {
+			"types": "./dist/errors.d.ts",
+			"import": "./dist/errors.js"
+		},
+		"./pci": {
+			"types": "./dist/pci.d.ts",
+			"import": "./dist/pci.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"dependencies": {
+		"@superbuilders/errors": "^3.0.2"
+	},
+	"scripts": {
+		"build": "bun run build.ts",
+		"typecheck": "bun --bun tsc --noEmit"
+	},
+	"devDependencies": {
+		"resolve-tspaths": "^0.8.23"
+	}
+}