Version Packages (next)

Author: github-actions[bot]

.changeset/pre.json

@@ -12,7 +12,9 @@
   "changesets": [
     "cold-dancers-chew",
     "flat-boats-train",
+    "green-pandas-argue",
     "grumpy-penguins-lick",
+    "popular-glasses-nail",
     "quick-teachers-camp",
     "serious-comics-lick",
     "slimy-pigs-buy",

packages/core/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @zarrita/core
 
+## 0.1.0-next.5
+
+### Minor Changes
+
+- feat: Add `tryWithConsolidated` store helper ([#141](https://github.com/manzt/zarrita.js/pull/141))
+
+  Provides a convenient way to open a store that may or may not have consolidated
+  metadata. Ideal for usage senarios with known access paths, since store with
+  consolidated metadata do not incur additional network requests when accessing
+  underlying groups and arrays.
+
+  ```js
+  import * as zarr from "zarrita";
+
+  let store = await zarr.tryWithConsolidated(
+    new zarr.FetchStore("https://localhost:8080/data.zarr");
+  );
+
+  // The following do not read from the store
+  // (make network requests) if it is consolidated.
+  let grp = await zarr.open(store, { kind: "group" });
+  let foo = await zarr.open(grp.resolve("foo"), { kind: "array" });
+  ```
+
+- feat: Add `withConsolidated` store utility ([#119](https://github.com/manzt/zarrita.js/pull/119))
+
+  **BREAKING**: Replaces [`openConsolidated`](https://github.com/manzt/zarrita.js/pull/91)
+  to provide a consistent interface for accessing consolidated and non-consolidated stores.
+
+  ```javascript
+  import * as zarr from "zarrita";
+
+  // non-consolidated
+  let store = new zarr.FetchStore("https://localhost:8080/data.zarr");
+  let grp = await zarr.open(store); // network request for .zgroup/.zattrs
+  let foo = await zarr.open(grp.resolve("/foo"), { kind: array }); // network request for .zarray/.zattrs
+
+  // consolidated
+  let store = new zarr.FetchStore("https://localhost:8080/data.zarr");
+  let consolidatedStore = await zarr.withConsolidated(store); // opens ./zmetadata
+  let contents = consolidatedStore.contents(); // [ {path: "/", kind: "group" }, { path: "/foo", kind: "array" }, ...]
+  let grp = await zarr.open(consolidatedStore); // no network request
+  let foo = await zarr.open(grp.resolve(contents[1].path), {
+    kind: contents[1].kind,
+  }); // no network request
+  ```
+
 ## 0.1.0-next.4
 
 ### Patch Changes

packages/core/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zarrita/core",
-	"version": "0.1.0-next.4",
+	"version": "0.1.0-next.5",
 	"license": "MIT",
 	"type": "module",
 	"sideEffects": false,

packages/indexing/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @zarrita/indexing
 
+## 0.1.0-next.7
+
+### Minor Changes
+
+- feat: Add `withConsolidated` store utility ([#119](https://github.com/manzt/zarrita.js/pull/119))
+
+  **BREAKING**: Replaces [`openConsolidated`](https://github.com/manzt/zarrita.js/pull/91)
+  to provide a consistent interface for accessing consolidated and non-consolidated stores.
+
+  ```javascript
+  import * as zarr from "zarrita";
+
+  // non-consolidated
+  let store = new zarr.FetchStore("https://localhost:8080/data.zarr");
+  let grp = await zarr.open(store); // network request for .zgroup/.zattrs
+  let foo = await zarr.open(grp.resolve("/foo"), { kind: array }); // network request for .zarray/.zattrs
+
+  // consolidated
+  let store = new zarr.FetchStore("https://localhost:8080/data.zarr");
+  let consolidatedStore = await zarr.withConsolidated(store); // opens ./zmetadata
+  let contents = consolidatedStore.contents(); // [ {path: "/", kind: "group" }, { path: "/foo", kind: "array" }, ...]
+  let grp = await zarr.open(consolidatedStore); // no network request
+  let foo = await zarr.open(grp.resolve(contents[1].path), {
+    kind: contents[1].kind,
+  }); // no network request
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`191d95c77d2c7902344cd0175ae0044f740d19ba`](https://github.com/manzt/zarrita.js/commit/191d95c77d2c7902344cd0175ae0044f740d19ba), [`4d177d825f7bc241e0906a1b2890cad93f22d8a6`](https://github.com/manzt/zarrita.js/commit/4d177d825f7bc241e0906a1b2890cad93f22d8a6)]:
+  - @zarrita/core@0.1.0-next.5
+
 ## 0.1.0-next.6
 
 ### Patch Changes

packages/indexing/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zarrita/indexing",
-	"version": "0.1.0-next.6",
+	"version": "0.1.0-next.7",
 	"license": "MIT",
 	"type": "module",
 	"sideEffects": false,

packages/ndarray/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @zarrita/ndarray
 
+## 0.1.0-next.7
+
+### Patch Changes
+
+- Updated dependencies [[`191d95c77d2c7902344cd0175ae0044f740d19ba`](https://github.com/manzt/zarrita.js/commit/191d95c77d2c7902344cd0175ae0044f740d19ba), [`4d177d825f7bc241e0906a1b2890cad93f22d8a6`](https://github.com/manzt/zarrita.js/commit/4d177d825f7bc241e0906a1b2890cad93f22d8a6)]:
+  - @zarrita/core@0.1.0-next.5
+  - @zarrita/indexing@0.1.0-next.7
+
 ## 0.1.0-next.6
 
 ### Patch Changes

packages/ndarray/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zarrita/ndarray",
-	"version": "0.1.0-next.6",
+	"version": "0.1.0-next.7",
 	"license": "MIT",
 	"type": "module",
 	"sideEffects": false,

packages/zarrita/CHANGELOG.md

@@ -1,5 +1,38 @@
 # zarrita
 
+## 0.4.0-next.7
+
+### Minor Changes
+
+- feat: Add `withConsolidated` store utility ([#119](https://github.com/manzt/zarrita.js/pull/119))
+
+  **BREAKING**: Replaces [`openConsolidated`](https://github.com/manzt/zarrita.js/pull/91)
+  to provide a consistent interface for accessing consolidated and non-consolidated stores.
+
+  ```javascript
+  import * as zarr from "zarrita";
+
+  // non-consolidated
+  let store = new zarr.FetchStore("https://localhost:8080/data.zarr");
+  let grp = await zarr.open(store); // network request for .zgroup/.zattrs
+  let foo = await zarr.open(grp.resolve("/foo"), { kind: array }); // network request for .zarray/.zattrs
+
+  // consolidated
+  let store = new zarr.FetchStore("https://localhost:8080/data.zarr");
+  let consolidatedStore = await zarr.withConsolidated(store); // opens ./zmetadata
+  let contents = consolidatedStore.contents(); // [ {path: "/", kind: "group" }, { path: "/foo", kind: "array" }, ...]
+  let grp = await zarr.open(consolidatedStore); // no network request
+  let foo = await zarr.open(grp.resolve(contents[1].path), {
+    kind: contents[1].kind,
+  }); // no network request
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`191d95c77d2c7902344cd0175ae0044f740d19ba`](https://github.com/manzt/zarrita.js/commit/191d95c77d2c7902344cd0175ae0044f740d19ba), [`4d177d825f7bc241e0906a1b2890cad93f22d8a6`](https://github.com/manzt/zarrita.js/commit/4d177d825f7bc241e0906a1b2890cad93f22d8a6)]:
+  - @zarrita/core@0.1.0-next.5
+  - @zarrita/indexing@0.1.0-next.7
+
 ## 0.4.0-next.6
 
 ### Patch Changes

packages/zarrita/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "zarrita",
-	"version": "0.4.0-next.6",
+	"version": "0.4.0-next.7",
 	"license": "MIT",
 	"homepage": "https://manzt.github.io/zarrita.js/",
 	"repository": {