@naculus/connect-appkit-core 0.6.0 → 0.8.0

package/dist/index.js

@@ -478,6 +478,13 @@ function saveNotificationSettings(storage, settings) {
 function updateNotificationSettings(current, update) {
   return { ...current, ...update };
 }
+function replayNotificationSettings(persisted, updates) {
+  let settings = persisted ?? DEFAULT_NOTIFICATION_SETTINGS;
+  for (const update of updates) {
+    settings = updateNotificationSettings(settings, update(settings));
+  }
+  return settings;
+}
 function channelsUpdate(channels) {
   const update = {};
   if (channels.includes("telegram")) update.telegram = true;
@@ -1289,7 +1296,127 @@ function createDelegationPolicyFlow(deps) {
   };
 }
 
+// src/authorization.ts
+import {
+  evaluateSpend
+} from "@naculus/connect-core";
+function assetAddress(asset) {
+  return asset.split(/[:/]/).at(-1);
+}
+function groupDigits(value) {
+  return value.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}
+function formatAuthorizationAmount(amount, metadata) {
+  const baseUnits = amount.toString();
+  if (!metadata || !metadata.symbol || !Number.isSafeInteger(metadata.decimals) || metadata.decimals < 0) {
+    return {
+      formatted: `${groupDigits(baseUnits)} base units`
+    };
+  }
+  const decimals = metadata.decimals;
+  const padded = baseUnits.padStart(decimals + 1, "0");
+  const integer = decimals === 0 ? padded : padded.slice(0, -decimals);
+  const fraction = decimals === 0 ? "" : padded.slice(-decimals).replace(/0+$/, "");
+  const value = `${groupDigits(integer)}${fraction ? `.${fraction}` : ""}`;
+  return { formatted: `${value} ${metadata.symbol}` };
+}
+function relativeExpiry(expiresAt, now, locale) {
+  const seconds = expiresAt - now;
+  const absolute = Math.abs(seconds);
+  const divisor = absolute >= 31536e3 ? 31536e3 : absolute >= 2592e3 ? 2592e3 : absolute >= 86400 ? 86400 : absolute >= 3600 ? 3600 : absolute >= 60 ? 60 : 1;
+  const unit = divisor === 31536e3 ? "year" : divisor === 2592e3 ? "month" : divisor === 86400 ? "day" : divisor === 3600 ? "hour" : divisor === 60 ? "minute" : "second";
+  return new Intl.RelativeTimeFormat(locale).format(
+    Math.round(seconds / divisor),
+    unit
+  );
+}
+function describeAuthorization(input, options = {}) {
+  const now = options.now ?? Math.floor(Date.now() / 1e3);
+  const locale = options.locale ?? "en";
+  const flags = "flags" in input ? input.flags : [];
+  const label = "label" in input ? input.label ?? null : null;
+  return {
+    label,
+    principal: input.principal ?? null,
+    grants: input.grants.map((grant) => {
+      const metadata = options.assets?.[grant.asset];
+      return {
+        asset: grant.asset,
+        assetLabel: metadata?.symbol || assetAddress(grant.asset),
+        recipients: grant.recipients.map((full) => ({
+          shortened: full.length <= 14 ? full : `${full.slice(0, 6)}\u2026${full.slice(-6)}`,
+          full
+        })),
+        perPayment: formatAuthorizationAmount(grant.maxPerPayment, metadata),
+        total: formatAuthorizationAmount(grant.maxTotal, metadata),
+        count: grant.maxCount ?? null,
+        rails: grant.rails.map((r) => r.replace("-", " "))
+      };
+    }),
+    expiry: {
+      timestamp: input.expiresAt,
+      absolute: new Intl.DateTimeFormat(locale, {
+        year: "numeric",
+        month: "short",
+        day: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+        hourCycle: "h23",
+        timeZone: "UTC",
+        timeZoneName: "short"
+      }).format(input.expiresAt * 1e3),
+      relative: relativeExpiry(input.expiresAt, now, locale)
+    },
+    warnings: flags.map(
+      (flag) => flag === "unrestricted-recipient-legacy" ? "This key can pay any recipient." : "This key can do more than shown here."
+    )
+  };
+}
+var REFUSAL_SENTENCES = {
+  expired: "This authorization has expired.",
+  "not-yet-valid": "This authorization is not valid yet.",
+  "no-matching-grant": "No grant covers this asset.",
+  "recipient-not-allowed": "This recipient is not allowed.",
+  "over-per-payment": "This amount exceeds the per-payment limit.",
+  "over-total": "This amount exceeds the remaining total limit.",
+  "over-count": "This authorization has reached its payment count limit.",
+  "rail-not-allowed": "This payment rail is not allowed.",
+  "invalid-authorization": "The authorization or spend request is invalid."
+};
+function explainSpend(authorization, request, options = {}) {
+  const verdict = evaluateSpend(authorization, request);
+  if (!verdict.allow) {
+    return {
+      allowed: false,
+      reason: verdict.reason,
+      sentence: REFUSAL_SENTENCES[verdict.reason]
+    };
+  }
+  const remainingTotal = authorization.grants[verdict.grant].maxTotal - request.spentSoFar - request.amount;
+  const remainingTotalFormatted = formatAuthorizationAmount(
+    remainingTotal,
+    options.assets?.[authorization.grants[verdict.grant].asset]
+  );
+  return {
+    allowed: true,
+    grant: verdict.grant,
+    remainingTotal,
+    remainingTotalFormatted,
+    sentence: `Allowed by grant ${verdict.grant + 1}; ${remainingTotalFormatted.formatted} remain.`
+  };
+}
+
 // src/payment-fetch.ts
+var DEFAULT_VERIFY_RETRY = { attempts: 5, delayMs: 4e3 };
+function applySettlementVerification(payment, result) {
+  return {
+    ...payment,
+    verification: {
+      status: result.status,
+      ..."reason" in result && result.reason !== void 0 ? { reason: result.reason } : {}
+    }
+  };
+}
 function record(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
@@ -1319,7 +1446,8 @@ function describePayment(input, result) {
       payTo: text(paid.payTo),
       amount: text(paid.amount),
       // A hash reported for another chain is not this payment's.
-      reference: settlement?.success === true && settlement.network === paid.network ? text(settlement.transaction) : null
+      reference: settlement?.success === true && settlement.network === paid.network ? text(settlement.transaction) : null,
+      verification: { status: "unverified" }
     };
   }
   const challenge = record(record(paid.challenge)?.params);
@@ -1333,7 +1461,8 @@ function describePayment(input, result) {
       asset: text(request.currency),
       payTo: text(request.recipient),
       amount: text(request.amount),
-      reference: text(record(result.receipt)?.reference)
+      reference: text(record(result.receipt)?.reference),
+      verification: { status: "unverified" }
     };
   }
   return {
@@ -1343,10 +1472,41 @@ function describePayment(input, result) {
     asset: null,
     payTo: null,
     amount: null,
-    reference: null
+    reference: null,
+    verification: { status: "unverified" }
   };
 }
 
+// src/mpp-session.ts
+function record2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function readMppSessionChannel(value) {
+  const channel = record2(value);
+  if (!channel || typeof channel.channelId !== "string" || typeof channel.payer !== "string" || typeof channel.payee !== "string" || typeof channel.mint !== "string" || typeof channel.channelProgram !== "string" || typeof channel.deposit !== "bigint" || typeof channel.gracePeriodSeconds !== "number" || typeof channel.openSlot !== "bigint" || typeof channel.salt !== "bigint") {
+    return null;
+  }
+  return channel;
+}
+function readCurrentMppSessionChannel(session) {
+  for (let index = session.channels.length - 1; index >= 0; index--) {
+    const channel = readMppSessionChannel(session.channels[index]);
+    if (channel) return channel;
+  }
+  return null;
+}
+function readMppSessionReceipt(value) {
+  const receipt = record2(value);
+  if (receipt?.status !== "success" || typeof receipt.method !== "string" || typeof receipt.timestamp !== "string" || typeof receipt.reference !== "string") {
+    return null;
+  }
+  return receipt;
+}
+function readMppRecoveryChannelId(error) {
+  const channelId = record2(error)?.channelId;
+  return typeof channelId === "string" && channelId !== "" ? channelId : null;
+}
+
 // src/solana-session-key.ts
 import {
   verifySignedOwnerTransaction,
@@ -1567,10 +1727,12 @@ function siwxResultToSession(result, now = /* @__PURE__ */ new Date()) {
 }
 export {
   DEFAULT_NOTIFICATION_SETTINGS,
+  DEFAULT_VERIFY_RETRY,
   InvalidUserOperationReceiptError,
   NOTIFICATION_SETTINGS_KEY,
   __resetResolverForTests,
   addInAppNotification,
+  applySettlementVerification,
   assertHexSignature,
   atomicSupportFor,
   bareEvmAddress,
@@ -1591,13 +1753,16 @@ export {
   decodeRevertReason,
   defaultSiwxDomain,
   defaultSiwxUri,
+  describeAuthorization,
   describeChain,
   describePayment,
   eip155ChainIdToNumber,
   encodeErc20Approve,
   encodeErc20Transfer,
   encodeErc20TransferFrom,
+  explainSpend,
   fetchUserOperationReceipt,
+  formatAuthorizationAmount,
   getResolver,
   getSharedSessionKeyManager,
   initialWeb3State,
@@ -1613,8 +1778,13 @@ export {
   normalizeCapabilities,
   normalizeEip155ChainId,
   parseUserOperationReceipt,
+  readCurrentMppSessionChannel,
   readDecimals,
+  readMppRecoveryChannelId,
+  readMppSessionChannel,
+  readMppSessionReceipt,
   readSolanaRoles,
+  replayNotificationSettings,
   resetSharedSessionKeyManager,
   resolveChain,
   resolveContextSimulationEndpoint,