@torrow/sdk-client 0.8.0 → 0.9.0

package/dist/index.js

@@ -11,103 +11,167 @@ async function buildAuthHeaders(config) {
   return headers;
 }
 
-// ../../src/http/TorrowHttpError.ts
-function pickApiErrorName(body) {
-  if (body === null || typeof body !== "object") {
-    return void 0;
-  }
-  const o = body;
-  if (typeof o.error === "string" && o.error.length > 0) {
-    return o.error;
-  }
-  if (typeof o.name === "string" && o.name.length > 0) {
-    return o.name;
+// ../../src/http/TorrowSdkError.ts
+var TorrowSdkErrorCategory = /* @__PURE__ */ ((TorrowSdkErrorCategory2) => {
+  TorrowSdkErrorCategory2["InvalidInput"] = "InvalidInput";
+  TorrowSdkErrorCategory2["InvalidState"] = "InvalidState";
+  TorrowSdkErrorCategory2["AccessDenied"] = "AccessDenied";
+  TorrowSdkErrorCategory2["InsufficientData"] = "InsufficientData";
+  TorrowSdkErrorCategory2["InvalidResponse"] = "InvalidResponse";
+  TorrowSdkErrorCategory2["VersionConflict"] = "VersionConflict";
+  TorrowSdkErrorCategory2["AuthenticationRequired"] = "AuthenticationRequired";
+  TorrowSdkErrorCategory2["UnsupportedOperation"] = "UnsupportedOperation";
+  TorrowSdkErrorCategory2["RateLimited"] = "RateLimited";
+  TorrowSdkErrorCategory2["HttpFailure"] = "HttpFailure";
+  TorrowSdkErrorCategory2["TransportFailure"] = "TransportFailure";
+  TorrowSdkErrorCategory2["StorageFailure"] = "StorageFailure";
+  TorrowSdkErrorCategory2["Cancelled"] = "Cancelled";
+  TorrowSdkErrorCategory2["Unknown"] = "Unknown";
+  return TorrowSdkErrorCategory2;
+})(TorrowSdkErrorCategory || {});
+var TorrowSdkRequestState = /* @__PURE__ */ ((TorrowSdkRequestState2) => {
+  TorrowSdkRequestState2["NotStarted"] = "NotStarted";
+  TorrowSdkRequestState2["Started"] = "Started";
+  return TorrowSdkRequestState2;
+})(TorrowSdkRequestState || {});
+var TorrowSdkEffectArea = /* @__PURE__ */ ((TorrowSdkEffectArea2) => {
+  TorrowSdkEffectArea2["Remote"] = "Remote";
+  TorrowSdkEffectArea2["SessionMemory"] = "SessionMemory";
+  TorrowSdkEffectArea2["Storage"] = "Storage";
+  return TorrowSdkEffectArea2;
+})(TorrowSdkEffectArea || {});
+var TorrowSdkEffectState = /* @__PURE__ */ ((TorrowSdkEffectState2) => {
+  TorrowSdkEffectState2["NotApplied"] = "NotApplied";
+  TorrowSdkEffectState2["Applied"] = "Applied";
+  TorrowSdkEffectState2["Unknown"] = "Unknown";
+  return TorrowSdkEffectState2;
+})(TorrowSdkEffectState || {});
+var TorrowSdkErrorDomain = /* @__PURE__ */ ((TorrowSdkErrorDomain2) => {
+  TorrowSdkErrorDomain2["BehaviorSettings"] = "BehaviorSettings";
+  TorrowSdkErrorDomain2["Otp"] = "Otp";
+  TorrowSdkErrorDomain2["AuthSession"] = "AuthSession";
+  return TorrowSdkErrorDomain2;
+})(TorrowSdkErrorDomain || {});
+var OtpErrorReason = /* @__PURE__ */ ((OtpErrorReason2) => {
+  OtpErrorReason2["InvalidChallenge"] = "InvalidChallenge";
+  OtpErrorReason2["UnsupportedMethod"] = "UnsupportedMethod";
+  OtpErrorReason2["AuthHeaderMissing"] = "AuthHeaderMissing";
+  OtpErrorReason2["CodeRequestLimitExceeded"] = "CodeRequestLimitExceeded";
+  return OtpErrorReason2;
+})(OtpErrorReason || {});
+var AuthSessionErrorReason = /* @__PURE__ */ ((AuthSessionErrorReason2) => {
+  AuthSessionErrorReason2["SessionNotReady"] = "SessionNotReady";
+  AuthSessionErrorReason2["CallbackFailed"] = "CallbackFailed";
+  return AuthSessionErrorReason2;
+})(AuthSessionErrorReason || {});
+var BehaviorSettingsEffectStep = /* @__PURE__ */ ((BehaviorSettingsEffectStep2) => {
+  BehaviorSettingsEffectStep2["Write"] = "Write";
+  return BehaviorSettingsEffectStep2;
+})(BehaviorSettingsEffectStep || {});
+var AuthSessionEffectStep = /* @__PURE__ */ ((AuthSessionEffectStep2) => {
+  AuthSessionEffectStep2["CreateAuthSession"] = "CreateAuthSession";
+  AuthSessionEffectStep2["CloseSession"] = "CloseSession";
+  AuthSessionEffectStep2["IssueTokens"] = "IssueTokens";
+  AuthSessionEffectStep2["RefreshTokens"] = "RefreshTokens";
+  AuthSessionEffectStep2["RevokeTokens"] = "RevokeTokens";
+  AuthSessionEffectStep2["SendCode"] = "SendCode";
+  AuthSessionEffectStep2["SetTokens"] = "SetTokens";
+  AuthSessionEffectStep2["ClearTokens"] = "ClearTokens";
+  AuthSessionEffectStep2["SaveTokens"] = "SaveTokens";
+  AuthSessionEffectStep2["ClearStorage"] = "ClearStorage";
+  return AuthSessionEffectStep2;
+})(AuthSessionEffectStep || {});
+var TorrowSdkError = class _TorrowSdkError extends Error {
+  /** Общая причина отказа. */
+  category;
+  /** Безопасные метаданные ответа. */
+  http;
+  /** Неизменяемое предметное уточнение. */
+  detail;
+  /** Начало fetch; не доставка. */
+  request;
+  /** Имя составной операции без пользовательских значений. */
+  operation;
+  /** Стадия отказа без аргументов. */
+  failureAt;
+  /** Неизменяемые сведения об описанных изменениях. */
+  effects;
+  #sensitive;
+  constructor(init) {
+    super(`Torrow SDK: ${init.category}`);
+    this.name = "TorrowSdkError";
+    this.category = init.category;
+    this.http = init.http && Object.freeze({ ...init.http });
+    this.detail = init.detail && Object.freeze({ ...init.detail });
+    this.request = init.request;
+    this.operation = init.operation;
+    this.failureAt = init.failureAt;
+    this.effects = init.effects && Object.freeze(init.effects.map((effect) => Object.freeze({ ...effect })));
+    this.#sensitive = Object.freeze({ ...init.sensitive, cleanup: init.sensitive?.cleanup && Object.freeze({ ...init.sensitive.cleanup }) });
+    Object.freeze(this);
+  }
+  /** Безопасный снимок для обычной сериализации и диагностики. */
+  toJSON() {
+    return {
+      category: this.category,
+      http: this.http,
+      detail: this.detail,
+      request: this.request,
+      operation: this.operation,
+      failureAt: this.failureAt,
+      effects: this.effects
+    };
   }
-  if (typeof o.title === "string" && o.title.length > 0) {
-    return o.title;
+  /** Явный доступ к секретной диагностике; вызывающий код отвечает за её защиту. */
+  getSensitiveDetails() {
+    return this.#sensitive;
   }
-  if (typeof o.message === "string" && o.message.length > 0) {
-    return o.message;
+  /** Новый снимок для составной операции; исходная ошибка не изменяется. */
+  withContext(context) {
+    return new _TorrowSdkError({ ...this.toJSON(), ...context, sensitive: this.#sensitive });
   }
-  return void 0;
+};
+
+// ../../src/http/transport-errors.ts
+var KnownApiErrorName = /* @__PURE__ */ ((KnownApiErrorName2) => {
+  KnownApiErrorName2["ResourceUnavailable"] = "REQUESTED_RESOURCE_IS_NOT_AVAILABLE";
+  KnownApiErrorName2["QuantityUnavailable"] = "REQUESTED_RESOURCE_QUANTITY_IS_NOT_AVAILABLE";
+  KnownApiErrorName2["ServiceUnavailableAtTime"] = "SERVICE_IS_NOT_AVAILABLE_AT_TIME";
+  KnownApiErrorName2["WrongVersion"] = "OBJECT_HAS_WRONG_VERSION";
+  KnownApiErrorName2["CodeRequestLimit"] = "CODE_REQUEST_LIMIT_EXCEEDED";
+  KnownApiErrorName2["AccessDenied"] = "ACCESS_DENIED";
+  KnownApiErrorName2["UserNoRights"] = "USER_HAVE_NO_RIGHTS_TO_ELEMENTS";
+  KnownApiErrorName2["AuthHeaderMissing"] = "AUTH_HEADER_MISSING";
+  KnownApiErrorName2["WrongSessionCode"] = "WRONG_SESSION_ACCESS_CODE";
+  KnownApiErrorName2["AttemptsExceeded"] = "EXCEEDED_ATTEMPTS_COUNT";
+  return KnownApiErrorName2;
+})(KnownApiErrorName || {});
+function createHttpError(init) {
+  const body = record(init.body);
+  const code = body?.code;
+  const apiCode = typeof code === "string" ? code : typeof code === "number" && Number.isFinite(code) ? String(code) : void 0;
+  const apiName = [body?.error, body?.name].find((value) => typeof value === "string" && Object.values(KnownApiErrorName).includes(value));
+  const nested = record(body?.torrowError) ?? record(body?.torrowErrorClient) ?? record(body?.innerError);
+  const trace = body?.traceIdentifier ?? nested?.traceIdentifier;
+  const http = {
+    status: init.status,
+    apiCode,
+    apiErrorName: typeof apiName === "string" ? apiName : void 0,
+    requestId: init.requestId,
+    traceIdentifier: init.traceIdentifier || (typeof trace === "string" ? trace : void 0)
+  };
+  const category = init.status === 401 ? "AuthenticationRequired" /* AuthenticationRequired */ : init.status === 403 ? "AccessDenied" /* AccessDenied */ : init.status === 429 ? "RateLimited" /* RateLimited */ : "HttpFailure" /* HttpFailure */;
+  return new TorrowSdkError({ category, http, request: "Started" /* Started */, sensitive: init });
 }
-function pickApiCode(body) {
-  if (body === null || typeof body !== "object") {
-    return void 0;
-  }
-  const c = body.code;
-  if (typeof c === "string") {
-    return c;
-  }
-  return typeof c === "number" && Number.isFinite(c) ? String(c) : void 0;
+function record(value) {
+  return value !== null && typeof value === "object" ? value : void 0;
 }
-function pickTraceIdentifier(body) {
-  if (body === null || typeof body !== "object") {
-    return void 0;
-  }
-  const o = body;
-  if (typeof o.traceIdentifier === "string" && o.traceIdentifier.length > 0) {
-    return o.traceIdentifier;
-  }
-  for (const key of ["torrowError", "torrowErrorClient", "innerError"]) {
-    const nested = o[key];
-    if (nested !== null && typeof nested === "object") {
-      const t = nested.traceIdentifier;
-      if (typeof t === "string" && t.length > 0) {
-        return t;
-      }
-    }
-  }
-  return void 0;
+function normalizeTransportError(cause, request, signal, url, parsing = false) {
+  if (cause instanceof TorrowSdkError) return cause;
+  const cancelled = signal?.aborted || record(cause)?.name === "AbortError";
+  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 } });
 }
-var TorrowHttpError = class _TorrowHttpError extends Error {
-  status;
-  body;
-  apiErrorName;
-  /** Код ошибки API строкой: числовой `TorrowErrorClient.code` приводится к строке (`"311293"`). */
-  code;
-  requestId;
-  /**
-   * Идентификатор трассировки шлюза (`TorrowErrorClient.traceIdentifier`
-   * или заголовок `trace-identifier`) — для саппорта/логов.
-   */
-  traceIdentifier;
-  url;
-  constructor(init) {
-    const apiName = pickApiErrorName(init.body);
-    const code = pickApiCode(init.body);
-    const traceIdentifier = (typeof init.traceIdentifier === "string" && init.traceIdentifier.length > 0 ? init.traceIdentifier : void 0) ?? pickTraceIdentifier(init.body);
-    const message = _TorrowHttpError.buildMessage(
-      init.status,
-      init.url,
-      apiName,
-      code,
-      traceIdentifier
-    );
-    super(message, { cause: init.cause });
-    this.name = "TorrowHttpError";
-    this.status = init.status;
-    this.body = init.body;
-    this.url = init.url;
-    this.requestId = init.requestId;
-    this.traceIdentifier = traceIdentifier;
-    this.apiErrorName = apiName;
-    this.code = code;
-  }
-  static buildMessage(status, url, apiErrorName, code, traceIdentifier) {
-    const parts = [`HTTP ${status}`, url];
-    if (code) {
-      parts.push(`code=${code}`);
-    }
-    if (apiErrorName) {
-      parts.push(apiErrorName);
-    }
-    if (traceIdentifier) {
-      parts.push(`trace-identifier=${traceIdentifier}`);
-    }
-    return parts.join(" \u2014 ");
-  }
-};
 
 // ../../src/util/json.ts
 var ISO_DATE_REGEX = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}(?:\.\d*)?)(Z|([+-])(\d{2}):(\d{2}))$/;
@@ -679,49 +743,59 @@ var HttpClient = class {
     this.config = config;
   }
   config;
+  /** Выполняет запрос; сетевые и подготовительные отказы возвращает как TorrowSdkError. */
   async requestJson(init, onDispatch) {
-    const { fetch: fetchFn = globalThis.fetch } = this.config;
-    const url = this.buildUrl(init.path, init.query);
-    const authHeaders = await buildAuthHeaders(this.config);
-    const headers = {
-      Accept: JSON_MIME,
-      ...authHeaders,
-      ...this.config.defaultHeaders,
-      ...init.headers
-    };
-    if (this.config.userAgent) {
-      headers["User-Agent"] = this.config.userAgent;
-    }
-    const needsBody = init.body !== void 0 && init.method !== "GET" && init.method !== "DELETE";
-    if (needsBody) {
-      headers["Content-Type"] = JSON_MIME;
-    }
-    const requestInit = {
-      method: init.method,
-      headers,
-      body: needsBody ? stringifyJsonBody(init.body) : void 0,
-      signal: init.signal
-    };
-    if (onDispatch) init.signal?.throwIfAborted();
-    onDispatch?.();
-    const res = await fetchFn(url, requestInit);
-    const requestId = res.headers.get("x-request-id") ?? void 0;
-    const traceIdentifier = res.headers.get("trace-identifier") ?? void 0;
-    const text = await res.text();
-    if (!res.ok) {
-      const errBody = tryParseErrorBody(text, res.headers.get("content-type"));
-      throw new TorrowHttpError({
-        status: res.status,
-        body: errBody,
-        url,
-        requestId,
-        traceIdentifier
-      });
-    }
-    if (text === "") {
-      return void 0;
+    let request = "NotStarted" /* NotStarted */;
+    let url;
+    let parsing = false;
+    try {
+      const { fetch: fetchFn = globalThis.fetch } = this.config;
+      url = this.buildUrl(init.path, init.query);
+      const authHeaders = await buildAuthHeaders(this.config);
+      const headers = {
+        Accept: JSON_MIME,
+        ...authHeaders,
+        ...this.config.defaultHeaders,
+        ...init.headers
+      };
+      if (this.config.userAgent) {
+        headers["User-Agent"] = this.config.userAgent;
+      }
+      const needsBody = init.body !== void 0 && init.method !== "GET" && init.method !== "DELETE";
+      if (needsBody) {
+        headers["Content-Type"] = JSON_MIME;
+      }
+      const requestInit = {
+        method: init.method,
+        headers,
+        body: needsBody ? stringifyJsonBody(init.body) : void 0,
+        signal: init.signal
+      };
+      init.signal?.throwIfAborted();
+      onDispatch?.();
+      request = "Started" /* Started */;
+      const res = await fetchFn(url, requestInit);
+      const requestId = res.headers.get("x-request-id") ?? void 0;
+      const traceIdentifier = res.headers.get("trace-identifier") ?? void 0;
+      const text = await res.text();
+      if (!res.ok) {
+        const errBody = tryParseErrorBody(text, res.headers.get("content-type"));
+        throw createHttpError({
+          status: res.status,
+          body: errBody,
+          url,
+          requestId,
+          traceIdentifier
+        });
+      }
+      if (text === "") {
+        return void 0;
+      }
+      parsing = true;
+      return parseOperationResponse(text, init.method, init.path, res.status);
+    } catch (cause) {
+      throw normalizeTransportError(cause, request, init.signal, url, parsing);
     }
-    return parseOperationResponse(text, init.method, init.path, res.status);
   }
   buildUrl(path, query) {
     const origin = this.config.baseUrl ?? DEFAULT_TORROW_API_BASE_URL;
@@ -3079,6 +3153,28 @@ var RelationsFacade = class {
   }
 };
 
+// ../../src/resources/common/behavior-settings-errors.ts
+function behaviorSettingsError(category) {
+  return new TorrowSdkError({ category, detail: { domain: "BehaviorSettings" /* BehaviorSettings */ } });
+}
+function contextualizeBehaviorError(cause, operation, failureAt, state) {
+  const error = cause instanceof TorrowSdkError ? cause : new TorrowSdkError({
+    category: "Unknown" /* Unknown */,
+    sensitive: { cause }
+  });
+  return error.withContext({
+    operation,
+    failureAt,
+    detail: error.detail ?? { domain: "BehaviorSettings" /* BehaviorSettings */ },
+    effects: state === void 0 ? void 0 : [{ area: "Remote" /* Remote */, step: "Write" /* Write */, state }]
+  });
+}
+function isBehaviorCasRefusal(cause) {
+  if (!(cause instanceof TorrowSdkError) || cause.request !== "Started" /* Started */ || cause.http?.status !== 500) return false;
+  const body = cause.getSensitiveDetails().body;
+  return body !== null && typeof body === "object" && "name" in body && body.name === "OBJECT_HAS_WRONG_VERSION" /* VersionConflict */ && "code" in body && (body.code === 208213 /* VersionConflict */ || body.code === String(208213 /* VersionConflict */));
+}
+
 // ../../src/resources/common/implicit-tag-params.ts
 var SERVICE_IMPLICIT_TAG_SUFFIX = {
   orderNameLegacy: ":ordername",
@@ -3486,39 +3582,77 @@ var ResourcesFacade = class extends TorrowItemFacade {
     return this.getBehaviorSettingsFromResource(resource);
   }
   async updateBehaviorSettings(resourceId, settingsPatch, options) {
-    const resource = await this.getById(resourceId, {
-      includeDeleted: options?.includeDeleted,
-      isNeedItem: options?.isNeedItem,
-      isNeedParentResource: options?.isNeedParentResource,
-      includeChildTypes: options?.includeChildTypes,
-      securityToken: options?.securityToken,
-      signal: options?.signal
-    });
-    const mergeParameters = options?.mergeParameters ?? true;
-    const nextSettings = mergeParameters ? {
-      ...this.getBehaviorSettingsFromResource(resource),
-      ...settingsPatch
-    } : { ...settingsPatch };
-    const nextTags = mergeResourceBehaviorTags(resource.tags, nextSettings);
-    await this.updateTags(resourceId, nextTags, {
-      versionToCheck: options?.checkVersion ? resource.meta?.version ?? void 0 : void 0,
-      isNeedAnnouncement: options?.isNeedAnnouncement,
-      signal: options?.signal
-    });
-    return this.getById(resourceId, {
-      includeDeleted: options?.includeDeleted,
-      isNeedItem: options?.isNeedItem,
-      isNeedParentResource: options?.isNeedParentResource,
-      includeChildTypes: options?.includeChildTypes,
-      securityToken: options?.securityToken,
-      signal: options?.signal
-    });
+    return this.writeBehaviorSettings(resourceId, settingsPatch, options, "ResourcesFacade.updateBehaviorSettings" /* ResourceUpdate */);
+  }
+  /** Контекст локален вызову; алгоритм и число запросов двух публичных операций совпадают. */
+  async writeBehaviorSettings(resourceId, settingsPatch, options, operation) {
+    let failureAt = "ReadCurrent" /* ReadCurrent */;
+    let effect = "NotApplied" /* NotApplied */;
+    try {
+      const resource = await this.getById(resourceId, {
+        includeDeleted: options?.includeDeleted,
+        isNeedItem: options?.isNeedItem,
+        isNeedParentResource: options?.isNeedParentResource,
+        includeChildTypes: options?.includeChildTypes,
+        securityToken: options?.securityToken,
+        signal: options?.signal
+      });
+      failureAt = "PrepareWrite" /* PrepareWrite */;
+      const mergeParameters = options?.mergeParameters ?? true;
+      const nextSettings = mergeParameters ? {
+        ...this.getBehaviorSettingsFromResource(resource),
+        ...settingsPatch
+      } : { ...settingsPatch };
+      const nextTags = mergeResourceBehaviorTags(resource.tags, nextSettings);
+      failureAt = "WriteSettings" /* WriteSettings */;
+      let dispatched = false;
+      let acknowledgement;
+      try {
+        acknowledgement = await this.http.requestJson({
+          method: "PUT",
+          path: `${BASE7}/${encodePathSegment(resourceId)}/tags`,
+          body: nextTags,
+          query: {
+            versionToCheck: options?.checkVersion ? resource.meta?.version ?? void 0 : void 0,
+            isNeedAnnouncement: options?.isNeedAnnouncement
+          },
+          signal: options?.signal
+        }, () => {
+          dispatched = true;
+        });
+      } catch (cause) {
+        effect = dispatched ? "Unknown" /* Unknown */ : "NotApplied" /* NotApplied */;
+        const error = contextualizeBehaviorError(cause, operation, failureAt, effect).withContext({
+          request: dispatched ? "Started" /* Started */ : "NotStarted" /* NotStarted */
+        });
+        if (dispatched && isBehaviorCasRefusal(error)) {
+          effect = "NotApplied" /* NotApplied */;
+          throw error.withContext({
+            category: "VersionConflict" /* VersionConflict */,
+            detail: { domain: "BehaviorSettings" /* BehaviorSettings */ }
+          });
+        }
+        throw error;
+      }
+      effect = acknowledgement?.id === resourceId ? "Applied" /* Applied */ : "Unknown" /* Unknown */;
+      failureAt = "ReadBack" /* ReadBack */;
+      return await this.getById(resourceId, {
+        includeDeleted: options?.includeDeleted,
+        isNeedItem: options?.isNeedItem,
+        isNeedParentResource: options?.isNeedParentResource,
+        includeChildTypes: options?.includeChildTypes,
+        securityToken: options?.securityToken,
+        signal: options?.signal
+      });
+    } catch (cause) {
+      throw contextualizeBehaviorError(cause, operation, failureAt, effect);
+    }
   }
   setBehaviorSettings(resourceId, settings, options) {
-    return this.updateBehaviorSettings(resourceId, settings, {
+    return this.writeBehaviorSettings(resourceId, settings, {
       ...options,
       mergeParameters: false
-    });
+    }, "ResourcesFacade.setBehaviorSettings" /* ResourceSet */);
   }
   /** `GET /api/v1/resources/personallist` */
   listPersonal(options) {
@@ -3590,61 +3724,39 @@ var ResourcesFacade = class extends TorrowItemFacade {
 };
 
 // ../../src/resources/services/behavior-settings.ts
-var ServiceBehaviorSettingsErrorCategory = /* @__PURE__ */ ((ServiceBehaviorSettingsErrorCategory2) => {
-  ServiceBehaviorSettingsErrorCategory2["InvalidInput"] = "InvalidInput";
-  ServiceBehaviorSettingsErrorCategory2["AccessDenied"] = "AccessDenied";
-  ServiceBehaviorSettingsErrorCategory2["InsufficientData"] = "InsufficientData";
-  ServiceBehaviorSettingsErrorCategory2["InvalidResponse"] = "InvalidResponse";
-  ServiceBehaviorSettingsErrorCategory2["VersionConflict"] = "VersionConflict";
-  ServiceBehaviorSettingsErrorCategory2["WriteOutcomeUnknown"] = "WriteOutcomeUnknown";
-  ServiceBehaviorSettingsErrorCategory2["RequestNotSent"] = "RequestNotSent";
-  return ServiceBehaviorSettingsErrorCategory2;
-})(ServiceBehaviorSettingsErrorCategory || {});
 var ServiceBehaviorSettingsIssueReason = /* @__PURE__ */ ((ServiceBehaviorSettingsIssueReason2) => {
   ServiceBehaviorSettingsIssueReason2["InvalidValue"] = "InvalidValue";
   ServiceBehaviorSettingsIssueReason2["AmbiguousValue"] = "AmbiguousValue";
   return ServiceBehaviorSettingsIssueReason2;
 })(ServiceBehaviorSettingsIssueReason || {});
-var ServiceBehaviorSettingsError = class extends Error {
-  /** Предметная категория; не зависит от кодов MCP. */
-  category;
-  /** Исходная ошибка транспорта или сервера, если она существует. */
-  cause;
-  constructor(category, cause) {
-    super(`Service BehaviorSettings: ${category}`);
-    this.name = "ServiceBehaviorSettingsError";
-    this.category = category;
-    this.cause = cause;
-  }
-};
 var configs = Object.values(SERVICE_IMPLICIT_TAG_REGISTRY);
 function isBehaviorVersion(value) {
   return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= 2147483647;
 }
-function record(value) {
+function record2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function validateBehaviorResponse(value, serviceId) {
-  if (!record(value) || value.id !== serviceId) throw new ServiceBehaviorSettingsError("InvalidResponse" /* InvalidResponse */);
+  if (!record2(value) || value.id !== serviceId) throw behaviorSettingsError("InvalidResponse" /* InvalidResponse */);
   const personal = value.personalInfo;
-  if (record(personal) && (personal.itemContentType === "NoRights" /* NoRights */ || personal.itemContentType === "SubscriptionIsNotValid" /* SubscriptionIsNotValid */)) {
-    throw new ServiceBehaviorSettingsError("AccessDenied" /* AccessDenied */);
+  if (record2(personal) && (personal.itemContentType === "NoRights" /* NoRights */ || personal.itemContentType === "SubscriptionIsNotValid" /* SubscriptionIsNotValid */)) {
+    throw behaviorSettingsError("AccessDenied" /* AccessDenied */);
   }
-  if (!record(personal) || personal.itemContentType !== "Full" /* Full */ || value.tags == null || !record(value.meta) || !isBehaviorVersion(value.meta.version)) {
-    throw new ServiceBehaviorSettingsError("InsufficientData" /* InsufficientData */);
+  if (!record2(personal) || personal.itemContentType !== "Full" /* Full */ || value.tags == null || !record2(value.meta) || !isBehaviorVersion(value.meta.version)) {
+    throw behaviorSettingsError("InsufficientData" /* InsufficientData */);
   }
   if (!Array.isArray(value.tags) || !value.tags.every((tag) => typeof tag === "string")) {
-    throw new ServiceBehaviorSettingsError("InvalidResponse" /* InvalidResponse */);
+    throw behaviorSettingsError("InvalidResponse" /* InvalidResponse */);
   }
   const operations = personal.operationList;
   if (operations != null && (!Array.isArray(operations) || !operations.every((operation) => typeof operation === "string" || typeof operation === "number" && Number.isSafeInteger(operation)))) {
-    throw new ServiceBehaviorSettingsError("InvalidResponse" /* InvalidResponse */);
+    throw behaviorSettingsError("InvalidResponse" /* InvalidResponse */);
   }
   return { tags: [...new Set(value.tags)], version: value.meta.version, operations };
 }
 function assertBehaviorPermission(operations) {
-  if (!Array.isArray(operations)) throw new ServiceBehaviorSettingsError("InsufficientData" /* InsufficientData */);
-  if (!operations.includes("SetItemTags" /* SetItemTags */)) throw new ServiceBehaviorSettingsError("AccessDenied" /* AccessDenied */);
+  if (!Array.isArray(operations)) throw behaviorSettingsError("InsufficientData" /* InsufficientData */);
+  if (!operations.includes("SetItemTags" /* SetItemTags */)) throw behaviorSettingsError("AccessDenied" /* AccessDenied */);
 }
 function suffixPrefix(tag, suffix, ignoreCase = false) {
   const matches = ignoreCase ? tag.toLowerCase().endsWith(suffix.toLowerCase()) : tag.endsWith(suffix);
@@ -3724,9 +3836,9 @@ function readBehaviorSettings(tags) {
 }
 function normalizeBehaviorInput(input) {
   function fail() {
-    throw new ServiceBehaviorSettingsError("InvalidInput" /* InvalidInput */);
+    throw behaviorSettingsError("InvalidInput" /* InvalidInput */);
   }
-  if (!record(input) || Object.keys(input).some((key) => !Object.hasOwn(SERVICE_IMPLICIT_TAG_REGISTRY, key))) fail();
+  if (!record2(input) || Object.keys(input).some((key) => !Object.hasOwn(SERVICE_IMPLICIT_TAG_REGISTRY, key))) fail();
   const output = {};
   for (const config of configs) {
     if (!Object.hasOwn(input, config.field)) continue;
@@ -3744,7 +3856,7 @@ function normalizeBehaviorInput(input) {
       if (!Array.isArray(value)) fail();
       const seen = /* @__PURE__ */ new Set();
       output[config.field] = value.map((entry) => {
-        if (!record(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();
+        if (!record2(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);
         const normalized = { index: entry.index };
         for (const attribute of ["text", "link"]) {
@@ -3897,7 +4009,7 @@ var ServicesFacade = class extends TorrowItemFacade {
   /** Читает сырой OpenAPI DTO до проекции, чтобы malformed tags не маскировались парсером. */
   async readBehaviorState(serviceId, options) {
     if (typeof serviceId !== "string" || !serviceId.trim()) {
-      throw new ServiceBehaviorSettingsError("InvalidInput" /* InvalidInput */);
+      throw behaviorSettingsError("InvalidInput" /* InvalidInput */);
     }
     const value = await this.http.requestJson({
       method: "GET",
@@ -3915,8 +4027,12 @@ var ServicesFacade = class extends TorrowItemFacade {
   }
   /** Один GET: версия всей услуги, предметные настройки и диагностика неполного снимка. */
   async getBehaviorSettings(serviceId, options) {
-    const state = await this.readBehaviorState(serviceId, options);
-    return { serviceId, version: state.version, ...readBehaviorSettings(state.tags) };
+    try {
+      const state = await this.readBehaviorState(serviceId, options);
+      return { serviceId, version: state.version, ...readBehaviorSettings(state.tags) };
+    } catch (cause) {
+      throw contextualizeBehaviorError(cause, "ServicesFacade.getBehaviorSettings" /* ServiceGet */, "ReadCurrent" /* ReadCurrent */);
+    }
   }
   /**
    * GET → локальный patch → PUT /tags с необязательной проверкой версии; автоматического readback нет.
@@ -3924,56 +4040,84 @@ var ServicesFacade = class extends TorrowItemFacade {
    * Порядок и одинаковые дубли сервер не сохраняет; no-op определяется множеством строк.
    */
   async updateBehaviorSettings(serviceId, settingsPatch, options = {}) {
-    if (!options || options.versionToCheck !== void 0 && !isBehaviorVersion(options.versionToCheck) || Object.hasOwn(options, "checkVersion") && options.checkVersion !== true || Object.hasOwn(options, "mergeParameters") && typeof options.mergeParameters !== "boolean" || options.isNeedAnnouncement != null && typeof options.isNeedAnnouncement !== "boolean" || Object.keys(options).some((key) => !["versionToCheck", "checkVersion", "mergeParameters", "profileId", "securityToken", "isNeedAnnouncement", "signal"].includes(key))) {
-      throw new ServiceBehaviorSettingsError("InvalidInput" /* InvalidInput */);
-    }
-    const normalized = normalizeBehaviorInput(settingsPatch);
-    options = { ...options };
-    const state = await this.readBehaviorState(serviceId, {
-      profileId: options.profileId,
-      securityToken: options.securityToken,
-      signal: options.signal
-    });
-    assertBehaviorPermission(state.operations);
-    if (options.versionToCheck !== void 0 && state.version !== options.versionToCheck) {
-      throw new ServiceBehaviorSettingsError("VersionConflict" /* VersionConflict */);
-    }
-    const tags = mergeBehaviorSettings(state.tags, normalized, options.mergeParameters ?? true);
-    const projected = readBehaviorSettings(tags);
-    const unchanged = tags.length === state.tags.length && tags.every((tag) => state.tags.includes(tag));
-    if (unchanged) return { serviceId, version: state.version, ...projected, changed: false };
-    let dispatched = false;
-    let result;
+    return this.writeBehaviorSettings(serviceId, settingsPatch, options, "ServicesFacade.updateBehaviorSettings" /* ServiceUpdate */);
+  }
+  /** Общий алгоритм двух публичных операций; контекст и эффект принадлежат только текущему вызову. */
+  async writeBehaviorSettings(serviceId, settingsPatch, options, operation) {
+    let failureAt = "ValidateInput" /* ValidateInput */;
+    let effect = "NotApplied" /* NotApplied */;
     try {
-      result = await this.http.requestJson({
-        method: "PUT",
-        path: `${BASE9}/${encodePathSegment(serviceId)}/tags`,
-        query: { versionToCheck: options.versionToCheck ?? (options.checkVersion ? state.version : void 0), isNeedAnnouncement: options.isNeedAnnouncement ?? false },
-        body: tags,
+      if (!options || options.versionToCheck !== void 0 && !isBehaviorVersion(options.versionToCheck) || Object.hasOwn(options, "checkVersion") && options.checkVersion !== true || Object.hasOwn(options, "mergeParameters") && typeof options.mergeParameters !== "boolean" || options.isNeedAnnouncement != null && typeof options.isNeedAnnouncement !== "boolean" || Object.keys(options).some((key) => !["versionToCheck", "checkVersion", "mergeParameters", "profileId", "securityToken", "isNeedAnnouncement", "signal"].includes(key))) {
+        throw behaviorSettingsError("InvalidInput" /* InvalidInput */);
+      }
+      const normalized = normalizeBehaviorInput(settingsPatch);
+      options = { ...options };
+      failureAt = "ReadCurrent" /* ReadCurrent */;
+      const state = await this.readBehaviorState(serviceId, {
+        profileId: options.profileId,
+        securityToken: options.securityToken,
         signal: options.signal
-      }, () => {
-        dispatched = true;
       });
-    } catch (cause) {
-      if (dispatched && cause instanceof TorrowHttpError && cause.status === 500 && cause.body !== null && typeof cause.body === "object" && "name" in cause.body && cause.body.name === "OBJECT_HAS_WRONG_VERSION" /* VersionConflict */ && "code" in cause.body && (cause.body.code === 208213 /* VersionConflict */ || cause.body.code === String(208213 /* VersionConflict */))) {
-        throw new ServiceBehaviorSettingsError("VersionConflict" /* VersionConflict */, cause);
+      failureAt = "PrepareWrite" /* PrepareWrite */;
+      assertBehaviorPermission(state.operations);
+      if (options.versionToCheck !== void 0 && state.version !== options.versionToCheck) {
+        throw behaviorSettingsError("VersionConflict" /* VersionConflict */);
       }
-      throw new ServiceBehaviorSettingsError(dispatched ? "WriteOutcomeUnknown" /* WriteOutcomeUnknown */ : "RequestNotSent" /* RequestNotSent */, cause);
-    }
-    if (!result || result.id !== serviceId || !isBehaviorVersion(result.meta?.version)) {
-      throw new ServiceBehaviorSettingsError("WriteOutcomeUnknown" /* WriteOutcomeUnknown */);
+      const tags = mergeBehaviorSettings(state.tags, normalized, options.mergeParameters ?? true);
+      const projected = readBehaviorSettings(tags);
+      const unchanged = tags.length === state.tags.length && tags.every((tag) => state.tags.includes(tag));
+      if (unchanged) return { serviceId, version: state.version, ...projected, changed: false };
+      failureAt = "WriteSettings" /* WriteSettings */;
+      let result;
+      let dispatched = false;
+      try {
+        result = await this.http.requestJson({
+          method: "PUT",
+          path: `${BASE9}/${encodePathSegment(serviceId)}/tags`,
+          query: { versionToCheck: options.versionToCheck ?? (options.checkVersion ? state.version : void 0), isNeedAnnouncement: options.isNeedAnnouncement ?? false },
+          body: tags,
+          signal: options.signal
+        }, () => {
+          dispatched = true;
+        });
+      } catch (cause) {
+        effect = dispatched ? "Unknown" /* Unknown */ : "NotApplied" /* NotApplied */;
+        const error = contextualizeBehaviorError(cause, operation, failureAt, effect).withContext({
+          request: dispatched ? "Started" /* Started */ : "NotStarted" /* NotStarted */
+        });
+        if (dispatched && isBehaviorCasRefusal(error)) {
+          effect = "NotApplied" /* NotApplied */;
+          throw error.withContext({
+            category: "VersionConflict" /* VersionConflict */,
+            detail: { domain: "BehaviorSettings" /* BehaviorSettings */ }
+          });
+        }
+        throw error;
+      }
+      effect = "Unknown" /* Unknown */;
+      failureAt = "ValidateWriteResponse" /* ValidateWriteResponse */;
+      if (!result || result.id !== serviceId || !isBehaviorVersion(result.meta?.version)) {
+        throw new TorrowSdkError({
+          category: "InvalidResponse" /* InvalidResponse */,
+          request: "Started" /* Started */,
+          detail: { domain: "BehaviorSettings" /* BehaviorSettings */ },
+          sensitive: { body: result }
+        });
+      }
+      return { serviceId, version: result.meta.version, ...projected, changed: true };
+    } catch (cause) {
+      throw contextualizeBehaviorError(cause, operation, failureAt, effect);
     }
-    return { serviceId, version: result.meta.version, ...projected, changed: true };
   }
   /** Полная замена: пропущенные поля очищаются, посторонние данные сохраняются. */
   setBehaviorSettings(serviceId, settings, options = {}) {
-    return this.updateBehaviorSettings(serviceId, settings, { ...options, mergeParameters: false });
+    return this.writeBehaviorSettings(serviceId, settings, { ...options, mergeParameters: false }, "ServicesFacade.setBehaviorSettings" /* ServiceSet */);
   }
   /**
    * Запись на услугу — `POST /api/v1/services/{serviceId}/order`.
    * Минимум в теле: непустой смысл в `checkInProperties` (слот, участник, контакты — по правилам услуги и OpenAPI).
    * Успех: `OrderResp` (часто интересен `order` как кейс и `consumerSecurityToken` для гостевого доступа).
-   * Типичные отказы: нет слота, услуга недоступна по времени, подписка/баланс — разбирай тело `TorrowHttpError` (`name` / `code`); эталон UX — `torrow-apps` `CreateOrderTask`.
+   * Типичные отказы: нет слота, услуга недоступна по времени, подписка/баланс — разбирай тело `TorrowSdkError` (`name` / `code`); эталон UX — `torrow-apps` `CreateOrderTask`.
    */
   createOrder(serviceId, body, options) {
     return createOrder(this.http, serviceId, body, options);
@@ -5800,21 +5944,30 @@ var ShortUrlFacade = class {
    * Возвращает заголовок `Location` без следования редиректу.
    */
   async getRedirectLocation(shortUrl, options) {
-    const fetchFn = this.config.fetch ?? globalThis.fetch;
-    const origin = this.config.baseUrl ?? DEFAULT_TORROW_API_BASE_URL;
-    const url = joinBaseUrlAndPath(origin, `${BASE27}/${encodePathSegment(shortUrl)}`);
-    const authHeaders = await buildAuthHeaders(this.config);
-    const res = await fetchFn(url, {
-      method: "GET",
-      redirect: "manual",
-      headers: {
-        Accept: "*/*",
-        ...authHeaders,
-        ...this.config.defaultHeaders
-      },
-      signal: options?.signal
-    });
-    return res.headers.get("Location");
+    let request = "NotStarted" /* NotStarted */;
+    let url;
+    try {
+      const fetchFn = this.config.fetch ?? globalThis.fetch;
+      const origin = this.config.baseUrl ?? DEFAULT_TORROW_API_BASE_URL;
+      url = joinBaseUrlAndPath(origin, `${BASE27}/${encodePathSegment(shortUrl)}`);
+      const authHeaders = await buildAuthHeaders(this.config);
+      const init = {
+        method: "GET",
+        redirect: "manual",
+        headers: {
+          Accept: "*/*",
+          ...authHeaders,
+          ...this.config.defaultHeaders
+        },
+        signal: options?.signal
+      };
+      options?.signal?.throwIfAborted();
+      request = "Started" /* Started */;
+      const res = await fetchFn(url, init);
+      return res.headers.get("Location");
+    } catch (cause) {
+      throw normalizeTransportError(cause, request, options?.signal, url);
+    }
   }
 };
 
@@ -6966,8 +7119,8 @@ var ServiceOrderConflictErrorNameValues = {
   ServiceUnavailableAtTime: "SERVICE_IS_NOT_AVAILABLE_AT_TIME"
 };
 function getServiceOrderConflictReason(error) {
-  if (!(error instanceof TorrowHttpError)) return void 0;
-  switch (error.apiErrorName) {
+  if (!(error instanceof TorrowSdkError)) return void 0;
+  switch (error.http?.apiErrorName) {
     case ServiceOrderConflictErrorNameValues.ResourceUnavailable:
       return "resource-unavailable";
     case ServiceOrderConflictErrorNameValues.QuantityUnavailable:
@@ -7171,6 +7324,9 @@ export {
   AuthFacade,
   AuthScopeValueList,
   AuthScopeValues,
+  AuthSessionEffectStep,
+  AuthSessionErrorReason,
+  BehaviorSettingsEffectStep,
   BlockReasonsFacade,
   CalendarsFacade,
   CaseStateValues,
@@ -7206,6 +7362,7 @@ export {
   LoyaltySystemsFacade,
   NoteTypeValues,
   NotesFacade,
+  OtpErrorReason,
   ParticipationFieldRequirementTypeValues,
   ParticipationFieldTypeValues,
   PinnedViewsFacade,
@@ -7219,8 +7376,6 @@ export {
   SearchFacade,
   SendCodeAccountTypeValueList,
   SendCodeAccountTypeValues,
-  ServiceBehaviorSettingsError,
-  ServiceBehaviorSettingsErrorCategory,
   ServiceBehaviorSettingsIssueReason,
   ServiceBuilder,
   ServiceCheckInWizardStepParameterName,
@@ -7241,11 +7396,16 @@ export {
   TokenStatusValueList,
   TokenStatusValues,
   TorrowClient,
-  TorrowHttpError,
   TorrowIdError,
   TorrowItemTypeValueList,
   TorrowItemTypeValues,
   TorrowObjectTypeCode,
+  TorrowSdkEffectArea,
+  TorrowSdkEffectState,
+  TorrowSdkError,
+  TorrowSdkErrorCategory,
+  TorrowSdkErrorDomain,
+  TorrowSdkRequestState,
   UsageConditionTypeValues,
   UsageTypeValues,
   UserAccessLevelValues,