washday-sdk 1.6.60 → 1.6.62

package/dist/api/attendance/post.js

@@ -8,13 +8,46 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 const ATTENDANCE_API = 'api/attendance';
+const ATTENDANCE_SOURCES = ["web_pos", "pos_v2", "unknown"];
+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 buildSafeAttendanceMetadata = (metadata) => {
+    if (!metadata)
+        return undefined;
+    const safeMetadata = {
+        source: sourceValue(metadata.source),
+        platform: stringValue(metadata.platform),
+        appVersion: stringValue(metadata.appVersion),
+        deviceId: stringValue(metadata.deviceId),
+        language: stringValue(metadata.language),
+        timezone: stringValue(metadata.timezone),
+        screenWidth: numberValue(metadata.screenWidth),
+        screenHeight: numberValue(metadata.screenHeight),
+    };
+    const filteredEntries = Object.entries(safeMetadata).filter(([, value]) => value !== undefined);
+    return filteredEntries.length
+        ? Object.fromEntries(filteredEntries)
+        : undefined;
+};
+const buildAttendancePayload = (data) => {
+    const metadata = buildSafeAttendanceMetadata(data.metadata);
+    const payload = Object.assign({}, data);
+    if (metadata) {
+        payload.metadata = metadata;
+    }
+    else {
+        delete payload.metadata;
+    }
+    return payload;
+};
 export const clockIn = function (data) {
     return __awaiter(this, void 0, void 0, function* () {
         try {
             const config = {
                 headers: { Authorization: `Bearer ${this.apiToken}` }
             };
-            return yield this.axiosInstance.post(`${ATTENDANCE_API}/clock-in`, data, config);
+            return yield this.axiosInstance.post(`${ATTENDANCE_API}/clock-in`, buildAttendancePayload(data), config);
         }
         catch (error) {
             console.error('Error clock-in:', error);
@@ -28,7 +61,7 @@ export const clockOut = function (data) {
             const config = {
                 headers: { Authorization: `Bearer ${this.apiToken}` }
             };
-            return yield this.axiosInstance.post(`${ATTENDANCE_API}/clock-out`, data, config);
+            return yield this.axiosInstance.post(`${ATTENDANCE_API}/clock-out`, buildAttendancePayload(data), config);
         }
         catch (error) {
             console.error('Error clock-out:', error);

package/dist/index.js

@@ -7,4 +7,5 @@ export * from './interfaces/Auth';
 export * from './interfaces/Customer';
 export * from './interfaces/DomainUrls';
 export * from './interfaces/GoogleMaps';
+export * from './interfaces/Attendance';
 export { WashdayClient, utils };

package/package.json

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

package/src/api/attendance/post.ts

@@ -1,36 +1,84 @@
 import { WashdayClientInstance } from "../../interfaces/Api";
-import axiosInstance from "../axiosInstance";
+import type {
+    AttendanceClientMetadata,
+    AttendanceSource,
+    ClockInRequest,
+    ClockOutRequest,
+} from "../../interfaces/Attendance";
 
 const ATTENDANCE_API = 'api/attendance';
+const ATTENDANCE_SOURCES: AttendanceSource[] = ["web_pos", "pos_v2", "unknown"];
 
-export const clockIn = async function (this: WashdayClientInstance, data: {
-    storeId: string;
-    userId?: string;
-    notes?: string;
-}): Promise<any> {
+const stringValue = (value: unknown): string | undefined => (
+    typeof value === "string" && value.trim() ? value.trim() : undefined
+);
+
+const numberValue = (value: unknown): number | undefined => (
+    typeof value === "number" && Number.isFinite(value) ? value : undefined
+);
+
+const sourceValue = (value: unknown): AttendanceSource | undefined => (
+    ATTENDANCE_SOURCES.includes(value as AttendanceSource) ? value as AttendanceSource : undefined
+);
+
+const buildSafeAttendanceMetadata = (
+    metadata?: AttendanceClientMetadata & Record<string, unknown>
+): AttendanceClientMetadata | undefined => {
+    if (!metadata) return undefined;
+
+    const safeMetadata: AttendanceClientMetadata = {
+        source: sourceValue(metadata.source),
+        platform: stringValue(metadata.platform),
+        appVersion: stringValue(metadata.appVersion),
+        deviceId: stringValue(metadata.deviceId),
+        language: stringValue(metadata.language),
+        timezone: stringValue(metadata.timezone),
+        screenWidth: numberValue(metadata.screenWidth),
+        screenHeight: numberValue(metadata.screenHeight),
+    };
+
+    const filteredEntries = Object.entries(safeMetadata).filter(
+        ([, value]) => value !== undefined
+    );
+
+    return filteredEntries.length
+        ? Object.fromEntries(filteredEntries) as AttendanceClientMetadata
+        : undefined;
+};
+
+const buildAttendancePayload = <T extends ClockInRequest | ClockOutRequest>(data: T): T => {
+    const metadata = buildSafeAttendanceMetadata(data.metadata as any);
+    const payload = { ...data } as T;
+
+    if (metadata) {
+        payload.metadata = metadata;
+    } else {
+        delete payload.metadata;
+    }
+
+    return payload;
+};
+
+export const clockIn = async function (this: WashdayClientInstance, data: ClockInRequest): Promise<any> {
     try {
         const config = {
             headers: { Authorization: `Bearer ${this.apiToken}` }
         };
-        return await this.axiosInstance.post(`${ATTENDANCE_API}/clock-in`, data, config);
+        return await this.axiosInstance.post(`${ATTENDANCE_API}/clock-in`, buildAttendancePayload(data), config);
     } catch (error) {
         console.error('Error clock-in:', error);
         throw error;
     }
 };
 
-export const clockOut = async function (this: WashdayClientInstance, data: {
-    userId?: string;
-    storeId?: string;    // ✅ AÑADIDO - requerido por backend
-    notes?: string;
-}): Promise<any> {
+export const clockOut = async function (this: WashdayClientInstance, data: ClockOutRequest): Promise<any> {
     try {
         const config = {
             headers: { Authorization: `Bearer ${this.apiToken}` }
         };
-        return await this.axiosInstance.post(`${ATTENDANCE_API}/clock-out`, data, config);
+        return await this.axiosInstance.post(`${ATTENDANCE_API}/clock-out`, buildAttendancePayload(data), config);
     } catch (error) {
         console.error('Error clock-out:', error);
         throw error;
     }
-}; 
+};

package/src/index.ts

@@ -7,6 +7,7 @@ export * from './interfaces/Auth';
 export * from './interfaces/Customer';
 export * from './interfaces/DomainUrls';
 export * from './interfaces/GoogleMaps';
+export * from './interfaces/Attendance';
 export type { StartMPOAuthFlowRequest } from './api/integrations/post';
 export type {
   CreateCFDISubscriptionCheckoutSessionRequest,

package/src/interfaces/Attendance.ts

@@ -1,6 +1,40 @@
 import { IUser } from "./User";
 import { IStore } from "./Store";
 
+export type AttendanceSource = "web_pos" | "pos_v2" | "unknown";
+
+export interface AttendanceClientMetadata {
+    platform?: string;
+    appVersion?: string;
+    deviceId?: string;
+    source?: AttendanceSource;
+    language?: string;
+    timezone?: string;
+    screenWidth?: number;
+    screenHeight?: number;
+}
+
+export interface AttendanceServerMetadata extends AttendanceClientMetadata {
+    ipAddress?: string;
+    cfConnectingIp?: string;
+    xForwardedFor?: string;
+    userAgent?: string;
+}
+
+export interface ClockInRequest {
+    storeId: string;
+    userId?: string;
+    notes?: string;
+    metadata?: AttendanceClientMetadata;
+}
+
+export interface ClockOutRequest {
+    userId?: string;
+    storeId?: string;
+    notes?: string;
+    metadata?: AttendanceClientMetadata;
+}
+
 export interface IAttendanceRecord {
     _id?: string;
     employee: IUser | string;
@@ -8,6 +42,7 @@ export interface IAttendanceRecord {
     type: 'IN' | 'OUT';
     timestamp: Date;
     ipAddress?: string;
+    metadata?: AttendanceServerMetadata;
     notes?: string;
     editedBy?: IUser | string;
     editedAt?: Date;
@@ -42,4 +77,4 @@ export interface IAttendanceReport {
         startDate: Date;
         endDate: Date;
     };
-} 
+}

package/src/interfaces/Company.ts

@@ -33,13 +33,17 @@ export interface UpdateCompanySubscriptionBillingInfoPayload {
 
 export type CFDIBillingMode = "none" | "separate_subscription" | "main_subscription_item";
 export type CFDIMigrationStatus = "none" | "pending_cycle_end" | "migrated";
+export type CFDIBillingStatus = "inactive" | "active" | "cancel_scheduled";
 
 export interface CFDIAddonStatus {
     enabled: boolean;
     billingMode: CFDIBillingMode;
     migrationStatus: CFDIMigrationStatus;
+    billingStatus: CFDIBillingStatus;
+    scheduledDisableAt: string | null;
     isLegacy: boolean;
     canToggleFromUI: boolean;
+    canCancelScheduledDisable: boolean;
 }
 
 export interface CFDIAddonToggleRequest {
@@ -55,6 +59,9 @@ export interface IStripeSettings {
     stripeCFDISubItemID: string | null;
     cfdiBillingMode?: CFDIBillingMode;
     cfdiMigrationStatus?: CFDIMigrationStatus;
+    cfdiBillingStatus?: CFDIBillingStatus;
+    cfdiScheduledDisableAt?: Date | string | null;
+    stripeCFDIDisableScheduleID?: string | null;
     legacyStripeCFDISubID?: string | null;
     legacyStripeCFDISubItemID?: string | null;
 }

package/test/attendance.metadata.test.ts

@@ -0,0 +1,83 @@
+import { clockIn, clockOut } from "../src/api/attendance/post";
+
+describe("attendance metadata requests", () => {
+  it("forwards client-safe clock-in metadata and strips IP fields", async () => {
+    const post = jest.fn().mockResolvedValue({ data: { data: {} } });
+    const client = {
+      apiToken: "token-123",
+      axiosInstance: { post },
+    } as any;
+
+    await clockIn.call(client, {
+      storeId: "store-1",
+      userId: "user-1",
+      metadata: {
+        source: "web_pos",
+        platform: "MacIntel",
+        language: "es-MX",
+        timezone: "America/Mexico_City",
+        screenWidth: 1440,
+        screenHeight: 900,
+        ipAddress: "1.1.1.1",
+        cfConnectingIp: "1.1.1.2",
+        xForwardedFor: "1.1.1.3",
+      },
+    } as any);
+
+    expect(post).toHaveBeenCalledWith(
+      "api/attendance/clock-in",
+      {
+        storeId: "store-1",
+        userId: "user-1",
+        metadata: {
+          source: "web_pos",
+          platform: "MacIntel",
+          language: "es-MX",
+          timezone: "America/Mexico_City",
+          screenWidth: 1440,
+          screenHeight: 900,
+        },
+      },
+      {
+        headers: { Authorization: "Bearer token-123" },
+      },
+    );
+  });
+
+  it("forwards client-safe clock-out metadata and strips IP fields", async () => {
+    const post = jest.fn().mockResolvedValue({ data: { data: {} } });
+    const client = {
+      apiToken: "token-123",
+      axiosInstance: { post },
+    } as any;
+
+    await clockOut.call(client, {
+      storeId: "store-1",
+      userId: "user-1",
+      metadata: {
+        source: "pos_v2",
+        platform: "ios",
+        appVersion: "2.5.0",
+        deviceId: "device-1",
+        ipAddress: "1.1.1.1",
+      },
+    } as any);
+
+    expect(post).toHaveBeenCalledWith(
+      "api/attendance/clock-out",
+      {
+        storeId: "store-1",
+        userId: "user-1",
+        metadata: {
+          source: "pos_v2",
+          platform: "ios",
+          appVersion: "2.5.0",
+          deviceId: "device-1",
+        },
+      },
+      {
+        headers: { Authorization: "Bearer token-123" },
+      },
+    );
+  });
+});

package/test/companies.cfdiBillingAddon.test.ts

@@ -3,6 +3,7 @@ import {
   enableCFDIAddon,
 } from "../src/api/companies/post";
 import { getCFDIAddonStatus } from "../src/api/companies/get";
+import type { CFDIAddonStatus } from "../src/interfaces/Company";
 
 describe("CFDI billing add-on company endpoints", () => {
   it("enables the CFDI add-on through the billing endpoint", async () => {
@@ -51,4 +52,19 @@ describe("CFDI billing add-on company endpoints", () => {
       { headers: { Authorization: "Bearer token-1" } },
     );
   });
+
+  it("types scheduled disable status fields", () => {
+    const status: CFDIAddonStatus = {
+      enabled: false,
+      billingMode: "main_subscription_item",
+      migrationStatus: "migrated",
+      billingStatus: "cancel_scheduled",
+      scheduledDisableAt: "2026-06-01T00:00:00.000Z",
+      canCancelScheduledDisable: true,
+      isLegacy: false,
+      canToggleFromUI: true,
+    };
+
+    expect(status.billingStatus).toBe("cancel_scheduled");
+  });
 });