spidersan 0.2.2

package/dist/lib/crdt.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Spidersan CRDT State
+ *
+ * Decentralized symbol locking using Yjs CRDTs.
+ * Allows agents to claim symbols before editing, preventing conflicts.
+ *
+ * @module crdt
+ */
+import * as Y from 'yjs';
+export interface SymbolLock {
+    symbolId: string;
+    agentId: string;
+    astHash: string;
+    timestamp: number;
+    description?: string;
+}
+export interface SwarmStateOptions {
+    agentId: string;
+    onUpdate?: (update: Uint8Array) => void;
+}
+export declare class SwarmState {
+    doc: Y.Doc;
+    locks: Y.Map<SymbolLock>;
+    intents: Y.Map<string>;
+    agentId: string;
+    private onUpdate?;
+    constructor(options: SwarmStateOptions);
+    /**
+     * Try to acquire a lock on a symbol
+     * Returns true if lock acquired, false if already locked by another agent
+     */
+    acquireLock(symbolId: string, astHash: string, description?: string): boolean;
+    /**
+     * Release a lock on a symbol
+     */
+    releaseLock(symbolId: string): boolean;
+    /**
+     * Release all locks held by this agent
+     */
+    releaseAllLocks(): number;
+    /**
+     * Get lock info for a symbol
+     */
+    getLock(symbolId: string): SymbolLock | undefined;
+    /**
+     * Check if a symbol is locked by another agent
+     */
+    isLockedByOther(symbolId: string): boolean;
+    /**
+     * Get all locks held by a specific agent
+     */
+    getAgentLocks(agentId: string): SymbolLock[];
+    /**
+     * Get all active locks
+     */
+    getAllLocks(): SymbolLock[];
+    /**
+     * Set current intent for this agent
+     */
+    setIntent(intent: string): void;
+    /**
+     * Get intent for an agent
+     */
+    getIntent(agentId: string): string | undefined;
+    /**
+     * Get all agent intents
+     */
+    getAllIntents(): Map<string, string>;
+    /**
+     * Apply an update from another agent
+     */
+    applyUpdate(update: Uint8Array): void;
+    /**
+     * Get the current state as an update (for initial sync)
+     */
+    getStateAsUpdate(): Uint8Array;
+    /**
+     * Merge state from another SwarmState instance
+     */
+    mergeFrom(other: SwarmState): void;
+}
+export declare function createSwarmState(agentId: string, onUpdate?: (update: Uint8Array) => void): SwarmState;
+//# sourceMappingURL=crdt.d.ts.map

package/dist/lib/crdt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crdt.d.ts","sourceRoot":"","sources":["../../src/lib/crdt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;CAC3C;AAED,qBAAa,UAAU;IACZ,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACX,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,CAA+B;gBAEpC,OAAO,EAAE,iBAAiB;IAgBtC;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO;IA0B7E;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAStC;;OAEG;IACH,eAAe,IAAI,MAAM;IAWzB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIjD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK1C;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAU5C;;OAEG;IACH,WAAW,IAAI,UAAU,EAAE;IAM3B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C;;OAEG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAQpC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIrC;;OAEG;IACH,gBAAgB,IAAI,UAAU;IAI9B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAIrC;AAGD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,UAAU,CAErG"}

package/dist/lib/crdt.js

@@ -0,0 +1,160 @@
+/**
+ * Spidersan CRDT State
+ *
+ * Decentralized symbol locking using Yjs CRDTs.
+ * Allows agents to claim symbols before editing, preventing conflicts.
+ *
+ * @module crdt
+ */
+import * as Y from 'yjs';
+export class SwarmState {
+    doc;
+    locks;
+    intents; // agentId -> current intent
+    agentId;
+    onUpdate;
+    constructor(options) {
+        this.doc = new Y.Doc();
+        this.agentId = options.agentId;
+        this.onUpdate = options.onUpdate;
+        this.locks = this.doc.getMap('locks');
+        this.intents = this.doc.getMap('intents');
+        // Propagate updates to sync callback
+        this.doc.on('update', (update) => {
+            if (this.onUpdate) {
+                this.onUpdate(update);
+            }
+        });
+    }
+    /**
+     * Try to acquire a lock on a symbol
+     * Returns true if lock acquired, false if already locked by another agent
+     */
+    acquireLock(symbolId, astHash, description) {
+        const existingLock = this.locks.get(symbolId);
+        // Check if locked by another agent
+        if (existingLock && existingLock.agentId !== this.agentId) {
+            // Check if lock is stale (older than 30 minutes)
+            const staleThreshold = 30 * 60 * 1000;
+            if (Date.now() - existingLock.timestamp > staleThreshold) {
+                console.warn(`🕷️ Taking over stale lock on ${symbolId} from ${existingLock.agentId}`);
+            }
+            else {
+                return false; // Still locked by active agent
+            }
+        }
+        // Acquire or refresh lock
+        const lock = {
+            symbolId,
+            agentId: this.agentId,
+            astHash,
+            timestamp: Date.now(),
+            description,
+        };
+        this.locks.set(symbolId, lock);
+        return true;
+    }
+    /**
+     * Release a lock on a symbol
+     */
+    releaseLock(symbolId) {
+        const lock = this.locks.get(symbolId);
+        if (lock && lock.agentId === this.agentId) {
+            this.locks.delete(symbolId);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Release all locks held by this agent
+     */
+    releaseAllLocks() {
+        let released = 0;
+        this.locks.forEach((lock, symbolId) => {
+            if (lock.agentId === this.agentId) {
+                this.locks.delete(symbolId);
+                released++;
+            }
+        });
+        return released;
+    }
+    /**
+     * Get lock info for a symbol
+     */
+    getLock(symbolId) {
+        return this.locks.get(symbolId);
+    }
+    /**
+     * Check if a symbol is locked by another agent
+     */
+    isLockedByOther(symbolId) {
+        const lock = this.locks.get(symbolId);
+        return lock !== undefined && lock.agentId !== this.agentId;
+    }
+    /**
+     * Get all locks held by a specific agent
+     */
+    getAgentLocks(agentId) {
+        const locks = [];
+        this.locks.forEach((lock) => {
+            if (lock.agentId === agentId) {
+                locks.push(lock);
+            }
+        });
+        return locks;
+    }
+    /**
+     * Get all active locks
+     */
+    getAllLocks() {
+        const locks = [];
+        this.locks.forEach((lock) => locks.push(lock));
+        return locks;
+    }
+    /**
+     * Set current intent for this agent
+     */
+    setIntent(intent) {
+        this.intents.set(this.agentId, intent);
+    }
+    /**
+     * Get intent for an agent
+     */
+    getIntent(agentId) {
+        return this.intents.get(agentId);
+    }
+    /**
+     * Get all agent intents
+     */
+    getAllIntents() {
+        const intents = new Map();
+        this.intents.forEach((intent, agentId) => {
+            intents.set(agentId, intent);
+        });
+        return intents;
+    }
+    /**
+     * Apply an update from another agent
+     */
+    applyUpdate(update) {
+        Y.applyUpdate(this.doc, update);
+    }
+    /**
+     * Get the current state as an update (for initial sync)
+     */
+    getStateAsUpdate() {
+        return Y.encodeStateAsUpdate(this.doc);
+    }
+    /**
+     * Merge state from another SwarmState instance
+     */
+    mergeFrom(other) {
+        const update = other.getStateAsUpdate();
+        this.applyUpdate(update);
+    }
+}
+// Factory function for creating connected swarm states
+export function createSwarmState(agentId, onUpdate) {
+    return new SwarmState({ agentId, onUpdate });
+}
+//# sourceMappingURL=crdt.js.map

package/dist/lib/crdt.js.map

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

package/dist/lib/crypto.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Spider Mail Crypto Module
+ *
+ * E2E encryption for agent messaging using TweetNaCl.
+ * Uses X25519 for key exchange and XSalsa20-Poly1305 for encryption.
+ */
+export interface KeyPair {
+    publicKey: Uint8Array;
+    secretKey: Uint8Array;
+}
+export interface SerializedKeyPair {
+    publicKey: string;
+    secretKey: string;
+}
+export interface EncryptedMessage {
+    ciphertext: string;
+    nonce: string;
+    senderPublicKey: string;
+}
+/**
+ * Generate a new keypair for an agent
+ */
+export declare function generateKeyPair(): KeyPair;
+/**
+ * Save keypair to local storage
+ */
+export declare function saveKeyPair(agentId: string, keyPair: KeyPair): void;
+/**
+ * Load keypair from local storage
+ */
+export declare function loadKeyPair(agentId: string): KeyPair | null;
+/**
+ * Check if agent has a keypair
+ */
+export declare function hasKeyPair(agentId: string): boolean;
+/**
+ * Get public key as base64 string (for sharing)
+ */
+export declare function getPublicKeyBase64(agentId: string): string | null;
+/**
+ * Load known public keys registry
+ */
+export declare function loadKnownKeys(): Record<string, string>;
+/**
+ * Save a public key for another agent
+ */
+export declare function saveKnownKey(agentId: string, publicKeyBase64: string): void;
+/**
+ * Get public key for an agent (from known keys)
+ */
+export declare function getKnownKey(agentId: string): Uint8Array | null;
+/**
+ * Encrypt a message for a recipient
+ */
+export declare function encryptMessage(message: string, recipientPublicKey: Uint8Array, senderKeyPair: KeyPair): EncryptedMessage;
+/**
+ * Decrypt a message from a sender
+ */
+export declare function decryptMessage(encrypted: EncryptedMessage, recipientKeyPair: KeyPair): string | null;
+/**
+ * Encrypt multiple fields for a message
+ */
+export declare function encryptFields(fields: Record<string, unknown>, recipientPublicKey: Uint8Array, senderKeyPair: KeyPair): {
+    encrypted: EncryptedMessage;
+    fieldNames: string[];
+};
+/**
+ * Decrypt fields from a message
+ */
+export declare function decryptFields(encrypted: EncryptedMessage, recipientKeyPair: KeyPair): Record<string, unknown> | null;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/lib/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/lib/crypto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,WAAW,OAAO;IACpB,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;CAC3B;AAyBD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAOnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAa3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIjE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAK3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAK9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,OAAO,GACvB,gBAAgB,CAgBlB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,SAAS,EAAE,gBAAgB,EAC3B,gBAAgB,EAAE,OAAO,GAC1B,MAAM,GAAG,IAAI,CAkBf;AAED;;GAEG;AACH,wBAAgB,aAAa,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,kBAAkB,EAAE,UAAU,EAC9B,aAAa,EAAE,OAAO,GACvB;IAAE,SAAS,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAOvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CACzB,SAAS,EAAE,gBAAgB,EAC3B,gBAAgB,EAAE,OAAO,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQhC"}

package/dist/lib/crypto.js

@@ -0,0 +1,172 @@
+/**
+ * Spider Mail Crypto Module
+ *
+ * E2E encryption for agent messaging using TweetNaCl.
+ * Uses X25519 for key exchange and XSalsa20-Poly1305 for encryption.
+ */
+import nacl from 'tweetnacl';
+import util from 'tweetnacl-util';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+// Key storage location
+const KEYS_DIR = join(homedir(), '.spidersan', 'keys');
+/**
+ * Ensure keys directory exists
+ */
+function ensureKeysDir() {
+    if (!existsSync(KEYS_DIR)) {
+        mkdirSync(KEYS_DIR, { recursive: true });
+    }
+}
+/**
+ * Get path to agent's keypair file
+ */
+function getKeyPath(agentId) {
+    return join(KEYS_DIR, `${agentId}.key.json`);
+}
+/**
+ * Get path to known public keys registry
+ */
+function getPublicKeysPath() {
+    return join(KEYS_DIR, 'known_keys.json');
+}
+/**
+ * Generate a new keypair for an agent
+ */
+export function generateKeyPair() {
+    return nacl.box.keyPair();
+}
+/**
+ * Save keypair to local storage
+ */
+export function saveKeyPair(agentId, keyPair) {
+    ensureKeysDir();
+    const serialized = {
+        publicKey: util.encodeBase64(keyPair.publicKey),
+        secretKey: util.encodeBase64(keyPair.secretKey),
+    };
+    writeFileSync(getKeyPath(agentId), JSON.stringify(serialized, null, 2), { mode: 0o600 });
+}
+/**
+ * Load keypair from local storage
+ */
+export function loadKeyPair(agentId) {
+    const path = getKeyPath(agentId);
+    if (!existsSync(path))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(path, 'utf-8'));
+        return {
+            publicKey: util.decodeBase64(data.publicKey),
+            secretKey: util.decodeBase64(data.secretKey),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if agent has a keypair
+ */
+export function hasKeyPair(agentId) {
+    return existsSync(getKeyPath(agentId));
+}
+/**
+ * Get public key as base64 string (for sharing)
+ */
+export function getPublicKeyBase64(agentId) {
+    const keyPair = loadKeyPair(agentId);
+    if (!keyPair)
+        return null;
+    return util.encodeBase64(keyPair.publicKey);
+}
+/**
+ * Load known public keys registry
+ */
+export function loadKnownKeys() {
+    const path = getPublicKeysPath();
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Save a public key for another agent
+ */
+export function saveKnownKey(agentId, publicKeyBase64) {
+    ensureKeysDir();
+    const keys = loadKnownKeys();
+    keys[agentId] = publicKeyBase64;
+    writeFileSync(getPublicKeysPath(), JSON.stringify(keys, null, 2));
+}
+/**
+ * Get public key for an agent (from known keys)
+ */
+export function getKnownKey(agentId) {
+    const keys = loadKnownKeys();
+    const keyBase64 = keys[agentId];
+    if (!keyBase64)
+        return null;
+    return util.decodeBase64(keyBase64);
+}
+/**
+ * Encrypt a message for a recipient
+ */
+export function encryptMessage(message, recipientPublicKey, senderKeyPair) {
+    const messageBytes = util.decodeUTF8(message);
+    const nonce = nacl.randomBytes(nacl.box.nonceLength);
+    const ciphertext = nacl.box(messageBytes, nonce, recipientPublicKey, senderKeyPair.secretKey);
+    return {
+        ciphertext: util.encodeBase64(ciphertext),
+        nonce: util.encodeBase64(nonce),
+        senderPublicKey: util.encodeBase64(senderKeyPair.publicKey),
+    };
+}
+/**
+ * Decrypt a message from a sender
+ */
+export function decryptMessage(encrypted, recipientKeyPair) {
+    try {
+        const ciphertext = util.decodeBase64(encrypted.ciphertext);
+        const nonce = util.decodeBase64(encrypted.nonce);
+        const senderPublicKey = util.decodeBase64(encrypted.senderPublicKey);
+        const decrypted = nacl.box.open(ciphertext, nonce, senderPublicKey, recipientKeyPair.secretKey);
+        if (!decrypted)
+            return null;
+        return util.encodeUTF8(decrypted);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Encrypt multiple fields for a message
+ */
+export function encryptFields(fields, recipientPublicKey, senderKeyPair) {
+    const serialized = JSON.stringify(fields);
+    const encrypted = encryptMessage(serialized, recipientPublicKey, senderKeyPair);
+    return {
+        encrypted,
+        fieldNames: Object.keys(fields),
+    };
+}
+/**
+ * Decrypt fields from a message
+ */
+export function decryptFields(encrypted, recipientKeyPair) {
+    const decrypted = decryptMessage(encrypted, recipientKeyPair);
+    if (!decrypted)
+        return null;
+    try {
+        return JSON.parse(decrypted);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=crypto.js.map

package/dist/lib/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/lib/crypto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,gBAAgB,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,uBAAuB;AACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AAkBvD;;GAEG;AACH,SAAS,aAAa;IAClB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,OAAe;IAC/B,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO,WAAW,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB;IACtB,OAAO,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,OAAgB;IACzD,aAAa,EAAE,CAAC;IAChB,MAAM,UAAU,GAAsB;QAClC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC;QAC/C,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC;KAClD,CAAC;IACF,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAsB,CAAC;QAC1E,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;YAC5C,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;SAC/C,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACtC,OAAO,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAC9C,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,eAAuB;IACjE,aAAa,EAAE,CAAC;IAChB,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC;IAChC,aAAa,CAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACvC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC1B,OAAe,EACf,kBAA8B,EAC9B,aAAsB;IAEtB,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAErD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACvB,YAAY,EACZ,KAAK,EACL,kBAAkB,EAClB,aAAa,CAAC,SAAS,CAC1B,CAAC;IAEF,OAAO;QACH,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;QACzC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAC/B,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC;KAC9D,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC1B,SAA2B,EAC3B,gBAAyB;IAEzB,IAAI,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAErE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAC3B,UAAU,EACV,KAAK,EACL,eAAe,EACf,gBAAgB,CAAC,SAAS,CAC7B,CAAC;QAEF,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,MAA+B,EAC/B,kBAA8B,EAC9B,aAAsB;IAEtB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,cAAc,CAAC,UAAU,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAChF,OAAO;QACH,SAAS;QACT,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;KAClC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,SAA2B,EAC3B,gBAAyB;IAEzB,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAC9D,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Spidersan Error Classes
+ *
+ * Structured error types for consistent error handling.
+ */
+export declare class SpidersanError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class StorageError extends SpidersanError {
+    readonly operation: string;
+    constructor(message: string, operation: string);
+}
+export declare class ConfigError extends SpidersanError {
+    constructor(message: string);
+}
+export declare class GitError extends SpidersanError {
+    constructor(message: string);
+}
+export declare class LicenseError extends SpidersanError {
+    constructor(message: string);
+}
+export declare class SupabaseError extends SpidersanError {
+    readonly hint?: string | undefined;
+    constructor(message: string, hint?: string | undefined);
+}
+/**
+ * Format error for CLI output
+ */
+export declare function formatError(error: unknown): string;
+/**
+ * Handle CLI errors consistently
+ */
+export declare function handleError(error: unknown, exitCode?: number): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,cAAe,SAAQ,KAAK;aACQ,IAAI,EAAE,MAAM;gBAA7C,OAAO,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM;CAI5D;AAED,qBAAa,YAAa,SAAQ,cAAc;aACC,SAAS,EAAE,MAAM;gBAAlD,OAAO,EAAE,MAAM,EAAkB,SAAS,EAAE,MAAM;CAIjE;AAED,qBAAa,WAAY,SAAQ,cAAc;gBAC/B,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,QAAS,SAAQ,cAAc;gBAC5B,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,YAAa,SAAQ,cAAc;gBAChC,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,aAAc,SAAQ,cAAc;aACA,IAAI,CAAC,EAAE,MAAM;gBAA9C,OAAO,EAAE,MAAM,EAAkB,IAAI,CAAC,EAAE,MAAM,YAAA;CAI7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,KAAK,CAG/D"}

package/dist/lib/errors.js

@@ -0,0 +1,71 @@
+/**
+ * Spidersan Error Classes
+ *
+ * Structured error types for consistent error handling.
+ */
+export class SpidersanError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'SpidersanError';
+    }
+}
+export class StorageError extends SpidersanError {
+    operation;
+    constructor(message, operation) {
+        super(message, 'STORAGE_ERROR');
+        this.operation = operation;
+        this.name = 'StorageError';
+    }
+}
+export class ConfigError extends SpidersanError {
+    constructor(message) {
+        super(message, 'CONFIG_ERROR');
+        this.name = 'ConfigError';
+    }
+}
+export class GitError extends SpidersanError {
+    constructor(message) {
+        super(message, 'GIT_ERROR');
+        this.name = 'GitError';
+    }
+}
+export class LicenseError extends SpidersanError {
+    constructor(message) {
+        super(message, 'LICENSE_ERROR');
+        this.name = 'LicenseError';
+    }
+}
+export class SupabaseError extends SpidersanError {
+    hint;
+    constructor(message, hint) {
+        super(message, 'SUPABASE_ERROR');
+        this.hint = hint;
+        this.name = 'SupabaseError';
+    }
+}
+/**
+ * Format error for CLI output
+ */
+export function formatError(error) {
+    if (error instanceof SpidersanError) {
+        let msg = `❌ ${error.message}`;
+        if (error instanceof SupabaseError && error.hint) {
+            msg += `\n   Hint: ${error.hint}`;
+        }
+        return msg;
+    }
+    if (error instanceof Error) {
+        return `❌ ${error.message}`;
+    }
+    return `❌ Unknown error: ${String(error)}`;
+}
+/**
+ * Handle CLI errors consistently
+ */
+export function handleError(error, exitCode = 1) {
+    console.error(formatError(error));
+    process.exit(exitCode);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACQ;IAA7C,YAAY,OAAe,EAAkB,IAAY;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD0B,SAAI,GAAJ,IAAI,CAAQ;QAErD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IACjC,CAAC;CACJ;AAED,MAAM,OAAO,YAAa,SAAQ,cAAc;IACC;IAA7C,YAAY,OAAe,EAAkB,SAAiB;QAC1D,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QADS,cAAS,GAAT,SAAS,CAAQ;QAE1D,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC/B,CAAC;CACJ;AAED,MAAM,OAAO,WAAY,SAAQ,cAAc;IAC3C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;CACJ;AAED,MAAM,OAAO,QAAS,SAAQ,cAAc;IACxC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IAC3B,CAAC;CACJ;AAED,MAAM,OAAO,YAAa,SAAQ,cAAc;IAC5C,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC/B,CAAC;CACJ;AAED,MAAM,OAAO,aAAc,SAAQ,cAAc;IACA;IAA7C,YAAY,OAAe,EAAkB,IAAa;QACtD,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QADQ,SAAI,GAAJ,IAAI,CAAS;QAEtD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAChC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QAClC,IAAI,GAAG,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC/C,GAAG,IAAI,cAAc,KAAK,CAAC,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,oBAAoB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,QAAQ,GAAG,CAAC;IACpD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC"}