@rs-native-kit/version-check 0.1.2

package/lib/typescript/src/domain/engines/decision/DecisionEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecisionEngine.d.ts","sourceRoot":"","sources":["../../../../../../src/domain/engines/decision/DecisionEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGxE;;;;;GAKG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,MAAM;IAE1C,eAAe,CACb,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAC/B,UAAU;CA2Bd"}

package/lib/typescript/src/domain/engines/policy/IUpdatePolicyEngine.d.ts

@@ -0,0 +1,17 @@
+import type { ActionType } from '../../models/ActionPlan';
+import type { ParsedVersion } from '../../models/ParsedVersion';
+import type { UserVersionDecision } from '../../models/RemoteVersionInfo';
+export interface PolicyEvaluationContext {
+    readonly currentVersion: ParsedVersion;
+    readonly remoteVersion: ParsedVersion;
+    readonly forceUpdateBelow: ParsedVersion | null;
+    readonly userDecision: UserVersionDecision | null;
+    readonly now: number;
+    readonly rolloutPercentage: number;
+    /** Precomputed 0-99 bucket for this device (Prompt 18 rollout hashing — deferred, see PolicyEngine). */
+    readonly rolloutBucket: number;
+}
+export interface IUpdatePolicyEngine {
+    evaluate(context: PolicyEvaluationContext): ActionType;
+}
+//# sourceMappingURL=IUpdatePolicyEngine.d.ts.map

package/lib/typescript/src/domain/engines/policy/IUpdatePolicyEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUpdatePolicyEngine.d.ts","sourceRoot":"","sources":["../../../../../../src/domain/engines/policy/IUpdatePolicyEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,aAAa,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,wGAAwG;IACxG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU,CAAC;CACxD"}

package/lib/typescript/src/domain/engines/policy/PolicyEngine.d.ts

@@ -0,0 +1,16 @@
+import { ActionType } from '../../models/ActionPlan';
+import type { IVersionComparator } from '../semver/IVersionComparator';
+import type { IUpdatePolicyEngine, PolicyEvaluationContext } from './IUpdatePolicyEngine';
+/**
+ * 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 declare class PolicyEngine implements IUpdatePolicyEngine {
+    private readonly comparator;
+    constructor(comparator: IVersionComparator);
+    evaluate(context: PolicyEvaluationContext): ActionType;
+}
+//# sourceMappingURL=PolicyEngine.d.ts.map

package/lib/typescript/src/domain/engines/policy/PolicyEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyEngine.d.ts","sourceRoot":"","sources":["../../../../../../src/domain/engines/policy/PolicyEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,kBAAkB;IAE3D,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU;CA0CvD"}

package/lib/typescript/src/domain/engines/semver/IVersionComparator.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedVersion } from '../../models/ParsedVersion';
+export interface IVersionComparator {
+    parse(raw: string): ParsedVersion;
+    compare(a: ParsedVersion, b: ParsedVersion): -1 | 0 | 1;
+    satisfies(version: ParsedVersion, range: string): boolean;
+}
+//# sourceMappingURL=IVersionComparator.d.ts.map

package/lib/typescript/src/domain/engines/semver/IVersionComparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IVersionComparator.d.ts","sourceRoot":"","sources":["../../../../../../src/domain/engines/semver/IVersionComparator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;IAClC,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxD,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3D"}

package/lib/typescript/src/domain/engines/semver/SemVerEngine.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedVersion } from '../../models/ParsedVersion';
+import type { IVersionComparator } from './IVersionComparator';
+export declare function parseVersion(raw: string): ParsedVersion;
+export declare function compareVersions(a: ParsedVersion, b: ParsedVersion): -1 | 0 | 1;
+export declare function satisfiesRange(version: ParsedVersion, range: string): boolean;
+export declare class SemVerEngine implements IVersionComparator {
+    parse(raw: string): ParsedVersion;
+    compare(a: ParsedVersion, b: ParsedVersion): -1 | 0 | 1;
+    satisfies(version: ParsedVersion, range: string): boolean;
+}
+//# sourceMappingURL=SemVerEngine.d.ts.map

package/lib/typescript/src/domain/engines/semver/SemVerEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SemVerEngine.d.ts","sourceRoot":"","sources":["../../../../../../src/domain/engines/semver/SemVerEngine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAuB/D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAuCvD;AA4BD,wBAAgB,eAAe,CAC7B,CAAC,EAAE,aAAa,EAChB,CAAC,EAAE,aAAa,GACf,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAKZ;AAiFD,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAI7E;AAED,qBAAa,YAAa,YAAW,kBAAkB;IACrD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAIjC,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAIvD,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;CAG1D"}

package/lib/typescript/src/domain/errors/VersionManagerException.d.ts

@@ -0,0 +1,97 @@
+export type VersionManagerErrorCode = 'VM-1001' | 'VM-1002' | 'VM-1003' | 'VM-1004' | 'VM-1005' | 'VM-1006' | 'VM-1007' | 'VM-1008' | 'VM-1009' | 'VM-2001' | 'VM-2002' | 'VM-2003' | 'VM-2004' | 'VM-3001' | 'VM-3002' | 'VM-3003' | 'VM-3004' | 'VM-4001' | 'VM-5001' | 'VM-6001' | 'VM-6002' | 'VM-7001' | 'VM-9999';
+export interface VersionManagerExceptionInit {
+    message: string;
+    cause?: unknown;
+    metadata?: Record<string, unknown>;
+    retryable?: boolean;
+}
+export declare abstract class VersionManagerException extends Error {
+    abstract readonly code: VersionManagerErrorCode;
+    readonly cause: unknown;
+    readonly metadata: Readonly<Record<string, unknown>>;
+    readonly retryable: boolean;
+    readonly timestamp: number;
+    constructor(init: VersionManagerExceptionInit);
+}
+export declare class InvalidConfigException extends VersionManagerException {
+    readonly code: "VM-1001";
+}
+export declare class NotInitializedException extends VersionManagerException {
+    readonly code: "VM-1002";
+}
+export declare class NotReadyException extends VersionManagerException {
+    readonly code: "VM-1003";
+}
+export declare class SchemaValidationException extends VersionManagerException {
+    readonly code: "VM-1004";
+}
+export declare class BoundaryValidationException extends VersionManagerException {
+    readonly code: "VM-1005";
+}
+export declare class SignatureVerificationException extends VersionManagerException {
+    readonly code: "VM-1006";
+}
+export declare class ConfigSizeLimitExceededException extends VersionManagerException {
+    readonly code: "VM-1007";
+}
+export declare class UntrustedKeyIdException extends VersionManagerException {
+    readonly code: "VM-1008";
+}
+export declare class EnvironmentOverrideConflictException extends VersionManagerException {
+    readonly code: "VM-1009";
+}
+export declare abstract class NetworkException extends VersionManagerException {
+}
+export declare class RequestTimeoutException extends NetworkException {
+    readonly code: "VM-2001";
+    readonly retryable = true;
+}
+export declare class RateLimitException extends NetworkException {
+    readonly code: "VM-2002";
+    readonly retryable = true;
+}
+export declare class OfflineException extends NetworkException {
+    readonly code: "VM-2003";
+    readonly retryable = true;
+}
+export declare class TlsHandshakeException extends NetworkException {
+    readonly code: "VM-2004";
+}
+export declare abstract class StoreProviderException extends VersionManagerException {
+}
+export declare class AppNotFoundException extends StoreProviderException {
+    readonly code: "VM-3001";
+}
+export declare class StorePermissionException extends StoreProviderException {
+    readonly code: "VM-3002";
+}
+export declare class UnsupportedStoreException extends StoreProviderException {
+    readonly code: "VM-3003";
+}
+export declare class StoreResponseParseException extends StoreProviderException {
+    readonly code: "VM-3004";
+}
+export declare class InvalidVersionFormatException extends VersionManagerException {
+    readonly code: "VM-4001";
+}
+export declare class PolicyEvaluationException extends VersionManagerException {
+    readonly code: "VM-5001";
+}
+export declare abstract class CacheException extends VersionManagerException {
+}
+export declare class CacheCorruptionException extends CacheException {
+    readonly code: "VM-6001";
+}
+export declare class CacheWriteException extends CacheException {
+    readonly code: "VM-6002";
+    readonly retryable = true;
+}
+export declare class PlatformBridgeException extends VersionManagerException {
+    readonly code: "VM-7001";
+}
+export declare class UnknownVersionManagerException extends VersionManagerException {
+    readonly code: "VM-9999";
+}
+export declare function toVersionManagerException(error: unknown): VersionManagerException;
+export declare function isConfigTierException(error: unknown): error is VersionManagerException;
+//# sourceMappingURL=VersionManagerException.d.ts.map

package/lib/typescript/src/domain/errors/VersionManagerException.d.ts.map

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

package/lib/typescript/src/domain/models/ActionPlan.d.ts

@@ -0,0 +1,15 @@
+import type { UpdateInfo } from './UpdateInfo';
+export declare const ActionType: {
+    readonly NO_ACTION: "NO_ACTION";
+    readonly FORCE_UPDATE: "FORCE_UPDATE";
+    readonly SOFT_UPDATE: "SOFT_UPDATE";
+    readonly OPTIONAL_REMINDER: "OPTIONAL_REMINDER";
+};
+export type ActionType = (typeof ActionType)[keyof typeof ActionType];
+export interface ActionPlan {
+    readonly type: ActionType;
+    readonly updateInfo: UpdateInfo | null;
+    readonly reason: string;
+    readonly decidedAt: number;
+}
+//# sourceMappingURL=ActionPlan.d.ts.map

package/lib/typescript/src/domain/models/ActionPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionPlan.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/ActionPlan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/lib/typescript/src/domain/models/ConfigDocument.d.ts

@@ -0,0 +1,86 @@
+import type { StoreLinksOptions } from './VersionManagerOptions';
+/** Doc 03 §1.1 — the loadable configuration document (payload of a SignedConfigEnvelope). */
+export interface VersionManagerConfigDocument {
+    readonly localVersionIdentifier?: string;
+    readonly remoteConfigUrl?: string;
+    readonly cache?: {
+        readonly ttlMs?: number;
+        readonly storage?: 'memory' | 'persistent';
+    };
+    readonly network?: {
+        readonly requestTimeoutMs?: number;
+        readonly retry?: {
+            readonly maxAttempts?: number;
+            readonly backoff?: 'fixed' | 'exponential-jitter';
+            readonly baseDelayMs?: number;
+        };
+    };
+    readonly alerts?: {
+        readonly forceUpdateBelow?: string;
+        readonly reminderDelayMs?: number;
+        readonly customUiHookIds?: readonly string[];
+    };
+    readonly stores?: StoreLinksOptions;
+    /**
+     * Only ever read from tier 4 (configure()) per §4.2 — a document cannot alter the
+     * rules used to verify documents. Present in the type for schema-shape completeness
+     * (an incoming document that includes it is structurally valid but this field is
+     * always ignored by the precedence merge — see ConfigResolutionPipeline).
+     */
+    readonly security?: {
+        readonly signatureAlgorithm?: 'ed25519' | 'hmac-sha256' | 'none';
+        readonly trustedKeyIds?: readonly string[];
+    };
+    readonly schemaVersion?: string;
+}
+export type SignatureAlgorithm = 'ed25519' | 'hmac-sha256' | 'none';
+/** Doc 03 §3.1 — envelope wrapping every local/remote config document. */
+export interface SignedConfigEnvelope {
+    readonly schemaVersion: string;
+    readonly payload: VersionManagerConfigDocument;
+    readonly signature: {
+        readonly algorithm: SignatureAlgorithm;
+        readonly keyId: string;
+        readonly value: string;
+        readonly signedAt: string;
+    };
+}
+/** Opaque raw bytes/JSON before schema validation has proven its shape. */
+export type RawConfigDocument = unknown;
+export interface ConfigLoadRequest {
+    readonly defaults: import('./VersionManagerOptions').VersionManagerOptions;
+}
+export interface FetchOptions {
+    readonly timeoutMs: number;
+    readonly headers?: Readonly<Record<string, string>>;
+}
+export interface TrustedKeySet {
+    readonly algorithm: SignatureAlgorithm;
+    /**
+     * Trusted keyIds only — per doc 03 §3.4, actual key material (public keys / HMAC
+     * secrets) is embedded at build time on the native side (Info.plist/BuildConfig), not
+     * shipped through JS. JS only needs to confirm the envelope's keyId is one this app
+     * trusts, then hand the keyId to ICryptoProvider, which resolves it to key material
+     * natively.
+     */
+    readonly keys: ReadonlySet<string>;
+}
+export type ConfigTier = 'env' | 'remote' | 'local' | 'default';
+export interface SchemaValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+export interface BoundaryValidationResult {
+    readonly valid: boolean;
+    /** Field-path -> reason, so the pipeline can drop only the offending fields (§7.3). */
+    readonly fieldErrors: ReadonlyMap<string, string>;
+}
+export interface SignatureVerificationResult {
+    readonly valid: boolean;
+    readonly reason?: string;
+}
+export interface ResolvedConfigWithProvenance {
+    readonly config: import('./VersionManagerOptions').ResolvedVersionManagerConfig;
+    readonly tier: ConfigTier;
+}
+//# sourceMappingURL=ConfigDocument.d.ts.map

package/lib/typescript/src/domain/models/ConfigDocument.d.ts.map

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

package/lib/typescript/src/domain/models/Events.d.ts

@@ -0,0 +1,39 @@
+import type { VersionManagerException } from '../errors/VersionManagerException';
+import type { ActionPlan } from './ActionPlan';
+import type { LifecycleState } from './LifecycleState';
+import type { UpdateInfo } from './UpdateInfo';
+export interface StateChangedEvent {
+    readonly from: LifecycleState;
+    readonly to: LifecycleState;
+    readonly timestamp: number;
+}
+export interface UpdateDetectedEvent {
+    readonly updateInfo: UpdateInfo;
+    readonly actionPlan: ActionPlan;
+    readonly timestamp: number;
+}
+export interface UpdateNotAvailableEvent {
+    readonly currentVersion: string;
+    readonly checkedAt: number;
+}
+export type UserActionType = 'update_clicked' | 'later_clicked' | 'ignore_clicked' | 'dismiss_clicked';
+export interface UserActionEvent {
+    readonly action: UserActionType;
+    readonly updateInfo: UpdateInfo;
+    readonly timestamp: number;
+}
+export type ErrorPhase = 'config' | 'check' | 'policy' | 'presentation';
+export interface VersionManagerErrorEvent {
+    readonly error: VersionManagerException;
+    readonly phase: ErrorPhase;
+    readonly timestamp: number;
+}
+export interface VersionManagerEventMap {
+    stateChanged: StateChangedEvent;
+    updateDetected: UpdateDetectedEvent;
+    updateNotAvailable: UpdateNotAvailableEvent;
+    userAction: UserActionEvent;
+    error: VersionManagerErrorEvent;
+}
+export type VersionManagerEventType = keyof VersionManagerEventMap;
+//# sourceMappingURL=Events.d.ts.map

package/lib/typescript/src/domain/models/Events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Events.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/Events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GACxB,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;AAExE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,iBAAiB,CAAC;IAChC,cAAc,EAAE,mBAAmB,CAAC;IACpC,kBAAkB,EAAE,uBAAuB,CAAC;IAC5C,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,wBAAwB,CAAC;CACjC;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,sBAAsB,CAAC"}

package/lib/typescript/src/domain/models/LifecycleState.d.ts

@@ -0,0 +1,18 @@
+export declare const LifecycleState: {
+    readonly UNINITIALIZED: "UNINITIALIZED";
+    readonly CONFIG_LOADING: "CONFIG_LOADING";
+    readonly IDLE: "IDLE";
+    readonly VERSION_CHECKING: "VERSION_CHECKING";
+    readonly DECIDING: "DECIDING";
+    readonly FORCE_UPDATE_DISPLAYED: "FORCE_UPDATE_DISPLAYED";
+    readonly SOFT_UPDATE_DISPLAYED: "SOFT_UPDATE_DISPLAYED";
+    readonly REJECTED_WAITING_REMINDER: "REJECTED_WAITING_REMINDER";
+    readonly TERMINATED: "TERMINATED";
+};
+export type LifecycleState = (typeof LifecycleState)[keyof typeof LifecycleState];
+/**
+ * Allowed transitions. Anything not listed here is invalid and
+ * ILifecycleStateMachine.transition() must reject it.
+ */
+export declare const LIFECYCLE_TRANSITIONS: Readonly<Record<LifecycleState, readonly LifecycleState[]>>;
+//# sourceMappingURL=LifecycleState.d.ts.map

package/lib/typescript/src/domain/models/LifecycleState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LifecycleState.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/LifecycleState.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;;;;;CAUjB,CAAC;AAEX,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,MAAM,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,CAAC,CA6BlD,CAAC"}

package/lib/typescript/src/domain/models/ParsedVersion.d.ts

@@ -0,0 +1,9 @@
+export interface ParsedVersion {
+    readonly raw: string;
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+    readonly prerelease: readonly (string | number)[];
+    readonly build: readonly string[];
+}
+//# sourceMappingURL=ParsedVersion.d.ts.map

package/lib/typescript/src/domain/models/ParsedVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParsedVersion.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/ParsedVersion.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC"}

package/lib/typescript/src/domain/models/PlatformId.d.ts

@@ -0,0 +1,3 @@
+export type PlatformId = 'ios' | 'android' | 'web';
+export type StoreProviderId = 'apple' | 'google-play' | 'huawei' | 'amazon' | 'custom' | 'firebase-remote-config';
+//# sourceMappingURL=PlatformId.d.ts.map

package/lib/typescript/src/domain/models/PlatformId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformId.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/PlatformId.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;AAEnD,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,wBAAwB,CAAC"}

package/lib/typescript/src/domain/models/PublicApiOptions.d.ts

@@ -0,0 +1,13 @@
+export interface CheckForUpdatesOptions {
+    bypassCache?: boolean;
+    silent?: boolean;
+    timeoutMs?: number;
+    context?: Record<string, unknown>;
+}
+export interface ForceTriggerOptions {
+    reason?: string;
+}
+export interface ResetIgnoredVersionsOptions {
+    versions?: string[];
+}
+//# sourceMappingURL=PublicApiOptions.d.ts.map

package/lib/typescript/src/domain/models/PublicApiOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicApiOptions.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/PublicApiOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/lib/typescript/src/domain/models/RemoteVersionInfo.d.ts

@@ -0,0 +1,21 @@
+import type { PlatformId, StoreProviderId } from './PlatformId';
+export interface RemoteVersionInfo {
+    readonly latestVersion: string;
+    readonly storeUrl: string;
+    readonly releaseNotes: string | null;
+    readonly minimumOsVersion: string | null;
+    readonly fetchedAt: number;
+    readonly provider: StoreProviderId;
+}
+export interface VersionCheckRequest {
+    readonly currentVersion: string;
+    readonly bundleId: string;
+    readonly platform: PlatformId;
+    readonly bypassCache: boolean;
+    readonly timeoutMs: number;
+}
+export interface UserVersionDecision {
+    readonly ignoredVersions: readonly string[];
+    readonly remindMeLaterUntil: number | null;
+}
+//# sourceMappingURL=RemoteVersionInfo.d.ts.map

package/lib/typescript/src/domain/models/RemoteVersionInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteVersionInfo.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/RemoteVersionInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C"}

package/lib/typescript/src/domain/models/StoreLookup.d.ts

@@ -0,0 +1,12 @@
+export interface StoreLookupRequest {
+    readonly bundleId: string;
+    readonly region: string | null;
+    readonly timeoutMs: number;
+}
+export interface StoreLookupResult {
+    readonly latestVersion: string;
+    readonly storeUrl: string;
+    readonly releaseNotes: string | null;
+    readonly minimumOsVersion: string | null;
+}
+//# sourceMappingURL=StoreLookup.d.ts.map

package/lib/typescript/src/domain/models/StoreLookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreLookup.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/StoreLookup.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C"}

package/lib/typescript/src/domain/models/Unsubscribe.d.ts

@@ -0,0 +1,2 @@
+export type Unsubscribe = () => void;
+//# sourceMappingURL=Unsubscribe.d.ts.map

package/lib/typescript/src/domain/models/Unsubscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Unsubscribe.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/Unsubscribe.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC"}

package/lib/typescript/src/domain/models/UpdateInfo.d.ts

@@ -0,0 +1,11 @@
+import type { StoreProviderId } from './PlatformId';
+export interface UpdateInfo {
+    readonly currentVersion: string;
+    readonly latestVersion: string;
+    readonly storeUrl: string;
+    readonly releaseNotes: string | null;
+    readonly isForceUpdate: boolean;
+    readonly provider: StoreProviderId;
+    readonly fetchedAt: number;
+}
+//# sourceMappingURL=UpdateInfo.d.ts.map

package/lib/typescript/src/domain/models/UpdateInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateInfo.d.ts","sourceRoot":"","sources":["../../../../../src/domain/models/UpdateInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/lib/typescript/src/domain/models/VersionManagerOptions.d.ts

@@ -0,0 +1,149 @@
+import type { IPlatformBridge } from '../ports/IPlatformBridge';
+import type { SignatureAlgorithm, VersionManagerConfigDocument } from './ConfigDocument';
+import type { RemoteVersionInfo } from './RemoteVersionInfo';
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug' | 'verbose';
+export interface LogEntry {
+    readonly level: LogLevel;
+    readonly message: string;
+    readonly timestamp: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ILogSink {
+    write(entry: LogEntry): void;
+}
+export interface LoggingOptions {
+    level?: LogLevel;
+    sink?: ILogSink;
+}
+export interface CacheOptions {
+    ttlMs?: number;
+    storage?: 'memory' | 'persistent';
+    bustOnManualCheck?: boolean;
+}
+export interface RetryOptions {
+    maxAttempts?: number;
+    backoff?: 'fixed' | 'exponential-jitter';
+    baseDelayMs?: number;
+}
+export interface FallbackOptions {
+    onNetworkError?: 'useCache' | 'useDefaultConfig' | 'noAction';
+    defaultConfig?: RemoteVersionInfo;
+    requestTimeoutMs?: number;
+    retry?: RetryOptions;
+}
+export interface StoreLinksOptions {
+    /**
+     * appStoreId is optional — when omitted, the App Store lookup falls back to the
+     * running app's bundle id (IAppInfoProvider.getBundleId(), read at check time)
+     * instead of the numeric App Store Connect id.
+     */
+    ios?: {
+        appStoreId?: string;
+        region?: string;
+    };
+    /**
+     * packageName is optional — when omitted, the Google Play lookup falls back to the
+     * running app's bundle id (which *is* the Android package name) at check time.
+     */
+    android?: {
+        packageName?: string;
+    };
+    huawei?: {
+        appId: string;
+    };
+    amazon?: {
+        asin: string;
+    };
+    custom?: {
+        url: string;
+        headers?: Record<string, string>;
+    };
+}
+export interface PolicyOptions {
+    forceUpdateBelow?: string;
+    reminderIntervalMs?: number;
+    rolloutPercentage?: number;
+}
+/** Doc 03 §1.1 Security field group — fixed by the app developer, tier-4 only. */
+export interface SecurityOptions {
+    signatureAlgorithm?: SignatureAlgorithm;
+    trustedKeyIds?: string[];
+}
+/**
+ * Doc 03 §0/§4 — optional loadable-config-document extension points layered on top of
+ * the VersionManagerOptions "default fallback" tier. All optional; an app that supplies
+ * none of these still works, driven entirely by configure() options (tier 4 only).
+ */
+export interface ConfigSourcesOptions {
+    /**
+     * Bundled local config envelope. Metro/webpack natively supports JSON imports
+     * (`import localConfig from './vm-config.json'`), which already avoids the
+     * double-buffer-copy §5.1 is concerned about for a <=64KB document without requiring
+     * a dedicated native mmap reader — pass the imported envelope object directly.
+     */
+    local?: import('./ConfigDocument').SignedConfigEnvelope;
+    /** Extra headers/timeout for the remote fetch beyond FallbackOptions.requestTimeoutMs. */
+    remoteFetchHeaders?: Record<string, string>;
+    /** Explicit runtime overrides — highest-precedence tier (§4.2 tier 1). */
+    envOverrides?: Partial<VersionManagerConfigDocument>;
+    /** Registered customUiHookIds -> handler ids that a config document is allowed to activate (§1.2, §7.1 VM-1009). */
+    registeredUiHookIds?: string[];
+}
+export interface VersionManagerOptions {
+    appVersion?: string;
+    logging?: LoggingOptions;
+    cache?: CacheOptions;
+    fallback?: FallbackOptions;
+    stores: StoreLinksOptions;
+    policy?: PolicyOptions;
+    /** DI override, advanced/testing use only (Prompt 2 §1.1). */
+    platformBridge?: IPlatformBridge;
+    strictReadiness?: boolean;
+    /** Doc 03 §1.1 — if absent, the SDK operates in local-file/default-only mode. */
+    remoteConfigUrl?: string;
+    security?: SecurityOptions;
+    configSources?: ConfigSourcesOptions;
+}
+/**
+ * Fully-defaulted, immutable configuration actually consumed at runtime, produced by
+ * IConfigProvider.resolve() from a VersionManagerOptions "default fallback" tier
+ * (Prompt 3 §4.2). Local-file/remote/env overlay tiers are extension points on
+ * IConfigProvider, not yet wired into a signed-envelope pipeline in this pass —
+ * see docs/architecture/03-configuration-system.md §3 for that follow-up scope.
+ */
+export interface ResolvedVersionManagerConfig {
+    readonly appVersion: string | null;
+    readonly logging: {
+        readonly level: LogLevel;
+        readonly sink: ILogSink;
+    };
+    readonly cache: {
+        readonly ttlMs: number;
+        readonly storage: 'memory' | 'persistent';
+        readonly bustOnManualCheck: boolean;
+    };
+    readonly fallback: {
+        readonly onNetworkError: 'useCache' | 'useDefaultConfig' | 'noAction';
+        readonly defaultConfig: RemoteVersionInfo | null;
+        readonly requestTimeoutMs: number;
+        readonly retry: {
+            readonly maxAttempts: number;
+            readonly backoff: 'fixed' | 'exponential-jitter';
+            readonly baseDelayMs: number;
+        };
+    };
+    readonly stores: StoreLinksOptions;
+    readonly policy: {
+        readonly forceUpdateBelow: string | null;
+        readonly reminderIntervalMs: number;
+        readonly rolloutPercentage: number;
+    };
+    readonly strictReadiness: boolean;
+    readonly remoteConfigUrl: string | null;
+    readonly security: {
+        readonly signatureAlgorithm: SignatureAlgorithm;
+        readonly trustedKeyIds: readonly string[];
+    };
+    readonly schemaVersion: string;
+}
+//# sourceMappingURL=VersionManagerOptions.d.ts.map

package/lib/typescript/src/domain/models/VersionManagerOptions.d.ts.map

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