@thunderid/javascript 1.7.0 → 1.8.1

package/dist/utils/getAuthorizeRequestUrlParams.d.ts

@@ -1,13 +1,14 @@
-import { ExtendedAuthorizeRequestUrlParams } from '../models/oauth-request';
+import { AuthorizeRequestParamValue, ExtendedAuthorizeRequestUrlParams } from '../models/oauth-request';
 /**
  * Generates a map of authorization request URL parameters for OIDC authorization requests.
  *
  * This utility ensures the `openid` scope is always included, handles both string and array forms of the `scope` parameter,
  * and supports PKCE and custom parameters. Throws if a code challenge is provided without a code challenge method.
  *
- * @param options - The main options for the authorization request, including redirectUri, clientId, scope, responseMode, codeChallenge, codeChallengeMethod, prompt, and randomState (a value generated from random bytes that makes the `state` unique to this request).
+ * @param options - The main options for the authorization request, including redirectUri, clientId, scope, responseMode, codeChallenge, codeChallengeMethod, prompt, authorizationDetails, and randomState (a value generated from random bytes that makes the `state` unique to this request).
  * @param pkceOptions - PKCE options, including the PKCE key for state correlation.
  * @param customParams - Optional custom parameters to include in the request (excluding the `state` param, which is handled separately).
+ * An object or array value, such as RFC 9396 `authorization_details`, is sent JSON-encoded.
  * @returns A Map of key-value pairs representing the authorization request URL parameters.
  *
  * @throws {ThunderIDRuntimeError} If a code challenge is provided without a code challenge method.
@@ -40,6 +41,6 @@ declare const getAuthorizeRequestUrlParams: (options: {
     scopes?: string;
 } & ExtendedAuthorizeRequestUrlParams, pkceOptions: {
     key: string;
-}, customParams: Record<string, string | number | boolean>) => Map<string, string>;
+}, customParams: Record<string, AuthorizeRequestParamValue>) => Map<string, string>;
 export default getAuthorizeRequestUrlParams;
 //# sourceMappingURL=getAuthorizeRequestUrlParams.d.ts.map

package/dist/utils/getAuthorizeRequestUrlParams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getAuthorizeRequestUrlParams.d.ts","sourceRoot":"","sources":["../../src/utils/getAuthorizeRequestUrlParams.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,iCAAiC,EAAC,MAAM,yBAAyB,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,QAAA,MAAM,4BAA4B,GAChC,SAAS;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,iCAAiC,EACrC,aAAa;IAAC,GAAG,EAAE,MAAM,CAAA;CAAC,EAC1B,cAAc,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,KACtD,GAAG,CAAC,MAAM,EAAE,MAAM,CAoEpB,CAAC;AAEF,eAAe,4BAA4B,CAAC"}
+{"version":3,"file":"getAuthorizeRequestUrlParams.d.ts","sourceRoot":"","sources":["../../src/utils/getAuthorizeRequestUrlParams.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,0BAA0B,EAAE,iCAAiC,EAAC,MAAM,yBAAyB,CAAC;AAEtG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,QAAA,MAAM,4BAA4B,GAChC,SAAS;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,iCAAiC,EACrC,aAAa;IAAC,GAAG,EAAE,MAAM,CAAA;CAAC,EAC1B,cAAc,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,KACvD,GAAG,CAAC,MAAM,EAAE,MAAM,CAkFpB,CAAC;AAEF,eAAe,4BAA4B,CAAC"}

package/dist/utils/getConsentElementDecision.d.ts

@@ -0,0 +1,20 @@
+import { ConsentAttributeElement, PromptElement } from '../models/embedded-flow';
+/**
+ * Builds the decision on one optional consent element. An approved authorization detail element carries
+ * the values the user modified on it; any other element carries only its name and approval.
+ *
+ * @param purposeId - The identifier of the consent purpose the element belongs to.
+ * @param element - The consent element.
+ * @param approved - Whether the user approved the element.
+ * @param inputs - Form values, holding the JSON text of each modified field under its modified key.
+ * @returns The element decision.
+ *
+ * @example
+ * ```typescript
+ * getConsentElementDecision('p1', element, true, {'__consent_modified__p1__d-1__amount': '20'})
+ * // returns {approved: true, name: 'd-1', modified: {amount: 20}}
+ * ```
+ */
+declare const getConsentElementDecision: (purposeId: string, element: PromptElement, approved: boolean, inputs: Record<string, unknown>) => ConsentAttributeElement;
+export default getConsentElementDecision;
+//# sourceMappingURL=getConsentElementDecision.d.ts.map

package/dist/utils/getConsentElementDecision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConsentElementDecision.d.ts","sourceRoot":"","sources":["../../src/utils/getConsentElementDecision.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,uBAAuB,EAAE,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,yBAAyB,GAC7B,WAAW,MAAM,EACjB,SAAS,aAAa,EACtB,UAAU,OAAO,EACjB,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,uBAMF,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/dist/utils/getConsentInvalidKey.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Prefix of the form keys that mark an authorization detail field whose entered text cannot be submitted.
+ */
+export declare const CONSENT_INVALID_KEY_PREFIX = "__consent_invalid__";
+/**
+ * Generates the form key that marks one field of an authorization detail as holding text that cannot be
+ * submitted. The stored value is `true` while the field shows such text, and empty otherwise.
+ *
+ * @param purposeId - The identifier of the consent purpose the authorization detail belongs to.
+ * @param detailId - The identifier of the authorization detail, its consent element name.
+ * @param path - Dot-separated location of the field within the detail.
+ * @returns A stable form key string.
+ *
+ * @example
+ * ```typescript
+ * getConsentInvalidKey('p1', 'd-1', 'instructedAmount.amount') // returns '__consent_invalid__p1__d-1__instructedAmount.amount'
+ * ```
+ */
+declare const getConsentInvalidKey: (purposeId: string, detailId: string, path: string) => string;
+export default getConsentInvalidKey;
+//# sourceMappingURL=getConsentInvalidKey.d.ts.map

package/dist/utils/getConsentInvalidKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConsentInvalidKey.d.ts","sourceRoot":"","sources":["../../src/utils/getConsentInvalidKey.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,oBAAoB,GAAI,WAAW,MAAM,EAAE,UAAU,MAAM,EAAE,MAAM,MAAM,KAAG,MACf,CAAC;AAEpE,eAAe,oBAAoB,CAAC"}

package/dist/utils/getConsentModifiedKey.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Prefix of the form keys that hold the values a user modified on an authorization detail.
+ */
+export declare const CONSENT_MODIFIED_KEY_PREFIX = "__consent_modified__";
+/**
+ * Generates the form key that holds the value a user chose for one field of an authorization
+ * detail. The stored value is the JSON text of the field's new value.
+ *
+ * @param purposeId - The identifier of the consent purpose the authorization detail belongs to.
+ * @param detailId - The identifier of the authorization detail, its consent element name.
+ * @param path - Dot-separated location of the field within the detail.
+ * @returns A stable form key string.
+ *
+ * @example
+ * ```typescript
+ * getConsentModifiedKey('p1', 'd-1', 'instructedAmount.amount') // returns '__consent_modified__p1__d-1__instructedAmount.amount'
+ * ```
+ */
+declare const getConsentModifiedKey: (purposeId: string, detailId: string, path: string) => string;
+export default getConsentModifiedKey;
+//# sourceMappingURL=getConsentModifiedKey.d.ts.map

package/dist/utils/getConsentModifiedKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConsentModifiedKey.d.ts","sourceRoot":"","sources":["../../src/utils/getConsentModifiedKey.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,qBAAqB,GAAI,WAAW,MAAM,EAAE,UAAU,MAAM,EAAE,MAAM,MAAM,KAAG,MACf,CAAC;AAErE,eAAe,qBAAqB,CAAC"}

package/dist/utils/getConsentModifiedValues.d.ts

@@ -0,0 +1,20 @@
+import { PromptElement } from '../models/embedded-flow';
+/**
+ * Collects the values a user modified on an authorization detail element, for the `modified` member
+ * of its consent decision. Only fields the element lets the user modify are read, and a field left at
+ * the value that was shown, or marked as holding text that cannot be submitted, is left out.
+ *
+ * @param purposeId - The identifier of the consent purpose the element belongs to.
+ * @param element - The authorization detail element.
+ * @param inputs - Form values, holding the JSON text of each changed field under its modified key and its
+ * invalid marker under its invalid key.
+ * @returns The changed values keyed by field path, or `undefined` when nothing was changed.
+ *
+ * @example
+ * ```typescript
+ * getConsentModifiedValues('p1', element, {'__consent_modified__p1__d-1__amount': '20'}) // returns {amount: 20}
+ * ```
+ */
+declare const getConsentModifiedValues: (purposeId: string, element: PromptElement, inputs: Record<string, unknown>) => Record<string, unknown> | undefined;
+export default getConsentModifiedValues;
+//# sourceMappingURL=getConsentModifiedValues.d.ts.map

package/dist/utils/getConsentModifiedValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConsentModifiedValues.d.ts","sourceRoot":"","sources":["../../src/utils/getConsentModifiedValues.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,wBAAwB,GAC5B,WAAW,MAAM,EACjB,SAAS,aAAa,EACtB,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAoB5B,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thunderid/javascript",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "JavaScript Ecosystem SDK for ThunderID",
   "keywords": [
     "thunderid",