@torrow/sdk-client 0.21.0 → 0.23.0

package/dist/index.js

@@ -239,7 +239,7 @@ function normalizeTransportError(cause, request, signal, url, parsing = false) {
   if (cause instanceof TorrowSdkError) {
     return cause;
   }
-  const cancelled = signal?.aborted || record(cause)?.name === "AbortError";
+  const cancelled = signal?.aborted || record(cause)?.name === "AbortError" /* Abort */;
   const category = cancelled ? "Cancelled" /* Cancelled */ : parsing ? "InvalidResponse" /* InvalidResponse */ : request === "Started" /* Started */ && cause instanceof TypeError ? "TransportFailure" /* TransportFailure */ : "Unknown" /* Unknown */;
   return new TorrowSdkError({ category, request, sensitive: { cause, url } });
 }
@@ -10269,7 +10269,16 @@ function projectItemPrice(item) {
 
 // ../../src/resources/cases/read-projection.ts
 function projectCaseItem(item) {
-  return projectReadChild(projectItemPrice(projectItemSocial(item)), "personalInfo", projectCasePersonalInfo);
+  const projected = projectReadChild(
+    projectItemPrice(projectItemSocial(item)),
+    "personalInfo",
+    projectCasePersonalInfo
+  );
+  if (projected !== null && typeof projected === "object" && !Array.isArray(projected)) {
+    const { visitCard: _visitCard, ...subject } = projected;
+    return subject;
+  }
+  return projected;
 }
 
 // ../../src/resources/loyalty-cards/read-projection.ts
@@ -10951,6 +10960,21 @@ async function readOptionalFileMetadata(options) {
   }
 }
 
+// ../../src/resources/common/nested-rid-error.ts
+var NestedRidErrorCode = /* @__PURE__ */ ((NestedRidErrorCode2) => {
+  NestedRidErrorCode2["InvalidRid"] = "InvalidRid";
+  return NestedRidErrorCode2;
+})(NestedRidErrorCode || {});
+var NestedRidError = class extends Error {
+  /** Машинная причина отказа; текст `message` остаётся диагностикой для человека. */
+  code;
+  /** Сохраняет прежнее сообщение об ошибке RID и задаёт машинную причину. */
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+};
+
 // ../../src/resources/common/nested-rid.ts
 function ensureNestedRidForWrite(item, path) {
   const { rid: rid2 } = item;
@@ -10959,7 +10983,10 @@ function ensureNestedRidForWrite(item, path) {
     return;
   }
   if (!isValidRid(rid2)) {
-    throw new Error(`Invalid rid for ${path}: expected ${TORROW_OBJECT_ID_HEX_LENGTH} hexadecimal characters`);
+    throw new NestedRidError(
+      "InvalidRid" /* InvalidRid */,
+      `Invalid rid for ${path}: expected ${TORROW_OBJECT_ID_HEX_LENGTH} hexadecimal characters`
+    );
   }
 }
 
@@ -11957,6 +11984,12 @@ function patchPublicMessage(category, failureAt) {
   }
 }
 async function patchItem(http, itemId, fields, options, adapter) {
+  return patchItemCore(http, itemId, fields, options, adapter);
+}
+async function patchDerivedItem(http, itemId, selector, options, adapter) {
+  return patchItemCore(http, itemId, selector, options, adapter, adapter);
+}
+async function patchItemCore(http, itemId, input, options, adapter, derived) {
   let failureAt = "ValidateInput" /* ValidateInput */;
   let effect = "NotApplied" /* NotApplied */;
   const trustedErrors = /* @__PURE__ */ new Set();
@@ -11989,16 +12022,20 @@ async function patchItem(http, itemId, fields, options, adapter) {
     if (expectedVersion !== void 0 && !isVersion(expectedVersion) || Object.hasOwn(opts, "versionToCheck") && expectedVersion === void 0 || signal !== void 0 && !isAbortSignal(signal)) {
       throw localError("InvalidInput" /* InvalidInput */);
     }
-    const selected = copyValue(fields, /* @__PURE__ */ new Set(), [], adapter.ridPaths);
-    if (!isRecord(selected) || Object.keys(selected).length === 0) {
+    const copied = copyValue(input, /* @__PURE__ */ new Set(), [], adapter.ridPaths);
+    if (!isRecord(copied) || !derived && Object.keys(copied).length === 0) {
       throw localError("InvalidInput" /* InvalidInput */);
     }
-    for (const [key, value] of Object.entries(selected)) {
-      if (!Object.hasOwn(adapter.fields, key) || !validField(value, adapter.fields[key])) {
-        throw localError("InvalidInput" /* InvalidInput */);
+    if (derived) {
+      derived.validateSelector(copied);
+    } else {
+      for (const [key, value] of Object.entries(copied)) {
+        if (!Object.hasOwn(adapter.fields, key) || !validField(value, adapter.fields[key])) {
+          throw localError("InvalidInput" /* InvalidInput */);
+        }
       }
+      adapter.validateFields?.(copied);
     }
-    adapter.validateFields?.(selected);
     const readQuery = adapter.readQuery ? { ...adapter.readQuery } : void 0;
     const writeQuery = adapter.writeQuery ? { ...adapter.writeQuery } : void 0;
     if (signal?.aborted) {
@@ -12058,12 +12095,28 @@ async function patchItem(http, itemId, fields, options, adapter) {
     if (signal?.aborted) {
       throw localError("Cancelled" /* Cancelled */);
     }
+    const selected = derived ? await derived.deriveSelectedFields(dto, copied, signal) : copied;
+    if (!isRecord(selected) || Object.keys(selected).length === 0) {
+      throw localError("InvalidInput" /* InvalidInput */);
+    }
+    for (const [key, value] of Object.entries(selected)) {
+      if (!Object.hasOwn(adapter.fields, key) || !validField(value, adapter.fields[key])) {
+        throw localError("InvalidInput" /* InvalidInput */);
+      }
+    }
+    if (derived) {
+      adapter.validateFields?.(selected);
+    }
+    if (signal?.aborted) {
+      throw localError("Cancelled" /* Cancelled */);
+    }
+    Object.assign(selected, adapter.deriveFields?.(dto, selected));
     const unchanged = Object.entries(selected).every(([key, value]) => {
       const equal = adapter.equalField?.(key, dto[key], value, dto);
       if (equal !== void 0) {
         return equal;
       }
-      if (adapter.fields[key].kind === "Image" /* Image */ && isRecord(dto[key]) && isRecord(value)) {
+      if (adapter.fields[key]?.kind === "Image" /* Image */ && isRecord(dto[key]) && isRecord(value)) {
         return dto[key].id === value.id;
       }
       return equalItemPatchValue(dto[key], value);
@@ -12112,6 +12165,7 @@ async function patchItem(http, itemId, fields, options, adapter) {
     if (!isRecord(ack) || ack.id !== itemId) {
       throw localError("InvalidResponse" /* InvalidResponse */);
     }
+    adapter.assertAck?.(ack, prepared);
     effect = "Applied" /* Applied */;
     failureAt = "ProjectResult" /* ProjectResult */;
     return { itemId, item: projectItem(ack, adapter.project), changed: true };
@@ -12414,32 +12468,6 @@ function validateItemPricePatch(fields) {
   }
 }
 
-// ../../src/resources/cases/types.ts
-var CaseStateValues = {
-  Unknown: "UnknownCaseState",
-  Verifying: "Verifying",
-  Waiting: "Waiting",
-  Processing: "Processing",
-  Preparing: "Preparing",
-  Completed: "Completed",
-  Closed: "Closed",
-  Rejected: "Rejected",
-  Canceled: "Canceled",
-  TimeControlled: "TimeControlled",
-  TaskNotCompleted: "TaskNotCompleted",
-  TaskCompleted: "TaskCompleted"
-};
-var CaseTypeValues = {
-  Unknown: "UnknownTimeType",
-  Time: "Time",
-  RepeatedTime: "RepeatedTime",
-  Today: "Today",
-  Week: "Week",
-  Later: "Later",
-  Date: "Date",
-  State: "State"
-};
-
 // ../../src/resources/common/item-patch-predicates.ts
 function isItemPatchDtoObject(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date);
@@ -12504,6 +12532,57 @@ function normalizeCaseActionRidsForWrite(body, path) {
   });
 }
 
+// ../../src/resources/cases/types.ts
+var CaseStateValues = {
+  Unknown: "UnknownCaseState",
+  Verifying: "Verifying",
+  Waiting: "Waiting",
+  Processing: "Processing",
+  Preparing: "Preparing",
+  Completed: "Completed",
+  Closed: "Closed",
+  Rejected: "Rejected",
+  Canceled: "Canceled",
+  TimeControlled: "TimeControlled",
+  TaskNotCompleted: "TaskNotCompleted",
+  TaskCompleted: "TaskCompleted"
+};
+var CaseTypeValues = {
+  Unknown: "UnknownTimeType",
+  Time: "Time",
+  RepeatedTime: "RepeatedTime",
+  Today: "Today",
+  Week: "Week",
+  Later: "Later",
+  Date: "Date",
+  State: "State"
+};
+
+// ../../src/resources/cases/case-create-visit-card.ts
+function isValidCaseCardType(value) {
+  return value !== CaseTypeValues.Unknown && Object.values(CaseTypeValues).some((type) => type === value);
+}
+function createCaseVisitCard(source) {
+  const { name, caseType, beginDate, endDate, place, description } = source;
+  return {
+    fields: [
+      { number: 0, value: name ?? "", expression: JSON.stringify({ type: "Name" /* Name */ }) },
+      {
+        number: 1,
+        value: caseType,
+        expression: JSON.stringify({ type: "CaseType" /* CaseType */, caseType, beginDate, endDate })
+      },
+      {
+        number: 2,
+        value: (place ? place : description) ?? "",
+        expression: JSON.stringify({
+          type: place ? "PlaceAddress" /* PlaceAddress */ : "Description" /* Description */
+        })
+      }
+    ]
+  };
+}
+
 // ../../src/resources/cases/case-patch.ts
 function optionalDate2(value) {
   return value == null || value instanceof Date && Number.isFinite(value.getTime());
@@ -12511,19 +12590,6 @@ function optionalDate2(value) {
 function appendices(value) {
   return isItemPatchObjectArray(value) && value.every((item) => optionalDate2(item.openDate) && optionalDate2(item.closeDate));
 }
-function visitCard(value) {
-  if (!isItemPatchDtoObject(value) || Object.keys(value).some((key) => key !== "fields")) {
-    return false;
-  }
-  if (value.fields == null) {
-    return true;
-  }
-  return Array.isArray(value.fields) && value.fields.every(
-    (field) => isItemPatchDtoObject(field) && Object.entries(field).every(
-      ([key, member]) => key === "number" ? isItemPatchInt32(member) : (key === "value" || key === "expression") && (member === null || typeof member === "string")
-    )
-  );
-}
 function checkinPermission(value) {
   return isItemPatchDtoObject(value) && Object.entries(value).every(
     ([key, member]) => key === "userAccessLevel" ? Object.values(UserAccessLevelValues).some((level) => level === member) : key === "consumerMinTimeSecBetweenCasesInService" && (member === null || isItemPatchInt32(member))
@@ -12546,7 +12612,7 @@ function createCasePatchAdapter() {
       clientGroupId: { kind: "String" /* String */, nullable: true, validate: isItemPatchReferenceId },
       caseType: {
         kind: "String" /* String */,
-        validate: (value) => value !== CaseTypeValues.Unknown && Object.values(CaseTypeValues).some((type) => type === value)
+        validate: isValidCaseCardType
       },
       schedule: { kind: "Object" /* Object */, nullable: true, validate: isItemPatchSchedule },
       registrationOpen: { kind: "Integer" /* Integer */, nullable: true, validate: isItemPatchInt32 },
@@ -12565,7 +12631,6 @@ function createCasePatchAdapter() {
       createSingleCases: { kind: "Boolean" /* Boolean */, nullable: true },
       checkinPermission: { kind: "Object" /* Object */, nullable: true, validate: checkinPermission },
       participateFieldRequirements: { kind: "Object" /* Object */, nullable: true },
-      visitCard: { kind: "Object" /* Object */, validate: visitCard },
       appendixList: { kind: "Array" /* Array */, nullable: true, validate: appendices },
       resourceGroupList: { kind: "Array" /* Array */, nullable: true, validate: isItemPatchObjectArray },
       caseActionList: { kind: "Array" /* Array */, nullable: true, validate: isItemPatchObjectArray },
@@ -12581,6 +12646,18 @@ function createCasePatchAdapter() {
         throw itemPatchError("InvalidInput" /* InvalidInput */);
       }
     },
+    deriveFields: (dto, selected) => {
+      const final = { ...dto, ...selected };
+      if (!isValidCaseCardType(final.caseType)) {
+        throw itemPatchError("InsufficientData" /* InsufficientData */);
+      }
+      return { visitCard: createCaseVisitCard(final) };
+    },
+    assertAck: (ack, written) => {
+      if (!equalItemPatchValue(ack.visitCard, written.visitCard)) {
+        throw itemPatchError("InvalidResponse" /* InvalidResponse */);
+      }
+    },
     project: (item) => projectCaseItem(item),
     casRefusal: isItemPatchCasRefusal
   };
@@ -12615,6 +12692,20 @@ function cancelCaseParticipation(http, torrowId, body, options) {
 
 // ../../src/resources/cases/CasesFacade.ts
 var BASE3 = "/api/v1/cases";
+var CARD_SOURCE_FIELDS = /* @__PURE__ */ new Set(["visitCard", "name", "caseType", "beginDate", "endDate", "place", "description"]);
+function affectsCaseCard(pointer) {
+  if (typeof pointer !== "string" || pointer === "") {
+    return true;
+  }
+  if (!pointer.startsWith("/")) {
+    return true;
+  }
+  const first = pointer.slice(1).split("/")[0];
+  if (/~(?![01])/.test(first)) {
+    return true;
+  }
+  return CARD_SOURCE_FIELDS.has(first.replace(/~1/g, "/").replace(/~0/g, "~"));
+}
 var CasesFacade = class extends TorrowItemFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.Case;
   /** Чтение полной карточки для метаданных без дочерних данных. */
@@ -12678,7 +12769,11 @@ var CasesFacade = class extends TorrowItemFacade {
   /** `PUT /api/v1/cases/{body.id}` */
   update(body, options) {
     const itemId = requireItemUpdateId(body, "Case");
+    if (!isValidCaseCardType(body.caseType)) {
+      throw new TorrowSdkError({ category: "InvalidInput" /* InvalidInput */ });
+    }
     const payload = structuredClone(body);
+    payload.visitCard = createCaseVisitCard(payload);
     normalizeItemScheduleRidsForWrite(payload, "case");
     normalizeCaseActionRidsForWrite(payload, "case");
     return this.http.requestJson({
@@ -12692,26 +12787,24 @@ var CasesFacade = class extends TorrowItemFacade {
       },
       body: payload,
       signal: options?.signal
-    }).then((dto) => projectCaseItem(dto));
+    }).then((dto) => {
+      if (dto === null || typeof dto !== "object" || Array.isArray(dto) || dto.id !== itemId || !equalItemPatchValue(dto.visitCard, payload.visitCard)) {
+        throw new TorrowSdkError({ category: "InvalidResponse" /* InvalidResponse */ });
+      }
+      return projectCaseItem(dto);
+    });
   }
   withCreateDefaults(body, publicityType) {
     const payload = applyItemCreateDefaults(structuredClone(body), "CaseItem" /* CaseItem */, publicityType);
     const prepared = {
       ...payload,
       caseState: payload.caseState ?? CaseStateValues.Verifying,
-      caseType: payload.caseType ?? CaseTypeValues.Time,
-      // Сервер отклоняет create без VisitCard («Parameter VisitCard cannot have value null»).
-      visitCard: payload.visitCard ?? {
-        fields: [
-          { number: 0, value: payload.name ?? "", expression: '{"type":"Name"}' },
-          { number: 1, value: "", expression: null },
-          { number: 2, value: "", expression: null }
-        ]
-      }
+      caseType: payload.caseType ?? CaseTypeValues.Time
     };
-    normalizeItemScheduleRidsForWrite(prepared, "case");
-    normalizeCaseActionRidsForWrite(prepared, "case");
-    return prepared;
+    const withCard = { ...prepared, visitCard: createCaseVisitCard(prepared) };
+    normalizeItemScheduleRidsForWrite(withCard, "case");
+    normalizeCaseActionRidsForWrite(withCard, "case");
+    return withCard;
   }
   /** `DELETE /api/v1/cases/{torrowId}` */
   async delete(torrowId, options) {
@@ -12980,6 +13073,11 @@ var CasesFacade = class extends TorrowItemFacade {
   }
   /** `POST /api/v1/cases/{torrowId}/patch` */
   patchCase(torrowId, body, options) {
+    if (!Array.isArray(body?.patchDoc?.operations) || body.patchDoc.operations.some(
+      (operation) => affectsCaseCard(operation.path) || operation.from != null && affectsCaseCard(operation.from)
+    )) {
+      throw new TorrowSdkError({ category: "InvalidInput" /* InvalidInput */ });
+    }
     return this.http.requestJson({
       method: "POST",
       path: `${BASE3}/${encodePathSegment(torrowId)}/patch`,
@@ -13050,11 +13148,11 @@ function contactVisitCardDefaultSlot0Value(body) {
   return trimNonEmptyString(body.company) ?? "";
 }
 function normalizeContactVisitCardFieldsForWrite(body) {
-  let visitCard3 = body.visitCard;
-  if (visitCard3 === void 0 || visitCard3 === null || typeof visitCard3 !== "object" || Array.isArray(visitCard3)) {
-    visitCard3 = {};
+  let visitCard2 = body.visitCard;
+  if (visitCard2 === void 0 || visitCard2 === null || typeof visitCard2 !== "object" || Array.isArray(visitCard2)) {
+    visitCard2 = {};
   }
-  let incoming = Array.isArray(visitCard3.fields) ? visitCard3.fields : [];
+  let incoming = Array.isArray(visitCard2.fields) ? visitCard2.fields : [];
   if (incoming.length === 0) {
     incoming = [
       {
@@ -13082,7 +13180,7 @@ function normalizeContactVisitCardFieldsForWrite(body) {
   for (let i = 0; i < CONTACT_VISIT_CARD_SLOT_COUNT; i++) {
     fields.push(picked[i] ?? { number: i, value: "" });
   }
-  body.visitCard = { ...visitCard3, fields };
+  body.visitCard = { ...visitCard2, fields };
 }
 
 // ../../src/resources/contacts/types.ts
@@ -13170,7 +13268,7 @@ var memorableDateShape = {
   order: integer
 };
 var file = (value) => shape(value, { id: (value2) => typeof value2 === "string" && value2.length > 0 }) && record4(value) && Object.hasOwn(value, "id");
-var visitCard2 = (value) => shape(value, {
+var visitCard = (value) => shape(value, {
   fields: nullable(
     (value2) => Array.isArray(value2) && value2.every((child) => shape(child, { number: integer, value: nullable(text), expression: nullable(text) }))
   )
@@ -13247,7 +13345,7 @@ function createContactPatchAdapter() {
         validate: arrayOf((value) => shape(value, memorableDateShape))
       },
       photos: { kind: "Array" /* Array */, nullable: true, validate: arrayOf(file) },
-      visitCard: { kind: "Object" /* Object */, validate: visitCard2 }
+      visitCard: { kind: "Object" /* Object */, validate: visitCard }
     },
     validateFields(fields) {
       selected = structuredClone(fields);
@@ -14487,6 +14585,9 @@ var resourceItemPatchFields = {
     kind: "String" /* String */,
     validate: (value) => Object.values(UsageTypeValues).some((type) => type === value)
   },
+  // Это полная замена списка. Нельзя собирать одно изменение связи снаружи и передавать
+  // сюда массив: внутренний GET/CAS не защитит изменения между внешним и внутренним чтением.
+  // upsertServiceLink/removeServiceLink вычисляют список из собственного raw GET.
   serviceDescriptions: { kind: "Array" /* Array */, validate: isItemPatchObjectArray },
   code: { kind: "String" /* String */, nullable: true },
   duration: { kind: "Integer" /* Integer */, nullable: true, validate: isItemPatchInt32 },
@@ -14525,6 +14626,225 @@ function createResourcePatchAdapter(project) {
   };
 }
 
+// ../../src/resources/resources/resource-service-link.ts
+var preservedRootFields = [
+  "name",
+  "description",
+  "contactId",
+  "parentResourceId",
+  "calendarId",
+  "itemId",
+  "timetableId",
+  "schedule",
+  "priceInfo",
+  "usageType",
+  "code",
+  "duration",
+  "amountProperties",
+  "usageCondition",
+  "appendixList",
+  "paymentProperties",
+  "ticketProperties",
+  "loyaltyTransactionPropertiesList",
+  "tags",
+  "uniqueName",
+  "image",
+  "publicityType",
+  "searchMode",
+  "anyoneAccess",
+  "feedbackOptions",
+  "integrationIds"
+];
+function invalidInput() {
+  throw itemPatchError("InvalidInput" /* InvalidInput */);
+}
+function insufficientData() {
+  throw itemPatchError("InsufficientData" /* InsufficientData */);
+}
+function invalidResponse() {
+  throw itemPatchError("InvalidResponse" /* InvalidResponse */);
+}
+function validateSelector(selector) {
+  if (Object.keys(selector).some((key) => !["action", "serviceId", "resourceGroupId", "fields"].includes(key))) {
+    invalidInput();
+  }
+  if (selector.action !== "Upsert" /* Upsert */ && selector.action !== "Remove" /* Remove */) {
+    invalidInput();
+  }
+  try {
+    if (getTorrowObjectTypeFromTorrowId(selector.serviceId) !== "Service") {
+      invalidInput();
+    }
+  } catch {
+    invalidInput();
+  }
+  if (typeof selector.resourceGroupId !== "string" || selector.resourceGroupId.length === 0) {
+    invalidInput();
+  }
+  if (selector.fields === null || typeof selector.fields !== "object" || Array.isArray(selector.fields)) {
+    invalidInput();
+  }
+  if (selector.action === "Remove" /* Remove */ && Object.keys(selector.fields).length > 0) {
+    invalidInput();
+  }
+  for (const [key, value] of Object.entries(selector.fields)) {
+    if (key === "usageAmount") {
+      if (value !== null && (typeof value !== "number" || !Number.isFinite(value))) {
+        invalidInput();
+      }
+    } else if (key === "sortIndex") {
+      if (value !== null && (typeof value !== "number" || !Number.isInteger(value) || value < -2147483648 || value > 2147483647)) {
+        invalidInput();
+      }
+    } else {
+      invalidInput();
+    }
+  }
+}
+function checkedDescriptions(dto) {
+  const list = dto.serviceDescriptions;
+  if (list == null || Array.isArray(list) && list.length === 0) {
+    insufficientData();
+  }
+  if (!Array.isArray(list)) {
+    invalidResponse();
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const binding of list) {
+    if (binding === null || typeof binding !== "object" || Array.isArray(binding) || typeof binding.id !== "string" || typeof binding.resourceGroupId !== "string" || binding.resourceGroupId.length === 0) {
+      invalidResponse();
+    }
+    try {
+      if (getTorrowObjectTypeFromTorrowId(binding.id) !== "Service") {
+        invalidResponse();
+      }
+    } catch {
+      invalidResponse();
+    }
+    if (binding.serviceName != null && typeof binding.serviceName !== "string" || binding.resourceGroupName != null && typeof binding.resourceGroupName !== "string" || binding.laterBinding != null && typeof binding.laterBinding !== "boolean" || binding.usageAmount != null && (typeof binding.usageAmount !== "number" || !Number.isFinite(binding.usageAmount)) || binding.sortIndex != null && (typeof binding.sortIndex !== "number" || !Number.isInteger(binding.sortIndex) || binding.sortIndex < -2147483648 || binding.sortIndex > 2147483647)) {
+      invalidResponse();
+    }
+    const pair = `${binding.id.length}:${binding.id}${binding.resourceGroupId}`;
+    if (seen.has(pair)) {
+      invalidResponse();
+    }
+    seen.add(pair);
+  }
+  return list;
+}
+function samePair(binding, selector) {
+  return binding.id === selector.serviceId && binding.resourceGroupId === selector.resourceGroupId;
+}
+async function changeResourceServiceLink(http, project, resourceId, selector, options) {
+  let before;
+  let expected;
+  let acknowledged;
+  const adapter = createResourcePatchAdapter(project);
+  const result = await patchDerivedItem(http, resourceId, selector, options, {
+    ...adapter,
+    operation: selector.action === "Upsert" /* Upsert */ ? "ResourcesFacade.upsertServiceLink" : "ResourcesFacade.removeServiceLink",
+    validateSelector,
+    async deriveSelectedFields(dto, selected, signal) {
+      const list2 = checkedDescriptions(dto);
+      before = dto;
+      const at = list2.findIndex((binding) => samePair(binding, selected));
+      if (selected.action === "Remove" /* Remove */) {
+        if (at < 0) {
+          expected = list2;
+          return { serviceDescriptions: list2 };
+        }
+        if (list2.length === 1) {
+          insufficientData();
+        }
+        expected = list2.filter((_, index) => index !== at);
+        return { serviceDescriptions: expected };
+      }
+      if (signal?.aborted) {
+        throw itemPatchError("Cancelled" /* Cancelled */);
+      }
+      const service = await http.requestJson({
+        method: "GET",
+        path: `/api/v1/services/${encodePathSegment(selected.serviceId)}`,
+        signal
+      });
+      if (service === null || typeof service !== "object" || Array.isArray(service) || service.id !== selected.serviceId) {
+        invalidResponse();
+      }
+      const groups = service.resourceGroupList;
+      if (!Array.isArray(groups)) {
+        insufficientData();
+      }
+      const matchingGroups = groups.filter((item) => item?.groupId === selected.resourceGroupId);
+      if (matchingGroups.length > 1) {
+        invalidResponse();
+      }
+      const group = matchingGroups[0];
+      if (!group || typeof group.usageType !== "string" || group.usageType.length === 0 || typeof group.groupName !== "string" || typeof service.name !== "string") {
+        insufficientData();
+      }
+      if (group.usageType === UsageTypeValues.Unknown || !Object.values(UsageTypeValues).some((value) => value === group.usageType)) {
+        invalidResponse();
+      }
+      if (dto.usageType !== group.usageType) {
+        invalidInput();
+      }
+      const next = [...list2];
+      if (at < 0) {
+        next.push({
+          id: selected.serviceId,
+          resourceGroupId: selected.resourceGroupId,
+          serviceName: service.name,
+          resourceGroupName: group.groupName,
+          laterBinding: group.bookingProperties != null,
+          ...selected.fields
+        });
+      } else {
+        next[at] = { ...list2[at], ...selected.fields };
+      }
+      expected = next;
+      return { serviceDescriptions: next };
+    },
+    assertAck(ack, written) {
+      if (!before || !expected || !Array.isArray(ack.serviceDescriptions) || !equalItemPatchValue(ack.serviceDescriptions, expected) || !Number.isInteger(ack.meta?.version) || (ack.meta?.version ?? 0) <= 0) {
+        invalidResponse();
+      }
+      const rawAck = ack;
+      const rawWritten = written;
+      for (const key of preservedRootFields) {
+        if (Object.hasOwn(before, key) && !equalItemPatchValue(rawAck[key], rawWritten[key])) {
+          invalidResponse();
+        }
+      }
+      acknowledged = ack.serviceDescriptions;
+    }
+  });
+  const list = result.changed ? acknowledged : before.serviceDescriptions;
+  return {
+    ...result,
+    serviceId: selector.serviceId,
+    resourceGroupId: selector.resourceGroupId,
+    binding: list.find((binding) => samePair(binding, selector)) ?? null
+  };
+}
+function upsertResourceServiceLink(http, project, resourceId, serviceId, resourceGroupId, fields, options) {
+  return changeResourceServiceLink(
+    http,
+    project,
+    resourceId,
+    { action: "Upsert" /* Upsert */, serviceId, resourceGroupId, fields },
+    options
+  );
+}
+function removeResourceServiceLink(http, project, resourceId, serviceId, resourceGroupId, options) {
+  return changeResourceServiceLink(
+    http,
+    project,
+    resourceId,
+    { action: "Remove" /* Remove */, serviceId, resourceGroupId, fields: {} },
+    options
+  );
+}
+
 // ../../src/resources/resources/ResourcesFacade.ts
 var BASE7 = "/api/v1/resources";
 var ResourcesFacade = class extends TorrowItemFacade {
@@ -14555,6 +14875,35 @@ var ResourcesFacade = class extends TorrowItemFacade {
       createResourcePatchAdapter((item) => this.toSdkResourceItem(item))
     );
   }
+  /**
+   * Адресно добавляет или изменяет одну связь при полном непустом списке.
+   * Предполагается, что Service не изменяется в течение вызова; CAS защищает Resource.
+   * Серверный отказ проверки Service при PUT передаётся как TorrowSdkError с HTTP-данными.
+   * Проверка Service не атомарна с записью Resource.
+   * При неизвестном результате PUT требуется отдельная сверка, автоматического повтора нет.
+   */
+  upsertServiceLink(resourceId, serviceId, resourceGroupId, fields, options) {
+    return upsertResourceServiceLink(
+      this.http,
+      (item) => this.toSdkResourceItem(item),
+      resourceId,
+      serviceId,
+      resourceGroupId,
+      fields,
+      options
+    );
+  }
+  /** Удаляет одну связь, если после неё остаётся непустой подтверждённый список. */
+  removeServiceLink(resourceId, serviceId, resourceGroupId, options) {
+    return removeResourceServiceLink(
+      this.http,
+      (item) => this.toSdkResourceItem(item),
+      resourceId,
+      serviceId,
+      resourceGroupId,
+      options
+    );
+  }
   /** Поиск по уникальному имени возвращает ту же модель ресурса, что и getById. */
   getByUniqueName(uniqueName, options) {
     return this.readByUniqueName(uniqueName, options).then((item) => this.toSdkResourceItem(item));
@@ -15529,11 +15878,13 @@ var ServicesFacade = class extends TorrowItemFacade {
   }
   /** `POST /api/v1/services/{serviceId}/session` — создать сессию записи (тело `CaseItem`). */
   createSession(serviceId, body, options) {
+    const payload = { ...structuredClone(body), caseType: body.caseType ?? CaseTypeValues.Time };
+    payload.visitCard = createCaseVisitCard(payload);
     return this.http.requestJson({
       method: "POST",
       path: `${BASE9}/${encodePathSegment(serviceId)}/session`,
       query: { profileId: options?.profileId },
-      body,
+      body: payload,
       signal: options?.signal
     }).then((dto) => projectCaseItem(dto));
   }
@@ -18659,6 +19010,30 @@ function getTimeStepUiMode(session) {
   return TimeStepUiModeValues.SelectTime;
 }
 
+// ../../src/resources/services/service-builder-error.ts
+var ServiceBuilderErrorCode = /* @__PURE__ */ ((ServiceBuilderErrorCode2) => {
+  ServiceBuilderErrorCode2["InvalidConfiguration"] = "InvalidConfiguration";
+  return ServiceBuilderErrorCode2;
+})(ServiceBuilderErrorCode || {});
+var ServiceBuilderError = class extends TypeError {
+  /** Стабильная машинная причина отказа конфигурации. */
+  code;
+  /** Создаёт локальный отказ с прежним сообщением и машинным кодом. */
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+};
+var ServiceBuilderRangeError = class extends RangeError {
+  /** Стабильная машинная причина отказа числового диапазона. */
+  code;
+  /** Создаёт локальный отказ диапазона с прежним сообщением и машинным кодом. */
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+};
+
 // ../../src/resources/services/service-builder.ts
 var RESOURCE_USAGE_TYPES = /* @__PURE__ */ new Set(["Specification", "Rent", "Sale"]);
 var GROUP_ID_PATTERN = /^[0-9a-f]{24}$/i;
@@ -18714,7 +19089,10 @@ function assertStepPosition(position, length) {
     return length + 1;
   }
   if (!Number.isInteger(position) || position < 1 || position > length + 1) {
-    throw new RangeError(`stepOrder must be an integer from 1 to ${length + 1}`);
+    throw new ServiceBuilderRangeError(
+      "InvalidConfiguration" /* InvalidConfiguration */,
+      `stepOrder must be an integer from 1 to ${length + 1}`
+    );
   }
   return position;
 }
@@ -18734,14 +19112,18 @@ var ServiceBuilder = class _ServiceBuilder {
   }
   withType(type, options) {
     if (type === ServiceType.Custom) {
-      throw new TypeError("ServiceType.Custom requires explicit sessionDurationProperties");
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        "ServiceType.Custom requires explicit sessionDurationProperties"
+      );
     }
     this.draft.sessionDurationProperties = createServiceSessionDurationProperties(type, options);
     return this;
   }
   withSessionDurationProperties(properties) {
     if (!properties.sessionDurationType || !SESSION_DURATION_TYPES.has(properties.sessionDurationType) || !properties.timeSelectionType || !TIME_SELECTION_TYPES.has(properties.timeSelectionType) || !properties.stateManagementType || !STATE_MANAGEMENT_TYPES.has(properties.stateManagementType)) {
-      throw new TypeError(
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
         "sessionDurationProperties must include sessionDurationType, timeSelectionType, and stateManagementType"
       );
     }
@@ -18750,12 +19132,18 @@ var ServiceBuilder = class _ServiceBuilder {
   }
   addResourceStep(input) {
     if (!RESOURCE_USAGE_TYPES.has(input.usageType)) {
-      throw new TypeError(`Unsupported resource group usageType: ${String(input.usageType)}`);
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        `Unsupported resource group usageType: ${String(input.usageType)}`
+      );
     }
     const minResources = input.minResources ?? 1;
     const maxResources = input.maxResources ?? 1;
     if (input.autoChoiceResource === true && (minResources !== 1 || maxResources !== 1)) {
-      throw new RangeError("autoChoiceResource requires exactly one resource");
+      throw new ServiceBuilderRangeError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        "autoChoiceResource requires exactly one resource"
+      );
     }
     const group = this.addResourceGroup(input, input.usageType);
     const groupId = group.groupId;
@@ -18793,18 +19181,27 @@ var ServiceBuilder = class _ServiceBuilder {
   setResourceGroupResourceIds(resourceGroupId, resourceIds) {
     const normalizedGroupId = resourceGroupId.trim();
     if (!normalizedGroupId) {
-      throw new TypeError("resourceGroupId must not be empty");
+      throw new ServiceBuilderError("InvalidConfiguration" /* InvalidConfiguration */, "resourceGroupId must not be empty");
     }
     const normalizedResourceIds = resourceIds.map((resourceId) => resourceId.trim());
     if (normalizedResourceIds.some((resourceId) => !resourceId)) {
-      throw new TypeError("resourceIds must not contain empty ids");
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        "resourceIds must not contain empty ids"
+      );
     }
     if (new Set(normalizedResourceIds).size !== normalizedResourceIds.length) {
-      throw new TypeError("resourceIds must not contain duplicates");
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        "resourceIds must not contain duplicates"
+      );
     }
     const groups = this.draft.resourceGroupList ?? [];
     if (!groups.some((group) => group.groupId === normalizedGroupId)) {
-      throw new TypeError(`Service resource group not found: ${normalizedGroupId}`);
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        `Service resource group not found: ${normalizedGroupId}`
+      );
     }
     this.draft.resourceGroupList = groups.map(
       (group) => group.groupId === normalizedGroupId ? { ...group, resourceIdList: [...normalizedResourceIds] } : group
@@ -18833,7 +19230,10 @@ var ServiceBuilder = class _ServiceBuilder {
   }
   addSingletonStep(stepType, stepOrder) {
     if (this.draft.stepDescriptionList?.some((step) => step.stepType === stepType)) {
-      throw new TypeError(`Service already contains step type ${stepType}`);
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        `Service already contains step type ${stepType}`
+      );
     }
     this.insertStep({ stepType }, stepOrder);
     return this;
@@ -18842,21 +19242,36 @@ var ServiceBuilder = class _ServiceBuilder {
     const key = input.key.trim();
     const groupName = input.groupName.trim();
     if (!key) {
-      throw new TypeError("Resource group key must not be empty");
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        "Resource group key must not be empty"
+      );
     }
     if (!groupName) {
-      throw new TypeError("Resource group name must not be empty");
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        "Resource group name must not be empty"
+      );
     }
     if (this.addedGroups.has(key)) {
-      throw new TypeError(`Duplicate resource group key: ${key}`);
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        `Duplicate resource group key: ${key}`
+      );
     }
     const groupId = input.groupId ?? generateServiceResourceGroupId();
     if (!GROUP_ID_PATTERN.test(groupId)) {
-      throw new TypeError("Resource group id must be a 24-character hexadecimal string");
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        "Resource group id must be a 24-character hexadecimal string"
+      );
     }
     const groups = [...this.draft.resourceGroupList ?? []];
     if (groups.some((group2) => group2.groupId === groupId)) {
-      throw new TypeError(`Duplicate resource group id: ${groupId}`);
+      throw new ServiceBuilderError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        `Duplicate resource group id: ${groupId}`
+      );
     }
     const minResources = input.minResources ?? 1;
     const maxResources = input.maxResources ?? 1;
@@ -18866,11 +19281,17 @@ var ServiceBuilder = class _ServiceBuilder {
       ["maxTotalAmount", input.maxTotalAmount]
     ]) {
       if (value != null && (!Number.isInteger(value) || value < 0)) {
-        throw new RangeError(`${name} must be a non-negative integer`);
+        throw new ServiceBuilderRangeError(
+          "InvalidConfiguration" /* InvalidConfiguration */,
+          `${name} must be a non-negative integer`
+        );
       }
     }
     if (minResources > maxResources) {
-      throw new RangeError("minResources must not exceed maxResources");
+      throw new ServiceBuilderRangeError(
+        "InvalidConfiguration" /* InvalidConfiguration */,
+        "minResources must not exceed maxResources"
+      );
     }
     const group = {
       groupId,
@@ -18923,10 +19344,16 @@ var ServiceBuilder = class _ServiceBuilder {
     const ids = /* @__PURE__ */ new Set();
     for (const group of groups) {
       if (!group.groupId || !GROUP_ID_PATTERN.test(group.groupId)) {
-        throw new TypeError("Every resource group must have a valid 24-character hexadecimal id");
+        throw new ServiceBuilderError(
+          "InvalidConfiguration" /* InvalidConfiguration */,
+          "Every resource group must have a valid 24-character hexadecimal id"
+        );
       }
       if (ids.has(group.groupId)) {
-        throw new TypeError(`Duplicate resource group id: ${group.groupId}`);
+        throw new ServiceBuilderError(
+          "InvalidConfiguration" /* InvalidConfiguration */,
+          `Duplicate resource group id: ${group.groupId}`
+        );
       }
       ids.add(group.groupId);
     }
@@ -18937,10 +19364,16 @@ var ServiceBuilder = class _ServiceBuilder {
       }
       const groupId = getResourceGroupIdFromStep(step);
       if (!groupId || !ids.has(groupId)) {
-        throw new TypeError(`Resource step references an unknown resource group: ${groupId ?? ""}`);
+        throw new ServiceBuilderError(
+          "InvalidConfiguration" /* InvalidConfiguration */,
+          `Resource step references an unknown resource group: ${groupId ?? ""}`
+        );
       }
       if (usedIds.has(groupId)) {
-        throw new TypeError(`Resource group is used by more than one step: ${groupId}`);
+        throw new ServiceBuilderError(
+          "InvalidConfiguration" /* InvalidConfiguration */,
+          `Resource group is used by more than one step: ${groupId}`
+        );
       }
       usedIds.add(groupId);
     }
@@ -19061,6 +19494,21 @@ function getTicketPaymentUrl(caseItem) {
   return normalizePaymentUrl(getTicketPaymentUrlRaw(caseItem));
 }
 
+// ../../src/resources/resources/resource-builder-error.ts
+var ResourceBuilderErrorCode = /* @__PURE__ */ ((ResourceBuilderErrorCode2) => {
+  ResourceBuilderErrorCode2["InvalidServiceLink"] = "InvalidServiceLink";
+  return ResourceBuilderErrorCode2;
+})(ResourceBuilderErrorCode || {});
+var ResourceBuilderError = class extends TypeError {
+  /** Стабильная машинная причина отказа связи. */
+  code;
+  /** Сохраняет прежний текст TypeError и предоставляет машинный код. */
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+};
+
 // ../../src/resources/resources/resource-builder.ts
 function cloneValue2(value) {
   if (value instanceof Date) {
@@ -19096,21 +19544,30 @@ var ResourceBuilder = class _ResourceBuilder {
   attachToService(service, resourceGroupId, options) {
     const serviceId = service.id?.trim();
     if (!serviceId) {
-      throw new TypeError("Service must have a non-empty id");
+      throw new ResourceBuilderError("InvalidServiceLink" /* InvalidServiceLink */, "Service must have a non-empty id");
     }
     const normalizedGroupId = resourceGroupId.trim();
     if (!normalizedGroupId) {
-      throw new TypeError("resourceGroupId must not be empty");
+      throw new ResourceBuilderError("InvalidServiceLink" /* InvalidServiceLink */, "resourceGroupId must not be empty");
     }
     const group = service.resourceGroupList?.find((item) => item.groupId === normalizedGroupId);
     if (!group) {
-      throw new TypeError(`Service resource group not found: ${normalizedGroupId}`);
+      throw new ResourceBuilderError(
+        "InvalidServiceLink" /* InvalidServiceLink */,
+        `Service resource group not found: ${normalizedGroupId}`
+      );
     }
     if (!group.usageType) {
-      throw new TypeError("Service resource group has no usageType");
+      throw new ResourceBuilderError(
+        "InvalidServiceLink" /* InvalidServiceLink */,
+        "Service resource group has no usageType"
+      );
     }
     if (this.draft.usageType != null && this.draft.usageType !== group.usageType) {
-      throw new TypeError("Resource usageType does not match the service resource group");
+      throw new ResourceBuilderError(
+        "InvalidServiceLink" /* InvalidServiceLink */,
+        "Resource usageType does not match the service resource group"
+      );
     }
     const descriptions = [...this.draft.serviceDescriptions ?? []];
     const matching = descriptions.filter((item) => isSameBinding(item, serviceId, normalizedGroupId));
@@ -19297,6 +19754,8 @@ export {
   LoyaltyCardUpdateNonKeyInformationValues,
   LoyaltyCardsFacade,
   LoyaltySystemsFacade,
+  NestedRidError,
+  NestedRidErrorCode,
   NoteTypeValues,
   NotesFacade,
   OtpErrorReason,
@@ -19314,12 +19773,17 @@ export {
   RelationsFacade,
   ReportsFacade,
   ResourceBuilder,
+  ResourceBuilderError,
+  ResourceBuilderErrorCode,
   ResourcesFacade,
   SearchFacade,
   SendCodeAccountTypeValueList,
   SendCodeAccountTypeValues,
   ServiceBehaviorSettingsIssueReason,
   ServiceBuilder,
+  ServiceBuilderError,
+  ServiceBuilderErrorCode,
+  ServiceBuilderRangeError,
   ServiceCheckInWizardStepParameterName,
   ServiceCheckInWizardStepType,
   ServiceOrderConflictErrorNameValues,