@chipmobilesdk/rn-local-db 0.2.0 → 0.2.1

package/src/artifacts/reconcile.ts

@@ -1,63 +1,63 @@
-/**
- * Reconciliation: the two ways the database and the disk can disagree.
- *
- * An **orphaned artifact** is a file with no reference — left by a rolled-back
- * transaction, or by a crash between the write and the insert. A **dangling
- * reference** is the reverse: a row pointing at a file the operating system
- * reclaimed, or the user deleted through a file manager.
- *
- * App-triggered only (FR-073d). A background sweep would run during a user's
- * session without their knowledge, delete files it believes are orphans, and
- * have no way to distinguish "orphan" from "written by a transaction that has
- * not committed yet". Handing the trigger to the app makes that an explicit
- * decision at a moment the app knows is quiet.
- */
-
-import type { ReconciliationReport } from '../contract/attachment';
-import { fileSystem, removeIfPresent } from '../platform/fs';
-import { byteOrder } from '../query/compare';
-import type { Executor } from '../sqlite/connection';
-import { artifactPath, artifactsDirectory } from './paths';
-import { listReferences, type ArtifactContext } from './store';
-
-export type ReconcileOptions = {
-	/** Off by default: deleting a user's file is never an implied yes. */
-	removeOrphans?: boolean;
-};
-
-async function filesOnDisk(context: ArtifactContext): Promise<string[]> {
-	try {
-		return await fileSystem().readdir(artifactsDirectory(context.layout, context.scopeKey));
-	} catch {
-		// No directory means no artifacts, which is a valid answer rather than
-		// a failure — a scope that never wrote one never created it.
-		return [];
-	}
-}
-
-export async function reconcileArtifacts(
-	context: ArtifactContext,
-	executor: Executor,
-	options: ReconcileOptions = {},
-): Promise<ReconciliationReport> {
-	const references = await listReferences(executor);
-	const referenced = new Set(references.map(reference => reference.id));
-	const present = new Set(await filesOnDisk(context));
-
-	const orphanedArtifacts = [...present].filter(id => !referenced.has(id)).sort(byteOrder);
-	const danglingReferences = references
-		.filter(reference => !present.has(reference.id))
-		.map(reference => reference.id)
-		.sort(byteOrder);
-
-	const removedArtifacts: string[] = [];
-	if (options.removeOrphans) {
-		for (const id of orphanedArtifacts) {
-			if (await removeIfPresent(artifactPath(context.layout, context.scopeKey, id))) {
-				removedArtifacts.push(id);
-			}
-		}
-	}
-
-	return { orphanedArtifacts, danglingReferences, removedArtifacts };
-}
+/**
+ * Reconciliation: the two ways the database and the disk can disagree.
+ *
+ * An **orphaned artifact** is a file with no reference — left by a rolled-back
+ * transaction, or by a crash between the write and the insert. A **dangling
+ * reference** is the reverse: a row pointing at a file the operating system
+ * reclaimed, or the user deleted through a file manager.
+ *
+ * App-triggered only (FR-073d). A background sweep would run during a user's
+ * session without their knowledge, delete files it believes are orphans, and
+ * have no way to distinguish "orphan" from "written by a transaction that has
+ * not committed yet". Handing the trigger to the app makes that an explicit
+ * decision at a moment the app knows is quiet.
+ */
+
+import type { ReconciliationReport } from '../contract/attachment';
+import { fileSystem, removeIfPresent } from '../platform/fs';
+import { byteOrder } from '../query/compare';
+import type { Executor } from '../sqlite/connection';
+import { artifactPath, artifactsDirectory } from './paths';
+import { listReferences, type ArtifactContext } from './store';
+
+export type ReconcileOptions = {
+	/** Off by default: deleting a user's file is never an implied yes. */
+	removeOrphans?: boolean;
+};
+
+async function filesOnDisk(context: ArtifactContext): Promise<string[]> {
+	try {
+		return await fileSystem().readdir(artifactsDirectory(context.layout, context.scopeKey));
+	} catch {
+		// No directory means no artifacts, which is a valid answer rather than
+		// a failure — a scope that never wrote one never created it.
+		return [];
+	}
+}
+
+export async function reconcileArtifacts(
+	context: ArtifactContext,
+	executor: Executor,
+	options: ReconcileOptions = {},
+): Promise<ReconciliationReport> {
+	const references = await listReferences(executor);
+	const referenced = new Set(references.map(reference => reference.id));
+	const present = new Set(await filesOnDisk(context));
+
+	const orphanedArtifacts = [...present].filter(id => !referenced.has(id)).sort(byteOrder);
+	const danglingReferences = references
+		.filter(reference => !present.has(reference.id))
+		.map(reference => reference.id)
+		.sort(byteOrder);
+
+	const removedArtifacts: string[] = [];
+	if (options.removeOrphans) {
+		for (const id of orphanedArtifacts) {
+			if (await removeIfPresent(artifactPath(context.layout, context.scopeKey, id))) {
+				removedArtifacts.push(id);
+			}
+		}
+	}
+
+	return { orphanedArtifacts, danglingReferences, removedArtifacts };
+}