@brownandroot/api 0.5.0 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
 # @brownandroot/api
 
-TypeScript client for the Brown & Root APIHub employee data service.
+Read-only TypeScript client for the Brown & Root APIHub data service. All methods are GET-only — no create, update, or delete operations are supported.
 
 ## Installation
 
@@ -21,47 +21,67 @@ const client = new ApiHubClient({
 
 ## Usage
 
-### Get all employees
+### Employees
 
 ```typescript
 const employees = await client.getEmployees()
+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 { jde, employee } = await client.getJdeFromEmail('john@example.com')
 ```
 
-### Get a single employee
+### Business Units
 
 ```typescript
-const employee = await client.getEmployee(12345)
+const units = await client.getBusinessUnits()
+const unit = await client.getBusinessUnit('BU001')
 ```
 
-### Search by name
-
-Case-insensitive partial match:
+### Cost Codes
 
 ```typescript
-const results = await client.searchByName('John')
+const codes = await client.getCostcodes()
+const code = await client.getCostcode('CC001')
 ```
 
-### Get employees by supervisor
+### Pay Types
 
 ```typescript
-const reports = await client.getBySupervisor(12345)
+const types = await client.getPaytypes()
+const type = await client.getPaytype('PT001')
 ```
 
-### Get supervisor chain
+### Work Orders
+
+```typescript
+const orders = await client.getWorkorders()
+const order = await client.getWorkorder('WO001')
+```
 
-Returns the chain of supervisors above an employee (excludes the employee themselves):
+### LLM Logs
 
 ```typescript
-const chain = await client.getSupervisorChain(12345)
-// [directSupervisor, theirSupervisor, ...]
+const logs = await client.getLlmLogs()
 ```
 
 ## Types
 
-The package exports the `Employee` interface and `ApiHubClientOptions`:
+The package exports interfaces for all resource types:
 
 ```typescript
-import type { Employee, ApiHubClientOptions } from '@brownandroot/api'
+import type {
+	Employee,
+	BusinessUnit,
+	Costcode,
+	Paytype,
+	Shift,
+	Workorder,
+	LlmLog,
+	ApiHubClientOptions,
+} from '@brownandroot/api'
 ```
 
 ## Error Handling

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * Employee type matching the API response shape.
  */
 export interface Employee {
-    employeeId: number | null;
+    employeeId: string;
     name: string | null;
     email: string | null;
     badgeNumber: string | null;
@@ -26,22 +26,25 @@ export interface Employee {
     reportingLevel: string | null;
     recordType: string | null;
     payCycleCode: string | null;
-    dateTimeStamps: string | null;
     benefitGroup: string | null;
-    supervisor: number | null;
+    supervisor: string | null;
     adjustedServiceDate: string | null;
     departmentCode: string | null;
-    dateUpdated: string | null;
     nccerNumber: string | null;
-    mentor: number | null;
+    mentor: string | null;
     source: string | null;
     createdAt: string | null;
+    updatedAtJulian: number | null;
     updatedAt: string | null;
 }
 export interface ApiHubClientOptions {
     baseUrl: string;
     apiKey: string;
 }
+export interface DropdownOption {
+    value: number | string;
+    label: string;
+}
 /**
  * LLM log entry matching the API response shape.
  */
@@ -55,40 +58,86 @@ export interface LlmLog {
     totalTokens: number | null;
     createdAt: string | null;
 }
-export interface CreateLlmLogInput {
-    source: string;
-    user: string;
-    function?: string;
-    tokensIn?: number;
-    tokensOut?: number;
-    totalTokens?: number;
+export interface BusinessUnit {
+    id: string;
+    companyId: string;
+    description: string;
+    clientId: string | null;
+    clientDescription: string | null;
+    workOrderRequired: boolean;
+    isActive: boolean;
+    expirationDate: string | null;
+    createdBy: string;
+    createdAt: string;
+    updatedBy: string | null;
+    updatedAt: string | null;
+    subsector: string | null;
 }
-export interface UpdateLlmLogInput {
-    source?: string;
-    user?: string;
-    function?: string;
-    tokensIn?: number;
-    tokensOut?: number;
-    totalTokens?: number;
+export interface Costcode {
+    id: string;
+    jdeCostCode: string | null;
+    description: string | null;
+    businessUnitId: string;
+    objectAccount: string | null;
+    suba: string | null;
+    isActive: boolean;
+    expirationDate: string | null;
+    createdBy: string;
+    createdAt: string;
+    updatedBy: string | null;
+    updatedAt: string | null;
+    billFlag: string | null;
+    entryEffectiveDate: string | null;
+    entryFlag: boolean;
+}
+export interface Paytype {
+    id: string;
+    companyCode: string | null;
+    payClass: string | null;
+    description: string;
+    isActive: boolean;
+    sortOrder: string | null;
+    objectAccount: string | null;
+    category: string | null;
+    perDiemPayType: boolean;
+    type: string | null;
+}
+export interface Workorder {
+    id: string;
+    businessUnitId: string;
+    costCodeId: string | null;
+    clientWorkOrderId: string | null;
+    description: string | null;
+    completed: boolean;
+    area: string | null;
+    isActive: boolean;
+    expirationDate: string | null;
+    createdBy: string;
+    createdAt: string;
+    updatedBy: string | null;
+    updatedAt: string | null;
+    parentWorkOrder: string | null;
+    workOrder2: string | null;
 }
 export declare class ApiHubClient {
     private baseUrl;
     private apiKey;
     constructor(options: ApiHubClientOptions);
     private request;
-    private requestWithBody;
     /** Get all employees */
     getEmployees(): Promise<Employee[]>;
+    /** Get employees formatted for dropdown controls */
+    getEmployeesDropdown(): Promise<DropdownOption[]>;
     /** Get a single employee by employeeId */
-    getEmployee(employeeId: number): Promise<Employee>;
+    getEmployee(employeeId: string): Promise<Employee>;
     /** Search employees by name (case-insensitive partial match) */
     searchByName(name: string): Promise<Employee[]>;
     /** Get all employees reporting to a supervisor */
-    getBySupervisor(supervisorId: number): Promise<Employee[]>;
+    getBySupervisor(supervisorId: string): Promise<Employee[]>;
     /** Search employees by email (case-insensitive partial match) */
     searchByEmail(email: string): Promise<Employee[]>;
     /** Get the supervisor chain above an employee */
-    getSupervisorChain(employeeId: number): Promise<Employee[]>;
+    getSupervisorChain(employeeId: string): Promise<Employee[]>;
     /** Look up JDE number and employee data from email (with JDEService/CoreService fallback) */
     getJdeFromEmail(email: string): Promise<{
         jde: string | null;
@@ -96,8 +145,16 @@ export declare class ApiHubClient {
     }>;
     /** List all LLM log entries (newest first) */
     getLlmLogs(): Promise<LlmLog[]>;
-    /** Create a new LLM log entry */
-    createLlmLog(input: CreateLlmLogInput): Promise<LlmLog>;
-    /** Update an existing LLM log entry */
-    updateLlmLog(id: number, input: UpdateLlmLogInput): Promise<LlmLog>;
+    getBusinessUnits(): Promise<BusinessUnit[]>;
+    getBusinessUnitsDropdown(): Promise<DropdownOption[]>;
+    getBusinessUnit(id: string): Promise<BusinessUnit>;
+    getCostcodes(): Promise<Costcode[]>;
+    getCostcodesDropdown(): Promise<DropdownOption[]>;
+    getCostcode(id: string): Promise<Costcode>;
+    getPaytypes(): Promise<Paytype[]>;
+    getPaytypesDropdown(): Promise<DropdownOption[]>;
+    getPaytype(id: string): Promise<Paytype>;
+    getWorkorders(): Promise<Workorder[]>;
+    getWorkordersDropdown(): Promise<DropdownOption[]>;
+    getWorkorder(id: string): Promise<Workorder>;
 }

package/dist/index.js

@@ -15,25 +15,17 @@ export class ApiHubClient {
         }
         return res.json();
     }
-    async requestWithBody(path, method, body) {
-        const res = await fetch(`${this.baseUrl}${path}`, {
-            method,
-            headers: { 'x-api-key': this.apiKey, 'Content-Type': 'application/json' },
-            body: JSON.stringify(body),
-        });
-        if (!res.ok) {
-            const respBody = await res.json().catch(() => ({}));
-            throw new Error(respBody.error ?? `Request failed: ${res.status}`);
-        }
-        return res.json();
-    }
     /** Get all employees */
     async getEmployees() {
         return this.request('/employees');
     }
+    /** Get employees formatted for dropdown controls */
+    async getEmployeesDropdown() {
+        return this.request('/employees/dropdown');
+    }
     /** Get a single employee by employeeId */
     async getEmployee(employeeId) {
-        return this.request(`/employees/${employeeId}`);
+        return this.request(`/employees/${encodeURIComponent(employeeId)}`);
     }
     /** Search employees by name (case-insensitive partial match) */
     async searchByName(name) {
@@ -41,7 +33,7 @@ export class ApiHubClient {
     }
     /** Get all employees reporting to a supervisor */
     async getBySupervisor(supervisorId) {
-        return this.request(`/employees/by-supervisor/${supervisorId}`);
+        return this.request(`/employees/by-supervisor/${encodeURIComponent(supervisorId)}`);
     }
     /** Search employees by email (case-insensitive partial match) */
     async searchByEmail(email) {
@@ -49,7 +41,7 @@ export class ApiHubClient {
     }
     /** Get the supervisor chain above an employee */
     async getSupervisorChain(employeeId) {
-        return this.request(`/employees/${employeeId}/supervisor-chain`);
+        return this.request(`/employees/${encodeURIComponent(employeeId)}/supervisor-chain`);
     }
     /** Look up JDE number and employee data from email (with JDEService/CoreService fallback) */
     async getJdeFromEmail(email) {
@@ -62,12 +54,52 @@ export class ApiHubClient {
     async getLlmLogs() {
         return this.request('/llm-logs');
     }
-    /** Create a new LLM log entry */
-    async createLlmLog(input) {
-        return this.requestWithBody('/llm-logs', 'POST', input);
+    // -----------------------------------------------------------------------
+    // Business Units
+    // -----------------------------------------------------------------------
+    async getBusinessUnits() {
+        return this.request('/business-units');
+    }
+    async getBusinessUnitsDropdown() {
+        return this.request('/business-units/dropdown');
+    }
+    async getBusinessUnit(id) {
+        return this.request(`/business-units/${encodeURIComponent(id)}`);
+    }
+    // -----------------------------------------------------------------------
+    // Cost Codes
+    // -----------------------------------------------------------------------
+    async getCostcodes() {
+        return this.request('/costcodes');
+    }
+    async getCostcodesDropdown() {
+        return this.request('/costcodes/dropdown');
+    }
+    async getCostcode(id) {
+        return this.request(`/costcodes/${encodeURIComponent(id)}`);
+    }
+    // -----------------------------------------------------------------------
+    // Pay Types
+    // -----------------------------------------------------------------------
+    async getPaytypes() {
+        return this.request('/paytypes');
+    }
+    async getPaytypesDropdown() {
+        return this.request('/paytypes/dropdown');
+    }
+    async getPaytype(id) {
+        return this.request(`/paytypes/${encodeURIComponent(id)}`);
+    }
+    // -----------------------------------------------------------------------
+    // Work Orders
+    // -----------------------------------------------------------------------
+    async getWorkorders() {
+        return this.request('/workorders');
+    }
+    async getWorkordersDropdown() {
+        return this.request('/workorders/dropdown');
     }
-    /** Update an existing LLM log entry */
-    async updateLlmLog(id, input) {
-        return this.requestWithBody(`/llm-logs/${id}`, 'PATCH', input);
+    async getWorkorder(id) {
+        return this.request(`/workorders/${encodeURIComponent(id)}`);
     }
 }

package/package.json

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