@ragable/sdk 0.6.24 → 0.7.6

package/dist/index.js

@@ -54,6 +54,7 @@ __export(index_exports, {
   RagableTimeoutError: () => RagableTimeoutError,
   SessionStorageAdapter: () => SessionStorageAdapter,
   ShiftClient: () => ShiftClient,
+  StorageClient: () => StorageClient,
   Transport: () => Transport,
   asPostgrestResponse: () => asPostgrestResponse,
   assertPostgrestSuccess: () => assertPostgrestSuccess,
@@ -82,7 +83,6 @@ __export(index_exports, {
   parseSseDataLine: () => parseSseDataLine,
   parseTransportResponse: () => parseTransportResponse,
   readSseStream: () => readSseStream,
-  resolveRagableApiBase: () => resolveRagableApiBase,
   runAgentChatStream: () => runAgentChatStream,
   runAgentChatStreamForUi: () => runAgentChatStreamForUi,
   runAgentChatStreamLenient: () => runAgentChatStreamLenient,
@@ -99,10 +99,6 @@ function bindFetch(custom) {
   };
 }
 var DEFAULT_RAGABLE_API_BASE = "https://ragable-341305259977.asia-southeast1.run.app/api";
-function resolveRagableApiBase(explicitBaseUrl) {
-  const raw = typeof explicitBaseUrl === "string" && explicitBaseUrl.trim().length > 0 ? explicitBaseUrl.trim() : DEFAULT_RAGABLE_API_BASE.trim();
-  return raw.replace(/\/+$/, "");
-}
 var RagableSdkError = class extends Error {
   constructor(message) {
     super(message);
@@ -231,7 +227,7 @@ var RagableRequestClient = class {
     __publicField(this, "fetchImpl");
     __publicField(this, "defaultHeaders");
     this.apiKey = options.apiKey;
-    this.baseUrl = resolveRagableApiBase(options.baseUrl);
+    this.baseUrl = DEFAULT_RAGABLE_API_BASE.replace(/\/+$/, "");
     this.fetchImpl = bindFetch(options.fetch);
     this.defaultHeaders = options.headers;
   }
@@ -2255,7 +2251,7 @@ var RagableAuth = class {
     __publicField(this, "broadcast", null);
     __publicField(this, "visibilityHandler", null);
     __publicField(this, "initialized", false);
-    this.baseUrl = resolveRagableApiBase(config.baseUrl);
+    this.baseUrl = DEFAULT_RAGABLE_API_BASE.replace(/\/+$/, "");
     this.authGroupId = config.authGroupId;
     this.fetchImpl = bindFetch(config.fetch);
     this.defaultHeaders = config.headers;
@@ -2624,8 +2620,8 @@ function decodeJwtExpiry(jwt) {
 }
 
 // src/browser.ts
-function normalizeBrowserApiBase(explicitBaseUrl) {
-  return resolveRagableApiBase(explicitBaseUrl);
+function normalizeBrowserApiBase() {
+  return DEFAULT_RAGABLE_API_BASE.replace(/\/+$/, "");
 }
 function effectiveDataAuth(options) {
   if (options.dataAuth) return options.dataAuth;
@@ -2916,7 +2912,6 @@ var RagableBrowserDatabaseClient = class {
     this.options = options;
     this.ragableAuth = ragableAuth;
     __publicField(this, "fetchImpl");
-    __publicField(this, "apiBase");
     __publicField(this, "_transport", null);
     __publicField(this, "collections");
     __publicField(this, "collection");
@@ -2940,7 +2935,7 @@ var RagableBrowserDatabaseClient = class {
         }
         const gid = requireAuthGroupId(opts);
         const token = await resolveDatabaseAuthBearer(opts, ragableAuth);
-        const apiBase = this.apiBase;
+        const apiBase = normalizeBrowserApiBase();
         const qs = params.searchParams.toString();
         const url = `${apiBase}/auth-groups/${gid}/data/rest/${params.table}${qs ? `?${qs}` : ""}`;
         const headers = new Headers(opts.headers);
@@ -3055,7 +3050,6 @@ var RagableBrowserDatabaseClient = class {
       )
     });
     this.fetchImpl = bindFetch(options.fetch);
-    this.apiBase = resolveRagableApiBase(options.baseUrl);
     this.collections = new Proxy(
       {},
       {
@@ -3077,7 +3071,7 @@ var RagableBrowserDatabaseClient = class {
     this._transport = transport;
   }
   toUrl(path) {
-    return `${this.apiBase}${path.startsWith("/") ? path : `/${path}`}`;
+    return `${normalizeBrowserApiBase()}${path.startsWith("/") ? path : `/${path}`}`;
   }
   async _requestCollection(method, path, body, databaseInstanceId) {
     const gid = requireAuthGroupId(this.options);
@@ -3168,7 +3162,7 @@ async function subscribeBrowserRealtime(options, ragableAuth, fetchImpl, params)
     headers.set("Authorization", `Bearer ${token}`);
     headers.set("Content-Type", "application/json");
     const response = await fetchImpl(
-      `${resolveRagableApiBase(options.baseUrl)}/auth-groups/${gid}/data/realtime/stream`,
+      `${normalizeBrowserApiBase()}/auth-groups/${gid}/data/realtime/stream`,
       {
         method: "POST",
         headers,
@@ -3297,16 +3291,121 @@ async function subscribeBrowserRealtime(options, ragableAuth, fetchImpl, params)
   })();
   return subscription;
 }
+var BrowserStorageBucketClient = class {
+  constructor(options, fetchImpl, bucketId) {
+    this.options = options;
+    this.fetchImpl = fetchImpl;
+    this.bucketId = bucketId;
+  }
+  get authGroupId() {
+    const id = this.options.authGroupId?.trim();
+    if (!id) throw new RagableError("authGroupId is required for storage", 400, { code: "SDK_MISSING_AUTH_GROUP_ID" });
+    return id;
+  }
+  base() {
+    return `${normalizeBrowserApiBase()}/auth-groups/${this.authGroupId}/storage/buckets/${encodeURIComponent(this.bucketId)}`;
+  }
+  async bearerToken() {
+    const staticKey = this.options.dataStaticKey?.trim() || (this.options.getDataStaticKey ? await this.options.getDataStaticKey() : null)?.trim() || null;
+    if (staticKey) return staticKey;
+    if (this.options.getAccessToken) {
+      const tok = await this.options.getAccessToken();
+      if (tok?.trim()) return tok.trim();
+    }
+    throw new RagableError("No auth token for storage. Provide dataStaticKey or getAccessToken.", 401, { code: "SDK_NO_ACCESS_TOKEN" });
+  }
+  async req(method, path, body) {
+    const token = await this.bearerToken();
+    const headers = new Headers(this.options.headers);
+    headers.set("Authorization", `Bearer ${token}`);
+    if (body !== void 0 && !(body instanceof FormData)) headers.set("Content-Type", "application/json");
+    const res = await this.fetchImpl(`${this.base()}${path}`, {
+      method,
+      headers,
+      body: body instanceof FormData ? body : body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    const payload = await res.json().catch(() => ({}));
+    if (!res.ok) throw new RagableError(payload?.error ?? res.statusText, res.status, payload);
+    return payload;
+  }
+  list(params = {}) {
+    const qs = new URLSearchParams();
+    if (params.prefix) qs.set("prefix", params.prefix);
+    if (params.delimiter) qs.set("delimiter", params.delimiter);
+    if (params.maxResults != null) qs.set("maxResults", String(params.maxResults));
+    if (params.pageToken) qs.set("pageToken", params.pageToken);
+    const q = qs.toString();
+    return this.req("GET", `/contents${q ? `?${q}` : ""}`);
+  }
+  async upload(params) {
+    const token = await this.bearerToken();
+    const headers = new Headers(this.options.headers);
+    headers.set("Authorization", `Bearer ${token}`);
+    const form = new FormData();
+    const raw = params.file instanceof Blob ? params.file : new Blob([new Uint8Array(params.file instanceof ArrayBuffer ? params.file : params.file.buffer)], params.contentType ? { type: params.contentType } : {});
+    const blob = raw;
+    form.set("file", blob, params.fileName ?? "upload");
+    form.set("objectPath", params.objectPath);
+    if (params.cacheControl) form.set("cacheControl", params.cacheControl);
+    const res = await this.fetchImpl(`${this.base()}/upload`, { method: "POST", headers, body: form });
+    const payload = await res.json().catch(() => ({}));
+    if (!res.ok) throw new RagableError(payload?.error ?? res.statusText, res.status, payload);
+    return payload;
+  }
+  download(params) {
+    const qs = new URLSearchParams({ objectPath: params.objectPath });
+    if (params.asText != null) qs.set("asText", String(params.asText));
+    if (params.maxTextBytes != null) qs.set("maxTextBytes", String(params.maxTextBytes));
+    return this.req("GET", `/objects/download?${qs}`);
+  }
+  delete(objectPath) {
+    return this.req("DELETE", "/objects", { objectPath });
+  }
+  bulkDelete(objectPaths) {
+    return this.req("POST", "/objects/delete-bulk", { objectPaths });
+  }
+  getSignedUploadUrl(params) {
+    return this.req("POST", "/signed-upload-url", params);
+  }
+  getSignedDownloadUrl(params) {
+    const qs = new URLSearchParams({ objectPath: params.objectPath });
+    if (params.expiresInSeconds != null) qs.set("expiresInSeconds", String(params.expiresInSeconds));
+    return this.req("GET", `/signed-download-url?${qs}`);
+  }
+  copy(params) {
+    return this.req("POST", "/objects/copy", params);
+  }
+  move(params) {
+    return this.req("POST", "/objects/move", params);
+  }
+  createFolder(folderPath) {
+    return this.req("POST", "/folders", { folderPath });
+  }
+  deleteFolder(folderPath) {
+    return this.req("DELETE", "/folders", { folderPath });
+  }
+  getMetadata(objectPath) {
+    const qs = new URLSearchParams({ objectPath });
+    return this.req("GET", `/objects/metadata?${qs}`);
+  }
+};
+var RagableBrowserStorageClient = class {
+  constructor(options, fetchImpl) {
+    this.options = options;
+    this.fetchImpl = fetchImpl;
+  }
+  from(bucketId) {
+    return new BrowserStorageBucketClient(this.options, this.fetchImpl, bucketId);
+  }
+};
 var RagableBrowserAgentsClient = class {
   constructor(options) {
     this.options = options;
     __publicField(this, "fetchImpl");
-    __publicField(this, "apiBase");
     this.fetchImpl = bindFetch(options.fetch);
-    this.apiBase = resolveRagableApiBase(options.baseUrl);
   }
   toUrl(path) {
-    return `${this.apiBase}${path.startsWith("/") ? path : `/${path}`}`;
+    return `${normalizeBrowserApiBase()}${path.startsWith("/") ? path : `/${path}`}`;
   }
   requireWebsiteId() {
     const websiteId = this.options.websiteId?.trim();
@@ -3492,6 +3591,7 @@ var RagableBrowser = class {
     __publicField(this, "auth");
     __publicField(this, "database");
     __publicField(this, "db");
+    __publicField(this, "storage");
     __publicField(this, "transport");
     __publicField(this, "_ragableAuth");
     /** Delegates to `database.from()`. Kept for back-compat — prefer `database.from()`. */
@@ -3506,7 +3606,6 @@ var RagableBrowser = class {
     if (options.authGroupId) {
       this._ragableAuth = new RagableAuth({
         authGroupId: options.authGroupId,
-        baseUrl: options.baseUrl,
         fetch: options.fetch,
         headers: options.headers,
         auth: options.auth
@@ -3530,6 +3629,7 @@ var RagableBrowser = class {
     );
     this.database._setTransport(this.transport);
     this.db = this.database;
+    this.storage = new RagableBrowserStorageClient(options, bindFetch(options.fetch));
   }
   destroy() {
     this._ragableAuth?.destroy();
@@ -3582,15 +3682,171 @@ function createRagPipeline(client, options) {
   };
 }
 
+// src/storage.ts
+function normalizeUploadFile2(file, contentType) {
+  if (file instanceof Blob) return file;
+  const u8 = file instanceof ArrayBuffer ? new Uint8Array(file) : new Uint8Array(file);
+  return new Blob([u8.buffer], contentType ? { type: contentType } : {});
+}
+var StorageClient = class {
+  constructor(client) {
+    this.client = client;
+    /**
+     * Bucket-level CRUD — list, create and delete buckets for this organisation.
+     */
+    __publicField(this, "buckets");
+    this.buckets = {
+      list: async (params) => {
+        const qs = new URLSearchParams();
+        if (params?.q) qs.set("q", params.q);
+        if (params?.status) qs.set("status", params.status);
+        if (params?.sort) qs.set("sort", params.sort);
+        const query = qs.toString();
+        return this.client.request(
+          `/v1/storage/buckets${query ? `?${query}` : ""}`
+        );
+      },
+      create: async (name) => {
+        return this.client.request("/v1/storage/buckets", {
+          method: "POST",
+          body: { name }
+        });
+      },
+      delete: async (bucketId) => {
+        return this.client.request(
+          `/v1/storage/buckets/${encodeURIComponent(bucketId)}`,
+          { method: "DELETE" }
+        );
+      }
+    };
+  }
+  /**
+   * Returns a {@link StorageBucketClient} scoped to the given bucket ID.
+   *
+   * All object operations (upload, download, list, copy, move, signed URLs, …)
+   * are performed through the returned client.
+   *
+   * @param bucketId The Ragable bucket ID obtained from `buckets.list()` or `buckets.create()`.
+   */
+  from(bucketId) {
+    const { client } = this;
+    const base = `/v1/storage/buckets/${encodeURIComponent(bucketId)}`;
+    return {
+      list: async (params) => {
+        const qs = new URLSearchParams();
+        if (params?.prefix) qs.set("prefix", params.prefix);
+        if (params?.delimiter) qs.set("delimiter", params.delimiter);
+        if (params?.maxResults != null)
+          qs.set("maxResults", String(params.maxResults));
+        if (params?.pageToken) qs.set("pageToken", params.pageToken);
+        const query = qs.toString();
+        return client.request(
+          `${base}/contents${query ? `?${query}` : ""}`
+        );
+      },
+      createFolder: async (folderPath) => {
+        return client.request(
+          `${base}/folders`,
+          { method: "POST", body: { folderPath } }
+        );
+      },
+      deleteFolder: async (folderPath) => {
+        return client.request(
+          `${base}/folders`,
+          { method: "DELETE", body: { folderPath } }
+        );
+      },
+      upload: async (params) => {
+        const formData = new FormData();
+        const blob = normalizeUploadFile2(params.file, params.contentType);
+        const fileName = params.fileName ?? "upload";
+        formData.set("file", blob, fileName);
+        formData.set("objectPath", params.objectPath);
+        if (params.cacheControl) {
+          formData.set("cacheControl", params.cacheControl);
+        }
+        return client.request(`${base}/upload`, {
+          method: "POST",
+          body: formData
+        });
+      },
+      delete: async (objectPath) => {
+        return client.request(
+          `${base}/objects`,
+          { method: "DELETE", body: { objectPath } }
+        );
+      },
+      bulkDelete: async (objectPaths) => {
+        return client.request(
+          `${base}/objects/delete-bulk`,
+          { method: "POST", body: { objectPaths } }
+        );
+      },
+      getMetadata: async (objectPath) => {
+        const qs = new URLSearchParams({ objectPath });
+        return client.request(
+          `${base}/objects/metadata?${qs}`
+        );
+      },
+      updateMetadata: async (params) => {
+        return client.request(
+          `${base}/objects/metadata`,
+          { method: "PATCH", body: params }
+        );
+      },
+      download: async (params) => {
+        const qs = new URLSearchParams({ objectPath: params.objectPath });
+        if (params.asText != null) qs.set("asText", String(params.asText));
+        if (params.maxTextBytes != null)
+          qs.set("maxTextBytes", String(params.maxTextBytes));
+        return client.request(
+          `${base}/objects/download?${qs}`
+        );
+      },
+      copy: async (params) => {
+        return client.request(`${base}/objects/copy`, { method: "POST", body: params });
+      },
+      move: async (params) => {
+        return client.request(`${base}/objects/move`, { method: "POST", body: params });
+      },
+      getSignedUploadUrl: async (params) => {
+        return client.request(
+          `${base}/signed-upload-url`,
+          { method: "POST", body: params }
+        );
+      },
+      getSignedDownloadUrl: async (params) => {
+        const qs = new URLSearchParams({ objectPath: params.objectPath });
+        if (params.expiresInSeconds != null)
+          qs.set("expiresInSeconds", String(params.expiresInSeconds));
+        return client.request(
+          `${base}/signed-download-url?${qs}`
+        );
+      },
+      getSettings: async () => {
+        return client.request(`${base}/settings`);
+      },
+      updateSettings: async (params) => {
+        return client.request(`${base}/settings`, {
+          method: "PATCH",
+          body: params
+        });
+      }
+    };
+  }
+};
+
 // src/index.ts
 var Ragable = class {
   constructor(options) {
     __publicField(this, "shift");
     __publicField(this, "agents");
+    __publicField(this, "storage");
     __publicField(this, "infrastructure");
     const client = new RagableRequestClient(options);
     this.shift = new ShiftClient(client);
     this.agents = new AgentsClient(client);
+    this.storage = new StorageClient(client);
     this.infrastructure = {
       shift: this.shift
     };
@@ -3654,6 +3910,7 @@ function createRagableServerClient(options) {
   RagableTimeoutError,
   SessionStorageAdapter,
   ShiftClient,
+  StorageClient,
   Transport,
   asPostgrestResponse,
   assertPostgrestSuccess,
@@ -3682,7 +3939,6 @@ function createRagableServerClient(options) {
   parseSseDataLine,
   parseTransportResponse,
   readSseStream,
-  resolveRagableApiBase,
   runAgentChatStream,
   runAgentChatStreamForUi,
   runAgentChatStreamLenient,