@tatchi-xyz/sdk 0.21.0 → 0.31.1

package/dist/cjs/react/src/core/EmailRecovery/emailRecoveryPendingStore.js

@@ -0,0 +1,57 @@
+const require_index = require('../IndexedDBManager/index.js');
+
+//#region src/core/EmailRecovery/emailRecoveryPendingStore.ts
+var EmailRecoveryPendingStore = class {
+	getPendingTtlMs;
+	now;
+	constructor(options) {
+		this.getPendingTtlMs = options.getPendingTtlMs;
+		this.now = options.now ?? Date.now;
+	}
+	getPendingIndexKey(accountId) {
+		return `pendingEmailRecovery:${accountId}`;
+	}
+	getPendingRecordKey(accountId, nearPublicKey) {
+		return `${this.getPendingIndexKey(accountId)}:${nearPublicKey}`;
+	}
+	async get(accountId, nearPublicKey) {
+		const pendingTtlMs = this.getPendingTtlMs();
+		const indexKey = this.getPendingIndexKey(accountId);
+		const indexedNearPublicKey = await require_index.IndexedDBManager.clientDB.getAppState(indexKey);
+		const resolvedNearPublicKey = nearPublicKey ?? indexedNearPublicKey;
+		if (!resolvedNearPublicKey) return null;
+		const recordKey = this.getPendingRecordKey(accountId, resolvedNearPublicKey);
+		const record = await require_index.IndexedDBManager.clientDB.getAppState(recordKey);
+		const shouldClearIndex = indexedNearPublicKey === resolvedNearPublicKey;
+		if (!record) {
+			if (shouldClearIndex) await require_index.IndexedDBManager.clientDB.setAppState(indexKey, void 0).catch(() => {});
+			return null;
+		}
+		if (this.now() - record.createdAt > pendingTtlMs) {
+			await require_index.IndexedDBManager.clientDB.setAppState(recordKey, void 0).catch(() => {});
+			if (shouldClearIndex) await require_index.IndexedDBManager.clientDB.setAppState(indexKey, void 0).catch(() => {});
+			return null;
+		}
+		await this.touchIndex(accountId, record.nearPublicKey);
+		return record;
+	}
+	async set(record) {
+		const key = this.getPendingRecordKey(record.accountId, record.nearPublicKey);
+		await require_index.IndexedDBManager.clientDB.setAppState(key, record);
+		await this.touchIndex(record.accountId, record.nearPublicKey);
+	}
+	async clear(accountId, nearPublicKey) {
+		const indexKey = this.getPendingIndexKey(accountId);
+		const idx = await require_index.IndexedDBManager.clientDB.getAppState(indexKey).catch(() => void 0);
+		const resolvedNearPublicKey = nearPublicKey || idx || "";
+		if (resolvedNearPublicKey) await require_index.IndexedDBManager.clientDB.setAppState(this.getPendingRecordKey(accountId, resolvedNearPublicKey), void 0).catch(() => {});
+		if (!nearPublicKey || idx === nearPublicKey) await require_index.IndexedDBManager.clientDB.setAppState(indexKey, void 0).catch(() => {});
+	}
+	async touchIndex(accountId, nearPublicKey) {
+		await require_index.IndexedDBManager.clientDB.setAppState(this.getPendingIndexKey(accountId), nearPublicKey).catch(() => {});
+	}
+};
+
+//#endregion
+exports.EmailRecoveryPendingStore = EmailRecoveryPendingStore;
+//# sourceMappingURL=emailRecoveryPendingStore.js.map

package/dist/cjs/react/src/core/EmailRecovery/emailRecoveryPendingStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailRecoveryPendingStore.js","names":["IndexedDBManager"],"sources":["../../../../../../src/core/EmailRecovery/emailRecoveryPendingStore.ts"],"sourcesContent":["import { IndexedDBManager } from '../IndexedDBManager';\nimport type { AccountId } from '../types/accountIds';\nimport type { PendingEmailRecovery } from '../types/emailRecovery';\n\nexport interface PendingStore {\n  get(accountId: AccountId, nearPublicKey?: string): Promise<PendingEmailRecovery | null>;\n  set(record: PendingEmailRecovery): Promise<void>;\n  clear(accountId: AccountId, nearPublicKey?: string): Promise<void>;\n  touchIndex(accountId: AccountId, nearPublicKey: string): Promise<void>;\n}\n\ntype EmailRecoveryPendingStoreOptions = {\n  getPendingTtlMs: () => number;\n  now?: () => number;\n};\n\nexport class EmailRecoveryPendingStore implements PendingStore {\n  private getPendingTtlMs: () => number;\n  private now: () => number;\n\n  constructor(options: EmailRecoveryPendingStoreOptions) {\n    this.getPendingTtlMs = options.getPendingTtlMs;\n    this.now = options.now ?? Date.now;\n  }\n\n  private getPendingIndexKey(accountId: AccountId): string {\n    return `pendingEmailRecovery:${accountId}`;\n  }\n\n  private getPendingRecordKey(accountId: AccountId, nearPublicKey: string): string {\n    return `${this.getPendingIndexKey(accountId)}:${nearPublicKey}`;\n  }\n\n  async get(accountId: AccountId, nearPublicKey?: string): Promise<PendingEmailRecovery | null> {\n    const pendingTtlMs = this.getPendingTtlMs();\n    const indexKey = this.getPendingIndexKey(accountId);\n    const indexedNearPublicKey = await IndexedDBManager.clientDB.getAppState<string>(indexKey);\n    const resolvedNearPublicKey = nearPublicKey ?? indexedNearPublicKey;\n    if (!resolvedNearPublicKey) {\n      return null;\n    }\n\n    const recordKey = this.getPendingRecordKey(accountId, resolvedNearPublicKey);\n    const record = await IndexedDBManager.clientDB.getAppState<PendingEmailRecovery>(recordKey);\n    const shouldClearIndex = indexedNearPublicKey === resolvedNearPublicKey;\n    if (!record) {\n      if (shouldClearIndex) {\n        await IndexedDBManager.clientDB.setAppState(indexKey, undefined as any).catch(() => { });\n      }\n      return null;\n    }\n\n    if (this.now() - record.createdAt > pendingTtlMs) {\n      await IndexedDBManager.clientDB.setAppState(recordKey, undefined as any).catch(() => { });\n      if (shouldClearIndex) {\n        await IndexedDBManager.clientDB.setAppState(indexKey, undefined as any).catch(() => { });\n      }\n      return null;\n    }\n\n    await this.touchIndex(accountId, record.nearPublicKey);\n    return record;\n  }\n\n  async set(record: PendingEmailRecovery): Promise<void> {\n    const key = this.getPendingRecordKey(record.accountId, record.nearPublicKey);\n    await IndexedDBManager.clientDB.setAppState(key, record);\n    await this.touchIndex(record.accountId, record.nearPublicKey);\n  }\n\n  async clear(accountId: AccountId, nearPublicKey?: string): Promise<void> {\n    const indexKey = this.getPendingIndexKey(accountId);\n    const idx = await IndexedDBManager.clientDB.getAppState<string>(indexKey).catch(() => undefined);\n\n    const resolvedNearPublicKey = nearPublicKey || idx || '';\n    if (resolvedNearPublicKey) {\n      await IndexedDBManager.clientDB\n        .setAppState(this.getPendingRecordKey(accountId, resolvedNearPublicKey), undefined as any)\n        .catch(() => { });\n    }\n\n    if (!nearPublicKey || idx === nearPublicKey) {\n      await IndexedDBManager.clientDB.setAppState(indexKey, undefined as any).catch(() => { });\n    }\n  }\n\n  async touchIndex(accountId: AccountId, nearPublicKey: string): Promise<void> {\n    await IndexedDBManager.clientDB.setAppState(this.getPendingIndexKey(accountId), nearPublicKey).catch(() => { });\n  }\n}\n"],"mappings":";;;AAgBA,IAAa,4BAAb,MAA+D;CAC7D,AAAQ;CACR,AAAQ;CAER,YAAY,SAA2C;AACrD,OAAK,kBAAkB,QAAQ;AAC/B,OAAK,MAAM,QAAQ,OAAO,KAAK;;CAGjC,AAAQ,mBAAmB,WAA8B;AACvD,SAAO,wBAAwB;;CAGjC,AAAQ,oBAAoB,WAAsB,eAA+B;AAC/E,SAAO,GAAG,KAAK,mBAAmB,WAAW,GAAG;;CAGlD,MAAM,IAAI,WAAsB,eAA8D;EAC5F,MAAM,eAAe,KAAK;EAC1B,MAAM,WAAW,KAAK,mBAAmB;EACzC,MAAM,uBAAuB,MAAMA,+BAAiB,SAAS,YAAoB;EACjF,MAAM,wBAAwB,iBAAiB;AAC/C,MAAI,CAAC,sBACH,QAAO;EAGT,MAAM,YAAY,KAAK,oBAAoB,WAAW;EACtD,MAAM,SAAS,MAAMA,+BAAiB,SAAS,YAAkC;EACjF,MAAM,mBAAmB,yBAAyB;AAClD,MAAI,CAAC,QAAQ;AACX,OAAI,iBACF,OAAMA,+BAAiB,SAAS,YAAY,UAAU,QAAkB,YAAY;AAEtF,UAAO;;AAGT,MAAI,KAAK,QAAQ,OAAO,YAAY,cAAc;AAChD,SAAMA,+BAAiB,SAAS,YAAY,WAAW,QAAkB,YAAY;AACrF,OAAI,iBACF,OAAMA,+BAAiB,SAAS,YAAY,UAAU,QAAkB,YAAY;AAEtF,UAAO;;AAGT,QAAM,KAAK,WAAW,WAAW,OAAO;AACxC,SAAO;;CAGT,MAAM,IAAI,QAA6C;EACrD,MAAM,MAAM,KAAK,oBAAoB,OAAO,WAAW,OAAO;AAC9D,QAAMA,+BAAiB,SAAS,YAAY,KAAK;AACjD,QAAM,KAAK,WAAW,OAAO,WAAW,OAAO;;CAGjD,MAAM,MAAM,WAAsB,eAAuC;EACvE,MAAM,WAAW,KAAK,mBAAmB;EACzC,MAAM,MAAM,MAAMA,+BAAiB,SAAS,YAAoB,UAAU,YAAY;EAEtF,MAAM,wBAAwB,iBAAiB,OAAO;AACtD,MAAI,sBACF,OAAMA,+BAAiB,SACpB,YAAY,KAAK,oBAAoB,WAAW,wBAAwB,QACxE,YAAY;AAGjB,MAAI,CAAC,iBAAiB,QAAQ,cAC5B,OAAMA,+BAAiB,SAAS,YAAY,UAAU,QAAkB,YAAY;;CAIxF,MAAM,WAAW,WAAsB,eAAsC;AAC3E,QAAMA,+BAAiB,SAAS,YAAY,KAAK,mBAAmB,YAAY,eAAe,YAAY"}

package/dist/cjs/react/src/core/EmailRecovery/index.js

@@ -0,0 +1,99 @@
+const require_accountIds = require('../types/accountIds.js');
+const require_base64 = require('../../utils/base64.js');
+const require_index = require('../IndexedDBManager/index.js');
+const require_emailRecoveryPendingStore = require('./emailRecoveryPendingStore.js');
+
+//#region src/core/EmailRecovery/index.ts
+function getTxSuccessValueBase64(outcome) {
+	const status = outcome.status;
+	if (!status || typeof status !== "object") return null;
+	if (!("SuccessValue" in status)) return null;
+	const value = status.SuccessValue;
+	return typeof value === "string" && value.length > 0 ? value : null;
+}
+function parseLinkDeviceRegisterUserResponse(outcome) {
+	try {
+		const successValueB64 = getTxSuccessValueBase64(outcome);
+		if (!successValueB64) return null;
+		const bytes = require_base64.base64Decode(successValueB64);
+		const text = new TextDecoder().decode(bytes);
+		if (!text.trim()) return null;
+		const parsed = JSON.parse(text);
+		if (!parsed || typeof parsed !== "object") return null;
+		const candidate = parsed;
+		return typeof candidate.verified === "boolean" ? candidate : null;
+	} catch {
+		return null;
+	}
+}
+const canonicalizeEmail = (email) => {
+	const raw = String(email || "").trim();
+	if (!raw) return "";
+	const withoutHeaderName = raw.replace(/^[a-z0-9-]+\s*:\s*/i, "").trim();
+	const emailRegex = /([a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*)/;
+	const angleMatch = withoutHeaderName.match(/<([^>]+)>/);
+	const candidates = [angleMatch?.[1], withoutHeaderName].filter((v) => typeof v === "string" && v.length > 0);
+	for (const candidate of candidates) {
+		const cleaned = candidate.replace(/^mailto:\s*/i, "");
+		const match = cleaned.match(emailRegex);
+		if (match?.[1]) return match[1].trim().toLowerCase();
+	}
+	return withoutHeaderName.toLowerCase();
+};
+const bytesToHex = (bytes) => {
+	const arr = bytes instanceof Uint8Array ? bytes : Uint8Array.from(bytes);
+	return `0x${Array.from(arr).map((b) => b.toString(16).padStart(2, "0")).join("")}`;
+};
+async function hashRecoveryEmails(emails, accountId) {
+	const encoder = new TextEncoder();
+	const salt = (accountId || "").trim().toLowerCase();
+	const normalized = (emails || []).map((e) => e.trim()).filter((e) => e.length > 0);
+	const hashed = [];
+	for (const email of normalized) try {
+		const canonicalEmail = canonicalizeEmail(email);
+		const input = `${canonicalEmail}|${salt}`;
+		const data = encoder.encode(input);
+		const digest = await crypto.subtle.digest("SHA-256", data);
+		const bytes = new Uint8Array(digest);
+		hashed.push(Array.from(bytes));
+	} catch {
+		const bytes = encoder.encode(email.toLowerCase());
+		hashed.push(Array.from(bytes));
+	}
+	return hashed;
+}
+/**
+* Canonicalize and hash recovery emails for an account, and persist the mapping
+* (hashHex → canonical email) in IndexedDB on a best-effort basis.
+*/
+async function prepareRecoveryEmails(nearAccountId, recoveryEmails) {
+	const accountId = require_accountIds.toAccountId(nearAccountId);
+	const trimmedEmails = (recoveryEmails || []).map((e) => e.trim()).filter((e) => e.length > 0);
+	const canonicalEmails = trimmedEmails.map(canonicalizeEmail);
+	const recoveryEmailHashes = await hashRecoveryEmails(recoveryEmails, accountId);
+	const pairs = recoveryEmailHashes.map((hashBytes, idx) => ({
+		hashHex: bytesToHex(hashBytes),
+		email: canonicalEmails[idx]
+	}));
+	(async () => {
+		try {
+			await require_index.IndexedDBManager.upsertRecoveryEmails(accountId, pairs);
+		} catch (error) {
+			console.warn("[EmailRecovery] Failed to persist local recovery emails", error);
+		}
+	})();
+	return {
+		hashes: recoveryEmailHashes,
+		pairs
+	};
+}
+async function getLocalRecoveryEmails(nearAccountId) {
+	return require_index.IndexedDBManager.getRecoveryEmails(nearAccountId);
+}
+
+//#endregion
+exports.bytesToHex = bytesToHex;
+exports.getLocalRecoveryEmails = getLocalRecoveryEmails;
+exports.parseLinkDeviceRegisterUserResponse = parseLinkDeviceRegisterUserResponse;
+exports.prepareRecoveryEmails = prepareRecoveryEmails;
+//# sourceMappingURL=index.js.map

package/dist/cjs/react/src/core/EmailRecovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["base64Decode","hashed: number[][]","toAccountId","pairs: RecoveryEmailEntry[]","IndexedDBManager"],"sources":["../../../../../../src/core/EmailRecovery/index.ts"],"sourcesContent":["import type { AccountId } from '../types/accountIds';\nimport { toAccountId } from '../types/accountIds';\nimport { IndexedDBManager, type RecoveryEmailRecord } from '../IndexedDBManager';\nimport type { FinalExecutionOutcome } from '@near-js/types';\nimport { base64Decode } from '../../utils/base64';\nexport { EmailRecoveryPendingStore, type PendingStore } from './emailRecoveryPendingStore';\n\nexport type RecoveryEmailEntry = {\n  hashHex: string;\n  email: string;\n};\n\nexport { type RecoveryEmailRecord };\n\nexport type LinkDeviceRegisterUserResponse = {\n  verified?: boolean;\n  registration_info?: unknown;\n  registrationInfo?: unknown;\n  error?: unknown;\n};\n\nfunction getTxSuccessValueBase64(outcome: FinalExecutionOutcome): string | null {\n  const status = outcome.status;\n  if (!status || typeof status !== 'object') return null;\n  if (!('SuccessValue' in status)) return null;\n  const value = status.SuccessValue;\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nexport function parseLinkDeviceRegisterUserResponse(\n  outcome: FinalExecutionOutcome\n): LinkDeviceRegisterUserResponse | null {\n  try {\n    const successValueB64 = getTxSuccessValueBase64(outcome);\n    if (!successValueB64) return null;\n\n    const bytes = base64Decode(successValueB64);\n    const text = new TextDecoder().decode(bytes);\n    if (!text.trim()) return null;\n\n    const parsed = JSON.parse(text) as unknown;\n    if (!parsed || typeof parsed !== 'object') return null;\n    const candidate = parsed as LinkDeviceRegisterUserResponse;\n    return typeof candidate.verified === 'boolean' ? candidate : null;\n  } catch {\n    return null;\n  }\n}\n\nexport const canonicalizeEmail = (email: string): string => {\n  const raw = String(email || '').trim();\n  if (!raw) return '';\n\n  // Handle cases where a full header line is passed in (e.g. \"From: ...\").\n  const withoutHeaderName = raw.replace(/^[a-z0-9-]+\\s*:\\s*/i, '').trim();\n\n  const emailRegex =\n    /([a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*)/;\n\n  // Prefer the common \"Name <email@domain>\" format when present, but still\n  // validate/extract the actual address via regex.\n  const angleMatch = withoutHeaderName.match(/<([^>]+)>/);\n  const candidates = [\n    angleMatch?.[1],\n    withoutHeaderName,\n  ].filter((v): v is string => typeof v === 'string' && v.length > 0);\n\n  for (const candidate of candidates) {\n    const cleaned = candidate.replace(/^mailto:\\s*/i, '');\n    const match = cleaned.match(emailRegex);\n    if (match?.[1]) {\n      return match[1].trim().toLowerCase();\n    }\n  }\n\n  return withoutHeaderName.toLowerCase();\n};\n\nexport const bytesToHex = (bytes: number[] | Uint8Array): string => {\n  const arr = bytes instanceof Uint8Array ? bytes : Uint8Array.from(bytes);\n  return `0x${Array.from(arr)\n    .map(b => b.toString(16).padStart(2, '0'))\n    .join('')}`;\n};\n\nasync function hashRecoveryEmails(emails: string[], accountId: AccountId): Promise<number[][]> {\n  const encoder = new TextEncoder();\n  const salt = (accountId || '').trim().toLowerCase();\n  const normalized = (emails || [])\n    .map(e => e.trim())\n    .filter(e => e.length > 0);\n\n  const hashed: number[][] = [];\n\n  for (const email of normalized) {\n    try {\n      const canonicalEmail = canonicalizeEmail(email);\n      const input = `${canonicalEmail}|${salt}`;\n      const data = encoder.encode(input);\n      const digest = await crypto.subtle.digest('SHA-256', data);\n      const bytes = new Uint8Array(digest);\n      hashed.push(Array.from(bytes));\n    } catch {\n      const bytes = encoder.encode(email.toLowerCase());\n      hashed.push(Array.from(bytes));\n    }\n  }\n\n  return hashed;\n}\n\n/**\n * Canonicalize and hash recovery emails for an account, and persist the mapping\n * (hashHex → canonical email) in IndexedDB on a best-effort basis.\n */\nexport async function prepareRecoveryEmails(nearAccountId: AccountId, recoveryEmails: string[]): Promise<{\n  hashes: number[][];\n  pairs: RecoveryEmailEntry[];\n}> {\n  const accountId = toAccountId(nearAccountId);\n\n  const trimmedEmails = (recoveryEmails || []).map(e => e.trim()).filter(e => e.length > 0);\n  const canonicalEmails = trimmedEmails.map(canonicalizeEmail);\n  const recoveryEmailHashes = await hashRecoveryEmails(recoveryEmails, accountId);\n\n  const pairs: RecoveryEmailEntry[] = recoveryEmailHashes.map((hashBytes, idx) => ({\n    hashHex: bytesToHex(hashBytes),\n    email: canonicalEmails[idx],\n  }));\n\n  void (async () => {\n    try {\n      await IndexedDBManager.upsertRecoveryEmails(accountId, pairs);\n    } catch (error) {\n      console.warn('[EmailRecovery] Failed to persist local recovery emails', error);\n    }\n  })();\n\n  return { hashes: recoveryEmailHashes, pairs };\n}\n\nexport async function getLocalRecoveryEmails(nearAccountId: AccountId): Promise<RecoveryEmailRecord[]> {\n  return IndexedDBManager.getRecoveryEmails(nearAccountId);\n}\n"],"mappings":";;;;;;AAqBA,SAAS,wBAAwB,SAA+C;CAC9E,MAAM,SAAS,QAAQ;AACvB,KAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,KAAI,EAAE,kBAAkB,QAAS,QAAO;CACxC,MAAM,QAAQ,OAAO;AACrB,QAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;;AAGjE,SAAgB,oCACd,SACuC;AACvC,KAAI;EACF,MAAM,kBAAkB,wBAAwB;AAChD,MAAI,CAAC,gBAAiB,QAAO;EAE7B,MAAM,QAAQA,4BAAa;EAC3B,MAAM,OAAO,IAAI,cAAc,OAAO;AACtC,MAAI,CAAC,KAAK,OAAQ,QAAO;EAEzB,MAAM,SAAS,KAAK,MAAM;AAC1B,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;EAClD,MAAM,YAAY;AAClB,SAAO,OAAO,UAAU,aAAa,YAAY,YAAY;SACvD;AACN,SAAO;;;AAIX,MAAa,qBAAqB,UAA0B;CAC1D,MAAM,MAAM,OAAO,SAAS,IAAI;AAChC,KAAI,CAAC,IAAK,QAAO;CAGjB,MAAM,oBAAoB,IAAI,QAAQ,uBAAuB,IAAI;CAEjE,MAAM,aACJ;CAIF,MAAM,aAAa,kBAAkB,MAAM;CAC3C,MAAM,aAAa,CACjB,aAAa,IACb,mBACA,QAAQ,MAAmB,OAAO,MAAM,YAAY,EAAE,SAAS;AAEjE,MAAK,MAAM,aAAa,YAAY;EAClC,MAAM,UAAU,UAAU,QAAQ,gBAAgB;EAClD,MAAM,QAAQ,QAAQ,MAAM;AAC5B,MAAI,QAAQ,GACV,QAAO,MAAM,GAAG,OAAO;;AAI3B,QAAO,kBAAkB;;AAG3B,MAAa,cAAc,UAAyC;CAClE,MAAM,MAAM,iBAAiB,aAAa,QAAQ,WAAW,KAAK;AAClE,QAAO,KAAK,MAAM,KAAK,KACpB,KAAI,MAAK,EAAE,SAAS,IAAI,SAAS,GAAG,MACpC,KAAK;;AAGV,eAAe,mBAAmB,QAAkB,WAA2C;CAC7F,MAAM,UAAU,IAAI;CACpB,MAAM,QAAQ,aAAa,IAAI,OAAO;CACtC,MAAM,cAAc,UAAU,IAC3B,KAAI,MAAK,EAAE,QACX,QAAO,MAAK,EAAE,SAAS;CAE1B,MAAMC,SAAqB;AAE3B,MAAK,MAAM,SAAS,WAClB,KAAI;EACF,MAAM,iBAAiB,kBAAkB;EACzC,MAAM,QAAQ,GAAG,eAAe,GAAG;EACnC,MAAM,OAAO,QAAQ,OAAO;EAC5B,MAAM,SAAS,MAAM,OAAO,OAAO,OAAO,WAAW;EACrD,MAAM,QAAQ,IAAI,WAAW;AAC7B,SAAO,KAAK,MAAM,KAAK;SACjB;EACN,MAAM,QAAQ,QAAQ,OAAO,MAAM;AACnC,SAAO,KAAK,MAAM,KAAK;;AAI3B,QAAO;;;;;;AAOT,eAAsB,sBAAsB,eAA0B,gBAGnE;CACD,MAAM,YAAYC,+BAAY;CAE9B,MAAM,iBAAiB,kBAAkB,IAAI,KAAI,MAAK,EAAE,QAAQ,QAAO,MAAK,EAAE,SAAS;CACvF,MAAM,kBAAkB,cAAc,IAAI;CAC1C,MAAM,sBAAsB,MAAM,mBAAmB,gBAAgB;CAErE,MAAMC,QAA8B,oBAAoB,KAAK,WAAW,SAAS;EAC/E,SAAS,WAAW;EACpB,OAAO,gBAAgB;;AAGzB,EAAM,YAAY;AAChB,MAAI;AACF,SAAMC,+BAAiB,qBAAqB,WAAW;WAChD,OAAO;AACd,WAAQ,KAAK,2DAA2D;;;AAI5E,QAAO;EAAE,QAAQ;EAAqB;;;AAGxC,eAAsB,uBAAuB,eAA0D;AACrG,QAAOA,+BAAiB,kBAAkB"}

package/dist/cjs/react/src/core/IndexedDBManager/index.js

@@ -0,0 +1,133 @@
+const require_passkeyClientDB = require('./passkeyClientDB.js');
+const require_passkeyNearKeysDB = require('./passkeyNearKeysDB.js');
+
+//#region src/core/IndexedDBManager/index.ts
+const passkeyClientDB = new require_passkeyClientDB.PasskeyClientDBManager();
+const passkeyNearKeysDB = new require_passkeyNearKeysDB.PasskeyNearKeysDBManager();
+const DB_CONFIG_BY_MODE = {
+	legacy: {
+		clientDbName: "PasskeyClientDB",
+		nearKeysDbName: "PasskeyNearKeys",
+		disabled: false
+	},
+	wallet: {
+		clientDbName: "PasskeyClientDB",
+		nearKeysDbName: "PasskeyNearKeys",
+		disabled: false
+	},
+	disabled: {
+		clientDbName: "PasskeyClientDB",
+		nearKeysDbName: "PasskeyNearKeys",
+		disabled: true
+	}
+};
+let configured = null;
+/**
+* Configure IndexedDB database names for the current runtime.
+*
+* Call this once, early (before any IndexedDB access).
+* - Wallet iframe host should use `mode: 'wallet'`.
+* - App origin should use `mode: 'disabled'` when wallet-iframe mode is enabled.
+* - Non-iframe apps should use `mode: 'legacy'`.
+*/
+function configureIndexedDB(args) {
+	const mode = args?.mode;
+	const next = DB_CONFIG_BY_MODE[mode];
+	if (!next) throw new Error(`[IndexedDBManager] Unknown IndexedDBMode: ${String(mode)}`);
+	if (configured) {
+		const isSame = configured.clientDbName === next.clientDbName && configured.nearKeysDbName === next.nearKeysDbName && configured.disabled === next.disabled;
+		if (!isSame) console.warn("[IndexedDBManager] configureIndexedDB called multiple times; ignoring subsequent configuration", {
+			configured,
+			requested: next
+		});
+		return {
+			clientDbName: configured.clientDbName,
+			nearKeysDbName: configured.nearKeysDbName
+		};
+	}
+	configured = {
+		mode,
+		...next
+	};
+	passkeyClientDB.setDbName(next.clientDbName);
+	passkeyNearKeysDB.setDbName(next.nearKeysDbName);
+	passkeyClientDB.setDisabled(next.disabled);
+	passkeyNearKeysDB.setDisabled(next.disabled);
+	return {
+		clientDbName: configured.clientDbName,
+		nearKeysDbName: configured.nearKeysDbName
+	};
+}
+/**
+* Unified IndexedDB interface providing access to both databases
+* This allows centralized access while maintaining separation of concerns
+*/
+var UnifiedIndexedDBManager = class {
+	clientDB;
+	nearKeysDB;
+	_initialized = false;
+	constructor() {
+		this.clientDB = passkeyClientDB;
+		this.nearKeysDB = passkeyNearKeysDB;
+	}
+	/**
+	* Initialize both databases proactively
+	* This ensures both databases are created and ready for use
+	*/
+	async initialize() {
+		if (this._initialized) return;
+		try {
+			if (this.clientDB.isDisabled() || this.nearKeysDB.isDisabled()) {
+				this._initialized = true;
+				return;
+			}
+			await Promise.all([this.clientDB.getAppState("_init_check"), this.nearKeysDB.hasKeyMaterial("_init_check", 1, "local_near_sk_v3")]);
+			this._initialized = true;
+		} catch (error) {
+			console.warn("Failed to initialize IndexedDB databases:", error);
+		}
+	}
+	/**
+	* Check if databases have been initialized
+	*/
+	get isInitialized() {
+		return this._initialized;
+	}
+	/**
+	* Get user data and check if they have encrypted NEAR keys
+	*/
+	async getUserWithKeys(nearAccountId) {
+		const last = await this.clientDB.getLastUser();
+		const userData = last && last.nearAccountId === nearAccountId ? last : await this.clientDB.getUserByDevice(nearAccountId, 1);
+		const deviceNumber = last && last.nearAccountId === nearAccountId ? last.deviceNumber : userData?.deviceNumber;
+		const [local, threshold] = await Promise.all([this.nearKeysDB.getLocalKeyMaterial(nearAccountId, deviceNumber), this.nearKeysDB.getThresholdKeyMaterial(nearAccountId, deviceNumber)]);
+		const keyData = local ?? threshold;
+		const hasKeys = !!keyData;
+		return {
+			userData,
+			hasKeys,
+			keyMaterial: hasKeys ? keyData : void 0
+		};
+	}
+	async setDerivedAddress(nearAccountId, args) {
+		return this.clientDB.setDerivedAddress(nearAccountId, args);
+	}
+	async getDerivedAddressRecord(nearAccountId, args) {
+		return this.clientDB.getDerivedAddressRecord(nearAccountId, args);
+	}
+	async getDerivedAddress(nearAccountId, args) {
+		return this.clientDB.getDerivedAddress(nearAccountId, args);
+	}
+	async upsertRecoveryEmails(nearAccountId, entries) {
+		return this.clientDB.upsertRecoveryEmails(nearAccountId, entries);
+	}
+	async getRecoveryEmails(nearAccountId) {
+		return this.clientDB.getRecoveryEmails(nearAccountId);
+	}
+};
+const IndexedDBManager = new UnifiedIndexedDBManager();
+
+//#endregion
+exports.IndexedDBManager = IndexedDBManager;
+exports.configureIndexedDB = configureIndexedDB;
+//# sourceMappingURL=index.js.map

package/dist/cjs/react/src/core/IndexedDBManager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["PasskeyClientDBManager","PasskeyNearKeysDBManager","DB_CONFIG_BY_MODE: Record<IndexedDBMode, { clientDbName: string; nearKeysDbName: string; disabled: boolean }>","configured: { mode: IndexedDBMode; clientDbName: string; nearKeysDbName: string; disabled: boolean } | null"],"sources":["../../../../../../src/core/IndexedDBManager/index.ts"],"sourcesContent":["export { PasskeyClientDBManager } from './passkeyClientDB';\nexport { PasskeyNearKeysDBManager } from './passkeyNearKeysDB';\n\nexport type {\n  ClientUserData,\n  UserPreferences,\n  ClientAuthenticatorData,\n  IndexedDBEvent,\n  DerivedAddressRecord,\n  RecoveryEmailRecord\n} from './passkeyClientDB';\n\nexport type {\n  PasskeyNearKeyMaterial,\n  LocalNearSkV3Material,\n  ThresholdEd25519_2p_V1Material,\n  PasskeyNearKeyMaterialKind,\n  ClientShareDerivation,\n} from './passkeyNearKeysDB';\n\nimport { AccountId } from '../types/accountIds';\n\n// === SINGLETON INSTANCES ===\nimport { PasskeyClientDBManager, type ClientUserData } from './passkeyClientDB';\nimport { PasskeyNearKeysDBManager, type PasskeyNearKeyMaterial } from './passkeyNearKeysDB';\n\n// Export singleton instances for backward compatibility with existing code\nexport const passkeyClientDB = new PasskeyClientDBManager();\nexport const passkeyNearKeysDB = new PasskeyNearKeysDBManager();\n\nexport type IndexedDBMode = 'legacy' | 'wallet' | 'disabled';\n\nconst DB_CONFIG_BY_MODE: Record<IndexedDBMode, { clientDbName: string; nearKeysDbName: string; disabled: boolean }> = {\n  legacy: { clientDbName: 'PasskeyClientDB', nearKeysDbName: 'PasskeyNearKeys', disabled: false },\n  wallet: { clientDbName: 'PasskeyClientDB', nearKeysDbName: 'PasskeyNearKeys', disabled: false },\n  // When running the SDK on the app origin with a wallet iframe configured, we disable IndexedDB entirely\n  // to ensure no SDK tables are created and nothing can accidentally persist there.\n  disabled: { clientDbName: 'PasskeyClientDB', nearKeysDbName: 'PasskeyNearKeys', disabled: true },\n};\n\nlet configured: { mode: IndexedDBMode; clientDbName: string; nearKeysDbName: string; disabled: boolean } | null = null;\n\n/**\n * Configure IndexedDB database names for the current runtime.\n *\n * Call this once, early (before any IndexedDB access).\n * - Wallet iframe host should use `mode: 'wallet'`.\n * - App origin should use `mode: 'disabled'` when wallet-iframe mode is enabled.\n * - Non-iframe apps should use `mode: 'legacy'`.\n */\nexport function configureIndexedDB(args: { mode: IndexedDBMode }): { clientDbName: string; nearKeysDbName: string } {\n  const mode = args?.mode;\n  const next = DB_CONFIG_BY_MODE[mode];\n  if (!next) {\n    throw new Error(`[IndexedDBManager] Unknown IndexedDBMode: ${String(mode)}`);\n  }\n\n  if (configured) {\n    const isSame =\n      configured.clientDbName === next.clientDbName\n      && configured.nearKeysDbName === next.nearKeysDbName\n      && configured.disabled === next.disabled;\n    if (!isSame) {\n      console.warn('[IndexedDBManager] configureIndexedDB called multiple times; ignoring subsequent configuration', {\n        configured,\n        requested: next,\n      });\n    }\n    return { clientDbName: configured.clientDbName, nearKeysDbName: configured.nearKeysDbName };\n  }\n\n  configured = { mode, ...next };\n  passkeyClientDB.setDbName(next.clientDbName);\n  passkeyNearKeysDB.setDbName(next.nearKeysDbName);\n  passkeyClientDB.setDisabled(next.disabled);\n  passkeyNearKeysDB.setDisabled(next.disabled);\n  return { clientDbName: configured.clientDbName, nearKeysDbName: configured.nearKeysDbName };\n}\n\nexport function getIndexedDBNames(): { clientDbName: string; nearKeysDbName: string } {\n  return configured || {\n    clientDbName: passkeyClientDB.getDbName(),\n    nearKeysDbName: passkeyNearKeysDB.getDbName(),\n  };\n}\n\n/**\n * Unified IndexedDB interface providing access to both databases\n * This allows centralized access while maintaining separation of concerns\n */\nexport class UnifiedIndexedDBManager {\n  public readonly clientDB: PasskeyClientDBManager;\n  public readonly nearKeysDB: PasskeyNearKeysDBManager;\n  private _initialized = false;\n\n  constructor() {\n    this.clientDB = passkeyClientDB;\n    this.nearKeysDB = passkeyNearKeysDB;\n  }\n\n  /**\n   * Initialize both databases proactively\n   * This ensures both databases are created and ready for use\n   */\n  async initialize(): Promise<void> {\n    if (this._initialized) {\n      return;\n    }\n\n    try {\n      if (this.clientDB.isDisabled() || this.nearKeysDB.isDisabled()) {\n        this._initialized = true;\n        return;\n      }\n      // Initialize both databases by calling a simple operation\n      // This will trigger the getDB() method in both managers and ensure databases are created\n      await Promise.all([\n        this.clientDB.getAppState('_init_check'),\n        this.nearKeysDB.hasKeyMaterial('_init_check', 1, 'local_near_sk_v3')\n      ]);\n\n      this._initialized = true;\n    } catch (error) {\n      console.warn('Failed to initialize IndexedDB databases:', error);\n      // Don't throw - allow the SDK to continue working, databases will be initialized on first use\n    }\n  }\n\n  /**\n   * Check if databases have been initialized\n   */\n  get isInitialized(): boolean {\n    return this._initialized;\n  }\n\n  // === CONVENIENCE METHODS ===\n\n  /**\n   * Get user data and check if they have encrypted NEAR keys\n   */\n  async getUserWithKeys(nearAccountId: AccountId): Promise<{\n    userData: ClientUserData | null;\n    hasKeys: boolean;\n    keyMaterial?: PasskeyNearKeyMaterial | null;\n  }> {\n    const last = await this.clientDB.getLastUser();\n    const userData = last && last.nearAccountId === nearAccountId\n      ? last\n      : await this.clientDB.getUserByDevice(nearAccountId, 1);\n    const deviceNumber = (last && last.nearAccountId === nearAccountId)\n      ? last.deviceNumber\n      : userData?.deviceNumber!;\n    const [local, threshold] = await Promise.all([\n      this.nearKeysDB.getLocalKeyMaterial(nearAccountId, deviceNumber),\n      this.nearKeysDB.getThresholdKeyMaterial(nearAccountId, deviceNumber),\n    ]);\n    const keyData = local ?? threshold;\n    const hasKeys = !!keyData;\n\n    return {\n      userData,\n      hasKeys,\n      keyMaterial: hasKeys ? keyData : undefined\n    };\n  }\n\n  // === Derived addresses convenience ===\n  async setDerivedAddress(\n    nearAccountId: AccountId,\n    args: { contractId: string; path: string; address: string }\n  ): Promise<void> {\n    return this.clientDB.setDerivedAddress(nearAccountId, args);\n  }\n\n  async getDerivedAddressRecord(\n    nearAccountId: AccountId,\n    args: { contractId: string; path: string }\n  ): Promise<import('./passkeyClientDB').DerivedAddressRecord | null> {\n    return this.clientDB.getDerivedAddressRecord(nearAccountId, args);\n  }\n\n  async getDerivedAddress(\n    nearAccountId: AccountId,\n    args: { contractId: string; path: string }\n  ): Promise<string | null> {\n    return this.clientDB.getDerivedAddress(nearAccountId, args);\n  }\n\n  // === Recovery emails convenience ===\n  async upsertRecoveryEmails(\n    nearAccountId: AccountId,\n    entries: Array<{ hashHex: string; email: string }>\n  ): Promise<void> {\n    return this.clientDB.upsertRecoveryEmails(nearAccountId, entries);\n  }\n\n  async getRecoveryEmails(nearAccountId: AccountId): Promise<import('./passkeyClientDB').RecoveryEmailRecord[]> {\n    return this.clientDB.getRecoveryEmails(nearAccountId);\n  }\n}\n\n// Export singleton instance of unified manager\nexport const IndexedDBManager = new UnifiedIndexedDBManager();\n"],"mappings":";;;;AA2BA,MAAa,kBAAkB,IAAIA;AACnC,MAAa,oBAAoB,IAAIC;AAIrC,MAAMC,oBAAgH;CACpH,QAAQ;EAAE,cAAc;EAAmB,gBAAgB;EAAmB,UAAU;;CACxF,QAAQ;EAAE,cAAc;EAAmB,gBAAgB;EAAmB,UAAU;;CAGxF,UAAU;EAAE,cAAc;EAAmB,gBAAgB;EAAmB,UAAU;;;AAG5F,IAAIC,aAA8G;;;;;;;;;AAUlH,SAAgB,mBAAmB,MAAiF;CAClH,MAAM,OAAO,MAAM;CACnB,MAAM,OAAO,kBAAkB;AAC/B,KAAI,CAAC,KACH,OAAM,IAAI,MAAM,6CAA6C,OAAO;AAGtE,KAAI,YAAY;EACd,MAAM,SACJ,WAAW,iBAAiB,KAAK,gBAC9B,WAAW,mBAAmB,KAAK,kBACnC,WAAW,aAAa,KAAK;AAClC,MAAI,CAAC,OACH,SAAQ,KAAK,kGAAkG;GAC7G;GACA,WAAW;;AAGf,SAAO;GAAE,cAAc,WAAW;GAAc,gBAAgB,WAAW;;;AAG7E,cAAa;EAAE;EAAM,GAAG;;AACxB,iBAAgB,UAAU,KAAK;AAC/B,mBAAkB,UAAU,KAAK;AACjC,iBAAgB,YAAY,KAAK;AACjC,mBAAkB,YAAY,KAAK;AACnC,QAAO;EAAE,cAAc,WAAW;EAAc,gBAAgB,WAAW;;;;;;;AAc7E,IAAa,0BAAb,MAAqC;CACnC,AAAgB;CAChB,AAAgB;CAChB,AAAQ,eAAe;CAEvB,cAAc;AACZ,OAAK,WAAW;AAChB,OAAK,aAAa;;;;;;CAOpB,MAAM,aAA4B;AAChC,MAAI,KAAK,aACP;AAGF,MAAI;AACF,OAAI,KAAK,SAAS,gBAAgB,KAAK,WAAW,cAAc;AAC9D,SAAK,eAAe;AACpB;;AAIF,SAAM,QAAQ,IAAI,CAChB,KAAK,SAAS,YAAY,gBAC1B,KAAK,WAAW,eAAe,eAAe,GAAG;AAGnD,QAAK,eAAe;WACb,OAAO;AACd,WAAQ,KAAK,6CAA6C;;;;;;CAQ9D,IAAI,gBAAyB;AAC3B,SAAO,KAAK;;;;;CAQd,MAAM,gBAAgB,eAInB;EACD,MAAM,OAAO,MAAM,KAAK,SAAS;EACjC,MAAM,WAAW,QAAQ,KAAK,kBAAkB,gBAC5C,OACA,MAAM,KAAK,SAAS,gBAAgB,eAAe;EACvD,MAAM,eAAgB,QAAQ,KAAK,kBAAkB,gBACjD,KAAK,eACL,UAAU;EACd,MAAM,CAAC,OAAO,aAAa,MAAM,QAAQ,IAAI,CAC3C,KAAK,WAAW,oBAAoB,eAAe,eACnD,KAAK,WAAW,wBAAwB,eAAe;EAEzD,MAAM,UAAU,SAAS;EACzB,MAAM,UAAU,CAAC,CAAC;AAElB,SAAO;GACL;GACA;GACA,aAAa,UAAU,UAAU;;;CAKrC,MAAM,kBACJ,eACA,MACe;AACf,SAAO,KAAK,SAAS,kBAAkB,eAAe;;CAGxD,MAAM,wBACJ,eACA,MACkE;AAClE,SAAO,KAAK,SAAS,wBAAwB,eAAe;;CAG9D,MAAM,kBACJ,eACA,MACwB;AACxB,SAAO,KAAK,SAAS,kBAAkB,eAAe;;CAIxD,MAAM,qBACJ,eACA,SACe;AACf,SAAO,KAAK,SAAS,qBAAqB,eAAe;;CAG3D,MAAM,kBAAkB,eAAsF;AAC5G,SAAO,KAAK,SAAS,kBAAkB;;;AAK3C,MAAa,mBAAmB,IAAI"}