@markwharton/eh-payroll 3.0.1 → 3.2.0

package/dist/errors.d.ts

@@ -11,7 +11,7 @@ import type { ParsedError } from '@markwharton/api-core';
 /**
  * Parsed EH error response
  */
-export type EHPayrollParsedError = ParsedError;
+export type PayrollParsedError = ParsedError;
 /**
  * Parse EH API error response text into a human-readable message.
  *
@@ -22,16 +22,16 @@ export type EHPayrollParsedError = ParsedError;
  * @param status - HTTP status code
  * @returns Parsed error with message
  */
-export declare function parseEHPayrollErrorResponse(errorText: string, status: number): EHPayrollParsedError;
+export declare function parsePayrollErrorResponse(errorText: string, status: number): PayrollParsedError;
 /**
  * Custom error class for EH API errors
  */
-export declare class EHPayrollError extends ApiError {
+export declare class PayrollError extends ApiError {
     constructor(message: string, status: number, options?: {
         rawResponse?: string;
     });
     /**
-     * Create an EHPayrollError from an API response
+     * Create an PayrollError from an API response
      */
-    static fromResponse(status: number, responseText: string): EHPayrollError;
+    static fromResponse(status: number, responseText: string): PayrollError;
 }

package/dist/errors.js

@@ -17,23 +17,23 @@ import { ApiError, parseJsonErrorResponse } from '@markwharton/api-core';
  * @param status - HTTP status code
  * @returns Parsed error with message
  */
-export function parseEHPayrollErrorResponse(errorText, status) {
+export function parsePayrollErrorResponse(errorText, status) {
     return parseJsonErrorResponse(errorText, status);
 }
 /**
  * Custom error class for EH API errors
  */
-export class EHPayrollError extends ApiError {
+export class PayrollError extends ApiError {
     constructor(message, status, options) {
         super(message, status, options);
-        this.name = 'EHPayrollError';
+        this.name = 'PayrollError';
     }
     /**
-     * Create an EHPayrollError from an API response
+     * Create an PayrollError from an API response
      */
     static fromResponse(status, responseText) {
-        const parsed = parseEHPayrollErrorResponse(responseText, status);
-        return new EHPayrollError(parsed.message, status, {
+        const parsed = parsePayrollErrorResponse(responseText, status);
+        return new PayrollError(parsed.message, status, {
             rawResponse: responseText,
         });
     }

package/dist/index.d.ts

@@ -5,9 +5,9 @@
  *
  * @example
  * ```typescript
- * import { EHClient } from '@markwharton/eh-payroll';
+ * import { PayrollClient } from '@markwharton/eh-payroll';
  *
- * const client = new EHClient({ apiKey: 'xxx', businessId: 123 });
+ * const client = new PayrollClient({ apiKey: 'xxx', businessId: 123 });
  *
  * // Validate credentials
  * await client.validateApiKey();
@@ -19,15 +19,22 @@
  * const { data: rosterShifts } = await client.getRosterShifts('2026-02-03', '2026-02-09');
  * ```
  */
-export { EHClient } from './client.js';
-export type { EHConfig, EHCacheConfig, EHRetryConfig, EHLeaveRequest, EHLeaveRequestOptions, EHEmployeeLeaveRequestOptions, EHLeaveRequestStatus, EHEmployee, EHEmployeeOptions, EHStandardHours, EHLocation, EHEmployeeGroup, EHRosterShift, EHRosterShiftOptions, EHAttendanceStatus, EHKiosk, EHKioskEmployee, EHKioskStaffOptions, EHEmployeeImage, } from './types.js';
-export { EMPLOYEE_FIELDS, LEAVE_REQUEST_FIELDS, LOCATION_FIELDS, EMPLOYEE_GROUP_FIELDS, ROSTER_SHIFT_FIELDS, KIOSK_FIELDS, KIOSK_EMPLOYEE_FIELDS, ENTITIES, } from './types.js';
+export { PayrollClient } from './client.js';
+export type { PayrollConfig, PayrollCacheConfig, PayrollRetryConfig, PayrollLeaveRequest, PayrollLeaveRequestOptions, PayrollLeaveRequestGroupBy, PayrollEmployeeLeaveRequestOptions, PayrollLeaveRequestStatus, PayrollEmployee, PayrollEmployeeStatus, PayrollLeaveAccrualStartDateType, PayrollCloselyHeldReporting, PayrollMedicareLevySurchargeWithholdingTier, PayrollSingleTouchPayrollCategory, PayrollTaxCategory, PayrollEmployeeOptions, PayrollStandardHours, PayrollLocation, PayrollEmployeeGroup, PayrollRosterShift, PayrollRosterShiftOptions, PayrollShiftStatus, PayrollAttendanceStatus, PayrollKiosk, PayrollKioskEmployee, PayrollKioskStaffOptions, PayrollEmployeeImage, } from './types.js';
+export { PAYROLL_EMPLOYEE_FIELDS, PAYROLL_LEAVE_REQUEST_FIELDS, PAYROLL_LOCATION_FIELDS, PAYROLL_EMPLOYEE_GROUP_FIELDS, PAYROLL_ROSTER_SHIFT_FIELDS, PAYROLL_KIOSK_FIELDS, PAYROLL_KIOSK_EMPLOYEE_FIELDS, ENTITIES, } from './types.js';
 export type { AccessTier } from './types.js';
 export { METHOD_TIERS } from './types.js';
 export { buildBasicAuthHeader } from './utils.js';
 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';
-export { EHPayrollError, parseEHPayrollErrorResponse } from './errors.js';
-export type { EHPayrollParsedError } from './errors.js';
+export { PAYROLL_API_BASE, PAYROLL_REGION_URLS } from './constants.js';
+export type { PayrollRegion } from './constants.js';
+export { PayrollError, parsePayrollErrorResponse } from './errors.js';
+export type { PayrollParsedError } from './errors.js';
+export { PayrollClient as EHClient } from './client.js';
+export type { PayrollConfig as EHConfig, PayrollCacheConfig as EHCacheConfig, PayrollRetryConfig as EHRetryConfig, PayrollLeaveRequest as EHLeaveRequest, PayrollLeaveRequestOptions as EHLeaveRequestOptions, PayrollLeaveRequestGroupBy as EHLeaveRequestGroupBy, PayrollEmployeeLeaveRequestOptions as EHEmployeeLeaveRequestOptions, PayrollLeaveRequestStatus as EHLeaveRequestStatus, PayrollEmployee as EHEmployee, PayrollEmployeeStatus as EHEmployeeStatus, PayrollLeaveAccrualStartDateType as EHLeaveAccrualStartDateType, PayrollCloselyHeldReporting as EHCloselyHeldReporting, PayrollMedicareLevySurchargeWithholdingTier as EHMedicareLevySurchargeWithholdingTier, PayrollSingleTouchPayrollCategory as EHSingleTouchPayrollCategory, PayrollTaxCategory as EHTaxCategory, PayrollEmployeeOptions as EHEmployeeOptions, PayrollStandardHours as EHStandardHours, PayrollLocation as EHLocation, PayrollEmployeeGroup as EHEmployeeGroup, PayrollRosterShift as EHRosterShift, PayrollRosterShiftOptions as EHRosterShiftOptions, PayrollShiftStatus as EHShiftStatus, PayrollAttendanceStatus as EHAttendanceStatus, PayrollKiosk as EHKiosk, PayrollKioskEmployee as EHKioskEmployee, PayrollKioskStaffOptions as EHKioskStaffOptions, PayrollEmployeeImage as EHEmployeeImage, } from './types.js';
+export { PAYROLL_EMPLOYEE_FIELDS as EMPLOYEE_FIELDS, PAYROLL_LEAVE_REQUEST_FIELDS as LEAVE_REQUEST_FIELDS, PAYROLL_LOCATION_FIELDS as LOCATION_FIELDS, PAYROLL_EMPLOYEE_GROUP_FIELDS as EMPLOYEE_GROUP_FIELDS, PAYROLL_ROSTER_SHIFT_FIELDS as ROSTER_SHIFT_FIELDS, PAYROLL_KIOSK_FIELDS as KIOSK_FIELDS, PAYROLL_KIOSK_EMPLOYEE_FIELDS as KIOSK_EMPLOYEE_FIELDS, } from './types.js';
+export { PAYROLL_API_BASE as EH_API_BASE, PAYROLL_REGION_URLS as EH_REGION_URLS } from './constants.js';
+export type { PayrollRegion as EHRegion } from './constants.js';
+export { PayrollError as EHPayrollError, parsePayrollErrorResponse as parseEHPayrollErrorResponse } from './errors.js';
+export type { PayrollParsedError as EHPayrollParsedError } from './errors.js';

package/dist/index.js

@@ -5,9 +5,9 @@
  *
  * @example
  * ```typescript
- * import { EHClient } from '@markwharton/eh-payroll';
+ * import { PayrollClient } from '@markwharton/eh-payroll';
  *
- * const client = new EHClient({ apiKey: 'xxx', businessId: 123 });
+ * const client = new PayrollClient({ apiKey: 'xxx', businessId: 123 });
  *
  * // Validate credentials
  * await client.validateApiKey();
@@ -20,15 +20,26 @@
  * ```
  */
 // Main client
-export { EHClient } from './client.js';
+export { PayrollClient } from './client.js';
 // Field definitions (for pickFields)
-export { EMPLOYEE_FIELDS, LEAVE_REQUEST_FIELDS, LOCATION_FIELDS, EMPLOYEE_GROUP_FIELDS, ROSTER_SHIFT_FIELDS, KIOSK_FIELDS, KIOSK_EMPLOYEE_FIELDS, ENTITIES, } from './types.js';
+export { PAYROLL_EMPLOYEE_FIELDS, PAYROLL_LEAVE_REQUEST_FIELDS, PAYROLL_LOCATION_FIELDS, PAYROLL_EMPLOYEE_GROUP_FIELDS, PAYROLL_ROSTER_SHIFT_FIELDS, PAYROLL_KIOSK_FIELDS, PAYROLL_KIOSK_EMPLOYEE_FIELDS, ENTITIES, } from './types.js';
 export { METHOD_TIERS } from './types.js';
 // Utilities
 export { buildBasicAuthHeader } from './utils.js';
 // Re-exported 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';
+export { PAYROLL_API_BASE, PAYROLL_REGION_URLS } from './constants.js';
 // Errors
-export { EHPayrollError, parseEHPayrollErrorResponse } from './errors.js';
+export { PayrollError, parsePayrollErrorResponse } from './errors.js';
+// ============================================================================
+// Backward compatibility aliases (deprecated — use Payroll* names)
+// ============================================================================
+// Client
+export { PayrollClient as EHClient } from './client.js';
+// Field definitions
+export { PAYROLL_EMPLOYEE_FIELDS as EMPLOYEE_FIELDS, PAYROLL_LEAVE_REQUEST_FIELDS as LEAVE_REQUEST_FIELDS, PAYROLL_LOCATION_FIELDS as LOCATION_FIELDS, PAYROLL_EMPLOYEE_GROUP_FIELDS as EMPLOYEE_GROUP_FIELDS, PAYROLL_ROSTER_SHIFT_FIELDS as ROSTER_SHIFT_FIELDS, PAYROLL_KIOSK_FIELDS as KIOSK_FIELDS, PAYROLL_KIOSK_EMPLOYEE_FIELDS as KIOSK_EMPLOYEE_FIELDS, } from './types.js';
+// Constants
+export { PAYROLL_API_BASE as EH_API_BASE, PAYROLL_REGION_URLS as EH_REGION_URLS } from './constants.js';
+// Errors
+export { PayrollError as EHPayrollError, parsePayrollErrorResponse as parseEHPayrollErrorResponse } from './errors.js';

package/dist/types.d.ts

@@ -4,15 +4,15 @@
  * Types for the Employment Hero Payroll (KeyPay) API.
  * Based on the API reference and KeyPay .NET SDK models.
  */
-import type { EHRegion } from './constants.js';
+import type { PayrollRegion } from './constants.js';
 import type { RetryConfig, ClientConfig } from '@markwharton/api-core';
 /**
- * Cache configuration for EHClient
+ * Cache configuration for PayrollClient
  *
- * When provided to EHConfig, enables in-memory TTL caching of API responses.
+ * When provided to PayrollConfig, enables in-memory TTL caching of API responses.
  * All TTL values are in milliseconds. Omit individual TTLs to use defaults.
  */
-export interface EHCacheConfig {
+export interface PayrollCacheConfig {
     /** TTL for employee list (default: 300000 = 5 min) */
     employeesTtl?: number;
     /** TTL for leave requests (default: 120000 = 2 min) */
@@ -31,19 +31,19 @@ export interface EHCacheConfig {
     kioskStaffTtl?: number;
 }
 /** @deprecated Use `RetryConfig` from `@markwharton/api-core` directly. */
-export type EHRetryConfig = RetryConfig;
+export type PayrollRetryConfig = RetryConfig;
 /**
  * Employment Hero Payroll configuration for API access
  */
-export interface EHConfig extends ClientConfig {
+export interface PayrollConfig extends ClientConfig {
     /** API key for authentication (used as Basic Auth username) */
     apiKey: string;
     /** Business ID to operate on */
     businessId: number;
     /** API region (default: 'au'). Sets the base URL automatically. */
-    region?: EHRegion;
+    region?: PayrollRegion;
     /** Enable caching with optional TTL overrides. Omit to disable caching. */
-    cache?: EHCacheConfig;
+    cache?: PayrollCacheConfig;
     /** Max requests per second (default: 5 per API spec). Set 0 to disable. */
     rateLimitPerSecond?: number;
     /** Whether to persist restricted-tier data in persistent cache stores (default: true). Set false to keep restricted data in memory only. */
@@ -56,14 +56,14 @@ export interface EHConfig extends ClientConfig {
  *
  * @see employee-types.generated.ts
  */
-export type { EHEmployee } from './employee-types.generated.js';
+export type { PayrollEmployee, PayrollEmployeeStatus, PayrollLeaveAccrualStartDateType, PayrollCloselyHeldReporting, PayrollMedicareLevySurchargeWithholdingTier, PayrollSingleTouchPayrollCategory, PayrollTaxCategory, } from './employee-types.generated.js';
 /**
  * Standard hours for an employee
  *
  * From GET /business/{id}/employee/{eid}/standardhours
  * Contains the FullTimeEquivalentHours field needed for FTE calculations.
  */
-export interface EHStandardHours {
+export interface PayrollStandardHours {
     /** Employee ID */
     employeeId: number;
     /** Standard hours per week */
@@ -78,7 +78,7 @@ export interface EHStandardHours {
  *
  * From GET /business/{id}/location
  */
-export interface EHLocation {
+export interface PayrollLocation {
     /** Location ID */
     id: number;
     /** Parent location ID (for hierarchy) */
@@ -101,7 +101,7 @@ export interface EHLocation {
 /**
  * Employee group
  */
-export interface EHEmployeeGroup {
+export interface PayrollEmployeeGroup {
     /** Group ID */
     id: number;
     /** Group name */
@@ -112,7 +112,7 @@ export interface EHEmployeeGroup {
  *
  * From GET /business/{id}/rostershift
  */
-export interface EHRosterShift {
+export interface PayrollRosterShift {
     /** Shift ID */
     id: number;
     /** Employee ID (null for unassigned shifts) */
@@ -141,13 +141,13 @@ export interface EHRosterShift {
 /**
  * Time and attendance status
  */
-export type EHAttendanceStatus = 'NotClockedOn' | 'ClockedOn' | 'OnBreak' | 'ClockedOff';
+export type PayrollAttendanceStatus = 'NotClockedOn' | 'ClockedOn' | 'OnBreak' | 'ClockedOff';
 /**
  * Kiosk employee from time and attendance
  *
  * From GET /business/{id}/kiosk/{kid}/staff
  */
-export interface EHKioskEmployee {
+export interface PayrollKioskEmployee {
     /** Employee ID */
     employeeId: number;
     /** First name */
@@ -157,7 +157,7 @@ export interface EHKioskEmployee {
     /** Full name */
     name: string | null;
     /** Attendance status */
-    status: EHAttendanceStatus;
+    status: PayrollAttendanceStatus;
     /** Clock-on time in UTC */
     clockOnTimeUtc: string | null;
     /** Break start time in UTC */
@@ -179,7 +179,7 @@ export interface EHKioskEmployee {
  * From GET /business/{id}/leaverequest
  * Fields from Swagger HourLeaveRequestResponseModel.
  */
-export interface EHLeaveRequest {
+export interface PayrollLeaveRequest {
     /** Leave request ID */
     id: number;
     /** Employee ID */
@@ -209,26 +209,28 @@ export interface EHLeaveRequest {
  * From GET /business/{id}/employee/{eid}/image
  * Returns binary data with content type.
  */
-export interface EHEmployeeImage {
+export interface PayrollEmployeeImage {
     /** Image data as ArrayBuffer */
     data: ArrayBuffer;
     /** Content type from response header (e.g., 'image/png') */
     contentType: string;
 }
 /** Leave request status values */
-export type EHLeaveRequestStatus = 'Approved' | 'Pending' | 'Rejected' | 'Cancelled';
+export type PayrollLeaveRequestStatus = 'Approved' | 'Pending' | 'Rejected' | 'Cancelled';
+/** Leave request grouping options */
+export type PayrollLeaveRequestGroupBy = 'Employee' | 'LeaveType';
 /**
  * Options for getLeaveRequests
  *
  * All filters are passed server-side to the API.
  */
-export interface EHLeaveRequestOptions {
+export interface PayrollLeaveRequestOptions {
     /** Filter by start date (ISO 8601 date-time → API FromDate) */
     fromDate?: string;
     /** Filter by end date (ISO 8601 date-time → API ToDate) */
     toDate?: string;
     /** Filter by status (→ API Status) */
-    status?: EHLeaveRequestStatus;
+    status?: PayrollLeaveRequestStatus;
     /** Filter by employee ID (→ API EmployeeId) */
     employeeId?: number;
     /** Filter by leave category ID (→ API LeaveCategoryId) */
@@ -236,7 +238,7 @@ export interface EHLeaveRequestOptions {
     /** Filter by location ID (→ API LocationId) */
     locationId?: number;
     /** Group results by 'Employee' or 'LeaveType' (→ API GroupBy) */
-    groupBy?: 'Employee' | 'LeaveType';
+    groupBy?: PayrollLeaveRequestGroupBy;
     /** Restrict results to leave overlapping the date range (→ API RestrictOverlappingLeave) */
     restrictOverlappingLeave?: boolean;
 }
@@ -245,9 +247,9 @@ export interface EHLeaveRequestOptions {
  *
  * Filters are passed as OData $filter to the per-employee endpoint.
  */
-export interface EHEmployeeLeaveRequestOptions {
+export interface PayrollEmployeeLeaveRequestOptions {
     /** Filter by status */
-    status?: EHLeaveRequestStatus;
+    status?: PayrollLeaveRequestStatus;
     /** Filter by start date (ISO 8601 date-time) */
     fromDate?: string;
     /** Filter by end date (ISO 8601 date-time) */
@@ -256,16 +258,18 @@ export interface EHEmployeeLeaveRequestOptions {
 /**
  * Options for getEmployees
  */
-export interface EHEmployeeOptions {
+export interface PayrollEmployeeOptions {
     /** Filter by pay schedule ID */
     payScheduleId?: number;
     /** Filter by location ID */
     locationId?: number;
 }
+/** Roster shift status filter values */
+export type PayrollShiftStatus = 'All' | 'Published' | 'Unpublished' | 'Accepted';
 /**
  * Options for getRosterShifts
  */
-export interface EHRosterShiftOptions {
+export interface PayrollRosterShiftOptions {
     /** Filter by employee ID */
     employeeId?: number;
     /** Filter by location ID */
@@ -275,9 +279,9 @@ export interface EHRosterShiftOptions {
     /** Include shifts with all roles (default: only unassigned roles) */
     selectAllRoles?: boolean;
     /** Filter by single shift status */
-    shiftStatus?: 'All' | 'Published' | 'Unpublished' | 'Accepted';
+    shiftStatus?: PayrollShiftStatus;
     /** Filter by multiple shift statuses */
-    shiftStatuses?: ('All' | 'Published' | 'Unpublished' | 'Accepted')[];
+    shiftStatuses?: PayrollShiftStatus[];
     /** Filter by specific locations (multiple) */
     selectedLocations?: string[];
     /** Filter by specific employees (multiple) */
@@ -296,7 +300,7 @@ export interface EHRosterShiftOptions {
  *
  * From GET /business/{id}/kiosk
  */
-export interface EHKiosk {
+export interface PayrollKiosk {
     /** Kiosk ID */
     id: number;
     /** External identifier */
@@ -333,12 +337,12 @@ export interface EHKiosk {
 /**
  * Options for getKioskStaff
  */
-export interface EHKioskStaffOptions {
+export interface PayrollKioskStaffOptions {
     /** Restrict current shifts to current kiosk location (default: false) */
     restrictCurrentShiftsToCurrentKioskLocation?: boolean;
 }
-/** Fields for EHLeaveRequest — set false to exclude from API responses */
-export declare const LEAVE_REQUEST_FIELDS: {
+/** Fields for PayrollLeaveRequest — set false to exclude from API responses */
+export declare const PAYROLL_LEAVE_REQUEST_FIELDS: {
     readonly id: true;
     readonly employeeId: true;
     readonly leaveCategoryId: true;
@@ -351,8 +355,8 @@ export declare const LEAVE_REQUEST_FIELDS: {
     readonly notes: true;
     readonly status: true;
 };
-/** Fields for EHLocation — set false to exclude from API responses */
-export declare const LOCATION_FIELDS: {
+/** Fields for PayrollLocation — set false to exclude from API responses */
+export declare const PAYROLL_LOCATION_FIELDS: {
     readonly id: true;
     readonly parentId: true;
     readonly name: true;
@@ -363,8 +367,8 @@ export declare const LOCATION_FIELDS: {
     readonly state: true;
     readonly country: true;
 };
-/** Fields for EHKiosk — set false to exclude from API responses */
-export declare const KIOSK_FIELDS: {
+/** Fields for PayrollKiosk — set false to exclude from API responses */
+export declare const PAYROLL_KIOSK_FIELDS: {
     readonly id: true;
     readonly externalId: true;
     readonly name: true;
@@ -382,8 +386,8 @@ export declare const KIOSK_FIELDS: {
     readonly canAddEmployees: true;
     readonly paidBreaksEnabled: true;
 };
-/** Fields for EHKioskEmployee — set false to exclude from API responses */
-export declare const KIOSK_EMPLOYEE_FIELDS: {
+/** Fields for PayrollKioskEmployee — set false to exclude from API responses */
+export declare const PAYROLL_KIOSK_EMPLOYEE_FIELDS: {
     readonly employeeId: true;
     readonly firstName: true;
     readonly surname: true;
@@ -397,13 +401,13 @@ export declare const KIOSK_EMPLOYEE_FIELDS: {
     readonly longShift: true;
     readonly recordedTimeUtc: true;
 };
-/** Fields for EHEmployeeGroup — set false to exclude from API responses */
-export declare const EMPLOYEE_GROUP_FIELDS: {
+/** Fields for PayrollEmployeeGroup — set false to exclude from API responses */
+export declare const PAYROLL_EMPLOYEE_GROUP_FIELDS: {
     readonly id: true;
     readonly name: true;
 };
-/** Fields for EHRosterShift — set false to exclude from API responses */
-export declare const ROSTER_SHIFT_FIELDS: {
+/** Fields for PayrollRosterShift — set false to exclude from API responses */
+export declare const PAYROLL_ROSTER_SHIFT_FIELDS: {
     readonly id: true;
     readonly employeeId: true;
     readonly employeeName: true;
@@ -417,8 +421,8 @@ export declare const ROSTER_SHIFT_FIELDS: {
     readonly published: true;
     readonly accepted: true;
 };
-/** Fields for EHEmployee — set false to exclude from API responses */
-export declare const EMPLOYEE_FIELDS: {
+/** Fields for PayrollEmployee — set false to exclude from API responses */
+export declare const PAYROLL_EMPLOYEE_FIELDS: {
     readonly id: true;
     readonly externalId: true;
     readonly firstName: true;

package/dist/types.js

@@ -7,42 +7,42 @@
 // ============================================================================
 // Field Definitions (for pickFields)
 // ============================================================================
-/** Fields for EHLeaveRequest — set false to exclude from API responses */
-export const LEAVE_REQUEST_FIELDS = {
+/** Fields for PayrollLeaveRequest — set false to exclude from API responses */
+export const PAYROLL_LEAVE_REQUEST_FIELDS = {
     id: true, employeeId: true, leaveCategoryId: true, employee: true, leaveCategory: true,
     fromDate: true, toDate: true, totalHours: true, hoursApplied: true, notes: true, status: true,
 };
-/** Fields for EHLocation — set false to exclude from API responses */
-export const LOCATION_FIELDS = {
+/** Fields for PayrollLocation — set false to exclude from API responses */
+export const PAYROLL_LOCATION_FIELDS = {
     id: true, parentId: true, name: true, externalId: true, source: true,
     fullyQualifiedName: true, isGlobal: true, state: true, country: true,
 };
-/** Fields for EHKiosk — set false to exclude from API responses */
-export const KIOSK_FIELDS = {
+/** Fields for PayrollKiosk — set false to exclude from API responses */
+export const PAYROLL_KIOSK_FIELDS = {
     id: true, externalId: true, name: true, locationId: true, timeZone: true, ianaTimeZone: true,
     allowHigherClassificationSelection: true, isLocationRequired: true, isWorkTypeRequired: true,
     restrictLocationsForEmployees: true, allowEmployeeShiftSelection: true,
     clockOnWindowMinutes: true, clockOffWindowMinutes: true,
     isPhotoRequired: true, canAddEmployees: true, paidBreaksEnabled: true,
 };
-/** Fields for EHKioskEmployee — set false to exclude from API responses */
-export const KIOSK_EMPLOYEE_FIELDS = {
+/** Fields for PayrollKioskEmployee — set false to exclude from API responses */
+export const PAYROLL_KIOSK_EMPLOYEE_FIELDS = {
     employeeId: true, firstName: true, surname: true, name: true, status: true,
     clockOnTimeUtc: true, breakStartTimeUtc: true, currentShiftId: true,
     employeeStartDate: true, employeeGroupIds: true, longShift: true, recordedTimeUtc: true,
 };
-/** Fields for EHEmployeeGroup — set false to exclude from API responses */
-export const EMPLOYEE_GROUP_FIELDS = {
+/** Fields for PayrollEmployeeGroup — set false to exclude from API responses */
+export const PAYROLL_EMPLOYEE_GROUP_FIELDS = {
     id: true, name: true,
 };
-/** Fields for EHRosterShift — set false to exclude from API responses */
-export const ROSTER_SHIFT_FIELDS = {
+/** Fields for PayrollRosterShift — set false to exclude from API responses */
+export const PAYROLL_ROSTER_SHIFT_FIELDS = {
     id: true, employeeId: true, employeeName: true, locationId: true, locationName: true,
     workTypeId: true, workTypeName: true, startTime: true, endTime: true,
     notes: true, published: true, accepted: true,
 };
-/** Fields for EHEmployee — set false to exclude from API responses */
-export const EMPLOYEE_FIELDS = {
+/** Fields for PayrollEmployee — set false to exclude from API responses */
+export const PAYROLL_EMPLOYEE_FIELDS = {
     // Identity
     id: true, externalId: true, firstName: true, surname: true, status: true,
     // Dates
@@ -111,15 +111,15 @@ export const EMPLOYEE_FIELDS = {
 };
 /** Entity registry — maps interface names to field specs and API path segments. */
 export const ENTITIES = {
-    EHEmployee: { fields: EMPLOYEE_FIELDS, path: 'employee/unstructured', apiRef: 'employee/au-employee--get-employees', apiRefById: 'employee/au-employee--get-employee-by-id' },
-    EHLeaveRequest: { fields: LEAVE_REQUEST_FIELDS, path: 'leaverequest', apiRef: 'leave-requests/au-business-hours-leave-request--list-leave-requests' },
-    EHEmployeeLeaveRequest: { fields: LEAVE_REQUEST_FIELDS, path: 'employee/{employeeId}/leaverequest', apiRef: 'leave-requests/au-hours-leave-request--get-leave-requests' },
-    EHLocation: { fields: LOCATION_FIELDS, path: 'location', apiRef: 'location/au-location--get-locations' },
-    EHRosterShift: { fields: ROSTER_SHIFT_FIELDS, path: 'rostershift', apiRef: 'roster-shifts/au-roster-shift--get' },
-    EHKiosk: { fields: KIOSK_FIELDS, path: 'kiosk', apiRef: 'time-and-attendance/kiosk--get-all' },
-    EHKioskEmployee: { fields: KIOSK_EMPLOYEE_FIELDS, path: 'kiosk/{kioskId}/staff', apiRef: 'time-and-attendance/generic-time-and-attendance--get-staff' },
-    EHEmployeeGroup: { fields: EMPLOYEE_GROUP_FIELDS, path: 'employeegroup', apiRef: 'employee-groups/au-employee-group--get-groups' },
-    EHStandardHours: { path: 'employee/{employeeId}/standardhours', apiRef: 'employee/au-employee-standard-hours--get' },
+    PayrollEmployee: { fields: PAYROLL_EMPLOYEE_FIELDS, path: 'employee/unstructured', apiRef: 'employee/au-employee--get-employees', apiRefById: 'employee/au-employee--get-employee-by-id' },
+    PayrollLeaveRequest: { fields: PAYROLL_LEAVE_REQUEST_FIELDS, path: 'leaverequest', apiRef: 'leave-requests/au-business-hours-leave-request--list-leave-requests' },
+    PayrollEmployeeLeaveRequest: { fields: PAYROLL_LEAVE_REQUEST_FIELDS, path: 'employee/{employeeId}/leaverequest', apiRef: 'leave-requests/au-hours-leave-request--get-leave-requests' },
+    PayrollLocation: { fields: PAYROLL_LOCATION_FIELDS, path: 'location', apiRef: 'location/au-location--get-locations' },
+    PayrollRosterShift: { fields: PAYROLL_ROSTER_SHIFT_FIELDS, path: 'rostershift', apiRef: 'roster-shifts/au-roster-shift--get' },
+    PayrollKiosk: { fields: PAYROLL_KIOSK_FIELDS, path: 'kiosk', apiRef: 'time-and-attendance/kiosk--get-all' },
+    PayrollKioskEmployee: { fields: PAYROLL_KIOSK_EMPLOYEE_FIELDS, path: 'kiosk/{kioskId}/staff', apiRef: 'time-and-attendance/generic-time-and-attendance--get-staff' },
+    PayrollEmployeeGroup: { fields: PAYROLL_EMPLOYEE_GROUP_FIELDS, path: 'employeegroup', apiRef: 'employee-groups/au-employee-group--get-groups' },
+    PayrollStandardHours: { path: 'employee/{employeeId}/standardhours', apiRef: 'employee/au-employee-standard-hours--get' },
 };
 /**
  * Access tier for each data method.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markwharton/eh-payroll",
-  "version": "3.0.1",
+  "version": "3.2.0",
   "description": "Employment Hero Payroll API client",
   "type": "module",
   "main": "dist/index.js",

package/dist/cache.d.ts

@@ -1,38 +0,0 @@
-/**
- * Simple in-memory TTL cache with request coalescing
- *
- * Provides per-instance memoization for EHClient API responses.
- * In serverless environments (Azure Functions, Static Web Apps),
- * module-level state persists across warm invocations within the
- * same instance — this cache leverages that behavior.
- *
- * Request coalescing: when multiple concurrent callers request the
- * same expired key, only one factory call is made. All callers
- * receive the same resolved value (or the same rejection).
- *
- * Not a distributed cache: each instance has its own cache.
- * Cold starts and instance recycling naturally clear stale data.
- */
-export declare class TTLCache {
-    private store;
-    private inflight;
-    /**
-     * Get a cached value, or call the factory to populate it.
-     *
-     * If a factory call is already in progress for this key,
-     * returns the existing promise instead of starting a duplicate.
-     *
-     * @param key - Cache key
-     * @param ttlMs - Time-to-live in milliseconds
-     * @param factory - Async function to produce the value on cache miss
-     */
-    get<T>(key: string, ttlMs: number, factory: () => Promise<T>): Promise<T>;
-    /**
-     * Invalidate cache entries matching a key prefix.
-     */
-    invalidate(prefix: string): void;
-    /**
-     * Clear all cached data and in-flight requests.
-     */
-    clear(): void;
-}

package/dist/cache.js

@@ -1,73 +0,0 @@
-/**
- * Simple in-memory TTL cache with request coalescing
- *
- * Provides per-instance memoization for EHClient API responses.
- * In serverless environments (Azure Functions, Static Web Apps),
- * module-level state persists across warm invocations within the
- * same instance — this cache leverages that behavior.
- *
- * Request coalescing: when multiple concurrent callers request the
- * same expired key, only one factory call is made. All callers
- * receive the same resolved value (or the same rejection).
- *
- * Not a distributed cache: each instance has its own cache.
- * Cold starts and instance recycling naturally clear stale data.
- */
-export class TTLCache {
-    constructor() {
-        this.store = new Map();
-        this.inflight = new Map();
-    }
-    /**
-     * Get a cached value, or call the factory to populate it.
-     *
-     * If a factory call is already in progress for this key,
-     * returns the existing promise instead of starting a duplicate.
-     *
-     * @param key - Cache key
-     * @param ttlMs - Time-to-live in milliseconds
-     * @param factory - Async function to produce the value on cache miss
-     */
-    async get(key, ttlMs, factory) {
-        const existing = this.store.get(key);
-        if (existing && existing.expiresAt > Date.now()) {
-            return existing.data;
-        }
-        const pending = this.inflight.get(key);
-        if (pending) {
-            return pending;
-        }
-        const promise = factory().then((data) => {
-            this.store.set(key, { data, expiresAt: Date.now() + ttlMs });
-            this.inflight.delete(key);
-            return data;
-        }, (err) => {
-            this.inflight.delete(key);
-            throw err;
-        });
-        this.inflight.set(key, promise);
-        return promise;
-    }
-    /**
-     * Invalidate cache entries matching a key prefix.
-     */
-    invalidate(prefix) {
-        for (const key of this.store.keys()) {
-            if (key.startsWith(prefix)) {
-                this.store.delete(key);
-            }
-        }
-        for (const key of this.inflight.keys()) {
-            if (key.startsWith(prefix)) {
-                this.inflight.delete(key);
-            }
-        }
-    }
-    /**
-     * Clear all cached data and in-flight requests.
-     */
-    clear() {
-        this.store.clear();
-        this.inflight.clear();
-    }
-}