git-fs-s3 0.15.2 → 0.16.0

package/dist/chunk-T5M5EYCZ.js

@@ -1,143 +0,0 @@
-import {
-  OBJ_OFS_DELTA,
-  OBJ_REF_DELTA,
-  OID_BYTES,
-  findPackIndexOffset,
-  inflatePrefix,
-  packFileName,
-  parsePackDirectory,
-  parsePackFileName,
-  rawFs,
-  readDeltaHeader,
-  readEntryHeader,
-  readOfsDeltaOffset
-} from "./chunk-OKBQISUC.js";
-
-// src/git-layout.ts
-var HEX = new Set("0123456789abcdef");
-function isHex(value, length) {
-  if (value.length !== length) return false;
-  for (const char of value) if (!HEX.has(char)) return false;
-  return true;
-}
-function classifyGitdirPath(path) {
-  const segments = path.split("/");
-  const [first, second, third, ...rest] = segments;
-  if (segments.length === 1) {
-    if (first === "HEAD") return { kind: "head" };
-    if (first === "config") return { kind: "config" };
-    if (first === "refs") return { kind: "refs", path };
-    return { kind: "other" };
-  }
-  if (first === "refs") return { kind: "refs", path };
-  if (first !== "objects" || second === void 0) return { kind: "other" };
-  if (segments.length === 2 && second === "") return { kind: "objects-dir" };
-  if (second === "pack" && third !== void 0 && rest.length === 0) {
-    if (third === "") return { kind: "pack-dir" };
-    const file = parsePackFileName(third);
-    return file ? { kind: "pack-file", file } : { kind: "other" };
-  }
-  if (third !== void 0 && rest.length === 0 && isHex(second, 2) && isHex(third, 38)) {
-    return { kind: "loose-object", oid: second + third };
-  }
-  return { kind: "other" };
-}
-function isMutableGitdirEntry(entry) {
-  switch (entry.kind) {
-    case "head":
-    case "refs":
-    case "objects-dir":
-    case "pack-dir":
-      return true;
-    default:
-      return false;
-  }
-}
-function parseLooseObjectPath(path) {
-  const segments = path.split("/");
-  if (segments.length < 3) return null;
-  const gitdirSegments = segments.slice(0, -3);
-  const entry = classifyGitdirPath(segments.slice(-3).join("/"));
-  if (entry.kind !== "loose-object") return null;
-  return { gitdir: gitdirSegments.join("/"), oid: entry.oid };
-}
-
-// src/object-size.ts
-var ENTRY_PROBE_BYTES = 64;
-var DELTA_PROBE_BYTES = 4 * 1024;
-var DELTA_HEADER_MAX_BYTES = 20;
-async function locatePackedObject(repo, oid) {
-  const fsp = rawFs(repo);
-  const packDir = `${repo.gitdir}/objects/pack`;
-  const indexes = parsePackDirectory(
-    await fsp.readdir(packDir).catch(() => [])
-  ).filter((file) => file.kind === "idx");
-  for (const { base } of indexes) {
-    const idx = await fsp.readFile(`${packDir}/${packFileName(base, "idx")}`);
-    if (!(idx instanceof Uint8Array)) continue;
-    const offset = findPackIndexOffset(idx, oid);
-    if (offset !== null) {
-      return { packName: packFileName(base, "pack"), offset };
-    }
-  }
-  return null;
-}
-function rangeReader(repo) {
-  const promises = rawFs(repo);
-  if (!promises.getRange) return null;
-  return (key, start, end) => {
-    if (!promises.getRange) return Promise.resolve(null);
-    return promises.getRange(key, start, end);
-  };
-}
-async function deltaResultSize(read, packKey, dataStart) {
-  const compressed = await read(
-    packKey,
-    dataStart,
-    dataStart + DELTA_PROBE_BYTES - 1
-  );
-  if (!compressed || compressed.byteLength === 0) return null;
-  const inflated = await inflatePrefix(
-    new Uint8Array(compressed),
-    DELTA_HEADER_MAX_BYTES
-  );
-  if (!inflated) return null;
-  const header = readDeltaHeader(inflated, 0);
-  return header.length <= inflated.byteLength ? header.resultSize : null;
-}
-async function getObjectSize(repo, oid) {
-  const read = rangeReader(repo);
-  if (!read) return null;
-  const located = await locatePackedObject(repo, oid);
-  if (!located) return null;
-  const packKey = `${repo.gitdir}/objects/pack/${located.packName}`;
-  const probe = await read(
-    packKey,
-    located.offset,
-    located.offset + ENTRY_PROBE_BYTES - 1
-  );
-  if (!probe || probe.byteLength === 0) return null;
-  const header = readEntryHeader(probe, 0);
-  if (header.length > probe.byteLength) return null;
-  if (header.type !== OBJ_OFS_DELTA && header.type !== OBJ_REF_DELTA) {
-    return header.size;
-  }
-  const bodyStart = located.offset + header.length;
-  let dataStart;
-  if (header.type === OBJ_REF_DELTA) {
-    dataStart = bodyStart + OID_BYTES;
-  } else {
-    const base = readOfsDeltaOffset(probe, header.length);
-    if (header.length + base.length > probe.byteLength) return null;
-    dataStart = bodyStart + base.length;
-  }
-  return deltaResultSize(read, packKey, dataStart);
-}
-
-export {
-  classifyGitdirPath,
-  isMutableGitdirEntry,
-  parseLooseObjectPath,
-  getObjectSize
-};
-//# sourceMappingURL=chunk-T5M5EYCZ.js.map

package/dist/chunk-T5M5EYCZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/git-layout.ts","../src/object-size.ts"],"sourcesContent":["/**\n * Typed classification of paths inside a git directory, so callers can\n * reason about \"a ref\", \"a loose object\" or \"the pack listing\" as values\n * instead of matching path strings against patterns.\n *\n * Edge-compatible: no node: imports.\n */\n\nimport { type PackFileName, parsePackFileName } from \"./pack-files.js\";\n\n/** What a gitdir-relative path refers to. Listing prefixes end in `/`. */\nexport type GitdirEntry =\n\t| { readonly kind: \"head\" }\n\t| { readonly kind: \"config\" }\n\t/** A ref file (`refs/heads/main`) or a refs listing (`refs/heads/`). */\n\t| { readonly kind: \"refs\"; readonly path: string }\n\t/** The `objects/` listing. */\n\t| { readonly kind: \"objects-dir\" }\n\t/** The `objects/pack/` listing. */\n\t| { readonly kind: \"pack-dir\" }\n\t| { readonly kind: \"pack-file\"; readonly file: PackFileName }\n\t| { readonly kind: \"loose-object\"; readonly oid: string }\n\t| { readonly kind: \"other\" };\n\nconst HEX = new Set(\"0123456789abcdef\");\n\nfunction isHex(value: string, length: number): boolean {\n\tif (value.length !== length) return false;\n\tfor (const char of value) if (!HEX.has(char)) return false;\n\treturn true;\n}\n\n/** Classify a path relative to a gitdir (no leading slash). */\nexport function classifyGitdirPath(path: string): GitdirEntry {\n\tconst segments = path.split(\"/\");\n\tconst [first, second, third, ...rest] = segments;\n\tif (segments.length === 1) {\n\t\tif (first === \"HEAD\") return { kind: \"head\" };\n\t\tif (first === \"config\") return { kind: \"config\" };\n\t\tif (first === \"refs\") return { kind: \"refs\", path };\n\t\treturn { kind: \"other\" };\n\t}\n\tif (first === \"refs\") return { kind: \"refs\", path };\n\tif (first !== \"objects\" || second === undefined) return { kind: \"other\" };\n\tif (segments.length === 2 && second === \"\") return { kind: \"objects-dir\" };\n\tif (second === \"pack\" && third !== undefined && rest.length === 0) {\n\t\tif (third === \"\") return { kind: \"pack-dir\" };\n\t\tconst file = parsePackFileName(third);\n\t\treturn file ? { kind: \"pack-file\", file } : { kind: \"other\" };\n\t}\n\tif (\n\t\tthird !== undefined &&\n\t\trest.length === 0 &&\n\t\tisHex(second, 2) &&\n\t\tisHex(third, 38)\n\t) {\n\t\treturn { kind: \"loose-object\", oid: second + third };\n\t}\n\treturn { kind: \"other\" };\n}\n\n/**\n * Whether reads of this entry can change between pushes: refs, `HEAD`, and\n * the object/pack listings. Everything else is content-addressed (objects)\n * or written once (config, a given pack file name).\n */\nexport function isMutableGitdirEntry(entry: GitdirEntry): boolean {\n\tswitch (entry.kind) {\n\t\tcase \"head\":\n\t\tcase \"refs\":\n\t\tcase \"objects-dir\":\n\t\tcase \"pack-dir\":\n\t\t\treturn true;\n\t\tdefault:\n\t\t\treturn false;\n\t}\n}\n\n/**\n * A loose-object path anywhere in the fs, split into its gitdir and oid —\n * for callers that don't know where the gitdir boundary is: a loose object\n * is always `<gitdir>/objects/<2 hex>/<38 hex>`.\n */\nexport function parseLooseObjectPath(\n\tpath: string,\n): { readonly gitdir: string; readonly oid: string } | null {\n\tconst segments = path.split(\"/\");\n\tif (segments.length < 3) return null;\n\tconst gitdirSegments = segments.slice(0, -3);\n\tconst entry = classifyGitdirPath(segments.slice(-3).join(\"/\"));\n\tif (entry.kind !== \"loose-object\") return null;\n\treturn { gitdir: gitdirSegments.join(\"/\"), oid: entry.oid };\n}\n","/**\n * An object's size without reading (or inflating) the object.\n *\n * Why this exists: a git object's length lives in its pack entry, but the only\n * way isomorphic-git will hand you an object's bytes is by inflating the whole\n * thing — so \"is this blob too large to render or diff\" could only be asked\n * *after* loading it, which is exactly the cost a size limit is meant to avoid.\n * A 500 MB blob committed to a public repository would be materialised in\n * memory by a single page view before any limit could reject it.\n *\n * Reading the answer is cheap but not trivial, because git stores an object two\n * ways:\n *\n * - **whole** — the entry header records the size, so a small range read at the\n *   entry's offset answers it;\n * - **as a delta** — the entry header records the size of the *delta stream*,\n *   and the reconstructed size is the second varint inside the delta data, which\n *   is itself deflated. Only a bounded prefix of that stream is needed, so\n *   {@link inflatePrefix} recovers it without inflating the object.\n *\n * Either way the answer is exact, which matters because it decides whether a\n * caller may load the object at all. The cost is one `.idx` read (served from\n * the fs cache after the first) plus one or two small range reads of the pack,\n * so a caller can ask about a hundred objects without fetching a pack.\n *\n * `null` means \"not a packed object whose size could be read\" — a loose object,\n * a genuinely absent one, an unreadable index, a store without range reads, or\n * a delta prefix too short to yield its header. A caller must then read the\n * object rather than treating `null` as \"too large\"; see the call sites.\n */\nimport { inflatePrefix } from \"./edge-utils.js\";\nimport { rawFs } from \"./http/types.js\";\nimport type { Repo } from \"./ops/types.js\";\nimport {\n\tOBJ_OFS_DELTA,\n\tOBJ_REF_DELTA,\n\tOID_BYTES,\n\treadDeltaHeader,\n\treadEntryHeader,\n\treadOfsDeltaOffset,\n} from \"./pack-entry.js\";\nimport { packFileName, parsePackDirectory } from \"./pack-files.js\";\nimport { findPackIndexOffset } from \"./pack-index.js\";\n\n/**\n * Bytes fetched at an entry's offset. The entry header itself is at most 10\n * bytes for a 64-bit length, a `REF_DELTA`'s base id is 20, and an `OFS_DELTA`'s\n * base offset at most 10 — 40 bytes, so 64 answers the layout without a second\n * request.\n */\nconst ENTRY_PROBE_BYTES = 64;\n\n/**\n * Compressed bytes fetched from a delta's data. A delta header is two varints\n * (at most 10 bytes each) whose compressed form is smaller still, so this is\n * generous by orders of magnitude while staying a bounded read.\n */\nconst DELTA_PROBE_BYTES = 4 * 1024;\n\n/** The most a delta header can occupy once inflated: two 10-byte varints. */\nconst DELTA_HEADER_MAX_BYTES = 20;\n\n/** The pack holding `oid`, with the offset of its entry. */\nasync function locatePackedObject(\n\trepo: Repo,\n\toid: string,\n): Promise<{ packName: string; offset: number } | null> {\n\tconst fsp = rawFs(repo);\n\tconst packDir = `${repo.gitdir}/objects/pack`;\n\tconst indexes = parsePackDirectory(\n\t\tawait fsp.readdir(packDir).catch(() => [] as string[]),\n\t).filter((file) => file.kind === \"idx\");\n\n\tfor (const { base } of indexes) {\n\t\tconst idx = await fsp.readFile(`${packDir}/${packFileName(base, \"idx\")}`);\n\t\tif (!(idx instanceof Uint8Array)) continue;\n\t\tconst offset = findPackIndexOffset(idx, oid);\n\t\tif (offset !== null) {\n\t\t\treturn { packName: packFileName(base, \"pack\"), offset };\n\t\t}\n\t}\n\treturn null;\n}\n\n/** The store's range reader, or `null` when it has none. */\nfunction rangeReader(repo: Repo) {\n\tconst promises = rawFs(repo) as {\n\t\tgetRange?: (\n\t\t\tkey: string,\n\t\t\tstart: number,\n\t\t\tend: number,\n\t\t) => Promise<Uint8Array | null>;\n\t};\n\tif (!promises.getRange) return null;\n\treturn (key: string, start: number, end: number) => {\n\t\tif (!promises.getRange) return Promise.resolve(null);\n\t\treturn promises.getRange(key, start, end);\n\t};\n}\n\n/**\n * A delta entry's reconstructed size, read from the header its deflated data\n * opens with. `null` when the bounded prefix doesn't yield a complete header.\n */\nasync function deltaResultSize(\n\tread: NonNullable<ReturnType<typeof rangeReader>>,\n\tpackKey: string,\n\tdataStart: number,\n): Promise<number | null> {\n\tconst compressed = await read(\n\t\tpackKey,\n\t\tdataStart,\n\t\tdataStart + DELTA_PROBE_BYTES - 1,\n\t);\n\tif (!compressed || compressed.byteLength === 0) return null;\n\n\tconst inflated = await inflatePrefix(\n\t\tnew Uint8Array(compressed),\n\t\tDELTA_HEADER_MAX_BYTES,\n\t);\n\tif (!inflated) return null;\n\n\tconst header = readDeltaHeader(inflated, 0);\n\treturn header.length <= inflated.byteLength ? header.resultSize : null;\n}\n\n/**\n * `oid`'s size in bytes, or `null` when it isn't a packed object this can read\n * (see the module comment for what that means to a caller).\n */\nexport async function getObjectSize(\n\trepo: Repo,\n\toid: string,\n): Promise<number | null> {\n\t// Without range reads the pack would have to be fetched whole, which is the\n\t// cost this exists to avoid — so report \"unknown\" and let the caller read.\n\tconst read = rangeReader(repo);\n\tif (!read) return null;\n\n\tconst located = await locatePackedObject(repo, oid);\n\tif (!located) return null;\n\n\tconst packKey = `${repo.gitdir}/objects/pack/${located.packName}`;\n\tconst probe = await read(\n\t\tpackKey,\n\t\tlocated.offset,\n\t\tlocated.offset + ENTRY_PROBE_BYTES - 1,\n\t);\n\tif (!probe || probe.byteLength === 0) return null;\n\n\tconst header = readEntryHeader(probe, 0);\n\t// A header that ran off the end of the probe is a header this read, not one\n\t// it can interpret.\n\tif (header.length > probe.byteLength) return null;\n\tif (header.type !== OBJ_OFS_DELTA && header.type !== OBJ_REF_DELTA) {\n\t\treturn header.size;\n\t}\n\n\t// The base reference sits between the entry header and the deflated delta\n\t// data: 20 bytes of oid for `REF_DELTA`, or a backwards offset for\n\t// `OFS_DELTA`.\n\tconst bodyStart = located.offset + header.length;\n\tlet dataStart: number;\n\tif (header.type === OBJ_REF_DELTA) {\n\t\tdataStart = bodyStart + OID_BYTES;\n\t} else {\n\t\tconst base = readOfsDeltaOffset(probe, header.length);\n\t\tif (header.length + base.length > probe.byteLength) return null;\n\t\tdataStart = bodyStart + base.length;\n\t}\n\treturn deltaResultSize(read, packKey, dataStart);\n}\n"],"mappings":"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","names":[]}