Auth & API Keys

1
const session = await r.auth.signUp({
2
  name: 'Alice Johnson',
3
  email: 'alice@example.com',
4
  password: 'Example-Passw0rd!',
5
});
6
7
console.log(session.token);        // Session token — store this securely
8
console.log(session.user.id);
9
console.log(session.user.name);
10
console.log(session.user.email);

1
interface AuthSession {
2
  token: string;
3
  user: {
4
    id: string;
5
    name: string;
6
    email: string;
7
    image: string | null;
8
  };
9
}

1
const session = await r.auth.signIn({
2
  email: 'alice@example.com',
3
  password: 'Example-Passw0rd!',
4
});
5
6
console.log(session.token);
7
console.log(session.user.name);

1
import { AuthenticationError, ValidationError } from '@recursiv/sdk';
2
3
try {
4
  const session = await r.auth.signIn({
5
    email: 'alice@example.com',
6
    password: 'wrongpassword',
7
  });
8
} catch (err) {
9
  if (err instanceof AuthenticationError) {
10
    // err.code === 'invalid_credentials'
11
    console.error('Invalid email or password');
12
  }
13
}

1
const session = await r.auth.getSession(storedToken);
2
3
if (session) {
4
  console.log(`Logged in as ${session.user.name}`);
5
} else {
6
  console.log('Session expired — redirect to login');
7
}

1
await r.auth.signOut(sessionToken);

1
const apiKey = await r.auth.createApiKey(
2
  {
3
    name: 'CI/CD Pipeline',
4
    scopes: ['projects:read', 'projects:write'],
5
  },
6
  sessionToken,
7
);
8
9
console.log(apiKey.key);     // 'sk_live_...' — only shown once!
10
console.log(apiKey.id);
11
console.log(apiKey.name);
12
console.log(apiKey.prefix);  // 'sk_live_abc...' (for identification)
13
console.log(apiKey.scopes);

1
import { Recursiv } from '@recursiv/sdk';
2
3
const anon = new Recursiv({ anonymous: true });
4
5
const { apiKey, user, session } = await anon.auth.signUpAndCreateKey(
6
  { name: 'Bob Builder', email: 'bob@example.com', password: 'Example-Passw0rd!' },
7
  { name: 'my-app', scopes: ['projects:read', 'projects:write'] },
8
);
9
10
const r = new Recursiv({ apiKey });

1
import { Recursiv } from '@recursiv/sdk';
2
3
// Step 1: Initialize without an API key (for auth only)
4
const authClient = new Recursiv({
5
  allowNoKey: true, // Auth methods don't need an API key
6
});
7
8
// Step 2: Sign up
9
const session = await authClient.auth.signUp({
10
  name: 'Bob Builder',
11
  email: 'bob@example.com',
12
  password: 'Example-Passw0rd!',
13
});
14
15
console.log('Signed up as:', session.user.name);
16
17
// Step 3: Create an API key using the session token
18
const apiKey = await authClient.auth.createApiKey(
19
  {
20
    name: 'Development',
21
    scopes: [
22
      'projects:read',
23
      'projects:write',
24
      'agents:read',
25
      'agents:write',
26
    ],
27
  },
28
  session.token,
29
);
30
31
console.log('API Key created:', apiKey.prefix);
32
// Store apiKey.key securely — it's only shown once!
33
34
// Step 4: Use the API key for all future SDK operations
35
const r = new Recursiv({ apiKey: apiKey.key });
36
37
const { data: me } = await r.users.me();
38
console.log('Authenticated as:', me.name);