@absurd-sqlite/bun-worker 0.2.1 → 0.2.2-alpha.1

package/bun.lock

@@ -5,8 +5,9 @@
     "": {
       "name": "@absurd-sqlite/bun-worker",
       "dependencies": {
-        "@absurd-sqlite/sdk": "~0.2.0",
+        "@absurd-sqlite/sdk": "next",
         "absurd-sdk": "~0.0.7",
+        "cac": "^6.7.14",
       },
       "devDependencies": {
         "bun-types": "^1.3.5",
@@ -15,7 +16,7 @@
     },
   },
   "packages": {
-    "@absurd-sqlite/sdk": ["@absurd-sqlite/sdk@0.2.0", "", { "dependencies": { "absurd-sdk": "~0.0.7" }, "peerDependencies": { "better-sqlite3": "^12.5.0" } }, "sha512-DQVvEKK3F/+jvmbcC1dLmm9kTrGk5xn3Hhet76swHDtug/XvY8Tb+pKBjIVNvfqzxcJ+/BBv5QWbW/6qfozPHw=="],
+    "@absurd-sqlite/sdk": ["@absurd-sqlite/sdk@0.2.1-alpha.1", "", { "dependencies": { "absurd-sdk": "~0.0.7" }, "peerDependencies": { "better-sqlite3": "^12.5.0" } }, "sha512-gIly9R1ZO/9Ja/dDbVupxs5Yd4AXx+iDz5PIsq0qg/GSCCIujxt8VXI4c+BvkbvEY1ew7mpvmZa/ttMkKopFrA=="],
 
     "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
 
@@ -33,6 +34,8 @@
 
     "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
 
+    "cac": ["cac@6.7.14", "", {}, "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ=="],
+
     "chownr": ["chownr@1.1.4", "", {}, "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg=="],
 
     "decompress-response": ["decompress-response@6.0.0", "", { "dependencies": { "mimic-response": "^3.1.0" } }, "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ=="],

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import type { AbsurdClient } from "@absurd-sqlite/sdk";
 export type { AbsurdClient } from "@absurd-sqlite/sdk";
+export type { WorkerOptions } from "absurd-sdk";
+export { downloadExtension, type DownloadExtensionOptions, } from "@absurd-sqlite/sdk";
 /**
  * Register tasks and perform any one-time setup before the worker starts.
  */
@@ -7,9 +9,10 @@ export type SetupFunction = (absurd: AbsurdClient) => void | Promise<void>;
 /**
  * Boots a worker using Bun's SQLite driver and Absurd's task engine.
  *
- * Requires:
- * - ABSURD_DATABASE_PATH: SQLite database file path.
- * - ABSURD_DATABASE_EXTENSION_PATH: Absurd-SQLite extension path (libabsurd.*).
+ * CLI flags:
+ * - --concurrency, -c: Number of tasks to process concurrently (default: 10)
+ * - --database-path: SQLite database file path (overrides ABSURD_DATABASE_PATH)
+ * - --extension-path: Absurd-SQLite extension path (overrides ABSURD_DATABASE_EXTENSION_PATH)
  */
 export default function run(setupFunction: SetupFunction): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3E;;;;;;GAMG;AACH,wBAA8B,GAAG,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C7E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AA0D3E;;;;;;;GAOG;AACH,wBAA8B,GAAG,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6D7E"}

package/dist/index.js

@@ -5305,9 +5305,612 @@ function normalizeCancellation(policy) {
 // src/index.ts
 import { Database } from "bun:sqlite";
 
+// node_modules/cac/dist/index.mjs
+import { EventEmitter } from "events";
+function toArr(any) {
+  return any == null ? [] : Array.isArray(any) ? any : [any];
+}
+function toVal(out, key, val, opts) {
+  var x, old = out[key], nxt = ~opts.string.indexOf(key) ? val == null || val === true ? "" : String(val) : typeof val === "boolean" ? val : ~opts.boolean.indexOf(key) ? val === "false" ? false : val === "true" || (out._.push((x = +val, x * 0 === 0) ? x : val), !!val) : (x = +val, x * 0 === 0) ? x : val;
+  out[key] = old == null ? nxt : Array.isArray(old) ? old.concat(nxt) : [old, nxt];
+}
+function mri2(args, opts) {
+  args = args || [];
+  opts = opts || {};
+  var k, arr, arg, name, val, out = { _: [] };
+  var i = 0, j = 0, idx = 0, len = args.length;
+  const alibi = opts.alias !== undefined;
+  const strict = opts.unknown !== undefined;
+  const defaults2 = opts.default !== undefined;
+  opts.alias = opts.alias || {};
+  opts.string = toArr(opts.string);
+  opts.boolean = toArr(opts.boolean);
+  if (alibi) {
+    for (k in opts.alias) {
+      arr = opts.alias[k] = toArr(opts.alias[k]);
+      for (i = 0;i < arr.length; i++) {
+        (opts.alias[arr[i]] = arr.concat(k)).splice(i, 1);
+      }
+    }
+  }
+  for (i = opts.boolean.length;i-- > 0; ) {
+    arr = opts.alias[opts.boolean[i]] || [];
+    for (j = arr.length;j-- > 0; )
+      opts.boolean.push(arr[j]);
+  }
+  for (i = opts.string.length;i-- > 0; ) {
+    arr = opts.alias[opts.string[i]] || [];
+    for (j = arr.length;j-- > 0; )
+      opts.string.push(arr[j]);
+  }
+  if (defaults2) {
+    for (k in opts.default) {
+      name = typeof opts.default[k];
+      arr = opts.alias[k] = opts.alias[k] || [];
+      if (opts[name] !== undefined) {
+        opts[name].push(k);
+        for (i = 0;i < arr.length; i++) {
+          opts[name].push(arr[i]);
+        }
+      }
+    }
+  }
+  const keys = strict ? Object.keys(opts.alias) : [];
+  for (i = 0;i < len; i++) {
+    arg = args[i];
+    if (arg === "--") {
+      out._ = out._.concat(args.slice(++i));
+      break;
+    }
+    for (j = 0;j < arg.length; j++) {
+      if (arg.charCodeAt(j) !== 45)
+        break;
+    }
+    if (j === 0) {
+      out._.push(arg);
+    } else if (arg.substring(j, j + 3) === "no-") {
+      name = arg.substring(j + 3);
+      if (strict && !~keys.indexOf(name)) {
+        return opts.unknown(arg);
+      }
+      out[name] = false;
+    } else {
+      for (idx = j + 1;idx < arg.length; idx++) {
+        if (arg.charCodeAt(idx) === 61)
+          break;
+      }
+      name = arg.substring(j, idx);
+      val = arg.substring(++idx) || (i + 1 === len || ("" + args[i + 1]).charCodeAt(0) === 45 || args[++i]);
+      arr = j === 2 ? [name] : name;
+      for (idx = 0;idx < arr.length; idx++) {
+        name = arr[idx];
+        if (strict && !~keys.indexOf(name))
+          return opts.unknown("-".repeat(j) + name);
+        toVal(out, name, idx + 1 < arr.length || val, opts);
+      }
+    }
+  }
+  if (defaults2) {
+    for (k in opts.default) {
+      if (out[k] === undefined) {
+        out[k] = opts.default[k];
+      }
+    }
+  }
+  if (alibi) {
+    for (k in out) {
+      arr = opts.alias[k] || [];
+      while (arr.length > 0) {
+        out[arr.shift()] = out[k];
+      }
+    }
+  }
+  return out;
+}
+var removeBrackets = (v) => v.replace(/[<[].+/, "").trim();
+var findAllBrackets = (v) => {
+  const ANGLED_BRACKET_RE_GLOBAL = /<([^>]+)>/g;
+  const SQUARE_BRACKET_RE_GLOBAL = /\[([^\]]+)\]/g;
+  const res = [];
+  const parse = (match) => {
+    let variadic = false;
+    let value = match[1];
+    if (value.startsWith("...")) {
+      value = value.slice(3);
+      variadic = true;
+    }
+    return {
+      required: match[0].startsWith("<"),
+      value,
+      variadic
+    };
+  };
+  let angledMatch;
+  while (angledMatch = ANGLED_BRACKET_RE_GLOBAL.exec(v)) {
+    res.push(parse(angledMatch));
+  }
+  let squareMatch;
+  while (squareMatch = SQUARE_BRACKET_RE_GLOBAL.exec(v)) {
+    res.push(parse(squareMatch));
+  }
+  return res;
+};
+var getMriOptions = (options) => {
+  const result = { alias: {}, boolean: [] };
+  for (const [index, option] of options.entries()) {
+    if (option.names.length > 1) {
+      result.alias[option.names[0]] = option.names.slice(1);
+    }
+    if (option.isBoolean) {
+      if (option.negated) {
+        const hasStringTypeOption = options.some((o, i) => {
+          return i !== index && o.names.some((name) => option.names.includes(name)) && typeof o.required === "boolean";
+        });
+        if (!hasStringTypeOption) {
+          result.boolean.push(option.names[0]);
+        }
+      } else {
+        result.boolean.push(option.names[0]);
+      }
+    }
+  }
+  return result;
+};
+var findLongest = (arr) => {
+  return arr.sort((a, b) => {
+    return a.length > b.length ? -1 : 1;
+  })[0];
+};
+var padRight = (str, length) => {
+  return str.length >= length ? str : `${str}${" ".repeat(length - str.length)}`;
+};
+var camelcase = (input) => {
+  return input.replace(/([a-z])-([a-z])/g, (_, p1, p2) => {
+    return p1 + p2.toUpperCase();
+  });
+};
+var setDotProp = (obj, keys, val) => {
+  let i = 0;
+  let length = keys.length;
+  let t = obj;
+  let x;
+  for (;i < length; ++i) {
+    x = t[keys[i]];
+    t = t[keys[i]] = i === length - 1 ? val : x != null ? x : !!~keys[i + 1].indexOf(".") || !(+keys[i + 1] > -1) ? {} : [];
+  }
+};
+var setByType = (obj, transforms) => {
+  for (const key of Object.keys(transforms)) {
+    const transform = transforms[key];
+    if (transform.shouldTransform) {
+      obj[key] = Array.prototype.concat.call([], obj[key]);
+      if (typeof transform.transformFunction === "function") {
+        obj[key] = obj[key].map(transform.transformFunction);
+      }
+    }
+  }
+};
+var getFileName = (input) => {
+  const m = /([^\\\/]+)$/.exec(input);
+  return m ? m[1] : "";
+};
+var camelcaseOptionName = (name) => {
+  return name.split(".").map((v, i) => {
+    return i === 0 ? camelcase(v) : v;
+  }).join(".");
+};
+
+class CACError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = this.constructor.name;
+    if (typeof Error.captureStackTrace === "function") {
+      Error.captureStackTrace(this, this.constructor);
+    } else {
+      this.stack = new Error(message).stack;
+    }
+  }
+}
+
+class Option {
+  constructor(rawName, description, config) {
+    this.rawName = rawName;
+    this.description = description;
+    this.config = Object.assign({}, config);
+    rawName = rawName.replace(/\.\*/g, "");
+    this.negated = false;
+    this.names = removeBrackets(rawName).split(",").map((v) => {
+      let name = v.trim().replace(/^-{1,2}/, "");
+      if (name.startsWith("no-")) {
+        this.negated = true;
+        name = name.replace(/^no-/, "");
+      }
+      return camelcaseOptionName(name);
+    }).sort((a, b) => a.length > b.length ? 1 : -1);
+    this.name = this.names[this.names.length - 1];
+    if (this.negated && this.config.default == null) {
+      this.config.default = true;
+    }
+    if (rawName.includes("<")) {
+      this.required = true;
+    } else if (rawName.includes("[")) {
+      this.required = false;
+    } else {
+      this.isBoolean = true;
+    }
+  }
+}
+var processArgs = process.argv;
+var platformInfo = `${process.platform}-${process.arch} node-${process.version}`;
+
+class Command {
+  constructor(rawName, description, config = {}, cli) {
+    this.rawName = rawName;
+    this.description = description;
+    this.config = config;
+    this.cli = cli;
+    this.options = [];
+    this.aliasNames = [];
+    this.name = removeBrackets(rawName);
+    this.args = findAllBrackets(rawName);
+    this.examples = [];
+  }
+  usage(text) {
+    this.usageText = text;
+    return this;
+  }
+  allowUnknownOptions() {
+    this.config.allowUnknownOptions = true;
+    return this;
+  }
+  ignoreOptionDefaultValue() {
+    this.config.ignoreOptionDefaultValue = true;
+    return this;
+  }
+  version(version, customFlags = "-v, --version") {
+    this.versionNumber = version;
+    this.option(customFlags, "Display version number");
+    return this;
+  }
+  example(example) {
+    this.examples.push(example);
+    return this;
+  }
+  option(rawName, description, config) {
+    const option = new Option(rawName, description, config);
+    this.options.push(option);
+    return this;
+  }
+  alias(name) {
+    this.aliasNames.push(name);
+    return this;
+  }
+  action(callback) {
+    this.commandAction = callback;
+    return this;
+  }
+  isMatched(name) {
+    return this.name === name || this.aliasNames.includes(name);
+  }
+  get isDefaultCommand() {
+    return this.name === "" || this.aliasNames.includes("!");
+  }
+  get isGlobalCommand() {
+    return this instanceof GlobalCommand;
+  }
+  hasOption(name) {
+    name = name.split(".")[0];
+    return this.options.find((option) => {
+      return option.names.includes(name);
+    });
+  }
+  outputHelp() {
+    const { name, commands } = this.cli;
+    const {
+      versionNumber,
+      options: globalOptions,
+      helpCallback
+    } = this.cli.globalCommand;
+    let sections = [
+      {
+        body: `${name}${versionNumber ? `/${versionNumber}` : ""}`
+      }
+    ];
+    sections.push({
+      title: "Usage",
+      body: `  $ ${name} ${this.usageText || this.rawName}`
+    });
+    const showCommands = (this.isGlobalCommand || this.isDefaultCommand) && commands.length > 0;
+    if (showCommands) {
+      const longestCommandName = findLongest(commands.map((command) => command.rawName));
+      sections.push({
+        title: "Commands",
+        body: commands.map((command) => {
+          return `  ${padRight(command.rawName, longestCommandName.length)}  ${command.description}`;
+        }).join(`
+`)
+      });
+      sections.push({
+        title: `For more info, run any command with the \`--help\` flag`,
+        body: commands.map((command) => `  $ ${name}${command.name === "" ? "" : ` ${command.name}`} --help`).join(`
+`)
+      });
+    }
+    let options = this.isGlobalCommand ? globalOptions : [...this.options, ...globalOptions || []];
+    if (!this.isGlobalCommand && !this.isDefaultCommand) {
+      options = options.filter((option) => option.name !== "version");
+    }
+    if (options.length > 0) {
+      const longestOptionName = findLongest(options.map((option) => option.rawName));
+      sections.push({
+        title: "Options",
+        body: options.map((option) => {
+          return `  ${padRight(option.rawName, longestOptionName.length)}  ${option.description} ${option.config.default === undefined ? "" : `(default: ${option.config.default})`}`;
+        }).join(`
+`)
+      });
+    }
+    if (this.examples.length > 0) {
+      sections.push({
+        title: "Examples",
+        body: this.examples.map((example) => {
+          if (typeof example === "function") {
+            return example(name);
+          }
+          return example;
+        }).join(`
+`)
+      });
+    }
+    if (helpCallback) {
+      sections = helpCallback(sections) || sections;
+    }
+    console.log(sections.map((section) => {
+      return section.title ? `${section.title}:
+${section.body}` : section.body;
+    }).join(`
+
+`));
+  }
+  outputVersion() {
+    const { name } = this.cli;
+    const { versionNumber } = this.cli.globalCommand;
+    if (versionNumber) {
+      console.log(`${name}/${versionNumber} ${platformInfo}`);
+    }
+  }
+  checkRequiredArgs() {
+    const minimalArgsCount = this.args.filter((arg) => arg.required).length;
+    if (this.cli.args.length < minimalArgsCount) {
+      throw new CACError(`missing required args for command \`${this.rawName}\``);
+    }
+  }
+  checkUnknownOptions() {
+    const { options, globalCommand } = this.cli;
+    if (!this.config.allowUnknownOptions) {
+      for (const name of Object.keys(options)) {
+        if (name !== "--" && !this.hasOption(name) && !globalCommand.hasOption(name)) {
+          throw new CACError(`Unknown option \`${name.length > 1 ? `--${name}` : `-${name}`}\``);
+        }
+      }
+    }
+  }
+  checkOptionValue() {
+    const { options: parsedOptions, globalCommand } = this.cli;
+    const options = [...globalCommand.options, ...this.options];
+    for (const option of options) {
+      const value = parsedOptions[option.name.split(".")[0]];
+      if (option.required) {
+        const hasNegated = options.some((o) => o.negated && o.names.includes(option.name));
+        if (value === true || value === false && !hasNegated) {
+          throw new CACError(`option \`${option.rawName}\` value is missing`);
+        }
+      }
+    }
+  }
+}
+
+class GlobalCommand extends Command {
+  constructor(cli) {
+    super("@@global@@", "", {}, cli);
+  }
+}
+var __assign = Object.assign;
+
+class CAC extends EventEmitter {
+  constructor(name = "") {
+    super();
+    this.name = name;
+    this.commands = [];
+    this.rawArgs = [];
+    this.args = [];
+    this.options = {};
+    this.globalCommand = new GlobalCommand(this);
+    this.globalCommand.usage("<command> [options]");
+  }
+  usage(text) {
+    this.globalCommand.usage(text);
+    return this;
+  }
+  command(rawName, description, config) {
+    const command = new Command(rawName, description || "", config, this);
+    command.globalCommand = this.globalCommand;
+    this.commands.push(command);
+    return command;
+  }
+  option(rawName, description, config) {
+    this.globalCommand.option(rawName, description, config);
+    return this;
+  }
+  help(callback) {
+    this.globalCommand.option("-h, --help", "Display this message");
+    this.globalCommand.helpCallback = callback;
+    this.showHelpOnExit = true;
+    return this;
+  }
+  version(version, customFlags = "-v, --version") {
+    this.globalCommand.version(version, customFlags);
+    this.showVersionOnExit = true;
+    return this;
+  }
+  example(example) {
+    this.globalCommand.example(example);
+    return this;
+  }
+  outputHelp() {
+    if (this.matchedCommand) {
+      this.matchedCommand.outputHelp();
+    } else {
+      this.globalCommand.outputHelp();
+    }
+  }
+  outputVersion() {
+    this.globalCommand.outputVersion();
+  }
+  setParsedInfo({ args, options }, matchedCommand, matchedCommandName) {
+    this.args = args;
+    this.options = options;
+    if (matchedCommand) {
+      this.matchedCommand = matchedCommand;
+    }
+    if (matchedCommandName) {
+      this.matchedCommandName = matchedCommandName;
+    }
+    return this;
+  }
+  unsetMatchedCommand() {
+    this.matchedCommand = undefined;
+    this.matchedCommandName = undefined;
+  }
+  parse(argv = processArgs, {
+    run = true
+  } = {}) {
+    this.rawArgs = argv;
+    if (!this.name) {
+      this.name = argv[1] ? getFileName(argv[1]) : "cli";
+    }
+    let shouldParse = true;
+    for (const command of this.commands) {
+      const parsed = this.mri(argv.slice(2), command);
+      const commandName = parsed.args[0];
+      if (command.isMatched(commandName)) {
+        shouldParse = false;
+        const parsedInfo = __assign(__assign({}, parsed), {
+          args: parsed.args.slice(1)
+        });
+        this.setParsedInfo(parsedInfo, command, commandName);
+        this.emit(`command:${commandName}`, command);
+      }
+    }
+    if (shouldParse) {
+      for (const command of this.commands) {
+        if (command.name === "") {
+          shouldParse = false;
+          const parsed = this.mri(argv.slice(2), command);
+          this.setParsedInfo(parsed, command);
+          this.emit(`command:!`, command);
+        }
+      }
+    }
+    if (shouldParse) {
+      const parsed = this.mri(argv.slice(2));
+      this.setParsedInfo(parsed);
+    }
+    if (this.options.help && this.showHelpOnExit) {
+      this.outputHelp();
+      run = false;
+      this.unsetMatchedCommand();
+    }
+    if (this.options.version && this.showVersionOnExit && this.matchedCommandName == null) {
+      this.outputVersion();
+      run = false;
+      this.unsetMatchedCommand();
+    }
+    const parsedArgv = { args: this.args, options: this.options };
+    if (run) {
+      this.runMatchedCommand();
+    }
+    if (!this.matchedCommand && this.args[0]) {
+      this.emit("command:*");
+    }
+    return parsedArgv;
+  }
+  mri(argv, command) {
+    const cliOptions = [
+      ...this.globalCommand.options,
+      ...command ? command.options : []
+    ];
+    const mriOptions = getMriOptions(cliOptions);
+    let argsAfterDoubleDashes = [];
+    const doubleDashesIndex = argv.indexOf("--");
+    if (doubleDashesIndex > -1) {
+      argsAfterDoubleDashes = argv.slice(doubleDashesIndex + 1);
+      argv = argv.slice(0, doubleDashesIndex);
+    }
+    let parsed = mri2(argv, mriOptions);
+    parsed = Object.keys(parsed).reduce((res, name) => {
+      return __assign(__assign({}, res), {
+        [camelcaseOptionName(name)]: parsed[name]
+      });
+    }, { _: [] });
+    const args = parsed._;
+    const options = {
+      "--": argsAfterDoubleDashes
+    };
+    const ignoreDefault = command && command.config.ignoreOptionDefaultValue ? command.config.ignoreOptionDefaultValue : this.globalCommand.config.ignoreOptionDefaultValue;
+    let transforms = Object.create(null);
+    for (const cliOption of cliOptions) {
+      if (!ignoreDefault && cliOption.config.default !== undefined) {
+        for (const name of cliOption.names) {
+          options[name] = cliOption.config.default;
+        }
+      }
+      if (Array.isArray(cliOption.config.type)) {
+        if (transforms[cliOption.name] === undefined) {
+          transforms[cliOption.name] = Object.create(null);
+          transforms[cliOption.name]["shouldTransform"] = true;
+          transforms[cliOption.name]["transformFunction"] = cliOption.config.type[0];
+        }
+      }
+    }
+    for (const key of Object.keys(parsed)) {
+      if (key !== "_") {
+        const keys = key.split(".");
+        setDotProp(options, keys, parsed[key]);
+        setByType(options, transforms);
+      }
+    }
+    return {
+      args,
+      options
+    };
+  }
+  runMatchedCommand() {
+    const { args, options, matchedCommand: command } = this;
+    if (!command || !command.commandAction)
+      return;
+    command.checkUnknownOptions();
+    command.checkOptionValue();
+    command.checkRequiredArgs();
+    const actionArgs = [];
+    command.args.forEach((arg, index) => {
+      if (arg.variadic) {
+        actionArgs.push(args.slice(index));
+      } else {
+        actionArgs.push(args[index]);
+      }
+    });
+    actionArgs.push(options);
+    return command.commandAction.apply(this, actionArgs);
+  }
+}
+var cac = (name = "") => new CAC(name);
+
 // src/sqlite.ts
 class BunSqliteConnection {
   db;
+  maxRetries = 5;
+  baseRetryDelayMs = 50;
   constructor(db) {
     this.db = db;
   }
@@ -5315,13 +5918,28 @@ class BunSqliteConnection {
     const { sql: sqliteQuery, paramOrder } = rewritePostgresQuery(sql);
     const sqliteParams = rewritePostgresParams(normalizeParams(params), paramOrder);
     const statement = this.db.query(sqliteQuery);
-    const rows = statement.all(...sqliteParams).map((row) => decodeRowValues(row));
+    const rows = await this.runWithRetry(() => statement.all(...sqliteParams).map((row) => decodeRowValues(row)));
     return { rows };
   }
   async exec(sql, params) {
     const { sql: sqliteQuery, paramOrder } = rewritePostgresQuery(sql);
     const sqliteParams = rewritePostgresParams(normalizeParams(params), paramOrder);
-    this.db.query(sqliteQuery).run(...sqliteParams);
+    const statement = this.db.query(sqliteQuery);
+    await this.runWithRetry(() => statement.run(...sqliteParams));
+  }
+  async runWithRetry(operation) {
+    let attempt = 0;
+    while (true) {
+      try {
+        return operation();
+      } catch (err) {
+        if (!isRetryableSQLiteError(err) || attempt >= this.maxRetries) {
+          throw err;
+        }
+        attempt++;
+        await delay(this.baseRetryDelayMs * attempt);
+      }
+    }
   }
 }
 function rewritePostgresQuery(text) {
@@ -5415,23 +6033,198 @@ function isBindParams(value) {
   const tag = Object.prototype.toString.call(value);
   return tag === "[object Object]";
 }
+var sqliteRetryableErrorCodes = new Set(["SQLITE_BUSY", "SQLITE_LOCKED"]);
+var sqliteRetryableErrnos = new Set([5, 6]);
+function isRetryableSQLiteError(err) {
+  if (!err || typeof err !== "object") {
+    return false;
+  }
+  const code = err.code;
+  if (typeof code === "string") {
+    for (const retryableCode of sqliteRetryableErrorCodes) {
+      if (code.startsWith(retryableCode)) {
+        return true;
+      }
+    }
+  }
+  const errno = err.errno;
+  if (typeof errno === "number" && sqliteRetryableErrnos.has(errno)) {
+    return true;
+  }
+  return false;
+}
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// node_modules/@absurd-sqlite/sdk/dist/sqlite.js
+var sqliteRetryableErrorCodes2 = new Set(["SQLITE_BUSY", "SQLITE_LOCKED"]);
+var sqliteRetryableErrnos2 = new Set([5, 6]);
 
+// node_modules/@absurd-sqlite/sdk/dist/extension-downloader.js
+import { existsSync, mkdirSync, writeFileSync, chmodSync, readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { createHash } from "crypto";
+function getPlatformInfo() {
+  const platform = process.platform;
+  const arch = process.arch;
+  let os2;
+  let ext;
+  switch (platform) {
+    case "darwin":
+      os2 = "macOS";
+      ext = "dylib";
+      break;
+    case "linux":
+      os2 = "Linux";
+      ext = "so";
+      break;
+    case "win32":
+      os2 = "Windows";
+      ext = "dll";
+      break;
+    default:
+      throw new Error(`Unsupported platform: ${platform}`);
+  }
+  let archStr;
+  switch (arch) {
+    case "x64":
+      archStr = "X64";
+      break;
+    case "arm64":
+      archStr = "ARM64";
+      break;
+    default:
+      throw new Error(`Unsupported architecture: ${arch}`);
+  }
+  return { os: os2, arch: archStr, ext };
+}
+function getDefaultCacheDir() {
+  return join(homedir(), ".cache", "absurd-sqlite", "extensions");
+}
+function getAssetName(version, platform) {
+  return `absurd-absurd-sqlite-extension-${version}-${platform.os}-${platform.arch}.${platform.ext}`;
+}
+function getTag(version) {
+  return `absurd-sqlite-extension/${version}`;
+}
+async function fetchLatestVersion(owner, repo) {
+  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();
+  for (const release of releases) {
+    if (!release.draft && release.tag_name.startsWith("absurd-sqlite-extension/")) {
+      return release.tag_name.replace("absurd-sqlite-extension/", "");
+    }
+  }
+  throw new Error("No extension releases found");
+}
+async function downloadAsset(owner, repo, tag, assetName, destPath, expectedChecksum) {
+  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));
+  if (expectedChecksum) {
+    const actualChecksum = calculateChecksum(destPath);
+    if (actualChecksum !== expectedChecksum.toLowerCase()) {
+      throw new Error(`Checksum verification failed. Expected: ${expectedChecksum.toLowerCase()}, Got: ${actualChecksum}`);
+    }
+  }
+  if (process.platform !== "win32") {
+    chmodSync(destPath, 493);
+  }
+}
+function calculateChecksum(filePath) {
+  const fileBuffer = readFileSync(filePath);
+  const hash = createHash("sha256");
+  hash.update(fileBuffer);
+  return hash.digest("hex");
+}
+function getCachedPath(cacheDir, version, platform) {
+  const ext = platform.ext;
+  return join(cacheDir, version, `libabsurd.${ext}`);
+}
+async function downloadExtension(options = {}) {
+  const owner = options.owner ?? "b4fun";
+  const repo = options.repo ?? "absurd-sqlite";
+  const cacheDir = options.cacheDir ?? getDefaultCacheDir();
+  const force = options.force ?? false;
+  let version = options.version ?? "latest";
+  if (version === "latest") {
+    version = await fetchLatestVersion(owner, repo);
+  }
+  const platform = getPlatformInfo();
+  const assetName = getAssetName(version, platform);
+  const tag = getTag(version);
+  const cachedPath = getCachedPath(cacheDir, version, platform);
+  if (!force && existsSync(cachedPath)) {
+    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;
+  }
+  const versionDir = join(cacheDir, version);
+  mkdirSync(versionDir, { recursive: true });
+  await downloadAsset(owner, repo, tag, assetName, cachedPath, options.expectedChecksum);
+  return cachedPath;
+}
 // src/index.ts
+function parseCliOptions() {
+  const cli = cac("bun-worker");
+  cli.option("-c, --concurrency <number>", "Number of tasks to process concurrently", {
+    default: 10
+  }).option("--database-path <path>", "SQLite database file path").option("--extension-path <path>", "Absurd-SQLite extension path").help();
+  const parsed = cli.parse(process.argv, { run: false });
+  if (parsed.options.help) {
+    process.exit(0);
+  }
+  const options = {};
+  if (parsed.options.databasePath) {
+    options.dbPath = parsed.options.databasePath;
+  }
+  if (parsed.options.extensionPath) {
+    options.extensionPath = parsed.options.extensionPath;
+  }
+  if (parsed.options.concurrency) {
+    const value = parseInt(parsed.options.concurrency, 10);
+    if (!isNaN(value) && value > 0) {
+      options.concurrency = value;
+    } else {
+      console.warn(`Invalid value for --concurrency: "${parsed.options.concurrency}" (must be a positive integer)`);
+    }
+  }
+  return options;
+}
 async function run(setupFunction) {
-  const dbPath = process.env.ABSURD_DATABASE_PATH;
-  const extensionPath = process.env.ABSURD_DATABASE_EXTENSION_PATH;
+  const cliOptions = parseCliOptions();
+  const dbPath = cliOptions.dbPath || process.env.ABSURD_DATABASE_PATH;
+  const extensionPath = cliOptions.extensionPath || process.env.ABSURD_DATABASE_EXTENSION_PATH;
   if (!dbPath) {
-    throw new Error("ABSURD_DATABASE_PATH is required");
+    throw new Error("Database path is required. Set ABSURD_DATABASE_PATH environment variable or use --database-path flag.");
   }
   if (!extensionPath) {
-    throw new Error("ABSURD_DATABASE_EXTENSION_PATH is required");
+    throw new Error("Extension path is required. Set ABSURD_DATABASE_EXTENSION_PATH environment variable or use --extension-path flag.");
   }
   const db = new Database(dbPath);
   db.loadExtension(extensionPath);
   const conn = new BunSqliteConnection(db);
   const absurd = new Absurd({ db: conn });
   await setupFunction(absurd);
-  const worker = await absurd.startWorker();
+  const workerOptions = {
+    ...getDefaultWorkerOptions(),
+    ...cliOptions.concurrency !== undefined ? { concurrency: cliOptions.concurrency } : {}
+  };
+  const worker = await absurd.startWorker(workerOptions);
   let shuttingDown = false;
   const shutdown = async (signal) => {
     if (shuttingDown) {
@@ -5453,6 +6246,14 @@ async function run(setupFunction) {
     shutdown("SIGTERM");
   });
 }
+function getDefaultWorkerOptions() {
+  return {
+    concurrency: 10,
+    pollInterval: 5,
+    claimTimeout: 60
+  };
+}
 export {
+  downloadExtension,
   run as default
 };

package/dist/sqlite.d.ts

@@ -3,10 +3,13 @@ import type { Queryable } from "@absurd-sqlite/sdk";
 import type { SQLiteRestBindParams } from "@absurd-sqlite/sdk";
 export declare class BunSqliteConnection implements Queryable {
     private readonly db;
+    private readonly maxRetries;
+    private readonly baseRetryDelayMs;
     constructor(db: Database);
     query<R extends object = Record<string, any>>(sql: string, params?: SQLiteRestBindParams): Promise<{
         rows: R[];
     }>;
     exec(sql: string, params?: SQLiteRestBindParams): Promise<void>;
+    private runWithRetry;
 }
 //# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAGV,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAElB,EAAE,EAAE,QAAQ;IAIlB,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChD,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC;IAenB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAStE"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAGV,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAM;gBAE3B,EAAE,EAAE,QAAQ;IAIlB,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChD,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC;IAiBnB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;YAWvD,YAAY;CAc3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absurd-sqlite/bun-worker",
-  "version": "0.2.1",
+  "version": "0.2.2-alpha.1",
   "description": "Bun worker utilities for Absurd-SQLite",
   "type": "module",
   "main": "dist/index.js",
@@ -38,8 +38,9 @@
   },
   "homepage": "https://github.com/b4fun/absurd-sqlite#readme",
   "dependencies": {
-    "@absurd-sqlite/sdk": "~0.2.0",
-    "absurd-sdk": "~0.0.7"
+    "@absurd-sqlite/sdk": "next",
+    "absurd-sdk": "~0.0.7",
+    "cac": "^6.7.14"
   },
   "devDependencies": {
     "bun-types": "^1.3.5",
@@ -48,4 +49,4 @@
   "engines": {
     "bun": ">=1.1.0"
   }
-}
+}

package/src/index.ts

@@ -1,32 +1,103 @@
-import { Absurd } from "absurd-sdk";
+import { Absurd, type WorkerOptions } from "absurd-sdk";
 import { Database } from "bun:sqlite";
 import type { AbsurdClient } from "@absurd-sqlite/sdk";
+import { cac } from "cac";
 
 import { BunSqliteConnection } from "./sqlite";
 
 export type { AbsurdClient } from "@absurd-sqlite/sdk";
+export type { WorkerOptions } from "absurd-sdk";
+
+export {
+  downloadExtension,
+  type DownloadExtensionOptions,
+} from "@absurd-sqlite/sdk";
 
 /**
  * Register tasks and perform any one-time setup before the worker starts.
  */
 export type SetupFunction = (absurd: AbsurdClient) => void | Promise<void>;
 
+/**
+ * Parsed CLI options.
+ */
+interface ParsedOptions {
+  dbPath?: string;
+  extensionPath?: string;
+  concurrency?: number;
+}
+
+/**
+ * Parses CLI arguments and returns parsed options.
+ */
+function parseCliOptions(): ParsedOptions {
+  const cli = cac("bun-worker");
+
+  cli
+    .option(
+      "-c, --concurrency <number>",
+      "Number of tasks to process concurrently",
+      {
+        default: 10,
+      }
+    )
+    .option("--database-path <path>", "SQLite database file path")
+    .option("--extension-path <path>", "Absurd-SQLite extension path")
+    .help();
+
+  const parsed = cli.parse(process.argv, { run: false });
+
+  // If help was requested, cac will output it and we should exit gracefully
+  if (parsed.options.help) {
+    process.exit(0);
+  }
+
+  const options: ParsedOptions = {};
+
+  if (parsed.options.databasePath) {
+    options.dbPath = parsed.options.databasePath;
+  }
+  if (parsed.options.extensionPath) {
+    options.extensionPath = parsed.options.extensionPath;
+  }
+  if (parsed.options.concurrency) {
+    const value = parseInt(parsed.options.concurrency, 10);
+    if (!isNaN(value) && value > 0) {
+      options.concurrency = value;
+    } else {
+      console.warn(
+        `Invalid value for --concurrency: "${parsed.options.concurrency}" (must be a positive integer)`
+      );
+    }
+  }
+
+  return options;
+}
+
 /**
  * Boots a worker using Bun's SQLite driver and Absurd's task engine.
  *
- * Requires:
- * - ABSURD_DATABASE_PATH: SQLite database file path.
- * - ABSURD_DATABASE_EXTENSION_PATH: Absurd-SQLite extension path (libabsurd.*).
+ * CLI flags:
+ * - --concurrency, -c: Number of tasks to process concurrently (default: 10)
+ * - --database-path: SQLite database file path (overrides ABSURD_DATABASE_PATH)
+ * - --extension-path: Absurd-SQLite extension path (overrides ABSURD_DATABASE_EXTENSION_PATH)
  */
 export default async function run(setupFunction: SetupFunction): Promise<void> {
-  const dbPath = process.env.ABSURD_DATABASE_PATH;
-  const extensionPath = process.env.ABSURD_DATABASE_EXTENSION_PATH;
+  const cliOptions = parseCliOptions();
+
+  const dbPath = cliOptions.dbPath || process.env.ABSURD_DATABASE_PATH;
+  const extensionPath =
+    cliOptions.extensionPath || process.env.ABSURD_DATABASE_EXTENSION_PATH;
 
   if (!dbPath) {
-    throw new Error("ABSURD_DATABASE_PATH is required");
+    throw new Error(
+      "Database path is required. Set ABSURD_DATABASE_PATH environment variable or use --database-path flag."
+    );
   }
   if (!extensionPath) {
-    throw new Error("ABSURD_DATABASE_EXTENSION_PATH is required");
+    throw new Error(
+      "Extension path is required. Set ABSURD_DATABASE_EXTENSION_PATH environment variable or use --extension-path flag."
+    );
   }
 
   const db = new Database(dbPath);
@@ -38,7 +109,18 @@ export default async function run(setupFunction: SetupFunction): Promise<void> {
   const absurd = new Absurd({ db: conn });
 
   await setupFunction(absurd);
-  const worker = await absurd.startWorker();
+
+  // Merge worker options from multiple sources:
+  // 1. Default options
+  // 2. CLI flags
+  const workerOptions: WorkerOptions = {
+    ...getDefaultWorkerOptions(),
+    ...(cliOptions.concurrency !== undefined
+      ? { concurrency: cliOptions.concurrency }
+      : {}),
+  };
+
+  const worker = await absurd.startWorker(workerOptions);
 
   let shuttingDown = false;
   const shutdown = async (signal: string) => {
@@ -62,3 +144,14 @@ export default async function run(setupFunction: SetupFunction): Promise<void> {
     void shutdown("SIGTERM");
   });
 }
+
+/**
+ * Returns default worker options.
+ */
+function getDefaultWorkerOptions(): WorkerOptions {
+  return {
+    concurrency: 10,
+    pollInterval: 5,
+    claimTimeout: 60,
+  };
+}

package/src/sqlite.ts

@@ -9,6 +9,8 @@ import type {
 
 export class BunSqliteConnection implements Queryable {
   private readonly db: Database;
+  private readonly maxRetries = 5;
+  private readonly baseRetryDelayMs = 50;
 
   constructor(db: Database) {
     this.db = db;
@@ -25,8 +27,10 @@ export class BunSqliteConnection implements Queryable {
     );
 
     const statement = this.db.query(sqliteQuery);
-    const rows = statement.all(...sqliteParams).map((row) =>
-      decodeRowValues(row as Record<string, unknown>)
+    const rows = await this.runWithRetry(() =>
+      statement.all(...sqliteParams).map((row) =>
+        decodeRowValues(row as Record<string, unknown>)
+      )
     );
 
     return { rows: rows as R[] };
@@ -39,7 +43,23 @@ export class BunSqliteConnection implements Queryable {
       paramOrder
     );
 
-    this.db.query(sqliteQuery).run(...sqliteParams);
+    const statement = this.db.query(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);
+      }
+    }
   }
 }
 
@@ -167,3 +187,32 @@ function isBindParams(value: unknown): value is SQLiteBindParams {
   const tag = Object.prototype.toString.call(value);
   return tag === "[object Object]";
 }
+
+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/cli.test.ts

@@ -0,0 +1,83 @@
+import { describe, it, expect, beforeEach, afterEach } from "bun:test";
+import { mkdtempSync, rmSync, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { Database } from "bun:sqlite";
+import { fileURLToPath } from "node:url";
+
+const testDir = fileURLToPath(new URL(".", import.meta.url));
+const repoRoot = join(testDir, "../../..");
+const extensionBase = join(repoRoot, "target/release/libabsurd");
+
+function resolveExtensionPath(base: string): string {
+  const platformExt =
+    process.platform === "win32"
+      ? ".dll"
+      : process.platform === "darwin"
+      ? ".dylib"
+      : ".so";
+  const candidates = [base, `${base}${platformExt}`];
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  throw new Error(
+    `SQLite extension not found at ${base} (expected ${platformExt})`
+  );
+}
+
+const extensionPath = resolveExtensionPath(extensionBase);
+
+describe("Worker configuration", () => {
+  let tempDir: string;
+  let dbPath: string;
+
+  beforeEach(() => {
+    tempDir = mkdtempSync(join(tmpdir(), "absurd-cli-test-"));
+    dbPath = join(tempDir, "test.db");
+
+    // Initialize database with migrations
+    const db = new Database(dbPath);
+    (db as unknown as { loadExtension(path: string): void }).loadExtension(
+      extensionPath
+    );
+    db.query("select absurd_apply_migrations()").get();
+    db.close();
+
+    process.env.ABSURD_DATABASE_PATH = dbPath;
+    process.env.ABSURD_DATABASE_EXTENSION_PATH = extensionPath;
+  });
+
+  afterEach(() => {
+    if (tempDir) {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+    delete process.env.ABSURD_DATABASE_PATH;
+    delete process.env.ABSURD_DATABASE_EXTENSION_PATH;
+  });
+
+  it("works with default options when none provided", async () => {
+    const { default: run } = await import("../src/index");
+
+    let workerStarted = false;
+
+    const promise = run(async (absurd) => {
+      await absurd.createQueue("default");
+      absurd.registerTask({ name: "test" }, async () => {
+        return { ok: true };
+      });
+      workerStarted = true;
+    });
+
+    // Give the worker time to start
+    await new Promise((resolve) => setTimeout(resolve, 100));
+
+    expect(workerStarted).toBe(true);
+
+    // Clean up by sending SIGINT
+    process.emit("SIGINT");
+    await new Promise((resolve) => setTimeout(resolve, 100));
+  });
+});
+

package/test/run.test.ts

@@ -62,7 +62,7 @@ describe("run", () => {
     const { default: run } = await import("../src/index");
 
     await expect(run(() => {})).rejects.toThrow(
-      "ABSURD_DATABASE_PATH is required"
+      "Database path is required"
     );
   });
 
@@ -71,7 +71,7 @@ describe("run", () => {
     const { default: run } = await import("../src/index");
 
     await expect(run(() => {})).rejects.toThrow(
-      "ABSURD_DATABASE_EXTENSION_PATH is required"
+      "Extension path is required"
     );
   });
 

package/test/sqlite.test.ts

@@ -1,5 +1,8 @@
 import { Database } from "bun:sqlite";
-import { describe, expect, it } from "bun:test";
+import { describe, expect, it, jest } from "bun:test";
+import { mkdtempSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
 
 import { BunSqliteConnection } from "../src/sqlite";
 
@@ -86,4 +89,71 @@ describe("BunSqliteConnection", () => {
     expect(rows[0]?.created_at.getTime()).toBe(now);
     db.close();
   });
+
+  it("retries when SQLite reports the database is busy", async () => {
+    const tempDir = mkdtempSync(join(tmpdir(), "absurd-sqlite-busy-"));
+    const dbPath = join(tempDir, "busy.db");
+    const primary = new Database(dbPath);
+    primary.run("PRAGMA busy_timeout = 1");
+    const conn = new BunSqliteConnection(primary);
+    await conn.exec("CREATE TABLE t_busy (id INTEGER PRIMARY KEY, value TEXT)");
+
+    const blocker = new Database(dbPath);
+    blocker.run("PRAGMA busy_timeout = 1");
+    blocker.run("BEGIN EXCLUSIVE");
+
+    let released = false;
+    const releaseLock = () => {
+      if (released) return;
+      released = true;
+      try {
+        blocker.run("COMMIT");
+      } catch {
+        // ignore if already closed
+      }
+      blocker.close();
+    };
+    const timer = setTimeout(releaseLock, 20);
+
+    try {
+      await conn.exec("INSERT INTO t_busy (value) VALUES ($1)", ["alpha"]);
+      const { rows } = await conn.query<{ value: string }>(
+        "SELECT value FROM t_busy"
+      );
+      expect(rows[0]?.value).toBe("alpha");
+    } finally {
+      clearTimeout(timer);
+      releaseLock();
+      primary.close();
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  it("retries on locked error codes from SQLite", async () => {
+    const lockedError = new Error("SQLITE_LOCKED: mock lock") as any;
+    lockedError.code = "SQLITE_LOCKED_SHAREDCACHE";
+    lockedError.errno = 6;
+
+    let attempts = 0;
+    const statement = {
+      all: jest.fn(),
+      run: jest.fn(() => {
+        attempts++;
+        if (attempts === 1) {
+          throw lockedError;
+        }
+        return 1;
+      }),
+    };
+
+    const querySpy = jest.fn().mockReturnValue(statement as any);
+    const db = { query: querySpy } as unknown as Database;
+    const conn = new BunSqliteConnection(db);
+
+    await expect(
+      conn.exec("UPDATE locked_table SET value = $1 WHERE id = $2", [1, 1])
+    ).resolves.toBeUndefined();
+    expect(statement.run).toHaveBeenCalledTimes(2);
+    expect(querySpy).toHaveBeenCalledTimes(1);
+  });
 });