@iqauth/sdk 2.2.0 → 2.5.0

package/dist/chunk-UKZLOHZG.mjs

@@ -0,0 +1,83 @@
+// src/webhooks.ts
+import crypto from "crypto";
+var WebhookSignatureError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.name = "WebhookSignatureError";
+    this.code = code;
+  }
+};
+function toBuffer(p) {
+  if (typeof p === "string") return Buffer.from(p, "utf8");
+  if (Buffer.isBuffer(p)) return p;
+  return Buffer.from(p);
+}
+function parseHeader(header) {
+  let t = NaN;
+  const v1 = [];
+  for (const part of header.split(",")) {
+    const [k, v] = part.split("=", 2);
+    if (!k || v === void 0) continue;
+    const key = k.trim();
+    const value = v.trim();
+    if (key === "t") t = Number(value);
+    else if (key === "v1") v1.push(value);
+  }
+  return { t, v1 };
+}
+function timingSafeEqualHex(a, b) {
+  if (a.length !== b.length) return false;
+  try {
+    return crypto.timingSafeEqual(Buffer.from(a, "hex"), Buffer.from(b, "hex"));
+  } catch {
+    return false;
+  }
+}
+function verifyWebhookSignature(opts) {
+  const headerRaw = Array.isArray(opts.header) ? opts.header[0] : opts.header;
+  if (!headerRaw || typeof headerRaw !== "string") {
+    throw new WebhookSignatureError("MISSING_HEADER", "Missing X-IQAuth-Signature header");
+  }
+  if (!opts.secret) {
+    throw new WebhookSignatureError("MISSING_SECRET", "secret is required");
+  }
+  const { t, v1 } = parseHeader(headerRaw);
+  if (!Number.isFinite(t) || v1.length === 0) {
+    throw new WebhookSignatureError("MALFORMED_HEADER", `Could not parse signature header: ${headerRaw}`);
+  }
+  const tolerance = opts.toleranceSeconds ?? 300;
+  const now = opts.nowSeconds ?? Math.floor(Date.now() / 1e3);
+  if (Math.abs(now - t) > tolerance) {
+    throw new WebhookSignatureError(
+      "TIMESTAMP_OUT_OF_TOLERANCE",
+      `Signature timestamp ${t} is outside the ${tolerance}s tolerance window (now=${now})`
+    );
+  }
+  const body = toBuffer(opts.payload);
+  const expected = crypto.createHmac("sha256", opts.secret).update(`${t}.`).update(body).digest("hex");
+  const matched = v1.some((sig) => timingSafeEqualHex(sig, expected));
+  if (!matched) {
+    throw new WebhookSignatureError("SIGNATURE_MISMATCH", "Webhook signature does not match expected value");
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(body.toString("utf8"));
+  } catch {
+    throw new WebhookSignatureError("MALFORMED_BODY", "Webhook body is not valid JSON");
+  }
+  return parsed;
+}
+function isValidWebhookSignature(opts) {
+  try {
+    verifyWebhookSignature(opts);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export {
+  WebhookSignatureError,
+  verifyWebhookSignature,
+  isValidWebhookSignature
+};

package/dist/chunk-UNYDG2L4.mjs

@@ -0,0 +1,209 @@
+import {
+  IQAuthError
+} from "./chunk-6I6RM4MN.mjs";
+import {
+  __require
+} from "./chunk-Y6FXYEAI.mjs";
+
+// src/modules/tokens.ts
+import {
+  createLocalJWKSet,
+  jwtVerify,
+  errors as joseErrors
+} from "jose";
+var JWKS_CACHE_TTL_MS = 60 * 60 * 1e3;
+var DEFAULT_TOKEN_ISSUER = [
+  "https://auth.dispositioniq.com",
+  "auth.dispositioniq.com"
+];
+var DEFAULT_TOKEN_AUDIENCE = [
+  "dispositioniq",
+  "iqcapture",
+  "iqreuse",
+  "iqvalidate"
+];
+var DEFAULT_CLOCK_TOLERANCE_SECONDS = 30;
+function decodeProtectedHeader(token) {
+  const parts = token.split(".");
+  if (parts.length < 2) return null;
+  try {
+    const padded = parts[0] + "=".repeat((4 - parts[0].length % 4) % 4);
+    const b64 = padded.replace(/-/g, "+").replace(/_/g, "/");
+    let json;
+    if (typeof atob === "function") {
+      json = atob(b64);
+    } else {
+      const { Buffer } = __require("buffer");
+      json = Buffer.from(b64, "base64").toString("utf8");
+    }
+    return JSON.parse(json);
+  } catch {
+    return null;
+  }
+}
+var TokensModule = class {
+  constructor(baseUrl, options = {}) {
+    this.jwksCache = null;
+    this.inFlightRefresh = null;
+    this.baseUrl = baseUrl;
+    this.defaultIssuer = options.issuer ?? DEFAULT_TOKEN_ISSUER;
+    this.defaultAudience = options.audience ?? DEFAULT_TOKEN_AUDIENCE;
+    this.defaultClockTolerance = options.clockTolerance ?? DEFAULT_CLOCK_TOLERANCE_SECONDS;
+  }
+  /**
+   * Verify a JWT access token using RS256/ES256 via JWKS from
+   * `/.well-known/jwks.json`. Backed by `jose` (Web Crypto) so it runs on
+   * Node, browser, and edge runtimes alike — no `node:crypto` dependency.
+   * Caches JWKS for 1 hour and refetches once on unknown `kid`.
+   */
+  async verify(token, options = {}) {
+    const header = decodeProtectedHeader(token);
+    if (!header) {
+      throw new IQAuthError("TOKEN_INVALID", "Unable to decode token");
+    }
+    const kid = header.kid;
+    if (!kid) {
+      throw new IQAuthError("TOKEN_INVALID", "Token missing kid header");
+    }
+    let cache = await this.ensureCache();
+    if (!cache.byKid.has(kid)) {
+      this.jwksCache = null;
+      cache = await this.ensureCache();
+    }
+    if (!cache.byKid.has(kid)) {
+      throw new IQAuthError("TOKEN_INVALID", `Unknown key ID: ${kid}`);
+    }
+    const issuer = options.issuer ?? this.defaultIssuer;
+    const audience = options.audience ?? this.defaultAudience;
+    const clockTolerance = options.clockTolerance ?? this.defaultClockTolerance;
+    const algorithms = options.algorithms ?? ["RS256", "ES256"];
+    const verifyOptions = {
+      algorithms,
+      clockTolerance,
+      issuer,
+      audience
+    };
+    try {
+      const { payload } = await jwtVerify(token, cache.verifier, verifyOptions);
+      return payload;
+    } catch (err) {
+      if (err instanceof joseErrors.JWTExpired) {
+        throw new IQAuthError("TOKEN_EXPIRED", "Token has expired");
+      }
+      if (err instanceof joseErrors.JOSEError) {
+        throw new IQAuthError("TOKEN_INVALID", err.message);
+      }
+      if (err instanceof Error) {
+        throw new IQAuthError("TOKEN_INVALID", err.message);
+      }
+      throw new IQAuthError("TOKEN_INVALID", "Token verification failed");
+    }
+  }
+  /**
+   * Decode a JWT without verification. Returns null if malformed.
+   */
+  decode(token) {
+    try {
+      const parts = token.split(".");
+      if (parts.length < 2) return null;
+      const payload = parts[1];
+      const padded = payload + "=".repeat((4 - payload.length % 4) % 4);
+      const b64 = padded.replace(/-/g, "+").replace(/_/g, "/");
+      let json;
+      if (typeof atob === "function") {
+        json = atob(b64);
+      } else {
+        const { Buffer } = __require("buffer");
+        json = Buffer.from(b64, "base64").toString("utf8");
+      }
+      try {
+        json = decodeURIComponent(escape(json));
+      } catch {
+      }
+      const claims = JSON.parse(json);
+      if (!claims || typeof claims !== "object") return null;
+      return claims;
+    } catch {
+      return null;
+    }
+  }
+  /** Check if a token is expired based on the `exp` claim. */
+  isExpired(token) {
+    const claims = this.decode(token);
+    if (!claims?.exp) return true;
+    const now = Math.floor(Date.now() / 1e3);
+    return claims.exp <= now;
+  }
+  /** Get the claims from a token without verification. */
+  getClaims(token) {
+    const claims = this.decode(token);
+    if (!claims) {
+      throw new IQAuthError("TOKEN_INVALID", "Unable to decode token claims");
+    }
+    return claims;
+  }
+  async ensureCache() {
+    if (this.jwksCache && Date.now() - this.jwksCache.fetchedAt <= JWKS_CACHE_TTL_MS) {
+      return this.jwksCache;
+    }
+    await this.refreshJwks();
+    if (!this.jwksCache) {
+      throw new IQAuthError("INTERNAL_ERROR", "JWKS cache unavailable after refresh");
+    }
+    return this.jwksCache;
+  }
+  async refreshJwks() {
+    if (this.inFlightRefresh) {
+      return this.inFlightRefresh;
+    }
+    this.inFlightRefresh = (async () => {
+      try {
+        const res = await fetch(`${this.baseUrl}/.well-known/jwks.json`);
+        if (!res.ok) {
+          throw new IQAuthError(
+            "INTERNAL_ERROR",
+            `Failed to fetch JWKS: ${res.status}`
+          );
+        }
+        let jwks;
+        try {
+          jwks = await res.json();
+        } catch {
+          throw new IQAuthError("INTERNAL_ERROR", "Malformed JWKS response: invalid JSON");
+        }
+        if (!jwks || !Array.isArray(jwks.keys)) {
+          throw new IQAuthError(
+            "INTERNAL_ERROR",
+            "Malformed JWKS response: expected { keys: [...] }"
+          );
+        }
+        const byKid = /* @__PURE__ */ new Set();
+        for (const key of jwks.keys) {
+          if (!key || typeof key.kid !== "string" || typeof key.n !== "string" && typeof key.x !== "string" || key.kty === "RSA" && (typeof key.n !== "string" || typeof key.e !== "string")) {
+            throw new IQAuthError(
+              "INTERNAL_ERROR",
+              "Malformed JWKS response: key missing required fields"
+            );
+          }
+          byKid.add(key.kid);
+        }
+        const verifier = createLocalJWKSet({ keys: jwks.keys });
+        this.jwksCache = { raw: jwks.keys, byKid, verifier, fetchedAt: Date.now() };
+      } finally {
+        this.inFlightRefresh = null;
+      }
+    })();
+    return this.inFlightRefresh;
+  }
+  /** @internal Exposed for testing — clears JWKS cache */
+  clearCache() {
+    this.jwksCache = null;
+  }
+};
+
+export {
+  DEFAULT_TOKEN_ISSUER,
+  DEFAULT_TOKEN_AUDIENCE,
+  DEFAULT_CLOCK_TOLERANCE_SECONDS,
+  TokensModule
+};

package/dist/{chunk-MDUHPQMM.mjs → chunk-W3F4JYGP.mjs}

@@ -1,3 +1,6 @@
+import {
+  TokensModule
+} from "./chunk-UNYDG2L4.mjs";
 import {
   IQAuthError
 } from "./chunk-6I6RM4MN.mjs";
@@ -160,177 +163,6 @@ function parseMfaResponse(data, browserSessionMode) {
   throw new Error("Unexpected MFA response shape");
 }
 
-// src/modules/tokens.ts
-import crypto from "crypto";
-import jwt from "jsonwebtoken";
-var JWKS_CACHE_TTL_MS = 60 * 60 * 1e3;
-var DEFAULT_TOKEN_ISSUER = [
-  "https://auth.dispositioniq.com",
-  "auth.dispositioniq.com"
-];
-var DEFAULT_TOKEN_AUDIENCE = [
-  "dispositioniq",
-  "iqcapture",
-  "iqreuse",
-  "iqvalidate"
-];
-var DEFAULT_CLOCK_TOLERANCE_SECONDS = 30;
-var TokensModule = class {
-  constructor(baseUrl, options = {}) {
-    this.jwksCache = null;
-    this.inFlightRefresh = null;
-    this.baseUrl = baseUrl;
-    this.defaultIssuer = options.issuer ?? DEFAULT_TOKEN_ISSUER;
-    this.defaultAudience = options.audience ?? DEFAULT_TOKEN_AUDIENCE;
-    this.defaultClockTolerance = options.clockTolerance ?? DEFAULT_CLOCK_TOLERANCE_SECONDS;
-  }
-  /**
-   * Verify a JWT access token using RS256 via JWKS from /.well-known/jwks.json.
-   * Caches JWKS keys for 1 hour. Retries once on unknown `kid`.
-   *
-   * @remarks Validates against /.well-known/jwks.json. Issuer, audience, and
-   * clock tolerance default to client config but can be overridden per call.
-   */
-  async verify(token, options = {}) {
-    const decoded = jwt.decode(token, { complete: true });
-    if (!decoded || typeof decoded === "string") {
-      throw new IQAuthError("TOKEN_INVALID", "Unable to decode token");
-    }
-    const kid = decoded.header.kid;
-    if (!kid) {
-      throw new IQAuthError("TOKEN_INVALID", "Token missing kid header");
-    }
-    let publicKey = await this.getPublicKey(kid);
-    if (!publicKey) {
-      await this.refreshJwks();
-      publicKey = await this.getPublicKey(kid);
-    }
-    if (!publicKey) {
-      throw new IQAuthError("TOKEN_INVALID", `Unknown key ID: ${kid}`);
-    }
-    const issuer = options.issuer ?? this.defaultIssuer;
-    const audience = options.audience ?? this.defaultAudience;
-    const clockTolerance = options.clockTolerance ?? this.defaultClockTolerance;
-    const algorithms = options.algorithms ?? ["RS256"];
-    try {
-      const verifyOptions = {
-        algorithms,
-        clockTolerance,
-        // The jsonwebtoken types insist on tuple types for arrays; runtime
-        // accepts plain string[] so we cast to satisfy the compiler.
-        issuer,
-        audience
-      };
-      const verified = jwt.verify(token, publicKey, verifyOptions);
-      return verified;
-    } catch (err) {
-      if (err instanceof Error) {
-        if (err.name === "TokenExpiredError") {
-          throw new IQAuthError("TOKEN_EXPIRED", "Token has expired");
-        }
-        throw new IQAuthError("TOKEN_INVALID", err.message);
-      }
-      throw new IQAuthError("TOKEN_INVALID", "Token verification failed");
-    }
-  }
-  /**
-   * Decode a JWT without verification. Returns null if malformed.
-   *
-   * @remarks Local decode only — no network call
-   */
-  decode(token) {
-    const decoded = jwt.decode(token);
-    return decoded;
-  }
-  /**
-   * Check if a token is expired based on the `exp` claim.
-   *
-   * @remarks Local check only — no network call
-   */
-  isExpired(token) {
-    const claims = this.decode(token);
-    if (!claims?.exp) return true;
-    const now = Math.floor(Date.now() / 1e3);
-    return claims.exp <= now;
-  }
-  /**
-   * Get the claims from a token without verification.
-   *
-   * @remarks Local decode only — no network call
-   */
-  getClaims(token) {
-    const claims = this.decode(token);
-    if (!claims) {
-      throw new IQAuthError("TOKEN_INVALID", "Unable to decode token claims");
-    }
-    return claims;
-  }
-  async getPublicKey(kid) {
-    if (!this.jwksCache || Date.now() - this.jwksCache.fetchedAt > JWKS_CACHE_TTL_MS) {
-      await this.refreshJwks();
-    }
-    return this.jwksCache?.keys.get(kid) ?? null;
-  }
-  async refreshJwks() {
-    if (this.inFlightRefresh) {
-      return this.inFlightRefresh;
-    }
-    this.inFlightRefresh = (async () => {
-      try {
-        const res = await fetch(`${this.baseUrl}/.well-known/jwks.json`);
-        if (!res.ok) {
-          throw new IQAuthError(
-            "INTERNAL_ERROR",
-            `Failed to fetch JWKS: ${res.status}`
-          );
-        }
-        let jwks;
-        try {
-          jwks = await res.json();
-        } catch {
-          throw new IQAuthError("INTERNAL_ERROR", "Malformed JWKS response: invalid JSON");
-        }
-        if (!jwks || !Array.isArray(jwks.keys)) {
-          throw new IQAuthError(
-            "INTERNAL_ERROR",
-            "Malformed JWKS response: expected { keys: [...] }"
-          );
-        }
-        const keys = /* @__PURE__ */ new Map();
-        for (const key of jwks.keys) {
-          if (!key || typeof key.kid !== "string" || typeof key.n !== "string" || typeof key.e !== "string") {
-            throw new IQAuthError(
-              "INTERNAL_ERROR",
-              "Malformed JWKS response: key missing required fields"
-            );
-          }
-          const pem = this.jwkToPem(key);
-          keys.set(key.kid, pem);
-        }
-        this.jwksCache = { keys, fetchedAt: Date.now() };
-      } finally {
-        this.inFlightRefresh = null;
-      }
-    })();
-    return this.inFlightRefresh;
-  }
-  jwkToPem(jwk) {
-    const keyObject = crypto.createPublicKey({
-      key: {
-        kty: jwk.kty,
-        n: jwk.n,
-        e: jwk.e
-      },
-      format: "jwk"
-    });
-    return keyObject.export({ type: "spki", format: "pem" });
-  }
-  /** @internal Exposed for testing — clears JWKS cache */
-  clearCache() {
-    this.jwksCache = null;
-  }
-};
-
 // src/modules/sessions.ts
 var SessionsModule = class {
   constructor(http) {
@@ -532,7 +364,7 @@ var PermissionsModule = class {
 };
 
 // src/modules/oidc.ts
-import crypto2 from "crypto";
+import crypto from "crypto";
 var InMemoryOidcStateStore = class {
   constructor() {
     this.map = /* @__PURE__ */ new Map();
@@ -613,12 +445,12 @@ var OidcModule = class {
    * ready to redirect the user to.
    */
   async createAuthRequest(params) {
-    const codeVerifier = base64UrlEncode(crypto2.randomBytes(32));
+    const codeVerifier = base64UrlEncode(crypto.randomBytes(32));
     const codeChallenge = base64UrlEncode(
-      crypto2.createHash("sha256").update(codeVerifier).digest()
+      crypto.createHash("sha256").update(codeVerifier).digest()
     );
-    const state = base64UrlEncode(crypto2.randomBytes(16));
-    const nonce = base64UrlEncode(crypto2.randomBytes(16));
+    const state = base64UrlEncode(crypto.randomBytes(16));
+    const nonce = base64UrlEncode(crypto.randomBytes(16));
     await this.stateStore.set(state, {
       codeVerifier,
       state,
@@ -1712,10 +1544,6 @@ var IQAuthClient = class _IQAuthClient {
 
 export {
   AuthModule,
-  DEFAULT_TOKEN_ISSUER,
-  DEFAULT_TOKEN_AUDIENCE,
-  DEFAULT_CLOCK_TOLERANCE_SECONDS,
-  TokensModule,
   SessionsModule,
   UsersModule,
   PermissionsModule,

package/dist/{chunk-QEJB7WEQ.mjs → chunk-WQWBJSSS.mjs}

@@ -93,7 +93,7 @@ function assertPublishableKey(raw, opts) {
   if (!isValidIssuerUrl(decoded.iss)) {
     throw new IQAuthError(
       "CONFIG_INVALID",
-      `${ctx}IQAuth publishable key encodes an invalid issuer (iss=${JSON.stringify(decoded.iss)}). Expected a fully-qualified URL like "https://auth.example.com" (scheme required). Regenerate the key from the IQAuth admin console, or set IQAUTH_ISSUER to the correct issuer URL as a temporary workaround.`
+      `${ctx}IQAuth publishable key encodes an invalid issuer (iss=${JSON.stringify(decoded.iss)}). Expected a fully-qualified URL like "https://auth.example.com" (scheme required). Regenerate the key from the IQAuth admin console \u2014 the new key will encode a valid issuer URL.`
     );
   }
   return { mode: shapeMatch[1], iss: decoded.iss, appId: decoded.appId, tenantId: decoded.tenantId, kid: decoded.kid, raw };