@mxpicture/tesla-superchargers-api 0.1.51 → 0.1.53

package/dist/api/ClustersApi.d.ts

@@ -0,0 +1,19 @@
+import { type ClusterAssignSummary } from "@mxpicture/tesla-superchargers-mate/store";
+import { IApi } from "./IApi.js";
+/**
+ * Address clustering — `pic_cluster` / `pic_cluster_member`, the grouping that
+ * lets a Supercharger site logged under half a dozen slightly different
+ * Nominatim addresses read as one place in the clustered cost views.
+ *
+ * TeslaMate creates an address whenever it geocodes a new place, so the
+ * assignment has to be kept up: this is the scheduled caller that replaced the
+ * AFTER INSERT trigger the clustering used to install on `addresses`. A full
+ * re-clustering (`pic_rebuild()`) is deliberately not exposed here — it
+ * discards every cluster, which is a manual act, not a scheduled one.
+ */
+export declare class ClustersApi extends IApi {
+    /** Cluster the addresses that have no cluster yet. Idempotent. */
+    assign(diameterM?: number): Promise<ClusterAssignSummary>;
+}
+export declare const clustersApi: () => ClustersApi;
+//# sourceMappingURL=ClustersApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClustersApi.d.ts","sourceRoot":"","sources":["../../src/api/ClustersApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,SAAQ,IAAI;IACnC,kEAAkE;IACrD,MAAM,CACjB,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,oBAAoB,CAAC;CAGjC;AAGD,eAAO,MAAM,WAAW,mBAAqC,CAAC"}

package/dist/api/ClustersApi.js

@@ -0,0 +1,22 @@
+import { assignClusters, CLUSTER_DIAMETER_M, } from "@mxpicture/tesla-superchargers-mate/store";
+import { IApi } from "./IApi.js";
+/**
+ * Address clustering — `pic_cluster` / `pic_cluster_member`, the grouping that
+ * lets a Supercharger site logged under half a dozen slightly different
+ * Nominatim addresses read as one place in the clustered cost views.
+ *
+ * TeslaMate creates an address whenever it geocodes a new place, so the
+ * assignment has to be kept up: this is the scheduled caller that replaced the
+ * AFTER INSERT trigger the clustering used to install on `addresses`. A full
+ * re-clustering (`pic_rebuild()`) is deliberately not exposed here — it
+ * discards every cluster, which is a manual act, not a scheduled one.
+ */
+export class ClustersApi extends IApi {
+    /** Cluster the addresses that have no cluster yet. Idempotent. */
+    async assign(diameterM = CLUSTER_DIAMETER_M) {
+        return await assignClusters(diameterM);
+    }
+}
+let _api = null;
+export const clustersApi = () => (_api ??= new ClustersApi());
+//# sourceMappingURL=ClustersApi.js.map

package/dist/api/ClustersApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClustersApi.js","sourceRoot":"","sources":["../../src/api/ClustersApi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,kBAAkB,GAEnB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAY,SAAQ,IAAI;IACnC,kEAAkE;IAC3D,KAAK,CAAC,MAAM,CACjB,YAAoB,kBAAkB;QAEtC,OAAO,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;CACF;AAED,IAAI,IAAI,GAAuB,IAAI,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,WAAW,EAAE,CAAC,CAAC"}

package/dist/api/RefsApi.d.ts

@@ -0,0 +1,20 @@
+import { type RefsBuildSummary } from "@mxpicture/tesla-superchargers-mate/store";
+import { IApi } from "./IApi.js";
+/**
+ * `pic_refs` — one row per drive, parked interval and charge, each carrying the
+ * euros it consumed, which the Grafana drive/idle cost views read through
+ * `pic_base_drive_cost_v` / `pic_base_idle_cost_v`.
+ *
+ * The table is a projection of what TeslaMate has logged, so it only ever holds
+ * what the last build saw: it needs rebuilding after TeslaMate logs new drives
+ * or charges, after the pricing pass back-fills a charge's
+ * cost (the invoice the replay prices a charge from), and after a
+ * deploy — the schema migration drops and recreates the table, so `setup`
+ * leaves it empty.
+ */
+export declare class RefsApi extends IApi {
+    /** Reconcile and reprice every car's refs. Idempotent; see `buildRefs`. */
+    build(): Promise<RefsBuildSummary>;
+}
+export declare const refsApi: () => RefsApi;
+//# sourceMappingURL=RefsApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RefsApi.d.ts","sourceRoot":"","sources":["../../src/api/RefsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,qBAAa,OAAQ,SAAQ,IAAI;IAC/B,2EAA2E;IAC9D,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAGhD;AAGD,eAAO,MAAM,OAAO,eAAiC,CAAC"}

package/dist/api/RefsApi.js

@@ -0,0 +1,23 @@
+import { buildRefs, } from "@mxpicture/tesla-superchargers-mate/store";
+import { IApi } from "./IApi.js";
+/**
+ * `pic_refs` — one row per drive, parked interval and charge, each carrying the
+ * euros it consumed, which the Grafana drive/idle cost views read through
+ * `pic_base_drive_cost_v` / `pic_base_idle_cost_v`.
+ *
+ * The table is a projection of what TeslaMate has logged, so it only ever holds
+ * what the last build saw: it needs rebuilding after TeslaMate logs new drives
+ * or charges, after the pricing pass back-fills a charge's
+ * cost (the invoice the replay prices a charge from), and after a
+ * deploy — the schema migration drops and recreates the table, so `setup`
+ * leaves it empty.
+ */
+export class RefsApi extends IApi {
+    /** Reconcile and reprice every car's refs. Idempotent; see `buildRefs`. */
+    async build() {
+        return await buildRefs();
+    }
+}
+let _api = null;
+export const refsApi = () => (_api ??= new RefsApi());
+//# sourceMappingURL=RefsApi.js.map

package/dist/api/RefsApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RefsApi.js","sourceRoot":"","sources":["../../src/api/RefsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,GAEV,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,OAAQ,SAAQ,IAAI;IAC/B,2EAA2E;IACpE,KAAK,CAAC,KAAK;QAChB,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,IAAI,IAAI,GAAmB,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC"}

package/dist/api/index.d.ts

@@ -1,8 +1,10 @@
 export * from "./ChargersApi.js";
 export * from "./ChargingProcessesApi.js";
+export * from "./ClustersApi.js";
 export * from "./FailuresApi.js";
 export * from "./IApi.js";
 export * from "./InvoicesApi.js";
+export * from "./RefsApi.js";
 export * from "./SlugsApi.js";
 export * from "./ZipCodesApi.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
+{"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,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/api/index.js

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

package/dist/api/index.js.map

@@ -1 +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,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
+{"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,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxpicture/tesla-superchargers-api",
-  "version": "0.1.51",
+  "version": "0.1.53",
   "description": "Fetch + store Tesla Supercharger locations and pricing",
   "type": "module",
   "author": "MXPicture",
@@ -44,9 +44,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@mxpicture/tesla-superchargers-cloud-store": "^0.1.51",
-    "@mxpicture/tesla-superchargers-generated": "^0.1.51",
-    "@mxpicture/tesla-superchargers-mate": "^0.1.51",
+    "@mxpicture/tesla-superchargers-cloud-store": "^0.1.53",
+    "@mxpicture/tesla-superchargers-generated": "^0.1.53",
+    "@mxpicture/tesla-superchargers-mate": "^0.1.53",
     "csv-parse": "^7.0.1",
     "fflate": "^0.8.3",
     "json5": "^2.2.3",