bindra 2.0.0

package/dist/examples.js

@@ -0,0 +1,242 @@
+/**
+ * Bindra TypeScript Usage Examples
+ *
+ * This file demonstrates how to use Bindra with TypeScript for type-safe
+ * reactive data management.
+ */
+import { DataSource, createSignal, reactive } from './index';
+// Create a typed DataSource
+const usersDS = new DataSource({
+    data: [
+        { id: 1, name: 'Alice', email: 'alice@example.com', age: 25, isActive: true },
+        { id: 2, name: 'Bob', email: 'bob@example.com', age: 30, isActive: true },
+        { id: 3, name: 'Charlie', email: 'charlie@example.com', age: 35, isActive: false }
+    ]
+});
+// Subscribe to changes with type safety
+usersDS.currentRecord.subscribe((user) => {
+    if (user) {
+        console.log(`Current user: ${user.name} (${user.email})`);
+        // TypeScript knows all properties of user
+        console.log(`Age: ${user.age}`);
+    }
+});
+// Navigate through records
+usersDS.next();
+usersDS.prev();
+usersDS.goto(0);
+// ============================================================================
+// Example 2: CRUD Operations with Type Safety
+// ============================================================================
+async function crudExample() {
+    // Create - TypeScript enforces the User interface
+    const newUser = await usersDS.create({
+        id: 4,
+        name: 'David',
+        email: 'david@example.com',
+        age: 28
+    });
+    console.log('Created:', newUser);
+    // Update - Partial<User> allows partial updates
+    const updated = await usersDS.update(1, {
+        age: 26,
+        isActive: false
+    });
+    console.log('Updated:', updated);
+    // Query with type-safe filter
+    const activeUsers = await usersDS.query({
+        filter: (user) => user.isActive === true,
+        sort: 'age',
+        limit: 10
+    });
+    console.log('Active users:', activeUsers);
+    // Delete
+    const deleted = await usersDS.delete(4);
+    console.log('Deleted:', deleted);
+}
+// ============================================================================
+// Example 3: Event Handling with Types
+// ============================================================================
+// Type-safe event handlers
+usersDS.on('created', (user) => {
+    console.log('New user created:', user.name);
+});
+usersDS.on('updated', (user) => {
+    console.log('User updated:', user.name);
+});
+usersDS.on('deleted', (user) => {
+    console.log('User deleted:', user.name);
+});
+usersDS.on('dataChanged', (data) => {
+    console.log('Data changed, total users:', data?.length ?? 0);
+});
+// ============================================================================
+// Example 4: Middleware with Type Safety
+// ============================================================================
+// Type-safe before middleware
+usersDS.middleware.useBefore('create', async ({ record }) => {
+    const user = record;
+    // Validation
+    if (!user.name || user.name.length < 2) {
+        throw new Error('Name must be at least 2 characters');
+    }
+    if (!user.email || !user.email.includes('@')) {
+        throw new Error('Invalid email address');
+    }
+    if (user.age && (user.age < 0 || user.age > 150)) {
+        throw new Error('Age must be between 0 and 150');
+    }
+    console.log('Validation passed for:', user.name);
+});
+// Type-safe after middleware
+usersDS.middleware.useAfter('create', async ({ record }) => {
+    const user = record;
+    console.log(`Welcome email sent to ${user.email}`);
+    // Could trigger analytics, logging, etc.
+});
+// ============================================================================
+// Example 5: Signals and Reactive State
+// ============================================================================
+// Create typed signals
+const counter = createSignal(0);
+const message = createSignal('Hello');
+// Subscribe with type safety
+counter.subscribe((value) => {
+    console.log('Counter:', value);
+});
+message.subscribe((value) => {
+    console.log('Message:', value);
+});
+// Update signals
+counter.set(10);
+message.set('Hello, TypeScript!');
+const appState = reactive({
+    theme: 'light',
+    user: {
+        name: 'Alice',
+        preferences: {
+            notifications: true,
+            language: 'en'
+        }
+    },
+    items: ['item1', 'item2']
+}, (prop, newValue, oldValue) => {
+    console.log(`State changed: ${String(prop)}`);
+    console.log(`  Old: ${JSON.stringify(oldValue)}`);
+    console.log(`  New: ${JSON.stringify(newValue)}`);
+});
+// Deep reactivity - all changes are tracked
+appState.theme = 'dark';
+appState.user.name = 'Bob';
+appState.user.preferences.notifications = false;
+appState.items.push('item3');
+const productsConfig = {
+    url: 'https://api.example.com/products'
+};
+const productsDS = new DataSource(productsConfig);
+// Remote operations work the same way
+async function remoteExample() {
+    // Fetch from remote API
+    const products = await productsDS.query({
+        filter: { category: 'electronics', inStock: true },
+        sort: 'price',
+        limit: 20
+    });
+    console.log('Products:', products);
+    // Create on remote
+    const newProduct = await productsDS.create({
+        name: 'New Laptop',
+        price: 999,
+        category: 'electronics',
+        inStock: true
+    });
+    console.log('Created product:', newProduct);
+}
+// ============================================================================
+// Example 8: Advanced Pattern - Form Binding
+// ============================================================================
+class UserForm {
+    constructor(dataSource) {
+        this.unsubscribers = [];
+        this.ds = dataSource;
+        this.bindToCurrentRecord();
+    }
+    bindToCurrentRecord() {
+        // Subscribe to current record changes
+        const unsub = this.ds.currentRecord.subscribe((user) => {
+            if (user) {
+                this.populateForm(user);
+            }
+        });
+        this.unsubscribers.push(unsub);
+    }
+    populateForm(user) {
+        // Update form fields
+        console.log('Populating form with:', user);
+        // In real app: update DOM elements
+    }
+    async save(formData) {
+        const currentUser = this.ds.currentRecord.get();
+        if (currentUser) {
+            await this.ds.update(currentUser.id, formData);
+        }
+        else {
+            await this.ds.create(formData);
+        }
+    }
+    cleanup() {
+        this.unsubscribers.forEach(unsub => unsub());
+    }
+}
+// Usage
+// @ts-ignore - Unused variable for documentation purposes
+const userForm = new UserForm(usersDS);
+const tasksDS = new DataSource({
+    data: [
+        { id: 1, title: 'Task 1', completed: false, priority: 'high', dueDate: new Date() },
+        { id: 2, title: 'Task 2', completed: true, priority: 'low', dueDate: new Date() }
+    ]
+});
+// Create computed values
+const taskStats = {
+    total: createSignal(0),
+    completed: createSignal(0),
+    pending: createSignal(0),
+    highPriority: createSignal(0)
+};
+// Update stats when data changes
+tasksDS.on('dataChanged', (tasks) => {
+    if (!tasks)
+        return;
+    taskStats.total.set(tasks.length);
+    taskStats.completed.set(tasks.filter(t => t.completed).length);
+    taskStats.pending.set(tasks.filter(t => !t.completed).length);
+    taskStats.highPriority.set(tasks.filter(t => t.priority === 'high').length);
+});
+// Subscribe to computed values
+taskStats.pending.subscribe((count) => {
+    console.log(`Pending tasks: ${count}`);
+});
+// ============================================================================
+// Example 10: Type Guards and Validation
+// ============================================================================
+function isValidUser(obj) {
+    return (typeof obj === 'object' &&
+        typeof obj.id === 'number' &&
+        typeof obj.name === 'string' &&
+        typeof obj.email === 'string' &&
+        typeof obj.age === 'number');
+}
+// Use type guard in middleware
+usersDS.middleware.useBefore('create', async ({ record }) => {
+    if (!isValidUser(record)) {
+        throw new Error('Invalid user object');
+    }
+    // TypeScript now knows record is User
+    console.log(`Validating user: ${record.name}`);
+});
+// ============================================================================
+// Export examples for use in other modules
+// ============================================================================
+export { usersDS, productsDS, tasksDS, crudExample, remoteExample, UserForm, isValidUser, taskStats };
+//# sourceMappingURL=examples.js.map

package/dist/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../src/examples.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAe7D,4BAA4B;AAC5B,MAAM,OAAO,GAAG,IAAI,UAAU,CAAO;IACnC,IAAI,EAAE;QACJ,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7E,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;KACnF;CACF,CAAC,CAAC;AAEH,wCAAwC;AACxC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAiB,EAAE,EAAE;IACpD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QAC1D,0CAA0C;QAC1C,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAClC,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,2BAA2B;AAC3B,OAAO,CAAC,IAAI,EAAE,CAAC;AACf,OAAO,CAAC,IAAI,EAAE,CAAC;AACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhB,+EAA+E;AAC/E,8CAA8C;AAC9C,+EAA+E;AAE/E,KAAK,UAAU,WAAW;IACxB,kDAAkD;IAClD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;QACnC,EAAE,EAAE,CAAC;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,mBAAmB;QAC1B,GAAG,EAAE,EAAE;KACR,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEjC,gDAAgD;IAChD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE;QACtC,GAAG,EAAE,EAAE;QACP,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEjC,8BAA8B;IAC9B,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC;QACtC,MAAM,EAAE,CAAC,IAAU,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI;QAC9C,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,EAAE;KACV,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAE1C,SAAS;IACT,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E;AAE/E,2BAA2B;AAC3B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAU,EAAE,EAAE;IACnC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAU,EAAE,EAAE;IACnC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAU,EAAE,EAAE;IACnC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAmB,EAAE,EAAE;IAChD,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E,8BAA8B;AAC9B,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IAC1D,MAAM,IAAI,GAAG,MAAuB,CAAC;IAErC,aAAa;IACb,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,6BAA6B;AAC7B,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACzD,MAAM,IAAI,GAAG,MAAc,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACnD,yCAAyC;AAC3C,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E,uBAAuB;AACvB,MAAM,OAAO,GAAmB,YAAY,CAAC,CAAC,CAAC,CAAC;AAChD,MAAM,OAAO,GAAmB,YAAY,CAAC,OAAO,CAAC,CAAC;AAEtD,6BAA6B;AAC7B,OAAO,CAAC,SAAS,CAAC,CAAC,KAAa,EAAE,EAAE;IAClC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,SAAS,CAAC,CAAC,KAAa,EAAE,EAAE;IAClC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,iBAAiB;AACjB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAkBlC,MAAM,QAAQ,GAAG,QAAQ,CACvB;IACE,KAAK,EAAE,OAAO;IACd,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,WAAW,EAAE;YACX,aAAa,EAAE,IAAI;YACnB,QAAQ,EAAE,IAAI;SACf;KACF;IACD,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B,EACD,CAAC,IAAqB,EAAE,QAAa,EAAE,QAAa,EAAE,EAAE;IACtD,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACpD,CAAC,CACF,CAAC;AAEF,4CAA4C;AAC5C,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC;AACxB,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;AAC3B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,GAAG,KAAK,CAAC;AAChD,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAc7B,MAAM,cAAc,GAAqB;IACvC,GAAG,EAAE,kCAAkC;CACxC,CAAC;AAEF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAU,cAAc,CAAC,CAAC;AAE3D,sCAAsC;AACtC,KAAK,UAAU,aAAa;IAC1B,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC;QACtC,MAAM,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE;QAClD,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE;KACV,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAEnC,mBAAmB;IACnB,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC;QACzC,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,IAAI;KACM,CAAC,CAAC;IAEvB,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,+EAA+E;AAC/E,6CAA6C;AAC7C,+EAA+E;AAE/E,MAAM,QAAQ;IAIZ,YAAY,UAA4B;QAFhC,kBAAa,GAAsB,EAAE,CAAC;QAG5C,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC;QACrB,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAEO,mBAAmB;QACzB,sCAAsC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAiB,EAAE,EAAE;YAClE,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAEO,YAAY,CAAC,IAAU;QAC7B,qBAAqB;QACrB,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;QAC3C,mCAAmC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAuB;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC;QAChD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,QAAQ;AACR,0DAA0D;AAC1D,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;AAcvC,MAAM,OAAO,GAAG,IAAI,UAAU,CAAO;IACnC,IAAI,EAAE;QACJ,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE;QACnF,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE;KAClF;CACF,CAAC,CAAC;AAEH,yBAAyB;AACzB,MAAM,SAAS,GAAG;IAChB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;IACtB,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;CAC9B,CAAC;AAEF,iCAAiC;AACjC,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,KAAoB,EAAE,EAAE;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/D,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9D,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,+BAA+B;AAC/B,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAa,EAAE,EAAE;IAC5C,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E,SAAS,WAAW,CAAC,GAAQ;IAC3B,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;QAC1B,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAC7B,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,CAC5B,CAAC;AACJ,CAAC;AAED,+BAA+B;AAC/B,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IAC1D,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E,OAAO,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,SAAS,EACV,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { DataSource } from './core/DataSource';
+export { EventEmitter } from './core/EventEmitter';
+export { MiddlewareManager } from './core/MiddlewareManager';
+export { createSignal, reactive } from './core/Observable';
+export { Container, container, dataSource, getDataSource } from './core/Container';
+export { subscribe, unsubscribe, dispatch } from './core/Dispatcher';
+export { Validator } from './core/validation';
+export { BindraError, NetworkError, ValidationError, PermissionError, ConfigurationError, isBindraError, isNetworkError, isValidationError } from './core/errors';
+export type { DataSourceConfig, Field, Permissions, QueryOptions, RetryConfig, CacheConfig, PaginationConfig, RealtimeConfig, SecurityConfig } from './core/DataSource';
+export type { FieldConfig, FieldValidation } from './core/validation';
+export type { Signal } from './core/Observable';
+export { debounce, throttle, debounceWithMaxWait } from './utils/performance';
+//# 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":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,gBAAgB,EAChB,KAAK,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,WAAW,EACX,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// Main entry point for Bindra library
+export { DataSource } from './core/DataSource';
+export { EventEmitter } from './core/EventEmitter';
+export { MiddlewareManager } from './core/MiddlewareManager';
+export { createSignal, reactive } from './core/Observable';
+export { Container, container, dataSource, getDataSource } from './core/Container';
+export { subscribe, unsubscribe, dispatch } from './core/Dispatcher';
+// Export validation
+export { Validator } from './core/validation';
+// Export error classes
+export { BindraError, NetworkError, ValidationError, PermissionError, ConfigurationError, isBindraError, isNetworkError, isValidationError } from './core/errors';
+// Export performance utilities
+export { debounce, throttle, debounceWithMaxWait } from './utils/performance';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAErE,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAsBvB,+BAA+B;AAC/B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/utils/performance.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Creates a debounced version of a function that delays invoking until after
+ * a specified delay has elapsed since the last time it was invoked
+ *
+ * @param fn - The function to debounce
+ * @param delay - The delay in milliseconds
+ * @returns Debounced function
+ *
+ * @example
+ * ```typescript
+ * const search = debounce((query: string) => {
+ *   console.log('Searching for:', query);
+ * }, 300);
+ *
+ * search('a');  // Won't execute
+ * search('ab'); // Won't execute
+ * search('abc'); // Executes after 300ms
+ * ```
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Creates a throttled version of a function that only invokes at most once
+ * per every specified milliseconds
+ *
+ * @param fn - The function to throttle
+ * @param limit - The minimum time between invocations in milliseconds
+ * @returns Throttled function
+ *
+ * @example
+ * ```typescript
+ * const handleScroll = throttle(() => {
+ *   console.log('Scroll event');
+ * }, 100);
+ *
+ * window.addEventListener('scroll', handleScroll);
+ * ```
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Creates a function that delays invoking until after a specified delay,
+ * but also ensures it's called at least once every maxWait milliseconds
+ *
+ * @param fn - The function to debounce with max wait
+ * @param delay - The delay in milliseconds
+ * @param maxWait - Maximum time to wait before forcing invocation
+ * @returns Debounced function with max wait
+ */
+export declare function debounceWithMaxWait<T extends (...args: any[]) => any>(fn: T, delay: number, maxWait: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=performance.d.ts.map

package/dist/utils/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/utils/performance.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAOlC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACnE,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAkClC"}

package/dist/utils/performance.js

@@ -0,0 +1,94 @@
+// Performance utilities: debounce and throttle functions
+/**
+ * Creates a debounced version of a function that delays invoking until after
+ * a specified delay has elapsed since the last time it was invoked
+ *
+ * @param fn - The function to debounce
+ * @param delay - The delay in milliseconds
+ * @returns Debounced function
+ *
+ * @example
+ * ```typescript
+ * const search = debounce((query: string) => {
+ *   console.log('Searching for:', query);
+ * }, 300);
+ *
+ * search('a');  // Won't execute
+ * search('ab'); // Won't execute
+ * search('abc'); // Executes after 300ms
+ * ```
+ */
+export function debounce(fn, delay) {
+    let timeoutId;
+    return function (...args) {
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => fn.apply(this, args), delay);
+    };
+}
+/**
+ * Creates a throttled version of a function that only invokes at most once
+ * per every specified milliseconds
+ *
+ * @param fn - The function to throttle
+ * @param limit - The minimum time between invocations in milliseconds
+ * @returns Throttled function
+ *
+ * @example
+ * ```typescript
+ * const handleScroll = throttle(() => {
+ *   console.log('Scroll event');
+ * }, 100);
+ *
+ * window.addEventListener('scroll', handleScroll);
+ * ```
+ */
+export function throttle(fn, limit) {
+    let inThrottle;
+    return function (...args) {
+        if (!inThrottle) {
+            fn.apply(this, args);
+            inThrottle = true;
+            setTimeout(() => (inThrottle = false), limit);
+        }
+    };
+}
+/**
+ * Creates a function that delays invoking until after a specified delay,
+ * but also ensures it's called at least once every maxWait milliseconds
+ *
+ * @param fn - The function to debounce with max wait
+ * @param delay - The delay in milliseconds
+ * @param maxWait - Maximum time to wait before forcing invocation
+ * @returns Debounced function with max wait
+ */
+export function debounceWithMaxWait(fn, delay, maxWait) {
+    let timeoutId;
+    let maxWaitTimeoutId;
+    let lastArgs = null;
+    let lastThis = null;
+    const invokeFunc = () => {
+        if (lastArgs !== null && lastThis !== null) {
+            fn.apply(lastThis, lastArgs);
+            lastArgs = null;
+            lastThis = null;
+        }
+    };
+    return function (...args) {
+        lastArgs = args;
+        lastThis = this;
+        clearTimeout(timeoutId);
+        if (!maxWaitTimeoutId) {
+            maxWaitTimeoutId = setTimeout(() => {
+                invokeFunc();
+                clearTimeout(timeoutId);
+                maxWaitTimeoutId = undefined;
+            }, maxWait);
+        }
+        timeoutId = setTimeout(() => {
+            invokeFunc();
+            clearTimeout(maxWaitTimeoutId);
+            maxWaitTimeoutId = undefined;
+        }, delay);
+    };
+}
+//# sourceMappingURL=performance.js.map

package/dist/utils/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../src/utils/performance.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,KAAa;IAEb,IAAI,SAAwC,CAAC;IAE7C,OAAO,UAAqB,GAAG,IAAmB;QAChD,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CACtB,EAAK,EACL,KAAa;IAEb,IAAI,UAAmB,CAAC;IAExB,OAAO,UAAqB,GAAG,IAAmB;QAChD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrB,UAAU,GAAG,IAAI,CAAC;YAClB,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,EAAK,EACL,KAAa,EACb,OAAe;IAEf,IAAI,SAAwC,CAAC;IAC7C,IAAI,gBAA+C,CAAC;IACpD,IAAI,QAAQ,GAAyB,IAAI,CAAC;IAC1C,IAAI,QAAQ,GAAQ,IAAI,CAAC;IAEzB,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3C,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC7B,QAAQ,GAAG,IAAI,CAAC;YAChB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,UAAqB,GAAG,IAAmB;QAChD,QAAQ,GAAG,IAAI,CAAC;QAChB,QAAQ,GAAG,IAAI,CAAC;QAEhB,YAAY,CAAC,SAAS,CAAC,CAAC;QAExB,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,gBAAgB,GAAG,UAAU,CAAC,GAAG,EAAE;gBACjC,UAAU,EAAE,CAAC;gBACb,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,gBAAgB,GAAG,SAAgB,CAAC;YACtC,CAAC,EAAE,OAAO,CAAC,CAAC;QACd,CAAC;QAED,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,UAAU,EAAE,CAAC;YACb,YAAY,CAAC,gBAAgB,CAAC,CAAC;YAC/B,gBAAgB,GAAG,SAAgB,CAAC;QACtC,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "bindra",
+  "version": "2.0.0",
+  "description": "Lightweight reactive data management library for TypeScript applications",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "release": "npm version patch && npm publish",
+    "release:minor": "npm version minor && npm publish",
+    "release:major": "npm version major && npm publish"
+  },
+  "keywords": [
+    "reactive",
+    "data",
+    "datasource",
+    "mvvm",
+    "typescript",
+    "signals",
+    "crud",
+    "api",
+    "state-management",
+    "observable"
+  ],
+  "author": "Mohamad J. <mohamad-j@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mohamad-j/Bindra.git",
+    "directory": "package"
+  },
+  "bugs": {
+    "url": "https://github.com/mohamad-j/Bindra/issues"
+  },
+  "homepage": "https://bindra-docs.web.app",
+  "packageManager": "pnpm@10.11.1",
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/ui": "^4.0.16",
+    "happy-dom": "^20.0.11",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.16"
+  }
+}