@roughapp/sdk

A TypeScript SDK for interacting with the Rough API.

Installation

npm install @roughapp/sdk

Authorization

All API requests require an Authorization header with a Bearer token. When making requests, include your API key like this:

import { client, getDocumentList } from '@roughapp/sdk'

// Option 1: use the same API key for all requests
client.setConfig({ auth: () => 'your-api-key' })

// Option 2: manually pass an API key
const response = await getDocumentList({
    auth: 'your-api-key'
})

Available Endpoints

Documents

// Get all documents
const documents = await getDocumentList({
  query: { includeArchived: 'false' }
})

// Get a specific document
const document = await getDocument({
  path: { documentId: "123" }
})

Notes

• getNoteList() - Get all notes
• createNote() - Create a new note
• getNote() - Get a specific note
• deleteNote() - Delete a note

People

• getPersonList() - List all people
• createPerson() - Create a new person
• getPerson() - Get a specific person
• getPersonByEmail() - Find person by email
• upsertPerson() - Create or update a person

Other Resources

• getWorkspace() - Get workspace details
• getContentList() - List all content
• getLabelList() - List all labels
• getReferenceList() - List all references
• getUserList() - List all users

OAuth2 Authentication

For OAuth2 authentication flows:

import { createRoughOAuth2Provider } from '@roughapp/sdk'

const oauth2 = createRoughOAuth2Provider({
  baseUrl: 'https://in.rough.app',
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  redirectUri: 'YOUR_REDIRECT_URI'
})

Uploading Images

import { createPendingTusUpload, uploadFile } from '@roughapp/sdk'

const result = createPendingTusUpload()
if (result.error || !result.data) { /* ... */ }
const uploadToken = result.data.token

const uploadId = await uploadFile({
    uploadToken,
    data: Buffer.from(...),
    fileName: 'image.jpg',
    mimeType: 'image/jpeg',
})

For detailed API documentation and request/response types, please refer to the source code or contact Rough support.