@effect-native/libcrsql 0.16.3-1 → 0.16.301

package/src/platform.ts

@@ -0,0 +1,75 @@
+/**
+ * Platform detection and mapping utilities for @effect-native/libcrsql.
+ * @since 0.16.300
+ */
+// Platform detection and mapping
+
+/**
+ * Supported platform-arch identifiers.
+ * @since 0.16.300
+ */
+export type Platform =
+  | "darwin-aarch64"
+  | "darwin-x86_64"
+  | "linux-aarch64"
+  | "linux-x86_64"
+  | "win-x86_64"
+  | "win-i686"
+
+/**
+ * List of supported platforms.
+ * @since 0.16.300
+ */
+export const SUPPORTED_PLATFORMS: ReadonlyArray<Platform> = [
+  "darwin-aarch64",
+  "darwin-x86_64",
+  "linux-aarch64",
+  "linux-x86_64",
+  "win-x86_64",
+  "win-i686"
+] as const
+
+/**
+ * True if the given string is a supported platform.
+ * @since 0.16.300
+ */
+export const isSupportedPlatform = (p: string): p is Platform =>
+  (SUPPORTED_PLATFORMS as ReadonlyArray<string>).includes(p)
+
+/**
+ * Detect current platform string.
+ * @since 0.16.300
+ */
+export const detectPlatform = (): string => {
+  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: Platform): string => {
+  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 satisfies never
+}

package/src/version.ts

@@ -0,0 +1,5 @@
+/**
+ * Underlying cr-sqlite release version bundled with this package.
+ * @since 0.16.300
+ */
+export const CRSQLITE_VERSION = "0.16.3"

package/bin/libcrsql-extension-path.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-
-import { pathToCRSQLiteExtension } from '../index.js';
-
-try {
-  console.log(pathToCRSQLiteExtension);
-} catch (error) {
-  console.error(error.message);
-  process.exit(1);
-}

package/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * Get the absolute path to the bundled CR-SQLite extension
- * @returns Absolute path to crsqlite.dylib/.so
- */
-export declare function getExtensionPath(): string;
-
-/**
- * Path to CR-SQLite extension - for use with db.loadExtension()
- */
-export declare const pathToCRSQLiteExtension: string;
-
-/**
- * Default export - same as pathToCRSQLiteExtension
- */
-declare const _default: string;
-export default _default;

package/index.js

@@ -1,67 +0,0 @@
-import { fileURLToPath } from 'node:url';
-import { dirname, resolve } from 'node:path';
-import { existsSync } from 'node:fs';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/**
- * Get the absolute path to the bundled CR-SQLite extension
- * Automatically detects platform and architecture
- * @returns {string} Absolute path to crsqlite.dylib/.so
- */
-export function getExtensionPath() {
-  // Browser check - prevent misuse in browsers
-  if (typeof window !== 'undefined') {
-    throw new Error(
-      '@effect-native/libcrsql is for Node.js server environments only. ' +
-      'For browsers, use sql.js or a server-side database API.'
-    );
-  }
-
-  // Detect current platform and architecture
-  const platform = process.platform === 'darwin' ? 'darwin' : 'linux';
-  const arch = process.arch === 'arm64' ? 'aarch64' : 'x86_64';
-  const ext = platform === 'darwin' ? 'dylib' : 'so';
-
-  const libDir = resolve(__dirname, 'lib');
-
-  // Try platform-specific extension first (highest priority)
-  const specificExt = resolve(libDir, `crsqlite-${platform}-${arch}.${ext}`);
-  if (existsSync(specificExt)) {
-    return specificExt;
-  }
-
-  // Fallback to any available extension for the current platform
-  const fallbackCandidates = [
-    resolve(libDir, `crsqlite.${ext}`),        // Generic for platform
-    resolve(libDir, 'crsqlite.dylib'),         // macOS generic
-    resolve(libDir, 'crsqlite.so'),            // Linux generic
-  ];
-
-  for (const candidate of fallbackCandidates) {
-    if (existsSync(candidate)) {
-      return candidate;
-    }
-  }
-
-  // Helpful error message with available platforms
-  const availablePlatforms = [];
-  const expectedExt = `crsqlite-${platform}-${arch}.${ext}`;
-  throw new Error(
-    `CR-SQLite extension not found for ${platform}/${arch}. ` +
-    `Expected: ${expectedExt}. ` +
-    `Available platforms: ${availablePlatforms.join(', ')}. ` +
-    `This package supports: Intel/AMD Linux (Docker, most servers), ARM64 Linux (Raspberry Pi 4+, AWS Graviton), Intel Mac, Apple Silicon Mac (M1/M2/M3)`
-  );
-}
-
-/**
- * Path to CR-SQLite extension - for use with db.loadExtension()
- * Automatically detects your platform and returns the right extension
- */
-export const pathToCRSQLiteExtension = getExtensionPath();
-
-/**
- * Default export - same as pathToCRSQLiteExtension
- */
-export default pathToCRSQLiteExtension;

package/react-native.d.ts

@@ -1,13 +0,0 @@
-/**
- * React Native placeholder for getExtensionPath
- * @throws Always throws with helpful message for React Native users
- */
-export declare function getExtensionPath(): never;
-
-/**
- * React Native placeholder for pathToCRSQLiteExtension
- * @throws Always throws with helpful message for React Native users
- */
-export declare const pathToCRSQLiteExtension: never;
-
-export default pathToCRSQLiteExtension;

package/react-native.js

@@ -1,32 +0,0 @@
-// React Native specific entry point
-// CR-SQLite extensions don't work in React Native
-
-/**
- * React Native placeholder for getExtensionPath
- * @throws Always throws with helpful message for React Native users
- */
-export function getExtensionPath() {
-  throw new Error(
-    '\u{1f6ab} @effect-native/libcrsql is for Node.js / Bun server environments only.\n\n' +
-    '\u{1f4f1} For React Native, use one of these instead:\n' +
-    '  \u2022 @op-engineering/op-sqlite: https://www.npmjs.com/package/@op-engineering/op-sqlite\n' +
-    '  \u2022 expo-sqlite: https://docs.expo.dev/versions/latest/sdk/sqlite/\n' +
-    '\u{1f4a1} This package provides native CR-SQLite extensions for Node.js / Bun servers, not mobile apps.'
-  );
-}
-
-/**
- * React Native placeholder for pathToCRSQLiteExtension
- * @throws Always throws with helpful message
- */
-export const pathToCRSQLiteExtension = (() => {
-  throw new Error(
-    '\u{1f6ab} @effect-native/libcrsql is for Node.js / Bun server environments only.\n\n' +
-    '\u{1f4f1} For React Native, use one of these instead:\n' +
-    '  \u2022 @op-engineering/op-sqlite: https://www.npmjs.com/package/@op-engineering/op-sqlite\n' +
-    '  \u2022 expo-sqlite: https://docs.expo.dev/versions/latest/sdk/sqlite/\n' +
-    '\u{1f4a1} This package provides native CR-SQLite extensions for Node.js / Bun servers, not mobile apps.'
-  );
-})();
-
-export default pathToCRSQLiteExtension;