@partylayer/conformance-runner 0.2.8 → 0.2.10

package/dist/tests.js

@@ -1,233 +0,0 @@
-/**
- * Adapter Conformance Tests
- *
- * Standard contract tests that all adapters must pass.
- */
-import { CapabilityNotSupportedError, } from '@partylayer/core';
-/**
- * Create mock adapter context
- */
-export function createMockContext() {
-    return {
-        appName: 'Conformance Test',
-        origin: 'https://test.example.com',
-        network: 'devnet',
-        logger: {
-            debug: () => { },
-            info: () => { },
-            warn: () => { },
-            error: () => { },
-        },
-        telemetry: undefined,
-        registry: {
-            getWallet: async () => ({}),
-        },
-        crypto: {
-            encrypt: async (data) => data,
-            decrypt: async (data) => data,
-            generateKey: async () => 'test-key',
-        },
-        storage: {
-            get: async () => null,
-            set: async () => { },
-            remove: async () => { },
-            clear: async () => { },
-        },
-        timeout: async (ms) => {
-            await new Promise((resolve) => setTimeout(resolve, ms));
-            throw new Error('Timeout');
-        },
-    };
-}
-/**
- * Run conformance tests
- */
-export async function runConformanceTests(adapter, context) {
-    const results = [];
-    // Test 1: Adapter has required properties
-    results.push({
-        name: 'Adapter has walletId',
-        passed: typeof adapter.walletId === 'string' && adapter.walletId.length > 0,
-        details: { walletId: adapter.walletId },
-    });
-    results.push({
-        name: 'Adapter has name',
-        passed: typeof adapter.name === 'string' && adapter.name.length > 0,
-        details: { name: adapter.name },
-    });
-    // Test 2: getCapabilities returns valid array
-    let capabilities;
-    try {
-        capabilities = adapter.getCapabilities();
-        results.push({
-            name: 'getCapabilities returns array',
-            passed: Array.isArray(capabilities),
-            details: { capabilities },
-        });
-        // Check for required capabilities
-        const hasConnect = capabilities.includes('connect');
-        results.push({
-            name: 'Capabilities include "connect"',
-            passed: hasConnect,
-            details: { capabilities },
-        });
-    }
-    catch (err) {
-        results.push({
-            name: 'getCapabilities throws error',
-            passed: false,
-            error: err instanceof Error ? err.message : String(err),
-        });
-        return results; // Can't continue without capabilities
-    }
-    // Test 3: detectInstalled returns valid result
-    try {
-        const detect = await adapter.detectInstalled();
-        results.push({
-            name: 'detectInstalled returns valid result',
-            passed: typeof detect === 'object' &&
-                typeof detect.installed === 'boolean' &&
-                (detect.installed || typeof detect.reason === 'string'),
-            details: { detect },
-        });
-    }
-    catch (err) {
-        results.push({
-            name: 'detectInstalled throws error',
-            passed: false,
-            error: err instanceof Error ? err.message : String(err),
-        });
-    }
-    // Test 4: If detectInstalled returns false, connect should throw WalletNotInstalledError
-    // (This test requires mocking detectInstalled - skip for now or use mock adapter)
-    // Test 5: Capability checks
-    if (capabilities.includes('signMessage')) {
-        if (typeof adapter.signMessage !== 'function') {
-            results.push({
-                name: 'signMessage capability declared but method missing',
-                passed: false,
-                error: 'signMessage capability declared but method not implemented',
-            });
-        }
-    }
-    else {
-        // If signMessage not in capabilities, calling it should throw CapabilityNotSupportedError
-        if (typeof adapter.signMessage === 'function') {
-            try {
-                await adapter.signMessage(context, {}, { message: 'test' });
-                results.push({
-                    name: 'signMessage throws CapabilityNotSupportedError when not supported',
-                    passed: false,
-                    error: 'signMessage did not throw error',
-                });
-            }
-            catch (err) {
-                const passed = err instanceof CapabilityNotSupportedError;
-                results.push({
-                    name: 'signMessage throws CapabilityNotSupportedError when not supported',
-                    passed,
-                    error: passed ? undefined : err instanceof Error ? err.message : String(err),
-                });
-            }
-        }
-    }
-    // Similar tests for signTransaction and submitTransaction
-    if (capabilities.includes('signTransaction')) {
-        if (typeof adapter.signTransaction !== 'function') {
-            results.push({
-                name: 'signTransaction capability declared but method missing',
-                passed: false,
-                error: 'signTransaction capability declared but method not implemented',
-            });
-        }
-    }
-    if (capabilities.includes('submitTransaction')) {
-        if (typeof adapter.submitTransaction !== 'function') {
-            results.push({
-                name: 'submitTransaction capability declared but method missing',
-                passed: false,
-                error: 'submitTransaction capability declared but method not implemented',
-            });
-        }
-    }
-    // Test 5b: restore capability <-> method symmetry.
-    //
-    // We had a real bug where 3 of 5 adapters implemented restore() but did
-    // not declare the 'restore' capability in getCapabilities(). The SDK
-    // checks method presence at runtime so session persistence still worked,
-    // but `wallet.capabilities.includes('restore')` returned false, which
-    // misleads docs consumers and anyone programmatically inspecting caps.
-    //
-    // Enforce both directions:
-    //   - declared-but-missing: capability listed, no method → broken promise
-    //   - implemented-but-undeclared: method exists, capability missing →
-    //     silent drift that hides a feature from consumers
-    {
-        const hasRestoreMethod = typeof adapter.restore === 'function';
-        const declaresRestore = capabilities.includes('restore');
-        if (declaresRestore && !hasRestoreMethod) {
-            results.push({
-                name: 'restore capability declared but method missing',
-                passed: false,
-                error: `${adapter.name}: declares 'restore' capability but does not implement restore()`,
-            });
-        }
-        else if (hasRestoreMethod && !declaresRestore) {
-            results.push({
-                name: 'restore method implemented but capability not declared',
-                passed: false,
-                error: `${adapter.name}: implements restore() but getCapabilities() does not include 'restore'. ` +
-                    `Add 'restore' to the returned array so consumers can discover the feature.`,
-            });
-        }
-        else {
-            results.push({
-                name: 'restore capability / method symmetry',
-                passed: true,
-                details: { hasRestoreMethod, declaresRestore },
-            });
-        }
-    }
-    // Test 6: Error mapping
-    // Verify adapter uses mapUnknownErrorToPartyLayerError
-    // (This is a code inspection test - hard to test at runtime)
-    return results;
-}
-/**
- * Network-truthfulness contract.
- *
- * An adapter's `connect()` MUST surface the wallet's EFFECTIVE network in
- * `session.network` (so the SDK can detect a wallet/dApp network mismatch) —
- * not merely echo the requested `context.network`.
- *
- * Drive it with a context whose `.network` differs from the network the wallet
- * actually reports (`walletReportedNetwork`); a compliant adapter returns
- * `session.network === walletReportedNetwork`. An adapter that echoes
- * `context.network` fails the contract.
- *
- * Adapters that genuinely cannot read the wallet's network must NOT claim to
- * (leave `session.network = context.network`) and must be recorded as
- * "network-reported: no" in the support matrix — they are out of scope for this
- * contract rather than silently passing it.
- */
-export async function checkNetworkTruthfulness(adapter, context, walletReportedNetwork) {
-    const name = 'connect() session.network is the wallet effective network';
-    try {
-        const result = await adapter.connect(context);
-        const got = result.session.network;
-        const passed = got === walletReportedNetwork;
-        return {
-            name,
-            passed,
-            error: passed
-                ? undefined
-                : `expected session.network='${walletReportedNetwork}' (wallet-reported), got '${String(got)}'` +
-                    (got === context.network ? ' — merely echoed context.network' : ''),
-            details: { expected: walletReportedNetwork, got, ctxNetwork: context.network },
-        };
-    }
-    catch (err) {
-        return { name, passed: false, error: err instanceof Error ? err.message : String(err) };
-    }
-}
-//# sourceMappingURL=tests.js.map

package/dist/tests.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tests.js","sourceRoot":"","sources":["../src/tests.ts"],"names":[],"mappings":"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"}

package/src/cip0103-tests.ts

@@ -1,340 +0,0 @@
-/**
- * CIP-0103 Conformance Test Suite
- *
- * Validates that a Provider implementation conforms to CIP-0103:
- * - Interface shape (request, on, emit, removeListener)
- * - All 10 mandatory methods are handled
- * - Event subscription returns Provider for chaining
- * - Error responses use ProviderRpcError with numeric codes
- *
- * This suite can be run against:
- * - PartyLayerProvider (native path)
- * - createProviderBridge() (bridge path)
- * - Any third-party CIP-0103 Provider
- */
-
-import type { CIP0103Provider } from '@partylayer/core';
-import { CIP0103_MANDATORY_METHODS, CIP0103_EVENTS } from '@partylayer/core';
-
-// ─── Types ──────────────────────────────────────────────────────────────────
-
-export interface CIP0103TestResult {
-  name: string;
-  category: 'interface' | 'method' | 'event' | 'error' | 'lifecycle';
-  passed: boolean;
-  error?: string;
-  details?: Record<string, unknown>;
-}
-
-export interface CIP0103ConformanceReport {
-  total: number;
-  passed: number;
-  failed: number;
-  results: CIP0103TestResult[];
-}
-
-// ─── Runner ─────────────────────────────────────────────────────────────────
-
-export async function runCIP0103ConformanceTests(
-  provider: CIP0103Provider,
-): Promise<CIP0103ConformanceReport> {
-  const results: CIP0103TestResult[] = [];
-
-  // ── Interface shape tests ─────────────────────────────────────────────
-
-  results.push({
-    name: 'Provider has request() method',
-    category: 'interface',
-    passed: typeof provider.request === 'function',
-  });
-
-  results.push({
-    name: 'Provider has on() method',
-    category: 'interface',
-    passed: typeof provider.on === 'function',
-  });
-
-  results.push({
-    name: 'Provider has emit() method',
-    category: 'interface',
-    passed: typeof provider.emit === 'function',
-  });
-
-  results.push({
-    name: 'Provider has removeListener() method',
-    category: 'interface',
-    passed: typeof provider.removeListener === 'function',
-  });
-
-  // ── Method presence tests ─────────────────────────────────────────────
-
-  for (const method of CIP0103_MANDATORY_METHODS) {
-    try {
-      await provider.request({ method, params: {} });
-      results.push({
-        name: `Method "${method}" is handled`,
-        category: 'method',
-        passed: true,
-      });
-    } catch (err: unknown) {
-      // A valid ProviderRpcError means the method IS handled
-      // (it just may not be authorized / connected yet)
-      const isValidError = isNumericCodeError(err);
-      results.push({
-        name: `Method "${method}" is handled`,
-        category: 'method',
-        passed: isValidError,
-        error: isValidError
-          ? undefined
-          : `Expected ProviderRpcError with numeric code, got: ${String(err)}`,
-        details: isValidError
-          ? { code: (err as { code: number }).code }
-          : undefined,
-      });
-    }
-  }
-
-  // ── Event chaining tests ──────────────────────────────────────────────
-
-  const noopHandler = () => {};
-
-  const onResult = provider.on('statusChanged', noopHandler);
-  results.push({
-    name: 'on() returns Provider for chaining',
-    category: 'event',
-    passed: onResult === provider,
-    error:
-      onResult === provider
-        ? undefined
-        : 'on() did not return the Provider instance',
-  });
-
-  const removeResult = provider.removeListener('statusChanged', noopHandler);
-  results.push({
-    name: 'removeListener() returns Provider for chaining',
-    category: 'event',
-    passed: removeResult === provider,
-    error:
-      removeResult === provider
-        ? undefined
-        : 'removeListener() did not return the Provider instance',
-  });
-
-  // ── Error code validation ─────────────────────────────────────────────
-
-  try {
-    await provider.request({ method: '__cip0103_conformance_nonexistent__' });
-    results.push({
-      name: 'Unsupported method returns ProviderRpcError',
-      category: 'error',
-      passed: false,
-      error: 'Expected error for unsupported method, got success',
-    });
-  } catch (err: unknown) {
-    const hasNumericCode = isNumericCodeError(err);
-    results.push({
-      name: 'Unsupported method returns error with numeric code',
-      category: 'error',
-      passed: hasNumericCode,
-      error: hasNumericCode
-        ? undefined
-        : `Expected numeric code, got: ${String(err)}`,
-      details: hasNumericCode
-        ? { code: (err as { code: number }).code }
-        : undefined,
-    });
-
-    if (hasNumericCode) {
-      const code = (err as { code: number }).code;
-      // Should be 4200 (UNSUPPORTED_METHOD) or -32601 (METHOD_NOT_FOUND)
-      const isCorrectCode = code === 4200 || code === -32601;
-      results.push({
-        name: 'Unsupported method uses code 4200 or -32601',
-        category: 'error',
-        passed: isCorrectCode,
-        error: isCorrectCode
-          ? undefined
-          : `Expected code 4200 or -32601, got ${code}`,
-        details: { code },
-      });
-    }
-  }
-
-  // ── emit() returns boolean ────────────────────────────────────────────
-
-  const emitResult = provider.emit('__cip0103_conformance_test__');
-  results.push({
-    name: 'emit() returns boolean',
-    category: 'interface',
-    passed: typeof emitResult === 'boolean',
-    error:
-      typeof emitResult === 'boolean'
-        ? undefined
-        : `emit() returned ${typeof emitResult}`,
-  });
-
-  // ── Transaction lifecycle tests ─────────────────────────────────────
-
-  {
-    const txEvents: unknown[] = [];
-    const txHandler = (...args: unknown[]) => txEvents.push(...args);
-    provider.on(CIP0103_EVENTS.TX_CHANGED, txHandler);
-
-    try {
-      await provider.request({
-        method: 'prepareExecute',
-        params: { tx: { _conformance: true } },
-      });
-
-      // Check that 'pending' was emitted
-      results.push({
-        name: 'prepareExecute emits txChanged with "pending"',
-        category: 'lifecycle',
-        passed: txEvents.some(
-          (e) => typeof e === 'object' && e !== null && (e as Record<string, unknown>).status === 'pending',
-        ),
-        error: txEvents.length === 0 ? 'No txChanged events emitted' : undefined,
-      });
-
-      // Check that 'signed' was emitted
-      const signedEvent = txEvents.find(
-        (e) => typeof e === 'object' && e !== null && (e as Record<string, unknown>).status === 'signed',
-      ) as Record<string, unknown> | undefined;
-      results.push({
-        name: 'prepareExecute emits txChanged with "signed"',
-        category: 'lifecycle',
-        passed: !!signedEvent,
-      });
-
-      // Validate 'signed' payload shape
-      if (signedEvent) {
-        const payload = signedEvent.payload as Record<string, unknown> | undefined;
-        results.push({
-          name: 'signed event has payload.signature (string)',
-          category: 'lifecycle',
-          passed: typeof payload?.signature === 'string',
-        });
-        results.push({
-          name: 'signed event has payload.signedBy (string)',
-          category: 'lifecycle',
-          passed: typeof payload?.signedBy === 'string',
-        });
-        results.push({
-          name: 'signed event has payload.party (string)',
-          category: 'lifecycle',
-          passed: typeof payload?.party === 'string',
-        });
-      }
-
-      // Check that a terminal state was reached
-      const hasTerminal = txEvents.some(
-        (e) =>
-          typeof e === 'object' &&
-          e !== null &&
-          ((e as Record<string, unknown>).status === 'executed' ||
-            (e as Record<string, unknown>).status === 'failed'),
-      );
-      results.push({
-        name: 'prepareExecute reaches terminal tx state (executed or failed)',
-        category: 'lifecycle',
-        passed: hasTerminal,
-      });
-
-      // Validate 'executed' payload shape
-      const executedEvent = txEvents.find(
-        (e) => typeof e === 'object' && e !== null && (e as Record<string, unknown>).status === 'executed',
-      ) as Record<string, unknown> | undefined;
-      if (executedEvent) {
-        const payload = executedEvent.payload as Record<string, unknown> | undefined;
-        results.push({
-          name: 'executed event has payload.updateId (string)',
-          category: 'lifecycle',
-          passed: typeof payload?.updateId === 'string',
-        });
-        results.push({
-          name: 'executed event has payload.completionOffset (number)',
-          category: 'lifecycle',
-          passed: typeof payload?.completionOffset === 'number',
-        });
-      }
-    } catch {
-      // prepareExecute may throw — still check if events were emitted
-      results.push({
-        name: 'prepareExecute emits txChanged events (despite error)',
-        category: 'lifecycle',
-        passed: txEvents.length > 0,
-        error: txEvents.length === 0 ? 'No txChanged events emitted before error' : undefined,
-      });
-    } finally {
-      provider.removeListener(CIP0103_EVENTS.TX_CHANGED, txHandler);
-    }
-  }
-
-  // ── ledgerApi handling test ────────────────────────────────────────
-
-  try {
-    await provider.request({
-      method: 'ledgerApi',
-      params: { requestMethod: 'GET', resource: '/v1/state/acs' },
-    });
-    results.push({
-      name: 'ledgerApi returns result (supported)',
-      category: 'method',
-      passed: true,
-    });
-  } catch (err: unknown) {
-    // ProviderRpcError with numeric code = method is recognized
-    const isHandled = isNumericCodeError(err);
-    results.push({
-      name: 'ledgerApi is handled (returns result or ProviderRpcError)',
-      category: 'method',
-      passed: isHandled,
-      error: isHandled ? undefined : `Unexpected error type: ${String(err)}`,
-    });
-  }
-
-  // ── Summary ───────────────────────────────────────────────────────────
-
-  const passed = results.filter((r) => r.passed).length;
-  return {
-    total: results.length,
-    passed,
-    failed: results.length - passed,
-    results,
-  };
-}
-
-// ─── Helpers ────────────────────────────────────────────────────────────────
-
-function isNumericCodeError(err: unknown): boolean {
-  if (typeof err !== 'object' || err === null) return false;
-  return typeof (err as Record<string, unknown>).code === 'number';
-}
-
-// ─── Formatting ─────────────────────────────────────────────────────────────
-
-export function formatCIP0103Report(report: CIP0103ConformanceReport): string {
-  const lines: string[] = [
-    '═══ CIP-0103 Conformance Report ═══',
-    '',
-    `Total: ${report.total}  Passed: ${report.passed}  Failed: ${report.failed}`,
-    '',
-  ];
-
-  const categories = ['interface', 'method', 'event', 'error', 'lifecycle'] as const;
-  for (const cat of categories) {
-    const catResults = report.results.filter((r) => r.category === cat);
-    if (catResults.length === 0) continue;
-    lines.push(`── ${cat.toUpperCase()} ──`);
-    for (const r of catResults) {
-      const icon = r.passed ? '✓' : '✗';
-      lines.push(`  ${icon} ${r.name}`);
-      if (r.error) {
-        lines.push(`    → ${r.error}`);
-      }
-    }
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}