@learncard/helpers 1.5.0 → 1.6.0

package/dist/helpers.esm.js

@@ -53,6 +53,7 @@ var require_types_cjs_development = __commonJS({
     var __toCommonJS = /* @__PURE__ */ __name((mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod), "__toCommonJS");
     var index_exports = {};
     __export2(index_exports, {
+      ACT_AS_HEADER: /* @__PURE__ */ __name(() => ACT_AS_HEADER, "ACT_AS_HEADER"),
       AUTH_GRANT_AUDIENCE_DOMAIN_PREFIX: /* @__PURE__ */ __name(() => AUTH_GRANT_AUDIENCE_DOMAIN_PREFIX, "AUTH_GRANT_AUDIENCE_DOMAIN_PREFIX"),
       AchievementCredentialValidator: /* @__PURE__ */ __name(() => AchievementCredentialValidator, "AchievementCredentialValidator"),
       AchievementCriteriaValidator: /* @__PURE__ */ __name(() => AchievementCriteriaValidator, "AchievementCriteriaValidator"),
@@ -115,6 +116,7 @@ var require_types_cjs_development = __commonJS({
       ConsentFlowContractValidator: /* @__PURE__ */ __name(() => ConsentFlowContractValidator, "ConsentFlowContractValidator"),
       ConsentFlowDataForDidQueryValidator: /* @__PURE__ */ __name(() => ConsentFlowDataForDidQueryValidator, "ConsentFlowDataForDidQueryValidator"),
       ConsentFlowDataQueryValidator: /* @__PURE__ */ __name(() => ConsentFlowDataQueryValidator, "ConsentFlowDataQueryValidator"),
+      ConsentFlowGuardianApprovalValidator: /* @__PURE__ */ __name(() => ConsentFlowGuardianApprovalValidator, "ConsentFlowGuardianApprovalValidator"),
       ConsentFlowTermValidator: /* @__PURE__ */ __name(() => ConsentFlowTermValidator, "ConsentFlowTermValidator"),
       ConsentFlowTermsQueryValidator: /* @__PURE__ */ __name(() => ConsentFlowTermsQueryValidator, "ConsentFlowTermsQueryValidator"),
       ConsentFlowTermsStatusValidator: /* @__PURE__ */ __name(() => ConsentFlowTermsStatusValidator, "ConsentFlowTermsStatusValidator"),
@@ -191,10 +193,18 @@ var require_types_cjs_development = __commonJS({
       IdentifierTypeValidator: /* @__PURE__ */ __name(() => IdentifierTypeValidator, "IdentifierTypeValidator"),
       IdentityObjectValidator: /* @__PURE__ */ __name(() => IdentityObjectValidator, "IdentityObjectValidator"),
       ImageValidator: /* @__PURE__ */ __name(() => ImageValidator, "ImageValidator"),
+      InboxBatchErrorReasonValidator: /* @__PURE__ */ __name(() => InboxBatchErrorReasonValidator, "InboxBatchErrorReasonValidator"),
+      InboxBatchReceiptValidator: /* @__PURE__ */ __name(() => InboxBatchReceiptValidator, "InboxBatchReceiptValidator"),
+      InboxBatchStatusValidator: /* @__PURE__ */ __name(() => InboxBatchStatusValidator, "InboxBatchStatusValidator"),
       InboxCredentialQueryValidator: /* @__PURE__ */ __name(() => InboxCredentialQueryValidator, "InboxCredentialQueryValidator"),
+      InboxCredentialRefreshReceiptValidator: /* @__PURE__ */ __name(() => InboxCredentialRefreshReceiptValidator, "InboxCredentialRefreshReceiptValidator"),
       InboxCredentialValidator: /* @__PURE__ */ __name(() => InboxCredentialValidator, "InboxCredentialValidator"),
       IncrementCounterEventValidator: /* @__PURE__ */ __name(() => IncrementCounterEventValidator, "IncrementCounterEventValidator"),
       InstalledAppValidator: /* @__PURE__ */ __name(() => InstalledAppValidator, "InstalledAppValidator"),
+      IssueInboxCredentialBatchItemResultValidator: /* @__PURE__ */ __name(() => IssueInboxCredentialBatchItemResultValidator, "IssueInboxCredentialBatchItemResultValidator"),
+      IssueInboxCredentialBatchItemValidator: /* @__PURE__ */ __name(() => IssueInboxCredentialBatchItemValidator, "IssueInboxCredentialBatchItemValidator"),
+      IssueInboxCredentialBatchResponseValidator: /* @__PURE__ */ __name(() => IssueInboxCredentialBatchResponseValidator, "IssueInboxCredentialBatchResponseValidator"),
+      IssueInboxCredentialBatchValidator: /* @__PURE__ */ __name(() => IssueInboxCredentialBatchValidator, "IssueInboxCredentialBatchValidator"),
       IssueInboxCredentialResponseValidator: /* @__PURE__ */ __name(() => IssueInboxCredentialResponseValidator, "IssueInboxCredentialResponseValidator"),
       IssueInboxCredentialValidator: /* @__PURE__ */ __name(() => IssueInboxCredentialValidator, "IssueInboxCredentialValidator"),
       IssueInboxSigningAuthorityValidator: /* @__PURE__ */ __name(() => IssueInboxSigningAuthorityValidator, "IssueInboxSigningAuthorityValidator"),
@@ -243,7 +253,8 @@ var require_types_cjs_development = __commonJS({
       LaunchTypeValidator: /* @__PURE__ */ __name(() => LaunchTypeValidator, "LaunchTypeValidator"),
       LearnCardRefreshAuthorizationValidator: /* @__PURE__ */ __name(() => LearnCardRefreshAuthorizationValidator, "LearnCardRefreshAuthorizationValidator"),
       LinkProviderFrameworkInputValidator: /* @__PURE__ */ __name(() => LinkProviderFrameworkInputValidator, "LinkProviderFrameworkInputValidator"),
-      ManagedCredentialRefreshServiceValidator: /* @__PURE__ */ __name(() => ManagedCredentialRefreshServiceValidator, "ManagedCredentialRefreshServiceValidator"),
+      ManagedCredentialRefreshReceiptValidator: /* @__PURE__ */ __name(() => ManagedCredentialRefreshReceiptValidator, "ManagedCredentialRefreshReceiptValidator"),
+      ManagedCredentialRefreshServiceValidator: /* @__PURE__ */ __name(() => ManagedCredentialRefreshServiceValidator2, "ManagedCredentialRefreshServiceValidator"),
       PaginatedAppStoreListingsValidator: /* @__PURE__ */ __name(() => PaginatedAppStoreListingsValidator, "PaginatedAppStoreListingsValidator"),
       PaginatedBoostRecipientsValidator: /* @__PURE__ */ __name(() => PaginatedBoostRecipientsValidator, "PaginatedBoostRecipientsValidator"),
       PaginatedBoostRecipientsWithChildrenValidator: /* @__PURE__ */ __name(() => PaginatedBoostRecipientsWithChildrenValidator, "PaginatedBoostRecipientsWithChildrenValidator"),
@@ -269,6 +280,8 @@ var require_types_cjs_development = __commonJS({
       PaginatedVisibleLCNProfilesValidator: /* @__PURE__ */ __name(() => PaginatedVisibleLCNProfilesValidator, "PaginatedVisibleLCNProfilesValidator"),
       PaginationOptionsValidator: /* @__PURE__ */ __name(() => PaginationOptionsValidator, "PaginationOptionsValidator"),
       PaginationResponseValidator: /* @__PURE__ */ __name(() => PaginationResponseValidator, "PaginationResponseValidator"),
+      PrepareRefreshableSendInputValidator: /* @__PURE__ */ __name(() => PrepareRefreshableSendInputValidator, "PrepareRefreshableSendInputValidator"),
+      PrepareRefreshableSendResultValidator: /* @__PURE__ */ __name(() => PrepareRefreshableSendResultValidator, "PrepareRefreshableSendResultValidator"),
       ProfileValidator: /* @__PURE__ */ __name(() => ProfileValidator, "ProfileValidator"),
       ProfileVisibilityEnum: /* @__PURE__ */ __name(() => ProfileVisibilityEnum, "ProfileVisibilityEnum"),
       PromotionLevelValidator: /* @__PURE__ */ __name(() => PromotionLevelValidator, "PromotionLevelValidator"),
@@ -294,6 +307,7 @@ var require_types_cjs_development = __commonJS({
       SendAiSessionCredentialEventValidator: /* @__PURE__ */ __name(() => SendAiSessionCredentialEventValidator, "SendAiSessionCredentialEventValidator"),
       SendBoostInputValidator: /* @__PURE__ */ __name(() => SendBoostInputValidator, "SendBoostInputValidator"),
       SendBoostResponseValidator: /* @__PURE__ */ __name(() => SendBoostResponseValidator, "SendBoostResponseValidator"),
+      SendBoostTemplateValidator: /* @__PURE__ */ __name(() => SendBoostTemplateValidator, "SendBoostTemplateValidator"),
       SendBrandingOptionsValidator: /* @__PURE__ */ __name(() => SendBrandingOptionsValidator, "SendBrandingOptionsValidator"),
       SendCredentialEventValidator: /* @__PURE__ */ __name(() => SendCredentialEventValidator, "SendCredentialEventValidator"),
       SendInboxResponseValidator: /* @__PURE__ */ __name(() => SendInboxResponseValidator, "SendInboxResponseValidator"),
@@ -1023,7 +1037,7 @@ var require_types_cjs_development = __commonJS({
       getSizableOrigin: /* @__PURE__ */ __name(() => getSizableOrigin, "getSizableOrigin"),
       hexToUint8Array: /* @__PURE__ */ __name(() => hexToUint8Array, "hexToUint8Array"),
       isObject: /* @__PURE__ */ __name(() => isObject, "isObject"),
-      isPlainObject: /* @__PURE__ */ __name(() => isPlainObject, "isPlainObject"),
+      isPlainObject: /* @__PURE__ */ __name(() => isPlainObject2, "isPlainObject"),
       issue: /* @__PURE__ */ __name(() => issue, "issue"),
       joinValues: /* @__PURE__ */ __name(() => joinValues, "joinValues"),
       jsonStringifyReplacer: /* @__PURE__ */ __name(() => jsonStringifyReplacer, "jsonStringifyReplacer"),
@@ -1249,7 +1263,7 @@ var require_types_cjs_development = __commonJS({
         return false;
       }
     });
-    function isPlainObject(o) {
+    function isPlainObject2(o) {
       if (isObject(o) === false)
         return false;
       const ctor = o.constructor;
@@ -1265,10 +1279,10 @@ var require_types_cjs_development = __commonJS({
       }
       return true;
     }
-    __name(isPlainObject, "isPlainObject");
-    __name2(isPlainObject, "isPlainObject");
+    __name(isPlainObject2, "isPlainObject");
+    __name2(isPlainObject2, "isPlainObject");
     function shallowClone(o) {
-      if (isPlainObject(o))
+      if (isPlainObject2(o))
         return { ...o };
       if (Array.isArray(o))
         return [...o];
@@ -1492,7 +1506,7 @@ var require_types_cjs_development = __commonJS({
     __name(omit, "omit");
     __name2(omit, "omit");
     function extend(schema, shape) {
-      if (!isPlainObject(shape)) {
+      if (!isPlainObject2(shape)) {
         throw new Error("Invalid input to extend: expected a plain object");
       }
       const checks = schema._zod.def.checks;
@@ -1517,7 +1531,7 @@ var require_types_cjs_development = __commonJS({
     __name(extend, "extend");
     __name2(extend, "extend");
     function safeExtend(schema, shape) {
-      if (!isPlainObject(shape)) {
+      if (!isPlainObject2(shape)) {
         throw new Error("Invalid input to safeExtend: expected a plain object");
       }
       const def = mergeDefs(schema._zod.def, {
@@ -3944,7 +3958,7 @@ var require_types_cjs_development = __commonJS({
       if (a instanceof Date && b instanceof Date && +a === +b) {
         return { valid: true, data: a };
       }
-      if (isPlainObject(a) && isPlainObject(b)) {
+      if (isPlainObject2(a) && isPlainObject2(b)) {
         const bKeys = Object.keys(b);
         const sharedKeys = Object.keys(a).filter((key) => bKeys.indexOf(key) !== -1);
         const newObj = { ...a, ...b };
@@ -4140,7 +4154,7 @@ var require_types_cjs_development = __commonJS({
       $ZodType.init(inst, def);
       inst._zod.parse = (payload, ctx) => {
         const input = payload.value;
-        if (!isPlainObject(input)) {
+        if (!isPlainObject2(input)) {
           payload.issues.push({
             expected: "record",
             code: "invalid_type",
@@ -15761,14 +15775,22 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }).catchall(external_exports.any());
     var ProofValidator = external_exports.object({
       type: external_exports.string(),
-      created: external_exports.string(),
+      created: external_exports.string().optional(),
       challenge: external_exports.string().optional(),
       domain: external_exports.string().optional(),
       nonce: external_exports.string().optional(),
       proofPurpose: external_exports.string(),
       verificationMethod: external_exports.string(),
       jws: external_exports.string().optional()
-    }).catchall(external_exports.any());
+    }).catchall(external_exports.any()).superRefine((proof, ctx) => {
+      if (proof.created === void 0 && (proof.type !== "DataIntegrityProof" || proof.cryptosuite !== "ecdsa-rdfc-2019")) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["created"],
+          message: "created is required for this proof suite"
+        });
+      }
+    });
     var VCValidator = UnsignedVCValidator.extend({
       proof: ProofValidator.or(ProofValidator.array())
     });
@@ -16210,6 +16232,204 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         $or: BaseStringQuery.array()
       })
     ]);
+    var LearnCardRefreshAuthorizationValidator = external_exports.object({ type: external_exports.literal("LearnCardDIDAuth") }).catchall(external_exports.any());
+    var ManagedCredentialRefreshServiceValidator2 = external_exports.object({
+      id: external_exports.string().min(1),
+      type: external_exports.literal("LearnCardCredentialRefresh2026"),
+      authorization: LearnCardRefreshAuthorizationValidator.optional()
+    }).catchall(external_exports.any());
+    var StandardCredentialRefreshServiceValidator = external_exports.object({
+      id: external_exports.string().min(1),
+      type: external_exports.literal("1EdTechCredentialRefresh")
+    }).catchall(external_exports.any());
+    var SupportedCredentialRefreshServiceValidator2 = external_exports.union([
+      ManagedCredentialRefreshServiceValidator2,
+      StandardCredentialRefreshServiceValidator
+    ]);
+    var AllocateCredentialRefreshInputValidator = external_exports.object({
+      holder: external_exports.object({
+        profileId: external_exports.string().optional(),
+        did: external_exports.string().min(1)
+      }),
+      credentialId: external_exports.string().min(1)
+    });
+    var AllocateCredentialRefreshResultValidator = external_exports.object({
+      refreshId: external_exports.string().min(1),
+      refreshService: ManagedCredentialRefreshServiceValidator2.extend({
+        authorization: LearnCardRefreshAuthorizationValidator
+      })
+    });
+    var ManagedCredentialRefreshReceiptValidator = external_exports.object({
+      refreshId: external_exports.string().min(1),
+      refreshService: ManagedCredentialRefreshServiceValidator2,
+      credentialId: external_exports.string().min(1),
+      issuerDid: external_exports.string().min(1),
+      holderDid: external_exports.string().min(1),
+      credentialStatus: CredentialStatusValidator.or(
+        CredentialStatusValidator.array()
+      ).optional()
+    }).strip();
+    var InboxCredentialRefreshReceiptValidator = ManagedCredentialRefreshReceiptValidator.omit(
+      { holderDid: true }
+    ).extend({ holderDid: external_exports.string().min(1).optional() });
+    var CredentialRefreshSigningModeValidator = external_exports.enum(["issuer-signed", "signing-authority"]);
+    var PublishCredentialRefreshBaseFields = {
+      refreshId: external_exports.string().min(1),
+      notifyHolder: external_exports.boolean().optional(),
+      updateSummary: external_exports.string().optional(),
+      idempotencyKey: external_exports.string().optional()
+    };
+    var PublishIssuerSignedRefreshValidator = external_exports.object({
+      ...PublishCredentialRefreshBaseFields,
+      mode: external_exports.literal("issuer-signed"),
+      signedCredential: VCValidator
+    });
+    var PublishSigningAuthorityRefreshValidator = external_exports.object({
+      ...PublishCredentialRefreshBaseFields,
+      mode: external_exports.literal("signing-authority"),
+      credential: UnsignedVCValidator,
+      signingAuthority: external_exports.object({
+        type: external_exports.string().min(1)
+      }).catchall(external_exports.any())
+    });
+    var PublishCredentialRefreshInputValidator = external_exports.object({
+      ...PublishCredentialRefreshBaseFields,
+      mode: CredentialRefreshSigningModeValidator,
+      signedCredential: VCValidator.optional(),
+      credential: UnsignedVCValidator.optional(),
+      signingAuthority: external_exports.object({
+        type: external_exports.string().min(1)
+      }).catchall(external_exports.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_exports.enum([
+      "queued",
+      "suppressed",
+      "not-applicable",
+      /** Publication succeeded, but the post-commit notification enqueue must be retried. */
+      "delivery-failed"
+    ]);
+    var PublishCredentialRefreshResultValidator = external_exports.object({
+      refreshId: external_exports.string().min(1),
+      version: external_exports.number().int().positive(),
+      publishedAt: external_exports.string().min(1),
+      notification: PublishCredentialRefreshNotificationValidator
+    });
+    var CredentialRefreshVersionMetadataValidator = external_exports.object({
+      version: external_exports.number().int().positive(),
+      publishedAt: external_exports.string().min(1),
+      effectiveAt: external_exports.string().optional(),
+      etag: external_exports.string().optional(),
+      signingMode: CredentialRefreshSigningModeValidator.optional(),
+      updateSummary: external_exports.string().optional()
+    });
+    var GetCredentialRefreshHistoryInputValidator = external_exports.object({
+      refreshId: external_exports.string().min(1),
+      cursor: external_exports.string().optional(),
+      limit: external_exports.number().int().positive().optional()
+    });
+    var GetCredentialRefreshHistoryResultValidator = external_exports.object({
+      records: CredentialRefreshVersionMetadataValidator.array(),
+      hasMore: external_exports.boolean(),
+      cursor: external_exports.string().optional()
+    });
+    var CredentialRefreshChallengeValidator = external_exports.object({
+      challenge: external_exports.string().min(1),
+      expiresAt: external_exports.string().min(1),
+      domain: external_exports.string().optional(),
+      scheme: external_exports.literal("LearnCardDIDAuth").optional()
+    });
+    var PublicCredentialRefreshEnvelopeValidator = external_exports.object({
+      format: external_exports.literal("vc"),
+      credential: VCValidator,
+      etag: external_exports.string().optional()
+    });
+    var JweCredentialRefreshEnvelopeValidator = external_exports.object({
+      format: external_exports.literal("jwe"),
+      jwe: JWEValidator2,
+      etag: external_exports.string().optional(),
+      /** Present on LearnCard-managed endpoints; optional for interoperable JWE services. */
+      version: external_exports.number().int().positive().optional()
+    });
+    var CredentialRefreshResponseEnvelopeValidator = external_exports.discriminatedUnion("format", [
+      PublicCredentialRefreshEnvelopeValidator,
+      JweCredentialRefreshEnvelopeValidator
+    ]);
+    var CredentialRefreshFailureCodeValidator = external_exports.enum([
+      "UNAVAILABLE",
+      "TIMEOUT",
+      "UNSUPPORTED_SERVICE",
+      "UNAUTHORIZED",
+      "MALFORMED_RESPONSE",
+      "INVALID_PROOF",
+      "ISSUER_MISMATCH",
+      "ID_MISMATCH",
+      "ROLLBACK",
+      "REVOKED",
+      "UNSAFE_ENDPOINT"
+    ]);
+    var CredentialRefreshUpdatedResultValidator = external_exports.object({
+      status: external_exports.literal("updated"),
+      credential: VCValidator,
+      etag: external_exports.string().optional(),
+      managedVersion: external_exports.number().int().positive().optional()
+    });
+    var CredentialRefreshUnchangedResultValidator = external_exports.object({
+      status: external_exports.literal("unchanged"),
+      checkedAt: external_exports.string().min(1),
+      etag: external_exports.string().optional()
+    });
+    var CredentialRefreshUnsupportedResultValidator = external_exports.object({
+      status: external_exports.literal("unsupported")
+    });
+    var CredentialRefreshFailedResultValidator = external_exports.object({
+      status: external_exports.literal("failed"),
+      code: CredentialRefreshFailureCodeValidator,
+      retryable: external_exports.boolean()
+    });
+    var CredentialRefreshResultValidator = external_exports.discriminatedUnion("status", [
+      CredentialRefreshUpdatedResultValidator,
+      CredentialRefreshUnchangedResultValidator,
+      CredentialRefreshUnsupportedResultValidator,
+      CredentialRefreshFailedResultValidator
+    ]);
     var LCNProfileDisplayValidator = external_exports.object({
       backgroundColor: external_exports.string().optional(),
       backgroundImage: external_exports.string().optional(),
@@ -16545,7 +16765,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         "Options for email/phone recipients (Universal Inbox)"
       ),
       templateData: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
-      integrationId: external_exports.string().optional().describe("Integration ID for activity tracking")
+      integrationId: external_exports.string().optional().describe("Integration ID for activity tracking"),
+      refresh: external_exports.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_exports.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"]
@@ -16560,8 +16786,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_exports.object({
+      refresh: InboxCredentialRefreshReceiptValidator.optional(),
       issuanceId: external_exports.string(),
       status: external_exports.enum(["PENDING", "ISSUED", "EXPIRED", "DELIVERED", "CLAIMED"]),
       claimUrl: external_exports.string().url().optional().describe("Present when suppressDelivery=true"),
@@ -16576,8 +16806,34 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       activityId: external_exports.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_exports.object({
+      recipient: external_exports.string(),
+      templateUri: external_exports.string().optional(),
+      template: SendBoostTemplateValidator.optional(),
+      contractUri: external_exports.string().optional(),
+      templateData: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+      integrationId: external_exports.string().optional(),
+      /** Credential ID to allocate for; generated server-side when omitted. */
+      credentialId: external_exports.string().min(1).optional(),
+      idempotencyKey: external_exports.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_exports.object({
+      boostUri: external_exports.string(),
+      credentialId: external_exports.string(),
+      refreshId: external_exports.string(),
+      refreshService: ManagedCredentialRefreshServiceValidator2,
+      /** The DID to use as credentialSubject.id (recipient DID, or the profile's did:web). */
+      holderDid: external_exports.string(),
+      /** Present when this idempotencyKey already completed: return it without signing. */
+      completed: SendBoostResponseValidator.optional()
+    });
     var SendInputValidator = external_exports.discriminatedUnion("type", [SendBoostInputValidator]);
     var SendResponseValidator = external_exports.discriminatedUnion("type", [SendBoostResponseValidator]);
     var ConsentFlowTermsStatusValidator = external_exports.enum(["live", "stale", "withdrawn"]);
@@ -16653,15 +16909,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     var PaginatedConsentFlowDataValidator = PaginationResponseValidator.extend({
       records: ConsentFlowContractDataValidator.array()
     });
-    var ConsentFlowContractDataForDidValidator = external_exports.object({
-      credentials: external_exports.object({ category: external_exports.string(), uri: external_exports.string() }).array(),
-      personal: external_exports.record(external_exports.string(), external_exports.string()).default({}),
-      date: external_exports.string(),
-      contractUri: external_exports.string()
-    });
-    var PaginatedConsentFlowDataForDidValidator = PaginationResponseValidator.extend({
-      records: ConsentFlowContractDataForDidValidator.array()
-    });
     var ConsentFlowTermValidator = external_exports.object({
       sharing: external_exports.boolean().optional(),
       shared: external_exports.string().array().optional(),
@@ -16695,6 +16942,34 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         status: ConsentFlowTermsStatusValidator
       }).array()
     });
+    var ConsentFlowGuardianApprovalValidator = external_exports.object({
+      guardianProfileId: external_exports.string(),
+      guardianDid: external_exports.string(),
+      approvedAt: external_exports.string().datetime(),
+      contractUpdatedAt: external_exports.string()
+    });
+    var ConsentFlowContractDataForDidValidator = external_exports.object({
+      credentials: external_exports.object({ category: external_exports.string(), uri: external_exports.string() }).array(),
+      personal: external_exports.record(external_exports.string(), external_exports.string()).default({}),
+      date: external_exports.string(),
+      createdAt: external_exports.string().optional(),
+      contractUpdatedAt: external_exports.string(),
+      contractExpiresAt: external_exports.string().optional(),
+      reasonForAccessing: external_exports.string().optional(),
+      guardian: external_exports.object({
+        required: external_exports.boolean(),
+        approved: external_exports.boolean(),
+        approval: ConsentFlowGuardianApprovalValidator.optional()
+      }),
+      contractUri: external_exports.string(),
+      termsUri: external_exports.string(),
+      status: ConsentFlowTermsStatusValidator,
+      expiresAt: external_exports.string().optional(),
+      terms: ConsentFlowTermsValidator
+    });
+    var PaginatedConsentFlowDataForDidValidator = PaginationResponseValidator.extend({
+      records: ConsentFlowContractDataForDidValidator.array()
+    });
     var ConsentFlowContractQueryValidator = external_exports.object({
       read: external_exports.object({
         anonymize: external_exports.boolean().optional(),
@@ -16755,6 +17030,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       expiresAt: external_exports.string().optional(),
       oneTime: external_exports.boolean().optional(),
       terms: ConsentFlowTermsValidator.optional(),
+      guardianApproval: ConsentFlowGuardianApprovalValidator.optional(),
       id: external_exports.string(),
       action: ConsentFlowTransactionActionValidator,
       date: external_exports.string(),
@@ -16876,6 +17152,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       webhookUrl: external_exports.string().optional()
     });
     var AUTH_GRANT_AUDIENCE_DOMAIN_PREFIX = "auth-grant:";
+    var ACT_AS_HEADER = "X-LearnCard-Act-As";
     var AuthGrantValidator = external_exports.object({
       id: external_exports.string(),
       name: external_exports.string(),
@@ -16888,6 +17165,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         }, "error")
       }),
       scope: external_exports.string(),
+      actAs: external_exports.string().optional(),
       createdAt: external_exports.iso.datetime({ error: "createdAt must be a valid ISO 8601 datetime string" }),
       expiresAt: external_exports.iso.datetime({ error: "expiresAt must be a valid ISO 8601 datetime string" }).nullish().optional()
     });
@@ -16959,6 +17237,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       sessionJwt: external_exports.string()
     });
     var InboxCredentialValidator = external_exports.object({
+      refresh: InboxCredentialRefreshReceiptValidator.optional(),
+      refreshId: external_exports.string().optional(),
       id: external_exports.string(),
       credential: external_exports.string().optional(),
       isSigned: external_exports.boolean(),
@@ -17013,12 +17293,19 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       templateUri: external_exports.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_exports.boolean().optional().describe(
+        "Allocate managed refresh before signing. Requires unsigned content and a registered signing authority; binds the holder on claim."
+      ),
+      idempotencyKey: external_exports.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_exports.object({
+        guardianEmail: external_exports.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."
         ),
@@ -17072,17 +17359,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_exports.object({
+      refresh: InboxCredentialRefreshReceiptValidator.optional(),
       issuanceId: external_exports.string(),
       status: LCNInboxStatusEnumValidator,
       recipient: ContactMethodQueryValidator,
       claimUrl: external_exports.string().url().optional(),
       recipientDid: external_exports.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_exports.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_exports.object({
+      ...IssueInboxCredentialValidator.shape,
+      configuration: InboxBatchItemConfigurationValidator.optional(),
+      idempotencyKey: external_exports.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_exports.object({
+      requestId: external_exports.string().min(1).max(256).optional(),
+      items: external_exports.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_exports.enum([
+      "DUPLICATE_KEY",
+      "IDEMPOTENCY_MISMATCH",
+      "IN_PROGRESS",
+      "UNCONFIRMED"
+    ]);
+    var IssueInboxCredentialBatchItemResultValidator = external_exports.discriminatedUnion("success", [
+      IssueInboxCredentialResponseValidator.extend({
+        success: external_exports.literal(true),
+        index: external_exports.number().int().nonnegative(),
+        deduplicated: external_exports.boolean().optional(),
+        guardianStatus: GuardianStatusValidator.optional(),
+        idempotencyKey: external_exports.string().optional()
+      }),
+      external_exports.object({
+        success: external_exports.literal(false),
+        index: external_exports.number().int().nonnegative(),
+        idempotencyKey: external_exports.string().optional(),
+        recipient: ContactMethodQueryValidator.optional(),
+        error: external_exports.object({
+          code: external_exports.string(),
+          message: external_exports.string(),
+          reason: InboxBatchErrorReasonValidator.optional()
+        }),
+        issuanceId: external_exports.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_exports.string().url().optional().describe(
+          "Claim URL of the completed issuance, if available, when replay storage could not be confirmed."
+        )
+      })
+    ]);
+    var IssueInboxCredentialBatchResponseValidator = external_exports.object({
+      results: external_exports.array(IssueInboxCredentialBatchItemResultValidator),
+      summary: external_exports.object({
+        total: external_exports.number(),
+        succeeded: external_exports.number(),
+        failed: external_exports.number(),
+        deduplicated: external_exports.number()
+      })
+    });
+    var InboxBatchReceiptValidator = external_exports.object({
+      batchId: external_exports.string(),
+      status: external_exports.enum(["QUEUED", "PROCESSING", "COMPLETED", "NEEDS_RECONCILIATION"]),
+      createdAt: external_exports.string()
+    });
+    var InboxBatchStatusValidator = external_exports.object({
+      batchId: external_exports.string(),
+      createdAt: external_exports.string(),
+      done: external_exports.boolean().describe(
+        "True when no queued or processing items remain, including unconfirmed outcomes."
+      ),
+      status: external_exports.enum(["QUEUED", "PROCESSING", "COMPLETED", "NEEDS_RECONCILIATION"]),
+      items: external_exports.array(
+        external_exports.object({
+          index: external_exports.number().int().nonnegative(),
+          state: external_exports.enum(["QUEUED", "PROCESSING", "COMPLETED", "NEEDS_RECONCILIATION"]),
+          result: IssueInboxCredentialBatchItemResultValidator.optional()
+        })
+      ),
+      summary: IssueInboxCredentialBatchResponseValidator.shape.summary.extend({
+        completed: external_exports.number(),
+        pending: external_exports.number(),
+        unconfirmed: external_exports.number()
+      })
+    });
     var CredentialNameRefValidator = external_exports.object({ name: external_exports.string() }).passthrough();
     var ClaimInboxCredentialValidator = external_exports.object({
       credential: VCValidator.or(VPValidator).or(UnsignedVCValidator).or(CredentialNameRefValidator).describe("The credential to issue, or a { name } reference to resolve a boost template."),
@@ -17568,6 +17968,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       eventType: CredentialActivityEventTypeValidator,
       timestamp: external_exports.string(),
       actorProfileId: external_exports.string().optional(),
+      onBehalfOf: external_exports.string().optional(),
       recipientType: CredentialActivityRecipientTypeValidator,
       recipientIdentifier: external_exports.string(),
       boostUri: external_exports.string().optional(),
@@ -17728,191 +18129,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_exports.object({ type: external_exports.literal("LearnCardDIDAuth") }).catchall(external_exports.any());
-    var ManagedCredentialRefreshServiceValidator = external_exports.object({
-      id: external_exports.string().min(1),
-      type: external_exports.literal("LearnCardCredentialRefresh2026"),
-      authorization: LearnCardRefreshAuthorizationValidator.optional()
-    }).catchall(external_exports.any());
-    var StandardCredentialRefreshServiceValidator = external_exports.object({
-      id: external_exports.string().min(1),
-      type: external_exports.literal("1EdTechCredentialRefresh")
-    }).catchall(external_exports.any());
-    var SupportedCredentialRefreshServiceValidator2 = external_exports.union([
-      ManagedCredentialRefreshServiceValidator,
-      StandardCredentialRefreshServiceValidator
-    ]);
-    var AllocateCredentialRefreshInputValidator = external_exports.object({
-      holder: external_exports.object({
-        profileId: external_exports.string().optional(),
-        did: external_exports.string().min(1)
-      }),
-      credentialId: external_exports.string().min(1)
-    });
-    var AllocateCredentialRefreshResultValidator = external_exports.object({
-      refreshId: external_exports.string().min(1),
-      refreshService: ManagedCredentialRefreshServiceValidator.extend({
-        authorization: LearnCardRefreshAuthorizationValidator
-      })
-    });
-    var CredentialRefreshSigningModeValidator = external_exports.enum(["issuer-signed", "signing-authority"]);
-    var PublishCredentialRefreshBaseFields = {
-      refreshId: external_exports.string().min(1),
-      notifyHolder: external_exports.boolean().optional(),
-      updateSummary: external_exports.string().optional(),
-      idempotencyKey: external_exports.string().optional()
-    };
-    var PublishIssuerSignedRefreshValidator = external_exports.object({
-      ...PublishCredentialRefreshBaseFields,
-      mode: external_exports.literal("issuer-signed"),
-      signedCredential: VCValidator
-    });
-    var PublishSigningAuthorityRefreshValidator = external_exports.object({
-      ...PublishCredentialRefreshBaseFields,
-      mode: external_exports.literal("signing-authority"),
-      credential: UnsignedVCValidator,
-      signingAuthority: external_exports.object({
-        type: external_exports.string().min(1)
-      }).catchall(external_exports.any())
-    });
-    var PublishCredentialRefreshInputValidator = external_exports.object({
-      ...PublishCredentialRefreshBaseFields,
-      mode: CredentialRefreshSigningModeValidator,
-      signedCredential: VCValidator.optional(),
-      credential: UnsignedVCValidator.optional(),
-      signingAuthority: external_exports.object({
-        type: external_exports.string().min(1)
-      }).catchall(external_exports.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_exports.enum([
-      "queued",
-      "suppressed",
-      "not-applicable",
-      /** Publication succeeded, but the post-commit notification enqueue must be retried. */
-      "delivery-failed"
-    ]);
-    var PublishCredentialRefreshResultValidator = external_exports.object({
-      refreshId: external_exports.string().min(1),
-      version: external_exports.number().int().positive(),
-      publishedAt: external_exports.string().min(1),
-      notification: PublishCredentialRefreshNotificationValidator
-    });
-    var CredentialRefreshVersionMetadataValidator = external_exports.object({
-      version: external_exports.number().int().positive(),
-      publishedAt: external_exports.string().min(1),
-      effectiveAt: external_exports.string().optional(),
-      etag: external_exports.string().optional(),
-      signingMode: CredentialRefreshSigningModeValidator.optional(),
-      updateSummary: external_exports.string().optional()
-    });
-    var GetCredentialRefreshHistoryInputValidator = external_exports.object({
-      refreshId: external_exports.string().min(1),
-      cursor: external_exports.string().optional(),
-      limit: external_exports.number().int().positive().optional()
-    });
-    var GetCredentialRefreshHistoryResultValidator = external_exports.object({
-      records: CredentialRefreshVersionMetadataValidator.array(),
-      hasMore: external_exports.boolean(),
-      cursor: external_exports.string().optional()
-    });
-    var CredentialRefreshChallengeValidator = external_exports.object({
-      challenge: external_exports.string().min(1),
-      expiresAt: external_exports.string().min(1),
-      domain: external_exports.string().optional(),
-      scheme: external_exports.literal("LearnCardDIDAuth").optional()
-    });
-    var PublicCredentialRefreshEnvelopeValidator = external_exports.object({
-      format: external_exports.literal("vc"),
-      credential: VCValidator,
-      etag: external_exports.string().optional()
-    });
-    var JweCredentialRefreshEnvelopeValidator = external_exports.object({
-      format: external_exports.literal("jwe"),
-      jwe: JWEValidator2,
-      etag: external_exports.string().optional(),
-      /** Present on LearnCard-managed endpoints; optional for interoperable JWE services. */
-      version: external_exports.number().int().positive().optional()
-    });
-    var CredentialRefreshResponseEnvelopeValidator = external_exports.discriminatedUnion("format", [
-      PublicCredentialRefreshEnvelopeValidator,
-      JweCredentialRefreshEnvelopeValidator
-    ]);
-    var CredentialRefreshFailureCodeValidator = external_exports.enum([
-      "UNAVAILABLE",
-      "TIMEOUT",
-      "UNSUPPORTED_SERVICE",
-      "UNAUTHORIZED",
-      "MALFORMED_RESPONSE",
-      "INVALID_PROOF",
-      "ISSUER_MISMATCH",
-      "ID_MISMATCH",
-      "ROLLBACK",
-      "REVOKED",
-      "UNSAFE_ENDPOINT"
-    ]);
-    var CredentialRefreshUpdatedResultValidator = external_exports.object({
-      status: external_exports.literal("updated"),
-      credential: VCValidator,
-      etag: external_exports.string().optional(),
-      managedVersion: external_exports.number().int().positive().optional()
-    });
-    var CredentialRefreshUnchangedResultValidator = external_exports.object({
-      status: external_exports.literal("unchanged"),
-      checkedAt: external_exports.string().min(1),
-      etag: external_exports.string().optional()
-    });
-    var CredentialRefreshUnsupportedResultValidator = external_exports.object({
-      status: external_exports.literal("unsupported")
-    });
-    var CredentialRefreshFailedResultValidator = external_exports.object({
-      status: external_exports.literal("failed"),
-      code: CredentialRefreshFailureCodeValidator,
-      retryable: external_exports.boolean()
-    });
-    var CredentialRefreshResultValidator = external_exports.discriminatedUnion("status", [
-      CredentialRefreshUpdatedResultValidator,
-      CredentialRefreshUnchangedResultValidator,
-      CredentialRefreshUnsupportedResultValidator,
-      CredentialRefreshFailedResultValidator
-    ]);
   }
 });
 
@@ -18814,6 +19030,134 @@ var canonicalizeCredentialContent = /* @__PURE__ */ __name((value) => {
   return value;
 }, "canonicalizeCredentialContent");
 var canonicalizeCredentialJson = /* @__PURE__ */ __name((value) => JSON.stringify(canonicalizeCredentialContent(value)), "canonicalizeCredentialJson");
+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 isPlainObject = /* @__PURE__ */ __name((value) => !!value && typeof value === "object" && !Array.isArray(value), "isPlainObject");
+var toIdForm = /* @__PURE__ */ __name((definition) => typeof definition === "string" ? { "@id": definition } : definition, "toIdForm");
+var definitionId = /* @__PURE__ */ __name((definition) => {
+  const idForm = toIdForm(definition);
+  return isPlainObject(idForm) ? idForm["@id"] : void 0;
+}, "definitionId");
+var findTopLevelDefinition = /* @__PURE__ */ __name((contextObjects, term) => {
+  let found;
+  for (const contextObject of contextObjects) {
+    if (term in contextObject) found = contextObject[term];
+  }
+  return found;
+}, "findTopLevelDefinition");
+var assertDefinitionMatchesIri = /* @__PURE__ */ __name((term, definition, expectedIri) => {
+  const actualIri = definitionId(definition);
+  if (actualIri !== expectedIri) {
+    throw new Error(
+      `Conflicting JSON-LD definition for term "${term}": expected "${expectedIri}" but the credential already defines it as ${JSON.stringify(
+        definition
+      )}. Remove or correct the existing definition before signing.`
+    );
+  }
+}, "assertDefinitionMatchesIri");
+var getManagedRefreshServices = /* @__PURE__ */ __name((vc) => {
+  const refreshService = vc?.refreshService;
+  if (!refreshService) return [];
+  const services = Array.isArray(refreshService) ? refreshService : [refreshService];
+  return services.flatMap((service) => {
+    const parsed = import_types2.ManagedCredentialRefreshServiceValidator.safeParse(service);
+    return parsed.success ? [parsed.data] : [];
+  });
+}, "getManagedRefreshServices");
+var prepareManagedRefreshContext = /* @__PURE__ */ __name((credential) => {
+  const source = credential;
+  if (getManagedRefreshServices(source).length === 0) return credential;
+  const existingContext = credential["@context"];
+  const contextList = existingContext === void 0 || existingContext === null ? [] : Array.isArray(existingContext) ? [...existingContext] : [existingContext];
+  const inlineObjects = contextList.filter(isPlainObject);
+  const fragment = {};
+  const typeDefinition = findTopLevelDefinition(inlineObjects, MANAGED_REFRESH_TYPE_TERM);
+  if (typeDefinition === void 0) {
+    fragment[MANAGED_REFRESH_TYPE_TERM] = MANAGED_REFRESH_TYPE_IRI;
+  } else {
+    assertDefinitionMatchesIri(
+      MANAGED_REFRESH_TYPE_TERM,
+      typeDefinition,
+      MANAGED_REFRESH_TYPE_IRI
+    );
+  }
+  const authorizationDefinition = findTopLevelDefinition(inlineObjects, "authorization");
+  let didAuthCovered = false;
+  if (authorizationDefinition === void 0) {
+    fragment["authorization"] = MANAGED_REFRESH_SERVICE_CONTEXT.authorization;
+    didAuthCovered = true;
+  } else {
+    assertDefinitionMatchesIri(
+      "authorization",
+      authorizationDefinition,
+      MANAGED_REFRESH_AUTHORIZATION_IRI
+    );
+    if (isPlainObject(authorizationDefinition) && isPlainObject(authorizationDefinition["@context"])) {
+      const scopedContext = authorizationDefinition["@context"];
+      if (MANAGED_REFRESH_DID_AUTH_TERM in scopedContext) {
+        assertDefinitionMatchesIri(
+          MANAGED_REFRESH_DID_AUTH_TERM,
+          scopedContext[MANAGED_REFRESH_DID_AUTH_TERM],
+          MANAGED_REFRESH_DID_AUTH_IRI
+        );
+        didAuthCovered = true;
+      }
+    }
+  }
+  if (!didAuthCovered) {
+    const didAuthDefinition = findTopLevelDefinition(
+      inlineObjects,
+      MANAGED_REFRESH_DID_AUTH_TERM
+    );
+    if (didAuthDefinition === void 0) {
+      fragment[MANAGED_REFRESH_DID_AUTH_TERM] = MANAGED_REFRESH_DID_AUTH_IRI;
+    } else {
+      assertDefinitionMatchesIri(
+        MANAGED_REFRESH_DID_AUTH_TERM,
+        didAuthDefinition,
+        MANAGED_REFRESH_DID_AUTH_IRI
+      );
+    }
+  }
+  if (Object.keys(fragment).length === 0) return credential;
+  return {
+    ...credential,
+    "@context": [...contextList, fragment]
+  };
+}, "prepareManagedRefreshContext");
+var injectManagedRefreshService = /* @__PURE__ */ __name((credential, refreshService) => {
+  const service = import_types2.ManagedCredentialRefreshServiceValidator.parse(refreshService);
+  const source = credential;
+  const existing = source["refreshService"];
+  const existingServices = existing === void 0 || existing === null ? [] : Array.isArray(existing) ? [...existing] : [existing];
+  const existingManaged = getManagedRefreshServices({ refreshService: existingServices });
+  if (existingManaged.some((entry) => entry.id !== service.id)) {
+    throw new Error(
+      "Credential already carries a different managed refresh service; a credential can only reference one managed refresh service."
+    );
+  }
+  const nonManagedEntries = existingServices.filter(
+    (entry) => !import_types2.ManagedCredentialRefreshServiceValidator.safeParse(entry).success
+  );
+  const mergedRefreshService = existingServices.length === 0 ? service : !Array.isArray(existing) && existingManaged.length > 0 ? (
+    // Re-injecting the same managed service: keep object form (idempotent)
+    service
+  ) : [service, ...nonManagedEntries];
+  return prepareManagedRefreshContext({
+    ...credential,
+    refreshService: mergedRefreshService
+  });
+}, "injectManagedRefreshService");
 var credentialContentsEqual = /* @__PURE__ */ __name((first, second) => {
   const stripProof = /* @__PURE__ */ __name((vc) => {
     const { proof: _proof, ...rest } = vc ?? {};
@@ -18936,6 +19280,10 @@ export {
   ImageResizingValidator,
   ImageUploadingValidator,
   ImageWithLoadingStateValdator,
+  MANAGED_REFRESH_AUTHORIZATION_IRI,
+  MANAGED_REFRESH_DID_AUTH_IRI,
+  MANAGED_REFRESH_SERVICE_CONTEXT,
+  MANAGED_REFRESH_TYPE_IRI,
   RegExpTransformer,
   calculateAgeFromDob,
   canonicalizeCredentialContent,
@@ -18968,10 +19316,12 @@ export {
   getCredentialIssuerId,
   getCredentialStatusArray,
   getDidWeb,
+  getManagedRefreshServices,
   getProvider,
   getSupportedRefreshService,
   getUrlsFromSrcSet,
   immerArraySlice,
+  injectManagedRefreshService,
   innerImmerOuterImmer,
   innerImmerOuterReact,
   innerReactOuterImmer,
@@ -18988,6 +19338,7 @@ export {
   optionalEnvironmentString,
   optionalEnvironmentUrl,
   parseEnvironment,
+  prepareManagedRefreshContext,
   projectEnvelopeToDisplayVc,
   quantizeValue,
   requiredEnvironmentString,