@pontive/pontkit-core 1.7.2 → 1.7.4

package/dist/components/widgets/flow-widget.d.ts

@@ -0,0 +1,32 @@
+import { LitElement } from 'lit';
+import { BrandingEntitlements } from '../../context';
+/**
+ * A widget that runs one flow: sign-in, sign-up or invitation.
+ *
+ * It starts the flow once Auth is configured, starts it again when the locale
+ * changes or the layout asks for it, and renders whatever the flow's render
+ * spec says. When the flow cannot be started it says so, with a way to try
+ * again. It used to log the failure and render nothing, so the page stayed
+ * blank, or on its loading fallback, with nothing to tell the person why.
+ */
+export declare abstract class PontFlowWidget extends LitElement {
+    renderSpec: string | null;
+    branding: BrandingEntitlements;
+    locales: string;
+    /** Why the flow could not be started, as the person should read it. */
+    private startError?;
+    /** Starts this widget's flow. */
+    protected abstract startFlow(): Promise<unknown>;
+    createRenderRoot(): this;
+    private __flowStarted;
+    private __initialized;
+    private __previousLocale;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected firstUpdated(): void;
+    protected updated(changedProperties: Map<string, unknown>): void;
+    private restart;
+    private startAuthFlow;
+    private tryRemoveFallback;
+    render(): import('lit-html').TemplateResult<1>;
+}

package/dist/components/widgets/pont-invitation/pont-invitation.d.ts

@@ -1,5 +1,4 @@
-import { LitElement } from 'lit';
-import { BrandingEntitlements } from '../../../context';
+import { PontFlowWidget } from '../flow-widget';
 /**
  * Accepting an invitation.
  *
@@ -19,17 +18,6 @@ import { BrandingEntitlements } from '../../../context';
  * sign-in and sign-up: the instance's own invitation widgets, if it has
  * published any, and otherwise the built-in ones.
  */
-export declare class PontInvitation extends LitElement {
-    renderSpec: string | null;
-    branding: BrandingEntitlements;
-    locales: string;
-    createRenderRoot(): this;
-    private __flowStarted;
-    private __initialized;
-    private __previousLocale;
-    protected firstUpdated(): void;
-    protected updated(changedProperties: Map<string, unknown>): void;
-    private startAuthFlow;
-    private tryRemoveFallback;
-    render(): import('lit-html').TemplateResult<1>;
+export declare class PontInvitation extends PontFlowWidget {
+    protected startFlow(): Promise<import('@pontive/oidc-client').StartLoginflowResponse>;
 }

package/dist/components/widgets/pont-signin/pont-signin.d.ts

@@ -1,16 +1,4 @@
-import { LitElement } from 'lit';
-import { BrandingEntitlements } from '../../../context';
-export declare class PontSignIn extends LitElement {
-    renderSpec: string | null;
-    branding: BrandingEntitlements;
-    locales: string;
-    createRenderRoot(): this;
-    private __flowStarted;
-    private __initialized;
-    private __previousLocale;
-    protected firstUpdated(): void;
-    protected updated(changedProperties: Map<string, unknown>): void;
-    private startAuthFlow;
-    private tryRemoveFallback;
-    render(): import('lit-html').TemplateResult<1>;
+import { PontFlowWidget } from '../flow-widget';
+export declare class PontSignIn extends PontFlowWidget {
+    protected startFlow(): Promise<import('@pontive/oidc-client').StartLoginflowResponse>;
 }

package/dist/components/widgets/pont-signup/pont-signup.d.ts

@@ -1,16 +1,4 @@
-import { LitElement } from 'lit';
-import { BrandingEntitlements } from '../../../context';
-export declare class PontSignUp extends LitElement {
-    renderSpec: string | null;
-    branding: BrandingEntitlements;
-    locales: string;
-    createRenderRoot(): this;
-    private __flowStarted;
-    private __initialized;
-    private __previousLocale;
-    protected firstUpdated(): void;
-    protected updated(changedProperties: Map<string, unknown>): void;
-    private startAuthFlow;
-    private tryRemoveFallback;
-    render(): import('lit-html').TemplateResult<1>;
+import { PontFlowWidget } from '../flow-widget';
+export declare class PontSignUp extends PontFlowWidget {
+    protected startFlow(): Promise<import('@pontive/oidc-client').StartLoginflowResponse>;
 }

package/dist/components/wrappers/layout/layout.d.ts

@@ -33,6 +33,23 @@ export declare class PontKitLayout extends LitElement {
      */
     branding: BrandingEntitlements;
     createRenderRoot(): this;
+    /**
+     * Asks the widget hosting this layout to start its flow again. Fired from the
+     * banner of a flow that has ended, whose screen takes no more events.
+     */
+    static readonly RESTART_EVENT = "pont-layout:restart";
+    /**
+     * Every element that talks to the flow reports a failed call with one of
+     * these. A failure the flow can recover from comes back as a screen with the
+     * server's banner already in it; these are the rest — the request failed, or
+     * the flow is over — and each must reach the screen, or the person is left
+     * on a page that does nothing when they press it.
+     */
+    private static readonly ERROR_EVENTS;
+    /** Marks the elements of a banner this layout put on the screen. */
+    private static readonly BANNER_ATTR;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     updated(): void;
     private renderDynamicContent;
     /** Tags already reported on this page, so a re-render does not repeat them. */
@@ -54,4 +71,11 @@ export declare class PontKitLayout extends LitElement {
     private static reportUnregistered;
     render(): import('lit-html').TemplateResult<1>;
     private handleError;
+    /**
+     * Shows a failure as the server shows one: an error alert at the top of the
+     * widget's block, below its logo and header. It replaces any banner already
+     * there, so the screen holds one error at a time, and goes with the screen
+     * when the next render spec replaces the content.
+     */
+    private showError;
 }