@salesforce/b2c-tooling-sdk 1.17.0 → 1.18.0

package/dist/esm/discovery/patterns/storefront-next.js

@@ -10,13 +10,29 @@
  */
 import path from 'node:path';
 import { readPackageJson, globDirs } from '../utils.js';
+import { packageIndicatesPwaKit } from './pwa-kit.js';
+/**
+ * The Storefront Next dev toolchain dependency — the definitive dependency
+ * signal that a project is Storefront Next.
+ *
+ * We deliberately do NOT match the broader `@salesforce/storefront-next*` prefix:
+ * `@salesforce/storefront-next-runtime` is now also pulled in by PWA Kit projects
+ * for unrelated reasons, and matching the prefix produced false positives there.
+ */
+const STOREFRONT_NEXT_DEV_DEP = '@salesforce/storefront-next-dev';
 /**
  * Returns true if this package.json (deps or name) indicates a Storefront Next project.
- * Relies on @salesforce/storefront-next* dependency or package name starting with "storefront-next" only.
+ *
+ * A PWA Kit signal disqualifies the package outright: PWA Kit apps may depend on
+ * `@salesforce/storefront-next-runtime`, and a package that is clearly PWA Kit is
+ * not Storefront Next.
  */
 function packageIndicatesStorefrontNext(pkg) {
+    // PWA Kit and Storefront Next are distinct; a PWA Kit package is never SFNext.
+    if (packageIndicatesPwaKit(pkg))
+        return false;
     const deps = Object.keys({ ...pkg.dependencies, ...pkg.devDependencies });
-    if (deps.some((dep) => dep.startsWith('@salesforce/storefront-next'))) {
+    if (deps.includes(STOREFRONT_NEXT_DEV_DEP)) {
         return true;
     }
     const name = pkg.name;

package/dist/esm/discovery/patterns/storefront-next.js.map

@@ -1 +1 @@
-{"version":3,"file":"storefront-next.js","sourceRoot":"","sources":["../../../../src/discovery/patterns/storefront-next.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAC,eAAe,EAAE,QAAQ,EAAC,MAAM,aAAa,CAAC;AAEtD;;;GAGG;AACH,SAAS,8BAA8B,CAAC,GAAgB;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAC,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAC,CAAC,CAAC;IACxE,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAC3D,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1F,IAAI,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,gBAAgB,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iBAAiB;IAC9B,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE3B,IAAI,8BAA8B,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAE9B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACvE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC7D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAC,GAAG,EAAE,aAAa,EAAC,CAAC,CAAC;YAC3D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;gBAC9C,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;gBAC3C,IAAI,GAAG,IAAI,8BAA8B,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}
+{"version":3,"file":"storefront-next.js","sourceRoot":"","sources":["../../../../src/discovery/patterns/storefront-next.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAC,eAAe,EAAE,QAAQ,EAAC,MAAM,aAAa,CAAC;AACtD,OAAO,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,uBAAuB,GAAG,iCAAiC,CAAC;AAElE;;;;;;GAMG;AACH,SAAS,8BAA8B,CAAC,GAAgB;IACtD,+EAA+E;IAC/E,IAAI,sBAAsB,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAC,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAC,CAAC,CAAC;IACxE,IAAI,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAC3D,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1F,IAAI,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,gBAAgB,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,iBAAiB;IAC9B,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE3B,IAAI,8BAA8B,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAE9B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACvE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC7D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAC,GAAG,EAAE,aAAa,EAAC,CAAC,CAAC;YAC3D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;gBAC9C,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;gBAC3C,IAAI,GAAG,IAAI,8BAA8B,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}

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

@@ -4,14 +4,23 @@
  * @module discovery/types
  */
 /**
- * Identifies the type of B2C Commerce project.
+ * A workspace marker: something detected about a B2C Commerce project. A single
+ * workspace can carry several — they are not mutually exclusive. In particular
+ * `sfra` is a refinement of `cartridges` (a SFRA project also has cartridges),
+ * so an SFRA workspace detects as both.
  *
- * Simplified to 3 workspace types:
- * - cartridges: Any project with cartridges (detected via .project files)
+ * - cartridges: any project with cartridges (detected via .project files)
+ * - sfra: a Storefront Reference Architecture project (has `app_storefront_base`)
  * - pwa-kit-v3: PWA Kit v3 storefront
  * - storefront-next: Storefront Next (Odyssey)
  */
-export type ProjectType = 'cartridges' | 'pwa-kit-v3' | 'storefront-next';
+export type ProjectType = 'cartridges' | 'sfra' | 'pwa-kit-v3' | 'storefront-next';
+/**
+ * All workspace markers as a runtime list (single source of truth for callers
+ * that need to validate user input, e.g. a CLI flag or MCP enum). Kept in sync
+ * with {@link ProjectType} by the `satisfies` check below.
+ */
+export declare const PROJECT_TYPES: readonly ["cartridges", "sfra", "pwa-kit-v3", "storefront-next"];
 /**
  * Detection pattern definition.
  */

package/dist/esm/discovery/types.js

@@ -8,5 +8,15 @@
  *
  * @module discovery/types
  */
-export {};
+/**
+ * All workspace markers as a runtime list (single source of truth for callers
+ * that need to validate user input, e.g. a CLI flag or MCP enum). Kept in sync
+ * with {@link ProjectType} by the `satisfies` check below.
+ */
+export const PROJECT_TYPES = [
+    'cartridges',
+    'sfra',
+    'pwa-kit-v3',
+    'storefront-next',
+];
 //# sourceMappingURL=types.js.map

package/dist/esm/discovery/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AAmBH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,iBAAiB;CACwB,CAAC"}

package/dist/esm/docs/index.d.ts

@@ -29,7 +29,7 @@
  * results.forEach(r => console.log(r.entry.id, r.score));
  *
  * // Read a specific doc by fuzzy query
- * const doc = readDocByQuery('dw.catalog.ProductMgr');
+ * const doc = await readDocByQuery('dw.catalog.ProductMgr');
  * if (doc) {
  *   console.log(doc.content);
  * }
@@ -37,8 +37,8 @@
  *
  * @module docs
  */
-export type { DocEntry, SearchIndex, SearchResult, SchemaEntry, SchemaIndex, SchemaSearchResult } from './types.js';
-export { searchDocs, readDoc, readDocByQuery, listDocs, loadSearchIndex } from './search.js';
+export type { DocCategory, DocEntry, SearchIndex, SearchResult, SchemaEntry, SchemaIndex, SchemaSearchResult, } from './types.js';
+export { searchDocs, readDoc, readDocByQuery, readEntryContent, listDocs, loadSearchIndex, resetDocsCache, categoriesForWorkspace, resolveEnabledCategories, DOC_CATEGORIES, type SearchDocsOptions, } from './search.js';
 export { listSchemas, readSchema, readSchemaByQuery, searchSchemas } from './schema.js';
 export { downloadDocs } from './download.js';
 export type { DownloadDocsOptions, DownloadDocsResult } from './download.js';

package/dist/esm/docs/index.js

@@ -4,7 +4,7 @@
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
 // Search operations
-export { searchDocs, readDoc, readDocByQuery, listDocs, loadSearchIndex } from './search.js';
+export { searchDocs, readDoc, readDocByQuery, readEntryContent, listDocs, loadSearchIndex, resetDocsCache, categoriesForWorkspace, resolveEnabledCategories, DOC_CATEGORIES, } from './search.js';
 // Schema operations
 export { listSchemas, readSchema, readSchemaByQuery, searchSchemas } from './schema.js';
 // Download operation

package/dist/esm/docs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/docs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6CH,oBAAoB;AACpB,OAAO,EAAC,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAC,MAAM,aAAa,CAAC;AAE3F,oBAAoB;AACpB,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC;AAEtF,qBAAqB;AACrB,OAAO,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/docs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqDH,oBAAoB;AACpB,OAAO,EACL,UAAU,EACV,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,GAEf,MAAM,aAAa,CAAC;AAErB,oBAAoB;AACpB,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC;AAEtF,qBAAqB;AACrB,OAAO,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC"}

package/dist/esm/docs/search.d.ts

@@ -1,70 +1,143 @@
-import { type DocEntry, type SearchIndex, type SearchResult } from './types.js';
+import type { ProjectType } from '../discovery/types.js';
+import { type DocCategory, type DocEntry, type SearchIndex, type SearchResult } from './types.js';
 /**
- * Loads the pre-built search index from the bundled data directories.
+ * The canonical list of documentation categories, in a stable display order.
+ * Exported so the CLI and MCP surfaces validate against a single source of truth
+ * instead of maintaining their own copies. Derived from {@link CATEGORY_TAXONOMY}.
+ */
+export declare const DOC_CATEGORIES: readonly DocCategory[];
+/**
+ * Parses and validates a user-supplied set of documentation categories into a
+ * "topics" allowlist that bounds the entire available corpus (see
+ * {@link SearchDocsOptions.enabledCategories}). Accepts a comma-separated string
+ * or an array; names are trimmed and lower-cased.
  *
- * Combines the Script API documentation corpus with the standard job-step
- * reference so both are searchable through the same functions.
+ * Unknown names are dropped (and reported via `onInvalid`, if provided). Returns
+ * `undefined` when the input is empty or contains no valid categories, which
+ * means "no restriction" — matching the tolerant behavior of the MCP `--toolsets`
+ * flag, so a typo yields a warning and the full corpus rather than a dead tool.
+ *
+ * @param input - Comma-separated category names, or an array of names
+ * @param onInvalid - Optional callback invoked with any unrecognized names
+ * @returns The validated, de-duplicated categories, or `undefined` for no restriction
+ */
+export declare function resolveEnabledCategories(input: string | readonly string[] | undefined, onInvalid?: (invalid: string[]) => void): DocCategory[] | undefined;
+/**
+ * Computes the set of doc categories relevant to the given workspace marker(s):
+ * the always-relevant categories plus the union of each marker's categories
+ * (merged, not summed).
+ */
+export declare function categoriesForWorkspace(workspace: ProjectType | ProjectType[]): DocCategory[];
+/**
+ * Loads the combined search index from every bundled corpus directory.
+ *
+ * Combines the Script API reference, standard job steps, Developer Center
+ * guides, and this project's own docs so all are searchable through the same
+ * functions. Corpora that have not been generated are skipped.
  *
  * @returns The combined search index with all documentation entries
- * @throws Error if the Script API index file cannot be read
  */
 export declare function loadSearchIndex(): SearchIndex;
 /**
- * Searches the documentation index with fuzzy matching.
+ * Options for {@link searchDocs}.
+ */
+export interface SearchDocsOptions {
+    /** Maximum number of results to return (default: 20). */
+    limit?: number;
+    /** Restrict results to one or more corpora/categories (hard filter). */
+    category?: DocCategory | DocCategory[];
+    /**
+     * The current workspace marker(s) (e.g. from workspace detection). When set,
+     * the categories relevant to those markers rank higher (always a boost — never
+     * hides anything). To hard-scope instead, use {@link SearchDocsOptions.category}
+     * or {@link SearchDocsOptions.enabledCategories}.
+     */
+    workspace?: ProjectType | ProjectType[];
+    /**
+     * A hard allowlist of categories that bounds the ENTIRE available corpus for
+     * this call — a configuration boundary, distinct from the per-query
+     * {@link SearchDocsOptions.category} filter and the soft workspace boost.
+     *
+     * When set, only entries in these categories are ever eligible; any `category`
+     * narrows *within* this set (their intersection wins). Intended to be resolved
+     * once from a launch-time flag/env var (see {@link resolveEnabledCategories}) so
+     * operators can pin the docs surface to exactly the topics they want exposed.
+     * `undefined` means no restriction.
+     */
+    enabledCategories?: readonly DocCategory[];
+}
+/**
+ * Searches the combined documentation index.
+ *
+ * Higher scores are better. Results carry the full {@link DocEntry} (including
+ * `category`, `summary`, `keywords`, and `url` when available) so callers can
+ * triage matches without a follow-up read.
+ *
+ * When `workspace` is provided, the categories relevant to those markers (e.g.
+ * `sfra` for an SFRA project, `script-api`/`job-step` for any cartridge project,
+ * `pwa-kit-managed-runtime`/`commerce-api` for PWA Kit, `sfnext`/`commerce-api`
+ * for Storefront Next — plus the always-relevant docs) are boosted. It only ever
+ * reorders results; use `category`/`enabledCategories` to hard-scope.
  *
  * @param query - The search query string
- * @param limit - Maximum number of results to return (default: 20)
- * @returns Array of search results sorted by relevance
+ * @param limitOrOptions - Result limit (number) or {@link SearchDocsOptions}
+ * @returns Array of search results sorted by relevance (best first)
  *
  * @example
  * ```typescript
- * const results = searchDocs('ProductMgr');
- * results.forEach(r => console.log(r.entry.id, r.score));
+ * // Favor the current workspace's docs (nothing hidden)
+ * searchDocs('deploy bundle', {workspace: 'pwa-kit-v3'});
+ * // Hard-scope to one category instead
+ * searchDocs('components', {category: 'sfnext'});
  * ```
  */
-export declare function searchDocs(query: string, limit?: number): SearchResult[];
+export declare function searchDocs(query: string, limitOrOptions?: number | SearchDocsOptions): SearchResult[];
 /**
- * Reads the content of a documentation file by its ID.
+ * Lists documentation entries, optionally filtered by category.
  *
- * @param id - The documentation ID (filename without .md extension)
- * @returns The raw markdown content of the document
- * @throws Error if the document is not found
+ * @param category - Optional corpus/category (or list) to restrict to
+ * @param enabledCategories - Optional launch-time allowlist that bounds the
+ *   entire corpus (see {@link SearchDocsOptions.enabledCategories}). When set,
+ *   only entries in these categories are eligible; `category` narrows within it.
+ * @returns Array of matching documentation entries
+ */
+export declare function listDocs(category?: DocCategory | DocCategory[], enabledCategories?: readonly DocCategory[]): DocEntry[];
+/**
+ * Reads the full content of a documentation entry by its exact id.
  *
- * @example
- * ```typescript
- * const content = readDoc('dw.catalog.ProductMgr');
- * console.log(content);
- * ```
+ * Bundled entries are read from disk. Entries whose content is published online
+ * (Developer Center guides) are fetched from their canonical URL; on network
+ * failure a readable fallback assembled from the indexed metadata is returned.
+ *
+ * @param id - The documentation id
+ * @returns The document content (markdown)
+ * @throws Error if the id is unknown
+ */
+export declare function readDoc(id: string): Promise<string>;
+/**
+ * Reads the content of a resolved {@link DocEntry}, choosing bundled-file vs.
+ * online fetch based on whether the entry ships its content on disk.
  */
-export declare function readDoc(id: string): string;
+export declare function readEntryContent(entry: DocEntry): Promise<string>;
 /**
  * Reads documentation by fuzzy-matching the query and returning the best match.
  *
  * @param query - The search query string
+ * @param options - Optional search constraints (e.g. category)
  * @returns The best matching entry and its content, or null if no match
  *
  * @example
  * ```typescript
- * const doc = readDocByQuery('ProductMgr');
- * if (doc) {
- *   console.log(`Found: ${doc.entry.title}`);
- *   console.log(doc.content);
- * }
+ * const doc = await readDocByQuery('ProductMgr');
+ * if (doc) console.log(doc.content);
  * ```
  */
-export declare function readDocByQuery(query: string): {
+export declare function readDocByQuery(query: string, options?: SearchDocsOptions): Promise<{
     entry: DocEntry;
     content: string;
-} | null;
+} | null>;
 /**
- * Lists all available documentation entries.
- *
- * @returns Array of all documentation entries in the index
- *
- * @example
- * ```typescript
- * const docs = listDocs();
- * console.log(`${docs.length} documentation files available`);
- * ```
+ * Resets the in-memory index/search caches. Intended for tests that swap the
+ * bundled data on disk between assertions.
  */
-export declare function listDocs(): DocEntry[];
+export declare function resetDocsCache(): void;