@effect-native/libcrsql 0.16.301 → 4.0.0

package/README.md

@@ -3,39 +3,99 @@
 Absolute paths to the cr-sqlite extension binaries for common desktop/server platforms, plus an optional Effect entrypoint.
 
 Supported platforms (verified on release):
+
 - macOS: darwin-aarch64, darwin-x86_64
 - Linux: linux-aarch64, linux-x86_64
 - Windows: win-x86_64, win-i686
 
 ## Install
 
-pnpm add @effect-native/libcrsql
+```sh
+bun add @effect-native/libcrsql
+```
 
 ## Usage (no Effect)
 
+```ts
+import { getCrSqliteExtensionPathSync, pathToCrSqliteExtension } from "@effect-native/libcrsql"
 import Database from "better-sqlite3"
-import { pathToCrSqliteExtension, getCrSqliteExtensionPathSync } from "@effect-native/libcrsql"
 
 const db = new Database(":memory:")
 db.loadExtension(pathToCrSqliteExtension)
 // or explicit
 // db.loadExtension(getCrSqliteExtensionPathSync("linux-x86_64"))
+```
+
+## Using with @effect/sql-sqlite-node
+
+Use the Node Sqlite client from Effect and load the CR‑SQLite extension before running queries.
+
+Simple usage (Effect):
+
+```ts
+import { getCrSqliteExtensionPath } from "@effect-native/libcrsql/effect"
+import { SqliteClient } from "@effect/sql-sqlite-node"
+import { Effect, Layer } from "effect"
+
+const SqliteBase = SqliteClient.layer({ filename: ":memory:" })
+
+const program = Effect.gen(function*() {
+  const client = yield* SqliteClient.SqliteClient
+  const ext = yield* getCrSqliteExtensionPath
+  yield* client.loadExtension(ext)
+  const rows = yield* client`SELECT hex(crsql_site_id()) AS site_id`
+  console.log(rows[0].site_id)
+}).pipe(Effect.provide(SqliteBase))
+```
+
+Idiomatic Layer composition for tests:
+
+```ts
+import { getCrSqliteExtensionPath } from "@effect-native/libcrsql/effect"
+import { SqliteClient } from "@effect/sql-sqlite-node"
+import { Effect, Layer } from "effect"
+
+const SqliteBase = SqliteClient.layer({ filename: ":memory:" })
+
+export const SqliteWithCr = Layer.effect(
+  SqliteClient.SqliteClient,
+  Effect.gen(function*() {
+    const client = yield* SqliteClient.SqliteClient
+    const ext = yield* getCrSqliteExtensionPath
+    yield* client.loadExtension(ext)
+    return client
+  })
+).pipe(Layer.provide(SqliteBase))
+
+// Use in tests
+// it.scoped("works", () => Effect.provide(SqliteWithCr)(...))
+```
+
+Notes:
+
+- better‑sqlite3 compiles with SQLite built in; you do not need @effect‑native/libsqlite for Node.
+- If you need to control the SQLite binary (e.g. Bun), use @effect‑native/libsqlite and its `Database.setCustomSQLite` APIs.
 
 ## Absolute constants (no side effects)
 
+```ts
 import { linux_x86_64 } from "@effect-native/libcrsql/paths"
-// linux_x86_64 is an absolute string like 
+// linux_x86_64 is an absolute string like
 // /.../node_modules/@effect-native/libcrsql/lib/linux-x86_64/libcrsqlite.so
+```
 
 ## Effect entrypoint (optional)
 
-import { Effect } from "effect"
+```ts
 import { getCrSqliteExtensionPath } from "@effect-native/libcrsql/effect"
+import { Effect } from "effect"
 
 const program = getCrSqliteExtensionPath()
 Effect.runPromise(program)
+```
 
 ## Notes
+
 - No network or postinstall scripts. Binaries are bundled in `lib/`.
 - Android and iOS are out of scope for this release.
 - Root and paths entrypoints have zero external runtime dependencies.
@@ -56,10 +116,109 @@ console.log(CRSQLITE_VERSION) // "0.16.3"
 ## Performance Note
 
 The module uses a synchronous file existence check (`fs.accessSync`) to ensure the returned path points to a real binary. This runs once per import/use and is acceptable for this package’s contract. If needed, this can be revisited later with memoization.
+
 ## Binary Integrity
 
 Run a local integrity check to verify bundled binaries match the expected SHA256:
 
+```sh
+bun --filter @effect-native/libcrsql run verify
+```
+
+---
+
+# Examples
+
+## nodejs + better-sqlite3
+
+```ts
+import { pathToCrSqliteExtension } from "@effect-native/libcrsql"
+import Database from "better-sqlite3"
+
+const db = new Database(":memory:")
+db.loadExtension(pathToCrSqliteExtension)
+
+console.log("LibSqlite loaded successfully?", db.prepare("SELECT sqlite_version() AS sqlite_version").get())
+
+console.log("CR-SQLite extension loaded successfully")
+console.log("Site ID:", db.prepare("SELECT hex(crsql_site_id()) as site_id").get())
 ```
-pnpm --filter @effect-native/libcrsql run verify
+
+## bun build --compile
+
+Embed libsqlite and crsqlite extension in a compiled Bun single file executable.
+
+```ts
+/* eslint-disable @typescript-eslint/no-require-imports */
+
+import { Database } from "bun:sqlite"
+
+import { getCrSqliteExtensionPathSync } from "@effect-native/libcrsql" with { type: "macro" }
+import { getLibSqlitePathSync } from "@effect-native/libsqlite" with { type: "macro" }
+
+const embeddedLibSqlitePath = String(require(getLibSqlitePathSync()))
+const embeddedCrSqliteExtensionPath = String(require(getCrSqliteExtensionPathSync()))
+
+if (Bun.embeddedFiles.length) {
+  const embeddedLibSqliteFile = Bun.file(embeddedLibSqlitePath)
+  const exportedLibSqlitePath = `./.${embeddedLibSqliteFile.name}`
+  Bun.write(exportedLibSqlitePath, embeddedLibSqliteFile)
+  Database.setCustomSQLite(exportedLibSqlitePath)
+} else {
+  Database.setCustomSQLite(embeddedLibSqlitePath)
+}
+
+const db = new Database(":memory:")
+console.log("LibSqlite loaded successfully?", db.query("SELECT sqlite_version() AS sqlite_version").get())
+db.loadExtension(embeddedCrSqliteExtensionPath, "sqlite3_crsqlite_init")
+
+try {
+} catch (cause) {
+  if (!String(cause).includes("no such file")) throw cause
+  const embeddedCrSqliteExtensionFile = Bun.file(embeddedCrSqliteExtensionPath)
+  const exportedCrSqliteExtensionPath = `./.${embeddedCrSqliteExtensionFile.name}`
+  Bun.write(exportedCrSqliteExtensionPath, embeddedCrSqliteExtensionFile)
+  db.loadExtension(exportedCrSqliteExtensionPath, "sqlite3_crsqlite_init")
+}
+
+console.log("CRSQLite extension loaded successfully?", db.query("SELECT hex(crsql_site_id()) AS siteId").get())
+```
+
+## bun build --compile
+
+Embed libsqlite and crsqlite extension in a compiled Bun single file executable.
+
+```ts
+/* eslint-disable @typescript-eslint/no-require-imports */
+import { Database } from "bun:sqlite"
+
+import { getCrSqliteExtensionPathSync } from "@effect-native/libcrsql" with { type: "macro" }
+import { getLibSqlitePathSync } from "@effect-native/libsqlite" with { type: "macro" }
+
+const embeddedLibSqlitePath = String(require(getLibSqlitePathSync()))
+const embeddedCrSqliteExtensionPath = String(require(getCrSqliteExtensionPathSync()))
+
+if (Bun.embeddedFiles.length) {
+  const embeddedLibSqliteFile = Bun.file(embeddedLibSqlitePath)
+  const exportedLibSqlitePath = `./.${embeddedLibSqliteFile.name}`
+  Bun.write(exportedLibSqlitePath, embeddedLibSqliteFile)
+  Database.setCustomSQLite(exportedLibSqlitePath)
+} else {
+  Database.setCustomSQLite(embeddedLibSqlitePath)
+}
+
+const db = new Database(":memory:")
+console.log("LibSqlite loaded successfully?", db.query("SELECT sqlite_version() AS sqliteVersion").get())
+
+try {
+  db.loadExtension(embeddedCrSqliteExtensionPath, "sqlite3_crsqlite_init")
+} catch (cause) {
+  if (!String(cause).includes("no such file")) throw cause
+  const embeddedCrSqliteExtensionFile = Bun.file(embeddedCrSqliteExtensionPath)
+  const exportedCrSqliteExtensionPath = `./.${embeddedCrSqliteExtensionFile.name}`
+  Bun.write(exportedCrSqliteExtensionPath, embeddedCrSqliteExtensionFile)
+  db.loadExtension(exportedCrSqliteExtensionPath, "sqlite3_crsqlite_init")
+}
+
+console.log("CRSQLite extension loaded successfully?", db.query("SELECT hex(crsql_site_id()) AS siteId").get())
 ```

package/dist/cjs/effect.js

@@ -0,0 +1,92 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getCrSqliteExtensionPath = exports.SUPPORTED_PLATFORMS = exports.PlatformNotSupportedError = exports.ExtensionPath = exports.ExtensionNotFoundError = void 0;
+var _effect = require("effect");
+var fs = _interopRequireWildcard(require("node:fs"));
+var _nodeUrl = require("node:url");
+var _platform = require("./platform.js");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * Effect entrypoint: idiomatic Effect API with TaggedError failures.
+ *
+ * @since 0.16.300
+ */
+
+/**
+ * Error indicating that a platform-arch combination is not supported.
+ * @since 0.16.300
+ */
+class PlatformNotSupportedError extends /*#__PURE__*/_effect.Data.TaggedError("PlatformNotSupportedError") {
+  /**
+   * @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
+ */
+exports.PlatformNotSupportedError = PlatformNotSupportedError;
+class ExtensionNotFoundError extends /*#__PURE__*/_effect.Data.TaggedError("ExtensionNotFoundError") {}
+/**
+ * Brand constructor for `ExtensionPath`.
+ * @since 0.16.300
+ */
+exports.ExtensionNotFoundError = ExtensionNotFoundError;
+const ExtensionPath = exports.ExtensionPath = /*#__PURE__*/_effect.Brand.nominal();
+// 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)
+ */
+const getCrSqliteExtensionPath = platform => _effect.Effect.gen(function* () {
+  const target = platform ?? (0, _platform.detectPlatform)();
+  if (!(0, _platform.isSupportedPlatform)(target)) {
+    return yield* _effect.Effect.fail(new PlatformNotSupportedError({
+      platform: target,
+      supportedPlatforms: SUPPORTED_PLATFORMS,
+      detectedArch: process.arch,
+      detectedPlatform: process.platform
+    }));
+  }
+  const abs = (0, _nodeUrl.fileURLToPath)(new URL(`../${(0, _platform.buildRelativeLibraryPath)(target)}`, import.meta.url));
+  const exists = yield* _effect.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.Effect.fail(new ExtensionNotFoundError({
+      path: abs,
+      platform: target
+    }));
+  }
+  return ExtensionPath(abs);
+});
+/**
+ * List of supported platforms.
+ * @since 0.16.300
+ */
+exports.getCrSqliteExtensionPath = getCrSqliteExtensionPath;
+const SUPPORTED_PLATFORMS = exports.SUPPORTED_PLATFORMS = _platform.SUPPORTED_PLATFORMS;
+//# sourceMappingURL=effect.js.map

package/dist/cjs/effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.js","names":["_effect","require","fs","_interopRequireWildcard","_nodeUrl","_platform","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","PlatformNotSupportedError","Data","TaggedError","message","platform","detectedPlatform","detectedArch","supportedPlatforms","join","exports","ExtensionNotFoundError","ExtensionPath","Brand","nominal","getCrSqliteExtensionPath","Effect","gen","target","detectPlatform","isSupportedPlatform","fail","SUPPORTED_PLATFORMS","process","arch","abs","fileURLToPath","URL","buildRelativeLibraryPath","import","meta","url","exists","sync","accessSync","path","_SUPPORTED_PLATFORMS"],"sources":["../../src/effect.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dts/effect.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Effect entrypoint: idiomatic Effect API with TaggedError failures.
+ *
+ * @since 0.16.300
+ */
+import { Brand, Effect } from "effect";
+import type { Platform as _Platform } from "./platform.js";
+declare const PlatformNotSupportedError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").MatchRecord<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }, void, { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "PlatformNotSupportedError";
+} & Readonly<A>;
+/**
+ * Error indicating that a platform-arch combination is not supported.
+ * @since 0.16.300
+ */
+export declare class PlatformNotSupportedError extends PlatformNotSupportedError_base<{
+    readonly platform: string;
+    readonly supportedPlatforms: ReadonlyArray<string>;
+    readonly detectedArch: string;
+    readonly detectedPlatform: string;
+}> {
+    /**
+     * @since 0.16.300
+     */
+    get message(): string;
+}
+declare const ExtensionNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").MatchRecord<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }, void, { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ExtensionNotFoundError";
+} & Readonly<A>;
+/**
+ * Error indicating that the resolved binary path does not exist.
+ * @since 0.16.300
+ */
+export declare class ExtensionNotFoundError extends ExtensionNotFoundError_base<{
+    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 declare const ExtensionPath: Brand.Constructor<ExtensionPath>;
+/**
+ * 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 declare const getCrSqliteExtensionPath: (platform?: Platform) => Effect.Effect<ExtensionPath, PlatformNotSupportedError | ExtensionNotFoundError>;
+/**
+ * Supported platform-arch identifiers.
+ * @since 0.16.300
+ */
+export type Platform = _Platform;
+/**
+ * List of supported platforms.
+ * @since 0.16.300
+ */
+export declare const SUPPORTED_PLATFORMS: readonly _Platform[];
+export {};
+//# sourceMappingURL=effect.d.ts.map

package/dist/dts/effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../../src/effect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAA;AAS5C,OAAO,KAAK,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,eAAe,CAAA;;;;AAE1D;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,+BAA8C;IAC3F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC,CAAC;IACA;;OAEG;IACH,IAAa,OAAO,WAInB;CACF;;;;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,4BAA2C;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAC;CAAG;AAEL;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;AACjE;;;GAGG;AACH,eAAO,MAAM,aAAa,kCAAiC,CAAA;AAG3D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,GACnC,WAAW,QAAQ,KAClB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,yBAAyB,GAAG,sBAAsB,CA+B9E,CAAA;AAEJ;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAA;AAEhC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,sBAAuB,CAAA"}

package/dist/esm/effect.js

@@ -0,0 +1,81 @@
+/**
+ * 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";
+/**
+ * Error indicating that a platform-arch combination is not supported.
+ * @since 0.16.300
+ */
+export class PlatformNotSupportedError extends /*#__PURE__*/Data.TaggedError("PlatformNotSupportedError") {
+  /**
+   * @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 /*#__PURE__*/Data.TaggedError("ExtensionNotFoundError") {}
+/**
+ * Brand constructor for `ExtensionPath`.
+ * @since 0.16.300
+ */
+export const ExtensionPath = /*#__PURE__*/Brand.nominal();
+// 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 => 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);
+});
+/**
+ * List of supported platforms.
+ * @since 0.16.300
+ */
+export const SUPPORTED_PLATFORMS = _SUPPORTED_PLATFORMS;
+//# sourceMappingURL=effect.js.map

package/dist/esm/effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.js","names":["Brand","Data","Effect","fs","fileURLToPath","buildRelativeLibraryPath","detectPlatform","isSupportedPlatform","SUPPORTED_PLATFORMS","_SUPPORTED_PLATFORMS","PlatformNotSupportedError","TaggedError","message","platform","detectedPlatform","detectedArch","supportedPlatforms","join","ExtensionNotFoundError","ExtensionPath","nominal","getCrSqliteExtensionPath","gen","target","fail","process","arch","abs","URL","import","meta","url","exists","sync","accessSync","path"],"sources":["../../src/effect.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;AAKA,SAASA,KAAK,EAAEC,IAAI,EAAEC,MAAM,QAAQ,QAAQ;AAC5C,OAAO,KAAKC,EAAE,MAAM,SAAS;AAC7B,SAASC,aAAa,QAAQ,UAAU;AACxC,SACEC,wBAAwB,EACxBC,cAAc,EACdC,mBAAmB,EACnBC,mBAAmB,IAAIC,oBAAoB,QACtC,eAAe;AAGtB;;;;AAIA,OAAM,MAAOC,yBAA0B,sBAAQT,IAAI,CAACU,WAAW,CAAC,2BAA2B,CAKzF;EACA;;;EAGA,IAAaC,OAAOA,CAAA;IAClB,OAAO,aAAa,IAAI,CAACC,QAAQ,iCAAiC,IAAI,CAACC,gBAAgB,IAAI,IAAI,CAACC,YAAY,gBAC1G,IAAI,CAACC,kBAAkB,CAACC,IAAI,CAAC,IAAI,CACnC,EAAE;EACJ;;AAGF;;;;AAIA,OAAM,MAAOC,sBAAuB,sBAAQjB,IAAI,CAACU,WAAW,CAAC,wBAAwB,CAGnF;AAOF;;;;AAIA,OAAO,MAAMQ,aAAa,gBAAGnB,KAAK,CAACoB,OAAO,EAAiB;AAE3D;AACA;;;;;;;;;;;;;;AAcA,OAAO,MAAMC,wBAAwB,GACnCR,QAAmB,IAEnBX,MAAM,CAACoB,GAAG,CAAC,aAAS;EAClB,MAAMC,MAAM,GAAGV,QAAQ,IAAIP,cAAc,EAAE;EAC3C,IAAI,CAACC,mBAAmB,CAACgB,MAAM,CAAC,EAAE;IAChC,OAAO,OAAOrB,MAAM,CAACsB,IAAI,CACvB,IAAId,yBAAyB,CAAC;MAC5BG,QAAQ,EAAEU,MAAM;MAChBP,kBAAkB,EAAER,mBAAmB;MACvCO,YAAY,EAAEU,OAAO,CAACC,IAAI;MAC1BZ,gBAAgB,EAAEW,OAAO,CAACZ;KAC3B,CAAC,CACH;EACH;EACA,MAAMc,GAAG,GAAGvB,aAAa,CAAC,IAAIwB,GAAG,CAAC,MAAMvB,wBAAwB,CAACkB,MAAM,CAAC,EAAE,EAAEM,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC;EAE7F,MAAMC,MAAM,GAAG,OAAO9B,MAAM,CAAC+B,IAAI,CAAC,MAAK;IACrC,IAAI;MACF;MACA;MACA9B,EAAE,CAAC+B,UAAU,CAACP,GAAG,CAAC;MAClB,OAAO,IAAI;IACb,CAAC,CAAC,MAAM;MACN,OAAO,KAAK;IACd;EACF,CAAC,CAAC;EAEF,IAAI,CAACK,MAAM,EAAE;IACX,OAAO,OAAO9B,MAAM,CAACsB,IAAI,CAAC,IAAIN,sBAAsB,CAAC;MAAEiB,IAAI,EAAER,GAAG;MAAEd,QAAQ,EAAEU;IAAM,CAAE,CAAC,CAAC;EACxF;EAEA,OAAOJ,aAAa,CAACQ,GAAG,CAAC;AAC3B,CAAC,CAAC;AAQJ;;;;AAIA,OAAO,MAAMnB,mBAAmB,GAAGC,oBAAoB","ignoreList":[]}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@effect-native/libcrsql",
-  "version": "0.16.301",
+  "version": "4.0.0",
   "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/effect-native.git",
-    "directory": "packages-native/libcrsql"
+    "directory": "packages/libcrsql"
   },
   "sideEffects": [
     "./dist/cjs/index.js",
@@ -18,15 +18,11 @@
   ],
   "homepage": "https://github.com/effect-native/effect-native",
   "peerDependencies": {
-    "effect": "*",
-    "@effect/platform": "*"
+    "effect": "^4.0.0-beta.0"
   },
   "peerDependenciesMeta": {
     "effect": {
       "optional": true
-    },
-    "@effect/platform": {
-      "optional": true
     }
   },
   "publishConfig": {

package/src/effect.ts

@@ -27,7 +27,7 @@ export class PlatformNotSupportedError extends Data.TaggedError("PlatformNotSupp
   /**
    * @since 0.16.300
    */
-  get message() {
+  override get message() {
     return `Platform "${this.platform}" is not supported. Detected: ${this.detectedPlatform}-${this.detectedArch}. Supported: ${
       this.supportedPlatforms.join(", ")
     }`