@vaadin/hilla-frontend 24.4.0-alpha4

package/.lintstagedrc.js

@@ -0,0 +1,6 @@
+import { commands, extensions } from '../../../.lintstagedrc.js';
+
+export default {
+  [`src/**/*.{${extensions}}`]: commands,
+  [`test/**/*.{${extensions}}`]: commands,
+};

package/Authentication.d.ts

@@ -0,0 +1,45 @@
+import type { MiddlewareClass, MiddlewareContext, MiddlewareNext } from './Connect.js';
+export interface LoginResult {
+    error: boolean;
+    token?: string;
+    errorTitle?: string;
+    errorMessage?: string;
+    redirectUrl?: string;
+    defaultUrl?: string;
+}
+export interface LoginOptions {
+    loginProcessingUrl?: string;
+}
+export interface LogoutOptions {
+    logoutUrl?: string;
+}
+/**
+ * A helper method for Spring Security based form login.
+ * @param username - username
+ * @param password - password
+ * @param options - defines additional options, e.g, the loginProcessingUrl etc.
+ */
+export declare function login(username: string, password: string, options?: LoginOptions): Promise<LoginResult>;
+/**
+ * A helper method for Spring Security based form logout
+ * @param options - defines additional options, e.g, the logoutUrl.
+ */
+export declare function logout(options?: LogoutOptions): Promise<void>;
+/**
+ * It defines what to do when it detects a session is invalid. E.g.,
+ * show a login view.
+ * It takes an <code>EndpointCallContinue</code> parameter, which can be
+ * used to continue the endpoint call.
+ */
+export type OnInvalidSessionCallback = () => Promise<LoginResult>;
+/**
+ * A helper class for handling invalid sessions during an endpoint call.
+ * E.g., you can use this to show user a login page when the session has
+ * expired.
+ */
+export declare class InvalidSessionMiddleware implements MiddlewareClass {
+    private readonly onInvalidSessionCallback;
+    constructor(onInvalidSessionCallback: OnInvalidSessionCallback);
+    invoke(context: MiddlewareContext, next: MiddlewareNext): Promise<Response>;
+}
+//# sourceMappingURL=Authentication.d.ts.map

package/Authentication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Authentication.d.ts","sourceRoot":"","sources":["src/Authentication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAoDvF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA2D5G;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBnE;AAED;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;AAElE;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IAC9D,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA2B;gBAExD,wBAAwB,EAAE,wBAAwB;IAIxD,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;CAalF"}

package/Authentication.js

@@ -0,0 +1,136 @@
+import CookieManager from "./CookieManager.js";
+import { getSpringCsrfInfo, getSpringCsrfTokenHeadersForAuthRequest, VAADIN_CSRF_HEADER } from "./CsrfUtils.js";
+const JWT_COOKIE_NAME = "jwt.headerAndPayload";
+function getSpringCsrfTokenFromResponseBody(body) {
+  const doc = new DOMParser().parseFromString(body, "text/html");
+  return getSpringCsrfInfo(doc);
+}
+function clearSpringCsrfMetaTags() {
+  Array.from(document.head.querySelectorAll('meta[name="_csrf"], meta[name="_csrf_header"]')).forEach(
+    (el) => el.remove()
+  );
+}
+function updateSpringCsrfMetaTags(springCsrfInfo) {
+  clearSpringCsrfMetaTags();
+  const headerNameMeta = document.createElement("meta");
+  headerNameMeta.name = "_csrf_header";
+  headerNameMeta.content = springCsrfInfo._csrf_header;
+  document.head.appendChild(headerNameMeta);
+  const tokenMeta = document.createElement("meta");
+  tokenMeta.name = "_csrf";
+  tokenMeta.content = springCsrfInfo._csrf;
+  document.head.appendChild(tokenMeta);
+}
+const getVaadinCsrfTokenFromResponseBody = (body) => {
+  const match = /window\.Vaadin = \{TypeScript: \{"csrfToken":"([0-9a-zA-Z\\-]{36})"\}\};/iu.exec(body);
+  return match ? match[1] : void 0;
+};
+async function updateCsrfTokensBasedOnResponse(response) {
+  const responseText = await response.text();
+  const token = getVaadinCsrfTokenFromResponseBody(responseText);
+  const springCsrfTokenInfo = getSpringCsrfTokenFromResponseBody(responseText);
+  updateSpringCsrfMetaTags(springCsrfTokenInfo);
+  return token;
+}
+async function doLogout(logoutUrl, headers) {
+  const response = await fetch(logoutUrl, { headers, method: "POST" });
+  if (!response.ok) {
+    throw new Error(`failed to logout with response ${response.status}`);
+  }
+  await updateCsrfTokensBasedOnResponse(response);
+}
+async function login(username, password, options) {
+  try {
+    const data = new FormData();
+    data.append("username", username);
+    data.append("password", password);
+    const loginProcessingUrl = options?.loginProcessingUrl ?? "login";
+    const headers = getSpringCsrfTokenHeadersForAuthRequest(document);
+    headers.source = "typescript";
+    const response = await fetch(loginProcessingUrl, {
+      body: data,
+      headers,
+      method: "POST"
+    });
+    const result = response.headers.get("Result");
+    const savedUrl = response.headers.get("Saved-url") ?? void 0;
+    const defaultUrl = response.headers.get("Default-url") ?? void 0;
+    const loginSuccessful = response.ok && result === "success";
+    if (loginSuccessful) {
+      const vaadinCsrfToken = response.headers.get("Vaadin-CSRF") ?? void 0;
+      const springCsrfHeader = response.headers.get("Spring-CSRF-header") ?? void 0;
+      const springCsrfToken = response.headers.get("Spring-CSRF-token") ?? void 0;
+      if (springCsrfHeader && springCsrfToken) {
+        const springCsrfTokenInfo = {};
+        springCsrfTokenInfo._csrf = springCsrfToken;
+        springCsrfTokenInfo._csrf_header = springCsrfHeader;
+        updateSpringCsrfMetaTags(springCsrfTokenInfo);
+      }
+      return {
+        defaultUrl,
+        error: false,
+        redirectUrl: savedUrl,
+        token: vaadinCsrfToken
+      };
+    }
+    return {
+      error: true,
+      errorMessage: "Check that you have entered the correct username and password and try again.",
+      errorTitle: "Incorrect username or password."
+    };
+  } catch (e) {
+    if (e instanceof Error) {
+      return {
+        error: true,
+        errorMessage: e.message,
+        errorTitle: e.name
+      };
+    }
+    throw e;
+  }
+}
+async function logout(options) {
+  const logoutUrl = options?.logoutUrl ?? "logout";
+  try {
+    const headers = getSpringCsrfTokenHeadersForAuthRequest(document);
+    await doLogout(logoutUrl, headers);
+  } catch {
+    try {
+      const response = await fetch("?nocache");
+      const responseText = await response.text();
+      const doc = new DOMParser().parseFromString(responseText, "text/html");
+      const headers = getSpringCsrfTokenHeadersForAuthRequest(doc);
+      await doLogout(logoutUrl, headers);
+    } catch (error) {
+      clearSpringCsrfMetaTags();
+      throw error;
+    }
+  } finally {
+    CookieManager.remove(JWT_COOKIE_NAME);
+  }
+}
+class InvalidSessionMiddleware {
+  onInvalidSessionCallback;
+  constructor(onInvalidSessionCallback) {
+    this.onInvalidSessionCallback = onInvalidSessionCallback;
+  }
+  async invoke(context, next) {
+    const clonedContext = { ...context };
+    clonedContext.request = context.request.clone();
+    const response = await next(context);
+    if (response.status === 401) {
+      const loginResult = await this.onInvalidSessionCallback();
+      if (loginResult.token) {
+        clonedContext.request.headers.set(VAADIN_CSRF_HEADER, loginResult.token);
+        return next(clonedContext);
+      }
+    }
+    return response;
+  }
+}
+export {
+  InvalidSessionMiddleware,
+  login,
+  logout
+};
+//# sourceMappingURL=Authentication.js.map

package/Authentication.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/Authentication.ts"],
+  "sourcesContent": ["import type { MiddlewareClass, MiddlewareContext, MiddlewareNext } from './Connect.js';\nimport CookieManager from './CookieManager.js';\nimport { getSpringCsrfInfo, getSpringCsrfTokenHeadersForAuthRequest, VAADIN_CSRF_HEADER } from './CsrfUtils.js';\n\nconst JWT_COOKIE_NAME = 'jwt.headerAndPayload';\n\nfunction getSpringCsrfTokenFromResponseBody(body: string): Record<string, string> {\n  const doc = new DOMParser().parseFromString(body, 'text/html');\n  return getSpringCsrfInfo(doc);\n}\n\nfunction clearSpringCsrfMetaTags() {\n  Array.from(document.head.querySelectorAll('meta[name=\"_csrf\"], meta[name=\"_csrf_header\"]')).forEach((el) =>\n    el.remove(),\n  );\n}\n\nfunction updateSpringCsrfMetaTags(springCsrfInfo: Record<string, string>) {\n  clearSpringCsrfMetaTags();\n  const headerNameMeta: HTMLMetaElement = document.createElement('meta');\n  headerNameMeta.name = '_csrf_header';\n  headerNameMeta.content = springCsrfInfo._csrf_header;\n  document.head.appendChild(headerNameMeta);\n  const tokenMeta: HTMLMetaElement = document.createElement('meta');\n  tokenMeta.name = '_csrf';\n  tokenMeta.content = springCsrfInfo._csrf;\n  document.head.appendChild(tokenMeta);\n}\n\nconst getVaadinCsrfTokenFromResponseBody = (body: string): string | undefined => {\n  const match = /window\\.Vaadin = \\{TypeScript: \\{\"csrfToken\":\"([0-9a-zA-Z\\\\-]{36})\"\\}\\};/iu.exec(body);\n  return match ? match[1] : undefined;\n};\n\nasync function updateCsrfTokensBasedOnResponse(response: Response): Promise<string | undefined> {\n  const responseText = await response.text();\n  const token = getVaadinCsrfTokenFromResponseBody(responseText);\n  const springCsrfTokenInfo = getSpringCsrfTokenFromResponseBody(responseText);\n  updateSpringCsrfMetaTags(springCsrfTokenInfo);\n\n  return token;\n}\n\nasync function doLogout(logoutUrl: string, headers: Record<string, string>) {\n  const response = await fetch(logoutUrl, { headers, method: 'POST' });\n  if (!response.ok) {\n    throw new Error(`failed to logout with response ${response.status}`);\n  }\n\n  await updateCsrfTokensBasedOnResponse(response);\n}\n\nexport interface LoginResult {\n  error: boolean;\n  token?: string;\n  errorTitle?: string;\n  errorMessage?: string;\n  redirectUrl?: string;\n  defaultUrl?: string;\n}\n\nexport interface LoginOptions {\n  loginProcessingUrl?: string;\n}\n\nexport interface LogoutOptions {\n  logoutUrl?: string;\n}\n\n/**\n * A helper method for Spring Security based form login.\n * @param username - username\n * @param password - password\n * @param options - defines additional options, e.g, the loginProcessingUrl etc.\n */\nexport async function login(username: string, password: string, options?: LoginOptions): Promise<LoginResult> {\n  try {\n    const data = new FormData();\n    data.append('username', username);\n    data.append('password', password);\n\n    const loginProcessingUrl = options?.loginProcessingUrl ?? 'login';\n    const headers = getSpringCsrfTokenHeadersForAuthRequest(document);\n    headers.source = 'typescript';\n    const response = await fetch(loginProcessingUrl, {\n      body: data,\n      headers,\n      method: 'POST',\n    });\n\n    // This code assumes that a VaadinSavedRequestAwareAuthenticationSuccessHandler is used on the server side,\n    // setting these header values based on the \"source=typescript\" header set above\n\n    const result = response.headers.get('Result');\n    const savedUrl = response.headers.get('Saved-url') ?? undefined;\n    const defaultUrl = response.headers.get('Default-url') ?? undefined;\n    const loginSuccessful = response.ok && result === 'success';\n\n    if (loginSuccessful) {\n      const vaadinCsrfToken = response.headers.get('Vaadin-CSRF') ?? undefined;\n\n      const springCsrfHeader = response.headers.get('Spring-CSRF-header') ?? undefined;\n      const springCsrfToken = response.headers.get('Spring-CSRF-token') ?? undefined;\n      if (springCsrfHeader && springCsrfToken) {\n        const springCsrfTokenInfo: Record<string, string> = {};\n        springCsrfTokenInfo._csrf = springCsrfToken;\n        // eslint-disable-next-line camelcase\n        springCsrfTokenInfo._csrf_header = springCsrfHeader;\n        updateSpringCsrfMetaTags(springCsrfTokenInfo);\n      }\n\n      return {\n        defaultUrl,\n        error: false,\n        redirectUrl: savedUrl,\n        token: vaadinCsrfToken,\n      };\n    }\n    return {\n      error: true,\n      errorMessage: 'Check that you have entered the correct username and password and try again.',\n      errorTitle: 'Incorrect username or password.',\n    };\n  } catch (e: unknown) {\n    if (e instanceof Error) {\n      return {\n        error: true,\n        errorMessage: e.message,\n        errorTitle: e.name,\n      };\n    }\n\n    throw e;\n  }\n}\n\n/**\n * A helper method for Spring Security based form logout\n * @param options - defines additional options, e.g, the logoutUrl.\n */\nexport async function logout(options?: LogoutOptions): Promise<void> {\n  // this assumes the default Spring Security logout configuration (handler URL)\n  const logoutUrl = options?.logoutUrl ?? 'logout';\n  try {\n    const headers = getSpringCsrfTokenHeadersForAuthRequest(document);\n    await doLogout(logoutUrl, headers);\n  } catch {\n    try {\n      const response = await fetch('?nocache');\n      const responseText = await response.text();\n      const doc = new DOMParser().parseFromString(responseText, 'text/html');\n      const headers = getSpringCsrfTokenHeadersForAuthRequest(doc);\n      await doLogout(logoutUrl, headers);\n    } catch (error) {\n      // clear the token if the call fails\n      clearSpringCsrfMetaTags();\n      throw error;\n    }\n  } finally {\n    CookieManager.remove(JWT_COOKIE_NAME);\n  }\n}\n\n/**\n * It defines what to do when it detects a session is invalid. E.g.,\n * show a login view.\n * It takes an <code>EndpointCallContinue</code> parameter, which can be\n * used to continue the endpoint call.\n */\nexport type OnInvalidSessionCallback = () => Promise<LoginResult>;\n\n/**\n * A helper class for handling invalid sessions during an endpoint call.\n * E.g., you can use this to show user a login page when the session has\n * expired.\n */\nexport class InvalidSessionMiddleware implements MiddlewareClass {\n  private readonly onInvalidSessionCallback: OnInvalidSessionCallback;\n\n  constructor(onInvalidSessionCallback: OnInvalidSessionCallback) {\n    this.onInvalidSessionCallback = onInvalidSessionCallback;\n  }\n\n  async invoke(context: MiddlewareContext, next: MiddlewareNext): Promise<Response> {\n    const clonedContext = { ...context };\n    clonedContext.request = context.request.clone();\n    const response = await next(context);\n    if (response.status === 401) {\n      const loginResult = await this.onInvalidSessionCallback();\n      if (loginResult.token) {\n        clonedContext.request.headers.set(VAADIN_CSRF_HEADER, loginResult.token);\n        return next(clonedContext) as Promise<Response>;\n      }\n    }\n    return response;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/Connect.d.ts

@@ -0,0 +1,165 @@
+/// <reference types="atmosphere.js" />
+import type { ReactiveControllerHost } from '@lit/reactive-element';
+import { FluxConnection } from './FluxConnection.js';
+export type MaybePromise<T> = Promise<T> | T;
+/**
+ * Represents the connection to and endpoint returning a subscription rather than a value.
+ */
+export interface Subscription<T> {
+    /** Cancels the subscription.  No values are made available after calling this. */
+    cancel(): void;
+    context(context: ReactiveControllerHost): Subscription<T>;
+    /** Called when the subscription has completed. No values are made available after calling this. */
+    onComplete(callback: () => void): Subscription<T>;
+    /** Called when an exception occured in the subscription. */
+    onError(callback: () => void): Subscription<T>;
+    /** Called when a new value is available. */
+    onNext(callback: (value: T) => void): Subscription<T>;
+}
+/**
+ * The `ConnectClient` constructor options.
+ */
+export interface ConnectClientOptions {
+    /**
+     * The `middlewares` property value.
+     */
+    middlewares?: Middleware[];
+    /**
+     * The `prefix` property value.
+     */
+    prefix?: string;
+    /**
+     * The Atmosphere options for the FluxConnection.
+     */
+    atmosphereOptions?: Partial<Atmosphere.Request>;
+}
+export interface EndpointCallMetaInfo {
+    /**
+     * The endpoint name.
+     */
+    endpoint: string;
+    /**
+     * The method name to call on in the endpoint class.
+     */
+    method: string;
+    /**
+     * Optional object with method call arguments.
+     */
+    params?: Record<string, unknown>;
+}
+/**
+ * An object with the call arguments and the related Request instance.
+ * See also {@link ConnectClient.call | the call() method in ConnectClient}.
+ */
+export interface MiddlewareContext extends EndpointCallMetaInfo {
+    /**
+     * The Fetch API Request object reflecting the other properties.
+     */
+    request: Request;
+}
+/**
+ * An async middleware callback that invokes the next middleware in the chain
+ * or makes the actual request.
+ * @param context - The information about the call and request
+ */
+export type MiddlewareNext = (context: MiddlewareContext) => MaybePromise<Response>;
+/**
+ * An interface that allows defining a middleware as a class.
+ */
+export interface MiddlewareClass {
+    /**
+     * @param context - The information about the call and request
+     * @param next - Invokes the next in the call chain
+     */
+    invoke(context: MiddlewareContext, next: MiddlewareNext): MaybePromise<Response>;
+}
+/**
+ * An async callback function that can intercept the request and response
+ * of a call.
+ */
+export type MiddlewareFunction = (context: MiddlewareContext, next: MiddlewareNext) => MaybePromise<Response>;
+/**
+ * An async callback that can intercept the request and response
+ * of a call, could be either a function or a class.
+ */
+export type Middleware = MiddlewareClass | MiddlewareFunction;
+/**
+ * A list of parameters supported by {@link ConnectClient.call | the call() method in ConnectClient}.
+ */
+export interface EndpointRequestInit {
+    /**
+     * An AbortSignal to set request's signal.
+     */
+    signal?: AbortSignal | null;
+}
+/**
+ * A low-level network calling utility. It stores
+ * a prefix and facilitates remote calls to endpoint class methods
+ * on the Hilla backend.
+ *
+ * Example usage:
+ *
+ * ```js
+ * const client = new ConnectClient();
+ * const responseData = await client.call('MyEndpoint', 'myMethod');
+ * ```
+ *
+ * ### Prefix
+ *
+ * The client supports an `prefix` constructor option:
+ * ```js
+ * const client = new ConnectClient({prefix: '/my-connect-prefix'});
+ * ```
+ *
+ * The default prefix is '/connect'.
+ *
+ */
+export declare class ConnectClient {
+    #private;
+    /**
+     * The array of middlewares that are invoked during a call.
+     */
+    middlewares: Middleware[];
+    /**
+     * The Hilla endpoint prefix
+     */
+    prefix: string;
+    /**
+     * The Atmosphere options for the FluxConnection.
+     */
+    atmosphereOptions: Partial<Atmosphere.Request>;
+    /**
+     * @param options - Constructor options.
+     */
+    constructor(options?: ConnectClientOptions);
+    /**
+     * Gets a representation of the underlying persistent network connection used for subscribing to Flux type endpoint
+     * methods.
+     */
+    get fluxConnection(): FluxConnection;
+    /**
+     * Calls the given endpoint method defined using the endpoint and method
+     * parameters with the parameters given as params.
+     * Asynchronously returns the parsed JSON response data.
+     *
+     * @param endpoint - Endpoint name.
+     * @param method - Method name to call in the endpoint class.
+     * @param params - Optional parameters to pass to the method.
+     * @param init - Optional parameters for the request
+     * @returns Decoded JSON response data.
+     */
+    call(endpoint: string, method: string, params?: Record<string, unknown>, init?: EndpointRequestInit): Promise<any>;
+    /**
+     * Subscribes to the given method defined using the endpoint and method
+     * parameters with the parameters given as params. The method must return a
+     * compatible type such as a Flux.
+     * Returns a subscription that is used to fetch values as they become available.
+     *
+     * @param endpoint - Endpoint name.
+     * @param method - Method name to call in the endpoint class.
+     * @param params - Optional parameters to pass to the method.
+     * @returns A subscription used to handles values as they become available.
+     */
+    subscribe(endpoint: string, method: string, params?: any): Subscription<any>;
+}
+//# sourceMappingURL=Connect.d.ts.map

package/Connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connect.d.ts","sourceRoot":"","sources":["src/Connect.ts"],"names":[],"mappings":"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"}

package/Connect.js

@@ -0,0 +1,185 @@
+import { ConnectionIndicator, ConnectionState } from "@vaadin/common-frontend";
+import { getCsrfTokenHeadersForEndpointRequest } from "./CsrfUtils.js";
+import {
+  EndpointError,
+  EndpointResponseError,
+  EndpointValidationError,
+  ForbiddenResponseError,
+  UnauthorizedResponseError
+} from "./EndpointErrors.js";
+import { FluxConnection } from "./FluxConnection.js";
+const $wnd = window;
+$wnd.Vaadin ??= {};
+$wnd.Vaadin.registrations ??= [];
+$wnd.Vaadin.registrations.push({
+  is: "endpoint"
+});
+const assertResponseIsOk = async (response) => {
+  if (!response.ok) {
+    const errorText = await response.text();
+    let errorJson;
+    try {
+      errorJson = JSON.parse(errorText);
+    } catch (ignored) {
+      errorJson = null;
+    }
+    const message = errorJson?.message ?? (errorText.length > 0 ? errorText : `expected "200 OK" response, but got ${response.status} ${response.statusText}`);
+    const type = errorJson?.type;
+    if (errorJson?.validationErrorData) {
+      throw new EndpointValidationError(message, errorJson.validationErrorData, type);
+    }
+    if (type) {
+      throw new EndpointError(message, type, errorJson?.detail);
+    }
+    switch (response.status) {
+      case 401:
+        throw new UnauthorizedResponseError(message, response);
+      case 403:
+        throw new ForbiddenResponseError(message, response);
+      default:
+        throw new EndpointResponseError(message, response);
+    }
+  }
+};
+function isFlowLoaded() {
+  return $wnd.Vaadin?.Flow?.clients?.TypeScript !== void 0;
+}
+class ConnectClient {
+  /**
+   * The array of middlewares that are invoked during a call.
+   */
+  middlewares = [];
+  /**
+   * The Hilla endpoint prefix
+   */
+  prefix = "/connect";
+  /**
+   * The Atmosphere options for the FluxConnection.
+   */
+  atmosphereOptions = {};
+  #fluxConnection;
+  /**
+   * @param options - Constructor options.
+   */
+  constructor(options = {}) {
+    if (options.prefix) {
+      this.prefix = options.prefix;
+    }
+    if (options.middlewares) {
+      this.middlewares = options.middlewares;
+    }
+    if (options.atmosphereOptions) {
+      this.atmosphereOptions = options.atmosphereOptions;
+    }
+    ConnectionIndicator.create();
+    addEventListener("online", () => {
+      if (!isFlowLoaded() && $wnd.Vaadin?.connectionState) {
+        $wnd.Vaadin.connectionState.state = ConnectionState.CONNECTED;
+      }
+    });
+    addEventListener("offline", () => {
+      if (!isFlowLoaded() && $wnd.Vaadin?.connectionState) {
+        $wnd.Vaadin.connectionState.state = ConnectionState.CONNECTION_LOST;
+      }
+    });
+  }
+  /**
+   * Gets a representation of the underlying persistent network connection used for subscribing to Flux type endpoint
+   * methods.
+   */
+  get fluxConnection() {
+    if (!this.#fluxConnection) {
+      this.#fluxConnection = new FluxConnection(this.prefix, this.atmosphereOptions);
+    }
+    return this.#fluxConnection;
+  }
+  /**
+   * Calls the given endpoint method defined using the endpoint and method
+   * parameters with the parameters given as params.
+   * Asynchronously returns the parsed JSON response data.
+   *
+   * @param endpoint - Endpoint name.
+   * @param method - Method name to call in the endpoint class.
+   * @param params - Optional parameters to pass to the method.
+   * @param init - Optional parameters for the request
+   * @returns Decoded JSON response data.
+   */
+  async call(endpoint, method, params, init) {
+    if (arguments.length < 2) {
+      throw new TypeError(`2 arguments required, but got only ${arguments.length}`);
+    }
+    const csrfHeaders = getCsrfTokenHeadersForEndpointRequest(document);
+    const headers = {
+      Accept: "application/json",
+      "Content-Type": "application/json",
+      ...csrfHeaders
+    };
+    const request = new Request(`${this.prefix}/${endpoint}/${method}`, {
+      body: params !== void 0 ? JSON.stringify(params, (_, value) => value === void 0 ? null : value) : void 0,
+      headers,
+      method: "POST"
+    });
+    const initialContext = {
+      endpoint,
+      method,
+      params,
+      request
+    };
+    async function responseHandlerMiddleware(context, next) {
+      const response = await next(context);
+      await assertResponseIsOk(response);
+      const text = await response.text();
+      return JSON.parse(text, (_, value) => value === null ? void 0 : value);
+    }
+    async function fetchNext(context) {
+      $wnd.Vaadin?.connectionState?.loadingStarted();
+      try {
+        const response = await fetch(context.request, { signal: init?.signal });
+        $wnd.Vaadin?.connectionState?.loadingFinished();
+        return response;
+      } catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+          $wnd.Vaadin?.connectionState?.loadingFinished();
+        } else {
+          $wnd.Vaadin?.connectionState?.loadingFailed();
+        }
+        return Promise.reject(error);
+      }
+    }
+    const middlewares = [responseHandlerMiddleware, ...this.middlewares];
+    const chain = middlewares.reduceRight(
+      (next, middleware) => (
+        // Compose and return the new chain step, that takes the context and
+        // invokes the current middleware with the context and the further chain
+        // as the next argument
+        async (context) => {
+          if (typeof middleware === "function") {
+            return middleware(context, next);
+          }
+          return middleware.invoke(context, next);
+        }
+      ),
+      // Initialize reduceRight the accumulator with `fetchNext`
+      fetchNext
+    );
+    return chain(initialContext);
+  }
+  /**
+   * Subscribes to the given method defined using the endpoint and method
+   * parameters with the parameters given as params. The method must return a
+   * compatible type such as a Flux.
+   * Returns a subscription that is used to fetch values as they become available.
+   *
+   * @param endpoint - Endpoint name.
+   * @param method - Method name to call in the endpoint class.
+   * @param params - Optional parameters to pass to the method.
+   * @returns A subscription used to handles values as they become available.
+   */
+  subscribe(endpoint, method, params) {
+    return this.fluxConnection.subscribe(endpoint, method, params ? Object.values(params) : []);
+  }
+}
+export {
+  ConnectClient
+};
+//# sourceMappingURL=Connect.js.map

package/Connect.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/Connect.ts"],
+  "sourcesContent": ["import type { ReactiveControllerHost } from '@lit/reactive-element';\nimport { ConnectionIndicator, ConnectionState } from '@vaadin/common-frontend';\nimport { getCsrfTokenHeadersForEndpointRequest } from './CsrfUtils.js';\nimport {\n  EndpointError,\n  EndpointResponseError,\n  EndpointValidationError,\n  ForbiddenResponseError,\n  UnauthorizedResponseError,\n  type ValidationErrorData,\n} from './EndpointErrors.js';\nimport { FluxConnection } from './FluxConnection.js';\nimport type { VaadinWindow } from './types.js';\n\nconst $wnd = window as VaadinWindow;\n\n$wnd.Vaadin ??= {};\n$wnd.Vaadin.registrations ??= [];\n$wnd.Vaadin.registrations.push({\n  is: 'endpoint',\n});\n\nexport type MaybePromise<T> = Promise<T> | T;\n\n/**\n * Represents the connection to and endpoint returning a subscription rather than a value.\n */\nexport interface Subscription<T> {\n  /** Cancels the subscription.  No values are made available after calling this. */\n  cancel(): void;\n\n  /*\n   * Binds to the given context (element) so that when the context is deactivated (element detached), the subscription is closed.\n   */\n  context(context: ReactiveControllerHost): Subscription<T>;\n\n  /** Called when the subscription has completed. No values are made available after calling this. */\n  onComplete(callback: () => void): Subscription<T>;\n\n  /** Called when an exception occured in the subscription. */\n  onError(callback: () => void): Subscription<T>;\n\n  /** Called when a new value is available. */\n  onNext(callback: (value: T) => void): Subscription<T>;\n}\n\ninterface ConnectExceptionData {\n  detail?: any;\n  message: string;\n  type: string;\n  validationErrorData?: ValidationErrorData[];\n}\n\n/**\n * Throws a TypeError if the response is not 200 OK.\n * @param response - The response to assert.\n */\nconst assertResponseIsOk = async (response: Response): Promise<void> => {\n  if (!response.ok) {\n    const errorText = await response.text();\n    let errorJson: ConnectExceptionData | null;\n    try {\n      errorJson = JSON.parse(errorText);\n    } catch (ignored) {\n      // not a json\n      errorJson = null;\n    }\n\n    const message =\n      errorJson?.message ??\n      (errorText.length > 0\n        ? errorText\n        : `expected \"200 OK\" response, but got ${response.status} ${response.statusText}`);\n    const type = errorJson?.type;\n\n    if (errorJson?.validationErrorData) {\n      throw new EndpointValidationError(message, errorJson.validationErrorData, type);\n    }\n\n    if (type) {\n      throw new EndpointError(message, type, errorJson?.detail);\n    }\n\n    switch (response.status) {\n      case 401:\n        throw new UnauthorizedResponseError(message, response);\n      case 403:\n        throw new ForbiddenResponseError(message, response);\n      default:\n        throw new EndpointResponseError(message, response);\n    }\n  }\n};\n\n/**\n * The `ConnectClient` constructor options.\n */\nexport interface ConnectClientOptions {\n  /**\n   * The `middlewares` property value.\n   */\n  middlewares?: Middleware[];\n  /**\n   * The `prefix` property value.\n   */\n  prefix?: string;\n  /**\n   * The Atmosphere options for the FluxConnection.\n   */\n  atmosphereOptions?: Partial<Atmosphere.Request>;\n}\n\nexport interface EndpointCallMetaInfo {\n  /**\n   * The endpoint name.\n   */\n  endpoint: string;\n\n  /**\n   * The method name to call on in the endpoint class.\n   */\n  method: string;\n\n  /**\n   * Optional object with method call arguments.\n   */\n  params?: Record<string, unknown>;\n}\n\n/**\n * An object with the call arguments and the related Request instance.\n * See also {@link ConnectClient.call | the call() method in ConnectClient}.\n */\nexport interface MiddlewareContext extends EndpointCallMetaInfo {\n  /**\n   * The Fetch API Request object reflecting the other properties.\n   */\n  request: Request;\n}\n\n/**\n * An async middleware callback that invokes the next middleware in the chain\n * or makes the actual request.\n * @param context - The information about the call and request\n */\nexport type MiddlewareNext = (context: MiddlewareContext) => MaybePromise<Response>;\n\n/**\n * An interface that allows defining a middleware as a class.\n */\nexport interface MiddlewareClass {\n  /**\n   * @param context - The information about the call and request\n   * @param next - Invokes the next in the call chain\n   */\n  invoke(context: MiddlewareContext, next: MiddlewareNext): MaybePromise<Response>;\n}\n\n/**\n * An async callback function that can intercept the request and response\n * of a call.\n */\nexport type MiddlewareFunction = (context: MiddlewareContext, next: MiddlewareNext) => MaybePromise<Response>;\n\n/**\n * An async callback that can intercept the request and response\n * of a call, could be either a function or a class.\n */\nexport type Middleware = MiddlewareClass | MiddlewareFunction;\n\nfunction isFlowLoaded(): boolean {\n  return $wnd.Vaadin?.Flow?.clients?.TypeScript !== undefined;\n}\n\n/**\n * A list of parameters supported by {@link ConnectClient.call | the call() method in ConnectClient}.\n */\nexport interface EndpointRequestInit {\n  /**\n   * An AbortSignal to set request's signal.\n   */\n  signal?: AbortSignal | null;\n}\n\n/**\n * A low-level network calling utility. It stores\n * a prefix and facilitates remote calls to endpoint class methods\n * on the Hilla backend.\n *\n * Example usage:\n *\n * ```js\n * const client = new ConnectClient();\n * const responseData = await client.call('MyEndpoint', 'myMethod');\n * ```\n *\n * ### Prefix\n *\n * The client supports an `prefix` constructor option:\n * ```js\n * const client = new ConnectClient({prefix: '/my-connect-prefix'});\n * ```\n *\n * The default prefix is '/connect'.\n *\n */\nexport class ConnectClient {\n  /**\n   * The array of middlewares that are invoked during a call.\n   */\n  middlewares: Middleware[] = [];\n  /**\n   * The Hilla endpoint prefix\n   */\n  prefix = '/connect';\n  /**\n   * The Atmosphere options for the FluxConnection.\n   */\n  atmosphereOptions: Partial<Atmosphere.Request> = {};\n\n  #fluxConnection?: FluxConnection;\n\n  /**\n   * @param options - Constructor options.\n   */\n  constructor(options: ConnectClientOptions = {}) {\n    if (options.prefix) {\n      this.prefix = options.prefix;\n    }\n\n    if (options.middlewares) {\n      this.middlewares = options.middlewares;\n    }\n\n    if (options.atmosphereOptions) {\n      this.atmosphereOptions = options.atmosphereOptions;\n    }\n\n    // add connection indicator to DOM\n    ConnectionIndicator.create();\n\n    // Listen to browser online/offline events and update the loading indicator accordingly.\n    // Note: if Flow.ts is loaded, it instead handles the state transitions.\n    addEventListener('online', () => {\n      if (!isFlowLoaded() && $wnd.Vaadin?.connectionState) {\n        $wnd.Vaadin.connectionState.state = ConnectionState.CONNECTED;\n      }\n    });\n    addEventListener('offline', () => {\n      if (!isFlowLoaded() && $wnd.Vaadin?.connectionState) {\n        $wnd.Vaadin.connectionState.state = ConnectionState.CONNECTION_LOST;\n      }\n    });\n  }\n\n  /**\n   * Gets a representation of the underlying persistent network connection used for subscribing to Flux type endpoint\n   * methods.\n   */\n  get fluxConnection(): FluxConnection {\n    if (!this.#fluxConnection) {\n      this.#fluxConnection = new FluxConnection(this.prefix, this.atmosphereOptions);\n    }\n    return this.#fluxConnection;\n  }\n\n  /**\n   * Calls the given endpoint method defined using the endpoint and method\n   * parameters with the parameters given as params.\n   * Asynchronously returns the parsed JSON response data.\n   *\n   * @param endpoint - Endpoint name.\n   * @param method - Method name to call in the endpoint class.\n   * @param params - Optional parameters to pass to the method.\n   * @param init - Optional parameters for the request\n   * @returns Decoded JSON response data.\n   */\n  async call(\n    endpoint: string,\n    method: string,\n    params?: Record<string, unknown>,\n    init?: EndpointRequestInit,\n  ): Promise<any> {\n    if (arguments.length < 2) {\n      throw new TypeError(`2 arguments required, but got only ${arguments.length}`);\n    }\n\n    const csrfHeaders = getCsrfTokenHeadersForEndpointRequest(document);\n    const headers: Record<string, string> = {\n      Accept: 'application/json',\n      'Content-Type': 'application/json',\n      ...csrfHeaders,\n    };\n\n    const request = new Request(`${this.prefix}/${endpoint}/${method}`, {\n      body:\n        params !== undefined ? JSON.stringify(params, (_, value) => (value === undefined ? null : value)) : undefined,\n      headers,\n      method: 'POST',\n    });\n\n    // The middleware `context`, includes the call arguments and the request\n    // constructed from them\n    const initialContext: MiddlewareContext = {\n      endpoint,\n      method,\n      params,\n      request,\n    };\n\n    // The internal middleware to assert and parse the response. The internal\n    // response handling should come last after the other middlewares are done\n    // with processing the response. That is why this middleware is first\n    // in the final middlewares array.\n    async function responseHandlerMiddleware(context: MiddlewareContext, next: MiddlewareNext): Promise<Response> {\n      const response = await next(context);\n      await assertResponseIsOk(response);\n      const text = await response.text();\n      return JSON.parse(text, (_, value: any) => (value === null ? undefined : value));\n    }\n\n    // The actual fetch call itself is expressed as a middleware\n    // chain item for our convenience. Always having an ending of the chain\n    // this way makes the folding down below more concise.\n    async function fetchNext(context: MiddlewareContext) {\n      $wnd.Vaadin?.connectionState?.loadingStarted();\n      try {\n        const response = await fetch(context.request, { signal: init?.signal });\n        $wnd.Vaadin?.connectionState?.loadingFinished();\n        return response;\n      } catch (error: unknown) {\n        // don't bother about connections aborted by purpose\n        if (error instanceof Error && error.name === 'AbortError') {\n          $wnd.Vaadin?.connectionState?.loadingFinished();\n        } else {\n          $wnd.Vaadin?.connectionState?.loadingFailed();\n        }\n        return Promise.reject(error);\n      }\n    }\n\n    // Assemble the final middlewares array from internal\n    // and external middlewares\n    const middlewares = [responseHandlerMiddleware as Middleware, ...this.middlewares];\n\n    // Fold the final middlewares array into a single function\n    const chain = middlewares.reduceRight(\n      (next: MiddlewareNext, middleware) =>\n        // Compose and return the new chain step, that takes the context and\n        // invokes the current middleware with the context and the further chain\n        // as the next argument\n        async (context) => {\n          if (typeof middleware === 'function') {\n            return middleware(context, next);\n          }\n          return middleware.invoke(context, next);\n        },\n      // Initialize reduceRight the accumulator with `fetchNext`\n      fetchNext,\n    );\n\n    // Invoke all the folded async middlewares and return\n    return chain(initialContext);\n  }\n\n  /**\n   * Subscribes to the given method defined using the endpoint and method\n   * parameters with the parameters given as params. The method must return a\n   * compatible type such as a Flux.\n   * Returns a subscription that is used to fetch values as they become available.\n   *\n   * @param endpoint - Endpoint name.\n   * @param method - Method name to call in the endpoint class.\n   * @param params - Optional parameters to pass to the method.\n   * @returns A subscription used to handles values as they become available.\n   */\n  subscribe(endpoint: string, method: string, params?: any): Subscription<any> {\n    return this.fluxConnection.subscribe(endpoint, method, params ? Object.values(params) : []);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/CookieManager.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="js-cookie" />
+export declare function calculatePath({ pathname }: URL): string;
+declare const CookieManager: Cookies.CookiesStatic;
+export default CookieManager;
+//# sourceMappingURL=CookieManager.d.ts.map

package/CookieManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieManager.d.ts","sourceRoot":"","sources":["src/CookieManager.ts"],"names":[],"mappings":";AAEA,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,GAAG,MAAM,CAEvD;AAED,QAAA,MAAM,aAAa,EAAE,OAAO,CAAC,aAE3B,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/CookieManager.js

@@ -0,0 +1,13 @@
+import Cookies from "js-cookie";
+function calculatePath({ pathname }) {
+  return pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname;
+}
+const CookieManager = Cookies.withAttributes({
+  path: calculatePath(new URL(document.baseURI))
+});
+var CookieManager_default = CookieManager;
+export {
+  calculatePath,
+  CookieManager_default as default
+};
+//# sourceMappingURL=CookieManager.js.map

package/CookieManager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/CookieManager.ts"],
+  "sourcesContent": ["import Cookies from 'js-cookie';\n\nexport function calculatePath({ pathname }: URL): string {\n  return pathname.length > 1 && pathname.endsWith('/') ? pathname.slice(0, -1) : pathname;\n}\n\nconst CookieManager: Cookies.CookiesStatic = Cookies.withAttributes({\n  path: calculatePath(new URL(document.baseURI)),\n});\n\nexport default CookieManager;\n"],
+  "mappings": "AAAA,OAAO,aAAa;AAEb,SAAS,cAAc,EAAE,SAAS,GAAgB;AACvD,SAAO,SAAS,SAAS,KAAK,SAAS,SAAS,GAAG,IAAI,SAAS,MAAM,GAAG,EAAE,IAAI;AACjF;AAEA,MAAM,gBAAuC,QAAQ,eAAe;AAAA,EAClE,MAAM,cAAc,IAAI,IAAI,SAAS,OAAO,CAAC;AAC/C,CAAC;AAED,IAAO,wBAAQ;",
+  "names": []
+}