@fluxsave/sdk 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# @fluxsave/sdk
+
+JavaScript/TypeScript SDK for FluxSave. Supports API key + secret auth, file uploads, and file management.
+
+## Install
+
+```bash
+npm install @fluxsave/sdk
+# or
+yarn add @fluxsave/sdk
+```
+
+## Documentation
+
+https://fluxsave-sdk-docs.vercel.app/
+
+## Usage
+
+```ts
+import { FluxsaveClient } from '@fluxsave/sdk';
+
+const client = new FluxsaveClient({
+  baseUrl: 'https://fluxsaveapi.lutheralien.com',
+  apiKey: 'fs_xxx',
+  apiSecret: 'sk_xxx',
+  timeoutMs: 30000,
+  retry: { retries: 2, retryDelayMs: 400 },
+});
+
+const file = new File([blobData], 'photo.png', { type: 'image/png' });
+const uploaded = await client.uploadFile(file, { name: 'marketing-hero', transform: true });
+
+const files = await client.listFiles();
+await client.deleteFile(uploaded.data.fileId || uploaded.data._id);
+```
+
+## Node example
+
+```ts
+import { FluxsaveClient } from '@fluxsave/sdk';
+import { readFile } from 'node:fs/promises';
+
+const client = new FluxsaveClient({
+  baseUrl: 'https://fluxsaveapi.lutheralien.com',
+  apiKey: process.env.FLUXSAVE_KEY!,
+  apiSecret: process.env.FLUXSAVE_SECRET!,
+});
+
+const buffer = await readFile('./photo.png');
+const file = new Blob([buffer], { type: 'image/png' });
+const response = await client.uploadFile(file, { filename: 'photo.png' });
+```
+
+## API
+
+- `uploadFile(file, options)`
+- `uploadFiles(files, options)`
+- `listFiles()`
+- `getFileMetadata(fileId)`
+- `updateFile(fileId, file, options)`
+- `deleteFile(fileId)`
+- `getMetrics()`
+- `buildFileUrl(fileId, options)`
+- `setTimeout(timeoutMs)`
+- `setRetry(options)`
+- `fileFromBuffer(buffer, filename, type?)`
+
+## Auth
+
+Auth is sent as headers:
+
+```
+X-API-KEY: <apiKey>
+X-API-SECRET: <apiSecret>
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,217 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FluxsaveClient: () => FluxsaveClient,
+  FluxsaveError: () => FluxsaveError,
+  fileFromBuffer: () => fileFromBuffer
+});
+module.exports = __toCommonJS(index_exports);
+var FluxsaveError = class extends Error {
+  constructor(message, status, data) {
+    super(message);
+    this.name = "FluxsaveError";
+    this.status = status;
+    this.data = data;
+  }
+};
+var FluxsaveClient = class {
+  constructor(options) {
+    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.apiSecret = options.apiSecret;
+    this.fetchImpl = options.fetchImpl ?? fetch;
+    this.timeoutMs = options.timeoutMs ?? 3e4;
+    this.retry = {
+      retries: options.retry?.retries ?? 2,
+      retryDelayMs: options.retry?.retryDelayMs ?? 400,
+      retryOn: options.retry?.retryOn ?? [429, 500, 502, 503, 504]
+    };
+  }
+  setAuth(apiKey, apiSecret) {
+    this.apiKey = apiKey;
+    this.apiSecret = apiSecret;
+  }
+  setTimeout(timeoutMs) {
+    this.timeoutMs = timeoutMs;
+  }
+  setRetry(options) {
+    this.retry = {
+      retries: options.retries,
+      retryDelayMs: options.retryDelayMs ?? this.retry.retryDelayMs,
+      retryOn: options.retryOn ?? this.retry.retryOn
+    };
+  }
+  async uploadFile(file, options = {}) {
+    const form = new FormData();
+    form.append("file", file, options.filename || "file");
+    if (options.name) {
+      form.append("name", options.name);
+    }
+    if (options.transform !== void 0) {
+      form.append("transform", String(options.transform));
+    }
+    return this.request("/api/v1/files/upload", {
+      method: "POST",
+      body: form
+    });
+  }
+  async uploadFiles(files, options = {}) {
+    const form = new FormData();
+    files.forEach((item) => {
+      form.append("files", item.file, item.filename || "file");
+    });
+    if (options.name) {
+      form.append("name", options.name);
+    }
+    if (options.transform !== void 0) {
+      form.append("transform", String(options.transform));
+    }
+    return this.request("/api/v1/files/upload", {
+      method: "POST",
+      body: form
+    });
+  }
+  async listFiles() {
+    return this.request("/api/v1/files", {
+      method: "GET"
+    });
+  }
+  async getFileMetadata(fileId) {
+    return this.request(`/api/v1/files/metadata/${fileId}`, {
+      method: "GET"
+    });
+  }
+  async updateFile(fileId, file, options = {}) {
+    const form = new FormData();
+    form.append("file", file, options.filename || "file");
+    if (options.name) {
+      form.append("name", options.name);
+    }
+    if (options.transform !== void 0) {
+      form.append("transform", String(options.transform));
+    }
+    return this.request(`/api/v1/files/${fileId}`, {
+      method: "PUT",
+      body: form
+    });
+  }
+  async deleteFile(fileId) {
+    return this.request(`/api/v1/files/${fileId}`, {
+      method: "DELETE"
+    });
+  }
+  async getMetrics() {
+    return this.request("/api/v1/metrics", {
+      method: "GET"
+    });
+  }
+  buildFileUrl(fileId, options = {}) {
+    const url = new URL(`${this.baseUrl}/api/v1/files/${fileId}`);
+    if (options.width) url.searchParams.set("width", String(options.width));
+    if (options.height) url.searchParams.set("height", String(options.height));
+    if (options.format) url.searchParams.set("format", options.format);
+    if (options.quality !== void 0) url.searchParams.set("quality", String(options.quality));
+    return url.toString();
+  }
+  async request(path, init) {
+    if (!this.apiKey || !this.apiSecret) {
+      throw new FluxsaveError("API key and secret are required", 401);
+    }
+    const headers = new Headers(init.headers || {});
+    headers.set("x-api-key", this.apiKey);
+    headers.set("x-api-secret", this.apiSecret);
+    let attempt = 0;
+    while (true) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+      try {
+        const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+          ...init,
+          headers,
+          signal: controller.signal
+        });
+        const contentType = response.headers.get("content-type") || "";
+        const isJson = contentType.includes("application/json");
+        const payload = isJson ? await response.json() : await response.text();
+        if (!response.ok) {
+          const message = payload && (payload.message || payload.error) || response.statusText;
+          const error = new FluxsaveError(message, response.status, payload);
+          if (this.shouldRetry(response.status, attempt)) {
+            attempt += 1;
+            await this.sleep(this.retry.retryDelayMs);
+            continue;
+          }
+          throw error;
+        }
+        return payload;
+      } catch (error) {
+        if (error?.name === "AbortError") {
+          if (this.shouldRetry(0, attempt)) {
+            attempt += 1;
+            await this.sleep(this.retry.retryDelayMs);
+            continue;
+          }
+          throw new FluxsaveError("Request timed out", 408);
+        }
+        if (this.shouldRetry(0, attempt)) {
+          attempt += 1;
+          await this.sleep(this.retry.retryDelayMs);
+          continue;
+        }
+        throw error;
+      } finally {
+        clearTimeout(timeoutId);
+      }
+    }
+  }
+  shouldRetry(status, attempt) {
+    if (attempt >= this.retry.retries) {
+      return false;
+    }
+    if (status === 0) {
+      return true;
+    }
+    return this.retry.retryOn.includes(status);
+  }
+  async sleep(delayMs) {
+    await new Promise((resolve) => setTimeout(resolve, delayMs));
+  }
+};
+var toArrayBuffer = (buffer) => {
+  if (buffer instanceof Uint8Array) {
+    const copy = new Uint8Array(buffer.byteLength);
+    copy.set(buffer);
+    return copy.buffer;
+  }
+  return buffer;
+};
+var fileFromBuffer = (buffer, filename, type = "application/octet-stream") => {
+  const data = toArrayBuffer(buffer);
+  return new Blob([data], { type });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FluxsaveClient,
+  FluxsaveError,
+  fileFromBuffer
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type ApiSuccess<T> = {\n  status: number;\n  message: string;\n  data: T;\n};\n\nexport type ApiError = {\n  status: number;\n  message: string;\n  data?: unknown;\n};\n\nexport type FileRecord = {\n  _id?: string;\n  fileId?: string;\n  cloudId?: string;\n  filename: string;\n  originalFilename?: string;\n  url: string;\n  size: number;\n  mimeType: string;\n  width?: number;\n  height?: number;\n  createdAt?: string;\n  updatedAt?: string;\n};\n\nexport type Metrics = {\n  totalFiles: number;\n  totalStorageBytes: number;\n  averageFileSize: number;\n  storageLimitBytes: number;\n  storageRemainingBytes: number;\n  storageUsedPercent: number;\n  uploadsLast7Days: number;\n  latestUploadAt?: string | null;\n  byMimeType: Record<string, number>;\n};\n\nexport type FetchLike = typeof fetch;\n\nexport type RetryOptions = {\n  retries: number;\n  retryDelayMs?: number;\n  retryOn?: number[];\n};\n\nexport type FluxsaveClientOptions = {\n  baseUrl: string;\n  apiKey?: string;\n  apiSecret?: string;\n  fetchImpl?: FetchLike;\n  timeoutMs?: number;\n  retry?: RetryOptions;\n};\n\nexport type UploadOptions = {\n  name?: string;\n  transform?: boolean;\n  filename?: string;\n};\n\nexport type TransformOptions = {\n  width?: number;\n  height?: number;\n  format?: string;\n  quality?: number | string;\n};\n\nexport class FluxsaveError extends Error {\n  status: number;\n  data?: unknown;\n\n  constructor(message: string, status: number, data?: unknown) {\n    super(message);\n    this.name = 'FluxsaveError';\n    this.status = status;\n    this.data = data;\n  }\n}\n\nexport class FluxsaveClient {\n  private baseUrl: string;\n  private apiKey?: string;\n  private apiSecret?: string;\n  private fetchImpl: FetchLike;\n  private timeoutMs: number;\n  private retry: Required<RetryOptions>;\n\n  constructor(options: FluxsaveClientOptions) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\n    this.apiKey = options.apiKey;\n    this.apiSecret = options.apiSecret;\n    this.fetchImpl = options.fetchImpl ?? fetch;\n    this.timeoutMs = options.timeoutMs ?? 30000;\n    this.retry = {\n      retries: options.retry?.retries ?? 2,\n      retryDelayMs: options.retry?.retryDelayMs ?? 400,\n      retryOn: options.retry?.retryOn ?? [429, 500, 502, 503, 504],\n    };\n  }\n\n  setAuth(apiKey: string, apiSecret: string) {\n    this.apiKey = apiKey;\n    this.apiSecret = apiSecret;\n  }\n\n  setTimeout(timeoutMs: number) {\n    this.timeoutMs = timeoutMs;\n  }\n\n  setRetry(options: RetryOptions) {\n    this.retry = {\n      retries: options.retries,\n      retryDelayMs: options.retryDelayMs ?? this.retry.retryDelayMs,\n      retryOn: options.retryOn ?? this.retry.retryOn,\n    };\n  }\n\n  async uploadFile(file: Blob, options: UploadOptions = {}): Promise<ApiSuccess<FileRecord>> {\n    const form = new FormData();\n    form.append('file', file, options.filename || 'file');\n    if (options.name) {\n      form.append('name', options.name);\n    }\n    if (options.transform !== undefined) {\n      form.append('transform', String(options.transform));\n    }\n\n    return this.request<ApiSuccess<FileRecord>>('/api/v1/files/upload', {\n      method: 'POST',\n      body: form,\n    });\n  }\n\n  async uploadFiles(\n    files: Array<{ file: Blob; filename?: string }>,\n    options: UploadOptions = {}\n  ): Promise<ApiSuccess<FileRecord[]>> {\n    const form = new FormData();\n    files.forEach((item) => {\n      form.append('files', item.file, item.filename || 'file');\n    });\n    if (options.name) {\n      form.append('name', options.name);\n    }\n    if (options.transform !== undefined) {\n      form.append('transform', String(options.transform));\n    }\n\n    return this.request<ApiSuccess<FileRecord[]>>('/api/v1/files/upload', {\n      method: 'POST',\n      body: form,\n    });\n  }\n\n  async listFiles(): Promise<ApiSuccess<FileRecord[]>> {\n    return this.request<ApiSuccess<FileRecord[]>>('/api/v1/files', {\n      method: 'GET',\n    });\n  }\n\n  async getFileMetadata(fileId: string): Promise<ApiSuccess<FileRecord>> {\n    return this.request<ApiSuccess<FileRecord>>(`/api/v1/files/metadata/${fileId}`, {\n      method: 'GET',\n    });\n  }\n\n  async updateFile(fileId: string, file: Blob, options: UploadOptions = {}): Promise<ApiSuccess<FileRecord>> {\n    const form = new FormData();\n    form.append('file', file, options.filename || 'file');\n    if (options.name) {\n      form.append('name', options.name);\n    }\n    if (options.transform !== undefined) {\n      form.append('transform', String(options.transform));\n    }\n\n    return this.request<ApiSuccess<FileRecord>>(`/api/v1/files/${fileId}`, {\n      method: 'PUT',\n      body: form,\n    });\n  }\n\n  async deleteFile(fileId: string): Promise<ApiSuccess<null>> {\n    return this.request<ApiSuccess<null>>(`/api/v1/files/${fileId}`, {\n      method: 'DELETE',\n    });\n  }\n\n  async getMetrics(): Promise<ApiSuccess<Metrics>> {\n    return this.request<ApiSuccess<Metrics>>('/api/v1/metrics', {\n      method: 'GET',\n    });\n  }\n\n  buildFileUrl(fileId: string, options: TransformOptions = {}) {\n    const url = new URL(`${this.baseUrl}/api/v1/files/${fileId}`);\n    if (options.width) url.searchParams.set('width', String(options.width));\n    if (options.height) url.searchParams.set('height', String(options.height));\n    if (options.format) url.searchParams.set('format', options.format);\n    if (options.quality !== undefined) url.searchParams.set('quality', String(options.quality));\n    return url.toString();\n  }\n\n  private async request<T>(path: string, init: RequestInit): Promise<T> {\n    if (!this.apiKey || !this.apiSecret) {\n      throw new FluxsaveError('API key and secret are required', 401);\n    }\n\n    const headers = new Headers(init.headers || {});\n    headers.set('x-api-key', this.apiKey);\n    headers.set('x-api-secret', this.apiSecret);\n\n    let attempt = 0;\n    while (true) {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);\n      try {\n        const response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n          ...init,\n          headers,\n          signal: controller.signal,\n        });\n\n        const contentType = response.headers.get('content-type') || '';\n        const isJson = contentType.includes('application/json');\n        const payload = isJson ? await response.json() : await response.text();\n\n        if (!response.ok) {\n          const message = (payload && (payload.message || payload.error)) || response.statusText;\n          const error = new FluxsaveError(message, response.status, payload);\n          if (this.shouldRetry(response.status, attempt)) {\n            attempt += 1;\n            await this.sleep(this.retry.retryDelayMs);\n            continue;\n          }\n          throw error;\n        }\n\n        return payload as T;\n      } catch (error: any) {\n        if (error?.name === 'AbortError') {\n          if (this.shouldRetry(0, attempt)) {\n            attempt += 1;\n            await this.sleep(this.retry.retryDelayMs);\n            continue;\n          }\n          throw new FluxsaveError('Request timed out', 408);\n        }\n\n        if (this.shouldRetry(0, attempt)) {\n          attempt += 1;\n          await this.sleep(this.retry.retryDelayMs);\n          continue;\n        }\n        throw error;\n      } finally {\n        clearTimeout(timeoutId);\n      }\n    }\n  }\n\n  private shouldRetry(status: number, attempt: number) {\n    if (attempt >= this.retry.retries) {\n      return false;\n    }\n    if (status === 0) {\n      return true;\n    }\n    return this.retry.retryOn.includes(status);\n  }\n\n  private async sleep(delayMs: number) {\n    await new Promise((resolve) => setTimeout(resolve, delayMs));\n  }\n}\n\nconst toArrayBuffer = (buffer: ArrayBuffer | Uint8Array) => {\n  if (buffer instanceof Uint8Array) {\n    const copy = new Uint8Array(buffer.byteLength);\n    copy.set(buffer);\n    return copy.buffer;\n  }\n  return buffer;\n};\n\nexport const fileFromBuffer = (\n  buffer: ArrayBuffer | Uint8Array,\n  filename: string,\n  type = 'application/octet-stream'\n) => {\n  const data = toArrayBuffer(buffer);\n  return new Blob([data], { type });\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,94 @@
+type ApiSuccess<T> = {
+    status: number;
+    message: string;
+    data: T;
+};
+type ApiError = {
+    status: number;
+    message: string;
+    data?: unknown;
+};
+type FileRecord = {
+    _id?: string;
+    fileId?: string;
+    cloudId?: string;
+    filename: string;
+    originalFilename?: string;
+    url: string;
+    size: number;
+    mimeType: string;
+    width?: number;
+    height?: number;
+    createdAt?: string;
+    updatedAt?: string;
+};
+type Metrics = {
+    totalFiles: number;
+    totalStorageBytes: number;
+    averageFileSize: number;
+    storageLimitBytes: number;
+    storageRemainingBytes: number;
+    storageUsedPercent: number;
+    uploadsLast7Days: number;
+    latestUploadAt?: string | null;
+    byMimeType: Record<string, number>;
+};
+type FetchLike = typeof fetch;
+type RetryOptions = {
+    retries: number;
+    retryDelayMs?: number;
+    retryOn?: number[];
+};
+type FluxsaveClientOptions = {
+    baseUrl: string;
+    apiKey?: string;
+    apiSecret?: string;
+    fetchImpl?: FetchLike;
+    timeoutMs?: number;
+    retry?: RetryOptions;
+};
+type UploadOptions = {
+    name?: string;
+    transform?: boolean;
+    filename?: string;
+};
+type TransformOptions = {
+    width?: number;
+    height?: number;
+    format?: string;
+    quality?: number | string;
+};
+declare class FluxsaveError extends Error {
+    status: number;
+    data?: unknown;
+    constructor(message: string, status: number, data?: unknown);
+}
+declare class FluxsaveClient {
+    private baseUrl;
+    private apiKey?;
+    private apiSecret?;
+    private fetchImpl;
+    private timeoutMs;
+    private retry;
+    constructor(options: FluxsaveClientOptions);
+    setAuth(apiKey: string, apiSecret: string): void;
+    setTimeout(timeoutMs: number): void;
+    setRetry(options: RetryOptions): void;
+    uploadFile(file: Blob, options?: UploadOptions): Promise<ApiSuccess<FileRecord>>;
+    uploadFiles(files: Array<{
+        file: Blob;
+        filename?: string;
+    }>, options?: UploadOptions): Promise<ApiSuccess<FileRecord[]>>;
+    listFiles(): Promise<ApiSuccess<FileRecord[]>>;
+    getFileMetadata(fileId: string): Promise<ApiSuccess<FileRecord>>;
+    updateFile(fileId: string, file: Blob, options?: UploadOptions): Promise<ApiSuccess<FileRecord>>;
+    deleteFile(fileId: string): Promise<ApiSuccess<null>>;
+    getMetrics(): Promise<ApiSuccess<Metrics>>;
+    buildFileUrl(fileId: string, options?: TransformOptions): string;
+    private request;
+    private shouldRetry;
+    private sleep;
+}
+declare const fileFromBuffer: (buffer: ArrayBuffer | Uint8Array, filename: string, type?: string) => Blob;
+
+export { type ApiError, type ApiSuccess, type FetchLike, type FileRecord, FluxsaveClient, type FluxsaveClientOptions, FluxsaveError, type Metrics, type RetryOptions, type TransformOptions, type UploadOptions, fileFromBuffer };

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+type ApiSuccess<T> = {
+    status: number;
+    message: string;
+    data: T;
+};
+type ApiError = {
+    status: number;
+    message: string;
+    data?: unknown;
+};
+type FileRecord = {
+    _id?: string;
+    fileId?: string;
+    cloudId?: string;
+    filename: string;
+    originalFilename?: string;
+    url: string;
+    size: number;
+    mimeType: string;
+    width?: number;
+    height?: number;
+    createdAt?: string;
+    updatedAt?: string;
+};
+type Metrics = {
+    totalFiles: number;
+    totalStorageBytes: number;
+    averageFileSize: number;
+    storageLimitBytes: number;
+    storageRemainingBytes: number;
+    storageUsedPercent: number;
+    uploadsLast7Days: number;
+    latestUploadAt?: string | null;
+    byMimeType: Record<string, number>;
+};
+type FetchLike = typeof fetch;
+type RetryOptions = {
+    retries: number;
+    retryDelayMs?: number;
+    retryOn?: number[];
+};
+type FluxsaveClientOptions = {
+    baseUrl: string;
+    apiKey?: string;
+    apiSecret?: string;
+    fetchImpl?: FetchLike;
+    timeoutMs?: number;
+    retry?: RetryOptions;
+};
+type UploadOptions = {
+    name?: string;
+    transform?: boolean;
+    filename?: string;
+};
+type TransformOptions = {
+    width?: number;
+    height?: number;
+    format?: string;
+    quality?: number | string;
+};
+declare class FluxsaveError extends Error {
+    status: number;
+    data?: unknown;
+    constructor(message: string, status: number, data?: unknown);
+}
+declare class FluxsaveClient {
+    private baseUrl;
+    private apiKey?;
+    private apiSecret?;
+    private fetchImpl;
+    private timeoutMs;
+    private retry;
+    constructor(options: FluxsaveClientOptions);
+    setAuth(apiKey: string, apiSecret: string): void;
+    setTimeout(timeoutMs: number): void;
+    setRetry(options: RetryOptions): void;
+    uploadFile(file: Blob, options?: UploadOptions): Promise<ApiSuccess<FileRecord>>;
+    uploadFiles(files: Array<{
+        file: Blob;
+        filename?: string;
+    }>, options?: UploadOptions): Promise<ApiSuccess<FileRecord[]>>;
+    listFiles(): Promise<ApiSuccess<FileRecord[]>>;
+    getFileMetadata(fileId: string): Promise<ApiSuccess<FileRecord>>;
+    updateFile(fileId: string, file: Blob, options?: UploadOptions): Promise<ApiSuccess<FileRecord>>;
+    deleteFile(fileId: string): Promise<ApiSuccess<null>>;
+    getMetrics(): Promise<ApiSuccess<Metrics>>;
+    buildFileUrl(fileId: string, options?: TransformOptions): string;
+    private request;
+    private shouldRetry;
+    private sleep;
+}
+declare const fileFromBuffer: (buffer: ArrayBuffer | Uint8Array, filename: string, type?: string) => Blob;
+
+export { type ApiError, type ApiSuccess, type FetchLike, type FileRecord, FluxsaveClient, type FluxsaveClientOptions, FluxsaveError, type Metrics, type RetryOptions, type TransformOptions, type UploadOptions, fileFromBuffer };

package/dist/index.js

@@ -0,0 +1,190 @@
+// src/index.ts
+var FluxsaveError = class extends Error {
+  constructor(message, status, data) {
+    super(message);
+    this.name = "FluxsaveError";
+    this.status = status;
+    this.data = data;
+  }
+};
+var FluxsaveClient = class {
+  constructor(options) {
+    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.apiSecret = options.apiSecret;
+    this.fetchImpl = options.fetchImpl ?? fetch;
+    this.timeoutMs = options.timeoutMs ?? 3e4;
+    this.retry = {
+      retries: options.retry?.retries ?? 2,
+      retryDelayMs: options.retry?.retryDelayMs ?? 400,
+      retryOn: options.retry?.retryOn ?? [429, 500, 502, 503, 504]
+    };
+  }
+  setAuth(apiKey, apiSecret) {
+    this.apiKey = apiKey;
+    this.apiSecret = apiSecret;
+  }
+  setTimeout(timeoutMs) {
+    this.timeoutMs = timeoutMs;
+  }
+  setRetry(options) {
+    this.retry = {
+      retries: options.retries,
+      retryDelayMs: options.retryDelayMs ?? this.retry.retryDelayMs,
+      retryOn: options.retryOn ?? this.retry.retryOn
+    };
+  }
+  async uploadFile(file, options = {}) {
+    const form = new FormData();
+    form.append("file", file, options.filename || "file");
+    if (options.name) {
+      form.append("name", options.name);
+    }
+    if (options.transform !== void 0) {
+      form.append("transform", String(options.transform));
+    }
+    return this.request("/api/v1/files/upload", {
+      method: "POST",
+      body: form
+    });
+  }
+  async uploadFiles(files, options = {}) {
+    const form = new FormData();
+    files.forEach((item) => {
+      form.append("files", item.file, item.filename || "file");
+    });
+    if (options.name) {
+      form.append("name", options.name);
+    }
+    if (options.transform !== void 0) {
+      form.append("transform", String(options.transform));
+    }
+    return this.request("/api/v1/files/upload", {
+      method: "POST",
+      body: form
+    });
+  }
+  async listFiles() {
+    return this.request("/api/v1/files", {
+      method: "GET"
+    });
+  }
+  async getFileMetadata(fileId) {
+    return this.request(`/api/v1/files/metadata/${fileId}`, {
+      method: "GET"
+    });
+  }
+  async updateFile(fileId, file, options = {}) {
+    const form = new FormData();
+    form.append("file", file, options.filename || "file");
+    if (options.name) {
+      form.append("name", options.name);
+    }
+    if (options.transform !== void 0) {
+      form.append("transform", String(options.transform));
+    }
+    return this.request(`/api/v1/files/${fileId}`, {
+      method: "PUT",
+      body: form
+    });
+  }
+  async deleteFile(fileId) {
+    return this.request(`/api/v1/files/${fileId}`, {
+      method: "DELETE"
+    });
+  }
+  async getMetrics() {
+    return this.request("/api/v1/metrics", {
+      method: "GET"
+    });
+  }
+  buildFileUrl(fileId, options = {}) {
+    const url = new URL(`${this.baseUrl}/api/v1/files/${fileId}`);
+    if (options.width) url.searchParams.set("width", String(options.width));
+    if (options.height) url.searchParams.set("height", String(options.height));
+    if (options.format) url.searchParams.set("format", options.format);
+    if (options.quality !== void 0) url.searchParams.set("quality", String(options.quality));
+    return url.toString();
+  }
+  async request(path, init) {
+    if (!this.apiKey || !this.apiSecret) {
+      throw new FluxsaveError("API key and secret are required", 401);
+    }
+    const headers = new Headers(init.headers || {});
+    headers.set("x-api-key", this.apiKey);
+    headers.set("x-api-secret", this.apiSecret);
+    let attempt = 0;
+    while (true) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+      try {
+        const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+          ...init,
+          headers,
+          signal: controller.signal
+        });
+        const contentType = response.headers.get("content-type") || "";
+        const isJson = contentType.includes("application/json");
+        const payload = isJson ? await response.json() : await response.text();
+        if (!response.ok) {
+          const message = payload && (payload.message || payload.error) || response.statusText;
+          const error = new FluxsaveError(message, response.status, payload);
+          if (this.shouldRetry(response.status, attempt)) {
+            attempt += 1;
+            await this.sleep(this.retry.retryDelayMs);
+            continue;
+          }
+          throw error;
+        }
+        return payload;
+      } catch (error) {
+        if (error?.name === "AbortError") {
+          if (this.shouldRetry(0, attempt)) {
+            attempt += 1;
+            await this.sleep(this.retry.retryDelayMs);
+            continue;
+          }
+          throw new FluxsaveError("Request timed out", 408);
+        }
+        if (this.shouldRetry(0, attempt)) {
+          attempt += 1;
+          await this.sleep(this.retry.retryDelayMs);
+          continue;
+        }
+        throw error;
+      } finally {
+        clearTimeout(timeoutId);
+      }
+    }
+  }
+  shouldRetry(status, attempt) {
+    if (attempt >= this.retry.retries) {
+      return false;
+    }
+    if (status === 0) {
+      return true;
+    }
+    return this.retry.retryOn.includes(status);
+  }
+  async sleep(delayMs) {
+    await new Promise((resolve) => setTimeout(resolve, delayMs));
+  }
+};
+var toArrayBuffer = (buffer) => {
+  if (buffer instanceof Uint8Array) {
+    const copy = new Uint8Array(buffer.byteLength);
+    copy.set(buffer);
+    return copy.buffer;
+  }
+  return buffer;
+};
+var fileFromBuffer = (buffer, filename, type = "application/octet-stream") => {
+  const data = toArrayBuffer(buffer);
+  return new Blob([data], { type });
+};
+export {
+  FluxsaveClient,
+  FluxsaveError,
+  fileFromBuffer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type ApiSuccess<T> = {\n  status: number;\n  message: string;\n  data: T;\n};\n\nexport type ApiError = {\n  status: number;\n  message: string;\n  data?: unknown;\n};\n\nexport type FileRecord = {\n  _id?: string;\n  fileId?: string;\n  cloudId?: string;\n  filename: string;\n  originalFilename?: string;\n  url: string;\n  size: number;\n  mimeType: string;\n  width?: number;\n  height?: number;\n  createdAt?: string;\n  updatedAt?: string;\n};\n\nexport type Metrics = {\n  totalFiles: number;\n  totalStorageBytes: number;\n  averageFileSize: number;\n  storageLimitBytes: number;\n  storageRemainingBytes: number;\n  storageUsedPercent: number;\n  uploadsLast7Days: number;\n  latestUploadAt?: string | null;\n  byMimeType: Record<string, number>;\n};\n\nexport type FetchLike = typeof fetch;\n\nexport type RetryOptions = {\n  retries: number;\n  retryDelayMs?: number;\n  retryOn?: number[];\n};\n\nexport type FluxsaveClientOptions = {\n  baseUrl: string;\n  apiKey?: string;\n  apiSecret?: string;\n  fetchImpl?: FetchLike;\n  timeoutMs?: number;\n  retry?: RetryOptions;\n};\n\nexport type UploadOptions = {\n  name?: string;\n  transform?: boolean;\n  filename?: string;\n};\n\nexport type TransformOptions = {\n  width?: number;\n  height?: number;\n  format?: string;\n  quality?: number | string;\n};\n\nexport class FluxsaveError extends Error {\n  status: number;\n  data?: unknown;\n\n  constructor(message: string, status: number, data?: unknown) {\n    super(message);\n    this.name = 'FluxsaveError';\n    this.status = status;\n    this.data = data;\n  }\n}\n\nexport class FluxsaveClient {\n  private baseUrl: string;\n  private apiKey?: string;\n  private apiSecret?: string;\n  private fetchImpl: FetchLike;\n  private timeoutMs: number;\n  private retry: Required<RetryOptions>;\n\n  constructor(options: FluxsaveClientOptions) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\n    this.apiKey = options.apiKey;\n    this.apiSecret = options.apiSecret;\n    this.fetchImpl = options.fetchImpl ?? fetch;\n    this.timeoutMs = options.timeoutMs ?? 30000;\n    this.retry = {\n      retries: options.retry?.retries ?? 2,\n      retryDelayMs: options.retry?.retryDelayMs ?? 400,\n      retryOn: options.retry?.retryOn ?? [429, 500, 502, 503, 504],\n    };\n  }\n\n  setAuth(apiKey: string, apiSecret: string) {\n    this.apiKey = apiKey;\n    this.apiSecret = apiSecret;\n  }\n\n  setTimeout(timeoutMs: number) {\n    this.timeoutMs = timeoutMs;\n  }\n\n  setRetry(options: RetryOptions) {\n    this.retry = {\n      retries: options.retries,\n      retryDelayMs: options.retryDelayMs ?? this.retry.retryDelayMs,\n      retryOn: options.retryOn ?? this.retry.retryOn,\n    };\n  }\n\n  async uploadFile(file: Blob, options: UploadOptions = {}): Promise<ApiSuccess<FileRecord>> {\n    const form = new FormData();\n    form.append('file', file, options.filename || 'file');\n    if (options.name) {\n      form.append('name', options.name);\n    }\n    if (options.transform !== undefined) {\n      form.append('transform', String(options.transform));\n    }\n\n    return this.request<ApiSuccess<FileRecord>>('/api/v1/files/upload', {\n      method: 'POST',\n      body: form,\n    });\n  }\n\n  async uploadFiles(\n    files: Array<{ file: Blob; filename?: string }>,\n    options: UploadOptions = {}\n  ): Promise<ApiSuccess<FileRecord[]>> {\n    const form = new FormData();\n    files.forEach((item) => {\n      form.append('files', item.file, item.filename || 'file');\n    });\n    if (options.name) {\n      form.append('name', options.name);\n    }\n    if (options.transform !== undefined) {\n      form.append('transform', String(options.transform));\n    }\n\n    return this.request<ApiSuccess<FileRecord[]>>('/api/v1/files/upload', {\n      method: 'POST',\n      body: form,\n    });\n  }\n\n  async listFiles(): Promise<ApiSuccess<FileRecord[]>> {\n    return this.request<ApiSuccess<FileRecord[]>>('/api/v1/files', {\n      method: 'GET',\n    });\n  }\n\n  async getFileMetadata(fileId: string): Promise<ApiSuccess<FileRecord>> {\n    return this.request<ApiSuccess<FileRecord>>(`/api/v1/files/metadata/${fileId}`, {\n      method: 'GET',\n    });\n  }\n\n  async updateFile(fileId: string, file: Blob, options: UploadOptions = {}): Promise<ApiSuccess<FileRecord>> {\n    const form = new FormData();\n    form.append('file', file, options.filename || 'file');\n    if (options.name) {\n      form.append('name', options.name);\n    }\n    if (options.transform !== undefined) {\n      form.append('transform', String(options.transform));\n    }\n\n    return this.request<ApiSuccess<FileRecord>>(`/api/v1/files/${fileId}`, {\n      method: 'PUT',\n      body: form,\n    });\n  }\n\n  async deleteFile(fileId: string): Promise<ApiSuccess<null>> {\n    return this.request<ApiSuccess<null>>(`/api/v1/files/${fileId}`, {\n      method: 'DELETE',\n    });\n  }\n\n  async getMetrics(): Promise<ApiSuccess<Metrics>> {\n    return this.request<ApiSuccess<Metrics>>('/api/v1/metrics', {\n      method: 'GET',\n    });\n  }\n\n  buildFileUrl(fileId: string, options: TransformOptions = {}) {\n    const url = new URL(`${this.baseUrl}/api/v1/files/${fileId}`);\n    if (options.width) url.searchParams.set('width', String(options.width));\n    if (options.height) url.searchParams.set('height', String(options.height));\n    if (options.format) url.searchParams.set('format', options.format);\n    if (options.quality !== undefined) url.searchParams.set('quality', String(options.quality));\n    return url.toString();\n  }\n\n  private async request<T>(path: string, init: RequestInit): Promise<T> {\n    if (!this.apiKey || !this.apiSecret) {\n      throw new FluxsaveError('API key and secret are required', 401);\n    }\n\n    const headers = new Headers(init.headers || {});\n    headers.set('x-api-key', this.apiKey);\n    headers.set('x-api-secret', this.apiSecret);\n\n    let attempt = 0;\n    while (true) {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);\n      try {\n        const response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n          ...init,\n          headers,\n          signal: controller.signal,\n        });\n\n        const contentType = response.headers.get('content-type') || '';\n        const isJson = contentType.includes('application/json');\n        const payload = isJson ? await response.json() : await response.text();\n\n        if (!response.ok) {\n          const message = (payload && (payload.message || payload.error)) || response.statusText;\n          const error = new FluxsaveError(message, response.status, payload);\n          if (this.shouldRetry(response.status, attempt)) {\n            attempt += 1;\n            await this.sleep(this.retry.retryDelayMs);\n            continue;\n          }\n          throw error;\n        }\n\n        return payload as T;\n      } catch (error: any) {\n        if (error?.name === 'AbortError') {\n          if (this.shouldRetry(0, attempt)) {\n            attempt += 1;\n            await this.sleep(this.retry.retryDelayMs);\n            continue;\n          }\n          throw new FluxsaveError('Request timed out', 408);\n        }\n\n        if (this.shouldRetry(0, attempt)) {\n          attempt += 1;\n          await this.sleep(this.retry.retryDelayMs);\n          continue;\n        }\n        throw error;\n      } finally {\n        clearTimeout(timeoutId);\n      }\n    }\n  }\n\n  private shouldRetry(status: number, attempt: number) {\n    if (attempt >= this.retry.retries) {\n      return false;\n    }\n    if (status === 0) {\n      return true;\n    }\n    return this.retry.retryOn.includes(status);\n  }\n\n  private async sleep(delayMs: number) {\n    await new Promise((resolve) => setTimeout(resolve, delayMs));\n  }\n}\n\nconst toArrayBuffer = (buffer: ArrayBuffer | Uint8Array) => {\n  if (buffer instanceof Uint8Array) {\n    const copy = new Uint8Array(buffer.byteLength);\n    copy.set(buffer);\n    return copy.buffer;\n  }\n  return buffer;\n};\n\nexport const fileFromBuffer = (\n  buffer: ArrayBuffer | Uint8Array,\n  filename: string,\n  type = 'application/octet-stream'\n) => {\n  const data = toArrayBuffer(buffer);\n  return new Blob([data], { type });\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@fluxsave/sdk",
+  "version": "0.1.0",
+  "description": "FluxSave SDK for API key uploads and file management",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "fluxsave",
+    "sdk",
+    "storage",
+    "upload"
+  ],
+  "author": "FluxSave",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.1.0",
+    "typescript": "^5.9.2"
+  }
+}