@torrow/sdk-client 0.18.0 → 0.19.0

package/dist/index.js

@@ -52,8 +52,37 @@ var TorrowSdkErrorDomain = /* @__PURE__ */ ((TorrowSdkErrorDomain2) => {
   TorrowSdkErrorDomain2["BehaviorSettings"] = "BehaviorSettings";
   TorrowSdkErrorDomain2["Otp"] = "Otp";
   TorrowSdkErrorDomain2["AuthSession"] = "AuthSession";
+  TorrowSdkErrorDomain2["Profiles"] = "Profiles";
   return TorrowSdkErrorDomain2;
 })(TorrowSdkErrorDomain || {});
+var ProfileErrorReason = /* @__PURE__ */ ((ProfileErrorReason2) => {
+  ProfileErrorReason2["TargetNotProfile"] = "TargetNotProfile";
+  ProfileErrorReason2["LastProfile"] = "LastProfile";
+  ProfileErrorReason2["SelectedDefault"] = "SelectedDefault";
+  ProfileErrorReason2["UnusableProfileList"] = "UnusableProfileList";
+  ProfileErrorReason2["UnusableDefault"] = "UnusableDefault";
+  return ProfileErrorReason2;
+})(ProfileErrorReason || {});
+var ProfileOperation = /* @__PURE__ */ ((ProfileOperation2) => {
+  ProfileOperation2["SetDefaultProfileByContactId"] = "setDefaultProfileByContactId";
+  ProfileOperation2["Remove"] = "remove";
+  return ProfileOperation2;
+})(ProfileOperation || {});
+var ProfileFailureAt = /* @__PURE__ */ ((ProfileFailureAt2) => {
+  ProfileFailureAt2["ValidateInput"] = "ValidateInput";
+  ProfileFailureAt2["ReadProfiles"] = "ReadProfiles";
+  ProfileFailureAt2["ValidateProfiles"] = "ValidateProfiles";
+  ProfileFailureAt2["ReadDefault"] = "ReadDefault";
+  ProfileFailureAt2["ValidateDefault"] = "ValidateDefault";
+  ProfileFailureAt2["Write"] = "Write";
+  ProfileFailureAt2["ValidateWriteResponse"] = "ValidateWriteResponse";
+  ProfileFailureAt2["ProjectResponse"] = "ProjectResponse";
+  return ProfileFailureAt2;
+})(ProfileFailureAt || {});
+var ProfileEffectStep = /* @__PURE__ */ ((ProfileEffectStep2) => {
+  ProfileEffectStep2["Write"] = "Write";
+  return ProfileEffectStep2;
+})(ProfileEffectStep || {});
 var FileMetadataErrorReason = /* @__PURE__ */ ((FileMetadataErrorReason2) => {
   FileMetadataErrorReason2["ContentTypeUnavailable"] = "ContentTypeUnavailable";
   FileMetadataErrorReason2["SubscriptionIsNotValid"] = "SubscriptionIsNotValid";
@@ -15652,6 +15681,63 @@ function prepareUserProfileItemForAdd(body) {
   return payload;
 }
 
+// ../../src/resources/user-profiles/profile-list-response-error.ts
+var ProfileListResponseError = class extends Error {
+  constructor(message, cause) {
+    super(message, { cause });
+  }
+};
+
+// ../../src/resources/user-profiles/read-default-profile.ts
+async function readDefaultProfile(http, listProfiles, options) {
+  const dto = await http.requestJson({
+    method: "GET",
+    path: "/api/v1/user/defaultprofile",
+    signal: options?.signal
+  });
+  if (dto !== null && dto !== void 0) {
+    return projectContactItem(dto);
+  }
+  return (await listProfiles())[0] ?? null;
+}
+
+// ../../src/resources/user-profiles/profile-write-guard.ts
+function assertUsableProfileIds(profiles) {
+  const ids = /* @__PURE__ */ new Set();
+  if (!Array.isArray(profiles) || profiles.length === 0 || profiles.some((profile) => {
+    const id = profile?.id;
+    if (typeof id !== "string" || id.trim().length === 0 || ids.has(id)) {
+      return true;
+    }
+    ids.add(id);
+    return false;
+  })) {
+    throw new TorrowSdkError({
+      category: "InsufficientData" /* InsufficientData */,
+      detail: { domain: "Profiles" /* Profiles */, reason: "UnusableProfileList" /* UnusableProfileList */ }
+    });
+  }
+  return ids;
+}
+function contextualizeProfileWriteError(cause, operation, failureAt, dispatched, effect) {
+  const error = cause instanceof TorrowSdkError ? cause : new TorrowSdkError({
+    category: cause instanceof ProfileListResponseError || failureAt === "ProjectResponse" /* ProjectResponse */ && cause instanceof Error ? "InvalidResponse" /* InvalidResponse */ : "Unknown" /* Unknown */,
+    sensitive: { cause }
+  });
+  const detail = cause instanceof ProfileListResponseError ? {
+    domain: "Profiles" /* Profiles */,
+    reason: failureAt === "ReadProfiles" /* ReadProfiles */ ? "UnusableProfileList" /* UnusableProfileList */ : "UnusableDefault" /* UnusableDefault */
+  } : error.detail?.domain === "Profiles" /* Profiles */ ? error.detail : { domain: "Profiles" /* Profiles */ };
+  const writeState = effect === "Applied" /* Applied */ ? effect : dispatched ? "Unknown" /* Unknown */ : "NotApplied" /* NotApplied */;
+  return error.withContext({
+    detail,
+    operation,
+    failureAt,
+    request: dispatched ? "Started" /* Started */ : "NotStarted" /* NotStarted */,
+    effects: [{ area: "Remote" /* Remote */, step: "Write" /* Write */, state: writeState }]
+  });
+}
+
 // ../../src/resources/user-profiles/ProfilesFacade.ts
 var BASE11 = "/api/v1/user/profiles";
 var ProfilesFacade = class {
@@ -15671,16 +15757,20 @@ var ProfilesFacade = class {
       signal: options?.signal
     });
     if (resp === null || typeof resp !== "object") {
-      throw new Error("GET /api/v1/user/profiles: expected a JSON object body");
+      throw new ProfileListResponseError("GET /api/v1/user/profiles: expected a JSON object body");
     }
     const pl = resp.profileList;
     if (pl === void 0 || pl === null) {
       return projectReadList([], (dto) => projectContactItem(dto));
     }
     if (!Array.isArray(pl)) {
-      throw new Error("GET /api/v1/user/profiles: profileList must be an array when present");
+      throw new ProfileListResponseError("GET /api/v1/user/profiles: profileList must be an array when present");
+    }
+    try {
+      return projectReadList(pl, (dto) => projectContactItem(dto));
+    } catch (cause) {
+      throw new ProfileListResponseError("GET /api/v1/user/profiles: invalid profile projection", cause);
     }
-    return projectReadList(pl, (dto) => projectContactItem(dto));
   }
   /**
    * `POST /api/v1/user/profiles` — создать Профиль по телу **`UserProfileItemForAdd`** (контакт для write + поля Профиля).
@@ -15724,14 +15814,65 @@ var ProfilesFacade = class {
     });
     return unwrapTorrowObjectFromProfilePropertiesUpdate(resp);
   }
-  /** `DELETE /api/v1/user/profiles/{profileId}` — удалить Профиль; возвращает актуальный **`personalContactList`**. */
+  /**
+   * `DELETE /api/v1/user/profiles/{profileId}` — снять связь Профиля, сохранив другой Профиль и выбранный SDK default.
+   * Проверяет список и default до DELETE; fallback default может повторно прочитать список, но первый снимок остаётся условием.
+   * Успех возвращает `personalContactList` как `ContactItem[]`; Contact не удаляется. GET→DELETE не атомарны.
+   * @param profileId Точный ID привязанного Contact; на wire кодируется как сегмент пути.
+   * @param options Общий signal предварительных чтений и целевого DELETE.
+   */
   async remove(profileId, options) {
-    const resp = await this.http.requestJson({
-      method: "DELETE",
-      path: `${BASE11}/${encodePathSegment(profileId)}`,
-      signal: options?.signal
-    });
-    return projectReadList(unwrapRemoveProfileList(resp), (dto) => projectContactItem(dto));
+    let failureAt = "ValidateInput" /* ValidateInput */;
+    let dispatched = false;
+    let effect = "NotApplied" /* NotApplied */;
+    try {
+      if (typeof profileId !== "string" || profileId.trim().length === 0) {
+        throw new TorrowSdkError({ category: "InvalidInput" /* InvalidInput */ });
+      }
+      failureAt = "ReadProfiles" /* ReadProfiles */;
+      const profiles = await this.list(options);
+      failureAt = "ValidateProfiles" /* ValidateProfiles */;
+      const ids = assertUsableProfileIds(profiles);
+      if (!ids.has(profileId)) {
+        throw new TorrowSdkError({
+          category: "InvalidState" /* InvalidState */,
+          detail: { domain: "Profiles" /* Profiles */, reason: "TargetNotProfile" /* TargetNotProfile */ }
+        });
+      }
+      if (profiles.length === 1) {
+        throw new TorrowSdkError({
+          category: "InvalidState" /* InvalidState */,
+          detail: { domain: "Profiles" /* Profiles */, reason: "LastProfile" /* LastProfile */ }
+        });
+      }
+      failureAt = "ReadDefault" /* ReadDefault */;
+      const selected = await readDefaultProfile(this.http, () => this.list(options), options);
+      failureAt = "ValidateDefault" /* ValidateDefault */;
+      if (typeof selected?.id !== "string" || selected.id.trim().length === 0 || !ids.has(selected.id)) {
+        throw new TorrowSdkError({
+          category: "InsufficientData" /* InsufficientData */,
+          detail: { domain: "Profiles" /* Profiles */, reason: "UnusableDefault" /* UnusableDefault */ }
+        });
+      }
+      if (selected.id === profileId) {
+        throw new TorrowSdkError({
+          category: "InvalidState" /* InvalidState */,
+          detail: { domain: "Profiles" /* Profiles */, reason: "SelectedDefault" /* SelectedDefault */ }
+        });
+      }
+      failureAt = "Write" /* Write */;
+      const resp = await this.http.requestJson(
+        { method: "DELETE", path: `${BASE11}/${encodePathSegment(profileId)}`, signal: options?.signal },
+        () => {
+          dispatched = true;
+        }
+      );
+      effect = "Applied" /* Applied */;
+      failureAt = "ProjectResponse" /* ProjectResponse */;
+      return projectReadList(unwrapRemoveProfileList(resp), (dto) => projectContactItem(dto));
+    } catch (cause) {
+      throw contextualizeProfileWriteError(cause, "remove" /* Remove */, failureAt, dispatched, effect);
+    }
   }
 };
 
@@ -16575,6 +16716,113 @@ var LoyaltySystemsFacade = class extends TorrowItemCoreFacade {
   }
 };
 
+// ../../src/resources/loyalty-cards/types.ts
+var LoyaltyCardStateValues = /* @__PURE__ */ ((LoyaltyCardStateValues2) => {
+  LoyaltyCardStateValues2["Unknown"] = "UnknownLoyaltyCardState";
+  LoyaltyCardStateValues2["Issued"] = "Issued";
+  LoyaltyCardStateValues2["Actived"] = "Actived";
+  LoyaltyCardStateValues2["Blocked"] = "Blocked";
+  LoyaltyCardStateValues2["Closed"] = "Closed";
+  return LoyaltyCardStateValues2;
+})(LoyaltyCardStateValues || {});
+
+// ../../src/resources/loyalty-cards/loyalty-card-patch.ts
+function omitLoyaltyCardNumber(body) {
+  const payload = { ...body };
+  Reflect.deleteProperty(payload, "cardNumber");
+  return payload;
+}
+function contactInformation(value) {
+  return isItemPatchDtoObject(value) && Array.isArray(value.fields) && value.fields.length > 0 && value.fields.every(isItemPatchDtoObject);
+}
+function subscriptions(value) {
+  if (!Array.isArray(value)) {
+    return false;
+  }
+  const ids = /* @__PURE__ */ new Set();
+  return value.every((item) => {
+    if (!isItemPatchDtoObject(item) || typeof item.subscriptionId !== "string" || !isItemPatchReferenceId(item.subscriptionId) || ids.has(item.subscriptionId)) {
+      return false;
+    }
+    ids.add(item.subscriptionId);
+    for (const key of ["createDate", "beginDate", "endDate"]) {
+      const date2 = item[key];
+      if (date2 != null && (!(date2 instanceof Date) || !Number.isFinite(date2.getTime()))) {
+        return false;
+      }
+    }
+    if (item.image == null) {
+      return true;
+    }
+    return isItemPatchDtoObject(item.image) && Object.keys(item.image).length === 1 && isItemPatchReferenceId(item.image.id);
+  });
+}
+function createLoyaltyCardPatchAdapter() {
+  let selectedSubscriptionIds;
+  return {
+    operation: "LoyaltyCardsFacade.patch",
+    basePath: "/api/v1/loyaltycards",
+    objectType: TorrowObjectTypeCode.LoyaltyCard,
+    discriminator: "LoyaltyCardItem" /* LoyaltyCardItem */,
+    fields: {
+      contactId: { kind: "String" /* String */, nullable: true, validate: isItemPatchReferenceId },
+      state: {
+        kind: "String" /* String */,
+        validate: (value) => value !== "UnknownLoyaltyCardState" /* Unknown */ && Object.values(LoyaltyCardStateValues).some((state) => state === value)
+      },
+      issueDate: { kind: "Date" /* Date */, nullable: true },
+      expiredDate: { kind: "Date" /* Date */, nullable: true },
+      contactInformation: { kind: "Object" /* Object */, validate: contactInformation },
+      cardIssueInformation: { kind: "Object" /* Object */, nullable: true },
+      allowedReferralProgramIds: {
+        kind: "Array" /* Array */,
+        validate: (value) => Array.isArray(value) && value.every(isItemPatchReferenceId)
+      },
+      subscriptions: { kind: "Array" /* Array */, validate: subscriptions }
+    },
+    validateFields: (fields) => {
+      if (Array.isArray(fields.subscriptions)) {
+        selectedSubscriptionIds = fields.subscriptions.map((item) => item.subscriptionId);
+      }
+    },
+    assertSnapshot: (item) => {
+      if (item.name == null || item.loyaltySystemId == null || item.contactInformation == null) {
+        throw itemPatchError("InsufficientData" /* InsufficientData */);
+      }
+      if (typeof item.name !== "string" || !item.name.length || !isItemPatchReferenceId(item.loyaltySystemId) || !contactInformation(item.contactInformation)) {
+        throw itemPatchError("InvalidResponse" /* InvalidResponse */);
+      }
+      const storedIds = /* @__PURE__ */ new Set();
+      if (item.subscriptions != null) {
+        if (!Array.isArray(item.subscriptions)) {
+          throw itemPatchError("InvalidResponse" /* InvalidResponse */);
+        }
+        for (const subscription of item.subscriptions) {
+          if (!isItemPatchDtoObject(subscription) || typeof subscription.subscriptionId !== "string" || !isItemPatchReferenceId(subscription.subscriptionId) || storedIds.has(subscription.subscriptionId)) {
+            throw itemPatchError("InvalidResponse" /* InvalidResponse */);
+          }
+          storedIds.add(subscription.subscriptionId);
+        }
+      }
+      if (selectedSubscriptionIds?.some((id) => !storedIds.has(id))) {
+        throw itemPatchError("InvalidInput" /* InvalidInput */);
+      }
+    },
+    prepare: (body) => omitLoyaltyCardNumber(body),
+    project: (item) => projectLoyaltyCardItem(item),
+    equalField: (key, before, after) => {
+      if (key !== "subscriptions" || !Array.isArray(before)) {
+        return void 0;
+      }
+      const comparable2 = before.map(
+        (item) => isItemPatchDtoObject(item) && isItemPatchDtoObject(item.image) && isItemPatchReferenceId(item.image.id) ? { ...item, image: { id: item.image.id } } : item
+      );
+      return equalItemPatchValue(comparable2, after);
+    },
+    casRefusal: isItemPatchCasRefusal
+  };
+}
+
 // ../../src/resources/loyalty-cards/LoyaltyCardsFacade.ts
 var BASE18 = "/api/v1/loyaltycards";
 var LOYALTY_CARD_SOCIAL_OPTS = { withGroupListEndpoint: false };
@@ -16587,6 +16835,15 @@ var LoyaltyCardsFacade = class extends TorrowItemCoreFacade {
   constructor(http) {
     super(http, BASE18, LOYALTY_CARD_SOCIAL_OPTS);
   }
+  /**
+   * Изменяет выбранные поля карты через Full GET и максимум один CAS PUT.
+   * Пропуск сохраняет поле; вложенные значения заменяются целиком. Name/image производные.
+   * Номер карты доступен только для чтения. Draft: backend cleanup общего файла шаблона требует live-приёмки. Нет retry/readback.
+   * Effects описывают root write, а не транзакцию файлов, очередей и финансов.
+   */
+  patch(itemId, fields, options) {
+    return patchItem(this.http, itemId, fields, options, createLoyaltyCardPatchAdapter());
+  }
   /**
    * Отображаемый аватар из свежей Full-карточки за один GET; отсутствие → null.
    * Сервер уже применил наследование изображения программы. image/info читает собственный файл карты,
@@ -16618,15 +16875,15 @@ var LoyaltyCardsFacade = class extends TorrowItemCoreFacade {
       validateInput: () => validateFileMetadataId(subscriptionId),
       readItem: (id, readSignal) => this.readFileMetadataItem(id, readSignal),
       selectFile: (item) => {
-        const subscriptions = item.subscriptions;
-        if (subscriptions == null) {
+        const subscriptions2 = item.subscriptions;
+        if (subscriptions2 == null) {
           return null;
         }
-        if (!Array.isArray(subscriptions)) {
+        if (!Array.isArray(subscriptions2)) {
           throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
         }
         const ids = /* @__PURE__ */ new Set();
-        for (const subscription of subscriptions) {
+        for (const subscription of subscriptions2) {
           if (subscription === null || typeof subscription !== "object" || Array.isArray(subscription)) {
             throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
           }
@@ -16642,7 +16899,7 @@ var LoyaltyCardsFacade = class extends TorrowItemCoreFacade {
           }
           ids.add(id);
         }
-        return subscriptions.find((subscription) => subscription.subscriptionId === subscriptionId)?.image;
+        return subscriptions2.find((subscription) => subscription.subscriptionId === subscriptionId)?.image;
       }
     });
   }
@@ -16710,7 +16967,7 @@ var LoyaltyCardsFacade = class extends TorrowItemCoreFacade {
       signal: options?.signal
     }).then((items) => projectReadList(items, (dto) => projectAccountingTransaction(dto)));
   }
-  /** `PUT /api/v1/loyaltycards/{body.id}` */
+  /** `PUT /api/v1/loyaltycards/{body.id}`; server-owned cardNumber исключается из копии тела. */
   update(body, options) {
     const itemId = requireItemUpdateId(body, "Loyalty card");
     return this.http.requestJson({
@@ -16720,7 +16977,7 @@ var LoyaltyCardsFacade = class extends TorrowItemCoreFacade {
         checkVersion: options?.checkVersion,
         isNeedAnnouncement: options?.isNeedAnnouncement
       },
-      body,
+      body: omitLoyaltyCardNumber(body),
       signal: options?.signal
     }).then((dto) => projectLoyaltyCardItem(dto));
   }
@@ -16972,25 +17229,61 @@ var UserFacade = class {
    * @param options Параметры чтения: signal — отмена всей цепочки запросов.
    */
   async getDefaultProfile(options) {
-    const dto = await this.http.requestJson({
-      method: "GET",
-      path: `${BASE20}/defaultprofile`,
-      signal: options?.signal
-    });
-    if (dto !== null && dto !== void 0) {
-      return projectContactItem(dto);
-    }
-    return (await this.profiles.list(options))[0] ?? null;
+    return readDefaultProfile(this.http, () => this.profiles.list(options), options);
   }
-  /** `PUT /api/v1/user/defaultprofile` */
+  /**
+   * `PUT /api/v1/user/defaultprofile` — назначает только Contact, доказанно входящий в Профили учётной записи.
+   * Предварительный список и целевой PUT используют один signal; между ними возможна серверная гонка.
+   * При отказе `TorrowSdkError.effects` описывает только целевой PUT, а не предварительный GET.
+   * @param contactId Точный ID Contact из `profiles.list`; не нормализуется.
+   * @param options Параметры всей цепочки, включая общий signal отмены.
+   */
   async setDefaultProfileByContactId(contactId, options) {
-    const resp = await this.http.requestJson({
-      method: "PUT",
-      path: `${BASE20}/defaultprofile`,
-      body: contactId,
-      signal: options?.signal
-    });
-    return projectContactItem(unwrapAddProfileContact(resp));
+    let failureAt = "ValidateInput" /* ValidateInput */;
+    let dispatched = false;
+    let effect = "NotApplied" /* NotApplied */;
+    try {
+      if (typeof contactId !== "string" || contactId.trim().length === 0) {
+        throw new TorrowSdkError({ category: "InvalidInput" /* InvalidInput */ });
+      }
+      failureAt = "ReadProfiles" /* ReadProfiles */;
+      const profiles = await this.profiles.list(options);
+      failureAt = "ValidateProfiles" /* ValidateProfiles */;
+      const ids = assertUsableProfileIds(profiles);
+      if (!ids.has(contactId)) {
+        throw new TorrowSdkError({
+          category: "InvalidState" /* InvalidState */,
+          detail: { domain: "Profiles" /* Profiles */, reason: "TargetNotProfile" /* TargetNotProfile */ }
+        });
+      }
+      failureAt = "Write" /* Write */;
+      const resp = await this.http.requestJson(
+        { method: "PUT", path: `${BASE20}/defaultprofile`, body: contactId, signal: options?.signal },
+        () => {
+          dispatched = true;
+        }
+      );
+      effect = "Unknown" /* Unknown */;
+      failureAt = "ValidateWriteResponse" /* ValidateWriteResponse */;
+      const profile = resp?.profile;
+      if (!profile || typeof profile !== "object" || Array.isArray(profile) || profile.id !== contactId) {
+        throw new TorrowSdkError({
+          category: "InvalidResponse" /* InvalidResponse */,
+          sensitive: { body: resp }
+        });
+      }
+      effect = "Applied" /* Applied */;
+      failureAt = "ProjectResponse" /* ProjectResponse */;
+      return projectContactItem(profile);
+    } catch (cause) {
+      throw contextualizeProfileWriteError(
+        cause,
+        "setDefaultProfileByContactId" /* SetDefaultProfileByContactId */,
+        failureAt,
+        dispatched,
+        effect
+      );
+    }
   }
   /**
    * `POST /api/v1/user/defaultprofile` — создать и назначить дефолтный профиль.
@@ -18984,6 +19277,7 @@ export {
   LayoutTypeValues,
   LoyaltyCardIssueTypeValues,
   LoyaltyCardSortConditionValues,
+  LoyaltyCardStateValues,
   LoyaltyCardUpdateKeyInformationValues,
   LoyaltyCardUpdateNonKeyInformationValues,
   LoyaltyCardsFacade,
@@ -18995,6 +19289,10 @@ export {
   ParticipationFieldTypeValues,
   PaymentProviderTypeValues,
   PinnedViewsFacade,
+  ProfileEffectStep,
+  ProfileErrorReason,
+  ProfileFailureAt,
+  ProfileOperation,
   ProfileTypeValues,
   ProfilesFacade,
   RawClient,