@orangecheck/me-client 0.9.0 → 0.12.0

package/dist/index.mjs

@@ -38,22 +38,69 @@ async function api(path, opts = {}) {
   });
   if (!res.ok) {
     let message = `me.ochk.io ${res.status}`;
+    let errorCode;
+    let body;
     try {
       const data = await res.json();
-      if (data?.error) message = data.error;
+      body = data;
+      if (data?.error) {
+        errorCode = data.error;
+        message = data.reason ?? data.error;
+      }
     } catch {
     }
-    throw new MeClientError(message, res.status);
+    let retryAfterSeconds;
+    if (res.status === 429) {
+      const headerValue = res.headers.get("retry-after");
+      if (headerValue) {
+        const parsed = Number.parseInt(headerValue, 10);
+        if (Number.isFinite(parsed) && parsed >= 0) retryAfterSeconds = parsed;
+      }
+      if (retryAfterSeconds == null && typeof body?.retry_after_seconds === "number") {
+        retryAfterSeconds = body.retry_after_seconds;
+      }
+    }
+    throw new MeClientError(message, res.status, { errorCode, retryAfterSeconds });
   }
   return await res.json();
 }
 var MeClientError = class extends Error {
-  constructor(message, status) {
+  constructor(message, status, opts) {
     super(message);
     this.name = "MeClientError";
     this.status = status;
+    this.errorCode = opts?.errorCode;
+    this.retryAfterSeconds = opts?.retryAfterSeconds;
+  }
+  /** True for the 429 surface · convenience boolean so callers don't
+   *  have to compare status === 429 every time. */
+  get isRateLimited() {
+    return this.status === 429;
   }
 };
+async function withRateLimitRetry(fn, opts = {}) {
+  const maxRetries = opts.maxRetries ?? 2;
+  const maxRetryAfter = opts.maxRetryAfterSeconds ?? 30;
+  const baseBackoff = opts.baseBackoffMs ?? 250;
+  let attempt = 0;
+  while (true) {
+    try {
+      return await fn();
+    } catch (err) {
+      if (!(err instanceof MeClientError) || !err.isRateLimited) throw err;
+      if (attempt >= maxRetries) throw err;
+      let waitMs;
+      if (err.retryAfterSeconds != null) {
+        if (err.retryAfterSeconds > maxRetryAfter) throw err;
+        waitMs = err.retryAfterSeconds * 1e3;
+      } else {
+        waitMs = baseBackoff * 2 ** attempt;
+      }
+      await new Promise((resolve) => setTimeout(resolve, waitMs));
+      attempt++;
+    }
+  }
+}
 
 // src/session.ts
 var DEFAULT_POLICY = {
@@ -109,7 +156,7 @@ async function invalidate(sessionId) {
 }
 var session = { create, refresh, invalidate };
 function OcSignInButton({
-  scope,
+  scope: scope2,
   sessionPolicy,
   returnTo,
   onSignin,
@@ -130,7 +177,7 @@ function OcSignInButton({
         if (event2.defaultPrevented) return;
         setPending(true);
         try {
-          const result = await session.create({ scope, sessionPolicy, returnTo });
+          const result = await session.create({ scope: scope2, sessionPolicy, returnTo });
           onSignin?.(result);
         } catch (err) {
           onSignInError?.(err instanceof Error ? err : new Error(String(err)));
@@ -272,6 +319,23 @@ async function fire(options) {
     body: options
   });
 }
+async function fireBatch(options) {
+  if (!options.project_key) {
+    throw new Error("event.fireBatch requires project_key");
+  }
+  if (!Array.isArray(options.events) || options.events.length === 0) {
+    throw new Error("event.fireBatch requires at least one event");
+  }
+  if (options.events.length > 100) {
+    throw new Error(
+      `event.fireBatch \xB7 max 100 events per call (got ${options.events.length}). Split client-side.`
+    );
+  }
+  return api("/api/integrator/event/batch", {
+    method: "POST",
+    body: options
+  });
+}
 function verify(envelope, config2, payment_amount_sats) {
   const issues = [];
   const eventCfg = config2.events[envelope.subtype];
@@ -356,7 +420,7 @@ function verify(envelope, config2, payment_amount_sats) {
     issues
   };
 }
-var event = { fire, verify };
+var event = { fire, fireBatch, verify };
 
 // src/config.ts
 function validate(cfg) {
@@ -722,9 +786,60 @@ async function defaultLive() {
 }
 var federations = { list, live, get, defaultLive };
 
+// src/scope.ts
+var VALID_SCOPES = [
+  "bitcoin_address",
+  "email",
+  "attest_tier",
+  "display_name"
+];
+async function granted(options) {
+  if (!options.project_key) {
+    throw new Error("oc.scope.granted: project_key is required");
+  }
+  const r = await api(
+    `/api/integrator/scopes/${encodeURIComponent(options.project_key)}`,
+    { method: "GET", signal: options.signal }
+  );
+  return {
+    sub: r.sub,
+    scopes_granted: r.scopes_granted,
+    scopes: r.scopes
+  };
+}
+function request(scopes, options) {
+  if (!options.project_key) {
+    throw new Error("oc.scope.request: project_key is required");
+  }
+  if (!options.return_to) {
+    throw new Error("oc.scope.request: return_to is required");
+  }
+  if (!Array.isArray(scopes) || scopes.length === 0) {
+    throw new Error("oc.scope.request: scopes must be a non-empty array");
+  }
+  for (const s of scopes) {
+    if (!VALID_SCOPES.includes(s)) {
+      throw new Error(
+        `oc.scope.request: unknown scope "${s}" \xB7 valid: ${VALID_SCOPES.join(", ")}`
+      );
+    }
+  }
+  if (typeof window === "undefined") {
+    throw new Error("oc.scope.request: must be called in a browser environment");
+  }
+  const origin2 = options.origin ?? getOrigin();
+  const url = new URL("/me/scope-grant", origin2);
+  url.searchParams.set("project_key", options.project_key);
+  url.searchParams.set("scopes", scopes.join(","));
+  url.searchParams.set("return_to", options.return_to);
+  window.location.assign(url.toString());
+  throw new Error("oc.scope.request: redirected to consent prompt");
+}
+var scope = { granted, request };
+
 // src/index.ts
-var oc = { session, payment, event, config, webhook, federations };
+var oc = { session, payment, event, config, webhook, federations, scope };
 
-export { MIN_INTEGRATOR_PRICE_SATS, MeClientError, OcSignInButton, PLATFORM_FEE_POLICY, clearBearerToken, computeFees, config, event, federations, getBearerToken, getOrigin, oc, onTelemetry, payment, session, setBearerToken, setOrigin, validateIntegratorConfig, webhook };
+export { MIN_INTEGRATOR_PRICE_SATS, MeClientError, OcSignInButton, PLATFORM_FEE_POLICY, clearBearerToken, computeFees, config, event, federations, getBearerToken, getOrigin, oc, onTelemetry, payment, scope, session, setBearerToken, setOrigin, validateIntegratorConfig, webhook, withRateLimitRetry };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map