@arbidocs/client 0.4.68 → 0.4.70

package/dist/index.d.cts

@@ -1758,89 +1758,115 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/sign/prepare': {
+    '/v1/document/{document_ext_id}/markup': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Prepare Document Signature
-         * @description Return the exact statement the signer's key must sign, and the hash of the PDF they are shown.
+         * Get Document Markup
+         * @description The version's marks and their revision (0 = no markup yet). Anyone who can see the document
+         *     can read them; ``can_edit`` says whether the caller may save.
          */
-        post: operations['prepare_document_signature'];
+        get: operations['get_document_markup'];
+        /**
+         * Save Document Markup
+         * @description Save the version's whole layer, overwriting its markup in place.
+         *
+         *     Optimistic concurrency: the save must name the revision it started from (``If-Match`` or
+         *     ``base_revision``). When someone saved in between, nothing is written and the 409 carries the
+         *     latest revision: the client re-reads it, merges by annotation id and saves again.
+         */
+        put: operations['save_document_markup'];
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/sign': {
+    '/v1/document/{document_ext_id}/markup/pdf': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Sign Document
-         * @description Sign a document: verify the signer's statement, seal a signed copy, save it as the document's next
-         *     version (reason ``signed``; the document keeps its id).
+         * Download Document Markup
+         * @description "Download with markup": the version's PDF with its annotations as native PDF annotations
+         *     (Acrobat, Preview and other viewers show them). The plain download serves the original.
          */
-        post: operations['sign_document'];
+        get: operations['download_document_markup'];
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/signatures': {
+    '/v1/document/{document_ext_id}/sign/prepare': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get Document Signature Status
-         * @description Is this document version a signed copy, and is it unchanged since signing? Read from the PDF itself.
+         * Prepare Document Signature
+         * @description Return the exact statement the signer's key must sign, and the hash of the PDF they are shown.
+         *
+         *     ``appearance`` and ``include_date`` are part of the statement: send the same ones to ``/sign``.
          */
-        get: operations['get_document_signature_status'];
-        put?: never;
-        post?: never;
+        post: operations['prepare_document_signature'];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/markup': {
+    '/v1/document/{document_ext_id}/sign': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get Document Markup
-         * @description The version's marks and their revision (0 = no markup yet). Anyone who can see the document
-         *     can read them; ``can_edit`` says whether the caller may save.
+         * Sign Document
+         * @description Sign a document: verify the signer's statement, seal a signed copy, save it as the document's next
+         *     version (reason ``signed``; the document keeps its id) and record the evidence under the signing's
+         *     reference, whose public certificate the signature links to.
          */
-        get: operations['get_document_markup'];
+        post: operations['sign_document'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/document/{document_ext_id}/signatures': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Save Document Markup
-         * @description Save the version's whole layer, overwriting its markup in place.
-         *
-         *     Optimistic concurrency: the save must name the revision it started from (``If-Match`` or
-         *     ``base_revision``). When someone saved in between, nothing is written and the 409 carries the
-         *     latest revision: the client re-reads it, merges by annotation id and saves again.
+         * Get Document Signature Status
+         * @description Is this document version a signed copy, and is it unchanged since signing? The seals are checked
+         *     on the stored PDF itself (a signed PDF changed outside ARBI and uploaded again shows as not intact);
+         *     who signed comes from the signing records the seals name.
          */
-        put: operations['save_document_markup'];
+        get: operations['get_document_signature_status'];
+        put?: never;
         post?: never;
         delete?: never;
         options?: never;
@@ -1848,7 +1874,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/markup/pdf': {
+    '/v1/sign/verify/{reference}': {
         parameters: {
             query?: never;
             header?: never;
@@ -1856,11 +1882,12 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Download Document Markup
-         * @description "Download with markup": the version's PDF with its annotations as native PDF annotations
-         *     (Acrobat, Preview and other viewers show them). The plain download serves the original.
+         * Verify Signature
+         * @description The public certificate of a signing (no login): who signed, when, the SHA-256 of each signed
+         *     revision and whether its seal verified. ``reference`` is the one the signature links to; 404 if
+         *     there is no such signing. Never exposes email, document content or ids.
          */
-        get: operations['download_document_markup'];
+        get: operations['verify_signature'];
         put?: never;
         post?: never;
         delete?: never;
@@ -10725,6 +10752,12 @@ interface components {
             signer: components['schemas']['SignerDetails'];
             /** @description Omit for the bottom of the last page */
             appearance?: components['schemas']['SignatureAppearance'] | null;
+            /**
+             * Include Date
+             * @description Show the signing date under the signature. Must match the sign request.
+             * @default false
+             */
+            include_date: boolean;
         };
         /** PrepareSignatureResponse */
         PrepareSignatureResponse: {
@@ -12712,6 +12745,12 @@ interface components {
             signer: components['schemas']['SignerDetails'];
             /** @description Omit for the bottom of the last page */
             appearance?: components['schemas']['SignatureAppearance'] | null;
+            /**
+             * Include Date
+             * @description Show the signing date under the signature. Must match the prepare request.
+             * @default false
+             */
+            include_date: boolean;
             /** Timestamp */
             timestamp: number;
             /**
@@ -12797,21 +12836,16 @@ interface components {
              */
             signer_name?: string | null;
             /**
-             * Capacity
-             * @description The signer's role, e.g. 'Partner'
+             * Certificate Url
+             * @description The public certificate page of this signing
              */
-            capacity?: string | null;
-            /**
-             * On Behalf Of
-             * @description Who the signer signed for, e.g. a firm
-             */
-            on_behalf_of?: string | null;
+            certificate_url: string;
         };
         /** SignatureStatusResponse */
         SignatureStatusResponse: {
             /**
              * Signed
-             * @description This document is a PDF signed and sealed by ARBI
+             * @description This document version is a PDF signed and sealed by ARBI
              */
             signed: boolean;
             /**
@@ -12825,26 +12859,45 @@ interface components {
              * @default false
              */
             timestamped: boolean;
+            /**
+             * Certificate Url
+             * @description The public certificate of this version (its latest signing)
+             */
+            certificate_url?: string | null;
             /**
              * Signatures
              * @default []
              */
             signatures: components['schemas']['SignatureRecord'][];
         };
-        /** SignerDetails */
-        SignerDetails: {
-            /** Name */
-            name: string;
+        /**
+         * SignatureVerification
+         * @description The public certificate of a signing: no email, document content or ids.
+         */
+        SignatureVerification: {
+            /**
+             * Signatures
+             * @description Every signing in this version, oldest first
+             */
+            signatures: components['schemas']['VerifiedSignature'][];
+            /**
+             * Document Sha256
+             * @description SHA-256 of the signed PDF this reference points to
+             */
+            document_sha256: string;
             /**
-             * Capacity
-             * @description e.g. 'Partner', 'Solicitor'
+             * Intact
+             * @description Every seal in that PDF verified
              */
-            capacity?: string | null;
+            intact: boolean;
+        };
+        /** SignerDetails */
+        SignerDetails: {
             /**
-             * On Behalf Of
-             * @description e.g. the firm's name
+             * Name
+             * @description Rendered as the signature
              */
-            on_behalf_of?: string | null;
+            name: string;
         };
         /**
          * SkillSummaryResponse
@@ -14559,6 +14612,34 @@ interface components {
          * @enum {string}
          */
         VendorKey: 'microsoft' | 'microsoft_sharepoint' | 'gdrive' | 'gmail' | 'imanage' | 'westlaw' | 'clio' | 'box' | 'dropbox' | 'onenote' | 'ms365_mail';
+        /** VerifiedSignature */
+        VerifiedSignature: {
+            /**
+             * Signer Name
+             * @description The name the signer signed as
+             */
+            signer_name: string;
+            /**
+             * Signed At
+             * Format: date-time
+             */
+            signed_at: string;
+            /**
+             * Sha256
+             * @description SHA-256 of the PDF revision this signing sealed
+             */
+            sha256: string;
+            /**
+             * Intact
+             * @description The seal of this revision verified when it was signed
+             */
+            intact: boolean;
+            /**
+             * Timestamped
+             * @description The seal carries an RFC 3161 timestamp
+             */
+            timestamped: boolean;
+        };
         /** VerifyEmailRequest */
         VerifyEmailRequest: {
             /**
@@ -17744,20 +17825,21 @@ interface operations {
             };
         };
     };
-    prepare_document_signature: {
+    get_document_markup: {
         parameters: {
-            query?: never;
-            header?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
+            header?: {
+                'if-none-match'?: string | null;
+            };
             path: {
                 document_ext_id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['PrepareSignatureRequest'];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -17765,8 +17847,15 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['PrepareSignatureResponse'];
+                    'application/json': components['schemas']['MarkupLayerResponse'];
+                };
+            };
+            /** @description Unchanged since the revision in If-None-Match */
+            304: {
+                headers: {
+                    [name: string]: unknown;
                 };
+                content?: never;
             };
             /** @description Validation Error */
             422: {
@@ -17779,10 +17868,15 @@ interface operations {
             };
         };
     };
-    sign_document: {
+    save_document_markup: {
         parameters: {
-            query?: never;
-            header?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
+            header?: {
+                'if-match'?: string | null;
+            };
             path: {
                 document_ext_id: string;
             };
@@ -17790,7 +17884,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['SignDocumentRequest'];
+                'application/json': components['schemas']['SaveMarkupRequest'];
             };
         };
         responses: {
@@ -17800,7 +17894,16 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['SignDocumentResponse'];
+                    'application/json': components['schemas']['SaveMarkupResponse'];
+                };
+            };
+            /** @description Saved by someone else first; re-read and merge */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['MarkupConflict'];
                 };
             };
             /** @description Validation Error */
@@ -17814,7 +17917,7 @@ interface operations {
             };
         };
     };
-    get_document_signature_status: {
+    download_document_markup: {
         parameters: {
             query?: {
                 /** @description Document version (default: the current one) */
@@ -17834,9 +17937,23 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['SignatureStatusResponse'];
+                    'application/pdf': unknown;
                 };
             };
+            /** @description This version has no markup */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description This version is signed: its PDF takes no more changes */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             /** @description Validation Error */
             422: {
                 headers: {
@@ -17848,21 +17965,20 @@ interface operations {
             };
         };
     };
-    get_document_markup: {
+    prepare_document_signature: {
         parameters: {
-            query?: {
-                /** @description Document version (default: the current one) */
-                version?: number | null;
-            };
-            header?: {
-                'if-none-match'?: string | null;
-            };
+            query?: never;
+            header?: never;
             path: {
                 document_ext_id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['PrepareSignatureRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -17870,15 +17986,8 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['MarkupLayerResponse'];
-                };
-            };
-            /** @description Unchanged since the revision in If-None-Match */
-            304: {
-                headers: {
-                    [name: string]: unknown;
+                    'application/json': components['schemas']['PrepareSignatureResponse'];
                 };
-                content?: never;
             };
             /** @description Validation Error */
             422: {
@@ -17891,15 +18000,10 @@ interface operations {
             };
         };
     };
-    save_document_markup: {
+    sign_document: {
         parameters: {
-            query?: {
-                /** @description Document version (default: the current one) */
-                version?: number | null;
-            };
-            header?: {
-                'if-match'?: string | null;
-            };
+            query?: never;
+            header?: never;
             path: {
                 document_ext_id: string;
             };
@@ -17907,7 +18011,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['SaveMarkupRequest'];
+                'application/json': components['schemas']['SignDocumentRequest'];
             };
         };
         responses: {
@@ -17917,16 +18021,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['SaveMarkupResponse'];
-                };
-            };
-            /** @description Saved by someone else first; re-read and merge */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['MarkupConflict'];
+                    'application/json': components['schemas']['SignDocumentResponse'];
                 };
             };
             /** @description Validation Error */
@@ -17940,7 +18035,7 @@ interface operations {
             };
         };
     };
-    download_document_markup: {
+    get_document_signature_status: {
         parameters: {
             query?: {
                 /** @description Document version (default: the current one) */
@@ -17960,15 +18055,39 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/pdf': unknown;
+                    'application/json': components['schemas']['SignatureStatusResponse'];
                 };
             };
-            /** @description This version has no markup */
-            404: {
+            /** @description Validation Error */
+            422: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    verify_signature: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                reference: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['SignatureVerification'];
+                };
             };
             /** @description Validation Error */
             422: {

package/dist/index.d.ts

@@ -1758,89 +1758,115 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/sign/prepare': {
+    '/v1/document/{document_ext_id}/markup': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Prepare Document Signature
-         * @description Return the exact statement the signer's key must sign, and the hash of the PDF they are shown.
+         * Get Document Markup
+         * @description The version's marks and their revision (0 = no markup yet). Anyone who can see the document
+         *     can read them; ``can_edit`` says whether the caller may save.
          */
-        post: operations['prepare_document_signature'];
+        get: operations['get_document_markup'];
+        /**
+         * Save Document Markup
+         * @description Save the version's whole layer, overwriting its markup in place.
+         *
+         *     Optimistic concurrency: the save must name the revision it started from (``If-Match`` or
+         *     ``base_revision``). When someone saved in between, nothing is written and the 409 carries the
+         *     latest revision: the client re-reads it, merges by annotation id and saves again.
+         */
+        put: operations['save_document_markup'];
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/sign': {
+    '/v1/document/{document_ext_id}/markup/pdf': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Sign Document
-         * @description Sign a document: verify the signer's statement, seal a signed copy, save it as the document's next
-         *     version (reason ``signed``; the document keeps its id).
+         * Download Document Markup
+         * @description "Download with markup": the version's PDF with its annotations as native PDF annotations
+         *     (Acrobat, Preview and other viewers show them). The plain download serves the original.
          */
-        post: operations['sign_document'];
+        get: operations['download_document_markup'];
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/signatures': {
+    '/v1/document/{document_ext_id}/sign/prepare': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get Document Signature Status
-         * @description Is this document version a signed copy, and is it unchanged since signing? Read from the PDF itself.
+         * Prepare Document Signature
+         * @description Return the exact statement the signer's key must sign, and the hash of the PDF they are shown.
+         *
+         *     ``appearance`` and ``include_date`` are part of the statement: send the same ones to ``/sign``.
          */
-        get: operations['get_document_signature_status'];
-        put?: never;
-        post?: never;
+        post: operations['prepare_document_signature'];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/markup': {
+    '/v1/document/{document_ext_id}/sign': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get Document Markup
-         * @description The version's marks and their revision (0 = no markup yet). Anyone who can see the document
-         *     can read them; ``can_edit`` says whether the caller may save.
+         * Sign Document
+         * @description Sign a document: verify the signer's statement, seal a signed copy, save it as the document's next
+         *     version (reason ``signed``; the document keeps its id) and record the evidence under the signing's
+         *     reference, whose public certificate the signature links to.
          */
-        get: operations['get_document_markup'];
+        post: operations['sign_document'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/document/{document_ext_id}/signatures': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Save Document Markup
-         * @description Save the version's whole layer, overwriting its markup in place.
-         *
-         *     Optimistic concurrency: the save must name the revision it started from (``If-Match`` or
-         *     ``base_revision``). When someone saved in between, nothing is written and the 409 carries the
-         *     latest revision: the client re-reads it, merges by annotation id and saves again.
+         * Get Document Signature Status
+         * @description Is this document version a signed copy, and is it unchanged since signing? The seals are checked
+         *     on the stored PDF itself (a signed PDF changed outside ARBI and uploaded again shows as not intact);
+         *     who signed comes from the signing records the seals name.
          */
-        put: operations['save_document_markup'];
+        get: operations['get_document_signature_status'];
+        put?: never;
         post?: never;
         delete?: never;
         options?: never;
@@ -1848,7 +1874,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/document/{document_ext_id}/markup/pdf': {
+    '/v1/sign/verify/{reference}': {
         parameters: {
             query?: never;
             header?: never;
@@ -1856,11 +1882,12 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Download Document Markup
-         * @description "Download with markup": the version's PDF with its annotations as native PDF annotations
-         *     (Acrobat, Preview and other viewers show them). The plain download serves the original.
+         * Verify Signature
+         * @description The public certificate of a signing (no login): who signed, when, the SHA-256 of each signed
+         *     revision and whether its seal verified. ``reference`` is the one the signature links to; 404 if
+         *     there is no such signing. Never exposes email, document content or ids.
          */
-        get: operations['download_document_markup'];
+        get: operations['verify_signature'];
         put?: never;
         post?: never;
         delete?: never;
@@ -10725,6 +10752,12 @@ interface components {
             signer: components['schemas']['SignerDetails'];
             /** @description Omit for the bottom of the last page */
             appearance?: components['schemas']['SignatureAppearance'] | null;
+            /**
+             * Include Date
+             * @description Show the signing date under the signature. Must match the sign request.
+             * @default false
+             */
+            include_date: boolean;
         };
         /** PrepareSignatureResponse */
         PrepareSignatureResponse: {
@@ -12712,6 +12745,12 @@ interface components {
             signer: components['schemas']['SignerDetails'];
             /** @description Omit for the bottom of the last page */
             appearance?: components['schemas']['SignatureAppearance'] | null;
+            /**
+             * Include Date
+             * @description Show the signing date under the signature. Must match the prepare request.
+             * @default false
+             */
+            include_date: boolean;
             /** Timestamp */
             timestamp: number;
             /**
@@ -12797,21 +12836,16 @@ interface components {
              */
             signer_name?: string | null;
             /**
-             * Capacity
-             * @description The signer's role, e.g. 'Partner'
+             * Certificate Url
+             * @description The public certificate page of this signing
              */
-            capacity?: string | null;
-            /**
-             * On Behalf Of
-             * @description Who the signer signed for, e.g. a firm
-             */
-            on_behalf_of?: string | null;
+            certificate_url: string;
         };
         /** SignatureStatusResponse */
         SignatureStatusResponse: {
             /**
              * Signed
-             * @description This document is a PDF signed and sealed by ARBI
+             * @description This document version is a PDF signed and sealed by ARBI
              */
             signed: boolean;
             /**
@@ -12825,26 +12859,45 @@ interface components {
              * @default false
              */
             timestamped: boolean;
+            /**
+             * Certificate Url
+             * @description The public certificate of this version (its latest signing)
+             */
+            certificate_url?: string | null;
             /**
              * Signatures
              * @default []
              */
             signatures: components['schemas']['SignatureRecord'][];
         };
-        /** SignerDetails */
-        SignerDetails: {
-            /** Name */
-            name: string;
+        /**
+         * SignatureVerification
+         * @description The public certificate of a signing: no email, document content or ids.
+         */
+        SignatureVerification: {
+            /**
+             * Signatures
+             * @description Every signing in this version, oldest first
+             */
+            signatures: components['schemas']['VerifiedSignature'][];
+            /**
+             * Document Sha256
+             * @description SHA-256 of the signed PDF this reference points to
+             */
+            document_sha256: string;
             /**
-             * Capacity
-             * @description e.g. 'Partner', 'Solicitor'
+             * Intact
+             * @description Every seal in that PDF verified
              */
-            capacity?: string | null;
+            intact: boolean;
+        };
+        /** SignerDetails */
+        SignerDetails: {
             /**
-             * On Behalf Of
-             * @description e.g. the firm's name
+             * Name
+             * @description Rendered as the signature
              */
-            on_behalf_of?: string | null;
+            name: string;
         };
         /**
          * SkillSummaryResponse
@@ -14559,6 +14612,34 @@ interface components {
          * @enum {string}
          */
         VendorKey: 'microsoft' | 'microsoft_sharepoint' | 'gdrive' | 'gmail' | 'imanage' | 'westlaw' | 'clio' | 'box' | 'dropbox' | 'onenote' | 'ms365_mail';
+        /** VerifiedSignature */
+        VerifiedSignature: {
+            /**
+             * Signer Name
+             * @description The name the signer signed as
+             */
+            signer_name: string;
+            /**
+             * Signed At
+             * Format: date-time
+             */
+            signed_at: string;
+            /**
+             * Sha256
+             * @description SHA-256 of the PDF revision this signing sealed
+             */
+            sha256: string;
+            /**
+             * Intact
+             * @description The seal of this revision verified when it was signed
+             */
+            intact: boolean;
+            /**
+             * Timestamped
+             * @description The seal carries an RFC 3161 timestamp
+             */
+            timestamped: boolean;
+        };
         /** VerifyEmailRequest */
         VerifyEmailRequest: {
             /**
@@ -17744,20 +17825,21 @@ interface operations {
             };
         };
     };
-    prepare_document_signature: {
+    get_document_markup: {
         parameters: {
-            query?: never;
-            header?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
+            header?: {
+                'if-none-match'?: string | null;
+            };
             path: {
                 document_ext_id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['PrepareSignatureRequest'];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -17765,8 +17847,15 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['PrepareSignatureResponse'];
+                    'application/json': components['schemas']['MarkupLayerResponse'];
+                };
+            };
+            /** @description Unchanged since the revision in If-None-Match */
+            304: {
+                headers: {
+                    [name: string]: unknown;
                 };
+                content?: never;
             };
             /** @description Validation Error */
             422: {
@@ -17779,10 +17868,15 @@ interface operations {
             };
         };
     };
-    sign_document: {
+    save_document_markup: {
         parameters: {
-            query?: never;
-            header?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
+            header?: {
+                'if-match'?: string | null;
+            };
             path: {
                 document_ext_id: string;
             };
@@ -17790,7 +17884,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['SignDocumentRequest'];
+                'application/json': components['schemas']['SaveMarkupRequest'];
             };
         };
         responses: {
@@ -17800,7 +17894,16 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['SignDocumentResponse'];
+                    'application/json': components['schemas']['SaveMarkupResponse'];
+                };
+            };
+            /** @description Saved by someone else first; re-read and merge */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['MarkupConflict'];
                 };
             };
             /** @description Validation Error */
@@ -17814,7 +17917,7 @@ interface operations {
             };
         };
     };
-    get_document_signature_status: {
+    download_document_markup: {
         parameters: {
             query?: {
                 /** @description Document version (default: the current one) */
@@ -17834,9 +17937,23 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['SignatureStatusResponse'];
+                    'application/pdf': unknown;
                 };
             };
+            /** @description This version has no markup */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description This version is signed: its PDF takes no more changes */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             /** @description Validation Error */
             422: {
                 headers: {
@@ -17848,21 +17965,20 @@ interface operations {
             };
         };
     };
-    get_document_markup: {
+    prepare_document_signature: {
         parameters: {
-            query?: {
-                /** @description Document version (default: the current one) */
-                version?: number | null;
-            };
-            header?: {
-                'if-none-match'?: string | null;
-            };
+            query?: never;
+            header?: never;
             path: {
                 document_ext_id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['PrepareSignatureRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -17870,15 +17986,8 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['MarkupLayerResponse'];
-                };
-            };
-            /** @description Unchanged since the revision in If-None-Match */
-            304: {
-                headers: {
-                    [name: string]: unknown;
+                    'application/json': components['schemas']['PrepareSignatureResponse'];
                 };
-                content?: never;
             };
             /** @description Validation Error */
             422: {
@@ -17891,15 +18000,10 @@ interface operations {
             };
         };
     };
-    save_document_markup: {
+    sign_document: {
         parameters: {
-            query?: {
-                /** @description Document version (default: the current one) */
-                version?: number | null;
-            };
-            header?: {
-                'if-match'?: string | null;
-            };
+            query?: never;
+            header?: never;
             path: {
                 document_ext_id: string;
             };
@@ -17907,7 +18011,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['SaveMarkupRequest'];
+                'application/json': components['schemas']['SignDocumentRequest'];
             };
         };
         responses: {
@@ -17917,16 +18021,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['SaveMarkupResponse'];
-                };
-            };
-            /** @description Saved by someone else first; re-read and merge */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['MarkupConflict'];
+                    'application/json': components['schemas']['SignDocumentResponse'];
                 };
             };
             /** @description Validation Error */
@@ -17940,7 +18035,7 @@ interface operations {
             };
         };
     };
-    download_document_markup: {
+    get_document_signature_status: {
         parameters: {
             query?: {
                 /** @description Document version (default: the current one) */
@@ -17960,15 +18055,39 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/pdf': unknown;
+                    'application/json': components['schemas']['SignatureStatusResponse'];
                 };
             };
-            /** @description This version has no markup */
-            404: {
+            /** @description Validation Error */
+            422: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    verify_signature: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                reference: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['SignatureVerification'];
+                };
             };
             /** @description Validation Error */
             422: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/client",
-  "version": "0.4.68",
+  "version": "0.4.70",
   "description": "TypeScript SDK for the ARBI API — zero-knowledge auth, E2E encryption, and type-safe REST client",
   "type": "module",
   "sideEffects": false,