@subscrypts/subscrypts-sdk-react 1.6.0

package/dist/wallet/InjectedConnector.d.ts

@@ -0,0 +1,55 @@
+import { WalletConnector, ConnectResult } from './types';
+
+export declare class InjectedConnector implements WalletConnector {
+    readonly id: "injected";
+    readonly name: string;
+    readonly icon?: string;
+    private provider;
+    private accountsHandler;
+    private chainHandler;
+    constructor(options?: {
+        name?: string;
+        icon?: string;
+    });
+    /**
+     * Detect the installed wallet name from window.ethereum
+     */
+    private detectWalletName;
+    /**
+     * Check if a browser wallet is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Connect to the browser wallet
+     */
+    connect(): Promise<ConnectResult>;
+    /**
+     * Disconnect (reset internal state)
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Silent reconnect: check if already authorized without popup
+     */
+    reconnect(): Promise<ConnectResult | null>;
+    /**
+     * Listen to account changes
+     */
+    onAccountsChanged(callback: (accounts: string[]) => void): void;
+    /**
+     * Listen to chain changes
+     */
+    onChainChanged(callback: (chainId: number) => void): void;
+    /**
+     * Remove all event listeners
+     */
+    removeListeners(): void;
+    /**
+     * Switch to a specific network
+     */
+    switchNetwork(chainId: number): Promise<void>;
+    /**
+     * Add a network to the wallet
+     */
+    private addNetwork;
+}
+//# sourceMappingURL=InjectedConnector.d.ts.map

package/dist/wallet/InjectedConnector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InjectedConnector.d.ts","sourceRoot":"","sources":["../../src/wallet/InjectedConnector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKzD,qBAAa,iBAAkB,YAAW,eAAe;IACvD,QAAQ,CAAC,EAAE,EAAG,UAAU,CAAU;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,YAAY,CAA+C;gBAEvD,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAKtD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAiCvC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA2BhD;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI;IAS/D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAUzD;;OAEG;IACH,eAAe,IAAI,IAAI;IAavB;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBnD;;OAEG;YACW,UAAU;CAyBzB"}

package/dist/wallet/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wallet module exports
+ */
+export type { WalletConnector, ConnectorId, ConnectResult } from './types';
+export { InjectedConnector } from './InjectedConnector';
+export { ExternalConnector } from './ExternalConnector';
+export { saveSession, loadSession, clearSession, isSessionStale } from './sessionStore';
+export type { WalletSession } from './sessionStore';
+//# sourceMappingURL=index.d.ts.map

package/dist/wallet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wallet/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/wallet/sessionStore.d.ts

@@ -0,0 +1,28 @@
+import { ConnectorId } from './types';
+
+/**
+ * Stored wallet session data
+ */
+export interface WalletSession {
+    connectorId: ConnectorId;
+    address: string;
+    timestamp: number;
+}
+/**
+ * Save a wallet session to localStorage
+ */
+export declare function saveSession(connectorId: ConnectorId, address: string): void;
+/**
+ * Load a wallet session from localStorage
+ * Returns null if no session exists or session is invalid
+ */
+export declare function loadSession(): WalletSession | null;
+/**
+ * Clear the stored wallet session
+ */
+export declare function clearSession(): void;
+/**
+ * Check if a session is stale (older than max age)
+ */
+export declare function isSessionStale(session: WalletSession): boolean;
+//# sourceMappingURL=sessionStore.d.ts.map

package/dist/wallet/sessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../src/wallet/sessionStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKtC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAW3E;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,aAAa,GAAG,IAAI,CAkBlD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAMnC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE9D"}

package/dist/wallet/types.d.ts

@@ -0,0 +1,66 @@
+import { BrowserProvider, Signer } from 'ethers';
+
+/**
+ * Connector identifier type.
+ * Built-in: 'injected' (MetaMask/browser), 'external' (Wagmi/RainbowKit).
+ * Custom connectors can use any string.
+ */
+export type ConnectorId = 'injected' | 'external' | (string & {});
+/**
+ * Result of a successful wallet connection
+ */
+export interface ConnectResult {
+    provider: BrowserProvider;
+    signer: Signer;
+    address: string;
+    chainId: number;
+}
+/**
+ * Wallet Connector Interface
+ *
+ * Implement this interface to create a custom wallet connector
+ * for use with the Subscrypts SDK.
+ *
+ * @example
+ * ```typescript
+ * import { WalletConnector, ConnectResult } from '@subscrypts/subscrypts-sdk-react';
+ *
+ * class PrivyConnector implements WalletConnector {
+ *   readonly id = 'privy';
+ *   readonly name = 'Email/Social Login';
+ *   isAvailable() { return true; }
+ *   async connect(): Promise<ConnectResult> {
+ *     // Use Privy SDK to login and get ethers provider/signer
+ *   }
+ *   async disconnect() { /* privy logout *\/ }
+ * }
+ * ```
+ */
+export interface WalletConnector {
+    /** Unique connector identifier */
+    readonly id: ConnectorId;
+    /** Human-readable connector name (e.g. 'MetaMask', 'WalletConnect') */
+    readonly name: string;
+    /** Optional icon URL or data URI */
+    readonly icon?: string;
+    /** Check if this connector is available (e.g. MetaMask installed?) */
+    isAvailable(): boolean;
+    /** Connect the wallet. Shows popup/modal as needed. */
+    connect(): Promise<ConnectResult>;
+    /** Disconnect the wallet */
+    disconnect(): Promise<void>;
+    /**
+     * Silent reconnect without popup (for session persistence).
+     * Returns null if reconnection is not possible.
+     */
+    reconnect?(): Promise<ConnectResult | null>;
+    /** Listen to account changes */
+    onAccountsChanged?(callback: (accounts: string[]) => void): void;
+    /** Listen to chain/network changes */
+    onChainChanged?(callback: (chainId: number) => void): void;
+    /** Remove all event listeners */
+    removeListeners?(): void;
+    /** Switch to a specific network */
+    switchNetwork?(chainId: number): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/wallet/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/wallet/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEjD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,sEAAsE;IACtE,WAAW,IAAI,OAAO,CAAC;IAEvB,uDAAuD;IACvD,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAElC,4BAA4B;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAE5C,gCAAgC;IAChC,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAEjE,sCAAsC;IACtC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAE3D,iCAAiC;IACjC,eAAe,CAAC,IAAI,IAAI,CAAC;IAEzB,mCAAmC;IACnC,aAAa,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@subscrypts/subscrypts-sdk-react",
+  "version": "1.6.0",
+  "description": "Official React SDK for Subscrypts - Decentralized subscriptions on Arbitrum",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./styles": "./dist/style.css",
+    "./hooks": {
+      "import": "./dist/hooks/index.js",
+      "require": "./dist/hooks/index.cjs",
+      "types": "./dist/hooks/index.d.ts"
+    },
+    "./components": {
+      "import": "./dist/components/index.js",
+      "require": "./dist/components/index.cjs",
+      "types": "./dist/components/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build && npm run build:css",
+    "build:css": "tailwindcss -i ./src/styles/index.css -o ./dist/style.css --minify",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext ts,tsx",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "ethers": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "@vitest/ui": "^1.2.0",
+    "@testing-library/react": "^14.1.0",
+    "@testing-library/jest-dom": "^6.2.0",
+    "@testing-library/user-event": "^14.5.0",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^8.57.0",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "happy-dom": "^12.10.0",
+    "postcss": "^8.4.49",
+    "tailwindcss": "^3.4.17",
+    "typescript": "^5.6.0",
+    "vite": "^5.4.11",
+    "vite-plugin-dts": "^3.9.1",
+    "vitest": "^1.2.0"
+  },
+  "dependencies": {},
+  "keywords": [
+    "subscrypts",
+    "subscription",
+    "web3",
+    "arbitrum",
+    "react",
+    "sdk",
+    "ethers",
+    "blockchain",
+    "crypto"
+  ],
+  "author": "Subscrypts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Subscrypts/subscrypts-sdk-react.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Subscrypts/subscrypts-sdk-react/issues"
+  },
+  "homepage": "https://subscrypts.com"
+}