@fill-easy/api 1.0.28 → 1.0.30

package/dist/openapi.d.ts

@@ -649,6 +649,99 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/uaepass/request/auth": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Authentication
+         * @description Retrieves user identity details following a successful UAE Pass login.
+         */
+        post: operations["uaepassAuth"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/uaepass/poll": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Poll Data
+         * @description Short poll this endpoint, passing in the `token` (from endpoints in `Request Data` folder) to obtain the results.
+         *
+         *     For authentication, this includes user data. For signing, this provides a link by which the signed document can be obtained.
+         *
+         *     The response's `token` is a JWT or JWE depending if there's sensitive personal data. You should handle them like so:
+         *
+         *     - `JWT` verify\* token
+         *
+         *     - `JWE` decrypt using the private keys that Fill Easy has previously provided.
+         *
+         *
+         *     Please note that the data result is returned only once and is deleted immediately.
+         *
+         *     \*you can try using online decoder like [https://jwt.io/](https://jwt.io/)
+         *
+         *     all responses are `JWE` unless noted otherwise.
+         */
+        post: operations["uaepassPoll"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/uaepass/callback": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Callback
+         * @description UAE Pass will redirect to this endpoint after user authorization.
+         *     This endpoint then redirects the user again to the original `redirect` URI provided in the `/uaepass/request/auth` request, appending the authorization `code` and `state` as query parameters.
+         */
+        get: operations["uaepassCallback"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/uaepass/logout": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** UAEPass Logout */
+        post: operations["uaepassLogout"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/ocr/request": {
         parameters: {
             query?: never;
@@ -878,28 +971,15 @@ export interface paths {
         put?: never;
         /**
          * Request
-         * @description This endpoint may retrieve the company JSON and document via two methods:
-         *
-         *     #### Automated retrieval using Company ID for supported countries
-         *
-         *     If the country supplied in `countryCode` is in the [AutomatedCountry](/models) Model,
-         *     and the supplied `companyId` is valid, the system will automatically fetch the document.
+         * @description Initiate a company report request. Returns a JWT token for use with `/cra/poll`.
          *
-         *     In order to ensure a valid `companyId`, please validate using `/cra/{countryCode}/search/companies`.
+         *     **Required:** `countryCode` (ISO 3166 alpha-2)
          *
-         *     In this case, `/cra/poll` will resolve in around 5 minutes.
+         *     **Recommended:** `companyId` from `/cra/{countryCode}/search/companies` for faster automated processing.
          *
-         *     The `/cra/{countryCode}/search/companies` endpoint will not return a
-         *     companyId for certain countries (empty string). In that case please
-         *     refer to the information in the section below.
+         *     **Fallback:** Provide `companyName` if `companyId` is unavailable — request will be processed manually.
          *
-         *     #### Manual request for unsupported countries or missing Company ID
-         *
-         *     In case of unsupported countries or missing `companyId`, Fill Easy will manually process the request.
-         *     Retrieving this information may take longer (up to several days).
-         *
-         *     In any case, the endpoint returns a JWT token that should be used with the
-         *     `/cra/poll` endpoint to retrieve the document when ready.
+         *     **Document Request:** Provide `documentId` from `/cra/{countryCode}/search/documents` to request specific document.
          */
         post: operations["craRequest"];
         delete?: never;
@@ -1038,74 +1118,21 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/uaepass/request/auth": {
+    "/cra/info": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Authentication
-         * @description Retrieves user identity details following a successful UAE Pass login.
-         */
-        post: operations["uaepassAuth"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/uaepass/poll": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Poll Data
-         * @description Short poll this endpoint, passing in the `token` (from endpoints in `Request Data` folder) to obtain the results.
-         *
-         *     For authentication, this includes user data. For signing, this provides a link by which the signed document can be obtained.
-         *
-         *     The response's `token` is a JWT or JWE depending if there's sensitive personal data. You should handle them like so:
-         *
-         *     - `JWT` verify\* token
-         *
-         *     - `JWE` decrypt using the private keys that Fill Easy has previously provided.
-         *
-         *
-         *     Please note that the data result is returned only once and is deleted immediately.
-         *
-         *     \*you can try using online decoder like [https://jwt.io/](https://jwt.io/)
+         * Info
+         * @description Returns metadata and a list of all countries supported by the CorpVerify service,
+         *     including their automation status, available search capabilities, and report contents.
          *
-         *     all responses are `JWE` unless noted otherwise.
+         *     > For an up-to-date version of the same data, please view the [CorpVerify Country Coverage table](countries).
          */
-        post: operations["uaepassPoll"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/uaepass/callback": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Callback
-         * @description UAE Pass will redirect to this endpoint after user authorization.
-         *     This endpoint then redirects the user again to the original `redirect` URI provided in the `/uaepass/request/auth` request, appending the authorization `code` and `state` as query parameters.
-         */
-        get: operations["uaepassCallback"];
+        get: operations["craInfo"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1114,23 +1141,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/uaepass/logout": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** UAEPass Logout */
-        post: operations["uaepassLogout"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/lra/request": {
         parameters: {
             query?: never;
@@ -1195,11 +1205,49 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
-        /**
-         * @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code for regions with fully automated support.
-         * @enum {string}
-         */
-        AutomatedCountry: "HK" | "AU" | "CN";
+        Country: {
+            /**
+             * @description Country name
+             * @example Hong Kong
+             */
+            name: string;
+            /**
+             * @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code.
+             * @example HK
+             */
+            code: string;
+            /**
+             * @description Geographic region
+             * @example Asia
+             */
+            region: string;
+            /**
+             * @description ISO 639-1 language code for the source language of documents
+             * @example en
+             */
+            sourceLanguage: string;
+            /**
+             * @description Whether the country is fully automated or requires manual processing
+             * @enum {string}
+             */
+            status: "automated" | "manual";
+            search: {
+                /** @description Whether document search is available */
+                documents: boolean;
+                /** @description Whether company name search is available */
+                companies: boolean;
+                /** @description Whether company ID lookup is available */
+                company: boolean;
+            };
+            contents: {
+                /** @description Whether registration information is available */
+                registration: boolean;
+                /** @description Whether shareholder information is available */
+                sharedholder: boolean;
+                /** @description Whether financial information is available */
+                financial: boolean;
+            };
+        };
         Error: {
             /**
              * @description Error message
@@ -2385,6 +2433,143 @@ export interface operations {
             };
         };
     };
+    uaepassAuth: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    redirect: components["schemas"]["RedirectUri"];
+                    /**
+                     * @description List of values, separated by spaces, that represent the scope of the authorization that the application wants to obtain.
+                     *     It queries the scopes required for accessing the resources or services in question.
+                     *     Available scopes: sub, fullnameAR, gender, mobile, lastnameEN, fullnameEN, uuid, lastnameAR, idn, nationalityEN, firstnameEN, userType, nationalityAR, firstnameAR, email.
+                     *     (To be shared by UAEPASS Team if its value is other than specified in sample above)
+                     * @example sub fullnameEN email mobile
+                     */
+                    scope?: string;
+                    /**
+                     * @description UAE Pass display language, case sensitive
+                     * @example en
+                     * @enum {string}
+                     */
+                    lang?: "en" | "ar";
+                    /**
+                     * @description Platform source for the authentication request
+                     * @example PC_Browser
+                     * @enum {string}
+                     */
+                    source: "PC_Browser" | "android" | "iOS" | "Mobile_Browser";
+                };
+            };
+        };
+        responses: {
+            /** @description Success */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description JWT token for polling authentication status */
+                        token: string;
+                        /**
+                         * Format: uri
+                         * @description UAE Pass authorization URL to redirect user to
+                         */
+                        oAuthUrl: string;
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            500: components["responses"]["InternalServerError"];
+        };
+    };
+    uaepassPoll: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    token: components["schemas"]["Token"];
+                };
+            };
+        };
+        responses: {
+            /** @description Success */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        message?: string;
+                        token?: components["schemas"]["Token"];
+                    };
+                };
+            };
+        };
+    };
+    uaepassCallback: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    uaepassLogout: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    redirect: components["schemas"]["RedirectUri"];
+                };
+            };
+        };
+        responses: {
+            /** @description Success */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uri
+                         * @description UAE Pass logout URL to redirect user to
+                         */
+                        logoutUrl: string;
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            500: components["responses"]["InternalServerError"];
+        };
+    };
     request1: {
         parameters: {
             query?: never;
@@ -3179,7 +3364,7 @@ export interface operations {
                     /** @description Company ID (e.g., BRN for Hong Kong, ACN for Australia) */
                     companyId?: string;
                     /** @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code (case insensitive) */
-                    countryCode: components["schemas"]["AutomatedCountry"] | string;
+                    countryCode: string;
                     /**
                      * @description Type of document
                      * @default companySearch
@@ -3469,7 +3654,7 @@ export interface operations {
             header?: never;
             path: {
                 /** @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code in lowercase. */
-                countryCode: "hk" | "cn" | "au" | "sg" | "ky" | "th" | "us" | "bm" | "kh" | "ph";
+                countryCode: string;
             };
             cookie?: never;
         };
@@ -3518,7 +3703,7 @@ export interface operations {
             header?: never;
             path: {
                 /** @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code. */
-                countryCode: "hk" | "ph";
+                countryCode: string;
             };
             cookie?: never;
         };
@@ -3535,7 +3720,7 @@ export interface operations {
                      */
                     documentType?: "financialStatement" | "annualReturn" | "GIS" | "AFS";
                     /** @description Optional filter by year */
-                    documentYear?: number;
+                    documentYear?: string;
                 };
             };
         };
@@ -3602,7 +3787,7 @@ export interface operations {
             header?: never;
             path: {
                 /** @description [ISO 3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code. */
-                countryCode: "hk" | "au" | "sg" | "th" | "us" | "kh" | "ph";
+                countryCode: string;
             };
             cookie?: never;
         };
@@ -3648,141 +3833,50 @@ export interface operations {
             };
         };
     };
-    uaepassAuth: {
+    craInfo: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": {
-                    redirect: components["schemas"]["RedirectUri"];
-                    /**
-                     * @description List of values, separated by spaces, that represent the scope of the authorization that the application wants to obtain.
-                     *     It queries the scopes required for accessing the resources or services in question.
-                     *     Available scopes: sub, fullnameAR, gender, mobile, lastnameEN, fullnameEN, uuid, lastnameAR, idn, nationalityEN, firstnameEN, userType, nationalityAR, firstnameAR, email.
-                     *     (To be shared by UAEPASS Team if its value is other than specified in sample above)
-                     * @example sub fullnameEN email mobile
-                     */
-                    scope?: string;
-                    /**
-                     * @description UAE Pass display language, case sensitive
-                     * @example en
-                     * @enum {string}
-                     */
-                    lang?: "en" | "ar";
-                    /**
-                     * @description Platform source for the authentication request
-                     * @example PC_Browser
-                     * @enum {string}
-                     */
-                    source: "PC_Browser" | "android" | "iOS" | "Mobile_Browser";
-                };
-            };
-        };
-        responses: {
-            /** @description Success */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        /** @description JWT token for polling authentication status */
-                        token: string;
-                        /**
-                         * Format: uri
-                         * @description UAE Pass authorization URL to redirect user to
-                         */
-                        oAuthUrl: string;
-                    };
-                };
-            };
-            400: components["responses"]["BadRequest"];
-            500: components["responses"]["InternalServerError"];
-        };
-    };
-    uaepassPoll: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": {
-                    token: components["schemas"]["Token"];
-                };
-            };
-        };
+        requestBody?: never;
         responses: {
-            /** @description Success */
+            /** @description Successfully retrieved country information */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": {
-                        message?: string;
-                        token?: components["schemas"]["Token"];
+                        meta: {
+                            /** @description Total number of countries */
+                            totalCountries: number;
+                            /** @description Number of automated countries */
+                            automated: number;
+                            /** @description Number of manual countries */
+                            manual: number;
+                            /** @description Number of countries with at least one search capability */
+                            searchable: number;
+                        };
+                        countries: components["schemas"]["Country"][];
                     };
                 };
             };
-        };
-    };
-    uaepassCallback: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Success */
-            200: {
+            /** @description Bad Request */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-        };
-    };
-    uaepassLogout: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": {
-                    redirect: components["schemas"]["RedirectUri"];
-                };
-            };
-        };
-        responses: {
-            /** @description Success */
-            200: {
+            /** @description Internal server error */
+            500: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": {
-                        /**
-                         * Format: uri
-                         * @description UAE Pass logout URL to redirect user to
-                         */
-                        logoutUrl: string;
-                    };
-                };
+                content?: never;
             };
-            400: components["responses"]["BadRequest"];
-            500: components["responses"]["InternalServerError"];
         };
     };
     lraRequest: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fill-easy/api",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "type": "module",
   "description": "Type-safe SDK for Fill Easy API",
   "main": "dist/index.js",