@objectstack/client 4.0.1 → 4.0.3

package/dist/index.mjs

@@ -2,6 +2,135 @@
 import { isFilterAST } from "@objectstack/spec/data";
 import { createLogger } from "@objectstack/core";
 
+// src/realtime-api.ts
+var RealtimeAPI = class {
+  constructor(baseUrl, token) {
+    this.subscriptions = /* @__PURE__ */ new Map();
+    this.eventBuffer = [];
+    this._baseUrl = baseUrl;
+    this._token = token;
+  }
+  /**
+   * Subscribe to metadata events
+   * Returns an unsubscribe function
+   */
+  subscribeMetadata(type, callback, options) {
+    const subscriptionId = `metadata-${type}-${Date.now()}`;
+    this.subscriptions.set(subscriptionId, {
+      filter: {
+        type,
+        packageId: options?.packageId,
+        eventTypes: [
+          `metadata.${type}.created`,
+          `metadata.${type}.updated`,
+          `metadata.${type}.deleted`
+        ]
+      },
+      handler: (event) => {
+        if (event.type.startsWith("metadata.")) {
+          callback(event);
+        }
+      }
+    });
+    this.startPolling();
+    return () => {
+      this.subscriptions.delete(subscriptionId);
+      if (this.subscriptions.size === 0) {
+        this.stopPolling();
+      }
+    };
+  }
+  /**
+   * Subscribe to data record events
+   * Returns an unsubscribe function
+   */
+  subscribeData(object, callback, options) {
+    const subscriptionId = `data-${object}-${Date.now()}`;
+    this.subscriptions.set(subscriptionId, {
+      filter: {
+        type: object,
+        recordId: options?.recordId,
+        eventTypes: [
+          "data.record.created",
+          "data.record.updated",
+          "data.record.deleted"
+        ]
+      },
+      handler: (event) => {
+        if (event.type.startsWith("data.") && event.object === object) {
+          if (!options?.recordId || event.payload?.recordId === options.recordId) {
+            callback(event);
+          }
+        }
+      }
+    });
+    this.startPolling();
+    return () => {
+      this.subscriptions.delete(subscriptionId);
+      if (this.subscriptions.size === 0) {
+        this.stopPolling();
+      }
+    };
+  }
+  /**
+   * Emit an event to all matching subscriptions (client-side only)
+   * This is used for in-process event delivery
+   */
+  emitEvent(event) {
+    for (const sub of this.subscriptions.values()) {
+      const matchesType = !sub.filter.type || event.type.includes(sub.filter.type) || event.object === sub.filter.type;
+      const matchesEventType = !sub.filter.eventTypes?.length || sub.filter.eventTypes.includes(event.type);
+      const matchesPackage = !sub.filter.packageId || event.payload?.packageId === sub.filter.packageId;
+      if (matchesType && matchesEventType && matchesPackage) {
+        try {
+          sub.handler(event);
+        } catch (error) {
+          console.error("Error in realtime event handler:", error);
+        }
+      }
+    }
+  }
+  /**
+   * Start polling for events (fallback mechanism)
+   * In production, this would be replaced with WebSocket/SSE
+   */
+  startPolling() {
+    if (this.pollInterval) return;
+    this.pollInterval = setInterval(() => {
+      while (this.eventBuffer.length > 0) {
+        const event = this.eventBuffer.shift();
+        if (event) {
+          this.emitEvent(event);
+        }
+      }
+    }, 2e3);
+  }
+  /**
+   * Stop polling for events
+   */
+  stopPolling() {
+    if (this.pollInterval) {
+      clearInterval(this.pollInterval);
+      this.pollInterval = void 0;
+    }
+  }
+  /**
+   * Internal method to buffer events from server
+   * This would be called by WebSocket/SSE handlers in production
+   */
+  _bufferEvent(event) {
+    this.eventBuffer.push(event);
+  }
+  /**
+   * Disconnect and clean up all subscriptions
+   */
+  disconnect() {
+    this.stopPolling();
+    this.subscriptions.clear();
+    this.eventBuffer = [];
+  }
+};
+
 // src/query-builder.ts
 var FilterBuilder = class {
   constructor() {
@@ -310,10 +439,15 @@ var ObjectStackClient = class {
        * Get a specific metadata item by type and name
        * @param type - Metadata type (e.g., 'object', 'plugin')
        * @param name - Item name (snake_case identifier)
+       * @param options - Optional filters (e.g., packageId to scope by package)
        */
-      getItem: async (type, name) => {
+      getItem: async (type, name, options) => {
         const route = this.getRoute("metadata");
-        const res = await this.fetch(`${this.baseUrl}${route}/${type}/${name}`);
+        const params = new URLSearchParams();
+        if (options?.packageId) params.set("package", options.packageId);
+        const qs = params.toString();
+        const url = `${this.baseUrl}${route}/${type}/${name}${qs ? `?${qs}` : ""}`;
+        const res = await this.fetch(url);
         return this.unwrapResponse(res);
       },
       /**
@@ -330,6 +464,18 @@ var ObjectStackClient = class {
         });
         return this.unwrapResponse(res);
       },
+      /**
+       * Delete a metadata item
+       * @param type - Metadata type (e.g., 'object', 'plugin')
+       * @param name - Item name (snake_case identifier)
+       */
+      deleteItem: async (type, name) => {
+        const route = this.getRoute("metadata");
+        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(type)}/${encodeURIComponent(name)}`, {
+          method: "DELETE"
+        });
+        return this.unwrapResponse(res);
+      },
       /**
        * Get object metadata with cache support
        * Supports ETag-based conditional requests for efficient caching
@@ -1073,17 +1219,7 @@ var ObjectStackClient = class {
         });
         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 chat method removed — use Vercel AI SDK `useChat()` / `@ai-sdk/react` directly.
       /**
        * AI-powered field value suggestions
        */
@@ -1465,6 +1601,7 @@ var ObjectStackClient = class {
       level: config.debug ? "debug" : "info",
       format: "pretty"
     });
+    this.realtimeAPI = new RealtimeAPI(this.baseUrl, this.token);
     this.logger.debug("ObjectStack client created", { baseUrl: this.baseUrl });
   }
   /**
@@ -1535,6 +1672,13 @@ var ObjectStackClient = class {
     }
     return result;
   }
+  /**
+   * Event Subscription API
+   * Provides real-time event subscriptions for metadata and data changes
+   */
+  get events() {
+    return this.realtimeAPI;
+  }
   /**
    * Private Helpers
    */
@@ -1638,6 +1782,7 @@ export {
   FilterBuilder,
   ObjectStackClient,
   QueryBuilder,
+  RealtimeAPI,
   createFilter,
   createQuery
 };