@framers/agentos-ext-wallet 0.2.0

package/dist/cards/CardManager.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview High-level card lifecycle manager.
+ *
+ * Mirrors AgentWalletManager's pattern: one card per agent, spending policy
+ * enforcement via the shared SpendingPolicyEnforcer, and in-memory/DB store
+ * abstraction via ICardStore.
+ *
+ * @module wallet/cards/CardManager
+ */
+import type { SpendingPolicyEnforcer } from '../SpendingPolicyEnforcer.js';
+import type { SpendCategory } from '../types.js';
+import type { MccCategoryMap } from './MccCategoryMap.js';
+import type { AgentCardRecord, CardConfig, ICardAdapter, ICardStore, LithicTransaction, SpendingSummary } from './types.js';
+export interface CardManagerOptions {
+    adapter: ICardAdapter;
+    store: ICardStore;
+    policyEnforcer: SpendingPolicyEnforcer;
+    mccMap: MccCategoryMap;
+    config: CardConfig;
+}
+export declare class CardManager {
+    private readonly adapter;
+    private readonly store;
+    private readonly policy;
+    private readonly mccMap;
+    private readonly config;
+    constructor(opts: CardManagerOptions);
+    /**
+     * Issue a new virtual card for the agent.
+     * One card per agent — throws if card already exists.
+     */
+    issueCard(agentId: string, opts?: {
+        memo?: string;
+        spendLimitUsd?: number;
+    }): Promise<AgentCardRecord>;
+    /** Get the agent's card record, or null. */
+    getCard(agentId: string): Promise<AgentCardRecord | null>;
+    /**
+     * Get sensitive card details (PAN, CVV, expiry) for online payments.
+     * Enforces spending policy before revealing details.
+     */
+    getCardDetails(agentId: string, estimatedAmountUsd?: number, category?: SpendCategory): Promise<{
+        last4: string;
+        expMonth: string;
+        expYear: string;
+        cvv: string;
+        pan: string;
+    }>;
+    /** Freeze (pause) the agent's card. */
+    freezeCard(agentId: string): Promise<void>;
+    /** Unfreeze (resume) the agent's card. */
+    unfreezeCard(agentId: string): Promise<void>;
+    /** Permanently close the agent's card. */
+    closeCard(agentId: string): Promise<void>;
+    getSpendingSummary(agentId: string, period?: 'day' | 'month'): Promise<SpendingSummary>;
+    /**
+     * Process a Lithic transaction webhook event.
+     * Resolves MCC → category and records the spend in the shared ledger.
+     */
+    processWebhookTransaction(agentId: string, lithicTx: LithicTransaction): Promise<void>;
+    private requireCard;
+    /**
+     * Build a flat list of blocked MCC codes from the spending policy's
+     * blockedCategories, expanded via the MCC map.
+     */
+    private getBlockedMccs;
+}
+export declare class CardSpendingBlockedError extends Error {
+    constructor(reason: string);
+}
+//# sourceMappingURL=CardManager.d.ts.map

package/dist/cards/CardManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardManager.d.ts","sourceRoot":"","sources":["../../src/cards/CardManager.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAEV,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,eAAe,EAChB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,cAAc,EAAE,sBAAsB,CAAC;IACvC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBAExB,IAAI,EAAE,kBAAkB;IAYpC;;;OAGG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC,eAAe,CAAC;IA0C3B,4CAA4C;IACtC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI/D;;;OAGG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,MAAM,EAC3B,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB1F,uCAAuC;IACjC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,0CAA0C;IACpC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,0CAA0C;IACpC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,KAAK,GAAG,OAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkCtG;;;OAGG;IACG,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YA+B9E,WAAW;IAQzB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAQvB;AAMD,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,MAAM,EAAE,MAAM;CAI3B"}

package/dist/cards/CardManager.js

@@ -0,0 +1,212 @@
+// @ts-nocheck
+/**
+ * @fileoverview High-level card lifecycle manager.
+ *
+ * Mirrors AgentWalletManager's pattern: one card per agent, spending policy
+ * enforcement via the shared SpendingPolicyEnforcer, and in-memory/DB store
+ * abstraction via ICardStore.
+ *
+ * @module wallet/cards/CardManager
+ */
+import { v4 as uuidv4 } from 'uuid';
+export class CardManager {
+    adapter;
+    store;
+    policy;
+    mccMap;
+    config;
+    constructor(opts) {
+        this.adapter = opts.adapter;
+        this.store = opts.store;
+        this.policy = opts.policyEnforcer;
+        this.mccMap = opts.mccMap;
+        this.config = opts.config;
+    }
+    // -----------------------------------------------------------------------
+    // Card lifecycle
+    // -----------------------------------------------------------------------
+    /**
+     * Issue a new virtual card for the agent.
+     * One card per agent — throws if card already exists.
+     */
+    async issueCard(agentId, opts) {
+        const existing = await this.store.getCard(agentId);
+        if (existing) {
+            throw new Error(`Agent ${agentId} already has a card (last4: ${existing.last4})`);
+        }
+        const spendLimit = opts?.spendLimitUsd ?? this.config.defaultSpendLimitUsd;
+        const lithicCard = await this.adapter.createCard({
+            type: 'VIRTUAL',
+            memo: opts?.memo || `Agent ${agentId} virtual card`,
+            spend_limit: Math.round(spendLimit * 100), // Lithic uses cents
+            spend_limit_duration: 'MONTHLY',
+            state: 'OPEN',
+        });
+        // Set auth rules for blocked categories
+        const blockedMccs = this.getBlockedMccs();
+        if (blockedMccs.length > 0) {
+            await this.adapter.createAuthRule(lithicCard.token, {
+                blocked_mcc: blockedMccs,
+            });
+        }
+        const record = {
+            id: uuidv4(),
+            agentId,
+            lithicCardToken: lithicCard.token,
+            last4: lithicCard.last_four,
+            cardType: lithicCard.type,
+            state: lithicCard.state,
+            spendLimitUsd: spendLimit,
+            spendLimitDuration: 'MONTHLY',
+            network: 'VISA',
+            memo: opts?.memo,
+            createdAt: Date.now(),
+        };
+        await this.store.saveCard(record);
+        return record;
+    }
+    /** Get the agent's card record, or null. */
+    async getCard(agentId) {
+        return this.store.getCard(agentId);
+    }
+    /**
+     * Get sensitive card details (PAN, CVV, expiry) for online payments.
+     * Enforces spending policy before revealing details.
+     */
+    async getCardDetails(agentId, estimatedAmountUsd, category) {
+        const card = await this.requireCard(agentId);
+        // If an estimated amount is provided, check spending policy first
+        if (estimatedAmountUsd !== undefined) {
+            const check = await this.policy.canSpend(agentId, estimatedAmountUsd, category || 'shopping');
+            if (!check.allowed) {
+                throw new CardSpendingBlockedError(check.reason || 'Spending policy violation');
+            }
+        }
+        const lithicCard = await this.adapter.getCard(card.lithicCardToken);
+        return {
+            last4: lithicCard.last_four,
+            expMonth: lithicCard.exp_month || '',
+            expYear: lithicCard.exp_year || '',
+            cvv: lithicCard.cvv || '',
+            pan: lithicCard.pan || '',
+        };
+    }
+    /** Freeze (pause) the agent's card. */
+    async freezeCard(agentId) {
+        const card = await this.requireCard(agentId);
+        if (card.state === 'PAUSED')
+            return;
+        if (card.state === 'CLOSED')
+            throw new Error('Cannot freeze a closed card');
+        await this.adapter.pauseCard(card.lithicCardToken);
+        await this.store.updateCardState(agentId, 'PAUSED');
+    }
+    /** Unfreeze (resume) the agent's card. */
+    async unfreezeCard(agentId) {
+        const card = await this.requireCard(agentId);
+        if (card.state === 'OPEN')
+            return;
+        if (card.state === 'CLOSED')
+            throw new Error('Cannot unfreeze a closed card');
+        await this.adapter.resumeCard(card.lithicCardToken);
+        await this.store.updateCardState(agentId, 'OPEN');
+    }
+    /** Permanently close the agent's card. */
+    async closeCard(agentId) {
+        const card = await this.requireCard(agentId);
+        if (card.state === 'CLOSED')
+            return;
+        await this.adapter.closeCard(card.lithicCardToken);
+        await this.store.updateCardState(agentId, 'CLOSED');
+    }
+    // -----------------------------------------------------------------------
+    // Spending summary
+    // -----------------------------------------------------------------------
+    async getSpendingSummary(agentId, period = 'month') {
+        const card = await this.requireCard(agentId);
+        const now = new Date();
+        let since;
+        if (period === 'day') {
+            since = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
+        }
+        else {
+            since = new Date(now.getFullYear(), now.getMonth(), 1).getTime();
+        }
+        const txs = await this.store.getTransactionsByPeriod(card.id, since);
+        const settled = txs.filter(t => t.status === 'SETTLED' || t.status === 'PENDING');
+        const byCategory = new Map();
+        let totalUsd = 0;
+        for (const tx of settled) {
+            totalUsd += tx.amountUsd;
+            byCategory.set(tx.category, (byCategory.get(tx.category) || 0) + tx.amountUsd);
+        }
+        return {
+            totalUsd,
+            period,
+            byCategory: [...byCategory.entries()].map(([category, amountUsd]) => ({ category, amountUsd })),
+            transactionCount: settled.length,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Webhook processing
+    // -----------------------------------------------------------------------
+    /**
+     * Process a Lithic transaction webhook event.
+     * Resolves MCC → category and records the spend in the shared ledger.
+     */
+    async processWebhookTransaction(agentId, lithicTx) {
+        const card = await this.store.getCard(agentId);
+        if (!card)
+            return; // Unknown card — ignore
+        const category = this.mccMap.mccToCategory(lithicTx.merchant.mcc);
+        const amountUsd = Math.abs(lithicTx.amount) / 100; // Lithic amounts are in cents
+        const txRecord = {
+            id: uuidv4(),
+            cardId: card.id,
+            lithicTxToken: lithicTx.token,
+            merchantName: lithicTx.merchant.descriptor,
+            merchantMcc: lithicTx.merchant.mcc,
+            category,
+            amountUsd,
+            status: lithicTx.status,
+            createdAt: Date.now(),
+        };
+        await this.store.insertTransaction(txRecord);
+        // Record in shared spending ledger (same as crypto sends)
+        if (lithicTx.status === 'SETTLED' || lithicTx.status === 'PENDING') {
+            await this.policy.recordSpend(agentId, amountUsd, category);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Internal helpers
+    // -----------------------------------------------------------------------
+    async requireCard(agentId) {
+        const card = await this.store.getCard(agentId);
+        if (!card) {
+            throw new Error(`No card found for agent ${agentId}. Issue one first.`);
+        }
+        return card;
+    }
+    /**
+     * Build a flat list of blocked MCC codes from the spending policy's
+     * blockedCategories, expanded via the MCC map.
+     */
+    getBlockedMccs() {
+        // Access the policy's config to get blocked categories
+        // The SpendingPolicyEnforcer doesn't expose config directly,
+        // so we pass blocked categories through the card config or
+        // use the MCC map to expand known blocked categories.
+        // For now, this is handled at the extension pack level.
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Error classes
+// ---------------------------------------------------------------------------
+export class CardSpendingBlockedError extends Error {
+    constructor(reason) {
+        super(reason);
+        this.name = 'CardSpendingBlockedError';
+    }
+}
+//# sourceMappingURL=CardManager.js.map

package/dist/cards/CardManager.js.map

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

package/dist/cards/LithicCardAdapter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Pure REST client for the Lithic card issuance API.
+ *
+ * No SDK dependency — uses fetch() directly. Supports sandbox and production
+ * environments via configurable base URL.
+ *
+ * @see https://docs.lithic.com/reference
+ * @module wallet/cards/LithicCardAdapter
+ */
+import type { AuthRuleParams, CreateCardParams, ICardAdapter, LithicCardResponse, LithicTransaction, ListTxOpts, UpdateCardParams } from './types.js';
+export interface LithicCardAdapterOptions {
+    apiKey: string;
+    /** Use sandbox environment. Defaults to true. */
+    sandbox?: boolean;
+    /** Override base URL (for testing). */
+    baseUrl?: string;
+}
+export declare class LithicCardAdapter implements ICardAdapter {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(opts: LithicCardAdapterOptions);
+    createCard(params: CreateCardParams): Promise<LithicCardResponse>;
+    getCard(cardToken: string): Promise<LithicCardResponse>;
+    updateCard(cardToken: string, updates: UpdateCardParams): Promise<LithicCardResponse>;
+    pauseCard(cardToken: string): Promise<void>;
+    resumeCard(cardToken: string): Promise<void>;
+    closeCard(cardToken: string): Promise<void>;
+    listTransactions(cardToken: string, opts?: ListTxOpts): Promise<LithicTransaction[]>;
+    createAuthRule(cardToken: string, rule: AuthRuleParams): Promise<void>;
+    private get;
+    private post;
+    private patch;
+    private request;
+}
+export declare class LithicApiError extends Error {
+    readonly statusCode: number;
+    readonly path: string;
+    constructor(statusCode: number, message: string, path: string);
+}
+//# sourceMappingURL=LithicCardAdapter.d.ts.map

package/dist/cards/LithicCardAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LithicCardAdapter.d.ts","sourceRoot":"","sources":["../../src/cards/LithicCardAdapter.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AASD,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,IAAI,EAAE,wBAAwB;IASpC,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIvD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIrF,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAepF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAW9D,GAAG;YAIH,IAAI;YAIJ,KAAK;YAIL,OAAO;CAwBtB;AAMD,qBAAa,cAAe,SAAQ,KAAK;aAErB,UAAU,EAAE,MAAM;aAElB,IAAI,EAAE,MAAM;gBAFZ,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK/B"}

package/dist/cards/LithicCardAdapter.js

@@ -0,0 +1,116 @@
+// @ts-nocheck
+/**
+ * @fileoverview Pure REST client for the Lithic card issuance API.
+ *
+ * No SDK dependency — uses fetch() directly. Supports sandbox and production
+ * environments via configurable base URL.
+ *
+ * @see https://docs.lithic.com/reference
+ * @module wallet/cards/LithicCardAdapter
+ */
+const SANDBOX_URL = 'https://sandbox.lithic.com/v1';
+const PRODUCTION_URL = 'https://api.lithic.com/v1';
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+export class LithicCardAdapter {
+    apiKey;
+    baseUrl;
+    constructor(opts) {
+        this.apiKey = opts.apiKey;
+        this.baseUrl = opts.baseUrl || (opts.sandbox !== false ? SANDBOX_URL : PRODUCTION_URL);
+    }
+    // -----------------------------------------------------------------------
+    // Card CRUD
+    // -----------------------------------------------------------------------
+    async createCard(params) {
+        return this.post('/cards', params);
+    }
+    async getCard(cardToken) {
+        return this.get(`/cards/${cardToken}`);
+    }
+    async updateCard(cardToken, updates) {
+        return this.patch(`/cards/${cardToken}`, updates);
+    }
+    async pauseCard(cardToken) {
+        await this.patch(`/cards/${cardToken}`, { state: 'PAUSED' });
+    }
+    async resumeCard(cardToken) {
+        await this.patch(`/cards/${cardToken}`, { state: 'OPEN' });
+    }
+    async closeCard(cardToken) {
+        await this.patch(`/cards/${cardToken}`, { state: 'CLOSED' });
+    }
+    // -----------------------------------------------------------------------
+    // Transactions
+    // -----------------------------------------------------------------------
+    async listTransactions(cardToken, opts) {
+        const params = new URLSearchParams();
+        params.set('card_token', cardToken);
+        if (opts?.begin)
+            params.set('begin', opts.begin);
+        if (opts?.end)
+            params.set('end', opts.end);
+        if (opts?.page_size)
+            params.set('page_size', String(opts.page_size));
+        const result = await this.get(`/transactions?${params.toString()}`);
+        return result.data;
+    }
+    // -----------------------------------------------------------------------
+    // Auth rules (MCC-based spending controls)
+    // -----------------------------------------------------------------------
+    async createAuthRule(cardToken, rule) {
+        await this.post('/auth_rules', {
+            card_tokens: [cardToken],
+            ...rule,
+        });
+    }
+    // -----------------------------------------------------------------------
+    // HTTP helpers
+    // -----------------------------------------------------------------------
+    async get(path) {
+        return this.request('GET', path);
+    }
+    async post(path, body) {
+        return this.request('POST', path, body);
+    }
+    async patch(path, body) {
+        return this.request('PATCH', path, body);
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Authorization': this.apiKey,
+            'Accept': 'application/json',
+        };
+        if (body)
+            headers['Content-Type'] = 'application/json';
+        const resp = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => '');
+            throw new LithicApiError(resp.status, `Lithic API error ${resp.status}: ${text}`, path);
+        }
+        // Some endpoints return no body (204)
+        if (resp.status === 204)
+            return undefined;
+        return resp.json();
+    }
+}
+// ---------------------------------------------------------------------------
+// Error
+// ---------------------------------------------------------------------------
+export class LithicApiError extends Error {
+    statusCode;
+    path;
+    constructor(statusCode, message, path) {
+        super(message);
+        this.statusCode = statusCode;
+        this.path = path;
+        this.name = 'LithicApiError';
+    }
+}
+//# sourceMappingURL=LithicCardAdapter.js.map

package/dist/cards/LithicCardAdapter.js.map

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

package/dist/cards/MccCategoryMap.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Merchant Category Code (MCC) → SpendCategory mapping.
+ *
+ * Maps 4-digit MCC codes used by card networks to the wallet extension's
+ * SpendCategory enum. Uses range-based matching for efficient lookup.
+ *
+ * @module wallet/cards/MccCategoryMap
+ */
+import type { SpendCategory } from '../types.js';
+export declare class MccCategoryMap {
+    private readonly ranges;
+    constructor();
+    /**
+     * Resolve a 4-digit MCC string to a SpendCategory.
+     * Returns 'other' if no matching range is found.
+     */
+    mccToCategory(mcc: string): SpendCategory;
+    /**
+     * Get all MCC ranges that map to a given SpendCategory.
+     * Useful for building Lithic auth rules.
+     */
+    categoryToMccRanges(category: SpendCategory): Array<{
+        min: number;
+        max: number;
+    }>;
+    /**
+     * Get all individual MCC codes for a category (expands ranges).
+     * Useful for Lithic's blocked_mcc list which expects individual codes.
+     */
+    categoryToMccCodes(category: SpendCategory): string[];
+    /**
+     * Get all categories that have MCC mappings.
+     */
+    getMappedCategories(): SpendCategory[];
+}
+//# sourceMappingURL=MccCategoryMap.d.ts.map

package/dist/cards/MccCategoryMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MccCategoryMap.d.ts","sourceRoot":"","sources":["../../src/cards/MccCategoryMap.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoEjD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;;IAOpC;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAYzC;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAMjF;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE;IAWrD;;OAEG;IACH,mBAAmB,IAAI,aAAa,EAAE;CAOvC"}

package/dist/cards/MccCategoryMap.js

@@ -0,0 +1,113 @@
+// @ts-nocheck
+/**
+ * @fileoverview Merchant Category Code (MCC) → SpendCategory mapping.
+ *
+ * Maps 4-digit MCC codes used by card networks to the wallet extension's
+ * SpendCategory enum. Uses range-based matching for efficient lookup.
+ *
+ * @module wallet/cards/MccCategoryMap
+ */
+/**
+ * Ordered list of MCC ranges → SpendCategory mappings.
+ * Ranges are inclusive on both ends.
+ */
+const MCC_RANGES = [
+    // Travel: airlines, hotels, rental cars, travel agencies
+    { min: 3000, max: 3999, category: 'travel' },
+    { min: 4511, max: 4511, category: 'travel' }, // airlines
+    { min: 4722, max: 4722, category: 'travel' }, // travel agencies
+    { min: 7011, max: 7012, category: 'travel' }, // hotels, timeshares
+    { min: 7033, max: 7033, category: 'travel' }, // trailer parks
+    { min: 7512, max: 7519, category: 'travel' }, // car rental
+    // Utilities: telecom, electric, gas, water
+    { min: 4812, max: 4816, category: 'utilities' }, // telecom
+    { min: 4899, max: 4900, category: 'utilities' }, // cable, electric/gas/water
+    // Shopping: general retail
+    { min: 5200, max: 5499, category: 'shopping' }, // home supply, dept stores
+    { min: 5511, max: 5599, category: 'shopping' }, // auto dealers, auto parts
+    { min: 5600, max: 5699, category: 'shopping' }, // apparel
+    { min: 5700, max: 5799, category: 'shopping' }, // furniture, electronics
+    { min: 5900, max: 5999, category: 'shopping' }, // retail stores, misc
+    // Dining: restaurants, bars, fast food
+    { min: 5811, max: 5811, category: 'dining' }, // caterers
+    { min: 5812, max: 5812, category: 'dining' }, // eating places/restaurants
+    { min: 5813, max: 5813, category: 'dining' }, // bars/taverns
+    { min: 5814, max: 5814, category: 'dining' }, // fast food
+    // Subscriptions: digital goods/services
+    { min: 5815, max: 5818, category: 'subscriptions' }, // digital goods, games, apps, streaming
+    // Entertainment: movies, theaters, events, recreation
+    { min: 7832, max: 7833, category: 'entertainment' }, // movie theaters
+    { min: 7841, max: 7841, category: 'entertainment' }, // video tape rental
+    { min: 7911, max: 7911, category: 'entertainment' }, // dance halls/studios
+    { min: 7922, max: 7922, category: 'entertainment' }, // theatrical producers
+    { min: 7929, max: 7929, category: 'entertainment' }, // bands/orchestras
+    { min: 7932, max: 7933, category: 'entertainment' }, // billiards, bowling
+    { min: 7941, max: 7941, category: 'entertainment' }, // sports clubs/fields
+    { min: 7991, max: 7999, category: 'entertainment' }, // tourist attractions, recreation
+    // Web services: computer programming, data processing, IT
+    { min: 7372, max: 7379, category: 'web_services' }, // computer services
+    { min: 4816, max: 4816, category: 'web_services' }, // computer network/info services (re-mapped from utilities for precision)
+    // API costs: SaaS / cloud compute (commonly billed under computer services)
+    // Note: most SaaS bills under 7372 (web_services). If needed, specific
+    // merchant descriptors can override at the CardManager level.
+];
+// ---------------------------------------------------------------------------
+// Lookup class
+// ---------------------------------------------------------------------------
+export class MccCategoryMap {
+    ranges;
+    constructor() {
+        // Sort by min for binary-search-friendly access
+        this.ranges = [...MCC_RANGES].sort((a, b) => a.min - b.min);
+    }
+    /**
+     * Resolve a 4-digit MCC string to a SpendCategory.
+     * Returns 'other' if no matching range is found.
+     */
+    mccToCategory(mcc) {
+        const code = parseInt(mcc, 10);
+        if (isNaN(code))
+            return 'other';
+        for (const range of this.ranges) {
+            if (code >= range.min && code <= range.max) {
+                return range.category;
+            }
+        }
+        return 'other';
+    }
+    /**
+     * Get all MCC ranges that map to a given SpendCategory.
+     * Useful for building Lithic auth rules.
+     */
+    categoryToMccRanges(category) {
+        return this.ranges
+            .filter(r => r.category === category)
+            .map(({ min, max }) => ({ min, max }));
+    }
+    /**
+     * Get all individual MCC codes for a category (expands ranges).
+     * Useful for Lithic's blocked_mcc list which expects individual codes.
+     */
+    categoryToMccCodes(category) {
+        const codes = [];
+        for (const range of this.ranges) {
+            if (range.category !== category)
+                continue;
+            for (let code = range.min; code <= range.max; code++) {
+                codes.push(code.toString().padStart(4, '0'));
+            }
+        }
+        return codes;
+    }
+    /**
+     * Get all categories that have MCC mappings.
+     */
+    getMappedCategories() {
+        const categories = new Set();
+        for (const range of this.ranges) {
+            categories.add(range.category);
+        }
+        return [...categories];
+    }
+}
+//# sourceMappingURL=MccCategoryMap.js.map

package/dist/cards/MccCategoryMap.js.map

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