@torthu/jacketui-bring 0.0.1

package/dist/pipe-helpers/backoff.js

@@ -0,0 +1,16 @@
+import { exponentialBackoff, } from "../helpers/exponentialBackoff";
+/** backoff(options?: BackoffOptions): BringInitDecorator
+ *
+ * Sets a exponential backoff function for retrying requests.
+ *
+ * @param options (optional) Backoff options
+ * @param options.base Base backoff time in milliseconds
+ * @param options.factor Multiplier for the backoff time
+ * @param options.max Maximum backoff time in milliseconds
+ * @param options.min Minimum backoff time in milliseconds
+ * @returns BringInitDecorator
+ */
+export const backoff = (options) => {
+    const backoffFun = (retryNum) => exponentialBackoff(retryNum, options);
+    return (init) => ({ ...init, backoff: backoffFun });
+};

package/dist/pipe-helpers/body.d.ts

@@ -0,0 +1,14 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** body(body): BringInitDecorator
+ *
+ * Sets the body of the request.
+ *
+ * @note This is a low-level helper. For JSON bodies, use `jsonBody` instead or manually JSON.stringify first.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RequestInit#body
+ *
+ * @param body
+ * @returns BringInitDecorator
+ */
+export declare const body: (body: BringInit["body"]) => BringInitDecorator;

package/dist/pipe-helpers/body.js

@@ -0,0 +1,12 @@
+/** body(body): BringInitDecorator
+ *
+ * Sets the body of the request.
+ *
+ * @note This is a low-level helper. For JSON bodies, use `jsonBody` instead or manually JSON.stringify first.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RequestInit#body
+ *
+ * @param body
+ * @returns BringInitDecorator
+ */
+export const body = (body) => (init) => ({ ...init, body });

package/dist/pipe-helpers/cache.d.ts

@@ -0,0 +1,17 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** cache(cacheMode): BringInitDecorator
+ *
+ * Sets the cache mode for the request.
+ * Possible values are "default", "no-store", "reload", "no-cache", "force-cache", and "only-if-cached".
+ * The default value is "default".
+ *
+ * @example
+ *   const customGet = (url: string) => pipe(cache("no-cache"), method("GET"), bring)({ url })
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/cache
+ *
+ * @param cacheMode - The cache mode to use for the request. "default", "no-store", "reload", "no-cache", "force-cache", and "only-if-cached"
+ * @returns BringInitDecorator
+ */
+export declare const cache: (cacheMode?: BringInit["cache"]) => BringInitDecorator;

package/dist/pipe-helpers/cache.js

@@ -0,0 +1,18 @@
+/** cache(cacheMode): BringInitDecorator
+ *
+ * Sets the cache mode for the request.
+ * Possible values are "default", "no-store", "reload", "no-cache", "force-cache", and "only-if-cached".
+ * The default value is "default".
+ *
+ * @example
+ *   const customGet = (url: string) => pipe(cache("no-cache"), method("GET"), bring)({ url })
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/cache
+ *
+ * @param cacheMode - The cache mode to use for the request. "default", "no-store", "reload", "no-cache", "force-cache", and "only-if-cached"
+ * @returns BringInitDecorator
+ */
+export const cache = (cacheMode = "default") => (init) => {
+    init.cache = cacheMode;
+    return init;
+};

package/dist/pipe-helpers/cors.d.ts

@@ -0,0 +1,33 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** cors(corsMode): BringInitDecorator
+ *
+ * Sets the CORS mode for the request.
+ *
+ * The default value is "cors".
+ *
+ * Possible values are: "cors", "no-cors", "same-origin".
+ * - "cors": CORS mode is enabled. This is the default value.
+ * - "no-cors": CORS mode is disabled.
+ * - "same-origin": CORS mode is enabled only for same-origin requests.
+ *
+ * An origin is the combination of protocol, host, and port.
+ * The path is not included in the origin.
+ *
+ * For example,
+ * - https://example.com is an origin.
+ * - https://example.com/path is the same origin.
+ * - https://example.com:8080 is a different origin.
+ * - https://sub.example.com/path is a different origin.
+ * - http://example.com is a different origin.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/mode
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS
+ *
+ * @example
+ *   const customGet = (url: string) => pipe(cors("no-cors"), method("GET"), bring)({ url }
+ *
+ * @param corsMode - The mode to use for the request. "cors", "no-cors", "same-origin" (default: "cors").
+ * @returns BringInitDecorator
+ */
+export declare const cors: (corsMode?: BringInit["mode"]) => BringInitDecorator;

package/dist/pipe-helpers/cors.js

@@ -0,0 +1,34 @@
+/** cors(corsMode): BringInitDecorator
+ *
+ * Sets the CORS mode for the request.
+ *
+ * The default value is "cors".
+ *
+ * Possible values are: "cors", "no-cors", "same-origin".
+ * - "cors": CORS mode is enabled. This is the default value.
+ * - "no-cors": CORS mode is disabled.
+ * - "same-origin": CORS mode is enabled only for same-origin requests.
+ *
+ * An origin is the combination of protocol, host, and port.
+ * The path is not included in the origin.
+ *
+ * For example,
+ * - https://example.com is an origin.
+ * - https://example.com/path is the same origin.
+ * - https://example.com:8080 is a different origin.
+ * - https://sub.example.com/path is a different origin.
+ * - http://example.com is a different origin.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/mode
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS
+ *
+ * @example
+ *   const customGet = (url: string) => pipe(cors("no-cors"), method("GET"), bring)({ url }
+ *
+ * @param corsMode - The mode to use for the request. "cors", "no-cors", "same-origin" (default: "cors").
+ * @returns BringInitDecorator
+ */
+export const cors = (corsMode = "cors") => (init) => {
+    init.mode = corsMode;
+    return init;
+};

package/dist/pipe-helpers/credentials.d.ts

@@ -0,0 +1,25 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** credentials(credentialsMode): BringInitDecorator
+ *
+ * Sets the credentials mode for the request.
+ *
+ * Credentials are cookies, TLS client certificates, or authentication headers containing a username and password.
+ *
+ * Possible values are:
+ * - "omit": Never send cookies.
+ * - "same-origin": Send cookies only if the URL is on the same origin as the calling script. This is the default value.
+ * - "include": Always send cookies, even for cross-origin calls.
+ *
+ * The default value is "same-origin".
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/credentials
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#including_credentials
+ *
+ * @example
+ *   const customGet = (url: string) => pipe(credentials("include"), method("GET"), bring)({ url })
+ *
+ * @param credentialsMode
+ * @returns
+ */
+export declare const credentials: (credentialsMode?: BringInit["credentials"]) => BringInitDecorator;

package/dist/pipe-helpers/credentials.js

@@ -0,0 +1,26 @@
+/** credentials(credentialsMode): BringInitDecorator
+ *
+ * Sets the credentials mode for the request.
+ *
+ * Credentials are cookies, TLS client certificates, or authentication headers containing a username and password.
+ *
+ * Possible values are:
+ * - "omit": Never send cookies.
+ * - "same-origin": Send cookies only if the URL is on the same origin as the calling script. This is the default value.
+ * - "include": Always send cookies, even for cross-origin calls.
+ *
+ * The default value is "same-origin".
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/credentials
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#including_credentials
+ *
+ * @example
+ *   const customGet = (url: string) => pipe(credentials("include"), method("GET"), bring)({ url })
+ *
+ * @param credentialsMode
+ * @returns
+ */
+export const credentials = (credentialsMode = "same-origin") => (init) => {
+    init.credentials = credentialsMode;
+    return init;
+};

package/dist/pipe-helpers/header.d.ts

@@ -0,0 +1,13 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+/** header(key: string, val: string): BringInitDecorator
+ *
+ * Sets a header on the request.
+ * If the header already exists, it will be overwritten.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Headers
+ *
+ * @param key The name of the header to set.
+ * @param val The value of the header to set.
+ * @returns BringDecorator
+ */
+export declare const header: (key: string, val: string) => BringInitDecorator;

package/dist/pipe-helpers/header.js

@@ -0,0 +1,25 @@
+/** header(key: string, val: string): BringInitDecorator
+ *
+ * Sets a header on the request.
+ * If the header already exists, it will be overwritten.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Headers
+ *
+ * @param key The name of the header to set.
+ * @param val The value of the header to set.
+ * @returns BringDecorator
+ */
+export const header = (key, val) => {
+    return (init) => {
+        init.headers ??= new Headers();
+        if (init.headers instanceof Headers) {
+            !init.headers.has(key)
+                ? init.headers.append(key, val)
+                : init.headers.set(key, val);
+        }
+        else {
+            init.headers[key] = val;
+        }
+        return init;
+    };
+};

package/dist/pipe-helpers/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./cache";
+export * from "./cors";
+export * from "./credentials";
+export * from "./header";
+export * from "./integrity";
+export * from "./keepalive";
+export * from "./method";
+export * from "./redirect";
+export * from "./referrer";
+export * from "./referrerPolicy";
+export * from "./retry";
+export * from "./body";
+export * from "./jsonBody";
+export * from "./priority";
+export * from "./backoff";
+export * from "./jitter";
+export * from "./timeout";

package/dist/pipe-helpers/index.js

@@ -0,0 +1,17 @@
+export * from "./cache";
+export * from "./cors";
+export * from "./credentials";
+export * from "./header";
+export * from "./integrity";
+export * from "./keepalive";
+export * from "./method";
+export * from "./redirect";
+export * from "./referrer";
+export * from "./referrerPolicy";
+export * from "./retry";
+export * from "./body";
+export * from "./jsonBody";
+export * from "./priority";
+export * from "./backoff";
+export * from "./jitter";
+export * from "./timeout";

package/dist/pipe-helpers/integrity.d.ts

@@ -0,0 +1,17 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** integrity(integrityMode): BringInitDecorator
+ *
+ * Sets the integrity mode of the request.
+ *
+ * The format of this option is <hash-algo>-<hash-source> where:
+ * - <hash-algo> is one of the following values: sha256, sha384, or sha512
+ * - <hash-source> is the Base64-encoding of the result of hashing the resource with the specified hash algorithm.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RequestInit#integrity
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/integrity
+ *
+ * @param integrityMode
+ * @returns BringDecorator
+ */
+export declare const integrity: (integrityMode?: BringInit["integrity"]) => BringInitDecorator;

package/dist/pipe-helpers/integrity.js

@@ -0,0 +1,18 @@
+/** integrity(integrityMode): BringInitDecorator
+ *
+ * Sets the integrity mode of the request.
+ *
+ * The format of this option is <hash-algo>-<hash-source> where:
+ * - <hash-algo> is one of the following values: sha256, sha384, or sha512
+ * - <hash-source> is the Base64-encoding of the result of hashing the resource with the specified hash algorithm.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RequestInit#integrity
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/integrity
+ *
+ * @param integrityMode
+ * @returns BringDecorator
+ */
+export const integrity = (integrityMode = "") => (init) => {
+    init.integrity = integrityMode;
+    return init;
+};

package/dist/pipe-helpers/jitter.d.ts

@@ -0,0 +1,13 @@
+import { JitterOptions } from "../helpers/randomJitter";
+import { BringInitDecorator } from "../types/BringDecorator";
+/** jitter(options?: JitterOptions): BringInitDecorator
+ *
+ * Sets a jitter function for retrying requests.
+ * Jitter is a random value added to the backoff time to prevent a thundering herd problem (when multiple clients retry at the same time).
+ *
+ * @param options (optional) Jitter options
+ * @param options.max (default 100) Maximum jitter time in milliseconds
+ * @param options.min (default 0) Minimum jitter time in milliseconds
+ * @returns BringInitDecorator
+ */
+export declare const jitter: (options?: JitterOptions) => BringInitDecorator;

package/dist/pipe-helpers/jitter.js

@@ -0,0 +1,15 @@
+import { randomJitter } from "../helpers/randomJitter";
+/** jitter(options?: JitterOptions): BringInitDecorator
+ *
+ * Sets a jitter function for retrying requests.
+ * Jitter is a random value added to the backoff time to prevent a thundering herd problem (when multiple clients retry at the same time).
+ *
+ * @param options (optional) Jitter options
+ * @param options.max (default 100) Maximum jitter time in milliseconds
+ * @param options.min (default 0) Minimum jitter time in milliseconds
+ * @returns BringInitDecorator
+ */
+export const jitter = (options) => {
+    const jitterFun = () => randomJitter(options);
+    return (init) => ({ ...init, backoff: jitterFun });
+};

package/dist/pipe-helpers/jsonBody.d.ts

@@ -0,0 +1,10 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** jsonBody(body: BringInit["body"]): BringInitDecorator
+ *
+ * Sets the body of the request to a JSON string.
+ *
+ * @param body Any JSON serializable value
+ * @returns BringInitDecorator
+ */
+export declare const jsonBody: (body: BringInit["body"]) => BringInitDecorator;

package/dist/pipe-helpers/jsonBody.js

@@ -0,0 +1,8 @@
+/** jsonBody(body: BringInit["body"]): BringInitDecorator
+ *
+ * Sets the body of the request to a JSON string.
+ *
+ * @param body Any JSON serializable value
+ * @returns BringInitDecorator
+ */
+export const jsonBody = (body) => (init) => ({ ...init, body: JSON.stringify(body) });

package/dist/pipe-helpers/keepalive.d.ts

@@ -0,0 +1,15 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** keepalive(boolean): BringInitDecorator
+ *
+ * Sets the keepalive mode of the request.
+ *
+ * If set to true, the request will be kept alive until the browser is closed.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/keepalive
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#keepalive
+ *
+ * @param keepaliveMode
+ * @returns
+ */
+export declare const keepalive: (keepaliveMode?: BringInit["keepalive"]) => BringInitDecorator;

package/dist/pipe-helpers/keepalive.js

@@ -0,0 +1,16 @@
+/** keepalive(boolean): BringInitDecorator
+ *
+ * Sets the keepalive mode of the request.
+ *
+ * If set to true, the request will be kept alive until the browser is closed.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/keepalive
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#keepalive
+ *
+ * @param keepaliveMode
+ * @returns
+ */
+export const keepalive = (keepaliveMode = false) => (init) => {
+    init.keepalive = keepaliveMode;
+    return init;
+};

package/dist/pipe-helpers/method.d.ts

@@ -0,0 +1,12 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** method(string): BringInitDecorator
+ *
+ * Sets the HTTP method of the request.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/method
+ *
+ * @param method - The HTTP method to use for the request.
+ * @returns BringDecorator
+ */
+export declare const method: (method?: BringInit["method"]) => BringInitDecorator;

package/dist/pipe-helpers/method.js

@@ -0,0 +1,13 @@
+/** method(string): BringInitDecorator
+ *
+ * Sets the HTTP method of the request.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/method
+ *
+ * @param method - The HTTP method to use for the request.
+ * @returns BringDecorator
+ */
+export const method = (method = "GET") => (init) => ({
+    ...init,
+    method,
+});

package/dist/pipe-helpers/priority.d.ts

@@ -0,0 +1,15 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** priority("auto" | "high" | "low"): BringInitDecorator
+ *
+ * The priority of the request relative to other requests of the same type.
+ *
+ * Possible values are:
+ * - "auto" (default) No user preference for the fetch priority
+ * - "high" A high priority fetch request relative to other requests of the same type.
+ * - "low" A low priority fetch request relative to other requests of the same type.
+ *
+ * @param priorityMode "auto" | "high" | "low
+ * @returns BringInitDecorator
+ */
+export declare const priority: (priorityMode?: BringInit["priority"]) => BringInitDecorator;

package/dist/pipe-helpers/priority.js

@@ -0,0 +1,15 @@
+/** priority("auto" | "high" | "low"): BringInitDecorator
+ *
+ * The priority of the request relative to other requests of the same type.
+ *
+ * Possible values are:
+ * - "auto" (default) No user preference for the fetch priority
+ * - "high" A high priority fetch request relative to other requests of the same type.
+ * - "low" A low priority fetch request relative to other requests of the same type.
+ *
+ * @param priorityMode "auto" | "high" | "low
+ * @returns BringInitDecorator
+ */
+export const priority = (priorityMode = "auto") => {
+    return (init) => ({ ...init, priority: priorityMode });
+};

package/dist/pipe-helpers/redirect.d.ts

@@ -0,0 +1,17 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** redirect(string): BringInitDecorator
+ *
+ * Sets the redirect mode of the request.
+ *
+ * Possible values are:
+ * - "follow": Automatically follow redirects. This is the default value.
+ * - "error": Abort with an error if a redirect occurs.
+ * - "manual": Handle redirects manually.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/redirect
+ *
+ * @param redirectMode - The redirect mode to use. "follow" | "error" | "manual". Defaults to "follow".
+ * @returns BringIntDecorator
+ */
+export declare const redirect: (redirectMode?: BringInit["redirect"]) => BringInitDecorator;

package/dist/pipe-helpers/redirect.js

@@ -0,0 +1,18 @@
+/** redirect(string): BringInitDecorator
+ *
+ * Sets the redirect mode of the request.
+ *
+ * Possible values are:
+ * - "follow": Automatically follow redirects. This is the default value.
+ * - "error": Abort with an error if a redirect occurs.
+ * - "manual": Handle redirects manually.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/redirect
+ *
+ * @param redirectMode - The redirect mode to use. "follow" | "error" | "manual". Defaults to "follow".
+ * @returns BringIntDecorator
+ */
+export const redirect = (redirectMode = "follow") => (init) => {
+    init.redirect = redirectMode;
+    return init;
+};

package/dist/pipe-helpers/referrer.d.ts

@@ -0,0 +1,15 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** referrer(string): BringInitDecorator
+ *
+ * A string specifying the value to use for the request's Referer header. One of the following:
+ * - A same-origin relative or absolute URL
+ * - An empty string, which indicates that no Referer header should be sent
+ * - "about:client" (default) set the Referer header to the default value for the context of the request (for example, the URL of the page that made the request).
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RequestInit#referrer
+ *
+ * @param referrerMode
+ * @returns
+ */
+export declare const referrer: (referrerMode?: BringInit["referrer"]) => BringInitDecorator;

package/dist/pipe-helpers/referrer.js

@@ -0,0 +1,16 @@
+/** referrer(string): BringInitDecorator
+ *
+ * A string specifying the value to use for the request's Referer header. One of the following:
+ * - A same-origin relative or absolute URL
+ * - An empty string, which indicates that no Referer header should be sent
+ * - "about:client" (default) set the Referer header to the default value for the context of the request (for example, the URL of the page that made the request).
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RequestInit#referrer
+ *
+ * @param referrerMode
+ * @returns
+ */
+export const referrer = (referrerMode = "about:client") => (init) => {
+    init.referrer = referrerMode;
+    return init;
+};

package/dist/pipe-helpers/referrerPolicy.d.ts

@@ -0,0 +1,25 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** referrerPolicy(string): BringInitDecorator
+ *
+ * A string specifying the value of the referrer-policy header to use for the request.
+ *
+ * Possible values are:
+ * - "no-referrer" The Referer header will not be sent.
+ * - "no-referrer-when-downgrade" Send the origin, path, and query string in Referer when the protocol security level stays the same or improves
+ * - "origin" Send only the origin in the Referer header. For example, a document at https://example.com/page.html will send the referrer https://example.com/.
+ * - "origin-when-cross-origin" When performing a same-origin request to the same protocol level (HTTP→HTTP, HTTPS→HTTPS), send the origin, path, and query string. Send only the origin for cross origin requests and requests to less secure destinations (HTTPS→HTTP).
+ * - "same-origin" Send the origin, path, and query string for same-origin requests. Don't send the Referer header for cross-origin requests.
+ * - "strict-origin" Send only the origin when the protocol security level stays the same (HTTPS→HTTPS). Don't send the Referer header to less secure destinations (HTTPS→HTTP).
+ * - "strict-origin-when-cross-origin" (default) Send the origin, path, and query string when performing a same-origin request. For cross-origin requests send the origin (only) when the protocol security level stays same (HTTPS→HTTPS). Don't send the Referer header to less secure destinations (HTTPS→HTTP).
+ * - "unsafe-url" Send the origin, path, and query string when performing any request, regardless of security.
+ *
+ * Default is "strict-origin-when-cross-origin"
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RequestInit#referrerpolicy
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Referrer-Policy
+ *
+ * @param referrerPolicyMode
+ * @returns BringInitDecorator
+ */
+export declare const referrerPolicy: (referrerPolicyMode?: BringInit["referrerPolicy"]) => BringInitDecorator;

package/dist/pipe-helpers/referrerPolicy.js

@@ -0,0 +1,26 @@
+/** referrerPolicy(string): BringInitDecorator
+ *
+ * A string specifying the value of the referrer-policy header to use for the request.
+ *
+ * Possible values are:
+ * - "no-referrer" The Referer header will not be sent.
+ * - "no-referrer-when-downgrade" Send the origin, path, and query string in Referer when the protocol security level stays the same or improves
+ * - "origin" Send only the origin in the Referer header. For example, a document at https://example.com/page.html will send the referrer https://example.com/.
+ * - "origin-when-cross-origin" When performing a same-origin request to the same protocol level (HTTP→HTTP, HTTPS→HTTPS), send the origin, path, and query string. Send only the origin for cross origin requests and requests to less secure destinations (HTTPS→HTTP).
+ * - "same-origin" Send the origin, path, and query string for same-origin requests. Don't send the Referer header for cross-origin requests.
+ * - "strict-origin" Send only the origin when the protocol security level stays the same (HTTPS→HTTPS). Don't send the Referer header to less secure destinations (HTTPS→HTTP).
+ * - "strict-origin-when-cross-origin" (default) Send the origin, path, and query string when performing a same-origin request. For cross-origin requests send the origin (only) when the protocol security level stays same (HTTPS→HTTPS). Don't send the Referer header to less secure destinations (HTTPS→HTTP).
+ * - "unsafe-url" Send the origin, path, and query string when performing any request, regardless of security.
+ *
+ * Default is "strict-origin-when-cross-origin"
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/RequestInit#referrerpolicy
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Referrer-Policy
+ *
+ * @param referrerPolicyMode
+ * @returns BringInitDecorator
+ */
+export const referrerPolicy = (referrerPolicyMode = "strict-origin-when-cross-origin") => (init) => {
+    init.referrerPolicy = referrerPolicyMode;
+    return init;
+};

package/dist/pipe-helpers/retry.d.ts

@@ -0,0 +1,10 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** retry(number): BringInitDecorator
+ *
+ * Sets the number of times to retry the request.
+ *
+ * @param retry The number of times to retry the request.
+ * @returns BringInitDecorator
+ */
+export declare const retry: (retry: BringInit["retry"]) => BringInitDecorator;

package/dist/pipe-helpers/retry.js

@@ -0,0 +1,8 @@
+/** retry(number): BringInitDecorator
+ *
+ * Sets the number of times to retry the request.
+ *
+ * @param retry The number of times to retry the request.
+ * @returns BringInitDecorator
+ */
+export const retry = (retry) => (init) => ({ ...init, retry });

package/dist/pipe-helpers/shouldRetry.d.ts

@@ -0,0 +1,8 @@
+import { BringInitDecorator } from "../types/BringDecorator";
+import { BringInit } from "../types/BringInit";
+/** shouldRetry((response: Response, retryNum: number) => boolean)): BringInitDecorator
+ *
+ * @param shouldRetry ((response: Response, retryNum: number) => boolean)
+ * @returns BringInitDecorator
+ */
+export declare const shouldRetry: (shouldRetry: BringInit["shouldRetry"]) => BringInitDecorator;

package/dist/pipe-helpers/shouldRetry.js

@@ -0,0 +1,6 @@
+/** shouldRetry((response: Response, retryNum: number) => boolean)): BringInitDecorator
+ *
+ * @param shouldRetry ((response: Response, retryNum: number) => boolean)
+ * @returns BringInitDecorator
+ */
+export const shouldRetry = (shouldRetry) => (init) => ({ ...init, shouldRetry });