@marvalt/digivalt-core 0.1.0

package/dist/types/members.d.ts

@@ -0,0 +1,85 @@
+/** Known fields; ACF/extra fields are allowed via index signature. */
+export interface MemberPublicProfile {
+    members_firstname: string;
+    members_last_name: string;
+    business_name: string;
+    tagline: string;
+    business_category: string;
+    member_pitch: string;
+    customer_segments: string;
+    website: string;
+    member_bio: string;
+    chapter_role: string;
+    profile_image_url: string | null;
+    [key: string]: unknown;
+}
+export interface WordPressMember {
+    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;
+    };
+    excerpt: {
+        rendered: string;
+        protected: boolean;
+    };
+    featured_media: number;
+    template: string;
+    meta: {
+        _acf_changed: boolean;
+    };
+    "member-role": unknown[];
+    class_list: string[];
+    acf: unknown[];
+    public_profile: MemberPublicProfile;
+    default_image: string | null;
+    _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 MemberQueryParams {
+    page?: number;
+    per_page?: number;
+    search?: string;
+    slug?: string;
+    orderby?: string;
+    order?: 'asc' | 'desc';
+}

package/dist/types/projects.d.ts

@@ -0,0 +1,90 @@
+export interface ProjectPublicProfile {
+    title: string;
+    suburbs?: string;
+    designer?: string;
+    project_type?: string[];
+    project_description?: string;
+    image_two?: string[];
+}
+export interface WordPressProject {
+    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;
+    };
+    "project-type": any[];
+    class_list: string[];
+    acf: any[];
+    public_profile: ProjectPublicProfile;
+    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 ProjectQueryParams {
+    page?: number;
+    per_page?: number;
+    search?: string;
+    slug?: string;
+    orderby?: string;
+    order?: 'asc' | 'desc';
+    project_type?: string;
+}

package/dist/types/wordpress.d.ts

@@ -0,0 +1,132 @@
+export interface WordPressPost {
+    id: number;
+    title: {
+        rendered: string;
+    };
+    content: {
+        rendered: string;
+    };
+    excerpt: {
+        rendered: string;
+    };
+    date: string;
+    slug: string;
+    _embedded?: {
+        'wp:featuredmedia'?: Array<{
+            source_url: string;
+            alt_text?: string;
+        }>;
+        author?: Array<{
+            name: string;
+        }>;
+    };
+}
+export interface WordPressPage {
+    id: number;
+    title: {
+        rendered: string;
+    };
+    content: {
+        rendered: string;
+    };
+    slug: string;
+    date: string;
+}
+export interface WordPressCaseStudy {
+    id: number;
+    title: {
+        rendered: string;
+    };
+    content: {
+        rendered: string;
+    };
+    excerpt: {
+        rendered: string;
+    };
+    slug: string;
+    date: string;
+}
+export interface WordPressProject {
+    id: number;
+    title: {
+        rendered: string;
+    };
+    content: {
+        rendered: string;
+    };
+    excerpt: {
+        rendered: string;
+    };
+    slug: string;
+    date: string;
+}
+export interface WordPressMember {
+    id: number;
+    title: {
+        rendered: string;
+    };
+    content: {
+        rendered: string;
+    };
+    excerpt: {
+        rendered: string;
+    };
+    slug: string;
+    date: string;
+}
+export interface KudoData {
+    value: string;
+    label: string;
+}
+export interface Testimonial extends WordPressPost {
+    type: 'testimonial';
+    acf: {
+        submitter_name: string;
+        submitter_email: string;
+        submitter_company?: string;
+        kudos?: string[];
+        testimonial_for?: number | object;
+    };
+    submitter_avatar?: string;
+    kudos_data?: KudoData[];
+}
+export interface StaticDataConfig {
+    frontend_id: string;
+    frontend_name: string;
+    post_types: {
+        posts: {
+            max_items: number;
+            include_embedded: boolean;
+            orderby: string;
+            order: 'asc' | 'desc';
+            categories?: string[];
+        };
+        pages: {
+            max_items: number;
+            include_embedded: boolean;
+        };
+        case_studies: {
+            max_items: number;
+            include_embedded: boolean;
+        };
+        projects: {
+            max_items: number;
+            include_embedded: boolean;
+        };
+        members: {
+            max_items: number;
+            include_embedded: boolean;
+        };
+    };
+}
+export interface StaticDataStore {
+    generated_at: string;
+    frontend_id: string;
+    frontend_name: string;
+    config: StaticDataConfig;
+    posts: WordPressPost[];
+    pages: WordPressPage[];
+    case_studies: WordPressCaseStudy[];
+    projects: WordPressProject[];
+    members: WordPressMember[];
+}

package/dist/utils/cfImages.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cloudflare Images URL helpers
+ *
+ * Many endpoints (e.g., cloudflare_image_standardized) return the base URL
+ * without a variant/transform segment. Append a variant at render-time to
+ * control size and improve LCP/SEO.
+ */
+export interface CloudflareVariantOptions {
+    width: number;
+    height?: number;
+}
+export declare const isCloudflareImageUrl: (url: string | undefined | null) => boolean;
+/**
+ * Append Cloudflare Images variant to the base URL if not already present.
+ * Example output: https://imagedelivery.net/<account>/<id>/w=1024,h=600
+ */
+export declare const getCloudflareVariantUrl: (url: string, options: CloudflareVariantOptions) => string;
+/**
+ * Build a simple srcset for responsive images from a base Cloudflare URL.
+ */
+export declare const buildCloudflareSrcSet: (url: string, widths: number[], fixedHeight?: number) => string | undefined;

package/dist/utils/eventStaticData.d.ts

@@ -0,0 +1,11 @@
+export declare function createEventStaticDataProvider(): {
+    events: any[];
+    getEventById(id: string | number): any | null;
+    filterEvents(filters: {
+        category?: string;
+        tax?: string;
+        limit?: number;
+        orderby?: string;
+        order?: string;
+    }): any[];
+};

package/dist/utils/extractDescriptionFromContent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Extracts a meta description from page content HTML when excerpt is not available.
+ * Uses the first heading and first paragraph (after skipping any form before the first heading),
+ * cut to SEO length (default 160 characters).
+ */
+/**
+ * Extract a description from rendered page content:
+ * - Removes form blocks so content before the first heading that is inside a form is skipped
+ * - Finds the first heading (h1–h6) and first paragraph in document order
+ * - Combines them and truncates to maxLength (SEO typical 155–160)
+ */
+export declare function extractDescriptionFromContent(html: string, maxLength?: number): string;

package/dist/utils/index.d.ts

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

package/dist/utils/mauticTrackingUtils.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Mautic Tracking Utilities
+ * Helper functions for Mautic tracking and debugging
+ */
+declare global {
+    interface Window {
+        mt?: any;
+        MauticTrackingObject?: string;
+    }
+}
+/**
+ * Check if Mautic tracking is available
+ */
+export declare const isMauticTrackingAvailable: () => boolean;
+/**
+ * Check if Mautic tracking script is loaded
+ */
+export declare const isMauticScriptLoaded: () => boolean;
+/**
+ * Get Mautic tracking status
+ */
+export declare const getMauticTrackingStatus: () => {
+    scriptLoaded: boolean;
+    trackingObject: boolean;
+    trackingObjectType: "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function";
+};
+/**
+ * Send a pageview to Mautic
+ */
+export declare const sendMauticPageview: (page?: string, additionalData?: Record<string, any>) => boolean;
+/**
+ * Track a custom event in Mautic
+ */
+export declare const trackMauticEvent: (eventName: string, eventData?: Record<string, any>, email?: string) => boolean;
+/**
+ * Identify a user in Mautic
+ */
+export declare const identifyMauticUser: (email: string, userData?: Record<string, any>) => boolean;
+/**
+ * Track form submission in Mautic
+ */
+export declare const trackMauticFormSubmission: (formId: string | number, formData?: Record<string, any>, email?: string) => boolean;
+/**
+ * Track button click in Mautic
+ */
+export declare const trackMauticButtonClick: (buttonText: string, buttonLocation: string, email?: string) => boolean;
+/**
+ * Track link click in Mautic
+ */
+export declare const trackMauticLinkClick: (linkUrl: string, linkText?: string, email?: string) => boolean;
+/**
+ * Track scroll depth in Mautic
+ */
+export declare const trackMauticScrollDepth: (depth: number, email?: string) => boolean;
+/**
+ * Track time on page in Mautic
+ */
+export declare const trackMauticTimeOnPage: (seconds: number, email?: string) => boolean;
+/**
+ * Debug Mautic tracking configuration
+ */
+export declare const debugMauticTracking: () => {
+    scriptLoaded: boolean;
+    trackingObject: boolean;
+    trackingObjectType: "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function";
+};
+/**
+ * Wait for Mautic tracking to be available
+ */
+export declare const waitForMauticTracking: (timeout?: number) => Promise<boolean>;
+/**
+ * Initialize Mautic tracking with custom configuration
+ */
+export declare const initializeMauticTracking: (config?: {
+    debug?: boolean;
+    waitForLoad?: boolean;
+    onReady?: () => void;
+}) => void;

package/dist/utils/memberImageUtils.d.ts

@@ -0,0 +1,4 @@
+import { WordPressMember } from '../types/members';
+export declare const getMemberImageUrl: (member: WordPressMember) => string | undefined;
+export declare const getMemberInitials: (firstName: string, lastName: string) => string;
+export declare const getMemberDisplayName: (member: WordPressMember) => string;

package/dist/utils/memberStaticData.d.ts

@@ -0,0 +1,11 @@
+export declare function createMemberStaticDataProvider(): {
+    members: any[];
+    getMemberById(id: string | number): any | null;
+    filterMembers(filters: {
+        category?: string;
+        role?: string;
+        limit?: number;
+        orderby?: string;
+        order?: string;
+    }): any[];
+};

package/dist/utils/normalizeMemberForProfile.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Normalizes a raw WordPress member (member_meta or public_profile) into the shape
+ * expected by MemberProfile and memberImageUtils (WordPressMember with public_profile).
+ */
+import type { WordPressMember } from '../types/members';
+/**
+ * Normalize raw member from wordpress-data.json to WordPressMember shape for profile page.
+ * Uses public_profile when present; otherwise builds from member_meta. Preserves ACF/extra keys.
+ */
+export declare function normalizeMemberForProfile(raw: Record<string, unknown> | null | undefined): WordPressMember | null;

package/dist/utils/passwordUtils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Password utility functions for handling special characters
+ */
+/**
+ * Safely encode a password for API requests
+ * Handles special characters like $, @, #, %, etc.
+ */
+export declare function encodePassword(password: string): string;
+/**
+ * Safely encode a password for URL-encoded requests
+ * Used when sending as form data
+ */
+export declare function encodePasswordForUrl(password: string): string;
+/**
+ * Validate password for common issues
+ */
+export declare function validatePassword(password: string): {
+    isValid: boolean;
+    issues: string[];
+};
+/**
+ * Get password encoding recommendations
+ */
+export declare function getPasswordRecommendations(password: string): string[];

package/dist/utils/placeholderReplacer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Placeholder replacement utility for dynamic content
+ *
+ * Replaces placeholders like {member_fullname} with actual data from member objects
+ */
+export interface MemberData {
+    id: number;
+    title?: {
+        rendered: string;
+    };
+    member_meta?: {
+        members_firstname?: string;
+        members_last_name?: string;
+        members_email?: string;
+        business_name?: string;
+        tagline?: string;
+        member_role?: string;
+        website?: string;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+/**
+ * Get member full name from member data
+ */
+export declare function getMemberFullName(member: MemberData | null): string;
+/**
+ * Replace placeholders in text with member data
+ */
+export declare function replacePlaceholders(text: string, member: MemberData | null, queryParams?: Record<string, string>): string;
+/**
+ * Process blocks recursively to replace placeholders
+ */
+export declare function processBlocksForPlaceholders(blocks: any[], member: MemberData | null, queryParams?: Record<string, string>): any[];

package/dist/utils/testimonialStaticData.d.ts

@@ -0,0 +1,12 @@
+export declare function createTestimonialStaticDataProvider(): {
+    testimonials: any[];
+    getTestimonialById(id: string | number): any | null;
+    filterTestimonials(filters: {
+        category?: string;
+        tax?: string;
+        limit?: number;
+        orderby?: string;
+        order?: string;
+        forPostId?: string;
+    }): any[];
+};

package/dist/utils/wpRegistry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Create app-specific WordPress registry with enhanced component mappings
+ *
+ * This registry:
+ * - Maps Gutenberg blocks to React components (atomic design)
+ * - Handles shortcodes for integrations (Gravity Forms, Mautic, etc.)
+ * - Extracts block data and passes as props to components
+ * - Provides color mapping from WordPress theme colors to app CSS classes
+ * - Configures spacing system for consistent element spacing
+ *
+ * @param themePalette - Optional WordPress theme color palette to use actual theme colors
+ */
+export declare function createAppRegistry(themePalette?: Record<string, string>): import("@marvalt/wparser").EnhancedRegistry;

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@marvalt/digivalt-core",
+  "version": "0.1.0",
+  "description": "Core glue logic and shared context for DigiVAlt frontend applications",
+  "license": "GPL-3.0-or-later",
+  "main": "dist/index.cjs",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "lint": "eslint src --ext .ts,.tsx",
+    "type-check": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.5",
+    "@types/node": "^22.5.5",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "rimraf": "^5.0.5",
+    "rollup": "^4.6.1",
+    "rollup-plugin-dts": "^6.1.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.5.3"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
+  "dependencies": {
+    "@marvalt/dstyler": "^0.1.51",
+    "@marvalt/madapter": "^2.3.7",
+    "@marvalt/sadapter": "^0.1.5",
+    "@marvalt/shcoder": "^0.1.35",
+    "@marvalt/tadapter": "^1.0.12",
+    "@marvalt/wadapter": "^2.3.56",
+    "@marvalt/wparser": "^0.1.79",
+    "@radix-ui/react-toast": "^1.2.15",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "dotenv": "^17.3.1",
+    "lucide-react": "^0.577.0",
+    "tailwind-merge": "^3.5.0"
+  }
+}