@arbidocs/client 0.3.36 → 0.3.37

package/dist/index.d.cts

@@ -728,9 +728,12 @@ interface paths {
          * List Documents
          * @description List documents in the current workspace.
          *
-         *     By default returns all documents (no pagination) since the frontend needs
-         *     the full set for client-side sort/search/filter. Pass ``limit``/``offset``
-         *     to opt into pagination — useful for the CLI when streaming a workspace.
+         *     By default returns all documents (no pagination, full shape) since the
+         *     frontend's client-side sort/search/filter needs the complete set.
+         *
+         *     Pagination params (``limit``/``offset``) opt into server-side paging. When
+         *     paginating, ``order`` chooses the scan (id ascending vs created_at
+         *     descending) and ``fields=lite`` trims per-row decrypt cost.
          */
         get: operations['list_documents'];
         put?: never;
@@ -8637,8 +8640,12 @@ interface operations {
             query?: {
                 /** @description Optional page size. Omit to return every document in the workspace (the default — the web UI's sort/search/filter is client-side and needs the full list). Set when paging through huge workspaces from a CLI. */
                 limit?: number | null;
-                /** @description Optional offset for pagination. Requires a stable id-ordered scan. */
+                /** @description Optional offset for pagination. Requires a stable ordered scan. */
                 offset?: number | null;
+                /** @description Ordering for paginated results. ``id_asc`` (default) walks docs by primary key and matches legacy behavior. ``created_desc`` returns newest-first and uses ix_docs_workspace_id_created_at_id_desc so the frontend's progressive loader hits a warm index. Ignored when limit/offset are omitted (unpaginated full-list has no order). */
+                order?: string;
+                /** @description Response payload shape. ``full`` (default) returns DocResponse with doctags and decrypted doc_metadata — unchanged legacy behavior. ``lite`` skips the doctags JOIN and doc_metadata decrypt for each row: doctags=[] and doc_metadata=None. Used by the frontend's progressive loader to halve per-row decrypt work; full metadata is fetched on-demand per doc via /v1/document/ when a row is opened. */
+                fields?: string;
             };
             header?: never;
             path?: never;

package/dist/index.d.ts

@@ -728,9 +728,12 @@ interface paths {
          * List Documents
          * @description List documents in the current workspace.
          *
-         *     By default returns all documents (no pagination) since the frontend needs
-         *     the full set for client-side sort/search/filter. Pass ``limit``/``offset``
-         *     to opt into pagination — useful for the CLI when streaming a workspace.
+         *     By default returns all documents (no pagination, full shape) since the
+         *     frontend's client-side sort/search/filter needs the complete set.
+         *
+         *     Pagination params (``limit``/``offset``) opt into server-side paging. When
+         *     paginating, ``order`` chooses the scan (id ascending vs created_at
+         *     descending) and ``fields=lite`` trims per-row decrypt cost.
          */
         get: operations['list_documents'];
         put?: never;
@@ -8637,8 +8640,12 @@ interface operations {
             query?: {
                 /** @description Optional page size. Omit to return every document in the workspace (the default — the web UI's sort/search/filter is client-side and needs the full list). Set when paging through huge workspaces from a CLI. */
                 limit?: number | null;
-                /** @description Optional offset for pagination. Requires a stable id-ordered scan. */
+                /** @description Optional offset for pagination. Requires a stable ordered scan. */
                 offset?: number | null;
+                /** @description Ordering for paginated results. ``id_asc`` (default) walks docs by primary key and matches legacy behavior. ``created_desc`` returns newest-first and uses ix_docs_workspace_id_created_at_id_desc so the frontend's progressive loader hits a warm index. Ignored when limit/offset are omitted (unpaginated full-list has no order). */
+                order?: string;
+                /** @description Response payload shape. ``full`` (default) returns DocResponse with doctags and decrypted doc_metadata — unchanged legacy behavior. ``lite`` skips the doctags JOIN and doc_metadata decrypt for each row: doctags=[] and doc_metadata=None. Used by the frontend's progressive loader to halve per-row decrypt work; full metadata is fetched on-demand per doc via /v1/document/ when a row is opened. */
+                fields?: string;
             };
             header?: never;
             path?: never;

package/package.json

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