@effect-native/libcrsql 0.16.3-1 → 0.16.301

package/dist/esm/index.js

@@ -0,0 +1,68 @@
+/**
+ * Root entrypoint: absolute path getters with zero external dependencies.
+ *
+ * @since 0.16.300
+ */
+import * as fs from "node:fs";
+import { fileURLToPath } from "node:url";
+import { buildRelativeLibraryPath, detectPlatform, isSupportedPlatform, SUPPORTED_PLATFORMS as _SUPPORTED_PLATFORMS } from "./platform.js";
+import { CRSQLITE_VERSION as _CRSQLITE_VERSION } from "./version.js";
+/**
+ * Synchronous absolute path resolution for the cr-sqlite extension binary.
+ *
+ * - Returns an absolute path string that you can pass to `db.loadExtension()`.
+ * - Throws native Error with `code` set to `ERR_PLATFORM_UNSUPPORTED` or
+ *   `ERR_EXTENSION_NOT_FOUND`.
+ *
+ * @since 0.16.300
+ * @example
+ * import { getCrSqliteExtensionPathSync } from "@effect-native/libcrsql"
+ *
+ * const path = getCrSqliteExtensionPathSync()
+ * console.log(path)
+ */
+export const getCrSqliteExtensionPathSync = platform => {
+  const target = platform ?? detectPlatform();
+  if (!isSupportedPlatform(target)) {
+    const err = new Error(`Platform "${target}" is not supported. Detected: ${process.platform}-${process.arch}. Supported: ${SUPPORTED_PLATFORMS.join(", ")}`);
+    err.code = "ERR_PLATFORM_UNSUPPORTED";
+    throw err;
+  }
+  const abs = fileURLToPath(new URL(`../${buildRelativeLibraryPath(target)}`, import.meta.url));
+  // Best-effort existence check without external deps.
+  // Note: this synchronous check runs once per import/use and ensures the
+  // contract of this package (absolute path to an existing native binary).
+  // If needed, we can memoize this at runtime, but import memoization already
+  // avoids repeated work in typical usage.
+  try {
+    fs.accessSync(abs);
+  } catch {
+    const err = new Error(`Extension binary not found: ${abs}`);
+    err.code = "ERR_EXTENSION_NOT_FOUND";
+    throw err;
+  }
+  return abs;
+};
+/**
+ * Absolute path to the cr-sqlite binary for the current platform, computed at import time.
+ *
+ * - Useful for the simplest use cases: just import and load.
+ * - Throws on unsupported platform or if the binary is not present.
+ *
+ * @since 0.16.300
+ * @example
+ * import { pathToCrSqliteExtension } from "@effect-native/libcrsql"
+ * console.log(pathToCrSqliteExtension)
+ */
+export const pathToCrSqliteExtension = /*#__PURE__*/getCrSqliteExtensionPathSync();
+/**
+ * List of supported platforms.
+ * @since 0.16.300
+ */
+export const SUPPORTED_PLATFORMS = _SUPPORTED_PLATFORMS;
+/**
+ * Bundled upstream cr-sqlite version.
+ * @since 0.16.300
+ */
+export const CRSQLITE_VERSION = _CRSQLITE_VERSION;
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["fs","fileURLToPath","buildRelativeLibraryPath","detectPlatform","isSupportedPlatform","SUPPORTED_PLATFORMS","_SUPPORTED_PLATFORMS","CRSQLITE_VERSION","_CRSQLITE_VERSION","getCrSqliteExtensionPathSync","platform","target","err","Error","process","arch","join","code","abs","URL","import","meta","url","accessSync","pathToCrSqliteExtension"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,OAAO,KAAKA,EAAE,MAAM,SAAS;AAC7B,SAASC,aAAa,QAAQ,UAAU;AACxC,SACEC,wBAAwB,EACxBC,cAAc,EACdC,mBAAmB,EACnBC,mBAAmB,IAAIC,oBAAoB,QACtC,eAAe;AACtB,SAASC,gBAAgB,IAAIC,iBAAiB,QAAQ,cAAc;AAIpE;;;;;;;;;;;;;;AAcA,OAAO,MAAMC,4BAA4B,GAAIC,QAAmB,IAAY;EAC1E,MAAMC,MAAM,GAAGD,QAAQ,IAAIP,cAAc,EAAE;EAC3C,IAAI,CAACC,mBAAmB,CAACO,MAAM,CAAC,EAAE;IAChC,MAAMC,GAAG,GAA0B,IAAIC,KAAK,CAC1C,aAAaF,MAAM,iCAAiCG,OAAO,CAACJ,QAAQ,IAAII,OAAO,CAACC,IAAI,gBAClFV,mBAAmB,CAACW,IAAI,CAAC,IAAI,CAC/B,EAAE,CACH;IACDJ,GAAG,CAACK,IAAI,GAAG,0BAA0B;IACrC,MAAML,GAAG;EACX;EACA,MAAMM,GAAG,GAAGjB,aAAa,CAAC,IAAIkB,GAAG,CAAC,MAAMjB,wBAAwB,CAACS,MAAM,CAAC,EAAE,EAAES,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC;EAC7F;EACA;EACA;EACA;EACA;EACA,IAAI;IACFtB,EAAE,CAACuB,UAAU,CAACL,GAAG,CAAC;EACpB,CAAC,CAAC,MAAM;IACN,MAAMN,GAAG,GAA0B,IAAIC,KAAK,CAAC,+BAA+BK,GAAG,EAAE,CAAC;IAClFN,GAAG,CAACK,IAAI,GAAG,yBAAyB;IACpC,MAAML,GAAG;EACX;EACA,OAAOM,GAAG;AACZ,CAAC;AAED;;;;;;;;;;;AAWA,OAAO,MAAMM,uBAAuB,gBAAWf,4BAA4B,EAAE;AAQ7E;;;;AAIA,OAAO,MAAMJ,mBAAmB,GAAGC,oBAAoB;AACvD;;;;AAIA,OAAO,MAAMC,gBAAgB,GAAGC,iBAAiB","ignoreList":[]}

package/dist/esm/package.json

@@ -0,0 +1,8 @@
+{
+  "type": "module",
+  "sideEffects": [
+    "./index.js",
+    "./paths.js",
+    "./effect.js"
+  ]
+}

package/dist/esm/paths.js

@@ -0,0 +1,38 @@
+/**
+ * Absolute paths per-platform. These are computed from this module location
+ * using Node built-ins only (no external dependencies, no I/O).
+ *
+ * @since 0.16.300
+ */
+import { fileURLToPath } from "node:url";
+/**
+ * Absolute path to darwin-aarch64 cr-sqlite dylib.
+ * @since 0.16.300
+ */
+export const darwin_aarch64 = /*#__PURE__*/fileURLToPath(/*#__PURE__*/new URL("../lib/darwin-aarch64/libcrsqlite.dylib", import.meta.url));
+/**
+ * Absolute path to darwin-x86_64 cr-sqlite dylib.
+ * @since 0.16.300
+ */
+export const darwin_x86_64 = /*#__PURE__*/fileURLToPath(/*#__PURE__*/new URL("../lib/darwin-x86_64/libcrsqlite.dylib", import.meta.url));
+/**
+ * Absolute path to linux-aarch64 cr-sqlite so.
+ * @since 0.16.300
+ */
+export const linux_aarch64 = /*#__PURE__*/fileURLToPath(/*#__PURE__*/new URL("../lib/linux-aarch64/libcrsqlite.so", import.meta.url));
+/**
+ * Absolute path to linux-x86_64 cr-sqlite so.
+ * @since 0.16.300
+ */
+export const linux_x86_64 = /*#__PURE__*/fileURLToPath(/*#__PURE__*/new URL("../lib/linux-x86_64/libcrsqlite.so", import.meta.url));
+/**
+ * Absolute path to win-x86_64 cr-sqlite dll.
+ * @since 0.16.300
+ */
+export const win_x86_64 = /*#__PURE__*/fileURLToPath(/*#__PURE__*/new URL("../lib/win-x86_64/crsqlite.dll", import.meta.url));
+/**
+ * Absolute path to win-i686 cr-sqlite dll.
+ * @since 0.16.300
+ */
+export const win_i686 = /*#__PURE__*/fileURLToPath(/*#__PURE__*/new URL("../lib/win-i686/crsqlite.dll", import.meta.url));
+//# sourceMappingURL=paths.js.map

package/dist/esm/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","names":["fileURLToPath","darwin_aarch64","URL","import","meta","url","darwin_x86_64","linux_aarch64","linux_x86_64","win_x86_64","win_i686"],"sources":["../../src/paths.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;AAMA,SAASA,aAAa,QAAQ,UAAU;AAExC;;;;AAIA,OAAO,MAAMC,cAAc,gBAAGD,aAAa,cAAC,IAAIE,GAAG,CAAC,yCAAyC,EAAEC,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC;AAChH;;;;AAIA,OAAO,MAAMC,aAAa,gBAAGN,aAAa,cAAC,IAAIE,GAAG,CAAC,wCAAwC,EAAEC,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC;AAC9G;;;;AAIA,OAAO,MAAME,aAAa,gBAAGP,aAAa,cAAC,IAAIE,GAAG,CAAC,qCAAqC,EAAEC,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC;AAC3G;;;;AAIA,OAAO,MAAMG,YAAY,gBAAGR,aAAa,cAAC,IAAIE,GAAG,CAAC,oCAAoC,EAAEC,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC;AACzG;;;;AAIA,OAAO,MAAMI,UAAU,gBAAGT,aAAa,cAAC,IAAIE,GAAG,CAAC,gCAAgC,EAAEC,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC;AACnG;;;;AAIA,OAAO,MAAMK,QAAQ,gBAAGV,aAAa,cAAC,IAAIE,GAAG,CAAC,8BAA8B,EAAEC,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC","ignoreList":[]}

package/dist/esm/platform.js

@@ -0,0 +1,52 @@
+/**
+ * Platform detection and mapping utilities for @effect-native/libcrsql.
+ * @since 0.16.300
+ */
+// Platform detection and mapping
+/**
+ * List of supported platforms.
+ * @since 0.16.300
+ */
+export const SUPPORTED_PLATFORMS = ["darwin-aarch64", "darwin-x86_64", "linux-aarch64", "linux-x86_64", "win-x86_64", "win-i686"];
+/**
+ * True if the given string is a supported platform.
+ * @since 0.16.300
+ */
+export const isSupportedPlatform = p => SUPPORTED_PLATFORMS.includes(p);
+/**
+ * Detect current platform string.
+ * @since 0.16.300
+ */
+export const detectPlatform = () => {
+  const platform = process.platform;
+  const arch = process.arch;
+  // Map Node.js platform/arch to our strings
+  if (platform === "darwin" && arch === "arm64") return "darwin-aarch64";
+  if (platform === "darwin" && arch === "x64") return "darwin-x86_64";
+  if (platform === "linux" && arch === "arm64") return "linux-aarch64";
+  if (platform === "linux" && arch === "x64") return "linux-x86_64";
+  if (platform === "win32" && arch === "x64") return "win-x86_64";
+  if (platform === "win32" && arch === "ia32") return "win-i686";
+  return `${platform}-${arch}`;
+};
+/**
+ * Build relative path to the cr-sqlite binary within the package.
+ * @since 0.16.300
+ */
+export const buildRelativeLibraryPath = platform => {
+  switch (platform) {
+    case "darwin-aarch64":
+    case "darwin-x86_64":
+      return `lib/${platform}/libcrsqlite.dylib`;
+    case "linux-aarch64":
+    case "linux-x86_64":
+      return `lib/${platform}/libcrsqlite.so`;
+    case "win-x86_64":
+    case "win-i686":
+      return `lib/${platform}/crsqlite.dll`;
+  }
+  // Exhaustiveness note: if a new Platform variant is added, TypeScript will error
+  // unless it is handled above. This fallback exists only for type safety.
+  return platform;
+};
+//# sourceMappingURL=platform.js.map

package/dist/esm/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","names":["SUPPORTED_PLATFORMS","isSupportedPlatform","p","includes","detectPlatform","platform","process","arch","buildRelativeLibraryPath"],"sources":["../../src/platform.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;AAIA;AAcA;;;;AAIA,OAAO,MAAMA,mBAAmB,GAA4B,CAC1D,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,UAAU,CACF;AAEV;;;;AAIA,OAAO,MAAMC,mBAAmB,GAAIC,CAAS,IAC1CF,mBAA6C,CAACG,QAAQ,CAACD,CAAC,CAAC;AAE5D;;;;AAIA,OAAO,MAAME,cAAc,GAAGA,CAAA,KAAa;EACzC,MAAMC,QAAQ,GAAGC,OAAO,CAACD,QAAQ;EACjC,MAAME,IAAI,GAAGD,OAAO,CAACC,IAAI;EACzB;EACA,IAAIF,QAAQ,KAAK,QAAQ,IAAIE,IAAI,KAAK,OAAO,EAAE,OAAO,gBAAgB;EACtE,IAAIF,QAAQ,KAAK,QAAQ,IAAIE,IAAI,KAAK,KAAK,EAAE,OAAO,eAAe;EACnE,IAAIF,QAAQ,KAAK,OAAO,IAAIE,IAAI,KAAK,OAAO,EAAE,OAAO,eAAe;EACpE,IAAIF,QAAQ,KAAK,OAAO,IAAIE,IAAI,KAAK,KAAK,EAAE,OAAO,cAAc;EACjE,IAAIF,QAAQ,KAAK,OAAO,IAAIE,IAAI,KAAK,KAAK,EAAE,OAAO,YAAY;EAC/D,IAAIF,QAAQ,KAAK,OAAO,IAAIE,IAAI,KAAK,MAAM,EAAE,OAAO,UAAU;EAC9D,OAAO,GAAGF,QAAQ,IAAIE,IAAI,EAAE;AAC9B,CAAC;AAED;;;;AAIA,OAAO,MAAMC,wBAAwB,GAAIH,QAAkB,IAAY;EACrE,QAAQA,QAAQ;IACd,KAAK,gBAAgB;IACrB,KAAK,eAAe;MAClB,OAAO,OAAOA,QAAQ,oBAAoB;IAC5C,KAAK,eAAe;IACpB,KAAK,cAAc;MACjB,OAAO,OAAOA,QAAQ,iBAAiB;IACzC,KAAK,YAAY;IACjB,KAAK,UAAU;MACb,OAAO,OAAOA,QAAQ,eAAe;EACzC;EACA;EACA;EACA,OAAOA,QAAwB;AACjC,CAAC","ignoreList":[]}

package/dist/esm/version.js

@@ -0,0 +1,6 @@
+/**
+ * Underlying cr-sqlite release version bundled with this package.
+ * @since 0.16.300
+ */
+export const CRSQLITE_VERSION = "0.16.3";
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","names":["CRSQLITE_VERSION"],"sources":["../../src/version.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;AAIA,OAAO,MAAMA,gBAAgB,GAAG,QAAQ","ignoreList":[]}

package/effect/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": [],
+  "main": "../dist/cjs/effect.js",
+  "module": "../dist/esm/effect.js",
+  "types": "../dist/dts/effect.d.ts"
+}

package/package.json

@@ -1,70 +1,66 @@
 {
   "name": "@effect-native/libcrsql",
-  "version": "0.16.3-1",
-  "description": "Pure-Nix CR-SQLite extension (.dylib/.so) for conflict-free replicated databases",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "type": "module",
-  "exports": {
-    ".": {
-      "react-native": "./react-native.js",
-      "default": "./index.js"
-    },
-    "./react-native": {
-      "import": "./react-native.js",
-      "types": "./react-native.d.ts"
-    },
-    "./package.json": "./package.json"
-  },
-  "scripts": {},
-  "bin": {
-    "@effect-native/libcrsql": "./bin/libcrsql-extension-path.js",
-    "libcrsql-extension-path": "./bin/libcrsql-extension-path.js"
-  },
-  "files": [
-    "index.js",
-    "index.d.ts",
-    "react-native.js",
-    "react-native.d.ts",
-    "lib/",
-    "bin/",
-    "README.md"
-  ],
-  "keywords": [
-    "sqlite",
-    "sqlite3",
-    "cr-sqlite",
-    "crsqlite",
-    "crdt",
-    "conflict-free",
-    "replicated",
-    "extension",
-    "nix",
-    "dylib",
-    "shared-library"
-  ],
-  "author": "Tom Aylott",
+  "version": "0.16.301",
+  "description": "Absolute paths to cr-sqlite extension binaries for Node.js with optional Effect API",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/effect-native/cr-sqlite.git"
+    "url": "https://github.com/effect-native/effect-native.git",
+    "directory": "packages-native/libcrsql"
   },
-  "engines": {
-    "node": ">=16.0.0"
+  "sideEffects": [
+    "./dist/cjs/index.js",
+    "./dist/cjs/paths.js",
+    "./dist/cjs/effect.js",
+    "./dist/esm/index.js",
+    "./dist/esm/paths.js",
+    "./dist/esm/effect.js"
+  ],
+  "homepage": "https://github.com/effect-native/effect-native",
+  "peerDependencies": {
+    "effect": "*",
+    "@effect/platform": "*"
   },
-  "peerDependencies": {},
-  "dependencies": {},
-  "devDependencies": {
-    "@effect-native/libsqlite": "^3.50.2-1",
-    "@effect/platform": "^0.66.3",
-    "@effect/platform-bun": "^0.46.0",
-    "@types/bun": "latest",
-    "@types/node": "^22.0.0",
-    "effect": "^3.10.0",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.2"
+  "peerDependenciesMeta": {
+    "effect": {
+      "optional": true
+    },
+    "@effect/platform": {
+      "optional": true
+    }
   },
   "publishConfig": {
-    "access": "public"
+    "provenance": true
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/dts/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/dts/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/cjs/index.js"
+    },
+    "./paths": {
+      "types": "./dist/dts/paths.d.ts",
+      "import": "./dist/esm/paths.js",
+      "default": "./dist/cjs/paths.js"
+    },
+    "./effect": {
+      "types": "./dist/dts/effect.d.ts",
+      "import": "./dist/esm/effect.js",
+      "default": "./dist/cjs/effect.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "paths": [
+        "./dist/dts/paths.d.ts"
+      ],
+      "effect": [
+        "./dist/dts/effect.d.ts"
+      ]
+    }
   }
 }

package/paths/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": [],
+  "main": "../dist/cjs/paths.js",
+  "module": "../dist/esm/paths.js",
+  "types": "../dist/dts/paths.d.ts"
+}

package/src/browser-unsupported.ts

@@ -0,0 +1,9 @@
+/**
+ * Browser guard for @effect-native/libcrsql.
+ * This package is Node.js-only and provides paths to native binaries.
+ * @since 0.16.300
+ */
+// Importing in browser environments is not supported.
+
+const msg = "@effect-native/libcrsql is Node.js-only (native binaries). Browser is not supported."
+throw new Error(msg)

package/src/effect.ts

@@ -0,0 +1,117 @@
+/**
+ * Effect entrypoint: idiomatic Effect API with TaggedError failures.
+ *
+ * @since 0.16.300
+ */
+import { Brand, Data, Effect } from "effect"
+import * as fs from "node:fs"
+import { fileURLToPath } from "node:url"
+import {
+  buildRelativeLibraryPath,
+  detectPlatform,
+  isSupportedPlatform,
+  SUPPORTED_PLATFORMS as _SUPPORTED_PLATFORMS
+} from "./platform.js"
+import type { Platform as _Platform } from "./platform.js"
+
+/**
+ * Error indicating that a platform-arch combination is not supported.
+ * @since 0.16.300
+ */
+export class PlatformNotSupportedError extends Data.TaggedError("PlatformNotSupportedError")<{
+  readonly platform: string
+  readonly supportedPlatforms: ReadonlyArray<string>
+  readonly detectedArch: string
+  readonly detectedPlatform: string
+}> {
+  /**
+   * @since 0.16.300
+   */
+  get message() {
+    return `Platform "${this.platform}" is not supported. Detected: ${this.detectedPlatform}-${this.detectedArch}. Supported: ${
+      this.supportedPlatforms.join(", ")
+    }`
+  }
+}
+
+/**
+ * Error indicating that the resolved binary path does not exist.
+ * @since 0.16.300
+ */
+export class ExtensionNotFoundError extends Data.TaggedError("ExtensionNotFoundError")<{
+  readonly path: string
+  readonly platform: string
+}> {}
+
+/**
+ * Branded absolute path to the cr-sqlite binary.
+ * @since 0.16.300
+ */
+export type ExtensionPath = string & Brand.Brand<"ExtensionPath">
+/**
+ * Brand constructor for `ExtensionPath`.
+ * @since 0.16.300
+ */
+export const ExtensionPath = Brand.nominal<ExtensionPath>()
+
+// Uses a best-effort Node fs sync check without depending on @effect/platform.
+/**
+ * Effect-based absolute path resolution with idiomatic TaggedError failures.
+ *
+ * - Succeeds with a branded `ExtensionPath` string.
+ * - Fails with `PlatformNotSupportedError` or `ExtensionNotFoundError`.
+ *
+ * @since 0.16.300
+ * @example
+ * import { getCrSqliteExtensionPath } from "@effect-native/libcrsql/effect"
+ * import { Effect } from "effect"
+ *
+ * const program = getCrSqliteExtensionPath()
+ * Effect.runPromise(program)
+ */
+export const getCrSqliteExtensionPath = (
+  platform?: Platform
+): Effect.Effect<ExtensionPath, PlatformNotSupportedError | ExtensionNotFoundError> =>
+  Effect.gen(function*() {
+    const target = platform ?? detectPlatform()
+    if (!isSupportedPlatform(target)) {
+      return yield* Effect.fail(
+        new PlatformNotSupportedError({
+          platform: target,
+          supportedPlatforms: SUPPORTED_PLATFORMS,
+          detectedArch: process.arch,
+          detectedPlatform: process.platform
+        })
+      )
+    }
+    const abs = fileURLToPath(new URL(`../${buildRelativeLibraryPath(target)}`, import.meta.url))
+
+    const exists = yield* Effect.sync(() => {
+      try {
+        // Synchronous check is acceptable here since this path is computed
+        // infrequently and typically only once per process.
+        fs.accessSync(abs)
+        return true
+      } catch {
+        return false
+      }
+    })
+
+    if (!exists) {
+      return yield* Effect.fail(new ExtensionNotFoundError({ path: abs, platform: target }))
+    }
+
+    return ExtensionPath(abs)
+  })
+
+/**
+ * Supported platform-arch identifiers.
+ * @since 0.16.300
+ */
+export type Platform = _Platform
+
+/**
+ * List of supported platforms.
+ * @since 0.16.300
+ */
+export const SUPPORTED_PLATFORMS = _SUPPORTED_PLATFORMS

package/src/index.ts

@@ -0,0 +1,87 @@
+/**
+ * Root entrypoint: absolute path getters with zero external dependencies.
+ *
+ * @since 0.16.300
+ */
+import * as fs from "node:fs"
+import { fileURLToPath } from "node:url"
+import {
+  buildRelativeLibraryPath,
+  detectPlatform,
+  isSupportedPlatform,
+  SUPPORTED_PLATFORMS as _SUPPORTED_PLATFORMS
+} from "./platform.js"
+import { CRSQLITE_VERSION as _CRSQLITE_VERSION } from "./version.js"
+
+import type { Platform as _Platform } from "./platform.js"
+
+/**
+ * Synchronous absolute path resolution for the cr-sqlite extension binary.
+ *
+ * - Returns an absolute path string that you can pass to `db.loadExtension()`.
+ * - Throws native Error with `code` set to `ERR_PLATFORM_UNSUPPORTED` or
+ *   `ERR_EXTENSION_NOT_FOUND`.
+ *
+ * @since 0.16.300
+ * @example
+ * import { getCrSqliteExtensionPathSync } from "@effect-native/libcrsql"
+ *
+ * const path = getCrSqliteExtensionPathSync()
+ * console.log(path)
+ */
+export const getCrSqliteExtensionPathSync = (platform?: Platform): string => {
+  const target = platform ?? detectPlatform()
+  if (!isSupportedPlatform(target)) {
+    const err: NodeJS.ErrnoException = new Error(
+      `Platform "${target}" is not supported. Detected: ${process.platform}-${process.arch}. Supported: ${
+        SUPPORTED_PLATFORMS.join(", ")
+      }`
+    )
+    err.code = "ERR_PLATFORM_UNSUPPORTED"
+    throw err
+  }
+  const abs = fileURLToPath(new URL(`../${buildRelativeLibraryPath(target)}`, import.meta.url))
+  // Best-effort existence check without external deps.
+  // Note: this synchronous check runs once per import/use and ensures the
+  // contract of this package (absolute path to an existing native binary).
+  // If needed, we can memoize this at runtime, but import memoization already
+  // avoids repeated work in typical usage.
+  try {
+    fs.accessSync(abs)
+  } catch {
+    const err: NodeJS.ErrnoException = new Error(`Extension binary not found: ${abs}`)
+    err.code = "ERR_EXTENSION_NOT_FOUND"
+    throw err
+  }
+  return abs
+}
+
+/**
+ * Absolute path to the cr-sqlite binary for the current platform, computed at import time.
+ *
+ * - Useful for the simplest use cases: just import and load.
+ * - Throws on unsupported platform or if the binary is not present.
+ *
+ * @since 0.16.300
+ * @example
+ * import { pathToCrSqliteExtension } from "@effect-native/libcrsql"
+ * console.log(pathToCrSqliteExtension)
+ */
+export const pathToCrSqliteExtension: string = getCrSqliteExtensionPathSync()
+
+/**
+ * Supported platform-arch identifiers.
+ * @since 0.16.300
+ */
+export type Platform = _Platform
+
+/**
+ * List of supported platforms.
+ * @since 0.16.300
+ */
+export const SUPPORTED_PLATFORMS = _SUPPORTED_PLATFORMS
+/**
+ * Bundled upstream cr-sqlite version.
+ * @since 0.16.300
+ */
+export const CRSQLITE_VERSION = _CRSQLITE_VERSION

package/src/paths.ts

@@ -0,0 +1,47 @@
+/**
+ * Absolute paths per-platform. These are computed from this module location
+ * using Node built-ins only (no external dependencies, no I/O).
+ *
+ * @since 0.16.300
+ */
+import { fileURLToPath } from "node:url"
+
+/**
+ * Absolute path to darwin-aarch64 cr-sqlite dylib.
+ * @since 0.16.300
+ */
+export const darwin_aarch64 = fileURLToPath(new URL("../lib/darwin-aarch64/libcrsqlite.dylib", import.meta.url))
+/**
+ * Absolute path to darwin-x86_64 cr-sqlite dylib.
+ * @since 0.16.300
+ */
+export const darwin_x86_64 = fileURLToPath(new URL("../lib/darwin-x86_64/libcrsqlite.dylib", import.meta.url))
+/**
+ * Absolute path to linux-aarch64 cr-sqlite so.
+ * @since 0.16.300
+ */
+export const linux_aarch64 = fileURLToPath(new URL("../lib/linux-aarch64/libcrsqlite.so", import.meta.url))
+/**
+ * Absolute path to linux-x86_64 cr-sqlite so.
+ * @since 0.16.300
+ */
+export const linux_x86_64 = fileURLToPath(new URL("../lib/linux-x86_64/libcrsqlite.so", import.meta.url))
+/**
+ * Absolute path to win-x86_64 cr-sqlite dll.
+ * @since 0.16.300
+ */
+export const win_x86_64 = fileURLToPath(new URL("../lib/win-x86_64/crsqlite.dll", import.meta.url))
+/**
+ * Absolute path to win-i686 cr-sqlite dll.
+ * @since 0.16.300
+ */
+export const win_i686 = fileURLToPath(new URL("../lib/win-i686/crsqlite.dll", import.meta.url))
+
+/**
+ * Map of platform name to absolute path.
+ * @since 0.16.300
+ */
+export type Paths = {
+  readonly [K in "darwin_aarch64" | "darwin_x86_64" | "linux_aarch64" | "linux_x86_64" | "win_x86_64" | "win_i686"]:
+    string
+}