@hamak/ui-store 0.8.1 → 0.9.1

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/fs/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,cAAc,EACd,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,iCAAiC,EAClC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACX,MAAM,qBAAqB,CAAC;AAG7B,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC"}

package/dist/api/fs/index.js

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

package/dist/impl/autosave/autosave-middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autosave-middleware.d.ts","sourceRoot":"","sources":["../../../src/impl/autosave/autosave-middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,OAAO,CAAC;AAElE,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAgFnB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,QAAQ,EAAE,yBAAyB,CAAC;IAEpC,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAExC,gCAAgC;IAChC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAEvC,kCAAkC;IAClC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAEjE,+BAA+B;IAC/B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClF;AAcD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,UAAU,CA6RZ"}
+{"version":3,"file":"autosave-middleware.d.ts","sourceRoot":"","sources":["../../../src/impl/autosave/autosave-middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,OAAO,CAAC;AAElE,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAgFnB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,QAAQ,EAAE,yBAAyB,CAAC;IAEpC,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAExC,gCAAgC;IAChC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAEvC,kCAAkC;IAClC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAEjE,+BAA+B;IAC/B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClF;AAcD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,UAAU,CA+RZ"}

package/dist/impl/autosave/autosave-middleware.js

@@ -7,6 +7,7 @@
  * 3. Delegates save operations to registered providers
  * 4. Handles retries on failure
  */
+import { resolvePermissions } from '@hamak/shared-utils';
 import { AutosaveActionTypes, autosaveActions, DEFAULT_AUTOSAVE_CONFIG, } from '../../api/index.js';
 import { resolveAutosaveConfig, getNodeAtPath, pathToKey, } from './autosave-config-resolver.js';
 /**
@@ -247,7 +248,9 @@ export function createAutosaveMiddleware(config) {
                 if (root) {
                     // Resolve config
                     const autosaveConfig = resolveAutosaveConfig(root, path, mergedDefaultConfig);
-                    if (autosaveConfig.enabled) {
+                    // Effective enable also requires the node to be writable — a
+                    // read-only node forces autosave off regardless of config.
+                    if (autosaveConfig.enabled && resolvePermissions(root, path).write) {
                         // Get node
                         const node = getNodeAtPath(root, path);
                         if (node) {

package/dist/impl/fs/commands/fs-commands.d.ts

@@ -1,11 +1,12 @@
 import { FileNode, FileSystemNode, FileSystemState, FileContentSchema } from '../../../api/index.js';
+import { type FileSystemNodePermissions } from '@hamak/shared-utils';
 import { StructureNodeCommand } from './structure-commands.js';
 import { DataUpdater } from '../utils/data-updater.js';
 /**
  * Base interface for filesystem commands
  */
 export interface FsCommandBase {
-    name: 'mkdir' | 'set-file' | 'remove' | 'update-file-content' | 'set-file-content' | 'set-extension-state';
+    name: 'mkdir' | 'set-file' | 'remove' | 'update-file-content' | 'set-file-content' | 'set-extension-state' | 'set-content-loading' | 'set-permissions';
     path: string | string[];
 }
 /**
@@ -57,10 +58,27 @@ export interface SetExtensionStateCommand extends FsCommandBase {
     key: string;
     state: Record<string, unknown>;
 }
+/**
+ * Set the loading flag on a file node without touching its content.
+ * Used for stale-while-revalidate refreshes (keep previous content visible
+ * while a new fetch is in flight). Setting loading=true clears any prior error.
+ */
+export interface SetContentLoadingCommand extends FsCommandBase {
+    name: 'set-content-loading';
+    loading: boolean;
+}
+/**
+ * Set (merge) client-side permissions on a node. Typically issued by the
+ * provider that loaded the node, reflecting the source's real ACL.
+ */
+export interface SetPermissionsCommand extends FsCommandBase {
+    name: 'set-permissions';
+    permissions: FileSystemNodePermissions;
+}
 /**
  * Union type for all filesystem commands
  */
-export type FileSystemCommand = MkdirCommand | RemoveCommand | SetFileCommand | UpdateFileContentCommand | SetFileContentCommand | SetExtensionStateCommand;
+export type FileSystemCommand = MkdirCommand | RemoveCommand | SetFileCommand | UpdateFileContentCommand | SetFileContentCommand | SetExtensionStateCommand | SetContentLoadingCommand | SetPermissionsCommand;
 export { pathSteps, parentPathSteps } from '@hamak/shared-utils';
 /**
  * Get filesystem node at path
@@ -79,6 +97,8 @@ export declare class FileSystemCommandHandler {
     private contentMayChange;
     private executeSetContentCommand;
     private executeSetExtensionState;
+    private executeSetContentLoading;
+    private executeSetPermissions;
     protected current<T = any>(o: T): T;
     protected original<T = any>(o: T): T | undefined;
 }

package/dist/impl/fs/commands/fs-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-commands.d.ts","sourceRoot":"","sources":["../../../../src/impl/fs/commands/fs-commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs-commands.d.ts","sourceRoot":"","sources":["../../../../src/impl/fs/commands/fs-commands.ts"],"names":[],"mappings":"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"}

package/dist/impl/fs/commands/fs-commands.js

@@ -1,5 +1,5 @@
 import { fileSystemNodeInitialState } from '../../../api/index.js';
-import { pathSteps } from '@hamak/shared-utils';
+import { pathSteps, resolvePermissions } from '@hamak/shared-utils';
 import { DataUpdater } from '../utils/data-updater.js';
 import { produce, current, isDraft, original } from 'immer';
 import { deepEqual } from '../utils/deep-equal.js';
@@ -69,6 +69,8 @@ export class FileSystemCommandHandler {
             case 'set-file-content': return this.executeSetContentCommand(state, command);
             case 'remove': return this.executeRemove(state, command);
             case 'set-extension-state': return this.executeSetExtensionState(state, command);
+            case 'set-content-loading': return this.executeSetContentLoading(state, command);
+            case 'set-permissions': return this.executeSetPermissions(state, command);
         }
     }
     executeMkdir(state, command) {
@@ -124,6 +126,11 @@ export class FileSystemCommandHandler {
                     && !(recursive === true)) {
                     return;
                 }
+                // Permission gate: node (with inheritance) must allow removal.
+                if (child !== undefined && !resolvePermissions(root, steps).remove) {
+                    console.warn(`Remove denied (read-only) at location`, path);
+                    return;
+                }
                 delete parentDir.children[last];
             }
         });
@@ -160,6 +167,11 @@ export class FileSystemCommandHandler {
             const fileNode = getFileSystemNode(root, path);
             if (fileNode !== undefined) {
                 if (fileNode.type === 'file') {
+                    // Permission gate: local edits require write (loads use fromRemote).
+                    if (!resolvePermissions(root, path).write) {
+                        console.warn(`Edit denied (read-only) at location`, path);
+                        return;
+                    }
                     this.contentCommandHandler.execute(fileNode, contentCommand);
                     this.contentMayChange(fileNode);
                 }
@@ -193,6 +205,12 @@ export class FileSystemCommandHandler {
             const fileNode = getFileSystemNode(root, path);
             if (fileNode !== undefined) {
                 if (fileNode.type === 'file') {
+                    // Permission gate: a local (non-remote) set requires write.
+                    // Remote loads (fromRemote) are always allowed.
+                    if (!fromRemote && !resolvePermissions(root, path).write) {
+                        console.warn(`Edit denied (read-only) at location`, path);
+                        return;
+                    }
                     fileNode.content = content;
                     if (fileNode.state === undefined) {
                         fileNode.state = fileSystemNodeInitialState(true);
@@ -245,6 +263,46 @@ export class FileSystemCommandHandler {
             }
         });
     }
+    executeSetContentLoading(state, command) {
+        const { path, loading } = command;
+        return produce(state, draft => {
+            const { root } = draft;
+            const node = getFileSystemNode(root, path);
+            if (node === undefined) {
+                console.warn(`No node found at location`, path);
+                return;
+            }
+            if (node.state === undefined) {
+                node.state = fileSystemNodeInitialState();
+            }
+            // Flip the loading flag without touching content. Starting a load clears
+            // any previous error so a retry doesn't surface a stale failure.
+            node.state.contentLoading = loading;
+            if (loading) {
+                node.state.contentLoadError = undefined;
+            }
+        });
+    }
+    executeSetPermissions(state, command) {
+        const { path, permissions } = command;
+        return produce(state, draft => {
+            const { root } = draft;
+            const node = getFileSystemNode(root, path);
+            if (node === undefined) {
+                console.warn(`No node found at location`, path);
+                return;
+            }
+            if (node.state === undefined) {
+                node.state = fileSystemNodeInitialState();
+            }
+            // Merge onto any existing permissions so a provider can set fields
+            // incrementally (e.g. { write: false } then { reason }).
+            node.state.permissions = {
+                ...node.state.permissions,
+                ...permissions
+            };
+        });
+    }
     current(o) {
         if (o === null || o === undefined) {
             return o;

package/dist/impl/fs/core/fs-adapter.d.ts

@@ -2,6 +2,7 @@ import { Action } from '@reduxjs/toolkit';
 import { FileSystemCommandHandler } from '../commands/fs-commands.js';
 import { FileSystemNode, FileSystemState, FileContentSchema, FileSystemNodeActionParams, FileSystemNodeAction, Selector } from '../../../api/index.js';
 import { StructureNodeCommand } from '../commands/structure-commands.js';
+import type { FileSystemNodePermissions } from '@hamak/shared-utils';
 /**
  * Factory function to create a FileSystemAdapter
  */
@@ -35,6 +36,8 @@ export declare class FileSystemNodeActions {
     private readonly _updateFileContentType;
     private readonly _setFileContentType;
     private readonly _setExtensionStateType;
+    private readonly _setContentLoadingType;
+    private readonly _setPermissionsType;
     private actionTypeSet;
     constructor(sliceName: string);
     get mkdirType(): string;
@@ -43,6 +46,8 @@ export declare class FileSystemNodeActions {
     get updateFileContentType(): string;
     get setFileContentType(): string;
     get setExtensionStateType(): string;
+    get setContentLoadingType(): string;
+    get setPermissionsType(): string;
     isFileSystemNodeAction(action: Action): action is FileSystemNodeAction;
     mkdir(path: string | string[], parents?: boolean, extensionStates?: Record<string, unknown>): FileSystemNodeAction;
     setFile(path: string | string[], content: any, schema: FileContentSchema, params?: FileSystemNodeActionParams): FileSystemNodeAction;
@@ -50,5 +55,17 @@ export declare class FileSystemNodeActions {
     setFileContent(path: string | string[], content: any, fromRemote?: boolean): FileSystemNodeAction;
     removeNode(path: string | string[], recursive?: boolean): FileSystemNodeAction;
     setExtensionState(path: string | string[], key: string, state: Record<string, unknown>): FileSystemNodeAction;
+    /**
+     * Set a file node's loading flag without altering its content.
+     * Enables stale-while-revalidate: keep the previous content visible while a
+     * re-fetch is in flight. Passing `true` also clears any prior load error.
+     */
+    setContentLoading(path: string | string[], loading: boolean): FileSystemNodeAction;
+    /**
+     * Set (merge) client-side permissions on a node. Absent permissions mean a
+     * node is fully permissive; providers use this to reflect a source's ACL
+     * (e.g. a read-only listing: `{ write: false, reason: 'Query result' }`).
+     */
+    setPermissions(path: string | string[], permissions: FileSystemNodePermissions): FileSystemNodeAction;
 }
 //# sourceMappingURL=fs-adapter.d.ts.map

package/dist/impl/fs/core/fs-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-adapter.d.ts","sourceRoot":"","sources":["../../../../src/impl/fs/core/fs-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs-adapter.d.ts","sourceRoot":"","sources":["../../../../src/impl/fs/core/fs-adapter.ts"],"names":[],"mappings":"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"}

package/dist/impl/fs/core/fs-adapter.js

@@ -122,6 +122,18 @@ export class FileSystemNodeActions {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "_setContentLoadingType", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_setPermissionsType", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "actionTypeSet", {
             enumerable: true,
             configurable: true,
@@ -134,13 +146,17 @@ export class FileSystemNodeActions {
         this._updateFileContentType = `${this.sliceName}/updateFileContent`;
         this._setFileContentType = `${this.sliceName}/setFileContent`;
         this._setExtensionStateType = `${this.sliceName}/setExtensionState`;
+        this._setContentLoadingType = `${this.sliceName}/setContentLoading`;
+        this._setPermissionsType = `${this.sliceName}/setPermissions`;
         this.actionTypeSet = new Set([
             this._mkdirType,
             this._setFileType,
             this._removeType,
             this._updateFileContentType,
             this._setFileContentType,
-            this._setExtensionStateType
+            this._setExtensionStateType,
+            this._setContentLoadingType,
+            this._setPermissionsType
         ]);
     }
     get mkdirType() {
@@ -161,6 +177,12 @@ export class FileSystemNodeActions {
     get setExtensionStateType() {
         return this._setExtensionStateType;
     }
+    get setContentLoadingType() {
+        return this._setContentLoadingType;
+    }
+    get setPermissionsType() {
+        return this._setPermissionsType;
+    }
     isFileSystemNodeAction(action) {
         return this.actionTypeSet.has(action.type);
     }
@@ -201,4 +223,26 @@ export class FileSystemNodeActions {
             command: { name: 'set-extension-state', path, key, state }
         };
     }
+    /**
+     * Set a file node's loading flag without altering its content.
+     * Enables stale-while-revalidate: keep the previous content visible while a
+     * re-fetch is in flight. Passing `true` also clears any prior load error.
+     */
+    setContentLoading(path, loading) {
+        return {
+            type: this.setContentLoadingType,
+            command: { name: 'set-content-loading', path, loading }
+        };
+    }
+    /**
+     * Set (merge) client-side permissions on a node. Absent permissions mean a
+     * node is fully permissive; providers use this to reflect a source's ACL
+     * (e.g. a read-only listing: `{ write: false, reason: 'Query result' }`).
+     */
+    setPermissions(path, permissions) {
+        return {
+            type: this.setPermissionsType,
+            command: { name: 'set-permissions', path, permissions }
+        };
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamak/ui-store",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "private": false,
   "type": "module",
   "description": "Redux store management for microkernel-based applications",