@learncard/types 5.21.0 → 5.22.0

package/dist/types.esm.js

@@ -2406,6 +2406,7 @@ var CredentialActivityStatsValidator = z12.object({
 });
 
 // src/auth.ts
+import { z as z13 } from "zod";
 var AuthSessionError = class extends Error {
   constructor(message, reason) {
     super(message);
@@ -2416,126 +2417,591 @@ var AuthSessionError = class extends Error {
     __name(this, "AuthSessionError");
   }
 };
+var ESCROW_PIN_LOCKED_MESSAGE = "Too many incorrect PIN attempts. You can still recover by waiting.";
+var ESCROW_PIN_UNAVAILABLE_MESSAGE = "PIN recovery is not available for this account.";
+var ESCROW_PIN_MISMATCH_PATTERN = /^Incorrect PIN\. (\d+) attempts left\.$/;
+var escrowPinMismatchMessage = /* @__PURE__ */ __name((attemptsRemaining) => `Incorrect PIN. ${attemptsRemaining} attempts left.`, "escrowPinMismatchMessage");
+var EscrowPinStatusValidator = z13.object({
+  state: z13.enum(["none", "enabled", "locked", "stale"]),
+  enabled: z13.boolean(),
+  attemptsRemaining: z13.number().int().nonnegative(),
+  salt: z13.string().optional()
+});
 
 // src/bitstring-status-list.ts
-import { z as z13 } from "zod/v4";
+import { z as z14 } from "zod/v4";
 var BITSTRING_STATUS_PURPOSES = ["revocation", "suspension"];
 var DEFAULT_BITSTRING_STATUS_LIST_SIZE = 131072;
-var BitstringStatusPurposeValidator = z13.enum(BITSTRING_STATUS_PURPOSES);
-var BitstringStatusListEntryValidator = z13.object({
-  id: z13.string().optional(),
-  type: z13.literal("BitstringStatusListEntry"),
+var BitstringStatusPurposeValidator = z14.enum(BITSTRING_STATUS_PURPOSES);
+var BitstringStatusListEntryValidator = z14.object({
+  id: z14.string().optional(),
+  type: z14.literal("BitstringStatusListEntry"),
   statusPurpose: BitstringStatusPurposeValidator,
-  statusListIndex: z13.string().or(z13.number().int().nonnegative()),
-  statusListCredential: z13.string()
+  statusListIndex: z14.string().or(z14.number().int().nonnegative()),
+  statusListCredential: z14.string()
 });
 var AllocatedBitstringStatusListEntryValidator = BitstringStatusListEntryValidator.extend({
-  id: z13.string()
+  id: z14.string()
 });
-var BitstringStatusListCredentialSubjectValidator = z13.object({
-  id: z13.string().optional(),
-  type: z13.literal("BitstringStatusList"),
+var BitstringStatusListCredentialSubjectValidator = z14.object({
+  id: z14.string().optional(),
+  type: z14.literal("BitstringStatusList"),
   statusPurpose: BitstringStatusPurposeValidator,
-  encodedList: z13.string()
+  encodedList: z14.string()
 });
-var AllocateCredentialStatusInputValidator = z13.object({
-  statusPurposes: z13.array(BitstringStatusPurposeValidator).optional(),
-  listSize: z13.number().int().positive().optional()
+var AllocateCredentialStatusInputValidator = z14.object({
+  statusPurposes: z14.array(BitstringStatusPurposeValidator).optional(),
+  listSize: z14.number().int().positive().optional()
 }).default({});
 
 // src/inAppMessages.ts
-import { z as z14 } from "zod";
-var inAppMessagePlatformValidator = z14.enum(["ios", "android", "web"]);
-var inAppMessageVersionSourceValidator = z14.enum(["native", "web", "capgo"]);
-var inAppMessageVersionOpValidator = z14.enum(["lt", "lte", "eq", "gte", "gt"]);
-var platformPredicateValidator = z14.object({ platform: z14.array(inAppMessagePlatformValidator).nonempty() }).strict();
-var rolePredicateValidator = z14.object({ role: z14.array(z14.string()).nonempty() }).strict();
-var versionPredicateValidator = z14.object({
-  version: z14.object({
+import { z as z15 } from "zod";
+var inAppMessagePlatformValidator = z15.enum(["ios", "android", "web"]);
+var inAppMessageVersionSourceValidator = z15.enum(["native", "web", "capgo"]);
+var inAppMessageVersionOpValidator = z15.enum(["lt", "lte", "eq", "gte", "gt"]);
+var platformPredicateValidator = z15.object({ platform: z15.array(inAppMessagePlatformValidator).nonempty() }).strict();
+var rolePredicateValidator = z15.object({ role: z15.array(z15.string()).nonempty() }).strict();
+var versionPredicateValidator = z15.object({
+  version: z15.object({
     source: inAppMessageVersionSourceValidator,
     op: inAppMessageVersionOpValidator,
-    value: z14.string()
+    value: z15.string()
   }).strict()
 }).strict();
-var inAppMessagePredicateValidator = z14.lazy(
-  () => z14.union([
+var inAppMessagePredicateValidator = z15.lazy(
+  () => z15.union([
     platformPredicateValidator,
     rolePredicateValidator,
     versionPredicateValidator,
-    z14.object({ all: z14.array(inAppMessagePredicateValidator) }).strict(),
-    z14.object({ any: z14.array(inAppMessagePredicateValidator) }).strict(),
-    z14.object({ not: inAppMessagePredicateValidator }).strict()
+    z15.object({ all: z15.array(inAppMessagePredicateValidator) }).strict(),
+    z15.object({ any: z15.array(inAppMessagePredicateValidator) }).strict(),
+    z15.object({ not: inAppMessagePredicateValidator }).strict()
   ])
 );
-var inAppMessageActionStyleValidator = z14.enum(["primary", "secondary", "positive", "dismiss"]).default("secondary");
-var internalLinkActionValidator = z14.object({ type: z14.literal("internalLink"), path: z14.string() }).passthrough();
-var externalLinkActionValidator = z14.object({ type: z14.literal("externalLink"), url: z14.string() }).passthrough();
-var appStoreActionValidator = z14.object({
-  type: z14.literal("appStore"),
-  iosUrl: z14.string().optional(),
-  androidUrl: z14.string().optional(),
-  webUrl: z14.string().optional()
+var inAppMessageActionStyleValidator = z15.enum(["primary", "secondary", "positive", "dismiss"]).default("secondary");
+var internalLinkActionValidator = z15.object({ type: z15.literal("internalLink"), path: z15.string() }).passthrough();
+var externalLinkActionValidator = z15.object({ type: z15.literal("externalLink"), url: z15.string() }).passthrough();
+var appStoreActionValidator = z15.object({
+  type: z15.literal("appStore"),
+  iosUrl: z15.string().optional(),
+  androidUrl: z15.string().optional(),
+  webUrl: z15.string().optional()
 }).passthrough();
-var capgoUpdateActionValidator = z14.object({ type: z14.literal("capgoUpdate") }).passthrough();
-var dismissActionValidator = z14.object({ type: z14.literal("dismiss") }).passthrough();
-var inAppMessageActionTargetValidator = z14.union([
+var capgoUpdateActionValidator = z15.object({ type: z15.literal("capgoUpdate") }).passthrough();
+var dismissActionValidator = z15.object({ type: z15.literal("dismiss") }).passthrough();
+var inAppMessageActionTargetValidator = z15.union([
   internalLinkActionValidator,
   externalLinkActionValidator,
   appStoreActionValidator,
   capgoUpdateActionValidator,
   dismissActionValidator
 ]);
-var inAppMessageActionValidator = z14.object({
-  label: z14.string(),
+var inAppMessageActionValidator = z15.object({
+  label: z15.string(),
   style: inAppMessageActionStyleValidator,
   action: inAppMessageActionTargetValidator,
   /** When true, the message closes after this action runs (default true). */
-  closeOnComplete: z14.boolean().default(true)
+  closeOnComplete: z15.boolean().default(true)
 }).passthrough();
-var inAppMessageMediaValidator = z14.object({
-  type: z14.enum(["youtube", "image", "gif"]),
-  url: z14.string(),
+var inAppMessageMediaValidator = z15.object({
+  type: z15.enum(["youtube", "image", "gif"]),
+  url: z15.string(),
   /** Aspect ratio hint, e.g. "16:9" or "1:1". Defaults to 16:9. */
-  aspect: z14.string().default("16:9"),
+  aspect: z15.string().default("16:9"),
   /** Alt text for images/gifs (accessibility). */
-  alt: z14.string().optional()
+  alt: z15.string().optional()
 }).passthrough();
-var inAppMessageFrequencyValidator = z14.union([
-  z14.literal("once"),
-  z14.literal("session"),
-  z14.literal("always"),
-  z14.object({ everyDays: z14.number().positive() }).strict()
+var inAppMessageFrequencyValidator = z15.union([
+  z15.literal("once"),
+  z15.literal("session"),
+  z15.literal("always"),
+  z15.object({ everyDays: z15.number().positive() }).strict()
 ]).default("once");
-var inAppMessagePresentationValidator = z14.enum(["modal", "banner", "toast"]).default("modal");
-var inAppMessageValidator = z14.object({
+var inAppMessagePresentationValidator = z15.enum(["modal", "banner", "toast"]).default("modal");
+var inAppMessageValidator = z15.object({
   /** Stable identifier — used to persist dismissal / frequency state. */
-  id: z14.string(),
+  id: z15.string(),
   /** Higher priority wins when multiple messages match. Default 0. */
-  priority: z14.number().default(0),
+  priority: z15.number().default(0),
   /** When false, the message is required/blocking (no dismiss affordance). */
-  dismissible: z14.boolean().default(true),
+  dismissible: z15.boolean().default(true),
   frequency: inAppMessageFrequencyValidator,
   presentation: inAppMessagePresentationValidator,
   media: inAppMessageMediaValidator.optional(),
   /** Optional emoji hero glyph — rendered only when `media` is not set. */
-  emoji: z14.string().optional(),
-  title: z14.string(),
-  body: z14.string().optional(),
-  actions: z14.array(inAppMessageActionValidator).default([]),
+  emoji: z15.string().optional(),
+  title: z15.string(),
+  body: z15.string().optional(),
+  actions: z15.array(inAppMessageActionValidator).default([]),
   /** Targeting predicate tree. Omitted → matches everyone. */
   targeting: inAppMessagePredicateValidator.optional(),
   /** Allow disabling a message without removing it from the flag. */
-  enabled: z14.boolean().default(true)
+  enabled: z15.boolean().default(true)
 }).passthrough();
-var inAppMessagesFlagValidator = z14.object({
-  version: z14.number().default(1),
-  messages: z14.array(inAppMessageValidator).default([])
+var inAppMessagesFlagValidator = z15.object({
+  version: z15.number().default(1),
+  messages: z15.array(inAppMessageValidator).default([])
 }).passthrough();
 var EMPTY_IN_APP_MESSAGES_FLAG = { version: 1, messages: [] };
 var parseInAppMessagesFlag = /* @__PURE__ */ __name((raw) => {
   const result = inAppMessagesFlagValidator.safeParse(raw);
   return result.success ? result.data : EMPTY_IN_APP_MESSAGES_FLAG;
 }, "parseInAppMessagesFlag");
+
+// src/share-links.ts
+import { z as z16 } from "zod/v4";
+var SHARE_LINK_ID_BYTES = 16;
+var SHARE_CONTENT_KEY_BYTES = 32;
+var SHARE_IV_BYTES = 12;
+var SHARE_TAG_BYTES = 16;
+var MAX_SHARE_CIPHERTEXT_BYTES = 512 * 1024;
+var MAX_SHARE_RECOVERY_JWE_BYTES = 64 * 1024;
+var MAX_SELECTED_CREDENTIALS = 50;
+var MAX_ENDORSEMENTS = 200;
+var MAX_VP_MEMBERS = MAX_SELECTED_CREDENTIALS + MAX_ENDORSEMENTS;
+var MAX_SHARE_SOURCE_URI_CHARS = 2048;
+var MAX_SHARE_LINK_REQUEST_BYTES = 1024 * 1024;
+var SHARE_LINK_PROTOCOL = "lc-share/v1";
+var SHARE_RECOVERY_PROTOCOL = "lc-share-recovery/v1";
+var SHARE_AAD_PREFIX = "lc-share:v1";
+var BASE64URL_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+var BASE64URL_LOOKUP = (() => {
+  const table = new Int16Array(128).fill(-1);
+  for (let index = 0; index < BASE64URL_ALPHABET.length; index += 1) {
+    table[BASE64URL_ALPHABET.charCodeAt(index)] = index;
+  }
+  return table;
+})();
+var encodeBase64Url = /* @__PURE__ */ __name((bytes) => {
+  let output = "";
+  for (let index = 0; index < bytes.length; index += 3) {
+    const first = bytes[index];
+    const second = bytes[index + 1];
+    const third = bytes[index + 2];
+    output += BASE64URL_ALPHABET[first >> 2];
+    output += BASE64URL_ALPHABET[(first & 3) << 4 | (second ?? 0) >> 4];
+    if (second === void 0) break;
+    output += BASE64URL_ALPHABET[(second & 15) << 2 | (third ?? 0) >> 6];
+    if (third === void 0) break;
+    output += BASE64URL_ALPHABET[third & 63];
+  }
+  return output;
+}, "encodeBase64Url");
+var decodeBase64Url = /* @__PURE__ */ __name((value) => {
+  if (typeof value !== "string") return null;
+  const output = new Uint8Array(Math.floor(value.length * 6 / 8));
+  let bits = 0;
+  let bitCount = 0;
+  let outputIndex = 0;
+  for (let index = 0; index < value.length; index += 1) {
+    const code = value.charCodeAt(index);
+    const digit = code < 128 ? BASE64URL_LOOKUP[code] : -1;
+    if (digit < 0) return null;
+    bits = bits << 6 | digit;
+    bitCount += 6;
+    if (bitCount >= 8) {
+      bitCount -= 8;
+      output[outputIndex] = bits >> bitCount & 255;
+      outputIndex += 1;
+    }
+  }
+  return output;
+}, "decodeBase64Url");
+var isCanonicalBase64Url = /* @__PURE__ */ __name((value, expectedBytes) => {
+  if (typeof value !== "string") return false;
+  if (expectedBytes !== void 0 && value.length !== Math.ceil(expectedBytes * 4 / 3))
+    return false;
+  const decoded = decodeBase64Url(value);
+  if (decoded === null) return false;
+  if (expectedBytes !== void 0 && decoded.length !== expectedBytes) return false;
+  return encodeBase64Url(decoded) === value;
+}, "isCanonicalBase64Url");
+var decodedBase64UrlByteLength = /* @__PURE__ */ __name((value) => decodeBase64Url(value)?.length ?? null, "decodedBase64UrlByteLength");
+var utf8ByteLength = /* @__PURE__ */ __name((value) => new TextEncoder().encode(value).length, "utf8ByteLength");
+var canonicalBase64Url = /* @__PURE__ */ __name((bytes) => z16.string().refine((value) => isCanonicalBase64Url(value, bytes), {
+  message: `must be canonical base64url for exactly ${bytes} bytes`
+}), "canonicalBase64Url");
+var ShareLinkIdValidator = canonicalBase64Url(SHARE_LINK_ID_BYTES);
+var ShareContentKeyValidator = canonicalBase64Url(SHARE_CONTENT_KEY_BYTES);
+var ShareIvValidator = canonicalBase64Url(SHARE_IV_BYTES);
+var ShareCiphertextValidator = z16.string().refine(
+  (value) => {
+    if (value.length > Math.ceil(MAX_SHARE_CIPHERTEXT_BYTES * 4 / 3)) return false;
+    const decoded = decodeBase64Url(value);
+    if (decoded === null) return false;
+    if (encodeBase64Url(decoded) !== value) return false;
+    return decoded.length >= SHARE_TAG_BYTES && decoded.length <= MAX_SHARE_CIPHERTEXT_BYTES;
+  },
+  {
+    message: `must be canonical base64url decoding to ${SHARE_TAG_BYTES}..${MAX_SHARE_CIPHERTEXT_BYTES} bytes`
+  }
+);
+var ShareEnvelopeValidator = z16.object({
+  v: z16.literal(1),
+  alg: z16.literal("A256GCM"),
+  iv: ShareIvValidator,
+  ct: ShareCiphertextValidator
+}).strict();
+var safeVersion = z16.number().int().min(1).max(2 ** 31 - 1);
+var safeCredentialIndex = z16.number().int().min(0).max(MAX_VP_MEMBERS - 1);
+var ShareSelectionEntryValidator = z16.object({ credentialIndex: safeCredentialIndex }).strict();
+var ShareEndorsementEntryValidator = z16.object({ credentialIndex: safeCredentialIndex, targetCredentialIndex: safeCredentialIndex }).strict();
+var ShareSharerValidator = z16.object({
+  profileId: z16.string().min(1).max(128),
+  displayName: z16.string().min(1).max(120),
+  avatar: z16.string().max(2048).optional()
+}).strict();
+var presentationShape = VPValidator.extend({
+  verifiableCredential: VCValidator.array().min(1).max(MAX_VP_MEMBERS)
+});
+var hasBoundedPresentation = /* @__PURE__ */ __name((value) => {
+  let credentialCount = 0;
+  const ancestors = /* @__PURE__ */ new Set();
+  const visit = /* @__PURE__ */ __name((node, depth) => {
+    if (node === null || typeof node !== "object") return true;
+    if (depth > 32 || ancestors.has(node)) return false;
+    ancestors.add(node);
+    try {
+      for (const [key, child] of Object.entries(node)) {
+        if (key === "verifiableCredential") {
+          credentialCount += Array.isArray(child) ? child.length : 1;
+          if (credentialCount > MAX_VP_MEMBERS) return false;
+        }
+        if (!visit(child, depth + 1)) return false;
+      }
+      return true;
+    } finally {
+      ancestors.delete(node);
+    }
+  }, "visit");
+  return visit(value, 0);
+}, "hasBoundedPresentation");
+var ShareManifestPresentationValidator = z16.custom(
+  (value) => hasBoundedPresentation(value) && presentationShape.safeParse(value).success,
+  { message: "invalid share presentation" }
+);
+var SharePayloadValidatorShape = z16.object({
+  protocol: z16.literal(SHARE_LINK_PROTOCOL),
+  shareId: ShareLinkIdValidator,
+  contentVersion: safeVersion,
+  createdAt: z16.iso.datetime(),
+  sharer: ShareSharerValidator,
+  presentation: ShareManifestPresentationValidator,
+  selection: ShareSelectionEntryValidator.array().min(1).max(MAX_SELECTED_CREDENTIALS),
+  endorsements: ShareEndorsementEntryValidator.array().max(MAX_ENDORSEMENTS).default([])
+}).strict();
+var classificationFailure = /* @__PURE__ */ __name((code, message, path = []) => ({ ok: false, code, message, path }), "classificationFailure");
+var readSignedClaimId = /* @__PURE__ */ __name((member) => {
+  if (member === null || typeof member !== "object") return void 0;
+  const record = member;
+  const claim = record.credentialSubject ?? record.endorsement;
+  if (claim === null || typeof claim !== "object") return void 0;
+  const claimRecord = claim;
+  const nested = claimRecord.endorsement;
+  const nestedId = nested !== null && typeof nested === "object" ? nested.id : void 0;
+  return claimRecord.id ?? nestedId;
+}, "readSignedClaimId");
+var classifyShareManifest = /* @__PURE__ */ __name((payload) => {
+  const members = payload.presentation?.verifiableCredential;
+  if (!Array.isArray(members) || members.length === 0) {
+    return classificationFailure("NO_PRESENTATION_MEMBERS", "presentation has no credentials");
+  }
+  if (members.length > MAX_VP_MEMBERS) {
+    return classificationFailure(
+      "TOO_MANY_VP_MEMBERS",
+      `presentation has ${members.length} members, over the ${MAX_VP_MEMBERS} bound`
+    );
+  }
+  const selection = payload.selection;
+  const endorsements = payload.endorsements ?? [];
+  if (!Array.isArray(selection) || selection.length < 1 || selection.length > MAX_SELECTED_CREDENTIALS) {
+    return classificationFailure("BAD_SELECTION", "selection must contain 1..50 entries");
+  }
+  if (!Array.isArray(endorsements) || endorsements.length > MAX_ENDORSEMENTS) {
+    return classificationFailure(
+      "BAD_ENDORSEMENTS",
+      "endorsements must contain at most 200 entries"
+    );
+  }
+  const selectedIndices = [];
+  const selected = /* @__PURE__ */ new Set();
+  for (let index = 0; index < selection.length; index += 1) {
+    const entry = selection[index];
+    const credentialIndex = entry?.credentialIndex;
+    if (!Number.isSafeInteger(credentialIndex) || credentialIndex < 0 || credentialIndex >= members.length) {
+      return classificationFailure(
+        "SELECTION_INDEX_OUT_OF_BOUNDS",
+        `selection[${index}].credentialIndex is out of bounds`,
+        ["selection", index, "credentialIndex"]
+      );
+    }
+    if (selected.has(credentialIndex)) {
+      return classificationFailure(
+        "SELECTION_INDEX_DUPLICATE",
+        `selection[${index}].credentialIndex is duplicated`,
+        ["selection", index, "credentialIndex"]
+      );
+    }
+    selected.add(credentialIndex);
+    selectedIndices.push(credentialIndex);
+  }
+  const classified = new Set(selected);
+  const endorsementIndices = [];
+  for (let index = 0; index < endorsements.length; index += 1) {
+    const entry = endorsements[index];
+    const credentialIndex = entry?.credentialIndex;
+    const targetIndex = entry?.targetCredentialIndex;
+    if (!Number.isSafeInteger(credentialIndex) || credentialIndex < 0 || credentialIndex >= members.length) {
+      return classificationFailure(
+        "ENDORSEMENT_INDEX_OUT_OF_BOUNDS",
+        `endorsements[${index}].credentialIndex is out of bounds`,
+        ["endorsements", index, "credentialIndex"]
+      );
+    }
+    if (classified.has(credentialIndex)) {
+      return classificationFailure(
+        "VP_MEMBER_CLASSIFIED_TWICE",
+        `endorsements[${index}].credentialIndex was already classified`,
+        ["endorsements", index, "credentialIndex"]
+      );
+    }
+    if (!selected.has(targetIndex)) {
+      return classificationFailure(
+        "ENDORSEMENT_TARGET_NOT_SELECTED",
+        `endorsements[${index}].targetCredentialIndex must reference a selected credential`,
+        ["endorsements", index, "targetCredentialIndex"]
+      );
+    }
+    const referenced = readSignedClaimId(members[credentialIndex]);
+    const target = members[targetIndex];
+    const targetId = target !== null && typeof target === "object" ? target.id : void 0;
+    if (typeof referenced !== "string" || typeof targetId !== "string" || referenced !== targetId) {
+      return classificationFailure(
+        "ENDORSEMENT_TARGET_UNBOUND",
+        `endorsements[${index}] claim does not reference the target credential id`,
+        ["endorsements", index]
+      );
+    }
+    classified.add(credentialIndex);
+    endorsementIndices.push(credentialIndex);
+  }
+  if (classified.size !== members.length) {
+    return classificationFailure(
+      "UNCLASSIFIED_VP_MEMBER",
+      "every presentation member must be classified exactly once",
+      ["presentation", "verifiableCredential"]
+    );
+  }
+  return {
+    ok: true,
+    classification: { selectedIndices, endorsementIndices, memberCount: members.length }
+  };
+}, "classifyShareManifest");
+var SharePayloadValidator = SharePayloadValidatorShape.superRefine((payload, ctx) => {
+  const result = classifyShareManifest(payload);
+  if (!result.ok) {
+    ctx.addIssue({
+      code: "custom",
+      message: result.message,
+      path: result.path,
+      params: { shareLinkCode: result.code }
+    });
+  }
+});
+var ShareRecoverySelectionValidator = z16.object({
+  ref: z16.string().min(1).max(MAX_SHARE_SOURCE_URI_CHARS),
+  order: z16.number().int().min(0).max(MAX_SELECTED_CREDENTIALS - 1)
+}).strict();
+var ShareRecoveryEndorsementValidator = z16.object({ targetRef: z16.string().min(1).max(MAX_SHARE_SOURCE_URI_CHARS) }).strict();
+var ShareRecoveryPlaintextValidator = z16.object({
+  protocol: z16.literal(SHARE_RECOVERY_PROTOCOL),
+  shareId: ShareLinkIdValidator,
+  ownerProfileId: z16.string().min(1).max(128),
+  createdAt: z16.iso.datetime(),
+  latest: z16.object({ contentVersion: safeVersion, key: ShareContentKeyValidator }).strict(),
+  selection: ShareRecoverySelectionValidator.array().min(1).max(MAX_SELECTED_CREDENTIALS),
+  endorsements: ShareRecoveryEndorsementValidator.array().max(MAX_ENDORSEMENTS).default([])
+}).strict().superRefine((recovery, ctx) => {
+  const orders = /* @__PURE__ */ new Set();
+  recovery.selection.forEach((entry, index) => {
+    if (entry.order >= recovery.selection.length) {
+      ctx.addIssue({
+        code: "custom",
+        message: "order must be within the selection bounds",
+        path: ["selection", index, "order"]
+      });
+    }
+    if (orders.has(entry.order)) {
+      ctx.addIssue({
+        code: "custom",
+        message: "order must be unique within the selection",
+        path: ["selection", index, "order"]
+      });
+    }
+    orders.add(entry.order);
+  });
+});
+var ShareOwnerRecoveryValidator = JWEValidator.refine(
+  (value) => utf8ByteLength(JSON.stringify(value)) <= MAX_SHARE_RECOVERY_JWE_BYTES,
+  { message: `serialized recovery JWE must be at most ${MAX_SHARE_RECOVERY_JWE_BYTES} bytes` }
+);
+var ShareLinkStatusValidator = z16.enum(["pending", "active", "stopped"]);
+var ShareContentStateValidator = z16.enum(["staging", "finalized", "content_missing"]);
+var ShareLinkValidator = z16.object({
+  id: ShareLinkIdValidator,
+  title: z16.string().min(1).max(120),
+  note: z16.string().max(500).optional(),
+  selectedCount: z16.number().int().min(1).max(MAX_SELECTED_CREDENTIALS),
+  version: safeVersion,
+  contentVersion: safeVersion,
+  status: ShareLinkStatusValidator,
+  contentState: ShareContentStateValidator,
+  createdAt: z16.iso.datetime(),
+  updatedAt: z16.iso.datetime(),
+  expiresAt: z16.iso.datetime().nullable(),
+  stoppedAt: z16.iso.datetime().nullable(),
+  lastViewedAt: z16.iso.datetime().nullable(),
+  viewCount: z16.number().int().min(0).optional(),
+  passcodeProtected: z16.boolean(),
+  notifyOnView: z16.boolean(),
+  minorPolicy: z16.object({
+    isMinor: z16.boolean().nullable(),
+    policyResolved: z16.boolean(),
+    defaultExpiryDays: z16.union([z16.literal(30), z16.literal(365)]),
+    viewCountingEnabled: z16.boolean()
+  }),
+  /**
+   * Guarded application/API URL for the content. Optional because owner APIs in
+   * D1 have no public resolve/content endpoint yet; it must never be a
+   * LearnCloud object URL or carry a fabricated decryption key.
+   */
+  contentUrl: z16.string().optional()
+});
+var clientRequestId = z16.string().uuid();
+var CreateShareLinkInputValidator = z16.object({
+  id: ShareLinkIdValidator,
+  clientRequestId,
+  title: z16.string().min(1).max(120),
+  note: z16.string().max(500).optional(),
+  expiresAt: z16.iso.datetime().nullable().optional(),
+  passcode: z16.string().min(8).max(64).optional(),
+  notifyOnView: z16.boolean().default(false),
+  selectedCount: z16.number().int().min(1).max(MAX_SELECTED_CREDENTIALS),
+  contentVersion: z16.literal(1),
+  envelope: ShareEnvelopeValidator,
+  ownerEncryptedRecovery: ShareOwnerRecoveryValidator
+}).strict();
+var UpdateShareLinkInputValidator = z16.object({
+  id: ShareLinkIdValidator,
+  expectedVersion: safeVersion,
+  clientRequestId,
+  title: z16.string().min(1).max(120).optional(),
+  note: z16.string().max(500).nullable().optional(),
+  expiresAt: z16.iso.datetime().nullable().optional(),
+  /** Omitted preserves the current passcode, null removes it, and a string replaces it. */
+  passcode: z16.string().min(8).max(64).nullable().optional(),
+  notifyOnView: z16.boolean().optional(),
+  contentVersion: safeVersion.optional(),
+  selectedCount: z16.number().int().min(1).max(MAX_SELECTED_CREDENTIALS).optional(),
+  envelope: ShareEnvelopeValidator.optional(),
+  ownerEncryptedRecovery: ShareOwnerRecoveryValidator.optional()
+}).strict().superRefine((value, ctx) => {
+  const provided = [
+    value.contentVersion,
+    value.selectedCount,
+    value.envelope,
+    value.ownerEncryptedRecovery
+  ].filter((field) => field !== void 0).length;
+  if (provided !== 0 && provided !== 4) {
+    ctx.addIssue({
+      code: "custom",
+      message: "content replacement requires contentVersion, selectedCount, envelope and ownerEncryptedRecovery together"
+    });
+  }
+});
+var ShareLinkIdInputValidator = z16.object({ id: ShareLinkIdValidator }).strict();
+var ShareLinkOperationKeyInputValidator = z16.object({ id: ShareLinkIdValidator, operationId: z16.string().uuid() }).strict();
+var ShareLinkOwnerCommitOutputValidator = z16.discriminatedUnion("status", [
+  z16.object({ status: z16.literal("completed"), share: ShareLinkValidator }).strict(),
+  z16.object({
+    status: z16.literal("pending"),
+    id: ShareLinkIdValidator,
+    operationId: z16.string().uuid()
+  }).strict()
+]);
+var ShareLinkOwnerStatusOutputValidator = z16.discriminatedUnion("status", [
+  z16.object({ status: z16.literal("found"), share: ShareLinkValidator }).strict(),
+  z16.object({
+    status: z16.literal("pending"),
+    id: ShareLinkIdValidator,
+    operationId: z16.string().uuid()
+  }).strict(),
+  z16.object({ status: z16.literal("not_found"), id: ShareLinkIdValidator }).strict()
+]);
+var ShareLinkOwnerRecoveryOutputValidator = z16.object({ recovery: ShareOwnerRecoveryValidator }).strict();
+var ShareLinkOwnerContentOutputValidator = z16.object({
+  id: ShareLinkIdValidator,
+  contentVersion: safeVersion,
+  envelope: ShareEnvelopeValidator
+}).strict();
+var ResolveShareLinkInputValidator = z16.object({
+  id: ShareLinkIdValidator,
+  /** Sent only in a POST body; it must never be placed in a share URL. */
+  passcode: z16.string().min(4).max(64).optional()
+}).strict();
+var ShareLinkPublicStateValidator = z16.discriminatedUnion("state", [
+  z16.object({
+    state: z16.literal("passcode_required"),
+    id: ShareLinkIdValidator
+  }).strict(),
+  z16.object({ state: z16.literal("try_later"), id: ShareLinkIdValidator }).strict(),
+  z16.object({
+    state: z16.literal("active"),
+    id: ShareLinkIdValidator,
+    title: z16.string().max(120),
+    note: z16.string().max(500).optional(),
+    selectedCount: z16.number().int().min(1).max(MAX_SELECTED_CREDENTIALS),
+    contentVersion: safeVersion,
+    contentUrl: z16.string(),
+    sharer: z16.object({
+      displayName: z16.string().max(120),
+      avatar: z16.string().max(2048).optional()
+    }),
+    createdAt: z16.iso.datetime(),
+    updatedAt: z16.iso.datetime(),
+    expiresAt: z16.iso.datetime().nullable()
+  }).strict(),
+  z16.object({
+    state: z16.literal("expired"),
+    id: ShareLinkIdValidator,
+    expiresAt: z16.iso.datetime()
+  }).strict(),
+  z16.object({
+    state: z16.literal("stopped"),
+    id: ShareLinkIdValidator,
+    stoppedAt: z16.iso.datetime()
+  }).strict(),
+  z16.object({ state: z16.literal("not_found"), id: ShareLinkIdValidator }).strict()
+]);
+var ListShareLinksInputValidator = z16.object({
+  limit: z16.number().int().min(1).max(50).default(25),
+  cursor: z16.string().max(512).optional()
+}).strict();
+var PaginatedShareLinksValidator = PaginationResponseValidator.extend({
+  records: ShareLinkValidator.array()
+});
+var AcknowledgeViewInputValidator = z16.object({
+  receipt: z16.string().min(22).max(128).regex(/^[A-Za-z0-9_-]+$/)
+}).strict();
+var AcknowledgeViewOutputValidator = z16.object({ ok: z16.literal(true) }).strict();
+var SHARE_VIEW_RECEIPT_TTL_SECONDS = 10 * 60;
+var ShareLinkPublicContentViewValidator = z16.object({
+  id: ShareLinkIdValidator,
+  contentVersion: safeVersion,
+  envelope: ShareEnvelopeValidator,
+  contentUrl: z16.string(),
+  receipt: z16.string().min(22).max(128).regex(/^[A-Za-z0-9_-]+$/)
+}).strict();
 export {
   ACT_AS_HEADER,
   AUTH_GRANT_AUDIENCE_DOMAIN_PREFIX,
@@ -2544,6 +3010,8 @@ export {
   AchievementSubjectValidator,
   AchievementTypeValidator,
   AchievementValidator,
+  AcknowledgeViewInputValidator,
+  AcknowledgeViewOutputValidator,
   AddTagInputValidator,
   AddressValidator,
   AgeRatingValidator,
@@ -2621,6 +3089,7 @@ export {
   CreateContactMethodSessionValidator,
   CreateManagedFrameworkBatchInputValidator,
   CreateManagedFrameworkInputValidator,
+  CreateShareLinkInputValidator,
   CreateSkillInputValidator,
   CreateSkillsBatchInputValidator,
   CredentialActivityEventTypeValidator,
@@ -2652,10 +3121,14 @@ export {
   DeleteSkillInputValidator,
   DidDocumentValidator,
   EMPTY_IN_APP_MESSAGES_FLAG,
+  ESCROW_PIN_LOCKED_MESSAGE,
+  ESCROW_PIN_MISMATCH_PATTERN,
+  ESCROW_PIN_UNAVAILABLE_MESSAGE,
   EncryptedCredentialRecordValidator,
   EncryptedRecordValidator,
   EndorsementCredentialValidator,
   EndorsementSubjectValidator,
+  EscrowPinStatusValidator,
   EvidenceValidator,
   FlatAuthGrantValidator,
   FrameworkWithSkillsValidator,
@@ -2737,6 +3210,14 @@ export {
   LaunchTypeValidator,
   LearnCardRefreshAuthorizationValidator,
   LinkProviderFrameworkInputValidator,
+  ListShareLinksInputValidator,
+  MAX_ENDORSEMENTS,
+  MAX_SELECTED_CREDENTIALS,
+  MAX_SHARE_CIPHERTEXT_BYTES,
+  MAX_SHARE_LINK_REQUEST_BYTES,
+  MAX_SHARE_RECOVERY_JWE_BYTES,
+  MAX_SHARE_SOURCE_URI_CHARS,
+  MAX_VP_MEMBERS,
   ManagedCredentialRefreshReceiptValidator,
   ManagedCredentialRefreshServiceValidator,
   PaginatedAppStoreListingsValidator,
@@ -2759,6 +3240,7 @@ export {
   PaginatedLCNProfileManagersValidator,
   PaginatedLCNProfilesAndManagersValidator,
   PaginatedLCNProfilesValidator,
+  PaginatedShareLinksValidator,
   PaginatedSkillFrameworksValidator,
   PaginatedSkillTreeValidator,
   PaginatedVisibleLCNProfilesValidator,
@@ -2783,11 +3265,20 @@ export {
   ReplaceSkillFrameworkSkillsInputValidator,
   ReplaceSkillFrameworkSkillsResultValidator,
   RequestLearnerContextEventValidator,
+  ResolveShareLinkInputValidator,
   ResultDescriptionValidator,
   ResultStatusTypeValidator,
   ResultTypeValidator,
   ResultValidator,
   RubricCriterionValidator,
+  SHARE_AAD_PREFIX,
+  SHARE_CONTENT_KEY_BYTES,
+  SHARE_IV_BYTES,
+  SHARE_LINK_ID_BYTES,
+  SHARE_LINK_PROTOCOL,
+  SHARE_RECOVERY_PROTOCOL,
+  SHARE_TAG_BYTES,
+  SHARE_VIEW_RECEIPT_TTL_SECONDS,
   SendAiSessionCredentialEventValidator,
   SendBoostInputValidator,
   SendBoostResponseValidator,
@@ -2802,6 +3293,32 @@ export {
   SentCredentialInfoValidator,
   ServiceValidator,
   SetPrimaryContactMethodValidator,
+  ShareCiphertextValidator,
+  ShareContentKeyValidator,
+  ShareContentStateValidator,
+  ShareEndorsementEntryValidator,
+  ShareEnvelopeValidator,
+  ShareIvValidator,
+  ShareLinkIdInputValidator,
+  ShareLinkIdValidator,
+  ShareLinkOperationKeyInputValidator,
+  ShareLinkOwnerCommitOutputValidator,
+  ShareLinkOwnerContentOutputValidator,
+  ShareLinkOwnerRecoveryOutputValidator,
+  ShareLinkOwnerStatusOutputValidator,
+  ShareLinkPublicContentViewValidator,
+  ShareLinkPublicStateValidator,
+  ShareLinkStatusValidator,
+  ShareLinkValidator,
+  ShareManifestPresentationValidator,
+  ShareOwnerRecoveryValidator,
+  SharePayloadValidator,
+  SharePayloadValidatorShape,
+  ShareRecoveryEndorsementValidator,
+  ShareRecoveryPlaintextValidator,
+  ShareRecoverySelectionValidator,
+  ShareSelectionEntryValidator,
+  ShareSharerValidator,
   SkillDeletionStrategyValidator,
   SkillFrameworkAdminInputValidator,
   SkillFrameworkAdminsValidator,
@@ -2833,6 +3350,7 @@ export {
   UnsignedVCValidator,
   UnsignedVPValidator,
   UpdateFrameworkInputValidator,
+  UpdateShareLinkInputValidator,
   UpdateSkillInputValidator,
   VC2EvidenceValidator,
   VCValidator,
@@ -2844,7 +3362,12 @@ export {
   VerificationStatusValidator,
   appStoreActionValidator,
   capgoUpdateActionValidator,
+  classifyShareManifest,
+  decodeBase64Url,
+  decodedBase64UrlByteLength,
   dismissActionValidator,
+  encodeBase64Url,
+  escrowPinMismatchMessage,
   externalLinkActionValidator,
   inAppMessageActionStyleValidator,
   inAppMessageActionTargetValidator,
@@ -2859,9 +3382,11 @@ export {
   inAppMessageVersionSourceValidator,
   inAppMessagesFlagValidator,
   internalLinkActionValidator,
+  isCanonicalBase64Url,
   isStoredCredentialEnvelope,
   parseInAppMessagesFlag,
   platformPredicateValidator,
   rolePredicateValidator,
+  utf8ByteLength,
   versionPredicateValidator
 };