@mxpicture/tesla-superchargers-mate 0.1.24 → 0.1.26

package/dist/store/index.d.ts

@@ -8,5 +8,6 @@ export * from "./PicInvoicesStore.js";
 export * from "./PicPricebooksStore.js";
 export * from "./PicSlugsStore.js";
 export * from "./db.js";
+export * from "./schema.js";
 export * from "./statements.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/store/index.js

@@ -9,5 +9,6 @@ export * from "./PicInvoicesStore.js";
 export * from "./PicPricebooksStore.js";
 export * from "./PicSlugsStore.js";
 export * from "./db.js";
+export * from "./schema.js";
 export * from "./statements.js";
 //# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/store/schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Apply the idempotent `pic_*` schema (CREATE ... IF NOT EXISTS) to the
+ * configured database. Safe to re-run on every deploy — existing rows (including
+ * the accumulated price history in `pic_pricebooks`) are left untouched. The
+ * connection comes from the standard `PG*` environment variables.
+ */
+export declare const applySchema: () => Promise<void>;
+/**
+ * DESTRUCTIVE: drop every `pic_*` table, including the accumulated price history.
+ * Intended for a deliberate reset; pair with {@link applySchema} to recreate.
+ */
+export declare const resetSchema: () => Promise<void>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/store/schema.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,IAAI,CAEhD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,IAAI,CAEhD,CAAC"}

package/dist/store/schema.js

@@ -0,0 +1,27 @@
+import { fileURLToPath } from "node:url";
+import { sql } from "./db.js";
+/**
+ * Absolute path to a bundled SQL file. The `.sql` files ship inside this package
+ * (see its `files` array) at `<pkg>/sql/*.sql`; this module compiles to
+ * `<pkg>/dist/store/schema.js`, so they sit two directories up in both `src` and
+ * `dist`. Resolving from `import.meta.url` (not `process.cwd()`) makes it work no
+ * matter where the CLI is invoked from.
+ */
+const sqlFile = (name) => fileURLToPath(new URL(`../../sql/${name}`, import.meta.url));
+/**
+ * Apply the idempotent `pic_*` schema (CREATE ... IF NOT EXISTS) to the
+ * configured database. Safe to re-run on every deploy — existing rows (including
+ * the accumulated price history in `pic_pricebooks`) are left untouched. The
+ * connection comes from the standard `PG*` environment variables.
+ */
+export const applySchema = async () => {
+    await sql().file(sqlFile("setup.sql"));
+};
+/**
+ * DESTRUCTIVE: drop every `pic_*` table, including the accumulated price history.
+ * Intended for a deliberate reset; pair with {@link applySchema} to recreate.
+ */
+export const resetSchema = async () => {
+    await sql().file(sqlFile("reset.sql"));
+};
+//# sourceMappingURL=schema.js.map

package/dist/store/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/store/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE,CACvC,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,IAAI,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;IACnD,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,IAAmB,EAAE;IACnD,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxpicture/tesla-superchargers-mate",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "TeslaMate integration",
   "type": "module",
   "author": "MXPicture",
@@ -33,7 +33,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "sql"
   ],
   "engines": {
     "node": ">=24"
@@ -48,7 +49,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@mxpicture/tesla-superchargers-generated": "^0.1.24",
+    "@mxpicture/tesla-superchargers-generated": "^0.1.26",
     "postgres": "^3.4.9",
     "short-uuid": "^6.0.3",
     "zod": "^4.3.6"

package/sql/reset.sql

@@ -0,0 +1,29 @@
+-- DESTRUCTIVE reset: drops every pic_* object — INCLUDING pic_pricebooks,
+-- the accumulated price history this project exists to build. Run it only to
+-- start over from scratch; setup.sql alone is idempotent and safe to
+-- (re-)apply after updates.
+DROP VIEW IF EXISTS pic_cp_inv_v;
+
+DROP VIEW IF EXISTS pic_cp_sc_v;
+
+DROP VIEW IF EXISTS pic_chargers_v;
+
+DROP VIEW IF EXISTS pic_pricebooks_tesla_ui_v;
+
+DROP VIEW IF EXISTS pic_pricebooks_tesla_condensed_v;
+
+DROP VIEW IF EXISTS pic_pricebooks_tesla_v;
+
+DROP TABLE IF EXISTS pic_invoices;
+
+DROP TABLE IF EXISTS pic_invoice_missing_states;
+
+DROP TABLE IF EXISTS pic_invoice_files;
+
+DROP TABLE IF EXISTS pic_pricebooks;
+
+DROP TABLE IF EXISTS pic_chargers;
+
+DROP TABLE IF EXISTS pic_slugs;
+
+DROP TABLE IF EXISTS pic_charging_process_states;

package/sql/setup.sql

@@ -0,0 +1,462 @@
+-- Idempotent schema setup: creates the pic_* tables next to TeslaMate's own.
+-- Safe to (re-)apply — existing tables (and the price history in
+-- pic_pricebooks) are left untouched. To start over, run reset.sql first
+-- (DESTRUCTIVE: drops the accumulated history).
+-- slugs ------------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS pic_slugs (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  fetched_at TIMESTAMPTZ NOT NULL,
+  last_fetch_uuid TEXT NOT NULL,
+  failure_count SMALLINT NOT NULL,
+  --
+  latitude DOUBLE PRECISION NOT NULL, -- number
+  longitude DOUBLE PRECISION NOT NULL, -- number
+  location_types TEXT[] NOT NULL DEFAULT '{}',
+  location_url_slug TEXT NOT NULL, -- string
+  tesla_uuid TEXT UNIQUE, -- string (uuid), semantic key for syncs
+  title TEXT, -- string|null
+  access_type TEXT, -- string (supercharger_function.access_type)
+  actual_latitude TEXT, -- string (supercharger_function.actual_latitude)
+  actual_longitude TEXT, -- string (supercharger_function.actual_longitude)
+  charging_accessibility TEXT, -- string (supercharger_function.charging_accessibility)
+  coming_soon_latitude TEXT, -- string (supercharger_function.coming_soon_latitude)
+  coming_soon_longitude TEXT, -- string (supercharger_function.coming_soon_longitude)
+  coming_soon_name TEXT, -- string (supercharger_function.coming_soon_name)
+  open_to_non_tesla BOOLEAN, -- boolean (supercharger_function.open_to_non_tesla)
+  project_status TEXT, -- string (supercharger_function.project_status)
+  show_on_find_us TEXT, -- string (supercharger_function.show_on_find_us)
+  site_status TEXT, -- string (supercharger_function.site_status)
+  vote_winner_quarter TEXT, -- string (supercharger_function.vote_winner_quarter)
+  failure_notified_at TIMESTAMPTZ -- set when a failure notification covered this row; NULL = not yet notified
+);
+
+CREATE INDEX IF NOT EXISTS pic_slugs_location_types_gin ON pic_slugs USING gin (location_types);
+
+CREATE INDEX IF NOT EXISTS pic_slugs_location_slug_idx ON pic_slugs (location_url_slug);
+
+CREATE INDEX IF NOT EXISTS pic_slugs_fetched_at_idx ON pic_slugs (fetched_at);
+
+CREATE INDEX IF NOT EXISTS pic_slugs_locslug_time_idx ON pic_slugs (location_url_slug, fetched_at DESC);
+
+-- chargers ------------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS pic_chargers (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  fetched_at TIMESTAMPTZ NOT NULL,
+  last_fetch_uuid TEXT NOT NULL,
+  deleted_at TIMESTAMPTZ,
+  failure_count SMALLINT NOT NULL,
+  pic_slugs_id BIGINT REFERENCES pic_slugs (id) ON DELETE SET NULL,
+  --
+  access_type TEXT NOT NULL, -- string (accessType)
+  location_guid TEXT NOT NULL UNIQUE, -- string (locationGUID), semantic key for syncs
+  max_power_kw SMALLINT NOT NULL, -- number (maxPowerKw)
+  name TEXT NOT NULL, -- string
+  public_stall_count SMALLINT NOT NULL, -- number
+  time_zone TEXT NOT NULL, -- string
+  entry_point_latitude DOUBLE PRECISION NOT NULL, -- number (entryPoint.latitude)
+  entry_point_longitude DOUBLE PRECISION NOT NULL, -- number (entryPoint.longitude)
+  centroid_latitude DOUBLE PRECISION NOT NULL, -- number (centroid.latitude)
+  centroid_longitude DOUBLE PRECISION NOT NULL, -- number (centroid.longitude)
+  brand_name TEXT, -- string|null (brandName)
+  common_site_name TEXT NOT NULL, -- string (commonSiteName)
+  city TEXT NOT NULL, -- string
+  country TEXT NOT NULL, -- string
+  country_code TEXT NOT NULL, -- string (countryCode)
+  district TEXT, -- string|null
+  nav_region TEXT NOT NULL, -- string (navRegion)
+  nearest_entrance TEXT, -- string|null (nearestEntrance)
+  postal_code TEXT NOT NULL, -- string (postalCode)
+  postal_ext TEXT, -- string|null (postalExt)
+  state TEXT, -- string|null
+  street TEXT NOT NULL, -- string
+  street_number TEXT NOT NULL, -- string (streetNumber)
+  site_id BIGINT NOT NULL, -- number (availabilityProfile.siteId.id)
+  site_type TEXT NOT NULL, -- string (availabilityProfile.siteId.siteType)
+  trt_id BIGINT NOT NULL, -- number (availabilityProfile.trtId.id)
+  trt_type TEXT NOT NULL, -- string (availabilityProfile.trtId.siteType)
+  utc_offset TEXT, -- string|null (availabilityProfile.utcOffset)
+  failure_notified_at TIMESTAMPTZ -- set when a failure notification covered this row; NULL = not yet notified
+);
+
+CREATE INDEX IF NOT EXISTS pic_chargers_location_slug_idx ON pic_chargers (pic_slugs_id);
+
+CREATE INDEX IF NOT EXISTS pic_chargers_fetched_at_idx ON pic_chargers (fetched_at);
+
+CREATE INDEX IF NOT EXISTS pic_chargers_locslug_time_idx ON pic_chargers (pic_slugs_id, fetched_at DESC);
+
+CREATE OR REPLACE VIEW pic_chargers_v AS
+SELECT
+  *
+FROM
+  pic_chargers
+WHERE
+  deleted_at IS NULL;
+
+-- pricebooks ------------------------------------------------------------------------------
+-- History table: one snapshot ("group") = all rows sharing
+-- (pic_chargers_id, last_fetch_uuid). fetched_at is the group's creation time
+-- and never changes; an unchanged re-fetch only bumps last_fetch_uuid.
+CREATE TABLE IF NOT EXISTS pic_pricebooks (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  fetched_at TIMESTAMPTZ NOT NULL,
+  last_fetch_uuid TEXT NOT NULL,
+  pic_chargers_id BIGINT NOT NULL REFERENCES pic_chargers (id) ON DELETE CASCADE,
+  --
+  currency_code TEXT NOT NULL, -- string (currencyCode)
+  uom TEXT NOT NULL, -- string (ucom)
+  days SMALLINT[] NOT NULL, -- string [0,1,...]
+  start_time TIME NOT NULL, -- time (startTime)
+  end_time TIME NOT NULL, -- time (endTime)
+  vehicle_make_type TEXT NOT NULL, -- string (vehicleMakeType)
+  fee_type TEXT NOT NULL, -- string (feeType)
+  is_member_pricebook BOOLEAN NOT NULL, -- boolean (isMemberPricebook)
+  is_tou BOOLEAN NOT NULL, -- boolean (isTou)
+  rate_base NUMERIC(5, 2) NOT NULL, -- number (rateBase)
+  rate_tier_1 NUMERIC(5, 2) NOT NULL, -- number (rateTier1)
+  rate_tier_2 NUMERIC(5, 2) NOT NULL, -- number (rateTier2)
+  -- derived: 0-based dense rank within the (pic_chargers_id, last_fetch_uuid)
+  -- group, ordered by start_time (rows sharing a start_time share the value);
+  -- NULL when is_tou = false
+  sort_order SMALLINT
+);
+
+CREATE INDEX IF NOT EXISTS pic_pricebooks_loc_idx ON pic_pricebooks (pic_chargers_id);
+
+-- group lookups: current group / group at a point in time
+CREATE INDEX IF NOT EXISTS pic_pricebooks_charger_time_idx ON pic_pricebooks (pic_chargers_id, fetched_at DESC);
+
+CREATE OR REPLACE VIEW pic_pricebooks_tesla_v AS
+SELECT
+  *
+FROM
+  pic_pricebooks AS p
+WHERE
+  p.vehicle_make_type = 'TSLA'
+  AND p.fee_type = 'CHARGING'
+ORDER BY
+  p.pic_chargers_id,
+  p.is_tou,
+  p.start_time;
+
+-- // todo add currency code for ui/grafana
+CREATE OR REPLACE VIEW pic_pricebooks_tesla_condensed_v AS
+SELECT
+  c.*,
+  base.start_time AS base_start_time,
+  base.end_time AS base_end_time,
+  base.rate_base AS base_rate_base,
+  base.uom AS base_uom,
+  s0.start_time AS s0_start_time,
+  s0.end_time AS s0_end_time,
+  s0.rate_base AS s0_rate_base,
+  s0.uom AS s0_uom,
+  s1.start_time AS s1_start_time,
+  s1.end_time AS s1_end_time,
+  s1.rate_base AS s1_rate_base,
+  s1.uom AS s1_uom,
+  s2.start_time AS s2_start_time,
+  s2.end_time AS s2_end_time,
+  s2.rate_base AS s2_rate_base,
+  s2.uom AS s2_uom,
+  s3.start_time AS s3_start_time,
+  s3.end_time AS s3_end_time,
+  s3.rate_base AS s3_rate_base,
+  s3.uom AS s3_uom,
+  s4.start_time AS s4_start_time,
+  s4.end_time AS s4_end_time,
+  s4.rate_base AS s4_rate_base,
+  s4.uom AS s4_uom,
+  s5.start_time AS s5_start_time,
+  s5.end_time AS s5_end_time,
+  s5.rate_base AS s5_rate_base,
+  s5.uom AS s5_uom
+FROM
+  pic_chargers_v AS c
+  LEFT JOIN pic_pricebooks_tesla_v base ON base.pic_chargers_id = c.id
+  AND base.last_fetch_uuid = c.last_fetch_uuid
+  AND base.sort_order IS NULL
+  LEFT JOIN pic_pricebooks_tesla_v s0 ON s0.pic_chargers_id = c.id
+  AND s0.last_fetch_uuid = c.last_fetch_uuid
+  AND s0.sort_order = 0
+  LEFT JOIN pic_pricebooks_tesla_v s1 ON s1.pic_chargers_id = c.id
+  AND s1.last_fetch_uuid = c.last_fetch_uuid
+  AND s1.sort_order = 1
+  LEFT JOIN pic_pricebooks_tesla_v s2 ON s2.pic_chargers_id = c.id
+  AND s2.last_fetch_uuid = c.last_fetch_uuid
+  AND s2.sort_order = 2
+  LEFT JOIN pic_pricebooks_tesla_v s3 ON s3.pic_chargers_id = c.id
+  AND s3.last_fetch_uuid = c.last_fetch_uuid
+  AND s3.sort_order = 3
+  LEFT JOIN pic_pricebooks_tesla_v s4 ON s4.pic_chargers_id = c.id
+  AND s4.last_fetch_uuid = c.last_fetch_uuid
+  AND s4.sort_order = 4
+  LEFT JOIN pic_pricebooks_tesla_v s5 ON s5.pic_chargers_id = c.id
+  AND s5.last_fetch_uuid = c.last_fetch_uuid
+  AND s5.sort_order = 5;
+
+CREATE OR REPLACE VIEW pic_pricebooks_tesla_ui_v AS
+SELECT
+  v.*,
+  CASE
+    WHEN v.s0_start_time IS NULL THEN CONCAT(v.base_rate_base, ' €/', v.base_uom)
+  END AS base_timeslot,
+  CASE
+    WHEN v.s0_start_time IS NOT NULL THEN CONCAT(
+      to_char(v.s0_start_time, 'HH24:mm'),
+      '-',
+      to_char(v.s0_end_time, 'HH24:mm'),
+      ': ',
+      v.s0_rate_base,
+      ' €/',
+      v.s0_uom
+    )
+  END AS s0_timeslot,
+  CASE
+    WHEN v.s1_start_time IS NOT NULL THEN CONCAT(
+      to_char(v.s1_start_time, 'HH24:mm'),
+      '-',
+      to_char(v.s1_end_time, 'HH24:mm'),
+      ': ',
+      v.s1_rate_base,
+      ' €/',
+      v.s1_uom
+    )
+  END AS s1_timeslot,
+  CASE
+    WHEN v.s2_start_time IS NOT NULL THEN CONCAT(
+      to_char(v.s2_start_time, 'HH24:mm'),
+      '-',
+      to_char(v.s2_end_time, 'HH24:mm'),
+      ': ',
+      v.s2_rate_base,
+      ' €/',
+      v.s2_uom
+    )
+  END AS s2_timeslot,
+  CASE
+    WHEN v.s3_start_time IS NOT NULL THEN CONCAT(
+      to_char(v.s3_start_time, 'HH24:mm'),
+      '-',
+      to_char(v.s3_end_time, 'HH24:mm'),
+      ': ',
+      v.s3_rate_base,
+      ' €/',
+      v.s3_uom
+    )
+  END AS s3_timeslot,
+  CASE
+    WHEN v.s4_start_time IS NOT NULL THEN CONCAT(
+      to_char(v.s4_start_time, 'HH24:mm'),
+      '-',
+      to_char(v.s4_end_time, 'HH24:mm'),
+      ': ',
+      v.s4_rate_base,
+      ' €/',
+      v.s4_uom
+    )
+  END AS s4_timeslot,
+  CASE
+    WHEN v.s5_start_time IS NOT NULL THEN CONCAT(
+      to_char(v.s5_start_time, 'HH24:mm'),
+      '-',
+      to_char(v.s5_end_time, 'HH24:mm'),
+      ': ',
+      v.s5_rate_base,
+      ' €/',
+      v.s5_uom
+    )
+  END AS s5_timeslot
+FROM
+  pic_pricebooks_tesla_condensed_v AS v;
+
+-- charging process states ------------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS pic_charging_process_states (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL,
+  --
+  charging_processes_id INTEGER NOT NULL, -- no foreign key --> teslamate should not fail because of this extension
+  failure_count SMALLINT NOT NULL,
+  failure_notified_at TIMESTAMPTZ -- set when a failure notification covered this row; NULL = not yet notified
+);
+
+-- the failure upsert conflicts on charging_processes_id, so the index must be
+-- unique; the old non-unique pic_charg_proc_idx is dropped on upgrade
+DROP INDEX IF EXISTS pic_charg_proc_idx;
+
+CREATE UNIQUE INDEX IF NOT EXISTS pic_charg_proc_uq_idx ON pic_charging_process_states (charging_processes_id);
+
+-- invoices (from Tesla App) ------------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS pic_invoices (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  fetched_at TIMESTAMPTZ NOT NULL,
+  last_fetch_uuid TEXT NOT NULL,
+  charging_processes_id INTEGER, -- no foreign key --> teslamate should not fail because of this extension
+  --
+  charge_start_date_time TIMESTAMPTZ NOT NULL,
+  name TEXT,
+  vin TEXT NOT NULL,
+  model TEXT,
+  country TEXT NOT NULL,
+  site_location_name TEXT NOT NULL,
+  description TEXT,
+  ucom TEXT NOT NULL,
+  quantity_base NUMERIC(8, 4) NOT NULL,
+  quantity_tier1 NUMERIC(8, 4),
+  quantity_tier2 NUMERIC(8, 4),
+  quantity_tier3 NUMERIC(8, 4),
+  quantity_tier4 NUMERIC(8, 4),
+  invoice_number TEXT NOT NULL,
+  unit_cost_base NUMERIC(4, 2) NOT NULL,
+  unit_cost_tier1 NUMERIC(4, 2),
+  unit_cost_tier2 NUMERIC(4, 2),
+  unit_cost_tier3 NUMERIC(4, 2),
+  unit_cost_tier4 NUMERIC(4, 2),
+  vat NUMERIC(5, 2) NOT NULL,
+  total_exc_vat NUMERIC(5, 2) NOT NULL,
+  total_inc_vat NUMERIC(5, 2) NOT NULL,
+  status TEXT,
+  invoice TEXT
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS pic_invoices_uq_cp_idx ON pic_invoices (charging_processes_id);
+
+CREATE UNIQUE INDEX IF NOT EXISTS pic_invoices_uq_inv_idx ON pic_invoices (invoice_number);
+
+-- invoice files (from Tesla App) ------------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS pic_invoice_files (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  fetched_at TIMESTAMPTZ NOT NULL,
+  last_fetch_uuid TEXT NOT NULL,
+  --
+  name TEXT NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS pic_invoices_name_idx ON pic_invoice_files (name);
+
+-- invoice missing states ------------------------------------------------------------------------------
+-- One row per Supercharger charge already paged about a missing invoice
+-- (notify-unmatched-invoices), so each charge pages exactly once. A row is
+-- irrelevant once an invoice arrives (the charge stops matching the query).
+CREATE TABLE IF NOT EXISTS pic_invoice_missing_states (
+  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL,
+  --
+  charging_processes_id INTEGER NOT NULL, -- no foreign key --> teslamate should not fail because of this extension
+  notified_at TIMESTAMPTZ -- set when a missing-invoice notification covered this row; NULL = not yet notified
+);
+
+-- the notified upsert conflicts on charging_processes_id, so the index must be unique
+CREATE UNIQUE INDEX IF NOT EXISTS pic_invoice_missing_uq_idx ON pic_invoice_missing_states (charging_processes_id);
+
+-- charging processes <-> pic_invoices ---------------------------------------------------------
+-- Dropped instead of CREATE OR REPLACE: column types/order may change between
+-- versions, which OR REPLACE rejects. Views hold no data, so this stays
+-- idempotent. pic_cp_inv_v depends on pic_cp_sc_v, so it is dropped first.
+DROP VIEW IF EXISTS pic_cp_inv_v;
+
+DROP VIEW IF EXISTS pic_cp_inv_prep_v;
+
+DROP VIEW IF EXISTS pic_cp_sc_v;
+
+-- Supercharger charging processes: a process counts as Supercharger when any
+-- of its charges rows reports fast_charger_brand = 'Tesla' (AC charging
+-- reports '<invalid>'). Site name comes from the reverse-geocoded address.
+CREATE VIEW pic_cp_sc_v AS
+SELECT
+  cp.id,
+  cp.start_date AT TIME ZONE 'UTC' AS charge_start_date_time,
+  COALESCE(addr.name, addr.display_name) AS site_location_name,
+  COALESCE(cp.charge_energy_used, cp.charge_energy_added) AS quantity,
+  cp.cost
+FROM
+  charging_processes AS cp
+  LEFT JOIN addresses AS addr ON addr.id = cp.address_id
+WHERE
+  EXISTS (
+    SELECT
+      1
+    FROM
+      charges AS c
+    WHERE
+      c.charging_process_id = cp.id
+      AND c.fast_charger_brand = 'Tesla'
+  );
+
+-- Full outer join: matched rows plus Supercharger charges without an invoice
+-- (match_state = 'cp_only') and invoices without a matched charge
+-- ('inv_only'). Values missing because one side is absent are 0, so sums stay
+-- usable; deviations are 0 where undefined.
+CREATE VIEW pic_cp_inv_prep_v AS
+SELECT
+  COALESCE(
+    inv.charge_start_date_time,
+    cp.charge_start_date_time
+  ) AS charge_start_date_time,
+  --
+  COALESCE(
+    inv.site_location_name,
+    cp.site_location_name,
+    'Unknown'
+  ) AS site_location_name,
+  --
+  CASE
+    WHEN inv.id IS NULL THEN 'cp_only'
+    WHEN cp.id IS NULL THEN 'inv_only'
+    ELSE 'matched'
+  END AS match_state,
+  --
+  inv.quantity_base AS inv_quan_raw,
+  --
+  ROUND(COALESCE(inv.quantity_base, 0), 2) AS inv_quan,
+  --
+  cp.quantity AS cp_quan_raw,
+  --
+  COALESCE(cp.quantity, 0) AS cp_quan,
+  --
+  COALESCE(
+    ROUND(
+      (cp.quantity / NULLIF(inv.quantity_base, 0)) - 1,
+      4
+    ),
+    0
+  ) AS deviation_quan,
+  --
+  CASE
+    WHEN inv.quantity_base IS NULL
+    OR cp.quantity IS NULL THEN 0
+    ELSE ROUND(inv.quantity_base - cp.quantity, 2)
+  END AS diff_quan,
+  --
+  inv.total_inc_vat AS inv_cost_raw,
+  --
+  ROUND(COALESCE(inv.total_inc_vat, 0), 2) AS inv_cost,
+  --
+  cp.cost AS cp_cost_raw,
+  --
+  COALESCE(cp.cost, 0) AS cp_cost,
+  --
+  COALESCE(
+    ROUND((cp.cost / NULLIF(inv.total_inc_vat, 0)) - 1, 4),
+    0
+  ) AS deviation_cost,
+  --
+  CASE
+    WHEN inv.total_inc_vat IS NULL
+    OR cp.cost IS NULL THEN 0
+    ELSE ROUND(inv.total_inc_vat - cp.cost, 2)
+  END AS diff_cost
+FROM
+  pic_cp_sc_v AS cp
+  FULL OUTER JOIN pic_invoices AS inv ON inv.charging_processes_id = cp.id;
+
+--
+CREATE VIEW pic_cp_inv_v AS
+SELECT
+  base.*,
+  to_char(base.charge_start_date_time, 'YYYY-MM-DD hh:MM') AS formatted_date,
+  base.inv_quan || ' kWh (' || base.inv_cost_raw || ' €)' AS inv,
+  base.cp_quan || ' kWh (' || base.cp_cost_raw || ' €)' AS cp
+FROM
+  pic_cp_inv_prep_v AS base;