@objectstack/client 2.0.0 → 2.0.2

package/dist/index.js

@@ -111,6 +111,41 @@ var FilterBuilder = class {
     this.conditions.push([field, "is_not_null", null]);
     return this;
   }
+  /**
+   * BETWEEN filter: field BETWEEN min AND max
+   */
+  between(field, min, max) {
+    this.conditions.push(["and", [field, ">=", min], [field, "<=", max]]);
+    return this;
+  }
+  /**
+   * CONTAINS filter: field contains value (case-insensitive LIKE %value%)
+   */
+  contains(field, value) {
+    this.conditions.push([field, "like", `%${value}%`]);
+    return this;
+  }
+  /**
+   * STARTS WITH filter: field starts with value (LIKE value%)
+   */
+  startsWith(field, value) {
+    this.conditions.push([field, "like", `${value}%`]);
+    return this;
+  }
+  /**
+   * ENDS WITH filter: field ends with value (LIKE %value)
+   */
+  endsWith(field, value) {
+    this.conditions.push([field, "like", `%${value}`]);
+    return this;
+  }
+  /**
+   * EXISTS filter: field is not null (alias for isNotNull)
+   */
+  exists(field) {
+    this.conditions.push([field, "is_not_null", null]);
+    return this;
+  }
   /**
    * Build the filter condition
    */
@@ -206,6 +241,37 @@ var QueryBuilder = class {
     this.query.groupBy = fields;
     return this;
   }
+  /**
+   * Expand (eager-load) a related object with an optional sub-query
+   */
+  expand(relation, subQuery) {
+    if (!this.query.expand) {
+      this.query.expand = {};
+    }
+    this.query.expand[relation] = subQuery || {};
+    return this;
+  }
+  /**
+   * Add full-text search
+   */
+  search(query, options) {
+    this.query.search = { query, ...options };
+    return this;
+  }
+  /**
+   * Set cursor for keyset pagination
+   */
+  cursor(cursor) {
+    this.query.cursor = cursor;
+    return this;
+  }
+  /**
+   * Enable SELECT DISTINCT
+   */
+  distinct() {
+    this.query.distinct = true;
+    return this;
+  }
   /**
    * Build the final query AST
    */
@@ -363,36 +429,6 @@ var ObjectStackClient = class {
         return res.json();
       }
     };
-    /**
-     * Hub Management Services
-     */
-    this.hub = {
-      spaces: {
-        list: async () => {
-          const route = this.getRoute("hub");
-          const res = await this.fetch(`${this.baseUrl}${route}/spaces`);
-          return res.json();
-        },
-        create: async (payload) => {
-          const route = this.getRoute("hub");
-          const res = await this.fetch(`${this.baseUrl}${route}/spaces`, {
-            method: "POST",
-            body: JSON.stringify(payload)
-          });
-          return res.json();
-        }
-      },
-      plugins: {
-        install: async (pkg, version) => {
-          const route = this.getRoute("hub");
-          const res = await this.fetch(`${this.baseUrl}${route}/plugins/install`, {
-            method: "POST",
-            body: JSON.stringify({ pkg, version })
-          });
-          return res.json();
-        }
-      }
-    };
     /**
      * Package Management Services
      * 
@@ -503,6 +539,36 @@ var ObjectStackClient = class {
         const route = this.getRoute("auth");
         const res = await this.fetch(`${this.baseUrl}${route}/me`);
         return res.json();
+      },
+      /**
+       * Register a new user account
+       */
+      register: async (request) => {
+        const route = this.getRoute("auth");
+        const res = await this.fetch(`${this.baseUrl}${route}/register`, {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        const data = await res.json();
+        if (data.data?.token) {
+          this.token = data.data.token;
+        }
+        return data;
+      },
+      /**
+       * Refresh an authentication token
+       */
+      refreshToken: async (refreshToken) => {
+        const route = this.getRoute("auth");
+        const res = await this.fetch(`${this.baseUrl}${route}/refresh`, {
+          method: "POST",
+          body: JSON.stringify({ refreshToken })
+        });
+        const data = await res.json();
+        if (data.data?.token) {
+          this.token = data.data.token;
+        }
+        return data;
       }
     };
     /**
@@ -559,6 +625,384 @@ var ObjectStackClient = class {
         return res.json();
       }
     };
+    /**
+     * Permissions Services
+     */
+    this.permissions = {
+      /**
+       * Check if current user has permission for an action on an object
+       */
+      check: async (request) => {
+        const route = this.getRoute("permissions");
+        const res = await this.fetch(`${this.baseUrl}${route}/check`, {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Get all permissions for a specific object
+       */
+      getObjectPermissions: async (object) => {
+        const route = this.getRoute("permissions");
+        const res = await this.fetch(`${this.baseUrl}${route}/permissions/${encodeURIComponent(object)}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Get effective permissions for the current user
+       */
+      getEffectivePermissions: async () => {
+        const route = this.getRoute("permissions");
+        const res = await this.fetch(`${this.baseUrl}${route}/permissions/effective`);
+        return this.unwrapResponse(res);
+      }
+    };
+    /**
+     * Realtime Services
+     */
+    this.realtime = {
+      /**
+       * Establish a realtime connection
+       */
+      connect: async (request) => {
+        const route = this.getRoute("realtime");
+        const res = await this.fetch(`${this.baseUrl}${route}/connect`, {
+          method: "POST",
+          body: JSON.stringify(request || {})
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Disconnect from realtime services
+       */
+      disconnect: async () => {
+        const route = this.getRoute("realtime");
+        await this.fetch(`${this.baseUrl}${route}/disconnect`, {
+          method: "POST"
+        });
+      },
+      /**
+       * Subscribe to a channel
+       */
+      subscribe: async (request) => {
+        const route = this.getRoute("realtime");
+        const res = await this.fetch(`${this.baseUrl}${route}/subscribe`, {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Unsubscribe from a channel
+       */
+      unsubscribe: async (subscriptionId) => {
+        const route = this.getRoute("realtime");
+        await this.fetch(`${this.baseUrl}${route}/unsubscribe`, {
+          method: "POST",
+          body: JSON.stringify({ subscriptionId })
+        });
+      },
+      /**
+       * Set presence state on a channel
+       */
+      setPresence: async (channel, state) => {
+        const route = this.getRoute("realtime");
+        await this.fetch(`${this.baseUrl}${route}/presence`, {
+          method: "PUT",
+          body: JSON.stringify({ channel, state })
+        });
+      },
+      /**
+       * Get presence information for a channel
+       */
+      getPresence: async (channel) => {
+        const route = this.getRoute("realtime");
+        const res = await this.fetch(`${this.baseUrl}${route}/presence/${encodeURIComponent(channel)}`);
+        return this.unwrapResponse(res);
+      }
+    };
+    /**
+     * Workflow Services
+     */
+    this.workflow = {
+      /**
+       * Get workflow configuration for an object
+       */
+      getConfig: async (object) => {
+        const route = this.getRoute("workflow");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/config`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Get current workflow state for a record
+       */
+      getState: async (object, recordId) => {
+        const route = this.getRoute("workflow");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(recordId)}/state`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Execute a workflow state transition
+       */
+      transition: async (request) => {
+        const route = this.getRoute("workflow");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(request.object)}/${encodeURIComponent(request.recordId)}/transition`, {
+          method: "POST",
+          body: JSON.stringify({
+            transition: request.transition,
+            comment: request.comment,
+            data: request.data
+          })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Approve a workflow step
+       */
+      approve: async (request) => {
+        const route = this.getRoute("workflow");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(request.object)}/${encodeURIComponent(request.recordId)}/approve`, {
+          method: "POST",
+          body: JSON.stringify({
+            comment: request.comment,
+            data: request.data
+          })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Reject a workflow step
+       */
+      reject: async (request) => {
+        const route = this.getRoute("workflow");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(request.object)}/${encodeURIComponent(request.recordId)}/reject`, {
+          method: "POST",
+          body: JSON.stringify({
+            reason: request.reason,
+            comment: request.comment
+          })
+        });
+        return this.unwrapResponse(res);
+      }
+    };
+    /**
+     * Views CRUD Services
+     */
+    this.views = {
+      /**
+       * List views for an object
+       */
+      list: async (object, type) => {
+        const route = this.getRoute("views");
+        const params = new URLSearchParams();
+        if (type) params.set("type", type);
+        const qs = params.toString();
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}${qs ? `?${qs}` : ""}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Get a specific view
+       */
+      get: async (object, viewId) => {
+        const route = this.getRoute("views");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(viewId)}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Create a new view
+       */
+      create: async (object, data) => {
+        const route = this.getRoute("views");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}`, {
+          method: "POST",
+          body: JSON.stringify({ object, data })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Update an existing view
+       */
+      update: async (object, viewId, data) => {
+        const route = this.getRoute("views");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(viewId)}`, {
+          method: "PUT",
+          body: JSON.stringify({ object, viewId, data })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Delete a view
+       */
+      delete: async (object, viewId) => {
+        const route = this.getRoute("views");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(object)}/${encodeURIComponent(viewId)}`, {
+          method: "DELETE"
+        });
+        return this.unwrapResponse(res);
+      }
+    };
+    /**
+     * Notification Services
+     */
+    this.notifications = {
+      /**
+       * Register a device for push notifications
+       */
+      registerDevice: async (request) => {
+        const route = this.getRoute("notifications");
+        const res = await this.fetch(`${this.baseUrl}${route}/devices`, {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Unregister a device from push notifications
+       */
+      unregisterDevice: async (deviceId) => {
+        const route = this.getRoute("notifications");
+        const res = await this.fetch(`${this.baseUrl}${route}/devices/${encodeURIComponent(deviceId)}`, {
+          method: "DELETE"
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Get notification preferences for the current user
+       */
+      getPreferences: async () => {
+        const route = this.getRoute("notifications");
+        const res = await this.fetch(`${this.baseUrl}${route}/preferences`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Update notification preferences
+       */
+      updatePreferences: async (preferences) => {
+        const route = this.getRoute("notifications");
+        const res = await this.fetch(`${this.baseUrl}${route}/preferences`, {
+          method: "PUT",
+          body: JSON.stringify({ preferences })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * List notifications for the current user
+       */
+      list: async (options) => {
+        const route = this.getRoute("notifications");
+        const params = new URLSearchParams();
+        if (options?.read !== void 0) params.set("read", String(options.read));
+        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}${qs ? `?${qs}` : ""}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Mark specific notifications as read
+       */
+      markRead: async (ids) => {
+        const route = this.getRoute("notifications");
+        const res = await this.fetch(`${this.baseUrl}${route}/read`, {
+          method: "POST",
+          body: JSON.stringify({ ids })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Mark all notifications as read
+       */
+      markAllRead: async () => {
+        const route = this.getRoute("notifications");
+        const res = await this.fetch(`${this.baseUrl}${route}/read/all`, {
+          method: "POST"
+        });
+        return this.unwrapResponse(res);
+      }
+    };
+    /**
+     * AI Services
+     */
+    this.ai = {
+      /**
+       * Natural language query — converts natural language to structured query
+       */
+      nlq: async (request) => {
+        const route = this.getRoute("ai");
+        const res = await this.fetch(`${this.baseUrl}${route}/nlq`, {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Multi-turn AI chat
+       */
+      chat: async (request) => {
+        const route = this.getRoute("ai");
+        const res = await this.fetch(`${this.baseUrl}${route}/chat`, {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * AI-powered field value suggestions
+       */
+      suggest: async (request) => {
+        const route = this.getRoute("ai");
+        const res = await this.fetch(`${this.baseUrl}${route}/suggest`, {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * AI-powered data insights
+       */
+      insights: async (request) => {
+        const route = this.getRoute("ai");
+        const res = await this.fetch(`${this.baseUrl}${route}/insights`, {
+          method: "POST",
+          body: JSON.stringify(request)
+        });
+        return this.unwrapResponse(res);
+      }
+    };
+    /**
+     * Internationalization Services
+     */
+    this.i18n = {
+      /**
+       * Get available locales
+       */
+      getLocales: async () => {
+        const route = this.getRoute("i18n");
+        const res = await this.fetch(`${this.baseUrl}${route}/locales`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Get translations for a locale
+       */
+      getTranslations: async (locale, options) => {
+        const route = this.getRoute("i18n");
+        const params = new URLSearchParams();
+        params.set("locale", locale);
+        if (options?.namespace) params.set("namespace", options.namespace);
+        if (options?.keys) params.set("keys", options.keys.join(","));
+        const res = await this.fetch(`${this.baseUrl}${route}/translations?${params.toString()}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Get translated field labels for an object
+       */
+      getFieldLabels: async (object, locale) => {
+        const route = this.getRoute("i18n");
+        const res = await this.fetch(`${this.baseUrl}${route}/labels/${encodeURIComponent(object)}?locale=${encodeURIComponent(locale)}`);
+        return this.unwrapResponse(res);
+      }
+    };
     /**
      * Data Operations
      */
@@ -829,10 +1273,17 @@ var ObjectStackClient = class {
       ui: "/api/v1/ui",
       auth: "/api/v1/auth",
       analytics: "/api/v1/analytics",
-      hub: "/api/v1/hub",
       storage: "/api/v1/storage",
       automation: "/api/v1/automation",
-      packages: "/api/v1/packages"
+      packages: "/api/v1/packages",
+      permissions: "/api/v1/auth",
+      // Permission endpoints are under /api/v1/auth per spec
+      realtime: "/api/v1/realtime",
+      workflow: "/api/v1/workflow",
+      views: "/api/v1/ui/views",
+      notifications: "/api/v1/notifications",
+      ai: "/api/v1/ai",
+      i18n: "/api/v1/i18n"
     };
     return routeMap[type] || `/api/v1/${type}`;
   }