washday-sdk 1.6.55 → 1.6.57

package/dist/index.js

@@ -5,5 +5,6 @@ export * from './interfaces/Config';
 export * from './interfaces/Cfdi';
 export * from './interfaces/Auth';
 export * from './interfaces/Customer';
+export * from './interfaces/DomainUrls';
 export * from './interfaces/GoogleMaps';
 export { WashdayClient, utils };

package/dist/interfaces/DomainUrls.js

@@ -0,0 +1 @@
+export {};

package/package.json

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

package/src/api/integrations/post.ts

@@ -1,11 +1,21 @@
 import { WashdayClientInstance } from "../../interfaces/Api";
+import { AppReturnUrlOptions } from "../../interfaces/DomainUrls";
 
 const BASE_ROUTER = 'api/integrations';
 const BASE_ROUTER_MP_ATTEMPTS = 'api/payments/mp/attempts';
 
-export const startMPOAuthFlow = async function (this: WashdayClientInstance, data: {
-    redirectUri: string;
-}): Promise<any> {
+export interface StartMPOAuthFlowRequest extends AppReturnUrlOptions {
+    /**
+     * @deprecated The backend owns the Mercado Pago OAuth callback now.
+     * Use returnToUrl or returnToOrigin/returnPath for the final app redirect.
+     */
+    redirectUri?: string;
+}
+
+export const startMPOAuthFlow = async function (
+    this: WashdayClientInstance,
+    data: StartMPOAuthFlowRequest
+): Promise<any> {
     try {
         const config = {
             headers: { Authorization: `Bearer ${this.apiToken}` }
@@ -119,4 +129,4 @@ export const cancelMPAttempt = async function (this: WashdayClientInstance, data
     catch (error) {
         throw error;
     }
-};
+};

package/src/api/stripe/post.ts

@@ -1,11 +1,25 @@
 import { WashdayClientInstance } from "../../interfaces/Api";
-import axiosInstance from "../axiosInstance";
+import { StripeReturnUrlOptions } from "../../interfaces/DomainUrls";
 const GET_SET_STRIPE = 'api/stripe';
 const GENERATE_CHECKOUT_SESSION = 'api/orders/create-checkout-session';
 
-export const createCreateSuscriptionCheckoutSession = async function (this: WashdayClientInstance, data: {
-    priceId: string
-}): Promise<any> {
+export interface CreateSubscriptionCheckoutSessionRequest extends StripeReturnUrlOptions {
+    priceId: string;
+    planKey?: string;
+}
+
+export interface CreateGetMoreCheckoutSessionRequest extends StripeReturnUrlOptions {
+    priceId: string;
+}
+
+export interface CreateCFDISubscriptionCheckoutSessionRequest extends StripeReturnUrlOptions {}
+
+export interface CreateCustomerPortalSessionRequest extends StripeReturnUrlOptions {}
+
+export const createCreateSuscriptionCheckoutSession = async function (
+    this: WashdayClientInstance,
+    data: CreateSubscriptionCheckoutSessionRequest
+): Promise<any> {
     try {
         const config = {
             headers: { Authorization: `Bearer ${this.apiToken}` }
@@ -18,7 +32,10 @@ export const createCreateSuscriptionCheckoutSession = async function (this: Wash
     }
 };
 
-export const createCustomerPortalSession = async function (this: WashdayClientInstance, data?: any): Promise<any> {
+export const createCustomerPortalSession = async function (
+    this: WashdayClientInstance,
+    data?: CreateCustomerPortalSessionRequest
+): Promise<any> {
     try {
         const config = {
             headers: { Authorization: `Bearer ${this.apiToken}` }
@@ -31,7 +48,10 @@ export const createCustomerPortalSession = async function (this: WashdayClientIn
     }
 };
 
-export const createCFDISuscrptionCheckoutSession = async function (this: WashdayClientInstance, data?: any): Promise<any> {
+export const createCFDISuscrptionCheckoutSession = async function (
+    this: WashdayClientInstance,
+    data?: CreateCFDISubscriptionCheckoutSessionRequest
+): Promise<any> {
     try {
         const config = {
             headers: { Authorization: `Bearer ${this.apiToken}` }
@@ -44,9 +64,10 @@ export const createCFDISuscrptionCheckoutSession = async function (this: Washday
     }
 };
 
-export const createGetMoreCheckoutSession = async function (this: WashdayClientInstance, data: {
-    priceId: string
-}): Promise<any> {
+export const createGetMoreCheckoutSession = async function (
+    this: WashdayClientInstance,
+    data: CreateGetMoreCheckoutSessionRequest
+): Promise<any> {
     try {
         const config = {
             headers: { Authorization: `Bearer ${this.apiToken}` }
@@ -56,4 +77,4 @@ export const createGetMoreCheckoutSession = async function (this: WashdayClientI
         console.error('Error fetching createGetMoreCheckoutSession:', error);
         throw error;
     }
-};
+};

package/src/index.ts

@@ -5,6 +5,14 @@ export * from './interfaces/Config';
 export * from './interfaces/Cfdi';
 export * from './interfaces/Auth';
 export * from './interfaces/Customer';
+export * from './interfaces/DomainUrls';
 export * from './interfaces/GoogleMaps';
+export type { StartMPOAuthFlowRequest } from './api/integrations/post';
+export type {
+  CreateCFDISubscriptionCheckoutSessionRequest,
+  CreateCustomerPortalSessionRequest,
+  CreateGetMoreCheckoutSessionRequest,
+  CreateSubscriptionCheckoutSessionRequest,
+} from './api/stripe/post';
 
 export { WashdayClient, utils };

package/src/interfaces/DomainUrls.ts

@@ -0,0 +1,11 @@
+export interface AppReturnUrlOptions {
+  returnToUrl?: string;
+  returnToOrigin?: string;
+  returnPath?: string;
+  returnToPath?: string;
+}
+
+export interface StripeReturnUrlOptions {
+  returnToUrl?: string;
+  returnToOrigin?: string;
+}

package/src/interfaces/Store.ts

@@ -48,6 +48,10 @@ export interface ICustomersAppConfig {
     }[]
 }
 
+export interface IPublicReceiptConfig {
+    showEvidence?: boolean
+}
+
 export interface IStore {
     name: string,
     streetAddress?: string,
@@ -85,6 +89,7 @@ export interface IStore {
     ticketStructure?: ITicketStructure | null,
     ticketForLaundryStructure?: ITicketForLaundryStructure | null,
     labelTicketStructure?: ILabelTicketStructure | null,
+    publicReceiptConfig?: IPublicReceiptConfig,
     ticketScanMode?: 'order' | 'customer',
     storeDiscounts: IStoreDiscount | null,
     discountCodes: IDiscountCode | null,

package/test/domainUrls.types.test.ts

@@ -0,0 +1,52 @@
+import { StartMPOAuthFlowRequest } from "../src/api/integrations/post";
+import {
+  CreateCFDISubscriptionCheckoutSessionRequest,
+  CreateCustomerPortalSessionRequest,
+  CreateGetMoreCheckoutSessionRequest,
+  CreateSubscriptionCheckoutSessionRequest,
+} from "../src/api/stripe/post";
+import { AppReturnUrlOptions } from "../src/interfaces/DomainUrls";
+
+describe("domain return URL request types", () => {
+  it("supports app and provider return URL options", () => {
+    const appReturnUrlOptions: AppReturnUrlOptions = {
+      returnToUrl: "https://app.washdaypos.com/settings/mercado-pago?storeId=store-1",
+      returnToOrigin: "https://app.washdaypos.com",
+      returnPath: "/settings/mercado-pago?storeId=store-1",
+    };
+
+    const mpRequest: StartMPOAuthFlowRequest = {
+      returnToUrl: "https://app.washdaypos.com/settings/mercado-pago?storeId=store-1",
+    };
+
+    const legacyMpRequest: StartMPOAuthFlowRequest = {
+      redirectUri: "https://app.washday.mx/integrations/mercadopago/callback",
+    };
+
+    const subscriptionRequest: CreateSubscriptionCheckoutSessionRequest = {
+      priceId: "price_1",
+      returnToOrigin: "https://app.washdaypos.com",
+    };
+
+    const extraOrdersRequest: CreateGetMoreCheckoutSessionRequest = {
+      priceId: "price_extra",
+      returnToOrigin: "https://app.washday.mx",
+    };
+
+    const cfdiRequest: CreateCFDISubscriptionCheckoutSessionRequest = {
+      returnToUrl: "https://app.washdaypos.com/settings/company-info",
+    };
+
+    const portalRequest: CreateCustomerPortalSessionRequest = {
+      returnToUrl: "https://app.washdaypos.com/settings",
+    };
+
+    expect(appReturnUrlOptions.returnToOrigin).toBe("https://app.washdaypos.com");
+    expect(mpRequest.returnToUrl).toBe("https://app.washdaypos.com/settings/mercado-pago?storeId=store-1");
+    expect(legacyMpRequest.redirectUri).toBe("https://app.washday.mx/integrations/mercadopago/callback");
+    expect(subscriptionRequest.returnToOrigin).toBe("https://app.washdaypos.com");
+    expect(extraOrdersRequest.returnToOrigin).toBe("https://app.washday.mx");
+    expect(cfdiRequest.returnToUrl).toBe("https://app.washdaypos.com/settings/company-info");
+    expect(portalRequest.returnToUrl).toBe("https://app.washdaypos.com/settings");
+  });
+});

package/test/integrations.domainReturnUrls.test.ts

@@ -0,0 +1,25 @@
+import { startMPOAuthFlow } from "../src/api/integrations/post";
+
+describe("startMPOAuthFlow return URL options", () => {
+  it("posts returnToUrl without requiring callers to provide the OAuth callback redirectUri", async () => {
+    const post = jest.fn().mockResolvedValue({ data: { data: { authUrl: "https://mp.example/auth" } } });
+    const client = {
+      apiToken: "token-1",
+      axiosInstance: { post },
+    } as any;
+
+    await startMPOAuthFlow.call(client, {
+      returnToUrl: "https://app.washdaypos.com/settings/mercado-pago?storeId=store-1",
+    });
+
+    expect(post).toHaveBeenCalledWith(
+      "api/integrations/mp/oauth/start",
+      {
+        returnToUrl: "https://app.washdaypos.com/settings/mercado-pago?storeId=store-1",
+      },
+      {
+        headers: { Authorization: "Bearer token-1" },
+      },
+    );
+  });
+});

package/test/store.publicReceiptConfig.test.ts

@@ -0,0 +1,14 @@
+import { IPublicReceiptConfig, IStore } from "../src/interfaces/Store";
+
+describe("store public receipt config types", () => {
+  it("accepts publicReceiptConfig.showEvidence", () => {
+    const publicReceiptConfig: IPublicReceiptConfig = {
+      showEvidence: false,
+    };
+    const store: Partial<IStore> = {
+      publicReceiptConfig,
+    };
+
+    expect(store.publicReceiptConfig?.showEvidence).toBe(false);
+  });
+});

package/test/stripe.domainReturnUrls.test.ts

@@ -0,0 +1,92 @@
+import {
+  createCFDISuscrptionCheckoutSession,
+  createCreateSuscriptionCheckoutSession,
+  createCustomerPortalSession,
+  createGetMoreCheckoutSession,
+} from "../src/api/stripe/post";
+
+describe("stripe checkout return URL options", () => {
+  it("passes returnToOrigin for subscription checkout", async () => {
+    const post = jest.fn().mockResolvedValue({ data: { data: { url: "https://stripe.example" } } });
+    const client = {
+      apiToken: "token-1",
+      axiosInstance: { post },
+    } as any;
+
+    await createCreateSuscriptionCheckoutSession.call(client, {
+      priceId: "price_1",
+      returnToOrigin: "https://app.washdaypos.com",
+    });
+
+    expect(post).toHaveBeenCalledWith(
+      "api/stripe/create-subscription-checkout-session",
+      {
+        priceId: "price_1",
+        returnToOrigin: "https://app.washdaypos.com",
+      },
+      {
+        headers: { Authorization: "Bearer token-1" },
+      },
+    );
+  });
+
+  it("passes returnToOrigin for extra orders checkout", async () => {
+    const post = jest.fn().mockResolvedValue({ data: { data: { url: "https://stripe.example" } } });
+    const client = {
+      apiToken: "token-1",
+      axiosInstance: { post },
+    } as any;
+
+    await createGetMoreCheckoutSession.call(client, {
+      priceId: "price_extra",
+      returnToOrigin: "https://app.washday.mx",
+    });
+
+    expect(post).toHaveBeenCalledWith(
+      "api/orders/create-checkout-session",
+      {
+        priceId: "price_extra",
+        returnToOrigin: "https://app.washday.mx",
+      },
+      {
+        headers: { Authorization: "Bearer token-1" },
+      },
+    );
+  });
+
+  it("passes returnToUrl for CFDI checkout and customer portal", async () => {
+    const post = jest.fn().mockResolvedValue({ data: { data: { url: "https://stripe.example" } } });
+    const client = {
+      apiToken: "token-1",
+      axiosInstance: { post },
+    } as any;
+
+    await createCFDISuscrptionCheckoutSession.call(client, {
+      returnToUrl: "https://app.washdaypos.com/settings/company-info",
+    });
+    await createCustomerPortalSession.call(client, {
+      returnToUrl: "https://app.washdaypos.com/settings",
+    });
+
+    expect(post).toHaveBeenNthCalledWith(
+      1,
+      "api/stripe/create-cfdi-subscription-checkout-session",
+      {
+        returnToUrl: "https://app.washdaypos.com/settings/company-info",
+      },
+      {
+        headers: { Authorization: "Bearer token-1" },
+      },
+    );
+    expect(post).toHaveBeenNthCalledWith(
+      2,
+      "api/stripe/create-customer-portal-session",
+      {
+        returnToUrl: "https://app.washdaypos.com/settings",
+      },
+      {
+        headers: { Authorization: "Bearer token-1" },
+      },
+    );
+  });
+});