@zhin.js/plugin-earthquake 0.0.0-stage → 0.1.0

package/lib/query-text.js

@@ -0,0 +1,37 @@
+/** Shared query rendering for the `地震` command and the Agent tool. */
+import { formatEventList, formatSourceWarnings } from './format.js';
+import { EarthquakeUnavailableError } from './service.js';
+export const DEFAULT_QUERY_HOURS = 24;
+export const MAX_QUERY_HOURS = 168;
+export async function renderRecentEarthquakes(service, options) {
+    const config = service.config;
+    const limit = Math.min(20, Math.max(1, Math.round(options.limit ?? config.queryLimit)));
+    const minMagnitude = options.minMagnitude ?? config.queryMinMagnitude;
+    const hours = Math.min(MAX_QUERY_HOURS, Math.max(1, Math.round(options.hours ?? DEFAULT_QUERY_HOURS)));
+    const region = options.region?.trim();
+    const regions = region ? [region] : [];
+    try {
+        const result = await service.queryRecent({ limit, minMagnitude, regions, hours });
+        const scope = region ? `「${region}」` : '';
+        const header = `最近 ${hours} 小时${scope} M${minMagnitude.toFixed(1)} 以上地震`;
+        const warning = formatSourceWarnings(result.outcomes);
+        const staleNote = result.stale ? '⚠️ 数据源暂不可用，以下为上次成功获取的数据' : undefined;
+        if (result.events.length === 0) {
+            return [`${header}：暂无记录`, staleNote, warning].filter(Boolean).join('\n');
+        }
+        return formatEventList({
+            title: `${header}（共 ${result.total} 条）：`,
+            events: result.events,
+            timezone: config.timezone,
+            hiddenCount: result.total - result.events.length,
+            footer: [staleNote, warning],
+        });
+    }
+    catch (error) {
+        if (error instanceof EarthquakeUnavailableError) {
+            return `暂时无法获取地震数据，请稍后再试。\n${error.message}`;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=query-text.js.map

package/lib/query-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-text.js","sourceRoot":"","sources":["../src/query-text.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAS1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAA0B,EAAE,OAAyB;IACjG,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,iBAAiB,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACvG,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAClF,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,KAAK,MAAM,KAAK,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACzE,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,MAAM,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,eAAe,CAAC;YACrB,KAAK,EAAE,GAAG,MAAM,MAAM,MAAM,CAAC,KAAK,MAAM;YACxC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM;YAChD,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,0BAA0B,EAAE,CAAC;YAChD,OAAO,sBAAsB,KAAK,CAAC,OAAO,EAAE,CAAC;QAC/C,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/lib/rate-limit.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sliding-window limiter for outbound pushes, keyed by conversation.
+ * State lives in memory only: a restart starts every window fresh.
+ */
+export declare class SlidingWindowRateLimiter {
+    #private;
+    constructor(options: {
+        readonly limit: number;
+        readonly windowMs: number;
+        readonly now?: () => number;
+    });
+    /** Consumes one slot when available. */
+    tryAcquire(key: string): boolean;
+    /** Slots left in the current window without consuming one. */
+    remaining(key: string): number;
+}
+//# sourceMappingURL=rate-limit.d.ts.map

package/lib/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,wBAAwB;;gBAMvB,OAAO,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE;IAiBvG,wCAAwC;IACxC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAShC,8DAA8D;IAC9D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAG/B"}

package/lib/rate-limit.js

@@ -0,0 +1,41 @@
+/**
+ * Sliding-window limiter for outbound pushes, keyed by conversation.
+ * State lives in memory only: a restart starts every window fresh.
+ */
+export class SlidingWindowRateLimiter {
+    #limit;
+    #windowMs;
+    #now;
+    #history = new Map();
+    constructor(options) {
+        this.#limit = options.limit;
+        this.#windowMs = options.windowMs;
+        this.#now = options.now ?? Date.now;
+    }
+    #recent(key, now) {
+        const since = now - this.#windowMs;
+        const kept = (this.#history.get(key) ?? []).filter((timestamp) => timestamp > since);
+        if (kept.length === 0) {
+            this.#history.delete(key);
+        }
+        else {
+            this.#history.set(key, kept);
+        }
+        return kept;
+    }
+    /** Consumes one slot when available. */
+    tryAcquire(key) {
+        const now = this.#now();
+        const recent = this.#recent(key, now);
+        if (recent.length >= this.#limit)
+            return false;
+        recent.push(now);
+        this.#history.set(key, recent);
+        return true;
+    }
+    /** Slots left in the current window without consuming one. */
+    remaining(key) {
+        return Math.max(0, this.#limit - this.#recent(key, this.#now()).length);
+    }
+}
+//# sourceMappingURL=rate-limit.js.map

package/lib/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IAC1B,MAAM,CAAS;IACf,SAAS,CAAS;IAClB,IAAI,CAAe;IACnB,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEhD,YAAY,OAA2F;QACrG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,GAAW;QAC9B,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;QACrF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,UAAU,CAAC,GAAW;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8DAA8D;IAC9D,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/lib/runtime.d.ts

@@ -0,0 +1,4 @@
+import type { EarthquakeService } from './service.js';
+/** Owner-scoped earthquake service shared by commands, the poller and the Agent tool. */
+export declare const earthquakeServiceToken: import("zhin.js").Token<EarthquakeService>;
+//# sourceMappingURL=runtime.d.ts.map

package/lib/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,4CAGlC,CAAC"}

package/lib/runtime.js

@@ -0,0 +1,4 @@
+import { createToken } from 'zhin.js';
+/** Owner-scoped earthquake service shared by commands, the poller and the Agent tool. */
+export const earthquakeServiceToken = createToken('zhin.earthquake.service', 'Owner-scoped earthquake query and subscription service');
+//# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,yFAAyF;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAC/C,yBAAyB,EACzB,wDAAwD,CACzD,CAAC"}

package/lib/service.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Earthquake service: fetches every enabled source, merges reports, answers
+ * queries and drives the subscription poller.
+ *
+ * Poller guarantees:
+ * - `poll()` never throws; every failure is logged and reported in the result.
+ * - Overlapping ticks are skipped (single flight), so a slow source cannot pile up work.
+ * - The first successful fetch of each source is a baseline: its current events
+ *   are remembered without pushing, so startup or source recovery never floods groups.
+ * - Events older than `maxEventAgeMinutes` are never pushed.
+ * - Each physical event is pushed at most once (it is marked seen before sending;
+ *   a failed send is logged and not retried, to avoid duplicate deliveries).
+ * - Pushes are rate-limited per conversation; skipped events are summarised as a
+ *   count in that conversation's next allowed push.
+ */
+import type { ResolvedEarthquakeConfig } from './config.js';
+import { type EventFilter } from './filters.js';
+import type { HttpDependencies } from './http.js';
+import { FeedSource, type FeedSourceHealth } from './sources/feed-source.js';
+import { type EarthquakeSubscription, type SubscriptionStore } from './subscriptions.js';
+import type { EarthquakeEvent, SourceOutcome } from './types.js';
+export type PushSender = (subscription: EarthquakeSubscription, content: string) => Promise<void>;
+export interface ServiceLogger {
+    warn(message: string): void;
+    debug?(message: string): void;
+}
+export interface EarthquakeServiceOptions {
+    readonly config: ResolvedEarthquakeConfig;
+    readonly store: SubscriptionStore;
+    readonly push?: PushSender;
+    readonly deps?: HttpDependencies;
+    readonly logger?: ServiceLogger;
+    /** Replaces the default CENC/USGS sources (tests, custom mirrors). */
+    readonly sources?: readonly FeedSource[];
+}
+export interface QueryOptions extends EventFilter {
+    readonly limit: number;
+    readonly hours: number;
+}
+export interface QueryResult {
+    readonly events: readonly EarthquakeEvent[];
+    /** Matching events before the limit was applied. */
+    readonly total: number;
+    readonly outcomes: readonly SourceOutcome[];
+    /** True when every source failed and cached data from an earlier round was used. */
+    readonly stale: boolean;
+}
+export type PollStatus = 'ok' | 'skipped' | 'failed';
+export interface PollReport {
+    readonly status: PollStatus;
+    readonly outcomes: readonly SourceOutcome[];
+    readonly newEvents: number;
+    readonly pushed: number;
+    readonly rateLimited: number;
+    readonly failedPushes: number;
+    readonly error?: string;
+}
+export declare class EarthquakeUnavailableError extends Error {
+    readonly outcomes: readonly SourceOutcome[];
+    constructor(outcomes: readonly SourceOutcome[]);
+}
+export declare function createDefaultSources(config: ResolvedEarthquakeConfig, deps?: HttpDependencies): FeedSource[];
+export declare class EarthquakeService {
+    #private;
+    readonly config: ResolvedEarthquakeConfig;
+    readonly store: SubscriptionStore;
+    constructor(options: EarthquakeServiceOptions);
+    get canPush(): boolean;
+    health(): readonly FeedSourceHealth[];
+    /** Stops future polls; an in-flight poll finishes its current step. */
+    stop(): void;
+    /** Recent events matching the filter, newest first. Falls back to cached data when every source fails. */
+    queryRecent(options: QueryOptions): Promise<QueryResult>;
+    /** One poller tick. Never throws. */
+    poll(): Promise<PollReport>;
+}
+//# sourceMappingURL=service.d.ts.map

package/lib/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/lib/service.js

@@ -0,0 +1,229 @@
+import { mergeReports, SeenEventLog } from './dedupe.js';
+import { matchesFilter } from './filters.js';
+import { formatEventList, formatSourceWarnings } from './format.js';
+import { SlidingWindowRateLimiter } from './rate-limit.js';
+import { parseCencFeed } from './sources/cenc.js';
+import { FeedSource } from './sources/feed-source.js';
+import { parseUsgsFeed, usgsFeedUrl } from './sources/usgs.js';
+import { subscriptionKey } from './subscriptions.js';
+/** Reports dated further in the future than this are treated as corrupt. */
+const FUTURE_TOLERANCE_MS = 10 * 60_000;
+export class EarthquakeUnavailableError extends Error {
+    outcomes;
+    constructor(outcomes) {
+        super(formatSourceWarnings(outcomes) ?? '所有地震数据源暂时不可用');
+        this.name = 'EarthquakeUnavailableError';
+        this.outcomes = outcomes;
+    }
+}
+const SOURCE_LABELS = {
+    cenc: 'CENC 中国地震台网',
+    usgs: 'USGS',
+};
+export function createDefaultSources(config, deps) {
+    const policy = {
+        timeoutMs: config.requestTimeoutMs,
+        maxRetries: config.maxRetries,
+        baseDelayMs: config.retryBaseDelayMs,
+        maxDelayMs: config.retryMaxDelayMs,
+    };
+    return config.sources.map((id) => {
+        if (id === 'cenc') {
+            return new FeedSource({ id, label: SOURCE_LABELS.cenc, urls: config.cencUrls, parse: parseCencFeed, policy, deps });
+        }
+        return new FeedSource({ id, label: SOURCE_LABELS.usgs, urls: [usgsFeedUrl(config.usgsFeed)], parse: parseUsgsFeed, policy, deps });
+    });
+}
+function emptyReport(status, outcomes, error) {
+    return { status, outcomes, newEvents: 0, pushed: 0, rateLimited: 0, failedPushes: 0, error };
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export class EarthquakeService {
+    config;
+    store;
+    #sources;
+    #push;
+    #logger;
+    #now;
+    #seen = new SeenEventLog();
+    #baselinedSources = new Set();
+    #limiter;
+    #rateLimitedCounts = new Map();
+    #polling = false;
+    #stopped = false;
+    constructor(options) {
+        this.config = options.config;
+        this.store = options.store;
+        this.#push = options.push;
+        this.#logger = options.logger;
+        this.#now = options.deps?.now ?? Date.now;
+        this.#sources = options.sources ?? createDefaultSources(options.config, options.deps);
+        this.#limiter = new SlidingWindowRateLimiter({
+            limit: options.config.pushLimit,
+            windowMs: options.config.pushWindowMinutes * 60_000,
+            now: this.#now,
+        });
+    }
+    get canPush() {
+        return this.#push !== undefined;
+    }
+    health() {
+        return this.#sources.map((source) => source.health());
+    }
+    /** Stops future polls; an in-flight poll finishes its current step. */
+    stop() {
+        this.#stopped = true;
+    }
+    async #fetchAll() {
+        const reports = new Map();
+        const settled = await Promise.all(this.#sources.map(async (source) => {
+            if (source.isCoolingDown()) {
+                return { source: source.id, ok: false, skipped: true, eventCount: 0 };
+            }
+            try {
+                const events = await source.fetchEvents();
+                reports.set(source.id, events);
+                return { source: source.id, ok: true, eventCount: events.length };
+            }
+            catch (error) {
+                return { source: source.id, ok: false, error: errorMessage(error), eventCount: 0 };
+            }
+        }));
+        return { reports, outcomes: settled };
+    }
+    #withinWindow(reports, windowMs) {
+        const now = this.#now();
+        const oldest = now - windowMs;
+        const newest = now + FUTURE_TOLERANCE_MS;
+        return reports.filter((report) => report.time >= oldest && report.time <= newest);
+    }
+    /** Recent events matching the filter, newest first. Falls back to cached data when every source fails. */
+    async queryRecent(options) {
+        const { reports, outcomes } = await this.#fetchAll();
+        let stale = false;
+        let collected = [...reports.values()].flat();
+        if (reports.size === 0) {
+            const cached = this.#sources.flatMap((source) => source.cachedEvents() ?? []);
+            if (cached.length === 0) {
+                throw new EarthquakeUnavailableError(outcomes);
+            }
+            stale = true;
+            collected = cached;
+        }
+        const windowed = this.#withinWindow(collected, options.hours * 60 * 60_000);
+        const merged = mergeReports(windowed, this.config.sources);
+        const matching = merged.filter((event) => matchesFilter(event, options));
+        return {
+            events: matching.slice(0, options.limit),
+            total: matching.length,
+            outcomes,
+            stale,
+        };
+    }
+    /** One poller tick. Never throws. */
+    async poll() {
+        if (this.#stopped)
+            return emptyReport('skipped', []);
+        if (this.#polling)
+            return emptyReport('skipped', []);
+        this.#polling = true;
+        try {
+            return await this.#pollOnce();
+        }
+        catch (error) {
+            const message = errorMessage(error);
+            this.#logger?.warn(`[earthquake] poll failed: ${message}`);
+            return emptyReport('failed', [], message);
+        }
+        finally {
+            this.#polling = false;
+        }
+    }
+    async #pollOnce() {
+        const { reports, outcomes } = await this.#fetchAll();
+        for (const outcome of outcomes) {
+            if (!outcome.ok && !outcome.skipped) {
+                this.#logger?.warn(`[earthquake] source failed: ${outcome.error ?? outcome.source}`);
+            }
+        }
+        if (reports.size === 0) {
+            return emptyReport('failed', outcomes, '所有数据源本轮均不可用');
+        }
+        const windowMs = this.config.maxEventAgeMinutes * 60_000;
+        const windowed = new Map();
+        for (const [source, sourceReports] of reports) {
+            windowed.set(source, this.#withinWindow(sourceReports, windowMs));
+        }
+        // Baseline: remember what a source shows on its first good round, push nothing from it.
+        for (const [source, sourceReports] of windowed) {
+            if (this.#baselinedSources.has(source))
+                continue;
+            for (const report of sourceReports) {
+                this.#seen.add({ primary: report, reports: [report] });
+            }
+            this.#baselinedSources.add(source);
+        }
+        const merged = mergeReports([...windowed.values()].flat(), this.config.sources);
+        const fresh = merged.filter((event) => !this.#seen.has(event));
+        // Merged events may carry reports that were never seen; record them all.
+        for (const event of merged) {
+            this.#seen.add(event);
+        }
+        this.#seen.prune(this.#now());
+        if (fresh.length === 0 || !this.#push || this.#stopped) {
+            return { ...emptyReport('ok', outcomes), newEvents: fresh.length };
+        }
+        let subscriptions;
+        try {
+            subscriptions = await this.store.list();
+        }
+        catch (error) {
+            const message = errorMessage(error);
+            this.#logger?.warn(`[earthquake] cannot load subscriptions: ${message}`);
+            return { ...emptyReport('failed', outcomes, message), newEvents: fresh.length };
+        }
+        let pushed = 0;
+        let rateLimited = 0;
+        let failedPushes = 0;
+        for (const subscription of subscriptions) {
+            const matching = fresh.filter((event) => matchesFilter(event, subscription));
+            if (matching.length === 0)
+                continue;
+            const key = subscriptionKey(subscription);
+            if (!this.#limiter.tryAcquire(key)) {
+                rateLimited += matching.length;
+                this.#rateLimitedCounts.set(key, (this.#rateLimitedCounts.get(key) ?? 0) + matching.length);
+                continue;
+            }
+            const content = this.#formatPush(matching, this.#rateLimitedCounts.get(key) ?? 0);
+            this.#rateLimitedCounts.delete(key);
+            try {
+                await this.#push(subscription, content);
+                pushed += 1;
+            }
+            catch (error) {
+                failedPushes += 1;
+                this.#logger?.warn(`[earthquake] push to ${subscription.adapter}/${subscription.conversationKind}/${subscription.conversationId} failed: ${errorMessage(error)}`);
+            }
+        }
+        return { status: 'ok', outcomes, newEvents: fresh.length, pushed, rateLimited, failedPushes };
+    }
+    #formatPush(events, previouslyRateLimited) {
+        const limit = this.config.maxEventsPerMessage;
+        const shown = events.slice(0, limit);
+        const title = events.length === 1 ? '🌏 地震速报' : `🌏 地震速报（${events.length} 条）`;
+        const footer = previouslyRateLimited > 0
+            ? `（推送限流期间另有 ${previouslyRateLimited} 条地震未推送，可发送「地震」查看）`
+            : undefined;
+        return formatEventList({
+            title,
+            events: shown,
+            timezone: this.config.timezone,
+            hiddenCount: events.length - shown.length,
+            footer: [footer],
+        });
+    }
+}
+//# sourceMappingURL=service.js.map

package/lib/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/lib/sources/cenc.d.ts

@@ -0,0 +1,37 @@
+/**
+ * China Earthquake Networks Center (中国地震台网中心, CENC) public catalogue feed.
+ *
+ * The public site https://www.cenc.ac.cn / https://ceic.ac.cn renders its
+ * "最新地震" list from a static JSON array at `https://ceic.ac.cn/data/data.json`:
+ *
+ *   [{ "id": "CC.20261020145206.3", "time": "2026-10-20 14:41:20",
+ *      "latitude": 37.8, "longitude": 95.65, "depth": 10,
+ *      "magnitude": 4.6, "location": "青海海西州直辖区" }, ...]
+ *
+ * The default primary is the keyless public mirror `https://api.wolfx.jp/cenc_eqlist.json`
+ * (much smaller, CDN-cached), which republishes the same catalogue as an object:
+ *
+ *   { "No1": { "EventID": "AU.20261020144123.7", "time": "2026-10-20 14:41:20",
+ *              "location": "青海海西州直辖区", "magnitude": "4.6", "depth": "10",
+ *              "latitude": "37.80", "longitude": "95.65", ... }, "No2": ... }
+ *
+ * Both shapes are accepted. Mirrors may assign different ids to one event, so
+ * cross-round de-duplication never relies on CENC ids alone (see dedupe.ts).
+ *
+ * Times are Beijing time (UTC+8) without an offset. The feeds are undocumented, so
+ * parsing is deliberately tolerant: numeric strings are accepted, a wrapped
+ * `{ data: [...] }` envelope is unwrapped, and invalid rows are skipped one by
+ * one instead of failing the whole batch.
+ */
+import type { SourceEarthquake } from '../types.js';
+/** Keyless public mirror (default primary). */
+export declare const CENC_MIRROR_URL = "https://api.wolfx.jp/cenc_eqlist.json";
+/** Static JSON behind the official CENC "最新地震" page (default fallback). */
+export declare const CENC_OFFICIAL_URL = "https://ceic.ac.cn/data/data.json";
+export declare const DEFAULT_CENC_URLS: readonly string[];
+export declare const CENC_HOME_URL = "https://www.cenc.ac.cn/";
+/** Parses `YYYY-MM-DD HH:mm:ss` in Beijing time; also accepts ISO strings with an explicit offset. */
+export declare function parseBeijingTime(value: string): number | undefined;
+/** Parses the CENC feed body. Throws only when the body is not JSON or has no list at all. */
+export declare function parseCencFeed(body: string): SourceEarthquake[];
+//# sourceMappingURL=cenc.d.ts.map

package/lib/sources/cenc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cenc.d.ts","sourceRoot":"","sources":["../../src/sources/cenc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,+CAA+C;AAC/C,eAAO,MAAM,eAAe,0CAA0C,CAAC;AACvE,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,sCAAsC,CAAC;AACrE,eAAO,MAAM,iBAAiB,mBAAsD,CAAC;AACrF,eAAO,MAAM,aAAa,4BAA4B,CAAC;AAKvD,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqBlE;AAgDD,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAqB9D"}

package/lib/sources/cenc.js

@@ -0,0 +1,110 @@
+import { isPlausibleMagnitude, isRecord, isValidLatitude, isValidLongitude, toFiniteNumber, toTrimmedString, } from './parse-helpers.js';
+/** Keyless public mirror (default primary). */
+export const CENC_MIRROR_URL = 'https://api.wolfx.jp/cenc_eqlist.json';
+/** Static JSON behind the official CENC "最新地震" page (default fallback). */
+export const CENC_OFFICIAL_URL = 'https://ceic.ac.cn/data/data.json';
+export const DEFAULT_CENC_URLS = Object.freeze([CENC_MIRROR_URL, CENC_OFFICIAL_URL]);
+export const CENC_HOME_URL = 'https://www.cenc.ac.cn/';
+const BEIJING_OFFSET_MS = 8 * 60 * 60 * 1_000;
+const BEIJING_TIME_PATTERN = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2}):(\d{2})(?:\.\d+)?$/u;
+/** Parses `YYYY-MM-DD HH:mm:ss` in Beijing time; also accepts ISO strings with an explicit offset. */
+export function parseBeijingTime(value) {
+    const match = BEIJING_TIME_PATTERN.exec(value.trim());
+    if (!match) {
+        const hasExplicitZone = /(?:Z|[+-]\d{2}:?\d{2})$/u.test(value.trim());
+        if (!hasExplicitZone)
+            return undefined;
+        const parsed = Date.parse(value);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    }
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const hour = Number(match[4]);
+    const minute = Number(match[5]);
+    const second = Number(match[6]);
+    const utc = Date.UTC(year, month - 1, day, hour, minute, second);
+    const roundTrip = new Date(utc);
+    // Reject impossible dates such as 2026-02-31 instead of silently rolling over.
+    if (roundTrip.getUTCDate() !== day || roundTrip.getUTCMonth() !== month - 1) {
+        return undefined;
+    }
+    return utc - BEIJING_OFFSET_MS;
+}
+const MIRROR_ROW_KEY = /^No\d+$/u;
+function isMirrorObject(payload) {
+    return Object.keys(payload).some((key) => MIRROR_ROW_KEY.test(key));
+}
+/** Returns the row list, or undefined when the payload has no recognisable list. */
+function extractRows(payload) {
+    if (Array.isArray(payload))
+        return payload;
+    if (!isRecord(payload))
+        return undefined;
+    if (Array.isArray(payload.data))
+        return payload.data;
+    if (isMirrorObject(payload)) {
+        return Object.entries(payload)
+            .filter(([key]) => MIRROR_ROW_KEY.test(key))
+            .map(([, row]) => row);
+    }
+    return undefined;
+}
+function parseCencRow(row) {
+    if (!isRecord(row))
+        return undefined;
+    const id = toTrimmedString(row.id) ?? toTrimmedString(row.EventID);
+    const timeText = toTrimmedString(row.time);
+    const latitude = toFiniteNumber(row.latitude);
+    const longitude = toFiniteNumber(row.longitude);
+    const magnitude = toFiniteNumber(row.magnitude);
+    const location = toTrimmedString(row.location) ?? toTrimmedString(row.placeName);
+    if (!id || !timeText || !location)
+        return undefined;
+    if (latitude === undefined || !isValidLatitude(latitude))
+        return undefined;
+    if (longitude === undefined || !isValidLongitude(longitude))
+        return undefined;
+    if (magnitude === undefined || !isPlausibleMagnitude(magnitude))
+        return undefined;
+    const time = parseBeijingTime(timeText);
+    if (time === undefined)
+        return undefined;
+    const depth = toFiniteNumber(row.depth);
+    return {
+        source: 'cenc',
+        id,
+        time,
+        latitude,
+        longitude,
+        depthKm: depth !== undefined && depth >= 0 ? depth : undefined,
+        magnitude,
+        location,
+    };
+}
+/** Parses the CENC feed body. Throws only when the body is not JSON or has no list at all. */
+export function parseCencFeed(body) {
+    let payload;
+    try {
+        payload = JSON.parse(body);
+    }
+    catch (error) {
+        throw new Error('CENC 返回的不是有效 JSON', { cause: error });
+    }
+    const rows = extractRows(payload);
+    if (!rows) {
+        throw new Error('CENC 返回的数据格式无法识别');
+    }
+    const events = [];
+    for (const row of rows) {
+        const event = parseCencRow(row);
+        if (event)
+            events.push(event);
+    }
+    if (rows.length > 0 && events.length === 0) {
+        // Every row is unreadable: the schema probably changed. Fail so callers fall back.
+        throw new Error('CENC 返回的记录全部无法解析');
+    }
+    return events;
+}
+//# sourceMappingURL=cenc.js.map

package/lib/sources/cenc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cenc.js","sourceRoot":"","sources":["../../src/sources/cenc.ts"],"names":[],"mappings":"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"}