@substrat-run/connector-planima 0.2.0 → 0.2.1

package/dist/api.js

@@ -0,0 +1,462 @@
+import { z } from 'zod';
+/**
+ * A thin, typed client over the Planima REST API.
+ *
+ * Every call goes through the connection's `fetch`, never a global one: that is what
+ * gets it a timeout, an egress policy, and health recorded against the right
+ * connection. Module code cannot reach any of this — boundary-lint bans `fetch`
+ * outright — and a connector is host code.
+ *
+ * ## One host, and the two headers that are easy to get wrong
+ *
+ * Unlike Fortnox there is no separate OAuth origin: Planima has a single host and a
+ * static token, so there is nothing to mint and nothing to refresh. What replaces that
+ * complexity is two header details the docs state once and a client gets wrong
+ * silently:
+ *
+ * 1. **`Authorization` carries the bare token** — no `Bearer` prefix. Planima's own
+ *    curl example is `-H "Authorization: NotARealToken+tm6rdPsx23u+4/HiguLIFQw="`.
+ *    Prefixing it is a 401 that reads exactly like a bad token.
+ * 2. **`Accept: application/vnd.planima.v1+json`** pins the version. Omitting it works
+ *    today — v1 is the default — and is precisely the kind of thing that breaks on the
+ *    day the default moves, months after the code that omitted it was written. So it
+ *    is sent on every request rather than left to the default.
+ */
+/** The one REST host. Everything hangs off this. */
+export const PLANIMA_API_BASE = 'https://api.planima.se';
+/** The version-pinning `Accept` value — sent on every request, never defaulted to. */
+export const PLANIMA_ACCEPT = 'application/vnd.planima.v1+json';
+/**
+ * Planima's page ceiling. Asking for more is not an error — the server silently caps —
+ * so the client asks for exactly this and paginates, rather than asking for a big
+ * number and believing the answer is complete.
+ */
+export const PLANIMA_MAX_PAGE = 50;
+/**
+ * A Planima connection's credential — one static API token, and nothing else.
+ *
+ * Created by a person in Planima under *account settings → API*, and it carries
+ * **that person's access level**: a token minted by a read-only user cannot write, and
+ * one minted by an admin can do everything that admin can. That is a fact worth
+ * stating in a credential's docs because it is the whole security model — there are no
+ * scopes to narrow, so the narrowing is done by choosing which user mints the token.
+ * A connector that only reads should be handed a read-only user's token, and this one
+ * only reads.
+ *
+ * There is no refresh token and no expiry, which removes the rotation hazard entirely
+ * and replaces it with a different one: a token is valid until a human revokes it in
+ * Planima, so revocation is out-of-band and the first this connector hears of it is a
+ * 401. {@link PlanimaApiError.refused} is what carries that distinction to the health
+ * record.
+ */
+export const planimaSecret = z.object({
+    token: z.string().min(1),
+});
+/**
+ * A Planima API failure, with the two bits a caller actually branches on.
+ *
+ * `refused` means the provider said "not with this token" — a 401 or 403. Everything
+ * else (a timeout, a 5xx, a parse failure) says nothing about the credential, and
+ * treating it as a refusal would make a Planima outage look like every tenant's token
+ * going bad at once.
+ *
+ * `retryAfterSeconds` is set only on a 429 and only when Planima sent the header. It is
+ * the provider's own instruction, so the throttle below obeys it rather than guessing.
+ */
+export class PlanimaApiError extends Error {
+    status;
+    refused;
+    body;
+    retryAfterSeconds;
+    constructor(message, status, body, retryAfterSeconds = null) {
+        super(message);
+        this.name = 'PlanimaApiError';
+        this.status = status;
+        this.refused = status === 401 || status === 403;
+        this.body = body;
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/**
+ * Planima's error envelope. A caller wants the message from whichever shape arrived
+ * rather than a bare status.
+ */
+function errorMessage(body, status) {
+    try {
+        const parsed = JSON.parse(body);
+        const e = parsed;
+        if (typeof e.error === 'string')
+            return e.error;
+        if (typeof e.error === 'object' && e.error !== null && typeof e.error.message === 'string') {
+            return e.error.message;
+        }
+        if (typeof e.message === 'string')
+            return e.message;
+        if (Array.isArray(e.errors) && e.errors.length > 0) {
+            return e.errors.map((x) => (typeof x === 'string' ? x : JSON.stringify(x))).join('; ');
+        }
+    }
+    catch {
+        // Not JSON — fall through to the raw slice, which is more use than nothing.
+    }
+    const slice = body.trim().slice(0, 200);
+    return slice === '' ? `HTTP ${status}` : slice;
+}
+/**
+ * `JSON.parse`, but a non-JSON body stays inside this module's error contract.
+ *
+ * This runs AFTER `res.ok`, which is exactly when it bites: a proxy, captive portal or
+ * gateway that answers `200` with an HTML page makes a bare `JSON.parse` throw a
+ * `SyntaxError`, and the caller loses `status`, `body` and `refused` — the three fields
+ * {@link PlanimaApiError} exists to carry, and the ones a sweep reports and a probe
+ * branches on.
+ */
+function asJson(body, what) {
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        throw new PlanimaApiError(`${what} was not JSON`, 502, body);
+    }
+}
+// ---------------------------------------------------------------------------
+// Provider shapes. Extra fields are ignored; every field Planima documents as
+// nullable is read as nullable, because `.optional()` alone is not enough.
+// ---------------------------------------------------------------------------
+/**
+ * A field Planima may send as an explicit `null`.
+ *
+ * `.optional()` permits an ABSENT key; Planima sends the key with `null` in it for
+ * anything unset — `address`, `zip_code`, `description` and most of `Action` are
+ * documented that way. Both mean "not set", so both become `null`, and a caller gets
+ * one case to handle instead of two.
+ */
+const nullableString = () => z
+    .union([z.string(), z.null()])
+    .optional()
+    .transform((v) => v ?? null);
+const nullableNumber = () => z
+    .union([z.number(), z.null()])
+    .optional()
+    .transform((v) => v ?? null);
+/** A list's pagination block — the cursor the walk below is driven by. */
+export const planimaPagination = z.object({
+    total_count: z.number().int().nonnegative(),
+    offset: z.number().int().nonnegative(),
+    limit: z.number().int().positive(),
+});
+export const planimaOrganization = z.object({
+    id: z.number().int(),
+    name: z.string(),
+    updated_at: nullableString(),
+    created_at: nullableString(),
+});
+export const planimaFacility = z.object({
+    id: z.number().int(),
+    name: z.string(),
+    address: nullableString(),
+    zip_code: nullableString(),
+    region: nullableString(),
+    tags: z.array(z.string()).default([]),
+    /** Residential area (sv. BOA) in m². */
+    residential_area: nullableNumber(),
+    /** Non-residential area (sv. LOA) in m². */
+    non_residential_area: nullableNumber(),
+    year_of_construction: nullableNumber(),
+    description: nullableString(),
+    /**
+     * The owning organization, nested by Planima on a facility read.
+     *
+     * Nullable AND optional, which is not belt-and-braces: `.optional()` alone permits
+     * an absent key, and a provider that sends `"organization": null` — for a facility
+     * whose organization the token cannot see, say — fails the parse and takes the whole
+     * sweep down with it. That is the exact shape of the bug `connector-fortnox` shipped
+     * against a real company, and the mock reproduces it here rather than agreeing with
+     * a convenient assumption.
+     */
+    organization: z
+        .union([planimaOrganization, z.null()])
+        .optional()
+        .transform((v) => v ?? null),
+    updated_at: nullableString(),
+    created_at: nullableString(),
+});
+export const planimaBuilding = z.object({
+    id: z.number().int(),
+    name: z.string(),
+    address: nullableString(),
+    zip_code: nullableString(),
+    region: nullableString(),
+    year_of_construction: nullableNumber(),
+    facility_id: z.number().int(),
+    updated_at: nullableString(),
+    created_at: nullableString(),
+});
+export const planimaComponent = z.object({
+    id: z.number().int(),
+    name: z.string(),
+    amount: nullableNumber(),
+    building_id: nullableNumber(),
+    /** The component DEFINITION's name — what kind of thing this is. */
+    component: nullableString(),
+    unit: nullableString(),
+    category: nullableString(),
+    /** `null` when the component has no specific type set. */
+    type: nullableString(),
+    facility_id: z.number().int(),
+    updated_at: nullableString(),
+    created_at: nullableString(),
+});
+/**
+ * One planned maintenance action — the row a maintenance plan is actually made of.
+ *
+ * Every price arrives as a JSON **number**. It does not stay one: see `plan.ts`, where
+ * it becomes a decimal string before it can reach a scope.
+ */
+export const planimaAction = z.object({
+    id: z.number().int(),
+    name: z.string(),
+    amount: nullableNumber(),
+    unit: nullableString(),
+    unit_price: nullableNumber(),
+    total_price: nullableNumber(),
+    total_price_incl_vat: nullableNumber(),
+    year: z.number().int(),
+    status: z.string(),
+    description: nullableString(),
+    /** Fraction of the cost treated as investment, as a decimal fraction. */
+    investment_rate: nullableNumber(),
+    /** VAT rate as a decimal fraction (0.25 = 25 %). */
+    vat_rate: nullableNumber(),
+    category: nullableString(),
+    location: nullableString(),
+    building: nullableString(),
+    building_id: nullableNumber(),
+    component_id: nullableNumber(),
+    is_energy_saving: z.boolean().optional().default(false),
+    co2_equivalent: nullableNumber(),
+    final_cost: nullableNumber(),
+    tags: z.array(z.string()).default([]),
+    facility: z.object({ id: z.number().int(), name: z.string() }).optional(),
+    /** Requires the Project feature; absent or null on accounts without it. */
+    project_id: nullableNumber(),
+    updated_at: nullableString(),
+    created_at: nullableString(),
+});
+/**
+ * The eight action statuses Planima documents as its `status` filter enum.
+ *
+ * Exported as data rather than enforced as a schema, and that is the point: the field
+ * itself is typed `string` in Planima's own spec, so a ninth status is an ordinary
+ * product change, not a protocol break. Parsing against a closed set would turn that
+ * into a sweep-wide throw — a whole tenant's plan failing to land because one action
+ * moved to a status added last week. A consumer that wants to branch on status has the
+ * list; the connector passes through whatever arrived.
+ */
+export const PLANIMA_ACTION_STATUSES = [
+    'draft',
+    'planned',
+    'prioritized',
+    'decided',
+    'in_progress',
+    'deferred',
+    'completed',
+    'inactive',
+];
+/**
+ * Planima's documented ceiling: 10 requests per 10 seconds per token (and 10,000 per
+ * 24 h, which a sweep of this shape cannot approach).
+ *
+ * The throttle below is a sliding window rather than a fixed delay because the two
+ * behave differently for the traffic this connector actually makes: a sweep is bursty —
+ * one facility is 3 requests back to back, then nothing while pages are landed. A fixed
+ * 1 s spacing would tax the quiet stretches for nothing; a window lets the burst
+ * through and only waits when the tenth request in ten seconds is genuinely due.
+ */
+const RATE_LIMIT_REQUESTS = 10;
+const RATE_LIMIT_WINDOW_MS = 10_000;
+export class PlanimaApi {
+    conn;
+    apiBase;
+    now;
+    sleep;
+    maxRateLimitRetries;
+    /**
+     * When the last {@link RATE_LIMIT_REQUESTS} requests went out, oldest first.
+     *
+     * Per-instance by default, matching `FortnoxApi`'s token cache: an instance is built
+     * for one unit of work, so the window lives exactly as long as that work and no
+     * cross-request state accumulates in a Worker's isolate. But the limit Planima
+     * enforces is per TOKEN, so a caller that builds several clients on one token passes
+     * {@link PlanimaApiOptions.rateWindow} to share one — which `sweepPlanimaPlan` does
+     * across every binding in a pass.
+     *
+     * What that still does not cover, stated rather than hidden: two sweeps overlapping
+     * on one token, or the tenant's own scripts using it. Both are absorbed by the 429
+     * retry below rather than prevented here, because preventing them needs a lock this
+     * connector has nowhere to keep.
+     */
+    sent;
+    constructor(conn, options) {
+        this.conn = conn;
+        this.apiBase = options?.apiBase ?? PLANIMA_API_BASE;
+        this.now = options?.now ?? (() => Date.now());
+        this.sleep = options?.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+        this.maxRateLimitRetries = options?.maxRateLimitRetries ?? 3;
+        this.sent = options?.rateWindow ?? [];
+    }
+    secret() {
+        const parsed = planimaSecret.safeParse(this.conn.secret);
+        if (!parsed.success) {
+            throw new PlanimaApiError(`incomplete Planima credential: ${parsed.error.issues.map((i) => i.path.join('.')).join(', ')}`, 400, '');
+        }
+        return parsed.data;
+    }
+    /** Wait, if the sliding window says the next request would breach the limit. */
+    async throttle() {
+        const cutoff = this.now() - RATE_LIMIT_WINDOW_MS;
+        while (this.sent.length > 0 && this.sent[0] <= cutoff)
+            this.sent.shift();
+        if (this.sent.length >= RATE_LIMIT_REQUESTS) {
+            // The oldest request leaving the window is the earliest moment a new one fits.
+            const waitMs = this.sent[0] + RATE_LIMIT_WINDOW_MS - this.now();
+            if (waitMs > 0)
+                await this.sleep(waitMs);
+            const after = this.now() - RATE_LIMIT_WINDOW_MS;
+            while (this.sent.length > 0 && this.sent[0] <= after)
+                this.sent.shift();
+        }
+        this.sent.push(this.now());
+    }
+    /**
+     * A JSON GET against the REST host, throttled, and retried through a 429.
+     *
+     * The retry exists because the window above cannot be authoritative: it models one
+     * client's own traffic, and the tenant's token may be in use by their own scripts at
+     * the same time. When Planima says "too many", it says how long to wait — so the
+     * client obeys `Retry-After` rather than backing off on a schedule of its own
+     * invention, and gives up after {@link PlanimaApiOptions.maxRateLimitRetries} so a
+     * pathologically busy token surfaces as a failed sweep instead of a hung one.
+     */
+    async getJson(path) {
+        const { token } = this.secret();
+        for (let attempt = 0;; attempt += 1) {
+            await this.throttle();
+            const res = await this.conn.fetch(`${this.apiBase}${path}`, {
+                headers: {
+                    // Bare, no `Bearer` — see this module's header note.
+                    Authorization: token,
+                    Accept: PLANIMA_ACCEPT,
+                },
+            });
+            if (res.ok)
+                return asJson(await res.text(), `Planima GET ${path}`);
+            const body = await res.text();
+            if (res.status === 429 && attempt < this.maxRateLimitRetries) {
+                const retryAfter = retryAfterMs(res.headers?.get('Retry-After') ?? null);
+                await this.sleep(retryAfter);
+                continue;
+            }
+            throw new PlanimaApiError(`Planima GET ${path} failed: ${errorMessage(body, res.status)}`, res.status, body, res.status === 429
+                ? (retryAfterMs(res.headers?.get('Retry-After') ?? null) / 1000)
+                : null);
+        }
+    }
+    /**
+     * Walk every page of a list endpoint.
+     *
+     * Termination is driven by what came BACK, never by `total_count` alone: a plan that
+     * grows mid-walk would otherwise leave the loop reading past the end, and a
+     * `total_count` that disagrees with the rows (a filter applied server-side after the
+     * count) would loop forever. An empty page ends the walk, and `total_count` is used
+     * only as the belt to that braces — a bound on how many pages can be worth asking
+     * for.
+     */
+    async list(path, schema, query = {}) {
+        const rows = [];
+        let offset = 0;
+        for (;;) {
+            const url = new URL(`${this.apiBase}${path}`);
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, String(v));
+            }
+            url.searchParams.set('page[limit]', String(PLANIMA_MAX_PAGE));
+            url.searchParams.set('page[offset]', String(offset));
+            const requested = url.toString().slice(this.apiBase.length);
+            const raw = (await this.getJson(requested));
+            // A 200 with no `data` array is NOT an empty list, and the difference is the
+            // whole plan. `raw.data ?? []` would read a malformed success — a proxy's
+            // rewritten body, a partial outage, a shape change — as "this facility has no
+            // components any more", land it, and record the content hash for it. A consumer
+            // that swaps its plan on `final` then replaces real rows with nothing, and the
+            // next sweep sees an unchanged hash and never repairs it. So a missing `data` is
+            // a response fault, reported as one.
+            if (!Array.isArray(raw.data)) {
+                throw new PlanimaApiError(`Planima GET ${requested} returned success with no 'data' array`, 502, JSON.stringify(raw).slice(0, 500));
+            }
+            const page = z.array(schema).parse(raw.data);
+            rows.push(...page);
+            if (page.length === 0)
+                return rows;
+            const pagination = planimaPagination.safeParse(raw.pagination);
+            // No pagination block at all ⇒ the endpoint is not paged, and one page is the
+            // whole answer. Trusting a missing block as "there is more" would loop forever.
+            if (!pagination.success)
+                return rows;
+            offset += page.length;
+            if (offset >= pagination.data.total_count)
+                return rows;
+            // A page shorter than the limit with the count still ahead of us means the server
+            // has stopped handing rows over; believing the count would spin.
+            if (page.length < Math.min(PLANIMA_MAX_PAGE, pagination.data.limit))
+                return rows;
+        }
+    }
+    /** Every organization this token can see — the probe read, and the sweep's entry point. */
+    async organizations() {
+        return this.list('/organizations', planimaOrganization);
+    }
+    /** Every facility, optionally narrowed to one organization. */
+    async facilities(organizationId) {
+        return this.list('/facilities', planimaFacility, { organization_id: organizationId });
+    }
+    /** One facility's buildings. */
+    async buildings(facilityId) {
+        return this.list(`/facilities/${facilityId}/buildings`, planimaBuilding);
+    }
+    /** One facility's components. */
+    async components(facilityId) {
+        return this.list(`/facilities/${facilityId}/components`, planimaComponent);
+    }
+    /**
+     * One facility's planned actions, over a year window.
+     *
+     * The window is server-side (`start_year`/`end_year`) rather than a filter applied
+     * after the fact, because a maintenance plan routinely runs 30 years out and pulling
+     * all of it to keep five years is a rate-limit budget spent on rows that get dropped.
+     */
+    async actions(facilityId, window) {
+        return this.list('/actions', planimaAction, {
+            facility_id: facilityId,
+            start_year: window.fromYear,
+            end_year: window.toYear,
+        });
+    }
+}
+/**
+ * `Retry-After` in milliseconds, defaulting to the full window.
+ *
+ * Planima documents it as a count of seconds. A missing or unparseable value falls back
+ * to the whole rate-limit window, which is the only wait guaranteed to clear a
+ * 10-per-10-seconds limit — a shorter guess just spends another request to be told the
+ * same thing.
+ */
+function retryAfterMs(header) {
+    const seconds = header === null ? Number.NaN : Number(header);
+    if (!Number.isFinite(seconds) || seconds < 0)
+        return RATE_LIMIT_WINDOW_MS;
+    // A provider that answers with an hour must not become an hour-long hung sweep.
+    return Math.min(seconds * 1000, RATE_LIMIT_WINDOW_MS * 3);
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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