@domino-sdk/relay 1.62.0 → 1.65.0

package/dist/{chunk-UPQPUJOU.js → chunk-CVQZ2YP7.js}

@@ -1,18 +1,20 @@
+import {
+  createHttpExchange,
+  uncertainStatuses
+} from "./chunk-7H4MRVQF.js";
 import {
   MANAGEMENT_TIMEOUT,
-  clientIdentity,
   lifetime,
-  retryAfter,
   retrying,
   validTimeout
-} from "./chunk-3PYYGFSB.js";
+} from "./chunk-DLABJSBO.js";
 import {
   knownResponse
-} from "./chunk-MK425RXJ.js";
+} from "./chunk-HNR6G3GV.js";
 import {
   RequestError,
   isRequestError
-} from "./chunk-K2KS3JLY.js";
+} from "./chunk-EOUEAOWJ.js";
 
 // src/configuration.ts
 function questConfiguration(release) {
@@ -40,11 +42,10 @@ var ManagementErrorCode = {
   Aborted: "aborted",
   InvalidResponse: "invalid-response"
 };
-var managementErrorSchema = z.looseObject({
+var managementErrorSchema = /* @__PURE__ */ (() => z.looseObject({
   error: z.string(),
   code: z.string().optional()
-});
-var uncertainStatuses = /* @__PURE__ */ new Set([500, 502, 504]);
+}))();
 function uncertainOutcome(init) {
   if (init.method === void 0 || init.method === "GET") {
     return false;
@@ -62,7 +63,7 @@ function uncertainOutcome(init) {
       return false;
   }
 }
-var managementErrorBrand = /* @__PURE__ */ Symbol.for("@domino-sdk/relay.ManagementError");
+var managementErrorBrand = /* @__PURE__ */ (() => /* @__PURE__ */ Symbol.for("@domino-sdk/relay.ManagementError"))();
 function isManagementError(value) {
   return isRequestError(value) && value[managementErrorBrand] === true;
 }
@@ -139,182 +140,63 @@ function checkedTimeout(timeout) {
 }
 function managementTransport(options) {
   const clientTimeout = checkedTimeout(options.timeout) ?? DEFAULT_MANAGEMENT_TIMEOUT;
-  try {
-    const headers = new Headers(options.headers);
-    headers.set("X-Relay-Organization", options.organization ?? "");
-    headers.set("X-Relay-Project", options.project ?? "");
-  } catch (error) {
-    throw new ManagementError({
-      kind: "client",
-      code: ManagementErrorCode.InvalidInput,
-      message: "Management headers, organization and project must be valid HTTP header values",
-      cause: error
-    });
-  }
+  const redirect = options.redirect ? { redirect: options.redirect } : {};
+  const http = createHttpExchange(
+    {
+      baseUrl: `${options.baseUrl}/management/v1`,
+      headers: options.headers,
+      getToken: options.getToken,
+      fetch: options.fetch,
+      organization: options.organization,
+      project: options.project,
+      environment: options.environment
+    },
+    {
+      client: options.client,
+      credentialLast: true,
+      // A redirect fetch refused to follow was answered without being applied. The participant
+      // client has no such rule, so there a write that failed to connect stays uncertain.
+      neverSent: (error) => unsent(error) || redirected(error),
+      abortReason: true,
+      messages: {
+        aborted: "The management request was cancelled",
+        timeout: (milliseconds) => `The management request did not finish within ${milliseconds} ms`,
+        network: () => "The management request failed before Domino answered",
+        credential: "Could not get a management credential",
+        invalidToken: "getToken returned a value that is not a token",
+        invalidOptions: "Management headers, organization and project must be valid HTTP header values"
+        // No `unsendable`: a header or body that cannot be sent rejects with the platform's error.
+      },
+      makeError: (message, error, context) => new ManagementError({ ...context, ...error, message }),
+      // A body that is not the server's error JSON still rejects with the status.
+      parseRefusal: (body) => {
+        const parsed = managementErrorSchema.safeParse(body);
+        if (!parsed.success) {
+          return {};
+        }
+        const { error, code, ...details } = parsed.data;
+        return { message: error, code, details };
+      }
+    }
+  );
   function callLifetime(call) {
     return lifetime(
       checkedTimeout(call?.timeout) ?? clientTimeout,
       call?.signal ?? void 0
     );
   }
-  function transportFailure(error, context, life, sent, status, refused = false, headers) {
-    if (error instanceof ManagementError) {
-      return error;
-    }
-    const unsent2 = {
-      retryAfter: headers ? retryAfter(headers) : void 0,
-      // A redirect fetch refused to follow was answered without being applied.
-      ...!sent || redirected(error) ? { uncertain: false } : refused ? {
-        uncertain: context.method !== "GET" && [500, 502, 504].includes(status ?? 0)
-      } : {},
-      ...status === void 0 ? {} : { status }
-    };
-    const ended = life.ended();
-    if (ended === "aborted") {
-      return new ManagementError({
-        ...context,
-        ...unsent2,
-        kind: "aborted",
-        code: ManagementErrorCode.Aborted,
-        message: "The management request was cancelled",
-        cause: life.reason()
-      });
-    }
-    if (ended === "timeout") {
-      return new ManagementError({
-        ...context,
-        ...unsent2,
-        kind: "timeout",
-        code: ManagementErrorCode.Timeout,
-        message: `The management request did not finish within ${life.timeout} ms`,
-        cause: error
-      });
-    }
-    return new ManagementError({
-      ...context,
-      ...unsent2,
-      kind: "network",
-      code: ManagementErrorCode.Network,
-      message: "The management request failed before Domino answered",
-      cause: error
-    });
-  }
-  async function credential(context, life) {
-    if (!options.getToken) {
-      return null;
-    }
-    const getToken = options.getToken;
-    try {
-      return await new Promise((resolve, reject) => {
-        const stop = () => reject(life.signal.reason);
-        life.signal.addEventListener("abort", stop, { once: true });
-        getToken().then(resolve, reject).finally(() => life.signal.removeEventListener("abort", stop));
-      });
-    } catch (error) {
-      if (life.signal.aborted) {
-        throw transportFailure(error, context, life, false);
-      }
-      throw new ManagementError({
-        ...context,
-        // A token source that could not reach its own service failed like a network call.
-        kind: error instanceof TypeError ? "network" : "client",
-        code: ManagementErrorCode.Credential,
-        uncertain: false,
-        message: "Could not get a management credential",
-        cause: error
-      });
-    }
-  }
-  async function send(path, fetchInit, context, life) {
-    if (life.signal.aborted) {
-      throw transportFailure(life.reason(), context, life, false);
-    }
-    const headers = new Headers(options.headers);
-    new Headers(fetchInit.headers).forEach(
-      (value, name) => headers.set(name, value)
-    );
-    headers.set("X-Domino-Client", options.client ?? clientIdentity());
-    const token = await credential(context, life);
-    if (token) {
-      try {
-        headers.set("Authorization", `Bearer ${token}`);
-      } catch (error) {
-        throw new ManagementError({
-          ...context,
-          kind: "client",
-          code: ManagementErrorCode.Credential,
-          uncertain: false,
-          message: "getToken returned a value that is not a token",
-          cause: error
-        });
-      }
-    } else if (options.getToken) {
-      headers.delete("Authorization");
-    }
-    if (options.organization) {
-      headers.set("X-Relay-Organization", options.organization);
-    }
-    if (options.project) {
-      headers.set("X-Relay-Project", options.project);
-    }
-    if (options.environment) {
-      headers.set("X-Relay-Environment", options.environment);
-    }
-    let response;
-    try {
-      response = await (options.fetch ?? fetch)(
-        `${options.baseUrl}/management/v1${path}`,
-        {
-          ...fetchInit,
-          headers,
-          signal: life.signal,
-          ...options.redirect ? { redirect: options.redirect } : {}
-        }
-      );
-    } catch (error) {
-      throw transportFailure(error, context, life, !unsent(error));
-    }
-    if (!response.ok) {
-      let text;
-      try {
-        text = await response.text();
-      } catch (error2) {
-        throw transportFailure(
-          error2,
-          context,
-          life,
-          true,
-          response.status,
-          true,
-          response.headers
-        );
-      }
-      let body = null;
-      try {
-        body = JSON.parse(text);
-      } catch {
-      }
-      const parsed = managementErrorSchema.safeParse(body);
-      const { error, code, ...details } = parsed.success ? parsed.data : { error: `Request failed (${response.status})`, code: void 0 };
-      throw new ManagementError({
-        ...context,
-        kind: "http",
-        status: response.status,
-        message: error,
-        ...code === void 0 ? {} : { code },
-        details,
-        retryAfter: retryAfter(response.headers)
-      });
-    }
-    return response;
-  }
   async function raw(path, init) {
     const { timeout, signal, ...fetchInit } = init ?? {};
     const life = callLifetime({ timeout, signal: signal ?? void 0 });
     try {
-      return await send(
+      return await http.send(
         path,
-        fetchInit,
+        {
+          method: fetchInit.method,
+          headers: fetchInit.headers,
+          body: fetchInit.body,
+          init: { ...fetchInit, ...redirect }
+        },
         {
           method: (fetchInit.method ?? "GET").toUpperCase(),
           path: path.split("?")[0],
@@ -334,31 +216,24 @@ function managementTransport(options) {
       path: path.split("?")[0],
       ...actionId ? { actionId } : {}
     };
-    const fetchInit = {
+    const tolerance = tolerant ? { "X-Domino-Response": "tolerant-v1" } : {};
+    const request = input instanceof ManagementUploadBody ? {
       method,
-      headers: tolerant ? { "X-Domino-Response": "tolerant-v1" } : void 0,
-      ...input === void 0 ? {} : input instanceof ManagementUploadBody ? {
-        headers: {
-          "Content-Type": input.body.type,
-          ...input.headers,
-          ...tolerant ? { "X-Domino-Response": "tolerant-v1" } : {}
-        },
-        body: input.body
-      } : {
-        headers: {
-          "Content-Type": "application/json",
-          ...tolerant ? { "X-Domino-Response": "tolerant-v1" } : {}
-        },
-        body: JSON.stringify(input)
-      }
-    };
+      headers: {
+        "Content-Type": input.body.type,
+        ...input.headers,
+        ...tolerance
+      },
+      body: input.body,
+      init: redirect
+    } : { method, headers: tolerance, json: input, init: redirect };
     const life = callLifetime(call);
     try {
       return await retrying(
         life,
         { replaySafe: method === "GET" || replaySafe },
         async () => {
-          const response = await send(path, fetchInit, context, life);
+          const response = await http.send(path, request, context, life);
           let body;
           try {
             body = response.status === 204 ? null : await response.json();
@@ -373,15 +248,11 @@ function managementTransport(options) {
                 cause: error
               });
             }
-            throw transportFailure(
-              error,
-              context,
-              life,
-              true,
-              response.status,
-              false,
-              response.headers
-            );
+            throw http.interrupted(error, method, context, life, {
+              sent: true,
+              status: response.status,
+              headers: response.headers
+            });
           }
           const parsed = knownResponse(schema).safeParse(
             tolerant ? { status: response.status, operationId: actionId, result: body } : body
@@ -421,7 +292,7 @@ function managementTransport(options) {
 
 // src/sequence-cursor.ts
 import * as z3 from "zod";
-var sequenceCursorSchema = z3.string().regex(/^[1-9][0-9]{0,15}$/, "Invalid cursor").transform(Number).pipe(z3.number().int().positive().safe());
+var sequenceCursorSchema = /* @__PURE__ */ (() => z3.string().regex(/^[1-9][0-9]{0,15}$/, "Invalid cursor").transform(Number).pipe(z3.number().int().positive().safe()))();
 
 // src/referral-reward-kinds.ts
 var REFERRAL_INTEGRATION_REWARD_ERROR = "Referral programs can grant points and tiered rewards; Discord roles need a quest";

package/dist/{chunk-3PYYGFSB.js → chunk-DLABJSBO.js}

@@ -1,10 +1,10 @@
 import {
   isRequestError
-} from "./chunk-K2KS3JLY.js";
+} from "./chunk-EOUEAOWJ.js";
 
 // package.json
 var name = "@domino-sdk/relay";
-var version = "1.62.0";
+var version = "1.65.0";
 
 // src/client-identity.ts
 function clientIdentity() {
@@ -16,7 +16,7 @@ function clientIdentity() {
 var PARTICIPANT_TIMEOUT = 15e3;
 var MANAGEMENT_TIMEOUT = 3e4;
 var MAX_ATTEMPTS = 3;
-var transientStatuses = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+var transientStatuses = /* @__PURE__ */ (() => /* @__PURE__ */ new Set([429, 500, 502, 503, 504]))();
 function validTimeout(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0;
 }

package/dist/{chunk-Y322OTCH.js → chunk-E22XSC4L.js}

@@ -2,7 +2,7 @@ import {
   RelayErrorCode,
   clientError,
   isRequestError
-} from "./chunk-K2KS3JLY.js";
+} from "./chunk-EOUEAOWJ.js";
 
 // src/action.ts
 function withActionId(value) {

package/dist/{chunk-E6IKQHTX.js → chunk-EDNKKVGU.js}

@@ -4,10 +4,10 @@ import {
   imageFieldsSchema,
   imageInspectionSchema,
   imageSightingsSchema
-} from "./chunk-QYPMPWVX.js";
+} from "./chunk-XVZ4YOF2.js";
 import {
   photoResultSchema
-} from "./chunk-MK425RXJ.js";
+} from "./chunk-HNR6G3GV.js";
 
 // src/image-results.ts
 import * as z from "zod";

package/dist/{chunk-K2KS3JLY.js → chunk-EOUEAOWJ.js}

@@ -1,5 +1,5 @@
 // src/request-error.ts
-var requestErrorBrand = /* @__PURE__ */ Symbol.for("@domino-sdk/relay.RequestError");
+var requestErrorBrand = /* @__PURE__ */ (() => /* @__PURE__ */ Symbol.for("@domino-sdk/relay.RequestError"))();
 function isRequestError(value) {
   return typeof value === "object" && value !== null && value[requestErrorBrand] === true;
 }
@@ -31,13 +31,37 @@ var RequestError = class extends Error {
   }
 };
 
+// src/definition-error.ts
+function issueText(issues) {
+  return [
+    ...new Set(
+      issues.map(
+        (issue) => issue.path.length ? issue.path.map(String).join(".") + ": " + issue.message : issue.message
+      )
+    )
+  ].join("; ");
+}
+function parseDefinition(kind, schema, input) {
+  const parsed = schema.safeParse(input);
+  if (parsed.success) {
+    return parsed.data;
+  }
+  const key = typeof input === "object" && input !== null && "key" in input && typeof input.key === "string" ? ` "${input.key}"` : "";
+  parsed.error.message = `${kind}${key} is invalid: ${issueText(parsed.error.issues)}`;
+  throw parsed.error;
+}
+
 // src/errors.ts
-import * as z from "zod";
 var RelayErrorCode = {
   /** The call needs a signed-in member. */
   NotSignedIn: "not-signed-in",
   /** The session changed since the app read it (the `session` option). Reload before retrying. */
   StaleSession: "stale-session",
+  /**
+   * A participant backend (`createParticipantBackend`) refused the call because the app's own
+   * sign-in ended. The SDK treats it like `not-signed-in`: the member is signed out.
+   */
+  Unauthenticated: "unauthenticated",
   /** The input failed validation before it was sent. */
   InvalidInput: "invalid-input",
   /** Relay's answer was not JSON or not the expected shape (kind `invalid-response`). */
@@ -116,6 +140,11 @@ var RelayErrorCode = {
   QuestClosed: "quest-closed",
   /** An operator paused the quest. */
   QuestPaused: "quest-paused",
+  /**
+   * The member is banned from the project, so their attempts, completions and invitations are
+   * refused. Relay gives no reason; `me()` answers `eligible: false`.
+   */
+  MemberBanned: "member-banned",
   /** An operator locked the member's profile; hiding it is still allowed. */
   ProfileLocked: "profile-locked",
   /** No member in the project has the invitation code the member accepted. */
@@ -129,7 +158,7 @@ var RelayErrorCode = {
   /** Too many requests; `retryAfter` says how long to wait when Relay knows. */
   RateLimited: "rate-limited"
 };
-var relayErrorBrand = /* @__PURE__ */ Symbol.for("@domino-sdk/relay.RelayError");
+var relayErrorBrand = /* @__PURE__ */ (() => /* @__PURE__ */ Symbol.for("@domino-sdk/relay.RelayError"))();
 function isRelayError(value) {
   return isRequestError(value) && value[relayErrorBrand] === true;
 }
@@ -168,7 +197,7 @@ function parseInput(schema, value) {
   const parsed = schema.safeParse(value);
   if (!parsed.success) {
     throw clientError(
-      z.prettifyError(parsed.error),
+      issueText(parsed.error.issues),
       RelayErrorCode.InvalidInput,
       { cause: parsed.error }
     );
@@ -179,6 +208,8 @@ function parseInput(schema, value) {
 export {
   isRequestError,
   RequestError,
+  issueText,
+  parseDefinition,
   RelayErrorCode,
   isRelayError,
   RelayError,

package/dist/{chunk-6WCIWXUV.js → chunk-EUEW2APU.js}

@@ -1,10 +1,10 @@
 import {
   RelayErrorCode,
   clientError
-} from "./chunk-K2KS3JLY.js";
+} from "./chunk-EOUEAOWJ.js";
 
 // src/plugin-client.ts
-var transportKey = /* @__PURE__ */ Symbol.for("@domino-sdk/relay:plugin-transport");
+var transportKey = /* @__PURE__ */ (() => /* @__PURE__ */ Symbol.for("@domino-sdk/relay:plugin-transport"))();
 function setPluginTransport(client, transport) {
   Object.defineProperty(client, transportKey, { value: transport });
 }