@mxpicture/tesla-superchargers-api 0.1.63 → 0.1.65

package/dist/api/AdditionalCostsApi.d.ts

@@ -0,0 +1,32 @@
+import { type AdditionalCost, type AdditionalCostInput } from "@mxpicture/tesla-superchargers-mate/store";
+import type { PicAdditionalCostsId } from "@mxpicture/tesla-superchargers-generated/public";
+import { IApi } from "./IApi.js";
+/**
+ * `pic_additional_costs` — the costs of running a car that TeslaMate never
+ * sees: service, repairs, tyres, insurance, tax and the subsidies that come
+ * back the other way. Charging costs are deliberately not in here; `pic_refs`
+ * and the pricing pass already model those, and a second copy would
+ * double-count in any future total.
+ *
+ * Full CRUD, unlike every other api in this package, because these rows are
+ * the only ones in the `pic_*` schema that are **not derivable**: nothing
+ * fetches them and no rebuild recreates them, so the UI is the only thing that
+ * can put one there. Hence no upsert, no snapshot sync and no soft delete.
+ *
+ * A recurring cost stays one row — `recurrence = 'monthly'` with `date` as the
+ * first occurrence, `end_date` as the last (null while it is still running)
+ * and `cost` as the amount per month. The Grafana view that will read this
+ * expands the series with `generate_series` at read time; nothing here
+ * materializes the occurrences.
+ */
+export declare class AdditionalCostsApi extends IApi {
+    /** Every entry, newest date first. */
+    query(): Promise<AdditionalCost[]>;
+    create(input: AdditionalCostInput): Promise<AdditionalCost>;
+    /** The updated row, or null when no row has that id. */
+    update(id: PicAdditionalCostsId, input: AdditionalCostInput): Promise<AdditionalCost | null>;
+    /** False when the row was already gone; deleting twice is not an error. */
+    remove(id: PicAdditionalCostsId): Promise<boolean>;
+}
+export declare const additionalCostsApi: () => AdditionalCostsApi;
+//# sourceMappingURL=AdditionalCostsApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AdditionalCostsApi.d.ts","sourceRoot":"","sources":["../../src/api/AdditionalCostsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,SAAQ,IAAI;IAC1C,sCAAsC;IACzB,KAAK,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIlC,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxE,wDAAwD;IAC3C,MAAM,CACjB,EAAE,EAAE,oBAAoB,EACxB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIjC,2EAA2E;IAC9D,MAAM,CAAC,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;CAGhE;AAGD,eAAO,MAAM,kBAAkB,0BAA4C,CAAC"}

package/dist/api/AdditionalCostsApi.js

@@ -0,0 +1,40 @@
+import { picAdditionalCostsStore, } from "@mxpicture/tesla-superchargers-mate/store";
+import { IApi } from "./IApi.js";
+/**
+ * `pic_additional_costs` — the costs of running a car that TeslaMate never
+ * sees: service, repairs, tyres, insurance, tax and the subsidies that come
+ * back the other way. Charging costs are deliberately not in here; `pic_refs`
+ * and the pricing pass already model those, and a second copy would
+ * double-count in any future total.
+ *
+ * Full CRUD, unlike every other api in this package, because these rows are
+ * the only ones in the `pic_*` schema that are **not derivable**: nothing
+ * fetches them and no rebuild recreates them, so the UI is the only thing that
+ * can put one there. Hence no upsert, no snapshot sync and no soft delete.
+ *
+ * A recurring cost stays one row — `recurrence = 'monthly'` with `date` as the
+ * first occurrence, `end_date` as the last (null while it is still running)
+ * and `cost` as the amount per month. The Grafana view that will read this
+ * expands the series with `generate_series` at read time; nothing here
+ * materializes the occurrences.
+ */
+export class AdditionalCostsApi extends IApi {
+    /** Every entry, newest date first. */
+    async query() {
+        return await picAdditionalCostsStore().query();
+    }
+    async create(input) {
+        return await picAdditionalCostsStore().insert(input);
+    }
+    /** The updated row, or null when no row has that id. */
+    async update(id, input) {
+        return await picAdditionalCostsStore().update(id, input);
+    }
+    /** False when the row was already gone; deleting twice is not an error. */
+    async remove(id) {
+        return await picAdditionalCostsStore().remove(id);
+    }
+}
+let _api = null;
+export const additionalCostsApi = () => (_api ??= new AdditionalCostsApi());
+//# sourceMappingURL=AdditionalCostsApi.js.map

package/dist/api/AdditionalCostsApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdditionalCostsApi.js","sourceRoot":"","sources":["../../src/api/AdditionalCostsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GAGxB,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,kBAAmB,SAAQ,IAAI;IAC1C,sCAAsC;IAC/B,KAAK,CAAC,KAAK;QAChB,OAAO,MAAM,uBAAuB,EAAE,CAAC,KAAK,EAAE,CAAC;IACjD,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,KAA0B;QAC5C,OAAO,MAAM,uBAAuB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,wDAAwD;IACjD,KAAK,CAAC,MAAM,CACjB,EAAwB,EACxB,KAA0B;QAE1B,OAAO,MAAM,uBAAuB,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,2EAA2E;IACpE,KAAK,CAAC,MAAM,CAAC,EAAwB;QAC1C,OAAO,MAAM,uBAAuB,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AAED,IAAI,IAAI,GAA8B,IAAI,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,kBAAkB,EAAE,CAAC,CAAC"}

package/dist/api/CarsApi.d.ts

@@ -0,0 +1,13 @@
+import { type CarOption } from "@mxpicture/tesla-superchargers-mate/store";
+import { IApi } from "./IApi.js";
+/**
+ * TeslaMate's `cars`, read-only and only as far as the additional-costs form
+ * needs it: the id and the name behind its car picker. Its own class rather
+ * than a method on {@link AdditionalCostsApi} because a `cars` read behind an
+ * additional-costs name is a lie about what it touches.
+ */
+export declare class CarsApi extends IApi {
+    query(): Promise<CarOption[]>;
+}
+export declare const carsApi: () => CarsApi;
+//# sourceMappingURL=CarsApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CarsApi.d.ts","sourceRoot":"","sources":["../../src/api/CarsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,qBAAa,OAAQ,SAAQ,IAAI;IAClB,KAAK,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;CAG3C;AAGD,eAAO,MAAM,OAAO,eAAiC,CAAC"}

package/dist/api/CarsApi.js

@@ -0,0 +1,16 @@
+import { carsStore, } from "@mxpicture/tesla-superchargers-mate/store";
+import { IApi } from "./IApi.js";
+/**
+ * TeslaMate's `cars`, read-only and only as far as the additional-costs form
+ * needs it: the id and the name behind its car picker. Its own class rather
+ * than a method on {@link AdditionalCostsApi} because a `cars` read behind an
+ * additional-costs name is a lie about what it touches.
+ */
+export class CarsApi extends IApi {
+    async query() {
+        return await carsStore().queryNames();
+    }
+}
+let _api = null;
+export const carsApi = () => (_api ??= new CarsApi());
+//# sourceMappingURL=CarsApi.js.map

package/dist/api/CarsApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarsApi.js","sourceRoot":"","sources":["../../src/api/CarsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,GAEV,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,OAAO,OAAQ,SAAQ,IAAI;IACxB,KAAK,CAAC,KAAK;QAChB,OAAO,MAAM,SAAS,EAAE,CAAC,UAAU,EAAE,CAAC;IACxC,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,3 +1,5 @@
+export * from "./AdditionalCostsApi.js";
+export * from "./CarsApi.js";
 export * from "./ChargersApi.js";
 export * from "./ChargingProcessesApi.js";
 export * from "./ClustersApi.js";

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,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,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,4 +1,6 @@
 // This file is auto-generated by build-cli. Do not edit manually.
+export * from "./AdditionalCostsApi.js";
+export * from "./CarsApi.js";
 export * from "./ChargersApi.js";
 export * from "./ChargingProcessesApi.js";
 export * from "./ClustersApi.js";

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,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,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/types/additionalCosts.types.d.ts

@@ -0,0 +1,18 @@
+export type { AdditionalCost, AdditionalCostInput, CarOption, } from "@mxpicture/tesla-superchargers-mate/store";
+/**
+ * The category and recurrence values, straight out of the generated enums —
+ * which kanel derived from the `CREATE TYPE` in the migration. `packages/http`
+ * depends on `-api` and `-mate` but not on `-generated`, so re-exporting them
+ * here is what puts the DDL's own list in reach of the 400-validation and of
+ * the UI's `<select>` options, instead of a second hand-written copy.
+ */
+export declare const COST_CATEGORIES: ("service" | "repair" | "tyres" | "insurance" | "tax" | "funding" | "other")[];
+export declare const COST_RECURRENCES: ("once" | "monthly")[];
+/**
+ * The largest amount `pic_additional_costs.cost` can hold, either sign — the
+ * `NUMERIC(10, 2)` the column is declared as. Checked before the insert so an
+ * extra digit comes back as a readable 400 rather than as a 500 from
+ * Postgres's own numeric overflow.
+ */
+export declare const COST_MAX = 99999999.99;
+//# sourceMappingURL=additionalCosts.types.d.ts.map

package/dist/types/additionalCosts.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"additionalCosts.types.d.ts","sourceRoot":"","sources":["../../src/types/additionalCosts.types.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,SAAS,GACV,MAAM,2CAA2C,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,gFAA0B,CAAC;AACvD,eAAO,MAAM,gBAAgB,wBAA4B,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,cAAc,CAAC"}

package/dist/types/additionalCosts.types.js

@@ -0,0 +1,18 @@
+import { picCostCategory, picCostRecurrence, } from "@mxpicture/tesla-superchargers-generated/public";
+/**
+ * The category and recurrence values, straight out of the generated enums —
+ * which kanel derived from the `CREATE TYPE` in the migration. `packages/http`
+ * depends on `-api` and `-mate` but not on `-generated`, so re-exporting them
+ * here is what puts the DDL's own list in reach of the 400-validation and of
+ * the UI's `<select>` options, instead of a second hand-written copy.
+ */
+export const COST_CATEGORIES = picCostCategory.options;
+export const COST_RECURRENCES = picCostRecurrence.options;
+/**
+ * The largest amount `pic_additional_costs.cost` can hold, either sign — the
+ * `NUMERIC(10, 2)` the column is declared as. Checked before the insert so an
+ * extra digit comes back as a readable 400 rather than as a 500 from
+ * Postgres's own numeric overflow.
+ */
+export const COST_MAX = 99999999.99;
+//# sourceMappingURL=additionalCosts.types.js.map

package/dist/types/additionalCosts.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"additionalCosts.types.js","sourceRoot":"","sources":["../../src/types/additionalCosts.types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,iBAAiB,GAClB,MAAM,iDAAiD,CAAC;AAQzD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./additionalCosts.types.js";
 export * from "./chargers.types.js";
 export * from "./charging.types.js";
 export * from "./failures.types.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/types/index.js

@@ -1,4 +1,5 @@
 // This file is auto-generated by build-cli. Do not edit manually.
+export * from "./additionalCosts.types.js";
 export * from "./chargers.types.js";
 export * from "./charging.types.js";
 export * from "./failures.types.js";

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxpicture/tesla-superchargers-api",
-  "version": "0.1.63",
+  "version": "0.1.65",
   "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.63",
-    "@mxpicture/tesla-superchargers-generated": "^0.1.63",
-    "@mxpicture/tesla-superchargers-mate": "^0.1.63",
+    "@mxpicture/tesla-superchargers-cloud-store": "^0.1.65",
+    "@mxpicture/tesla-superchargers-generated": "^0.1.65",
+    "@mxpicture/tesla-superchargers-mate": "^0.1.65",
     "csv-parse": "^7.0.1",
     "fflate": "^0.8.3",
     "json5": "^2.2.3",