wiki-graph-core 0.3.1

package/dist/common/wiki-graph-uri.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/wiki-graph-uri.ts"],"sourcesContent":["import { isAbsolute, relative, resolve } from \"path\";\nimport { homedir } from \"os\";\n\nexport const WIKI_GRAPH_URI_PREFIX = \"wikg://\";\nexport const WIKI_GRAPH_JOB_URI_PREFIX = \"wikg://local/job\";\nexport const WIKI_GRAPH_ARCHIVE_EXTENSION = \".wikg\";\n\nexport interface LocatedWikiGraphUri {\n  readonly archivePath?: string;\n  readonly objectUri?: string;\n}\n\nexport function isWikiGraphUri(value: string | undefined): value is string {\n  return isWikiGraphUriPrefix(value);\n}\n\nexport function isWikiGraphJobUri(value: string | undefined): value is string {\n  return isWikiGraphLocalJobUri(value);\n}\n\nexport function parseLocatedWikiGraphUri(uri: string): LocatedWikiGraphUri {\n  const prefix = getWikiGraphUriPrefix(uri);\n\n  if (prefix === undefined) {\n    throw new Error(formatWikiGraphUriExpectedError(uri));\n  }\n\n  const body = uri.slice(prefix.length);\n  const split = body.split(\"#\", 2);\n  const path = split[0] ?? \"\";\n  const hash = split[1] ?? \"\";\n  const parts = path.split(\"/\");\n  const archiveIndex = parts.findIndex((part) =>\n    part.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION),\n  );\n\n  if (archiveIndex < 0) {\n    return { objectUri: uri };\n  }\n\n  const archivePath = parts.slice(0, archiveIndex + 1).join(\"/\");\n  const objectPath = parts.slice(archiveIndex + 1).join(\"/\");\n\n  if (archivePath === \"\") {\n    throw new Error(`Invalid Wiki Graph archive URI: ${uri}`);\n  }\n\n  return {\n    archivePath: resolveArchivePath(archivePath),\n    ...(objectPath === \"\"\n      ? {}\n      : {\n          objectUri: formatWikiGraphObjectUri(\n            objectPath,\n            hash === \"\" ? undefined : hash,\n          ),\n        }),\n  };\n}\n\nfunction resolveArchivePath(archivePath: string): string {\n  if (archivePath.startsWith(\"~/\")) {\n    return resolve(homedir(), archivePath.slice(2));\n  }\n\n  return resolve(archivePath);\n}\n\nexport function formatLocatedWikiGraphUri(\n  archivePath: string,\n  objectUri?: string,\n): string {\n  const uriArchivePath = archivePath.replace(/\\\\/gu, \"/\");\n\n  if (objectUri === undefined || objectUri === WIKI_GRAPH_URI_PREFIX) {\n    return `${WIKI_GRAPH_URI_PREFIX}${uriArchivePath}`;\n  }\n\n  return `${WIKI_GRAPH_URI_PREFIX}${uriArchivePath}/${stripWikiGraphUriPrefix(\n    objectUri,\n  )}`;\n}\n\nexport function formatWikiGraphCommandUri(\n  archivePath: string,\n  objectUri?: string,\n  cwd = process.cwd(),\n): string {\n  return formatLocatedWikiGraphUri(\n    formatCommandArchivePath(archivePath, cwd),\n    objectUri,\n  );\n}\n\nfunction formatCommandArchivePath(archivePath: string, cwd: string): string {\n  const resolvedCwd = resolve(cwd);\n  const resolvedArchivePath = isAbsolute(archivePath)\n    ? resolve(archivePath)\n    : resolve(resolvedCwd, archivePath);\n  const relativeArchivePath = relative(resolvedCwd, resolvedArchivePath);\n\n  if (\n    relativeArchivePath !== \"\" &&\n    !relativeArchivePath.startsWith(\"..\") &&\n    !isAbsolute(relativeArchivePath)\n  ) {\n    return relativeArchivePath;\n  }\n\n  return resolvedArchivePath;\n}\n\nexport function formatLocatedChapterUri(\n  archivePath: string,\n  chapterId: number,\n): string {\n  return formatLocatedWikiGraphUri(\n    archivePath,\n    formatWikiGraphObjectUri(`chapter/${chapterId}`),\n  );\n}\n\nexport function formatLocatedChapterResourceUri(\n  archivePath: string,\n  chapterId: number,\n  resource: \"source\" | \"summary\" | \"title\",\n): string {\n  return formatLocatedWikiGraphUri(\n    archivePath,\n    formatWikiGraphObjectUri(`chapter/${chapterId}/${resource}`),\n  );\n}\n\nexport function formatLocatedChapterSourceCollectionUri(\n  archivePath: string,\n  chapterId: number,\n): string {\n  return formatLocatedWikiGraphUri(\n    archivePath,\n    formatWikiGraphObjectUri(`chapter/${chapterId}/source`),\n  );\n}\n\nexport function formatWikiGraphObjectUri(path: string, hash?: string): string {\n  const normalizedPath = path.replace(/^\\/+/u, \"\").replace(/\\/+$/u, \"\");\n\n  return `${WIKI_GRAPH_URI_PREFIX}${normalizedPath}${\n    hash === undefined ? \"\" : `#${hash}`\n  }`;\n}\n\nexport function requireArchiveUri(uri: string): string {\n  const parsed = parseLocatedWikiGraphUri(uri);\n\n  if (parsed.archivePath === undefined || parsed.objectUri !== undefined) {\n    throw new Error(\n      `${formatWikiGraphUriExpectedError(uri)} Expected a .wikg archive locator.`,\n    );\n  }\n\n  return parsed.archivePath;\n}\n\nexport function requireLocatedObjectUri(uri: string): {\n  readonly archivePath: string;\n  readonly objectUri: string;\n} {\n  const parsed = parseLocatedWikiGraphUri(uri);\n\n  if (parsed.archivePath === undefined || parsed.objectUri === undefined) {\n    throw new Error(\n      `${formatWikiGraphUriExpectedError(uri)} Expected an object URI with a .wikg archive locator.`,\n    );\n  }\n\n  return {\n    archivePath: parsed.archivePath,\n    objectUri: parsed.objectUri,\n  };\n}\n\nexport function requireLocatedObjectOrArchiveUri(uri: string): {\n  readonly archivePath: string;\n  readonly objectUri?: string;\n} {\n  const parsed = parseLocatedWikiGraphUri(uri);\n\n  if (parsed.archivePath === undefined) {\n    throw new Error(formatWikiGraphUriExpectedError(uri));\n  }\n\n  return {\n    archivePath: parsed.archivePath,\n    ...(parsed.objectUri === undefined ? {} : { objectUri: parsed.objectUri }),\n  };\n}\n\nexport function formatWikiGraphUriExpectedError(value: string): string {\n  const example =\n    value.endsWith(WIKI_GRAPH_ARCHIVE_EXTENSION) && value.startsWith(\"/\")\n      ? `${WIKI_GRAPH_URI_PREFIX}${value}`\n      : \"wikg:///absolute/path/book.wikg\";\n\n  return [\n    `Expected a Wiki Graph URI with a .wikg archive locator: ${value}`,\n    `Example: ${example}`,\n    \"See: wg help uri\",\n  ].join(\"\\n\");\n}\n\nfunction stripWikiGraphUriPrefix(uri: string): string {\n  const prefix = getWikiGraphUriPrefix(uri);\n\n  if (prefix === undefined) {\n    throw new Error(`Expected a Wiki Graph object URI: ${uri}`);\n  }\n\n  return uri.slice(prefix.length).replace(/^\\/+/u, \"\");\n}\n\nfunction getWikiGraphUriPrefix(uri: string): string | undefined {\n  if (uri.startsWith(WIKI_GRAPH_URI_PREFIX)) {\n    return WIKI_GRAPH_URI_PREFIX;\n  }\n\n  return undefined;\n}\n\nfunction isWikiGraphUriPrefix(value: string | undefined): value is string {\n  return value?.startsWith(WIKI_GRAPH_URI_PREFIX) === true;\n}\n\nfunction isWikiGraphLocalJobUri(value: string | undefined): boolean {\n  return (\n    value === WIKI_GRAPH_JOB_URI_PREFIX ||\n    value?.startsWith(`${WIKI_GRAPH_JOB_URI_PREFIX}/`) === true\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/context/index.d.ts

@@ -0,0 +1 @@
+export { WIKI_GRAPH_CONTEXT_VERSION, WikiGraphTask, WikiGraphTaskContext, WikiGraphTaskContextOptions, WikiGraphTaskIdentity, WikiGraphTaskType, createWikiGraphTaskId } from './task-context.js';

package/dist/context/index.js

@@ -0,0 +1,13 @@
+import {
+  createWikiGraphTaskId,
+  WikiGraphTask,
+  WikiGraphTaskContext,
+  WIKI_GRAPH_CONTEXT_VERSION
+} from "./task-context.js";
+export {
+  WIKI_GRAPH_CONTEXT_VERSION,
+  WikiGraphTask,
+  WikiGraphTaskContext,
+  createWikiGraphTaskId
+};
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/context/index.ts"],"sourcesContent":["export {\n  createWikiGraphTaskId,\n  WikiGraphTask,\n  WikiGraphTaskContext,\n  WIKI_GRAPH_CONTEXT_VERSION,\n} from \"./task-context.js\";\nexport type {\n  WikiGraphTaskContextOptions,\n  WikiGraphTaskIdentity,\n  WikiGraphTaskType,\n} from \"./task-context.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/context/task-context.d.ts

@@ -0,0 +1,41 @@
+declare const WIKI_GRAPH_CONTEXT_VERSION = 1;
+declare const TASK_STATUS_VERSION = 1;
+type WikiGraphTaskType = "source-to-graph" | "source-graph-to-summary";
+interface WikiGraphTaskIdentity {
+    readonly normalizedSource: string;
+    readonly parameters: unknown;
+    readonly taskType: WikiGraphTaskType;
+    readonly version?: number;
+}
+interface WikiGraphTaskContextOptions {
+    readonly rootDirPath: string;
+}
+interface WikiGraphTaskRun<T> {
+    readonly task: WikiGraphTask;
+    run(operation: (task: WikiGraphTask) => Promise<T> | T): Promise<T>;
+}
+interface TaskStatus {
+    readonly completedAt?: string | undefined;
+    readonly startedAt: string;
+    readonly status: "running" | "succeeded";
+    readonly version: typeof TASK_STATUS_VERSION;
+}
+declare class WikiGraphTaskContext {
+    #private;
+    constructor(options: WikiGraphTaskContextOptions);
+    createTask(identity: WikiGraphTaskIdentity): WikiGraphTask;
+    runTask<T>(identity: WikiGraphTaskIdentity, operation: (task: WikiGraphTask) => Promise<T> | T): Promise<T>;
+}
+declare class WikiGraphTask {
+    #private;
+    constructor(id: string, path: string);
+    get artifactDirPath(): string;
+    get id(): string;
+    get path(): string;
+    readStatus(): Promise<TaskStatus | undefined>;
+    run<T>(operation: (task: WikiGraphTask) => Promise<T> | T): Promise<T>;
+    remove(): Promise<void>;
+}
+declare function createWikiGraphTaskId(identity: WikiGraphTaskIdentity): string;
+
+export { WIKI_GRAPH_CONTEXT_VERSION, WikiGraphTask, WikiGraphTaskContext, type WikiGraphTaskContextOptions, type WikiGraphTaskIdentity, type WikiGraphTaskRun, type WikiGraphTaskType, createWikiGraphTaskId };

package/dist/context/task-context.js

@@ -0,0 +1,111 @@
+import { mkdir, readFile, rm, writeFile } from "fs/promises";
+import { join, resolve } from "path";
+import { z } from "zod";
+import { createHash } from "../utils/hash.js";
+import { isNodeError } from "../utils/node-error.js";
+const WIKI_GRAPH_CONTEXT_VERSION = 1;
+const TASK_STATUS_VERSION = 1;
+const taskStatusSchema = z.object({
+  completedAt: z.string().optional(),
+  startedAt: z.string(),
+  status: z.enum(["running", "succeeded"]),
+  version: z.literal(TASK_STATUS_VERSION)
+});
+class WikiGraphTaskContext {
+  #rootDirPath;
+  constructor(options) {
+    this.#rootDirPath = resolve(options.rootDirPath);
+  }
+  createTask(identity) {
+    const taskId = createWikiGraphTaskId(identity);
+    return new WikiGraphTask(taskId, join(this.#rootDirPath, taskId));
+  }
+  async runTask(identity, operation) {
+    const task = this.createTask(identity);
+    return await task.run(operation);
+  }
+}
+class WikiGraphTask {
+  #id;
+  #path;
+  constructor(id, path) {
+    this.#id = id;
+    this.#path = resolve(path);
+  }
+  get artifactDirPath() {
+    return join(this.#path, "artifacts");
+  }
+  get id() {
+    return this.#id;
+  }
+  get path() {
+    return this.#path;
+  }
+  async readStatus() {
+    try {
+      const status = JSON.parse(
+        await readFile(this.#getStatusPath(), "utf8")
+      );
+      return taskStatusSchema.parse(status);
+    } catch (error) {
+      if (isNodeError(error) && error.code === "ENOENT") {
+        return void 0;
+      }
+      throw error;
+    }
+  }
+  async run(operation) {
+    await this.#begin();
+    const result = await operation(this);
+    await this.#complete();
+    await this.remove();
+    return result;
+  }
+  async remove() {
+    await rm(this.#path, { force: true, recursive: true });
+  }
+  async #begin() {
+    await mkdir(this.artifactDirPath, { recursive: true });
+    await this.#writeStatus({
+      startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      status: "running",
+      version: TASK_STATUS_VERSION
+    });
+  }
+  async #complete() {
+    const existingStatus = await this.readStatus();
+    await this.#writeStatus({
+      completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      startedAt: existingStatus?.startedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+      status: "succeeded",
+      version: TASK_STATUS_VERSION
+    });
+  }
+  async #writeStatus(status) {
+    await mkdir(this.#path, { recursive: true });
+    await writeFile(
+      this.#getStatusPath(),
+      `${JSON.stringify(status, null, 2)}
+`,
+      "utf8"
+    );
+  }
+  #getStatusPath() {
+    return join(this.#path, "status.json");
+  }
+}
+function createWikiGraphTaskId(identity) {
+  return createHash({
+    normalizedSource: identity.normalizedSource,
+    parameters: identity.parameters,
+    taskType: identity.taskType,
+    version: identity.version ?? WIKI_GRAPH_CONTEXT_VERSION
+  });
+}
+export {
+  WIKI_GRAPH_CONTEXT_VERSION,
+  WikiGraphTask,
+  WikiGraphTaskContext,
+  createWikiGraphTaskId
+};
+//# sourceMappingURL=task-context.js.map

package/dist/context/task-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/context/task-context.ts"],"sourcesContent":["import { mkdir, readFile, rm, writeFile } from \"fs/promises\";\nimport { join, resolve } from \"path\";\nimport { z } from \"zod\";\n\nimport { createHash } from \"../utils/hash.js\";\nimport { isNodeError } from \"../utils/node-error.js\";\n\nexport const WIKI_GRAPH_CONTEXT_VERSION = 1;\n\nconst TASK_STATUS_VERSION = 1;\n\nconst taskStatusSchema = z.object({\n  completedAt: z.string().optional(),\n  startedAt: z.string(),\n  status: z.enum([\"running\", \"succeeded\"]),\n  version: z.literal(TASK_STATUS_VERSION),\n});\n\nexport type WikiGraphTaskType = \"source-to-graph\" | \"source-graph-to-summary\";\n\nexport interface WikiGraphTaskIdentity {\n  readonly normalizedSource: string;\n  readonly parameters: unknown;\n  readonly taskType: WikiGraphTaskType;\n  readonly version?: number;\n}\n\nexport interface WikiGraphTaskContextOptions {\n  readonly rootDirPath: string;\n}\n\nexport interface WikiGraphTaskRun<T> {\n  readonly task: WikiGraphTask;\n  run(operation: (task: WikiGraphTask) => Promise<T> | T): Promise<T>;\n}\n\ninterface TaskStatus {\n  readonly completedAt?: string | undefined;\n  readonly startedAt: string;\n  readonly status: \"running\" | \"succeeded\";\n  readonly version: typeof TASK_STATUS_VERSION;\n}\n\nexport class WikiGraphTaskContext {\n  readonly #rootDirPath: string;\n\n  public constructor(options: WikiGraphTaskContextOptions) {\n    this.#rootDirPath = resolve(options.rootDirPath);\n  }\n\n  public createTask(identity: WikiGraphTaskIdentity): WikiGraphTask {\n    const taskId = createWikiGraphTaskId(identity);\n\n    return new WikiGraphTask(taskId, join(this.#rootDirPath, taskId));\n  }\n\n  public async runTask<T>(\n    identity: WikiGraphTaskIdentity,\n    operation: (task: WikiGraphTask) => Promise<T> | T,\n  ): Promise<T> {\n    const task = this.createTask(identity);\n\n    return await task.run(operation);\n  }\n}\n\nexport class WikiGraphTask {\n  readonly #id: string;\n  readonly #path: string;\n\n  public constructor(id: string, path: string) {\n    this.#id = id;\n    this.#path = resolve(path);\n  }\n\n  public get artifactDirPath(): string {\n    return join(this.#path, \"artifacts\");\n  }\n\n  public get id(): string {\n    return this.#id;\n  }\n\n  public get path(): string {\n    return this.#path;\n  }\n\n  public async readStatus(): Promise<TaskStatus | undefined> {\n    try {\n      const status = JSON.parse(\n        await readFile(this.#getStatusPath(), \"utf8\"),\n      ) as unknown;\n\n      return taskStatusSchema.parse(status);\n    } catch (error) {\n      if (isNodeError(error) && error.code === \"ENOENT\") {\n        return undefined;\n      }\n\n      throw error;\n    }\n  }\n\n  public async run<T>(\n    operation: (task: WikiGraphTask) => Promise<T> | T,\n  ): Promise<T> {\n    await this.#begin();\n\n    const result = await operation(this);\n\n    await this.#complete();\n    await this.remove();\n    return result;\n  }\n\n  public async remove(): Promise<void> {\n    await rm(this.#path, { force: true, recursive: true });\n  }\n\n  async #begin(): Promise<void> {\n    await mkdir(this.artifactDirPath, { recursive: true });\n    await this.#writeStatus({\n      startedAt: new Date().toISOString(),\n      status: \"running\",\n      version: TASK_STATUS_VERSION,\n    });\n  }\n\n  async #complete(): Promise<void> {\n    const existingStatus = await this.readStatus();\n\n    await this.#writeStatus({\n      completedAt: new Date().toISOString(),\n      startedAt: existingStatus?.startedAt ?? new Date().toISOString(),\n      status: \"succeeded\",\n      version: TASK_STATUS_VERSION,\n    });\n  }\n\n  async #writeStatus(status: TaskStatus): Promise<void> {\n    await mkdir(this.#path, { recursive: true });\n    await writeFile(\n      this.#getStatusPath(),\n      `${JSON.stringify(status, null, 2)}\\n`,\n      \"utf8\",\n    );\n  }\n\n  #getStatusPath(): string {\n    return join(this.#path, \"status.json\");\n  }\n}\n\nexport function createWikiGraphTaskId(identity: WikiGraphTaskIdentity): string {\n  return createHash({\n    normalizedSource: identity.normalizedSource,\n    parameters: identity.parameters,\n    taskType: identity.taskType,\n    version: identity.version ?? WIKI_GRAPH_CONTEXT_VERSION,\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/document/database.d.ts

@@ -0,0 +1,30 @@
+import * as Sqlite3Namespace from 'sqlite3';
+
+type SqliteDatabase = Sqlite3Namespace.Database;
+type SqlBindValue = Buffer | Uint8Array | number | string | null;
+type SqlBindParams = readonly SqlBindValue[];
+type SqlRowValue = SqlBindValue;
+type SqlRow = Record<string, SqlRowValue>;
+declare class Database {
+    #private;
+    constructor(database: SqliteDatabase, options?: {
+        readonly onWrite?: () => void;
+    });
+    static open(databasePath: string, schemaSql?: string, options?: {
+        readonly onWrite?: () => void;
+        readonly readonly?: boolean;
+    }): Promise<Database>;
+    static initialize(databasePath: string, schemaSql: string): Promise<void>;
+    queryAll<T>(sql: string, params: SqlBindParams | undefined, mapRow: (row: SqlRow) => T): Promise<T[]>;
+    queryOne<T>(sql: string, params: SqlBindParams | undefined, mapRow: (row: SqlRow) => T): Promise<T | undefined>;
+    run(sql: string, params?: SqlBindParams): Promise<void>;
+    transaction<T>(operation: () => Promise<T> | T): Promise<T>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    getLastInsertRowId(): Promise<number>;
+}
+declare function getNumber(row: SqlRow, key: string): number;
+declare function getString(row: SqlRow, key: string): string;
+declare function getOptionalString(row: SqlRow, key: string): string | undefined;
+
+export { Database, type SqlBindValue, type SqlRow, getNumber, getOptionalString, getString };

package/dist/document/database.js

@@ -0,0 +1,273 @@
+import { AsyncLocalStorage } from "async_hooks";
+import { stat } from "fs/promises";
+import { resolve } from "path";
+const SQLITE_BUSY_TIMEOUT_MS = 15 * 60 * 1e3;
+async function isMissingOrEmptyFile(path) {
+  const stats = await stat(path).catch((error) => {
+    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+      return void 0;
+    }
+    throw error;
+  });
+  return stats === void 0 || stats.size === 0;
+}
+class Database {
+  #database;
+  #onWrite;
+  #operationScope = new AsyncLocalStorage();
+  #activeTransactionScope;
+  #closed = false;
+  #operationChain = Promise.resolve();
+  #transactionDepth = 0;
+  constructor(database, options = {}) {
+    this.#database = database;
+    this.#onWrite = options.onWrite;
+  }
+  static async open(databasePath, schemaSql = "", options = {}) {
+    const resolvedDatabasePath = resolve(databasePath);
+    const shouldMarkSchemaWritten = options.readonly !== true && schemaSql.trim() !== "" && await isMissingOrEmptyFile(resolvedDatabasePath);
+    const database = await openSqliteDatabase(resolvedDatabasePath, options);
+    const openedDatabase = new Database(database, options);
+    await openedDatabase.#executeSql(
+      `PRAGMA busy_timeout = ${SQLITE_BUSY_TIMEOUT_MS}`
+    );
+    if (options.readonly !== true && schemaSql.trim() !== "") {
+      await openedDatabase.#executeSql(schemaSql);
+      if (shouldMarkSchemaWritten) {
+        openedDatabase.#markWritten();
+      }
+    }
+    return openedDatabase;
+  }
+  static async initialize(databasePath, schemaSql) {
+    const database = await Database.open(databasePath);
+    try {
+      if (schemaSql.trim() !== "") {
+        await database.#executeSql(schemaSql);
+      }
+    } finally {
+      await database.close();
+    }
+  }
+  async queryAll(sql, params, mapRow) {
+    return await this.#runSerialized(async () => {
+      this.#assertOpen();
+      const rows = await this.#queryAllRows(sql, params);
+      return rows.map(mapRow);
+    });
+  }
+  async queryOne(sql, params, mapRow) {
+    return await this.#runSerialized(async () => {
+      this.#assertOpen();
+      const row = await this.#queryOneRow(sql, params);
+      return row === void 0 ? void 0 : mapRow(row);
+    });
+  }
+  async run(sql, params) {
+    await this.#runSerialized(async () => {
+      this.#assertOpen();
+      await this.#runStatement(sql, params);
+      this.#markWritten();
+    });
+  }
+  async transaction(operation) {
+    return await this.#runSerialized(async () => {
+      this.#assertOpen();
+      const isRootTransaction = this.#transactionDepth === 0;
+      const transactionScope = this.#activeTransactionScope ?? /* @__PURE__ */ Symbol("database transaction scope");
+      if (isRootTransaction) {
+        await this.#executeSql("BEGIN IMMEDIATE");
+        this.#activeTransactionScope = transactionScope;
+      }
+      this.#transactionDepth += 1;
+      try {
+        const result = await this.#operationScope.run(
+          transactionScope,
+          operation
+        );
+        if (isRootTransaction) {
+          await this.#executeSql("COMMIT");
+        }
+        return result;
+      } catch (error) {
+        if (isRootTransaction) {
+          await this.#executeSql("ROLLBACK");
+        }
+        throw error;
+      } finally {
+        this.#transactionDepth -= 1;
+        if (isRootTransaction) {
+          this.#activeTransactionScope = void 0;
+        }
+      }
+    });
+  }
+  async flush() {
+    await this.#runSerialized(() => {
+      this.#assertOpen();
+    });
+  }
+  async close() {
+    await this.#runSerialized(async () => {
+      if (this.#closed) {
+        return;
+      }
+      await this.#closeDatabase();
+      this.#closed = true;
+    });
+  }
+  async getLastInsertRowId() {
+    const row = await this.queryOne(
+      "SELECT last_insert_rowid() AS row_id",
+      void 0,
+      (value) => getNumber(value, "row_id")
+    );
+    if (row === void 0) {
+      throw new Error("Could not read last_insert_rowid()");
+    }
+    return row;
+  }
+  #assertOpen() {
+    if (this.#closed) {
+      throw new Error("Database is already closed");
+    }
+  }
+  async #runSerialized(operation) {
+    const operationScope = this.#operationScope.getStore();
+    if (operationScope !== void 0 && operationScope === this.#activeTransactionScope) {
+      return await operation();
+    }
+    const queuedOperation = this.#operationChain.then(operation);
+    this.#operationChain = queuedOperation.then(
+      () => void 0,
+      () => void 0
+    );
+    return await queuedOperation;
+  }
+  #markWritten() {
+    this.#onWrite?.();
+  }
+  async #closeDatabase() {
+    await new Promise((resolveClose, rejectClose) => {
+      this.#database.close((error) => {
+        if (error !== null) {
+          rejectClose(error);
+          return;
+        }
+        resolveClose();
+      });
+    });
+  }
+  async #executeSql(sql) {
+    await new Promise((resolveExec, rejectExec) => {
+      this.#database.exec(sql, (error) => {
+        if (error !== null) {
+          rejectExec(error);
+          return;
+        }
+        resolveExec();
+      });
+    });
+  }
+  async #queryAllRows(sql, params) {
+    return await new Promise((resolveAll, rejectAll) => {
+      this.#database.all(
+        sql,
+        normalizeSqlBindParams(params),
+        (error, rows) => {
+          if (error !== null) {
+            rejectAll(error);
+            return;
+          }
+          resolveAll(rows);
+        }
+      );
+    });
+  }
+  async #queryOneRow(sql, params) {
+    return await new Promise((resolveGet, rejectGet) => {
+      this.#database.get(
+        sql,
+        normalizeSqlBindParams(params),
+        (error, row) => {
+          if (error !== null) {
+            rejectGet(error);
+            return;
+          }
+          resolveGet(row);
+        }
+      );
+    });
+  }
+  async #runStatement(sql, params) {
+    await new Promise((resolveRun, rejectRun) => {
+      this.#database.run(sql, normalizeSqlBindParams(params), (error) => {
+        if (error !== null) {
+          rejectRun(error);
+          return;
+        }
+        resolveRun();
+      });
+    });
+  }
+}
+function getNumber(row, key) {
+  const value = row[key];
+  if (typeof value !== "number") {
+    throw new TypeError(`Expected ${key} to be a number`);
+  }
+  return value;
+}
+function getString(row, key) {
+  const value = row[key];
+  if (typeof value !== "string") {
+    throw new TypeError(`Expected ${key} to be a string`);
+  }
+  return value;
+}
+function getOptionalString(row, key) {
+  const value = row[key];
+  if (value === null || value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    throw new TypeError(`Expected ${key} to be a string`);
+  }
+  return value;
+}
+async function openSqliteDatabase(databasePath, options = {}) {
+  const sqlite3 = await loadSqlite3();
+  const flags = (options.readonly === true ? sqlite3.OPEN_READONLY : sqlite3.OPEN_READWRITE | sqlite3.OPEN_CREATE) | sqlite3.OPEN_FULLMUTEX;
+  return await new Promise((resolveOpen, rejectOpen) => {
+    const database = new sqlite3.Database(databasePath, flags, (error) => {
+      if (error !== null) {
+        rejectOpen(error);
+        return;
+      }
+      resolveOpen(database);
+    });
+  });
+}
+async function loadSqlite3() {
+  const module = await import("sqlite3");
+  return resolveSqlite3Module(module);
+}
+function resolveSqlite3Module(module) {
+  if (typeof module === "object" && module !== null && "default" in module && typeof module.default === "object" && module.default !== null && "Database" in module.default) {
+    return module.default;
+  }
+  if (typeof module === "object" && module !== null && "Database" in module) {
+    return module;
+  }
+  throw new TypeError("Could not load sqlite3");
+}
+function normalizeSqlBindParams(params) {
+  return params ?? [];
+}
+export {
+  Database,
+  getNumber,
+  getOptionalString,
+  getString
+};
+//# sourceMappingURL=database.js.map

package/dist/document/database.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/document/database.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"async_hooks\";\nimport { stat } from \"fs/promises\";\nimport { resolve } from \"path\";\n\nimport type * as Sqlite3Namespace from \"sqlite3\";\n\ntype Sqlite3Module = typeof Sqlite3Namespace;\ntype SqliteDatabase = Sqlite3Namespace.Database;\nexport type SqlBindValue = Buffer | Uint8Array | number | string | null;\ntype SqlBindParams = readonly SqlBindValue[];\ntype SqlRowValue = SqlBindValue;\n\nexport type SqlRow = Record<string, SqlRowValue>;\n\nconst SQLITE_BUSY_TIMEOUT_MS = 15 * 60 * 1000;\n\ntype DatabaseOperationScope = symbol;\n\nasync function isMissingOrEmptyFile(path: string): Promise<boolean> {\n  const stats = await stat(path).catch((error: unknown) => {\n    if (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"code\" in error &&\n      error.code === \"ENOENT\"\n    ) {\n      return undefined;\n    }\n\n    throw error;\n  });\n\n  return stats === undefined || stats.size === 0;\n}\n\nexport class Database {\n  readonly #database: SqliteDatabase;\n  readonly #onWrite: (() => void) | undefined;\n  readonly #operationScope = new AsyncLocalStorage<DatabaseOperationScope>();\n  #activeTransactionScope: DatabaseOperationScope | undefined;\n  #closed = false;\n  #operationChain: Promise<void> = Promise.resolve();\n  #transactionDepth = 0;\n\n  public constructor(\n    database: SqliteDatabase,\n    options: { readonly onWrite?: () => void } = {},\n  ) {\n    this.#database = database;\n    this.#onWrite = options.onWrite;\n  }\n\n  public static async open(\n    databasePath: string,\n    schemaSql = \"\",\n    options: {\n      readonly onWrite?: () => void;\n      readonly readonly?: boolean;\n    } = {},\n  ): Promise<Database> {\n    const resolvedDatabasePath = resolve(databasePath);\n    const shouldMarkSchemaWritten =\n      options.readonly !== true &&\n      schemaSql.trim() !== \"\" &&\n      (await isMissingOrEmptyFile(resolvedDatabasePath));\n    const database = await openSqliteDatabase(resolvedDatabasePath, options);\n    const openedDatabase = new Database(database, options);\n\n    await openedDatabase.#executeSql(\n      `PRAGMA busy_timeout = ${SQLITE_BUSY_TIMEOUT_MS}`,\n    );\n    if (options.readonly !== true && schemaSql.trim() !== \"\") {\n      await openedDatabase.#executeSql(schemaSql);\n      if (shouldMarkSchemaWritten) {\n        openedDatabase.#markWritten();\n      }\n    }\n\n    return openedDatabase;\n  }\n\n  public static async initialize(\n    databasePath: string,\n    schemaSql: string,\n  ): Promise<void> {\n    const database = await Database.open(databasePath);\n\n    try {\n      if (schemaSql.trim() !== \"\") {\n        await database.#executeSql(schemaSql);\n      }\n    } finally {\n      await database.close();\n    }\n  }\n\n  public async queryAll<T>(\n    sql: string,\n    params: SqlBindParams | undefined,\n    mapRow: (row: SqlRow) => T,\n  ): Promise<T[]> {\n    return await this.#runSerialized(async () => {\n      this.#assertOpen();\n      const rows = await this.#queryAllRows(sql, params);\n\n      return rows.map(mapRow);\n    });\n  }\n\n  public async queryOne<T>(\n    sql: string,\n    params: SqlBindParams | undefined,\n    mapRow: (row: SqlRow) => T,\n  ): Promise<T | undefined> {\n    return await this.#runSerialized(async () => {\n      this.#assertOpen();\n      const row = await this.#queryOneRow(sql, params);\n\n      return row === undefined ? undefined : mapRow(row);\n    });\n  }\n\n  public async run(sql: string, params?: SqlBindParams): Promise<void> {\n    await this.#runSerialized(async () => {\n      this.#assertOpen();\n      await this.#runStatement(sql, params);\n      this.#markWritten();\n    });\n  }\n\n  public async transaction<T>(operation: () => Promise<T> | T): Promise<T> {\n    return await this.#runSerialized(async () => {\n      this.#assertOpen();\n      const isRootTransaction = this.#transactionDepth === 0;\n      const transactionScope =\n        this.#activeTransactionScope ?? Symbol(\"database transaction scope\");\n\n      if (isRootTransaction) {\n        await this.#executeSql(\"BEGIN IMMEDIATE\");\n        this.#activeTransactionScope = transactionScope;\n      }\n\n      this.#transactionDepth += 1;\n\n      try {\n        const result = await this.#operationScope.run(\n          transactionScope,\n          operation,\n        );\n\n        if (isRootTransaction) {\n          await this.#executeSql(\"COMMIT\");\n        }\n\n        return result;\n      } catch (error) {\n        if (isRootTransaction) {\n          await this.#executeSql(\"ROLLBACK\");\n        }\n\n        throw error;\n      } finally {\n        this.#transactionDepth -= 1;\n        if (isRootTransaction) {\n          this.#activeTransactionScope = undefined;\n        }\n      }\n    });\n  }\n\n  public async flush(): Promise<void> {\n    await this.#runSerialized(() => {\n      this.#assertOpen();\n    });\n  }\n\n  public async close(): Promise<void> {\n    await this.#runSerialized(async () => {\n      if (this.#closed) {\n        return;\n      }\n\n      await this.#closeDatabase();\n      this.#closed = true;\n    });\n  }\n\n  public async getLastInsertRowId(): Promise<number> {\n    const row = await this.queryOne(\n      \"SELECT last_insert_rowid() AS row_id\",\n      undefined,\n      (value) => getNumber(value, \"row_id\"),\n    );\n\n    if (row === undefined) {\n      throw new Error(\"Could not read last_insert_rowid()\");\n    }\n\n    return row;\n  }\n\n  #assertOpen(): void {\n    if (this.#closed) {\n      throw new Error(\"Database is already closed\");\n    }\n  }\n\n  async #runSerialized<T>(operation: () => Promise<T> | T): Promise<T> {\n    const operationScope = this.#operationScope.getStore();\n\n    if (\n      operationScope !== undefined &&\n      operationScope === this.#activeTransactionScope\n    ) {\n      return await operation();\n    }\n\n    const queuedOperation = this.#operationChain.then(operation);\n\n    this.#operationChain = queuedOperation.then(\n      () => undefined,\n      () => undefined,\n    );\n\n    return await queuedOperation;\n  }\n\n  #markWritten(): void {\n    this.#onWrite?.();\n  }\n\n  async #closeDatabase(): Promise<void> {\n    await new Promise<void>((resolveClose, rejectClose) => {\n      this.#database.close((error) => {\n        if (error !== null) {\n          rejectClose(error);\n          return;\n        }\n\n        resolveClose();\n      });\n    });\n  }\n\n  async #executeSql(sql: string): Promise<void> {\n    await new Promise<void>((resolveExec, rejectExec) => {\n      this.#database.exec(sql, (error) => {\n        if (error !== null) {\n          rejectExec(error);\n          return;\n        }\n\n        resolveExec();\n      });\n    });\n  }\n\n  async #queryAllRows(\n    sql: string,\n    params: SqlBindParams | undefined,\n  ): Promise<SqlRow[]> {\n    return await new Promise<SqlRow[]>((resolveAll, rejectAll) => {\n      this.#database.all<SqlRow>(\n        sql,\n        normalizeSqlBindParams(params),\n        (error, rows) => {\n          if (error !== null) {\n            rejectAll(error);\n            return;\n          }\n\n          resolveAll(rows);\n        },\n      );\n    });\n  }\n\n  async #queryOneRow(\n    sql: string,\n    params: SqlBindParams | undefined,\n  ): Promise<SqlRow | undefined> {\n    return await new Promise<SqlRow | undefined>((resolveGet, rejectGet) => {\n      this.#database.get<SqlRow>(\n        sql,\n        normalizeSqlBindParams(params),\n        (error, row) => {\n          if (error !== null) {\n            rejectGet(error);\n            return;\n          }\n\n          resolveGet(row);\n        },\n      );\n    });\n  }\n\n  async #runStatement(\n    sql: string,\n    params: SqlBindParams | undefined,\n  ): Promise<void> {\n    await new Promise<void>((resolveRun, rejectRun) => {\n      this.#database.run(sql, normalizeSqlBindParams(params), (error) => {\n        if (error !== null) {\n          rejectRun(error);\n          return;\n        }\n\n        resolveRun();\n      });\n    });\n  }\n}\n\nexport function getNumber(row: SqlRow, key: string): number {\n  const value = row[key];\n\n  if (typeof value !== \"number\") {\n    throw new TypeError(`Expected ${key} to be a number`);\n  }\n\n  return value;\n}\n\nexport function getString(row: SqlRow, key: string): string {\n  const value = row[key];\n\n  if (typeof value !== \"string\") {\n    throw new TypeError(`Expected ${key} to be a string`);\n  }\n\n  return value;\n}\n\nexport function getOptionalString(\n  row: SqlRow,\n  key: string,\n): string | undefined {\n  const value = row[key];\n\n  if (value === null || value === undefined) {\n    return undefined;\n  }\n\n  if (typeof value !== \"string\") {\n    throw new TypeError(`Expected ${key} to be a string`);\n  }\n\n  return value;\n}\n\nasync function openSqliteDatabase(\n  databasePath: string,\n  options: { readonly readonly?: boolean } = {},\n): Promise<SqliteDatabase> {\n  const sqlite3 = await loadSqlite3();\n  const flags =\n    (options.readonly === true\n      ? sqlite3.OPEN_READONLY\n      : sqlite3.OPEN_READWRITE | sqlite3.OPEN_CREATE) | sqlite3.OPEN_FULLMUTEX;\n\n  return await new Promise<SqliteDatabase>((resolveOpen, rejectOpen) => {\n    const database = new sqlite3.Database(databasePath, flags, (error) => {\n      if (error !== null) {\n        rejectOpen(error);\n        return;\n      }\n\n      resolveOpen(database);\n    });\n  });\n}\n\nasync function loadSqlite3(): Promise<Sqlite3Module> {\n  const module = await import(\"sqlite3\");\n\n  return resolveSqlite3Module(module as unknown);\n}\n\nfunction resolveSqlite3Module(module: unknown): Sqlite3Module {\n  if (\n    typeof module === \"object\" &&\n    module !== null &&\n    \"default\" in module &&\n    typeof module.default === \"object\" &&\n    module.default !== null &&\n    \"Database\" in module.default\n  ) {\n    return module.default as Sqlite3Module;\n  }\n\n  if (typeof module === \"object\" && module !== null && \"Database\" in module) {\n    return module as Sqlite3Module;\n  }\n\n  throw new TypeError(\"Could not load sqlite3\");\n}\n\nfunction normalizeSqlBindParams(\n  params: SqlBindParams | undefined,\n): SqlBindParams {\n  return params ?? [];\n}\n"],"mappings":"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","names":[]}