@matter/protocol 0.17.0-alpha.0-20260507-059f7763b → 0.17.0-alpha.0-20260508-29ff5ae9e

package/dist/cjs/dcl/DclConfig.js

@@ -1,48 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var DclConfig_exports = {};
-__export(DclConfig_exports, {
-  DclConfig: () => DclConfig,
-  DclGithubConfig: () => DclGithubConfig
-});
-module.exports = __toCommonJS(DclConfig_exports);
-/**
- * @license
- * Copyright 2026 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-var DclConfig;
-((DclConfig2) => {
-  DclConfig2.production = {
-    url: "https://on.dcl.csa-iot.org"
-  };
-  DclConfig2.test = {
-    url: "https://on.test-net.dcl.csa-iot.org"
-  };
-})(DclConfig || (DclConfig = {}));
-var DclGithubConfig;
-((DclGithubConfig2) => {
-  DclGithubConfig2.defaults = {
-    owner: "project-chip",
-    repo: "connectedhomeip",
-    branch: "master",
-    certPath: "credentials/development/paa-root-certs"
-  };
-})(DclGithubConfig || (DclGithubConfig = {}));
-//# sourceMappingURL=DclConfig.js.map

package/dist/cjs/dcl/DclConfig.js.map

@@ -1,6 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/dcl/DclConfig.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAeO,IAAU;AAAA,CAAV,CAAUA,eAAV;AAEI,EAAMA,WAAA,aAAwB;AAAA,IACjC,KAAK;AAAA,EACT;AAGO,EAAMA,WAAA,OAAkB;AAAA,IAC3B,KAAK;AAAA,EACT;AAAA,GATa;AAyBV,IAAU;AAAA,CAAV,CAAUC,qBAAV;AAEI,EAAMA,iBAAA,WAA4B;AAAA,IACrC,OAAO;AAAA,IACP,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,EACd;AAAA,GAPa;",
-  "names": ["DclConfig", "DclGithubConfig"]
-}

package/dist/cjs/dcl/DclOtaUpdateService.d.ts

@@ -1,207 +0,0 @@
-/**
- * @license
- * Copyright 2022-2026 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-import { PersistedFileDesignator } from "#bdx/PersistedFileDesignator.js";
-import { ScopedStorage } from "#bdx/ScopedStorage.js";
-import { Construction, Environment, MatterError } from "@matter/general";
-import { DeviceSoftwareVersionModelDclSchema } from "@matter/types";
-import { DclConfig } from "./DclConfig.js";
-/** Error thrown when OTA update check or download fails */
-export declare class OtaUpdateError extends MatterError {
-    constructor(message: string, options?: ErrorOptions);
-}
-export type OtaUpdateSource = "local" | "dcl-prod" | "dcl-test";
-export type OtaStorageMode = "prod" | "test" | "local";
-export interface DeviceSoftwareVersionModelDclSchemaWithSource extends DeviceSoftwareVersionModelDclSchema {
-    source: OtaUpdateSource;
-}
-/**
- * Update information returned by checkForUpdate.
- * This is an alias for the DCL schema to provide better semantic meaning.
- */
-export type OtaUpdateInfo = DeviceSoftwareVersionModelDclSchemaWithSource;
-/**
- * Service to query and manage OTA updates from the Distributed Compliance Ledger (DCL), but also allows to inject own
- * OTA update info from streams or files. The service is designed as a singleton within an Environment and is shared
- * across multiple nodes. This service is mainly relevant for controllers.
- *
- * The service checks the DCL for available software updates for Matter devices and can download and validate OTA
- * images. Production and test DCL instances are supported, with separate file storage for each.
- */
-export declare class DclOtaUpdateService {
-    #private;
-    get construction(): Construction<DclOtaUpdateService>;
-    constructor(environment: Environment, options?: DclOtaUpdateService.Options);
-    get storage(): ScopedStorage;
-    close(): Promise<void>;
-    /**
-     * Check DCL for available software updates for a device, defined by its vendor ID, product ID, and current
-     * software version. If a target software version is provided, only that version is checked for applicability and
-     * ignoring other newer versions.
-     * If isProduction flag is specified, it is exactly used to find updates. Leave that flag undefined to find both
-     * test and production updates.
-     */
-    checkForUpdate(options: {
-        vendorId: number;
-        productId: number;
-        currentSoftwareVersion: number;
-        includeStoredUpdates?: boolean;
-        isProduction?: boolean;
-        targetSoftwareVersion?: number;
-    }): Promise<DeviceSoftwareVersionModelDclSchemaWithSource | undefined>;
-    /**
-     * Store an OTA update image from a ReadableStream into persistent storage.
-     */
-    store(stream: ReadableStream<Uint8Array>, updateInfo: OtaUpdateInfo, mode?: boolean | OtaStorageMode): Promise<PersistedFileDesignator>;
-    /**
-     * Download and validate an OTA update image from a HTTP pr HTTPS server.
-     *
-     * If a file with the same vendor ID, product ID, and production mode already exists
-     * and passes validation, it will be reused instead of downloading again, unless force is true.
-     *
-     * Production and test files are stored separately to avoid conflicts.
-     *
-     * Returns a PersistedFileDesignator for the validated OTA image
-     */
-    downloadUpdate(updateInfo: OtaUpdateInfo, force?: boolean, timeout?: import("@matter/general").Duration): Promise<PersistedFileDesignator>;
-    /**
-     * Create OtaUpdateInfo from an OTA image stream.
-     *
-     * This method reads and validates an OTA image from a ReadableStream and creates an OtaUpdateInfo
-     * structure. This is useful for providing OTA updates from local files or any stream source.
-     *
-     * The OTA image header contains most required information. However, some DCL-specific
-     * fields are not present in the OTA header and must be provided via options or use defaults:
-     * - cdVersionNumber: Certificate Declaration version (defaults to 1)
-     * - softwareVersionValid: Validity flag (defaults to true)
-     * - schemaVersion: DCL schema version (defaults to 0)
-     * - minApplicableSoftwareVersion: If not in header, defaults to 0 (all versions)
-     * - maxApplicableSoftwareVersion: If not in header, defaults to current version minus 1
-     *
-     * @param stream - ReadableStream of the OTA image
-     * @param otaUrl - URL to use for the OTA file (should be file:// for local files or https:// for remote)
-     * @param options - Optional parameters for DCL-specific fields not in OTA header
-     * @returns OtaUpdateInfo with stream data and header information
-     */
-    updateInfoFromStream(stream: ReadableStream<Uint8Array>, otaUrl: string, options?: {
-        /** Certificate Declaration version number. Defaults to 1. */
-        cdVersionNumber?: number;
-        /** Whether this version is valid. Defaults to true. */
-        softwareVersionValid?: boolean;
-        /** DCL schema version. Defaults to 0. */
-        schemaVersion?: number;
-        /**
-         * Minimum applicable software version. If not provided and not in OTA header,
-         * defaults to 0 (applicable to all versions).
-         */
-        minApplicableSoftwareVersion?: number;
-        /**
-         * Maximum applicable software version. If not provided and not in OTA header,
-         * defaults to current version (only applicable to current version and below).
-         */
-        maxApplicableSoftwareVersion?: number;
-    }): Promise<DeviceSoftwareVersionModelDclSchemaWithSource>;
-    /**
-     * Create OtaUpdateInfo from a remote OTA image file URL.
-     *
-     * This method fetches and validates a remote OTA image file (via HTTPS) and creates an OtaUpdateInfo
-     * structure that can be used with downloadUpdate(). For local files, use updateInfoFromStream() instead.
-     *
-     * The OTA image header contains most required information. However, some DCL-specific
-     * fields are not present in the OTA header and must be provided via options or use defaults:
-     * - cdVersionNumber: Certificate Declaration version (defaults to 1)
-     * - softwareVersionValid: Validity flag (defaults to true)
-     * - schemaVersion: DCL schema version (defaults to 0)
-     * - minApplicableSoftwareVersion: If not in header, defaults to 0 (all versions)
-     * - maxApplicableSoftwareVersion: If not in header, defaults to current version
-     *
-     * @param fileUrl - HTTPS URL to the OTA image file
-     * @param options - Optional parameters for DCL-specific fields not in OTA header
-     * @returns OtaUpdateInfo with file URL and header data
-     */
-    createUpdateInfoFromFile(fileUrl: string, options?: {
-        /** Certificate Declaration version number. Defaults to 1. */
-        cdVersionNumber?: number;
-        /** Whether this version is valid. Defaults to true. */
-        softwareVersionValid?: boolean;
-        /** DCL schema version. Defaults to 0. */
-        schemaVersion?: number;
-        /**
-         * Minimum applicable software version. If not provided and not in OTA header,
-         * defaults to 0 (applicable to all versions).
-         */
-        minApplicableSoftwareVersion?: number;
-        /**
-         * Maximum applicable software version. If not provided and not in OTA header,
-         * defaults to current version (only applicable to current version and below).
-         */
-        maxApplicableSoftwareVersion?: number;
-    }): Promise<DeviceSoftwareVersionModelDclSchemaWithSource>;
-    /**
-     * Find downloaded OTA updates in storage.
-     *
-     * This method scans the OTA storage for downloaded update files and returns
-     * information about them. Files can be filtered by vendor ID, product ID,
-     * and production/test mode.
-     *
-     * @param options - Optional filter criteria
-     * @param options.vendorId - Filter by vendor ID
-     * @param options.productId - Filter by product ID (requires vendorId)
-     * @param options.isProduction - Filter by production (true) or test (false) mode
-     * @returns Array of downloaded update information
-     */
-    find(options?: DclOtaUpdateService.FindOptions): Promise<DclOtaUpdateService.OtaUpdateListEntry[]>;
-    /** Get a PersistedFileDesignator for a stored OTA update file by filename. */
-    fileDesignatorForUpdate(filename: string): Promise<PersistedFileDesignator>;
-    /**
-     * Delete stored OTA update files.
-     *
-     * Can delete by specific filename or by vendor ID, product ID, and mode.
-     * If only vendor ID is provided (no product ID), all files for that vendor are deleted.
-     *
-     * @param options - Deletion criteria
-     * @param options.filename - Specific filename to delete (e.g. `fff1.8000.prod.3`)
-     * @param options.vendorId - Vendor ID to filter files for deletion
-     * @param options.productId - Product ID to filter files for deletion (optional, requires vendorId)
-     * @param options.isProduction - (deprecated, use `mode` instead) production (true) or test (false) mode
-     * @param options.mode - Storage mode: "prod", "test", or "local"
-     * @returns Number of files deleted
-     */
-    delete(options: {
-        filename?: string;
-        vendorId?: number;
-        productId?: number;
-        /** @deprecated Use mode instead */
-        isProduction?: boolean;
-        mode?: OtaStorageMode;
-    }): Promise<number>;
-}
-export declare namespace DclOtaUpdateService {
-    interface Options {
-        /** DCL config for production endpoint. Defaults to DclConfig.production. */
-        productionDclConfig?: DclConfig;
-        /** DCL config for test endpoint. Defaults to DclConfig.test. */
-        testDclConfig?: DclConfig;
-    }
-    type OtaUpdateListEntry = {
-        filename: string;
-        vendorId: number;
-        productId: number;
-        softwareVersion: number;
-        softwareVersionString: string;
-        minApplicableSoftwareVersion?: number;
-        maxApplicableSoftwareVersion?: number;
-        mode: OtaStorageMode;
-        size: number;
-    };
-    interface FindOptions {
-        vendorId?: number;
-        productId?: number;
-        isProduction?: boolean;
-        mode?: OtaStorageMode;
-        currentVersion?: number;
-    }
-}
-//# sourceMappingURL=DclOtaUpdateService.d.ts.map

package/dist/cjs/dcl/DclOtaUpdateService.d.ts.map

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