@workwell-global/toolkit 1.1.49 → 1.1.50

package/dist/analytics/consent.d.ts

@@ -0,0 +1,33 @@
+/** Cookie set on the parent domain so one accept covers all subdomains. */
+export declare const CONSENT_COOKIE_NAME = "wwl_consent";
+/** Request header web apps forward to the API so server-side events respect consent. */
+export declare const CONSENT_HEADER_NAME = "x-wwl-consent";
+/** Bump when the consent policy text/categories change; a lower stored version re-prompts the banner. */
+export declare const CONSENT_VERSION = 1;
+export interface IConsentCategories {
+    /** Always true: auth/session + the consent cookie itself. */
+    functional: true;
+    /** Product analytics (Mixpanel). */
+    statistics: boolean;
+}
+export interface IConsentState {
+    /** Consent policy version the user responded to. */
+    v: number;
+    /** Epoch ms of the user's choice. */
+    ts: number;
+    cat: IConsentCategories;
+}
+export declare const buildConsentState: (statistics: boolean, nowMs: number) => IConsentState;
+/** Serialize for the cookie value / forwarded header. URI-encoded JSON. */
+export declare const serializeConsent: (state: IConsentState) => string;
+/**
+ * Parse a cookie/header value. Returns null for anything malformed or absent:
+ * callers must treat null as "no consent given" (and the banner re-prompts).
+ */
+export declare const parseConsent: (raw: string | null | undefined) => IConsentState | null;
+/**
+ * True only for a well-formed, current-version consent with statistics on.
+ * An outdated version means the user has not consented to the CURRENT policy.
+ */
+export declare const hasStatisticsConsent: (raw: string | null | undefined) => boolean;
+//# sourceMappingURL=consent.d.ts.map

package/dist/analytics/consent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/analytics/consent.ts"],"names":[],"mappings":"AAKA,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAEhD,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAElD,yGAAyG;AACzG,eAAO,MAAM,eAAe,IAAI,CAAA;AAEhC,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,UAAU,EAAE,IAAI,CAAA;IAChB,oCAAoC;IACpC,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,CAAC,EAAE,MAAM,CAAA;IACT,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,kBAAkB,CAAA;CACxB;AAED,eAAO,MAAM,iBAAiB,GAAI,YAAY,OAAO,EAAE,OAAO,MAAM,KAAG,aAIrE,CAAA;AAEF,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,GAAI,OAAO,aAAa,KAAG,MACb,CAAA;AAE3C;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,aAAa,GAAG,IAyB7E,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,KAC7B,OAGF,CAAA"}

package/dist/analytics/consent.js

@@ -0,0 +1,53 @@
+// Consent contract shared by the web apps (banner writes / reads the cookie)
+// and the API (parses the forwarded header). Blanket v1: 'statistics' is the
+// only toggleable category; 'functional' is always active. Stored per-category
+// from day one so a tiered model later needs no format change.
+/** Cookie set on the parent domain so one accept covers all subdomains. */
+export const CONSENT_COOKIE_NAME = 'wwl_consent';
+/** Request header web apps forward to the API so server-side events respect consent. */
+export const CONSENT_HEADER_NAME = 'x-wwl-consent';
+/** Bump when the consent policy text/categories change; a lower stored version re-prompts the banner. */
+export const CONSENT_VERSION = 1;
+export const buildConsentState = (statistics, nowMs) => ({
+    v: CONSENT_VERSION,
+    ts: nowMs,
+    cat: { functional: true, statistics },
+});
+/** Serialize for the cookie value / forwarded header. URI-encoded JSON. */
+export const serializeConsent = (state) => encodeURIComponent(JSON.stringify(state));
+/**
+ * Parse a cookie/header value. Returns null for anything malformed or absent:
+ * callers must treat null as "no consent given" (and the banner re-prompts).
+ */
+export const parseConsent = (raw) => {
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(decodeURIComponent(raw));
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        const candidate = parsed;
+        if (typeof candidate.v !== 'number' || typeof candidate.ts !== 'number')
+            return null;
+        if (candidate.cat?.functional !== true ||
+            typeof candidate.cat.statistics !== 'boolean')
+            return null;
+        return {
+            v: candidate.v,
+            ts: candidate.ts,
+            cat: { functional: true, statistics: candidate.cat.statistics },
+        };
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * True only for a well-formed, current-version consent with statistics on.
+ * An outdated version means the user has not consented to the CURRENT policy.
+ */
+export const hasStatisticsConsent = (raw) => {
+    const state = parseConsent(raw);
+    return state !== null && state.v >= CONSENT_VERSION && state.cat.statistics;
+};
+//# sourceMappingURL=consent.js.map

package/dist/analytics/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/analytics/consent.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,+DAA+D;AAE/D,2EAA2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAEhD,wFAAwF;AACxF,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAA;AAElD,yGAAyG;AACzG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAiBhC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,UAAmB,EAAE,KAAa,EAAiB,EAAE,CAAC,CAAC;IACvF,CAAC,EAAE,eAAe;IAClB,EAAE,EAAE,KAAK;IACT,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;CACtC,CAAC,CAAA;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAoB,EAAU,EAAE,CAC/D,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAA8B,EAAwB,EAAE;IACnF,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAA;QAC3D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC9D,MAAM,SAAS,GAAG,MAIjB,CAAA;QACD,IAAI,OAAO,SAAS,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ;YACrE,OAAO,IAAI,CAAA;QACb,IACE,SAAS,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI;YAClC,OAAO,SAAS,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS;YAE7C,OAAO,IAAI,CAAA;QACb,OAAO;YACL,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE;SAChE,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,GAA8B,EACrB,EAAE;IACX,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,eAAe,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAA;AAC7E,CAAC,CAAA"}

package/dist/analytics/consent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=consent.test.d.ts.map

package/dist/analytics/consent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.test.d.ts","sourceRoot":"","sources":["../../src/analytics/consent.test.ts"],"names":[],"mappings":""}

package/dist/analytics/consent.test.js

@@ -0,0 +1,51 @@
+import { describe, expect, it } from 'vitest';
+import { buildConsentState, CONSENT_VERSION, hasStatisticsConsent, parseConsent, serializeConsent, } from './consent.js';
+describe('consent serialization', () => {
+    it('round-trips an accept state', () => {
+        const state = buildConsentState(true, 1_756_000_000_000);
+        const parsed = parseConsent(serializeConsent(state));
+        expect(parsed).toEqual({
+            v: CONSENT_VERSION,
+            ts: 1_756_000_000_000,
+            cat: { functional: true, statistics: true },
+        });
+    });
+    it('round-trips a deny state', () => {
+        const state = buildConsentState(false, 1_756_000_000_000);
+        const parsed = parseConsent(serializeConsent(state));
+        expect(parsed?.cat.statistics).toBe(false);
+        expect(parsed?.cat.functional).toBe(true);
+    });
+    it.each([
+        ['undefined', undefined],
+        ['null', null],
+        ['empty string', ''],
+        ['not json', 'garbage'],
+        ['json but wrong shape', encodeURIComponent('{"foo":1}')],
+        ['missing categories', encodeURIComponent('{"v":1,"ts":2}')],
+        [
+            'functional not always-active',
+            encodeURIComponent('{"v":1,"ts":2,"cat":{"functional":false,"statistics":true}}'),
+        ],
+    ])('parseConsent returns null for %s', (_label, raw) => {
+        expect(parseConsent(raw)).toBeNull();
+    });
+});
+describe('hasStatisticsConsent', () => {
+    it('is true only for current-version consent with statistics on', () => {
+        const accepted = serializeConsent(buildConsentState(true, 1));
+        const denied = serializeConsent(buildConsentState(false, 1));
+        expect(hasStatisticsConsent(accepted)).toBe(true);
+        expect(hasStatisticsConsent(denied)).toBe(false);
+        expect(hasStatisticsConsent(undefined)).toBe(false);
+    });
+    it('treats consent given under an older policy version as no consent', () => {
+        const outdated = serializeConsent({
+            v: CONSENT_VERSION - 1,
+            ts: 1,
+            cat: { functional: true, statistics: true },
+        });
+        expect(hasStatisticsConsent(outdated)).toBe(false);
+    });
+});
+//# sourceMappingURL=consent.test.js.map

package/dist/analytics/consent.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.test.js","sourceRoot":"","sources":["../../src/analytics/consent.test.ts"],"names":[],"mappings":"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"}

package/dist/analytics/events.d.ts

@@ -0,0 +1,82 @@
+/** Which deployable emitted the event. Registered as a super property client-side, stamped per event server-side. */
+export type TAnalyticsApp = 'auth' | 'portal' | 'services' | 'api';
+/**
+ * Coarse population the signed-in user belongs to, for segmentation. Shared
+ * vocabulary so the apps cannot diverge: each derives it from whatever signal it
+ * already trusts (an RBAC permission in Services, the CRM customer type in the
+ * auth hub) but they must agree on the values.
+ *
+ * Not set by the Portal, where every user is agency-side and `app: 'portal'`
+ * already says so. A role filter therefore excludes Portal events by design:
+ * see the tracking plan, section 10.3.
+ */
+export type TAnalyticsRole = 'worker' | 'agency';
+export declare const AnalyticsEvents: {
+    readonly pageViewed: "page_viewed";
+    readonly panelViewed: "panel_viewed";
+    /**
+     * A deliberately named UI click, for journey steps that do not warrant their
+     * own semantic event. Middle tier: prefer a semantic KPI event where one
+     * exists (assignment_accepted, not element_clicked), and leave everything
+     * else to autocapture. Carries a stable snake_case `element_name`, never a
+     * translated label.
+     */
+    readonly elementClicked: "element_clicked";
+    readonly formStarted: "form_started";
+    readonly formSubmitted: "form_submitted";
+    readonly formFailed: "form_failed";
+    readonly loginStarted: "login_started";
+    readonly loginCompleted: "login_completed";
+    readonly loginFailed: "login_failed";
+    readonly logoutCompleted: "logout_completed";
+    readonly inviteOpened: "invite_opened";
+    readonly inviteExpiredViewed: "invite_expired_viewed";
+    readonly signupCompleted: "signup_completed";
+    readonly emailVerificationRequested: "email_verification_requested";
+    readonly emailVerified: "email_verified";
+    readonly passwordResetRequested: "password_reset_requested";
+    readonly passwordResetCompleted: "password_reset_completed";
+    readonly appTileClicked: "app_tile_clicked";
+    readonly workerOnboardingStarted: "worker_onboarding_started";
+    readonly documentUploaded: "document_uploaded";
+    readonly documentViewed: "document_viewed";
+    readonly workerViewed: "worker_viewed";
+    readonly assignmentViewed: "assignment_viewed";
+    readonly onboardingStepViewed: "onboarding_step_viewed";
+    readonly onboardingStepCompleted: "onboarding_step_completed";
+    readonly kycStarted: "kyc_started";
+    readonly insuranceValidationStarted: "insurance_validation_started";
+    readonly assignmentAccepted: "assignment_accepted";
+    readonly assignmentDeclined: "assignment_declined";
+    readonly caseFormSubmitted: "case_form_submitted";
+    readonly caseThreadOpened: "case_thread_opened";
+    /**
+     * The thread's "Did this answer your question?" prompt. `answer` is `yes`
+     * (the portal then closes the case, confirmed by the API's `case_closed`) or
+     * `no` (prompt dismissed; never reaches the API, so only visible here).
+     */
+    readonly caseClosePromptAnswered: "case_close_prompt_answered";
+    /** Funnel step only: the authoritative record is the API's `worker_referred`. */
+    readonly workerReferralSubmitted: "worker_referral_submitted";
+    readonly simulationViewed: "simulation_viewed";
+    readonly bankDetailsSubmitted: "bank_details_submitted";
+    readonly userInvited: "user_invited";
+    readonly userRegistered: "user_registered";
+    readonly caseCreated: "case_created";
+    readonly caseReplyCreated: "case_reply_created";
+    readonly caseClosed: "case_closed";
+    readonly assignmentStatusChanged: "assignment_status_changed";
+    readonly changeRequestCreated: "change_request_created";
+    /** An agency referred a worker (CRM referral created at stage `referred`). */
+    readonly workerReferred: "worker_referred";
+    readonly changeRequestResponded: "change_request_responded";
+    readonly kycVerificationCompleted: "kyc_verification_completed";
+    readonly documentValidationCompleted: "document_validation_completed";
+    readonly contractorDocumentUploaded: "contractor_document_uploaded";
+};
+export type TAnalyticsEventName = (typeof AnalyticsEvents)[keyof typeof AnalyticsEvents];
+/** Allowed property value types. No objects/arrays: keeps properties queryable and PII-review simple. */
+export type TAnalyticsPropValue = string | number | boolean | null | undefined;
+/** Event properties. Property names must be snake_case; no PII (names, emails, free text). */
+export type TAnalyticsProps = Record<string, TAnalyticsPropValue>;
+//# sourceMappingURL=events.d.ts.map

package/dist/analytics/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"AAKA,qHAAqH;AACrH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAA;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEhD,eAAO,MAAM,eAAe;;;IAI1B;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoCH;;;;OAIG;;IAEH,iFAAiF;;;;;;;;;;;IAajF,8EAA8E;;;;;;CAMtE,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AAExD,yGAAyG;AACzG,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;AAE9E,8FAA8F;AAC9F,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA"}

package/dist/analytics/events.js

@@ -0,0 +1,73 @@
+// Mixpanel event dictionary - single source of truth for event names across
+// all apps and the API. Naming convention: snake_case object_verb (past tense).
+// Never encode dynamic data (ids, dates, page names) in an event NAME; use a
+// property. Tracking plan: /context/docs/mixpanel-tracking-plan.md (workspace).
+export const AnalyticsEvents = {
+    // Cross-app (identical shape in all web apps)
+    pageViewed: 'page_viewed',
+    panelViewed: 'panel_viewed',
+    /**
+     * A deliberately named UI click, for journey steps that do not warrant their
+     * own semantic event. Middle tier: prefer a semantic KPI event where one
+     * exists (assignment_accepted, not element_clicked), and leave everything
+     * else to autocapture. Carries a stable snake_case `element_name`, never a
+     * translated label.
+     */
+    elementClicked: 'element_clicked',
+    formStarted: 'form_started',
+    formSubmitted: 'form_submitted',
+    formFailed: 'form_failed',
+    // wwl-auth (identity moments)
+    loginStarted: 'login_started',
+    loginCompleted: 'login_completed',
+    loginFailed: 'login_failed',
+    logoutCompleted: 'logout_completed',
+    inviteOpened: 'invite_opened',
+    inviteExpiredViewed: 'invite_expired_viewed',
+    signupCompleted: 'signup_completed',
+    emailVerificationRequested: 'email_verification_requested',
+    emailVerified: 'email_verified',
+    passwordResetRequested: 'password_reset_requested',
+    passwordResetCompleted: 'password_reset_completed',
+    appTileClicked: 'app_tile_clicked',
+    // Portal (admin/managers)
+    workerOnboardingStarted: 'worker_onboarding_started',
+    documentUploaded: 'document_uploaded',
+    documentViewed: 'document_viewed',
+    workerViewed: 'worker_viewed',
+    assignmentViewed: 'assignment_viewed',
+    // Services (workers/agencies)
+    onboardingStepViewed: 'onboarding_step_viewed',
+    onboardingStepCompleted: 'onboarding_step_completed',
+    kycStarted: 'kyc_started',
+    insuranceValidationStarted: 'insurance_validation_started',
+    assignmentAccepted: 'assignment_accepted',
+    assignmentDeclined: 'assignment_declined',
+    caseFormSubmitted: 'case_form_submitted',
+    caseThreadOpened: 'case_thread_opened',
+    /**
+     * The thread's "Did this answer your question?" prompt. `answer` is `yes`
+     * (the portal then closes the case, confirmed by the API's `case_closed`) or
+     * `no` (prompt dismissed; never reaches the API, so only visible here).
+     */
+    caseClosePromptAnswered: 'case_close_prompt_answered',
+    /** Funnel step only: the authoritative record is the API's `worker_referred`. */
+    workerReferralSubmitted: 'worker_referral_submitted',
+    simulationViewed: 'simulation_viewed',
+    bankDetailsSubmitted: 'bank_details_submitted',
+    // API (server-truthy business outcomes - the authoritative record)
+    userInvited: 'user_invited',
+    userRegistered: 'user_registered',
+    caseCreated: 'case_created',
+    caseReplyCreated: 'case_reply_created',
+    caseClosed: 'case_closed',
+    assignmentStatusChanged: 'assignment_status_changed',
+    changeRequestCreated: 'change_request_created',
+    /** An agency referred a worker (CRM referral created at stage `referred`). */
+    workerReferred: 'worker_referred',
+    changeRequestResponded: 'change_request_responded',
+    kycVerificationCompleted: 'kyc_verification_completed',
+    documentValidationCompleted: 'document_validation_completed',
+    contractorDocumentUploaded: 'contractor_document_uploaded',
+};
+//# sourceMappingURL=events.js.map

package/dist/analytics/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAiBhF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,8CAA8C;IAC9C,UAAU,EAAE,aAAa;IACzB,WAAW,EAAE,cAAc;IAC3B;;;;;;OAMG;IACH,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,gBAAgB;IAC/B,UAAU,EAAE,aAAa;IAEzB,8BAA8B;IAC9B,YAAY,EAAE,eAAe;IAC7B,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,cAAc;IAC3B,eAAe,EAAE,kBAAkB;IACnC,YAAY,EAAE,eAAe;IAC7B,mBAAmB,EAAE,uBAAuB;IAC5C,eAAe,EAAE,kBAAkB;IACnC,0BAA0B,EAAE,8BAA8B;IAC1D,aAAa,EAAE,gBAAgB;IAC/B,sBAAsB,EAAE,0BAA0B;IAClD,sBAAsB,EAAE,0BAA0B;IAClD,cAAc,EAAE,kBAAkB;IAElC,0BAA0B;IAC1B,uBAAuB,EAAE,2BAA2B;IACpD,gBAAgB,EAAE,mBAAmB;IACrC,cAAc,EAAE,iBAAiB;IACjC,YAAY,EAAE,eAAe;IAC7B,gBAAgB,EAAE,mBAAmB;IAErC,8BAA8B;IAC9B,oBAAoB,EAAE,wBAAwB;IAC9C,uBAAuB,EAAE,2BAA2B;IACpD,UAAU,EAAE,aAAa;IACzB,0BAA0B,EAAE,8BAA8B;IAC1D,kBAAkB,EAAE,qBAAqB;IACzC,kBAAkB,EAAE,qBAAqB;IACzC,iBAAiB,EAAE,qBAAqB;IACxC,gBAAgB,EAAE,oBAAoB;IACtC;;;;OAIG;IACH,uBAAuB,EAAE,4BAA4B;IACrD,iFAAiF;IACjF,uBAAuB,EAAE,2BAA2B;IACpD,gBAAgB,EAAE,mBAAmB;IACrC,oBAAoB,EAAE,wBAAwB;IAE9C,mEAAmE;IACnE,WAAW,EAAE,cAAc;IAC3B,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,cAAc;IAC3B,gBAAgB,EAAE,oBAAoB;IACtC,UAAU,EAAE,aAAa;IACzB,uBAAuB,EAAE,2BAA2B;IACpD,oBAAoB,EAAE,wBAAwB;IAC9C,8EAA8E;IAC9E,cAAc,EAAE,iBAAiB;IACjC,sBAAsB,EAAE,0BAA0B;IAClD,wBAAwB,EAAE,4BAA4B;IACtD,2BAA2B,EAAE,+BAA+B;IAC5D,0BAA0B,EAAE,8BAA8B;CAClD,CAAA"}

package/dist/analytics/index.d.ts

@@ -0,0 +1,4 @@
+export * from './events.js';
+export * from './consent.js';
+export * from './serverTracker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA"}

package/dist/analytics/index.js

@@ -0,0 +1,4 @@
+export * from './events.js';
+export * from './consent.js';
+export * from './serverTracker.js';
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA"}

package/dist/analytics/serverTracker.d.ts

@@ -0,0 +1,36 @@
+import type { TAnalyticsApp, TAnalyticsEventName, TAnalyticsProps } from './events.js';
+export declare const MIXPANEL_EU_HOST = "https://api-eu.mixpanel.com";
+export interface IServerTrackerOptions {
+    /** Mixpanel project token. Missing or an unresolved "$(...)" pipeline macro disables the tracker (no-op, one warning). */
+    token: string | undefined;
+    /** Stamped on every event. Defaults to 'api'. */
+    app?: TAnalyticsApp;
+    host?: string;
+    /** Events per /import request. Mixpanel caps at 2000; keep batches small. */
+    maxBatchSize?: number;
+    flushIntervalMs?: number;
+    /** Send attempts per batch on 429/5xx/network failure before dropping. */
+    maxRetries?: number;
+    /** Injectable for tests and future runtimes. Defaults to globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+    /** Failure reporter. Defaults to console.warn. Must not throw. */
+    onError?: (message: string, detail?: unknown) => void;
+}
+export interface ITrackOptions {
+    /** The acting user's identity ($user_id, e.g. the Auth0 sub). Required and non-empty. */
+    distinctId: string;
+    props?: TAnalyticsProps;
+    /** Event time, epoch ms. Defaults to now. */
+    timeMs?: number;
+}
+export interface IServerTracker {
+    /** False when the token was missing/invalid at creation: all calls no-op. */
+    readonly enabled: boolean;
+    track: (event: TAnalyticsEventName, options: ITrackOptions) => void;
+    /** Send everything queued now. Resolves when the queue has drained (or dropped). */
+    flush: () => Promise<void>;
+    /** Stop the interval timer and flush. Call on process shutdown. */
+    shutdown: () => Promise<void>;
+}
+export declare const createServerTracker: (options: IServerTrackerOptions) => IServerTracker;
+//# sourceMappingURL=serverTracker.d.ts.map

package/dist/analytics/serverTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverTracker.d.ts","sourceRoot":"","sources":["../../src/analytics/serverTracker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,eAAe,EAChB,MAAM,aAAa,CAAA;AAEpB,eAAO,MAAM,gBAAgB,gCAAgC,CAAA;AAE7D,MAAM,WAAW,qBAAqB;IACpC,0HAA0H;IAC1H,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,iDAAiD;IACjD,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACtD;AAED,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,KAAK,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;IACnE,oFAAoF;IACpF,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAqBD,eAAO,MAAM,mBAAmB,GAC9B,SAAS,qBAAqB,KAC7B,cAmJF,CAAA"}

package/dist/analytics/serverTracker.js

@@ -0,0 +1,139 @@
+// Server-side Mixpanel tracker over the /import HTTP API. Framework-agnostic
+// by design (no Next.js or node: imports) so the API's planned migration off
+// Next.js changes nothing here. Fire-and-forget: an analytics failure must
+// never fail a business request, so nothing in here throws to the caller.
+export const MIXPANEL_EU_HOST = 'https://api-eu.mixpanel.com';
+const isUsableToken = (token) => typeof token === 'string' && token.length > 0 && !/^\$\(.+\)$/.test(token);
+export const createServerTracker = (options) => {
+    const { token, app = 'api', host = MIXPANEL_EU_HOST, maxBatchSize = 200, flushIntervalMs = 10_000, maxRetries = 3, fetchImpl = globalThis.fetch, onError = (message, detail) => 
+    // eslint-disable-next-line no-console
+    console.warn(`[analytics] ${message}`, detail ?? ''), } = options;
+    const enabled = isUsableToken(token);
+    if (!enabled) {
+        onError('Mixpanel token missing or unresolved macro - tracking disabled');
+        return {
+            enabled: false,
+            track: () => undefined,
+            flush: () => Promise.resolve(),
+            shutdown: () => Promise.resolve(),
+        };
+    }
+    const importUrl = `${host}/import?strict=1`;
+    const authHeader = `Basic ${btoa(`${token}:`)}`;
+    let queue = [];
+    let timer;
+    let inFlight;
+    const scheduleFlush = () => {
+        if (timer !== undefined)
+            return;
+        timer = setTimeout(() => {
+            timer = undefined;
+            void flush();
+        }, flushIntervalMs);
+        // Do not keep the process alive for analytics (Node-only; absent in browsers).
+        const unref = timer.unref;
+        if (typeof unref === 'function')
+            unref.call(timer);
+    };
+    const sendBatch = async (batch) => {
+        try {
+            const response = await fetchImpl(importUrl, {
+                method: 'POST',
+                headers: {
+                    authorization: authHeader,
+                    'content-type': 'application/json',
+                    accept: 'application/json',
+                },
+                body: JSON.stringify(batch.map(pending => pending.body)),
+            });
+            if (response.ok)
+                return;
+            if (response.status === 429 || response.status >= 500) {
+                requeue(batch, `Mixpanel /import responded ${response.status}`);
+                return;
+            }
+            // 4xx other than 429: strict validation rejected the payload; retrying cannot help.
+            onError(`Mixpanel /import rejected batch (${response.status}) - ${batch.length} event(s) dropped`, await response.text().catch(() => undefined));
+        }
+        catch (error) {
+            requeue(batch, 'Mixpanel /import request failed');
+            void error;
+        }
+    };
+    const requeue = (batch, reason) => {
+        const retryable = batch
+            .map(pending => ({ ...pending, attempts: pending.attempts + 1 }))
+            .filter(pending => pending.attempts < maxRetries);
+        const dropped = batch.length - retryable.length;
+        if (dropped > 0)
+            onError(`${reason} - ${dropped} event(s) dropped after ${maxRetries} attempts`);
+        if (retryable.length > 0) {
+            queue.push(...retryable);
+            scheduleFlush();
+        }
+    };
+    // One drain pass sends only what was queued when it started; failed events
+    // are requeued at the back with attempts+1 for the next pass, so a single
+    // pass never resends the same event. Retry volume is bounded by maxRetries.
+    // $insert_id makes any duplicate delivery a safe no-op on Mixpanel's side.
+    const drain = async () => {
+        let remaining = queue.length;
+        while (remaining > 0) {
+            const batch = queue.slice(0, Math.min(maxBatchSize, remaining));
+            queue = queue.slice(batch.length);
+            remaining -= batch.length;
+            await sendBatch(batch);
+        }
+    };
+    const flush = async () => {
+        // Loop until the queue is fully drained: picks up events queued while a
+        // drain was in flight, and retries requeued failures immediately. This
+        // terminates because failures increment attempts and drop at maxRetries.
+        while (inFlight !== undefined || queue.length > 0) {
+            if (inFlight === undefined)
+                inFlight = drain().finally(() => {
+                    inFlight = undefined;
+                });
+            await inFlight;
+        }
+    };
+    const track = (event, trackOptions) => {
+        try {
+            const { distinctId, props, timeMs } = trackOptions;
+            if (!distinctId) {
+                onError(`track('${event}') called without a distinctId - event dropped`);
+                return;
+            }
+            queue.push({
+                attempts: 0,
+                body: {
+                    event,
+                    properties: {
+                        ...props,
+                        time: timeMs ?? Date.now(),
+                        distinct_id: distinctId,
+                        $insert_id: globalThis.crypto.randomUUID(),
+                        ip: '0',
+                        app,
+                    },
+                },
+            });
+            if (queue.length >= maxBatchSize)
+                void flush();
+            else
+                scheduleFlush();
+        }
+        catch (error) {
+            onError('track() failed', error);
+        }
+    };
+    const shutdown = async () => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+        await flush();
+    };
+    return { enabled: true, track, flush, shutdown };
+};
+//# sourceMappingURL=serverTracker.js.map

package/dist/analytics/serverTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverTracker.js","sourceRoot":"","sources":["../../src/analytics/serverTracker.ts"],"names":[],"mappings":"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"}

package/dist/analytics/serverTracker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serverTracker.test.d.ts.map

package/dist/analytics/serverTracker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverTracker.test.d.ts","sourceRoot":"","sources":["../../src/analytics/serverTracker.test.ts"],"names":[],"mappings":""}

package/dist/analytics/serverTracker.test.js

@@ -0,0 +1,139 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { AnalyticsEvents } from './events.js';
+import { createServerTracker, MIXPANEL_EU_HOST } from './serverTracker.js';
+const okResponse = () => new Response('{"status":"OK"}', { status: 200 });
+const errorResponse = (status) => new Response('{"error":"boom"}', { status });
+describe('event dictionary hygiene', () => {
+    it('all event names are unique snake_case', () => {
+        const names = Object.values(AnalyticsEvents);
+        expect(new Set(names).size).toBe(names.length);
+        for (const name of names) {
+            expect(name).toMatch(/^[a-z][a-z0-9]*(_[a-z0-9]+)*$/);
+        }
+    });
+});
+describe('createServerTracker', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('no-ops with a warning when the token is missing or an unresolved macro', () => {
+        const onError = vi.fn();
+        const fetchImpl = vi.fn();
+        for (const token of [undefined, '', '$(MIXPANEL_TOKEN)']) {
+            const tracker = createServerTracker({ token, onError, fetchImpl });
+            tracker.track(AnalyticsEvents.caseCreated, { distinctId: 'auth0|1' });
+            expect(tracker.enabled).toBe(false);
+        }
+        expect(onError).toHaveBeenCalledTimes(3);
+        expect(fetchImpl).not.toHaveBeenCalled();
+    });
+    it('sends events to EU /import with auth, $insert_id, ip 0 and app stamp', async () => {
+        const fetchImpl = vi.fn().mockResolvedValue(okResponse());
+        const tracker = createServerTracker({ token: 'tok-123', fetchImpl });
+        tracker.track(AnalyticsEvents.caseCreated, {
+            distinctId: 'auth0|abc',
+            props: { case_type: 'question' },
+            timeMs: 1_756_000_000_000,
+        });
+        await tracker.flush();
+        expect(fetchImpl).toHaveBeenCalledTimes(1);
+        const [url, init] = fetchImpl.mock.calls[0];
+        expect(url).toBe(`${MIXPANEL_EU_HOST}/import?strict=1`);
+        expect(init.headers.authorization).toBe(`Basic ${btoa('tok-123:')}`);
+        const body = JSON.parse(init.body);
+        expect(body).toHaveLength(1);
+        expect(body[0]?.event).toBe('case_created');
+        expect(body[0]?.properties).toMatchObject({
+            time: 1_756_000_000_000,
+            distinct_id: 'auth0|abc',
+            ip: '0',
+            app: 'api',
+            case_type: 'question',
+        });
+        expect(body[0]?.properties.$insert_id).toMatch(/^[0-9a-f-]{36}$/);
+    });
+    it('flushes on the interval without an explicit flush call', async () => {
+        const fetchImpl = vi.fn().mockResolvedValue(okResponse());
+        const tracker = createServerTracker({
+            token: 'tok',
+            fetchImpl,
+            flushIntervalMs: 5_000,
+        });
+        tracker.track(AnalyticsEvents.userInvited, { distinctId: 'auth0|1' });
+        expect(fetchImpl).not.toHaveBeenCalled();
+        await vi.advanceTimersByTimeAsync(5_000);
+        expect(fetchImpl).toHaveBeenCalledTimes(1);
+    });
+    it('flushes immediately when the batch size is reached, splitting batches', async () => {
+        const fetchImpl = vi.fn().mockResolvedValue(okResponse());
+        const tracker = createServerTracker({
+            token: 'tok',
+            fetchImpl,
+            maxBatchSize: 2,
+        });
+        tracker.track(AnalyticsEvents.userInvited, { distinctId: 'a' });
+        tracker.track(AnalyticsEvents.userInvited, { distinctId: 'b' });
+        tracker.track(AnalyticsEvents.userInvited, { distinctId: 'c' });
+        await tracker.flush();
+        const sentCounts = fetchImpl.mock.calls.map(call => JSON.parse(call[1].body).length);
+        expect(sentCounts.reduce((sum, count) => sum + count, 0)).toBe(3);
+        for (const count of sentCounts)
+            expect(count).toBeLessThanOrEqual(2);
+    });
+    it('retries retryable failures up to maxRetries within a flush, then drops', async () => {
+        const onError = vi.fn();
+        const fetchImpl = vi.fn().mockResolvedValue(errorResponse(503));
+        const tracker = createServerTracker({
+            token: 'tok',
+            fetchImpl,
+            maxRetries: 2,
+            onError,
+        });
+        tracker.track(AnalyticsEvents.caseCreated, { distinctId: 'a' });
+        await tracker.flush(); // attempt 1 fails + retried once, then dropped (maxRetries 2)
+        await tracker.flush(); // nothing left
+        expect(fetchImpl).toHaveBeenCalledTimes(2);
+        expect(onError).toHaveBeenCalledWith(expect.stringContaining('dropped after 2 attempts'));
+    });
+    it('recovers events on a retry after a transient failure', async () => {
+        const fetchImpl = vi
+            .fn()
+            .mockRejectedValueOnce(new Error('network down'))
+            .mockResolvedValue(okResponse());
+        const tracker = createServerTracker({ token: 'tok', fetchImpl });
+        tracker.track(AnalyticsEvents.caseCreated, { distinctId: 'a' });
+        await tracker.flush();
+        await tracker.flush();
+        expect(fetchImpl).toHaveBeenCalledTimes(2);
+    });
+    it('drops the batch without retry on a non-retryable 4xx', async () => {
+        const onError = vi.fn();
+        const fetchImpl = vi.fn().mockResolvedValue(errorResponse(400));
+        const tracker = createServerTracker({ token: 'tok', fetchImpl, onError });
+        tracker.track(AnalyticsEvents.caseCreated, { distinctId: 'a' });
+        await tracker.flush();
+        await tracker.flush();
+        expect(fetchImpl).toHaveBeenCalledTimes(1);
+        expect(onError).toHaveBeenCalledWith(expect.stringContaining('rejected batch (400)'), expect.anything());
+    });
+    it('drops events without a distinctId and never throws', () => {
+        const onError = vi.fn();
+        const fetchImpl = vi.fn();
+        const tracker = createServerTracker({ token: 'tok', fetchImpl, onError });
+        expect(() => tracker.track(AnalyticsEvents.caseCreated, { distinctId: '' })).not.toThrow();
+        expect(onError).toHaveBeenCalledWith(expect.stringContaining('without a distinctId'));
+    });
+    it('shutdown flushes the queue and stops the timer', async () => {
+        const fetchImpl = vi.fn().mockResolvedValue(okResponse());
+        const tracker = createServerTracker({ token: 'tok', fetchImpl });
+        tracker.track(AnalyticsEvents.caseCreated, { distinctId: 'a' });
+        await tracker.shutdown();
+        expect(fetchImpl).toHaveBeenCalledTimes(1);
+        await vi.advanceTimersByTimeAsync(60_000);
+        expect(fetchImpl).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=serverTracker.test.js.map

package/dist/analytics/serverTracker.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverTracker.test.js","sourceRoot":"","sources":["../../src/analytics/serverTracker.test.ts"],"names":[],"mappings":"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"}

package/dist/models/schemas/api/assignment/TAssignmentAPI.d.ts

@@ -4107,7 +4107,7 @@ export type TAssignmentAPI = Omit<z.infer<typeof AssignmentEntity.SResponseAPI>,
 };
 export type TAssignmentPayloadAPI = z.infer<typeof AssignmentEntity.SPayloadAPI>;
 export declare const SAssignmentsQueryParams: z.ZodEffects<z.ZodType<URLSearchParams, z.ZodTypeDef, URLSearchParams>, {
-    filter: "agent" | "agency" | "contractor";
+    filter: "agency" | "agent" | "contractor";
     id: string;
     includeChildren?: boolean | undefined;
     includeDocuments?: boolean | undefined;

package/dist/models/schemas/api/batch/SBatchAPI.d.ts

@@ -6,15 +6,15 @@ export declare const SBatchAPI: z.ZodUnion<[z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     refId: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    method: "POST" | "PATCH" | "DELETE";
     type: string;
     data: Record<string, unknown>;
-    method: "POST" | "PATCH" | "DELETE";
     id?: string | undefined;
     refId?: number | undefined;
 }, {
+    method: "POST" | "PATCH" | "DELETE";
     type: string;
     data: Record<string, unknown>;
-    method: "POST" | "PATCH" | "DELETE";
     id?: string | undefined;
     refId?: number | undefined;
 }>, z.ZodObject<{
@@ -25,18 +25,18 @@ export declare const SBatchAPI: z.ZodUnion<[z.ZodObject<{
     query: z.ZodOptional<z.ZodString>;
     key: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: string;
     method: "GET";
+    type: string;
+    key?: string | undefined;
     id?: string | undefined;
     data?: Record<string, unknown> | undefined;
-    key?: string | undefined;
     query?: string | undefined;
 }, {
-    type: string;
     method: "GET";
+    type: string;
+    key?: string | undefined;
     id?: string | undefined;
     data?: Record<string, unknown> | undefined;
-    key?: string | undefined;
     query?: string | undefined;
 }>]>;
 //# sourceMappingURL=SBatchAPI.d.ts.map

package/dist/models/schemas/api/changeRequest/TChangeRequestAPI.d.ts

@@ -677,8 +677,8 @@ export declare const ChangeRequestEntity: {
         };
     }, false>, z.UnknownKeysParam, z.ZodTypeAny, {
         changerequestId: string;
-        source?: number | null | undefined;
         status?: number | null | undefined;
+        source?: number | null | undefined;
         void?: number | null | undefined;
         workCountryValue?: string | null | undefined;
         etag?: string | null | undefined;
@@ -743,8 +743,8 @@ export declare const ChangeRequestEntity: {
         documents?: any[] | null | undefined;
     }, {
         changerequestId: string;
-        source?: number | null | undefined;
         status?: number | null | undefined;
+        source?: number | null | undefined;
         void?: number | null | undefined;
         workCountryValue?: string | null | undefined;
         etag?: string | null | undefined;
@@ -855,8 +855,8 @@ export declare const ChangeRequestEntity: {
         readonly reasonForChange: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         readonly documents: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
     }, z.UnknownKeysParam, z.ZodTypeAny, {
-        source?: number | null | undefined;
         status?: number | null | undefined;
+        source?: number | null | undefined;
         void?: number | null | undefined;
         workCountryValue?: string | null | undefined;
         name?: string | null | undefined;
@@ -901,8 +901,8 @@ export declare const ChangeRequestEntity: {
         reasonForChange?: string | null | undefined;
         documents?: string | null | undefined;
     }, {
-        source?: number | null | undefined;
         status?: number | null | undefined;
+        source?: number | null | undefined;
         void?: number | null | undefined;
         workCountryValue?: string | null | undefined;
         name?: string | null | undefined;

package/dist/models/schemas/api/changeRequest/index.d.ts

@@ -680,8 +680,8 @@ export declare const ChangeRequest: {
             };
         }, false>, import("zod").UnknownKeysParam, import("zod").ZodTypeAny, {
             changerequestId: string;
-            source?: number | null | undefined;
             status?: number | null | undefined;
+            source?: number | null | undefined;
             void?: number | null | undefined;
             workCountryValue?: string | null | undefined;
             etag?: string | null | undefined;
@@ -746,8 +746,8 @@ export declare const ChangeRequest: {
             documents?: any[] | null | undefined;
         }, {
             changerequestId: string;
-            source?: number | null | undefined;
             status?: number | null | undefined;
+            source?: number | null | undefined;
             void?: number | null | undefined;
             workCountryValue?: string | null | undefined;
             etag?: string | null | undefined;
@@ -858,8 +858,8 @@ export declare const ChangeRequest: {
             readonly reasonForChange: import("zod").ZodOptional<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>>;
             readonly documents: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodOptional<import("zod").ZodString>>>;
         }, import("zod").UnknownKeysParam, import("zod").ZodTypeAny, {
-            source?: number | null | undefined;
             status?: number | null | undefined;
+            source?: number | null | undefined;
             void?: number | null | undefined;
             workCountryValue?: string | null | undefined;
             name?: string | null | undefined;
@@ -904,8 +904,8 @@ export declare const ChangeRequest: {
             reasonForChange?: string | null | undefined;
             documents?: string | null | undefined;
         }, {
-            source?: number | null | undefined;
             status?: number | null | undefined;
+            source?: number | null | undefined;
             void?: number | null | undefined;
             workCountryValue?: string | null | undefined;
             name?: string | null | undefined;

package/dist/models/schemas/api/referral/TReferralAPI.d.ts

@@ -3262,7 +3262,7 @@ export type TReferralD365 = z.infer<typeof ReferralEntity.SResponseD365>;
 export type TReferralAPI = z.infer<typeof ReferralEntity.SResponseAPI>;
 export type TReferralPayloadAPI = z.infer<typeof ReferralEntity.SPayloadAPI>;
 export declare const SReferralsQueryParams: z.ZodEffects<z.ZodType<URLSearchParams, z.ZodTypeDef, URLSearchParams>, {
-    filter: "agent" | "agency" | "contractor";
+    filter: "agency" | "agent" | "contractor";
     id: string;
     includeChildren: boolean;
     includeDocuments: boolean;

package/dist/models/schemas/api/systemUser/TSystemUserAPI.d.ts

@@ -735,11 +735,11 @@ export declare const SystemUserEntity: {
         };
     }, false>, z.UnknownKeysParam, z.ZodTypeAny, {
         systemUserId: string;
+        status?: boolean | null | undefined;
         description?: string | null | undefined;
         fax?: string | null | undefined;
         nickname?: string | null | undefined;
         pager?: string | null | undefined;
-        status?: boolean | null | undefined;
         type?: number | null | undefined;
         firstName?: string | null | undefined;
         middleName?: string | null | undefined;
@@ -813,11 +813,11 @@ export declare const SystemUserEntity: {
         recipientEmails?: string | null | undefined;
     }, {
         systemUserId: string;
+        status?: boolean | null | undefined;
         description?: string | null | undefined;
         fax?: string | null | undefined;
         nickname?: string | null | undefined;
         pager?: string | null | undefined;
-        status?: boolean | null | undefined;
         type?: number | null | undefined;
         firstName?: string | null | undefined;
         middleName?: string | null | undefined;
@@ -953,11 +953,11 @@ export declare const SystemUserEntity: {
         readonly recipientEmails: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         readonly status: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
     }, z.UnknownKeysParam, z.ZodTypeAny, {
+        status?: boolean | null | undefined;
         description?: string | null | undefined;
         fax?: string | null | undefined;
         nickname?: string | null | undefined;
         pager?: string | null | undefined;
-        status?: boolean | null | undefined;
         type?: number | null | undefined;
         firstName?: string | null | undefined;
         middleName?: string | null | undefined;
@@ -1015,11 +1015,11 @@ export declare const SystemUserEntity: {
         omnichannelPhoneValue?: string | null | undefined;
         recipientEmails?: string | null | undefined;
     }, {
+        status?: boolean | null | undefined;
         description?: string | null | undefined;
         fax?: string | null | undefined;
         nickname?: string | null | undefined;
         pager?: string | null | undefined;
-        status?: boolean | null | undefined;
         type?: number | null | undefined;
         firstName?: string | null | undefined;
         middleName?: string | null | undefined;

package/dist/models/schemas/api/systemUser/index.d.ts

@@ -739,11 +739,11 @@ export declare const SystemUser: {
             };
         }, false>, import("zod").UnknownKeysParam, import("zod").ZodTypeAny, {
             systemUserId: string;
+            status?: boolean | null | undefined;
             description?: string | null | undefined;
             fax?: string | null | undefined;
             nickname?: string | null | undefined;
             pager?: string | null | undefined;
-            status?: boolean | null | undefined;
             type?: number | null | undefined;
             firstName?: string | null | undefined;
             middleName?: string | null | undefined;
@@ -817,11 +817,11 @@ export declare const SystemUser: {
             recipientEmails?: string | null | undefined;
         }, {
             systemUserId: string;
+            status?: boolean | null | undefined;
             description?: string | null | undefined;
             fax?: string | null | undefined;
             nickname?: string | null | undefined;
             pager?: string | null | undefined;
-            status?: boolean | null | undefined;
             type?: number | null | undefined;
             firstName?: string | null | undefined;
             middleName?: string | null | undefined;
@@ -957,11 +957,11 @@ export declare const SystemUser: {
             readonly recipientEmails: import("zod").ZodOptional<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>>;
             readonly status: import("zod").ZodOptional<import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>>;
         }, import("zod").UnknownKeysParam, import("zod").ZodTypeAny, {
+            status?: boolean | null | undefined;
             description?: string | null | undefined;
             fax?: string | null | undefined;
             nickname?: string | null | undefined;
             pager?: string | null | undefined;
-            status?: boolean | null | undefined;
             type?: number | null | undefined;
             firstName?: string | null | undefined;
             middleName?: string | null | undefined;
@@ -1019,11 +1019,11 @@ export declare const SystemUser: {
             omnichannelPhoneValue?: string | null | undefined;
             recipientEmails?: string | null | undefined;
         }, {
+            status?: boolean | null | undefined;
             description?: string | null | undefined;
             fax?: string | null | undefined;
             nickname?: string | null | undefined;
             pager?: string | null | undefined;
-            status?: boolean | null | undefined;
             type?: number | null | undefined;
             firstName?: string | null | undefined;
             middleName?: string | null | undefined;

package/dist/models/schemas/bff/changeRequest/SGetChangeRequestBFF.d.ts

@@ -280,7 +280,7 @@ export declare const SGetChangeRequestBFF: z.ZodEffects<z.ZodObject<Pick<import(
         readonly entityKey: "contractorDocument";
         readonly isArray: true;
     };
-}, false>, "source" | "status" | "endDate" | "changeApplies" | "changeType" | "legalStatus" | "relatedAssignmentValue" | "requestedDate" | "requestedByValue" | "assignmentStageAtSubmission" | "proposedEndDate"> & {
+}, false>, "status" | "source" | "endDate" | "changeApplies" | "changeType" | "legalStatus" | "relatedAssignmentValue" | "requestedDate" | "requestedByValue" | "assignmentStageAtSubmission" | "proposedEndDate"> & {
     documents: z.ZodOptional<z.ZodArray<z.ZodOptional<z.ZodNullable<z.ZodObject<Pick<import("../../api/_entityTools/SchemasEntityTools.js").TPrettyShape<{
         readonly _ownerid_value: {
             readonly pretty: "ownerIdValue";
@@ -593,8 +593,8 @@ export declare const SGetChangeRequestBFF: z.ZodEffects<z.ZodObject<Pick<import(
         fileName?: string | null | undefined;
     }>>>, "many">>;
 }, z.UnknownKeysParam, z.ZodTypeAny, {
-    source?: number | null | undefined;
     status?: number | null | undefined;
+    source?: number | null | undefined;
     endDate?: string | null | undefined;
     changeApplies?: number | null | undefined;
     changeType?: number | null | undefined;
@@ -610,8 +610,8 @@ export declare const SGetChangeRequestBFF: z.ZodEffects<z.ZodObject<Pick<import(
         fileName?: string | null | undefined;
     } | null | undefined)[] | undefined;
 }, {
-    source?: number | null | undefined;
     status?: number | null | undefined;
+    source?: number | null | undefined;
     endDate?: string | null | undefined;
     changeApplies?: number | null | undefined;
     changeType?: number | null | undefined;
@@ -627,8 +627,8 @@ export declare const SGetChangeRequestBFF: z.ZodEffects<z.ZodObject<Pick<import(
         fileName?: string | null | undefined;
     } | null | undefined)[] | undefined;
 }>, {
-    source?: number | null | undefined;
     status?: number | null | undefined;
+    source?: number | null | undefined;
     endDate?: string | null | undefined;
     changeApplies?: number | null | undefined;
     changeType?: number | null | undefined;
@@ -644,8 +644,8 @@ export declare const SGetChangeRequestBFF: z.ZodEffects<z.ZodObject<Pick<import(
     assignmentId: string | null | undefined;
     requestedById: string | null | undefined;
 }, {
-    source?: number | null | undefined;
     status?: number | null | undefined;
+    source?: number | null | undefined;
     endDate?: string | null | undefined;
     changeApplies?: number | null | undefined;
     changeType?: number | null | undefined;

package/package.json

@@ -7,7 +7,7 @@
   "name": "@workwell-global/toolkit",
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "1.1.49",
+  "version": "1.1.50",
   "files": [
     "dist"
   ],
@@ -20,6 +20,9 @@
       "*": [
         "./dist/index.d.ts"
       ],
+      "analytics": [
+        "./dist/analytics/index.d.ts"
+      ],
       "enums": [
         "./dist/enums/index.d.ts"
       ],
@@ -87,6 +90,12 @@
       "default": "./dist/index.js"
     },
     "./package.json": "./package.json",
+    "./analytics": {
+      "types": "./dist/analytics/index.d.ts",
+      "import": "./dist/analytics/index.js",
+      "require": "./dist/analytics/index.js",
+      "default": "./dist/analytics/index.js"
+    },
     "./enums": {
       "types": "./dist/enums/index.d.ts",
       "import": "./dist/enums/index.js",