yoto-nodejs-client 0.0.2 → 0.0.4

package/index.d.ts

@@ -1,586 +1,5 @@
-/**
- * @typedef {Object} RefreshSuccessEvent
- * @property {string} clientId - The OAuth client ID
- * @property {string} accessToken - The new access token
- * @property {string} refreshToken - The refresh token (may be updated)
- * @property {number} expiresAt - Unix timestamp in seconds when token expires
- */
-/**
- * @typedef {Object} YotoClientConstructorOptions
- * @property {string} clientId - OAuth client ID
- * @property {string} refreshToken - OAuth refresh token
- * @property {string} accessToken - Initial OAuth access token (JWT)
- * @property {(event: RefreshSuccessEvent) => void | Promise<void>} onTokenRefresh - **REQUIRED** Callback invoked when tokens are refreshed. You MUST persist these tokens (to file, database, etc.) as the refresh can happen at any time during API calls. The refresh token may be rotated by the auth server. **DO NOT STUB THIS CALLBACK** - always implement proper persistence logic.
- * @property {number} [bufferSeconds=30] - Seconds before expiration to consider token expired
- * @property {() => void | Promise<void>} [onRefreshStart] - Optional callback invoked when token refresh starts. Defaults to console.log.
- * @property {(error: Error) => void | Promise<void>} [onRefreshError] - Optional callback invoked when token refresh fails with a transient error. Defaults to console.warn.
- * @property {(error: Error) => void | Promise<void>} [onInvalid] - Optional callback invoked when refresh token is permanently invalid. Defaults to console.error.
- * @property {string} [userAgent] - Optional user agent string to identify your application
- * @property {RequestOptions} [defaultRequestOptions] - Default undici request options for all requests (dispatcher, timeouts, etc.)
- */
-/**
- * Yoto API Client with automatic token refresh
- */
-export class YotoClient {
-    /**
-     * Get authorization URL for browser-based OAuth flow
-     * @see https://yoto.dev/api/get-authorize/
-     * @param {object} params
-     * @param {string} params.clientId - OAuth client ID
-     * @param {string} params.redirectUri - Redirect URI after authorization
-     * @param {'code' | 'token' | 'id_token' | 'code token' | 'code id_token' | 'token id_token' | 'code token id_token'} params.responseType - OAuth response type
-     * @param {string} params.state - State parameter for CSRF protection
-     * @param {string} [params.audience] - Audience for the token
-     * @param {string} [params.scope] - Requested scopes
-     * @param {string} [params.nonce] - Nonce for replay attack prevention
-     * @param {'none' | 'login' | 'consent' | 'select_account'} [params.prompt] - Authorization prompt behavior
-     * @param {number} [params.maxAge] - Maximum authentication age in seconds
-     * @param {string} [params.codeChallenge] - PKCE code challenge
-     * @param {'S256' | 'plain'} [params.codeChallengeMethod] - PKCE code challenge method
-     * @returns {string} Authorization URL
-     */
-    static getAuthorizeUrl(params: {
-        clientId: string;
-        redirectUri: string;
-        responseType: "code" | "token" | "id_token" | "code token" | "code id_token" | "token id_token" | "code token id_token";
-        state: string;
-        audience?: string | undefined;
-        scope?: string | undefined;
-        nonce?: string | undefined;
-        prompt?: "none" | "login" | "consent" | "select_account" | undefined;
-        maxAge?: number | undefined;
-        codeChallenge?: string | undefined;
-        codeChallengeMethod?: "S256" | "plain" | undefined;
-    }): string;
-    /**
-     * Exchange authorization code or refresh token for access tokens
-     * @see https://yoto.dev/api/post-oauth-token/
-     * @param {object} params
-     * @param {'authorization_code' | 'refresh_token' | 'client_credentials' | 'urn:ietf:params:oauth:grant-type:device_code'} params.grantType - OAuth grant type
-     * @param {string} [params.code] - Authorization code (required for authorization_code grant)
-     * @param {string} [params.redirectUri] - Redirect URI (required for authorization_code grant if used in authorize request)
-     * @param {string} [params.refreshToken] - Refresh token (required for refresh_token grant)
-     * @param {string} [params.clientId] - OAuth client ID
-     * @param {string} [params.clientSecret] - OAuth client secret
-     * @param {string} [params.scope] - Requested scope
-     * @param {string} [params.codeVerifier] - PKCE code verifier
-     * @param {string} [params.deviceCode] - Device code (required for device_code grant)
-     * @param {string} [params.audience] - Audience for the token
-     * @returns {Promise<YotoTokenResponse>}
-     */
-    static exchangeToken(params: {
-        grantType: "authorization_code" | "refresh_token" | "client_credentials" | "urn:ietf:params:oauth:grant-type:device_code";
-        code?: string | undefined;
-        redirectUri?: string | undefined;
-        refreshToken?: string | undefined;
-        clientId?: string | undefined;
-        clientSecret?: string | undefined;
-        scope?: string | undefined;
-        codeVerifier?: string | undefined;
-        deviceCode?: string | undefined;
-        audience?: string | undefined;
-    }): Promise<Auth.YotoTokenResponse>;
-    /**
-     * Request device code for device authorization flow
-     * @see https://yoto.dev/api/post-oauth-device-code/
-     * @param {object} params
-     * @param {string} params.clientId - OAuth client ID
-     * @param {string} [params.scope] - Requested scopes
-     * @param {string} [params.audience] - Audience for the token
-     * @returns {Promise<YotoDeviceCodeResponse>}
-     */
-    static requestDeviceCode(params: {
-        clientId: string;
-        scope?: string | undefined;
-        audience?: string | undefined;
-    }): Promise<Auth.YotoDeviceCodeResponse>;
-    /**
-     * Create a new Yoto API client
-     * @param {YotoClientConstructorOptions} options
-     */
-    constructor({ clientId, refreshToken, accessToken, onTokenRefresh, bufferSeconds, onRefreshStart, onRefreshError, onInvalid, userAgent, defaultRequestOptions }: YotoClientConstructorOptions);
-    /**
-     * Get the underlying RefreshableToken instance
-     * @returns {RefreshableToken}
-     */
-    get token(): RefreshableToken;
-    /**
-     * Get content/card details
-     * @see https://yoto.dev/api/getcontent/
-     * @param {object} params
-     * @param {string} params.cardId - The card/content ID
-     * @param {string} [params.timezone] - Timezone for schedule-based content
-     * @param {'full' | 'pre'} [params.signingType] - Type of URL signing
-     * @param {boolean} [params.playable] - Whether to include playback URLs
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoContentResponse>}
-     */
-    getContent({ cardId, timezone, signingType, playable, requestOptions }: {
-        cardId: string;
-        timezone?: string | undefined;
-        signingType?: "full" | "pre" | undefined;
-        playable?: boolean | undefined;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Content.YotoContentResponse>;
-    /**
-     * Get user's MYO (Make Your Own) content
-     * @see https://yoto.dev/api/getusersmyocontent/
-     * @param {object} [params]
-     * @param {boolean} [params.showDeleted=false] - Include deleted content
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoMyoContentResponse>}
-     */
-    getUserMyoContent({ showDeleted, requestOptions }?: {
-        showDeleted?: boolean | undefined;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Content.YotoMyoContentResponse>;
-    /**
-     * Create or update content/card
-     * @see https://yoto.dev/api/createorupdatecontent/
-     * @param {object} params
-     * @param {YotoCreateOrUpdateContentRequest} params.content - Content data to create/update
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoCreateOrUpdateContentResponse>}
-     */
-    createOrUpdateContent({ content, requestOptions }: {
-        content: Content.YotoCreateOrUpdateContentRequest;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Content.YotoCreateOrUpdateContentResponse>;
-    /**
-     * Delete content/card
-     * @see https://yoto.dev/api/deletecontent/
-     * @param {object} params
-     * @param {string} params.cardId - The card/content ID to delete
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoDeleteContentResponse>}
-     */
-    deleteContent({ cardId, requestOptions }: {
-        cardId: string;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Content.YotoDeleteContentResponse>;
-    /**
-     * Get all devices for authenticated user
-     * @see https://yoto.dev/api/getdevices/
-     * @param {object} [params]
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoDevicesResponse>}
-     */
-    getDevices({ requestOptions }?: {
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Devices.YotoDevicesResponse>;
-    /**
-     * Get device status
-     * @see https://yoto.dev/api/getdevicestatus/
-     * @param {object} params
-     * @param {string} params.deviceId - Device ID
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoDeviceStatusResponse>}
-     */
-    getDeviceStatus({ deviceId, requestOptions }: {
-        deviceId: string;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Devices.YotoDeviceStatusResponse>;
-    /**
-     * Get device configuration
-     * @see https://yoto.dev/api/getdeviceconfig/
-     * @param {object} params
-     * @param {string} params.deviceId - Device ID
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoDeviceConfigResponse>}
-     */
-    getDeviceConfig({ deviceId, requestOptions }: {
-        deviceId: string;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Devices.YotoDeviceConfigResponse>;
-    /**
-     * Update device configuration
-     * @see https://yoto.dev/api/updatedeviceconfig/
-     * @param {object} params
-     * @param {string} params.deviceId - Device ID
-     * @param {YotoUpdateDeviceConfigRequest} params.configUpdate - Config updates
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoUpdateDeviceConfigResponse>}
-     */
-    updateDeviceConfig({ deviceId, configUpdate, requestOptions }: {
-        deviceId: string;
-        configUpdate: Devices.YotoUpdateDeviceConfigRequest;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Devices.YotoUpdateDeviceConfigResponse>;
-    /**
-     * Update device shortcuts
-     * @see https://yoto.dev/api/updateshortcutsbeta/
-     * @param {object} params
-     * @param {string} params.deviceId - Device ID
-     * @param {YotoUpdateShortcutsRequest} params.shortcutsUpdate - Shortcuts config
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoUpdateShortcutsResponse>}
-     */
-    updateDeviceShortcuts({ deviceId, shortcutsUpdate, requestOptions }: {
-        deviceId: string;
-        shortcutsUpdate: Devices.YotoUpdateShortcutsRequest;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Devices.YotoUpdateShortcutsResponse>;
-    /**
-     * Send command to device
-     * @see https://yoto.dev/api/senddevicecommand/
-     * @see https://yoto.dev/players-mqtt/mqtt-docs/
-     * @param {object} params
-     * @param {string} params.deviceId - Device ID
-     * @param {YotoDeviceCommand} params.command - Command to send
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoDeviceCommandResponse>}
-     */
-    sendDeviceCommand({ deviceId, command, requestOptions }: {
-        deviceId: string;
-        command: Devices.YotoDeviceCommand;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Devices.YotoDeviceCommandResponse>;
-    /**
-     * Get all family library groups
-     * @see https://yoto.dev/api/getgroups/
-     * @param {object} [params]
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoGroup[]>}
-     */
-    getGroups({ requestOptions }?: {
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<FamilyLibraryGroups.YotoGroup[]>;
-    /**
-     * Create a family library group
-     * @see https://yoto.dev/api/createagroup/
-     * @param {object} params
-     * @param {YotoCreateGroupRequest} params.group - Group data
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoGroup>}
-     */
-    createGroup({ group, requestOptions }: {
-        group: FamilyLibraryGroups.YotoCreateGroupRequest;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<FamilyLibraryGroups.YotoGroup>;
-    /**
-     * Get a specific family library group
-     * @see https://yoto.dev/api/getgroup/
-     * @param {object} params
-     * @param {string} params.groupId - Group ID
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoGroup>}
-     */
-    getGroup({ groupId, requestOptions }: {
-        groupId: string;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<FamilyLibraryGroups.YotoGroup>;
-    /**
-     * Update a family library group
-     * @see https://yoto.dev/api/updateagroup/
-     * @param {object} params
-     * @param {string} params.groupId - Group ID
-     * @param {YotoUpdateGroupRequest} params.group - Updated group data
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoGroup>}
-     */
-    updateGroup({ groupId, group, requestOptions }: {
-        groupId: string;
-        group: FamilyLibraryGroups.YotoUpdateGroupRequest;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<FamilyLibraryGroups.YotoGroup>;
-    /**
-     * Delete a family library group
-     * @see https://yoto.dev/api/deleteagroup/
-     * @param {object} params
-     * @param {string} params.groupId - Group ID
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoDeleteGroupResponse>}
-     */
-    deleteGroup({ groupId, requestOptions }: {
-        groupId: string;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<FamilyLibraryGroups.YotoDeleteGroupResponse>;
-    /**
-     * Get all family images
-     * @see https://yoto.dev/api/getfamilyimages/
-     * @param {object} [params]
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoFamilyImagesResponse>}
-     */
-    getFamilyImages({ requestOptions }?: {
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Family.YotoFamilyImagesResponse>;
-    /**
-     * Get a specific family image
-     * @see https://yoto.dev/api/getafamilyimage/
-     * @param {object} params
-     * @param {string} params.imageId - Image ID
-     * @param {'640x480' | '320x320'} params.size - Image size
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoFamilyImageResponse>}
-     */
-    getAFamilyImage({ imageId, size, requestOptions }: {
-        imageId: string;
-        size: "640x480" | "320x320";
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Family.YotoFamilyImageResponse>;
-    /**
-     * Upload a family image
-     * @see https://yoto.dev/api/uploadafamilyimage/
-     * @param {object} params
-     * @param {Buffer} params.imageData - Image binary data
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoUploadFamilyImageResponse>}
-     */
-    uploadAFamilyImage({ imageData, requestOptions }: {
-        imageData: Buffer;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Family.YotoUploadFamilyImageResponse>;
-    /**
-     * Get public Yoto icons
-     * @see https://yoto.dev/api/getpublicicons/
-     * @param {object} [params]
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoPublicIconsResponse>}
-     */
-    getPublicIcons({ requestOptions }?: {
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Icons.YotoPublicIconsResponse>;
-    /**
-     * Get user's custom icons
-     * @see https://yoto.dev/api/getusericons/
-     * @param {object} [params]
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoUserIconsResponse>}
-     */
-    getUserIcons({ requestOptions }?: {
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Icons.YotoUserIconsResponse>;
-    /**
-     * Upload a custom icon
-     * @see https://yoto.dev/api/uploadicon/
-     * @param {object} params
-     * @param {Buffer} params.imageData - Image binary data
-     * @param {boolean} [params.autoConvert=true] - Auto-convert to proper format
-     * @param {string} [params.filename] - Optional filename
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoUploadIconResponse>}
-     */
-    uploadIcon({ imageData, autoConvert, filename, requestOptions }: {
-        imageData: Buffer;
-        autoConvert?: boolean | undefined;
-        filename?: string | undefined;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Icons.YotoUploadIconResponse>;
-    /**
-     * Get audio upload URL
-     * @see https://yoto.dev/api/getaudiouploadurl/
-     * @param {object} params
-     * @param {string} params.sha256 - SHA256 hash of audio file
-     * @param {string} [params.filename] - Optional filename
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoAudioUploadUrlResponse>}
-     */
-    getAudioUploadUrl({ sha256, filename, requestOptions }: {
-        sha256: string;
-        filename?: string | undefined;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Media.YotoAudioUploadUrlResponse>;
-    /**
-     * Upload a cover image
-     * @see https://yoto.dev/api/uploadcoverimage/
-     * @param {object} params
-     * @param {Buffer} [params.imageData] - Image binary data
-     * @param {string} [params.imageUrl] - URL to image
-     * @param {boolean} [params.autoConvert] - Auto-convert to proper format
-     * @param {YotoCoverType} [params.coverType] - Cover image type
-     * @param {string} [params.filename] - Optional filename
-     * @param {RequestOptions} [params.requestOptions] - Request options that override defaults
-     * @returns {Promise<YotoUploadCoverImageResponse>}
-     */
-    uploadCoverImage({ imageData, imageUrl, autoConvert, coverType, filename, requestOptions }: {
-        imageData?: Buffer<ArrayBufferLike> | undefined;
-        imageUrl?: string | undefined;
-        autoConvert?: boolean | undefined;
-        coverType?: Media.YotoCoverType | undefined;
-        filename?: string | undefined;
-        requestOptions?: ({
-            dispatcher?: import("undici").Dispatcher;
-        } & Omit<import("undici").Dispatcher.RequestOptions<unknown>, "origin" | "path" | "method"> & Partial<Pick<import("undici").Dispatcher.RequestOptions<null>, "method">>) | undefined;
-    }): Promise<Media.YotoUploadCoverImageResponse>;
-    /**
-     * Create an MQTT client for a specific device
-     *
-     * The MQTT client provides real-time communication with Yoto devices:
-     * - Subscribe to device events (playback, volume, card changes)
-     * - Subscribe to device status (battery, temperature, network)
-     * - Send commands (volume, card playback, ambient lights, etc.)
-     *
-     * @see https://yoto.dev/players-mqtt/
-     * @param {object} params
-     * @param {string} params.deviceId - The device ID to connect to
-     * @param {object} [params.options] - MQTT client options
-     * @param {boolean} [params.options.autoSubscribe=true] - Auto-subscribe to device topics on connect
-     * @returns {Promise<YotoMqttClient>} MQTT client instance
-     *
-     * @example
-     * // Create YotoClient with token refresh callback
-     * const client = new YotoClient({
-     *   clientId: 'your-client-id',
-     *   refreshToken: 'your-refresh-token',
-     *   accessToken: 'your-access-token',
-     *   onTokenRefresh: async (event) => {
-     *     // Save tokens to file/database
-     *     await saveTokens(event.accessToken, event.refreshToken)
-     *   }
-     * })
-     *
-     * // Get an online device
-     * const devices = await client.getDevices()
-     * const device = devices.devices.find(d => d.online)
-     *
-     * // Create MQTT client for the device
-     * const mqttClient = await client.createMqttClient({ deviceId: device.deviceId })
-     *
-     * // Setup event handlers
-     * mqttClient.on('events', (message) => {
-     *   console.log('Playback event:', message.playbackStatus)
-     *   console.log('Volume:', message.volume)
-     * })
-     *
-     * mqttClient.on('status', (message) => {
-     *   console.log('Battery:', message.status.batteryLevel)
-     *   console.log('Temperature:', message.status.temp)
-     * })
-     *
-     * mqttClient.on('response', (message) => {
-     *   console.log('Command acknowledged:', message.status)
-     * })
-     *
-     * // Connect and send commands
-     * await mqttClient.connect()
-     * await mqttClient.requestStatus()
-     * await mqttClient.setVolume(50)
-     * await mqttClient.startCard({ uri: 'https://yoto.io/cardId123' })
-     *
-     * // Cleanup
-     * await mqttClient.disconnect()
-     */
-    createMqttClient({ deviceId, options }: {
-        deviceId: string;
-        options?: {
-            autoSubscribe?: boolean | undefined;
-        } | undefined;
-    }): Promise<YotoMqttClient>;
-    #private;
-}
-export type RefreshSuccessEvent = {
-    /**
-     * - The OAuth client ID
-     */
-    clientId: string;
-    /**
-     * - The new access token
-     */
-    accessToken: string;
-    /**
-     * - The refresh token (may be updated)
-     */
-    refreshToken: string;
-    /**
-     * - Unix timestamp in seconds when token expires
-     */
-    expiresAt: number;
-};
-export type YotoClientConstructorOptions = {
-    /**
-     * - OAuth client ID
-     */
-    clientId: string;
-    /**
-     * - OAuth refresh token
-     */
-    refreshToken: string;
-    /**
-     * - Initial OAuth access token (JWT)
-     */
-    accessToken: string;
-    /**
-     * - **REQUIRED** Callback invoked when tokens are refreshed. You MUST persist these tokens (to file, database, etc.) as the refresh can happen at any time during API calls. The refresh token may be rotated by the auth server. **DO NOT STUB THIS CALLBACK** - always implement proper persistence logic.
-     */
-    onTokenRefresh: (event: RefreshSuccessEvent) => void | Promise<void>;
-    /**
-     * - Seconds before expiration to consider token expired
-     */
-    bufferSeconds?: number;
-    /**
-     * - Optional callback invoked when token refresh starts. Defaults to console.log.
-     */
-    onRefreshStart?: () => void | Promise<void>;
-    /**
-     * - Optional callback invoked when token refresh fails with a transient error. Defaults to console.warn.
-     */
-    onRefreshError?: (error: Error) => void | Promise<void>;
-    /**
-     * - Optional callback invoked when refresh token is permanently invalid. Defaults to console.error.
-     */
-    onInvalid?: (error: Error) => void | Promise<void>;
-    /**
-     * - Optional user agent string to identify your application
-     */
-    userAgent?: string;
-    /**
-     * - Default undici request options for all requests (dispatcher, timeouts, etc.)
-     */
-    defaultRequestOptions?: RequestOptions;
-};
-import { RefreshableToken } from './lib/token.js';
-import * as Content from './lib/api-endpoints/content.js';
-import * as Devices from './lib/api-endpoints/devices.js';
-import * as FamilyLibraryGroups from './lib/api-endpoints/family-library-groups.js';
-import * as Family from './lib/api-endpoints/family.js';
-import * as Icons from './lib/api-endpoints/icons.js';
-import * as Media from './lib/api-endpoints/media.js';
-import type { YotoMqttClient } from './lib/mqtt/client.js';
-import * as Auth from './lib/api-endpoints/auth.js';
-import type { RequestOptions } from './lib/api-endpoints/helpers.js';
+export { YotoClient } from "./lib/api-client.js";
+export { YotoDeviceModel } from "./lib/yoto-device.js";
+export { YotoAccount } from "./lib/yoto-account.js";
+export { DEFAULT_CLIENT_ID, DEFAULT_AUDIENCE, DEFAULT_SCOPE, DEVICE_CODE_GRANT_TYPE } from "./lib/api-endpoints/constants.js";
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

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