@arbidocs/client 0.3.140 → 0.3.142

package/dist/index.d.cts

@@ -247,6 +247,9 @@ interface paths {
          *     For each email:
          *     - If user already exists: Adds them to contacts with status="registered"
          *     - If user doesn't exist: Sends invitation email and creates contact with status="invited"
+         *     - If an invitation is already pending: returns the contact unchanged without
+         *       resending, since a resend rotates the code and invalidates the link already
+         *       sent. Delete the contact to invite again before the invitation expires.
          *
          *     Protected endpoint - requires authentication.
          *     Returns list of created contact records.
@@ -1971,7 +1974,12 @@ interface paths {
         };
         /**
          * List Notes Endpoint
-         * @description List notes visible in the active workspace (newest first).
+         * @description List notes visible in the active workspace.
+         *
+         *     Newest first by default. Passing a date range (or ``dated_only``) turns this
+         *     into the timeline: only dated notes, ordered by when they happened. Each
+         *     bound is read at its own precision and widened outward, so ``date_to=2019``
+         *     runs through 31 December rather than stopping on 1 January.
          */
         get: operations['list_notes'];
         put?: never;
@@ -2026,6 +2034,36 @@ interface paths {
         patch: operations['update_note'];
         trace?: never;
     };
+    '/v1/notes/{note_ext_id}/remind': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Remind Note Endpoint
+         * @description Set a one-off reminder for a dated note, and link it to the note.
+         *
+         *     Give an explicit ``remind_at`` or a ``lead_minutes`` offset before the note's
+         *     date; with neither it fires when the note's span starts. Only dated notes can
+         *     be reminded about — there is nothing to fire relative to otherwise.
+         *
+         *     The reminder is deliberately CONTENT-FREE: it names the note by external id
+         *     and nothing else. ``tasks.name`` is plaintext while ``notes.content`` is
+         *     encrypted under the workspace key, so copying the text into the reminder
+         *     would leak the very thing the note protects. The client resolves the text
+         *     from the note when it displays the notification.
+         */
+        post: operations['remind_note'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/notifications/ws-schemas': {
         parameters: {
             query?: never;
@@ -5139,7 +5177,7 @@ interface components {
          */
         ContactResponse: {
             /** External Id */
-            external_id: string;
+            external_id?: string | null;
             /** Email */
             email: string;
             user?: components['schemas']['UserResponse'] | null;
@@ -5147,9 +5185,13 @@ interface components {
              * Status
              * @enum {string}
              */
-            status: 'invitation_pending' | 'invitation_expired' | 'registered';
+            status: 'invitation_pending' | 'invitation_expired' | 'registered' | 'failed';
             /** Created At */
             created_at: string;
+            /** Outcome */
+            outcome?: ('invited' | 'reinvited' | 'not_resent_still_pending' | 'contact_added' | 'already_contact' | 'failed') | null;
+            /** Outcome Detail */
+            outcome_detail?: string | null;
         };
         /**
          * ContextUsage
@@ -5486,8 +5528,12 @@ interface components {
              * @enum {string}
              */
             source: 'manual' | 'learning' | 'curator';
-            /** Note Date */
-            note_date?: string | null;
+            /** Date */
+            date?: string | null;
+            /** Date End */
+            date_end?: string | null;
+            /** Timezone */
+            timezone?: string | null;
             /**
              * Tag Ext Ids
              * @default []
@@ -7485,8 +7531,17 @@ interface components {
             shared: boolean;
             /** Source */
             source: string;
-            /** Note Date */
-            note_date?: string | null;
+            /** Date Start */
+            date_start?: string | null;
+            /** Date End */
+            date_end?: string | null;
+            /** Timezone */
+            timezone?: string | null;
+            /**
+             * Reminder Task Ext Ids
+             * @default []
+             */
+            reminder_task_ext_ids: string[];
             /**
              * Tags
              * @default []
@@ -8403,6 +8458,23 @@ interface components {
             /** Picture */
             picture?: string | null;
         };
+        /**
+         * RemindNoteRequest
+         * @description Set a one-off reminder for a dated note.
+         *
+         *     Give either an explicit ``remind_at`` or a ``lead_minutes`` offset before
+         *     the note's date; with neither, the reminder fires when its span starts.
+         *
+         *     A declared model rather than embedded ``Body(...)`` params: FastAPI
+         *     synthesises an inline ``Body_*`` schema for those, which is not strict, and
+         *     the client generator rejects request bodies that accept unknown fields.
+         */
+        RemindNoteRequest: {
+            /** Remind At */
+            remind_at?: string | null;
+            /** Lead Minutes */
+            lead_minutes?: number | null;
+        };
         /**
          * RemoveWorkspaceUserItem
          * @description A user or agent to remove from a workspace.
@@ -10504,7 +10576,7 @@ interface components {
          * UpdateNoteRequest
          * @description Patch a note. An edit to ``text`` soft-deletes the old row and
          *     inserts a replacement (append + soft-delete lifecycle); ``pinned``/``shared``/
-         *     ``note_date``/``tag_ext_ids`` update in place.
+         *     ``tag_ext_ids`` update in place.
          */
         UpdateNoteRequest: {
             /** Text */
@@ -10513,8 +10585,12 @@ interface components {
             pinned?: boolean | null;
             /** Shared */
             shared?: boolean | null;
-            /** Note Date */
-            note_date?: string | null;
+            /** Date */
+            date?: string | null;
+            /** Date End */
+            date_end?: string | null;
+            /** Timezone */
+            timezone?: string | null;
             /** Tag Ext Ids */
             tag_ext_ids?: string[] | null;
             citations?: components['schemas']['CitationSources'] | null;
@@ -14274,6 +14350,12 @@ interface operations {
         parameters: {
             query?: {
                 pinned_only?: boolean;
+                /** @description Range start, any precision ("2019", "2019-10") */
+                date_from?: string | null;
+                /** @description Range end, any precision */
+                date_to?: string | null;
+                /** @description Only notes that carry a date — the timeline view */
+                dated_only?: boolean;
             };
             header?: never;
             path?: never;
@@ -14400,6 +14482,41 @@ interface operations {
             };
         };
     };
+    remind_note: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                note_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                'application/json': components['schemas']['RemindNoteRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['NoteResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     get_websocket_schema: {
         parameters: {
             query?: never;

package/dist/index.d.ts

@@ -247,6 +247,9 @@ interface paths {
          *     For each email:
          *     - If user already exists: Adds them to contacts with status="registered"
          *     - If user doesn't exist: Sends invitation email and creates contact with status="invited"
+         *     - If an invitation is already pending: returns the contact unchanged without
+         *       resending, since a resend rotates the code and invalidates the link already
+         *       sent. Delete the contact to invite again before the invitation expires.
          *
          *     Protected endpoint - requires authentication.
          *     Returns list of created contact records.
@@ -1971,7 +1974,12 @@ interface paths {
         };
         /**
          * List Notes Endpoint
-         * @description List notes visible in the active workspace (newest first).
+         * @description List notes visible in the active workspace.
+         *
+         *     Newest first by default. Passing a date range (or ``dated_only``) turns this
+         *     into the timeline: only dated notes, ordered by when they happened. Each
+         *     bound is read at its own precision and widened outward, so ``date_to=2019``
+         *     runs through 31 December rather than stopping on 1 January.
          */
         get: operations['list_notes'];
         put?: never;
@@ -2026,6 +2034,36 @@ interface paths {
         patch: operations['update_note'];
         trace?: never;
     };
+    '/v1/notes/{note_ext_id}/remind': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Remind Note Endpoint
+         * @description Set a one-off reminder for a dated note, and link it to the note.
+         *
+         *     Give an explicit ``remind_at`` or a ``lead_minutes`` offset before the note's
+         *     date; with neither it fires when the note's span starts. Only dated notes can
+         *     be reminded about — there is nothing to fire relative to otherwise.
+         *
+         *     The reminder is deliberately CONTENT-FREE: it names the note by external id
+         *     and nothing else. ``tasks.name`` is plaintext while ``notes.content`` is
+         *     encrypted under the workspace key, so copying the text into the reminder
+         *     would leak the very thing the note protects. The client resolves the text
+         *     from the note when it displays the notification.
+         */
+        post: operations['remind_note'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/notifications/ws-schemas': {
         parameters: {
             query?: never;
@@ -5139,7 +5177,7 @@ interface components {
          */
         ContactResponse: {
             /** External Id */
-            external_id: string;
+            external_id?: string | null;
             /** Email */
             email: string;
             user?: components['schemas']['UserResponse'] | null;
@@ -5147,9 +5185,13 @@ interface components {
              * Status
              * @enum {string}
              */
-            status: 'invitation_pending' | 'invitation_expired' | 'registered';
+            status: 'invitation_pending' | 'invitation_expired' | 'registered' | 'failed';
             /** Created At */
             created_at: string;
+            /** Outcome */
+            outcome?: ('invited' | 'reinvited' | 'not_resent_still_pending' | 'contact_added' | 'already_contact' | 'failed') | null;
+            /** Outcome Detail */
+            outcome_detail?: string | null;
         };
         /**
          * ContextUsage
@@ -5486,8 +5528,12 @@ interface components {
              * @enum {string}
              */
             source: 'manual' | 'learning' | 'curator';
-            /** Note Date */
-            note_date?: string | null;
+            /** Date */
+            date?: string | null;
+            /** Date End */
+            date_end?: string | null;
+            /** Timezone */
+            timezone?: string | null;
             /**
              * Tag Ext Ids
              * @default []
@@ -7485,8 +7531,17 @@ interface components {
             shared: boolean;
             /** Source */
             source: string;
-            /** Note Date */
-            note_date?: string | null;
+            /** Date Start */
+            date_start?: string | null;
+            /** Date End */
+            date_end?: string | null;
+            /** Timezone */
+            timezone?: string | null;
+            /**
+             * Reminder Task Ext Ids
+             * @default []
+             */
+            reminder_task_ext_ids: string[];
             /**
              * Tags
              * @default []
@@ -8403,6 +8458,23 @@ interface components {
             /** Picture */
             picture?: string | null;
         };
+        /**
+         * RemindNoteRequest
+         * @description Set a one-off reminder for a dated note.
+         *
+         *     Give either an explicit ``remind_at`` or a ``lead_minutes`` offset before
+         *     the note's date; with neither, the reminder fires when its span starts.
+         *
+         *     A declared model rather than embedded ``Body(...)`` params: FastAPI
+         *     synthesises an inline ``Body_*`` schema for those, which is not strict, and
+         *     the client generator rejects request bodies that accept unknown fields.
+         */
+        RemindNoteRequest: {
+            /** Remind At */
+            remind_at?: string | null;
+            /** Lead Minutes */
+            lead_minutes?: number | null;
+        };
         /**
          * RemoveWorkspaceUserItem
          * @description A user or agent to remove from a workspace.
@@ -10504,7 +10576,7 @@ interface components {
          * UpdateNoteRequest
          * @description Patch a note. An edit to ``text`` soft-deletes the old row and
          *     inserts a replacement (append + soft-delete lifecycle); ``pinned``/``shared``/
-         *     ``note_date``/``tag_ext_ids`` update in place.
+         *     ``tag_ext_ids`` update in place.
          */
         UpdateNoteRequest: {
             /** Text */
@@ -10513,8 +10585,12 @@ interface components {
             pinned?: boolean | null;
             /** Shared */
             shared?: boolean | null;
-            /** Note Date */
-            note_date?: string | null;
+            /** Date */
+            date?: string | null;
+            /** Date End */
+            date_end?: string | null;
+            /** Timezone */
+            timezone?: string | null;
             /** Tag Ext Ids */
             tag_ext_ids?: string[] | null;
             citations?: components['schemas']['CitationSources'] | null;
@@ -14274,6 +14350,12 @@ interface operations {
         parameters: {
             query?: {
                 pinned_only?: boolean;
+                /** @description Range start, any precision ("2019", "2019-10") */
+                date_from?: string | null;
+                /** @description Range end, any precision */
+                date_to?: string | null;
+                /** @description Only notes that carry a date — the timeline view */
+                dated_only?: boolean;
             };
             header?: never;
             path?: never;
@@ -14400,6 +14482,41 @@ interface operations {
             };
         };
     };
+    remind_note: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                note_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                'application/json': components['schemas']['RemindNoteRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['NoteResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     get_websocket_schema: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/client",
-  "version": "0.3.140",
+  "version": "0.3.142",
   "description": "TypeScript SDK for the ARBI API — zero-knowledge auth, E2E encryption, and type-safe REST client",
   "type": "module",
   "main": "dist/index.cjs",