@sitecore-feaas/clientside 0.5.4 → 0.5.5

package/src/dom/stylesheet.ts

@@ -17,23 +17,25 @@ export function renderStylesheetPromise(props: FEAASCDNStylesheetProps, styleshe
   }).then(() => stylesheet)
 }
 
+const validatedStylesheets = new WeakSet<HTMLStyleElement | HTMLLinkElement>()
 export function loadStylesheet(props: FEAASCDNStylesheetProps, callback?: ValidatableStylesheetCallback) {
-  var foundStylesheet = findStylesheet(props) as HTMLStyleElement
-  if (!foundStylesheet) {
-    var createdStylesheet = createStylesheet(props)
-  } else {
-    if (foundStylesheet.tagName == 'LINK') {
-      callback(null, 'initial')
-      return Promise.resolve(foundStylesheet)
-    }
+  var foundStylesheet: HTMLStyleElement | HTMLLinkElement
+  var writableStylesheet: HTMLStyleElement
+
+  if (foundStylesheet && validatedStylesheets.has(foundStylesheet)) {
+    return Promise.resolve(foundStylesheet)
   }
 
   return fetchAndRevalidateStylesheet(props, (cssText, phase) => {
-    if (createdStylesheet) {
-      createdStylesheet.textContent = cssText
+    foundStylesheet ||= findStylesheet(props)
+    // dont need to write stylesheet for cached state if we already found a stylesheet
+    if (!(phase == 'initial' && foundStylesheet)) {
+      writableStylesheet ||=
+        !foundStylesheet || foundStylesheet.tagName == 'LINK' ? createStylesheet(props) : foundStylesheet
+      writableStylesheet.textContent = cssText
     }
     callback?.(cssText, phase)
-  }).then(() => foundStylesheet || createdStylesheet)
+  }).then(() => foundStylesheet || writableStylesheet)
 }
 
 export function loadStylesheetAllowStale(props: FEAASCDNStylesheetProps) {
@@ -43,10 +45,10 @@ export function loadStylesheetAllowStale(props: FEAASCDNStylesheetProps) {
 }
 
 export function findStylesheet(props: FEAASCDNStylesheetProps) {
-  return (
-    document.head.querySelector(`style[data-href="${getStylesheetURL(props)}"]`) ||
-    document.querySelector(`link[rel="stylesheet"][href="${getStylesheetURL(props)}"]`)
-  )
+  return (document.head.querySelector(`style[data-href="${getStylesheetURL(props)}"]`) ||
+    document.querySelector(`link[rel="stylesheet"][href="${getStylesheetURL(props)}"]`)) as
+    | HTMLStyleElement
+    | HTMLLinkElement
 }
 
 export function createStylesheet(props: FEAASCDNStylesheetProps) {

package/src/fetch.ts

@@ -68,6 +68,22 @@ export function getFetchCache(url: Parameters<typeof fetch>[0], dontCreate = fal
 
 export class InvalidResponse extends Error {}
 
+/**
+ * Executes a fetch request optionally validating and handling the response. Using callback function it's possible to
+ * observe successful response twice: Cached version first, and up-to-date later.
+ *
+ * @param {Object}                  request              - An object containing request parameters.
+ * @param {string}                  request.url          - The URL to fetch.
+ * @param {Object}                  request.options      - Fetch request options.
+ * @param {Function}                [request.validator]  - Function to validate the response. Should return `false` if
+ *                                                       validation fails.
+ * @param {Function}                [request.callback]   - Function to execute after fetching. Receives the response,
+ *                                                       phase, and cache status.
+ * @param {Object}                  [request.cache]      - Cache object to store or retrieve cached data.
+ * @param {ValidatableRequestPhase} [phase='initial']    - The phase of the request, defaults to 'initial'.
+ * @returns {Promise<Object>} A promise that resolves to an object containing request details and the response.
+ * @throws {Error} Throws an error if the fetch fails or if the response is not valid according to the validator.
+ */
 export async function fetchWithCacheAwareness(
   { url, options, validator, callback, cache }: ValidatableRequest,
   phase: ValidatableRequestPhase = 'initial'
@@ -107,6 +123,14 @@ export async function fetchWithCacheAwareness(
   }
 }
 
+/**
+ * Validates cache of previousl fetch If the resource is cached and there is a newer version available, it will be
+ * re-fetched.
+ *
+ * @param request  - The request object containing the URL, cache information, options, validator, and response of
+ *                 initial request.
+ * @returns A promise that resolves to the request object.
+ */
 export async function fetchToValidateCache(
   request: ValidatableRequest & Required<Pick<ValidatableRequest, 'response'>>
 ) {
@@ -129,7 +153,7 @@ export async function fetchToValidateCache(
 
     // there's a newer version of the file that we may fetch
     if (head.headers.get('last-modified') != response.headers.get('last-modified')) {
-      // otherwise the new resource has to be re-fetched
+      // the new resource has to be re-fetched
       return fetchBypassingCache(request)
     }
   }

package/src/utils/settings.ts

@@ -52,7 +52,7 @@ export function clean(settings: any) {
  * @returns {boolean} - True if the data is of type DataSettings, false otherwise.
  */
 export const isDataSettings = (data: any): data is DataSettings => {
-  if (typeof data.url != 'string') return false
+  if (!data || typeof data.url != 'string') return false
 
   for (var property in data) {
     if (

package/test/FEAASComponent.test.tsx

@@ -25,7 +25,7 @@ describe('Components', () => {
     const spy = vi.spyOn(global, 'fetch')
     spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
       if (url.match('CDN/components/L/C/V/R')) {
-        return new Response('TODAY', {
+        return new Response('FRESH', {
           headers: {
             date: now.toUTCString(),
             'last-modified': earlier.toUTCString()
@@ -43,7 +43,7 @@ describe('Components', () => {
     await expect(component.whenRendered).resolves.toEqual(component)
     expect(spy).toHaveBeenCalledTimes(1)
 
-    expect(component.innerHTML).toContain('TODAY')
+    expect(component.innerHTML).toContain('FRESH')
   })
 
   describe('fetch control', () => {
@@ -116,7 +116,7 @@ describe('Components', () => {
       const spy = vi.spyOn(global, 'fetch')
       spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
         if (url.match('CDN/components/L/C/V/R')) {
-          return new Response('TODAY', {
+          return new Response('FRESH', {
             headers: {
               date: now.toUTCString(),
               'last-modified': earlier.toUTCString()
@@ -139,7 +139,7 @@ describe('Components', () => {
 
       await expect(component.whenRendered).resolves.toEqual(component)
       expect(spy).toHaveBeenCalledTimes(2)
-      expect(component.innerHTML).toBe('TODAY')
+      expect(component.innerHTML).toBe('FRESH')
       expect(document.head.querySelectorAll('style').length).toEqual(1)
     })
     it('should make data/css requests when fetch="stylesheet data"', async () => {
@@ -208,7 +208,7 @@ describe('Components', () => {
     const spy = vi.spyOn(global, 'fetch')
     spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
       if (url.match('http://a/components/b/c/d/1.html')) {
-        return new Response('TODAY', {
+        return new Response('FRESH', {
           headers: {
             date: now.toUTCString(),
             'last-modified': earlier.toUTCString()
@@ -226,7 +226,7 @@ describe('Components', () => {
     expect(spy).toHaveBeenCalledTimes(1)
 
     expect(component.outerHTML).toBe(
-      `<feaas-component fetch="template data" src="http://a/components/b/c/d/1.html" cdn="http://a" library="b" component="c" version="d" revision="1" class="-feaas">TODAY</feaas-component>`
+      `<feaas-component fetch="template data" src="http://a/components/b/c/d/1.html" cdn="http://a" library="b" component="c" version="d" revision="1" class="-feaas">FRESH</feaas-component>`
     )
   })
 
@@ -234,7 +234,7 @@ describe('Components', () => {
     const spy = vi.spyOn(global, 'fetch')
     spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
       if (url.match('http://a/components/b/c/d/1.html')) {
-        return new Response('TODAY', {
+        return new Response('FRESH', {
           headers: {
             date: now.toUTCString(),
             'last-modified': earlier.toUTCString()
@@ -260,16 +260,63 @@ describe('Components', () => {
     expect(document.head.querySelectorAll('style')[1].getAttribute('data-href')).toBe('http://a/styles/b/staged.css')
   })
 
-  it('should render component if stylesheet is statically embedded as link', async () => {
+  it('should validate stylesheet when included as link before rendering component', async () => {
     const spy = vi.spyOn(global, 'fetch')
     spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
       if (url.match('http://a/components/b/c/d/1.html')) {
-        return new Response('TODAY', {
+        return new Response('FRESH', {
           headers: {
             date: now.toUTCString(),
             'last-modified': earlier.toUTCString()
           }
         })
+      } else if (url.match('.css')) {
+        return new Response('FRESH', {
+          headers: {
+            date: /*String(options?.method).toLowerCase() == 'head' ? */ now.toUTCString(),
+            'last-modified': earlier.toUTCString()
+          }
+        })
+      }
+    })
+
+    document.body.innerHTML =
+      '<feaas-component src="http://a/components/b/c/d/1.html"></feaas-component><link rel="stylesheet" href="http://a/styles/b/published.css" />'
+
+    const component = document.body.firstElementChild as FEAASComponent
+    await expect(component.whenRendered).resolves.toEqual(component)
+    expect(spy).toHaveBeenCalledTimes(2)
+    expect(document.head.querySelectorAll('style').length).toBe(0)
+  })
+
+  it('should validate and re-write stylesheet when included as link before rendering component', async () => {
+    const spy = vi.spyOn(global, 'fetch')
+    spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
+      if (url.match('http://a/components/b/c/d/1.html')) {
+        return new Response('FRESH', {
+          headers: {
+            date: now.toUTCString(),
+            'last-modified': earlier.toUTCString()
+          }
+        })
+      } else if (url.match('.css')) {
+        if (!options?.cache) {
+          // respond with cached css
+          return new Response('CACHED', {
+            headers: {
+              date: earliest.toUTCString(),
+              'last-modified': earliest.toUTCString()
+            }
+          })
+        } else {
+          // respond with up to date
+          return new Response('CACHED', {
+            headers: {
+              date: now.toUTCString(),
+              'last-modified': earliest.toUTCString()
+            }
+          })
+        }
       }
     })
 
@@ -278,15 +325,65 @@ describe('Components', () => {
 
     const component = document.body.firstElementChild as FEAASComponent
     await expect(component.whenRendered).resolves.toEqual(component)
+    expect(spy).toHaveBeenCalledTimes(3)
+    // render with stale stylesheet
+    expect(document.head.querySelectorAll('style').length).toBe(0)
+    await new Promise((r) => setTimeout(r, 50))
+    expect(spy).toHaveBeenCalledTimes(3)
     expect(document.head.querySelectorAll('style').length).toBe(0)
   })
 
+  it('should validate and re-write stylesheet when included as link before rendering component', async () => {
+    const spy = vi.spyOn(global, 'fetch')
+    spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
+      if (url.match('http://a/components/b/c/d/1.html')) {
+        return new Response('FRESH', {
+          headers: {
+            date: now.toUTCString(),
+            'last-modified': earlier.toUTCString()
+          }
+        })
+      } else if (url.match('.css')) {
+        if (!options?.cache) {
+          // respond with cached css
+          return new Response('CACHED', {
+            headers: {
+              date: earliest.toUTCString(),
+              'last-modified': earliest.toUTCString()
+            }
+          })
+        } else {
+          if (String(options?.method).toLowerCase() == 'head') await new Promise((r) => setTimeout(r, 50))
+          // respond with up to date
+          return new Response('FRESH', {
+            headers: {
+              date: now.toUTCString(),
+              'last-modified': now.toUTCString()
+            }
+          })
+        }
+      }
+    })
+
+    document.body.innerHTML =
+      '<feaas-component src="http://a/components/b/c/d/1.html"></feaas-component><link rel="stylesheet" href="http://a/styles/b/published.css" />'
+
+    const component = document.body.firstElementChild as FEAASComponent
+    await expect(component.whenRendered).resolves.toEqual(component)
+    expect(spy).toHaveBeenCalledTimes(3)
+    // render with stale stylesheet
+    expect(document.head.querySelectorAll('style').length).toBe(0)
+    await new Promise((r) => setTimeout(r, 100))
+    expect(spy).toHaveBeenCalledTimes(4)
+    expect(document.head.querySelectorAll('style').length).toBe(1)
+  })
+
   it('should revalidate cached component response', async () => {
     const spy = vi.spyOn(global, 'fetch')
     spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
       if (url.match('CDN/components/L/C/V/R') && options.method != 'HEAD') {
         // 1. Here's cached component
-        return new Response('TODAY', {
+        return new Response('CACHED', {
           headers: {
             date: earlier.toUTCString(),
             'last-modified': earlier.toUTCString()
@@ -311,7 +408,7 @@ describe('Components', () => {
     await expect(component.whenRendered).resolves.toEqual(component)
     expect(spy).toHaveBeenCalledTimes(2)
 
-    expect(component.innerHTML).toContain('TODAY')
+    expect(component.innerHTML).toContain('CACHED')
   })
 
   it('should reload component while using stale cache', async () => {
@@ -335,7 +432,7 @@ describe('Components', () => {
         })
       } else {
         // Up to date version
-        return new Response('TODAY', {
+        return new Response('FRESH', {
           headers: {
             date: now.toUTCString(),
             'last-modified': earlier.toUTCString()
@@ -356,7 +453,7 @@ describe('Components', () => {
     // whenLoaded only fires when ensures that up-to-date version is loaded
     await expect(component.whenLoaded).resolves.toBeTruthy()
     expect(spy).toHaveBeenCalledTimes(3)
-    expect(component.innerHTML).toContain('TODAY')
+    expect(component.innerHTML).toContain('FRESH')
   })
 
   it('should re-fetch component when attributes change', async () => {
@@ -418,7 +515,7 @@ describe('Components', () => {
           })
         } else {
           await new Promise((resolve) => setTimeout(resolve, 200))
-          return new Response('TODAY {}', {
+          return new Response('FRESH {}', {
             headers: {
               date: now.toUTCString(),
               'last-modified': earlier.toUTCString()
@@ -445,7 +542,7 @@ describe('Components', () => {
         } else {
           //  Latest
           await new Promise((resolve) => setTimeout(resolve, 100))
-          return new Response('TODAY', {
+          return new Response('FRESH', {
             headers: {
               date: now.toUTCString(),
               'last-modified': earlier.toUTCString()
@@ -459,20 +556,20 @@ describe('Components', () => {
     const component = document.body.firstElementChild as FEAASComponent
     expect(document.head.querySelector('style')).toBeNull()
     await new Promise((resolve) => setTimeout(resolve, 50))
-    const stylesheet = document.head.querySelector('style') as HTMLStyleElement
-    expect(stylesheet.innerHTML).toEqual('')
+    expect(document.head.querySelector('style')).toBeNull()
     expect(component.innerHTML).toEqual('')
     // Component will rendered with stale cached stylesheet
     await expect(component.whenRendered).resolves.toEqual(component)
+    const stylesheet = document.head.querySelector('style') as HTMLStyleElement
     expect(stylesheet.innerHTML).toEqual('YESTERDAY {}')
     expect(component.innerHTML).toEqual('YESTERDAY')
     // Component will update itself with stale cached stylesheet
-    await expect(component.whenLoaded).resolves.toEqual('TODAY')
+    await expect(component.whenLoaded).resolves.toEqual('FRESH')
     expect(stylesheet.innerHTML).toEqual('YESTERDAY {}')
-    expect(component.innerHTML).toEqual('TODAY')
+    expect(component.innerHTML).toEqual('FRESH')
     await new Promise((resolve) => setTimeout(resolve, 200))
     // Stylesheet will update later
-    expect(stylesheet.innerHTML).toEqual('TODAY {}')
+    expect(stylesheet.innerHTML).toEqual('FRESH {}')
   })
 
   it('render without data', () => {

package/test/FEAASStylesheet.test.tsx

@@ -29,7 +29,7 @@ describe('Stylesheet', () => {
   it('should load stylesheet (cold cache)', async () => {
     const spy = vi.spyOn(global, 'fetch')
     spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
-      return new Response('TODAY {}', {
+      return new Response('FRESH {}', {
         headers: {
           date: now.toUTCString(),
           'last-modified': earlier.toUTCString()
@@ -44,13 +44,13 @@ describe('Stylesheet', () => {
     await expect(stylesheet.whenRendered).resolves.toEqual(stylesheet)
     expect(spy).toHaveBeenCalledTimes(1)
 
-    expect(document.head.querySelector('style').textContent).toContain('TODAY')
+    expect(document.head.querySelector('style').textContent).toContain('FRESH')
   })
   it('should load stylesheet with minimum parameters(cold cache)', async () => {
     const spy = vi.spyOn(global, 'fetch')
     spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
       if (url.match(DEFAULT_CDN_URL + '/styles/L/published.css'))
-        return new Response('TODAY {}', {
+        return new Response('FRESH {}', {
           headers: {
             date: now.toUTCString(),
             'last-modified': earlier.toUTCString()
@@ -65,14 +65,14 @@ describe('Stylesheet', () => {
     await expect(stylesheet.whenRendered).resolves.toEqual(stylesheet)
     expect(spy).toHaveBeenCalledTimes(1)
 
-    expect(document.head.querySelector('style').textContent).toContain('TODAY')
+    expect(document.head.querySelector('style').textContent).toContain('FRESH')
   })
 
   it('should invalidate stylesheet cache', async () => {
     const spy = vi.spyOn(global, 'fetch')
     spy.mockImplementation(async (url: string, options: Parameters<typeof fetch>[1] = {}) => {
       if (url.match('CDN/styles/L/published.css') && options?.method != 'HEAD') {
-        return new Response('TODAY {}', {
+        return new Response('FRESH {}', {
           headers: {
             date: earlier.toUTCString(),
             'last-modified': earlier.toUTCString()
@@ -95,7 +95,7 @@ describe('Stylesheet', () => {
     await expect(stylesheet.whenRendered).resolves.toEqual(stylesheet)
     expect(spy).toHaveBeenCalledTimes(2)
 
-    expect(document.head.querySelector('style').textContent).toContain('TODAY')
+    expect(document.head.querySelector('style').textContent).toContain('FRESH')
   })
   it('should update stylesheet while using stale cache', async () => {
     const spy = vi.spyOn(global, 'fetch')
@@ -117,7 +117,7 @@ describe('Stylesheet', () => {
           }
         })
       } else {
-        return new Response('TODAY {}', {
+        return new Response('FRESH {}', {
           headers: {
             date: now.toUTCString(),
             'last-modified': earlier.toUTCString()
@@ -137,7 +137,7 @@ describe('Stylesheet', () => {
     // whenLoaded only fires when ensures that up-to-date version is loaded
     await expect(stylesheet.whenLoaded).resolves.toBeTruthy()
     expect(spy).toHaveBeenCalledTimes(3)
-    expect(document.head.querySelector('style').textContent).toContain('TODAY {}')
+    expect(document.head.querySelector('style').textContent).toContain('FRESH {}')
   })
 
   it('should load stylesheet statically', async () => {
@@ -160,7 +160,7 @@ describe('Stylesheet', () => {
           }
         })
       } else {
-        return new Response('TODAY {}', {
+        return new Response('FRESH {}', {
           headers: {
             date: now.toUTCString(),
             'last-modified': earlier.toUTCString()
@@ -175,7 +175,9 @@ describe('Stylesheet', () => {
         library: 'L',
         revision: 'published'
       }).then((r) => r.textContent)
-    ).resolves.toEqual('TODAY {}')
-    await expect(loadStylesheet(`http://CDN/L/published.css`).then((r) => r.textContent)).resolves.toEqual('TODAY {}')
+    ).resolves.toEqual('FRESH {}')
+    await expect(loadStylesheet(`http://CDN/L/published.css`).then((r) => r.textContent)).resolves.toEqual('FRESH {}')
   })
+
+  it('should ')
 })

package/test/datasettings.test.ts

@@ -118,6 +118,98 @@ describe('DataSettings', () => {
       ])
     })
   })
+  describe('.isDataSettings', () => {
+    it('should return true if data has all the required properties', () => {
+      const data = {
+        url: 'https://example.com',
+        method: 'GET',
+        headers: { 'Content-Type': 'application/json' }
+      }
+
+      expect(DataSettings.isDataSettings(data)).toBe(true)
+    })
+
+    it('should return false if data does not have the "url" property', () => {
+      const data = {
+        method: 'GET',
+        headers: { 'Content-Type': 'application/json' }
+      }
+
+      expect(DataSettings.isDataSettings(data)).toBe(false)
+    })
+
+    it('should return false if data has an additional property apart from the allowed ones', () => {
+      const data = {
+        url: 'https://example.com',
+        method: 'GET',
+        headers: { 'Content-Type': 'application/json' },
+        invalidProperty: 'invalid'
+      }
+
+      expect(DataSettings.isDataSettings(data)).toBe(false)
+    })
+
+    it('should return false if "jsonpath" property is not a string', () => {
+      const data = {
+        url: 'https://example.com',
+        method: 'GET',
+        headers: { 'Content-Type': 'application/json' },
+        jsonpath: { invalid: 'value' }
+      }
+
+      expect(DataSettings.isDataSettings(data)).toBe(false)
+    })
+  })
+  describe('.hasDataSettings', () => {
+    it('should return false if data is falsy', () => {
+      expect(DataSettings.hasDataSettings(null)).toBe(false)
+      expect(DataSettings.hasDataSettings(undefined)).toBe(false)
+      expect(DataSettings.hasDataSettings({ test: null })).toBe(false)
+      expect(DataSettings.hasDataSettings({ test: undefined })).toBe(false)
+    })
+    it('should return true for simple case', () => {
+      expect(DataSettings.hasDataSettings({ test: { url: 'a' } })).toBe(true)
+      expect(DataSettings.hasDataSettings({ url: 'a' })).toBe(true)
+    })
+
+    it('should return true if data has a valid DataSettings object', () => {
+      const data = {
+        url: 'https://example.com',
+        method: 'GET',
+        headers: { 'Content-Type': 'application/json' }
+      }
+
+      expect(DataSettings.hasDataSettings(data)).toBe(true)
+      expect(DataSettings.hasDataSettings({ a: data })).toBe(true)
+    })
+
+    it('should return true if any property in data is a valid DataSettings object', () => {
+      const data = {
+        url: 'https://example.com',
+        method: 'GET',
+        headers: { 'Content-Type': 'application/json' },
+        nestedData: {
+          url: 'https://example.com/nested',
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' }
+        }
+      }
+
+      expect(DataSettings.hasDataSettings(data)).toBe(true)
+    })
+
+    it('should return false if all properties in data are invalid', () => {
+      const data = {
+        property1: 'value1',
+        property2: { invalid: 'object' },
+        property3: false
+      }
+
+      expect(DataSettings.hasDataSettings(data)).toBe(false)
+    })
+
+    // Add more test cases to cover other scenarios
+  })
   describe('.fetch', () => {
     it('fetches when passed data object', async () => {
       const result = await DataSettings.fetch({ hello: 'world' })

package/types/dom/stylesheet.d.ts

@@ -3,6 +3,6 @@ export declare function renderStylesheet(props: FEAASCDNStylesheetProps, style?:
 export declare function renderStylesheetPromise(props: FEAASCDNStylesheetProps, stylesheet?: HTMLStyleElement): Promise<HTMLStyleElement>;
 export declare function loadStylesheet(props: FEAASCDNStylesheetProps, callback?: ValidatableStylesheetCallback): Promise<HTMLStyleElement>;
 export declare function loadStylesheetAllowStale(props: FEAASCDNStylesheetProps): Promise<unknown>;
-export declare function findStylesheet(props: FEAASCDNStylesheetProps): Element;
+export declare function findStylesheet(props: FEAASCDNStylesheetProps): HTMLLinkElement | HTMLStyleElement;
 export declare function createStylesheet(props: FEAASCDNStylesheetProps): HTMLStyleElement;
 //# sourceMappingURL=stylesheet.d.ts.map

package/types/dom/stylesheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stylesheet.d.ts","sourceRoot":"","sources":["../../src/dom/stylesheet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAGvB,6BAA6B,EAC9B,MAAM,WAAW,CAAA;AAElB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,EAAE,KAAK,CAAC,EAAE,gBAAgB,oBAGxF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,uBAAuB,EAAE,UAAU,CAAC,EAAE,gBAAgB,6BAKpG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,uBAAuB,EAAE,QAAQ,CAAC,EAAE,6BAA6B,6BAiBtG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,oBAItE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,uBAAuB,WAK5D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,oBAM9D"}
+{"version":3,"file":"stylesheet.d.ts","sourceRoot":"","sources":["../../src/dom/stylesheet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAGvB,6BAA6B,EAC9B,MAAM,WAAW,CAAA;AAElB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,EAAE,KAAK,CAAC,EAAE,gBAAgB,oBAGxF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,uBAAuB,EAAE,UAAU,CAAC,EAAE,gBAAgB,6BAKpG;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,uBAAuB,EAAE,QAAQ,CAAC,EAAE,6BAA6B,6BAkBtG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,oBAItE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,uBAAuB,sCAK5D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,oBAM9D"}

package/types/fetch.d.ts

@@ -36,6 +36,22 @@ export declare function fetchAndRevalidate(url: ValidatableRequest['url'], optio
 export declare function getFetchCache(url: Parameters<typeof fetch>[0], dontCreate?: boolean): FetchCacheRequest;
 export declare class InvalidResponse extends Error {
 }
+/**
+ * Executes a fetch request optionally validating and handling the response. Using callback function it's possible to
+ * observe successful response twice: Cached version first, and up-to-date later.
+ *
+ * @param {Object}                  request              - An object containing request parameters.
+ * @param {string}                  request.url          - The URL to fetch.
+ * @param {Object}                  request.options      - Fetch request options.
+ * @param {Function}                [request.validator]  - Function to validate the response. Should return `false` if
+ *                                                       validation fails.
+ * @param {Function}                [request.callback]   - Function to execute after fetching. Receives the response,
+ *                                                       phase, and cache status.
+ * @param {Object}                  [request.cache]      - Cache object to store or retrieve cached data.
+ * @param {ValidatableRequestPhase} [phase='initial']    - The phase of the request, defaults to 'initial'.
+ * @returns {Promise<Object>} A promise that resolves to an object containing request details and the response.
+ * @throws {Error} Throws an error if the fetch fails or if the response is not valid according to the validator.
+ */
 export declare function fetchWithCacheAwareness({ url, options, validator, callback, cache }: ValidatableRequest, phase?: ValidatableRequestPhase): Promise<{
     url: RequestInfo | URL;
     options: RequestInit;
@@ -45,6 +61,14 @@ export declare function fetchWithCacheAwareness({ url, options, validator, callb
     callback: (response: Response, status: "initial" | "check" | "updated", isCached: boolean) => any;
     cache: FetchCache;
 }>;
+/**
+ * Validates cache of previousl fetch If the resource is cached and there is a newer version available, it will be
+ * re-fetched.
+ *
+ * @param request  - The request object containing the URL, cache information, options, validator, and response of
+ *                 initial request.
+ * @returns A promise that resolves to the request object.
+ */
 export declare function fetchToValidateCache(request: ValidatableRequest & Required<Pick<ValidatableRequest, 'response'>>): Promise<ValidatableRequest & Required<Pick<ValidatableRequest, "response">>>;
 export declare function fetchBypassingCache(request: ValidatableRequest): Promise<{
     url: RequestInfo | URL;

package/types/fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,MAAM,0CAA2C,CAAA;AACvD,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAC7D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAC1D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAA;IAC9D,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,OAAO,KAAK,GAAG,CAAA;IAC1F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,uBAAuB,CAAA;IAC9B,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACpC,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAClC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACpC,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;CACnC,CAAA;AAED,eAAO,IAAI,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAM,CAAA;AAC7D,wBAAgB,eAAe,SAE9B;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACvC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,EAC3C,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACzC,KAAK,GAAE,UAAuB,qBAM/B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,UAAQ,qBAajF;AAED,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C,wBAAsB,uBAAuB,CAC3C,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,kBAAkB,EAChE,KAAK,GAAE,uBAAmC;;;;;;;;GAmC3C;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,kBAAkB,GAAG,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,gFA0B7E;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB;;;;;;;;GAWpE"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,MAAM,0CAA2C,CAAA;AACvD,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAC7D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAC1D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACrC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAA;IAC9D,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,OAAO,KAAK,GAAG,CAAA;IAC1F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,uBAAuB,CAAA;IAC9B,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACpC,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAClC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACpC,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;CACnC,CAAA;AAED,eAAO,IAAI,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAM,CAAA;AAC7D,wBAAgB,eAAe,SAE9B;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACvC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,EAC3C,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACzC,KAAK,GAAE,UAAuB,qBAM/B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,UAAQ,qBAajF;AAED,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,kBAAkB,EAChE,KAAK,GAAE,uBAAmC;;;;;;;;GAmC3C;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,kBAAkB,GAAG,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,gFA0B7E;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB;;;;;;;;GAWpE"}