@kumbatio/energy-system 0.6.0 → 1.0.1

package/dist/persistence.js

@@ -1,4 +1,4 @@
-import { createEnergyState, isEnergyLevel, isEnergySource } from './levels.js';
+import { parseExternalEnergyState } from './levels.js';
 /*
  * `null` means "nothing usable is stored", which the engine treats as a fresh
  * install. Corrupt or schema-violating data reaches the same conclusion, but it
@@ -16,26 +16,17 @@ function parsePersistedState(source, raw) {
         console.error(`[energy-system] Discarding unparseable persisted energy state (${source})`, err);
         return null;
     }
-    if (typeof parsed !== 'object' || parsed === null || !('level' in parsed)) {
-        console.error(`[energy-system] Discarding persisted energy state with unexpected shape (${source})`);
-        return null;
-    }
-    const obj = parsed;
-    if (!isEnergyLevel(obj['level']) ||
-        !isEnergySource(obj['source']) ||
-        typeof obj['timestamp'] !== 'number' ||
-        typeof obj['revision'] !== 'number' ||
-        typeof obj['origin'] !== 'string') {
-        console.error(`[energy-system] Discarding malformed persisted energy state (${source})`);
-        return null;
-    }
     try {
-        return createEnergyState(obj['level'], obj['source'], obj['timestamp'], obj['revision'], obj['origin']);
+        // Shape, key set and field invariants are all one boundary rule, enforced
+        // to the letter of spec/energy-state.schema.json — including its
+        // `additionalProperties: false`. Storage written by a newer or foreign
+        // producer is rejected, not quietly trimmed to fit.
+        return parseExternalEnergyState(parsed);
     }
     catch (err) {
-        // Field-level invariants (negative timestamp, non-integer revision, blank
-        // origin) are enforced by createEnergyState, not by the checks above.
-        console.error(`[energy-system] Discarding invalid persisted energy state (${source})`, err);
+        // Distinct from the unparseable case above: the bytes were JSON, the
+        // content was not an EnergyState. The thrown error carries which rule broke.
+        console.error(`[energy-system] Discarding malformed persisted energy state (${source})`, err);
         return null;
     }
 }
@@ -90,18 +81,20 @@ export function localStoragePersistence(key = 'energy-state') {
  * Useful for tests, SSR, or ephemeral sessions.
  */
 export function memoryPersistence(initial) {
-    let stored = initial === undefined
-        ? null
-        : createEnergyState(initial.level, initial.source, initial.timestamp, initial.revision, initial.origin);
+    let stored = initial === undefined ? null : parseExternalEnergyState(initial);
     const listeners = new Set();
     return {
         async load() {
             return stored;
         },
         async save(state) {
-            stored = createEnergyState(state.level, state.source, state.timestamp, state.revision, state.origin);
+            // Re-parsed rather than stored by reference: this adapter is the one
+            // observers read back from, so what it hands out must satisfy the
+            // interchange contract exactly, whoever called save().
+            const next = parseExternalEnergyState(state);
+            stored = next;
             for (const listener of listeners) {
-                listener(stored);
+                listener(next);
             }
         },
         observe(onState) {

package/dist/persistence.js.map

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

package/dist/reconcile.d.ts

@@ -0,0 +1,26 @@
+import type { EnergyState } from './types.js';
+/**
+ * Should `candidate` replace `current`?
+ *
+ * The comparison walks four keys in order, stopping at the first that differs:
+ *
+ * 1. **`timestamp`** — later wins. The ordinary case, and the only one most
+ *    states ever reach.
+ * 2. **`revision`** — higher wins. Two writes inside one clock tick are not
+ *    simultaneous; the producer numbers them so they still order.
+ * 3. **`source`** — `manual` > `scheduled` > `inferred`. See `sourcePriority`.
+ * 4. **`origin`** — higher string wins. Not meaningful, and deliberately so:
+ *    when two producers write the same instant, the same revision, and the same
+ *    kind of source, there is no principled winner, and an arbitrary rule every
+ *    context computes identically beats a coin flip each context tosses
+ *    separately. Convergence is the property that matters.
+ *
+ * A final `level` comparison exists below the four keys as a backstop for
+ * producers that reuse one identity for different state, which is a contract
+ * violation but should still converge rather than oscillate.
+ *
+ * Equal on every key means equal: `false`, so an identical state never counts
+ * as a change and never fires a notification.
+ */
+export declare function isPreferredEnergyState(candidate: EnergyState, current: EnergyState): boolean;
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../src/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,YAAY,CAAA;AAqC3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAsB5F"}

package/dist/reconcile.js

@@ -0,0 +1,75 @@
+/**
+ * State reconciliation — how two `EnergyState` values that describe the same
+ * user are ordered when they meet.
+ *
+ * They meet constantly: a second browser tab writes the shared store, a desktop
+ * window and its detached child both hold an engine, a sync layer hands back
+ * what another device recorded. Every one of those paths needs the same answer
+ * to "which of these two is the current state?", and the answer has to be
+ * *deterministic* — not "last write wins by arrival order", which converges on
+ * different values depending on network timing.
+ *
+ * This is the rule, extracted from the engine so it can be read, tested, and
+ * ported on its own. It is the single hardest thing to reimplement correctly in
+ * another language, and the conformance vectors exercise it directly.
+ */
+/**
+ * How much authority each source carries when everything else ties.
+ *
+ * A level the user set by hand outranks one a schedule applied, which outranks
+ * one inferred from behaviour. This is the library's central stance in numeric
+ * form: the dial is the trust anchor, and nothing the system worked out on its
+ * own may quietly overwrite what the person said about themselves.
+ */
+function sourcePriority(source) {
+    switch (source) {
+        case 'manual':
+            return 3;
+        case 'scheduled':
+            return 2;
+        case 'inferred':
+            return 1;
+    }
+}
+/**
+ * Should `candidate` replace `current`?
+ *
+ * The comparison walks four keys in order, stopping at the first that differs:
+ *
+ * 1. **`timestamp`** — later wins. The ordinary case, and the only one most
+ *    states ever reach.
+ * 2. **`revision`** — higher wins. Two writes inside one clock tick are not
+ *    simultaneous; the producer numbers them so they still order.
+ * 3. **`source`** — `manual` > `scheduled` > `inferred`. See `sourcePriority`.
+ * 4. **`origin`** — higher string wins. Not meaningful, and deliberately so:
+ *    when two producers write the same instant, the same revision, and the same
+ *    kind of source, there is no principled winner, and an arbitrary rule every
+ *    context computes identically beats a coin flip each context tosses
+ *    separately. Convergence is the property that matters.
+ *
+ * A final `level` comparison exists below the four keys as a backstop for
+ * producers that reuse one identity for different state, which is a contract
+ * violation but should still converge rather than oscillate.
+ *
+ * Equal on every key means equal: `false`, so an identical state never counts
+ * as a change and never fires a notification.
+ */
+export function isPreferredEnergyState(candidate, current) {
+    if (candidate.timestamp !== current.timestamp) {
+        return candidate.timestamp > current.timestamp;
+    }
+    if (candidate.revision !== current.revision) {
+        return candidate.revision > current.revision;
+    }
+    if (candidate.source !== current.source) {
+        return sourcePriority(candidate.source) > sourcePriority(current.source);
+    }
+    if (candidate.origin !== current.origin) {
+        return candidate.origin > current.origin;
+    }
+    if (candidate.level !== current.level) {
+        return candidate.level > current.level;
+    }
+    return false;
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../src/reconcile.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,MAAoB;IAC1C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,CAAC,CAAA;QACV,KAAK,WAAW;YACd,OAAO,CAAC,CAAA;QACV,KAAK,UAAU;YACb,OAAO,CAAC,CAAA;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAsB,EAAE,OAAoB;IACjF,IAAI,SAAS,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IAChD,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IAC9C,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1E,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC1C,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IACxC,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kumbatio/energy-system",
-  "version": "0.6.0",
+  "version": "1.0.1",
   "private": false,
   "description": "Framework-agnostic TypeScript library for energy-aware application behavior.",
   "license": "MIT",
@@ -8,6 +8,10 @@
     "dist",
     "src/energy.css",
     "api-surface.json",
+    "conformance.json",
+    "spec",
+    "SPEC.md",
+    "CHANGELOG.md",
     "README.md"
   ],
   "type": "module",
@@ -35,27 +39,31 @@
     },
     "./css": "./src/energy.css",
     "./api-surface.json": "./api-surface.json",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./conformance.json": "./conformance.json",
+    "./spec/energy-state.schema.json": "./spec/energy-state.schema.json",
+    "./spec/conformance.schema.json": "./spec/conformance.schema.json"
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
-    "@happy-dom/global-registrator": "^20.11.1",
-    "@types/node": "^26.1.2",
+    "@happy-dom/global-registrator": "^20.11.2",
+    "@types/node": "^26.2.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
+    "ajv": "8.20.0",
     "oxfmt": "0.62.0",
     "oxlint": "1.77.0",
     "oxlint-tsgolint": "^7.0.2001",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "tsx": "^4.23.7",
+    "tsx": "^4.23.12",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {
-    "@types/react": ">=19",
-    "react": ">=19"
+    "@types/react": ">=19.2.0",
+    "react": ">=19.2.0"
   },
   "peerDependenciesMeta": {
     "@types/react": {
@@ -69,17 +77,21 @@
     "node": ">=24.19.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && pnpm run api:surface",
+    "build:ts": "tsc -p tsconfig.build.json",
+    "build": "pnpm run build:ts && pnpm run api:surface && pnpm run conformance",
     "api:surface": "tsx scripts/extract-api-surface.ts",
+    "api:surface:check": "tsx scripts/extract-api-surface.ts --check",
     "check-types": "tsc --noEmit -p tsconfig.json",
-    "test": "pnpm run build && node --test --import tsx",
+    "test": "pnpm run build:ts && node --test --import tsx",
     "validate": "pnpm run format:check && pnpm run lint && pnpm run check-types && pnpm run test && pnpm run pack:dry-run",
-    "pack:dry-run": "npm pack --dry-run",
+    "pack:dry-run": "pnpm pack --dry-run",
     "format": "oxfmt --write .",
     "format:check": "oxfmt --check .",
     "lint": "oxlint --import-plugin --type-aware --type-check --vitest-plugin .",
     "lint:fix": "oxlint --import-plugin --type-aware --type-check --vitest-plugin --fix . && oxfmt --write .",
     "lint:fix-unsafe": "oxlint --import-plugin --type-aware --type-check --vitest-plugin --fix --fix-suggestions --fix-dangerously . && oxfmt --write .",
-    "check:fix-suggestions": "oxlint --import-plugin   --type-aware --type-check --vitest-plugin --fix --fix-suggestions . && oxfmt --write ."
+    "check:fix-suggestions": "oxlint --import-plugin   --type-aware --type-check --vitest-plugin --fix --fix-suggestions . && oxfmt --write .",
+    "conformance": "TZ=UTC tsx scripts/extract-conformance.ts",
+    "conformance:check": "TZ=UTC tsx scripts/extract-conformance.ts --check"
   }
 }