@voltro/data-transfer 0.33.0 → 0.34.0

package/dist/index.d.ts

@@ -20,15 +20,25 @@ import { YieldableError } from 'effect/Cause';
 export declare const applyAction: (action: MaskAction, input: MaskInput) => unknown;
 
 /**
- * Refuse a direct/native import when a live instance is detected, unless the
- * operator passed `--allow-live`. `liveInstance` is a human label (url/name) of
- * the detected instance, or `null` when none was found (or detection was
- * inconclusive — the CLI treats "can't tell" as "not detected" so the common
- * import-into-a-stopped-target case isn't blocked).
+ * Refuse a direct/native import when a live instance is writing to the SAME
+ * database, unless the operator passed `--allow-live`.
+ *
+ * @param liveInstance human label (url/name) of a detected instance, or `null`
+ *   when none answered — detection is best-effort, and "can't tell" is treated
+ *   as "not detected" so importing into a stopped target is not blocked.
+ * @param sameTarget whether that instance is connected to the database being
+ *   written. `'unknown'` when either side could not be identified (an older
+ *   instance, an unparseable connection) — and it must behave like `'same'`,
+ *   because the alternative is a guard that steps aside whenever it is unsure.
+ * @param targetLabel what the CLI resolved as the target, for the message. A
+ *   refusal that names only one of the two things it is comparing is why
+ *   `--allow-live` became a reflex.
  */
 export declare const assessLiveImport: (opts: {
     readonly liveInstance: string | null;
     readonly allowLive: boolean;
+    readonly sameTarget?: "same" | "different" | "unknown";
+    readonly targetLabel?: string;
 }) => LiveGuardResult;
 
 export declare const ASSET_INDEX_FILE = "assets/index.ndjson";