@opendoor/partner-sdk-client-js-core 0.0.1-alpha.40.1 → 0.0.1-alpha.42.1

package/dist/client.d.ts

@@ -20,16 +20,19 @@
  * @packageDocumentation
  */
 import type { AddressSuggestionsResponse, CreateOfferRequest, CreateOfferResponse, UpdateOfferRequest, UpdateOfferResponse, GetOfferResponse, GetOfferWithPricingResponse, AddressUnitCheckResponse, GetAssessmentSlotsRequest, GetAssessmentSlotsResponse, GetHomeDetailRequest, GetHomeDetailResponse } from './types.js';
+export type OpendoorEnvironment = 'staging' | 'production';
 /**
  * Configuration for the browser OpendoorClient.
  *
  * @param baseURL - Base URL of the partner's BFF server (e.g., '/api/opendoor')
  * @param timeout - Request timeout in milliseconds. Defaults to 30000.
+ * @param environment - Target environment. Defaults to 'production'.
  * @param endpoints - Override default endpoint paths.
  */
 export interface OpendoorClientConfig {
     baseURL: string;
     timeout?: number;
+    environment?: OpendoorEnvironment;
     endpoints?: Partial<{
         addressSuggestions: string;
         createOffer: string;
@@ -42,6 +45,7 @@ export declare class OpendoorClient {
     private readonly baseURL;
     private readonly timeout;
     private readonly endpoints;
+    readonly environment: OpendoorEnvironment;
     constructor(config: OpendoorClientConfig);
     /**
      * Search for addresses matching a query string.

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAYpB;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC,CAAC;CACJ;AAqBD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,MAAM,EAAE,oBAAoB;IAcxC;;;;;OAKG;IACG,qBAAqB,CACzB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,0BAA0B,CAAC;IActC;;;;;OAKG;IACG,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IASzE;;;;;;OAMG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAS/B;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW1D;;;;OAIG;IACG,6BAA6B,CACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,2BAA2B,CAAC;IAcvC;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE;QAC9B,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAcrC;;;;;OAKG;IACG,kBAAkB,CACtB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,0BAA0B,CAAC;IActC;;;OAGG;IACG,aAAa,CACjB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC;YAkBnB,OAAO;CA8CtB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAYpB,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,YAAY,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC,CAAC;CACJ;AAqBD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;gBAE9B,MAAM,EAAE,oBAAoB;IAexC;;;;;OAKG;IACG,qBAAqB,CACzB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,0BAA0B,CAAC;IActC;;;;;OAKG;IACG,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IASzE;;;;;;OAMG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAS/B;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAW1D;;;;OAIG;IACG,6BAA6B,CACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,2BAA2B,CAAC;IAcvC;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE;QAC9B,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAcrC;;;;;OAKG;IACG,kBAAkB,CACtB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,0BAA0B,CAAC;IActC;;;OAGG;IACG,aAAa,CACjB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC;YAkBnB,OAAO;CA8CtB"}

package/dist/client.js

@@ -44,6 +44,7 @@ export class OpendoorClient {
         // Strip trailing slash from baseURL
         this.baseURL = config.baseURL.replace(/\/+$/, '');
         this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+        this.environment = config.environment ?? 'production';
         this.endpoints = {
             ...DEFAULT_ENDPOINTS,
             ...config.endpoints,

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  */
 export declare const VERSION = "0.2.0";
 export { OpendoorClient } from './client.js';
-export type { OpendoorClientConfig } from './client.js';
+export type { OpendoorClientConfig, OpendoorEnvironment } from './client.js';
 export type { Address, AddressSuggestionsResponse, CreateOfferRequest, CreateOfferResponse, UpdateOfferRequest, UpdateOfferResponse, GetOfferResponse, GetOfferWithPricingResponse, OfferData, OfferDataWithPricing, DenialInfo, OfferStatus, ExperimentalQuestionAnswer, AddressUnitCheckResponse, GetAssessmentSlotsRequest, GetAssessmentSlotsResponse, GetHomeDetailRequest, GetHomeDetailResponse, } from './types.js';
 export { resolveAppearance, THEMES } from './appearance.js';
 export type { OpendoorAppearance, OpendoorThemeVariables, } from './appearance.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD,YAAY,EACV,OAAO,EACP,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,SAAS,EACT,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAG7E,YAAY,EACV,OAAO,EACP,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,SAAS,EACT,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/tracking-types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Internal types matching the Journey API proto3 JSON format.
+ * These are NOT exported from the package — they are used only by the
+ * internal TrackingClient.
+ *
+ * Field names use camelCase (proto3 JSON mapping).
+ * google.protobuf.StringValue → string | undefined
+ * google.protobuf.Timestamp → ISO 8601 string
+ * oneof → only the selected field is present
+ */
+export interface Screen {
+    width: number;
+    height: number;
+    density: number;
+}
+export interface WebsiteSource {
+    url: string;
+    userAgent?: string;
+    referrer?: string;
+    pathname?: string;
+    host?: string;
+    eventOrigin: 'CLIENT';
+    screen?: Screen;
+    language?: string[];
+}
+export interface PageViewEvent {
+}
+export interface ButtonClickEvent {
+    targetName: string;
+}
+export interface InputViewEvent {
+    targetName: string;
+}
+export interface LinkClickEvent {
+    targetName: string;
+}
+export interface CheckboxClickEvent {
+    targetName: string;
+    optionName: string;
+}
+export interface RadioClickEvent {
+    targetName: string;
+    optionName: string;
+}
+export type PlatformEvent = {
+    pageViewEvent: PageViewEvent;
+} | {
+    buttonClickEvent: ButtonClickEvent;
+} | {
+    inputViewEvent: InputViewEvent;
+} | {
+    linkClickEvent: LinkClickEvent;
+} | {
+    checkboxClickEvent: CheckboxClickEvent;
+} | {
+    radioClickEvent: RadioClickEvent;
+};
+export interface PlatformCategory {
+    platform: PlatformEvent;
+}
+export interface AddressEntryV2Event {
+    street1?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    unit?: string;
+    sourcePage?: string;
+}
+export type SellEvent = {
+    addressEntryV2: AddressEntryV2Event;
+};
+export interface SellCategory {
+    sell: SellEvent;
+}
+export type EventCategory = PlatformCategory | SellCategory;
+export interface EventWrapper {
+    timestamp: string;
+    websiteSource: WebsiteSource;
+    anonymousId?: string;
+    customerUuid?: string;
+    platform?: PlatformEvent;
+    sell?: SellEvent;
+}
+export interface EventWrapperList {
+    eventWrappers: EventWrapper[];
+}
+//# sourceMappingURL=tracking-types.d.ts.map

package/dist/tracking-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-types.d.ts","sourceRoot":"","sources":["../src/tracking-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,QAAQ,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD,MAAM,WAAW,aAAa;CAE7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,aAAa,EAAE,aAAa,CAAA;CAAE,GAChC;IAAE,gBAAgB,EAAE,gBAAgB,CAAA;CAAE,GACtC;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,GAClC;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,GAClC;IAAE,kBAAkB,EAAE,kBAAkB,CAAA;CAAE,GAC1C;IAAE,eAAe,EAAE,eAAe,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,aAAa,CAAC;CACzB;AAMD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,cAAc,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEhE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;CACjB;AAMD,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B"}

package/dist/tracking-types.js

@@ -0,0 +1,11 @@
+/**
+ * Internal types matching the Journey API proto3 JSON format.
+ * These are NOT exported from the package — they are used only by the
+ * internal TrackingClient.
+ *
+ * Field names use camelCase (proto3 JSON mapping).
+ * google.protobuf.StringValue → string | undefined
+ * google.protobuf.Timestamp → ISO 8601 string
+ * oneof → only the selected field is present
+ */
+export {};

package/dist/tracking.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Internal Journey event tracking client.
+ * NOT exported from the package — used only by client-react components.
+ *
+ * Modeled after the observability JourneyClientImpl in opendoor-labs/code,
+ * adapted for cross-origin partner domains.
+ */
+import type { PlatformEvent, SellEvent } from './tracking-types.js';
+import type { OpendoorEnvironment } from './client.js';
+export interface Tracker {
+    trackPlatform(event: PlatformEvent): void;
+    trackSell(event: SellEvent): void;
+    flush(keepalive?: boolean): void;
+    destroy(): void;
+}
+export declare class TrackingClient implements Tracker {
+    private buffer;
+    private timer;
+    private readonly endpoint;
+    private readonly anonymousId;
+    private destroyed;
+    private readonly onVisibilityChange;
+    private readonly onBeforeUnload;
+    constructor(environment: OpendoorEnvironment);
+    trackPlatform(event: PlatformEvent): void;
+    trackSell(event: SellEvent): void;
+    flush(keepalive?: boolean): void;
+    destroy(): void;
+    private enqueue;
+}
+export declare const NOOP_TRACKING: Tracker;
+//# sourceMappingURL=tracking.d.ts.map

package/dist/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../src/tracking.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAGV,aAAa,EACb,SAAS,EACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA0BvD,MAAM,WAAW,OAAO;IACtB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AA8ED,qBAAa,cAAe,YAAW,OAAO;IAC5C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAEjC;IACF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE7B;gBAEU,WAAW,EAAE,mBAAmB;IAa5C,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIzC,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAOjC,KAAK,CAAC,SAAS,UAAQ,GAAG,IAAI;IAmB9B,OAAO,IAAI,IAAI;IAef,OAAO,CAAC,OAAO;CAqBhB;AAMD,eAAO,MAAM,aAAa,EAAE,OAK3B,CAAC"}

package/dist/tracking.js

@@ -0,0 +1,183 @@
+/**
+ * Internal Journey event tracking client.
+ * NOT exported from the package — used only by client-react components.
+ *
+ * Modeled after the observability JourneyClientImpl in opendoor-labs/code,
+ * adapted for cross-origin partner domains.
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const JOURNEY_ENDPOINTS = {
+    production: 'https://journey.apps.opendoor.com/_journey/api/v1/events',
+    staging: 'https://journey.apps-staging.opendoor.com/_journey/api/v1/events',
+};
+const CLIENT_NAME = 'partner-sdk';
+const CLIENT_VERSION = '1.0';
+const FLUSH_INTERVAL_MS = 5000;
+const MAX_BATCH_SIZE = 20;
+const MAX_PAYLOAD_KB = 512;
+const RETRY_COUNT = 5;
+const RETRY_DELAY_MS = 500;
+const ANONYMOUS_ID_KEY = 'od_sdk_aid';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function getOrCreateAnonymousId() {
+    try {
+        const existing = localStorage.getItem(ANONYMOUS_ID_KEY);
+        if (existing)
+            return existing;
+        const id = crypto.randomUUID();
+        localStorage.setItem(ANONYMOUS_ID_KEY, id);
+        return id;
+    }
+    catch {
+        // localStorage unavailable (SSR, privacy mode, etc.)
+        return undefined;
+    }
+}
+function buildWebsiteSource() {
+    if (typeof window === 'undefined') {
+        return { url: '', eventOrigin: 'CLIENT' };
+    }
+    return {
+        url: window.location.href,
+        userAgent: navigator.userAgent,
+        referrer: document.referrer || undefined,
+        pathname: window.location.pathname,
+        host: window.location.host,
+        eventOrigin: 'CLIENT',
+        screen: {
+            width: Math.round(window.innerWidth),
+            height: Math.round(window.innerHeight),
+            density: Math.round(window.devicePixelRatio ?? 1),
+        },
+        language: Array.from(navigator.languages ?? []),
+    };
+}
+function computeSizeKB(buffer) {
+    let total = 0;
+    for (const s of buffer)
+        total += s.length;
+    return total / 1024;
+}
+function isApproachingLimit(buffer) {
+    return computeSizeKB(buffer) >= MAX_PAYLOAD_KB - 50;
+}
+async function fetchWithRetry(url, init) {
+    let retries = RETRY_COUNT;
+    while (retries > 0) {
+        try {
+            const response = await fetch(url, init);
+            if (response.status === 202)
+                return;
+            if (response.status >= 500 && retries >= 1) {
+                await new Promise((r) => setTimeout(r, RETRY_DELAY_MS));
+                retries--;
+            }
+            else {
+                break;
+            }
+        }
+        catch {
+            if (retries >= 1) {
+                await new Promise((r) => setTimeout(r, RETRY_DELAY_MS));
+                retries--;
+            }
+            else {
+                break;
+            }
+        }
+    }
+    // Silent fail — no Sentry in partner SDK
+}
+// ---------------------------------------------------------------------------
+// TrackingClient
+// ---------------------------------------------------------------------------
+export class TrackingClient {
+    constructor(environment) {
+        this.buffer = [];
+        this.destroyed = false;
+        this.onVisibilityChange = () => {
+            if (document.visibilityState === 'hidden')
+                this.flush(true);
+        };
+        this.onBeforeUnload = () => {
+            this.flush(true);
+        };
+        this.endpoint = JOURNEY_ENDPOINTS[environment];
+        this.anonymousId = getOrCreateAnonymousId();
+        this.timer = setInterval(() => this.flush(), FLUSH_INTERVAL_MS);
+        if (typeof document !== 'undefined') {
+            document.addEventListener('visibilitychange', this.onVisibilityChange);
+        }
+        if (typeof window !== 'undefined') {
+            window.addEventListener('beforeunload', this.onBeforeUnload);
+        }
+    }
+    trackPlatform(event) {
+        this.enqueue({ platform: event });
+    }
+    trackSell(event) {
+        this.enqueue({ sell: event });
+    }
+    // keepalive=true is only used on page unload (visibilitychange/beforeunload)
+    // to survive navigation. Timer-based flushes use regular fetch because
+    // keepalive requests have a 64KB cumulative body size limit per origin.
+    flush(keepalive = false) {
+        if (this.buffer.length === 0)
+            return;
+        const body = `{"eventWrappers":[${this.buffer.join(',')}]}`;
+        this.buffer = [];
+        fetchWithRetry(this.endpoint, {
+            method: 'POST',
+            credentials: 'omit',
+            keepalive,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Journey-Client-Name': CLIENT_NAME,
+                'X-Journey-Client-Version': CLIENT_VERSION,
+            },
+            body,
+        });
+    }
+    destroy() {
+        this.destroyed = true;
+        this.flush(true);
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        if (typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.onVisibilityChange);
+        }
+        if (typeof window !== 'undefined') {
+            window.removeEventListener('beforeunload', this.onBeforeUnload);
+        }
+    }
+    enqueue(category) {
+        if (this.destroyed)
+            return;
+        const wrapper = {
+            timestamp: new Date().toISOString(),
+            websiteSource: buildWebsiteSource(),
+            anonymousId: this.anonymousId,
+            ...category,
+        };
+        this.buffer.push(JSON.stringify(wrapper));
+        if (this.buffer.length >= MAX_BATCH_SIZE ||
+            isApproachingLimit(this.buffer)) {
+            this.flush();
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// No-op stub for when tracking is unavailable
+// ---------------------------------------------------------------------------
+export const NOOP_TRACKING = {
+    trackPlatform() { },
+    trackSell() { },
+    flush() { },
+    destroy() { },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendoor/partner-sdk-client-js-core",
-  "version": "0.0.1-alpha.40.1",
+  "version": "0.0.1-alpha.42.1",
   "description": "Framework-agnostic client SDK for Opendoor partner integrations",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./internal/tracking": {
+      "import": "./dist/tracking.js",
+      "types": "./dist/tracking.d.ts"
     }
   },
   "files": [