@torrow/sdk-client 0.11.1 → 0.12.0

package/dist/index.js

@@ -47,12 +47,36 @@ var TorrowSdkEffectState = /* @__PURE__ */ ((TorrowSdkEffectState2) => {
   return TorrowSdkEffectState2;
 })(TorrowSdkEffectState || {});
 var TorrowSdkErrorDomain = /* @__PURE__ */ ((TorrowSdkErrorDomain2) => {
+  TorrowSdkErrorDomain2["FileMetadata"] = "FileMetadata";
   TorrowSdkErrorDomain2["ItemPatch"] = "ItemPatch";
   TorrowSdkErrorDomain2["BehaviorSettings"] = "BehaviorSettings";
   TorrowSdkErrorDomain2["Otp"] = "Otp";
   TorrowSdkErrorDomain2["AuthSession"] = "AuthSession";
   return TorrowSdkErrorDomain2;
 })(TorrowSdkErrorDomain || {});
+var FileMetadataErrorReason = /* @__PURE__ */ ((FileMetadataErrorReason2) => {
+  FileMetadataErrorReason2["ContentTypeUnavailable"] = "ContentTypeUnavailable";
+  FileMetadataErrorReason2["SubscriptionIsNotValid"] = "SubscriptionIsNotValid";
+  FileMetadataErrorReason2["FileIdUnavailable"] = "FileIdUnavailable";
+  FileMetadataErrorReason2["SubscriptionIdUnavailable"] = "SubscriptionIdUnavailable";
+  return FileMetadataErrorReason2;
+})(FileMetadataErrorReason || {});
+var FileMetadataOperation = /* @__PURE__ */ ((FileMetadataOperation2) => {
+  FileMetadataOperation2["GetInitialSubscriptionImageInfo"] = "getInitialSubscriptionImageInfo";
+  FileMetadataOperation2["GetImageInfo"] = "getImageInfo";
+  FileMetadataOperation2["GetFileInfo"] = "getFileInfo";
+  FileMetadataOperation2["GetPhotoInfo"] = "getPhotoInfo";
+  FileMetadataOperation2["GetSubscriptionImageInfo"] = "getSubscriptionImageInfo";
+  return FileMetadataOperation2;
+})(FileMetadataOperation || {});
+var FileMetadataFailureAt = /* @__PURE__ */ ((FileMetadataFailureAt2) => {
+  FileMetadataFailureAt2["ValidateInput"] = "ValidateInput";
+  FileMetadataFailureAt2["ReadItem"] = "ReadItem";
+  FileMetadataFailureAt2["ValidateItem"] = "ValidateItem";
+  FileMetadataFailureAt2["ReadMetadata"] = "ReadMetadata";
+  FileMetadataFailureAt2["ValidateMetadata"] = "ValidateMetadata";
+  return FileMetadataFailureAt2;
+})(FileMetadataFailureAt || {});
 var OtpErrorReason = /* @__PURE__ */ ((OtpErrorReason2) => {
   OtpErrorReason2["InvalidChallenge"] = "InvalidChallenge";
   OtpErrorReason2["UnsupportedMethod"] = "UnsupportedMethod";
@@ -9353,6 +9377,104 @@ function applyItemCreateDefaults(body, discriminator) {
   return payload;
 }
 
+// ../../src/resources/common/file-metadata.ts
+function fileMetadataError(category, reason) {
+  return new TorrowSdkError({ category, detail: { domain: "FileMetadata" /* FileMetadata */, reason } });
+}
+function validateFileMetadataId(value) {
+  if (typeof value !== "string" || !value.trim()) {
+    throw fileMetadataError("InvalidInput" /* InvalidInput */);
+  }
+}
+function record2(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function validateFileReference(value) {
+  if (!record2(value)) {
+    throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+  }
+  if (value.id == null) {
+    throw fileMetadataError("InsufficientData" /* InsufficientData */, "FileIdUnavailable" /* FileIdUnavailable */);
+  }
+  if (typeof value.id !== "string" || !value.id.trim()) {
+    throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+  }
+}
+function validateFullItem(value, itemId) {
+  if (!record2(value) || value.id !== itemId) {
+    throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+  }
+  const personal = value.personalInfo;
+  if (personal != null && !record2(personal)) {
+    throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+  }
+  const content = personal?.itemContentType;
+  if (content != null && typeof content !== "string") {
+    throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+  }
+  if (content === "NoRights" /* NoRights */) {
+    throw fileMetadataError("AccessDenied" /* AccessDenied */);
+  }
+  if (content !== "Full" /* Full */) {
+    throw fileMetadataError(
+      "InsufficientData" /* InsufficientData */,
+      content === "SubscriptionIsNotValid" /* SubscriptionIsNotValid */ ? "SubscriptionIsNotValid" /* SubscriptionIsNotValid */ : "ContentTypeUnavailable" /* ContentTypeUnavailable */
+    );
+  }
+}
+async function readSelectedFileMetadata(options) {
+  let failureAt = "ValidateInput" /* ValidateInput */;
+  try {
+    validateFileMetadataId(options.itemId);
+    options.validateInput?.();
+    failureAt = "ReadItem" /* ReadItem */;
+    const item = await options.readItem(options.itemId, options.signal);
+    failureAt = "ValidateItem" /* ValidateItem */;
+    validateFullItem(item, options.itemId);
+    const file2 = options.selectFile(item);
+    if (file2 == null) {
+      return null;
+    }
+    validateFileReference(file2);
+    return file2;
+  } catch (cause) {
+    const error = cause instanceof TorrowSdkError ? cause : new TorrowSdkError({ category: "Unknown" /* Unknown */, sensitive: { cause } });
+    throw error.withContext({ operation: options.operation, failureAt });
+  }
+}
+async function readOptionalFileMetadata(options) {
+  let failureAt = "ValidateInput" /* ValidateInput */;
+  try {
+    validateFileMetadataId(options.itemId);
+    failureAt = "ReadItem" /* ReadItem */;
+    const item = await options.readItem(options.itemId, options.signal);
+    failureAt = "ValidateItem" /* ValidateItem */;
+    validateFullItem(item, options.itemId);
+    if (!options.hasFile(item)) {
+      return null;
+    }
+    failureAt = "ReadMetadata" /* ReadMetadata */;
+    if (options.signal?.aborted) {
+      throw new TorrowSdkError({
+        category: "Cancelled" /* Cancelled */,
+        request: "NotStarted" /* NotStarted */
+      });
+    }
+    const metadata = await options.readMetadata();
+    failureAt = "ValidateMetadata" /* ValidateMetadata */;
+    if (!record2(metadata)) {
+      throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+    }
+    if (metadata.id != null && (typeof metadata.id !== "string" || !metadata.id.trim() || options.expectedFileId !== void 0 && metadata.id !== options.expectedFileId)) {
+      throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+    }
+    return metadata;
+  } catch (cause) {
+    const error = cause instanceof TorrowSdkError ? cause : new TorrowSdkError({ category: "Unknown" /* Unknown */, sensitive: { cause } });
+    throw error.withContext({ operation: options.operation, failureAt });
+  }
+}
+
 // ../../src/util/torrow-id.ts
 var TORROW_OBJECT_ID_HEX_LENGTH = 24;
 var OBJECT_ID_HEX_LENGTH = TORROW_OBJECT_ID_HEX_LENGTH;
@@ -9934,12 +10056,26 @@ var TorrowItemCoreFacade = class {
       signal: options?.signal
     });
   }
-  /** `GET /api/v1/{domain}/{torrowId}/image/info` */
+  /** Полная карточка без аватара → null (1 GET); иначе FileInfo из image/info (2 GET). Требуется доступ к Full. */
   getImageInfo(torrowId, options) {
-    return this.http.requestJson({
-      method: "GET",
-      path: `${this.basePath}/${encodePathSegment(torrowId)}/image/info`,
-      signal: options?.signal
+    const signal = options?.signal;
+    return readOptionalFileMetadata({
+      itemId: torrowId,
+      operation: "getImageInfo" /* GetImageInfo */,
+      signal,
+      readItem: (id, readSignal) => this.readFileMetadataItem(id, readSignal),
+      hasFile: (item) => {
+        if (item.image == null) {
+          return false;
+        }
+        validateFileReference(item.image);
+        return true;
+      },
+      readMetadata: () => this.http.requestJson({
+        method: "GET",
+        path: `${this.basePath}/${encodePathSegment(torrowId)}/image/info`,
+        signal
+      })
     });
   }
   /** `GET /api/v1/{domain}/{torrowId}/image/puturl` */
@@ -10001,16 +10137,48 @@ var TorrowItemCoreFacade = class {
       signal: options?.signal
     });
   }
-  /** `GET /api/v1/{domain}/{torrowId}/photo/info` — только при {@link TorrowItemFacadeOptions.withPhotoEndpoints}. */
-  getPhotoInfo(torrowId, options) {
-    if (!this.socialOpts.withPhotoEndpoints) {
-      throw new Error("getPhotoInfo is only supported when withPhotoEndpoints is true (contacts)");
+  /** Читает выбранную фотографию Contact: Full-карточка и, при наличии связи, metadata GET. Отсутствие связи — null. */
+  async getPhotoInfo(torrowId, options) {
+    const photoId = options?.photoId;
+    const signal = options?.signal;
+    try {
+      if (!this.socialOpts.withPhotoEndpoints) {
+        throw fileMetadataError("UnsupportedOperation" /* UnsupportedOperation */);
+      }
+      validateFileMetadataId(photoId);
+    } catch (cause) {
+      if (cause instanceof TorrowSdkError) {
+        throw cause.withContext({
+          operation: "getPhotoInfo" /* GetPhotoInfo */,
+          failureAt: "ValidateInput" /* ValidateInput */
+        });
+      }
+      throw cause;
     }
-    return this.http.requestJson({
-      method: "GET",
-      path: `${this.basePath}/${encodePathSegment(torrowId)}/photo/info`,
-      query: { photoId: options?.photoId },
-      signal: options?.signal
+    return readOptionalFileMetadata({
+      itemId: torrowId,
+      operation: "getPhotoInfo" /* GetPhotoInfo */,
+      signal,
+      readItem: (id, itemSignal) => this.readFileMetadataItem(id, itemSignal),
+      hasFile: (item) => {
+        if (item.photos == null) {
+          return false;
+        }
+        if (!Array.isArray(item.photos)) {
+          throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+        }
+        for (const photo of item.photos) {
+          validateFileReference(photo);
+        }
+        return item.photos.some((photo) => photo.id === photoId);
+      },
+      expectedFileId: photoId,
+      readMetadata: () => this.http.requestJson({
+        method: "GET",
+        path: `${this.basePath}/${encodePathSegment(torrowId)}/photo/info`,
+        query: { photoId },
+        signal
+      })
     });
   }
   /** `GET /api/v1/{domain}/{torrowId}/photo/puturl` — только при {@link TorrowItemFacadeOptions.withPhotoEndpoints}. */
@@ -10263,7 +10431,7 @@ function copyValue(value, active = /* @__PURE__ */ new Set()) {
   if (Array.isArray(value)) {
     result = Array.from(value, (child) => copyValue(child, active));
   } else {
-    const record5 = {};
+    const record6 = {};
     for (const key of Reflect.ownKeys(value)) {
       if (typeof key !== "string") {
         throw itemPatchError("InvalidInput" /* InvalidInput */);
@@ -10272,14 +10440,14 @@ function copyValue(value, active = /* @__PURE__ */ new Set()) {
       if (!descriptor || !Object.hasOwn(descriptor, "value")) {
         throw itemPatchError("InvalidInput" /* InvalidInput */);
       }
-      Object.defineProperty(record5, key, {
+      Object.defineProperty(record6, key, {
         value: copyValue(descriptor.value, active),
         enumerable: true,
         writable: true,
         configurable: true
       });
     }
-    result = record5;
+    result = record6;
   }
   active.delete(value);
   return result;
@@ -10582,6 +10750,10 @@ function createCalendarPatchAdapter() {
 var BASE = "/api/v1/calendars";
 var CalendarsFacade = class extends TorrowItemFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.Calendar;
+  /** Чтение полной карточки для метаданных без дочерних данных. */
+  readFileMetadataItem(id, signal) {
+    return this.getById(id, { includeChildItems: false, signal });
+  }
   constructor(http) {
     super(http, BASE, { imagePutUrlSecurityToken: false, withPhotoEndpoints: false });
   }
@@ -10950,6 +11122,10 @@ function cancelCaseParticipation(http, torrowId, body, options) {
 var BASE3 = "/api/v1/cases";
 var CasesFacade = class extends TorrowItemFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.Case;
+  /** Чтение полной карточки для метаданных без дочерних данных. */
+  readFileMetadataItem(id, signal) {
+    return this.getById(id, { includeChildTypes: false, signal });
+  }
   constructor(http) {
     super(http, BASE3);
   }
@@ -11465,7 +11641,7 @@ var ContactPatchCommunicationState = /* @__PURE__ */ ((ContactPatchCommunication
   ContactPatchCommunicationState2["Checked"] = "Checked";
   return ContactPatchCommunicationState2;
 })(ContactPatchCommunicationState || {});
-function record2(value) {
+function record3(value) {
   return value !== null && typeof value === "object" && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
 }
 var text = (value) => typeof value === "string";
@@ -11474,7 +11650,7 @@ var date = (value) => value instanceof Date && Number.isFinite(value.getTime());
 var nullable = (validate) => (value) => value === null || validate(value);
 var rid = (value) => value === null || typeof value === "string" && (value.trim() === "" || isValidRid(value));
 function shape(value, fields) {
-  return record2(value) && Object.entries(value).every(([key, child]) => Object.hasOwn(fields, key) && fields[key](child));
+  return record3(value) && Object.entries(value).every(([key, child]) => Object.hasOwn(fields, key) && fields[key](child));
 }
 var addressShape = {
   rid,
@@ -11507,7 +11683,7 @@ var memorableDateShape = {
   needsReminder: (value) => typeof value === "boolean",
   order: integer
 };
-var file = (value) => shape(value, { id: (value2) => typeof value2 === "string" && value2.length > 0 }) && record2(value) && Object.hasOwn(value, "id");
+var file = (value) => shape(value, { id: (value2) => typeof value2 === "string" && value2.length > 0 }) && record3(value) && Object.hasOwn(value, "id");
 var visitCard2 = (value) => shape(value, {
   fields: nullable(
     (value2) => Array.isArray(value2) && value2.every((child) => shape(child, { number: integer, value: nullable(text), expression: nullable(text) }))
@@ -11521,7 +11697,7 @@ function comparable(value) {
   if (Array.isArray(value)) {
     return `[${value.map(comparable).join(",")}]`;
   }
-  if (record2(value)) {
+  if (record3(value)) {
     return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${comparable(value[key])}`).join(",")}}`;
   }
   return JSON.stringify(value) ?? "undefined";
@@ -11603,7 +11779,7 @@ function createContactPatchAdapter() {
         return void 0;
       }
       if (key === "photos") {
-        const previousIds = Array.isArray(before) ? before.map((photo) => record2(photo) ? { id: photo.id } : photo) : before;
+        const previousIds = Array.isArray(before) ? before.map((photo) => record3(photo) ? { id: photo.id } : photo) : before;
         return comparable(previousIds) === comparable(selected.photos);
       }
       if (key !== "addresses" && key !== "communications" && key !== "dates" && key !== "visitCard") {
@@ -11627,6 +11803,10 @@ var CONTACT_SOCIAL_OPTS = {
 };
 var ContactsFacade = class extends TorrowItemFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.Contact;
+  /** Чтение полной карточки для метаданных без дочерних данных. */
+  readFileMetadataItem(id, signal) {
+    return this.getById(id, { includeChildTypes: false, signal });
+  }
   constructor(http) {
     super(http, BASE4, CONTACT_SOCIAL_OPTS);
   }
@@ -11818,6 +11998,10 @@ function createContextPatchAdapter() {
 var BASE5 = "/api/v1/contexts";
 var ContextsFacade = class extends TorrowItemFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.Context;
+  /** Чтение полной карточки для метаданных без дочерних данных. */
+  readFileMetadataItem(id, signal) {
+    return this.getById(id, { includeChildTypes: false, signal });
+  }
   constructor(http) {
     super(http, BASE5, { imagePutUrlSecurityToken: false, withPhotoEndpoints: false });
   }
@@ -11976,6 +12160,10 @@ var BASE6 = "/api/v1/notes";
 var DEFAULT_NOTE_NAME = "Untitled note";
 var NotesFacade = class extends TorrowItemFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.Note;
+  /** Чтение полной карточки для метаданных без дочерних данных. */
+  readFileMetadataItem(id, signal) {
+    return this.getById(id, { includeChildTypes: false, signal });
+  }
   constructor(http) {
     super(http, BASE6, { imagePutUrlSecurityToken: false, withPhotoEndpoints: false });
   }
@@ -12058,13 +12246,50 @@ var NotesFacade = class extends TorrowItemFacade {
       signal
     });
   }
-  /** `GET /api/v1/notes/{torrowId}/file/info` */
-  getFileInfo(torrowId, fileId, options) {
-    return this.http.requestJson({
-      method: "GET",
-      path: `${BASE6}/${encodePathSegment(torrowId)}/file/info`,
-      query: { fileId },
-      signal: options?.signal
+  /**
+   * Читает полную заметку и метаданные выбранного вложения: один GET при отсутствии связи, два при наличии.
+   * @param torrowId ID заметки без преобразований; доступная карточка Full обязательна.
+   * @param fileId Обязательный ID вложения из files; аватар и фотографии не участвуют в выборе.
+   * @param options.signal Общая отмена чтения карточки и метаданных.
+   * @returns Метаданные либо null, если выбранное вложение отсутствует в полной карточке.
+   */
+  async getFileInfo(torrowId, fileId, options) {
+    const signal = options?.signal;
+    try {
+      validateFileMetadataId(fileId);
+    } catch (error) {
+      if (error instanceof TorrowSdkError) {
+        throw error.withContext({
+          operation: "getFileInfo" /* GetFileInfo */,
+          failureAt: "ValidateInput" /* ValidateInput */
+        });
+      }
+      throw error;
+    }
+    return readOptionalFileMetadata({
+      itemId: torrowId,
+      operation: "getFileInfo" /* GetFileInfo */,
+      signal,
+      readItem: (id, readSignal) => this.readFileMetadataItem(id, readSignal),
+      hasFile: (item) => {
+        if (item.files == null) {
+          return false;
+        }
+        if (!Array.isArray(item.files)) {
+          throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+        }
+        for (const file2 of item.files) {
+          validateFileReference(file2);
+        }
+        return item.files.some((file2) => file2.id === fileId);
+      },
+      readMetadata: () => this.http.requestJson({
+        method: "GET",
+        path: `${BASE6}/${encodePathSegment(torrowId)}/file/info`,
+        query: { fileId },
+        signal
+      }),
+      expectedFileId: fileId
     });
   }
   /** `GET /api/v1/notes/{torrowId}/file/puturl` — URL для загрузки файла (presigned). */
@@ -12746,11 +12971,11 @@ var providers = {
     strings: ["redirectBaseUrl"]
   }
 };
-function record3(value) {
+function record4(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date);
 }
 function isResourcePaymentPatch(value) {
-  if (!record3(value) || Object.keys(value).some(
+  if (!record4(value) || Object.keys(value).some(
     (key) => !["paymentProviderType", "parameters", "numeratorId", "waitForConfirmation"].includes(key)
   )) {
     return false;
@@ -12770,7 +12995,7 @@ function isResourcePaymentPatch(value) {
   if (value.parameters == null) {
     return guarded;
   }
-  if (!record3(value.parameters)) {
+  if (!record4(value.parameters)) {
     return false;
   }
   const parameters = value.parameters;
@@ -12799,7 +13024,7 @@ function isResourcePaymentPatch(value) {
   });
 }
 function paymentPatchToWire(value) {
-  if (!record3(value) || !record3(value.parameters)) {
+  if (!record4(value) || !record4(value.parameters)) {
     return value;
   }
   const shape2 = providers[value.paymentProviderType];
@@ -12816,7 +13041,7 @@ function equalResourcePaymentPatchField(key, before, after) {
     return void 0;
   }
   const expected = paymentPatchToWire(after);
-  if (record3(before) && record3(expected) && before.paymentProviderType === "MockPaymentProvider" /* Mock */ && expected.paymentProviderType === "MockPaymentProvider" /* Mock */ && record3(before.parameters) && record3(expected.parameters) && expected.parameters.createAfter instanceof Date && typeof before.parameters.createAfter === "string") {
+  if (record4(before) && record4(expected) && before.paymentProviderType === "MockPaymentProvider" /* Mock */ && expected.paymentProviderType === "MockPaymentProvider" /* Mock */ && record4(before.parameters) && record4(expected.parameters) && expected.parameters.createAfter instanceof Date && typeof before.parameters.createAfter === "string") {
     const date2 = new Date(before.parameters.createAfter);
     if (!Number.isFinite(date2.getTime())) {
       return false;
@@ -12893,6 +13118,10 @@ function createResourcePatchAdapter(project) {
 var BASE7 = "/api/v1/resources";
 var ResourcesFacade = class extends TorrowItemFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.Resource;
+  /** Чтение полной карточки для метаданных без дочерних данных. */
+  readFileMetadataItem(id, signal) {
+    return this.getById(id, { includeChildTypes: false, isNeedItem: true, isNeedParentResource: false, signal });
+  }
   constructor(http) {
     super(http, BASE7, { imagePutUrlSecurityToken: false, withPhotoEndpoints: false });
   }
@@ -12915,6 +13144,9 @@ var ResourcesFacade = class extends TorrowItemFacade {
     return super.getByUniqueName(uniqueName, options).then((item) => this.toSdkResourceItem(item));
   }
   toSdkResourceItem(item) {
+    if (item === null || typeof item !== "object" || Array.isArray(item)) {
+      throw new TorrowSdkError({ category: "InvalidResponse" /* InvalidResponse */ });
+    }
     return {
       ...item,
       behaviorSettings: parseResourceBehaviorSettings(item.tags)
@@ -13179,6 +13411,9 @@ function projectItemViews(domain, views) {
 // ../../src/resources/services/service-requests.ts
 var BASE8 = "/api/v1/services";
 function toSdkServiceItem(service) {
+  if (service === null || typeof service !== "object" || Array.isArray(service)) {
+    throw new TorrowSdkError({ category: "InvalidResponse" /* InvalidResponse */ });
+  }
   return {
     ...omitUnusedServiceFields(service),
     behaviorSettings: parseServiceImplicitTagParams(service.tags)
@@ -13289,18 +13524,18 @@ var configs = Object.values(SERVICE_IMPLICIT_TAG_REGISTRY);
 function isBehaviorVersion(value) {
   return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= 2147483647;
 }
-function record4(value) {
+function record5(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function validateBehaviorResponse(value, serviceId) {
-  if (!record4(value) || value.id !== serviceId) {
+  if (!record5(value) || value.id !== serviceId) {
     throw behaviorSettingsError("InvalidResponse" /* InvalidResponse */);
   }
   const personal = value.personalInfo;
-  if (record4(personal) && (personal.itemContentType === "NoRights" /* NoRights */ || personal.itemContentType === "SubscriptionIsNotValid" /* SubscriptionIsNotValid */)) {
+  if (record5(personal) && (personal.itemContentType === "NoRights" /* NoRights */ || personal.itemContentType === "SubscriptionIsNotValid" /* SubscriptionIsNotValid */)) {
     throw behaviorSettingsError("AccessDenied" /* AccessDenied */);
   }
-  if (!record4(personal) || personal.itemContentType !== "Full" /* Full */ || value.tags == null || !record4(value.meta) || !isBehaviorVersion(value.meta.version)) {
+  if (!record5(personal) || personal.itemContentType !== "Full" /* Full */ || value.tags == null || !record5(value.meta) || !isBehaviorVersion(value.meta.version)) {
     throw behaviorSettingsError("InsufficientData" /* InsufficientData */);
   }
   if (!Array.isArray(value.tags) || !value.tags.every((tag) => typeof tag === "string")) {
@@ -13429,7 +13664,7 @@ function normalizeBehaviorInput(input) {
   function fail() {
     throw behaviorSettingsError("InvalidInput" /* InvalidInput */);
   }
-  if (!record4(input) || Object.keys(input).some((key) => !Object.hasOwn(SERVICE_IMPLICIT_TAG_REGISTRY, key))) {
+  if (!record5(input) || Object.keys(input).some((key) => !Object.hasOwn(SERVICE_IMPLICIT_TAG_REGISTRY, key))) {
     fail();
   }
   const output = {};
@@ -13459,7 +13694,7 @@ function normalizeBehaviorInput(input) {
       }
       const seen = /* @__PURE__ */ new Set();
       output[config.field] = value.map((entry) => {
-        if (!record4(entry) || Object.keys(entry).some((key) => !["index", "text", "link"].includes(key)) || typeof entry.index !== "number" || !Number.isSafeInteger(entry.index) || entry.index <= 0 || seen.has(entry.index)) {
+        if (!record5(entry) || Object.keys(entry).some((key) => !["index", "text", "link"].includes(key)) || typeof entry.index !== "number" || !Number.isSafeInteger(entry.index) || entry.index <= 0 || seen.has(entry.index)) {
           fail();
         }
         seen.add(entry.index);
@@ -13515,6 +13750,10 @@ function mergeBehaviorSettings(tags, settings, mergeParameters) {
 var BASE9 = "/api/v1/services";
 var ServicesFacade = class extends TorrowItemFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.Service;
+  /** Чтение полной карточки для метаданных без дочерних данных. */
+  readFileMetadataItem(id, signal) {
+    return this.getById(id, { includeChildTypes: false, signal });
+  }
   constructor(http) {
     super(http, BASE9, { imagePutUrlSecurityToken: false, withPhotoEndpoints: false });
   }
@@ -14744,9 +14983,36 @@ function createLoyaltySystemPatchAdapter() {
 var BASE17 = "/api/v1/loyaltysystems";
 var LoyaltySystemsFacade = class extends TorrowItemCoreFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.LoyaltySystem;
+  /** Чтение полной карточки для метаданных без дочерних данных. */
+  readFileMetadataItem(id, signal) {
+    return this.getById(id, { includeChildItems: false, signal });
+  }
   constructor(http) {
     super(http, BASE17);
   }
+  /**
+   * Изображение начальной подписки из одного GET Full-программы; null означает отсутствие.
+   * Основной аватар не участвует в выборе; url/refreshUrl не вызываются и не исправляются.
+   */
+  getInitialSubscriptionImageInfo(torrowId, options) {
+    const signal = options?.signal;
+    return readSelectedFileMetadata({
+      itemId: torrowId,
+      operation: "getInitialSubscriptionImageInfo" /* GetInitialSubscriptionImageInfo */,
+      signal,
+      readItem: (id, originalSignal) => this.getById(id, { includeChildItems: false, signal: originalSignal }),
+      selectFile: (item) => {
+        const initial = item.initialSubscription;
+        if (initial == null) {
+          return null;
+        }
+        if (typeof initial !== "object" || Array.isArray(initial)) {
+          throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+        }
+        return initial.image;
+      }
+    });
+  }
   /** Изменяет выбранные настройки через полный GET и один CAS PUT; пропуск сохраняет поля. */
   patch(itemId, fields, options) {
     return patchItem(
@@ -14886,9 +15152,72 @@ var BASE18 = "/api/v1/loyaltycards";
 var LOYALTY_CARD_SOCIAL_OPTS = { withGroupListEndpoint: false };
 var LoyaltyCardsFacade = class extends TorrowItemCoreFacade {
   itemObjectTypeCode = TorrowObjectTypeCode.LoyaltyCard;
+  /** Чтение полной карточки для метаданных без дочерних данных. */
+  readFileMetadataItem(id, signal) {
+    return this.getById(id, { includeChildItems: false, includeBalance: false, signal });
+  }
   constructor(http) {
     super(http, BASE18, LOYALTY_CARD_SOCIAL_OPTS);
   }
+  /**
+   * Отображаемый аватар из свежей Full-карточки за один GET; отсутствие → null.
+   * Сервер уже применил наследование изображения программы. image/info читает собственный файл карты,
+   * поэтому не используется. Для обновления URL повторить getter; refreshUrl не вызывается.
+   */
+  getImageInfo(torrowId, options) {
+    const signal = options?.signal;
+    return readSelectedFileMetadata({
+      itemId: torrowId,
+      operation: "getImageInfo" /* GetImageInfo */,
+      signal,
+      readItem: (id, readSignal) => this.readFileMetadataItem(id, readSignal),
+      selectFile: (item) => item.image
+    });
+  }
+  /**
+   * Изображение выбранной подписки из одного GET Full-карты; отсутствие → null.
+   * @param torrowId ID карты без преобразований.
+   * @param subscriptionId Обязательный ID подписки, не ID файла и не аватара карты.
+   * @param options Отмена чтения; URL и refreshUrl не запрашиваются автоматически.
+   * @returns FileInfo из свежего снимка либо null; доступность байтов отдельно не проверяется.
+   */
+  getSubscriptionImageInfo(torrowId, subscriptionId, options) {
+    const signal = options?.signal;
+    return readSelectedFileMetadata({
+      itemId: torrowId,
+      operation: "getSubscriptionImageInfo" /* GetSubscriptionImageInfo */,
+      signal,
+      validateInput: () => validateFileMetadataId(subscriptionId),
+      readItem: (id, readSignal) => this.readFileMetadataItem(id, readSignal),
+      selectFile: (item) => {
+        const subscriptions = item.subscriptions;
+        if (subscriptions == null) {
+          return null;
+        }
+        if (!Array.isArray(subscriptions)) {
+          throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+        }
+        const ids = /* @__PURE__ */ new Set();
+        for (const subscription of subscriptions) {
+          if (subscription === null || typeof subscription !== "object" || Array.isArray(subscription)) {
+            throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+          }
+          const id = subscription.subscriptionId;
+          if (id == null) {
+            throw fileMetadataError(
+              "InsufficientData" /* InsufficientData */,
+              "SubscriptionIdUnavailable" /* SubscriptionIdUnavailable */
+            );
+          }
+          if (typeof id !== "string" || !id.trim() || ids.has(id)) {
+            throw fileMetadataError("InvalidResponse" /* InvalidResponse */);
+          }
+          ids.add(id);
+        }
+        return subscriptions.find((subscription) => subscription.subscriptionId === subscriptionId)?.image;
+      }
+    });
+  }
   /** Id карты лояльности до `create` / presigned upload. */
   generateLoyaltyCardId(ownerTorrowId) {
     return this.generateItemId(ownerTorrowId);
@@ -17077,6 +17406,9 @@ export {
   Discriminator,
   ExportImportFacade,
   ExternalAuthsFacade,
+  FileMetadataErrorReason,
+  FileMetadataFailureAt,
+  FileMetadataOperation,
   GenderValues,
   HttpClient,
   IdGeneratorFacade,