jpdcl 1.0.0

package/dist/smart-client.d.ts

@@ -0,0 +1,50 @@
+import { type EndpointName } from "./catalog.js";
+import type { PortalResponse, RequestOptions } from "./types.js";
+export interface SmartTokenClaims {
+    sub?: string;
+    exp?: number;
+    tenantId?: string;
+    currentAccountTenantId?: string;
+    currentAccountKno?: string;
+    currentAccountMeterNo?: string;
+    currentAccountIsMeterPrepaid?: boolean | string;
+    currentAccountMeteringMode?: string;
+    currentAccountName?: string;
+    userAccounts?: string | unknown[];
+    [key: string]: unknown;
+}
+export declare class SmartMeterClient {
+    private token?;
+    readonly baseUrl: string;
+    private readonly allowMutations;
+    readonly tenantId?: string | undefined;
+    private readonly adminToken;
+    readonly claims: SmartTokenClaims;
+    constructor(token?: string | undefined, baseUrl?: string, allowMutations?: boolean, tenantId?: string | undefined, adminToken?: string | undefined);
+    get bearerToken(): string | undefined;
+    get accountId(): string | undefined;
+    get meterNumber(): string | undefined;
+    get effectiveTenantId(): string | undefined;
+    get expiresAt(): string | undefined;
+    sessionInfo(): Record<string, unknown>;
+    request<T = unknown>(name: EndpointName | string, options?: RequestOptions): Promise<PortalResponse<T>>;
+    connections(): Promise<PortalResponse>;
+    dashboard(accountId?: string | undefined, options?: {
+        includeDerived?: boolean;
+    }): Promise<PortalResponse>;
+    consumption(accountId?: string | undefined, type?: string, value?: number): Promise<PortalResponse>;
+    intervalConsumption(accountId: string | undefined, from: string, to: string, sortOrder?: string): Promise<PortalResponse>;
+    report(reportType: SmartReportType, accountId?: string | undefined, options?: SmartReportOptions): Promise<PortalResponse>;
+}
+export type SmartReportType = "PowerOnOff" | "DayWiseTOD" | "MonthlyTOD" | "PeakSlotConsumption" | "PeakSlotConsumptionMonthly" | "ConsumerVoltageDataProfile" | "SanctionLoadVSMaxDemand";
+export interface SmartReportOptions {
+    from?: string;
+    to?: string;
+    start?: number;
+    end?: number;
+    filter?: string;
+    format?: "xlsx" | "pdf";
+}
+export declare function encodeReportFilter(from: string, to: string, start?: number, end?: number): string;
+export declare function smartApiUrlFromAppUrl(appUrl?: string): string;
+export declare function decodeJwt(token: string): SmartTokenClaims;

package/dist/smart-client.js

@@ -0,0 +1,238 @@
+import { endpointCatalog, isEndpointName } from "./catalog.js";
+import { SMART_API_URL, mutationsEnabled } from "./config.js";
+import { assertDateRange } from "./dates.js";
+import { AuthenticationError, JpdclError, MutationDisabledError } from "./errors.js";
+import { buildUrl } from "./http.js";
+export class SmartMeterClient {
+    token;
+    baseUrl;
+    allowMutations;
+    tenantId;
+    adminToken;
+    claims;
+    constructor(token, baseUrl = SMART_API_URL, allowMutations = mutationsEnabled(), tenantId, adminToken = process.env.JPDCL_SMART_ADMIN_TOKEN) {
+        this.token = token;
+        this.baseUrl = baseUrl;
+        this.allowMutations = allowMutations;
+        this.tenantId = tenantId;
+        this.adminToken = adminToken;
+        this.claims = token ? decodeJwt(token) : {};
+    }
+    get bearerToken() { return this.token; }
+    get accountId() { return stringClaim(this.claims.currentAccountKno); }
+    get meterNumber() { return stringClaim(this.claims.currentAccountMeterNo); }
+    get effectiveTenantId() {
+        return this.tenantId ?? stringClaim(this.claims.currentAccountTenantId) ?? stringClaim(this.claims.tenantId);
+    }
+    get expiresAt() {
+        return typeof this.claims.exp === "number" ? new Date(this.claims.exp * 1000).toISOString() : undefined;
+    }
+    sessionInfo() {
+        return {
+            authenticated: Boolean(this.token),
+            expiresAt: this.expiresAt,
+            accountId: this.accountId,
+            meterNumber: this.meterNumber,
+            tenantId: this.effectiveTenantId,
+            userId: stringClaim(this.claims.sub),
+            isPrepaid: booleanClaim(this.claims.currentAccountIsMeterPrepaid),
+            meteringMode: stringClaim(this.claims.currentAccountMeteringMode),
+            accounts: parseAccounts(this.claims.userAccounts),
+        };
+    }
+    async request(name, options = {}) {
+        if (!isEndpointName(name))
+            throw new JpdclError(`Unknown endpoint: ${name}`, 400);
+        const endpoint = endpointCatalog[name];
+        if (endpoint.portal !== "smart")
+            throw new JpdclError(`${name} belongs to the main JPDCL portal`, 400);
+        if (endpoint.mutation && !this.allowMutations)
+            throw new MutationDisabledError();
+        if (endpoint.auth === "smart-bearer" && !this.token)
+            throw new AuthenticationError("A smart-meter bearer token is required");
+        if (endpoint.auth === "smart-admin" && !this.adminToken)
+            throw new AuthenticationError("JPDCL_SMART_ADMIN_TOKEN is required for this administrative endpoint");
+        const url = buildUrl(this.baseUrl, endpoint.path, options.params);
+        const headers = { Accept: endpoint.binary ? "*/*" : "application/json", ...options.headers };
+        if (endpoint.auth === "smart-bearer" && this.token)
+            headers.Authorization = `Bearer ${this.token}`;
+        if (endpoint.auth === "smart-bearer" && this.effectiveTenantId)
+            headers.TenantId = this.effectiveTenantId;
+        if (endpoint.auth === "smart-admin" && this.adminToken)
+            headers.Authorization = `Bearer ${this.adminToken}`;
+        let body;
+        if (options.body !== undefined && endpoint.method !== "GET" && endpoint.method !== "DELETE") {
+            headers["Content-Type"] = "application/json";
+            body = JSON.stringify(options.body);
+        }
+        const response = await fetch(url, { method: endpoint.method, headers, body });
+        const contentType = response.headers.get("content-type") ?? "";
+        if (endpoint.binary || !contentType.toLowerCase().includes("json")) {
+            const bytes = Buffer.from(await response.arrayBuffer());
+            if (!response.ok)
+                throw new JpdclError(`Smart-meter portal returned HTTP ${response.status}`, response.status, bytes.toString("utf8"));
+            return { status: true, data: { base64: bytes.toString("base64"), contentType } };
+        }
+        const raw = (await response.json());
+        if (!response.ok || raw.success === false) {
+            throw new JpdclError(errorMessage(raw) ?? `Smart-meter portal returned HTTP ${response.status}`, response.status || 502, raw);
+        }
+        return normalizeEnvelope(raw);
+    }
+    async connections() {
+        const accounts = parseAccounts(this.claims.userAccounts);
+        const current = this.sessionInfo();
+        return { status: true, data: accounts.length ? accounts : [current] };
+    }
+    async dashboard(accountId = this.accountId, options = {}) {
+        if (!accountId)
+            throw new JpdclError("Smart-meter account ID is required", 400);
+        const meterNumber = this.meterNumber;
+        if (!meterNumber)
+            throw new JpdclError("Smart-meter number is required", 400);
+        const calls = {
+            usage: this.request("smart_today_monthly", { params: { meterNumber } }),
+            currentMonth: this.request("smart_current_month", { params: { accountId } }),
+            meterReadings: this.request("smart_meter_reading", { params: { meterNumber } }),
+            reading: this.request("smart_current_meter_reading", { params: { accountId } }),
+            lastBill: this.request("smart_postpaid_last_bill", { params: { accountId } }),
+            billHistory: this.request("smart_postpaid_bill_history", { params: { accountId } }),
+            paymentHistory: this.request("smart_postpaid_payment_history", { params: { accountId } }),
+            meterDetails: this.request("smart_meter_details", { params: { meterNumber } }),
+            preferences: this.request("smart_preferences", { params: { isPrepaid: booleanClaim(this.claims.currentAccountIsMeterPrepaid) ?? false } }),
+            alerts: this.request("smart_my_alerts", { params: { accountId, meterNumber } }),
+            onDemandRequests: this.request("smart_on_demand_logs", { params: { meterNumber } }),
+        };
+        const userId = stringClaim(this.claims.sub);
+        if (userId) {
+            calls.notifications = this.request("smart_notifications", { params: { userId } }).catch(() => ({ status: true, data: [] }));
+            calls.unreadNotifications = this.request("smart_notification_unread_count", { params: { userId } }).catch(() => ({ status: true, data: { unreadCount: 0 } }));
+        }
+        if (booleanClaim(this.claims.currentAccountIsMeterPrepaid)) {
+            delete calls.lastBill;
+            delete calls.billHistory;
+            delete calls.paymentHistory;
+            calls.prepaidBalance = this.request("smart_prepaid_balance", { params: { meterNumber } });
+            calls.rechargeBalance = this.request("smart_prepaid_recharge_balance", { params: { accountId } });
+            calls.rechargeHistory = this.request("smart_prepaid_recharge_history", { params: { meterNumber } });
+            calls.billHistory = this.request("smart_prepaid_bill_history", { params: { meterNumber } });
+        }
+        if (options.includeDerived) {
+            calls.derivedInsights = this.request("smart_insights", { params: { accountId } });
+            calls.derivedForecastToday = this.request("smart_forecast_today", { params: { meterNumber } });
+            calls.derivedForecastWeekly = this.request("smart_forecast_weekly", { params: { meterNumber } });
+            calls.derivedForecastMonthly = this.request("smart_forecast_monthly", { params: { meterNumber } });
+        }
+        const entries = await Promise.all(Object.entries(calls).map(async ([key, promise]) => {
+            try {
+                return [key, (await promise).data];
+            }
+            catch (error) {
+                return [key, { unavailable: true, message: error instanceof Error ? error.message : String(error) }];
+            }
+        }));
+        return {
+            status: true,
+            data: {
+                _meta: options.includeDerived
+                    ? { dataPolicy: "observed-plus-derived", warning: "derivedInsights and derivedForecast* are predictions/advice, not meter evidence" }
+                    : { dataPolicy: "observed-only", derivedAndAdvisoryExcluded: true },
+                session: this.sessionInfo(),
+                ...Object.fromEntries(entries),
+            },
+        };
+    }
+    consumption(accountId = this.accountId, type = "monthly", value = 12) {
+        if (!accountId)
+            throw new JpdclError("Smart-meter account ID is required", 400);
+        if (!this.meterNumber)
+            throw new JpdclError("Smart-meter number is required", 400);
+        return this.request("smart_consumption_comparison", { params: { meterNumber: this.meterNumber, type, value } });
+    }
+    intervalConsumption(accountId, from, to, sortOrder = "date") {
+        if (!(accountId ?? this.accountId))
+            throw new JpdclError("Smart-meter account ID is required", 400);
+        if (!this.meterNumber)
+            throw new JpdclError("Smart-meter number is required", 400);
+        assertDateRange(from, to, { requireBoth: true });
+        return this.request("smart_consumption_30min", { params: { meterNumber: this.meterNumber, fromDate: from, toDate: to, sortOrder } });
+    }
+    report(reportType, accountId = this.accountId, options = {}) {
+        if (!accountId)
+            throw new JpdclError("Smart-meter account ID is required", 400);
+        if (!this.meterNumber)
+            throw new JpdclError("Smart-meter number is required", 400);
+        assertDateRange(options.from, options.to, { pairedWhenPresent: true });
+        const filter = options.filter ?? (options.from && options.to
+            ? encodeReportFilter(options.from, options.to, options.start ?? 1, options.end ?? defaultReportEnd(reportType))
+            : undefined);
+        return this.request("smart_report", { params: { meterNumber: this.meterNumber, reportType, filter, format: options.format } });
+    }
+}
+export function encodeReportFilter(from, to, start = 1, end = 100) {
+    return Buffer.from(JSON.stringify({
+        start,
+        end,
+        filters: { createdDateFrom: from, createdDateTo: to },
+    }), "utf8").toString("base64");
+}
+export function smartApiUrlFromAppUrl(appUrl) {
+    if (!appUrl)
+        return SMART_API_URL;
+    return new URL("/api", appUrl).toString().replace(/\/$/, "");
+}
+export function decodeJwt(token) {
+    try {
+        const payload = token.split(".")[1];
+        if (!payload)
+            throw new Error("JWT payload is missing");
+        return JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
+    }
+    catch (error) {
+        throw new AuthenticationError("Invalid smart-meter SSO token", error);
+    }
+}
+function normalizeEnvelope(raw) {
+    if (Object.prototype.hasOwnProperty.call(raw, "success")) {
+        return { status: raw.success, message: raw.message, data: raw.data, correlationId: raw.correlationId };
+    }
+    return raw;
+}
+function errorMessage(value) {
+    const error = value.error;
+    if (typeof error === "string")
+        return error;
+    if (error && typeof error === "object") {
+        const record = error;
+        return stringClaim(record.message) ?? stringClaim(record.title);
+    }
+    return stringClaim(value.message);
+}
+function stringClaim(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function booleanClaim(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string" && ["true", "false"].includes(value.toLowerCase()))
+        return value.toLowerCase() === "true";
+    return undefined;
+}
+function parseAccounts(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value === "string") {
+        try {
+            const parsed = JSON.parse(value);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+function defaultReportEnd(reportType) {
+    return reportType === "ConsumerVoltageDataProfile" ? 100 : reportType === "SanctionLoadVSMaxDemand" ? 12 : 10;
+}
+//# sourceMappingURL=smart-client.js.map

package/dist/smart-client.js.map

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

package/dist/tariff.d.ts

@@ -0,0 +1,121 @@
+export declare const JPDCL_TARIFF_ORDER_2025_26: {
+    readonly id: "JPDCL-JERC-FY2025-26-SUBSIDIZED";
+    readonly title: "JPDCL & KPDCL ARR and Tariff for FY 2025-26 - Subsidized Tariff";
+    readonly fiscalYear: "2025-26";
+    readonly sourceUrl: "https://jpdcl.jk.gov.in/downloads/tariff/JPDCL_Tariff_Order_2025_26.pdf";
+    readonly domesticSchedule: {
+        readonly pdfPages: readonly [159, 160];
+        readonly printedPages: readonly [139, 140];
+        readonly energySlabs: readonly [{
+            readonly upToKwh: 200;
+            readonly ratePerKwh: 2.3;
+        }, {
+            readonly upToKwh: 400;
+            readonly ratePerKwh: 4;
+        }, {
+            readonly upToKwh: null;
+            readonly ratePerKwh: 4.35;
+        }];
+        readonly fixedChargePerKwMonth: 8;
+        readonly loadRoundingKw: 0.5;
+    };
+    readonly generalTerms: {
+        readonly pdfPages: readonly [176, 177, 178, 179, 180];
+        readonly printedPages: readonly [156, 157, 158, 159, 160];
+        readonly prepaidEnergyRebatePercent: 2;
+        readonly latePaymentPercentPerMonth: 1.5;
+        readonly solarWaterHeaterRebatePerMonth: 150;
+    };
+};
+export interface DomesticTariffInput {
+    unitsKwh: number;
+    sanctionedLoadKw: number;
+    prepaid?: boolean;
+    solarWaterHeaterEligible?: boolean;
+    electricityDutyAmount?: number;
+    otherChargesAmount?: number;
+    unpaidPrincipalAmount?: number;
+    lateMonths?: number;
+}
+export interface TariffSlabCharge {
+    fromKwh: number;
+    toKwh: number | null;
+    unitsKwh: number;
+    ratePerKwh: number;
+    amount: number;
+}
+export declare function calculateDomesticMeteredCharges(input: DomesticTariffInput): {
+    _meta: {
+        dataClass: string;
+        purpose: string;
+        tariffOrderId: "JPDCL-JERC-FY2025-26-SUBSIDIZED";
+        formulaVersion: string;
+    };
+    input: {
+        measuredUnitsKwh: number;
+        billedUnitsKwh: number;
+        sanctionedLoadKw: number;
+        billedLoadKw: number;
+        prepaid: boolean;
+        solarWaterHeaterEligible: boolean;
+    };
+    rates: {
+        energySlabs: readonly [{
+            readonly upToKwh: 200;
+            readonly ratePerKwh: 2.3;
+        }, {
+            readonly upToKwh: 400;
+            readonly ratePerKwh: 4;
+        }, {
+            readonly upToKwh: null;
+            readonly ratePerKwh: 4.35;
+        }];
+        fixedChargePerKwMonth: 8;
+        prepaidEnergyRebatePercent: 2;
+        latePaymentPercentPerMonth: 1.5;
+        solarWaterHeaterRebatePerMonth: 150;
+    };
+    slabCharges: TariffSlabCharge[];
+    charges: {
+        energyCharge: number;
+        fixedCharge: number;
+        prepaidRebate: number;
+        solarWaterHeaterRebate: number;
+        tariffSubtotal: number;
+        electricityDuty: number;
+        otherCharges: number;
+        latePaymentSurcharge: number;
+        totalEstimate: number;
+        currency: string;
+    };
+    exclusions: string[];
+    source: {
+        readonly id: "JPDCL-JERC-FY2025-26-SUBSIDIZED";
+        readonly title: "JPDCL & KPDCL ARR and Tariff for FY 2025-26 - Subsidized Tariff";
+        readonly fiscalYear: "2025-26";
+        readonly sourceUrl: "https://jpdcl.jk.gov.in/downloads/tariff/JPDCL_Tariff_Order_2025_26.pdf";
+        readonly domesticSchedule: {
+            readonly pdfPages: readonly [159, 160];
+            readonly printedPages: readonly [139, 140];
+            readonly energySlabs: readonly [{
+                readonly upToKwh: 200;
+                readonly ratePerKwh: 2.3;
+            }, {
+                readonly upToKwh: 400;
+                readonly ratePerKwh: 4;
+            }, {
+                readonly upToKwh: null;
+                readonly ratePerKwh: 4.35;
+            }];
+            readonly fixedChargePerKwMonth: 8;
+            readonly loadRoundingKw: 0.5;
+        };
+        readonly generalTerms: {
+            readonly pdfPages: readonly [176, 177, 178, 179, 180];
+            readonly printedPages: readonly [156, 157, 158, 159, 160];
+            readonly prepaidEnergyRebatePercent: 2;
+            readonly latePaymentPercentPerMonth: 1.5;
+            readonly solarWaterHeaterRebatePerMonth: 150;
+        };
+    };
+};

package/dist/tariff.js

@@ -0,0 +1,124 @@
+export const JPDCL_TARIFF_ORDER_2025_26 = {
+    id: "JPDCL-JERC-FY2025-26-SUBSIDIZED",
+    title: "JPDCL & KPDCL ARR and Tariff for FY 2025-26 - Subsidized Tariff",
+    fiscalYear: "2025-26",
+    sourceUrl: "https://jpdcl.jk.gov.in/downloads/tariff/JPDCL_Tariff_Order_2025_26.pdf",
+    domesticSchedule: {
+        pdfPages: [159, 160],
+        printedPages: [139, 140],
+        energySlabs: [
+            { upToKwh: 200, ratePerKwh: 2.30 },
+            { upToKwh: 400, ratePerKwh: 4.00 },
+            { upToKwh: null, ratePerKwh: 4.35 },
+        ],
+        fixedChargePerKwMonth: 8.00,
+        loadRoundingKw: 0.5,
+    },
+    generalTerms: {
+        pdfPages: [176, 177, 178, 179, 180],
+        printedPages: [156, 157, 158, 159, 160],
+        prepaidEnergyRebatePercent: 2,
+        latePaymentPercentPerMonth: 1.5,
+        solarWaterHeaterRebatePerMonth: 150,
+    },
+};
+export function calculateDomesticMeteredCharges(input) {
+    requireNonNegative("unitsKwh", input.unitsKwh);
+    requireNonNegative("sanctionedLoadKw", input.sanctionedLoadKw);
+    const billedUnitsKwh = Math.round(input.unitsKwh);
+    const billedLoadKw = Math.ceil(input.sanctionedLoadKw / 0.5) * 0.5;
+    const slabCharges = calculateSlabs(billedUnitsKwh);
+    const energyCharge = roundMoney(slabCharges.reduce((sum, slab) => sum + slab.amount, 0));
+    const fixedCharge = roundMoney(billedLoadKw * JPDCL_TARIFF_ORDER_2025_26.domesticSchedule.fixedChargePerKwMonth);
+    const prepaidRebate = input.prepaid
+        ? roundMoney(energyCharge * JPDCL_TARIFF_ORDER_2025_26.generalTerms.prepaidEnergyRebatePercent / 100)
+        : 0;
+    const solarWaterHeaterRebate = input.solarWaterHeaterEligible
+        ? JPDCL_TARIFF_ORDER_2025_26.generalTerms.solarWaterHeaterRebatePerMonth
+        : 0;
+    const electricityDuty = optionalMoney("electricityDutyAmount", input.electricityDutyAmount);
+    const otherCharges = optionalMoney("otherChargesAmount", input.otherChargesAmount);
+    const lateMonths = input.lateMonths ?? 0;
+    requireNonNegative("lateMonths", lateMonths);
+    const unpaidPrincipal = optionalMoney("unpaidPrincipalAmount", input.unpaidPrincipalAmount);
+    const latePaymentSurcharge = roundMoney(unpaidPrincipal * lateMonths * JPDCL_TARIFF_ORDER_2025_26.generalTerms.latePaymentPercentPerMonth / 100);
+    const tariffSubtotal = roundMoney(Math.max(0, energyCharge + fixedCharge - prepaidRebate - solarWaterHeaterRebate));
+    const totalEstimate = roundMoney(tariffSubtotal + electricityDuty + otherCharges + latePaymentSurcharge);
+    return {
+        _meta: {
+            dataClass: "deterministic-calculation",
+            purpose: "estimate-not-utility-bill",
+            tariffOrderId: JPDCL_TARIFF_ORDER_2025_26.id,
+            formulaVersion: "1.0",
+        },
+        input: {
+            measuredUnitsKwh: input.unitsKwh,
+            billedUnitsKwh,
+            sanctionedLoadKw: input.sanctionedLoadKw,
+            billedLoadKw,
+            prepaid: Boolean(input.prepaid),
+            solarWaterHeaterEligible: Boolean(input.solarWaterHeaterEligible),
+        },
+        rates: {
+            energySlabs: JPDCL_TARIFF_ORDER_2025_26.domesticSchedule.energySlabs,
+            fixedChargePerKwMonth: JPDCL_TARIFF_ORDER_2025_26.domesticSchedule.fixedChargePerKwMonth,
+            prepaidEnergyRebatePercent: JPDCL_TARIFF_ORDER_2025_26.generalTerms.prepaidEnergyRebatePercent,
+            latePaymentPercentPerMonth: JPDCL_TARIFF_ORDER_2025_26.generalTerms.latePaymentPercentPerMonth,
+            solarWaterHeaterRebatePerMonth: JPDCL_TARIFF_ORDER_2025_26.generalTerms.solarWaterHeaterRebatePerMonth,
+        },
+        slabCharges,
+        charges: {
+            energyCharge,
+            fixedCharge,
+            prepaidRebate: -prepaidRebate,
+            solarWaterHeaterRebate: -solarWaterHeaterRebate,
+            tariffSubtotal,
+            electricityDuty,
+            otherCharges,
+            latePaymentSurcharge,
+            totalEstimate,
+            currency: "INR",
+        },
+        exclusions: [
+            "arrears and bill adjustments unless supplied as otherChargesAmount",
+            "electricity duty or government levy unless supplied as electricityDutyAmount",
+            "FPPCA or later tariff revision not present in the cited order",
+            "excess-demand charges unless assessed by JPDCL",
+            "meter defects, penalties, and utility-specific rounding or adjustments",
+        ],
+        source: JPDCL_TARIFF_ORDER_2025_26,
+    };
+}
+function calculateSlabs(unitsKwh) {
+    const definitions = [
+        { fromKwh: 1, toKwh: 200, width: 200, ratePerKwh: 2.30 },
+        { fromKwh: 201, toKwh: 400, width: 200, ratePerKwh: 4.00 },
+        { fromKwh: 401, toKwh: null, width: Number.POSITIVE_INFINITY, ratePerKwh: 4.35 },
+    ];
+    let remaining = unitsKwh;
+    return definitions.map((definition) => {
+        const slabUnits = Math.max(0, Math.min(remaining, definition.width));
+        remaining -= slabUnits;
+        return {
+            fromKwh: definition.fromKwh,
+            toKwh: definition.toKwh,
+            unitsKwh: slabUnits,
+            ratePerKwh: definition.ratePerKwh,
+            amount: roundMoney(slabUnits * definition.ratePerKwh),
+        };
+    }).filter((slab) => slab.unitsKwh > 0);
+}
+function optionalMoney(name, value) {
+    if (value === undefined)
+        return 0;
+    requireNonNegative(name, value);
+    return roundMoney(value);
+}
+function requireNonNegative(name, value) {
+    if (!Number.isFinite(value) || value < 0)
+        throw new TypeError(`${name} must be a non-negative finite number`);
+}
+function roundMoney(value) {
+    return Math.round((value + Number.EPSILON) * 100) / 100;
+}
+//# sourceMappingURL=tariff.js.map

package/dist/tariff.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export interface PortalResponse<T = unknown> {
+    status?: boolean | number | string;
+    message?: string;
+    data?: T;
+    [key: string]: unknown;
+}
+export interface MainSession {
+    version: 1;
+    createdAt: string;
+    updatedAt: string;
+    cookies: string;
+    loginId?: string;
+    primaryAccountId?: string;
+    consumerCode?: string;
+    user?: Record<string, unknown>;
+    smart?: {
+        token: string;
+        baseUrl: string;
+        appUrl?: string;
+        tenantId?: string;
+        accountId?: string;
+        meterNumber?: string;
+        userId?: string;
+        expiresAt?: string;
+    };
+}
+export interface EndpointDefinition {
+    portal: "main" | "smart" | "ledger";
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    encrypted?: boolean;
+    auth: "public" | "public-basic" | "main-session" | "smart-bearer" | "smart-admin" | "external-basic";
+    mutation?: boolean;
+    binary?: boolean;
+    dataClass?: "observed" | "derived" | "advisory" | "configuration" | "transactional";
+    description: string;
+    parameters?: string[];
+    bodyExample?: Record<string, unknown>;
+}
+export interface RequestOptions {
+    params?: Record<string, string | number | boolean | null | undefined>;
+    body?: unknown;
+    headers?: Record<string, string>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,5 @@
+import { handleMcpRequest } from "./http-handler.js";
+declare const _default: {
+    fetch: typeof handleMcpRequest;
+};
+export default _default;

package/dist/worker.js

@@ -0,0 +1,3 @@
+import { handleMcpRequest } from "./http-handler.js";
+export default { fetch: handleMcpRequest };
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC"}