@fhss-web-team/frontend-utils 0.0.2

package/README.md

@@ -0,0 +1,2 @@
+# frontend-utils
+Utility code for the frontend of FHSS Web applications.

package/dist/cli/cli.js

@@ -0,0 +1,2 @@
+"use strict";
+console.log("FHSS CLI works!");

package/dist/components/fesm2022/components.mjs

@@ -0,0 +1,19 @@
+import * as i0 from '@angular/core';
+import { Component } from '@angular/core';
+
+class ByuFooterComponent {
+    currentYear = new Date().getFullYear(); // Automatically updates the year
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.8", ngImport: i0, type: ByuFooterComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.8", type: ByuFooterComponent, isStandalone: true, selector: "byu-footer", ngImport: i0, template: "<footer>\n    <p class=\"title\"><a href=\"https://www.byu.edu/\">BRIGHAM YOUNG UNIVERSITY</a></p>\n    <p>Provo, UT 84602, USA | \u00A9 {{ currentYear }} All rights reserved.</p>\n    <p>\n      <a href=\"https://privacy.byu.edu/privacy-notice\">Privacy Notice</a> |\n      <a href=\"https://privacy.byu.edu/cookie-prefs\">Cookie Preferences</a>\n    </p>\n</footer>\n    \n\n", styles: ["footer{font-family:HCo Ringside Narrow SSm,Open Sans,Helvetica,Arial,sans-serif;font-weight:400;font-size:14px;color:#fff;background-color:#002e5d;text-align:center;padding:10px 20px}p{margin:8px 0}a{text-decoration:none;color:inherit}a:hover{text-decoration:underline}.title{font-family:HCo Ringside Narrow SSm Bold,Open Sans,Helvetica,Arial,sans-serif;font-weight:700;font-size:20px;letter-spacing:5px;margin-bottom:18px}.title a:hover{text-decoration:none}\n"] });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.8", ngImport: i0, type: ByuFooterComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'byu-footer', standalone: true, template: "<footer>\n    <p class=\"title\"><a href=\"https://www.byu.edu/\">BRIGHAM YOUNG UNIVERSITY</a></p>\n    <p>Provo, UT 84602, USA | \u00A9 {{ currentYear }} All rights reserved.</p>\n    <p>\n      <a href=\"https://privacy.byu.edu/privacy-notice\">Privacy Notice</a> |\n      <a href=\"https://privacy.byu.edu/cookie-prefs\">Cookie Preferences</a>\n    </p>\n</footer>\n    \n\n", styles: ["footer{font-family:HCo Ringside Narrow SSm,Open Sans,Helvetica,Arial,sans-serif;font-weight:400;font-size:14px;color:#fff;background-color:#002e5d;text-align:center;padding:10px 20px}p{margin:8px 0}a{text-decoration:none;color:inherit}a:hover{text-decoration:underline}.title{font-family:HCo Ringside Narrow SSm Bold,Open Sans,Helvetica,Arial,sans-serif;font-weight:700;font-size:20px;letter-spacing:5px;margin-bottom:18px}.title a:hover{text-decoration:none}\n"] }]
+        }] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { ByuFooterComponent };
+//# sourceMappingURL=components.mjs.map

package/dist/components/fesm2022/components.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.mjs","sources":["../../../projects/components/src/lib/byu-footer/byu-footer.component.ts","../../../projects/components/src/lib/byu-footer/byu-footer.component.html","../../../projects/components/src/components.ts"],"sourcesContent":["import { Component } from '@angular/core';\n\n@Component({\n  selector: 'byu-footer',\n  templateUrl: './byu-footer.component.html',\n  styleUrl: './byu-footer.component.scss',\n  standalone: true\n})\nexport class ByuFooterComponent {\n  currentYear: number = new Date().getFullYear(); // Automatically updates the year\n}\n","<footer>\n    <p class=\"title\"><a href=\"https://www.byu.edu/\">BRIGHAM YOUNG UNIVERSITY</a></p>\n    <p>Provo, UT 84602, USA | © {{ currentYear }} All rights reserved.</p>\n    <p>\n      <a href=\"https://privacy.byu.edu/privacy-notice\">Privacy Notice</a> |\n      <a href=\"https://privacy.byu.edu/cookie-prefs\">Cookie Preferences</a>\n    </p>\n</footer>\n    \n\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;MAQa,kBAAkB,CAAA;IAC7B,WAAW,GAAW,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;uGADpC,kBAAkB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;AAAlB,IAAA,OAAA,IAAA,GAAA,EAAA,CAAA,oBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,IAAA,EAAA,kBAAkB,sECR/B,2XAUA,EAAA,MAAA,EAAA,CAAA,+cAAA,CAAA,EAAA,CAAA;;2FDFa,kBAAkB,EAAA,UAAA,EAAA,CAAA;kBAN9B,SAAS;AACE,YAAA,IAAA,EAAA,CAAA,EAAA,QAAA,EAAA,YAAY,cAGV,IAAI,EAAA,QAAA,EAAA,2XAAA,EAAA,MAAA,EAAA,CAAA,+cAAA,CAAA,EAAA;;;AENlB;;AAEG;;;;"}

package/dist/components/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="components" />
+export * from './public-api';

package/dist/components/lib/byu-footer/byu-footer.component.d.ts

@@ -0,0 +1,6 @@
+import * as i0 from "@angular/core";
+export declare class ByuFooterComponent {
+    currentYear: number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ByuFooterComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ByuFooterComponent, "byu-footer", never, {}, {}, never, never, true, never>;
+}

package/dist/components/public-api.d.ts

@@ -0,0 +1 @@
+export * from './lib/byu-footer/byu-footer.component';

package/dist/signals/debounced/debounced.d.ts

@@ -0,0 +1,2 @@
+import { Signal } from "@angular/core";
+export declare const debounced: <T>(inputSignal: Signal<T>, wait?: number) => import("@angular/core").WritableSignal<T>;

package/dist/signals/debounced/debounced.js

@@ -0,0 +1,18 @@
+import { effect, signal } from "@angular/core";
+export const debounced = (inputSignal, wait = 400) => {
+    const debouncedSignal = signal(inputSignal());
+    const setSignal = debounce((value) => debouncedSignal.set(value), wait);
+    effect(() => {
+        setSignal(inputSignal());
+    });
+    return debouncedSignal;
+};
+const debounce = (callback, wait) => {
+    let timeoutId;
+    return (...args) => {
+        window.clearTimeout(timeoutId);
+        timeoutId = window.setTimeout(() => {
+            callback(...args);
+        }, wait);
+    };
+};

package/dist/signals/fetch-signal/fetch-signal.d.ts

@@ -0,0 +1,351 @@
+import { Signal } from '@angular/core';
+type JsonValue = string | number | boolean | null | JsonArray | JsonObject;
+type JsonObject = {
+    [key: string]: JsonValue;
+};
+type JsonArray = JsonValue[];
+type Json = JsonObject | JsonArray;
+export type Maybe<T> = T | undefined | null;
+type DefaultError = {
+    code?: string;
+    message?: string;
+    details?: Json;
+};
+/**
+ * A value that may be a plain value of type `T` or a reactive `Signal<T>`.
+ *
+ * This is useful in APIs that accept either static or reactive values,
+ * allowing flexibility while maintaining type safety.
+ *
+ * Use `unwrapSignal` to extract the underlying value in a uniform way.
+ *
+ * @template T The underlying value type.
+ */
+export type MaybeSignal<T> = T | Signal<T>;
+/**
+ * Reads the underlying value from a MaybeSignal.
+ *
+ * This function is designed for use with reactive APIs (like fetchSignal) where it's important
+ * that Angular's computed methods register the dependency. If the input is a Signal, invoking it
+ * not only returns its current value but also tracks the signal for reactivity. If the input is
+ * a plain value, it simply returns that value.
+ *
+ * @template T The type of the value.
+ * @param value A plain value or a Signal that yields the value.
+ * @returns The current value, with dependency tracking enabled if the input is a Signal.
+ */
+export declare function readMaybeSignal<T>(value: MaybeSignal<T>): T;
+type FetchSignalRequest = {
+    url: string;
+    body?: unknown;
+    params?: Record<string, string | number | boolean | undefined>;
+    headers?: Record<string, string>;
+};
+/**
+ * Represents the reactive result of an HTTP fetch request.
+ */
+export type FetchSignal<Response, Error = DefaultError> = {
+    value: Signal<Maybe<Response>>;
+    persistentValue: Signal<Maybe<Response>>;
+    isLoading: Signal<boolean>;
+    error: Signal<Maybe<Error>>;
+    statusCode: Signal<Maybe<number>>;
+    headers: Signal<Maybe<Record<string, string>>>;
+    refresh: (abortSignal?: AbortSignal) => void;
+};
+type FetchSignalFactory = {
+    /**
+     * Initiates a reactive HTTP GET request using the provided request configuration.
+     *
+     * @template Response - The expected response type.
+     * @template Error - The expected error shape (defaults to `DefaultError`).
+     * @param request - The configuration object for the HTTP GET request.
+     * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+     * @returns A `FetchSignal` object containing reactive signals for the response data, loading state, status code, error, headers, and a refresh method.
+     */
+    <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean): FetchSignal<Response, Error>;
+    /**
+     * Initiates a reactive HTTP GET request using the provided request configuration and parses the response as JSON.
+     *
+     * @template Response - The expected response type.
+     * @template Error - The expected error shape (defaults to `DefaultError`).
+     * @param request - The configuration object for the HTTP GET request.
+     * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+     * @returns A `FetchSignal` object with the JSON-parsed response.
+     */
+    json: <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Response, Error>;
+    /**
+     * Initiates a reactive HTTP GET request using the provided request configuration and parses the response as plain text.
+     *
+     * @template Error - The expected error shape (defaults to `DefaultError`).
+     * @param request - The configuration object for the HTTP GET request.
+     * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+     * @returns A `FetchSignal` object with the text response.
+     */
+    text: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<string, Error>;
+    /**
+     * Initiates a reactive HTTP GET request using the provided request configuration and parses the response as a Blob.
+     *
+     * @template Error - The expected error shape (defaults to `DefaultError`).
+     * @param request - The configuration object for the HTTP GET request.
+     * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+     * @returns A `FetchSignal` object with the Blob response.
+     */
+    blob: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Blob, Error>;
+    /**
+     * Initiates a reactive HTTP GET request using the provided request configuration and parses the response as an ArrayBuffer.
+     *
+     * @template Error - The expected error shape (defaults to `DefaultError`).
+     * @param request - The configuration object for the HTTP GET request.
+     * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+     * @returns A `FetchSignal` object with the ArrayBuffer response.
+     */
+    arrayBuffer: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<ArrayBuffer, Error>;
+    get: {
+        /**
+         * Initiates a reactive HTTP GET request using the provided request configuration.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP GET request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object containing reactive signals for the response data, loading state, status code, error, headers, and a refresh method.
+         */
+        <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean): FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP GET request using the provided request configuration and parses the response as JSON.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP GET request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the JSON-parsed response.
+         */
+        json: <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP GET request using the provided request configuration and parses the response as plain text.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP GET request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the text response.
+         */
+        text: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<string, Error>;
+        /**
+         * Initiates a reactive HTTP GET request using the provided request configuration and parses the response as a Blob.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP GET request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the Blob response.
+         */
+        blob: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Blob, Error>;
+        /**
+         * Initiates a reactive HTTP GET request using the provided request configuration and parses the response as an ArrayBuffer.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP GET request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the ArrayBuffer response.
+         */
+        arrayBuffer: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<ArrayBuffer, Error>;
+    };
+    post: {
+        /**
+         * Initiates a reactive HTTP POST request using the provided request configuration.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP POST request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object containing reactive signals for the response data, loading state, status code, error, headers, and a refresh method.
+         */
+        <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean): FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP POST request using the provided request configuration and parses the response as JSON.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP POST request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the JSON-parsed response.
+         */
+        json: <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP POST request using the provided request configuration and parses the response as plain text.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP POST request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the text response.
+         */
+        text: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<string, Error>;
+        /**
+         * Initiates a reactive HTTP POST request using the provided request configuration and parses the response as a Blob.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP POST request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the Blob response.
+         */
+        blob: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Blob, Error>;
+        /**
+         * Initiates a reactive HTTP POST request using the provided request configuration and parses the response as an ArrayBuffer.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP POST request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the ArrayBuffer response.
+         */
+        arrayBuffer: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<ArrayBuffer, Error>;
+    };
+    put: {
+        /**
+         * Initiates a reactive HTTP PUT request using the provided request configuration.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PUT request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object containing reactive signals for the response data, loading state, status code, error, headers, and a refresh method.
+         */
+        <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean): FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP PUT request using the provided request configuration and parses the response as JSON.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PUT request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the JSON-parsed response.
+         */
+        json: <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP PUT request using the provided request configuration and parses the response as plain text.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PUT request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the text response.
+         */
+        text: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<string, Error>;
+        /**
+         * Initiates a reactive HTTP PUT request using the provided request configuration and parses the response as a Blob.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PUT request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the Blob response.
+         */
+        blob: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Blob, Error>;
+        /**
+         * Initiates a reactive HTTP PUT request using the provided request configuration and parses the response as an ArrayBuffer.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PUT request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the ArrayBuffer response.
+         */
+        arrayBuffer: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<ArrayBuffer, Error>;
+    };
+    patch: {
+        /**
+         * Initiates a reactive HTTP PATCH request using the provided request configuration.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PATCH request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object containing reactive signals for the response data, loading state, status code, error, headers, and a refresh method.
+         */
+        <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean): FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP PATCH request using the provided request configuration and parses the response as JSON.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PATCH request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the JSON-parsed response.
+         */
+        json: <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP PATCH request using the provided request configuration and parses the response as plain text.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PATCH request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the text response.
+         */
+        text: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<string, Error>;
+        /**
+         * Initiates a reactive HTTP PATCH request using the provided request configuration and parses the response as a Blob.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PATCH request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the Blob response.
+         */
+        blob: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Blob, Error>;
+        /**
+         * Initiates a reactive HTTP PATCH request using the provided request configuration and parses the response as an ArrayBuffer.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP PATCH request, which must include a body.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the ArrayBuffer response.
+         */
+        arrayBuffer: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<ArrayBuffer, Error>;
+    };
+    delete: {
+        /**
+         * Initiates a reactive HTTP DELETE request using the provided request configuration.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP DELETE request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object containing reactive signals for the response data, loading state, status code, error, headers, and a refresh method.
+         */
+        <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean): FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP DELETE request using the provided request configuration and parses the response as JSON.
+         *
+         * @template Response - The expected response type.
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP DELETE request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the JSON-parsed response.
+         */
+        json: <Response extends Json, Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Response, Error>;
+        /**
+         * Initiates a reactive HTTP DELETE request using the provided request configuration and parses the response as plain text.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP DELETE request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the text response.
+         */
+        text: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<string, Error>;
+        /**
+         * Initiates a reactive HTTP DELETE request using the provided request configuration and parses the response as a Blob.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP DELETE request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the Blob response.
+         */
+        blob: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<Blob, Error>;
+        /**
+         * Initiates a reactive HTTP DELETE request using the provided request configuration and parses the response as an ArrayBuffer.
+         *
+         * @template Error - The expected error shape (defaults to `DefaultError`).
+         * @param request - The configuration object for the HTTP DELETE request.
+         * @param autoRefresh - whether or not the request should be automatically refreshed when the request input signals have changed value
+         * @returns A `FetchSignal` object with the ArrayBuffer response.
+         */
+        arrayBuffer: <Error extends Json = DefaultError>(request: () => FetchSignalRequest, autoRefresh?: boolean) => FetchSignal<ArrayBuffer, Error>;
+    };
+};
+declare const fetchSignal: FetchSignalFactory;
+export { fetchSignal };

package/dist/signals/fetch-signal/fetch-signal.js

@@ -0,0 +1,171 @@
+import { computed, effect, signal } from '@angular/core';
+/**
+ * Reads the underlying value from a MaybeSignal.
+ *
+ * This function is designed for use with reactive APIs (like fetchSignal) where it's important
+ * that Angular's computed methods register the dependency. If the input is a Signal, invoking it
+ * not only returns its current value but also tracks the signal for reactivity. If the input is
+ * a plain value, it simply returns that value.
+ *
+ * @template T The type of the value.
+ * @param value A plain value or a Signal that yields the value.
+ * @returns The current value, with dependency tracking enabled if the input is a Signal.
+ */
+export function readMaybeSignal(value) {
+    return typeof value === 'function' ? value() : value;
+}
+/**
+ * Creates a reactive fetch signal.
+ *
+ * The request function can include Signals for properties. These are unwrapped in the refresh function.
+ */
+function createFetchSignal(request, method, transform, autoRefresh) {
+    // Use a computed signal so that any changes to Signals in the request object trigger updates.
+    const currentRequest = computed(request);
+    const value = signal(undefined);
+    const persistentValue = signal(undefined);
+    const isLoading = signal(false);
+    const error = signal(undefined);
+    const statusCode = signal(undefined);
+    const headers = signal(undefined);
+    const refresh = async (abortSignal) => {
+        // Reset signals for a fresh request.
+        value.set(undefined);
+        isLoading.set(true);
+        error.set(undefined);
+        statusCode.set(undefined);
+        headers.set(undefined);
+        // Unwrap the current request.
+        const req = currentRequest();
+        const url = req.url;
+        const params = req.params;
+        const requestHeaders = req.headers;
+        const body = req.body;
+        // Build URL with query parameters.
+        let uri = url;
+        if (params) {
+            const searchParams = new URLSearchParams();
+            for (const key in params) {
+                if (params[key] !== undefined)
+                    searchParams.append(key, String(params[key]));
+            }
+            uri += (uri.includes('?') ? '&' : '?') + searchParams.toString();
+        }
+        try {
+            const response = await fetch(uri, {
+                method,
+                headers: requestHeaders,
+                // Only include a body if one is provided.
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: abortSignal
+            });
+            statusCode.set(response.status);
+            // Extract response headers.
+            const headersObj = {};
+            response.headers.forEach((val, key) => {
+                headersObj[key] = val;
+            });
+            headers.set(headersObj);
+            // if the response is ok, transform the body
+            if (response.ok) {
+                value.set(await transform(response));
+                error.set(null);
+            }
+            else {
+                // try to parse the error as json
+                // set the error to null if this fails
+                try {
+                    error.set(await response.json());
+                }
+                catch {
+                    error.set(null);
+                }
+                finally {
+                    value.set(null);
+                }
+            }
+        }
+        catch (err) {
+            // if the request is aborted, ignore the error
+            if (err.name !== 'AbortError') {
+                console.error(err);
+            }
+            error.set(null);
+            value.set(null);
+        }
+        finally {
+            persistentValue.set(value());
+            isLoading.set(false);
+        }
+    };
+    if (autoRefresh) {
+        effect((onCleanup) => {
+            // read the current request to trigger re-run of this effect
+            currentRequest();
+            // pass abort signal to refresh on cleanup of effect
+            const controller = new AbortController();
+            onCleanup(() => controller.abort());
+            // call refresh with this abort controller
+            refresh(controller.signal);
+        });
+    }
+    return { value, persistentValue, isLoading, error, statusCode, headers, refresh };
+}
+//
+// Helpers for attaching response transforms for GET/DELETE (which don’t include a body).
+//
+const createHelper = (method, transform) => (request, autoRefresh = false) => createFetchSignal(request, method, transform, autoRefresh);
+// Transforms
+const jsonTransformer = (response) => response.json();
+const textTransformer = (response) => response.text();
+const blobTransformer = (response) => response.blob();
+const arrayBufferTransformer = (response) => response.arrayBuffer();
+//
+// Build the defaults - GET chain
+//
+const fetchSignal = createHelper('GET', jsonTransformer);
+fetchSignal.json = createHelper('GET', jsonTransformer);
+fetchSignal.text = createHelper('GET', textTransformer);
+fetchSignal.blob = createHelper('GET', blobTransformer);
+fetchSignal.arrayBuffer = createHelper('GET', arrayBufferTransformer);
+//
+// Build the GET chain
+//
+fetchSignal.get = createHelper('GET', jsonTransformer);
+fetchSignal.get.json = createHelper('GET', jsonTransformer);
+fetchSignal.get.text = createHelper('GET', textTransformer);
+fetchSignal.get.blob = createHelper('GET', blobTransformer);
+fetchSignal.get.arrayBuffer = createHelper('GET', arrayBufferTransformer);
+//
+// Build the POST chain.
+//
+fetchSignal.post = createHelper('POST', jsonTransformer);
+fetchSignal.post.json = createHelper('POST', jsonTransformer);
+fetchSignal.post.text = createHelper('POST', textTransformer);
+fetchSignal.post.blob = createHelper('POST', blobTransformer);
+fetchSignal.post.arrayBuffer = createHelper('POST', arrayBufferTransformer);
+//
+// Build the PUT chain.
+//
+fetchSignal.put = createHelper('PUT', jsonTransformer);
+fetchSignal.put.json = createHelper('PUT', jsonTransformer);
+fetchSignal.put.text = createHelper('PUT', textTransformer);
+fetchSignal.put.blob = createHelper('PUT', blobTransformer);
+fetchSignal.put.arrayBuffer = createHelper('PUT', arrayBufferTransformer);
+//
+// Build the PATCH chain.
+//
+fetchSignal.patch = createHelper('PATCH', jsonTransformer);
+fetchSignal.patch.json = createHelper('PATCH', jsonTransformer);
+fetchSignal.patch.text = createHelper('PATCH', textTransformer);
+fetchSignal.patch.blob = createHelper('PATCH', blobTransformer);
+fetchSignal.patch.arrayBuffer = createHelper('PATCH', arrayBufferTransformer);
+//
+// Build the DELETE chain
+//
+fetchSignal.delete = createHelper('DELETE', jsonTransformer);
+fetchSignal.delete.json = createHelper('DELETE', jsonTransformer);
+fetchSignal.delete.text = createHelper('DELETE', textTransformer);
+fetchSignal.delete.blob = createHelper('DELETE', blobTransformer);
+fetchSignal.delete.arrayBuffer = createHelper('DELETE', arrayBufferTransformer);
+export { fetchSignal };

package/dist/signals/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./debounced/debounced";
+export * from "./fetch-signal/fetch-signal";

package/dist/signals/index.js

@@ -0,0 +1,2 @@
+export * from "./debounced/debounced";
+export * from "./fetch-signal/fetch-signal";

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@fhss-web-team/frontend-utils",
+  "version": "0.0.2",
+  "description": "Utility code for the frontend of FHSS Web applications.",
+  "author": "FHSS Web Team",
+  "type": "module",
+  "exports": {
+    "./components": {
+      "import": "./dist/components/fesm2022/components.mjs",
+      "types": "./dist/components/index.d.ts"
+    },
+    "./signals": {
+      "import": "./dist/signals/index.js",
+      "types": "./dist/signals/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "fhss-cli": "./dist/cli/cli.js"
+  },
+  "scripts": {
+    "build:components": "ng-packagr -p projects/components/ng-package.json",
+    "build:signals": "tsc -p tsconfig.signals.json",
+    "build:cli": "tsc -p tsconfig.cli.json",
+    "build": "npm run build:components && npm run build:signals && npm run build:cli",
+    "push": "npm run build && npm publish --access public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "ng-packagr": "^19.2.2",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "@angular/core": "^19.2.8"
+  }
+}