@tearleads/client-sdk 0.1.13 → 0.1.15

package/internal/api-client/principalHistoryRequest.js

@@ -1,4 +1,5 @@
 import { decodeJsonOperationResponse } from "./operationResponse.js";
+import { principalHistoryDeadline } from "./principalHistoryDeadline.js";
 import { PrincipalHistoryRequestContext } from "./principalHistoryRequestContext.js";
 /** Retry only an explicit, validated response proving the operation rolled back. */
 export async function principalHistoryRequest(runtime, input) {
@@ -15,7 +16,7 @@ export async function principalHistoryRequest(runtime, input) {
         if (!decoded.ok && context.restartReadAfterRenewal())
             continue;
         if (!decoded.ok)
-            return decoded;
+            return preserveCommitUncertainty(method, context, decoded);
         if (decoded.data.status === 202) {
             context.afterPreparation();
             const failure = await continuePreparation(decoded.data.data, progress);
@@ -30,38 +31,74 @@ export async function principalHistoryRequest(runtime, input) {
                 });
             continue;
         }
-        if (decoded.data.status !== 200 || !input.validator(decoded.data.data))
-            return runtime.responseRequest.reportFailure({
+        if (decoded.data.status !== 200 || !input.validator(decoded.data.data)) {
+            const failure = runtime.responseRequest.reportFailure({
                 kind: "shape",
                 message: `Invalid principal policy response for ${path}`,
                 method,
-                options,
+                options: method === "GET" ? options : { ...options, reportErrors: false },
                 path,
                 status: decoded.data.status,
                 statusText: decoded.data.statusText,
             });
+            return preserveCommitUncertainty(method, context, failure);
+        }
         return { ok: true, data: decoded.data.data };
     }
 }
+function preserveCommitUncertainty(method, context, failure) {
+    if (method === "GET")
+        return failure;
+    // A network/decode failure or intermediary 5xx says nothing about commit.
+    // Inner write errors are silent until this final classification is known.
+    const ambiguous = failure.kind !== "http" ||
+        ((failure.status ?? 0) >= 500 &&
+            // The declared 503 schema requires the exact code and committed:false.
+            // Unvalidated codes never reach RequestFailure.code.
+            !(failure.status === 503 &&
+                failure.code === "principal_history_preparation_unavailable")) ||
+        failure.status === 408 ||
+        failure.status === 499;
+    const result = ambiguous && failure.kind !== "outcome-unknown"
+        ? context.failure()
+        : failure;
+    if (context.options.reportErrors !== false &&
+        (result.kind === "http" || !context.cancelled()))
+        result.report();
+    return result;
+}
 async function readResponse(runtime, context, input) {
-    const response = await runtime.responseRequest(input.path, input.method, input.body, context.options, [], input.operation);
-    // Authentication rejection precedes the workflow, so renewal does not make
-    // this write's outcome uncertain. Reads may restart after a known renewal.
-    if (!response.ok && response.kind === "http" && response.status === 401)
-        return response;
-    if (context.cancelled())
-        return context.failure(response.ok ? response.data : undefined);
-    if (!response.ok)
-        return response;
-    const decoded = await decodeJsonOperationResponse(runtime.responseRequest, input.operation, response.data, input.path, context.options);
-    if (context.cancelled())
-        return context.failure(response.data);
-    if (!decoded.ok)
-        return decoded;
-    return {
-        ok: true,
-        data: { ...decoded.data, statusText: response.data.statusText },
-    };
+    const deadline = principalHistoryDeadline(context.options, 
+    // Writes await acknowledgement unless the caller supplies a deadline.
+    // Aborting a committed write cannot be repaired by the continuation loop.
+    input.requestTimeoutMs ?? (input.method === "GET" ? undefined : null));
+    const options = input.method === "GET"
+        ? deadline.options
+        : { ...deadline.options, reportErrors: false };
+    try {
+        const response = await runtime.responseRequest(input.path, input.method, input.body, options, [], input.operation);
+        // Authentication rejection precedes the workflow, so renewal does not make
+        // this write's outcome uncertain. Reads may restart after a known renewal.
+        if (!response.ok && response.kind === "http" && response.status === 401)
+            return response;
+        // An expired write remains uncertain even if a failure status arrived.
+        if (context.cancelled() || deadline.expired())
+            return context.failure(response.ok ? response.data : undefined, deadline.expired() && !context.cancelled());
+        if (!response.ok)
+            return response;
+        const decoded = await decodeJsonOperationResponse(runtime.responseRequest, input.operation, response.data, input.path, options);
+        if (context.cancelled() || deadline.expired())
+            return context.failure(response.data, deadline.expired() && !context.cancelled());
+        if (!decoded.ok)
+            return decoded;
+        return {
+            ok: true,
+            data: { ...decoded.data, statusText: response.data.statusText },
+        };
+    }
+    finally {
+        deadline.dispose();
+    }
 }
 async function continuePreparation(data, progress) {
     const token = typeof data === "object" &&

package/internal/api-client/principalHistoryRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"principalHistoryRequest.js","sourceRoot":"","sources":["principalHistoryRequest.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JsonOperation } from \"@tearleads/validators/operation\";\nimport type { ApiRequestRuntime } from \"./apiRequestRuntime\";\nimport { decodeJsonOperationResponse } from \"./operationResponse\";\nimport { PrincipalHistoryRequestContext } from \"./principalHistoryRequestContext\";\nimport type { HttpMethod, RequestResult, RequestResultOptions } from \"./types\";\n\n/** Retry only an explicit, validated response proving the operation rolled back. */\nexport async function principalHistoryRequest<T>(\n  runtime: ApiRequestRuntime,\n  input: {\n    readonly path: string;\n    readonly validator: (value: unknown) => value is T;\n    readonly method: HttpMethod;\n    readonly body?: string;\n    readonly options?: RequestResultOptions;\n    readonly operation: JsonOperation;\n    readonly context?: PrincipalHistoryRequestContext;\n  },\n): Promise<RequestResult<T>> {\n  const { path, method } = input;\n  const context =\n    input.context ??\n    new PrincipalHistoryRequestContext(runtime, method, path, input.options);\n  const options = context.options;\n  const progress: PreparationProgress = { previous: undefined, unchanged: 0 };\n  while (true) {\n    if (context.cancelled()) return context.failure();\n    context.beforeRequest();\n    const decoded = await readResponse(runtime, context, input);\n    if (!decoded.ok && context.restartReadAfterRenewal()) continue;\n    if (!decoded.ok) return decoded;\n    if (decoded.data.status === 202) {\n      context.afterPreparation();\n      const failure = await continuePreparation(decoded.data.data, progress);\n      if (failure)\n        return runtime.responseRequest.reportFailure({\n          ...failure,\n          method,\n          options,\n          path,\n          status: 202,\n          statusText: decoded.data.statusText,\n        });\n      continue;\n    }\n    if (decoded.data.status !== 200 || !input.validator(decoded.data.data))\n      return runtime.responseRequest.reportFailure({\n        kind: \"shape\",\n        message: `Invalid principal policy response for ${path}`,\n        method,\n        options,\n        path,\n        status: decoded.data.status,\n        statusText: decoded.data.statusText,\n      });\n    return { ok: true, data: decoded.data.data };\n  }\n}\n\nasync function readResponse(\n  runtime: ApiRequestRuntime,\n  context: PrincipalHistoryRequestContext,\n  input: {\n    readonly path: string;\n    readonly method: HttpMethod;\n    readonly body?: string;\n    readonly operation: JsonOperation;\n  },\n) {\n  const response = await runtime.responseRequest(\n    input.path,\n    input.method,\n    input.body,\n    context.options,\n    [],\n    input.operation,\n  );\n  // Authentication rejection precedes the workflow, so renewal does not make\n  // this write's outcome uncertain. Reads may restart after a known renewal.\n  if (!response.ok && response.kind === \"http\" && response.status === 401)\n    return response;\n  if (context.cancelled())\n    return context.failure(response.ok ? response.data : undefined);\n  if (!response.ok) return response;\n  const decoded = await decodeJsonOperationResponse(\n    runtime.responseRequest,\n    input.operation,\n    response.data,\n    input.path,\n    context.options,\n  );\n  if (context.cancelled()) return context.failure(response.data);\n  if (!decoded.ok) return decoded;\n  return {\n    ok: true as const,\n    data: { ...decoded.data, statusText: response.data.statusText },\n  };\n}\n\ninterface PreparationProgress {\n  previous: string | undefined;\n  unchanged: number;\n}\n\nasync function continuePreparation(\n  data: unknown,\n  progress: PreparationProgress,\n): Promise<{\n  readonly kind: \"shape\" | \"http\";\n  readonly message: string;\n  readonly code?: string;\n} | null> {\n  const token =\n    typeof data === \"object\" &&\n    data !== null &&\n    \"progressToken\" in data &&\n    typeof data.progressToken === \"string\"\n      ? data.progressToken\n      : undefined;\n  if (token === undefined)\n    return {\n      kind: \"shape\",\n      message: \"Principal preparation progress is missing\",\n    };\n  progress.unchanged = token === progress.previous ? progress.unchanged + 1 : 0;\n  progress.previous = token;\n  if (progress.unchanged >= 2)\n    return {\n      code: \"principal_history_preparation_stalled\",\n      kind: \"http\",\n      message: \"Principal history preparation did not advance; retry later\",\n    };\n  // The next round checks cancellation and identity again before any request.\n  await new Promise<void>((resolve) =>\n    setTimeout(resolve, progress.unchanged ? 250 : 25),\n  );\n  return null;\n}\n"]}
+{"version":3,"file":"principalHistoryRequest.js","sourceRoot":"","sources":["principalHistoryRequest.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JsonOperation } from \"@tearleads/validators/operation\";\nimport type { ApiRequestRuntime } from \"./apiRequestRuntime\";\nimport { decodeJsonOperationResponse } from \"./operationResponse\";\nimport { principalHistoryDeadline } from \"./principalHistoryDeadline\";\nimport { PrincipalHistoryRequestContext } from \"./principalHistoryRequestContext\";\nimport type {\n  HttpMethod,\n  RequestFailure,\n  RequestResult,\n  RequestResultOptions,\n} from \"./types\";\n\n/** Retry only an explicit, validated response proving the operation rolled back. */\nexport async function principalHistoryRequest<T>(\n  runtime: ApiRequestRuntime,\n  input: {\n    readonly path: string;\n    readonly validator: (value: unknown) => value is T;\n    readonly method: HttpMethod;\n    readonly body?: string;\n    readonly options?: RequestResultOptions;\n    readonly operation: JsonOperation;\n    readonly context?: PrincipalHistoryRequestContext;\n    readonly requestTimeoutMs?: number;\n  },\n): Promise<RequestResult<T>> {\n  const { path, method } = input;\n  const context =\n    input.context ??\n    new PrincipalHistoryRequestContext(runtime, method, path, input.options);\n  const options = context.options;\n  const progress: PreparationProgress = { previous: undefined, unchanged: 0 };\n  while (true) {\n    if (context.cancelled()) return context.failure();\n    context.beforeRequest();\n    const decoded = await readResponse(runtime, context, input);\n    if (!decoded.ok && context.restartReadAfterRenewal()) continue;\n    if (!decoded.ok) return preserveCommitUncertainty(method, context, decoded);\n    if (decoded.data.status === 202) {\n      context.afterPreparation();\n      const failure = await continuePreparation(decoded.data.data, progress);\n      if (failure)\n        return runtime.responseRequest.reportFailure({\n          ...failure,\n          method,\n          options,\n          path,\n          status: 202,\n          statusText: decoded.data.statusText,\n        });\n      continue;\n    }\n    if (decoded.data.status !== 200 || !input.validator(decoded.data.data)) {\n      const failure = runtime.responseRequest.reportFailure({\n        kind: \"shape\",\n        message: `Invalid principal policy response for ${path}`,\n        method,\n        options:\n          method === \"GET\" ? options : { ...options, reportErrors: false },\n        path,\n        status: decoded.data.status,\n        statusText: decoded.data.statusText,\n      });\n      return preserveCommitUncertainty(method, context, failure);\n    }\n    return { ok: true, data: decoded.data.data };\n  }\n}\n\nfunction preserveCommitUncertainty(\n  method: HttpMethod,\n  context: PrincipalHistoryRequestContext,\n  failure: RequestFailure,\n): RequestFailure {\n  if (method === \"GET\") return failure;\n  // A network/decode failure or intermediary 5xx says nothing about commit.\n  // Inner write errors are silent until this final classification is known.\n  const ambiguous =\n    failure.kind !== \"http\" ||\n    ((failure.status ?? 0) >= 500 &&\n      // The declared 503 schema requires the exact code and committed:false.\n      // Unvalidated codes never reach RequestFailure.code.\n      !(\n        failure.status === 503 &&\n        failure.code === \"principal_history_preparation_unavailable\"\n      )) ||\n    failure.status === 408 ||\n    failure.status === 499;\n  const result =\n    ambiguous && failure.kind !== \"outcome-unknown\"\n      ? context.failure()\n      : failure;\n  if (\n    context.options.reportErrors !== false &&\n    (result.kind === \"http\" || !context.cancelled())\n  )\n    result.report();\n  return result;\n}\n\nasync function readResponse(\n  runtime: ApiRequestRuntime,\n  context: PrincipalHistoryRequestContext,\n  input: {\n    readonly path: string;\n    readonly method: HttpMethod;\n    readonly body?: string;\n    readonly operation: JsonOperation;\n    readonly requestTimeoutMs?: number;\n  },\n) {\n  const deadline = principalHistoryDeadline(\n    context.options,\n    // Writes await acknowledgement unless the caller supplies a deadline.\n    // Aborting a committed write cannot be repaired by the continuation loop.\n    input.requestTimeoutMs ?? (input.method === \"GET\" ? undefined : null),\n  );\n  const options =\n    input.method === \"GET\"\n      ? deadline.options\n      : { ...deadline.options, reportErrors: false };\n  try {\n    const response = await runtime.responseRequest(\n      input.path,\n      input.method,\n      input.body,\n      options,\n      [],\n      input.operation,\n    );\n    // Authentication rejection precedes the workflow, so renewal does not make\n    // this write's outcome uncertain. Reads may restart after a known renewal.\n    if (!response.ok && response.kind === \"http\" && response.status === 401)\n      return response;\n    // An expired write remains uncertain even if a failure status arrived.\n    if (context.cancelled() || deadline.expired())\n      return context.failure(\n        response.ok ? response.data : undefined,\n        deadline.expired() && !context.cancelled(),\n      );\n    if (!response.ok) return response;\n    const decoded = await decodeJsonOperationResponse(\n      runtime.responseRequest,\n      input.operation,\n      response.data,\n      input.path,\n      options,\n    );\n    if (context.cancelled() || deadline.expired())\n      return context.failure(\n        response.data,\n        deadline.expired() && !context.cancelled(),\n      );\n    if (!decoded.ok) return decoded;\n    return {\n      ok: true as const,\n      data: { ...decoded.data, statusText: response.data.statusText },\n    };\n  } finally {\n    deadline.dispose();\n  }\n}\n\ninterface PreparationProgress {\n  previous: string | undefined;\n  unchanged: number;\n}\n\nasync function continuePreparation(\n  data: unknown,\n  progress: PreparationProgress,\n): Promise<{\n  readonly kind: \"shape\" | \"http\";\n  readonly message: string;\n  readonly code?: string;\n} | null> {\n  const token =\n    typeof data === \"object\" &&\n    data !== null &&\n    \"progressToken\" in data &&\n    typeof data.progressToken === \"string\"\n      ? data.progressToken\n      : undefined;\n  if (token === undefined)\n    return {\n      kind: \"shape\",\n      message: \"Principal preparation progress is missing\",\n    };\n  progress.unchanged = token === progress.previous ? progress.unchanged + 1 : 0;\n  progress.previous = token;\n  if (progress.unchanged >= 2)\n    return {\n      code: \"principal_history_preparation_stalled\",\n      kind: \"http\",\n      message: \"Principal history preparation did not advance; retry later\",\n    };\n  // The next round checks cancellation and identity again before any request.\n  await new Promise<void>((resolve) =>\n    setTimeout(resolve, progress.unchanged ? 250 : 25),\n  );\n  return null;\n}\n"]}

package/internal/api-client/principalHistoryRequestContext.js

@@ -46,18 +46,31 @@ export class PrincipalHistoryRequestContext {
         this.restartedRead = true;
         return true;
     }
-    failure(response) {
+    failure(response, timedOut = false) {
         void response?.body?.cancel().catch(() => { });
         return this.runtime.responseRequest.reportFailure({
             code: this.submitted
                 ? "principal_history_outcome_unknown"
-                : "principal_history_context_changed",
-            kind: this.submitted ? "outcome-unknown" : "cancelled",
+                : timedOut
+                    ? "principal_history_request_timed_out"
+                    : "principal_history_context_changed",
+            kind: this.submitted
+                ? "outcome-unknown"
+                : timedOut
+                    ? "network"
+                    : "cancelled",
             message: this.submitted
                 ? "Policy request may have committed; refresh before retrying"
-                : "Principal history request was cancelled",
+                : timedOut
+                    ? "Principal history request timed out"
+                    : "Principal history request was cancelled",
             method: this.method,
-            options: { ...this.options, reportErrors: false },
+            options: {
+                ...this.options,
+                reportErrors: timedOut &&
+                    this.method === "GET" &&
+                    this.options.reportErrors !== false,
+            },
             path: this.path,
             status: null,
             statusText: "",

package/internal/api-client/principalHistoryRequestContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"principalHistoryRequestContext.js","sourceRoot":"","sources":["principalHistoryRequestContext.ts"],"names":[],"mappings":"AAGA,gGAAgG;AAChG,MAAM,OAAO,8BAA8B;IAQtB;IACA;IACA;IATV,OAAO,CAAuB;IAC/B,KAAK,CAAgB;IACrB,SAAS,GAAG,KAAK,CAAC;IAClB,WAAW,GAAG,KAAK,CAAC;IACpB,aAAa,GAAG,KAAK,CAAC;IAE9B,YACmB,OAA0B,EAC1B,MAAkB,EAClB,IAAY,EAC7B,OAAyC;QAHxB,YAAO,GAAP,OAAO,CAAmB;QAC1B,WAAM,GAAN,MAAM,CAAY;QAClB,SAAI,GAAJ,IAAI,CAAQ;QAG7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG;YACb,GAAG,OAAO;YACV,qBAAqB,EACnB,OAAO,EAAE,qBAAqB,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY;YACjE,gBAAgB,EAAE,GAAG,EAAE;gBACrB,IAAI,MAAM,KAAK,KAAK,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;oBAClD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;oBACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBAC1B,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,SAAS;QACP,OAAO,CACL,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI;YACrC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,IAAI,CAAC,KAAK,CAC3C,CAAC;IACJ,CAAC;IAED,aAAa;QACX,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC;IACzC,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,aAAa;QACX,sEAAsE;QACtE,sEAAsE;QACtE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,uBAAuB;QACrB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,EAAE;YAC7D,OAAO,KAAK,CAAC;QACf,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,QAAmB;QACzB,KAAK,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC;YAChD,IAAI,EAAE,IAAI,CAAC,SAAS;gBAClB,CAAC,CAAC,mCAAmC;gBACrC,CAAC,CAAC,mCAAmC;YACvC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW;YACtD,OAAO,EAAE,IAAI,CAAC,SAAS;gBACrB,CAAC,CAAC,4DAA4D;gBAC9D,CAAC,CAAC,yCAAyC;YAC7C,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE;YACjD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import type { ApiRequestRuntime } from \"./apiRequestRuntime\";\nimport type { HttpMethod, RequestFailure, RequestResultOptions } from \"./types\";\n\n/** Keep continuations within their authentication context without hiding commit uncertainty. */\nexport class PrincipalHistoryRequestContext {\n  readonly options: RequestResultOptions;\n  private token: string | null;\n  private submitted = false;\n  private renewedRead = false;\n  private restartedRead = false;\n\n  constructor(\n    private readonly runtime: ApiRequestRuntime,\n    private readonly method: HttpMethod,\n    private readonly path: string,\n    options: RequestResultOptions | undefined,\n  ) {\n    this.token = runtime.getAuthToken();\n    this.options = {\n      ...options,\n      retryOnSessionExpired:\n        options?.retryOnSessionExpired === false ? false : \"renew-only\",\n      onSessionRenewed: () => {\n        if (method === \"GET\" && !options?.signal?.aborted) {\n          this.token = runtime.getAuthToken();\n          this.renewedRead = true;\n        }\n      },\n    };\n  }\n\n  cancelled(): boolean {\n    return (\n      this.options.signal?.aborted === true ||\n      this.runtime.getAuthToken() !== this.token\n    );\n  }\n\n  beforeRequest(): void {\n    this.submitted = this.method !== \"GET\";\n  }\n\n  afterPreparation(): void {\n    this.submitted = false;\n  }\n\n  afterReadPage(): void {\n    // A completed page is forward progress. A later page may renew again,\n    // while repeated 401s within one page still cannot loop indefinitely.\n    this.renewedRead = false;\n    this.restartedRead = false;\n  }\n\n  restartReadAfterRenewal(): boolean {\n    if (!this.renewedRead || this.restartedRead || this.cancelled())\n      return false;\n    this.restartedRead = true;\n    return true;\n  }\n\n  failure(response?: Response): RequestFailure {\n    void response?.body?.cancel().catch(() => {});\n    return this.runtime.responseRequest.reportFailure({\n      code: this.submitted\n        ? \"principal_history_outcome_unknown\"\n        : \"principal_history_context_changed\",\n      kind: this.submitted ? \"outcome-unknown\" : \"cancelled\",\n      message: this.submitted\n        ? \"Policy request may have committed; refresh before retrying\"\n        : \"Principal history request was cancelled\",\n      method: this.method,\n      options: { ...this.options, reportErrors: false },\n      path: this.path,\n      status: null,\n      statusText: \"\",\n    });\n  }\n}\n"]}
+{"version":3,"file":"principalHistoryRequestContext.js","sourceRoot":"","sources":["principalHistoryRequestContext.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ApiRequestRuntime } from \"./apiRequestRuntime\";\nimport type { HttpMethod, RequestFailure, RequestResultOptions } from \"./types\";\n\n/** Keep continuations within their authentication context without hiding commit uncertainty. */\nexport class PrincipalHistoryRequestContext {\n  readonly options: RequestResultOptions;\n  private token: string | null;\n  private submitted = false;\n  private renewedRead = false;\n  private restartedRead = false;\n\n  constructor(\n    private readonly runtime: ApiRequestRuntime,\n    private readonly method: HttpMethod,\n    private readonly path: string,\n    options: RequestResultOptions | undefined,\n  ) {\n    this.token = runtime.getAuthToken();\n    this.options = {\n      ...options,\n      retryOnSessionExpired:\n        options?.retryOnSessionExpired === false ? false : \"renew-only\",\n      onSessionRenewed: () => {\n        if (method === \"GET\" && !options?.signal?.aborted) {\n          this.token = runtime.getAuthToken();\n          this.renewedRead = true;\n        }\n      },\n    };\n  }\n\n  cancelled(): boolean {\n    return (\n      this.options.signal?.aborted === true ||\n      this.runtime.getAuthToken() !== this.token\n    );\n  }\n\n  beforeRequest(): void {\n    this.submitted = this.method !== \"GET\";\n  }\n\n  afterPreparation(): void {\n    this.submitted = false;\n  }\n\n  afterReadPage(): void {\n    // A completed page is forward progress. A later page may renew again,\n    // while repeated 401s within one page still cannot loop indefinitely.\n    this.renewedRead = false;\n    this.restartedRead = false;\n  }\n\n  restartReadAfterRenewal(): boolean {\n    if (!this.renewedRead || this.restartedRead || this.cancelled())\n      return false;\n    this.restartedRead = true;\n    return true;\n  }\n\n  failure(response?: Response, timedOut = false): RequestFailure {\n    void response?.body?.cancel().catch(() => {});\n    return this.runtime.responseRequest.reportFailure({\n      code: this.submitted\n        ? \"principal_history_outcome_unknown\"\n        : timedOut\n          ? \"principal_history_request_timed_out\"\n          : \"principal_history_context_changed\",\n      kind: this.submitted\n        ? \"outcome-unknown\"\n        : timedOut\n          ? \"network\"\n          : \"cancelled\",\n      message: this.submitted\n        ? \"Policy request may have committed; refresh before retrying\"\n        : timedOut\n          ? \"Principal history request timed out\"\n          : \"Principal history request was cancelled\",\n      method: this.method,\n      options: {\n        ...this.options,\n        reportErrors:\n          timedOut &&\n          this.method === \"GET\" &&\n          this.options.reportErrors !== false,\n      },\n      path: this.path,\n      status: null,\n      statusText: \"\",\n    });\n  }\n}\n"]}