yoto-nodejs-client 0.0.1

package/bin/token-info.js

@@ -0,0 +1,351 @@
+#!/usr/bin/env node
+
+/**
+ * @import {ArgscloptsParseArgsOptionsConfig} from 'argsclopts'
+ */
+
+import { printHelpText } from 'argsclopts'
+import { parseArgs } from 'node:util'
+import { YotoClient } from '../index.js'
+import { pkg } from '../lib/pkg.cjs'
+import { DEFAULT_CLIENT_ID } from '../lib/api-endpoints/constants.js'
+import { decodeJwt, formatTimestamp, checkExpiration, saveTokensToEnv } from './lib/token-helpers.js'
+import {
+  getCommonOptions,
+  loadEnvFile,
+  printHeader
+} from './lib/cli-helpers.js'
+
+/** @type {ArgscloptsParseArgsOptionsConfig} */
+const options = {
+  ...getCommonOptions(),
+  'access-token': {
+    type: 'string',
+    short: 'a',
+    help: 'Access token to inspect (or set YOTO_ACCESS_TOKEN env var)'
+  },
+  'refresh-token': {
+    type: 'string',
+    short: 'r',
+    help: 'Refresh token to inspect (or set YOTO_REFRESH_TOKEN env var)'
+  },
+  introspect: {
+    type: 'boolean',
+    short: 'i',
+    help: 'Attempt to introspect token with authorization server'
+  }
+}
+
+const args = parseArgs({ options, strict: false })
+
+if (args.values['help']) {
+  await printHelpText({
+    options,
+    name: 'yoto-token-info',
+    version: pkg.version,
+    exampleFn: ({ name }) => `    Display information about Yoto OAuth tokens\n\n    Examples:\n      ${name}\n      ${name} --access-token eyJhbGc...\n      ${name} --env-file .env.local\n`
+  })
+  process.exit(0)
+}
+
+// Load .env file if specified or use default
+const envFile = loadEnvFile(args.values['env-file'] ? String(args.values['env-file']) : undefined)
+const outputFile = envFile // Use same file for output
+
+// Get tokens from args or env
+const accessToken = String(args.values['access-token'] || process.env['YOTO_ACCESS_TOKEN'] || '')
+const refreshToken = String(args.values['refresh-token'] || process.env['YOTO_REFRESH_TOKEN'] || '')
+const clientId = String(args.values['client-id'] || process.env['YOTO_CLIENT_ID'] || DEFAULT_CLIENT_ID)
+const shouldIntrospect = Boolean(args.values['introspect'])
+
+if (!accessToken || !refreshToken) {
+  console.error('❌ Both access token and refresh token are required')
+  console.error('Provide tokens via:')
+  console.error('  - Command line flags: --access-token and --refresh-token')
+  console.error('  - Environment variables: YOTO_ACCESS_TOKEN and YOTO_REFRESH_TOKEN')
+  console.error('  - .env file (loaded automatically or specify with --env-file)')
+  console.error('\n💡 Tip: Run yoto-auth to get both tokens')
+  process.exit(1)
+}
+
+/**
+ * Introspect token with authorization server
+ * @param {string} token
+ * @param {string} clientId
+ * @returns {Promise<any>}
+ */
+async function introspectToken (token, clientId) {
+  const introspectionUrl = 'https://login.yotoplay.com/oauth/introspect'
+
+  try {
+    const response = await fetch(introspectionUrl, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/x-www-form-urlencoded'
+      },
+      body: new URLSearchParams({
+        token,
+        client_id: clientId
+      })
+    })
+
+    if (response.status === 404) {
+      return { error: 'not_supported', message: 'Token introspection endpoint not found (404)' }
+    }
+
+    if (response.status === 401) {
+      return {
+        error: 'authentication_required',
+        message: 'Endpoint requires client authentication. This is typical for introspection endpoints - they require confidential clients with credentials (client secret or private key). Public clients cannot use this endpoint.'
+      }
+    }
+
+    if (!response.ok) {
+      const errorText = await response.text()
+      return { error: 'request_failed', message: `Request failed: ${response.status} ${errorText}` }
+    }
+
+    return await response.json()
+  } catch (err) {
+    const error = /** @type {any} */ (err)
+    return { error: 'network_error', message: error.message }
+  }
+}
+
+/**
+ * Display token information
+ * @param {string} tokenType
+ * @param {string} token
+ * @param {string} clientId
+ * @param {boolean} shouldIntrospect
+ */
+async function displayTokenInfo (tokenType, token, clientId, shouldIntrospect) {
+  console.log(`\n${'='.repeat(60)}`)
+  console.log(`${tokenType.toUpperCase()} TOKEN`)
+  console.log('='.repeat(60))
+
+  // Check if token is a JWT (has three parts separated by dots)
+  const parts = token.split('.')
+  if (parts.length !== 3) {
+    // Not a JWT - probably an opaque token (like refresh tokens)
+    console.log('\n🔤 Token Type: Opaque Token (not a JWT)')
+    console.log('\n📝 Information:')
+    console.log('  This token is not a JWT and cannot be decoded.')
+    console.log('  It is likely an opaque refresh token that can only')
+    console.log('  be validated by the authorization server.')
+    console.log('\n🔤 Token Preview:')
+    if (token.length > 40) {
+      console.log(`  ${token.substring(0, 20)}...${token.substring(token.length - 20)}`)
+    } else {
+      console.log(`  ${token}`)
+    }
+    console.log(`  Length: ${token.length} characters`)
+    return
+  }
+
+  try {
+    const decoded = decodeJwt(token)
+
+    console.log('\n📋 Token Type: JWT')
+
+    // Expiration
+    if (decoded.exp) {
+      console.log('\n⏰ Expiration:')
+      console.log(`  Expires:   ${formatTimestamp(decoded.exp)}`)
+      const expCheck = checkExpiration(decoded.exp)
+      const statusIcon = expCheck.expired ? '❌' : '✅'
+      console.log(`  Status:    ${statusIcon} ${expCheck.message}`)
+    }
+
+    // Issued at
+    if (decoded.iat) {
+      console.log(`  Issued:    ${formatTimestamp(decoded.iat)}`)
+      const age = Math.floor(Date.now() / 1000) - decoded.iat
+      const ageMinutes = Math.floor(age / 60)
+      const ageHours = Math.floor(ageMinutes / 60)
+      if (ageHours > 0) {
+        console.log(`  Age:       ${ageHours} hour(s) ${ageMinutes % 60} minute(s)`)
+      } else {
+        console.log(`  Age:       ${ageMinutes} minute(s)`)
+      }
+    }
+
+    // Subject and audience
+    console.log('\n👤 Claims:')
+    if (decoded.sub) console.log(`  Subject:   ${decoded.sub}`)
+    if (decoded.aud) {
+      if (Array.isArray(decoded.aud)) {
+        console.log('  Audience:')
+        decoded.aud.forEach((/** @type {any} */ aud) => console.log(`    - ${aud}`))
+      } else {
+        console.log(`  Audience:  ${decoded.aud}`)
+      }
+    }
+    if (decoded.iss) console.log(`  Issuer:    ${decoded.iss}`)
+
+    // Client ID verification
+    if (decoded.azp || decoded.client_id) {
+      const tokenClientId = decoded.azp || decoded.client_id
+      console.log(`  Client ID: ${tokenClientId}`)
+      if (clientId) {
+        if (tokenClientId === clientId) {
+          console.log('             ✅ Matches provided client ID')
+        } else {
+          console.log(`             ⚠️  Does NOT match provided client ID (${clientId})`)
+        }
+      }
+    }
+
+    // Scopes
+    if (decoded.scope) {
+      console.log('\n🔐 Scopes:')
+      const scopes = typeof decoded.scope === 'string' ? decoded.scope.split(' ') : decoded.scope
+      if (Array.isArray(scopes)) {
+        scopes.forEach(scope => console.log(`  - ${scope}`))
+      } else {
+        console.log(`  ${scopes}`)
+      }
+    }
+
+    // Permissions
+    if (decoded.permissions && Array.isArray(decoded.permissions)) {
+      console.log('\n🔑 Permissions:')
+      decoded.permissions.forEach((/** @type {any} */ perm) => console.log(`  - ${perm}`))
+    }
+
+    // Other claims
+    const standardClaims = new Set(['exp', 'iat', 'nbf', 'sub', 'aud', 'iss', 'azp', 'client_id', 'scope', 'permissions', 'alg', 'typ', 'kid'])
+    const otherClaims = Object.keys(decoded).filter(key => !standardClaims.has(key))
+
+    if (otherClaims.length > 0) {
+      console.log('\n📦 Other Claims:')
+      otherClaims.forEach(key => {
+        const value = decoded[key]
+        if (typeof value === 'object') {
+          console.log(`  ${key}: ${JSON.stringify(value)}`)
+        } else {
+          console.log(`  ${key}: ${value}`)
+        }
+      })
+    }
+
+    // Raw token (first/last 20 chars)
+    console.log('\n🔤 Token Preview:')
+    if (token.length > 40) {
+      console.log(`  ${token.substring(0, 20)}...${token.substring(token.length - 20)}`)
+    } else {
+      console.log(`  ${token}`)
+    }
+    console.log(`  Length: ${token.length} characters`)
+  } catch (err) {
+    const error = /** @type {any} */ (err)
+    console.error(`\n❌ Error decoding ${tokenType} token:`)
+    console.error(`   ${error.message}`)
+    console.error('\n💡 Tip: If this is a refresh token, it may be an opaque token')
+    console.error('   that cannot be decoded. This is normal for some OAuth2 implementations.')
+  }
+
+  // Introspection
+  if (shouldIntrospect) {
+    console.log('\n🔍 Token Introspection:')
+    console.log('  Querying authorization server...')
+
+    const introspectionResult = await introspectToken(token, clientId)
+
+    if (introspectionResult.error) {
+      if (introspectionResult.error === 'authentication_required') {
+        console.log(`  ⚠️  ${introspectionResult.message}`)
+      } else {
+        console.log(`  ❌ ${introspectionResult.message}`)
+      }
+    } else if (introspectionResult.active === false) {
+      console.log('  ❌ Token is INACTIVE')
+    } else if (introspectionResult.active === true) {
+      console.log('  ✅ Token is ACTIVE')
+      if (introspectionResult.scope) {
+        console.log(`  Scope:     ${introspectionResult.scope}`)
+      }
+      if (introspectionResult.client_id) {
+        console.log(`  Client ID: ${introspectionResult.client_id}`)
+      }
+      if (introspectionResult.username) {
+        console.log(`  Username:  ${introspectionResult.username}`)
+      }
+      if (introspectionResult.exp) {
+        console.log(`  Expires:   ${formatTimestamp(introspectionResult.exp)}`)
+      }
+      if (introspectionResult.iat) {
+        console.log(`  Issued:    ${formatTimestamp(introspectionResult.iat)}`)
+      }
+    } else {
+      console.log('  ⚠️  Unexpected response:')
+      console.log(`  ${JSON.stringify(introspectionResult, null, 2)}`)
+    }
+  }
+}
+
+printHeader('Yoto Token Information')
+
+// Create YotoClient to show token status
+let client
+try {
+  console.log('\n📊 Creating YotoClient instance...')
+  client = new YotoClient({
+    clientId,
+    refreshToken,
+    accessToken,
+    onTokenRefresh: async (tokens) => {
+      // Save tokens if they refresh during inspection
+      console.log('\n⚠️  Token was refreshed during inspection! Saving...')
+      await saveTokensToEnv(outputFile, {
+        access_token: tokens.accessToken,
+        refresh_token: tokens.refreshToken,
+        token_type: 'Bearer',
+        expires_in: tokens.expiresAt - Math.floor(Date.now() / 1000)
+      }, tokens.clientId)
+      console.log(`✅ Updated tokens saved to ${outputFile}`)
+    },
+    onRefreshStart: () => {
+      console.log('\n🔄 Token refresh triggered during inspection...')
+    },
+    onRefreshError: (error) => {
+      console.warn('\n⚠️  Token refresh failed:', error.message)
+    },
+    onInvalid: (error) => {
+      console.error('\n❌ Refresh token is invalid:', error.message)
+    }
+  })
+
+  console.log('✅ YotoClient created successfully')
+  console.log('\n🔍 Token Status from RefreshableToken:')
+  console.log(`  Valid:         ${client.token.isValid() ? '✅ Yes' : '❌ No'}`)
+  console.log(`  Expires At:    ${formatTimestamp(client.token.getExpiresAt())}`)
+
+  const timeRemaining = client.token.getTimeRemaining()
+  if (timeRemaining > 0) {
+    const minutes = Math.floor(timeRemaining / 60)
+    const hours = Math.floor(minutes / 60)
+    if (hours > 0) {
+      console.log(`  Time Remaining: ${hours} hour(s) ${minutes % 60} minute(s)`)
+    } else {
+      console.log(`  Time Remaining: ${minutes} minute(s)`)
+    }
+  } else {
+    console.log(`  Time Remaining: Expired ${Math.abs(timeRemaining)} seconds ago`)
+  }
+} catch (err) {
+  const error = /** @type {Error} */ (err)
+  console.log(`⚠️  Could not create YotoClient: ${error.message}`)
+}
+
+// Display access token info
+if (accessToken) {
+  await displayTokenInfo('access', accessToken, clientId, shouldIntrospect)
+}
+
+// Display refresh token info
+await displayTokenInfo('refresh', refreshToken, clientId, shouldIntrospect)
+
+console.log('\n' + '='.repeat(60))
+console.log('✨ Token inspection complete')
+console.log('='.repeat(60) + '\n')

package/index.d.ts

@@ -0,0 +1,218 @@
+export class YotoClient {
+    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;
+    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>;
+    static requestDeviceCode(params: {
+        clientId: string;
+        scope?: string | undefined;
+        audience?: string | undefined;
+    }): Promise<Auth.YotoDeviceCodeResponse>;
+    constructor({ clientId, refreshToken, accessToken, onTokenRefresh, bufferSeconds, onRefreshStart, onRefreshError, onInvalid, userAgent, defaultRequestOptions }: YotoClientConstructorOptions);
+    get token(): RefreshableToken;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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[]>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    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>;
+    createMqttClient({ deviceId, options }: {
+        deviceId: string;
+        options?: {
+            autoSubscribe?: boolean | undefined;
+        } | undefined;
+    }): Promise<YotoMqttClient>;
+    #private;
+}
+export type RefreshSuccessEvent = {
+    clientId: string;
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+};
+export type YotoClientConstructorOptions = {
+    clientId: string;
+    refreshToken: string;
+    accessToken: string;
+    onTokenRefresh: (event: RefreshSuccessEvent) => void | Promise<void>;
+    bufferSeconds?: number;
+    onRefreshStart?: () => void | Promise<void>;
+    onRefreshError?: (error: Error) => void | Promise<void>;
+    onInvalid?: (error: Error) => void | Promise<void>;
+    userAgent?: string;
+    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';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

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