@absurd-sqlite/sdk 0.2.0 → 0.2.1-alpha.1

package/dist/sqlite.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absurd-sqlite/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1-alpha.1",
   "description": "TypeScript SDK for Absurd-SQLite - SQLite-based durable task execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -48,4 +48,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}

package/src/extension-downloader.ts

@@ -0,0 +1,291 @@
+import { existsSync, mkdirSync, writeFileSync, chmodSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { createHash } from "node:crypto";
+
+export interface DownloadExtensionOptions {
+  /**
+   * Version of the extension to download. If not specified, uses "latest".
+   * Examples: "v0.1.0-alpha.3", "latest"
+   */
+  version?: string;
+
+  /**
+   * GitHub repository owner. Defaults to "b4fun".
+   */
+  owner?: string;
+
+  /**
+   * GitHub repository name. Defaults to "absurd-sqlite".
+   */
+  repo?: string;
+
+  /**
+   * Custom cache directory for storing downloaded extensions.
+   * If not specified, uses a default cache directory in user's home.
+   */
+  cacheDir?: string;
+
+  /**
+   * Force re-download even if cached version exists.
+   */
+  force?: boolean;
+
+  /**
+   * Expected SHA256 checksum of the downloaded file for validation.
+   * If provided, the downloaded file's checksum will be verified against this value.
+   * If the checksum doesn't match, an error will be thrown.
+   */
+  expectedChecksum?: string;
+}
+
+interface PlatformInfo {
+  os: string;
+  arch: string;
+  ext: string;
+}
+
+function getPlatformInfo(): PlatformInfo {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  let os: string;
+  let ext: string;
+
+  switch (platform) {
+    case "darwin":
+      os = "macOS";
+      ext = "dylib";
+      break;
+    case "linux":
+      os = "Linux";
+      ext = "so";
+      break;
+    case "win32":
+      os = "Windows";
+      ext = "dll";
+      break;
+    default:
+      throw new Error(`Unsupported platform: ${platform}`);
+  }
+
+  let archStr: string;
+  switch (arch) {
+    case "x64":
+      archStr = "X64";
+      break;
+    case "arm64":
+      archStr = "ARM64";
+      break;
+    default:
+      throw new Error(`Unsupported architecture: ${arch}`);
+  }
+
+  return { os, arch: archStr, ext };
+}
+
+function getDefaultCacheDir(): string {
+  return join(homedir(), ".cache", "absurd-sqlite", "extensions");
+}
+
+function getAssetName(version: string, platform: PlatformInfo): string {
+  // Format: absurd-absurd-sqlite-extension-vX.Y.Z-{OS}-{ARCH}.{ext}
+  return `absurd-absurd-sqlite-extension-${version}-${platform.os}-${platform.arch}.${platform.ext}`;
+}
+
+function getTag(version: string): string {
+  return `absurd-sqlite-extension/${version}`;
+}
+
+async function fetchLatestVersion(
+  owner: string,
+  repo: string
+): Promise<string> {
+  const url = `https://api.github.com/repos/${owner}/${repo}/releases`;
+  const response = await fetch(url);
+
+  if (!response.ok) {
+    throw new Error(
+      `Failed to fetch releases: ${response.status} ${response.statusText}`
+    );
+  }
+
+  const releases = (await response.json()) as Array<{
+    tag_name: string;
+    prerelease: boolean;
+    draft: boolean;
+  }>;
+
+  // Find the latest non-draft extension release
+  for (const release of releases) {
+    if (
+      !release.draft &&
+      release.tag_name.startsWith("absurd-sqlite-extension/")
+    ) {
+      // Extract version from tag (e.g., "absurd-sqlite-extension/v0.1.0-alpha.3" -> "v0.1.0-alpha.3")
+      return release.tag_name.replace("absurd-sqlite-extension/", "");
+    }
+  }
+
+  throw new Error("No extension releases found");
+}
+
+async function downloadAsset(
+  owner: string,
+  repo: string,
+  tag: string,
+  assetName: string,
+  destPath: string,
+  expectedChecksum?: string
+): Promise<void> {
+  const url = `https://github.com/${owner}/${repo}/releases/download/${tag}/${assetName}`;
+  const response = await fetch(url);
+
+  if (!response.ok) {
+    throw new Error(
+      `Failed to download extension: ${response.status} ${response.statusText} from ${url}`
+    );
+  }
+
+  const buffer = await response.arrayBuffer();
+  writeFileSync(destPath, Buffer.from(buffer));
+
+  // Verify checksum if provided
+  if (expectedChecksum) {
+    const actualChecksum = calculateChecksum(destPath);
+    if (actualChecksum !== expectedChecksum.toLowerCase()) {
+      throw new Error(
+        `Checksum verification failed. Expected: ${expectedChecksum.toLowerCase()}, Got: ${actualChecksum}`
+      );
+    }
+  }
+
+  // Make the extension executable on Unix-like systems
+  if (process.platform !== "win32") {
+    chmodSync(destPath, 0o755);
+  }
+}
+
+function calculateChecksum(filePath: string): string {
+  const fileBuffer = readFileSync(filePath);
+  const hash = createHash("sha256");
+  hash.update(fileBuffer);
+  return hash.digest("hex");
+}
+
+function getCachedPath(
+  cacheDir: string,
+  version: string,
+  platform: PlatformInfo
+): string {
+  // Use a consistent name that SQLite expects: libabsurd.{ext}
+  const ext = platform.ext;
+  return join(cacheDir, version, `libabsurd.${ext}`);
+}
+
+/**
+ * Downloads the absurd-sqlite extension from GitHub releases.
+ * Returns the path to the downloaded extension file.
+ *
+ * @param options - Download options
+ * @returns Path to the extension file
+ *
+ * @example
+ * ```typescript
+ * import { downloadExtension } from "@absurd-sqlite/sdk";
+ *
+ * // Download latest version
+ * const extensionPath = await downloadExtension();
+ *
+ * // Download specific version
+ * const extensionPath = await downloadExtension({ version: "v0.1.0-alpha.3" });
+ *
+ * // Download with checksum verification
+ * const extensionPath = await downloadExtension({
+ *   version: "v0.1.0-alpha.3",
+ *   expectedChecksum: "abc123..."
+ * });
+ * ```
+ */
+export async function downloadExtension(
+  options: DownloadExtensionOptions = {}
+): Promise<string> {
+  const owner = options.owner ?? "b4fun";
+  const repo = options.repo ?? "absurd-sqlite";
+  const cacheDir = options.cacheDir ?? getDefaultCacheDir();
+  const force = options.force ?? false;
+
+  // Resolve version
+  let version = options.version ?? "latest";
+  if (version === "latest") {
+    version = await fetchLatestVersion(owner, repo);
+  }
+
+  // Get platform info
+  const platform = getPlatformInfo();
+  const assetName = getAssetName(version, platform);
+  const tag = getTag(version);
+
+  // Check cache
+  const cachedPath = getCachedPath(cacheDir, version, platform);
+
+  if (!force && existsSync(cachedPath)) {
+    // If checksum is provided, verify cached file
+    if (options.expectedChecksum) {
+      const actualChecksum = calculateChecksum(cachedPath);
+      if (actualChecksum !== options.expectedChecksum.toLowerCase()) {
+        throw new Error(
+          `Cached file checksum verification failed. Expected: ${options.expectedChecksum.toLowerCase()}, Got: ${actualChecksum}`
+        );
+      }
+    }
+    return cachedPath;
+  }
+
+  // Ensure cache directory exists
+  const versionDir = join(cacheDir, version);
+  mkdirSync(versionDir, { recursive: true });
+
+  // Download asset
+  await downloadAsset(owner, repo, tag, assetName, cachedPath, options.expectedChecksum);
+
+  return cachedPath;
+}
+
+/**
+ * Resolves the extension path, either from the provided path, environment variable,
+ * or by downloading from GitHub releases.
+ *
+ * @param extensionPath - Optional path to the extension file
+ * @param downloadOptions - Options for downloading if no path is provided
+ * @returns Path to the extension file
+ *
+ * @example
+ * ```typescript
+ * import { resolveExtensionPath } from "@absurd-sqlite/sdk";
+ *
+ * // Use provided path
+ * const path1 = await resolveExtensionPath("/path/to/extension.so");
+ *
+ * // Use environment variable or download
+ * const path2 = await resolveExtensionPath();
+ * ```
+ */
+export async function resolveExtensionPath(
+  extensionPath?: string,
+  downloadOptions?: DownloadExtensionOptions
+): Promise<string> {
+  // If path is provided, use it
+  if (extensionPath) {
+    return extensionPath;
+  }
+
+  // Try environment variable
+  const envPath = process.env.ABSURD_SQLITE_EXTENSION_PATH;
+  if (envPath) {
+    return envPath;
+  }
+
+  // Download from GitHub releases
+  return downloadExtension(downloadOptions);
+}

package/src/index.ts

@@ -5,6 +5,11 @@ import type { SQLiteDatabase } from "./sqlite-types";
 import { SqliteConnection } from "./sqlite";
 
 export type { AbsurdClient, Queryable, Worker } from "./absurd-types";
+export {
+  downloadExtension,
+  resolveExtensionPath,
+  type DownloadExtensionOptions,
+} from "./extension-downloader";
 export type {
   AbsurdHooks,
   AbsurdOptions,

package/src/sqlite.ts

@@ -8,6 +8,8 @@ import type {
 
 export class SqliteConnection implements Queryable {
   private readonly db: SQLiteDatabase;
+  private readonly maxRetries = 5;
+  private readonly baseRetryDelayMs = 50;
 
   constructor(db: SQLiteDatabase) {
     this.db = db;
@@ -28,9 +30,11 @@ export class SqliteConnection implements Queryable {
       throw new Error("The query() method is only statements that return data");
     }
 
-    const rowsDecoded = statement
-      .all(sqliteParams)
-      .map((row) => decodeRowValues(statement, row));
+    const rowsDecoded = await this.runWithRetry(() =>
+      statement
+        .all(sqliteParams)
+        .map((row) => decodeRowValues(statement, row))
+    );
 
     return { rows: rowsDecoded };
   }
@@ -39,7 +43,23 @@ export class SqliteConnection implements Queryable {
     const sqliteQuery = rewritePostgresQuery(sql);
     const sqliteParams = rewritePostgresParams(params);
 
-    this.db.prepare(sqliteQuery).run(sqliteParams);
+    const statement = this.db.prepare(sqliteQuery);
+    await this.runWithRetry(() => statement.run(sqliteParams));
+  }
+
+  private async runWithRetry<T>(operation: () => T): Promise<T> {
+    let attempt = 0;
+    while (true) {
+      try {
+        return operation();
+      } catch (err) {
+        if (!isRetryableSQLiteError(err) || attempt >= this.maxRetries) {
+          throw err;
+        }
+        attempt++;
+        await delay(this.baseRetryDelayMs * attempt);
+      }
+    }
   }
 }
 
@@ -160,3 +180,32 @@ function encodeColumnValue(value: any): any {
   }
   return value;
 }
+
+const sqliteRetryableErrorCodes = new Set(["SQLITE_BUSY", "SQLITE_LOCKED"]);
+const sqliteRetryableErrnos = new Set([5, 6]);
+
+function isRetryableSQLiteError(err: unknown): boolean {
+  if (!err || typeof err !== "object") {
+    return false;
+  }
+
+  const code = (err as any).code;
+  if (typeof code === "string") {
+    for (const retryableCode of sqliteRetryableErrorCodes) {
+      if (code.startsWith(retryableCode)) {
+        return true;
+      }
+    }
+  }
+
+  const errno = (err as any).errno;
+  if (typeof errno === "number" && sqliteRetryableErrnos.has(errno)) {
+    return true;
+  }
+
+  return false;
+}
+
+function delay(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/test/extension-downloader.test.ts

@@ -0,0 +1,203 @@
+import { existsSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+
+import {
+  downloadExtension,
+  resolveExtensionPath,
+} from "../src/extension-downloader";
+
+let tempCacheDir: string | null = null;
+
+afterEach(() => {
+  if (tempCacheDir) {
+    rmSync(tempCacheDir, { recursive: true, force: true });
+    tempCacheDir = null;
+  }
+});
+
+// Helper function to calculate checksum of a file
+async function getFileChecksum(filePath: string): Promise<string> {
+  const { createHash } = await import("node:crypto");
+  const { readFileSync } = await import("node:fs");
+  const fileBuffer = readFileSync(filePath);
+  const hash = createHash("sha256");
+  hash.update(fileBuffer);
+  return hash.digest("hex");
+}
+
+describe("downloadExtension", () => {
+  it("downloads specific version", async () => {
+    tempCacheDir = mkdtempSync(join(tmpdir(), "absurd-ext-cache-"));
+
+    const extensionPath = await downloadExtension({
+      version: "v0.1.0-alpha.3",
+      cacheDir: tempCacheDir,
+    });
+
+    expect(existsSync(extensionPath)).toBe(true);
+    expect(extensionPath).toContain("v0.1.0-alpha.3");
+
+    // Verify it has the right extension
+    const platform = process.platform;
+    if (platform === "darwin") {
+      expect(extensionPath).toMatch(/libabsurd\.dylib$/);
+    } else if (platform === "linux") {
+      expect(extensionPath).toMatch(/libabsurd\.so$/);
+    } else if (platform === "win32") {
+      expect(extensionPath).toMatch(/libabsurd\.dll$/);
+    }
+  }, 60000);
+
+  it("uses cached version on second call", async () => {
+    tempCacheDir = mkdtempSync(join(tmpdir(), "absurd-ext-cache-"));
+
+    const path1 = await downloadExtension({
+      version: "v0.1.0-alpha.3",
+      cacheDir: tempCacheDir,
+    });
+
+    const path2 = await downloadExtension({
+      version: "v0.1.0-alpha.3",
+      cacheDir: tempCacheDir,
+    });
+
+    expect(path1).toBe(path2);
+  }, 60000);
+
+  it("forces re-download when force=true", async () => {
+    tempCacheDir = mkdtempSync(join(tmpdir(), "absurd-ext-cache-"));
+
+    const path1 = await downloadExtension({
+      version: "v0.1.0-alpha.3",
+      cacheDir: tempCacheDir,
+    });
+
+    // Delete the cached file
+    rmSync(path1);
+    expect(existsSync(path1)).toBe(false);
+
+    // Download again with force
+    const path2 = await downloadExtension({
+      version: "v0.1.0-alpha.3",
+      cacheDir: tempCacheDir,
+      force: true,
+    });
+
+    expect(existsSync(path2)).toBe(true);
+    expect(path2).toBe(path1); // Same path
+  }, 60000);
+
+  it("validates checksum when provided", async () => {
+    tempCacheDir = mkdtempSync(join(tmpdir(), "absurd-ext-cache-"));
+
+    // First download to get the file
+    const extensionPath = await downloadExtension({
+      version: "v0.1.0-alpha.3",
+      cacheDir: tempCacheDir,
+    });
+
+    // Calculate the actual checksum
+    const actualChecksum = await getFileChecksum(extensionPath);
+
+    // Clear cache
+    rmSync(extensionPath);
+
+    // Download again with correct checksum - should succeed
+    const path1 = await downloadExtension({
+      version: "v0.1.0-alpha.3",
+      cacheDir: tempCacheDir,
+      expectedChecksum: actualChecksum,
+    });
+
+    expect(existsSync(path1)).toBe(true);
+
+    // Try with wrong checksum - should fail
+    rmSync(path1);
+    await expect(
+      downloadExtension({
+        version: "v0.1.0-alpha.3",
+        cacheDir: tempCacheDir,
+        expectedChecksum: "0000000000000000000000000000000000000000000000000000000000000000",
+      })
+    ).rejects.toThrow(/Checksum verification failed/);
+  }, 60000);
+
+  it("validates checksum of cached file", async () => {
+    tempCacheDir = mkdtempSync(join(tmpdir(), "absurd-ext-cache-"));
+
+    // First download to get the file
+    const extensionPath = await downloadExtension({
+      version: "v0.1.0-alpha.3",
+      cacheDir: tempCacheDir,
+    });
+
+    // Calculate the actual checksum
+    const actualChecksum = await getFileChecksum(extensionPath);
+
+    // Use cached file with correct checksum - should succeed
+    const path1 = await downloadExtension({
+      version: "v0.1.0-alpha.3",
+      cacheDir: tempCacheDir,
+      expectedChecksum: actualChecksum,
+    });
+
+    expect(existsSync(path1)).toBe(true);
+
+    // Try with wrong checksum on cached file - should fail
+    await expect(
+      downloadExtension({
+        version: "v0.1.0-alpha.3",
+        cacheDir: tempCacheDir,
+        expectedChecksum: "0000000000000000000000000000000000000000000000000000000000000000",
+      })
+    ).rejects.toThrow(/Cached file checksum verification failed/);
+  }, 60000);
+});
+
+describe("resolveExtensionPath", () => {
+  it("returns provided path when given", async () => {
+    const providedPath = "/custom/path/to/extension.so";
+    const resolved = await resolveExtensionPath(providedPath);
+    expect(resolved).toBe(providedPath);
+  });
+
+  it("uses environment variable when no path provided", async () => {
+    const envPath = "/env/path/to/extension.so";
+    const originalEnv = process.env.ABSURD_SQLITE_EXTENSION_PATH;
+
+    try {
+      process.env.ABSURD_SQLITE_EXTENSION_PATH = envPath;
+      const resolved = await resolveExtensionPath();
+      expect(resolved).toBe(envPath);
+    } finally {
+      if (originalEnv !== undefined) {
+        process.env.ABSURD_SQLITE_EXTENSION_PATH = originalEnv;
+      } else {
+        delete process.env.ABSURD_SQLITE_EXTENSION_PATH;
+      }
+    }
+  });
+
+  it("downloads when no path or env var provided", async () => {
+    tempCacheDir = mkdtempSync(join(tmpdir(), "absurd-ext-cache-"));
+    const originalEnv = process.env.ABSURD_SQLITE_EXTENSION_PATH;
+
+    try {
+      delete process.env.ABSURD_SQLITE_EXTENSION_PATH;
+
+      const resolved = await resolveExtensionPath(undefined, {
+        version: "v0.1.0-alpha.3",
+        cacheDir: tempCacheDir,
+      });
+
+      expect(existsSync(resolved)).toBe(true);
+      expect(resolved).toContain(tempCacheDir);
+    } finally {
+      if (originalEnv !== undefined) {
+        process.env.ABSURD_SQLITE_EXTENSION_PATH = originalEnv;
+      }
+    }
+  }, 60000);
+});