chunktech 0.1.0

package/dist/chunker.js

@@ -0,0 +1,220 @@
+/**
+ * ChunkTech - File Chunking
+ * Split files into chunks for on-chain storage
+ */
+import { MAX_CHUNK_SIZE, CHUNK_PREFIX, CHUNK_ENCRYPTED_PREFIX } from './types.js';
+// ============================================================================
+// Chunking
+// ============================================================================
+/**
+ * Generate a random chunk set ID
+ */
+export function generateChunkId() {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+/**
+ * Split data into chunks
+ */
+export function chunkData(data, chunkId) {
+    const id = chunkId || generateChunkId();
+    const totalChunks = Math.ceil(data.length / MAX_CHUNK_SIZE);
+    const chunks = [];
+    for (let i = 0; i < totalChunks; i++) {
+        const start = i * MAX_CHUNK_SIZE;
+        const end = Math.min(start + MAX_CHUNK_SIZE, data.length);
+        const chunkData = data.slice(start, end);
+        chunks.push({
+            id,
+            part: i + 1,
+            total: totalChunks,
+            data: chunkData,
+        });
+    }
+    return { id, total: totalChunks, chunks };
+}
+/**
+ * Encode chunk to calldata string
+ */
+export function encodeChunk(chunk, encrypted = false) {
+    const prefix = encrypted ? CHUNK_ENCRYPTED_PREFIX : CHUNK_PREFIX;
+    const metadata = {
+        id: chunk.id,
+        part: chunk.part,
+        total: chunk.total,
+    };
+    // Format: prefix + base64(JSON({metadata, data: base64(data)}))
+    const payload = {
+        ...metadata,
+        data: uint8ArrayToBase64(chunk.data),
+    };
+    return prefix + btoa(JSON.stringify(payload));
+}
+/**
+ * Decode calldata string to chunk
+ */
+export function decodeChunk(calldata) {
+    const isEncrypted = calldata.startsWith(CHUNK_ENCRYPTED_PREFIX);
+    const isPlain = calldata.startsWith(CHUNK_PREFIX);
+    if (!isEncrypted && !isPlain) {
+        return null;
+    }
+    try {
+        const prefix = isEncrypted ? CHUNK_ENCRYPTED_PREFIX : CHUNK_PREFIX;
+        const base64 = calldata.slice(prefix.length);
+        const payload = JSON.parse(atob(base64));
+        return {
+            id: payload.id,
+            part: payload.part,
+            total: payload.total,
+            data: base64ToUint8Array(payload.data),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if calldata is a chunk
+ */
+export function isChunk(calldata) {
+    return (calldata.startsWith(CHUNK_PREFIX) ||
+        calldata.startsWith(CHUNK_ENCRYPTED_PREFIX));
+}
+/**
+ * Check if calldata is an encrypted chunk
+ */
+export function isEncryptedChunk(calldata) {
+    return calldata.startsWith(CHUNK_ENCRYPTED_PREFIX);
+}
+// ============================================================================
+// Reassembly
+// ============================================================================
+/**
+ * Reassemble chunks back into original data
+ */
+export function reassembleChunks(chunks) {
+    if (chunks.length === 0)
+        return null;
+    // Verify all chunks have same ID
+    const id = chunks[0].id;
+    if (!chunks.every((c) => c.id === id)) {
+        throw new Error('Chunks have mismatched IDs');
+    }
+    // Verify we have all parts
+    const total = chunks[0].total;
+    if (chunks.length !== total) {
+        return null; // Incomplete
+    }
+    // Sort by part number
+    const sorted = [...chunks].sort((a, b) => a.part - b.part);
+    // Verify sequential parts
+    for (let i = 0; i < sorted.length; i++) {
+        if (sorted[i].part !== i + 1) {
+            throw new Error(`Missing chunk part ${i + 1}`);
+        }
+    }
+    // Calculate total size
+    const totalSize = sorted.reduce((sum, c) => sum + c.data.length, 0);
+    // Concatenate data
+    const result = new Uint8Array(totalSize);
+    let offset = 0;
+    for (const chunk of sorted) {
+        result.set(chunk.data, offset);
+        offset += chunk.data.length;
+    }
+    return result;
+}
+// ============================================================================
+// Chunk Tracker (streaming reassembly)
+// ============================================================================
+export class ChunkTracker {
+    chunks = new Map();
+    /**
+     * Add a chunk, returns assembled data if complete
+     */
+    add(chunk) {
+        const existing = this.chunks.get(chunk.id) || [];
+        // Avoid duplicates
+        if (existing.some((c) => c.part === chunk.part)) {
+            return null;
+        }
+        existing.push(chunk);
+        this.chunks.set(chunk.id, existing);
+        // Check if complete
+        if (existing.length === chunk.total) {
+            const result = reassembleChunks(existing);
+            if (result !== null) {
+                this.chunks.delete(chunk.id); // Clean up
+                return result;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get incomplete chunk sets
+     */
+    getIncomplete() {
+        const result = [];
+        for (const [id, chunks] of this.chunks) {
+            result.push({
+                id,
+                have: chunks.length,
+                need: chunks[0].total,
+            });
+        }
+        return result;
+    }
+    /**
+     * Get chunks for a specific ID
+     */
+    getChunks(id) {
+        return this.chunks.get(id) || [];
+    }
+    /**
+     * Clear all tracked chunks
+     */
+    clear() {
+        this.chunks.clear();
+    }
+}
+// ============================================================================
+// Estimation
+// ============================================================================
+/**
+ * Estimate number of chunks needed for data
+ */
+export function estimateChunks(dataSize) {
+    return Math.ceil(dataSize / MAX_CHUNK_SIZE);
+}
+/**
+ * Estimate total calldata size (rough approximation)
+ */
+export function estimateCalldataSize(dataSize) {
+    const numChunks = estimateChunks(dataSize);
+    // Base64 expansion ~1.37x + ~100 bytes metadata per chunk
+    const perChunkOverhead = 100;
+    return Math.ceil(dataSize * 1.37 + numChunks * perChunkOverhead);
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+function uint8ArrayToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+function base64ToUint8Array(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+//# sourceMappingURL=chunker.js.map

package/dist/chunker.js.map

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

package/dist/crypto.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ChunkTech - Optional Encryption (X3DH + AES-256-GCM)
+ *
+ * Uses Web Crypto API for browser compatibility.
+ * Requires @noble/curves and @noble/hashes as optional dependencies.
+ */
+import type { KeyPair, KeyBundle, EncryptionKeys, Recipient, EncryptedPayload } from './types.js';
+export declare function toHex(bytes: Uint8Array): string;
+export declare function fromHex(hex: string): Uint8Array;
+export declare function bundleToHex(bundle: KeyBundle): {
+    identityKey: string;
+    signedPreKey: string;
+};
+export declare function bundleFromHex(hex: {
+    identityKey: string;
+    signedPreKey: string;
+}): KeyBundle;
+/**
+ * Generate a new X25519 key pair
+ */
+export declare function generateKeyPair(): Promise<KeyPair>;
+/**
+ * Generate full encryption keys (identity + signedPreKey)
+ */
+export declare function generateEncryptionKeys(): Promise<EncryptionKeys>;
+/**
+ * Derive encryption keys from a wallet signature
+ */
+export declare function deriveKeysFromSignature(signature: string): Promise<EncryptionKeys>;
+/**
+ * Encrypt data for multiple recipients
+ */
+export declare function encryptForRecipients(senderKeys: EncryptionKeys, recipients: Recipient[], plaintext: Uint8Array): Promise<EncryptedPayload>;
+/**
+ * Decrypt data for a specific recipient
+ */
+export declare function decryptForRecipient(recipientId: string, recipientKeys: EncryptionKeys, encrypted: EncryptedPayload): Promise<Uint8Array>;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EACT,cAAc,EACd,SAAS,EACT,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAiCpB,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI/C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAM/C;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAK5F;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAK3F;AAMD;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAQxD;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,cAAc,CAAC,CAYtE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA+BxF;AAwHD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,SAAS,EAAE,EACvB,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAsC3B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,cAAc,EAC7B,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAkCrB"}

package/dist/crypto.js

@@ -0,0 +1,242 @@
+/**
+ * ChunkTech - Optional Encryption (X3DH + AES-256-GCM)
+ *
+ * Uses Web Crypto API for browser compatibility.
+ * Requires @noble/curves and @noble/hashes as optional dependencies.
+ */
+// ============================================================================
+// Dynamic Imports (optional dependencies)
+// ============================================================================
+let x25519;
+let hkdf;
+let sha256;
+async function loadCryptoDeps() {
+    if (x25519)
+        return; // Already loaded
+    try {
+        const curves = await import('@noble/curves/ed25519');
+        const hashes = await import('@noble/hashes/hkdf');
+        const sha = await import('@noble/hashes/sha256');
+        x25519 = curves.x25519;
+        hkdf = hashes.hkdf;
+        sha256 = sha.sha256;
+    }
+    catch {
+        throw new Error('Encryption requires @noble/curves and @noble/hashes. ' +
+            'Install them with: npm install @noble/curves @noble/hashes');
+    }
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+export function toHex(bytes) {
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+export function fromHex(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < hex.length; i += 2) {
+        bytes[i / 2] = parseInt(hex.substr(i, 2), 16);
+    }
+    return bytes;
+}
+export function bundleToHex(bundle) {
+    return {
+        identityKey: toHex(bundle.identityKey),
+        signedPreKey: toHex(bundle.signedPreKey),
+    };
+}
+export function bundleFromHex(hex) {
+    return {
+        identityKey: fromHex(hex.identityKey),
+        signedPreKey: fromHex(hex.signedPreKey),
+    };
+}
+// ============================================================================
+// Key Generation
+// ============================================================================
+/**
+ * Generate a new X25519 key pair
+ */
+export async function generateKeyPair() {
+    await loadCryptoDeps();
+    const privateKey = new Uint8Array(32);
+    crypto.getRandomValues(privateKey);
+    const publicKey = x25519.getPublicKey(privateKey);
+    return { privateKey, publicKey };
+}
+/**
+ * Generate full encryption keys (identity + signedPreKey)
+ */
+export async function generateEncryptionKeys() {
+    const identity = await generateKeyPair();
+    const signedPreKey = await generateKeyPair();
+    return {
+        identity,
+        signedPreKey,
+        bundle: {
+            identityKey: identity.publicKey,
+            signedPreKey: signedPreKey.publicKey,
+        },
+    };
+}
+/**
+ * Derive encryption keys from a wallet signature
+ */
+export async function deriveKeysFromSignature(signature) {
+    await loadCryptoDeps();
+    const sigBytes = new TextEncoder().encode(signature);
+    const seed = sha256(sigBytes);
+    const identitySalt = new TextEncoder().encode('chunk-identity');
+    const signedPreKeySalt = new TextEncoder().encode('chunk-signed-prekey');
+    const info = new TextEncoder().encode('chunktech-v1');
+    const identityPrivate = hkdf(sha256, seed, identitySalt, info, 32);
+    const signedPreKeyPrivate = hkdf(sha256, seed, signedPreKeySalt, info, 32);
+    const identity = {
+        privateKey: identityPrivate,
+        publicKey: x25519.getPublicKey(identityPrivate),
+    };
+    const signedPreKey = {
+        privateKey: signedPreKeyPrivate,
+        publicKey: x25519.getPublicKey(signedPreKeyPrivate),
+    };
+    return {
+        identity,
+        signedPreKey,
+        bundle: {
+            identityKey: identity.publicKey,
+            signedPreKey: signedPreKey.publicKey,
+        },
+    };
+}
+// ============================================================================
+// Crypto Primitives (Web Crypto API)
+// ============================================================================
+function dh(privateKey, publicKey) {
+    return x25519.getSharedSecret(privateKey, publicKey);
+}
+function deriveKey(ikm, salt, info, length = 32) {
+    const saltBytes = typeof salt === 'string' ? new TextEncoder().encode(salt) : salt;
+    const infoBytes = new TextEncoder().encode(info);
+    return hkdf(sha256, ikm, saltBytes, infoBytes, length);
+}
+async function encrypt(key, plaintext) {
+    const iv = new Uint8Array(12);
+    crypto.getRandomValues(iv);
+    const cryptoKey = await crypto.subtle.importKey('raw', key, { name: 'AES-GCM' }, false, ['encrypt']);
+    const encrypted = await crypto.subtle.encrypt({ name: 'AES-GCM', iv, tagLength: 128 }, cryptoKey, plaintext);
+    // Web Crypto appends auth tag to ciphertext
+    const encryptedBytes = new Uint8Array(encrypted);
+    const ciphertext = encryptedBytes.slice(0, -16);
+    const authTag = encryptedBytes.slice(-16);
+    return { iv, ciphertext, authTag };
+}
+async function decrypt(key, iv, ciphertext, authTag) {
+    const cryptoKey = await crypto.subtle.importKey('raw', key, { name: 'AES-GCM' }, false, ['decrypt']);
+    // Web Crypto expects auth tag appended to ciphertext
+    const combined = new Uint8Array(ciphertext.length + authTag.length);
+    combined.set(ciphertext, 0);
+    combined.set(authTag, ciphertext.length);
+    const decrypted = await crypto.subtle.decrypt({ name: 'AES-GCM', iv, tagLength: 128 }, cryptoKey, combined);
+    return new Uint8Array(decrypted);
+}
+// ============================================================================
+// X3DH Key Exchange
+// ============================================================================
+function x3dhSender(senderIdentity, recipientBundle) {
+    const ephemeralPrivate = new Uint8Array(32);
+    crypto.getRandomValues(ephemeralPrivate);
+    const ephemeralPublic = x25519.getPublicKey(ephemeralPrivate);
+    const dh1 = dh(senderIdentity.privateKey, recipientBundle.signedPreKey);
+    const dh2 = dh(ephemeralPrivate, recipientBundle.identityKey);
+    const dh3 = dh(ephemeralPrivate, recipientBundle.signedPreKey);
+    const dhConcat = new Uint8Array(96);
+    dhConcat.set(dh1, 0);
+    dhConcat.set(dh2, 32);
+    dhConcat.set(dh3, 64);
+    const sharedSecret = deriveKey(dhConcat, new Uint8Array(32), 'ChunkTechProtocol', 32);
+    return { sharedSecret, ephemeralPublicKey: ephemeralPublic };
+}
+function x3dhRecipient(recipientIdentity, recipientSignedPreKey, senderIdentityKey, ephemeralKey) {
+    const dh1 = dh(recipientSignedPreKey.privateKey, senderIdentityKey);
+    const dh2 = dh(recipientIdentity.privateKey, ephemeralKey);
+    const dh3 = dh(recipientSignedPreKey.privateKey, ephemeralKey);
+    const dhConcat = new Uint8Array(96);
+    dhConcat.set(dh1, 0);
+    dhConcat.set(dh2, 32);
+    dhConcat.set(dh3, 64);
+    return deriveKey(dhConcat, new Uint8Array(32), 'ChunkTechProtocol', 32);
+}
+// ============================================================================
+// Multi-Recipient Encryption
+// ============================================================================
+/**
+ * Encrypt data for multiple recipients
+ */
+export async function encryptForRecipients(senderKeys, recipients, plaintext) {
+    await loadCryptoDeps();
+    const symmetricKey = new Uint8Array(32);
+    crypto.getRandomValues(symmetricKey);
+    const { iv, ciphertext, authTag } = await encrypt(symmetricKey, plaintext);
+    // Always include sender so they can decrypt their own data
+    const allRecipients = [
+        { id: 'sender', bundle: senderKeys.bundle },
+        ...recipients,
+    ];
+    const keys = [];
+    for (const r of allRecipients) {
+        const { sharedSecret, ephemeralPublicKey } = x3dhSender(senderKeys.identity, r.bundle);
+        const wrapped = await encrypt(sharedSecret, symmetricKey);
+        keys.push({
+            recipientId: r.id,
+            recipientIdentityKey: toHex(r.bundle.identityKey),
+            ephemeralKey: toHex(ephemeralPublicKey),
+            wrappedKey: toHex(wrapped.ciphertext),
+            iv: toHex(wrapped.iv),
+            authTag: toHex(wrapped.authTag),
+        });
+    }
+    return {
+        version: 1,
+        senderIdentityKey: toHex(senderKeys.identity.publicKey),
+        iv: toHex(iv),
+        ciphertext: uint8ArrayToBase64(ciphertext),
+        authTag: toHex(authTag),
+        keys,
+    };
+}
+/**
+ * Decrypt data for a specific recipient
+ */
+export async function decryptForRecipient(recipientId, recipientKeys, encrypted) {
+    await loadCryptoDeps();
+    // Find key entry by ID or identity key match
+    const keyEntry = encrypted.keys.find((k) => k.recipientId === recipientId ||
+        k.recipientIdentityKey === toHex(recipientKeys.identity.publicKey));
+    if (!keyEntry) {
+        throw new Error(`No key found for recipient: ${recipientId}`);
+    }
+    const sharedSecret = x3dhRecipient(recipientKeys.identity, recipientKeys.signedPreKey, fromHex(encrypted.senderIdentityKey), fromHex(keyEntry.ephemeralKey));
+    const symmetricKey = await decrypt(sharedSecret, fromHex(keyEntry.iv), fromHex(keyEntry.wrappedKey), fromHex(keyEntry.authTag));
+    return decrypt(symmetricKey, fromHex(encrypted.iv), base64ToUint8Array(encrypted.ciphertext), fromHex(encrypted.authTag));
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+function uint8ArrayToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+function base64ToUint8Array(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * ChunkTech - On-chain file storage via chunked transactions
+ *
+ * Store and retrieve files on EVM chains (Ethereum, Base, Arbitrum)
+ * using transaction calldata.
+ */
+import type { PublicClient, Hash, Chain } from 'viem';
+import type { ChunkTechConfig, UploadOptions, UploadResult, DownloadOptions, DownloadResult } from './types.js';
+import { TransactionMonitor } from './tracker.js';
+import { StreamingAssembler } from './assembler.js';
+export declare class ChunkTech {
+    private walletClient;
+    private publicClient;
+    private chain;
+    constructor(config: ChunkTechConfig);
+    private detectChain;
+    /**
+     * Upload data to chain
+     */
+    upload(data: Uint8Array | ArrayBuffer | string, options?: UploadOptions): Promise<UploadResult>;
+    /**
+     * Download data from chain
+     */
+    download(txHashes: Hash[], options?: DownloadOptions): Promise<DownloadResult>;
+    /**
+     * Get a streaming assembler for progressive downloads
+     */
+    getStreamingAssembler(options?: DownloadOptions): StreamingAssembler;
+    /**
+     * Get a transaction monitor for tracking uploads
+     */
+    getTransactionMonitor(options?: {
+        pollInterval?: number;
+        confirmations?: number;
+    }): TransactionMonitor;
+    /**
+     * Estimate chunks needed for data
+     */
+    estimateChunks(dataSize: number): number;
+    /**
+     * Get the current chain
+     */
+    getChain(): Chain;
+    /**
+     * Get the public client
+     */
+    getPublicClient(): PublicClient;
+}
+export { ChunkTech as default };
+export type { ChunkTechConfig, UploadOptions, UploadResult, DownloadOptions, DownloadResult, TxStatus, EncryptionKeys, Recipient, Chunk, ChunkedData, ChunkMetadata, } from './types.js';
+export { chunkData, encodeChunk, decodeChunk, reassembleChunks, isChunk, isEncryptedChunk, generateChunkId, estimateChunks, estimateCalldataSize, ChunkTracker, } from './chunker.js';
+export { sendChunk, sendChunks, sendChunksParallel } from './sender.js';
+export type { SendResult, SendOptions } from './sender.js';
+export { waitForTransaction, waitForTransactions, checkTransactionStatus, TransactionMonitor, } from './tracker.js';
+export type { TrackerOptions } from './types.js';
+export { fetchTransaction, fetchChunk, fetchChunks, fetchChunksParallel, assembleFromHashes, StreamingAssembler, } from './assembler.js';
+export type { FetchResult } from './assembler.js';
+export { generateKeyPair, generateEncryptionKeys, deriveKeysFromSignature, encryptForRecipients, decryptForRecipient, toHex, fromHex, bundleToHex, bundleFromHex, } from './crypto.js';
+export { MAX_CHUNK_SIZE, CHUNK_PREFIX, CHUNK_ENCRYPTED_PREFIX, SUPPORTED_CHAINS } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAgB,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAGpE,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EAIf,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAuB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAsB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAoBxE,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,KAAK,CAAQ;gBAET,MAAM,EAAE,eAAe;IAYnC,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACG,MAAM,CACV,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EACvC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC;IA6CxB;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,IAAI,EAAE,EAChB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC;IA6B1B;;OAEG;IACH,qBAAqB,CAAC,OAAO,GAAE,eAAoB,GAAG,kBAAkB;IAIxE;;OAEG;IACH,qBAAqB,CAAC,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,kBAAkB;IAI1G;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACH,QAAQ,IAAI,KAAK;IAIjB;;OAEG;IACH,eAAe,IAAI,YAAY;CAGhC;AAOD,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,CAAC;AAGhC,YAAY,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,QAAQ,EACR,cAAc,EACd,SAAS,EACT,KAAK,EACL,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,EACL,OAAO,EACP,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}