@raytio/types 5.2.0 → 6.0.1

package/dist/raytio.d.ts

@@ -1,9 +1,11 @@
 import { Encrypted } from "./crypto";
-import { Colors } from "./theme";
+import { Colors, CustomFonts } from "./theme";
 /** @internal see Microsoft/TypeScript#202 */
 export declare type StringWithIdentity<T> = string & {
     $$typeof$$: T;
 };
+/** @internal */
+declare type Json = Record<string, any>;
 /** A `p_id` is the ID of a @see Relationship */
 export declare type PId = StringWithIdentity<"PId">;
 /** An `i_id` is the ID of an @see Instance */
@@ -16,12 +18,12 @@ export declare type GId = StringWithIdentity<"GId">;
 export declare type UId = StringWithIdentity<"UId">;
 /** An `a_id` is the ID of an @see AA */
 export declare type AId = StringWithIdentity<"AId">;
-/** @internal */
+/** An `o_id` is the ID of an @see Organization */
+export declare type OId = StringWithIdentity<"OId">;
 export declare type DataTypes = "string" | "number" | "boolean" | "object" | "integer" | "array" | "null";
-/** @internal */
 export declare type SubmissionStatus = "Submitted" | "Processing" | "Rejected" | "Expired" | "Completed" | "DataChanged" | "Received" | "Accepted";
 /** You can supply an option type argument if you know exactly what the properties will be */
-export declare type ProfileObject<Properties = any> = {
+export declare type ProfileObject<Properties = Json> = {
     n_id: NId;
     properties: Properties;
     labels: string[];
@@ -31,10 +33,10 @@ export declare type ProfileObject<Properties = any> = {
      * @internal the client adds this, if this PO doesn't actually belong to the current user,
      * i.e. it's actually from a submission. If truthy, it's the `[aId, iId]` of the submission.
      */
-    isFromSubmission?: [aId: string, iId: string];
+    isFromSubmission?: [aId: AId, iId: IId];
 };
 /** @internal This is what we send the API */
-export declare type ProfileObjectForUpload<Properties = any> = {
+export declare type ProfileObjectForUpload<Properties = Json> = {
     properties: Properties;
     document?: {
         content?: string | Encrypted;
@@ -75,6 +77,8 @@ export declare type Lookup = {
     label?: string | number;
     children?: Lookup[];
     description?: string;
+    /** used in AkahuDynamicSection only */
+    requires_2FA?: boolean;
 };
 export declare type AA = {
     a_id: AId;
@@ -91,12 +95,17 @@ export declare type AA = {
     /** markdown or string help information including [phoneNumber || email] */
     aa_help?: string;
     theme?: {
-        colors: Colors;
+        font?: CustomFonts;
+        colors?: Colors;
     };
     /** the n_id of the associated service provider */
     service_provider_n_id?: NId;
     /** the id of the associated organisation */
-    org_id: string;
+    org_id: OId;
+    /** configuration for the submission rules */
+    ruleset?: unknown;
+    /** if true, only specific email addresses can submit the form */
+    auth_list_enabled?: boolean;
     /** @internal */
     _transitions?: unknown[];
 };
@@ -123,7 +132,7 @@ export declare type Instance = {
     /** @depreacted The status of a submission */
     _state?: SubmissionStatus;
     /** Previous status of the shared information */
-    previous_state: string;
+    previous_state: SubmissionStatus;
     /** Hash of the Service Provider ID */
     sub_service_provider_hash?: string;
     /** Service provider ID */
@@ -145,7 +154,7 @@ export declare type Instance = {
  * NOTE: this is different to how the schema defines an Organization. **The schema is wrong (see #468)**
  */
 export declare type Organization = {
-    id: string;
+    id: OId;
     name: string;
     email: string;
     address: {
@@ -174,3 +183,4 @@ export declare type Validation = {
         };
     };
 };
+export {};

package/dist/schema.d.ts

@@ -7,27 +7,27 @@ export declare type ConditionallyRequired = {
         [fieldName: string]: string[];
     };
 };
-export declare type SchemaFieldTag = "password" | `group:${string}` | `upload-group:${string}` | "display:stars" | "display:no_autofill" | "display:currency" | "display:cascade" | "display:survey" | "display:quoting" | "display:customModal" | "display:showOnWizard" | `display:main_media:${string}` | "action:client_upload" | "verify:show_if_pending" | "special:hide_select_behind_button" | "type:extract_required";
-export declare type SchemaTag = "action:experimental_pass_object_store_id" | "action:verify" | "default_camera:rear" | "default_camera:front" | "type:service_provider" | "type:service_offer" | "type:marketplace" | "type:client_only" | "type:globally_unique_field";
+export declare type SchemaFieldTag = "password" | `group:${string}` | `upload-group:${string}` | "display:stars" | "display:no_autofill" | "display:currency" | "display:cascade" | "display:survey" | "display:quoting" | "display:customModal" | "display:terms_conditions" | "display:showOnWizard" | `display:main_media:${string}` | "date_component:day" | "date_component:month" | "date_component:year" | "action:client_upload" | "verify:show_if_pending" | "special:hide_select_behind_button" | "type:capture_geolocation" | "type:extract_required";
+export declare type SchemaTag = "action:experimental_pass_object_store_id" | "action:verify" | "default_camera:rear" | "default_camera:front" | `oauth2_component:name:${string}` | `oauth2_component:redirect_url:${string}` | `link_to:${string}:${string}` | "type:service_provider" | "type:service_offer" | "type:marketplace" | "type:client_only" | "type:globally_unique_field";
 export declare type SchemaField = {
     /** @deprecated don't use, it's inconsistent */
     $id?: string;
     title?: string;
+    title_plural?: string;
     description?: string;
     /** readOnly means the Wizard won't show this field */
     readOnly?: boolean;
     examples?: unknown[];
     tags?: SchemaFieldTag[];
     type?: DataTypes;
-    enum?: unknown[];
+    enum?: string[];
     maximum?: number;
     minimum?: number;
     /** @deprecated raytio's usage not documented */
     maxLength?: number;
     /** @deprecated raytio's usage not documented */
     minLength?: number;
-    /** @internal added by the client. It's the default value based on the existing values from subschema on their profile */
-    defaultValue?: unknown;
+    /** the default value */
     default?: unknown;
     pattern?: string;
     /** whether the field should be encrypted */
@@ -35,13 +35,17 @@ export declare type SchemaField = {
     format?: "date" | "date-time";
     contentMediaType?: string;
     contentEncoding?: "base64";
-    /** for nested JSON */
+    /** `items` is used for nested arrays, (while `properties` is used for nested objects) */
     items?: {
         type: DataTypes;
         properties: {
             [subFieldName: string]: SchemaField;
         };
     };
+    /** `properties` is used for nested objects, (while `items` is used for nested arrays) */
+    properties?: {
+        [subFieldName: string]: SchemaField;
+    };
     /** If this field refers to a sub-object */
     $ref?: string;
     /**
@@ -61,10 +65,10 @@ export declare type SchemaField = {
     /** URL to a JSON file in the `Lookup` format */
     lookup?: string;
     /** @internal the client adds this - it's the fieldName. */
-    $prop?: string;
+    $prop: string;
     priority?: number;
     /** @internal if supplied, it's the existing field values. Added by the client */
-    subObjectRef?: (string | number)[];
+    subObjectRef?: unknown[];
     /** specifies that the description is formatted in markdown */
     description_decorator?: "md";
     /** if a `pattern` is specified, this is the error message */
@@ -80,6 +84,8 @@ export declare type SchemaField = {
     };
     /** if this field is a table input, this determines the text to show on the "Add Row" btn */
     add_row_btn_label?: string;
+    /** if this field is a table input, this determines the text to show if the table is empty */
+    table_empty_message?: string;
     /**
      * used on fields that are a signature file picker, see !849
      * also used to determine if the MediaPicker should be shown inline
@@ -101,8 +107,12 @@ export declare type Schema = {
     $id?: string;
     $schema?: string;
     n_id?: NId;
-    /** name will always exist on schema */
+    /** these fields will always exist on schema */
     name: string;
+    title: string;
+    description: string;
+    /** plural version of the title */
+    title_plural?: string;
     /**
      * the group that a schema belongs to, such as "passports". This is useful for
      * forms that accept different types of similar documents.
@@ -110,10 +120,11 @@ export declare type Schema = {
     schema_group?: string;
     /** the localized title of the `schema_group`. added by the client */
     group_title?: string;
-    title?: string;
-    description?: string;
     /** @deprecated not sure why a schema would have this, only fields should */
     $ref?: string;
+    version?: string;
+    /** whether the `version` is the latest version */
+    version_current?: boolean;
     tags?: SchemaTag[];
     /** originally `string[]`, the client modifies this */
     verified_fields?: (string | ConditionallyRequired)[];
@@ -129,13 +140,10 @@ export declare type Schema = {
         if?: Schema;
         then?: Schema;
     }[];
-    /**
-     * this is deliberately an optional prop, there are cases where properties are
-     * undefined, e.g.
-     *  - from get-all-schema API
-     *  - if the schema is a sub-object
-     */
-    properties?: {
+    /** If this tag exists, the schema is deprecated. ISO Date. */
+    end_date?: string;
+    /** 🚨 Note that there are cases where properties are undefined, e.g. if the schema is a sub-object */
+    properties: {
         [fieldName: string]: SchemaField;
     };
     i18n?: {
@@ -171,7 +179,7 @@ export declare type Schema = {
             $loading_pending_ver_resubmit: {
                 title: string;
             };
-            [fieldNameOrGroupName: string]: SchemaField & {
+            [fieldNameOrGroupName: string]: Omit<SchemaField, "$prop"> & {
                 title_plural?: string;
             };
         };
@@ -270,3 +278,15 @@ export declare type Schema = {
         return_to?: string;
     };
 };
+/** Only certain properties from the schema */
+export declare type SchemaMetadata = Pick<Schema, "name" | "title" | "description" | "schema_group" | "end_date" | "i18n" | "display" | "tags" | "clientLocale" | "groupNames" | "title_plural" | "group_title"> & {
+    /**
+     * @deprecated this prop exists so that SchemaMetadata does not extend Schema.
+     * use `getSchema(schemaName)` to fetch the full schema
+     */
+    __typeof__: "You cannot supply SchemaMetadata to a function that expects Schema";
+    isProfileSchema: boolean;
+    isSpSchema: boolean;
+};
+/** @ignore */
+export declare type RelationDefinition = NonNullable<Schema["relationships"]>[number];

package/dist/theme.d.ts

@@ -24,3 +24,7 @@ export declare type Colors = {
     blankBackground: string;
     blank: string;
 };
+export declare type CustomFonts = {
+    header?: string;
+    body?: string;
+};

package/dist/verification.d.ts

@@ -1,4 +1,28 @@
 import { NId, ProfileObject } from "./raytio";
+export declare type VerificationPayload<WithValue extends boolean> = {
+    field: string;
+    schema?: string;
+    metadata?: Record<string, unknown>;
+    passed: boolean;
+    request_div: string;
+    /** @deprecated don't use this, it looks like the schema name but it's not */
+    source: string;
+    /** the n_id of the parent profile object that this ver belongs (NOT the n_id of the field) */
+    source_n_id?: NId;
+    /** like `source_n_id` */
+    source_hashed_n_id?: NId;
+    type?: null;
+    v_id: string;
+    verification_date: string;
+    verifier_id?: NId;
+    verifier_source_id?: NId;
+    verifier_service_id?: NId;
+    verifier_div: string;
+    /** ISO Date */
+    valid_until?: string;
+} & (WithValue extends true ? {
+    value: string | number;
+} : {});
 /**
  * Different APIs inconsistently include the `value` prop. If you know it exists,
  * use `Verification<true>`, otherwise just `Verification`. Verifications from
@@ -16,24 +40,7 @@ export declare type Verification<WithValue extends boolean = false> = ProfileObj
     verifications: [
         {
             signature: string;
-            data: {
-                field: string;
-                metadata?: Record<string, unknown>;
-                passed: boolean;
-                request_div: string;
-                /** @deprecated don't use this, it looks like the schema name but it's not */
-                source: string;
-                /** the n_id of the parent profile object that this ver belongs (NOT the n_id of the field) */
-                source_n_id: NId;
-                v_id: string;
-                verification_date: string;
-                verifier_id?: NId;
-                verifier_source_id?: NId;
-                verifier_service_id?: NId;
-                verifier_div: string;
-            } & (WithValue extends true ? {
-                value: string | number;
-            } : {});
+            data: VerificationPayload<WithValue>;
         }
     ];
 }>;
@@ -62,12 +69,12 @@ export declare type VerificationProvider = {
     dataSourceNId?: NId;
     serviceProviderNId?: NId;
     /** the date which the verification was verified on, or last re-verified on */
-    date: Date;
+    date?: Date;
 };
 /** This is what @raytio/core exposes, which is more useable than @see Verification */
 export declare type RealVer = {
     fieldName: string;
-    value: string | number;
+    value: unknown;
     provider: VerificationProvider;
     signature: string;
     /**

package/dist/verification.js

@@ -5,6 +5,8 @@ exports.POVerification = exports.FieldVerification = void 0;
  * "Not Verified" means show no badge, cf. "Verified False" means the
  * verifier revealed that the data was wrong. So show a ❌
  */
+// We cannot change the enum values, since ScoreRules have been generated
+// with the enum values hardcoded. The enum value are also used to find the "best" or "worst" verification (lower=better)
 var FieldVerification;
 (function (FieldVerification) {
     FieldVerification[FieldVerification["Verified"] = 60001] = "Verified";
@@ -12,6 +14,8 @@ var FieldVerification;
     FieldVerification[FieldVerification["VerifiedFalse"] = 60003] = "VerifiedFalse";
     FieldVerification[FieldVerification["Expired"] = 60004] = "Expired";
 })(FieldVerification = exports.FieldVerification || (exports.FieldVerification = {}));
+// We cannot change the enum values, since ScoreRules have been generated
+// with the enum values hardcoded.
 var POVerification;
 (function (POVerification) {
     POVerification[POVerification["FullyVerified"] = 70001] = "FullyVerified";

package/dist/wizard.d.ts

@@ -1,11 +1,15 @@
 import { AId } from "./raytio";
 /** configuration data for a single wizard page (@see WizardConfig) */
-export interface WizardPage {
+export declare type WizardPage = {
     /** if undefined, the schema title will be used */
     name?: string | symbol;
     filter: "oneOf" | "anyOf";
     schemas: string[];
+    /** the fallback description, if there isn't one for the specific situation */
     description?: string;
+    description_select?: string;
+    description_create?: string;
+    description_update?: string;
     /** if explictly == false, then it's an AO (not a PO), in which case there can only be one schema */
     profile?: boolean;
     /** if true this page can be skipped. The PageResult wil be undefined */
@@ -37,13 +41,17 @@ export interface WizardPage {
     extract_threshold_pass_action?: "review" | "next_step";
     /** for ImageDynamicSection, the action to take if pre-verify fails */
     extract_threshold_fail_action?: "capture" | "capture_review" | "recapture_or_next_step" | "review" | "next_step";
+    /** for ImageDynamicSection, the action to take if the API returns no `validation: {}` object */
+    extract_threshold_null_action?: WizardPage["extract_threshold_fail_action"];
     /** if `false`, ProfileObjects created while completing the form will not be verified. `undefined` implies `true` */
-    verify?: boolean;
+    verify_data?: boolean;
     /** a list of fields that should not be required, even if the schema says they're required */
     optional_fields?: string[];
-    /** the infomation to share. undefined implies both. */
+    /** the information to share. undefined implies both. */
     share?: "profile" | "verification" | "both";
-}
+    /** can you force the colour theme to change for just one page (#1066, #1074). At the moment this on pages that use WebcamImageCapture */
+    display_mode?: "light" | "dark" | "default";
+};
 /**
  * when a form link is generated, this is what gets saved on the API.
  * Each value can be overriden in the query parameters. If specified
@@ -75,7 +83,7 @@ export declare type WizardConfig = {
     /** if specified, the email addresses that a submission should be sent to */
     emails?: string[];
     /**
-     * whether the "quick onboard" process should be used if the user visits
+     * whether the passwordless-signup process should be used if the user visits
      * this form, and they are not logged in. If false, the standard sign-up
      * process will be used
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raytio/types",
-  "version": "5.2.0",
+  "version": "6.0.1",
   "license": "MIT",
   "main": "index",
   "types": "index",
@@ -12,6 +12,7 @@
   ],
   "scripts": {
     "docs": "sh ../../scripts/generate-docs.sh",
-    "build": "tsc"
+    "test": "npm run build",
+    "build": "tsc && rm -rf dist/__tests__"
   }
 }

package/src/__tests__/schema.ts

@@ -0,0 +1,23 @@
+/* eslint-disable fp/no-let, @typescript-eslint/no-unused-vars */
+import { Schema, SchemaField, SchemaMetadata } from "..";
+
+/**
+ * this file is not run, it is just compiled by tsc
+ * If compilation suceeds, then the test passes.
+ */
+
+let schema: Schema;
+let schemaField: SchemaField;
+let schemaMetadata: SchemaMetadata;
+
+function f() {
+  // @ts-expect-error SchemaField should not extend Schema
+  const test1: SchemaField = schema;
+  // @ts-expect-error Schema should not extend SchemaField
+  const test2: Schema = schemaField;
+
+  // @ts-expect-error SchemaMetadata should not extend Schema
+  const test3: SchemaMetadata = schema;
+  // @ts-expect-error Schema should not extend SchemaMetadata
+  const test4: Schema = schemaMetadata;
+}

package/src/crypto.ts

@@ -1,10 +1,11 @@
-export type Encrypted<Data = string> = {
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export type Encrypted<_Data = string> = {
   encrypted_key: {
     encrypted_key: string;
   };
   encrypted_data: {
     iv: string;
-    data: Data;
+    data: string;
     algorithm: AesKeyAlgorithm;
   };
 };

package/src/raytio.ts

@@ -1,9 +1,12 @@
 import { Encrypted } from "./crypto";
-import { Colors } from "./theme";
+import { Colors, CustomFonts } from "./theme";
 
 /** @internal see Microsoft/TypeScript#202 */
 export type StringWithIdentity<T> = string & { $$typeof$$: T };
 
+/** @internal */
+type Json = Record<string, any>; // TODO: (semver breaking) unknown
+
 /** A `p_id` is the ID of a @see Relationship */
 export type PId = StringWithIdentity<"PId">;
 /** An `i_id` is the ID of an @see Instance */
@@ -16,8 +19,9 @@ export type GId = StringWithIdentity<"GId">;
 export type UId = StringWithIdentity<"UId">;
 /** An `a_id` is the ID of an @see AA */
 export type AId = StringWithIdentity<"AId">;
+/** An `o_id` is the ID of an @see Organization */
+export type OId = StringWithIdentity<"OId">;
 
-/** @internal */
 export type DataTypes =
   | "string"
   | "number"
@@ -27,7 +31,6 @@ export type DataTypes =
   | "array"
   | "null";
 
-/** @internal */
 export type SubmissionStatus =
   | "Submitted"
   | "Processing"
@@ -39,7 +42,7 @@ export type SubmissionStatus =
   | "Accepted";
 
 /** You can supply an option type argument if you know exactly what the properties will be */
-export type ProfileObject<Properties = any> = {
+export type ProfileObject<Properties = Json> = {
   n_id: NId;
   properties: Properties;
   labels: string[];
@@ -49,11 +52,11 @@ export type ProfileObject<Properties = any> = {
    * @internal the client adds this, if this PO doesn't actually belong to the current user,
    * i.e. it's actually from a submission. If truthy, it's the `[aId, iId]` of the submission.
    */
-  isFromSubmission?: [aId: string, iId: string]; // TODO: do NOT use nominal types here, see microsoft/TypeScript#42773
+  isFromSubmission?: [aId: AId, iId: IId];
 };
 
 /** @internal This is what we send the API */
-export type ProfileObjectForUpload<Properties = any> = {
+export type ProfileObjectForUpload<Properties = Json> = {
   properties: Properties;
   document?: {
     content?: string | Encrypted;
@@ -82,7 +85,7 @@ export type UrnNodeType =
   | "user"
   | "profile_object"
   | "instance"
-  | "temp_object" // this will only be encountered in backend environments which lack access to an applicationDecryptor
+  | "temp_object" // this will only be encountered in backend environments which lack access to an applicationDecryptor, or from RapidShare
   | "document";
 
 /** e.g. "urn:user:..." */
@@ -107,6 +110,9 @@ export type Lookup = {
   label?: string | number;
   children?: Lookup[];
   description?: string;
+
+  /** used in AkahuDynamicSection only */
+  requires_2FA?: boolean;
 };
 
 export type AA = {
@@ -124,12 +130,21 @@ export type AA = {
   /** markdown or string help information including [phoneNumber || email] */
   aa_help?: string;
   theme?: {
-    colors: Colors;
+    font?: CustomFonts;
+    colors?: Colors;
   };
   /** the n_id of the associated service provider */
   service_provider_n_id?: NId;
   /** the id of the associated organisation */
-  org_id: string;
+  org_id: OId;
+
+  /** configuration for the submission rules */
+  // we know the type should be `ScoreConfig`, but we can't rely that it's valid, or the right version
+  ruleset?: unknown;
+
+  /** if true, only specific email addresses can submit the form */
+  auth_list_enabled?: boolean;
+
   /** @internal */
   _transitions?: unknown[];
 };
@@ -157,7 +172,7 @@ export type Instance = {
   /** @depreacted The status of a submission */
   _state?: SubmissionStatus;
   /** Previous status of the shared information */
-  previous_state: string;
+  previous_state: SubmissionStatus;
   /** Hash of the Service Provider ID */
   sub_service_provider_hash?: string;
   /** Service provider ID */
@@ -182,7 +197,7 @@ export type Instance = {
  * NOTE: this is different to how the schema defines an Organization. **The schema is wrong (see #468)**
  */
 export type Organization = {
-  id: string;
+  id: OId;
   name: string;
   email: string;
   address: {