@mxpicture/tesla-superchargers-api 0.1.1

package/dist/api/ChargersApi.d.ts

@@ -0,0 +1,53 @@
+import { type PicChargers, type PicPricebooks, type PicSlugsId } from "@mxpicture/tesla-superchargers-generated/public";
+import { type TeslaClientCharger } from "@mxpicture/tesla-superchargers-mate/client";
+import type { CoordinateAny } from "@mxpicture/tesla-superchargers-mate/common";
+import { IApi } from "./IApi.js";
+import type { SyncSummary } from "../types/sync.types.js";
+export declare class ChargersApi extends IApi {
+    /**
+     * Find the Supercharger at a coordinate: try the nearby slug rows
+     * (slugs first — their location_url_slug is the canonical details slug),
+     * answer from the db when the cached charger is fresh, otherwise fetch and
+     * store it via the chargers sync. Candidates whose failure_count reached
+     * {@link FAILURE_DEPRIORITIZE_THRESHOLD} are tried last (still by
+     * distance within each bucket). Returns the first confirmed charger; a
+     * failed fetch bumps the source row's failure_count and moves on. A stale
+     * cached charger is returned rather than nothing when its refresh fails or
+     * the fetch budget is spent.
+     */
+    find(item: CoordinateAny, locale?: string): Promise<PicChargers | null>;
+    /**
+     * The pricebook rows valid at `at` for the Supercharger at a coordinate.
+     * The charger is resolved from the stored rows first — soft-deleted
+     * included, since a site Tesla removed from the feed has no slug left to
+     * resolve but its price history stays valid for past dates. Stored history
+     * fully answers any `at` up to the row's last fetch; only when there is no
+     * stored charger, or `at` lies after a stale row's last fetch, does the
+     * slug-based lookup (which may fetch and store the site on demand) run,
+     * falling back to the stored row when it finds nothing. From the resolved
+     * charger the pricebook group valid at `at` is taken and filtered to the
+     * rows whose time-of-use window covers `at` in the charger's time zone.
+     * All variants (member/non-member × vehicle make × fee type) are returned.
+     * When `at` predates the first recorded group (always the case right after
+     * a fetch-on-demand stored the charger's first group), that earliest group
+     * is used as the best available estimate.
+     */
+    findPrices(item: CoordinateAny, at: Date): Promise<PicPricebooks[]>;
+    initialLoadFile(path: string): Promise<void>;
+    /**
+     * Fetch one charger by its details slug and upsert it on `location_guid`,
+     * recording its pricebooks as history in the same transaction: when no
+     * price changed, the current group is only re-stamped with the fetch's
+     * uuid; when one did, a new group is inserted and the old rows stay as
+     * history. A successful fetch resurrects the row and resets
+     * `failure_count`; `ids` links it to the slug rows it was found through
+     * (existing links are kept when `ids` is omitted). Throws when the
+     * endpoint returns no charger.
+     */
+    syncLoad(slug: string, locale: string, slugsId?: PicSlugsId): Promise<PicChargers>;
+    /** Snapshot sync from a full-feed file dump. Does not touch pricebooks. */
+    syncLoadFile(path: string): Promise<SyncSummary>;
+    protected _syncLoad(clientDocs: TeslaClientCharger[]): Promise<SyncSummary>;
+}
+export declare const chargersApi: () => ChargersApi;
+//# sourceMappingURL=ChargersApi.d.ts.map

package/dist/api/ChargersApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChargersApi.d.ts","sourceRoot":"","sources":["../../src/api/ChargersApi.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,4CAA4C,CAAC;AAOpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAQhF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1D,qBAAa,WAAY,SAAQ,IAAI;IACnC;;;;;;;;;;OAUG;IACU,IAAI,CACf,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,MAAgB,GACvB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA8D9B;;;;;;;;;;;;;;;OAeG;IACU,UAAU,CACrB,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,IAAI,GACP,OAAO,CAAC,aAAa,EAAE,CAAC;IAmBd,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzD;;;;;;;;;OASG;IACU,QAAQ,CACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,WAAW,CAAC;IAgDvB,2EAA2E;IAC9D,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;cAK7C,SAAS,CACvB,UAAU,EAAE,kBAAkB,EAAE,GAC/B,OAAO,CAAC,WAAW,CAAC;CAkBxB;AAGD,eAAO,MAAM,WAAW,mBAAqC,CAAC"}

package/dist/api/ChargersApi.js

@@ -0,0 +1,173 @@
+import { createMeta, chargerToInitializer, pricebookToInitializer, } from "@mxpicture/tesla-superchargers-mate/transform";
+import { readFile } from "node:fs/promises";
+import json5 from "json5";
+import { picChargersInitializerKeys, } from "@mxpicture/tesla-superchargers-generated/public";
+import { teslaClient, teslaClientChargersSchema, } from "@mxpicture/tesla-superchargers-mate/client";
+import { picChargersStore, picPricebooksStore, picSlugsStore, transaction, } from "@mxpicture/tesla-superchargers-mate/store";
+import { FAILURE_DEPRIORITIZE_THRESHOLD, isFresh, MAX_CHARGER_FETCHES, withoutFkColumns, } from "../common/chargers.common.js";
+import { IApi } from "./IApi.js";
+import { syncColumns, syncSnapshot } from "../common/sync.common.js";
+import { pricebookCoversInstant, samePricebookGroup, } from "../common/pricebooks.common.js";
+export class ChargersApi extends IApi {
+    /**
+     * Find the Supercharger at a coordinate: try the nearby slug rows
+     * (slugs first — their location_url_slug is the canonical details slug),
+     * answer from the db when the cached charger is fresh, otherwise fetch and
+     * store it via the chargers sync. Candidates whose failure_count reached
+     * {@link FAILURE_DEPRIORITIZE_THRESHOLD} are tried last (still by
+     * distance within each bucket). Returns the first confirmed charger; a
+     * failed fetch bumps the source row's failure_count and moves on. A stale
+     * cached charger is returned rather than nothing when its refresh fails or
+     * the fetch budget is spent.
+     */
+    async find(item, locale = "de-DE") {
+        const founds = await picSlugsStore().findByCoordinate(item);
+        const candidates = founds.map((found) => ({
+            slug: found.location_url_slug,
+            slugsId: found.id,
+            failureCount: found.failure_count,
+        }));
+        // deprioritize (not skip) repeat failers; the sort is stable, so the
+        // nearest-first order is kept within each bucket
+        candidates.sort((a, b) => Number(a.failureCount >= FAILURE_DEPRIORITIZE_THRESHOLD) -
+            Number(b.failureCount >= FAILURE_DEPRIORITIZE_THRESHOLD));
+        const seen = new Set();
+        let fetches = 0;
+        const chargersStore = picChargersStore();
+        const slugsStore = picSlugsStore();
+        for (const candidate of candidates) {
+            if (seen.has(candidate.slug))
+                continue;
+            seen.add(candidate.slug);
+            const cached = await chargersStore.getBySlug(candidate.slugsId);
+            if (cached && isFresh(cached))
+                return cached;
+            if (fetches >= MAX_CHARGER_FETCHES) {
+                if (cached)
+                    return cached; // stale beats nothing
+                continue;
+            }
+            fetches++;
+            try {
+                const charger = await this.syncLoad(candidate.slug, locale, candidate.slugsId);
+                if (charger.failure_count > 0)
+                    await chargersStore.resetFailed(charger.id);
+                await slugsStore.resetFailed(candidate.slugsId);
+                return charger;
+            }
+            catch {
+                // record the failure where it happened: a failed refresh on the
+                // charger row, a failed first fetch on the slug row
+                if (cached) {
+                    cached.failure_count = await chargersStore.incrementFailed(cached.id);
+                    return cached; // stale beats nothing
+                }
+                candidate.failureCount = await slugsStore.incrementFailed(candidate.slugsId);
+            }
+        }
+        return null;
+    }
+    /**
+     * The pricebook rows valid at `at` for the Supercharger at a coordinate.
+     * The charger is resolved from the stored rows first — soft-deleted
+     * included, since a site Tesla removed from the feed has no slug left to
+     * resolve but its price history stays valid for past dates. Stored history
+     * fully answers any `at` up to the row's last fetch; only when there is no
+     * stored charger, or `at` lies after a stale row's last fetch, does the
+     * slug-based lookup (which may fetch and store the site on demand) run,
+     * falling back to the stored row when it finds nothing. From the resolved
+     * charger the pricebook group valid at `at` is taken and filtered to the
+     * rows whose time-of-use window covers `at` in the charger's time zone.
+     * All variants (member/non-member × vehicle make × fee type) are returned.
+     * When `at` predates the first recorded group (always the case right after
+     * a fetch-on-demand stored the charger's first group), that earliest group
+     * is used as the best available estimate.
+     */
+    async findPrices(item, at) {
+        const stored = (await picChargersStore().findByCoordinate(item))[0] ?? null;
+        let charger = stored;
+        if (!stored || (at > stored.fetched_at && !isFresh(stored)))
+            charger = (await this.find(item)) ?? stored;
+        if (!charger)
+            return [];
+        const pricebooksStore = picPricebooksStore();
+        const group = await pricebooksStore.getGroupAt(charger.id, at);
+        const rows = group.length > 0
+            ? group
+            : await pricebooksStore.getEarliestGroup(charger.id);
+        return rows.filter((row) => pricebookCoversInstant(row, at, charger.time_zone));
+    }
+    async initialLoadFile(path) {
+        const json = json5.parse(await readFile(path, { encoding: "utf8" }));
+        const meta = createMeta();
+        await this.initialInserts(picChargersStore(), teslaClientChargersSchema.parse(json), (charger) => chargerToInitializer({ charger, meta }));
+    }
+    /**
+     * Fetch one charger by its details slug and upsert it on `location_guid`,
+     * recording its pricebooks as history in the same transaction: when no
+     * price changed, the current group is only re-stamped with the fetch's
+     * uuid; when one did, a new group is inserted and the old rows stay as
+     * history. A successful fetch resurrects the row and resets
+     * `failure_count`; `ids` links it to the slug rows it was found through
+     * (existing links are kept when `ids` is omitted). Throws when the
+     * endpoint returns no charger.
+     */
+    async syncLoad(slug, locale, slugsId) {
+        const clientDoc = await teslaClient().fetchCharger(slug, locale);
+        if (!clientDoc.charger)
+            throw new Error(`charger fetch for slug "${slug}" returned no charger` +
+                (clientDoc.reason ? `: ${clientDoc.reason}` : "") +
+                ` (${clientDoc.attempts} attempts)`);
+        const charger = clientDoc.charger;
+        const meta = createMeta();
+        const init = chargerToInitializer({ charger, meta, slugsId });
+        const chargersStore = picChargersStore();
+        const pricebooksStore = picPricebooksStore();
+        return await transaction(chargersStore.table, async (tx) => {
+            const row = await chargersStore.upsertOne(init, 
+            // update only the columns present in the initializer, so omitted ids
+            // don't overwrite existing FK links with NULL
+            { conflictColumn: "location_guid", updateColumns: Object.keys(init) }, tx);
+            const current = await pricebooksStore.getCurrentGroup(row.id, tx);
+            const next = charger.effectivePricebooks.map((pricebook) => pricebookToInitializer({ pricebook, meta, chargersId: row.id }));
+            if (next.length === 0) {
+                // an empty group cannot be represented by rows — keep the last
+                // known prices instead of pretending they vanished
+                if (current.length > 0)
+                    console.warn(`charger ${row.id} (slug "${slug}"): fetch returned no pricebooks — keeping last known prices`);
+            }
+            else if (samePricebookGroup(current, next)) {
+                // current is non-empty here: next is non-empty and the groups match
+                await pricebooksStore.updateGroupFetchUuid(row.id, current[0].last_fetch_uuid, meta.last_fetch_uuid, tx);
+            }
+            else {
+                await pricebooksStore.insertMany(next, tx);
+            }
+            return row;
+        });
+    }
+    /** Snapshot sync from a full-feed file dump. Does not touch pricebooks. */
+    async syncLoadFile(path) {
+        const json = json5.parse(await readFile(path, { encoding: "utf8" }));
+        return await this._syncLoad(teslaClientChargersSchema.parse(json));
+    }
+    async _syncLoad(clientDocs) {
+        const meta = createMeta();
+        const { compareColumns, updateColumns } = syncColumns(picChargersInitializerKeys);
+        return await syncSnapshot({
+            store: picChargersStore(),
+            clientDocs,
+            meta,
+            toInitializer: (charger) => chargerToInitializer({ charger, meta }),
+            keyOfInit: (doc) => doc.location_guid,
+            keyOfDb: (doc) => doc.location_guid,
+            deleteAbsent: "soft",
+            conflictColumn: "location_guid",
+            compareColumns: withoutFkColumns(compareColumns),
+            updateColumns: withoutFkColumns(updateColumns),
+        });
+    }
+}
+let _api = null;
+export const chargersApi = () => (_api ??= new ChargersApi());
+//# sourceMappingURL=ChargersApi.js.map

package/dist/api/ChargersApi.js.map

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

package/dist/api/ChargingProcessesApi.d.ts

@@ -0,0 +1,11 @@
+import { type ChargingProcesses, type ChargingProcessesId } from "@mxpicture/tesla-superchargers-generated/public";
+import type { UnpricedChargingProcess } from "@mxpicture/tesla-superchargers-mate/types";
+import type { PricingSummary } from "../types/charging.types.js";
+import { IApi } from "./IApi.js";
+export declare class ChargingProcessesApi extends IApi {
+    runPricing(): Promise<PricingSummary>;
+    getUnpricedCharges(): Promise<UnpricedChargingProcess[]>;
+    updatePrice(processId: ChargingProcessesId, cost: number | null): Promise<ChargingProcesses>;
+}
+export declare const chargingProcessesApi: () => ChargingProcessesApi;
+//# sourceMappingURL=ChargingProcessesApi.d.ts.map

package/dist/api/ChargingProcessesApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChargingProcessesApi.d.ts","sourceRoot":"","sources":["../../src/api/ChargingProcessesApi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,iDAAiD,CAAC;AAEzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEzF,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,qBAAa,oBAAqB,SAAQ,IAAI;IAC/B,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAoDrC,kBAAkB,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAIxD,WAAW,CACtB,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,OAAO,CAAC,iBAAiB,CAAC;CAG9B;AAGD,eAAO,MAAM,oBAAoB,4BAA8C,CAAC"}

package/dist/api/ChargingProcessesApi.js

@@ -0,0 +1,56 @@
+import {} from "@mxpicture/tesla-superchargers-generated/public";
+import { chargingProcessesStore } from "@mxpicture/tesla-superchargers-mate/store";
+import { chargersApi } from "./ChargersApi.js";
+import { IApi } from "./IApi.js";
+import { teslaChargingRate } from "../common/pricebooks.common.js";
+import { FAILURE_DEPRIORITIZE_THRESHOLD } from "../common/chargers.common.js";
+export class ChargingProcessesApi extends IApi {
+    async runPricing() {
+        const store = chargingProcessesStore();
+        const charges = await this.getUnpricedCharges();
+        const summary = {
+            unpricedCharges: charges.length,
+            items: [],
+        };
+        for (const charge of charges) {
+            const item = { charge, topic: "unknown" };
+            summary.items.push(item);
+            if (charge.failure_count &&
+                charge.failure_count >= FAILURE_DEPRIORITIZE_THRESHOLD) {
+                item.topic = "failureLimitReached";
+                continue;
+            }
+            const pricebooks = await chargersApi().findPrices({ latitude: charge.latitude, longitude: charge.longitude }, charge.start_date);
+            const rate = teslaChargingRate(pricebooks);
+            item.rate = rate;
+            if (!rate) {
+                item.topic = "noRate";
+                item.failure_count = await store.incrementStateFailed(item.charge.id);
+                continue;
+            }
+            const energy = charge.charge_energy_used ?? charge.charge_energy_added;
+            item.energy = energy;
+            if (energy === null || !Number.isFinite(Number(energy))) {
+                item.topic = "noEnergyValue";
+                item.failure_count = await store.incrementStateFailed(item.charge.id);
+                continue;
+            }
+            const cost = Number((rate.rate * Number(energy)).toFixed(2));
+            item.cost = cost;
+            await chargingProcessesApi().updatePrice(charge.id, cost);
+            item.topic = "chargeUpdated";
+            item.failure_count = 0;
+            await store.resetState(item.charge.id);
+        }
+        return summary;
+    }
+    async getUnpricedCharges() {
+        return await chargingProcessesStore().getUnpricedCharges();
+    }
+    async updatePrice(processId, cost) {
+        return await chargingProcessesStore().updatePrice(processId, cost);
+    }
+}
+let _api = null;
+export const chargingProcessesApi = () => (_api ??= new ChargingProcessesApi());
+//# sourceMappingURL=ChargingProcessesApi.js.map

package/dist/api/ChargingProcessesApi.js.map

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

package/dist/api/FailuresApi.d.ts

@@ -0,0 +1,38 @@
+import { IApi } from "./IApi.js";
+import type { FailedSources, FailureNotifySummary, FailureSource } from "../types/failures.types.js";
+/**
+ * Inspect, reset and page about the failing rows across the three
+ * failure-tracked sources (charges, chargers, slugs). Notification semantics:
+ * a row is paged once when it crosses the threshold; a growing count never
+ * re-pages, only a reset (successful fetch/pricing or a manual reset) re-arms.
+ */
+export declare class FailuresApi extends IApi {
+    /**
+     * Failing rows for one source or all three, at or above `threshold`. With
+     * `onlyUnnotified` only rows not yet paged are returned; non-requested
+     * sources stay empty.
+     */
+    getFailed(source: FailureSource | "all", threshold?: number, onlyUnnotified?: boolean): Promise<FailedSources>;
+    /**
+     * Reset one row's failure state. For charges the id is the
+     * `charging_processes_id` and the reset deletes the state row; for
+     * chargers/slugs the id is the row id.
+     */
+    resetFailed(source: FailureSource, id: string): Promise<void>;
+    /** Reset every failing row for one source or all three; returns per-source counts. */
+    resetAllFailed(source: FailureSource | "all"): Promise<{
+        charges: number;
+        chargers: number;
+        slugs: number;
+    }>;
+    /**
+     * Page (Pushover) about not-yet-notified failures at or above `threshold`,
+     * each failure exactly once: on a successful send the included rows get their
+     * `failure_notified_at` stamped so a growing count never re-pages. A no-op
+     * (nothing sent, nothing marked) when there is nothing to report or Pushover
+     * is unconfigured; the per-source counts are reported either way.
+     */
+    notifyFailures(threshold?: number, logger?: (m: string) => void): Promise<FailureNotifySummary>;
+}
+export declare const failuresApi: () => FailuresApi;
+//# sourceMappingURL=FailuresApi.d.ts.map

package/dist/api/FailuresApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailuresApi.d.ts","sourceRoot":"","sources":["../../src/api/FailuresApi.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,IAAI;IACnC;;;;OAIG;IACU,SAAS,CACpB,MAAM,EAAE,aAAa,GAAG,KAAK,EAC7B,SAAS,GAAE,MAAuC,EAClD,cAAc,UAAQ,GACrB,OAAO,CAAC,aAAa,CAAC;IAmBzB;;;;OAIG;IACU,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1E,sFAAsF;IACzE,cAAc,CACzB,MAAM,EAAE,aAAa,GAAG,KAAK,GAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAahE;;;;;;OAMG;IACU,cAAc,CACzB,SAAS,GAAE,MAAuC,EAClD,MAAM,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAe,GACrC,OAAO,CAAC,oBAAoB,CAAC;CAwBjC;AAGD,eAAO,MAAM,WAAW,mBAAqC,CAAC"}

package/dist/api/FailuresApi.js

@@ -0,0 +1,88 @@
+import { chargingProcessesStore, picChargersStore, picSlugsStore, } from "@mxpicture/tesla-superchargers-mate/store";
+import { FAILURE_DEPRIORITIZE_THRESHOLD } from "../common/chargers.common.js";
+import { buildFailureMessage } from "../common/failures.common.js";
+import { pushoverConfigFromEnv, sendPushover, } from "../common/pushover.common.js";
+import { IApi } from "./IApi.js";
+/**
+ * Inspect, reset and page about the failing rows across the three
+ * failure-tracked sources (charges, chargers, slugs). Notification semantics:
+ * a row is paged once when it crosses the threshold; a growing count never
+ * re-pages, only a reset (successful fetch/pricing or a manual reset) re-arms.
+ */
+export class FailuresApi extends IApi {
+    /**
+     * Failing rows for one source or all three, at or above `threshold`. With
+     * `onlyUnnotified` only rows not yet paged are returned; non-requested
+     * sources stay empty.
+     */
+    async getFailed(source, threshold = FAILURE_DEPRIORITIZE_THRESHOLD, onlyUnnotified = false) {
+        const result = { charges: [], chargers: [], slugs: [] };
+        if (source === "all" || source === "charges")
+            result.charges = await chargingProcessesStore().getFailedStates(threshold, onlyUnnotified);
+        if (source === "all" || source === "chargers")
+            result.chargers = await picChargersStore().getFailed(threshold, onlyUnnotified);
+        if (source === "all" || source === "slugs")
+            result.slugs = await picSlugsStore().getFailed(threshold, onlyUnnotified);
+        return result;
+    }
+    /**
+     * Reset one row's failure state. For charges the id is the
+     * `charging_processes_id` and the reset deletes the state row; for
+     * chargers/slugs the id is the row id.
+     */
+    async resetFailed(source, id) {
+        switch (source) {
+            case "charges":
+                await chargingProcessesStore().resetState(Number(id));
+                return;
+            case "chargers":
+                await picChargersStore().resetFailed(id);
+                return;
+            case "slugs":
+                await picSlugsStore().resetFailed(id);
+                return;
+        }
+    }
+    /** Reset every failing row for one source or all three; returns per-source counts. */
+    async resetAllFailed(source) {
+        const counts = { charges: 0, chargers: 0, slugs: 0 };
+        if (source === "all" || source === "charges")
+            counts.charges = await chargingProcessesStore().resetAllStates();
+        if (source === "all" || source === "chargers")
+            counts.chargers = await picChargersStore().resetAllFailed();
+        if (source === "all" || source === "slugs")
+            counts.slugs = await picSlugsStore().resetAllFailed();
+        return counts;
+    }
+    /**
+     * Page (Pushover) about not-yet-notified failures at or above `threshold`,
+     * each failure exactly once: on a successful send the included rows get their
+     * `failure_notified_at` stamped so a growing count never re-pages. A no-op
+     * (nothing sent, nothing marked) when there is nothing to report or Pushover
+     * is unconfigured; the per-source counts are reported either way.
+     */
+    async notifyFailures(threshold = FAILURE_DEPRIORITIZE_THRESHOLD, logger = () => { }) {
+        const cfg = pushoverConfigFromEnv();
+        const failed = await this.getFailed("all", threshold, true);
+        const summary = {
+            configured: cfg != null,
+            sent: false,
+            charges: failed.charges.length,
+            chargers: failed.chargers.length,
+            slugs: failed.slugs.length,
+        };
+        const message = buildFailureMessage(failed);
+        if (!message || !cfg)
+            return summary;
+        if (!(await sendPushover(cfg, message, logger)))
+            return summary;
+        summary.sent = true;
+        await chargingProcessesStore().markStatesNotified(failed.charges.map((c) => c.id));
+        await picChargersStore().markNotified(failed.chargers.map((c) => c.id));
+        await picSlugsStore().markNotified(failed.slugs.map((s) => s.id));
+        return summary;
+    }
+}
+let _api = null;
+export const failuresApi = () => (_api ??= new FailuresApi());
+//# sourceMappingURL=FailuresApi.js.map

package/dist/api/FailuresApi.js.map

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

package/dist/api/IApi.d.ts

@@ -0,0 +1,6 @@
+import { type IMateStore } from "@mxpicture/tesla-superchargers-mate/store";
+export declare abstract class IApi {
+    constructor();
+    protected initialInserts<T extends object, INITIALZER extends object, STORE extends IMateStore<any, any, INITIALZER, any>>(store: STORE, rows: T[], transform: (row: T) => INITIALZER): Promise<number>;
+}
+//# sourceMappingURL=IApi.d.ts.map

package/dist/api/IApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IApi.d.ts","sourceRoot":"","sources":["../../src/api/IApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,2CAA2C,CAAC;AAEnD,8BAAsB,IAAI;;cAGR,cAAc,CAC5B,CAAC,SAAS,MAAM,EAChB,UAAU,SAAS,MAAM,EAEzB,KAAK,SAAS,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,EAEnD,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,CAAC,EAAE,EACT,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,UAAU,GAChC,OAAO,CAAC,MAAM,CAAC;CAMnB"}

package/dist/api/IApi.js

@@ -0,0 +1,11 @@
+import { transaction, } from "@mxpicture/tesla-superchargers-mate/store";
+export class IApi {
+    constructor() { }
+    async initialInserts(store, rows, transform) {
+        return await transaction(store.table, async (tx) => {
+            await store.deleteAll(tx);
+            return await store.insertMany(rows.map(transform), tx);
+        });
+    }
+}
+//# sourceMappingURL=IApi.js.map

package/dist/api/IApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IApi.js","sourceRoot":"","sources":["../../src/api/IApi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAEZ,MAAM,2CAA2C,CAAC;AAEnD,MAAM,OAAgB,IAAI;IACxB,gBAAsB,CAAC;IAEb,KAAK,CAAC,cAAc,CAM5B,KAAY,EACZ,IAAS,EACT,SAAiC;QAEjC,OAAO,MAAM,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACjD,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC1B,OAAO,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/api/SlugsApi.d.ts

@@ -0,0 +1,15 @@
+import type { TeslaClientSlug } from "@mxpicture/tesla-superchargers-mate/client";
+import type { CoordinateAny } from "@mxpicture/tesla-superchargers-mate/common";
+import type { PicSlugsDistance } from "@mxpicture/tesla-superchargers-mate/types";
+import { IApi } from "./IApi.js";
+import type { SyncSummary } from "../types/sync.types.js";
+export declare class SlugsApi extends IApi {
+    find(item: CoordinateAny): Promise<PicSlugsDistance[]>;
+    initialLoad(): Promise<SyncSummary>;
+    initialLoadFile(path: string): Promise<SyncSummary>;
+    syncLoad(): Promise<SyncSummary>;
+    syncLoadFile(path: string): Promise<SyncSummary>;
+    protected _syncLoad(clientDocs: TeslaClientSlug[]): Promise<SyncSummary>;
+}
+export declare const slugsApi: () => SlugsApi;
+//# sourceMappingURL=SlugsApi.d.ts.map

package/dist/api/SlugsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlugsApi.d.ts","sourceRoot":"","sources":["../../src/api/SlugsApi.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAY1D,qBAAa,QAAS,SAAQ,IAAI;IACnB,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAItD,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAgBnC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAgBnD,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAKhC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;cAI7C,SAAS,CACvB,UAAU,EAAE,eAAe,EAAE,GAC5B,OAAO,CAAC,WAAW,CAAC;CAexB;AAGD,eAAO,MAAM,QAAQ,gBAAkC,CAAC"}

package/dist/api/SlugsApi.js

@@ -0,0 +1,68 @@
+import { parseTeslaClientSlugs, teslaClient, } from "@mxpicture/tesla-superchargers-mate/client";
+import { createMeta, slugToInitializer, } from "@mxpicture/tesla-superchargers-mate/transform";
+import { readFile } from "node:fs/promises";
+import json5 from "json5";
+import { picSlugsInitializerKeys } from "@mxpicture/tesla-superchargers-generated/public";
+import { picSlugsStore } from "@mxpicture/tesla-superchargers-mate/store";
+import { IApi } from "./IApi.js";
+import { syncSnapshot, syncColumns } from "../common/sync.common.js";
+/** Per-element parse of a slugs file dump; invalid entries are skipped, not fatal. */
+const readSlugsFile = async (path) => {
+    const json = json5.parse(await readFile(path, { encoding: "utf8" }));
+    const { slugs, invalid } = parseTeslaClientSlugs(json);
+    if (invalid > 0)
+        console.warn(`slugs file "${path}": skipped ${invalid} invalid entries`);
+    return slugs;
+};
+export class SlugsApi extends IApi {
+    async find(item) {
+        return await picSlugsStore().findByCoordinate(item);
+    }
+    async initialLoad() {
+        const meta = createMeta();
+        const count = await this.initialInserts(picSlugsStore(), await teslaClient().fetchSlugs(), (slug) => slugToInitializer({ slug, meta }));
+        return {
+            feedCount: count,
+            feedDuplicates: 0,
+            feedNullKeys: 0,
+            upserted: count,
+            deleted: 0,
+        };
+    }
+    async initialLoadFile(path) {
+        const meta = createMeta();
+        const count = await this.initialInserts(picSlugsStore(), await readSlugsFile(path), (slug) => slugToInitializer({ slug, meta }));
+        return {
+            feedCount: count,
+            feedDuplicates: 0,
+            feedNullKeys: 0,
+            upserted: count,
+            deleted: 0,
+        };
+    }
+    async syncLoad() {
+        const clientDocs = await teslaClient().fetchSlugs();
+        return await this._syncLoad(clientDocs);
+    }
+    async syncLoadFile(path) {
+        return await this._syncLoad(await readSlugsFile(path));
+    }
+    async _syncLoad(clientDocs) {
+        const meta = createMeta();
+        return await syncSnapshot({
+            store: picSlugsStore(),
+            clientDocs,
+            meta,
+            toInitializer: (slug) => slugToInitializer({ slug, meta }),
+            keyOfInit: (doc) => doc.tesla_uuid ?? null,
+            keyOfDb: (doc) => doc.tesla_uuid,
+            // the table mirrors the feed: rows absent from it are hard-deleted
+            deleteAbsent: "hard",
+            conflictColumn: "tesla_uuid",
+            ...syncColumns(picSlugsInitializerKeys),
+        });
+    }
+}
+let _api = null;
+export const slugsApi = () => (_api ??= new SlugsApi());
+//# sourceMappingURL=SlugsApi.js.map

package/dist/api/SlugsApi.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./ChargersApi.js";
+export * from "./ChargingProcessesApi.js";
+export * from "./FailuresApi.js";
+export * from "./IApi.js";
+export * from "./SlugsApi.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,7 @@
+// This file is auto-generated by build-cli. Do not edit manually.
+export * from "./ChargersApi.js";
+export * from "./ChargingProcessesApi.js";
+export * from "./FailuresApi.js";
+export * from "./IApi.js";
+export * from "./SlugsApi.js";
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/common/chargers.common.d.ts

@@ -0,0 +1,11 @@
+import type { PicChargers } from "@mxpicture/tesla-superchargers-generated/public";
+/** Refetch a cached charger whose last fetch is older than this. */
+export declare const CHARGER_STALE_AFTER_DAYS = 5;
+/** Detail fetches per findByCoordinate call — the endpoint is slow and guarded. */
+export declare const MAX_CHARGER_FETCHES = 3;
+/** Candidates that failed this often are tried after the rest, so dead slugs stop burning the fetch budget first. */
+export declare const FAILURE_DEPRIORITIZE_THRESHOLD = 3;
+export declare const isFresh: (row: PicChargers) => boolean;
+/** FK links are not part of the feed; a snapshot re-sync must not wipe them. */
+export declare const withoutFkColumns: (columns: string[]) => string[];
+//# sourceMappingURL=chargers.common.d.ts.map

package/dist/common/chargers.common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chargers.common.d.ts","sourceRoot":"","sources":["../../src/common/chargers.common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAEnF,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,qHAAqH;AACrH,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,eAAO,MAAM,OAAO,GAAI,KAAK,WAAW,KAAG,OAEkB,CAAC;AAE9D,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,KAAG,MAAM,EACJ,CAAC"}