@claritydao/midnight-agora-sdk 0.1.0

package/test/wasm-init.test.ts

@@ -0,0 +1,132 @@
+/**
+ * Test WASM initialization timing to ensure browser compatibility
+ */
+
+import { describe, it, expect } from 'vitest';
+
+describe('WASM Initialization', () => {
+  it('should import SDK without triggering WASM load', async () => {
+    // This simulates what happens when a browser imports the SDK
+    // The import should be non-blocking and not trigger WASM initialization
+    const sdkModule = await import('../src/index');
+
+    expect(sdkModule.GovernorManager).toBeDefined();
+    expect(sdkModule.GovernorAPI).toBeDefined();
+    expect(sdkModule.initializeProviders).toBeDefined();
+    expect(sdkModule.VoteChoice).toBeDefined();
+    expect(sdkModule.ConfigPresets).toBeDefined();
+  });
+
+  it('should create GovernorManager without error (production config required)', async () => {
+    const { GovernorManager, ConfigPresets } = await import('../src/index');
+    const pino = (await import('pino')).default;
+
+    const logger = pino({ level: 'info' });
+
+    // Create valid deployment config with secure random admin key
+    const adminKey = new Uint8Array(32);
+    crypto.getRandomValues(adminKey);
+
+    const config = {
+      governor: {
+        governance: ConfigPresets.testing(),
+        executionDelay: BigInt(60),
+        gracePeriod: BigInt(300),
+        maxActiveProposals: BigInt(100),
+        proposalLifetime: BigInt(86400),
+        emergencyVetoEnabled: true,
+        emergencyVetoThreshold: BigInt(75000),
+      },
+      token: {
+        name: 'Test DAO',
+        symbol: 'TDAO',
+        decimals: BigInt(18),
+      },
+      adminKey,
+    };
+
+    // This should not throw "ocrt.maxField is not a function"
+    expect(() => {
+      const manager = new GovernorManager(config, logger);
+    }).not.toThrow();
+  });
+
+  it('should lazily load contract only when needed', async () => {
+    const { GovernorManager, ConfigPresets } = await import('../src/index');
+    const pino = (await import('pino')).default;
+
+    const logger = pino({ level: 'info' });
+
+    // Create secure random admin key
+    const adminKey = new Uint8Array(32);
+    crypto.getRandomValues(adminKey);
+
+    const config = {
+      governor: {
+        governance: ConfigPresets.testing(),
+        executionDelay: BigInt(60),
+        gracePeriod: BigInt(300),
+        maxActiveProposals: BigInt(100),
+        proposalLifetime: BigInt(86400),
+        emergencyVetoEnabled: true,
+        emergencyVetoThreshold: BigInt(75000),
+      },
+      token: {
+        name: 'Test DAO',
+        symbol: 'TDAO',
+        decimals: BigInt(18),
+      },
+      adminKey,
+    };
+
+    const manager = new GovernorManager(config, logger);
+
+    // At this point, contract should NOT be loaded yet
+    // Contract loads when resolve() is called
+    expect(manager).toBeDefined();
+  });
+
+  it('should export all production-ready types', async () => {
+    const sdkModule = await import('../src/index');
+
+    // Type exports
+    expect(sdkModule.VoteChoice).toBeDefined();
+    expect(sdkModule.ProposalStatus).toBeDefined();
+    expect(sdkModule.ConfigPresets).toBeDefined();
+
+    // Error exports
+    expect(sdkModule.GovernorSDKError).toBeDefined();
+    expect(sdkModule.WalletNotConnectedError).toBeDefined();
+    expect(sdkModule.InsufficientStakeError).toBeDefined();
+    expect(sdkModule.InvalidParameterError).toBeDefined();
+    expect(sdkModule.ContractNotFoundError).toBeDefined();
+    expect(sdkModule.ProposalNotFoundError).toBeDefined();
+    expect(sdkModule.TransactionError).toBeDefined();
+    expect(sdkModule.DeploymentError).toBeDefined();
+    expect(sdkModule.InvalidConfigurationError).toBeDefined();
+    expect(sdkModule.NetworkNotConfiguredError).toBeDefined();
+
+    // Validator exports
+    expect(sdkModule.validators).toBeDefined();
+    expect(sdkModule.validators.validateProposal).toBeDefined();
+    expect(sdkModule.validators.validateVoteChoice).toBeDefined();
+    expect(sdkModule.validators.validateDeploymentConfig).toBeDefined();
+  });
+
+  it('should not trigger WASM initialization on type-only operations', async () => {
+    const { VoteChoice, ProposalStatus, ConfigPresets } = await import('../src/index');
+
+    // These are pure type/enum operations - should not trigger WASM
+    expect(VoteChoice.For).toBe(0);
+    expect(VoteChoice.Against).toBe(1);
+    expect(VoteChoice.Abstain).toBe(2);
+
+    expect(ProposalStatus.Active).toBe(1);
+
+    const testingConfig = ConfigPresets.testing();
+    expect(testingConfig.votingPeriod).toBe(BigInt(300));
+
+    const productionConfig = ConfigPresets.production();
+    expect(productionConfig.votingPeriod).toBe(BigInt(604800));
+  });
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022", "DOM"],
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['test/**/*.test.ts'],
+  },
+});