@learncard/helpers 1.3.0 → 1.3.2

package/dist/helpers.cjs.development.js

@@ -143,6 +143,7 @@ var require_types_cjs_development = __commonJS({
       CredentialActivityStatsValidator: /* @__PURE__ */ __name(() => CredentialActivityStatsValidator, "CredentialActivityStatsValidator"),
       CredentialActivityValidator: /* @__PURE__ */ __name(() => CredentialActivityValidator, "CredentialActivityValidator"),
       CredentialActivityWithDetailsValidator: /* @__PURE__ */ __name(() => CredentialActivityWithDetailsValidator, "CredentialActivityWithDetailsValidator"),
+      CredentialFormatValidator: /* @__PURE__ */ __name(() => CredentialFormatValidator, "CredentialFormatValidator"),
       CredentialInfoValidator: /* @__PURE__ */ __name(() => CredentialInfoValidator, "CredentialInfoValidator"),
       CredentialNameRefValidator: /* @__PURE__ */ __name(() => CredentialNameRefValidator, "CredentialNameRefValidator"),
       CredentialRecordValidator: /* @__PURE__ */ __name(() => CredentialRecordValidator, "CredentialRecordValidator"),
@@ -171,6 +172,8 @@ var require_types_cjs_development = __commonJS({
       GetSkillPathResultValidator: /* @__PURE__ */ __name(() => GetSkillPathResultValidator, "GetSkillPathResultValidator"),
       GetTemplateRecipientsEventValidator: /* @__PURE__ */ __name(() => GetTemplateRecipientsEventValidator, "GetTemplateRecipientsEventValidator"),
       GuardianStatusValidator: /* @__PURE__ */ __name(() => GuardianStatusValidator, "GuardianStatusValidator"),
+      HolderExportConsentRecordValidator: /* @__PURE__ */ __name(() => HolderExportConsentRecordValidator, "HolderExportConsentRecordValidator"),
+      HolderExportMetadataValidator: /* @__PURE__ */ __name(() => HolderExportMetadataValidator, "HolderExportMetadataValidator"),
       IdentifierEntryValidator: /* @__PURE__ */ __name(() => IdentifierEntryValidator, "IdentifierEntryValidator"),
       IdentifierTypeValidator: /* @__PURE__ */ __name(() => IdentifierTypeValidator, "IdentifierTypeValidator"),
       IdentityObjectValidator: /* @__PURE__ */ __name(() => IdentityObjectValidator, "IdentityObjectValidator"),
@@ -250,6 +253,7 @@ var require_types_cjs_development = __commonJS({
       RefreshServiceValidator: /* @__PURE__ */ __name(() => RefreshServiceValidator, "RefreshServiceValidator"),
       RegExpValidator: /* @__PURE__ */ __name(() => RegExpValidator, "RegExpValidator"),
       RelatedValidator: /* @__PURE__ */ __name(() => RelatedValidator, "RelatedValidator"),
+      RenderMethodValidator: /* @__PURE__ */ __name(() => RenderMethodValidator, "RenderMethodValidator"),
       ReplaceSkillFrameworkSkillsInputValidator: /* @__PURE__ */ __name(() => ReplaceSkillFrameworkSkillsInputValidator, "ReplaceSkillFrameworkSkillsInputValidator"),
       ReplaceSkillFrameworkSkillsResultValidator: /* @__PURE__ */ __name(() => ReplaceSkillFrameworkSkillsResultValidator, "ReplaceSkillFrameworkSkillsResultValidator"),
       RequestLearnerContextEventValidator: /* @__PURE__ */ __name(() => RequestLearnerContextEventValidator, "RequestLearnerContextEventValidator"),
@@ -292,6 +296,7 @@ var require_types_cjs_development = __commonJS({
       SummaryCredentialKeywordValidator: /* @__PURE__ */ __name(() => SummaryCredentialKeywordValidator, "SummaryCredentialKeywordValidator"),
       SyncFrameworkInputValidator: /* @__PURE__ */ __name(() => SyncFrameworkInputValidator, "SyncFrameworkInputValidator"),
       TagValidator: /* @__PURE__ */ __name(() => TagValidator, "TagValidator"),
+      TemplateRenderMethodValidator: /* @__PURE__ */ __name(() => TemplateRenderMethodValidator, "TemplateRenderMethodValidator"),
       TermsOfUseValidator: /* @__PURE__ */ __name(() => TermsOfUseValidator, "TermsOfUseValidator"),
       UnsignedAchievementCredentialValidator: /* @__PURE__ */ __name(() => UnsignedAchievementCredentialValidator, "UnsignedAchievementCredentialValidator"),
       UnsignedClrCredentialValidator: /* @__PURE__ */ __name(() => UnsignedClrCredentialValidator, "UnsignedClrCredentialValidator"),
@@ -13771,6 +13776,19 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       genre: external_exports.string().optional(),
       audience: external_exports.string().optional()
     }).catchall(external_exports.any());
+    var TemplateRenderMethodValidator = external_exports.object({
+      type: external_exports.literal("TemplateRenderMethod"),
+      renderSuite: external_exports.string(),
+      template: external_exports.string(),
+      renderProperty: external_exports.array(external_exports.string()).optional(),
+      outputPreference: external_exports.object({
+        mediaType: external_exports.string()
+      }).optional()
+    });
+    var RenderMethodValidator = external_exports.union([
+      TemplateRenderMethodValidator,
+      external_exports.record(external_exports.string(), external_exports.any())
+    ]);
     var UnsignedVCValidator = external_exports.object({
       "@context": ContextValidator,
       id: external_exports.string().optional(),
@@ -13794,7 +13812,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       validUntil: external_exports.string().optional(),
       status: CredentialStatusValidator.or(CredentialStatusValidator.array()).optional(),
       termsOfUse: TermsOfUseValidator.or(TermsOfUseValidator.array()).optional(),
-      evidence: external_exports.union([VC2EvidenceValidator, external_exports.array(VC2EvidenceValidator)]).optional()
+      evidence: external_exports.union([VC2EvidenceValidator, external_exports.array(VC2EvidenceValidator)]).optional(),
+      renderMethod: external_exports.union([RenderMethodValidator, external_exports.array(RenderMethodValidator)]).optional()
     }).catchall(external_exports.any());
     var ProofValidator = external_exports.object({
       type: external_exports.string(),
@@ -14102,17 +14121,52 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     var ClrCredentialValidator = UnsignedClrCredentialValidator.extend({
       proof: ProofValidator.or(ProofValidator.array())
     });
+    var CredentialFormatValidator = external_exports.enum([
+      "w3c-vc-2.0",
+      "w3c-vc-1.1",
+      "jwt-vc-json",
+      "dc+sd-jwt",
+      "vc+sd-jwt",
+      "mso_mdoc"
+    ]);
     var StatusCheckEntryValidator = external_exports.object({
+      /**
+       * The `credentialStatus.type` as it appeared on the credential.
+       * One of `BitstringStatusListEntry`, `StatusList2021Entry`,
+       * `RevocationList2020Status`, or any future custom status type.
+       */
       entryType: external_exports.string(),
+      /**
+       * The claimed purpose of the entry. Standard values are
+       * `"revocation"` and `"suspension"`; the spec allows arbitrary
+       * strings.
+       */
       statusPurpose: external_exports.string(),
+      /**
+       * Whether the bit at the credential's index in the status list
+       * bitstring was set.
+       */
       isSet: external_exports.boolean(),
+      /** URL of the status list credential, when known. */
       statusListCredential: external_exports.string().optional(),
+      /** Original (string) index within the status list. */
       statusListIndex: external_exports.string().optional()
     });
     var VerificationCheckValidator = external_exports.object({
       checks: external_exports.string().array(),
       warnings: external_exports.string().array(),
       errors: external_exports.string().array(),
+      /**
+       * Per-entry results for the `credentialStatus` check, populated
+       * by `@learncard/didkit-plugin` when the verified credential
+       * carries one or more `credentialStatus` entries. Empty / absent
+       * for credentials without a status entry.
+       *
+       * Marked `.optional()` because the underlying `ssi-ldp`
+       * serializer omits the field when empty (`skip_serializing_if`),
+       * so older WASM builds that pre-date the structured-status
+       * change still validate against this schema.
+       */
       status: StatusCheckEntryValidator.array().optional()
     });
     var VerificationStatusValidator = external_exports.enum(["Success", "Failed", "Error"]);
@@ -14130,7 +14184,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       issuee: ProfileValidator.optional(),
       credentialSubject: CredentialSubjectValidator.optional()
     });
-    var CredentialRecordValidator = external_exports.object({ id: external_exports.string(), uri: external_exports.string() }).catchall(external_exports.any());
+    var CredentialRecordValidator = external_exports.object({
+      id: external_exports.string(),
+      uri: external_exports.string(),
+      format: CredentialFormatValidator.optional(),
+      semanticType: external_exports.string().optional(),
+      rawWireForm: external_exports.string().optional()
+    }).catchall(external_exports.any());
     var PaginationOptionsValidator = external_exports.object({
       limit: external_exports.number(),
       cursor: external_exports.string().optional(),
@@ -14698,6 +14758,22 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       date: external_exports.string(),
       uris: external_exports.string().array().optional()
     });
+    var HolderExportConsentRecordValidator = external_exports.object({
+      termsUri: external_exports.string(),
+      status: ConsentFlowTermsStatusValidator,
+      contract: ConsentFlowContractDetailsValidator,
+      terms: ConsentFlowTermsValidator,
+      transactions: ConsentFlowTransactionValidator.array()
+    });
+    var HolderExportMetadataValidator = external_exports.object({
+      consentRecords: HolderExportConsentRecordValidator.array(),
+      truncated: external_exports.boolean().optional(),
+      warnings: external_exports.string().array().optional(),
+      limits: external_exports.object({
+        maxConsentRecords: external_exports.number(),
+        maxTransactionsPerConsentRecord: external_exports.number()
+      }).optional()
+    });
     var PaginatedConsentFlowTransactionsValidator = PaginationResponseValidator.extend({
       records: ConsentFlowTransactionValidator.array()
     });
@@ -14784,10 +14860,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     var LCNNotificationValidator = external_exports.object({
       type: LCNNotificationTypeEnumValidator,
       to: LCNProfileValidator.partial().and(external_exports.object({ did: external_exports.string() })),
-      from: external_exports.union([
-        external_exports.string(),
-        LCNProfileValidator.partial().and(external_exports.object({ did: external_exports.string() }))
-      ]),
+      from: external_exports.union([external_exports.string(), LCNProfileValidator.partial().and(external_exports.object({ did: external_exports.string() }))]),
       message: LCNNotificationMessageValidator.optional(),
       data: LCNNotificationDataValidator.optional(),
       sent: external_exports.iso.datetime().optional(),
@@ -15604,6 +15677,7 @@ __export(index_exports, {
   quantizeValue: () => quantizeValue,
   resizeAndChangeQuality: () => resizeAndChangeQuality4,
   setBitstringStatusListBit: () => setBitstringStatusListBit,
+  toStoredCredential: () => toStoredCredential,
   unwrapBoostCredential: () => unwrapBoostCredential
 });
 module.exports = __toCommonJS(index_exports);
@@ -16544,6 +16618,78 @@ var calculateAgeFromDob = /* @__PURE__ */ __name((dob) => {
   return age;
 }, "calculateAgeFromDob");
 
+// src/credential-format.ts
+var toStoredCredential = /* @__PURE__ */ __name((record) => {
+  if (record.format) {
+    if (record.format === "dc+sd-jwt" || record.format === "vc+sd-jwt" || record.format === "jwt-vc-json" || record.format === "mso_mdoc") {
+      const wireForm = record.rawWireForm ?? extractWireFormFromVc(record.vc);
+      if (typeof wireForm === "string" && wireForm.length > 0) {
+        return { format: record.format, data: wireForm };
+      }
+    }
+    if (record.format === "w3c-vc-2.0" || record.format === "w3c-vc-1.1") {
+      return { format: record.format, data: record.vc };
+    }
+  }
+  const vc = record.vc;
+  if (typeof vc === "string") {
+    if (looksLikeSdJwtCompact(vc)) {
+      return { format: "dc+sd-jwt", data: vc };
+    }
+    if (looksLikeJwsCompact(vc)) {
+      return { format: "jwt-vc-json", data: vc };
+    }
+  }
+  if (vc && typeof vc === "object") {
+    const proof = getWireFormProof(vc, true);
+    const wireFromProof = getWireFormFromProof(proof);
+    if (wireFromProof) {
+      const proofType = proof?.type;
+      if (proofType === "SdJwtCompactProof") {
+        return { format: "dc+sd-jwt", data: wireFromProof };
+      }
+      if (proofType === "JwtProof2020") {
+        return { format: "jwt-vc-json", data: wireFromProof };
+      }
+    }
+    const inferred = inferW3cVersionFromContext(vc);
+    return { format: inferred, data: vc };
+  }
+  return { format: "w3c-vc-1.1", data: vc };
+}, "toStoredCredential");
+var SD_JWT_COMPACT_RE = /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+~/;
+var JWS_COMPACT_RE = /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/;
+var looksLikeSdJwtCompact = /* @__PURE__ */ __name((value) => SD_JWT_COMPACT_RE.test(value), "looksLikeSdJwtCompact");
+var looksLikeJwsCompact = /* @__PURE__ */ __name((value) => JWS_COMPACT_RE.test(value), "looksLikeJwsCompact");
+var getWireFormProof = /* @__PURE__ */ __name((vc, requireSupportedType = false) => {
+  if (!vc || typeof vc !== "object") return void 0;
+  const proof = vc.proof;
+  if (Array.isArray(proof)) {
+    for (const entry of proof) {
+      const proofObject2 = asWireFormProof(entry);
+      if (proofObject2 && isUsableWireFormProof(proofObject2, requireSupportedType)) {
+        return proofObject2;
+      }
+    }
+    return void 0;
+  }
+  const proofObject = asWireFormProof(proof);
+  return proofObject && isUsableWireFormProof(proofObject, requireSupportedType) ? proofObject : void 0;
+}, "getWireFormProof");
+var asWireFormProof = /* @__PURE__ */ __name((proof) => proof && typeof proof === "object" ? proof : void 0, "asWireFormProof");
+var isUsableWireFormProof = /* @__PURE__ */ __name((proof, requireSupportedType) => typeof proof.jwt === "string" && proof.jwt.length > 0 && (!requireSupportedType || proof.type === "SdJwtCompactProof" || proof.type === "JwtProof2020"), "isUsableWireFormProof");
+var getWireFormFromProof = /* @__PURE__ */ __name((proof) => typeof proof?.jwt === "string" && proof.jwt.length > 0 ? proof.jwt : void 0, "getWireFormFromProof");
+var extractWireFormFromVc = /* @__PURE__ */ __name((vc) => getWireFormFromProof(getWireFormProof(vc)), "extractWireFormFromVc");
+var inferW3cVersionFromContext = /* @__PURE__ */ __name((vc) => {
+  if (!vc || typeof vc !== "object") return "w3c-vc-1.1";
+  const contextRaw = vc["@context"];
+  const contexts = Array.isArray(contextRaw) ? contextRaw : contextRaw !== void 0 ? [contextRaw] : [];
+  const isV2 = contexts.some(
+    (c) => typeof c === "string" && c.includes("w3.org/ns/credentials/v2")
+  );
+  return isV2 ? "w3c-vc-2.0" : "w3c-vc-1.1";
+}, "inferW3cVersionFromContext");
+
 // src/index.ts
 var isHex = /* @__PURE__ */ __name((str) => /^[0-9a-f]+$/i.test(str), "isHex");
 var isEncrypted = /* @__PURE__ */ __name((item) => {