@ominity/api-typescript 1.1.4 → 1.1.6

package/dist/esm/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sdk/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sdk/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC"}

package/dist/esm/sdk/sdk.d.ts

@@ -9,6 +9,7 @@ import { OAuth2 } from "./oauth2.js";
 import { Settings } from "./settings/index.js";
 import { Users } from "./users/index.js";
 import { Admins } from "./admins.js";
+import { Tracking } from "./tracking/index.js";
 import type { SDKOptions } from "../lib/config.js";
 import type { OminityModuleInput, OminityModules } from "./modules.js";
 export type OminityOptions = SDKOptions & {
@@ -28,6 +29,8 @@ export declare class Ominity extends ClientSDK {
     get settings(): Settings;
     private _http?;
     get http(): Http;
+    private _tracking?;
+    get tracking(): Tracking;
     private _localization?;
     get localization(): Localization;
     private _oauth2?;

package/dist/esm/sdk/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/sdk/sdk.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IACxC,OAAO,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAC1D,CAAC;AAEF,qBAAa,OAAQ,SAAQ,SAAS;IACpC,SAAgB,OAAO,EAAE,cAAc,CAAwB;gBAEnD,OAAO,GAAE,cAAmB;IAWxC,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,IAAI;IAO3C,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,OAAO,CAAC,IAAI,CAAC,CAAM;IACnB,IAAI,GAAG,IAAI,GAAG,CAEb;IAED,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,OAAO,CAAC,KAAK,CAAC,CAAO;IACrB,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,OAAO,CAAC,GAAG,CAAC,CAAK;IACjB,IAAI,EAAE,IAAI,EAAE,CAEX;IAED,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/sdk/sdk.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IACxC,OAAO,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAC1D,CAAC;AAEF,qBAAa,OAAQ,SAAQ,SAAS;IACpC,SAAgB,OAAO,EAAE,cAAc,CAAwB;gBAEnD,OAAO,GAAE,cAAmB;IAWxC,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,IAAI;IAO3C,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,OAAO,CAAC,IAAI,CAAC,CAAM;IACnB,IAAI,GAAG,IAAI,GAAG,CAEb;IAED,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,OAAO,CAAC,KAAK,CAAC,CAAO;IACrB,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,OAAO,CAAC,GAAG,CAAC,CAAK;IACjB,IAAI,EAAE,IAAI,EAAE,CAEX;IAED,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/esm/sdk/sdk.js

@@ -9,6 +9,7 @@ import { OAuth2 } from "./oauth2.js";
 import { Settings } from "./settings/index.js";
 import { Users } from "./users/index.js";
 import { Admins } from "./admins.js";
+import { Tracking } from "./tracking/index.js";
 export class Ominity extends ClientSDK {
     constructor(options = {}) {
         const { modules, ...sdkOptions } = options;
@@ -41,6 +42,9 @@ export class Ominity extends ClientSDK {
     get http() {
         return (this._http ?? (this._http = new Http(this._options)));
     }
+    get tracking() {
+        return (this._tracking ?? (this._tracking = new Tracking(this.http)));
+    }
     get localization() {
         return (this._localization ?? (this._localization = new Localization(this._options)));
     }

package/dist/esm/sdk/sdk.js.map

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

package/dist/esm/sdk/tracking/events.d.ts

@@ -0,0 +1,27 @@
+import { RequestOptions } from "../../lib/sdks.js";
+import { Http } from "../http.js";
+export type TrackingEventName = "page_view" | "product_view" | "cart_view" | "add_to_cart" | "remove_from_cart" | "checkout_started" | "purchase" | "button_click" | string;
+export type TrackingEventMetadata = Readonly<Record<string, unknown>>;
+export type TrackingEventUtm = Readonly<Record<string, string>>;
+export interface TrackEventRequest {
+    readonly event: TrackingEventName;
+    readonly timestamp?: string | Date;
+    readonly title?: string;
+    readonly url?: string;
+    readonly metadata?: TrackingEventMetadata;
+    readonly visitorId?: string;
+    readonly userId?: number;
+    readonly referrer?: string;
+    readonly utm?: TrackingEventUtm;
+}
+export interface TrackEventResponse {
+    readonly success: boolean;
+    readonly visitorId: string;
+}
+export declare class TrackingEvents {
+    #private;
+    constructor(http: Http);
+    create(request: TrackEventRequest, options?: RequestOptions): Promise<TrackEventResponse>;
+    track(request: TrackEventRequest, options?: RequestOptions): Promise<TrackEventResponse>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/esm/sdk/tracking/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/sdk/tracking/events.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,cAAc,GACd,WAAW,GACX,aAAa,GACb,kBAAkB,GAClB,kBAAkB,GAClB,UAAU,GACV,cAAc,GACd,MAAM,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AA0ID,qBAAa,cAAc;;gBAGb,IAAI,EAAE,IAAI;IAIhB,MAAM,CACV,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC;IASxB,KAAK,CACT,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC;CAG/B"}

package/dist/esm/sdk/tracking/events.js

@@ -0,0 +1,133 @@
+/*
+ * Tracking Events SDK.
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TrackingEvents_http;
+function asNonEmptyString(value) {
+    if (typeof value !== "string") {
+        return;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function asValidDate(value) {
+    if (!Number.isFinite(value.getTime())) {
+        return;
+    }
+    return value;
+}
+function normalizeTimestamp(value) {
+    if (value instanceof Date) {
+        const parsed = asValidDate(value);
+        if (parsed) {
+            return parsed.toISOString();
+        }
+    }
+    else if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed.length > 0) {
+            return trimmed;
+        }
+    }
+    return new Date().toISOString();
+}
+function normalizeUtm(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return;
+    }
+    const normalized = {};
+    for (const [key, raw] of Object.entries(value)) {
+        const trimmed = asNonEmptyString(raw);
+        if (trimmed) {
+            normalized[key] = trimmed;
+        }
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+function normalizeMetadata(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return;
+    }
+    return value;
+}
+function normalizeTrackEventPayload(input) {
+    const eventName = asNonEmptyString(input.event);
+    if (!eventName) {
+        throw new Error("Tracking event name is required.");
+    }
+    const payload = {
+        event: eventName,
+        timestamp: normalizeTimestamp(input.timestamp),
+    };
+    const title = asNonEmptyString(input.title);
+    if (title) {
+        payload.title = title;
+    }
+    const url = asNonEmptyString(input.url);
+    if (url) {
+        payload.url = url;
+    }
+    const metadata = normalizeMetadata(input.metadata);
+    if (metadata) {
+        payload.metadata = metadata;
+    }
+    const visitorId = asNonEmptyString(input.visitorId);
+    if (visitorId) {
+        payload.visitorId = visitorId;
+    }
+    if (typeof input.userId === "number" && Number.isFinite(input.userId)) {
+        payload.userId = Math.trunc(input.userId);
+    }
+    const referrer = asNonEmptyString(input.referrer);
+    if (referrer) {
+        payload.referrer = referrer;
+    }
+    const utm = normalizeUtm(input.utm);
+    if (utm) {
+        payload.utm = utm;
+    }
+    return payload;
+}
+function asRecord(value) {
+    if (typeof value === "object" && value !== null) {
+        return value;
+    }
+    return {};
+}
+function normalizeTrackEventResponse(payload) {
+    const record = asRecord(payload);
+    const visitorId = asNonEmptyString(record["visitorId"]) ?? "";
+    const success = record["success"] === true;
+    return {
+        success,
+        visitorId,
+    };
+}
+export class TrackingEvents {
+    constructor(http) {
+        _TrackingEvents_http.set(this, void 0);
+        __classPrivateFieldSet(this, _TrackingEvents_http, http, "f");
+    }
+    async create(request, options) {
+        const response = await __classPrivateFieldGet(this, _TrackingEvents_http, "f").post("/tracking/events", {
+            ...options,
+            json: normalizeTrackEventPayload(request),
+        });
+        return normalizeTrackEventResponse(await response.json());
+    }
+    async track(request, options) {
+        return this.create(request, options);
+    }
+}
+_TrackingEvents_http = new WeakMap();
+//# sourceMappingURL=events.js.map

package/dist/esm/sdk/tracking/events.js.map

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

package/dist/esm/sdk/tracking/index.d.ts

@@ -0,0 +1,12 @@
+import { Http } from "../http.js";
+import { TrackingEvents } from "./events.js";
+export { TrackingEvents, };
+export type { TrackEventRequest, TrackEventResponse, TrackingEventMetadata, TrackingEventName, TrackingEventUtm, } from "./events.js";
+export declare class Tracking {
+    #private;
+    constructor(http: Http);
+    private _events?;
+    get events(): TrackingEvents;
+    track(...args: Parameters<TrackingEvents["track"]>): ReturnType<TrackingEvents["track"]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/sdk/tracking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sdk/tracking/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,cAAc,GACf,CAAC;AACF,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,qBAAa,QAAQ;;gBAGP,IAAI,EAAE,IAAI;IAItB,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,IAAI,MAAM,IAAI,cAAc,CAE3B;IAEK,KAAK,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;CAG/F"}

package/dist/esm/sdk/tracking/index.js

@@ -0,0 +1,31 @@
+/*
+ * SDK module: Tracking
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Tracking_http;
+import { TrackingEvents } from "./events.js";
+export { TrackingEvents, };
+export class Tracking {
+    constructor(http) {
+        _Tracking_http.set(this, void 0);
+        __classPrivateFieldSet(this, _Tracking_http, http, "f");
+    }
+    get events() {
+        return (this._events ?? (this._events = new TrackingEvents(__classPrivateFieldGet(this, _Tracking_http, "f"))));
+    }
+    async track(...args) {
+        return this.events.track(...args);
+    }
+}
+_Tracking_http = new WeakMap();
+//# sourceMappingURL=index.js.map

package/dist/esm/sdk/tracking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sdk/tracking/index.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;;;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,cAAc,GACf,CAAC;AASF,MAAM,OAAO,QAAQ;IAGnB,YAAY,IAAU;QAFb,iCAAY;QAGnB,uBAAA,IAAI,kBAAS,IAAI,MAAA,CAAC;IACpB,CAAC;IAGD,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,OAAO,KAAZ,IAAI,CAAC,OAAO,GAAK,IAAI,cAAc,CAAC,uBAAA,IAAI,sBAAM,CAAC,EAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAG,IAAyC;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;CACF"}

package/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "ominity-api-typescript",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "exports": {
     ".": "./src/index.ts",
     "./models/errors": "./src/models/errors/index.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ominity/api-typescript",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "author": "Ominity",
   "type": "module",
   "tshy": {

package/src/funcs/commerce/cartItemsDelete.ts

@@ -44,7 +44,8 @@ async function $do(
     | RequestTimeoutError
   >
 > {
-  const path = pathToFunc("/commerce/cart-items/{id}")({
+  const path = pathToFunc("/commerce/carts/{cartId}/items/{id}")({
+    cartId: request.cartId,
     id: request.itemId,
   });
 
@@ -118,4 +119,3 @@ async function $do(
 
   return result;
 }
-

package/src/funcs/commerce/cartItemsGet.ts

@@ -46,7 +46,8 @@ async function $do(
     | RequestTimeoutError
   >
 > {
-  const path = pathToFunc("/commerce/cart-items/{id}")({
+  const path = pathToFunc("/commerce/carts/{cartId}/items/{id}")({
+    cartId: request.cartId,
     id: request.itemId,
   });
 
@@ -127,4 +128,3 @@ async function $do(
 
   return result;
 }
-

package/src/funcs/commerce/cartItemsUpdate.ts

@@ -47,7 +47,8 @@ async function $do(
     | RequestTimeoutError
   >
 > {
-  const path = pathToFunc("/commerce/cart-items/{id}")({
+  const path = pathToFunc("/commerce/carts/{cartId}/items/{id}")({
+    cartId: request.cartId,
     id: request.itemId,
   });
 
@@ -124,4 +125,3 @@ async function $do(
 
   return result;
 }
-

package/src/index.ts

@@ -7,3 +7,4 @@ export * from "./core.js";
 export * from "./funcs/index.js";
 export * from "./sdk/modules.js";
 export * from "./sdk/sdk.js";
+export * from "./sdk/tracking/index.js";

package/src/lib/config.ts

@@ -75,7 +75,7 @@ function applyApiVersion(url: URL, apiVersion: string | undefined): URL {
   return url;
 }
 
-export const SDK_VERSION = "1.1.4";
+export const SDK_VERSION = "1.1.6";
 
 export const SDK_METADATA = {
   language: "typescript",

package/src/sdk/index.ts

@@ -1,2 +1,3 @@
 
 export * from "./sdk.js";
+export * from "./tracking/index.js";

package/src/sdk/sdk.ts

@@ -10,6 +10,7 @@ import { OAuth2 } from "./oauth2.js";
 import { Settings } from "./settings/index.js";
 import { Users } from "./users/index.js";
 import { Admins } from "./admins.js";
+import { Tracking } from "./tracking/index.js";
 import type { SDKOptions } from "../lib/config.js";
 import type {
   OminityModuleInput,
@@ -66,6 +67,11 @@ export class Ominity extends ClientSDK {
     return (this._http ??= new Http(this._options));
   }
 
+  private _tracking?: Tracking;
+  get tracking(): Tracking {
+    return (this._tracking ??= new Tracking(this.http));
+  }
+
   private _localization?: Localization;
   get localization(): Localization {
     return (this._localization ??= new Localization(this._options));

package/src/sdk/tracking/events.ts

@@ -0,0 +1,200 @@
+/*
+ * Tracking Events SDK.
+ */
+
+import { RequestOptions } from "../../lib/sdks.js";
+import { Http } from "../http.js";
+
+export type TrackingEventName =
+  | "page_view"
+  | "product_view"
+  | "cart_view"
+  | "add_to_cart"
+  | "remove_from_cart"
+  | "checkout_started"
+  | "purchase"
+  | "button_click"
+  | string;
+
+export type TrackingEventMetadata = Readonly<Record<string, unknown>>;
+export type TrackingEventUtm = Readonly<Record<string, string>>;
+
+export interface TrackEventRequest {
+  readonly event: TrackingEventName;
+  readonly timestamp?: string | Date;
+  readonly title?: string;
+  readonly url?: string;
+  readonly metadata?: TrackingEventMetadata;
+  readonly visitorId?: string;
+  readonly userId?: number;
+  readonly referrer?: string;
+  readonly utm?: TrackingEventUtm;
+}
+
+export interface TrackEventResponse {
+  readonly success: boolean;
+  readonly visitorId: string;
+}
+
+type MutableTrackingPayload = {
+  event: string;
+  timestamp: string;
+  title?: string;
+  url?: string;
+  metadata?: TrackingEventMetadata;
+  visitorId?: string;
+  userId?: number;
+  referrer?: string;
+  utm?: TrackingEventUtm;
+};
+
+function asNonEmptyString(value: unknown): string | undefined {
+  if (typeof value !== "string") {
+    return;
+  }
+
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : undefined;
+}
+
+function asValidDate(value: Date): Date | undefined {
+  if (!Number.isFinite(value.getTime())) {
+    return;
+  }
+
+  return value;
+}
+
+function normalizeTimestamp(value: string | Date | undefined): string {
+  if (value instanceof Date) {
+    const parsed = asValidDate(value);
+    if (parsed) {
+      return parsed.toISOString();
+    }
+  } else if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed.length > 0) {
+      return trimmed;
+    }
+  }
+
+  return new Date().toISOString();
+}
+
+function normalizeUtm(value: unknown): TrackingEventUtm | undefined {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return;
+  }
+
+  const normalized: Record<string, string> = {};
+  for (const [key, raw] of Object.entries(value)) {
+    const trimmed = asNonEmptyString(raw);
+    if (trimmed) {
+      normalized[key] = trimmed;
+    }
+  }
+
+  return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+
+function normalizeMetadata(value: unknown): TrackingEventMetadata | undefined {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return;
+  }
+
+  return value as TrackingEventMetadata;
+}
+
+function normalizeTrackEventPayload(input: TrackEventRequest): MutableTrackingPayload {
+  const eventName = asNonEmptyString(input.event);
+  if (!eventName) {
+    throw new Error("Tracking event name is required.");
+  }
+
+  const payload: MutableTrackingPayload = {
+    event: eventName,
+    timestamp: normalizeTimestamp(input.timestamp),
+  };
+
+  const title = asNonEmptyString(input.title);
+  if (title) {
+    payload.title = title;
+  }
+
+  const url = asNonEmptyString(input.url);
+  if (url) {
+    payload.url = url;
+  }
+
+  const metadata = normalizeMetadata(input.metadata);
+  if (metadata) {
+    payload.metadata = metadata;
+  }
+
+  const visitorId = asNonEmptyString(input.visitorId);
+  if (visitorId) {
+    payload.visitorId = visitorId;
+  }
+
+  if (typeof input.userId === "number" && Number.isFinite(input.userId)) {
+    payload.userId = Math.trunc(input.userId);
+  }
+
+  const referrer = asNonEmptyString(input.referrer);
+  if (referrer) {
+    payload.referrer = referrer;
+  }
+
+  const utm = normalizeUtm(input.utm);
+  if (utm) {
+    payload.utm = utm;
+  }
+
+  return payload;
+}
+
+function asRecord(value: unknown): Record<string, unknown> {
+  if (typeof value === "object" && value !== null) {
+    return value as Record<string, unknown>;
+  }
+
+  return {};
+}
+
+function normalizeTrackEventResponse(payload: unknown): TrackEventResponse {
+  const record = asRecord(payload);
+  const visitorId = asNonEmptyString(record["visitorId"]) ?? "";
+  const success = record["success"] === true;
+
+  return {
+    success,
+    visitorId,
+  };
+}
+
+export class TrackingEvents {
+  readonly #http: Http;
+
+  constructor(http: Http) {
+    this.#http = http;
+  }
+
+  async create(
+    request: TrackEventRequest,
+    options?: RequestOptions,
+  ): Promise<TrackEventResponse> {
+    const response = await this.#http.post("/tracking/events", {
+      ...options,
+      json: normalizeTrackEventPayload(request),
+    });
+
+    return normalizeTrackEventResponse(await response.json());
+  }
+
+  async track(
+    request: TrackEventRequest,
+    options?: RequestOptions,
+  ): Promise<TrackEventResponse> {
+    return this.create(request, options);
+  }
+}

package/src/sdk/tracking/index.ts

@@ -0,0 +1,34 @@
+/*
+ * SDK module: Tracking
+ */
+
+import { Http } from "../http.js";
+import { TrackingEvents } from "./events.js";
+
+export {
+  TrackingEvents,
+};
+export type {
+  TrackEventRequest,
+  TrackEventResponse,
+  TrackingEventMetadata,
+  TrackingEventName,
+  TrackingEventUtm,
+} from "./events.js";
+
+export class Tracking {
+  readonly #http: Http;
+
+  constructor(http: Http) {
+    this.#http = http;
+  }
+
+  private _events?: TrackingEvents;
+  get events(): TrackingEvents {
+    return (this._events ??= new TrackingEvents(this.#http));
+  }
+
+  async track(...args: Parameters<TrackingEvents["track"]>): ReturnType<TrackingEvents["track"]> {
+    return this.events.track(...args);
+  }
+}