@bigcrunch/react-native-ads 0.1.0

package/lib/types/config.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Configuration types for BigCrunch Mobile Ads SDK
+ */
+import { AdFormat } from './index';
+/**
+ * App configuration from BigCrunch backend
+ */
+export interface AppConfig {
+    /** Property ID */
+    propertyId: string;
+    /** Property name */
+    propertyName: string;
+    /** List of configured placements */
+    placements: PlacementConfig[];
+    /** Global settings */
+    settings?: GlobalSettings;
+    /** Last updated timestamp */
+    lastUpdated?: string;
+    /** Config version */
+    version?: string;
+}
+/**
+ * Individual placement configuration
+ */
+export interface PlacementConfig {
+    /** Unique placement ID */
+    placementId: string;
+    /** Placement name for reporting */
+    placementName?: string;
+    /** Ad format type */
+    format: AdFormat;
+    /** Google Ad Manager ad unit ID */
+    gamAdUnit: string;
+    /** Ad size configuration */
+    size?: AdSizeConfig;
+    /** Prebid configuration */
+    prebidConfig?: PrebidConfig;
+    /** Amazon APS configuration */
+    amazonConfig?: AmazonConfig;
+    /** Placement-specific settings */
+    settings?: PlacementSettings;
+    /** Whether placement is active */
+    enabled: boolean;
+}
+/**
+ * Ad size configuration
+ */
+export interface AdSizeConfig {
+    /** Width in dp/points */
+    width: number;
+    /** Height in dp/points */
+    height: number;
+    /** Whether to use adaptive sizing */
+    adaptive?: boolean;
+}
+/**
+ * Prebid configuration
+ */
+export interface PrebidConfig {
+    /** Prebid account ID */
+    accountId: string;
+    /** Config ID for server-side configuration */
+    configId: string;
+    /** Timeout for prebid requests in milliseconds */
+    timeout?: number;
+    /** Enable debug mode for prebid */
+    debug?: boolean;
+    /** Custom targeting parameters */
+    customTargeting?: Record<string, string>;
+    /** Price granularity */
+    priceGranularity?: 'low' | 'medium' | 'high' | 'auto' | 'dense' | 'custom';
+    /** Custom price granularity buckets */
+    customPriceGranularity?: PriceGranularityBucket[];
+}
+/**
+ * Price granularity bucket configuration
+ */
+export interface PriceGranularityBucket {
+    /** Minimum price */
+    min: number;
+    /** Maximum price */
+    max: number;
+    /** Increment */
+    increment: number;
+}
+/**
+ * Amazon APS configuration
+ */
+export interface AmazonConfig {
+    /** Amazon slot ID */
+    slotId: string;
+    /** Enable Amazon integration */
+    enabled: boolean;
+    /** Timeout for Amazon requests */
+    timeout?: number;
+}
+/**
+ * Global settings
+ */
+export interface GlobalSettings {
+    /** Enable test mode */
+    testMode?: boolean;
+    /** Test device IDs */
+    testDeviceIds?: string[];
+    /** Enable verbose logging */
+    verboseLogging?: boolean;
+    /** Session timeout in seconds */
+    sessionTimeout?: number;
+    /** Analytics batch size */
+    analyticsBatchSize?: number;
+    /** Analytics flush interval in seconds */
+    analyticsFlushInterval?: number;
+    /** Enable crash reporting */
+    crashReporting?: boolean;
+    /** GDPR consent string */
+    gdprConsent?: string;
+    /** CCPA compliance string */
+    ccpaString?: string;
+    /** COPPA compliance */
+    coppaCompliant?: boolean;
+}
+/**
+ * Placement-specific settings
+ */
+export interface PlacementSettings {
+    /** Auto-refresh interval in seconds (0 = disabled) */
+    refreshInterval?: number;
+    /** Maximum refresh count */
+    maxRefreshCount?: number;
+    /** Enable viewability tracking */
+    viewabilityTracking?: boolean;
+    /** Viewability threshold percentage */
+    viewabilityThreshold?: number;
+    /** Custom targeting for this placement */
+    customTargeting?: Record<string, string>;
+}
+//# sourceMappingURL=config.d.ts.map

package/lib/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}

package/lib/types/config.js

@@ -0,0 +1,4 @@
+/**
+ * Configuration types for BigCrunch Mobile Ads SDK
+ */
+export {};

package/lib/types/events.d.ts

@@ -0,0 +1,306 @@
+/**
+ * Event types for BigCrunch Mobile Ads SDK
+ */
+import { AdError, AdRevenue, AdFormat } from './index';
+/**
+ * Base event data
+ */
+export interface BaseAdEvent {
+    /** Placement ID */
+    placementId: string;
+    /** Ad format */
+    format: AdFormat;
+    /** Timestamp of the event */
+    timestamp: number;
+}
+/**
+ * Ad loaded event
+ */
+export interface AdLoadedEvent extends BaseAdEvent {
+    type: 'adLoaded';
+    /** Ad network that filled the ad */
+    adNetwork?: string;
+    /** Ad unit ID */
+    adUnitId?: string;
+}
+/**
+ * Ad failed to load event
+ */
+export interface AdFailedToLoadEvent extends BaseAdEvent {
+    type: 'adFailedToLoad';
+    /** Error details */
+    error: AdError;
+}
+/**
+ * Ad impression event
+ */
+export interface AdImpressionEvent extends BaseAdEvent {
+    type: 'adImpression';
+    /** Ad network that served the impression */
+    adNetwork?: string;
+    /** Unique impression ID (UUID) */
+    impressionId?: string;
+    /** GAM ad unit path */
+    gamAdUnit?: string;
+    /** Ad size (e.g., "320x50") */
+    adSize?: string;
+    /** Auction ID from Prebid */
+    auctionId?: string;
+    /** Winning bidder name */
+    bidder?: string;
+    /** Bid price in CPM */
+    bidPriceCpm?: number;
+    /** Advertiser ID from GAM metadata */
+    advertiserId?: string;
+    /** Campaign ID from GAM metadata (not available in mobile SDKs) */
+    campaignId?: string;
+    /** Line item ID from GAM metadata (not available in mobile SDKs) */
+    lineItemId?: string;
+    /** Creative ID from GAM metadata */
+    creativeId?: string;
+    /** Refresh count for this placement */
+    refreshCount?: number;
+    /** Demand channel (e.g., "Prebid Header", "GAM Direct") */
+    demandChannel?: string;
+}
+/**
+ * Ad clicked event
+ */
+export interface AdClickedEvent extends BaseAdEvent {
+    type: 'adClicked';
+}
+/**
+ * Ad opened event (for overlays/modals)
+ */
+export interface AdOpenedEvent extends BaseAdEvent {
+    type: 'adOpened';
+}
+/**
+ * Ad closed event
+ */
+export interface AdClosedEvent extends BaseAdEvent {
+    type: 'adClosed';
+}
+/**
+ * Ad revenue event (ILRD)
+ */
+export interface AdRevenueEvent extends BaseAdEvent {
+    type: 'adRevenue';
+    /** Revenue data */
+    revenue: AdRevenue;
+}
+/**
+ * Ad viewable event
+ */
+export interface AdViewableEvent extends BaseAdEvent {
+    type: 'adViewable';
+    /** Duration in view (milliseconds) */
+    viewDuration?: number;
+    /** Percentage of ad visible */
+    visiblePercentage?: number;
+}
+/**
+ * Rewarded ad events
+ */
+export interface RewardedAdEarnedEvent extends BaseAdEvent {
+    type: 'rewardEarned';
+    /** Reward type */
+    rewardType: string;
+    /** Reward amount */
+    rewardAmount: number;
+}
+/**
+ * Union type of all ad events
+ */
+export type AdEvent = AdLoadedEvent | AdFailedToLoadEvent | AdImpressionEvent | AdClickedEvent | AdOpenedEvent | AdClosedEvent | AdRevenueEvent | AdViewableEvent | RewardedAdEarnedEvent;
+/**
+ * Event listener callback
+ */
+export type AdEventListener<T extends AdEvent = AdEvent> = (event: T) => void;
+/**
+ * Event subscription
+ */
+export interface EventSubscription {
+    /** Remove the event listener */
+    remove: () => void;
+}
+/**
+ * Analytics event for backend
+ *
+ * Note: This represents the legacy event format. The SDK now uses web schema events
+ * with flattened structure (PageViewEvent, ImpressionEvent, ClickEvent, etc.)
+ *
+ * @deprecated Use web schema event types instead
+ */
+export interface AnalyticsEvent {
+    /** Event type */
+    eventType: 'screen_view' | 'ad_request' | 'ad_impression' | 'ad_click' | 'ad_revenue' | 'ad_viewable' | 'session_start' | 'session_end';
+    /** Event timestamp (milliseconds since epoch) */
+    timestamp: number;
+    /** Session ID */
+    sessionId: string;
+    /** Event-specific data */
+    data: Record<string, any>;
+    /** Device context */
+    deviceContext?: Partial<DeviceContext>;
+}
+/**
+ * Web schema common fields (present in all events)
+ */
+export interface WebSchemaCommonFields {
+    /** Payload version identifier */
+    payloadVersion: string;
+    /** Config version from backend */
+    configVersion?: string;
+    /** Event timestamp in ISO 8601 format (e.g., "2025-01-15T10:30:00Z") */
+    browserTimestamp: string;
+    /** Session ID (UUID) */
+    sessionId: string;
+    /** User ID (UUID, persistent across sessions) */
+    userId: string;
+    /** Property ID from BigCrunch dashboard */
+    propertyId: string;
+    /** True if this is user's first session */
+    newUser: boolean;
+    /** Current page/screen ID (UUID) */
+    pageId: string;
+    /** Number of page views in current session */
+    sessionDepth: number;
+    /** Browser/SDK identifier (e.g., "BigCrunch iOS SDK 1.0.0") */
+    browser: string;
+    /** Device type (e.g., "iPhone 14", "Samsung Galaxy S21") */
+    device: string;
+    /** Operating system (e.g., "iOS 16.0", "Android 13") */
+    os: string;
+    /** Country code (ISO 3166-1 alpha-2, e.g., "US") */
+    country: string;
+    /** Region/state code */
+    region: string;
+    /** Session attribution source */
+    sessionSource: string;
+    /** Session attribution medium */
+    sessionMedium: string;
+    /** UTM source parameter */
+    utmSource?: string;
+    /** UTM medium parameter */
+    utmMedium?: string;
+    /** UTM campaign parameter */
+    utmCampaign?: string;
+    /** UTM term parameter */
+    utmTerm?: string;
+    /** UTM content parameter */
+    utmContent?: string;
+    /** Google Click ID for attribution */
+    gclid?: string;
+    /** Facebook Click ID for attribution */
+    fbclid?: string;
+}
+/**
+ * Page view event (web schema)
+ * Sent to /pageviews endpoint
+ */
+export interface PageViewEvent extends WebSchemaCommonFields {
+    /** Screen/page name */
+    screenName: string;
+    /** Referrer (previous screen) */
+    referrer?: string;
+}
+/**
+ * Impression event (web schema)
+ * Sent to /impressions endpoint
+ * Consolidates ad request, impression, and revenue tracking
+ */
+export interface ImpressionEvent extends WebSchemaCommonFields {
+    /** Unique impression ID (UUID) */
+    impressionId: string;
+    /** Placement identifier */
+    placementId: string;
+    /** GAM ad unit path */
+    gamAdUnit: string;
+    /** Ad format (banner, interstitial, rewarded) */
+    format: string;
+    /** Auction ID from Prebid */
+    auctionId?: string;
+    /** Refresh count for this placement */
+    refreshCount?: number;
+    /** Winning bidder name */
+    bidder?: string;
+    /** Ad size (e.g., "320x50") */
+    adSize?: string;
+    /** Bid price/revenue in CPM */
+    bidPriceCpm?: number;
+    /** Floor price */
+    floorPrice?: number;
+    /** Minimum bid to win */
+    minBidToWin?: number;
+    /** Advertiser ID from GAM */
+    advertiserId?: string;
+    /** Campaign ID from GAM (not available in mobile SDKs) */
+    campaignId?: string;
+    /** Line item ID from GAM (not available in mobile SDKs) */
+    lineItemId?: string;
+    /** Creative ID from GAM response */
+    creativeId?: string;
+    /** Amazon bid data */
+    amznBid?: string;
+    /** Amazon price data */
+    amznPrice?: string;
+    /** Demand type (banner, video, etc.) */
+    demandType?: string;
+    /** Demand channel (e.g., "Prebid Header", "GAM Direct") */
+    demandChannel?: string;
+}
+/**
+ * Click event (web schema)
+ * Sent to /clicks endpoint
+ */
+export interface ClickEvent extends WebSchemaCommonFields {
+    /** Reference to the impression that was clicked */
+    impressionId: string;
+    /** Placement identifier */
+    placementId: string;
+    /** Ad format */
+    format: string;
+}
+/**
+ * Viewability event (web schema)
+ * Sent to /viewability endpoint
+ */
+export interface ViewabilityEvent extends WebSchemaCommonFields {
+    /** Reference to the impression */
+    impressionId: string;
+    /** Placement identifier */
+    placementId: string;
+    /** Ad format */
+    format: string;
+    /** Time ad was viewable in milliseconds */
+    viewableTimeMs: number;
+    /** Percentage of ad that was visible */
+    percentVisible: number;
+}
+/**
+ * Engagement event (web schema)
+ * Sent to /engagement endpoint
+ */
+export interface EngagementEvent extends WebSchemaCommonFields {
+    /** Time actively engaged in seconds */
+    engagedTime: number;
+    /** Total time on page/screen in seconds */
+    timeOnPage: number;
+}
+/**
+ * Screen view event data
+ */
+export interface ScreenViewData {
+    /** Screen name */
+    screenName: string;
+    /** Screen class/component name */
+    screenClass?: string;
+    /** Previous screen */
+    previousScreen?: string;
+}
+/**
+ * Device context (imported from index)
+ */
+import { DeviceContext } from './index';
+//# sourceMappingURL=events.d.ts.map

package/lib/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"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"}

package/lib/types/events.js

@@ -0,0 +1,4 @@
+/**
+ * Event types for BigCrunch Mobile Ads SDK
+ */
+export {};

package/lib/types/index.d.ts

@@ -0,0 +1,175 @@
+/**
+ * BigCrunch Mobile Ads SDK for React Native
+ * Type definitions
+ */
+export * from './config';
+export * from './events';
+export * from './ads';
+/**
+ * SDK Environment options
+ */
+export type Environment = 'production' | 'sandbox';
+/**
+ * Ad formats supported by the SDK
+ */
+export type AdFormat = 'banner' | 'interstitial' | 'rewarded';
+/**
+ * Banner ad sizes
+ */
+export type BannerSize = 'BANNER' | 'LARGE_BANNER' | 'MEDIUM_RECTANGLE' | 'FULL_BANNER' | 'LEADERBOARD' | 'ADAPTIVE' | 'SMART';
+/**
+ * Custom ad size
+ */
+export interface CustomSize {
+    width: number;
+    height: number;
+}
+/**
+ * SDK initialization options
+ */
+export interface InitializationOptions {
+    /** Your BigCrunch property ID */
+    propertyId: string;
+    /** Your API key for authentication */
+    apiKey: string;
+    /** Environment to use */
+    environment?: Environment;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Use mock configuration for testing (no backend required) */
+    useMockConfig?: boolean;
+    /** Custom backend URL (optional) */
+    customBackendUrl?: string;
+    /** Session timeout in seconds (default: 1800) */
+    sessionTimeout?: number;
+}
+/**
+ * Ad request options
+ */
+export interface AdRequestOptions {
+    /** Placement ID from BigCrunch dashboard */
+    placementId: string;
+    /** Custom targeting parameters */
+    customTargeting?: Record<string, string>;
+    /** Content URL for contextual targeting */
+    contentUrl?: string;
+    /** Publisher provided ID */
+    publisherProvidedId?: string;
+}
+/**
+ * Error codes for ad loading failures
+ */
+export declare enum AdErrorCode {
+    UNKNOWN = "UNKNOWN",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    NO_FILL = "NO_FILL",
+    INVALID_REQUEST = "INVALID_REQUEST",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    INVALID_PLACEMENT = "INVALID_PLACEMENT",
+    NOT_INITIALIZED = "NOT_INITIALIZED",
+    ALREADY_LOADED = "ALREADY_LOADED",
+    NOT_LOADED = "NOT_LOADED",
+    TIMEOUT = "TIMEOUT"
+}
+/**
+ * Ad error object
+ */
+export interface AdError {
+    code: AdErrorCode;
+    message: string;
+    underlyingError?: string;
+}
+/**
+ * Ad revenue data from Impression-Level Revenue Data (ILRD)
+ */
+export interface AdRevenue {
+    /** Revenue value in micros (millionths of currency unit) */
+    valueMicros: number;
+    /** Currency code (e.g., 'USD') */
+    currencyCode: string;
+    /** Ad unit that generated the revenue */
+    adUnitId?: string;
+    /** Precision of the revenue value */
+    precision?: 'ESTIMATED' | 'PUBLISHER_PROVIDED' | 'PRECISE' | 'UNKNOWN';
+}
+/**
+ * Session information
+ */
+export interface SessionInfo {
+    /** Unique session ID (UUID) */
+    sessionId: string;
+    /** Persistent user ID (UUID, stored across app launches) */
+    userId: string;
+    /** Session start timestamp in ISO 8601 format (e.g., "2025-01-15T10:30:00Z") */
+    sessionStartTime: string;
+    /** Total number of sessions for this user (across all time) */
+    totalSessionCount: number;
+    /** True if this is the user's first session */
+    isNewUser: boolean;
+    /** Number of screens/page views in current session */
+    sessionDepth: number;
+    /** Number of screens viewed in session (deprecated, use sessionDepth) */
+    screenViewCount: number;
+    /** Number of ads requested in session */
+    adRequestCount: number;
+    /** Number of ads shown in session */
+    adImpressionCount: number;
+    /** Total revenue in session (micros) */
+    totalRevenueMicros: number;
+    /** Current page/screen ID (UUID, new per page view) */
+    currentPageId?: string;
+    /** UTM source parameter (e.g., "google", "facebook") */
+    utmSource?: string;
+    /** UTM medium parameter (e.g., "cpc", "email") */
+    utmMedium?: string;
+    /** UTM campaign parameter (e.g., "summer_sale") */
+    utmCampaign?: string;
+    /** UTM term parameter (optional keyword) */
+    utmTerm?: string;
+    /** UTM content parameter (optional content variant) */
+    utmContent?: string;
+    /** Session attribution source (derived from UTM or defaults to "direct") */
+    sessionSource: string;
+    /** Session attribution medium (derived from UTM or defaults to "none") */
+    sessionMedium: string;
+}
+/**
+ * Device context information
+ */
+export interface DeviceContext {
+    /** Device ID (IDFA/AAID when available) */
+    deviceId?: string;
+    /** Operating system */
+    os: 'iOS' | 'Android';
+    /** OS version */
+    osVersion: string;
+    /** Device model */
+    deviceModel: string;
+    /** Device manufacturer */
+    deviceManufacturer?: string;
+    /** Screen width in pixels */
+    screenWidth: number;
+    /** Screen height in pixels */
+    screenHeight: number;
+    /** Screen density */
+    screenDensity?: number;
+    /** App version */
+    appVersion: string;
+    /** SDK version */
+    sdkVersion: string;
+    /** Network connection type */
+    connectionType?: 'wifi' | 'cellular' | 'ethernet' | 'unknown';
+    /** User's locale */
+    locale?: string;
+    /** User's timezone */
+    timezone?: string;
+    /** Country code (ISO 3166-1 alpha-2, e.g., "US", "GB") */
+    country?: string;
+    /** Region/state code */
+    region?: string;
+    /** Browser/SDK identifier for web schema (e.g., "BigCrunch iOS SDK 1.0.0") */
+    browser?: string;
+    /** Device type for web schema (e.g., "iPhone 14", "Samsung Galaxy S21") */
+    device?: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/lib/types/index.js

@@ -0,0 +1,23 @@
+/**
+ * BigCrunch Mobile Ads SDK for React Native
+ * Type definitions
+ */
+export * from './config';
+export * from './events';
+export * from './ads';
+/**
+ * Error codes for ad loading failures
+ */
+export var AdErrorCode;
+(function (AdErrorCode) {
+    AdErrorCode["UNKNOWN"] = "UNKNOWN";
+    AdErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    AdErrorCode["NO_FILL"] = "NO_FILL";
+    AdErrorCode["INVALID_REQUEST"] = "INVALID_REQUEST";
+    AdErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    AdErrorCode["INVALID_PLACEMENT"] = "INVALID_PLACEMENT";
+    AdErrorCode["NOT_INITIALIZED"] = "NOT_INITIALIZED";
+    AdErrorCode["ALREADY_LOADED"] = "ALREADY_LOADED";
+    AdErrorCode["NOT_LOADED"] = "NOT_LOADED";
+    AdErrorCode["TIMEOUT"] = "TIMEOUT";
+})(AdErrorCode || (AdErrorCode = {}));