feat(sqlite-plugin): export SQL and bridge helpers for custom adapters

.changeset/sqlite-plugin-export-sql-bridge-helpers.md

@@ -0,0 +1,5 @@
+---
+'@rozenite/sqlite-plugin': minor
+---
+
+`classifySqlStatement`, `normalizeSingleStatementSql`, `splitSqlStatements`, `statementReturnsRows`, `decodeSqliteBridgeValue`, and `formatSqliteError` are now exported from `@rozenite/sqlite-plugin`. These are the building blocks you need when writing a custom SQLite adapter — to parse and classify SQL before execution, and to decode values coming back over the native bridge.

packages/sqlite-plugin/react-native.ts

@@ -18,6 +18,7 @@ export type {
   CreateExpoSqliteAdapterOptions,
   ExpoSqliteLike,
 } from './src/react-native/adapters/expo-sqlite';
+export type { SqlStatementSegment } from './src/shared/sql';
 
 type CreateSqliteAdapter =
   typeof import('./src/react-native/adapters').createSqliteAdapter;
@@ -27,6 +28,12 @@ type CreateExpoSqliteAdapter =
 export let createSqliteAdapter: CreateSqliteAdapter;
 export let createExpoSqliteAdapter: CreateExpoSqliteAdapter;
 export let useRozeniteSqlitePlugin: typeof import('./src/react-native/useRozeniteSqlitePlugin').useRozeniteSqlitePlugin;
+export let classifySqlStatement: typeof import('./src/shared/sql').classifySqlStatement;
+export let normalizeSingleStatementSql: typeof import('./src/shared/sql').normalizeSingleStatementSql;
+export let splitSqlStatements: typeof import('./src/shared/sql').splitSqlStatements;
+export let statementReturnsRows: typeof import('./src/shared/sql').statementReturnsRows;
+export let decodeSqliteBridgeValue: typeof import('./src/shared/bridge-values').decodeSqliteBridgeValue;
+export let formatSqliteError: typeof import('./src/shared/bridge-values').formatSqliteError;
 
 const isDev = process.env.NODE_ENV !== 'production';
 const isWeb =
@@ -40,6 +47,14 @@ if (isDev && !isWeb && !isServer) {
     require('./src/react-native/adapters').createExpoSqliteAdapter;
   useRozeniteSqlitePlugin =
     require('./src/react-native/useRozeniteSqlitePlugin').useRozeniteSqlitePlugin;
+  classifySqlStatement = require('./src/shared/sql').classifySqlStatement;
+  normalizeSingleStatementSql =
+    require('./src/shared/sql').normalizeSingleStatementSql;
+  splitSqlStatements = require('./src/shared/sql').splitSqlStatements;
+  statementReturnsRows = require('./src/shared/sql').statementReturnsRows;
+  decodeSqliteBridgeValue =
+    require('./src/shared/bridge-values').decodeSqliteBridgeValue;
+  formatSqliteError = require('./src/shared/bridge-values').formatSqliteError;
 } else {
   createSqliteAdapter = (options) => ({
     id: options.adapterId ?? 'sqlite',
@@ -52,4 +67,10 @@ if (isDev && !isWeb && !isServer) {
     databases: [],
   });
   useRozeniteSqlitePlugin = () => null;
+  classifySqlStatement = () => 'other';
+  normalizeSingleStatementSql = (sql) => sql;
+  splitSqlStatements = () => [];
+  statementReturnsRows = (_type): _type is never => false;
+  decodeSqliteBridgeValue = (value) => value;
+  formatSqliteError = () => 'Unknown SQLite error.';
 }