@ragable/sdk 0.7.5 → 0.7.6

package/dist/index.d.mts

@@ -1520,6 +1520,132 @@ interface BrowserRealtimeSubscription {
     unsubscribe: () => void;
     readonly status: BrowserRealtimeStatus;
 }
+interface BrowserStorageItem {
+    type: "file" | "folder";
+    path: string;
+    name: string;
+    size?: string | null;
+    contentType?: string | null;
+    updated?: string | null;
+}
+interface BrowserStorageListResult {
+    bucket: string;
+    prefix: string;
+    items: BrowserStorageItem[];
+    nextPageToken: string | null;
+}
+interface BrowserStorageUploadResult {
+    success: true;
+    path: string;
+    size: string | null;
+    contentType: string | null;
+    updated: string | null;
+}
+interface BrowserStorageDownloadResult {
+    path: string;
+    size: string | null;
+    contentType: string | null;
+    updated: string | null;
+    encoding: string;
+    contentsBase64: string;
+    text: string | null;
+    textIncluded: boolean;
+}
+interface BrowserStorageSignedUrlResult {
+    url: string;
+    method: string;
+    expiresInSeconds: number;
+    objectPath: string;
+}
+interface BrowserStorageBulkDeleteResult {
+    success: boolean;
+    totalRequested: number;
+    uniquePaths: number;
+    deleted: string[];
+    errors: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+declare class BrowserStorageBucketClient {
+    private readonly options;
+    private readonly fetchImpl;
+    private readonly bucketId;
+    constructor(options: RagableBrowserClientOptions, fetchImpl: typeof fetch, bucketId: string);
+    private get authGroupId();
+    private base;
+    private bearerToken;
+    private req;
+    list(params?: {
+        prefix?: string;
+        delimiter?: string;
+        maxResults?: number;
+        pageToken?: string;
+    }): Promise<BrowserStorageListResult>;
+    upload(params: {
+        objectPath: string;
+        file: Blob | ArrayBuffer | Uint8Array;
+        fileName?: string;
+        contentType?: string;
+        cacheControl?: string;
+    }): Promise<BrowserStorageUploadResult>;
+    download(params: {
+        objectPath: string;
+        asText?: boolean;
+        maxTextBytes?: number;
+    }): Promise<BrowserStorageDownloadResult>;
+    delete(objectPath: string): Promise<{
+        success: true;
+        path: string;
+    }>;
+    bulkDelete(objectPaths: string[]): Promise<BrowserStorageBulkDeleteResult>;
+    getSignedUploadUrl(params: {
+        objectPath: string;
+        contentType?: string;
+        expiresInSeconds?: number;
+    }): Promise<BrowserStorageSignedUrlResult>;
+    getSignedDownloadUrl(params: {
+        objectPath: string;
+        expiresInSeconds?: number;
+    }): Promise<BrowserStorageSignedUrlResult>;
+    copy(params: {
+        sourcePath: string;
+        destinationPath: string;
+    }): Promise<{
+        success: true;
+        sourcePath: string;
+        destinationPath: string;
+    }>;
+    move(params: {
+        sourcePath: string;
+        destinationPath: string;
+    }): Promise<{
+        success: true;
+        sourcePath: string;
+        destinationPath: string;
+    }>;
+    createFolder(folderPath: string): Promise<{
+        success: true;
+        folderPath: string;
+    }>;
+    deleteFolder(folderPath: string): Promise<{
+        success: true;
+        folderPath: string;
+    }>;
+    getMetadata(objectPath: string): Promise<{
+        name: string;
+        contentType: string | null;
+        size: string | null;
+        updated: string | null;
+        metadata?: Record<string, string>;
+    }>;
+}
+declare class RagableBrowserStorageClient {
+    private readonly options;
+    private readonly fetchImpl;
+    constructor(options: RagableBrowserClientOptions, fetchImpl: typeof fetch);
+    from(bucketId: string): BrowserStorageBucketClient;
+}
 interface AgentConversationMessage {
     role: "user" | "assistant";
     content: string;
@@ -1588,6 +1714,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly auth: RagableBrowserAuthClient<AuthUser>;
     readonly database: RagableBrowserDatabaseClient<Database>;
     readonly db: RagableBrowserDatabaseClient<Database>;
+    readonly storage: RagableBrowserStorageClient;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);

package/dist/index.d.ts

@@ -1520,6 +1520,132 @@ interface BrowserRealtimeSubscription {
     unsubscribe: () => void;
     readonly status: BrowserRealtimeStatus;
 }
+interface BrowserStorageItem {
+    type: "file" | "folder";
+    path: string;
+    name: string;
+    size?: string | null;
+    contentType?: string | null;
+    updated?: string | null;
+}
+interface BrowserStorageListResult {
+    bucket: string;
+    prefix: string;
+    items: BrowserStorageItem[];
+    nextPageToken: string | null;
+}
+interface BrowserStorageUploadResult {
+    success: true;
+    path: string;
+    size: string | null;
+    contentType: string | null;
+    updated: string | null;
+}
+interface BrowserStorageDownloadResult {
+    path: string;
+    size: string | null;
+    contentType: string | null;
+    updated: string | null;
+    encoding: string;
+    contentsBase64: string;
+    text: string | null;
+    textIncluded: boolean;
+}
+interface BrowserStorageSignedUrlResult {
+    url: string;
+    method: string;
+    expiresInSeconds: number;
+    objectPath: string;
+}
+interface BrowserStorageBulkDeleteResult {
+    success: boolean;
+    totalRequested: number;
+    uniquePaths: number;
+    deleted: string[];
+    errors: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+declare class BrowserStorageBucketClient {
+    private readonly options;
+    private readonly fetchImpl;
+    private readonly bucketId;
+    constructor(options: RagableBrowserClientOptions, fetchImpl: typeof fetch, bucketId: string);
+    private get authGroupId();
+    private base;
+    private bearerToken;
+    private req;
+    list(params?: {
+        prefix?: string;
+        delimiter?: string;
+        maxResults?: number;
+        pageToken?: string;
+    }): Promise<BrowserStorageListResult>;
+    upload(params: {
+        objectPath: string;
+        file: Blob | ArrayBuffer | Uint8Array;
+        fileName?: string;
+        contentType?: string;
+        cacheControl?: string;
+    }): Promise<BrowserStorageUploadResult>;
+    download(params: {
+        objectPath: string;
+        asText?: boolean;
+        maxTextBytes?: number;
+    }): Promise<BrowserStorageDownloadResult>;
+    delete(objectPath: string): Promise<{
+        success: true;
+        path: string;
+    }>;
+    bulkDelete(objectPaths: string[]): Promise<BrowserStorageBulkDeleteResult>;
+    getSignedUploadUrl(params: {
+        objectPath: string;
+        contentType?: string;
+        expiresInSeconds?: number;
+    }): Promise<BrowserStorageSignedUrlResult>;
+    getSignedDownloadUrl(params: {
+        objectPath: string;
+        expiresInSeconds?: number;
+    }): Promise<BrowserStorageSignedUrlResult>;
+    copy(params: {
+        sourcePath: string;
+        destinationPath: string;
+    }): Promise<{
+        success: true;
+        sourcePath: string;
+        destinationPath: string;
+    }>;
+    move(params: {
+        sourcePath: string;
+        destinationPath: string;
+    }): Promise<{
+        success: true;
+        sourcePath: string;
+        destinationPath: string;
+    }>;
+    createFolder(folderPath: string): Promise<{
+        success: true;
+        folderPath: string;
+    }>;
+    deleteFolder(folderPath: string): Promise<{
+        success: true;
+        folderPath: string;
+    }>;
+    getMetadata(objectPath: string): Promise<{
+        name: string;
+        contentType: string | null;
+        size: string | null;
+        updated: string | null;
+        metadata?: Record<string, string>;
+    }>;
+}
+declare class RagableBrowserStorageClient {
+    private readonly options;
+    private readonly fetchImpl;
+    constructor(options: RagableBrowserClientOptions, fetchImpl: typeof fetch);
+    from(bucketId: string): BrowserStorageBucketClient;
+}
 interface AgentConversationMessage {
     role: "user" | "assistant";
     content: string;
@@ -1588,6 +1714,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly auth: RagableBrowserAuthClient<AuthUser>;
     readonly database: RagableBrowserDatabaseClient<Database>;
     readonly db: RagableBrowserDatabaseClient<Database>;
+    readonly storage: RagableBrowserStorageClient;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);

package/dist/index.js

@@ -3291,6 +3291,113 @@ 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;
@@ -3484,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()`. */
@@ -3521,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();