@jobsphere/sdk v3.2.1

# Using npm
npm install @jobsphere/sdk

# Using yarn
yarn add @jobsphere/sdk

# Using pnpm
pnpm add @jobsphere/sdk

# Using bun
bun add @jobsphere/sdk

import { JobSphere } from "@jobsphere/sdk";

// Initialize the SDK
const jobsphere = new JobSphere({
  apiKey: process.env.JOBSHERE_API_KEY,
  environment: "production" // or "sandbox"
});

// Search for jobs
const jobs = await jobsphere.jobs.search({
  query: "Senior Software Engineer",
  location: "San Francisco, CA",
  remote: true,
  limit: 20,
  sortBy: "relevance"
});

console.log(`Found ${jobs.total} jobs`);

// Iterate through results
for (const job of jobs.data) {
  console.log(`- ${job.title} at ${job.company.name}`);
}

import { JobSphere } from "@jobsphere/sdk";

// Option 1: Pass API key directly
const client = new JobSphere({
  apiKey: "js_live_sk_abc123..."
});

// Option 2: Use environment variable (recommended)
const client = new JobSphere({
  apiKey: process.env.JOBSHERE_API_KEY
});

// Option 3: Use a secret manager
import { secretManager } from "@your-app/secrets";
const client = new JobSphere({
  apiKey: await secretManager.get("jobsphere_api_key")
});

import { JobSphere, OAuthConfig } from "@jobsphere/sdk";

const oauthConfig: OAuthConfig = {
  clientId: "your_client_id",
  clientSecret: "your_client_secret",
  redirectUri: "https://yourapp.com/callback",
  scopes: ["jobs:read", "jobs:write", "applications:write"]
};

const client = new JobSphere({
  auth: oauthConfig
});

// Generate authorization URL
const authUrl = client.oauth.getAuthorizationUrl();
console.log(`Visit: ${authUrl}`);

// Exchange code for tokens
const tokens = await client.oauth.exchangeCode("authorization_code");
console.log("Access token:", tokens.accessToken);

// Advanced search with filters
const results = await jobsphere.jobs.search({
  query: "React Developer",
  location: "New York, NY",
  radius: 25, // miles
  remote: ["remote", "hybrid"],
  experienceLevel: "senior",
  salaryMin: 120000,
  postedWithin: "7d",
  categories: ["engineering", "frontend"],
  limit: 50,
  page: 1,
  sortBy: "posted_at",
  sortOrder: "desc"
});

console.log(results.total);     // 1243
console.log(results.page);     // 1
console.log(results.perPage);  // 50
console.log(results.hasMore);  // true

const job = await jobsphere.jobs.get("job_2xK9mPqR7sL3");

console.log(job.title);              // "Senior React Developer"
console.log(job.company.name);      // "TechCorp Inc."
console.log(job.salary.min);         // 140000
console.log(job.salary.currency);    // "USD"
console.log(job.location.city);     // "San Francisco"
console.log(job.isRemote);          // true
console.log(job.tags);              // ["react", "typescript", "nextjs"]

const newJob = await jobsphere.jobs.create({
  title: "Full Stack Engineer",
  companyId: "comp_8xR2nVtW4mK1",
  description: "We're looking for a talented...",
  location: {
    city: "Austin",
    state: "TX",
    country: "US"
  },
  remote: "hybrid",
  salary: {
    min: 130000,
    max: 170000,
    currency: "USD",
    period: "yearly"
  },
  categories: ["engineering", "fullstack"],
  tags: ["node", "react", "postgres"],
  experienceLevel: "mid",
  employmentType: "full_time",
  expiresAt: "2025-03-15T00:00:00Z"
});

console.log(`Created job: ${newJob.id}`);

// Get company details
const company = await jobsphere.companies.get("comp_8xR2nVtW4mK1");

console.log(company.name);          // "TechCorp Inc."
console.log(company.website);       // "https://techcorp.com"
console.log(company.size);          // "201-500"
console.log(company.industry);      // "Technology"
console.log(company.activeJobs);    // 12

// Update company profile
const updated = await jobsphere.companies.update("comp_8xR2nVtW4mK1", {
  description: "Updated company description...",
  logoUrl: "https://cdn.example.com/logo.png",
  socialLinks: {
    linkedin: "https://linkedin.com/company/techcorp",
    twitter: "https://twitter.com/techcorp"
  }
});

// Apply to a job
const application = await jobsphere.applications.create({
  jobId: "job_2xK9mPqR7sL3",
  candidate: {
    name: "Jane Doe",
    email: "jane@example.com",
    linkedin: "https://linkedin.com/in/janedoe"
  },
  resume: {
    url: "https://cdn.example.com/resume.pdf",
    mimeType: "application/pdf"
  },
  coverLetter: "I am excited to apply for...",
  status: "submitted"
});

console.log(`Application ID: ${application.id}`);

// Track application status
const status = await jobsphere.applications.getStatus(application.id);
console.log(`Status: ${status.stage}`); // "screening", "interview", "offered"

// Get job analytics
const analytics = await jobsphere.analytics.getJobMetrics("job_2xK9mPqR7sL3");

console.log(analytics.views);       // 1,247
console.log(analytics.applications); // 42
console.log(analytics.clickRate);   // 0.034
console.log(analytics.topSources);  // [{ source: "linkedin", count: 18 }]

// Market salary data
const marketData = await jobsphere.analytics.getSalaryInsights({
  role: "Software Engineer",
  location: "San Francisco",
  experience: "senior"
});

console.log(marketData.median);    // 175000
console.log(marketData.p25);       // 145000
console.log(marketData.p75);       // 210000

import { verifyWebhook, WebhookEvent } from "@jobsphere/sdk";

// Express.js example
app.post("/webhooks/jobsphere", async (req, res) => {
  const signature = req.headers["x-jobsphere-signature"] as string;

  try {
    const event: WebhookEvent = await verifyWebhook(
      req.body,
      signature,
      process.env.JOBSHERE_WEBHOOK_SECRET
    );

    switch (event.type) {
      case "application.submitted":
        await notifyHiringTeam(event.data);
        break;
      case "job.expiring":
        await sendExpiryReminder(event.data);
        break;
      case "application.status_changed":
        await updateCandidateDashboard(event.data);
        break;
    }

    res.status(200).json({ received: true });
  } catch (error) {
    res.status(400).json({ error: "Invalid signature" });
  }
});

import {
  JobSphereError,
  AuthenticationError,
  RateLimitError,
  NotFoundError,
  ValidationError
} from "@jobsphere/sdk";

try {
  const job = await jobsphere.jobs.get("job_invalid_id");
} catch (error) {
  if (error instanceof NotFoundError) {
    console.error(`Job not found: ${error.jobId}`);
  } else if (error instanceof RateLimitError) {
    console.error(`Retry after ${error.retryAfter} seconds`);
  } else if (error instanceof AuthenticationError) {
    console.error("Invalid API key");
  } else if (error instanceof ValidationError) {
    console.error("Validation failed:", error.fields);
  } else if (error instanceof JobSphereError) {
    console.error(`API Error: ${error.code} - ${error.message}`);
  } else {
    console.error("Unexpected error", error);
  }
}

# Clone the repository
git clone https://github.com/jobsphere/sdk-js.git
cd sdk-js

# Install dependencies
npm install

# Run tests
npm run test

# Build the package
npm run build

# Generate TypeScript types
npm run generate:types