@dofek/xert 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Asher Cohen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,135 @@
+# @dofek/xert
+
+TypeScript client for Xert authentication, token refresh, observed activity
+paging, runtime response validation, and conversion to provider-agnostic
+activity records.
+
+Xert publishes an API reference that documents its password and refresh-token
+grants, including the `xert_public` client credentials. The paginated activity
+response consumed here is an observed Xert web API shape rather than the
+activity-list representation in that reference. See the
+[Xert API documentation](https://www.xertonline.com/API.html).
+
+This package is not affiliated with, endorsed by, or supported by Xert or Baron
+Biosystems. Undocumented endpoints and response shapes may change without
+notice.
+
+## Requirements and installation
+
+Requires Node.js 22.14 or newer and its built-in
+[`fetch`](https://nodejs.org/api/globals.html#fetch) implementation.
+
+```sh
+npm install @dofek/xert
+```
+
+## Quick start
+
+```ts
+import { XertClient } from "@dofek/xert";
+import { parseXertActivity } from "@dofek/xert/parsing";
+
+const email = process.env.XERT_EMAIL;
+const password = process.env.XERT_PASSWORD;
+if (!email || !password) {
+  throw new Error("Set XERT_EMAIL and XERT_PASSWORD");
+}
+
+const token = await XertClient.signIn(email, password);
+const client = new XertClient(token.accessToken);
+const activities = await client.listActivities({
+  from: Math.floor(Date.parse("2026-07-01T00:00:00Z") / 1000),
+});
+
+console.log(activities.map(parseXertActivity));
+```
+
+`from` is a Unix timestamp in seconds. `page` defaults to `0`, and `limit`
+defaults to `50`.
+
+## Authentication and token refresh
+
+`XertClient.signIn(email, password, fetch?, credentials?)` uses the resource
+owner password grant documented by Xert. It returns:
+
+- `accessToken`
+- `refreshToken`
+- `expiresAt`
+- `scopes`
+
+The library defaults to the documented `xert_public` client ID and secret. To
+use different credentials, pass them explicitly:
+
+```ts
+const token = await XertClient.signIn(
+  email,
+  password,
+  fetch,
+  { clientId: "client-id", clientSecret: "client-secret" },
+);
+```
+
+The library never reads environment variables. Applications decide how to load
+configuration and must store account passwords, access tokens, and refresh
+tokens as password-equivalent secrets.
+
+Refresh before `expiresAt`:
+
+```ts
+const refreshed = await XertClient.refreshToken(token.refreshToken!);
+```
+
+The standalone `signInToXert` and `refreshXertToken` functions expose the same
+operations. If Xert does not return a replacement refresh token,
+`refreshXertToken` retains the supplied token.
+
+## Public API
+
+- `new XertClient(accessToken, fetch?)`
+- `XertClient.signIn(email, password, fetch?, credentials?)`
+- `XertClient.refreshToken(refreshToken, fetch?, credentials?)`
+- `client.listActivities({ from, page?, limit? })`
+- `signInToXert(...)`
+- `refreshXertToken(...)`
+- `DEFAULT_XERT_CLIENT_CREDENTIALS`
+- `XertAuthenticationError`
+- `XertApiError`
+
+Supported deep imports:
+
+- `@dofek/xert/client` — authentication, refresh, and API client.
+- `@dofek/xert/parsing` — sport mapping and normalized activity parsing.
+- `@dofek/xert/types` — Zod schemas and TypeScript types.
+
+All token and activity responses cross a
+[Zod](https://zod.dev/) runtime-validation boundary. A response-shape change
+therefore throws `ZodError` instead of returning unchecked data.
+
+## Errors and rate limits
+
+Rejected authentication and refresh requests throw
+`XertAuthenticationError`. Other unsuccessful activity requests throw
+`XertApiError`. Both expose `statusCode` and `responseBody`.
+
+The shared HTTP wrapper throws `ProviderRateLimitError` for `429` and
+`ProviderServiceUnavailableError` for `502`, `503`, and `504`, retaining a
+parsed
+[`Retry-After`](https://www.rfc-editor.org/rfc/rfc9110.html#name-retry-after)
+value when supplied.
+
+If your application handles these classes directly, declare
+`@dofek/provider-http` as a direct dependency:
+
+```ts
+import {
+  ProviderRateLimitError,
+  ProviderServiceUnavailableError,
+} from "@dofek/provider-http/rate-limit";
+```
+
+## Project
+
+- [Source](https://github.com/Asherlc/dofek/tree/main/packages/xert-client)
+- [Report an issue](https://github.com/Asherlc/dofek/issues)
+- [Contribute a pull request](https://github.com/Asherlc/dofek/pulls)
+- License: [MIT](./LICENSE)

package/dist/client.d.ts

@@ -0,0 +1,36 @@
+import { type XertActivity, type XertActivityListOptions, type XertClientCredentials, type XertTokenSet } from "./types.ts";
+export declare const XERT_API_BASE_URL = "https://www.xertonline.com";
+export declare const DEFAULT_XERT_CLIENT_CREDENTIALS: Readonly<XertClientCredentials>;
+export declare class XertAuthenticationError extends Error {
+    readonly statusCode: number;
+    readonly responseBody: string;
+    readonly operation: "sign-in" | "token refresh";
+    constructor(operation: "sign-in" | "token refresh", statusCode: number, responseBody: string, options?: ErrorOptions);
+}
+export declare class XertApiError extends Error {
+    readonly statusCode: number;
+    readonly responseBody: string;
+    constructor(statusCode: number, responseBody: string, options?: ErrorOptions);
+}
+/**
+ * Signs in with Xert's documented resource-owner password grant.
+ *
+ * Credentials are explicit so the library never reads process environment.
+ */
+export declare function signInToXert(email: string, password: string, fetchFn?: typeof globalThis.fetch, credentials?: XertClientCredentials): Promise<XertTokenSet>;
+/**
+ * Exchanges a refresh token for a new token set.
+ *
+ * Xert normally rotates refresh tokens. If it omits one, this retains the
+ * supplied refresh token so callers do not accidentally discard it.
+ */
+export declare function refreshXertToken(refreshToken: string, fetchFn?: typeof globalThis.fetch, credentials?: XertClientCredentials): Promise<XertTokenSet>;
+export declare class XertClient {
+    #private;
+    constructor(accessToken: string, fetchFn?: typeof globalThis.fetch);
+    static signIn(email: string, password: string, fetchFn?: typeof globalThis.fetch, credentials?: XertClientCredentials): Promise<XertTokenSet>;
+    static refreshToken(refreshToken: string, fetchFn?: typeof globalThis.fetch, credentials?: XertClientCredentials): Promise<XertTokenSet>;
+    listActivities(options: XertActivityListOptions): Promise<XertActivity[]>;
+}
+export type { XertActivity, XertActivityListOptions, XertClientCredentials, XertTokenSet, } from "./types.ts";
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAE5B,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAE9D,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,qBAAqB,CAG1E,CAAC;AAYH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe,CAAC;gBAG9C,SAAS,EAAE,SAAS,GAAG,eAAe,EACtC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,YAAY;CAQzB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAM7E;AA6CD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB,EACnD,WAAW,GAAE,qBAAuD,GACnE,OAAO,CAAC,YAAY,CAAC,CAWvB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB,EACnD,WAAW,GAAE,qBAAuD,GACnE,OAAO,CAAC,YAAY,CAAC,CAWvB;AAED,qBAAa,UAAU;;gBAIT,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB;IAKpF,MAAM,CAAC,MAAM,CACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB,EACnD,WAAW,GAAE,qBAAuD,GACnE,OAAO,CAAC,YAAY,CAAC;IAIxB,MAAM,CAAC,YAAY,CACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB,EACnD,WAAW,GAAE,qBAAuD,GACnE,OAAO,CAAC,YAAY,CAAC;IAIlB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAwBhF;AAED,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/client.js

@@ -0,0 +1,125 @@
+import { createRateLimitAwareFetch } from "@dofek/provider-http/rate-limit";
+import { z } from "zod";
+import { XertActivityListSchema, } from "./types.js";
+export const XERT_API_BASE_URL = "https://www.xertonline.com";
+export const DEFAULT_XERT_CLIENT_CREDENTIALS = Object.freeze({
+    clientId: "xert_public",
+    clientSecret: "xert_public",
+});
+const DEFAULT_EXPIRES_IN_SECONDS = 365 * 24 * 60 * 60;
+const XertTokenResponseSchema = z.object({
+    access_token: z.string(),
+    refresh_token: z.string().optional(),
+    expires_in: z.number().optional(),
+    token_type: z.string().optional(),
+    scope: z.string().optional(),
+});
+export class XertAuthenticationError extends Error {
+    statusCode;
+    responseBody;
+    operation;
+    constructor(operation, statusCode, responseBody, options) {
+        super(`Xert ${operation} failed (${statusCode}): ${responseBody}`, options);
+        this.name = new.target.name;
+        this.operation = operation;
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+    }
+}
+export class XertApiError extends Error {
+    statusCode;
+    responseBody;
+    constructor(statusCode, responseBody, options) {
+        super(`Xert API error (${statusCode}): ${responseBody}`, options);
+        this.name = new.target.name;
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+    }
+}
+function authorizationHeader(credentials) {
+    return `Basic ${btoa(`${credentials.clientId}:${credentials.clientSecret}`)}`;
+}
+function parseTokenResponse(data, fallbackRefreshToken = null) {
+    const parsed = XertTokenResponseSchema.parse(data);
+    return {
+        accessToken: parsed.access_token,
+        refreshToken: parsed.refresh_token ?? fallbackRefreshToken,
+        expiresAt: new Date(Date.now() + (parsed.expires_in ?? DEFAULT_EXPIRES_IN_SECONDS) * 1000),
+        scopes: parsed.scope ?? null,
+    };
+}
+async function requestToken(operation, body, fetchFn, credentials, fallbackRefreshToken = null) {
+    const rateLimitFetchFn = createRateLimitAwareFetch(fetchFn, { providerId: "xert" });
+    const response = await rateLimitFetchFn(`${XERT_API_BASE_URL}/oauth/token`, {
+        method: "POST",
+        headers: {
+            Authorization: authorizationHeader(credentials),
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        body: body.toString(),
+    });
+    if (!response.ok) {
+        const responseBody = await response.text();
+        throw new XertAuthenticationError(operation, response.status, responseBody);
+    }
+    const data = await response.json();
+    return parseTokenResponse(data, fallbackRefreshToken);
+}
+/**
+ * Signs in with Xert's documented resource-owner password grant.
+ *
+ * Credentials are explicit so the library never reads process environment.
+ */
+export function signInToXert(email, password, fetchFn = globalThis.fetch, credentials = DEFAULT_XERT_CLIENT_CREDENTIALS) {
+    return requestToken("sign-in", new URLSearchParams({
+        grant_type: "password",
+        username: email,
+        password,
+    }), fetchFn, credentials);
+}
+/**
+ * Exchanges a refresh token for a new token set.
+ *
+ * Xert normally rotates refresh tokens. If it omits one, this retains the
+ * supplied refresh token so callers do not accidentally discard it.
+ */
+export function refreshXertToken(refreshToken, fetchFn = globalThis.fetch, credentials = DEFAULT_XERT_CLIENT_CREDENTIALS) {
+    return requestToken("token refresh", new URLSearchParams({
+        grant_type: "refresh_token",
+        refresh_token: refreshToken,
+    }), fetchFn, credentials, refreshToken);
+}
+export class XertClient {
+    #accessToken;
+    #fetchFn;
+    constructor(accessToken, fetchFn = globalThis.fetch) {
+        this.#accessToken = accessToken;
+        this.#fetchFn = createRateLimitAwareFetch(fetchFn, { providerId: "xert" });
+    }
+    static signIn(email, password, fetchFn = globalThis.fetch, credentials = DEFAULT_XERT_CLIENT_CREDENTIALS) {
+        return signInToXert(email, password, fetchFn, credentials);
+    }
+    static refreshToken(refreshToken, fetchFn = globalThis.fetch, credentials = DEFAULT_XERT_CLIENT_CREDENTIALS) {
+        return refreshXertToken(refreshToken, fetchFn, credentials);
+    }
+    async listActivities(options) {
+        const query = new URLSearchParams({
+            from: String(options.from),
+            page: String(options.page ?? 0),
+            limit: String(options.limit ?? 50),
+        });
+        const response = await this.#fetchFn(`${XERT_API_BASE_URL}/oauth/activity/?${query.toString()}`, {
+            headers: {
+                Authorization: `Bearer ${this.#accessToken}`,
+                Accept: "application/json",
+            },
+        });
+        if (!response.ok) {
+            const responseBody = await response.text();
+            throw new XertApiError(response.status, responseBody);
+        }
+        const data = await response.json();
+        return XertActivityListSchema.parse(data);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/parsing.d.ts

@@ -0,0 +1,14 @@
+import type { CanonicalActivityType } from "@dofek/training/training";
+import type { XertActivity } from "./types.ts";
+export interface ParsedXertActivity {
+    externalId: string;
+    activityType: CanonicalActivityType;
+    name: string;
+    startedAt: Date;
+    endedAt: Date;
+    raw: Record<string, unknown>;
+}
+export declare const XERT_SPORT_MAP: Readonly<Record<string, CanonicalActivityType>>;
+export declare function mapXertSport(sport: string): CanonicalActivityType;
+export declare function parseXertActivity(activity: XertActivity): ParsedXertActivity;
+//# sourceMappingURL=parsing.d.ts.map

package/dist/parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.ts","sourceRoot":"","sources":["../src/parsing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,qBAAqB,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAY1E,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,kBAAkB,CAyB5E"}

package/dist/parsing.js

@@ -0,0 +1,43 @@
+export const XERT_SPORT_MAP = {
+    Cycling: "cycling",
+    Running: "running",
+    Swimming: "swimming",
+    Walking: "walking",
+    Hiking: "hiking",
+    Rowing: "rowing",
+    Skiing: "skiing",
+    "Virtual Cycling": "virtual_cycling",
+    "Mountain Biking": "mountain_biking",
+    "Trail Running": "trail_running",
+    "Cross Country Skiing": "cross_country_skiing",
+};
+export function mapXertSport(sport) {
+    return XERT_SPORT_MAP[sport] ?? "other";
+}
+export function parseXertActivity(activity) {
+    return {
+        externalId: String(activity.id),
+        activityType: mapXertSport(activity.sport),
+        name: activity.name,
+        startedAt: new Date(activity.startTimestamp * 1000),
+        endedAt: new Date(activity.endTimestamp * 1000),
+        raw: {
+            sport: activity.sport,
+            duration: activity.duration,
+            distance: activity.distance,
+            powerAvg: activity.power_avg,
+            powerMax: activity.power_max,
+            powerNormalized: activity.power_normalized,
+            heartrateAvg: activity.heartrate_avg,
+            heartrateMax: activity.heartrate_max,
+            cadenceAvg: activity.cadence_avg,
+            cadenceMax: activity.cadence_max,
+            elevationGain: activity.elevation_gain,
+            elevationLoss: activity.elevation_loss,
+            xss: activity.xss,
+            focus: activity.focus,
+            difficulty: activity.difficulty,
+        },
+    };
+}
+//# sourceMappingURL=parsing.js.map

package/dist/parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../src/parsing.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,cAAc,GAAoD;IAC7E,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,iBAAiB,EAAE,iBAAiB;IACpC,iBAAiB,EAAE,iBAAiB;IACpC,eAAe,EAAE,eAAe;IAChC,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,YAAY,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1C,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,SAAS,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC;QACnD,OAAO,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC;QAC/C,GAAG,EAAE;YACH,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,SAAS;YAC5B,QAAQ,EAAE,QAAQ,CAAC,SAAS;YAC5B,eAAe,EAAE,QAAQ,CAAC,gBAAgB;YAC1C,YAAY,EAAE,QAAQ,CAAC,aAAa;YACpC,YAAY,EAAE,QAAQ,CAAC,aAAa;YACpC,UAAU,EAAE,QAAQ,CAAC,WAAW;YAChC,UAAU,EAAE,QAAQ,CAAC,WAAW;YAChC,aAAa,EAAE,QAAQ,CAAC,cAAc;YACtC,aAAa,EAAE,QAAQ,CAAC,cAAc;YACtC,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+export declare const XertActivitySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    sport: z.ZodString;
+    startTimestamp: z.ZodNumber;
+    endTimestamp: z.ZodNumber;
+    duration: z.ZodNumber;
+    distance: z.ZodNumber;
+    power_avg: z.ZodNumber;
+    power_max: z.ZodNumber;
+    power_normalized: z.ZodNumber;
+    heartrate_avg: z.ZodNumber;
+    heartrate_max: z.ZodNumber;
+    cadence_avg: z.ZodNumber;
+    cadence_max: z.ZodNumber;
+    elevation_gain: z.ZodNumber;
+    elevation_loss: z.ZodNumber;
+    xss: z.ZodNumber;
+    focus: z.ZodNumber;
+    difficulty: z.ZodNumber;
+}, z.core.$strip>;
+export declare const XertActivityListSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    sport: z.ZodString;
+    startTimestamp: z.ZodNumber;
+    endTimestamp: z.ZodNumber;
+    duration: z.ZodNumber;
+    distance: z.ZodNumber;
+    power_avg: z.ZodNumber;
+    power_max: z.ZodNumber;
+    power_normalized: z.ZodNumber;
+    heartrate_avg: z.ZodNumber;
+    heartrate_max: z.ZodNumber;
+    cadence_avg: z.ZodNumber;
+    cadence_max: z.ZodNumber;
+    elevation_gain: z.ZodNumber;
+    elevation_loss: z.ZodNumber;
+    xss: z.ZodNumber;
+    focus: z.ZodNumber;
+    difficulty: z.ZodNumber;
+}, z.core.$strip>>;
+export type XertActivity = z.infer<typeof XertActivitySchema>;
+export interface XertClientCredentials {
+    clientId: string;
+    clientSecret: string;
+}
+export interface XertTokenSet {
+    accessToken: string;
+    refreshToken: string | null;
+    expiresAt: Date;
+    scopes: string | null;
+}
+export interface XertActivityListOptions {
+    /** Earliest activity start time, expressed as Unix seconds. */
+    from: number;
+    /** Zero-based page number. */
+    page?: number;
+    /** Number of activities requested per page. */
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;iBAoB7B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;kBAA8B,CAAC;AAElE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export const XertActivitySchema = z.object({
+    id: z.number(),
+    name: z.string(),
+    sport: z.string(),
+    startTimestamp: z.number(),
+    endTimestamp: z.number(),
+    duration: z.number(),
+    distance: z.number(),
+    power_avg: z.number(),
+    power_max: z.number(),
+    power_normalized: z.number(),
+    heartrate_avg: z.number(),
+    heartrate_max: z.number(),
+    cadence_avg: z.number(),
+    cadence_max: z.number(),
+    elevation_gain: z.number(),
+    elevation_loss: z.number(),
+    xss: z.number(),
+    focus: z.number(),
+    difficulty: z.number(),
+});
+export const XertActivityListSchema = z.array(XertActivitySchema);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@dofek/xert",
+  "version": "0.1.0",
+  "description": "Unofficial Xert API client with password authentication, token refresh, and activity parsing",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Asherlc/dofek.git",
+    "directory": "packages/xert-client"
+  },
+  "homepage": "https://github.com/Asherlc/dofek/tree/main/packages/xert-client#readme",
+  "bugs": "https://github.com/Asherlc/dofek/issues",
+  "keywords": [
+    "xert",
+    "cycling",
+    "api-client",
+    "oauth",
+    "unofficial",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest --watch",
+    "build": "tsc",
+    "prepack": "pnpm run build",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@dofek/provider-http": "0.1.0",
+    "@dofek/training": "0.1.0",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "typescript": "6.0.3",
+    "vitest": "3.2.6"
+  },
+  "gitHead": "ac95258c753c7e75b57da7ae47426d22b78e8c01"
+}