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

package/lib/sources/feed-source.d.ts

@@ -0,0 +1,51 @@
+/**
+ * One upstream feed with its own cache and health bookkeeping.
+ *
+ * - Mirrors: `urls` are tried in order each round; the first one that answers
+ *   with a parseable body wins. A failing primary falls back to the next mirror.
+ * - Conditional GET: unchanged feeds answer 304 and the cached events are reused.
+ * - Cooldown: after a failed round the source is skipped for a growing period
+ *   (30 s, 60 s, 120 s ... capped at 10 min), or longer when the server sent a
+ *   Retry-After. Other sources keep serving in the meantime.
+ * - A failed round never throws past `fetchEvents`' caller contract: it rejects
+ *   with a readable Error, and the cache from the last good round is kept.
+ */
+import type { EarthquakeSourceId } from '../config.js';
+import { type HttpDependencies, type RetryPolicy } from '../http.js';
+import type { SourceEarthquake } from '../types.js';
+export declare const SOURCE_COOLDOWN_BASE_MS = 30000;
+export declare const SOURCE_COOLDOWN_MAX_MS: number;
+/** Longest Retry-After we will honour as a cooldown, to recover from bogus headers. */
+export declare const SOURCE_RETRY_AFTER_CAP_MS: number;
+export interface FeedSourceOptions {
+    readonly id: EarthquakeSourceId;
+    readonly label: string;
+    /** Primary URL first, then mirrors. At least one entry. */
+    readonly urls: readonly string[];
+    readonly parse: (body: string) => SourceEarthquake[];
+    readonly policy: RetryPolicy;
+    readonly deps?: HttpDependencies;
+}
+export interface FeedSourceHealth {
+    readonly id: EarthquakeSourceId;
+    readonly label: string;
+    readonly consecutiveFailures: number;
+    /** Epoch ms until which the source is skipped; 0 when healthy. */
+    readonly coolingDownUntil: number;
+    readonly lastError?: string;
+    readonly lastSuccessAt?: number;
+    /** URL that served the last good round. */
+    readonly activeUrl?: string;
+}
+export declare class FeedSource {
+    #private;
+    readonly id: EarthquakeSourceId;
+    readonly label: string;
+    constructor(options: FeedSourceOptions);
+    isCoolingDown(): boolean;
+    health(): FeedSourceHealth;
+    /** Events from the last good round, if any; used as a stale fallback. */
+    cachedEvents(): readonly SourceEarthquake[] | undefined;
+    fetchEvents(): Promise<SourceEarthquake[]>;
+}
+//# sourceMappingURL=feed-source.d.ts.map

package/lib/sources/feed-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed-source.d.ts","sourceRoot":"","sources":["../../src/sources/feed-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAkE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACrI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,eAAO,MAAM,sBAAsB,QAAc,CAAC;AAClD,uFAAuF;AACvF,eAAO,MAAM,yBAAyB,QAAc,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,UAAU;;IACrB,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAYX,OAAO,EAAE,iBAAiB;IAOtC,aAAa,IAAI,OAAO;IAIxB,MAAM,IAAI,gBAAgB;IAY1B,yEAAyE;IACzE,YAAY,IAAI,SAAS,gBAAgB,EAAE,GAAG,SAAS;IAIjD,WAAW,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA6DjD"}

package/lib/sources/feed-source.js

@@ -0,0 +1,115 @@
+import { getTextWithRetry, HttpRequestError } from '../http.js';
+export const SOURCE_COOLDOWN_BASE_MS = 30_000;
+export const SOURCE_COOLDOWN_MAX_MS = 10 * 60_000;
+/** Longest Retry-After we will honour as a cooldown, to recover from bogus headers. */
+export const SOURCE_RETRY_AFTER_CAP_MS = 60 * 60_000;
+export class FeedSource {
+    id;
+    label;
+    #options;
+    #now;
+    #validators = new Map();
+    #bodies = new Map();
+    #cachedEvents;
+    #activeUrl;
+    #consecutiveFailures = 0;
+    #coolingDownUntil = 0;
+    #lastError;
+    #lastSuccessAt;
+    constructor(options) {
+        this.id = options.id;
+        this.label = options.label;
+        this.#options = options;
+        this.#now = options.deps?.now ?? Date.now;
+    }
+    isCoolingDown() {
+        return this.#now() < this.#coolingDownUntil;
+    }
+    health() {
+        return {
+            id: this.id,
+            label: this.label,
+            consecutiveFailures: this.#consecutiveFailures,
+            coolingDownUntil: this.isCoolingDown() ? this.#coolingDownUntil : 0,
+            lastError: this.#lastError,
+            lastSuccessAt: this.#lastSuccessAt,
+            activeUrl: this.#activeUrl,
+        };
+    }
+    /** Events from the last good round, if any; used as a stale fallback. */
+    cachedEvents() {
+        return this.#cachedEvents;
+    }
+    async fetchEvents() {
+        try {
+            const events = await this.#fetchOnce();
+            this.#recordSuccess();
+            return events;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.#recordFailure(error, message);
+            throw new Error(`${this.label}：${message}`, { cause: error });
+        }
+    }
+    async #fetchOnce() {
+        const failures = [];
+        for (const url of this.#options.urls) {
+            try {
+                const events = await this.#fetchUrl(url);
+                this.#cachedEvents = events;
+                this.#activeUrl = url;
+                return events;
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        throw combineFailures(failures, this.#options.urls);
+    }
+    async #fetchUrl(url) {
+        const cached = this.#bodies.get(url);
+        const result = await getTextWithRetry(url, this.#options.policy, {
+            validators: cached ? this.#validators.get(url) : undefined,
+            deps: this.#options.deps,
+        });
+        if (result.notModified && cached) {
+            return cached;
+        }
+        // Parse before touching the cache so a malformed body keeps the last good data.
+        const events = this.#options.parse(result.body);
+        this.#bodies.set(url, events);
+        this.#validators.set(url, result.validators);
+        return events;
+    }
+    #recordSuccess() {
+        this.#consecutiveFailures = 0;
+        this.#coolingDownUntil = 0;
+        this.#lastError = undefined;
+        this.#lastSuccessAt = this.#now();
+    }
+    #recordFailure(error, message) {
+        this.#consecutiveFailures += 1;
+        this.#lastError = message;
+        const exponent = Math.min(this.#consecutiveFailures - 1, 10);
+        let cooldown = Math.min(SOURCE_COOLDOWN_MAX_MS, SOURCE_COOLDOWN_BASE_MS * 2 ** exponent);
+        const cause = error instanceof HttpRequestError ? error : undefined;
+        if (cause?.retryAfterMs !== undefined) {
+            cooldown = Math.max(cooldown, Math.min(cause.retryAfterMs, SOURCE_RETRY_AFTER_CAP_MS));
+        }
+        this.#coolingDownUntil = this.#now() + cooldown;
+    }
+}
+/** One error for a round in which every URL failed; keeps the longest Retry-After. */
+function combineFailures(failures, urls) {
+    const messages = failures.map((failure) => (failure instanceof Error ? failure.message : String(failure)));
+    const retryAfters = failures
+        .map((failure) => (failure instanceof HttpRequestError ? failure.retryAfterMs : undefined))
+        .filter((value) => value !== undefined);
+    const message = urls.length > 1 ? `全部 ${urls.length} 个地址失败：${messages.join('；')}` : messages[0] ?? '请求失败';
+    if (retryAfters.length > 0) {
+        return new HttpRequestError(message, { retryable: true, retryAfterMs: Math.max(...retryAfters), cause: failures[0] });
+    }
+    return new Error(message, { cause: failures[0] });
+}
+//# sourceMappingURL=feed-source.js.map

package/lib/sources/feed-source.js.map

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

package/lib/sources/parse-helpers.d.ts

@@ -0,0 +1,10 @@
+/** Small, total helpers for tolerant parsing of untrusted JSON. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Accepts numbers and numeric strings; returns undefined for anything else. */
+export declare function toFiniteNumber(value: unknown): number | undefined;
+export declare function toTrimmedString(value: unknown): string | undefined;
+export declare function isValidLatitude(value: number): boolean;
+export declare function isValidLongitude(value: number): boolean;
+/** Magnitudes outside this range are treated as corrupt data. */
+export declare function isPlausibleMagnitude(value: number): boolean;
+//# sourceMappingURL=parse-helpers.d.ts.map

package/lib/sources/parse-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-helpers.d.ts","sourceRoot":"","sources":["../../src/sources/parse-helpers.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASjE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASlE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/lib/sources/parse-helpers.js

@@ -0,0 +1,36 @@
+/** Small, total helpers for tolerant parsing of untrusted JSON. */
+export function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** Accepts numbers and numeric strings; returns undefined for anything else. */
+export function toFiniteNumber(value) {
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    if (typeof value === 'string' && value.trim() !== '') {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+}
+export function toTrimmedString(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed || undefined;
+    }
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return String(value);
+    }
+    return undefined;
+}
+export function isValidLatitude(value) {
+    return value >= -90 && value <= 90;
+}
+export function isValidLongitude(value) {
+    return value >= -180 && value <= 180;
+}
+/** Magnitudes outside this range are treated as corrupt data. */
+export function isPlausibleMagnitude(value) {
+    return value >= -2 && value <= 10.5;
+}
+//# sourceMappingURL=parse-helpers.js.map

package/lib/sources/parse-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-helpers.js","sourceRoot":"","sources":["../../src/sources/parse-helpers.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,OAAO,IAAI,SAAS,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,IAAI,CAAC,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;AACvC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC;AACtC,CAAC"}

package/lib/sources/usgs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * USGS real-time GeoJSON summary feeds.
+ * Docs: https://earthquake.usgs.gov/earthquakes/feed/v1.0/geojson.php
+ *
+ * Only `properties.type === "earthquake"` features are kept (quarry blasts and
+ * explosions are dropped). Features with missing or out-of-range fields are
+ * skipped individually.
+ */
+import type { UsgsFeed } from '../config.js';
+import type { SourceEarthquake } from '../types.js';
+export declare function usgsFeedUrl(feed: UsgsFeed): string;
+/** Parses a USGS GeoJSON FeatureCollection. Throws only when there is no feature list at all. */
+export declare function parseUsgsFeed(body: string): SourceEarthquake[];
+//# sourceMappingURL=usgs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usgs.d.ts","sourceRoot":"","sources":["../../src/sources/usgs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAElD;AA2CD,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAuB9D"}

package/lib/sources/usgs.js

@@ -0,0 +1,81 @@
+import { isPlausibleMagnitude, isRecord, isValidLatitude, isValidLongitude, toFiniteNumber, toTrimmedString, } from './parse-helpers.js';
+export function usgsFeedUrl(feed) {
+    return `https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/${feed}.geojson`;
+}
+/** Blasts, explosions and other non-earthquake events are not errors, just irrelevant. */
+function isEarthquakeFeature(feature) {
+    if (!isRecord(feature) || !isRecord(feature.properties))
+        return true;
+    const eventType = toTrimmedString(feature.properties.type);
+    return eventType === undefined || eventType === 'earthquake';
+}
+function parseUsgsFeature(feature) {
+    if (!isRecord(feature))
+        return undefined;
+    const properties = feature.properties;
+    const geometry = feature.geometry;
+    if (!isRecord(properties) || !isRecord(geometry))
+        return undefined;
+    const eventType = toTrimmedString(properties.type);
+    if (eventType !== undefined && eventType !== 'earthquake')
+        return undefined;
+    const coordinates = geometry.coordinates;
+    if (!Array.isArray(coordinates) || coordinates.length < 2)
+        return undefined;
+    const longitude = toFiniteNumber(coordinates[0]);
+    const latitude = toFiniteNumber(coordinates[1]);
+    const depth = toFiniteNumber(coordinates[2]);
+    const magnitude = toFiniteNumber(properties.mag);
+    const time = toFiniteNumber(properties.time);
+    const id = toTrimmedString(feature.id) ?? toTrimmedString(properties.code);
+    const location = toTrimmedString(properties.place) ?? toTrimmedString(properties.title);
+    if (!id || !location || time === undefined)
+        return undefined;
+    if (latitude === undefined || !isValidLatitude(latitude))
+        return undefined;
+    if (longitude === undefined || !isValidLongitude(longitude))
+        return undefined;
+    if (magnitude === undefined || !isPlausibleMagnitude(magnitude))
+        return undefined;
+    const url = toTrimmedString(properties.url);
+    return {
+        source: 'usgs',
+        id,
+        time,
+        latitude,
+        longitude,
+        depthKm: depth !== undefined && depth >= 0 ? depth : undefined,
+        magnitude,
+        location,
+        url: url?.startsWith('https://') ? url : undefined,
+    };
+}
+/** Parses a USGS GeoJSON FeatureCollection. Throws only when there is no feature list at all. */
+export function parseUsgsFeed(body) {
+    let payload;
+    try {
+        payload = JSON.parse(body);
+    }
+    catch (error) {
+        throw new Error('USGS 返回的不是有效 JSON', { cause: error });
+    }
+    if (!isRecord(payload) || !Array.isArray(payload.features)) {
+        throw new Error('USGS 返回的数据格式无法识别');
+    }
+    const events = [];
+    let earthquakeFeatures = 0;
+    for (const feature of payload.features) {
+        if (!isEarthquakeFeature(feature))
+            continue;
+        earthquakeFeatures += 1;
+        const event = parseUsgsFeature(feature);
+        if (event)
+            events.push(event);
+    }
+    if (earthquakeFeatures > 0 && events.length === 0) {
+        // Every earthquake feature is unreadable: the schema probably changed.
+        throw new Error('USGS 返回的记录全部无法解析');
+    }
+    return events;
+}
+//# sourceMappingURL=usgs.js.map

package/lib/sources/usgs.js.map

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

package/lib/subscribe-args.d.ts

@@ -0,0 +1,9 @@
+export interface SubscribeArgs {
+    readonly minMagnitude?: number;
+    readonly regions: readonly string[];
+}
+export declare function parseMagnitudeToken(token: string): number | undefined;
+export declare function parseSubscribeArgs(tokens: readonly string[]): SubscribeArgs | {
+    readonly error: string;
+};
+//# sourceMappingURL=subscribe-args.d.ts.map

package/lib/subscribe-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-args.d.ts","sourceRoot":"","sources":["../src/subscribe-args.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAID,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMrE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAsBxG"}

package/lib/subscribe-args.js

@@ -0,0 +1,40 @@
+/**
+ * Parses `地震 订阅 [最小震级] [地区...]` arguments.
+ * The first token may be a magnitude such as `5`, `5.5`, `M5` or `5级`; the rest are regions.
+ */
+import { MAX_REGIONS_PER_SUBSCRIPTION } from './config.js';
+const MAGNITUDE_TOKEN = /^(?:m)?(\d{1,2}(?:\.\d)?)(?:级)?$/iu;
+export function parseMagnitudeToken(token) {
+    const match = MAGNITUDE_TOKEN.exec(token.trim());
+    if (!match)
+        return undefined;
+    const value = Number(match[1]);
+    if (!Number.isFinite(value) || value < 0 || value > 10)
+        return undefined;
+    return value;
+}
+export function parseSubscribeArgs(tokens) {
+    const cleaned = tokens.map((token) => token.trim()).filter((token) => token.length > 0);
+    let minMagnitude;
+    const regions = [];
+    for (const [index, token] of cleaned.entries()) {
+        const magnitude = parseMagnitudeToken(token);
+        if (index === 0 && magnitude !== undefined) {
+            minMagnitude = magnitude;
+            continue;
+        }
+        if (magnitude !== undefined) {
+            return { error: '最小震级请写在地区之前，例如：地震 订阅 5 四川 云南' };
+        }
+        if (token.length > 20) {
+            return { error: `地区关键词过长：${token.slice(0, 20)}…` };
+        }
+        if (!regions.includes(token))
+            regions.push(token);
+    }
+    if (regions.length > MAX_REGIONS_PER_SUBSCRIPTION) {
+        return { error: `最多设置 ${MAX_REGIONS_PER_SUBSCRIPTION} 个地区关键词` };
+    }
+    return { minMagnitude, regions };
+}
+//# sourceMappingURL=subscribe-args.js.map

package/lib/subscribe-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-args.js","sourceRoot":"","sources":["../src/subscribe-args.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAO3D,MAAM,eAAe,GAAG,oCAAoC,CAAC;AAE7D,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IACzE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxF,IAAI,YAAgC,CAAC;IACrC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,KAAK,KAAK,CAAC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC3C,YAAY,GAAG,SAAS,CAAC;YACzB,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;QACnD,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACtB,OAAO,EAAE,KAAK,EAAE,WAAW,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,4BAA4B,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,QAAQ,4BAA4B,SAAS,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC"}

package/lib/subscriptions.d.ts

@@ -0,0 +1,36 @@
+export type ConversationKind = 'private' | 'group' | 'channel';
+export interface EarthquakeSubscription {
+    readonly adapter: string;
+    readonly endpointKey: string;
+    readonly conversationKind: ConversationKind;
+    readonly conversationId: string;
+    readonly minMagnitude: number;
+    readonly regions: readonly string[];
+    readonly createdBy: string;
+    readonly createdAt: string;
+}
+/** Minimal key-value surface; `PluginStateStore` from the database host satisfies it. */
+export interface KeyValueState {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: never): Promise<void>;
+}
+export declare const SUBSCRIPTIONS_STATE_KEY = "subscriptions/v1";
+export declare function subscriptionKey(target: Pick<EarthquakeSubscription, 'adapter' | 'endpointKey' | 'conversationKind' | 'conversationId'>): string;
+export declare function createMemoryState(): KeyValueState;
+export declare class SubscriptionStore {
+    #private;
+    constructor(state: KeyValueState, options: {
+        readonly maxSubscriptions: number;
+    });
+    list(): Promise<EarthquakeSubscription[]>;
+    get(key: string): Promise<EarthquakeSubscription | undefined>;
+    /** Creates or replaces this conversation's subscription. */
+    upsert(subscription: EarthquakeSubscription): Promise<{
+        readonly created: boolean;
+    }>;
+    remove(key: string): Promise<boolean>;
+}
+export declare class SubscriptionLimitError extends Error {
+    constructor(limit: number);
+}
+//# sourceMappingURL=subscriptions.d.ts.map

package/lib/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,aAAa,GAAG,kBAAkB,GAAG,gBAAgB,CAAC,GAAG,MAAM,CAE/I;AA6BD,wBAAgB,iBAAiB,IAAI,aAAa,CAUjD;AAED,qBAAa,iBAAiB;;gBAKhB,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAK1E,IAAI,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAWzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAKnE,4DAA4D;IACtD,MAAM,CAAC,YAAY,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAkBpF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAoB5C;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,KAAK,EAAE,MAAM;CAI1B"}

package/lib/subscriptions.js

@@ -0,0 +1,122 @@
+/**
+ * Conversation subscriptions, one per conversation.
+ *
+ * Persisted as a single JSON document in the plugin's database state when a
+ * database is configured, otherwise kept in memory (lost on restart). Mutations
+ * are serialised so concurrent commands cannot lose each other's writes, and
+ * malformed stored entries are dropped on load instead of breaking the poller.
+ */
+import { isRecord, toFiniteNumber, toTrimmedString } from './sources/parse-helpers.js';
+export const SUBSCRIPTIONS_STATE_KEY = 'subscriptions/v1';
+export function subscriptionKey(target) {
+    return [target.adapter, target.endpointKey, target.conversationKind, target.conversationId].join('\u0000');
+}
+function isConversationKind(value) {
+    return value === 'private' || value === 'group' || value === 'channel';
+}
+function parseStoredSubscription(value) {
+    if (!isRecord(value))
+        return undefined;
+    const adapter = toTrimmedString(value.adapter);
+    const endpointKey = toTrimmedString(value.endpointKey);
+    const conversationId = toTrimmedString(value.conversationId);
+    const minMagnitude = toFiniteNumber(value.minMagnitude);
+    if (!adapter || !endpointKey || !conversationId || minMagnitude === undefined)
+        return undefined;
+    if (!isConversationKind(value.conversationKind))
+        return undefined;
+    const regions = Array.isArray(value.regions)
+        ? value.regions.filter((region) => typeof region === 'string' && region.trim() !== '')
+        : [];
+    return {
+        adapter,
+        endpointKey,
+        conversationKind: value.conversationKind,
+        conversationId,
+        minMagnitude,
+        regions,
+        createdBy: toTrimmedString(value.createdBy) ?? '',
+        createdAt: toTrimmedString(value.createdAt) ?? '',
+    };
+}
+export function createMemoryState() {
+    const values = new Map();
+    return {
+        async get(key) {
+            return structuredClone(values.get(key));
+        },
+        async set(key, value) {
+            values.set(key, structuredClone(value));
+        },
+    };
+}
+export class SubscriptionStore {
+    #state;
+    #maxSubscriptions;
+    #queue = Promise.resolve();
+    constructor(state, options) {
+        this.#state = state;
+        this.#maxSubscriptions = options.maxSubscriptions;
+    }
+    async list() {
+        const stored = await this.#state.get(SUBSCRIPTIONS_STATE_KEY);
+        if (!Array.isArray(stored))
+            return [];
+        const subscriptions = [];
+        for (const entry of stored) {
+            const parsed = parseStoredSubscription(entry);
+            if (parsed)
+                subscriptions.push(parsed);
+        }
+        return subscriptions;
+    }
+    async get(key) {
+        const all = await this.list();
+        return all.find((subscription) => subscriptionKey(subscription) === key);
+    }
+    /** Creates or replaces this conversation's subscription. */
+    async upsert(subscription) {
+        return this.#serialize(async () => {
+            const all = await this.list();
+            const key = subscriptionKey(subscription);
+            const index = all.findIndex((existing) => subscriptionKey(existing) === key);
+            if (index === -1 && all.length >= this.#maxSubscriptions) {
+                throw new SubscriptionLimitError(this.#maxSubscriptions);
+            }
+            if (index === -1) {
+                all.push(subscription);
+            }
+            else {
+                all[index] = subscription;
+            }
+            await this.#write(all);
+            return { created: index === -1 };
+        });
+    }
+    async remove(key) {
+        return this.#serialize(async () => {
+            const all = await this.list();
+            const remaining = all.filter((subscription) => subscriptionKey(subscription) !== key);
+            if (remaining.length === all.length)
+                return false;
+            await this.#write(remaining);
+            return true;
+        });
+    }
+    async #write(subscriptions) {
+        const plain = subscriptions.map((subscription) => ({ ...subscription, regions: [...subscription.regions] }));
+        await this.#state.set(SUBSCRIPTIONS_STATE_KEY, plain);
+    }
+    #serialize(operation) {
+        const next = this.#queue.then(operation, operation);
+        this.#queue = next.catch(() => undefined);
+        return next;
+    }
+}
+export class SubscriptionLimitError extends Error {
+    constructor(limit) {
+        super(`订阅总数已达上限（${limit}），请联系管理员调整 maxSubscriptions`);
+        this.name = 'SubscriptionLimitError';
+    }
+}
+//# sourceMappingURL=subscriptions.js.map

package/lib/subscriptions.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,36 @@
+import type { EarthquakeSourceId } from './config.js';
+/** One earthquake as reported by a single source, normalised to SI-ish units. */
+export interface SourceEarthquake {
+    readonly source: EarthquakeSourceId;
+    /** Source-scoped id, stable across polls. */
+    readonly id: string;
+    /** Origin time, epoch milliseconds (UTC). */
+    readonly time: number;
+    readonly latitude: number;
+    readonly longitude: number;
+    /** Hypocentre depth in kilometres; undefined when the source omits it. */
+    readonly depthKm?: number;
+    readonly magnitude: number;
+    /** Human-readable place as published by the source. */
+    readonly location: string;
+    readonly url?: string;
+}
+/**
+ * The same physical event after cross-source merging.
+ * The primary report comes from the most preferred source that saw the event.
+ */
+export interface EarthquakeEvent {
+    readonly primary: SourceEarthquake;
+    /** Every report merged into this event, primary first. */
+    readonly reports: readonly SourceEarthquake[];
+}
+/** Per-source outcome of one fetch round. */
+export interface SourceOutcome {
+    readonly source: EarthquakeSourceId;
+    readonly ok: boolean;
+    /** True when the source was skipped because it is cooling down after failures. */
+    readonly skipped?: boolean;
+    readonly error?: string;
+    readonly eventCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC/C;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}