Quickstart

pip install contactsmanager

from contactsmanager import ContactsManagerClient

# Initialize the client with your API credentials
client = ContactsManagerClient(
    api_key="your-api-key",
    api_secret="your-api-secret",
    org_id="your-org-id"
)

# Generate a token for a user
token_data = client.generate_token(
    user_id="user-123",
    device_info={"device_name": "iPhone 15", "os_version": "iOS 17.5"},
    expiration_seconds=86400  # 24 hours
)

# The token to be used in client SDK initialization
token = token_data["token"]

npm install @contactsmanager/server

import { ContactsManagerClient } from '@contactsmanager/server';

// Initialize the client with your API credentials
const client = new ContactsManagerClient({
  apiKey: 'your-api-key',
  apiSecret: 'your-api-secret',
  orgId: 'your-org-id'
});

// Generate a token for a user
async function generateUserToken() {
  const tokenData = await client.generateToken({
    userId: 'user-123',
    deviceInfo: { deviceName: 'iPhone 15', osVersion: 'iOS 17.5' },
    expirationSeconds: 86400 // 24 hours
  });
  
  // The token to be used in client SDK initialization
  const token = tokenData.token;
  return token;
}

// supabase/functions/generate-token/index.ts
import { serve } from 'https://deno.land/std@0.168.0/http/server.ts'
import * as jose from 'https://deno.land/x/jose@v4.14.1/index.ts'

const corsHeaders = {
  'Access-Control-Allow-Origin': '*',
  'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
}

serve(async (req) => {
  // Handle CORS preflight requests
  if (req.method === 'OPTIONS') {
    return new Response('ok', { headers: corsHeaders })
  }

  try {
    const { user_id, device_info } = await req.json()
    
    // Get secrets from environment variables
    const apiKey = Deno.env.get('CONTACTS_MANAGER_API_KEY')
    const apiSecret = Deno.env.get('CONTACTS_MANAGER_API_SECRET')
    const orgId = Deno.env.get('CONTACTS_MANAGER_ORG_ID')
    
    if (!apiKey || !apiSecret || !orgId) {
      throw new Error('Missing required environment variables')
    }

    // Create JWT payload
    const now = Math.floor(Date.now() / 1000)
    const payload = {
      iss: orgId,
      org_id: orgId,
      api_key: apiKey,
      user_id: user_id,
      device_info: device_info || {},
      jti: crypto.randomUUID(),
      iat: now,
      exp: now + 86400 // 24 hours
    }

    // Generate JWT token
    const token = await new jose.SignJWT(payload)
      .setProtectedHeader({ alg: 'HS256' })
      .sign(new TextEncoder().encode(apiSecret))

    return new Response(
      JSON.stringify({ token, expires_at: payload.exp }),
      { headers: { ...corsHeaders, 'Content-Type': 'application/json' } }
    )
  } catch (error) {
    return new Response(
      JSON.stringify({ error: error.message }),
      { status: 400, headers: { ...corsHeaders, 'Content-Type': 'application/json' } }
    )
  }
})

dependencies: [
    .package(url: "https://github.com/arpwal/contactsmanager-ios.git", from: "<latest-version>")
]

import ContactsManager

// Initialize the SDK with the token generated from your server
try await ContactsService.shared.initialize(
    withAPIKey: "your-api-key",
    token: "user-auth-token",  // From server token generation
    userInfo: userInfo
)