@hamak/ui-store-api 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## 0.4.0 (2025-11-10)
+
+### 🚀 Features
+
+- implement notification plugin with UI and backend components ([c19ffcf](https://github.com/amah/app-framework/commit/c19ffcf))
+- add ES2015 build support and fix TypeScript config for logging packages ([be5e45e](https://github.com/amah/app-framework/commit/be5e45e))
+- complete logging system build and add optional console interception ([f390bc6](https://github.com/amah/app-framework/commit/f390bc6))
+- implement core pluggable logging system (Phase 1) ([2abdc1a](https://github.com/amah/app-framework/commit/2abdc1a))
+
+### 🩹 Fixes
+
+- add notification packages to workspaces ([97a234d](https://github.com/amah/app-framework/commit/97a234d))
+
+### ❤️ Thank You
+
+- Amah
+- Claude
+
 ## 0.3.0 (2025-11-06)
 
 ### 🚀 Features

package/dist/es2015/fs/contracts/filesystem-facade.contract.js

@@ -0,0 +1 @@
+export {};

package/dist/es2015/fs/contracts/filesystem-manager.contract.js

@@ -0,0 +1 @@
+export {};

package/dist/es2015/fs/index.js

@@ -0,0 +1,4 @@
+export { fileSystemNodeInitialState } from '@hamak/shared-utils';
+// Filesystem contracts
+export * from './contracts/filesystem-manager.contract';
+export * from './contracts/filesystem-facade.contract';

package/dist/es2015/index.js

@@ -5,3 +5,4 @@
 export * from './types';
 export * from './api';
 export * from './tokens';
+export * from './fs';

package/dist/fs/contracts/filesystem-facade.contract.d.ts

@@ -0,0 +1,57 @@
+import { FileSystemNode, DirectoryNode, FileNode, Path } from '@hamak/shared-utils';
+/**
+ * High-level facade for filesystem operations
+ * Provides a convenient API over the filesystem manager
+ */
+export interface IFileSystemFacade {
+    /**
+     * Get the root directory node
+     */
+    getRoot(): DirectoryNode;
+    /**
+     * Resolve a file or directory at the given path
+     */
+    resolve(path: Path): FileSystemNode | undefined;
+    /**
+     * Resolve a file at the given path
+     */
+    resolveFile<T = any>(path: Path): FileNode<T> | undefined;
+    /**
+     * Resolve a directory at the given path
+     */
+    resolveDirectory(path: Path): DirectoryNode | undefined;
+    /**
+     * Create or update a file at the given path
+     */
+    setFile<T = any>(path: Path, content: T, schema?: string, params?: {
+        override?: boolean;
+        contentIsPresent?: boolean;
+    }): void;
+    /**
+     * Update file content at the given path
+     */
+    updateFileContent<T = any>(path: Path, content: T): void;
+    /**
+     * Create a directory at the given path
+     */
+    mkdir(path: Path, params?: {
+        override?: boolean;
+    }): void;
+    /**
+     * Remove a file or directory at the given path
+     */
+    remove(path: Path): void;
+    /**
+     * Check if a path exists
+     */
+    exists(path: Path): boolean;
+    /**
+     * Check if a path is a file
+     */
+    isFile(path: Path): boolean;
+    /**
+     * Check if a path is a directory
+     */
+    isDirectory(path: Path): boolean;
+}
+//# sourceMappingURL=filesystem-facade.contract.d.ts.map

package/dist/fs/contracts/filesystem-facade.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-facade.contract.d.ts","sourceRoot":"","sources":["../../../src/fs/contracts/filesystem-facade.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEpF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,IAAI,aAAa,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,GAAG,SAAS,CAAC;IAEhD;;OAEG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAE1D;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,GAAG,SAAS,CAAC;IAExD;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,GAAG,EACb,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,EACV,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1D,IAAI,CAAC;IAER;;OAEG;IACH,iBAAiB,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAE5B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;CAClC"}

package/dist/fs/contracts/filesystem-facade.contract.js

@@ -0,0 +1 @@
+export {};

package/dist/fs/contracts/filesystem-manager.contract.d.ts

@@ -0,0 +1,41 @@
+import { FileSystemNode, FileSystemState } from '@hamak/shared-utils';
+import { Action } from 'redux';
+/**
+ * Redux selector function type
+ */
+export type Selector<S, R> = (state: S) => R;
+/**
+ * Actions for filesystem operations
+ */
+export interface FileSystemNodeAction extends Action {
+    command: any;
+}
+/**
+ * Parameters for filesystem node actions
+ */
+export interface FileSystemNodeActionParams {
+    override?: boolean;
+    contentIsPresent?: boolean;
+}
+/**
+ * Filesystem manager interface - manages Redux state for virtual filesystem
+ */
+export interface IFileSystemManager {
+    /**
+     * Get the slice name for this filesystem
+     */
+    readonly sliceName: string;
+    /**
+     * Get initial filesystem state
+     */
+    getInitialState(): FileSystemState;
+    /**
+     * Get the reducer function for filesystem operations
+     */
+    getReducer(): (state: FileSystemState, action: Action) => FileSystemState;
+    /**
+     * Create a selector for a specific path in the filesystem
+     */
+    createSelector<S>(fileSystemSelector: Selector<S, FileSystemState | undefined>, path: string | string[]): Selector<S, FileSystemNode | undefined>;
+}
+//# sourceMappingURL=filesystem-manager.contract.d.ts.map

package/dist/fs/contracts/filesystem-manager.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-manager.contract.d.ts","sourceRoot":"","sources":["../../../src/fs/contracts/filesystem-manager.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA2B,eAAe,EAAQ,MAAM,qBAAqB,CAAC;AACrG,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM;IAClD,OAAO,EAAE,GAAG,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,eAAe,IAAI,eAAe,CAAC;IAEnC;;OAEG;IACH,UAAU,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,KAAK,eAAe,CAAC;IAE1E;;OAEG;IACH,cAAc,CAAC,CAAC,EACd,kBAAkB,EAAE,QAAQ,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,EAC5D,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GACtB,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;CAC5C"}

package/dist/fs/contracts/filesystem-manager.contract.js

@@ -0,0 +1 @@
+export {};

package/dist/fs/index.d.ts

@@ -0,0 +1,5 @@
+export type { FileSystemNode, DirectoryNode, FileNode, FileSystemNodeBase, FileSystemNodeState, FileMemoState, FileSystemState, FileContentSchema } from '@hamak/shared-utils';
+export { fileSystemNodeInitialState } from '@hamak/shared-utils';
+export * from './contracts/filesystem-manager.contract';
+export * from './contracts/filesystem-facade.contract';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fs/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,cAAc,EACd,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAGjE,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC"}

package/dist/fs/index.js

@@ -0,0 +1,4 @@
+export { fileSystemNodeInitialState } from '@hamak/shared-utils';
+// Filesystem contracts
+export * from './contracts/filesystem-manager.contract';
+export * from './contracts/filesystem-facade.contract';

package/dist/index.d.ts

@@ -5,4 +5,5 @@
 export * from './types';
 export * from './api';
 export * from './tokens';
+export * from './fs';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC"}

package/dist/index.js

@@ -5,3 +5,4 @@
 export * from './types';
 export * from './api';
 export * from './tokens';
+export * from './fs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamak/ui-store-api",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "private": false,
   "type": "module",
   "description": "UI Store API - Redux store interfaces and contracts",
@@ -34,6 +34,7 @@
     }
   },
   "dependencies": {
+    "@hamak/shared-utils": "0.4.1",
     "redux": "^5.0.1"
   },
   "devDependencies": {

package/src/fs/contracts/filesystem-facade.contract.ts

@@ -0,0 +1,67 @@
+import { FileSystemNode, DirectoryNode, FileNode, Path } from '@hamak/shared-utils';
+
+/**
+ * High-level facade for filesystem operations
+ * Provides a convenient API over the filesystem manager
+ */
+export interface IFileSystemFacade {
+  /**
+   * Get the root directory node
+   */
+  getRoot(): DirectoryNode;
+
+  /**
+   * Resolve a file or directory at the given path
+   */
+  resolve(path: Path): FileSystemNode | undefined;
+
+  /**
+   * Resolve a file at the given path
+   */
+  resolveFile<T = any>(path: Path): FileNode<T> | undefined;
+
+  /**
+   * Resolve a directory at the given path
+   */
+  resolveDirectory(path: Path): DirectoryNode | undefined;
+
+  /**
+   * Create or update a file at the given path
+   */
+  setFile<T = any>(
+    path: Path,
+    content: T,
+    schema?: string,
+    params?: { override?: boolean; contentIsPresent?: boolean }
+  ): void;
+
+  /**
+   * Update file content at the given path
+   */
+  updateFileContent<T = any>(path: Path, content: T): void;
+
+  /**
+   * Create a directory at the given path
+   */
+  mkdir(path: Path, params?: { override?: boolean }): void;
+
+  /**
+   * Remove a file or directory at the given path
+   */
+  remove(path: Path): void;
+
+  /**
+   * Check if a path exists
+   */
+  exists(path: Path): boolean;
+
+  /**
+   * Check if a path is a file
+   */
+  isFile(path: Path): boolean;
+
+  /**
+   * Check if a path is a directory
+   */
+  isDirectory(path: Path): boolean;
+}

package/src/fs/contracts/filesystem-manager.contract.ts

@@ -0,0 +1,50 @@
+import { FileSystemNode, DirectoryNode, FileNode, FileSystemState, Path } from '@hamak/shared-utils';
+import { Action } from 'redux';
+
+/**
+ * Redux selector function type
+ */
+export type Selector<S, R> = (state: S) => R;
+
+/**
+ * Actions for filesystem operations
+ */
+export interface FileSystemNodeAction extends Action {
+  command: any // Will be typed more specifically in implementation
+}
+
+/**
+ * Parameters for filesystem node actions
+ */
+export interface FileSystemNodeActionParams {
+  override?: boolean
+  contentIsPresent?: boolean
+}
+
+/**
+ * Filesystem manager interface - manages Redux state for virtual filesystem
+ */
+export interface IFileSystemManager {
+  /**
+   * Get the slice name for this filesystem
+   */
+  readonly sliceName: string;
+
+  /**
+   * Get initial filesystem state
+   */
+  getInitialState(): FileSystemState;
+
+  /**
+   * Get the reducer function for filesystem operations
+   */
+  getReducer(): (state: FileSystemState, action: Action) => FileSystemState;
+
+  /**
+   * Create a selector for a specific path in the filesystem
+   */
+  createSelector<S>(
+    fileSystemSelector: Selector<S, FileSystemState | undefined>,
+    path: string | string[]
+  ): Selector<S, FileSystemNode | undefined>;
+}

package/src/fs/index.ts

@@ -0,0 +1,16 @@
+// Re-export filesystem types from shared-utils
+export type {
+  FileSystemNode,
+  DirectoryNode,
+  FileNode,
+  FileSystemNodeBase,
+  FileSystemNodeState,
+  FileMemoState,
+  FileSystemState,
+  FileContentSchema
+} from '@hamak/shared-utils';
+export { fileSystemNodeInitialState } from '@hamak/shared-utils';
+
+// Filesystem contracts
+export * from './contracts/filesystem-manager.contract';
+export * from './contracts/filesystem-facade.contract';

package/src/index.ts

@@ -6,3 +6,4 @@
 export * from './types';
 export * from './api';
 export * from './tokens';
+export * from './fs';