hydrousdb 2.0.3 → 3.0.0

package/dist/index.mjs

@@ -1,1038 +0,0 @@
-// src/utils/errors.ts
-var HydrousDBError = class extends Error {
-  constructor(message, code = "SDK_ERROR", status) {
-    super(message);
-    this.name = "HydrousDBError";
-    this.code = code;
-    this.status = status;
-  }
-};
-function toHydrousError(err) {
-  if (err instanceof HydrousDBError) {
-    return { message: err.message, code: err.code, status: err.status };
-  }
-  if (err instanceof Error) {
-    return { message: err.message, code: "UNKNOWN_ERROR" };
-  }
-  return { message: String(err), code: "UNKNOWN_ERROR" };
-}
-function isHydrousError(err) {
-  return err instanceof HydrousDBError;
-}
-
-// src/utils/http.ts
-async function parseResponse(res) {
-  let body;
-  try {
-    body = await res.json();
-  } catch (e) {
-    if (!res.ok) throw new HydrousDBError(`HTTP ${res.status}`, "HTTP_ERROR", res.status);
-    return void 0;
-  }
-  if (!res.ok) {
-    const e = body;
-    throw new HydrousDBError(
-      e.error || e.message || `HTTP ${res.status}`,
-      e.code || "HTTP_ERROR",
-      res.status
-    );
-  }
-  return body;
-}
-function buildUrl(base, path, params) {
-  const url = new URL(path, base.endsWith("/") ? base : base + "/");
-  if (params) {
-    for (const [k, v] of Object.entries(params)) {
-      if (v !== void 0 && v !== null) url.searchParams.set(k, String(v));
-    }
-  }
-  return url.toString();
-}
-function mergeHeaders(a, b) {
-  return { ...a, ...b };
-}
-async function readSSEStream(response, onEvent) {
-  if (!response.body) return;
-  const reader = response.body.getReader();
-  const decoder = new TextDecoder();
-  let buf = "";
-  const flush = (chunk) => {
-    var _a;
-    buf += chunk;
-    const blocks = buf.split("\n\n");
-    buf = (_a = blocks.pop()) != null ? _a : "";
-    for (const block of blocks) {
-      if (!block.trim()) continue;
-      let eventType = "message";
-      let dataLine = null;
-      for (const line of block.split("\n")) {
-        if (line.startsWith("event:")) eventType = line.slice(6).trim();
-        if (line.startsWith("data:")) dataLine = line.slice(5).trim();
-      }
-      if (dataLine === null) continue;
-      try {
-        onEvent(eventType, JSON.parse(dataLine));
-      } catch (e) {
-      }
-    }
-  };
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    flush(decoder.decode(value, { stream: true }));
-  }
-  if (buf.trim()) flush("");
-}
-function parseSSEText(text, onEvent) {
-  const blocks = text.split("\n\n");
-  for (const block of blocks) {
-    if (!block.trim()) continue;
-    let eventType = "message";
-    let dataLine = null;
-    for (const line of block.split("\n")) {
-      if (line.startsWith("event:")) eventType = line.slice(6).trim();
-      if (line.startsWith("data:")) dataLine = line.slice(5).trim();
-    }
-    if (dataLine === null) continue;
-    try {
-      onEvent(eventType, JSON.parse(dataLine));
-    } catch (e) {
-    }
-  }
-}
-function xhrUpload(url, body, headers, onProgress) {
-  return new Promise((resolve, reject) => {
-    const xhr = new XMLHttpRequest();
-    xhr.open("POST", url);
-    for (const [k, v] of Object.entries(headers)) xhr.setRequestHeader(k, v);
-    xhr.responseType = "text";
-    if (onProgress) {
-      xhr.upload.onprogress = (e) => {
-        if (e.lengthComputable) onProgress(e.loaded, e.total);
-      };
-    }
-    xhr.onload = () => {
-      var _a;
-      if (xhr.status >= 200 && xhr.status < 300) {
-        resolve(xhr.responseText);
-      } else {
-        try {
-          const d = JSON.parse(xhr.responseText);
-          reject(new HydrousDBError((_a = d.error) != null ? _a : `HTTP ${xhr.status}`, "HTTP_ERROR", xhr.status));
-        } catch (e) {
-          reject(new HydrousDBError(`HTTP ${xhr.status}`, "HTTP_ERROR", xhr.status));
-        }
-      }
-    };
-    xhr.onerror = () => reject(new HydrousDBError("Network error", "NETWORK_ERROR"));
-    xhr.onabort = () => reject(new HydrousDBError("Upload aborted", "UPLOAD_ABORTED"));
-    xhr.ontimeout = () => reject(new HydrousDBError("Upload timed out", "UPLOAD_TIMEOUT"));
-    xhr.send(body);
-  });
-}
-
-// src/auth/client.ts
-var AuthClient = class {
-  constructor(config) {
-    this.session = null;
-    this.baseUrl = config.url;
-    this.headers = {
-      "Content-Type": "application/json",
-      "Authorization": `Bearer ${config.authKey}`
-    };
-  }
-  /** Create a new user account */
-  async signUp(options) {
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, "auth/signup"), {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify(options)
-      });
-      const json = await parseResponse(res);
-      this.session = json.data;
-      return { data: json.data, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Sign in with email and password */
-  async signIn(options) {
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, "auth/signin"), {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify(options)
-      });
-      const json = await parseResponse(res);
-      this.session = json.data;
-      return { data: json.data, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Sign out and invalidate the current session */
-  async signOut() {
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, "auth/signout"), {
-        method: "POST",
-        headers: mergeHeaders(this.headers, this._sessionHeader())
-      });
-      await parseResponse(res);
-      this.session = null;
-      return { data: void 0, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Get the currently authenticated user */
-  async getUser() {
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, "auth/user"), {
-        headers: mergeHeaders(this.headers, this._sessionHeader())
-      });
-      const json = await parseResponse(res);
-      return { data: json.data, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Refresh the access token using the stored refresh token */
-  async refreshSession() {
-    var _a;
-    if (!((_a = this.session) == null ? void 0 : _a.refreshToken)) {
-      return { data: null, error: { message: "No active session", code: "NO_SESSION" } };
-    }
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, "auth/refresh"), {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify({ refreshToken: this.session.refreshToken })
-      });
-      const json = await parseResponse(res);
-      this.session = json.data;
-      return { data: json.data, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Return the current in-memory session (may be null) */
-  getSession() {
-    return this.session;
-  }
-  _sessionHeader() {
-    var _a;
-    return ((_a = this.session) == null ? void 0 : _a.accessToken) ? { "X-Session-Token": this.session.accessToken } : {};
-  }
-};
-
-// src/utils/query.ts
-function serialiseQuery(opts = {}) {
-  var _a;
-  const params = {};
-  if (opts.limit !== void 0) params["limit"] = String(opts.limit);
-  if (opts.offset !== void 0) params["offset"] = String(opts.offset);
-  if (opts.select && opts.select.length > 0) params["select"] = opts.select.join(",");
-  if (opts.orderBy) {
-    params["orderBy"] = opts.orderBy.field;
-    params["direction"] = (_a = opts.orderBy.direction) != null ? _a : "asc";
-  }
-  const filters = opts.where ? Array.isArray(opts.where) ? opts.where : [opts.where] : [];
-  if (filters.length > 0) params["where"] = JSON.stringify(filters);
-  return params;
-}
-var eq = (field, value) => ({ field, operator: "eq", value });
-var neq = (field, value) => ({ field, operator: "neq", value });
-var gt = (field, value) => ({ field, operator: "gt", value });
-var lt = (field, value) => ({ field, operator: "lt", value });
-var gte = (field, value) => ({ field, operator: "gte", value });
-var lte = (field, value) => ({ field, operator: "lte", value });
-var inArray = (field, value) => ({ field, operator: "in", value });
-
-// src/records/client.ts
-var RecordsClient = class {
-  constructor(config) {
-    this.baseUrl = config.url;
-    this.headers = {
-      "Content-Type": "application/json",
-      "Authorization": `Bearer ${config.bucketSecurityKey}`
-    };
-  }
-  /** Query records from a collection */
-  async select(collection, options = {}) {
-    try {
-      const url = buildUrl(this.baseUrl, `records/${collection}`, serialiseQuery(options));
-      const res = await fetch(url, { headers: this.headers });
-      const json = await parseResponse(res);
-      return { data: json.data, count: json.count, error: null };
-    } catch (err) {
-      return { data: [], count: 0, error: toHydrousError(err) };
-    }
-  }
-  /** Fetch a single record by ID */
-  async get(collection, id) {
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, `records/${collection}/${id}`), { headers: this.headers });
-      const json = await parseResponse(res);
-      return { data: json.data, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Insert one or more records */
-  async insert(collection, payload) {
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, `records/${collection}`), {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify(payload)
-      });
-      const json = await parseResponse(res);
-      return { data: json.data, count: json.count, error: null };
-    } catch (err) {
-      return { data: [], count: 0, error: toHydrousError(err) };
-    }
-  }
-  /** Update a record by ID */
-  async update(collection, id, payload) {
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, `records/${collection}/${id}`), {
-        method: "PATCH",
-        headers: this.headers,
-        body: JSON.stringify(payload)
-      });
-      const json = await parseResponse(res);
-      return { data: json.data, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Delete a record by ID */
-  async delete(collection, id) {
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, `records/${collection}/${id}`), {
-        method: "DELETE",
-        headers: this.headers
-      });
-      await parseResponse(res);
-      return { data: void 0, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-};
-
-// src/analytics/client.ts
-var AnalyticsClient = class {
-  constructor(config) {
-    this.baseUrl = config.url;
-    this.headers = {
-      "Content-Type": "application/json",
-      "Authorization": `Bearer ${config.bucketSecurityKey}`
-    };
-  }
-  /** Track a single analytics event */
-  async track(options) {
-    var _a;
-    try {
-      const res = await fetch(buildUrl(this.baseUrl, "analytics/track"), {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify({ ...options, timestamp: (_a = options.timestamp) != null ? _a : Date.now() })
-      });
-      await parseResponse(res);
-      return { data: void 0, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Track many events in one request */
-  async trackBatch(events) {
-    try {
-      const stamped = events.map((e) => {
-        var _a;
-        return { ...e, timestamp: (_a = e.timestamp) != null ? _a : Date.now() };
-      });
-      const res = await fetch(buildUrl(this.baseUrl, "analytics/track/batch"), {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify({ events: stamped })
-      });
-      await parseResponse(res);
-      return { data: void 0, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Query recorded analytics events */
-  async query(options = {}) {
-    try {
-      const params = {};
-      if (options.event) params["event"] = options.event;
-      if (options.from) params["from"] = options.from;
-      if (options.to) params["to"] = options.to;
-      if (options.limit) params["limit"] = String(options.limit);
-      if (options.groupBy) params["groupBy"] = options.groupBy;
-      const url = buildUrl(this.baseUrl, "analytics/events", params);
-      const res = await fetch(url, { headers: this.headers });
-      const json = await parseResponse(res);
-      return { data: json.data, count: json.count, error: null };
-    } catch (err) {
-      return { data: [], count: 0, error: toHydrousError(err) };
-    }
-  }
-};
-
-// src/storage/scoped.ts
-var isBrowser = typeof window !== "undefined" && typeof XMLHttpRequest !== "undefined";
-function storageBase(url, bucketKey) {
-  return `${url.replace(/\/$/, "")}/storage/${encodeURIComponent(bucketKey)}`;
-}
-function storageHeaders(bucketKey) {
-  return { "X-Storage-Key": bucketKey };
-}
-function jsonHeaders(bucketKey) {
-  return { "X-Storage-Key": bucketKey, "Content-Type": "application/json" };
-}
-function drainSSE(raw, onProgress) {
-  const results = [];
-  const errors = [];
-  parseSSEText(raw, (eventType, data) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
-    const d = data;
-    if (eventType === "progress" && onProgress) {
-      onProgress({
-        index: (_a = d["index"]) != null ? _a : 0,
-        total: (_b = d["total"]) != null ? _b : 1,
-        path: (_c = d["path"]) != null ? _c : "",
-        stage: (_d = d["stage"]) != null ? _d : "uploading",
-        bytesUploaded: (_e = d["bytesUploaded"]) != null ? _e : 0,
-        totalBytes: (_f = d["totalBytes"]) != null ? _f : 0,
-        percent: (_g = d["percent"]) != null ? _g : 0,
-        bytesPerSecond: (_h = d["bytesPerSecond"]) != null ? _h : null,
-        eta: (_i = d["eta"]) != null ? _i : null,
-        result: d["result"],
-        error: d["error"],
-        code: d["code"]
-      });
-    }
-    if (eventType === "done") {
-      if (d["path"]) {
-        results.push(d);
-      } else if (Array.isArray(d["succeeded"])) {
-        results.push(...d["succeeded"]);
-        errors.push(...(_j = d["errors"]) != null ? _j : []);
-      }
-    }
-    if (eventType === "error") {
-      errors.push({
-        path: "",
-        error: (_k = d["error"]) != null ? _k : "Unknown error",
-        code: (_l = d["code"]) != null ? _l : "UNKNOWN"
-      });
-    }
-  });
-  return { results, errors };
-}
-var ScopedStorageClient = class {
-  constructor(baseUrl, keyName, bucketKey) {
-    this.base = storageBase(baseUrl, bucketKey);
-    this.key = bucketKey;
-    this.keyName = keyName;
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // UPLOAD — single file
-  // ══════════════════════════════════════════════════════════════════════════
-  /**
-   * Upload a single file.
-   *
-   * Supply `onProgress` to receive live upload ticks including bytes
-   * transferred, speed (bytes/sec), ETA, and lifecycle stage.
-   *
-   * **Stage sequence:**
-   * `pending → compressing → uploading → done | error`
-   *
-   * In browsers the progress is tracked at the network level via XHR, so
-   * `percent` reflects actual bytes leaving the device.  `done` only fires
-   * after the server confirms the write to cloud storage, so 100% is real.
-   *
-   * @example
-   * const { data, error } = await db.storage('avatars').upload(file, {
-   *   path:      'users/alice.jpg',
-   *   overwrite: true,
-   *   onProgress: (p) => {
-   *     setProgress(p.percent);              // e.g. drive a <progress> bar
-   *     setSpeed(`${p.bytesPerSecond} B/s`);
-   *     setEta(`${p.eta}s remaining`);
-   *   },
-   * });
-   */
-  async upload(file, options = {}) {
-    var _a, _b;
-    const { path, overwrite = false, onProgress } = options;
-    try {
-      const url = `${this.base}/upload`;
-      const form = new FormData();
-      if (file instanceof Uint8Array) {
-        form.append("file", new Blob([file.buffer]), path != null ? path : "file");
-      } else if (file instanceof ArrayBuffer) {
-        form.append("file", new Blob([file]), path != null ? path : "file");
-      } else {
-        form.append("file", file, path != null ? path : file instanceof File ? file.name : "file");
-      }
-      if (path) form.append("path", path);
-      if (overwrite) form.append("overwrite", "true");
-      const headers = storageHeaders(this.key);
-      if (isBrowser) {
-        const totalBytes = file instanceof Blob ? file.size : file instanceof Uint8Array ? file.byteLength : file.byteLength;
-        const rawBody = await xhrUpload(url, form, headers, (loaded, total) => {
-          onProgress == null ? void 0 : onProgress({
-            index: 0,
-            total: 1,
-            path: path != null ? path : "",
-            stage: "uploading",
-            bytesUploaded: loaded,
-            totalBytes: total || totalBytes,
-            percent: Math.min(99, Math.round(loaded / (total || totalBytes) * 100)),
-            bytesPerSecond: null,
-            eta: null
-          });
-        });
-        const { results, errors } = drainSSE(rawBody, onProgress);
-        if (errors.length > 0 && results.length === 0) {
-          return { data: null, error: { message: errors[0].error, code: errors[0].code } };
-        }
-        const result = (_a = results[0]) != null ? _a : null;
-        if (result && onProgress) {
-          onProgress({
-            index: 0,
-            total: 1,
-            path: result.path,
-            stage: "done",
-            bytesUploaded: totalBytes,
-            totalBytes,
-            percent: 100,
-            bytesPerSecond: null,
-            eta: 0,
-            result
-          });
-        }
-        return { data: result, error: null };
-      }
-      const res = await fetch(url, { method: "POST", headers, body: form });
-      if (!res.ok) {
-        const e = await res.json().catch(() => ({}));
-        throw new HydrousDBError((_b = e.error) != null ? _b : `HTTP ${res.status}`, "HTTP_ERROR", res.status);
-      }
-      let finalResult = null;
-      await readSSEStream(res, (eventType, data) => {
-        var _a2, _b2, _c, _d, _e, _f, _g, _h;
-        const d = data;
-        if (eventType === "progress" && onProgress) {
-          onProgress({
-            index: 0,
-            total: 1,
-            path: path != null ? path : "",
-            stage: (_a2 = d["stage"]) != null ? _a2 : "uploading",
-            bytesUploaded: (_b2 = d["bytesUploaded"]) != null ? _b2 : 0,
-            totalBytes: (_c = d["totalBytes"]) != null ? _c : 0,
-            percent: (_d = d["percent"]) != null ? _d : 0,
-            bytesPerSecond: (_e = d["bytesPerSecond"]) != null ? _e : null,
-            eta: (_f = d["eta"]) != null ? _f : null,
-            result: d["result"]
-          });
-        }
-        if (eventType === "done") finalResult = data;
-        if (eventType === "error") {
-          throw new HydrousDBError(
-            (_g = d["error"]) != null ? _g : "Upload failed",
-            (_h = d["code"]) != null ? _h : "UPLOAD_ERROR"
-          );
-        }
-      });
-      return { data: finalResult, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // UPLOAD TEXT / JSON
-  // ══════════════════════════════════════════════════════════════════════════
-  /**
-   * Upload raw text or JSON content directly — no File object needed.
-   *
-   * @example
-   * // Save a JSON config
-   * await db.storage('configs').uploadText(
-   *   'settings/app.json',
-   *   JSON.stringify({ theme: 'dark' }),
-   *   { mimeType: 'application/json' }
-   * );
-   */
-  async uploadText(path, content, options = {}) {
-    var _a;
-    const { mimeType = "text/plain", overwrite = false, onProgress } = options;
-    try {
-      const res = await fetch(`${this.base}/upload-raw`, {
-        method: "POST",
-        headers: jsonHeaders(this.key),
-        body: JSON.stringify({ path, content, mimeType, overwrite })
-      });
-      if (!res.ok) {
-        const e = await res.json().catch(() => ({}));
-        throw new HydrousDBError((_a = e.error) != null ? _a : `HTTP ${res.status}`, "HTTP_ERROR", res.status);
-      }
-      let finalResult = null;
-      await readSSEStream(res, (eventType, data) => {
-        var _a2, _b, _c, _d, _e, _f;
-        const d = data;
-        if (eventType === "progress" && onProgress) {
-          onProgress({
-            index: 0,
-            total: 1,
-            path,
-            stage: (_a2 = d["stage"]) != null ? _a2 : "uploading",
-            bytesUploaded: (_b = d["bytesUploaded"]) != null ? _b : 0,
-            totalBytes: (_c = d["totalBytes"]) != null ? _c : 0,
-            percent: (_d = d["percent"]) != null ? _d : 0,
-            bytesPerSecond: (_e = d["bytesPerSecond"]) != null ? _e : null,
-            eta: (_f = d["eta"]) != null ? _f : null
-          });
-        }
-        if (eventType === "done") finalResult = data;
-      });
-      return { data: finalResult, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // BATCH UPLOAD
-  // ══════════════════════════════════════════════════════════════════════════
-  /**
-   * Upload multiple files in one request.
-   *
-   * `onProgress` fires per file — use `p.index` to identify which file.
-   * All files receive a `pending` event upfront so you can render progress
-   * bars immediately before any data is sent.
-   *
-   * @example
-   * await db.storage('documents').batchUpload(files, {
-   *   prefix:     'reports/2024/',
-   *   onProgress: (p) => updateBar(p.index, p.percent),
-   * });
-   */
-  async batchUpload(files, options = {}) {
-    var _a;
-    const { prefix = "", paths, overwrite = false, onProgress } = options;
-    try {
-      const url = `${this.base}/batch-upload`;
-      const resolvedPaths = files.map((f, i) => {
-        var _a2;
-        return (_a2 = paths == null ? void 0 : paths[i]) != null ? _a2 : `${prefix}${f.name}`;
-      });
-      const form = new FormData();
-      files.forEach((f) => form.append("files", f, f.name));
-      form.append("paths", JSON.stringify(resolvedPaths));
-      if (overwrite) form.append("overwrite", "true");
-      const headers = storageHeaders(this.key);
-      if (isBrowser) {
-        const totalBytes = files.reduce((s, f) => s + f.size, 0);
-        const rawBody = await xhrUpload(url, form, headers, (loaded, total) => {
-          if (!onProgress) return;
-          let cursor = 0;
-          for (let i = 0; i < files.length; i++) {
-            const share = files[i].size / (totalBytes || 1);
-            const fileLoaded = Math.max(0, Math.min(
-              files[i].size,
-              (loaded / (total || totalBytes) - cursor) / share * files[i].size
-            ));
-            onProgress({
-              index: i,
-              total: files.length,
-              path: resolvedPaths[i],
-              stage: "uploading",
-              bytesUploaded: Math.round(fileLoaded),
-              totalBytes: files[i].size,
-              percent: Math.min(99, Math.round(fileLoaded / files[i].size * 100)),
-              bytesPerSecond: null,
-              eta: null
-            });
-            cursor += share;
-          }
-        });
-        const { results, errors } = drainSSE(rawBody, onProgress);
-        return { data: { succeeded: results, failed: errors }, error: null };
-      }
-      const res = await fetch(url, { method: "POST", headers, body: form });
-      if (!res.ok) {
-        const e = await res.json().catch(() => ({}));
-        throw new HydrousDBError((_a = e.error) != null ? _a : `HTTP ${res.status}`, "HTTP_ERROR", res.status);
-      }
-      const succeeded = [];
-      const failed = [];
-      await readSSEStream(res, (eventType, data) => {
-        var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j;
-        const d = data;
-        if (eventType === "progress" && onProgress) {
-          onProgress({
-            index: (_a2 = d["index"]) != null ? _a2 : 0,
-            total: (_b = d["total"]) != null ? _b : files.length,
-            path: (_c = d["path"]) != null ? _c : "",
-            stage: (_d = d["stage"]) != null ? _d : "uploading",
-            bytesUploaded: (_e = d["bytesUploaded"]) != null ? _e : 0,
-            totalBytes: (_f = d["totalBytes"]) != null ? _f : 0,
-            percent: (_g = d["percent"]) != null ? _g : 0,
-            bytesPerSecond: (_h = d["bytesPerSecond"]) != null ? _h : null,
-            eta: (_i = d["eta"]) != null ? _i : null
-          });
-        }
-        if (eventType === "done" && d["succeeded"]) {
-          succeeded.push(...d["succeeded"]);
-          failed.push(...(_j = d["errors"]) != null ? _j : []);
-        }
-      });
-      return { data: { succeeded, failed }, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // DOWNLOAD
-  // ══════════════════════════════════════════════════════════════════════════
-  /**
-   * Download a single file and return its content as an `ArrayBuffer`.
-   *
-   * @example
-   * const { data } = await db.storage('avatars').download('users/alice.jpg');
-   * const blob = new Blob([data!]);
-   * img.src = URL.createObjectURL(blob);
-   */
-  async download(filePath) {
-    var _a;
-    try {
-      const res = await fetch(`${this.base}/download/${filePath}`, {
-        headers: storageHeaders(this.key)
-      });
-      if (!res.ok) {
-        const e = await res.json().catch(() => ({}));
-        throw new HydrousDBError((_a = e.error) != null ? _a : `HTTP ${res.status}`, "HTTP_ERROR", res.status);
-      }
-      return { data: await res.arrayBuffer(), error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // BATCH DOWNLOAD
-  // ══════════════════════════════════════════════════════════════════════════
-  /**
-   * Download multiple files in one request.
-   *
-   * Set `autoSave: true` (browser only) to trigger a Save dialog per file.
-   *
-   * @example
-   * const { data } = await db.storage('reports').batchDownload(
-   *   ['jan.pdf', 'feb.pdf'],
-   *   { autoSave: true, onProgress: (p) => console.log(p.path, p.status) }
-   * );
-   */
-  async batchDownload(filePaths, options = {}) {
-    var _a;
-    const { concurrency = 5, onProgress, autoSave = false } = options;
-    try {
-      const res = await fetch(`${this.base}/batch-download`, {
-        method: "POST",
-        headers: jsonHeaders(this.key),
-        body: JSON.stringify({ paths: filePaths, concurrency })
-      });
-      if (!res.ok) {
-        const e = await res.json().catch(() => ({}));
-        throw new HydrousDBError((_a = e.error) != null ? _a : `HTTP ${res.status}`, "HTTP_ERROR", res.status);
-      }
-      const downloadedFiles = [];
-      await readSSEStream(res, (eventType, data) => {
-        var _a2, _b, _c, _d, _e, _f, _g, _h;
-        const d = data;
-        if (eventType === "file") {
-          const base64 = d["content"];
-          const mimeType = (_a2 = d["mimeType"]) != null ? _a2 : "application/octet-stream";
-          const path = (_b = d["path"]) != null ? _b : "";
-          const size = (_c = d["size"]) != null ? _c : 0;
-          const index = (_d = d["index"]) != null ? _d : 0;
-          const binary = atob(base64);
-          const bytes = new Uint8Array(binary.length);
-          for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
-          downloadedFiles.push({ path, content: bytes.buffer, mimeType, size });
-          onProgress == null ? void 0 : onProgress({ index, total: filePaths.length, path, status: "success", size, mimeType });
-          if (autoSave && isBrowser) {
-            const blob = new Blob([bytes.buffer], { type: mimeType });
-            const blobUrl = URL.createObjectURL(blob);
-            const a = document.createElement("a");
-            a.href = blobUrl;
-            a.download = (_e = path.split("/").pop()) != null ? _e : "download";
-            a.click();
-            setTimeout(() => URL.revokeObjectURL(blobUrl), 5e3);
-          }
-        }
-        if (eventType === "error" && onProgress) {
-          const index = (_f = d["index"]) != null ? _f : 0;
-          onProgress({
-            index,
-            total: filePaths.length,
-            path: (_g = filePaths[index]) != null ? _g : "",
-            status: "error",
-            error: (_h = d["error"]) != null ? _h : "Download failed"
-          });
-        }
-      });
-      return { data: downloadedFiles, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // LIST
-  // ══════════════════════════════════════════════════════════════════════════
-  /**
-   * List files and folders (paginated).
-   *
-   * @example
-   * const { data } = await db.storage('avatars').list({ prefix: 'users/' });
-   * for (const item of data!.items) {
-   *   console.log(item.type, item.path, item.size);
-   * }
-   */
-  async list(options = {}) {
-    const { prefix = "", limit = 50, cursor } = options;
-    try {
-      const url = buildUrl(this.base, "list", {
-        prefix: prefix || void 0,
-        limit,
-        cursor: cursor || void 0
-      });
-      const res = await fetch(url.replace(this.base + "/list", `${this.base}/list`), {
-        headers: storageHeaders(this.key)
-      });
-      const u = `${this.base}/list?${new URLSearchParams(
-        Object.entries({ prefix: prefix || "", limit: String(limit), ...cursor ? { cursor } : {} }).filter(([, v]) => v !== "")
-      ).toString()}`;
-      const r = await fetch(u, { headers: storageHeaders(this.key) });
-      const json = await parseResponse(r);
-      return { data: json, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // METADATA
-  // ══════════════════════════════════════════════════════════════════════════
-  /**
-   * Get metadata for a file (size, MIME type, compression, etc.)
-   *
-   * @example
-   * const { data: meta } = await db.storage('docs').metadata('report.pdf');
-   * console.log(meta!.size, meta!.mimeType, meta!.isCompressed);
-   */
-  async metadata(filePath) {
-    try {
-      const res = await fetch(`${this.base}/metadata/${filePath}`, {
-        headers: storageHeaders(this.key)
-      });
-      const json = await parseResponse(res);
-      return { data: json.data, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // DELETE
-  // ══════════════════════════════════════════════════════════════════════════
-  /** Delete a single file */
-  async deleteFile(filePath) {
-    try {
-      const res = await fetch(`${this.base}/file`, {
-        method: "DELETE",
-        headers: jsonHeaders(this.key),
-        body: JSON.stringify({ path: filePath })
-      });
-      await parseResponse(res);
-      return { data: void 0, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Recursively delete a folder and all its contents */
-  async deleteFolder(folderPath) {
-    try {
-      const res = await fetch(`${this.base}/folder`, {
-        method: "DELETE",
-        headers: jsonHeaders(this.key),
-        body: JSON.stringify({ path: folderPath })
-      });
-      await parseResponse(res);
-      return { data: void 0, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Create an empty folder */
-  async createFolder(folderPath) {
-    try {
-      const res = await fetch(`${this.base}/folder`, {
-        method: "POST",
-        headers: jsonHeaders(this.key),
-        body: JSON.stringify({ path: folderPath })
-      });
-      await parseResponse(res);
-      return { data: void 0, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // MOVE & COPY
-  // ══════════════════════════════════════════════════════════════════════════
-  /** Move (rename) a file */
-  async move(fromPath, toPath) {
-    try {
-      const res = await fetch(`${this.base}/move`, {
-        method: "POST",
-        headers: jsonHeaders(this.key),
-        body: JSON.stringify({ from: fromPath, to: toPath })
-      });
-      await parseResponse(res);
-      return { data: void 0, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  /** Copy a file (original is kept) */
-  async copy(fromPath, toPath) {
-    try {
-      const res = await fetch(`${this.base}/copy`, {
-        method: "POST",
-        headers: jsonHeaders(this.key),
-        body: JSON.stringify({ from: fromPath, to: toPath })
-      });
-      await parseResponse(res);
-      return { data: void 0, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // SIGNED URL
-  // ══════════════════════════════════════════════════════════════════════════
-  /**
-   * Generate a time-limited public URL for a private file.
-   *
-   * @example
-   * const { data } = await db.storage('contracts').signedUrl('nda.pdf', { expiresIn: 300 });
-   * console.log(data!.signedUrl); // share this
-   */
-  async signedUrl(filePath, options = {}) {
-    const { expiresIn = 3600 } = options;
-    try {
-      const res = await fetch(`${this.base}/signed-url`, {
-        method: "POST",
-        headers: jsonHeaders(this.key),
-        body: JSON.stringify({ path: filePath, expiresInSeconds: expiresIn })
-      });
-      const json = await parseResponse(res);
-      return { data: json, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-  // ══════════════════════════════════════════════════════════════════════════
-  // STATS
-  // ══════════════════════════════════════════════════════════════════════════
-  /**
-   * Get usage and billing stats for this storage key.
-   *
-   * @example
-   * const { data } = await db.storage('main').stats();
-   * console.log(data!.totalFiles, data!.totalSizeBytes);
-   */
-  async stats() {
-    try {
-      const res = await fetch(`${this.base}/stats`, {
-        headers: storageHeaders(this.key)
-      });
-      const json = await parseResponse(res);
-      return { data: json.data, error: null };
-    } catch (err) {
-      return { data: null, error: toHydrousError(err) };
-    }
-  }
-};
-
-// src/storage/manager.ts
-var StorageManager = class {
-  constructor(config) {
-    this.cache = /* @__PURE__ */ new Map();
-    this.baseUrl = config.url;
-    this._keys = config.storageKeys;
-  }
-  /**
-   * Get a storage client scoped to a named key.
-   *
-   * @param keyName - Must match a property you declared in `storageKeys`
-   *
-   * @example
-   * const avatarStore   = db.storage('avatars');
-   * const documentStore = db.storage('documents');
-   *
-   * await avatarStore.upload(file, { path: 'users/alice.jpg' });
-   * const list = await documentStore.list({ prefix: 'invoices/' });
-   */
-  use(keyName) {
-    const bucketKey = this._keys[keyName];
-    if (!bucketKey) {
-      const available = Object.keys(this._keys).join(", ");
-      throw new HydrousDBError(
-        `Storage key "${keyName}" is not defined.
-Available: ${available || "(none)"}`,
-        "UNKNOWN_STORAGE_KEY"
-      );
-    }
-    if (!this.cache.has(keyName)) {
-      this.cache.set(keyName, new ScopedStorageClient(this.baseUrl, keyName, bucketKey));
-    }
-    return this.cache.get(keyName);
-  }
-  /** Return the names of all configured storage keys */
-  keyNames() {
-    return Object.keys(this._keys);
-  }
-};
-
-// src/client.ts
-var HydrousClient = class {
-  constructor(config) {
-    if (!config.url) throw new Error("[HydrousDB] config.url is required");
-    if (!config.authKey) throw new Error("[HydrousDB] config.authKey is required");
-    if (!config.bucketSecurityKey) throw new Error("[HydrousDB] config.bucketSecurityKey is required");
-    if (!config.storageKeys || typeof config.storageKeys !== "object") {
-      throw new Error("[HydrousDB] config.storageKeys must be an object of named keys");
-    }
-    this.auth = new AuthClient(config);
-    this.records = new RecordsClient(config);
-    this.analytics = new AnalyticsClient(config);
-    const manager = new StorageManager(config);
-    const fn = (keyName) => manager.use(keyName);
-    fn.use = (keyName) => manager.use(keyName);
-    fn.keyNames = () => manager.keyNames();
-    this.storage = fn;
-  }
-};
-
-// src/index.ts
-function createClient(config) {
-  return new HydrousClient(config);
-}
-
-export { AnalyticsClient, AuthClient, HydrousClient, HydrousDBError, RecordsClient, ScopedStorageClient, StorageManager, createClient, eq, gt, gte, inArray, isHydrousError, lt, lte, neq };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map