Mobile apps

dependencies: [
    .package(url: "https://github.com/vrsoai/verso-connect-ios", from: "0.1.2"),
],
targets: [
    .target(name: "YourApp", dependencies: ["VersoConnect"]),
]

import VersoConnect

// From a UIViewController, after fetching `link` from your backend
do {
    let connection = try await VersoConnect.present(link: link, from: self)
    // connection.connectionId; your backend also receives connection.created
} catch VersoConnectError.cancelled {
    // the user closed the sheet
} catch {
    // see Errors below
}

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven("https://jitpack.io")
    }
}

// app/build.gradle.kts
dependencies {
    implementation("com.github.vrsoai:verso-connect-android:0.1.2")
}

import ai.tryverso.connect.VersoConnect
import ai.tryverso.connect.VersoConnectException

// From an Activity, after fetching `link` from your backend
VersoConnect.present(this, Uri.parse(link)) { result ->
    result.onSuccess { connection ->
        // connection.connectionId; your backend also receives connection.created
    }.onFailure { e ->
        when (e) {
            is VersoConnectException.Cancelled -> { /* the user closed the screen */ }
            is VersoConnectException.Rejected -> { /* e.status, e.message: sign a new link */ }
            else -> { /* network */ }
        }
    }
}

import { signLink } from "@versoai/core";

interface Env {
  APP_ID: string;      // your Verso app id
  APP_SECRET: string;  // your Verso app secret, kept as a secret binding
}

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const url = new URL(request.url);
    if (url.pathname !== "/connect-link" || request.method !== "POST") {
      return new Response("Not found", { status: 404 });
    }

    // Authenticate the caller as you do for the rest of your API, and
    // derive userRef from that user: the app never chooses it.
    const user = await authenticate(request);
    if (!user) return new Response("Unauthorized", { status: 401 });

    const link = await signLink(
      {
        appId: env.APP_ID,
        userRef: user.id,
        scopes: ["conversations:read"],
        purpose: "connect",
        expiresInSeconds: 900,
      },
      env.APP_SECRET,
    );
    return Response.json({ url: link.url });
  },
};

npm install @versoai/react-native-connect
cd ios && pod install

import { VersoConnect, VersoConnectError } from "@versoai/react-native-connect";

// After fetching `url` from your backend
try {
  const { connectionId } = await VersoConnect.present(url);
  // connected; your backend also receives connection.created
} catch (e) {
  if (e instanceof VersoConnectError && e.code === "cancelled") return;
  throw e;
}

dependencies:
  verso_connect: ^0.1.3

import 'package:verso_connect/verso_connect.dart';

// After fetching `link` from your backend
try {
  final connection = await VersoConnect.present(Uri.parse(link));
  // connection.connectionId; your backend also receives connection.created
} on VersoConnectException catch (e) {
  if (e.isCancelled) return;
  rethrow;
}