@brownandroot/api 0.9.0 → 0.11.0

package/README.md

@@ -1,6 +1,6 @@
 # @brownandroot/api
 
-TypeScript client for the Brown & Root APIHub data service. Provides read-only access to company data and an LLM chat endpoint powered by Azure AI Foundry.
+TypeScript client for the Brown & Root APIHub data service. Provides read-only access to company data (employees, business units, cost codes, pay types, work orders, job type/job steps) and an LLM chat endpoint powered by Azure AI Foundry.
 
 ## Installation
 
@@ -25,11 +25,12 @@ const client = new ApiHubClient({
 
 ```typescript
 const employees = await client.getEmployees()
-const employee = await client.getEmployee(12345)
+const dropdown = await client.getEmployeesDropdown() // { value, label }[]
+const employee = await client.getEmployee('12345')
 const results = await client.searchByName('John')
 const results = await client.searchByEmail('john@example.com')
-const reports = await client.getBySupervisor(12345)
-const chain = await client.getSupervisorChain(12345)
+const reports = await client.getBySupervisor('12345')
+const chain = await client.getSupervisorChain('12345')
 const { jde, employee } = await client.getJdeFromEmail('john@example.com')
 ```
 
@@ -37,6 +38,7 @@ const { jde, employee } = await client.getJdeFromEmail('john@example.com')
 
 ```typescript
 const units = await client.getBusinessUnits()
+const dropdown = await client.getBusinessUnitsDropdown() // { value, label }[]
 const unit = await client.getBusinessUnit('BU001')
 ```
 
@@ -44,6 +46,7 @@ const unit = await client.getBusinessUnit('BU001')
 
 ```typescript
 const codes = await client.getCostcodes()
+const dropdown = await client.getCostcodesDropdown() // { value, label }[]
 const code = await client.getCostcode('CC001')
 ```
 
@@ -51,6 +54,7 @@ const code = await client.getCostcode('CC001')
 
 ```typescript
 const types = await client.getPaytypes()
+const dropdown = await client.getPaytypesDropdown() // { value, label, payClass }[]
 const type = await client.getPaytype('PT001')
 ```
 
@@ -58,9 +62,18 @@ const type = await client.getPaytype('PT001')
 
 ```typescript
 const orders = await client.getWorkorders()
+const dropdown = await client.getWorkordersDropdown() // { value, label }[]
 const order = await client.getWorkorder('WO001')
 ```
 
+### Job Type / Job Steps
+
+```typescript
+const items = await client.getJobtypejobsteps()
+const dropdown = await client.getJobtypejobstepsDropdown() // { value, label }[]
+const item = await client.getJobtypejobstep('JTJS001')
+```
+
 ### LLM
 
 ```typescript
@@ -89,11 +102,14 @@ import type {
 	Costcode,
 	Paytype,
 	Workorder,
+	Jobtypejobstep,
 	LlmLog,
 	ChatMessage,
 	ChatRequest,
 	ChatResponse,
 	ApiHubClientOptions,
+	DropdownOption,
+	PaytypeDropdownOption,
 } from '@brownandroot/api'
 ```
 
@@ -103,7 +119,7 @@ Methods throw an `Error` when the API returns a non-OK response. The error messa
 
 ```typescript
 try {
-	const emp = await client.getEmployee(99999)
+	const emp = await client.getEmployee('99999')
 } catch (err) {
 	console.error(err.message) // "Employee not found"
 }

package/dist/index.d.ts

@@ -45,6 +45,9 @@ export interface DropdownOption {
     value: number | string;
     label: string;
 }
+export interface PaytypeDropdownOption extends DropdownOption {
+    payClass: string | null;
+}
 /**
  * LLM log entry matching the API response shape.
  */
@@ -171,7 +174,7 @@ export declare class ApiHubClient {
     searchByEmail(email: string): Promise<Employee[]>;
     /** Get the supervisor chain above an employee */
     getSupervisorChain(employeeId: string): Promise<Employee[]>;
-    /** Look up JDE number and employee data from email (with JDEService/CoreService fallback) */
+    /** Look up JDE number and employee data from email (with itime fallback) */
     getJdeFromEmail(email: string): Promise<{
         jde: string | null;
         employee: Employee | null;
@@ -187,10 +190,12 @@ export declare class ApiHubClient {
     getCostcodesDropdown(): Promise<DropdownOption[]>;
     getCostcode(id: string): Promise<Costcode>;
     getPaytypes(): Promise<Paytype[]>;
-    getPaytypesDropdown(): Promise<DropdownOption[]>;
+    getPaytypesDropdown(): Promise<PaytypeDropdownOption[]>;
     getPaytype(id: string): Promise<Paytype>;
     getWorkorders(): Promise<Workorder[]>;
     getWorkordersDropdown(): Promise<DropdownOption[]>;
+    /** Get work orders for a specific business unit, formatted for dropdown controls */
+    getWorkordersDropdownByBu(businessUnitId: string): Promise<DropdownOption[]>;
     getWorkorder(id: string): Promise<Workorder>;
     getJobtypejobsteps(): Promise<Jobtypejobstep[]>;
     getJobtypejobstepsDropdown(): Promise<DropdownOption[]>;

package/dist/index.js

@@ -6,12 +6,20 @@ export class ApiHubClient {
         this.apiKey = options.apiKey;
     }
     async request(path) {
-        const res = await fetch(`${this.baseUrl}${path}`, {
-            headers: { 'x-api-key': this.apiKey },
-        });
+        let res;
+        try {
+            res = await fetch(`${this.baseUrl}${path}`, {
+                headers: { 'x-api-key': this.apiKey },
+            });
+        }
+        catch {
+            throw new Error(`APIHub unavailable: ${this.baseUrl}${path}`);
+        }
         if (!res.ok) {
-            const body = await res.json().catch(() => ({}));
-            throw new Error(body.error ?? `Request failed: ${res.status}`);
+            const body = await res.json().catch(() => null);
+            const message = (body && typeof body === 'object' && 'error' in body && typeof body.error === 'string' ? body.error : null) ??
+                `Request failed: ${res.status} ${res.statusText}`;
+            throw new Error(message);
         }
         return res.json();
     }
@@ -43,7 +51,7 @@ export class ApiHubClient {
     async getSupervisorChain(employeeId) {
         return this.request(`/employees/${encodeURIComponent(employeeId)}/supervisor-chain`);
     }
-    /** Look up JDE number and employee data from email (with JDEService/CoreService fallback) */
+    /** Look up JDE number and employee data from email (with itime fallback) */
     async getJdeFromEmail(email) {
         return this.request(`/employees/jde-from-email/${encodeURIComponent(email)}`);
     }
@@ -56,17 +64,25 @@ export class ApiHubClient {
     }
     /** Send a chat completion request to the LLM */
     async chat(request) {
-        const res = await fetch(`${this.baseUrl}/llm/chat`, {
-            method: 'POST',
-            headers: {
-                'x-api-key': this.apiKey,
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(request),
-        });
+        let res;
+        try {
+            res = await fetch(`${this.baseUrl}/llm/chat`, {
+                method: 'POST',
+                headers: {
+                    'x-api-key': this.apiKey,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(request),
+            });
+        }
+        catch {
+            throw new Error(`APIHub unavailable: ${this.baseUrl}/llm/chat`);
+        }
         if (!res.ok) {
-            const body = await res.json().catch(() => ({}));
-            throw new Error(body.error ?? `Request failed: ${res.status}`);
+            const body = await res.json().catch(() => null);
+            const message = (body && typeof body === 'object' && 'error' in body && typeof body.error === 'string' ? body.error : null) ??
+                `Request failed: ${res.status} ${res.statusText}`;
+            throw new Error(message);
         }
         return res.json();
     }
@@ -115,6 +131,10 @@ export class ApiHubClient {
     async getWorkordersDropdown() {
         return this.request('/workorders/dropdown');
     }
+    /** Get work orders for a specific business unit, formatted for dropdown controls */
+    async getWorkordersDropdownByBu(businessUnitId) {
+        return this.request(`/workorders/by-bu/${encodeURIComponent(businessUnitId)}/dropdown`);
+    }
     async getWorkorder(id) {
         return this.request(`/workorders/${encodeURIComponent(id)}`);
     }

package/package.json

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