@superfunctions/db 0.1.0

package/dist/adapter/types.d.ts

@@ -0,0 +1,255 @@
+/**
+ * Core type definitions for the adapter system
+ */
+import type { AdapterCapabilities } from './capabilities.js';
+export interface Adapter {
+    readonly id: string;
+    readonly name: string;
+    readonly version: string;
+    readonly capabilities: AdapterCapabilities;
+    create<T = any>(params: CreateParams): Promise<T>;
+    findOne<T = any>(params: FindOneParams): Promise<T | null>;
+    findMany<T = any>(params: FindManyParams): Promise<T[]>;
+    update<T = any>(params: UpdateParams): Promise<T>;
+    delete(params: DeleteParams): Promise<void>;
+    createMany<T = any>(params: CreateManyParams): Promise<T[]>;
+    updateMany(params: UpdateManyParams): Promise<number>;
+    deleteMany(params: DeleteManyParams): Promise<number>;
+    upsert<T = any>(params: UpsertParams): Promise<T>;
+    count(params: CountParams): Promise<number>;
+    transaction<R>(callback: (trx: TransactionAdapter) => Promise<R>): Promise<R>;
+    initialize(): Promise<void>;
+    isHealthy(): Promise<HealthStatus>;
+    close(): Promise<void>;
+    getSchemaVersion(namespace: string): Promise<number>;
+    setSchemaVersion(namespace: string, version: number): Promise<void>;
+    validateSchema(schema: TableSchema): Promise<ValidationResult>;
+    createSchema?(params: CreateSchemaParams): Promise<SchemaCreation>;
+}
+export interface TransactionAdapter extends Omit<Adapter, 'transaction' | 'close'> {
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+}
+export interface HealthStatus {
+    healthy: boolean;
+    connections?: {
+        active: number;
+        idle: number;
+        max: number;
+    };
+    lastError?: Error;
+    uptime: number;
+}
+export interface CreateParams {
+    model: string;
+    data: Record<string, any>;
+    select?: string[];
+    namespace?: string;
+}
+export interface FindOneParams {
+    model: string;
+    where: WhereClause[];
+    select?: string[];
+    join?: JoinConfig;
+    namespace?: string;
+}
+export interface FindManyParams extends FindOneParams {
+    limit?: number;
+    offset?: number;
+    orderBy?: OrderBy[];
+}
+export interface UpdateParams {
+    model: string;
+    where: WhereClause[];
+    data: Record<string, any>;
+    select?: string[];
+    namespace?: string;
+}
+export interface DeleteParams {
+    model: string;
+    where: WhereClause[];
+    namespace?: string;
+}
+export interface CreateManyParams {
+    model: string;
+    data: Record<string, any>[];
+    select?: string[];
+    namespace?: string;
+}
+export interface UpdateManyParams {
+    model: string;
+    where: WhereClause[];
+    data: Record<string, any>;
+    namespace?: string;
+}
+export interface DeleteManyParams {
+    model: string;
+    where: WhereClause[];
+    namespace?: string;
+}
+export interface UpsertParams {
+    model: string;
+    where: WhereClause[];
+    create: Record<string, any>;
+    update: Record<string, any>;
+    select?: string[];
+    namespace?: string;
+}
+export interface CountParams {
+    model: string;
+    where?: WhereClause[];
+    namespace?: string;
+}
+export interface WhereClause {
+    field: string;
+    operator: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'not_in' | 'contains' | 'starts_with' | 'ends_with';
+    value: any;
+    connector?: 'AND' | 'OR';
+}
+export interface OrderBy {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+export interface JoinConfig {
+    model: string;
+    on: {
+        field: string;
+        foreignField: string;
+    };
+    type?: 'inner' | 'left' | 'right';
+}
+export interface TableSchema {
+    modelName: string;
+    fields: Record<string, FieldSchema>;
+    indexes?: IndexSchema[];
+    constraints?: ConstraintSchema[];
+}
+export interface FieldSchema {
+    type: 'string' | 'number' | 'boolean' | 'date' | 'json' | 'bigint';
+    required?: boolean;
+    unique?: boolean;
+    defaultValue?: any;
+    references?: {
+        model: string;
+        field: string;
+        onDelete?: 'cascade' | 'set null' | 'restrict';
+        onUpdate?: 'cascade' | 'set null' | 'restrict';
+    };
+    fieldName?: string;
+}
+export interface IndexSchema {
+    name: string;
+    fields: string[];
+    unique?: boolean;
+}
+export interface ConstraintSchema {
+    name: string;
+    type: 'check' | 'unique' | 'foreign_key';
+    fields: string[];
+    check?: string;
+}
+export type TableSchemaMap = Record<string, TableSchema>;
+export interface ValidationResult {
+    valid: boolean;
+    errors?: string[];
+}
+export interface CreateSchemaParams {
+    schema: TableSchemaMap;
+    namespace?: string;
+}
+export interface SchemaCreation {
+    sql?: string;
+    success: boolean;
+    errors?: string[];
+}
+export interface AdapterFactoryConfig {
+    adapterId: string;
+    adapterName?: string;
+    capabilities?: Partial<AdapterCapabilities>;
+    supportsJSON?: boolean;
+    supportsDates?: boolean;
+    supportsBooleans?: boolean;
+    supportsNumericIds?: boolean;
+    usePlural?: boolean;
+    caseStyle?: 'snake_case' | 'camelCase' | 'PascalCase';
+    namespace?: {
+        enabled: boolean;
+        separator?: string;
+        prefix?: string;
+        schemaSupport?: boolean;
+    };
+    transaction?: boolean | {
+        enabled: boolean;
+        isolationLevel?: TransactionIsolation;
+        timeout?: number;
+    };
+    mapKeysInput?: Record<string, string>;
+    mapKeysOutput?: Record<string, string>;
+    customIdGenerator?: () => string | number;
+    disableIdGeneration?: boolean;
+    debug?: boolean | {
+        logQueries?: boolean;
+        logResults?: boolean;
+        logTransactions?: boolean;
+    };
+    performance?: {
+        maxBatchSize?: number;
+        queryTimeout?: number;
+        maxConnections?: number;
+    };
+}
+export type TransactionIsolation = 'read_uncommitted' | 'read_committed' | 'repeatable_read' | 'serializable';
+export interface LibraryOptions {
+    namespace?: string;
+    schema?: TableSchemaMap;
+    validateSchema?: boolean;
+    autoMigrate?: boolean;
+}
+export interface AdapterContext {
+    options: LibraryOptions;
+    schema: TableSchemaMap;
+    getModelName: (model: string) => string;
+    getFieldName: (params: {
+        model: string;
+        field: string;
+    }) => string;
+    getDefaultModelName: (model: string) => string;
+    getDefaultFieldName: (params: {
+        model: string;
+        field: string;
+    }) => string;
+    transformInput: (data: any, model: string, action: 'create' | 'update') => Promise<any>;
+    transformOutput: (data: any, model: string) => Promise<any>;
+    log: Logger;
+}
+export interface Logger {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+}
+export interface AdapterImplementation {
+    create<T = any>(params: CreateParams): Promise<T>;
+    findOne<T = any>(params: FindOneParams): Promise<T | null>;
+    findMany<T = any>(params: FindManyParams): Promise<T[]>;
+    update<T = any>(params: UpdateParams): Promise<T>;
+    delete(params: DeleteParams): Promise<void>;
+    createMany<T = any>(params: CreateManyParams): Promise<T[]>;
+    updateMany(params: UpdateManyParams): Promise<number>;
+    deleteMany(params: DeleteManyParams): Promise<number>;
+    upsert<T = any>(params: UpsertParams): Promise<T>;
+    count(params: CountParams): Promise<number>;
+    transaction<R>(callback: (trx: TransactionAdapter) => Promise<R>): Promise<R>;
+    initialize(): Promise<void>;
+    isHealthy(): Promise<HealthStatus>;
+    close(): Promise<void>;
+    getSchemaVersion(namespace: string): Promise<number>;
+    setSchemaVersion(namespace: string, version: number): Promise<void>;
+    validateSchema(schema: TableSchema): Promise<ValidationResult>;
+    createSchema?(params: CreateSchemaParams): Promise<SchemaCreation>;
+}
+export interface AdapterFactoryOptions {
+    config: AdapterFactoryConfig;
+    adapter: (context: AdapterContext) => AdapterImplementation;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapter/types.d.ts.map

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

package/dist/adapter/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for the adapter system
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapter/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/adapters/drizzle/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Drizzle adapter
+ *
+ * Generic adapter that maps the Superfunctions Adapter interface to Drizzle ORM.
+ * It requires callers to provide a mapping from model names to Drizzle table objects,
+ * plus (optionally) conflict targets for upsert and a schema versions table.
+ */
+import type { Adapter, AdapterFactoryOptions } from '../../adapter/types.js';
+export type DrizzleDialect = 'postgres' | 'mysql' | 'sqlite';
+export interface DrizzleAdapterConfig {
+    db: any;
+    schema: Record<string, any>;
+    dialect: DrizzleDialect;
+    upsertKeys?: Record<string, string | string[]>;
+    schemaVersionsTable?: any;
+    namespace?: AdapterFactoryOptions['config']['namespace'];
+    debug?: boolean;
+}
+export declare function drizzleAdapter(config: DrizzleAdapterConfig): Adapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/drizzle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/drizzle/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,OAAO,EAEP,qBAAqB,EAatB,MAAM,wBAAwB,CAAC;AAkBhC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,GAAG,CAAC;IACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,OAAO,EAAE,cAAc,CAAC;IAExB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAE/C,mBAAmB,CAAC,EAAE,GAAG,CAAC;IAC1B,SAAS,CAAC,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,CAAC;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA0DD,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CA2QpE"}

package/dist/adapters/drizzle/index.js

@@ -0,0 +1,346 @@
+/**
+ * Drizzle adapter
+ *
+ * Generic adapter that maps the Superfunctions Adapter interface to Drizzle ORM.
+ * It requires callers to provide a mapping from model names to Drizzle table objects,
+ * plus (optionally) conflict targets for upsert and a schema versions table.
+ */
+import { createAdapterFactory } from '../../adapter/factory.js';
+import { OperationNotSupportedError } from '../../adapter/errors.js';
+// Import Drizzle helpers loosely to avoid strict peer typing
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+// These are type-unsafe on purpose to avoid hard binding to a specific driver.
+// Drizzle exports these from 'drizzle-orm'.
+// We fall back to minimal shims if not present at runtime.
+let drizzleOps = {};
+try {
+    // dynamic import to keep peer dep optional
+    // @ts-ignore
+    drizzleOps = await import('drizzle-orm');
+}
+catch {
+    // no-op: will throw if used without drizzle installed
+}
+function buildWhere(tbl, where) {
+    if (!where || where.length === 0)
+        return undefined;
+    const { and, or, not, eq, ne, gt, gte, lt, lte, inArray, sql } = drizzleOps;
+    const parts = where.map((clause) => {
+        const col = tbl[clause.field];
+        const op = clause.operator;
+        const val = clause.value;
+        switch (op) {
+            case 'eq':
+                return eq(col, val);
+            case 'ne':
+                return ne(col, val);
+            case 'gt':
+                return gt(col, val);
+            case 'gte':
+                return gte(col, val);
+            case 'lt':
+                return lt(col, val);
+            case 'lte':
+                return lte(col, val);
+            case 'in':
+                return inArray(col, Array.isArray(val) ? val : [val]);
+            case 'not_in':
+                return not(inArray(col, Array.isArray(val) ? val : [val]));
+            case 'contains':
+                return sql `${col} LIKE ${'%' + val + '%'}`;
+            case 'starts_with':
+                return sql `${col} LIKE ${val + '%'}`;
+            case 'ends_with':
+                return sql `${col} LIKE ${'%' + val}`;
+            default:
+                throw new Error(`Unsupported operator: ${op}`);
+        }
+    });
+    // Combine using connectors (default AND)
+    if (parts.length === 0)
+        return undefined;
+    if (parts.length === 1)
+        return parts[0];
+    let combined = parts[0];
+    for (let i = 1; i < parts.length; i++) {
+        const connector = where[i]?.connector ?? 'AND';
+        combined = connector === 'OR' ? or(combined, parts[i]) : and(combined, parts[i]);
+    }
+    return combined;
+}
+function buildOrder(tbl, orderBy) {
+    if (!orderBy || orderBy.length === 0)
+        return undefined;
+    const { asc, desc } = drizzleOps;
+    return orderBy.map((o) => {
+        const col = tbl[o.field];
+        return o.direction === 'desc' ? desc(col) : asc(col);
+    });
+}
+export function drizzleAdapter(config) {
+    if (!config?.db)
+        throw new Error('drizzleAdapter: config.db is required');
+    if (!config?.schema)
+        throw new Error('drizzleAdapter: config.schema is required');
+    if (!drizzleOps?.eq)
+        throw new Error('drizzle-orm is required as a peerDependency to use drizzleAdapter');
+    const createImpl = (ctx) => {
+        const { db, schema, dialect, schemaVersionsTable } = config;
+        const resolveTable = (model) => {
+            const tbl = schema[ctx.getModelName(model)];
+            if (!tbl)
+                throw new Error(`Drizzle adapter: no table mapping for model "${model}"`);
+            return tbl;
+        };
+        return {
+            async create({ model, data, select }) {
+                const tbl = resolveTable(model);
+                const q = db.insert(tbl).values(data);
+                if (dialect === 'mysql') {
+                    await q.execute();
+                    // MySQL has no returning; fetch the inserted row if selection present
+                    if (select && select.length > 0) {
+                        const where = Object.keys(data)
+                            .filter((k) => k in tbl)
+                            .slice(0, 1)
+                            .map((k) => ({ field: k, operator: 'eq', value: data[k] }));
+                        const row = await this.findOne({ model, where, select });
+                        return row;
+                    }
+                    return data;
+                }
+                else {
+                    const returning = select && select.length > 0 ? Object.fromEntries(select.map((k) => [k, tbl[k]])) : undefined;
+                    const res = await (returning ? q.returning(returning) : q.returning()).execute();
+                    return (res?.[0] ?? data);
+                }
+            },
+            async createMany({ model, data }) {
+                const tbl = resolveTable(model);
+                const q = db.insert(tbl).values(data);
+                if (dialect === 'mysql') {
+                    await q.execute();
+                    return data; // no returning
+                }
+                else {
+                    const res = await q.returning().execute();
+                    return (res ?? data);
+                }
+            },
+            async findOne({ model, where, select }) {
+                const tbl = resolveTable(model);
+                const selection = select && select.length > 0 ? Object.fromEntries(select.map((k) => [k, tbl[k]])) : undefined;
+                const q = db.select(selection).from(tbl);
+                const cond = buildWhere(tbl, where);
+                const rows = await q.where(cond).limit(1).execute();
+                return rows?.[0] ?? null;
+            },
+            async findMany({ model, where, select, orderBy, limit, offset }) {
+                const tbl = resolveTable(model);
+                const selection = select && select.length > 0 ? Object.fromEntries(select.map((k) => [k, tbl[k]])) : undefined;
+                let q = db.select(selection).from(tbl);
+                const cond = buildWhere(tbl, where);
+                if (cond)
+                    q = q.where(cond);
+                const order = buildOrder(tbl, orderBy);
+                if (order && order.length > 0)
+                    q = q.orderBy(...order);
+                if (typeof limit === 'number')
+                    q = q.limit(limit);
+                if (typeof offset === 'number')
+                    q = q.offset(offset);
+                const rows = await q.execute();
+                return rows;
+            },
+            async update({ model, where, data, select }) {
+                const tbl = resolveTable(model);
+                const cond = buildWhere(tbl, where);
+                const q = db.update(tbl).set(data).where(cond);
+                if (dialect === 'mysql') {
+                    await q.execute();
+                    const row = await this.findOne({ model, where, select });
+                    if (!row)
+                        throw new Error('Update affected zero rows');
+                    return row;
+                }
+                else {
+                    const returning = select && select.length > 0 ? Object.fromEntries(select.map((k) => [k, tbl[k]])) : undefined;
+                    const res = await (returning ? q.returning(returning) : q.returning()).execute();
+                    return (Array.isArray(res) ? res[0] : res);
+                }
+            },
+            async updateMany({ model, where, data }) {
+                const tbl = resolveTable(model);
+                const cond = buildWhere(tbl, where);
+                const q = db.update(tbl).set(data).where(cond);
+                const result = await q.execute();
+                // drizzle returns driver-dependent result; for better-sqlite3 it's { changes: N, lastInsertRowid: X }
+                const n = result?.changes ?? result?.rowsAffected ?? result?.rowCount ?? 0;
+                return typeof n === 'number' ? n : 0;
+            },
+            async delete({ model, where }) {
+                const tbl = resolveTable(model);
+                const cond = buildWhere(tbl, where);
+                const q = db.delete(tbl).where(cond);
+                if (dialect === 'mysql') {
+                    // MySQL no returning; attempt to fetch first then delete
+                    const existing = await this.findOne({ model, where });
+                    await db.delete(tbl).where(cond).execute();
+                    return existing ?? null;
+                }
+                else {
+                    const res = await q.execute();
+                    void res; // ignore value; delete returns void
+                }
+            },
+            async deleteMany({ model, where }) {
+                const tbl = resolveTable(model);
+                const cond = buildWhere(tbl, where);
+                const res = await db.delete(tbl).where(cond).execute();
+                const n = res?.changes ?? res?.rowsAffected ?? res?.rowCount ?? 0;
+                return typeof n === 'number' ? n : 0;
+            },
+            async upsert({ model, where, create, update, select }) {
+                const tbl = resolveTable(model);
+                if (!where || where.length === 0)
+                    throw new Error('upsert requires a non-empty where clause targeting unique columns');
+                // Determine conflict target
+                let target = config.upsertKeys?.[model];
+                if (!target) {
+                    // derive from where fields
+                    target = where.length === 1 ? where[0].field : where.map((w) => w.field);
+                }
+                if (config.dialect === 'mysql') {
+                    const q = db.insert(tbl).values(create).onDuplicateKeyUpdate({ set: update });
+                    if (select && select.length > 0) {
+                        await q.execute();
+                        // reselect
+                        const row = await this.findOne({ model, where, select });
+                        if (!row)
+                            throw new Error('Upsert failed to return a row');
+                        return row;
+                    }
+                    else {
+                        await q.execute();
+                        return create;
+                    }
+                }
+                else {
+                    const keys = Array.isArray(target) ? target.map((k) => tbl[k]) : [tbl[target]];
+                    const returning = select && select.length > 0 ? Object.fromEntries(select.map((k) => [k, tbl[k]])) : undefined;
+                    const q = db
+                        .insert(tbl)
+                        .values(create)
+                        .onConflictDoUpdate({ target: keys, set: update });
+                    const res = await (returning ? q.returning(returning) : q.returning()).execute();
+                    return (Array.isArray(res) ? res[0] : res);
+                }
+            },
+            async count({ model, where }) {
+                const tbl = resolveTable(model);
+                const { sql } = drizzleOps;
+                const cond = buildWhere(tbl, where);
+                const rows = await db
+                    .select({ value: sql `count(*)`.as('value') })
+                    .from(tbl)
+                    .where(cond)
+                    .execute();
+                const v = rows?.[0]?.value;
+                return typeof v === 'number' ? v : Number(v ?? 0);
+            },
+            async transaction(fn) {
+                // Drizzle's transaction API varies by dialect
+                // For async dialects (postgres, mysql): db.transaction returns Promise
+                // For better-sqlite3: db.transaction must be synchronous
+                if (dialect === 'sqlite') {
+                    // better-sqlite3 doesn't support async transaction callbacks natively
+                    // fallback: execute directly without transaction wrapper for now
+                    const child = drizzleAdapter({ ...config, db });
+                    const txAdapter = {
+                        ...child,
+                        transaction: async () => {
+                            throw new OperationNotSupportedError('transaction', 'DrizzleAdapter (nested transaction)');
+                        },
+                        close: async () => { },
+                        commit: async () => { },
+                        rollback: async () => { },
+                    };
+                    return await fn(txAdapter);
+                }
+                else {
+                    // Async transaction for postgres/mysql
+                    return await db.transaction(async (trx) => {
+                        const child = drizzleAdapter({ ...config, db: trx });
+                        const txAdapter = {
+                            ...child,
+                            transaction: async () => {
+                                throw new OperationNotSupportedError('transaction', 'DrizzleAdapter (nested transaction)');
+                            },
+                            close: async () => { },
+                            commit: async () => { },
+                            rollback: async () => { },
+                        };
+                        return await fn(txAdapter);
+                    });
+                }
+            },
+            async initialize() { return; },
+            async isHealthy() {
+                return { healthy: true, uptime: 0 };
+            },
+            async close() { return; },
+            async getSchemaVersion(namespace) {
+                if (!schemaVersionsTable)
+                    return 0;
+                const rows = await db
+                    .select({ version: schemaVersionsTable.version })
+                    .from(schemaVersionsTable)
+                    .where(drizzleOps.eq(schemaVersionsTable.namespace, namespace))
+                    .limit(1)
+                    .execute();
+                return rows?.[0]?.version ?? 0;
+            },
+            async setSchemaVersion(namespace, version) {
+                if (!schemaVersionsTable)
+                    throw new OperationNotSupportedError('setSchemaVersion', 'DrizzleAdapter (schemaVersionsTable not configured)');
+                // Try update, then insert
+                const existing = await this.getSchemaVersion(namespace);
+                const now = new Date().toISOString();
+                if (existing === 0) {
+                    await db.insert(schemaVersionsTable).values({ namespace, version, appliedAt: now }).execute();
+                }
+                else {
+                    await db
+                        .update(schemaVersionsTable)
+                        .set({ version, appliedAt: now })
+                        .where(drizzleOps.eq(schemaVersionsTable.namespace, namespace))
+                        .execute();
+                }
+            },
+            async validateSchema() {
+                // Drizzle is strongly typed; runtime validation is out-of-scope here
+                return { valid: true };
+            },
+        };
+    };
+    const factory = createAdapterFactory({
+        config: {
+            adapterId: 'drizzle',
+            adapterName: 'Drizzle Adapter',
+            debug: config.debug ?? false,
+            namespace: config.namespace,
+            capabilities: {
+                types: { json: true, dates: true, booleans: true, bigint: true, uuid: true, enum: true },
+                operations: { batch: true, upsert: true, streaming: false, fulltext: false, returning: config.dialect !== 'mysql' },
+                transactions: { supported: true, nested: false, isolation: undefined },
+                performance: { supportsJoins: true, supportsPreparedStatements: true },
+                schema: { migrations: false, constraints: true, indexes: true },
+                advanced: { customIdGeneration: false, numericIds: true, schemaNamespaces: true, customTypes: true },
+            },
+        },
+        adapter: createImpl,
+    });
+    // Return an adapter instance for default (no library-provided overrides)
+    return factory({});
+}
+//# sourceMappingURL=index.js.map