@spectratools/cli-shared 0.1.0 → 0.1.1

package/dist/chunk-74BQLM22.js

@@ -0,0 +1,136 @@
+import {
+  HttpError
+} from "./chunk-TKORXDDX.js";
+
+// src/middleware/auth.ts
+var MissingApiKeyError = class extends Error {
+  constructor(envVar) {
+    super(`Missing required API key. Set the ${envVar} environment variable.`);
+    this.name = "MissingApiKeyError";
+  }
+};
+function apiKeyAuth(envVar) {
+  const apiKey = process.env[envVar];
+  if (!apiKey) {
+    throw new MissingApiKeyError(envVar);
+  }
+  return { apiKey };
+}
+
+// src/middleware/pagination.ts
+async function* paginateCursor(options) {
+  let cursor = null;
+  while (true) {
+    const { items, nextCursor } = await options.fetchPage(cursor);
+    for (const item of items) {
+      yield item;
+    }
+    if (!nextCursor) break;
+    cursor = nextCursor;
+  }
+}
+async function* paginateOffset(options) {
+  const limit = options.limit ?? 100;
+  let offset = 0;
+  while (true) {
+    const { items, total } = await options.fetchPage(offset, limit);
+    for (const item of items) {
+      yield item;
+    }
+    offset += items.length;
+    if (offset >= total || items.length === 0) break;
+  }
+}
+
+// src/middleware/rate-limit.ts
+function createRateLimiter(options) {
+  const { requestsPerSecond } = options;
+  const intervalMs = 1e3 / requestsPerSecond;
+  const queue = [];
+  let tokens = requestsPerSecond;
+  let lastRefill = Date.now();
+  let processingInterval = null;
+  function refill() {
+    const now = Date.now();
+    const elapsed = now - lastRefill;
+    const newTokens = elapsed / 1e3 * requestsPerSecond;
+    tokens = Math.min(requestsPerSecond, tokens + newTokens);
+    lastRefill = now;
+  }
+  function processQueue() {
+    refill();
+    while (queue.length > 0 && tokens >= 1) {
+      tokens -= 1;
+      const resolve = queue.shift();
+      resolve?.();
+    }
+    if (queue.length === 0 && processingInterval !== null) {
+      clearInterval(processingInterval);
+      processingInterval = null;
+    }
+  }
+  return () => {
+    return new Promise((resolve) => {
+      refill();
+      if (tokens >= 1) {
+        tokens -= 1;
+        resolve();
+        return;
+      }
+      queue.push(resolve);
+      if (processingInterval === null) {
+        processingInterval = setInterval(processQueue, intervalMs);
+      }
+    });
+  };
+}
+function withRateLimit(fn, acquire) {
+  return acquire().then(() => fn());
+}
+
+// src/middleware/retry.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function jitter(ms) {
+  return ms * (0.5 + Math.random() * 0.5);
+}
+function parseRetryAfter(headers) {
+  const retryAfter = headers.get("Retry-After");
+  if (!retryAfter) return null;
+  const seconds = Number(retryAfter);
+  if (!Number.isNaN(seconds)) return seconds * 1e3;
+  const date = Date.parse(retryAfter);
+  if (!Number.isNaN(date)) return Math.max(0, date - Date.now());
+  return null;
+}
+async function withRetry(fn, options) {
+  const { maxRetries, baseMs, maxMs } = options;
+  let attempt = 0;
+  while (true) {
+    try {
+      return await fn();
+    } catch (err) {
+      if (attempt >= maxRetries) throw err;
+      let delayMs;
+      if (err instanceof HttpError && (err.status === 429 || err.status === 503)) {
+        const retryAfterMs = parseRetryAfter(err.headers);
+        delayMs = retryAfterMs ?? Math.min(baseMs * 2 ** attempt, maxMs);
+      } else {
+        delayMs = Math.min(baseMs * 2 ** attempt, maxMs);
+      }
+      await sleep(jitter(delayMs));
+      attempt++;
+    }
+  }
+}
+
+export {
+  MissingApiKeyError,
+  apiKeyAuth,
+  paginateCursor,
+  paginateOffset,
+  createRateLimiter,
+  withRateLimit,
+  withRetry
+};

package/dist/chunk-IW62SQFU.js

@@ -0,0 +1,28 @@
+// src/utils/format.ts
+import { Address } from "ox";
+var ETH_DECIMALS = 18n;
+var WEI_PER_ETH = 10n ** ETH_DECIMALS;
+function weiToEth(wei, decimals = 6) {
+  const weiValue = typeof wei === "string" ? BigInt(wei) : wei;
+  const whole = weiValue / WEI_PER_ETH;
+  const frac = weiValue % WEI_PER_ETH;
+  const fracStr = frac.toString().padStart(18, "0").slice(0, decimals).replace(/0+$/, "");
+  return fracStr.length > 0 ? `${whole}.${fracStr}` : `${whole}`;
+}
+function checksumAddress(address) {
+  return Address.checksum(address);
+}
+function formatTimestamp(unixSeconds) {
+  return new Date(unixSeconds * 1e3).toISOString();
+}
+function truncate(str, prefixLen = 6, suffixLen = 4) {
+  if (str.length <= prefixLen + suffixLen + 3) return str;
+  return `${str.slice(0, prefixLen)}...${str.slice(-suffixLen)}`;
+}
+
+export {
+  weiToEth,
+  checksumAddress,
+  formatTimestamp,
+  truncate
+};

package/dist/chunk-QEANTXUE.js

@@ -0,0 +1,49 @@
+// src/testing/mock-server.ts
+import { createServer } from "http";
+async function createMockServer() {
+  const routes = /* @__PURE__ */ new Map();
+  const requests = [];
+  const server = createServer((req, res) => {
+    let body = "";
+    req.on("data", (chunk) => {
+      body += chunk.toString();
+    });
+    req.on("end", () => {
+      const recorded = {
+        method: req.method ?? "GET",
+        url: req.url ?? "/",
+        headers: req.headers,
+        body
+      };
+      requests.push(recorded);
+      const key = `${recorded.method}:${recorded.url.split("?")[0]}`;
+      const mock = routes.get(key) ?? routes.get("*");
+      const status = mock?.status ?? 200;
+      const responseHeaders = mock?.headers ?? { "Content-Type": "application/json" };
+      const responseBody = mock?.body !== void 0 ? JSON.stringify(mock.body) : "{}";
+      res.writeHead(status, responseHeaders);
+      res.end(responseBody);
+    });
+  });
+  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  const address = server.address();
+  if (!address || typeof address === "string") {
+    throw new Error("Failed to get server address");
+  }
+  return {
+    url: `http://127.0.0.1:${address.port}`,
+    requests,
+    addRoute(method, path, response) {
+      routes.set(`${method.toUpperCase()}:${path}`, response);
+    },
+    close() {
+      return new Promise((resolve, reject) => {
+        server.close((err) => err ? reject(err) : resolve());
+      });
+    }
+  };
+}
+
+export {
+  createMockServer
+};

package/dist/chunk-TKORXDDX.js

@@ -0,0 +1,55 @@
+// src/utils/http.ts
+var HttpError = class extends Error {
+  constructor(status, statusText, body, headers = new Headers()) {
+    super(`HTTP ${status} ${statusText}: ${body}`);
+    this.status = status;
+    this.statusText = statusText;
+    this.body = body;
+    this.headers = headers;
+    this.name = "HttpError";
+  }
+};
+function serializeQuery(params) {
+  const parts = [];
+  for (const [key, value] of Object.entries(params)) {
+    if (value === void 0 || value === null) continue;
+    parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+  }
+  return parts.length > 0 ? `?${parts.join("&")}` : "";
+}
+function createHttpClient(options) {
+  const { baseUrl, defaultHeaders = {} } = options;
+  async function request(path, opts = {}) {
+    const { method = "GET", headers = {}, query = {}, body } = opts;
+    const qs = serializeQuery(query);
+    const url = `${baseUrl}${path}${qs}`;
+    const init = {
+      method
+    };
+    const mergedHeaders = {
+      ...defaultHeaders,
+      ...headers
+    };
+    if (body !== void 0) {
+      mergedHeaders["Content-Type"] ??= "application/json";
+      init.body = JSON.stringify(body);
+    }
+    init.headers = mergedHeaders;
+    const res = await fetch(url, init);
+    if (!res.ok) {
+      const text = await res.text();
+      throw new HttpError(res.status, res.statusText, text, res.headers);
+    }
+    const contentType = res.headers.get("content-type") ?? "";
+    if (contentType.includes("application/json")) {
+      return res.json();
+    }
+    return res.text();
+  }
+  return { request };
+}
+
+export {
+  HttpError,
+  createHttpClient
+};

package/dist/index.d.ts

@@ -1,124 +1,3 @@
-declare class MissingApiKeyError extends Error {
-    constructor(envVar: string);
-}
-interface ApiKeyAuthContext {
-    apiKey: string;
-}
-/**
- * Reads an API key from the environment and returns it.
- * Throws MissingApiKeyError if the variable is not set.
- */
-declare function apiKeyAuth(envVar: string): ApiKeyAuthContext;
-
-interface CursorPaginationOptions<T> {
-    fetchPage: (cursor: string | null) => Promise<{
-        items: T[];
-        nextCursor: string | null;
-    }>;
-}
-interface OffsetPaginationOptions<T> {
-    fetchPage: (offset: number, limit: number) => Promise<{
-        items: T[];
-        total: number;
-    }>;
-    limit?: number;
-}
-/**
- * Async iterator for cursor-based pagination.
- */
-declare function paginateCursor<T>(options: CursorPaginationOptions<T>): AsyncGenerator<T>;
-/**
- * Async iterator for offset-based pagination.
- */
-declare function paginateOffset<T>(options: OffsetPaginationOptions<T>): AsyncGenerator<T>;
-
-interface RateLimitOptions {
-    requestsPerSecond: number;
-}
-/**
- * Token bucket rate limiter. Returns a function that must be called
- * before each request; it resolves when the request is allowed.
- */
-declare function createRateLimiter(options: RateLimitOptions): () => Promise<void>;
-/**
- * Wraps a fetch-like function with token bucket rate limiting.
- */
-declare function withRateLimit<T>(fn: () => Promise<T>, acquire: () => Promise<void>): Promise<T>;
-
-interface RetryOptions {
-    maxRetries: number;
-    baseMs: number;
-    maxMs: number;
-}
-/**
- * Wraps a fetch-like function with exponential backoff retry logic.
- * Respects Retry-After headers on 429/503 responses.
- */
-declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
-
-interface RecordedRequest {
-    method: string;
-    url: string;
-    headers: Record<string, string | string[] | undefined>;
-    body: string;
-}
-interface MockResponse {
-    status?: number;
-    headers?: Record<string, string>;
-    body?: unknown;
-}
-interface MockServer {
-    url: string;
-    requests: RecordedRequest[];
-    addRoute(method: string, path: string, response: MockResponse): void;
-    close(): Promise<void>;
-}
-/**
- * Creates a lightweight HTTP mock server for integration testing.
- * Records all incoming requests and returns configured fixture responses.
- */
-declare function createMockServer(): Promise<MockServer>;
-
-/**
- * Converts wei (as bigint or string) to a human-readable ETH string.
- */
-declare function weiToEth(wei: bigint | string, decimals?: number): string;
-/**
- * Checksums an Ethereum address using EIP-55.
- * Accepts lowercase or mixed-case hex addresses.
- */
-declare function checksumAddress(address: string): string;
-/**
- * Formats a Unix timestamp (seconds) to a human-readable string.
- */
-declare function formatTimestamp(unixSeconds: number): string;
-/**
- * Truncates a string in the middle, e.g. "0x1234...abcd".
- */
-declare function truncate(str: string, prefixLen?: number, suffixLen?: number): string;
-
-interface HttpClientOptions {
-    baseUrl: string;
-    defaultHeaders?: Record<string, string>;
-}
-interface RequestOptions {
-    method?: string;
-    headers?: Record<string, string>;
-    query?: Record<string, string | number | boolean | undefined | null>;
-    body?: unknown;
-}
-declare class HttpError extends Error {
-    readonly status: number;
-    readonly statusText: string;
-    readonly body: string;
-    readonly headers: Headers;
-    constructor(status: number, statusText: string, body: string, headers?: Headers);
-}
-/**
- * Typed fetch wrapper with base URL, default headers, query serialization, and error handling.
- */
-declare function createHttpClient(options: HttpClientOptions): {
-    request: <T>(path: string, opts?: RequestOptions) => Promise<T>;
-};
-
-export { type ApiKeyAuthContext, type CursorPaginationOptions, type HttpClientOptions, HttpError, MissingApiKeyError, type MockResponse, type MockServer, type OffsetPaginationOptions, type RateLimitOptions, type RecordedRequest, type RequestOptions, type RetryOptions, apiKeyAuth, checksumAddress, createHttpClient, createMockServer, createRateLimiter, formatTimestamp, paginateCursor, paginateOffset, truncate, weiToEth, withRateLimit, withRetry };
+export { ApiKeyAuthContext, CursorPaginationOptions, MissingApiKeyError, OffsetPaginationOptions, RateLimitOptions, RetryOptions, apiKeyAuth, createRateLimiter, paginateCursor, paginateOffset, withRateLimit, withRetry } from './middleware/index.js';
+export { MockResponse, MockServer, RecordedRequest, createMockServer } from './testing/index.js';
+export { HttpClientOptions, HttpError, RequestOptions, checksumAddress, createHttpClient, formatTimestamp, truncate, weiToEth } from './utils/index.js';

package/dist/index.js

@@ -1,244 +1,25 @@
-// src/middleware/auth.ts
-var MissingApiKeyError = class extends Error {
-  constructor(envVar) {
-    super(`Missing required API key. Set the ${envVar} environment variable.`);
-    this.name = "MissingApiKeyError";
-  }
-};
-function apiKeyAuth(envVar) {
-  const apiKey = process.env[envVar];
-  if (!apiKey) {
-    throw new MissingApiKeyError(envVar);
-  }
-  return { apiKey };
-}
-
-// src/middleware/pagination.ts
-async function* paginateCursor(options) {
-  let cursor = null;
-  while (true) {
-    const { items, nextCursor } = await options.fetchPage(cursor);
-    for (const item of items) {
-      yield item;
-    }
-    if (!nextCursor) break;
-    cursor = nextCursor;
-  }
-}
-async function* paginateOffset(options) {
-  const limit = options.limit ?? 100;
-  let offset = 0;
-  while (true) {
-    const { items, total } = await options.fetchPage(offset, limit);
-    for (const item of items) {
-      yield item;
-    }
-    offset += items.length;
-    if (offset >= total || items.length === 0) break;
-  }
-}
-
-// src/middleware/rate-limit.ts
-function createRateLimiter(options) {
-  const { requestsPerSecond } = options;
-  const intervalMs = 1e3 / requestsPerSecond;
-  const queue = [];
-  let tokens = requestsPerSecond;
-  let lastRefill = Date.now();
-  let processingInterval = null;
-  function refill() {
-    const now = Date.now();
-    const elapsed = now - lastRefill;
-    const newTokens = elapsed / 1e3 * requestsPerSecond;
-    tokens = Math.min(requestsPerSecond, tokens + newTokens);
-    lastRefill = now;
-  }
-  function processQueue() {
-    refill();
-    while (queue.length > 0 && tokens >= 1) {
-      tokens -= 1;
-      const resolve = queue.shift();
-      resolve?.();
-    }
-    if (queue.length === 0 && processingInterval !== null) {
-      clearInterval(processingInterval);
-      processingInterval = null;
-    }
-  }
-  return () => {
-    return new Promise((resolve) => {
-      refill();
-      if (tokens >= 1) {
-        tokens -= 1;
-        resolve();
-        return;
-      }
-      queue.push(resolve);
-      if (processingInterval === null) {
-        processingInterval = setInterval(processQueue, intervalMs);
-      }
-    });
-  };
-}
-function withRateLimit(fn, acquire) {
-  return acquire().then(() => fn());
-}
-
-// src/utils/http.ts
-var HttpError = class extends Error {
-  constructor(status, statusText, body, headers = new Headers()) {
-    super(`HTTP ${status} ${statusText}: ${body}`);
-    this.status = status;
-    this.statusText = statusText;
-    this.body = body;
-    this.headers = headers;
-    this.name = "HttpError";
-  }
-};
-function serializeQuery(params) {
-  const parts = [];
-  for (const [key, value] of Object.entries(params)) {
-    if (value === void 0 || value === null) continue;
-    parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
-  }
-  return parts.length > 0 ? `?${parts.join("&")}` : "";
-}
-function createHttpClient(options) {
-  const { baseUrl, defaultHeaders = {} } = options;
-  async function request(path, opts = {}) {
-    const { method = "GET", headers = {}, query = {}, body } = opts;
-    const qs = serializeQuery(query);
-    const url = `${baseUrl}${path}${qs}`;
-    const init = {
-      method
-    };
-    const mergedHeaders = {
-      ...defaultHeaders,
-      ...headers
-    };
-    if (body !== void 0) {
-      mergedHeaders["Content-Type"] ??= "application/json";
-      init.body = JSON.stringify(body);
-    }
-    init.headers = mergedHeaders;
-    const res = await fetch(url, init);
-    if (!res.ok) {
-      const text = await res.text();
-      throw new HttpError(res.status, res.statusText, text, res.headers);
-    }
-    const contentType = res.headers.get("content-type") ?? "";
-    if (contentType.includes("application/json")) {
-      return res.json();
-    }
-    return res.text();
-  }
-  return { request };
-}
-
-// src/middleware/retry.ts
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function jitter(ms) {
-  return ms * (0.5 + Math.random() * 0.5);
-}
-function parseRetryAfter(headers) {
-  const retryAfter = headers.get("Retry-After");
-  if (!retryAfter) return null;
-  const seconds = Number(retryAfter);
-  if (!Number.isNaN(seconds)) return seconds * 1e3;
-  const date = Date.parse(retryAfter);
-  if (!Number.isNaN(date)) return Math.max(0, date - Date.now());
-  return null;
-}
-async function withRetry(fn, options) {
-  const { maxRetries, baseMs, maxMs } = options;
-  let attempt = 0;
-  while (true) {
-    try {
-      return await fn();
-    } catch (err) {
-      if (attempt >= maxRetries) throw err;
-      let delayMs;
-      if (err instanceof HttpError && (err.status === 429 || err.status === 503)) {
-        const retryAfterMs = parseRetryAfter(err.headers);
-        delayMs = retryAfterMs ?? Math.min(baseMs * 2 ** attempt, maxMs);
-      } else {
-        delayMs = Math.min(baseMs * 2 ** attempt, maxMs);
-      }
-      await sleep(jitter(delayMs));
-      attempt++;
-    }
-  }
-}
-
-// src/testing/mock-server.ts
-import { createServer } from "http";
-async function createMockServer() {
-  const routes = /* @__PURE__ */ new Map();
-  const requests = [];
-  const server = createServer((req, res) => {
-    let body = "";
-    req.on("data", (chunk) => {
-      body += chunk.toString();
-    });
-    req.on("end", () => {
-      const recorded = {
-        method: req.method ?? "GET",
-        url: req.url ?? "/",
-        headers: req.headers,
-        body
-      };
-      requests.push(recorded);
-      const key = `${recorded.method}:${recorded.url.split("?")[0]}`;
-      const mock = routes.get(key) ?? routes.get("*");
-      const status = mock?.status ?? 200;
-      const responseHeaders = mock?.headers ?? { "Content-Type": "application/json" };
-      const responseBody = mock?.body !== void 0 ? JSON.stringify(mock.body) : "{}";
-      res.writeHead(status, responseHeaders);
-      res.end(responseBody);
-    });
-  });
-  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
-  const address = server.address();
-  if (!address || typeof address === "string") {
-    throw new Error("Failed to get server address");
-  }
-  return {
-    url: `http://127.0.0.1:${address.port}`,
-    requests,
-    addRoute(method, path, response) {
-      routes.set(`${method.toUpperCase()}:${path}`, response);
-    },
-    close() {
-      return new Promise((resolve, reject) => {
-        server.close((err) => err ? reject(err) : resolve());
-      });
-    }
-  };
-}
-
-// src/utils/format.ts
-import { Address } from "ox";
-var ETH_DECIMALS = 18n;
-var WEI_PER_ETH = 10n ** ETH_DECIMALS;
-function weiToEth(wei, decimals = 6) {
-  const weiValue = typeof wei === "string" ? BigInt(wei) : wei;
-  const whole = weiValue / WEI_PER_ETH;
-  const frac = weiValue % WEI_PER_ETH;
-  const fracStr = frac.toString().padStart(18, "0").slice(0, decimals).replace(/0+$/, "");
-  return fracStr.length > 0 ? `${whole}.${fracStr}` : `${whole}`;
-}
-function checksumAddress(address) {
-  return Address.checksum(address);
-}
-function formatTimestamp(unixSeconds) {
-  return new Date(unixSeconds * 1e3).toISOString();
-}
-function truncate(str, prefixLen = 6, suffixLen = 4) {
-  if (str.length <= prefixLen + suffixLen + 3) return str;
-  return `${str.slice(0, prefixLen)}...${str.slice(-suffixLen)}`;
-}
+import {
+  MissingApiKeyError,
+  apiKeyAuth,
+  createRateLimiter,
+  paginateCursor,
+  paginateOffset,
+  withRateLimit,
+  withRetry
+} from "./chunk-74BQLM22.js";
+import {
+  checksumAddress,
+  formatTimestamp,
+  truncate,
+  weiToEth
+} from "./chunk-IW62SQFU.js";
+import {
+  HttpError,
+  createHttpClient
+} from "./chunk-TKORXDDX.js";
+import {
+  createMockServer
+} from "./chunk-QEANTXUE.js";
 export {
   HttpError,
   MissingApiKeyError,

package/dist/middleware/index.d.ts

@@ -0,0 +1,59 @@
+declare class MissingApiKeyError extends Error {
+    constructor(envVar: string);
+}
+interface ApiKeyAuthContext {
+    apiKey: string;
+}
+/**
+ * Reads an API key from the environment and returns it.
+ * Throws MissingApiKeyError if the variable is not set.
+ */
+declare function apiKeyAuth(envVar: string): ApiKeyAuthContext;
+
+interface CursorPaginationOptions<T> {
+    fetchPage: (cursor: string | null) => Promise<{
+        items: T[];
+        nextCursor: string | null;
+    }>;
+}
+interface OffsetPaginationOptions<T> {
+    fetchPage: (offset: number, limit: number) => Promise<{
+        items: T[];
+        total: number;
+    }>;
+    limit?: number;
+}
+/**
+ * Async iterator for cursor-based pagination.
+ */
+declare function paginateCursor<T>(options: CursorPaginationOptions<T>): AsyncGenerator<T>;
+/**
+ * Async iterator for offset-based pagination.
+ */
+declare function paginateOffset<T>(options: OffsetPaginationOptions<T>): AsyncGenerator<T>;
+
+interface RateLimitOptions {
+    requestsPerSecond: number;
+}
+/**
+ * Token bucket rate limiter. Returns a function that must be called
+ * before each request; it resolves when the request is allowed.
+ */
+declare function createRateLimiter(options: RateLimitOptions): () => Promise<void>;
+/**
+ * Wraps a fetch-like function with token bucket rate limiting.
+ */
+declare function withRateLimit<T>(fn: () => Promise<T>, acquire: () => Promise<void>): Promise<T>;
+
+interface RetryOptions {
+    maxRetries: number;
+    baseMs: number;
+    maxMs: number;
+}
+/**
+ * Wraps a fetch-like function with exponential backoff retry logic.
+ * Respects Retry-After headers on 429/503 responses.
+ */
+declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+
+export { type ApiKeyAuthContext, type CursorPaginationOptions, MissingApiKeyError, type OffsetPaginationOptions, type RateLimitOptions, type RetryOptions, apiKeyAuth, createRateLimiter, paginateCursor, paginateOffset, withRateLimit, withRetry };

package/dist/middleware/index.js

@@ -0,0 +1,19 @@
+import {
+  MissingApiKeyError,
+  apiKeyAuth,
+  createRateLimiter,
+  paginateCursor,
+  paginateOffset,
+  withRateLimit,
+  withRetry
+} from "../chunk-74BQLM22.js";
+import "../chunk-TKORXDDX.js";
+export {
+  MissingApiKeyError,
+  apiKeyAuth,
+  createRateLimiter,
+  paginateCursor,
+  paginateOffset,
+  withRateLimit,
+  withRetry
+};

package/dist/testing/index.d.ts

@@ -0,0 +1,24 @@
+interface RecordedRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+    body: string;
+}
+interface MockResponse {
+    status?: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+interface MockServer {
+    url: string;
+    requests: RecordedRequest[];
+    addRoute(method: string, path: string, response: MockResponse): void;
+    close(): Promise<void>;
+}
+/**
+ * Creates a lightweight HTTP mock server for integration testing.
+ * Records all incoming requests and returns configured fixture responses.
+ */
+declare function createMockServer(): Promise<MockServer>;
+
+export { type MockResponse, type MockServer, type RecordedRequest, createMockServer };

package/dist/testing/index.js

@@ -0,0 +1,6 @@
+import {
+  createMockServer
+} from "../chunk-QEANTXUE.js";
+export {
+  createMockServer
+};

package/dist/utils/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Converts wei (as bigint or string) to a human-readable ETH string.
+ */
+declare function weiToEth(wei: bigint | string, decimals?: number): string;
+/**
+ * Checksums an Ethereum address using EIP-55.
+ * Accepts lowercase or mixed-case hex addresses.
+ */
+declare function checksumAddress(address: string): string;
+/**
+ * Formats a Unix timestamp (seconds) to a human-readable string.
+ */
+declare function formatTimestamp(unixSeconds: number): string;
+/**
+ * Truncates a string in the middle, e.g. "0x1234...abcd".
+ */
+declare function truncate(str: string, prefixLen?: number, suffixLen?: number): string;
+
+interface HttpClientOptions {
+    baseUrl: string;
+    defaultHeaders?: Record<string, string>;
+}
+interface RequestOptions {
+    method?: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string | number | boolean | undefined | null>;
+    body?: unknown;
+}
+declare class HttpError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly body: string;
+    readonly headers: Headers;
+    constructor(status: number, statusText: string, body: string, headers?: Headers);
+}
+/**
+ * Typed fetch wrapper with base URL, default headers, query serialization, and error handling.
+ */
+declare function createHttpClient(options: HttpClientOptions): {
+    request: <T>(path: string, opts?: RequestOptions) => Promise<T>;
+};
+
+export { type HttpClientOptions, HttpError, type RequestOptions, checksumAddress, createHttpClient, formatTimestamp, truncate, weiToEth };

package/dist/utils/index.js

@@ -0,0 +1,18 @@
+import {
+  checksumAddress,
+  formatTimestamp,
+  truncate,
+  weiToEth
+} from "../chunk-IW62SQFU.js";
+import {
+  HttpError,
+  createHttpClient
+} from "../chunk-TKORXDDX.js";
+export {
+  HttpError,
+  checksumAddress,
+  createHttpClient,
+  formatTimestamp,
+  truncate,
+  weiToEth
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectratools/cli-shared",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Shared middleware, utilities, and testing helpers for spectra CLI tools",
   "type": "module",
   "license": "MIT",
@@ -10,20 +10,20 @@
   },
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
     "./middleware": {
-      "types": "./src/middleware/index.ts",
-      "default": "./src/middleware/index.ts"
+      "types": "./dist/middleware/index.d.ts",
+      "default": "./dist/middleware/index.js"
     },
     "./utils": {
-      "types": "./src/utils/index.ts",
-      "default": "./src/utils/index.ts"
+      "types": "./dist/utils/index.d.ts",
+      "default": "./dist/utils/index.js"
     },
     "./testing": {
-      "types": "./src/testing/index.ts",
-      "default": "./src/testing/index.ts"
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
     }
   },
   "devDependencies": {