@dxtmisha/scripts 1.5.1 → 1.5.2

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.5.2] - 2026-10-07
+
+### Added
+- **Package Modification Date Tracking in `BuildPackages`**:
+  - Added `--date` (`-t`) CLI option to `dxt-build-packages` (`bin/build-packages.ts`) enabling rebuilds when package modification dates or git commit timestamps change.
+  - Added `BuildPackagesOptions` interface with `{ path, code, logFile, date }` configuration properties.
+  - Added `BuildPackageLogItem` interface (`{ version: string, date?: string }`) supporting structured build log entries.
+  - Added `getDate(packageFile)` method resolving commit timestamp via `GitRead.getFileDate()` with filesystem mtime fallback via `PropertiesFile.getTime()`.
+  - Added `getDateLog(name)` method to extract cached package timestamps from memory/file build logs.
+
+### Changed
+- **`BuildPackages` Constructor & Options Refactoring**:
+  - Refactored `BuildPackages` constructor to accept a unified `BuildPackagesOptions` object instead of separate positional arguments.
+  - Enhanced `updateLog()` to record both `version` and `date` in `ui-build.log.json`.
+  - Updated `getVersionLog()` to maintain backward compatibility with both legacy string-based and new object-based log records.
+  - Updated `isUpdate()` logic to evaluate date invalidation when `date: true` option is enabled.
+  - Updated unit test suite in `BuildPackages.test.ts` covering object-based options, date-driven rebuild detection, and log persistence.
+
 ## [1.5.1] - 2026-10-05
 
 ### Added

package/bin/build-packages.ts

@@ -6,13 +6,18 @@ import { BuildPackages } from '../dist/library.js'
 
 const { values } = parseCliArguments(
   'Scans, sorts, and builds monorepo packages managing build order by priorities.',
-  'Usage: dxt-build-packages [--code CODE] [--dir DIR] [--log LOG]',
+  'Usage: dxt-build-packages [--code CODE] [--date] [--dir DIR] [--log LOG]',
   {
     code: {
       type: 'string',
       short: 'c',
       description: 'Custom build command or script name to execute'
     },
+    date: {
+      type: 'boolean',
+      short: 't',
+      description: 'Compare package modification date in addition to version'
+    },
     dir: {
       type: 'string',
       short: 'd',
@@ -29,8 +34,14 @@ const { values } = parseCliArguments(
 const dir = typeof values.dir === 'string' ? values.dir : undefined
 const code = typeof values.code === 'string' ? values.code : undefined
 const log = typeof values.log === 'string' ? values.log : undefined
+const date = typeof values.date === 'boolean' ? values.date : undefined
 
-new BuildPackages(dir, code, log)
+new BuildPackages({
+  path: dir,
+  code,
+  logFile: log,
+  date
+})
   .make()
   .catch((error) => {
     console.error('dxt-build-packages failed:', error)

package/dist/library.d.ts

@@ -991,6 +991,18 @@ export declare class BrowserItem {
     protected toConsole(text: string): void;
 }
 
+/**
+ * Cached package build log entry.
+ *
+ * Запись лога сборки пакета в кэше.
+ */
+export declare interface BuildPackageLogItem {
+    /** Package version / Версия пакета */
+    version: string;
+    /** Last modification date or commit timestamp / Дата последнего изменения или временная метка коммита */
+    date?: string;
+}
+
 /**
  * Orchestrator for scanning, sorting, and building monorepo packages.
  * Manages build order based on package priorities and tracks build versions via log cache.
@@ -999,20 +1011,20 @@ export declare class BrowserItem {
  * Управляет порядком сборки на основе приоритетов пакетов и отслеживает версии сборки через лог-кэш.
  */
 export declare class BuildPackages {
+    protected readonly options: BuildPackagesOptions;
+    /** Map of cached package build logs / Карта кэшированных логов сборки пакетов */
+    protected log: Record<string, BuildPackageLogItem | string>;
     protected readonly path: string;
-    protected readonly code?: string | undefined;
-    protected readonly logFile?: string | undefined;
-    /** Map of cached package build versions / Карта кэшированных версий сборки пакетов */
-    protected log: Record<string, string>;
+    protected readonly code?: string;
+    protected readonly logFile?: string;
+    protected readonly date?: boolean;
     /**
-     * Constructor initializes packages path, custom build code, custom log file, and loads build log.
+     * Constructor initializes packages path, custom build code, custom log file, date comparison flag, and loads build log.
      *
-     * Конструктор инициализирует путь к пакетам, пользовательский код сборки, пользовательский файл лога и загружает лог сборки.
-     * @param path packages directory path / путь к директории пакетов
-     * @param code custom build command or script name / пользовательская команда сборки или имя скрипта
-     * @param logFile custom log file name or path / пользовательское имя или путь к файлу лога
+     * Конструктор инициализирует путь к пакетам, пользовательский код сборки, пользовательский файл лога, флаг сравнения дат и загружает лог сборки.
+     * @param options configuration options / параметры конфигурации
      */
-    constructor(path?: string, code?: string | undefined, logFile?: string | undefined);
+    constructor(options?: BuildPackagesOptions);
     /**
      * Scans the packages directory and builds each package that contains a package.json.
      *
@@ -1024,7 +1036,7 @@ export declare class BuildPackages {
      *
      * Проверяет, нужно ли обновлять пакет.
      * @param packageFile package file object / объект файла пакета
-     * @returns true if version differs from log cache / true, если версия отличается от кэша лога
+     * @returns true if version or modification date differs from log cache / true, если версия или дата изменения отличается от кэша лога
      */
     protected isUpdate(packageFile: PackageFile): boolean;
     /**
@@ -1035,6 +1047,22 @@ export declare class BuildPackages {
      * @returns command string or undefined / строка команды или undefined
      */
     protected getCode(packageFile: PackageFile): string | undefined;
+    /**
+     * Returns the last modification date of the package.
+     *
+     * Возвращает дату последнего изменения пакета.
+     * @param packageFile package file instance / экземпляр файла пакета
+     * @returns commit date string / строка даты коммита
+     */
+    protected getDate(packageFile: PackageFile): string;
+    /**
+     * Returns the cached modification date of the package from the build log.
+     *
+     * Возвращает кэшированную дату изменения пакета из лога сборки.
+     * @param name package name / имя пакета
+     * @returns cached date string or undefined / строка кэшированной даты или undefined
+     */
+    protected getDateLog(name: string): string | undefined;
     /**
      * Returns the path segments to the build log file.
      *
@@ -1051,9 +1079,9 @@ export declare class BuildPackages {
      */
     protected getVersionLog(name: string): string;
     /**
-     * Updates the build log with the current package version in memory.
+     * Updates the build log with the current package version and date in memory.
      *
-     * Обновляет лог сборки текущей версией пакета в памяти.
+     * Обновляет лог сборки текущей версией и датой пакета в памяти.
      * @param packageFile package file object / объект файла пакета
      */
     protected updateLog(packageFile: PackageFile): void;
@@ -1088,6 +1116,22 @@ export declare class BuildPackages {
     private getList;
 }
 
+/**
+ * Configuration options for BuildPackages.
+ *
+ * Параметры конфигурации для BuildPackages.
+ */
+export declare interface BuildPackagesOptions {
+    /** Directory path to packages / Путь к директории пакетов */
+    path?: string;
+    /** Custom build command or script name / Пользовательская команда сборки или имя скрипта */
+    code?: string;
+    /** Custom log file name or path / Пользовательское имя или путь к файлу лога */
+    logFile?: string;
+    /** Whether to compare package modification date in addition to version / Сравнивать ли дату изменения пакета дополнительно к версии */
+    date?: boolean;
+}
+
 /**
  * Orchestrator for scanning and publishing changed packages to the npm registry.
  * Compares current package versions against published versions in npm and publishes updated packages.