@homebridge-plugins/homebridge-august 3.2.2 → 3.3.0-beta.0

package/.github/scripts/resolve-version-bump-esm.js

@@ -1,118 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'node:fs'
-import https from 'node:https'
-import process from 'node:process'
-
-const allowed = new Set(['major', 'minor', 'patch'])
-
-function setOutput(name, value) {
-  if (process.env.GITHUB_OUTPUT) {
-    fs.appendFileSync(process.env.GITHUB_OUTPUT, `${name}=${value}\n`)
-  }
-  console.log(`${name}=${value}`)
-}
-
-function resolveFromLabels(labels) {
-  const majorLabels = new Set(['major', 'semver:major', 'release:major', 'breaking', 'breaking-change'])
-  const minorLabels = new Set(['minor', 'semver:minor', 'release:minor', 'feature'])
-  const patchLabels = new Set(['patch', 'semver:patch', 'release:patch', 'fix'])
-
-  if (labels.some(label => majorLabels.has(label))) return 'major'
-  if (labels.some(label => minorLabels.has(label))) return 'minor'
-  if (labels.some(label => patchLabels.has(label))) return 'patch'
-  return 'patch'
-}
-
-function listPrsForCommit(owner, repo, sha, token) {
-  return new Promise((resolve, reject) => {
-    const path = `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/commits/${sha}/pulls`
-    const req = https.request(
-      {
-        hostname: 'api.github.com',
-        method: 'GET',
-        path,
-        headers: {
-          Accept: 'application/vnd.github+json',
-          Authorization: `Bearer ${token}`,
-          'User-Agent': 'homebridge-resolve-version-bump',
-          'X-GitHub-Api-Version': '2022-11-28',
-        },
-      },
-      (res) => {
-        let body = ''
-        res.setEncoding('utf8')
-        res.on('data', (chunk) => {
-          body += chunk
-        })
-        res.on('end', () => {
-          if (res.statusCode < 200 || res.statusCode >= 300) {
-            reject(new Error(`GitHub API request failed (${res.statusCode}): ${body}`))
-            return
-          }
-          try {
-            const parsed = JSON.parse(body)
-            resolve(Array.isArray(parsed) ? parsed : [])
-          } catch (error) {
-            reject(new Error(`Failed to parse GitHub API response: ${error.message}`))
-          }
-        })
-      },
-    )
-
-    req.on('error', reject)
-    req.end()
-  })
-}
-
-async function main() {
-  const manualInput = (process.argv[2] || '').trim().toLowerCase()
-  if (manualInput) {
-    if (!allowed.has(manualInput)) {
-      console.error(`Invalid version bump '${manualInput}'. Use major, minor, or patch.`)
-      process.exit(1)
-    }
-    console.error(`Using manual version bump input: ${manualInput}`)
-    setOutput('version_bump', manualInput)
-    return
-  }
-
-  const repository = process.env.GITHUB_REPOSITORY || ''
-  const sha = process.env.GITHUB_SHA || ''
-  const token = process.env.GITHUB_TOKEN || ''
-
-  if (!repository || !sha || !token || !repository.includes('/')) {
-    console.error('Missing GITHUB_REPOSITORY, GITHUB_SHA, or GITHUB_TOKEN. Defaulting to patch.')
-    setOutput('version_bump', 'patch')
-    return
-  }
-
-  const [owner, repo] = repository.split('/')
-
-  try {
-    const prs = await listPrsForCommit(owner, repo, sha, token)
-    const pr = prs.find((candidate) => candidate.merged_at) || prs[0]
-
-    if (!pr) {
-      console.error('No PR associated with commit; defaulting to patch.')
-      setOutput('version_bump', 'patch')
-      return
-    }
-
-    const labels = (pr.labels || [])
-      .map((label) => (typeof label === 'string' ? label : label.name || ''))
-      .map((label) => label.toLowerCase())
-
-    const bump = resolveFromLabels(labels)
-    console.error(`Resolved bump '${bump}' from PR #${pr.number} labels: ${labels.join(', ') || '(none)'}`)
-    setOutput('version_bump', bump)
-  } catch (error) {
-    console.error(`Failed to inspect PR labels, defaulting to patch: ${error.message}`)
-    setOutput('version_bump', 'patch')
-  }
-}
-
-main().catch((error) => {
-  console.error(error)
-  process.exit(1)
-})

package/dist/platform.d.ts

@@ -1,146 +0,0 @@
-import type { API, DynamicPlatformPlugin, Logging, PlatformAccessory } from 'homebridge';
-import type { AugustPlatformConfig, credentials, device, devicesConfig, options } from './settings.js';
-import August from 'august-yale';
-import { ConnectivityManager } from './connectivity-manager.js';
-/**
- * HomebridgePlatform
- * This class is the main constructor for your plugin, this is where you should
- * parse the user config and discover/register accessories with Homebridge.
- */
-export declare class AugustPlatform implements DynamicPlatformPlugin {
-    accessories: PlatformAccessory[];
-    readonly api: API;
-    readonly log: Logging;
-    config: AugustPlatformConfig;
-    platformConfig: AugustPlatformConfig;
-    platformLogging: options['logging'];
-    platformRefreshRate: options['refreshRate'];
-    platformPushRate: options['pushRate'];
-    platformUpdateRate: options['updateRate'];
-    registeringDevice: boolean;
-    debugMode: boolean;
-    version: string;
-    augustConfig?: August;
-    connectivity?: ConnectivityManager;
-    private readonly lockMechanisms;
-    private pollTimer?;
-    private normalizedCredentialsCache?;
-    constructor(log: Logging, config: AugustPlatformConfig, api: API);
-    /**
-     * This function is invoked when homebridge restores cached accessories from disk at startup.
-     * It should be used to setup event handlers for characteristics and update respective values.
-     */
-    configureAccessory(accessory: PlatformAccessory): Promise<void>;
-    /**
-     * Verify the config passed to the plugin is valid
-     */
-    verifyConfig(): Promise<void>;
-    /**
-     * This method looks to see if session is already Validate, if not then sends a validateCode and saves the installId.
-     * After validateCode is saved to the config user must restart homebridge
-     * this process then looks to see if session is already validated and if the validateCode in config;
-     * if isValidated is false then it will validate iwth the validateCode and save isValidated as true in the config.json file
-     * will also make the validateCode undefined
-     */
-    validated(): Promise<void>;
-    augustCredentials(): Promise<void>;
-    /**
-     * Normalize credentials for August API compatibility
-     * Handle country code variations that may cause 403 errors
-     * Maps regional country codes to supported API endpoints
-     */
-    private normalizeCredentialsForApi;
-    /**
-     * Clear the normalized credentials cache
-     * Should be called when credentials are updated
-     */
-    clearNormalizedCredentialsCache(): void;
-    /**
-     * Public method to get normalized credentials for use by device classes
-     * Uses caching to avoid repeated normalization of the same credentials
-     */
-    getNormalizedCredentials(): Promise<credentials>;
-    /**
-     * Start the platform-level poll cycle. Iterates registered locks
-     * SERIALLY (not in parallel) and short-circuits on the first failure.
-     *
-     * Why serial:
-     *   - One outstanding request at a time on a healthy network is cheap
-     *     enough (most cycles complete in <1s for a handful of locks) and
-     *     avoids racing the August API.
-     *   - On a failing network, a parallel cycle would produce N timeouts
-     *     ~simultaneously, which is exactly the log-spam pattern the
-     *     ConnectivityManager exists to prevent. Serial means one timeout,
-     *     classified once, and the rest of the cycle aborts.
-     *
-     * Why short-circuit on first failure:
-     *   - If the first call fails with a network error, the manager has
-     *     already entered 'degraded' state and scheduled a probe. The
-     *     remaining N-1 calls would all hit the same dead network and
-     *     produce identical errors. Aborting the cycle is the correct
-     *     thing to do.
-     *
-     * Why skip when offline:
-     *   - The manager's state machine is already managing recovery via
-     *     scheduled probes. Polling on top of that just wastes API calls
-     *     and risks rate limiting.
-     */
-    startPolling(): void;
-    /** Stop the platform poll cycle. Called from shutdown paths. */
-    stopPolling(): void;
-    pluginConfig(): Promise<{
-        pluginConfig: any;
-        currentConfig: any;
-    }>;
-    /**
-     * This method is used to discover the your location and devices.
-     */
-    discoverDevices(): Promise<void>;
-    protected Lock(device: device & devicesConfig): Promise<void>;
-    registerDevice(device: device & devicesConfig): Promise<boolean>;
-    externalOrPlatform(device: device & devicesConfig, accessory: PlatformAccessory): Promise<void>;
-    externalAccessory(accessory: PlatformAccessory): Promise<void>;
-    unregisterPlatformAccessories(existingAccessory: PlatformAccessory, device: device & devicesConfig): Promise<void>;
-    /**
-     * Tear down the LockMechanism for a given lockId, releasing its PubNub
-     * subscription. Called when an accessory is unregistered (either via
-     * explicit removal or excludeLockIds config).
-     */
-    private tearDownLockMechanism;
-    getPlatformLogSettings(): Promise<void>;
-    getPlatformRateSettings(): Promise<void>;
-    getPlatformConfigSettings(): Promise<void>;
-    /**
-     * Asynchronously retrieves the version of the plugin from the package.json file.
-     *
-     * This method reads the package.json file located in the parent directory,
-     * parses its content to extract the version, and logs the version using the debug logger.
-     * The extracted version is then assigned to the `version` property of the class.
-     *
-     * @returns {Promise<void>} A promise that resolves when the version has been retrieved and logged.
-     */
-    getVersion(): Promise<void>;
-    /**
-     * Validate and clean a string value for a Name Characteristic.
-     * @param displayName - The display name of the accessory.
-     * @param name - The name of the characteristic.
-     * @param value - The value to be validated and cleaned.
-     * @returns The cleaned string value.
-     */
-    validateAndCleanDisplayName(displayName: string, name: string, value: string): Promise<string>;
-    /**
-     * If device level logging is turned on, log to log.warn
-     * Otherwise send debug logs to log.debug
-     */
-    infoLog(...log: any[]): Promise<void>;
-    successLog(...log: any[]): Promise<void>;
-    debugSuccessLog(...log: any[]): Promise<void>;
-    warnLog(...log: any[]): Promise<void>;
-    debugWarnLog(...log: any[]): Promise<void>;
-    errorLog(...log: any[]): Promise<void>;
-    debugErrorLog(...log: any[]): Promise<void>;
-    debugLog(...log: any[]): Promise<void>;
-    loggingIsDebug(): Promise<boolean>;
-    enablingPlatformLogging(): Promise<boolean>;
-}
-//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAExF,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAKtG,OAAO,MAAM,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAI/D;;;;GAIG;AACH,qBAAa,cAAe,YAAW,qBAAqB;IACnD,WAAW,EAAE,iBAAiB,EAAE,CAAA;IACvC,SAAgB,GAAG,EAAE,GAAG,CAAA;IACxB,SAAgB,GAAG,EAAE,OAAO,CAAA;IACrB,MAAM,EAAG,oBAAoB,CAAA;IAEpC,cAAc,EAAG,oBAAoB,CAAA;IACrC,eAAe,EAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACpC,mBAAmB,EAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAC5C,gBAAgB,EAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACtC,kBAAkB,EAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC1C,iBAAiB,EAAG,OAAO,CAAA;IAC3B,SAAS,EAAG,OAAO,CAAA;IACnB,OAAO,EAAG,MAAM,CAAA;IAUhB,YAAY,CAAC,EAAE,MAAM,CAAA;IAKrB,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAIlC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAOlE,OAAO,CAAC,SAAS,CAAC,CAAgB;IAGlC,OAAO,CAAC,0BAA0B,CAAC,CAAa;gBAG9C,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,oBAAoB,EAC5B,GAAG,EAAE,GAAG;IAkEV;;;OAGG;IACG,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrE;;OAEG;IACG,YAAY;IAalB;;;;;;OAMG;IACG,SAAS;IAwDT,iBAAiB;IAwBvB;;;;OAIG;YACW,0BAA0B;IAiCxC;;;OAGG;IACH,+BAA+B,IAAI,IAAI;IAKvC;;;OAGG;IACG,wBAAwB,IAAI,OAAO,CAAC,WAAW,CAAC;IA0BtD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY,IAAI,IAAI;IAuDpB,gEAAgE;IAChE,WAAW,IAAI,IAAI;IAOb,YAAY;;;;IAoBlB;;OAEG;IACG,eAAe;cAkHL,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IA4D7C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAmBtC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,SAAS,EAAE,iBAAiB;IAU/E,iBAAiB,CAAC,SAAS,EAAE,iBAAiB;IAI9C,6BAA6B,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa;IAO/G;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAQvB,sBAAsB;IAUtB,uBAAuB;IAevB,yBAAyB;IAgB/B;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;;;OAMG;IACG,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCpG;;;OAGG;IACG,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrC,UAAU,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxC,eAAe,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrC,YAAY,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,QAAQ,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtC,aAAa,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,QAAQ,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;CAGlD"}