@ensnode/ensdb-sdk 1.10.1 → 1.11.1

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { EnsIndexerPublicConfig, EnsDbPublicConfig, CrossChainIndexingStatusSnapshot, Unvalidated } from '@ensnode/ensnode-sdk';
+import { EnsDbPublicConfig, IndexingMetadataContext, IndexingMetadataContextInitialized, Unvalidated } from '@ensnode/ensnode-sdk';
+export { IndexingMetadataContext, IndexingMetadataContextInitialized, IndexingMetadataContextStatusCodes, IndexingMetadataContextUninitialized } from '@ensnode/ensnode-sdk';
 import { NodePgDatabase } from 'drizzle-orm/node-postgres';
-import { a as abstractEnsIndexerSchema } from './index-DN0SGSyd.js';
+import { a as abstractEnsIndexerSchema } from './index-C0lByZGy.js';
 import { e as ensNodeSchema } from './index-BHoa233Z.js';
 import 'drizzle-orm/pg-core';
 import 'drizzle-orm';
@@ -152,27 +153,26 @@ declare class EnsDbReader<ConcreteEnsIndexerSchema extends AbstractEnsIndexerSch
      */
     get ensNodeSchema(): EnsNodeSchema;
     /**
-     * Get ENSDb Version
-     *
-     * @returns the existing record, or `undefined`.
+     * Check if the ENSDb instance is healthy by running a simple query
+     * against it.
      */
-    getEnsDbVersion(): Promise<string | undefined>;
+    isHealthy(): Promise<boolean>;
     /**
-     * Get ENSIndexer Public Config
-     *
-     * @returns the existing record, or `undefined`.
+     * Check if the ENSDb instance is ready by verifying that
+     * the {@link IndexingMetadataContext} has been initialized for
+     * the ENSIndexer Schema used by this ENSDbReader instance.
      */
-    getEnsIndexerPublicConfig(): Promise<EnsIndexerPublicConfig | undefined>;
+    isReady(): Promise<boolean>;
     /**
      * Build ENSDb Public Config
      */
     buildEnsDbPublicConfig(): Promise<EnsDbPublicConfig>;
     /**
-     * Get Indexing Status Snapshot
+     * Get Indexing Metadata Context
      *
-     * @returns the existing record, or `undefined`.
+     * @returns the initialized record, or a default uninitialized one if no record exists in ENSDb.
      */
-    getIndexingStatusSnapshot(): Promise<CrossChainIndexingStatusSnapshot | undefined>;
+    getIndexingMetadataContext(): Promise<IndexingMetadataContext>;
     /**
      * Get ENSNode Metadata record
      *
@@ -205,32 +205,31 @@ declare class EnsDbReader<ConcreteEnsIndexerSchema extends AbstractEnsIndexerSch
  * - updating ENSNode Metadata records in ENSDb for the given ENSIndexer instance.
  */
 declare class EnsDbWriter extends EnsDbReader {
+    /**
+     * Stable arbitrary lock ID for ENSNode Schema migrations to
+     * prevent concurrent migration execution across multiple ENSIndexer instances.
+     */
+    private static readonly MIGRATION_LOCK_ID;
     /**
      * Execute pending database migrations for ENSNode Schema in ENSDb.
      *
+     * This function is:
+     * - idempotent and can be safely executed multiple times,
+     * - safe to execute concurrently across multiple ENSIndexer instances,
+     *   as it uses a stable arbitrary advisory lock to prevent concurrent
+     *   execution of migrations.
+     *
      * @param migrationsDirPath - The file path to the directory containing
      *                            database migration files for ENSNode Schema.
      * @throws error when migration execution fails.
      */
     migrateEnsNodeSchema(migrationsDirPath: string): Promise<void>;
     /**
-     * Upsert ENSDb Version
-     *
-     * @throws when upsert operation failed.
-     */
-    upsertEnsDbVersion(ensDbVersion: string): Promise<void>;
-    /**
-     * Upsert ENSIndexer Public Config
+     * Upsert Indexing Metadata Context Initialized
      *
      * @throws when upsert operation failed.
      */
-    upsertEnsIndexerPublicConfig(ensIndexerPublicConfig: EnsIndexerPublicConfig): Promise<void>;
-    /**
-     * Upsert Indexing Status Snapshot
-     *
-     * @throws when upsert operation failed.
-     */
-    upsertIndexingStatusSnapshot(indexingStatus: CrossChainIndexingStatusSnapshot): Promise<void>;
+    upsertIndexingMetadataContext(indexingMetadataContext: IndexingMetadataContextInitialized): Promise<void>;
     /**
      * Upsert ENSNode metadata
      *
@@ -243,29 +242,28 @@ declare class EnsDbWriter extends EnsDbReader {
  * Keys used to distinguish records in `ensnode_metadata` table in the ENSDb.
  */
 declare const EnsNodeMetadataKeys: {
-    readonly EnsDbVersion: "ensdb_version";
-    readonly EnsIndexerPublicConfig: "ensindexer_public_config";
-    readonly EnsIndexerIndexingStatus: "ensindexer_indexing_status";
+    readonly IndexingMetadataContext: "indexing_metadata_context";
 };
 type EnsNodeMetadataKey = (typeof EnsNodeMetadataKeys)[keyof typeof EnsNodeMetadataKeys];
-interface EnsNodeMetadataEnsDbVersion {
-    key: typeof EnsNodeMetadataKeys.EnsDbVersion;
-    value: string;
-}
-interface EnsNodeMetadataEnsIndexerPublicConfig {
-    key: typeof EnsNodeMetadataKeys.EnsIndexerPublicConfig;
-    value: EnsIndexerPublicConfig;
-}
-interface EnsNodeMetadataEnsIndexerIndexingStatus {
-    key: typeof EnsNodeMetadataKeys.EnsIndexerIndexingStatus;
-    value: CrossChainIndexingStatusSnapshot;
+/**
+ * ENSNode Metadata record for Indexing Metadata Context
+ *
+ * This record is used to store the Indexing Metadata Context in
+ * ENSNode Metadata table for each ENSIndexer instance.
+ */
+interface EnsNodeMetadataIndexingMetadataContext {
+    key: typeof EnsNodeMetadataKeys.IndexingMetadataContext;
+    value: IndexingMetadataContextInitialized;
 }
 /**
  * ENSNode Metadata
  *
- * Union type gathering all variants of ENSNode Metadata.
+ * Type alias for ENSNode Metadata records,
+ * currently only includes the record for Indexing Metadata Context,
+ * but can be extended in the future to include more types of
+ * ENSNode Metadata records as needed.
  */
-type EnsNodeMetadata = EnsNodeMetadataEnsDbVersion | EnsNodeMetadataEnsIndexerPublicConfig | EnsNodeMetadataEnsIndexerIndexingStatus;
+type EnsNodeMetadata = EnsNodeMetadataIndexingMetadataContext;
 
 /**
  * Validate ENSDb config
@@ -276,4 +274,4 @@ type EnsNodeMetadata = EnsNodeMetadataEnsDbVersion | EnsNodeMetadataEnsIndexerPu
  */
 declare function validateEnsDbConfig(unvalidatedConfig: Unvalidated<EnsDbConfig>): EnsDbConfig;
 
-export { ENSDB_CONNECTION_OPTIONS, ENSDB_SCHEMA_CHECKSUM, type EnsDbConfig, type EnsDbDrizzleClient, EnsDbReader, EnsDbWriter, type EnsNodeMetadata, type EnsNodeMetadataEnsDbVersion, type EnsNodeMetadataEnsIndexerIndexingStatus, type EnsNodeMetadataEnsIndexerPublicConfig, type EnsNodeMetadataKey, EnsNodeMetadataKeys, validateEnsDbConfig };
+export { ENSDB_CONNECTION_OPTIONS, ENSDB_SCHEMA_CHECKSUM, type EnsDbConfig, type EnsDbDrizzleClient, EnsDbReader, EnsDbWriter, type EnsNodeMetadata, type EnsNodeMetadataIndexingMetadataContext, type EnsNodeMetadataKey, EnsNodeMetadataKeys, validateEnsDbConfig };