hood-alerts 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+export { A as AlertEvent, a as AlertEventBase, b as AlertEventKind, C as CurveTradeEvent, E as EVENT_KIND_LABELS, c as ExplorerLinks, G as GraduationEvent, L as LAUNCHPAD_EVENT_KINDS, d as LaunchEvent, e as Launchpad, T as TradeSide, W as WhaleTradeEvent, i as isKind } from './types-DFPpTMWo.cjs';
+export { LiquidityReader, LiquidityReaderOptions, MAINNET_EXPLORER, TESTNET_EXPLORER, addressUrl, blockUrl, createLiquidityReader, explorerBase, tokenUrl, txUrl } from './events/index.cjs';
+export { P as PriceOracle, a as PriceOracleOptions, c as createPriceOracle, b as createStaticPriceOracle, q as quoteTokens } from './pricing-BumgLpvB.cjs';
+export { B as BlockTimeReader, E as EventSource, S as SUPPORTED_LAUNCHPADS, a as SourceContext, T as TokenMeta, b as TokenMetaReader, c as createBlockTimeReader, d as createEventSources, e as createNoxaLaunchSource, f as createOdysseyCurveTradeSource, g as createOdysseyGraduationSource, h as createOdysseyLaunchSource, i as createTokenMetaReader, j as createWhaleTradeSource, k as eventId } from './sources-CpDOUlzx.cjs';
+export { P as PoolEntry, a as PoolRegistry, c as createMemoryPoolRegistry } from './registry-DePA3IyS.cjs';
+export { F as FetchLogRangeOptions, b as batchAddresses, f as fetchLogRange, i as isResultTooLarge, a as isRetryableRpcError } from './logs-D7sYBvSy.cjs';
+export { P as Platform, R as RateLimitConfig, a as ReputationFilter, b as Rule, c as RuleInput, S as Subscription, d as SubscriptionInput, e as addressSchema, f as canEmit, g as defaultRules, h as eventKindSchema, i as formatValidationError, l as launchpadSchema, p as parseRule, j as parseSubscription, k as platformSchema, r as rateLimitSchema, m as reputationFilterSchema, n as ruleComplexity, o as ruleSchema, s as safeParseRule, q as safeParseSubscription, t as sideSchema, u as subscriptionSchema, v as usesOnChainLookups } from './schema-NnIdKFl2.cjs';
+export { DeployerReputation, EvaluationContext, MatchResult, PriorLaunch, ReputationProvider, ReputationProviderOptions, createRpcReputationProvider, evaluateRule, matchRules, priorLaunchesBefore } from './rules/index.cjs';
+export { R as RateLimitDecision, a as RateLimitStore, c as checkRateLimit, b as createMemoryRateLimitStore, r as rateLimitKey } from './ratelimit-BKVQG2oY.cjs';
+export { CaptureNotifier, CapturedDelivery, DiscordBotOptions, DiscordOptionsBase, DiscordRateLimiter, DiscordWebhookOptions, JsonResponse, createCaptureNotifier, createDiscordBotNotifier, createDiscordRateLimiter, createDiscordWebhookNotifier, displayLabel, escapeDiscordMarkdown, escapeHtml, escapeHtmlAttribute, escapeMarkdownV2, escapeMarkdownV2Code, escapeMarkdownV2Url, htmlLink, markdownV2Link, numericHeader, pick, postJson, resolveFetch, shortAddress, sleep, truncate } from './notifiers/index.cjs';
+export { E as EMBED_COLORS, R as RenderOptions, d as detailRows, f as formatAmount, a as formatEth, b as formatUsd, h as headline, r as renderAlert } from './format-B7d40f65.cjs';
+export { T as TelegramClient, a as TelegramClientOptions, b as TelegramNotifierOptions, c as TelegramResponse, d as createTelegramClient, e as createTelegramNotifier } from './telegram-CpodYJrP.cjs';
+export { D as DeliveryResult, a as DiscordEmbed, b as DiscordEmbedField, F as FetchLike, c as FetchLikeResponse, N as Notifier, d as NotifierHttpOptions, R as RenderedAlert, e as delivered, f as failed } from './types-CcoKpStA.cjs';
+export { CALLBACK_TYPE, COMMANDS, CommandContext, CommandReply, CommandRouter, CommandRouterDeps, CommandSpec, DiscordCommandDefinition, DiscordInteractionOptions, EPHEMERAL_FLAG, INTERACTION_TYPE, InteractionResponse, RegisterCommandsOptions, TelegramBot, TelegramBotOptions, createCommandRouter, createDiscordInteractionHandler, createTelegramBot, discordCommandDefinitions, registerDiscordCommands, verifyDiscordSignature } from './bot/index.cjs';
+export { Entitlement, EntitlementGate, EntitlementGateOptions, EntitlementProvider, PolicyDecision, TIER_POLICIES, Tier, TierPolicy, UsdgEntitlementOptions, WalletLinkStore, accrueExpiry, canAddRule, canAddSubscription, chainEntitlementProviders, createEntitlementGate, createStaticEntitlementProvider, createUsdgEntitlementProvider, isRuleAllowed, linkMessage, policyFor, verifyWalletLink } from './tiers/index.cjs';
+export { AlertService, CreateServiceOptions, Dispatcher, DispatcherOptions, FlushStats, HealthState, HttpServerOptions, PollStats, ServiceConfig, VERSION, createDispatcher, createHttpServer, createService, decode, decodeEvent, encode, encodeEvent, loadConfig, renderMetrics } from './service/index.cjs';
+export { A as AlertStore, L as LEVELS, a as LogFields, b as LogLevel, c as Logger, d as LoggerOptions, O as OutboxRow, e as OutboxStatus, S as StoreMetrics, f as createLogger, g as createSilentLogger } from './logger-3phvV_fl.cjs';
+import 'viem';
+import 'hoodchain';
+import 'zod';
+import 'node:http';

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { A as AlertEvent, a as AlertEventBase, b as AlertEventKind, C as CurveTradeEvent, E as EVENT_KIND_LABELS, c as ExplorerLinks, G as GraduationEvent, L as LAUNCHPAD_EVENT_KINDS, d as LaunchEvent, e as Launchpad, T as TradeSide, W as WhaleTradeEvent, i as isKind } from './types-DFPpTMWo.js';
+export { LiquidityReader, LiquidityReaderOptions, MAINNET_EXPLORER, TESTNET_EXPLORER, addressUrl, blockUrl, createLiquidityReader, explorerBase, tokenUrl, txUrl } from './events/index.js';
+export { P as PriceOracle, a as PriceOracleOptions, c as createPriceOracle, b as createStaticPriceOracle, q as quoteTokens } from './pricing-BumgLpvB.js';
+export { B as BlockTimeReader, E as EventSource, S as SUPPORTED_LAUNCHPADS, a as SourceContext, T as TokenMeta, b as TokenMetaReader, c as createBlockTimeReader, d as createEventSources, e as createNoxaLaunchSource, f as createOdysseyCurveTradeSource, g as createOdysseyGraduationSource, h as createOdysseyLaunchSource, i as createTokenMetaReader, j as createWhaleTradeSource, k as eventId } from './sources-CAaQR6-N.js';
+export { P as PoolEntry, a as PoolRegistry, c as createMemoryPoolRegistry } from './registry-D3We8Lg6.js';
+export { F as FetchLogRangeOptions, b as batchAddresses, f as fetchLogRange, i as isResultTooLarge, a as isRetryableRpcError } from './logs-D7sYBvSy.js';
+export { P as Platform, R as RateLimitConfig, a as ReputationFilter, b as Rule, c as RuleInput, S as Subscription, d as SubscriptionInput, e as addressSchema, f as canEmit, g as defaultRules, h as eventKindSchema, i as formatValidationError, l as launchpadSchema, p as parseRule, j as parseSubscription, k as platformSchema, r as rateLimitSchema, m as reputationFilterSchema, n as ruleComplexity, o as ruleSchema, s as safeParseRule, q as safeParseSubscription, t as sideSchema, u as subscriptionSchema, v as usesOnChainLookups } from './schema-DuDMPqpq.js';
+export { DeployerReputation, EvaluationContext, MatchResult, PriorLaunch, ReputationProvider, ReputationProviderOptions, createRpcReputationProvider, evaluateRule, matchRules, priorLaunchesBefore } from './rules/index.js';
+export { R as RateLimitDecision, a as RateLimitStore, c as checkRateLimit, b as createMemoryRateLimitStore, r as rateLimitKey } from './ratelimit-CGLlXNIS.js';
+export { CaptureNotifier, CapturedDelivery, DiscordBotOptions, DiscordOptionsBase, DiscordRateLimiter, DiscordWebhookOptions, JsonResponse, createCaptureNotifier, createDiscordBotNotifier, createDiscordRateLimiter, createDiscordWebhookNotifier, displayLabel, escapeDiscordMarkdown, escapeHtml, escapeHtmlAttribute, escapeMarkdownV2, escapeMarkdownV2Code, escapeMarkdownV2Url, htmlLink, markdownV2Link, numericHeader, pick, postJson, resolveFetch, shortAddress, sleep, truncate } from './notifiers/index.js';
+export { E as EMBED_COLORS, R as RenderOptions, d as detailRows, f as formatAmount, a as formatEth, b as formatUsd, h as headline, r as renderAlert } from './format-6RG4OcyE.js';
+export { T as TelegramClient, a as TelegramClientOptions, b as TelegramNotifierOptions, c as TelegramResponse, d as createTelegramClient, e as createTelegramNotifier } from './telegram-pvphmBwn.js';
+export { D as DeliveryResult, a as DiscordEmbed, b as DiscordEmbedField, F as FetchLike, c as FetchLikeResponse, N as Notifier, d as NotifierHttpOptions, R as RenderedAlert, e as delivered, f as failed } from './types-C0ETog04.js';
+export { CALLBACK_TYPE, COMMANDS, CommandContext, CommandReply, CommandRouter, CommandRouterDeps, CommandSpec, DiscordCommandDefinition, DiscordInteractionOptions, EPHEMERAL_FLAG, INTERACTION_TYPE, InteractionResponse, RegisterCommandsOptions, TelegramBot, TelegramBotOptions, createCommandRouter, createDiscordInteractionHandler, createTelegramBot, discordCommandDefinitions, registerDiscordCommands, verifyDiscordSignature } from './bot/index.js';
+export { Entitlement, EntitlementGate, EntitlementGateOptions, EntitlementProvider, PolicyDecision, TIER_POLICIES, Tier, TierPolicy, UsdgEntitlementOptions, WalletLinkStore, accrueExpiry, canAddRule, canAddSubscription, chainEntitlementProviders, createEntitlementGate, createStaticEntitlementProvider, createUsdgEntitlementProvider, isRuleAllowed, linkMessage, policyFor, verifyWalletLink } from './tiers/index.js';
+export { AlertService, CreateServiceOptions, Dispatcher, DispatcherOptions, FlushStats, HealthState, HttpServerOptions, PollStats, ServiceConfig, VERSION, createDispatcher, createHttpServer, createService, decode, decodeEvent, encode, encodeEvent, loadConfig, renderMetrics } from './service/index.js';
+export { A as AlertStore, L as LEVELS, a as LogFields, b as LogLevel, c as Logger, d as LoggerOptions, O as OutboxRow, e as OutboxStatus, S as StoreMetrics, f as createLogger, g as createSilentLogger } from './logger-CYza_0eU.js';
+import 'viem';
+import 'hoodchain';
+import 'zod';
+import 'node:http';

package/dist/index.js

@@ -0,0 +1,274 @@
+import {
+  createMemoryPoolRegistry
+} from "./chunk-IUOEGBF6.js";
+import "./chunk-3NHLSKZE.js";
+import "./chunk-CIURPPOW.js";
+import "./chunk-ZDM5VNWB.js";
+import "./chunk-O2RY2SWN.js";
+import "./chunk-PLMVKTQM.js";
+import {
+  AlertStore,
+  VERSION,
+  createDispatcher,
+  createHttpServer,
+  createService,
+  decode,
+  decodeEvent,
+  encode,
+  encodeEvent,
+  loadConfig,
+  renderMetrics
+} from "./chunk-Z4DJPESQ.js";
+import {
+  MAINNET_EXPLORER,
+  SUPPORTED_LAUNCHPADS,
+  TESTNET_EXPLORER,
+  addressUrl,
+  blockUrl,
+  createBlockTimeReader,
+  createEventSources,
+  createLiquidityReader,
+  createNoxaLaunchSource,
+  createOdysseyCurveTradeSource,
+  createOdysseyGraduationSource,
+  createOdysseyLaunchSource,
+  createTokenMetaReader,
+  createWhaleTradeSource,
+  eventId,
+  explorerBase,
+  tokenUrl,
+  txUrl
+} from "./chunk-CBNZ6AZT.js";
+import {
+  checkRateLimit,
+  createMemoryRateLimitStore,
+  createRpcReputationProvider,
+  evaluateRule,
+  matchRules,
+  priorLaunchesBefore,
+  rateLimitKey
+} from "./chunk-Y2M3USWZ.js";
+import {
+  createPriceOracle,
+  createStaticPriceOracle,
+  quoteTokens
+} from "./chunk-6JQK5G3Z.js";
+import {
+  EMBED_COLORS,
+  createCaptureNotifier,
+  createDiscordBotNotifier,
+  createDiscordRateLimiter,
+  createDiscordWebhookNotifier,
+  detailRows,
+  formatAmount,
+  formatEth,
+  formatUsd,
+  headline,
+  renderAlert
+} from "./chunk-SOBZ2FPP.js";
+import {
+  CALLBACK_TYPE,
+  COMMANDS,
+  EPHEMERAL_FLAG,
+  INTERACTION_TYPE,
+  LEVELS,
+  createCommandRouter,
+  createDiscordInteractionHandler,
+  createLogger,
+  createSilentLogger,
+  createTelegramBot,
+  discordCommandDefinitions,
+  registerDiscordCommands,
+  verifyDiscordSignature
+} from "./chunk-32GS6XVE.js";
+import {
+  createTelegramClient,
+  createTelegramNotifier,
+  delivered,
+  displayLabel,
+  escapeDiscordMarkdown,
+  escapeHtml,
+  escapeHtmlAttribute,
+  escapeMarkdownV2,
+  escapeMarkdownV2Code,
+  escapeMarkdownV2Url,
+  failed,
+  htmlLink,
+  markdownV2Link,
+  numericHeader,
+  pick,
+  postJson,
+  resolveFetch,
+  shortAddress,
+  sleep,
+  truncate
+} from "./chunk-NBMINJ5E.js";
+import {
+  TIER_POLICIES,
+  canAddRule,
+  canAddSubscription,
+  createEntitlementGate,
+  isRuleAllowed,
+  policyFor
+} from "./chunk-RSTLW7XH.js";
+import {
+  accrueExpiry,
+  chainEntitlementProviders,
+  createStaticEntitlementProvider,
+  createUsdgEntitlementProvider,
+  linkMessage,
+  verifyWalletLink
+} from "./chunk-W2GUAWUR.js";
+import {
+  addressSchema,
+  canEmit,
+  defaultRules,
+  eventKindSchema,
+  formatValidationError,
+  launchpadSchema,
+  parseRule,
+  parseSubscription,
+  platformSchema,
+  rateLimitSchema,
+  reputationFilterSchema,
+  ruleComplexity,
+  ruleSchema,
+  safeParseRule,
+  safeParseSubscription,
+  sideSchema,
+  subscriptionSchema,
+  usesOnChainLookups
+} from "./chunk-VC5MKEY2.js";
+import {
+  EVENT_KIND_LABELS,
+  LAUNCHPAD_EVENT_KINDS,
+  batchAddresses,
+  fetchLogRange,
+  isKind,
+  isResultTooLarge,
+  isRetryableRpcError
+} from "./chunk-3LHCQA4Z.js";
+export {
+  AlertStore,
+  CALLBACK_TYPE,
+  COMMANDS,
+  EMBED_COLORS,
+  EPHEMERAL_FLAG,
+  EVENT_KIND_LABELS,
+  INTERACTION_TYPE,
+  LAUNCHPAD_EVENT_KINDS,
+  LEVELS,
+  MAINNET_EXPLORER,
+  SUPPORTED_LAUNCHPADS,
+  TESTNET_EXPLORER,
+  TIER_POLICIES,
+  VERSION,
+  accrueExpiry,
+  addressSchema,
+  addressUrl,
+  batchAddresses,
+  blockUrl,
+  canAddRule,
+  canAddSubscription,
+  canEmit,
+  chainEntitlementProviders,
+  checkRateLimit,
+  createBlockTimeReader,
+  createCaptureNotifier,
+  createCommandRouter,
+  createDiscordBotNotifier,
+  createDiscordInteractionHandler,
+  createDiscordRateLimiter,
+  createDiscordWebhookNotifier,
+  createDispatcher,
+  createEntitlementGate,
+  createEventSources,
+  createHttpServer,
+  createLiquidityReader,
+  createLogger,
+  createMemoryPoolRegistry,
+  createMemoryRateLimitStore,
+  createNoxaLaunchSource,
+  createOdysseyCurveTradeSource,
+  createOdysseyGraduationSource,
+  createOdysseyLaunchSource,
+  createPriceOracle,
+  createRpcReputationProvider,
+  createService,
+  createSilentLogger,
+  createStaticEntitlementProvider,
+  createStaticPriceOracle,
+  createTelegramBot,
+  createTelegramClient,
+  createTelegramNotifier,
+  createTokenMetaReader,
+  createUsdgEntitlementProvider,
+  createWhaleTradeSource,
+  decode,
+  decodeEvent,
+  defaultRules,
+  delivered,
+  detailRows,
+  discordCommandDefinitions,
+  displayLabel,
+  encode,
+  encodeEvent,
+  escapeDiscordMarkdown,
+  escapeHtml,
+  escapeHtmlAttribute,
+  escapeMarkdownV2,
+  escapeMarkdownV2Code,
+  escapeMarkdownV2Url,
+  evaluateRule,
+  eventId,
+  eventKindSchema,
+  explorerBase,
+  failed,
+  fetchLogRange,
+  formatAmount,
+  formatEth,
+  formatUsd,
+  formatValidationError,
+  headline,
+  htmlLink,
+  isKind,
+  isResultTooLarge,
+  isRetryableRpcError,
+  isRuleAllowed,
+  launchpadSchema,
+  linkMessage,
+  loadConfig,
+  markdownV2Link,
+  matchRules,
+  numericHeader,
+  parseRule,
+  parseSubscription,
+  pick,
+  platformSchema,
+  policyFor,
+  postJson,
+  priorLaunchesBefore,
+  quoteTokens,
+  rateLimitKey,
+  rateLimitSchema,
+  registerDiscordCommands,
+  renderAlert,
+  renderMetrics,
+  reputationFilterSchema,
+  resolveFetch,
+  ruleComplexity,
+  ruleSchema,
+  safeParseRule,
+  safeParseSubscription,
+  shortAddress,
+  sideSchema,
+  sleep,
+  subscriptionSchema,
+  tokenUrl,
+  truncate,
+  txUrl,
+  usesOnChainLookups,
+  verifyDiscordSignature,
+  verifyWalletLink
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/logger-3phvV_fl.d.cts

@@ -0,0 +1,185 @@
+import { Address } from 'viem';
+import { a as PoolRegistry } from './registry-DePA3IyS.cjs';
+import { a as RateLimitStore } from './ratelimit-BKVQG2oY.cjs';
+import { S as Subscription, P as Platform } from './schema-NnIdKFl2.cjs';
+import { WalletLinkStore } from './tiers/index.cjs';
+
+/**
+ * All durable service state, in one SQLite file, with no native dependency.
+ *
+ * The three invariants this schema exists to guarantee, in order of how badly
+ * they bite when they are missing:
+ *
+ * 1. **A restart never double-sends.** Every potential delivery has a
+ *    deterministic primary key (`eventId:subscriptionId:ruleId`), and
+ *    `enqueue` is an `INSERT` that reports a uniqueness violation as "already
+ *    queued". Re-processing a block range after a crash regenerates the exact
+ *    same keys, so the second pass inserts nothing.
+ * 2. **A restart never silently skips a range.** The block cursor advances
+ *    only after every event in a chunk has been enqueued and committed. A
+ *    crash mid-chunk leaves the cursor pointing at the start of that chunk, so
+ *    the range is simply re-read.
+ * 3. **A crash between enqueue and send does not lose the alert.** Enqueued
+ *    rows live in the outbox until they are delivered or dead-lettered. On
+ *    startup, rows left in `sending` (a crash mid-flight) are returned to
+ *    `pending` and retried.
+ *
+ * The one honest caveat: if the process dies after the platform accepted a
+ * message but before the row was marked `sent`, that alert is delivered twice.
+ * Neither the Telegram nor the Discord send API exposes a client-supplied
+ * idempotency key, so this window cannot be closed from here. Everything
+ * outside it is exactly once.
+ */
+/** Delivery lifecycle. */
+type OutboxStatus = 'pending' | 'sending' | 'sent' | 'failed' | 'dead';
+/** A queued delivery. */
+interface OutboxRow {
+    id: string;
+    subscriptionId: string;
+    subscriberId: string;
+    ruleId: string;
+    eventId: string;
+    eventJson: string;
+    platform: Platform;
+    target: string;
+    status: OutboxStatus;
+    /** Earliest delivery time, ms since epoch. Carries the free-tier delay. */
+    notBeforeMs: number;
+    attempts: number;
+    lastError: string | null;
+    createdAtMs: number;
+    updatedAtMs: number;
+}
+/** Aggregate counters for `/metrics`. */
+interface StoreMetrics {
+    subscriptions: number;
+    enabledSubscriptions: number;
+    outbox: Record<OutboxStatus, number>;
+    pools: number;
+    deliveriesLastHour: number;
+    cursors: {
+        sourceId: string;
+        nextBlock: bigint;
+    }[];
+}
+/** The service's durable state. */
+declare class AlertStore {
+    private readonly db;
+    private readonly clock;
+    constructor(path: string, clock?: () => number);
+    /** Deterministic outbox key. The whole dedupe guarantee rests on this. */
+    static deliveryKey(eventId: string, subscriptionId: string, ruleId: string): string;
+    /** The next unprocessed block for a source, or `null` when never persisted. */
+    getCursor(sourceId: string): bigint | null;
+    /** Persist the next unprocessed block. Call only after the range is enqueued. */
+    setCursor(sourceId: string, nextBlock: bigint): void;
+    /** Every persisted cursor, for `/metrics` and for operator inspection. */
+    listCursors(): {
+        sourceId: string;
+        nextBlock: bigint;
+    }[];
+    /** Insert or replace a subscription. */
+    saveSubscription(subscription: Subscription): void;
+    private hydrate;
+    /** One subscription by id. */
+    getSubscription(id: string): Subscription | null;
+    /** Every subscription owned by a subscriber. */
+    listSubscriptionsFor(subscriberId: string): Subscription[];
+    /** Every enabled subscription, for the dispatch fan-out. */
+    listEnabledSubscriptions(): Subscription[];
+    /** Remove a subscription. Returns `true` when a row was deleted. */
+    deleteSubscription(id: string): boolean;
+    /** Every token on any enabled subscription's watchlist, deduped. */
+    watchlistTokens(): Address[];
+    /**
+     * Queue a delivery.
+     *
+     * @returns `true` when this call created the row, `false` when it already
+     * existed (a replayed block range, a duplicate log). The boolean is the
+     * dedupe signal the dispatcher counts.
+     */
+    enqueue(row: Omit<OutboxRow, 'status' | 'attempts' | 'lastError' | 'createdAtMs' | 'updatedAtMs'>): boolean;
+    private static toOutboxRow;
+    /**
+     * Claim due deliveries, moving them to `sending` in one transaction so a
+     * second flush pass cannot pick up the same rows.
+     */
+    claimDue(nowMs: number, limit: number): OutboxRow[];
+    /** Mark a delivery sent. */
+    markSent(id: string): void;
+    /** Record a retryable failure and schedule the next attempt. */
+    markFailed(id: string, attempts: number, error: string, nextAttemptAtMs: number): void;
+    /** Give up on a delivery (permanent rejection, or attempts exhausted). */
+    markDead(id: string, attempts: number, error: string): void;
+    /**
+     * Return rows abandoned mid-flight by a crash to the queue.
+     *
+     * @returns how many rows were recovered.
+     */
+    recoverInFlight(): number;
+    /** Delete delivered rows older than `beforeMs`, keeping the file bounded. */
+    pruneOutbox(beforeMs: number): number;
+    /** Delete delivery history older than `beforeMs`. */
+    pruneDeliveries(beforeMs: number): number;
+    /** A {@link RateLimitStore} backed by the `deliveries` table. */
+    rateLimitStore(): RateLimitStore;
+    /** Record a delivery for both rate limiting and throughput accounting. */
+    recordDelivery(key: string, subscriberId: string, atMs: number): void;
+    /** How many alerts a subscriber received since `sinceMs`. */
+    countDeliveriesForSubscriber(subscriberId: string, sinceMs: number): number;
+    /** A {@link PoolRegistry} backed by the `pools` table. */
+    poolRegistry(): PoolRegistry;
+    private static toPoolEntry;
+    /** Store a signature-verified wallet link. */
+    linkWallet(subscriberId: string, address: Address): void;
+    /** A {@link WalletLinkStore} view of the links table. */
+    walletLinks(): WalletLinkStore;
+    /** Issue (or reissue) the nonce a subscriber must sign to link a wallet. */
+    issueLinkNonce(subscriberId: string, nonce: string): string;
+    /** The outstanding link nonce for a subscriber, or `null`. */
+    getLinkNonce(subscriberId: string): string | null;
+    /** Consume a link nonce so a signature cannot be replayed. */
+    clearLinkNonce(subscriberId: string): void;
+    /** Read a free-form service setting. */
+    getMeta(key: string): string | null;
+    /** Write a free-form service setting. */
+    setMeta(key: string, value: string): void;
+    /** Aggregate counters for `/metrics`. */
+    metrics(): StoreMetrics;
+    /** Close the database. Safe to call twice. */
+    close(): void;
+}
+
+/** Structured logging: one JSON object per line, machine-readable by default. */
+/** Log levels, ordered. */
+declare const LEVELS: readonly ["debug", "info", "warn", "error"];
+/** A log level. */
+type LogLevel = (typeof LEVELS)[number];
+/** Structured fields attached to a log line. */
+type LogFields = Record<string, unknown>;
+/** The logger the service uses everywhere. */
+interface Logger {
+    debug(message: string, fields?: LogFields): void;
+    info(message: string, fields?: LogFields): void;
+    warn(message: string, fields?: LogFields): void;
+    error(message: string, fields?: LogFields): void;
+    /** A logger that adds `fields` to every line, for per-component context. */
+    child(fields: LogFields): Logger;
+}
+/** Options for {@link createLogger}. */
+interface LoggerOptions {
+    /** Minimum level emitted. @defaultValue `'info'` */
+    level?: LogLevel;
+    /** Where lines go. @defaultValue `console.log` */
+    write?: (line: string) => void;
+    /** Fields added to every line. */
+    base?: LogFields;
+    /** Clock injection point for tests. @defaultValue `Date.now` */
+    now?: () => number;
+}
+/** Build a structured logger. */
+declare function createLogger(options?: LoggerOptions): Logger;
+/** A logger that discards everything. For tests and for `--quiet`. */
+declare function createSilentLogger(): Logger;
+
+export { AlertStore as A, LEVELS as L, type OutboxRow as O, type StoreMetrics as S, type LogFields as a, type LogLevel as b, type Logger as c, type LoggerOptions as d, type OutboxStatus as e, createLogger as f, createSilentLogger as g };