@uvrn/core 1.0.0

package/dist/core/engine.d.ts

@@ -0,0 +1,3 @@
+import { DeltaBundle, DeltaReceipt, EngineOpts } from '../types';
+export declare function runDeltaEngine(bundle: DeltaBundle, opts?: EngineOpts): DeltaReceipt;
+//# sourceMappingURL=engine.d.ts.map

package/dist/core/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,YAAY,EAEZ,UAAU,EAEX,MAAM,UAAU,CAAC;AA8BlB,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAyGnF"}

package/dist/core/engine.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDeltaEngine = runDeltaEngine;
+const validation_1 = require("./validation");
+const serialization_1 = require("./serialization");
+/**
+ * Rounds a number to a fixed precision (8 decimal places) to mitigate FP hazards.
+ */
+function roundDet(num) {
+    return Math.round(num * 100000000) / 100000000;
+}
+/**
+ * Computes Delta between two numbers.
+ * Formula: |a - b| / ((a + b)/2)
+ *
+ * Rules:
+ * - If both 0 -> 0
+ * - If one 0, other != 0 -> 1.0 (Max Variance for this context)
+ */
+function computeDelta(a, b) {
+    if (a === 0 && b === 0)
+        return 0;
+    if (a === 0 || b === 0)
+        return 1.0;
+    const numerator = Math.abs(a - b);
+    const denominator = (a + b) / 2;
+    // Determine absolute delta
+    const rawDelta = numerator / denominator;
+    return roundDet(rawDelta);
+}
+function runDeltaEngine(bundle, opts) {
+    // 1. Validate
+    const validation = (0, validation_1.validateBundle)(bundle);
+    if (!validation.valid) {
+        throw new Error(`Invalid DeltaBundle: ${validation.error}`);
+    }
+    // 2. Sort DataSpecs (Stable Ordering)
+    const sortedSpecs = [...bundle.dataSpecs].sort((a, b) => a.id.localeCompare(b.id));
+    const sourceLabels = sortedSpecs.map(s => s.label);
+    // 3. Extract Comparable Metrics
+    const allKeys = new Set();
+    sortedSpecs.forEach(spec => {
+        spec.metrics.forEach(m => allKeys.add(m.key));
+    });
+    const sortedKeys = Array.from(allKeys).sort(); // Lexicographical sort
+    const comparableKeys = [];
+    for (const key of sortedKeys) {
+        let count = 0;
+        for (const spec of sortedSpecs) {
+            if (spec.metrics.some(m => m.key === key))
+                count++;
+        }
+        if (count >= 2) {
+            comparableKeys.push(key);
+        }
+    }
+    const maxRounds = bundle.maxRounds || 5;
+    const rounds = [];
+    let outcome = 'indeterminate';
+    // 4. Run Cycles
+    let currentRound = 0;
+    let finalDelta = 0;
+    while (currentRound < maxRounds) {
+        currentRound++;
+        const deltasByMetric = {};
+        let maxDeltaInRound = 0;
+        for (const key of comparableKeys) {
+            const values = [];
+            for (const spec of sortedSpecs) {
+                const m = spec.metrics.find(x => x.key === key);
+                if (m)
+                    values.push(m.value);
+            }
+            const min = Math.min(...values);
+            const max = Math.max(...values);
+            const d = computeDelta(max, min);
+            deltasByMetric[key] = d;
+            if (d > maxDeltaInRound) {
+                maxDeltaInRound = d;
+            }
+        }
+        finalDelta = maxDeltaInRound;
+        const within = maxDeltaInRound <= bundle.thresholdPct;
+        const roundData = {
+            round: currentRound,
+            deltasByMetric,
+            withinThreshold: within,
+            witnessRequired: !within && currentRound === maxRounds,
+        };
+        rounds.push(roundData);
+        if (within) {
+            outcome = 'consensus';
+            break;
+        }
+        // Continue loop if not within threshold
+    }
+    if (outcome !== 'consensus') {
+        outcome = 'indeterminate';
+    }
+    // 5. Construct Receipt (excluding hash)
+    const receiptPayload = {
+        bundleId: bundle.bundleId,
+        deltaFinal: finalDelta,
+        sources: sourceLabels,
+        rounds,
+        suggestedFixes: [],
+        outcome,
+    };
+    if (opts?.timestamp) {
+        receiptPayload.ts = opts.timestamp;
+    }
+    // 6. Canonical Serialize & Hash
+    const hash = (0, serialization_1.hashReceipt)(receiptPayload);
+    return {
+        ...receiptPayload,
+        hash
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/core/engine.js.map

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

package/dist/core/serialization.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Delta Engine Core - Serialization & Hashing
+ * Implements canonical JSON serialization and SHA-256 hashing.
+ */
+import { DeltaReceipt } from '../types';
+/**
+ * Canonically serializes an object (RFC 8785 style).
+ * - Object keys sorted lexicographically.
+ * - No whitespace.
+ */
+export declare function canonicalSerialize(obj: any): string;
+/**
+ * Computes SHA-256 hash of the canonical serialization of the receipt payload.
+ * IMPORTANT: The hash matches the `canonicalSerialize` output.
+ */
+export declare function hashReceipt(receiptPayload: Omit<DeltaReceipt, 'hash'>): string;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/core/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/core/serialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAkBnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,MAAM,CAG9E"}

package/dist/core/serialization.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Delta Engine Core - Serialization & Hashing
+ * Implements canonical JSON serialization and SHA-256 hashing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalSerialize = canonicalSerialize;
+exports.hashReceipt = hashReceipt;
+const crypto_1 = require("crypto");
+/**
+ * Canonically serializes an object (RFC 8785 style).
+ * - Object keys sorted lexicographically.
+ * - No whitespace.
+ */
+function canonicalSerialize(obj) {
+    if (obj === undefined) {
+        return '';
+    }
+    if (obj === null || typeof obj !== 'object') {
+        return JSON.stringify(obj);
+    }
+    if (Array.isArray(obj)) {
+        return '[' + obj.map((item) => canonicalSerialize(item)).join(',') + ']';
+    }
+    const keys = Object.keys(obj).sort();
+    const acc = [];
+    for (const key of keys) {
+        acc.push(JSON.stringify(key) + ':' + canonicalSerialize(obj[key]));
+    }
+    return '{' + acc.join(',') + '}';
+}
+/**
+ * Computes SHA-256 hash of the canonical serialization of the receipt payload.
+ * IMPORTANT: The hash matches the `canonicalSerialize` output.
+ */
+function hashReceipt(receiptPayload) {
+    const canonical = canonicalSerialize(receiptPayload);
+    return (0, crypto_1.createHash)('sha256').update(canonical).digest('hex');
+}
+//# sourceMappingURL=serialization.js.map

package/dist/core/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/core/serialization.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAUH,gDAkBC;AAMD,kCAGC;AAnCD,mCAAoC;AAGpC;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,GAAQ;IACzC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,cAA0C;IACpE,MAAM,SAAS,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACrD,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC"}

package/dist/core/validation.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Delta Engine Core - Validation Logic
+ * Structural validation only. No inference or enrichment.
+ */
+import { DeltaBundle, ValidationResult } from '../types';
+export declare function validateBundle(bundle: DeltaBundle): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEzD,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAiDpE"}

package/dist/core/validation.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Delta Engine Core - Validation Logic
+ * Structural validation only. No inference or enrichment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBundle = validateBundle;
+function validateBundle(bundle) {
+    if (!bundle) {
+        return { valid: false, error: 'Bundle is undefined or null' };
+    }
+    if (typeof bundle.bundleId !== 'string' || !bundle.bundleId) {
+        return { valid: false, error: 'Missing or invalid bundleId' };
+    }
+    if (typeof bundle.claim !== 'string' || !bundle.claim) {
+        return { valid: false, error: 'Missing or invalid claim' };
+    }
+    if (!Array.isArray(bundle.dataSpecs) || bundle.dataSpecs.length < 2) {
+        return { valid: false, error: 'dataSpecs must be an array with at least 2 items' };
+    }
+    // Validate thresholdPct
+    if (typeof bundle.thresholdPct !== 'number' || isNaN(bundle.thresholdPct)) {
+        return { valid: false, error: 'thresholdPct must be a valid number' };
+    }
+    if (bundle.thresholdPct <= 0 || bundle.thresholdPct > 1) {
+        return { valid: false, error: 'thresholdPct must be > 0 and <= 1' };
+    }
+    // Validate internals of dataSpecs
+    for (let i = 0; i < bundle.dataSpecs.length; i++) {
+        const spec = bundle.dataSpecs[i];
+        if (!spec.id || typeof spec.id !== 'string') {
+            return { valid: false, error: `DataSpec at index ${i} missing id` };
+        }
+        if (!spec.label || typeof spec.label !== 'string') {
+            return { valid: false, error: `DataSpec at index ${i} missing label` };
+        }
+        if (!Array.isArray(spec.metrics)) {
+            return { valid: false, error: `DataSpec at index ${i} metrics must be an array` };
+        }
+        for (const metric of spec.metrics) {
+            if (!metric.key || typeof metric.key !== 'string') {
+                return { valid: false, error: `DataSpec[${i}] has metric without key` };
+            }
+            if (typeof metric.value !== 'number' || isNaN(metric.value)) {
+                return { valid: false, error: `DataSpec[${i}] metric '${metric.key}' has invalid value` };
+            }
+        }
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

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

package/dist/core/verification.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Delta Engine Core - Verification Logic
+ * Verify receipt integrity locally.
+ */
+import { DeltaReceipt, VerifyResult } from '../types';
+export declare function verifyReceipt(receipt: DeltaReceipt): VerifyResult;
+//# sourceMappingURL=verification.d.ts.map

package/dist/core/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../src/core/verification.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGtD,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAuBjE"}

package/dist/core/verification.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Delta Engine Core - Verification Logic
+ * Verify receipt integrity locally.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyReceipt = verifyReceipt;
+const serialization_1 = require("./serialization");
+function verifyReceipt(receipt) {
+    if (!receipt) {
+        return { verified: false, error: 'Receipt is null or undefined' };
+    }
+    if (!receipt.hash) {
+        return { verified: false, error: 'Receipt missing hash' };
+    }
+    // extract hash and the rest
+    const { hash, ...payload } = receipt;
+    // Recompute hash
+    const computedHash = (0, serialization_1.hashReceipt)(payload);
+    if (computedHash === hash) {
+        return { verified: true, recomputedHash: computedHash };
+    }
+    else {
+        return {
+            verified: false,
+            recomputedHash: computedHash,
+            error: `Hash mismatch. Provided: ${hash}, Computed: ${computedHash}`
+        };
+    }
+}
+//# sourceMappingURL=verification.js.map

package/dist/core/verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../src/core/verification.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAKH,sCAuBC;AAzBD,mDAA8C;AAE9C,SAAgB,aAAa,CAAC,OAAqB;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAC5D,CAAC;IAED,4BAA4B;IAC5B,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IAErC,iBAAiB;IACjB,MAAM,YAAY,GAAG,IAAA,2BAAW,EAAC,OAAO,CAAC,CAAC;IAE1C,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,cAAc,EAAE,YAAY;YAC5B,KAAK,EAAE,4BAA4B,IAAI,eAAe,YAAY,EAAE;SACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Loosechain Delta Engine Core
+ * Layer 1 Protocol Infrastructure
+ */
+export * from './types';
+export * from './core/validation';
+export * from './core/engine';
+export * from './core/serialization';
+export * from './core/verification';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Loosechain Delta Engine Core
+ * Layer 1 Protocol Infrastructure
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./core/validation"), exports);
+__exportStar(require("./core/engine"), exports);
+__exportStar(require("./core/serialization"), exports);
+__exportStar(require("./core/verification"), exports);
+//# 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;;;GAGG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,oDAAkC;AAClC,gDAA8B;AAC9B,uDAAqC;AACrC,sDAAoC"}

package/dist/types/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Loosechain Layer 1: Delta Engine Core - Types
+ * These types constitute the "Protocol Law" and must remain stable.
+ */
+export interface MetricPoint {
+    key: string;
+    value: number;
+    unit?: string;
+    ts?: string;
+}
+export interface DataSpec {
+    id: string;
+    label: string;
+    sourceKind: 'report' | 'metric' | 'chart' | 'meta';
+    originDocIds: string[];
+    metrics: MetricPoint[];
+}
+export interface DeltaBundle {
+    bundleId: string;
+    claim: string;
+    dataSpecs: DataSpec[];
+    thresholdPct: number;
+    maxRounds?: number;
+}
+export interface DeltaRound {
+    round: number;
+    deltasByMetric: Record<string, number>;
+    withinThreshold: boolean;
+    witnessRequired: boolean;
+    notes?: string[];
+}
+export type Outcome = 'consensus' | 'indeterminate';
+export interface DeltaReceipt {
+    bundleId: string;
+    deltaFinal: number;
+    sources: string[];
+    rounds: DeltaRound[];
+    suggestedFixes: [];
+    outcome: Outcome;
+    ts?: string;
+    hash: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+export interface VerifyResult {
+    verified: boolean;
+    recomputedHash?: string;
+    error?: string;
+}
+export interface EngineOpts {
+    timestamp?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,eAAe,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,cAAc,EAAE,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAEzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/index.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Loosechain Layer 1: Delta Engine Core - Types
+ * These types constitute the "Protocol Law" and must remain stable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@uvrn/core",
+  "version": "1.0.0",
+  "description": "UVRN engine core — deterministic protocol infrastructure",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "uvrn",
+    "deterministic",
+    "protocol",
+    "consensus"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {},
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rm -rf dist"
+  }
+}