jpdcl 1.0.0

package/dist/dates.js

@@ -0,0 +1,20 @@
+import { JpdclError } from "./errors.js";
+export function isIsoDate(value) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return false;
+    const timestamp = Date.parse(`${value}T00:00:00Z`);
+    return Number.isFinite(timestamp) && new Date(timestamp).toISOString().slice(0, 10) === value;
+}
+export function assertDateRange(from, to, options = {}) {
+    if (from && !isIsoDate(from))
+        throw new JpdclError("from must be a real date in YYYY-MM-DD format", 400);
+    if (to && !isIsoDate(to))
+        throw new JpdclError("to must be a real date in YYYY-MM-DD format", 400);
+    if (options.requireBoth && (!from || !to))
+        throw new JpdclError("Both from and to dates are required", 400);
+    if (options.pairedWhenPresent && Boolean(from) !== Boolean(to))
+        throw new JpdclError("Supply both from and to dates, or neither", 400);
+    if (from && to && from > to)
+        throw new JpdclError("from must be on or before to", 400);
+}
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAa,EACb,EAAW,EACX,UAAkE,EAAE;IAEpE,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,+CAA+C,EAAE,GAAG,CAAC,CAAC;IACzG,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,6CAA6C,EAAE,GAAG,CAAC,CAAC;IACnG,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;IAC5G,IAAI,OAAO,CAAC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;IACvI,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,GAAG,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;AACzF,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class JpdclError extends Error {
+    readonly status?: number | undefined;
+    readonly details?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, details?: unknown | undefined);
+}
+export declare class AuthenticationError extends JpdclError {
+    constructor(message?: string, details?: unknown);
+}
+export declare class MutationDisabledError extends JpdclError {
+    constructor();
+}

package/dist/errors.js

@@ -0,0 +1,23 @@
+export class JpdclError extends Error {
+    status;
+    details;
+    constructor(message, status, details) {
+        super(message);
+        this.status = status;
+        this.details = details;
+        this.name = "JpdclError";
+    }
+}
+export class AuthenticationError extends JpdclError {
+    constructor(message = "JPDCL authentication is required", details) {
+        super(message, 401, details);
+        this.name = "AuthenticationError";
+    }
+}
+export class MutationDisabledError extends JpdclError {
+    constructor() {
+        super("Mutating JPDCL operations are disabled. Set JPDCL_ENABLE_MUTATIONS=true to enable them.", 403);
+        this.name = "MutationDisabledError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IACA;IAHlB,YACE,OAAe,EACC,MAAe,EACf,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAS;QACf,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AACD,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,OAAO,GAAG,kCAAkC,EAAE,OAAiB;QACzE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD;QACE,KAAK,CACH,yFAAyF,EACzF,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/http-handler.d.ts

@@ -0,0 +1 @@
+export declare function handleMcpRequest(request: Request): Promise<Response>;

package/dist/http-handler.js

@@ -0,0 +1,46 @@
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { createJpdclMcpServer } from "./mcp.js";
+import { JpdclRuntime } from "./runtime.js";
+const corsHeaders = {
+    "Access-Control-Allow-Origin": "*",
+    "Access-Control-Allow-Methods": "GET, POST, DELETE, OPTIONS",
+    "Access-Control-Allow-Headers": "Content-Type, Accept, mcp-protocol-version, mcp-session-id, last-event-id, x-jpdcl-login-id, x-jpdcl-password",
+    "Access-Control-Expose-Headers": "mcp-protocol-version, mcp-session-id",
+};
+function withCors(response) {
+    const headers = new Headers(response.headers);
+    for (const [name, value] of Object.entries(corsHeaders))
+        headers.set(name, value);
+    return new Response(response.body, { status: response.status, statusText: response.statusText, headers });
+}
+export async function handleMcpRequest(request) {
+    if (request.method === "OPTIONS")
+        return new Response(null, { status: 204, headers: corsHeaders });
+    const loginId = request.headers.get("x-jpdcl-login-id")?.trim();
+    const password = request.headers.get("x-jpdcl-password")?.trim();
+    if (Boolean(loginId) !== Boolean(password)) {
+        return withCors(Response.json({
+            jsonrpc: "2.0",
+            error: { code: -32602, message: "Both x-jpdcl-login-id and x-jpdcl-password are required" },
+            id: null,
+        }, { status: 400 }));
+    }
+    const url = new URL(request.url);
+    const runtime = await JpdclRuntime.create({
+        credentials: loginId && password ? { loginId, password, source: "environment" } : undefined,
+        persistent: false,
+        allowMutations: url.searchParams.get("allowMutations") === "true",
+    });
+    const server = await createJpdclMcpServer({
+        runtime,
+        allowCredentialStorage: false,
+        credentialSource: loginId && password ? "smithery-connection" : undefined,
+    });
+    const transport = new WebStandardStreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+        enableJsonResponse: true,
+    });
+    await server.connect(transport);
+    return withCors(await transport.handleRequest(request));
+}
+//# sourceMappingURL=http-handler.js.map

package/dist/http-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-handler.js","sourceRoot":"","sources":["../src/http-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC;AACzH,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,GAAG;IAClB,6BAA6B,EAAE,GAAG;IAClC,8BAA8B,EAAE,4BAA4B;IAC5D,8BAA8B,EAAE,+GAA+G;IAC/I,+BAA+B,EAAE,sCAAsC;CACxE,CAAC;AAEF,SAAS,QAAQ,CAAC,QAAkB;IAClC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClF,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAgB;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAEnG,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC;IACjE,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC5B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,yDAAyD,EAAE;YAC3F,EAAE,EAAE,IAAI;SACT,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC;QACxC,WAAW,EAAE,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS;QAC3F,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,MAAM;KAClE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;QACxC,OAAO;QACP,sBAAsB,EAAE,KAAK;QAC7B,gBAAgB,EAAE,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS;KAC1E,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,wCAAwC,CAAC;QAC7D,kBAAkB,EAAE,SAAS;QAC7B,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC,MAAM,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,9 @@
+import { CookieJar } from "tough-cookie";
+export declare class CookieHttpClient {
+    readonly jar: CookieJar;
+    readonly fetch: typeof globalThis.fetch;
+    constructor(serializedCookies?: string);
+    serialize(): string;
+}
+export declare function basicAuth(value: string): string;
+export declare function buildUrl(baseUrl: string, path: string, params?: Record<string, string | number | boolean | null | undefined>): string;

package/dist/http.js

@@ -0,0 +1,43 @@
+import makeFetchCookie from "fetch-cookie";
+import { CookieJar } from "tough-cookie";
+export class CookieHttpClient {
+    jar;
+    fetch;
+    constructor(serializedCookies) {
+        this.jar = serializedCookies
+            ? CookieJar.deserializeSync(JSON.parse(serializedCookies))
+            : new CookieJar();
+        this.fetch = makeFetchCookie(globalThis.fetch, this.jar);
+    }
+    serialize() {
+        return JSON.stringify(this.jar.serializeSync());
+    }
+}
+export function basicAuth(value) {
+    return `Basic ${Buffer.from(value, "utf8").toString("base64")}`;
+}
+export function buildUrl(baseUrl, path, params = {}) {
+    let resolved = path;
+    const unused = { ...params };
+    for (const [key, rawValue] of Object.entries(params)) {
+        const marker = `{${key}}`;
+        if (resolved.includes(marker)) {
+            if (rawValue === undefined || rawValue === null) {
+                throw new Error(`Missing required URL parameter: ${key}`);
+            }
+            resolved = resolved.replaceAll(marker, encodeURIComponent(String(rawValue)));
+            delete unused[key];
+        }
+    }
+    const missing = [...resolved.matchAll(/\{([^}]+)\}/g)].map((match) => match[1]);
+    if (missing.length)
+        throw new Error(`Missing required URL parameter(s): ${missing.join(", ")}`);
+    const base = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+    const url = new URL(resolved.replace(/^\//, ""), base);
+    for (const [key, value] of Object.entries(unused)) {
+        if (value !== undefined && value !== null)
+            url.searchParams.set(key, String(value));
+    }
+    return url.toString();
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,OAAO,gBAAgB;IAClB,GAAG,CAAY;IACf,KAAK,CAA0B;IAExC,YAAY,iBAA0B;QACpC,IAAI,CAAC,GAAG,GAAG,iBAAiB;YAC1B,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC1D,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAA4B,CAAC;IACtF,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;IAClD,CAAC;CACF;AACD,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,SAAS,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,OAAe,EACf,IAAY,EACZ,SAAuE,EAAE;IAEzE,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC;QAC1B,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC7E,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEhG,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;IAC7D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./catalog.js";
+export * from "./config.js";
+export * from "./crypto.js";
+export * from "./credentials.js";
+export * from "./errors.js";
+export * from "./main-client.js";
+export * from "./ledger-client.js";
+export * from "./dates.js";
+export * from "./runtime.js";
+export * from "./session.js";
+export * from "./smart-client.js";
+export * from "./tariff.js";
+export * from "./types.js";

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from "./catalog.js";
+export * from "./config.js";
+export * from "./crypto.js";
+export * from "./credentials.js";
+export * from "./errors.js";
+export * from "./main-client.js";
+export * from "./ledger-client.js";
+export * from "./dates.js";
+export * from "./runtime.js";
+export * from "./session.js";
+export * from "./smart-client.js";
+export * from "./tariff.js";
+export * from "./types.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,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/launcher.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/launcher.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// MCP clients start the package without arguments. Any explicit argument selects
+// the human CLI, so `npx jpdcl` and `jpdcl auth status` can share one executable.
+if (process.argv.length > 2) {
+    await import("./cli.js");
+}
+else {
+    await import("./mcp-stdio.js");
+}
+export {};
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.js","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":";AAEA,iFAAiF;AACjF,kFAAkF;AAClF,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC5B,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;AAC3B,CAAC;KAAM,CAAC;IACN,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACjC,CAAC"}

package/dist/ledger-client.d.ts

@@ -0,0 +1,112 @@
+import type { EndpointName } from "./catalog.js";
+import type { RequestOptions } from "./types.js";
+export declare const LEDGER_PORTAL_URL = "https://smartmeter1.jpdcl.co.in/smartmeter/";
+export declare const LEDGER_CONSUMER_ENDPOINT: string;
+export declare const LEDGER_ALARM_ENDPOINT: string;
+export interface LedgerReading {
+    observedAt: string;
+    cumulative: {
+        importKwh: number;
+        exportKwh: number;
+        netImportKwh: number;
+        importKvah: number;
+        exportKvah: number;
+        netImportKvah: number;
+    };
+}
+export interface LedgerConsumerData {
+    _meta: {
+        dataClass: "observed";
+        source: "jpdcl-daily-meter-ledger";
+        sourceUrl: string;
+        fetchedAt: string;
+        publicConsumerLookup: true;
+    };
+    consumer: {
+        consumerId: string;
+        name: string | null;
+        smartMeterNumber: string | null;
+        installationDate: string | null;
+        netMeter: boolean | null;
+        earthLoading: boolean | null;
+    };
+    readings: LedgerReading[];
+}
+export interface LedgerPeriodOptions {
+    from?: string;
+    to?: string;
+    limit?: number;
+}
+export declare class JpdclLedgerClient {
+    private readonly timeoutMs;
+    private readonly cacheMs;
+    private readonly cache;
+    constructor(timeoutMs?: number, cacheMs?: number);
+    consumer(consumerId: string): Promise<LedgerConsumerData>;
+    alarms(meterNumber: string): Promise<Record<string, unknown>>;
+    request(name: EndpointName | string, options?: RequestOptions): Promise<unknown>;
+}
+export declare function parseLedgerHtml(html: string, expectedConsumerId: string): LedgerConsumerData;
+export declare function ledgerPeriod(data: LedgerConsumerData, options?: LedgerPeriodOptions): {
+    _meta: {
+        dataClass: string;
+        source: "jpdcl-daily-meter-ledger";
+        fetchedAt: string;
+        calculation: string;
+    };
+    consumer: {
+        consumerId: string;
+        name: string | null;
+        smartMeterNumber: string | null;
+        installationDate: string | null;
+        netMeter: boolean | null;
+        earthLoading: boolean | null;
+    };
+    availability: {
+        firstObservation: string | null;
+        latestObservation: string | null;
+        sourceRecordCount: number;
+        freshnessHoursAtFetch: number;
+    };
+    period: {
+        from: string;
+        to: string;
+        baselineObservation: string | null;
+        latestObservation: string | null;
+        usage: {
+            importKwh: number;
+            exportKwh: number;
+            netImportKwh: number;
+            importKvah: number;
+            exportKvah: number;
+            netImportKvah: number;
+        } | null;
+        provisionalBillableKwh: number | null;
+        provisionalBillableBasis: string;
+        warning: string;
+    };
+    readings: {
+        usageSincePreviousObservation: {
+            importKwh: number;
+            exportKwh: number;
+            netImportKwh: number;
+            importKvah: number;
+            exportKvah: number;
+            netImportKvah: number;
+        } | null;
+        observedAt: string;
+        cumulative: {
+            importKwh: number;
+            exportKwh: number;
+            netImportKwh: number;
+            importKvah: number;
+            exportKvah: number;
+            netImportKvah: number;
+        };
+    }[];
+    pagination: {
+        returned: number;
+        matched: number;
+        limit: number | null;
+    };
+};

package/dist/ledger-client.js

@@ -0,0 +1,221 @@
+import * as cheerio from "cheerio";
+import { assertDateRange } from "./dates.js";
+import { JpdclError } from "./errors.js";
+export const LEDGER_PORTAL_URL = "https://smartmeter1.jpdcl.co.in/smartmeter/";
+export const LEDGER_CONSUMER_ENDPOINT = new URL("assets/php/_getConsumerDetails.php", LEDGER_PORTAL_URL).toString();
+export const LEDGER_ALARM_ENDPOINT = new URL("assets/php/_getAlarmDetails.php", LEDGER_PORTAL_URL).toString();
+export class JpdclLedgerClient {
+    timeoutMs;
+    cacheMs;
+    cache = new Map();
+    constructor(timeoutMs = 20_000, cacheMs = 30_000) {
+        this.timeoutMs = timeoutMs;
+        this.cacheMs = cacheMs;
+    }
+    async consumer(consumerId) {
+        validateConsumerId(consumerId);
+        const cached = this.cache.get(consumerId);
+        if (cached && Date.now() - cached.at < this.cacheMs)
+            return cached.value;
+        const response = await postForm(LEDGER_CONSUMER_ENDPOINT, { consumercode: consumerId }, this.timeoutMs);
+        if (!response.ok)
+            throw new JpdclError(`Daily meter portal returned HTTP ${response.status}`, response.status);
+        const parsed = parseLedgerHtml(await response.text(), consumerId);
+        this.cache.set(consumerId, { at: Date.now(), value: parsed });
+        return parsed;
+    }
+    async alarms(meterNumber) {
+        if (!meterNumber.trim())
+            throw new JpdclError("A smart-meter number is required", 400);
+        const response = await postForm(LEDGER_ALARM_ENDPOINT, { meterSno: meterNumber.trim() }, this.timeoutMs);
+        if (!response.ok)
+            throw new JpdclError(`Daily meter alarm endpoint returned HTTP ${response.status}`, response.status);
+        const body = await response.text();
+        const noAlarms = /no\s+alarms/i.test(body);
+        const tables = noAlarms ? [] : parseGenericTables(body);
+        return {
+            _meta: {
+                dataClass: "observed",
+                source: "jpdcl-daily-meter-ledger-alarm-endpoint",
+                sourceUrl: LEDGER_ALARM_ENDPOINT,
+                fetchedAt: new Date().toISOString(),
+            },
+            meterNumber,
+            hasAlarms: noAlarms ? false : tables.some((table) => table.rows.length > 0),
+            tables,
+            message: noAlarms ? "No Alarms" : undefined,
+        };
+    }
+    async request(name, options = {}) {
+        if (name === "ledger_consumer_readings") {
+            const consumerId = String(options.params?.consumerId ?? options.body?.consumerId ?? "");
+            return this.consumer(consumerId);
+        }
+        if (name === "ledger_meter_alarms") {
+            const meterNumber = String(options.params?.meterNumber ?? options.body?.meterNumber ?? "");
+            return this.alarms(meterNumber);
+        }
+        throw new JpdclError(`Unknown daily meter ledger endpoint: ${name}`, 400);
+    }
+}
+export function parseLedgerHtml(html, expectedConsumerId) {
+    const [profileHtml, tableHtml = ""] = html.split("||||");
+    const profile = parseProfile(profileHtml ?? "");
+    const $ = cheerio.load(tableHtml);
+    const readings = [];
+    $("#readtable1 tbody tr").each((_, row) => {
+        const cells = $(row).find("td").map((__, cell) => $(cell).text().trim()).get();
+        if (cells.length < 7 || !/^\d{4}-\d{2}-\d{2}$/.test(cells[0] ?? ""))
+            return;
+        const values = cells.slice(1, 7).map(Number);
+        if (values.some((value) => !Number.isFinite(value)))
+            return;
+        readings.push({
+            observedAt: `${cells[0]}T00:00:00+05:30`,
+            cumulative: {
+                importKwh: values[0], exportKwh: values[1], netImportKwh: values[2],
+                importKvah: values[3], exportKvah: values[4], netImportKvah: values[5],
+            },
+        });
+    });
+    readings.sort((a, b) => b.observedAt.localeCompare(a.observedAt));
+    if (!readings.length)
+        throw new JpdclError("No daily meter readings were returned for this consumer ID", 404);
+    const consumerId = profile["consumer id"] || expectedConsumerId;
+    return {
+        _meta: {
+            dataClass: "observed",
+            source: "jpdcl-daily-meter-ledger",
+            sourceUrl: LEDGER_CONSUMER_ENDPOINT,
+            fetchedAt: new Date().toISOString(),
+            publicConsumerLookup: true,
+        },
+        consumer: {
+            consumerId,
+            name: nullable(profile.name),
+            smartMeterNumber: nullable(profile["smart meter"]),
+            installationDate: validDate(profile["inatallation date"] ?? profile["installation date"]),
+            netMeter: yesNo(profile["net meter"]),
+            earthLoading: yesNo(profile["earth-loading"]),
+        },
+        readings,
+    };
+}
+export function ledgerPeriod(data, options = {}) {
+    const newestDate = data.readings[0]?.observedAt.slice(0, 10);
+    if (!newestDate)
+        throw new JpdclError("The daily meter ledger is empty", 404);
+    const from = options.from ?? `${newestDate.slice(0, 7)}-01`;
+    const to = options.to ?? newestDate;
+    assertDateRange(from, to, { requireBoth: true });
+    const ascending = [...data.readings].sort((a, b) => a.observedAt.localeCompare(b.observedAt));
+    const selected = ascending.filter((reading) => {
+        const day = reading.observedAt.slice(0, 10);
+        return day >= from && day <= to;
+    });
+    const baseline = [...ascending].reverse().find((reading) => reading.observedAt.slice(0, 10) < from) ?? selected[0];
+    const latest = selected.at(-1);
+    const deltas = new Map();
+    for (let index = 1; index < ascending.length; index++) {
+        deltas.set(ascending[index].observedAt, subtractReadings(ascending[index], ascending[index - 1]));
+    }
+    const requestedLimit = Math.max(0, Math.floor(options.limit ?? 35));
+    const returned = (requestedLimit === 0 ? [] : [...selected].reverse().slice(0, requestedLimit)).map((reading) => ({
+        ...reading,
+        usageSincePreviousObservation: deltas.get(reading.observedAt) ?? null,
+    }));
+    const periodUsage = baseline && latest ? subtractReadings(latest, baseline) : null;
+    const settlementCandidateKwh = periodUsage
+        ? data.consumer.netMeter ? Math.max(0, periodUsage.netImportKwh) : Math.max(0, periodUsage.importKwh)
+        : null;
+    const latestDay = new Date(`${newestDate}T00:00:00+05:30`).getTime();
+    return {
+        _meta: {
+            dataClass: "observed-with-deterministic-deltas",
+            source: data._meta.source,
+            fetchedAt: data._meta.fetchedAt,
+            calculation: "cumulative register subtraction",
+        },
+        consumer: data.consumer,
+        availability: {
+            firstObservation: data.readings.at(-1)?.observedAt ?? null,
+            latestObservation: data.readings[0]?.observedAt ?? null,
+            sourceRecordCount: data.readings.length,
+            freshnessHoursAtFetch: Math.max(0, Math.round((new Date(data._meta.fetchedAt).getTime() - latestDay) / 360_000) / 10),
+        },
+        period: {
+            from,
+            to,
+            baselineObservation: baseline?.observedAt ?? null,
+            latestObservation: latest?.observedAt ?? null,
+            usage: periodUsage,
+            provisionalBillableKwh: settlementCandidateKwh,
+            provisionalBillableBasis: data.consumer.netMeter ? "net-import-register-difference" : "import-register-difference",
+            warning: "Register differences are meter evidence, but JPDCL may use different billing cutoffs, adjustments, carry-forward credits, or settlement rules.",
+        },
+        readings: returned,
+        pagination: { returned: returned.length, matched: selected.length, limit: requestedLimit || null },
+    };
+}
+function subtractReadings(current, previous) {
+    const result = {};
+    for (const key of Object.keys(current.cumulative)) {
+        result[key] = round3(current.cumulative[key] - previous.cumulative[key]);
+    }
+    return result;
+}
+function parseProfile(html) {
+    const $ = cheerio.load(html);
+    const profile = {};
+    $(".row").each((_, row) => {
+        const columns = $(row).find(".col").map((__, column) => $(column).text().replace(/\s+/g, " ").trim()).get();
+        const key = columns[0]?.toLowerCase();
+        if (!key)
+            return;
+        profile[key] = $(row).find("input").attr("value")?.trim() ?? columns[1] ?? "";
+    });
+    return profile;
+}
+function parseGenericTables(html) {
+    const $ = cheerio.load(html);
+    return $("table").map((_, table) => {
+        const headers = $(table).find("thead th").map((__, cell) => $(cell).text().replace(/\s+/g, " ").trim()).get();
+        const rows = $(table).find("tbody tr").map((__, row) => [$(row).find("td").map((___, cell) => $(cell).text().replace(/\s+/g, " ").trim()).get()]).get();
+        return { headers, rows };
+    }).get();
+}
+async function postForm(url, fields, timeoutMs) {
+    return fetch(url, {
+        method: "POST",
+        headers: {
+            Accept: "text/html, */*; q=0.01",
+            "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8",
+            "X-Requested-With": "XMLHttpRequest",
+        },
+        body: new URLSearchParams(fields),
+        signal: AbortSignal.timeout(timeoutMs),
+    });
+}
+function validateConsumerId(value) {
+    if (!/^\d{1,13}$/.test(value))
+        throw new JpdclError("Consumer ID must contain 1 to 13 digits", 400);
+}
+function nullable(value) {
+    return value?.trim() ? value.trim() : null;
+}
+function validDate(value) {
+    return value && /^\d{4}-\d{2}-\d{2}$/.test(value) && value !== "0000-00-00" ? value : null;
+}
+function yesNo(value) {
+    if (!value)
+        return null;
+    if (/^yes$/i.test(value.trim()))
+        return true;
+    if (/^no$/i.test(value.trim()))
+        return false;
+    return null;
+}
+function round3(value) {
+    return Math.round((value + Number.EPSILON) * 1000) / 1000;
+}
+//# sourceMappingURL=ledger-client.js.map

package/dist/ledger-client.js.map

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

package/dist/main-client.d.ts

@@ -0,0 +1,25 @@
+import { type EndpointName } from "./catalog.js";
+import { type Credentials } from "./credentials.js";
+import type { MainSession, PortalResponse, RequestOptions } from "./types.js";
+export declare class JpdclClient {
+    private readonly baseUrl;
+    private readonly allowMutations;
+    private readonly suppliedCredentials?;
+    private readonly persistSession;
+    private readonly http;
+    private session?;
+    constructor(session?: MainSession, baseUrl?: string, allowMutations?: boolean, suppliedCredentials?: Credentials | undefined, persistSession?: (session: MainSession) => Promise<void>);
+    get currentSession(): MainSession | undefined;
+    login(loginId: string, password: string): Promise<PortalResponse>;
+    request<T = unknown>(name: EndpointName | string, options?: RequestOptions): Promise<PortalResponse<T>>;
+    private requestInternal;
+    private decodeResponse;
+    customerInfo(accountId?: string | undefined): Promise<PortalResponse>;
+    linkedAccounts(loginId?: string | undefined): Promise<PortalResponse>;
+    history(type: "BILL" | "PAYM", accountId?: string | undefined, from?: string, to?: string): Promise<PortalResponse>;
+    consumption(accountId?: string | undefined, from?: string, to?: string): Promise<PortalResponse>;
+    smartSso(accountId: string, meterNumber: string): Promise<PortalResponse>;
+    digest(accountId?: string | undefined): Promise<Record<string, unknown>>;
+}
+export declare function isoDate(date: Date): string;
+export declare function sixMonthsAgo(): string;