pay-lobster 1.0.0

package/dist/notifications.js

@@ -0,0 +1,350 @@
+"use strict";
+/**
+ * Payment Notifications & Webhooks
+ *
+ * Real-time notifications for USDC transactions and events.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationManager = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const DATA_DIR = process.env.USDC_DATA_DIR || './data';
+/**
+ * Notification Manager
+ */
+class NotificationManager {
+    constructor(dataDir = DATA_DIR) {
+        this.configPath = path_1.default.join(dataDir, 'notification-configs.json');
+        this.historyPath = path_1.default.join(dataDir, 'notification-history.json');
+    }
+    async loadConfigs() {
+        try {
+            const data = await promises_1.default.readFile(this.configPath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return [];
+        }
+    }
+    async saveConfigs(configs) {
+        await promises_1.default.mkdir(path_1.default.dirname(this.configPath), { recursive: true });
+        await promises_1.default.writeFile(this.configPath, JSON.stringify(configs, null, 2));
+    }
+    async loadHistory() {
+        try {
+            const data = await promises_1.default.readFile(this.historyPath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return [];
+        }
+    }
+    async saveHistory(history) {
+        await promises_1.default.mkdir(path_1.default.dirname(this.historyPath), { recursive: true });
+        // Keep last 1000 notifications
+        const trimmed = history.slice(-1000);
+        await promises_1.default.writeFile(this.historyPath, JSON.stringify(trimmed, null, 2));
+    }
+    // ============ Configuration Management ============
+    /**
+     * Create notification configuration
+     */
+    async createConfig(params) {
+        const configs = await this.loadConfigs();
+        const config = {
+            id: crypto_1.default.randomUUID(),
+            name: params.name,
+            enabled: true,
+            triggers: params.triggers,
+            channels: params.channels,
+            cooldownMs: params.cooldownMs,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        configs.push(config);
+        await this.saveConfigs(configs);
+        return config;
+    }
+    /**
+     * Enable/disable notification config
+     */
+    async toggleConfig(id, enabled) {
+        const configs = await this.loadConfigs();
+        const config = configs.find(c => c.id === id);
+        if (config) {
+            config.enabled = enabled;
+            config.updatedAt = new Date().toISOString();
+            await this.saveConfigs(configs);
+        }
+        return config || null;
+    }
+    /**
+     * List notification configs
+     */
+    async listConfigs() {
+        return this.loadConfigs();
+    }
+    /**
+     * Delete notification config
+     */
+    async deleteConfig(id) {
+        const configs = await this.loadConfigs();
+        const index = configs.findIndex(c => c.id === id);
+        if (index >= 0) {
+            configs.splice(index, 1);
+            await this.saveConfigs(configs);
+            return true;
+        }
+        return false;
+    }
+    // ============ Notification Triggering ============
+    /**
+     * Process a transaction and trigger matching notifications
+     */
+    async processTransaction(tx) {
+        const configs = await this.loadConfigs();
+        const triggeredNotifications = [];
+        const now = new Date();
+        for (const config of configs) {
+            if (!config.enabled)
+                continue;
+            // Check cooldown
+            if (config.cooldownMs && config.lastTriggeredAt) {
+                const timeSince = now.getTime() - new Date(config.lastTriggeredAt).getTime();
+                if (timeSince < config.cooldownMs)
+                    continue;
+            }
+            // Check triggers
+            const matchingTrigger = config.triggers.find(trigger => {
+                if (trigger.type !== tx.type)
+                    return false;
+                if (trigger.minAmount && parseFloat(tx.amount) < parseFloat(trigger.minAmount)) {
+                    return false;
+                }
+                if (trigger.addresses && trigger.addresses.length > 0) {
+                    const relevantAddr = tx.type === 'incoming' ? tx.fromAddress : tx.toAddress;
+                    if (!trigger.addresses.some(a => a.toLowerCase() === relevantAddr.toLowerCase())) {
+                        return false;
+                    }
+                }
+                if (trigger.chains && trigger.chains.length > 0) {
+                    if (!trigger.chains.includes(tx.chain))
+                        return false;
+                }
+                return true;
+            });
+            if (!matchingTrigger)
+                continue;
+            // Create notification
+            const notification = await this.createNotification({
+                configId: config.id,
+                type: tx.type === 'incoming' ? 'payment_received' : 'payment_sent',
+                title: tx.type === 'incoming'
+                    ? `Received ${tx.amount} USDC`
+                    : `Sent ${tx.amount} USDC`,
+                message: tx.type === 'incoming'
+                    ? `You received ${tx.amount} USDC from ${this.shortAddress(tx.fromAddress)} on ${tx.chain}`
+                    : `You sent ${tx.amount} USDC to ${this.shortAddress(tx.toAddress)} on ${tx.chain}`,
+                data: tx,
+                channels: config.channels,
+            });
+            triggeredNotifications.push(notification);
+            // Update last triggered
+            config.lastTriggeredAt = now.toISOString();
+        }
+        await this.saveConfigs(configs);
+        return triggeredNotifications;
+    }
+    /**
+     * Create and deliver a notification
+     */
+    async createNotification(params) {
+        const notification = {
+            id: crypto_1.default.randomUUID(),
+            configId: params.configId,
+            type: params.type,
+            title: params.title,
+            message: params.message,
+            data: params.data,
+            deliveries: params.channels.map(ch => ({
+                channel: ch.type,
+                status: 'pending',
+            })),
+            createdAt: new Date().toISOString(),
+        };
+        // Attempt delivery to each channel
+        for (let i = 0; i < params.channels.length; i++) {
+            const channel = params.channels[i];
+            try {
+                await this.deliver(channel, notification);
+                notification.deliveries[i].status = 'sent';
+                notification.deliveries[i].sentAt = new Date().toISOString();
+            }
+            catch (err) {
+                notification.deliveries[i].status = 'failed';
+                notification.deliveries[i].error = err.message;
+            }
+        }
+        // Save to history
+        const history = await this.loadHistory();
+        history.push(notification);
+        await this.saveHistory(history);
+        return notification;
+    }
+    /**
+     * Deliver notification to a channel
+     */
+    async deliver(channel, notification) {
+        switch (channel.type) {
+            case 'webhook':
+                await this.deliverWebhook(channel.config, notification);
+                break;
+            case 'telegram':
+                await this.deliverTelegram(channel.config, notification);
+                break;
+            case 'clawdbot':
+                await this.deliverClawdbot(channel.config, notification);
+                break;
+            case 'email':
+                // Email delivery would require SMTP config
+                console.log('Email delivery not implemented');
+                break;
+            default:
+                throw new Error(`Unknown channel type: ${channel.type}`);
+        }
+    }
+    /**
+     * Deliver via webhook
+     */
+    async deliverWebhook(config, notification) {
+        if (!config.url) {
+            throw new Error('Webhook URL not configured');
+        }
+        const payload = {
+            id: notification.id,
+            type: notification.type,
+            title: notification.title,
+            message: notification.message,
+            data: notification.data,
+            timestamp: notification.createdAt,
+        };
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        // Add optional secret for verification
+        if (config.secret) {
+            const signature = crypto_1.default
+                .createHmac('sha256', config.secret)
+                .update(JSON.stringify(payload))
+                .digest('hex');
+            headers['X-Signature'] = signature;
+        }
+        const response = await fetch(config.url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            throw new Error(`Webhook failed: ${response.status}`);
+        }
+    }
+    /**
+     * Deliver via Telegram (would integrate with Clawdbot's messaging)
+     */
+    async deliverTelegram(config, notification) {
+        // This would use Clawdbot's message tool
+        console.log(`[Telegram] ${notification.title}: ${notification.message}`);
+        // In practice, this would call the message API
+    }
+    /**
+     * Deliver via Clawdbot session message
+     */
+    async deliverClawdbot(config, notification) {
+        // This would use sessions_send
+        console.log(`[Clawdbot] ${notification.title}: ${notification.message}`);
+        // In practice, this would call sessions_send
+    }
+    // ============ History & Management ============
+    /**
+     * Get notification history
+     */
+    async getHistory(options) {
+        let history = await this.loadHistory();
+        if (options?.type) {
+            history = history.filter(n => n.type === options.type);
+        }
+        if (options?.unreadOnly) {
+            history = history.filter(n => !n.readAt);
+        }
+        history.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        if (options?.limit) {
+            history = history.slice(0, options.limit);
+        }
+        return history;
+    }
+    /**
+     * Mark notification as read
+     */
+    async markRead(id) {
+        const history = await this.loadHistory();
+        const notification = history.find(n => n.id === id);
+        if (notification) {
+            notification.readAt = new Date().toISOString();
+            await this.saveHistory(history);
+        }
+    }
+    /**
+     * Mark all as read
+     */
+    async markAllRead() {
+        const history = await this.loadHistory();
+        const now = new Date().toISOString();
+        for (const notification of history) {
+            if (!notification.readAt) {
+                notification.readAt = now;
+            }
+        }
+        await this.saveHistory(history);
+    }
+    /**
+     * Get unread count
+     */
+    async getUnreadCount() {
+        const history = await this.loadHistory();
+        return history.filter(n => !n.readAt).length;
+    }
+    // ============ Helpers ============
+    /**
+     * Shorten address for display
+     */
+    shortAddress(address) {
+        return `${address.slice(0, 6)}...${address.slice(-4)}`;
+    }
+    /**
+     * Create default notification configs for a new user
+     */
+    async createDefaultConfigs() {
+        const configs = [];
+        // Incoming payments
+        configs.push(await this.createConfig({
+            name: 'All Incoming Payments',
+            triggers: [{ type: 'incoming' }],
+            channels: [{ type: 'clawdbot', config: {} }],
+        }));
+        // Large outgoing (security alert)
+        configs.push(await this.createConfig({
+            name: 'Large Outgoing (>1000 USDC)',
+            triggers: [{ type: 'outgoing', minAmount: '1000' }],
+            channels: [{ type: 'clawdbot', config: {} }],
+            cooldownMs: 60000, // 1 min cooldown
+        }));
+        return configs;
+    }
+}
+exports.NotificationManager = NotificationManager;
+exports.default = NotificationManager;
+//# sourceMappingURL=notifications.js.map

package/dist/notifications.js.map

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

package/dist/tips.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Tip Jar / Creator Economy Module
+ *
+ * Enable Clawdbot operators and agents to receive USDC tips
+ * via simple commands. Built for the creator economy.
+ */
+export interface TipJar {
+    id: string;
+    name: string;
+    description?: string;
+    ownerId: string;
+    ownerName: string;
+    addresses: {
+        chain: string;
+        address: string;
+        isDefault: boolean;
+    }[];
+    settings: {
+        minTip: string;
+        suggestedAmounts: string[];
+        thankYouMessage?: string;
+        allowAnonymous: boolean;
+        notifyOnTip: boolean;
+    };
+    stats: {
+        totalReceived: string;
+        tipCount: number;
+        uniqueTippers: number;
+        largestTip: string;
+        lastTipAt?: string;
+    };
+    publicSlug?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Tip {
+    id: string;
+    tipJarId: string;
+    fromAddress: string;
+    fromName?: string;
+    isAnonymous: boolean;
+    amount: string;
+    chain: string;
+    txHash: string;
+    message?: string;
+    status: 'pending' | 'confirmed' | 'failed';
+    confirmedAt?: string;
+    createdAt: string;
+}
+export interface Leaderboard {
+    tipJarId: string;
+    period: 'all-time' | 'monthly' | 'weekly';
+    entries: {
+        rank: number;
+        name: string;
+        address: string;
+        totalTipped: string;
+        tipCount: number;
+    }[];
+    generatedAt: string;
+}
+/**
+ * Tip Jar Manager
+ */
+export declare class TipJarManager {
+    private jarsPath;
+    private tipsPath;
+    constructor(dataDir?: string);
+    private loadJars;
+    private saveJars;
+    private loadTips;
+    private saveTips;
+    /**
+     * Create a new tip jar
+     */
+    createJar(params: {
+        ownerId: string;
+        ownerName: string;
+        name?: string;
+        description?: string;
+        addresses: {
+            chain: string;
+            address: string;
+        }[];
+        publicSlug?: string;
+        settings?: Partial<TipJar['settings']>;
+    }): Promise<TipJar>;
+    /**
+     * Get tip jar by ID, slug, or owner
+     */
+    getJar(identifier: string): Promise<TipJar | null>;
+    /**
+     * Update tip jar settings
+     */
+    updateJar(id: string, updates: Partial<Pick<TipJar, 'name' | 'description' | 'settings' | 'publicSlug'>>): Promise<TipJar | null>;
+    /**
+     * Add address to tip jar
+     */
+    addAddress(jarId: string, chain: string, address: string): Promise<TipJar | null>;
+    /**
+     * Set default address
+     */
+    setDefaultAddress(jarId: string, chain: string): Promise<TipJar | null>;
+    /**
+     * Record a tip
+     */
+    recordTip(params: {
+        tipJarId: string;
+        fromAddress: string;
+        fromName?: string;
+        isAnonymous?: boolean;
+        amount: string;
+        chain: string;
+        txHash: string;
+        message?: string;
+    }): Promise<Tip>;
+    /**
+     * Get tips for a jar
+     */
+    getTips(jarId: string, options?: {
+        limit?: number;
+        includeAnonymous?: boolean;
+    }): Promise<Tip[]>;
+    /**
+     * Get recent tips across all jars (for activity feed)
+     */
+    getRecentTips(limit?: number): Promise<(Tip & {
+        jarName: string;
+    })[]>;
+    /**
+     * Generate leaderboard for a tip jar
+     */
+    getLeaderboard(jarId: string, period?: Leaderboard['period']): Promise<Leaderboard>;
+    /**
+     * Parse tip command and return tip info
+     * Supports: "tip @gustav 10", "tip 5 to gustav", etc.
+     */
+    parseTipCommand(command: string): {
+        recipient: string;
+        amount: string;
+        message?: string;
+    } | null;
+    /**
+     * Generate tip jar card/embed for display
+     */
+    formatTipJarCard(jar: TipJar): string;
+    /**
+     * Format tip notification
+     */
+    formatTipNotification(tip: Tip, jar: TipJar): string;
+    private shortAddress;
+    /**
+     * Send tip from one agent to another
+     * Returns the transaction to be executed
+     */
+    prepareAgentTip(params: {
+        fromAgentId: string;
+        fromWalletId: string;
+        toAgentId: string;
+        amount: string;
+        message?: string;
+    }): Promise<{
+        toJar: TipJar;
+        toAddress: string;
+        chain: string;
+        amount: string;
+        message?: string;
+    } | null>;
+}
+export default TipJarManager;
+//# sourceMappingURL=tips.d.ts.map

package/dist/tips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tips.d.ts","sourceRoot":"","sources":["../lib/tips.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,EAAE,CAAC;IAGJ,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;IAGF,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAGF,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IAGjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IAGrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IACJ,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,SAAW;YAKhB,QAAQ;YASR,QAAQ;YAKR,QAAQ;YASR,QAAQ;IAOtB;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAChD,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;KACxC,GAAG,OAAO,CAAC,MAAM,CAAC;IA6CnB;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASxD;;OAEG;IACG,SAAS,CACb,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,YAAY,CAAC,CAAC,GACjF,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAwBzB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgBvF;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiB7E;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,GAAG,CAAC;IAuDhB;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACrC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAmBlB;;OAEG;IACG,aAAa,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAiBvE;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,WAAW,CAAC,QAAQ,CAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAmDrG;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI;IAmCR;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAyBrC;;OAEG;IACH,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAepD,OAAO,CAAC,YAAY;IAMpB;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;CAoBV;AAED,eAAe,aAAa,CAAC"}