@tsdoctor/snapshot 0.4.1 → 0.5.1

package/SnapshotService.js

@@ -44,6 +44,26 @@ var SnapshotService = class SnapshotService extends Context.Service()("@tsdoctor
 	*/
 	static layer = (dbPath) => make(dbPath);
 	/**
+	* The live {@link SnapshotService} implementation over an in-memory
+	* (`:memory:`) SQLite database.
+	*
+	* @remarks
+	* The same SQL, migrations and upsert semantics as
+	* {@link SnapshotService.layer}, backed by `@effected/store`'s
+	* `Store.layerTest` instead of a file — so a test exercises the real queries
+	* without a temp directory. What it cannot cover is file-backed behaviour:
+	* WAL mode, `checkpointOnClose`, and persistence across a reopen. Unlike
+	* {@link SnapshotService.layerTest}, nothing is stubbed.
+	*
+	* This is a layer FACTORY: each call mints a fresh layer and so a fresh,
+	* empty database. Bind the result to a `const` and provide it once when the
+	* steps of one test must see each other's rows.
+	*
+	* @returns A layer providing {@link SnapshotService}
+	* @public
+	*/
+	static layerMemory = () => makeMemory();
+	/**
 	* An in-memory double: no SQLite file, no migrations, no WAL.
 	*
 	* @remarks
@@ -113,20 +133,21 @@ const migrations = [{
 		yield* sql`CREATE INDEX IF NOT EXISTS idx_file_path ON file_snapshots(file_path)`;
 	})
 }];
-const make = (dbPath) => {
-	const StoreLive = Store.layerSqlite({
-		filename: dbPath,
-		migrations,
-		checkpointOnClose: true
-	});
-	const ServiceImpl = Layer.effect(SnapshotService, Effect.gen(function* () {
-		const sql = (yield* Store).client;
-		return {
-			hashContent,
-			getSnapshot: (outputDir, filePath) => sql`SELECT * FROM file_snapshots WHERE output_dir = ${outputDir} AND file_path = ${filePath}`.pipe(Effect.map((rows) => rows.length > 0 ? Option.some(toFileSnapshot(rows[0])) : Option.none()), Effect.mapError(toSnapshotDbError)),
-			getAllForDirectory: (outputDir) => sql`SELECT * FROM file_snapshots WHERE output_dir = ${outputDir}`.pipe(Effect.map((rows) => rows.map(toFileSnapshot)), Effect.mapError(toSnapshotDbError)),
-			getFilePaths: (outputDir) => sql`SELECT file_path FROM file_snapshots WHERE output_dir = ${outputDir}`.pipe(Effect.map((rows) => rows.map((r) => r.file_path)), Effect.mapError(toSnapshotDbError)),
-			upsert: (snapshot) => sql`INSERT INTO file_snapshots
+const make = (dbPath) => Layer.provide(serviceImpl(), Store.layerSqlite({
+	filename: dbPath,
+	migrations,
+	checkpointOnClose: true
+}));
+const makeMemory = () => Layer.provide(serviceImpl(), Store.layerTest({ migrations }));
+/** The SQL implementation, over whichever `Store` the caller provides. */
+const serviceImpl = () => Layer.effect(SnapshotService, Effect.gen(function* () {
+	const sql = (yield* Store).client;
+	return {
+		hashContent,
+		getSnapshot: (outputDir, filePath) => sql`SELECT * FROM file_snapshots WHERE output_dir = ${outputDir} AND file_path = ${filePath}`.pipe(Effect.map((rows) => rows.length > 0 ? Option.some(toFileSnapshot(rows[0])) : Option.none()), Effect.mapError(toSnapshotDbError)),
+		getAllForDirectory: (outputDir) => sql`SELECT * FROM file_snapshots WHERE output_dir = ${outputDir}`.pipe(Effect.map((rows) => rows.map(toFileSnapshot)), Effect.mapError(toSnapshotDbError)),
+		getFilePaths: (outputDir) => sql`SELECT file_path FROM file_snapshots WHERE output_dir = ${outputDir}`.pipe(Effect.map((rows) => rows.map((r) => r.file_path)), Effect.mapError(toSnapshotDbError)),
+		upsert: (snapshot) => sql`INSERT INTO file_snapshots
 						(output_dir, file_path, published_time, modified_time,
 						 content_hash, frontmatter_hash, build_time)
 						VALUES (${snapshot.outputDir}, ${snapshot.filePath},
@@ -143,7 +164,7 @@ const make = (dbPath) => {
 						   OR modified_time != ${snapshot.modifiedTime}
 						   OR content_hash != ${snapshot.contentHash}
 						   OR frontmatter_hash != ${snapshot.frontmatterHash}`.pipe(Effect.as(true), Effect.mapError(toSnapshotDbError)),
-			batchUpsert: (snapshots) => (snapshots.length === 0 ? Effect.succeed(0) : sql.withTransaction(Effect.forEach(snapshots, (s) => sql`INSERT INTO file_snapshots
+		batchUpsert: (snapshots) => (snapshots.length === 0 ? Effect.succeed(0) : sql.withTransaction(Effect.forEach(snapshots, (s) => sql`INSERT INTO file_snapshots
 												(output_dir, file_path, published_time, modified_time,
 												 content_hash, frontmatter_hash, build_time)
 												VALUES (${s.outputDir}, ${s.filePath},
@@ -160,23 +181,21 @@ const make = (dbPath) => {
 												   OR modified_time != ${s.modifiedTime}
 												   OR content_hash != ${s.contentHash}
 												   OR frontmatter_hash != ${s.frontmatterHash}`, { concurrency: 1 })).pipe(Effect.map(() => snapshots.length))).pipe(Effect.mapError(toSnapshotDbError)),
-			deleteSnapshot: (outputDir, filePath) => sql`DELETE FROM file_snapshots WHERE output_dir = ${outputDir} AND file_path = ${filePath}`.pipe(Effect.asVoid, Effect.mapError(toSnapshotDbError)),
-			cleanupStale: (outputDir, currentFiles) => Effect.gen(function* () {
-				const rows = yield* sql`SELECT file_path FROM file_snapshots WHERE output_dir = ${outputDir}`;
-				const staleFiles = [];
-				for (const row of rows) {
-					const fp = row.file_path;
-					if (!currentFiles.has(fp)) {
-						yield* sql`DELETE FROM file_snapshots WHERE output_dir = ${outputDir} AND file_path = ${fp}`;
-						staleFiles.push(fp);
-					}
+		deleteSnapshot: (outputDir, filePath) => sql`DELETE FROM file_snapshots WHERE output_dir = ${outputDir} AND file_path = ${filePath}`.pipe(Effect.asVoid, Effect.mapError(toSnapshotDbError)),
+		cleanupStale: (outputDir, currentFiles) => Effect.gen(function* () {
+			const rows = yield* sql`SELECT file_path FROM file_snapshots WHERE output_dir = ${outputDir}`;
+			const staleFiles = [];
+			for (const row of rows) {
+				const fp = row.file_path;
+				if (!currentFiles.has(fp)) {
+					yield* sql`DELETE FROM file_snapshots WHERE output_dir = ${outputDir} AND file_path = ${fp}`;
+					staleFiles.push(fp);
 				}
-				return staleFiles;
-			}).pipe(Effect.mapError(toSnapshotDbError))
-		};
-	}));
-	return Layer.provide(ServiceImpl, StoreLive);
-};
+			}
+			return staleFiles;
+		}).pipe(Effect.mapError(toSnapshotDbError))
+	};
+}));
 
 //#endregion
 export { SnapshotDbError, SnapshotService };

package/index.d.ts

@@ -171,6 +171,26 @@ export declare class SnapshotService extends SnapshotService_base {
    * @public
    */
   static readonly layer: (dbPath: string) => Layer.Layer<SnapshotService, StoreError | StoreMigrationError>;
+  /**
+   * The live {@link SnapshotService} implementation over an in-memory
+   * (`:memory:`) SQLite database.
+   *
+   * @remarks
+   * The same SQL, migrations and upsert semantics as
+   * {@link SnapshotService.layer}, backed by `@effected/store`'s
+   * `Store.layerTest` instead of a file — so a test exercises the real queries
+   * without a temp directory. What it cannot cover is file-backed behaviour:
+   * WAL mode, `checkpointOnClose`, and persistence across a reopen. Unlike
+   * {@link SnapshotService.layerTest}, nothing is stubbed.
+   *
+   * This is a layer FACTORY: each call mints a fresh layer and so a fresh,
+   * empty database. Bind the result to a `const` and provide it once when the
+   * steps of one test must see each other's rows.
+   *
+   * @returns A layer providing {@link SnapshotService}
+   * @public
+   */
+  static readonly layerMemory: () => Layer.Layer<SnapshotService, StoreError | StoreMigrationError>;
   /**
    * An in-memory double: no SQLite file, no migrations, no WAL.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tsdoctor/snapshot",
-	"version": "0.4.1",
+	"version": "0.5.1",
 	"private": false,
 	"description": "Incremental-build snapshot tracking for static documentation pipelines: a schema-versioned SQLite store of per-file content hashes and timestamps, built on @effected/store, plus the pure SHA-256 content-hashing helpers that feed it.",
 	"keywords": [
@@ -37,11 +37,11 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@effected/jsonc": "^0.14.0"
+		"@effected/jsonc": "^0.15.0"
 	},
 	"peerDependencies": {
-		"@effected/store": "^0.11.0",
-		"effect": "4.0.0-rc.118"
+		"@effected/store": "^0.12.0",
+		"effect": "^4.0.0"
 	},
 	"engines": {
 		"node": ">=24.11.0"