@earthmover/icechunk 2.0.0-alpha.10 → 2.0.0-alpha.12

package/README.md

@@ -46,14 +46,30 @@ In-memory storage works on all platforms. The following backends are available o
 - **HTTP** — `Storage.newHttp(baseUrl, config?)`
 - **Local Filesystem** — `Storage.newLocalFilesystem(path)`
 
+### Fetch Storage (read-only, works everywhere)
+
+For read-only access to a publicly hosted Icechunk repository, use the built-in fetch-based storage. This works on both native and WASM builds, making it the easiest way to open a repository in the browser:
+
+```typescript
+import { Repository } from '@earthmover/icechunk'
+import { createFetchStorage } from '@earthmover/icechunk/fetch-storage'
+
+const storage = createFetchStorage('https://my-bucket.s3.us-west-2.amazonaws.com/my-repo.icechunk')
+const repo = await Repository.open(storage)
+const session = await repo.readonlySession({ branch: 'main' })
+const keys = await session.store.list()
+```
+
+The repository must be on S3-compatible storage with public read access and XML listing enabled. `createFetchStorage` uses the browser `fetch` API under the hood, so it works in any environment where `fetch` is available.
+
 ### Custom Storage Backends
 
 For WASM builds (or any environment where the built-in backends aren't suitable), you can provide your own storage implementation in JavaScript using `Storage.newCustom()`:
 
 ```typescript
 const storage = Storage.newCustom({
-  canWrite: async () => true,
-  getObjectRange: async ({ path, rangeStart, rangeEnd }) => {
+  canWrite: async (_err, ) => true,
+  getObjectRange: async (_err, { path, rangeStart, rangeEnd }) => {
     const headers: Record<string, string> = {}
     if (rangeStart != null && rangeEnd != null) {
       headers['Range'] = `bytes=${rangeStart}-${rangeEnd - 1}`
@@ -61,15 +77,17 @@ const storage = Storage.newCustom({
     const resp = await fetch(`https://my-bucket.example.com/${path}`, { headers })
     return { data: new Uint8Array(await resp.arrayBuffer()), version: { etag: resp.headers.get('etag') ?? undefined } }
   },
-  putObject: async ({ path, data, contentType }) => { /* ... */ },
-  copyObject: async ({ from, to }) => { /* ... */ },
-  listObjects: async (prefix) => { /* return [{ id, createdAt, sizeBytes }] */ },
-  deleteBatch: async ({ prefix, batch }) => { /* return { deletedObjects, deletedBytes } */ },
-  getObjectLastModified: async (path) => { /* return Date */ },
-  getObjectConditional: async ({ path, previousVersion }) => { /* ... */ },
+  putObject: async (_err, { path, data, contentType }) => { /* ... */ },
+  copyObject: async (_err, { from, to }) => { /* ... */ },
+  listObjects: async (_err, prefix) => { /* return [{ id, createdAt, sizeBytes }] */ },
+  deleteBatch: async (_err, { prefix, batch }) => { /* return { deletedObjects, deletedBytes } */ },
+  getObjectLastModified: async (_err, path) => { /* return Date */ },
+  getObjectConditional: async (_err, { path, previousVersion }) => { /* ... */ },
 })
 ```
 
+> **Note:** Callbacks use the Node.js error-first convention — the first argument is always `null` (reserved for errors) and the actual arguments follow. Use `_err` to skip it.
+
 This is the primary way to use cloud storage in the browser, where native Rust networking is unavailable. Each callback method maps to an operation on the underlying `Storage` trait. See the exported `Storage*` TypeScript interfaces for the full type signatures.
 
 ### Virtual Chunks
@@ -84,6 +102,18 @@ Install the package with the `--cpu=wasm32` flag to get the WASM binary:
 npm install @earthmover/icechunk --cpu=wasm32
 ```
 
+To open a public repository in the browser, use fetch storage:
+
+```typescript
+import { Repository } from '@earthmover/icechunk'
+import { createFetchStorage } from '@earthmover/icechunk/fetch-storage'
+
+const storage = createFetchStorage('https://my-bucket.s3.us-west-2.amazonaws.com/my-repo.icechunk')
+const repo = await Repository.open(storage)
+```
+
+For more control, use `Storage.newCustom()` to implement your own storage backend with any JS networking library.
+
 The WASM build uses `SharedArrayBuffer` for threading, which requires your server to send these headers:
 
 ```

package/fetch-storage.d.ts

@@ -0,0 +1,20 @@
+import type { Storage } from '@earthmover/icechunk'
+
+/**
+ * Create a read-only storage backend that fetches objects over HTTP.
+ *
+ * Works with any publicly accessible icechunk repository hosted on S3-compatible
+ * storage. Requires the bucket to support anonymous reads and S3 XML listing.
+ *
+ * @param baseUrl - Base URL of the icechunk repository (no trailing slash)
+ *
+ * @example
+ * ```ts
+ * import { Repository } from '@earthmover/icechunk'
+ * import { createFetchStorage } from '@earthmover/icechunk/fetch-storage'
+ *
+ * const storage = createFetchStorage('https://my-bucket.s3.us-west-2.amazonaws.com/path/to/repo.icechunk')
+ * const repo = await Repository.open(storage)
+ * ```
+ */
+export declare function createFetchStorage(baseUrl: string): Storage

package/fetch-storage.js

@@ -0,0 +1,130 @@
+/**
+ * Read-only fetch-based storage backend for Icechunk.
+ *
+ * Usage:
+ *   import { Repository } from '@earthmover/icechunk'
+ *   import { createFetchStorage } from '@earthmover/icechunk/fetch-storage'
+ *
+ *   const storage = createFetchStorage('https://my-bucket.s3.amazonaws.com/my-repo.icechunk')
+ *   const repo = await Repository.open(storage)
+ */
+
+const { Storage } = require('@earthmover/icechunk')
+
+/**
+ * @param {string} baseUrl - Base URL of the icechunk repository (no trailing slash)
+ * @returns {Storage}
+ */
+function createFetchStorage(baseUrl) {
+  // Normalize: strip trailing slash
+  const base = baseUrl.replace(/\/+$/, '')
+
+  function throwForStatus(resp, url) {
+    if (resp.ok) return
+    if (resp.status === 404) {
+      throw new Error(`ObjectNotFound: ${url}`)
+    }
+    throw new Error(`HTTP ${resp.status}: ${url}`)
+  }
+
+  return Storage.newCustom({
+    canWrite: async (_err) => false,
+
+    getObjectRange: async (_err, { path, rangeStart, rangeEnd }) => {
+      const url = `${base}/${path}`
+      const headers = {}
+
+      if (rangeStart != null && rangeEnd != null) {
+        headers['Range'] = `bytes=${rangeStart}-${rangeEnd - 1}`
+      } else if (rangeStart != null) {
+        headers['Range'] = `bytes=${rangeStart}-`
+      }
+
+      const resp = await fetch(url, { headers })
+      throwForStatus(resp, url)
+
+      const data = new Uint8Array(await resp.arrayBuffer())
+      const etag = resp.headers.get('etag') ?? undefined
+      return { data, version: { etag } }
+    },
+
+    putObject: async () => {
+      throw new Error('Read-only storage: putObject not supported')
+    },
+
+    copyObject: async () => {
+      throw new Error('Read-only storage: copyObject not supported')
+    },
+
+    listObjects: async (_err, prefix) => {
+      // Try S3-style XML listing
+      // Derive bucket URL and key prefix from the base URL
+      // e.g. https://bucket.s3.region.amazonaws.com/prefix -> bucket URL + key prefix
+      const url = new URL(base)
+      const keyPrefix = url.pathname.replace(/^\//, '') + '/' + prefix
+      const listUrl = `${url.origin}/?list-type=2&prefix=${encodeURIComponent(keyPrefix)}`
+
+      const resp = await fetch(listUrl)
+      throwForStatus(resp, listUrl)
+
+      const xml = await resp.text()
+      const results = []
+      const contentRegex = /<Contents>([\s\S]*?)<\/Contents>/g
+      let match
+      while ((match = contentRegex.exec(xml)) !== null) {
+        const block = match[1]
+        const key = block.match(/<Key>(.*?)<\/Key>/)?.[1]
+        const lastModified = block.match(/<LastModified>(.*?)<\/LastModified>/)?.[1]
+        const size = block.match(/<Size>(.*?)<\/Size>/)?.[1]
+        if (key && lastModified && size) {
+          const id = key.startsWith(keyPrefix) ? key.slice(keyPrefix.length) : key
+          results.push({
+            id,
+            createdAt: new Date(lastModified),
+            sizeBytes: Number(size),
+          })
+        }
+      }
+
+      return results
+    },
+
+    deleteBatch: async () => {
+      throw new Error('Read-only storage: deleteBatch not supported')
+    },
+
+    getObjectLastModified: async (_err, path) => {
+      const url = `${base}/${path}`
+      const resp = await fetch(url, { method: 'HEAD' })
+      throwForStatus(resp, url)
+      const lastModified = resp.headers.get('last-modified')
+      if (!lastModified) {
+        throw new Error(`No Last-Modified header: ${url}`)
+      }
+      return new Date(lastModified)
+    },
+
+    getObjectConditional: async (_err, { path, previousVersion }) => {
+      const url = `${base}/${path}`
+      const headers = {}
+
+      if (previousVersion?.etag) {
+        headers['If-None-Match'] = previousVersion.etag
+      }
+
+      const resp = await fetch(url, { headers })
+
+      if (resp.status === 304) {
+        return { kind: 'on_latest_version' }
+      }
+
+      throwForStatus(resp, url)
+
+      const data = new Uint8Array(await resp.arrayBuffer())
+      const etag = resp.headers.get('etag') ?? undefined
+      return { kind: 'modified', data, newVersion: { etag } }
+    },
+  })
+}
+
+module.exports = { createFetchStorage }

package/index.d.ts

@@ -12,6 +12,24 @@ export declare class Repository {
   listTags(): Promise<Array<string>>
   createTag(name: string, snapshotId: string): Promise<void>
   lookupManifestFiles(snapshotId: string): Promise<Array<JsManifestFileInfo>>
+  lookupBranch(branch: string): Promise<string>
+  resetBranch(branch: string, toSnapshotId: string, fromSnapshotId?: string | undefined | null): Promise<void>
+  deleteBranch(branch: string): Promise<void>
+  lookupTag(tag: string): Promise<string>
+  deleteTag(tag: string): Promise<void>
+  lookupSnapshot(snapshotId: string): Promise<SnapshotInfo>
+  static fetchSpecVersion(storage: JsStorage, storageSettings?: StorageSettings | undefined | null): Promise<number | null>
+  static fetchConfig(storage: JsStorage): Promise<RepositoryConfig | null>
+  saveConfig(): Promise<void>
+  get config(): RepositoryConfig
+  get specVersion(): number
+  diff(options: DiffOptions): Promise<DiffResult>
+  featureFlags(): Promise<Array<FeatureFlag>>
+  enabledFeatureFlags(): Promise<Array<FeatureFlag>>
+  disabledFeatureFlags(): Promise<Array<FeatureFlag>>
+  setFeatureFlag(name: string, setting?: boolean | undefined | null): Promise<void>
+  rearrangeSession(branch: string): Promise<JsSession>
+  ancestry(options: VersionOptions): Promise<Array<SnapshotInfo>>
 }
 export type JsRepository = Repository
 
@@ -23,11 +41,44 @@ export declare class Session {
   get store(): JsStore
   commit(message: string): Promise<string>
   discardChanges(): Promise<void>
+  get isFork(): boolean
+  get mode(): string
+  get config(): RepositoryConfig
+  status(): Promise<DiffResult>
+  moveNode(fromPath: string, toPath: string): Promise<void>
+  getNodeId(path: string): Promise<string>
+  merge(other: Session): Promise<void>
+  amend(message: string): Promise<string>
+  flush(message: string): Promise<string>
+  rebase(): Promise<void>
+  /** Get all virtual chunk locations referenced by this session */
+  allVirtualChunkLocations(): Promise<Array<string>>
 }
 export type JsSession = Session
 
 export declare class Storage {
   static newInMemory(): Promise<Storage>
+  /**
+   * Create a Storage backed by a JS object implementing the StorageBackend interface.
+   *
+   * This allows providing a custom storage implementation using JS libraries
+   * (fetch, @aws-sdk/client-s3, @google-cloud/storage, etc.), which is
+   * especially useful for WASM builds where native Rust networking is unavailable.
+   */
+  static newCustom(backend: { canWrite: () => Promise<boolean>; getObjectRange: (args: StorageGetObjectRangeArgs) => Promise<StorageGetObjectResponse>; putObject: (args: StoragePutObjectArgs) => Promise<StorageVersionedUpdateResult>; copyObject: (args: StorageCopyObjectArgs) => Promise<StorageVersionedUpdateResult>; listObjects: (prefix: string) => Promise<Array<StorageListInfo>>; deleteBatch: (args: StorageDeleteBatchArgs) => Promise<StorageDeleteObjectsResult>; getObjectLastModified: (path: string) => Promise<Date>; getObjectConditional: (args: StorageGetObjectConditionalArgs) => Promise<StorageGetModifiedResult> }): Storage
+  static newLocalFilesystem(path: string): Promise<Storage>
+  static newS3(bucket: string, prefix?: string | undefined | null, credentials?: S3Credentials | undefined | null, options?: S3Options | undefined | null): Storage
+  static newR2(bucket?: string | undefined | null, prefix?: string | undefined | null, accountId?: string | undefined | null, credentials?: S3Credentials | undefined | null, options?: S3Options | undefined | null): Storage
+  static newTigris(bucket: string, prefix?: string | undefined | null, credentials?: S3Credentials | undefined | null, options?: S3Options | undefined | null, useWeakConsistency?: boolean | undefined | null): Storage
+  static newS3ObjectStore(bucket: string, prefix?: string | undefined | null, credentials?: S3Credentials | undefined | null, options?: S3Options | undefined | null): Promise<Storage>
+  static newGcs(bucket: string, prefix?: string | undefined | null, credentials?: GcsCredentials | undefined | null, config?: Record<string, string> | undefined | null): Storage
+  static newAzureBlob(account: string, container: string, prefix?: string | undefined | null, credentials?: AzureCredentials | undefined | null, config?: Record<string, string> | undefined | null): Promise<Storage>
+  static newHttp(baseUrl: string, config?: Record<string, string> | undefined | null): Storage
+  static newS3WithRefreshableCredentials(bucket: string, prefix: string | undefined | null, credentialsCallback: () => Promise<S3StaticCredentials>, initialCredentials?: S3StaticCredentials | undefined | null, options?: S3Options | undefined | null): Storage
+  static newR2WithRefreshableCredentials(bucket: string | undefined | null, prefix: string | undefined | null, accountId: string | undefined | null, credentialsCallback: () => Promise<S3StaticCredentials>, initialCredentials?: S3StaticCredentials | undefined | null, options?: S3Options | undefined | null): Storage
+  static newTigrisWithRefreshableCredentials(bucket: string, prefix: string | undefined | null, credentialsCallback: () => Promise<S3StaticCredentials>, initialCredentials?: S3StaticCredentials | undefined | null, options?: S3Options | undefined | null, useWeakConsistency?: boolean | undefined | null): Storage
+  static newS3ObjectStoreWithRefreshableCredentials(bucket: string, prefix: string | undefined | null, credentialsCallback: () => Promise<S3StaticCredentials>, initialCredentials?: S3StaticCredentials | undefined | null, options?: S3Options | undefined | null): Promise<Storage>
+  static newGcsWithRefreshableCredentials(bucket: string, prefix: string | undefined | null, credentialsCallback: () => Promise<GcsBearerCredential>, initialCredentials?: GcsBearerCredential | undefined | null, config?: Record<string, string> | undefined | null): Storage
 }
 export type JsStorage = Storage
 
@@ -43,9 +94,40 @@ export declare class Store {
   get supportsWrites(): boolean
   get supportsDeletes(): boolean
   get supportsListing(): boolean
+  get readOnly(): Promise<boolean>
+  get session(): Session
+  isEmpty(prefix: string): Promise<boolean>
+  clear(): Promise<void>
+  setIfNotExists(key: string, value: Buffer): Promise<void>
+  deleteDir(prefix: string): Promise<void>
+  getsize(key: string): Promise<number>
+  getsizePrefix(prefix: string): Promise<number>
+  /**
+   * Set a single virtual reference to a chunk
+   *
+   * For checksum validation, provide either etag_checksum (string) or last_modified (JS Date object).
+   * If both are provided, etag_checksum takes precedence.
+   */
+  setVirtualRef(key: string, location: string, offset: number, length: number, etagChecksum: string | undefined | null, lastModified: Date | undefined | null, validateContainer: boolean): Promise<void>
+  /**
+   * Set multiple virtual references for the same array
+   * Returns the indices of failed chunk references if any
+   */
+  setVirtualRefs(arrayPath: string, chunks: Array<VirtualChunkSpec>, validateContainers: boolean): Promise<Array<Array<number>> | null>
 }
 export type JsStore = Store
 
+/** Azure credentials */
+export type AzureCredentials =
+  | { type: 'FromEnv' }
+  | { type: 'Static', field0: AzureStaticCredentials }
+
+/** Azure static credentials */
+export type AzureStaticCredentials =
+  | { type: 'AccessKey', field0: string }
+  | { type: 'SasToken', field0: string }
+  | { type: 'BearerToken', field0: string }
+
 /** Caching configuration */
 export interface CachingConfig {
   numSnapshotNodes?: number
@@ -66,19 +148,109 @@ export interface CompressionConfig {
   level?: number
 }
 
+/** Credentials for virtual chunk access */
+export type Credentials =
+  | { type: 'S3', field0: S3Credentials }
+  | { type: 'Gcs', field0: GcsCredentials }
+  | { type: 'Azure', field0: AzureCredentials }
+
+export interface DiffOptions {
+  fromBranch?: string
+  fromTag?: string
+  fromSnapshotId?: string
+  toBranch?: string
+  toTag?: string
+  toSnapshotId?: string
+}
+
+export interface DiffResult {
+  newGroups: Array<string>
+  newArrays: Array<string>
+  deletedGroups: Array<string>
+  deletedArrays: Array<string>
+  updatedGroups: Array<string>
+  updatedArrays: Array<string>
+  updatedChunks: any
+  movedNodes: Array<JsMovedNode>
+}
+
+export interface FeatureFlag {
+  id: number
+  name: string
+  defaultEnabled: boolean
+  setting?: boolean
+  enabled: boolean
+}
+
+/** GCS bearer credential with optional expiry */
+export interface GcsBearerCredential {
+  bearer: string
+  expiresAfter?: Date
+}
+
+/** GCS credentials */
+export type GcsCredentials =
+  | { type: 'Anonymous' }
+  | { type: 'FromEnv' }
+  | { type: 'Static', field0: GcsStaticCredentials }
+
+/** GCS static credentials */
+export type GcsStaticCredentials =
+  | { type: 'ServiceAccount', field0: string }
+  | { type: 'ServiceAccountKey', field0: string }
+  | { type: 'ApplicationCredentials', field0: string }
+  | { type: 'BearerToken', field0: string }
+
 export interface ManifestFileInfo {
   id: string
   sizeBytes: number
   numChunkRefs: number
 }
 
+export interface MovedNode {
+  from: string
+  to: string
+}
+
+/** Object store configuration for virtual chunk containers */
+export type ObjectStoreConfig =
+  | { type: 'InMemory' }
+  | { type: 'LocalFileSystem', field0: string }
+  | { type: 'Http', field0: Record<string, string> }
+  | { type: 'S3Compatible', field0: S3Options }
+  | { type: 'S3', field0: S3Options }
+  | { type: 'Gcs', field0: Record<string, string> }
+  | { type: 'Azure', field0: Record<string, string> }
+  | { type: 'Tigris', field0: S3Options }
+
 export interface ReadonlySessionOptions {
   branch?: string
   tag?: string
   snapshotId?: string
 }
 
-/** Repository configuration (WASM build — no virtual chunk support) */
+/**
+ * Repository configuration
+ *
+ * The `manifest` field accepts a JSON object matching the serde serialization
+ * of `ManifestConfig`. Example:
+ * ```js
+ * {
+ *   manifest: {
+ *     preload: {
+ *       max_total_refs: 1000,
+ *       preload_if: { true: null },
+ *       max_arrays_to_scan: 10
+ *     },
+ *     splitting: {
+ *       split_sizes: [
+ *         [{ path_matches: { regex: ".*" } }, [{ condition: "any", num_chunks: 100 }]]
+ *       ]
+ *     }
+ *   }
+ * }
+ * ```
+ */
 export interface RepositoryConfig {
   inlineChunkThresholdBytes?: number
   getPartialValuesConcurrency?: number
@@ -91,6 +263,41 @@ export interface RepositoryConfig {
    * The object is deserialized using serde, matching the Rust ManifestConfig structure.
    */
   manifest?: any
+  /** Virtual chunk containers configuration */
+  virtualChunkContainers?: Record<string, VirtualChunkContainer>
+}
+
+/** S3 credentials */
+export type S3Credentials =
+  | { type: 'FromEnv' }
+  | { type: 'Anonymous' }
+  | { type: 'Static', field0: S3StaticCredentials }
+
+/** S3 options */
+export interface S3Options {
+  region?: string
+  endpointUrl?: string
+  allowHttp?: boolean
+  anonymous?: boolean
+  forcePathStyle?: boolean
+  networkStreamTimeoutSeconds?: number
+  requesterPays?: boolean
+}
+
+/** S3 static credentials */
+export interface S3StaticCredentials {
+  accessKeyId: string
+  secretAccessKey: string
+  sessionToken?: string
+  expiresAfter?: Date
+}
+
+export interface SnapshotInfo {
+  id: string
+  parentId?: string
+  writtenAt: string
+  message: string
+  metadata: any
 }
 
 /** Storage concurrency settings */
@@ -99,6 +306,81 @@ export interface StorageConcurrencySettings {
   idealConcurrentRequestSize?: number
 }
 
+/** Arguments for copy_object callback */
+export interface StorageCopyObjectArgs {
+  from: string
+  to: string
+  contentType?: string
+  version: StorageVersionInfo
+}
+
+/** Arguments for delete_batch callback */
+export interface StorageDeleteBatchArgs {
+  prefix: string
+  batch: Array<StorageDeleteItem>
+}
+
+/** An item in a delete_batch call */
+export interface StorageDeleteItem {
+  id: string
+  size: number
+}
+
+/** Result of a delete_batch call from JS */
+export interface StorageDeleteObjectsResult {
+  deletedObjects: number
+  deletedBytes: number
+}
+
+/** Result of a get_object_conditional call from JS */
+export interface StorageGetModifiedResult {
+  /** "modified" or "on_latest_version" */
+  kind: string
+  data?: Buffer
+  newVersion?: StorageVersionInfo
+}
+
+/** Arguments for get_object_conditional callback */
+export interface StorageGetObjectConditionalArgs {
+  path: string
+  previousVersion?: StorageVersionInfo
+}
+
+/** Arguments for get_object_range callback */
+export interface StorageGetObjectRangeArgs {
+  path: string
+  rangeStart?: number
+  rangeEnd?: number
+}
+
+/** Result of a get_object_range call from JS */
+export interface StorageGetObjectResponse {
+  data: Buffer
+  version: StorageVersionInfo
+}
+
+/** A key-value pair for object metadata */
+export interface StorageKeyValue {
+  key: string
+  value: string
+}
+
+/** Entry in a list_objects result from JS */
+export interface StorageListInfo {
+  id: string
+  createdAt: Date
+  sizeBytes: number
+}
+
+/** Arguments for put_object callback */
+export interface StoragePutObjectArgs {
+  path: string
+  data: Buffer
+  contentType?: string
+  metadata: Array<StorageKeyValue>
+  previousVersion?: StorageVersionInfo
+}
+
 /** Storage retries settings */
 export interface StorageRetriesSettings {
   maxTries?: number
@@ -110,6 +392,7 @@ export interface StorageRetriesSettings {
 export interface StorageSettings {
   concurrency?: StorageConcurrencySettings
   retries?: StorageRetriesSettings
+  timeouts?: StorageTimeoutSettings
   unsafeUseConditionalUpdate?: boolean
   unsafeUseConditionalCreate?: boolean
   unsafeUseMetadata?: boolean
@@ -118,3 +401,48 @@ export interface StorageSettings {
   chunksStorageClass?: string
   minimumSizeForMultipartUpload?: number
 }
+
+/** Storage timeout settings */
+export interface StorageTimeoutSettings {
+  connectTimeoutMs?: number
+  readTimeoutMs?: number
+  operationTimeoutMs?: number
+  operationAttemptTimeoutMs?: number
+}
+
+/** Result of a put_object or copy_object call from JS */
+export interface StorageVersionedUpdateResult {
+  /** "updated" or "not_on_latest_version" */
+  kind: string
+  newVersion?: StorageVersionInfo
+}
+
+/** Version information returned from JS storage callbacks */
+export interface StorageVersionInfo {
+  etag?: string
+  generation?: string
+}
+
+export interface VersionOptions {
+  branch?: string
+  tag?: string
+  snapshotId?: string
+}
+
+/** Virtual chunk container configuration */
+export interface VirtualChunkContainer {
+  name?: string
+  urlPrefix: string
+  store: JsObjectStoreConfig
+}
+
+/** Specification for a virtual chunk reference */
+export interface VirtualChunkSpec {
+  index: Array<number>
+  location: string
+  offset: number
+  length: number
+  etagChecksum?: string
+  /** Last modified datetime (accepts JS Date object) */
+  lastModified?: Date
+}

package/index.js

@@ -80,8 +80,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-android-arm64')
         const bindingPackageVersion = require('@earthmover/icechunk-android-arm64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -96,8 +96,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-android-arm-eabi')
         const bindingPackageVersion = require('@earthmover/icechunk-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -116,8 +116,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-win32-x64-msvc')
         const bindingPackageVersion = require('@earthmover/icechunk-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -132,8 +132,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-win32-ia32-msvc')
         const bindingPackageVersion = require('@earthmover/icechunk-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -148,8 +148,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-win32-arm64-msvc')
         const bindingPackageVersion = require('@earthmover/icechunk-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -167,8 +167,8 @@ function requireNative() {
     try {
       const binding = require('@earthmover/icechunk-darwin-universal')
       const bindingPackageVersion = require('@earthmover/icechunk-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -183,8 +183,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-darwin-x64')
         const bindingPackageVersion = require('@earthmover/icechunk-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -199,8 +199,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-darwin-arm64')
         const bindingPackageVersion = require('@earthmover/icechunk-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -219,8 +219,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-freebsd-x64')
         const bindingPackageVersion = require('@earthmover/icechunk-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -235,8 +235,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-freebsd-arm64')
         const bindingPackageVersion = require('@earthmover/icechunk-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -256,8 +256,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-x64-musl')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -272,8 +272,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-x64-gnu')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -290,8 +290,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-arm64-musl')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -306,8 +306,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-arm64-gnu')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -324,8 +324,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-arm-musleabihf')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -340,8 +340,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -358,8 +358,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-loong64-musl')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -374,8 +374,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-loong64-gnu')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -392,8 +392,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-riscv64-musl')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -408,8 +408,8 @@ function requireNative() {
         try {
           const binding = require('@earthmover/icechunk-linux-riscv64-gnu')
           const bindingPackageVersion = require('@earthmover/icechunk-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -425,8 +425,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-linux-ppc64-gnu')
         const bindingPackageVersion = require('@earthmover/icechunk-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -441,8 +441,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-linux-s390x-gnu')
         const bindingPackageVersion = require('@earthmover/icechunk-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -461,8 +461,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-openharmony-arm64')
         const bindingPackageVersion = require('@earthmover/icechunk-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -477,8 +477,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-openharmony-x64')
         const bindingPackageVersion = require('@earthmover/icechunk-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -493,8 +493,8 @@ function requireNative() {
       try {
         const binding = require('@earthmover/icechunk-openharmony-arm')
         const bindingPackageVersion = require('@earthmover/icechunk-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '2.0.0-alpha.6' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.6 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-alpha.11' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-alpha.11 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@earthmover/icechunk",
-  "version": "2.0.0-alpha.10",
+  "version": "2.0.0-alpha.12",
   "description": "JavaScript/TypeScript bindings for Icechunk",
   "main": "index.js",
   "repository": {
@@ -19,10 +19,22 @@
     "science",
     "geospatial"
   ],
+  "exports": {
+    ".": {
+      "browser": "./browser.js",
+      "default": "./index.js"
+    },
+    "./fetch-storage": {
+      "types": "./fetch-storage.d.ts",
+      "default": "./fetch-storage.js"
+    }
+  },
   "files": [
     "index.d.ts",
     "index.js",
-    "browser.js"
+    "browser.js",
+    "fetch-storage.js",
+    "fetch-storage.d.ts"
   ],
   "napi": {
     "binaryName": "icechunk",
@@ -108,9 +120,9 @@
   },
   "packageManager": "yarn@4.12.0",
   "optionalDependencies": {
-    "@earthmover/icechunk-win32-x64-msvc": "2.0.0-alpha.10",
-    "@earthmover/icechunk-linux-x64-gnu": "2.0.0-alpha.10",
-    "@earthmover/icechunk-darwin-arm64": "2.0.0-alpha.10",
-    "@earthmover/icechunk-wasm32-wasi": "2.0.0-alpha.10"
+    "@earthmover/icechunk-win32-x64-msvc": "2.0.0-alpha.12",
+    "@earthmover/icechunk-linux-x64-gnu": "2.0.0-alpha.12",
+    "@earthmover/icechunk-darwin-arm64": "2.0.0-alpha.12",
+    "@earthmover/icechunk-wasm32-wasi": "2.0.0-alpha.12"
   }
 }