docs-cache 0.4.3 → 0.5.1

package/dist/esm/git/resolve-remote.mjs

@@ -0,0 +1,87 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { redactRepoUrl } from "#git/redact";
+const execFileAsync = promisify(execFile);
+const DEFAULT_TIMEOUT_MS = 3e4;
+const BLOCKED_PROTOCOLS = /* @__PURE__ */ new Set(["file:", "ftp:", "data:", "javascript:"]);
+const assertAllowedProtocol = (repo) => {
+  try {
+    const url = new URL(repo);
+    if (BLOCKED_PROTOCOLS.has(url.protocol)) {
+      throw new Error(
+        `Blocked protocol '${url.protocol}' in repo URL '${redactRepoUrl(repo)}'.`
+      );
+    }
+  } catch (error) {
+    if (error instanceof TypeError) {
+      return;
+    }
+    throw error;
+  }
+};
+const parseRepoHost = (repo) => {
+  assertAllowedProtocol(repo);
+  const scpMatch = repo.match(/^[^@]+@([^:]+):/);
+  if (scpMatch) {
+    return scpMatch[1] || null;
+  }
+  try {
+    const url = new URL(repo);
+    if (url.protocol !== "https:" && url.protocol !== "ssh:") {
+      return null;
+    }
+    return url.hostname || null;
+  } catch {
+    return null;
+  }
+};
+export const enforceHostAllowlist = (repo, allowHosts) => {
+  const host = parseRepoHost(repo);
+  if (!host) {
+    throw new Error(
+      `Unsupported repo URL '${redactRepoUrl(repo)}'. Use HTTPS or SSH.`
+    );
+  }
+  const normalizedHost = host.toLowerCase();
+  const allowed = allowHosts.map((entry) => entry.toLowerCase());
+  const isAllowed = allowed.some(
+    (entry) => normalizedHost === entry || normalizedHost.endsWith(`.${entry}`)
+  );
+  if (!isAllowed) {
+    throw new Error(
+      `Host '${host}' is not in allowHosts for '${redactRepoUrl(repo)}'.`
+    );
+  }
+};
+export const parseLsRemote = (stdout) => {
+  const lines = stdout.trim().split("\n").filter(Boolean);
+  if (lines.length === 0) {
+    return null;
+  }
+  const first = lines[0].split(/\s+/)[0];
+  return first || null;
+};
+export const resolveRemoteCommit = async (params) => {
+  enforceHostAllowlist(params.repo, params.allowHosts);
+  const repoLabel = redactRepoUrl(params.repo);
+  params.logger?.(`git ls-remote ${repoLabel} ${params.ref}`);
+  const { stdout } = await execFileAsync(
+    "git",
+    ["ls-remote", params.repo, params.ref],
+    {
+      timeout: params.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+      maxBuffer: 1024 * 1024
+    }
+  );
+  const resolvedCommit = parseLsRemote(stdout);
+  if (!resolvedCommit) {
+    throw new Error(
+      `Unable to resolve ref '${params.ref}' for ${redactRepoUrl(params.repo)}.`
+    );
+  }
+  return {
+    repo: params.repo,
+    ref: params.ref,
+    resolvedCommit
+  };
+};

package/dist/esm/git/resolve-repo.d.ts

@@ -0,0 +1,5 @@
+export declare const resolveRepoInput: (repo: string) => {
+    repoUrl: string;
+    ref: string | undefined;
+    inferredId: string | undefined;
+};

package/dist/esm/git/resolve-repo.mjs

@@ -0,0 +1,52 @@
+export const resolveRepoInput = (repo) => {
+  const trimmed = repo.trim();
+  const sshMatch = trimmed.match(/^git@([^:]+):(.+)$/);
+  if (sshMatch) {
+    const host = sshMatch[1];
+    const rawPath = sshMatch[2];
+    const [pathPart, rawRef] = rawPath.split("#", 2);
+    const sanitizedPath = pathPart.replace(/^\//, "");
+    const inferredId = sanitizedPath.split("/").filter(Boolean).pop()?.replace(/\.git$/i, "");
+    const repoUrl = `git@${host}:${sanitizedPath}`;
+    const ref = rawRef?.trim() || void 0;
+    return { repoUrl, ref, inferredId };
+  }
+  const plainMatch = trimmed.match(/^([^\s/:]+)\/([^\s#]+)(?:#(.+))?$/);
+  if (plainMatch) {
+    const [, owner, name, rawRef] = plainMatch;
+    const sanitizedPath = `${owner}/${name}`.replace(/\.git$/i, "");
+    const repoUrl = `https://github.com/${sanitizedPath}.git`;
+    return {
+      repoUrl,
+      ref: rawRef?.trim() || void 0,
+      inferredId: name.replace(/\.git$/i, "")
+    };
+  }
+  const shortcutMatch = trimmed.match(/^(github|gitlab):(.+)$/i);
+  if (shortcutMatch) {
+    const provider = shortcutMatch[1].toLowerCase();
+    const rawPath = shortcutMatch[2];
+    const [pathPart, rawRef] = rawPath.split("#", 2);
+    const sanitizedPath = pathPart.replace(/^\//, "");
+    const inferredId = sanitizedPath.split("/").filter(Boolean).pop()?.replace(/\.git$/i, "");
+    const host = provider === "gitlab" ? "gitlab.com" : "github.com";
+    const suffix = sanitizedPath.endsWith(".git") ? "" : ".git";
+    const repoUrl = `https://${host}/${sanitizedPath}${suffix}`;
+    const ref = rawRef?.trim() || void 0;
+    return { repoUrl, ref, inferredId };
+  }
+  try {
+    const url = new URL(trimmed);
+    if (url.protocol === "https:" || url.protocol === "ssh:") {
+      const parts = url.pathname.split("/").filter(Boolean);
+      const inferredId = parts.pop()?.replace(/\.git$/i, "");
+      return {
+        repoUrl: trimmed,
+        ref: void 0,
+        inferredId
+      };
+    }
+  } catch {
+  }
+  return { repoUrl: trimmed, ref: void 0, inferredId: void 0 };
+};

package/dist/esm/gitignore.d.ts

@@ -0,0 +1,18 @@
+export declare const getGitignoreStatus: (rootDir: string, cacheDir: string) => Promise<{
+    gitignorePath: any;
+    entry: null;
+    hasEntry: boolean;
+} | {
+    gitignorePath: any;
+    entry: string;
+    hasEntry: boolean;
+}>;
+export declare const ensureGitignoreEntry: (rootDir: string, cacheDir: string) => Promise<{
+    updated: boolean;
+    gitignorePath: any;
+    entry: null;
+} | {
+    updated: boolean;
+    gitignorePath: any;
+    entry: string;
+}>;

package/dist/esm/gitignore.mjs

@@ -0,0 +1,80 @@
+import { access, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { toPosixPath } from "#core/paths";
+const exists = async (target) => {
+  try {
+    await access(target);
+    return true;
+  } catch {
+    return false;
+  }
+};
+const normalizeEntry = (value) => {
+  const trimmed = value.trim();
+  if (!trimmed || trimmed.startsWith("#") || trimmed.startsWith("!")) {
+    return "";
+  }
+  let normalized = trimmed.replace(/^\//, "");
+  normalized = normalized.replace(/^\.\//, "");
+  normalized = normalized.replace(/\/+$/, "");
+  return toPosixPath(normalized);
+};
+const resolveGitignoreEntry = (rootDir, cacheDir) => {
+  const resolved = path.isAbsolute(cacheDir) ? path.resolve(cacheDir) : path.resolve(rootDir, cacheDir);
+  const relative = path.relative(rootDir, resolved);
+  const isOutside = relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative);
+  if (isOutside) {
+    return null;
+  }
+  return relative.length === 0 ? "." : relative;
+};
+export const getGitignoreStatus = async (rootDir, cacheDir) => {
+  const gitignorePath = path.resolve(rootDir, ".gitignore");
+  const entry = resolveGitignoreEntry(rootDir, cacheDir);
+  if (!entry) {
+    return { gitignorePath, entry: null, hasEntry: false };
+  }
+  const normalizedEntry = normalizeEntry(entry);
+  if (!normalizedEntry) {
+    return { gitignorePath, entry: null, hasEntry: false };
+  }
+  let contents = "";
+  if (await exists(gitignorePath)) {
+    contents = await readFile(gitignorePath, "utf8");
+  }
+  const lines = contents.split(/\r?\n/);
+  const existing = new Set(
+    lines.map((line) => normalizeEntry(line)).filter(Boolean)
+  );
+  return {
+    gitignorePath,
+    entry: `${normalizedEntry}/`,
+    hasEntry: existing.has(normalizedEntry)
+  };
+};
+export const ensureGitignoreEntry = async (rootDir, cacheDir) => {
+  const status = await getGitignoreStatus(rootDir, cacheDir);
+  if (!status.entry) {
+    return { updated: false, gitignorePath: status.gitignorePath, entry: null };
+  }
+  if (status.hasEntry) {
+    return {
+      updated: false,
+      gitignorePath: status.gitignorePath,
+      entry: status.entry
+    };
+  }
+  let contents = "";
+  if (await exists(status.gitignorePath)) {
+    contents = await readFile(status.gitignorePath, "utf8");
+  }
+  const prefix = contents.length === 0 || contents.endsWith("\n") ? "" : "\n";
+  const next = `${contents}${prefix}${status.entry}
+`;
+  await writeFile(status.gitignorePath, next, "utf8");
+  return {
+    updated: true,
+    gitignorePath: status.gitignorePath,
+    entry: status.entry
+  };
+};

package/dist/esm/paths.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_TOC_FILENAME = "TOC.md";
+export declare const toPosixPath: (value: string) => string;
+export declare const resolveTargetDir: (configPath: string, targetDir: string) => any;
+export declare const resolveCacheDir: (configPath: string, cacheDir: string, overrideCacheDir?: string) => any;
+export declare const getCacheLayout: (cacheDir: string, sourceId: string) => {
+    cacheDir: string;
+    sourceDir: any;
+};

package/dist/esm/paths.mjs

@@ -0,0 +1,34 @@
+import path from "node:path";
+export const DEFAULT_TOC_FILENAME = "TOC.md";
+export const toPosixPath = (value) => value.replace(/\\/g, "/");
+export const resolveTargetDir = (configPath, targetDir) => {
+  const configDir = path.dirname(path.resolve(configPath));
+  const resolved = path.resolve(configDir, targetDir);
+  const relative = path.relative(configDir, resolved);
+  const isOutside = relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative);
+  if (isOutside) {
+    throw new Error(
+      `targetDir '${targetDir}' escapes project directory. Must be within ${configDir}.`
+    );
+  }
+  const segments = toPosixPath(relative).split("/").filter(Boolean);
+  if (segments.includes(".git")) {
+    throw new Error("targetDir cannot be within .git directory.");
+  }
+  return resolved;
+};
+export const resolveCacheDir = (configPath, cacheDir, overrideCacheDir) => {
+  if (overrideCacheDir) {
+    return path.resolve(overrideCacheDir);
+  }
+  const configDir = path.dirname(configPath);
+  return path.resolve(configDir, cacheDir);
+};
+export const getCacheLayout = (cacheDir, sourceId) => {
+  const _reposDir = path.join(cacheDir, "repos");
+  const sourceDir = path.join(cacheDir, sourceId);
+  return {
+    cacheDir,
+    sourceDir
+  };
+};

package/dist/esm/source-id.d.ts

@@ -0,0 +1 @@
+export declare const assertSafeSourceId: (value: unknown, label: string) => string;

package/dist/esm/source-id.mjs

@@ -0,0 +1,29 @@
+const SAFE_ID_PATTERN = /^[a-zA-Z0-9_-]+$/;
+const MAX_ID_LENGTH = 200;
+const RESERVED_NAMES = /* @__PURE__ */ new Set([
+  ".",
+  "..",
+  "CON",
+  "PRN",
+  "AUX",
+  "NUL",
+  "COM1",
+  "LPT1"
+]);
+export const assertSafeSourceId = (value, label) => {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`${label} must be a non-empty string.`);
+  }
+  if (value.length > MAX_ID_LENGTH) {
+    throw new Error(`${label} exceeds maximum length of ${MAX_ID_LENGTH}.`);
+  }
+  if (!SAFE_ID_PATTERN.test(value)) {
+    throw new Error(
+      `${label} must contain only alphanumeric characters, hyphens, and underscores.`
+    );
+  }
+  if (RESERVED_NAMES.has(value.toUpperCase())) {
+    throw new Error(`${label} uses reserved name '${value}'.`);
+  }
+  return value;
+};

package/dist/esm/types/sync.d.ts

@@ -0,0 +1,25 @@
+export type SyncOptions = {
+    configPath?: string;
+    cacheDirOverride?: string;
+    json: boolean;
+    lockOnly: boolean;
+    offline: boolean;
+    failOnMiss: boolean;
+    verbose?: boolean;
+    concurrency?: number;
+    sourceFilter?: string[];
+    timeoutMs?: number;
+};
+export type SyncResult = {
+    id: string;
+    repo: string;
+    ref: string;
+    resolvedCommit: string;
+    lockCommit: string | null;
+    lockRulesSha256?: string;
+    status: "up-to-date" | "changed" | "missing";
+    bytes?: number;
+    fileCount?: number;
+    manifestSha256?: string;
+    rulesSha256?: string;
+};

package/package.json

@@ -1,92 +1,139 @@
 {
-  "name": "docs-cache",
-  "private": false,
-  "type": "module",
-  "version": "0.4.3",
-  "description": "CLI for deterministic local caching of external documentation for agents and tools",
-  "author": "Frederik Bosch",
-  "license": "MIT",
-  "homepage": "https://github.com/fbosch/docs-cache#readme",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/fbosch/docs-cache.git"
-  },
-  "bugs": {
-    "url": "https://github.com/fbosch/docs-cache/issues"
-  },
-  "keywords": [
-    "docs",
-    "documentation",
-    "cache",
-    "agent",
-    "ai",
-    "git",
-    "cli"
-  ],
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "bin": {
-    "docs-cache": "./bin/docs-cache.mjs"
-  },
-  "files": [
-    "bin",
-    "dist/cli.mjs",
-    "dist/chunks/*.mjs",
-    "dist/lock.mjs",
-    "dist/shared/*.mjs",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "@clack/prompts": "^1.0.0",
-    "cac": "^6.7.14",
-    "execa": "^9.6.1",
-    "fast-glob": "^3.3.2",
-    "picocolors": "^1.1.1",
-    "picomatch": "^2.3.1",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.3.8",
-    "@size-limit/file": "^11.2.0",
-    "@types/node": "^24.2.1",
-    "bumpp": "^10.3.2",
-    "c8": "^10.1.3",
-    "jiti": "^2.5.1",
-    "lint-staged": "^16.2.7",
-    "simple-git-hooks": "^2.13.1",
-    "size-limit": "^11.2.0",
-    "tinybench": "^6.0.0",
-    "typescript": "^5.9.3",
-    "unbuild": "^3.6.1"
-  },
-  "size-limit": [
-    {
-      "path": "dist/cli.mjs",
-      "limit": "10 kB"
-    }
-  ],
-  "simple-git-hooks": {
-    "pre-commit": "pnpm lint-staged && pnpm typecheck"
-  },
-  "lint-staged": {
-    "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
-      "biome check --write --no-errors-on-unmatched"
-    ]
-  },
-  "scripts": {
-    "build": "unbuild",
-    "dev": "unbuild --stub",
-    "lint": "biome check .",
-    "release": "pnpm run lint && pnpm run typecheck && bumpp && pnpm publish --access public",
-    "test": "pnpm build && node --test",
-    "test:coverage": "pnpm build && c8 --include dist --exclude bin --reporter=text node --test",
-    "bench": "pnpm build && node scripts/benchmarks/run.mjs",
-    "schema:build": "node scripts/generate-schema.mjs",
-    "size": "size-limit",
-    "test:watch": "node --test --watch",
-    "typecheck": "tsc --noEmit"
-  }
-}
+	"name": "docs-cache",
+	"private": false,
+	"type": "module",
+	"version": "0.5.1",
+	"packageManager": "pnpm@10.14.0+sha512.ad27a79641b49c3e481a16a805baa71817a04bbe06a38d17e60e2eaee83f6a146c6a688125f5792e48dd5ba30e7da52a5cda4c3992b9ccf333f9ce223af84748",
+	"description": "CLI for deterministic local caching of external documentation for agents and tools",
+	"author": "Frederik Bosch",
+	"license": "MIT",
+	"homepage": "https://github.com/fbosch/docs-cache#readme",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/fbosch/docs-cache.git"
+	},
+	"bugs": {
+		"url": "https://github.com/fbosch/docs-cache/issues"
+	},
+	"keywords": [
+		"docs",
+		"documentation",
+		"cache",
+		"agent",
+		"ai",
+		"git",
+		"cli"
+	],
+	"sideEffects": false,
+	"engines": {
+		"node": ">=18"
+	},
+	"bin": {
+		"docs-cache": "./bin/docs-cache.mjs"
+	},
+	"files": [
+		"bin",
+		"dist/cli.mjs",
+		"dist/esm/**/*.mjs",
+		"dist/esm/**/*.d.ts",
+		"dist/lock.mjs",
+		"dist/shared/*.mjs",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"build": "unbuild",
+		"dev": "unbuild --stub",
+		"lint": "biome check .",
+		"prepublishOnly": "pnpm audit --audit-level=high && pnpm build && pnpm size && pnpm schema:build",
+		"release": "pnpm run lint && pnpm run typecheck && bumpp && pnpm publish --access public",
+		"test": "pnpm build && node --test",
+		"test:coverage": "pnpm build && c8 --include dist --exclude bin --reporter=text node --test",
+		"bench": "pnpm build && node scripts/benchmarks/run.mjs",
+		"complexity": "node scripts/complexity/run.mjs",
+		"schema:build": "node scripts/generate-schema.mjs",
+		"size": "size-limit",
+		"test:watch": "node --test --watch",
+		"typecheck": "tsc --noEmit",
+		"prepare": "simple-git-hooks"
+	},
+	"imports": {
+		"#cache/*": {
+			"types": "./dist/esm/cache/*.d.ts",
+			"default": "./dist/esm/cache/*.mjs"
+		},
+		"#cli/*": {
+			"types": "./dist/esm/cli/*.d.ts",
+			"default": "./dist/esm/cli/*.mjs"
+		},
+		"#commands/*": {
+			"types": "./dist/esm/commands/*.d.ts",
+			"default": "./dist/esm/commands/*.mjs"
+		},
+		"#core/*": {
+			"types": "./dist/esm/*.d.ts",
+			"default": "./dist/esm/*.mjs"
+		},
+		"#config": {
+			"types": "./dist/esm/config/index.d.ts",
+			"default": "./dist/esm/config/index.mjs"
+		},
+		"#config/*": {
+			"types": "./dist/esm/config/*.d.ts",
+			"default": "./dist/esm/config/*.mjs"
+		},
+		"#git/*": {
+			"types": "./dist/esm/git/*.d.ts",
+			"default": "./dist/esm/git/*.mjs"
+		},
+		"#types/*": {
+			"types": "./dist/esm/types/*.d.ts",
+			"default": "./dist/esm/types/*.mjs"
+		}
+	},
+	"dependencies": {
+		"@clack/prompts": "^1.0.0",
+		"cac": "^6.7.14",
+		"cli-truncate": "^4.0.0",
+		"execa": "^9.6.1",
+		"fast-glob": "^3.3.2",
+		"log-update": "^7.0.2",
+		"picocolors": "^1.1.1",
+		"picomatch": "^4.0.3",
+		"zod": "^4.3.6"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.14",
+		"@size-limit/file": "^12.0.0",
+		"@types/node": "^25.2.0",
+		"bumpp": "^10.3.2",
+		"c8": "^10.1.3",
+		"jiti": "^2.5.1",
+		"lint-staged": "^16.2.7",
+		"simple-git-hooks": "^2.13.1",
+		"size-limit": "^12.0.0",
+		"tinybench": "^6.0.0",
+		"ts-complex": "^1.0.0",
+		"typescript": "^5.9.3",
+		"unbuild": "^3.6.1"
+	},
+	"size-limit": [
+		{
+			"path": "dist/cli.mjs",
+			"limit": "10 kB"
+		}
+	],
+	"complexity": {
+		"maxCyclomatic": 20,
+		"minMaintainability": 60,
+		"top": 10
+	},
+	"simple-git-hooks": {
+		"pre-commit": "pnpm lint-staged && pnpm typecheck"
+	},
+	"lint-staged": {
+		"*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
+			"biome check --write --no-errors-on-unmatched"
+		]
+	}
+}

package/dist/chunks/add.mjs

@@ -1,3 +0,0 @@
-import{readFile as D,writeFile as k,access as E}from"node:fs/promises";import l from"node:path";import{v,D as P,a as A,s as F,w as I,b as U,r as S}from"../shared/docs-cache.CaOcl4OS.mjs";import{e as N}from"../shared/docs-cache.BOr9BnyP.mjs";import{r as O}from"../shared/docs-cache.CQiaFDb_.mjs";import{r as x}from"../shared/docs-cache.BSvQNKuf.mjs";import"zod";import"node:process";import"cac";import"picocolors";const u=async o=>{try{return await E(o),!0}catch{return!1}},y="package.json",C=async o=>{const i=await D(o,"utf8"),e=JSON.parse(i),a=e["docs-cache"];return a?{parsed:e,config:v(a)}:{parsed:e,config:null}},J=async o=>{if(o){const a=S(o);return{resolvedPath:a,mode:l.basename(a)===y?"package":"config"}}const i=S();if(await u(i))return{resolvedPath:i,mode:"config"};const e=l.resolve(process.cwd(),y);return await u(e)&&(await C(e)).config?{resolvedPath:e,mode:"package"}:{resolvedPath:i,mode:"config"}},T=async o=>{const i=await J(o.configPath),e=i.resolvedPath;let a=P,t=null,g=null,f=!1;if(await u(e))if(i.mode==="package"){const r=await C(e);g=r.parsed,t=r.config,a=t??P,f=!!t}else{const r=await D(e,"utf8");t=JSON.parse(r.toString()),a=v(t),f=!0}const b="https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",p=new Set(a.sources.map(r=>r.id)),m=[],d=o.entries.map(r=>{const n=x(r.repo),w=r.id||n.inferredId;if(!w)throw new Error("Unable to infer id. Provide an explicit id.");const c=A(w,"source id");return p.has(c)?(m.push(c),null):(p.add(c),r.targetDir&&O(e,r.targetDir),{id:c,repo:n.repoUrl,...r.targetDir?{targetDir:r.targetDir}:{},...n.ref?{ref:n.ref}:{}})}).filter(Boolean);if(d.length===0)throw new Error("All sources already exist in config.");const s={$schema:b,sources:[...a.sources,...d]};if(t?.cacheDir&&(s.cacheDir=t.cacheDir),t?.defaults&&(s.defaults=t.defaults),i.mode==="package"){const r=g??{};r["docs-cache"]=F(s),await k(e,`${JSON.stringify(r,null,2)}
-`,"utf8")}else await I(e,s);const h=f?null:await N(l.dirname(e),t?.cacheDir??U);return{configPath:e,sources:d,skipped:m,created:!0,gitignoreUpdated:h?.updated??!1,gitignorePath:h?.gitignorePath??null}};export{T as addSources};
-//# sourceMappingURL=add.mjs.map

package/dist/chunks/clean-git-cache.mjs

@@ -1,2 +0,0 @@
-import{rm as n,readdir as o,stat as m}from"node:fs/promises";import u from"node:path";import{r as f,e as w}from"../shared/docs-cache.kK1DPQIQ.mjs";import"node:os";const c=async t=>{try{const e=await o(t,{withFileTypes:!0});let r=0;for(const a of e){const i=u.join(t,a.name);if(a.isDirectory())r+=await c(i);else{const s=await m(i);r+=s.size}}return r}catch{return 0}},h=async t=>{try{return(await o(t)).length}catch{return 0}},p=async()=>{const t=f();if(!await w(t))return{removed:!1,cacheDir:t};const e=await h(t),r=await c(t);return await n(t,{recursive:!0,force:!0}),{removed:!0,cacheDir:t,repoCount:e,bytesFreed:r}};export{p as cleanGitCache};
-//# sourceMappingURL=clean-git-cache.mjs.map

package/dist/chunks/clean.mjs

@@ -1,2 +0,0 @@
-import{rm as o,access as i}from"node:fs/promises";import{l as s,b as m}from"../shared/docs-cache.CaOcl4OS.mjs";import{c as n}from"../shared/docs-cache.CQiaFDb_.mjs";import"node:path";import"zod";import"node:process";import"cac";import"picocolors";const f=async r=>{try{return await i(r),!0}catch{return!1}},p=async r=>{const{config:t,resolvedPath:c}=await s(r.configPath),a=n(c,t.cacheDir??m,r.cacheDirOverride),e=await f(a);return e&&await o(a,{recursive:!0,force:!0}),{cacheDir:a,removed:e}};export{p as cleanCache};
-//# sourceMappingURL=clean.mjs.map

package/dist/chunks/init.mjs

@@ -1,3 +0,0 @@
-import{readFile as C,writeFile as N,access as S}from"node:fs/promises";import c from"node:path";import{confirm as V,isCancel as G,select as J,text as U}from"@clack/prompts";import{c as _,b as r,s as L,w as T}from"../shared/docs-cache.CaOcl4OS.mjs";import{g as H,e as k}from"../shared/docs-cache.BOr9BnyP.mjs";import"zod";import"../shared/docs-cache.CQiaFDb_.mjs";import"node:process";import"cac";import"picocolors";const h=async n=>{try{return await S(n),!0}catch{return!1}},M=async(n,s={})=>{const y=s.confirm??V,l=s.isCancel??G,x=s.select??J,F=s.text??U,f=n.cwd??process.cwd(),d=c.resolve(f,_),i=c.resolve(f,"package.json"),g=[];if(await h(d)&&g.push(d),await h(i)){const e=await C(i,"utf8");JSON.parse(e)["docs-cache"]&&g.push(i)}if(g.length>0)throw new Error(`Config already exists at ${g.join(", ")}. Init aborted.`);let b=!1;if(await h(i)){const e=await C(i,"utf8");if(!JSON.parse(e)["docs-cache"]){const o=await x({message:"Config location",options:[{value:"config",label:"docs.config.json"},{value:"package",label:"package.json"}],initialValue:"config"});if(l(o))throw new Error("Init cancelled.");b=o==="package"}}const $=b?i:d,v=n.cacheDirOverride??r,u=await F({message:"Cache directory",initialValue:v});if(l(u))throw new Error("Init cancelled.");const A=u||r,D=await y({message:"Generate TOC.md (table of contents with links to all documentation)",initialValue:!0});if(l(D))throw new Error("Init cancelled.");const I=await H(f,A);let P=!1;if(I.entry&&!I.hasEntry){const e=await y({message:"Add cache directory to .gitignore",initialValue:!0});if(l(e))throw new Error("Init cancelled.");P=e}const a={configPath:$,cacheDir:u,toc:D,gitignore:P},t=c.resolve(f,a.configPath);if(c.basename(t)==="package.json"){const e=await C(t,"utf8"),o=JSON.parse(e);if(o["docs-cache"])throw new Error(`docs-cache config already exists in ${t}.`);const p={$schema:"https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",sources:[]},E=a.cacheDir||r;E!==r&&(p.cacheDir=E),a.toc||(p.defaults={toc:!1}),o["docs-cache"]=L(p),await N(t,`${JSON.stringify(o,null,2)}
-`,"utf8");const O=a.gitignore?await k(c.dirname(t),E):null;return{configPath:t,created:!0,gitignoreUpdated:O?.updated??!1,gitignorePath:O?.gitignorePath??null}}if(await h(t))throw new Error(`Config already exists at ${t}.`);const w={$schema:"https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",sources:[]},m=a.cacheDir||r;m!==r&&(w.cacheDir=m),a.toc||(w.defaults={toc:!1}),await T(t,w);const j=a.gitignore?await k(c.dirname(t),m):null;return{configPath:t,created:!0,gitignoreUpdated:j?.updated??!1,gitignorePath:j?.gitignorePath??null}};export{M as initConfig};
-//# sourceMappingURL=init.mjs.map

package/dist/chunks/prune.mjs

@@ -1,2 +0,0 @@
-import{readdir as p,rm as f,access as h}from"node:fs/promises";import u from"node:path";import{l as d,b as D}from"../shared/docs-cache.CaOcl4OS.mjs";import{c as v}from"../shared/docs-cache.CQiaFDb_.mjs";import"zod";import"node:process";import"cac";import"picocolors";const w=async t=>{try{return await h(t),!0}catch{return!1}},l=async t=>{const{config:c,resolvedPath:s,sources:a}=await d(t.configPath),e=v(s,c.cacheDir??D,t.cacheDirOverride);if(!await w(e))return{cacheDir:e,removed:[],kept:a.map(r=>r.id)};const n=new Set(a.map(r=>r.id)),m=await p(e,{withFileTypes:!0}),o=[];for(const r of m){if(!r.isDirectory())continue;const i=r.name;n.has(i)||i.startsWith(".tmp-")||(await f(u.join(e,i),{recursive:!0,force:!0}),o.push(i))}return{cacheDir:e,removed:o,kept:a.map(r=>r.id)}};export{l as pruneCache};
-//# sourceMappingURL=prune.mjs.map

package/dist/chunks/remove.mjs

@@ -1,3 +0,0 @@
-import{readFile as w,writeFile as N,rm as $,access as k}from"node:fs/promises";import v from"node:path";import{v as D,D as E,s as F,w as I,r as P}from"../shared/docs-cache.CaOcl4OS.mjs";import{r as O}from"../shared/docs-cache.CQiaFDb_.mjs";import{r as U}from"../shared/docs-cache.BSvQNKuf.mjs";import"zod";import"node:process";import"cac";import"picocolors";const f=async a=>{try{return await k(a),!0}catch{return!1}},y="package.json",S=async a=>{const s=await w(a,"utf8"),o=JSON.parse(s),r=o["docs-cache"];return r?{parsed:o,config:D(r)}:{parsed:o,config:null}},b=async a=>{if(a){const r=P(a);return{resolvedPath:r,mode:v.basename(r)===y?"package":"config"}}const s=P();if(await f(s))return{resolvedPath:s,mode:"config"};const o=v.resolve(process.cwd(),y);return await f(o)&&(await S(o)).config?{resolvedPath:o,mode:"package"}:{resolvedPath:s,mode:"config"}},J=async a=>{if(a.ids.length===0)throw new Error("No sources specified to remove.");const s=await b(a.configPath),o=s.resolvedPath;let r=E,t=null,d=null;if(await f(o))if(s.mode==="package"){const e=await S(o);if(d=e.parsed,t=e.config,!t)throw new Error(`Missing docs-cache config in ${o}.`);r=t}else{const e=await w(o,"utf8");t=JSON.parse(e.toString()),r=D(t)}else throw new Error(`Config not found at ${o}.`);const u=new Map(r.sources.map(e=>[e.id,e])),g=new Map(r.sources.map(e=>[e.repo,e])),n=new Set,l=[];for(const e of a.ids){if(u.has(e)){n.add(e);continue}const i=U(e);if(i.repoUrl&&g.has(i.repoUrl)){const p=g.get(i.repoUrl);p&&n.add(p.id);continue}if(i.inferredId&&u.has(i.inferredId)){n.add(i.inferredId);continue}l.push(e)}const C=r.sources.filter(e=>!n.has(e.id)),h=r.sources.filter(e=>n.has(e.id)).map(e=>e.id),M=r.sources.filter(e=>n.has(e.id));if(h.length===0)throw new Error("No matching sources found to remove.");const c={$schema:t?.$schema??"https://raw.githubusercontent.com/fbosch/docs-cache/main/docs.config.schema.json",sources:C};if(t?.cacheDir&&(c.cacheDir=t.cacheDir),t?.defaults&&(c.defaults=t.defaults),t?.targetMode&&(c.targetMode=t.targetMode),s.mode==="package"){const e=d??{};e["docs-cache"]=F(c),await N(o,`${JSON.stringify(e,null,2)}
-`,"utf8")}else await I(o,c);const m=[];for(const e of M){if(!e.targetDir)continue;const i=O(o,e.targetDir);await $(i,{recursive:!0,force:!0}),m.push({id:e.id,targetDir:i})}return{configPath:o,removed:h,missing:l,targetsRemoved:m}};export{J as removeSources};
-//# sourceMappingURL=remove.mjs.map

package/dist/chunks/status.mjs

@@ -1,2 +0,0 @@
-import{access as y}from"node:fs/promises";import t from"picocolors";import{u as o,b as u,c as D,g as w}from"../shared/docs-cache.CQiaFDb_.mjs";import{l as C,b as L}from"../shared/docs-cache.CaOcl4OS.mjs";import{DEFAULT_LOCK_FILENAME as v,resolveLockPath as x,readLock as P}from"../lock.mjs";import"node:process";import"cac";import"node:path";import"zod";const h=async r=>{try{return await y(r),!0}catch{return!1}},A=async r=>{const{config:c,resolvedPath:a,sources:n}=await C(r.configPath),s=D(a,c.cacheDir??L,r.cacheDirOverride),l=await h(s),e=x(a),i=await h(e);let d=!1,f=null;if(i)try{f=await P(e),d=!0}catch{d=!1}const E=await Promise.all(n.map(async m=>{const p=w(s,m.id),g=await h(p.sourceDir),k=f?.sources?.[m.id]??null;return{id:m.id,docsPath:p.sourceDir,docsExists:g,lockEntry:k}}));return{configPath:a,cacheDir:s,cacheDirExists:l,lockPath:e,lockExists:i,lockValid:d,sources:E}},_=r=>{const c=o.path(r.cacheDir),a=r.cacheDirExists?t.green("present"):t.red("missing"),n=r.lockExists?r.lockValid?t.green("valid"):t.red("invalid"):t.yellow("missing");if(o.header("Cache",`${c} (${a})`),o.header("Lock",`${v} (${n})`),r.sources.length===0){o.line(),o.line(`${u.warn} No sources configured.`);return}o.line();for(const s of r.sources){const l=s.docsExists?u.success:u.error,e=s.lockEntry?t.green("locked"):t.yellow("new"),i=o.hash(s.lockEntry?.resolvedCommit);o.item(l,s.id.padEnd(20),`${e.padEnd(10)} ${i}`)}};export{A as getStatus,_ as printStatus};
-//# sourceMappingURL=status.mjs.map