@brownandroot/api 0.2.4 → 0.3.0

package/README.md

@@ -0,0 +1,77 @@
+# @brownandroot/api
+
+TypeScript client for the Brown & Root APIHub employee data service.
+
+## Installation
+
+```bash
+npm install @brownandroot/api
+```
+
+## Setup
+
+```typescript
+import { ApiHubClient } from '@brownandroot/api'
+
+const client = new ApiHubClient({
+	baseUrl: 'https://your-apihub-url.com',
+	apiKey: 'your-api-key',
+})
+```
+
+## Usage
+
+### Get all employees
+
+```typescript
+const employees = await client.getEmployees()
+```
+
+### Get a single employee
+
+```typescript
+const employee = await client.getEmployee(12345)
+```
+
+### Search by name
+
+Case-insensitive partial match:
+
+```typescript
+const results = await client.searchByName('John')
+```
+
+### Get employees by supervisor
+
+```typescript
+const reports = await client.getBySupervisor(12345)
+```
+
+### Get supervisor chain
+
+Returns the chain of supervisors above an employee (excludes the employee themselves):
+
+```typescript
+const chain = await client.getSupervisorChain(12345)
+// [directSupervisor, theirSupervisor, ...]
+```
+
+## Types
+
+The package exports the `Employee` interface and `ApiHubClientOptions`:
+
+```typescript
+import type { Employee, ApiHubClientOptions } from '@brownandroot/api'
+```
+
+## Error Handling
+
+Methods throw an `Error` when the API returns a non-OK response. The error message contains the server's error detail or the HTTP status code.
+
+```typescript
+try {
+	const emp = await client.getEmployee(99999)
+} catch (err) {
+	console.error(err.message) // "Employee not found"
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@brownandroot/api",
-	"version": "0.2.4",
+	"version": "0.3.0",
 	"type": "module",
 	"repository": {
 		"type": "git",