@mxpicture/teslamate-extended-cli 2.1.51

package/dist/cli.common.d.ts

@@ -0,0 +1,64 @@
+import { Option } from "@commander-js/extra-typings";
+import { type FetchOptions, type FetchScope } from "@mxpicture/teslamate-extended-api/api";
+import { type SuperchargerStore } from "@mxpicture/teslamate-extended-api/store";
+/** Reads the CLI package version from its package.json. */
+export declare const readVersion: () => string;
+/** One day in milliseconds — the schedule interval. */
+export declare const DAY_MS: number;
+/** Parses a non-negative float (e.g. --delay). */
+export declare const parseFloatArg: (v: string) => number;
+/** Parses a non-negative integer (e.g. --limit). */
+export declare const parseIntArg: (v: string) => number;
+/** Validates an HH:MM (24h) time string (e.g. --at). */
+export declare const parseTime: (v: string) => string;
+/** Commander option: restrict to a single country. */
+export declare const countryOption: Option<"-c, --country <name>", undefined, undefined, undefined, false, undefined>;
+/** Commander option: restrict to a single region. */
+export declare const regionOption: Option<"-R, --region <name>", undefined, undefined, undefined, false, undefined>;
+/** Commander option: all Superchargers worldwide. */
+export declare const allOption: Option<"-a, --all", undefined, undefined, undefined, false, undefined>;
+/** Commander option: pricing locale. */
+export declare const localeOption: Option<"-l, --locale <locale>", undefined, "en-US", undefined, false, undefined>;
+/** Commander option: politeness delay between requests (seconds). */
+export declare const delayOption: Option<"-d, --delay <seconds>", undefined, 0.35, number, false, undefined>;
+/** Commander option: cap the number of sites fetched (0 = no cap). */
+export declare const limitOption: Option<"-n, --limit <count>", undefined, 0, number, false, undefined>;
+/** Commander option: JSON snapshot output directory. */
+export declare const outOption: Option<"-o, --out <dir>", undefined, undefined, undefined, false, undefined>;
+/** Commander option: Postgres connection URL. */
+export declare const postgresUrlOption: Option<"-p, --postgres-url <url>", undefined, undefined, undefined, false, undefined>;
+/** Commander option: Postgres table name. */
+export declare const pgTableOption: Option<"--pg-table <name>", undefined, "supercharger_price_history", undefined, false, undefined>;
+/** Commander option: daily run time for `schedule` (24h, local). */
+export declare const atOption: Option<"-t, --at <HH:MM>", undefined, "03:30", string, false, undefined>;
+/** Options common to `fetch` and `schedule`. */
+export interface CommonOpts {
+    country?: string;
+    region?: string;
+    all?: boolean;
+    locale: string;
+    delay: number;
+    limit: number;
+    out?: string;
+    postgresUrl?: string;
+    pgTable: string;
+}
+/** `schedule` options: the common ones plus the daily run time. */
+export type ScheduleOpts = CommonOpts & {
+    at: string;
+};
+/** Resolves the single scope flag (exactly one of country/region/all). */
+export declare function toScope(o: CommonOpts): FetchScope;
+/** Maps CLI options to the api fetch options. */
+export declare function toFetchOptions(o: CommonOpts): FetchOptions;
+/** Builds the sinks the user asked for (CLI flag or env). At least one required. */
+export declare function buildStores(o: CommonOpts): SuperchargerStore[];
+/** Fetches one snapshot, stores it, and closes the sinks. */
+export declare function runOnce(o: CommonOpts): Promise<void>;
+/** ms from now until the next HH:MM (local); rolls to tomorrow if already passed. */
+export declare function msUntil(at: string): number;
+/** Runs once on start, then every day at o.at — keeping the process alive. */
+export declare function scheduleDaily(o: ScheduleOpts): Promise<void>;
+/** Prints the countries and regions that have Superchargers. */
+export declare function listCountries(): Promise<void>;
+//# sourceMappingURL=cli.common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.common.d.ts","sourceRoot":"","sources":["../src/cli.common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAK3E,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,yCAAyC,CAAC;AAIjD,2DAA2D;AAC3D,eAAO,MAAM,WAAW,QAAO,MAET,CAAC;AAEvB,uDAAuD;AACvD,eAAO,MAAM,MAAM,QAAsB,CAAC;AAI1C,kDAAkD;AAClD,eAAO,MAAM,aAAa,GAAI,GAAG,MAAM,KAAG,MAKzC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,KAAG,MAKvC,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,KAAG,MAIrC,CAAC;AAIF,sDAAsD;AACtD,eAAO,MAAM,aAAa,mFAGzB,CAAC;AACF,qDAAqD;AACrD,eAAO,MAAM,YAAY,kFAGxB,CAAC;AACF,qDAAqD;AACrD,eAAO,MAAM,SAAS,wEAAyD,CAAC;AAChF,wCAAwC;AACxC,eAAO,MAAM,YAAY,kFAGP,CAAC;AACnB,qEAAqE;AACrE,eAAO,MAAM,WAAW,4EAKG,CAAC;AAC5B,sEAAsE;AACtE,eAAO,MAAM,WAAW,uEAEC,CAAC;AAC1B,wDAAwD;AACxD,eAAO,MAAM,SAAS,8EAGrB,CAAC;AACF,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,uFAG7B,CAAC;AACF,6CAA6C;AAC7C,eAAO,MAAM,aAAa,mGAGa,CAAC;AACxC,oEAAoE;AACpE,eAAO,MAAM,QAAQ,0EAKE,CAAC;AAIxB,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU,CASjD;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,YAAY,CAQ1D;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,iBAAiB,EAAE,CAiB9D;AAED,6DAA6D;AAC7D,wBAAsB,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1D;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO1C;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBlE;AAED,gEAAgE;AAChE,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAWnD"}

package/dist/cli.common.js

@@ -0,0 +1,156 @@
+import { InvalidArgumentError, Option } from "@commander-js/extra-typings";
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { env, exit } from "node:process";
+import { fileURLToPath } from "node:url";
+import { fetchAllLocations, isSupercharger, } from "@mxpicture/teslamate-extended-api/api";
+import { ingestSuperchargers, JsonFileStore, PostgresStore, } from "@mxpicture/teslamate-extended-api/store";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Reads the CLI package version from its package.json. */
+export const readVersion = () => JSON.parse(readFileSync(resolve(__dirname, "../package.json"), "utf8"))
+    .version;
+/** One day in milliseconds — the schedule interval. */
+export const DAY_MS = 24 * 60 * 60 * 1000;
+// ---------- argument parsers ----------
+/** Parses a non-negative float (e.g. --delay). */
+export const parseFloatArg = (v) => {
+    const n = Number(v);
+    if (!Number.isFinite(n) || n < 0)
+        throw new InvalidArgumentError("must be a non-negative number");
+    return n;
+};
+/** Parses a non-negative integer (e.g. --limit). */
+export const parseIntArg = (v) => {
+    const n = parseInt(v, 10);
+    if (isNaN(n) || n < 0)
+        throw new InvalidArgumentError("must be a non-negative integer");
+    return n;
+};
+/** Validates an HH:MM (24h) time string (e.g. --at). */
+export const parseTime = (v) => {
+    if (!/^([01]\d|2[0-3]):[0-5]\d$/.test(v))
+        throw new InvalidArgumentError("expected HH:MM (24h)");
+    return v;
+};
+// ---------- commander options ----------
+/** Commander option: restrict to a single country. */
+export const countryOption = new Option("-c, --country <name>", "Only this country");
+/** Commander option: restrict to a single region. */
+export const regionOption = new Option("-R, --region <name>", "Only this region");
+/** Commander option: all Superchargers worldwide. */
+export const allOption = new Option("-a, --all", "All Superchargers worldwide");
+/** Commander option: pricing locale. */
+export const localeOption = new Option("-l, --locale <locale>", "Locale for pricing").default("en-US");
+/** Commander option: politeness delay between requests (seconds). */
+export const delayOption = new Option("-d, --delay <seconds>", "Delay between requests")
+    .default(0.35)
+    .argParser(parseFloatArg);
+/** Commander option: cap the number of sites fetched (0 = no cap). */
+export const limitOption = new Option("-n, --limit <count>", "Cap number of sites")
+    .default(0)
+    .argParser(parseIntArg);
+/** Commander option: JSON snapshot output directory. */
+export const outOption = new Option("-o, --out <dir>", "Write JSON snapshots to this directory (env SUPERCHARGERS_OUT_DIR)");
+/** Commander option: Postgres connection URL. */
+export const postgresUrlOption = new Option("-p, --postgres-url <url>", "Append snapshots to this Postgres DB (env SUPERCHARGERS_PG_URL)");
+/** Commander option: Postgres table name. */
+export const pgTableOption = new Option("--pg-table <name>", "Postgres table name").default("supercharger_price_history");
+/** Commander option: daily run time for `schedule` (24h, local). */
+export const atOption = new Option("-t, --at <HH:MM>", "Daily run time (24h, local)")
+    .default("03:30")
+    .argParser(parseTime);
+/** Resolves the single scope flag (exactly one of country/region/all). */
+export function toScope(o) {
+    const picked = [o.country, o.region, o.all ? "all" : undefined].filter(Boolean);
+    if (picked.length !== 1) {
+        console.error("Pick exactly one scope: --country | --region | --all.");
+        exit(1);
+    }
+    return { country: o.country, region: o.region, all: o.all };
+}
+/** Maps CLI options to the api fetch options. */
+export function toFetchOptions(o) {
+    return {
+        scope: toScope(o),
+        locale: o.locale,
+        delayMs: o.delay * 1000,
+        limit: o.limit,
+        logger: (m) => console.log(m),
+    };
+}
+/** Builds the sinks the user asked for (CLI flag or env). At least one required. */
+export function buildStores(o) {
+    const stores = [];
+    const outDir = o.out ?? env.SUPERCHARGERS_OUT_DIR;
+    const pgUrl = o.postgresUrl ?? env.SUPERCHARGERS_PG_URL;
+    if (outDir)
+        stores.push(new JsonFileStore(outDir));
+    if (pgUrl)
+        stores.push(new PostgresStore({ connectionString: pgUrl, table: o.pgTable }));
+    if (stores.length === 0) {
+        console.error("No output configured. Pass --out <dir> and/or --postgres-url <url> " +
+            "(or set SUPERCHARGERS_OUT_DIR / SUPERCHARGERS_PG_URL).");
+        exit(1);
+    }
+    return stores;
+}
+/** Fetches one snapshot, stores it, and closes the sinks. */
+export async function runOnce(o) {
+    const fetchOpts = toFetchOptions(o);
+    const stores = buildStores(o);
+    try {
+        const res = await ingestSuperchargers(fetchOpts, stores);
+        console.log(`Saved ${res.count} Superchargers (run ${res.runId}, ` +
+            `${res.fetchedAt.toISOString()}).`);
+    }
+    finally {
+        for (const s of stores)
+            await s.close?.();
+    }
+}
+/** ms from now until the next HH:MM (local); rolls to tomorrow if already passed. */
+export function msUntil(at) {
+    const [h, m] = at.split(":").map(Number);
+    const now = new Date();
+    const next = new Date(now);
+    next.setHours(h, m, 0, 0);
+    if (next <= now)
+        next.setTime(next.getTime() + DAY_MS);
+    return next.getTime() - now.getTime();
+}
+/** Runs once on start, then every day at o.at — keeping the process alive. */
+export async function scheduleDaily(o) {
+    const safeRun = async () => {
+        try {
+            await runOnce(o);
+        }
+        catch (e) {
+            console.error("Run failed:", e instanceof Error ? e.message : e);
+        }
+    };
+    const arm = () => {
+        const wait = msUntil(o.at);
+        console.log(`Next run at ${o.at} (in ${Math.round(wait / 60000)} min).`);
+        setTimeout(async () => {
+            await safeRun();
+            arm();
+        }, wait);
+    };
+    await safeRun(); // run immediately on start
+    arm();
+}
+/** Prints the countries and regions that have Superchargers. */
+export async function listCountries() {
+    const locations = (await fetchAllLocations()).filter(isSupercharger);
+    const countries = [
+        ...new Set(locations.map((l) => l.country).filter(Boolean)),
+    ].sort();
+    const regions = [
+        ...new Set(locations.map((l) => l.region).filter(Boolean)),
+    ].sort();
+    console.log("Regions:", regions.join(", "));
+    console.log("\nCountries:");
+    for (const c of countries)
+        console.log("  ", c);
+}
+//# sourceMappingURL=cli.common.js.map

package/dist/cli.common.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * teslamate-superchargers
+ * =======================
+ * Fetch all Tesla Supercharger locations + pricing (via the public tesla.com
+ * endpoints, see `@mxpicture/teslamate-extended-api`) and persist each run as a
+ * dated snapshot — to JSON files and/or PostgreSQL. Because every run is stored
+ * under its own timestamp, repeated runs build a price history.
+ *
+ *   teslamate-superchargers fetch    --all --out ./data --postgres-url "$PG_URL"
+ *   teslamate-superchargers schedule --all --postgres-url "$PG_URL" --at 03:30
+ *   teslamate-superchargers list-countries
+ *
+ * The `schedule` command runs once on start and then daily at --at, keeping the
+ * process alive — so a single container is enough to refresh the data every day.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}

package/dist/cli.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * teslamate-superchargers
+ * =======================
+ * Fetch all Tesla Supercharger locations + pricing (via the public tesla.com
+ * endpoints, see `@mxpicture/teslamate-extended-api`) and persist each run as a
+ * dated snapshot — to JSON files and/or PostgreSQL. Because every run is stored
+ * under its own timestamp, repeated runs build a price history.
+ *
+ *   teslamate-superchargers fetch    --all --out ./data --postgres-url "$PG_URL"
+ *   teslamate-superchargers schedule --all --postgres-url "$PG_URL" --at 03:30
+ *   teslamate-superchargers list-countries
+ *
+ * The `schedule` command runs once on start and then daily at --at, keeping the
+ * process alive — so a single container is enough to refresh the data every day.
+ */
+import { program } from "@commander-js/extra-typings";
+import { argv, exit } from "node:process";
+import { allOption, atOption, countryOption, delayOption, limitOption, listCountries, localeOption, outOption, pgTableOption, postgresUrlOption, readVersion, regionOption, runOnce, scheduleDaily, } from "./cli.common.js";
+program
+    .name("teslamate-superchargers")
+    .version(readVersion())
+    .description("Fetch + store Tesla Supercharger locations and pricing");
+program
+    .command("fetch")
+    .description("Fetch one snapshot and store it, then exit")
+    .addOption(countryOption)
+    .addOption(regionOption)
+    .addOption(allOption)
+    .addOption(localeOption)
+    .addOption(delayOption)
+    .addOption(limitOption)
+    .addOption(outOption)
+    .addOption(postgresUrlOption)
+    .addOption(pgTableOption)
+    .action(async (o) => {
+    await runOnce(o);
+});
+program
+    .command("schedule")
+    .description("Fetch now, then refresh once a day at --at (keeps running)")
+    .addOption(countryOption)
+    .addOption(regionOption)
+    .addOption(allOption)
+    .addOption(localeOption)
+    .addOption(delayOption)
+    .addOption(limitOption)
+    .addOption(outOption)
+    .addOption(postgresUrlOption)
+    .addOption(pgTableOption)
+    .addOption(atOption)
+    .action(async (o) => {
+    await scheduleDaily(o);
+});
+program
+    .command("list-countries")
+    .description("List the countries and regions that have Superchargers")
+    .action(async () => {
+    await listCountries();
+});
+program.parseAsync(argv).catch((e) => {
+    console.error(e);
+    exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,OAAO,EACP,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO;KACJ,IAAI,CAAC,yBAAyB,CAAC;KAC/B,OAAO,CAAC,WAAW,EAAE,CAAC;KACtB,WAAW,CAAC,wDAAwD,CAAC,CAAC;AAEzE,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,4CAA4C,CAAC;KACzD,SAAS,CAAC,aAAa,CAAC;KACxB,SAAS,CAAC,YAAY,CAAC;KACvB,SAAS,CAAC,SAAS,CAAC;KACpB,SAAS,CAAC,YAAY,CAAC;KACvB,SAAS,CAAC,WAAW,CAAC;KACtB,SAAS,CAAC,WAAW,CAAC;KACtB,SAAS,CAAC,SAAS,CAAC;KACpB,SAAS,CAAC,iBAAiB,CAAC;KAC5B,SAAS,CAAC,aAAa,CAAC;KACxB,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;IAClB,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,4DAA4D,CAAC;KACzE,SAAS,CAAC,aAAa,CAAC;KACxB,SAAS,CAAC,YAAY,CAAC;KACvB,SAAS,CAAC,SAAS,CAAC;KACpB,SAAS,CAAC,YAAY,CAAC;KACvB,SAAS,CAAC,WAAW,CAAC;KACtB,SAAS,CAAC,WAAW,CAAC;KACtB,SAAS,CAAC,SAAS,CAAC;KACpB,SAAS,CAAC,iBAAiB,CAAC;KAC5B,SAAS,CAAC,aAAa,CAAC;KACxB,SAAS,CAAC,QAAQ,CAAC;KACnB,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;IAClB,MAAM,aAAa,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,wDAAwD,CAAC;KACrE,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACnC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,IAAI,CAAC,CAAC,CAAC,CAAC;AACV,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

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

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@mxpicture/teslamate-extended-cli",
+  "version": "2.1.51",
+  "description": "CLI to fetch + store Tesla Supercharger locations and pricing",
+  "type": "module",
+  "author": "MXPicture",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MXPicture/npm-teslamate-extended.git"
+  },
+  "bin": {
+    "teslamate-superchargers": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "lint": "eslint \"src/**/*.ts\" --ext .ts --cache --cache-strategy content",
+    "lint:ci": "eslint \"src/**/*.ts\" --ext .ts --max-warnings=0",
+    "build": "tsc -b ."
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@commander-js/extra-typings": "^14.0.0",
+    "@mxpicture/teslamate-extended-api": "^2.1.51",
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "eslint": "^9.39.3",
+    "typescript": "^5.9.3"
+  }
+}