@hamak/ui-remote-resource 0.8.1 → 0.9.0

package/dist/api/actions/resource-action-factory.d.ts

@@ -1,4 +1,4 @@
-import type { ResourceCallRequestAction, ResourceCallSuccessAction, ResourceCallFailureAction, InvalidateResourceAction } from './resource-action-types.js';
+import type { ResourceCallRequestAction, ResourceCallSuccessAction, ResourceCallFailureAction, InvalidateResourceAction, RefreshResourceAction } from './resource-action-types.js';
 import type { ResourceOperation, ErrorObject } from '../types/resource-types.js';
 /**
  * Factory class for creating resource actions
@@ -36,5 +36,15 @@ export declare class ResourceActionFactory {
      * Create invalidate action
      */
     invalidate(path: string | string[]): InvalidateResourceAction;
+    /**
+     * Create a refresh action for a query-bound node.
+     *
+     * @param path - Stable path of the bound node to refresh
+     * @param paramsPatch - New/changed criteria (merged or replacing per `merge`)
+     * @param opts.merge - Merge the patch over stored params (default true)
+     */
+    refresh(path: string | string[], paramsPatch?: Record<string, any>, opts?: {
+        merge?: boolean;
+    }): RefreshResourceAction;
 }
 //# sourceMappingURL=resource-action-factory.d.ts.map

package/dist/api/actions/resource-action-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-action-factory.d.ts","sourceRoot":"","sources":["../../../src/api/actions/resource-action-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAU9E;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,iBAAiB,EAC5B,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAa5B;;OAEG;IACH,KAAK,CACH,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAI5B;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAI5B;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAI5B;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAI5B;;OAEG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,GAAG,GAAG,SAAS,EACzB,OAAO,EAAE,yBAAyB,GACjC,yBAAyB;IAc5B;;OAEG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,yBAAyB,GACjC,yBAAyB;IAa5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,wBAAwB;CAO9D"}
+{"version":3,"file":"resource-action-factory.d.ts","sourceRoot":"","sources":["../../../src/api/actions/resource-action-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAU9E;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,iBAAiB,EAC5B,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAa5B;;OAEG;IACH,KAAK,CACH,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAI5B;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAI5B;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAI5B;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,GAAG,EACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,EAAE,CAAC,EAAE,MAAM,GACV,yBAAyB;IAI5B;;OAEG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,GAAG,GAAG,SAAS,EACzB,OAAO,EAAE,yBAAyB,GACjC,yBAAyB;IAc5B;;OAEG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,yBAAyB,GACjC,yBAAyB;IAa5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,wBAAwB;IAQ7D;;;;;;OAMG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,qBAAqB;CAWzB"}

package/dist/api/actions/resource-action-factory.js

@@ -90,4 +90,22 @@ export class ResourceActionFactory {
             payload: { path }
         };
     }
+    /**
+     * Create a refresh action for a query-bound node.
+     *
+     * @param path - Stable path of the bound node to refresh
+     * @param paramsPatch - New/changed criteria (merged or replacing per `merge`)
+     * @param opts.merge - Merge the patch over stored params (default true)
+     */
+    refresh(path, paramsPatch, opts) {
+        return {
+            type: Types.REFRESH_RESOURCE,
+            id: generateId(),
+            payload: {
+                path,
+                paramsPatch,
+                merge: opts?.merge ?? true
+            }
+        };
+    }
 }

package/dist/api/actions/resource-action-types.d.ts

@@ -6,7 +6,8 @@ export declare enum ResourceActionTypes {
     RESOURCE_CALL_REQUEST = "@@resource/CALL_REQUEST",
     RESOURCE_CALL_SUCCESS = "@@resource/CALL_SUCCESS",
     RESOURCE_CALL_FAILURE = "@@resource/CALL_FAILURE",
-    INVALIDATE_RESOURCE = "@@resource/INVALIDATE"
+    INVALIDATE_RESOURCE = "@@resource/INVALIDATE",
+    REFRESH_RESOURCE = "@@resource/REFRESH"
 }
 /**
  * Generic resource call request action
@@ -101,5 +102,29 @@ export interface InvalidateResourceAction {
         path: string | string[];
     };
 }
-export type ResourceAction = ResourceCallRequestAction | ResourceCallSuccessAction | ResourceCallFailureAction | InvalidateResourceAction;
+/**
+ * Refresh a query-bound resource node.
+ *
+ * Re-runs the query that produced the node at `path`, recovering its
+ * `endpointId` + previous params from the node's stored binding and re-issuing
+ * a fetch to the same path. Use to refresh a filtered listing when the user
+ * changes a criterion.
+ */
+export interface RefreshResourceAction {
+    type: ResourceActionTypes.REFRESH_RESOURCE;
+    id: string;
+    payload: {
+        /** Stable path of the bound node to refresh */
+        path: string | string[];
+        /** New/changed criteria to apply (see `merge`) */
+        paramsPatch?: Record<string, any>;
+        /**
+         * When true, shallow-merge `paramsPatch` over the node's stored params.
+         * When false, `paramsPatch` replaces them (falls back to stored params if
+         * no patch is given). Defaults to true.
+         */
+        merge?: boolean;
+    };
+}
+export type ResourceAction = ResourceCallRequestAction | ResourceCallSuccessAction | ResourceCallFailureAction | InvalidateResourceAction | RefreshResourceAction;
 //# sourceMappingURL=resource-action-types.d.ts.map

package/dist/api/actions/resource-action-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-action-types.d.ts","sourceRoot":"","sources":["../../../src/api/actions/resource-action-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;GAEG;AACH,oBAAY,mBAAmB;IAE7B,qBAAqB,4BAA4B;IAGjD,qBAAqB,4BAA4B;IACjD,qBAAqB,4BAA4B;IAGjD,mBAAmB,0BAA0B;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kBAAkB;IAClB,IAAI,EAAE,mBAAmB,CAAC,qBAAqB,CAAC;IAEhD,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,OAAO,EAAE;QACP,gCAAgC;QAChC,UAAU,EAAE,MAAM,CAAC;QAEnB,qBAAqB;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAE7B;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAEzB,8DAA8D;QAC9D,MAAM,CAAC,EAAE,GAAG,CAAC;KACd,CAAC;IAEF,wBAAwB;IACxB,IAAI,CAAC,EAAE;QACL,yBAAyB;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kBAAkB;IAClB,IAAI,EAAE,mBAAmB,CAAC,qBAAqB,CAAC;IAEhD,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,OAAO,EAAE;QACP,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC;QAEnB,qCAAqC;QACrC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAExB,oBAAoB;QACpB,IAAI,EAAE,GAAG,CAAC;QAEV,wBAAwB;QACxB,QAAQ,CAAC,EAAE,GAAG,CAAC;KAChB,CAAC;IAEF,6CAA6C;IAC7C,OAAO,EAAE,yBAAyB,CAAC;IAEnC,wBAAwB;IACxB,IAAI,CAAC,EAAE;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IAEF,8CAA8C;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kBAAkB;IAClB,IAAI,EAAE,mBAAmB,CAAC,qBAAqB,CAAC;IAEhD,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,OAAO,EAAE;QACP,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC;QAEnB,4CAA4C;QAC5C,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAExB,wBAAwB;QACxB,KAAK,EAAE,WAAW,CAAC;KACpB,CAAC;IAEF,6CAA6C;IAC7C,OAAO,EAAE,yBAAyB,CAAC;IAEnC,wBAAwB;IACxB,IAAI,CAAC,EAAE;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IAEF,8CAA8C;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,mBAAmB,CAAC,mBAAmB,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QACP,yBAAyB;QACzB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KACzB,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GACtB,yBAAyB,GACzB,yBAAyB,GACzB,yBAAyB,GACzB,wBAAwB,CAAC"}
+{"version":3,"file":"resource-action-types.d.ts","sourceRoot":"","sources":["../../../src/api/actions/resource-action-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;GAEG;AACH,oBAAY,mBAAmB;IAE7B,qBAAqB,4BAA4B;IAGjD,qBAAqB,4BAA4B;IACjD,qBAAqB,4BAA4B;IAGjD,mBAAmB,0BAA0B;IAG7C,gBAAgB,uBAAuB;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kBAAkB;IAClB,IAAI,EAAE,mBAAmB,CAAC,qBAAqB,CAAC;IAEhD,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,OAAO,EAAE;QACP,gCAAgC;QAChC,UAAU,EAAE,MAAM,CAAC;QAEnB,qBAAqB;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAE7B;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAEzB,8DAA8D;QAC9D,MAAM,CAAC,EAAE,GAAG,CAAC;KACd,CAAC;IAEF,wBAAwB;IACxB,IAAI,CAAC,EAAE;QACL,yBAAyB;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kBAAkB;IAClB,IAAI,EAAE,mBAAmB,CAAC,qBAAqB,CAAC;IAEhD,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,OAAO,EAAE;QACP,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC;QAEnB,qCAAqC;QACrC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAExB,oBAAoB;QACpB,IAAI,EAAE,GAAG,CAAC;QAEV,wBAAwB;QACxB,QAAQ,CAAC,EAAE,GAAG,CAAC;KAChB,CAAC;IAEF,6CAA6C;IAC7C,OAAO,EAAE,yBAAyB,CAAC;IAEnC,wBAAwB;IACxB,IAAI,CAAC,EAAE;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IAEF,8CAA8C;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kBAAkB;IAClB,IAAI,EAAE,mBAAmB,CAAC,qBAAqB,CAAC;IAEhD,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,OAAO,EAAE;QACP,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC;QAEnB,4CAA4C;QAC5C,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAExB,wBAAwB;QACxB,KAAK,EAAE,WAAW,CAAC;KACpB,CAAC;IAEF,6CAA6C;IAC7C,OAAO,EAAE,yBAAyB,CAAC;IAEnC,wBAAwB;IACxB,IAAI,CAAC,EAAE;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IAEF,8CAA8C;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,mBAAmB,CAAC,mBAAmB,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QACP,yBAAyB;QACzB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KACzB,CAAC;CACH;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC,gBAAgB,CAAC;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QACP,+CAA+C;QAC/C,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,kDAAkD;QAClD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAClC;;;;WAIG;QACH,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GACtB,yBAAyB,GACzB,yBAAyB,GACzB,yBAAyB,GACzB,wBAAwB,GACxB,qBAAqB,CAAC"}

package/dist/api/actions/resource-action-types.js

@@ -10,4 +10,6 @@ export var ResourceActionTypes;
     ResourceActionTypes["RESOURCE_CALL_FAILURE"] = "@@resource/CALL_FAILURE";
     // Invalidate cache
     ResourceActionTypes["INVALIDATE_RESOURCE"] = "@@resource/INVALIDATE";
+    // Refresh a bound node by re-running its query (optionally with new criteria)
+    ResourceActionTypes["REFRESH_RESOURCE"] = "@@resource/REFRESH";
 })(ResourceActionTypes || (ResourceActionTypes = {}));

package/dist/api/types/resource-attributes.d.ts

@@ -14,6 +14,13 @@ export interface RemoteResourceAttributes {
     expiresAt?: number;
     /** Endpoint ID that populated this file */
     endpointId?: string;
+    /**
+     * High-level params that produced this node (the "query binding").
+     * Persisted so the node can be re-fetched/refreshed with changed criteria —
+     * the endpoint's payloadMapper deterministically re-derives the wire query
+     * from these. See `ResourceActionFactory.refresh`.
+     */
+    params?: Record<string, any>;
     /** Resource-specific metadata */
     metadata?: {
         status?: number;

package/dist/api/types/resource-attributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-attributes.d.ts","sourceRoot":"","sources":["../../../src/api/types/resource-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IAEF,+BAA+B;IAC/B,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,yEAAyE;IACzE,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAEhB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"resource-attributes.d.ts","sourceRoot":"","sources":["../../../src/api/types/resource-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B,iCAAiC;IACjC,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IAEF,+BAA+B;IAC/B,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,yEAAyE;IACzE,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAEhB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B"}

package/dist/impl/index.d.ts

@@ -8,12 +8,17 @@ export { RestResourceProvider } from './providers/rest-resource-provider.js';
 export type { RestProviderConfig } from './providers/rest-resource-provider.js';
 export { MockResourceProvider } from './providers/mock-resource-provider.js';
 export type { MockProviderConfig, EndpointMockConfig, MockConfigMap, MockCallHistoryEntry } from './providers/mock-resource-provider.js';
+export { PlainHttpResourceProvider } from './providers/plain-http-resource-provider.js';
+export type { PlainHttpProviderConfig } from './providers/plain-http-resource-provider.js';
 export { ResourceRegistry } from './registry/resource-registry.js';
 export { EntityRegistry } from './registry/entity-registry.js';
 export { createResourceMiddleware } from './middleware/resource-middleware.js';
 export { createSyncMiddleware } from './middleware/sync-middleware.js';
 export { createEntityMiddleware } from './middleware/entity-middleware.js';
 export { createEntitySyncMiddleware } from './middleware/entity-sync-middleware.js';
+export { createRefreshMiddleware } from './middleware/refresh-middleware.js';
+export type { RefreshMiddlewareConfig } from './middleware/refresh-middleware.js';
+export { RequestSequencer, pathKey } from './middleware/request-sequencer.js';
 export type { FileSystemNodeActions } from '@hamak/ui-store-impl';
 export { ResourceAutosaveProvider } from './autosave/resource-autosave-provider.js';
 export type { ResourceAutosaveProviderConfig } from './autosave/resource-autosave-provider.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/impl/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AAGvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACrB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAGjF,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,YAAY,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/impl/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AAGvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,YAAY,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAGxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAG3E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,YAAY,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/impl/index.js

@@ -8,6 +8,7 @@ export { STORE_MANAGER_TOKEN, MIDDLEWARE_REGISTRY_TOKEN, STORE_EXTENSIONS_TOKEN
 // Built-in providers (exported for convenience and testing)
 export { RestResourceProvider } from './providers/rest-resource-provider.js';
 export { MockResourceProvider } from './providers/mock-resource-provider.js';
+export { PlainHttpResourceProvider } from './providers/plain-http-resource-provider.js';
 // Registry implementations (internal, but exported for testing)
 export { ResourceRegistry } from './registry/resource-registry.js';
 export { EntityRegistry } from './registry/entity-registry.js';
@@ -16,5 +17,7 @@ export { createResourceMiddleware } from './middleware/resource-middleware.js';
 export { createSyncMiddleware } from './middleware/sync-middleware.js';
 export { createEntityMiddleware } from './middleware/entity-middleware.js';
 export { createEntitySyncMiddleware } from './middleware/entity-sync-middleware.js';
+export { createRefreshMiddleware } from './middleware/refresh-middleware.js';
+export { RequestSequencer, pathKey } from './middleware/request-sequencer.js';
 // Autosave provider
 export { ResourceAutosaveProvider } from './autosave/resource-autosave-provider.js';

package/dist/impl/middleware/refresh-middleware.d.ts

@@ -0,0 +1,21 @@
+import type { Middleware } from 'redux';
+import { type ResourceAction } from '../../api/index.js';
+export interface RefreshMiddlewareConfig {
+    /**
+     * Read the file node at a path from the current root store state.
+     * Returns the node (with `state.extensionStates`) or undefined.
+     */
+    readNode: (state: any, path: string | string[]) => any | undefined;
+    /** Called when a refresh targets a node with no remote binding. */
+    onError?: (error: any, action: ResourceAction) => void;
+}
+/**
+ * Refresh middleware.
+ *
+ * Handles REFRESH_RESOURCE: recovers a node's stored query binding
+ * (`endpointId` + `params`) and re-issues a fetch to the SAME path with the
+ * (optionally merged) new criteria. The existing resource + sync middleware
+ * then re-fetch and overwrite the node content in place.
+ */
+export declare function createRefreshMiddleware<S = any>(config: RefreshMiddlewareConfig): Middleware<{}, S>;
+//# sourceMappingURL=refresh-middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-middleware.d.ts","sourceRoot":"","sources":["../../../src/impl/middleware/refresh-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAGnB,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,GAAG,GAAG,SAAS,CAAC;IAEnE,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACxD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,GAAG,EAC7C,MAAM,EAAE,uBAAuB,GAC9B,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CA2CnB"}

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

@@ -0,0 +1,34 @@
+import { ResourceActionTypes, ResourceActionFactory, REMOTE_RESOURCE_EXTENSION_KEY } from '../../api/index.js';
+import { Pathway } from '@hamak/navigation-utils';
+/**
+ * Refresh middleware.
+ *
+ * Handles REFRESH_RESOURCE: recovers a node's stored query binding
+ * (`endpointId` + `params`) and re-issues a fetch to the SAME path with the
+ * (optionally merged) new criteria. The existing resource + sync middleware
+ * then re-fetch and overwrite the node content in place.
+ */
+export function createRefreshMiddleware(config) {
+    const { readNode, onError } = config;
+    const actionFactory = new ResourceActionFactory();
+    return (store) => (next) => (action) => {
+        if (action.type !== ResourceActionTypes.REFRESH_RESOURCE) {
+            return next(action);
+        }
+        const result = next(action);
+        const { path, paramsPatch, merge } = action.payload;
+        const node = readNode(store.getState(), path);
+        const attrs = node?.state?.extensionStates?.[REMOTE_RESOURCE_EXTENSION_KEY];
+        if (!attrs?.endpointId) {
+            onError?.(new Error(`[ui-remote-resource] refresh: node at '${Pathway.of(path).toString()}' has no remote binding (was it fetched with a stable path?)`), action);
+            return result;
+        }
+        const prevParams = attrs.params ?? {};
+        const nextParams = merge === false
+            ? paramsPatch ?? prevParams
+            : { ...prevParams, ...(paramsPatch ?? {}) };
+        // Re-issue a fetch to the same node — resource + sync middleware do the rest.
+        store.dispatch(actionFactory.callRequest(attrs.endpointId, 'fetch', nextParams, path));
+        return result;
+    };
+}

package/dist/impl/middleware/request-sequencer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Per-path monotonic request sequencer.
+ *
+ * Guards against out-of-order responses when a node is re-fetched rapidly
+ * (e.g. a user flipping filters): each request to a path gets an increasing
+ * token, and a response is only applied if its token is still the latest one
+ * issued for that path. A slow earlier response therefore can't clobber a
+ * newer filter's result.
+ */
+export declare class RequestSequencer {
+    private readonly latest;
+    /** Issue the next token for a path key. */
+    next(key: string): number;
+    /** True if `token` is the most recent one issued for the path key. */
+    isCurrent(key: string, token: number): boolean;
+}
+/** Normalize a path (string or segments) to a stable map key. */
+export declare function pathKey(path: string | string[]): string;
+//# sourceMappingURL=request-sequencer.d.ts.map

package/dist/impl/middleware/request-sequencer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-sequencer.d.ts","sourceRoot":"","sources":["../../../src/impl/middleware/request-sequencer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD,2CAA2C;IAC3C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAMzB,sEAAsE;IACtE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;CAG/C;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAEvD"}

package/dist/impl/middleware/request-sequencer.js

@@ -0,0 +1,33 @@
+/**
+ * Per-path monotonic request sequencer.
+ *
+ * Guards against out-of-order responses when a node is re-fetched rapidly
+ * (e.g. a user flipping filters): each request to a path gets an increasing
+ * token, and a response is only applied if its token is still the latest one
+ * issued for that path. A slow earlier response therefore can't clobber a
+ * newer filter's result.
+ */
+export class RequestSequencer {
+    constructor() {
+        Object.defineProperty(this, "latest", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    /** Issue the next token for a path key. */
+    next(key) {
+        const token = (this.latest.get(key) ?? 0) + 1;
+        this.latest.set(key, token);
+        return token;
+    }
+    /** True if `token` is the most recent one issued for the path key. */
+    isCurrent(key, token) {
+        return (this.latest.get(key) ?? 0) === token;
+    }
+}
+/** Normalize a path (string or segments) to a stable map key. */
+export function pathKey(path) {
+    return Array.isArray(path) ? path.join('/') : path;
+}

package/dist/impl/middleware/resource-middleware.d.ts

@@ -1,9 +1,15 @@
 import type { Middleware } from 'redux';
 import { type ResourceAction } from '../../api/index.js';
+import { RequestSequencer } from './request-sequencer.js';
 export interface ResourceMiddlewareConfig {
     registry: any;
     onError?: (error: any, action: ResourceAction) => void;
     onSuccess?: (result: any, action: ResourceAction) => void;
+    /**
+     * Optional out-of-order guard. When provided, a response is dropped if a newer
+     * request to the same storage path was issued while it was in flight.
+     */
+    sequencer?: RequestSequencer;
 }
 /**
  * Resource middleware

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

@@ -1 +1 @@
-{"version":3,"file":"resource-middleware.d.ts","sourceRoot":"","sources":["../../../src/impl/middleware/resource-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAGnB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IACvD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAC9C,MAAM,EAAE,wBAAwB,GAC/B,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CA6EnB"}
+{"version":3,"file":"resource-middleware.d.ts","sourceRoot":"","sources":["../../../src/impl/middleware/resource-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAW,MAAM,qBAAqB,CAAC;AAGhE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IACvD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1D;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,GAAG,EAC9C,MAAM,EAAE,wBAAwB,GAC/B,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAwFnB"}

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

@@ -1,10 +1,11 @@
 import { ResourceActionTypes, ResourceActionFactory } from '../../api/index.js';
+import { pathKey } from './request-sequencer.js';
 /**
  * Resource middleware
  * Intercepts RESOURCE_CALL_REQUEST actions and executes API calls via providers
  */
 export function createResourceMiddleware(config) {
-    const { registry, onError, onSuccess } = config;
+    const { registry, onError, onSuccess, sequencer } = config;
     const actionFactory = new ResourceActionFactory();
     return (store) => (next) => async (action) => {
         // Only handle RESOURCE_CALL_REQUEST actions
@@ -15,9 +16,15 @@ export function createResourceMiddleware(config) {
         next(action);
         const requestAction = action;
         const { endpointId, operation, params, path } = requestAction.payload;
+        // Resolve the storage path and claim an ordering token up front, so a
+        // response that loses the race to a newer request to the same node is
+        // dropped instead of overwriting fresher content.
+        const endpointDef = registry.getEndpoint(endpointId);
+        const storagePath = determinePath(path, endpointDef, params, operation);
+        const key = pathKey(storagePath);
+        const token = sequencer?.next(key);
+        const isStale = () => sequencer !== undefined && token !== undefined && !sequencer.isCurrent(key, token);
         try {
-            // Lookup endpoint
-            const endpointDef = registry.getEndpoint(endpointId);
             if (!endpointDef) {
                 throw new Error(`Endpoint not found: ${endpointId}`);
             }
@@ -32,21 +39,24 @@ export function createResourceMiddleware(config) {
                 : { params }; // Default: just use params
             // Execute provider call
             const result = await provider.call(endpointDef.endpoint, callParams, operation);
+            // Drop the result if a newer request to the same node superseded it
+            if (isStale()) {
+                return;
+            }
             // Transform response (transformer receives entire action)
             const transformedData = endpointDef.responseTransformer
                 ? endpointDef.responseTransformer(result.data, result.metadata, requestAction)
                 : result.data;
-            // Determine storage path
-            const storagePath = determinePath(path, endpointDef, params, operation);
             // Dispatch success action
             const successAction = actionFactory.callSuccess(endpointId, storagePath, transformedData, result.metadata, requestAction);
             store.dispatch(successAction);
             onSuccess?.(result, requestAction);
         }
         catch (error) {
-            // Determine storage path for error state
-            const endpointDef = registry.getEndpoint(endpointId);
-            const storagePath = determinePath(path, endpointDef, params, operation);
+            // Drop a stale failure too, so it can't surface over newer content
+            if (isStale()) {
+                return;
+            }
             // Dispatch failure action
             const failureAction = actionFactory.callFailure(endpointId, storagePath, normalizeError(error), requestAction);
             store.dispatch(failureAction);
@@ -86,12 +96,17 @@ function generateFilename(params, operation) {
     return `${operation}-${Date.now()}`;
 }
 /**
- * Normalize error to consistent format
+ * Normalize error to consistent format.
+ *
+ * Handles both axios-shaped errors (`error.response.status` / `.data`) and
+ * plain-HTTP-shaped errors thrown by PlainHttpResourceProvider
+ * (`error.status` / `.body`), so `code` carries the HTTP status either way.
  */
 function normalizeError(error) {
+    const status = error.response?.status ?? error.status;
     return {
         message: error.message || 'Unknown error',
-        code: error.code || error.response?.status?.toString(),
-        details: error.response?.data || error
+        code: error.code ?? (status != null ? String(status) : undefined),
+        details: error.response?.data ?? error.body ?? error
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"sync-middleware.d.ts","sourceRoot":"","sources":["../../../src/impl/middleware/sync-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAOxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,SAAS,EAAE,qBAAqB,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAC1C,MAAM,EAAE,oBAAoB,GAC3B,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAwBnB"}
+{"version":3,"file":"sync-middleware.d.ts","sourceRoot":"","sources":["../../../src/impl/middleware/sync-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAQxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,SAAS,EAAE,qBAAqB,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAC1C,MAAM,EAAE,oBAAoB,GAC3B,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAwBnB"}

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

@@ -1,4 +1,4 @@
-import { ResourceActionTypes } from '../../api/index.js';
+import { ResourceActionTypes, REMOTE_RESOURCE_EXTENSION_KEY } from '../../api/index.js';
 import { Pathway } from '@hamak/navigation-utils';
 /**
  * Sync middleware
@@ -38,11 +38,13 @@ function handleRequestAction(store, action, fsActions) {
     if (parentSegments.length > 0) {
         store.dispatch(fsActions.mkdir(parentSegments, true));
     }
-    // Set loading state by creating file node with contentIsPresent=false
+    // Ensure the node exists (no-op if already present — keeps prior content for
+    // stale-while-revalidate), then flag it loading without clobbering content.
     store.dispatch(fsActions.setFile(path, null, 'xs:any', { override: false, contentIsPresent: false }));
+    store.dispatch(fsActions.setContentLoading(path, true));
 }
 function handleSuccessAction(store, action, fsActions) {
-    const { path, data } = action.payload;
+    const { path, data, endpointId, metadata } = action.payload;
     const { request } = action;
     // Normalize path using Pathway utility
     const pathway = Pathway.of(path);
@@ -55,10 +57,21 @@ function handleSuccessAction(store, action, fsActions) {
     // Set file content from remote (automatically sets contentLoaded=true and clears loading)
     // Schema should come from endpoint definition if available
     const schema = request.meta?.schema || 'xs:any';
-    // First ensure file exists with proper schema
+    // First ensure file exists with proper schema (override resets node state,
+    // clearing the loading flag set on the request)
     store.dispatch(fsActions.setFile(path, data, schema, { override: true, contentIsPresent: true }));
     // Then set content from remote to mark it as loaded from remote source
     store.dispatch(fsActions.setFileContent(path, data, true));
+    // Persist the query binding so the node can be refreshed later with new
+    // criteria (re-fetch via REFRESH_RESOURCE). setFile(override) above reset
+    // extension state, so this write must follow it.
+    store.dispatch(fsActions.setExtensionState(path, REMOTE_RESOURCE_EXTENSION_KEY, {
+        endpointId,
+        params: request?.payload?.params,
+        lastFetched: Date.now(),
+        lastOperation: request?.payload?.operation,
+        metadata
+    }));
 }
 function handleFailureAction(store, action, fsActions) {
     const { path, error } = action.payload;

package/dist/impl/plugin/resource-plugin-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-plugin-factory.d.ts","sourceRoot":"","sources":["../../../src/impl/plugin/resource-plugin-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AActD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,UAAU,qBAAqB;IAC7B,OAAO,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,UAAU,eAAe;IACvB,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;IACzB,KAAK,EAAE;QACL,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;KACvC,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAGD,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAC3D,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,oBAAyB,GAChC,YAAY,CAgId"}
+{"version":3,"file":"resource-plugin-factory.d.ts","sourceRoot":"","sources":["../../../src/impl/plugin/resource-plugin-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAiBtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,UAAU,qBAAqB;IAC7B,OAAO,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,UAAU,eAAe;IACvB,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;IACzB,KAAK,EAAE;QACL,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;KACvC,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAGD,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAC3D,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,oBAAyB,GAChC,YAAY,CAgKd"}

package/dist/impl/plugin/resource-plugin-factory.js

@@ -8,6 +8,9 @@ import { createResourceMiddleware } from '../middleware/resource-middleware.js';
 import { createSyncMiddleware } from '../middleware/sync-middleware.js';
 import { createEntityMiddleware } from '../middleware/entity-middleware.js';
 import { createEntitySyncMiddleware } from '../middleware/entity-sync-middleware.js';
+import { createRefreshMiddleware } from '../middleware/refresh-middleware.js';
+import { RequestSequencer } from '../middleware/request-sequencer.js';
+import { Pathway } from '@hamak/navigation-utils';
 // Dependency injection tokens (for local use)
 export const RESOURCE_REGISTRY_TOKEN = 'RESOURCE_REGISTRY';
 export const ENTITY_REGISTRY_TOKEN = 'ENTITY_REGISTRY';
@@ -67,22 +70,50 @@ export function createResourcePlugin(config = {}) {
                     }
                     const fsActions = fsAdapter.getActions();
                     const fsSliceName = fsAdapter.sliceName;
+                    // Shared per-path ordering guard for in-flight resource calls
+                    const sequencer = new RequestSequencer();
+                    // Read a node from the fs slice by path (for refresh binding lookup)
+                    const readNode = (state, path) => {
+                        const root = state?.[fsSliceName]?.root;
+                        if (!root) {
+                            return undefined;
+                        }
+                        return Pathway.of(path)
+                            .getSegments()
+                            .reduce((acc, step) => {
+                            if (!acc || acc.type === 'file') {
+                                return acc;
+                            }
+                            return acc.children?.[step];
+                        }, root);
+                    };
                     // Create middleware with FileSystemAdapter actions
                     const entityMiddleware = createEntityMiddleware({
                         entityRegistry,
                         fsSliceName,
                         onError: config.onError
                     });
+                    const refreshMiddleware = createRefreshMiddleware({
+                        readNode,
+                        onError: config.onError
+                    });
                     const resourceMiddleware = createResourceMiddleware({
                         registry: resourceRegistry,
                         onError: config.onError,
-                        onSuccess: config.onSuccess
+                        onSuccess: config.onSuccess,
+                        sequencer
                     });
                     const entitySyncMiddleware = createEntitySyncMiddleware();
                     const resourceSyncMiddleware = createSyncMiddleware({
                         fsActions
                     });
                     const middlewareRegistry = resolve(MIDDLEWARE_REGISTRY_TOKEN);
+                    middlewareRegistry.register({
+                        id: 'refresh-middleware',
+                        middleware: refreshMiddleware,
+                        priority: 120,
+                        plugin: 'ui-remote-resource'
+                    });
                     middlewareRegistry.register({
                         id: 'entity-middleware',
                         middleware: entityMiddleware,

package/dist/impl/providers/plain-http-resource-provider.d.ts

@@ -0,0 +1,51 @@
+import type { IResourceProvider, ResourceCallParams, ResourceCallResult, HttpMethod } from '../../spi/index.js';
+import type { ResourceOperation } from '../../api/index.js';
+/**
+ * Configuration for the plain HTTP resource provider
+ */
+export interface PlainHttpProviderConfig {
+    /** Base URL the endpoint paths are resolved against */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (uses AbortSignal.timeout when set) */
+    timeoutMs?: number;
+    /** Default headers applied to every request */
+    headers?: Record<string, string>;
+    /**
+     * Default HTTP verb per CRUD operation, used when the call doesn't specify
+     * `params.method`. Overrides the built-in CRUD mapping for the given ops.
+     */
+    methodMap?: Partial<Record<ResourceOperation, HttpMethod>>;
+    /**
+     * Last-chance hook to mutate the RequestInit before the call (auth, signing,
+     * etc.). Return a new init to replace it, or mutate in place and return void.
+     */
+    onRequest?: (req: RequestInit, url: string) => RequestInit | void;
+    /** Custom fetch implementation (tests / SSR). Defaults to globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Plain HTTP resource provider (provider type `'http'`).
+ *
+ * For endpoints that don't follow REST resource semantics — e.g. a data-listing
+ * / query API, a `POST /search` returning a collection, or an RPC-style call.
+ * The HTTP verb is decoupled from the CRUD `operation`: a `payloadMapper` can
+ * set `params.method` explicitly, so a "list" doesn't have to masquerade as a
+ * `create`. Zero dependencies — uses the native `fetch`/`URL`/`URLSearchParams`.
+ */
+export declare class PlainHttpResourceProvider implements IResourceProvider {
+    private readonly config;
+    readonly type = "http";
+    constructor(config?: PlainHttpProviderConfig);
+    call<TData = any>(endpoint: string, params: ResourceCallParams, operation: ResourceOperation): Promise<ResourceCallResult<TData>>;
+    /**
+     * Parse the response body by content type: JSON when the server says so,
+     * otherwise text. 204/empty bodies resolve to null.
+     */
+    private parseBody;
+    /**
+     * Build the request URL: substitute `:param` path placeholders, resolve
+     * against `baseUrl` when configured, then append serialized query params.
+     */
+    private buildUrl;
+}
+//# sourceMappingURL=plain-http-resource-provider.d.ts.map

package/dist/impl/providers/plain-http-resource-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-http-resource-provider.d.ts","sourceRoot":"","sources":["../../../src/impl/providers/plain-http-resource-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACX,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC,CAAC;IAE3D;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IAElE,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAaD;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IAGrD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,IAAI,UAAU;gBAEM,MAAM,GAAE,uBAA4B;IAE3D,IAAI,CAAC,KAAK,GAAG,GAAG,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IA8CrC;;;OAGG;YACW,SAAS;IAWvB;;;OAGG;IACH,OAAO,CAAC,QAAQ;CAgCjB"}

package/dist/impl/providers/plain-http-resource-provider.js

@@ -0,0 +1,112 @@
+/**
+ * Default CRUD→verb mapping, matching REST semantics so this provider is a
+ * drop-in for plain CRUD endpoints too.
+ */
+const DEFAULT_METHODS = {
+    fetch: 'GET',
+    create: 'POST',
+    update: 'PUT',
+    delete: 'DELETE'
+};
+/**
+ * Plain HTTP resource provider (provider type `'http'`).
+ *
+ * For endpoints that don't follow REST resource semantics — e.g. a data-listing
+ * / query API, a `POST /search` returning a collection, or an RPC-style call.
+ * The HTTP verb is decoupled from the CRUD `operation`: a `payloadMapper` can
+ * set `params.method` explicitly, so a "list" doesn't have to masquerade as a
+ * `create`. Zero dependencies — uses the native `fetch`/`URL`/`URLSearchParams`.
+ */
+export class PlainHttpResourceProvider {
+    constructor(config = {}) {
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: config
+        });
+        Object.defineProperty(this, "type", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'http'
+        });
+    }
+    async call(endpoint, params, operation) {
+        const method = params.method ??
+            this.config.methodMap?.[operation] ??
+            DEFAULT_METHODS[operation];
+        const url = this.buildUrl(endpoint, params.params, params.query);
+        const hasBody = method !== 'GET' && method !== 'HEAD' && params.body != null;
+        let init = {
+            method,
+            headers: {
+                ...(hasBody ? { 'Content-Type': 'application/json' } : {}),
+                ...this.config.headers,
+                ...params.headers
+            },
+            body: hasBody ? JSON.stringify(params.body) : undefined,
+            signal: this.config.timeoutMs
+                ? AbortSignal.timeout(this.config.timeoutMs)
+                : undefined
+        };
+        init = this.config.onRequest?.(init, url) ?? init;
+        const fetchImpl = this.config.fetchImpl ?? fetch;
+        const response = await fetchImpl(url, init);
+        if (!response.ok) {
+            const body = await response.text().catch(() => undefined);
+            throw Object.assign(new Error(`HTTP ${response.status} for ${method} ${url}`), { status: response.status, body });
+        }
+        const data = (await this.parseBody(response));
+        return {
+            data,
+            metadata: {
+                status: response.status,
+                headers: Object.fromEntries(response.headers)
+            }
+        };
+    }
+    /**
+     * Parse the response body by content type: JSON when the server says so,
+     * otherwise text. 204/empty bodies resolve to null.
+     */
+    async parseBody(response) {
+        if (response.status === 204) {
+            return null;
+        }
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            return response.json();
+        }
+        return response.text();
+    }
+    /**
+     * Build the request URL: substitute `:param` path placeholders, resolve
+     * against `baseUrl` when configured, then append serialized query params.
+     */
+    buildUrl(endpoint, pathParams, query) {
+        let url = endpoint;
+        if (pathParams) {
+            for (const [key, value] of Object.entries(pathParams)) {
+                url = url.replace(`:${key}`, encodeURIComponent(String(value)));
+            }
+        }
+        const base = this.config.baseUrl
+            ? new URL(url, this.config.baseUrl).toString()
+            : url;
+        if (!query) {
+            return base;
+        }
+        const search = new URLSearchParams();
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined && value !== null) {
+                search.append(key, String(value));
+            }
+        }
+        const qs = search.toString();
+        if (!qs) {
+            return base;
+        }
+        return `${base}${base.includes('?') ? '&' : '?'}${qs}`;
+    }
+}

package/dist/spi/providers/i-resource-provider.d.ts

@@ -1,4 +1,9 @@
 import type { ResourceOperation } from '../../api/index.js';
+/**
+ * HTTP method, for providers that talk plain HTTP and need the verb decoupled
+ * from CRUD intent (e.g. a non-REST listing API where a "fetch" is a POST).
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD';
 /**
  * Parameters extracted from action and mapped to API call
  */
@@ -11,6 +16,12 @@ export interface ResourceCallParams {
     headers?: Record<string, string>;
     /** Query parameters */
     query?: Record<string, any>;
+    /**
+     * Explicit HTTP method override, decoupled from the CRUD `operation`.
+     * Honored by plain-HTTP providers (e.g. `PlainHttpResourceProvider`); ignored
+     * by `RestResourceProvider`, which keeps its fixed CRUD→verb mapping.
+     */
+    method?: HttpMethod;
 }
 /**
  * Result from a resource provider call

package/dist/spi/providers/i-resource-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i-resource-provider.d.ts","sourceRoot":"","sources":["../../../src/spi/providers/i-resource-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,GAAG;IAC7C,oBAAoB;IACpB,IAAI,EAAE,KAAK,CAAC;IACZ,gDAAgD;IAChD,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,KAAK,GAAG,GAAG,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;CACvC"}
+{"version":3,"file":"i-resource-provider.d.ts","sourceRoot":"","sources":["../../../src/spi/providers/i-resource-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,GAAG;IAC7C,oBAAoB;IACpB,IAAI,EAAE,KAAK,CAAC;IACZ,gDAAgD;IAChD,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,KAAK,GAAG,GAAG,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;CACvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamak/ui-remote-resource",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "private": false,
   "type": "module",
   "description": "Remote resource management for microkernel-based applications",