@framers/agentos-ext-wallet 0.2.0 → 0.2.1

package/test/MccCategoryMap.spec.ts

@@ -1,153 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Unit tests for MccCategoryMap.
- *
- * Tests cover: category resolution for all known ranges, boundary values,
- * unknown MCCs, reverse lookup (category → ranges/codes), and mapped categories.
- */
-
-import { describe, it, expect } from 'vitest';
-import { MccCategoryMap } from '../src/cards/MccCategoryMap.js';
-
-describe('MccCategoryMap', () => {
-  const map = new MccCategoryMap();
-
-  /* ── mccToCategory ────────────────────────────────────────────────── */
-
-  describe('mccToCategory', () => {
-    it('should resolve dining MCCs (5812-5814)', () => {
-      expect(map.mccToCategory('5812')).toBe('dining');
-      expect(map.mccToCategory('5813')).toBe('dining');
-      expect(map.mccToCategory('5814')).toBe('dining');
-    });
-
-    it('should resolve travel MCCs (airlines, hotels)', () => {
-      expect(map.mccToCategory('3000')).toBe('travel');
-      expect(map.mccToCategory('3500')).toBe('travel');
-      expect(map.mccToCategory('3999')).toBe('travel');
-      expect(map.mccToCategory('4511')).toBe('travel');
-      expect(map.mccToCategory('7011')).toBe('travel');
-      expect(map.mccToCategory('7012')).toBe('travel');
-    });
-
-    it('should resolve shopping MCCs (retail)', () => {
-      expect(map.mccToCategory('5200')).toBe('shopping');
-      expect(map.mccToCategory('5411')).toBe('shopping');
-      expect(map.mccToCategory('5699')).toBe('shopping');
-      expect(map.mccToCategory('5999')).toBe('shopping');
-    });
-
-    it('should resolve entertainment MCCs', () => {
-      expect(map.mccToCategory('7832')).toBe('entertainment');
-      expect(map.mccToCategory('7841')).toBe('entertainment');
-      expect(map.mccToCategory('7941')).toBe('entertainment');
-    });
-
-    it('should resolve utilities MCCs (telecom, electric)', () => {
-      expect(map.mccToCategory('4812')).toBe('utilities');
-      expect(map.mccToCategory('4900')).toBe('utilities');
-    });
-
-    it('should resolve subscriptions MCCs (digital goods)', () => {
-      expect(map.mccToCategory('5815')).toBe('subscriptions');
-      expect(map.mccToCategory('5816')).toBe('subscriptions');
-      expect(map.mccToCategory('5818')).toBe('subscriptions');
-    });
-
-    it('should resolve web_services MCCs (computer services)', () => {
-      expect(map.mccToCategory('7372')).toBe('web_services');
-      expect(map.mccToCategory('7379')).toBe('web_services');
-    });
-
-    it('should return "other" for unknown MCC', () => {
-      expect(map.mccToCategory('0000')).toBe('other');
-      expect(map.mccToCategory('9999')).toBe('other');
-      expect(map.mccToCategory('1234')).toBe('other');
-    });
-
-    it('should return "other" for invalid MCC string', () => {
-      expect(map.mccToCategory('abcd')).toBe('other');
-      expect(map.mccToCategory('')).toBe('other');
-    });
-
-    it('should handle boundary values correctly', () => {
-      // Just before travel range
-      expect(map.mccToCategory('2999')).toBe('other');
-      // First travel MCC
-      expect(map.mccToCategory('3000')).toBe('travel');
-      // Last travel MCC in range
-      expect(map.mccToCategory('3999')).toBe('travel');
-      // Just after travel range
-      expect(map.mccToCategory('4000')).toBe('other');
-    });
-  });
-
-  /* ── categoryToMccRanges ──────────────────────────────────────────── */
-
-  describe('categoryToMccRanges', () => {
-    it('should return ranges for dining', () => {
-      const ranges = map.categoryToMccRanges('dining');
-      expect(ranges.length).toBeGreaterThan(0);
-      expect(ranges.some(r => r.min === 5812)).toBe(true);
-    });
-
-    it('should return multiple ranges for travel', () => {
-      const ranges = map.categoryToMccRanges('travel');
-      expect(ranges.length).toBeGreaterThan(1);
-    });
-
-    it('should return empty array for unmapped categories', () => {
-      const ranges = map.categoryToMccRanges('defi');
-      expect(ranges).toEqual([]);
-    });
-
-    it('should return empty array for api_costs (no MCC mapping)', () => {
-      const ranges = map.categoryToMccRanges('api_costs');
-      expect(ranges).toEqual([]);
-    });
-  });
-
-  /* ── categoryToMccCodes ───────────────────────────────────────────── */
-
-  describe('categoryToMccCodes', () => {
-    it('should expand dining to individual codes', () => {
-      const codes = map.categoryToMccCodes('dining');
-      expect(codes).toContain('5812');
-      expect(codes).toContain('5813');
-      expect(codes).toContain('5814');
-    });
-
-    it('should pad codes to 4 digits', () => {
-      const codes = map.categoryToMccCodes('dining');
-      for (const code of codes) {
-        expect(code.length).toBe(4);
-      }
-    });
-
-    it('should return empty for unmapped categories', () => {
-      expect(map.categoryToMccCodes('transfers')).toEqual([]);
-    });
-  });
-
-  /* ── getMappedCategories ──────────────────────────────────────────── */
-
-  describe('getMappedCategories', () => {
-    it('should return all categories with MCC mappings', () => {
-      const categories = map.getMappedCategories();
-      expect(categories).toContain('dining');
-      expect(categories).toContain('travel');
-      expect(categories).toContain('shopping');
-      expect(categories).toContain('entertainment');
-      expect(categories).toContain('utilities');
-      expect(categories).toContain('subscriptions');
-      expect(categories).toContain('web_services');
-    });
-
-    it('should not include categories without MCC mappings', () => {
-      const categories = map.getMappedCategories();
-      expect(categories).not.toContain('defi');
-      expect(categories).not.toContain('transfers');
-      expect(categories).not.toContain('api_costs');
-    });
-  });
-});

package/test/SpendingPolicyEnforcer.spec.ts

@@ -1,254 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Unit tests for SpendingPolicyEnforcer.
- *
- * Tests cover: per-tx limits, daily/monthly caps, category budgets,
- * blocked categories, address whitelists/blacklists, approval thresholds,
- * and spend recording.
- */
-
-import { describe, it, expect, beforeEach } from 'vitest';
-import { SpendingPolicyEnforcer, type ISpendingLedgerStore } from '../src/SpendingPolicyEnforcer.js';
-import type { SpendingPolicyConfig } from '../src/types.js';
-
-/* ------------------------------------------------------------------ */
-/*  In-memory ledger for tests                                         */
-/* ------------------------------------------------------------------ */
-
-function createTestLedger(): ISpendingLedgerStore & { entries: any[] } {
-  const entries: any[] = [];
-  return {
-    entries,
-    async sumByPeriod(agentId: string, periodKey: string) {
-      return entries
-        .filter(e => e.agentId === agentId && e.periodKey === periodKey)
-        .reduce((sum, e) => sum + e.amountUsd, 0);
-    },
-    async sumByCategoryAndPeriod(agentId: string, category: string, periodKey: string) {
-      return entries
-        .filter(e => e.agentId === agentId && e.category === category && e.periodKey === periodKey)
-        .reduce((sum, e) => sum + e.amountUsd, 0);
-    },
-    async insert(entry: any) {
-      entries.push(entry);
-    },
-  };
-}
-
-const AGENT = 'test-agent-1';
-
-/* ------------------------------------------------------------------ */
-/*  Tests                                                              */
-/* ------------------------------------------------------------------ */
-
-describe('SpendingPolicyEnforcer', () => {
-  let policy: SpendingPolicyConfig;
-  let ledger: ReturnType<typeof createTestLedger>;
-  let enforcer: SpendingPolicyEnforcer;
-
-  beforeEach(() => {
-    policy = {
-      dailyLimitUsd: 50,
-      perTransactionLimitUsd: 20,
-      monthlyLimitUsd: 500,
-      categoryBudgets: [
-        { category: 'api_costs', dailyLimitUsd: 10, monthlyLimitUsd: 100 },
-      ],
-      requireApprovalAboveUsd: 15,
-      blockedCategories: ['defi'],
-      allowedAddresses: ['0xAllowed1', '0xAllowed2'],
-      blockedAddresses: ['0xBlocked1'],
-    };
-    ledger = createTestLedger();
-    enforcer = new SpendingPolicyEnforcer(policy, ledger);
-  });
-
-  /* ── Per-transaction limit ─────────────────────────────────────── */
-
-  describe('per-transaction limit', () => {
-    it('should allow transactions within per-tx limit', async () => {
-      const result = await enforcer.canSpend(AGENT, 15, 'transfers');
-      expect(result.allowed).toBe(true);
-    });
-
-    it('should block transactions exceeding per-tx limit', async () => {
-      const result = await enforcer.canSpend(AGENT, 25, 'transfers');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('per-transaction limit');
-    });
-
-    it('should block transaction exactly at limit + epsilon', async () => {
-      const result = await enforcer.canSpend(AGENT, 20.01, 'transfers');
-      expect(result.allowed).toBe(false);
-    });
-  });
-
-  /* ── Daily limit ───────────────────────────────────────────────── */
-
-  describe('daily limit', () => {
-    it('should allow first transaction within daily limit', async () => {
-      const result = await enforcer.canSpend(AGENT, 10, 'transfers');
-      expect(result.allowed).toBe(true);
-      expect(result.remainingDailyUsd).toBe(40);
-    });
-
-    it('should block when daily limit would be exceeded', async () => {
-      // Pre-seed ledger with $45 of spending today
-      const today = new Date().toISOString().slice(0, 10);
-      ledger.entries.push({ agentId: AGENT, category: 'transfers', amountUsd: 45, periodKey: today });
-
-      const result = await enforcer.canSpend(AGENT, 10, 'transfers');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('Daily limit');
-    });
-
-    it('should allow up to remaining daily budget', async () => {
-      const today = new Date().toISOString().slice(0, 10);
-      ledger.entries.push({ agentId: AGENT, category: 'transfers', amountUsd: 40, periodKey: today });
-
-      const result = await enforcer.canSpend(AGENT, 10, 'transfers');
-      expect(result.allowed).toBe(true);
-      expect(result.remainingDailyUsd).toBe(0);
-    });
-  });
-
-  /* ── Monthly limit ─────────────────────────────────────────────── */
-
-  describe('monthly limit', () => {
-    it('should block when monthly limit would be exceeded', async () => {
-      const month = new Date().toISOString().slice(0, 7);
-      ledger.entries.push({ agentId: AGENT, category: 'transfers', amountUsd: 495, periodKey: month });
-
-      const result = await enforcer.canSpend(AGENT, 10, 'transfers');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('Monthly limit');
-    });
-  });
-
-  /* ── Category budgets ──────────────────────────────────────────── */
-
-  describe('category budgets', () => {
-    it('should enforce daily category budget', async () => {
-      const today = new Date().toISOString().slice(0, 10);
-      ledger.entries.push({ agentId: AGENT, category: 'api_costs', amountUsd: 8, periodKey: today });
-
-      const result = await enforcer.canSpend(AGENT, 5, 'api_costs');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('"api_costs" budget');
-    });
-
-    it('should enforce monthly category budget', async () => {
-      const month = new Date().toISOString().slice(0, 7);
-      ledger.entries.push({ agentId: AGENT, category: 'api_costs', amountUsd: 98, periodKey: month });
-
-      const result = await enforcer.canSpend(AGENT, 5, 'api_costs');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('"api_costs" budget');
-    });
-
-    it('should allow categories without specific budgets', async () => {
-      const result = await enforcer.canSpend(AGENT, 15, 'shopping');
-      expect(result.allowed).toBe(true);
-    });
-  });
-
-  /* ── Blocked categories ────────────────────────────────────────── */
-
-  describe('blocked categories', () => {
-    it('should block spend in blocked category', async () => {
-      const result = await enforcer.canSpend(AGENT, 1, 'defi');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('blocked');
-    });
-
-    it('should allow spend in non-blocked category', async () => {
-      const result = await enforcer.canSpend(AGENT, 5, 'transfers');
-      expect(result.allowed).toBe(true);
-    });
-  });
-
-  /* ── Address whitelist/blacklist ────────────────────────────────── */
-
-  describe('address restrictions', () => {
-    it('should block blacklisted address', async () => {
-      const result = await enforcer.canSpend(AGENT, 5, 'transfers', '0xBlocked1');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('blocked');
-    });
-
-    it('should allow whitelisted address', async () => {
-      const result = await enforcer.canSpend(AGENT, 5, 'transfers', '0xAllowed1');
-      expect(result.allowed).toBe(true);
-    });
-
-    it('should block address not in whitelist', async () => {
-      const result = await enforcer.canSpend(AGENT, 5, 'transfers', '0xRandom');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('not in the allowed list');
-    });
-
-    it('should allow any address when no whitelist is configured', async () => {
-      policy.allowedAddresses = undefined;
-      enforcer = new SpendingPolicyEnforcer(policy, ledger);
-
-      const result = await enforcer.canSpend(AGENT, 5, 'transfers', '0xAnything');
-      expect(result.allowed).toBe(true);
-    });
-  });
-
-  /* ── Approval threshold ────────────────────────────────────────── */
-
-  describe('approval threshold', () => {
-    it('should flag requiresApproval for amounts above threshold', async () => {
-      const result = await enforcer.canSpend(AGENT, 18, 'transfers', '0xAllowed1');
-      expect(result.allowed).toBe(true);
-      expect(result.requiresApproval).toBe(true);
-    });
-
-    it('should not flag requiresApproval for amounts at or below threshold', async () => {
-      const result = await enforcer.canSpend(AGENT, 15, 'transfers', '0xAllowed1');
-      expect(result.allowed).toBe(true);
-      expect(result.requiresApproval).toBe(false);
-    });
-  });
-
-  /* ── Spend recording ───────────────────────────────────────────── */
-
-  describe('recordSpend', () => {
-    it('should insert daily and monthly entries into the ledger', async () => {
-      await enforcer.recordSpend(AGENT, 10, 'api_costs');
-
-      // Should produce 2 entries: one daily, one monthly
-      expect(ledger.entries.length).toBe(2);
-      expect(ledger.entries[0].periodKey).toMatch(/^\d{4}-\d{2}-\d{2}$/); // YYYY-MM-DD
-      expect(ledger.entries[1].periodKey).toMatch(/^\d{4}-\d{2}$/);       // YYYY-MM
-      expect(ledger.entries[0].amountUsd).toBe(10);
-      expect(ledger.entries[0].category).toBe('api_costs');
-    });
-
-    it('should accumulate across multiple spends', async () => {
-      await enforcer.recordSpend(AGENT, 5, 'transfers');
-      await enforcer.recordSpend(AGENT, 8, 'transfers');
-
-      const today = new Date().toISOString().slice(0, 10);
-      const sum = await ledger.sumByPeriod(AGENT, today);
-      expect(sum).toBe(13);
-    });
-  });
-
-  /* ── Check order priority ──────────────────────────────────────── */
-
-  describe('check order', () => {
-    it('should block on category before checking limits', async () => {
-      const result = await enforcer.canSpend(AGENT, 1, 'defi', '0xAllowed1');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('blocked');
-    });
-
-    it('should block on blacklist before checking limits', async () => {
-      const result = await enforcer.canSpend(AGENT, 1, 'transfers', '0xBlocked1');
-      expect(result.allowed).toBe(false);
-      expect(result.reason).toContain('blocked');
-    });
-  });
-});

package/test/card-integration.spec.ts

@@ -1,242 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Integration tests for the card subsystem within the wallet extension pack.
- *
- * Tests the full lifecycle: extension pack creation with card enabled →
- * card tool registration → card issuance → status → spending summary →
- * freeze → unfreeze → close. Also verifies backwards compatibility
- * when card is disabled.
- */
-
-import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
-import { createExtensionPack } from '../src/index.js';
-import type { ExtensionPack } from '../src/index.js';
-
-/* ------------------------------------------------------------------ */
-/*  Mock fetch for Lithic API calls                                    */
-/* ------------------------------------------------------------------ */
-
-const mockFetch = vi.fn();
-
-beforeEach(() => {
-  vi.stubGlobal('fetch', mockFetch);
-  mockFetch.mockReset();
-
-  // Default mock for Lithic createCard
-  mockFetch.mockResolvedValue({
-    ok: true,
-    status: 200,
-    json: async () => ({
-      token: 'integration-card-token',
-      last_four: '8888',
-      type: 'VIRTUAL',
-      state: 'OPEN',
-      spend_limit: 50000,
-      spend_limit_duration: 'MONTHLY',
-      pan: '4111111111118888',
-      cvv: '789',
-      exp_month: '03',
-      exp_year: '2030',
-      funding: { token: 'fund-1', type: 'DEPOSITORY_CHECKING' },
-    }),
-  });
-});
-
-afterEach(() => {
-  vi.unstubAllGlobals();
-});
-
-/* ------------------------------------------------------------------ */
-/*  Tests                                                              */
-/* ------------------------------------------------------------------ */
-
-describe('card integration', () => {
-
-  /* ── Extension pack with cards disabled ────────────────────────── */
-
-  describe('card disabled (backwards compatibility)', () => {
-    it('should create pack with only 3 crypto tools when card not configured', () => {
-      const pack = createExtensionPack({
-        options: { enabled: true, chains: ['solana'] },
-      });
-
-      expect(pack.descriptors.length).toBe(3);
-      expect(pack.descriptors.every(d => d.kind === 'tool')).toBe(true);
-    });
-
-    it('should create pack with only 3 crypto tools when card.enabled=false', () => {
-      const pack = createExtensionPack({
-        options: { enabled: true, chains: ['solana'], card: { enabled: false, provider: 'lithic', defaultSpendLimitUsd: 500, allowPhysical: false } },
-      });
-
-      expect(pack.descriptors.length).toBe(3);
-    });
-  });
-
-  /* ── Extension pack with cards enabled ─────────────────────────── */
-
-  describe('card enabled', () => {
-    let pack: ExtensionPack;
-
-    beforeEach(() => {
-      pack = createExtensionPack({
-        options: {
-          enabled: true,
-          chains: ['solana'],
-          card: { enabled: true, provider: 'lithic', defaultSpendLimitUsd: 500, allowPhysical: false },
-        },
-        secrets: { LITHIC_API_KEY: 'test-lithic-key' },
-      });
-    });
-
-    it('should create pack with 9 tools (3 crypto + 6 card)', () => {
-      expect(pack.descriptors.length).toBe(9);
-      expect(pack.descriptors.every(d => d.kind === 'tool')).toBe(true);
-    });
-
-    it('should register all 6 card tools', () => {
-      const toolNames = pack.descriptors.map(d => d.id);
-      expect(toolNames).toContain('issue_virtual_card');
-      expect(toolNames).toContain('card_status');
-      expect(toolNames).toContain('freeze_card');
-      expect(toolNames).toContain('unfreeze_card');
-      expect(toolNames).toContain('card_spending_summary');
-      expect(toolNames).toContain('pay_with_card');
-    });
-
-    it('should still register all 3 crypto tools', () => {
-      const toolNames = pack.descriptors.map(d => d.id);
-      expect(toolNames).toContain('check_wallet_balance');
-      expect(toolNames).toContain('send_crypto');
-      expect(toolNames).toContain('wallet_transaction_history');
-    });
-
-    it('should set version to 0.2.0', () => {
-      expect(pack.version).toBe('0.2.0');
-    });
-
-    it('should call onActivate with card mention', async () => {
-      const logs: string[] = [];
-      const p = createExtensionPack({
-        options: {
-          enabled: true,
-          chains: ['solana'],
-          card: { enabled: true, provider: 'lithic', defaultSpendLimitUsd: 500, allowPhysical: false },
-        },
-        logger: { info: (m: string) => logs.push(m) },
-      });
-
-      await p.onActivate?.();
-      expect(logs.length).toBe(1);
-      expect(logs[0]).toContain('virtual card');
-    });
-  });
-
-  /* ── Card tool execution lifecycle ─────────────────────────────── */
-
-  describe('card tool lifecycle', () => {
-    const CTX = {
-      gmiId: 'integration-agent',
-      personaId: 'persona-1',
-      userContext: { userId: 'user-1' } as any,
-    };
-
-    function getTools(pack: ExtensionPack) {
-      const tools = new Map<string, any>();
-      for (const desc of pack.descriptors) {
-        if (desc.kind === 'tool') tools.set((desc.payload as any).name, desc.payload);
-      }
-      return tools;
-    }
-
-    it('should execute issue → status → freeze → unfreeze → close lifecycle', async () => {
-      const pack = createExtensionPack({
-        options: {
-          enabled: true,
-          chains: ['solana'],
-          card: { enabled: true, provider: 'lithic', defaultSpendLimitUsd: 500, allowPhysical: false },
-        },
-        secrets: { LITHIC_API_KEY: 'test-key' },
-      });
-
-      const tools = getTools(pack);
-
-      // Issue card
-      const issueResult = await tools.get('issue_virtual_card').execute({}, CTX);
-      expect(issueResult.success).toBe(true);
-      expect(issueResult.output.last4).toBe('8888');
-
-      // Check status
-      const statusResult = await tools.get('card_status').execute({}, CTX);
-      expect(statusResult.success).toBe(true);
-      expect(statusResult.output.state).toBe('OPEN');
-
-      // Spending summary (empty)
-      const spendingResult = await tools.get('card_spending_summary').execute({}, CTX);
-      expect(spendingResult.success).toBe(true);
-      expect(spendingResult.output.totalUsd).toBe(0);
-
-      // Freeze
-      const freezeResult = await tools.get('freeze_card').execute({}, CTX);
-      expect(freezeResult.success).toBe(true);
-      expect(freezeResult.output.state).toBe('PAUSED');
-
-      // Unfreeze
-      const unfreezeResult = await tools.get('unfreeze_card').execute({}, CTX);
-      expect(unfreezeResult.success).toBe(true);
-      expect(unfreezeResult.output.state).toBe('OPEN');
-    });
-
-    it('should return error from card tools when no card exists', async () => {
-      const pack = createExtensionPack({
-        options: {
-          enabled: true,
-          chains: ['solana'],
-          card: { enabled: true, provider: 'lithic', defaultSpendLimitUsd: 500, allowPhysical: false },
-        },
-      });
-
-      const tools = getTools(pack);
-
-      const statusResult = await tools.get('card_status').execute({}, CTX);
-      expect(statusResult.success).toBe(false);
-      expect(statusResult.error).toContain('No card found');
-
-      const freezeResult = await tools.get('freeze_card').execute({}, CTX);
-      expect(freezeResult.success).toBe(false);
-
-      const spendingResult = await tools.get('card_spending_summary').execute({}, CTX);
-      expect(spendingResult.success).toBe(false);
-    });
-
-    it('all tools should have category=wallet', () => {
-      const pack = createExtensionPack({
-        options: {
-          enabled: true,
-          chains: ['solana'],
-          card: { enabled: true, provider: 'lithic', defaultSpendLimitUsd: 500, allowPhysical: false },
-        },
-      });
-
-      for (const desc of pack.descriptors) {
-        expect((desc.payload as any).category).toBe('wallet');
-      }
-    });
-
-    it('all tools should have valid inputSchema', () => {
-      const pack = createExtensionPack({
-        options: {
-          enabled: true,
-          chains: ['solana'],
-          card: { enabled: true, provider: 'lithic', defaultSpendLimitUsd: 500, allowPhysical: false },
-        },
-      });
-
-      for (const desc of pack.descriptors) {
-        const tool = desc.payload as any;
-        expect(tool.inputSchema).toBeTruthy();
-        expect(tool.inputSchema.type).toBe('object');
-      }
-    });
-  });
-});