@thehoneyjar/sigil-lens 0.1.0

package/dist/wagmi.js

@@ -0,0 +1,74 @@
+// src/wagmi.ts
+import { useAccount } from "wagmi";
+import { useEffect } from "react";
+
+// src/store.ts
+import { create } from "zustand";
+import { persist } from "zustand/middleware";
+var initialState = {
+  enabled: false,
+  impersonatedAddress: null,
+  realAddress: null,
+  savedAddresses: []
+};
+var useLensStore = create()(
+  persist(
+    (set) => ({
+      ...initialState,
+      setImpersonatedAddress: (address) => set({
+        enabled: true,
+        impersonatedAddress: address
+      }),
+      clearImpersonation: () => set({
+        enabled: false,
+        impersonatedAddress: null
+      }),
+      setRealAddress: (address) => set({ realAddress: address }),
+      saveAddress: (entry) => set((state) => {
+        if (state.savedAddresses.some((a) => a.address === entry.address)) {
+          return state;
+        }
+        return {
+          savedAddresses: [
+            ...state.savedAddresses,
+            { ...entry, addedAt: Date.now() }
+          ]
+        };
+      }),
+      removeAddress: (address) => set((state) => ({
+        savedAddresses: state.savedAddresses.filter((a) => a.address !== address)
+      })),
+      reset: () => set(initialState)
+    }),
+    {
+      name: "sigil-lens-storage",
+      partialize: (state) => ({
+        savedAddresses: state.savedAddresses
+      })
+    }
+  )
+);
+
+// src/wagmi.ts
+function useLensAwareAccount() {
+  const { address: realAddress, isConnected } = useAccount();
+  const setRealAddress = useLensStore((state) => state.setRealAddress);
+  useEffect(() => {
+    setRealAddress(realAddress ?? null);
+  }, [realAddress, setRealAddress]);
+  const enabled = useLensStore((state) => state.enabled);
+  const impersonatedAddress = useLensStore((state) => state.impersonatedAddress);
+  const isImpersonating = enabled && impersonatedAddress !== null;
+  const address = isImpersonating ? impersonatedAddress : realAddress;
+  return {
+    address,
+    realAddress,
+    isImpersonating,
+    impersonatedAddress,
+    isConnected
+  };
+}
+export {
+  useLensAwareAccount
+};
+//# sourceMappingURL=wagmi.js.map

package/dist/wagmi.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wagmi.ts","../src/store.ts"],"sourcesContent":["/**\n * Lens Wagmi Integration\n *\n * Wagmi-aware hooks for lens functionality.\n */\n\nimport { useAccount } from 'wagmi'\nimport { useEffect } from 'react'\nimport type { Address } from 'viem'\nimport { useLensStore } from './store'\n\n/**\n * Return type for useLensAwareAccount\n */\nexport interface LensAwareAccount {\n  /** Address for reads - impersonated if lens enabled, otherwise real */\n  address: Address | undefined\n  /** The user's real connected address (always available for signing) */\n  realAddress: Address | undefined\n  /** Whether currently impersonating another address */\n  isImpersonating: boolean\n  /** The impersonated address (if any) */\n  impersonatedAddress: Address | null\n  /** Whether the wallet is connected */\n  isConnected: boolean\n}\n\n/**\n * Hook that returns impersonated address for reads, real address for writes.\n *\n * Use this hook in place of wagmi's `useAccount` when you want components\n * to display data for an impersonated address while still being able to\n * sign transactions with the real connected wallet.\n *\n * @example\n * ```tsx\n * function WalletInfo() {\n *   const { address, realAddress, isImpersonating } = useLensAwareAccount()\n *\n *   // Use `address` for reading data (respects impersonation)\n *   const { data: balance } = useBalance({ address })\n *\n *   // Use `realAddress` for signing transactions\n *   const { writeContract } = useWriteContract()\n *\n *   return (\n *     <div>\n *       <p>Viewing: {address}</p>\n *       {isImpersonating && <Badge>Lens Active</Badge>}\n *       <button onClick={() => writeContract({ ... })}>\n *         Sign with {realAddress}\n *       </button>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useLensAwareAccount(): LensAwareAccount {\n  const { address: realAddress, isConnected } = useAccount()\n  const setRealAddress = useLensStore((state) => state.setRealAddress)\n\n  // Sync real address to lens store\n  useEffect(() => {\n    setRealAddress(realAddress ?? null)\n  }, [realAddress, setRealAddress])\n\n  const enabled = useLensStore((state) => state.enabled)\n  const impersonatedAddress = useLensStore((state) => state.impersonatedAddress)\n\n  const isImpersonating = enabled && impersonatedAddress !== null\n  const address = isImpersonating ? impersonatedAddress : realAddress\n\n  return {\n    address,\n    realAddress,\n    isImpersonating,\n    impersonatedAddress,\n    isConnected,\n  }\n}\n","/**\n * Lens Store\n *\n * Zustand store for lens state management.\n */\n\nimport { create } from 'zustand'\nimport { persist } from 'zustand/middleware'\nimport type { Address } from 'viem'\nimport type { LensState, SavedAddress } from './types'\n\n/**\n * Lens store actions\n */\ninterface LensActions {\n  setImpersonatedAddress: (address: Address) => void\n  clearImpersonation: () => void\n  setRealAddress: (address: Address | null) => void\n  saveAddress: (entry: Omit<SavedAddress, 'addedAt'>) => void\n  removeAddress: (address: Address) => void\n  reset: () => void\n}\n\n/**\n * Combined lens store type\n */\nexport type LensStore = LensState & LensActions\n\n/**\n * Initial lens state\n */\nconst initialState: LensState = {\n  enabled: false,\n  impersonatedAddress: null,\n  realAddress: null,\n  savedAddresses: [],\n}\n\n/**\n * Create the lens store\n */\nexport const useLensStore = create<LensStore>()(\n  persist(\n    (set) => ({\n      ...initialState,\n\n      setImpersonatedAddress: (address: Address) =>\n        set({\n          enabled: true,\n          impersonatedAddress: address,\n        }),\n\n      clearImpersonation: () =>\n        set({\n          enabled: false,\n          impersonatedAddress: null,\n        }),\n\n      setRealAddress: (address: Address | null) =>\n        set({ realAddress: address }),\n\n      saveAddress: (entry: Omit<SavedAddress, 'addedAt'>) =>\n        set((state) => {\n          // Don't add duplicates\n          if (state.savedAddresses.some((a) => a.address === entry.address)) {\n            return state\n          }\n          return {\n            savedAddresses: [\n              ...state.savedAddresses,\n              { ...entry, addedAt: Date.now() },\n            ],\n          }\n        }),\n\n      removeAddress: (address: Address) =>\n        set((state) => ({\n          savedAddresses: state.savedAddresses.filter((a) => a.address !== address),\n        })),\n\n      reset: () => set(initialState),\n    }),\n    {\n      name: 'sigil-lens-storage',\n      partialize: (state) => ({\n        savedAddresses: state.savedAddresses,\n      }),\n    }\n  )\n)\n\n/**\n * Get lens store state (for non-React contexts)\n */\nexport function getLensState(): LensState {\n  const state = useLensStore.getState()\n  return {\n    enabled: state.enabled,\n    impersonatedAddress: state.impersonatedAddress,\n    realAddress: state.realAddress,\n    savedAddresses: state.savedAddresses,\n  }\n}\n"],"mappings":";AAMA,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;;;ACD1B,SAAS,cAAc;AACvB,SAAS,eAAe;AAwBxB,IAAM,eAA0B;AAAA,EAC9B,SAAS;AAAA,EACT,qBAAqB;AAAA,EACrB,aAAa;AAAA,EACb,gBAAgB,CAAC;AACnB;AAKO,IAAM,eAAe,OAAkB;AAAA,EAC5C;AAAA,IACE,CAAC,SAAS;AAAA,MACR,GAAG;AAAA,MAEH,wBAAwB,CAAC,YACvB,IAAI;AAAA,QACF,SAAS;AAAA,QACT,qBAAqB;AAAA,MACvB,CAAC;AAAA,MAEH,oBAAoB,MAClB,IAAI;AAAA,QACF,SAAS;AAAA,QACT,qBAAqB;AAAA,MACvB,CAAC;AAAA,MAEH,gBAAgB,CAAC,YACf,IAAI,EAAE,aAAa,QAAQ,CAAC;AAAA,MAE9B,aAAa,CAAC,UACZ,IAAI,CAAC,UAAU;AAEb,YAAI,MAAM,eAAe,KAAK,CAAC,MAAM,EAAE,YAAY,MAAM,OAAO,GAAG;AACjE,iBAAO;AAAA,QACT;AACA,eAAO;AAAA,UACL,gBAAgB;AAAA,YACd,GAAG,MAAM;AAAA,YACT,EAAE,GAAG,OAAO,SAAS,KAAK,IAAI,EAAE;AAAA,UAClC;AAAA,QACF;AAAA,MACF,CAAC;AAAA,MAEH,eAAe,CAAC,YACd,IAAI,CAAC,WAAW;AAAA,QACd,gBAAgB,MAAM,eAAe,OAAO,CAAC,MAAM,EAAE,YAAY,OAAO;AAAA,MAC1E,EAAE;AAAA,MAEJ,OAAO,MAAM,IAAI,YAAY;AAAA,IAC/B;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,YAAY,CAAC,WAAW;AAAA,QACtB,gBAAgB,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AACF;;;ADhCO,SAAS,sBAAwC;AACtD,QAAM,EAAE,SAAS,aAAa,YAAY,IAAI,WAAW;AACzD,QAAM,iBAAiB,aAAa,CAAC,UAAU,MAAM,cAAc;AAGnE,YAAU,MAAM;AACd,mBAAe,eAAe,IAAI;AAAA,EACpC,GAAG,CAAC,aAAa,cAAc,CAAC;AAEhC,QAAM,UAAU,aAAa,CAAC,UAAU,MAAM,OAAO;AACrD,QAAM,sBAAsB,aAAa,CAAC,UAAU,MAAM,mBAAmB;AAE7E,QAAM,kBAAkB,WAAW,wBAAwB;AAC3D,QAAM,UAAU,kBAAkB,sBAAsB;AAExD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@thehoneyjar/sigil-lens",
+  "version": "0.1.0",
+  "description": "Address impersonation for testing different user states",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./wagmi": {
+      "import": "./dist/wagmi.js",
+      "types": "./dist/wagmi.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "viem": "^2.0.0",
+    "wagmi": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "wagmi": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "zustand": "^4.4.7"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/react": "^18.2.45",
+    "react": "^18.2.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "viem": "^2.0.0",
+    "vitest": "^1.2.0",
+    "wagmi": "^2.0.0"
+  },
+  "keywords": [
+    "sigil",
+    "lens",
+    "impersonation",
+    "web3",
+    "testing"
+  ],
+  "author": "Sigil Framework",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/0xHoneyJar/sigil.git",
+    "directory": "packages/lens"
+  },
+  "bugs": {
+    "url": "https://github.com/0xHoneyJar/sigil/issues"
+  },
+  "homepage": "https://github.com/0xHoneyJar/sigil/tree/main/packages/lens#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx"
+  }
+}