@rs-native-kit/version-check 0.1.2

package/lib/module/data/repositories/VersionRepositoryImpl.js

@@ -0,0 +1,69 @@
+"use strict";
+
+import { toVersionManagerException, UnsupportedStoreException } from "../../domain/errors/VersionManagerException.js";
+const REMOTE_INFO_CACHE_KEY = 'remote-version-info';
+const USER_DECISION_STORAGE_KEY = 'vm_user_decision';
+
+/**
+ * Sequential fallback across registered providers (Prompt 14's simpler tier): the first
+ * provider to succeed wins. Only providers the host app actually registers via DI
+ * reach this list — nothing here imports a provider it doesn't need (Prompt 1 §8).
+ */
+export class VersionRepositoryImpl {
+  constructor(providers, cache, storage, clock) {
+    this.providers = providers;
+    this.cache = cache;
+    this.storage = storage;
+    this.clock = clock;
+  }
+  async getRemoteVersionInfo(request) {
+    if (!request.bypassCache) {
+      const cached = await this.cache.get(REMOTE_INFO_CACHE_KEY);
+      if (cached) return cached;
+    }
+    if (this.providers.length === 0) {
+      throw new UnsupportedStoreException({
+        message: 'No store providers are registered — configure() must include at least one of stores.ios/.android/.custom/etc'
+      });
+    }
+    let lastError = null;
+    for (const provider of this.providers) {
+      try {
+        const result = await provider.fetchLatestVersionInfo({
+          bundleId: request.bundleId,
+          region: null,
+          timeoutMs: request.timeoutMs
+        });
+        const info = {
+          latestVersion: result.latestVersion,
+          storeUrl: result.storeUrl,
+          releaseNotes: result.releaseNotes,
+          minimumOsVersion: result.minimumOsVersion,
+          fetchedAt: this.clock.now(),
+          provider: provider.id
+        };
+        await this.cache.set(REMOTE_INFO_CACHE_KEY, info);
+        return info;
+      } catch (error) {
+        lastError = error;
+      }
+    }
+    throw toVersionManagerException(lastError);
+  }
+  async getCachedVersionInfo() {
+    return this.cache.get(REMOTE_INFO_CACHE_KEY);
+  }
+  async persistUserDecision(decision) {
+    await this.storage.set(USER_DECISION_STORAGE_KEY, JSON.stringify(decision));
+  }
+  async getUserDecision() {
+    const raw = await this.storage.get(USER_DECISION_STORAGE_KEY);
+    if (!raw) return null;
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return null;
+    }
+  }
+}
+//# sourceMappingURL=VersionRepositoryImpl.js.map

package/lib/module/data/repositories/VersionRepositoryImpl.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["toVersionManagerException","UnsupportedStoreException","REMOTE_INFO_CACHE_KEY","USER_DECISION_STORAGE_KEY","VersionRepositoryImpl","constructor","providers","cache","storage","clock","getRemoteVersionInfo","request","bypassCache","cached","get","length","message","lastError","provider","result","fetchLatestVersionInfo","bundleId","region","timeoutMs","info","latestVersion","storeUrl","releaseNotes","minimumOsVersion","fetchedAt","now","id","set","error","getCachedVersionInfo","persistUserDecision","decision","JSON","stringify","getUserDecision","raw","parse"],"sourceRoot":"../../../../src","sources":["data/repositories/VersionRepositoryImpl.ts"],"mappings":";;AAAA,SACEA,yBAAyB,EACzBC,yBAAyB,QACpB,gDAA6C;AAYpD,MAAMC,qBAAqB,GAAG,qBAAqB;AACnD,MAAMC,yBAAyB,GAAG,kBAAkB;;AAEpD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,qBAAqB,CAA+B;EAC/DC,WAAWA,CACQC,SAAoC,EACpCC,KAAqC,EACrCC,OAAyB,EACzBC,KAAa,EAC9B;IAAA,KAJiBH,SAAoC,GAApCA,SAAoC;IAAA,KACpCC,KAAqC,GAArCA,KAAqC;IAAA,KACrCC,OAAyB,GAAzBA,OAAyB;IAAA,KACzBC,KAAa,GAAbA,KAAa;EAC7B;EAEH,MAAMC,oBAAoBA,CACxBC,OAA4B,EACA;IAC5B,IAAI,CAACA,OAAO,CAACC,WAAW,EAAE;MACxB,MAAMC,MAAM,GAAG,MAAM,IAAI,CAACN,KAAK,CAACO,GAAG,CAACZ,qBAAqB,CAAC;MAC1D,IAAIW,MAAM,EAAE,OAAOA,MAAM;IAC3B;IAEA,IAAI,IAAI,CAACP,SAAS,CAACS,MAAM,KAAK,CAAC,EAAE;MAC/B,MAAM,IAAId,yBAAyB,CAAC;QAClCe,OAAO,EACL;MACJ,CAAC,CAAC;IACJ;IAEA,IAAIC,SAAkB,GAAG,IAAI;IAC7B,KAAK,MAAMC,QAAQ,IAAI,IAAI,CAACZ,SAAS,EAAE;MACrC,IAAI;QACF,MAAMa,MAAM,GAAG,MAAMD,QAAQ,CAACE,sBAAsB,CAAC;UACnDC,QAAQ,EAAEV,OAAO,CAACU,QAAQ;UAC1BC,MAAM,EAAE,IAAI;UACZC,SAAS,EAAEZ,OAAO,CAACY;QACrB,CAAC,CAAC;QACF,MAAMC,IAAuB,GAAG;UAC9BC,aAAa,EAAEN,MAAM,CAACM,aAAa;UACnCC,QAAQ,EAAEP,MAAM,CAACO,QAAQ;UACzBC,YAAY,EAAER,MAAM,CAACQ,YAAY;UACjCC,gBAAgB,EAAET,MAAM,CAACS,gBAAgB;UACzCC,SAAS,EAAE,IAAI,CAACpB,KAAK,CAACqB,GAAG,CAAC,CAAC;UAC3BZ,QAAQ,EAAEA,QAAQ,CAACa;QACrB,CAAC;QACD,MAAM,IAAI,CAACxB,KAAK,CAACyB,GAAG,CAAC9B,qBAAqB,EAAEsB,IAAI,CAAC;QACjD,OAAOA,IAAI;MACb,CAAC,CAAC,OAAOS,KAAK,EAAE;QACdhB,SAAS,GAAGgB,KAAK;MACnB;IACF;IAEA,MAAMjC,yBAAyB,CAACiB,SAAS,CAAC;EAC5C;EAEA,MAAMiB,oBAAoBA,CAAA,EAAsC;IAC9D,OAAO,IAAI,CAAC3B,KAAK,CAACO,GAAG,CAACZ,qBAAqB,CAAC;EAC9C;EAEA,MAAMiC,mBAAmBA,CAACC,QAA6B,EAAiB;IACtE,MAAM,IAAI,CAAC5B,OAAO,CAACwB,GAAG,CAAC7B,yBAAyB,EAAEkC,IAAI,CAACC,SAAS,CAACF,QAAQ,CAAC,CAAC;EAC7E;EAEA,MAAMG,eAAeA,CAAA,EAAwC;IAC3D,MAAMC,GAAG,GAAG,MAAM,IAAI,CAAChC,OAAO,CAACM,GAAG,CAACX,yBAAyB,CAAC;IAC7D,IAAI,CAACqC,GAAG,EAAE,OAAO,IAAI;IACrB,IAAI;MACF,OAAOH,IAAI,CAACI,KAAK,CAACD,GAAG,CAAC;IACxB,CAAC,CAAC,MAAM;MACN,OAAO,IAAI;IACb;EACF;AACF","ignoreList":[]}

package/lib/module/di/container.js

@@ -0,0 +1,80 @@
+"use strict";
+
+import { PersistentCacheStore } from "../data/cache/PersistentCacheStore.js";
+import { MemoryCacheStore } from "../data/cache/MemoryCacheStore.js";
+import { ConfigCache } from "../data/config/ConfigCache.js";
+import { ConfigDocumentValidator } from "../data/config/ConfigDocumentValidator.js";
+import { resolveConfigSync } from "../data/config/ConfigLoader.js";
+import { ConfigProvider } from "../data/config/ConfigProvider.js";
+import { SignatureVerifier } from "../data/config/SignatureVerifier.js";
+import { EnvironmentOverrideSource } from "../data/config/sources/EnvironmentOverrideSource.js";
+import { LocalConfigSource } from "../data/config/sources/LocalConfigSource.js";
+import { RemoteConfigSource } from "../data/config/sources/RemoteConfigSource.js";
+import { AppleStoreProvider } from "../data/providers/apple/AppleStoreProvider.js";
+import { CustomApiProvider } from "../data/providers/custom-api/CustomApiProvider.js";
+import { GooglePlayProvider } from "../data/providers/google-play/GooglePlayProvider.js";
+import { VersionRepositoryImpl } from "../data/repositories/VersionRepositoryImpl.js";
+import { DecisionEngine } from "../domain/engines/decision/DecisionEngine.js";
+import { PolicyEngine } from "../domain/engines/policy/PolicyEngine.js";
+import { SemVerEngine } from "../domain/engines/semver/SemVerEngine.js";
+import { VersionManagerCore } from "../domain/VersionManagerCore.js";
+import { createPlatformBridge } from '../platform/createPlatformBridge';
+import { EventBus } from "../shared/eventbus/EventBus.js";
+
+/**
+ * Composition root (Prompt 1 §1.3) — the only file in the codebase that imports both a
+ * port and its concrete adapter simultaneously. Only Apple/Google Play/Custom API
+ * providers are wired here; Huawei/Amazon/Firebase Remote Config providers exist as
+ * independently importable files (Prompt 1 §8) but are intentionally not referenced
+ * from this file yet since their implementations are still stubs (see those files'
+ * doc comments) — wiring them here would defeat tree-shaking for no behavioral benefit.
+ */
+export function createVersionManagerCore(options) {
+  // Synchronous — throws InvalidConfigException immediately for a bad options bag
+  // (Prompt 2 §1.3's fail-fast requirement), before any adapter is constructed.
+  const config = resolveConfigSync(options);
+  const platformBridge = options.platformBridge ?? createPlatformBridge();
+  const clock = platformBridge.clock;
+  const comparator = new SemVerEngine();
+  const policyEngine = new PolicyEngine(comparator);
+  const decisionEngine = new DecisionEngine(clock);
+  const eventBus = new EventBus();
+  const providers = buildProviders(config, platformBridge);
+  const remoteInfoCache = config.cache.storage === 'memory' ? new MemoryCacheStore(clock, config.cache.ttlMs) : new PersistentCacheStore(platformBridge.storage, clock, config.cache.ttlMs);
+  const repository = new VersionRepositoryImpl(providers, remoteInfoCache, platformBridge.storage, clock);
+  const configProvider = new ConfigProvider({
+    local: new LocalConfigSource(options.configSources?.local),
+    remote: new RemoteConfigSource(platformBridge.http),
+    envOverrides: new EnvironmentOverrideSource(options.configSources?.envOverrides),
+    cache: new ConfigCache(platformBridge.storage),
+    validator: new ConfigDocumentValidator(),
+    signatureVerifier: new SignatureVerifier(platformBridge.crypto),
+    clock
+  });
+  return new VersionManagerCore({
+    config,
+    rawOptions: options,
+    platformBridge,
+    repository,
+    comparator,
+    policyEngine,
+    decisionEngine,
+    eventBus,
+    clock,
+    configProvider
+  });
+}
+function buildProviders(config, bridge) {
+  const providers = [];
+  if (bridge.platform === 'ios' && config.stores.ios) {
+    providers.push(new AppleStoreProvider(bridge.http, config.stores.ios.appStoreId, config.stores.ios.region));
+  }
+  if (bridge.platform === 'android' && config.stores.android) {
+    providers.push(new GooglePlayProvider(bridge.http, config.stores.android.packageName));
+  }
+  if (config.stores.custom) {
+    providers.push(new CustomApiProvider(bridge.http, config.stores.custom.url, config.stores.custom.headers));
+  }
+  return providers;
+}
+//# sourceMappingURL=container.js.map

package/lib/module/di/container.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PersistentCacheStore","MemoryCacheStore","ConfigCache","ConfigDocumentValidator","resolveConfigSync","ConfigProvider","SignatureVerifier","EnvironmentOverrideSource","LocalConfigSource","RemoteConfigSource","AppleStoreProvider","CustomApiProvider","GooglePlayProvider","VersionRepositoryImpl","DecisionEngine","PolicyEngine","SemVerEngine","VersionManagerCore","createPlatformBridge","EventBus","createVersionManagerCore","options","config","platformBridge","clock","comparator","policyEngine","decisionEngine","eventBus","providers","buildProviders","remoteInfoCache","cache","storage","ttlMs","repository","configProvider","local","configSources","remote","http","envOverrides","validator","signatureVerifier","crypto","rawOptions","bridge","platform","stores","ios","push","appStoreId","region","android","packageName","custom","url","headers"],"sourceRoot":"../../../src","sources":["di/container.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/domain/IVersionManagerCore.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=IVersionManagerCore.js.map

package/lib/module/domain/IVersionManagerCore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["domain/IVersionManagerCore.ts"],"mappings":"","ignoreList":[]}

package/lib/module/domain/VersionManagerCore.js

@@ -0,0 +1,276 @@
+"use strict";
+
+import { CheckForUpdatesUseCase } from "./usecases/CheckForUpdatesUseCase.js";
+import { ForceTriggerUpdateUseCase } from "./usecases/ForceTriggerUpdateUseCase.js";
+import { ResetIgnoredVersionsUseCase } from "./usecases/ResetIgnoredVersionsUseCase.js";
+import { ActionType } from "./models/ActionPlan.js";
+import { LifecycleState } from "./models/LifecycleState.js";
+import { NotReadyException, isConfigTierException, toVersionManagerException } from "./errors/VersionManagerException.js";
+import { InvalidTransitionError, LifecycleStateMachine } from "./statemachine/LifecycleStateMachine.js";
+/**
+ * The concrete IVersionManagerCore. Composed entirely from ports and other domain
+ * constructs (Prompt 1 §1.3) — every concrete adapter (repository impl, platform
+ * bridge impl) is injected by src/di/container.ts, never imported here directly.
+ */
+export class VersionManagerCore {
+  /**
+   * Mutable, doc 03 §4.4 "hot-update" target — starts at the tier-4-only sync
+   * resolution and is replaced (not merged in place — a fresh immutable object each
+   * time) once configProvider's full pipeline resolves, and again on every subsequent
+   * subscribe() notification. In-flight operations keep whatever reference they already
+   * captured; only the *next* operation observes an update, matching §4.4's guarantee.
+   */
+
+  lastActionPlan = null;
+  lastCheckedAt = null;
+  inFlightCheck = null;
+  /**
+   * Non-persisted rollout bucket (0-99), stable for the process lifetime only.
+   * A device-stable bucket derived from a persisted installation id is Prompt 18
+   * scope — this is a documented simplification, not the final design.
+   */
+  rolloutBucket = null;
+  constructor(deps) {
+    this.deps = deps;
+    this.currentConfig = deps.config;
+    this.stateMachine = deps.stateMachine ?? new LifecycleStateMachine();
+    this.checkUseCase = new CheckForUpdatesUseCase({
+      repository: deps.repository,
+      comparator: deps.comparator,
+      policyEngine: deps.policyEngine,
+      decisionEngine: deps.decisionEngine,
+      clock: deps.clock
+    });
+    this.resetUseCase = new ResetIgnoredVersionsUseCase(deps.repository);
+    this.forceUseCase = new ForceTriggerUpdateUseCase(deps.repository, deps.decisionEngine);
+    this.readyPromise = this.initialize();
+  }
+  async initialize() {
+    this.tryTransition(LifecycleState.CONFIG_LOADING);
+
+    // Doc 03 §4 full precedence resolution (env > remote > local > default) — runs
+    // during CONFIG_LOADING per doc 02 §7's sequence diagram. A failure here never
+    // fails initialization (doc 02 §7's "Initialization only ever hard-fails on VM-1xxx
+    // config codes, which reject before an instance is ever returned" — this is
+    // *post*-construction, so it degrades to the already-valid tier-4 config instead).
+    if (this.deps.configProvider) {
+      try {
+        this.currentConfig = await this.deps.configProvider.resolve(this.deps.rawOptions);
+      } catch (error) {
+        this.publishError(toVersionManagerException(error), 'config');
+      }
+      this.deps.configProvider.subscribe(config => {
+        // §4.4 hot-update: only the *next* operation observes this — in-flight work
+        // already captured the previous currentConfig reference by value.
+        this.currentConfig = config;
+      });
+    }
+    try {
+      // Warm start: prime/validate the cache read path. The first checkForUpdates()
+      // call is what actually turns cached data into a decision (it needs the
+      // current app version, resolved asynchronously from the platform bridge).
+      await this.deps.repository.getCachedVersionInfo();
+    } catch (error) {
+      this.publishError(toVersionManagerException(error), 'config');
+    }
+    this.tryTransition(LifecycleState.IDLE);
+  }
+  ready() {
+    return this.readyPromise;
+  }
+  async checkForUpdates(options = {}) {
+    if (this.currentConfig.strictReadiness && this.stateMachine.current === LifecycleState.CONFIG_LOADING) {
+      throw new NotReadyException({
+        message: 'checkForUpdates() called before ready() resolved'
+      });
+    }
+    await this.readyPromise;
+    if (this.inFlightCheck) {
+      return this.inFlightCheck;
+    }
+    const promise = this.runCheck(options).finally(() => {
+      this.inFlightCheck = null;
+    });
+    this.inFlightCheck = promise;
+    return promise;
+  }
+  async runCheck(options) {
+    this.tryTransition(LifecycleState.VERSION_CHECKING);
+    const [currentVersion, bundleId] = await Promise.all([this.resolveCurrentVersion(), this.deps.platformBridge.appInfo.getBundleId()]);
+    try {
+      const plan = await this.checkUseCase.execute({
+        currentVersion,
+        bundleId,
+        platform: this.deps.platformBridge.platform,
+        bypassCache: options.bypassCache ?? this.currentConfig.cache.bustOnManualCheck,
+        timeoutMs: options.timeoutMs ?? this.currentConfig.fallback.requestTimeoutMs,
+        forceUpdateBelow: this.currentConfig.policy.forceUpdateBelow,
+        rolloutPercentage: this.currentConfig.policy.rolloutPercentage,
+        rolloutBucket: this.getRolloutBucket()
+      });
+      this.applyPlan(plan, currentVersion);
+      return plan;
+    } catch (error) {
+      const vmError = toVersionManagerException(error);
+      if (isConfigTierException(vmError)) {
+        this.tryTransition(LifecycleState.IDLE);
+        throw vmError;
+      }
+      return this.runFallback(vmError, currentVersion);
+    }
+  }
+  async runFallback(error, currentVersion) {
+    this.publishError(error, 'check');
+    let remote = null;
+    const strategy = this.currentConfig.fallback.onNetworkError;
+    if (strategy === 'useCache') {
+      remote = await this.deps.repository.getCachedVersionInfo().catch(() => null);
+    } else if (strategy === 'useDefaultConfig') {
+      remote = this.currentConfig.fallback.defaultConfig;
+    }
+    const plan = remote ? this.deps.decisionEngine.buildActionPlan(ActionType.NO_ACTION, currentVersion, remote) : {
+      type: ActionType.NO_ACTION,
+      updateInfo: null,
+      reason: 'fallback',
+      decidedAt: this.deps.clock.now()
+    };
+    this.applyPlan(plan, currentVersion);
+    return plan;
+  }
+  applyPlan(plan, currentVersion) {
+    this.lastActionPlan = plan;
+    this.lastCheckedAt = this.deps.clock.now();
+    this.tryTransition(LifecycleState.DECIDING);
+    const targetState = this.stateForActionType(plan.type);
+    this.tryTransition(targetState);
+    if (plan.updateInfo) {
+      const event = {
+        updateInfo: plan.updateInfo,
+        actionPlan: plan,
+        timestamp: this.deps.clock.now()
+      };
+      this.deps.eventBus.publish('updateDetected', event);
+    } else {
+      this.deps.eventBus.publish('updateNotAvailable', {
+        currentVersion,
+        checkedAt: this.deps.clock.now()
+      });
+    }
+  }
+  stateForActionType(type) {
+    switch (type) {
+      case ActionType.FORCE_UPDATE:
+        return LifecycleState.FORCE_UPDATE_DISPLAYED;
+      case ActionType.SOFT_UPDATE:
+      case ActionType.OPTIONAL_REMINDER:
+        return LifecycleState.SOFT_UPDATE_DISPLAYED;
+      default:
+        return LifecycleState.IDLE;
+    }
+  }
+  async forceTriggerUpdate(_options = {}) {
+    await this.readyPromise;
+    const [currentVersion, bundleId] = await Promise.all([this.resolveCurrentVersion(), this.deps.platformBridge.appInfo.getBundleId()]);
+    try {
+      const plan = await this.forceUseCase.execute({
+        currentVersion,
+        bundleId,
+        platform: this.deps.platformBridge.platform,
+        timeoutMs: this.currentConfig.fallback.requestTimeoutMs
+      });
+      this.applyPlan(plan, currentVersion);
+    } catch (error) {
+      this.publishError(toVersionManagerException(error), 'check');
+    }
+  }
+  async resetIgnoredVersions(options = {}) {
+    await this.resetUseCase.execute(options.versions);
+  }
+  getCurrentState() {
+    return this.stateMachine.current;
+  }
+  getUpdateInfo() {
+    return this.lastActionPlan?.updateInfo ?? null;
+  }
+  isUpdateAvailable() {
+    return this.lastActionPlan !== null && this.lastActionPlan.type !== ActionType.NO_ACTION;
+  }
+  getActionPlan() {
+    return this.lastActionPlan;
+  }
+  getLastCheckedAt() {
+    return this.lastCheckedAt;
+  }
+  on(event, handler) {
+    return this.deps.eventBus.subscribe(event, handler);
+  }
+  once(event, handler) {
+    const unsubscribe = this.deps.eventBus.subscribe(event, payload => {
+      unsubscribe();
+      handler(payload);
+    });
+    return unsubscribe;
+  }
+  off(event, handler) {
+    // Removes a handler registered via on(event, handler) by reference, in addition to
+    // (not instead of) the Unsubscribe closure returned from on()/once() — both styles
+    // are safe to mix (Prompt 2 §4.2). Handlers wrapped internally by once() are not
+    // reachable here since once() never hands the wrapped function back to the caller;
+    // its own Unsubscribe closure is the only way to remove a once() handler early.
+    this.deps.eventBus.off(event, handler);
+  }
+  onUpdateDetected(handler) {
+    return this.on('updateDetected', handler);
+  }
+  onUserAction(handler) {
+    return this.on('userAction', handler);
+  }
+  onError(handler) {
+    return this.on('error', handler);
+  }
+  onStateChanged(handler) {
+    return this.on('stateChanged', handler);
+  }
+  dispose() {
+    this.tryTransition(LifecycleState.TERMINATED);
+  }
+  async resolveCurrentVersion() {
+    return this.currentConfig.appVersion ?? this.deps.platformBridge.appInfo.getCurrentVersion();
+  }
+  getRolloutBucket() {
+    if (this.rolloutBucket === null) {
+      this.rolloutBucket = Math.floor(Math.random() * 100);
+    }
+    return this.rolloutBucket;
+  }
+  publishError(error, phase) {
+    this.deps.eventBus.publish('error', {
+      error,
+      phase,
+      timestamp: this.deps.clock.now()
+    });
+  }
+  tryTransition(to) {
+    const from = this.stateMachine.current;
+    if (from === to) return;
+    try {
+      this.stateMachine.transition(to);
+    } catch (error) {
+      if (error instanceof InvalidTransitionError) {
+        // Some manual-trigger call paths (e.g. checkForUpdates() while a dialog from a
+        // previous check is still displayed) do not have a modeled edge in the Prompt 9
+        // transition table yet. Rather than throw out of a public API method for an
+        // internal invariant, this is logged and the state machine is left untouched.
+        return;
+      }
+      throw error;
+    }
+    const event = {
+      from,
+      to,
+      timestamp: this.deps.clock.now()
+    };
+    this.deps.eventBus.publish('stateChanged', event);
+  }
+}
+//# sourceMappingURL=VersionManagerCore.js.map

package/lib/module/domain/VersionManagerCore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CheckForUpdatesUseCase","ForceTriggerUpdateUseCase","ResetIgnoredVersionsUseCase","ActionType","LifecycleState","NotReadyException","isConfigTierException","toVersionManagerException","InvalidTransitionError","LifecycleStateMachine","VersionManagerCore","lastActionPlan","lastCheckedAt","inFlightCheck","rolloutBucket","constructor","deps","currentConfig","config","stateMachine","checkUseCase","repository","comparator","policyEngine","decisionEngine","clock","resetUseCase","forceUseCase","readyPromise","initialize","tryTransition","CONFIG_LOADING","configProvider","resolve","rawOptions","error","publishError","subscribe","getCachedVersionInfo","IDLE","ready","checkForUpdates","options","strictReadiness","current","message","promise","runCheck","finally","VERSION_CHECKING","currentVersion","bundleId","Promise","all","resolveCurrentVersion","platformBridge","appInfo","getBundleId","plan","execute","platform","bypassCache","cache","bustOnManualCheck","timeoutMs","fallback","requestTimeoutMs","forceUpdateBelow","policy","rolloutPercentage","getRolloutBucket","applyPlan","vmError","runFallback","remote","strategy","onNetworkError","catch","defaultConfig","buildActionPlan","NO_ACTION","type","updateInfo","reason","decidedAt","now","DECIDING","targetState","stateForActionType","event","actionPlan","timestamp","eventBus","publish","checkedAt","FORCE_UPDATE","FORCE_UPDATE_DISPLAYED","SOFT_UPDATE","OPTIONAL_REMINDER","SOFT_UPDATE_DISPLAYED","forceTriggerUpdate","_options","resetIgnoredVersions","versions","getCurrentState","getUpdateInfo","isUpdateAvailable","getActionPlan","getLastCheckedAt","on","handler","once","unsubscribe","payload","off","onUpdateDetected","onUserAction","onError","onStateChanged","dispose","TERMINATED","appVersion","getCurrentVersion","Math","floor","random","phase","to","from","transition"],"sourceRoot":"../../../src","sources":["domain/VersionManagerCore.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/domain/engines/decision/DecisionEngine.js

@@ -0,0 +1,40 @@
+"use strict";
+
+import { ActionType } from "../../models/ActionPlan.js";
+/**
+ * Assembles the final ActionPlan (with a fully-populated UpdateInfo, when relevant)
+ * from a PolicyEngine classification. Kept separate from PolicyEngine per the Prompt 7
+ * Decision Engine split in docs/architecture/01 §5.3 — this is the orchestration step,
+ * not the rule evaluation step.
+ */
+export class DecisionEngine {
+  constructor(clock) {
+    this.clock = clock;
+  }
+  buildActionPlan(actionType, currentVersion, remote) {
+    if (actionType === ActionType.NO_ACTION || remote === null) {
+      return {
+        type: ActionType.NO_ACTION,
+        updateInfo: null,
+        reason: 'up_to_date_or_suppressed',
+        decidedAt: this.clock.now()
+      };
+    }
+    const updateInfo = {
+      currentVersion,
+      latestVersion: remote.latestVersion,
+      storeUrl: remote.storeUrl,
+      releaseNotes: remote.releaseNotes,
+      isForceUpdate: actionType === ActionType.FORCE_UPDATE,
+      provider: remote.provider,
+      fetchedAt: remote.fetchedAt
+    };
+    return {
+      type: actionType,
+      updateInfo,
+      reason: actionType.toLowerCase(),
+      decidedAt: this.clock.now()
+    };
+  }
+}
+//# sourceMappingURL=DecisionEngine.js.map

package/lib/module/domain/engines/decision/DecisionEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ActionType","DecisionEngine","constructor","clock","buildActionPlan","actionType","currentVersion","remote","NO_ACTION","type","updateInfo","reason","decidedAt","now","latestVersion","storeUrl","releaseNotes","isForceUpdate","FORCE_UPDATE","provider","fetchedAt","toLowerCase"],"sourceRoot":"../../../../../src","sources":["domain/engines/decision/DecisionEngine.ts"],"mappings":";;AACA,SAASA,UAAU,QAAQ,4BAAyB;AAKpD;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,cAAc,CAAC;EAC1BC,WAAWA,CAAkBC,KAAa,EAAE;IAAA,KAAfA,KAAa,GAAbA,KAAa;EAAG;EAE7CC,eAAeA,CACbC,UAAsB,EACtBC,cAAsB,EACtBC,MAAgC,EACpB;IACZ,IAAIF,UAAU,KAAKL,UAAU,CAACQ,SAAS,IAAID,MAAM,KAAK,IAAI,EAAE;MAC1D,OAAO;QACLE,IAAI,EAAET,UAAU,CAACQ,SAAS;QAC1BE,UAAU,EAAE,IAAI;QAChBC,MAAM,EAAE,0BAA0B;QAClCC,SAAS,EAAE,IAAI,CAACT,KAAK,CAACU,GAAG,CAAC;MAC5B,CAAC;IACH;IAEA,MAAMH,UAAsB,GAAG;MAC7BJ,cAAc;MACdQ,aAAa,EAAEP,MAAM,CAACO,aAAa;MACnCC,QAAQ,EAAER,MAAM,CAACQ,QAAQ;MACzBC,YAAY,EAAET,MAAM,CAACS,YAAY;MACjCC,aAAa,EAAEZ,UAAU,KAAKL,UAAU,CAACkB,YAAY;MACrDC,QAAQ,EAAEZ,MAAM,CAACY,QAAQ;MACzBC,SAAS,EAAEb,MAAM,CAACa;IACpB,CAAC;IAED,OAAO;MACLX,IAAI,EAAEJ,UAAU;MAChBK,UAAU;MACVC,MAAM,EAAEN,UAAU,CAACgB,WAAW,CAAC,CAAC;MAChCT,SAAS,EAAE,IAAI,CAACT,KAAK,CAACU,GAAG,CAAC;IAC5B,CAAC;EACH;AACF","ignoreList":[]}

package/lib/module/domain/engines/policy/IUpdatePolicyEngine.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=IUpdatePolicyEngine.js.map

package/lib/module/domain/engines/policy/IUpdatePolicyEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["domain/engines/policy/IUpdatePolicyEngine.ts"],"mappings":"","ignoreList":[]}

package/lib/module/domain/engines/policy/PolicyEngine.js

@@ -0,0 +1,42 @@
+"use strict";
+
+import { ActionType } from "../../models/ActionPlan.js";
+/**
+ * Minimal rule evaluator: threshold-based force-update classification, ignore-list and
+ * remind-later suppression, and rollout-percentage gating. This intentionally covers a
+ * subset of the full Rule DSL described for Prompt 6 (conflict resolution across
+ * security/force/grace-period/optional tiers) — that richer precedence table is future
+ * scope; this engine implements the linear precedence documented inline below.
+ */
+export class PolicyEngine {
+  constructor(comparator) {
+    this.comparator = comparator;
+  }
+  evaluate(context) {
+    const cmp = this.comparator.compare(context.currentVersion, context.remoteVersion);
+    if (cmp >= 0) {
+      return ActionType.NO_ACTION;
+    }
+    if (context.userDecision?.ignoredVersions.includes(context.remoteVersion.raw)) {
+      return ActionType.NO_ACTION;
+    }
+    const remindMeLaterUntil = context.userDecision?.remindMeLaterUntil ?? null;
+    if (remindMeLaterUntil !== null && context.now < remindMeLaterUntil) {
+      return ActionType.NO_ACTION;
+    }
+    if (context.forceUpdateBelow && this.comparator.compare(context.currentVersion, context.forceUpdateBelow) < 0) {
+      return ActionType.FORCE_UPDATE;
+    }
+    if (context.rolloutBucket >= context.rolloutPercentage) {
+      return ActionType.NO_ACTION;
+    }
+
+    // A previously-expired "remind me later" snooze downgrades to a less intrusive
+    // banner on the next detection rather than repeating the modal dialog.
+    if (remindMeLaterUntil !== null) {
+      return ActionType.OPTIONAL_REMINDER;
+    }
+    return ActionType.SOFT_UPDATE;
+  }
+}
+//# sourceMappingURL=PolicyEngine.js.map

package/lib/module/domain/engines/policy/PolicyEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ActionType","PolicyEngine","constructor","comparator","evaluate","context","cmp","compare","currentVersion","remoteVersion","NO_ACTION","userDecision","ignoredVersions","includes","raw","remindMeLaterUntil","now","forceUpdateBelow","FORCE_UPDATE","rolloutBucket","rolloutPercentage","OPTIONAL_REMINDER","SOFT_UPDATE"],"sourceRoot":"../../../../../src","sources":["domain/engines/policy/PolicyEngine.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,4BAAyB;AAOpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,YAAY,CAAgC;EACvDC,WAAWA,CAAkBC,UAA8B,EAAE;IAAA,KAAhCA,UAA8B,GAA9BA,UAA8B;EAAG;EAE9DC,QAAQA,CAACC,OAAgC,EAAc;IACrD,MAAMC,GAAG,GAAG,IAAI,CAACH,UAAU,CAACI,OAAO,CACjCF,OAAO,CAACG,cAAc,EACtBH,OAAO,CAACI,aACV,CAAC;IACD,IAAIH,GAAG,IAAI,CAAC,EAAE;MACZ,OAAON,UAAU,CAACU,SAAS;IAC7B;IAEA,IACEL,OAAO,CAACM,YAAY,EAAEC,eAAe,CAACC,QAAQ,CAACR,OAAO,CAACI,aAAa,CAACK,GAAG,CAAC,EACzE;MACA,OAAOd,UAAU,CAACU,SAAS;IAC7B;IAEA,MAAMK,kBAAkB,GAAGV,OAAO,CAACM,YAAY,EAAEI,kBAAkB,IAAI,IAAI;IAC3E,IAAIA,kBAAkB,KAAK,IAAI,IAAIV,OAAO,CAACW,GAAG,GAAGD,kBAAkB,EAAE;MACnE,OAAOf,UAAU,CAACU,SAAS;IAC7B;IAEA,IACEL,OAAO,CAACY,gBAAgB,IACxB,IAAI,CAACd,UAAU,CAACI,OAAO,CACrBF,OAAO,CAACG,cAAc,EACtBH,OAAO,CAACY,gBACV,CAAC,GAAG,CAAC,EACL;MACA,OAAOjB,UAAU,CAACkB,YAAY;IAChC;IAEA,IAAIb,OAAO,CAACc,aAAa,IAAId,OAAO,CAACe,iBAAiB,EAAE;MACtD,OAAOpB,UAAU,CAACU,SAAS;IAC7B;;IAEA;IACA;IACA,IAAIK,kBAAkB,KAAK,IAAI,EAAE;MAC/B,OAAOf,UAAU,CAACqB,iBAAiB;IACrC;IAEA,OAAOrB,UAAU,CAACsB,WAAW;EAC/B;AACF","ignoreList":[]}

package/lib/module/domain/engines/semver/IVersionComparator.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=IVersionComparator.js.map

package/lib/module/domain/engines/semver/IVersionComparator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["domain/engines/semver/IVersionComparator.ts"],"mappings":"","ignoreList":[]}