@bigcrunch/react-native-ads 0.11.0 → 0.14.0

package/src/types/index.ts

@@ -12,6 +12,11 @@ export * from './ads';
  */
 export type Environment = 'production' | 'sandbox';
 
+/**
+ * Account type for the current user
+ */
+export type AccountType = 'guest' | 'logged_in' | 'paid' | 'subscriber' | 'free';
+
 /**
  * Ad formats supported by the SDK
  */
@@ -57,6 +62,44 @@ export interface InitializationOptions {
   sessionTimeout?: number;
 }
 
+/**
+ * Content metadata for a screen/page view
+ *
+ * Matches the `page_meta_data` fields in the BigCrunch analytics schema.
+ */
+export interface PageMetaData {
+  /** Canonical page URL */
+  url?: string;
+  /** Content author */
+  author?: string;
+  /** Page/screen title */
+  title?: string;
+  /** Featured image URL */
+  thumbnailUrl?: string;
+  /** Content section/category */
+  articleSection?: string;
+  /** Comma-separated keywords */
+  keywords?: string;
+  /** Content creation date (ISO 8601) */
+  dateCreated?: string;
+  /** Content last modified date (ISO 8601) */
+  dateModified?: string;
+  /** Content publication date (ISO 8601) */
+  datePublished?: string;
+}
+
+/**
+ * Options for customizing screen view tracking
+ */
+export interface ScreenViewOptions {
+  /** Override the auto-generated page URL (must be a valid web URL) */
+  pageUrl?: string;
+  /** Content metadata for this screen/page */
+  pageMeta?: PageMetaData;
+  /** Custom key-value dimensions attached to analytics events */
+  customDimensions?: Record<string, string>;
+}
+
 /**
  * Ad request options
  */