@learncard/helpers 1.2.8 → 1.2.10

package/dist/helpers.cjs.development.js

@@ -63,6 +63,7 @@ var require_types_cjs_development = __commonJS({
       AchievementValidator: /* @__PURE__ */ __name(() => AchievementValidator, "AchievementValidator"),
       AddTagInputValidator: /* @__PURE__ */ __name(() => AddTagInputValidator, "AddTagInputValidator"),
       AddressValidator: /* @__PURE__ */ __name(() => AddressValidator, "AddressValidator"),
+      AgeRatingValidator: /* @__PURE__ */ __name(() => AgeRatingValidator, "AgeRatingValidator"),
       AlignmentTargetTypeValidator: /* @__PURE__ */ __name(() => AlignmentTargetTypeValidator, "AlignmentTargetTypeValidator"),
       AlignmentValidator: /* @__PURE__ */ __name(() => AlignmentValidator, "AlignmentValidator"),
       AppBoostValidator: /* @__PURE__ */ __name(() => AppBoostValidator, "AppBoostValidator"),
@@ -76,6 +77,7 @@ var require_types_cjs_development = __commonJS({
       AuthGrantQueryValidator: /* @__PURE__ */ __name(() => AuthGrantQueryValidator, "AuthGrantQueryValidator"),
       AuthGrantStatusValidator: /* @__PURE__ */ __name(() => AuthGrantStatusValidator, "AuthGrantStatusValidator"),
       AuthGrantValidator: /* @__PURE__ */ __name(() => AuthGrantValidator, "AuthGrantValidator"),
+      AuthSessionError: /* @__PURE__ */ __name(() => AuthSessionError, "AuthSessionError"),
       AutoBoostConfigValidator: /* @__PURE__ */ __name(() => AutoBoostConfigValidator, "AutoBoostConfigValidator"),
       BoostPermissionsQueryValidator: /* @__PURE__ */ __name(() => BoostPermissionsQueryValidator, "BoostPermissionsQueryValidator"),
       BoostPermissionsValidator: /* @__PURE__ */ __name(() => BoostPermissionsValidator, "BoostPermissionsValidator"),
@@ -83,6 +85,8 @@ var require_types_cjs_development = __commonJS({
       BoostRecipientValidator: /* @__PURE__ */ __name(() => BoostRecipientValidator, "BoostRecipientValidator"),
       BoostRecipientWithChildrenValidator: /* @__PURE__ */ __name(() => BoostRecipientWithChildrenValidator, "BoostRecipientWithChildrenValidator"),
       BoostValidator: /* @__PURE__ */ __name(() => BoostValidator, "BoostValidator"),
+      CheckCredentialEventValidator: /* @__PURE__ */ __name(() => CheckCredentialEventValidator, "CheckCredentialEventValidator"),
+      CheckIssuanceStatusEventValidator: /* @__PURE__ */ __name(() => CheckIssuanceStatusEventValidator, "CheckIssuanceStatusEventValidator"),
       ClaimHookQueryValidator: /* @__PURE__ */ __name(() => ClaimHookQueryValidator, "ClaimHookQueryValidator"),
       ClaimHookTypeValidator: /* @__PURE__ */ __name(() => ClaimHookTypeValidator, "ClaimHookTypeValidator"),
       ClaimHookValidator: /* @__PURE__ */ __name(() => ClaimHookValidator, "ClaimHookValidator"),
@@ -124,6 +128,7 @@ var require_types_cjs_development = __commonJS({
       CredentialActivityValidator: /* @__PURE__ */ __name(() => CredentialActivityValidator, "CredentialActivityValidator"),
       CredentialActivityWithDetailsValidator: /* @__PURE__ */ __name(() => CredentialActivityWithDetailsValidator, "CredentialActivityWithDetailsValidator"),
       CredentialInfoValidator: /* @__PURE__ */ __name(() => CredentialInfoValidator, "CredentialInfoValidator"),
+      CredentialNameRefValidator: /* @__PURE__ */ __name(() => CredentialNameRefValidator, "CredentialNameRefValidator"),
       CredentialRecordValidator: /* @__PURE__ */ __name(() => CredentialRecordValidator, "CredentialRecordValidator"),
       CredentialSchemaValidator: /* @__PURE__ */ __name(() => CredentialSchemaValidator, "CredentialSchemaValidator"),
       CredentialStatusValidator: /* @__PURE__ */ __name(() => CredentialStatusValidator, "CredentialStatusValidator"),
@@ -145,6 +150,7 @@ var require_types_cjs_development = __commonJS({
       GetFullSkillTreeResultValidator: /* @__PURE__ */ __name(() => GetFullSkillTreeResultValidator, "GetFullSkillTreeResultValidator"),
       GetSkillPathInputValidator: /* @__PURE__ */ __name(() => GetSkillPathInputValidator, "GetSkillPathInputValidator"),
       GetSkillPathResultValidator: /* @__PURE__ */ __name(() => GetSkillPathResultValidator, "GetSkillPathResultValidator"),
+      GetTemplateRecipientsEventValidator: /* @__PURE__ */ __name(() => GetTemplateRecipientsEventValidator, "GetTemplateRecipientsEventValidator"),
       IdentifierEntryValidator: /* @__PURE__ */ __name(() => IdentifierEntryValidator, "IdentifierEntryValidator"),
       IdentifierTypeValidator: /* @__PURE__ */ __name(() => IdentifierTypeValidator, "IdentifierTypeValidator"),
       IdentityObjectValidator: /* @__PURE__ */ __name(() => IdentityObjectValidator, "IdentityObjectValidator"),
@@ -14592,7 +14598,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       "PROFILE_PARENT_APPROVED",
       "APP_LISTING_SUBMITTED",
       "APP_LISTING_APPROVED",
-      "APP_LISTING_REJECTED"
+      "APP_LISTING_REJECTED",
+      "DEVICE_LINK_REQUEST"
     ]);
     var LCNNotificationMessageValidator = external_exports.object({
       title: external_exports.string().optional(),
@@ -14731,6 +14738,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       webhookUrl: external_exports.string().optional(),
       boostUri: external_exports.string().optional(),
       activityId: external_exports.string().optional(),
+      integrationId: external_exports.string().optional(),
       signingAuthority: external_exports.object({
         endpoint: external_exports.string().optional(),
         name: external_exports.string().optional()
@@ -14832,8 +14840,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       claimUrl: external_exports.string().url().optional(),
       recipientDid: external_exports.string().optional()
     });
+    var CredentialNameRefValidator = external_exports.object({ name: external_exports.string() }).passthrough();
     var ClaimInboxCredentialValidator = external_exports.object({
-      credential: VCValidator.or(VPValidator).or(UnsignedVCValidator).describe("The credential to issue."),
+      credential: VCValidator.or(VPValidator).or(UnsignedVCValidator).or(CredentialNameRefValidator).describe("The credential to issue, or a { name } reference to resolve a boost template."),
       configuration: external_exports.object({
         publishableKey: external_exports.string(),
         signingAuthorityName: external_exports.string().optional(),
@@ -15116,6 +15125,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       "STANDARD",
       "DEMOTED"
     ]);
+    var AgeRatingValidator = external_exports.enum(["4+", "9+", "12+", "17+"]);
     var AppStoreListingValidator = external_exports.object({
       listing_id: external_exports.string(),
       slug: external_exports.string().optional(),
@@ -15135,7 +15145,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       terms_url: external_exports.string().optional(),
       highlights: external_exports.array(external_exports.string()).optional(),
       screenshots: external_exports.array(external_exports.string()).optional(),
-      hero_background_color: external_exports.string().optional()
+      hero_background_color: external_exports.string().optional(),
+      min_age: external_exports.number().int().min(0).max(18).optional(),
+      age_rating: AgeRatingValidator.optional()
     });
     var AppStoreListingCreateValidator = AppStoreListingValidator.omit({
       listing_id: true,
@@ -15163,9 +15175,39 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     var SendCredentialEventValidator = external_exports.object({
       type: external_exports.literal("send-credential"),
       templateAlias: external_exports.string(),
-      templateData: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+      templateData: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+      preventDuplicateClaim: external_exports.boolean().optional()
+    });
+    var CheckCredentialEventValidator = external_exports.object({
+      type: external_exports.literal("check-credential"),
+      templateAlias: external_exports.string().optional(),
+      boostUri: external_exports.string().optional()
+    }).refine((input) => Boolean(input.templateAlias) !== Boolean(input.boostUri), {
+      message: "Exactly one of templateAlias or boostUri is required"
+    });
+    var CheckIssuanceStatusEventValidator = external_exports.object({
+      type: external_exports.literal("check-issuance-status"),
+      templateAlias: external_exports.string().optional(),
+      boostUri: external_exports.string().optional(),
+      recipient: external_exports.string()
+    }).refine((input) => Boolean(input.templateAlias) !== Boolean(input.boostUri), {
+      message: "Exactly one of templateAlias or boostUri is required"
     });
-    var AppEventValidator = external_exports.discriminatedUnion("type", [SendCredentialEventValidator]);
+    var GetTemplateRecipientsEventValidator = external_exports.object({
+      type: external_exports.literal("get-template-recipients"),
+      templateAlias: external_exports.string().optional(),
+      boostUri: external_exports.string().optional(),
+      limit: external_exports.number().optional(),
+      cursor: external_exports.string().optional()
+    }).refine((input) => Boolean(input.templateAlias) !== Boolean(input.boostUri), {
+      message: "Exactly one of templateAlias or boostUri is required"
+    });
+    var AppEventValidator = external_exports.discriminatedUnion("type", [
+      SendCredentialEventValidator,
+      CheckCredentialEventValidator,
+      CheckIssuanceStatusEventValidator,
+      GetTemplateRecipientsEventValidator
+    ]);
     var AppEventInputValidator = external_exports.object({
       listingId: external_exports.string(),
       event: AppEventValidator
@@ -15228,6 +15270,19 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       failed: external_exports.number(),
       claimRate: external_exports.number()
     });
+    var AuthSessionError = class extends Error {
+      static {
+        __name(this, "AuthSessionError");
+      }
+      constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = "AuthSessionError";
+      }
+      static {
+        __name2(this, "AuthSessionError");
+      }
+    };
   }
 });
 
@@ -15246,13 +15301,16 @@ var require_dist = __commonJS({
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AGE_RATING_TO_MIN_AGE: () => AGE_RATING_TO_MIN_AGE,
   DEFAULT_RESOLUTIONS: () => DEFAULT_RESOLUTIONS,
   ImageResizingValidator: () => ImageResizingValidator,
   ImageUploadingValidator: () => ImageUploadingValidator,
   ImageWithLoadingStateValdator: () => ImageWithLoadingStateValdator,
   RegExpTransformer: () => RegExpTransformer,
+  calculateAgeFromDob: () => calculateAgeFromDob,
   capitalizeFirstLetter: () => capitalizeFirstLetter,
   changeQuality: () => changeQuality4,
+  checkAppInstallEligibility: () => checkAppInstallEligibility,
   curriedArraySlice: () => curriedArraySlice,
   curriedInnerImmerOuterImmer: () => curriedInnerImmerOuterImmer,
   curriedInnerImmerOuterReact: () => curriedInnerImmerOuterReact,
@@ -16096,6 +16154,90 @@ var ImageWithLoadingStateValdator = import_zod.z.object({
 var isNotUndefined = /* @__PURE__ */ __name((value) => Boolean(value), "isNotUndefined");
 var filterUndefined = /* @__PURE__ */ __name((arr) => arr.filter(isNotUndefined), "filterUndefined");
 
+// src/app-install/index.ts
+var checkAppInstallEligibility = /* @__PURE__ */ __name((input) => {
+  const {
+    isChildProfile,
+    userAge,
+    minAge,
+    ageRating,
+    hasContract,
+    hasGuardianApproval = false
+  } = input;
+  const ageRatingMinAge = getAgeRatingMinAge(ageRating);
+  const isHardBlocked = userAge !== null && minAge !== void 0 && minAge > 0 && userAge < minAge;
+  if (isHardBlocked) {
+    return {
+      action: "hard_blocked",
+      reason: `User does not meet the minimum age requirement of ${minAge}`
+    };
+  }
+  if (isChildProfile) {
+    const noAgeRating = ageRatingMinAge === 0;
+    const childAgeUnknown = userAge === null;
+    const childTooYoung = userAge !== null && userAge < ageRatingMinAge;
+    if (childAgeUnknown) {
+      if (hasGuardianApproval) {
+        return { action: "proceed" };
+      }
+      return {
+        action: "require_dob",
+        reason: "Child profile age is unknown and must be verified by guardian"
+      };
+    }
+    if (noAgeRating) {
+      if (hasGuardianApproval) {
+        return { action: "proceed" };
+      }
+      return {
+        action: "require_guardian_approval",
+        reason: "App has no age rating; guardian approval required for child profiles"
+      };
+    }
+    if (childTooYoung) {
+      if (hasGuardianApproval) {
+        return { action: "proceed" };
+      }
+      return {
+        action: "require_guardian_approval",
+        reason: `Child is under the age rating of ${ageRatingMinAge}+; guardian approval required`
+      };
+    }
+    if (hasContract) {
+      if (hasGuardianApproval) {
+        return { action: "proceed" };
+      }
+      return {
+        action: "require_guardian_approval",
+        reason: "App requires consent to a contract; guardian approval required for child profiles"
+      };
+    }
+  }
+  return { action: "proceed" };
+}, "checkAppInstallEligibility");
+var AGE_RATING_TO_MIN_AGE = {
+  "4+": 4,
+  "9+": 9,
+  "12+": 12,
+  "17+": 17
+};
+var getAgeRatingMinAge = /* @__PURE__ */ __name((ageRating) => {
+  if (!ageRating) return 0;
+  return AGE_RATING_TO_MIN_AGE[ageRating] ?? 0;
+}, "getAgeRatingMinAge");
+var calculateAgeFromDob = /* @__PURE__ */ __name((dob) => {
+  if (!dob) return null;
+  const birthDate = new Date(dob);
+  if (isNaN(birthDate.getTime())) return null;
+  const today = /* @__PURE__ */ new Date();
+  let age = today.getFullYear() - birthDate.getFullYear();
+  const monthDiff = today.getMonth() - birthDate.getMonth();
+  if (monthDiff < 0 || monthDiff === 0 && today.getDate() < birthDate.getDate()) {
+    age--;
+  }
+  return age;
+}, "calculateAgeFromDob");
+
 // src/index.ts
 var isHex = /* @__PURE__ */ __name((str) => /^[0-9a-f]+$/i.test(str), "isHex");
 var isEncrypted = /* @__PURE__ */ __name((item) => {