@gscdump/lakehouse 7.8.0 → 7.8.1

package/dist/_virtual/node_modules/.pnpm/icebird@0.8.30_patch_hash=1359a91da68522a736babe444880ae391f19455fbe47c346f76cec92c5c2e471/node_modules/icebird/types/fetch.d.mts

@@ -1,2 +1,36 @@
 import "../../../../hyparquet@1.31.1/node_modules/hyparquet/types/node.mjs";
-import "../src/types.mjs";
+import { Resolver } from "../src/types.mjs";
+/**
+ * Wrap a `Resolver` so reads of the same path share one HTTP fetch and
+ * subsequent range reads share one in-memory buffer. Writes and deletes
+ * through the same resolver invalidate the cache entry for their path on
+ * success, so a commit pipeline (`icebergAppend` → reload metadata) sees the
+ * new bytes without manual invalidation.
+ *
+ * - `reader(path)` is memoized by path. The returned buffer is passed through
+ *   `cachedAsyncBuffer` so range reads within a single file are also deduped.
+ *   `byteLength` is a fetch hint and not part of the cache key — the bytes
+ *   are the same either way.
+ * - `writer(path).finish()` invalidates the cache entry only when the
+ *   underlying finish resolves; a rejected finish (e.g. an `If-None-Match: *`
+ *   collision returning 412/409) leaves the cached bytes intact, since the
+ *   server-side object hasn't changed.
+ * - `deleter(path)` invalidates the cache entry on success.
+ * - `writer` and `deleter` are omitted when the base resolver omits them, so
+ *   wrapping a read-only resolver still yields a read-only resolver.
+ *
+ * Iceberg writes are almost entirely create-new-path (data parquets, manifest
+ * avros, snapshot avros, vN.metadata.json all live at fresh paths per
+ * commit). Only `version-hint.text` and equivalent catalog-pointer files are
+ * truly mutated in place, so path-level invalidation is sufficient to keep
+ * single-process write-then-read pipelines consistent.
+ *
+ * Cross-process freshness is out of scope: a reader in process B does not
+ * see writes committed by process A through a different cache. Use a
+ * short-lived resolver, an external coordination layer, or wrap with TTL /
+ * conditional-GET revalidation if you need that.
+ *
+ * @param {Resolver} base
+ * @returns {Resolver}
+ */
+export declare function cachingResolver(base: Resolver): Resolver;

package/dist/_virtual/node_modules/.pnpm/icebird@0.8.30_patch_hash=1359a91da68522a736babe444880ae391f19455fbe47c346f76cec92c5c2e471/node_modules/icebird/types/index.d.mts

@@ -1,9 +1,9 @@
 import { icebergManifests } from "./manifest.mjs";
 import { icebergAppend, icebergCreateTable, icebergDropTable } from "./write/write.mjs";
+import { cachingResolver } from "./fetch.mjs";
 import { restCatalogConnect, restCatalogCreateNamespace, restCatalogListTables, restCatalogLoadTable } from "./catalog/rest.mjs";
 import "./create.mjs";
 import "./catalog/file.mjs";
-import "./fetch.mjs";
 import { s3SignedResolver } from "./s3.mjs";
 import "../../../../squirreling@0.16.6/node_modules/squirreling/src/index.mjs";
 import "./read.mjs";

package/dist/catalog.d.mts

@@ -1,11 +1,11 @@
 import { ManifestReadCache, ManifestReadLimits } from "./_virtual/node_modules/.pnpm/icebird@0.8.30_patch_hash=1359a91da68522a736babe444880ae391f19455fbe47c346f76cec92c5c2e471/node_modules/icebird/types/manifest.mjs";
 import { icebergAppend } from "./_virtual/node_modules/.pnpm/icebird@0.8.30_patch_hash=1359a91da68522a736babe444880ae391f19455fbe47c346f76cec92c5c2e471/node_modules/icebird/types/write/write.mjs";
 import { CatalogCache } from "./catalog-cache.mjs";
+import { Resolver } from "./icebird-resolver.mjs";
 import "./manifest-read-limits.mjs";
 import { IcebergPrimitiveType, IcebergS3Config } from "./schema.mjs";
 import { PartitionValueMatch } from "./partition-prune.mjs";
 import { restCatalogConnect, restCatalogLoadTable } from "./_virtual/node_modules/.pnpm/icebird@0.8.30_patch_hash=1359a91da68522a736babe444880ae391f19455fbe47c346f76cec92c5c2e471/node_modules/icebird/types/catalog/rest.mjs";
-import { Resolver } from "icebird/src/types.js";
 /** A field in an icebird table `Schema`. */
 export interface IcebergSchemaField {
   id: number;

package/dist/icebird-resolver.d.mts

@@ -0,0 +1,10 @@
+import { cachingResolver } from "./_virtual/node_modules/.pnpm/icebird@0.8.30_patch_hash=1359a91da68522a736babe444880ae391f19455fbe47c346f76cec92c5c2e471/node_modules/icebird/types/fetch.mjs";
+/**
+ * icebird's file `Resolver`.
+ *
+ * Derive it from `cachingResolver` and never import `icebird/src/types.js`.
+ * That specifier has no declaration under icebird's `types/` folder, so the
+ * declaration bundler keeps it as an external import. icebird is bundled and
+ * consumers do not install it, so the type would resolve to `any` for them.
+ */
+export type Resolver = ReturnType<typeof cachingResolver>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/lakehouse",
   "type": "module",
-  "version": "7.8.0",
+  "version": "7.8.1",
   "description": "Dataset-agnostic Iceberg lakehouse layer + dataset registry for R2 Data Catalog producers (ADR-0021).",
   "author": {
     "name": "Harlan Wilton",