@genesislcap/foundation-comms 15.0.0 → 15.1.0-GENC-1461.6

package/dist/dts/connect/http.d.ts

@@ -10,6 +10,14 @@ export interface HttpRequestInit extends RequestInit {
      * This can be used to transform the request body to a specific format such as JSON or XML.
      */
     serializer?: JSONSerializer;
+    /**
+     * Optional hook invoked with the raw `Response` before its body is deserialized.
+     * @remarks
+     * Use it to read response metadata the deserialized body omits — for example the HTTP status
+     * code or headers such as `ETag` and `Cache-Control`. Only read metadata here; the body is
+     * consumed by the deserializer afterwards.
+     */
+    onResponse?: (response: Response) => void;
 }
 /**
  * An interface representing an HTTP client that can make GET and POST requests and return a promise with the response data.
@@ -29,6 +37,14 @@ export interface HttpError extends Error {
 }
 /**
  * The default implementation of the Http interface.
+ *
+ * @remarks
+ * Caching is delegated to the browser's HTTP cache. Requests use the default `fetch` cache mode, so
+ * a response carrying an `ETag` (and a storable `Cache-Control`) is cached, revalidated with
+ * `If-None-Match`, and replayed by the browser automatically — the client keeps no cache of its own.
+ * Callers that send their own conditional headers receive the raw `304 Not Modified` (resolved as no
+ * body) instead of an error, and can inspect any response via {@link HttpRequestInit.onResponse}.
+ *
  * @public
  */
 export declare class DefaultHttp implements Http {
@@ -36,6 +52,7 @@ export declare class DefaultHttp implements Http {
     constructor(serializer: JSONSerializer);
     get<T>(url: string, requestInit: HttpRequestInit): Promise<T>;
     post<T>(url: string, requestInit: HttpRequestInit): Promise<T>;
+    private handleResponse;
 }
 /**
  * The DI token for the Http interface.

package/dist/dts/connect/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/connect/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACtE;AAED;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AASD;;;GAGG;AACH,qBAAa,WAAY,YAAW,IAAI;IACV,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,cAAc;IAEjD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IAkB7D,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;CAiB5E;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,4DAA4D,CAAC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/connect/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACtE;AAED;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,YAAW,IAAI;IACV,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,cAAc;IAEjD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IAU7D,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC;YAU7D,cAAc;CAkB7B;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,4DAA4D,CAAC"}

package/dist/esm/connect/http.js

@@ -7,8 +7,18 @@ function createHttpError(response) {
     error.message = response.statusText;
     return error;
 }
+/** HTTP status for a successful conditional request whose resource is unchanged. */
+const HTTP_STATUS_NOT_MODIFIED = 304;
 /**
  * The default implementation of the Http interface.
+ *
+ * @remarks
+ * Caching is delegated to the browser's HTTP cache. Requests use the default `fetch` cache mode, so
+ * a response carrying an `ETag` (and a storable `Cache-Control`) is cached, revalidated with
+ * `If-None-Match`, and replayed by the browser automatically — the client keeps no cache of its own.
+ * Callers that send their own conditional headers receive the raw `304 Not Modified` (resolved as no
+ * body) instead of an error, and can inspect any response via {@link HttpRequestInit.onResponse}.
+ *
  * @public
  */
 let DefaultHttp = class DefaultHttp {
@@ -18,24 +28,29 @@ let DefaultHttp = class DefaultHttp {
     get(url, requestInit) {
         return __awaiter(this, void 0, void 0, function* () {
             const response = yield fetch(url, Object.assign(Object.assign({ credentials: 'include', headers: { 'Content-type': 'application/json; charset=UTF-8' } }, requestInit), { method: 'GET' }));
-            if (response.redirected) {
-                window.location.href = response.url;
-                return new Promise(() => { });
-            }
-            if (!response.ok) {
-                throw createHttpError(response);
-            }
-            const serializer = requestInit.serializer || this.serializer;
-            return serializer.deserialize(response);
+            return this.handleResponse(response, requestInit);
         });
     }
     post(url, requestInit) {
         return __awaiter(this, void 0, void 0, function* () {
             const response = yield fetch(url, Object.assign(Object.assign({ credentials: 'include', headers: { 'Content-type': 'application/json; charset=UTF-8' } }, requestInit), { method: 'POST' }));
+            return this.handleResponse(response, requestInit);
+        });
+    }
+    handleResponse(response, requestInit) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             if (response.redirected) {
                 window.location.href = response.url;
                 return new Promise(() => { });
             }
+            // Expose response metadata (status, headers such as ETag) before the body is consumed.
+            (_a = requestInit.onResponse) === null || _a === void 0 ? void 0 : _a.call(requestInit, response);
+            // 304 Not Modified is a successful conditional response with no body; surface it via
+            // onResponse rather than treating it as an error, and return no data.
+            if (response.status === HTTP_STATUS_NOT_MODIFIED) {
+                return undefined;
+            }
             if (!response.ok) {
                 throw createHttpError(response);
             }

package/dist/foundation-comms.api.json

@@ -17878,7 +17878,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/foundation-comms!DefaultHttp:class",
-          "docComment": "/**\n * The default implementation of the Http interface.\n *\n * @public\n */\n",
+          "docComment": "/**\n * The default implementation of the Http interface.\n *\n * @remarks\n *\n * Caching is delegated to the browser's HTTP cache. Requests use the default `fetch` cache mode, so a response carrying an `ETag` (and a storable `Cache-Control`) is cached, revalidated with `If-None-Match`, and replayed by the browser automatically — the client keeps no cache of its own. Callers that send their own conditional headers receive the raw `304 Not Modified` (resolved as no body) instead of an error, and can inspect any response via {@link HttpRequestInit.onResponse}.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -27883,6 +27883,42 @@
           "name": "HttpRequestInit",
           "preserveMemberOrder": false,
           "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-comms!HttpRequestInit#onResponse:member",
+              "docComment": "/**\n * Optional hook invoked with the raw `Response` before its body is deserialized.\n *\n * @remarks\n *\n * Use it to read response metadata the deserialized body omits — for example the HTTP status code or headers such as `ETag` and `Cache-Control`. Only read metadata here; the body is consumed by the deserializer afterwards.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "onResponse?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(response: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Response",
+                  "canonicalReference": "!Response:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ") => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "onResponse",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 4
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/foundation-comms!HttpRequestInit#serializer:member",

package/dist/foundation-comms.d.ts

@@ -2175,6 +2175,14 @@ export declare const defaultGenesisResourcesConfig: GenesisResourcesConfig;
 
 /**
  * The default implementation of the Http interface.
+ *
+ * @remarks
+ * Caching is delegated to the browser's HTTP cache. Requests use the default `fetch` cache mode, so
+ * a response carrying an `ETag` (and a storable `Cache-Control`) is cached, revalidated with
+ * `If-None-Match`, and replayed by the browser automatically — the client keeps no cache of its own.
+ * Callers that send their own conditional headers receive the raw `304 Not Modified` (resolved as no
+ * body) instead of an error, and can inspect any response via {@link HttpRequestInit.onResponse}.
+ *
  * @public
  */
 export declare class DefaultHttp implements Http {
@@ -2182,6 +2190,7 @@ export declare class DefaultHttp implements Http {
     constructor(serializer: JSONSerializer);
     get<T>(url: string, requestInit: HttpRequestInit): Promise<T>;
     post<T>(url: string, requestInit: HttpRequestInit): Promise<T>;
+    private handleResponse;
 }
 
 /**
@@ -3373,6 +3382,14 @@ export declare interface HttpRequestInit extends RequestInit {
      * This can be used to transform the request body to a specific format such as JSON or XML.
      */
     serializer?: JSONSerializer;
+    /**
+     * Optional hook invoked with the raw `Response` before its body is deserialized.
+     * @remarks
+     * Use it to read response metadata the deserialized body omits — for example the HTTP status
+     * code or headers such as `ETag` and `Cache-Control`. Only read metadata here; the body is
+     * consumed by the deserializer afterwards.
+     */
+    onResponse?: (response: Response) => void;
 }
 
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-comms",
   "description": "Genesis Foundation UI Comms",
-  "version": "15.0.0",
+  "version": "15.1.0-GENC-1461.6",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -77,24 +77,24 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.0.0",
-    "@genesislcap/genx": "15.0.0",
-    "@genesislcap/rollup-builder": "15.0.0",
-    "@genesislcap/ts-builder": "15.0.0",
-    "@genesislcap/uvu-playwright-builder": "15.0.0",
-    "@genesislcap/vite-builder": "15.0.0",
-    "@genesislcap/webpack-builder": "15.0.0",
+    "@genesislcap/foundation-testing": "15.1.0-GENC-1461.6",
+    "@genesislcap/genx": "15.1.0-GENC-1461.6",
+    "@genesislcap/rollup-builder": "15.1.0-GENC-1461.6",
+    "@genesislcap/ts-builder": "15.1.0-GENC-1461.6",
+    "@genesislcap/uvu-playwright-builder": "15.1.0-GENC-1461.6",
+    "@genesislcap/vite-builder": "15.1.0-GENC-1461.6",
+    "@genesislcap/webpack-builder": "15.1.0-GENC-1461.6",
     "@types/js-cookie": "^3.0.2",
     "@types/json-schema": "^7.0.11",
     "@types/webappsec-credential-management": "^0.6.2",
     "sinon": "^17.0.1"
   },
   "dependencies": {
-    "@genesislcap/foundation-broadcast-channel": "15.0.0",
-    "@genesislcap/foundation-logger": "15.0.0",
-    "@genesislcap/foundation-user": "15.0.0",
-    "@genesislcap/foundation-utils": "15.0.0",
-    "@genesislcap/web-core": "15.0.0",
+    "@genesislcap/foundation-broadcast-channel": "15.1.0-GENC-1461.6",
+    "@genesislcap/foundation-logger": "15.1.0-GENC-1461.6",
+    "@genesislcap/foundation-user": "15.1.0-GENC-1461.6",
+    "@genesislcap/foundation-utils": "15.1.0-GENC-1461.6",
+    "@genesislcap/web-core": "15.1.0-GENC-1461.6",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.50.0",
     "bowser": "^2.11.0",
@@ -112,5 +112,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "035852ede9f26ea4434f1b3dfaff98db41490246"
+  "gitHead": "fe4c3b94eb819877d8a0a9879743e6070548bf34"
 }