@consenti/api 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,200 +1,27 @@
 import { EventEmitter } from 'node:events';
 import { IncomingMessage, ServerResponse } from 'node:http';
 
-type ConsentStatus = 'granted' | 'denied' | 'objected';
-type ConsentValue = Record<string, ConsentStatus>;
-interface Cookie {
-    id: string;
-    type?: 'consent' | 'legitimate_interest';
-    mandatory?: boolean;
-    listenGpc?: boolean;
-    expiry?: number;
-    tcfVendorId?: number;
-    tcfPurposes?: number[];
-    cpraCategory?: 'sale' | 'sharing' | 'sensitive';
-}
-type ButtonStyle = 'primary' | 'secondary' | 'text' | 'accent';
-type ButtonAction = 'submit' | 'manage' | 'close' | 'custom' | 'link';
-interface Button {
-    text: string;
-    style: ButtonStyle;
-    action: ButtonAction;
-    cookies?: string[] | '*' | '!';
-    url?: string;
-}
-interface MainBanner {
-    position: 'top' | 'bottom' | 'middle' | 'left-bottom' | 'right-bottom';
-    overlayOpacity?: number;
-    showClose?: boolean;
-    showLocaleSwitcher?: boolean;
-    heading?: string;
-    headingTag?: string;
-    htmlText: string;
-    buttons: Button[];
-}
-type GpcBanner = MainBanner;
-interface Category {
-    id: string;
-    heading: string;
-    headingTag?: string;
-    htmlText: string;
-    mandatory?: boolean;
-    type?: 'consent' | 'legitimate_interest';
-    legitimateInterest?: {
-        enabled?: boolean;
-        description?: string;
-    };
-    cookies: string[];
-}
-interface PreferenceModal {
-    position?: 'left' | 'right' | 'center';
-    overlayOpacity?: number;
-    showClose?: boolean;
-    showLocaleSwitcher?: boolean;
-    heading?: string;
-    headingTag?: string;
-    subheading?: string;
-    htmlText?: string;
-    buttons: Button[];
-    categories: Category[];
-    persistent?: boolean;
-}
-interface LocaleTranslations {
-    mainBanner: MainBanner;
-    gpcBanner?: GpcBanner;
-    preferenceModal: PreferenceModal;
-}
-interface ProfileTranslations {
-    [locale: string]: LocaleTranslations;
-}
-interface DpdpaConfig {
-    dataFiduciary: string;
-    grievanceEmail: string;
-    purposeDescription?: string;
-}
-interface LocaleTextContent {
-    mainBanner: {
-        heading: string;
-        htmlText: string;
-        buttonLabels: string[];
-    };
-    gpcBanner: {
-        heading: string;
-        htmlText: string;
-        buttonLabels: string[];
-    };
-    preferenceModal: {
-        heading: string;
-        subheading?: string;
-        htmlText?: string;
-        buttonLabels: string[];
-        categories: Array<{
-            id: string;
-            heading: string;
-            htmlText: string;
-        }>;
-    };
-}
-interface ProfileConfig {
-    cookies?: Cookie[];
-    defaultLocale: string;
-    translations?: ProfileTranslations;
-    gpcBanner?: boolean;
-    darkMode?: boolean;
-    allowedOrigins?: string[];
-    dpdpa?: DpdpaConfig;
-    regulation?: 'gdpr' | 'ccpa' | 'cpra' | 'dpdpa' | 'uk-gdpr' | 'lgpd' | 'pipeda' | 'popia' | 'pdpa-th' | 'appi' | 'kvkk';
-    regulations?: string[];
-    cookieTemplateId?: string;
-    uiTemplateId?: string;
-    localeContents?: Record<string, LocaleTextContent>;
-}
-interface UITemplateButton {
-    text: string;
-    type: string;
-    action: 'submit' | 'custom' | 'manage' | 'close' | 'link';
-    cookies?: string | string[];
-    url?: string;
-}
-interface UITemplateBanner {
-    position: string;
-    overlayOpacity: number;
-    showClose: boolean;
-    showLocaleSwitcher?: boolean;
-    headingTag: string;
-    buttons: UITemplateButton[];
-}
-interface UITemplateCategory {
-    id: string;
-    headingTag: string;
-    mandatory: boolean;
-    type: 'consent' | 'legitimate_interest';
-    liEnabled: boolean;
-    cookies: string[];
-}
-interface UITemplateModal extends UITemplateBanner {
-    hasSubheading: boolean;
-    persistent: boolean;
-    showLocaleSwitcher?: boolean;
-    categories: UITemplateCategory[];
-}
-interface ServerUITemplate {
-    id: string;
-    tenantId: string;
-    name: string;
-    mainBanner: UITemplateBanner;
-    gpcBanner: UITemplateBanner;
-    preferenceModal: UITemplateModal;
-    createdAt: string;
-    updatedAt: string;
-}
-interface ServerCookieTemplate {
-    id: string;
-    tenantId: string;
-    name: string;
-    cookies: Cookie[];
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreateCookieTemplateInput {
-    tenantId: string;
-    name: string;
-    cookies: Cookie[];
-}
-interface UpdateCookieTemplateInput {
-    name?: string;
-    cookies?: Cookie[];
-}
-interface CreateUITemplateInput {
-    tenantId: string;
-    name: string;
-    mainBanner: UITemplateBanner;
-    gpcBanner: UITemplateBanner;
-    preferenceModal: UITemplateModal;
-}
-interface UpdateUITemplateInput {
-    name?: string;
-    mainBanner?: UITemplateBanner;
-    gpcBanner?: UITemplateBanner;
-    preferenceModal?: UITemplateModal;
-}
-interface PublicProfileResponse {
-    id: string;
-    version: number;
-    defaultLocale: string;
-    currentLocale: string;
-    locales: string[];
-    cookies: Cookie[];
-    mainBanner: MainBanner;
-    gpcBanner?: GpcBanner;
-    preferenceModal: PreferenceModal;
-}
+declare const COMPLIANCE_GROUP_IDS: readonly ["opt-in", "opt-out", "opt-out-strict", "opt-in-dpdpa", "opt-in-china", "opt-in-brazil", "general-privacy-consent", "notice-only"];
+
+/**
+ * Compliance-related literal types, derived from the regulation/group ID data
+ * that lives in @consenti/utils (packages/utils/src/compliance.ts).
+ *
+ * This import is type-only and fully erased at compile time — @consenti/types
+ * has no runtime dependency on @consenti/utils. The actual data (COMPLIANCE_GROUPS,
+ * EMBEDDED_COMPLIANCE_MAP, COMPLIANCE_VALIDATION_RULES, GPC_OPTIONS, etc.) lives in
+ * @consenti/utils; import it from there.
+ *
+ * HOW TO ADD A NEW REGULATION OR COMPLIANCE GROUP: see the header comment in
+ * packages/utils/src/compliance.ts — these types auto-update from that data.
+ */
+
+type ComplianceGroupId = typeof COMPLIANCE_GROUP_IDS[number];
 
 interface StorageConfig {
     driver: 'sqlite' | 'better-sqlite3' | 'node-sqlite3-wasm' | 'node:sqlite' | 'mongodb' | 'mysql' | 'postgresql' | 'json';
     path?: string;
     uri?: string;
-    dbName?: string;
     database?: string;
     host?: string;
     port?: number;
@@ -231,10 +58,97 @@ interface RateLimitConfig {
     windowMs?: number;
     maxRequests?: number;
 }
+type GeoResult = {
+    country: string | null;
+    region: string | null;
+    locale: string | null;
+};
+type CountryResolverFn = (ctx: {
+    ip: string;
+    language: string;
+    timezone: string;
+}) => Promise<GeoResult>;
+interface S3ApiConfig {
+    enabled: boolean;
+    region: string;
+    bucketName: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+}
+interface ProfileSummary {
+    id: string;
+    name: string;
+    defaultLocale: string;
+    complianceGroup: ComplianceGroupId | null;
+    version: number;
+    isActive: boolean;
+    cookieTemplateName: string | null;
+    uiTemplateName: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ProfileVersionEntry {
+    version: number;
+    createdAt: string;
+    locales: string[];
+}
+interface OptInFilters {
+    profileId?: string;
+    complianceGroup?: string;
+    from?: string;
+    to?: string;
+    locale?: string;
+}
+interface OptInByLocale {
+    total: number;
+    granted: number;
+    denied: number;
+    managed: number;
+}
+interface OptInByDate {
+    date: string;
+    total: number;
+    granted: number;
+    denied: number;
+    managed: number;
+}
+interface OptInStats {
+    total: number;
+    granted: number;
+    denied: number;
+    managed: number;
+    grantedPct: number;
+    deniedPct: number;
+    managedPct: number;
+    byLocale: Record<string, OptInByLocale>;
+    byDate: OptInByDate[];
+}
+type ComplianceMapOverride = 'default' | ComplianceMapData | 'auto';
+interface ComplianceMapData {
+    version: string;
+    countries: Record<string, CountryComplianceEntry>;
+}
+interface CountryComplianceEntry {
+    complianceGroup: ComplianceGroupId;
+    default: ComplianceGroupId;
+    description: string;
+    overriddenRegions?: Record<string, {
+        complianceGroup: ComplianceGroupId;
+        description: string;
+    }>;
+}
 interface ComplianceConfig {
+    /** @deprecated use type */
     gdpr?: boolean;
+    /** @deprecated use type */
     ccpa?: boolean;
-    gpc?: boolean;
+    gpc?: boolean | 'strict';
+    type?: ComplianceGroupId | 'auto';
+    /** @deprecated use 'default' instead of 'language' or 'timezone'; 'geoip' and 'hosted-geoip-lite' removed */
+    geoDataProvider?: 'default' | 'maxmind' | 'language' | 'timezone' | 'geoip' | 'hosted-geoip-lite' | CountryResolverFn;
+    autoComplianceMap?: ComplianceMapOverride;
+    complianceMapUrl?: string;
 }
 interface DashboardConfig {
     enabled?: boolean;
@@ -256,6 +170,18 @@ interface TcfConfig {
 interface DataRetentionConfig {
     purgeAfterDays: number;
 }
+interface BrandingConfig {
+    /** Display name shown in the dashboard (login page, header, browser tab). Default: 'Consenti'. */
+    appName?: string;
+    /**
+     * Logo to display in the dashboard. Accepts a public URL (https://…) or a local
+     * filesystem path — when a path is given, the file is copied into the dashboard
+     * dist and served as a static asset automatically.
+     */
+    appLogoPath?: string;
+    /** When true, hides the "Powered by Consenti" badge in the dashboard. Default: false. */
+    hidePoweredBy?: boolean;
+}
 interface ConsentiServerConfig {
     basePath?: string;
     dashboard?: boolean | DashboardConfig;
@@ -270,6 +196,10 @@ interface ConsentiServerConfig {
     dataRetention?: DataRetentionConfig;
     maxBodySize?: number;
     trustedProxies?: string[];
+    branding?: BrandingConfig;
+    s3Api?: S3ApiConfig;
+    /** Called after every profile activate/deactivate/delete. isPurge=true means invalidate; false means warm. */
+    handleCache?: (paths: string[], currentVersion: number, isPurge: boolean) => void;
 }
 interface Tenant {
     id: string;
@@ -343,6 +273,8 @@ interface AdminUser {
     isActive: boolean;
     totpEnabled?: boolean;
     totpSecret?: string;
+    /** Empty array = access to all tenants. Non-empty = restricted to listed tenant IDs. */
+    allowedTenants?: string[];
     createdAt: string;
     updatedAt: string;
 }
@@ -417,6 +349,7 @@ interface CreateUserInput {
     name: string;
     email: string;
     passwordHash: string;
+    allowedTenants?: string[];
 }
 interface UpdateUserInput {
     name?: string;
@@ -425,6 +358,7 @@ interface UpdateUserInput {
     isActive?: boolean;
     totpSecret?: string | null;
     totpEnabled?: boolean;
+    allowedTenants?: string[];
 }
 interface CreateAuditLogInput {
     tenantId: string;
@@ -522,6 +456,12 @@ interface StorageAdapter {
     deleteProfile(id: string): Promise<void>;
     getProfile(id: string): Promise<Profile | null>;
     getProfiles(tenantId: string): Promise<Profile[]>;
+    findActiveProfileByComplianceGroup(tenantId: string, complianceGroup: string): Promise<Profile | null>;
+    /** Lightweight list — no profile_json blob; single JOIN for template names. */
+    listProfilesSummary(tenantId: string): Promise<ProfileSummary[]>;
+    findProfilesUsingCookieTemplate(templateId: string): Promise<ProfileSummary[]>;
+    findProfilesUsingUITemplate(templateId: string): Promise<ProfileSummary[]>;
+    getOptInStats(tenantId: string, filters: OptInFilters): Promise<OptInStats>;
     createConsent(data: CreateConsentInput): Promise<ConsentDbRecord>;
     updateConsent(visitorId: string, data: UpdateConsentInput): Promise<ConsentDbRecord>;
     deleteConsent(visitorId: string): Promise<void>;
@@ -600,6 +540,188 @@ declare abstract class ConsentiServerPlugin {
     afterUserCreate?(user: AdminUser): Promise<void>;
 }
 
+type ConsentStatus = 'granted' | 'denied' | 'objected';
+type ConsentValue = Record<string, ConsentStatus>;
+interface Cookie {
+    id: string;
+    legalBasis?: 'mandatory' | 'consent' | 'legitimate_interest';
+    /** @deprecated use legalBasis: 'mandatory' */
+    mandatory?: boolean;
+    /** @deprecated use legalBasis */
+    type?: 'consent' | 'legitimate_interest';
+    listenGpc?: boolean;
+    expiry?: number;
+    tcfVendorId?: number;
+    tcfPurposes?: number[];
+    tcfSpecialFeatures?: number[];
+    cpraCategory?: 'sale' | 'sharing' | 'sensitive';
+}
+type ButtonStyle = 'primary' | 'secondary' | 'text' | 'accent';
+type ButtonAction = 'submit' | 'manage' | 'close' | 'custom' | 'link';
+interface Button {
+    text: string;
+    style: ButtonStyle;
+    action: ButtonAction;
+    cookies?: string[] | '*' | '!';
+    url?: string;
+    type?: string;
+}
+interface MainBanner {
+    position: 'top' | 'bottom' | 'middle' | 'left-bottom' | 'right-bottom';
+    overlayOpacity?: number;
+    showClose?: boolean;
+    showLocaleSwitcher?: boolean;
+    heading?: string;
+    headingTag?: string;
+    htmlText: string;
+    buttons: Button[];
+}
+type GpcBanner = MainBanner;
+interface Category {
+    id: string;
+    heading: string;
+    headingTag?: string;
+    htmlText: string;
+    mandatory?: boolean;
+    type?: 'consent' | 'legitimate_interest';
+    legitimateInterest?: {
+        enabled?: boolean;
+        description?: string;
+    };
+    cookies: string[];
+}
+interface PreferenceModal extends Omit<MainBanner, "position"> {
+    position?: 'left' | 'right' | 'center';
+    subheading?: string;
+    categories: Category[];
+    persistent?: boolean;
+    /** Screen width in px below which the modal expands to full screen. Default: 576. Set to 0 to disable. */
+    mobileFullScreenBreakpoint?: number;
+}
+interface LocaleTranslations {
+    mainBanner: MainBanner;
+    gpcBanner?: GpcBanner;
+    preferenceModal: PreferenceModal;
+}
+interface ProfileTranslations {
+    [locale: string]: LocaleTranslations;
+}
+interface DpdpaConfig {
+    dataFiduciary: string;
+    grievanceEmail: string;
+    purposeDescription?: string;
+}
+interface LocaleTextContent {
+    mainBanner: {
+        heading?: string;
+        htmlText: string;
+        buttonLabels?: string[];
+    };
+    gpcBanner: {
+        heading?: string;
+        htmlText: string;
+        buttonLabels?: string[];
+    };
+    preferenceModal: {
+        heading: string;
+        subheading?: string;
+        htmlText?: string;
+        buttonLabels?: string[];
+        categories: {
+            id: string;
+            heading: string;
+            htmlText: string;
+        }[];
+    };
+}
+interface ProfileConfig {
+    cookies?: Cookie[];
+    defaultLocale: string;
+    translations?: ProfileTranslations;
+    gpcBanner?: boolean;
+    darkMode?: boolean;
+    allowedOrigins?: string[];
+    dpdpa?: DpdpaConfig;
+    regulation?: 'gdpr' | 'ccpa' | 'cpra' | 'dpdpa' | 'uk-gdpr' | 'lgpd' | 'pipeda' | 'popia' | 'pdpa-th' | 'appi' | 'kvkk';
+    regulations?: string[];
+    cookieTemplateId?: string;
+    uiTemplateId?: string;
+    localeContents?: Record<string, LocaleTextContent>;
+    complianceGroup?: string;
+    /** @deprecated use gpcMode */
+    gpcCompliance?: 'strict' | 'honor' | 'ignore';
+    gpcMode?: 'ignore' | 'honor' | 'strict';
+    isActive?: boolean;
+    hidePoweredBy?: boolean;
+    allowReceipt?: boolean;
+    /** Per-compliance extra config (e.g. DPDPA data fiduciary name). */
+    complianceConfig?: Record<string, string>;
+}
+interface ServerUITemplate {
+    id: string;
+    tenantId: string;
+    name: string;
+    mainBanner: MainBanner;
+    gpcBanner: GpcBanner;
+    preferenceModal: PreferenceModal;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ServerCookieTemplate {
+    id: string;
+    tenantId: string;
+    name: string;
+    cookies: Cookie[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateCookieTemplateInput {
+    tenantId: string;
+    name: string;
+    cookies: Cookie[];
+}
+interface UpdateCookieTemplateInput {
+    name?: string;
+    cookies?: Cookie[];
+}
+interface CreateUITemplateInput {
+    tenantId: string;
+    name: string;
+    mainBanner: MainBanner;
+    gpcBanner: MainBanner;
+    preferenceModal: PreferenceModal;
+}
+interface UpdateUITemplateInput {
+    name?: string;
+    mainBanner?: MainBanner;
+    gpcBanner?: MainBanner;
+    preferenceModal?: PreferenceModal;
+}
+interface PublicProfileResponse {
+    id: string;
+    name?: string;
+    tenantId?: string;
+    version: number;
+    defaultLocale: string;
+    currentLocale: string;
+    locales: string[];
+    cookies: Cookie[];
+    mainBanner: MainBanner;
+    gpcBanner?: GpcBanner;
+    preferenceModal: PreferenceModal;
+    resolvedComplianceGroup?: string;
+    complianceGroup?: string;
+    compliances?: string[];
+    complianceConfig?: Record<string, string>;
+    allowedOrigins?: string[];
+    gpcMode?: boolean | 'ignore' | 'honor' | 'strict';
+    hidePoweredBy?: boolean;
+    allowReceipt?: boolean;
+    darkMode?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+}
+
 declare class ProfileRepo {
     private adapter;
     constructor(adapter: StorageAdapter);
@@ -608,6 +730,7 @@ declare class ProfileRepo {
     delete(id: string): Promise<void>;
     get(id: string): Promise<Profile | null>;
     list(tenantId: string): Promise<Profile[]>;
+    findActiveByComplianceGroup(tenantId: string, complianceGroup: string): Promise<Profile | null>;
 }
 
 declare class AuditRepo {
@@ -617,18 +740,43 @@ declare class AuditRepo {
     list(filters: AuditFilters): Promise<AuditLog[]>;
 }
 
+declare class LocaleJsonCacheService {
+    private readonly dir;
+    constructor(dir: string);
+    read(profileId: string, locale: string): PublicProfileResponse | null;
+    write(profileId: string, locale: string, response: PublicProfileResponse): void;
+    rebuild(profileId: string, responses: Map<string, PublicProfileResponse>): void;
+    invalidate(profileId: string): void;
+    private path;
+}
+
 declare class ProfileService {
     private profiles;
     private audit;
     private tenantId;
     private storage?;
-    constructor(profiles: ProfileRepo, audit: AuditRepo, tenantId?: string, storage?: StorageAdapter | undefined);
+    private eventBus?;
+    private localeCache?;
+    private profilesDir?;
+    private handleCache?;
+    private s3Config?;
+    constructor(profiles: ProfileRepo, audit: AuditRepo, tenantId?: string, storage?: StorageAdapter | undefined, eventBus?: EventEmitter | undefined, localeCache?: LocaleJsonCacheService | undefined, profilesDir?: string | undefined, handleCache?: ((paths: string[], version: number, isPurge: boolean) => void) | undefined, s3Config?: S3ApiConfig | undefined);
+    private profileDir;
+    private complianceGroupDir;
+    private profileFilePaths;
     create(input: Omit<CreateProfileInput, 'tenantId'>): Promise<Profile>;
     update(id: string, input: UpdateProfileInput): Promise<Profile>;
     delete(id: string): Promise<void>;
+    activate(id: string): Promise<Profile>;
+    deactivate(id: string): Promise<Profile>;
+    private runWrite;
     get(id: string, locale?: string): Promise<Profile | null>;
     getResolved(id: string, locale?: string): Promise<PublicProfileResponse | null>;
+    findActiveByComplianceGroup(complianceGroup: string): Promise<Profile | null>;
     list(): Promise<Profile[]>;
+    listSummary(): Promise<ProfileSummary[]>;
+    listVersions(profileId: string): ProfileVersionEntry[];
+    getVersionFile(profileId: string, version: number, locale: string): string | null;
 }
 
 declare class ConsentRepo {
@@ -685,7 +833,8 @@ declare class ConsentService {
 declare class VisitorService {
     private visitors;
     private tenantId;
-    constructor(visitors: VisitorRepo, tenantId?: string);
+    private eventBus?;
+    constructor(visitors: VisitorRepo, tenantId?: string, eventBus?: EventEmitter | undefined);
     upsert(data: {
         visitorId: string;
         ip?: string;
@@ -721,12 +870,14 @@ declare class UserService {
         email: string;
         password: string;
         roleId?: string;
+        allowedTenants?: string[];
     }, actorId?: string): Promise<SafeAdminUser>;
     update(id: string, input: {
         name?: string;
         email?: string;
         isActive?: boolean;
         password?: string;
+        allowedTenants?: string[];
     }, actorId?: string): Promise<SafeAdminUser>;
     delete(id: string, actorId?: string): Promise<void>;
     get(id: string): Promise<SafeAdminUser | null>;
@@ -751,6 +902,7 @@ declare class BetterSqlite3Adapter implements StorageAdapter {
     deleteProfile(id: string): Promise<void>;
     getProfile(id: string): Promise<Profile | null>;
     getProfiles(tenantId: string): Promise<Profile[]>;
+    findActiveProfileByComplianceGroup(tenantId: string, complianceGroup: string): Promise<Profile | null>;
     private mapConsent;
     createConsent(data: CreateConsentInput): Promise<ConsentDbRecord>;
     updateConsent(visitorId: string, data: UpdateConsentInput): Promise<ConsentDbRecord>;
@@ -817,6 +969,12 @@ declare class BetterSqlite3Adapter implements StorageAdapter {
     getUITemplate(id: string): Promise<ServerUITemplate | null>;
     getUITemplates(tenantId: string): Promise<ServerUITemplate[]>;
     copyUITemplate(id: string, newName: string): Promise<ServerUITemplate>;
+    private mapProfileSummary;
+    private readonly PROFILE_SUMMARY_SQL;
+    listProfilesSummary(tenantId: string): Promise<ProfileSummary[]>;
+    findProfilesUsingCookieTemplate(templateId: string): Promise<ProfileSummary[]>;
+    findProfilesUsingUITemplate(templateId: string): Promise<ProfileSummary[]>;
+    getOptInStats(tenantId: string, filters: OptInFilters): Promise<OptInStats>;
 }
 
 declare class MongoDBAdapter implements StorageAdapter {
@@ -835,6 +993,7 @@ declare class MongoDBAdapter implements StorageAdapter {
     deleteProfile(id: string): Promise<void>;
     getProfile(id: string): Promise<Profile | null>;
     getProfiles(tenantId: string): Promise<Profile[]>;
+    findActiveProfileByComplianceGroup(tenantId: string, complianceGroup: string): Promise<Profile | null>;
     createConsent(data: CreateConsentInput): Promise<ConsentDbRecord>;
     updateConsent(visitorId: string, data: UpdateConsentInput): Promise<ConsentDbRecord>;
     deleteConsent(visitorId: string): Promise<void>;
@@ -897,6 +1056,10 @@ declare class MongoDBAdapter implements StorageAdapter {
     getUITemplate(): Promise<never>;
     getUITemplates(): Promise<never>;
     copyUITemplate(): Promise<never>;
+    listProfilesSummary(): Promise<never[]>;
+    findProfilesUsingCookieTemplate(): Promise<never[]>;
+    findProfilesUsingUITemplate(): Promise<never[]>;
+    getOptInStats(): Promise<never>;
 }
 
 declare class MySQLAdapter implements StorageAdapter {
@@ -914,6 +1077,7 @@ declare class MySQLAdapter implements StorageAdapter {
     deleteProfile(id: string): Promise<void>;
     getProfile(id: string): Promise<Profile | null>;
     getProfiles(tenantId: string): Promise<Profile[]>;
+    findActiveProfileByComplianceGroup(tenantId: string, complianceGroup: string): Promise<Profile | null>;
     createConsent(data: CreateConsentInput): Promise<ConsentDbRecord>;
     updateConsent(visitorId: string, data: UpdateConsentInput): Promise<ConsentDbRecord>;
     deleteConsent(visitorId: string): Promise<void>;
@@ -976,6 +1140,10 @@ declare class MySQLAdapter implements StorageAdapter {
     getUITemplate(): Promise<never>;
     getUITemplates(): Promise<never>;
     copyUITemplate(): Promise<never>;
+    listProfilesSummary(): Promise<never[]>;
+    findProfilesUsingCookieTemplate(): Promise<never[]>;
+    findProfilesUsingUITemplate(): Promise<never[]>;
+    getOptInStats(): Promise<never>;
 }
 
 declare class PostgreSQLAdapter implements StorageAdapter {
@@ -992,6 +1160,7 @@ declare class PostgreSQLAdapter implements StorageAdapter {
     deleteProfile(id: string): Promise<void>;
     getProfile(id: string): Promise<Profile | null>;
     getProfiles(tenantId: string): Promise<Profile[]>;
+    findActiveProfileByComplianceGroup(tenantId: string, complianceGroup: string): Promise<Profile | null>;
     createConsent(data: CreateConsentInput): Promise<ConsentDbRecord>;
     updateConsent(visitorId: string, data: UpdateConsentInput): Promise<ConsentDbRecord>;
     deleteConsent(visitorId: string): Promise<void>;
@@ -1054,13 +1223,17 @@ declare class PostgreSQLAdapter implements StorageAdapter {
     getUITemplate(): Promise<never>;
     getUITemplates(): Promise<never>;
     copyUITemplate(): Promise<never>;
+    listProfilesSummary(): Promise<never[]>;
+    findProfilesUsingCookieTemplate(): Promise<never[]>;
+    findProfilesUsingUITemplate(): Promise<never[]>;
+    getOptInStats(): Promise<never>;
 }
 
 declare const dashboardDir: string;
 declare function createConsenti(userConfig: ConsentiServerConfig): {
     router: (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
     handler: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
-    fastifyPlugin: (fastify: {
+    fastifyHandler: (fastify: {
         all: (path: string, handler: (req: {
             raw: IncomingMessage;
         }, reply: {
@@ -1078,8 +1251,9 @@ declare function createConsenti(userConfig: ConsentiServerConfig): {
         user: UserService;
     };
     storage: StorageAdapter;
-    eventBus: EventEmitter<[never]>;
+    eventBus: EventEmitter<any>;
+    ready: Promise<void>;
     destroy: () => Promise<void>;
 };
 
-export { type AdminUser, type AuditLog, type ConsentDbRecord, type ConsentVerifyResult, type ConsentiServerConfig, MongoDBAdapter, MySQLAdapter, type Permission, PostgreSQLAdapter, type Profile, type Role, BetterSqlite3Adapter as SQLiteAdapter, type SafeAdminUser, type StorageAdapter, type Visitor, createConsenti, dashboardDir };
+export { type AdminUser, type AuditLog, type BrandingConfig, type ConsentDbRecord, type ConsentVerifyResult, type ConsentiServerConfig, MongoDBAdapter, MySQLAdapter, type Permission, PostgreSQLAdapter, type Profile, type Role, BetterSqlite3Adapter as SQLiteAdapter, type SafeAdminUser, type StorageAdapter, type Visitor, createConsenti, dashboardDir };