docs-cache 0.4.3 → 0.5.1

package/dist/cli.mjs

@@ -1,5 +1,5 @@
-import m from"node:path";import r from"node:process";import d from"picocolors";import{p as w,s as y,a as j,E as g,b as a,u as n}from"./shared/docs-cache.CQiaFDb_.mjs";import"cac";const f="docs-cache",O=`
-Usage: ${f} <command> [options]
+import p from"node:path";import r from"node:process";import d from"picocolors";import{ExitCode as l}from"#cli/exit-code";import{parseArgs as w}from"#cli/parse-args";import{setSilentMode as y,setVerboseMode as v,symbols as a,ui as o}from"#cli/ui";const h="docs-cache",j=`
+Usage: ${h} <command> [options]
 
 Commands:
   add         Add sources to the config (supports github:org/repo#ref)
@@ -29,15 +29,15 @@ Add options:
   --target <dir>
   --target-dir <path>
   --id <id>
-`,u=()=>{r.stdout.write(O.trimStart())},$=o=>{r.stderr.write(`${a.error} ${o}
-`)},D=async o=>{const l=o.command,e=o.options;if(l==="add"){const{addSources:c}=await import("./chunks/add.mjs"),{runSync:i}=await import("./chunks/sync.mjs").then(function(s){return s.s});if(o.entries.length===0)throw new Error("Usage: docs-cache add [--source <repo> --target <dir>] <repo...>");const t=await c({configPath:e.config,entries:o.entries});if(e.offline?e.json||n.line(`${a.warn} Offline: skipped sync`):await i({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json,lockOnly:e.lockOnly,offline:e.offline,failOnMiss:e.failOnMiss,sourceFilter:t.sources.map(s=>s.id),timeoutMs:e.timeoutMs,verbose:e.verbose}),e.json)r.stdout.write(`${JSON.stringify(t,null,2)}
-`);else{for(const s of t.sources){const h=s.repo.replace(/^https?:\/\//,"").replace(/\.git$/,""),v=s.targetDir?` ${d.dim("->")} ${d.magenta(s.targetDir)}`:"";n.item(a.success,s.id,`${d.blue(h)}${v}`)}t.skipped?.length&&n.line(`${a.warn} Skipped ${t.skipped.length} existing source${t.skipped.length===1?"":"s"}: ${t.skipped.join(", ")}`),n.line(`${a.info} Updated ${d.gray(m.relative(r.cwd(),t.configPath)||"docs.config.json")}`),t.gitignoreUpdated&&t.gitignorePath&&n.line(`${a.info} Updated ${d.gray(n.path(t.gitignorePath))}`)}return}if(l==="remove"){const{removeSources:c}=await import("./chunks/remove.mjs"),{pruneCache:i}=await import("./chunks/prune.mjs");if(o.ids.length===0)throw new Error("Usage: docs-cache remove <id...>");const t=await c({configPath:e.config,ids:o.ids});if(e.json)r.stdout.write(`${JSON.stringify(t,null,2)}
-`);else{if(t.removed.length>0&&n.line(`${a.success} Removed ${t.removed.length} source${t.removed.length===1?"":"s"}: ${t.removed.join(", ")}`),t.missing.length>0&&n.line(`${a.warn} Missing ${t.missing.length} source${t.missing.length===1?"":"s"}: ${t.missing.join(", ")}`),t.targetsRemoved.length>0){const s=t.targetsRemoved.map(h=>`${h.id} -> ${n.path(h.targetDir)}`).join(", ");n.line(`${a.success} Removed ${t.targetsRemoved.length} target${t.targetsRemoved.length===1?"":"s"}: ${s}`)}n.line(`${a.info} Updated ${d.gray(m.relative(r.cwd(),t.configPath)||"docs.config.json")}`)}e.prune&&await i({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json});return}if(l==="status"){const{getStatus:c,printStatus:i}=await import("./chunks/status.mjs"),t=await c({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json});e.json?r.stdout.write(`${JSON.stringify(t,null,2)}
-`):i(t);return}if(l==="clean"){const{cleanCache:c}=await import("./chunks/clean.mjs"),i=await c({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json});e.json?r.stdout.write(`${JSON.stringify(i,null,2)}
-`):i.removed?n.line(`${a.success} Removed cache at ${n.path(i.cacheDir)}`):n.line(`${a.info} Cache already missing at ${n.path(i.cacheDir)}`);return}if(l==="clean-cache"){const{cleanGitCache:c}=await import("./chunks/clean-git-cache.mjs"),i=await c();if(e.json)r.stdout.write(`${JSON.stringify(i,null,2)}
-`);else if(i.removed){const t=i.bytesFreed!==void 0?`${(i.bytesFreed/1024/1024).toFixed(2)} MB`:"unknown size",s=i.repoCount!==void 0?` (${i.repoCount} cached repositor${i.repoCount===1?"y":"ies"})`:"";n.line(`${a.success} Cleared global git cache${s}: ${t} freed`),n.line(`${a.info} Cache location: ${n.path(i.cacheDir)}`)}else n.line(`${a.info} Global git cache already empty at ${n.path(i.cacheDir)}`);return}if(l==="prune"){const{pruneCache:c}=await import("./chunks/prune.mjs"),i=await c({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json});e.json?r.stdout.write(`${JSON.stringify(i,null,2)}
-`):i.removed.length===0?n.line(`${a.info} No cache entries to prune.`):n.line(`${a.success} Pruned ${i.removed.length} cache entr${i.removed.length===1?"y":"ies"}: ${i.removed.join(", ")}`);return}if(l==="sync"){const{printSyncPlan:c,runSync:i}=await import("./chunks/sync.mjs").then(function(s){return s.s}),t=await i({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json,lockOnly:e.lockOnly,offline:e.offline,failOnMiss:e.failOnMiss,timeoutMs:e.timeoutMs,verbose:e.verbose});e.json?r.stdout.write(`${JSON.stringify(t,null,2)}
-`):c(t);return}if(l==="verify"){const{printVerify:c,verifyCache:i}=await import("./chunks/verify.mjs").then(function(s){return s.a}),t=await i({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json});e.json?r.stdout.write(`${JSON.stringify(t,null,2)}
-`):c(t),t.results.some(s=>!s.ok)&&r.exit(g.FatalError);return}if(l==="init"){const{initConfig:c}=await import("./chunks/init.mjs");if(e.config)throw new Error("Init does not accept --config. Use the project root.");const i=await c({cacheDirOverride:e.cacheDir,json:e.json});e.json?r.stdout.write(`${JSON.stringify(i,null,2)}
-`):(n.line(`${a.success} Wrote ${d.gray(n.path(i.configPath))}`),i.gitignoreUpdated&&i.gitignorePath&&n.line(`${a.info} Updated ${d.gray(n.path(i.gitignorePath))}`));return}n.line(`${f} ${l}: not implemented yet.`)};async function S(){try{r.on("uncaughtException",p),r.on("unhandledRejection",p);const o=w();y(o.options.silent),j(o.options.verbose),o.help&&(u(),r.exit(g.Success)),o.command||(u(),r.exit(g.InvalidArgument)),o.command!=="add"&&o.command!=="remove"&&o.positionals.length>0&&($(`${f}: unexpected arguments.`),u(),r.exit(g.InvalidArgument)),await D(o.parsed)}catch(o){p(o)}}function p(o){const l=o.message||String(o);$(l),r.exit(g.FatalError)}export{f as CLI_NAME,S as main};
+`,f=()=>{r.stdout.write(j.trimStart())},m=i=>{r.stderr.write(`${a.error} ${i}
+`)},O=async i=>{const e=i.options,{addSources:s}=await import("#commands/add"),{runSync:n}=await import("#commands/sync");if(i.entries.length===0)throw new Error("Usage: docs-cache add [--source <repo> --target <dir>] <repo...>");const t=await s({configPath:e.config,entries:i.entries});if(e.offline?e.json||o.line(`${a.warn} Offline: skipped sync`):await n({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json,lockOnly:e.lockOnly,offline:e.offline,failOnMiss:e.failOnMiss,sourceFilter:t.sources.map(c=>c.id),timeoutMs:e.timeoutMs,verbose:e.verbose}),e.json){r.stdout.write(`${JSON.stringify(t,null,2)}
+`);return}for(const c of t.sources){const g=c.repo.replace(/^https?:\/\//,"").replace(/\.git$/,""),$=c.targetDir?` ${d.dim("->")} ${d.magenta(c.targetDir)}`:"";o.item(a.success,c.id,`${d.blue(g)}${$}`)}t.skipped?.length&&o.line(`${a.warn} Skipped ${t.skipped.length} existing source${t.skipped.length===1?"":"s"}: ${t.skipped.join(", ")}`),o.line(`${a.info} Updated ${d.gray(p.relative(r.cwd(),t.configPath)||"docs.config.json")}`),t.gitignoreUpdated&&t.gitignorePath&&o.line(`${a.info} Updated ${d.gray(o.path(t.gitignorePath))}`)},D=async i=>{const e=i.options,{removeSources:s}=await import("#commands/remove"),{pruneCache:n}=await import("#commands/prune");if(i.ids.length===0)throw new Error("Usage: docs-cache remove <id...>");const t=await s({configPath:e.config,ids:i.ids});if(e.json){r.stdout.write(`${JSON.stringify(t,null,2)}
+`);return}if(t.removed.length>0&&o.line(`${a.success} Removed ${t.removed.length} source${t.removed.length===1?"":"s"}: ${t.removed.join(", ")}`),t.missing.length>0&&o.line(`${a.warn} Missing ${t.missing.length} source${t.missing.length===1?"":"s"}: ${t.missing.join(", ")}`),t.targetsRemoved.length>0){const c=t.targetsRemoved.map(g=>`${g.id} -> ${o.path(g.targetDir)}`).join(", ");o.line(`${a.success} Removed ${t.targetsRemoved.length} target${t.targetsRemoved.length===1?"":"s"}: ${c}`)}o.line(`${a.info} Updated ${d.gray(p.relative(r.cwd(),t.configPath)||"docs.config.json")}`),e.prune&&await n({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json})},S=async i=>{const e=i.options,{getStatus:s,printStatus:n}=await import("#commands/status"),t=await s({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json});if(e.json){r.stdout.write(`${JSON.stringify(t,null,2)}
+`);return}n(t)},P=async i=>{const e=i.options,{cleanCache:s}=await import("#commands/clean"),n=await s({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json});if(e.json){r.stdout.write(`${JSON.stringify(n,null,2)}
+`);return}if(n.removed){o.line(`${a.success} Removed cache at ${o.path(n.cacheDir)}`);return}o.line(`${a.info} Cache already missing at ${o.path(n.cacheDir)}`)},C=async i=>{const e=i.options,{cleanGitCache:s}=await import("#commands/clean-git-cache"),n=await s();if(e.json){r.stdout.write(`${JSON.stringify(n,null,2)}
+`);return}if(!n.removed){o.line(`${a.info} Global git cache already empty at ${o.path(n.cacheDir)}`);return}const t=n.bytesFreed!==void 0?`${(n.bytesFreed/1024/1024).toFixed(2)} MB`:"unknown size",c=n.repoCount!==void 0?` (${n.repoCount} cached repositor${n.repoCount===1?"y":"ies"})`:"";o.line(`${a.success} Cleared global git cache${c}: ${t} freed`),o.line(`${a.info} Cache location: ${o.path(n.cacheDir)}`)},b=async i=>{const e=i.options,{pruneCache:s}=await import("#commands/prune"),n=await s({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json});if(e.json){r.stdout.write(`${JSON.stringify(n,null,2)}
+`);return}if(n.removed.length===0){o.line(`${a.info} No cache entries to prune.`);return}o.line(`${a.success} Pruned ${n.removed.length} cache entr${n.removed.length===1?"y":"ies"}: ${n.removed.join(", ")}`)},k=async i=>{const e=i.options,{printSyncPlan:s,runSync:n}=await import("#commands/sync"),t=await n({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json,lockOnly:e.lockOnly,offline:e.offline,failOnMiss:e.failOnMiss,timeoutMs:e.timeoutMs,verbose:e.verbose});if(e.json){r.stdout.write(`${JSON.stringify(t,null,2)}
+`);return}s(t)},M=async i=>{const e=i.options,{printVerify:s,verifyCache:n}=await import("#commands/verify"),t=await n({configPath:e.config,cacheDirOverride:e.cacheDir,json:e.json});e.json?r.stdout.write(`${JSON.stringify(t,null,2)}
+`):s(t),t.results.some(c=>!c.ok)&&r.exit(l.FatalError)},x=async i=>{const e=i.options,{initConfig:s}=await import("#commands/init");if(e.config)throw new Error("Init does not accept --config. Use the project root.");const n=await s({cacheDirOverride:e.cacheDir,json:e.json});if(e.json){r.stdout.write(`${JSON.stringify(n,null,2)}
+`);return}o.line(`${a.success} Wrote ${d.gray(o.path(n.configPath))}`),n.gitignoreUpdated&&n.gitignorePath&&o.line(`${a.info} Updated ${d.gray(o.path(n.gitignorePath))}`)},N=async i=>{switch(i.command){case"add":await O(i);return;case"remove":await D(i);return;case"status":await S(i);return;case"clean":await P(i);return;case"clean-cache":await C(i);return;case"prune":await b(i);return;case"sync":await k(i);return;case"verify":await M(i);return;case"init":await x(i);return;default:o.line(`${h} ${i.command}: not implemented yet.`)}};async function R(){try{r.on("uncaughtException",u),r.on("unhandledRejection",u);const i=w();y(i.options.silent),v(i.options.verbose),i.help&&(f(),r.exit(l.Success)),i.command||(f(),r.exit(l.InvalidArgument)),i.command!=="add"&&i.command!=="remove"&&i.positionals.length>0&&(m(`${h}: unexpected arguments.`),f(),r.exit(l.InvalidArgument)),await N(i.parsed)}catch(i){u(i)}}function u(i){const e=i instanceof Error?i.message:String(i);m(e),r.exit(l.FatalError)}export{h as CLI_NAME,R as main};
 //# sourceMappingURL=cli.mjs.map

package/dist/esm/api.d.ts

@@ -0,0 +1,14 @@
+export { DEFAULT_LOCK_FILENAME } from "#cache/lock";
+export { applyTargetDir } from "#cache/targets";
+export { parseArgs } from "#cli/parse-args";
+export { cleanCache } from "#commands/clean";
+export { cleanGitCache } from "#commands/clean-git-cache";
+export { initConfig } from "#commands/init";
+export { pruneCache } from "#commands/prune";
+export { removeSources } from "#commands/remove";
+export { printSyncPlan, runSync } from "#commands/sync";
+export { verifyCache } from "#commands/verify";
+export { loadConfig } from "#config";
+export { redactRepoUrl } from "#git/redact";
+export { enforceHostAllowlist, parseLsRemote } from "#git/resolve-remote";
+export { resolveRepoInput } from "#git/resolve-repo";

package/dist/esm/api.mjs

@@ -0,0 +1,14 @@
+export { DEFAULT_LOCK_FILENAME } from "#cache/lock";
+export { applyTargetDir } from "#cache/targets";
+export { parseArgs } from "#cli/parse-args";
+export { cleanCache } from "#commands/clean";
+export { cleanGitCache } from "#commands/clean-git-cache";
+export { initConfig } from "#commands/init";
+export { pruneCache } from "#commands/prune";
+export { removeSources } from "#commands/remove";
+export { printSyncPlan, runSync } from "#commands/sync";
+export { verifyCache } from "#commands/verify";
+export { loadConfig } from "#config";
+export { redactRepoUrl } from "#git/redact";
+export { enforceHostAllowlist, parseLsRemote } from "#git/resolve-remote";
+export { resolveRepoInput } from "#git/resolve-repo";

package/dist/esm/cache/cache-layout.d.ts

@@ -0,0 +1 @@
+export declare const ensureCacheLayout: (cacheDir: string, sourceIds: string[]) => Promise<void>;

package/dist/esm/cache/cache-layout.mjs

@@ -0,0 +1,12 @@
+import { mkdir } from "node:fs/promises";
+import { getCacheLayout } from "#core/paths";
+export const ensureCacheLayout = async (cacheDir, sourceIds) => {
+  const base = getCacheLayout(cacheDir, "tmp");
+  await mkdir(base.cacheDir, { recursive: true });
+  await Promise.all(
+    sourceIds.map(async (sourceId) => {
+      const layout = getCacheLayout(cacheDir, sourceId);
+      await mkdir(layout.sourceDir, { recursive: true });
+    })
+  );
+};

package/dist/esm/cache/lock.d.ts

@@ -0,0 +1,21 @@
+export interface DocsCacheLockSource {
+    repo: string;
+    ref: string;
+    resolvedCommit: string;
+    bytes: number;
+    fileCount: number;
+    manifestSha256: string;
+    rulesSha256?: string;
+    updatedAt: string;
+}
+export interface DocsCacheLock {
+    version: 1;
+    generatedAt: string;
+    toolVersion: string;
+    sources: Record<string, DocsCacheLockSource>;
+}
+export declare const DEFAULT_LOCK_FILENAME = "docs-lock.json";
+export declare const validateLock: (input: unknown) => DocsCacheLock;
+export declare const resolveLockPath: (configPath: string) => any;
+export declare const readLock: (lockPath: string) => Promise<DocsCacheLock>;
+export declare const writeLock: (lockPath: string, lock: DocsCacheLock) => Promise<void>;

package/dist/esm/cache/lock.mjs

@@ -0,0 +1,91 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+export const DEFAULT_LOCK_FILENAME = "docs-lock.json";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const assertString = (value, label) => {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`${label} must be a non-empty string.`);
+  }
+  return value;
+};
+const assertNumber = (value, label) => {
+  if (typeof value !== "number" || Number.isNaN(value)) {
+    throw new Error(`${label} must be a number.`);
+  }
+  return value;
+};
+const assertPositiveNumber = (value, label) => {
+  const numberValue = assertNumber(value, label);
+  if (numberValue < 0) {
+    throw new Error(`${label} must be zero or greater.`);
+  }
+  return numberValue;
+};
+export const validateLock = (input) => {
+  if (!isRecord(input)) {
+    throw new Error("Lock file must be a JSON object.");
+  }
+  const version = input.version;
+  if (version !== 1) {
+    throw new Error("Lock file version must be 1.");
+  }
+  const generatedAt = assertString(input.generatedAt, "generatedAt");
+  const toolVersion = assertString(input.toolVersion, "toolVersion");
+  if (!isRecord(input.sources)) {
+    throw new Error("sources must be an object.");
+  }
+  const sources = {};
+  for (const [key, value] of Object.entries(input.sources)) {
+    if (!isRecord(value)) {
+      throw new Error(`sources.${key} must be an object.`);
+    }
+    sources[key] = {
+      repo: assertString(value.repo, `sources.${key}.repo`),
+      ref: assertString(value.ref, `sources.${key}.ref`),
+      resolvedCommit: assertString(
+        value.resolvedCommit,
+        `sources.${key}.resolvedCommit`
+      ),
+      bytes: assertPositiveNumber(value.bytes, `sources.${key}.bytes`),
+      fileCount: assertPositiveNumber(
+        value.fileCount,
+        `sources.${key}.fileCount`
+      ),
+      manifestSha256: assertString(
+        value.manifestSha256,
+        `sources.${key}.manifestSha256`
+      ),
+      rulesSha256: value.rulesSha256 === void 0 ? void 0 : assertString(value.rulesSha256, `sources.${key}.rulesSha256`),
+      updatedAt: assertString(value.updatedAt, `sources.${key}.updatedAt`)
+    };
+  }
+  return {
+    version: 1,
+    generatedAt,
+    toolVersion,
+    sources
+  };
+};
+export const resolveLockPath = (configPath) => path.resolve(path.dirname(configPath), DEFAULT_LOCK_FILENAME);
+export const readLock = async (lockPath) => {
+  let raw;
+  try {
+    raw = await readFile(lockPath, "utf8");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to read lock file at ${lockPath}: ${message}`);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Invalid JSON in ${lockPath}: ${message}`);
+  }
+  return validateLock(parsed);
+};
+export const writeLock = async (lockPath, lock) => {
+  const data = `${JSON.stringify(lock, null, 2)}
+`;
+  await writeFile(lockPath, data, "utf8");
+};

package/dist/esm/cache/manifest.d.ts

@@ -0,0 +1,11 @@
+export type ManifestEntry = {
+    path: string;
+    size: number;
+};
+export declare const MANIFEST_FILENAME = ".manifest.jsonl";
+export declare const readManifest: (sourceDir: string) => Promise<{
+    manifestPath: any;
+    entries: ManifestEntry[];
+}>;
+export declare const streamManifestEntries: (sourceDir: string) => AsyncGenerator<ManifestEntry>;
+export declare const hasManifestEntries: (sourceDir: string) => Promise<boolean>;

package/dist/esm/cache/manifest.mjs

@@ -0,0 +1,68 @@
+import { createReadStream } from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+const parseManifestEntry = (value) => {
+  if (!value || typeof value !== "object") {
+    throw new Error("Manifest entry must be an object.");
+  }
+  const record = value;
+  if (typeof record.path !== "string" || record.path.length === 0) {
+    throw new Error("Manifest entry path must be a non-empty string.");
+  }
+  if (typeof record.size !== "number" || Number.isNaN(record.size)) {
+    throw new Error("Manifest entry size must be a number.");
+  }
+  if (record.size < 0) {
+    throw new Error("Manifest entry size must be zero or greater.");
+  }
+  return { path: record.path, size: record.size };
+};
+export const MANIFEST_FILENAME = ".manifest.jsonl";
+export const readManifest = async (sourceDir) => {
+  const manifestPath = path.join(sourceDir, MANIFEST_FILENAME);
+  const entries = [];
+  const stream = createReadStream(manifestPath, { encoding: "utf8" });
+  const lines = readline.createInterface({
+    input: stream,
+    crlfDelay: Infinity
+  });
+  try {
+    for await (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) {
+        continue;
+      }
+      entries.push(parseManifestEntry(JSON.parse(trimmed)));
+    }
+    return { manifestPath, entries };
+  } finally {
+    lines.close();
+    stream.destroy();
+  }
+};
+export const streamManifestEntries = async function* (sourceDir) {
+  const manifestPath = path.join(sourceDir, MANIFEST_FILENAME);
+  const stream = createReadStream(manifestPath, { encoding: "utf8" });
+  const lines = readline.createInterface({
+    input: stream,
+    crlfDelay: Infinity
+  });
+  try {
+    for await (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) {
+        continue;
+      }
+      yield parseManifestEntry(JSON.parse(trimmed));
+    }
+  } finally {
+    lines.close();
+    stream.destroy();
+  }
+};
+export const hasManifestEntries = async (sourceDir) => {
+  for await (const _entry of streamManifestEntries(sourceDir)) {
+    return true;
+  }
+  return false;
+};

package/dist/esm/cache/materialize.d.ts

@@ -0,0 +1,26 @@
+type MaterializeParams = {
+    sourceId: string;
+    repoDir: string;
+    cacheDir: string;
+    include: string[];
+    exclude?: string[];
+    maxBytes: number;
+    maxFiles?: number;
+    ignoreHidden?: boolean;
+    unwrapSingleRootDir?: boolean;
+    json?: boolean;
+    progressLogger?: (message: string) => void;
+    progressThrottleMs?: number;
+};
+type ManifestStats = {
+    bytes: number;
+    fileCount: number;
+    manifestSha256: string;
+};
+export declare const materializeSource: (params: MaterializeParams) => Promise<{
+    bytes: number;
+    fileCount: number;
+    manifestSha256: string;
+}>;
+export declare const computeManifestHash: (params: MaterializeParams) => Promise<ManifestStats>;
+export {};