@superbuilders/primer-tives 0.6.0 → 0.8.0

package/dist/errors.d.ts.map

@@ -1 +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,qBAAqB,OAAqC,CAAA;AAChE,QAAA,MAAM,uBAAuB,OAAuC,CAAA;AACpE,QAAA,MAAM,eAAe,OAAqC,CAAA;AAC1D,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;AAE7D,OAAO,EACN,aAAa,EACb,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,CAAA"}
+{"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,qBAAqB,OAAqC,CAAA;AAChE,QAAA,MAAM,uBAAuB,OAAuC,CAAA;AACpE,QAAA,MAAM,eAAe,OAAqC,CAAA;AAC1D,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;AAE7D,QAAA,MAAM,mBAAmB,OAAmC,CAAA;AAC5D,QAAA,MAAM,kBAAkB,OAAkC,CAAA;AAC1D,QAAA,MAAM,mBAAmB,OAAkC,CAAA;AAC3D,QAAA,MAAM,sBAAsB,OAAqC,CAAA;AAEjE,OAAO,EACN,aAAa,EACb,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,CAAA"}

package/dist/grade-level.d.ts

@@ -0,0 +1,5 @@
+declare const GRADE_LEVELS: readonly ["K", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"];
+type GradeLevel = (typeof GRADE_LEVELS)[number];
+export { GRADE_LEVELS };
+export type { GradeLevel };
+//# sourceMappingURL=grade-level.d.ts.map

package/dist/grade-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-level.d.ts","sourceRoot":"","sources":["../src/grade-level.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,YAAY,+EAAgF,CAAA;AAElG,KAAK,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,OAAO,EAAE,YAAY,EAAE,CAAA;AACvB,YAAY,EAAE,UAAU,EAAE,CAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,8 @@
+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;
+}
+export type { PrimerLogger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,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;AAED,YAAY,EAAE,YAAY,EAAE,CAAA"}

package/dist/server/create-server.d.ts

@@ -0,0 +1,42 @@
+import type { GradeLevel } from "../grade-level";
+import type { PrimerLogger } from "../logger";
+import { type SessionToken } from "./exchange";
+interface PrimerServerConfig {
+    readonly origin: string;
+    readonly secretKey: string;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly abort?: AbortController;
+    readonly logger?: PrimerLogger;
+}
+interface PrimerServer {
+    /**
+     * Native only: provision a new Primer-owned student. Returns a stable
+     * studentId string you persist in your own DB keyed by your user. Pair
+     * this value with `exchangeNativeStudentForAccessToken` on every
+     * session start. Timeback integrations do NOT call this — they
+     * provision automatically on exchange.
+     */
+    createNativeStudent(gradeLevel: GradeLevel): Promise<string>;
+    /**
+     * Native only: update an existing Primer student's grade level. For
+     * Timeback, grade changes flow from the SIS — do not call this.
+     */
+    updateNativeStudentGradeLevel(studentId: string, gradeLevel: GradeLevel): Promise<void>;
+    /**
+     * Native only: exchange a Primer-minted studentId for a short-lived
+     * access token. Pass `accessToken` from the returned `SessionToken` to
+     * `create()` on the browser SDK.
+     */
+    exchangeNativeStudentForAccessToken(studentId: string): Promise<SessionToken>;
+    /**
+     * Timeback only: exchange a OneRoster sourcedId for a short-lived
+     * access token. The underlying Primer student is auto-provisioned on
+     * first exchange. Pass `accessToken` from the returned `SessionToken`
+     * to `create()` on the browser SDK.
+     */
+    exchangeTimebackStudentForAccessToken(sourcedId: string): Promise<SessionToken>;
+}
+declare function createPrimerServer(config: PrimerServerConfig): PrimerServer;
+export type { PrimerServer, PrimerServerConfig };
+export { createPrimerServer };
+//# sourceMappingURL=create-server.d.ts.map

package/dist/server/create-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AACtE,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,6CAA6C,CAAA;AAG9F,UAAU,kBAAkB;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,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,YAAY;IACrB;;;;;;OAMG;IACH,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE5D;;;OAGG;IACH,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEvF;;;;OAIG;IACH,mCAAmC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAE7E;;;;;OAKG;IACH,qCAAqC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CAC/E;AAED,iBAAS,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAepE;AAED,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/server/exchange.d.ts

@@ -0,0 +1,17 @@
+import type { PrimerLogger } from "../logger";
+type Provider = "native" | "timeback";
+interface ExchangeConfig {
+    readonly origin: string;
+    readonly secretKey: string;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly abort?: AbortController;
+    readonly logger?: PrimerLogger;
+}
+interface SessionToken {
+    readonly accessToken: string;
+    readonly expiresInSeconds: number;
+}
+declare function exchangeToken(config: ExchangeConfig, provider: Provider, studentId: string): Promise<SessionToken>;
+export type { ExchangeConfig, SessionToken };
+export { exchangeToken };
+//# sourceMappingURL=exchange.d.ts.map

package/dist/server/exchange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange.d.ts","sourceRoot":"","sources":["../../src/server/exchange.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAItE,KAAK,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAA;AAErC,UAAU,cAAc;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,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,YAAY;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CACjC;AAgED,iBAAe,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAoEvB;AAED,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,CAAA"}

package/dist/server/index.d.ts

@@ -0,0 +1,8 @@
+export { createPrimerServer } from "./create-server";
+export type { PrimerServer, PrimerServerConfig } from "./create-server";
+export type { SessionToken } from "./exchange";
+export type { PrimerLogger } from "../logger";
+export type { GradeLevel } from "../grade-level";
+export { GRADE_LEVELS } from "../grade-level";
+export { ErrBadRequest, ErrInvalidSecretKey, ErrJsonParse, ErrNetwork, ErrServerError, ErrStudentNotFound, ErrTimebackUnavailable, ErrTimeout, ErrUnsupportedGrade } from "../errors";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAA;AACrF,YAAY,EACX,YAAY,EACZ,kBAAkB,EAClB,MAAM,kDAAkD,CAAA;AAEzD,YAAY,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAA;AAE/E,YAAY,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AACtE,YAAY,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAA;AAEtE,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,MAAM,oCAAoC,CAAA"}

package/dist/server/index.js

@@ -0,0 +1,259 @@
+// src/server/exchange.ts
+import * as errors2 from "@superbuilders/errors";
+
+// 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 ErrInvalidAccessToken = errors.new("invalid access token");
+var ErrMalformedAccessToken = errors.new("malformed access token");
+var ErrTokenExpired = errors.new("access token expired");
+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 ErrInvalidSecretKey = errors.new("invalid secret key");
+var ErrStudentNotFound = errors.new("student not found");
+var ErrUnsupportedGrade = errors.new("unsupported grade");
+var ErrTimebackUnavailable = errors.new("timeback unavailable");
+
+// src/server/exchange.ts
+var EXCHANGE_PATH = "/api/v0/auth/exchange";
+function isAbortError(err) {
+  if (err instanceof DOMException && err.name === "AbortError") {
+    return true;
+  }
+  if (err instanceof DOMException && err.name === "TimeoutError") {
+    return true;
+  }
+  return false;
+}
+function mapBadRequest(body) {
+  if (body.error === "unsupported_grade") {
+    return ErrUnsupportedGrade;
+  }
+  return ErrBadRequest;
+}
+function httpSentinel(status, body) {
+  if (status === 400) {
+    return mapBadRequest(body);
+  }
+  if (status === 401) {
+    return ErrInvalidSecretKey;
+  }
+  if (status === 404) {
+    return ErrStudentNotFound;
+  }
+  if (status === 502) {
+    return ErrTimebackUnavailable;
+  }
+  if (status >= 500 && status < 600) {
+    return ErrServerError;
+  }
+  return ErrServerError;
+}
+async function readErrorBody(res) {
+  const parsed = await res.json().then(function ok(data) {
+    return { ok: true, data };
+  }, function fail() {
+    return { ok: false };
+  });
+  if (!parsed.ok) {
+    return {};
+  }
+  return parsed.data;
+}
+async function exchangeToken(config, provider, studentId) {
+  const log = config.logger;
+  const fetchFn = config.fetch ? config.fetch : globalThis.fetch;
+  const signal = config.abort ? config.abort.signal : undefined;
+  log?.debug("exchange request", { provider });
+  const url = `${config.origin}${EXCHANGE_PATH}`;
+  const fetchResult = await fetchFn(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${config.secretKey}`
+    },
+    body: JSON.stringify({ provider, student_id: studentId }),
+    signal
+  }).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("exchange timeout", { provider });
+      throw errors2.wrap(ErrTimeout, fetchResult.error.message);
+    }
+    log?.error("exchange network error", { provider, error: fetchResult.error });
+    throw errors2.wrap(ErrNetwork, fetchResult.error.message);
+  }
+  const res = fetchResult.response;
+  if (!res.ok) {
+    const body = await readErrorBody(res);
+    const sentinel = httpSentinel(res.status, body);
+    const detail = body.error ? `${res.status} ${body.error}` : `${res.status}`;
+    log?.error("exchange http error", { provider, status: res.status, body });
+    throw errors2.wrap(sentinel, detail);
+  }
+  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("exchange json parse failed", { provider, error: jsonResult.error });
+    throw errors2.wrap(ErrJsonParse, jsonResult.error.message);
+  }
+  log?.debug("exchange success", { provider, expiresIn: jsonResult.data.expires_in });
+  return {
+    accessToken: jsonResult.data.access_token,
+    expiresInSeconds: jsonResult.data.expires_in
+  };
+}
+
+// src/server/students.ts
+import * as errors3 from "@superbuilders/errors";
+var STUDENTS_PATH = "/api/v0/students";
+function isAbortError2(err) {
+  if (err instanceof DOMException && err.name === "AbortError") {
+    return true;
+  }
+  if (err instanceof DOMException && err.name === "TimeoutError") {
+    return true;
+  }
+  return false;
+}
+function httpSentinel2(status) {
+  if (status === 400) {
+    return ErrBadRequest;
+  }
+  if (status === 401) {
+    return ErrInvalidSecretKey;
+  }
+  if (status === 404) {
+    return ErrStudentNotFound;
+  }
+  return ErrServerError;
+}
+async function readErrorBody2(res) {
+  const parsed = await res.json().then(function ok(data) {
+    return { ok: true, data };
+  }, function fail() {
+    return { ok: false };
+  });
+  if (!parsed.ok) {
+    return {};
+  }
+  return parsed.data;
+}
+async function sendStudentsRequest(config, path, method, body) {
+  const log = config.logger;
+  const fetchFn = config.fetch ? config.fetch : globalThis.fetch;
+  const signal = config.abort ? config.abort.signal : undefined;
+  const url = `${config.origin}${path}`;
+  const fetchResult = await fetchFn(url, {
+    method,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${config.secretKey}`
+    },
+    body: JSON.stringify(body),
+    signal
+  }).then(function ok(r) {
+    return { ok: true, response: r };
+  }, function fail(err) {
+    return { ok: false, error: err };
+  });
+  if (!fetchResult.ok) {
+    if (isAbortError2(fetchResult.error)) {
+      log?.error("students timeout", { path, method });
+      throw errors3.wrap(ErrTimeout, fetchResult.error.message);
+    }
+    log?.error("students network error", { path, method, error: fetchResult.error });
+    throw errors3.wrap(ErrNetwork, fetchResult.error.message);
+  }
+  return fetchResult.response;
+}
+async function createStudent(config, gradeLevel) {
+  const log = config.logger;
+  log?.debug("create student request", { gradeLevel });
+  const res = await sendStudentsRequest(config, STUDENTS_PATH, "POST", {
+    grade_level: gradeLevel
+  });
+  if (!res.ok) {
+    const body = await readErrorBody2(res);
+    const sentinel = httpSentinel2(res.status);
+    const detail = body.error ? `${res.status} ${body.error}` : `${res.status}`;
+    log?.error("create student http error", { status: res.status, body });
+    throw errors3.wrap(sentinel, detail);
+  }
+  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("create student json parse failed", { error: jsonResult.error });
+    throw errors3.wrap(ErrJsonParse, jsonResult.error.message);
+  }
+  log?.debug("create student success", { studentId: jsonResult.data.student_id });
+  return jsonResult.data.student_id;
+}
+async function updateStudentGradeLevel(config, studentId, gradeLevel) {
+  const log = config.logger;
+  log?.debug("update student grade request", { studentId, gradeLevel });
+  const res = await sendStudentsRequest(config, `${STUDENTS_PATH}/${encodeURIComponent(studentId)}`, "PATCH", { gradeLevel });
+  if (!res.ok) {
+    const body = await readErrorBody2(res);
+    const sentinel = httpSentinel2(res.status);
+    const detail = body.error ? `${res.status} ${body.error}` : `${res.status}`;
+    log?.error("update student http error", { status: res.status, body });
+    throw errors3.wrap(sentinel, detail);
+  }
+  log?.debug("update student success", { studentId });
+}
+
+// src/server/create-server.ts
+function createPrimerServer(config) {
+  return {
+    createNativeStudent(gradeLevel) {
+      return createStudent(config, gradeLevel);
+    },
+    updateNativeStudentGradeLevel(studentId, gradeLevel) {
+      return updateStudentGradeLevel(config, studentId, gradeLevel);
+    },
+    exchangeNativeStudentForAccessToken(studentId) {
+      return exchangeToken(config, "native", studentId);
+    },
+    exchangeTimebackStudentForAccessToken(sourcedId) {
+      return exchangeToken(config, "timeback", sourcedId);
+    }
+  };
+}
+// src/grade-level.ts
+var GRADE_LEVELS = ["K", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"];
+export {
+  createPrimerServer,
+  GRADE_LEVELS,
+  ErrUnsupportedGrade,
+  ErrTimeout,
+  ErrTimebackUnavailable,
+  ErrStudentNotFound,
+  ErrServerError,
+  ErrNetwork,
+  ErrJsonParse,
+  ErrInvalidSecretKey,
+  ErrBadRequest
+};
+
+//# debugId=3128BCEC46D85F5764756E2164756E21

package/dist/server/index.js.map

@@ -0,0 +1,14 @@
+{
+  "version": 3,
+  "sources": ["../src/server/exchange.ts", "../src/errors.ts", "../src/server/students.ts", "../src/server/create-server.ts", "../src/grade-level.ts"],
+  "sourcesContent": [
+    "import * as errors from \"@superbuilders/errors\"\nimport {\n\tErrBadRequest,\n\tErrInvalidSecretKey,\n\tErrJsonParse,\n\tErrNetwork,\n\tErrServerError,\n\tErrStudentNotFound,\n\tErrTimebackUnavailable,\n\tErrTimeout,\n\tErrUnsupportedGrade\n} from \"@superbuilders/primer-tives/errors\"\nimport type { PrimerLogger } from \"@superbuilders/primer-tives/logger\"\n\nconst EXCHANGE_PATH = \"/api/v0/auth/exchange\"\n\ntype Provider = \"native\" | \"timeback\"\n\ninterface ExchangeConfig {\n\treadonly origin: string\n\treadonly secretKey: string\n\treadonly fetch?: typeof globalThis.fetch\n\treadonly abort?: AbortController\n\treadonly logger?: PrimerLogger\n}\n\ninterface SessionToken {\n\treadonly accessToken: string\n\treadonly expiresInSeconds: number\n}\n\ninterface ExchangeSuccessBody {\n\taccess_token: string\n\ttoken_type: \"Bearer\"\n\texpires_in: number\n\tscope: string\n}\n\ninterface ExchangeErrorBody {\n\terror?: string\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\nfunction mapBadRequest(body: ExchangeErrorBody): Error {\n\tif (body.error === \"unsupported_grade\") {\n\t\treturn ErrUnsupportedGrade\n\t}\n\treturn ErrBadRequest\n}\n\nfunction httpSentinel(status: number, body: ExchangeErrorBody): Error {\n\tif (status === 400) {\n\t\treturn mapBadRequest(body)\n\t}\n\tif (status === 401) {\n\t\treturn ErrInvalidSecretKey\n\t}\n\tif (status === 404) {\n\t\treturn ErrStudentNotFound\n\t}\n\tif (status === 502) {\n\t\treturn ErrTimebackUnavailable\n\t}\n\tif (status >= 500 && status < 600) {\n\t\treturn ErrServerError\n\t}\n\treturn ErrServerError\n}\n\nasync function readErrorBody(res: Response): Promise<ExchangeErrorBody> {\n\tconst parsed = await res.json().then(\n\t\tfunction ok(data: ExchangeErrorBody) {\n\t\t\treturn { ok: true, data } as const\n\t\t},\n\t\tfunction fail() {\n\t\t\treturn { ok: false } as const\n\t\t}\n\t)\n\tif (!parsed.ok) {\n\t\treturn {}\n\t}\n\treturn parsed.data\n}\n\nasync function exchangeToken(\n\tconfig: ExchangeConfig,\n\tprovider: Provider,\n\tstudentId: string\n): Promise<SessionToken> {\n\tconst log = config.logger\n\tconst fetchFn = config.fetch ? config.fetch : globalThis.fetch\n\tconst signal = config.abort ? config.abort.signal : undefined\n\n\tlog?.debug(\"exchange request\", { provider })\n\n\tconst url = `${config.origin}${EXCHANGE_PATH}`\n\tconst fetchResult = await fetchFn(url, {\n\t\tmethod: \"POST\",\n\t\theaders: {\n\t\t\t\"Content-Type\": \"application/json\",\n\t\t\tAuthorization: `Bearer ${config.secretKey}`\n\t\t},\n\t\tbody: JSON.stringify({ provider, student_id: studentId }),\n\t\tsignal\n\t}).then(\n\t\tfunction ok(r: Response) {\n\t\t\treturn { ok: true, response: r } as const\n\t\t},\n\t\tfunction fail(err: Error) {\n\t\t\treturn { ok: false, error: err } as const\n\t\t}\n\t)\n\n\tif (!fetchResult.ok) {\n\t\tif (isAbortError(fetchResult.error)) {\n\t\t\tlog?.error(\"exchange timeout\", { provider })\n\t\t\t// biome-ignore lint/plugin: server SDK — log is optional config.logger, not slog\n\t\t\tthrow errors.wrap(ErrTimeout, fetchResult.error.message)\n\t\t}\n\t\tlog?.error(\"exchange network error\", { provider, error: fetchResult.error })\n\t\t// biome-ignore lint/plugin: server SDK — log is optional config.logger, not slog\n\t\tthrow errors.wrap(ErrNetwork, fetchResult.error.message)\n\t}\n\n\tconst res = fetchResult.response\n\n\tif (!res.ok) {\n\t\tconst body = await readErrorBody(res)\n\t\tconst sentinel = httpSentinel(res.status, body)\n\t\tconst detail = body.error ? `${res.status} ${body.error}` : `${res.status}`\n\t\tlog?.error(\"exchange http error\", { provider, status: res.status, body })\n\t\t// biome-ignore lint/plugin: server SDK — log is optional config.logger, not slog\n\t\tthrow errors.wrap(sentinel, detail)\n\t}\n\n\tconst jsonResult = await res.json().then(\n\t\tfunction ok(data: ExchangeSuccessBody) {\n\t\t\treturn { ok: true, data } as const\n\t\t},\n\t\tfunction fail(err: Error) {\n\t\t\treturn { ok: false, error: err } as const\n\t\t}\n\t)\n\n\tif (!jsonResult.ok) {\n\t\tlog?.error(\"exchange json parse failed\", { provider, error: jsonResult.error })\n\t\t// biome-ignore lint/plugin: server SDK — log is optional config.logger, not slog\n\t\tthrow errors.wrap(ErrJsonParse, jsonResult.error.message)\n\t}\n\n\tlog?.debug(\"exchange success\", { provider, expiresIn: jsonResult.data.expires_in })\n\n\treturn {\n\t\taccessToken: jsonResult.data.access_token,\n\t\texpiresInSeconds: jsonResult.data.expires_in\n\t}\n}\n\nexport type { ExchangeConfig, SessionToken }\nexport { exchangeToken }\n",
+    "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 ErrInvalidAccessToken = errors.new(\"invalid access token\")\nconst ErrMalformedAccessToken = errors.new(\"malformed access token\")\nconst ErrTokenExpired = errors.new(\"access token expired\")\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\")\n\nconst ErrInvalidSecretKey = errors.new(\"invalid secret key\")\nconst ErrStudentNotFound = errors.new(\"student not found\")\nconst ErrUnsupportedGrade = errors.new(\"unsupported grade\")\nconst ErrTimebackUnavailable = errors.new(\"timeback unavailable\")\n\nexport {\n\tErrBadRequest,\n\tErrConflict,\n\tErrForbidden,\n\tErrInvalidAccessToken,\n\tErrInvalidSecretKey,\n\tErrInvalidSubmission,\n\tErrJsonParse,\n\tErrMalformedAccessToken,\n\tErrNetwork,\n\tErrNotFound,\n\tErrNotSerializable,\n\tErrRateLimited,\n\tErrServerError,\n\tErrServiceUnavailable,\n\tErrStudentNotFound,\n\tErrTimebackUnavailable,\n\tErrTimeout,\n\tErrTokenExpired,\n\tErrUnsupportedGrade,\n\tErrUnsupportedPci\n}\n",
+    "import * as errors from \"@superbuilders/errors\"\nimport {\n\tErrBadRequest,\n\tErrInvalidSecretKey,\n\tErrJsonParse,\n\tErrNetwork,\n\tErrServerError,\n\tErrStudentNotFound,\n\tErrTimeout\n} from \"@superbuilders/primer-tives/errors\"\nimport type { GradeLevel } from \"@superbuilders/primer-tives/grade-level\"\nimport type { PrimerLogger } from \"@superbuilders/primer-tives/logger\"\n\nconst STUDENTS_PATH = \"/api/v0/students\"\n\ninterface StudentsConfig {\n\treadonly origin: string\n\treadonly secretKey: string\n\treadonly fetch?: typeof globalThis.fetch\n\treadonly abort?: AbortController\n\treadonly logger?: PrimerLogger\n}\n\ninterface CreateStudentSuccessBody {\n\tstudent_id: string\n}\n\ninterface StudentsErrorBody {\n\terror?: string\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\nfunction httpSentinel(status: number): Error {\n\tif (status === 400) {\n\t\treturn ErrBadRequest\n\t}\n\tif (status === 401) {\n\t\treturn ErrInvalidSecretKey\n\t}\n\tif (status === 404) {\n\t\treturn ErrStudentNotFound\n\t}\n\treturn ErrServerError\n}\n\nasync function readErrorBody(res: Response): Promise<StudentsErrorBody> {\n\tconst parsed = await res.json().then(\n\t\tfunction ok(data: StudentsErrorBody) {\n\t\t\treturn { ok: true, data } as const\n\t\t},\n\t\tfunction fail() {\n\t\t\treturn { ok: false } as const\n\t\t}\n\t)\n\tif (!parsed.ok) {\n\t\treturn {}\n\t}\n\treturn parsed.data\n}\n\nasync function sendStudentsRequest(\n\tconfig: StudentsConfig,\n\tpath: string,\n\tmethod: \"POST\" | \"PATCH\",\n\tbody: Record<string, unknown>\n): Promise<Response> {\n\tconst log = config.logger\n\tconst fetchFn = config.fetch ? config.fetch : globalThis.fetch\n\tconst signal = config.abort ? config.abort.signal : undefined\n\n\tconst url = `${config.origin}${path}`\n\tconst fetchResult = await fetchFn(url, {\n\t\tmethod,\n\t\theaders: {\n\t\t\t\"Content-Type\": \"application/json\",\n\t\t\tAuthorization: `Bearer ${config.secretKey}`\n\t\t},\n\t\tbody: JSON.stringify(body),\n\t\tsignal\n\t}).then(\n\t\tfunction ok(r: Response) {\n\t\t\treturn { ok: true, response: r } as const\n\t\t},\n\t\tfunction fail(err: Error) {\n\t\t\treturn { ok: false, error: err } as const\n\t\t}\n\t)\n\n\tif (!fetchResult.ok) {\n\t\tif (isAbortError(fetchResult.error)) {\n\t\t\tlog?.error(\"students timeout\", { path, method })\n\t\t\t// biome-ignore lint/plugin: server SDK — log is optional config.logger, not slog\n\t\t\tthrow errors.wrap(ErrTimeout, fetchResult.error.message)\n\t\t}\n\t\tlog?.error(\"students network error\", { path, method, error: fetchResult.error })\n\t\t// biome-ignore lint/plugin: server SDK — log is optional config.logger, not slog\n\t\tthrow errors.wrap(ErrNetwork, fetchResult.error.message)\n\t}\n\n\treturn fetchResult.response\n}\n\nasync function createStudent(config: StudentsConfig, gradeLevel: GradeLevel): Promise<string> {\n\tconst log = config.logger\n\tlog?.debug(\"create student request\", { gradeLevel })\n\n\tconst res = await sendStudentsRequest(config, STUDENTS_PATH, \"POST\", {\n\t\tgrade_level: gradeLevel\n\t})\n\n\tif (!res.ok) {\n\t\tconst body = await readErrorBody(res)\n\t\tconst sentinel = httpSentinel(res.status)\n\t\tconst detail = body.error ? `${res.status} ${body.error}` : `${res.status}`\n\t\tlog?.error(\"create student http error\", { status: res.status, body })\n\t\t// biome-ignore lint/plugin: server SDK — log is optional config.logger, not slog\n\t\tthrow errors.wrap(sentinel, detail)\n\t}\n\n\tconst jsonResult = await res.json().then(\n\t\tfunction ok(data: CreateStudentSuccessBody) {\n\t\t\treturn { ok: true, data } as const\n\t\t},\n\t\tfunction fail(err: Error) {\n\t\t\treturn { ok: false, error: err } as const\n\t\t}\n\t)\n\n\tif (!jsonResult.ok) {\n\t\tlog?.error(\"create student json parse failed\", { error: jsonResult.error })\n\t\t// biome-ignore lint/plugin: server SDK — log is optional config.logger, not slog\n\t\tthrow errors.wrap(ErrJsonParse, jsonResult.error.message)\n\t}\n\n\tlog?.debug(\"create student success\", { studentId: jsonResult.data.student_id })\n\treturn jsonResult.data.student_id\n}\n\nasync function updateStudentGradeLevel(\n\tconfig: StudentsConfig,\n\tstudentId: string,\n\tgradeLevel: GradeLevel\n): Promise<void> {\n\tconst log = config.logger\n\tlog?.debug(\"update student grade request\", { studentId, gradeLevel })\n\n\tconst res = await sendStudentsRequest(\n\t\tconfig,\n\t\t`${STUDENTS_PATH}/${encodeURIComponent(studentId)}`,\n\t\t\"PATCH\",\n\t\t{ gradeLevel }\n\t)\n\n\tif (!res.ok) {\n\t\tconst body = await readErrorBody(res)\n\t\tconst sentinel = httpSentinel(res.status)\n\t\tconst detail = body.error ? `${res.status} ${body.error}` : `${res.status}`\n\t\tlog?.error(\"update student http error\", { status: res.status, body })\n\t\t// biome-ignore lint/plugin: server SDK — log is optional config.logger, not slog\n\t\tthrow errors.wrap(sentinel, detail)\n\t}\n\n\tlog?.debug(\"update student success\", { studentId })\n}\n\nexport type { StudentsConfig }\nexport { createStudent, updateStudentGradeLevel }\n",
+    "import type { GradeLevel } from \"@superbuilders/primer-tives/grade-level\"\nimport type { PrimerLogger } from \"@superbuilders/primer-tives/logger\"\nimport { type SessionToken, exchangeToken } from \"@superbuilders/primer-tives/server/exchange\"\nimport { createStudent, updateStudentGradeLevel } from \"@superbuilders/primer-tives/server/students\"\n\ninterface PrimerServerConfig {\n\treadonly origin: string\n\treadonly secretKey: string\n\treadonly fetch?: typeof globalThis.fetch\n\treadonly abort?: AbortController\n\treadonly logger?: PrimerLogger\n}\n\ninterface PrimerServer {\n\t/**\n\t * Native only: provision a new Primer-owned student. Returns a stable\n\t * studentId string you persist in your own DB keyed by your user. Pair\n\t * this value with `exchangeNativeStudentForAccessToken` on every\n\t * session start. Timeback integrations do NOT call this — they\n\t * provision automatically on exchange.\n\t */\n\tcreateNativeStudent(gradeLevel: GradeLevel): Promise<string>\n\n\t/**\n\t * Native only: update an existing Primer student's grade level. For\n\t * Timeback, grade changes flow from the SIS — do not call this.\n\t */\n\tupdateNativeStudentGradeLevel(studentId: string, gradeLevel: GradeLevel): Promise<void>\n\n\t/**\n\t * Native only: exchange a Primer-minted studentId for a short-lived\n\t * access token. Pass `accessToken` from the returned `SessionToken` to\n\t * `create()` on the browser SDK.\n\t */\n\texchangeNativeStudentForAccessToken(studentId: string): Promise<SessionToken>\n\n\t/**\n\t * Timeback only: exchange a OneRoster sourcedId for a short-lived\n\t * access token. The underlying Primer student is auto-provisioned on\n\t * first exchange. Pass `accessToken` from the returned `SessionToken`\n\t * to `create()` on the browser SDK.\n\t */\n\texchangeTimebackStudentForAccessToken(sourcedId: string): Promise<SessionToken>\n}\n\nfunction createPrimerServer(config: PrimerServerConfig): PrimerServer {\n\treturn {\n\t\tcreateNativeStudent(gradeLevel): Promise<string> {\n\t\t\treturn createStudent(config, gradeLevel)\n\t\t},\n\t\tupdateNativeStudentGradeLevel(studentId, gradeLevel): Promise<void> {\n\t\t\treturn updateStudentGradeLevel(config, studentId, gradeLevel)\n\t\t},\n\t\texchangeNativeStudentForAccessToken(studentId): Promise<SessionToken> {\n\t\t\treturn exchangeToken(config, \"native\", studentId)\n\t\t},\n\t\texchangeTimebackStudentForAccessToken(sourcedId): Promise<SessionToken> {\n\t\t\treturn exchangeToken(config, \"timeback\", sourcedId)\n\t\t}\n\t}\n}\n\nexport type { PrimerServer, PrimerServerConfig }\nexport { createPrimerServer }\n",
+    "const GRADE_LEVELS = [\"K\", \"1\", \"2\", \"3\", \"4\", \"5\", \"6\", \"7\", \"8\", \"9\", \"10\", \"11\", \"12\"] as const\n\ntype GradeLevel = (typeof GRADE_LEVELS)[number]\n\nexport { GRADE_LEVELS }\nexport type { GradeLevel }\n"
+  ],
+  "mappings": "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",
+  "debugId": "3128BCEC46D85F5764756E2164756E21",
+  "names": []
+}

package/dist/server/students.d.ts

@@ -0,0 +1,14 @@
+import type { GradeLevel } from "../grade-level";
+import type { PrimerLogger } from "../logger";
+interface StudentsConfig {
+    readonly origin: string;
+    readonly secretKey: string;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly abort?: AbortController;
+    readonly logger?: PrimerLogger;
+}
+declare function createStudent(config: StudentsConfig, gradeLevel: GradeLevel): Promise<string>;
+declare function updateStudentGradeLevel(config: StudentsConfig, studentId: string, gradeLevel: GradeLevel): Promise<void>;
+export type { StudentsConfig };
+export { createStudent, updateStudentGradeLevel };
+//# sourceMappingURL=students.d.ts.map

package/dist/server/students.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"students.d.ts","sourceRoot":"","sources":["../../src/server/students.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAItE,UAAU,cAAc;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,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;AA0FD,iBAAe,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC5F;AAED,iBAAe,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GACpB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,YAAY,EAAE,cAAc,EAAE,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,CAAA"}

package/dist/subject.d.ts

@@ -1,4 +1,4 @@
-declare const SUBJECTS: readonly ["math", "vocabulary"];
+declare const SUBJECTS: readonly ["math", "vocabulary", "science"];
 type Subject = (typeof SUBJECTS)[number];
 type SubjectScope = Subject | "all";
 export { SUBJECTS };

package/dist/subject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../src/subject.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,QAAQ,iCAAkC,CAAA;AAEhD,KAAK,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAExC,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,CAAA;AAEnC,OAAO,EAAE,QAAQ,EAAE,CAAA;AACnB,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../src/subject.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,QAAQ,4CAA6C,CAAA;AAE3D,KAAK,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAExC,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,CAAA;AAEnC,OAAO,EAAE,QAAQ,EAAE,CAAA;AACnB,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/package.json

@@ -1,11 +1,15 @@
 {
 	"name": "@superbuilders/primer-tives",
-	"version": "0.6.0",
+	"version": "0.8.0",
 	"type": "module",
 	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js"
+		"./client": {
+			"types": "./dist/client/index.d.ts",
+			"import": "./dist/client/index.js"
+		},
+		"./server": {
+			"types": "./dist/server/index.d.ts",
+			"import": "./dist/server/index.js"
 		}
 	},
 	"files": [

package/dist/choice-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"choice-state.d.ts","sourceRoot":"","sources":["../src/choice-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAA;AAC5D,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,mCAAmC,CAAA;AA6C1C,iBAAS,WAAW,CAAC,IAAI,SAAS,KAAK,EACtC,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,EACnE,OAAO,EAAE,cAAc,EAAE,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAChB,WAAW,CAAC,IAAI,CAAC,CAsFnB;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAA;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAMpE,UAAU,MAAM,CAAC,IAAI,SAAS,KAAK,GAAG,KAAK;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,IAAI,EAAE,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,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,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;CACnC;AAUD,iBAAS,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CA4C5E;AAED,OAAO,EAAE,MAAM,EAAE,CAAA;AACjB,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA"}

package/dist/consumed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"consumed.d.ts","sourceRoot":"","sources":["../src/consumed.ts"],"names":[],"mappings":"AAEA,iBAAS,YAAY,IAAI,KAAK,CAG7B;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/content.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtF,KAAK,aAAa,GAAG,WAAW,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnE,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,CAgB1D;AAED,iBAAS,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAMzD;AAED,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/extended-text-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extended-text-state.d.ts","sourceRoot":"","sources":["../src/extended-text-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAA;AAC5D,OAAO,KAAK,EACX,WAAW,EACX,gBAAgB,EAChB,2BAA2B,EAC3B,MAAM,mCAAmC,CAAA;AAoB1C,iBAAS,iBAAiB,CAAC,IAAI,SAAS,KAAK,EAC5C,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,OAAO,CAAC,2BAA2B,EAAE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,GAC1E,WAAW,CAAC,IAAI,CAAC,CA0JnB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/feedback-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"feedback-state.d.ts","sourceRoot":"","sources":["../src/feedback-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAA;AAC5D,OAAO,KAAK,EACX,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,mCAAmC,CAAA;AAE1C,iBAAS,aAAa,CAAC,IAAI,SAAS,KAAK,EACxC,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,EACtC,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACpC,SAAS,EAAE,OAAO,EAClB,eAAe,EAAE,aAAa,EAAE,EAChC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,IAAI,GACpC,WAAW,CAAC,IAAI,CAAC,CAmBnB;AAED,OAAO,EAAE,aAAa,EAAE,CAAA"}