@aurabase/aurabase-js 0.3.1 → 0.4.1

package/packages/storage/dist/index.js

@@ -1,329 +0,0 @@
-import { BaseService, AuraError, isTokenExpired, refreshOnce } from '@aurabase/core';
-
-// src/StorageService.ts
-async function runDownload(fn, extract) {
-  let res;
-  try {
-    res = await fn();
-  } catch (err) {
-    return {
-      data: null,
-      error: new AuraError(0, { error: { code: "network_error", message: err instanceof Error ? err.message : "Download failed" } })
-    };
-  }
-  if (!res.ok) return { data: null, error: new AuraError(res.status) };
-  return { data: await extract(res), error: null };
-}
-var BlobDownloadBuilder = class {
-  constructor(_fn) {
-    this._fn = _fn;
-  }
-  _fn;
-  _promise = null;
-  asStream() {
-    return new StreamDownloadBuilder(this._fn);
-  }
-  _run() {
-    if (!this._promise) this._promise = runDownload(this._fn, (r) => r.blob());
-    return this._promise;
-  }
-  then(onfulfilled, onrejected) {
-    return this._run().then(onfulfilled, onrejected);
-  }
-};
-var StreamDownloadBuilder = class {
-  constructor(_fn) {
-    this._fn = _fn;
-  }
-  _fn;
-  _promise = null;
-  _run() {
-    if (!this._promise) {
-      this._promise = runDownload(this._fn, (r) => r.body);
-    }
-    return this._promise;
-  }
-  then(onfulfilled, onrejected) {
-    return this._run().then(onfulfilled, onrejected);
-  }
-};
-function encodeObjectPath(path) {
-  const trimmed = path.replace(/^\/+/, "");
-  const segments = trimmed.split("/");
-  for (const seg of segments) {
-    if (seg === "..") {
-      throw new AuraError(0, {
-        error: {
-          code: "invalid_path",
-          message: 'Path traversal ("..") is not allowed in storage object paths'
-        }
-      });
-    }
-  }
-  return segments.map((s) => encodeURIComponent(s)).join("/");
-}
-
-// src/transform.ts
-function renderTransformParams(t) {
-  const p = new URLSearchParams();
-  if (Number.isFinite(t.width)) p.set("width", String(Math.max(1, Math.floor(t.width))));
-  if (Number.isFinite(t.height)) p.set("height", String(Math.max(1, Math.floor(t.height))));
-  if (t.resize) p.set("fit", t.resize);
-  if (Number.isFinite(t.quality)) p.set("quality", String(Math.min(100, Math.max(20, Math.floor(t.quality)))));
-  if (t.format && t.format !== "origin") p.set("format", t.format);
-  return p;
-}
-
-// src/StorageService.ts
-var StorageService = class extends BaseService {
-  constructor(client) {
-    super(client);
-  }
-  get prefix() {
-    return `/v1/storage/${this.client.projectId}`;
-  }
-  // -- Buckets ----------------------------------------------------------------
-  async listBuckets() {
-    return this.request("GET", `${this.prefix}/buckets`);
-  }
-  async getBucket(id) {
-    return this.request("GET", `${this.prefix}/buckets/${id}`);
-  }
-  async createBucket(name, options) {
-    return this.request("POST", `${this.prefix}/buckets`, {
-      name,
-      public: options?.public ?? false,
-      file_size_limit: options?.fileSizeLimit,
-      allowed_mime_types: options?.allowedMimeTypes
-    });
-  }
-  /**
-   * Met à jour un bucket existant (mise à jour PARTIELLE : seuls les champs
-   * fournis sont envoyés). Mapping identique à `createBucket`
-   * (`public`/`file_size_limit`/`allowed_mime_types`).
-   *
-   * Backend route: PATCH /v1/storage/{project_id}/buckets/{id}
-   */
-  async updateBucket(id, options) {
-    const body = {};
-    if (options?.public !== void 0) body.public = options.public;
-    if (options?.fileSizeLimit !== void 0) body.file_size_limit = options.fileSizeLimit;
-    if (options?.allowedMimeTypes !== void 0) body.allowed_mime_types = options.allowedMimeTypes;
-    return this.request("PATCH", `${this.prefix}/buckets/${id}`, body);
-  }
-  async deleteBucket(id) {
-    return this.request("DELETE", `${this.prefix}/buckets/${id}`);
-  }
-  // -- Objects ----------------------------------------------------------------
-  /**
-   * Upload a file to a bucket.
-   *
-   * Le serveur génère une clé unique `<uuid>.<ext>` (relative au bucket).
-   * Réutilisez directement `data.key` pour download(), remove(), copy(), etc.
-   *
-   * @example
-   * const { data } = await client.storage.upload('avatars', 'photo.png', file)
-   * await client.storage.download('avatars', data!.key)  // fonctionne directement
-   *
-   * Backend route: POST /v1/storage/{project_id}/{bucket}
-   */
-  async upload(bucketId, path, file, options) {
-    const formData = new FormData();
-    const blob = file instanceof Blob ? file : new Blob([file], { type: options?.contentType ?? "application/octet-stream" });
-    formData.append("file", blob, path);
-    if (options?.upsert) formData.append("upsert", "true");
-    if (options?.metadata) {
-      for (const [k, v] of Object.entries(options.metadata)) formData.append(k, v);
-    }
-    return this.request("POST", `${this.prefix}/${bucketId}`, formData);
-  }
-  /**
-   * Download paresseux d'un fichier. Renvoie un builder (Blob par défaut, `.asStream()` pour
-   * le flux) ; la requête part à l'`await`. Refresh proactif du token avant la requête.
-   * `options?.transform` (image) : appende `renderTransformParams(...)` à l'URL — figée à
-   * l'appel, le builder reste inchangé.
-   * Backend route: GET /v1/storage/{project_id}/{bucket}/{*key}
-   */
-  download(bucketId, path, options) {
-    let url = this.url(`${this.prefix}/${encodeURIComponent(bucketId)}/${encodeObjectPath(path)}`);
-    if (options?.transform) {
-      const qs = renderTransformParams(options.transform).toString();
-      if (qs) url = `${url}?${qs}`;
-    }
-    const client = this.client;
-    const downloadFn = async () => {
-      const store = client.authStore;
-      if (store.token && store.refreshToken && isTokenExpired(store.token, 30)) {
-        await refreshOnce(client);
-      }
-      const headers = {};
-      if (store.token) headers["Authorization"] = `Bearer ${store.token}`;
-      if (client.apiKey) headers["apikey"] = client.apiKey;
-      return client.fetchFn(url, { headers });
-    };
-    return new BlobDownloadBuilder(downloadFn);
-  }
-  /**
-   * List files in a bucket.
-   *
-   * ⚠️ `offset` n'est PAS supporté par le backend (`ListQuery` ne connaît que
-   * `prefix`+`limit`) : le paramètre est accepté pour compatibilité ascendante
-   * mais IGNORÉ (jamais envoyé au serveur). Pour restreindre les résultats,
-   * utilisez `prefix`. La vraie pagination (continuation token) relève du backend.
-   *
-   * Backend route: GET /v1/storage/{project_id}/{bucket}
-   */
-  async list(bucketId, options) {
-    const params = new URLSearchParams();
-    if (options?.prefix) params.set("prefix", options.prefix);
-    if (options?.limit !== void 0) params.set("limit", String(options.limit));
-    const qs = params.toString();
-    const sep = qs ? "?" : "";
-    return this.request("GET", `${this.prefix}/${bucketId}${sep}${qs}`);
-  }
-  /**
-   * Delete one or more files from a bucket.
-   * Backend route: DELETE /v1/storage/{project_id}/{bucket}/{*key}
-   * Note: for single file deletion, paths[0] is used. Multi-delete is done in sequence.
-   */
-  async remove(bucketId, paths) {
-    let keys;
-    try {
-      keys = paths.map((p) => encodeObjectPath(p));
-    } catch (e) {
-      return { data: null, error: e };
-    }
-    const b = encodeURIComponent(bucketId);
-    if (keys.length === 1) {
-      return this.request("DELETE", `${this.prefix}/${b}/${keys[0]}`);
-    }
-    const results = await Promise.all(
-      keys.map((k) => this.request("DELETE", `${this.prefix}/${b}/${k}`))
-    );
-    const failed = results.find((r) => r.error);
-    if (failed) return failed;
-    return { data: null, error: null };
-  }
-  /**
-   * Copy a file within a bucket.
-   *
-   * `fromPath`/`toPath` sont relatifs au bucket (cohérent avec `download`/
-   * `remove`/`upload`) — le SDK les préfixe par `bucketId` pour produire les
-   * clés MinIO complètes attendues par le backend.
-   *
-   * Backend route: POST /v1/storage/{project_id}/{bucket}/copy
-   */
-  async copy(bucketId, fromPath, toPath) {
-    return this.request("POST", `${this.prefix}/${bucketId}/copy`, {
-      src_key: `${bucketId}/${fromPath}`,
-      dst_key: `${bucketId}/${toPath}`
-    });
-  }
-  /**
-   * Move/rename a file within a bucket.
-   *
-   * `fromPath`/`toPath` sont relatifs au bucket (cohérent avec `download`/
-   * `remove`/`upload`) — le SDK les préfixe par `bucketId` pour produire les
-   * clés MinIO complètes attendues par le backend.
-   *
-   * Backend route: POST /v1/storage/{project_id}/{bucket}/move
-   */
-  async move(bucketId, fromPath, toPath) {
-    return this.request("POST", `${this.prefix}/${bucketId}/move`, {
-      src_key: `${bucketId}/${fromPath}`,
-      dst_key: `${bucketId}/${toPath}`
-    });
-  }
-  /**
-   * Get file metadata.
-   * Backend route: GET /v1/storage/{project_id}/{bucket}/meta/{*key}
-   */
-  async getMetadata(bucketId, path) {
-    let key;
-    try {
-      key = encodeObjectPath(path);
-    } catch (e) {
-      return { data: null, error: e };
-    }
-    return this.request("GET", `${this.prefix}/${encodeURIComponent(bucketId)}/meta/${key}`);
-  }
-  /**
-   * Generate a signed (temporary) download URL.
-   *
-   * `options?.transform` (image) : dérisqué en réel (stack live) — les params transform
-   * sont HORS HMAC (le backend ne les couvre pas dans la signature), donc on les appende
-   * à l'URL signée APRÈS réception de `{ url, expires_in }`, sans toucher à la requête
-   * `signed-url` elle-même.
-   * Backend route: GET /v1/storage/{project_id}/{bucket}/signed-url?key=...&ttl_secs=...
-   */
-  async createSignedUrl(bucketId, path, expiresInSeconds = 3600, options) {
-    const params = new URLSearchParams({ key: path, ttl_secs: String(expiresInSeconds) });
-    const res = await this.request(
-      "GET",
-      `${this.prefix}/${bucketId}/signed-url?${params.toString()}`
-    );
-    if (res.data && options?.transform) {
-      const qs = renderTransformParams(options.transform).toString();
-      if (qs) {
-        const sep = res.data.url.includes("?") ? "&" : "?";
-        res.data = { ...res.data, url: `${res.data.url}${sep}${qs}` };
-      }
-    }
-    return res;
-  }
-  /**
-   * Génère plusieurs URLs signées en une passe (batch).
-   *
-   * Il n'existe pas d'endpoint batch côté backend : l'implémentation fait un
-   * fan-out `Promise.all` sur `createSignedUrl` (même patron que `remove()`),
-   * RÉSILIENT PAR-ITEM — chaque entrée est soit `{ path, url, expires_in }`
-   * (succès), soit `{ path, error }` (échec), sans faire échouer les autres.
-   *
-   * @example
-   * const { data } = await client.storage.createSignedUrls('avatars', ['a.png', 'b.png'])
-   * data?.forEach((r) => 'url' in r ? use(r.url) : console.warn(r.path, r.error))
-   */
-  async createSignedUrls(bucketId, paths, expiresInSeconds = 3600, options) {
-    const results = await Promise.all(
-      paths.map(async (path) => {
-        const res = await this.createSignedUrl(bucketId, path, expiresInSeconds, options);
-        if (res.error || !res.data) {
-          return { path, error: res.error ?? new AuraError(0, { error: { code: "unknown", message: "No data" } }) };
-        }
-        return { path, url: res.data.url, expires_in: res.data.expires_in };
-      })
-    );
-    return { data: results, error: null };
-  }
-  /**
-   * Generate a signed upload URL (presigned POST/PUT).
-   * Backend route: GET /v1/storage/{project_id}/{bucket}/upload-url?key=...&ttl_secs=...
-   */
-  async createSignedUploadUrl(bucketId, path, expiresInSeconds = 3600) {
-    const params = new URLSearchParams({ key: path, ttl_secs: String(expiresInSeconds) });
-    return this.request("GET", `${this.prefix}/${bucketId}/upload-url?${params.toString()}`);
-  }
-  /**
-   * Construit une URL vers un fichier d'un bucket.
-   *
-   * ⚠️ Cette URL N'EST PAS accessible sans authentification : le gateway exige
-   * une clé API (`apikey`/`x-api-key`) sur toutes les routes storage, y compris
-   * pour les buckets créés avec `public: true` (ce flag n'est actuellement pas
-   * vérifié côté gateway — une requête non authentifiée renvoie 401). Pour
-   * partager un fichier sans authentification, utilisez `createSignedUrl()`,
-   * qui génère une URL signée HMAC vérifiée côté serveur sans clé API.
-   *
-   * `options?.transform` (image) : appende `renderTransformParams(...)` en query string.
-   * Backend route: GET /v1/storage/{project_id}/{bucket}/{*key} (clé API requise)
-   */
-  getPublicUrl(bucketId, path, options) {
-    const base = this.url(`${this.prefix}/${encodeURIComponent(bucketId)}/${encodeObjectPath(path)}`);
-    if (options?.transform) {
-      const qs = renderTransformParams(options.transform).toString();
-      if (qs) return `${base}?${qs}`;
-    }
-    return base;
-  }
-};
-
-export { BlobDownloadBuilder, StorageService, StreamDownloadBuilder };

package/packages/storage/package.json

@@ -1,60 +0,0 @@
-{
-  "name": "@aurabase/storage",
-  "version": "0.3.0",
-  "description": "Service de stockage objet du SDK Aurabase (buckets, upload/download, URLs signées)",
-  "type": "module",
-  "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
-    }
-  },
-  "sideEffects": false,
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "license": "MIT",
-  "author": "Aurabase",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/daylami555/aurabase.git",
-    "directory": "aurabase-js/packages/storage"
-  },
-  "homepage": "https://github.com/daylami555/aurabase/tree/main/aurabase-js/packages/storage#readme",
-  "bugs": {
-    "url": "https://github.com/daylami555/aurabase/issues"
-  },
-  "keywords": [
-    "aurabase",
-    "baas",
-    "sdk",
-    "storage"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run --passWithNoTests",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@aurabase/core": "workspace:*"
-  },
-  "devDependencies": {
-    "tsup": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
-  }
-}