iOS

dependencies: [
    .package(url: "https://github.com/kontextso/sdk-swift", .upToNextMajor(from: "1.0.3"))
]

pod 'KontextSwiftSDK'

import KontextSwiftSDK

// Character that is being conversed with, leave nil if not relevant for this conversation.
let character = Character(
    // Unique ID of the character
    id: "<character-id>",
    // Name of the character
    name: "<character-name>",
    // URL of the character’s avatar
    avatarUrl: URL(string: "<character-avatar-url>"),
    // Whether the character is NSFW
    isNsfw: <bool>,
    // Greeting of the character
    greeting: "<character-greeting>",
    // Description of the character’s personality
    persona: "<character-persona>",
    // Tags of the character (list of strings)
    tags: ["<tag-1>", "<tag-2>"]
)

// Prepare regulatory compliance object
let regulatory = Regulatory(
	// Flag that indicates whether or not the request is subject to GDPR regulations (0 = No, 1 = Yes, null = Unknown).
	gdpr: 0,
	// Transparency and Consent Framework's Consent String data structure
	gdprConsent: "<gdpr-consent>",
	// Flag whether the request is subject to COPPA (0 = No, 1 = Yes, null = Unknown).
	coppa: 0,	
	// Global Privacy Platform (GPP) consent string
	gpp: "<gpp>",
	// List of the section(s) of the GPP string which should be applied for this transaction
	gppSid: [1, 2],
	// Communicates signals regarding consumer privacy under US privacy regulation under CCPA and LSPA
	usPrivacy: "<us-privacy>"
)

let configuration = AdsProviderConfiguration(
	// Your unique publisher token received from your account manager.
	publisherToken: "<publisher-token>",
	// A unique string that should remain the same during the user’s lifetime (used for retargeting and rewarded ads). Eg. uuid or hash of email address work well.
	userId: "<user-id>",
	// Unique ID of the conversation. This is mostly used for ad pacing.
	conversationId: "<conversation-id>",
	// A list of placement codes that identify ad slots in your app. You receive them from your account manager.
	enabledPlacementCodes: ["<code>"],
	// The character object used in this conversation
	character: character,
	// Advertising identifier (IDFA), when allowed by user, otherwise nil
	advertisingId: ASIdentifierManager.shared().advertisingIdentifier,
	// An alphanumeric string that uniquely identifies a device to the app’s vendor (IDFV).
	vendorId: UIDevice.current.identifierForVendor,
	/// Information about regulatory requirements that apply
	regulatory: regulatory,
    // May contain arbitrary key-value pairs. Used to pass publisher-specific information to Kontext. Contents will be discussed with your account manager if needed.   
    otherParams: ["theme": "v1-dark"]
)

let adsProvider = AdsProvider(
	// Previously created configuration (it is immutable and publicly available if you need to refer to it later)
	configuration: configuration,
	// ID of the session, will be nil for new chats, SDK will resolve it internally with first ads.
	sessionId: nil
)

// 1. Option: Conformance to MessageRepresentable
struct MyChatMessage: MessageRepresentable {
	...
	/// Unique ID of the message
	var id: String { self.uuid.uuidString }
	/// Role of the author of the message (user or assistant)
	var role: Role { self.isUser ? .user : .assistant }
	/// Content of the message
	var content: String { self.messageContent }
	/// Timestamp when the message was created
	var createdAt: Date { self.date }
	...
}

// 2. Option: Conformance to MessageRepresentableProviding
// Better if you have collision of names of properties
struct MyChatMessage: MessageRepresentable {
	...
	var message: MessageRepresentable {
		AdsMessage(
			id: self.uuid.uuidString,
			role: self.isUser ? .user : .assistant,
			content: self.messageContent,
			createdAt: self.date
		)
	...	
}

adsProvider.setMessages(messages)

ZStack {
    ForEach(messages, id: \.uuid.uuidString) { message in
        VStack {
            MyChatMessageView(message)
      
            let ad = // Retrieve ad for message
            InlineAdView(ad: ad)
        }
    }
}.onReceive(adsProvider.eventPublisher) { event in
   // React to adsProvider events
}