@learncard/helpers 1.7.3 → 1.8.0

package/dist/age-policy.d.ts

@@ -0,0 +1,9 @@
+export declare const GDPR_AGE_LIMIT: Record<string, number>;
+export declare const DEFAULT_EU_AGE_LIMIT = 16;
+export declare const GDPR_AGE_LIMIT_BY_CODE: Record<string, number>;
+export declare const EU_COUNTRY_CODES: string[];
+/** EU countries use the established GDPR threshold; other countries default to 18. */
+export declare const getMinorAgeThreshold: (countryCode?: string) => number;
+/** Returns completed years for a valid ISO date/timestamp, or NaN if invalid/future. */
+export declare const calculateAgeFromISODate: (dob: string, now?: Date) => number;
+//# sourceMappingURL=age-policy.d.ts.map

package/dist/age-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"age-policy.d.ts","sourceRoot":"","sources":["../src/age-policy.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASjD,CAAC;AAEF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASzD,CAAC;AAEF,eAAO,MAAM,gBAAgB,UA4B5B,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,KAAG,MAK3D,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,uBAAuB,GAAI,KAAK,MAAM,EAAE,MAAK,IAAiB,KAAG,MAsB7E,CAAC"}

package/dist/consent-flow-contract-updates.d.ts

@@ -0,0 +1,29 @@
+import type { ConsentFlowContract, ConsentFlowContractChangeKind, ConsentFlowContractDiff, ConsentFlowContractUpdatePreview } from '@learncard/types';
+/** Whether a published optional-choice proposal window has not yet expired. */
+export declare const hasOpenNewOptionsWindow: (newOptionsUntil: string | undefined, now?: number) => boolean;
+export type ConsentFlowContractSnapshot = {
+    contract: ConsentFlowContract;
+    name: string;
+    subtitle?: string;
+    description?: string;
+    reasonForAccessing?: string;
+    image?: string;
+    needsGuardianConsent?: boolean;
+    redirectUrl?: string;
+    frontDoorBoostUri?: string;
+    expiresAt?: string;
+    /** Stable URI/id identity is preferred; URI/id-bearing objects are canonicalized. */
+    autoboosts?: unknown[];
+    writers?: string[];
+};
+export declare const diffContractChange: (prev: ConsentFlowContractSnapshot, next: ConsentFlowContractSnapshot) => ConsentFlowContractDiff;
+export declare const classifyContractChange: (prev: ConsentFlowContractSnapshot, next: ConsentFlowContractSnapshot) => ConsentFlowContractChangeKind;
+export declare const buildContractUpdatePreview: ({ name, kind, diff, status, translate, }: {
+    name: string;
+    kind: ConsentFlowContractChangeKind;
+    diff: ConsentFlowContractDiff;
+    status?: string;
+    /** Clients localize structured changes; the API retains canonical English copy. */
+    translate?: (key: string, values?: Record<string, unknown>) => string;
+}) => ConsentFlowContractUpdatePreview;
+//# sourceMappingURL=consent-flow-contract-updates.d.ts.map

package/dist/consent-flow-contract-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent-flow-contract-updates.d.ts","sourceRoot":"","sources":["../src/consent-flow-contract-updates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,mBAAmB,EACnB,6BAA6B,EAE7B,uBAAuB,EAEvB,gCAAgC,EACnC,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,GAChC,iBAAiB,MAAM,GAAG,SAAS,EACnC,YAAgB,KACjB,OAAwE,CAAC;AAE5E,MAAM,MAAM,2BAA2B,GAAG;IACtC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAgEF,eAAO,MAAM,kBAAkB,GAC3B,MAAM,2BAA2B,EACjC,MAAM,2BAA2B,KAClC,uBAqBF,CAAC;AA2BF,eAAO,MAAM,sBAAsB,GAC/B,MAAM,2BAA2B,EACjC,MAAM,2BAA2B,KAClC,6BAyBF,CAAC;AAyNF,eAAO,MAAM,0BAA0B,GAAI,0CAMxC;IACC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,6BAA6B,CAAC;IACpC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;CACzE,KAAG,gCAqEH,CAAC"}

package/dist/credential-refresh.d.ts

@@ -1,4 +1,4 @@
-import { type ManagedCredentialRefreshService, type SupportedCredentialRefreshService } from '@learncard/types';
+import { type ManagedCredentialRefreshService, type SupportedCredentialRefreshService, type CredentialRefreshReceipt, type JWE } from '@learncard/types';
 /**
  * Canonical helpers for credential refresh (LC-2117, LC-2135, LC-2136).
  *
@@ -47,6 +47,21 @@ export declare const getCredentialEffectiveTime: (vc: RefreshableCredential) =>
 export declare const canonicalizeCredentialContent: <T>(value: T) => T;
 /** Serializes a value to a deterministic canonical JSON string */
 export declare const canonicalizeCredentialJson: (value: unknown) => string;
+/** Structural recipient check only; decryption and credential verification remain mandatory. */
+export declare const assertExactJweRecipients: (jwe: JWE, recipientKeyIds: string[]) => void;
+/** Compares exact public bindings while ignoring JSON object-key order, never array order. */
+export declare const credentialRefreshBindingsEqual: (credential: {
+    credentialStatus?: unknown;
+    refreshService?: unknown;
+}, baseline: {
+    credentialStatus?: unknown;
+    refreshService?: unknown;
+}) => boolean;
+/** Checks signed identity and public bindings. Legacy managed-entry receipts bind only the
+ * unique managed service; exact receipts also bind additional services and array shape.
+ * This does not replace proof/status verification.
+ */
+export declare const assertManagedCredentialBinding: (credential: RefreshableCredential, receipt: CredentialRefreshReceipt) => void;
 /** IRI the managed refresh service type term must resolve to. */
 export declare const MANAGED_REFRESH_TYPE_IRI = "https://learncard.com/refresh#LearnCardCredentialRefresh2026";
 /** OBv3-namespaced IRI for the authorization term of a managed refresh service. */

package/dist/credential-refresh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credential-refresh.d.ts","sourceRoot":"","sources":["../src/credential-refresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,EACzC,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;GAOG;AAEH,KAAK,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACnD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACnC,IAAI,qBAAqB,KAC1B,iCAAiC,GAAG,SActC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,IAAI,qBAAqB,KAAG,MAAM,GAAG,SAO1E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,IAAI,qBAAqB,KAAG,MAAM,GAAG,SAQ/E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,CAiB3D,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,MACJ,CAAC;AAUzD,iEAAiE;AACjE,eAAO,MAAM,wBAAwB,iEAC6B,CAAC;AAEnE,mFAAmF;AACnF,eAAO,MAAM,iCAAiC,0DACa,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,4DACoB,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;CAMlC,CAAC;AAIX,KAAK,oCAAoC,GAAG;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AA4CF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAClC,IAAI,oCAAoC,KACzC,+BAA+B,EAYjC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,GAAI,CAAC,EAAE,YAAY,CAAC,KAAG,CAqF/D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,EACzC,YAAY,CAAC,EACb,gBAAgB,+BAA+B,KAChD,CAoCF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAChC,OAAO,qBAAqB,EAC5B,QAAQ,qBAAqB,KAC9B,OAWF,CAAC"}
+{"version":3,"file":"credential-refresh.d.ts","sourceRoot":"","sources":["../src/credential-refresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,EACtC,KAAK,wBAAwB,EAC7B,KAAK,GAAG,EACX,MAAM,kBAAkB,CAAC;AAQ1B;;;;;;;GAOG;AAEH,KAAK,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACnD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACnC,IAAI,qBAAqB,KAC1B,iCAAiC,GAAG,SActC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,IAAI,qBAAqB,KAAG,MAAM,GAAG,SAO1E,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,IAAI,qBAAqB,KAAG,MAAM,GAAG,SAQ/E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,CAiB3D,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,MACJ,CAAC;AAEzD,gGAAgG;AAChG,eAAO,MAAM,wBAAwB,GAAI,KAAK,GAAG,EAAE,iBAAiB,MAAM,EAAE,KAAG,IAa9E,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,8BAA8B,GACvC,YAAY;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,EACpE,UAAU;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,KACnE,OAIwD,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GACvC,YAAY,qBAAqB,EACjC,SAAS,wBAAwB,KAClC,IAqCF,CAAC;AAUF,iEAAiE;AACjE,eAAO,MAAM,wBAAwB,iEAC6B,CAAC;AAEnE,mFAAmF;AACnF,eAAO,MAAM,iCAAiC,0DACa,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,4DACoB,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;CAMlC,CAAC;AAIX,KAAK,oCAAoC,GAAG;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AA4CF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAClC,IAAI,oCAAoC,KACzC,+BAA+B,EAYjC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,GAAI,CAAC,EAAE,YAAY,CAAC,KAAG,CAsG/D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,EACzC,YAAY,CAAC,EACb,gBAAgB,+BAA+B,KAChD,CAoCF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAChC,OAAO,qBAAqB,EAC5B,QAAQ,qBAAqB,KAC9B,OAWF,CAAC"}