shared-features 0.0.1

package/dist/types/campaigns.d.ts

@@ -0,0 +1,378 @@
+import { Timestamp } from 'firebase/firestore';
+/**
+ * Product type classification
+ */
+export type ProductType = 'extension' | 'android' | 'ios' | 'web';
+/**
+ * Product information for advertising
+ */
+export interface Product {
+    /** Unique product identifier */
+    id: string;
+    /** Product display name */
+    name: string;
+    /** Short tagline (marketing slogan) */
+    tagline: string;
+    /** Longer description of the product */
+    description: string;
+    /** Product type classification */
+    type: ProductType;
+    /** URL to the product (store link or website) */
+    url: string;
+    /** Brand/theme color (hex) */
+    color: string;
+    /** Key features list (3-4 items) */
+    features: string[];
+    /** Inline SVG icon (64px) */
+    icon64?: string;
+    /** Inline SVG icon (128px) */
+    icon128?: string;
+    /** Chrome Web Store URL */
+    chromeStoreUrl?: string;
+    /** Google Play Store URL */
+    playStoreUrl?: string;
+    /** Apple App Store URL */
+    appStoreUrl?: string;
+    /** Web app URL */
+    webUrl?: string;
+    /** Whether the product is active */
+    enabled: boolean;
+    /** When the product was created */
+    createdAt: Timestamp;
+    /** When the product was last updated */
+    updatedAt: Timestamp;
+}
+/**
+ * Campaign status values
+ */
+export type CampaignStatus = 'active' | 'paused' | 'scheduled' | 'ended';
+/**
+ * Target platforms for campaigns
+ */
+export type TargetPlatform = 'web' | 'android' | 'ios' | 'extension';
+/**
+ * Target audience for campaigns
+ */
+export type TargetAudience = 'all' | 'authenticated' | 'anonymous';
+/**
+ * Placement options for ads
+ */
+export type AdPlacement = 'popup_slider' | 'options_panel' | 'onetime_modal' | 'update_modal' | 'notification' | 'footer_slider' | 'sidebar_panel' | 'home_banner';
+/**
+ * Small panel variant styles
+ */
+export type SmallPanelVariant = 'small_panel_1' | 'small_panel_2' | 'small_panel_3' | 'small_panel_4' | 'small_panel_5';
+/**
+ * Large slider variant styles
+ */
+export type LargePanelVariant = 'large_slider_1' | 'large_slider_2' | 'large_slider_3' | 'large_slider_4' | 'large_slider_5';
+/**
+ * All ad variant types
+ */
+export type AdVariant = SmallPanelVariant | LargePanelVariant;
+/**
+ * Advertising campaign document
+ * Stored in: zaions_campaigns/{campaignId}
+ */
+export interface Campaign {
+    /** Campaign document ID */
+    id: string;
+    /** Reference to product being promoted */
+    productId: string;
+    /** Campaign name (admin reference) */
+    name: string;
+    /** Current campaign status */
+    status: CampaignStatus;
+    /** Platforms where this campaign should show */
+    targetPlatforms: TargetPlatform[];
+    /** Audience type to target */
+    targetAudience: TargetAudience;
+    /** Specific projects to target (empty = all projects) */
+    targetProjects: string[];
+    /** Don't show to users already using this product */
+    excludeProductUsers: boolean;
+    /** Where the ad can be displayed */
+    placements: AdPlacement[];
+    /** Priority (1-100, higher = more important) */
+    priority: number;
+    /** Days between impressions for same user (default: 20) */
+    frequencyDays: number;
+    /** Maximum total impressions (null = unlimited) */
+    maxImpressions: number | null;
+    /** Campaign start date */
+    startDate: Timestamp;
+    /** Campaign end date (null = no end) */
+    endDate: Timestamp | null;
+    /** UI variant to use */
+    variant: AdVariant;
+    /** Custom title (overrides product name) */
+    customTitle?: string;
+    /** Custom tagline (overrides product tagline) */
+    customTagline?: string;
+    /** Custom CTA button text */
+    customCta?: string;
+    /** Custom CTA button URL (overrides product URL) */
+    customCtaUrl?: string;
+    /** Custom description (overrides product description) */
+    customDescription?: string;
+    /** Custom product color for custom products/projects */
+    customProductColor?: string;
+    /** Custom icon SVG string (for custom products) */
+    customIcon?: string;
+    /** Custom features list (for custom products) */
+    customFeatures?: string[];
+    /** Total number of impressions */
+    totalImpressions: number;
+    /** Total number of clicks */
+    totalClicks: number;
+    /** Total number of closes/dismissals */
+    totalCloses: number;
+    /** When campaign was created */
+    createdAt: Timestamp;
+    /** When campaign was last updated */
+    updatedAt: Timestamp;
+    /** Admin user ID who created */
+    createdBy: string;
+    /** Admin user ID who last updated */
+    updatedBy?: string;
+}
+/**
+ * Input for creating a new campaign
+ */
+export interface CreateCampaignInput {
+    productId: string;
+    name: string;
+    status: CampaignStatus;
+    targetPlatforms: TargetPlatform[];
+    targetAudience: TargetAudience;
+    targetProjects: string[];
+    excludeProductUsers: boolean;
+    placements: AdPlacement[];
+    priority: number;
+    frequencyDays: number;
+    maxImpressions: number | null;
+    startDate: Date;
+    endDate: Date | null;
+    variant: AdVariant;
+    customTitle?: string;
+    customTagline?: string;
+    customCta?: string;
+    customCtaUrl?: string;
+    customDescription?: string;
+    customProductColor?: string;
+    customIcon?: string;
+    customFeatures?: string[];
+}
+/**
+ * Input for updating a campaign
+ */
+export interface UpdateCampaignInput extends Partial<CreateCampaignInput> {
+    id: string;
+}
+/**
+ * Types of ad interactions
+ */
+export type AdAction = 'impression' | 'click' | 'close' | 'notification_click';
+/**
+ * Ad impression/interaction event
+ * Stored in: zaions_impressions/{impressionId}
+ */
+export interface Impression {
+    /** Impression document ID */
+    id: string;
+    /** Campaign that generated this impression */
+    campaignId: string;
+    /** Product being advertised */
+    productId: string;
+    /** Project where impression occurred */
+    projectId: string;
+    /** User ID (null for anonymous) */
+    userId: string | null;
+    /** Device/browser fingerprint */
+    deviceId: string;
+    /** Platform where impression occurred */
+    platform: TargetPlatform;
+    /** Placement where ad was shown */
+    placement: AdPlacement;
+    /** Type of interaction */
+    action: AdAction;
+    /** When the interaction occurred */
+    timestamp: Timestamp;
+    /** UI variant that was displayed */
+    variant: AdVariant;
+    /** Session identifier */
+    sessionId?: string;
+}
+/**
+ * Input for recording an impression
+ */
+export interface RecordImpressionInput {
+    campaignId: string;
+    productId: string;
+    placement: AdPlacement;
+    action: AdAction;
+    variant: AdVariant;
+    sessionId?: string;
+}
+/**
+ * Local ad history entry (for frequency capping)
+ */
+export interface AdHistoryEntry {
+    /** Campaign ID */
+    campaignId: string;
+    /** Product ID */
+    productId: string;
+    /** Last seen timestamp (Unix ms) */
+    lastSeenAt: number;
+    /** Impression count */
+    impressionCount: number;
+    /** Whether clicked */
+    clicked: boolean;
+    /** Whether closed */
+    closed: boolean;
+    /** Next eligible timestamp (Unix ms) */
+    nextEligibleAt: number;
+}
+/**
+ * Options for fetching campaigns
+ */
+export interface FetchCampaignsOptions {
+    /** Filter by placement */
+    placement?: AdPlacement;
+    /** Filter by status */
+    status?: CampaignStatus;
+    /** Filter by product */
+    productId?: string;
+    /** Maximum results */
+    limit?: number;
+}
+/**
+ * Campaign with resolved product data
+ */
+export interface CampaignWithProduct extends Campaign {
+    /** Resolved product information */
+    product: Product;
+}
+/**
+ * Campaign analytics summary
+ */
+export interface CampaignAnalytics {
+    campaignId: string;
+    campaignName: string;
+    productId: string;
+    productName: string;
+    /** Total impressions */
+    impressions: number;
+    /** Total clicks */
+    clicks: number;
+    /** Total closes */
+    closes: number;
+    /** Click-through rate (clicks/impressions) */
+    ctr: number;
+    /** Close rate (closes/impressions) */
+    closeRate: number;
+    /** Breakdown by platform */
+    byPlatform: Record<TargetPlatform, {
+        impressions: number;
+        clicks: number;
+    }>;
+    /** Breakdown by placement */
+    byPlacement: Record<AdPlacement, {
+        impressions: number;
+        clicks: number;
+    }>;
+    /** Breakdown by project */
+    byProject: Record<string, {
+        impressions: number;
+        clicks: number;
+    }>;
+    /** Daily breakdown */
+    byDate: Array<{
+        date: string;
+        impressions: number;
+        clicks: number;
+        closes: number;
+    }>;
+}
+/**
+ * Props for small panel variants
+ */
+export interface SmallPanelProps {
+    campaign: Campaign;
+    product: Product;
+    variant: SmallPanelVariant;
+    onClose: () => void;
+    onClick: () => void;
+}
+/**
+ * Props for large panel variants
+ */
+export interface LargePanelProps {
+    campaign: Campaign;
+    product: Product;
+    variant: LargePanelVariant;
+    onClose: () => void;
+    onClick: () => void;
+}
+/**
+ * Props for ad slider component
+ */
+export interface AdSliderProps {
+    placement: AdPlacement;
+    variant?: SmallPanelVariant;
+    autoplay?: boolean;
+    interval?: number;
+    maxCampaigns?: number;
+    className?: string;
+}
+/**
+ * Props for ad modal component
+ */
+export interface AdModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    campaign: CampaignWithProduct | null;
+    variant?: LargePanelVariant;
+}
+/**
+ * Props for ad panel component
+ */
+export interface AdPanelProps {
+    placement: AdPlacement;
+    variant?: SmallPanelVariant;
+    className?: string;
+}
+/**
+ * Default frequency cap in days
+ */
+export declare const DEFAULT_FREQUENCY_DAYS = 20;
+/**
+ * Default campaign priority
+ */
+export declare const DEFAULT_CAMPAIGN_PRIORITY = 50;
+/**
+ * Variant display names
+ */
+export declare const VARIANT_NAMES: Record<AdVariant, string>;
+/**
+ * Placement display names
+ */
+export declare const PLACEMENT_NAMES: Record<AdPlacement, string>;
+/**
+ * Platform display names
+ */
+export declare const PLATFORM_NAMES: Record<TargetPlatform, string>;
+/**
+ * Collection names for shared features
+ */
+export declare const COLLECTIONS: {
+    readonly CAMPAIGNS: "zaions_campaigns";
+    readonly PRODUCTS: "zaions_products";
+    readonly IMPRESSIONS: "zaions_impressions";
+    readonly CONTACTS: "zaions_contacts";
+    readonly FEATURE_REQUESTS: "zaions_feature_requests";
+    readonly PAYMENT_OPTIONS: "zaions_payment_options";
+    readonly SOCIAL_LINKS: "zaions_social_links";
+    readonly DEVELOPER_INFO: "zaions_developer_info";
+};
+//# sourceMappingURL=campaigns.d.ts.map

package/dist/types/campaigns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaigns.d.ts","sourceRoot":"","sources":["../../src/types/campaigns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAM/C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,wCAAwC;IACxC,SAAS,EAAE,SAAS,CAAC;CACtB;AAMD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,WAAW,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,eAAe,GAAG,WAAW,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,eAAe,GACf,eAAe,GACf,cAAc,GACd,cAAc,GACd,eAAe,GACf,eAAe,GACf,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,MAAM,EAAE,cAAc,CAAC;IAGvB,gDAAgD;IAChD,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,8BAA8B;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,yDAAyD;IACzD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,mBAAmB,EAAE,OAAO,CAAC;IAG7B,oCAAoC;IACpC,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,0BAA0B;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,wCAAwC;IACxC,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAG1B,wBAAwB;IACxB,OAAO,EAAE,SAAS,CAAC;IACnB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAG1B,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IAGpB,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,qCAAqC;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,OAAO,CAAC,mBAAmB,CAAC;IACvE,EAAE,EAAE,MAAM,CAAC;CACZ;AAMD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,oBAAoB,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,cAAc,CAAC;IACzB,mCAAmC;IACnC,SAAS,EAAE,WAAW,CAAC;IAEvB,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,SAAS,CAAC;IAErB,oCAAoC;IACpC,OAAO,EAAE,SAAS,CAAC;IACnB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,WAAW,CAAC;IACvB,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,uBAAuB;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,sBAAsB;IACtB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,WAAW,CAAC;IACvB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,WAAW,CAAC;IACvB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAWnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CASvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKzD,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC"}

package/dist/types/index.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DEFAULT_FREQUENCY_DAYS = 20;
+const DEFAULT_CAMPAIGN_PRIORITY = 50;
+const VARIANT_NAMES = {
+  small_panel_1: "Minimal",
+  small_panel_2: "Tagline",
+  small_panel_3: "Features",
+  small_panel_4: "Gradient",
+  small_panel_5: "Card",
+  large_slider_1: "Hero",
+  large_slider_2: "Feature Grid",
+  large_slider_3: "Testimonial",
+  large_slider_4: "Comparison",
+  large_slider_5: "Video Placeholder"
+};
+const PLACEMENT_NAMES = {
+  popup_slider: "Extension Popup Slider",
+  options_panel: "Extension Options Panel",
+  onetime_modal: "One-Time Welcome Modal",
+  update_modal: "Update Announcement Modal",
+  notification: "Browser Notification",
+  footer_slider: "Web App Footer Slider",
+  sidebar_panel: "Web App Sidebar Panel",
+  home_banner: "Home Page Banner"
+};
+const PLATFORM_NAMES = {
+  web: "Web App",
+  android: "Android App",
+  ios: "iOS App",
+  extension: "Browser Extension"
+};
+const COLLECTIONS = {
+  CAMPAIGNS: "zaions_campaigns",
+  PRODUCTS: "zaions_products",
+  IMPRESSIONS: "zaions_impressions",
+  CONTACTS: "zaions_contacts",
+  FEATURE_REQUESTS: "zaions_feature_requests",
+  PAYMENT_OPTIONS: "zaions_payment_options",
+  SOCIAL_LINKS: "zaions_social_links",
+  DEVELOPER_INFO: "zaions_developer_info"
+};
+exports.COLLECTIONS = COLLECTIONS;
+exports.DEFAULT_CAMPAIGN_PRIORITY = DEFAULT_CAMPAIGN_PRIORITY;
+exports.DEFAULT_FREQUENCY_DAYS = DEFAULT_FREQUENCY_DAYS;
+exports.PLACEMENT_NAMES = PLACEMENT_NAMES;
+exports.PLATFORM_NAMES = PLATFORM_NAMES;
+exports.VARIANT_NAMES = VARIANT_NAMES;
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/types/campaigns.ts"],"sourcesContent":["/**\n * Campaign/Advertising System Type Definitions\n *\n * Type definitions for the centralized advertising system including\n * Firestore document schemas, service interfaces, and UI types.\n *\n * Based on ZTools advertising system, adapted for cross-project use.\n *\n * @author Ahsan Mahmood <aoneahsan@gmail.com>\n */\n\nimport { Timestamp } from 'firebase/firestore';\n\n// ============================================================================\n// PRODUCT TYPES\n// ============================================================================\n\n/**\n * Product type classification\n */\nexport type ProductType = 'extension' | 'android' | 'ios' | 'web';\n\n/**\n * Product information for advertising\n */\nexport interface Product {\n  /** Unique product identifier */\n  id: string;\n  /** Product display name */\n  name: string;\n  /** Short tagline (marketing slogan) */\n  tagline: string;\n  /** Longer description of the product */\n  description: string;\n  /** Product type classification */\n  type: ProductType;\n  /** URL to the product (store link or website) */\n  url: string;\n  /** Brand/theme color (hex) */\n  color: string;\n  /** Key features list (3-4 items) */\n  features: string[];\n  /** Inline SVG icon (64px) */\n  icon64?: string;\n  /** Inline SVG icon (128px) */\n  icon128?: string;\n  /** Chrome Web Store URL */\n  chromeStoreUrl?: string;\n  /** Google Play Store URL */\n  playStoreUrl?: string;\n  /** Apple App Store URL */\n  appStoreUrl?: string;\n  /** Web app URL */\n  webUrl?: string;\n  /** Whether the product is active */\n  enabled: boolean;\n  /** When the product was created */\n  createdAt: Timestamp;\n  /** When the product was last updated */\n  updatedAt: Timestamp;\n}\n\n// ============================================================================\n// CAMPAIGN TYPES\n// ============================================================================\n\n/**\n * Campaign status values\n */\nexport type CampaignStatus = 'active' | 'paused' | 'scheduled' | 'ended';\n\n/**\n * Target platforms for campaigns\n */\nexport type TargetPlatform = 'web' | 'android' | 'ios' | 'extension';\n\n/**\n * Target audience for campaigns\n */\nexport type TargetAudience = 'all' | 'authenticated' | 'anonymous';\n\n/**\n * Placement options for ads\n */\nexport type AdPlacement =\n  | 'popup_slider'\n  | 'options_panel'\n  | 'onetime_modal'\n  | 'update_modal'\n  | 'notification'\n  | 'footer_slider'\n  | 'sidebar_panel'\n  | 'home_banner';\n\n/**\n * Small panel variant styles\n */\nexport type SmallPanelVariant =\n  | 'small_panel_1' // Minimal\n  | 'small_panel_2' // Tagline\n  | 'small_panel_3' // Features\n  | 'small_panel_4' // Gradient\n  | 'small_panel_5'; // Card\n\n/**\n * Large slider variant styles\n */\nexport type LargePanelVariant =\n  | 'large_slider_1' // Hero\n  | 'large_slider_2' // Feature Grid\n  | 'large_slider_3' // Testimonial\n  | 'large_slider_4' // Comparison\n  | 'large_slider_5'; // Video Placeholder\n\n/**\n * All ad variant types\n */\nexport type AdVariant = SmallPanelVariant | LargePanelVariant;\n\n/**\n * Advertising campaign document\n * Stored in: zaions_campaigns/{campaignId}\n */\nexport interface Campaign {\n  /** Campaign document ID */\n  id: string;\n  /** Reference to product being promoted */\n  productId: string;\n  /** Campaign name (admin reference) */\n  name: string;\n  /** Current campaign status */\n  status: CampaignStatus;\n\n  // === TARGETING ===\n  /** Platforms where this campaign should show */\n  targetPlatforms: TargetPlatform[];\n  /** Audience type to target */\n  targetAudience: TargetAudience;\n  /** Specific projects to target (empty = all projects) */\n  targetProjects: string[];\n  /** Don't show to users already using this product */\n  excludeProductUsers: boolean;\n\n  // === DISPLAY RULES ===\n  /** Where the ad can be displayed */\n  placements: AdPlacement[];\n  /** Priority (1-100, higher = more important) */\n  priority: number;\n  /** Days between impressions for same user (default: 20) */\n  frequencyDays: number;\n  /** Maximum total impressions (null = unlimited) */\n  maxImpressions: number | null;\n\n  // === TIMELINE ===\n  /** Campaign start date */\n  startDate: Timestamp;\n  /** Campaign end date (null = no end) */\n  endDate: Timestamp | null;\n\n  // === CREATIVE ===\n  /** UI variant to use */\n  variant: AdVariant;\n  /** Custom title (overrides product name) */\n  customTitle?: string;\n  /** Custom tagline (overrides product tagline) */\n  customTagline?: string;\n  /** Custom CTA button text */\n  customCta?: string;\n  /** Custom CTA button URL (overrides product URL) */\n  customCtaUrl?: string;\n  /** Custom description (overrides product description) */\n  customDescription?: string;\n  /** Custom product color for custom products/projects */\n  customProductColor?: string;\n  /** Custom icon SVG string (for custom products) */\n  customIcon?: string;\n  /** Custom features list (for custom products) */\n  customFeatures?: string[];\n\n  // === METRICS (Denormalized) ===\n  /** Total number of impressions */\n  totalImpressions: number;\n  /** Total number of clicks */\n  totalClicks: number;\n  /** Total number of closes/dismissals */\n  totalCloses: number;\n\n  // === METADATA ===\n  /** When campaign was created */\n  createdAt: Timestamp;\n  /** When campaign was last updated */\n  updatedAt: Timestamp;\n  /** Admin user ID who created */\n  createdBy: string;\n  /** Admin user ID who last updated */\n  updatedBy?: string;\n}\n\n/**\n * Input for creating a new campaign\n */\nexport interface CreateCampaignInput {\n  productId: string;\n  name: string;\n  status: CampaignStatus;\n  targetPlatforms: TargetPlatform[];\n  targetAudience: TargetAudience;\n  targetProjects: string[];\n  excludeProductUsers: boolean;\n  placements: AdPlacement[];\n  priority: number;\n  frequencyDays: number;\n  maxImpressions: number | null;\n  startDate: Date;\n  endDate: Date | null;\n  variant: AdVariant;\n  customTitle?: string;\n  customTagline?: string;\n  customCta?: string;\n  customCtaUrl?: string;\n  customDescription?: string;\n  customProductColor?: string;\n  customIcon?: string;\n  customFeatures?: string[];\n}\n\n/**\n * Input for updating a campaign\n */\nexport interface UpdateCampaignInput extends Partial<CreateCampaignInput> {\n  id: string;\n}\n\n// ============================================================================\n// IMPRESSION TYPES\n// ============================================================================\n\n/**\n * Types of ad interactions\n */\nexport type AdAction = 'impression' | 'click' | 'close' | 'notification_click';\n\n/**\n * Ad impression/interaction event\n * Stored in: zaions_impressions/{impressionId}\n */\nexport interface Impression {\n  /** Impression document ID */\n  id: string;\n  /** Campaign that generated this impression */\n  campaignId: string;\n  /** Product being advertised */\n  productId: string;\n  /** Project where impression occurred */\n  projectId: string;\n\n  /** User ID (null for anonymous) */\n  userId: string | null;\n  /** Device/browser fingerprint */\n  deviceId: string;\n  /** Platform where impression occurred */\n  platform: TargetPlatform;\n  /** Placement where ad was shown */\n  placement: AdPlacement;\n\n  /** Type of interaction */\n  action: AdAction;\n  /** When the interaction occurred */\n  timestamp: Timestamp;\n\n  /** UI variant that was displayed */\n  variant: AdVariant;\n  /** Session identifier */\n  sessionId?: string;\n}\n\n/**\n * Input for recording an impression\n */\nexport interface RecordImpressionInput {\n  campaignId: string;\n  productId: string;\n  placement: AdPlacement;\n  action: AdAction;\n  variant: AdVariant;\n  sessionId?: string;\n}\n\n// ============================================================================\n// AD HISTORY TYPES\n// ============================================================================\n\n/**\n * Local ad history entry (for frequency capping)\n */\nexport interface AdHistoryEntry {\n  /** Campaign ID */\n  campaignId: string;\n  /** Product ID */\n  productId: string;\n  /** Last seen timestamp (Unix ms) */\n  lastSeenAt: number;\n  /** Impression count */\n  impressionCount: number;\n  /** Whether clicked */\n  clicked: boolean;\n  /** Whether closed */\n  closed: boolean;\n  /** Next eligible timestamp (Unix ms) */\n  nextEligibleAt: number;\n}\n\n// ============================================================================\n// SERVICE TYPES\n// ============================================================================\n\n/**\n * Options for fetching campaigns\n */\nexport interface FetchCampaignsOptions {\n  /** Filter by placement */\n  placement?: AdPlacement;\n  /** Filter by status */\n  status?: CampaignStatus;\n  /** Filter by product */\n  productId?: string;\n  /** Maximum results */\n  limit?: number;\n}\n\n/**\n * Campaign with resolved product data\n */\nexport interface CampaignWithProduct extends Campaign {\n  /** Resolved product information */\n  product: Product;\n}\n\n// ============================================================================\n// ANALYTICS TYPES\n// ============================================================================\n\n/**\n * Campaign analytics summary\n */\nexport interface CampaignAnalytics {\n  campaignId: string;\n  campaignName: string;\n  productId: string;\n  productName: string;\n\n  /** Total impressions */\n  impressions: number;\n  /** Total clicks */\n  clicks: number;\n  /** Total closes */\n  closes: number;\n  /** Click-through rate (clicks/impressions) */\n  ctr: number;\n  /** Close rate (closes/impressions) */\n  closeRate: number;\n\n  /** Breakdown by platform */\n  byPlatform: Record<TargetPlatform, { impressions: number; clicks: number }>;\n  /** Breakdown by placement */\n  byPlacement: Record<AdPlacement, { impressions: number; clicks: number }>;\n  /** Breakdown by project */\n  byProject: Record<string, { impressions: number; clicks: number }>;\n  /** Daily breakdown */\n  byDate: Array<{\n    date: string;\n    impressions: number;\n    clicks: number;\n    closes: number;\n  }>;\n}\n\n// ============================================================================\n// COMPONENT PROPS\n// ============================================================================\n\n/**\n * Props for small panel variants\n */\nexport interface SmallPanelProps {\n  campaign: Campaign;\n  product: Product;\n  variant: SmallPanelVariant;\n  onClose: () => void;\n  onClick: () => void;\n}\n\n/**\n * Props for large panel variants\n */\nexport interface LargePanelProps {\n  campaign: Campaign;\n  product: Product;\n  variant: LargePanelVariant;\n  onClose: () => void;\n  onClick: () => void;\n}\n\n/**\n * Props for ad slider component\n */\nexport interface AdSliderProps {\n  placement: AdPlacement;\n  variant?: SmallPanelVariant;\n  autoplay?: boolean;\n  interval?: number;\n  maxCampaigns?: number;\n  className?: string;\n}\n\n/**\n * Props for ad modal component\n */\nexport interface AdModalProps {\n  open: boolean;\n  onOpenChange: (open: boolean) => void;\n  campaign: CampaignWithProduct | null;\n  variant?: LargePanelVariant;\n}\n\n/**\n * Props for ad panel component\n */\nexport interface AdPanelProps {\n  placement: AdPlacement;\n  variant?: SmallPanelVariant;\n  className?: string;\n}\n\n// ============================================================================\n// DEFAULT VALUES\n// ============================================================================\n\n/**\n * Default frequency cap in days\n */\nexport const DEFAULT_FREQUENCY_DAYS = 20;\n\n/**\n * Default campaign priority\n */\nexport const DEFAULT_CAMPAIGN_PRIORITY = 50;\n\n/**\n * Variant display names\n */\nexport const VARIANT_NAMES: Record<AdVariant, string> = {\n  small_panel_1: 'Minimal',\n  small_panel_2: 'Tagline',\n  small_panel_3: 'Features',\n  small_panel_4: 'Gradient',\n  small_panel_5: 'Card',\n  large_slider_1: 'Hero',\n  large_slider_2: 'Feature Grid',\n  large_slider_3: 'Testimonial',\n  large_slider_4: 'Comparison',\n  large_slider_5: 'Video Placeholder',\n};\n\n/**\n * Placement display names\n */\nexport const PLACEMENT_NAMES: Record<AdPlacement, string> = {\n  popup_slider: 'Extension Popup Slider',\n  options_panel: 'Extension Options Panel',\n  onetime_modal: 'One-Time Welcome Modal',\n  update_modal: 'Update Announcement Modal',\n  notification: 'Browser Notification',\n  footer_slider: 'Web App Footer Slider',\n  sidebar_panel: 'Web App Sidebar Panel',\n  home_banner: 'Home Page Banner',\n};\n\n/**\n * Platform display names\n */\nexport const PLATFORM_NAMES: Record<TargetPlatform, string> = {\n  web: 'Web App',\n  android: 'Android App',\n  ios: 'iOS App',\n  extension: 'Browser Extension',\n};\n\n// ============================================================================\n// FIREBASE COLLECTION NAMES\n// ============================================================================\n\n/**\n * Collection names for shared features\n */\nexport const COLLECTIONS = {\n  CAMPAIGNS: 'zaions_campaigns',\n  PRODUCTS: 'zaions_products',\n  IMPRESSIONS: 'zaions_impressions',\n  CONTACTS: 'zaions_contacts',\n  FEATURE_REQUESTS: 'zaions_feature_requests',\n  PAYMENT_OPTIONS: 'zaions_payment_options',\n  SOCIAL_LINKS: 'zaions_social_links',\n  DEVELOPER_INFO: 'zaions_developer_info',\n} as const;\n"],"names":[],"mappings":";;AAybO,MAAM,yBAAyB;AAK/B,MAAM,4BAA4B;AAKlC,MAAM,gBAA2C;AAAA,EACtD,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAClB;AAKO,MAAM,kBAA+C;AAAA,EAC1D,cAAc;AAAA,EACd,eAAe;AAAA,EACf,eAAe;AAAA,EACf,cAAc;AAAA,EACd,cAAc;AAAA,EACd,eAAe;AAAA,EACf,eAAe;AAAA,EACf,aAAa;AACf;AAKO,MAAM,iBAAiD;AAAA,EAC5D,KAAK;AAAA,EACL,SAAS;AAAA,EACT,KAAK;AAAA,EACL,WAAW;AACb;AASO,MAAM,cAAc;AAAA,EACzB,WAAW;AAAA,EACX,UAAU;AAAA,EACV,aAAa;AAAA,EACb,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,gBAAgB;AAClB;;;;;;;"}

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Type Definitions Index
+ *
+ * Re-exports all type definitions from the shared-features package.
+ *
+ * @author Ahsan Mahmood <aoneahsan@gmail.com>
+ */
+export * from './campaigns';
+export type { FirebaseConfig, ConsumerPlatform, SharedFeaturesConfig, SharedFeaturesState, } from '../firebase/config';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,aAAa,CAAC;AAG5B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,49 @@
+const DEFAULT_FREQUENCY_DAYS = 20;
+const DEFAULT_CAMPAIGN_PRIORITY = 50;
+const VARIANT_NAMES = {
+  small_panel_1: "Minimal",
+  small_panel_2: "Tagline",
+  small_panel_3: "Features",
+  small_panel_4: "Gradient",
+  small_panel_5: "Card",
+  large_slider_1: "Hero",
+  large_slider_2: "Feature Grid",
+  large_slider_3: "Testimonial",
+  large_slider_4: "Comparison",
+  large_slider_5: "Video Placeholder"
+};
+const PLACEMENT_NAMES = {
+  popup_slider: "Extension Popup Slider",
+  options_panel: "Extension Options Panel",
+  onetime_modal: "One-Time Welcome Modal",
+  update_modal: "Update Announcement Modal",
+  notification: "Browser Notification",
+  footer_slider: "Web App Footer Slider",
+  sidebar_panel: "Web App Sidebar Panel",
+  home_banner: "Home Page Banner"
+};
+const PLATFORM_NAMES = {
+  web: "Web App",
+  android: "Android App",
+  ios: "iOS App",
+  extension: "Browser Extension"
+};
+const COLLECTIONS = {
+  CAMPAIGNS: "zaions_campaigns",
+  PRODUCTS: "zaions_products",
+  IMPRESSIONS: "zaions_impressions",
+  CONTACTS: "zaions_contacts",
+  FEATURE_REQUESTS: "zaions_feature_requests",
+  PAYMENT_OPTIONS: "zaions_payment_options",
+  SOCIAL_LINKS: "zaions_social_links",
+  DEVELOPER_INFO: "zaions_developer_info"
+};
+export {
+  COLLECTIONS,
+  DEFAULT_CAMPAIGN_PRIORITY,
+  DEFAULT_FREQUENCY_DAYS,
+  PLACEMENT_NAMES,
+  PLATFORM_NAMES,
+  VARIANT_NAMES
+};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/types/campaigns.ts"],"sourcesContent":["/**\n * Campaign/Advertising System Type Definitions\n *\n * Type definitions for the centralized advertising system including\n * Firestore document schemas, service interfaces, and UI types.\n *\n * Based on ZTools advertising system, adapted for cross-project use.\n *\n * @author Ahsan Mahmood <aoneahsan@gmail.com>\n */\n\nimport { Timestamp } from 'firebase/firestore';\n\n// ============================================================================\n// PRODUCT TYPES\n// ============================================================================\n\n/**\n * Product type classification\n */\nexport type ProductType = 'extension' | 'android' | 'ios' | 'web';\n\n/**\n * Product information for advertising\n */\nexport interface Product {\n  /** Unique product identifier */\n  id: string;\n  /** Product display name */\n  name: string;\n  /** Short tagline (marketing slogan) */\n  tagline: string;\n  /** Longer description of the product */\n  description: string;\n  /** Product type classification */\n  type: ProductType;\n  /** URL to the product (store link or website) */\n  url: string;\n  /** Brand/theme color (hex) */\n  color: string;\n  /** Key features list (3-4 items) */\n  features: string[];\n  /** Inline SVG icon (64px) */\n  icon64?: string;\n  /** Inline SVG icon (128px) */\n  icon128?: string;\n  /** Chrome Web Store URL */\n  chromeStoreUrl?: string;\n  /** Google Play Store URL */\n  playStoreUrl?: string;\n  /** Apple App Store URL */\n  appStoreUrl?: string;\n  /** Web app URL */\n  webUrl?: string;\n  /** Whether the product is active */\n  enabled: boolean;\n  /** When the product was created */\n  createdAt: Timestamp;\n  /** When the product was last updated */\n  updatedAt: Timestamp;\n}\n\n// ============================================================================\n// CAMPAIGN TYPES\n// ============================================================================\n\n/**\n * Campaign status values\n */\nexport type CampaignStatus = 'active' | 'paused' | 'scheduled' | 'ended';\n\n/**\n * Target platforms for campaigns\n */\nexport type TargetPlatform = 'web' | 'android' | 'ios' | 'extension';\n\n/**\n * Target audience for campaigns\n */\nexport type TargetAudience = 'all' | 'authenticated' | 'anonymous';\n\n/**\n * Placement options for ads\n */\nexport type AdPlacement =\n  | 'popup_slider'\n  | 'options_panel'\n  | 'onetime_modal'\n  | 'update_modal'\n  | 'notification'\n  | 'footer_slider'\n  | 'sidebar_panel'\n  | 'home_banner';\n\n/**\n * Small panel variant styles\n */\nexport type SmallPanelVariant =\n  | 'small_panel_1' // Minimal\n  | 'small_panel_2' // Tagline\n  | 'small_panel_3' // Features\n  | 'small_panel_4' // Gradient\n  | 'small_panel_5'; // Card\n\n/**\n * Large slider variant styles\n */\nexport type LargePanelVariant =\n  | 'large_slider_1' // Hero\n  | 'large_slider_2' // Feature Grid\n  | 'large_slider_3' // Testimonial\n  | 'large_slider_4' // Comparison\n  | 'large_slider_5'; // Video Placeholder\n\n/**\n * All ad variant types\n */\nexport type AdVariant = SmallPanelVariant | LargePanelVariant;\n\n/**\n * Advertising campaign document\n * Stored in: zaions_campaigns/{campaignId}\n */\nexport interface Campaign {\n  /** Campaign document ID */\n  id: string;\n  /** Reference to product being promoted */\n  productId: string;\n  /** Campaign name (admin reference) */\n  name: string;\n  /** Current campaign status */\n  status: CampaignStatus;\n\n  // === TARGETING ===\n  /** Platforms where this campaign should show */\n  targetPlatforms: TargetPlatform[];\n  /** Audience type to target */\n  targetAudience: TargetAudience;\n  /** Specific projects to target (empty = all projects) */\n  targetProjects: string[];\n  /** Don't show to users already using this product */\n  excludeProductUsers: boolean;\n\n  // === DISPLAY RULES ===\n  /** Where the ad can be displayed */\n  placements: AdPlacement[];\n  /** Priority (1-100, higher = more important) */\n  priority: number;\n  /** Days between impressions for same user (default: 20) */\n  frequencyDays: number;\n  /** Maximum total impressions (null = unlimited) */\n  maxImpressions: number | null;\n\n  // === TIMELINE ===\n  /** Campaign start date */\n  startDate: Timestamp;\n  /** Campaign end date (null = no end) */\n  endDate: Timestamp | null;\n\n  // === CREATIVE ===\n  /** UI variant to use */\n  variant: AdVariant;\n  /** Custom title (overrides product name) */\n  customTitle?: string;\n  /** Custom tagline (overrides product tagline) */\n  customTagline?: string;\n  /** Custom CTA button text */\n  customCta?: string;\n  /** Custom CTA button URL (overrides product URL) */\n  customCtaUrl?: string;\n  /** Custom description (overrides product description) */\n  customDescription?: string;\n  /** Custom product color for custom products/projects */\n  customProductColor?: string;\n  /** Custom icon SVG string (for custom products) */\n  customIcon?: string;\n  /** Custom features list (for custom products) */\n  customFeatures?: string[];\n\n  // === METRICS (Denormalized) ===\n  /** Total number of impressions */\n  totalImpressions: number;\n  /** Total number of clicks */\n  totalClicks: number;\n  /** Total number of closes/dismissals */\n  totalCloses: number;\n\n  // === METADATA ===\n  /** When campaign was created */\n  createdAt: Timestamp;\n  /** When campaign was last updated */\n  updatedAt: Timestamp;\n  /** Admin user ID who created */\n  createdBy: string;\n  /** Admin user ID who last updated */\n  updatedBy?: string;\n}\n\n/**\n * Input for creating a new campaign\n */\nexport interface CreateCampaignInput {\n  productId: string;\n  name: string;\n  status: CampaignStatus;\n  targetPlatforms: TargetPlatform[];\n  targetAudience: TargetAudience;\n  targetProjects: string[];\n  excludeProductUsers: boolean;\n  placements: AdPlacement[];\n  priority: number;\n  frequencyDays: number;\n  maxImpressions: number | null;\n  startDate: Date;\n  endDate: Date | null;\n  variant: AdVariant;\n  customTitle?: string;\n  customTagline?: string;\n  customCta?: string;\n  customCtaUrl?: string;\n  customDescription?: string;\n  customProductColor?: string;\n  customIcon?: string;\n  customFeatures?: string[];\n}\n\n/**\n * Input for updating a campaign\n */\nexport interface UpdateCampaignInput extends Partial<CreateCampaignInput> {\n  id: string;\n}\n\n// ============================================================================\n// IMPRESSION TYPES\n// ============================================================================\n\n/**\n * Types of ad interactions\n */\nexport type AdAction = 'impression' | 'click' | 'close' | 'notification_click';\n\n/**\n * Ad impression/interaction event\n * Stored in: zaions_impressions/{impressionId}\n */\nexport interface Impression {\n  /** Impression document ID */\n  id: string;\n  /** Campaign that generated this impression */\n  campaignId: string;\n  /** Product being advertised */\n  productId: string;\n  /** Project where impression occurred */\n  projectId: string;\n\n  /** User ID (null for anonymous) */\n  userId: string | null;\n  /** Device/browser fingerprint */\n  deviceId: string;\n  /** Platform where impression occurred */\n  platform: TargetPlatform;\n  /** Placement where ad was shown */\n  placement: AdPlacement;\n\n  /** Type of interaction */\n  action: AdAction;\n  /** When the interaction occurred */\n  timestamp: Timestamp;\n\n  /** UI variant that was displayed */\n  variant: AdVariant;\n  /** Session identifier */\n  sessionId?: string;\n}\n\n/**\n * Input for recording an impression\n */\nexport interface RecordImpressionInput {\n  campaignId: string;\n  productId: string;\n  placement: AdPlacement;\n  action: AdAction;\n  variant: AdVariant;\n  sessionId?: string;\n}\n\n// ============================================================================\n// AD HISTORY TYPES\n// ============================================================================\n\n/**\n * Local ad history entry (for frequency capping)\n */\nexport interface AdHistoryEntry {\n  /** Campaign ID */\n  campaignId: string;\n  /** Product ID */\n  productId: string;\n  /** Last seen timestamp (Unix ms) */\n  lastSeenAt: number;\n  /** Impression count */\n  impressionCount: number;\n  /** Whether clicked */\n  clicked: boolean;\n  /** Whether closed */\n  closed: boolean;\n  /** Next eligible timestamp (Unix ms) */\n  nextEligibleAt: number;\n}\n\n// ============================================================================\n// SERVICE TYPES\n// ============================================================================\n\n/**\n * Options for fetching campaigns\n */\nexport interface FetchCampaignsOptions {\n  /** Filter by placement */\n  placement?: AdPlacement;\n  /** Filter by status */\n  status?: CampaignStatus;\n  /** Filter by product */\n  productId?: string;\n  /** Maximum results */\n  limit?: number;\n}\n\n/**\n * Campaign with resolved product data\n */\nexport interface CampaignWithProduct extends Campaign {\n  /** Resolved product information */\n  product: Product;\n}\n\n// ============================================================================\n// ANALYTICS TYPES\n// ============================================================================\n\n/**\n * Campaign analytics summary\n */\nexport interface CampaignAnalytics {\n  campaignId: string;\n  campaignName: string;\n  productId: string;\n  productName: string;\n\n  /** Total impressions */\n  impressions: number;\n  /** Total clicks */\n  clicks: number;\n  /** Total closes */\n  closes: number;\n  /** Click-through rate (clicks/impressions) */\n  ctr: number;\n  /** Close rate (closes/impressions) */\n  closeRate: number;\n\n  /** Breakdown by platform */\n  byPlatform: Record<TargetPlatform, { impressions: number; clicks: number }>;\n  /** Breakdown by placement */\n  byPlacement: Record<AdPlacement, { impressions: number; clicks: number }>;\n  /** Breakdown by project */\n  byProject: Record<string, { impressions: number; clicks: number }>;\n  /** Daily breakdown */\n  byDate: Array<{\n    date: string;\n    impressions: number;\n    clicks: number;\n    closes: number;\n  }>;\n}\n\n// ============================================================================\n// COMPONENT PROPS\n// ============================================================================\n\n/**\n * Props for small panel variants\n */\nexport interface SmallPanelProps {\n  campaign: Campaign;\n  product: Product;\n  variant: SmallPanelVariant;\n  onClose: () => void;\n  onClick: () => void;\n}\n\n/**\n * Props for large panel variants\n */\nexport interface LargePanelProps {\n  campaign: Campaign;\n  product: Product;\n  variant: LargePanelVariant;\n  onClose: () => void;\n  onClick: () => void;\n}\n\n/**\n * Props for ad slider component\n */\nexport interface AdSliderProps {\n  placement: AdPlacement;\n  variant?: SmallPanelVariant;\n  autoplay?: boolean;\n  interval?: number;\n  maxCampaigns?: number;\n  className?: string;\n}\n\n/**\n * Props for ad modal component\n */\nexport interface AdModalProps {\n  open: boolean;\n  onOpenChange: (open: boolean) => void;\n  campaign: CampaignWithProduct | null;\n  variant?: LargePanelVariant;\n}\n\n/**\n * Props for ad panel component\n */\nexport interface AdPanelProps {\n  placement: AdPlacement;\n  variant?: SmallPanelVariant;\n  className?: string;\n}\n\n// ============================================================================\n// DEFAULT VALUES\n// ============================================================================\n\n/**\n * Default frequency cap in days\n */\nexport const DEFAULT_FREQUENCY_DAYS = 20;\n\n/**\n * Default campaign priority\n */\nexport const DEFAULT_CAMPAIGN_PRIORITY = 50;\n\n/**\n * Variant display names\n */\nexport const VARIANT_NAMES: Record<AdVariant, string> = {\n  small_panel_1: 'Minimal',\n  small_panel_2: 'Tagline',\n  small_panel_3: 'Features',\n  small_panel_4: 'Gradient',\n  small_panel_5: 'Card',\n  large_slider_1: 'Hero',\n  large_slider_2: 'Feature Grid',\n  large_slider_3: 'Testimonial',\n  large_slider_4: 'Comparison',\n  large_slider_5: 'Video Placeholder',\n};\n\n/**\n * Placement display names\n */\nexport const PLACEMENT_NAMES: Record<AdPlacement, string> = {\n  popup_slider: 'Extension Popup Slider',\n  options_panel: 'Extension Options Panel',\n  onetime_modal: 'One-Time Welcome Modal',\n  update_modal: 'Update Announcement Modal',\n  notification: 'Browser Notification',\n  footer_slider: 'Web App Footer Slider',\n  sidebar_panel: 'Web App Sidebar Panel',\n  home_banner: 'Home Page Banner',\n};\n\n/**\n * Platform display names\n */\nexport const PLATFORM_NAMES: Record<TargetPlatform, string> = {\n  web: 'Web App',\n  android: 'Android App',\n  ios: 'iOS App',\n  extension: 'Browser Extension',\n};\n\n// ============================================================================\n// FIREBASE COLLECTION NAMES\n// ============================================================================\n\n/**\n * Collection names for shared features\n */\nexport const COLLECTIONS = {\n  CAMPAIGNS: 'zaions_campaigns',\n  PRODUCTS: 'zaions_products',\n  IMPRESSIONS: 'zaions_impressions',\n  CONTACTS: 'zaions_contacts',\n  FEATURE_REQUESTS: 'zaions_feature_requests',\n  PAYMENT_OPTIONS: 'zaions_payment_options',\n  SOCIAL_LINKS: 'zaions_social_links',\n  DEVELOPER_INFO: 'zaions_developer_info',\n} as const;\n"],"names":[],"mappings":"AAybO,MAAM,yBAAyB;AAK/B,MAAM,4BAA4B;AAKlC,MAAM,gBAA2C;AAAA,EACtD,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAClB;AAKO,MAAM,kBAA+C;AAAA,EAC1D,cAAc;AAAA,EACd,eAAe;AAAA,EACf,eAAe;AAAA,EACf,cAAc;AAAA,EACd,cAAc;AAAA,EACd,eAAe;AAAA,EACf,eAAe;AAAA,EACf,aAAa;AACf;AAKO,MAAM,iBAAiD;AAAA,EAC5D,KAAK;AAAA,EACL,SAAS;AAAA,EACT,KAAK;AAAA,EACL,WAAW;AACb;AASO,MAAM,cAAc;AAAA,EACzB,WAAW;AAAA,EACX,UAAU;AAAA,EACV,aAAa;AAAA,EACb,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,gBAAgB;AAClB;"}