@fern-api/replay 0.16.0 → 0.16.2

package/dist/index.d.cts

@@ -214,8 +214,19 @@ declare class LockfileNotFoundError extends Error {
 declare class LockfileManager {
     private outputDir;
     private lock;
+    private fernignorePatterns;
     readonly warnings: string[];
     constructor(outputDir: string);
+    /**
+     * Inform the lockfile of the customer's `.fernignore` patterns so that
+     * `save()` can suppress its "Patch X removed from lockfile" warning when
+     * every file in the stripped patch is already `.fernignore`-protected.
+     * The strip itself still happens (credentials never persist); only the
+     * customer-visible warning is suppressed in that case, because the
+     * protected files survive the generator wipe regardless of whether the
+     * lockfile tracks them, so there's nothing for the customer to action.
+     */
+    setFernignorePatterns(patterns: string[]): void;
     get lockfilePath(): string;
     get customizationsPath(): string;
     exists(): boolean;
@@ -255,8 +266,9 @@ declare class ReplayDetector {
     private git;
     private lockManager;
     private sdkOutputDir;
+    private fernignorePatterns;
     readonly warnings: string[];
-    constructor(git: GitClient, lockManager: LockfileManager, sdkOutputDir: string);
+    constructor(git: GitClient, lockManager: LockfileManager, sdkOutputDir: string, fernignorePatterns?: readonly string[]);
     /**
      * Derive the previous-generation SHA from git history instead of trusting
      * `lock.current_generation`.
@@ -726,6 +738,19 @@ declare class ReplayService {
      * `applyPreparedReplay` (e.g., `[fern-autoversion]`).
      */
     prepareReplay(options?: ReplayOptions): Promise<ReplayPreparation>;
+    /**
+     * ADR 0002 migration step. Strips `.fernignore`-matched entries from
+     * `patch.files`, `patch.theirs_snapshot` keys, and `diff --git` sections
+     * in `patch.patch_content` for every patch in the lockfile. Patches that
+     * end up with no surviving files are removed entirely.
+     *
+     * Idempotent: a second run is a no-op because the first run already
+     * matches the contract. Per-patch try/catch ensures one bad patch does
+     * not block the rest. Each affected patch emits a warning naming the
+     * stripped paths. `patch_content` is left untouched if no parseable
+     * `diff --git` headers are found (fail-safe for exotic legacy formats).
+     */
+    private cleanseLegacyFernignoreEntries;
     /**
      * Phase 2 of the two-phase replay flow. Applies patches, rebases them against
      * the generation, saves the lockfile, and commits `[fern-replay]` (or stages
@@ -874,7 +899,8 @@ declare class ReplayService {
      */
     /** @internal Used by Flow implementations in `src/flows/`. */
     cleanupStaleConflictMarkers(): Promise<void>;
-    private readFernignorePatterns;
+    /** @internal Used by Flow implementations in `src/flows/`. */
+    readFernignorePatterns(): string[];
     /** @internal Used by Flow implementations in `src/flows/`. */
     buildReport(flow: "first-generation" | "no-patches" | "normal-regeneration" | "skip-application", patches: StoredPatch[], results: ReplayResult[], options?: ReplayOptions, warnings?: string[], rebaseCounts?: {
         absorbed: number;

package/dist/index.d.ts

@@ -214,8 +214,19 @@ declare class LockfileNotFoundError extends Error {
 declare class LockfileManager {
     private outputDir;
     private lock;
+    private fernignorePatterns;
     readonly warnings: string[];
     constructor(outputDir: string);
+    /**
+     * Inform the lockfile of the customer's `.fernignore` patterns so that
+     * `save()` can suppress its "Patch X removed from lockfile" warning when
+     * every file in the stripped patch is already `.fernignore`-protected.
+     * The strip itself still happens (credentials never persist); only the
+     * customer-visible warning is suppressed in that case, because the
+     * protected files survive the generator wipe regardless of whether the
+     * lockfile tracks them, so there's nothing for the customer to action.
+     */
+    setFernignorePatterns(patterns: string[]): void;
     get lockfilePath(): string;
     get customizationsPath(): string;
     exists(): boolean;
@@ -255,8 +266,9 @@ declare class ReplayDetector {
     private git;
     private lockManager;
     private sdkOutputDir;
+    private fernignorePatterns;
     readonly warnings: string[];
-    constructor(git: GitClient, lockManager: LockfileManager, sdkOutputDir: string);
+    constructor(git: GitClient, lockManager: LockfileManager, sdkOutputDir: string, fernignorePatterns?: readonly string[]);
     /**
      * Derive the previous-generation SHA from git history instead of trusting
      * `lock.current_generation`.
@@ -726,6 +738,19 @@ declare class ReplayService {
      * `applyPreparedReplay` (e.g., `[fern-autoversion]`).
      */
     prepareReplay(options?: ReplayOptions): Promise<ReplayPreparation>;
+    /**
+     * ADR 0002 migration step. Strips `.fernignore`-matched entries from
+     * `patch.files`, `patch.theirs_snapshot` keys, and `diff --git` sections
+     * in `patch.patch_content` for every patch in the lockfile. Patches that
+     * end up with no surviving files are removed entirely.
+     *
+     * Idempotent: a second run is a no-op because the first run already
+     * matches the contract. Per-patch try/catch ensures one bad patch does
+     * not block the rest. Each affected patch emits a warning naming the
+     * stripped paths. `patch_content` is left untouched if no parseable
+     * `diff --git` headers are found (fail-safe for exotic legacy formats).
+     */
+    private cleanseLegacyFernignoreEntries;
     /**
      * Phase 2 of the two-phase replay flow. Applies patches, rebases them against
      * the generation, saves the lockfile, and commits `[fern-replay]` (or stages
@@ -874,7 +899,8 @@ declare class ReplayService {
      */
     /** @internal Used by Flow implementations in `src/flows/`. */
     cleanupStaleConflictMarkers(): Promise<void>;
-    private readFernignorePatterns;
+    /** @internal Used by Flow implementations in `src/flows/`. */
+    readFernignorePatterns(): string[];
     /** @internal Used by Flow implementations in `src/flows/`. */
     buildReport(flow: "first-generation" | "no-patches" | "normal-regeneration" | "skip-application", patches: StoredPatch[], results: ReplayResult[], options?: ReplayOptions, warnings?: string[], rebaseCounts?: {
         absorbed: number;