@ensnode/ensnode-sdk 0.0.0-next-20260429174842 → 0.0.0-next-20260429191816

package/dist/index.cjs

@@ -48,6 +48,7 @@ __export(index_exports, {
   EnsIndexerIndexingStatusResponseCodes: () => EnsIndexerIndexingStatusResponseCodes,
   EnsNodeClient: () => EnsNodeClient,
   ForwardResolutionProtocolStep: () => ForwardResolutionProtocolStep,
+  IndexingMetadataContextStatusCodes: () => IndexingMetadataContextStatusCodes,
   IndexingStatusResponseCodes: () => IndexingStatusResponseCodes,
   LruCache: () => LruCache,
   NFTMintStatuses: () => NFTMintStatuses,
@@ -86,6 +87,8 @@ __export(index_exports, {
   buildEnsNodeStackInfo: () => buildEnsNodeStackInfo,
   buildEnsRainbowClientLabelSet: () => buildEnsRainbowClientLabelSet,
   buildIndexedBlockranges: () => buildIndexedBlockranges,
+  buildIndexingMetadataContextInitialized: () => buildIndexingMetadataContextInitialized,
+  buildIndexingMetadataContextUninitialized: () => buildIndexingMetadataContextUninitialized,
   buildLabelSetId: () => buildLabelSetId,
   buildLabelSetVersion: () => buildLabelSetVersion,
   buildOmnichainIndexingStatusSnapshot: () => buildOmnichainIndexingStatusSnapshot,
@@ -122,6 +125,7 @@ __export(index_exports, {
   deserializeEnsIndexerStackInfo: () => deserializeEnsIndexerStackInfo,
   deserializeEnsNodeStackInfo: () => deserializeEnsNodeStackInfo,
   deserializeErrorResponse: () => deserializeErrorResponse2,
+  deserializeIndexingMetadataContext: () => deserializeIndexingMetadataContext,
   deserializeIndexingStatusResponse: () => deserializeIndexingStatusResponse,
   deserializeOmnichainIndexingStatusSnapshot: () => deserializeOmnichainIndexingStatusSnapshot,
   deserializePriceDai: () => deserializePriceDai,
@@ -228,6 +232,8 @@ __export(index_exports, {
   serializeEnsIndexerStackInfo: () => serializeEnsIndexerStackInfo,
   serializeEnsNodeStackInfo: () => serializeEnsNodeStackInfo,
   serializeIndexedChainIds: () => serializeIndexedChainIds,
+  serializeIndexingMetadataContext: () => serializeIndexingMetadataContext,
+  serializeIndexingMetadataContextInitialized: () => serializeIndexingMetadataContextInitialized,
   serializeIndexingStatusResponse: () => serializeIndexingStatusResponse,
   serializeNameToken: () => serializeNameToken,
   serializeNameTokensResponse: () => serializeNameTokensResponse,
@@ -256,6 +262,7 @@ __export(index_exports, {
   validateEnsIndexerStackInfo: () => validateEnsIndexerStackInfo,
   validateEnsIndexerVersionInfo: () => validateEnsIndexerVersionInfo,
   validateEnsNodeStackInfo: () => validateEnsNodeStackInfo,
+  validateIndexingMetadataContextInitialized: () => validateIndexingMetadataContextInitialized,
   validateOmnichainIndexingStatusSnapshot: () => validateOmnichainIndexingStatusSnapshot,
   validateRealtimeIndexingStatusProjection: () => validateRealtimeIndexingStatusProjection,
   validateSupportedLabelSetAndVersion: () => validateSupportedLabelSetAndVersion
@@ -4093,41 +4100,8 @@ var EnsNodeClient = class _EnsNodeClient {
   }
 };
 
-// src/identity/identity.ts
-var import_datasources6 = require("@ensnode/datasources");
-
-// src/identity/types.ts
-var ResolutionStatusIds = {
-  /**
-   * Represents that the `Identity` is not resolved yet.
-   */
-  Unresolved: "unresolved",
-  /**
-   * Represents that resolution of the `Identity` resulted in a named identity.
-   */
-  Named: "named",
-  /**
-   * Represents that resolution of the `Identity` resulted in an unnamed identity.
-   */
-  Unnamed: "unnamed",
-  /**
-   * Represents that attempted resolution of the `Identity` resulted in an error
-   * and therefore it is unknown if the `Identity` resolves to a named or unnamed identity.
-   */
-  Unknown: "unknown"
-};
-
-// src/identity/identity.ts
-function buildUnresolvedIdentity(address, namespaceId, chainId) {
-  return {
-    resolutionStatus: ResolutionStatusIds.Unresolved,
-    chainId: chainId ?? (0, import_datasources6.getENSRootChainId)(namespaceId),
-    address
-  };
-}
-function isResolvedIdentity(identity) {
-  return identity.resolutionStatus !== ResolutionStatusIds.Unresolved;
-}
+// src/ensnode/metadata/deserialize/indexing-metadata-context.ts
+var import_v446 = require("zod/v4");
 
 // src/indexing-status/deserialize/chain-indexing-status-snapshot.ts
 var import_v439 = require("zod/v4");
@@ -4180,6 +4154,221 @@ ${(0, import_v441.prettifyError)(parsed.error)}
   return parsed.data;
 }
 
+// src/stack-info/validate/ensindexer-stack-info.ts
+var import_v442 = require("zod/v4");
+function validateEnsIndexerStackInfo(maybeStackInfo, valueLabel) {
+  const parsed = makeEnsIndexerStackInfoSchema(valueLabel).safeParse(maybeStackInfo);
+  if (parsed.error) {
+    throw new Error(`Cannot validate EnsIndexerStackInfo:
+${(0, import_v442.prettifyError)(parsed.error)}
+`);
+  }
+  return parsed.data;
+}
+
+// src/stack-info/ensindexer-stack-info.ts
+function buildEnsIndexerStackInfo(ensDbPublicConfig, ensIndexerPublicConfig, ensRainbowPublicConfig) {
+  return validateEnsIndexerStackInfo({
+    ensDb: ensDbPublicConfig,
+    ensIndexer: ensIndexerPublicConfig,
+    ensRainbow: ensRainbowPublicConfig
+  });
+}
+
+// src/stack-info/validate/ensnode-stack-info.ts
+var import_v443 = require("zod/v4");
+function validateEnsNodeStackInfo(maybeStackInfo, valueLabel) {
+  const parsed = makeEnsNodeStackInfoSchema(valueLabel).safeParse(maybeStackInfo);
+  if (parsed.error) {
+    throw new Error(`Cannot validate EnsNodeStackInfo:
+${(0, import_v443.prettifyError)(parsed.error)}
+`);
+  }
+  return parsed.data;
+}
+
+// src/stack-info/ensnode-stack-info.ts
+function buildEnsNodeStackInfo(ensApiPublicConfig, ensDbPublicConfig, ensIndexerPublicConfig, ensRainbowPublicConfig) {
+  return validateEnsNodeStackInfo({
+    ...buildEnsIndexerStackInfo(ensDbPublicConfig, ensIndexerPublicConfig, ensRainbowPublicConfig),
+    ensApi: ensApiPublicConfig
+  });
+}
+
+// src/ensnode/metadata/validate/indexing-metadata-context.ts
+var import_v445 = require("zod/v4");
+
+// src/ensnode/metadata/zod-schemas/indexing-metadata-context.ts
+var import_v444 = require("zod/v4");
+var makeSerializedIndexingMetadataContextUninitializedSchema = (valueLabel) => {
+  const label = valueLabel ?? "SerializedIndexingMetadataContextUninitialized";
+  return import_v444.z.object({
+    statusCode: import_v444.z.literal(IndexingMetadataContextStatusCodes.Uninitialized, {
+      error: `${label} must have status code ${IndexingMetadataContextStatusCodes.Uninitialized}`
+    })
+  });
+};
+var makeSerializedIndexingMetadataContextInitializedSchema = (valueLabel) => {
+  const label = valueLabel ?? "SerializedIndexingMetadataContextInitialized";
+  return import_v444.z.object({
+    statusCode: import_v444.z.literal(IndexingMetadataContextStatusCodes.Initialized, {
+      error: `${label} must have status code ${IndexingMetadataContextStatusCodes.Initialized}`
+    }),
+    indexingStatus: makeSerializedCrossChainIndexingStatusSnapshotSchema(`${label}.indexingStatus`),
+    stackInfo: makeSerializedEnsIndexerStackInfoSchema(`${label}.stackInfo`)
+  });
+};
+var makeSerializedIndexingMetadataContextSchema = (valueLabel) => {
+  const label = valueLabel ?? "SerializedIndexingMetadataContext";
+  return import_v444.z.discriminatedUnion("statusCode", [
+    makeSerializedIndexingMetadataContextUninitializedSchema(label),
+    makeSerializedIndexingMetadataContextInitializedSchema(label)
+  ]);
+};
+var makeIndexingMetadataContextUninitializedSchema = makeSerializedIndexingMetadataContextUninitializedSchema;
+var makeIndexingMetadataContextInitializedSchema = (valueLabel) => {
+  const label = valueLabel ?? "IndexingMetadataContextInitialized";
+  return import_v444.z.object({
+    statusCode: import_v444.z.literal(IndexingMetadataContextStatusCodes.Initialized, {
+      error: `${label} must have status code ${IndexingMetadataContextStatusCodes.Initialized}`
+    }),
+    indexingStatus: makeCrossChainIndexingStatusSnapshotSchema(`${label}.indexingStatus`),
+    stackInfo: makeEnsIndexerStackInfoSchema(`${label}.stackInfo`)
+  });
+};
+var makeIndexingMetadataContextSchema = (valueLabel) => {
+  const label = valueLabel ?? "IndexingMetadataContext";
+  return import_v444.z.discriminatedUnion("statusCode", [
+    makeIndexingMetadataContextUninitializedSchema(label),
+    makeIndexingMetadataContextInitializedSchema(label)
+  ]);
+};
+
+// src/ensnode/metadata/validate/indexing-metadata-context.ts
+function validateIndexingMetadataContextInitialized(maybeIndexingMetadataContext, valueLabel) {
+  const label = valueLabel ?? "IndexingMetadataContextInitialized";
+  const result = makeIndexingMetadataContextInitializedSchema(label).safeParse(
+    maybeIndexingMetadataContext
+  );
+  if (result.error) {
+    throw new Error(`Cannot validate ${label}:
+${(0, import_v445.prettifyError)(result.error)}
+`);
+  }
+  return result.data;
+}
+
+// src/ensnode/metadata/indexing-metadata-context.ts
+var IndexingMetadataContextStatusCodes = {
+  /**
+   * Represents that no indexing metadata context has been initialized
+   * for the ENSIndexer Schema Name in the ENSNode Metadata table in ENSDb.
+   */
+  Uninitialized: "uninitialized",
+  /**
+   * Represents that the indexing metadata context has been initialized
+   * for the ENSIndexer Schema Name in the ENSNode Metadata table in ENSDb.
+   */
+  Initialized: "initialized"
+};
+function buildIndexingMetadataContextUninitialized() {
+  return {
+    statusCode: IndexingMetadataContextStatusCodes.Uninitialized
+  };
+}
+function buildIndexingMetadataContextInitialized(indexingStatus, stackInfo) {
+  return validateIndexingMetadataContextInitialized({
+    statusCode: IndexingMetadataContextStatusCodes.Initialized,
+    indexingStatus,
+    stackInfo
+  });
+}
+
+// src/ensnode/metadata/deserialize/indexing-metadata-context.ts
+function buildUnvalidatedIndexingMetadataContextInitialized(serializedIndexingMetadataContext) {
+  return {
+    statusCode: serializedIndexingMetadataContext.statusCode,
+    indexingStatus: buildUnvalidatedCrossChainIndexingStatusSnapshot(
+      serializedIndexingMetadataContext.indexingStatus
+    ),
+    stackInfo: buildUnvalidatedEnsIndexerStackInfo(serializedIndexingMetadataContext.stackInfo)
+  };
+}
+function buildUnvalidatedIndexingMetadataContext(serializedIndexingMetadataContext) {
+  switch (serializedIndexingMetadataContext.statusCode) {
+    case IndexingMetadataContextStatusCodes.Uninitialized:
+      return serializedIndexingMetadataContext;
+    case IndexingMetadataContextStatusCodes.Initialized:
+      return buildUnvalidatedIndexingMetadataContextInitialized(serializedIndexingMetadataContext);
+  }
+}
+function deserializeIndexingMetadataContext(serializedIndexingMetadataContext, valueLabel) {
+  const label = valueLabel ?? "IndexingMetadataContext";
+  const parsed = makeSerializedIndexingMetadataContextSchema(label).transform(buildUnvalidatedIndexingMetadataContext).pipe(makeIndexingMetadataContextSchema(label)).safeParse(serializedIndexingMetadataContext);
+  if (parsed.error) {
+    throw new Error(
+      `Cannot deserialize IndexingMetadataContext:
+${(0, import_v446.prettifyError)(parsed.error)}
+`
+    );
+  }
+  return parsed.data;
+}
+
+// src/ensnode/metadata/serialize/indexing-metadata-context.ts
+function serializeIndexingMetadataContextInitialized(context) {
+  const { statusCode, indexingStatus, stackInfo } = context;
+  return {
+    statusCode,
+    indexingStatus: serializeCrossChainIndexingStatusSnapshot(indexingStatus),
+    stackInfo: serializeEnsIndexerStackInfo(stackInfo)
+  };
+}
+function serializeIndexingMetadataContext(context) {
+  switch (context.statusCode) {
+    case IndexingMetadataContextStatusCodes.Uninitialized:
+      return context;
+    case IndexingMetadataContextStatusCodes.Initialized:
+      return serializeIndexingMetadataContextInitialized(context);
+  }
+}
+
+// src/identity/identity.ts
+var import_datasources6 = require("@ensnode/datasources");
+
+// src/identity/types.ts
+var ResolutionStatusIds = {
+  /**
+   * Represents that the `Identity` is not resolved yet.
+   */
+  Unresolved: "unresolved",
+  /**
+   * Represents that resolution of the `Identity` resulted in a named identity.
+   */
+  Named: "named",
+  /**
+   * Represents that resolution of the `Identity` resulted in an unnamed identity.
+   */
+  Unnamed: "unnamed",
+  /**
+   * Represents that attempted resolution of the `Identity` resulted in an error
+   * and therefore it is unknown if the `Identity` resolves to a named or unnamed identity.
+   */
+  Unknown: "unknown"
+};
+
+// src/identity/identity.ts
+function buildUnresolvedIdentity(address, namespaceId, chainId) {
+  return {
+    resolutionStatus: ResolutionStatusIds.Unresolved,
+    chainId: chainId ?? (0, import_datasources6.getENSRootChainId)(namespaceId),
+    address
+  };
+}
+function isResolvedIdentity(identity) {
+  return identity.resolutionStatus !== ResolutionStatusIds.Unresolved;
+}
+
 // src/omnigraph-api/prerequisites.ts
 function hasOmnigraphApiConfigSupport(config) {
   const supported = config.plugins.includes("ensv2" /* ENSv2 */);
@@ -4277,13 +4466,13 @@ var import_getUnixTime2 = require("date-fns/getUnixTime");
 var import_getUnixTime = require("date-fns/getUnixTime");
 
 // src/shared/deserialize.ts
-var import_v442 = __toESM(require("zod/v4"), 1);
+var import_v447 = __toESM(require("zod/v4"), 1);
 function deserializeChainId(maybeChainId, valueLabel) {
   const schema = makeChainIdStringSchema(valueLabel);
   const parsed = schema.safeParse(maybeChainId);
   if (parsed.error) {
     throw new Error(`Cannot deserialize ChainId:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4293,7 +4482,7 @@ function deserializeDatetime(maybeDatetime, valueLabel) {
   const parsed = schema.safeParse(maybeDatetime);
   if (parsed.error) {
     throw new Error(`Cannot deserialize Datetime:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4303,7 +4492,7 @@ function deserializeUnixTimestamp(maybeTimestamp, valueLabel) {
   const parsed = schema.safeParse(maybeTimestamp);
   if (parsed.error) {
     throw new Error(`Cannot deserialize Unix Timestamp:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4313,7 +4502,7 @@ function deserializeUrl(maybeUrl, valueLabel) {
   const parsed = schema.safeParse(maybeUrl);
   if (parsed.error) {
     throw new Error(`Cannot deserialize URL:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4323,7 +4512,7 @@ function deserializeBlockNumber(maybeBlockNumber, valueLabel) {
   const parsed = schema.safeParse(maybeBlockNumber);
   if (parsed.error) {
     throw new Error(`Cannot deserialize BlockNumber:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4333,17 +4522,17 @@ function deserializeBlockRef(maybeBlockRef, valueLabel) {
   const parsed = schema.safeParse(maybeBlockRef);
   if (parsed.error) {
     throw new Error(`Cannot deserialize BlockRef:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
 }
 function deserializeDuration(maybeDuration, valueLabel) {
-  const schema = import_v442.default.coerce.number().pipe(makeDurationSchema(valueLabel));
+  const schema = import_v447.default.coerce.number().pipe(makeDurationSchema(valueLabel));
   const parsed = schema.safeParse(maybeDuration);
   if (parsed.error) {
     throw new RangeError(`Cannot deserialize Duration:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4353,7 +4542,7 @@ function parseAccountId(maybeAccountId, valueLabel) {
   const parsed = schema.safeParse(maybeAccountId);
   if (parsed.error) {
     throw new RangeError(`Cannot deserialize AccountId:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4363,7 +4552,7 @@ function deserializePriceEth(maybePrice, valueLabel) {
   const parsed = schema.safeParse(maybePrice);
   if (parsed.error) {
     throw new Error(`Cannot deserialize PriceEth:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4373,7 +4562,7 @@ function deserializePriceUsdc(maybePrice, valueLabel) {
   const parsed = schema.safeParse(maybePrice);
   if (parsed.error) {
     throw new Error(`Cannot deserialize PriceUsdc:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4383,7 +4572,7 @@ function deserializePriceDai(maybePrice, valueLabel) {
   const parsed = schema.safeParse(maybePrice);
   if (parsed.error) {
     throw new Error(`Cannot deserialize PriceDai:
-${(0, import_v442.prettifyError)(parsed.error)}
+${(0, import_v447.prettifyError)(parsed.error)}
 `);
   }
   return parsed.data;
@@ -4827,47 +5016,6 @@ function isWebSocketProtocol(url) {
   return ["ws:", "wss:"].includes(url.protocol);
 }
 
-// src/stack-info/validate/ensindexer-stack-info.ts
-var import_v443 = require("zod/v4");
-function validateEnsIndexerStackInfo(maybeStackInfo, valueLabel) {
-  const parsed = makeEnsIndexerStackInfoSchema(valueLabel).safeParse(maybeStackInfo);
-  if (parsed.error) {
-    throw new Error(`Cannot validate EnsIndexerStackInfo:
-${(0, import_v443.prettifyError)(parsed.error)}
-`);
-  }
-  return parsed.data;
-}
-
-// src/stack-info/ensindexer-stack-info.ts
-function buildEnsIndexerStackInfo(ensDbPublicConfig, ensIndexerPublicConfig, ensRainbowPublicConfig) {
-  return validateEnsIndexerStackInfo({
-    ensDb: ensDbPublicConfig,
-    ensIndexer: ensIndexerPublicConfig,
-    ensRainbow: ensRainbowPublicConfig
-  });
-}
-
-// src/stack-info/validate/ensnode-stack-info.ts
-var import_v444 = require("zod/v4");
-function validateEnsNodeStackInfo(maybeStackInfo, valueLabel) {
-  const parsed = makeEnsNodeStackInfoSchema(valueLabel).safeParse(maybeStackInfo);
-  if (parsed.error) {
-    throw new Error(`Cannot validate EnsNodeStackInfo:
-${(0, import_v444.prettifyError)(parsed.error)}
-`);
-  }
-  return parsed.data;
-}
-
-// src/stack-info/ensnode-stack-info.ts
-function buildEnsNodeStackInfo(ensApiPublicConfig, ensDbPublicConfig, ensIndexerPublicConfig, ensRainbowPublicConfig) {
-  return validateEnsNodeStackInfo({
-    ...buildEnsIndexerStackInfo(ensDbPublicConfig, ensIndexerPublicConfig, ensRainbowPublicConfig),
-    ensApi: ensApiPublicConfig
-  });
-}
-
 // src/subgraph-api/prerequisites.ts
 function hasSubgraphApiConfigSupport(config) {
   const supported = config.plugins.includes("subgraph" /* Subgraph */);