@igamingcareer/igaming-components 1.2.23 → 1.2.25

package/dist/types/src/types/candidate.d.ts

@@ -0,0 +1,27 @@
+export type CandidateStatus = "new" | "reviewed" | "shortlisted" | "rejected";
+export type CandidateRating = 1 | 2 | 3 | 4 | 5 | null;
+export type CandidateNote = {
+    id: string;
+    author: string;
+    note: string;
+    createdAt: string;
+    isInternal: boolean;
+};
+export type Candidate = {
+    id: string;
+    firstName: string;
+    lastName: string;
+    title: string;
+    location: string;
+    appliedDate: string;
+    lastActive: string;
+    source: string;
+    yearsExperience: number;
+    status: CandidateStatus;
+    rating: CandidateRating;
+    skills: string[];
+    licenses: string[];
+    appliedJobs: string[];
+    notes: CandidateNote[];
+    resumeUrl?: string;
+};

package/dist/types/src/types/chat-messages.d.ts

@@ -0,0 +1,6 @@
+export interface ChatMessage {
+    role: "user" | "assistant";
+    content: string;
+    toolCalls?: any[];
+    isLoading?: boolean;
+}

package/dist/types/src/types/company-user.d.ts

@@ -0,0 +1,33 @@
+export type CompanyUserRole = "COMPANY_OWNER" | "COMPANY_RECRUITER" | "COMPANY_EMPLOYEE";
+export type CompanyAssociationType = "create" | "join" | "suggest";
+export interface CompanyOnboardingData {
+    associationType: CompanyAssociationType;
+    companyId?: string;
+    companyName?: string;
+    companyWebsite?: string;
+    companyLinkedinUrl?: string;
+    companyType?: string;
+    verticals?: string[];
+    headquarters?: {
+        city: string;
+        country: string;
+    };
+    jobTitle: string;
+    department: string;
+    teamSize?: string;
+    isComplete: boolean;
+    isDraft: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare const ASSOCIATION_RULES: Record<CompanyUserRole, CompanyAssociationType[]>;
+export declare const DEFAULT_ASSOCIATION_BY_ROLE: Record<CompanyUserRole, CompanyAssociationType>;
+export declare const ROLE_PERMISSIONS: {
+    COMPANY_OWNER: string[];
+    COMPANY_RECRUITER: string[];
+    COMPANY_EMPLOYEE: string[];
+};
+export declare const hasPermission: (role: CompanyUserRole, permission: string) => boolean;
+export declare const COMPANY_DEPARTMENTS: string[];
+export declare const TEAM_SIZE_OPTIONS: string[];
+export declare const isCompanyRole: (role: string) => role is CompanyUserRole;

package/dist/types/src/types/company-user.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/company.d.ts

@@ -0,0 +1,252 @@
+/**
+ * Canonical CompanyDTO — iGaming Career platform
+ *
+ * Source of truth: generic-backend/companies/views.py → build_company_response()
+ * Contract document: generic-backend/docs/company-contract.md
+ *
+ * Status: Draft — pending BE + FE tech-lead sign-off
+ * Last updated: 2026-04-01
+ *
+ * Endpoints:
+ *   GET /companies/api/          → CompanyListResponse
+ *   GET /companies/api/{slug}/   → CompanyDTO
+ */
+export interface CompanyTypeRef {
+    slug: string;
+    name: string;
+    label: string;
+}
+export interface VerticalRef {
+    slug: string;
+    name: string;
+    label: string;
+}
+export interface ChannelRef {
+    slug: string;
+    name: string;
+    label: string;
+}
+export interface MarketRef {
+    slug: string;
+    name: string;
+    region: string;
+    relationType: string;
+    confidence: number;
+    source: string;
+}
+export interface RegulatorRef {
+    slug: string;
+    name: string;
+    acronym: string;
+    country: string;
+    licenseType: string;
+    confidence: number;
+    source: string;
+}
+export interface DepartmentRef {
+    slug: string;
+    name: string;
+    jobCount: number;
+    source: string;
+}
+export interface ProductCategoryRef {
+    slug: string;
+    name: string;
+    parentCategory: string;
+    confidence: number;
+    source: string;
+}
+export interface ProductRef {
+    name: string;
+    category: string;
+    description: string;
+    targetCustomers: string[];
+    integrationModel: string;
+    keyDifferentiators: string[];
+}
+export interface LicenseRef {
+    jurisdiction: string;
+    authority: string;
+}
+export interface CertificationRef {
+    name: string;
+    issuer: string;
+}
+export interface AwardRef {
+    name: string;
+    year: number | null;
+}
+export interface EventRef {
+    slug: string;
+    name: string;
+    /** ISO 8601 date (YYYY-MM-DD) or null */
+    date: string | null;
+    confidence: number;
+    source: string;
+}
+export interface ScrapedEventRef {
+    eventName: string;
+    eventSlug: string;
+    location: string;
+    stand: string;
+    link: string;
+    source: string;
+    /** Shape not yet guaranteed — pass-through from scraper */
+    socialLinks: unknown[];
+    scrapedAt: string;
+}
+export interface EnrichmentScoreRef {
+    /** Float 0–100 */
+    total: number;
+    /** camelCase signal name → whether the signal is present */
+    breakdown: Record<string, boolean>;
+    /** ISO 8601 datetime */
+    computedAt: string;
+}
+export interface HeadquartersRef {
+    /** Stripped string; may be "" when unknown */
+    city: string;
+    country: string;
+}
+export interface ContactRef {
+    /** Pass-through from scraper; shape not guaranteed */
+    addresses: unknown[];
+    phone: string | null;
+    /** Absolute URL or null */
+    contactPage: string | null;
+    hasForm: boolean;
+}
+export interface ClassificationDTO {
+    companyType: CompanyTypeRef | null;
+    businessModel: string;
+    /**
+     * ⚠ Inconsistent type: VerticalRef[] when sourced from DB, string[] when derived.
+     * Treat as (VerticalRef | string)[]. Will be unified in v2.
+     */
+    verticals: (VerticalRef | string)[];
+    /** Same caveat as verticals */
+    channels: (ChannelRef | string)[];
+    /** String names only (derived). Full objects available at top-level productCategories. */
+    productCategories: string[];
+    /** Display names only. Full objects available at top-level markets. */
+    markets: string[];
+    /** Display names only. Full objects available at top-level regulators. */
+    regulators: string[];
+    departments: DepartmentRef[];
+    /** Float 0–100 */
+    enrichmentScore: number;
+}
+export interface OverviewDTO {
+    shortDescription: string;
+    longDescription: string;
+    foundedYear: number | null;
+    /** null when both city and country are blank */
+    headquarters: HeadquartersRef | null;
+    /** Reserved — always [] */
+    officeLocations: never[];
+    employeeRange: string | null;
+    /** Reserved — always false */
+    publicCompany: boolean;
+    /** Reserved — always "" */
+    stockTicker: string;
+    /** Absolute URL or "" — never null */
+    website: string;
+    /** Keys: "twitter", "linkedin", "facebook", "instagram", etc. Values: absolute URLs */
+    socialLinks: Record<string, string>;
+    contact: ContactRef;
+}
+export interface TrustAndComplianceDTO {
+    licenses: LicenseRef[];
+    certifications: CertificationRef[];
+    awards: AwardRef[];
+}
+/** Reserved section — always the static shape below */
+export interface PeopleDTO {
+    departmentDistribution: Record<string, never>;
+    members: never[];
+}
+/** Reserved section — always the static shape below. Live jobs: GET /api/companies/{slug}/jobs */
+export interface JobsDTO {
+    openRoles: never[];
+    departmentsHiring: never[];
+    locationsHiring: never[];
+    remotePolicy: string;
+}
+/** Reserved section — always the static shape below */
+export interface NewsAndMediaDTO {
+    pressMentions: never[];
+    employeePosts: never[];
+}
+export interface EventsDTO {
+    /** DB-linked upcoming events */
+    upcoming: EventRef[];
+    /** DB-linked past events */
+    attended: EventRef[];
+    /** Scraped from CompanyRelations */
+    upcomingEvents: ScrapedEventRef[];
+    /** Reserved — always false */
+    bookMeetingEnabled: boolean;
+}
+export interface SignalsAndInsightsDTO {
+    profileViews30d: number;
+    followsCount: number;
+    /** "Low" | "Medium" | "High" — default "Low" */
+    hiringIntensity: string;
+    topSkillsHiring: string[];
+    topViewingCountries: string[];
+    /** Raw from CompanyRelations.often_compared_with */
+    oftenComparedWith: unknown[];
+    /** Reserved — always [] */
+    similarCompanies: never[];
+}
+export interface VisibilityMetricsDTO {
+    searchImpressions: number;
+    profileClicks: number;
+    externalClicks: number;
+}
+export interface CompanyDTO {
+    id: string;
+    name: string;
+    /** URL-safe identifier — primary lookup key */
+    slug: string;
+    group_id: number | null;
+    group_name: string | null;
+    group_slug: string | null;
+    is_primary: boolean;
+    /**
+     * @deprecated Use classification.companyType instead
+     */
+    companyType: string | null;
+    claimedStatus: 'claimed' | 'unclaimed' | 'verified';
+    /** Absolute URL or "" — never null */
+    logo: string;
+    classification: ClassificationDTO;
+    overview: OverviewDTO;
+    productsAndServices: ProductRef[];
+    /** Full MarketRef objects (contrast with classification.markets which is string[]) */
+    markets: MarketRef[];
+    /** Full RegulatorRef objects */
+    regulators: RegulatorRef[];
+    /** Full ProductCategoryRef objects (contrast with classification.productCategories which is string[]) */
+    productCategories: ProductCategoryRef[];
+    trustAndCompliance: TrustAndComplianceDTO;
+    people: PeopleDTO;
+    jobs: JobsDTO;
+    newsAndMedia: NewsAndMediaDTO;
+    events: EventsDTO;
+    signalsAndInsights: SignalsAndInsightsDTO;
+    visibilityMetrics: VisibilityMetricsDTO;
+    /** null when enrichment score has not yet been computed */
+    enrichmentScore: EnrichmentScoreRef | null;
+}
+export interface CompanyListResponse {
+    /** Total items across all pages */
+    count: number;
+    /** Current 1-based page number */
+    page: number;
+    /** Items per page (max 200) */
+    page_size: number;
+    total_pages: number;
+    /** Full CompanyDTO objects — list shape is identical to detail shape */
+    results: CompanyDTO[];
+}

package/dist/types/src/types/complaint.d.ts

@@ -0,0 +1,21 @@
+export type ComplaintStatus = "resolved" | "open" | "unresolved";
+export interface Complaint {
+    id: string;
+    companyId: string;
+    companySlug: string;
+    companyName: string;
+    title: string;
+    body: string;
+    amount?: string;
+    currency?: string;
+    status: ComplaintStatus;
+    createdAt: string;
+    updatedAt?: string;
+    authorDisplayName: string;
+    isAnonymous: boolean;
+}
+export type ComplaintSortOption = "newest" | "oldest" | "amount-high" | "amount-low";
+export interface ComplaintFiltersState {
+    status?: ComplaintStatus;
+    sort: ComplaintSortOption;
+}

package/dist/types/src/types/conference.d.ts

@@ -0,0 +1,21 @@
+export interface ConferenceEvent {
+    _id?: string;
+    name: string;
+    conference: string;
+    conference_slug: string;
+    slug: string;
+    status: number;
+    scraped_at: string;
+    address?: string;
+    description?: string;
+    link?: string;
+    website?: string;
+    logo?: string;
+    source?: string;
+    stand?: string;
+    category?: string;
+    event_slug?: string;
+    event_year?: number;
+    email?: string;
+    social_links?: string[];
+}

package/dist/types/src/types/dashboard.d.ts

@@ -0,0 +1,252 @@
+import { DashboardJob } from "./job";
+import { FreelancerOnboardingData } from "@/types/freelancer";
+import { CompanyUserRole } from "./company-user";
+export type CoursesUpdatePayload = {
+    action: "enroll";
+    courseId: string;
+} | {
+    action: "continue";
+    courseId: string;
+} | {
+    action: "explore";
+} | {
+    action: "save";
+    courseId: string;
+} | {
+    action: "remove-saved";
+    courseId: string;
+} | {
+    action: "remove-recommended";
+    courseId: string;
+};
+export type NewsUpdatePayload = {
+    action: "read";
+    articleId: string;
+} | {
+    action: "save";
+    articleId: string;
+} | {
+    action: "remove-saved";
+    articleId: string;
+} | {
+    action: "remove-recommended";
+    articleId: string;
+} | {
+    action: "category";
+    category: string;
+} | {
+    action: "manage-preferences";
+};
+export interface NotificationSettings {
+    emailNotifications: boolean;
+    pushNotifications: boolean;
+    weeklyDigest: boolean;
+    jobAlerts: boolean;
+    courseUpdates: boolean;
+    newsDigest: boolean;
+}
+export interface ConnectedAccount {
+    id: string;
+    platform: string;
+    connected: boolean;
+    email?: string;
+}
+export interface SubscriptionSettings {
+    isPremium: boolean;
+    plan?: string;
+    renewalDate?: string | null;
+}
+export interface PasswordUpdateDetails {
+    currentPassword: string;
+    newPassword: string;
+    confirmPassword: string;
+}
+export interface UserSettings {
+    notifications: NotificationSettings;
+    connectedAccounts: ConnectedAccount[];
+    subscription: SubscriptionSettings;
+}
+export type SettingsUpdatePayload = {
+    action: "notifications";
+    updates: Partial<NotificationSettings>;
+} | {
+    action: "connect-account";
+    platform: string;
+} | {
+    action: "disconnect-account";
+    accountId: string;
+} | {
+    action: "upgrade";
+    plan?: string;
+} | {
+    action: "update-password";
+    details: PasswordUpdateDetails;
+} | {
+    action: "change-password";
+} | {
+    action: "delete-account";
+};
+export interface JobsDashboardData {
+    savedJobs: DashboardJob[];
+    recommendedJobs: DashboardJob[];
+    applications: DashboardJob[];
+}
+export interface CompanyOwnerDashboardData {
+    stats: {
+        openRoles: number;
+        totalApplicants: number;
+        profileViews: number;
+        teamMembers: number;
+    };
+    profileStrength?: number;
+    recentActivity?: Array<{
+        id: string;
+        title: string;
+        subtitle: string;
+        badge: string;
+        badgeVariant?: "default" | "secondary" | "destructive" | "outline";
+    }>;
+}
+export interface CompanyRecruiterDashboardData {
+    stats: {
+        activeJobs: number;
+        newApplicants: number;
+        interviewsThisWeek: number;
+        pendingReviews: number;
+    };
+    pipeline: Array<{
+        stage: string;
+        count: number;
+        color: string;
+    }>;
+    upcomingInterviews?: Array<{
+        id: string;
+        candidateName: string;
+        role: string;
+        scheduleLabel: string;
+    }>;
+    activeListings?: Array<{
+        id: string;
+        title: string;
+        location: string;
+        applicantsLabel: string;
+        badgeVariant?: "default" | "secondary" | "destructive" | "outline";
+    }>;
+}
+export interface CompanyEmployeeDashboardData {
+    announcements: Array<{
+        id: string;
+        title: string;
+        date: string;
+        isNew: boolean;
+    }>;
+    coursesInProgress: Array<{
+        id: string;
+        title: string;
+        progress: number;
+        provider: string;
+    }>;
+    upcomingEvents: Array<{
+        id: string;
+        title: string;
+        date: string;
+        location: string;
+        type: string;
+    }>;
+    colleagueCount: number;
+}
+export interface CompanyDashboardData {
+    owner?: CompanyOwnerDashboardData;
+    recruiter?: CompanyRecruiterDashboardData;
+    employee?: CompanyEmployeeDashboardData;
+}
+export interface ProfileData {
+    personalDetails: {
+        fullName?: string;
+        email?: string;
+        phone?: string;
+        location?: string;
+        dob?: string;
+        address?: string;
+        nationality?: string;
+        summary?: string | null;
+    };
+    workExperience: Array<{
+        id: string;
+        title: string;
+        company: string;
+        period: string;
+        summary?: string;
+        location?: string;
+        tags: string[];
+    }>;
+    jobSearchDetails: {
+        desiredRoles: string[];
+        locations: string[];
+        employmentType: string[];
+    };
+    skills: string[];
+    languages: Array<{
+        name: string;
+        proficiency: "Native" | "Fluent" | "Intermediate" | "Basic";
+    }>;
+    alerts: {
+        jobAlerts: boolean;
+        courseAlerts: boolean;
+        newsAlerts: boolean;
+    };
+    preferences: {
+        topics: string[];
+        language: string;
+        emailNotifications: boolean;
+    };
+    jobsDashboard?: JobsDashboardData;
+}
+export type FreelancerUpdatePayload = {
+    action: "start-onboarding";
+} | {
+    action: "complete-step-1";
+    data: Partial<FreelancerOnboardingData>;
+} | {
+    action: "complete-step-2";
+    data: Partial<FreelancerOnboardingData>;
+} | {
+    action: "go-public";
+} | {
+    action: "save-draft";
+    data: Partial<FreelancerOnboardingData>;
+} | {
+    action: "toggle-visibility";
+    visible: boolean;
+} | {
+    action: "edit-profile";
+};
+export type DashboardUpdateEvent = {
+    type: "jobs";
+    payload: JobsDashboardData;
+} | {
+    type: "profile";
+    payload: Partial<ProfileData>;
+} | {
+    type: "courses";
+    payload: CoursesUpdatePayload;
+} | {
+    type: "news";
+    payload: NewsUpdatePayload;
+} | {
+    type: "settings";
+    payload: SettingsUpdatePayload;
+} | {
+    type: "freelancer";
+    payload: FreelancerUpdatePayload;
+} | {
+    type: "alerts" | "overview";
+    payload: unknown;
+};
+export type DashboardTab = "overview" | "profile" | "jobs" | "alerts" | "courses" | "news" | "settings";
+export type DashboardRole = "jobSeeker" | "freelancer" | "owner" | "recruiter" | "companyEmployee";
+export declare const DASHBOARD_ROLE_TO_COMPANY_USER_ROLE: Record<Exclude<DashboardRole, "jobSeeker" | "freelancer">, CompanyUserRole>;
+export interface DashboardTabChangeEvent {
+    tab: DashboardTab;
+    path?: string;
+}

package/dist/types/src/types/events.courses.d.ts

@@ -0,0 +1,49 @@
+import type { BaseListingEvent } from "./events";
+export interface CoursesFilterStatePayload {
+    category?: string;
+    subcategory?: string;
+    levels: string[];
+    languages: string[];
+    features: string[];
+    rating: number;
+    priceRange: [number, number];
+    favoritesOnly: boolean;
+}
+export interface CoursesListingMetaPayload {
+    page: number;
+    pageSize: number;
+    totalResults?: number;
+    sortBy: "relevance" | "price-low-high" | "price-high-low" | "rating" | "newest" | "most-enrolled";
+    viewMode: "grid" | "list";
+}
+export type CoursesListingEvent = BaseListingEvent<"courses", "courses_listing_viewed", CoursesFilterStatePayload & CoursesListingMetaPayload> | BaseListingEvent<"courses", "courses_listing_viewmode_changed", {
+    viewMode: "grid" | "list";
+}> | BaseListingEvent<"courses", "courses_listing_items_per_page_changed", {
+    pageSize: number;
+}> | BaseListingEvent<"courses", "courses_listing_page_changed", {
+    page: number;
+    pageSize: number;
+    totalResults?: number;
+}> | BaseListingEvent<"courses", "courses_search_submitted", {
+    query: string;
+} & CoursesFilterStatePayload> | BaseListingEvent<"courses", "courses_filter_changed", {
+    changedKey: "category" | "subcategory" | "levels" | "languages" | "features" | "rating" | "priceRange" | "favoritesOnly";
+} & CoursesFilterStatePayload> | BaseListingEvent<"courses", "courses_filters_cleared_all", {}> | BaseListingEvent<"courses", "courses_category_selected", {
+    category: string | null;
+}> | BaseListingEvent<"courses", "courses_subcategory_selected", {
+    subcategory: string | null;
+}> | BaseListingEvent<"courses", "course_opened", {
+    courseId: string;
+    positionInList?: number;
+    openedFrom: "listing" | "hero" | "featured" | "other";
+    openedIn: "same_tab" | "new_tab" | "external";
+}> | BaseListingEvent<"courses", "course_favorited", {
+    courseId: string;
+    positionInList?: number;
+}> | BaseListingEvent<"courses", "course_unfavorited", {
+    courseId: string;
+    positionInList?: number;
+}> | BaseListingEvent<"courses", "course_enroll_clicked", {
+    courseId: string;
+    positionInList?: number;
+}>;

package/dist/types/src/types/events.d.ts

@@ -0,0 +1,23 @@
+export type ListingDomain = "jobs" | "courses" | "news" | "freelancers" | "newsletter";
+export interface ListingEventContext {
+    component: "Listing" | "IGamingCoursePage" | "NewsPage" | "Freelancers" | "FreelancerProfile" | "IgamingCareerHome";
+    route?: string;
+    sessionId?: string;
+    userId?: string | null;
+    source?: string;
+    [key: string]: unknown;
+}
+export interface BaseListingEvent<TDomain extends ListingDomain, TName extends string, TPayload> {
+    domain: TDomain;
+    name: TName;
+    payload: TPayload;
+    timestamp: string;
+    context?: ListingEventContext;
+}
+export type JobsListingEvent = import("./events.jobs").JobsListingEvent;
+export type CoursesListingEvent = import("./events.courses").CoursesListingEvent;
+export type NewsListingEvent = import("./events.news").NewsListingEvent;
+export type FreelancersListingEvent = import("./events.freelancers").FreelancersListingEvent;
+export type NewsletterEvent = import("./events.newsletter").NewsletterEvent;
+export type EmittedEvent = JobsListingEvent | CoursesListingEvent | NewsListingEvent | FreelancersListingEvent | NewsletterEvent;
+export type EmittedEventHandler = (event: EmittedEvent) => void;