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

package/dist/auth/index.d.mts

@@ -1,4 +1,4 @@
-import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-C4ud8bej.mjs";
+import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-B1iZb2Ph.mjs";
 import '@lunora/runtime';
 interface IdentityStore {
   /** Read the current resolved user, or `null` when signed out / not yet resolved. */

package/dist/auth/index.d.ts

@@ -1,4 +1,4 @@
-import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-C4ud8bej.js";
+import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-B1iZb2Ph.js";
 import '@lunora/runtime';
 interface IdentityStore {
   /** Read the current resolved user, or `null` when signed out / not yet resolved. */

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { c as PersistenceAdapter, B as BookmarkStorage, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, F as FunctionReference, A as ArgsOf, M as MutationCallOptions, R as ReturnOf, O as OfflineQueueOptions, Q as QueryCacheAdapter, g as ReconnectOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-C4ud8bej.mjs";
-export { type h as BatchSlot, C as CONFLICT_ERROR_CODE, type i as CachedQuery, type j as ClientMessage, type k as ClientQueryRef, type l as ClientShapeSubscribeMessage, type m as ClientShapeUnsubscribeMessage, type n as ConnectionStatus, D as DEFAULT_MAX_BUFFER, type o as FunctionArgumentDescriptor, type p as FunctionDescriptor, type G as GlobalFacetResult, type q as GlobalFacetValue, type r as GlobalFilterClause, type s as GlobalTableInfo, type t as GlobalTablePage, type u as HttpStreamCallArgs, type v as LunoraClientError, type w as LunoraClientOptions, type x as LunoraErrorCode, type y as MutationSettledEvent, type z as OptimisticLocalStore, type E as OptimisticUpdate, type I as OutboxMutation, type J as OutboxSink, type K as PersistedMutation, type P as Preloaded, type N as RowOp, type T as RpcEnvelope, type V as RpcResponseBody, type W as ScheduleRecord, type X as SchedulerPoolStatus, type Y as SchedulerStatus, type Z as ServerMessage, type _ as ServerPokeEndMessage, type $ as ServerPokePartMessage, type a0 as ServerPokeStartMessage, type a1 as ShardTrafficEntry, type a2 as ShardTrafficResult, type a3 as StorageListPage, type a4 as StorageObject, type a5 as StreamHandle, type a6 as SubscriptionCallback, type b as SubscriptionErrorCallback, a7 as SubscriptionRegistry, type a8 as SubscriptionState, type a9 as SyncWatermark, type a as Unsubscribe, type U as User, type aa as WorkflowInstanceAction, type ab as WorkflowInstanceDetail, type ac as WorkflowInstancePage, type ad as WorkflowInstanceStatus, type ae as WorkflowInstanceSummary, type af as WorkflowStepDetail, type ag as WsTokenProvider, ah as createClientQuery, ai as createLocalStore, aj as createStream, ak as getErrorCode, al as getRetryAfterMs, am as isConflictError, an as isForbiddenError, ao as isRateLimitedError, ap as isUnauthorizedError } from "./packem_shared/lunora-client.d-C4ud8bej.mjs";
-export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-Dvk8zg6m.mjs";
-export type { AuthCapabilities, AuthConfigInfo, AuthImpersonation, AuthPage, AuthSession, AuthUser, AuthUserFieldSpec, CronJobInfo, KvKeyEntry, KvKeyListResult, KvNamespaceSummary, KvValueResult, VectorIndexSummary, VectorQueryMatch } from '@lunora/runtime';
+import { c as PersistenceAdapter, B as BookmarkStorage, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, F as FunctionReference, A as ArgsOf, M as MutationCallOptions, R as ReturnOf, O as OfflineQueueOptions, Q as QueryCacheAdapter, g as ReconnectOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-B1iZb2Ph.mjs";
+export { type h as BatchSlot, C as CONFLICT_ERROR_CODE, type i as CachedQuery, type j as ClientMessage, type k as ClientQueryRef, type l as ClientShapeSubscribeMessage, type m as ClientShapeUnsubscribeMessage, type n as ConnectionStatus, D as DEFAULT_MAX_BUFFER, type o as FunctionArgumentDescriptor, type p as FunctionDescriptor, type G as GlobalFacetResult, type q as GlobalFacetValue, type r as GlobalFilterClause, type s as GlobalTableInfo, type t as GlobalTablePage, type u as HttpStreamCallArgs, type v as LunoraClientError, type w as LunoraClientOptions, type x as LunoraErrorCode, type y as MutationSettledEvent, type z as OptimisticLocalStore, type E as OptimisticUpdate, type I as OutboxMutation, type J as OutboxSink, type K as PersistedMutation, type P as Preloaded, type N as RowOp, type T as RpcEnvelope, type V as RpcResponseBody, type W as ScheduleRecord, type X as SchedulerPoolStatus, type Y as SchedulerStatus, type Z as ServerMessage, type _ as ServerPokeEndMessage, type $ as ServerPokePartMessage, type a0 as ServerPokeStartMessage, type a1 as ShardTrafficEntry, type a2 as ShardTrafficResult, type a3 as StorageListPage, type a4 as StorageObject, type a5 as StreamHandle, type a6 as SubscriptionCallback, type b as SubscriptionErrorCallback, a7 as SubscriptionRegistry, type a8 as SubscriptionState, type a9 as SyncWatermark, type a as Unsubscribe, type U as User, type aa as WorkflowInstanceAction, type ab as WorkflowInstanceDetail, type ac as WorkflowInstancePage, type ad as WorkflowInstanceStatus, type ae as WorkflowInstanceSummary, type af as WorkflowStepDetail, type ag as WsTokenProvider, ah as createClientQuery, ai as createLocalStore, aj as createStream, ak as getErrorCode, al as getRetryAfterMs, am as isConflictError, an as isForbiddenError, ao as isRateLimitedError, ap as isUnauthorizedError } from "./packem_shared/lunora-client.d-B1iZb2Ph.mjs";
+export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-CLwoXl3R.mjs";
+export type { AuthCapabilities, AuthConfigInfo, AuthImpersonation, AuthPage, AuthSession, AuthUser, AuthUserFieldSpec, CronJobInfo, KvKeyEntry, KvKeyListResult, KvNamespaceSummary, KvValueResult, PipelineLogColumnMap, PipelineLogCursor, PipelineLogField, PipelineLogPage, PipelineLogQuery, PipelineLogRow, VectorIndexSummary, VectorQueryMatch } from '@lunora/runtime';
 /**
  * The slice of React Native's `AsyncStorage` (or any async key/value store —
  * Expo `SecureStore`, a wrapped `localForage`, an in-memory map in tests) this

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { c as PersistenceAdapter, B as BookmarkStorage, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, F as FunctionReference, A as ArgsOf, M as MutationCallOptions, R as ReturnOf, O as OfflineQueueOptions, Q as QueryCacheAdapter, g as ReconnectOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-C4ud8bej.js";
-export { type h as BatchSlot, C as CONFLICT_ERROR_CODE, type i as CachedQuery, type j as ClientMessage, type k as ClientQueryRef, type l as ClientShapeSubscribeMessage, type m as ClientShapeUnsubscribeMessage, type n as ConnectionStatus, D as DEFAULT_MAX_BUFFER, type o as FunctionArgumentDescriptor, type p as FunctionDescriptor, type G as GlobalFacetResult, type q as GlobalFacetValue, type r as GlobalFilterClause, type s as GlobalTableInfo, type t as GlobalTablePage, type u as HttpStreamCallArgs, type v as LunoraClientError, type w as LunoraClientOptions, type x as LunoraErrorCode, type y as MutationSettledEvent, type z as OptimisticLocalStore, type E as OptimisticUpdate, type I as OutboxMutation, type J as OutboxSink, type K as PersistedMutation, type P as Preloaded, type N as RowOp, type T as RpcEnvelope, type V as RpcResponseBody, type W as ScheduleRecord, type X as SchedulerPoolStatus, type Y as SchedulerStatus, type Z as ServerMessage, type _ as ServerPokeEndMessage, type $ as ServerPokePartMessage, type a0 as ServerPokeStartMessage, type a1 as ShardTrafficEntry, type a2 as ShardTrafficResult, type a3 as StorageListPage, type a4 as StorageObject, type a5 as StreamHandle, type a6 as SubscriptionCallback, type b as SubscriptionErrorCallback, a7 as SubscriptionRegistry, type a8 as SubscriptionState, type a9 as SyncWatermark, type a as Unsubscribe, type U as User, type aa as WorkflowInstanceAction, type ab as WorkflowInstanceDetail, type ac as WorkflowInstancePage, type ad as WorkflowInstanceStatus, type ae as WorkflowInstanceSummary, type af as WorkflowStepDetail, type ag as WsTokenProvider, ah as createClientQuery, ai as createLocalStore, aj as createStream, ak as getErrorCode, al as getRetryAfterMs, am as isConflictError, an as isForbiddenError, ao as isRateLimitedError, ap as isUnauthorizedError } from "./packem_shared/lunora-client.d-C4ud8bej.js";
-export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-B6-lqUf2.js";
-export type { AuthCapabilities, AuthConfigInfo, AuthImpersonation, AuthPage, AuthSession, AuthUser, AuthUserFieldSpec, CronJobInfo, KvKeyEntry, KvKeyListResult, KvNamespaceSummary, KvValueResult, VectorIndexSummary, VectorQueryMatch } from '@lunora/runtime';
+import { c as PersistenceAdapter, B as BookmarkStorage, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, F as FunctionReference, A as ArgsOf, M as MutationCallOptions, R as ReturnOf, O as OfflineQueueOptions, Q as QueryCacheAdapter, g as ReconnectOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-B1iZb2Ph.js";
+export { type h as BatchSlot, C as CONFLICT_ERROR_CODE, type i as CachedQuery, type j as ClientMessage, type k as ClientQueryRef, type l as ClientShapeSubscribeMessage, type m as ClientShapeUnsubscribeMessage, type n as ConnectionStatus, D as DEFAULT_MAX_BUFFER, type o as FunctionArgumentDescriptor, type p as FunctionDescriptor, type G as GlobalFacetResult, type q as GlobalFacetValue, type r as GlobalFilterClause, type s as GlobalTableInfo, type t as GlobalTablePage, type u as HttpStreamCallArgs, type v as LunoraClientError, type w as LunoraClientOptions, type x as LunoraErrorCode, type y as MutationSettledEvent, type z as OptimisticLocalStore, type E as OptimisticUpdate, type I as OutboxMutation, type J as OutboxSink, type K as PersistedMutation, type P as Preloaded, type N as RowOp, type T as RpcEnvelope, type V as RpcResponseBody, type W as ScheduleRecord, type X as SchedulerPoolStatus, type Y as SchedulerStatus, type Z as ServerMessage, type _ as ServerPokeEndMessage, type $ as ServerPokePartMessage, type a0 as ServerPokeStartMessage, type a1 as ShardTrafficEntry, type a2 as ShardTrafficResult, type a3 as StorageListPage, type a4 as StorageObject, type a5 as StreamHandle, type a6 as SubscriptionCallback, type b as SubscriptionErrorCallback, a7 as SubscriptionRegistry, type a8 as SubscriptionState, type a9 as SyncWatermark, type a as Unsubscribe, type U as User, type aa as WorkflowInstanceAction, type ab as WorkflowInstanceDetail, type ac as WorkflowInstancePage, type ad as WorkflowInstanceStatus, type ae as WorkflowInstanceSummary, type af as WorkflowStepDetail, type ag as WsTokenProvider, ah as createClientQuery, ai as createLocalStore, aj as createStream, ak as getErrorCode, al as getRetryAfterMs, am as isConflictError, an as isForbiddenError, ao as isRateLimitedError, ap as isUnauthorizedError } from "./packem_shared/lunora-client.d-B1iZb2Ph.js";
+export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-Cqb4Kh2I.js";
+export type { AuthCapabilities, AuthConfigInfo, AuthImpersonation, AuthPage, AuthSession, AuthUser, AuthUserFieldSpec, CronJobInfo, KvKeyEntry, KvKeyListResult, KvNamespaceSummary, KvValueResult, PipelineLogColumnMap, PipelineLogCursor, PipelineLogField, PipelineLogPage, PipelineLogQuery, PipelineLogRow, VectorIndexSummary, VectorQueryMatch } from '@lunora/runtime';
 /**
  * The slice of React Native's `AsyncStorage` (or any async key/value store —
  * Expo `SecureStore`, a wrapped `localForage`, an in-memory map in tests) this

package/dist/index.mjs

@@ -6,7 +6,7 @@ export { applyDelta, isMutationDelta } from './packem_shared/applyDelta-CRKZ1PBt
 export { CONFLICT_ERROR_CODE, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from './packem_shared/CONFLICT_ERROR_CODE-B8gQ8tyU.mjs';
 export { httpStream } from './packem_shared/httpStream-DIdL8NEw.mjs';
 export { c as createLocalStore } from './packem_shared/local-store-DIq-UWfD.mjs';
-export { LunoraClient } from './packem_shared/LunoraClient-D3h4P7hg.mjs';
+export { LunoraClient } from './packem_shared/LunoraClient-DKATLGHY.mjs';
 export { createMutationRunner } from './packem_shared/createMutationRunner-BqsavzvG.mjs';
 export { createMutatorRunner } from './packem_shared/createMutatorRunner-BETvCd0p.mjs';
 export { O as OfflineQueue } from './packem_shared/offline-queue-N-1JvYb4.mjs';

package/dist/packem_shared/{LunoraClient-D3h4P7hg.mjs → LunoraClient-DKATLGHY.mjs}

@@ -97,6 +97,7 @@ const GLOBAL_TABLE_PATH = "/_lunora/admin/global/table";
 const GLOBAL_FACET_PATH = "/_lunora/admin/global/facet";
 const VECTOR_INDEXES_PATH = "/_lunora/admin/vector/indexes";
 const VECTOR_QUERY_PATH = "/_lunora/admin/vector/query";
+const LOG_ARCHIVE_PATH = "/_lunora/admin/logs/archive";
 const KV_NAMESPACES_PATH = "/_lunora/admin/kv/namespaces";
 const KV_KEYS_PATH = "/_lunora/admin/kv/keys";
 const KV_VALUE_PATH = "/_lunora/admin/kv/value";
@@ -1663,6 +1664,23 @@ class LunoraClient {
     const body = await this.adminFetch(VECTOR_QUERY_PATH, "POST", options);
     return body.matches ?? [];
   }
+  /**
+   * Read one keyset-paginated page of the durable `ctx.log` archive that
+   * `pipelineLogSink` writes to R2. Server-side only — the worker holds the R2
+   * SQL credentials and runs the reader; the browser only sees the decoded
+   * `{ rows, nextCursor }`. Pass the previous page's `nextCursor` as
+   * `query.cursor` to page. Admin-gated. When the operator hasn't wired the
+   * archive, `adminFetch` throws a `LunoraClientError` with `.code ===
+   * "LOG_ARCHIVE_NOT_CONFIGURED"`, so a caller can render a "not configured"
+   * state rather than an error.
+   */
+  async queryLogArchive(query = {}) {
+    if (this.closed) {
+      throw new LunoraError("INTERNAL", "LunoraClient is closed");
+    }
+    const body = await this.adminFetch(LOG_ARCHIVE_PATH, "POST", query);
+    return { nextCursor: body.nextCursor, rows: body.rows ?? [] };
+  }
   // --- KV namespace admin -------------------------------------------------
   /**
    * List the worker's registered Workers KV namespaces (binding names). Hits

package/dist/packem_shared/{createServerClient-DzeC2J3A.mjs → createServerClient-Bp2r9tcB.mjs}

@@ -1,4 +1,4 @@
-import { LunoraClient } from './LunoraClient-D3h4P7hg.mjs';
+import { LunoraClient } from './LunoraClient-DKATLGHY.mjs';
 
 const createServerClient = (options) => {
   const client = new LunoraClient({ fetch: options.fetch, url: options.url });

package/dist/packem_shared/{lunora-client.d-C4ud8bej.d.mts → lunora-client.d-B1iZb2Ph.d.mts}

@@ -1,4 +1,4 @@
-import { CronJobInfo, VectorIndexSummary, VectorQueryMatch, KvNamespaceSummary, KvKeyListResult, KvValueResult, AuthUser, AuthPage, AuthImpersonation, AuthCapabilities, AuthConfigInfo, AuthSession } from '@lunora/runtime';
+import { CronJobInfo, VectorIndexSummary, VectorQueryMatch, PipelineLogQuery, PipelineLogPage, KvNamespaceSummary, KvKeyListResult, KvValueResult, AuthUser, AuthPage, AuthImpersonation, AuthCapabilities, AuthConfigInfo, AuthSession } from '@lunora/runtime';
 /**
  * Reactive key-value store for local-only client state.
  *
@@ -2123,6 +2123,17 @@ declare class LunoraClient {
     text: string;
     topK?: number;
   }): Promise<VectorQueryMatch[]>;
+  /**
+   * Read one keyset-paginated page of the durable `ctx.log` archive that
+   * `pipelineLogSink` writes to R2. Server-side only — the worker holds the R2
+   * SQL credentials and runs the reader; the browser only sees the decoded
+   * `{ rows, nextCursor }`. Pass the previous page's `nextCursor` as
+   * `query.cursor` to page. Admin-gated. When the operator hasn't wired the
+   * archive, `adminFetch` throws a `LunoraClientError` with `.code ===
+   * "LOG_ARCHIVE_NOT_CONFIGURED"`, so a caller can render a "not configured"
+   * state rather than an error.
+   */
+  queryLogArchive(query?: PipelineLogQuery): Promise<PipelineLogPage>;
   /**
    * List the worker's registered Workers KV namespaces (binding names). Hits
    * the admin-gated `GET /_lunora/admin/kv/namespaces` endpoint — the worker

package/dist/packem_shared/{lunora-client.d-C4ud8bej.d.ts → lunora-client.d-B1iZb2Ph.d.ts}

@@ -1,4 +1,4 @@
-import { CronJobInfo, VectorIndexSummary, VectorQueryMatch, KvNamespaceSummary, KvKeyListResult, KvValueResult, AuthUser, AuthPage, AuthImpersonation, AuthCapabilities, AuthConfigInfo, AuthSession } from '@lunora/runtime';
+import { CronJobInfo, VectorIndexSummary, VectorQueryMatch, PipelineLogQuery, PipelineLogPage, KvNamespaceSummary, KvKeyListResult, KvValueResult, AuthUser, AuthPage, AuthImpersonation, AuthCapabilities, AuthConfigInfo, AuthSession } from '@lunora/runtime';
 /**
  * Reactive key-value store for local-only client state.
  *
@@ -2123,6 +2123,17 @@ declare class LunoraClient {
     text: string;
     topK?: number;
   }): Promise<VectorQueryMatch[]>;
+  /**
+   * Read one keyset-paginated page of the durable `ctx.log` archive that
+   * `pipelineLogSink` writes to R2. Server-side only — the worker holds the R2
+   * SQL credentials and runs the reader; the browser only sees the decoded
+   * `{ rows, nextCursor }`. Pass the previous page's `nextCursor` as
+   * `query.cursor` to page. Admin-gated. When the operator hasn't wired the
+   * archive, `adminFetch` throws a `LunoraClientError` with `.code ===
+   * "LOG_ARCHIVE_NOT_CONFIGURED"`, so a caller can render a "not configured"
+   * state rather than an error.
+   */
+  queryLogArchive(query?: PipelineLogQuery): Promise<PipelineLogPage>;
   /**
    * List the worker's registered Workers KV namespaces (binding names). Hits
    * the admin-gated `GET /_lunora/admin/kv/namespaces` endpoint — the worker

package/dist/packem_shared/{preload.d-Dvk8zg6m.d.mts → preload.d-CLwoXl3R.d.mts}

@@ -1,4 +1,4 @@
-import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-C4ud8bej.mjs";
+import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-B1iZb2Ph.mjs";
 /**
  * Run a query once on the server (during SSR) and capture its result in a
  * serializable {@link Preloaded} token. Embed the token in the rendered HTML and

package/dist/packem_shared/{preload.d-B6-lqUf2.d.ts → preload.d-Cqb4Kh2I.d.ts}

@@ -1,4 +1,4 @@
-import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-C4ud8bej.js";
+import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-B1iZb2Ph.js";
 /**
  * Run a query once on the server (during SSR) and capture its result in a
  * serializable {@link Preloaded} token. Embed the token in the rendered HTML and

package/dist/query/index.d.mts

@@ -1,5 +1,5 @@
-import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-C4ud8bej.mjs";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-C4ud8bej.mjs";
+import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-B1iZb2Ph.mjs";
+export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-B1iZb2Ph.mjs";
 import '@lunora/runtime';
 /**
  * The sentinel a framework adapter resolves its reactive args to when it wants

package/dist/query/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-C4ud8bej.js";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-C4ud8bej.js";
+import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-B1iZb2Ph.js";
+export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-B1iZb2Ph.js";
 import '@lunora/runtime';
 /**
  * The sentinel a framework adapter resolves its reactive args to when it wants

package/dist/ssr/index.d.mts

@@ -1,6 +1,6 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-C4ud8bej.mjs";
-export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-C4ud8bej.mjs";
-export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-Dvk8zg6m.mjs";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-B1iZb2Ph.mjs";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-B1iZb2Ph.mjs";
+export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-CLwoXl3R.mjs";
 import '@lunora/runtime';
 /**
  * Structural shape of a better-auth `getSession` call's resolved value.

package/dist/ssr/index.d.ts

@@ -1,6 +1,6 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-C4ud8bej.js";
-export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-C4ud8bej.js";
-export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-B6-lqUf2.js";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-B1iZb2Ph.js";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-B1iZb2Ph.js";
+export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-Cqb4Kh2I.js";
 import '@lunora/runtime';
 /**
  * Structural shape of a better-auth `getSession` call's resolved value.

package/dist/ssr/index.mjs

@@ -1,4 +1,4 @@
 export { getServerSession } from '../packem_shared/getServerSession-8jXewqxd.mjs';
 export { deserializePreloaded, serializePreloaded } from '../packem_shared/deserializePreloaded-C0eJTY_W.mjs';
-export { createServerClient } from '../packem_shared/createServerClient-DzeC2J3A.mjs';
+export { createServerClient } from '../packem_shared/createServerClient-Bp2r9tcB.mjs';
 export { preloadQuery, preloadedQueryResult } from '../packem_shared/preloadQuery-lobFkD2Z.mjs';

package/dist/upload.d.mts

@@ -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.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,24 @@
+import { createMultipartAdapter, createChunkedRestAdapter, createTusAdapter } from '@visulima/storage-client';
+export { LocalStorageUrlStorage, MemoryUrlStorage, RestrictionError, UploadControl, UploadError, createChunkedRestAdapter, createMultipartAdapter, createTusAdapter, putFile, validateFile, validateFiles } from '@visulima/storage-client';
+
+const createUpload = (options) => {
+  const protocol = options.protocol ?? "tus";
+  const { chunkSize, control, endpoint, headers, maxRetries, metadata, restrictions, retry } = options;
+  if (protocol === "multipart") {
+    const multipartOptions = { endpoint, headers, maxRetries, metadata, restrictions, retry };
+    return createMultipartAdapter(multipartOptions);
+  }
+  const resumableOptions = {
+    chunkSize,
+    control,
+    endpoint,
+    headers,
+    maxRetries,
+    metadata,
+    restrictions,
+    retry
+  };
+  return protocol === "chunked-rest" ? createChunkedRestAdapter(resumableOptions) : createTusAdapter(resumableOptions);
+};
+
+export { createUpload };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/client",
-  "version": "1.0.0-alpha.25",
+  "version": "1.0.0-alpha.27",
   "description": "Lunora browser SDK: WebSocket transport, optimistic updates, and an offline mutation queue",
   "keywords": [
     "cloudflare",
@@ -56,13 +56,18 @@
       "types": "./dist/ssr/index.d.ts",
       "import": "./dist/ssr/index.mjs"
     },
+    "./upload": {
+      "types": "./dist/upload.d.ts",
+      "import": "./dist/upload.mjs"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@lunora/errors": "1.0.0-alpha.6"
+    "@lunora/errors": "1.0.0-alpha.7",
+    "@visulima/storage-client": "1.0.0"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"