@campnetwork/origin 1.2.0-1 → 1.2.0-3

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import { Address, Hex, WalletClient, Abi } from 'viem';
+import { Address, Hex, WalletClient, Abi, Account, Chain } from 'viem';
 
 /**
  * The TwitterAPI class.
@@ -234,6 +234,15 @@ declare enum DataStatus {
     PENDING_DELETE = 1,
     DELETED = 2
 }
+/**
+ * Creates license terms for a digital asset.
+ * @param price The price of the asset in wei.
+ * @param duration The duration of the license in seconds.
+ * @param royaltyBps The royalty percentage in basis points (0-10000).
+ * @param paymentToken The address of the payment token (ERC20 / address(0) for native currency).
+ * @returns The created license terms.
+ */
+declare const createLicenseTerms: (price: bigint, duration: number, royaltyBps: number, paymentToken: Address) => LicenseTerms;
 /**
  * Represents the source of an IpNFT.
  * This can be one of the supported social media platforms or a file upload.
@@ -493,6 +502,30 @@ declare class Origin {
     claimRoyalties(tokenId: bigint, recipient?: Address, token?: Address): Promise<any>;
 }
 
+interface StorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+/**
+ * Browser localStorage adapter
+ */
+declare class BrowserStorage implements StorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+/**
+ * In-memory storage adapter for Node.js
+ */
+declare class MemoryStorage implements StorageAdapter {
+    private storage;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): void;
+}
+
 declare global {
     interface Window {
         ethereum?: any;
@@ -520,12 +553,14 @@ declare class Auth {
      * @param {string} options.clientId The client ID.
      * @param {string|object} options.redirectUri The redirect URI used for oauth. Leave empty if you want to use the current URL. If you want different redirect URIs for different socials, pass an object with the socials as keys and the redirect URIs as values.
      * @param {("DEVELOPMENT"|"PRODUCTION")} [options.environment="DEVELOPMENT"] The environment to use.
+     * @param {StorageAdapter} [options.storage] Custom storage adapter. Defaults to localStorage in browser, memory storage in Node.js.
      * @throws {APIError} - Throws an error if the clientId is not provided.
      */
-    constructor({ clientId, redirectUri, environment, }: {
+    constructor({ clientId, redirectUri, environment, storage, }: {
         clientId: string;
         redirectUri: string | Record<string, string>;
         environment?: "DEVELOPMENT" | "PRODUCTION";
+        storage?: StorageAdapter;
     });
     /**
      * Subscribe to an event. Possible events are "state", "provider", "providers", and "viem".
@@ -588,6 +623,33 @@ declare class Auth {
         message: string;
         walletAddress: string;
     }>;
+    /**
+     * Connect with a custom signer (for Node.js or custom wallet implementations).
+     * This method bypasses browser wallet interactions and uses the provided signer directly.
+     * @param {any} signer The signer instance (viem WalletClient, ethers Signer, or custom signer).
+     * @param {object} [options] Optional configuration.
+     * @param {string} [options.domain] The domain to use in SIWE message (defaults to 'localhost').
+     * @param {string} [options.uri] The URI to use in SIWE message (defaults to 'http://localhost').
+     * @returns {Promise<{ success: boolean; message: string; walletAddress: string }>} A promise that resolves with the authentication result.
+     * @throws {APIError} - Throws an error if authentication fails.
+     * @example
+     * // Using with ethers
+     * const signer = new ethers.Wallet(privateKey, provider);
+     * await auth.connectWithSigner(signer, { domain: 'myapp.com', uri: 'https://myapp.com' });
+     *
+     * // Using with viem
+     * const account = privateKeyToAccount('0x...');
+     * const client = createWalletClient({ account, chain: mainnet, transport: http() });
+     * await auth.connectWithSigner(client);
+     */
+    connectWithSigner(signer: any, options?: {
+        domain?: string;
+        uri?: string;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        walletAddress: string;
+    }>;
     /**
      * Get the user's linked social accounts.
      * @returns {Promise<Record<string, boolean>>} A promise that resolves with the user's linked social accounts.
@@ -601,19 +663,19 @@ declare class Auth {
     /**
      * Link the user's Twitter account.
      * @returns {Promise<void>}
-     * @throws {Error} - Throws an error if the user is not authenticated.
+     * @throws {Error} - Throws an error if the user is not authenticated or in Node.js environment.
      */
     linkTwitter(): Promise<void>;
     /**
      * Link the user's Discord account.
      * @returns {Promise<void>}
-     * @throws {Error} - Throws an error if the user is not authenticated.
+     * @throws {Error} - Throws an error if the user is not authenticated or in Node.js environment.
      */
     linkDiscord(): Promise<void>;
     /**
      * Link the user's Spotify account.
      * @returns {Promise<void>}
-     * @throws {Error} - Throws an error if the user is not authenticated.
+     * @throws {Error} - Throws an error if the user is not authenticated or in Node.js environment.
      */
     linkSpotify(): Promise<void>;
     /**
@@ -676,4 +738,106 @@ declare class Auth {
     unlinkTelegram(): Promise<any>;
 }
 
-export { Auth, SpotifyAPI, TwitterAPI };
+interface BaseSigner {
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+type SignerType = "viem" | "ethers" | "custom";
+interface SignerAdapter {
+    type: SignerType;
+    signer: any;
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+
+/**
+ * Adapter for viem WalletClient
+ */
+declare class ViemSignerAdapter implements SignerAdapter {
+    type: SignerType;
+    signer: WalletClient;
+    constructor(signer: WalletClient);
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+/**
+ * Adapter for ethers Signer (v5 and v6)
+ */
+declare class EthersSignerAdapter implements SignerAdapter {
+    type: SignerType;
+    signer: any;
+    constructor(signer: any);
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+/**
+ * Adapter for custom signer implementations
+ */
+declare class CustomSignerAdapter implements SignerAdapter {
+    type: SignerType;
+    signer: any;
+    constructor(signer: any);
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+/**
+ * Factory function to create appropriate adapter based on signer type
+ */
+declare function createSignerAdapter(signer: any): SignerAdapter;
+
+/**
+ * Create a wallet client for Node.js environment
+ * @param account The viem account
+ * @param chain The chain to use
+ * @param rpcUrl Optional RPC URL (defaults to chain's default RPC)
+ * @returns WalletClient
+ */
+declare function createNodeWalletClient(account: Account, chain: Chain, rpcUrl?: string): WalletClient;
+
+declare const testnet: {
+    id: number;
+    name: string;
+    nativeCurrency: {
+        decimals: number;
+        name: string;
+        symbol: string;
+    };
+    rpcUrls: {
+        default: {
+            http: string[];
+        };
+    };
+    blockExplorers: {
+        default: {
+            name: string;
+            url: string;
+        };
+    };
+};
+declare const mainnet: {
+    id: number;
+    name: string;
+    nativeCurrency: {
+        decimals: number;
+        name: string;
+        symbol: string;
+    };
+    rpcUrls: {
+        default: {
+            http: string[];
+        };
+    };
+    blockExplorers: {
+        default: {
+            name: string;
+            url: string;
+        };
+    };
+};
+
+export { Auth, type BaseSigner, BrowserStorage, CustomSignerAdapter, DataStatus, EthersSignerAdapter, type LicenseTerms, MemoryStorage, type SignerAdapter, type SignerType, SpotifyAPI, type StorageAdapter, TwitterAPI, ViemSignerAdapter, mainnet as campMainnet, testnet as campTestnet, createLicenseTerms, createNodeWalletClient, createSignerAdapter };

package/dist/core.esm.d.ts

@@ -1,4 +1,4 @@
-import { Address, Hex, WalletClient, Abi } from 'viem';
+import { Address, Hex, WalletClient, Abi, Account, Chain } from 'viem';
 
 /**
  * The TwitterAPI class.
@@ -234,6 +234,15 @@ declare enum DataStatus {
     PENDING_DELETE = 1,
     DELETED = 2
 }
+/**
+ * Creates license terms for a digital asset.
+ * @param price The price of the asset in wei.
+ * @param duration The duration of the license in seconds.
+ * @param royaltyBps The royalty percentage in basis points (0-10000).
+ * @param paymentToken The address of the payment token (ERC20 / address(0) for native currency).
+ * @returns The created license terms.
+ */
+declare const createLicenseTerms: (price: bigint, duration: number, royaltyBps: number, paymentToken: Address) => LicenseTerms;
 /**
  * Represents the source of an IpNFT.
  * This can be one of the supported social media platforms or a file upload.
@@ -493,6 +502,30 @@ declare class Origin {
     claimRoyalties(tokenId: bigint, recipient?: Address, token?: Address): Promise<any>;
 }
 
+interface StorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+/**
+ * Browser localStorage adapter
+ */
+declare class BrowserStorage implements StorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+/**
+ * In-memory storage adapter for Node.js
+ */
+declare class MemoryStorage implements StorageAdapter {
+    private storage;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): void;
+}
+
 declare global {
     interface Window {
         ethereum?: any;
@@ -520,12 +553,14 @@ declare class Auth {
      * @param {string} options.clientId The client ID.
      * @param {string|object} options.redirectUri The redirect URI used for oauth. Leave empty if you want to use the current URL. If you want different redirect URIs for different socials, pass an object with the socials as keys and the redirect URIs as values.
      * @param {("DEVELOPMENT"|"PRODUCTION")} [options.environment="DEVELOPMENT"] The environment to use.
+     * @param {StorageAdapter} [options.storage] Custom storage adapter. Defaults to localStorage in browser, memory storage in Node.js.
      * @throws {APIError} - Throws an error if the clientId is not provided.
      */
-    constructor({ clientId, redirectUri, environment, }: {
+    constructor({ clientId, redirectUri, environment, storage, }: {
         clientId: string;
         redirectUri: string | Record<string, string>;
         environment?: "DEVELOPMENT" | "PRODUCTION";
+        storage?: StorageAdapter;
     });
     /**
      * Subscribe to an event. Possible events are "state", "provider", "providers", and "viem".
@@ -588,6 +623,33 @@ declare class Auth {
         message: string;
         walletAddress: string;
     }>;
+    /**
+     * Connect with a custom signer (for Node.js or custom wallet implementations).
+     * This method bypasses browser wallet interactions and uses the provided signer directly.
+     * @param {any} signer The signer instance (viem WalletClient, ethers Signer, or custom signer).
+     * @param {object} [options] Optional configuration.
+     * @param {string} [options.domain] The domain to use in SIWE message (defaults to 'localhost').
+     * @param {string} [options.uri] The URI to use in SIWE message (defaults to 'http://localhost').
+     * @returns {Promise<{ success: boolean; message: string; walletAddress: string }>} A promise that resolves with the authentication result.
+     * @throws {APIError} - Throws an error if authentication fails.
+     * @example
+     * // Using with ethers
+     * const signer = new ethers.Wallet(privateKey, provider);
+     * await auth.connectWithSigner(signer, { domain: 'myapp.com', uri: 'https://myapp.com' });
+     *
+     * // Using with viem
+     * const account = privateKeyToAccount('0x...');
+     * const client = createWalletClient({ account, chain: mainnet, transport: http() });
+     * await auth.connectWithSigner(client);
+     */
+    connectWithSigner(signer: any, options?: {
+        domain?: string;
+        uri?: string;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        walletAddress: string;
+    }>;
     /**
      * Get the user's linked social accounts.
      * @returns {Promise<Record<string, boolean>>} A promise that resolves with the user's linked social accounts.
@@ -601,19 +663,19 @@ declare class Auth {
     /**
      * Link the user's Twitter account.
      * @returns {Promise<void>}
-     * @throws {Error} - Throws an error if the user is not authenticated.
+     * @throws {Error} - Throws an error if the user is not authenticated or in Node.js environment.
      */
     linkTwitter(): Promise<void>;
     /**
      * Link the user's Discord account.
      * @returns {Promise<void>}
-     * @throws {Error} - Throws an error if the user is not authenticated.
+     * @throws {Error} - Throws an error if the user is not authenticated or in Node.js environment.
      */
     linkDiscord(): Promise<void>;
     /**
      * Link the user's Spotify account.
      * @returns {Promise<void>}
-     * @throws {Error} - Throws an error if the user is not authenticated.
+     * @throws {Error} - Throws an error if the user is not authenticated or in Node.js environment.
      */
     linkSpotify(): Promise<void>;
     /**
@@ -676,4 +738,106 @@ declare class Auth {
     unlinkTelegram(): Promise<any>;
 }
 
-export { Auth, SpotifyAPI, TwitterAPI };
+interface BaseSigner {
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+type SignerType = "viem" | "ethers" | "custom";
+interface SignerAdapter {
+    type: SignerType;
+    signer: any;
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+
+/**
+ * Adapter for viem WalletClient
+ */
+declare class ViemSignerAdapter implements SignerAdapter {
+    type: SignerType;
+    signer: WalletClient;
+    constructor(signer: WalletClient);
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+/**
+ * Adapter for ethers Signer (v5 and v6)
+ */
+declare class EthersSignerAdapter implements SignerAdapter {
+    type: SignerType;
+    signer: any;
+    constructor(signer: any);
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+/**
+ * Adapter for custom signer implementations
+ */
+declare class CustomSignerAdapter implements SignerAdapter {
+    type: SignerType;
+    signer: any;
+    constructor(signer: any);
+    getAddress(): Promise<string>;
+    signMessage(message: string): Promise<string>;
+    getChainId(): Promise<number>;
+}
+/**
+ * Factory function to create appropriate adapter based on signer type
+ */
+declare function createSignerAdapter(signer: any): SignerAdapter;
+
+/**
+ * Create a wallet client for Node.js environment
+ * @param account The viem account
+ * @param chain The chain to use
+ * @param rpcUrl Optional RPC URL (defaults to chain's default RPC)
+ * @returns WalletClient
+ */
+declare function createNodeWalletClient(account: Account, chain: Chain, rpcUrl?: string): WalletClient;
+
+declare const testnet: {
+    id: number;
+    name: string;
+    nativeCurrency: {
+        decimals: number;
+        name: string;
+        symbol: string;
+    };
+    rpcUrls: {
+        default: {
+            http: string[];
+        };
+    };
+    blockExplorers: {
+        default: {
+            name: string;
+            url: string;
+        };
+    };
+};
+declare const mainnet: {
+    id: number;
+    name: string;
+    nativeCurrency: {
+        decimals: number;
+        name: string;
+        symbol: string;
+    };
+    rpcUrls: {
+        default: {
+            http: string[];
+        };
+    };
+    blockExplorers: {
+        default: {
+            name: string;
+            url: string;
+        };
+    };
+};
+
+export { Auth, type BaseSigner, BrowserStorage, CustomSignerAdapter, DataStatus, EthersSignerAdapter, type LicenseTerms, MemoryStorage, type SignerAdapter, type SignerType, SpotifyAPI, type StorageAdapter, TwitterAPI, ViemSignerAdapter, mainnet as campMainnet, testnet as campTestnet, createLicenseTerms, createNodeWalletClient, createSignerAdapter };