@greatapps/common 1.1.713 → 1.1.714

package/dist/testing/constants.mjs

@@ -0,0 +1,21 @@
+const TEST_IDS = {
+  wl: 1,
+  account: 123,
+  user: 456,
+  page: 789
+};
+const TEST_API = {
+  gapps: "https://gapps.test",
+  gpages: "https://gpages.test",
+  masterToken: "test-master-token",
+  domain: "app.test"
+};
+const TEST_API_VERSION = "v1";
+const TEST_API_LOCALE = "pt-br";
+export {
+  TEST_API,
+  TEST_API_LOCALE,
+  TEST_API_VERSION,
+  TEST_IDS
+};
+//# sourceMappingURL=constants.mjs.map

package/dist/testing/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/constants.ts"],"sourcesContent":["// Fixed identity and endpoints used across the test infra. Single source of truth: the same\n// object feeds DUMMY_AUTH_TOKEN (via createTestJwt), the factories and the request handlers, and\n// consumer apps must mirror it in their test env (GAPPS_R3_API_URL etc.) so the URL the ApiClient\n// builds matches the one the handlers expect.\nexport const TEST_IDS = {\n  wl: 1,\n  account: 123,\n  user: 456,\n  page: 789,\n} as const;\n\n// Bases the apps MUST export as test env:\n//   GAPPS_R3_API_URL = TEST_API.gapps\n//   GPAGES_R3_API_URL = TEST_API.gpages\n//   WHITELABEL_TOKEN_MASTER = TEST_API.masterToken\n//   WHITELABEL_DOMAIN = TEST_API.domain\n// `.test` domains never resolve on the real network, so a leaked unhandled request fails loudly\n// instead of hitting a real backend.\nexport const TEST_API = {\n  gapps: 'https://gapps.test',\n  gpages: 'https://gpages.test',\n  masterToken: 'test-master-token',\n  domain: 'app.test',\n} as const;\n\n// Fixed locale and version the ApiClient uses to build the URL (`/v1/pt-br/{wl}`).\nexport const TEST_API_VERSION = 'v1';\nexport const TEST_API_LOCALE = 'pt-br';\n"],"mappings":"AAIO,MAAM,WAAW;AAAA,EACtB,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AACR;AASO,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,QAAQ;AACV;AAGO,MAAM,mBAAmB;AACzB,MAAM,kBAAkB;","names":[]}

package/dist/testing/factories/account.factory.mjs

@@ -0,0 +1,38 @@
+import { faker } from "@faker-js/faker";
+import { TEST_IDS } from "../constants";
+import { createMock } from "./create-mock";
+const createAccountMock = createMock((overrides) => ({
+  id: overrides?.id ?? TEST_IDS.account,
+  id_wl: overrides?.id_wl ?? TEST_IDS.wl,
+  id_affiliate: overrides?.id_affiliate ?? 0,
+  id_api: overrides?.id_api ?? 1,
+  name: overrides?.name || faker.company.name(),
+  language: overrides?.language ?? "pt-br",
+  timezone: overrides?.timezone ?? "America/Sao_Paulo",
+  currency: overrides?.currency ?? "brl",
+  verified: overrides?.verified ?? true,
+  bussiness_type: overrides?.bussiness_type ?? 1,
+  gateway: overrides?.gateway ?? "stripe",
+  gateway_customer_id: overrides?.gateway_customer_id ?? null,
+  origin: overrides?.origin ?? null,
+  zipcode: overrides?.zipcode ?? null,
+  address: overrides?.address ?? null,
+  address_number: overrides?.address_number ?? null,
+  address_complement: overrides?.address_complement ?? null,
+  neighborhood: overrides?.neighborhood ?? null,
+  city: overrides?.city ?? null,
+  state: overrides?.state ?? null,
+  country: overrides?.country ?? "BR",
+  financial_document: overrides?.financial_document ?? null,
+  financial_name: overrides?.financial_name ?? null,
+  financial_email: overrides?.financial_email ?? null,
+  financial_document_type: overrides?.financial_document_type ?? 1,
+  deleted: overrides?.deleted ?? 0,
+  datetime_add: overrides?.datetime_add || "2025-01-01 00:00:00",
+  datetime_alt: overrides?.datetime_alt || "2025-01-01 00:00:00",
+  datetime_del: overrides?.datetime_del ?? null
+}));
+export {
+  createAccountMock
+};
+//# sourceMappingURL=account.factory.mjs.map

package/dist/testing/factories/account.factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/factories/account.factory.ts"],"sourcesContent":["import { faker } from '@faker-js/faker';\nimport { Account } from '../../modules/accounts/types';\nimport { TEST_IDS } from '../constants';\nimport { createMock } from './create-mock';\n\n// Identity fields (id/id_wl) are fixed to TEST_IDS; cosmetic fields use faker.\nexport const createAccountMock = createMock<Account, Partial<Account>>((overrides) => ({\n  id: overrides?.id ?? TEST_IDS.account,\n  id_wl: overrides?.id_wl ?? TEST_IDS.wl,\n  id_affiliate: overrides?.id_affiliate ?? 0,\n  id_api: overrides?.id_api ?? 1,\n  name: overrides?.name || faker.company.name(),\n  language: overrides?.language ?? 'pt-br',\n  timezone: overrides?.timezone ?? 'America/Sao_Paulo',\n  currency: overrides?.currency ?? 'brl',\n  verified: overrides?.verified ?? true,\n  bussiness_type: overrides?.bussiness_type ?? 1,\n  gateway: overrides?.gateway ?? 'stripe',\n  gateway_customer_id: overrides?.gateway_customer_id ?? null,\n  origin: overrides?.origin ?? null,\n  zipcode: overrides?.zipcode ?? null,\n  address: overrides?.address ?? null,\n  address_number: overrides?.address_number ?? null,\n  address_complement: overrides?.address_complement ?? null,\n  neighborhood: overrides?.neighborhood ?? null,\n  city: overrides?.city ?? null,\n  state: overrides?.state ?? null,\n  country: overrides?.country ?? 'BR',\n  financial_document: overrides?.financial_document ?? null,\n  financial_name: overrides?.financial_name ?? null,\n  financial_email: overrides?.financial_email ?? null,\n  financial_document_type: overrides?.financial_document_type ?? 1,\n  deleted: overrides?.deleted ?? 0,\n  datetime_add: overrides?.datetime_add || '2025-01-01 00:00:00',\n  datetime_alt: overrides?.datetime_alt || '2025-01-01 00:00:00',\n  datetime_del: overrides?.datetime_del ?? null,\n}));\n"],"mappings":"AAAA,SAAS,aAAa;AAEtB,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAGpB,MAAM,oBAAoB,WAAsC,CAAC,eAAe;AAAA,EACrF,IAAI,WAAW,MAAM,SAAS;AAAA,EAC9B,OAAO,WAAW,SAAS,SAAS;AAAA,EACpC,cAAc,WAAW,gBAAgB;AAAA,EACzC,QAAQ,WAAW,UAAU;AAAA,EAC7B,MAAM,WAAW,QAAQ,MAAM,QAAQ,KAAK;AAAA,EAC5C,UAAU,WAAW,YAAY;AAAA,EACjC,UAAU,WAAW,YAAY;AAAA,EACjC,UAAU,WAAW,YAAY;AAAA,EACjC,UAAU,WAAW,YAAY;AAAA,EACjC,gBAAgB,WAAW,kBAAkB;AAAA,EAC7C,SAAS,WAAW,WAAW;AAAA,EAC/B,qBAAqB,WAAW,uBAAuB;AAAA,EACvD,QAAQ,WAAW,UAAU;AAAA,EAC7B,SAAS,WAAW,WAAW;AAAA,EAC/B,SAAS,WAAW,WAAW;AAAA,EAC/B,gBAAgB,WAAW,kBAAkB;AAAA,EAC7C,oBAAoB,WAAW,sBAAsB;AAAA,EACrD,cAAc,WAAW,gBAAgB;AAAA,EACzC,MAAM,WAAW,QAAQ;AAAA,EACzB,OAAO,WAAW,SAAS;AAAA,EAC3B,SAAS,WAAW,WAAW;AAAA,EAC/B,oBAAoB,WAAW,sBAAsB;AAAA,EACrD,gBAAgB,WAAW,kBAAkB;AAAA,EAC7C,iBAAiB,WAAW,mBAAmB;AAAA,EAC/C,yBAAyB,WAAW,2BAA2B;AAAA,EAC/D,SAAS,WAAW,WAAW;AAAA,EAC/B,cAAc,WAAW,gBAAgB;AAAA,EACzC,cAAc,WAAW,gBAAgB;AAAA,EACzC,cAAc,WAAW,gBAAgB;AAC3C,EAAE;","names":[]}

package/dist/testing/factories/create-mock.mjs

@@ -0,0 +1,16 @@
+const resetters = /* @__PURE__ */ new Set();
+function createMock(factory) {
+  let instance = factory();
+  resetters.add(() => {
+    instance = factory();
+  });
+  return (overrides) => overrides ? factory(overrides) : instance;
+}
+function resetMocks() {
+  for (const reset of resetters) reset();
+}
+export {
+  createMock,
+  resetMocks
+};
+//# sourceMappingURL=create-mock.mjs.map

package/dist/testing/factories/create-mock.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/factories/create-mock.ts"],"sourcesContent":["type Factory<T, O> = (overrides?: O) => T;\n\n// Reset registry for the cached defaults. Runner-agnostic on purpose: these factories also run\n// under `next dev` (E2E request handlers) where vitest's `beforeEach` does not exist, so the app\n// calls `resetMocks()` from its own `beforeEach`.\nconst resetters = new Set<() => void>();\n\n// createMock(factory) returns a getter that:\n//   - without overrides → returns the SAME default instance within a test (stable for asserts);\n//   - with overrides → returns a NEW instance with those fields replaced.\n// Between tests, `resetMocks()` refreshes the defaults.\nexport function createMock<T, O = Partial<T>>(factory: Factory<T, O>): Factory<T, O> {\n  let instance = factory();\n  resetters.add(() => {\n    instance = factory();\n  });\n  return (overrides?: O): T => (overrides ? factory(overrides) : instance);\n}\n\n// Refreshes every default cached by createMock. Call it from the setup's beforeEach.\nexport function resetMocks(): void {\n  for (const reset of resetters) reset();\n}\n"],"mappings":"AAKA,MAAM,YAAY,oBAAI,IAAgB;AAM/B,SAAS,WAA8B,SAAuC;AACnF,MAAI,WAAW,QAAQ;AACvB,YAAU,IAAI,MAAM;AAClB,eAAW,QAAQ;AAAA,EACrB,CAAC;AACD,SAAO,CAAC,cAAsB,YAAY,QAAQ,SAAS,IAAI;AACjE;AAGO,SAAS,aAAmB;AACjC,aAAW,SAAS,UAAW,OAAM;AACvC;","names":[]}

package/dist/testing/factories/index.mjs

@@ -0,0 +1,21 @@
+import { createMock, resetMocks } from "./create-mock";
+import { createTestJwt } from "./jwt";
+import { createUserMock } from "./user.factory";
+import { createAccountMock } from "./account.factory";
+import { createWhitelabelMock, createWhitelabelTokenMock } from "./whitelabel.factory";
+import { createSubscriptionMock, createSubscriptionItemMock } from "./subscription.factory";
+import { createPlanMock, createPlanItemMock } from "./plan.factory";
+export {
+  createAccountMock,
+  createMock,
+  createPlanItemMock,
+  createPlanMock,
+  createSubscriptionItemMock,
+  createSubscriptionMock,
+  createTestJwt,
+  createUserMock,
+  createWhitelabelMock,
+  createWhitelabelTokenMock,
+  resetMocks
+};
+//# sourceMappingURL=index.mjs.map

package/dist/testing/factories/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/factories/index.ts"],"sourcesContent":["export { createMock, resetMocks } from './create-mock';\nexport { createTestJwt, type TestJwtClaims } from './jwt';\nexport { createUserMock } from './user.factory';\nexport { createAccountMock } from './account.factory';\nexport { createWhitelabelMock, createWhitelabelTokenMock } from './whitelabel.factory';\nexport { createSubscriptionMock, createSubscriptionItemMock } from './subscription.factory';\nexport { createPlanMock, createPlanItemMock } from './plan.factory';\n"],"mappings":"AAAA,SAAS,YAAY,kBAAkB;AACvC,SAAS,qBAAyC;AAClD,SAAS,sBAAsB;AAC/B,SAAS,yBAAyB;AAClC,SAAS,sBAAsB,iCAAiC;AAChE,SAAS,wBAAwB,kCAAkC;AACnE,SAAS,gBAAgB,0BAA0B;","names":[]}

package/dist/testing/factories/jwt.mjs

@@ -0,0 +1,33 @@
+import { TEST_IDS } from "../constants";
+function b64(value) {
+  return btoa(JSON.stringify(value));
+}
+function createTestJwt(claims = {}) {
+  const payload = {
+    session: {
+      location: {
+        continent: "SA",
+        country: claims.country ?? "BR",
+        region: "SP",
+        city: "Sao Paulo",
+        latitude: "0",
+        longitude: "0"
+      },
+      ip: "127.0.0.1",
+      timezone: "America/Sao_Paulo",
+      agent: "test",
+      code: null
+    },
+    id_wl: String(claims.id_wl ?? TEST_IDS.wl),
+    id_account: claims.id_account ?? TEST_IDS.account,
+    id_user: claims.id_user ?? TEST_IDS.user,
+    iss: "test",
+    aud: "test",
+    iat: 17e8
+  };
+  return `${b64({ alg: "none", typ: "JWT" })}.${b64(payload)}.sig`;
+}
+export {
+  createTestJwt
+};
+//# sourceMappingURL=jwt.mjs.map

package/dist/testing/factories/jwt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/factories/jwt.ts"],"sourcesContent":["import type { JWTPayload } from '../../modules/users/schema';\nimport { TEST_IDS } from '../constants';\n\nfunction b64(value: unknown): string {\n  // getUserContext decodes the payload with `atob(token.split('.')[1])`, so standard base64 works.\n  return btoa(JSON.stringify(value));\n}\n\nexport interface TestJwtClaims {\n  id_wl?: number;\n  id_account?: number;\n  id_user?: number;\n  // Country used by resolveLocale (session.location.country).\n  country?: string;\n}\n\n// Builds a fake JWT (placeholder signature) whose payload is decodable by getUserContext and\n// resolveLocale. Used as DUMMY_AUTH_TOKEN: the common auth bypasses verification when that env is\n// set, so only the payload matters.\nexport function createTestJwt(claims: TestJwtClaims = {}): string {\n  const payload: JWTPayload = {\n    session: {\n      location: {\n        continent: 'SA',\n        country: claims.country ?? 'BR',\n        region: 'SP',\n        city: 'Sao Paulo',\n        latitude: '0',\n        longitude: '0',\n      },\n      ip: '127.0.0.1',\n      timezone: 'America/Sao_Paulo',\n      agent: 'test',\n      code: null,\n    },\n    id_wl: String(claims.id_wl ?? TEST_IDS.wl),\n    id_account: claims.id_account ?? TEST_IDS.account,\n    id_user: claims.id_user ?? TEST_IDS.user,\n    iss: 'test',\n    aud: 'test',\n    iat: 1700000000,\n  };\n  return `${b64({ alg: 'none', typ: 'JWT' })}.${b64(payload)}.sig`;\n}\n"],"mappings":"AACA,SAAS,gBAAgB;AAEzB,SAAS,IAAI,OAAwB;AAEnC,SAAO,KAAK,KAAK,UAAU,KAAK,CAAC;AACnC;AAaO,SAAS,cAAc,SAAwB,CAAC,GAAW;AAChE,QAAM,UAAsB;AAAA,IAC1B,SAAS;AAAA,MACP,UAAU;AAAA,QACR,WAAW;AAAA,QACX,SAAS,OAAO,WAAW;AAAA,QAC3B,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,UAAU;AAAA,QACV,WAAW;AAAA,MACb;AAAA,MACA,IAAI;AAAA,MACJ,UAAU;AAAA,MACV,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,OAAO,OAAO,OAAO,SAAS,SAAS,EAAE;AAAA,IACzC,YAAY,OAAO,cAAc,SAAS;AAAA,IAC1C,SAAS,OAAO,WAAW,SAAS;AAAA,IACpC,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,EACP;AACA,SAAO,GAAG,IAAI,EAAE,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC;AAC5D;","names":[]}

package/dist/testing/factories/plan.factory.mjs

@@ -0,0 +1,23 @@
+import { faker } from "@faker-js/faker";
+import { createMock } from "./create-mock";
+const createPlanItemMock = createMock((overrides) => ({
+  id_addon: overrides?.id_addon ?? 2,
+  quantity: overrides?.quantity ?? 10,
+  value: overrides?.value ?? 9990,
+  base: overrides?.base ?? true
+}));
+const createPlanMock = createMock((overrides) => ({
+  id: overrides?.id ?? faker.number.int({ min: 1, max: 9999 }),
+  name: overrides?.name || faker.commerce.productName(),
+  value: overrides?.value ?? 9990,
+  currency: overrides?.currency ?? "brl",
+  type: overrides?.type ?? "paid",
+  discount_semester: overrides?.discount_semester ?? 0,
+  discount_annual: overrides?.discount_annual ?? 0,
+  items: overrides?.items ?? [createPlanItemMock()]
+}));
+export {
+  createPlanItemMock,
+  createPlanMock
+};
+//# sourceMappingURL=plan.factory.mjs.map

package/dist/testing/factories/plan.factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/factories/plan.factory.ts"],"sourcesContent":["import { faker } from '@faker-js/faker';\nimport { Plan, PlanItem } from '../../modules/plans/types/plan.type';\nimport { createMock } from './create-mock';\n\nexport const createPlanItemMock = createMock<PlanItem, Partial<PlanItem>>((overrides) => ({\n  id_addon: overrides?.id_addon ?? 2,\n  quantity: overrides?.quantity ?? 10,\n  value: overrides?.value ?? 9990,\n  base: overrides?.base ?? true,\n}));\n\nexport const createPlanMock = createMock<Plan, Partial<Plan>>((overrides) => ({\n  id: overrides?.id ?? faker.number.int({ min: 1, max: 9999 }),\n  name: overrides?.name || faker.commerce.productName(),\n  value: overrides?.value ?? 9990,\n  currency: overrides?.currency ?? 'brl',\n  type: overrides?.type ?? 'paid',\n  discount_semester: overrides?.discount_semester ?? 0,\n  discount_annual: overrides?.discount_annual ?? 0,\n  items: overrides?.items ?? [createPlanItemMock()],\n}));\n"],"mappings":"AAAA,SAAS,aAAa;AAEtB,SAAS,kBAAkB;AAEpB,MAAM,qBAAqB,WAAwC,CAAC,eAAe;AAAA,EACxF,UAAU,WAAW,YAAY;AAAA,EACjC,UAAU,WAAW,YAAY;AAAA,EACjC,OAAO,WAAW,SAAS;AAAA,EAC3B,MAAM,WAAW,QAAQ;AAC3B,EAAE;AAEK,MAAM,iBAAiB,WAAgC,CAAC,eAAe;AAAA,EAC5E,IAAI,WAAW,MAAM,MAAM,OAAO,IAAI,EAAE,KAAK,GAAG,KAAK,KAAK,CAAC;AAAA,EAC3D,MAAM,WAAW,QAAQ,MAAM,SAAS,YAAY;AAAA,EACpD,OAAO,WAAW,SAAS;AAAA,EAC3B,UAAU,WAAW,YAAY;AAAA,EACjC,MAAM,WAAW,QAAQ;AAAA,EACzB,mBAAmB,WAAW,qBAAqB;AAAA,EACnD,iBAAiB,WAAW,mBAAmB;AAAA,EAC/C,OAAO,WAAW,SAAS,CAAC,mBAAmB,CAAC;AAClD,EAAE;","names":[]}

package/dist/testing/factories/subscription.factory.mjs

@@ -0,0 +1,52 @@
+import { faker } from "@faker-js/faker";
+import { TEST_IDS } from "../constants";
+import { createMock } from "./create-mock";
+const createSubscriptionItemMock = createMock(
+  (overrides) => ({
+    id: overrides?.id ?? faker.number.int({ min: 1, max: 99999 }),
+    deleted: overrides?.deleted ?? 0,
+    datetime_add: overrides?.datetime_add ?? /* @__PURE__ */ new Date("2025-01-01T00:00:00Z"),
+    id_wl: overrides?.id_wl ?? TEST_IDS.wl,
+    id_subscription: overrides?.id_subscription ?? 1,
+    id_addon: overrides?.id_addon ?? null,
+    value: overrides?.value ?? 9990,
+    currency: overrides?.currency ?? "brl",
+    quantity: overrides?.quantity ?? 1,
+    payment_status: overrides?.payment_status ?? 1,
+    id_charge: overrides?.id_charge ?? null,
+    trial: overrides?.trial ?? true
+  })
+);
+const createSubscriptionMock = createMock(
+  (overrides) => ({
+    id: overrides?.id ?? faker.number.int({ min: 1, max: 99999 }),
+    deleted: overrides?.deleted ?? 0,
+    datetime_add: overrides?.datetime_add ?? /* @__PURE__ */ new Date("2025-01-01T00:00:00Z"),
+    id_wl: overrides?.id_wl ?? TEST_IDS.wl,
+    id_account: overrides?.id_account ?? TEST_IDS.account,
+    id_card: overrides?.id_card ?? null,
+    id_coupon: overrides?.id_coupon ?? null,
+    type: overrides?.type ?? "recurring",
+    payment_method: overrides?.payment_method ?? 1,
+    periodicity: overrides?.periodicity ?? 1,
+    value: overrides?.value ?? 9990,
+    id_product: overrides?.id_product ?? 1,
+    id_plan: overrides?.id_plan ?? 1,
+    id_gateway: overrides?.id_gateway ?? null,
+    gateway_account: overrides?.gateway_account ?? null,
+    date_hiring: overrides?.date_hiring ?? /* @__PURE__ */ new Date("2025-01-01"),
+    date_due: overrides?.date_due ?? /* @__PURE__ */ new Date("2099-01-01"),
+    date_cancellation: overrides?.date_cancellation ?? null,
+    date_verification: overrides?.date_verification ?? null,
+    cancellation_reason: overrides?.cancellation_reason ?? null,
+    cancellation_description: overrides?.cancellation_description ?? null,
+    active: overrides?.active ?? true,
+    charged: overrides?.charged ?? true,
+    items: overrides?.items ?? [createSubscriptionItemMock()]
+  })
+);
+export {
+  createSubscriptionItemMock,
+  createSubscriptionMock
+};
+//# sourceMappingURL=subscription.factory.mjs.map

package/dist/testing/factories/subscription.factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/factories/subscription.factory.ts"],"sourcesContent":["import { faker } from '@faker-js/faker';\nimport { Subscription, SubscriptionItem } from '../../modules/subscriptions/types/subscription.type';\nimport { TEST_IDS } from '../constants';\nimport { createMock } from './create-mock';\n\n// Dates are Date objects (the inferred output of the schema).\nexport const createSubscriptionItemMock = createMock<SubscriptionItem, Partial<SubscriptionItem>>(\n  (overrides) => ({\n    id: overrides?.id ?? faker.number.int({ min: 1, max: 99999 }),\n    deleted: overrides?.deleted ?? 0,\n    datetime_add: overrides?.datetime_add ?? new Date('2025-01-01T00:00:00Z'),\n    id_wl: overrides?.id_wl ?? TEST_IDS.wl,\n    id_subscription: overrides?.id_subscription ?? 1,\n    id_addon: overrides?.id_addon ?? null,\n    value: overrides?.value ?? 9990,\n    currency: overrides?.currency ?? 'brl',\n    quantity: overrides?.quantity ?? 1,\n    payment_status: overrides?.payment_status ?? 1,\n    id_charge: overrides?.id_charge ?? null,\n    trial: overrides?.trial ?? true,\n  }),\n);\n\n// Default: an active subscription with a future due date (a valid trial).\nexport const createSubscriptionMock = createMock<Subscription, Partial<Subscription>>(\n  (overrides) => ({\n    id: overrides?.id ?? faker.number.int({ min: 1, max: 99999 }),\n    deleted: overrides?.deleted ?? 0,\n    datetime_add: overrides?.datetime_add ?? new Date('2025-01-01T00:00:00Z'),\n    id_wl: overrides?.id_wl ?? TEST_IDS.wl,\n    id_account: overrides?.id_account ?? TEST_IDS.account,\n    id_card: overrides?.id_card ?? null,\n    id_coupon: overrides?.id_coupon ?? null,\n    type: overrides?.type ?? 'recurring',\n    payment_method: overrides?.payment_method ?? 1,\n    periodicity: overrides?.periodicity ?? 1,\n    value: overrides?.value ?? 9990,\n    id_product: overrides?.id_product ?? 1,\n    id_plan: overrides?.id_plan ?? 1,\n    id_gateway: overrides?.id_gateway ?? null,\n    gateway_account: overrides?.gateway_account ?? null,\n    date_hiring: overrides?.date_hiring ?? new Date('2025-01-01'),\n    date_due: overrides?.date_due ?? new Date('2099-01-01'),\n    date_cancellation: overrides?.date_cancellation ?? null,\n    date_verification: overrides?.date_verification ?? null,\n    cancellation_reason: overrides?.cancellation_reason ?? null,\n    cancellation_description: overrides?.cancellation_description ?? null,\n    active: overrides?.active ?? true,\n    charged: overrides?.charged ?? true,\n    items: overrides?.items ?? [createSubscriptionItemMock()],\n  }),\n);\n"],"mappings":"AAAA,SAAS,aAAa;AAEtB,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAGpB,MAAM,6BAA6B;AAAA,EACxC,CAAC,eAAe;AAAA,IACd,IAAI,WAAW,MAAM,MAAM,OAAO,IAAI,EAAE,KAAK,GAAG,KAAK,MAAM,CAAC;AAAA,IAC5D,SAAS,WAAW,WAAW;AAAA,IAC/B,cAAc,WAAW,gBAAgB,oBAAI,KAAK,sBAAsB;AAAA,IACxE,OAAO,WAAW,SAAS,SAAS;AAAA,IACpC,iBAAiB,WAAW,mBAAmB;AAAA,IAC/C,UAAU,WAAW,YAAY;AAAA,IACjC,OAAO,WAAW,SAAS;AAAA,IAC3B,UAAU,WAAW,YAAY;AAAA,IACjC,UAAU,WAAW,YAAY;AAAA,IACjC,gBAAgB,WAAW,kBAAkB;AAAA,IAC7C,WAAW,WAAW,aAAa;AAAA,IACnC,OAAO,WAAW,SAAS;AAAA,EAC7B;AACF;AAGO,MAAM,yBAAyB;AAAA,EACpC,CAAC,eAAe;AAAA,IACd,IAAI,WAAW,MAAM,MAAM,OAAO,IAAI,EAAE,KAAK,GAAG,KAAK,MAAM,CAAC;AAAA,IAC5D,SAAS,WAAW,WAAW;AAAA,IAC/B,cAAc,WAAW,gBAAgB,oBAAI,KAAK,sBAAsB;AAAA,IACxE,OAAO,WAAW,SAAS,SAAS;AAAA,IACpC,YAAY,WAAW,cAAc,SAAS;AAAA,IAC9C,SAAS,WAAW,WAAW;AAAA,IAC/B,WAAW,WAAW,aAAa;AAAA,IACnC,MAAM,WAAW,QAAQ;AAAA,IACzB,gBAAgB,WAAW,kBAAkB;AAAA,IAC7C,aAAa,WAAW,eAAe;AAAA,IACvC,OAAO,WAAW,SAAS;AAAA,IAC3B,YAAY,WAAW,cAAc;AAAA,IACrC,SAAS,WAAW,WAAW;AAAA,IAC/B,YAAY,WAAW,cAAc;AAAA,IACrC,iBAAiB,WAAW,mBAAmB;AAAA,IAC/C,aAAa,WAAW,eAAe,oBAAI,KAAK,YAAY;AAAA,IAC5D,UAAU,WAAW,YAAY,oBAAI,KAAK,YAAY;AAAA,IACtD,mBAAmB,WAAW,qBAAqB;AAAA,IACnD,mBAAmB,WAAW,qBAAqB;AAAA,IACnD,qBAAqB,WAAW,uBAAuB;AAAA,IACvD,0BAA0B,WAAW,4BAA4B;AAAA,IACjE,QAAQ,WAAW,UAAU;AAAA,IAC7B,SAAS,WAAW,WAAW;AAAA,IAC/B,OAAO,WAAW,SAAS,CAAC,2BAA2B,CAAC;AAAA,EAC1D;AACF;","names":[]}

package/dist/testing/factories/user.factory.mjs

@@ -0,0 +1,36 @@
+import { faker } from "@faker-js/faker";
+import { UserProfile } from "../../modules/users/schema";
+import { TEST_IDS } from "../constants";
+import { createMock } from "./create-mock";
+const createUserMock = createMock((overrides) => ({
+  id: overrides?.id ?? TEST_IDS.user,
+  id_wl: overrides?.id_wl ?? TEST_IDS.wl,
+  id_account: overrides?.id_account ?? TEST_IDS.account,
+  id_api: overrides?.id_api ?? 1,
+  name: overrides?.name || faker.person.firstName(),
+  last_name: overrides?.last_name || faker.person.lastName(),
+  email: overrides?.email || faker.internet.email().toLowerCase(),
+  ddi: overrides?.ddi || "55",
+  phone: overrides?.phone || faker.string.numeric(11),
+  rg: overrides?.rg ?? null,
+  cpf: overrides?.cpf ?? null,
+  gender: overrides?.gender ?? 0,
+  two_factor_authentication: overrides?.two_factor_authentication ?? false,
+  google_sub: overrides?.google_sub ?? null,
+  google_linked_at: overrides?.google_linked_at ?? null,
+  profile: overrides?.profile ?? UserProfile.owner,
+  language: overrides?.language ?? "pt-br",
+  receive_sms: overrides?.receive_sms ?? false,
+  receive_email: overrides?.receive_email ?? true,
+  photo: overrides?.photo ?? null,
+  deleted: overrides?.deleted ?? 0,
+  datetime_alt: overrides?.datetime_alt || "2025-01-01 00:00:00",
+  datetime_del: overrides?.datetime_del ?? null,
+  datetime_add: overrides?.datetime_add || "2025-01-01 00:00:00",
+  total_projects: overrides?.total_projects ?? 1,
+  projects: overrides?.projects ?? [{ id: 1, title: faker.company.name() }]
+}));
+export {
+  createUserMock
+};
+//# sourceMappingURL=user.factory.mjs.map

package/dist/testing/factories/user.factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/factories/user.factory.ts"],"sourcesContent":["import { faker } from '@faker-js/faker';\nimport { User, UserProfile } from '../../modules/users/schema';\nimport { TEST_IDS } from '../constants';\nimport { createMock } from './create-mock';\n\n// Identity fields (id/id_wl/id_account) are fixed to TEST_IDS by default — the auth chain and the\n// request-URL matching depend on them; override explicitly when needed. Cosmetic fields use faker.\nexport const createUserMock = createMock<User, Partial<User>>((overrides) => ({\n  id: overrides?.id ?? TEST_IDS.user,\n  id_wl: overrides?.id_wl ?? TEST_IDS.wl,\n  id_account: overrides?.id_account ?? TEST_IDS.account,\n  id_api: overrides?.id_api ?? 1,\n  name: overrides?.name || faker.person.firstName(),\n  last_name: overrides?.last_name || faker.person.lastName(),\n  email: overrides?.email || faker.internet.email().toLowerCase(),\n  ddi: overrides?.ddi || '55',\n  phone: overrides?.phone || faker.string.numeric(11),\n  rg: overrides?.rg ?? null,\n  cpf: overrides?.cpf ?? null,\n  gender: overrides?.gender ?? 0,\n  two_factor_authentication: overrides?.two_factor_authentication ?? false,\n  google_sub: overrides?.google_sub ?? null,\n  google_linked_at: overrides?.google_linked_at ?? null,\n  profile: overrides?.profile ?? UserProfile.owner,\n  language: overrides?.language ?? 'pt-br',\n  receive_sms: overrides?.receive_sms ?? false,\n  receive_email: overrides?.receive_email ?? true,\n  photo: overrides?.photo ?? null,\n  deleted: overrides?.deleted ?? 0,\n  datetime_alt: overrides?.datetime_alt || '2025-01-01 00:00:00',\n  datetime_del: overrides?.datetime_del ?? null,\n  datetime_add: overrides?.datetime_add || '2025-01-01 00:00:00',\n  total_projects: overrides?.total_projects ?? 1,\n  projects: overrides?.projects ?? [{ id: 1, title: faker.company.name() }],\n}));\n"],"mappings":"AAAA,SAAS,aAAa;AACtB,SAAe,mBAAmB;AAClC,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAIpB,MAAM,iBAAiB,WAAgC,CAAC,eAAe;AAAA,EAC5E,IAAI,WAAW,MAAM,SAAS;AAAA,EAC9B,OAAO,WAAW,SAAS,SAAS;AAAA,EACpC,YAAY,WAAW,cAAc,SAAS;AAAA,EAC9C,QAAQ,WAAW,UAAU;AAAA,EAC7B,MAAM,WAAW,QAAQ,MAAM,OAAO,UAAU;AAAA,EAChD,WAAW,WAAW,aAAa,MAAM,OAAO,SAAS;AAAA,EACzD,OAAO,WAAW,SAAS,MAAM,SAAS,MAAM,EAAE,YAAY;AAAA,EAC9D,KAAK,WAAW,OAAO;AAAA,EACvB,OAAO,WAAW,SAAS,MAAM,OAAO,QAAQ,EAAE;AAAA,EAClD,IAAI,WAAW,MAAM;AAAA,EACrB,KAAK,WAAW,OAAO;AAAA,EACvB,QAAQ,WAAW,UAAU;AAAA,EAC7B,2BAA2B,WAAW,6BAA6B;AAAA,EACnE,YAAY,WAAW,cAAc;AAAA,EACrC,kBAAkB,WAAW,oBAAoB;AAAA,EACjD,SAAS,WAAW,WAAW,YAAY;AAAA,EAC3C,UAAU,WAAW,YAAY;AAAA,EACjC,aAAa,WAAW,eAAe;AAAA,EACvC,eAAe,WAAW,iBAAiB;AAAA,EAC3C,OAAO,WAAW,SAAS;AAAA,EAC3B,SAAS,WAAW,WAAW;AAAA,EAC/B,cAAc,WAAW,gBAAgB;AAAA,EACzC,cAAc,WAAW,gBAAgB;AAAA,EACzC,cAAc,WAAW,gBAAgB;AAAA,EACzC,gBAAgB,WAAW,kBAAkB;AAAA,EAC7C,UAAU,WAAW,YAAY,CAAC,EAAE,IAAI,GAAG,OAAO,MAAM,QAAQ,KAAK,EAAE,CAAC;AAC1E,EAAE;","names":[]}

package/dist/testing/factories/whitelabel.factory.mjs

@@ -0,0 +1,66 @@
+import { faker } from "@faker-js/faker";
+import { TEST_API, TEST_IDS } from "../constants";
+import { createMock } from "./create-mock";
+import { createTestJwt } from "./jwt";
+const createWhitelabelMock = createMock(
+  (overrides) => {
+    const domain = overrides?.domain ?? TEST_API.domain;
+    return {
+      id: overrides?.id ?? TEST_IDS.wl,
+      deleted: overrides?.deleted ?? 0,
+      datetime_alt: overrides?.datetime_alt || "2025-01-01 00:00:00",
+      datetime_del: overrides?.datetime_del ?? null,
+      datetime_add: overrides?.datetime_add || "2025-01-01 00:00:00",
+      id_account: overrides?.id_account ?? TEST_IDS.account,
+      active: overrides?.active ?? true,
+      name: overrides?.name || faker.company.name(),
+      email: overrides?.email || faker.internet.email().toLowerCase(),
+      email_financial: overrides?.email_financial || faker.internet.email().toLowerCase(),
+      email_transactional: overrides?.email_transactional || faker.internet.email().toLowerCase(),
+      domain,
+      domain_free: overrides?.domain_free ?? null,
+      url_help: overrides?.url_help ?? `https://${domain}/help`,
+      url_login: overrides?.url_login ?? `https://${domain}/login`,
+      url_site: overrides?.url_site ?? `https://${domain}`,
+      url_signup: overrides?.url_signup ?? `https://${domain}/signup`,
+      codes: overrides?.codes ?? null,
+      id_gateway: overrides?.id_gateway ?? 1,
+      gateway_product: overrides?.gateway_product ?? "prod_test",
+      external_contracting: overrides?.external_contracting ?? false,
+      logo: overrides?.logo ?? `https://${domain}/logo.png`,
+      secondary_logo: overrides?.secondary_logo ?? null,
+      favicon: overrides?.favicon ?? `https://${domain}/favicon.ico`,
+      general: overrides?.general ?? {
+        primary_color: faker.color.rgb(),
+        hover_color: faker.color.rgb(),
+        link_color: faker.color.rgb()
+      },
+      signin_page: overrides?.signin_page ?? null,
+      signup_page: overrides?.signup_page ?? null,
+      dashboard: overrides?.dashboard ?? null,
+      use_policy_url: overrides?.use_policy_url ?? `https://${domain}/terms`,
+      cookie_policy_url: overrides?.cookie_policy_url ?? `https://${domain}/cookies`,
+      privacy_policy_url: overrides?.privacy_policy_url ?? `https://${domain}/privacy`,
+      editor_url: overrides?.editor_url ?? `https://editor.${domain}`,
+      accounts_url: overrides?.accounts_url ?? `https://accounts.${domain}`,
+      pages_url: overrides?.pages_url ?? `https://pages.${domain}`,
+      pages_preview_url: overrides?.pages_preview_url ?? `https://preview.${domain}`,
+      api_url: overrides?.api_url ?? TEST_API.gpages,
+      cname_url: overrides?.cname_url ?? `cname.${domain}`,
+      video_url: overrides?.video_url ?? null,
+      external_contracting_url: overrides?.external_contracting_url ?? null,
+      external_plans_url: overrides?.external_plans_url ?? null
+    };
+  }
+);
+const createWhitelabelTokenMock = createMock(
+  (overrides) => ({
+    ...createWhitelabelMock(overrides),
+    token: overrides?.token ?? createTestJwt()
+  })
+);
+export {
+  createWhitelabelMock,
+  createWhitelabelTokenMock
+};
+//# sourceMappingURL=whitelabel.factory.mjs.map

package/dist/testing/factories/whitelabel.factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/factories/whitelabel.factory.ts"],"sourcesContent":["import { faker } from '@faker-js/faker';\nimport { WhitelabelData, WhitelabelTokenData } from '../../modules/whitelabel/schema';\nimport { TEST_API, TEST_IDS } from '../constants';\nimport { createMock } from './create-mock';\nimport { createTestJwt } from './jwt';\n\n// id/domain stay aligned with TEST_IDS/TEST_API because resolveLocale/branding and the\n// domain-based whitelabel resolution depend on them.\nexport const createWhitelabelMock = createMock<WhitelabelData, Partial<WhitelabelData>>(\n  (overrides) => {\n    const domain = overrides?.domain ?? TEST_API.domain;\n    return {\n      id: overrides?.id ?? TEST_IDS.wl,\n      deleted: overrides?.deleted ?? 0,\n      datetime_alt: overrides?.datetime_alt || '2025-01-01 00:00:00',\n      datetime_del: overrides?.datetime_del ?? null,\n      datetime_add: overrides?.datetime_add || '2025-01-01 00:00:00',\n      id_account: overrides?.id_account ?? TEST_IDS.account,\n      active: overrides?.active ?? true,\n      name: overrides?.name || faker.company.name(),\n      email: overrides?.email || faker.internet.email().toLowerCase(),\n      email_financial: overrides?.email_financial || faker.internet.email().toLowerCase(),\n      email_transactional: overrides?.email_transactional || faker.internet.email().toLowerCase(),\n      domain,\n      domain_free: overrides?.domain_free ?? null,\n      url_help: overrides?.url_help ?? `https://${domain}/help`,\n      url_login: overrides?.url_login ?? `https://${domain}/login`,\n      url_site: overrides?.url_site ?? `https://${domain}`,\n      url_signup: overrides?.url_signup ?? `https://${domain}/signup`,\n      codes: overrides?.codes ?? null,\n      id_gateway: overrides?.id_gateway ?? 1,\n      gateway_product: overrides?.gateway_product ?? 'prod_test',\n      external_contracting: overrides?.external_contracting ?? false,\n      logo: overrides?.logo ?? `https://${domain}/logo.png`,\n      secondary_logo: overrides?.secondary_logo ?? null,\n      favicon: overrides?.favicon ?? `https://${domain}/favicon.ico`,\n      general: overrides?.general ?? {\n        primary_color: faker.color.rgb(),\n        hover_color: faker.color.rgb(),\n        link_color: faker.color.rgb(),\n      },\n      signin_page: overrides?.signin_page ?? null,\n      signup_page: overrides?.signup_page ?? null,\n      dashboard: overrides?.dashboard ?? null,\n      use_policy_url: overrides?.use_policy_url ?? `https://${domain}/terms`,\n      cookie_policy_url: overrides?.cookie_policy_url ?? `https://${domain}/cookies`,\n      privacy_policy_url: overrides?.privacy_policy_url ?? `https://${domain}/privacy`,\n      editor_url: overrides?.editor_url ?? `https://editor.${domain}`,\n      accounts_url: overrides?.accounts_url ?? `https://accounts.${domain}`,\n      pages_url: overrides?.pages_url ?? `https://pages.${domain}`,\n      pages_preview_url: overrides?.pages_preview_url ?? `https://preview.${domain}`,\n      api_url: overrides?.api_url ?? TEST_API.gpages,\n      cname_url: overrides?.cname_url ?? `cname.${domain}`,\n      video_url: overrides?.video_url ?? null,\n      external_contracting_url: overrides?.external_contracting_url ?? null,\n      external_plans_url: overrides?.external_plans_url ?? null,\n    };\n  },\n);\n\n// Variant with `token` — what getTokenByDomain returns for the ApiClient to build the header.\nexport const createWhitelabelTokenMock = createMock<WhitelabelTokenData, Partial<WhitelabelTokenData>>(\n  (overrides) => ({\n    ...createWhitelabelMock(overrides),\n    token: overrides?.token ?? createTestJwt(),\n  }),\n);\n"],"mappings":"AAAA,SAAS,aAAa;AAEtB,SAAS,UAAU,gBAAgB;AACnC,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAIvB,MAAM,uBAAuB;AAAA,EAClC,CAAC,cAAc;AACb,UAAM,SAAS,WAAW,UAAU,SAAS;AAC7C,WAAO;AAAA,MACL,IAAI,WAAW,MAAM,SAAS;AAAA,MAC9B,SAAS,WAAW,WAAW;AAAA,MAC/B,cAAc,WAAW,gBAAgB;AAAA,MACzC,cAAc,WAAW,gBAAgB;AAAA,MACzC,cAAc,WAAW,gBAAgB;AAAA,MACzC,YAAY,WAAW,cAAc,SAAS;AAAA,MAC9C,QAAQ,WAAW,UAAU;AAAA,MAC7B,MAAM,WAAW,QAAQ,MAAM,QAAQ,KAAK;AAAA,MAC5C,OAAO,WAAW,SAAS,MAAM,SAAS,MAAM,EAAE,YAAY;AAAA,MAC9D,iBAAiB,WAAW,mBAAmB,MAAM,SAAS,MAAM,EAAE,YAAY;AAAA,MAClF,qBAAqB,WAAW,uBAAuB,MAAM,SAAS,MAAM,EAAE,YAAY;AAAA,MAC1F;AAAA,MACA,aAAa,WAAW,eAAe;AAAA,MACvC,UAAU,WAAW,YAAY,WAAW,MAAM;AAAA,MAClD,WAAW,WAAW,aAAa,WAAW,MAAM;AAAA,MACpD,UAAU,WAAW,YAAY,WAAW,MAAM;AAAA,MAClD,YAAY,WAAW,cAAc,WAAW,MAAM;AAAA,MACtD,OAAO,WAAW,SAAS;AAAA,MAC3B,YAAY,WAAW,cAAc;AAAA,MACrC,iBAAiB,WAAW,mBAAmB;AAAA,MAC/C,sBAAsB,WAAW,wBAAwB;AAAA,MACzD,MAAM,WAAW,QAAQ,WAAW,MAAM;AAAA,MAC1C,gBAAgB,WAAW,kBAAkB;AAAA,MAC7C,SAAS,WAAW,WAAW,WAAW,MAAM;AAAA,MAChD,SAAS,WAAW,WAAW;AAAA,QAC7B,eAAe,MAAM,MAAM,IAAI;AAAA,QAC/B,aAAa,MAAM,MAAM,IAAI;AAAA,QAC7B,YAAY,MAAM,MAAM,IAAI;AAAA,MAC9B;AAAA,MACA,aAAa,WAAW,eAAe;AAAA,MACvC,aAAa,WAAW,eAAe;AAAA,MACvC,WAAW,WAAW,aAAa;AAAA,MACnC,gBAAgB,WAAW,kBAAkB,WAAW,MAAM;AAAA,MAC9D,mBAAmB,WAAW,qBAAqB,WAAW,MAAM;AAAA,MACpE,oBAAoB,WAAW,sBAAsB,WAAW,MAAM;AAAA,MACtE,YAAY,WAAW,cAAc,kBAAkB,MAAM;AAAA,MAC7D,cAAc,WAAW,gBAAgB,oBAAoB,MAAM;AAAA,MACnE,WAAW,WAAW,aAAa,iBAAiB,MAAM;AAAA,MAC1D,mBAAmB,WAAW,qBAAqB,mBAAmB,MAAM;AAAA,MAC5E,SAAS,WAAW,WAAW,SAAS;AAAA,MACxC,WAAW,WAAW,aAAa,SAAS,MAAM;AAAA,MAClD,WAAW,WAAW,aAAa;AAAA,MACnC,0BAA0B,WAAW,4BAA4B;AAAA,MACjE,oBAAoB,WAAW,sBAAsB;AAAA,IACvD;AAAA,EACF;AACF;AAGO,MAAM,4BAA4B;AAAA,EACvC,CAAC,eAAe;AAAA,IACd,GAAG,qBAAqB,SAAS;AAAA,IACjC,OAAO,WAAW,SAAS,cAAc;AAAA,EAC3C;AACF;","names":[]}

package/dist/testing/index.mjs

@@ -0,0 +1,10 @@
+import { TEST_IDS, TEST_API, TEST_API_VERSION, TEST_API_LOCALE } from "./constants";
+export * from "./factories";
+export * from "./msw";
+export {
+  TEST_API,
+  TEST_API_LOCALE,
+  TEST_API_VERSION,
+  TEST_IDS
+};
+//# sourceMappingURL=index.mjs.map

package/dist/testing/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["// Shared test infra for the GreatApps apps. Imported as `@greatapps/common/testing`.\n//\n// This barrel is LIGHT and safe for node/E2E/handlers: only deterministic factories and session\n// request handlers. The React PROVIDERS (which pull the lib's client tree) live in a separate\n// subpath — `@greatapps/common/testing/react` — so the barrel and its load-time side effects\n// (e.g. zustand stores reading localStorage) don't leak into reducer/route-handler tests.\n//\n// `msw` and `@faker-js/faker` are OPTIONAL peer dependencies: only the files here import them.\nexport { TEST_IDS, TEST_API, TEST_API_VERSION, TEST_API_LOCALE } from './constants';\nexport * from './factories';\nexport * from './msw';\n"],"mappings":"AAQA,SAAS,UAAU,UAAU,kBAAkB,uBAAuB;AACtE,cAAc;AACd,cAAc;","names":[]}

package/dist/testing/msw/envelope.mjs

@@ -0,0 +1,20 @@
+import { HttpResponse } from "msw";
+function apiList(items, total = items.length) {
+  return HttpResponse.json({ status: 1, data: items, total });
+}
+function apiFind(item) {
+  return apiList([item], 1);
+}
+function apiOne(data) {
+  return HttpResponse.json({ status: 1, data });
+}
+function apiError(message = "test error", status = 400) {
+  return HttpResponse.json({ status: 0, message }, { status });
+}
+export {
+  apiError,
+  apiFind,
+  apiList,
+  apiOne
+};
+//# sourceMappingURL=envelope.mjs.map

package/dist/testing/msw/envelope.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/msw/envelope.ts"],"sourcesContent":["import { HttpResponse } from 'msw';\n\n// The envelope GreatApps backends return. Services read `data` as an array and take `data[0]` on\n// finds (see the user/account/whitelabel/pages services), so the success default is a list. Use\n// `apiOne` when the consumer expects `data` to be a single object.\nexport function apiList<T>(items: T[], total = items.length) {\n  return HttpResponse.json({ status: 1, data: items, total });\n}\n\n// Success with a single item wrapped in a list (`{ status:1, data:[item], total:1 }`).\nexport function apiFind<T>(item: T) {\n  return apiList([item], 1);\n}\n\n// Success with `data` as a single object (few endpoints; most use a list).\nexport function apiOne<T>(data: T) {\n  return HttpResponse.json({ status: 1, data });\n}\n\n// Backend-shaped error (`{ status:0, message }`) with an HTTP status.\nexport function apiError(message = 'test error', status = 400) {\n  return HttpResponse.json({ status: 0, message }, { status });\n}\n"],"mappings":"AAAA,SAAS,oBAAoB;AAKtB,SAAS,QAAW,OAAY,QAAQ,MAAM,QAAQ;AAC3D,SAAO,aAAa,KAAK,EAAE,QAAQ,GAAG,MAAM,OAAO,MAAM,CAAC;AAC5D;AAGO,SAAS,QAAW,MAAS;AAClC,SAAO,QAAQ,CAAC,IAAI,GAAG,CAAC;AAC1B;AAGO,SAAS,OAAU,MAAS;AACjC,SAAO,aAAa,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC;AAC9C;AAGO,SAAS,SAAS,UAAU,cAAc,SAAS,KAAK;AAC7D,SAAO,aAAa,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,EAAE,OAAO,CAAC;AAC7D;","names":[]}

package/dist/testing/msw/index.mjs

@@ -0,0 +1,10 @@
+import { apiList, apiFind, apiOne, apiError } from "./envelope";
+import { makeSessionHandlers } from "./session.handlers";
+export {
+  apiError,
+  apiFind,
+  apiList,
+  apiOne,
+  makeSessionHandlers
+};
+//# sourceMappingURL=index.mjs.map

package/dist/testing/msw/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/msw/index.ts"],"sourcesContent":["export { apiList, apiFind, apiOne, apiError } from './envelope';\nexport { makeSessionHandlers, type SessionHandlersOptions } from './session.handlers';\n"],"mappings":"AAAA,SAAS,SAAS,SAAS,QAAQ,gBAAgB;AACnD,SAAS,2BAAwD;","names":[]}

package/dist/testing/msw/session.handlers.mjs

@@ -0,0 +1,23 @@
+import { http } from "msw";
+import { TEST_API } from "../constants";
+import { createAccountMock } from "../factories/account.factory";
+import { createUserMock } from "../factories/user.factory";
+import { createWhitelabelTokenMock } from "../factories/whitelabel.factory";
+import { apiFind } from "./envelope";
+function makeSessionHandlers(opts = {}) {
+  const base = opts.gappsBase ?? TEST_API.gapps;
+  const user = opts.user ?? createUserMock();
+  const account = opts.account ?? createAccountMock();
+  const whitelabel = opts.whitelabel ?? createWhitelabelTokenMock();
+  return [
+    http.get(`${base}/v1/:locale/:wl/whitelabel/:host/token`, () => apiFind(whitelabel)),
+    http.get(`${base}/v1/:locale/:wl/tokens`, () => apiFind(whitelabel)),
+    // The users path has more segments, so it must come before /accounts/:acc.
+    http.get(`${base}/v1/:locale/:wl/accounts/:acc/users/:user`, () => apiFind(user)),
+    http.get(`${base}/v1/:locale/:wl/accounts/:acc`, () => apiFind(account))
+  ];
+}
+export {
+  makeSessionHandlers
+};
+//# sourceMappingURL=session.handlers.mjs.map

package/dist/testing/msw/session.handlers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/msw/session.handlers.ts"],"sourcesContent":["import { http } from 'msw';\nimport type { Account } from '../../modules/accounts/types';\nimport type { User } from '../../modules/users/schema';\nimport type { WhitelabelTokenData } from '../../modules/whitelabel/schema';\nimport { TEST_API } from '../constants';\nimport { createAccountMock } from '../factories/account.factory';\nimport { createUserMock } from '../factories/user.factory';\nimport { createWhitelabelTokenMock } from '../factories/whitelabel.factory';\nimport { apiFind } from './envelope';\n\nexport interface SessionHandlersOptions {\n  // gapps base (= GAPPS_R3_API_URL). Defaults to TEST_API.gapps.\n  gappsBase?: string;\n  user?: User;\n  account?: Account;\n  whitelabel?: WhitelabelTokenData;\n}\n\n// Handlers for the server-side session resolution any app triggers when booting an authenticated\n// route (with DUMMY_AUTH_TOKEN): whitelabel by domain, token by wl id, user and account. These are\n// what the layout prefetches and what the ApiClient needs to build the URL/header. Apps compose\n// them with their own handlers:\n//   setupServer(...makeSessionHandlers(), ...myPageHandlers)\n// Paths follow the ApiClient template: `{base}/v1/{locale}/{wl}{endpoint}`.\nexport function makeSessionHandlers(opts: SessionHandlersOptions = {}) {\n  const base = opts.gappsBase ?? TEST_API.gapps;\n  const user = opts.user ?? createUserMock();\n  const account = opts.account ?? createAccountMock();\n  const whitelabel = opts.whitelabel ?? createWhitelabelTokenMock();\n\n  return [\n    http.get(`${base}/v1/:locale/:wl/whitelabel/:host/token`, () => apiFind(whitelabel)),\n    http.get(`${base}/v1/:locale/:wl/tokens`, () => apiFind(whitelabel)),\n    // The users path has more segments, so it must come before /accounts/:acc.\n    http.get(`${base}/v1/:locale/:wl/accounts/:acc/users/:user`, () => apiFind(user)),\n    http.get(`${base}/v1/:locale/:wl/accounts/:acc`, () => apiFind(account)),\n  ];\n}\n"],"mappings":"AAAA,SAAS,YAAY;AAIrB,SAAS,gBAAgB;AACzB,SAAS,yBAAyB;AAClC,SAAS,sBAAsB;AAC/B,SAAS,iCAAiC;AAC1C,SAAS,eAAe;AAgBjB,SAAS,oBAAoB,OAA+B,CAAC,GAAG;AACrE,QAAM,OAAO,KAAK,aAAa,SAAS;AACxC,QAAM,OAAO,KAAK,QAAQ,eAAe;AACzC,QAAM,UAAU,KAAK,WAAW,kBAAkB;AAClD,QAAM,aAAa,KAAK,cAAc,0BAA0B;AAEhE,SAAO;AAAA,IACL,KAAK,IAAI,GAAG,IAAI,0CAA0C,MAAM,QAAQ,UAAU,CAAC;AAAA,IACnF,KAAK,IAAI,GAAG,IAAI,0BAA0B,MAAM,QAAQ,UAAU,CAAC;AAAA;AAAA,IAEnE,KAAK,IAAI,GAAG,IAAI,6CAA6C,MAAM,QAAQ,IAAI,CAAC;AAAA,IAChF,KAAK,IAAI,GAAG,IAAI,iCAAiC,MAAM,QAAQ,OAAO,CAAC;AAAA,EACzE;AACF;","names":[]}

package/dist/testing/react/index.mjs

@@ -0,0 +1,8 @@
+import { makeTestQueryClient } from "./test-query-client";
+import { TestProviders, makeProvidersWrapper } from "./providers";
+export {
+  TestProviders,
+  makeProvidersWrapper,
+  makeTestQueryClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/testing/react/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/react/index.ts"],"sourcesContent":["export { makeTestQueryClient } from './test-query-client';\nexport { TestProviders, makeProvidersWrapper, type TestProvidersOptions } from './providers';\n"],"mappings":"AAAA,SAAS,2BAA2B;AACpC,SAAS,eAAe,4BAAuD;","names":[]}

package/dist/testing/react/providers.mjs

@@ -0,0 +1,42 @@
+import { jsx } from "react/jsx-runtime";
+import { QueryClientProvider } from "@tanstack/react-query";
+import { AuthContext } from "../../providers/auth.provider";
+import { WhitelabelProvider } from "../../providers/whitelabel.provider";
+import { createAccountMock } from "../factories/account.factory";
+import { createUserMock } from "../factories/user.factory";
+import { createWhitelabelMock } from "../factories/whitelabel.factory";
+import { makeTestQueryClient } from "./test-query-client";
+const notImpl = async () => {
+  throw new Error("auth action is not available in TestProviders \u2014 mock it in the test if needed");
+};
+function TestProviders({
+  children,
+  ...opts
+}) {
+  const queryClient = opts.queryClient ?? makeTestQueryClient();
+  const user = opts.user === void 0 ? createUserMock() : opts.user;
+  const account = opts.account === void 0 ? createAccountMock() : opts.account;
+  const whitelabel = opts.whitelabel === void 0 ? createWhitelabelMock() : opts.whitelabel;
+  const authValue = {
+    user,
+    account,
+    isAuthenticated: !!user,
+    isLoading: false,
+    login: notImpl,
+    register: notImpl,
+    logout: notImpl,
+    loginWithGoogle: notImpl,
+    completeGoogleOnboarding: notImpl
+  };
+  return /* @__PURE__ */ jsx(QueryClientProvider, { client: queryClient, children: /* @__PURE__ */ jsx(WhitelabelProvider, { whitelabel, children: /* @__PURE__ */ jsx(AuthContext.Provider, { value: authValue, children }) }) });
+}
+function makeProvidersWrapper(opts = {}) {
+  return function ProvidersWrapper({ children }) {
+    return /* @__PURE__ */ jsx(TestProviders, { ...opts, children });
+  };
+}
+export {
+  TestProviders,
+  makeProvidersWrapper
+};
+//# sourceMappingURL=providers.mjs.map

package/dist/testing/react/providers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/react/providers.tsx"],"sourcesContent":["import { QueryClient, QueryClientProvider } from '@tanstack/react-query';\nimport type { ContextType, ReactNode } from 'react';\nimport type { Account } from '../../modules/accounts/types';\nimport type { User } from '../../modules/users/schema';\nimport type { WhitelabelData } from '../../modules/whitelabel/schema';\nimport { AuthContext } from '../../providers/auth.provider';\nimport { WhitelabelProvider } from '../../providers/whitelabel.provider';\nimport { createAccountMock } from '../factories/account.factory';\nimport { createUserMock } from '../factories/user.factory';\nimport { createWhitelabelMock } from '../factories/whitelabel.factory';\nimport { makeTestQueryClient } from './test-query-client';\n\ntype AuthValue = NonNullable<ContextType<typeof AuthContext>>;\n\n// The real AuthProvider runs session queries/actions that don't work in jsdom, so we feed the same\n// (exported) AuthContext a mocked value. The auth actions throw if called — mock them per test.\nconst notImpl = async (): Promise<never> => {\n  throw new Error('auth action is not available in TestProviders — mock it in the test if needed');\n};\n\nexport interface TestProvidersOptions {\n  queryClient?: QueryClient;\n  user?: User | null;\n  account?: Account | null;\n  whitelabel?: WhitelabelData | null;\n}\n\nexport function TestProviders({\n  children,\n  ...opts\n}: TestProvidersOptions & { children: ReactNode }) {\n  const queryClient = opts.queryClient ?? makeTestQueryClient();\n  const user = opts.user === undefined ? createUserMock() : opts.user;\n  const account = opts.account === undefined ? createAccountMock() : opts.account;\n  const whitelabel = opts.whitelabel === undefined ? createWhitelabelMock() : opts.whitelabel;\n\n  const authValue: AuthValue = {\n    user,\n    account,\n    isAuthenticated: !!user,\n    isLoading: false,\n    login: notImpl,\n    register: notImpl,\n    logout: notImpl,\n    loginWithGoogle: notImpl,\n    completeGoogleOnboarding: notImpl,\n  };\n\n  return (\n    <QueryClientProvider client={queryClient}>\n      <WhitelabelProvider whitelabel={whitelabel}>\n        <AuthContext.Provider value={authValue}>{children}</AuthContext.Provider>\n      </WhitelabelProvider>\n    </QueryClientProvider>\n  );\n}\n\n// Wrapper for Testing Library: `render(ui, { wrapper: makeProvidersWrapper(opts) })`. The\n// @testing-library/react dependency stays in the app, not the common lib, hence a wrapper here\n// rather than a renderWithProviders.\nexport function makeProvidersWrapper(opts: TestProvidersOptions = {}) {\n  return function ProvidersWrapper({ children }: { children: ReactNode }) {\n    return <TestProviders {...opts}>{children}</TestProviders>;\n  };\n}\n"],"mappings":"AAmDQ;AAnDR,SAAsB,2BAA2B;AAKjD,SAAS,mBAAmB;AAC5B,SAAS,0BAA0B;AACnC,SAAS,yBAAyB;AAClC,SAAS,sBAAsB;AAC/B,SAAS,4BAA4B;AACrC,SAAS,2BAA2B;AAMpC,MAAM,UAAU,YAA4B;AAC1C,QAAM,IAAI,MAAM,oFAA+E;AACjG;AASO,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA,GAAG;AACL,GAAmD;AACjD,QAAM,cAAc,KAAK,eAAe,oBAAoB;AAC5D,QAAM,OAAO,KAAK,SAAS,SAAY,eAAe,IAAI,KAAK;AAC/D,QAAM,UAAU,KAAK,YAAY,SAAY,kBAAkB,IAAI,KAAK;AACxE,QAAM,aAAa,KAAK,eAAe,SAAY,qBAAqB,IAAI,KAAK;AAEjF,QAAM,YAAuB;AAAA,IAC3B;AAAA,IACA;AAAA,IACA,iBAAiB,CAAC,CAAC;AAAA,IACnB,WAAW;AAAA,IACX,OAAO;AAAA,IACP,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,iBAAiB;AAAA,IACjB,0BAA0B;AAAA,EAC5B;AAEA,SACE,oBAAC,uBAAoB,QAAQ,aAC3B,8BAAC,sBAAmB,YAClB,8BAAC,YAAY,UAAZ,EAAqB,OAAO,WAAY,UAAS,GACpD,GACF;AAEJ;AAKO,SAAS,qBAAqB,OAA6B,CAAC,GAAG;AACpE,SAAO,SAAS,iBAAiB,EAAE,SAAS,GAA4B;AACtE,WAAO,oBAAC,iBAAe,GAAG,MAAO,UAAS;AAAA,EAC5C;AACF;","names":[]}

package/dist/testing/react/test-query-client.mjs

@@ -0,0 +1,13 @@
+import { QueryClient } from "@tanstack/react-query";
+function makeTestQueryClient() {
+  return new QueryClient({
+    defaultOptions: {
+      queries: { retry: false, gcTime: 0, staleTime: 0, refetchOnWindowFocus: false },
+      mutations: { retry: false }
+    }
+  });
+}
+export {
+  makeTestQueryClient
+};
+//# sourceMappingURL=test-query-client.mjs.map

package/dist/testing/react/test-query-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/react/test-query-client.ts"],"sourcesContent":["import { QueryClient } from '@tanstack/react-query';\n\n/**\n * QueryClient para testes: sem retry (erros aparecem na hora), sem cache entre testes\n * (`gcTime: 0`) e sem refetch por foco. Crie um por teste pra isolamento total.\n */\nexport function makeTestQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      queries: { retry: false, gcTime: 0, staleTime: 0, refetchOnWindowFocus: false },\n      mutations: { retry: false },\n    },\n  });\n}\n"],"mappings":"AAAA,SAAS,mBAAmB;AAMrB,SAAS,sBAAmC;AACjD,SAAO,IAAI,YAAY;AAAA,IACrB,gBAAgB;AAAA,MACd,SAAS,EAAE,OAAO,OAAO,QAAQ,GAAG,WAAW,GAAG,sBAAsB,MAAM;AAAA,MAC9E,WAAW,EAAE,OAAO,MAAM;AAAA,IAC5B;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/testing.mjs

@@ -0,0 +1,2 @@
+export * from "./testing/index";
+//# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"sourcesContent":["export * from './testing/index';\n"],"mappings":"AAAA,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greatapps/common",
-  "version": "1.1.713",
+  "version": "1.1.714",
   "description": "Shared library for GreatApps frontend applications",
   "main": "./dist/index.mjs",
   "types": "./src/index.ts",
@@ -32,6 +32,14 @@
     "./i18n": {
       "import": "./dist/i18n.mjs",
       "types": "./src/i18n.ts"
+    },
+    "./testing": {
+      "import": "./dist/testing.mjs",
+      "types": "./src/testing.ts"
+    },
+    "./testing/react": {
+      "import": "./dist/testing/react/index.mjs",
+      "types": "./src/testing/react/index.ts"
     }
   },
   "files": [
@@ -89,6 +97,8 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "glob": "13.0.6",
+    "msw": "2.7.0",
+    "@faker-js/faker": "9.9.0",
     "next": "16.2.1",
     "next-intl": "4.12.0",
     "react": "19.1.4",
@@ -105,11 +115,21 @@
     "@tanstack/react-query-persist-client": ">=5.0.0",
     "next": ">=16.0.0",
     "next-intl": ">=4.0.0",
+    "@faker-js/faker": ">=9.0.0",
+    "msw": ">=2.0.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
     "react-hook-form": ">=7.0.0",
     "sonner": ">=2.0.0",
     "zod": ">=4.0.0",
     "zustand": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "msw": {
+      "optional": true
+    },
+    "@faker-js/faker": {
+      "optional": true
+    }
   }
 }

package/src/testing/constants.ts

@@ -0,0 +1,28 @@
+// Fixed identity and endpoints used across the test infra. Single source of truth: the same
+// object feeds DUMMY_AUTH_TOKEN (via createTestJwt), the factories and the request handlers, and
+// consumer apps must mirror it in their test env (GAPPS_R3_API_URL etc.) so the URL the ApiClient
+// builds matches the one the handlers expect.
+export const TEST_IDS = {
+  wl: 1,
+  account: 123,
+  user: 456,
+  page: 789,
+} as const;
+
+// Bases the apps MUST export as test env:
+//   GAPPS_R3_API_URL = TEST_API.gapps
+//   GPAGES_R3_API_URL = TEST_API.gpages
+//   WHITELABEL_TOKEN_MASTER = TEST_API.masterToken
+//   WHITELABEL_DOMAIN = TEST_API.domain
+// `.test` domains never resolve on the real network, so a leaked unhandled request fails loudly
+// instead of hitting a real backend.
+export const TEST_API = {
+  gapps: 'https://gapps.test',
+  gpages: 'https://gpages.test',
+  masterToken: 'test-master-token',
+  domain: 'app.test',
+} as const;
+
+// Fixed locale and version the ApiClient uses to build the URL (`/v1/pt-br/{wl}`).
+export const TEST_API_VERSION = 'v1';
+export const TEST_API_LOCALE = 'pt-br';

package/src/testing/factories/account.factory.ts

@@ -0,0 +1,37 @@
+import { faker } from '@faker-js/faker';
+import { Account } from '../../modules/accounts/types';
+import { TEST_IDS } from '../constants';
+import { createMock } from './create-mock';
+
+// Identity fields (id/id_wl) are fixed to TEST_IDS; cosmetic fields use faker.
+export const createAccountMock = createMock<Account, Partial<Account>>((overrides) => ({
+  id: overrides?.id ?? TEST_IDS.account,
+  id_wl: overrides?.id_wl ?? TEST_IDS.wl,
+  id_affiliate: overrides?.id_affiliate ?? 0,
+  id_api: overrides?.id_api ?? 1,
+  name: overrides?.name || faker.company.name(),
+  language: overrides?.language ?? 'pt-br',
+  timezone: overrides?.timezone ?? 'America/Sao_Paulo',
+  currency: overrides?.currency ?? 'brl',
+  verified: overrides?.verified ?? true,
+  bussiness_type: overrides?.bussiness_type ?? 1,
+  gateway: overrides?.gateway ?? 'stripe',
+  gateway_customer_id: overrides?.gateway_customer_id ?? null,
+  origin: overrides?.origin ?? null,
+  zipcode: overrides?.zipcode ?? null,
+  address: overrides?.address ?? null,
+  address_number: overrides?.address_number ?? null,
+  address_complement: overrides?.address_complement ?? null,
+  neighborhood: overrides?.neighborhood ?? null,
+  city: overrides?.city ?? null,
+  state: overrides?.state ?? null,
+  country: overrides?.country ?? 'BR',
+  financial_document: overrides?.financial_document ?? null,
+  financial_name: overrides?.financial_name ?? null,
+  financial_email: overrides?.financial_email ?? null,
+  financial_document_type: overrides?.financial_document_type ?? 1,
+  deleted: overrides?.deleted ?? 0,
+  datetime_add: overrides?.datetime_add || '2025-01-01 00:00:00',
+  datetime_alt: overrides?.datetime_alt || '2025-01-01 00:00:00',
+  datetime_del: overrides?.datetime_del ?? null,
+}));

package/src/testing/factories/create-mock.ts

@@ -0,0 +1,23 @@
+type Factory<T, O> = (overrides?: O) => T;
+
+// Reset registry for the cached defaults. Runner-agnostic on purpose: these factories also run
+// under `next dev` (E2E request handlers) where vitest's `beforeEach` does not exist, so the app
+// calls `resetMocks()` from its own `beforeEach`.
+const resetters = new Set<() => void>();
+
+// createMock(factory) returns a getter that:
+//   - without overrides → returns the SAME default instance within a test (stable for asserts);
+//   - with overrides → returns a NEW instance with those fields replaced.
+// Between tests, `resetMocks()` refreshes the defaults.
+export function createMock<T, O = Partial<T>>(factory: Factory<T, O>): Factory<T, O> {
+  let instance = factory();
+  resetters.add(() => {
+    instance = factory();
+  });
+  return (overrides?: O): T => (overrides ? factory(overrides) : instance);
+}
+
+// Refreshes every default cached by createMock. Call it from the setup's beforeEach.
+export function resetMocks(): void {
+  for (const reset of resetters) reset();
+}

package/src/testing/factories/index.ts

@@ -0,0 +1,7 @@
+export { createMock, resetMocks } from './create-mock';
+export { createTestJwt, type TestJwtClaims } from './jwt';
+export { createUserMock } from './user.factory';
+export { createAccountMock } from './account.factory';
+export { createWhitelabelMock, createWhitelabelTokenMock } from './whitelabel.factory';
+export { createSubscriptionMock, createSubscriptionItemMock } from './subscription.factory';
+export { createPlanMock, createPlanItemMock } from './plan.factory';

package/src/testing/factories/jwt.ts

@@ -0,0 +1,44 @@
+import type { JWTPayload } from '../../modules/users/schema';
+import { TEST_IDS } from '../constants';
+
+function b64(value: unknown): string {
+  // getUserContext decodes the payload with `atob(token.split('.')[1])`, so standard base64 works.
+  return btoa(JSON.stringify(value));
+}
+
+export interface TestJwtClaims {
+  id_wl?: number;
+  id_account?: number;
+  id_user?: number;
+  // Country used by resolveLocale (session.location.country).
+  country?: string;
+}
+
+// Builds a fake JWT (placeholder signature) whose payload is decodable by getUserContext and
+// resolveLocale. Used as DUMMY_AUTH_TOKEN: the common auth bypasses verification when that env is
+// set, so only the payload matters.
+export function createTestJwt(claims: TestJwtClaims = {}): string {
+  const payload: JWTPayload = {
+    session: {
+      location: {
+        continent: 'SA',
+        country: claims.country ?? 'BR',
+        region: 'SP',
+        city: 'Sao Paulo',
+        latitude: '0',
+        longitude: '0',
+      },
+      ip: '127.0.0.1',
+      timezone: 'America/Sao_Paulo',
+      agent: 'test',
+      code: null,
+    },
+    id_wl: String(claims.id_wl ?? TEST_IDS.wl),
+    id_account: claims.id_account ?? TEST_IDS.account,
+    id_user: claims.id_user ?? TEST_IDS.user,
+    iss: 'test',
+    aud: 'test',
+    iat: 1700000000,
+  };
+  return `${b64({ alg: 'none', typ: 'JWT' })}.${b64(payload)}.sig`;
+}

package/src/testing/factories/plan.factory.ts

@@ -0,0 +1,21 @@
+import { faker } from '@faker-js/faker';
+import { Plan, PlanItem } from '../../modules/plans/types/plan.type';
+import { createMock } from './create-mock';
+
+export const createPlanItemMock = createMock<PlanItem, Partial<PlanItem>>((overrides) => ({
+  id_addon: overrides?.id_addon ?? 2,
+  quantity: overrides?.quantity ?? 10,
+  value: overrides?.value ?? 9990,
+  base: overrides?.base ?? true,
+}));
+
+export const createPlanMock = createMock<Plan, Partial<Plan>>((overrides) => ({
+  id: overrides?.id ?? faker.number.int({ min: 1, max: 9999 }),
+  name: overrides?.name || faker.commerce.productName(),
+  value: overrides?.value ?? 9990,
+  currency: overrides?.currency ?? 'brl',
+  type: overrides?.type ?? 'paid',
+  discount_semester: overrides?.discount_semester ?? 0,
+  discount_annual: overrides?.discount_annual ?? 0,
+  items: overrides?.items ?? [createPlanItemMock()],
+}));

package/src/testing/factories/subscription.factory.ts

@@ -0,0 +1,52 @@
+import { faker } from '@faker-js/faker';
+import { Subscription, SubscriptionItem } from '../../modules/subscriptions/types/subscription.type';
+import { TEST_IDS } from '../constants';
+import { createMock } from './create-mock';
+
+// Dates are Date objects (the inferred output of the schema).
+export const createSubscriptionItemMock = createMock<SubscriptionItem, Partial<SubscriptionItem>>(
+  (overrides) => ({
+    id: overrides?.id ?? faker.number.int({ min: 1, max: 99999 }),
+    deleted: overrides?.deleted ?? 0,
+    datetime_add: overrides?.datetime_add ?? new Date('2025-01-01T00:00:00Z'),
+    id_wl: overrides?.id_wl ?? TEST_IDS.wl,
+    id_subscription: overrides?.id_subscription ?? 1,
+    id_addon: overrides?.id_addon ?? null,
+    value: overrides?.value ?? 9990,
+    currency: overrides?.currency ?? 'brl',
+    quantity: overrides?.quantity ?? 1,
+    payment_status: overrides?.payment_status ?? 1,
+    id_charge: overrides?.id_charge ?? null,
+    trial: overrides?.trial ?? true,
+  }),
+);
+
+// Default: an active subscription with a future due date (a valid trial).
+export const createSubscriptionMock = createMock<Subscription, Partial<Subscription>>(
+  (overrides) => ({
+    id: overrides?.id ?? faker.number.int({ min: 1, max: 99999 }),
+    deleted: overrides?.deleted ?? 0,
+    datetime_add: overrides?.datetime_add ?? new Date('2025-01-01T00:00:00Z'),
+    id_wl: overrides?.id_wl ?? TEST_IDS.wl,
+    id_account: overrides?.id_account ?? TEST_IDS.account,
+    id_card: overrides?.id_card ?? null,
+    id_coupon: overrides?.id_coupon ?? null,
+    type: overrides?.type ?? 'recurring',
+    payment_method: overrides?.payment_method ?? 1,
+    periodicity: overrides?.periodicity ?? 1,
+    value: overrides?.value ?? 9990,
+    id_product: overrides?.id_product ?? 1,
+    id_plan: overrides?.id_plan ?? 1,
+    id_gateway: overrides?.id_gateway ?? null,
+    gateway_account: overrides?.gateway_account ?? null,
+    date_hiring: overrides?.date_hiring ?? new Date('2025-01-01'),
+    date_due: overrides?.date_due ?? new Date('2099-01-01'),
+    date_cancellation: overrides?.date_cancellation ?? null,
+    date_verification: overrides?.date_verification ?? null,
+    cancellation_reason: overrides?.cancellation_reason ?? null,
+    cancellation_description: overrides?.cancellation_description ?? null,
+    active: overrides?.active ?? true,
+    charged: overrides?.charged ?? true,
+    items: overrides?.items ?? [createSubscriptionItemMock()],
+  }),
+);

package/src/testing/factories/user.factory.ts

@@ -0,0 +1,35 @@
+import { faker } from '@faker-js/faker';
+import { User, UserProfile } from '../../modules/users/schema';
+import { TEST_IDS } from '../constants';
+import { createMock } from './create-mock';
+
+// Identity fields (id/id_wl/id_account) are fixed to TEST_IDS by default — the auth chain and the
+// request-URL matching depend on them; override explicitly when needed. Cosmetic fields use faker.
+export const createUserMock = createMock<User, Partial<User>>((overrides) => ({
+  id: overrides?.id ?? TEST_IDS.user,
+  id_wl: overrides?.id_wl ?? TEST_IDS.wl,
+  id_account: overrides?.id_account ?? TEST_IDS.account,
+  id_api: overrides?.id_api ?? 1,
+  name: overrides?.name || faker.person.firstName(),
+  last_name: overrides?.last_name || faker.person.lastName(),
+  email: overrides?.email || faker.internet.email().toLowerCase(),
+  ddi: overrides?.ddi || '55',
+  phone: overrides?.phone || faker.string.numeric(11),
+  rg: overrides?.rg ?? null,
+  cpf: overrides?.cpf ?? null,
+  gender: overrides?.gender ?? 0,
+  two_factor_authentication: overrides?.two_factor_authentication ?? false,
+  google_sub: overrides?.google_sub ?? null,
+  google_linked_at: overrides?.google_linked_at ?? null,
+  profile: overrides?.profile ?? UserProfile.owner,
+  language: overrides?.language ?? 'pt-br',
+  receive_sms: overrides?.receive_sms ?? false,
+  receive_email: overrides?.receive_email ?? true,
+  photo: overrides?.photo ?? null,
+  deleted: overrides?.deleted ?? 0,
+  datetime_alt: overrides?.datetime_alt || '2025-01-01 00:00:00',
+  datetime_del: overrides?.datetime_del ?? null,
+  datetime_add: overrides?.datetime_add || '2025-01-01 00:00:00',
+  total_projects: overrides?.total_projects ?? 1,
+  projects: overrides?.projects ?? [{ id: 1, title: faker.company.name() }],
+}));

package/src/testing/factories/whitelabel.factory.ts

@@ -0,0 +1,67 @@
+import { faker } from '@faker-js/faker';
+import { WhitelabelData, WhitelabelTokenData } from '../../modules/whitelabel/schema';
+import { TEST_API, TEST_IDS } from '../constants';
+import { createMock } from './create-mock';
+import { createTestJwt } from './jwt';
+
+// id/domain stay aligned with TEST_IDS/TEST_API because resolveLocale/branding and the
+// domain-based whitelabel resolution depend on them.
+export const createWhitelabelMock = createMock<WhitelabelData, Partial<WhitelabelData>>(
+  (overrides) => {
+    const domain = overrides?.domain ?? TEST_API.domain;
+    return {
+      id: overrides?.id ?? TEST_IDS.wl,
+      deleted: overrides?.deleted ?? 0,
+      datetime_alt: overrides?.datetime_alt || '2025-01-01 00:00:00',
+      datetime_del: overrides?.datetime_del ?? null,
+      datetime_add: overrides?.datetime_add || '2025-01-01 00:00:00',
+      id_account: overrides?.id_account ?? TEST_IDS.account,
+      active: overrides?.active ?? true,
+      name: overrides?.name || faker.company.name(),
+      email: overrides?.email || faker.internet.email().toLowerCase(),
+      email_financial: overrides?.email_financial || faker.internet.email().toLowerCase(),
+      email_transactional: overrides?.email_transactional || faker.internet.email().toLowerCase(),
+      domain,
+      domain_free: overrides?.domain_free ?? null,
+      url_help: overrides?.url_help ?? `https://${domain}/help`,
+      url_login: overrides?.url_login ?? `https://${domain}/login`,
+      url_site: overrides?.url_site ?? `https://${domain}`,
+      url_signup: overrides?.url_signup ?? `https://${domain}/signup`,
+      codes: overrides?.codes ?? null,
+      id_gateway: overrides?.id_gateway ?? 1,
+      gateway_product: overrides?.gateway_product ?? 'prod_test',
+      external_contracting: overrides?.external_contracting ?? false,
+      logo: overrides?.logo ?? `https://${domain}/logo.png`,
+      secondary_logo: overrides?.secondary_logo ?? null,
+      favicon: overrides?.favicon ?? `https://${domain}/favicon.ico`,
+      general: overrides?.general ?? {
+        primary_color: faker.color.rgb(),
+        hover_color: faker.color.rgb(),
+        link_color: faker.color.rgb(),
+      },
+      signin_page: overrides?.signin_page ?? null,
+      signup_page: overrides?.signup_page ?? null,
+      dashboard: overrides?.dashboard ?? null,
+      use_policy_url: overrides?.use_policy_url ?? `https://${domain}/terms`,
+      cookie_policy_url: overrides?.cookie_policy_url ?? `https://${domain}/cookies`,
+      privacy_policy_url: overrides?.privacy_policy_url ?? `https://${domain}/privacy`,
+      editor_url: overrides?.editor_url ?? `https://editor.${domain}`,
+      accounts_url: overrides?.accounts_url ?? `https://accounts.${domain}`,
+      pages_url: overrides?.pages_url ?? `https://pages.${domain}`,
+      pages_preview_url: overrides?.pages_preview_url ?? `https://preview.${domain}`,
+      api_url: overrides?.api_url ?? TEST_API.gpages,
+      cname_url: overrides?.cname_url ?? `cname.${domain}`,
+      video_url: overrides?.video_url ?? null,
+      external_contracting_url: overrides?.external_contracting_url ?? null,
+      external_plans_url: overrides?.external_plans_url ?? null,
+    };
+  },
+);
+
+// Variant with `token` — what getTokenByDomain returns for the ApiClient to build the header.
+export const createWhitelabelTokenMock = createMock<WhitelabelTokenData, Partial<WhitelabelTokenData>>(
+  (overrides) => ({
+    ...createWhitelabelMock(overrides),
+    token: overrides?.token ?? createTestJwt(),
+  }),
+);

package/src/testing/index.ts

@@ -0,0 +1,11 @@
+// Shared test infra for the GreatApps apps. Imported as `@greatapps/common/testing`.
+//
+// This barrel is LIGHT and safe for node/E2E/handlers: only deterministic factories and session
+// request handlers. The React PROVIDERS (which pull the lib's client tree) live in a separate
+// subpath — `@greatapps/common/testing/react` — so the barrel and its load-time side effects
+// (e.g. zustand stores reading localStorage) don't leak into reducer/route-handler tests.
+//
+// `msw` and `@faker-js/faker` are OPTIONAL peer dependencies: only the files here import them.
+export { TEST_IDS, TEST_API, TEST_API_VERSION, TEST_API_LOCALE } from './constants';
+export * from './factories';
+export * from './msw';

package/src/testing/msw/envelope.ts

@@ -0,0 +1,23 @@
+import { HttpResponse } from 'msw';
+
+// The envelope GreatApps backends return. Services read `data` as an array and take `data[0]` on
+// finds (see the user/account/whitelabel/pages services), so the success default is a list. Use
+// `apiOne` when the consumer expects `data` to be a single object.
+export function apiList<T>(items: T[], total = items.length) {
+  return HttpResponse.json({ status: 1, data: items, total });
+}
+
+// Success with a single item wrapped in a list (`{ status:1, data:[item], total:1 }`).
+export function apiFind<T>(item: T) {
+  return apiList([item], 1);
+}
+
+// Success with `data` as a single object (few endpoints; most use a list).
+export function apiOne<T>(data: T) {
+  return HttpResponse.json({ status: 1, data });
+}
+
+// Backend-shaped error (`{ status:0, message }`) with an HTTP status.
+export function apiError(message = 'test error', status = 400) {
+  return HttpResponse.json({ status: 0, message }, { status });
+}

package/src/testing/msw/index.ts

@@ -0,0 +1,2 @@
+export { apiList, apiFind, apiOne, apiError } from './envelope';
+export { makeSessionHandlers, type SessionHandlersOptions } from './session.handlers';

package/src/testing/msw/session.handlers.ts

@@ -0,0 +1,38 @@
+import { http } from 'msw';
+import type { Account } from '../../modules/accounts/types';
+import type { User } from '../../modules/users/schema';
+import type { WhitelabelTokenData } from '../../modules/whitelabel/schema';
+import { TEST_API } from '../constants';
+import { createAccountMock } from '../factories/account.factory';
+import { createUserMock } from '../factories/user.factory';
+import { createWhitelabelTokenMock } from '../factories/whitelabel.factory';
+import { apiFind } from './envelope';
+
+export interface SessionHandlersOptions {
+  // gapps base (= GAPPS_R3_API_URL). Defaults to TEST_API.gapps.
+  gappsBase?: string;
+  user?: User;
+  account?: Account;
+  whitelabel?: WhitelabelTokenData;
+}
+
+// Handlers for the server-side session resolution any app triggers when booting an authenticated
+// route (with DUMMY_AUTH_TOKEN): whitelabel by domain, token by wl id, user and account. These are
+// what the layout prefetches and what the ApiClient needs to build the URL/header. Apps compose
+// them with their own handlers:
+//   setupServer(...makeSessionHandlers(), ...myPageHandlers)
+// Paths follow the ApiClient template: `{base}/v1/{locale}/{wl}{endpoint}`.
+export function makeSessionHandlers(opts: SessionHandlersOptions = {}) {
+  const base = opts.gappsBase ?? TEST_API.gapps;
+  const user = opts.user ?? createUserMock();
+  const account = opts.account ?? createAccountMock();
+  const whitelabel = opts.whitelabel ?? createWhitelabelTokenMock();
+
+  return [
+    http.get(`${base}/v1/:locale/:wl/whitelabel/:host/token`, () => apiFind(whitelabel)),
+    http.get(`${base}/v1/:locale/:wl/tokens`, () => apiFind(whitelabel)),
+    // The users path has more segments, so it must come before /accounts/:acc.
+    http.get(`${base}/v1/:locale/:wl/accounts/:acc/users/:user`, () => apiFind(user)),
+    http.get(`${base}/v1/:locale/:wl/accounts/:acc`, () => apiFind(account)),
+  ];
+}

package/src/testing/react/index.ts

@@ -0,0 +1,2 @@
+export { makeTestQueryClient } from './test-query-client';
+export { TestProviders, makeProvidersWrapper, type TestProvidersOptions } from './providers';

package/src/testing/react/providers.tsx

@@ -0,0 +1,65 @@
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import type { ContextType, ReactNode } from 'react';
+import type { Account } from '../../modules/accounts/types';
+import type { User } from '../../modules/users/schema';
+import type { WhitelabelData } from '../../modules/whitelabel/schema';
+import { AuthContext } from '../../providers/auth.provider';
+import { WhitelabelProvider } from '../../providers/whitelabel.provider';
+import { createAccountMock } from '../factories/account.factory';
+import { createUserMock } from '../factories/user.factory';
+import { createWhitelabelMock } from '../factories/whitelabel.factory';
+import { makeTestQueryClient } from './test-query-client';
+
+type AuthValue = NonNullable<ContextType<typeof AuthContext>>;
+
+// The real AuthProvider runs session queries/actions that don't work in jsdom, so we feed the same
+// (exported) AuthContext a mocked value. The auth actions throw if called — mock them per test.
+const notImpl = async (): Promise<never> => {
+  throw new Error('auth action is not available in TestProviders — mock it in the test if needed');
+};
+
+export interface TestProvidersOptions {
+  queryClient?: QueryClient;
+  user?: User | null;
+  account?: Account | null;
+  whitelabel?: WhitelabelData | null;
+}
+
+export function TestProviders({
+  children,
+  ...opts
+}: TestProvidersOptions & { children: ReactNode }) {
+  const queryClient = opts.queryClient ?? makeTestQueryClient();
+  const user = opts.user === undefined ? createUserMock() : opts.user;
+  const account = opts.account === undefined ? createAccountMock() : opts.account;
+  const whitelabel = opts.whitelabel === undefined ? createWhitelabelMock() : opts.whitelabel;
+
+  const authValue: AuthValue = {
+    user,
+    account,
+    isAuthenticated: !!user,
+    isLoading: false,
+    login: notImpl,
+    register: notImpl,
+    logout: notImpl,
+    loginWithGoogle: notImpl,
+    completeGoogleOnboarding: notImpl,
+  };
+
+  return (
+    <QueryClientProvider client={queryClient}>
+      <WhitelabelProvider whitelabel={whitelabel}>
+        <AuthContext.Provider value={authValue}>{children}</AuthContext.Provider>
+      </WhitelabelProvider>
+    </QueryClientProvider>
+  );
+}
+
+// Wrapper for Testing Library: `render(ui, { wrapper: makeProvidersWrapper(opts) })`. The
+// @testing-library/react dependency stays in the app, not the common lib, hence a wrapper here
+// rather than a renderWithProviders.
+export function makeProvidersWrapper(opts: TestProvidersOptions = {}) {
+  return function ProvidersWrapper({ children }: { children: ReactNode }) {
+    return <TestProviders {...opts}>{children}</TestProviders>;
+  };
+}

package/src/testing/react/test-query-client.ts

@@ -0,0 +1,14 @@
+import { QueryClient } from '@tanstack/react-query';
+
+/**
+ * QueryClient para testes: sem retry (erros aparecem na hora), sem cache entre testes
+ * (`gcTime: 0`) e sem refetch por foco. Crie um por teste pra isolamento total.
+ */
+export function makeTestQueryClient(): QueryClient {
+  return new QueryClient({
+    defaultOptions: {
+      queries: { retry: false, gcTime: 0, staleTime: 0, refetchOnWindowFocus: false },
+      mutations: { retry: false },
+    },
+  });
+}

package/src/testing.ts

@@ -0,0 +1 @@
+export * from './testing/index';