@oxy.so/core 1.18.1 → 3.0.0

package/dist/types/mixins/OxyServices.linkedAccounts.d.ts

@@ -1,107 +0,0 @@
-/**
- * Linked Accounts Methods Mixin
- *
- * External accounts (any Mastodon-API server, Bluesky) the current user has
- * PROVEN they own by completing an OAuth authorization there. Oxy uses that
- * authorization only to learn which account granted it and then discards the
- * token — nothing here ever carries a third-party token.
- *
- * The flow is a top-level browser navigation: {@link startLinkedAccount} returns
- * the other network's `authorizeUrl`; open it (a new tab, or
- * `expo-web-browser`'s auth session on native); the network sends the browser
- * to Oxy's callback, and Oxy sends it to `returnTo` with `?link_code=<code>` or
- * `?link_error=<code>`. Pass the code to {@link completeLinkedAccount} with the
- * same user signed in: that call, not the callback, creates the link, so an
- * authorization someone else started can never link to them. `returnTo` must
- * be a redirect URI registered on the first-party application `clientId` names.
- *
- * Wire types live in `@oxy.so/contracts` (`linkedAccounts.ts`).
- */
-import type { LinkedAccount, LinkedAccountNetwork, ServiceLinkedAccountListResponse, StartLinkedAccountRequest, StartLinkedAccountResponse } from '@oxy.so/contracts';
-import type { OxyServicesBase } from '../OxyServices.base';
-export declare function OxyServicesLinkedAccountsMixin<T extends typeof OxyServicesBase>(Base: T): {
-    new (...args: any[]): {
-        /** Inherited from the auth mixin at runtime. */
-        makeServiceRequest: <R = unknown>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: unknown, userId?: string) => Promise<R>;
-        /**
-         * Begin linking an external account for the current user.
-         *
-         * @param network - `'activitypub'` (any Mastodon-API server) or `'atproto'` (Bluesky).
-         * @param options - `instance` for ActivityPub (`mastodon.social`, or
-         *   `@user@mastodon.social`), `handle` for atproto; `clientId` + `returnTo`
-         *   to be sent back to your app afterwards.
-         * @returns The URL to open, and when the attempt expires (ten minutes).
-         */
-        startLinkedAccount(network: LinkedAccountNetwork, options: StartLinkedAccountRequest): Promise<StartLinkedAccountResponse>;
-        /**
-         * Finish a link with the `link_code` the callback appended to `returnTo`.
-         * Must be the user who started the flow: for anyone else the API answers
-         * 403 and burns the code. 409 when the account is already someone else's
-         * link. Repeating it within the code's five minutes returns the same link.
-         */
-        completeLinkedAccount(code: string): Promise<LinkedAccount>;
-        /** The current user's live linked accounts, oldest first. */
-        listLinkedAccounts(): Promise<LinkedAccount[]>;
-        /**
-         * Unlink one of the current user's accounts. An ActivityPub link stops being
-         * published as an `alsoKnownAs` alias, and the external account can then be
-         * linked to another Oxy account.
-         */
-        revokeLinkedAccount(linkedAccountId: string): Promise<void>;
-        /**
-         * SERVICE: a user's live linked accounts, each with the federated shadow
-         * user Oxy already holds for it (`federatedUserId`). Requires a service
-         * credential whose application holds the privileged `linked-accounts:read`.
-         */
-        getLinkedAccountsForUser(userId: string): Promise<ServiceLinkedAccountListResponse>;
-        httpService: import("../HttpService").HttpService;
-        cloudURL: string;
-        config: import("../OxyServices.base").OxyConfig;
-        __resetTokensForTests(): void;
-        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
-        getBaseURL(): string;
-        getClient(): import("../HttpService").HttpService;
-        createLinkedClient(config: import("../OxyServices.base").OxyConfig): import("..").LinkedHttpClient;
-        getMetrics(): {
-            totalRequests: number;
-            successfulRequests: number;
-            failedRequests: number;
-            cacheHits: number;
-            cacheMisses: number;
-            averageResponseTime: number;
-        };
-        clearCache(): void;
-        clearCacheEntry(key: string): void;
-        clearCacheByPrefix(prefix: string): number;
-        getCacheStats(): {
-            size: number;
-            hits: number;
-            misses: number;
-            hitRate: number;
-        };
-        getCloudURL(): string;
-        setTokens(accessToken: string): void;
-        clearTokens(): void;
-        onTokensChanged(listener: (accessToken: string | null) => void): () => void;
-        _cachedUserId: string | null | undefined;
-        _cachedAccessToken: string | null;
-        getCurrentUserId(): string | null;
-        hasValidToken(): boolean;
-        getAccessToken(): string | null;
-        getAccessTokenExpiry(): number | null;
-        waitForAuth(timeoutMs?: number): Promise<boolean>;
-        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
-            maxRetries?: number;
-            retryDelay?: number;
-            authTimeoutMs?: number;
-        }): Promise<T_1>;
-        validate(): Promise<boolean>;
-        handleError(error: unknown): Error;
-        healthCheck(): Promise<{
-            status: string;
-            users?: number;
-            timestamp?: string;
-            [key: string]: any;
-        }>;
-    };
-} & T;

package/dist/types/mixins/OxyServices.location.d.ts

@@ -1,70 +0,0 @@
-/**
- * Location Methods Mixin
- */
-import type { OxyServicesBase } from '../OxyServices.base';
-export declare function OxyServicesLocationMixin<T extends typeof OxyServicesBase>(Base: T): {
-    new (...args: any[]): {
-        /**
-         * Update user location
-         * @param latitude - Latitude coordinate
-         * @param longitude - Longitude coordinate
-         * @returns Location update result
-         */
-        updateLocation(latitude: number, longitude: number): Promise<any>;
-        /**
-         * Get nearby users
-         * @param radius - Optional search radius in meters
-         * @returns Array of nearby users
-         */
-        getNearbyUsers(radius?: number): Promise<any[]>;
-        httpService: import("../HttpService").HttpService;
-        cloudURL: string;
-        config: import("../OxyServices.base").OxyConfig;
-        __resetTokensForTests(): void;
-        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
-        getBaseURL(): string;
-        getClient(): import("../HttpService").HttpService;
-        createLinkedClient(config: import("../OxyServices.base").OxyConfig): import("..").LinkedHttpClient;
-        getMetrics(): {
-            totalRequests: number;
-            successfulRequests: number;
-            failedRequests: number;
-            cacheHits: number;
-            cacheMisses: number;
-            averageResponseTime: number;
-        };
-        clearCache(): void;
-        clearCacheEntry(key: string): void;
-        clearCacheByPrefix(prefix: string): number;
-        getCacheStats(): {
-            size: number;
-            hits: number;
-            misses: number;
-            hitRate: number;
-        };
-        getCloudURL(): string;
-        setTokens(accessToken: string): void;
-        clearTokens(): void;
-        onTokensChanged(listener: (accessToken: string | null) => void): () => void;
-        _cachedUserId: string | null | undefined;
-        _cachedAccessToken: string | null;
-        getCurrentUserId(): string | null;
-        hasValidToken(): boolean;
-        getAccessToken(): string | null;
-        getAccessTokenExpiry(): number | null;
-        waitForAuth(timeoutMs?: number): Promise<boolean>;
-        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
-            maxRetries?: number;
-            retryDelay?: number;
-            authTimeoutMs?: number;
-        }): Promise<T_1>;
-        validate(): Promise<boolean>;
-        handleError(error: unknown): Error;
-        healthCheck(): Promise<{
-            status: string;
-            users?: number;
-            timestamp?: string;
-            [key: string]: any;
-        }>;
-    };
-} & T;

package/dist/types/mixins/OxyServices.nodes.d.ts

@@ -1,198 +0,0 @@
-import type { OxyServicesBase } from '../OxyServices.base';
-/** How Oxy and the node move records: the node pulls (default), or Oxy pushes. */
-export type UserNodeMode = 'pull' | 'push';
-/**
- * Who operates the node:
- *  - `self` — the user self-hosts the node (registered by their own signed
- *    `type:'node'` record).
- *  - `oxy`  — Oxy operates a MANAGED vault on the user's behalf (custodial-signed
- *    `type:'node'` record; the `controller:[OXY_DID]` model).
- */
-export type UserNodeController = 'self' | 'oxy';
-/**
- * Liveness badge of a node, maintained ONLY by Oxy's background probes:
- *  - `active`      — the last probe reached the node's liveness manifest.
- *  - `unreachable` — the last probe failed (DNS/connect/timeout/non-2xx); the
- *    cached row is still served, only the badge changes.
- *  - `revoked`     — the user removed the registration; excluded from the DID
- *    document and from liveness sweeps.
- */
-export type UserNodeLivenessStatus = 'active' | 'unreachable' | 'revoked';
-/**
- * The caller's registered node, as projected by the server's `serializeNode`
- * (`GET /nodes/me`, `POST /nodes/managed`). A denormalised, fast-to-read copy of
- * the authoritative signed `type:'node'` record plus the live liveness state Oxy
- * maintains in the background.
- *
- * `mode` / `managed` / `controller` / `status` are always present (server fields
- * with defaults); the probe/sync fields and `nodeDid` are present only once set.
- * The `Date` fields cross the wire as ISO-8601 strings.
- */
-export interface UserNodeStatus {
-    /** Optional DID the node advertises for itself (informational). */
-    nodeDid?: string;
-    /** The node's public HTTPS base URL (where its liveness manifest lives). */
-    endpoint: string;
-    /** The node's secp256k1 public key (hex) — records it signs verify against this. */
-    nodePublicKey: string;
-    /** Transport direction. `pull` (the node paces its own sync) by default. */
-    mode: UserNodeMode;
-    /** Whether Oxy operates this node on the user's behalf (managed vault). */
-    managed: boolean;
-    /** Operator of the node — `self` (user self-hosts) or `oxy` (managed vault). */
-    controller: UserNodeController;
-    /** Liveness badge — maintained only by background probes, never a read handler. */
-    status: UserNodeLivenessStatus;
-    /** Last time a probe reached the node successfully (ISO-8601). */
-    lastSeenAt?: string;
-    /** Last time a probe ran, success or failure (ISO-8601). */
-    lastProbeAt?: string;
-    /** Human-readable reason the last probe OR ingest failed (cleared on success). */
-    lastError?: string;
-    /** Last synced chain `seq` for two-way sync (advanced only by the ingest worker). */
-    cursor?: number;
-    /** Last time the ingest worker ran a pull for this node (ISO-8601). */
-    lastSyncedAt?: string;
-    /** When the node was first registered (ISO-8601). */
-    createdAt: string;
-    /** When the node row was last updated (ISO-8601). */
-    updatedAt: string;
-}
-/**
- * Input for {@link OxyServicesNodesMixin.registerNode} — the operational facts of
- * the user's self-hosted node that go into the signed `type:'node'` record.
- */
-export interface RegisterNodeInput {
-    /** The node's public HTTPS base URL (where its liveness manifest is served). */
-    endpoint: string;
-    /** The node's secp256k1 public key (hex) — records the node signs verify against this. */
-    nodePublicKey: string;
-    /** Transport direction; defaults to `'pull'` when omitted. */
-    mode?: UserNodeMode;
-}
-/** Result of {@link OxyServicesNodesMixin.removeMyNode} (`DELETE /nodes/me`). */
-export interface RemoveNodeResult {
-    /** `true` when an active registration was flipped to `revoked`. */
-    revoked: boolean;
-}
-export declare function OxyServicesNodesMixin<T extends typeof OxyServicesBase>(Base: T): {
-    new (...args: any[]): {
-        /**
-         * Register (or re-register) the caller's SELF-HOSTED personal data node.
-         *
-         * Builds the `{ endpoint, nodePublicKey, mode }` node record, signs a v2
-         * envelope on the caller's own per-subject hash chain (fetching the current
-         * chain head first so `seq`/`prev` are never stale), and publishes it through
-         * the EXISTING `POST /identity/records` path — which verifies the signature
-         * and materializes the operational node cache as a side effect. The signed
-         * record (not this call) is the authority; re-registering over-writes the
-         * single `self` record (last-writer-wins).
-         *
-         * NATIVE-ONLY: signs with the on-device identity key (throws on web / when no
-         * identity or no authenticated user — the guard fires before any network).
-         * `mode` defaults to `'pull'`. After a successful publish the node + `/users/me`
-         * GET caches are swept, then the freshly-materialized status is returned.
-         *
-         * Throws if the chain record stored but the server skipped materialization
-         * (e.g. a malformed endpoint the server rejected) — an unexpected state rather
-         * than a silent `null`.
-         *
-         * @param input - The node's endpoint, public key, and optional transport mode.
-         */
-        registerNode(input: RegisterNodeInput): Promise<UserNodeStatus>;
-        /**
-         * Read the caller's registered node status (`GET /nodes/me`), or `null` when
-         * the caller has no node. Auth required; short-TTL cached (the liveness badge
-         * is background-maintained) and swept after the caller's own
-         * register / revoke / managed-provision.
-         */
-        getMyNode(): Promise<UserNodeStatus | null>;
-        /**
-         * Revoke the caller's node registration (`DELETE /nodes/me`). The node flips
-         * to `revoked` server-side (leaving the DID document and liveness sweeps).
-         * Auth required; the node + `/users/me` GET caches are swept on success.
-         *
-         * Maps the server's `{ success }` to the SDK's `{ revoked }` semantic.
-         */
-        removeMyNode(): Promise<RemoveNodeResult>;
-        /**
-         * Provision (or refresh) an Oxy-operated MANAGED vault for the caller
-         * (`POST /nodes/managed`) — the "Create your vault" convenience for
-         * non-technical users. Oxy custodial-signs the node registration onto the
-         * caller's chain and returns the materialized node (`managed:true,
-         * controller:'oxy'`). Idempotent server-side. Auth required; the owner id is
-         * resolved from the session, never the body. The node + `/users/me` GET caches
-         * are swept on success.
-         */
-        provisionManagedVault(): Promise<UserNodeStatus>;
-        /**
-         * Send an ingest HINT that a user's node has new records
-         * (`POST /nodes/ingest/notify/:userId`). Unauthenticated by design and
-         * fire-and-forget on the server (it only schedules a background re-pull of the
-         * named user's OWN node, then fully re-verifies — a notify can never inject
-         * data), so this resolves once the 202 hint is accepted and returns nothing.
-         *
-         * @param userId - The user whose node may have new records. URL-encoded.
-         */
-        notifyNodeIngest(userId: string): Promise<void>;
-        /**
-         * Sweep the GET caches a node mutation invalidates: every node read
-         * (`GET:/nodes/`) so a re-read reflects the new node / its absence, and
-         * `/users/me` because the user's derived DID document embeds an `#oxy-node`
-         * service entry that changes on register / revoke / manage. Public rather
-         * than `private` because mixins compose into an exported anonymous class
-         * where TypeScript cannot represent a private member in the emitted
-         * declaration file (TS4094) — mirrors the civic / identity cache sweepers.
-         */
-        _sweepNodeCaches(): void;
-        httpService: import("../HttpService").HttpService;
-        cloudURL: string;
-        config: import("../OxyServices.base").OxyConfig;
-        __resetTokensForTests(): void;
-        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
-        getBaseURL(): string;
-        getClient(): import("../HttpService").HttpService;
-        createLinkedClient(config: import("../OxyServices.base").OxyConfig): import("..").LinkedHttpClient;
-        getMetrics(): {
-            totalRequests: number;
-            successfulRequests: number;
-            failedRequests: number;
-            cacheHits: number;
-            cacheMisses: number;
-            averageResponseTime: number;
-        };
-        clearCache(): void;
-        clearCacheEntry(key: string): void;
-        clearCacheByPrefix(prefix: string): number;
-        getCacheStats(): {
-            size: number;
-            hits: number;
-            misses: number;
-            hitRate: number;
-        };
-        getCloudURL(): string;
-        setTokens(accessToken: string): void;
-        clearTokens(): void;
-        onTokensChanged(listener: (accessToken: string | null) => void): () => void;
-        _cachedUserId: string | null | undefined;
-        _cachedAccessToken: string | null;
-        getCurrentUserId(): string | null;
-        hasValidToken(): boolean;
-        getAccessToken(): string | null;
-        getAccessTokenExpiry(): number | null;
-        waitForAuth(timeoutMs?: number): Promise<boolean>;
-        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
-            maxRetries?: number;
-            retryDelay?: number;
-            authTimeoutMs?: number;
-        }): Promise<T_1>;
-        validate(): Promise<boolean>;
-        handleError(error: unknown): Error;
-        healthCheck(): Promise<{
-            status: string;
-            users?: number;
-            timestamp?: string;
-            [key: string]: any;
-        }>;
-    };
-} & T;

package/dist/types/mixins/OxyServices.notifications.d.ts

@@ -1,143 +0,0 @@
-/**
- * Push Notification Registration Mixin
- *
- * Registers this installation's push token with Oxy so the platform can reach
- * the signed-in identity — most importantly to deliver a "Sign in with Oxy"
- * approval request to a known Commons installation (issue #691, Phase 4)
- * instead of forcing the user onto a QR.
- *
- * This lives in `@oxy.so/core` because push registration is cross-cutting: every
- * Oxy app that wants to receive platform notifications performs the exact same
- * bearer-authenticated register/unregister pair. App-local copies drift (see the
- * token-kind hazard below), so there is ONE implementation here.
- *
- * ## The token is an EXPO PUSH TOKEN
- *
- * `registerPushToken` takes the token returned by
- * `Notifications.getExpoPushTokenAsync()` — the `ExponentPushToken[…]` handle —
- * because the server delivers through Expo's push service, which only accepts
- * that form.
- *
- * It does NOT take `getDevicePushTokenAsync()`'s raw APNs/FCM device token.
- * Registering one of those looks completely successful (the row is stored, the
- * endpoint returns 200) and then every push silently fails at delivery time,
- * which is exactly the failure mode this surface is written to make impossible:
- * the token is validated here, at the call site, so a raw device token is
- * rejected immediately with an explicit error rather than becoming a dead
- * registration nobody notices.
- *
- * Acquiring the token (permission prompt, `expo-notifications`) is the app's
- * job — `@oxy.so/core` never imports an `expo-*` module.
- */
-import type { OxyServicesBase } from '../OxyServices.base';
-/**
- * Platform the push token was minted on. Mirrors the enum the server accepts;
- * a value outside it is rejected server-side.
- */
-export type PushTokenPlatform = 'ios' | 'android' | 'web';
-/** Registration input for {@link OxyServicesNotificationsMixin.registerPushToken}. */
-export interface RegisterPushTokenInput {
-    /**
-     * The **Expo push token** for this installation — `ExponentPushToken[…]`,
-     * from `Notifications.getExpoPushTokenAsync()`.
-     *
-     * NOT the raw APNs/FCM token from `getDevicePushTokenAsync()`; that form is
-     * rejected before any request is sent.
-     */
-    expoPushToken: string;
-    /** Platform this token was minted on. */
-    platform: PushTokenPlatform;
-    /**
-     * Optional device-first `deviceId` this installation is registered under, so
-     * the server can retire the token when that device session goes away instead
-     * of pushing to an installation that has signed out.
-     */
-    deviceId?: string;
-    /**
-     * Optional registered OAuth client id (the caller's credential `publicKey`,
-     * `oxy_dk_…`) identifying WHICH application this installation is. The server
-     * resolves it to the registering `Application` and rejects an unusable one.
-     *
-     * This is what makes "deliver the approval request to a known Commons
-     * installation" possible: delivery targets the Commons application's
-     * registrations, never every push token the identity owns.
-     */
-    clientId?: string;
-}
-export declare function OxyServicesNotificationsMixin<T extends typeof OxyServicesBase>(Base: T): {
-    new (...args: any[]): {
-        /**
-         * Register this installation's **Expo** push token for the authenticated
-         * identity (`POST /notifications/push-token`, bearer required).
-         *
-         * Idempotent server-side: re-registering the same token for the same
-         * identity refreshes the existing row rather than creating a duplicate, so
-         * callers can safely re-register on every cold boot.
-         *
-         * @throws When `expoPushToken` is not an Expo push token — a raw APNs/FCM
-         *   device token fails here rather than becoming a silently undeliverable
-         *   registration.
-         */
-        registerPushToken(input: RegisterPushTokenInput): Promise<void>;
-        /**
-         * Retire an **Expo** push token for the authenticated identity
-         * (`DELETE /notifications/push-token`, bearer required).
-         *
-         * Call it when the user turns notifications off, when the vault identity is
-         * replaced, and on sign-out — otherwise the installation keeps receiving
-         * approval requests for an identity it no longer holds.
-         *
-         * @param expoPushToken - The exact token previously registered.
-         */
-        unregisterPushToken(expoPushToken: string): Promise<void>;
-        httpService: import("../HttpService").HttpService;
-        cloudURL: string;
-        config: import("../OxyServices.base").OxyConfig;
-        __resetTokensForTests(): void;
-        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
-        getBaseURL(): string;
-        getClient(): import("../HttpService").HttpService;
-        createLinkedClient(config: import("../OxyServices.base").OxyConfig): import("..").LinkedHttpClient;
-        getMetrics(): {
-            totalRequests: number;
-            successfulRequests: number;
-            failedRequests: number;
-            cacheHits: number;
-            cacheMisses: number;
-            averageResponseTime: number;
-        };
-        clearCache(): void;
-        clearCacheEntry(key: string): void;
-        clearCacheByPrefix(prefix: string): number;
-        getCacheStats(): {
-            size: number;
-            hits: number;
-            misses: number;
-            hitRate: number;
-        };
-        getCloudURL(): string;
-        setTokens(accessToken: string): void;
-        clearTokens(): void;
-        onTokensChanged(listener: (accessToken: string | null) => void): () => void;
-        _cachedUserId: string | null | undefined;
-        _cachedAccessToken: string | null;
-        getCurrentUserId(): string | null;
-        hasValidToken(): boolean;
-        getAccessToken(): string | null;
-        getAccessTokenExpiry(): number | null;
-        waitForAuth(timeoutMs?: number): Promise<boolean>;
-        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
-            maxRetries?: number;
-            retryDelay?: number;
-            authTimeoutMs?: number;
-        }): Promise<T_1>;
-        validate(): Promise<boolean>;
-        handleError(error: unknown): Error;
-        healthCheck(): Promise<{
-            status: string;
-            users?: number;
-            timestamp?: string;
-            [key: string]: any;
-        }>;
-    };
-} & T;

package/dist/types/mixins/OxyServices.payment.d.ts

@@ -1,117 +0,0 @@
-/**
- * Payment Methods Mixin
- *
- * Provides methods for payment processing and management
- */
-import type { OxyServicesBase } from '../OxyServices.base';
-export declare function OxyServicesPaymentMixin<T extends typeof OxyServicesBase>(Base: T): {
-    new (...args: any[]): {
-        /**
-         * Create a payment
-         * @param data - Payment data
-         * @returns Created payment object
-         */
-        createPayment(data: any): Promise<any>;
-        /**
-         * Get payment by ID
-         * @param paymentId - The payment ID
-         * @returns Payment object
-         */
-        getPayment(paymentId: string): Promise<any>;
-        /**
-         * Get user payments
-         * @returns Array of user payments
-         */
-        getUserPayments(): Promise<any[]>;
-        /**
-         * Get user subscription
-         * @param userId - The user ID
-         * @returns Subscription object
-         */
-        getSubscription(userId: string): Promise<any>;
-        /**
-         * Get current user's subscription
-         * @returns Subscription object
-         */
-        getCurrentUserSubscription(): Promise<any>;
-        /**
-         * Get user wallet
-         * @param userId - The user ID
-         * @returns Wallet object with balance
-         */
-        getWallet(userId: string): Promise<any>;
-        /**
-         * Get current user's wallet
-         * @returns Wallet object with balance
-         */
-        getCurrentUserWallet(): Promise<any>;
-        /**
-         * Get wallet transaction history
-         * @param userId - The user ID
-         * @param options - Pagination options
-         * @returns Transaction history
-         */
-        getWalletTransactions(userId: string, options?: {
-            limit?: number;
-            offset?: number;
-        }): Promise<any>;
-        /**
-         * Get current user's wallet transaction history
-         * @param options - Pagination options
-         * @returns Transaction history
-         */
-        getCurrentUserWalletTransactions(options?: {
-            limit?: number;
-            offset?: number;
-        }): Promise<any>;
-        httpService: import("../HttpService").HttpService;
-        cloudURL: string;
-        config: import("../OxyServices.base").OxyConfig;
-        __resetTokensForTests(): void;
-        makeRequest<T_1>(method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", url: string, data?: any, options?: import("../HttpService").RequestOptions): Promise<T_1>;
-        getBaseURL(): string;
-        getClient(): import("../HttpService").HttpService;
-        createLinkedClient(config: import("../OxyServices.base").OxyConfig): import("..").LinkedHttpClient;
-        getMetrics(): {
-            totalRequests: number;
-            successfulRequests: number;
-            failedRequests: number;
-            cacheHits: number;
-            cacheMisses: number;
-            averageResponseTime: number;
-        };
-        clearCache(): void;
-        clearCacheEntry(key: string): void;
-        clearCacheByPrefix(prefix: string): number;
-        getCacheStats(): {
-            size: number;
-            hits: number;
-            misses: number;
-            hitRate: number;
-        };
-        getCloudURL(): string;
-        setTokens(accessToken: string): void;
-        clearTokens(): void;
-        onTokensChanged(listener: (accessToken: string | null) => void): () => void;
-        _cachedUserId: string | null | undefined;
-        _cachedAccessToken: string | null;
-        getCurrentUserId(): string | null;
-        hasValidToken(): boolean;
-        getAccessToken(): string | null;
-        getAccessTokenExpiry(): number | null;
-        waitForAuth(timeoutMs?: number): Promise<boolean>;
-        withAuthRetry<T_1>(operation: () => Promise<T_1>, operationName: string, options?: {
-            maxRetries?: number;
-            retryDelay?: number;
-            authTimeoutMs?: number;
-        }): Promise<T_1>;
-        validate(): Promise<boolean>;
-        handleError(error: unknown): Error;
-        healthCheck(): Promise<{
-            status: string;
-            users?: number;
-            timestamp?: string;
-            [key: string]: any;
-        }>;
-    };
-} & T;