@apibara/plugin-drizzle 2.1.0-beta.2 → 2.1.0-beta.20

package/dist/index.cjs

@@ -4,10 +4,21 @@ const indexer = require('@apibara/indexer');
 const plugins = require('@apibara/indexer/plugins');
 const internal = require('@apibara/indexer/internal');
 const plugins$1 = require('@apibara/indexer/internal/plugins');
+const constants = require('./shared/plugin-drizzle.cae20704.cjs');
+const pglite$1 = require('@electric-sql/pglite');
+const nodePostgres = require('drizzle-orm/node-postgres');
+const migrator$1 = require('drizzle-orm/node-postgres/migrator');
+const pglite = require('drizzle-orm/pglite');
+const migrator = require('drizzle-orm/pglite/migrator');
+const pg = require('pg');
 const protocol = require('@apibara/protocol');
 const drizzleOrm = require('drizzle-orm');
 const pgCore = require('drizzle-orm/pg-core');
 
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const pg__default = /*#__PURE__*/_interopDefaultCompat(pg);
+
 class DrizzleStorageError extends Error {
   constructor(message, options) {
     super(message, options);
@@ -36,15 +47,63 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-const CHECKPOINTS_TABLE_NAME = "__indexer_checkpoints";
-const FILTERS_TABLE_NAME = "__indexer_filters";
-const SCHEMA_VERSION_TABLE_NAME = "__indexer_schema_version";
-const checkpoints = pgCore.pgTable(CHECKPOINTS_TABLE_NAME, {
+function drizzle(options) {
+  const {
+    connectionString = process.env["POSTGRES_CONNECTION_STRING"] ?? "memory://",
+    schema,
+    type = "pglite",
+    config,
+    poolConfig
+  } = options ?? {};
+  if (isPostgresConnectionString(connectionString) || type === "node-postgres") {
+    const pool = new pg__default.Pool({
+      connectionString,
+      ...poolConfig || {}
+    });
+    return nodePostgres.drizzle(pool, { schema, ...config || {} });
+  }
+  if (type === "pglite") {
+    return pglite.drizzle({
+      schema,
+      connection: {
+        dataDir: connectionString || "memory://pglite"
+      },
+      ...config || {}
+    });
+  }
+  throw new Error("Invalid database type");
+}
+async function migrate(db, options) {
+  const isPglite = !!("$client" in db && db.$client instanceof pglite$1.PGlite);
+  try {
+    if (isPglite) {
+      await migrator.migrate(db, options);
+    } else {
+      await migrator$1.migrate(db, options);
+    }
+  } catch (error) {
+    throw new DrizzleStorageError(
+      "Failed to apply migrations! Please check if you have generated migrations using drizzle:generate",
+      {
+        cause: error
+      }
+    );
+  }
+}
+function isPostgresConnectionString(conn) {
+  return conn.startsWith("postgres://") || conn.startsWith("postgresql://");
+}
+
+const CHECKPOINTS_TABLE_NAME = "checkpoints";
+const FILTERS_TABLE_NAME = "filters";
+const SCHEMA_VERSION_TABLE_NAME = "schema_version";
+const schema$1 = pgCore.pgSchema(constants.SCHEMA_NAME);
+const checkpoints = schema$1.table(CHECKPOINTS_TABLE_NAME, {
   id: pgCore.text("id").notNull().primaryKey(),
   orderKey: pgCore.integer("order_key").notNull(),
   uniqueKey: pgCore.text("unique_key")
 });
-const filters = pgCore.pgTable(
+const filters = schema$1.table(
   FILTERS_TABLE_NAME,
   {
     id: pgCore.text("id").notNull(),
@@ -58,7 +117,7 @@ const filters = pgCore.pgTable(
     }
   ]
 );
-const schemaVersion = pgCore.pgTable(SCHEMA_VERSION_TABLE_NAME, {
+const schemaVersion = schema$1.table(SCHEMA_VERSION_TABLE_NAME, {
   k: pgCore.integer("k").notNull().primaryKey(),
   version: pgCore.integer("version").notNull()
 });
@@ -69,12 +128,19 @@ const MIGRATIONS = [
   // Add more migration arrays for future versions
 ];
 async function initializePersistentState(tx) {
-  await tx.execute(`
-    CREATE TABLE IF NOT EXISTS ${SCHEMA_VERSION_TABLE_NAME} (
+  await tx.execute(
+    drizzleOrm.sql.raw(`
+      CREATE SCHEMA IF NOT EXISTS ${constants.SCHEMA_NAME};
+  `)
+  );
+  await tx.execute(
+    drizzleOrm.sql.raw(`
+    CREATE TABLE IF NOT EXISTS ${constants.SCHEMA_NAME}.${SCHEMA_VERSION_TABLE_NAME} (
       k INTEGER PRIMARY KEY,
       version INTEGER NOT NULL
     );
-  `);
+  `)
+  );
   const versionRows = await tx.select().from(schemaVersion).where(drizzleOrm.eq(schemaVersion.k, 0));
   const storedVersion = versionRows[0]?.version ?? -1;
   if (storedVersion > CURRENT_SCHEMA_VERSION) {
@@ -84,22 +150,26 @@ async function initializePersistentState(tx) {
   }
   try {
     if (storedVersion === -1) {
-      await tx.execute(`
-        CREATE TABLE IF NOT EXISTS ${CHECKPOINTS_TABLE_NAME} (
+      await tx.execute(
+        drizzleOrm.sql.raw(`
+        CREATE TABLE IF NOT EXISTS ${constants.SCHEMA_NAME}.${CHECKPOINTS_TABLE_NAME} (
           id TEXT PRIMARY KEY,
           order_key INTEGER NOT NULL,
           unique_key TEXT
         );
-      `);
-      await tx.execute(`
-        CREATE TABLE IF NOT EXISTS ${FILTERS_TABLE_NAME} (
+      `)
+      );
+      await tx.execute(
+        drizzleOrm.sql.raw(`
+        CREATE TABLE IF NOT EXISTS ${constants.SCHEMA_NAME}.${FILTERS_TABLE_NAME} (
           id TEXT NOT NULL,
           filter TEXT NOT NULL,
           from_block INTEGER NOT NULL,
           to_block INTEGER DEFAULT NULL,
           PRIMARY KEY (id, from_block)
         );
-      `);
+      `)
+      );
       await tx.insert(schemaVersion).values({
         k: 0,
         version: CURRENT_SCHEMA_VERSION
@@ -134,7 +204,9 @@ async function persistState(props) {
         target: checkpoints.id,
         set: {
           orderKey: Number(endCursor.orderKey),
-          uniqueKey: endCursor.uniqueKey
+          // Explicitly set the unique key to `null` to indicate that it has been deleted
+          // Otherwise drizzle will not update its value.
+          uniqueKey: endCursor.uniqueKey ? endCursor.uniqueKey : null
         }
       });
       if (filter) {
@@ -213,11 +285,24 @@ async function finalizeState(props) {
     });
   }
 }
+async function resetPersistence(props) {
+  const { tx, indexerId } = props;
+  try {
+    await tx.delete(checkpoints).where(drizzleOrm.eq(checkpoints.id, indexerId));
+    await tx.delete(filters).where(drizzleOrm.eq(filters.id, indexerId));
+  } catch (error) {
+    throw new DrizzleStorageError("Failed to reset persistence state", {
+      cause: error
+    });
+  }
+}
 
+const ROLLBACK_TABLE_NAME = "reorg_rollback";
+const schema = pgCore.pgSchema(constants.SCHEMA_NAME);
 function getReorgTriggerName(table, indexerId) {
   return `${table}_reorg_${indexerId}`;
 }
-pgCore.pgTable("__reorg_rollback", {
+schema.table(ROLLBACK_TABLE_NAME, {
   n: pgCore.serial("n").primaryKey(),
   op: pgCore.char("op", { length: 1 }).$type().notNull(),
   table_name: pgCore.text("table_name").notNull(),
@@ -228,9 +313,12 @@ pgCore.pgTable("__reorg_rollback", {
 });
 async function initializeReorgRollbackTable(tx, indexerId) {
   try {
+    await tx.execute(`
+    CREATE SCHEMA IF NOT EXISTS ${constants.SCHEMA_NAME};
+    `);
     await tx.execute(
       drizzleOrm.sql.raw(`
-        CREATE TABLE IF NOT EXISTS __reorg_rollback(
+        CREATE TABLE IF NOT EXISTS ${constants.SCHEMA_NAME}.${ROLLBACK_TABLE_NAME}(
           n SERIAL PRIMARY KEY,
           op CHAR(1) NOT NULL,
           table_name TEXT NOT NULL,
@@ -243,7 +331,7 @@ async function initializeReorgRollbackTable(tx, indexerId) {
     );
     await tx.execute(
       drizzleOrm.sql.raw(`
-        CREATE INDEX IF NOT EXISTS idx_reorg_rollback_indexer_id_cursor ON __reorg_rollback(indexer_id, cursor);
+        CREATE INDEX IF NOT EXISTS idx_reorg_rollback_indexer_id_cursor ON ${constants.SCHEMA_NAME}.${ROLLBACK_TABLE_NAME}(indexer_id, cursor);
       `)
     );
   } catch (error) {
@@ -254,7 +342,7 @@ async function initializeReorgRollbackTable(tx, indexerId) {
   try {
     await tx.execute(
       drizzleOrm.sql.raw(`
-      CREATE OR REPLACE FUNCTION reorg_checkpoint()
+      CREATE OR REPLACE FUNCTION ${constants.SCHEMA_NAME}.reorg_checkpoint()
       RETURNS TRIGGER AS $$
       DECLARE
         id_col TEXT := TG_ARGV[0]::TEXT;
@@ -264,13 +352,13 @@ async function initializeReorgRollbackTable(tx, indexerId) {
         old_id_value TEXT := row_to_json(OLD.*)->>id_col;
       BEGIN
         IF (TG_OP = 'DELETE') THEN
-          INSERT INTO __reorg_rollback(op, table_name, cursor, row_id, row_value, indexer_id)
+          INSERT INTO ${constants.SCHEMA_NAME}.${ROLLBACK_TABLE_NAME}(op, table_name, cursor, row_id, row_value, indexer_id)
             SELECT 'D', TG_TABLE_NAME, order_key, old_id_value, row_to_json(OLD.*), indexer_id;
         ELSIF (TG_OP = 'UPDATE') THEN
-          INSERT INTO __reorg_rollback(op, table_name, cursor, row_id, row_value, indexer_id)
+          INSERT INTO ${constants.SCHEMA_NAME}.${ROLLBACK_TABLE_NAME}(op, table_name, cursor, row_id, row_value, indexer_id)
             SELECT 'U', TG_TABLE_NAME, order_key, new_id_value, row_to_json(OLD.*), indexer_id;
         ELSIF (TG_OP = 'INSERT') THEN
-          INSERT INTO __reorg_rollback(op, table_name, cursor, row_id, row_value, indexer_id)
+          INSERT INTO ${constants.SCHEMA_NAME}.${ROLLBACK_TABLE_NAME}(op, table_name, cursor, row_id, row_value, indexer_id)
             SELECT 'I', TG_TABLE_NAME, order_key, new_id_value, null, indexer_id;
         END IF;
         RETURN NULL;
@@ -300,7 +388,7 @@ async function registerTriggers(tx, tables, endCursor, idColumn, indexerId) {
           CREATE CONSTRAINT TRIGGER ${getReorgTriggerName(table, indexerId)}
           AFTER INSERT OR UPDATE OR DELETE ON ${table}
           DEFERRABLE INITIALLY DEFERRED
-          FOR EACH ROW EXECUTE FUNCTION reorg_checkpoint('${idColumn}', ${`${Number(endCursor.orderKey)}`}, '${indexerId}');
+          FOR EACH ROW EXECUTE FUNCTION ${constants.SCHEMA_NAME}.reorg_checkpoint('${idColumn}', ${`${Number(endCursor.orderKey)}`}, '${indexerId}');
         `)
       );
     }
@@ -329,7 +417,7 @@ async function invalidate(tx, cursor, idColumn, indexerId) {
   const { rows: result } = await tx.execute(
     drizzleOrm.sql.raw(`
       WITH deleted AS (
-        DELETE FROM __reorg_rollback
+        DELETE FROM ${constants.SCHEMA_NAME}.${ROLLBACK_TABLE_NAME}
         WHERE cursor > ${Number(cursor.orderKey)}
         AND indexer_id = '${indexerId}'
         RETURNING *
@@ -422,7 +510,7 @@ async function finalize(tx, cursor, indexerId) {
   try {
     await tx.execute(
       drizzleOrm.sql.raw(`
-      DELETE FROM __reorg_rollback
+      DELETE FROM ${constants.SCHEMA_NAME}.${ROLLBACK_TABLE_NAME}
       WHERE cursor <= ${Number(cursor.orderKey)}
       AND indexer_id = '${indexerId}'
     `)
@@ -433,28 +521,60 @@ async function finalize(tx, cursor, indexerId) {
     });
   }
 }
+async function cleanupStorage(tx, tables, indexerId) {
+  try {
+    for (const table of tables) {
+      await tx.execute(
+        drizzleOrm.sql.raw(
+          `DROP TRIGGER IF EXISTS ${getReorgTriggerName(table, indexerId)} ON ${table};`
+        )
+      );
+    }
+    await tx.execute(
+      drizzleOrm.sql.raw(`
+        DELETE FROM ${constants.SCHEMA_NAME}.${ROLLBACK_TABLE_NAME}
+        WHERE indexer_id = '${indexerId}'
+      `)
+    );
+    for (const table of tables) {
+      try {
+        await tx.execute(drizzleOrm.sql.raw(`TRUNCATE TABLE ${table} CASCADE;`));
+      } catch (error) {
+        throw new DrizzleStorageError(`Failed to truncate table ${table}`, {
+          cause: error
+        });
+      }
+    }
+  } catch (error) {
+    throw new DrizzleStorageError("Failed to clean up storage", {
+      cause: error
+    });
+  }
+}
 
-const DRIZZLE_PROPERTY = "_drizzle";
 const MAX_RETRIES = 5;
 function useDrizzleStorage(_db) {
   const context = indexer.useIndexerContext();
-  if (!context[DRIZZLE_PROPERTY]) {
+  if (!context[constants.DRIZZLE_PROPERTY]) {
     throw new DrizzleStorageError(
       "drizzle storage is not available. Did you register the plugin?"
     );
   }
-  return context[DRIZZLE_PROPERTY];
+  return context[constants.DRIZZLE_PROPERTY];
 }
 function drizzleStorage({
   db,
   persistState: enablePersistence = true,
   indexerName: identifier = "default",
   schema,
-  idColumn = "id"
+  idColumn = "id",
+  migrate: migrateOptions
 }) {
-  return plugins.defineIndexerPlugin((indexer) => {
+  return plugins.defineIndexerPlugin((indexer$1) => {
     let tableNames = [];
     let indexerId = "";
+    const alwaysReindex = process.env["APIBARA_ALWAYS_REINDEX"] === "true";
+    let prevFinality;
     try {
       tableNames = Object.values(schema ?? db._.schema ?? {}).map(
         (table) => table.dbName
@@ -464,12 +584,34 @@ function drizzleStorage({
         cause: error
       });
     }
-    indexer.hooks.hook("run:before", async () => {
-      const { indexerName: indexerFileName, availableIndexers } = plugins$1.useInternalContext();
+    indexer$1.hooks.hook("run:before", async () => {
+      const internalContext = plugins$1.useInternalContext();
+      const context = indexer.useIndexerContext();
+      const logger = plugins.useLogger();
+      context[constants.DRIZZLE_STORAGE_DB_PROPERTY] = db;
+      const { indexerName: indexerFileName, availableIndexers } = internalContext;
       indexerId = internal.generateIndexerId(indexerFileName, identifier);
+      if (alwaysReindex) {
+        logger.warn(
+          `Reindexing: Deleting all data from tables - ${tableNames.join(", ")}`
+        );
+        await withTransaction(db, async (tx) => {
+          await cleanupStorage(tx, tableNames, indexerId);
+          if (enablePersistence) {
+            await resetPersistence({ tx, indexerId });
+          }
+          logger.success("Tables have been cleaned up for reindexing");
+        });
+      }
       let retries = 0;
+      let migrationsApplied = false;
       while (retries <= MAX_RETRIES) {
         try {
+          if (migrateOptions && !migrationsApplied) {
+            await migrate(db, migrateOptions);
+            migrationsApplied = true;
+            logger.success("Migrations applied");
+          }
           await withTransaction(db, async (tx) => {
             await initializeReorgRollbackTable(tx, indexerId);
             if (enablePersistence) {
@@ -479,6 +621,9 @@ function drizzleStorage({
           break;
         } catch (error) {
           if (retries === MAX_RETRIES) {
+            if (error instanceof DrizzleStorageError) {
+              throw error;
+            }
             throw new DrizzleStorageError(
               "Initialization failed after 5 retries",
               {
@@ -491,7 +636,7 @@ function drizzleStorage({
         }
       }
     });
-    indexer.hooks.hook("connect:before", async ({ request }) => {
+    indexer$1.hooks.hook("connect:before", async ({ request }) => {
       if (!enablePersistence) {
         return;
       }
@@ -508,7 +653,7 @@ function drizzleStorage({
         }
       });
     });
-    indexer.hooks.hook("connect:after", async ({ request }) => {
+    indexer$1.hooks.hook("connect:after", async ({ request }) => {
       const cursor = request.startingCursor;
       if (!cursor) {
         return;
@@ -520,7 +665,7 @@ function drizzleStorage({
         }
       });
     });
-    indexer.hooks.hook("connect:factory", async ({ request, endCursor }) => {
+    indexer$1.hooks.hook("connect:factory", async ({ request, endCursor }) => {
       if (!enablePersistence) {
         return;
       }
@@ -534,7 +679,7 @@ function drizzleStorage({
         });
       }
     });
-    indexer.hooks.hook("message:finalize", async ({ message }) => {
+    indexer$1.hooks.hook("message:finalize", async ({ message }) => {
       const { cursor } = message.finalize;
       if (!cursor) {
         throw new DrizzleStorageError("Finalized Cursor is undefined");
@@ -546,7 +691,7 @@ function drizzleStorage({
         }
       });
     });
-    indexer.hooks.hook("message:invalidate", async ({ message }) => {
+    indexer$1.hooks.hook("message:invalidate", async ({ message }) => {
       const { cursor } = message.invalidate;
       if (!cursor) {
         throw new DrizzleStorageError("Invalidate Cursor is undefined");
@@ -558,15 +703,18 @@ function drizzleStorage({
         }
       });
     });
-    indexer.hooks.hook("handler:middleware", async ({ use }) => {
+    indexer$1.hooks.hook("handler:middleware", async ({ use }) => {
       use(async (context, next) => {
         try {
-          const { endCursor, finality } = context;
+          const { endCursor, finality, cursor } = context;
           if (!endCursor) {
             throw new DrizzleStorageError("End Cursor is undefined");
           }
           await withTransaction(db, async (tx) => {
-            context[DRIZZLE_PROPERTY] = { db: tx };
+            context[constants.DRIZZLE_PROPERTY] = { db: tx };
+            if (prevFinality === "pending") {
+              await invalidate(tx, cursor, idColumn, indexerId);
+            }
             if (finality !== "finalized") {
               await registerTriggers(
                 tx,
@@ -577,14 +725,15 @@ function drizzleStorage({
               );
             }
             await next();
-            delete context[DRIZZLE_PROPERTY];
-            if (enablePersistence) {
+            delete context[constants.DRIZZLE_PROPERTY];
+            if (enablePersistence && finality !== "pending") {
               await persistState({
                 tx,
                 endCursor,
                 indexerId
               });
             }
+            prevFinality = finality;
           });
           if (finality !== "finalized") {
             await removeTriggers(db, tableNames, indexerId);
@@ -600,5 +749,7 @@ function drizzleStorage({
   });
 }
 
+exports.drizzle = drizzle;
 exports.drizzleStorage = drizzleStorage;
+exports.migrate = migrate;
 exports.useDrizzleStorage = useDrizzleStorage;

package/dist/index.d.cts

@@ -1,17 +1,147 @@
 import * as _apibara_indexer_plugins from '@apibara/indexer/plugins';
-import { TablesRelationalConfig, ExtractTablesWithRelations } from 'drizzle-orm';
+import { DrizzleConfig, TablesRelationalConfig, ExtractTablesWithRelations } from 'drizzle-orm';
 import { PgQueryResultHKT, PgTransaction, PgDatabase } from 'drizzle-orm/pg-core';
+import { PGliteOptions, PGlite } from '@electric-sql/pglite';
+import { MigrationConfig } from 'drizzle-orm/migrator';
+import { NodePgDatabase as NodePgDatabase$1 } from 'drizzle-orm/node-postgres';
+import { PgliteDatabase as PgliteDatabase$1 } from 'drizzle-orm/pglite';
+import pg from 'pg';
+
+/**
+ * Union type of all possible drizzle database options
+ */
+type DrizzleOptions = PgliteDrizzleOptions | NodePgDrizzleOptions;
+/**
+ * Configuration options for Node-Postgres database connection
+ */
+type NodePgDrizzleOptions = {
+    /**
+     * Type of database to use -
+     * - "pglite" - PGLite database
+     * - "node-postgres" - Node-Postgres database
+     * @default "pglite"
+     */
+    type: "node-postgres";
+    /**
+     * Connection string to use for the database
+     * @default ""
+     */
+    connectionString?: string;
+    /**
+     * Pool configuration options for Node-Postgres
+     */
+    poolConfig?: pg.PoolConfig;
+    /**
+     * Additional drizzle configuration options
+     */
+    config?: Omit<DrizzleConfig, "schema">;
+};
+/**
+ * Configuration options for PGLite database connection
+ */
+type PgliteDrizzleOptions = {
+    /**
+     * Type of database to use -
+     * - "pglite" - PGLite database
+     * - "node-postgres" - Node-Postgres database
+     */
+    type?: "pglite";
+    /**
+     * Connection string to use for the database
+     * @default process.env["POSTGRES_CONNECTION_STRING"] ?? "memory://pglite"
+     */
+    connectionString?: string;
+    /**
+     * Pool configuration is not supported for PGLite
+     */
+    poolConfig?: never;
+    /**
+     * Additional drizzle configuration options with PGLite specific connection options
+     */
+    config?: Omit<DrizzleConfig, "schema"> & {
+        connection?: (PGliteOptions & {
+            dataDir?: string;
+        }) | string;
+    };
+};
+/**
+ * Extended PGLite database type with client information
+ */
+type PgliteDatabase<TSchema extends Record<string, unknown>> = PgliteDatabase$1<TSchema> & {
+    $client: PGlite;
+};
+/**
+ * Extended Node-Postgres database type with client information
+ */
+type NodePgDatabase<TSchema extends Record<string, unknown>> = NodePgDatabase$1<TSchema> & {
+    $client: pg.Pool;
+};
+type Database<TOptions extends DrizzleOptions, TSchema extends Record<string, unknown>> = TOptions extends PgliteDrizzleOptions ? PgliteDatabase<TSchema> : NodePgDatabase<TSchema>;
+/**
+ * Creates a new Drizzle database instance based on the provided options
+ *
+ * @important connectionString defaults to process.env["POSTGRES_CONNECTION_STRING"], if not set, it defaults to "memory://" (in-memory pglite)
+ *
+ * @param options - Configuration options for the database connection
+ * @returns A configured Drizzle database instance
+ * @throws {Error} If an invalid database type is specified
+ */
+declare function drizzle<TSchema extends Record<string, unknown>, TOptions extends DrizzleOptions>(options?: TOptions & {
+    /**
+     * Schema to use for the database
+     * @default {}
+     */
+    schema?: TSchema;
+}): Database<TOptions, TSchema>;
+/**
+ * Options for database migration
+ */
+type MigrateOptions = MigrationConfig;
+/**
+ * Performs database migration based on the provided configuration
+ * @param db - The database instance to migrate
+ * @param options - Migration configuration options
+ *
+ * @important This function runs migrations on the database instance provided to the `drizzleStorage` plugin.
+ * It automatically detects the type of database and runs the appropriate migrate function
+ * (PGLite or Node-Postgres).
+ *
+ * @example
+ * ```ts
+ * await migrate(db, { migrationsFolder: "./drizzle" });
+ * ```
+ */
+declare function migrate<TSchema extends Record<string, unknown>>(db: PgliteDatabase<TSchema> | NodePgDatabase<TSchema>, options: MigrateOptions): Promise<void>;
 
 type DrizzleStorage<TQueryResult extends PgQueryResultHKT, TFullSchema extends Record<string, unknown> = Record<string, never>, TSchema extends TablesRelationalConfig = ExtractTablesWithRelations<TFullSchema>> = {
     db: PgTransaction<TQueryResult, TFullSchema, TSchema>;
 };
 declare function useDrizzleStorage<TQueryResult extends PgQueryResultHKT, TFullSchema extends Record<string, unknown> = Record<string, never>, TSchema extends TablesRelationalConfig = ExtractTablesWithRelations<TFullSchema>>(_db?: PgDatabase<TQueryResult, TFullSchema, TSchema>): DrizzleStorage<TQueryResult, TFullSchema, TSchema>;
 interface DrizzleStorageOptions<TQueryResult extends PgQueryResultHKT, TFullSchema extends Record<string, unknown> = Record<string, never>, TSchema extends TablesRelationalConfig = ExtractTablesWithRelations<TFullSchema>> {
+    /**
+     * The Drizzle database instance.
+     */
     db: PgDatabase<TQueryResult, TFullSchema, TSchema>;
+    /**
+     * Whether to persist the indexer's state. Defaults to true.
+     */
     persistState?: boolean;
+    /**
+     * The name of the indexer. Default value is 'default'.
+     */
     indexerName?: string;
+    /**
+     * The schema of the database.
+     */
     schema?: Record<string, unknown>;
+    /**
+     * The column to use as the id. Defaults to 'id'.
+     */
     idColumn?: string;
+    /**
+     * The options for the database migration. When provided, the database will automatically run migrations before the indexer runs.
+     */
+    migrate?: MigrateOptions;
 }
 /**
  * Creates a plugin that uses Drizzle as the storage layer.
@@ -22,7 +152,8 @@ interface DrizzleStorageOptions<TQueryResult extends PgQueryResultHKT, TFullSche
  * @param options.indexerName - The name of the indexer. Defaults value is 'default'.
  * @param options.schema - The schema of the database.
  * @param options.idColumn - The column to use as the id. Defaults to 'id'.
+ * @param options.migrate - The options for the database migration. when provided, the database will automatically run migrations before the indexer runs.
  */
-declare function drizzleStorage<TFilter, TBlock, TQueryResult extends PgQueryResultHKT, TFullSchema extends Record<string, unknown> = Record<string, never>, TSchema extends TablesRelationalConfig = ExtractTablesWithRelations<TFullSchema>>({ db, persistState: enablePersistence, indexerName: identifier, schema, idColumn, }: DrizzleStorageOptions<TQueryResult, TFullSchema, TSchema>): _apibara_indexer_plugins.IndexerPlugin<TFilter, TBlock>;
+declare function drizzleStorage<TFilter, TBlock, TQueryResult extends PgQueryResultHKT, TFullSchema extends Record<string, unknown> = Record<string, never>, TSchema extends TablesRelationalConfig = ExtractTablesWithRelations<TFullSchema>>({ db, persistState: enablePersistence, indexerName: identifier, schema, idColumn, migrate: migrateOptions, }: DrizzleStorageOptions<TQueryResult, TFullSchema, TSchema>): _apibara_indexer_plugins.IndexerPlugin<TFilter, TBlock>;
 
-export { type DrizzleStorage, type DrizzleStorageOptions, drizzleStorage, useDrizzleStorage };
+export { type Database, type DrizzleOptions, type DrizzleStorage, type DrizzleStorageOptions, type MigrateOptions, type NodePgDatabase, type NodePgDrizzleOptions, type PgliteDatabase, type PgliteDrizzleOptions, drizzle, drizzleStorage, migrate, useDrizzleStorage };