@magicblock-console/core 0.1.0

package/dist/oracle.js

@@ -0,0 +1,215 @@
+// ---------------------------------------------------------------------------
+// Pyth Feed IDs (hex-encoded, 32 bytes)
+// ---------------------------------------------------------------------------
+const PYTH_FEED_IDS = {
+    'SOL/USD': 'ef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d',
+    'BTC/USD': 'e62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43',
+    'ETH/USD': 'ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace',
+    'USDC/USD': 'eaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a',
+};
+/**
+ * Pyth Solana Receiver program — owns PriceUpdateV2 accounts on devnet/mainnet.
+ */
+const PYTH_RECEIVER_PROGRAM = 'rec5EKMGg6MxZYaMdyBfgwp4d5rB9T1VQH5pJv5LtFJ';
+/**
+ * PriceUpdateV2 account layout:
+ *   [0..8)    Anchor discriminator
+ *   [8..40)   write_authority (Pubkey)
+ *   [40]      verification_level (u8)
+ *   [41..73)  feed_id (32 bytes)
+ *   [73..81)  price (i64 LE)
+ *   [81..89)  confidence (u64 LE)
+ *   [89..93)  exponent (i32 LE)
+ *   [93..101) publish_time (i64 LE)
+ *   [101..109) prev_publish_time (i64 LE)
+ *   [109..117) ema_price (i64 LE)
+ *   [117..125) ema_conf (u64 LE)
+ *   [125..133) posted_slot (u64 LE)
+ *   Total: 134 bytes (with 1 byte padding)
+ */
+const PRICE_UPDATE_SIZE = 134;
+const FEED_ID_OFFSET = 41;
+// ---------------------------------------------------------------------------
+// Simulated Price Data
+// ---------------------------------------------------------------------------
+/**
+ * Simulated price feeds for common trading pairs.
+ * Used as fallback when no blockchain connection is available.
+ */
+const SIMULATED_PRICES = {
+    'SOL/USD': { price: 142.85, confidence: 0.12 },
+    'BTC/USD': { price: 67420.5, confidence: 15.3 },
+    'ETH/USD': { price: 3520.75, confidence: 2.1 },
+    'USDC/USD': { price: 1.0001, confidence: 0.0002 },
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Load a project from storage and validate that the oracle feature is enabled.
+ */
+async function requireOracleEnabled(storage, project) {
+    const data = await storage.get(`project:${project}`);
+    if (!data) {
+        throw new Error(`Project "${project}" not found`);
+    }
+    const parsed = JSON.parse(data);
+    if (!parsed.features.oracle) {
+        throw new Error(`Feature "oracle" is not enabled for project "${project}". ` +
+            `Enable it with: client.projects.configure("${project}", { features: { oracle: true } })`);
+    }
+    return parsed;
+}
+/**
+ * Apply slight randomization to a price to simulate realistic market movement.
+ * Varies the price by +/- 0.5%.
+ */
+function jitterPrice(basePrice) {
+    const factor = 1 + (Math.random() - 0.5) * 0.01; // +/- 0.5%
+    return Math.round(basePrice * factor * 100) / 100;
+}
+/**
+ * Convert a hex string to a Uint8Array.
+ */
+function hexToBytes(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < hex.length; i += 2) {
+        bytes[i / 2] = parseInt(hex.substring(i, i + 2), 16);
+    }
+    return bytes;
+}
+/**
+ * Read a signed 64-bit little-endian integer from a buffer at the given offset.
+ */
+function readInt64LE(data, offset) {
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    return view.getBigInt64(offset, true);
+}
+/**
+ * Read an unsigned 64-bit little-endian integer from a buffer at the given offset.
+ */
+function readUint64LE(data, offset) {
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    return view.getBigUint64(offset, true);
+}
+/**
+ * Read a signed 32-bit little-endian integer from a buffer at the given offset.
+ */
+function readInt32LE(data, offset) {
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    return view.getInt32(offset, true);
+}
+/**
+ * Encode a Uint8Array to base64 string (works in both Node.js and browser).
+ */
+function bytesToBase64(bytes) {
+    // Use Buffer in Node.js, btoa in browser
+    if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {
+        return Buffer.from(bytes).toString('base64');
+    }
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a fully-functional `OracleNamespace` backed by the given Storage.
+ *
+ * When a `getConnection` callback returns a valid `BlockchainConnection`,
+ * attempts to read real Pyth Lazer price data from on-chain PDAs.
+ * Falls back to simulated prices on any error or missing connection.
+ */
+export function createOracleNamespace(storage, _network, getConnection) {
+    return {
+        async getPrice(options) {
+            await requireOracleEnabled(storage, options.project);
+            const feedData = SIMULATED_PRICES[options.feed];
+            if (!feedData) {
+                const supported = Object.keys(SIMULATED_PRICES).join(', ');
+                throw new Error(`Unknown price feed: ${options.feed}. Supported feeds: ${supported}`);
+            }
+            // Attempt real on-chain Pyth price read via Pyth Solana Receiver
+            const conn = getConnection?.();
+            const feedIdHex = PYTH_FEED_IDS[options.feed];
+            if (conn && feedIdHex) {
+                try {
+                    const { PublicKey } = await import('@solana/web3.js');
+                    const receiverProgramId = new PublicKey(PYTH_RECEIVER_PROGRAM);
+                    const feedIdBytes = hexToBytes(feedIdHex);
+                    // Find a PriceUpdateV2 account matching this feed ID via memcmp filter
+                    const accounts = await conn.baseConnection.getProgramAccounts(receiverProgramId, {
+                        filters: [
+                            { dataSize: PRICE_UPDATE_SIZE },
+                            { memcmp: { offset: FEED_ID_OFFSET, bytes: bytesToBase64(feedIdBytes), encoding: 'base64' } },
+                        ],
+                        dataSlice: { offset: 73, length: 28 },
+                    });
+                    if (accounts.length > 0) {
+                        // Pick the account with the most recent publish_time
+                        let bestIdx = 0;
+                        if (accounts.length > 1) {
+                            let bestTime = readInt64LE(new Uint8Array(accounts[0].account.data), 20);
+                            for (let i = 1; i < accounts.length; i++) {
+                                const t = readInt64LE(new Uint8Array(accounts[i].account.data), 20);
+                                if (t > bestTime) {
+                                    bestTime = t;
+                                    bestIdx = i;
+                                }
+                            }
+                        }
+                        const sliceData = new Uint8Array(accounts[bestIdx].account.data);
+                        // Slice layout (relative to offset 73):
+                        //   [0..8)   price (i64 LE)
+                        //   [8..16)  confidence (u64 LE)
+                        //   [16..20) exponent (i32 LE)
+                        //   [20..28) publish_time (i64 LE)
+                        const rawPrice = readInt64LE(sliceData, 0);
+                        const rawConfidence = readUint64LE(sliceData, 8);
+                        const rawExponent = readInt32LE(sliceData, 16);
+                        const rawTimestamp = readInt64LE(sliceData, 20);
+                        // Check staleness — reject data older than 120 seconds
+                        const ageSeconds = Math.floor(Date.now() / 1000) - Number(rawTimestamp);
+                        if (ageSeconds > 120) {
+                            console.warn(`[mb-console] Pyth price data for ${options.feed} is ${ageSeconds}s old, using simulated mode`);
+                        }
+                        else {
+                            // Pyth exponents are typically negative (e.g. -8).
+                            // Use multiplication with 10^exponent which works for any sign.
+                            const scale = Math.pow(10, rawExponent);
+                            const price = Number(rawPrice) * scale;
+                            const confidence = Number(rawConfidence) * scale;
+                            const timestamp = new Date(Number(rawTimestamp) * 1000);
+                            return {
+                                feed: options.feed,
+                                price,
+                                confidence,
+                                timestamp,
+                                // getProgramAccounts doesn't expose context.slot;
+                                // approximate from wall clock (~400ms per slot)
+                                slot: Math.floor(Date.now() / 400),
+                                simulated: false,
+                            };
+                        }
+                    }
+                }
+                catch (err) {
+                    console.warn(`[mb-console] Real Pyth price read failed, using simulated mode: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            // Simulated fallback
+            return {
+                feed: options.feed,
+                price: jitterPrice(feedData.price),
+                confidence: feedData.confidence,
+                timestamp: new Date(),
+                slot: Math.floor(Date.now() / 400),
+                simulated: true,
+            };
+        },
+    };
+}
+//# sourceMappingURL=oracle.js.map

package/dist/oracle.js.map

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

package/dist/privacy.d.ts

@@ -0,0 +1,14 @@
+import type { Storage } from './storage.js';
+import type { Network } from './types.js';
+import type { PrivacyNamespace } from './client.js';
+import type { BlockchainConnection } from './connection.js';
+/**
+ * Create a fully-functional `PrivacyNamespace` backed by the given Storage.
+ *
+ * When a `getConnection` callback returns a valid `BlockchainConnection`
+ * with a signer, real TEE delegation / withdrawal / transfer operations
+ * are attempted via the MagicBlock SDK. Falls back to simulated behavior
+ * on any error or missing connection.
+ */
+export declare function createPrivacyNamespace(storage: Storage, _network: Network, getConnection?: () => BlockchainConnection | undefined): PrivacyNamespace;
+//# sourceMappingURL=privacy.d.ts.map

package/dist/privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../src/privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EACV,OAAO,EAMR,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAgD5D;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,GACrD,gBAAgB,CAoPlB"}

package/dist/privacy.js

@@ -0,0 +1,177 @@
+import { generateSignature, assertPubkey } from './utils.js';
+import { VALIDATORS } from './config.js';
+// ---------------------------------------------------------------------------
+// Known devnet SPL token mints
+// ---------------------------------------------------------------------------
+const KNOWN_MINTS = {
+    'SOL': 'So11111111111111111111111111111111111111112',
+    'USDC': '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU',
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Load a project from storage and validate that the privacy feature is enabled.
+ */
+async function requirePrivacyEnabled(storage, project) {
+    const data = await storage.get(`project:${project}`);
+    if (!data) {
+        throw new Error(`Project "${project}" not found`);
+    }
+    const parsed = JSON.parse(data);
+    if (!parsed.features.privacy) {
+        throw new Error(`Feature "privacy" is not enabled for project "${project}". ` +
+            `Enable it with: client.projects.configure("${project}", { features: { privacy: true } })`);
+    }
+    return parsed;
+}
+/**
+ * Resolve a mint address from either an explicit `mint` option or
+ * a well-known token symbol (SOL, USDC).
+ */
+function resolveMint(token, mint) {
+    if (mint)
+        return mint;
+    return KNOWN_MINTS[token.toUpperCase()];
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a fully-functional `PrivacyNamespace` backed by the given Storage.
+ *
+ * When a `getConnection` callback returns a valid `BlockchainConnection`
+ * with a signer, real TEE delegation / withdrawal / transfer operations
+ * are attempted via the MagicBlock SDK. Falls back to simulated behavior
+ * on any error or missing connection.
+ */
+export function createPrivacyNamespace(storage, _network, getConnection) {
+    return {
+        async deposit(options) {
+            await requirePrivacyEnabled(storage, options.project);
+            if (options.amount <= 0) {
+                throw new Error('Deposit amount must be greater than 0');
+            }
+            // Real blockchain: delegate SPL tokens to TEE validator
+            const conn = getConnection?.();
+            const mintAddress = resolveMint(options.token, options.mint);
+            if (conn?.signer && mintAddress) {
+                try {
+                    const { PublicKey, Transaction, SystemProgram } = await import('@solana/web3.js');
+                    const { getAssociatedTokenAddress, createAssociatedTokenAccountInstruction, createSyncNativeInstruction, NATIVE_MINT, } = await import('@solana/spl-token');
+                    const { delegatePrivateSpl } = await import('@magicblock-labs/ephemeral-rollups-sdk');
+                    const mintPk = new PublicKey(mintAddress);
+                    const teeValidator = new PublicKey(VALIDATORS[conn.network].tee);
+                    const lamports = BigInt(Math.round(options.amount * 1e9));
+                    const tx = new Transaction();
+                    // For native SOL: wrap into wSOL before delegating
+                    const isNativeSol = mintPk.equals(NATIVE_MINT);
+                    if (isNativeSol) {
+                        const wsolAta = await getAssociatedTokenAddress(NATIVE_MINT, conn.signer.publicKey);
+                        // Create wSOL ATA if it doesn't exist
+                        const ataInfo = await conn.baseConnection.getAccountInfo(wsolAta);
+                        if (!ataInfo) {
+                            tx.add(createAssociatedTokenAccountInstruction(conn.signer.publicKey, wsolAta, conn.signer.publicKey, NATIVE_MINT));
+                        }
+                        // Transfer native SOL to wSOL ATA
+                        tx.add(SystemProgram.transfer({
+                            fromPubkey: conn.signer.publicKey,
+                            toPubkey: wsolAta,
+                            lamports,
+                        }));
+                        // Sync native balance so SPL token program sees it
+                        tx.add(createSyncNativeInstruction(wsolAta));
+                    }
+                    const instructions = await delegatePrivateSpl(conn.signer.publicKey, mintPk, lamports, { validator: teeValidator, delegatePermission: true });
+                    for (const ix of instructions) {
+                        tx.add(ix);
+                    }
+                    tx.feePayer = conn.signer.publicKey;
+                    // Delegation happens on the base Solana chain, not the Magic Router
+                    tx.recentBlockhash = (await conn.baseConnection.getLatestBlockhash()).blockhash;
+                    const signed = await conn.signer.signTransaction(tx);
+                    const signature = await conn.baseConnection.sendRawTransaction(signed.serialize());
+                    return { signature, simulated: false };
+                }
+                catch (err) {
+                    console.warn(`[mb-console] Real privacy deposit failed, using simulated mode: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            return { signature: generateSignature(), simulated: true };
+        },
+        async transfer(options) {
+            await requirePrivacyEnabled(storage, options.project);
+            if (options.amount <= 0) {
+                throw new Error('Transfer amount must be greater than 0');
+            }
+            if (!options.to) {
+                throw new Error('Transfer recipient address is required');
+            }
+            assertPubkey(options.to, 'recipient');
+            // Real blockchain: SPL transfer via TEE ER connection
+            const conn = getConnection?.();
+            const mintAddress = resolveMint(options.token, options.mint);
+            if (conn?.signer && mintAddress) {
+                try {
+                    const { PublicKey, Transaction } = await import('@solana/web3.js');
+                    const { createAssociatedTokenAccountInstruction, createTransferInstruction, getAssociatedTokenAddress, } = await import('@solana/spl-token');
+                    const mintPk = new PublicKey(mintAddress);
+                    const recipientPk = new PublicKey(options.to);
+                    const lamports = BigInt(Math.round(options.amount * 1e9));
+                    // Get/create associated token accounts
+                    const senderAta = await getAssociatedTokenAddress(mintPk, conn.signer.publicKey);
+                    const recipientAta = await getAssociatedTokenAddress(mintPk, recipientPk);
+                    const tx = new Transaction();
+                    // Create recipient ATA if needed
+                    const recipientAtaInfo = await conn.routerConnection.getAccountInfo(recipientAta);
+                    if (!recipientAtaInfo) {
+                        tx.add(createAssociatedTokenAccountInstruction(conn.signer.publicKey, recipientAta, recipientPk, mintPk));
+                    }
+                    tx.add(createTransferInstruction(senderAta, recipientAta, conn.signer.publicKey, lamports));
+                    tx.feePayer = conn.signer.publicKey;
+                    tx.recentBlockhash = (await conn.baseConnection.getLatestBlockhash()).blockhash;
+                    const signed = await conn.signer.signTransaction(tx);
+                    const signature = await conn.baseConnection.sendRawTransaction(signed.serialize());
+                    return { signature, simulated: false };
+                }
+                catch (err) {
+                    console.warn(`[mb-console] Real privacy transfer failed, using simulated mode: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            return { signature: generateSignature(), simulated: true };
+        },
+        async withdraw(options) {
+            await requirePrivacyEnabled(storage, options.project);
+            if (options.amount <= 0) {
+                throw new Error('Withdraw amount must be greater than 0');
+            }
+            // Real blockchain: withdraw SPL + undelegate from TEE
+            const conn = getConnection?.();
+            const mintAddress = resolveMint(options.token, options.mint);
+            if (conn?.signer && mintAddress) {
+                try {
+                    const { PublicKey, Transaction } = await import('@solana/web3.js');
+                    const { withdrawSplIx, undelegateIx } = await import('@magicblock-labs/ephemeral-rollups-sdk');
+                    const mintPk = new PublicKey(mintAddress);
+                    const lamports = BigInt(Math.round(options.amount * 1e9));
+                    const withdrawInstruction = withdrawSplIx(conn.signer.publicKey, mintPk, lamports);
+                    const undelegateInstruction = undelegateIx(conn.signer.publicKey, mintPk);
+                    const tx = new Transaction()
+                        .add(withdrawInstruction)
+                        .add(undelegateInstruction);
+                    tx.feePayer = conn.signer.publicKey;
+                    // Undelegation returns to the base Solana chain
+                    tx.recentBlockhash = (await conn.baseConnection.getLatestBlockhash()).blockhash;
+                    const signed = await conn.signer.signTransaction(tx);
+                    const signature = await conn.baseConnection.sendRawTransaction(signed.serialize());
+                    return { signature, simulated: false };
+                }
+                catch (err) {
+                    console.warn(`[mb-console] Real privacy withdraw failed, using simulated mode: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            return { signature: generateSignature(), simulated: true };
+        },
+    };
+}
+//# sourceMappingURL=privacy.js.map

package/dist/privacy.js.map

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

package/dist/projects.d.ts

@@ -0,0 +1,9 @@
+import type { Storage } from './storage.js';
+import type { ProjectsNamespace } from './client.js';
+/**
+ * Create a fully-functional `ProjectsNamespace` backed by the given Storage.
+ *
+ * Each project is persisted as a JSON string under the key `project:<name>`.
+ */
+export declare function createProjectsNamespace(storage: Storage): ProjectsNamespace;
+//# sourceMappingURL=projects.d.ts.map

package/dist/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA0CrD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAqE3E"}

package/dist/projects.js

@@ -0,0 +1,94 @@
+import { DEFAULT_FEATURES } from './config.js';
+// ---------------------------------------------------------------------------
+// Key helpers
+// ---------------------------------------------------------------------------
+const PROJECT_PREFIX = 'project:';
+function projectKey(name) {
+    return `${PROJECT_PREFIX}${name}`;
+}
+// ---------------------------------------------------------------------------
+// Serialization (handles Date fields)
+// ---------------------------------------------------------------------------
+function serialize(project) {
+    return JSON.stringify(project);
+}
+function deserialize(json) {
+    const raw = JSON.parse(json);
+    return { ...raw, createdAt: new Date(raw.createdAt) };
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+// Valid project name: alphanumeric, hyphens, underscores, 1-64 characters
+const PROJECT_NAME_RE = /^[a-zA-Z0-9_-]{1,64}$/;
+function validateProjectName(name) {
+    if (!PROJECT_NAME_RE.test(name)) {
+        throw new Error(`Invalid project name "${name}". ` +
+            'Use 1-64 characters: letters, numbers, hyphens, underscores.');
+    }
+}
+/**
+ * Create a fully-functional `ProjectsNamespace` backed by the given Storage.
+ *
+ * Each project is persisted as a JSON string under the key `project:<name>`.
+ */
+export function createProjectsNamespace(storage) {
+    return {
+        async create(options) {
+            validateProjectName(options.name);
+            const existing = await storage.get(projectKey(options.name));
+            if (existing) {
+                throw new Error(`Project "${options.name}" already exists`);
+            }
+            const project = {
+                name: options.name,
+                region: options.region ?? 'us',
+                features: { ...DEFAULT_FEATURES, ...options.features },
+                createdAt: new Date(),
+            };
+            await storage.set(projectKey(options.name), serialize(project));
+            return project;
+        },
+        async get(name) {
+            const data = await storage.get(projectKey(name));
+            if (!data) {
+                throw new Error(`Project "${name}" not found`);
+            }
+            return deserialize(data);
+        },
+        async list() {
+            const keys = await storage.list(PROJECT_PREFIX);
+            const projects = [];
+            for (const key of keys) {
+                const data = await storage.get(key);
+                if (data) {
+                    projects.push(deserialize(data));
+                }
+            }
+            return projects.sort((a, b) => a.name.localeCompare(b.name));
+        },
+        async configure(name, options) {
+            const data = await storage.get(projectKey(name));
+            if (!data) {
+                throw new Error(`Project "${name}" not found`);
+            }
+            const project = deserialize(data);
+            if (options.features) {
+                project.features = { ...project.features, ...options.features };
+            }
+            if (options.region) {
+                project.region = options.region;
+            }
+            await storage.set(projectKey(name), serialize(project));
+            return project;
+        },
+        async delete(name) {
+            const data = await storage.get(projectKey(name));
+            if (!data) {
+                throw new Error(`Project "${name}" not found`);
+            }
+            await storage.delete(projectKey(name));
+        },
+    };
+}
+//# sourceMappingURL=projects.js.map

package/dist/projects.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,37 @@
+/** Key-value storage abstraction for persisting project data. */
+export interface Storage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+}
+export declare class MemoryStorage implements Storage {
+    private readonly data;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+}
+export declare class FileStorage implements Storage {
+    private readonly baseDir;
+    constructor(baseDir?: string);
+    private fs;
+    private path;
+    /** Encode a key to a safe filename. */
+    private encodeKey;
+    private decodeKey;
+    private filePath;
+    private ensureDir;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+}
+export declare class BrowserStorage implements Storage {
+    private getLocalStorage;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix: string): Promise<string[]>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAIA,iEAAiE;AACjE,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC;AAMD,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAE5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAG9C;AAMD,qBAAa,WAAY,YAAW,OAAO;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,CAAC,EAAE,MAAM;YAYd,EAAE;YAIF,IAAI;IAIlB,uCAAuC;IACvC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,SAAS;YAIH,QAAQ;YAUR,SAAS;IAKjB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAa9C;AAQD,qBAAa,cAAe,YAAW,OAAO;IAC5C,OAAO,CAAC,eAAe;IAOjB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAa9C"}