@ensnode/ensnode-sdk 0.0.0-next-20260227190633 → 0.0.0-next-20260228175526

package/dist/index.cjs

@@ -36,7 +36,6 @@ __export(index_exports, {
   ATTR_PROTOCOL_STEP_RESULT: () => ATTR_PROTOCOL_STEP_RESULT,
   AssetNamespaces: () => AssetNamespaces,
   BASENAMES_NODE: () => BASENAMES_NODE,
-  BlockRefRangeTypeIds: () => BlockRefRangeTypeIds,
   ChainIndexingStatusIds: () => ChainIndexingStatusIds,
   ClientError: () => ClientError,
   CrossChainIndexingStrategyIds: () => CrossChainIndexingStrategyIds,
@@ -75,6 +74,7 @@ __export(index_exports, {
   RECORDS_PER_PAGE_MAX: () => RECORDS_PER_PAGE_MAX,
   ROOT_NODE: () => ROOT_NODE,
   ROOT_RESOURCE: () => ROOT_RESOURCE,
+  RangeTypeIds: () => RangeTypeIds,
   RegistrarActionTypes: () => RegistrarActionTypes,
   RegistrarActionsFilterTypes: () => RegistrarActionsFilterTypes,
   RegistrarActionsOrders: () => RegistrarActionsOrders,
@@ -96,6 +96,8 @@ __export(index_exports, {
   bigIntToNumber: () => bigIntToNumber,
   bigintToCoinType: () => bigintToCoinType,
   buildAssetId: () => buildAssetId,
+  buildBlockNumberRange: () => buildBlockNumberRange,
+  buildBlockRefRange: () => buildBlockRefRange,
   buildEncodedReferrer: () => buildEncodedReferrer,
   buildEnsRainbowClientLabelSet: () => buildEnsRainbowClientLabelSet,
   buildLabelSetId: () => buildLabelSetId,
@@ -113,7 +115,6 @@ __export(index_exports, {
   coinTypeReverseLabel: () => coinTypeReverseLabel,
   coinTypeToEvmChainId: () => coinTypeToEvmChainId,
   constructSubInterpretedName: () => constructSubInterpretedName,
-  createIndexingConfig: () => createIndexingConfig,
   createRealtimeIndexingStatusProjection: () => createRealtimeIndexingStatusProjection,
   decodeDNSEncodedLiteralName: () => decodeDNSEncodedLiteralName,
   decodeDNSEncodedName: () => decodeDNSEncodedName,
@@ -121,7 +122,6 @@ __export(index_exports, {
   deserializeAssetId: () => deserializeAssetId,
   deserializeBlockNumber: () => deserializeBlockNumber,
   deserializeBlockRef: () => deserializeBlockRef,
-  deserializeBlockrange: () => deserializeBlockrange,
   deserializeChainId: () => deserializeChainId,
   deserializeChainIndexingStatusSnapshot: () => deserializeChainIndexingStatusSnapshot,
   deserializeConfigResponse: () => deserializeConfigResponse,
@@ -742,23 +742,6 @@ var makeUrlSchema = (valueLabel = "Value") => import_v4.z.url({
   abort: true
 }).transform((v) => new URL(v));
 var makeBlockNumberSchema = (valueLabel = "Block number") => makeNonNegativeIntegerSchema(valueLabel);
-var makeBlockrangeSchema = (valueLabel = "Value") => import_v4.z.strictObject(
-  {
-    startBlock: makeBlockNumberSchema(`${valueLabel}.startBlock`).optional(),
-    endBlock: makeBlockNumberSchema(`${valueLabel}.endBlock`).optional()
-  },
-  {
-    error: `${valueLabel} must be a valid Blockrange object.`
-  }
-).refine(
-  (v) => {
-    if (v.startBlock && v.endBlock) {
-      return v.startBlock <= v.endBlock;
-    }
-    return true;
-  },
-  { error: `${valueLabel}: startBlock must be before or equal to endBlock` }
-);
 var makeBlockRefSchema = (valueLabel = "Value") => import_v4.z.strictObject(
   {
     timestamp: makeUnixTimestampSchema(`${valueLabel}.timestamp`),
@@ -1100,17 +1083,88 @@ var import_v410 = require("zod/v4");
 // src/indexing-status/zod-schema/cross-chain-indexing-status-snapshot.ts
 var import_v49 = require("zod/v4");
 
-// src/indexing-status/chain-indexing-status-snapshot.ts
-var BlockRefRangeTypeIds = {
-  /**
-   * Represents that indexing of the chain should be performed for an indefinite range.
-   */
-  Indefinite: "indefinite",
-  /**
-   * Represents that indexing of the chain should be performed for a definite range.
-   */
-  Definite: "definite"
+// src/shared/block-ref.ts
+function isBefore(blockA, blockB) {
+  return blockA.number < blockB.number && blockA.timestamp < blockB.timestamp;
+}
+function isEqualTo(blockA, blockB) {
+  return blockA.number === blockB.number && blockA.timestamp === blockB.timestamp;
+}
+function isBeforeOrEqualTo(blockA, blockB) {
+  return isBefore(blockA, blockB) || isEqualTo(blockA, blockB);
+}
+
+// src/shared/blockrange.ts
+var RangeTypeIds = {
+  Unbounded: "unbounded",
+  LeftBounded: "left-bounded",
+  RightBounded: "right-bounded",
+  Bounded: "bounded"
 };
+function buildBlockNumberRange(startBlock, endBlock) {
+  if (startBlock === void 0 && endBlock === void 0) {
+    return {
+      rangeType: RangeTypeIds.Unbounded
+    };
+  }
+  if (startBlock !== void 0 && endBlock === void 0) {
+    return {
+      rangeType: RangeTypeIds.LeftBounded,
+      startBlock
+    };
+  }
+  if (startBlock === void 0 && endBlock !== void 0) {
+    return {
+      rangeType: RangeTypeIds.RightBounded,
+      endBlock
+    };
+  }
+  if (startBlock !== void 0 && endBlock !== void 0) {
+    if (startBlock > endBlock) {
+      throw new Error(
+        `For a block number range startBlock must be lower than or equal to endBlock.`
+      );
+    }
+    return {
+      rangeType: RangeTypeIds.Bounded,
+      startBlock,
+      endBlock
+    };
+  }
+  throw new Error("Invalid block number range. This should be unreachable.");
+}
+function buildBlockRefRange(startBlock, endBlock) {
+  if (startBlock === void 0 && endBlock === void 0) {
+    return {
+      rangeType: RangeTypeIds.Unbounded
+    };
+  }
+  if (startBlock !== void 0 && endBlock === void 0) {
+    return {
+      rangeType: RangeTypeIds.LeftBounded,
+      startBlock
+    };
+  }
+  if (startBlock === void 0 && endBlock !== void 0) {
+    return {
+      rangeType: RangeTypeIds.RightBounded,
+      endBlock
+    };
+  }
+  if (startBlock !== void 0 && endBlock !== void 0) {
+    if (isBeforeOrEqualTo(startBlock, endBlock) === false) {
+      throw new Error(`For a block ref range startBlock must be before or equal to endBlock.`);
+    }
+    return {
+      rangeType: RangeTypeIds.Bounded,
+      startBlock,
+      endBlock
+    };
+  }
+  throw new Error("Invalid block ref range. This should be unreachable.");
+}
+
+// src/indexing-status/chain-indexing-status-snapshot.ts
 var ChainIndexingStatusIds = {
   /**
    * Represents that indexing of the chain is not ready to begin yet because:
@@ -1142,19 +1196,6 @@ var ChainIndexingStatusIds = {
    */
   Completed: "chain-completed"
 };
-function createIndexingConfig(startBlock, endBlock) {
-  if (endBlock) {
-    return {
-      blockRangeType: BlockRefRangeTypeIds.Definite,
-      startBlock,
-      endBlock
-    };
-  }
-  return {
-    blockRangeType: BlockRefRangeTypeIds.Indefinite,
-    startBlock
-  };
-}
 function getTimestampForLowestOmnichainStartBlock(chains) {
   const earliestKnownBlockTimestamps = chains.map(
     (chain) => chain.config.startBlock.timestamp
@@ -1171,7 +1212,7 @@ function getTimestampForHighestOmnichainKnownBlock(chains) {
   for (const chain of chains) {
     switch (chain.chainStatus) {
       case ChainIndexingStatusIds.Queued:
-        if (chain.config.blockRangeType === BlockRefRangeTypeIds.Definite) {
+        if (chain.config.rangeType === RangeTypeIds.Bounded) {
           latestKnownBlockTimestamps.push(chain.config.endBlock.timestamp);
         }
         break;
@@ -1314,22 +1355,9 @@ function getOmnichainIndexingCursor(chains) {
 
 // src/indexing-status/zod-schema/chain-indexing-status-snapshot.ts
 var import_v47 = require("zod/v4");
-
-// src/shared/block-ref.ts
-function isBefore(blockA, blockB) {
-  return blockA.number < blockB.number && blockA.timestamp < blockB.timestamp;
-}
-function isEqualTo(blockA, blockB) {
-  return blockA.number === blockB.number && blockA.timestamp === blockB.timestamp;
-}
-function isBeforeOrEqualTo(blockA, blockB) {
-  return isBefore(blockA, blockB) || isEqualTo(blockA, blockB);
-}
-
-// src/indexing-status/zod-schema/chain-indexing-status-snapshot.ts
 function invariant_chainSnapshotQueuedBlocks(ctx) {
   const { config } = ctx.value;
-  if (config.blockRangeType === BlockRefRangeTypeIds.Indefinite) {
+  if (config.rangeType === RangeTypeIds.LeftBounded) {
     return;
   }
   if (isBeforeOrEqualTo(config.startBlock, config.endBlock) === false) {
@@ -1356,7 +1384,7 @@ function invariant_chainSnapshotBackfillBlocks(ctx) {
       message: "`latestIndexedBlock` must be before or same as `backfillEndBlock`."
     });
   }
-  if (config.blockRangeType === BlockRefRangeTypeIds.Indefinite) {
+  if (config.rangeType === RangeTypeIds.LeftBounded) {
     return;
   }
   if (isEqualTo(backfillEndBlock, config.endBlock) === false) {
@@ -1401,31 +1429,40 @@ function invariant_chainSnapshotFollowingBlocks(ctx) {
     });
   }
 }
-var makeBlockRefRangeSchema = (valueLabel = "Value") => import_v47.z.discriminatedUnion("blockRangeType", [
-  import_v47.z.object({
-    blockRangeType: import_v47.z.literal(BlockRefRangeTypeIds.Indefinite),
-    startBlock: makeBlockRefSchema(valueLabel)
-  }),
-  import_v47.z.object({
-    blockRangeType: import_v47.z.literal(BlockRefRangeTypeIds.Definite),
-    startBlock: makeBlockRefSchema(valueLabel),
-    endBlock: makeBlockRefSchema(valueLabel)
-  })
-]);
 var makeChainIndexingStatusSnapshotQueuedSchema = (valueLabel = "Value") => import_v47.z.object({
   chainStatus: import_v47.z.literal(ChainIndexingStatusIds.Queued),
-  config: makeBlockRefRangeSchema(valueLabel)
+  config: import_v47.z.discriminatedUnion("rangeType", [
+    import_v47.z.object({
+      rangeType: import_v47.z.literal(RangeTypeIds.LeftBounded),
+      startBlock: makeBlockRefSchema(valueLabel)
+    }),
+    import_v47.z.object({
+      rangeType: import_v47.z.literal(RangeTypeIds.Bounded),
+      startBlock: makeBlockRefSchema(valueLabel),
+      endBlock: makeBlockRefSchema(valueLabel)
+    })
+  ])
 }).check(invariant_chainSnapshotQueuedBlocks);
 var makeChainIndexingStatusSnapshotBackfillSchema = (valueLabel = "Value") => import_v47.z.object({
   chainStatus: import_v47.z.literal(ChainIndexingStatusIds.Backfill),
-  config: makeBlockRefRangeSchema(valueLabel),
+  config: import_v47.z.discriminatedUnion("rangeType", [
+    import_v47.z.object({
+      rangeType: import_v47.z.literal(RangeTypeIds.LeftBounded),
+      startBlock: makeBlockRefSchema(valueLabel)
+    }),
+    import_v47.z.object({
+      rangeType: import_v47.z.literal(RangeTypeIds.Bounded),
+      startBlock: makeBlockRefSchema(valueLabel),
+      endBlock: makeBlockRefSchema(valueLabel)
+    })
+  ]),
   latestIndexedBlock: makeBlockRefSchema(valueLabel),
   backfillEndBlock: makeBlockRefSchema(valueLabel)
 }).check(invariant_chainSnapshotBackfillBlocks);
 var makeChainIndexingStatusSnapshotCompletedSchema = (valueLabel = "Value") => import_v47.z.object({
   chainStatus: import_v47.z.literal(ChainIndexingStatusIds.Completed),
   config: import_v47.z.object({
-    blockRangeType: import_v47.z.literal(BlockRefRangeTypeIds.Definite),
+    rangeType: import_v47.z.literal(RangeTypeIds.Bounded),
     startBlock: makeBlockRefSchema(valueLabel),
     endBlock: makeBlockRefSchema(valueLabel)
   }),
@@ -1434,7 +1471,7 @@ var makeChainIndexingStatusSnapshotCompletedSchema = (valueLabel = "Value") => i
 var makeChainIndexingStatusSnapshotFollowingSchema = (valueLabel = "Value") => import_v47.z.object({
   chainStatus: import_v47.z.literal(ChainIndexingStatusIds.Following),
   config: import_v47.z.object({
-    blockRangeType: import_v47.z.literal(BlockRefRangeTypeIds.Indefinite),
+    rangeType: import_v47.z.literal(RangeTypeIds.LeftBounded),
     startBlock: makeBlockRefSchema(valueLabel)
   }),
   latestIndexedBlock: makeBlockRefSchema(valueLabel),
@@ -1702,7 +1739,7 @@ function invariant_snapshotTimeIsTheHighestKnownBlockTimestamp(ctx) {
   const { snapshotTime, omnichainSnapshot } = ctx.value;
   const chains = Array.from(omnichainSnapshot.chains.values());
   const startBlockTimestamps = chains.map((chain) => chain.config.startBlock.timestamp);
-  const endBlockTimestamps = chains.map((chain) => chain.config).filter((chainConfig) => chainConfig.blockRangeType === BlockRefRangeTypeIds.Definite).map((chainConfig) => chainConfig.endBlock.timestamp);
+  const endBlockTimestamps = chains.map((chain) => chain.config).filter((chainConfig) => chainConfig.rangeType === RangeTypeIds.Bounded).map((chainConfig) => chainConfig.endBlock.timestamp);
   const backfillEndBlockTimestamps = chains.filter((chain) => chain.chainStatus === ChainIndexingStatusIds.Backfill).map((chain) => chain.backfillEndBlock.timestamp);
   const latestKnownBlockTimestamps = chains.filter((chain) => chain.chainStatus === ChainIndexingStatusIds.Following).map((chain) => chain.latestKnownBlock.timestamp);
   const highestKnownBlockTimestamp = Math.max(
@@ -4376,16 +4413,6 @@ ${(0, import_v435.prettifyError)(parsed.error)}
   }
   return parsed.data;
 }
-function deserializeBlockrange(maybeBlockrange, valueLabel) {
-  const schema = makeBlockrangeSchema(valueLabel);
-  const parsed = schema.safeParse(maybeBlockrange);
-  if (parsed.error) {
-    throw new Error(`Cannot deserialize Blockrange:
-${(0, import_v435.prettifyError)(parsed.error)}
-`);
-  }
-  return parsed.data;
-}
 function deserializeBlockRef(maybeBlockRef, valueLabel) {
   const schema = makeBlockRefSchema(valueLabel);
   const parsed = schema.safeParse(maybeBlockRef);