@dependabit/manifest 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @dependabit/manifest
 
+## 0.1.15
+
+### Patch Changes
+
+- [#101](https://github.com/pradeepmouli/dependabit/pull/101) [`83b9818`](https://github.com/pradeepmouli/dependabit/commit/83b98187940da75a41fb41990ea03c8d962146b4) Thanks [@pradeepmouli](https://github.com/pradeepmouli)! - - chore: bump typedoc-plugin-to-skills to ^1.3.0
+
+## 0.1.14
+
+### Patch Changes
+
+- [#76](https://github.com/pradeepmouli/dependabit/pull/76) [`7952538`](https://github.com/pradeepmouli/dependabit/commit/7952538578b97472f9da49056db535abf8c6a26a) Thanks [@pradeepmouli](https://github.com/pradeepmouli)! - - test: trigger CI pipeline
+
 ## 0.1.13
 
 ### Patch Changes

package/dist/config.d.ts

@@ -1,19 +1,68 @@
 import { type DependabitConfig } from './schema.js';
 /**
- * Parse and validate a YAML configuration file
+ * Reads a YAML configuration file from disk, parses it, and validates it
+ * against `DependabitConfigSchema`.
+ *
+ * @param path - Path to the `.dependabit.yml` (or `.json`) file.
+ * @returns The validated `DependabitConfig` object.
+ *
+ * @throws {ValidationError} If the YAML does not match the config schema.
+ * @throws {Error} If the file cannot be read.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - YAML comments are parsed but not preserved in the returned object.
+ *   A subsequent `stringifyConfig` call will lose all comments.
+ * - Duplicate YAML keys are silently overwritten by the YAML parser (last
+ *   value wins) — no warning is emitted.
  */
 export declare function readConfig(path: string): Promise<DependabitConfig>;
 /**
- * Parse YAML string to config
+ * Parses a YAML string into a validated `DependabitConfig`.
+ *
+ * @param yaml - Raw YAML or JSON string.
+ * @returns Validated config object.
+ *
+ * @throws {ValidationError} If the parsed data does not satisfy the schema.
+ *
+ * @category Manifest
+ *
+ * @useWhen
+ * Parsing config from an in-memory string (e.g., fetched from GitHub API).
  */
 export declare function parseConfig(yaml: string): DependabitConfig;
 /**
- * Convert config to YAML string
+ * Serialises a validated `DependabitConfig` to a YAML string.
+ *
+ * @param config - The config to serialise.
+ * @returns YAML string representation.
+ *
+ * @throws {ValidationError} If `config` fails schema validation before
+ *   serialisation.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - YAML comments present in the original file are **not** preserved;
+ *   this function always produces comment-free YAML.
  */
 export declare function stringifyConfig(config: DependabitConfig): string;
 /**
- * Get effective monitoring rules for a dependency
- * Merges global config with dependency-specific overrides
+ * Resolves the effective monitoring rules for a specific dependency URL by
+ * merging global config defaults with any per-URL override defined in
+ * `config.dependencies`.
+ *
+ * @param config - Root `DependabitConfig` object.
+ * @param dependencyUrl - The exact URL of the dependency to look up.
+ * @returns Resolved `enabled`, `checkFrequency`, and `ignoreChanges` values.
+ *
+ * @remarks
+ * Override matching is performed by exact URL equality.  A trailing slash
+ * or query parameter difference between the stored URL and the override URL
+ * will cause the override to be silently ignored.
+ *
+ * @category Manifest
  */
 export declare function getEffectiveMonitoringRules(config: DependabitConfig, dependencyUrl: string): {
     enabled: boolean;
@@ -21,7 +70,18 @@ export declare function getEffectiveMonitoringRules(config: DependabitConfig, de
     ignoreChanges: boolean;
 };
 /**
- * Check if a URL should be ignored based on config
+ * Returns `true` if the given URL matches any exclusion rule defined in
+ * `config.ignore` (exact URL list or regex pattern list).
+ *
+ * @param config - Root `DependabitConfig` object.
+ * @param url - The URL to test.
+ * @returns `true` if the URL should be skipped; `false` otherwise.
+ *
+ * @remarks
+ * Invalid regex patterns in `config.ignore.patterns` are logged as warnings
+ * via `console.warn` and skipped rather than throwing.
+ *
+ * @category Manifest
  */
 export declare function shouldIgnoreUrl(config: DependabitConfig, url: string): boolean;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAIxE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAG1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAIhE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,MAAM,GACpB;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1D,aAAa,EAAE,OAAO,CAAC;CACxB,CAsBA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CA0B9E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAIxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAG1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAIhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,MAAM,GACpB;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1D,aAAa,EAAE,OAAO,CAAC;CACxB,CAsBA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CA0B9E"}

package/dist/config.js

@@ -3,7 +3,22 @@ import YAML from 'yaml';
 import {} from './schema.js';
 import { validateConfig } from './validator.js';
 /**
- * Parse and validate a YAML configuration file
+ * Reads a YAML configuration file from disk, parses it, and validates it
+ * against `DependabitConfigSchema`.
+ *
+ * @param path - Path to the `.dependabit.yml` (or `.json`) file.
+ * @returns The validated `DependabitConfig` object.
+ *
+ * @throws {ValidationError} If the YAML does not match the config schema.
+ * @throws {Error} If the file cannot be read.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - YAML comments are parsed but not preserved in the returned object.
+ *   A subsequent `stringifyConfig` call will lose all comments.
+ * - Duplicate YAML keys are silently overwritten by the YAML parser (last
+ *   value wins) — no warning is emitted.
  */
 export async function readConfig(path) {
     const content = await readFile(path, 'utf-8');
@@ -11,14 +26,36 @@ export async function readConfig(path) {
     return validateConfig(data);
 }
 /**
- * Parse YAML string to config
+ * Parses a YAML string into a validated `DependabitConfig`.
+ *
+ * @param yaml - Raw YAML or JSON string.
+ * @returns Validated config object.
+ *
+ * @throws {ValidationError} If the parsed data does not satisfy the schema.
+ *
+ * @category Manifest
+ *
+ * @useWhen
+ * Parsing config from an in-memory string (e.g., fetched from GitHub API).
  */
 export function parseConfig(yaml) {
     const data = YAML.parse(yaml);
     return validateConfig(data);
 }
 /**
- * Convert config to YAML string
+ * Serialises a validated `DependabitConfig` to a YAML string.
+ *
+ * @param config - The config to serialise.
+ * @returns YAML string representation.
+ *
+ * @throws {ValidationError} If `config` fails schema validation before
+ *   serialisation.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - YAML comments present in the original file are **not** preserved;
+ *   this function always produces comment-free YAML.
  */
 export function stringifyConfig(config) {
     // Validate before stringifying
@@ -26,8 +63,20 @@ export function stringifyConfig(config) {
     return YAML.stringify(config);
 }
 /**
- * Get effective monitoring rules for a dependency
- * Merges global config with dependency-specific overrides
+ * Resolves the effective monitoring rules for a specific dependency URL by
+ * merging global config defaults with any per-URL override defined in
+ * `config.dependencies`.
+ *
+ * @param config - Root `DependabitConfig` object.
+ * @param dependencyUrl - The exact URL of the dependency to look up.
+ * @returns Resolved `enabled`, `checkFrequency`, and `ignoreChanges` values.
+ *
+ * @remarks
+ * Override matching is performed by exact URL equality.  A trailing slash
+ * or query parameter difference between the stored URL and the override URL
+ * will cause the override to be silently ignored.
+ *
+ * @category Manifest
  */
 export function getEffectiveMonitoringRules(config, dependencyUrl) {
     // Start with global defaults
@@ -49,7 +98,18 @@ export function getEffectiveMonitoringRules(config, dependencyUrl) {
     };
 }
 /**
- * Check if a URL should be ignored based on config
+ * Returns `true` if the given URL matches any exclusion rule defined in
+ * `config.ignore` (exact URL list or regex pattern list).
+ *
+ * @param config - Root `DependabitConfig` object.
+ * @param url - The URL to test.
+ * @returns `true` if the URL should be skipped; `false` otherwise.
+ *
+ * @remarks
+ * Invalid regex patterns in `config.ignore.patterns` are logged as warnings
+ * via `console.warn` and skipped rather than throwing.
+ *
+ * @category Manifest
  */
 export function shouldIgnoreUrl(config, url) {
     if (!config.ignore) {

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts

@@ -1,10 +1,46 @@
 import { type DependencyManifest, type DependencyEntry } from './schema.js';
 /**
- * Read and parse a manifest file
+ * Reads a manifest JSON file from disk and validates it against
+ * `DependencyManifestSchema`.
+ *
+ * @param path - Absolute or process-relative path to the manifest file.
+ * @returns The validated manifest object.
+ *
+ * @throws {ValidationError} If the file content does not match the schema.
+ * @throws {Error} If the file cannot be read (e.g., not found, permissions).
+ *
+ * @category Manifest
+ *
+ * @useWhen Loading an existing manifest to pass to the monitor or detector.
+ *
+ * @never
+ * - The file is parsed as JSON, not YAML.  Passing a YAML manifest path
+ *   will throw a `SyntaxError`; use `readConfig` for YAML.
  */
 export declare function readManifest(path: string): Promise<DependencyManifest>;
 /**
- * Write a manifest to file
+ * Serialises a manifest to pretty-printed JSON and writes it to disk.
+ *
+ * @remarks
+ * The directory is created recursively if it does not exist.
+ * When `strict` is `false` (the default) the file is written even if
+ * validation fails; validation errors are returned in the result so callers
+ * can surface them as warnings.
+ *
+ * @param path - Destination file path.
+ * @param manifest - Manifest object to write.
+ * @param options - Optional write behaviour overrides.
+ * @returns An object that may contain `validationErrors` if the manifest
+ *   has schema violations and `strict` is `false`.
+ *
+ * @throws {ValidationError} Only when `options.strict` is `true` and the
+ *   manifest fails validation.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - Writing a manifest with `strict: false` can persist invalid data that
+ *   later fails to parse.  Prefer `strict: true` in production pipelines.
  */
 export declare function writeManifest(path: string, manifest: DependencyManifest, options?: {
     strict?: boolean;
@@ -12,27 +48,114 @@ export declare function writeManifest(path: string, manifest: DependencyManifest
     validationErrors?: string[];
 }>;
 /**
- * Update a dependency entry in the manifest
+ * Updates a single dependency entry in the on-disk manifest by ID.
+ *
+ * @param path - Path to the manifest file.
+ * @param dependencyId - UUID of the dependency to update.
+ * @param updates - Partial `DependencyEntry` fields to merge.
+ * @returns The updated manifest.
+ *
+ * @throws {Error} If no dependency with `dependencyId` is found.
+ * @throws {ValidationError} If the merged entry fails schema validation.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - This function performs a **read–modify–write** cycle.  Concurrent calls
+ *   with the same `path` and different `dependencyId` values will race and
+ *   one write will silently overwrite the other.  Use a file lock or
+ *   serialise calls if running multiple monitors in parallel.
  */
 export declare function updateDependency(path: string, dependencyId: string, updates: Partial<DependencyEntry>): Promise<DependencyManifest>;
 /**
- * Add a new dependency to the manifest
+ * Appends a new dependency entry to the on-disk manifest.
+ *
+ * @param path - Path to the manifest file.
+ * @param dependency - The new `DependencyEntry` to add.
+ * @returns The updated manifest.
+ *
+ * @throws {Error} If a dependency with the same `id` or `url` already exists.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - Duplicate URL detection is exact-match only.  Trailing slashes or
+ *   fragment identifiers will not be treated as duplicates.
+ * - Same race condition as {@link updateDependency} applies.
  */
 export declare function addDependency(path: string, dependency: DependencyEntry): Promise<DependencyManifest>;
 /**
- * Remove a dependency from the manifest
+ * Removes a dependency from the on-disk manifest by ID.
+ *
+ * @param path - Path to the manifest file.
+ * @param dependencyId - UUID of the dependency to remove.
+ * @returns The updated manifest.
+ *
+ * @throws {Error} If no dependency with `dependencyId` is found.
+ *
+ * @category Manifest
  */
 export declare function removeDependency(path: string, dependencyId: string): Promise<DependencyManifest>;
 /**
- * Merge two manifests, preserving manual entries
- * Manual entries are those with detectionMethod === 'manual'
+ * Merges an `updated` manifest generated by the detector over an `existing`
+ * one, optionally preserving manual entries and accumulated change history.
+ *
+ * @remarks
+ * The merge strategy is:
+ * - All entries from `updated` are taken as the new ground truth.
+ * - If `preserveManual` is `true` (default), manual entries in `existing`
+ *   that are absent from `updated` are appended as-is.
+ * - If `preserveHistory` is `true` (default), any `changeHistory` from
+ *   `existing` is prepended to the corresponding entry in `updated`.
+ *
+ * Statistics are recalculated from the merged dependency list.
+ *
+ * @param existing - The current on-disk manifest.
+ * @param updated - The freshly-detected manifest to merge.
+ * @param options - Merge strategy options.
+ * @returns A new manifest object (does not mutate either input).
+ *
+ * @category Manifest
+ *
+ * @useWhen
+ * Applying the output of {@link Detector} to an existing manifest without
+ * losing manually-curated entries or historical change records.
+ *
+ * @avoidWhen
+ * You want to completely replace the existing manifest — just write
+ * `updated` directly via {@link writeManifest}.
+ *
+ * @never
+ * - Matching between `existing` and `updated` uses `id` **or** `url`.
+ *   If the URL of a dependency changes (e.g. a redirect is resolved), the
+ *   entry will be treated as new and history will not be preserved.
+ * - `preserveManual: true` can re-add entries that were intentionally
+ *   removed from the repository.  Set it to `false` when performing a
+ *   deliberate full refresh.
  */
 export declare function mergeManifests(existing: DependencyManifest, updated: DependencyManifest, options?: {
     preserveManual?: boolean;
     preserveHistory?: boolean;
 }): DependencyManifest;
 /**
- * Create an empty manifest template
+ * Creates a minimal, valid manifest with an empty `dependencies` array.
+ *
+ * @remarks
+ * Use this as the starting point when generating a manifest from scratch
+ * (e.g. on first run in a new repository).
+ *
+ * @returns A new `DependencyManifest` with zeroed statistics.
+ *
+ * @category Manifest
+ *
+ * @example
+ * ```ts
+ * const manifest = createEmptyManifest({
+ *   owner: 'my-org', name: 'my-repo',
+ *   branch: 'main', commit: 'abc123',
+ * });
+ * await writeManifest('.dependabit/manifest.json', manifest);
+ * ```
  */
 export declare function createEmptyManifest(options: {
     owner: string;

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5E;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAI5E;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,OAAO,CAAC;IAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuB1C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAqB7B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAyB7B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,kBAAkB,CAqDpB;AAyCD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,kBAAkB,CAyBrB"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAI5E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,OAAO,CAAC;IAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuB1C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAqB7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAyB7B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAkB7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,kBAAkB,CAqDpB;AAyCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,kBAAkB,CAyBrB"}

package/dist/manifest.js

@@ -3,7 +3,22 @@ import { dirname } from 'node:path';
 import {} from './schema.js';
 import { validateManifest, validateDependencyEntry, safeValidateManifest } from './validator.js';
 /**
- * Read and parse a manifest file
+ * Reads a manifest JSON file from disk and validates it against
+ * `DependencyManifestSchema`.
+ *
+ * @param path - Absolute or process-relative path to the manifest file.
+ * @returns The validated manifest object.
+ *
+ * @throws {ValidationError} If the file content does not match the schema.
+ * @throws {Error} If the file cannot be read (e.g., not found, permissions).
+ *
+ * @category Manifest
+ *
+ * @useWhen Loading an existing manifest to pass to the monitor or detector.
+ *
+ * @never
+ * - The file is parsed as JSON, not YAML.  Passing a YAML manifest path
+ *   will throw a `SyntaxError`; use `readConfig` for YAML.
  */
 export async function readManifest(path) {
     const content = await readFile(path, 'utf-8');
@@ -11,7 +26,28 @@ export async function readManifest(path) {
     return validateManifest(data);
 }
 /**
- * Write a manifest to file
+ * Serialises a manifest to pretty-printed JSON and writes it to disk.
+ *
+ * @remarks
+ * The directory is created recursively if it does not exist.
+ * When `strict` is `false` (the default) the file is written even if
+ * validation fails; validation errors are returned in the result so callers
+ * can surface them as warnings.
+ *
+ * @param path - Destination file path.
+ * @param manifest - Manifest object to write.
+ * @param options - Optional write behaviour overrides.
+ * @returns An object that may contain `validationErrors` if the manifest
+ *   has schema violations and `strict` is `false`.
+ *
+ * @throws {ValidationError} Only when `options.strict` is `true` and the
+ *   manifest fails validation.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - Writing a manifest with `strict: false` can persist invalid data that
+ *   later fails to parse.  Prefer `strict: true` in production pipelines.
  */
 export async function writeManifest(path, manifest, options) {
     const strict = options?.strict ?? false;
@@ -34,7 +70,23 @@ export async function writeManifest(path, manifest, options) {
     return result;
 }
 /**
- * Update a dependency entry in the manifest
+ * Updates a single dependency entry in the on-disk manifest by ID.
+ *
+ * @param path - Path to the manifest file.
+ * @param dependencyId - UUID of the dependency to update.
+ * @param updates - Partial `DependencyEntry` fields to merge.
+ * @returns The updated manifest.
+ *
+ * @throws {Error} If no dependency with `dependencyId` is found.
+ * @throws {ValidationError} If the merged entry fails schema validation.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - This function performs a **read–modify–write** cycle.  Concurrent calls
+ *   with the same `path` and different `dependencyId` values will race and
+ *   one write will silently overwrite the other.  Use a file lock or
+ *   serialise calls if running multiple monitors in parallel.
  */
 export async function updateDependency(path, dependencyId, updates) {
     const manifest = await readManifest(path);
@@ -53,7 +105,20 @@ export async function updateDependency(path, dependencyId, updates) {
     return manifest;
 }
 /**
- * Add a new dependency to the manifest
+ * Appends a new dependency entry to the on-disk manifest.
+ *
+ * @param path - Path to the manifest file.
+ * @param dependency - The new `DependencyEntry` to add.
+ * @returns The updated manifest.
+ *
+ * @throws {Error} If a dependency with the same `id` or `url` already exists.
+ *
+ * @category Manifest
+ *
+ * @never
+ * - Duplicate URL detection is exact-match only.  Trailing slashes or
+ *   fragment identifiers will not be treated as duplicates.
+ * - Same race condition as {@link updateDependency} applies.
  */
 export async function addDependency(path, dependency) {
     const manifest = await readManifest(path);
@@ -75,7 +140,15 @@ export async function addDependency(path, dependency) {
     return manifest;
 }
 /**
- * Remove a dependency from the manifest
+ * Removes a dependency from the on-disk manifest by ID.
+ *
+ * @param path - Path to the manifest file.
+ * @param dependencyId - UUID of the dependency to remove.
+ * @returns The updated manifest.
+ *
+ * @throws {Error} If no dependency with `dependencyId` is found.
+ *
+ * @category Manifest
  */
 export async function removeDependency(path, dependencyId) {
     const manifest = await readManifest(path);
@@ -92,8 +165,41 @@ export async function removeDependency(path, dependencyId) {
     return manifest;
 }
 /**
- * Merge two manifests, preserving manual entries
- * Manual entries are those with detectionMethod === 'manual'
+ * Merges an `updated` manifest generated by the detector over an `existing`
+ * one, optionally preserving manual entries and accumulated change history.
+ *
+ * @remarks
+ * The merge strategy is:
+ * - All entries from `updated` are taken as the new ground truth.
+ * - If `preserveManual` is `true` (default), manual entries in `existing`
+ *   that are absent from `updated` are appended as-is.
+ * - If `preserveHistory` is `true` (default), any `changeHistory` from
+ *   `existing` is prepended to the corresponding entry in `updated`.
+ *
+ * Statistics are recalculated from the merged dependency list.
+ *
+ * @param existing - The current on-disk manifest.
+ * @param updated - The freshly-detected manifest to merge.
+ * @param options - Merge strategy options.
+ * @returns A new manifest object (does not mutate either input).
+ *
+ * @category Manifest
+ *
+ * @useWhen
+ * Applying the output of {@link Detector} to an existing manifest without
+ * losing manually-curated entries or historical change records.
+ *
+ * @avoidWhen
+ * You want to completely replace the existing manifest — just write
+ * `updated` directly via {@link writeManifest}.
+ *
+ * @never
+ * - Matching between `existing` and `updated` uses `id` **or** `url`.
+ *   If the URL of a dependency changes (e.g. a redirect is resolved), the
+ *   entry will be treated as new and history will not be preserved.
+ * - `preserveManual: true` can re-add entries that were intentionally
+ *   removed from the repository.  Set it to `false` when performing a
+ *   deliberate full refresh.
  */
 export function mergeManifests(existing, updated, options = {}) {
     const { preserveManual = true, preserveHistory = true } = options;
@@ -171,7 +277,24 @@ function calculateStatistics(dependencies) {
     };
 }
 /**
- * Create an empty manifest template
+ * Creates a minimal, valid manifest with an empty `dependencies` array.
+ *
+ * @remarks
+ * Use this as the starting point when generating a manifest from scratch
+ * (e.g. on first run in a new repository).
+ *
+ * @returns A new `DependencyManifest` with zeroed statistics.
+ *
+ * @category Manifest
+ *
+ * @example
+ * ```ts
+ * const manifest = createEmptyManifest({
+ *   owner: 'my-org', name: 'my-repo',
+ *   branch: 'main', commit: 'abc123',
+ * });
+ * await writeManifest('.dependabit/manifest.json', manifest);
+ * ```
  */
 export function createEmptyManifest(options) {
     return {

package/dist/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}