trekoon 0.1.0

package/src/sync/branch-db.ts

@@ -0,0 +1,49 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { Database } from "bun:sqlite";
+
+export interface BranchDatabaseSnapshot {
+  readonly branch: string;
+  readonly path: string;
+  readonly db: Database;
+  close(): void;
+}
+
+export class MissingBranchDatabaseError extends Error {
+  constructor(branch: string) {
+    super(`Unable to read .trekoon/trekoon.db from branch '${branch}'.`);
+    this.name = "MissingBranchDatabaseError";
+  }
+}
+
+export function openBranchDatabaseSnapshot(branch: string, cwd: string): BranchDatabaseSnapshot {
+  const show = Bun.spawnSync({
+    cmd: ["git", "show", `${branch}:.trekoon/trekoon.db`],
+    cwd,
+    stdout: "pipe",
+    stderr: "pipe",
+  });
+
+  if (show.exitCode !== 0 || show.stdout.byteLength === 0) {
+    throw new MissingBranchDatabaseError(branch);
+  }
+
+  const tempDir: string = mkdtempSync(join(tmpdir(), "trekoon-sync-branch-"));
+  const tempDbPath: string = join(tempDir, "remote.db");
+
+  writeFileSync(tempDbPath, show.stdout);
+
+  const db: Database = new Database(tempDbPath);
+
+  return {
+    branch,
+    path: tempDbPath,
+    db,
+    close(): void {
+      db.close(false);
+      rmSync(tempDir, { recursive: true, force: true });
+    },
+  };
+}

package/src/sync/event-writes.ts

@@ -0,0 +1,49 @@
+import { randomUUID } from "node:crypto";
+
+import { type Database } from "bun:sqlite";
+
+import { persistGitContext, resolveGitContext } from "./git-context";
+
+interface EventRecordInput {
+  readonly entityKind: string;
+  readonly entityId: string;
+  readonly operation: string;
+  readonly fields: Record<string, unknown>;
+}
+
+export function appendEventWithGitContext(db: Database, cwd: string, input: EventRecordInput): string {
+  const git = resolveGitContext(cwd);
+  persistGitContext(db, git);
+
+  const now: number = Date.now();
+  const eventId: string = randomUUID();
+
+  db.query(
+    `
+    INSERT INTO events (
+      id,
+      entity_kind,
+      entity_id,
+      operation,
+      payload,
+      git_branch,
+      git_head,
+      created_at,
+      updated_at,
+      version
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 1);
+    `,
+  ).run(
+    eventId,
+    input.entityKind,
+    input.entityId,
+    input.operation,
+    JSON.stringify({ fields: input.fields }),
+    git.branchName,
+    git.headSha,
+    now,
+    now,
+  );
+
+  return eventId;
+}

package/src/sync/git-context.ts

@@ -0,0 +1,67 @@
+import { type Database } from "bun:sqlite";
+
+import { type GitContextSnapshot } from "./types";
+
+function runGit(args: readonly string[], cwd: string): string | null {
+  const command = Bun.spawnSync({
+    cmd: ["git", ...args],
+    cwd,
+    stdout: "pipe",
+    stderr: "pipe",
+  });
+
+  if (command.exitCode !== 0) {
+    return null;
+  }
+
+  const output: string = new TextDecoder().decode(command.stdout).trim();
+  return output.length > 0 ? output : null;
+}
+
+export function resolveGitContext(cwd: string): GitContextSnapshot {
+  const branchName: string | null = runGit(["branch", "--show-current"], cwd);
+  const headSha: string | null = runGit(["rev-parse", "HEAD"], cwd);
+
+  return {
+    worktreePath: cwd,
+    branchName,
+    headSha,
+  };
+}
+
+export function persistGitContext(db: Database, git: GitContextSnapshot): void {
+  const now: number = Date.now();
+
+  db.query(
+    `
+    INSERT INTO git_context (
+      id,
+      worktree_path,
+      branch_name,
+      head_sha,
+      created_at,
+      updated_at,
+      version
+    ) VALUES (
+      'current',
+      @worktreePath,
+      @branchName,
+      @headSha,
+      @now,
+      @now,
+      1
+    )
+    ON CONFLICT(id) DO UPDATE SET
+      worktree_path = excluded.worktree_path,
+      branch_name = excluded.branch_name,
+      head_sha = excluded.head_sha,
+      updated_at = excluded.updated_at,
+      version = git_context.version + 1;
+    `,
+  ).run({
+    "@worktreePath": git.worktreePath,
+    "@branchName": git.branchName,
+    "@headSha": git.headSha,
+    "@now": now,
+  });
+}