@typeb-digital/nucleus-sdk 0.2.1 → 0.3.1

package/dist/es/index.js

@@ -397,6 +397,7 @@ function transformGenericRate(raw) {
     if ('id' in r) out['id'] = r['id'];
     if ('title' in r) out['title'] = str(r['title']);
     if ('department' in r) out['department'] = str(r['department']);
+    if ('job_level_id' in r) out['jobLevelId'] = str(r['job_level_id']);
     if ('currency_code' in r) out['currencyCode'] = str(r['currency_code']);
     if ('cost_rate' in r) out['costRate'] = num(r['cost_rate']);
     if ('billable_rate' in r) out['billableRate'] = num(r['billable_rate']);
@@ -419,7 +420,10 @@ function transformJobLevel(raw) {
     if ('id' in r) out['id'] = r['id'];
     if ('name' in r) out['name'] = str(r['name']);
     if ('code' in r) out['code'] = str(r['code']);
-    if ('department_id' in r) out['departmentId'] = str(r['department_id']);
+    // The API returns the join rows under `departments`; flatten to a string[] of ids.
+    if ('departments' in r && Array.isArray(r['departments'])) {
+        out['departmentIds'] = r['departments'].map((d)=>d?.['department_id']).filter((v)=>typeof v === 'string');
+    }
     if ('sort_order' in r) out['sortOrder'] = num(r['sort_order']) ?? 0;
     return out;
 }
@@ -429,6 +433,7 @@ function transformSalaryBand(raw) {
     const out = {};
     if ('id' in r) out['id'] = r['id'];
     if ('job_level_id' in r) out['jobLevelId'] = str(r['job_level_id']);
+    if ('department_id' in r) out['departmentId'] = str(r['department_id']);
     if ('jurisdiction_id' in r) out['jurisdictionId'] = str(r['jurisdiction_id']);
     if ('currency_code' in r) out['currencyCode'] = str(r['currency_code']);
     if ('min_salary' in r) out['minSalary'] = num(r['min_salary']);
@@ -545,6 +550,12 @@ function transformCalendarEvent(raw) {
     if ('location' in r) out['location'] = str(r['location']);
     if ('color' in r) out['color'] = str(r['color']);
     if ('is_published' in r) out['isPublished'] = bool(r['is_published']);
+    if ('jurisdiction_id' in r) out['jurisdictionId'] = str(r['jurisdiction_id']);
+    if ('national' in r) out['national'] = bool(r['national']);
+    // Expand: jurisdiction (recursively transformed)
+    if ('jurisdiction' in r) {
+        out['jurisdiction'] = r['jurisdiction'] ? transformJurisdiction(r['jurisdiction']) : null;
+    }
     return out;
 }
 function transformTimesheet(raw) {
@@ -605,6 +616,18 @@ class EmployeesAccessor {
             data: transformEmployee(result.data)
         };
     }
+    /**
+   * Update an employee's placement (manager, partner, department, jurisdiction, job
+   * level, employment type, external flag, timezone). Requires `employees` update on the
+   * `placement` bucket. Identity/contact/sensitive fields are Google-owned and read-only;
+   * employees cannot be created or deleted via the SDK.
+   */ async update(id, data) {
+        const result = await this.transport.patch(`/api/v1/data/employees/${id}`, toSnakeBody(data));
+        if ('error' in result) return result;
+        return {
+            data: transformEmployee(result.data)
+        };
+    }
 }
 
 function transformMember(raw) {
@@ -669,25 +692,22 @@ class ProjectsAccessor {
     // ─── Team membership (the projects `team` bucket) ──────────────────────────
     // Membership is the project↔employee join. Reads need `projects` read on `team`;
     // add/remove need `projects` update on `team` (re-adding restores a soft-deleted row).
-    membersBase(projectId) {
-        return `/api/v1/data/project-memberships/projects/${projectId}/members`;
-    }
     /** List a project's team members. Requires `projects` read on the `team` bucket. */ async listMembers(projectId) {
-        const result = await this.transport.get(this.membersBase(projectId));
+        const result = await this.transport.get(`/api/v1/data/project-memberships/projects/${projectId}/members`);
         if ('error' in result) return result;
         return {
             data: (result.data ?? []).map((r)=>transformMember(r))
         };
     }
     /** Add a team member. Requires `projects` update on the `team` bucket. */ async addMember(projectId, data) {
-        const result = await this.transport.post(this.membersBase(projectId), toSnakeBody(data));
+        const result = await this.transport.post(`/api/v1/data/project-memberships/projects/${projectId}/members`, toSnakeBody(data));
         if ('error' in result) return result;
         return {
             data: transformMember(result.data)
         };
     }
     /** Remove a team member. Requires `projects` update on the `team` bucket. */ async removeMember(projectId, employeeId) {
-        const result = await this.transport.del(`${this.membersBase(projectId)}/${employeeId}`);
+        const result = await this.transport.del(`/api/v1/data/project-memberships/projects/${projectId}/members/${employeeId}`);
         if ('error' in result) return result;
         return {
             data: null
@@ -1091,6 +1111,7 @@ class JurisdictionsAccessor {
     async list(params) {
         const query = {};
         if (params?.jobLevelId) query['jobLevelId'] = params.jobLevelId;
+        if (params?.departmentId) query['departmentId'] = params.departmentId;
         if (params?.jurisdictionId) query['jurisdictionId'] = params.jurisdictionId;
         if (params?.page) query['page'] = params.page;
         if (params?.pageSize) query['pageSize'] = params.pageSize;
@@ -1394,6 +1415,7 @@ class CalendarEventsAccessor {
         if (params?.page) query['page'] = params.page;
         if (params?.pageSize) query['pageSize'] = params.pageSize;
         if (params?.updatedSince) query['updatedSince'] = params.updatedSince;
+        if (params?.expand?.length) query['expand'] = params.expand.join(',');
         const result = await this.transport.getList('/api/v1/data/calendar-events', query);
         if ('error' in result) return result;
         return {
@@ -1401,8 +1423,10 @@ class CalendarEventsAccessor {
             meta: result.meta
         };
     }
-    async getById(id) {
-        const result = await this.transport.get(`/api/v1/data/calendar-events/${id}`);
+    async getById(id, options) {
+        const query = {};
+        if (options?.expand?.length) query['expand'] = options.expand.join(',');
+        const result = await this.transport.get(`/api/v1/data/calendar-events/${id}`, query);
         if ('error' in result) return result;
         return {
             data: transformCalendarEvent(result.data)
@@ -1536,7 +1560,7 @@ class TimesheetsAccessor {
     }
 }
 
-function transform(raw) {
+function transform$2(raw) {
     return {
         id: raw['id'],
         employeeId: raw['employee_id'],
@@ -1558,32 +1582,111 @@ function transform(raw) {
     constructor(transport){
         this.transport = transport;
     }
-    base(employeeId) {
-        return `/api/v1/data/employee-compensation/employees/${employeeId}/compensation`;
-    }
     /** Full history, newest first. */ async list(employeeId) {
-        const result = await this.transport.get(this.base(employeeId));
+        const result = await this.transport.get(`/api/v1/data/employee-compensation/employees/${employeeId}/compensation`);
         if ('error' in result) return result;
         return {
-            data: (result.data ?? []).map((r)=>transform(r))
+            data: (result.data ?? []).map((r)=>transform$2(r))
         };
     }
     /** The current (open) record, or null. */ async current(employeeId) {
-        const result = await this.transport.get(`${this.base(employeeId)}/current`);
+        const result = await this.transport.get(`/api/v1/data/employee-compensation/employees/${employeeId}/compensation/current`);
         if ('error' in result) return result;
         return {
-            data: result.data ? transform(result.data) : null
+            data: result.data ? transform$2(result.data) : null
         };
     }
     /** Add a new effective-dated record (closes the prior open one). */ async create(employeeId, data) {
-        const result = await this.transport.post(this.base(employeeId), toSnakeBody(data));
+        const result = await this.transport.post(`/api/v1/data/employee-compensation/employees/${employeeId}/compensation`, toSnakeBody(data));
         if ('error' in result) return result;
         return {
-            data: transform(result.data)
+            data: transform$2(result.data)
         };
     }
     /** Soft-delete a compensation record. */ async delete(employeeId, id) {
-        const result = await this.transport.del(`${this.base(employeeId)}/${id}`);
+        const result = await this.transport.del(`/api/v1/data/employee-compensation/employees/${employeeId}/compensation/${id}`);
+        if ('error' in result) return result;
+        return {
+            data: null
+        };
+    }
+}
+
+function transform$1(raw) {
+    return {
+        id: raw['id'],
+        employeeId: raw['employee_id'],
+        dailyHours: raw['daily_hours'] ?? 8,
+        probationMonths: raw['probation_months'] ?? null,
+        isOvertimeEnabled: raw['is_overtime_enabled'] ?? false
+    };
+}
+/**
+ * EmployeeProfilesAccessor — an employee's work-arrangement profile (Iteration 4).
+ * Gated server-side by the `employee-profiles` scope.
+ */ class EmployeeProfilesAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async get(employeeId) {
+        const result = await this.transport.get(`/api/v1/data/employee-profiles/employees/${employeeId}/profile`);
+        if ('error' in result) return result;
+        return {
+            data: result.data ? transform$1(result.data) : null
+        };
+    }
+    /** Create-or-update the profile. Requires `employee-profiles` update scope. */ async upsert(employeeId, data) {
+        const result = await this.transport.put(`/api/v1/data/employee-profiles/employees/${employeeId}/profile`, toSnakeBody(data));
+        if ('error' in result) return result;
+        return {
+            data: transform$1(result.data)
+        };
+    }
+}
+
+function transform(raw) {
+    return {
+        id: raw['id'],
+        employeeId: raw['employee_id'],
+        reviewType: raw['review_type'],
+        dueDate: raw['due_date'] ?? null,
+        completedDate: raw['completed_date'] ?? null,
+        status: raw['status'],
+        rating: raw['rating'] ?? null,
+        feedback: raw['feedback'] ?? null,
+        reviewerId: raw['reviewer_id'] ?? null
+    };
+}
+/**
+ * EmployeeReviewsAccessor — performance reviews (Iteration 4). Gated server-side by the
+ * `employee-reviews` scope; the `feedback` bucket (rating + feedback) is approval-gated.
+ */ class EmployeeReviewsAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async list(employeeId) {
+        const result = await this.transport.get(`/api/v1/data/employee-reviews/employees/${employeeId}/reviews`);
+        if ('error' in result) return result;
+        return {
+            data: (result.data ?? []).map((r)=>transform(r))
+        };
+    }
+    async create(employeeId, data) {
+        const result = await this.transport.post(`/api/v1/data/employee-reviews/employees/${employeeId}/reviews`, toSnakeBody(data));
+        if ('error' in result) return result;
+        return {
+            data: transform(result.data)
+        };
+    }
+    async update(employeeId, id, data) {
+        const result = await this.transport.patch(`/api/v1/data/employee-reviews/employees/${employeeId}/reviews/${id}`, toSnakeBody(data));
+        if ('error' in result) return result;
+        return {
+            data: transform(result.data)
+        };
+    }
+    async delete(employeeId, id) {
+        const result = await this.transport.del(`/api/v1/data/employee-reviews/employees/${employeeId}/reviews/${id}`);
         if ('error' in result) return result;
         return {
             data: null
@@ -1757,6 +1860,8 @@ class AuthAccessor {
         this.calendar = new CalendarAccessor(transport);
         this.email = new EmailAccessor(transport);
         this.employeeCompensation = new EmployeeCompensationAccessor(transport);
+        this.employeeProfiles = new EmployeeProfilesAccessor(transport);
+        this.employeeReviews = new EmployeeReviewsAccessor(transport);
         this.apps = new AppsAccessor(transport);
         this.files = new FilesAccessor(transport);
         this.auth = new AuthAccessor(config.baseUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typeb-digital/nucleus-sdk",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Server-side TypeScript SDK for the Nucleus data platform",
   "type": "module",
   "engines": {