@majikah/majik-universal-id-client 0.0.16 → 0.1.0

package/dist/core/client-state-manager.d.ts

@@ -24,82 +24,26 @@
  * hydrate() pass. Callers should never need to hydrate() again unless the
  * adapter is swapped.
  */
-import { AccountOrderValue, ClientStateEntry, ClientStateStorageAdapter } from "./storage/client-state/_types";
-export declare class ClientStateManager {
-    /** In-memory cache — warmed by hydrate(), kept in sync on every write. */
-    private _cache;
-    private _adapter;
-    /**
-     * @param adapter Defaults to InMemoryClientStateAdapter (non-persistent).
-     *   Pass IDBClientStateAdapter or SQLiteClientStateAdapter for persistence.
-     */
+import { MajikKeyClientStateManager } from "@majikah/majik-key-client";
+import { ClientStateStorageAdapter, UserAppPreferences } from "./storage/client-state/_types";
+export declare class ClientStateManager extends MajikKeyClientStateManager {
     constructor(adapter?: ClientStateStorageAdapter);
-    get adapter(): ClientStateStorageAdapter;
-    /**
-     * Swap the storage adapter at runtime.
-     *
-     * Does NOT migrate data. To migrate:
-     * ```ts
-     * const entries = stateManager.listCachedEntries();
-     * stateManager.setAdapter(newAdapter);
-     * await stateManager.hydrate();
-     * await stateManager.bulkSet(entries);
-     * ```
-     */
-    setAdapter(adapter: ClientStateStorageAdapter): void;
-    /**
-     * Load all entries from the adapter into the in-memory cache.
-     * Call once after construction (MajikBuwizClient.hydrate() does this).
-     */
-    hydrate(): Promise<void>;
-    /**
-     * Retrieve a raw JSON string for any key. Returns `null` if not found.
-     * Prefer the typed accessors (getAccountOrder, getInvoiceDefaults) over this.
-     */
-    get(id: string): Promise<string | null>;
-    /**
-     * Persist a raw JSON string for any key.
-     * Prefer the typed accessors over this.
-     */
-    set(id: string, value: string): Promise<void>;
-    /**
-     * Remove a single key.
-     */
-    remove(id: string): Promise<boolean>;
-    /**
-     * Remove all stored state.
-     */
-    clear(): Promise<void>;
-    /**
-     * Whether a key exists in the cache.
-     * Accurate after hydrate(); use exists() for an authoritative adapter check.
-     */
-    hasCached(id: string): boolean;
-    /**
-     * Authoritative existence check against the adapter.
-     */
-    exists(id: string): Promise<boolean>;
-    /**
-     * Snapshot of all cached entries — useful for adapter migration.
-     */
-    listCachedEntries(): ClientStateEntry[];
     /**
-     * Persist multiple entries in one adapter call.
+     * Retrieve user app preferences.
+     * Returns `null` if none have been saved yet.
      */
-    bulkSet(entries: ClientStateEntry[]): Promise<void>;
+    getUserAppPreferences(): Promise<UserAppPreferences>;
     /**
-     * Retrieve the ordered list of own account IDs.
-     * Returns `null` if no order has been persisted yet.
+     * Persist user app preferences.
      */
-    getAccountOrder(): Promise<AccountOrderValue | null>;
+    setUserAppPreferences(preferences: UserAppPreferences): Promise<void>;
     /**
-     * Persist the ordered list of own account IDs.
+     * Persist user app preferences.
      */
-    setAccountOrder(order: AccountOrderValue): Promise<void>;
+    resetUserAppPreferences(): Promise<void>;
     /**
-     * Remove the persisted account order (resets to insertion order on next
-     * hydrate).
+     * Remove user app preferences.
      */
-    removeAccountOrder(): Promise<void>;
-    count(): Promise<number>;
+    removeUserAppPreferences(): Promise<void>;
 }
+export declare const DEFAULT_USER_APP_PREFERENCES: UserAppPreferences;

package/dist/core/client-state-manager.js

@@ -24,227 +24,65 @@
  * hydrate() pass. Callers should never need to hydrate() again unless the
  * adapter is swapped.
  */
+import { MajikKeyClientStateManager } from "@majikah/majik-key-client";
 import { CLIENT_STATE_KEYS, } from "./storage/client-state/_types";
 import { InMemoryClientStateAdapter } from "./storage/client-state/adapter-memory";
 // ---------------------------------------------------------------------------
 // ClientStateManager
 // ---------------------------------------------------------------------------
-export class ClientStateManager {
-    /** In-memory cache — warmed by hydrate(), kept in sync on every write. */
-    _cache = new Map();
-    _adapter;
-    /**
-     * @param adapter Defaults to InMemoryClientStateAdapter (non-persistent).
-     *   Pass IDBClientStateAdapter or SQLiteClientStateAdapter for persistence.
-     */
+export class ClientStateManager extends MajikKeyClientStateManager {
     constructor(adapter = new InMemoryClientStateAdapter()) {
-        this._adapter = adapter;
-    }
-    // ── Adapter management ────────────────────────────────────────────────────
-    get adapter() {
-        return this._adapter;
+        super(adapter);
     }
     /**
-     * Swap the storage adapter at runtime.
-     *
-     * Does NOT migrate data. To migrate:
-     * ```ts
-     * const entries = stateManager.listCachedEntries();
-     * stateManager.setAdapter(newAdapter);
-     * await stateManager.hydrate();
-     * await stateManager.bulkSet(entries);
-     * ```
+     * Retrieve user app preferences.
+     * Returns `null` if none have been saved yet.
      */
-    setAdapter(adapter) {
-        this._adapter = adapter;
-    }
-    // ── Hydration ─────────────────────────────────────────────────────────────
-    /**
-     * Load all entries from the adapter into the in-memory cache.
-     * Call once after construction (MajikBuwizClient.hydrate() does this).
-     */
-    async hydrate() {
-        const entries = await this._adapter.list();
-        this._cache.clear();
-        for (const entry of entries) {
-            this._cache.set(entry.id, entry.value);
+    async getUserAppPreferences() {
+        const raw = await this.get(CLIENT_STATE_KEYS.USER_APP_PREFERENCES);
+        if (raw === null) {
+            await this.resetUserAppPreferences();
+            return DEFAULT_USER_APP_PREFERENCES;
         }
-    }
-    // ── Generic typed get / set / remove ─────────────────────────────────────
-    /**
-     * Retrieve a raw JSON string for any key. Returns `null` if not found.
-     * Prefer the typed accessors (getAccountOrder, getInvoiceDefaults) over this.
-     */
-    async get(id) {
-        const cached = this._cache.get(id);
-        if (cached !== undefined)
-            return cached;
-        // Cache miss — should not happen after hydrate() but defensive
-        const entry = await this._adapter.getById(id);
-        if (!entry)
-            return null;
-        this._cache.set(id, entry.value);
-        return entry.value;
-    }
-    /**
-     * Persist a raw JSON string for any key.
-     * Prefer the typed accessors over this.
-     */
-    async set(id, value) {
-        const entry = { id, value };
-        await this._adapter.save(entry);
-        this._cache.set(id, value);
-    }
-    /**
-     * Remove a single key.
-     */
-    async remove(id) {
-        const removed = await this._adapter.remove(id);
-        this._cache.delete(id);
-        return removed;
-    }
-    /**
-     * Remove all stored state.
-     */
-    async clear() {
-        await this._adapter.clear();
-        this._cache.clear();
-    }
-    /**
-     * Whether a key exists in the cache.
-     * Accurate after hydrate(); use exists() for an authoritative adapter check.
-     */
-    hasCached(id) {
-        return this._cache.has(id);
-    }
-    /**
-     * Authoritative existence check against the adapter.
-     */
-    async exists(id) {
-        if (this._cache.has(id))
-            return true;
-        return this._adapter.exists(id);
-    }
-    /**
-     * Snapshot of all cached entries — useful for adapter migration.
-     */
-    listCachedEntries() {
-        return Array.from(this._cache.entries()).map(([id, value]) => ({
-            id,
-            value,
-        }));
-    }
-    /**
-     * Persist multiple entries in one adapter call.
-     */
-    async bulkSet(entries) {
-        if (entries.length === 0)
-            return;
-        await this._adapter.bulkSave(entries);
-        for (const e of entries)
-            this._cache.set(e.id, e.value);
-    }
-    // ── Typed: account order ──────────────────────────────────────────────────
-    /**
-     * Retrieve the ordered list of own account IDs.
-     * Returns `null` if no order has been persisted yet.
-     */
-    async getAccountOrder() {
-        const raw = await this.get(CLIENT_STATE_KEYS.ACCOUNT_ORDER);
-        if (raw === null)
-            return null;
         try {
-            return JSON.parse(raw);
+            return {
+                ...DEFAULT_USER_APP_PREFERENCES,
+                ...JSON.parse(raw),
+            };
         }
-        catch {
-            console.warn("ClientStateManager: malformed account order — discarding.");
-            return null;
+        catch (e) {
+            console.warn("ClientStateManager: Problem retrieving user app preferences: ", e);
+            return DEFAULT_USER_APP_PREFERENCES;
         }
     }
     /**
-     * Persist the ordered list of own account IDs.
+     * Persist user app preferences.
      */
-    async setAccountOrder(order) {
-        await this.set(CLIENT_STATE_KEYS.ACCOUNT_ORDER, JSON.stringify(order));
+    async setUserAppPreferences(preferences) {
+        await this.set(CLIENT_STATE_KEYS.USER_APP_PREFERENCES, JSON.stringify(preferences));
     }
     /**
-     * Remove the persisted account order (resets to insertion order on next
-     * hydrate).
+     * Persist user app preferences.
      */
-    async removeAccountOrder() {
-        await this.remove(CLIENT_STATE_KEYS.ACCOUNT_ORDER);
+    async resetUserAppPreferences() {
+        await this.set(CLIENT_STATE_KEYS.USER_APP_PREFERENCES, JSON.stringify(DEFAULT_USER_APP_PREFERENCES));
     }
-    // ── Typed: invoice defaults ───────────────────────────────────────────────
-    // /**
-    //  * Retrieve user-configured invoice defaults.
-    //  * Returns `null` if none have been saved yet.
-    //  */
-    // async getInvoiceDefaults(): Promise<InvoiceDefaults | null> {
-    //   const raw = await this.get(CLIENT_STATE_KEYS.INVOICE_DEFAULTS);
-    //   if (raw === null) return null;
-    //   try {
-    //     return JSON.parse(raw) as InvoiceDefaults;
-    //   } catch {
-    //     console.warn(
-    //       "ClientStateManager: malformed invoice defaults — discarding.",
-    //     );
-    //     return null;
-    //   }
-    // }
-    // /**
-    //  * Persist user-configured invoice defaults.
-    //  */
-    // async setInvoiceDefaults(defaults: InvoiceDefaults): Promise<void> {
-    //   await this.set(
-    //     CLIENT_STATE_KEYS.INVOICE_DEFAULTS,
-    //     JSON.stringify(defaults),
-    //   );
-    // }
-    // /**
-    //  * Remove the persisted invoice defaults.
-    //  */
-    // async removeInvoiceDefaults(): Promise<void> {
-    //   await this.remove(CLIENT_STATE_KEYS.INVOICE_DEFAULTS);
-    // }
-    // async currentInvoiceNumber(): Promise<number> {
-    //   const current = await this.getInvoiceDefaults();
-    //   const counter = current?.invoiceNumberCounter ?? 0;
-    //   return counter;
-    // }
-    // async incrementInvoiceNumber(): Promise<number> {
-    //   // 1. Get current defaults
-    //   const current = await this.getInvoiceDefaults();
-    //   // 2. Initialize safely if missing
-    //   const counter = current?.invoiceNumberCounter ?? 0;
-    //   const updated: InvoiceDefaults = {
-    //     ...(current ?? {
-    //       currency: "PHP" as any, // fallback — adjust if you have a real default
-    //     }),
-    //     invoiceNumberCounter: counter + 1,
-    //   };
-    //   // 3. Persist
-    //   await this.setInvoiceDefaults(updated);
-    //   // 4. Return the new value (useful for generating invoice number)
-    //   return updated.invoiceNumberCounter!;
-    // }
-    // async decrementInvoiceNumber(): Promise<number> {
-    //   // 1. Get current defaults
-    //   const current = await this.getInvoiceDefaults();
-    //   // 2. Initialize safely if missing
-    //   const counter = current?.invoiceNumberCounter ?? 0;
-    //   const updated: InvoiceDefaults = {
-    //     ...(current ?? {
-    //       currency: "PHP" as any, // fallback — adjust if you have a real default
-    //     }),
-    //     invoiceNumberCounter: counter - 1,
-    //   };
-    //   // 3. Persist
-    //   await this.setInvoiceDefaults(updated);
-    //   // 4. Return the new value (useful for generating invoice number)
-    //   return updated.invoiceNumberCounter!;
-    // }
-    // ── Async count ───────────────────────────────────────────────────────────
-    async count() {
-        return this._adapter.count();
+    /**
+     * Remove user app preferences.
+     */
+    async removeUserAppPreferences() {
+        await this.remove(CLIENT_STATE_KEYS.USER_APP_PREFERENCES);
     }
 }
+export const DEFAULT_USER_APP_PREFERENCES = {
+    general: {},
+    privacy: {
+        shareAnalytics: true,
+    },
+    security: {
+        key: {
+            autoLockOnMinimize: false,
+            onetimeUnlock: true,
+        },
+    },
+};

package/dist/core/contacts/majik-contact-directory.d.ts

@@ -1,6 +1,7 @@
 import { MAJIK_API_RESPONSE } from "../types";
 import { MajikContact, MajikContactData } from "@majikah/majik-contact";
 import { MajikContactDirectoryData } from "./types";
+import { MajikKeyAddress } from "@majikah/majik-key";
 export declare class MajikContactDirectory {
     private contacts;
     private fingerprintMap;
@@ -15,7 +16,7 @@ export declare class MajikContactDirectory {
      * Get contact by public key (base64)
      * Uses MajikContact.getPublicKeyBase64() for canonical comparison
      */
-    getContactByPublicKeyBase64(publicKeyBase64: string): Promise<MajikContact | undefined>;
+    getContactByAddress(address: MajikKeyAddress): Promise<MajikContact | undefined>;
     hasFingerprint(fingerprint: string): boolean;
     listContacts(sortedByLabel?: boolean, majikahOnly?: boolean): MajikContact[];
     blockContact(id: string): MajikContact;
@@ -24,7 +25,7 @@ export declare class MajikContactDirectory {
     /**
      * Checks if a contact exists by their public key (base64)
      */
-    hasContactByPublicKeyBase64(publicKeyBase64: string): Promise<boolean>;
+    hasContactByAddress(address: MajikKeyAddress): Promise<boolean>;
     clear(): this;
     setMajikahStatus(id: string, status: boolean): MajikContact;
     isMajikahIdentityChecked(id: string): boolean;

package/dist/core/contacts/majik-contact-directory.js

@@ -23,9 +23,6 @@ export class MajikContactDirectory {
             !contact?.mlKey) {
             throw new MajikContactDirectoryError("Invalid contact");
         }
-        if (!(contact instanceof MajikContact)) {
-            throw new MajikContactDirectoryError("Invalid contact instance");
-        }
         if (this.contacts.has(contact.id)) {
             throw new MajikContactDirectoryError(`Contact with id "${contact.id}" already exists`);
         }
@@ -81,13 +78,13 @@ export class MajikContactDirectory {
      * Get contact by public key (base64)
      * Uses MajikContact.getPublicKeyBase64() for canonical comparison
      */
-    async getContactByPublicKeyBase64(publicKeyBase64) {
-        if (!publicKeyBase64 || typeof publicKeyBase64 !== "string") {
-            throw new MajikContactDirectoryError("Public key must be a non-empty base64 string");
+    async getContactByAddress(address) {
+        if (!address || typeof address !== "string") {
+            throw new MajikContactDirectoryError("Public key must be a non-empty base64 MajikKeyAddress");
         }
         for (const contact of this.contacts.values()) {
             const contactKey = await contact.getPublicKeyBase64();
-            if (contactKey === publicKeyBase64) {
+            if (contactKey === address) {
                 return contact;
             }
         }
@@ -124,11 +121,11 @@ export class MajikContactDirectory {
     /**
      * Checks if a contact exists by their public key (base64)
      */
-    async hasContactByPublicKeyBase64(publicKeyBase64) {
-        if (!publicKeyBase64 || typeof publicKeyBase64 !== "string") {
-            throw new MajikContactDirectoryError("Public key must be a non-empty base64 string");
+    async hasContactByAddress(address) {
+        if (!address || typeof address !== "string") {
+            throw new MajikContactDirectoryError("Public key must be a non-empty base64 MajikKeyAddress");
         }
-        const contact = await this.getContactByPublicKeyBase64(publicKeyBase64);
+        const contact = await this.getContactByAddress(address);
         return contact !== undefined;
     }
     clear() {

package/dist/core/contacts/majik-contact-manager.d.ts

@@ -2,11 +2,10 @@ import { MajikContact, MajikContactData, MajikContactGroup, MajikContactGroupMet
 import { MajikContactDirectory } from "./majik-contact-directory";
 import { MajikContactGroupManager } from "./majik-contact-groups";
 import { MAJIK_API_RESPONSE } from "../types";
-import { ContactManagerQueryMode, MajikContactManagerJSON } from "./types";
+import { MajikContactManagerJSON } from "./types";
 import { MajikContactStorageAdapter } from "../storage/contact-directory/contacts/_types";
 import { MajikContactGroupStorageAdapter } from "../storage/contact-directory/groups/_types";
-import { MajikRecipient } from "@majikah/majik-envelope";
-import { ExpectedSigner } from "@majikah/majik-signature";
+import { MajikKeyAddress } from "@majikah/majik-key";
 export interface MajikContactManagerAdapters {
     contacts?: MajikContactStorageAdapter;
     groups?: MajikContactGroupStorageAdapter;
@@ -84,14 +83,12 @@ export declare class MajikContactManager {
     clear(): Promise<this>;
     getContact(id: string): MajikContact | undefined;
     getContactByFingerprint(fingerprint: string): MajikContact | undefined;
-    getContactByPublicKeyBase64(publicKeyBase64: string): Promise<MajikContact | undefined>;
+    getContactByAddress(address: MajikKeyAddress): Promise<MajikContact | undefined>;
     getContactsByIds(ids: string[], strict?: boolean): MajikContact[];
     getContactsByPublicKeys(publicKeys: string[], strict?: boolean): Promise<MajikContact[]>;
-    getMajikRecipients(mode: ContactManagerQueryMode | undefined, input: string[], strict?: boolean): Promise<MajikRecipient[]>;
-    getExpectedSigners(mode: ContactManagerQueryMode | undefined, input: string[], strict?: boolean): Promise<ExpectedSigner[]>;
     hasContact(id: string): boolean;
     hasFingerprint(fingerprint: string): boolean;
-    hasContactByPublicKeyBase64(publicKeyBase64: string): Promise<boolean>;
+    hasContactByAddress(address: MajikKeyAddress): Promise<boolean>;
     listContacts(sortedByLabel?: boolean, majikahOnly?: boolean): MajikContact[];
     isMajikahRegistered(id: string): boolean;
     isMajikahIdentityChecked(id: string): boolean;

package/dist/core/contacts/majik-contact-manager.js

@@ -2,12 +2,11 @@ import { MajikContact, } from "@majikah/majik-contact";
 import { MajikContactDirectory } from "./majik-contact-directory";
 import { MajikContactGroupManager } from "./majik-contact-groups";
 import { MajikContactManagerError } from "./errors";
-import { arrayBufferToBase64, arrayToBase64, base64ToArrayBuffer, base64ToUint8Array, } from "../utils/utilities";
+import { arrayBufferToBase64, arrayToBase64, base64ToArrayBuffer, } from "../utils/utilities";
 import { KEY_ALGO } from "../crypto/constants";
 import { gunzipSync, gzipSync } from "fflate";
 import { InMemoryContactAdapter } from "../storage/contact-directory/contacts/adapter-memory";
 import { InMemoryContactGroupAdapter } from "../storage/contact-directory/groups/adapter-memory";
-import { MajikEnvelope } from "@majikah/majik-envelope";
 export class MajikContactManager {
     directory;
     groupManager;
@@ -191,8 +190,8 @@ export class MajikContactManager {
     getContactByFingerprint(fingerprint) {
         return this.directory.getContactByFingerprint(fingerprint);
     }
-    async getContactByPublicKeyBase64(publicKeyBase64) {
-        return await this.directory.getContactByPublicKeyBase64(publicKeyBase64);
+    async getContactByAddress(address) {
+        return await this.directory.getContactByAddress(address);
     }
     getContactsByIds(ids, strict = false) {
         if (!ids?.length)
@@ -219,7 +218,7 @@ export class MajikContactManager {
             return [];
         const uniqueKeys = [...new Set(publicKeys)];
         const contacts = await Promise.all(uniqueKeys.map(async (key) => {
-            const contact = await this.directory.getContactByPublicKeyBase64(key);
+            const contact = await this.directory.getContactByAddress(key);
             if (!contact && strict) {
                 throw new MajikContactManagerError(`Contact not found for publicKey: ${key}`);
             }
@@ -227,80 +226,14 @@ export class MajikContactManager {
         }));
         return contacts.filter((c) => Boolean(c));
     }
-    async getMajikRecipients(mode = "id", input, strict) {
-        if (!input?.length)
-            throw new MajikContactManagerError("At least 1 id/key is required");
-        const contacts = mode === "public_key"
-            ? await this.getContactsByPublicKeys(input, strict)
-            : this.getContactsByIds(input, strict);
-        if (!contacts || contacts.length === 0)
-            return [];
-        const recipients = [];
-        const seen = new Set();
-        const invalidContacts = [];
-        for (const contact of contacts) {
-            if (!contact)
-                continue;
-            // dedupe by fingerprint
-            if (seen.has(contact.fingerprint))
-                continue;
-            const mlPubKey = base64ToUint8Array(contact.mlKey);
-            if (!mlPubKey) {
-                invalidContacts.push(contact.fingerprint);
-                continue;
-            }
-            const builtMajikRecipient = await MajikEnvelope.buildMajikRecipientFromContact(contact);
-            recipients.push(builtMajikRecipient);
-            seen.add(contact.fingerprint);
-        }
-        if (invalidContacts.length > 0) {
-            throw new MajikContactManagerError(`Invalid ML-KEM public key for contact(s): ${invalidContacts.join(", ")}`);
-        }
-        return recipients;
-    }
-    async getExpectedSigners(mode = "id", input, strict) {
-        if (!input?.length)
-            throw new MajikContactManagerError("At least 1 id/key is required");
-        const contacts = mode === "public_key"
-            ? await this.getContactsByPublicKeys(input, strict)
-            : this.getContactsByIds(input, strict);
-        if (!contacts || contacts.length === 0)
-            return [];
-        const signers = [];
-        const seen = new Set();
-        const invalidContacts = [];
-        for (const contact of contacts) {
-            if (!contact)
-                continue;
-            // dedupe by fingerprint
-            if (seen.has(contact.fingerprint))
-                continue;
-            const mlDsaPublicKey = contact.mlDsaPublicKeyBase64;
-            if (!mlDsaPublicKey?.trim()) {
-                invalidContacts.push(contact.fingerprint);
-                continue;
-            }
-            const expectedSigner = {
-                edPublicKey: contact.edPublicKeyBase64,
-                mlDsaPublicKey: contact.mlDsaPublicKeyBase64,
-                signerId: contact.fingerprint,
-            };
-            signers.push(expectedSigner);
-            seen.add(contact.fingerprint);
-        }
-        if (invalidContacts.length > 0) {
-            throw new MajikContactManagerError(`Invalid ML-KEM public key for contact(s): ${invalidContacts.join(", ")}`);
-        }
-        return signers;
-    }
     hasContact(id) {
         return this.directory.hasContact(id);
     }
     hasFingerprint(fingerprint) {
         return this.directory.hasFingerprint(fingerprint);
     }
-    async hasContactByPublicKeyBase64(publicKeyBase64) {
-        return this.directory.hasContactByPublicKeyBase64(publicKeyBase64);
+    async hasContactByAddress(address) {
+        return this.directory.hasContactByAddress(address);
     }
     listContacts(sortedByLabel = false, majikahOnly = false) {
         return this.directory.listContacts(sortedByLabel, majikahOnly);

package/dist/core/storage/client-state/_types.d.ts

@@ -18,13 +18,49 @@ export interface ClientStateEntry {
 }
 export declare const CLIENT_STATE_KEYS: {
     readonly ACCOUNT_ORDER: "user_account_order";
+    readonly USER_APP_PREFERENCES: "user_app_preferences";
 };
 export type ClientStateKey = (typeof CLIENT_STATE_KEYS)[keyof typeof CLIENT_STATE_KEYS];
 /**
- * Ordered list of own account IDs. The head of the array is the active
- * account. Stored as a JSON array: `["id1", "id2", ...]`.
+ * User-configured app-wide preferences.
  */
-export type AccountOrderValue = string[];
+export interface UserAppPreferences {
+    general: GeneralPreferences;
+    privacy: PrivacyPreferences;
+    security: SecurityPreferences;
+}
+export interface GeneralPreferences {
+    history?: HistoryPreferences;
+}
+export interface HistoryPreferences {
+    enabled?: boolean;
+    maxCount?: number;
+}
+export interface SigningPreferences {
+    autoSeal?: boolean;
+    defaultToTSA?: boolean;
+    defaultToDetached?: boolean;
+    autosave?: {
+        afterSign?: AutosavePreferences;
+        afterSeal?: AutosavePreferences;
+        afterNotary?: AutosavePreferences;
+    };
+}
+export interface AutosavePreferences {
+    enabled?: boolean;
+    defaultPath?: string;
+}
+export interface PrivacyPreferences {
+    shareAnalytics?: boolean;
+}
+export interface SecurityPreferences {
+    key?: KeyPreferences;
+}
+export interface KeyPreferences {
+    autoLockOnMinimize?: boolean;
+    autoLockInterval?: number;
+    onetimeUnlock?: boolean;
+}
 /**
  * Pluggable persistence backend for client-level state.
  *

package/dist/core/storage/client-state/_types.js

@@ -7,10 +7,11 @@
  * ClientStateManager owns all serialisation / deserialisation logic; the
  * adapter only moves bytes.
  */
+import { BASE_CLIENT_STATE_KEYS } from "@majikah/majik-key-client";
 // ---------------------------------------------------------------------------
 // Well-known state keys
 // ---------------------------------------------------------------------------
 export const CLIENT_STATE_KEYS = {
-    ACCOUNT_ORDER: "user_account_order",
-    // INVOICE_DEFAULTS: "invoice_defaults",
+    ...BASE_CLIENT_STATE_KEYS,
+    USER_APP_PREFERENCES: "user_app_preferences",
 };