washday-sdk 1.6.62 → 1.6.63

package/dist/api/attendance/post.js

@@ -9,9 +9,52 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 const ATTENDANCE_API = 'api/attendance';
 const ATTENDANCE_SOURCES = ["web_pos", "pos_v2", "unknown"];
+const LOCATION_PERMISSION_STATUSES = [
+    "granted",
+    "denied",
+    "unavailable",
+    "not_requested",
+    "error",
+];
 const stringValue = (value) => (typeof value === "string" && value.trim() ? value.trim() : undefined);
 const numberValue = (value) => (typeof value === "number" && Number.isFinite(value) ? value : undefined);
 const sourceValue = (value) => (ATTENDANCE_SOURCES.includes(value) ? value : undefined);
+const permissionStatusValue = (value) => (LOCATION_PERMISSION_STATUSES.includes(value)
+    ? value
+    : undefined);
+const dateValue = (value) => {
+    if (value instanceof Date && !Number.isNaN(value.getTime()))
+        return value;
+    if (typeof value !== "string")
+        return undefined;
+    return Number.isNaN(new Date(value).getTime()) ? undefined : value;
+};
+const buildSafeAttendanceLocation = (location) => {
+    if (!location)
+        return undefined;
+    const permissionStatus = permissionStatusValue(location.permissionStatus);
+    if (!permissionStatus)
+        return undefined;
+    const safeLocation = {
+        permissionStatus,
+        capturedAt: dateValue(location.capturedAt),
+        errorCode: stringValue(location.errorCode),
+        errorMessage: stringValue(location.errorMessage),
+    };
+    if (permissionStatus === "granted") {
+        safeLocation.latitude = numberValue(location.latitude);
+        safeLocation.longitude = numberValue(location.longitude);
+        safeLocation.accuracy = numberValue(location.accuracy);
+        safeLocation.altitude = numberValue(location.altitude);
+        safeLocation.altitudeAccuracy = numberValue(location.altitudeAccuracy);
+        safeLocation.heading = numberValue(location.heading);
+        safeLocation.speed = numberValue(location.speed);
+    }
+    const filteredEntries = Object.entries(safeLocation).filter(([, value]) => value !== undefined);
+    return filteredEntries.length
+        ? Object.fromEntries(filteredEntries)
+        : undefined;
+};
 const buildSafeAttendanceMetadata = (metadata) => {
     if (!metadata)
         return undefined;
@@ -24,6 +67,7 @@ const buildSafeAttendanceMetadata = (metadata) => {
         timezone: stringValue(metadata.timezone),
         screenWidth: numberValue(metadata.screenWidth),
         screenHeight: numberValue(metadata.screenHeight),
+        location: buildSafeAttendanceLocation(metadata.location),
     };
     const filteredEntries = Object.entries(safeMetadata).filter(([, value]) => value !== undefined);
     return filteredEntries.length

package/dist/api/attendance/put.js

@@ -14,7 +14,8 @@ export const updateById = function (id, data) {
             const config = {
                 headers: { Authorization: `Bearer ${this.apiToken}` }
             };
-            return yield this.axiosInstance.put(`${ATTENDANCE_API}/${id}`, data, config);
+            const { timestamp, notes, reason } = data;
+            return yield this.axiosInstance.put(`${ATTENDANCE_API}/${id}`, Object.assign(Object.assign(Object.assign({}, (timestamp !== undefined ? { timestamp } : {})), (notes !== undefined ? { notes } : {})), { reason }), config);
         }
         catch (error) {
             console.error('Error updating attendance entry:', error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "washday-sdk",
-  "version": "1.6.62",
+  "version": "1.6.63",
   "description": "Washday utilities functions and API",
   "main": "dist/index.js",
   "type": "module",

package/src/api/attendance/post.ts

@@ -1,6 +1,8 @@
 import { WashdayClientInstance } from "../../interfaces/Api";
 import type {
     AttendanceClientMetadata,
+    AttendanceLocationMetadata,
+    AttendanceLocationPermissionStatus,
     AttendanceSource,
     ClockInRequest,
     ClockOutRequest,
@@ -8,6 +10,13 @@ import type {
 
 const ATTENDANCE_API = 'api/attendance';
 const ATTENDANCE_SOURCES: AttendanceSource[] = ["web_pos", "pos_v2", "unknown"];
+const LOCATION_PERMISSION_STATUSES: AttendanceLocationPermissionStatus[] = [
+    "granted",
+    "denied",
+    "unavailable",
+    "not_requested",
+    "error",
+];
 
 const stringValue = (value: unknown): string | undefined => (
     typeof value === "string" && value.trim() ? value.trim() : undefined
@@ -21,6 +30,52 @@ const sourceValue = (value: unknown): AttendanceSource | undefined => (
     ATTENDANCE_SOURCES.includes(value as AttendanceSource) ? value as AttendanceSource : undefined
 );
 
+const permissionStatusValue = (value: unknown): AttendanceLocationPermissionStatus | undefined => (
+    LOCATION_PERMISSION_STATUSES.includes(value as AttendanceLocationPermissionStatus)
+        ? value as AttendanceLocationPermissionStatus
+        : undefined
+);
+
+const dateValue = (value: unknown): string | Date | undefined => {
+    if (value instanceof Date && !Number.isNaN(value.getTime())) return value;
+    if (typeof value !== "string") return undefined;
+    return Number.isNaN(new Date(value).getTime()) ? undefined : value;
+};
+
+const buildSafeAttendanceLocation = (
+    location?: AttendanceLocationMetadata & Record<string, unknown>
+): AttendanceLocationMetadata | undefined => {
+    if (!location) return undefined;
+
+    const permissionStatus = permissionStatusValue(location.permissionStatus);
+    if (!permissionStatus) return undefined;
+
+    const safeLocation: AttendanceLocationMetadata = {
+        permissionStatus,
+        capturedAt: dateValue(location.capturedAt),
+        errorCode: stringValue(location.errorCode),
+        errorMessage: stringValue(location.errorMessage),
+    };
+
+    if (permissionStatus === "granted") {
+        safeLocation.latitude = numberValue(location.latitude);
+        safeLocation.longitude = numberValue(location.longitude);
+        safeLocation.accuracy = numberValue(location.accuracy);
+        safeLocation.altitude = numberValue(location.altitude);
+        safeLocation.altitudeAccuracy = numberValue(location.altitudeAccuracy);
+        safeLocation.heading = numberValue(location.heading);
+        safeLocation.speed = numberValue(location.speed);
+    }
+
+    const filteredEntries = Object.entries(safeLocation).filter(
+        ([, value]) => value !== undefined
+    );
+
+    return filteredEntries.length
+        ? Object.fromEntries(filteredEntries) as AttendanceLocationMetadata
+        : undefined;
+};
+
 const buildSafeAttendanceMetadata = (
     metadata?: AttendanceClientMetadata & Record<string, unknown>
 ): AttendanceClientMetadata | undefined => {
@@ -35,6 +90,7 @@ const buildSafeAttendanceMetadata = (
         timezone: stringValue(metadata.timezone),
         screenWidth: numberValue(metadata.screenWidth),
         screenHeight: numberValue(metadata.screenHeight),
+        location: buildSafeAttendanceLocation(metadata.location as any),
     };
 
     const filteredEntries = Object.entries(safeMetadata).filter(

package/src/api/attendance/put.ts

@@ -1,20 +1,27 @@
 import { WashdayClientInstance } from "../../interfaces/Api";
-import axiosInstance from "../axiosInstance";
 
 const ATTENDANCE_API = 'api/attendance';
 
-export const updateById = async function (this: WashdayClientInstance, id: string, data: {
+export interface UpdateAttendanceEntryRequest {
     timestamp?: string;
     notes?: string;
+    reason: string;
     editorId?: string;
-}): Promise<any> {
+}
+
+export const updateById = async function (this: WashdayClientInstance, id: string, data: UpdateAttendanceEntryRequest): Promise<any> {
     try {
         const config = {
             headers: { Authorization: `Bearer ${this.apiToken}` }
         };
-        return await this.axiosInstance.put(`${ATTENDANCE_API}/${id}`, data, config);
+        const { timestamp, notes, reason } = data;
+        return await this.axiosInstance.put(`${ATTENDANCE_API}/${id}`, {
+            ...(timestamp !== undefined ? { timestamp } : {}),
+            ...(notes !== undefined ? { notes } : {}),
+            reason,
+        }, config);
     } catch (error) {
         console.error('Error updating attendance entry:', error);
         throw error;
     }
-}; 
+};

package/src/interfaces/Attendance.ts

@@ -3,6 +3,27 @@ import { IStore } from "./Store";
 
 export type AttendanceSource = "web_pos" | "pos_v2" | "unknown";
 
+export type AttendanceLocationPermissionStatus =
+    | "granted"
+    | "denied"
+    | "unavailable"
+    | "not_requested"
+    | "error";
+
+export interface AttendanceLocationMetadata {
+    latitude?: number;
+    longitude?: number;
+    accuracy?: number;
+    altitude?: number;
+    altitudeAccuracy?: number;
+    heading?: number;
+    speed?: number;
+    permissionStatus?: AttendanceLocationPermissionStatus;
+    capturedAt?: string | Date;
+    errorCode?: string;
+    errorMessage?: string;
+}
+
 export interface AttendanceClientMetadata {
     platform?: string;
     appVersion?: string;
@@ -12,6 +33,7 @@ export interface AttendanceClientMetadata {
     timezone?: string;
     screenWidth?: number;
     screenHeight?: number;
+    location?: AttendanceLocationMetadata;
 }
 
 export interface AttendanceServerMetadata extends AttendanceClientMetadata {
@@ -46,6 +68,8 @@ export interface IAttendanceRecord {
     notes?: string;
     editedBy?: IUser | string;
     editedAt?: Date;
+    lastEditReason?: string;
+    revision?: number;
     autoClosed?: boolean;
     createdAt?: Date;
     updatedAt?: Date;
@@ -64,6 +88,36 @@ export interface IAttendanceStatus {
     clockInStore?: IStore | string;
 }
 
+export interface AttendanceShiftDuration {
+    hours: number;
+    minutes: number;
+    totalMinutes: number;
+}
+
+export interface AttendanceReportTableInfoRow {
+    _id?: string;
+    employee: IUser | string | {
+        _id?: string;
+        name?: string;
+        email?: string;
+    };
+    clockInTime?: Date | string;
+    clockOutTime?: Date | string | null;
+    shiftDuration?: AttendanceShiftDuration | null;
+    clockInStore?: string;
+    clockOutStore?: string | null;
+    notes?: string;
+    clockInIpAddress?: string;
+    clockOutIpAddress?: string;
+    clockInMetadata?: AttendanceServerMetadata | null;
+    clockOutMetadata?: AttendanceServerMetadata | null;
+    clockInLocation?: AttendanceLocationMetadata | null;
+    clockOutLocation?: AttendanceLocationMetadata | null;
+    clockInLocationSummary?: string;
+    clockOutLocationSummary?: string;
+    autoClosed?: boolean;
+}
+
 export interface IAttendanceReport {
     storeId: string;
     storeName?: string;
@@ -77,4 +131,12 @@ export interface IAttendanceReport {
         startDate: Date;
         endDate: Date;
     };
+    tableInfo?: AttendanceReportTableInfoRow[];
+    totalRows?: number;
+    pagination?: {
+        currentPage: number;
+        totalPages: number;
+        totalRecords: number;
+        limit?: number;
+    };
 }

package/src/interfaces/Permission.ts

@@ -13,6 +13,7 @@ export interface IPermissionMutationType {
 
 export interface IPermission {
     canEditOrders: IPermissionMutationType,
+    canManageAttendance: IPermissionMutationType,
     mutateOrderPayments: IPermissionMutationType,
     markOrderAsCollectedWithPendingAmount: IPermissionMutationType,
     markOrderAsUncollected: IPermissionMutationType,

package/test/attendance.metadata.test.ts

@@ -18,6 +18,14 @@ describe("attendance metadata requests", () => {
         timezone: "America/Mexico_City",
         screenWidth: 1440,
         screenHeight: 900,
+        location: {
+          permissionStatus: "granted",
+          latitude: 19.4326,
+          longitude: -99.1332,
+          accuracy: 24,
+          capturedAt: "2026-05-26T14:00:00.000Z",
+          unknown: "drop-me",
+        },
         ipAddress: "1.1.1.1",
         cfConnectingIp: "1.1.1.2",
         xForwardedFor: "1.1.1.3",
@@ -36,6 +44,13 @@ describe("attendance metadata requests", () => {
           timezone: "America/Mexico_City",
           screenWidth: 1440,
           screenHeight: 900,
+          location: {
+            permissionStatus: "granted",
+            latitude: 19.4326,
+            longitude: -99.1332,
+            accuracy: 24,
+            capturedAt: "2026-05-26T14:00:00.000Z",
+          },
         },
       },
       {
@@ -59,6 +74,15 @@ describe("attendance metadata requests", () => {
         platform: "ios",
         appVersion: "2.5.0",
         deviceId: "device-1",
+        location: {
+          permissionStatus: "denied",
+          latitude: 19.4326,
+          longitude: -99.1332,
+          accuracy: 24,
+          capturedAt: "2026-05-26T14:00:00.000Z",
+          errorCode: "1",
+          errorMessage: "Permission denied",
+        },
         ipAddress: "1.1.1.1",
       },
     } as any);
@@ -73,6 +97,12 @@ describe("attendance metadata requests", () => {
           platform: "ios",
           appVersion: "2.5.0",
           deviceId: "device-1",
+          location: {
+            permissionStatus: "denied",
+            capturedAt: "2026-05-26T14:00:00.000Z",
+            errorCode: "1",
+            errorMessage: "Permission denied",
+          },
         },
       },
       {

package/test/attendance.update.test.ts

@@ -0,0 +1,30 @@
+import { updateById } from "../src/api/attendance/put";
+
+describe("attendance update requests", () => {
+  it("sends reason with editable attendance fields", async () => {
+    const put = jest.fn().mockResolvedValue({ data: { data: {} } });
+    const client = {
+      apiToken: "token-123",
+      axiosInstance: { put },
+    } as any;
+
+    await updateById.call(client, "entry-1", {
+      timestamp: "2026-05-26T14:00:00.000Z",
+      notes: "Corrected note",
+      reason: "El empleado olvidó marcar a tiempo",
+      editorId: "ignored-by-backend",
+    } as any);
+
+    expect(put).toHaveBeenCalledWith(
+      "api/attendance/entry-1",
+      {
+        timestamp: "2026-05-26T14:00:00.000Z",
+        notes: "Corrected note",
+        reason: "El empleado olvidó marcar a tiempo",
+      },
+      {
+        headers: { Authorization: "Bearer token-123" },
+      },
+    );
+  });
+});