@learncard/helpers 1.2.14 → 1.2.16

package/dist/helpers.esm.js

@@ -74,6 +74,8 @@ var require_types_cjs_development = __commonJS({
       AppStoreListingSubmitterValidator: /* @__PURE__ */ __name(() => AppStoreListingSubmitterValidator, "AppStoreListingSubmitterValidator"),
       AppStoreListingUpdateValidator: /* @__PURE__ */ __name(() => AppStoreListingUpdateValidator, "AppStoreListingUpdateValidator"),
       AppStoreListingValidator: /* @__PURE__ */ __name(() => AppStoreListingValidator, "AppStoreListingValidator"),
+      AssociationTypeValidator: /* @__PURE__ */ __name(() => AssociationTypeValidator, "AssociationTypeValidator"),
+      AssociationValidator: /* @__PURE__ */ __name(() => AssociationValidator, "AssociationValidator"),
       AuthGrantQueryValidator: /* @__PURE__ */ __name(() => AuthGrantQueryValidator, "AuthGrantQueryValidator"),
       AuthGrantStatusValidator: /* @__PURE__ */ __name(() => AuthGrantStatusValidator, "AuthGrantStatusValidator"),
       AuthGrantValidator: /* @__PURE__ */ __name(() => AuthGrantValidator, "AuthGrantValidator"),
@@ -92,6 +94,8 @@ var require_types_cjs_development = __commonJS({
       ClaimHookValidator: /* @__PURE__ */ __name(() => ClaimHookValidator, "ClaimHookValidator"),
       ClaimInboxCredentialValidator: /* @__PURE__ */ __name(() => ClaimInboxCredentialValidator, "ClaimInboxCredentialValidator"),
       ClaimTokenValidator: /* @__PURE__ */ __name(() => ClaimTokenValidator, "ClaimTokenValidator"),
+      ClrCredentialValidator: /* @__PURE__ */ __name(() => ClrCredentialValidator, "ClrCredentialValidator"),
+      ClrSubjectValidator: /* @__PURE__ */ __name(() => ClrSubjectValidator, "ClrSubjectValidator"),
       ConsentFlowContractDataForDidValidator: /* @__PURE__ */ __name(() => ConsentFlowContractDataForDidValidator, "ConsentFlowContractDataForDidValidator"),
       ConsentFlowContractDataValidator: /* @__PURE__ */ __name(() => ConsentFlowContractDataValidator, "ConsentFlowContractDataValidator"),
       ConsentFlowContractDetailsValidator: /* @__PURE__ */ __name(() => ConsentFlowContractDetailsValidator, "ConsentFlowContractDetailsValidator"),
@@ -150,17 +154,21 @@ var require_types_cjs_development = __commonJS({
       FrameworkWithSkillsValidator: /* @__PURE__ */ __name(() => FrameworkWithSkillsValidator, "FrameworkWithSkillsValidator"),
       FullClaimHookValidator: /* @__PURE__ */ __name(() => FullClaimHookValidator, "FullClaimHookValidator"),
       GeoCoordinatesValidator: /* @__PURE__ */ __name(() => GeoCoordinatesValidator, "GeoCoordinatesValidator"),
+      GetCounterEventValidator: /* @__PURE__ */ __name(() => GetCounterEventValidator, "GetCounterEventValidator"),
+      GetCountersEventValidator: /* @__PURE__ */ __name(() => GetCountersEventValidator, "GetCountersEventValidator"),
       GetFullSkillTreeInputValidator: /* @__PURE__ */ __name(() => GetFullSkillTreeInputValidator, "GetFullSkillTreeInputValidator"),
       GetFullSkillTreeResultValidator: /* @__PURE__ */ __name(() => GetFullSkillTreeResultValidator, "GetFullSkillTreeResultValidator"),
       GetSkillPathInputValidator: /* @__PURE__ */ __name(() => GetSkillPathInputValidator, "GetSkillPathInputValidator"),
       GetSkillPathResultValidator: /* @__PURE__ */ __name(() => GetSkillPathResultValidator, "GetSkillPathResultValidator"),
       GetTemplateRecipientsEventValidator: /* @__PURE__ */ __name(() => GetTemplateRecipientsEventValidator, "GetTemplateRecipientsEventValidator"),
+      GuardianStatusValidator: /* @__PURE__ */ __name(() => GuardianStatusValidator, "GuardianStatusValidator"),
       IdentifierEntryValidator: /* @__PURE__ */ __name(() => IdentifierEntryValidator, "IdentifierEntryValidator"),
       IdentifierTypeValidator: /* @__PURE__ */ __name(() => IdentifierTypeValidator, "IdentifierTypeValidator"),
       IdentityObjectValidator: /* @__PURE__ */ __name(() => IdentityObjectValidator, "IdentityObjectValidator"),
       ImageValidator: /* @__PURE__ */ __name(() => ImageValidator, "ImageValidator"),
       InboxCredentialQueryValidator: /* @__PURE__ */ __name(() => InboxCredentialQueryValidator, "InboxCredentialQueryValidator"),
       InboxCredentialValidator: /* @__PURE__ */ __name(() => InboxCredentialValidator, "InboxCredentialValidator"),
+      IncrementCounterEventValidator: /* @__PURE__ */ __name(() => IncrementCounterEventValidator, "IncrementCounterEventValidator"),
       InstalledAppValidator: /* @__PURE__ */ __name(() => InstalledAppValidator, "InstalledAppValidator"),
       IssueInboxCredentialResponseValidator: /* @__PURE__ */ __name(() => IssueInboxCredentialResponseValidator, "IssueInboxCredentialResponseValidator"),
       IssueInboxCredentialValidator: /* @__PURE__ */ __name(() => IssueInboxCredentialValidator, "IssueInboxCredentialValidator"),
@@ -235,17 +243,20 @@ var require_types_cjs_development = __commonJS({
       RelatedValidator: /* @__PURE__ */ __name(() => RelatedValidator, "RelatedValidator"),
       ReplaceSkillFrameworkSkillsInputValidator: /* @__PURE__ */ __name(() => ReplaceSkillFrameworkSkillsInputValidator, "ReplaceSkillFrameworkSkillsInputValidator"),
       ReplaceSkillFrameworkSkillsResultValidator: /* @__PURE__ */ __name(() => ReplaceSkillFrameworkSkillsResultValidator, "ReplaceSkillFrameworkSkillsResultValidator"),
+      RequestLearnerContextEventValidator: /* @__PURE__ */ __name(() => RequestLearnerContextEventValidator, "RequestLearnerContextEventValidator"),
       ResultDescriptionValidator: /* @__PURE__ */ __name(() => ResultDescriptionValidator, "ResultDescriptionValidator"),
       ResultStatusTypeValidator: /* @__PURE__ */ __name(() => ResultStatusTypeValidator, "ResultStatusTypeValidator"),
       ResultTypeValidator: /* @__PURE__ */ __name(() => ResultTypeValidator, "ResultTypeValidator"),
       ResultValidator: /* @__PURE__ */ __name(() => ResultValidator, "ResultValidator"),
       RubricCriterionValidator: /* @__PURE__ */ __name(() => RubricCriterionValidator, "RubricCriterionValidator"),
+      SendAiSessionCredentialEventValidator: /* @__PURE__ */ __name(() => SendAiSessionCredentialEventValidator, "SendAiSessionCredentialEventValidator"),
       SendBoostInputValidator: /* @__PURE__ */ __name(() => SendBoostInputValidator, "SendBoostInputValidator"),
       SendBoostResponseValidator: /* @__PURE__ */ __name(() => SendBoostResponseValidator, "SendBoostResponseValidator"),
       SendBrandingOptionsValidator: /* @__PURE__ */ __name(() => SendBrandingOptionsValidator, "SendBrandingOptionsValidator"),
       SendCredentialEventValidator: /* @__PURE__ */ __name(() => SendCredentialEventValidator, "SendCredentialEventValidator"),
       SendInboxResponseValidator: /* @__PURE__ */ __name(() => SendInboxResponseValidator, "SendInboxResponseValidator"),
       SendInputValidator: /* @__PURE__ */ __name(() => SendInputValidator, "SendInputValidator"),
+      SendNotificationEventValidator: /* @__PURE__ */ __name(() => SendNotificationEventValidator, "SendNotificationEventValidator"),
       SendOptionsValidator: /* @__PURE__ */ __name(() => SendOptionsValidator, "SendOptionsValidator"),
       SendResponseValidator: /* @__PURE__ */ __name(() => SendResponseValidator, "SendResponseValidator"),
       SentCredentialInfoValidator: /* @__PURE__ */ __name(() => SentCredentialInfoValidator, "SentCredentialInfoValidator"),
@@ -267,10 +278,13 @@ var require_types_cjs_development = __commonJS({
       SkillTreeNodeValidator: /* @__PURE__ */ __name(() => SkillTreeNodeValidator, "SkillTreeNodeValidator"),
       SkillValidator: /* @__PURE__ */ __name(() => SkillValidator, "SkillValidator"),
       StringQuery: /* @__PURE__ */ __name(() => StringQuery, "StringQuery"),
+      SummaryCredentialDataValidator: /* @__PURE__ */ __name(() => SummaryCredentialDataValidator, "SummaryCredentialDataValidator"),
+      SummaryCredentialKeywordValidator: /* @__PURE__ */ __name(() => SummaryCredentialKeywordValidator, "SummaryCredentialKeywordValidator"),
       SyncFrameworkInputValidator: /* @__PURE__ */ __name(() => SyncFrameworkInputValidator, "SyncFrameworkInputValidator"),
       TagValidator: /* @__PURE__ */ __name(() => TagValidator, "TagValidator"),
       TermsOfUseValidator: /* @__PURE__ */ __name(() => TermsOfUseValidator, "TermsOfUseValidator"),
       UnsignedAchievementCredentialValidator: /* @__PURE__ */ __name(() => UnsignedAchievementCredentialValidator, "UnsignedAchievementCredentialValidator"),
+      UnsignedClrCredentialValidator: /* @__PURE__ */ __name(() => UnsignedClrCredentialValidator, "UnsignedClrCredentialValidator"),
       UnsignedVCValidator: /* @__PURE__ */ __name(() => UnsignedVCValidator, "UnsignedVCValidator"),
       UnsignedVPValidator: /* @__PURE__ */ __name(() => UnsignedVPValidator, "UnsignedVPValidator"),
       UpdateFrameworkInputValidator: /* @__PURE__ */ __name(() => UpdateFrameworkInputValidator, "UpdateFrameworkInputValidator"),
@@ -14042,6 +14056,42 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     var AchievementCredentialValidator = UnsignedAchievementCredentialValidator.extend({
       proof: ProofValidator.or(ProofValidator.array())
     });
+    var AssociationTypeValidator = external_exports.enum([
+      "exactMatchOf",
+      "extends",
+      "isChildOf",
+      "isParentOf",
+      "isPartOf",
+      "isPeerOf",
+      "isRelatedTo",
+      "precedes",
+      "replacedBy"
+    ]).or(external_exports.string());
+    var AssociationValidator = external_exports.object({
+      type: external_exports.string().array().nonempty(),
+      associationType: AssociationTypeValidator,
+      sourceId: external_exports.string().optional(),
+      targetId: external_exports.string()
+    }).catchall(external_exports.any());
+    var ClrSubjectValidator = external_exports.object({
+      id: external_exports.string().optional(),
+      type: external_exports.string().array().nonempty(),
+      identifier: external_exports.any().array().optional(),
+      achievement: AchievementValidator.array().optional(),
+      association: AssociationValidator.array().optional(),
+      verifiableCredential: external_exports.any().array().optional()
+    }).catchall(external_exports.any());
+    var UnsignedClrCredentialValidator = UnsignedVCValidator.extend({
+      name: external_exports.string().optional(),
+      description: external_exports.string().optional(),
+      image: ImageValidator.optional(),
+      credentialSubject: ClrSubjectValidator.or(ClrSubjectValidator.array()),
+      endorsement: EndorsementCredentialValidator.array().optional(),
+      partial: external_exports.boolean().optional()
+    });
+    var ClrCredentialValidator = UnsignedClrCredentialValidator.extend({
+      proof: ProofValidator.or(ProofValidator.array())
+    });
     var VerificationCheckValidator = external_exports.object({
       checks: external_exports.string().array(),
       warnings: external_exports.string().array(),
@@ -14393,10 +14443,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       credentialName: external_exports.string().optional().describe("Display name for the credential"),
       recipientName: external_exports.string().optional().describe("Name of the recipient for personalization")
     });
+    var GuardianStatusValidator = external_exports.enum([
+      "AWAITING_GUARDIAN",
+      "GUARDIAN_APPROVED",
+      "GUARDIAN_REJECTED"
+    ]);
     var SendOptionsValidator = external_exports.object({
       webhookUrl: external_exports.string().url().optional().describe("Webhook URL to receive claim notifications"),
       suppressDelivery: external_exports.boolean().optional().describe("If true, returns claimUrl without sending email/SMS"),
-      branding: SendBrandingOptionsValidator.optional().describe("Branding for email/SMS delivery")
+      branding: SendBrandingOptionsValidator.optional().describe("Branding for email/SMS delivery"),
+      guardianEmail: external_exports.string().email().optional().describe("Guardian email that must approve before student can claim")
     });
     var SendBoostInputValidator = external_exports.object({
       type: external_exports.literal("boost"),
@@ -14413,11 +14469,25 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }).refine((data) => data.templateUri || data.template || data.signedCredential, {
       message: "Either templateUri, template, or signedCredential must be provided.",
       path: ["templateUri"]
-    });
+    }).refine(
+      (data) => {
+        if (data.options?.guardianEmail) {
+          return data.options.guardianEmail.toLowerCase() !== data.recipient.toLowerCase();
+        }
+        return true;
+      },
+      {
+        message: "guardianEmail must differ from recipient (self-approval not allowed)",
+        path: ["options", "guardianEmail"]
+      }
+    );
     var SendInboxResponseValidator = external_exports.object({
       issuanceId: external_exports.string(),
       status: external_exports.enum(["PENDING", "ISSUED", "EXPIRED", "DELIVERED", "CLAIMED"]),
-      claimUrl: external_exports.string().url().optional().describe("Present when suppressDelivery=true")
+      claimUrl: external_exports.string().url().optional().describe("Present when suppressDelivery=true"),
+      guardianStatus: GuardianStatusValidator.optional().describe(
+        "Present when guardianEmail was specified"
+      )
     });
     var SendBoostResponseValidator = external_exports.object({
       type: external_exports.literal("boost"),
@@ -14654,7 +14724,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       "APP_LISTING_APPROVED",
       "APP_LISTING_REJECTED",
       "APP_LISTING_WITHDRAWN",
-      "DEVICE_LINK_REQUEST"
+      "DEVICE_LINK_REQUEST",
+      "GUARDIAN_APPROVAL_PENDING",
+      "GUARDIAN_APPROVED",
+      "GUARDIAN_REJECTED",
+      "APP_NOTIFICATION"
     ]);
     var LCNNotificationMessageValidator = external_exports.object({
       title: external_exports.string().optional(),
@@ -14692,7 +14766,10 @@ 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: 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(),
@@ -14797,7 +14874,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       signingAuthority: external_exports.object({
         endpoint: external_exports.string().optional(),
         name: external_exports.string().optional()
-      }).optional()
+      }).optional(),
+      // Guardian gate fields (all optional — absent on pre-existing credentials)
+      guardianEmail: external_exports.string().email().optional(),
+      guardianStatus: GuardianStatusValidator.optional(),
+      guardianApprovedAt: external_exports.string().optional(),
+      guardianApprovedByDid: external_exports.string().optional()
     });
     var PaginatedInboxCredentialsValidator = external_exports.object({
       hasMore: external_exports.boolean(),
@@ -15265,11 +15347,84 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }).refine((input) => Boolean(input.templateAlias) !== Boolean(input.boostUri), {
       message: "Exactly one of templateAlias or boostUri is required"
     });
+    var RequestLearnerContextEventValidator = external_exports.object({
+      type: external_exports.literal("request-learner-context"),
+      includeCredentials: external_exports.boolean().optional().default(true),
+      includePersonalData: external_exports.boolean().optional().default(false),
+      format: external_exports.enum(["prompt", "structured"]).optional().default("prompt"),
+      instructions: external_exports.string().optional(),
+      detailLevel: external_exports.enum(["compact", "expanded"]).optional().default("compact")
+    });
+    var SummaryCredentialKeywordValidator = external_exports.object({
+      occupations: external_exports.array(external_exports.string()).nullable(),
+      careers: external_exports.array(external_exports.string()).nullable(),
+      jobs: external_exports.array(external_exports.string()).nullable(),
+      skills: external_exports.array(external_exports.string()).nullable(),
+      fieldOfStudy: external_exports.string().nullable()
+    });
+    var SummaryCredentialDataValidator = external_exports.object({
+      title: external_exports.string().describe("Short, concise title for the learning session or credential"),
+      summary: external_exports.string().describe("Comprehensive summary of what happened during the session"),
+      learned: external_exports.array(external_exports.string()).describe("Bullet points of key knowledge gained"),
+      skills: external_exports.array(
+        external_exports.object({
+          title: external_exports.string().describe("Name of the skill category"),
+          description: external_exports.string().describe("Detailed description of what this skill category involves")
+        })
+      ).describe("Categorized skills learned during the session"),
+      nextSteps: external_exports.array(
+        external_exports.object({
+          title: external_exports.string().describe("Title of the suggested next step"),
+          description: external_exports.string().describe("Description explaining why this next step is recommended"),
+          keywords: SummaryCredentialKeywordValidator
+        })
+      ).describe("Recommended follow-up activities or learning modules"),
+      reflections: external_exports.array(
+        external_exports.object({
+          title: external_exports.string().describe("Title of the reflection"),
+          description: external_exports.string().describe("Detailed description of what this reflection involves")
+        })
+      ).describe("Reflections on the learning experience")
+    });
+    var SendAiSessionCredentialEventValidator = external_exports.object({
+      type: external_exports.literal("send-ai-session-credential"),
+      sessionTitle: external_exports.string(),
+      summaryData: SummaryCredentialDataValidator,
+      metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+    });
+    var SendNotificationEventValidator = external_exports.object({
+      type: external_exports.literal("send-notification"),
+      title: external_exports.string().optional(),
+      body: external_exports.string().optional(),
+      actionPath: external_exports.string().optional(),
+      category: external_exports.string().optional(),
+      priority: external_exports.enum(["normal", "high"]).optional()
+    });
+    var counterKeyValidator = external_exports.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/, "Key must be alphanumeric with _ or -");
+    var IncrementCounterEventValidator = external_exports.object({
+      type: external_exports.literal("increment-counter"),
+      key: counterKeyValidator,
+      amount: external_exports.number().int().finite()
+    });
+    var GetCounterEventValidator = external_exports.object({
+      type: external_exports.literal("get-counter"),
+      key: counterKeyValidator
+    });
+    var GetCountersEventValidator = external_exports.object({
+      type: external_exports.literal("get-counters"),
+      keys: external_exports.array(counterKeyValidator).min(1).max(50).optional()
+    });
     var AppEventValidator = external_exports.discriminatedUnion("type", [
       SendCredentialEventValidator,
       CheckCredentialEventValidator,
       CheckIssuanceStatusEventValidator,
-      GetTemplateRecipientsEventValidator
+      GetTemplateRecipientsEventValidator,
+      RequestLearnerContextEventValidator,
+      SendAiSessionCredentialEventValidator,
+      SendNotificationEventValidator,
+      IncrementCounterEventValidator,
+      GetCounterEventValidator,
+      GetCountersEventValidator
     ]);
     var AppEventInputValidator = external_exports.object({
       listingId: external_exports.string(),
@@ -15300,7 +15455,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       activityId: external_exports.string(),
       eventType: CredentialActivityEventTypeValidator,
       timestamp: external_exports.string(),
-      actorProfileId: external_exports.string(),
+      actorProfileId: external_exports.string().optional(),
       recipientType: CredentialActivityRecipientTypeValidator,
       recipientIdentifier: external_exports.string(),
       boostUri: external_exports.string().optional(),