@zango-core/appbuilder 1.0.0-rc.1

package/dist/types/schemas/appInit.schema.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+type MenuItem = {
+    id: string;
+    label: string;
+    path?: string;
+    uri?: string;
+    icon?: string;
+    type?: string;
+    children?: MenuItem[];
+};
+declare const menuItemSchema: z.ZodType<MenuItem>;
+export declare const appInitSchema: z.ZodObject<{
+    routes: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        page_type: z.ZodString;
+        entity: z.ZodOptional<z.ZodString>;
+        component: z.ZodOptional<z.ZodString>;
+        extra_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    menu: z.ZodArray<z.ZodType<MenuItem, unknown, z.core.$ZodTypeInternals<MenuItem, unknown>>>;
+    app_name: z.ZodOptional<z.ZodString>;
+    is_user_anonymous: z.ZodOptional<z.ZodBoolean>;
+    profile_info: z.ZodOptional<z.ZodUnknown>;
+    app_logo: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    theme: z.ZodOptional<z.ZodObject<{
+        colors: z.ZodDefault<z.ZodObject<{
+            primary: z.ZodOptional<z.ZodString>;
+            secondary: z.ZodOptional<z.ZodString>;
+            success: z.ZodOptional<z.ZodString>;
+            warning: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+            gray: z.ZodOptional<z.ZodString>;
+            background: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        typography: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        borders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        shadows: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        spacing: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        fonts: z.ZodOptional<z.ZodObject<{
+            body: z.ZodOptional<z.ZodString>;
+            heading: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        borderRadius: z.ZodOptional<z.ZodObject<{
+            small: z.ZodOptional<z.ZodString>;
+            medium: z.ZodOptional<z.ZodString>;
+            large: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$loose>>;
+    session_security: z.ZodOptional<z.ZodBoolean>;
+    session_security_config: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        ping_url: z.ZodString;
+        warn_after: z.ZodNumber;
+        expire_after: z.ZodNumber;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type AppInitValidated = z.infer<typeof appInitSchema>;
+export { menuItemSchema };
+export type MenuItemValidated = MenuItem;

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

@@ -0,0 +1,10 @@
+export type { AppInitValidated, MenuItemValidated } from './appInit.schema';
+export { appInitSchema, menuItemSchema } from './appInit.schema';
+export type { ProfileValidated } from './profile.schema';
+export { profileSchema } from './profile.schema';
+export type { RouteConfigValidated } from './route.schema';
+export { routeConfigSchema } from './route.schema';
+export type { SessionValidated } from './session.schema';
+export { sessionSchema } from './session.schema';
+export type { ThemeValidated } from './theme.schema';
+export { themeSchema } from './theme.schema';

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

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const profileSchema: z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    mobile: z.ZodString;
+    profile_pic: z.ZodNullable<z.ZodString>;
+    roles: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        is_active: z.ZodOptional<z.ZodBoolean>;
+        is_default: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    last_password_changed: z.ZodOptional<z.ZodString>;
+    auth_config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    password_policy: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    tokens: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$loose>;
+export type ProfileValidated = z.infer<typeof profileSchema>;

package/dist/types/schemas/route.schema.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export declare const routeConfigSchema: z.ZodObject<{
+    path: z.ZodString;
+    page_type: z.ZodString;
+    entity: z.ZodOptional<z.ZodString>;
+    component: z.ZodOptional<z.ZodString>;
+    extra_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export type RouteConfigValidated = z.infer<typeof routeConfigSchema>;

package/dist/types/schemas/session.schema.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const sessionSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    ping_url: z.ZodString;
+    warn_after: z.ZodNumber;
+    expire_after: z.ZodNumber;
+}, z.core.$loose>;
+export type SessionValidated = z.infer<typeof sessionSchema>;

package/dist/types/schemas/theme.schema.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export declare const themeSchema: z.ZodObject<{
+    colors: z.ZodDefault<z.ZodObject<{
+        primary: z.ZodOptional<z.ZodString>;
+        secondary: z.ZodOptional<z.ZodString>;
+        success: z.ZodOptional<z.ZodString>;
+        warning: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        gray: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    typography: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    borders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    shadows: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    spacing: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    fonts: z.ZodOptional<z.ZodObject<{
+        body: z.ZodOptional<z.ZodString>;
+        heading: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    borderRadius: z.ZodOptional<z.ZodObject<{
+        small: z.ZodOptional<z.ZodString>;
+        medium: z.ZodOptional<z.ZodString>;
+        large: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+export type ThemeValidated = z.infer<typeof themeSchema>;

package/dist/types/services/api/index.d.ts

@@ -0,0 +1,2 @@
+export { getApiTimeout, getApiUrl, getEndpoint, } from '../../framework/utils/apiConfig';
+export * from '../api';

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

@@ -0,0 +1,109 @@
+import { PasswordChange, ProfileFormData } from '../types';
+interface ApiDetails {
+    url: string;
+    type: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    payload?: unknown;
+}
+interface ApiResponse {
+    response: unknown;
+    success: boolean;
+    responseStatus: number;
+    isNetworkError?: boolean;
+}
+export declare const callGetApi: ({ fullUrl }: {
+    fullUrl: string;
+}) => Promise<Response>;
+export declare const callPostApi: ({ fullUrl, payload }: {
+    fullUrl: string;
+    payload?: unknown;
+}) => Promise<Response>;
+export declare const callPutApi: ({ fullUrl, payload }: {
+    fullUrl: string;
+    payload?: unknown;
+}) => Promise<Response>;
+export declare const callDeleteApi: ({ fullUrl, payload, }: {
+    fullUrl: string;
+    payload?: unknown;
+}) => Promise<Response>;
+export declare const callPatchApi: ({ fullUrl, payload }: {
+    fullUrl: string;
+    payload?: unknown;
+}) => Promise<Response>;
+export declare const callApi: (apiDetails: ApiDetails) => Promise<ApiResponse>;
+export declare const generateQueryString: (params: Record<string, unknown>) => string;
+export declare const getAppInitData: () => {
+    url: string;
+    type: "GET";
+};
+export declare const getUserProfile: () => {
+    url: string;
+    type: "GET";
+};
+export declare const updateUserProfile: (payload: ProfileFormData) => {
+    url: string;
+    type: "PUT";
+    payload: ProfileFormData;
+};
+export declare const uploadProfilePhoto: (payload: FormData) => {
+    url: string;
+    type: "POST";
+    payload: FormData;
+};
+export declare const changePassword: (payload: PasswordChange) => {
+    url: string;
+    type: "PUT";
+    payload: PasswordChange;
+};
+export declare const toggleTwoFactor: (payload: Record<string, unknown>) => {
+    url: string;
+    type: "POST";
+    payload: Record<string, unknown>;
+};
+export declare const switchRole: (roleId: string) => {
+    url: string;
+    type: "POST";
+};
+export declare const getUserSessions: () => {
+    url: string;
+    type: "GET";
+};
+export declare const logoutSession: (sessionId: number) => {
+    url: string;
+    type: "DELETE";
+    payload: {
+        sessions: number[];
+    };
+};
+export declare const logoutAllSessions: (sessionIds: number[]) => {
+    url: string;
+    type: "DELETE";
+    payload: {
+        sessions: number[];
+    };
+};
+export declare const logout: () => {
+    url: string;
+    type: "DELETE";
+};
+export declare const performLogout: () => {
+    url: string;
+    type: "POST";
+};
+export declare const pingSessionSecurity: (pingUrl: string, idleFor: number) => {
+    url: string;
+    type: "GET";
+};
+export declare const fetchAppInitData: () => Promise<ApiResponse>;
+export declare const fetchUserProfile: () => Promise<ApiResponse>;
+export declare const fetchUserSessions: () => Promise<ApiResponse>;
+export declare const saveUserProfile: (data: ProfileFormData) => Promise<ApiResponse>;
+export declare const uploadPhoto: (formData: FormData) => Promise<ApiResponse>;
+export declare const updatePassword: (passwordData: PasswordChange) => Promise<ApiResponse>;
+export declare const setTwoFactor: (enabled: boolean) => Promise<ApiResponse>;
+export declare const changeRole: (roleId: string) => Promise<ApiResponse>;
+export declare const removeSession: (sessionId: number) => Promise<ApiResponse>;
+export declare const removeAllSessions: (sessionIds: number[]) => Promise<ApiResponse>;
+export declare const performAppLogout: () => Promise<ApiResponse>;
+export declare const performDirectLogout: () => Promise<ApiResponse>;
+export declare const pingSession: (pingUrl: string, idleFor: number) => Promise<ApiResponse>;
+export {};

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

@@ -0,0 +1,7 @@
+/**
+ * Services exports
+ */
+export * from './api';
+export { type LegacyApiResponse, toLegacyResponse } from './legacyAdapter';
+export * from './logger';
+export { type ApiResult, normalizeAxiosResponse, normalizeError, normalizeFetchResponse, normalizeResponse, } from './normalizeResponse';

package/dist/types/services/legacyAdapter.d.ts

@@ -0,0 +1,10 @@
+import { ApiResult } from './normalizeResponse';
+export interface LegacyApiResponse<T = unknown> {
+    success: boolean;
+    response: T | {
+        message: string;
+    };
+    responseStatus: number;
+    message?: string;
+}
+export declare function toLegacyResponse<T>(result: ApiResult<T>): LegacyApiResponse<T>;

package/dist/types/services/logger.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Logging utility with environment-aware behavior
+ * Development: console methods with level prefixes
+ * Production: console.warn/error (placeholder until monitoring service is wired)
+ */
+interface LogContext {
+    [key: string]: unknown;
+}
+declare class Logger {
+    private isDev;
+    constructor();
+    /**
+     * Debug messages - only in development
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Info messages
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Warning messages
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Error messages - always logged
+     */
+    error(message: string, error?: Error | unknown, context?: LogContext): void;
+    /** Placeholder — wire to Sentry/DataDog when ready */
+    private sendToMonitoring;
+}
+export declare const logger: Logger;
+export {};

package/dist/types/services/normalizeResponse.d.ts

@@ -0,0 +1,29 @@
+export type ApiResult<T = unknown> = {
+    ok: true;
+    data: T;
+    status: number;
+} | {
+    ok: false;
+    error: string;
+    status: number;
+    details?: unknown;
+};
+interface LegacyEnvelope {
+    success: boolean;
+    response: unknown;
+    responseStatus: number;
+    message?: string;
+}
+interface AxiosLikeResponse {
+    data: {
+        success?: boolean;
+        response?: unknown;
+        message?: string;
+    };
+    status: number;
+}
+export declare function normalizeResponse<T = unknown>(envelope: LegacyEnvelope): ApiResult<T>;
+export declare function normalizeAxiosResponse<T = unknown>(response: AxiosLikeResponse): ApiResult<T>;
+export declare function normalizeFetchResponse<T = unknown>(status: number, body: unknown): ApiResult<T>;
+export declare function normalizeError(error: unknown): ApiResult<never>;
+export {};

package/dist/types/types/auth.d.ts

@@ -0,0 +1,103 @@
+import { SessionInfo, UserProfile, UserRole } from './common';
+export type { AuthResult, OAuthCallbackParams, PasswordChange, PasswordResetConfirm, PasswordResetRequest, PendingAuthResult, SamlCallbackParams, SessionInfo, TwoFactorSetup, TwoFactorVerify, UserProfile, UserRole, } from './common';
+/**
+ * Login credentials
+ */
+export interface LoginCredentials {
+    email: string;
+    password: string;
+    phone?: string;
+    username?: string;
+    remember?: boolean;
+}
+/**
+ * OTP login credentials
+ */
+export interface OTPLoginCredentials {
+    email: string;
+    otp: string;
+}
+/**
+ * Login response
+ */
+export interface LoginResponse {
+    success: boolean;
+    token?: string;
+    user?: UserProfile;
+    next_step?: NextStep;
+    redirect_url?: string;
+}
+/**
+ * Next step in multi-step auth
+ */
+export interface NextStep {
+    id: string;
+    is_pending: boolean;
+    title?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Multi-factor authentication state
+ */
+export interface MFAState {
+    enabled: boolean;
+    method: 'totp' | 'sms' | 'email' | null;
+    backup_codes?: string[];
+}
+/**
+ * Full auth state with tokens and session (for future token-based auth)
+ */
+export interface FullAuthState {
+    isAuthenticated: boolean;
+    isAnonymous: boolean;
+    user: UserProfile | null;
+    tokens: AuthTokens | null;
+    sessionInfo: SessionInfo | null;
+}
+/**
+ * Authentication tokens
+ */
+export interface AuthTokens {
+    access_token: string;
+    refresh_token?: string;
+    expires_at?: string;
+    token_type?: string;
+}
+/**
+ * Role selection data
+ */
+export interface RoleSelectionData {
+    user_id: string;
+    available_roles: UserRole[];
+    selected_role?: UserRole;
+}
+/**
+ * Two-factor auth verification result
+ */
+export interface TwoFactorResult {
+    success: boolean;
+    requires_backup_code?: boolean;
+    remaining_attempts?: number;
+}
+/**
+ * Password policy
+ */
+export interface PasswordPolicy {
+    min_length?: number;
+    require_uppercase?: boolean;
+    require_lowercase?: boolean;
+    require_numbers?: boolean;
+    require_special_chars?: boolean;
+    forbidden_patterns?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Session security policy (server-side constraints)
+ */
+export interface SessionPolicyConfig {
+    max_sessions: number;
+    session_timeout_minutes: number;
+    require_reauth_for_sensitive: boolean;
+    ip_whitelist?: string[];
+}