@markwharton/eh-payroll 2.7.0 → 2.7.2

package/README.md

@@ -84,6 +84,7 @@ All methods return `Result<T>` — see [api-core Result Pattern](../../README.md
 | `validateApiKey()` | — | `Result<void>` |
 | `getEmployees(options?)` | `EHEmployeeOptions?` | `Result<EHAuEmployee[]>` |
 | `getEmployee(employeeId)` | `number` | `Result<EHAuEmployee>` |
+| `getEmployeeImage(employeeId)` | `number` | `Result<EHEmployeeImage>` |
 | `getStandardHours(employeeId)` | `number` | `Result<EHStandardHours>` |
 | `getLocations()` | — | `Result<EHLocation[]>` |
 | `getEmployeeGroups()` | — | `Result<EHEmployeeGroup[]>` |
@@ -115,6 +116,8 @@ Returns leave requests with all filters applied server-side. The business-level
 | `employeeId` | `number` | Filter by employee ID |
 | `leaveCategoryId` | `number` | Filter by leave category ID |
 | `locationId` | `number` | Filter by location ID |
+| `groupBy` | `'Employee' \| 'LeaveType'` | Group results by employee or leave type |
+| `restrictOverlappingLeave` | `boolean` | Restrict results to leave overlapping the date range |
 
 ### `getEmployeeLeaveRequests()`
 

package/dist/client.d.ts

@@ -6,7 +6,7 @@
  *
  * @see https://api.keypay.com.au/
  */
-import type { EHConfig, EHLeaveRequest, EHLeaveRequestOptions, EHEmployeeLeaveRequestOptions, EHEmployeeOptions, EHStandardHours, EHLocation, EHEmployeeGroup, EHRosterShift, EHRosterShiftOptions, EHKiosk, EHKioskEmployee, EHKioskStaffOptions } from './types.js';
+import type { EHConfig, EHLeaveRequest, EHLeaveRequestOptions, EHEmployeeLeaveRequestOptions, EHEmployeeOptions, EHStandardHours, EHLocation, EHEmployeeGroup, EHRosterShift, EHRosterShiftOptions, EHKiosk, EHKioskEmployee, EHKioskStaffOptions, EHEmployeeImage } from './types.js';
 import type { EHAuEmployee } from './employee-types.generated.js';
 import type { Result } from '@markwharton/api-core';
 /**
@@ -117,6 +117,14 @@ export declare class EHClient {
      * Get a single employee by ID
      */
     getEmployee(employeeId: number): Promise<Result<EHAuEmployee>>;
+    /**
+     * Get employee profile image
+     *
+     * Returns binary image data. Not cached (large binary blobs).
+     *
+     * @see https://api.keypay.com.au/australia/reference/employee/au-employee--get-employee-profile-image.html
+     */
+    getEmployeeImage(employeeId: number): Promise<Result<EHEmployeeImage>>;
     /**
      * Get standard hours for an employee (includes FTE value)
      */

package/dist/client.js

@@ -235,6 +235,10 @@ export class EHClient {
             parts.push(`lcid:${options.leaveCategoryId}`);
         if (options?.locationId != null)
             parts.push(`lid:${options.locationId}`);
+        if (options?.groupBy)
+            parts.push(`gb:${options.groupBy}`);
+        if (options?.restrictOverlappingLeave)
+            parts.push('rol');
         const cacheKey = parts.join(':');
         return this.cached(cacheKey, this.cacheTtl.leaveRequestsTtl, async () => {
             const params = new URLSearchParams();
@@ -250,6 +254,10 @@ export class EHClient {
                 params.set('LeaveCategoryId', String(options.leaveCategoryId));
             if (options?.locationId != null)
                 params.set('LocationId', String(options.locationId));
+            if (options?.groupBy)
+                params.set('GroupBy', options.groupBy);
+            if (options?.restrictOverlappingLeave)
+                params.set('RestrictOverlappingLeave', 'true');
             const url = this.businessUrl(ENTITIES.EHLeaveRequest.path, params);
             return this.fetchAndParse(url, async (r) => {
                 return (await r.json())
@@ -328,6 +336,20 @@ export class EHClient {
             });
         }, this.restrictedPersistOpt);
     }
+    /**
+     * Get employee profile image
+     *
+     * Returns binary image data. Not cached (large binary blobs).
+     *
+     * @see https://api.keypay.com.au/australia/reference/employee/au-employee--get-employee-profile-image.html
+     */
+    async getEmployeeImage(employeeId) {
+        const url = this.businessUrl(`employee/${employeeId}/image`);
+        return this.fetchAndParse(url, async (r) => ({
+            data: await r.arrayBuffer(),
+            contentType: r.headers.get('content-type') || 'application/octet-stream',
+        }));
+    }
     // ============================================================================
     // Standard Hours
     // ============================================================================

package/dist/index.d.ts

@@ -20,13 +20,13 @@
  * ```
  */
 export { EHClient } from './client.js';
-export type { EHConfig, EHCacheConfig, EHRetryConfig, EHLeaveRequest, EHEmployeeLeaveRequest, EHLeaveRequestOptions, EHEmployeeLeaveRequestOptions, EHLeaveRequestStatus, EHEmployee, EHEmployeeOptions, EHStandardHours, EHLocation, EHEmployeeGroup, EHRosterShift, EHRosterShiftOptions, EHAttendanceStatus, EHKiosk, EHKioskEmployee, EHKioskStaffOptions, } from './types.js';
+export type { EHConfig, EHCacheConfig, EHRetryConfig, EHLeaveRequest, EHEmployeeLeaveRequest, EHLeaveRequestOptions, EHEmployeeLeaveRequestOptions, EHLeaveRequestStatus, EHEmployee, EHEmployeeOptions, EHStandardHours, EHLocation, EHEmployeeGroup, EHRosterShift, EHRosterShiftOptions, EHAttendanceStatus, EHKiosk, EHKioskEmployee, EHKioskStaffOptions, EHEmployeeImage, } from './types.js';
 export { AU_EMPLOYEE_FIELDS, LEAVE_REQUEST_FIELDS, LOCATION_FIELDS, EMPLOYEE_GROUP_FIELDS, ROSTER_SHIFT_FIELDS, KIOSK_FIELDS, KIOSK_EMPLOYEE_FIELDS, ENTITIES, } from './types.js';
 export type { AccessTier } from './types.js';
 export { METHOD_TIERS } from './types.js';
 export type { EHAuEmployee } from './employee-types.generated.js';
 export { buildBasicAuthHeader } from './utils.js';
-export { ok, err, getErrorMessage, pickFields, RateLimiter, TTLCache, MemoryCacheStore, LayeredCache } from '@markwharton/api-core';
+export { ok, err, getErrorMessage, pickFields, normalizeEnum, RateLimiter, TTLCache, MemoryCacheStore, LayeredCache } from '@markwharton/api-core';
 export type { Result, RetryConfig, OnRequestCallback, ClientConfig, Cache, CacheStore, CacheGetOptions } from '@markwharton/api-core';
 export { EH_API_BASE, EH_REGION_URLS } from './constants.js';
 export type { EHRegion } from './constants.js';

package/dist/index.js

@@ -27,7 +27,7 @@ export { METHOD_TIERS } from './types.js';
 // Utilities
 export { buildBasicAuthHeader } from './utils.js';
 // Re-exported from @markwharton/api-core
-export { ok, err, getErrorMessage, pickFields, RateLimiter, TTLCache, MemoryCacheStore, LayeredCache } from '@markwharton/api-core';
+export { ok, err, getErrorMessage, pickFields, normalizeEnum, RateLimiter, TTLCache, MemoryCacheStore, LayeredCache } from '@markwharton/api-core';
 // Constants
 export { EH_API_BASE, EH_REGION_URLS } from './constants.js';
 // Errors

package/dist/types.d.ts

@@ -204,6 +204,18 @@ export interface EHLeaveRequest {
     /** Status: Approved, Pending, Rejected, Cancelled */
     status: string;
 }
+/**
+ * Employee profile image
+ *
+ * From GET /business/{id}/employee/{eid}/image
+ * Returns binary data with content type.
+ */
+export interface EHEmployeeImage {
+    /** Image data as ArrayBuffer */
+    data: ArrayBuffer;
+    /** Content type from response header (e.g., 'image/png') */
+    contentType: string;
+}
 /** Employee-scoped leave request (same shape, different API operation). */
 export interface EHEmployeeLeaveRequest extends EHLeaveRequest {
 }
@@ -227,6 +239,10 @@ export interface EHLeaveRequestOptions {
     leaveCategoryId?: number;
     /** Filter by location ID (→ API LocationId) */
     locationId?: number;
+    /** Group results by 'Employee' or 'LeaveType' (→ API GroupBy) */
+    groupBy?: 'Employee' | 'LeaveType';
+    /** Restrict results to leave overlapping the date range (→ API RestrictOverlappingLeave) */
+    restrictOverlappingLeave?: boolean;
 }
 /**
  * Options for getEmployeeLeaveRequests
@@ -420,11 +436,11 @@ export declare const AU_EMPLOYEE_FIELDS: {
     readonly jobTitle: true;
     readonly employmentAgreement: false;
     readonly employmentAgreementId: false;
-    readonly paySchedule: false;
+    readonly paySchedule: true;
     readonly payRateTemplate: false;
-    readonly rate: false;
-    readonly rateUnit: false;
-    readonly hoursPerWeek: false;
+    readonly rate: true;
+    readonly rateUnit: true;
+    readonly hoursPerWeek: true;
     readonly hoursPerDay: false;
     readonly primaryPayCategory: false;
     readonly payConditionRuleSet: false;
@@ -432,7 +448,7 @@ export declare const AU_EMPLOYEE_FIELDS: {
     readonly automaticallyPayEmployee: false;
     readonly primaryLocation: true;
     readonly locations: false;
-    readonly tags: false;
+    readonly tags: true;
     readonly workTypes: false;
     readonly reportingDimensionValues: false;
     readonly leaveAccrualStartDateType: false;

package/dist/types.js

@@ -50,10 +50,10 @@ export const AU_EMPLOYEE_FIELDS = {
     // Employment
     employmentType: true, jobTitle: true, employmentAgreement: false, employmentAgreementId: false,
     // Pay
-    paySchedule: false, payRateTemplate: false, rate: false, rateUnit: false, hoursPerWeek: false, hoursPerDay: false,
+    paySchedule: true, payRateTemplate: false, rate: true, rateUnit: true, hoursPerWeek: true, hoursPerDay: false,
     primaryPayCategory: false, payConditionRuleSet: false, overrideTemplateRate: false, automaticallyPayEmployee: false,
     // Location/org
-    primaryLocation: true, locations: false, tags: false, workTypes: false, reportingDimensionValues: false,
+    primaryLocation: true, locations: false, tags: true, workTypes: false, reportingDimensionValues: false,
     // Leave
     leaveAccrualStartDateType: false, leaveTemplate: false, leaveYearStart: false,
     // Flags
@@ -138,5 +138,6 @@ export const METHOD_TIERS = {
     getLeaveRequests: 'restricted',
     getEmployeeLeaveRequests: 'restricted',
     getEmployee: 'restricted',
+    getEmployeeImage: 'restricted',
     getStandardHours: 'restricted',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markwharton/eh-payroll",
-  "version": "2.7.0",
+  "version": "2.7.2",
   "description": "Employment Hero Payroll API client",
   "type": "module",
   "main": "dist/index.js",
@@ -16,7 +16,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@markwharton/api-core": "^1.6.0"
+    "@markwharton/api-core": "^1.6.1"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",