@unidy.io/sdk 1.2.0-alpha9 → 1.2.0

package/dist/types/newsletter/components/logout-button/logout-button.d.ts

@@ -1,8 +1,17 @@
-export declare class LogoutButton {
-    el: HTMLElement;
+declare const NewsletterLogoutButton_base: abstract new (...args: any[]) => {
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+} & {
+    hasSlot: boolean;
+    connectedCallback(): void;
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+};
+export declare class NewsletterLogoutButton extends NewsletterLogoutButton_base {
     componentClassName: string;
-    private hasSlot;
-    componentWillLoad(): Promise<void>;
     private handleLogout;
     render(): any;
 }
+export {};

package/dist/types/newsletter/components/newsletter-root/newsletter-root.d.ts

@@ -1,11 +1,25 @@
-import { UnidyComponent } from "../../../logger";
+import { type EventEmitter } from "../../../stencil-public-runtime";
 import { type NewsletterErrorIdentifier } from "../../store/newsletter-store";
 import type { NewsletterButtonFor } from "../submit-button/newsletter-submit-button";
-export declare class NewsletterRoot extends UnidyComponent {
+declare const NewsletterRoot_base: abstract new (...args: any[]) => {
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+};
+export declare class NewsletterRoot extends NewsletterRoot_base {
     el: HTMLElement;
     componentClassName: string;
+    uNewsletterSuccess: EventEmitter<{
+        email: string;
+        newsletters: string[];
+    }>;
+    uNewsletterError: EventEmitter<{
+        email: string;
+        error: string;
+    }>;
     getErrorText(errorIdentifier: NewsletterErrorIdentifier): string;
     componentWillLoad(): Promise<void>;
     submit(forType?: NewsletterButtonFor): Promise<void>;
     render(): any;
 }
+export {};

package/dist/types/newsletter/newsletter-helpers.d.ts

@@ -1,12 +1,18 @@
 import { type ExistingSubscription } from "./store/newsletter-store";
 export declare function newsletterLogout(): void;
 export declare function resendDoi(internalName: string): Promise<boolean>;
-export declare function sendLoginEmail(email: string): Promise<void>;
+export type LoginEmailResult = {
+    success: true;
+} | {
+    success: false;
+    error: "rate_limit_exceeded" | "not_found" | "unknown";
+};
+export declare function sendLoginEmail(email: string): Promise<LoginEmailResult>;
 export declare function fetchSubscriptions(): Promise<void>;
 export declare function subscribeToNewsletter(internalName: string, email: string): Promise<boolean>;
 export declare function createSubscriptions({ email }: {
     email: string;
-}): Promise<void>;
+}): Promise<boolean>;
 export declare function deleteSubscription(internalName: string): Promise<boolean>;
 export declare function getSubscription(internalName: string): ExistingSubscription | undefined;
 export declare function isSubscribed(internalName: string): boolean;

package/dist/types/newsletter/store/newsletter-store.d.ts

@@ -1,4 +1,4 @@
-export type NewsletterErrorIdentifier = "unconfirmed" | "already_subscribed" | "consent_required" | "invalid_email" | "newsletter_not_found" | "preferences_not_found" | "invalid_preference_token" | "unknown";
+export type NewsletterErrorIdentifier = "unconfirmed" | "already_subscribed" | "consent_required" | "invalid_email" | "newsletter_not_found" | "preferences_not_found" | "invalid_preference_token" | "internal_server_error" | "user_validation_error" | "unknown";
 export type NewsletterInternalName = string;
 export type PreferenceIdentifier = string;
 export interface ExistingSubscription {
@@ -8,11 +8,18 @@ export interface ExistingSubscription {
 }
 export type CheckedNewsletters = Record<NewsletterInternalName, PreferenceIdentifier[]>;
 export type DefaultPreferences = Record<NewsletterInternalName, Set<PreferenceIdentifier>>;
+export interface AdditionalFieldNode {
+    value?: string | string[];
+    type?: string;
+}
+export type AdditionalFieldsData = Record<string, AdditionalFieldNode>;
 interface NewsletterState {
     email: string;
     preferenceToken: string;
     checkedNewsletters: CheckedNewsletters;
     defaultPreferences: DefaultPreferences;
+    additionalFields: AdditionalFieldsData;
+    additionalFieldErrors: Record<string, string>;
     fetchingSubscriptions: boolean;
     existingSubscriptions: ExistingSubscription[];
     errors: Record<string, NewsletterErrorIdentifier>;

package/dist/types/profile/api/profile.d.ts

@@ -1,7 +1,7 @@
-import { BaseService, type ApiClientInterface, type CommonErrors, type ServiceDependencies, type Payload } from "../../api/base-service";
+import { type ApiClientInterface, BaseService, type CommonErrors, type Payload, type ServiceDependencies } from "../../api/base-service";
 import { type ProfileErrorResponse, type UserProfileData, type UserProfileFormError } from "./schemas";
+export type { ProfileErrorResponse, UserProfileData, UserProfileFormError } from "./schemas";
 export { UserProfileSchema } from "./schemas";
-export type { UserProfileData, ProfileErrorResponse, UserProfileFormError } from "./schemas";
 export type UpdateProfilePayload = Record<string, unknown>;
 export type ProfileUpdateArgs = Payload<UpdateProfilePayload>;
 export type ResponseInfo = {

package/dist/types/profile/api/schemas.d.ts

@@ -16,7 +16,7 @@ export declare const BaseFieldDataSchema: z.ZodObject<{
     label: z.ZodString;
     attr_name: z.ZodString;
     locked: z.ZodOptional<z.ZodBoolean>;
-    locked_text: z.ZodOptional<z.ZodString>;
+    locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>;
 export declare const SelectOptionSchema: z.ZodObject<{
     value: z.ZodString;
@@ -33,7 +33,7 @@ export declare const TextFieldSchema: z.ZodObject<{
     label: z.ZodString;
     attr_name: z.ZodString;
     locked: z.ZodOptional<z.ZodBoolean>;
-    locked_text: z.ZodOptional<z.ZodString>;
+    locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     value: z.ZodNullable<z.ZodString>;
     type: z.ZodEnum<{
         text: "text";
@@ -45,7 +45,7 @@ export declare const PhoneFieldSchema: z.ZodObject<{
     label: z.ZodString;
     attr_name: z.ZodString;
     locked: z.ZodOptional<z.ZodBoolean>;
-    locked_text: z.ZodOptional<z.ZodString>;
+    locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     value: z.ZodNullable<z.ZodString>;
     type: z.ZodLiteral<"tel">;
 }, z.core.$strict>;
@@ -54,7 +54,7 @@ export declare const RadioFieldSchema: z.ZodObject<{
     label: z.ZodString;
     attr_name: z.ZodString;
     locked: z.ZodOptional<z.ZodBoolean>;
-    locked_text: z.ZodOptional<z.ZodString>;
+    locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     value: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"_NOT_SET_">, z.ZodBoolean]>>;
     type: z.ZodLiteral<"radio">;
     radio_options: z.ZodArray<z.ZodObject<{
@@ -68,7 +68,7 @@ export declare const SelectFieldSchema: z.ZodObject<{
     label: z.ZodString;
     attr_name: z.ZodString;
     locked: z.ZodOptional<z.ZodBoolean>;
-    locked_text: z.ZodOptional<z.ZodString>;
+    locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     value: z.ZodNullable<z.ZodString>;
     type: z.ZodLiteral<"select">;
     options: z.ZodArray<z.ZodObject<{
@@ -81,7 +81,7 @@ export declare const DateFieldSchema: z.ZodObject<{
     label: z.ZodString;
     attr_name: z.ZodString;
     locked: z.ZodOptional<z.ZodBoolean>;
-    locked_text: z.ZodOptional<z.ZodString>;
+    locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     value: z.ZodNullable<z.ZodString>;
     type: z.ZodEnum<{
         date: "date";
@@ -93,7 +93,7 @@ export declare const CustomFieldSchema: z.ZodObject<{
     label: z.ZodString;
     attr_name: z.ZodString;
     locked: z.ZodOptional<z.ZodBoolean>;
-    locked_text: z.ZodOptional<z.ZodString>;
+    locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     value: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodString>]>>;
     type: z.ZodEnum<{
         number: "number";
@@ -124,7 +124,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"_NOT_SET_">, z.ZodBoolean]>>;
         type: z.ZodLiteral<"radio">;
         radio_options: z.ZodArray<z.ZodObject<{
@@ -138,7 +138,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             text: "text";
@@ -150,7 +150,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             text: "text";
@@ -162,7 +162,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             text: "text";
@@ -174,7 +174,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodLiteral<"tel">;
     }, z.core.$strict>;
@@ -183,7 +183,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             text: "text";
@@ -195,7 +195,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             text: "text";
@@ -207,7 +207,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             text: "text";
@@ -219,7 +219,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             text: "text";
@@ -231,7 +231,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             text: "text";
@@ -243,7 +243,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodLiteral<"select">;
         options: z.ZodArray<z.ZodObject<{
@@ -256,7 +256,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             date: "date";
@@ -268,7 +268,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodString>;
         type: z.ZodEnum<{
             text: "text";
@@ -280,7 +280,7 @@ export declare const UserProfileSchema: z.ZodObject<{
         label: z.ZodString;
         attr_name: z.ZodString;
         locked: z.ZodOptional<z.ZodBoolean>;
-        locked_text: z.ZodOptional<z.ZodString>;
+        locked_text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         value: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodString>]>>;
         type: z.ZodEnum<{
             number: "number";

package/dist/types/profile/components/raw-field/raw-field.d.ts

@@ -1,8 +1,12 @@
-import { UnidyComponent } from "../../../logger";
 import { type MultiSelectOption } from "../raw-input-fields/MultiSelect";
 import { type RadioOption } from "../raw-input-fields/RadioGroup";
 import { type Option } from "../raw-input-fields/Select";
-export declare class RawField extends UnidyComponent {
+declare const RawField_base: abstract new (...args: any[]) => {
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+};
+export declare class RawField extends RawField_base {
     required: boolean;
     readonlyPlaceholder: string;
     countryCodeDisplayOption?: "icon" | "label";
@@ -30,8 +34,15 @@ export declare class RawField extends UnidyComponent {
     };
     el: HTMLElement;
     selected?: string | string[];
+    private get context();
     private readStore;
+    private readProfileStore;
+    private readNewsletterStore;
     private writeStore;
+    private writeProfileStore;
+    private writeNewsletterStore;
+    private getErrors;
+    private setErrors;
     private runExternalValidator;
     private validateValue;
     private getNormalizedOptions;
@@ -43,3 +54,4 @@ export declare class RawField extends UnidyComponent {
     componentDidRender(): void;
     render(): any;
 }
+export {};

package/dist/types/shared/base/component.d.ts

@@ -0,0 +1,46 @@
+import { type MixedInCtor } from "../../stencil-public-runtime";
+import { type Logger } from "../../logger";
+export declare const loggerFactory: <B extends MixedInCtor>(Base: B) => {
+    new (...args: any[]): {
+        /** @internal */
+        __logger: Logger | null;
+        get logger(): Logger;
+        get element(): import("@stencil/core/internal").HTMLStencilElement;
+    };
+} & B;
+export type BaseComponentType = ReturnType<typeof loggerFactory>;
+/**
+ * Base class factory for Unidy Stencil components that provides logging functionality
+ * and allows composing additional mixins.
+ * Components extending this class get a `this.logger` property that automatically prefixes log messages with the component's class name.
+ * Components extending this class get a `this.element` property that automatically returns the component's host element.
+ */
+export declare const UnidyComponent: <T extends ((base: MixedInCtor) => MixedInCtor)[]>(...mixins: T) => abstract new (...args: any[]) => (((readonly [<B extends MixedInCtor>(Base: B) => {
+    new (...args: any[]): {
+        /** @internal */
+        __logger: Logger | null;
+        get logger(): Logger;
+        get element(): import("@stencil/core/internal").HTMLStencilElement;
+    };
+} & B, ...T])[number] extends infer T_1 ? T_1 extends (readonly [<B extends MixedInCtor>(Base: B) => {
+    new (...args: any[]): {
+        /** @internal */
+        __logger: Logger | null;
+        get logger(): Logger;
+        get element(): import("@stencil/core/internal").HTMLStencilElement;
+    };
+} & B, ...T])[number] ? T_1 extends (base: MixedInCtor) => MixedInCtor<infer I> ? I : never : never : never) extends infer T_2 ? T_2 extends ((readonly [<B extends MixedInCtor>(Base: B) => {
+    new (...args: any[]): {
+        /** @internal */
+        __logger: Logger | null;
+        get logger(): Logger;
+        get element(): import("@stencil/core/internal").HTMLStencilElement;
+    };
+} & B, ...T])[number] extends infer T_3 ? T_3 extends (readonly [<B extends MixedInCtor>(Base: B) => {
+    new (...args: any[]): {
+        /** @internal */
+        __logger: Logger | null;
+        get logger(): Logger;
+        get element(): import("@stencil/core/internal").HTMLStencilElement;
+    };
+} & B, ...T])[number] ? T_3 extends (base: MixedInCtor) => MixedInCtor<infer I> ? I : never : never : never) ? T_2 extends any ? (k: T_2) => void : never : never : never) extends (k: infer I_1) => void ? I_1 : never;

package/dist/types/shared/base/has-slot-content.d.ts

@@ -0,0 +1,10 @@
+import type { BaseComponentType } from "./component";
+export declare const HasSlotContent: <B extends BaseComponentType>(Base?: B) => {
+    new (...args: any[]): {
+        hasSlot: boolean;
+        connectedCallback(): void;
+        __logger: import("../../logger").Logger | null;
+        get logger(): import("../../logger").Logger;
+        get element(): import("@stencil/core/internal").HTMLStencilElement;
+    };
+} & B;

package/dist/types/shared/component-utils.d.ts

@@ -1,16 +1,24 @@
 /**
- * Checks if a Stencil component's slot has content.
- * Use this in components to render fallback content when a slot is empty.
+ * Returns slot fallback content with proper loading handling for shadow: false components.
+ * When there's slot content, we must always render the <slot /> element to capture it,
+ * otherwise the slotted content will be visible even during loading state.
  *
- * IMPORTANT: (for shadow: false components)
- * You MUST call this in `componentWillLoad()` and cache the result in an instance property.
- * After the first render, `element.childNodes` will contain both user-provided slot content
- * AND the component's rendered internal elements (like <button>), causing false positives.
+ * @param fallbackText - The default text to display when there's no slot content
+ * @param options - Options object containing hasSlot and loading state
+ * @returns JSX content for the slot fallback
  *
- * Take a look at the https://stenciljs.com/docs/templating-jsx#slots-outside-shadow-dom
- *
- * @param element - The host element of the component (accessed via @Element())
- * @returns true if the slot has content, false otherwise
+ * @example
+ * ```tsx
+ * render() {
+ *   return (
+ *     <button>
+ *       {slotFallbackText(t("buttons.submit"), { hasSlot: this.hasSlot, loading: this.isLoading() })}
+ *     </button>
+ *   );
+ * }
+ * ```
  */
-export declare function hasSlotContent(element: HTMLElement): boolean;
-export declare function clearUrlParam(param: string): string | null;
+export declare function slotFallbackText(fallbackText: string, { hasSlot, loading }: {
+    hasSlot: boolean;
+    loading?: boolean;
+}): any;

package/dist/types/shared/components/conditional-render/conditional-render.d.ts

@@ -1,6 +1,10 @@
 import { type AuthState } from "../../../auth/store/auth-store";
-import { UnidyComponent } from "../../../logger";
-export declare class ConditionalRender extends UnidyComponent {
+declare const ConditionalRender_base: abstract new (...args: any[]) => {
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+};
+export declare class ConditionalRender extends ConditionalRender_base {
     when?: string;
     is?: string;
     not: boolean;
@@ -9,3 +13,4 @@ export declare class ConditionalRender extends UnidyComponent {
     private shouldRender;
     render(): any;
 }
+export {};

package/dist/types/shared/components/config/config.d.ts

@@ -1,5 +1,4 @@
 import { type EventEmitter } from "../../../stencil-public-runtime";
-import { UnidyComponent } from "../../../logger";
 export interface Config {
     apiKey: string;
     baseUrl: string;
@@ -14,7 +13,12 @@ export interface ConfigChange {
 type TranslationTree = {
     [key: string]: string | TranslationTree;
 };
-export declare class UnidyConfig extends UnidyComponent {
+declare const UnidyConfig_base: abstract new (...args: any[]) => {
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+};
+export declare class UnidyConfig extends UnidyConfig_base {
     mode: "production" | "development";
     baseUrl: string;
     apiKey: string;
@@ -25,6 +29,7 @@ export declare class UnidyConfig extends UnidyComponent {
     unidyInitialized: EventEmitter<Config>;
     configChange: EventEmitter<ConfigChange>;
     componentWillLoad(): Promise<void>;
+    disconnectedCallback(): void;
     onPropChange(newValue: string, oldValue: string, propName: keyof Config): void;
     render(): any;
     private loadCustomTranslations;

package/dist/types/shared/components/error-message/error-message.d.ts

@@ -1,15 +1,27 @@
 export type AuthErrorType = "email" | "password" | "magicCode" | "resetPassword" | "general" | "connection" | "passkey";
-export declare class ErrorMessage {
+declare const ErrorMessage_base: abstract new (...args: any[]) => {
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+} & {
+    hasSlot: boolean;
+    connectedCallback(): void;
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+};
+export declare class ErrorMessage extends ErrorMessage_base {
     componentClassName: string;
     for: string;
     errorMessages?: Record<string, string>;
-    el: HTMLElement;
     private detectContext;
     private get context();
     private getAuthErrorMessage;
     private getNewsletterErrorMessage;
     private getErrorMessage;
+    private translateValidationError;
     private getAuthErrorCode;
     private getNewsletterErrorCode;
     render(): any;
 }
+export {};

package/dist/types/shared/components/submit-button/submit-button.d.ts

@@ -1,20 +1,29 @@
 import { type AuthButtonFor } from "../../../auth/components/submit-button/auth-submit-button";
 import { type NewsletterButtonFor } from "../../../newsletter/components/submit-button/newsletter-submit-button";
-export declare class SubmitButton {
-    el: HTMLElement;
+declare const SubmitButton_base: abstract new (...args: any[]) => {
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+} & {
+    hasSlot: boolean;
+    connectedCallback(): void;
+    __logger: import("../../../logger").Logger | null;
+    get logger(): import("../../../logger").Logger;
+    get element(): import("@stencil/core/internal").HTMLStencilElement;
+};
+export declare class SubmitButton extends SubmitButton_base {
     for?: AuthButtonFor | NewsletterButtonFor;
     text?: string;
     disabled: boolean;
     componentClassName: string;
     private context;
     private contextModule;
-    private hasSlot;
     componentWillLoad(): Promise<void>;
     private detectContext;
     private handleClick;
     private isDisabled;
     private isLoading;
     private getButtonText;
-    private getButtonContent;
     render(): any;
 }
+export {};

package/dist/types/shared/context-utils.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Type map for parent component lookups.
+ * Maps custom element tag names to their corresponding TypeScript types.
+ */
+type ParentComponentMap = {
+    "u-profile": HTMLUProfileElement;
+    "u-signin-root": HTMLUSigninRootElement;
+    "u-signin-step": HTMLUSigninStepElement;
+    "u-newsletter-root": HTMLUNewsletterRootElement;
+    "u-ticketable-list": HTMLUTicketableListElement;
+};
+/**
+ * Component context types used throughout the SDK.
+ */
+export type ComponentContext = "auth" | "profile" | "newsletter" | "ticketable";
+/**
+ * Generic helper to find a parent component by tag name with proper typing.
+ *
+ * @param element - The element to start searching from
+ * @param tagName - The tag name of the parent component to find
+ * @returns The parent component element or null if not found
+ *
+ * @example
+ * const profile = findParent(this.el, "u-profile");
+ * profile?.submitProfile();
+ */
+export declare function findParent<T extends keyof ParentComponentMap>(element: HTMLElement, tagName: T): ParentComponentMap[T] | null;
+/**
+ * Find the parent u-profile component.
+ */
+export declare function findParentProfile(element: HTMLElement): HTMLUProfileElement | null;
+/**
+ * Find the parent u-signin-root component.
+ */
+export declare function findParentSigninRoot(element: HTMLElement): HTMLUSigninRootElement | null;
+/**
+ * Find the parent u-signin-step component.
+ */
+export declare function findParentSigninStep(element: HTMLElement): HTMLUSigninStepElement | null;
+/**
+ * Find the parent u-newsletter-root component.
+ */
+export declare function findParentNewsletterRoot(element: HTMLElement): HTMLUNewsletterRootElement | null;
+/**
+ * Find the parent u-ticketable-list component.
+ */
+export declare function findParentTicketableList(element: HTMLElement): HTMLUTicketableListElement | null;
+/**
+ * Detects which component context an element is within.
+ * Returns null if not within any known context.
+ *
+ * @param element - The element to detect context for
+ * @returns The detected context or null
+ *
+ * @example
+ * const context = detectContext(this.el);
+ * if (context === "auth") { ... }
+ */
+export declare function detectContext(element: HTMLElement): ComponentContext | null;
+/**
+ * Detects component context, throwing an error if not found.
+ * Use this when the component requires being within a specific context.
+ *
+ * @param element - The element to detect context for
+ * @param componentName - Name of the component for error message
+ * @returns The detected context
+ * @throws Error if no context is found
+ *
+ * @example
+ * const context = detectContextOrThrow(this.el, "submit button");
+ */
+export declare function detectContextOrThrow(element: HTMLElement, componentName: string): ComponentContext;
+export {};

package/dist/types/shared/utils/redirect-with-token.d.ts

@@ -0,0 +1,21 @@
+export interface RedirectWithTokenOptions {
+    /** The authentication token */
+    token: string;
+    /** If true, opens in a new tab. Defaults to false. */
+    newTab?: boolean;
+    /** Additional query parameters to add to the redirect URL */
+    extraParams?: Record<string, string>;
+}
+/**
+ * Redirects to Unidy's one_time_login endpoint with a token.
+ *
+ * @example
+ * ```ts
+ * redirectWithToken({
+ *   token: "abc123",
+ *   newTab: true,
+ *   extraParams: { redirect_uri: "https://example.com" }
+ * });
+ * ```
+ */
+export declare function redirectWithToken({ token, newTab, extraParams }: RedirectWithTokenOptions): void;

package/dist/types/shared/utils/url-utils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Removes a query parameter from the current URL and updates the browser history.
+ * Uses `replaceState` to avoid adding a new history entry.
+ *
+ * @param param - The name of the query parameter to remove
+ * @returns The value of the removed parameter, or null if it wasn't present
+ *
+ * @example
+ * ```ts
+ * // URL: https://example.com?token=abc123&foo=bar
+ * const token = clearUrlParam("token");
+ * // token = "abc123"
+ * // URL is now: https://example.com?foo=bar
+ * ```
+ */
+export declare function clearUrlParam(param: string): string | null;