@ereo/db-surrealdb 0.1.6

package/dist/adapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @ereo/db-surrealdb - SurrealDB Adapter Implementation
+ *
+ * Implements the DatabaseAdapter interface for SurrealDB.
+ */
+import { type DatabaseAdapter } from '@ereo/db';
+import type { SurrealDBConfig } from './types';
+/**
+ * SurrealDB client interface.
+ * This matches the API from the 'surrealdb' package.
+ */
+interface SurrealClient {
+    connect(url: string): Promise<void>;
+    close(): Promise<void>;
+    use(params: {
+        namespace: string;
+        database: string;
+    }): Promise<void>;
+    signin(credentials: Record<string, unknown>): Promise<string>;
+    query<T = unknown>(sql: string, vars?: Record<string, unknown>): Promise<T[]>;
+    select<T = unknown>(thing: string): Promise<T[]>;
+    create<T = unknown>(thing: string, data?: Record<string, unknown>): Promise<T>;
+    insert<T = unknown>(thing: string, data?: Record<string, unknown> | Record<string, unknown>[]): Promise<T[]>;
+    update<T = unknown>(thing: string, data?: Record<string, unknown>): Promise<T>;
+    merge<T = unknown>(thing: string, data?: Record<string, unknown>): Promise<T>;
+    patch<T = unknown>(thing: string, data?: unknown[]): Promise<T>;
+    delete<T = unknown>(thing: string): Promise<T>;
+}
+/**
+ * Create a SurrealDB database adapter.
+ *
+ * @param config - SurrealDB configuration
+ * @returns A configured DatabaseAdapter instance
+ *
+ * @example
+ * import { createSurrealAdapter } from '@ereo/db-surrealdb';
+ * import { createDatabasePlugin } from '@ereo/db';
+ *
+ * const adapter = createSurrealAdapter({
+ *   url: 'http://localhost:8000',
+ *   namespace: 'test',
+ *   database: 'test',
+ *   auth: {
+ *     username: 'root',
+ *     password: 'root',
+ *   },
+ * });
+ *
+ * export default defineConfig({
+ *   plugins: [createDatabasePlugin(adapter)],
+ * });
+ */
+export declare function createSurrealAdapter(config: SurrealDBConfig): DatabaseAdapter<SurrealClient>;
+/**
+ * Create a SurrealQL SELECT query.
+ */
+export declare function select(table: string, options?: {
+    where?: string;
+    orderBy?: string;
+    limit?: number;
+    start?: number;
+}): string;
+/**
+ * Create a SurrealQL CREATE query.
+ */
+export declare function create(table: string, id?: string): string;
+/**
+ * Create a SurrealQL UPDATE query.
+ */
+export declare function update(table: string, id?: string): string;
+/**
+ * Create a SurrealQL DELETE query.
+ */
+export declare function deleteFrom(table: string, id?: string): string;
+export type { SurrealClient };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

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

package/dist/config.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @ereo/db-surrealdb - Configuration Helpers
+ *
+ * Type-safe configuration builders for SurrealDB adapter.
+ */
+import type { SurrealDBConfig, RootAuth, NamespaceAuth, DatabaseAuth, RecordAccessAuth } from './types';
+/**
+ * Type-safe configuration builder for SurrealDB adapter.
+ *
+ * @example
+ * const config = defineSurrealConfig({
+ *   url: 'http://localhost:8000',
+ *   namespace: 'test',
+ *   database: 'test',
+ *   auth: {
+ *     username: 'root',
+ *     password: 'root',
+ *   },
+ * });
+ */
+export declare function defineSurrealConfig(config: SurrealDBConfig): SurrealDBConfig;
+/**
+ * Create root-level authentication credentials.
+ *
+ * @example
+ * const auth = rootAuth('root', 'surrealdb');
+ */
+export declare function rootAuth(username: string, password: string): RootAuth;
+/**
+ * Create namespace-level authentication credentials.
+ *
+ * @example
+ * const auth = namespaceAuth('myns', 'admin', 'password');
+ */
+export declare function namespaceAuth(namespace: string, username: string, password: string): NamespaceAuth;
+/**
+ * Create database-level authentication credentials.
+ *
+ * @example
+ * const auth = databaseAuth('myns', 'mydb', 'admin', 'password');
+ */
+export declare function databaseAuth(namespace: string, database: string, username: string, password: string): DatabaseAuth;
+/**
+ * Create record access authentication (SurrealDB 2.x+).
+ *
+ * @example
+ * const auth = recordAccessAuth('myns', 'mydb', 'user', {
+ *   email: 'user@example.com',
+ *   password: 'secret',
+ * });
+ */
+export declare function recordAccessAuth(namespace: string, database: string, access: string, variables?: Record<string, unknown>): RecordAccessAuth;
+/**
+ * Build a SurrealDB connection URL.
+ *
+ * @example
+ * const url = buildSurrealUrl('localhost', 8000, 'http');
+ * // => 'http://localhost:8000'
+ */
+export declare function buildSurrealUrl(host: string, port?: number, protocol?: 'http' | 'https' | 'ws' | 'wss'): string;
+/**
+ * Parse a SurrealDB connection URL into components.
+ */
+export declare function parseSurrealUrl(url: string): {
+    protocol: string;
+    host: string;
+    port: number;
+    path: string;
+};
+/**
+ * Create a local development configuration.
+ *
+ * @example
+ * const config = localConfig('test', 'test');
+ */
+export declare function localConfig(namespace: string, database: string, options?: Partial<SurrealDBConfig>): SurrealDBConfig;
+/**
+ * Create a cloud/production configuration.
+ *
+ * @example
+ * const config = cloudConfig(
+ *   'https://cloud.surrealdb.com',
+ *   'production',
+ *   'mydb',
+ *   rootAuth('user', 'password')
+ * );
+ */
+export declare function cloudConfig(url: string, namespace: string, database: string, auth: SurrealDBConfig['auth'], options?: Partial<SurrealDBConfig>): SurrealDBConfig;
+/**
+ * Create configuration from environment variables.
+ *
+ * Expected env vars:
+ * - SURREAL_URL (required)
+ * - SURREAL_NAMESPACE (required)
+ * - SURREAL_DATABASE (required)
+ * - SURREAL_USERNAME (optional)
+ * - SURREAL_PASSWORD (optional)
+ *
+ * @example
+ * const config = envConfig();
+ */
+export declare function envConfig(env?: Record<string, string | undefined>): SurrealDBConfig;
+/**
+ * Validate a SurrealDB configuration.
+ * Throws an error if the configuration is invalid.
+ */
+export declare function validateConfig(config: SurrealDBConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAM5E;AAMD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,aAAa,CAEf;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,YAAY,CAEd;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,gBAAgB,CAElB;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAa,EACnB,QAAQ,GAAE,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,KAAc,GACjD,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAQA;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACjC,eAAe,CAQjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAC7B,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACjC,eAAe,CASjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,eAAe,CAyBjB;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAsB5D"}

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @ereo/db-surrealdb - SurrealDB Adapter
+ *
+ * Provides SurrealDB integration for the EreoJS database abstraction layer.
+ * SurrealDB is a multi-model database that supports SQL-like queries, graph
+ * relationships, and real-time subscriptions.
+ *
+ * @example
+ * // Basic setup
+ * import { createSurrealAdapter, defineSurrealConfig } from '@ereo/db-surrealdb';
+ * import { createDatabasePlugin } from '@ereo/db';
+ *
+ * const adapter = createSurrealAdapter(defineSurrealConfig({
+ *   url: 'http://localhost:8000',
+ *   namespace: 'test',
+ *   database: 'test',
+ *   auth: {
+ *     username: 'root',
+ *     password: 'root',
+ *   },
+ * }));
+ *
+ * export default defineConfig({
+ *   plugins: [createDatabasePlugin(adapter)],
+ * });
+ *
+ * @example
+ * // Using in routes
+ * import { useDb } from '@ereo/db';
+ *
+ * export const loader = createLoader({
+ *   load: async ({ context }) => {
+ *     const db = useDb(context);
+ *
+ *     // Use SurrealQL
+ *     const result = await db.client.query('SELECT * FROM users WHERE active = true');
+ *
+ *     // Or use the convenience methods
+ *     const users = await db.client.select('users');
+ *
+ *     return users;
+ *   },
+ * });
+ *
+ * @example
+ * // Environment-based configuration
+ * import { createSurrealAdapter, envConfig } from '@ereo/db-surrealdb';
+ *
+ * const adapter = createSurrealAdapter(envConfig());
+ * // Uses: SURREAL_URL, SURREAL_NAMESPACE, SURREAL_DATABASE, SURREAL_USERNAME, SURREAL_PASSWORD
+ *
+ * @packageDocumentation
+ */
+export { createSurrealAdapter, select, create, update, deleteFrom, type SurrealClient, } from './adapter';
+export { defineSurrealConfig, rootAuth, namespaceAuth, databaseAuth, recordAccessAuth, buildSurrealUrl, parseSurrealUrl, localConfig, cloudConfig, envConfig, validateConfig, } from './config';
+export { type SurrealDBConfig, type SurrealAuth, type RootAuth, type NamespaceAuth, type DatabaseAuth, type RecordAccessAuth, type ScopeAuth, type ConnectionProtocol, type SurrealEngine, type SurrealQueryResult, type SurrealRawResponse, type RecordId, type SurrealRecord, type LiveAction, type LiveNotification, isRootAuth, isNamespaceAuth, isDatabaseAuth, isRecordAccessAuth, isScopeAuth, } from './types';
+export { createDatabasePlugin, useDb, useAdapter, getDb, withTransaction, type DatabaseAdapter, type RequestScopedClient, type QueryResult, type MutationResult, type DedupResult, type DedupStats, type TransactionOptions, } from '@ereo/db';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAMH,OAAO,EACL,oBAAoB,EAEpB,MAAM,EACN,MAAM,EACN,MAAM,EACN,UAAU,EAEV,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC;AAMnB,OAAO,EAEL,mBAAmB,EAEnB,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,gBAAgB,EAEhB,eAAe,EACf,eAAe,EAEf,WAAW,EACX,WAAW,EACX,SAAS,EAET,cAAc,GACf,MAAM,UAAU,CAAC;AAMlB,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAEd,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAElB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EAEvB,KAAK,QAAQ,EACb,KAAK,aAAa,EAElB,KAAK,UAAU,EACf,KAAK,gBAAgB,EAErB,UAAU,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,WAAW,GACZ,MAAM,SAAS,CAAC;AAMjB,OAAO,EAEL,oBAAoB,EACpB,KAAK,EACL,UAAU,EACV,KAAK,EACL,eAAe,EAEf,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,393 @@
+// @bun
+var __require = import.meta.require;
+
+// src/adapter.ts
+import {
+  dedupQuery,
+  clearDedupCache,
+  invalidateTables,
+  getRequestDedupStats,
+  ConnectionError,
+  QueryError,
+  TransactionError
+} from "@ereo/db";
+
+// src/config.ts
+function defineSurrealConfig(config) {
+  return {
+    timeout: 30000,
+    debug: false,
+    ...config
+  };
+}
+function rootAuth(username, password) {
+  return { username, password };
+}
+function namespaceAuth(namespace, username, password) {
+  return { namespace, username, password };
+}
+function databaseAuth(namespace, database, username, password) {
+  return { namespace, database, username, password };
+}
+function recordAccessAuth(namespace, database, access, variables) {
+  return { namespace, database, access, variables };
+}
+function buildSurrealUrl(host, port = 8000, protocol = "http") {
+  return `${protocol}://${host}:${port}`;
+}
+function parseSurrealUrl(url) {
+  const parsed = new URL(url);
+  return {
+    protocol: parsed.protocol.replace(":", ""),
+    host: parsed.hostname,
+    port: parseInt(parsed.port) || (parsed.protocol === "https:" || parsed.protocol === "wss:" ? 443 : 8000),
+    path: parsed.pathname
+  };
+}
+function localConfig(namespace, database, options) {
+  return defineSurrealConfig({
+    url: "http://127.0.0.1:8000",
+    namespace,
+    database,
+    debug: true,
+    ...options
+  });
+}
+function cloudConfig(url, namespace, database, auth, options) {
+  return defineSurrealConfig({
+    url,
+    namespace,
+    database,
+    auth,
+    debug: false,
+    ...options
+  });
+}
+function envConfig(env = process.env) {
+  const url = env.SURREAL_URL;
+  const namespace = env.SURREAL_NAMESPACE;
+  const database = env.SURREAL_DATABASE;
+  if (!url) {
+    throw new Error("SURREAL_URL environment variable is required");
+  }
+  if (!namespace) {
+    throw new Error("SURREAL_NAMESPACE environment variable is required");
+  }
+  if (!database) {
+    throw new Error("SURREAL_DATABASE environment variable is required");
+  }
+  const username = env.SURREAL_USERNAME;
+  const password = env.SURREAL_PASSWORD;
+  return defineSurrealConfig({
+    url,
+    namespace,
+    database,
+    auth: username && password ? { username, password } : undefined,
+    debug: env.SURREAL_DEBUG === "true"
+  });
+}
+function validateConfig(config) {
+  if (!config.url) {
+    throw new Error("SurrealDB url is required");
+  }
+  if (!config.namespace) {
+    throw new Error("SurrealDB namespace is required");
+  }
+  if (!config.database) {
+    throw new Error("SurrealDB database is required");
+  }
+  try {
+    if (!config.url.startsWith("mem://") && !config.url.startsWith("surrealkv://")) {
+      new URL(config.url);
+    }
+  } catch {
+    throw new Error(`Invalid SurrealDB URL: ${config.url}`);
+  }
+}
+
+// src/adapter.ts
+class SurrealDBAdapter {
+  name = "surrealdb";
+  edgeCompatible = true;
+  client = null;
+  config;
+  isConnected = false;
+  constructor(config) {
+    validateConfig(config);
+    this.config = config;
+  }
+  async connect() {
+    if (this.isConnected && this.client) {
+      return;
+    }
+    try {
+      const SurrealModule = await import("surrealdb");
+      const Surreal = SurrealModule.default || SurrealModule.Surreal || SurrealModule;
+      this.client = new Surreal;
+      let connectionUrl = this.config.url;
+      if ((connectionUrl.startsWith("http://") || connectionUrl.startsWith("https://")) && !connectionUrl.endsWith("/rpc")) {
+        connectionUrl = connectionUrl.replace(/\/$/, "") + "/rpc";
+      }
+      if (this.config.debug) {
+        console.log(`[surrealdb] Connecting to ${connectionUrl}...`);
+      }
+      await this.client.connect(connectionUrl);
+      if (this.config.auth) {
+        if (this.config.debug) {
+          console.log("[surrealdb] Signing in...");
+        }
+        await this.client.signin(this.config.auth);
+      }
+      await this.client.use({
+        namespace: this.config.namespace,
+        database: this.config.database
+      });
+      this.isConnected = true;
+      if (this.config.debug) {
+        console.log(`[surrealdb] Connected to ${this.config.namespace}/${this.config.database}`);
+      }
+    } catch (error) {
+      this.client = null;
+      this.isConnected = false;
+      throw new ConnectionError(`Failed to connect to SurrealDB: ${error instanceof Error ? error.message : error}`, error instanceof Error ? error : undefined);
+    }
+  }
+  getClient() {
+    if (!this.client || !this.isConnected) {
+      throw new ConnectionError("SurrealDB not connected. Call connect() first or use the plugin which handles this automatically.");
+    }
+    return this.client;
+  }
+  getRequestClient(context) {
+    const adapter = this;
+    return {
+      get client() {
+        return adapter.getClient();
+      },
+      async query(sql, params) {
+        const vars = params ? arrayToVars(params) : undefined;
+        return dedupQuery(context, sql, params, async () => adapter.query(sql, params));
+      },
+      getDedupStats() {
+        return getRequestDedupStats(context);
+      },
+      clearDedup() {
+        clearDedupCache(context);
+      },
+      invalidate(tables) {
+        if (tables) {
+          invalidateTables(context, tables);
+        } else {
+          clearDedupCache(context);
+        }
+      }
+    };
+  }
+  async query(sql, params) {
+    await this.connect();
+    try {
+      const vars = params ? arrayToVars(params) : undefined;
+      if (this.config.debug) {
+        console.log("[surrealdb] Query:", sql, vars);
+      }
+      const results = await this.client.query(sql, vars);
+      const flatResults = Array.isArray(results) ? results.flat() : [results];
+      return {
+        rows: flatResults,
+        rowCount: flatResults.length
+      };
+    } catch (error) {
+      throw new QueryError(`SurrealDB query failed: ${error instanceof Error ? error.message : error}`, sql, params, error instanceof Error ? error : undefined);
+    }
+  }
+  async execute(sql, params) {
+    await this.connect();
+    try {
+      const vars = params ? arrayToVars(params) : undefined;
+      if (this.config.debug) {
+        console.log("[surrealdb] Execute:", sql, vars);
+      }
+      const results = await this.client.query(sql, vars);
+      const flatResults = Array.isArray(results) ? results.flat() : [results];
+      return {
+        rowsAffected: flatResults.length
+      };
+    } catch (error) {
+      throw new QueryError(`SurrealDB execute failed: ${error instanceof Error ? error.message : error}`, sql, params, error instanceof Error ? error : undefined);
+    }
+  }
+  async transaction(fn, _options) {
+    await this.connect();
+    try {
+      await this.client.query("BEGIN TRANSACTION");
+      try {
+        const result = await fn(this.client);
+        await this.client.query("COMMIT TRANSACTION");
+        return result;
+      } catch (error) {
+        await this.client.query("CANCEL TRANSACTION");
+        throw error;
+      }
+    } catch (error) {
+      throw new TransactionError(`SurrealDB transaction failed: ${error instanceof Error ? error.message : error}`, error instanceof Error ? error : undefined);
+    }
+  }
+  async beginTransaction(_options) {
+    await this.connect();
+    let isActive = true;
+    const client = this.client;
+    await client.query("BEGIN TRANSACTION");
+    return {
+      client,
+      async commit() {
+        if (!isActive) {
+          throw new TransactionError("Transaction is not active");
+        }
+        isActive = false;
+        await client.query("COMMIT TRANSACTION");
+      },
+      async rollback() {
+        if (!isActive) {
+          throw new TransactionError("Transaction is not active");
+        }
+        isActive = false;
+        await client.query("CANCEL TRANSACTION");
+      },
+      get isActive() {
+        return isActive;
+      }
+    };
+  }
+  async healthCheck() {
+    const start = Date.now();
+    try {
+      await this.connect();
+      await this.client.query("INFO FOR DB");
+      return {
+        healthy: true,
+        latencyMs: Date.now() - start,
+        metadata: {
+          namespace: this.config.namespace,
+          database: this.config.database,
+          url: this.config.url
+        }
+      };
+    } catch (error) {
+      return {
+        healthy: false,
+        latencyMs: Date.now() - start,
+        error: error instanceof Error ? error.message : String(error),
+        metadata: {
+          namespace: this.config.namespace,
+          database: this.config.database
+        }
+      };
+    }
+  }
+  async disconnect() {
+    if (!this.client || !this.isConnected) {
+      return;
+    }
+    try {
+      await this.client.close();
+      if (this.config.debug) {
+        console.log("[surrealdb] Disconnected");
+      }
+    } catch (error) {
+      if (this.config.debug) {
+        console.error("[surrealdb] Error during disconnect:", error);
+      }
+    } finally {
+      this.client = null;
+      this.isConnected = false;
+    }
+  }
+}
+function arrayToVars(params) {
+  const vars = {};
+  for (let i = 0;i < params.length; i++) {
+    vars[i.toString()] = params[i];
+  }
+  return vars;
+}
+function createSurrealAdapter(config) {
+  return new SurrealDBAdapter(config);
+}
+function select(table, options) {
+  let query = `SELECT * FROM ${table}`;
+  if (options?.where) {
+    query += ` WHERE ${options.where}`;
+  }
+  if (options?.orderBy) {
+    query += ` ORDER BY ${options.orderBy}`;
+  }
+  if (options?.limit !== undefined) {
+    query += ` LIMIT ${options.limit}`;
+  }
+  if (options?.start !== undefined) {
+    query += ` START ${options.start}`;
+  }
+  return query;
+}
+function create(table, id) {
+  return id ? `CREATE ${table}:${id}` : `CREATE ${table}`;
+}
+function update(table, id) {
+  return id ? `UPDATE ${table}:${id}` : `UPDATE ${table}`;
+}
+function deleteFrom(table, id) {
+  return id ? `DELETE ${table}:${id}` : `DELETE ${table}`;
+}
+// src/types.ts
+function isRootAuth(auth) {
+  return "username" in auth && "password" in auth && !("namespace" in auth);
+}
+function isNamespaceAuth(auth) {
+  return "namespace" in auth && "username" in auth && !("database" in auth);
+}
+function isDatabaseAuth(auth) {
+  return "namespace" in auth && "database" in auth && "username" in auth && !("access" in auth) && !("scope" in auth);
+}
+function isRecordAccessAuth(auth) {
+  return "namespace" in auth && "database" in auth && "access" in auth;
+}
+function isScopeAuth(auth) {
+  return "namespace" in auth && "database" in auth && "scope" in auth;
+}
+
+// src/index.ts
+import {
+  createDatabasePlugin,
+  useDb,
+  useAdapter,
+  getDb,
+  withTransaction
+} from "@ereo/db";
+export {
+  withTransaction,
+  validateConfig,
+  useDb,
+  useAdapter,
+  update,
+  select,
+  rootAuth,
+  recordAccessAuth,
+  parseSurrealUrl,
+  namespaceAuth,
+  localConfig,
+  isScopeAuth,
+  isRootAuth,
+  isRecordAccessAuth,
+  isNamespaceAuth,
+  isDatabaseAuth,
+  getDb,
+  envConfig,
+  deleteFrom,
+  defineSurrealConfig,
+  databaseAuth,
+  createSurrealAdapter,
+  createDatabasePlugin,
+  create,
+  cloudConfig,
+  buildSurrealUrl
+};