@shisyamo4131/air-guard-v2-schemas 2.4.2-dev.8 → 2.4.2-dev.81

package/src/OperationResultDetail.js

@@ -1,61 +1,70 @@
 /*****************************************************************************
- * OperationResultDetail Model ver 1.0.0
+ * @file ./src/OperationResultDetail.js
  * @author shisyamo4131
- * ---------------------------------------------------------------------------
- * - Model representing the details of an operation result.
- * - Extends OperationDetail.
- * ---------------------------------------------------------------------------
- * @inherited - The following properties are inherited from OperationDetail:
- * @props {string} id - Employee or Outsourcer document ID
- * @props {number} index - Identifier index for Outsourcer (always 0 for Employee)
- * @props {boolean} isEmployee - Employee flag (true: Employee, false: Outsourcer)
- * @props {number} amount - Number of placements (always fixed at 1)
- * @props {string} siteId - Site ID
- * @props {boolean} isQualified - Qualified flag
- * @props {boolean} isOjt - OJT flag
- * @props {Date} dateAt - Placement date
- * @props {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
- * @props {string} shiftType - `DAY` or `NIGHT`
- * @props {string} startTime - Start time (HH:MM format)
- * @props {boolean} isStartNextDay - Next day start flag
- * @props {string} endTime - End time (HH:MM format)
- * @props {number} breakMinutes - Break time (minutes)
- * @props {number} regulationWorkMinutes - Regulation work minutes
- * --------------------------------------------------------------------------
- * @inherited - The following computed properties are inherited from OperationDetail:
- * @computed {string} workerId - Worker ID
- * - For Employee, it's the same as `id`, for Outsourcer, it's a concatenation of `id` and `index` with ':'
- * @computed {string|null} employeeId - Employee ID (null if not applicable)
- * @computed {string|null} outsourcerId - Outsourcer ID (null if not applicable)
- * @computed {number} overtimeWorkMinutes - Overtime work in minutes
- * - Calculated as `totalWorkMinutes` minus `regulationWorkMinutes`
- * - Overtime work is not negative; the minimum is 0.
- * @computed {string} key - Unique key combining `date`, `dayType`, and `shiftType`
- * @computed {string} date - Date string in YYYY-MM-DD format based on `dateAt`
- * @computed {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date
- * @computed {Date} startAt - Start date and time (Date object)
- * @computed {Date} endAt - End date and time (Date object)
- * @computed {number} totalWorkMinutes - Total working time in minutes (excluding break time)
- * @computed {number} regularTimeWorkMinutes - Regular working time in minutes
- * --------------------------------------------------------------------------
- * @inherited - The following accessor properties are inherited from OperationDetail:
- * @accessor {number} startHour - Start hour (0-23)
- * - Extracted from `startTime`.
- * @accessor {number} startMinute - Start minute (0-59)
- * - Extracted from `startTime`.
- * @accessor {number} endHour - End hour (0-23)
- * - Extracted from `endTime`.
- * @accessor {number} endMinute - End minute (0-59)
- * - Extracted from `endTime`.
- * @accessor {number} breakHours - Break time in hours (converts to/from breakMinutes)
- * - Accessor for break time in hours.
- * @accessor {number} overtimeWorkHours - Overtime work in hours (converts to/from overtimeWorkMinutes)
- * ---------------------------------------------------------------------------
- * @inherited - The following method is inherited from WorkingResult:
- * @method {function} setDateAtCallback - Callback method called when `dateAt` is set
- * - Override this method in subclasses to add custom behavior when `dateAt` changes.
- * - By default, updates `dayType` based on the new `dateAt` value.
- * - @param {Date} v - The new `dateAt` value
+ * @description 稼働実績明細クラス
+ *
+ * @class
+ * @extends OperationDetail
+ *
+ * @property {Date} dateAt - 日付 (変更されると `dayType` が自動的に更新されます)
+ * @property {string} shiftType - 勤務区分
+ * @property {string} startTime - 開始時刻 (HH:MM 形式)
+ * @property {string} endTime - 終了時刻 (HH:MM 形式)
+ * @property {boolean} isStartNextDay - 翌日開始フラグ
+ * - `true` の場合、実際の勤務は `dateAt` の翌日であることを意味します。
+ * @property {number} breakMinutes - 休憩時間 (分)
+ * @property {string} date - `dateAt` に基づく YYYY-MM-DD 形式の日付文字列 (読み取り専用)
+ * - `dateAt` に基づいて YYYY-MM-DD 形式の文字列を返します。
+ * @property {Date} startAt - 開始日時 (Date オブジェクト) (読み取り専用)
+ * - `dateAt` に基づいて `startTime` を設定した Date オブジェクトを返します。
+ * - `isStartNextDay` が true の場合、1日加算します。
+ * @property {Date} endAt - 終了日時 (Date オブジェクト) (読み取り専用)
+ * - `startAt` を起点に、最初に現れる `endTime` の Date オブジェクトを返します。
+ * @property {boolean} isSpansNextDay - 翌日跨ぎフラグ (読み取り専用)
+ * - `true` の場合、`startAt` と `endAt` の日付が異なることを意味します。
+ * @property {number} regulationWorkMinutes - 規定労働時間 (分)
+ * - `startAt` から `endAt` までの時間から `breakMinutes` を差し引いた時間のうち、
+ *   規定内として扱う労働時間（分）です。
+ * - 実際の労働時間から残業時間を算出するための基準となる値です。
+ * - この値があることで、取極めに柔軟な設定を行うことが可能になる他、労働基準法の 1 日の所定労働時間上限が変更された際に
+ *   影響を最小限に抑えることができます。
+ * 例) 8:00 から 17:00 までの勤務で休憩が 60 分の場合
+ * - 規定労働時間を 8 時間 (480 分) とし、実際の勤務が 8 時間 (480 分) を超えた分が残業時間として扱われます。
+ * 例) 8:00 から 16:00 までの勤務で休憩が 60 分の場合
+ * - 規定労働時間を 7 時間 (420 分) とすると、実際の勤務が 7 時間 (420 分) を超えた分が残業時間として扱われます。
+ * - 規定労働時間を 8 時間 (480 分) とすると、実際の勤務が 8 時間 (480 分) を超えた分が残業時間として扱われます。
+ * 例) 7:00 から 翌日 7:00 までの勤務で休憩が 60 分の場合
+ * - 規定労働時間を 8 時間 (480 分) とすると、実際の勤務が 8 時間 (480 分) を超えた分が残業時間として扱われます。
+ *   この場合、最初の 8 時間までは基本単価が適用され、残りの 8 時間は残業単価が適用されるといった設定が可能になります。
+ * - 規定労働時間を 24 時間 (1440 分) とすると、実際の勤務が 24 時間 (1440 分) を超えた分が残業時間として扱われます。
+ *   この場合、全ての勤務時間が基本単価で扱われるといった設定が可能になります。
+ * @property {string} dayType - 曜日区分
+ * @property {number} totalWorkMinutes - 総労働時間 (休憩時間を除く) (分) (読み取り専用)
+ * @property {number} regularTimeWorkMinutes - 所定労働時間 (分) (読み取り専用)
+ * @property {number} overtimeWorkMinutes - 残業時間 (分) (読み取り専用)
+ * @property {string} id - 従業員ID または 外注先ID
+ * @property {number} index - 外注先の識別用インデックス (従業員の場合は常に0)
+ * @property {boolean} isEmployee - 従業員フラグ (true: 従業員, false: 外注先)
+ * @property {number} amount - 配置人数 (常に1で固定)
+ * @property {string} siteId - 現場ID
+ * @property {boolean} isQualified - 資格者フラグ
+ * @property {boolean} isOjt - OJTフラグ
+ * @property {string} workerId - 作業者ID (読み取り専用)
+ * - 従業員の場合は `id` と同じ、外注先の場合は `id` と `index` を `:` で結合した文字列を返します。
+ * @property {string|null} employeeId - 従業員ID (該当しない場合は null) (読み取り専用)
+ * @property {string|null} outsourcerId - 外注先ID (該当しない場合は null) (読み取り専用)
+ *
+ * @method setDateAtCallback - `dateAt` が設定されたときに呼び出されるコールバック関数
+ * @method getInvalidReasons - クラス特有のエラーの有無を返すメソッド
+ *
+ * @getter {boolean} isInvalid - クラス特有のエラーが存在するかどうかを返すプロパティ
+ * @getter {Array<string>} invalidReasons - クラス特有のエラーコードの配列を返すプロパティ
+ *
+ * @static SHIFT_TYPE - 勤務区分を定義する定数オブジェクト
+ * @static INVALID_REASON - クラス特有のエラーコードを定義する定数オブジェクト
+ * - `BREAK_MINUTES_NEGATIVE`: `breakMinutes` が負の値である場合のエラーコード
+ * - `REGULATION_WORK_MINUTES_NEGATIVE`: `regulationWorkMinutes` が負の値である場合のエラーコード
+ * @static DAY_TYPE - 曜日区分を定義する定数オブジェクト
  *****************************************************************************/
 import OperationDetail from "./OperationDetail.js";
 

package/src/Site.js

@@ -1,7 +1,5 @@
-/**
- * @file src/Site.js
- * @author shisyamo4131
- *
+/*****************************************************************************
+ * @file ./src/Site.js
  * NOTE: `customerId`, `customer` プロパティについて
  * - 仮登録
  *   - 取引先未定での現場登録のシチュエーションを考慮して現場情報は仮登録を可能とする。
@@ -12,32 +10,20 @@
  * - 自身の従属先データを持たせる場合に `XxxxxMinimal` クラスを使用するが、アプリ側でオブジェクト選択を行う場合に
  *   `Xxxxx` クラスにするのか `XxxxxMinimal` クラスにするのかを判断できないため、docId を持たせて
  *   `beforeCreate` フックでオブジェクトを取得するようにする。
- */
+ *****************************************************************************/
 import { default as FireModel } from "@shisyamo4131/air-firebase-v2";
 import { defField } from "./parts/fieldDefinitions.js";
 import { defAccessor } from "./parts/accessorDefinitions.js";
 import Customer from "./Customer.js";
-import Agreement from "./Agreement.js";
+import AgreementV2 from "./AgreementV2.js";
 import { VALUES } from "./constants/site-status.js";
 import { GeocodableMixin } from "./mixins/GeocodableMixin.js";
 
 const classProps = {
-  // customerId: defField("customerId", {
-  //   required: true,
-  //   component: {
-  //     attrs: {
-  //       disabled: ({ editMode }) => {
-  //         return editMode !== "CREATE";
-  //       },
-  //     },
-  //   },
-  // }),
   customerId: defField("customerId", {
     component: {
       attrs: {
-        /**
-         * `_beforeData.customerId` が存在する場合（本登録後の編集時を表す）には `customerId` を必須とする。
-         */
+        /** `_beforeData.customerId` が存在する場合（本登録後の編集時を表す）には `customerId` を必須とする。 */
         required: ({ item }) => {
           return !!item._beforeData.customerId;
         },
@@ -45,17 +31,12 @@ const classProps = {
     },
   }),
   customer: defField("customer", { hidden: true, customClass: Customer }),
-  customerName: defField("name", {
-    label: "取引先名",
-    required: ({ item }) => {
-      return !item.customerId; // isTemporary プロパティでの判定でも良いか？
-    },
-    component: {
-      attrs: {
-        minLength: 2,
-      },
-    },
-  }),
+
+  /**
+   * 取引先名
+   * - `customerId` が未設定の場合に必須（仮登録状態で取引先の名前だけ登録したい場合を想定）
+   */
+  customerName: defField("customerName"),
   code: defField("code", { label: "現場コード" }),
   name: defField("name", {
     label: "現場名",
@@ -74,38 +55,37 @@ const classProps = {
   building: defField("building"),
   location: defField("location"),
   remarks: defField("multipleLine", { label: "備考" }),
-  agreements: defField("array", { label: "取極め", customClass: Agreement }),
+  // agreements: defField("array", { label: "取極め", customClass: Agreement }),
+  agreementsV2: defField("array", {
+    label: "取極め",
+    customClass: AgreementV2,
+  }),
   status: defField("siteStatus", { required: true }),
 };
 
 /*****************************************************************************
+ * @class Site
+ * @author shisyamo4131
+ *
  * @property {string} customerId - 取引先ドキュメントID
  *
  * @property {object} customer - 取引先オブジェクト
- * - `beforeCreate`, `beforeUpdate` で `customerId` に該当する `Customer` オブジェクトと自動的に同期されます。
- * - `Customer` が更新された場合は Cloud Functions で同期される必要があります。
- *
- * @property {string} code - Site code.
- * @property {string} name - Site name.
- * @property {string} nameKana - Site name in Kana.
+ * @property {string} customerName - 取引先名
+ * @property {string} code - 現場コード
+ * @property {string} name - 現場名
+ * @property {string} nameKana - 現場名カナ
  * @property {string} zipcode - Postal code.
  * @property {string} prefCode - Prefecture code.
- *
  * @property {string} prefecture - Prefecture name derived from `prefCode` (read-only)
- *
  * @property {string} city - City name.
  * @property {string} address - Address details.
  * @property {string} building - Building name.
- *
  * @property {string} fullAddress - Full address combining prefecture, city, and address (read-only)
- *
  * @property {object} location - Geographical location.
  * @property {string} remarks - Additional remarks.
- * @property {array} agreements - List of agreements (Agreement).
- * - Enhanced with custom methods: `add()`, `change()`, `remove()`
+ * @property {array} agreementsV2 - 取極めの配列（バージョン2）。`AgreementV2` クラスのインスタンスを要素とする。
  *
  * @property {string} status - Site status.
- *
  * @property {boolean} isTemporary - 仮登録状態かどうかを表すフラグ
  *
  * @function getAgreement
@@ -115,24 +95,6 @@ const classProps = {
  * @param {string} args.dayType - Day type (e.g., "WEEKDAY", "SATURDAY").
  * @param {string} args.shiftType - Shift type (e.g., "DAY", "NIGHT").
  * @returns {Agreement|null} - Matching agreement or null if not found.
- *
- * @memberof agreements
- * @function add
- * Adds Agreement instance to agreements array.
- * @param {Agreement} agreement - Agreement instance to add.
- * @throws {Error} If argument is not an Agreement instance.
- *
- * @memberof agreements
- * @function change
- * Replaces existing agreement by key matching.
- * @param {Agreement} newAgreement - New Agreement instance to replace existing one.
- * @throws {Error} If argument is not an Agreement instance or if agreement not found.
- *
- * @memberof agreements
- * @function remove
- * Removes agreement from array by key matching.
- * @param {Agreement} agreement - Agreement instance to remove.
- * @throws {Error} If agreement not found.
  *****************************************************************************/
 export default class Site extends GeocodableMixin(FireModel) {
   static className = "現場";
@@ -181,6 +143,8 @@ export default class Site extends GeocodableMixin(FireModel) {
   /**
    * ドキュメント作成直前の処理です。
    * - `customerId` に該当する `Customer` インスタンスを取得して `customer` プロパティにセットします。
+   * - 取引先が未設定のまま現場を仮登録することを許容しますが、その場合は `customerName` プロパティに取引先名を入力する必要があります。
+   * - `customerId` と `customerName` の両方が未設定の場合はエラーをスローします。
    * @param {Object} args - Creation options.
    * @param {string} [args.docId] - Document ID to use (optional).
    * @param {boolean} [args.useAutonumber=true] - Whether to use auto-numbering.
@@ -188,26 +152,29 @@ export default class Site extends GeocodableMixin(FireModel) {
    * @param {Function} [args.callBack] - Callback function.
    * @param {string} [args.prefix] - Path prefix.
    * @returns {Promise<void>}
+   * @throws {Error} `customerId` と `customerName` の両方が未設定の場合にスローされます。
    */
   async beforeCreate(args = {}) {
     await super.beforeCreate(args);
-    // if (!this.customerId) return;
-    // const customerInstance = new Customer();
-    // const isExist = await customerInstance.fetch({
-    //   ...args,
-    //   docId: this.customerId,
-    // });
-    // if (!isExist) {
-    //   return Promise.reject(
-    //     new Error("Invalid customerId: Customer does not exist.")
-    //   );
-    // }
-    // this.customer = customerInstance;
+
+    /**
+     * 取引先IDが指定されておらず、かつ取引先名が指定されていない場合はエラーをスロー
+     */
+    if (!this.customerId && !this.customerName) {
+      throw new Error(
+        "Either customerId or customerName must be provided for temporary registration.",
+      );
+    }
+
     await this._setCustomer();
   }
 
   /**
-   * Override beforeUpdate to prevent changing customer reference.
+   * ドキュメント更新直前の処理です。
+   * - `customerId` に該当する `Customer` インスタンスを取得して `customer` プロパティにセットします。
+   * - 一度設定した取引先を未設定に戻すことはできません。
+   * - 取引先が変更されていた場合は `customer` プロパティを更新します。
+   * - `customerId` と `customerName` の両方が未設定の場合はエラーをスローします。
    * @param {Object} args - Creation options.
    * @param {Object} [args.transaction] - Firestore transaction.
    * @param {Function} [args.callBack] - Callback function.
@@ -217,13 +184,7 @@ export default class Site extends GeocodableMixin(FireModel) {
   async beforeUpdate(args = {}) {
     await super.beforeUpdate(args);
 
-    // if (this.customer.docId !== this._beforeData.customer.docId) {
-    //   return Promise.reject(
-    //     new Error("Not allowed to change customer reference.")
-    //   );
-    // }
-
-    // 取引先を未設定に戻すことはできない。
+    // 一度設定した取引先を未設定に戻すことはできない。
     if (this._beforeData.customerId && !this.customerId) {
       throw new Error("Cannot unset customerId once it is set.");
     }
@@ -232,11 +193,28 @@ export default class Site extends GeocodableMixin(FireModel) {
     if (this.customerId !== this._beforeData.customerId) {
       await this._setCustomer();
     }
+
+    /**
+     * 取引先IDが指定されておらず、かつ取引先名が指定されていない場合はエラーをスロー
+     */
+    if (!this.customerId && !this.customerName) {
+      throw new Error(
+        "Either customerId or customerName must be provided for temporary registration.",
+      );
+    }
   }
 
+  /**
+   * Override `afterInitialize` to define custom accessors and methods.
+   * - Defines `fullAddress`, `prefecture`, and `isTemporary` accessors.
+   * - Enhances `agreements` array with `add`, `change`, and `remove` methods.
+   * @param {Object} item - Initial data item.
+   * @return {void}
+   */
   afterInitialize(item = {}) {
     super.afterInitialize(item);
 
+    /** Define `fullAddress`, `prefecture`, and `isTemporary` accessors. */
     Object.defineProperties(this, {
       fullAddress: defAccessor("fullAddress"),
       prefecture: defAccessor("prefecture"),
@@ -244,64 +222,105 @@ export default class Site extends GeocodableMixin(FireModel) {
         configurable: true,
         enumerable: true,
         get() {
-          return !!this.customerId;
+          return !this.customerId;
         },
         set() {},
       },
     });
 
-    const self = this;
+    /** 2026-03-31 Deprecated */
+    // /**
+    //  * `Agreement` プロパティに対するカスタムメソッドを定義します。
+    //  * - add(agreement): `Agreement` インスタンスを追加します。
+    //  * - change(newAgreement): `key` プロパティを基に既存の `Agreement` を置き換えます。
+    //  * - remove(agreement): `key` プロパティを基に `Agreement` を削除します。
+    //  */
+    // const self = this;
+    // Object.defineProperties(this.agreements, {
+    //   add: {
+    //     value: function (agreement) {
+    //       if (!(agreement instanceof Agreement)) {
+    //         throw new Error("Argument must be an instance of Agreement");
+    //       }
+    //       self.agreements.push(agreement);
+    //     },
+    //     writable: false,
+    //     enumerable: false,
+    //   },
+    //   change: {
+    //     value: function (newAgreement) {
+    //       if (!(newAgreement instanceof Agreement)) {
+    //         throw new Error("Argument must be an instance of Agreement");
+    //       }
+    //       const index = self.agreements.findIndex(
+    //         (agr) => agr.key === newAgreement._beforeData.key,
+    //       );
+    //       if (index !== -1) {
+    //         self.agreements[index] = newAgreement;
+    //       } else {
+    //         throw new Error("Agreement not found");
+    //       }
+    //     },
+    //     writable: false,
+    //     enumerable: false,
+    //   },
+    //   remove: {
+    //     value: function (agreement) {
+    //       const index = self.agreements.findIndex(
+    //         (agr) => agr.key === agreement._beforeData.key,
+    //       );
+    //       if (index !== -1) {
+    //         self.agreements.splice(index, 1);
+    //       } else {
+    //         throw new Error("Agreement not found");
+    //       }
+    //     },
+    //   },
+    // });
+  }
 
-    /**
-     * `Agreement` プロパティに対するカスタムメソッドを定義します。
-     * - add(agreement): `Agreement` インスタンスを追加します。
-     * - change(newAgreement): `key` プロパティを基に既存の `Agreement` を置き換えます。
-     * - remove(agreement): `key` プロパティを基に `Agreement` を削除します。
-     */
-    Object.defineProperties(this.agreements, {
-      add: {
-        value: function (agreement) {
-          if (!(agreement instanceof Agreement)) {
-            throw new Error("Argument must be an instance of Agreement");
-          }
-          self.agreements.push(agreement);
-        },
-        writable: false,
-        enumerable: false,
-      },
-      change: {
-        value: function (newAgreement) {
-          if (!(newAgreement instanceof Agreement)) {
-            throw new Error("Argument must be an instance of Agreement");
-          }
-          const index = self.agreements.findIndex(
-            (agr) => agr.key === newAgreement._beforeData.key
-          );
-          if (index !== -1) {
-            self.agreements[index] = newAgreement;
-          } else {
-            throw new Error("Agreement not found");
-          }
-        },
-        writable: false,
-        enumerable: false,
-      },
-      remove: {
-        value: function (agreement) {
-          const index = self.agreements.findIndex(
-            (agr) => agr.key === agreement._beforeData.key
-          );
-          if (index !== -1) {
-            self.agreements.splice(index, 1);
-          } else {
-            throw new Error("Agreement not found");
-          }
-        },
-      },
+  /**
+   * 指定された日付、勤務区分で有効な取極めオブジェクトを返します。
+   * - 日付が指定されなかった場合は、登録されている最新の取極めオブジェクトを返します。
+   * - 条件に合致する取極めオブジェクトが存在しない場合は `null` を返します。
+   * @param {string} date - 日付 (YYYY-MM-DD形式)
+   * @param {string} shiftType - 勤務区分
+   * @returns {Object|null} - 有効な取極めオブジェクトまたは `null`
+   */
+  getValidAgreement({ date = null, shiftType = null } = {}) {
+    const filtered = this.agreementsV2.filter((agr) => {
+      return agr.shiftType === shiftType;
     });
+    if (filtered.length === 0) return null;
+    filtered.sort((a, b) => b.date.localeCompare(a.date));
+    if (!date) return filtered[0];
+    return filtered.find((agr) => agr.date <= date) || null;
+  }
+
+  /***************************************************************************
+   * FOR DEPRECATED PROPERTIES
+   ***************************************************************************/
+  /**
+   * @deprecated `agreements` property is deprecated. Use `agreementsV2` instead.
+   */
+  get agreements() {
+    console.warn(
+      "Warning: `agreements` is deprecated. Use `agreementsV2` instead.",
+    );
+    return [];
+  }
+
+  /**
+   * @deprecated `agreements` property is deprecated. Use `agreementsV2` instead.
+   */
+  set agreements(newValue) {
+    console.warn(
+      "Warning: `agreements` is deprecated. Use `agreementsV2` instead.",
+    );
   }
 
   /**
+   * @deprecated `getAgreement` method is deprecated. Use `getValidAgreement` instead.
    * Returns the applicable agreement based on the given date, dayType, and shiftType.
    * Filters agreements by dayType and shiftType, sorts them by startDate in descending order,
    * and returns the first agreement where date is less than or equal to the given date.
@@ -313,13 +332,17 @@ export default class Site extends GeocodableMixin(FireModel) {
    * @returns {Object|null} - The matching agreement object or null if not found.
    */
   getAgreement(args = {}) {
-    const { date, dayType, shiftType } = args;
-    if (!date || !dayType || !shiftType) return null;
-    return (
-      this.agreements
-        .filter((agr) => agr.dayType === dayType && agr.shiftType === shiftType)
-        .sort((a, b) => b.date.localeCompare(a.date))
-        .find((agr) => agr.date <= date) || null
+    // const { date, dayType, shiftType } = args;
+    // if (!date || !dayType || !shiftType) return null;
+    // return (
+    //   this.agreements
+    //     .filter((agr) => agr.dayType === dayType && agr.shiftType === shiftType)
+    //     .sort((a, b) => b.date.localeCompare(a.date))
+    //     .find((agr) => agr.date <= date) || null
+    // );
+    console.warn(
+      "Warning: `getAgreement` is deprecated. Use `getValidAgreement` instead.",
     );
+    return null;
   }
 }