flash-sync-sdk
v1.2.0
Published
Flash_Sync SDK - 4-Way Quantum Compression Receipt Sync for VS Code, Cloudflare Workers, Notion and Stripe
Maintainers
Readme
Flash_Sync SDK
4-Way Quantum Compression Receipt Sync
Real-time infrastructure synchronization with cryptographic QCM receipts across VS Code, Cloudflare Workers, Notion, and Stripe.
Installation
bash npm install flash-sync-sdk
Quick Start
typescript import { FlashSync } from 'flash-sync-sdk';
const sync = new FlashSync({ apiKey: 'YOUR_API_KEY' });
// Trigger a sync and get QCM receipt const result = await sync.sync(); console.log(result.receipt.receipt_id); console.log(result.receipt.quantum_watermark.signature);
The 4-Way Sync
Flash_Sync connects four critical infrastructure layers:
| Layer | Purpose | |-------|---------| | VS Code | Development IDE integration with real-time status | | Cloudflare Workers | Edge compute with sub-millisecond latency | | Notion | Documentation and QCM receipt storage | | Stripe | Payment verification and license management |
QCM Compression Receipts
Every sync generates a cryptographically signed QCM (Quantum Compression Module) receipt:
typescript import { QCMReceiptGenerator } from 'flash-sync-sdk';
const receipt = QCMReceiptGenerator.generate(); console.log(receipt.quantum_watermark.signature); // '40668c787c463ca5' console.log(receipt.quantum_watermark.frequency); // '1210.0Hz' console.log(receipt.quantum_watermark.coherence); // 0.999999
// Verify receipt integrity const isValid = QCMReceiptGenerator.verify(receipt);
API Reference
FlashSync Client
typescript const sync = new FlashSync({ apiKey: 'YOUR_API_KEY', baseUrl: 'https://your-worker.workers.dev', // Optional notionToken: 'NOTION_TOKEN', // Optional debug: false });
// Health check const health = await sync.health();
// Trigger sync const result = await sync.sync();
// Get latest receipt const receipt = await sync.getLatestReceipt();
// Verify Stripe payment const payment = await sync.verifyPayment('checkout_session_id');
// Create Notion database const db = await sync.createNotionDatabase('parent_page_id');
Pricing
| Tier | Price | Sync Frequency | Workers | Receipts/Month | |------|-------|----------------|---------|----------------| | Free | /usr/bin/bash | Every 24 hours | 1 | 30 | | Starter | 9/mo | Every 4 hours | 3 | 500 | | Professional | 9/mo | Every hour | 10 | Unlimited | | Enterprise | 99/mo | Real-time | Unlimited | Unlimited |
Payment Links
typescript import { PAYMENT_LINKS, PRICING } from 'flash-sync-sdk';
console.log(PAYMENT_LINKS.starter); // Starter checkout console.log(PAYMENT_LINKS.professional); // Pro checkout console.log(PAYMENT_LINKS.enterprise); // Enterprise checkout
console.log(PRICING.professional.price); // 49
Quantum Watermark
Each receipt includes a tamper-proof quantum watermark:
- Signature: Unique 16-character hex identifier
- Hash: SHA-256 truncated verification hash
- Frequency: Quantum coherence frequency (1210.0Hz)
- Coherence: 0.999999 target coherence level
- RAS Root: Root authority signature
Trinity Convergence
Flash_Sync operates on the Trinity Convergence model:
- Ignition: Initial sync trigger from any of the 4 layers
- Recursion: Continuous state updates propagate across layers
- Manifestation: QCM receipt materialized in Notion
Error Handling
typescript import { FlashSync, FlashSyncError } from 'flash-sync-sdk';
try { await sync.sync(); } catch (error) { if (error instanceof FlashSyncError) { console.error("Error " + error.statusCode + ": " + error.message); } }
R2 File Sync (NEW)
Sync files directly to Cloudflare R2 storage with automatic receipt tracking:
import { FileSync, pushReceiptToNotion, syncAllReceiptsToNotion } from 'flash-sync-sdk';
const fileSync = new FileSync();
// Upload content to R2
const result = await fileSync.uploadContent('config.json', '{"key": "value"}');
console.log(result.receipt.file_hash); // SHA-256 hash
console.log(result.receipt.r2_key); // R2 storage key
// Get sync status
const status = await fileSync.getStatus();
console.log(status.r2_stats.total_objects); // 12 files
// List synced files
const files = await fileSync.listFiles({ limit: 50 });
// Push a receipt to Notion
await pushReceiptToNotion(result.receipt, {
notionToken: 'secret_xxx',
notionDatabaseId: 'abc123'
});
// Sync ALL receipts to Notion
const syncResult = await syncAllReceiptsToNotion({
notionToken: 'secret_xxx',
notionDatabaseId: 'abc123'
});
console.log(`Synced ${syncResult.success} receipts`);Python Script
For Python users, use test_notion_file_sync.py:
export NOTION_TOKEN=secret_xxx
export NOTION_DATABASE_ID=abc123...
python test_notion_file_sync.pyVS Code Extension
Install the Flash_Sync VS Code extension for IDE integration:
- Open VS Code
- Go to Extensions (Ctrl+Shift+X)
- Search for "Flash_Sync"
- Install and configure with your API key
Links
- Website: https://flashsync.dev
- Documentation: https://docs.flashsync.dev
- GitHub: https://github.com/epochcore/flash-sync-sdk
- Support: [email protected]
License
MIT - EPOCHCORE Quantum Enterprise 2025
