@miurajs/miura-data-flow 0.0.3 → 0.1.4

package/README.md

@@ -1,6 +1,6 @@
 # miura Data Flow
 
-Modern, reactive state management for miura applications. Combines the best of Redux, Zustand, and modern patterns with zero boilerplate and maximum performance.
+Modern, reactive state management for miura applications. Combines the best of Redux, Zustand, and modern patterns with zero boilerplate and maximum performance. **Now with optional dependencies for optimal bundle size!**
 
 ## Features
 
@@ -12,11 +12,26 @@ Modern, reactive state management for miura applications. Combines the best of R
 - **🛠️ DevTools Support** - Redux DevTools integration
 - **📝 TypeScript First** - Full type safety and IntelliSense
 - **⚡ Performance Optimized** - Efficient subscriptions and updates
+- **📦 Optional Dependencies** - Only install what you need for optimal bundle size
+
+## Installation
+
+```bash
+# Core package (includes built-in providers)
+npm install @miurajs/miura-data-flow
+
+# Optional providers (install as needed)
+npm install graphql-request          # For GraphQL provider
+npm install @aws-sdk/client-s3       # For AWS S3 provider  
+npm install firebase                 # For Firebase provider
+npm install @supabase/supabase-js    # For Supabase provider
+npm install grpc-web                 # For gRPC-Web provider
+```
 
 ## Quick Start
 
 ```typescript
-import { Store, globalState, createLoggerMiddleware } from '@miura/miura-data-flow';
+import { Store, globalState, createLoggerMiddleware } from '@miurajs/miura-data-flow';
 
 // Create a store
 const store = new Store({ count: 0, user: null });
@@ -47,7 +62,7 @@ await store.dispatch('setUser', { id: '1', name: 'John' });
 The main state container that manages your application state.
 
 ```typescript
-import { Store } from '@miura/miura-data-flow';
+import { Store } from '@miurajs/miura-data-flow';
 
 interface AppState {
   count: number;
@@ -118,7 +133,7 @@ const unsubscribeUser = store.subscribe(
 #### Logger Middleware
 
 ```typescript
-import { createLoggerMiddleware } from '@miura/miura-data-flow';
+import { createLoggerMiddleware } from '@miurajs/miura-data-flow';
 
 store.use(createLoggerMiddleware());
 // Logs all actions and state changes to console
@@ -127,7 +142,7 @@ store.use(createLoggerMiddleware());
 #### Persistence Middleware
 
 ```typescript
-import { createPersistenceMiddleware } from '@miura/miura-data-flow';
+import { createPersistenceMiddleware } from '@miurajs/miura-data-flow';
 
 store.use(createPersistenceMiddleware(['user', 'settings']));
 // Automatically saves/loads specified properties to localStorage
@@ -136,7 +151,7 @@ store.use(createPersistenceMiddleware(['user', 'settings']));
 #### API Middleware
 
 ```typescript
-import { createApiMiddleware } from '@miura/miura-data-flow';
+import { createApiMiddleware } from '@miurajs/miura-data-flow';
 
 store.use(createApiMiddleware({
   baseURL: 'https://api.example.com',
@@ -159,7 +174,7 @@ await store.dispatch('api_createUser', { method: 'POST', data: userData });
 #### Cache Middleware
 
 ```typescript
-import { createCacheMiddleware } from '@miura/miura-data-flow';
+import { createCacheMiddleware } from '@miurajs/miura-data-flow';
 
 store.use(createCacheMiddleware(5 * 60 * 1000)); // 5 minutes TTL
 // Caches API responses for 5 minutes
@@ -168,7 +183,7 @@ store.use(createCacheMiddleware(5 * 60 * 1000)); // 5 minutes TTL
 #### DevTools Middleware
 
 ```typescript
-import { createDevToolsMiddleware } from '@miura/miura-data-flow';
+import { createDevToolsMiddleware } from '@miurajs/miura-data-flow';
 
 store.use(createDevToolsMiddleware('MyApp'));
 // Enables Redux DevTools integration
@@ -194,7 +209,7 @@ Redux DevTools is a powerful browser extension that provides real-time debugging
 
 2. **Enable in Your Code:**
    ```typescript
-   import { createDevToolsMiddleware } from '@miura/miura-data-flow';
+   import { createDevToolsMiddleware } from '@miurajs/miura-data-flow';
    
    store.use(createDevToolsMiddleware('MyApp'));
    ```
@@ -222,7 +237,7 @@ State After:  { count: 1, user: { id: '1', name: 'John' } }
 #### Complete Example:
 
 ```typescript
-import { Store, createDevToolsMiddleware } from '@miura/miura-data-flow';
+import { Store, createDevToolsMiddleware } from '@miurajs/miura-data-flow';
 
 // Create store
 const store = new Store({
@@ -339,7 +354,7 @@ See the [examples directory](./examples) for complete working examples.
 ### Custom Middleware
 
 ```typescript
-import { StoreMiddleware } from '@miura/miura-data-flow';
+import { StoreMiddleware } from '@miurajs/miura-data-flow';
 
 const analyticsMiddleware: StoreMiddleware = {
   name: 'analytics',
@@ -365,7 +380,7 @@ store.use(analyticsMiddleware);
 ### Using Global State
 
 ```typescript
-import { globalState } from '@miura/miura-data-flow';
+import { globalState } from '@miurajs/miura-data-flow';
 
 // Set global properties
 globalState.set('theme', 'dark');
@@ -384,8 +399,8 @@ const unsubscribe = globalState.subscribeTo('my-component', 'theme', (theme) =>
 ### Global State in Components
 
 ```typescript
-import { MiuraElement, html } from '@miura/miura-element';
-import { globalState } from '@miura/miura-data-flow';
+import { MiuraElement, html } from '@miurajs/miura-element';
+import { globalState } from '@miurajs/miura-data-flow';
 
 class ThemeToggle extends MiuraElement {
   static properties = {
@@ -426,12 +441,168 @@ class ThemeToggle extends MiuraElement {
 }
 ```
 
+## Data Providers
+
+miura Data Flow includes a flexible provider system for connecting to various data sources. 
+
+### Built-in Providers (Always Available)
+
+These providers are included by default and have no external dependencies:
+
+```typescript
+import { 
+  RestProviderFactory,
+  LocalStorageProviderFactory, 
+  IndexedDBProviderFactory,
+  WebSocketProviderFactory 
+} from '@miurajs/miura-data-flow';
+
+// Register and use built-in providers
+import { registerProvider, createProvider } from '@miurajs/miura-data-flow';
+
+// Register REST API provider
+registerProvider('api', new RestProviderFactory());
+
+// Create provider instance
+const apiProvider = createProvider('api', { 
+  baseUrl: 'https://api.example.com' 
+});
+
+// Use the provider
+const users = await apiProvider.get('users');
+```
+
+### Optional Providers (Require Additional Dependencies)
+
+These providers are available as separate imports to keep the core package lightweight:
+
+#### GraphQL Provider
+
+```bash
+# Install the optional dependency
+npm install graphql-request
+```
+
+```typescript
+// Import the GraphQL provider separately
+import { GraphQLProviderFactory } from '@miurajs/miura-data-flow/providers/graphql';
+
+// Register and use
+registerProvider('graphql', new GraphQLProviderFactory());
+const graphqlProvider = createProvider('graphql', { 
+  endpoint: 'https://api.example.com/graphql' 
+});
+
+const result = await graphqlProvider.query({
+  query: 'query { users { id name } }'
+});
+```
+
+#### AWS S3 Provider
+
+```bash
+# Install the optional dependency
+npm install @aws-sdk/client-s3
+```
+
+```typescript
+// Import the S3 provider separately
+import { S3ProviderFactory } from '@miurajs/miura-data-flow/providers/s3';
+
+// Register and use
+registerProvider('s3', new S3ProviderFactory());
+const s3Provider = createProvider('s3', { 
+  region: 'us-east-1',
+  bucket: 'my-bucket' 
+});
+
+const data = await s3Provider.get('file.json');
+await s3Provider.put('file.json', jsonData);
+```
+
+#### Firebase Provider
+
+```bash
+# Install the optional dependency
+npm install firebase
+```
+
+```typescript
+// Import the Firebase provider separately
+import { FirebaseProviderFactory } from '@miurajs/miura-data-flow/providers/firebase';
+
+// Register and use
+registerProvider('firebase', new FirebaseProviderFactory());
+const firebaseProvider = createProvider('firebase', { 
+  apiKey: 'your-api-key',
+  authDomain: 'your-project.firebaseapp.com',
+  projectId: 'your-project-id'
+});
+```
+
+#### Supabase Provider
+
+```bash
+# Install the optional dependency
+npm install @supabase/supabase-js
+```
+
+```typescript
+// Import the Supabase provider separately
+import { SupabaseProviderFactory } from '@miurajs/miura-data-flow/providers/supabase';
+
+// Register and use
+registerProvider('supabase', new SupabaseProviderFactory());
+const supabaseProvider = createProvider('supabase', { 
+  url: 'https://your-project.supabase.co',
+  anonKey: 'your-anon-key'
+});
+```
+
+#### gRPC-Web Provider
+
+```bash
+# Install the optional dependency
+npm install grpc-web
+```
+
+```typescript
+// Import the gRPC-Web provider separately
+import { GrpcWebProviderFactory } from '@miurajs/miura-data-flow/providers/grpc-web';
+
+// Register and use
+registerProvider('grpc', new GrpcWebProviderFactory());
+const grpcProvider = createProvider('grpc', { 
+  host: 'localhost:8080',
+  protoPath: './service.proto'
+});
+```
+
+### Why This Structure?
+
+1. **Bundle Size Optimization** - Only include providers you actually use
+2. **Dependency Management** - Avoid forcing installation of large libraries
+3. **Tree Shaking** - Better optimization for production builds
+4. **Flexibility** - Use only what you need, when you need it
+
+### Provider Usage in Middleware
+
+```typescript
+import { createApiMiddleware } from '@miurajs/miura-data-flow';
+
+// Use any registered provider in middleware
+store.use(createApiMiddleware({
+  provider: 's3', // Use the S3 provider we registered
+  bucket: 'my-app-data'
+}));
+```
+
 ## Integration with miura Framework
 
 ### Framework Setup
 
 ```typescript
-import { Store, createApiMiddleware, createCacheMiddleware } from '@miura/miura-data-flow';
+import { Store, createApiMiddleware, createCacheMiddleware } from '@miurajs/miura-data-flow';
 
 class miuraFramework {
   private store: Store;
@@ -548,7 +719,7 @@ class MyComponent {
 ### Enable Debug Logging
 
 ```typescript
-import { enableDebug } from '@miura/miura-render';
+import { enableDebug } from '@miurajs/miura-render';
 
 enableDebug({
   element: true, // Shows data flow logs

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './src/miura-data-flow';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './src/miura-data-flow';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/src/global-state.d.ts

@@ -0,0 +1,79 @@
+import { Store, StoreState, StoreActions } from './store';
+/**
+ * Global state interface
+ */
+export interface GlobalState extends StoreState {
+    user?: {
+        id: string;
+        name: string;
+        email: string;
+    };
+    theme?: 'light' | 'dark';
+    language?: string;
+    notifications?: Array<{
+        id: string;
+        message: string;
+        type: 'info' | 'success' | 'warning' | 'error';
+    }>;
+}
+/**
+ * Global State Manager
+ * Manages application-wide state using the Store system
+ */
+export declare class GlobalStateManager {
+    private static instance;
+    private store;
+    private componentSubscriptions;
+    private constructor();
+    static getInstance(): GlobalStateManager;
+    /**
+     * Get the global store
+     */
+    getStore(): Store<GlobalState>;
+    /**
+     * Get a global property
+     */
+    get<K extends keyof GlobalState>(key: K): GlobalState[K];
+    /**
+     * Set a global property
+     */
+    set<K extends keyof GlobalState>(key: K, value: GlobalState[K]): void;
+    /**
+     * Subscribe to global state changes
+     */
+    subscribe(componentId: string, properties: (keyof GlobalState)[], callback: (state: GlobalState, prevState: GlobalState) => void): () => void;
+    /**
+     * Subscribe to a specific global property
+     */
+    subscribeTo<K extends keyof GlobalState>(componentId: string, key: K, callback: (value: GlobalState[K], prevValue: GlobalState[K]) => void): () => void;
+    /**
+     * Unsubscribe component from all global state
+     */
+    unsubscribe(componentId: string): void;
+    /**
+     * Define global actions
+     */
+    defineActions(actions: StoreActions<GlobalState>): void;
+    /**
+     * Dispatch a global action
+     */
+    dispatch(action: string, ...args: unknown[]): Promise<void>;
+    /**
+     * Add middleware to global store
+     */
+    use(middleware: any): void;
+    /**
+     * Get debug information
+     */
+    getDebugInfo(): {
+        componentSubscriptions: {
+            [k: string]: string[];
+        };
+        state: GlobalState;
+        actions: string[];
+        subscribers: number;
+        middlewares: string[];
+    };
+}
+export declare const globalState: GlobalStateManager;
+//# sourceMappingURL=global-state.d.ts.map

package/dist/src/global-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-state.d.ts","sourceRoot":"","sources":["../../src/global-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1D;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,UAAU;IAE7C,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;KAChD,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAC5C,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,sBAAsB,CAAkC;IAEhE,OAAO;IAQP,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAOxC;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAC;IAI9B;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IAIxD;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAIrE;;OAEG;IACH,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,CAAC,MAAM,WAAW,CAAC,EAAE,EACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,KAAK,IAAI,GAC7D,MAAM,IAAI;IAsBb;;OAEG;IACH,WAAW,CAAC,CAAC,SAAS,MAAM,WAAW,EACrC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACnE,MAAM,IAAI;IAQb;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI;IAI1B;;OAEG;IACH,YAAY;;;;;;;;;CAWb;AAGD,eAAO,MAAM,WAAW,oBAAmC,CAAC"}

package/dist/src/global-state.js

@@ -0,0 +1,111 @@
+import { Store } from './store';
+import { debugLog } from '@miurajs/miura-debugger';
+/**
+ * Global State Manager
+ * Manages application-wide state using the Store system
+ */
+export class GlobalStateManager {
+    static instance;
+    store;
+    componentSubscriptions = new Map();
+    constructor() {
+        this.store = new Store({
+            theme: 'light',
+            language: 'en',
+            notifications: []
+        });
+    }
+    static getInstance() {
+        if (!GlobalStateManager.instance) {
+            GlobalStateManager.instance = new GlobalStateManager();
+        }
+        return GlobalStateManager.instance;
+    }
+    /**
+     * Get the global store
+     */
+    getStore() {
+        return this.store;
+    }
+    /**
+     * Get a global property
+     */
+    get(key) {
+        return this.store.get(key);
+    }
+    /**
+     * Set a global property
+     */
+    set(key, value) {
+        this.store.setState({ [key]: value });
+    }
+    /**
+     * Subscribe to global state changes
+     */
+    subscribe(componentId, properties, callback) {
+        // Track component subscriptions
+        if (!this.componentSubscriptions.has(componentId)) {
+            this.componentSubscriptions.set(componentId, new Set());
+        }
+        this.componentSubscriptions.get(componentId).add(properties.join(','));
+        debugLog('element', 'Subscribed to global state', { componentId, properties });
+        // Subscribe to store with selector
+        return this.store.subscribe(callback, (state) => {
+            const selected = {};
+            properties.forEach(prop => {
+                selected[prop] = state[prop];
+            });
+            return selected;
+        });
+    }
+    /**
+     * Subscribe to a specific global property
+     */
+    subscribeTo(componentId, key, callback) {
+        return this.subscribe(componentId, [key], (state, prevState) => {
+            if (state[key] !== prevState[key]) {
+                callback(state[key], prevState[key]);
+            }
+        });
+    }
+    /**
+     * Unsubscribe component from all global state
+     */
+    unsubscribe(componentId) {
+        this.componentSubscriptions.delete(componentId);
+        debugLog('element', 'Unsubscribed from global state', { componentId });
+    }
+    /**
+     * Define global actions
+     */
+    defineActions(actions) {
+        this.store.defineActions(actions);
+    }
+    /**
+     * Dispatch a global action
+     */
+    async dispatch(action, ...args) {
+        await this.store.dispatch(action, ...args);
+    }
+    /**
+     * Add middleware to global store
+     */
+    use(middleware) {
+        this.store.use(middleware);
+    }
+    /**
+     * Get debug information
+     */
+    getDebugInfo() {
+        return {
+            ...this.store.getDebugInfo(),
+            componentSubscriptions: Object.fromEntries(Array.from(this.componentSubscriptions.entries()).map(([id, props]) => [
+                id,
+                Array.from(props)
+            ]))
+        };
+    }
+}
+// Export singleton instance
+export const globalState = GlobalStateManager.getInstance();
+//# sourceMappingURL=global-state.js.map

package/dist/src/global-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-state.js","sourceRoot":"","sources":["../../src/global-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAA4B,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAqBnD;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAC,QAAQ,CAAqB;IACpC,KAAK,CAAqB;IAC1B,sBAAsB,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEhE;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAc;YAClC,KAAK,EAAE,OAAO;YACd,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,EAAE;SAClB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;YACjC,kBAAkB,CAAC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,kBAAkB,CAAC,QAAQ,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,GAAG,CAA8B,GAAM;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,GAAG,CAA8B,GAAM,EAAE,KAAqB;QAC5D,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAA0B,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,SAAS,CACP,WAAmB,EACnB,UAAiC,EACjC,QAA8D;QAE9D,gCAAgC;QAChC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAExE,QAAQ,CAAC,SAAS,EAAE,4BAA4B,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;QAE/E,mCAAmC;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CACzB,QAAQ,EACR,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,QAAQ,GAAyB,EAAE,CAAC;YAC1C,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACxB,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW,CACT,WAAmB,EACnB,GAAM,EACN,QAAoE;QAEpE,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;YAC7D,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,WAAmB;QAC7B,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChD,QAAQ,CAAC,SAAS,EAAE,gCAAgC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAkC;QAC9C,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,GAAG,IAAe;QAC/C,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,UAAe;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO;YACL,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;YAC5B,sBAAsB,EAAE,MAAM,CAAC,WAAW,CACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;gBACrE,EAAE;gBACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;aAClB,CAAC,CACH;SACF,CAAC;IACJ,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC"}

package/dist/src/middleware.d.ts

@@ -0,0 +1,38 @@
+import { StoreMiddleware, StoreState } from './store';
+/**
+ * Logger middleware for debugging
+ */
+export declare function createLoggerMiddleware(): StoreMiddleware;
+/**
+ * Persistence middleware for localStorage
+ */
+export declare function createPersistenceMiddleware(keys: string[], storageKey?: string): StoreMiddleware;
+/**
+ * Loads persisted state from localStorage.
+ * Call this to get initial state when creating a store:
+ *   const persisted = loadPersistedState(['user', 'theme']);
+ *   const store = new Store({ ...defaults, ...persisted });
+ */
+export declare function loadPersistedState(keys: string[], storageKey?: string): Partial<StoreState>;
+/**
+ * API middleware for automatic API calls
+ */
+export declare function createApiMiddleware(apiConfig: {
+    baseURL: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}): StoreMiddleware & {
+    fetch: (endpoint: string, options?: {
+        method?: string;
+        data?: unknown;
+    }) => Promise<unknown>;
+};
+/**
+ * Cache middleware for API responses
+ */
+export declare function createCacheMiddleware(ttl?: number): StoreMiddleware;
+/**
+ * DevTools middleware for Redux DevTools integration
+ */
+export declare function createDevToolsMiddleware(storeName?: string): StoreMiddleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/src/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,CAkBxD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,SAAgB,GAAG,eAAe,CAkBvG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,SAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBlG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,eAAe,GAAG;IAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CA0BrH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,SAAgB,GAAG,eAAe,CAgC1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,SAAe,GAAG,eAAe,CAalF"}