TokenTable Core Package

Core utilities and functions for the TokenTable SDK.

Development

Testing

This package uses Vitest for testing.

Running Tests

# Run tests once
pnpm test:run

# Run tests in watch mode
pnpm test

# Run tests with UI
pnpm vitest --ui

Test Structure

Tests are located in src/**/__tests__/ directories following the pattern *.test.ts.

Current Test Coverage

• getOrCreateAssociatedTokenAccount - Comprehensive tests for Solana associated token account creation
  • Tests existing account retrieval
  • Tests new account creation when account doesn't exist
  • Tests error handling for invalid mint/owner
  • Tests custom parameter handling
  • Tests unexpected error propagation

Building

# Build the package
pnpm build

# Build in watch mode
pnpm build:watch

Cleaning

# Clean build artifacts
pnpm clean

Testing Philosophy

The tests use comprehensive mocking to isolate the unit under test while ensuring all code paths are covered. Key testing principles:

1. Isolation: External dependencies are mocked to focus on the function logic
2. Coverage: All branches and error conditions are tested
3. Realistic Data: Valid Solana public keys and realistic mock data are used
4. Error Handling: Both expected and unexpected errors are tested

Dependencies

This package depends on:

• @solana/web3.js - Solana blockchain interaction
• @solana/spl-token - SPL Token program utilities
• Various other blockchain and utility libraries

Dev dependencies include:

• vitest - Testing framework
• jsdom - DOM environment for tests