@owney/sdk 0.6.9-beta.1 → 0.6.9-beta.2

package/dist/index.cjs

@@ -26,7 +26,8 @@ __export(index_exports, {
   NotConnectedError: () => NotConnectedError,
   OwneyError: () => OwneyError,
   OwneySDK: () => OwneySDK,
-  createOwneySIWX: () => createOwneySIWX
+  createOwneySIWX: () => createOwneySIWX,
+  setOwneyDebug: () => setOwneyDebug
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -693,6 +694,23 @@ function splittingNeedsUpdate(current, desired) {
   return current.minSplits !== desired.minSplits;
 }
 
+// src/lib/debug.ts
+var configuredDebug = false;
+function setOwneyDebug(enabled) {
+  configuredDebug = enabled;
+}
+function isOwneyDebug() {
+  return globalThis.__OWNEY_DEBUG__ === true || configuredDebug;
+}
+function debugLog(scope, message, data) {
+  if (!isOwneyDebug()) return;
+  if (data === void 0) {
+    console.log(`[${scope}] ${message}`);
+  } else {
+    console.log(`[${scope}] ${message}`, data);
+  }
+}
+
 // src/agents/zyfai/zyfai.agent.ts
 var DEFAULT_ZYFAI_RPC_URLS = {
   8453: "https://base-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V",
@@ -1082,6 +1100,11 @@ var ZyfaiAgent = class {
    * activation.
    */
   async applyOrgPolicy(_state, _chainId, policy) {
+    debugLog("zyfai:splitting", "applying org policy", {
+      policy,
+      // Per asset because Zyfai stores splitting under assetTypeSettings[asset].
+      assets: SPLITTING_ASSETS
+    });
     await Promise.all(
       SPLITTING_ASSETS.map((asset) => this.applySplitting(asset, policy))
     );
@@ -1090,8 +1113,30 @@ var ZyfaiAgent = class {
     try {
       const desired = toZyfaiSplitting(policy);
       const current = await this.sdk.getUserDetails(asset);
-      if (!splittingNeedsUpdate(current, desired)) return;
-      await this.sdk.updateUserProfile({ asset, ...desired });
+      const currentSplitting = {
+        splitting: current?.splitting,
+        minSplits: current?.minSplits
+      };
+      const needsUpdate = splittingNeedsUpdate(current, desired);
+      debugLog("zyfai:splitting", `${asset}: comparing`, {
+        mode: policy.splittingMode,
+        current: currentSplitting,
+        desired,
+        // Spelled out because the "why" is the non-obvious part: minSplits is
+        // what separates automatic (1) from force (2-4), not `splitting`.
+        decision: needsUpdate ? "will write \u2014 profile differs from the org policy" : "skipping \u2014 profile already matches"
+      });
+      if (!needsUpdate) return;
+      const result = await this.sdk.updateUserProfile({ asset, ...desired });
+      debugLog("zyfai:splitting", `${asset}: wrote updateUserProfile`, {
+        sent: { asset, ...desired },
+        // updateUserProfile re-reads the profile after PATCHing, so this is
+        // Zyfai's own view of the result rather than an echo of what we sent.
+        zyfaiNowReports: {
+          splitting: result?.splitting,
+          minSplits: result?.minSplits
+        }
+      });
     } catch (error) {
       console.warn(
         `[zyfai] applyOrgPolicy(${asset}) failed (non-fatal):`,
@@ -1271,7 +1316,13 @@ async function fetchOrgAgentConfig(apiKey) {
       return null;
     }
     const json = await res.json();
-    return json.success ? json.data ?? null : null;
+    const policy = json.success ? json.data ?? null : null;
+    debugLog(
+      "owney-sdk",
+      policy ? "org agent config: loaded" : "org agent config: none set by this partner \u2014 user profiles will be left as they are",
+      policy ?? void 0
+    );
+    return policy;
   } catch (error) {
     console.warn(
       "[owney-sdk] Could not read org agent config (non-fatal):",
@@ -1907,6 +1958,7 @@ var OwneySDK = class {
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
+    if (config.debug) setOwneyDebug(true);
     this.zyfaiRpcUrls = config.zyfaiRpcUrls;
     this.routingApiBaseUrl = config.routingApiBaseUrl;
     this.referralSource = config.referralSource;
@@ -2093,7 +2145,13 @@ var OwneySDK = class {
    * user's connect over.
    */
   async applyOrgPolicyTo(agent, state, chainId) {
-    if (!agent.applyOrgPolicy) return;
+    if (!agent.applyOrgPolicy) {
+      debugLog(
+        "owney-sdk",
+        `${agent.id}: no applyOrgPolicy \u2014 agent has no org-level knobs, skipping`
+      );
+      return;
+    }
     try {
       const policy = await this.getOrgAgentConfig();
       if (!policy) return;
@@ -3227,5 +3285,6 @@ function createOwneySIWX(config) {
   NotConnectedError,
   OwneyError,
   OwneySDK,
-  createOwneySIWX
+  createOwneySIWX,
+  setOwneyDebug
 });

package/dist/index.d.cts

@@ -21,6 +21,15 @@ interface OwneySDKConfig {
      * `createOwneySIWX` for apps that don't use the AppKit SIWX modal.
      */
     referralSource?: string;
+    /**
+     * Turn on the SDK's debug logging (default false). Traces the decisions that
+     * are otherwise invisible — notably how the organization's agent policy is
+     * compared against each user's Zyfai profile and whether it writes.
+     *
+     * Also switchable at runtime without a rebuild, which is what you want on an
+     * already-deployed app: set `globalThis.__OWNEY_DEBUG__ = true` in devtools.
+     */
+    debug?: boolean;
 }
 interface ConnectionState {
     provider: any;
@@ -594,6 +603,29 @@ declare class InvalidHistoryCursorError extends Error {
     constructor(message: string);
 }
 
+/**
+ * Opt-in debug logging.
+ *
+ * The SDK is deliberately quiet: before this, `src/` contained no `console.log`
+ * at all, only `console.warn`/`console.error` for genuine faults. That is worth
+ * preserving — this runs inside every partner's app, on every user's connect, so
+ * unconditional chatter would land in end users' consoles forever.
+ *
+ * Two ways to turn it on:
+ *
+ *   1. From the app:        new OwneySDK({ apiKey, debug: true })
+ *   2. From devtools, live: globalThis.__OWNEY_DEBUG__ = true
+ *
+ * (2) is the useful one when diagnosing something on an already-deployed app:
+ * the flag is read on every call, not captured once, so flipping it in the
+ * console takes effect on the next action without a rebuild or a republish.
+ */
+declare global {
+    var __OWNEY_DEBUG__: boolean | undefined;
+}
+/** Enable/disable debug logging programmatically. */
+declare function setOwneyDebug(enabled: boolean): void;
+
 type OwneySIWXConfig = {
     /** Owney/Zyfai API key — same value passed to `new OwneySDK({ apiKey })`. */
     apiKey: string;
@@ -607,4 +639,4 @@ type OwneySIWXConfig = {
  */
 declare function createOwneySIWX(config: OwneySIWXConfig): SIWXConfig;
 
-export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, AllocationAgentApy, AllocationApyOptions, ApyByChainAndAsset, ApyHistoryPoint, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentApy, OwneyAgentHistory, OwneyAllocationApy, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyPosition, OwneySDK, OwneySDKConfig, OwneySIWXConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions, createOwneySIWX };
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, AllocationAgentApy, AllocationApyOptions, ApyByChainAndAsset, ApyHistoryPoint, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentApy, OwneyAgentHistory, OwneyAllocationApy, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyPosition, OwneySDK, OwneySDKConfig, OwneySIWXConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions, createOwneySIWX, setOwneyDebug };

package/dist/index.d.ts

@@ -21,6 +21,15 @@ interface OwneySDKConfig {
      * `createOwneySIWX` for apps that don't use the AppKit SIWX modal.
      */
     referralSource?: string;
+    /**
+     * Turn on the SDK's debug logging (default false). Traces the decisions that
+     * are otherwise invisible — notably how the organization's agent policy is
+     * compared against each user's Zyfai profile and whether it writes.
+     *
+     * Also switchable at runtime without a rebuild, which is what you want on an
+     * already-deployed app: set `globalThis.__OWNEY_DEBUG__ = true` in devtools.
+     */
+    debug?: boolean;
 }
 interface ConnectionState {
     provider: any;
@@ -594,6 +603,29 @@ declare class InvalidHistoryCursorError extends Error {
     constructor(message: string);
 }
 
+/**
+ * Opt-in debug logging.
+ *
+ * The SDK is deliberately quiet: before this, `src/` contained no `console.log`
+ * at all, only `console.warn`/`console.error` for genuine faults. That is worth
+ * preserving — this runs inside every partner's app, on every user's connect, so
+ * unconditional chatter would land in end users' consoles forever.
+ *
+ * Two ways to turn it on:
+ *
+ *   1. From the app:        new OwneySDK({ apiKey, debug: true })
+ *   2. From devtools, live: globalThis.__OWNEY_DEBUG__ = true
+ *
+ * (2) is the useful one when diagnosing something on an already-deployed app:
+ * the flag is read on every call, not captured once, so flipping it in the
+ * console takes effect on the next action without a rebuild or a republish.
+ */
+declare global {
+    var __OWNEY_DEBUG__: boolean | undefined;
+}
+/** Enable/disable debug logging programmatically. */
+declare function setOwneyDebug(enabled: boolean): void;
+
 type OwneySIWXConfig = {
     /** Owney/Zyfai API key — same value passed to `new OwneySDK({ apiKey })`. */
     apiKey: string;
@@ -607,4 +639,4 @@ type OwneySIWXConfig = {
  */
 declare function createOwneySIWX(config: OwneySIWXConfig): SIWXConfig;
 
-export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, AllocationAgentApy, AllocationApyOptions, ApyByChainAndAsset, ApyHistoryPoint, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentApy, OwneyAgentHistory, OwneyAllocationApy, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyPosition, OwneySDK, OwneySDKConfig, OwneySIWXConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions, createOwneySIWX };
+export { AccountAgentApy, AccountApyOptions, AgentApy, AgentApyDetails, AgentBalance, AgentChainIncompatibleError, AgentEarnings, AgentHistoryEntry, AgentHistoryPosition, AgentId, AgentNotFoundError, AgentSupportedAsset, AgentSupportedAssets, AgentUserProfile, AgentWithdrawResult, AgentsApyOptions, AllocationAgentApy, AllocationApyOptions, ApyByChainAndAsset, ApyHistoryPoint, Asset, ConnectionState, DailyApyDays, DepositCallback, DepositOptions, HistoryAction, HistoryFilters, HistoryOptions, HistoryTransaction, IAgent, InvalidHistoryCursorError, NotConnectedError, OwneyAccountApy, OwneyAgentApy, OwneyAgentHistory, OwneyAllocationApy, OwneyBalances, OwneyDepositResult, OwneyEarnings, OwneyError, OwneyErrorCode, OwneyMultiDepositResult, OwneyPosition, OwneySDK, OwneySDKConfig, OwneySIWXConfig, OwneySupportedChainId, OwneySupportedChains, OwneySupportedTokens, OwneyToken, OwneyUserProfile, OwneyWithdrawResult, RebalanceLog, WithdrawOptions, createOwneySIWX, setOwneyDebug };

package/dist/index.js

@@ -661,6 +661,23 @@ function splittingNeedsUpdate(current, desired) {
   return current.minSplits !== desired.minSplits;
 }
 
+// src/lib/debug.ts
+var configuredDebug = false;
+function setOwneyDebug(enabled) {
+  configuredDebug = enabled;
+}
+function isOwneyDebug() {
+  return globalThis.__OWNEY_DEBUG__ === true || configuredDebug;
+}
+function debugLog(scope, message, data) {
+  if (!isOwneyDebug()) return;
+  if (data === void 0) {
+    console.log(`[${scope}] ${message}`);
+  } else {
+    console.log(`[${scope}] ${message}`, data);
+  }
+}
+
 // src/agents/zyfai/zyfai.agent.ts
 var DEFAULT_ZYFAI_RPC_URLS = {
   8453: "https://base-mainnet.g.alchemy.com/v2/ZWyVU-9XfS3z8Rn-xkq7V",
@@ -1050,6 +1067,11 @@ var ZyfaiAgent = class {
    * activation.
    */
   async applyOrgPolicy(_state, _chainId, policy) {
+    debugLog("zyfai:splitting", "applying org policy", {
+      policy,
+      // Per asset because Zyfai stores splitting under assetTypeSettings[asset].
+      assets: SPLITTING_ASSETS
+    });
     await Promise.all(
       SPLITTING_ASSETS.map((asset) => this.applySplitting(asset, policy))
     );
@@ -1058,8 +1080,30 @@ var ZyfaiAgent = class {
     try {
       const desired = toZyfaiSplitting(policy);
       const current = await this.sdk.getUserDetails(asset);
-      if (!splittingNeedsUpdate(current, desired)) return;
-      await this.sdk.updateUserProfile({ asset, ...desired });
+      const currentSplitting = {
+        splitting: current?.splitting,
+        minSplits: current?.minSplits
+      };
+      const needsUpdate = splittingNeedsUpdate(current, desired);
+      debugLog("zyfai:splitting", `${asset}: comparing`, {
+        mode: policy.splittingMode,
+        current: currentSplitting,
+        desired,
+        // Spelled out because the "why" is the non-obvious part: minSplits is
+        // what separates automatic (1) from force (2-4), not `splitting`.
+        decision: needsUpdate ? "will write \u2014 profile differs from the org policy" : "skipping \u2014 profile already matches"
+      });
+      if (!needsUpdate) return;
+      const result = await this.sdk.updateUserProfile({ asset, ...desired });
+      debugLog("zyfai:splitting", `${asset}: wrote updateUserProfile`, {
+        sent: { asset, ...desired },
+        // updateUserProfile re-reads the profile after PATCHing, so this is
+        // Zyfai's own view of the result rather than an echo of what we sent.
+        zyfaiNowReports: {
+          splitting: result?.splitting,
+          minSplits: result?.minSplits
+        }
+      });
     } catch (error) {
       console.warn(
         `[zyfai] applyOrgPolicy(${asset}) failed (non-fatal):`,
@@ -1239,7 +1283,13 @@ async function fetchOrgAgentConfig(apiKey) {
       return null;
     }
     const json = await res.json();
-    return json.success ? json.data ?? null : null;
+    const policy = json.success ? json.data ?? null : null;
+    debugLog(
+      "owney-sdk",
+      policy ? "org agent config: loaded" : "org agent config: none set by this partner \u2014 user profiles will be left as they are",
+      policy ?? void 0
+    );
+    return policy;
   } catch (error) {
     console.warn(
       "[owney-sdk] Could not read org agent config (non-fatal):",
@@ -1879,6 +1929,7 @@ var OwneySDK = class {
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
+    if (config.debug) setOwneyDebug(true);
     this.zyfaiRpcUrls = config.zyfaiRpcUrls;
     this.routingApiBaseUrl = config.routingApiBaseUrl;
     this.referralSource = config.referralSource;
@@ -2065,7 +2116,13 @@ var OwneySDK = class {
    * user's connect over.
    */
   async applyOrgPolicyTo(agent, state, chainId) {
-    if (!agent.applyOrgPolicy) return;
+    if (!agent.applyOrgPolicy) {
+      debugLog(
+        "owney-sdk",
+        `${agent.id}: no applyOrgPolicy \u2014 agent has no org-level knobs, skipping`
+      );
+      return;
+    }
     try {
       const policy = await this.getOrgAgentConfig();
       if (!policy) return;
@@ -3198,5 +3255,6 @@ export {
   NotConnectedError,
   OwneyError,
   OwneySDK,
-  createOwneySIWX
+  createOwneySIWX,
+  setOwneyDebug
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owney/sdk",
-  "version": "0.6.9-beta.1",
+  "version": "0.6.9-beta.2",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",