@partylayer/conformance-runner 0.1.3

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# @cantonconnect/conformance-runner
+
+## 0.1.3
+
+### Patch Changes
+
+- Updated dependencies
+  - @cantonconnect/core@0.2.2
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @cantonconnect/core@0.2.1
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @cantonconnect/core@0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 CantonConnect
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * CantonConnect Conformance Runner CLI
+ *
+ * Runs adapter conformance tests and generates reports.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/index.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * CantonConnect Conformance Runner CLI
+ *
+ * Runs adapter conformance tests and generates reports.
+ */
+import { program } from 'commander';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { loadAdapter } from './loader';
+import { runConformanceTests, createMockContext } from './tests';
+import { generateReport, formatReportText } from './report';
+program
+    .name('cantonconnect-conformance')
+    .description('Run conformance tests for CantonConnect wallet adapters')
+    .version('0.1.0');
+program
+    .command('run')
+    .description('Run conformance tests for an adapter')
+    .requiredOption('--adapter <packageOrPath>', 'Adapter package name or path')
+    .option('--network <network>', 'Network to use', 'devnet')
+    .option('--registryUrl <url>', 'Registry URL (optional)')
+    .option('--output <path>', 'Output JSON report path', 'conformance-report.json')
+    .action(async (options) => {
+    try {
+        console.log(`Loading adapter: ${options.adapter}`);
+        const adapter = await loadAdapter(options.adapter);
+        console.log(`Running conformance tests for: ${adapter.name} (${adapter.walletId})`);
+        const context = createMockContext();
+        context.network = options.network;
+        const startTime = Date.now();
+        const testResults = await runConformanceTests(adapter, context);
+        const report = generateReport({
+            walletId: adapter.walletId,
+            name: adapter.name,
+        }, testResults, startTime);
+        // Write JSON report
+        writeFileSync(options.output, JSON.stringify(report, null, 2));
+        console.log(`\nReport written to: ${options.output}`);
+        // Print human-readable summary
+        console.log('\n' + formatReportText(report));
+        // Exit with error code if tests failed
+        if (report.results.failed > 0) {
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error('Error running conformance tests:', err);
+        process.exit(1);
+    }
+});
+program
+    .command('report')
+    .description('Format and display a conformance report')
+    .requiredOption('--input <path>', 'Input JSON report path')
+    .action((options) => {
+    try {
+        if (!existsSync(options.input)) {
+            console.error(`Report file not found: ${options.input}`);
+            process.exit(1);
+        }
+        const reportJson = readFileSync(options.input, 'utf-8');
+        const report = JSON.parse(reportJson);
+        console.log(formatReportText(report));
+        if (report.results.failed > 0) {
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error('Error reading report:', err);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Adapter Module Loader
+ *
+ * Dynamically loads adapter modules (ESM/CJS safe)
+ */
+import type { WalletAdapter } from '@partylayer/core';
+/**
+ * Load adapter from package or path
+ */
+export declare function loadAdapter(packageNameOrPath: string): Promise<WalletAdapter>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,CAAC,CAuDxB"}

package/dist/loader.js

@@ -0,0 +1,60 @@
+/**
+ * Adapter Module Loader
+ *
+ * Dynamically loads adapter modules (ESM/CJS safe)
+ */
+import { resolve } from 'path';
+import { pathToFileURL } from 'url';
+/**
+ * Load adapter from package or path
+ */
+export async function loadAdapter(packageNameOrPath) {
+    let adapterPath;
+    // Check if it's a path
+    if (packageNameOrPath.startsWith('.') || packageNameOrPath.startsWith('/')) {
+        adapterPath = resolve(packageNameOrPath);
+    }
+    else {
+        // Try to resolve as package
+        try {
+            adapterPath = require.resolve(packageNameOrPath);
+        }
+        catch {
+            throw new Error(`Cannot resolve adapter: ${packageNameOrPath}`);
+        }
+    }
+    // Try to load as ESM first
+    try {
+        const moduleUrl = pathToFileURL(adapterPath).href;
+        const module = await import(moduleUrl);
+        // Look for default export or named export
+        const adapter = module.default || module[Object.keys(module)[0]];
+        if (!adapter) {
+            throw new Error('No adapter export found');
+        }
+        // If it's a class, instantiate it
+        if (typeof adapter === 'function') {
+            return new adapter();
+        }
+        return adapter;
+    }
+    catch (err) {
+        // Fallback to CJS
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const module = require(adapterPath);
+            const adapter = module.default || module[Object.keys(module)[0]];
+            if (!adapter) {
+                throw new Error('No adapter export found');
+            }
+            if (typeof adapter === 'function') {
+                return new adapter();
+            }
+            return adapter;
+        }
+        catch (cjsErr) {
+            throw new Error(`Failed to load adapter: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,iBAAyB;IAEzB,IAAI,WAAmB,CAAC;IAExB,uBAAuB;IACvB,IAAI,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3E,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,4BAA4B;QAC5B,IAAI,CAAC;YACH,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,2BAA2B,iBAAiB,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAEvC,0CAA0C;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,kCAAkC;QAClC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,OAAO,IAAI,OAAO,EAAE,CAAC;QACvB,CAAC;QAED,OAAO,OAAwB,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,kBAAkB;QAClB,IAAI,CAAC;YACH,8DAA8D;YAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAEjE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YAED,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,OAAO,IAAI,OAAO,EAAE,CAAC;YACvB,CAAC;YAED,OAAO,OAAwB,CAAC;QAClC,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/report.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Conformance Report Generation
+ */
+import type { TestResult } from './tests';
+/**
+ * Conformance report
+ */
+export interface ConformanceReport {
+    adapter: {
+        walletId: string;
+        name: string;
+        version?: string;
+    };
+    environment: {
+        nodeVersion: string;
+        platform: string;
+        timestamp: string;
+    };
+    results: {
+        total: number;
+        passed: number;
+        failed: number;
+        duration: number;
+    };
+    tests: TestResult[];
+}
+/**
+ * Generate conformance report
+ */
+export declare function generateReport(adapter: {
+    walletId: string;
+    name: string;
+    version?: string;
+}, tests: TestResult[], startTime: number): ConformanceReport;
+/**
+ * Format report as human-readable text
+ */
+export declare function formatReportText(report: ConformanceReport): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,WAAW,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7D,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAmBnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA8ClE"}

package/dist/report.js

@@ -0,0 +1,72 @@
+/**
+ * Conformance Report Generation
+ */
+/**
+ * Generate conformance report
+ */
+export function generateReport(adapter, tests, startTime) {
+    const passed = tests.filter((t) => t.passed).length;
+    const failed = tests.filter((t) => !t.passed).length;
+    return {
+        adapter,
+        environment: {
+            nodeVersion: process.version,
+            platform: process.platform,
+            timestamp: new Date().toISOString(),
+        },
+        results: {
+            total: tests.length,
+            passed,
+            failed,
+            duration: Date.now() - startTime,
+        },
+        tests,
+    };
+}
+/**
+ * Format report as human-readable text
+ */
+export function formatReportText(report) {
+    const lines = [];
+    lines.push('='.repeat(60));
+    lines.push('CantonConnect Adapter Conformance Report');
+    lines.push('='.repeat(60));
+    lines.push('');
+    lines.push(`Adapter: ${report.adapter.name} (${report.adapter.walletId})`);
+    if (report.adapter.version) {
+        lines.push(`Version: ${report.adapter.version}`);
+    }
+    lines.push(`Environment: Node ${report.environment.nodeVersion} on ${report.environment.platform}`);
+    lines.push(`Timestamp: ${report.environment.timestamp}`);
+    lines.push('');
+    lines.push('Summary:');
+    lines.push(`  Total Tests: ${report.results.total}`);
+    lines.push(`  Passed: ${report.results.passed}`);
+    lines.push(`  Failed: ${report.results.failed}`);
+    lines.push(`  Duration: ${report.results.duration}ms`);
+    lines.push('');
+    lines.push('Test Results:');
+    lines.push('-'.repeat(60));
+    report.tests.forEach((test, index) => {
+        const status = test.passed ? '✓' : '✗';
+        lines.push(`${index + 1}. ${status} ${test.name}`);
+        if (test.details) {
+            Object.entries(test.details).forEach(([key, value]) => {
+                lines.push(`   ${key}: ${JSON.stringify(value)}`);
+            });
+        }
+        if (test.error) {
+            lines.push(`   Error: ${test.error}`);
+        }
+    });
+    lines.push('-'.repeat(60));
+    lines.push('');
+    if (report.results.failed === 0) {
+        lines.push('✓ All tests passed!');
+    }
+    else {
+        lines.push(`✗ ${report.results.failed} test(s) failed`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/tests.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Adapter Conformance Tests
+ *
+ * Standard contract tests that all adapters must pass.
+ */
+import type { WalletAdapter, AdapterContext } from '@partylayer/core';
+/**
+ * Test result
+ */
+export interface TestResult {
+    name: string;
+    passed: boolean;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Conformance test suite
+ */
+export interface ConformanceSuite {
+    adapter: WalletAdapter;
+    context: AdapterContext;
+    results: TestResult[];
+}
+/**
+ * Create mock adapter context
+ */
+export declare function createMockContext(): AdapterContext;
+/**
+ * Run conformance tests
+ */
+export declare function runConformanceTests(adapter: WalletAdapter, context: AdapterContext): Promise<TestResult[]>;
+//# sourceMappingURL=tests.d.ts.map

package/dist/tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests.d.ts","sourceRoot":"","sources":["../src/tests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAEf,MAAM,kBAAkB,CAAC;AAK1B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CA+BlD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,EAAE,CAAC,CAwHvB"}

package/dist/tests.js

@@ -0,0 +1,158 @@
+/**
+ * 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 6: Error mapping
+    // Verify adapter uses mapUnknownErrorToCantonConnectError
+    // (This is a code inspection test - hard to test at runtime)
+    return results;
+}
+//# sourceMappingURL=tests.js.map

package/dist/tests.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@partylayer/conformance-runner",
+  "version": "0.1.3",
+  "description": "CLI tool for running adapter conformance tests",
+  "type": "module",
+  "bin": {
+    "partylayer-conformance": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "keywords": [
+    "canton",
+    "wallet",
+    "adapter",
+    "conformance",
+    "testing"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^14.0.2",
+    "@partylayer/core": "0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "scripts": {
+    "build": "tsc && tsc --project tsconfig.esm.json",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit"
+  }
+}