@flashbacktech/flashbackclient 0.0.16 → 0.0.17

package/README.md

@@ -17,7 +17,7 @@ npm install @flashbacktech/flashbackclient
 ### Client Library
 
 ```typescript
-import { FlashOnStellarClient, StellarNetwork } from '@flashbacktech/flashbackclient/client';
+import { FlashOnStellarClient, StellarNetwork } from '@flashbacktech/flashbackclient/stellar';
 ```
 
 See the [Stellar README](STELLAR.md) for usage instructions.

package/dist/consumer/index.d.ts

@@ -0,0 +1,70 @@
+import type { Buffer, Blob, File } from 'buffer';
+export interface UploadRequest {
+    folderId: string;
+    fileId: string;
+    data: string | Blob | Buffer | File | ArrayBuffer;
+    type: 'base64' | 'binary' | 'multipart';
+}
+export interface UploadResponse {
+    url: string;
+}
+export interface GetUrlParams {
+    folder_id: string;
+    file_id: string;
+}
+export interface DeleteParams {
+    folder_id: string;
+    file_id: string;
+}
+export interface DeleteResponse {
+    success: boolean;
+}
+export interface ErrorResponse {
+    error: string;
+    message: string;
+}
+interface StorageClientConfig {
+    baseUrl: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+export declare class StorageClient {
+    private static instance;
+    private client;
+    private readonly config;
+    private constructor();
+    /**
+     * Initialize and get the StorageClient instance
+     * @param config - Configuration for the storage service
+     * @returns StorageClient instance
+     */
+    static initialize(config: StorageClientConfig): StorageClient;
+    /**
+     * Get the current instance of StorageClient
+     * @throws Error if client hasn't been initialized
+     */
+    static getInstance(): StorageClient;
+    /**
+     * Reset the client instance (useful for testing or reconfiguration)
+     */
+    static reset(): void;
+    /**
+     * Upload a file to storage
+     * @param params Upload parameters including file data and type
+     * @returns Promise with the file URL
+     */
+    upload(params: UploadRequest): Promise<UploadResponse>;
+    /**
+     * Get the URL for a file
+     * @param params File identifier parameters
+     * @returns Promise with the file URL
+     */
+    getUrl(params: GetUrlParams): Promise<UploadResponse>;
+    /**
+     * Delete a file from storage
+     * @param params File identifier parameters
+     * @returns Promise indicating success
+     */
+    delete(params: DeleteParams): Promise<DeleteResponse>;
+}
+export {};

package/dist/consumer/index.js

@@ -0,0 +1,143 @@
+import axios from 'axios';
+import { FormData } from 'formdata-node';
+export class StorageClient {
+    constructor(config) {
+        this.config = {
+            baseUrl: config.baseUrl.replace(/\/$/, ''),
+            timeout: config.timeout || 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                ...config.headers,
+            },
+        };
+        this.client = axios.create({
+            baseURL: this.config.baseUrl,
+            timeout: this.config.timeout,
+            headers: this.config.headers,
+        });
+    }
+    /**
+     * Initialize and get the StorageClient instance
+     * @param config - Configuration for the storage service
+     * @returns StorageClient instance
+     */
+    static initialize(config) {
+        if (!StorageClient.instance) {
+            StorageClient.instance = new StorageClient(config);
+        }
+        return StorageClient.instance;
+    }
+    /**
+     * Get the current instance of StorageClient
+     * @throws Error if client hasn't been initialized
+     */
+    static getInstance() {
+        if (!StorageClient.instance) {
+            throw new Error('StorageClient has not been initialized. Call initialize() first.');
+        }
+        return StorageClient.instance;
+    }
+    /**
+     * Reset the client instance (useful for testing or reconfiguration)
+     */
+    static reset() {
+        StorageClient.instance = null;
+    }
+    /**
+     * Upload a file to storage
+     * @param params Upload parameters including file data and type
+     * @returns Promise with the file URL
+     */
+    async upload(params) {
+        try {
+            let url = '';
+            switch (params.type) {
+                case 'multipart': {
+                    const formData = new FormData();
+                    formData.append('type', 'multipart');
+                    formData.append('folderId', params.folderId);
+                    formData.append('fileId', params.fileId);
+                    formData.append('file', params.data);
+                    const response = await this.client.post('/', formData, {
+                        headers: { 'Content-Type': 'multipart/form-data' },
+                        // Note: axios will automatically set the correct Content-Type boundary
+                    });
+                    url = response.data.url;
+                    break;
+                }
+                case 'binary': {
+                    // Binary upload
+                    const response = await this.client.post('/', params.data, {
+                        headers: {
+                            'Content-Type': 'application/octet-stream',
+                            'x-upload-type': 'binary',
+                            'x-folder-id': params.folderId,
+                            'x-file-id': params.fileId,
+                        },
+                    });
+                    url = response.data.url;
+                    break;
+                }
+                case 'base64': {
+                    const response = await this.client.post('/', {
+                        type: 'base64',
+                        folderId: params.folderId,
+                        fileId: params.fileId,
+                        data: params.data,
+                    }, {
+                        headers: { 'Content-Type': 'application/json' },
+                    });
+                    url = response.data.url;
+                    break;
+                }
+                default:
+                    throw new Error('Invalid file type');
+            }
+            return { url };
+        }
+        catch (error) {
+            if (axios.isAxiosError(error) && error.response?.data) {
+                const errorData = error.response.data;
+                throw new Error(`Upload failed: ${errorData.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get the URL for a file
+     * @param params File identifier parameters
+     * @returns Promise with the file URL
+     */
+    async getUrl(params) {
+        try {
+            const { data } = await this.client.get('/', { params });
+            return data;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error) && error.response?.data) {
+                const errorData = error.response.data;
+                throw new Error(`Get URL failed: ${errorData.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Delete a file from storage
+     * @param params File identifier parameters
+     * @returns Promise indicating success
+     */
+    async delete(params) {
+        try {
+            const { data } = await this.client.delete('/', { params });
+            return data;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error) && error.response?.data) {
+                const errorData = error.response.data;
+                throw new Error(`Delete failed: ${errorData.message}`);
+            }
+            throw error;
+        }
+    }
+}
+StorageClient.instance = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flashbacktech/flashbackclient",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "publishConfig": {
     "access": "public"
   },
@@ -21,9 +21,11 @@
     "pub": "npm run build && npm version patch && npm publish --access public"
   },
   "author": "Javier Ortiz <javier.ortiz@flashback.tech>",
-  "license": "ISC",
+  "license": "MIT",
   "dependencies": {
-    "@stellar/stellar-sdk": "^13.0.0"
+    "@stellar/stellar-sdk": "^13.0.0",
+    "axios": "^1.7.9",
+    "formdata-node": "^6.0.3"
   },
   "bin": {
     "": "./dist/.min.js"