@objectstack/client 3.0.8 → 3.0.10

package/dist/index.mjs

@@ -1,4 +1,5 @@
 // src/index.ts
+import { isFilterAST } from "@objectstack/spec/data";
 import { createLogger } from "@objectstack/core";
 
 // src/query-builder.ts
@@ -586,12 +587,80 @@ var ObjectStackClient = class {
         const res = await this.fetch(`${this.baseUrl}${route}/files/${fileId}/url`);
         const data = await res.json();
         return data.url;
+      },
+      /**
+       * Get a presigned URL for direct-to-cloud upload
+       */
+      getPresignedUrl: async (req) => {
+        const route = this.getRoute("storage");
+        const res = await this.fetch(`${this.baseUrl}${route}/upload/presigned`, {
+          method: "POST",
+          body: JSON.stringify(req)
+        });
+        return res.json();
+      },
+      /**
+       * Initiate a chunked (multipart) upload session
+       */
+      initChunkedUpload: async (req) => {
+        const route = this.getRoute("storage");
+        const res = await this.fetch(`${this.baseUrl}${route}/upload/chunked`, {
+          method: "POST",
+          body: JSON.stringify(req)
+        });
+        return res.json();
+      },
+      /**
+       * Upload a single chunk/part of a multipart upload
+       */
+      uploadPart: async (uploadId, chunkIndex, resumeToken, data) => {
+        const route = this.getRoute("storage");
+        const res = await this.fetch(`${this.baseUrl}${route}/upload/chunked/${uploadId}/chunk/${chunkIndex}`, {
+          method: "PUT",
+          headers: { "x-resume-token": resumeToken },
+          body: data
+        });
+        return res.json();
+      },
+      /**
+       * Complete a chunked upload by assembling all parts
+       */
+      completeChunkedUpload: async (req) => {
+        const route = this.getRoute("storage");
+        const res = await this.fetch(`${this.baseUrl}${route}/upload/chunked/${req.uploadId}/complete`, {
+          method: "POST",
+          body: JSON.stringify(req)
+        });
+        return res.json();
+      },
+      /**
+       * Resume an interrupted chunked upload.
+       * Fetches current progress, then uploads remaining chunks and completes.
+       */
+      resumeUpload: async (uploadId, file, chunkSize, resumeToken) => {
+        const route = this.getRoute("storage");
+        const progressRes = await this.fetch(`${this.baseUrl}${route}/upload/chunked/${uploadId}/progress`);
+        const progress = await progressRes.json();
+        const { totalChunks, uploadedChunks } = progress.data;
+        const parts = [];
+        const fileBuffer = file instanceof ArrayBuffer ? file : await file.arrayBuffer();
+        for (let i = uploadedChunks; i < totalChunks; i++) {
+          const start = i * chunkSize;
+          const end = Math.min(start + chunkSize, fileBuffer.byteLength);
+          const chunk = new Blob([fileBuffer.slice(start, end)]);
+          const chunkRes = await this.storage.uploadPart(uploadId, i, resumeToken, chunk);
+          parts.push({ chunkIndex: i, eTag: chunkRes.data.eTag });
+        }
+        return this.storage.completeChunkedUpload({ uploadId, parts });
       }
     };
     /**
      * Automation Services
      */
     this.automation = {
+      /**
+       * Trigger a named automation flow (legacy endpoint)
+       */
       trigger: async (triggerName, payload) => {
         const route = this.getRoute("automation");
         const res = await this.fetch(`${this.baseUrl}${route}/trigger/${triggerName}`, {
@@ -599,6 +668,90 @@ var ObjectStackClient = class {
           body: JSON.stringify(payload)
         });
         return res.json();
+      },
+      /**
+       * List all registered automation flows
+       */
+      list: async () => {
+        const route = this.getRoute("automation");
+        const res = await this.fetch(`${this.baseUrl}${route}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Get a flow definition by name
+       */
+      get: async (name) => {
+        const route = this.getRoute("automation");
+        const res = await this.fetch(`${this.baseUrl}${route}/${name}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Create (register) a new flow
+       */
+      create: async (name, definition) => {
+        const route = this.getRoute("automation");
+        const res = await this.fetch(`${this.baseUrl}${route}`, {
+          method: "POST",
+          body: JSON.stringify({ name, ...definition })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Update an existing flow
+       */
+      update: async (name, definition) => {
+        const route = this.getRoute("automation");
+        const res = await this.fetch(`${this.baseUrl}${route}/${name}`, {
+          method: "PUT",
+          body: JSON.stringify({ definition })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Delete (unregister) a flow
+       */
+      delete: async (name) => {
+        const route = this.getRoute("automation");
+        const res = await this.fetch(`${this.baseUrl}${route}/${name}`, {
+          method: "DELETE"
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Enable or disable a flow
+       */
+      toggle: async (name, enabled) => {
+        const route = this.getRoute("automation");
+        const res = await this.fetch(`${this.baseUrl}${route}/${name}/toggle`, {
+          method: "POST",
+          body: JSON.stringify({ enabled })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Execution run history
+       */
+      runs: {
+        /**
+         * List execution runs for a flow
+         */
+        list: async (flowName, options) => {
+          const route = this.getRoute("automation");
+          const params = new URLSearchParams();
+          if (options?.limit) params.set("limit", String(options.limit));
+          if (options?.cursor) params.set("cursor", options.cursor);
+          const qs = params.toString();
+          const res = await this.fetch(`${this.baseUrl}${route}/${flowName}/runs${qs ? `?${qs}` : ""}`);
+          return this.unwrapResponse(res);
+        },
+        /**
+         * Get a single execution run
+         */
+        get: async (flowName, runId) => {
+          const route = this.getRoute("automation");
+          const res = await this.fetch(`${this.baseUrl}${route}/${flowName}/runs/${runId}`);
+          return this.unwrapResponse(res);
+        }
       }
     };
     /**
@@ -979,6 +1132,174 @@ var ObjectStackClient = class {
         return this.unwrapResponse(res);
       }
     };
+    /**
+     * Feed / Chatter Services
+     *
+     * Provides access to the activity timeline (comments, field changes, tasks),
+     * emoji reactions, pin/star, search, changelog, and record subscriptions.
+     * Base path: /api/data/{object}/{recordId}/feed
+     */
+    this.feed = {
+      /**
+       * List feed items for a record
+       */
+      list: async (object, recordId, options) => {
+        const route = this.getRoute("feed");
+        const params = new URLSearchParams();
+        if (options?.type) params.set("type", options.type);
+        if (options?.limit) params.set("limit", String(options.limit));
+        if (options?.cursor) params.set("cursor", options.cursor);
+        const qs = params.toString();
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed${qs ? `?${qs}` : ""}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Create a new feed item (comment, note, task, etc.)
+       */
+      create: async (object, recordId, data) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed`, {
+          method: "POST",
+          body: JSON.stringify(data)
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Update an existing feed item
+       */
+      update: async (object, recordId, feedId, data) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed/${encodeURIComponent(feedId)}`, {
+          method: "PUT",
+          body: JSON.stringify(data)
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Delete a feed item
+       */
+      delete: async (object, recordId, feedId) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed/${encodeURIComponent(feedId)}`, {
+          method: "DELETE"
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Add an emoji reaction to a feed item
+       */
+      addReaction: async (object, recordId, feedId, emoji) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed/${encodeURIComponent(feedId)}/reactions`, {
+          method: "POST",
+          body: JSON.stringify({ emoji })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Remove an emoji reaction from a feed item
+       */
+      removeReaction: async (object, recordId, feedId, emoji) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed/${encodeURIComponent(feedId)}/reactions/${encodeURIComponent(emoji)}`, {
+          method: "DELETE"
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Pin a feed item to the top of the timeline
+       */
+      pin: async (object, recordId, feedId) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed/${encodeURIComponent(feedId)}/pin`, {
+          method: "POST"
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Unpin a feed item
+       */
+      unpin: async (object, recordId, feedId) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed/${encodeURIComponent(feedId)}/pin`, {
+          method: "DELETE"
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Star (bookmark) a feed item
+       */
+      star: async (object, recordId, feedId) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed/${encodeURIComponent(feedId)}/star`, {
+          method: "POST"
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Unstar a feed item
+       */
+      unstar: async (object, recordId, feedId) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed/${encodeURIComponent(feedId)}/star`, {
+          method: "DELETE"
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Search feed items
+       */
+      search: async (object, recordId, query, options) => {
+        const route = this.getRoute("feed");
+        const params = new URLSearchParams();
+        params.set("query", query);
+        if (options?.type) params.set("type", options.type);
+        if (options?.actorId) params.set("actorId", options.actorId);
+        if (options?.dateFrom) params.set("dateFrom", options.dateFrom);
+        if (options?.dateTo) params.set("dateTo", options.dateTo);
+        if (options?.limit) params.set("limit", String(options.limit));
+        if (options?.cursor) params.set("cursor", options.cursor);
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/feed/search?${params.toString()}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Get field-level changelog for a record
+       */
+      getChangelog: async (object, recordId, options) => {
+        const route = this.getRoute("feed");
+        const params = new URLSearchParams();
+        if (options?.field) params.set("field", options.field);
+        if (options?.actorId) params.set("actorId", options.actorId);
+        if (options?.dateFrom) params.set("dateFrom", options.dateFrom);
+        if (options?.dateTo) params.set("dateTo", options.dateTo);
+        if (options?.limit) params.set("limit", String(options.limit));
+        if (options?.cursor) params.set("cursor", options.cursor);
+        const qs = params.toString();
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/changelog${qs ? `?${qs}` : ""}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Subscribe to record notifications
+       */
+      subscribe: async (object, recordId, options) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/subscribe`, {
+          method: "POST",
+          body: JSON.stringify(options || {})
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Unsubscribe from record notifications
+       */
+      unsubscribe: async (object, recordId) => {
+        const route = this.getRoute("feed");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/subscribe`, {
+          method: "DELETE"
+        });
+        return this.unwrapResponse(res);
+      }
+    };
     /**
      * Data Operations
      */
@@ -1011,11 +1332,12 @@ var ObjectStackClient = class {
         if (options.select) {
           queryParams.set("select", options.select.join(","));
         }
-        if (options.filters) {
-          if (this.isFilterAST(options.filters)) {
-            queryParams.set("filters", JSON.stringify(options.filters));
-          } else {
-            Object.entries(options.filters).forEach(([k, v]) => {
+        const filterValue = options.filter ?? options.filters;
+        if (filterValue) {
+          if (this.isFilterAST(filterValue) || Array.isArray(filterValue)) {
+            queryParams.set("filter", JSON.stringify(filterValue));
+          } else if (typeof filterValue === "object" && filterValue !== null) {
+            Object.entries(filterValue).forEach(([k, v]) => {
               if (v !== void 0 && v !== null) {
                 queryParams.append(k, String(v));
               }
@@ -1170,11 +1492,19 @@ var ObjectStackClient = class {
       throw e;
     }
   }
+  /**
+   * Well-known capability flags discovered from the server.
+   * Returns undefined if the client has not yet connected or the server
+   * did not include capabilities in its discovery response.
+   */
+  get capabilities() {
+    return this.discoveryInfo?.capabilities;
+  }
   /**
    * Private Helpers
    */
   isFilterAST(filter) {
-    return Array.isArray(filter);
+    return isFilterAST(filter);
   }
   /**
    * Unwrap the standard REST API response envelope.
@@ -1259,7 +1589,8 @@ var ObjectStackClient = class {
       views: "/api/v1/ui/views",
       notifications: "/api/v1/notifications",
       ai: "/api/v1/ai",
-      i18n: "/api/v1/i18n"
+      i18n: "/api/v1/i18n",
+      feed: "/api/v1/data"
     };
     return routeMap[type] || `/api/v1/${type}`;
   }