joopjs 2.0.0

package/dist/oidc-client-DIJcClmB.d.mts

@@ -0,0 +1,190 @@
+import { J as JoopObservable } from './index-Dz0gOur2.mjs';
+import { d as JoopStorageAdapter } from './adapters-B6slG6hQ.mjs';
+
+interface JoopTokenPayload {
+    sub?: string;
+    exp?: number;
+    iat?: number;
+    jti?: string;
+    [key: string]: unknown;
+}
+declare class JoopTokenService {
+    private _access;
+    private _refresh;
+    private _refreshCb;
+    private _timer;
+    setTokens(accessToken: string, refreshToken: string): void;
+    getAccessToken(): string;
+    getRefreshToken(): string;
+    decode(token: string): JoopTokenPayload | null;
+    isExpired(token?: string): boolean;
+    expiresInMs(token?: string): number;
+    onRefreshNeeded(callback: (refreshToken: string) => Promise<string>): void;
+    refreshNow(): Promise<string>;
+    clear(): void;
+    private _scheduleRefresh;
+}
+
+interface JoopPKCEParams {
+    codeVerifier: string;
+    codeChallenge: string;
+    codeChallengeMethod: 'S256';
+}
+declare class JoopPKCEService {
+    private _verifier;
+    generate(): Promise<JoopPKCEParams>;
+    getVerifier(): string;
+    generateState(): string;
+    buildAuthUrl(baseUrl: string, params: {
+        clientId: string;
+        redirectUri: string;
+        scope: string;
+        state: string;
+        codeChallenge: string;
+    }): string;
+    private _base64url;
+}
+
+declare class JoopOtpService {
+    private readonly _period;
+    private readonly _digits;
+    generateTOTP(secretBase32: string, time?: number): Promise<string>;
+    verifyTOTP(token: string, secretBase32: string, window?: number): Promise<boolean>;
+    generateNumericOTP(length?: number): string;
+    generateAlphanumericOTP(length?: number): string;
+    private _hotp;
+    private _base32Decode;
+}
+
+declare class JoopBiometricService {
+    isSupported(): boolean;
+    isAvailable(): Promise<boolean>;
+    register(options: {
+        rpId: string;
+        rpName: string;
+        userId: string;
+        userName: string;
+        userDisplayName: string;
+        challenge: ArrayBuffer;
+    }): Promise<PublicKeyCredential>;
+    authenticate(options: {
+        rpId: string;
+        challenge: ArrayBuffer;
+        allowCredentials?: PublicKeyCredentialDescriptor[];
+    }): Promise<PublicKeyCredential>;
+    generateChallenge(): ArrayBuffer;
+    credentialIdToBase64(id: ArrayBuffer): string;
+}
+
+type JoopMfaChannel = 'totp' | 'sms' | 'email' | 'biometric' | 'backup';
+interface JoopMfaChallenge {
+    id: string;
+    channel: JoopMfaChannel;
+    destination?: string;
+    expiresAt: number;
+    attempts: number;
+    maxAttempts: number;
+    verified: boolean;
+}
+interface JoopMfaVerifyResult {
+    success: boolean;
+    reason?: string;
+    attemptsLeft?: number;
+}
+interface JoopMfaTotpSetup {
+    secret: string;
+    uri: string;
+    backupCodes: string[];
+}
+declare class JoopMfaService {
+    private _otp;
+    private _bio;
+    private _challenges;
+    private _expired$;
+    generateTotpSecret(length?: number): string;
+    getTotpUri(secret: string, account: string, issuer?: string): string;
+    setupTotp(account: string, issuer?: string): Promise<JoopMfaTotpSetup>;
+    verifyTotp(token: string, secret: string, window?: number): Promise<boolean>;
+    createChallenge(destination: string, channel: 'sms' | 'email', ttlMs?: number, maxAttempts?: number): JoopMfaChallenge & {
+        _code: string;
+    };
+    /** Get the OTP code for a challenge (pass to your SMS/email sendFn) */
+    getChallengeOtp(challengeId: string): string | null;
+    verifyChallenge(challengeId: string, token: string): JoopMfaVerifyResult;
+    generateBackupCodes(count?: number, length?: number): string[];
+    hashBackupCodes(codes: string[]): Promise<string[]>;
+    verifyBackupCode(code: string, hashedCodes: string[]): Promise<{
+        valid: boolean;
+        remaining: string[];
+    }>;
+    isBiometricAvailable(): Promise<boolean>;
+    registerBiometric(userId: string, displayName?: string): Promise<PublicKeyCredential>;
+    verifyBiometric(credentialId: string): Promise<boolean>;
+    onChallengeExpired(handler: (id: string) => void): () => void;
+    clearExpiredChallenges(): number;
+    getChallenge(id: string): JoopMfaChallenge | null;
+}
+
+interface JoopOIDCConfig {
+    issuer: string;
+    clientId: string;
+    redirectUri: string;
+    scope?: string;
+    responseType?: string;
+    /**
+     * Storage for PKCE verifier, state, and tokens.
+     * Accepts any JoopStorageAdapter (localStorage, sessionStorage, MMKV, custom).
+     * Default: sessionStorage on web, JoopPlatform.getSessionStorage() on other platforms.
+     */
+    storage?: JoopStorageAdapter;
+}
+interface JoopOIDCMetadata {
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    jwksUri: string;
+    userInfoEndpoint?: string;
+    endSessionEndpoint?: string;
+}
+interface JoopOIDCTokens {
+    accessToken: string;
+    idToken?: string;
+    refreshToken?: string;
+    expiresAt: number;
+    tokenType: string;
+    scope?: string;
+}
+interface JoopLoginOptions {
+    prompt?: 'none' | 'login' | 'consent' | 'select_account';
+    loginHint?: string;
+    state?: string;
+    nonce?: string;
+    extraParams?: Record<string, string>;
+}
+declare class JoopOIDCClient {
+    private _cfg;
+    private _metadata;
+    private _tokens$;
+    private _storage;
+    private _renewTimer;
+    private readonly _KEY;
+    private readonly _VER_KEY;
+    private readonly _STATE_KEY;
+    constructor(config: JoopOIDCConfig);
+    discover(): Promise<JoopOIDCMetadata>;
+    login(options?: JoopLoginOptions): Promise<void>;
+    /** Returns the authorization URL without redirecting (useful for React Native) */
+    buildLoginUrl(options?: JoopLoginOptions): Promise<string>;
+    handleCallback(url?: string): Promise<JoopOIDCTokens>;
+    refreshToken(): Promise<JoopOIDCTokens>;
+    getUserInfo(): Promise<Record<string, unknown>>;
+    logout(options?: {
+        redirectUri?: string;
+    }): Promise<void>;
+    silentRenew(renewBeforeMs?: number): void;
+    isAuthenticated(): boolean;
+    getTokens(): JoopOIDCTokens | null;
+    tokens$(): JoopObservable<JoopOIDCTokens | null>;
+    private _storeTokens;
+}
+
+export { JoopTokenService as J, JoopPKCEService as a, JoopOtpService as b, JoopBiometricService as c, JoopMfaService as d, JoopOIDCClient as e, type JoopLoginOptions as f, type JoopMfaChallenge as g, type JoopMfaTotpSetup as h, type JoopMfaVerifyResult as i, type JoopOIDCConfig as j, type JoopOIDCMetadata as k, type JoopOIDCTokens as l, type JoopPKCEParams as m, type JoopTokenPayload as n };

package/dist/oidc-client-DxhyE59t.d.ts

@@ -0,0 +1,190 @@
+import { J as JoopObservable } from './index-Dz0gOur2.js';
+import { d as JoopStorageAdapter } from './adapters-B6slG6hQ.js';
+
+interface JoopTokenPayload {
+    sub?: string;
+    exp?: number;
+    iat?: number;
+    jti?: string;
+    [key: string]: unknown;
+}
+declare class JoopTokenService {
+    private _access;
+    private _refresh;
+    private _refreshCb;
+    private _timer;
+    setTokens(accessToken: string, refreshToken: string): void;
+    getAccessToken(): string;
+    getRefreshToken(): string;
+    decode(token: string): JoopTokenPayload | null;
+    isExpired(token?: string): boolean;
+    expiresInMs(token?: string): number;
+    onRefreshNeeded(callback: (refreshToken: string) => Promise<string>): void;
+    refreshNow(): Promise<string>;
+    clear(): void;
+    private _scheduleRefresh;
+}
+
+interface JoopPKCEParams {
+    codeVerifier: string;
+    codeChallenge: string;
+    codeChallengeMethod: 'S256';
+}
+declare class JoopPKCEService {
+    private _verifier;
+    generate(): Promise<JoopPKCEParams>;
+    getVerifier(): string;
+    generateState(): string;
+    buildAuthUrl(baseUrl: string, params: {
+        clientId: string;
+        redirectUri: string;
+        scope: string;
+        state: string;
+        codeChallenge: string;
+    }): string;
+    private _base64url;
+}
+
+declare class JoopOtpService {
+    private readonly _period;
+    private readonly _digits;
+    generateTOTP(secretBase32: string, time?: number): Promise<string>;
+    verifyTOTP(token: string, secretBase32: string, window?: number): Promise<boolean>;
+    generateNumericOTP(length?: number): string;
+    generateAlphanumericOTP(length?: number): string;
+    private _hotp;
+    private _base32Decode;
+}
+
+declare class JoopBiometricService {
+    isSupported(): boolean;
+    isAvailable(): Promise<boolean>;
+    register(options: {
+        rpId: string;
+        rpName: string;
+        userId: string;
+        userName: string;
+        userDisplayName: string;
+        challenge: ArrayBuffer;
+    }): Promise<PublicKeyCredential>;
+    authenticate(options: {
+        rpId: string;
+        challenge: ArrayBuffer;
+        allowCredentials?: PublicKeyCredentialDescriptor[];
+    }): Promise<PublicKeyCredential>;
+    generateChallenge(): ArrayBuffer;
+    credentialIdToBase64(id: ArrayBuffer): string;
+}
+
+type JoopMfaChannel = 'totp' | 'sms' | 'email' | 'biometric' | 'backup';
+interface JoopMfaChallenge {
+    id: string;
+    channel: JoopMfaChannel;
+    destination?: string;
+    expiresAt: number;
+    attempts: number;
+    maxAttempts: number;
+    verified: boolean;
+}
+interface JoopMfaVerifyResult {
+    success: boolean;
+    reason?: string;
+    attemptsLeft?: number;
+}
+interface JoopMfaTotpSetup {
+    secret: string;
+    uri: string;
+    backupCodes: string[];
+}
+declare class JoopMfaService {
+    private _otp;
+    private _bio;
+    private _challenges;
+    private _expired$;
+    generateTotpSecret(length?: number): string;
+    getTotpUri(secret: string, account: string, issuer?: string): string;
+    setupTotp(account: string, issuer?: string): Promise<JoopMfaTotpSetup>;
+    verifyTotp(token: string, secret: string, window?: number): Promise<boolean>;
+    createChallenge(destination: string, channel: 'sms' | 'email', ttlMs?: number, maxAttempts?: number): JoopMfaChallenge & {
+        _code: string;
+    };
+    /** Get the OTP code for a challenge (pass to your SMS/email sendFn) */
+    getChallengeOtp(challengeId: string): string | null;
+    verifyChallenge(challengeId: string, token: string): JoopMfaVerifyResult;
+    generateBackupCodes(count?: number, length?: number): string[];
+    hashBackupCodes(codes: string[]): Promise<string[]>;
+    verifyBackupCode(code: string, hashedCodes: string[]): Promise<{
+        valid: boolean;
+        remaining: string[];
+    }>;
+    isBiometricAvailable(): Promise<boolean>;
+    registerBiometric(userId: string, displayName?: string): Promise<PublicKeyCredential>;
+    verifyBiometric(credentialId: string): Promise<boolean>;
+    onChallengeExpired(handler: (id: string) => void): () => void;
+    clearExpiredChallenges(): number;
+    getChallenge(id: string): JoopMfaChallenge | null;
+}
+
+interface JoopOIDCConfig {
+    issuer: string;
+    clientId: string;
+    redirectUri: string;
+    scope?: string;
+    responseType?: string;
+    /**
+     * Storage for PKCE verifier, state, and tokens.
+     * Accepts any JoopStorageAdapter (localStorage, sessionStorage, MMKV, custom).
+     * Default: sessionStorage on web, JoopPlatform.getSessionStorage() on other platforms.
+     */
+    storage?: JoopStorageAdapter;
+}
+interface JoopOIDCMetadata {
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    jwksUri: string;
+    userInfoEndpoint?: string;
+    endSessionEndpoint?: string;
+}
+interface JoopOIDCTokens {
+    accessToken: string;
+    idToken?: string;
+    refreshToken?: string;
+    expiresAt: number;
+    tokenType: string;
+    scope?: string;
+}
+interface JoopLoginOptions {
+    prompt?: 'none' | 'login' | 'consent' | 'select_account';
+    loginHint?: string;
+    state?: string;
+    nonce?: string;
+    extraParams?: Record<string, string>;
+}
+declare class JoopOIDCClient {
+    private _cfg;
+    private _metadata;
+    private _tokens$;
+    private _storage;
+    private _renewTimer;
+    private readonly _KEY;
+    private readonly _VER_KEY;
+    private readonly _STATE_KEY;
+    constructor(config: JoopOIDCConfig);
+    discover(): Promise<JoopOIDCMetadata>;
+    login(options?: JoopLoginOptions): Promise<void>;
+    /** Returns the authorization URL without redirecting (useful for React Native) */
+    buildLoginUrl(options?: JoopLoginOptions): Promise<string>;
+    handleCallback(url?: string): Promise<JoopOIDCTokens>;
+    refreshToken(): Promise<JoopOIDCTokens>;
+    getUserInfo(): Promise<Record<string, unknown>>;
+    logout(options?: {
+        redirectUri?: string;
+    }): Promise<void>;
+    silentRenew(renewBeforeMs?: number): void;
+    isAuthenticated(): boolean;
+    getTokens(): JoopOIDCTokens | null;
+    tokens$(): JoopObservable<JoopOIDCTokens | null>;
+    private _storeTokens;
+}
+
+export { JoopTokenService as J, JoopPKCEService as a, JoopOtpService as b, JoopBiometricService as c, JoopMfaService as d, JoopOIDCClient as e, type JoopLoginOptions as f, type JoopMfaChallenge as g, type JoopMfaTotpSetup as h, type JoopMfaVerifyResult as i, type JoopOIDCConfig as j, type JoopOIDCMetadata as k, type JoopOIDCTokens as l, type JoopPKCEParams as m, type JoopTokenPayload as n };

package/dist/platform/index.d.mts

@@ -0,0 +1,73 @@
+import { n as JoopPlatformAdapterConfig, d as JoopStorageAdapter } from '../adapters-B6slG6hQ.mjs';
+export { k as JoopCompressionAdapter, l as JoopCompressionFormat, m as JoopCryptoAdapter, o as JoopWorkerAdapter } from '../adapters-B6slG6hQ.mjs';
+
+type JoopPlatformType = 'web' | 'react-native' | 'node' | 'unknown';
+interface JoopCapabilities {
+    compression: boolean;
+    workers: boolean;
+    cryptoSubtle: boolean;
+    persistentStorage: boolean;
+    dom: boolean;
+    serviceWorker: boolean;
+}
+interface JoopPlatformConfig {
+    adapter?: JoopPlatformAdapterConfig;
+    /** Override auto-detection — useful in tests or SSR */
+    platform?: JoopPlatformType;
+}
+declare class JoopPlatform {
+    private static _type;
+    private static _adapter;
+    private static _memStorage;
+    /**
+     * Call once at app startup to configure adapters for your platform.
+     *
+     * Web (default — no call needed):
+     *   JoopPlatform.init();
+     *
+     * React Native with react-native-mmkv:
+     *   import { MMKV } from 'react-native-mmkv';
+     *   const mmkv = new MMKV();
+     *   JoopPlatform.init({ adapter: { storage: mmkv } });
+     *
+     * React Native with custom compression (fflate):
+     *   import { gzip, ungzip } from 'fflate';
+     *   JoopPlatform.init({
+     *     adapter: {
+     *       compression: {
+     *         compress: (d, fmt) => new Promise((res, rej) => gzip(d, (e, r) => e ? rej(e) : res(r))),
+     *         decompress: (d, fmt) => new Promise((res, rej) => ungzip(d, (e, r) => e ? rej(e) : res(r))),
+     *       },
+     *     },
+     *   });
+     */
+    static init(config?: JoopPlatformConfig): void;
+    /** Current detected or overridden platform type */
+    static get type(): JoopPlatformType;
+    static is(type: JoopPlatformType): boolean;
+    static isMobile(): boolean;
+    static isWeb(): boolean;
+    static isNode(): boolean;
+    /** Raw adapter config registered via init() */
+    static getAdapter(): JoopPlatformAdapterConfig;
+    /**
+     * Returns the best available storage adapter:
+     *   1. Custom adapter registered via init()
+     *   2. localStorage (web)
+     *   3. In-memory fallback (Node / RN without adapter)
+     */
+    static getStorage(): JoopStorageAdapter;
+    /**
+     * Returns the best available session-scoped storage:
+     *   1. Custom adapter registered via init()
+     *   2. sessionStorage (web)
+     *   3. Shared in-memory fallback
+     */
+    static getSessionStorage(): JoopStorageAdapter;
+    /** What APIs are available in the current environment */
+    static capabilities(): JoopCapabilities;
+    /** Reset to auto-detected defaults — useful between tests */
+    static _reset(): void;
+}
+
+export { type JoopCapabilities, JoopPlatform, JoopPlatformAdapterConfig, type JoopPlatformConfig, type JoopPlatformType, JoopStorageAdapter };

package/dist/platform/index.d.ts

@@ -0,0 +1,73 @@
+import { n as JoopPlatformAdapterConfig, d as JoopStorageAdapter } from '../adapters-B6slG6hQ.js';
+export { k as JoopCompressionAdapter, l as JoopCompressionFormat, m as JoopCryptoAdapter, o as JoopWorkerAdapter } from '../adapters-B6slG6hQ.js';
+
+type JoopPlatformType = 'web' | 'react-native' | 'node' | 'unknown';
+interface JoopCapabilities {
+    compression: boolean;
+    workers: boolean;
+    cryptoSubtle: boolean;
+    persistentStorage: boolean;
+    dom: boolean;
+    serviceWorker: boolean;
+}
+interface JoopPlatformConfig {
+    adapter?: JoopPlatformAdapterConfig;
+    /** Override auto-detection — useful in tests or SSR */
+    platform?: JoopPlatformType;
+}
+declare class JoopPlatform {
+    private static _type;
+    private static _adapter;
+    private static _memStorage;
+    /**
+     * Call once at app startup to configure adapters for your platform.
+     *
+     * Web (default — no call needed):
+     *   JoopPlatform.init();
+     *
+     * React Native with react-native-mmkv:
+     *   import { MMKV } from 'react-native-mmkv';
+     *   const mmkv = new MMKV();
+     *   JoopPlatform.init({ adapter: { storage: mmkv } });
+     *
+     * React Native with custom compression (fflate):
+     *   import { gzip, ungzip } from 'fflate';
+     *   JoopPlatform.init({
+     *     adapter: {
+     *       compression: {
+     *         compress: (d, fmt) => new Promise((res, rej) => gzip(d, (e, r) => e ? rej(e) : res(r))),
+     *         decompress: (d, fmt) => new Promise((res, rej) => ungzip(d, (e, r) => e ? rej(e) : res(r))),
+     *       },
+     *     },
+     *   });
+     */
+    static init(config?: JoopPlatformConfig): void;
+    /** Current detected or overridden platform type */
+    static get type(): JoopPlatformType;
+    static is(type: JoopPlatformType): boolean;
+    static isMobile(): boolean;
+    static isWeb(): boolean;
+    static isNode(): boolean;
+    /** Raw adapter config registered via init() */
+    static getAdapter(): JoopPlatformAdapterConfig;
+    /**
+     * Returns the best available storage adapter:
+     *   1. Custom adapter registered via init()
+     *   2. localStorage (web)
+     *   3. In-memory fallback (Node / RN without adapter)
+     */
+    static getStorage(): JoopStorageAdapter;
+    /**
+     * Returns the best available session-scoped storage:
+     *   1. Custom adapter registered via init()
+     *   2. sessionStorage (web)
+     *   3. Shared in-memory fallback
+     */
+    static getSessionStorage(): JoopStorageAdapter;
+    /** What APIs are available in the current environment */
+    static capabilities(): JoopCapabilities;
+    /** Reset to auto-detected defaults — useful between tests */
+    static _reset(): void;
+}
+
+export { type JoopCapabilities, JoopPlatform, JoopPlatformAdapterConfig, type JoopPlatformConfig, type JoopPlatformType, JoopStorageAdapter };

package/dist/platform/index.js

@@ -0,0 +1,127 @@
+'use strict';
+
+// src/platform/platform.ts
+var _webStorage = (store) => ({
+  getItem: (k) => store.getItem(k),
+  setItem: (k, v) => store.setItem(k, v),
+  removeItem: (k) => store.removeItem(k),
+  clear: () => store.clear()
+});
+var _MemStorageImpl = class {
+  _m = /* @__PURE__ */ new Map();
+  getItem(k) {
+    return this._m.get(k) ?? null;
+  }
+  setItem(k, v) {
+    this._m.set(k, v);
+  }
+  removeItem(k) {
+    this._m.delete(k);
+  }
+  clear() {
+    this._m.clear();
+  }
+};
+function _detect() {
+  if (typeof navigator !== "undefined" && navigator.product === "ReactNative") return "react-native";
+  const _proc = globalThis["process"];
+  if (typeof window === "undefined" && _proc?.versions?.node) return "node";
+  if (typeof window !== "undefined") return "web";
+  return "unknown";
+}
+var JoopPlatform = class {
+  static _type = _detect();
+  static _adapter = {};
+  static _memStorage = null;
+  /**
+   * Call once at app startup to configure adapters for your platform.
+   *
+   * Web (default — no call needed):
+   *   JoopPlatform.init();
+   *
+   * React Native with react-native-mmkv:
+   *   import { MMKV } from 'react-native-mmkv';
+   *   const mmkv = new MMKV();
+   *   JoopPlatform.init({ adapter: { storage: mmkv } });
+   *
+   * React Native with custom compression (fflate):
+   *   import { gzip, ungzip } from 'fflate';
+   *   JoopPlatform.init({
+   *     adapter: {
+   *       compression: {
+   *         compress: (d, fmt) => new Promise((res, rej) => gzip(d, (e, r) => e ? rej(e) : res(r))),
+   *         decompress: (d, fmt) => new Promise((res, rej) => ungzip(d, (e, r) => e ? rej(e) : res(r))),
+   *       },
+   *     },
+   *   });
+   */
+  static init(config = {}) {
+    if (config.platform) this._type = config.platform;
+    this._adapter = { ...this._adapter, ...config.adapter ?? {} };
+  }
+  /** Current detected or overridden platform type */
+  static get type() {
+    return this._type;
+  }
+  static is(type) {
+    return this._type === type;
+  }
+  static isMobile() {
+    return this._type === "react-native";
+  }
+  static isWeb() {
+    return this._type === "web";
+  }
+  static isNode() {
+    return this._type === "node";
+  }
+  /** Raw adapter config registered via init() */
+  static getAdapter() {
+    return this._adapter;
+  }
+  /**
+   * Returns the best available storage adapter:
+   *   1. Custom adapter registered via init()
+   *   2. localStorage (web)
+   *   3. In-memory fallback (Node / RN without adapter)
+   */
+  static getStorage() {
+    if (this._adapter.storage) return this._adapter.storage;
+    if (typeof localStorage !== "undefined") return _webStorage(localStorage);
+    if (!this._memStorage) this._memStorage = new _MemStorageImpl();
+    return this._memStorage;
+  }
+  /**
+   * Returns the best available session-scoped storage:
+   *   1. Custom adapter registered via init()
+   *   2. sessionStorage (web)
+   *   3. Shared in-memory fallback
+   */
+  static getSessionStorage() {
+    if (this._adapter.storage) return this._adapter.storage;
+    if (typeof sessionStorage !== "undefined") return _webStorage(sessionStorage);
+    if (!this._memStorage) this._memStorage = new _MemStorageImpl();
+    return this._memStorage;
+  }
+  /** What APIs are available in the current environment */
+  static capabilities() {
+    return {
+      compression: typeof CompressionStream !== "undefined" || !!this._adapter.compression,
+      workers: typeof Worker !== "undefined" || !!this._adapter.worker,
+      cryptoSubtle: !!(typeof globalThis !== "undefined" && globalThis.crypto?.subtle),
+      persistentStorage: typeof localStorage !== "undefined" || !!this._adapter.storage,
+      dom: typeof document !== "undefined",
+      serviceWorker: typeof navigator !== "undefined" && "serviceWorker" in navigator
+    };
+  }
+  /** Reset to auto-detected defaults — useful between tests */
+  static _reset() {
+    this._type = _detect();
+    this._adapter = {};
+    this._memStorage = null;
+  }
+};
+
+exports.JoopPlatform = JoopPlatform;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/platform/platform.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { JoopPlatformAdapterConfig, JoopStorageAdapter } from './adapters';\n\nexport type JoopPlatformType = 'web' | 'react-native' | 'node' | 'unknown';\n\nexport interface JoopCapabilities {\n  compression: boolean;\n  workers: boolean;\n  cryptoSubtle: boolean;\n  persistentStorage: boolean;\n  dom: boolean;\n  serviceWorker: boolean;\n}\n\nexport interface JoopPlatformConfig {\n  adapter?: JoopPlatformAdapterConfig;\n  /** Override auto-detection — useful in tests or SSR */\n  platform?: JoopPlatformType;\n}\n\n// ---------------------------------------------------------------------------\n// Built-in storage adapters\n// ---------------------------------------------------------------------------\n\nconst _webStorage = (store: Storage): JoopStorageAdapter => ({\n  getItem:    (k) => store.getItem(k),\n  setItem:    (k, v) => store.setItem(k, v),\n  removeItem: (k) => store.removeItem(k),\n  clear:      () => store.clear(),\n});\n\nclass _MemStorageImpl implements JoopStorageAdapter {\n  private _m = new Map<string, string>();\n  getItem(k: string)         { return this._m.get(k) ?? null; }\n  setItem(k: string, v: string) { this._m.set(k, v); }\n  removeItem(k: string)      { this._m.delete(k); }\n  clear()                    { this._m.clear(); }\n}\n\n// ---------------------------------------------------------------------------\n// Platform detection\n// ---------------------------------------------------------------------------\n\nfunction _detect(): JoopPlatformType {\n  // React Native sets navigator.product = 'ReactNative'\n  if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') return 'react-native';\n  // Node.js: no window, has globalThis.process.versions.node\n  const _proc = (globalThis as Record<string, unknown>)['process'] as { versions?: { node?: string } } | undefined;\n  if (typeof window === 'undefined' && _proc?.versions?.node) return 'node';\n  // Browser\n  if (typeof window !== 'undefined') return 'web';\n  return 'unknown';\n}\n\n// ---------------------------------------------------------------------------\n// JoopPlatform\n// ---------------------------------------------------------------------------\n\nexport class JoopPlatform {\n  private static _type: JoopPlatformType = _detect();\n  private static _adapter: JoopPlatformAdapterConfig = {};\n  private static _memStorage: JoopStorageAdapter | null = null;\n\n  /**\n   * Call once at app startup to configure adapters for your platform.\n   *\n   * Web (default — no call needed):\n   *   JoopPlatform.init();\n   *\n   * React Native with react-native-mmkv:\n   *   import { MMKV } from 'react-native-mmkv';\n   *   const mmkv = new MMKV();\n   *   JoopPlatform.init({ adapter: { storage: mmkv } });\n   *\n   * React Native with custom compression (fflate):\n   *   import { gzip, ungzip } from 'fflate';\n   *   JoopPlatform.init({\n   *     adapter: {\n   *       compression: {\n   *         compress: (d, fmt) => new Promise((res, rej) => gzip(d, (e, r) => e ? rej(e) : res(r))),\n   *         decompress: (d, fmt) => new Promise((res, rej) => ungzip(d, (e, r) => e ? rej(e) : res(r))),\n   *       },\n   *     },\n   *   });\n   */\n  static init(config: JoopPlatformConfig = {}): void {\n    if (config.platform) this._type = config.platform;\n    this._adapter = { ...this._adapter, ...(config.adapter ?? {}) };\n  }\n\n  /** Current detected or overridden platform type */\n  static get type(): JoopPlatformType { return this._type; }\n\n  static is(type: JoopPlatformType): boolean { return this._type === type; }\n  static isMobile(): boolean  { return this._type === 'react-native'; }\n  static isWeb(): boolean     { return this._type === 'web'; }\n  static isNode(): boolean    { return this._type === 'node'; }\n\n  /** Raw adapter config registered via init() */\n  static getAdapter(): JoopPlatformAdapterConfig { return this._adapter; }\n\n  /**\n   * Returns the best available storage adapter:\n   *   1. Custom adapter registered via init()\n   *   2. localStorage (web)\n   *   3. In-memory fallback (Node / RN without adapter)\n   */\n  static getStorage(): JoopStorageAdapter {\n    if (this._adapter.storage) return this._adapter.storage;\n    if (typeof localStorage !== 'undefined') return _webStorage(localStorage);\n    if (!this._memStorage) this._memStorage = new _MemStorageImpl();\n    return this._memStorage;\n  }\n\n  /**\n   * Returns the best available session-scoped storage:\n   *   1. Custom adapter registered via init()\n   *   2. sessionStorage (web)\n   *   3. Shared in-memory fallback\n   */\n  static getSessionStorage(): JoopStorageAdapter {\n    if (this._adapter.storage) return this._adapter.storage;\n    if (typeof sessionStorage !== 'undefined') return _webStorage(sessionStorage);\n    if (!this._memStorage) this._memStorage = new _MemStorageImpl();\n    return this._memStorage;\n  }\n\n  /** What APIs are available in the current environment */\n  static capabilities(): JoopCapabilities {\n    return {\n      compression:      typeof CompressionStream !== 'undefined' || !!this._adapter.compression,\n      workers:          typeof Worker !== 'undefined' || !!this._adapter.worker,\n      cryptoSubtle:     !!(typeof globalThis !== 'undefined' && (globalThis as typeof globalThis & { crypto?: Crypto }).crypto?.subtle),\n      persistentStorage: typeof localStorage !== 'undefined' || !!this._adapter.storage,\n      dom:              typeof document !== 'undefined',\n      serviceWorker:    typeof navigator !== 'undefined' && 'serviceWorker' in navigator,\n    };\n  }\n\n  /** Reset to auto-detected defaults — useful between tests */\n  static _reset(): void {\n    this._type = _detect();\n    this._adapter = {};\n    this._memStorage = null;\n  }\n}\n"]}