@enactprotocol/shared 2.0.0 → 2.0.2

package/dist/utils/logger.js.map

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

package/dist/utils/version.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @enactprotocol/shared - Version utilities
+ *
+ * Provides semver parsing, comparison, and range checking.
+ */
+export interface ParsedVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease?: string | undefined;
+    build?: string | undefined;
+    raw: string;
+}
+export interface VersionRange {
+    operator: "=" | ">" | ">=" | "<" | "<=" | "^" | "~";
+    version: ParsedVersion;
+    raw: string;
+}
+/**
+ * Parse a semver version string
+ * Supports: 1.0.0, 1.0, 1, 1.0.0-alpha, 1.0.0+build, 1.0.0-alpha+build
+ */
+export declare function parseVersion(version: string): ParsedVersion | null;
+/**
+ * Check if a string is a valid semver version
+ */
+export declare function isValidVersion(version: string): boolean;
+/**
+ * Compare two version strings
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ */
+export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
+/**
+ * Parse a version range string
+ * Supports: =1.0.0, >1.0.0, >=1.0.0, <1.0.0, <=1.0.0, ^1.0.0, ~1.0.0
+ */
+export declare function parseRange(range: string): VersionRange | null;
+/**
+ * Check if a version satisfies a range
+ */
+export declare function satisfiesRange(version: string, range: string): boolean;
+/**
+ * Sort versions in ascending order
+ */
+export declare function sortVersions(versions: string[]): string[];
+/**
+ * Get the highest version from a list
+ */
+export declare function getHighestVersion(versions: string[]): string | null;
+/**
+ * Increment a version by bump type
+ */
+export declare function incrementVersion(version: string, bump: "major" | "minor" | "patch"): string | null;
+/**
+ * Coerce a string to a valid semver, filling in missing parts
+ */
+export declare function coerceVersion(version: string): string | null;
+/**
+ * Format a parsed version back to string
+ */
+export declare function formatVersion(version: ParsedVersion): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;IACpD,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA2BlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAgChE;AA0CD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA6B7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAgDtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAOnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAChC,MAAM,GAAG,IAAI,CAYf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqB5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAS5D"}

package/dist/utils/version.js

@@ -0,0 +1,259 @@
+/**
+ * @enactprotocol/shared - Version utilities
+ *
+ * Provides semver parsing, comparison, and range checking.
+ */
+/**
+ * Parse a semver version string
+ * Supports: 1.0.0, 1.0, 1, 1.0.0-alpha, 1.0.0+build, 1.0.0-alpha+build
+ */
+export function parseVersion(version) {
+    const trimmed = version.trim();
+    // Remove leading 'v' if present (common in tags)
+    const normalized = trimmed.startsWith("v") ? trimmed.slice(1) : trimmed;
+    // Full semver regex with prerelease and build metadata
+    const semverRegex = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-([a-zA-Z0-9.-]+))?(?:\+([a-zA-Z0-9.-]+))?$/;
+    const match = normalized.match(semverRegex);
+    if (!match) {
+        return null;
+    }
+    const major = Number.parseInt(match[1] ?? "0", 10);
+    const minor = Number.parseInt(match[2] ?? "0", 10);
+    const patch = Number.parseInt(match[3] ?? "0", 10);
+    return {
+        major,
+        minor,
+        patch,
+        prerelease: match[4],
+        build: match[5],
+        raw: trimmed,
+    };
+}
+/**
+ * Check if a string is a valid semver version
+ */
+export function isValidVersion(version) {
+    return parseVersion(version) !== null;
+}
+/**
+ * Compare two version strings
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ */
+export function compareVersions(a, b) {
+    const parsedA = parseVersion(a);
+    const parsedB = parseVersion(b);
+    // Invalid versions sort last
+    if (!parsedA && !parsedB)
+        return 0;
+    if (!parsedA)
+        return 1;
+    if (!parsedB)
+        return -1;
+    // Compare major.minor.patch
+    if (parsedA.major !== parsedB.major) {
+        return parsedA.major < parsedB.major ? -1 : 1;
+    }
+    if (parsedA.minor !== parsedB.minor) {
+        return parsedA.minor < parsedB.minor ? -1 : 1;
+    }
+    if (parsedA.patch !== parsedB.patch) {
+        return parsedA.patch < parsedB.patch ? -1 : 1;
+    }
+    // Prerelease comparison
+    // A version without prerelease is greater than one with
+    if (!parsedA.prerelease && parsedB.prerelease)
+        return 1;
+    if (parsedA.prerelease && !parsedB.prerelease)
+        return -1;
+    // Both have prereleases - compare lexically
+    if (parsedA.prerelease && parsedB.prerelease) {
+        const prereleaseCompare = comparePrerelease(parsedA.prerelease, parsedB.prerelease);
+        if (prereleaseCompare !== 0)
+            return prereleaseCompare;
+    }
+    return 0;
+}
+/**
+ * Compare prerelease strings according to semver rules
+ */
+function comparePrerelease(a, b) {
+    const partsA = a.split(".");
+    const partsB = b.split(".");
+    for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+        const partA = partsA[i];
+        const partB = partsB[i];
+        // Shorter prerelease is less than longer
+        if (partA === undefined)
+            return -1;
+        if (partB === undefined)
+            return 1;
+        const numA = Number.parseInt(partA, 10);
+        const numB = Number.parseInt(partB, 10);
+        const isNumA = !Number.isNaN(numA) && String(numA) === partA;
+        const isNumB = !Number.isNaN(numB) && String(numB) === partB;
+        // Numeric identifiers are less than alphanumeric
+        if (isNumA && !isNumB)
+            return -1;
+        if (!isNumA && isNumB)
+            return 1;
+        // Both numeric - compare as numbers
+        if (isNumA && isNumB) {
+            if (numA < numB)
+                return -1;
+            if (numA > numB)
+                return 1;
+            continue;
+        }
+        // Both alphanumeric - compare lexically
+        if (partA < partB)
+            return -1;
+        if (partA > partB)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Parse a version range string
+ * Supports: =1.0.0, >1.0.0, >=1.0.0, <1.0.0, <=1.0.0, ^1.0.0, ~1.0.0
+ */
+export function parseRange(range) {
+    const trimmed = range.trim();
+    // Match operator at start
+    const rangeRegex = /^([=><^~]+)?\s*(.+)$/;
+    const match = trimmed.match(rangeRegex);
+    if (!match || !match[2]) {
+        return null;
+    }
+    const operator = (match[1] ?? "=");
+    const versionStr = match[2];
+    // Validate operator
+    if (!["=", ">", ">=", "<", "<=", "^", "~"].includes(operator)) {
+        return null;
+    }
+    const version = parseVersion(versionStr);
+    if (!version) {
+        return null;
+    }
+    return {
+        operator,
+        version,
+        raw: trimmed,
+    };
+}
+/**
+ * Check if a version satisfies a range
+ */
+export function satisfiesRange(version, range) {
+    const parsedVersion = parseVersion(version);
+    const parsedRange = parseRange(range);
+    if (!parsedVersion || !parsedRange) {
+        return false;
+    }
+    const comparison = compareVersions(version, parsedRange.version.raw);
+    switch (parsedRange.operator) {
+        case "=":
+            return comparison === 0;
+        case ">":
+            return comparison === 1;
+        case ">=":
+            return comparison >= 0;
+        case "<":
+            return comparison === -1;
+        case "<=":
+            return comparison <= 0;
+        case "^":
+            // Caret range: compatible changes (same major, >= version)
+            // ^1.2.3 := >=1.2.3 <2.0.0
+            // ^0.2.3 := >=0.2.3 <0.3.0
+            // ^0.0.3 := >=0.0.3 <0.0.4
+            if (comparison === -1)
+                return false;
+            if (parsedRange.version.major === 0) {
+                if (parsedRange.version.minor === 0) {
+                    // ^0.0.x - must be exact patch
+                    return parsedVersion.patch === parsedRange.version.patch;
+                }
+                // ^0.x - must be same minor
+                return parsedVersion.minor === parsedRange.version.minor;
+            }
+            // ^x - must be same major
+            return parsedVersion.major === parsedRange.version.major;
+        case "~":
+            // Tilde range: patch-level changes (same major.minor, >= version)
+            // ~1.2.3 := >=1.2.3 <1.3.0
+            if (comparison === -1)
+                return false;
+            return (parsedVersion.major === parsedRange.version.major &&
+                parsedVersion.minor === parsedRange.version.minor);
+        default:
+            return false;
+    }
+}
+/**
+ * Sort versions in ascending order
+ */
+export function sortVersions(versions) {
+    return [...versions].sort(compareVersions);
+}
+/**
+ * Get the highest version from a list
+ */
+export function getHighestVersion(versions) {
+    const valid = versions.filter(isValidVersion);
+    if (valid.length === 0)
+        return null;
+    const sorted = sortVersions(valid);
+    const last = sorted[sorted.length - 1];
+    return last ?? null;
+}
+/**
+ * Increment a version by bump type
+ */
+export function incrementVersion(version, bump) {
+    const parsed = parseVersion(version);
+    if (!parsed)
+        return null;
+    switch (bump) {
+        case "major":
+            return `${parsed.major + 1}.0.0`;
+        case "minor":
+            return `${parsed.major}.${parsed.minor + 1}.0`;
+        case "patch":
+            return `${parsed.major}.${parsed.minor}.${parsed.patch + 1}`;
+    }
+}
+/**
+ * Coerce a string to a valid semver, filling in missing parts
+ */
+export function coerceVersion(version) {
+    const trimmed = version.trim();
+    const normalized = trimmed.startsWith("v") ? trimmed.slice(1) : trimmed;
+    // Try parsing as-is first
+    const parsed = parseVersion(normalized);
+    if (parsed) {
+        return `${parsed.major}.${parsed.minor}.${parsed.patch}`;
+    }
+    // Try extracting numbers
+    const numbers = normalized.match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+    if (!numbers) {
+        return null;
+    }
+    const major = Number.parseInt(numbers[1] ?? "0", 10);
+    const minor = Number.parseInt(numbers[2] ?? "0", 10);
+    const patch = Number.parseInt(numbers[3] ?? "0", 10);
+    return `${major}.${minor}.${patch}`;
+}
+/**
+ * Format a parsed version back to string
+ */
+export function formatVersion(version) {
+    let result = `${version.major}.${version.minor}.${version.patch}`;
+    if (version.prerelease) {
+        result += `-${version.prerelease}`;
+    }
+    if (version.build) {
+        result += `+${version.build}`;
+    }
+    return result;
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enactprotocol/shared",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Core business logic and utilities for Enact",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,7 +18,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@enactprotocol/trust": "2.0.0",
+    "@enactprotocol/trust": "2.0.2",
     "js-yaml": "^4.1.1",
     "zod": "^4.1.13"
   },

package/src/config.ts

@@ -4,7 +4,7 @@
  */
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
+import { dirname, join } from "node:path";
 import yaml from "js-yaml";
 import { getConfigPath, getEnactHome } from "./paths";
 
@@ -95,7 +95,7 @@ export const DEFAULT_CONFIG: EnactConfig = {
     verbose: false,
   },
   registry: {
-    url: "https://enact.tools",
+    url: "https://siikwkfgsmouioodghho.supabase.co/functions/v1",
   },
 };
 
@@ -257,6 +257,40 @@ export function configExists(): boolean {
   return existsSync(getConfigPath());
 }
 
+/**
+ * Ensure global setup is complete
+ * Creates ~/.enact/ directory structure and default config if they don't exist.
+ * This is a non-interactive initialization that runs silently.
+ * @returns true if setup was performed, false if already initialized
+ */
+export function ensureGlobalSetup(): boolean {
+  const enactHome = getEnactHome();
+  const configPath = getConfigPath();
+  const cacheDir = join(enactHome, "cache");
+
+  let performedSetup = false;
+
+  // Ensure ~/.enact/ directory exists
+  if (!existsSync(enactHome)) {
+    mkdirSync(enactHome, { recursive: true });
+    performedSetup = true;
+  }
+
+  // Ensure ~/.enact/cache/ directory exists
+  if (!existsSync(cacheDir)) {
+    mkdirSync(cacheDir, { recursive: true });
+    performedSetup = true;
+  }
+
+  // Create default config if it doesn't exist
+  if (!existsSync(configPath)) {
+    saveConfig({ ...DEFAULT_CONFIG });
+    performedSetup = true;
+  }
+
+  return performedSetup;
+}
+
 // =============================================================================
 // Local Trust Management
 // =============================================================================

package/src/index.ts

@@ -40,6 +40,7 @@ export {
   setConfigValue,
   resetConfig,
   configExists,
+  ensureGlobalSetup,
   DEFAULT_CONFIG,
   // Local trust management (new unified API)
   getTrustedIdentities,

package/tests/config.test.ts

@@ -11,6 +11,7 @@ import {
   addTrustedIdentity,
   configExists,
   emailToProviderIdentity,
+  ensureGlobalSetup,
   getConfigValue,
   getMinimumAttestations,
   getTrustPolicy,
@@ -25,6 +26,7 @@ import {
   saveConfig,
   setConfigValue,
 } from "../src/config";
+import { getCacheDir, getConfigPath, getEnactHome } from "../src/paths";
 
 // Use a test-specific home directory to avoid affecting real config
 const TEST_HOME = join(import.meta.dir, "fixtures", "config-test-home");
@@ -64,7 +66,9 @@ describe("configuration manager", () => {
       expect(DEFAULT_CONFIG.trust?.minimum_attestations).toBe(1);
       expect(DEFAULT_CONFIG.cache?.maxSizeMb).toBe(1024);
       expect(DEFAULT_CONFIG.execution?.defaultTimeout).toBe("30s");
-      expect(DEFAULT_CONFIG.registry?.url).toBe("https://enact.tools");
+      expect(DEFAULT_CONFIG.registry?.url).toBe(
+        "https://siikwkfgsmouioodghho.supabase.co/functions/v1"
+      );
     });
   });
 
@@ -512,4 +516,189 @@ describe("configuration manager", () => {
       });
     });
   });
+
+  describe("ensureGlobalSetup", () => {
+    test("creates ~/.enact/ directory if it doesn't exist", () => {
+      const enactHome = getEnactHome();
+
+      // Clean up first to ensure fresh state
+      if (existsSync(enactHome)) {
+        rmSync(enactHome, { recursive: true, force: true });
+      }
+
+      // Run setup
+      const result = ensureGlobalSetup();
+
+      // Should have performed setup
+      expect(result).toBe(true);
+      expect(existsSync(enactHome)).toBe(true);
+    });
+
+    test("creates ~/.enact/cache/ directory", () => {
+      const enactHome = getEnactHome();
+      const cacheDir = getCacheDir();
+
+      // Clean up first
+      if (existsSync(enactHome)) {
+        rmSync(enactHome, { recursive: true, force: true });
+      }
+
+      ensureGlobalSetup();
+
+      expect(existsSync(cacheDir)).toBe(true);
+    });
+
+    test("creates default config.yaml", () => {
+      const enactHome = getEnactHome();
+      const configPath = getConfigPath();
+
+      // Clean up first
+      if (existsSync(enactHome)) {
+        rmSync(enactHome, { recursive: true, force: true });
+      }
+
+      ensureGlobalSetup();
+
+      expect(existsSync(configPath)).toBe(true);
+
+      // Verify config content
+      const config = loadConfig();
+      expect(config.version).toBe(DEFAULT_CONFIG.version);
+      expect(config.trust?.policy).toBe(DEFAULT_CONFIG.trust?.policy);
+      expect(config.registry?.url).toBe(DEFAULT_CONFIG.registry?.url);
+    });
+
+    test("returns false if already initialized", () => {
+      // First call should perform setup
+      ensureGlobalSetup();
+
+      // Second call should return false (already set up)
+      const result = ensureGlobalSetup();
+      expect(result).toBe(false);
+    });
+
+    test("is idempotent - multiple calls don't break things", () => {
+      // Run setup multiple times
+      ensureGlobalSetup();
+      ensureGlobalSetup();
+      ensureGlobalSetup();
+
+      // Everything should still work
+      expect(configExists()).toBe(true);
+      const config = loadConfig();
+      expect(config.version).toBeDefined();
+    });
+
+    test("preserves existing config if present", () => {
+      const enactHome = getEnactHome();
+
+      // Clean up first
+      if (existsSync(enactHome)) {
+        rmSync(enactHome, { recursive: true, force: true });
+      }
+
+      // Create initial config
+      ensureGlobalSetup();
+
+      // Modify the config
+      saveConfig({
+        ...DEFAULT_CONFIG,
+        trust: { policy: "require_attestation", auditors: ["github:test-user"] },
+      });
+
+      // Run setup again
+      ensureGlobalSetup();
+
+      // Config should be preserved
+      const config = loadConfig();
+      expect(config.trust?.policy).toBe("require_attestation");
+      expect(config.trust?.auditors).toContain("github:test-user");
+    });
+
+    test("creates cache directory even if config exists", () => {
+      const enactHome = getEnactHome();
+      const cacheDir = getCacheDir();
+
+      // Clean up first
+      if (existsSync(enactHome)) {
+        rmSync(enactHome, { recursive: true, force: true });
+      }
+
+      // Create only the home and config
+      mkdirSync(enactHome, { recursive: true });
+      saveConfig({ ...DEFAULT_CONFIG });
+
+      // Manually remove cache dir if it exists
+      if (existsSync(cacheDir)) {
+        rmSync(cacheDir, { recursive: true, force: true });
+      }
+
+      // Run setup
+      const result = ensureGlobalSetup();
+
+      // Should have created cache dir
+      expect(result).toBe(true);
+      expect(existsSync(cacheDir)).toBe(true);
+    });
+
+    test("default config has correct registry URL", () => {
+      const enactHome = getEnactHome();
+
+      // Clean up first
+      if (existsSync(enactHome)) {
+        rmSync(enactHome, { recursive: true, force: true });
+      }
+
+      ensureGlobalSetup();
+
+      const config = loadConfig();
+      expect(config.registry?.url).toBe("https://siikwkfgsmouioodghho.supabase.co/functions/v1");
+    });
+
+    test("default config has correct trust settings", () => {
+      const enactHome = getEnactHome();
+
+      // Clean up first
+      if (existsSync(enactHome)) {
+        rmSync(enactHome, { recursive: true, force: true });
+      }
+
+      ensureGlobalSetup();
+
+      const config = loadConfig();
+      expect(config.trust?.policy).toBe("prompt");
+      expect(config.trust?.minimum_attestations).toBe(1);
+      expect(config.trust?.auditors).toEqual([]);
+    });
+
+    test("default config has correct cache settings", () => {
+      const enactHome = getEnactHome();
+
+      // Clean up first
+      if (existsSync(enactHome)) {
+        rmSync(enactHome, { recursive: true, force: true });
+      }
+
+      ensureGlobalSetup();
+
+      const config = loadConfig();
+      expect(config.cache?.maxSizeMb).toBe(1024);
+      expect(config.cache?.ttlSeconds).toBe(86400 * 7); // 7 days
+    });
+
+    test("default config has correct execution settings", () => {
+      const enactHome = getEnactHome();
+
+      // Clean up first
+      if (existsSync(enactHome)) {
+        rmSync(enactHome, { recursive: true, force: true });
+      }
+
+      ensureGlobalSetup();
+
+      const config = loadConfig();
+      expect(config.execution?.defaultTimeout).toBe("30s");
+      expect(config.execution?.verbose).toBe(false);
+    });
+  });
 });