@pontive/pontkit-core 1.0.0

package/dist/types/layout/index.d.ts

@@ -0,0 +1,256 @@
+import { Style } from '../styles';
+export interface Container {
+    type: "flex_column" | "flex_row";
+    alignment?: "start" | "center" | "end";
+    children: UIElement[];
+}
+export interface ValidationRule {
+    type: "required" | "min_length" | "max_length" | "min_value" | "max_value" | "email" | "phone" | "date" | "regex" | "field_match";
+    error_message: string;
+    length?: number;
+    value?: string;
+    regex?: string;
+    field_match?: string;
+}
+export type ValidationOnEvent = "change" | "blur" | "submit";
+export interface Input {
+    type: "number" | "text" | "password" | "email" | "hidden" | "search" | "tel" | "url" | "date" | "month" | "week" | "time" | "datetime-local" | "range" | "color" | "file";
+    placeholder?: string;
+    autocomplete?: string;
+    hint?: string;
+    initial_value?: string;
+    data_key?: string;
+    validation?: {
+        rules: ValidationRule[];
+        on_event: ValidationOnEvent;
+    };
+    label?: string;
+}
+export interface ImageVariants {
+    dark?: string;
+    light?: string;
+}
+export interface Image {
+    image_url: string;
+    link_url?: string;
+}
+export interface Spinner {
+    size: number;
+}
+export interface Gap {
+    type: "vertical" | "horizontal";
+    size: string;
+}
+export interface Label {
+    for?: string;
+    content: string;
+}
+export interface Logo {
+    image_url: string;
+}
+export interface Watermark {
+    image_url: string;
+    label: string;
+}
+export interface Text {
+    content: string;
+    text_alignment?: "left" | "center" | "right";
+}
+export interface Html {
+    content: string;
+}
+export interface Button {
+    type: "secondary" | "link" | "default" | "destructive" | "outline" | "ghost";
+    size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg";
+    invalid?: boolean;
+    href?: string;
+    target?: "_blank" | "_parent" | "_self" | "_top" | "_unfencedTop";
+    text?: string;
+    icon_url?: string;
+    icon_position?: "start" | "end";
+    event: string;
+    requires_valid?: string[];
+    submit?: boolean;
+}
+export interface Divider {
+    text?: string;
+}
+export interface Checkbox {
+    label?: string;
+    initial_value?: boolean;
+    data_key?: string;
+    validation?: {
+        rules: ValidationRule[];
+        on_event: ValidationOnEvent;
+    };
+}
+export interface OTP {
+    length: number;
+    timeout: number;
+    variant?: "digits_only" | "with_spacing" | "with_separator" | "simple";
+    data_key?: string;
+    event?: string;
+    resend?: {
+        text?: Text;
+        button?: Button;
+    };
+}
+export interface Error {
+    variant?: "destructive" | "destructive-tonal";
+    icon_url?: string;
+    title?: string;
+    description?: string;
+    message?: string;
+}
+export interface CountdownProperties {
+    duration?: number;
+    redirect_url?: string;
+    content?: string;
+}
+export type DataElement = {
+    element_type: "checkbox";
+    id: string;
+    properties: Checkbox;
+    style: Style;
+    class: string;
+    data_key: string;
+} | {
+    element_type: "input";
+    id: string;
+    properties: Input;
+    style: Style;
+    class: string;
+    data_key: string;
+} | {
+    element_type: "otp";
+    id: string;
+    properties: OTP;
+    style: Style;
+    class: string;
+    data_key: string;
+};
+export type UIElement = {
+    element_type: "container";
+    id: string;
+    properties: Container;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "label";
+    id: string;
+    properties: Label;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "gap";
+    id: string;
+    properties: Gap;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "html";
+    id: string;
+    properties: Html;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "input";
+    id: string;
+    properties: Input;
+    style: Style;
+    class: string;
+    data_key?: string;
+    hidden?: boolean;
+} | {
+    element_type: "image";
+    id: string;
+    properties: Image;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "spinner";
+    id: string;
+    properties: Spinner;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "logo";
+    id: string;
+    properties: Logo;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "text";
+    id: string;
+    properties: Text;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "button";
+    id: string;
+    properties: Button;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "divider";
+    id: string;
+    properties: Divider;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "checkbox";
+    id: string;
+    properties: Checkbox;
+    style: Style;
+    class: string;
+    data_key?: string;
+    hidden?: boolean;
+} | {
+    element_type: "otp";
+    id: string;
+    properties: OTP;
+    style: Style;
+    class: string;
+    data_key?: string;
+    hidden?: boolean;
+} | {
+    element_type: "error";
+    id: string;
+    properties: Error;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "watermark";
+    id: string;
+    properties: Watermark;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+} | {
+    element_type: "countdown";
+    id: string;
+    properties: CountdownProperties;
+    style: Style;
+    class: string;
+    hidden?: boolean;
+};
+export interface RenderSpec {
+    root_container: UIElement;
+}
+export interface EventResponse {
+    next_screen: string;
+    state: string;
+    session_token: string;
+    render_spec: RenderSpec;
+}

package/dist/types/service/http/common/index.d.ts

@@ -0,0 +1,6 @@
+export interface Pagination {
+    page: number;
+    limit: number;
+    total: number;
+    total_pages: number;
+}

package/dist/types/service/http/index.d.ts

@@ -0,0 +1,5 @@
+export * from './user';
+export * from './member';
+export * from './invitation';
+export * from './roles';
+export * from './common';

package/dist/types/service/http/invitation/index.d.ts

@@ -0,0 +1,47 @@
+import { Pagination } from '../../..';
+export interface InvitedBy {
+    id: string;
+    name: string;
+}
+export interface Invitation {
+    id: string;
+    organization_id: string;
+    invitee_email: string;
+    roles: {
+        key: string;
+        name: string;
+    }[];
+    status: string;
+    invited_by: InvitedBy;
+    created_at: number;
+    updated_at: number;
+    accepted_at?: number;
+    cancelled_at?: number;
+    expires_at: number;
+    last_sent_at: number;
+    resend_count: number;
+    message?: string;
+    object: string;
+}
+export interface InvitationsResponse {
+    data: Invitation[];
+    pagination: Pagination;
+    object: string;
+}
+export interface GetInvitationsParams {
+    status?: string;
+    expired?: boolean;
+    invitee_emails?: string[];
+    invited_by?: string;
+    search?: string;
+    page?: number;
+    limit?: number;
+    order?: string;
+    roles?: string;
+}
+export interface InviteMembersRequest {
+    emails: string[];
+    invited_by?: string;
+    message?: string;
+    roles?: string[];
+}

package/dist/types/service/http/member/index.d.ts

@@ -0,0 +1,43 @@
+import { Pagination } from '../../..';
+export interface MemberUser {
+    id: string;
+    email: string;
+    email_verified: boolean;
+    family_name: string;
+    given_name: string;
+    name: string;
+    picture: string;
+    status: string;
+    username: string;
+}
+export interface Member {
+    id: string;
+    organization_id: string;
+    organization_name: string;
+    organization_slug: string;
+    project_id: string;
+    roles: {
+        key: string;
+        name: string;
+    }[];
+    joined_at: string;
+    last_active_at: string;
+    created_at: string;
+    updated_at: string;
+    object: string;
+    user: MemberUser;
+}
+export interface MembersResponse {
+    data: Member[];
+    pagination: Pagination;
+    object: string;
+}
+export interface GetMembersParams {
+    user_ids?: string[];
+    emails?: string[];
+    search?: string;
+    page?: number;
+    limit?: number;
+    order?: string;
+    roles?: string;
+}

package/dist/types/service/http/roles/index.d.ts

@@ -0,0 +1,38 @@
+import { Pagination } from '../../..';
+export interface GetRolesParams {
+    type?: "system" | "custom";
+    name?: string;
+    resource_type?: string;
+    resource_id?: string;
+    include_instance_scoped?: boolean;
+    permission?: string;
+    page?: number;
+    limit?: number;
+    order?: string;
+}
+export interface RoleInheritance {
+    parent_role_keys: string[];
+    relation: string;
+}
+export interface Role {
+    assignment_count: number;
+    created_at: number;
+    description: string;
+    inheritance: RoleInheritance;
+    key: string;
+    metadata: Record<string, any>;
+    name: string;
+    object: string;
+    permission_count: number;
+    permissions: string[];
+    resource_id: string;
+    resource_type: string;
+    type: "system" | "custom";
+    updated_at: number;
+}
+export interface ListRolesResponse {
+    data: Role[];
+    object: string;
+    pagination: Pagination;
+}
+export type RolesResponse = ListRolesResponse;

package/dist/types/service/http/user/index.d.ts

@@ -0,0 +1,40 @@
+export interface User {
+    birthdate?: number;
+    created_at?: number;
+    email?: string;
+    email_verified?: boolean;
+    family_name?: string;
+    gender?: string;
+    given_name?: string;
+    id: string;
+    locale?: string;
+    metadata?: Record<string, unknown>;
+    middle_name?: string;
+    name?: string;
+    nickname?: string;
+    object?: string;
+    password_change_required?: boolean;
+    phone?: string;
+    phone_verified?: boolean;
+    picture?: string;
+    private_metadata?: Record<string, unknown>;
+    profile?: string;
+    project_id?: string;
+    status?: string;
+    updated_at?: number;
+    username?: string;
+    website?: string;
+    zoneinfo?: string;
+    address?: UserAddress;
+}
+export interface UserAddress {
+    country?: string;
+    formatted?: string;
+    locality?: string;
+    postal_code?: string;
+    region?: string;
+    street_address?: string;
+}
+export type UpdateUserRequest = Partial<User> & {
+    readonly_metadata?: Record<string, unknown>;
+};

package/dist/types/service/index.d.ts

@@ -0,0 +1 @@
+export * from './http';

package/dist/types/styles/index.d.ts

@@ -0,0 +1,72 @@
+export type Breakpoints = "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl";
+export interface Style {
+    [prop: string]: string | number | undefined | null | Style;
+}
+export interface ICustomizationOptions {
+    class?: string;
+    style?: Style;
+    rule?: "override" | "merge";
+    font?: "font-geist" | "font-inter" | "font-roboto" | "font-open-sans" | "font-lato" | "font-montserrat";
+}
+export interface ICustomizations {
+    byType?: {
+        gap?: ICustomizationOptions;
+        header?: {
+            container: ICustomizationOptions;
+            title: ICustomizationOptions;
+            subtitle: ICustomizationOptions;
+        };
+        loader?: {
+            spinner?: ICustomizationOptions;
+            linear?: ICustomizationOptions;
+        };
+        logo?: ICustomizationOptions;
+        buttons?: {
+            defaultButton?: ICustomizationOptions;
+            secondaryButton?: ICustomizationOptions;
+            linkButton?: ICustomizationOptions;
+            outlineButton?: ICustomizationOptions;
+            ghostButton?: ICustomizationOptions;
+            destructiveButton?: ICustomizationOptions;
+        };
+        container?: ICustomizationOptions;
+        errors?: {
+            inputError?: ICustomizationOptions;
+            serviceError?: ICustomizationOptions;
+        };
+        inputs?: {
+            inputContainer?: ICustomizationOptions;
+            inputField?: ICustomizationOptions;
+            inputLabel?: ICustomizationOptions;
+            inputHint?: ICustomizationOptions;
+            inputError?: ICustomizationOptions;
+        };
+        labels?: {
+            inputLabel?: ICustomizationOptions;
+            checkboxLabel?: ICustomizationOptions;
+        };
+        divider?: ICustomizationOptions;
+        timer?: {
+            countdowns?: ICustomizationOptions;
+        };
+        userProfile?: {
+            container?: ICustomizationOptions;
+            sidebar?: ICustomizationOptions;
+            sidebarTabs?: ICustomizationOptions;
+            sidebarBurgerMenu?: ICustomizationOptions;
+            userProfileCard?: {
+                container?: ICustomizationOptions;
+                header?: {
+                    container?: ICustomizationOptions;
+                    title?: ICustomizationOptions;
+                };
+                editForm?: ICustomizationOptions;
+            };
+        };
+    };
+    byId?: Record<string, ICustomizationOptions>;
+    config?: {
+        breakpoints?: Partial<Record<Breakpoints, string>>;
+        font?: "font-geist" | "font-inter" | "font-roboto" | "font-open-sans" | "font-lato" | "font-montserrat";
+    };
+}

package/dist/utils/components.d.ts

@@ -0,0 +1,24 @@
+import { ICustomizationOptions, ICustomizations, Style } from '../types';
+import { AuthService } from '@pontive/oidc-client';
+export declare function mapAlignment(alignment: string): string;
+export declare function mapBtnToCustomizedStyle(variant: "secondary" | "link" | "default" | "destructive" | "outline" | "ghost", customizations: ICustomizations): ICustomizationOptions | undefined;
+export declare function applyCustomizations(defaultClass: string, defaultStyle?: Style | CSSStyleDeclaration, typeCustomization?: ICustomizationOptions, elementId?: string, customizations?: ICustomizations, isRootContainer?: boolean): {
+    class: string;
+    style: Style;
+};
+export declare const genRandSeed: () => string;
+export declare function showDestructiveToast(message: string): void;
+/**
+ * Waits until Auth.configure() has run, so a widget that mounted first does not
+ * start a flow that would throw NOT_CONFIGURED.
+ *
+ * This used to read `__configured` and `__whenConfigured` off the Auth object.
+ * Neither property has ever existed, so every call returned immediately and the
+ * race it was written for was never actually guarded — it only looked guarded,
+ * which is worse than not having it.
+ *
+ * The timeout is deliberate. A host that never configures Auth is a
+ * misconfiguration, and hanging the widget forever hides it; proceeding lets the
+ * call fail with NOT_CONFIGURED, which says what is wrong.
+ */
+export declare function waitForAuthConfigured(auth: AuthService, timeoutMs?: number): Promise<void>;

package/dist/utils/format.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Converts a Unix timestamp (seconds since epoch) to a formatted object
+ * @param timestamp - Unix timestamp in seconds (or milliseconds if isMilliseconds is true)
+ * @param isMilliseconds - Set to true if timestamp is in milliseconds (default: false)
+ * @returns Object with formatted date and clock strings
+ */
+export declare function formatTimestamp(timestamp: number, isMilliseconds?: boolean): {
+    date: string;
+    clock: string;
+};
+/**
+ * Formats a date relative to today:
+ * - "Today"       (same day)
+ * - "Yesterday"   (1 day ago)
+ * - Day-of-week   (2–6 days ago, e.g. "Monday")
+ * - Formatted date (7+ days ago, e.g. "Jan 15, 2024")
+ *
+ * @param timestamp - Unix timestamp in seconds OR an ISO date string
+ * @param isMilliseconds - set to true if timestamp is in milliseconds (default: false)
+ * @returns Human-readable label
+ */
+export declare function formatRelativeDateLabel(timestamp: number | string, isMilliseconds?: boolean): string;
+/**
+ * Returns the time part (HH:MM) from a timestamp.
+ * @param timestamp - Unix timestamp in seconds OR an ISO date string
+ * @param isMilliseconds - set to true if timestamp is in milliseconds (default: false)
+ * @returns Time string like "14:30"
+ */
+export declare function formatTime(timestamp: number | string, isMilliseconds?: boolean): string;
+export declare const formatDate: (dateString: string | number) => {
+    date: string;
+    time: string;
+};
+/**
+ * Returns relative time (e.g., "2 hours ago", "3 days ago")
+ * @param timestamp - Unix timestamp in seconds
+ * @returns Human-readable relative time string
+ */
+export declare function formatRelativeTime(timestamp: number): string;
+export declare function getInitials(str?: string): string;

package/dist/utils/html-base64.d.ts

@@ -0,0 +1 @@
+export declare function base64ToHtml(base64: string): string;

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from './components';
+export * from './html-base64';
+export * from './storybook';
+export * from './styles';
+export * from './svg-base64';
+export * from './tailwind';
+export * from './tokens';
+export * from './format';

package/dist/utils/storybook.d.ts

@@ -0,0 +1 @@
+export declare const genTypeString: (values: string[]) => string;

package/dist/utils/styles.d.ts

@@ -0,0 +1,21 @@
+import { Breakpoints, Style } from '../types';
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+export declare function mapStyles(style: Style): string;
+export declare function changeTheme(theme: "light" | "dark"): void;
+export declare function initTheme(): void;
+export declare function getTheme(): "light" | "dark";
+export declare function resolveImageUrl(url: string | undefined, theme: "light" | "dark" | string): string;
+export declare function splitStyle(style: Style): {
+    base: Style;
+    responsive: Record<Breakpoints, Style>;
+};
+export declare function nextPaint(): Promise<void>;
+/**
+ * Updates flex widths of buttons:
+ * - Last row normally fixed width
+ * - Other rows flex-grow: 1
+ * - If last row === first row, last row grows instead
+ */
+export declare function updateSocialLoginBtnWidths(container: HTMLElement, buttons: HTMLElement[]): Promise<void>;
+export declare function deepMerge<T extends Record<string, any>, U extends Record<string, any>>(target: T, source: U): T & U;

package/dist/utils/svg-base64.d.ts

@@ -0,0 +1,2 @@
+export declare function decodeBase64Svg(icon: string): string | null;
+export declare function resolveIconSource(icon: string): string;

package/dist/utils/tailwind.d.ts

@@ -0,0 +1,7 @@
+import { RenderSpec } from '../types';
+interface JSONEditor {
+    get: () => RenderSpec;
+    set: (data: RenderSpec) => void;
+}
+export declare function initializeDynamicStyles(jsonEditor: JSONEditor, renderSpec: RenderSpec): void;
+export {};

package/dist/utils/tokens.d.ts

@@ -0,0 +1 @@
+export declare function getAccessToken(): string | undefined;