@learncard/network-brain-client 2.5.26 → 2.5.30

package/dist/brain-client.esm.js

@@ -14076,6 +14076,8 @@ var require_types_cjs_development = __commonJS2({
       AppStoreListingSubmitterValidator: /* @__PURE__ */ __name2(() => AppStoreListingSubmitterValidator, "AppStoreListingSubmitterValidator"),
       AppStoreListingUpdateValidator: /* @__PURE__ */ __name2(() => AppStoreListingUpdateValidator, "AppStoreListingUpdateValidator"),
       AppStoreListingValidator: /* @__PURE__ */ __name2(() => AppStoreListingValidator, "AppStoreListingValidator"),
+      AssociationTypeValidator: /* @__PURE__ */ __name2(() => AssociationTypeValidator, "AssociationTypeValidator"),
+      AssociationValidator: /* @__PURE__ */ __name2(() => AssociationValidator, "AssociationValidator"),
       AuthGrantQueryValidator: /* @__PURE__ */ __name2(() => AuthGrantQueryValidator, "AuthGrantQueryValidator"),
       AuthGrantStatusValidator: /* @__PURE__ */ __name2(() => AuthGrantStatusValidator, "AuthGrantStatusValidator"),
       AuthGrantValidator: /* @__PURE__ */ __name2(() => AuthGrantValidator, "AuthGrantValidator"),
@@ -14094,6 +14096,8 @@ var require_types_cjs_development = __commonJS2({
       ClaimHookValidator: /* @__PURE__ */ __name2(() => ClaimHookValidator, "ClaimHookValidator"),
       ClaimInboxCredentialValidator: /* @__PURE__ */ __name2(() => ClaimInboxCredentialValidator, "ClaimInboxCredentialValidator"),
       ClaimTokenValidator: /* @__PURE__ */ __name2(() => ClaimTokenValidator, "ClaimTokenValidator"),
+      ClrCredentialValidator: /* @__PURE__ */ __name2(() => ClrCredentialValidator, "ClrCredentialValidator"),
+      ClrSubjectValidator: /* @__PURE__ */ __name2(() => ClrSubjectValidator, "ClrSubjectValidator"),
       ConsentFlowContractDataForDidValidator: /* @__PURE__ */ __name2(() => ConsentFlowContractDataForDidValidator, "ConsentFlowContractDataForDidValidator"),
       ConsentFlowContractDataValidator: /* @__PURE__ */ __name2(() => ConsentFlowContractDataValidator, "ConsentFlowContractDataValidator"),
       ConsentFlowContractDetailsValidator: /* @__PURE__ */ __name2(() => ConsentFlowContractDetailsValidator, "ConsentFlowContractDetailsValidator"),
@@ -14152,17 +14156,21 @@ var require_types_cjs_development = __commonJS2({
       FrameworkWithSkillsValidator: /* @__PURE__ */ __name2(() => FrameworkWithSkillsValidator, "FrameworkWithSkillsValidator"),
       FullClaimHookValidator: /* @__PURE__ */ __name2(() => FullClaimHookValidator, "FullClaimHookValidator"),
       GeoCoordinatesValidator: /* @__PURE__ */ __name2(() => GeoCoordinatesValidator, "GeoCoordinatesValidator"),
+      GetCounterEventValidator: /* @__PURE__ */ __name2(() => GetCounterEventValidator, "GetCounterEventValidator"),
+      GetCountersEventValidator: /* @__PURE__ */ __name2(() => GetCountersEventValidator, "GetCountersEventValidator"),
       GetFullSkillTreeInputValidator: /* @__PURE__ */ __name2(() => GetFullSkillTreeInputValidator, "GetFullSkillTreeInputValidator"),
       GetFullSkillTreeResultValidator: /* @__PURE__ */ __name2(() => GetFullSkillTreeResultValidator, "GetFullSkillTreeResultValidator"),
       GetSkillPathInputValidator: /* @__PURE__ */ __name2(() => GetSkillPathInputValidator, "GetSkillPathInputValidator"),
       GetSkillPathResultValidator: /* @__PURE__ */ __name2(() => GetSkillPathResultValidator, "GetSkillPathResultValidator"),
       GetTemplateRecipientsEventValidator: /* @__PURE__ */ __name2(() => GetTemplateRecipientsEventValidator, "GetTemplateRecipientsEventValidator"),
+      GuardianStatusValidator: /* @__PURE__ */ __name2(() => GuardianStatusValidator, "GuardianStatusValidator"),
       IdentifierEntryValidator: /* @__PURE__ */ __name2(() => IdentifierEntryValidator, "IdentifierEntryValidator"),
       IdentifierTypeValidator: /* @__PURE__ */ __name2(() => IdentifierTypeValidator, "IdentifierTypeValidator"),
       IdentityObjectValidator: /* @__PURE__ */ __name2(() => IdentityObjectValidator, "IdentityObjectValidator"),
       ImageValidator: /* @__PURE__ */ __name2(() => ImageValidator, "ImageValidator"),
       InboxCredentialQueryValidator: /* @__PURE__ */ __name2(() => InboxCredentialQueryValidator, "InboxCredentialQueryValidator"),
       InboxCredentialValidator: /* @__PURE__ */ __name2(() => InboxCredentialValidator, "InboxCredentialValidator"),
+      IncrementCounterEventValidator: /* @__PURE__ */ __name2(() => IncrementCounterEventValidator, "IncrementCounterEventValidator"),
       InstalledAppValidator: /* @__PURE__ */ __name2(() => InstalledAppValidator, "InstalledAppValidator"),
       IssueInboxCredentialResponseValidator: /* @__PURE__ */ __name2(() => IssueInboxCredentialResponseValidator, "IssueInboxCredentialResponseValidator"),
       IssueInboxCredentialValidator: /* @__PURE__ */ __name2(() => IssueInboxCredentialValidator, "IssueInboxCredentialValidator"),
@@ -14237,17 +14245,20 @@ var require_types_cjs_development = __commonJS2({
       RelatedValidator: /* @__PURE__ */ __name2(() => RelatedValidator, "RelatedValidator"),
       ReplaceSkillFrameworkSkillsInputValidator: /* @__PURE__ */ __name2(() => ReplaceSkillFrameworkSkillsInputValidator, "ReplaceSkillFrameworkSkillsInputValidator"),
       ReplaceSkillFrameworkSkillsResultValidator: /* @__PURE__ */ __name2(() => ReplaceSkillFrameworkSkillsResultValidator, "ReplaceSkillFrameworkSkillsResultValidator"),
+      RequestLearnerContextEventValidator: /* @__PURE__ */ __name2(() => RequestLearnerContextEventValidator, "RequestLearnerContextEventValidator"),
       ResultDescriptionValidator: /* @__PURE__ */ __name2(() => ResultDescriptionValidator, "ResultDescriptionValidator"),
       ResultStatusTypeValidator: /* @__PURE__ */ __name2(() => ResultStatusTypeValidator, "ResultStatusTypeValidator"),
       ResultTypeValidator: /* @__PURE__ */ __name2(() => ResultTypeValidator, "ResultTypeValidator"),
       ResultValidator: /* @__PURE__ */ __name2(() => ResultValidator, "ResultValidator"),
       RubricCriterionValidator: /* @__PURE__ */ __name2(() => RubricCriterionValidator, "RubricCriterionValidator"),
+      SendAiSessionCredentialEventValidator: /* @__PURE__ */ __name2(() => SendAiSessionCredentialEventValidator, "SendAiSessionCredentialEventValidator"),
       SendBoostInputValidator: /* @__PURE__ */ __name2(() => SendBoostInputValidator, "SendBoostInputValidator"),
       SendBoostResponseValidator: /* @__PURE__ */ __name2(() => SendBoostResponseValidator, "SendBoostResponseValidator"),
       SendBrandingOptionsValidator: /* @__PURE__ */ __name2(() => SendBrandingOptionsValidator, "SendBrandingOptionsValidator"),
       SendCredentialEventValidator: /* @__PURE__ */ __name2(() => SendCredentialEventValidator, "SendCredentialEventValidator"),
       SendInboxResponseValidator: /* @__PURE__ */ __name2(() => SendInboxResponseValidator, "SendInboxResponseValidator"),
       SendInputValidator: /* @__PURE__ */ __name2(() => SendInputValidator, "SendInputValidator"),
+      SendNotificationEventValidator: /* @__PURE__ */ __name2(() => SendNotificationEventValidator, "SendNotificationEventValidator"),
       SendOptionsValidator: /* @__PURE__ */ __name2(() => SendOptionsValidator, "SendOptionsValidator"),
       SendResponseValidator: /* @__PURE__ */ __name2(() => SendResponseValidator, "SendResponseValidator"),
       SentCredentialInfoValidator: /* @__PURE__ */ __name2(() => SentCredentialInfoValidator, "SentCredentialInfoValidator"),
@@ -14269,10 +14280,13 @@ var require_types_cjs_development = __commonJS2({
       SkillTreeNodeValidator: /* @__PURE__ */ __name2(() => SkillTreeNodeValidator, "SkillTreeNodeValidator"),
       SkillValidator: /* @__PURE__ */ __name2(() => SkillValidator, "SkillValidator"),
       StringQuery: /* @__PURE__ */ __name2(() => StringQuery, "StringQuery"),
+      SummaryCredentialDataValidator: /* @__PURE__ */ __name2(() => SummaryCredentialDataValidator, "SummaryCredentialDataValidator"),
+      SummaryCredentialKeywordValidator: /* @__PURE__ */ __name2(() => SummaryCredentialKeywordValidator, "SummaryCredentialKeywordValidator"),
       SyncFrameworkInputValidator: /* @__PURE__ */ __name2(() => SyncFrameworkInputValidator, "SyncFrameworkInputValidator"),
       TagValidator: /* @__PURE__ */ __name2(() => TagValidator, "TagValidator"),
       TermsOfUseValidator: /* @__PURE__ */ __name2(() => TermsOfUseValidator, "TermsOfUseValidator"),
       UnsignedAchievementCredentialValidator: /* @__PURE__ */ __name2(() => UnsignedAchievementCredentialValidator, "UnsignedAchievementCredentialValidator"),
+      UnsignedClrCredentialValidator: /* @__PURE__ */ __name2(() => UnsignedClrCredentialValidator, "UnsignedClrCredentialValidator"),
       UnsignedVCValidator: /* @__PURE__ */ __name2(() => UnsignedVCValidator, "UnsignedVCValidator"),
       UnsignedVPValidator: /* @__PURE__ */ __name2(() => UnsignedVPValidator, "UnsignedVPValidator"),
       UpdateFrameworkInputValidator: /* @__PURE__ */ __name2(() => UpdateFrameworkInputValidator, "UpdateFrameworkInputValidator"),
@@ -28466,6 +28480,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_exports2.enum([
+      "exactMatchOf",
+      "extends",
+      "isChildOf",
+      "isParentOf",
+      "isPartOf",
+      "isPeerOf",
+      "isRelatedTo",
+      "precedes",
+      "replacedBy"
+    ]).or(external_exports2.string());
+    var AssociationValidator = external_exports2.object({
+      type: external_exports2.string().array().nonempty(),
+      associationType: AssociationTypeValidator,
+      sourceId: external_exports2.string().optional(),
+      targetId: external_exports2.string()
+    }).catchall(external_exports2.any());
+    var ClrSubjectValidator = external_exports2.object({
+      id: external_exports2.string().optional(),
+      type: external_exports2.string().array().nonempty(),
+      identifier: external_exports2.any().array().optional(),
+      achievement: AchievementValidator.array().optional(),
+      association: AssociationValidator.array().optional(),
+      verifiableCredential: external_exports2.any().array().optional()
+    }).catchall(external_exports2.any());
+    var UnsignedClrCredentialValidator = UnsignedVCValidator.extend({
+      name: external_exports2.string().optional(),
+      description: external_exports2.string().optional(),
+      image: ImageValidator.optional(),
+      credentialSubject: ClrSubjectValidator.or(ClrSubjectValidator.array()),
+      endorsement: EndorsementCredentialValidator.array().optional(),
+      partial: external_exports2.boolean().optional()
+    });
+    var ClrCredentialValidator = UnsignedClrCredentialValidator.extend({
+      proof: ProofValidator.or(ProofValidator.array())
+    });
     var VerificationCheckValidator = external_exports2.object({
       checks: external_exports2.string().array(),
       warnings: external_exports2.string().array(),
@@ -28817,10 +28867,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       credentialName: external_exports2.string().optional().describe("Display name for the credential"),
       recipientName: external_exports2.string().optional().describe("Name of the recipient for personalization")
     });
+    var GuardianStatusValidator = external_exports2.enum([
+      "AWAITING_GUARDIAN",
+      "GUARDIAN_APPROVED",
+      "GUARDIAN_REJECTED"
+    ]);
     var SendOptionsValidator = external_exports2.object({
       webhookUrl: external_exports2.string().url().optional().describe("Webhook URL to receive claim notifications"),
       suppressDelivery: external_exports2.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_exports2.string().email().optional().describe("Guardian email that must approve before student can claim")
     });
     var SendBoostInputValidator = external_exports2.object({
       type: external_exports2.literal("boost"),
@@ -28837,11 +28893,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_exports2.object({
       issuanceId: external_exports2.string(),
       status: external_exports2.enum(["PENDING", "ISSUED", "EXPIRED", "DELIVERED", "CLAIMED"]),
-      claimUrl: external_exports2.string().url().optional().describe("Present when suppressDelivery=true")
+      claimUrl: external_exports2.string().url().optional().describe("Present when suppressDelivery=true"),
+      guardianStatus: GuardianStatusValidator.optional().describe(
+        "Present when guardianEmail was specified"
+      )
     });
     var SendBoostResponseValidator = external_exports2.object({
       type: external_exports2.literal("boost"),
@@ -29078,7 +29148,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_exports2.object({
       title: external_exports2.string().optional(),
@@ -29116,7 +29190,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     var LCNNotificationValidator = external_exports2.object({
       type: LCNNotificationTypeEnumValidator,
       to: LCNProfileValidator.partial().and(external_exports2.object({ did: external_exports2.string() })),
-      from: LCNProfileValidator.partial().and(external_exports2.object({ did: external_exports2.string() })),
+      from: external_exports2.union([
+        external_exports2.string(),
+        LCNProfileValidator.partial().and(external_exports2.object({ did: external_exports2.string() }))
+      ]),
       message: LCNNotificationMessageValidator.optional(),
       data: LCNNotificationDataValidator.optional(),
       sent: external_exports2.iso.datetime().optional(),
@@ -29221,7 +29298,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       signingAuthority: external_exports2.object({
         endpoint: external_exports2.string().optional(),
         name: external_exports2.string().optional()
-      }).optional()
+      }).optional(),
+      // Guardian gate fields (all optional — absent on pre-existing credentials)
+      guardianEmail: external_exports2.string().email().optional(),
+      guardianStatus: GuardianStatusValidator.optional(),
+      guardianApprovedAt: external_exports2.string().optional(),
+      guardianApprovedByDid: external_exports2.string().optional()
     });
     var PaginatedInboxCredentialsValidator = external_exports2.object({
       hasMore: external_exports2.boolean(),
@@ -29689,11 +29771,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_exports2.object({
+      type: external_exports2.literal("request-learner-context"),
+      includeCredentials: external_exports2.boolean().optional().default(true),
+      includePersonalData: external_exports2.boolean().optional().default(false),
+      format: external_exports2.enum(["prompt", "structured"]).optional().default("prompt"),
+      instructions: external_exports2.string().optional(),
+      detailLevel: external_exports2.enum(["compact", "expanded"]).optional().default("compact")
+    });
+    var SummaryCredentialKeywordValidator = external_exports2.object({
+      occupations: external_exports2.array(external_exports2.string()).nullable(),
+      careers: external_exports2.array(external_exports2.string()).nullable(),
+      jobs: external_exports2.array(external_exports2.string()).nullable(),
+      skills: external_exports2.array(external_exports2.string()).nullable(),
+      fieldOfStudy: external_exports2.string().nullable()
+    });
+    var SummaryCredentialDataValidator = external_exports2.object({
+      title: external_exports2.string().describe("Short, concise title for the learning session or credential"),
+      summary: external_exports2.string().describe("Comprehensive summary of what happened during the session"),
+      learned: external_exports2.array(external_exports2.string()).describe("Bullet points of key knowledge gained"),
+      skills: external_exports2.array(
+        external_exports2.object({
+          title: external_exports2.string().describe("Name of the skill category"),
+          description: external_exports2.string().describe("Detailed description of what this skill category involves")
+        })
+      ).describe("Categorized skills learned during the session"),
+      nextSteps: external_exports2.array(
+        external_exports2.object({
+          title: external_exports2.string().describe("Title of the suggested next step"),
+          description: external_exports2.string().describe("Description explaining why this next step is recommended"),
+          keywords: SummaryCredentialKeywordValidator
+        })
+      ).describe("Recommended follow-up activities or learning modules"),
+      reflections: external_exports2.array(
+        external_exports2.object({
+          title: external_exports2.string().describe("Title of the reflection"),
+          description: external_exports2.string().describe("Detailed description of what this reflection involves")
+        })
+      ).describe("Reflections on the learning experience")
+    });
+    var SendAiSessionCredentialEventValidator = external_exports2.object({
+      type: external_exports2.literal("send-ai-session-credential"),
+      sessionTitle: external_exports2.string(),
+      summaryData: SummaryCredentialDataValidator,
+      metadata: external_exports2.record(external_exports2.string(), external_exports2.unknown()).optional()
+    });
+    var SendNotificationEventValidator = external_exports2.object({
+      type: external_exports2.literal("send-notification"),
+      title: external_exports2.string().optional(),
+      body: external_exports2.string().optional(),
+      actionPath: external_exports2.string().optional(),
+      category: external_exports2.string().optional(),
+      priority: external_exports2.enum(["normal", "high"]).optional()
+    });
+    var counterKeyValidator = external_exports2.string().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/, "Key must be alphanumeric with _ or -");
+    var IncrementCounterEventValidator = external_exports2.object({
+      type: external_exports2.literal("increment-counter"),
+      key: counterKeyValidator,
+      amount: external_exports2.number().int().finite()
+    });
+    var GetCounterEventValidator = external_exports2.object({
+      type: external_exports2.literal("get-counter"),
+      key: counterKeyValidator
+    });
+    var GetCountersEventValidator = external_exports2.object({
+      type: external_exports2.literal("get-counters"),
+      keys: external_exports2.array(counterKeyValidator).min(1).max(50).optional()
+    });
     var AppEventValidator = external_exports2.discriminatedUnion("type", [
       SendCredentialEventValidator,
       CheckCredentialEventValidator,
       CheckIssuanceStatusEventValidator,
-      GetTemplateRecipientsEventValidator
+      GetTemplateRecipientsEventValidator,
+      RequestLearnerContextEventValidator,
+      SendAiSessionCredentialEventValidator,
+      SendNotificationEventValidator,
+      IncrementCounterEventValidator,
+      GetCounterEventValidator,
+      GetCountersEventValidator
     ]);
     var AppEventInputValidator = external_exports2.object({
       listingId: external_exports2.string(),
@@ -29724,7 +29879,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       activityId: external_exports2.string(),
       eventType: CredentialActivityEventTypeValidator,
       timestamp: external_exports2.string(),
-      actorProfileId: external_exports2.string(),
+      actorProfileId: external_exports2.string().optional(),
       recipientType: CredentialActivityRecipientTypeValidator,
       recipientIdentifier: external_exports2.string(),
       boostUri: external_exports2.string().optional(),
@@ -31772,7 +31927,7 @@ var callbackLink = /* @__PURE__ */ __name((callback) => {
 }, "callbackLink");
 
 // src/index.ts
-var getClient = /* @__PURE__ */ __name(async (url2, didAuthFunction, guardianApprovalGetter) => {
+var getClient = /* @__PURE__ */ __name(async (url2, didAuthFunction, guardianApprovalGetter, extraHeaders) => {
   let challenges = [];
   const challengeRequester = createTRPCClient({
     links: [
@@ -31780,7 +31935,7 @@ var getClient = /* @__PURE__ */ __name(async (url2, didAuthFunction, guardianApp
         methodOverride: "POST",
         url: url2,
         maxURLLength: 3072,
-        headers: { Authorization: `Bearer ${await didAuthFunction()}` },
+        headers: { Authorization: `Bearer ${await didAuthFunction()}`, ...extraHeaders },
         transformer: {
           input: RegExpTransformer,
           output: { serialize: /* @__PURE__ */ __name((o) => o, "serialize"), deserialize: /* @__PURE__ */ __name((o) => o, "deserialize") }
@@ -31806,7 +31961,8 @@ var getClient = /* @__PURE__ */ __name(async (url2, didAuthFunction, guardianApp
           const guardianApproval = guardianApprovalGetter ? await guardianApprovalGetter() : void 0;
           return {
             Authorization: `Bearer ${await didAuthFunction(challenges.pop())}`,
-            ...guardianApproval ? { "x-guardian-approval": guardianApproval } : {}
+            ...guardianApproval ? { "x-guardian-approval": guardianApproval } : {},
+            ...extraHeaders
           };
         }, "headers"),
         transformer: {
@@ -31818,7 +31974,7 @@ var getClient = /* @__PURE__ */ __name(async (url2, didAuthFunction, guardianApp
   });
   return trpc;
 }, "getClient");
-var getApiTokenClient = /* @__PURE__ */ __name(async (url2, apiToken, guardianApprovalGetter) => {
+var getApiTokenClient = /* @__PURE__ */ __name(async (url2, apiToken, guardianApprovalGetter, extraHeaders) => {
   const trpc = createTRPCClient({
     links: [
       httpBatchLink({
@@ -31829,7 +31985,8 @@ var getApiTokenClient = /* @__PURE__ */ __name(async (url2, apiToken, guardianAp
           const guardianApproval = guardianApprovalGetter ? await guardianApprovalGetter() : void 0;
           return {
             Authorization: `Bearer ${apiToken}`,
-            ...guardianApproval ? { "x-guardian-approval": guardianApproval } : {}
+            ...guardianApproval ? { "x-guardian-approval": guardianApproval } : {},
+            ...extraHeaders
           };
         }, "headers"),
         transformer: {