@lunora/client 1.0.0-alpha.25 → 1.0.0-alpha.250

package/dist/upload.d.ts

@@ -0,0 +1,35 @@
+import { UploadControl, HeadersResolver, UploadRestrictions, ChunkedRestAdapter, MultipartAdapter, TusAdapter } from '@visulima/storage-client';
+export { type ChunkedRestAdapter, type ChunkedRestAdapterOptions, type FingerprintFunction, type HeadersResolver, LocalStorageUrlStorage, MemoryUrlStorage, type MultipartAdapter, type MultipartAdapterOptions, type OnBeforeRequest, type RequestOptions, RestrictionError, type TusAdapter, type TusAdapterOptions, type UploadControl, UploadError, type UploadMethod, type UploadRestrictions, type UploadResult, type Uploader, type UrlStorage, createChunkedRestAdapter, createMultipartAdapter, createTusAdapter, putFile, validateFile, validateFiles } from '@visulima/storage-client';
+/** Resumable upload wire protocols {@link createUpload} can drive. */
+type UploadProtocol = "chunked-rest" | "multipart" | "tus";
+/** The adapter shape {@link createUpload} returns — a `.upload(file)` driver plus lifecycle callbacks. */
+type UploadAdapter = ChunkedRestAdapter | MultipartAdapter | TusAdapter;
+/** Options for {@link createUpload}. */
+interface CreateUploadOptions {
+  /** Chunk size in bytes (TUS / chunked-REST only). */
+  chunkSize?: number;
+  /** A shared {@link UploadControl} for pause/resume/cancel (TUS / chunked-REST). */
+  control?: UploadControl;
+  /** The upload endpoint — a route backed by `@lunora/storage/upload`'s handler. */
+  endpoint: string;
+  /** Static or dynamically-resolved request headers (e.g. an `Authorization` token). */
+  headers?: HeadersResolver;
+  /** Maximum retry attempts (TUS / chunked-REST, when `retry` is on). */
+  maxRetries?: number;
+  /** Extra metadata sent with the upload. */
+  metadata?: Record<string, string>;
+  /** Which protocol to speak. Default `"tus"` (resumable, pause/resume-capable). */
+  protocol?: UploadProtocol;
+  /** Client-side size/type restrictions, validated before any network request. */
+  restrictions?: UploadRestrictions;
+  /** Enable automatic retry on failure (TUS / chunked-REST). */
+  retry?: boolean;
+}
+/**
+ * Create a protocol-appropriate upload adapter against an RLS-gated endpoint.
+ * Defaults to TUS — the resumable path that survives pause/resume and a dropped
+ * connection. Call `.upload(file)` to start; use the shared {@link UploadControl}
+ * (or the adapter's `pause`/`resume`/`abort`) to steer it.
+ */
+declare const createUpload: (options: CreateUploadOptions) => UploadAdapter;
+export { CreateUploadOptions, UploadAdapter, UploadProtocol, createUpload };

package/dist/upload.mjs

@@ -0,0 +1 @@
+import{createMultipartAdapter as d,createChunkedRestAdapter as u,createTusAdapter as m}from"@visulima/storage-client";import{LocalStorageUrlStorage as S,MemoryUrlStorage as f,RestrictionError as g,UploadControl as x,UploadError as C,createChunkedRestAdapter as F,createMultipartAdapter as M,createTusAdapter as O,putFile as v,validateFile as y,validateFiles as E}from"@visulima/storage-client";const U=t=>{const r=t.protocol??"tus",{chunkSize:s,control:n,endpoint:e,headers:a,maxRetries:o,metadata:p,restrictions:i,retry:l}=t;if(r==="multipart")return d({endpoint:e,headers:a,maxRetries:o,metadata:p,restrictions:i,retry:l});const c={chunkSize:s,control:n,endpoint:e,headers:a,maxRetries:o,metadata:p,restrictions:i,retry:l};return r==="chunked-rest"?u(c):m(c)};export{S as LocalStorageUrlStorage,f as MemoryUrlStorage,g as RestrictionError,x as UploadControl,C as UploadError,F as createChunkedRestAdapter,M as createMultipartAdapter,O as createTusAdapter,U as createUpload,v as putFile,y as validateFile,E as validateFiles};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/client",
-  "version": "1.0.0-alpha.25",
+  "version": "1.0.0-alpha.250",
   "description": "Lunora browser SDK: WebSocket transport, optimistic updates, and an offline mutation queue",
   "keywords": [
     "cloudflare",
@@ -56,13 +56,26 @@
       "types": "./dist/ssr/index.d.ts",
       "import": "./dist/ssr/index.mjs"
     },
+    "./upload": {
+      "types": "./dist/upload.d.ts",
+      "import": "./dist/upload.mjs"
+    },
+    "./service": {
+      "types": "./dist/service.d.ts",
+      "import": "./dist/service.mjs"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@lunora/errors": "1.0.0-alpha.6"
+    "@lunora/errors": ">=1.0.0-alpha.51 <2.0.0-0",
+    "@lunora/wire": "1.0.0-alpha.2",
+    "@visulima/storage-client": "1.0.9"
+  },
+  "peerDependencies": {
+    "@lunora/runtime": ">=1.0.0-alpha.76 <2.0.0-0"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"

package/dist/packem_shared/CONFLICT_ERROR_CODE-B8gQ8tyU.mjs

@@ -1,33 +0,0 @@
-const LUNORA_ERROR_CODES = [
-  "BAD_REQUEST",
-  "CONFLICT",
-  "COUNT_RLS_UNSUPPORTED",
-  "FORBIDDEN",
-  "INTERNAL_SERVER_ERROR",
-  "MASK_UNSUPPORTED",
-  "NOT_FOUND",
-  "NOT_IMPLEMENTED",
-  "RELATION_PREDICATE_UNSUPPORTED",
-  "TOO_MANY_REQUESTS",
-  "UNAUTHORIZED",
-  "UNPROCESSABLE"
-];
-const KNOWN_ERROR_CODES = new Set(LUNORA_ERROR_CODES);
-const CONFLICT_ERROR_CODE = "CONFLICT";
-const isConflictError = (error) => error instanceof Error && error.code === CONFLICT_ERROR_CODE;
-const isForbiddenError = (error) => error instanceof Error && error.code === "FORBIDDEN";
-const isUnauthorizedError = (error) => error instanceof Error && error.code === "UNAUTHORIZED";
-const isRateLimitedError = (error) => error instanceof Error && error.code === "TOO_MANY_REQUESTS";
-const getErrorCode = (error) => {
-  if (!(error instanceof Error)) {
-    return void 0;
-  }
-  const { code } = error;
-  return typeof code === "string" && KNOWN_ERROR_CODES.has(code) ? code : void 0;
-};
-const getRetryAfterMs = (error) => {
-  const value = error?.data?.retryAfterMs;
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
-};
-
-export { CONFLICT_ERROR_CODE, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError };

package/dist/packem_shared/ClientServiceWorker-C3PAFwy0.mjs

@@ -1,100 +0,0 @@
-class ClientServiceWorker {
-  swUrl;
-  scope;
-  #registration = void 0;
-  #status = "unregistered";
-  #onStatusChange;
-  #messageHandlers = /* @__PURE__ */ new Set();
-  constructor(options) {
-    this.swUrl = options.swUrl;
-    this.scope = options.scope ?? "/";
-    this.#onStatusChange = options.onStatusChange;
-  }
-  // ── Status ──────────────────────────────────────────────────────────
-  /** Current registration status. */
-  get status() {
-    return this.#status;
-  }
-  /** The underlying `ServiceWorkerRegistration`, if registered. */
-  get registration() {
-    return this.#registration;
-  }
-  /** Whether the SW is currently controlling this page. */
-  get active() {
-    return this.#registration?.active !== null && this.#registration?.active !== void 0;
-  }
-  // ── Registration ────────────────────────────────────────────────────
-  /**
-   * Register the service worker.
-   *
-   * Returns `false` when the browser does not support service workers.
-   */
-  async register() {
-    if (!("serviceWorker" in navigator)) {
-      this.#setStatus("unsupported");
-      return false;
-    }
-    this.#setStatus("registering");
-    try {
-      this.#registration = await navigator.serviceWorker.register(this.swUrl, {
-        scope: this.scope
-      });
-      this.#setStatus("active");
-      navigator.serviceWorker.addEventListener("message", this.#onMessage);
-    } catch {
-      this.#setStatus("error");
-      return false;
-    }
-    return true;
-  }
-  /**
-   * Remove the active service worker registration and clear listeners.
-   *
-   * Returns `false` when no registration is currently held.
-   */
-  async unregister() {
-    if (!this.#registration) {
-      return false;
-    }
-    navigator.serviceWorker.removeEventListener("message", this.#onMessage);
-    const ok = await this.#registration.unregister();
-    this.#registration = void 0;
-    this.#setStatus("unregistered");
-    return ok;
-  }
-  // ── Messaging ───────────────────────────────────────────────────────
-  /**
-   * Send a message to the active service worker.
-   */
-  postMessage(message) {
-    const active = this.#registration?.active;
-    if (active) {
-      active.postMessage(message);
-    }
-  }
-  /**
-   * Register a handler for messages **from** the service worker.
-   * @returns Unsubscribe function.
-   */
-  onMessage(handler) {
-    this.#messageHandlers.add(handler);
-    return () => {
-      this.#messageHandlers.delete(handler);
-    };
-  }
-  // ── Internals ───────────────────────────────────────────────────────
-  #setStatus(status) {
-    this.#status = status;
-    this.#onStatusChange?.(status);
-  }
-  #onMessage = (event) => {
-    for (const handler of this.#messageHandlers) {
-      try {
-        handler(event);
-      } catch {
-      }
-    }
-  };
-}
-
-export { ClientServiceWorker };

package/dist/packem_shared/DEFAULT_MAX_BUFFER-7hFnzNk9.mjs

@@ -1,110 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-
-const DEFAULT_MAX_BUFFER = 1024;
-const createStream = (options) => {
-  const maxBuffer = options.maxBuffer ?? DEFAULT_MAX_BUFFER;
-  const buffer = [];
-  const pending = [];
-  let done = false;
-  let failure;
-  let cancelled = false;
-  const flushOne = () => {
-    const waiter = pending.shift();
-    if (!waiter) {
-      return false;
-    }
-    if (failure) {
-      waiter.reject(failure);
-      return true;
-    }
-    if (buffer.length > 0) {
-      const value = buffer.shift();
-      waiter.resolve({ done: false, value });
-      return true;
-    }
-    if (done) {
-      waiter.resolve({ done: true, value: void 0 });
-      return true;
-    }
-    pending.unshift(waiter);
-    return false;
-  };
-  const handle = {
-    complete() {
-      if (done || failure) {
-        return;
-      }
-      done = true;
-      while (flushOne()) {
-      }
-    },
-    fail(error) {
-      if (done || failure) {
-        return;
-      }
-      failure = error;
-      buffer.length = 0;
-      while (flushOne()) {
-      }
-    },
-    push(value) {
-      if (done || failure || cancelled) {
-        return;
-      }
-      if (buffer.length >= maxBuffer) {
-        handle.fail(
-          new LunoraError(
-            "STREAM_BACKPRESSURE",
-            `stream buffer overflow (max=${maxBuffer.toString()}); the consumer cannot keep up with the producer`
-          )
-        );
-        return;
-      }
-      buffer.push(value);
-      flushOne();
-    }
-  };
-  const cancel = () => {
-    if (cancelled) {
-      return;
-    }
-    cancelled = true;
-    done = true;
-    buffer.length = 0;
-    try {
-      options.onCancel();
-    } catch {
-    }
-    while (flushOne()) {
-    }
-  };
-  const iterable = {
-    cancel,
-    [Symbol.asyncIterator]() {
-      return {
-        next() {
-          if (failure) {
-            return Promise.reject(failure);
-          }
-          if (buffer.length > 0) {
-            const value = buffer.shift();
-            return Promise.resolve({ done: false, value });
-          }
-          if (done) {
-            return Promise.resolve({ done: true, value: void 0 });
-          }
-          return new Promise((resolve, reject) => {
-            pending.push({ reject, resolve });
-          });
-        },
-        return() {
-          cancel();
-          return Promise.resolve({ done: true, value: void 0 });
-        }
-      };
-    }
-  };
-  return { handle, iterable };
-};
-
-export { DEFAULT_MAX_BUFFER, createStream };