@marvalt/digivalt-core 0.1.0

package/dist/lib/structured-data.d.ts

@@ -0,0 +1,49 @@
+export declare const createOrganizationSchema: (data: {
+    name: string;
+    url: string;
+    logo?: string;
+    description?: string;
+    address?: {
+        streetAddress: string;
+        addressLocality: string;
+        addressRegion: string;
+        postalCode: string;
+        addressCountry: string;
+    };
+    contactPoint?: {
+        telephone: string;
+        contactType: string;
+    };
+}) => StructuredData;
+export declare const createWebSiteSchema: (data: {
+    name: string;
+    url: string;
+    description?: string;
+    publisher?: string;
+}) => StructuredData;
+export declare const createArticleSchema: (data: {
+    headline: string;
+    description: string;
+    image?: string;
+    author: string;
+    publisher: string;
+    datePublished: string;
+    dateModified?: string;
+    url: string;
+}) => StructuredData;
+export declare const createServiceSchema: (data: {
+    name: string;
+    description: string;
+    provider: string;
+    url: string;
+    areaServed?: string;
+    serviceType?: string;
+}) => StructuredData;
+export declare const createBreadcrumbSchema: (breadcrumbs: Array<{
+    name: string;
+    url: string;
+}>) => StructuredData;
+export declare const createFAQSchema: (faqs: Array<{
+    question: string;
+    answer: string;
+}>) => StructuredData;

package/dist/lib/utils.d.ts

@@ -0,0 +1,42 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * Decodes HTML entities in a string
+ * Handles both named entities (&, ") and numeric entities (', ’)
+ * @param text - The text string with HTML entities
+ * @returns Decoded text string
+ */
+export declare function decodeHtmlEntities(text: string): string;
+/**
+ * Replaces common WordPress HTML entities so they display as expected (e.g. en dash as hyphen, &/& as &).
+ * Use on block innerHTML or other WP-rendered HTML before passing to dangerouslySetInnerHTML.
+ */
+export declare function normalizeWordPressHtmlEntities(html: string): string;
+/**
+ * Sanitizes HTML content to prevent XSS attacks
+ * @param html - The HTML string to sanitize
+ * @returns Sanitized HTML string
+ */
+export declare function sanitizeHtml(html: string): string;
+/**
+ * Safely renders HTML content with sanitization
+ * @param html - The HTML string to render
+ * @returns Object for dangerouslySetInnerHTML with sanitized content
+ */
+export declare function safeHtml(html: string): {
+    __html: string;
+};
+/**
+ * Validates if a URL is safe for redirects
+ * @param url - The URL to validate
+ * @param allowedDomains - Array of allowed domains (optional)
+ * @returns boolean indicating if the URL is safe
+ */
+export declare function isValidRedirectUrl(url: string, allowedDomains?: string[]): boolean;
+/**
+ * Safely redirects to a URL after validation
+ * @param url - The URL to redirect to
+ * @param allowedDomains - Array of allowed domains (optional)
+ * @param fallbackUrl - Fallback URL if validation fails (optional)
+ */
+export declare function safeRedirect(url: string, allowedDomains?: string[], fallbackUrl?: string): void;

package/dist/services/cf-wp-webhook.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Cloudflare WordPress Webhook Service
+ * Handles webhook status and data regeneration monitoring
+ */
+export interface WebhookStatus {
+    last_triggered: string | null;
+    last_success: string | null;
+    last_error: string | null;
+    total_triggers: number;
+    success_rate: number;
+    status: 'healthy' | 'warning' | 'error' | 'unknown';
+}
+export interface WebhookResponse {
+    success: boolean;
+    message: string;
+    timestamp: string;
+    data_generated?: {
+        static_data: boolean;
+        gravity_forms: boolean;
+        mautic_data: boolean;
+    };
+    errors?: string[];
+}
+export interface WebhookConfig {
+    enabled: boolean;
+    refresh_secret: string;
+    frontends: Array<{
+        frontend_id: string;
+        webhook_url: string;
+        enabled: boolean;
+    }>;
+    post_types: string[];
+    rate_limit_minutes: number;
+}
+declare class CfWpWebhookService {
+    private baseUrl;
+    private refreshSecret;
+    constructor();
+    /**
+     * Get webhook status from WordPress
+     */
+    getWebhookStatus(): Promise<WebhookStatus>;
+    /**
+     * Get webhook configuration from WordPress
+     */
+    getWebhookConfig(): Promise<WebhookConfig | null>;
+    /**
+     * Test webhook endpoint
+     */
+    testWebhook(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Get last webhook response
+     */
+    getLastWebhookResponse(): Promise<WebhookResponse | null>;
+    /**
+     * Manually trigger data regeneration
+     */
+    triggerDataRegeneration(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Check if webhook is properly configured
+     */
+    isConfigured(): boolean;
+    /**
+     * Get configuration status
+     */
+    getConfigurationStatus(): {
+        wordpress_url: boolean;
+        refresh_secret: boolean;
+        fully_configured: boolean;
+    };
+}
+export declare const cfWpWebhookService: CfWpWebhookService;
+export default cfWpWebhookService;

package/dist/services/gravityForms.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Gravity Forms Integration Service
+ * Uses @marvalt/wadapter package for secure form submissions
+ */
+import { GravityFormsClient } from '@marvalt/wadapter';
+export type { GravityForm, GravityFormField, GravityFormSubmission, GravityFormSubmissionResult, GravityFormsConfig, } from '@marvalt/wadapter';
+export declare const gravityFormsClient: GravityFormsClient;
+export interface GravityFormEntry {
+    [fieldId: string]: any;
+}
+export declare const gravityFormsService: {
+    /**
+     * Submit a Gravity Form (legacy interface)
+     * @param formId - Form ID as string or number
+     * @param entry - Entry data with field IDs as keys
+     * @param files - Optional files (not yet supported)
+     * @param useBasicApi - Ignored (always uses proxy)
+     */
+    submitForm(formId: string | number, entry: GravityFormEntry, files?: {
+        [fieldId: string]: File[];
+    }, useBasicApi?: boolean): Promise<import("@marvalt/wadapter").GravityFormSubmissionResult>;
+    getForm: (id: number) => Promise<any>;
+    getForms: () => Promise<any>;
+    getFormConfig: (id: number) => Promise<any>;
+    getHealth: () => Promise<any>;
+};

package/dist/services/index.d.ts

@@ -0,0 +1,5 @@
+export * from './wordpress';
+export * from './gravityForms';
+export * from './mautic';
+export * from './suitecrm';
+export * from './cf-wp-webhook';

package/dist/services/mautic.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Mautic Integration Service (via @marvalt/madapter)
+ */
+export interface MauticContact {
+    id?: number;
+    email: string;
+    firstname?: string;
+    lastname?: string;
+    company?: string;
+    phone?: string;
+    tags?: string[];
+    customFields?: {
+        [key: string]: unknown;
+    };
+}
+export interface MauticFormSubmission {
+    formId: number;
+    fields: {
+        [fieldName: string]: unknown;
+    };
+    contact?: MauticContact;
+    formName?: string;
+    returnUrl?: string;
+}
+export interface MauticFormField {
+    id: number;
+    label: string;
+    alias: string;
+    type: string;
+    isRequired: boolean;
+    validationMessage?: string;
+    defaultValue?: string;
+    properties?: {
+        placeholder?: string;
+        cssClass?: string;
+        validation?: string[];
+        options?: string[];
+        helpText?: string;
+        size?: string;
+        [key: string]: unknown;
+    };
+}
+export interface MauticFormAction {
+    id: number;
+    name: string;
+    type: 'email' | 'notification' | 'tag' | 'segment';
+    properties: {
+        email?: string;
+        subject?: string;
+        message?: string;
+        tags?: string[];
+        segmentId?: number;
+        [key: string]: unknown;
+    };
+}
+export interface MauticForm {
+    id: number;
+    name: string;
+    description?: string;
+    fields: MauticFormField[];
+    actions: MauticFormAction[];
+    cssClass?: string;
+    submitAction?: string;
+    postAction?: string;
+    postActionProperty?: string;
+    formType?: string;
+    isPublished?: boolean;
+}
+export interface MauticFormConfig {
+    id: number;
+    name: string;
+    description?: string;
+    fields: MauticFormField[];
+    actions: MauticFormAction[];
+    cssClass?: string;
+    submitAction?: string;
+    postAction?: string;
+    postActionProperty?: string;
+    formType?: string;
+    isPublished?: boolean;
+}
+export declare const mauticService: any;

package/dist/services/suitecrm.d.ts

@@ -0,0 +1,98 @@
+export interface SuiteCRMLead {
+    first_name: string;
+    last_name: string;
+    email1: string;
+    phone_work?: string;
+    lead_source?: string;
+    status?: string;
+    description?: string;
+    campaign_id?: string;
+    [key: string]: any;
+}
+export interface SuiteCRMContact {
+    first_name: string;
+    last_name: string;
+    email1: string;
+    phone_work?: string;
+    title?: string;
+    department?: string;
+    [key: string]: any;
+}
+export interface SuiteCRMAccount {
+    name: string;
+    billing_address_city?: string;
+    billing_address_country?: string;
+    phone_office?: string;
+    website?: string;
+    [key: string]: any;
+}
+export interface SuiteCRMOpportunity {
+    name: string;
+    amount?: number;
+    sales_stage?: string;
+    probability?: number;
+    expected_close_date?: string;
+    [key: string]: any;
+}
+export interface SuiteCRMAPIResponse<T = any> {
+    data?: T;
+    errors?: Array<{
+        status: string;
+        code: string;
+        title: string;
+        detail: string;
+    }>;
+    meta?: {
+        total_count?: number;
+        page?: number;
+        per_page?: number;
+        action?: string;
+        recordId?: string;
+    };
+}
+declare class SuiteCRMService {
+    private baseUrl;
+    private proxyUrl?;
+    private appId?;
+    private workerSecret?;
+    private useProxy;
+    private isConfigured;
+    private oauth2Config?;
+    private accessToken?;
+    private tokenExpiresAt?;
+    private sessionId?;
+    private csrfToken?;
+    constructor();
+    private validateConfiguration;
+    private getSessionAndCSRFToken;
+    private getAccessToken;
+    private getAuthHeaders;
+    private makeRequest;
+    isServiceConfigured(): boolean;
+    createLead(lead: SuiteCRMLead): Promise<SuiteCRMAPIResponse>;
+    createLeadREST(lead: SuiteCRMLead): Promise<SuiteCRMAPIResponse>;
+    verifyLeadCreation(email: string, firstName: string, lastName: string): Promise<boolean>;
+    getLead(leadId: string): Promise<SuiteCRMAPIResponse>;
+    updateLead(leadId: string, lead: Partial<SuiteCRMLead>): Promise<SuiteCRMAPIResponse>;
+    getLeads(params?: {
+        page?: number;
+        per_page?: number;
+        filter?: string;
+        sort?: string;
+    }): Promise<SuiteCRMAPIResponse>;
+    createContact(contact: SuiteCRMContact): Promise<SuiteCRMAPIResponse>;
+    getContact(contactId: string): Promise<SuiteCRMAPIResponse>;
+    updateContact(contactId: string, contact: Partial<SuiteCRMContact>): Promise<SuiteCRMAPIResponse>;
+    createAccount(account: SuiteCRMAccount): Promise<SuiteCRMAPIResponse>;
+    getAccount(accountId: string): Promise<SuiteCRMAPIResponse>;
+    createOpportunity(opportunity: SuiteCRMOpportunity): Promise<SuiteCRMAPIResponse>;
+    getOpportunity(opportunityId: string): Promise<SuiteCRMAPIResponse>;
+    searchLeads(query: string): Promise<SuiteCRMAPIResponse>;
+    getLeadSources(): Promise<SuiteCRMAPIResponse>;
+    getLeadStatuses(): Promise<SuiteCRMAPIResponse>;
+    graphqlRequest<T = any>(query: string, variables?: Record<string, any>): Promise<T>;
+    testConnection(): Promise<boolean>;
+    createLeadSimple(leadData: SuiteCRMLead): Promise<SuiteCRMAPIResponse>;
+}
+export declare const suitecrmService: SuiteCRMService;
+export {};

package/dist/services/wordpress.d.ts

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

package/dist/static/wpStatic.d.ts

@@ -0,0 +1,189 @@
+export interface WordPressPost {
+    id: number;
+    title?: {
+        rendered: string;
+    };
+    content?: {
+        rendered: string;
+    };
+    excerpt?: {
+        rendered: string;
+    };
+    date?: string;
+    slug?: string;
+}
+export interface WordPressPage {
+    id: number;
+    slug?: string;
+    title?: {
+        rendered: string;
+    };
+    excerpt?: {
+        rendered: string;
+    };
+    content?: {
+        rendered: string;
+    };
+    /** Rendered content with Cloudflare image URLs (string when present in static data) */
+    content_cloudflare?: string;
+    blocks?: any[];
+    parent?: number;
+    menu_order?: number;
+    status?: string;
+    _embedded?: {
+        'wp:featuredmedia'?: Array<{
+            source_url?: string;
+            alt_text?: string;
+        }>;
+    };
+    featured_media_url?: string;
+}
+export interface WordPressMemberRaw {
+    id: number;
+    [key: string]: any;
+}
+type WPStatic = {
+    posts?: WordPressPost[];
+    pages?: WordPressPage[];
+    media?: any[];
+    categories?: any[];
+    tags?: any[];
+    chapter_member?: WordPressMemberRaw[];
+    members?: WordPressMemberRaw[];
+    eventbrite_event?: any[];
+    testimonial?: any[];
+    'member-role'?: any[];
+    memberRoles?: any[];
+    theme_styles?: any;
+    site_settings?: any;
+    header?: {
+        slug: string;
+        area: string;
+        blocks: any[];
+        blocks_count: number;
+    };
+    navigation_menu?: {
+        id: number;
+        name: string;
+        slug: string;
+        items: Array<{
+            id: number;
+            title: string;
+            url: string;
+            type: string;
+            object_id: number;
+            object: string;
+            parent: number;
+            menu_order: number;
+            children?: Array<any>;
+        }>;
+    };
+    menus?: Record<string | number, {
+        id: number;
+        name: string;
+        slug: string;
+        items: Array<{
+            id: number;
+            title: string;
+            url: string;
+            type: string;
+            object_id: number;
+            object: string;
+            parent: number;
+            menu_order: number;
+            children?: Array<any>;
+        }>;
+    }>;
+    footer?: {
+        slug: string;
+        area: string;
+        blocks: any[];
+        blocks_count: number;
+    };
+    config?: any;
+    front_page?: any;
+    frontend_id?: string;
+    frontend_name?: string;
+    generated_at?: string;
+};
+export declare const loadWordPressData: (path?: string) => Promise<void>;
+/**
+ * Get WordPress static data (includes theme_styles)
+ */
+export declare const getWordPressData: () => WPStatic | null;
+export declare const getWordPressPosts: () => WordPressPost[];
+export declare const getWordPressPages: () => WordPressPage[];
+export declare const getWordPressPageBySlug: (slug: string) => WordPressPage | undefined;
+export declare const getWordPressPageById: (id: number) => WordPressPage | undefined;
+export declare const getWordPressMedia: () => any[];
+export declare const getWordPressCategories: () => any[];
+export declare const getWordPressTags: () => any[];
+export declare const getWordPressMembers: () => WordPressMemberRaw[];
+export declare const getWordPressEvents: () => any[];
+export declare const getWordPressTestimonials: () => any[];
+/** Returns a member by slug from the same list the grid uses. Call after loadWordPressData(). */
+export declare const getWordPressMemberBySlug: (slug: string) => WordPressMemberRaw | undefined;
+export declare const getWordPressMemberRoles: () => any[];
+export interface SiteSettings {
+    logo?: {
+        id: number;
+        url: string;
+        cloudflare_url?: string;
+    };
+    site_icon?: {
+        id: number;
+        url: string;
+        cloudflare_url?: string;
+    };
+    site_name?: string;
+    site_description?: string;
+}
+export declare const getSiteSettings: () => SiteSettings | undefined;
+export interface FooterData {
+    slug: string;
+    area: string;
+    blocks: any[];
+    blocks_count: number;
+}
+export interface HeaderData {
+    slug: string;
+    area: string;
+    blocks: any[];
+    blocks_count: number;
+}
+export declare const getHeader: () => HeaderData | undefined;
+export declare const getHeaderMenuId: () => number | undefined;
+/** Parsed header data for app-owned header layout (no WP block tree render). */
+export interface ParsedHeader {
+    hasHeader: boolean;
+    menuId: number | undefined;
+}
+export declare const getParsedHeader: () => ParsedHeader;
+export interface NavigationMenuData {
+    id: number;
+    name: string;
+    slug: string;
+    items: Array<{
+        id: number;
+        title: string;
+        url: string;
+        type: string;
+        object_id: number;
+        object: string;
+        parent: number;
+        menu_order: number;
+        children?: Array<any>;
+    }>;
+}
+export declare const getNavigationMenu: () => NavigationMenuData | undefined;
+/**
+ * Get a menu by ID from static data
+ * @param menuId Menu ID to retrieve
+ * @returns Menu data if found, undefined otherwise
+ */
+export declare const getMenuById: (menuId: number) => NavigationMenuData | undefined;
+export declare const getFooter: () => FooterData | undefined;
+export declare const getLogoUrl: () => string | null;
+export declare const getSiteIconUrl: () => string | null;
+export declare const getSiteName: () => string;
+export {};

package/dist/types/caseStudies.d.ts

@@ -0,0 +1,92 @@
+export interface CaseStudyPublicProfile {
+    title: string;
+    client_name?: string;
+    industry?: string;
+    project_duration?: string;
+    challenge?: string;
+    solution?: string;
+    results?: string;
+    technologies_used?: string[];
+}
+export interface WordPressCaseStudy {
+    id: number;
+    date: string;
+    date_gmt: string;
+    guid: {
+        rendered: string;
+    };
+    modified: string;
+    modified_gmt: string;
+    slug: string;
+    status: string;
+    type: string;
+    link: string;
+    title: {
+        rendered: string;
+    };
+    content: {
+        rendered: string;
+        protected: boolean;
+    };
+    excerpt: {
+        rendered: string;
+        protected: boolean;
+    };
+    featured_media: number;
+    template: string;
+    meta: {
+        _acf_changed: boolean;
+    };
+    "case-study-category": any[];
+    class_list: string[];
+    acf: any[];
+    public_profile: CaseStudyPublicProfile;
+    default_image: string | null;
+    cloudflare_image?: string;
+    _embedded?: {
+        'wp:featuredmedia'?: Array<{
+            source_url: string;
+            alt_text?: string;
+        }>;
+    };
+    _links: {
+        self: Array<{
+            href: string;
+            targetHints?: {
+                allow: string[];
+            };
+        }>;
+        collection: Array<{
+            href: string;
+        }>;
+        about: Array<{
+            href: string;
+        }>;
+        "wp:featuredmedia"?: Array<{
+            embeddable: boolean;
+            href: string;
+        }>;
+        "wp:attachment": Array<{
+            href: string;
+        }>;
+        "wp:term": Array<{
+            taxonomy: string;
+            embeddable: boolean;
+            href: string;
+        }>;
+        curies: Array<{
+            name: string;
+            href: string;
+            templated: boolean;
+        }>;
+    };
+}
+export interface CaseStudyQueryParams {
+    page?: number;
+    per_page?: number;
+    search?: string;
+    slug?: string;
+    orderby?: string;
+    order?: 'asc' | 'desc';
+    category?: string;
+}

package/dist/types/index.d.ts

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