@bunbase-ae/js 1.0.0 → 1.0.1-next.3.ee6c18d

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@bunbase-ae/js",
-  "version": "1.0.0",
+  "version": "1.0.1-next.3.ee6c18d",
   "type": "module",
   "description": "TypeScript/JavaScript SDK for BunBase",
+  "homepage": "https://docs-bunbase.palmcode.ae/sdk/javascript",
   "files": [
     "src"
   ],

package/src/index.ts

@@ -38,7 +38,14 @@ export { AuthClient, type AuthSnapshot } from "./auth";
 export { BunBaseClient } from "./client";
 export { CollectionClient } from "./collection";
 export { RealtimeClient, type SubscribeOptions } from "./realtime";
-export { type SignedUploadResult, StorageClient, type UploadOptions } from "./storage";
+export {
+  type ImageTransformFit,
+  type ImageTransformFormat,
+  type ImageTransformOptions,
+  type SignedUploadResult,
+  StorageClient,
+  type UploadOptions,
+} from "./storage";
 export {
   type AggregateFunction,
   type AggregateResult,

package/src/storage.ts

@@ -4,6 +4,22 @@ import type { HttpClient } from "./http";
 import type { FileRecord } from "./types";
 import { BunBaseError } from "./types";
 
+export type ImageTransformFit = "cover" | "contain" | "inside";
+export type ImageTransformFormat = "webp" | "jpeg" | "png";
+
+export interface ImageTransformOptions {
+  /** Output width in pixels (1–4096). */
+  width?: number;
+  /** Output height in pixels (1–4096). */
+  height?: number;
+  /** How to fit the image into the given dimensions. Default: "inside". */
+  fit?: ImageTransformFit;
+  /** Convert to this output format. Omit to keep the original format. */
+  format?: ImageTransformFormat;
+  /** Quality for JPEG/WebP, 1–100. Default: 85. */
+  quality?: number;
+}
+
 export interface UploadOptions {
   // Target storage bucket. Defaults to "default" if omitted.
   bucket?: string;
@@ -190,10 +206,21 @@ export class StorageClient {
   // Do NOT use this for private files — the browser cannot send the
   // Authorization header via <img src>. For private files, call signedUrl()
   // to get a time-limited signed URL instead.
-  downloadUrl(id: string, filename?: string | null): string {
+  downloadUrl(id: string, filename?: string | null, transform?: ImageTransformOptions): string {
     if (id.startsWith("http")) return id;
     const base = `${this.http.baseUrl}/api/v1/storage/${encodeURIComponent(id)}`;
-    return filename ? `${base}/${encodeURIComponent(filename)}` : base;
+    let url = filename ? `${base}/${encodeURIComponent(filename)}` : base;
+    if (transform) {
+      const params = new URLSearchParams();
+      if (transform.width != null) params.set("w", String(transform.width));
+      if (transform.height != null) params.set("h", String(transform.height));
+      if (transform.fit) params.set("fit", transform.fit);
+      if (transform.format) params.set("format", transform.format);
+      if (transform.quality != null) params.set("q", String(transform.quality));
+      const qs = params.toString();
+      if (qs) url = `${url}?${qs}`;
+    }
+    return url;
   }
 
   async list(): Promise<FileRecord[]> {