@hamak/ui-store 0.5.1

package/README.md

@@ -0,0 +1,143 @@
+# UI Store
+
+Redux-based state management framework for microkernel applications with extensible middleware and dynamic reducer registration.
+
+## Package Structure
+
+This is a monorepo package containing four sub-packages following the API-SPI-IMPL pattern:
+
+- **[@hamak/ui-store-api](./ui-store-api)** - Type definitions, interfaces, and service tokens
+- **[@hamak/ui-store-spi](./ui-store-spi)** - Service Provider Interfaces for extensibility
+- **[@hamak/ui-store-impl](./ui-store-impl)** - Concrete implementations with Redux integration
+- **[@hamak/ui-store-templates](./ui-store-templates)** - React hooks and components
+
+## Features
+
+### Extensible Middleware System
+- **Plugin contributions** - Any plugin can register middleware
+- **Priority-based ordering** - Control middleware execution order
+- **Type-safe** - Full TypeScript support
+- **Built-in middleware** - Logger, thunk, event bridge, crash reporter
+
+### Dynamic Reducer Registry
+- **Hot replacement** - Add/remove reducers at runtime
+- **Plugin isolation** - Each plugin manages its own slice
+- **Type-safe** - Strongly typed state access
+
+### Microkernel Integration
+- **Event bridge** - Bidirectional Redux ↔ Microkernel events
+- **DI integration** - Services via dependency injection
+- **Plugin lifecycle** - Initialize during plugin setup
+
+### React Integration
+- **Standard Redux hooks** - useSelector, useDispatch, useStore
+- **Framework hooks** - Access store manager, registries, events
+- **DevTools support** - Redux DevTools integration
+
+## Installation
+
+```bash
+bun add @hamak/ui-store-api @hamak/ui-store-impl @hamak/ui-store-templates
+```
+
+## Quick Start
+
+```typescript
+import { Host } from '@hamak/microkernel-impl';
+import { createStorePlugin } from '@hamak/ui-store-impl';
+import { thunk } from 'redux-thunk';
+
+const host = new Host();
+
+// Register store plugin
+host.registerPlugin(
+  'ui-store',
+  { name: 'ui-store', version: '1.0.0', entry: '' },
+  createStorePlugin({
+    devTools: true,
+    middleware: [
+      { id: 'redux-thunk', middleware: thunk, priority: 500 }
+    ]
+  })
+);
+
+await host.bootstrapAllAtRoot();
+```
+
+## Usage
+
+### Plugin Contributing Middleware
+
+```typescript
+import { MIDDLEWARE_REGISTRY_TOKEN } from '@hamak/ui-store-api';
+
+export const myPlugin: PluginModule = {
+  async initialize(ctx) {
+    const registry = ctx.resolve(MIDDLEWARE_REGISTRY_TOKEN);
+
+    registry.register({
+      id: 'my-middleware',
+      middleware: (store) => (next) => (action) => {
+        console.log('Action:', action.type);
+        return next(action);
+      },
+      priority: 100,
+      plugin: 'my-plugin'
+    });
+  }
+};
+```
+
+### Plugin Contributing Reducer
+
+```typescript
+import { REDUCER_REGISTRY_TOKEN } from '@hamak/ui-store-api';
+
+export const myPlugin: PluginModule = {
+  async initialize(ctx) {
+    const registry = ctx.resolve(REDUCER_REGISTRY_TOKEN);
+
+    registry.register('mySlice', (state = {}, action) => {
+      switch (action.type) {
+        case 'MY_ACTION':
+          return { ...state, ...action.payload };
+        default:
+          return state;
+      }
+    });
+  }
+};
+```
+
+### React Components
+
+```typescript
+import { useSelector, useDispatch } from '@hamak/ui-store-templates';
+
+function MyComponent() {
+  const data = useSelector(state => state.mySlice.data);
+  const dispatch = useDispatch();
+
+  return (
+    <button onClick={() => dispatch({ type: 'MY_ACTION', payload: {} })}>
+      Click Me
+    </button>
+  );
+}
+```
+
+## Architecture
+
+```
+Plugins → DI Container → Store Manager
+  ↓          ↓              ↓
+Middleware Registry    Reducer Registry
+  ↓          ↓              ↓
+Redux Store ↔ Event Bridge ↔ Microkernel
+  ↓
+React (useSelector, useDispatch)
+```
+
+## License
+
+MIT

package/dist/api/api/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * API Interfaces Export
+ */
+export * from './store-manager';
+export * from './middleware-registry';
+export * from './reducer-registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}

package/dist/api/api/index.js

@@ -0,0 +1,6 @@
+/**
+ * API Interfaces Export
+ */
+export * from './store-manager';
+export * from './middleware-registry';
+export * from './reducer-registry';

package/dist/api/api/middleware-registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Middleware Registry Interface
+ * Extension point for plugins to contribute middleware
+ */
+import type { Middleware } from 'redux';
+import type { MiddlewareRegistration } from '../types';
+export interface IMiddlewareRegistry {
+    /**
+     * Register a middleware
+     */
+    register(registration: MiddlewareRegistration): void;
+    /**
+     * Unregister a middleware by ID
+     */
+    unregister(id: string): void;
+    /**
+     * Get all middleware in priority order
+     */
+    getAll(): Middleware[];
+    /**
+     * Check if middleware is registered
+     */
+    has(id: string): boolean;
+    /**
+     * Get middleware registration info
+     */
+    getInfo(id: string): MiddlewareRegistration | undefined;
+    /**
+     * Get all registrations with metadata
+     */
+    getAllRegistrations(): MiddlewareRegistration[];
+}
+//# sourceMappingURL=middleware-registry.d.ts.map

package/dist/api/api/middleware-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-registry.d.ts","sourceRoot":"","sources":["../../../src/api/api/middleware-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,MAAM,IAAI,UAAU,EAAE,CAAC;IAEvB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAAC;IAExD;;OAEG;IACH,mBAAmB,IAAI,sBAAsB,EAAE,CAAC;CACjD"}

package/dist/api/api/middleware-registry.js

@@ -0,0 +1,5 @@
+/**
+ * Middleware Registry Interface
+ * Extension point for plugins to contribute middleware
+ */
+export {};

package/dist/api/api/reducer-registry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Reducer Registry Interface
+ * Allows dynamic reducer registration and hot replacement
+ */
+import type { Reducer } from 'redux';
+import type { ReducerMap, ReducerRegistration } from '../types';
+export interface IReducerRegistry {
+    /**
+     * Register a reducer for a state slice key
+     * @param key - State slice key
+     * @param reducer - Reducer function
+     * @param replace - Whether to replace existing reducer (default: false)
+     */
+    register(key: string, reducer: Reducer, replace?: boolean): void;
+    /**
+     * Unregister a reducer
+     * @param key - State slice key
+     */
+    unregister(key: string): void;
+    /**
+     * Get all registered reducers
+     */
+    getAll(): ReducerMap;
+    /**
+     * Get combined root reducer
+     */
+    getCombinedReducer(): Reducer;
+    /**
+     * Check if reducer is registered
+     */
+    has(key: string): boolean;
+    /**
+     * Get reducer registration info
+     */
+    getInfo(key: string): ReducerRegistration | undefined;
+    /**
+     * Get all registrations with metadata
+     */
+    getAllRegistrations(): ReducerRegistration[];
+}
+//# sourceMappingURL=reducer-registry.d.ts.map

package/dist/api/api/reducer-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer-registry.d.ts","sourceRoot":"","sources":["../../../src/api/api/reducer-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,MAAM,IAAI,UAAU,CAAC;IAErB;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAEtD;;OAEG;IACH,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CAC9C"}

package/dist/api/api/reducer-registry.js

@@ -0,0 +1,5 @@
+/**
+ * Reducer Registry Interface
+ * Allows dynamic reducer registration and hot replacement
+ */
+export {};

package/dist/api/api/store-manager.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Store Manager Interface
+ * Main orchestrator for Redux store management
+ */
+import type { Store, Reducer, Action } from 'redux';
+import type { StoreConfig, RootState, AppAction } from '../types';
+import type { IMiddlewareRegistry } from './middleware-registry';
+import type { IReducerRegistry } from './reducer-registry';
+export interface IStoreManager {
+    /**
+     * Get the Redux store instance
+     * @throws Error if store is not initialized
+     */
+    getStore(): Store<RootState, AppAction>;
+    /**
+     * Check if store is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Initialize the store
+     * Should be called after all plugins have registered middleware/reducers
+     * @internal - Called by plugin framework during activation
+     */
+    initialize(config?: StoreConfig): Store<RootState, AppAction>;
+    /**
+     * Get middleware registry (for plugin contributions)
+     */
+    getMiddlewareRegistry(): IMiddlewareRegistry;
+    /**
+     * Get reducer registry (for dynamic reducers)
+     */
+    getReducerRegistry(): IReducerRegistry;
+    /**
+     * Dispatch an action
+     */
+    dispatch<A extends Action>(action: A): A;
+    /**
+     * Get current state
+     */
+    getState<S = RootState>(): S;
+    /**
+     * Subscribe to state changes
+     * @returns Unsubscribe function
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Replace the root reducer (for hot module replacement)
+     */
+    replaceReducer(nextReducer: Reducer<RootState, AppAction>): void;
+    /**
+     * Destroy the store and clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=store-manager.d.ts.map

package/dist/api/api/store-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-manager.d.ts","sourceRoot":"","sources":["../../../src/api/api/store-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAExC;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;;;OAIG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAE9D;;OAEG;IACH,qBAAqB,IAAI,mBAAmB,CAAC;IAE7C;;OAEG;IACH,kBAAkB,IAAI,gBAAgB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE5C;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;IAEjE;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/api/api/store-manager.js

@@ -0,0 +1,5 @@
+/**
+ * Store Manager Interface
+ * Main orchestrator for Redux store management
+ */
+export {};

package/dist/api/autosave/autosave-action-factory.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Autosave Action Factory
+ *
+ * Factory for creating autosave actions.
+ */
+import type { AnyAction } from 'redux';
+import type { AutosaveConfig } from './autosave-types';
+import { type SetAutosaveConfigAction, type ClearAutosaveConfigAction, type ChangeDetectedAction, type DebounceExpiredAction, type SaveStartedAction, type SaveSucceededAction, type SaveFailedAction, type RetryScheduledAction, type FlushPendingAction, type FlushAllPendingAction, type CancelPendingAction, type AutosaveAction } from './autosave-action-types';
+/**
+ * Factory class for creating autosave actions
+ */
+export declare class AutosaveActionFactory {
+    /**
+     * Set autosave configuration for a path
+     */
+    setConfig(path: string[], config: AutosaveConfig): SetAutosaveConfigAction;
+    /**
+     * Clear autosave configuration for a path (revert to inherited)
+     */
+    clearConfig(path: string[]): ClearAutosaveConfigAction;
+    /**
+     * Content change detected, debounce timer started
+     */
+    changeDetected(path: string[], detectedAt: number, scheduledFor: number, providerId: string): ChangeDetectedAction;
+    /**
+     * Debounce timer expired, ready to save
+     */
+    debounceExpired(path: string[]): DebounceExpiredAction;
+    /**
+     * Save operation started
+     */
+    saveStarted(path: string[], providerId: string): SaveStartedAction;
+    /**
+     * Save completed successfully
+     */
+    saveSucceeded(path: string[], timestamp?: number): SaveSucceededAction;
+    /**
+     * Save failed
+     */
+    saveFailed(path: string[], error: {
+        code: string;
+        message: string;
+    }, attempt?: number): SaveFailedAction;
+    /**
+     * Retry scheduled
+     */
+    retryScheduled(path: string[], retryAt: number, attempt: number): RetryScheduledAction;
+    /**
+     * Flush pending save immediately (cancels debounce)
+     */
+    flushPending(path: string[]): FlushPendingAction;
+    /**
+     * Flush all pending saves
+     */
+    flushAllPending(): FlushAllPendingAction;
+    /**
+     * Cancel pending save
+     */
+    cancelPending(path: string[]): CancelPendingAction;
+    /**
+     * Check if an action is an autosave action
+     */
+    isAutosaveAction(action: AnyAction): action is AutosaveAction;
+}
+/**
+ * Singleton instance of the autosave action factory
+ */
+export declare const autosaveActions: AutosaveActionFactory;
+//# sourceMappingURL=autosave-action-factory.d.ts.map

package/dist/api/autosave/autosave-action-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autosave-action-factory.d.ts","sourceRoot":"","sources":["../../../src/api/autosave/autosave-action-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,qBAAa,qBAAqB;IAKhC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,uBAAuB;IAO1E;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,yBAAyB;IAWtD;;OAEG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,oBAAoB;IAOvB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,qBAAqB;IAOtD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB;IAOlE;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAOtE;;OAEG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACxC,OAAO,GAAE,MAAU,GAClB,gBAAgB;IAUnB;;OAEG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,oBAAoB;IAWvB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB;IAOhD;;OAEG;IACH,eAAe,IAAI,qBAAqB;IAMxC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB;IAWlD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI,cAAc;CAM9D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,uBAA8B,CAAC"}

package/dist/api/autosave/autosave-action-factory.js

@@ -0,0 +1,135 @@
+/**
+ * Autosave Action Factory
+ *
+ * Factory for creating autosave actions.
+ */
+import { AutosaveActionTypes, } from './autosave-action-types';
+/**
+ * Factory class for creating autosave actions
+ */
+export class AutosaveActionFactory {
+    // ─────────────────────────────────────────────────────────────────
+    // Configuration Actions
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Set autosave configuration for a path
+     */
+    setConfig(path, config) {
+        return {
+            type: AutosaveActionTypes.SET_CONFIG,
+            payload: { path, config },
+        };
+    }
+    /**
+     * Clear autosave configuration for a path (revert to inherited)
+     */
+    clearConfig(path) {
+        return {
+            type: AutosaveActionTypes.CLEAR_CONFIG,
+            payload: { path },
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Lifecycle Actions (used internally by middleware)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Content change detected, debounce timer started
+     */
+    changeDetected(path, detectedAt, scheduledFor, providerId) {
+        return {
+            type: AutosaveActionTypes.CHANGE_DETECTED,
+            payload: { path, detectedAt, scheduledFor, providerId },
+        };
+    }
+    /**
+     * Debounce timer expired, ready to save
+     */
+    debounceExpired(path) {
+        return {
+            type: AutosaveActionTypes.DEBOUNCE_EXPIRED,
+            payload: { path },
+        };
+    }
+    /**
+     * Save operation started
+     */
+    saveStarted(path, providerId) {
+        return {
+            type: AutosaveActionTypes.SAVE_STARTED,
+            payload: { path, providerId },
+        };
+    }
+    /**
+     * Save completed successfully
+     */
+    saveSucceeded(path, timestamp) {
+        return {
+            type: AutosaveActionTypes.SAVE_SUCCEEDED,
+            payload: { path, timestamp: timestamp ?? Date.now() },
+        };
+    }
+    /**
+     * Save failed
+     */
+    saveFailed(path, error, attempt = 1) {
+        return {
+            type: AutosaveActionTypes.SAVE_FAILED,
+            payload: {
+                path,
+                error: { ...error, attempt },
+            },
+        };
+    }
+    /**
+     * Retry scheduled
+     */
+    retryScheduled(path, retryAt, attempt) {
+        return {
+            type: AutosaveActionTypes.RETRY_SCHEDULED,
+            payload: { path, retryAt, attempt },
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Manual Trigger Actions
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Flush pending save immediately (cancels debounce)
+     */
+    flushPending(path) {
+        return {
+            type: AutosaveActionTypes.FLUSH_PENDING,
+            payload: { path },
+        };
+    }
+    /**
+     * Flush all pending saves
+     */
+    flushAllPending() {
+        return {
+            type: AutosaveActionTypes.FLUSH_ALL_PENDING,
+        };
+    }
+    /**
+     * Cancel pending save
+     */
+    cancelPending(path) {
+        return {
+            type: AutosaveActionTypes.CANCEL_PENDING,
+            payload: { path },
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Type Guards
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Check if an action is an autosave action
+     */
+    isAutosaveAction(action) {
+        return (typeof action.type === 'string' &&
+            action.type.startsWith('@@autosave/'));
+    }
+}
+/**
+ * Singleton instance of the autosave action factory
+ */
+export const autosaveActions = new AutosaveActionFactory();

package/dist/api/autosave/autosave-action-types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Autosave Action Types
+ *
+ * These actions orchestrate the autosave lifecycle but do NOT execute saves.
+ * Actual saves are performed by plugin providers using their own actions
+ * (e.g., PUT_REQUEST for remote-fs, UPDATE_ENTITY for remote-resource).
+ */
+import type { AutosaveConfig, AutosaveError } from './autosave-types';
+/**
+ * Autosave action type constants
+ */
+export declare enum AutosaveActionTypes {
+    /** Set autosave configuration for a path */
+    SET_CONFIG = "@@autosave/SET_CONFIG",
+    /** Clear autosave configuration (revert to inherited) */
+    CLEAR_CONFIG = "@@autosave/CLEAR_CONFIG",
+    /** Content change detected, debounce timer started */
+    CHANGE_DETECTED = "@@autosave/CHANGE_DETECTED",
+    /** Debounce timer expired, save will be triggered */
+    DEBOUNCE_EXPIRED = "@@autosave/DEBOUNCE_EXPIRED",
+    /** Save operation started */
+    SAVE_STARTED = "@@autosave/SAVE_STARTED",
+    /** Save completed successfully */
+    SAVE_SUCCEEDED = "@@autosave/SAVE_SUCCEEDED",
+    /** Save failed */
+    SAVE_FAILED = "@@autosave/SAVE_FAILED",
+    /** Retry scheduled */
+    RETRY_SCHEDULED = "@@autosave/RETRY_SCHEDULED",
+    /** Flush pending save immediately (cancels debounce) */
+    FLUSH_PENDING = "@@autosave/FLUSH_PENDING",
+    /** Flush all pending saves */
+    FLUSH_ALL_PENDING = "@@autosave/FLUSH_ALL_PENDING",
+    /** Cancel pending save */
+    CANCEL_PENDING = "@@autosave/CANCEL_PENDING"
+}
+/** Set autosave configuration for a path */
+export interface SetAutosaveConfigAction {
+    type: AutosaveActionTypes.SET_CONFIG;
+    payload: {
+        path: string[];
+        config: AutosaveConfig;
+    };
+    [key: string]: unknown;
+}
+/** Clear autosave configuration for a path */
+export interface ClearAutosaveConfigAction {
+    type: AutosaveActionTypes.CLEAR_CONFIG;
+    payload: {
+        path: string[];
+    };
+    [key: string]: unknown;
+}
+/** Content change detected */
+export interface ChangeDetectedAction {
+    type: AutosaveActionTypes.CHANGE_DETECTED;
+    payload: {
+        path: string[];
+        detectedAt: number;
+        scheduledFor: number;
+        providerId: string;
+    };
+    [key: string]: unknown;
+}
+/** Debounce timer expired */
+export interface DebounceExpiredAction {
+    type: AutosaveActionTypes.DEBOUNCE_EXPIRED;
+    payload: {
+        path: string[];
+    };
+    [key: string]: unknown;
+}
+/** Save started */
+export interface SaveStartedAction {
+    type: AutosaveActionTypes.SAVE_STARTED;
+    payload: {
+        path: string[];
+        providerId: string;
+    };
+    [key: string]: unknown;
+}
+/** Save succeeded */
+export interface SaveSucceededAction {
+    type: AutosaveActionTypes.SAVE_SUCCEEDED;
+    payload: {
+        path: string[];
+        timestamp: number;
+    };
+    [key: string]: unknown;
+}
+/** Save failed */
+export interface SaveFailedAction {
+    type: AutosaveActionTypes.SAVE_FAILED;
+    payload: {
+        path: string[];
+        error: AutosaveError;
+    };
+    [key: string]: unknown;
+}
+/** Retry scheduled */
+export interface RetryScheduledAction {
+    type: AutosaveActionTypes.RETRY_SCHEDULED;
+    payload: {
+        path: string[];
+        retryAt: number;
+        attempt: number;
+    };
+    [key: string]: unknown;
+}
+/** Flush pending save */
+export interface FlushPendingAction {
+    type: AutosaveActionTypes.FLUSH_PENDING;
+    payload: {
+        path: string[];
+    };
+    [key: string]: unknown;
+}
+/** Flush all pending saves */
+export interface FlushAllPendingAction {
+    type: AutosaveActionTypes.FLUSH_ALL_PENDING;
+    [key: string]: unknown;
+}
+/** Cancel pending save */
+export interface CancelPendingAction {
+    type: AutosaveActionTypes.CANCEL_PENDING;
+    payload: {
+        path: string[];
+    };
+    [key: string]: unknown;
+}
+/**
+ * Union type of all autosave actions
+ */
+export type AutosaveAction = SetAutosaveConfigAction | ClearAutosaveConfigAction | ChangeDetectedAction | DebounceExpiredAction | SaveStartedAction | SaveSucceededAction | SaveFailedAction | RetryScheduledAction | FlushPendingAction | FlushAllPendingAction | CancelPendingAction;
+//# sourceMappingURL=autosave-action-types.d.ts.map

package/dist/api/autosave/autosave-action-types.d.ts.map

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