@ragable/sdk 0.6.24 → 0.7.5

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,
@@ -3301,12 +3295,10 @@ 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();
@@ -3506,7 +3498,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
@@ -3582,15 +3573,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 +3801,7 @@ function createRagableServerClient(options) {
   RagableTimeoutError,
   SessionStorageAdapter,
   ShiftClient,
+  StorageClient,
   Transport,
   asPostgrestResponse,
   assertPostgrestSuccess,
@@ -3682,7 +3830,6 @@ function createRagableServerClient(options) {
   parseSseDataLine,
   parseTransportResponse,
   readSseStream,
-  resolveRagableApiBase,
   runAgentChatStream,
   runAgentChatStreamForUi,
   runAgentChatStreamLenient,