@opendatalabs/vana-sdk 0.1.0-alpha.276ea01 → 0.1.0-alpha.2b6935d

package/dist/tests/fakes/fake-pgp-port.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fake PGP implementation for testing
+ *
+ * This provides predictable, fast PGP operations for tests
+ * without needing to mock complex OpenPGP internals.
+ */
+import type { PgpPort, PgpEncryptInput, PgpDecryptInput, PgpResult, PgpKeyPair, PgpKeyPairOptions } from "../../platform/ports/pgp-port";
+export declare class FakePgpPort implements PgpPort {
+    encrypt(input: PgpEncryptInput): Promise<PgpResult>;
+    decrypt(input: PgpDecryptInput): Promise<PgpResult>;
+    generateKeyPair(options?: PgpKeyPairOptions): Promise<PgpKeyPair>;
+}
+export declare const fakePgpPort: FakePgpPort;

package/dist/tests/grantValidation-edge-cases.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/grantValidation-unreachable-branch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/helper-methods.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/helpers/platformTestHelpers.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Shared platform testing utilities following TypeScript best practices.
+ *
+ * These utilities eliminate the need for 'as any' assertions in platform detection tests
+ * by providing type-safe mock objects and environment setup helpers.
+ *
+ * @module platformTestHelpers
+ */
+export interface NodeEnvironmentGlobals {
+    readonly process: {
+        readonly versions: {
+            readonly node: string;
+        };
+    };
+}
+export interface BrowserEnvironmentGlobals {
+    readonly window: Record<string, unknown>;
+    readonly document: Record<string, unknown>;
+}
+/**
+ * Type-safe platform environment manager for tests.
+ *
+ * This class provides methods to set up different platform environments
+ * without using 'as any' assertions, following official TypeScript best practices.
+ */
+export declare class PlatformTestHelper {
+    private readonly originalState;
+    constructor();
+    /**
+     * Configure globals for Node.js environment detection
+     *
+     * @param nodeVersion - Node.js version string to use
+     */
+    setupNodeEnvironment(nodeVersion?: string): void;
+    /**
+     * Configure globals for browser environment detection
+     */
+    setupBrowserEnvironment(): void;
+    /**
+     * Configure ambiguous environment (should default to Node)
+     */
+    setupAmbiguousEnvironment(): void;
+    /**
+     * Set up browser environment with crypto support
+     *
+     * @param cryptoOverrides - Optional crypto properties to override
+     */
+    setupBrowserWithCrypto(cryptoOverrides?: Partial<Crypto>): void;
+    /**
+     * Set up Node environment with specific process properties
+     *
+     * @param processOverrides - Optional process properties to override
+     */
+    setupNodeWithProcess(processOverrides?: Partial<typeof process>): void;
+    /**
+     * Restore original global state
+     */
+    restore(): void;
+    private captureOriginalState;
+    private restoreGlobal;
+    private clearNodeGlobals;
+    private clearBrowserGlobals;
+    private clearAllGlobals;
+}
+/**
+ * Creates a type-safe mock crypto object for testing.
+ *
+ * @param overrides - Properties to override in the base mock crypto implementation
+ * @returns A mock Crypto object with stubbed SubtleCrypto methods
+ */
+export declare function createMockCrypto(overrides?: Partial<Crypto>): Crypto;
+/**
+ * Creates a type-safe mock Node.js process object for testing.
+ *
+ * @param overrides - Properties to override in the base process mock
+ * @returns A mock process object with platform, version, and environment information
+ */
+export declare function createMockProcess(overrides?: Partial<typeof process>): typeof process;
+/**
+ * Creates a type-safe mock Window object for browser testing.
+ *
+ * @param overrides - Properties to override in the base window mock
+ * @returns A mock window object with document, location, and navigator properties
+ */
+export declare function createMockWindow(overrides?: Partial<Window>): Window & typeof globalThis;
+/**
+ * Creates a type-safe mock Document object for browser testing.
+ *
+ * @param overrides - Properties to override in the base document mock
+ * @returns A mock document object with DOM manipulation methods
+ */
+export declare function createMockDocument(overrides?: Partial<Document>): Document;
+/**
+ * Utility for creating properly typed fetch mocks
+ *
+ * @returns A Vitest mock function typed as the global fetch function
+ */
+export declare function createMockFetch(): typeof fetch;
+/**
+ * Utility for stubbing globals with proper typing using Vitest
+ */
+export declare class VitestGlobalStubber {
+    private stubs;
+    stubGlobal<T>(name: string, value: T): void;
+    restoreAllGlobals(): void;
+}

package/dist/tests/helpers/typedMocks.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Type-safe mock utilities following TypeScript best practices.
+ * These helpers eliminate the need for type assertions in tests.
+ */
+import { vi } from "vitest";
+/**
+ * Creates a typed mock function matching the signature of the provided type.
+ *
+ * @returns A vitest mock function typed to match the specified function signature
+ * @example
+ * ```typescript
+ * const fetchMock = typedFn<typeof fetch>();
+ * vi.stubGlobal('fetch', fetchMock);
+ * ```
+ */
+export declare const typedFn: <T extends (...args: unknown[]) => unknown>() => ReturnType<typeof vi.fn> & T;
+/**
+ * Creates a mock object that satisfies a specific interface.
+ *
+ * @param partial - Partial implementation to use as the mock, with only required methods
+ * @returns A mock object cast to the full interface type
+ * @example
+ * ```typescript
+ * const mockClient = createMock<WalletClient>({
+ *   getChainId: typedFn<WalletClient['getChainId']>(),
+ * });
+ * ```
+ */
+export declare function createMock<T>(partial: Partial<T>): T;
+/**
+ * Stubs a global property with type safety.
+ *
+ * @param key - The name of the global property to stub
+ * @param value - The mock value to use as the stub implementation
+ * @example
+ * ```typescript
+ * stubGlobal('fetch', typedFn<typeof fetch>());
+ * ```
+ */
+export declare function stubGlobal<K extends keyof typeof globalThis>(key: K, value: (typeof globalThis)[K]): void;
+/**
+ * Removes a global property for testing scenarios.
+ *
+ * @param key - The name of the global property to remove from globalThis
+ * @example
+ * ```typescript
+ * removeGlobal('Buffer');
+ * ```
+ */
+export declare function removeGlobal(key: keyof typeof globalThis): void;
+/**
+ * Restores a global property to its original value.
+ *
+ * @param key - The name of the global property to restore
+ * @param value - The original value to restore for the property
+ * @example
+ * ```typescript
+ * const original = globalThis.Buffer;
+ * removeGlobal('Buffer');
+ * // ... test ...
+ * restoreGlobal('Buffer', original);
+ * ```
+ */
+export declare function restoreGlobal<K extends keyof typeof globalThis>(key: K, value: (typeof globalThis)[K]): void;

package/dist/tests/index-browser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/index-node.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/mocks/platformAdapter.d.ts

@@ -0,0 +1,12 @@
+import type { VanaPlatformAdapter } from "../../platform/interface";
+/**
+ * Shared mock platform adapter for test files
+ * This provides a consistent mock implementation across all tests
+ *
+ * @returns A mock VanaPlatformAdapter instance with mocked methods
+ */
+export declare const createMockPlatformAdapter: () => VanaPlatformAdapter;
+/**
+ * Default mock platform adapter instance for convenience
+ */
+export declare const mockPlatformAdapter: VanaPlatformAdapter;

package/dist/tests/new-permissions-methods.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/no-buffer-browser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/permissions-grantee.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/permissions-revoke-relayer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/permissions-schema-validation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/permissions-server-files.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/permissions-trust-servers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/permissions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/personal.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/platform-browser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/platform-crypto-expanded.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/platform-crypto.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/platform-index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/platform-node.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/platform-shared-utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/platform-updated.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/protocol-additional-methods.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/protocol.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/read-only-mode.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/relayer-integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/relayer-unified.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/schemas.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server-handler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server-relayer-handler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/setup.d.ts

@@ -0,0 +1,7 @@
+export declare const consoleMocks: {
+    getLogCalls: () => unknown[];
+    getWarnCalls: () => unknown[];
+    getErrorCalls: () => unknown[];
+    getDebugCalls: () => unknown[];
+    getInfoCalls: () => unknown[];
+};

package/dist/tests/signatureFormatter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/trusted-server-queries.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/typedDataConverter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/types-contracts.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/types-data.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/types-external-apis.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/types-generics.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/types-permissions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/types-upload-params.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/types.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils-formatters.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils-grantFiles-edge-cases.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils-grantFiles-validation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils-grantFiles.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils-grantValidation-consolidated.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils-grants.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils-ipfs-additional.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils-ipfs.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Test suite for IPFS utilities
+ */
+export {};

package/dist/tests/utils-schemaValidation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/vana.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/wallet-crypto-compatibility.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/blockchain.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var blockchain_exports = {};
+module.exports = __toCommonJS(blockchain_exports);
+//# sourceMappingURL=blockchain.cjs.map

package/dist/types/blockchain.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/blockchain.ts"],"sourcesContent":["/**\n * Core blockchain types for the Vana SDK\n */\n\nimport type { Hash, Address } from \"viem\";\n\n/**\n * Represents a transaction that has been submitted to the blockchain\n * This is what contract calls return before confirmation\n */\nexport interface TransactionRequest {\n  /** Transaction hash */\n  hash: Hash;\n  /** Account that initiated the transaction */\n  from: Address;\n  /** Contract that was called */\n  contractName: string;\n  /** Function that was called */\n  functionName: string;\n  /** Function arguments (for debugging/logging) */\n  args?: readonly unknown[];\n}\n\n/**\n * Options for waiting for transaction confirmation\n */\nexport interface TransactionWaitOptions {\n  /** Number of confirmations to wait for (default: 1) */\n  confirmations?: number;\n  /** Timeout in milliseconds (default: 30000) */\n  timeout?: number;\n  /** Polling interval in milliseconds (default: 4000) */\n  pollingInterval?: number;\n}\n\n/**\n * Base result for all confirmed transactions\n */\nexport interface TransactionResult {\n  /** Transaction hash */\n  transactionHash: Hash;\n  /** Block number where transaction was included */\n  blockNumber: bigint;\n  /** Gas used by the transaction */\n  gasUsed: bigint;\n  /** Account that initiated the transaction */\n  from: Address;\n  /** Contract that was called */\n  contractName: string;\n  /** Function that was called */\n  functionName: string;\n}\n\n/**\n * Event arguments are dynamically typed based on the contract mappings.\n * The parseTransaction function will:\n * 1. Return expectedEvents with typed args for mapped functions\n * 2. Return allEvents with all parsed events from the transaction\n *\n * This approach avoids the need for specific result interfaces per event type,\n * letting the mapping file drive the types instead.\n */\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/blockchain.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Core blockchain types for the Vana SDK
+ */
+import type { Hash, Address } from "viem";
+/**
+ * Represents a transaction that has been submitted to the blockchain
+ * This is what contract calls return before confirmation
+ */
+export interface TransactionRequest {
+    /** Transaction hash */
+    hash: Hash;
+    /** Account that initiated the transaction */
+    from: Address;
+    /** Contract that was called */
+    contractName: string;
+    /** Function that was called */
+    functionName: string;
+    /** Function arguments (for debugging/logging) */
+    args?: readonly unknown[];
+}
+/**
+ * Options for waiting for transaction confirmation
+ */
+export interface TransactionWaitOptions {
+    /** Number of confirmations to wait for (default: 1) */
+    confirmations?: number;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Polling interval in milliseconds (default: 4000) */
+    pollingInterval?: number;
+}
+/**
+ * Base result for all confirmed transactions
+ */
+export interface TransactionResult {
+    /** Transaction hash */
+    transactionHash: Hash;
+    /** Block number where transaction was included */
+    blockNumber: bigint;
+    /** Gas used by the transaction */
+    gasUsed: bigint;
+    /** Account that initiated the transaction */
+    from: Address;
+    /** Contract that was called */
+    contractName: string;
+    /** Function that was called */
+    functionName: string;
+}
+/**
+ * Event arguments are dynamically typed based on the contract mappings.
+ * The parseTransaction function will:
+ * 1. Return expectedEvents with typed args for mapped functions
+ * 2. Return allEvents with all parsed events from the transaction
+ *
+ * This approach avoids the need for specific result interfaces per event type,
+ * letting the mapping file drive the types instead.
+ */

package/dist/types/blockchain.js

@@ -0,0 +1 @@
+//# sourceMappingURL=blockchain.js.map

package/dist/types/blockchain.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/chains-additional.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/chains.d.ts

@@ -1,19 +1,18 @@
-import { Chain } from 'viem';
-
+import type { Chain } from "viem";
 /**
  * Supported Vana chain IDs
  */
-type VanaChainId = 14800 | 1480;
+export type VanaChainId = 14800 | 1480;
 /**
  * Supported Vana chains
  */
-type VanaChain = Chain & {
+export type VanaChain = Chain & {
     id: VanaChainId;
 };
 /**
  * Chain configuration mapping
  */
-type ChainConfig = {
+export type ChainConfig = {
     [K in VanaChainId]: VanaChain;
 };
 /**
@@ -22,13 +21,11 @@ type ChainConfig = {
  * @param chainId - The chain ID to validate
  * @returns True if the chain ID is a supported Vana chain ID
  */
-declare function isVanaChainId(chainId: number): chainId is VanaChainId;
+export declare function isVanaChainId(chainId: number): chainId is VanaChainId;
 /**
  * Type guard to check if a chain is a Vana chain
  *
  * @param chain - The chain object to validate
  * @returns True if the chain is a supported Vana chain
  */
-declare function isVanaChain(chain: Chain): chain is VanaChain;
-
-export { type ChainConfig, type VanaChain, type VanaChainId, isVanaChain, isVanaChainId };
+export declare function isVanaChain(chain: Chain): chain is VanaChain;

package/dist/types/config.cjs

@@ -19,13 +19,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var config_exports = {};
 __export(config_exports, {
   hasStorageConfig: () => hasStorageConfig,
+  isAddressOnlyConfig: () => isAddressOnlyConfig,
   isChainConfig: () => isChainConfig,
+  isReadOnlyConfig: () => isReadOnlyConfig,
   isWalletConfig: () => isWalletConfig
 });
 module.exports = __toCommonJS(config_exports);
 function isWalletConfig(config) {
   return "walletClient" in config;
 }
+function isReadOnlyConfig(config) {
+  return "publicClient" in config && "address" in config && !("walletClient" in config);
+}
+function isAddressOnlyConfig(config) {
+  return "address" in config && !("publicClient" in config) && !("walletClient" in config) && !("chainId" in config);
+}
 function isChainConfig(config) {
   return "chainId" in config && !("walletClient" in config);
 }
@@ -35,7 +43,9 @@ function hasStorageConfig(config) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   hasStorageConfig,
+  isAddressOnlyConfig,
   isChainConfig,
+  isReadOnlyConfig,
   isWalletConfig
 });
 //# sourceMappingURL=config.cjs.map