@tspvivek/baasix-sdk 0.1.0-alpha.1

package/dist/modules/files.d.ts

@@ -0,0 +1,187 @@
+import { H as HttpClient, i as UploadOptions, j as FileMetadata, Q as QueryParams, e as PaginatedResponse, k as AssetTransformOptions } from '../client-CzF9B60b.js';
+import '../types-BdjsGANq.js';
+
+interface FilesModuleConfig {
+    client: HttpClient;
+}
+/**
+ * Files module for file upload, management, and asset transformations.
+ *
+ * @example
+ * ```typescript
+ * // Upload a file
+ * const file = await baasix.files.upload(fileInput.files[0], {
+ *   title: 'My Image',
+ *   isPublic: true
+ * });
+ *
+ * // Get asset URL with transformations
+ * const url = baasix.files.getAssetUrl(file.id, {
+ *   width: 200,
+ *   height: 200,
+ *   fit: 'cover'
+ * });
+ * ```
+ */
+declare class FilesModule {
+    private client;
+    constructor(config: FilesModuleConfig);
+    /**
+     * Upload a file
+     *
+     * @example
+     * ```typescript
+     * // Browser File API
+     * const metadata = await baasix.files.upload(fileInput.files[0], {
+     *   title: 'Product Image',
+     *   folder: 'products',
+     *   isPublic: true,
+     *   onProgress: (progress) => console.log(`${progress}% uploaded`)
+     * });
+     *
+     * // React Native with expo-image-picker
+     * const metadata = await baasix.files.upload({
+     *   uri: result.uri,
+     *   name: 'photo.jpg',
+     *   type: 'image/jpeg'
+     * });
+     * ```
+     */
+    upload(file: File | Blob | {
+        uri: string;
+        name: string;
+        type: string;
+    }, options?: UploadOptions): Promise<FileMetadata>;
+    /**
+     * Upload multiple files
+     *
+     * @example
+     * ```typescript
+     * const files = await baasix.files.uploadMany(fileInput.files, {
+     *   folder: 'gallery',
+     *   isPublic: true
+     * });
+     * ```
+     */
+    uploadMany(files: FileList | File[] | Array<{
+        uri: string;
+        name: string;
+        type: string;
+    }>, options?: Omit<UploadOptions, "onProgress">): Promise<FileMetadata[]>;
+    /**
+     * List files with optional filtering
+     *
+     * @example
+     * ```typescript
+     * const { data, totalCount } = await baasix.files.find({
+     *   filter: { mimeType: { startsWith: 'image/' } },
+     *   limit: 20
+     * });
+     * ```
+     */
+    find(params?: QueryParams): Promise<PaginatedResponse<FileMetadata>>;
+    /**
+     * Get file metadata by ID
+     *
+     * @example
+     * ```typescript
+     * const file = await baasix.files.findOne('file-uuid');
+     * console.log(file.filename, file.size);
+     * ```
+     */
+    findOne(id: string): Promise<FileMetadata>;
+    /**
+     * Update file metadata
+     *
+     * @example
+     * ```typescript
+     * await baasix.files.update('file-uuid', {
+     *   title: 'Updated Title',
+     *   description: 'New description'
+     * });
+     * ```
+     */
+    update(id: string, data: Partial<Pick<FileMetadata, "title" | "description" | "isPublic">>): Promise<FileMetadata>;
+    /**
+     * Delete a file
+     *
+     * @example
+     * ```typescript
+     * await baasix.files.delete('file-uuid');
+     * ```
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Delete multiple files
+     *
+     * @example
+     * ```typescript
+     * await baasix.files.deleteMany(['id1', 'id2', 'id3']);
+     * ```
+     */
+    deleteMany(ids: string[]): Promise<void>;
+    /**
+     * Get the URL for an asset with optional transformations
+     *
+     * @example
+     * ```typescript
+     * // Original file
+     * const url = baasix.files.getAssetUrl('file-uuid');
+     *
+     * // Resized thumbnail
+     * const thumbUrl = baasix.files.getAssetUrl('file-uuid', {
+     *   width: 200,
+     *   height: 200,
+     *   fit: 'cover',
+     *   quality: 80
+     * });
+     *
+     * // Convert to WebP
+     * const webpUrl = baasix.files.getAssetUrl('file-uuid', {
+     *   format: 'webp',
+     *   quality: 85
+     * });
+     * ```
+     */
+    getAssetUrl(id: string, options?: AssetTransformOptions): string;
+    /**
+     * Download a file as a Blob
+     *
+     * @example
+     * ```typescript
+     * const blob = await baasix.files.download('file-uuid');
+     *
+     * // Create download link
+     * const url = URL.createObjectURL(blob);
+     * const a = document.createElement('a');
+     * a.href = url;
+     * a.download = 'filename.pdf';
+     * a.click();
+     * ```
+     */
+    download(id: string, options?: AssetTransformOptions): Promise<Blob>;
+    /**
+     * Get file as base64 string (useful for React Native)
+     *
+     * @example
+     * ```typescript
+     * const base64 = await baasix.files.toBase64('file-uuid');
+     * // Use in Image component: <Image source={{ uri: `data:image/jpeg;base64,${base64}` }} />
+     * ```
+     */
+    toBase64(id: string, options?: AssetTransformOptions): Promise<string>;
+    /**
+     * Import file from URL
+     *
+     * @example
+     * ```typescript
+     * const file = await baasix.files.importFromUrl(
+     *   'https://example.com/image.jpg',
+     *   { title: 'Imported Image' }
+     * );
+     * ```
+     */
+    importFromUrl(url: string, options?: UploadOptions): Promise<FileMetadata>;
+}
+
+export { AssetTransformOptions, FileMetadata, FilesModule, type FilesModuleConfig, UploadOptions };

package/dist/modules/files.js

@@ -0,0 +1,264 @@
+// src/modules/files.ts
+var FilesModule = class {
+  client;
+  constructor(config) {
+    this.client = config.client;
+  }
+  /**
+   * Upload a file
+   *
+   * @example
+   * ```typescript
+   * // Browser File API
+   * const metadata = await baasix.files.upload(fileInput.files[0], {
+   *   title: 'Product Image',
+   *   folder: 'products',
+   *   isPublic: true,
+   *   onProgress: (progress) => console.log(`${progress}% uploaded`)
+   * });
+   *
+   * // React Native with expo-image-picker
+   * const metadata = await baasix.files.upload({
+   *   uri: result.uri,
+   *   name: 'photo.jpg',
+   *   type: 'image/jpeg'
+   * });
+   * ```
+   */
+  async upload(file, options) {
+    const formData = new FormData();
+    if (file instanceof File || file instanceof Blob) {
+      formData.append("file", file);
+    } else {
+      formData.append("file", file);
+    }
+    if (options?.title) {
+      formData.append("title", options.title);
+    }
+    if (options?.description) {
+      formData.append("description", options.description);
+    }
+    if (options?.folder) {
+      formData.append("folder", options.folder);
+    }
+    if (options?.storage) {
+      formData.append("storage", options.storage);
+    }
+    if (options?.isPublic !== void 0) {
+      formData.append("isPublic", String(options.isPublic));
+    }
+    if (options?.metadata) {
+      formData.append("metadata", JSON.stringify(options.metadata));
+    }
+    const response = await this.client.upload(
+      "/files",
+      formData,
+      { onProgress: options?.onProgress }
+    );
+    return response.data;
+  }
+  /**
+   * Upload multiple files
+   *
+   * @example
+   * ```typescript
+   * const files = await baasix.files.uploadMany(fileInput.files, {
+   *   folder: 'gallery',
+   *   isPublic: true
+   * });
+   * ```
+   */
+  async uploadMany(files, options) {
+    const results = [];
+    const fileArray = files instanceof FileList ? Array.from(files) : files;
+    for (const file of fileArray) {
+      const metadata = await this.upload(file, options);
+      results.push(metadata);
+    }
+    return results;
+  }
+  /**
+   * List files with optional filtering
+   *
+   * @example
+   * ```typescript
+   * const { data, totalCount } = await baasix.files.find({
+   *   filter: { mimeType: { startsWith: 'image/' } },
+   *   limit: 20
+   * });
+   * ```
+   */
+  async find(params) {
+    return this.client.get("/files", {
+      params
+    });
+  }
+  /**
+   * Get file metadata by ID
+   *
+   * @example
+   * ```typescript
+   * const file = await baasix.files.findOne('file-uuid');
+   * console.log(file.filename, file.size);
+   * ```
+   */
+  async findOne(id) {
+    const response = await this.client.get(`/files/${id}`);
+    return response.data;
+  }
+  /**
+   * Update file metadata
+   *
+   * @example
+   * ```typescript
+   * await baasix.files.update('file-uuid', {
+   *   title: 'Updated Title',
+   *   description: 'New description'
+   * });
+   * ```
+   */
+  async update(id, data) {
+    const response = await this.client.patch(
+      `/files/${id}`,
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Delete a file
+   *
+   * @example
+   * ```typescript
+   * await baasix.files.delete('file-uuid');
+   * ```
+   */
+  async delete(id) {
+    await this.client.delete(`/files/${id}`);
+  }
+  /**
+   * Delete multiple files
+   *
+   * @example
+   * ```typescript
+   * await baasix.files.deleteMany(['id1', 'id2', 'id3']);
+   * ```
+   */
+  async deleteMany(ids) {
+    await Promise.all(ids.map((id) => this.delete(id)));
+  }
+  /**
+   * Get the URL for an asset with optional transformations
+   *
+   * @example
+   * ```typescript
+   * // Original file
+   * const url = baasix.files.getAssetUrl('file-uuid');
+   *
+   * // Resized thumbnail
+   * const thumbUrl = baasix.files.getAssetUrl('file-uuid', {
+   *   width: 200,
+   *   height: 200,
+   *   fit: 'cover',
+   *   quality: 80
+   * });
+   *
+   * // Convert to WebP
+   * const webpUrl = baasix.files.getAssetUrl('file-uuid', {
+   *   format: 'webp',
+   *   quality: 85
+   * });
+   * ```
+   */
+  getAssetUrl(id, options) {
+    const baseUrl = this.client.getBaseUrl();
+    const url = new URL(`/assets/${id}`, baseUrl);
+    if (options) {
+      if (options.width) {
+        url.searchParams.set("width", String(options.width));
+      }
+      if (options.height) {
+        url.searchParams.set("height", String(options.height));
+      }
+      if (options.fit) {
+        url.searchParams.set("fit", options.fit);
+      }
+      if (options.quality) {
+        url.searchParams.set("quality", String(options.quality));
+      }
+      if (options.format) {
+        url.searchParams.set("format", options.format);
+      }
+    }
+    return url.toString();
+  }
+  /**
+   * Download a file as a Blob
+   *
+   * @example
+   * ```typescript
+   * const blob = await baasix.files.download('file-uuid');
+   *
+   * // Create download link
+   * const url = URL.createObjectURL(blob);
+   * const a = document.createElement('a');
+   * a.href = url;
+   * a.download = 'filename.pdf';
+   * a.click();
+   * ```
+   */
+  async download(id, options) {
+    const url = this.getAssetUrl(id, options);
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to download file: ${response.statusText}`);
+    }
+    return response.blob();
+  }
+  /**
+   * Get file as base64 string (useful for React Native)
+   *
+   * @example
+   * ```typescript
+   * const base64 = await baasix.files.toBase64('file-uuid');
+   * // Use in Image component: <Image source={{ uri: `data:image/jpeg;base64,${base64}` }} />
+   * ```
+   */
+  async toBase64(id, options) {
+    const blob = await this.download(id, options);
+    return new Promise((resolve, reject) => {
+      const reader = new FileReader();
+      reader.onloadend = () => {
+        const result = reader.result;
+        const base64 = result.split(",")[1];
+        resolve(base64);
+      };
+      reader.onerror = reject;
+      reader.readAsDataURL(blob);
+    });
+  }
+  /**
+   * Import file from URL
+   *
+   * @example
+   * ```typescript
+   * const file = await baasix.files.importFromUrl(
+   *   'https://example.com/image.jpg',
+   *   { title: 'Imported Image' }
+   * );
+   * ```
+   */
+  async importFromUrl(url, options) {
+    const response = await this.client.post(
+      "/files/import",
+      {
+        url,
+        ...options
+      }
+    );
+    return response.data;
+  }
+};
+
+export { FilesModule };
+//# sourceMappingURL=files.js.map
+//# sourceMappingURL=files.js.map

package/dist/modules/files.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/modules/files.ts"],"names":[],"mappings":"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","file":"files.js","sourcesContent":["import type { HttpClient } from \"../client\";\nimport type {\n  AssetTransformOptions,\n  FileMetadata,\n  PaginatedResponse,\n  QueryParams,\n  UploadOptions,\n} from \"../types\";\n\nexport interface FilesModuleConfig {\n  client: HttpClient;\n}\n\n/**\n * Files module for file upload, management, and asset transformations.\n *\n * @example\n * ```typescript\n * // Upload a file\n * const file = await baasix.files.upload(fileInput.files[0], {\n *   title: 'My Image',\n *   isPublic: true\n * });\n *\n * // Get asset URL with transformations\n * const url = baasix.files.getAssetUrl(file.id, {\n *   width: 200,\n *   height: 200,\n *   fit: 'cover'\n * });\n * ```\n */\nexport class FilesModule {\n  private client: HttpClient;\n\n  constructor(config: FilesModuleConfig) {\n    this.client = config.client;\n  }\n\n  /**\n   * Upload a file\n   *\n   * @example\n   * ```typescript\n   * // Browser File API\n   * const metadata = await baasix.files.upload(fileInput.files[0], {\n   *   title: 'Product Image',\n   *   folder: 'products',\n   *   isPublic: true,\n   *   onProgress: (progress) => console.log(`${progress}% uploaded`)\n   * });\n   *\n   * // React Native with expo-image-picker\n   * const metadata = await baasix.files.upload({\n   *   uri: result.uri,\n   *   name: 'photo.jpg',\n   *   type: 'image/jpeg'\n   * });\n   * ```\n   */\n  async upload(\n    file: File | Blob | { uri: string; name: string; type: string },\n    options?: UploadOptions\n  ): Promise<FileMetadata> {\n    const formData = new FormData();\n\n    // Handle different file types (Browser File, Blob, React Native)\n    if (file instanceof File || file instanceof Blob) {\n      formData.append(\"file\", file);\n    } else {\n      // React Native style object with uri\n      formData.append(\"file\", file as unknown as Blob);\n    }\n\n    // Add metadata options\n    if (options?.title) {\n      formData.append(\"title\", options.title);\n    }\n    if (options?.description) {\n      formData.append(\"description\", options.description);\n    }\n    if (options?.folder) {\n      formData.append(\"folder\", options.folder);\n    }\n    if (options?.storage) {\n      formData.append(\"storage\", options.storage);\n    }\n    if (options?.isPublic !== undefined) {\n      formData.append(\"isPublic\", String(options.isPublic));\n    }\n    if (options?.metadata) {\n      formData.append(\"metadata\", JSON.stringify(options.metadata));\n    }\n\n    const response = await this.client.upload<{ data: FileMetadata }>(\n      \"/files\",\n      formData,\n      { onProgress: options?.onProgress }\n    );\n\n    return response.data;\n  }\n\n  /**\n   * Upload multiple files\n   *\n   * @example\n   * ```typescript\n   * const files = await baasix.files.uploadMany(fileInput.files, {\n   *   folder: 'gallery',\n   *   isPublic: true\n   * });\n   * ```\n   */\n  async uploadMany(\n    files: FileList | File[] | Array<{ uri: string; name: string; type: string }>,\n    options?: Omit<UploadOptions, \"onProgress\">\n  ): Promise<FileMetadata[]> {\n    const results: FileMetadata[] = [];\n    \n    // Handle different input types\n    const fileArray: Array<File | { uri: string; name: string; type: string }> = \n      files instanceof FileList \n        ? Array.from(files) \n        : files;\n\n    for (const file of fileArray) {\n      const metadata = await this.upload(file, options);\n      results.push(metadata);\n    }\n\n    return results;\n  }\n\n  /**\n   * List files with optional filtering\n   *\n   * @example\n   * ```typescript\n   * const { data, totalCount } = await baasix.files.find({\n   *   filter: { mimeType: { startsWith: 'image/' } },\n   *   limit: 20\n   * });\n   * ```\n   */\n  async find(params?: QueryParams): Promise<PaginatedResponse<FileMetadata>> {\n    return this.client.get<PaginatedResponse<FileMetadata>>(\"/files\", {\n      params: params as Record<string, unknown>,\n    });\n  }\n\n  /**\n   * Get file metadata by ID\n   *\n   * @example\n   * ```typescript\n   * const file = await baasix.files.findOne('file-uuid');\n   * console.log(file.filename, file.size);\n   * ```\n   */\n  async findOne(id: string): Promise<FileMetadata> {\n    const response = await this.client.get<{ data: FileMetadata }>(`/files/${id}`);\n    return response.data;\n  }\n\n  /**\n   * Update file metadata\n   *\n   * @example\n   * ```typescript\n   * await baasix.files.update('file-uuid', {\n   *   title: 'Updated Title',\n   *   description: 'New description'\n   * });\n   * ```\n   */\n  async update(\n    id: string,\n    data: Partial<Pick<FileMetadata, \"title\" | \"description\" | \"isPublic\">>\n  ): Promise<FileMetadata> {\n    const response = await this.client.patch<{ data: FileMetadata }>(\n      `/files/${id}`,\n      data\n    );\n    return response.data;\n  }\n\n  /**\n   * Delete a file\n   *\n   * @example\n   * ```typescript\n   * await baasix.files.delete('file-uuid');\n   * ```\n   */\n  async delete(id: string): Promise<void> {\n    await this.client.delete(`/files/${id}`);\n  }\n\n  /**\n   * Delete multiple files\n   *\n   * @example\n   * ```typescript\n   * await baasix.files.deleteMany(['id1', 'id2', 'id3']);\n   * ```\n   */\n  async deleteMany(ids: string[]): Promise<void> {\n    await Promise.all(ids.map((id) => this.delete(id)));\n  }\n\n  /**\n   * Get the URL for an asset with optional transformations\n   *\n   * @example\n   * ```typescript\n   * // Original file\n   * const url = baasix.files.getAssetUrl('file-uuid');\n   *\n   * // Resized thumbnail\n   * const thumbUrl = baasix.files.getAssetUrl('file-uuid', {\n   *   width: 200,\n   *   height: 200,\n   *   fit: 'cover',\n   *   quality: 80\n   * });\n   *\n   * // Convert to WebP\n   * const webpUrl = baasix.files.getAssetUrl('file-uuid', {\n   *   format: 'webp',\n   *   quality: 85\n   * });\n   * ```\n   */\n  getAssetUrl(id: string, options?: AssetTransformOptions): string {\n    const baseUrl = this.client.getBaseUrl();\n    const url = new URL(`/assets/${id}`, baseUrl);\n\n    if (options) {\n      if (options.width) {\n        url.searchParams.set(\"width\", String(options.width));\n      }\n      if (options.height) {\n        url.searchParams.set(\"height\", String(options.height));\n      }\n      if (options.fit) {\n        url.searchParams.set(\"fit\", options.fit);\n      }\n      if (options.quality) {\n        url.searchParams.set(\"quality\", String(options.quality));\n      }\n      if (options.format) {\n        url.searchParams.set(\"format\", options.format);\n      }\n    }\n\n    return url.toString();\n  }\n\n  /**\n   * Download a file as a Blob\n   *\n   * @example\n   * ```typescript\n   * const blob = await baasix.files.download('file-uuid');\n   *\n   * // Create download link\n   * const url = URL.createObjectURL(blob);\n   * const a = document.createElement('a');\n   * a.href = url;\n   * a.download = 'filename.pdf';\n   * a.click();\n   * ```\n   */\n  async download(id: string, options?: AssetTransformOptions): Promise<Blob> {\n    const url = this.getAssetUrl(id, options);\n    const response = await fetch(url);\n    if (!response.ok) {\n      throw new Error(`Failed to download file: ${response.statusText}`);\n    }\n    return response.blob();\n  }\n\n  /**\n   * Get file as base64 string (useful for React Native)\n   *\n   * @example\n   * ```typescript\n   * const base64 = await baasix.files.toBase64('file-uuid');\n   * // Use in Image component: <Image source={{ uri: `data:image/jpeg;base64,${base64}` }} />\n   * ```\n   */\n  async toBase64(id: string, options?: AssetTransformOptions): Promise<string> {\n    const blob = await this.download(id, options);\n    return new Promise((resolve, reject) => {\n      const reader = new FileReader();\n      reader.onloadend = () => {\n        const result = reader.result as string;\n        // Remove data URL prefix\n        const base64 = result.split(\",\")[1];\n        resolve(base64);\n      };\n      reader.onerror = reject;\n      reader.readAsDataURL(blob);\n    });\n  }\n\n  /**\n   * Import file from URL\n   *\n   * @example\n   * ```typescript\n   * const file = await baasix.files.importFromUrl(\n   *   'https://example.com/image.jpg',\n   *   { title: 'Imported Image' }\n   * );\n   * ```\n   */\n  async importFromUrl(\n    url: string,\n    options?: UploadOptions\n  ): Promise<FileMetadata> {\n    const response = await this.client.post<{ data: FileMetadata }>(\n      \"/files/import\",\n      {\n        url,\n        ...options,\n      }\n    );\n    return response.data;\n  }\n}\n\n// Re-export types\nexport type { AssetTransformOptions, FileMetadata, UploadOptions };\n"]}