@nucleus-suite-pe/core 0.1.0

package/types/nucleus-suite-pe-core.d.ts

@@ -0,0 +1,368 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, EnvironmentProviders, Signal } from '@angular/core';
+import { HttpContextToken, HttpInterceptorFn } from '@angular/common/http';
+import * as _nucleus_suite_pe_core from '@nucleus-suite-pe/core';
+import * as _primeuix_themes from '@primeuix/themes';
+import * as _primeuix_themes_types_base from '@primeuix/themes/types/base';
+
+interface NucleusConfig {
+    readonly appId: string;
+    readonly securityApiUrl: string;
+    readonly appApiUrl: string | null;
+    readonly landingUrl: string | null;
+}
+declare const NUCLEUS_CONFIG: InjectionToken<NucleusConfig>;
+declare function provideNucleus(config: NucleusConfig): EnvironmentProviders;
+declare function loadNucleusConfig(url?: string): Promise<NucleusConfig>;
+declare function isNucleusConfigured(config: NucleusConfig): boolean;
+declare function ownsUrl(config: NucleusConfig, url: string): boolean;
+
+interface NucleusIdentity {
+    readonly uid: string;
+    readonly provider: string;
+    readonly providerUserId: string;
+    readonly email: string | null;
+    readonly displayName: string | null;
+    readonly photoUrl: string | null;
+}
+declare abstract class NucleusAuth {
+    abstract readonly user: Signal<NucleusIdentity | null>;
+    abstract idToken(): Promise<string | null>;
+    signOut?(): Promise<void>;
+    switchAccount?(): Promise<void>;
+}
+
+declare const NUCLEUS_FORCE_BEARER: HttpContextToken<boolean>;
+declare const NUCLEUS_SKIP_AUTH: HttpContextToken<boolean>;
+
+declare const nucleusAuthInterceptor: HttpInterceptorFn;
+
+interface SessionTicket {
+    readonly userId: string;
+    readonly expiresAtUtc: string;
+}
+declare class NucleusSessionAuth {
+    private readonly http;
+    private readonly config;
+    private readonly injector;
+    private readonly _ticket;
+    private readonly _failed;
+    private pending;
+    readonly ticket: _angular_core.Signal<SessionTicket | null>;
+    readonly failed: _angular_core.Signal<boolean>;
+    readonly established: _angular_core.Signal<boolean>;
+    establish(force?: boolean): Promise<boolean>;
+    clear(): Promise<void>;
+    private request;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusSessionAuth, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NucleusSessionAuth>;
+}
+
+interface AuthSyncRequest {
+    readonly provider: string;
+    readonly providerUserId: string;
+    readonly email: string | null;
+    readonly displayName: string | null;
+    readonly photoUrl: string | null;
+}
+interface AppUser {
+    readonly userId: string;
+    readonly displayName: string | null;
+    readonly photoUrl: string | null;
+    readonly createdAt: string;
+    readonly isNew: boolean;
+    readonly profileCompleted: boolean;
+    readonly hasCompanies: boolean;
+    readonly isPlatformAdmin: boolean;
+}
+declare class UserSyncService {
+    private readonly http;
+    private readonly config;
+    readonly appUser: _angular_core.WritableSignal<AppUser | null>;
+    readonly failed: _angular_core.WritableSignal<boolean>;
+    sync(session: NucleusIdentity, idToken: () => Promise<string | null>): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserSyncService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<UserSyncService>;
+}
+
+interface MenuNode {
+    readonly id: string;
+    readonly label: string;
+    readonly icon: string | null;
+    readonly route: string | null;
+    readonly sortOrder: number;
+    readonly canView: boolean;
+    readonly canInsert: boolean;
+    readonly canEdit: boolean;
+    readonly canDelete: boolean;
+    readonly canExport: boolean;
+    readonly children: readonly MenuNode[];
+}
+interface SiteAccess {
+    readonly siteId: string;
+    readonly siteName: string;
+    readonly appId: string;
+    readonly appName: string;
+    readonly roleName: string;
+}
+interface CompanySummary {
+    readonly id: string;
+    readonly legalName: string;
+    readonly tradeName: string | null;
+    readonly taxId: string;
+    readonly countryCode: string | null;
+    readonly logoPath: string | null;
+    readonly status: number;
+    readonly isOwner: boolean;
+    readonly ownerUserId: string;
+    readonly siteCount: number;
+    readonly createdAtUtc: string;
+    readonly myAccess: readonly SiteAccess[];
+}
+interface UserProfile {
+    readonly firstName: string | null;
+    readonly lastName: string | null;
+    readonly language: string | null;
+    readonly timeZone: string | null;
+    readonly themePreference: string | null;
+    readonly completedAtUtc: string | null;
+}
+interface Subscription {
+    readonly planName: string;
+    readonly status: number;
+    readonly quotaBytes: number;
+    readonly usedBytes: number;
+    readonly usedPercentage: number;
+}
+interface MeResponse {
+    readonly userId: string;
+    readonly emailVerified: boolean;
+    readonly displayName: string | null;
+    readonly photoUrl: string | null;
+    readonly status: number;
+    readonly isPlatformAdmin: boolean;
+    readonly createdAtUtc: string;
+    readonly lastLoginAtUtc: string | null;
+    readonly profile: UserProfile;
+    readonly subscription: Subscription;
+    readonly ownedCompanies: readonly CompanySummary[];
+    readonly sharedCompanies: readonly CompanySummary[];
+}
+type AccessScope = 'site' | 'account';
+interface AppSummary {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string | null;
+    readonly icon: string | null;
+    readonly color: string | null;
+    readonly url: string | null;
+    readonly status: number;
+    readonly sortOrder: number;
+}
+interface LauncherApp extends AppSummary {
+    readonly hasAccess: boolean;
+}
+
+declare class SessionService {
+    private readonly http;
+    private readonly auth;
+    private readonly userSync;
+    private readonly sessionAuth;
+    private readonly config;
+    private readonly _me;
+    private readonly _menu;
+    private readonly _access;
+    private readonly _scope;
+    private readonly _apps;
+    private readonly _loading;
+    private readonly _error;
+    private inFlight;
+    private loadedKey;
+    readonly me: _angular_core.Signal<MeResponse | null>;
+    readonly menu: _angular_core.Signal<readonly MenuNode[]>;
+    readonly access: _angular_core.Signal<SiteAccess | null>;
+    readonly scope: _angular_core.Signal<AccessScope | null>;
+    readonly apps: _angular_core.Signal<readonly LauncherApp[]>;
+    readonly loading: _angular_core.Signal<boolean>;
+    readonly error: _angular_core.Signal<string | null>;
+    readonly roleName: _angular_core.Signal<string | null>;
+    readonly siteName: _angular_core.Signal<string | null>;
+    readonly companies: _angular_core.Signal<_nucleus_suite_pe_core.CompanySummary[]>;
+    load(language: string, force?: boolean): Promise<void>;
+    reload(language: string): Promise<void>;
+    private buildLauncher;
+    private siteMenu;
+    private accountMenu;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SessionService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SessionService>;
+}
+
+type NucleusLang = 'es' | 'en';
+declare const NUCLEUS_LANGS: readonly NucleusLang[];
+declare class NucleusLanguage {
+    private readonly _lang;
+    readonly lang: _angular_core.Signal<NucleusLang>;
+    constructor();
+    setLang(lang: NucleusLang): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusLanguage, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NucleusLanguage>;
+}
+
+type ThemeId = 'nucleus' | 'light' | 'dark' | 'bubblegum' | 'cool-breeze' | 'cool-slate' | 'icy-mint' | 'juicy-plum' | 'mango-paradise' | 'moonlight-glow' | 'mystical-forest' | 'silky-pink' | 'spicy-red' | 'sunny-day';
+type ThemePreference = ThemeId | 'system';
+interface ThemeTokens {
+    readonly bg: string;
+    readonly surface: string;
+    readonly surfaceAlt: string;
+    readonly text: string;
+    readonly textMuted: string;
+    readonly border: string;
+    readonly accent: string;
+    readonly onAccent: string;
+}
+interface Theme {
+    readonly id: ThemeId;
+    readonly scheme: 'light' | 'dark';
+    readonly swatch: string;
+    readonly starfield: boolean;
+    readonly tokens: ThemeTokens;
+}
+declare const THEMES: readonly Theme[];
+declare const THEME_LABELS: Readonly<Record<ThemeId, string>>;
+declare const DEFAULT_THEME: ThemeId;
+declare function themeById(id: ThemeId): Theme;
+declare function isThemePreference(value: unknown): value is ThemePreference;
+
+declare class ThemeService {
+    private readonly _preference;
+    private readonly systemDark;
+    readonly preference: _angular_core.Signal<ThemePreference>;
+    readonly theme: _angular_core.Signal<Theme>;
+    readonly starfield: _angular_core.Signal<boolean>;
+    constructor();
+    setPreference(preference: ThemePreference): void;
+    private applyToDom;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThemeService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ThemeService>;
+}
+
+declare const NucleusPreset: _primeuix_themes.Preset<_primeuix_themes_types_base.BaseDesignTokens>;
+
+declare const NUCLEUS_DARK_SELECTOR = ".ns-dark";
+declare function provideNucleusTheme(): EnvironmentProviders;
+
+declare class NucleusMark {
+    readonly accent: _angular_core.InputSignal<string>;
+    readonly size: _angular_core.InputSignal<number>;
+    protected readonly orbit: {
+        readonly rx: 78;
+        readonly ry: 196;
+    };
+    protected readonly rotations: number[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusMark, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusMark, "nucleus-mark", never, { "accent": { "alias": "accent"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class NucleusStarfield {
+    protected readonly W = 1280;
+    protected readonly H = 720;
+    protected readonly stars: {
+        cx: number;
+        cy: number;
+        r: number;
+        opacity: string;
+        dx: string;
+        dy: string;
+        duration: string;
+        delay: string;
+    }[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusStarfield, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusStarfield, "nucleus-starfield", never, {}, {}, never, never, true, never>;
+}
+
+interface ShellCopy {
+    readonly navToggle: string;
+    readonly appsLauncher: string;
+    readonly appsEmpty: string;
+    readonly settingsTitle: string;
+    readonly settingsTheme: string;
+    readonly settingsThemeHint: string;
+    readonly themeSystem: string;
+    readonly signOut: string;
+    readonly accountManage: string;
+    readonly accountSwitch: string;
+    readonly accessLoading: string;
+    readonly accessEmpty: string;
+    readonly accountScope: string;
+    readonly hintNoAccess: string;
+    readonly hintComingSoon: string;
+    readonly hintNotDeployed: string;
+}
+declare const SHELL_COPY: Readonly<Record<NucleusLang, ShellCopy>>;
+
+interface ShellNavItem {
+    readonly id: string;
+    readonly icon: string;
+    readonly label: string;
+}
+interface ThemeOption {
+    readonly value: ThemePreference;
+    readonly label: string;
+    readonly swatch: string | null;
+}
+interface ShellIdentity {
+    readonly name: string;
+    readonly email: string;
+    readonly photoUrl: string | null;
+}
+declare class NucleusShell {
+    private readonly session;
+    private readonly sessionAuth;
+    private readonly themes;
+    private readonly language;
+    private readonly config;
+    private readonly injector;
+    private readonly router;
+    readonly brand: _angular_core.InputSignal<string>;
+    readonly heading: _angular_core.InputSignal<string>;
+    readonly lead: _angular_core.InputSignal<string>;
+    readonly navItems: _angular_core.InputSignal<readonly ShellNavItem[]>;
+    readonly activeNavId: _angular_core.InputSignal<string | null>;
+    readonly selectedMenuId: _angular_core.InputSignal<string | null>;
+    readonly navSelect: _angular_core.OutputEmitterRef<string>;
+    readonly menuSelect: _angular_core.OutputEmitterRef<MenuNode>;
+    protected readonly lang: _angular_core.Signal<NucleusLang>;
+    protected readonly copy: _angular_core.Signal<_nucleus_suite_pe_core.ShellCopy>;
+    protected readonly starfield: _angular_core.Signal<boolean>;
+    protected readonly themePreference: _angular_core.Signal<ThemePreference>;
+    protected readonly menu: _angular_core.Signal<readonly MenuNode[]>;
+    protected readonly menuLoading: _angular_core.Signal<boolean>;
+    protected readonly menuError: _angular_core.Signal<string | null>;
+    protected readonly launcherApps: _angular_core.Signal<readonly LauncherApp[]>;
+    protected readonly sidebarOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly settingsOpen: _angular_core.WritableSignal<boolean>;
+    private readonly auth;
+    protected readonly identity: _angular_core.Signal<ShellIdentity | null>;
+    protected readonly initials: _angular_core.Signal<string>;
+    protected readonly canSwitchAccount: _angular_core.Signal<boolean>;
+    protected readonly accessCaption: _angular_core.Signal<string>;
+    protected readonly themeOptions: _angular_core.Signal<ThemeOption[]>;
+    private readonly loadSession;
+    protected setLang(lang: NucleusLang): void;
+    protected toggleSidebar(): void;
+    protected selectTheme(preference: ThemePreference | null): void;
+    protected selectNav(id: string): void;
+    protected selectMenu(node: MenuNode): void;
+    protected isSelected(node: MenuNode): boolean;
+    protected canOpen(app: LauncherApp): boolean;
+    protected launch(app: LauncherApp): void;
+    protected appInitials(app: LauncherApp): string;
+    protected launchHint(app: LauncherApp): string;
+    protected switchAccount(): Promise<void>;
+    protected signOut(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusShell, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusShell, "nucleus-shell", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "lead": { "alias": "lead"; "required": false; "isSignal": true; }; "navItems": { "alias": "navItems"; "required": false; "isSignal": true; }; "activeNavId": { "alias": "activeNavId"; "required": false; "isSignal": true; }; "selectedMenuId": { "alias": "selectedMenuId"; "required": false; "isSignal": true; }; }, { "navSelect": "navSelect"; "menuSelect": "menuSelect"; }, never, ["*"], true, never>;
+}
+
+export { DEFAULT_THEME, NUCLEUS_CONFIG, NUCLEUS_DARK_SELECTOR, NUCLEUS_FORCE_BEARER, NUCLEUS_LANGS, NUCLEUS_SKIP_AUTH, NucleusAuth, NucleusLanguage, NucleusMark, NucleusPreset, NucleusSessionAuth, NucleusShell, NucleusStarfield, SHELL_COPY, SessionService, THEMES, THEME_LABELS, ThemeService, UserSyncService, isNucleusConfigured, isThemePreference, loadNucleusConfig, nucleusAuthInterceptor, ownsUrl, provideNucleus, provideNucleusTheme, themeById };
+export type { AccessScope, AppSummary, AppUser, AuthSyncRequest, CompanySummary, LauncherApp, MeResponse, MenuNode, NucleusConfig, NucleusIdentity, NucleusLang, SessionTicket, ShellCopy, ShellNavItem, SiteAccess, Subscription, Theme, ThemeId, ThemePreference, ThemeTokens, UserProfile };