@jamesaphoenix/tx-test-utils 0.4.2

package/dist/database/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Test database utilities for in-memory SQLite testing.
+ *
+ * @module @tx/test-utils/database
+ */
+export { createTestDatabase, TestDatabaseService, TestDatabaseLive, createTestDatabaseLayer } from "./test-database.js";
+export type { TestDatabase } from "./test-database.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/database/index.js

@@ -0,0 +1,7 @@
+/**
+ * Test database utilities for in-memory SQLite testing.
+ *
+ * @module @tx/test-utils/database
+ */
+export { createTestDatabase, TestDatabaseService, TestDatabaseLive, createTestDatabaseLayer } from "./test-database.js";
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,oBAAoB,CAAA"}

package/dist/database/test-database.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Test database utilities for in-memory SQLite testing.
+ *
+ * Provides an in-memory SQLite database with all migrations applied,
+ * suitable for integration testing of tx services.
+ *
+ * @module @tx/test-utils/database
+ */
+import Database from "better-sqlite3";
+import { Context, Effect, Layer } from "effect";
+/**
+ * Interface for test database operations.
+ * Wraps better-sqlite3 with convenience methods for testing.
+ */
+export interface TestDatabase {
+    /** The underlying better-sqlite3 Database instance */
+    readonly db: Database.Database;
+    /** Close the database connection */
+    readonly close: () => Effect.Effect<void>;
+    /** Delete all data from tables (preserves schema and migrations table) */
+    readonly reset: () => Effect.Effect<void>;
+    /** Execute a SELECT query and return results */
+    readonly query: <T = unknown>(sql: string, params?: unknown[]) => T[];
+    /** Execute raw SQL (DDL or DML) */
+    readonly exec: (sql: string) => void;
+    /** Execute a parameterized INSERT/UPDATE/DELETE and return run result */
+    readonly run: (sql: string, params?: unknown[]) => Database.RunResult;
+    /** Execute a function within a transaction */
+    readonly transaction: <T>(fn: () => T) => T;
+}
+declare const TestDatabaseService_base: Context.TagClass<TestDatabaseService, "TestDatabaseService", TestDatabase>;
+/**
+ * Service tag for test database dependency injection.
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const testDb = yield* TestDatabaseService
+ *   testDb.exec("INSERT INTO tasks ...")
+ * })
+ *
+ * Effect.runSync(Effect.provide(program, TestDatabaseLive))
+ * ```
+ */
+export declare class TestDatabaseService extends TestDatabaseService_base {
+}
+/**
+ * Create an in-memory test database with all migrations applied.
+ *
+ * @returns Effect that resolves to a TestDatabase instance
+ *
+ * @example
+ * ```typescript
+ * const testDb = await Effect.runPromise(createTestDatabase())
+ * testDb.exec("INSERT INTO tasks (id, title, status, score) VALUES ('tx-abc123', 'Test', 'backlog', 500)")
+ * const tasks = testDb.query("SELECT * FROM tasks")
+ * await Effect.runPromise(testDb.close())
+ * ```
+ */
+export declare const createTestDatabase: () => Effect.Effect<TestDatabase, Error>;
+/**
+ * Layer that provides a scoped test database.
+ * The database is automatically closed when the scope ends.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect'
+ * import { TestDatabaseService, TestDatabaseLive } from '@tx/test-utils'
+ *
+ * const program = Effect.gen(function* () {
+ *   const testDb = yield* TestDatabaseService
+ *   testDb.exec("INSERT INTO tasks ...")
+ *   return testDb.query("SELECT * FROM tasks")
+ * })
+ *
+ * const result = await Effect.runPromise(
+ *   Effect.provide(program, TestDatabaseLive)
+ * )
+ * ```
+ */
+export declare const TestDatabaseLive: Layer.Layer<TestDatabaseService, Error, never>;
+/**
+ * Create a test database Layer that can be used with SqliteClient.
+ * This allows using the test database with existing services that depend on SqliteClient.
+ *
+ * @example
+ * ```typescript
+ * import { SqliteClient } from '@tx/core'
+ * import { createTestDatabaseLayer } from '@tx/test-utils'
+ *
+ * const testLayer = createTestDatabaseLayer()
+ *
+ * // Use with services that depend on SqliteClient
+ * const result = await Effect.runPromise(
+ *   Effect.provide(myServiceMethod(), testLayer)
+ * )
+ * ```
+ */
+export declare const createTestDatabaseLayer: () => Layer.Layer<TestDatabaseService, Error>;
+export {};
+//# sourceMappingURL=test-database.d.ts.map

package/dist/database/test-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-database.d.ts","sourceRoot":"","sources":["../../src/database/test-database.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAG/C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAA;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzC,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAA;IACrE,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,QAAQ,CAAC,SAAS,CAAA;IACrE,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;CAC5C;;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,SAAQ,wBAGtC;CAAG;AAEN;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,QAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAmEnE,CAAA;AAEJ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,gDAG5B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,QAAO,KAAK,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAI9E,CAAA"}

package/dist/database/test-database.js

@@ -0,0 +1,130 @@
+/**
+ * Test database utilities for in-memory SQLite testing.
+ *
+ * Provides an in-memory SQLite database with all migrations applied,
+ * suitable for integration testing of tx services.
+ *
+ * @module @tx/test-utils/database
+ */
+import Database from "better-sqlite3";
+import { Context, Effect, Layer } from "effect";
+import { applyMigrations } from "@jamesaphoenix/tx-core";
+/**
+ * Service tag for test database dependency injection.
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const testDb = yield* TestDatabaseService
+ *   testDb.exec("INSERT INTO tasks ...")
+ * })
+ *
+ * Effect.runSync(Effect.provide(program, TestDatabaseLive))
+ * ```
+ */
+export class TestDatabaseService extends Context.Tag("TestDatabaseService")() {
+}
+/**
+ * Create an in-memory test database with all migrations applied.
+ *
+ * @returns Effect that resolves to a TestDatabase instance
+ *
+ * @example
+ * ```typescript
+ * const testDb = await Effect.runPromise(createTestDatabase())
+ * testDb.exec("INSERT INTO tasks (id, title, status, score) VALUES ('tx-abc123', 'Test', 'backlog', 500)")
+ * const tasks = testDb.query("SELECT * FROM tasks")
+ * await Effect.runPromise(testDb.close())
+ * ```
+ */
+export const createTestDatabase = () => Effect.try({
+    try: () => {
+        const db = new Database(":memory:");
+        // Enable WAL mode for better concurrent access (matches production settings)
+        db.pragma("journal_mode = WAL");
+        db.pragma("foreign_keys = ON");
+        // Run all migrations
+        applyMigrations(db);
+        const testDb = {
+            db,
+            close: () => Effect.sync(() => {
+                db.close();
+            }),
+            reset: () => Effect.sync(() => {
+                // Get all user tables (exclude sqlite internals, migrations tracking, and FTS tables)
+                // FTS5 shadow tables (*_fts, *_fts_data, *_fts_idx, etc.) cannot be modified directly
+                const tables = db
+                    .prepare(`
+              SELECT name FROM sqlite_master
+              WHERE type='table'
+                AND name NOT LIKE 'sqlite_%'
+                AND name != 'schema_version'
+                AND name NOT LIKE '%_fts'
+                AND name NOT LIKE '%_fts_%'
+                AND name NOT LIKE '%_config'
+            `)
+                    .all();
+                // Disable foreign keys temporarily to allow deletion in any order
+                db.exec("PRAGMA foreign_keys = OFF");
+                for (const { name } of tables) {
+                    db.exec(`DELETE FROM "${name}"`);
+                }
+                db.exec("PRAGMA foreign_keys = ON");
+            }),
+            query: (sql, params = []) => {
+                return db.prepare(sql).all(...params);
+            },
+            exec: (sql) => {
+                db.exec(sql);
+            },
+            run: (sql, params = []) => {
+                return db.prepare(sql).run(...params);
+            },
+            transaction: (fn) => {
+                return db.transaction(fn)();
+            }
+        };
+        return testDb;
+    },
+    catch: (error) => new Error(`Failed to create test database: ${error instanceof Error ? error.message : String(error)}`)
+});
+/**
+ * Layer that provides a scoped test database.
+ * The database is automatically closed when the scope ends.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect'
+ * import { TestDatabaseService, TestDatabaseLive } from '@tx/test-utils'
+ *
+ * const program = Effect.gen(function* () {
+ *   const testDb = yield* TestDatabaseService
+ *   testDb.exec("INSERT INTO tasks ...")
+ *   return testDb.query("SELECT * FROM tasks")
+ * })
+ *
+ * const result = await Effect.runPromise(
+ *   Effect.provide(program, TestDatabaseLive)
+ * )
+ * ```
+ */
+export const TestDatabaseLive = Layer.scoped(TestDatabaseService, Effect.acquireRelease(createTestDatabase(), (db) => db.close()));
+/**
+ * Create a test database Layer that can be used with SqliteClient.
+ * This allows using the test database with existing services that depend on SqliteClient.
+ *
+ * @example
+ * ```typescript
+ * import { SqliteClient } from '@tx/core'
+ * import { createTestDatabaseLayer } from '@tx/test-utils'
+ *
+ * const testLayer = createTestDatabaseLayer()
+ *
+ * // Use with services that depend on SqliteClient
+ * const result = await Effect.runPromise(
+ *   Effect.provide(myServiceMethod(), testLayer)
+ * )
+ * ```
+ */
+export const createTestDatabaseLayer = () => Layer.scoped(TestDatabaseService, Effect.acquireRelease(createTestDatabase(), (db) => db.close()));
+//# sourceMappingURL=test-database.js.map

package/dist/database/test-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-database.js","sourceRoot":"","sources":["../../src/database/test-database.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAuBxD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAoB,SAAQ,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAGxE;CAAG;AAEN;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAuC,EAAE,CACzE,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE;QACR,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAA;QAEnC,6EAA6E;QAC7E,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAA;QAC/B,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAA;QAE9B,qBAAqB;QACrB,eAAe,CAAC,EAAE,CAAC,CAAA;QAEnB,MAAM,MAAM,GAAiB;YAC3B,EAAE;YAEF,KAAK,EAAE,GAAG,EAAE,CACV,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;gBACf,EAAE,CAAC,KAAK,EAAE,CAAA;YACZ,CAAC,CAAC;YAEJ,KAAK,EAAE,GAAG,EAAE,CACV,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;gBACf,sFAAsF;gBACtF,sFAAsF;gBACtF,MAAM,MAAM,GAAG,EAAE;qBACd,OAAO,CACN;;;;;;;;aAQH,CACE;qBACA,GAAG,EAA6B,CAAA;gBAEnC,kEAAkE;gBAClE,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;gBACpC,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;oBAC9B,EAAE,CAAC,IAAI,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAA;gBAClC,CAAC;gBACD,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;YACrC,CAAC,CAAC;YAEJ,KAAK,EAAE,CAAc,GAAW,EAAE,SAAoB,EAAE,EAAO,EAAE;gBAC/D,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAQ,CAAA;YAC9C,CAAC;YAED,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE;gBAC1B,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACd,CAAC;YAED,GAAG,EAAE,CAAC,GAAW,EAAE,SAAoB,EAAE,EAAsB,EAAE;gBAC/D,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAA;YACvC,CAAC;YAED,WAAW,EAAE,CAAI,EAAW,EAAK,EAAE;gBACjC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAA;YAC7B,CAAC;SACF,CAAA;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,KAAK,CAAC,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;CACzG,CAAC,CAAA;AAEJ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAC1C,mBAAmB,EACnB,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAChE,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAA4C,EAAE,CACnF,KAAK,CAAC,MAAM,CACV,mBAAmB,EACnB,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAChE,CAAA"}

package/dist/factories/anchor.factory.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Anchor factory for creating test anchor data.
+ *
+ * Anchors link learnings to specific file locations, symbols, or code regions.
+ *
+ * @module @tx/test-utils/factories/anchor
+ */
+import type { Anchor, AnchorType, AnchorStatus } from "@jamesaphoenix/tx-types";
+import type { TestDatabase } from "../database/index.js";
+/**
+ * Options for creating a test anchor.
+ */
+export interface CreateAnchorOptions {
+    /** Anchor ID (auto-generated if not provided) */
+    id?: number;
+    /** ID of the learning this anchor belongs to */
+    learningId: number;
+    /** Type of anchor (glob, hash, symbol, line_range) */
+    anchorType?: AnchorType;
+    /** The anchor value (pattern, hash, symbol name, etc.) */
+    anchorValue?: string;
+    /** File path the anchor points to */
+    filePath?: string;
+    /** Fully qualified symbol name (for symbol anchors) */
+    symbolFqname?: string | null;
+    /** Start line (for line_range anchors) */
+    lineStart?: number | null;
+    /** End line (for line_range anchors) */
+    lineEnd?: number | null;
+    /** Content hash (for hash anchors) */
+    contentHash?: string | null;
+    /** Content preview for self-healing comparison */
+    contentPreview?: string | null;
+    /** Anchor status (valid, drifted, invalid) */
+    status?: AnchorStatus;
+    /** Whether anchor is pinned (prevents auto-invalidation) */
+    pinned?: boolean;
+    /** Last verification timestamp */
+    verifiedAt?: Date | null;
+    /** Creation timestamp */
+    createdAt?: Date;
+}
+/**
+ * Factory class for creating test anchors.
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const factory = new AnchorFactory(db)
+ *
+ * // Create symbol anchor
+ * const anchor = factory.symbolAnchor(1, 'src/service.ts', 'handleRequest')
+ *
+ * // Create glob anchor
+ * const glob = factory.globAnchor(1, 'src/repo/*.ts')
+ *
+ * // Create line range anchor
+ * const lines = factory.lineRangeAnchor(1, 'src/service.ts', 10, 25)
+ * ```
+ */
+export declare class AnchorFactory {
+    private counter;
+    private readonly db;
+    constructor(db: TestDatabase);
+    /**
+     * Create a single test anchor.
+     */
+    create(options: CreateAnchorOptions): Anchor;
+    /**
+     * Create multiple test anchors.
+     */
+    createMany(count: number, baseOptions: CreateAnchorOptions): Anchor[];
+    /**
+     * Create a symbol anchor pointing to a function/class/method.
+     */
+    symbolAnchor(learningId: number, filePath: string, symbolName: string, options?: Partial<CreateAnchorOptions>): Anchor;
+    /**
+     * Create a glob pattern anchor.
+     */
+    globAnchor(learningId: number, pattern: string, options?: Partial<CreateAnchorOptions>): Anchor;
+    /**
+     * Create a line range anchor.
+     */
+    lineRangeAnchor(learningId: number, filePath: string, lineStart: number, lineEnd: number, options?: Partial<CreateAnchorOptions>): Anchor;
+    /**
+     * Create a content hash anchor.
+     */
+    hashAnchor(learningId: number, filePath: string, contentHash: string, options?: Partial<CreateAnchorOptions>): Anchor;
+    /**
+     * Create an anchor with drifted status (code changed).
+     */
+    driftedAnchor(learningId: number, filePath: string, options?: Partial<CreateAnchorOptions>): Anchor;
+    /**
+     * Create an anchor with invalid status (no longer exists).
+     */
+    invalidAnchor(learningId: number, filePath: string, options?: Partial<CreateAnchorOptions>): Anchor;
+    /**
+     * Reset the internal counter.
+     */
+    reset(): void;
+}
+/**
+ * Create a single test anchor (convenience function).
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const anchor = createTestAnchor(db, {
+ *   learningId: 1,
+ *   anchorType: 'symbol',
+ *   anchorValue: 'handleRequest',
+ *   filePath: 'src/service.ts'
+ * })
+ * ```
+ */
+export declare const createTestAnchor: (db: TestDatabase, options: CreateAnchorOptions) => Anchor;
+//# sourceMappingURL=anchor.factory.d.ts.map

package/dist/factories/anchor.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.factory.d.ts","sourceRoot":"","sources":["../../src/factories/anchor.factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,MAAM,EAEN,UAAU,EACV,YAAY,EACb,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kCAAkC;IAClC,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACxB,yBAAyB;IACzB,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;gBAErB,EAAE,EAAE,YAAY;IAI5B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM;IA0D5C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,MAAM,EAAE;IAarE;;OAEG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,MAAM;IAYT;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,MAAM;IAUT;;OAEG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,MAAM;IAYT;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,MAAM;IAWT;;OAEG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,MAAM;IAST;;OAEG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,MAAM;IAST;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAC3B,IAAI,YAAY,EAChB,SAAS,mBAAmB,KAC3B,MAGF,CAAA"}

package/dist/factories/anchor.factory.js

@@ -0,0 +1,201 @@
+/**
+ * Anchor factory for creating test anchor data.
+ *
+ * Anchors link learnings to specific file locations, symbols, or code regions.
+ *
+ * @module @tx/test-utils/factories/anchor
+ */
+/**
+ * Factory class for creating test anchors.
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const factory = new AnchorFactory(db)
+ *
+ * // Create symbol anchor
+ * const anchor = factory.symbolAnchor(1, 'src/service.ts', 'handleRequest')
+ *
+ * // Create glob anchor
+ * const glob = factory.globAnchor(1, 'src/repo/*.ts')
+ *
+ * // Create line range anchor
+ * const lines = factory.lineRangeAnchor(1, 'src/service.ts', 10, 25)
+ * ```
+ */
+export class AnchorFactory {
+    counter = 0;
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Create a single test anchor.
+     */
+    create(options) {
+        this.counter++;
+        const now = new Date();
+        const id = options.id ?? this.counter;
+        const learningId = options.learningId;
+        const anchorType = options.anchorType ?? "symbol";
+        const anchorValue = options.anchorValue ?? `anchor-${this.counter}`;
+        const filePath = options.filePath ?? "src/test.ts";
+        const symbolFqname = options.symbolFqname ?? null;
+        const lineStart = options.lineStart ?? null;
+        const lineEnd = options.lineEnd ?? null;
+        const contentHash = options.contentHash ?? null;
+        const contentPreview = options.contentPreview ?? null;
+        const status = options.status ?? "valid";
+        const pinned = options.pinned ?? false;
+        const verifiedAt = options.verifiedAt ?? null;
+        const createdAt = options.createdAt ?? now;
+        this.db.run(`INSERT INTO learning_anchors (id, learning_id, anchor_type, anchor_value, file_path, symbol_fqname, line_start, line_end, content_hash, content_preview, status, pinned, verified_at, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            id,
+            learningId,
+            anchorType,
+            anchorValue,
+            filePath,
+            symbolFqname,
+            lineStart,
+            lineEnd,
+            contentHash,
+            contentPreview,
+            status,
+            pinned ? 1 : 0,
+            verifiedAt ? verifiedAt.toISOString() : null,
+            createdAt.toISOString()
+        ]);
+        return {
+            id: id,
+            learningId,
+            anchorType,
+            anchorValue,
+            filePath,
+            symbolFqname,
+            lineStart,
+            lineEnd,
+            contentHash,
+            contentPreview,
+            status,
+            pinned,
+            verifiedAt,
+            createdAt
+        };
+    }
+    /**
+     * Create multiple test anchors.
+     */
+    createMany(count, baseOptions) {
+        const anchors = [];
+        for (let i = 0; i < count; i++) {
+            anchors.push(this.create({
+                ...baseOptions,
+                anchorValue: baseOptions.anchorValue
+                    ? `${baseOptions.anchorValue}-${i + 1}`
+                    : undefined
+            }));
+        }
+        return anchors;
+    }
+    /**
+     * Create a symbol anchor pointing to a function/class/method.
+     */
+    symbolAnchor(learningId, filePath, symbolName, options = {}) {
+        const fqname = `${filePath}::${symbolName}`;
+        return this.create({
+            ...options,
+            learningId,
+            anchorType: "symbol",
+            anchorValue: symbolName,
+            filePath,
+            symbolFqname: fqname
+        });
+    }
+    /**
+     * Create a glob pattern anchor.
+     */
+    globAnchor(learningId, pattern, options = {}) {
+        return this.create({
+            ...options,
+            learningId,
+            anchorType: "glob",
+            anchorValue: pattern,
+            filePath: pattern
+        });
+    }
+    /**
+     * Create a line range anchor.
+     */
+    lineRangeAnchor(learningId, filePath, lineStart, lineEnd, options = {}) {
+        return this.create({
+            ...options,
+            learningId,
+            anchorType: "line_range",
+            anchorValue: `${lineStart}-${lineEnd}`,
+            filePath,
+            lineStart,
+            lineEnd
+        });
+    }
+    /**
+     * Create a content hash anchor.
+     */
+    hashAnchor(learningId, filePath, contentHash, options = {}) {
+        return this.create({
+            ...options,
+            learningId,
+            anchorType: "hash",
+            anchorValue: contentHash,
+            filePath,
+            contentHash
+        });
+    }
+    /**
+     * Create an anchor with drifted status (code changed).
+     */
+    driftedAnchor(learningId, filePath, options = {}) {
+        return this.create({
+            ...options,
+            learningId,
+            filePath,
+            status: "drifted"
+        });
+    }
+    /**
+     * Create an anchor with invalid status (no longer exists).
+     */
+    invalidAnchor(learningId, filePath, options = {}) {
+        return this.create({
+            ...options,
+            learningId,
+            filePath,
+            status: "invalid"
+        });
+    }
+    /**
+     * Reset the internal counter.
+     */
+    reset() {
+        this.counter = 0;
+    }
+}
+/**
+ * Create a single test anchor (convenience function).
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const anchor = createTestAnchor(db, {
+ *   learningId: 1,
+ *   anchorType: 'symbol',
+ *   anchorValue: 'handleRequest',
+ *   filePath: 'src/service.ts'
+ * })
+ * ```
+ */
+export const createTestAnchor = (db, options) => {
+    const factory = new AnchorFactory(db);
+    return factory.create(options);
+};
+//# sourceMappingURL=anchor.factory.js.map

package/dist/factories/anchor.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.factory.js","sourceRoot":"","sources":["../../src/factories/anchor.factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4CH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,aAAa;IAChB,OAAO,GAAG,CAAC,CAAA;IACF,EAAE,CAAc;IAEjC,YAAY,EAAgB;QAC1B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAA4B;QACjC,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QAEtB,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,CAAA;QACrC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;QACrC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAA;QACjD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,UAAU,IAAI,CAAC,OAAO,EAAE,CAAA;QACnE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAA;QAClD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAA;QACjD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAA;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAA;QACvC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAA;QAC/C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAA;QACrD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAA;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAA;QACtC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAA;QAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAA;QAE1C,IAAI,CAAC,EAAE,CAAC,GAAG,CACT;yDACmD,EACnD;YACE,EAAE;YACF,UAAU;YACV,UAAU;YACV,WAAW;YACX,QAAQ;YACR,YAAY;YACZ,SAAS;YACT,OAAO;YACP,WAAW;YACX,cAAc;YACd,MAAM;YACN,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACd,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;YAC5C,SAAS,CAAC,WAAW,EAAE;SACxB,CACF,CAAA;QAED,OAAO;YACL,EAAE,EAAE,EAAc;YAClB,UAAU;YACV,UAAU;YACV,WAAW;YACX,QAAQ;YACR,YAAY;YACZ,SAAS;YACT,OAAO;YACP,WAAW;YACX,cAAc;YACd,MAAM;YACN,MAAM;YACN,UAAU;YACV,SAAS;SACV,CAAA;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAa,EAAE,WAAgC;QACxD,MAAM,OAAO,GAAa,EAAE,CAAA;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;gBACvB,GAAG,WAAW;gBACd,WAAW,EAAE,WAAW,CAAC,WAAW;oBAClC,CAAC,CAAC,GAAG,WAAW,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,EAAE;oBACvC,CAAC,CAAC,SAAS;aACd,CAAC,CAAC,CAAA;QACL,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,YAAY,CACV,UAAkB,EAClB,QAAgB,EAChB,UAAkB,EAClB,UAAwC,EAAE;QAE1C,MAAM,MAAM,GAAG,GAAG,QAAQ,KAAK,UAAU,EAAE,CAAA;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,UAAU;YACV,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,UAAU;YACvB,QAAQ;YACR,YAAY,EAAE,MAAM;SACrB,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CACR,UAAkB,EAClB,OAAe,EACf,UAAwC,EAAE;QAE1C,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,UAAU;YACV,UAAU,EAAE,MAAM;YAClB,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CACb,UAAkB,EAClB,QAAgB,EAChB,SAAiB,EACjB,OAAe,EACf,UAAwC,EAAE;QAE1C,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,UAAU;YACV,UAAU,EAAE,YAAY;YACxB,WAAW,EAAE,GAAG,SAAS,IAAI,OAAO,EAAE;YACtC,QAAQ;YACR,SAAS;YACT,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CACR,UAAkB,EAClB,QAAgB,EAChB,WAAmB,EACnB,UAAwC,EAAE;QAE1C,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,UAAU;YACV,UAAU,EAAE,MAAM;YAClB,WAAW,EAAE,WAAW;YACxB,QAAQ;YACR,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CACX,UAAkB,EAClB,QAAgB,EAChB,UAAwC,EAAE;QAE1C,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,UAAU;YACV,QAAQ;YACR,MAAM,EAAE,SAAS;SAClB,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CACX,UAAkB,EAClB,QAAgB,EAChB,UAAwC,EAAE;QAE1C,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,UAAU;YACV,QAAQ;YACR,MAAM,EAAE,SAAS;SAClB,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,CAAC,CAAA;IAClB,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,EAAgB,EAChB,OAA4B,EACpB,EAAE;IACV,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC,CAAA;IACrC,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC,CAAA"}