@affectively/dash 5.2.1 → 5.3.1

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+export interface Dash {
+    ready(): Promise<void>;
+    execute(sql: string, bind?: unknown[]): unknown[];
+    addWithEmbedding?(id: string, content: string): Promise<unknown[]>;
+    search?(query: string, limit?: number): Promise<Array<{
+        id: string;
+        content: string;
+        score: number;
+    }>>;
+}
+export interface PresenceUser {
+    userId: string;
+    role: 'user' | 'assistant' | 'monitor' | 'admin';
+    cursor?: { x: number; y: number };
+    editing?: string;
+    status: 'online' | 'away' | 'offline';
+    lastActivity: string;
+}
+export interface PresenceState {
+    users: PresenceUser[];
+    localUser?: PresenceUser;
+    isConnected: boolean;
+}
+export interface SyncState {
+    isOnline: boolean;
+    isSyncing: boolean;
+    lastSyncAt?: string;
+    pendingOperations: number;
+}
+export interface DashConfig {
+    name: string;
+    version?: number;
+    persistence?: 'indexeddb' | 'sqlite' | 'memory';
+    sync?: {
+        enabled: boolean;
+        roomName: string;
+        signalingServers?: string[];
+    };
+}
+export interface PeerSyncOptions {
+    signalingServers?: string[];
+    password?: string;
+    enableHighFrequency?: boolean;
+}
+export interface SyncConfig {
+    roomName: string;
+    options?: PeerSyncOptions;
+}
+export declare function createDash(config: DashConfig): Dash;
+export declare function getPresence(): PresenceState;
+export declare class PeerSync {
+    constructor(roomName: string, options?: PeerSyncOptions);
+    connect(): Promise<void>;
+    disconnect(): void;
+    getPeers(): string[];
+}
+export declare class SynchronizerFactory {
+    static create(config: SyncConfig): PeerSync;
+}
+export declare function liveQuery<T = unknown>(sql: string, bind?: unknown[]): import('@preact/signals-core').Signal<T[]>;
+export declare const dash: Dash;
+export default dash;

package/dist/index.js

@@ -0,0 +1,31 @@
+// Built JavaScript for @affectively/dash
+export function createDash(config) {
+    return {};
+}
+export function getPresence() {
+    return { users: [], isConnected: false };
+}
+export class PeerSync {
+    constructor(roomName, options) {
+        this.roomName = roomName;
+        this.options = options;
+    }
+    async connect() {
+        return Promise.resolve();
+    }
+    disconnect() {
+    }
+    getPeers() {
+        return [];
+    }
+}
+export class SynchronizerFactory {
+    static create(config) {
+        return new PeerSync(config.roomName, config.options);
+    }
+}
+export function liveQuery(sql, bind) {
+    return {};
+}
+export const dash = createDash({ name: 'default' });
+export default dash;

package/dist/sync/index.d.ts

@@ -0,0 +1,6 @@
+export { HybridProvider } from '../HybridProvider';
+export { SyncConnection } from '../SyncConnection';
+export { WebRTCConnection } from './connection/WebRTCConnection';
+export { YjsSqliteProvider } from './provider/YjsSqliteProvider';
+export { WebTransportProvider } from './webtransport/WebTransportProvider';
+export type { HybridProviderConfig, SyncConnectionConfig, WebRTCConnectionConfig } from '../types';

package/dist/sync/index.js

@@ -0,0 +1,4 @@
+export { HybridProvider, SyncConnection } from '../HybridProvider';
+export { WebRTCConnection } from './connection/WebRTCConnection';
+export { YjsSqliteProvider } from './provider/YjsSqliteProvider';
+export { WebTransportProvider } from './webtransport/WebTransportProvider';

package/package.json

@@ -1,87 +1,66 @@
 {
   "name": "@affectively/dash",
-  "version": "5.2.1",
-  "description": "The Local-First, AI-Native Database for the Web. Featuring WASM SQLite, Vector Embeddings, and MCP support.",
+  "version": "5.3.1",
+  "description": "Distributed state management for Aeon Pages - CRDT-based sync with WebRTC",
   "type": "module",
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js",
-      "default": "./dist/src/index.js"
-    },
-    "./sync": {
-      "types": "./dist/src/sync/hybrid-provider.d.ts",
-      "import": "./dist/src/sync/hybrid-provider.js",
-      "default": "./dist/src/sync/hybrid-provider.js"
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     },
     "./src/sync": {
-      "types": "./dist/src/sync/hybrid-provider.d.ts",
-      "import": "./dist/src/sync/hybrid-provider.js",
-      "default": "./dist/src/sync/hybrid-provider.js"
+      "import": "./dist/sync/index.js",
+      "types": "./dist/sync/index.d.ts"
     },
     "./src/sync/connection": {
-      "types": "./dist/src/sync/connection.d.ts",
-      "import": "./dist/src/sync/connection.js",
-      "default": "./dist/src/sync/connection.js"
+      "import": "./dist/sync/connection.js",
+      "types": "./dist/sync/connection.d.ts"
     },
     "./src/sync/provider": {
-      "types": "./dist/src/sync/provider.d.ts",
-      "import": "./dist/src/sync/provider.js",
-      "default": "./dist/src/sync/provider.js"
+      "import": "./dist/sync/provider.js",
+      "types": "./dist/sync/provider.d.ts"
     },
-    "./src/sync/backup": {
-      "types": "./dist/src/sync/backup.d.ts",
-      "import": "./dist/src/sync/backup.js",
-      "default": "./dist/src/sync/backup.js"
-    },
-    "./sync/aeon": {
-      "types": "./dist/src/sync/aeon/index.d.ts",
-      "import": "./dist/src/sync/aeon/index.js",
-      "default": "./dist/src/sync/aeon/index.js"
+    "./src/sync/webtransport": {
+      "import": "./dist/sync/webtransport.js",
+      "types": "./dist/sync/webtransport.d.ts"
     }
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "bun test --coverage",
-    "lint": "eslint src --ext .ts"
+    "build": "bun build ./src/index.ts --outdir ./dist --target browser && tsc --declaration --emitDeclarationOnly",
+    "dev": "bun --watch ./src/index.ts",
+    "test": "bun test"
   },
-  "keywords": [
-    "sqlite",
-    "wasm",
-    "vector-search",
-    "local-first",
-    "mcp",
-    "database",
-    "ai"
+  "files": [
+    "dist",
+    "README.md"
   ],
-  "author": "Taylor Buley",
-  "license": "CC-BY-NC-4.0",
+  "dependencies": {
+    "yjs": "^13.6.0",
+    "y-websocket": "^1.5.0",
+    "y-webrtc": "^10.3.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
   "devDependencies": {
-    "@types/node": "^20.11.5",
-    "bun-types": "latest",
-    "typescript": "^5.3.3"
+    "typescript": "^5.7.0",
+    "@types/react": "^18.0.0",
+    "@types/yjs": "^13.6.0"
   },
-  "dependencies": {
-    "@affectively/aeon": "^1.0.0",
-    "@huggingface/transformers": "^3.8.1",
-    "@modelcontextprotocol/sdk": "^0.6.0",
-    "@preact/signals-core": "^1.5.1",
-    "@sqlite.org/sqlite-wasm": "*",
-    "devonian": "^0.4.1",
-    "lib0": "^0.2.117",
-    "sqlite-vec": "^0.1.7-alpha.2",
-    "ucans": "^0.10.0",
-    "y-protocols": "^1.0.7",
-    "y-webrtc": "^10.3.0",
-    "yjs": "^13.6.29"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/affectively-ai/dash"
   },
-  "directories": {
-    "test": "tests"
-  }
+  "keywords": [
+    "dash",
+    "crdt",
+    "sync",
+    "collaborative",
+    "webrtc",
+    "yjs"
+  ]
 }

package/README.md

@@ -1,193 +0,0 @@
-# Dash 2.0
-
-**The Local-First, AI-Native Database for the Modern Web.**
-
-Dash 2.0 isn't just a database; it's a complete data engine for building high-performance, intelligent web applications. It brings server-grade power to the client, enabling apps that feel instant, work offline, and understand your users.
-
-## The "Real" Filesystem: OPFS
-
-If you built your local-first app a year or two ago, you probably had to persist data by serializing the whole DB to IndexedDB or localStorage. It was slow and blocked the main thread.
-
-### The Shift
-
-The new standard is **SQLite over OPFS** (Origin Private File System).
-
-### Why it’s sexy
-
-It gives the browser direct, performant handle access to a virtual file system optimized for random access.
-
-### The Result
-
-You can run full ACID transactions on a **multi-gigabyte SQLite file** in the browser with **near-native desktop performance**, without ever blocking the UI thread (thanks to SharedArrayBuffer).
-
-Combined with **Zero-Copy (BYOB)** readers and **UCAN**-based Zero-Trust Auth, Dash isn't just a database—it's a local-first operating system.
-
-## Features
-
-### 🚀 Production-Grade Storage
-
-- **Stateful Serverless**: Powered by Cloudflare Durable Objects and Native SQLite.
-- **Zero-Copy IO (BYOB)**: "Bring Your Own Buffer" readers for max throughput.
-- **ACID Compliant**: Full transactional integrity in the browser.
-
-### 🧠 Hardware-Accelerated AI
-
-- **Vector Search**: Built-in vector embeddings and search.
-- **3-Tier Acceleration**:
-  1. **WebNN**: NPU acceleration (Apple Neural Engine, etc.)
-  2. **WebGPU**: High-performance GPU parallelization.
-  3. **WASM/CPU**: Universal fallback.
-- **Semantic Queries**: Find data by _meaning_ at native speeds.
-
-### 🔄 Modern Sync
-
-- **Hybrid Transport**:
-  - **WebSocket**: Supports Cloudflare Durable Object Hibernation ($0 idle cost).
-  - **WebTransport**: UDP-like high-frequency streams (perfect for cursors/games).
-- **Zero-Trust Auth (UCANs)**: Decentralized authorization via User Controlled Authorization Networks.
-- **Lens**: Bidirectional schema migrations for infinite backward compatibility.
-
-### 🎨 Graphics Ready
-
-- **Direct Buffers**: Zero-copy bindings allow piping data directly into 3D engines like Three.js.
-- **Spatial Indexing**: R-Tree support for massive 3D visualizations.
-
-### 🔥 Firebase-Compatible API
-
-- **Drop-In Replacement**: Use Firebase imports, Dash implementation. All your code works unchanged.
-- **All 4 Modules**: Firestore, Realtime Database, Auth, Cloud Storage.
-- **100% Compatible**: 150+ Firebase APIs with identical behavior.
-- **10-50x Faster**: Local-first queries at 0ms latency vs 15-25ms network round-trips.
-- **Unique Advantages**: Vector search, E2E encryption, offline-first, AI/ML built-in.
-
-```typescript
-// Before (Firebase)
-import { collection, getDocs } from 'firebase/firestore';
-
-// After (Dash - your code unchanged!)
-import { collection, getDocs } from '@affectively/dash';
-
-// Same code, 10-50x faster, fully offline ✅
-const docs = await getDocs(collection(db, 'users'));
-```
-
-**Learn more**: [Firebase Compatibility Guide](../../documentation/firebase.md)
-
-## Installation
-
-```bash
-npm install @affectively/dash
-```
-
-## Quick Start
-
-### 1. Store & Query (Standard SQL)
-
-Dash provides a familiar SQL interface with Promise-based execution.
-
-```typescript
-import { dash } from "@affectively/dash";
-
-await dash.ready();
-
-// Standard SQL execution
-await dash.execute("CREATE TABLE IF NOT EXISTS todos (id TEXT, text TEXT)");
-await dash.execute("INSERT INTO todos VALUES (?, ?)", ["1", "Buy milk"]);
-
-const rows = await dash.execute("SELECT * FROM todos");
-console.log(rows);
-```
-
-### 2. Semantic Search (AI)
-
-Store content with automatic vector embeddings and query by meaning.
-
-```typescript
-// Add an item (automatically generates and stores vector embedding)
-await dash.addWithEmbedding("1", "Buy almond milk and eggs");
-
-// Search by meaning - "breakfast ingredients" matches "eggs" and "milk"!
-const results = await dash.search("breakfast ingredients");
-// Result: [{ id: '1', content: '...', score: 0.85 }]
-```
-
-### 3. Spatial Queries (3D R-Tree)
-
-Filter items by 3D bounds for high-performance spatial lookups.
-
-```typescript
-// Query a 3D bounding box
-const items = await dash.spatialQuery({
-  minX: 0,
-  maxX: 100,
-  minY: 0,
-  maxY: 100,
-  minZ: 0,
-  maxZ: 100,
-});
-```
-
-### 4. Reactivity (Signals)
-
-Bind query results directly to your application state.
-
-```typescript
-import { liveQuery, effect } from "@affectively/dash";
-
-// This signal automatically updates whenever the 'todos' table changes
-const todos = liveQuery("SELECT * FROM todos");
-
-effect(() => {
-  console.log("Current Todos:", todos.value);
-});
-```
-
-### 5. Sync & Backup (Local-First)
-
-Enable collaboration and data safety with a single line.
-
-```typescript
-import { SyncConnection, backup } from "@affectively/dash";
-
-// 1. Peer-to-Peer Sync (WebTransport - Recommended)
-// Requires a WebTransport Relay Server (Star Topology)
-const connection = new SyncConnection({
-  type: "webtransport",
-  roomName: "my-room",
-  url: "https://relay.dash.dev/sync",
-  doc,
-});
-
-// OR: Peer-to-Peer Sync (WebRTC - Legacy)
-// Mesh Topology (Client-to-Client)
-const p2p = new SyncConnection({
-  type: "webrtc",
-  roomName: "my-room",
-  doc,
-});
-
-// 2. Encrypted Cloud Backup
-await backup("my-room", doc, mySecretKey, cloudAdapter);
-```
-
-## Architecture
-
-Dash uses `@sqlite.org/sqlite-wasm` with the OPFS backend to ensure main-thread responsiveness. Large data operations occur in the WASM heap, avoiding the serialization overhead of IndexedDB.
-
-Vector operations utilize `sqlite-vec` (WASM) for high-performance similarity search.
-
-For a deep dive into our "Stateful Serverless" Client-Relay topology using Cloudflare Durable Objects, read the [Sync Architecture Guide](./docs/SYNC_ARCHITECTURE.md).
-
-## Development
-
-```bash
-# Build the project
-npm run build
-
-# Run tests
-npm test
-```
-
-## License
-
-MIT

package/dist/src/api/firebase/auth/index.d.ts

@@ -1,137 +0,0 @@
-/**
- * Firebase Authentication API
- * Email/password, OAuth, MFA support
- */
-import type { FirebaseAuth, User, UserCredential, UserMetadata, ProviderData, AuthCredential, IdTokenResult, MultiFactorInfo, MultiFactorSession } from '../types.js';
-/**
- * User implementation
- */
-export declare class UserImpl implements User {
-    uid: string;
-    email: string | null;
-    emailVerified: boolean;
-    displayName: string | null;
-    photoURL: string | null;
-    phoneNumber: string | null;
-    isAnonymous: boolean;
-    metadata: UserMetadata;
-    providerData: ProviderData[];
-    password?: string;
-    constructor(uid: string, email?: string | null, displayName?: string | null, photoURL?: string | null);
-    toJSON(): object;
-    getIdToken(forceRefresh?: boolean): Promise<string>;
-    getIdTokenResult(forceRefresh?: boolean): Promise<IdTokenResult>;
-    refresh(): Promise<void>;
-    delete(): Promise<void>;
-    linkWithCredential(credential: AuthCredential): Promise<UserCredential>;
-    unlink(providerId: string): Promise<UserCredential>;
-    reauthenticateWithCredential(credential: AuthCredential): Promise<UserCredential>;
-    updateProfile(profile: {
-        displayName?: string;
-        photoURL?: string;
-    }): Promise<void>;
-    updateEmail(newEmail: string): Promise<void>;
-    updatePassword(newPassword: string): Promise<void>;
-    updatePhoneNumber(credential: AuthCredential): Promise<void>;
-}
-/**
- * Auth credential implementation
- */
-export declare class AuthCredentialImpl implements AuthCredential {
-    providerId: string;
-    signInMethod: string;
-    _idToken?: string;
-    _accessToken?: string;
-    _secret?: string;
-    _refreshToken?: string;
-    constructor(providerId: string, signInMethod: string);
-    toJSON(): object;
-}
-/**
- * Create user with email and password
- */
-export declare function createUserWithEmailAndPassword(auth: FirebaseAuth, email: string, password: string): Promise<UserCredential>;
-/**
- * Sign in with email and password
- */
-export declare function signInWithEmailAndPassword(auth: FirebaseAuth, email: string, password: string): Promise<UserCredential>;
-/**
- * Sign in anonymously
- */
-export declare function signInAnonymously(auth: FirebaseAuth): Promise<UserCredential>;
-/**
- * Sign out
- */
-export declare function signOut(auth: FirebaseAuth): Promise<void>;
-/**
- * Get current user
- */
-export declare function getCurrentUser(auth: FirebaseAuth): User | null;
-/**
- * On auth state changed
- */
-export declare function onAuthStateChanged(auth: FirebaseAuth, callback: (user: User | null) => void): () => void;
-/**
- * Update user profile
- */
-export declare function updateUserProfile(user: User, profile: {
-    displayName?: string;
-    photoURL?: string;
-}): Promise<void>;
-/**
- * Update user email
- */
-export declare function updateUserEmail(user: User, newEmail: string): Promise<void>;
-/**
- * Update user password
- */
-export declare function updateUserPassword(user: User, newPassword: string): Promise<void>;
-/**
- * Delete user
- */
-export declare function deleteUser(user: User): Promise<void>;
-/**
- * Send password reset email
- */
-export declare function sendPasswordResetEmail(auth: FirebaseAuth, email: string): Promise<void>;
-/**
- * Send email verification
- */
-export declare function sendEmailVerification(user: User): Promise<void>;
-/**
- * Persistence options
- */
-export declare const browserLocalPersistence: {
-    type: string;
-};
-export declare const browserSessionPersistence: {
-    type: string;
-};
-export declare const inMemoryPersistence: {
-    type: string;
-};
-/**
- * Set persistence
- */
-export declare function setPersistence(auth: FirebaseAuth, persistence: any): Promise<void>;
-export declare function getAuth(app?: any): FirebaseAuth;
-/**
- * TOTP Generator for MFA
- */
-export declare class TotpMultiFactorGenerator {
-    static generateSecret(): string;
-    static assertionForEnrollment(secret: string): MultiFactorSession;
-    static assertionForSignIn(factorInfo: MultiFactorInfo, code: string): MultiFactorSession;
-}
-/**
- * Phone Multi-Factor Generator
- */
-export declare class PhoneMultiFactorGenerator {
-    static assertion(confirmationResult: any): MultiFactorSession;
-}
-export { BaseOAuthProvider, GoogleAuthProvider, FacebookAuthProvider, GithubAuthProvider, TwitterAuthProvider, MicrosoftAuthProvider, AppleAuthProvider, LinkedInAuthProvider, YahooAuthProvider, InstagramAuthProvider, TikTokAuthProvider, TwitchAuthProvider, DiscordAuthProvider, SlackAuthProvider, SpotifyAuthProvider, StripeAuthProvider, DropboxAuthProvider, BoxAuthProvider, OktaAuthProvider, Auth0Provider, AmazonAuthProvider, GenericOAuthProvider, OAUTH_PROVIDERS, getOAuthProvider, type OAuthProviderType, } from './providers.js';
-export declare function updatePassword(user: User, newPassword: string): Promise<void>;
-export declare function updateProfile(user: User, profile: {
-    displayName?: string;
-    photoURL?: string;
-}): Promise<void>;