@siafoundation/sia-storage 0.1.0 → 0.1.2

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Browser entry; lazily initializes WASM on first use.\n\nimport wasmInit from '../wasm/sia_storage_wasm.js'\n\nlet initPromise: Promise<unknown> | null = null\n\n/** Initialize the WASM module. Safe to call multiple times. */\nexport async function initSia(): Promise<void> {\n  if (!initPromise) initPromise = wasmInit()\n  await initPromise\n}\n\nexport {\n  AppKey,\n  Builder,\n  KeyRecord,\n  ObjectEvent,\n  PackedUpload,\n  PinnedObject,\n  Sdk,\n  SharedSdk,\n  SharingKey,\n  encodedSize,\n  generateRecoveryPhrase,\n  setLogger,\n  validateRecoveryPhrase,\n} from '../wasm/sia_storage_wasm.js'\nexport type {\n  Account,\n  AppMetadata,\n  DownloadOptions,\n  Host,\n  HostQuery,\n  KeyStats,\n  PinnedSlab,\n  Sector,\n  SealedObject,\n  ShardProgress,\n  Slab,\n  UploadOptions,\n} from '../wasm/sia_storage_wasm.js'\n"],"mappings":";AAEA,OAAO,cAAc;AAUrB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAtBP,IAAI,cAAuC;AAG3C,eAAsB,UAAyB;AAC7C,MAAI,CAAC,YAAa,eAAc,SAAS;AACzC,QAAM;AACR;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/relay.ts","../src/stream/fallback.ts","../src/stream/page.ts"],"sourcesContent":["// Browser entry; lazily initializes WASM on first use.\n\nimport wasmInit from '../wasm/sia_storage_wasm.js'\n\nexport { detectPrivateRelay } from './relay'\nexport { enableStreaming, openStreams } from './stream/page'\nexport type {\n  AppCredentials,\n  CredentialsFor,\n  FileOptions,\n  SharedCredentials,\n  StreamedFile,\n  Streams,\n  StreamingOptions,\n} from './stream/page'\n\nlet initPromise: Promise<unknown> | null = null\n\n/** Initialize the WASM module. Safe to call multiple times. */\nexport async function initSia(): Promise<void> {\n  if (!initPromise) initPromise = wasmInit()\n  await initPromise\n}\n\nexport {\n  AppKey,\n  Builder,\n  KeyRecord,\n  ObjectEvent,\n  PackedUpload,\n  PinnedObject,\n  Sdk,\n  SharedSdk,\n  SharingKey,\n  encodedSize,\n  generateRecoveryPhrase,\n  setLogger,\n  validateRecoveryPhrase,\n} from '../wasm/sia_storage_wasm.js'\nexport type {\n  Account,\n  AppMetadata,\n  DownloadOptions,\n  Host,\n  HostQuery,\n  KeyStats,\n  PinnedSlab,\n  Sector,\n  SealedObject,\n  ShardProgress,\n  Slab,\n  UploadOptions,\n} from '../wasm/sia_storage_wasm.js'\n","/**\n * Whether the visitor is on iCloud Private Relay, which the SDK does not work\n * through. Show them a way to turn it off in iCloud settings.\n *\n * Asks check-relay.sia.storage, a Sia Foundation service that compares the\n * caller's address with Apple's published list of Private Relay addresses.\n * Only Safari's traffic goes through Private Relay, so other browsers resolve\n * false without a request. The answer is kept for the page's lifetime, and a\n * failure to get one resolves false.\n */\nconst RELAY_CHECK_URL = 'https://check-relay.sia.storage'\nconst TIMEOUT = 5000\n\nlet answer: Promise<boolean> | undefined\n\nexport function detectPrivateRelay(): Promise<boolean> {\n  answer ??=\n    typeof navigator === 'undefined'\n      ? Promise.resolve(false)\n      : checkPrivateRelay(navigator.userAgent, fetch)\n  return answer\n}\n\n/** `detectPrivateRelay` without the caching, for tests. */\nexport async function checkPrivateRelay(\n  userAgent: string,\n  request: typeof fetch,\n): Promise<boolean> {\n  const safari =\n    /Version\\/\\S+.*Safari\\//.test(userAgent) &&\n    !/Chrome|Chromium|CriOS|FxiOS|Edg|OPR|OPiOS|Ddg\\/|Android/.test(userAgent)\n  if (!safari) return false\n  try {\n    const response = await request(RELAY_CHECK_URL, {\n      signal: AbortSignal.timeout(TIMEOUT),\n    })\n    const body = (await response.json()) as { relay?: unknown }\n    return body.relay === true\n  } catch {\n    return false\n  }\n}\n","/**\n * Previews and downloads for pages that cannot stream through the service\n * worker, where the page reads the object itself. A preview holds the whole\n * file in memory as a Blob. A download writes straight to disk through the\n * save picker where the browser has one, and buffers a Blob where it does not.\n */\nimport type { PinnedObject, Sdk, SharedSdk } from '../../wasm/sia_storage_wasm.js'\n\ntype AnySdk = Pick<Sdk | SharedSdk, 'download'>\n\ntype Chunk = Uint8Array<ArrayBuffer>\n\n// The File System Access save picker, in Chromium only and not yet in\n// TypeScript's DOM types.\ntype SavePicker = (options: {\n  suggestedName: string\n}) => Promise<FileSystemFileHandle & { createWritable(): Promise<WritableStream<Chunk>> }>\n\nfunction chunks(stream: ReadableStream): ReadableStreamDefaultReader<Chunk> {\n  return stream.getReader() as ReadableStreamDefaultReader<Chunk>\n}\n\n/** The whole object as a Blob, stopping early when `signal` aborts. */\nexport async function readBlob(\n  sdk: AnySdk,\n  object: PinnedObject,\n  type: string | undefined,\n  onProgress: (bytesDownloaded: number) => void,\n  signal: AbortSignal,\n) {\n  const reader = chunks(sdk.download(object))\n  const onAbort = () => void reader.cancel()\n  signal.addEventListener('abort', onAbort)\n  const parts: Chunk[] = []\n  let bytesDownloaded = 0\n  try {\n    while (true) {\n      const { done, value } = await reader.read()\n      if (done) break\n      parts.push(value)\n      bytesDownloaded += value.length\n      onProgress(bytesDownloaded)\n    }\n  } finally {\n    signal.removeEventListener('abort', onAbort)\n  }\n  signal.throwIfAborted()\n  return new Blob(parts, type ? { type } : {})\n}\n\nexport function saveBlob(blob: Blob, name: string) {\n  const url = URL.createObjectURL(blob)\n  const a = document.createElement('a')\n  a.href = url\n  a.download = name\n  a.click()\n  // Some browsers cancel the download if the URL goes away in the same task.\n  setTimeout(() => URL.revokeObjectURL(url), 0)\n}\n\n/** False if the visitor closes the save picker. */\nexport async function saveToDisk(\n  sdk: AnySdk,\n  object: PinnedObject,\n  name: string,\n  type: string | undefined,\n  onProgress: (bytesDownloaded: number) => void,\n) {\n  const picker = (window as { showSaveFilePicker?: SavePicker })\n    .showSaveFilePicker\n  if (!picker) {\n    const blob = await readBlob(\n      sdk,\n      object,\n      type,\n      onProgress,\n      new AbortController().signal,\n    )\n    saveBlob(blob, name)\n    return true\n  }\n\n  // The picker must open inside the click that asked for it, so nothing is\n  // awaited before this call.\n  let handle: Awaited<ReturnType<SavePicker>>\n  try {\n    handle = await picker.call(window, { suggestedName: name })\n  } catch (e) {\n    if (e instanceof DOMException && e.name === 'AbortError') return false\n    throw e\n  }\n  let bytesDownloaded = 0\n  const progress = new TransformStream<Chunk, Chunk>({\n    transform(chunk, controller) {\n      bytesDownloaded += chunk.length\n      onProgress(bytesDownloaded)\n      controller.enqueue(chunk)\n    },\n  })\n  const file = await handle.createWritable()\n  await (sdk.download(object) as ReadableStream<Chunk>)\n    .pipeThrough(progress)\n    .pipeTo(file)\n  return true\n}\n","/**\n * The page side of streaming.\n *\n * `openStreams` hands out same-origin URLs that the library's service worker\n * answers with ranged reads of an object, so a `<video>` seeks without loading\n * the whole file and a download goes to the browser's download manager instead\n * of the page's memory. The worker connects its own SDK of the same kind, with\n * credentials this page hands it over a message port and it keeps in memory.\n * Where the worker is unavailable, the same calls read the object in the page.\n */\nimport type {\n  AppKey,\n  AppMetadata,\n  PinnedObject,\n  SealedObject,\n  Sdk,\n  SharedSdk,\n} from '../../wasm/sia_storage_wasm.js'\nimport { reportStreamError, streamErrorMessage } from './errors'\nimport { readBlob, saveToDisk } from './fallback'\nimport {\n  type ClientReply,\n  type Connection,\n  isAppMetadata,\n  type PageMessage,\n  requestReply,\n  type SourceReply,\n  streamPath,\n  type WorkerMessage,\n} from './protocol'\n\nexport type StreamingOptions = {\n  /** Where the site serves the worker file. Defaults to `/sia-storage-sw.js`. */\n  workerUrl?: string\n  /** The worker's scope. Defaults to the directory `workerUrl` is in. */\n  scope?: string\n  /** `'module'` when `workerUrl` is an ES module worker of your own. */\n  type?: WorkerType\n}\n\n/** What a `SharedSdk` was connected with. */\nexport type SharedCredentials = { indexerUrl: string; seed: string }\n\n/** What an `Sdk`'s `Builder` was made with. The key comes from `sdk.appKey()`. */\nexport type AppCredentials = { indexerUrl: string; appMeta: AppMetadata }\n\n/** The credentials `openStreams` takes for each kind of SDK. */\nexport type CredentialsFor<S extends Sdk | SharedSdk> = S extends SharedSdk\n  ? SharedCredentials\n  : AppCredentials\n\nexport type FileOptions = {\n  /** Used for downloads and for the browser's media handling. */\n  name: string\n  /** The MIME type. Defaults to `application/octet-stream`. */\n  type?: string\n  /** A failure after streaming started. Without it, failures are logged. */\n  onError?: (message: string) => void\n  /** Bytes read so far, when the page reads the object itself. */\n  onProgress?: (bytesDownloaded: number) => void\n}\n\n/** A URL for an `<img>`, `<video>`, `<audio>`, `<iframe>` or `fetch`. */\nexport type StreamedFile = {\n  url: string\n  /** The whole file, when the page read it itself instead of streaming. */\n  blob?: Blob\n  /** Frees the URL. Call it when the element showing it goes away. */\n  release(): void\n}\n\nexport type Streams = {\n  /** A URL serving the object. Streams where it can, else reads it whole. */\n  url(\n    object: PinnedObject,\n    options: FileOptions & { signal?: AbortSignal },\n  ): Promise<StreamedFile>\n  /**\n   * Saves the object, from a click handler. Streams to the browser's download\n   * manager where it can, else opens the save picker, else saves a Blob.\n   * Awaits nothing before the picker opens, so the browser still counts it as\n   * part of the click.\n   */\n  download(\n    object: PinnedObject,\n    options: FileOptions,\n  ): Promise<'streaming' | 'saved' | 'cancelled'>\n  /**\n   * Cancels the streams this handle made. Other handles on the same SDK keep\n   * theirs. Call it when you stop using the handle.\n   */\n  close(): void\n}\n\nconst DEFAULT_WORKER_URL = '/sia-storage-sw.js'\n// Covers registering the worker, its first activation, and the handshake.\nconst SETUP_TIMEOUT = 5000\n\n/** A stream URL this page handed out, and what the worker needs to serve it. */\ntype StreamEntry = {\n  handle: Opened\n  objectId: string\n  sealed: SealedObject | undefined\n  size: number\n  name: string\n  mime: string\n  onError: ((message: string) => void) | undefined\n}\n\n/**\n * One `openStreams` call, and how the worker reconnects its SDK. Each call gets\n * its own session, so closing one handle leaves another on the same SDK open.\n */\ntype Opened = { session: string; connection: Connection; appKey?: AppKey }\n\nconst entries = new Map<string, StreamEntry>()\nconst opened = new Set<Opened>()\nlet worker: { clientId: string; scope: string } | undefined\nlet initialization: Promise<boolean> | undefined\nlet initOptions: StreamingOptions = {}\n// The page's controller when setup last failed. Undefined unless it failed.\nlet failedController: ServiceWorker | null | undefined\n\n/**\n * Registers the streaming worker and resolves whether this page can stream.\n * `openStreams` calls it with the defaults, so call it yourself only to pass\n * options, and before the first `openStreams`. Later calls return the first\n * call's answer, except when setup failed or timed out and a different worker\n * has since taken control of the page. Then the next call tries again, with\n * the first call's options.\n */\nexport function enableStreaming(\n  options: StreamingOptions = {},\n): Promise<boolean> {\n  if (!initialization) {\n    initOptions = options\n  } else if (failedController === undefined) {\n    return initialization\n  } else {\n    // Only a new controller is worth a retry. Retrying against the same one,\n    // or none, would wait out SETUP_TIMEOUT again on every call.\n    const controller = navigator.serviceWorker.controller\n    if (!controller || controller === failedController) return initialization\n  }\n  failedController = undefined\n  initialization = initialize(initOptions).catch(() => {\n    failedController = navigator.serviceWorker.controller\n    return false\n  })\n  return initialization\n}\n\nasync function initialize({\n  workerUrl = DEFAULT_WORKER_URL,\n  scope,\n  type,\n}: StreamingOptions) {\n  if (\n    typeof window === 'undefined' ||\n    !('serviceWorker' in navigator) ||\n    !window.isSecureContext\n  ) {\n    return false\n  }\n  const { serviceWorker } = navigator\n  serviceWorker.addEventListener('message', onWorkerMessage)\n  const deadline = AbortSignal.timeout(SETUP_TIMEOUT)\n  // A hard reload (Shift+Reload) loads the page without its worker, and an\n  // active worker only claims pages when it first activates. Waiting would\n  // run out the whole deadline, so fall back at once.\n  const existing = await within(serviceWorker.getRegistration(), deadline)\n  if (existing?.active && !serviceWorker.controller) return false\n  const registration = await within(\n    serviceWorker\n      .register(workerUrl, { ...(scope && { scope }), ...(type && { type }) })\n      .then(() => serviceWorker.ready),\n    deadline,\n  )\n  // On a first visit, the page is controlled once the new worker claims it.\n  if (!serviceWorker.controller) {\n    await within(\n      new Promise((resolve) =>\n        serviceWorker.addEventListener('controllerchange', resolve, {\n          once: true,\n        }),\n      ),\n      deadline,\n    )\n  }\n  const controller = serviceWorker.controller\n  if (!controller) return false\n  const request = { type: 'sia-client' } satisfies PageMessage\n  const reply = (await requestReply(controller, request, {\n    signal: deadline,\n  })) as ClientReply\n  if (!reply.supported) return false\n  worker = { clientId: reply.clientId, scope: registration.scope }\n  return true\n}\n\n/** `promise`, or a rejection if `signal` aborts first. */\nfunction within<T>(promise: Promise<T>, signal: AbortSignal): Promise<T> {\n  return new Promise((resolve, reject) => {\n    signal.throwIfAborted()\n    signal.addEventListener('abort', () => reject(signal.reason), {\n      once: true,\n    })\n    promise.then(resolve, reject)\n  })\n}\n\n/**\n * Previews and downloads for one SDK's objects, from an `Sdk` or a `SharedSdk`.\n *\n * The worker cannot use this page's SDK, so it connects its own with\n * `credentials`: the indexer URL and seed a `SharedSdk` was connected with, or\n * the indexer URL and app metadata an `Sdk`'s `Builder` was made with.\n */\nexport function openStreams<S extends Sdk | SharedSdk>(\n  sdk: S,\n  credentials: CredentialsFor<S>,\n): Streams {\n  const handle = openedFor(sdk, credentials)\n  opened.add(handle)\n  // Started now, so it has usually finished by the first download click,\n  // which cannot wait for it.\n  void enableStreaming()\n  return {\n    async url(object, options) {\n      await enableStreaming()\n      options.signal?.throwIfAborted()\n      const stream = streamUrl(handle, object, options)\n      if (stream) return stream\n      const blob = await readBlob(\n        sdk,\n        object,\n        options.type,\n        options.onProgress ?? (() => {}),\n        options.signal ?? new AbortController().signal,\n      )\n      const url = URL.createObjectURL(blob)\n      return { url, blob, release: () => URL.revokeObjectURL(url) }\n    },\n    async download(object, options) {\n      const stream = streamUrl(handle, object, options)\n      if (stream) {\n        // A hidden frame, so a worker error loads there instead of replacing\n        // the page. Nothing signals when the download has started, so it stays.\n        const frame = document.createElement('iframe')\n        frame.hidden = true\n        frame.src = `${stream.url}?download=1`\n        document.body.append(frame)\n        // Never released here. The URL stays valid until `close()`, so\n        // delayed starts and browser retries still work.\n        return 'streaming'\n      }\n      const saved = await saveToDisk(\n        sdk,\n        object,\n        options.name,\n        options.type,\n        options.onProgress ?? (() => {}),\n      )\n      return saved ? 'saved' : 'cancelled'\n    },\n    close() {\n      releaseStreams(handle)\n    },\n  }\n}\n\n/**\n * Checked at runtime too, for callers without types. An `Sdk` is told apart\n * by its `appKey()`, which a `SharedSdk` does not have.\n */\nfunction openedFor(sdk: Sdk | SharedSdk, credentials: unknown): Opened {\n  const { indexerUrl, seed, appMeta } = (credentials ?? {}) as {\n    indexerUrl?: unknown\n    seed?: unknown\n    appMeta?: unknown\n  }\n  const session = crypto.randomUUID()\n  if (typeof (sdk as Partial<Sdk>).appKey === 'function') {\n    if (typeof indexerUrl !== 'string' || !isAppMetadata(appMeta)) {\n      throw new TypeError('openStreams(Sdk) needs { indexerUrl, appMeta }.')\n    }\n    const appKey = (sdk as Sdk).appKey()\n    const connection: Connection = {\n      kind: 'app',\n      indexerUrl,\n      appKey: toHex(appKey.export()),\n      appMeta,\n    }\n    return { session, connection, appKey }\n  }\n  if (typeof indexerUrl !== 'string' || typeof seed !== 'string') {\n    throw new TypeError('openStreams(SharedSdk) needs { indexerUrl, seed }.')\n  }\n  return { session, connection: { kind: 'shared', indexerUrl, seed } }\n}\n\nfunction toHex(bytes: Uint8Array) {\n  return Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('')\n}\n\nfunction streamUrl(\n  handle: Opened,\n  object: PinnedObject,\n  { name, type, onError }: FileOptions,\n): StreamedFile | undefined {\n  if (!worker || !navigator.serviceWorker.controller || !opened.has(handle)) {\n    return undefined\n  }\n  const token = crypto.randomUUID()\n  entries.set(token, {\n    handle,\n    objectId: object.id(),\n    sealed: handle.appKey && object.seal(handle.appKey),\n    size: object.size(),\n    name,\n    mime: type || 'application/octet-stream',\n    onError,\n  })\n  return {\n    url: streamPath(worker.scope, worker.clientId, token),\n    release() {\n      entries.delete(token)\n      const message = { type: 'sia-release', token } satisfies PageMessage\n      navigator.serviceWorker.controller?.postMessage(message)\n    },\n  }\n}\n\nfunction releaseStreams(handle: Opened) {\n  for (const [token, entry] of entries) {\n    if (entry.handle === handle) entries.delete(token)\n  }\n  if (!opened.delete(handle)) return\n  const message = {\n    type: 'sia-release-share',\n    session: handle.session,\n  } satisfies PageMessage\n  navigator.serviceWorker.controller?.postMessage(message)\n}\n\nfunction onWorkerMessage(event: MessageEvent) {\n  if (event.source !== navigator.serviceWorker.controller) return\n  const data = event.data as WorkerMessage | undefined\n  if (data?.type === 'sia-stream-error') {\n    const entry = entries.get(data.token)\n    if (!entry) return\n    const { offset, length } = data\n    const range =\n      offset !== undefined && length !== undefined\n        ? { offset, length }\n        : undefined\n    if (entry.onError) entry.onError(streamErrorMessage(data.message))\n    else reportStreamError(data.message, entry.name, range)\n  } else if (data?.type === 'sia-source') {\n    const port = event.ports[0]\n    if (!port) return\n    const entry = entries.get(data.token)\n    const reply: SourceReply =\n      entry\n        ? {\n            type: 'source',\n            session: entry.handle.session,\n            connection: entry.handle.connection,\n            objectId: entry.objectId,\n            ...(entry.sealed && { sealed: entry.sealed }),\n            size: entry.size,\n            mime: entry.mime,\n            name: entry.name,\n          }\n        : { type: 'error' }\n    port.postMessage(reply)\n    port.close()\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.node.cjs

@@ -29,40 +29,62 @@ __export(index_node_exports, {
   Sdk: () => Sdk,
   SharedSdk: () => SharedSdk,
   SharingKey: () => SharingKey,
+  detectPrivateRelay: () => detectPrivateRelay,
+  enableStreaming: () => enableStreaming,
   encodedSize: () => encodedSize,
   generateRecoveryPhrase: () => generateRecoveryPhrase,
   initSia: () => initSia,
+  openStreams: () => openStreams,
   setLogger: () => setLogger,
   validateRecoveryPhrase: () => validateRecoveryPhrase
 });
 module.exports = __toCommonJS(index_node_exports);
 
+// src/node/platforms.ts
+var NATIVE_PACKAGES = {
+  "darwin-arm64": "@siafoundation/sia-storage-darwin-arm64",
+  "darwin-x64": "@siafoundation/sia-storage-darwin-x64",
+  "linux-x64": "@siafoundation/sia-storage-linux-x64-gnu",
+  "linux-arm64": "@siafoundation/sia-storage-linux-arm64-gnu",
+  "win32-x64": "@siafoundation/sia-storage-win32-x64-msvc"
+};
+
 // src/node/load.ts
 var addon = null;
 function loadNativeAddon() {
   if (addon) return addon;
-  const platform = process.platform;
-  const arch = process.arch;
+  const target = `${process.platform}-${process.arch}`;
+  let cause;
   try {
-    if (platform === "darwin" && arch === "arm64") {
+    if (target === "darwin-arm64") {
       addon = require("@siafoundation/sia-storage-darwin-arm64");
-    } else if (platform === "darwin" && arch === "x64") {
+    } else if (target === "darwin-x64") {
       addon = require("@siafoundation/sia-storage-darwin-x64");
-    } else if (platform === "linux" && arch === "x64") {
+    } else if (target === "linux-x64") {
       addon = require("@siafoundation/sia-storage-linux-x64-gnu");
-    } else if (platform === "linux" && arch === "arm64") {
+    } else if (target === "linux-arm64") {
       addon = require("@siafoundation/sia-storage-linux-arm64-gnu");
-    } else if (platform === "win32" && arch === "x64") {
+    } else if (target === "win32-x64") {
       addon = require("@siafoundation/sia-storage-win32-x64-msvc");
     }
-  } catch {
+  } catch (error) {
+    cause = error;
   }
-  if (!addon) {
-    throw new Error(
-      `@siafoundation/sia-storage: Native addon not found for ${platform}-${arch}. Install @siafoundation/sia-storage-${platform}-${arch} or use the browser/WASM build.`
+  if (!addon) throw addonLoadError(target, cause);
+  return addon;
+}
+function addonLoadError(target, cause) {
+  const packageName = NATIVE_PACKAGES[target];
+  if (!packageName) {
+    return new Error(
+      `@siafoundation/sia-storage: no native addon is published for ${target}. Use the browser/WASM build.`
     );
   }
-  return addon;
+  const reason = cause instanceof Error ? cause.message : String(cause);
+  return new Error(
+    `@siafoundation/sia-storage: could not load the native addon for ${target} from ${packageName}: ${reason}`,
+    { cause }
+  );
 }
 
 // src/node/napi.ts
@@ -85,6 +107,21 @@ var {
 async function initSia() {
   loadNativeAddon();
 }
+
+// src/index.node.ts
+async function detectPrivateRelay() {
+  return false;
+}
+async function enableStreaming() {
+  return false;
+}
+function openStreams() {
+  const unavailable = () => Promise.reject(
+    new Error("openStreams is for browser pages. In Node, use sdk.download().")
+  );
+  return { url: unavailable, download: unavailable, close() {
+  } };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AppKey,
@@ -96,9 +133,12 @@ async function initSia() {
   Sdk,
   SharedSdk,
   SharingKey,
+  detectPrivateRelay,
+  enableStreaming,
   encodedSize,
   generateRecoveryPhrase,
   initSia,
+  openStreams,
   setLogger,
   validateRecoveryPhrase
 });

package/dist/index.node.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.node.ts","../src/node/load.ts","../src/node/napi.ts"],"sourcesContent":["export * from './node/napi'\nexport type * from './node/napi'\n","import type * as Addon from './napi.generated'\n\nlet addon: typeof Addon | null = null\n\nexport function loadNativeAddon(): typeof Addon {\n  if (addon) return addon\n\n  const platform = process.platform\n  const arch = process.arch\n\n  try {\n    if (platform === 'darwin' && arch === 'arm64') {\n      addon = require('@siafoundation/sia-storage-darwin-arm64')\n    } else if (platform === 'darwin' && arch === 'x64') {\n      addon = require('@siafoundation/sia-storage-darwin-x64')\n    } else if (platform === 'linux' && arch === 'x64') {\n      addon = require('@siafoundation/sia-storage-linux-x64-gnu')\n    } else if (platform === 'linux' && arch === 'arm64') {\n      addon = require('@siafoundation/sia-storage-linux-arm64-gnu')\n    } else if (platform === 'win32' && arch === 'x64') {\n      addon = require('@siafoundation/sia-storage-win32-x64-msvc')\n    }\n  } catch {}\n\n  if (!addon) {\n    throw new Error(\n      `@siafoundation/sia-storage: Native addon not found for ${platform}-${arch}. ` +\n        `Install @siafoundation/sia-storage-${platform}-${arch} or use the browser/WASM build.`,\n    )\n  }\n\n  return addon\n}\n","import { loadNativeAddon } from './load'\n\nconst addon = loadNativeAddon()\n\nexport const {\n  AppKey,\n  Builder,\n  Sdk,\n  PinnedObject,\n  PackedUpload,\n  ObjectEvent,\n  SharingKey,\n  KeyRecord,\n  SharedSdk,\n  generateRecoveryPhrase,\n  validateRecoveryPhrase,\n  setLogger,\n  encodedSize,\n} = addon\n\nexport type * from './napi.generated'\n\n/** Force-load the native addon to surface missing-binary errors at startup. */\nexport async function initSia(): Promise<void> {\n  loadNativeAddon()\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,IAAI,QAA6B;AAE1B,SAAS,kBAAgC;AAC9C,MAAI,MAAO,QAAO;AAElB,QAAM,WAAW,QAAQ;AACzB,QAAM,OAAO,QAAQ;AAErB,MAAI;AACF,QAAI,aAAa,YAAY,SAAS,SAAS;AAC7C,cAAQ,QAAQ,yCAAyC;AAAA,IAC3D,WAAW,aAAa,YAAY,SAAS,OAAO;AAClD,cAAQ,QAAQ,uCAAuC;AAAA,IACzD,WAAW,aAAa,WAAW,SAAS,OAAO;AACjD,cAAQ,QAAQ,0CAA0C;AAAA,IAC5D,WAAW,aAAa,WAAW,SAAS,SAAS;AACnD,cAAQ,QAAQ,4CAA4C;AAAA,IAC9D,WAAW,aAAa,WAAW,SAAS,OAAO;AACjD,cAAQ,QAAQ,2CAA2C;AAAA,IAC7D;AAAA,EACF,QAAQ;AAAA,EAAC;AAET,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR,0DAA0D,QAAQ,IAAI,IAAI,wCAClC,QAAQ,IAAI,IAAI;AAAA,IAC1D;AAAA,EACF;AAEA,SAAO;AACT;;;AC9BA,IAAMA,SAAQ,gBAAgB;AAEvB,IAAM;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,IAAIA;AAKJ,eAAsB,UAAyB;AAC7C,kBAAgB;AAClB;","names":["addon"]}
+{"version":3,"sources":["../src/index.node.ts","../src/node/platforms.ts","../src/node/load.ts","../src/node/napi.ts"],"sourcesContent":["export * from './node/napi'\nexport type * from './node/napi'\n\n/** Node's traffic never goes through iCloud Private Relay, which is Safari's. */\nexport async function detectPrivateRelay(): Promise<boolean> {\n  return false\n}\n\n// openStreams hands a browser page URLs that a service worker serves. Node\n// streams objects with sdk.download() directly, so these only let code shared\n// with the browser import them, and server rendering call them, without\n// crashing.\nexport async function enableStreaming(): Promise<boolean> {\n  return false\n}\n\nexport function openStreams() {\n  const unavailable = () =>\n    Promise.reject(\n      new Error('openStreams is for browser pages. In Node, use sdk.download().'),\n    )\n  return { url: unavailable, download: unavailable, close() {} }\n}\n","/**\n * The npm package that ships the native addon for each platform, keyed by\n * `${process.platform}-${process.arch}`. The Linux and Windows packages name\n * the C library or toolchain their binary was built against, so a package\n * name is not always the platform key with a prefix.\n *\n * scripts/publish.ts publishes these and lists them as the main package's\n * optionalDependencies.\n */\nexport const NATIVE_PACKAGES: Record<string, string> = {\n  'darwin-arm64': '@siafoundation/sia-storage-darwin-arm64',\n  'darwin-x64': '@siafoundation/sia-storage-darwin-x64',\n  'linux-x64': '@siafoundation/sia-storage-linux-x64-gnu',\n  'linux-arm64': '@siafoundation/sia-storage-linux-arm64-gnu',\n  'win32-x64': '@siafoundation/sia-storage-win32-x64-msvc',\n}\n","import type * as Addon from './napi.generated'\nimport { NATIVE_PACKAGES } from './platforms'\n\nlet addon: typeof Addon | null = null\n\nexport function loadNativeAddon(): typeof Addon {\n  if (addon) return addon\n\n  const target = `${process.platform}-${process.arch}`\n  let cause: unknown\n\n  // One literal require per package, rather than require(NATIVE_PACKAGES[...]),\n  // so bundlers, including `bun build --compile`, can find and embed the addon.\n  try {\n    if (target === 'darwin-arm64') {\n      addon = require('@siafoundation/sia-storage-darwin-arm64')\n    } else if (target === 'darwin-x64') {\n      addon = require('@siafoundation/sia-storage-darwin-x64')\n    } else if (target === 'linux-x64') {\n      addon = require('@siafoundation/sia-storage-linux-x64-gnu')\n    } else if (target === 'linux-arm64') {\n      addon = require('@siafoundation/sia-storage-linux-arm64-gnu')\n    } else if (target === 'win32-x64') {\n      addon = require('@siafoundation/sia-storage-win32-x64-msvc')\n    }\n  } catch (error) {\n    cause = error\n  }\n\n  if (!addon) throw addonLoadError(target, cause)\n  return addon\n}\n\n/**\n * Why the addon could not load. A missing package and a binary that fails to\n * load read differently, so the require error is kept as the cause and its\n * message is part of this one.\n */\nexport function addonLoadError(target: string, cause: unknown): Error {\n  const packageName = NATIVE_PACKAGES[target]\n  if (!packageName) {\n    return new Error(\n      `@siafoundation/sia-storage: no native addon is published for ${target}. ` +\n        'Use the browser/WASM build.',\n    )\n  }\n  const reason = cause instanceof Error ? cause.message : String(cause)\n  return new Error(\n    `@siafoundation/sia-storage: could not load the native addon for ${target} ` +\n      `from ${packageName}: ${reason}`,\n    { cause },\n  )\n}\n","import { loadNativeAddon } from './load'\n\nconst addon = loadNativeAddon()\n\nexport const {\n  AppKey,\n  Builder,\n  Sdk,\n  PinnedObject,\n  PackedUpload,\n  ObjectEvent,\n  SharingKey,\n  KeyRecord,\n  SharedSdk,\n  generateRecoveryPhrase,\n  validateRecoveryPhrase,\n  setLogger,\n  encodedSize,\n} = addon\n\nexport type * from './napi.generated'\n\n/** Force-load the native addon to surface missing-binary errors at startup. */\nexport async function initSia(): Promise<void> {\n  loadNativeAddon()\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACSO,IAAM,kBAA0C;AAAA,EACrD,gBAAgB;AAAA,EAChB,cAAc;AAAA,EACd,aAAa;AAAA,EACb,eAAe;AAAA,EACf,aAAa;AACf;;;ACZA,IAAI,QAA6B;AAE1B,SAAS,kBAAgC;AAC9C,MAAI,MAAO,QAAO;AAElB,QAAM,SAAS,GAAG,QAAQ,QAAQ,IAAI,QAAQ,IAAI;AAClD,MAAI;AAIJ,MAAI;AACF,QAAI,WAAW,gBAAgB;AAC7B,cAAQ,QAAQ,yCAAyC;AAAA,IAC3D,WAAW,WAAW,cAAc;AAClC,cAAQ,QAAQ,uCAAuC;AAAA,IACzD,WAAW,WAAW,aAAa;AACjC,cAAQ,QAAQ,0CAA0C;AAAA,IAC5D,WAAW,WAAW,eAAe;AACnC,cAAQ,QAAQ,4CAA4C;AAAA,IAC9D,WAAW,WAAW,aAAa;AACjC,cAAQ,QAAQ,2CAA2C;AAAA,IAC7D;AAAA,EACF,SAAS,OAAO;AACd,YAAQ;AAAA,EACV;AAEA,MAAI,CAAC,MAAO,OAAM,eAAe,QAAQ,KAAK;AAC9C,SAAO;AACT;AAOO,SAAS,eAAe,QAAgB,OAAuB;AACpE,QAAM,cAAc,gBAAgB,MAAM;AAC1C,MAAI,CAAC,aAAa;AAChB,WAAO,IAAI;AAAA,MACT,gEAAgE,MAAM;AAAA,IAExE;AAAA,EACF;AACA,QAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,SAAO,IAAI;AAAA,IACT,mEAAmE,MAAM,SAC/D,WAAW,KAAK,MAAM;AAAA,IAChC,EAAE,MAAM;AAAA,EACV;AACF;;;AClDA,IAAMA,SAAQ,gBAAgB;AAEvB,IAAM;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,IAAIA;AAKJ,eAAsB,UAAyB;AAC7C,kBAAgB;AAClB;;;AHrBA,eAAsB,qBAAuC;AAC3D,SAAO;AACT;AAMA,eAAsB,kBAAoC;AACxD,SAAO;AACT;AAEO,SAAS,cAAc;AAC5B,QAAM,cAAc,MAClB,QAAQ;AAAA,IACN,IAAI,MAAM,gEAAgE;AAAA,EAC5E;AACF,SAAO,EAAE,KAAK,aAAa,UAAU,aAAa,QAAQ;AAAA,EAAC,EAAE;AAC/D;","names":["addon"]}

package/dist/index.node.d.ts

@@ -115,6 +115,8 @@ export declare class PackedUpload {
   length(): bigint
   /** Returns the number of slabs in the upload. */
   slabs(): bigint
+  /** Returns the optimal size of each slab in bytes. */
+  optimalDataSize(): bigint
   /**
    * Adds a new object to the upload. The data is read until EOF and packed into
    * the current slab. Returns the number of bytes consumed; call
@@ -233,8 +235,8 @@ export declare class Sdk {
    * of the object's data.
    */
   download(object: PinnedObject, options?: DownloadOptions | undefined | null): ReadableStream
-  /** Returns a list of all usable hosts. */
-  hosts(): Promise<Array<Host>>
+  /** Returns a list of usable hosts, optionally filtered by a query. */
+  hosts(query?: HostQuery | undefined | null): Promise<Array<Host>>
   /** Returns object events from the indexer for syncing. */
   objectEvents(cursor: ObjectsCursor | undefined | null, limit: number): Promise<Array<ObjectEvent>>
   /** Updates the metadata of an object stored in the indexer. */
@@ -276,11 +278,11 @@ export declare class SharedSdk {
   /** Lists and decrypts a page of the objects the key grants access to. */
   objects(offset: number, limit: number): Promise<Array<PinnedObject>>
   /**
-   * Returns the hosts serving this key's objects. Mirrors `Sdk.hosts()` but
-   * is scoped to the sharing key, so the set is already limited to hosts
-   * holding its objects.
+   * Returns the hosts serving this key's objects, optionally filtered by a
+   * query. Mirrors `Sdk.hosts()` but is scoped to the sharing key, so the
+   * set is already limited to hosts holding its objects.
    */
-  hosts(): Promise<Array<Host>>
+  hosts(query?: HostQuery | undefined | null): Promise<Array<Host>>
   /** Streams a shared object's data, paying hosts with the owner's tokens. */
   download(object: PinnedObject, options?: DownloadOptions | undefined | null): ReadableStream
 }
@@ -353,6 +355,12 @@ export declare function encodedSize(size: bigint, dataShards: number, parityShar
 /** Generates a new BIP-39 12-word recovery phrase. */
 export declare function generateRecoveryPhrase(): string
 
+/** Geographic coordinates used to sort hosts by proximity. */
+export interface GeoLocation {
+  latitude: number
+  longitude: number
+}
+
 /** Information about a storage provider on the Sia network. */
 export interface Host {
   publicKey: string
@@ -363,6 +371,15 @@ export interface Host {
   goodForUpload: boolean
 }
 
+/** Query parameters for filtering hosts. */
+export interface HostQuery {
+  location?: GeoLocation
+  protocol?: AddressProtocol
+  country?: string
+  limit?: number
+  offset?: number
+}
+
 /**
  * A snapshot of what a sharing key grants access to. The counts reflect the
  * moment the record was fetched, not a live view.
@@ -465,3 +482,12 @@ export interface UploadOptions {
 export declare function validateRecoveryPhrase(phrase: string): void
 
 export declare function initSia(): Promise<void>
+export declare function detectPrivateRelay(): Promise<boolean>
+/** Always false. Service worker streaming is for browser pages. */
+export declare function enableStreaming(options?: { workerUrl?: string; scope?: string; type?: 'classic' | 'module' }): Promise<boolean>
+/** For browser pages. In Node, `url` and `download` reject, and `sdk.download()` streams objects directly. */
+export declare function openStreams(sdk: object, credentials: { indexerUrl: string; appMeta: AppMetadata } | { indexerUrl: string; seed: string }): {
+  url(object: PinnedObject, options: { name: string; type?: string }): Promise<never>
+  download(object: PinnedObject, options: { name: string; type?: string }): Promise<never>
+  close(): void
+}

package/dist/next.d.ts

@@ -0,0 +1,3 @@
+declare function GET(): Response;
+
+export { GET };