iOS

let customerConfiguration = CustomerConfiguration(
    cardName: "Card Name",		    // Your cardName
    customerName: "Customer Name",  // Your customerName
    logoId: "LogoId"				// Your logoID
)

let config = KnotConfiguration(
    sessionId: "session_12345",     // Current session ID
    clientId: "client_67890",       // Your client ID
    environment: .production,       // 'development' | 'production'
    merchantIds: [52],              // Recommend 0 or 1 merchant IDs
    useCategories: true,            // Recommend true
    useSearch: true,                // Recommend true
    domainUrls: nil,                // Explicitly passing nil
    entryPoint: "onboarding",       // Defined by you
    metadata: [                     // Optional metadata for webhooks
        "reference_token": "your-token",
        "trace_id": "your-trace-id"
    ],
    customerConfiguration: customerConfiguration,
    locale: "es-US"                 // Optional BCP-47 language tag
)

CustomerConfiguration *customerConfiguration = [[CustomerConfiguration alloc]
    initWithCardName:@"Card Name"
        customerName:@"Customer Name"
             logoId:@"LogoId"];

NSDictionary *metadata = @{
    @"reference_token": @"your-token",
    @"trace_id": @"your-trace-id"
};

KnotConfiguration *config = [[KnotConfiguration alloc]
    initWithSessionId:@"session_12345"
             clientId:@"client_67890"
          environment:EnvironmentDevelopment   // enum case
           entryPoint:@"onboarding"
              product:ProductCard_switcher     // enum case
        useCategories:YES
            useSearch:YES
          merchantIds:@[@52]
             metadata:metadata
customerConfiguration:customerConfiguration
               locale:@"es-US"];              // Optional BCP-47 language tag

Knot.open(configuration: myConfiguration, delegate: self)

[Knot openWithConfiguration:config delegate:self];

let customerConfiguration = CustomerConfiguration(
    cardName: "Card Name",		   
    customerName: "Customer Name",
    logoId: "LogoId"	
)

let config = KnotConfiguration(
    sessionId: "session_12345",
    clientId: "client_67890",
    environment: .development,
    entryPoint: "onboarding",
    useCategories: true,
    useSearch: true,
    merchantIds: [52],
    metadata: ["reference_token": "your-token"],
    customerConfiguration: customerConfiguration,
    locale: "es-US"                 // Optional BCP-47 language tag
)

Knot.open(configuration: config, delegate: self)

class MyViewController : UIViewController {

  func configureKnot() {
    let controller = Knot.createKnotViewController(configuration: session, delegate: delegate)
    view.addSubview(controller.view)
    addChild(controller)
  }

  ...
}

- (void)configureKnot {

    // 2) If self implements KnotEventDelegate, you can pass `self`; otherwise pass another object conforming to the protocol
    UIViewController *knotViewController =
        [Knot createKnotViewControllerWithConfiguration:config delegate:self];
    
    // 3) Add knotViewController as a child
    [self addChildViewController:knotViewController];
    [self.view addSubview:knotViewController.view];
    knotViewController.view.frame = self.view.bounds; // optionally size it
    [knotViewController didMoveToParentViewController:self];
}

class MyViewController: UIViewController, KnotEventDelegate {
    func onSuccess(merchant: String) {
        print("Merchant \(merchant) successfully authenticated.")
    }

    func onError(error: KnotError) {
        print("Error occurred: \(error.errorDescription)")
    }

    func onEvent(event: KnotEvent) {
        print("Received event: \(event.event)")
    }

    func onExit() {
        print("Knot session exited.")
    }
}

// Make sure to import the generated Swift header, e.g.:
#import <KnotAPI/KnotAPI-Swift.h>  // or @import KnotAPI;

@interface MyViewController () <KnotEventDelegate>

@end

@implementation MyViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // Your setup code here...
}

// MARK: - KnotEventDelegate Methods

- (void)onSuccessWithMerchant:(NSString *)merchant {
    NSLog(@"Merchant %@ successfully authenticated.", merchant);
}

- (void)onErrorWithError:(KnotError)error {
    // Because KnotError is an NS_ENUM (NSInteger), it does not expose the Swift-only
    // `errorDescription` property. You can switch on the enum or do something similar:
    NSString *errorDesc;
    switch (error) {
        case KnotErrorInvalidSession:
            errorDesc = @"Invalid session.";
            break;
        case KnotErrorExpiredSession:
            errorDesc = @"Session has expired.";
            break;
        case KnotErrorInvalidClientId:
            errorDesc = @"Invalid client ID.";
            break;
        case KnotErrorInternalError:
            errorDesc = @"An internal error occurred.";
            break;
    }
    NSLog(@"Error occurred: %@", errorDesc);
}

- (void)onEventWithEvent:(KnotEvent *)event {
    // event.event is a public NSString property on KnotEvent
    NSLog(@"Received event: %@", event.event);
}

- (void)onExit {
    NSLog(@"Knot session exited.");
}

func onError(error: KnotError) {
    switch error {
    case .invalidSession:
        print("Error: \(error.errorDescription)")
    case .expiredSession:
        print("Error: \(error.errorDescription)")
    case .invalidClientId:
        print("Error: \(error.errorDescription)")
    case .internalError:
        print("Error: \(error.errorDescription)")
	case .merchantIdNotFound:
        print("Error: \(error.errorDescription)")
	case .invalidCardName:
        print("Error: \(error.errorDescription)")
	case .invalidCustomerName:
        print("Error: \(error.errorDescription)")
	case .invalidLogoId:
        print("Error: \(error.errorDescription)")
	case .invalidLocale:
        print("Error: \(error.errorDescription)")
    }
}

- (void)onErrorWithError:(KnotError)error {
    // Because KnotError is an NS_ENUM (NSInteger), it does not expose the Swift-only
    // `errorDescription` property. You can switch on the enum or do something similar:
    NSString *errorDesc;
    switch (error) {
        case KnotErrorInvalidSession:
            errorDesc = @"The session is invalid.";
            break;
        case KnotErrorExpiredSession:
            errorDesc = @"The session has expired.";
            break;
        case KnotErrorInvalidClientId:
            errorDesc = @"The client ID is invalid.";
            break;
        case KnotErrorInternalError:
            errorDesc = @"An internal error occurred.";
            break;
		case KnotErrorMerchantIdNotFound:
            errorDesc = @"The merchant ID is required when product type = transaction_link.";
            break;
        case KnotErrorInvalidCardName:
            errorDesc = @"The card name is invalid.";
            break;
        case KnotErrorInvalidCustomerName:
            errorDesc = @"The customer name is invalid.";
            break;
        case KnotErrorInvalidLogoId:
            errorDesc = @"The logo ID is invalid.";
            break;
        case KnotErrorInvalidLocale:
            errorDesc = @"The locale is invalid.";
            break;
    }
    NSLog(@"Error occurred: %@", errorDesc);
}

/// Represents a Knot event received during user interaction within the Knot SDK.
@objc public class KnotEvent {

    /// The environment the event emitted from
    @objc public let evironment: Environment
    
    /// The product the event emitted from
    @objc public let product: Product
    
    /// The primary event code.
    @objc public let event: String
    
    /// The merchant associated with the event (if applicable).
    @objc public let merchant: String?

	/// The merchant ID associated with the event (if applicable).
    @objc public let merchantId: String?
    
    /// Additional metadata related to the event, stored as an Objective-C compatible dictionary.
    @objc public let metaData: NSDictionary
    
    /// The identifier associated with this event.
    @objc public let taskId: String?
    
...
}

let sdkVersion = Knot.SDKVersion()
print("Knot SDK Version: \(sdkVersion ?? "Unknown")")

NSString *sdkVersion = [Knot SDKVersion];
NSLog(@"Knot SDK Version: %@", sdkVersion ?: @"Unknown");

Knot.close()

[Knot close];