@ragable/sdk 0.6.12 → 0.6.14

package/dist/index.mjs

@@ -1457,6 +1457,13 @@ var PostgrestTableApi = class {
     this.databaseInstanceId = databaseInstanceId;
     this.table = table;
   }
+  /**
+   * Start a SELECT. Pass a PostgREST `select` string; use embedded resources for joins — see
+   * {@link PostgrestSelectBuilder}.
+   *
+   * @param columns Column list and optional embeds (default `"*"`). Omitted or `"*"` means all base columns.
+   * @typeParam RowResult Row shape returned by the query; defaults to this table’s `Row`. Override when using joins.
+   */
   select(columns = "*") {
     return new PostgrestSelectBuilder(
       this.pgFetch,
@@ -2287,6 +2294,18 @@ var RagableBrowserDatabaseClient = class {
         return payload;
       });
     });
+    /**
+     * Postgres `LISTEN` / `NOTIFY` realtime via server-proxied SSE.
+     * Channels must be lowercase identifiers: `[a-z_][a-z0-9_]*` (max 63 chars).
+     */
+    __publicField(this, "realtime", {
+      subscribe: (params) => subscribeBrowserRealtime(
+        this.options,
+        this.ragableAuth,
+        this.fetchImpl,
+        params
+      )
+    });
     this.fetchImpl = bindFetch(options.fetch);
   }
   /** @internal Called by RagableBrowser to share the Transport instance. */
@@ -2300,6 +2319,89 @@ var RagableBrowserDatabaseClient = class {
     return new Headers(this.options.headers);
   }
 };
+function followAbortSignal(parent, child) {
+  if (!parent) return;
+  if (parent.aborted) {
+    child.abort();
+    return;
+  }
+  parent.addEventListener("abort", () => child.abort(), { once: true });
+}
+async function subscribeBrowserRealtime(options, ragableAuth, fetchImpl, params) {
+  const gid = requireAuthGroupId(options);
+  const token = await resolveDatabaseAuthBearer(options, ragableAuth);
+  const databaseInstanceId = params.databaseInstanceId?.trim() || options.databaseInstanceId?.trim();
+  if (!databaseInstanceId) {
+    throw new RagableError(
+      "realtime.subscribe requires databaseInstanceId in params or on createBrowserClient({ databaseInstanceId })",
+      400,
+      { code: "SDK_MISSING_DATABASE_INSTANCE_ID" }
+    );
+  }
+  if (!Array.isArray(params.channels) || params.channels.length === 0) {
+    throw new RagableError(
+      "realtime.subscribe requires a non-empty channels array",
+      400,
+      { code: "SDK_REALTIME_CHANNELS_REQUIRED" }
+    );
+  }
+  const ac = new AbortController();
+  followAbortSignal(params.signal, ac);
+  const headers = new Headers(options.headers);
+  headers.set("Authorization", `Bearer ${token}`);
+  headers.set("Content-Type", "application/json");
+  const response = await fetchImpl(
+    `${normalizeBrowserApiBase()}/auth-groups/${gid}/data/realtime/stream`,
+    {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        databaseInstanceId,
+        channels: params.channels
+      }),
+      signal: ac.signal
+    }
+  );
+  const payload = await parseMaybeJsonBody(response);
+  if (!response.ok) {
+    const message = extractErrorMessage(payload, response.statusText);
+    throw new RagableError(message, response.status, payload);
+  }
+  const streamBody = response.body;
+  if (!streamBody) {
+    throw new RagableError(
+      "Realtime stream has no body",
+      502,
+      { code: "SDK_REALTIME_NO_BODY" }
+    );
+  }
+  void (async () => {
+    try {
+      for await (const evt of readSseStream(streamBody)) {
+        if (evt.type === "realtime:ready") {
+          const ch = evt.channels;
+          params.onReady?.(
+            Array.isArray(ch) ? ch.map((c) => String(c)) : []
+          );
+        } else if (evt.type === "notify") {
+          params.onNotify?.({
+            channel: String(evt.channel ?? ""),
+            payload: evt.payload === void 0 || evt.payload === null ? null : String(evt.payload),
+            processId: Number(evt.processId ?? 0)
+          });
+        } else if (evt.type === "realtime:error") {
+          params.onError?.(String(evt.message ?? "Realtime error"));
+        }
+      }
+    } catch (e) {
+      if (e.name === "AbortError") return;
+      params.onError?.(e.message);
+    }
+  })();
+  return {
+    unsubscribe: () => ac.abort()
+  };
+}
 var RagableBrowserAgentsClient = class {
   constructor(options) {
     this.options = options;