@rs-native-kit/version-check 0.1.2

package/lib/typescript/src/presentation/state/VersionManagerStore.d.ts

@@ -0,0 +1,28 @@
+import type { ActionPlan } from '../../domain/models/ActionPlan';
+import type { LifecycleState } from '../../domain/models/LifecycleState';
+import type { UpdateInfo } from '../../domain/models/UpdateInfo';
+import type { Unsubscribe } from '../../domain/models/Unsubscribe';
+import type { IVersionManagerCore } from '../../domain/IVersionManagerCore';
+export interface VersionManagerUiState {
+    readonly lifecycleState: LifecycleState;
+    readonly updateInfo: UpdateInfo | null;
+    readonly actionPlan: ActionPlan | null;
+    readonly isUpdateAvailable: boolean;
+}
+/**
+ * The single reactive source of truth the Hooks adapter renders from (Prompt 1 §6) —
+ * components subscribe to this store, never to the core's event bus directly. Kept in
+ * sync by re-snapshotting the core on every event it emits.
+ */
+export declare class VersionManagerStore {
+    private readonly core;
+    private state;
+    private readonly listeners;
+    private readonly detach;
+    constructor(core: IVersionManagerCore);
+    getState(): Readonly<VersionManagerUiState>;
+    subscribe(listener: (state: Readonly<VersionManagerUiState>) => void): Unsubscribe;
+    dispose(): void;
+    private sync;
+}
+//# sourceMappingURL=VersionManagerStore.d.ts.map

package/lib/typescript/src/presentation/state/VersionManagerStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionManagerStore.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/state/VersionManagerStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAWD;;;;GAIG;AACH,qBAAa,mBAAmB;IAOlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAEtB;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAER,IAAI,EAAE,mBAAmB;IAatD,QAAQ,IAAI,QAAQ,CAAC,qBAAqB,CAAC;IAI3C,SAAS,CACP,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,qBAAqB,CAAC,KAAK,IAAI,GACzD,WAAW;IAOd,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,IAAI;CAMb"}

package/lib/typescript/src/publicApi.d.ts

@@ -0,0 +1,24 @@
+import type { IVersionManagerCore } from './domain/IVersionManagerCore';
+import type { CacheOptions, FallbackOptions, LoggingOptions, PolicyOptions, StoreLinksOptions, VersionManagerOptions } from './domain/models/VersionManagerOptions';
+import type { IPlatformBridge } from './domain/ports/IPlatformBridge';
+export declare const VersionManager: {
+    configure(options: VersionManagerOptions): IVersionManagerCore;
+    getInstance(): IVersionManagerCore;
+    isConfigured(): boolean;
+    /** Testing/HMR only — tears down the singleton (Prompt 2 §1.1). */
+    reset(): void;
+};
+export declare class VersionManagerBuilder {
+    private options;
+    private constructor();
+    static create(): VersionManagerBuilder;
+    withLogging(options: LoggingOptions): this;
+    withCache(options: CacheOptions): this;
+    withFallback(options: FallbackOptions): this;
+    withStoreLinks(options: StoreLinksOptions): this;
+    withPolicy(options: PolicyOptions): this;
+    /** Advanced/testing: DI override (Prompt 2 §1.1). */
+    withPlatformBridge(bridge: IPlatformBridge): this;
+    build(): IVersionManagerCore;
+}
+//# sourceMappingURL=publicApi.d.ts.map

package/lib/typescript/src/publicApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicApi.d.ts","sourceRoot":"","sources":["../../../src/publicApi.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AA8BtE,eAAO,MAAM,cAAc;uBACN,qBAAqB,GAAG,mBAAmB;mBAgB/C,mBAAmB;oBASlB,OAAO;IAIvB,mEAAmE;aAC1D,IAAI;CAKd,CAAC;AAEF,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAyC;IAExD,OAAO;IAEP,MAAM,CAAC,MAAM,IAAI,qBAAqB;IAItC,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAK1C,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAKtC,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAK5C,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAKhD,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKxC,qDAAqD;IACrD,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAKjD,KAAK,IAAI,mBAAmB;CAG7B"}

package/lib/typescript/src/shared/eventbus/EventBus.d.ts

@@ -0,0 +1,21 @@
+import type { Unsubscribe } from '../../domain/models/Unsubscribe';
+export type { Unsubscribe };
+export interface IEventBus<TMap extends object> {
+    publish<K extends keyof TMap>(type: K, payload: TMap[K]): void;
+    subscribe<K extends keyof TMap>(type: K, handler: (payload: TMap[K]) => void): Unsubscribe;
+    /** Removes a handler registered via subscribe() by reference (Prompt 2 §4.2's off()). */
+    off<K extends keyof TMap>(type: K, handler: (payload: TMap[K]) => void): void;
+}
+/**
+ * Generic typed pub/sub used for both the internal domain event flow (Prompt 1 §6)
+ * and the public IVersionManagerEvents surface (Prompt 2 §4). Copy-on-write listener
+ * snapshots on dispatch (Prompt 1 §9.2) — publishing during a concurrent
+ * subscribe/unsubscribe never races or throws.
+ */
+export declare class EventBus<TMap extends object> implements IEventBus<TMap> {
+    private readonly listeners;
+    publish<K extends keyof TMap>(type: K, payload: TMap[K]): void;
+    subscribe<K extends keyof TMap>(type: K, handler: (payload: TMap[K]) => void): Unsubscribe;
+    off<K extends keyof TMap>(type: K, handler: (payload: TMap[K]) => void): void;
+}
+//# sourceMappingURL=EventBus.d.ts.map

package/lib/typescript/src/shared/eventbus/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../../../../src/shared/eventbus/EventBus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,MAAM,WAAW,SAAS,CAAC,IAAI,SAAS,MAAM;IAC5C,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/D,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,EAC5B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAClC,WAAW,CAAC;IACf,yFAAyF;IACzF,GAAG,CAAC,CAAC,SAAS,MAAM,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CAC/E;AAID;;;;;GAKG;AACH,qBAAa,QAAQ,CAAC,IAAI,SAAS,MAAM,CAAE,YAAW,SAAS,CAAC,IAAI,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IAEpE,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;IAQ9D,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,EAC5B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAClC,WAAW;IAad,GAAG,CAAC,CAAC,SAAS,MAAM,IAAI,EACtB,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAClC,IAAI;CAGR"}

package/lib/typescript/src/shared/logging/Logger.d.ts

@@ -0,0 +1,17 @@
+import type { ILogSink, LogEntry, LogLevel } from '../../domain/models/VersionManagerOptions';
+export declare class ConsoleLogSink implements ILogSink {
+    write(entry: LogEntry): void;
+}
+export declare class Logger {
+    private level;
+    private readonly sink;
+    constructor(level: LogLevel, sink: ILogSink);
+    setLevel(level: LogLevel): void;
+    error(message: string, metadata?: Record<string, unknown>): void;
+    warn(message: string, metadata?: Record<string, unknown>): void;
+    info(message: string, metadata?: Record<string, unknown>): void;
+    debug(message: string, metadata?: Record<string, unknown>): void;
+    verbose(message: string, metadata?: Record<string, unknown>): void;
+    private log;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/lib/typescript/src/shared/logging/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../../../src/shared/logging/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACT,MAAM,2CAA2C,CAAC;AAWnD,qBAAa,cAAe,YAAW,QAAQ;IAC7C,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAU7B;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;gBAEpB,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ;IAK3C,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIlE,OAAO,CAAC,GAAG;CAQZ"}

package/lib/typescript/src/ui.d.ts

@@ -0,0 +1,15 @@
+export { useVersionManager } from './presentation/hooks/useVersionManager';
+export type { UseVersionManagerResult } from './presentation/hooks/useVersionManager';
+export { useUpdateState } from './presentation/hooks/useUpdateState';
+export type { UseUpdateStateResult } from './presentation/hooks/useUpdateState';
+export { VersionManagerProvider } from './presentation/hooks/VersionManagerProvider';
+export type { VersionManagerProviderProps } from './presentation/hooks/VersionManagerProvider';
+export { ForceUpdateScreen } from './presentation/components/ForceUpdateScreen';
+export type { ForceUpdateScreenProps } from './presentation/components/ForceUpdateScreen';
+export { SoftUpdateDialog } from './presentation/components/SoftUpdateDialog';
+export type { SoftUpdateDialogProps } from './presentation/components/SoftUpdateDialog';
+export { OptionalUpdateBanner } from './presentation/components/OptionalUpdateBanner';
+export type { OptionalUpdateBannerProps } from './presentation/components/OptionalUpdateBanner';
+export type { VersionManagerUiState } from './presentation/state/VersionManagerStore';
+export { VersionManagerStore } from './presentation/state/VersionManagerStore';
+//# sourceMappingURL=ui.d.ts.map

package/lib/typescript/src/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/ui.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,YAAY,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,YAAY,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAE/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAChF,YAAY,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,YAAY,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAEhG,YAAY,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC"}

package/package.json

@@ -0,0 +1,192 @@
+{
+  "name": "@rs-native-kit/version-check",
+  "version": "0.1.2",
+  "description": "for version update",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "rs-native-kit-version-check-source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./ui": {
+      "rs-native-kit-version-check-source": "./src/ui.tsx",
+      "types": "./lib/typescript/src/ui.d.ts",
+      "default": "./lib/module/ui.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace @rs-native-kit/version-check-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version",
+    "web": "vite",
+    "build:web": "vite build"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rajssinde/rs-native-kit-version-check.git"
+  },
+  "author": "Rajesh Shinde <rajssinde@gmail.com> (https://github.com/rajssinde)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/rajssinde/rs-native-kit-version-check/issues"
+  },
+  "homepage": "https://github.com/rajssinde/rs-native-kit-version-check#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^21.0.2",
+    "@eslint/compat": "^2.1.0",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@jest/globals": "^29.7.0",
+    "@react-native/babel-preset": "0.85.0",
+    "@react-native/eslint-config": "0.85.0",
+    "@react-native/jest-preset": "0.85.0",
+    "@release-it/conventional-changelog": "^11.0.1",
+    "@types/react": "^19.2.0",
+    "commitlint": "^21.0.2",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.6",
+    "jest": "^29.7.0",
+    "lefthook": "^2.1.9",
+    "prettier": "^3.8.3",
+    "react": "19.2.3",
+    "react-native": "0.85.0",
+    "react-native-builder-bob": "^0.41.0",
+    "react-native-web": "~0.21.2",
+    "release-it": "^20.2.0",
+    "turbo": "^2.9.16",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "VersionCheckSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.rsnativekit.versioncheck"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "@react-native/jest-preset",
+    "testPathIgnorePatterns": [
+      "/node_modules/",
+      "<rootDir>/src/__tests__/mocks/"
+    ],
+    "testEnvironmentOptions": {
+      "customExportConditions": [
+        "require",
+        "react-native",
+        "<%- project.sourceCondition -%>"
+      ]
+    },
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it",
+      "vite"
+    ],
+    "version": "0.63.0"
+  }
+}

package/src/data/cache/MemoryCacheStore.ts

@@ -0,0 +1,36 @@
+import type { ICacheStore } from '../../domain/ports/ICacheStore';
+import type { IClock } from '../../domain/ports/IClock';
+
+interface Entry<T> {
+  readonly value: T;
+  readonly expiresAt: number | null;
+}
+
+export class MemoryCacheStore<T> implements ICacheStore<T> {
+  private readonly entries = new Map<string, Entry<T>>();
+
+  constructor(
+    private readonly clock: IClock,
+    private readonly defaultTtlMs: number
+  ) {}
+
+  async get(key: string): Promise<T | null> {
+    const entry = this.entries.get(key);
+    if (!entry) return null;
+    if (entry.expiresAt !== null && this.clock.now() > entry.expiresAt) {
+      this.entries.delete(key);
+      return null;
+    }
+    return entry.value;
+  }
+
+  async set(key: string, value: T, ttlMs?: number): Promise<void> {
+    const ttl = ttlMs ?? this.defaultTtlMs;
+    const expiresAt = ttl > 0 ? this.clock.now() + ttl : null;
+    this.entries.set(key, { value, expiresAt });
+  }
+
+  async invalidate(key: string): Promise<void> {
+    this.entries.delete(key);
+  }
+}

package/src/data/cache/PersistentCacheStore.ts

@@ -0,0 +1,63 @@
+import {
+  CacheCorruptionException,
+  CacheWriteException,
+} from '../../domain/errors/VersionManagerException';
+import type { ICacheStore } from '../../domain/ports/ICacheStore';
+import type { IClock } from '../../domain/ports/IClock';
+import type { IKeyValueStorage } from '../../domain/ports/IPlatformBridge';
+
+interface PersistedEntry<T> {
+  readonly value: T;
+  readonly expiresAt: number | null;
+}
+
+export class PersistentCacheStore<T> implements ICacheStore<T> {
+  constructor(
+    private readonly storage: IKeyValueStorage,
+    private readonly clock: IClock,
+    private readonly defaultTtlMs: number,
+    private readonly keyPrefix: string = 'vm_cache_'
+  ) {}
+
+  async get(key: string): Promise<T | null> {
+    const raw = await this.storage.get(this.keyPrefix + key);
+    if (!raw) return null;
+
+    let entry: PersistedEntry<T>;
+    try {
+      entry = JSON.parse(raw) as PersistedEntry<T>;
+    } catch (error) {
+      throw new CacheCorruptionException({
+        message: `Corrupt persistent cache entry for key "${key}"`,
+        cause: error,
+        metadata: { key },
+      });
+    }
+
+    if (entry.expiresAt !== null && this.clock.now() > entry.expiresAt) {
+      await this.storage.remove(this.keyPrefix + key);
+      return null;
+    }
+    return entry.value;
+  }
+
+  async set(key: string, value: T, ttlMs?: number): Promise<void> {
+    const ttl = ttlMs ?? this.defaultTtlMs;
+    const expiresAt = ttl > 0 ? this.clock.now() + ttl : null;
+    const entry: PersistedEntry<T> = { value, expiresAt };
+    try {
+      await this.storage.set(this.keyPrefix + key, JSON.stringify(entry));
+    } catch (error) {
+      throw new CacheWriteException({
+        message: `Failed to persist cache entry for key "${key}"`,
+        cause: error,
+        retryable: true,
+        metadata: { key },
+      });
+    }
+  }
+
+  async invalidate(key: string): Promise<void> {
+    await this.storage.remove(this.keyPrefix + key);
+  }
+}

package/src/data/config/ConfigCache.ts

@@ -0,0 +1,30 @@
+import type { ResolvedVersionManagerConfig } from '../../domain/models/VersionManagerOptions';
+import type { IConfigCache } from '../../domain/ports/IConfigSources';
+import type { IKeyValueStorage } from '../../domain/ports/IPlatformBridge';
+
+const STORAGE_KEY = 'vm_config_cache_v1';
+
+/**
+ * Doc 03 §4.3 — the persistent tier of the access-path cache (backs the in-process
+ * memory cache across app restarts). Stores the last config that successfully passed
+ * schema+boundary+signature validation, regardless of which tier produced it.
+ */
+export class ConfigCache implements IConfigCache {
+  constructor(private readonly storage: IKeyValueStorage) {}
+
+  async getLastValid(): Promise<ResolvedVersionManagerConfig | null> {
+    const raw = await this.storage.get(STORAGE_KEY);
+    if (!raw) return null;
+    try {
+      return JSON.parse(raw) as ResolvedVersionManagerConfig;
+    } catch {
+      // Corrupt config cache entry — treated as absent (§7.2 falls through to the next
+      // tier), not surfaced as a hard failure of the config pipeline itself.
+      return null;
+    }
+  }
+
+  async setLastValid(config: ResolvedVersionManagerConfig): Promise<void> {
+    await this.storage.set(STORAGE_KEY, JSON.stringify(config));
+  }
+}