@learncard/network-brain-client 2.5.56 → 2.5.57

package/dist/brain-client.esm.js

@@ -15954,6 +15954,7 @@ var require_types_cjs_development = __commonJS({
     var __toCommonJS = /* @__PURE__ */ __name2((mod) => __copyProps22(__defProp22({}, "__esModule", { value: true }), mod), "__toCommonJS");
     var index_exports = {};
     __export22(index_exports, {
+      ACT_AS_HEADER: /* @__PURE__ */ __name2(() => ACT_AS_HEADER, "ACT_AS_HEADER"),
       AUTH_GRANT_AUDIENCE_DOMAIN_PREFIX: /* @__PURE__ */ __name2(() => AUTH_GRANT_AUDIENCE_DOMAIN_PREFIX, "AUTH_GRANT_AUDIENCE_DOMAIN_PREFIX"),
       AchievementCredentialValidator: /* @__PURE__ */ __name2(() => AchievementCredentialValidator, "AchievementCredentialValidator"),
       AchievementCriteriaValidator: /* @__PURE__ */ __name2(() => AchievementCriteriaValidator, "AchievementCriteriaValidator"),
@@ -16093,10 +16094,18 @@ var require_types_cjs_development = __commonJS({
       IdentifierTypeValidator: /* @__PURE__ */ __name2(() => IdentifierTypeValidator, "IdentifierTypeValidator"),
       IdentityObjectValidator: /* @__PURE__ */ __name2(() => IdentityObjectValidator, "IdentityObjectValidator"),
       ImageValidator: /* @__PURE__ */ __name2(() => ImageValidator, "ImageValidator"),
+      InboxBatchErrorReasonValidator: /* @__PURE__ */ __name2(() => InboxBatchErrorReasonValidator, "InboxBatchErrorReasonValidator"),
+      InboxBatchReceiptValidator: /* @__PURE__ */ __name2(() => InboxBatchReceiptValidator, "InboxBatchReceiptValidator"),
+      InboxBatchStatusValidator: /* @__PURE__ */ __name2(() => InboxBatchStatusValidator, "InboxBatchStatusValidator"),
       InboxCredentialQueryValidator: /* @__PURE__ */ __name2(() => InboxCredentialQueryValidator, "InboxCredentialQueryValidator"),
+      InboxCredentialRefreshReceiptValidator: /* @__PURE__ */ __name2(() => InboxCredentialRefreshReceiptValidator, "InboxCredentialRefreshReceiptValidator"),
       InboxCredentialValidator: /* @__PURE__ */ __name2(() => InboxCredentialValidator, "InboxCredentialValidator"),
       IncrementCounterEventValidator: /* @__PURE__ */ __name2(() => IncrementCounterEventValidator, "IncrementCounterEventValidator"),
       InstalledAppValidator: /* @__PURE__ */ __name2(() => InstalledAppValidator, "InstalledAppValidator"),
+      IssueInboxCredentialBatchItemResultValidator: /* @__PURE__ */ __name2(() => IssueInboxCredentialBatchItemResultValidator, "IssueInboxCredentialBatchItemResultValidator"),
+      IssueInboxCredentialBatchItemValidator: /* @__PURE__ */ __name2(() => IssueInboxCredentialBatchItemValidator, "IssueInboxCredentialBatchItemValidator"),
+      IssueInboxCredentialBatchResponseValidator: /* @__PURE__ */ __name2(() => IssueInboxCredentialBatchResponseValidator, "IssueInboxCredentialBatchResponseValidator"),
+      IssueInboxCredentialBatchValidator: /* @__PURE__ */ __name2(() => IssueInboxCredentialBatchValidator, "IssueInboxCredentialBatchValidator"),
       IssueInboxCredentialResponseValidator: /* @__PURE__ */ __name2(() => IssueInboxCredentialResponseValidator, "IssueInboxCredentialResponseValidator"),
       IssueInboxCredentialValidator: /* @__PURE__ */ __name2(() => IssueInboxCredentialValidator, "IssueInboxCredentialValidator"),
       IssueInboxSigningAuthorityValidator: /* @__PURE__ */ __name2(() => IssueInboxSigningAuthorityValidator, "IssueInboxSigningAuthorityValidator"),
@@ -16145,7 +16154,8 @@ var require_types_cjs_development = __commonJS({
       LaunchTypeValidator: /* @__PURE__ */ __name2(() => LaunchTypeValidator, "LaunchTypeValidator"),
       LearnCardRefreshAuthorizationValidator: /* @__PURE__ */ __name2(() => LearnCardRefreshAuthorizationValidator, "LearnCardRefreshAuthorizationValidator"),
       LinkProviderFrameworkInputValidator: /* @__PURE__ */ __name2(() => LinkProviderFrameworkInputValidator, "LinkProviderFrameworkInputValidator"),
-      ManagedCredentialRefreshServiceValidator: /* @__PURE__ */ __name2(() => ManagedCredentialRefreshServiceValidator, "ManagedCredentialRefreshServiceValidator"),
+      ManagedCredentialRefreshReceiptValidator: /* @__PURE__ */ __name2(() => ManagedCredentialRefreshReceiptValidator, "ManagedCredentialRefreshReceiptValidator"),
+      ManagedCredentialRefreshServiceValidator: /* @__PURE__ */ __name2(() => ManagedCredentialRefreshServiceValidator2, "ManagedCredentialRefreshServiceValidator"),
       PaginatedAppStoreListingsValidator: /* @__PURE__ */ __name2(() => PaginatedAppStoreListingsValidator, "PaginatedAppStoreListingsValidator"),
       PaginatedBoostRecipientsValidator: /* @__PURE__ */ __name2(() => PaginatedBoostRecipientsValidator, "PaginatedBoostRecipientsValidator"),
       PaginatedBoostRecipientsWithChildrenValidator: /* @__PURE__ */ __name2(() => PaginatedBoostRecipientsWithChildrenValidator, "PaginatedBoostRecipientsWithChildrenValidator"),
@@ -16171,6 +16181,8 @@ var require_types_cjs_development = __commonJS({
       PaginatedVisibleLCNProfilesValidator: /* @__PURE__ */ __name2(() => PaginatedVisibleLCNProfilesValidator, "PaginatedVisibleLCNProfilesValidator"),
       PaginationOptionsValidator: /* @__PURE__ */ __name2(() => PaginationOptionsValidator, "PaginationOptionsValidator"),
       PaginationResponseValidator: /* @__PURE__ */ __name2(() => PaginationResponseValidator, "PaginationResponseValidator"),
+      PrepareRefreshableSendInputValidator: /* @__PURE__ */ __name2(() => PrepareRefreshableSendInputValidator, "PrepareRefreshableSendInputValidator"),
+      PrepareRefreshableSendResultValidator: /* @__PURE__ */ __name2(() => PrepareRefreshableSendResultValidator, "PrepareRefreshableSendResultValidator"),
       ProfileValidator: /* @__PURE__ */ __name2(() => ProfileValidator, "ProfileValidator"),
       ProfileVisibilityEnum: /* @__PURE__ */ __name2(() => ProfileVisibilityEnum, "ProfileVisibilityEnum"),
       PromotionLevelValidator: /* @__PURE__ */ __name2(() => PromotionLevelValidator, "PromotionLevelValidator"),
@@ -16196,6 +16208,7 @@ var require_types_cjs_development = __commonJS({
       SendAiSessionCredentialEventValidator: /* @__PURE__ */ __name2(() => SendAiSessionCredentialEventValidator, "SendAiSessionCredentialEventValidator"),
       SendBoostInputValidator: /* @__PURE__ */ __name2(() => SendBoostInputValidator, "SendBoostInputValidator"),
       SendBoostResponseValidator: /* @__PURE__ */ __name2(() => SendBoostResponseValidator, "SendBoostResponseValidator"),
+      SendBoostTemplateValidator: /* @__PURE__ */ __name2(() => SendBoostTemplateValidator, "SendBoostTemplateValidator"),
       SendBrandingOptionsValidator: /* @__PURE__ */ __name2(() => SendBrandingOptionsValidator, "SendBrandingOptionsValidator"),
       SendCredentialEventValidator: /* @__PURE__ */ __name2(() => SendCredentialEventValidator, "SendCredentialEventValidator"),
       SendInboxResponseValidator: /* @__PURE__ */ __name2(() => SendInboxResponseValidator, "SendInboxResponseValidator"),
@@ -16938,7 +16951,7 @@ var require_types_cjs_development = __commonJS({
       getSizableOrigin: /* @__PURE__ */ __name2(() => getSizableOrigin2, "getSizableOrigin"),
       hexToUint8Array: /* @__PURE__ */ __name2(() => hexToUint8Array2, "hexToUint8Array"),
       isObject: /* @__PURE__ */ __name2(() => isObject3, "isObject"),
-      isPlainObject: /* @__PURE__ */ __name2(() => isPlainObject3, "isPlainObject"),
+      isPlainObject: /* @__PURE__ */ __name2(() => isPlainObject22, "isPlainObject"),
       issue: /* @__PURE__ */ __name2(() => issue2, "issue"),
       joinValues: /* @__PURE__ */ __name2(() => joinValues2, "joinValues"),
       jsonStringifyReplacer: /* @__PURE__ */ __name2(() => jsonStringifyReplacer2, "jsonStringifyReplacer"),
@@ -17187,7 +17200,7 @@ var require_types_cjs_development = __commonJS({
         return false;
       }
     });
-    function isPlainObject3(o) {
+    function isPlainObject22(o) {
       if (isObject3(o) === false)
         return false;
       const ctor = o.constructor;
@@ -17203,11 +17216,11 @@ var require_types_cjs_development = __commonJS({
       }
       return true;
     }
-    __name(isPlainObject3, "isPlainObject");
-    __name2(isPlainObject3, "isPlainObject");
-    __name22(isPlainObject3, "isPlainObject");
+    __name(isPlainObject22, "isPlainObject2");
+    __name2(isPlainObject22, "isPlainObject");
+    __name22(isPlainObject22, "isPlainObject");
     function shallowClone2(o) {
-      if (isPlainObject3(o))
+      if (isPlainObject22(o))
         return { ...o };
       if (Array.isArray(o))
         return [...o];
@@ -17441,7 +17454,7 @@ var require_types_cjs_development = __commonJS({
     __name2(omit2, "omit");
     __name22(omit2, "omit");
     function extend2(schema, shape) {
-      if (!isPlainObject3(shape)) {
+      if (!isPlainObject22(shape)) {
         throw new Error("Invalid input to extend: expected a plain object");
       }
       const checks = schema._zod.def.checks;
@@ -17467,7 +17480,7 @@ var require_types_cjs_development = __commonJS({
     __name2(extend2, "extend");
     __name22(extend2, "extend");
     function safeExtend2(schema, shape) {
-      if (!isPlainObject3(shape)) {
+      if (!isPlainObject22(shape)) {
         throw new Error("Invalid input to safeExtend: expected a plain object");
       }
       const def = mergeDefs2(schema._zod.def, {
@@ -19941,7 +19954,7 @@ var require_types_cjs_development = __commonJS({
       if (a instanceof Date && b instanceof Date && +a === +b) {
         return { valid: true, data: a };
       }
-      if (isPlainObject3(a) && isPlainObject3(b)) {
+      if (isPlainObject22(a) && isPlainObject22(b)) {
         const bKeys = Object.keys(b);
         const sharedKeys = Object.keys(a).filter((key) => bKeys.indexOf(key) !== -1);
         const newObj = { ...a, ...b };
@@ -20142,7 +20155,7 @@ var require_types_cjs_development = __commonJS({
       $ZodType2.init(inst, def);
       inst._zod.parse = (payload, ctx) => {
         const input = payload.value;
-        if (!isPlainObject3(input)) {
+        if (!isPlainObject22(input)) {
           payload.issues.push({
             expected: "record",
             code: "invalid_type",
@@ -32572,6 +32585,204 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         $or: BaseStringQuery.array()
       })
     ]);
+    var LearnCardRefreshAuthorizationValidator = external_exports2.object({ type: external_exports2.literal("LearnCardDIDAuth") }).catchall(external_exports2.any());
+    var ManagedCredentialRefreshServiceValidator2 = external_exports2.object({
+      id: external_exports2.string().min(1),
+      type: external_exports2.literal("LearnCardCredentialRefresh2026"),
+      authorization: LearnCardRefreshAuthorizationValidator.optional()
+    }).catchall(external_exports2.any());
+    var StandardCredentialRefreshServiceValidator = external_exports2.object({
+      id: external_exports2.string().min(1),
+      type: external_exports2.literal("1EdTechCredentialRefresh")
+    }).catchall(external_exports2.any());
+    var SupportedCredentialRefreshServiceValidator2 = external_exports2.union([
+      ManagedCredentialRefreshServiceValidator2,
+      StandardCredentialRefreshServiceValidator
+    ]);
+    var AllocateCredentialRefreshInputValidator = external_exports2.object({
+      holder: external_exports2.object({
+        profileId: external_exports2.string().optional(),
+        did: external_exports2.string().min(1)
+      }),
+      credentialId: external_exports2.string().min(1)
+    });
+    var AllocateCredentialRefreshResultValidator = external_exports2.object({
+      refreshId: external_exports2.string().min(1),
+      refreshService: ManagedCredentialRefreshServiceValidator2.extend({
+        authorization: LearnCardRefreshAuthorizationValidator
+      })
+    });
+    var ManagedCredentialRefreshReceiptValidator = external_exports2.object({
+      refreshId: external_exports2.string().min(1),
+      refreshService: ManagedCredentialRefreshServiceValidator2,
+      credentialId: external_exports2.string().min(1),
+      issuerDid: external_exports2.string().min(1),
+      holderDid: external_exports2.string().min(1),
+      credentialStatus: CredentialStatusValidator.or(
+        CredentialStatusValidator.array()
+      ).optional()
+    }).strip();
+    var InboxCredentialRefreshReceiptValidator = ManagedCredentialRefreshReceiptValidator.omit(
+      { holderDid: true }
+    ).extend({ holderDid: external_exports2.string().min(1).optional() });
+    var CredentialRefreshSigningModeValidator = external_exports2.enum(["issuer-signed", "signing-authority"]);
+    var PublishCredentialRefreshBaseFields = {
+      refreshId: external_exports2.string().min(1),
+      notifyHolder: external_exports2.boolean().optional(),
+      updateSummary: external_exports2.string().optional(),
+      idempotencyKey: external_exports2.string().optional()
+    };
+    var PublishIssuerSignedRefreshValidator = external_exports2.object({
+      ...PublishCredentialRefreshBaseFields,
+      mode: external_exports2.literal("issuer-signed"),
+      signedCredential: VCValidator
+    });
+    var PublishSigningAuthorityRefreshValidator = external_exports2.object({
+      ...PublishCredentialRefreshBaseFields,
+      mode: external_exports2.literal("signing-authority"),
+      credential: UnsignedVCValidator,
+      signingAuthority: external_exports2.object({
+        type: external_exports2.string().min(1)
+      }).catchall(external_exports2.any())
+    });
+    var PublishCredentialRefreshInputValidator = external_exports2.object({
+      ...PublishCredentialRefreshBaseFields,
+      mode: CredentialRefreshSigningModeValidator,
+      signedCredential: VCValidator.optional(),
+      credential: UnsignedVCValidator.optional(),
+      signingAuthority: external_exports2.object({
+        type: external_exports2.string().min(1)
+      }).catchall(external_exports2.any()).optional()
+    }).superRefine((input, ctx) => {
+      if (input.mode === "issuer-signed" && !input.signedCredential) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["signedCredential"],
+          message: "signedCredential is required for issuer-signed publication"
+        });
+      }
+      if (input.mode === "issuer-signed" && (input.credential !== void 0 || input.signingAuthority !== void 0)) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["mode"],
+          message: "issuer-signed publication cannot include signing-authority fields"
+        });
+      }
+      if (input.mode === "signing-authority") {
+        if (input.signedCredential !== void 0) {
+          ctx.addIssue({
+            code: "custom",
+            path: ["signedCredential"],
+            message: "signing-authority publication cannot include signedCredential"
+          });
+        }
+        if (!input.credential) {
+          ctx.addIssue({
+            code: "custom",
+            path: ["credential"],
+            message: "credential is required for signing-authority publication"
+          });
+        }
+        if (!input.signingAuthority) {
+          ctx.addIssue({
+            code: "custom",
+            path: ["signingAuthority"],
+            message: "signingAuthority is required for signing-authority publication"
+          });
+        }
+      }
+    });
+    var PublishCredentialRefreshNotificationValidator = external_exports2.enum([
+      "queued",
+      "suppressed",
+      "not-applicable",
+      /** Publication succeeded, but the post-commit notification enqueue must be retried. */
+      "delivery-failed"
+    ]);
+    var PublishCredentialRefreshResultValidator = external_exports2.object({
+      refreshId: external_exports2.string().min(1),
+      version: external_exports2.number().int().positive(),
+      publishedAt: external_exports2.string().min(1),
+      notification: PublishCredentialRefreshNotificationValidator
+    });
+    var CredentialRefreshVersionMetadataValidator = external_exports2.object({
+      version: external_exports2.number().int().positive(),
+      publishedAt: external_exports2.string().min(1),
+      effectiveAt: external_exports2.string().optional(),
+      etag: external_exports2.string().optional(),
+      signingMode: CredentialRefreshSigningModeValidator.optional(),
+      updateSummary: external_exports2.string().optional()
+    });
+    var GetCredentialRefreshHistoryInputValidator = external_exports2.object({
+      refreshId: external_exports2.string().min(1),
+      cursor: external_exports2.string().optional(),
+      limit: external_exports2.number().int().positive().optional()
+    });
+    var GetCredentialRefreshHistoryResultValidator = external_exports2.object({
+      records: CredentialRefreshVersionMetadataValidator.array(),
+      hasMore: external_exports2.boolean(),
+      cursor: external_exports2.string().optional()
+    });
+    var CredentialRefreshChallengeValidator = external_exports2.object({
+      challenge: external_exports2.string().min(1),
+      expiresAt: external_exports2.string().min(1),
+      domain: external_exports2.string().optional(),
+      scheme: external_exports2.literal("LearnCardDIDAuth").optional()
+    });
+    var PublicCredentialRefreshEnvelopeValidator = external_exports2.object({
+      format: external_exports2.literal("vc"),
+      credential: VCValidator,
+      etag: external_exports2.string().optional()
+    });
+    var JweCredentialRefreshEnvelopeValidator = external_exports2.object({
+      format: external_exports2.literal("jwe"),
+      jwe: JWEValidator2,
+      etag: external_exports2.string().optional(),
+      /** Present on LearnCard-managed endpoints; optional for interoperable JWE services. */
+      version: external_exports2.number().int().positive().optional()
+    });
+    var CredentialRefreshResponseEnvelopeValidator = external_exports2.discriminatedUnion("format", [
+      PublicCredentialRefreshEnvelopeValidator,
+      JweCredentialRefreshEnvelopeValidator
+    ]);
+    var CredentialRefreshFailureCodeValidator = external_exports2.enum([
+      "UNAVAILABLE",
+      "TIMEOUT",
+      "UNSUPPORTED_SERVICE",
+      "UNAUTHORIZED",
+      "MALFORMED_RESPONSE",
+      "INVALID_PROOF",
+      "ISSUER_MISMATCH",
+      "ID_MISMATCH",
+      "ROLLBACK",
+      "REVOKED",
+      "UNSAFE_ENDPOINT"
+    ]);
+    var CredentialRefreshUpdatedResultValidator = external_exports2.object({
+      status: external_exports2.literal("updated"),
+      credential: VCValidator,
+      etag: external_exports2.string().optional(),
+      managedVersion: external_exports2.number().int().positive().optional()
+    });
+    var CredentialRefreshUnchangedResultValidator = external_exports2.object({
+      status: external_exports2.literal("unchanged"),
+      checkedAt: external_exports2.string().min(1),
+      etag: external_exports2.string().optional()
+    });
+    var CredentialRefreshUnsupportedResultValidator = external_exports2.object({
+      status: external_exports2.literal("unsupported")
+    });
+    var CredentialRefreshFailedResultValidator = external_exports2.object({
+      status: external_exports2.literal("failed"),
+      code: CredentialRefreshFailureCodeValidator,
+      retryable: external_exports2.boolean()
+    });
+    var CredentialRefreshResultValidator = external_exports2.discriminatedUnion("status", [
+      CredentialRefreshUpdatedResultValidator,
+      CredentialRefreshUnchangedResultValidator,
+      CredentialRefreshUnsupportedResultValidator,
+      CredentialRefreshFailedResultValidator
+    ]);
     var LCNProfileDisplayValidator = external_exports2.object({
       backgroundColor: external_exports2.string().optional(),
       backgroundImage: external_exports2.string().optional(),
@@ -32907,7 +33118,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         "Options for email/phone recipients (Universal Inbox)"
       ),
       templateData: external_exports2.record(external_exports2.string(), external_exports2.unknown()).optional(),
-      integrationId: external_exports2.string().optional().describe("Integration ID for activity tracking")
+      integrationId: external_exports2.string().optional().describe("Integration ID for activity tracking"),
+      refresh: external_exports2.boolean().optional().describe(
+        "Request managed credential refresh for this send. Profile/DID recipients use immediate issuance; email/phone recipients use deferred Universal Inbox signing and bind the holder at claim."
+      ),
+      idempotencyKey: external_exports2.string().min(1).max(200).optional().describe(
+        "Caller-chosen key that makes a managed refresh send (refresh: true) safe to retry as a whole: retries with the same key reuse the same boost, refresh allocation and result. Reusing a key for a different request is rejected. With signedCredential, requires prior tRPC prepareRefreshableSend; direct REST callers omit the key and retry the exact signed credential and templateUri."
+      )
     }).refine((data) => data.templateUri || data.template || data.signedCredential, {
       message: "Either templateUri, template, or signedCredential must be provided.",
       path: ["templateUri"]
@@ -32922,8 +33139,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         message: "guardianEmail must differ from recipient (self-approval not allowed)",
         path: ["options", "guardianEmail"]
       }
-    );
+    ).refine((data) => !data.idempotencyKey || data.refresh === true, {
+      message: "idempotencyKey is only supported with refresh: true.",
+      path: ["idempotencyKey"]
+    });
     var SendInboxResponseValidator = external_exports2.object({
+      refresh: InboxCredentialRefreshReceiptValidator.optional(),
       issuanceId: external_exports2.string(),
       status: external_exports2.enum(["PENDING", "ISSUED", "EXPIRED", "DELIVERED", "CLAIMED"]),
       claimUrl: external_exports2.string().url().optional().describe("Present when suppressDelivery=true"),
@@ -32938,8 +33159,34 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       activityId: external_exports2.string().describe("Links to the activity lifecycle for this issuance"),
       inbox: SendInboxResponseValidator.optional().describe(
         "Present when sent via email/phone (Universal Inbox)"
+      ),
+      refresh: ManagedCredentialRefreshReceiptValidator.optional().describe(
+        "Present when managed refresh was requested: issuance metadata the issuer keeps to publish future updates"
       )
     });
+    var PrepareRefreshableSendInputValidator = external_exports2.object({
+      recipient: external_exports2.string(),
+      templateUri: external_exports2.string().optional(),
+      template: SendBoostTemplateValidator.optional(),
+      contractUri: external_exports2.string().optional(),
+      templateData: external_exports2.record(external_exports2.string(), external_exports2.unknown()).optional(),
+      integrationId: external_exports2.string().optional(),
+      /** Credential ID to allocate for; generated server-side when omitted. */
+      credentialId: external_exports2.string().min(1).optional(),
+      idempotencyKey: external_exports2.string().min(1).max(200).optional()
+    }).refine((data) => Boolean(data.templateUri) !== Boolean(data.template), {
+      message: "Provide exactly one of templateUri or template."
+    });
+    var PrepareRefreshableSendResultValidator = external_exports2.object({
+      boostUri: external_exports2.string(),
+      credentialId: external_exports2.string(),
+      refreshId: external_exports2.string(),
+      refreshService: ManagedCredentialRefreshServiceValidator2,
+      /** The DID to use as credentialSubject.id (recipient DID, or the profile's did:web). */
+      holderDid: external_exports2.string(),
+      /** Present when this idempotencyKey already completed: return it without signing. */
+      completed: SendBoostResponseValidator.optional()
+    });
     var SendInputValidator = external_exports2.discriminatedUnion("type", [SendBoostInputValidator]);
     var SendResponseValidator = external_exports2.discriminatedUnion("type", [SendBoostResponseValidator]);
     var ConsentFlowTermsStatusValidator = external_exports2.enum(["live", "stale", "withdrawn"]);
@@ -33258,6 +33505,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       webhookUrl: external_exports2.string().optional()
     });
     var AUTH_GRANT_AUDIENCE_DOMAIN_PREFIX = "auth-grant:";
+    var ACT_AS_HEADER = "X-LearnCard-Act-As";
     var AuthGrantValidator = external_exports2.object({
       id: external_exports2.string(),
       name: external_exports2.string(),
@@ -33270,6 +33518,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         }, "error")
       }),
       scope: external_exports2.string(),
+      actAs: external_exports2.string().optional(),
       createdAt: external_exports2.iso.datetime({ error: "createdAt must be a valid ISO 8601 datetime string" }),
       expiresAt: external_exports2.iso.datetime({ error: "expiresAt must be a valid ISO 8601 datetime string" }).nullish().optional()
     });
@@ -33341,6 +33590,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       sessionJwt: external_exports2.string()
     });
     var InboxCredentialValidator = external_exports2.object({
+      refresh: InboxCredentialRefreshReceiptValidator.optional(),
+      refreshId: external_exports2.string().optional(),
       id: external_exports2.string(),
       credential: external_exports2.string().optional(),
       isSigned: external_exports2.boolean(),
@@ -33395,12 +33646,19 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       templateUri: external_exports2.string().optional().describe(
         "URI of a boost template to use for issuance. The boost credential will be resolved and used. Mutually exclusive with credential field."
       ),
+      refresh: external_exports2.boolean().optional().describe(
+        "Allocate managed refresh before signing. Requires unsigned content and a registered signing authority; binds the holder on claim."
+      ),
+      idempotencyKey: external_exports2.string().min(1).max(200).optional(),
       // === OPTIONAL FEATURES ===
       // Add major, distinct features at the top level.
       //consentRequest: ConsentRequestValidator.optional(),
       // === PROCESS CONFIGURATION (Optional) ===
       // HOW should this issuance be handled?
       configuration: external_exports2.object({
+        guardianEmail: external_exports2.string().email().optional().describe(
+          "Require approval from this guardian before the recipient can claim. Must differ from the recipient email."
+        ),
         signingAuthority: IssueInboxSigningAuthorityValidator.optional().describe(
           "The signing authority to use for the credential. If not provided, the users default signing authority will be used if the credential is not signed."
         ),
@@ -33454,17 +33712,130 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       }).optional().describe(
         "Configuration for the credential issuance. If not provided, the default configuration will be used."
       )
+    }).refine((data) => !data.idempotencyKey || data.refresh === true, {
+      message: "idempotencyKey requires refresh: true."
     }).refine((data) => data.credential || data.templateUri, {
       message: "Either credential or templateUri must be provided.",
       path: ["credential"]
-    });
+    }).refine(
+      (data) => !data.configuration?.guardianEmail || data.recipient.type !== "email" || data.configuration.guardianEmail.toLowerCase() !== data.recipient.value.toLowerCase(),
+      {
+        message: "guardianEmail must differ from recipient (self-approval not allowed)",
+        path: ["configuration", "guardianEmail"]
+      }
+    );
     var IssueInboxCredentialResponseValidator = external_exports2.object({
+      refresh: InboxCredentialRefreshReceiptValidator.optional(),
       issuanceId: external_exports2.string(),
       status: LCNInboxStatusEnumValidator,
       recipient: ContactMethodQueryValidator,
       claimUrl: external_exports2.string().url().optional(),
       recipientDid: external_exports2.string().optional()
     });
+    var InboxBatchConfigurationValidator = IssueInboxCredentialValidator.shape.configuration.unwrap().extend({
+      refresh: IssueInboxCredentialValidator.shape.refresh.describe(
+        "Enable managed refresh by default. An item configuration.refresh overrides this value, including false."
+      ),
+      delivery: IssueInboxCredentialValidator.shape.configuration.unwrap().shape.delivery.unwrap().extend({ suppress: external_exports2.boolean().optional() }).optional()
+    });
+    var InboxBatchItemConfigurationValidator = InboxBatchConfigurationValidator.extend({
+      guardianEmail: InboxBatchConfigurationValidator.shape.guardianEmail.nullable().describe(
+        "Require guardian approval, or set null to clear a batch-level guardianEmail for this item."
+      )
+    });
+    var IssueInboxCredentialBatchItemValidator = external_exports2.object({
+      ...IssueInboxCredentialValidator.shape,
+      configuration: InboxBatchItemConfigurationValidator.optional(),
+      idempotencyKey: external_exports2.string().max(256).optional()
+    }).refine((data) => data.credential || data.templateUri, {
+      message: "Either credential or templateUri must be provided.",
+      path: ["credential"]
+    }).describe(
+      "One issuance: provide credential or templateUri. Invalid input is rejected at submission with its item index."
+    );
+    var IssueInboxCredentialBatchValidator = external_exports2.object({
+      requestId: external_exports2.string().min(1).max(256).optional(),
+      items: external_exports2.array(IssueInboxCredentialBatchItemValidator).min(1).max(100),
+      configuration: InboxBatchConfigurationValidator.optional()
+    }).superRefine((batch, ctx) => {
+      batch.items.forEach((item, index) => {
+        const itemGuardian = item.configuration?.guardianEmail;
+        const guardian = itemGuardian === null ? void 0 : itemGuardian ?? batch.configuration?.guardianEmail;
+        if (guardian && item.recipient.type === "email" && guardian.toLowerCase() === item.recipient.value.toLowerCase()) {
+          ctx.addIssue({
+            code: "custom",
+            path: ["items", index, "configuration", "guardianEmail"],
+            message: "guardianEmail must differ from recipient (self-approval not allowed)"
+          });
+        }
+      });
+    });
+    var InboxBatchErrorReasonValidator = external_exports2.enum([
+      "DUPLICATE_KEY",
+      "IDEMPOTENCY_MISMATCH",
+      "IN_PROGRESS",
+      "UNCONFIRMED"
+    ]);
+    var IssueInboxCredentialBatchItemResultValidator = external_exports2.discriminatedUnion("success", [
+      IssueInboxCredentialResponseValidator.extend({
+        success: external_exports2.literal(true),
+        index: external_exports2.number().int().nonnegative(),
+        deduplicated: external_exports2.boolean().optional(),
+        guardianStatus: GuardianStatusValidator.optional(),
+        idempotencyKey: external_exports2.string().optional()
+      }),
+      external_exports2.object({
+        success: external_exports2.literal(false),
+        index: external_exports2.number().int().nonnegative(),
+        idempotencyKey: external_exports2.string().optional(),
+        recipient: ContactMethodQueryValidator.optional(),
+        error: external_exports2.object({
+          code: external_exports2.string(),
+          message: external_exports2.string(),
+          reason: InboxBatchErrorReasonValidator.optional()
+        }),
+        issuanceId: external_exports2.string().optional().describe(
+          "Present when issuance completed but replay storage could not be confirmed. Reconcile this issuance; do not issue again with a new key."
+        ),
+        claimUrl: external_exports2.string().url().optional().describe(
+          "Claim URL of the completed issuance, if available, when replay storage could not be confirmed."
+        )
+      })
+    ]);
+    var IssueInboxCredentialBatchResponseValidator = external_exports2.object({
+      results: external_exports2.array(IssueInboxCredentialBatchItemResultValidator),
+      summary: external_exports2.object({
+        total: external_exports2.number(),
+        succeeded: external_exports2.number(),
+        failed: external_exports2.number(),
+        deduplicated: external_exports2.number()
+      })
+    });
+    var InboxBatchReceiptValidator = external_exports2.object({
+      batchId: external_exports2.string(),
+      status: external_exports2.enum(["QUEUED", "PROCESSING", "COMPLETED", "NEEDS_RECONCILIATION"]),
+      createdAt: external_exports2.string()
+    });
+    var InboxBatchStatusValidator = external_exports2.object({
+      batchId: external_exports2.string(),
+      createdAt: external_exports2.string(),
+      done: external_exports2.boolean().describe(
+        "True when no queued or processing items remain, including unconfirmed outcomes."
+      ),
+      status: external_exports2.enum(["QUEUED", "PROCESSING", "COMPLETED", "NEEDS_RECONCILIATION"]),
+      items: external_exports2.array(
+        external_exports2.object({
+          index: external_exports2.number().int().nonnegative(),
+          state: external_exports2.enum(["QUEUED", "PROCESSING", "COMPLETED", "NEEDS_RECONCILIATION"]),
+          result: IssueInboxCredentialBatchItemResultValidator.optional()
+        })
+      ),
+      summary: IssueInboxCredentialBatchResponseValidator.shape.summary.extend({
+        completed: external_exports2.number(),
+        pending: external_exports2.number(),
+        unconfirmed: external_exports2.number()
+      })
+    });
     var CredentialNameRefValidator = external_exports2.object({ name: external_exports2.string() }).passthrough();
     var ClaimInboxCredentialValidator = external_exports2.object({
       credential: VCValidator.or(VPValidator).or(UnsignedVCValidator).or(CredentialNameRefValidator).describe("The credential to issue, or a { name } reference to resolve a boost template."),
@@ -33950,6 +34321,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       eventType: CredentialActivityEventTypeValidator,
       timestamp: external_exports2.string(),
       actorProfileId: external_exports2.string().optional(),
+      onBehalfOf: external_exports2.string().optional(),
       recipientType: CredentialActivityRecipientTypeValidator,
       recipientIdentifier: external_exports2.string(),
       boostUri: external_exports2.string().optional(),
@@ -34113,191 +34485,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       const result = inAppMessagesFlagValidator.safeParse(raw);
       return result.success ? result.data : EMPTY_IN_APP_MESSAGES_FLAG;
     }, "parseInAppMessagesFlag");
-    var LearnCardRefreshAuthorizationValidator = external_exports2.object({ type: external_exports2.literal("LearnCardDIDAuth") }).catchall(external_exports2.any());
-    var ManagedCredentialRefreshServiceValidator = external_exports2.object({
-      id: external_exports2.string().min(1),
-      type: external_exports2.literal("LearnCardCredentialRefresh2026"),
-      authorization: LearnCardRefreshAuthorizationValidator.optional()
-    }).catchall(external_exports2.any());
-    var StandardCredentialRefreshServiceValidator = external_exports2.object({
-      id: external_exports2.string().min(1),
-      type: external_exports2.literal("1EdTechCredentialRefresh")
-    }).catchall(external_exports2.any());
-    var SupportedCredentialRefreshServiceValidator2 = external_exports2.union([
-      ManagedCredentialRefreshServiceValidator,
-      StandardCredentialRefreshServiceValidator
-    ]);
-    var AllocateCredentialRefreshInputValidator = external_exports2.object({
-      holder: external_exports2.object({
-        profileId: external_exports2.string().optional(),
-        did: external_exports2.string().min(1)
-      }),
-      credentialId: external_exports2.string().min(1)
-    });
-    var AllocateCredentialRefreshResultValidator = external_exports2.object({
-      refreshId: external_exports2.string().min(1),
-      refreshService: ManagedCredentialRefreshServiceValidator.extend({
-        authorization: LearnCardRefreshAuthorizationValidator
-      })
-    });
-    var CredentialRefreshSigningModeValidator = external_exports2.enum(["issuer-signed", "signing-authority"]);
-    var PublishCredentialRefreshBaseFields = {
-      refreshId: external_exports2.string().min(1),
-      notifyHolder: external_exports2.boolean().optional(),
-      updateSummary: external_exports2.string().optional(),
-      idempotencyKey: external_exports2.string().optional()
-    };
-    var PublishIssuerSignedRefreshValidator = external_exports2.object({
-      ...PublishCredentialRefreshBaseFields,
-      mode: external_exports2.literal("issuer-signed"),
-      signedCredential: VCValidator
-    });
-    var PublishSigningAuthorityRefreshValidator = external_exports2.object({
-      ...PublishCredentialRefreshBaseFields,
-      mode: external_exports2.literal("signing-authority"),
-      credential: UnsignedVCValidator,
-      signingAuthority: external_exports2.object({
-        type: external_exports2.string().min(1)
-      }).catchall(external_exports2.any())
-    });
-    var PublishCredentialRefreshInputValidator = external_exports2.object({
-      ...PublishCredentialRefreshBaseFields,
-      mode: CredentialRefreshSigningModeValidator,
-      signedCredential: VCValidator.optional(),
-      credential: UnsignedVCValidator.optional(),
-      signingAuthority: external_exports2.object({
-        type: external_exports2.string().min(1)
-      }).catchall(external_exports2.any()).optional()
-    }).superRefine((input, ctx) => {
-      if (input.mode === "issuer-signed" && !input.signedCredential) {
-        ctx.addIssue({
-          code: "custom",
-          path: ["signedCredential"],
-          message: "signedCredential is required for issuer-signed publication"
-        });
-      }
-      if (input.mode === "issuer-signed" && (input.credential !== void 0 || input.signingAuthority !== void 0)) {
-        ctx.addIssue({
-          code: "custom",
-          path: ["mode"],
-          message: "issuer-signed publication cannot include signing-authority fields"
-        });
-      }
-      if (input.mode === "signing-authority") {
-        if (input.signedCredential !== void 0) {
-          ctx.addIssue({
-            code: "custom",
-            path: ["signedCredential"],
-            message: "signing-authority publication cannot include signedCredential"
-          });
-        }
-        if (!input.credential) {
-          ctx.addIssue({
-            code: "custom",
-            path: ["credential"],
-            message: "credential is required for signing-authority publication"
-          });
-        }
-        if (!input.signingAuthority) {
-          ctx.addIssue({
-            code: "custom",
-            path: ["signingAuthority"],
-            message: "signingAuthority is required for signing-authority publication"
-          });
-        }
-      }
-    });
-    var PublishCredentialRefreshNotificationValidator = external_exports2.enum([
-      "queued",
-      "suppressed",
-      "not-applicable",
-      /** Publication succeeded, but the post-commit notification enqueue must be retried. */
-      "delivery-failed"
-    ]);
-    var PublishCredentialRefreshResultValidator = external_exports2.object({
-      refreshId: external_exports2.string().min(1),
-      version: external_exports2.number().int().positive(),
-      publishedAt: external_exports2.string().min(1),
-      notification: PublishCredentialRefreshNotificationValidator
-    });
-    var CredentialRefreshVersionMetadataValidator = external_exports2.object({
-      version: external_exports2.number().int().positive(),
-      publishedAt: external_exports2.string().min(1),
-      effectiveAt: external_exports2.string().optional(),
-      etag: external_exports2.string().optional(),
-      signingMode: CredentialRefreshSigningModeValidator.optional(),
-      updateSummary: external_exports2.string().optional()
-    });
-    var GetCredentialRefreshHistoryInputValidator = external_exports2.object({
-      refreshId: external_exports2.string().min(1),
-      cursor: external_exports2.string().optional(),
-      limit: external_exports2.number().int().positive().optional()
-    });
-    var GetCredentialRefreshHistoryResultValidator = external_exports2.object({
-      records: CredentialRefreshVersionMetadataValidator.array(),
-      hasMore: external_exports2.boolean(),
-      cursor: external_exports2.string().optional()
-    });
-    var CredentialRefreshChallengeValidator = external_exports2.object({
-      challenge: external_exports2.string().min(1),
-      expiresAt: external_exports2.string().min(1),
-      domain: external_exports2.string().optional(),
-      scheme: external_exports2.literal("LearnCardDIDAuth").optional()
-    });
-    var PublicCredentialRefreshEnvelopeValidator = external_exports2.object({
-      format: external_exports2.literal("vc"),
-      credential: VCValidator,
-      etag: external_exports2.string().optional()
-    });
-    var JweCredentialRefreshEnvelopeValidator = external_exports2.object({
-      format: external_exports2.literal("jwe"),
-      jwe: JWEValidator2,
-      etag: external_exports2.string().optional(),
-      /** Present on LearnCard-managed endpoints; optional for interoperable JWE services. */
-      version: external_exports2.number().int().positive().optional()
-    });
-    var CredentialRefreshResponseEnvelopeValidator = external_exports2.discriminatedUnion("format", [
-      PublicCredentialRefreshEnvelopeValidator,
-      JweCredentialRefreshEnvelopeValidator
-    ]);
-    var CredentialRefreshFailureCodeValidator = external_exports2.enum([
-      "UNAVAILABLE",
-      "TIMEOUT",
-      "UNSUPPORTED_SERVICE",
-      "UNAUTHORIZED",
-      "MALFORMED_RESPONSE",
-      "INVALID_PROOF",
-      "ISSUER_MISMATCH",
-      "ID_MISMATCH",
-      "ROLLBACK",
-      "REVOKED",
-      "UNSAFE_ENDPOINT"
-    ]);
-    var CredentialRefreshUpdatedResultValidator = external_exports2.object({
-      status: external_exports2.literal("updated"),
-      credential: VCValidator,
-      etag: external_exports2.string().optional(),
-      managedVersion: external_exports2.number().int().positive().optional()
-    });
-    var CredentialRefreshUnchangedResultValidator = external_exports2.object({
-      status: external_exports2.literal("unchanged"),
-      checkedAt: external_exports2.string().min(1),
-      etag: external_exports2.string().optional()
-    });
-    var CredentialRefreshUnsupportedResultValidator = external_exports2.object({
-      status: external_exports2.literal("unsupported")
-    });
-    var CredentialRefreshFailedResultValidator = external_exports2.object({
-      status: external_exports2.literal("failed"),
-      code: CredentialRefreshFailureCodeValidator,
-      retryable: external_exports2.boolean()
-    });
-    var CredentialRefreshResultValidator = external_exports2.discriminatedUnion("status", [
-      CredentialRefreshUpdatedResultValidator,
-      CredentialRefreshUnchangedResultValidator,
-      CredentialRefreshUnsupportedResultValidator,
-      CredentialRefreshFailedResultValidator
-    ]);
   }
 });
 var require_dist = __commonJS({
@@ -34593,6 +34780,18 @@ var ImageWithLoadingStateValdator = external_exports.object({
 });
 var import_types2 = __toESM(require_dist());
 var import_types22 = __toESM(require_dist());
+var MANAGED_REFRESH_TYPE_TERM = "LearnCardCredentialRefresh2026";
+var MANAGED_REFRESH_DID_AUTH_TERM = "LearnCardDIDAuth";
+var MANAGED_REFRESH_TYPE_IRI = "https://learncard.com/refresh#LearnCardCredentialRefresh2026";
+var MANAGED_REFRESH_AUTHORIZATION_IRI = "https://purl.imsglobal.org/spec/ob/v3p0#authorization";
+var MANAGED_REFRESH_DID_AUTH_IRI = "https://docs.learncard.com/definitions#LearnCardDIDAuth";
+var MANAGED_REFRESH_SERVICE_CONTEXT = {
+  [MANAGED_REFRESH_TYPE_TERM]: MANAGED_REFRESH_TYPE_IRI,
+  authorization: {
+    "@id": MANAGED_REFRESH_AUTHORIZATION_IRI,
+    "@context": { [MANAGED_REFRESH_DID_AUTH_TERM]: MANAGED_REFRESH_DID_AUTH_IRI }
+  }
+};
 var EnvironmentConfigurationError = class extends Error {
   static {
     __name(this, "EnvironmentConfigurationError");