@mxpicture/tesla-superchargers-mate 0.1.1

package/dist/client/slugs.clients.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+/**
+ * ---------------------------------------------------------------------------------
+ * ----------------------- slug ----------------------------------------------------
+ * ---------------------------------------------------------------------------------
+ */
+export declare const teslaClientSlugSchema: z.ZodObject<{
+    inCN: z.ZodBoolean;
+    inHkMoTw: z.ZodBoolean;
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    location_type: z.ZodArray<z.ZodString>;
+    location_url_slug: z.ZodString;
+    supercharger_function: z.ZodOptional<z.ZodObject<{
+        access_type: z.ZodString;
+        actual_latitude: z.ZodString;
+        actual_longitude: z.ZodString;
+        charging_accessibility: z.ZodString;
+        coming_soon_latitude: z.ZodNullable<z.ZodString>;
+        coming_soon_longitude: z.ZodNullable<z.ZodString>;
+        coming_soon_name: z.ZodNullable<z.ZodString>;
+        open_to_non_tesla: z.ZodBoolean;
+        project_status: z.ZodString;
+        show_on_find_us: z.ZodString;
+        site_status: z.ZodString;
+        vote_winner_quarter: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    title: z.ZodString;
+    uuid: z.ZodString;
+}, z.core.$strip>;
+export type TeslaClientSlug = z.infer<typeof teslaClientSlugSchema>;
+export declare const teslaClientSlugsResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        data: z.ZodArray<z.ZodUnknown>;
+        success: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type TeslaClientSlugsResponse = z.infer<typeof teslaClientSlugsResponseSchema>;
+/**
+ * Per-element validation of a slugs feed array: a malformed entry (schema
+ * drift on a single site) is skipped and counted instead of aborting the
+ * whole sync. Throws only when `entries` is not an array at all.
+ */
+export declare const parseTeslaClientSlugs: (entries: unknown) => {
+    slugs: TeslaClientSlug[];
+    invalid: number;
+};
+//# sourceMappingURL=slugs.clients.d.ts.map

package/dist/client/slugs.clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugs.clients.d.ts","sourceRoot":"","sources":["../../src/client/slugs.clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;iBAyBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,eAAO,MAAM,8BAA8B;;;;;iBAKzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,OAAO,KACf;IAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAS7C,CAAC"}

package/dist/client/slugs.clients.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+/**
+ * ---------------------------------------------------------------------------------
+ * ----------------------- slug ----------------------------------------------------
+ * ---------------------------------------------------------------------------------
+ */
+export const teslaClientSlugSchema = z.object({
+    inCN: z.boolean(),
+    inHkMoTw: z.boolean(),
+    latitude: z.number(),
+    longitude: z.number(),
+    location_type: z.array(z.string()),
+    location_url_slug: z.string(),
+    supercharger_function: z
+        .object({
+        access_type: z.string(),
+        actual_latitude: z.string(),
+        actual_longitude: z.string(),
+        charging_accessibility: z.string(),
+        coming_soon_latitude: z.string().nullable(),
+        coming_soon_longitude: z.string().nullable(),
+        coming_soon_name: z.string().nullable(),
+        open_to_non_tesla: z.boolean(),
+        project_status: z.string(),
+        show_on_find_us: z.string(),
+        site_status: z.string(),
+        vote_winner_quarter: z.string().nullable(),
+    })
+        .optional(),
+    title: z.string(),
+    uuid: z.string(),
+});
+// elements stay unknown: they are validated one by one via parseTeslaClientSlugs
+export const teslaClientSlugsResponseSchema = z.object({
+    data: z.object({
+        data: z.array(z.unknown()),
+        success: z.boolean().nullable().optional(),
+    }),
+});
+/**
+ * Per-element validation of a slugs feed array: a malformed entry (schema
+ * drift on a single site) is skipped and counted instead of aborting the
+ * whole sync. Throws only when `entries` is not an array at all.
+ */
+export const parseTeslaClientSlugs = (entries) => {
+    const slugs = [];
+    let invalid = 0;
+    for (const entry of z.array(z.unknown()).parse(entries)) {
+        const parsed = teslaClientSlugSchema.safeParse(entry);
+        if (parsed.success)
+            slugs.push(parsed.data);
+        else
+            invalid++;
+    }
+    return { slugs, invalid };
+};
+//# sourceMappingURL=slugs.clients.js.map

package/dist/client/slugs.clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugs.clients.js","sourceRoot":"","sources":["../../src/client/slugs.clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,qBAAqB,EAAE,CAAC;SACrB,MAAM,CAAC;QACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC5B,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE;QAClC,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3C,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACvC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE;QAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC3C,CAAC;SACD,QAAQ,EAAE;IACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAIH,iFAAiF;AACjF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KAC3C,CAAC;CACH,CAAC,CAAC;AAMH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,OAAgB,EAC+B,EAAE;IACjD,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;;YACvC,OAAO,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC,CAAC"}

package/dist/common/coordinates.d.ts

@@ -0,0 +1,31 @@
+export interface Coordinate {
+    latitude: number;
+    longitude: number;
+}
+export interface CoordinateStr {
+    latitude: string;
+    longitude: string;
+}
+export interface CoordinateAny {
+    latitude: string | number;
+    longitude: string | number;
+}
+/**
+ * Coordinate box (degrees) used as a cheap SQL prefilter before the exact
+ * haversine check below. Latitude degrees are ~constant (0.005° ≈ 555 m);
+ * longitude degrees shrink with latitude, so the longitude bound is twice as
+ * wide — 0.01° still spans the 250 m match radius up to ~77° latitude,
+ * comfortably past the northernmost Superchargers.
+ */
+export declare const COVERED_RADIUS_KM = 0.25;
+export declare const COVERED_MARGIN = 1.05;
+export declare const EARTH_RADIUS_KM = 6371;
+export declare const KM_PER_DEG_LAT = 111.32;
+export declare const distanceInKm: (a: CoordinateAny, b: CoordinateAny) => number;
+export declare const toCoordinate: (item: CoordinateAny) => Coordinate;
+export declare const toNumber: (value: string | number) => number;
+export declare const boundingBoxDeg: (item: CoordinateAny, radiusKm: number) => {
+    latDeg: number;
+    lonDeg: number;
+};
+//# sourceMappingURL=coordinates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.d.ts","sourceRoot":"","sources":["../../src/common/coordinates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,cAAc,SAAS,CAAC;AAIrC,eAAO,MAAM,YAAY,GAAI,GAAG,aAAa,EAAE,GAAG,aAAa,KAAG,MAgBjE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,aAAa,KAAG,UAGjD,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,GAAG,MAAM,KAAG,MAQjD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,aAAa,EAAE,UAAU,MAAM;;;CAOnE,CAAC"}

package/dist/common/coordinates.js

@@ -0,0 +1,44 @@
+/**
+ * Coordinate box (degrees) used as a cheap SQL prefilter before the exact
+ * haversine check below. Latitude degrees are ~constant (0.005° ≈ 555 m);
+ * longitude degrees shrink with latitude, so the longitude bound is twice as
+ * wide — 0.01° still spans the 250 m match radius up to ~77° latitude,
+ * comfortably past the northernmost Superchargers.
+ */
+export const COVERED_RADIUS_KM = 0.25;
+export const COVERED_MARGIN = 1.05; // small safety factor for the box
+export const EARTH_RADIUS_KM = 6371;
+export const KM_PER_DEG_LAT = 111.32; // near-constant everywhere
+const toRadians = (degrees) => degrees * (Math.PI / 180);
+export const distanceInKm = (a, b) => {
+    const aCoord = toCoordinate(a);
+    const bCoord = toCoordinate(b);
+    const dLat = toRadians(bCoord.latitude - aCoord.latitude);
+    const dLon = toRadians(bCoord.longitude - aCoord.longitude);
+    const lat1 = toRadians(aCoord.latitude);
+    const lat2 = toRadians(bCoord.latitude);
+    const h = Math.sin(dLat / 2) ** 2 +
+        Math.cos(lat1) * Math.cos(lat2) * Math.sin(dLon / 2) ** 2;
+    const c = 2 * Math.asin(Math.sqrt(h));
+    return EARTH_RADIUS_KM * c;
+};
+export const toCoordinate = (item) => ({
+    latitude: toNumber(item.latitude),
+    longitude: toNumber(item.longitude),
+});
+export const toNumber = (value) => {
+    const n = typeof value === "number" ? value : parseFloat(value);
+    if (Number.isNaN(n)) {
+        throw new Error(`Could not parse a numeric value from: ${JSON.stringify(value)}`);
+    }
+    return n;
+};
+export const boundingBoxDeg = (item, radiusKm) => {
+    const coord = toCoordinate(item);
+    const latDeg = radiusKm / KM_PER_DEG_LAT;
+    const cosLat = Math.cos((coord.latitude * Math.PI) / 180);
+    // guard: near the poles cos(lat) -> 0 and lonDeg explodes; clamp to full range
+    const lonDeg = cosLat > 1e-6 ? radiusKm / (KM_PER_DEG_LAT * cosLat) : 180;
+    return { latDeg, lonDeg };
+};
+//# sourceMappingURL=coordinates.js.map

package/dist/common/coordinates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.js","sourceRoot":"","sources":["../../src/common/coordinates.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,kCAAkC;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,2BAA2B;AAEjE,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAgB,EAAE,CAAgB,EAAU,EAAE;IACzE,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAExC,MAAM,CAAC,GACL,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAE5D,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtC,OAAO,eAAe,GAAG,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAmB,EAAc,EAAE,CAAC,CAAC;IAChE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAsB,EAAU,EAAE;IACzD,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,yCAAyC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAmB,EAAE,QAAgB,EAAE,EAAE;IACtE,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;IAC1D,+EAA+E;IAC/E,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC,CAAC"}

package/dist/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./coordinates.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC"}

package/dist/common/index.js

@@ -0,0 +1,3 @@
+// This file is auto-generated by build-cli. Do not edit manually.
+export * from "./coordinates.js";
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,kBAAkB,CAAC"}

package/dist/store/ChargingProcessesStore.d.ts

@@ -0,0 +1,34 @@
+import { type ChargingProcesses, type ChargingProcessesId, type ChargingProcessesInitializer, type ChargingProcessesMutator, type PicChargingProcessStates, type PicChargingProcessStatesId } from "@mxpicture/tesla-superchargers-generated/public";
+import { IMateStore } from "./IMateStore.js";
+import { type SqlTx } from "./db.js";
+import type { FailedChargingProcessState, UnpricedChargingProcess } from "../types/chargingProcess.types.js";
+/**
+ * Access to TeslaMate's `charging_processes` table. The helpers here
+ * ({@link ChargingProcessesStore.getUnpricedCharges},
+ * {@link ChargingProcessesStore.updatePrice}) will back the planned charge-cost
+ * backfill; nothing calls them yet. The backfill's guardrails, once wired up:
+ * only charges matched to one of our priced Superchargers, and only rows where
+ * `cost IS NULL` — an existing cost (TeslaMate's or the user's) is never
+ * overwritten.
+ */
+export declare class ChargingProcessesStore extends IMateStore<ChargingProcessesId, ChargingProcesses, ChargingProcessesInitializer, ChargingProcessesMutator> {
+    readonly statesTable: string;
+    constructor();
+    getUnpricedCharges(tx?: SqlTx): Promise<UnpricedChargingProcess[]>;
+    updatePrice(processId: ChargingProcessesId, cost: number | null, tx?: SqlTx): Promise<ChargingProcesses>;
+    getState(processId: ChargingProcessesId, tx?: SqlTx): Promise<PicChargingProcessStates | null>;
+    resetState(processId: ChargingProcessesId, tx?: SqlTx): Promise<void>;
+    /**
+     * Failed state rows at or above `threshold`, most-failing first, each joined
+     * to its charge's `start_date`. With `onlyUnnotified` only rows not yet paged
+     * (`failure_notified_at IS NULL`) are returned.
+     */
+    getFailedStates(threshold: number, onlyUnnotified?: boolean, tx?: SqlTx): Promise<FailedChargingProcessState[]>;
+    /** Stamp the notified flag on the given state rows (by id; empty is a no-op). */
+    markStatesNotified(stateIds: PicChargingProcessStatesId[], tx?: SqlTx): Promise<void>;
+    /** Bulk reset = delete every state row (matching single-row resetState); returns rows deleted. */
+    resetAllStates(tx?: SqlTx): Promise<number>;
+    incrementStateFailed(processId: ChargingProcessesId, tx?: SqlTx): Promise<number>;
+}
+export declare const chargingProcessesStore: () => ChargingProcessesStore;
+//# sourceMappingURL=ChargingProcessesStore.d.ts.map

package/dist/store/ChargingProcessesStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChargingProcessesStore.d.ts","sourceRoot":"","sources":["../../src/store/ChargingProcessesStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAO,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,mCAAmC,CAAC;AAG3C;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,UAAU,CACpD,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,CACzB;IACC,SAAgB,WAAW,EAAE,MAAM,CAAiC;;IAUvD,kBAAkB,CAC7B,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAuBxB,WAAW,CACtB,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,iBAAiB,CAAC;IAQhB,QAAQ,CACnB,SAAS,EAAE,mBAAmB,EAC9B,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAO9B,UAAU,CACrB,SAAS,EAAE,mBAAmB,EAC9B,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;OAIG;IACU,eAAe,CAC1B,SAAS,EAAE,MAAM,EACjB,cAAc,UAAQ,EACtB,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAWxC,iFAAiF;IACpE,kBAAkB,CAC7B,QAAQ,EAAE,0BAA0B,EAAE,EACtC,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,IAAI,CAAC;IAMhB,kGAAkG;IACrF,cAAc,CAAC,EAAE,GAAE,KAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlD,oBAAoB,CAC/B,SAAS,EAAE,mBAAmB,EAC9B,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,MAAM,CAAC;CAWnB;AAGD,eAAO,MAAM,sBAAsB,8BACQ,CAAC"}

package/dist/store/ChargingProcessesStore.js

@@ -0,0 +1,90 @@
+import { chargingProcessesInitializer, chargingProcessesMutator, } from "@mxpicture/tesla-superchargers-generated/public";
+import { IMateStore } from "./IMateStore.js";
+import { sql } from "./db.js";
+/**
+ * Access to TeslaMate's `charging_processes` table. The helpers here
+ * ({@link ChargingProcessesStore.getUnpricedCharges},
+ * {@link ChargingProcessesStore.updatePrice}) will back the planned charge-cost
+ * backfill; nothing calls them yet. The backfill's guardrails, once wired up:
+ * only charges matched to one of our priced Superchargers, and only rows where
+ * `cost IS NULL` — an existing cost (TeslaMate's or the user's) is never
+ * overwritten.
+ */
+export class ChargingProcessesStore extends IMateStore {
+    statesTable = "pic_charging_process_states";
+    constructor() {
+        super("charging_processes", chargingProcessesInitializer, chargingProcessesMutator);
+    }
+    async getUnpricedCharges(tx = sql()) {
+        return await tx `
+      SELECT
+          cp.id,
+          cp.start_date,
+          cp.end_date,
+          cp.car_id,
+          cp.position_id,
+          cp.address_id,
+          cp.charge_energy_added,
+          cp.charge_energy_used,
+          cp.duration_min,
+          p.latitude,
+          p.longitude,
+          s.id AS states_id,
+          s.failure_count
+        FROM charging_processes cp
+        INNER JOIN positions p ON p.id = cp.position_id
+        LEFT OUTER JOIN pic_charging_process_states as s ON s.charging_processes_id = cp.id
+        WHERE cp.cost IS NULL
+          AND cp.end_date IS NOT NULL;`;
+    }
+    async updatePrice(processId, cost, tx = sql()) {
+        return await this.update(processId, { cost: cost?.toString().replace(",", ".") ?? null }, tx);
+    }
+    async getState(processId, tx = sql()) {
+        const [row] = await tx `SELECT * FROM ${tx(this.statesTable)} WHERE charging_processes_id = ${processId}`;
+        return row ?? null;
+    }
+    async resetState(processId, tx = sql()) {
+        await tx `DELETE FROM ${tx(this.statesTable)} WHERE charging_processes_id = ${processId}`;
+    }
+    /**
+     * Failed state rows at or above `threshold`, most-failing first, each joined
+     * to its charge's `start_date`. With `onlyUnnotified` only rows not yet paged
+     * (`failure_notified_at IS NULL`) are returned.
+     */
+    async getFailedStates(threshold, onlyUnnotified = false, tx = sql()) {
+        return await tx `
+      SELECT s.*, cp.start_date
+        FROM ${tx(this.statesTable)} s
+        LEFT JOIN charging_processes cp ON cp.id = s.charging_processes_id
+        WHERE s.failure_count >= ${threshold}
+        ${onlyUnnotified ? tx `AND s.failure_notified_at IS NULL` : tx ``}
+        ORDER BY s.failure_count DESC
+    `;
+    }
+    /** Stamp the notified flag on the given state rows (by id; empty is a no-op). */
+    async markStatesNotified(stateIds, tx = sql()) {
+        await tx `UPDATE ${tx(this.statesTable)}
+      SET failure_notified_at = CURRENT_TIMESTAMP
+      WHERE id = ANY(${stateIds}::bigint[])`;
+    }
+    /** Bulk reset = delete every state row (matching single-row resetState); returns rows deleted. */
+    async resetAllStates(tx = sql()) {
+        const result = await tx `DELETE FROM ${tx(this.statesTable)}`;
+        return result.count;
+    }
+    async incrementStateFailed(processId, tx = sql()) {
+        const [row] = await tx `
+      INSERT INTO ${tx(this.statesTable)} (created_at, updated_at, charging_processes_id, failure_count)
+        VALUES (CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, ${processId}, 1)
+        ON CONFLICT (charging_processes_id)
+        DO UPDATE SET failure_count = ${tx(this.statesTable)}.failure_count + 1,
+                      updated_at = CURRENT_TIMESTAMP
+        RETURNING failure_count
+      `;
+        return row.failure_count;
+    }
+}
+let _store = null;
+export const chargingProcessesStore = () => (_store ??= new ChargingProcessesStore());
+//# sourceMappingURL=ChargingProcessesStore.js.map

package/dist/store/ChargingProcessesStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChargingProcessesStore.js","sourceRoot":"","sources":["../../src/store/ChargingProcessesStore.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,GAOzB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAc,MAAM,SAAS,CAAC;AAO1C;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAuB,SAAQ,UAK3C;IACiB,WAAW,GAAW,6BAA6B,CAAC;IAEpE;QACE,KAAK,CACH,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,CACzB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,kBAAkB,CAC7B,KAAY,GAAG,EAAE;QAEjB,OAAO,MAAM,EAAE,CAA2B;;;;;;;;;;;;;;;;;;;uCAmBP,CAAC;IACtC,CAAC;IAEM,KAAK,CAAC,WAAW,CACtB,SAA8B,EAC9B,IAAmB,EACnB,KAAY,GAAG,EAAE;QAEjB,OAAO,MAAM,IAAI,CAAC,MAAM,CACtB,SAAS,EACT,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,EACpD,EAAE,CACH,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,QAAQ,CACnB,SAA8B,EAC9B,KAAY,GAAG,EAAE;QAEjB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAErB,iBAAiB,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,kCAAkC,SAAS,EAAE,CAAC;QACpF,OAAO,GAAG,IAAI,IAAI,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,UAAU,CACrB,SAA8B,EAC9B,KAAY,GAAG,EAAE;QAEjB,MAAM,EAAE,CAAA,eAAe,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,kCAAkC,SAAS,EAAE,CAAC;IAC3F,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,eAAe,CAC1B,SAAiB,EACjB,cAAc,GAAG,KAAK,EACtB,KAAY,GAAG,EAAE;QAEjB,OAAO,MAAM,EAAE,CAA8B;;eAElC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;;mCAEA,SAAS;UAClC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA,mCAAmC,CAAC,CAAC,CAAC,EAAE,CAAA,EAAE;;KAElE,CAAC;IACJ,CAAC;IAED,iFAAiF;IAC1E,KAAK,CAAC,kBAAkB,CAC7B,QAAsC,EACtC,KAAY,GAAG,EAAE;QAEjB,MAAM,EAAE,CAAA,UAAU,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;;uBAEnB,QAA+B,aAAa,CAAC;IAClE,CAAC;IAED,kGAAkG;IAC3F,KAAK,CAAC,cAAc,CAAC,KAAY,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAA,eAAe,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,oBAAoB,CAC/B,SAA8B,EAC9B,KAAY,GAAG,EAAE;QAEjB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAuB;oBAC7B,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;wDACgB,SAAS;;wCAEzB,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;;;OAGrD,CAAC;QACJ,OAAO,GAAG,CAAC,aAAa,CAAC;IAC3B,CAAC;CACF;AAED,IAAI,MAAM,GAAkC,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,EAAE,CACzC,CAAC,MAAM,KAAK,IAAI,sBAAsB,EAAE,CAAC,CAAC"}

package/dist/store/GeofencesStore.d.ts

@@ -0,0 +1,20 @@
+import { type Geofences, type GeofencesId, type GeofencesInitializer, type GeofencesMutator } from "@mxpicture/tesla-superchargers-generated/public";
+import { IMateStore } from "./IMateStore.js";
+import type { Coordinate } from "../common/coordinates.js";
+import { type SqlTx } from "./db.js";
+/**
+ * Read access to TeslaMate's `geofences` table. Today this is only
+ * {@link GeofencesStore.getHome}; writing priced Supercharger geofences back
+ * into TeslaMate is planned but not implemented yet.
+ */
+export declare class GeofencesStore extends IMateStore<GeofencesId, Geofences, GeofencesInitializer, GeofencesMutator> {
+    constructor();
+    /**
+     * The coordinate of the TeslaMate geofence named `name` (case-insensitive,
+     * default "Home"), or null if there is none. Used to center a radius scope on
+     * your home without duplicating the coordinate in config.
+     */
+    getHome(geofenceName?: string, tx?: SqlTx): Promise<Coordinate | null>;
+}
+export declare const geofencesStore: () => GeofencesStore;
+//# sourceMappingURL=GeofencesStore.d.ts.map

package/dist/store/GeofencesStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeofencesStore.d.ts","sourceRoot":"","sources":["../../src/store/GeofencesStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAO,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,UAAU,CAC5C,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,gBAAgB,CACjB;;IAKC;;;;OAIG;IACU,OAAO,CAClB,YAAY,GAAE,MAAe,EAC7B,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAU9B;AAGD,eAAO,MAAM,cAAc,sBAA0C,CAAC"}

package/dist/store/GeofencesStore.js

@@ -0,0 +1,28 @@
+import { geofencesInitializer, geofencesMutator, } from "@mxpicture/tesla-superchargers-generated/public";
+import { IMateStore } from "./IMateStore.js";
+import { sql } from "./db.js";
+/**
+ * Read access to TeslaMate's `geofences` table. Today this is only
+ * {@link GeofencesStore.getHome}; writing priced Supercharger geofences back
+ * into TeslaMate is planned but not implemented yet.
+ */
+export class GeofencesStore extends IMateStore {
+    constructor() {
+        super("geofences", geofencesInitializer, geofencesMutator);
+    }
+    /**
+     * The coordinate of the TeslaMate geofence named `name` (case-insensitive,
+     * default "Home"), or null if there is none. Used to center a radius scope on
+     * your home without duplicating the coordinate in config.
+     */
+    async getHome(geofenceName = "home", tx = sql()) {
+        const rows = await tx `SELECT latitude, longitude FROM geofences
+        WHERE name ILIKE ${geofenceName}
+        ORDER BY id
+        LIMIT 1`;
+        return rows[0] ?? null;
+    }
+}
+let _store = null;
+export const geofencesStore = () => (_store ??= new GeofencesStore());
+//# sourceMappingURL=GeofencesStore.js.map

package/dist/store/GeofencesStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeofencesStore.js","sourceRoot":"","sources":["../../src/store/GeofencesStore.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GAKjB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,GAAG,EAAc,MAAM,SAAS,CAAC;AAE1C;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,UAKnC;IACC;QACE,KAAK,CAAC,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO,CAClB,eAAuB,MAAM,EAC7B,KAAY,GAAG,EAAE;QAEjB,MAAM,IAAI,GAAG,MAAM,EAAE,CAEpB;2BACsB,YAAY;;gBAEvB,CAAC;QAEb,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACzB,CAAC;CACF;AAED,IAAI,MAAM,GAA0B,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC,CAAC"}

package/dist/store/IFailableStore.d.ts

@@ -0,0 +1,29 @@
+import { type SqlTx } from "./db.js";
+import { IMateStore, type MateStoreId } from "./IMateStore.js";
+export interface FailableMutator {
+    failure_count?: number;
+    failure_notified_at?: Date | null;
+}
+export interface FailableInitializer {
+    failure_count: number;
+}
+export interface Failable<T extends number | string> extends MateStoreId<T>, FailableInitializer {
+}
+export declare abstract class IFailableStore<ID extends number | string, BASE extends Failable<ID>, INITIALZER extends FailableInitializer, MUTATOR extends FailableMutator> extends IMateStore<ID, BASE, INITIALZER, MUTATOR> {
+    protected abstract parseFailure(failure_count: number): MUTATOR;
+    incrementFailed(id: string, tx?: SqlTx): Promise<number>;
+    setFailed(id: ID, failure_count: number, tx?: SqlTx): Promise<BASE>;
+    /** Clears both the failure count and the notified flag, re-arming paging. */
+    resetFailed(id: ID, tx?: SqlTx): Promise<BASE>;
+    /**
+     * Rows at or above `threshold` failures, most-failing first. With
+     * `onlyUnnotified` only rows that have not been paged yet
+     * (`failure_notified_at IS NULL`) are returned.
+     */
+    getFailed(threshold: number, onlyUnnotified?: boolean, tx?: SqlTx): Promise<BASE[]>;
+    /** Stamp the notified flag on the given rows (empty list is a no-op). */
+    markNotified(ids: ID[], tx?: SqlTx): Promise<void>;
+    /** Reset every failing row (count + notified flag); returns rows affected. */
+    resetAllFailed(tx?: SqlTx): Promise<number>;
+}
+//# sourceMappingURL=IFailableStore.d.ts.map

package/dist/store/IFailableStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFailableStore.d.ts","sourceRoot":"","sources":["../../src/store/IFailableStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CACjD,SAAQ,WAAW,CAAC,CAAC,CAAC,EAAE,mBAAmB;CAAG;AAEhD,8BAAsB,cAAc,CAClC,EAAE,SAAS,MAAM,GAAG,MAAM,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,CAAC,EACzB,UAAU,SAAS,mBAAmB,EACtC,OAAO,SAAS,eAAe,CAC/B,SAAQ,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC;IACjD,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAElD,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,GAAE,KAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAU/D,SAAS,CACpB,EAAE,EAAE,EAAE,EACN,aAAa,EAAE,MAAM,EACrB,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,IAAI,CAAC;IAIhB,6EAA6E;IAChE,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAE,KAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE;;;;OAIG;IACU,SAAS,CACpB,SAAS,EAAE,MAAM,EACjB,cAAc,UAAQ,EACtB,EAAE,GAAE,KAAa,GAChB,OAAO,CAAC,IAAI,EAAE,CAAC;IASlB,yEAAyE;IAC5D,YAAY,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAE,KAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE,8EAA8E;IACjE,cAAc,CAAC,EAAE,GAAE,KAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CAMhE"}

package/dist/store/IFailableStore.js

@@ -0,0 +1,47 @@
+import { sql } from "./db.js";
+import { IMateStore } from "./IMateStore.js";
+export class IFailableStore extends IMateStore {
+    async incrementFailed(id, tx = sql()) {
+        const [row] = await tx `
+      UPDATE ${tx(this.table)}
+        SET failure_count = failure_count + 1
+        WHERE id = ${id}
+        RETURNING failure_count
+    `;
+        return row.failure_count;
+    }
+    async setFailed(id, failure_count, tx = sql()) {
+        return await this.update(id, this.parseFailure(failure_count), tx);
+    }
+    /** Clears both the failure count and the notified flag, re-arming paging. */
+    async resetFailed(id, tx = sql()) {
+        return await this.update(id, { ...this.parseFailure(0), failure_notified_at: null }, tx);
+    }
+    /**
+     * Rows at or above `threshold` failures, most-failing first. With
+     * `onlyUnnotified` only rows that have not been paged yet
+     * (`failure_notified_at IS NULL`) are returned.
+     */
+    async getFailed(threshold, onlyUnnotified = false, tx = sql()) {
+        return await tx `
+      SELECT * FROM ${tx(this.table)}
+        WHERE failure_count >= ${threshold}
+        ${onlyUnnotified ? tx `AND failure_notified_at IS NULL` : tx ``}
+        ORDER BY failure_count DESC
+    `;
+    }
+    /** Stamp the notified flag on the given rows (empty list is a no-op). */
+    async markNotified(ids, tx = sql()) {
+        await tx `UPDATE ${tx(this.table)}
+      SET failure_notified_at = CURRENT_TIMESTAMP
+      WHERE id = ANY(${ids}::bigint[])`;
+    }
+    /** Reset every failing row (count + notified flag); returns rows affected. */
+    async resetAllFailed(tx = sql()) {
+        const result = await tx `UPDATE ${tx(this.table)}
+      SET failure_count = 0, failure_notified_at = NULL
+      WHERE failure_count > 0`;
+        return result.count;
+    }
+}
+//# sourceMappingURL=IFailableStore.js.map

package/dist/store/IFailableStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFailableStore.js","sourceRoot":"","sources":["../../src/store/IFailableStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAc,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAC;AAc/D,MAAM,OAAgB,cAKpB,SAAQ,UAAyC;IAG1C,KAAK,CAAC,eAAe,CAAC,EAAU,EAAE,KAAY,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAuB;eAClC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;;qBAER,EAAE;;KAElB,CAAC;QACF,OAAO,GAAG,CAAC,aAAa,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,SAAS,CACpB,EAAM,EACN,aAAqB,EACrB,KAAY,GAAG,EAAE;QAEjB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,6EAA6E;IACtE,KAAK,CAAC,WAAW,CAAC,EAAM,EAAE,KAAY,GAAG,EAAE;QAChD,OAAO,MAAM,IAAI,CAAC,MAAM,CACtB,EAAE,EACF,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,EACtD,EAAE,CACH,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,SAAS,CACpB,SAAiB,EACjB,cAAc,GAAG,KAAK,EACtB,KAAY,GAAG,EAAE;QAEjB,OAAO,MAAM,EAAE,CAAQ;sBACL,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;iCACH,SAAS;UAChC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA,iCAAiC,CAAC,CAAC,CAAC,EAAE,CAAA,EAAE;;KAEhE,CAAC;IACJ,CAAC;IAED,yEAAyE;IAClE,KAAK,CAAC,YAAY,CAAC,GAAS,EAAE,KAAY,GAAG,EAAE;QACpD,MAAM,EAAE,CAAA,UAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;;uBAEb,GAA0B,aAAa,CAAC;IAC7D,CAAC;IAED,8EAA8E;IACvE,KAAK,CAAC,cAAc,CAAC,KAAY,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAA,UAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;;8BAErB,CAAC;QAC3B,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;CACF"}

package/dist/store/IMateStore.d.ts

@@ -0,0 +1,66 @@
+import type { z } from "zod";
+import { type SqlTx } from "./db.js";
+import type { Meta } from "../types/client.types.js";
+/**
+ * Run `fn` inside one transaction, serialized per `lockKey` via a Postgres
+ * advisory lock — concurrent runs on the same key wait instead of interleaving.
+ */
+export declare const transaction: <T>(lockKey: string, fn: (tx: SqlTx) => Promise<T>) => Promise<T>;
+export interface MateStoreId<T extends number | string> {
+    id: T;
+}
+export interface FoundCoordinate<T> {
+    entity: T;
+    distanceInKm: number;
+}
+export declare abstract class IMateStore<ID extends number | string, BASE extends MateStoreId<ID>, INITIALZER extends object, MUTATOR extends object> {
+    readonly table: string;
+    protected readonly initializer: z.Schema<INITIALZER>;
+    protected readonly mutator: z.Schema<MUTATOR>;
+    readonly view: string | null;
+    constructor(table: string, initializer: z.Schema<INITIALZER>, mutator: z.Schema<MUTATOR>, view?: string | null);
+    createTable(tx?: SqlTx): Promise<void>;
+    get(id: ID, tx?: SqlTx): Promise<BASE | null>;
+    query(filters?: Partial<BASE>, tx?: SqlTx): Promise<BASE[]>;
+    delete(id: ID, tx?: SqlTx): Promise<void>;
+    deleteAll(tx?: SqlTx): Promise<void>;
+    insert(data: INITIALZER, tx?: SqlTx): Promise<BASE>;
+    insertMany(data: INITIALZER[], tx?: SqlTx): Promise<number>;
+    /**
+     * Single-row `INSERT … ON CONFLICT (conflictColumn) DO UPDATE … RETURNING *`.
+     * Unlike `upsertMany` the update is unconditional, so the meta columns
+     * (`fetched_at`, `last_fetch_uuid`) advance even when the content is
+     * unchanged — callers rely on that for staleness tracking.
+     */
+    upsertOne(data: INITIALZER, opts: {
+        conflictColumn: string;
+        /** columns SET from EXCLUDED on conflict */
+        updateColumns: string[];
+    }, tx?: SqlTx): Promise<BASE>;
+    /**
+     * Chunked `INSERT … ON CONFLICT (conflictColumn) DO UPDATE`. A conflicting
+     * row is only written when its `compareColumns` differ by value
+     * (`IS DISTINCT FROM`) from the incoming row; untouched rows are not part
+     * of the returned count.
+     */
+    upsertMany(data: INITIALZER[], opts: {
+        conflictColumn: string;
+        /** columns SET from EXCLUDED when the row changed */
+        updateColumns: string[];
+        /** columns compared to decide whether the row changed */
+        compareColumns: string[];
+    }, tx?: SqlTx): Promise<number>;
+    /**
+     * Soft-delete every not-yet-deleted row whose id is NOT in `ids` — i.e. the
+     * rows absent from the current snapshot. Assumes the table's meta columns
+     * (`deleted_at`, `fetched_at`, `last_fetch_uuid`) and a bigint/int identity id.
+     */
+    softDeleteWhereIdNotIn(ids: ID[], meta: Meta, tx?: SqlTx): Promise<number>;
+    /**
+     * Hard-delete every row whose id is NOT in `ids` — for tables that mirror
+     * their feed instead of soft-deleting absent rows.
+     */
+    deleteWhereIdNotIn(ids: ID[], tx?: SqlTx): Promise<number>;
+    update(id: ID, data: MUTATOR, tx?: SqlTx): Promise<BASE>;
+}
+//# sourceMappingURL=IMateStore.d.ts.map

package/dist/store/IMateStore.d.ts.map

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