@canopy-io/node 0.5.0 → 0.7.0

package/dist/index.js

@@ -82,6 +82,15 @@ function isCanopyTokenError(error) {
   return error instanceof Error && error.name === "CanopyTokenError";
 }
 
+// src/strings.ts
+function withoutTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value[end - 1] === "/") {
+    end -= 1;
+  }
+  return value.slice(0, end);
+}
+
 // src/client.ts
 function isCursorPagination(pagination) {
   return "next_cursor" in pagination;
@@ -106,7 +115,7 @@ var CanopyClient = class {
         "CanopyClient requires either `apiKey` (server-to-server) or `accessToken` (a user or identity JWT)."
       );
     }
-    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.baseUrl = withoutTrailingSlashes(options.baseUrl ?? DEFAULT_BASE_URL);
     this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
     this.maxBackoffMs = options.maxBackoffMs ?? DEFAULT_MAX_BACKOFF_MS;
@@ -550,29 +559,19 @@ var Identities = class {
       { body: input }
     );
   }
+  /**
+   * Takes the identity out of this key's Environment: its membership here is
+   * deactivated and its role assignments here are dropped. The identity and
+   * its access to other Environments are untouched. Deactivating an identity
+   * everywhere is an Account-level action, not available to an
+   * Environment-scoped key.
+   */
   delete(id) {
     return this.client.request(
       "DELETE",
       `/api/v1/identities/${encodeURIComponent(id)}`
     );
   }
-  /**
-   * Deactivation is the reversible counterpart to `delete` — sessions are
-   * revoked and sign-in refused, but the identity and its assignments survive.
-   * Prefer it for offboarding you may need to undo.
-   */
-  deactivate(id) {
-    return this.client.request(
-      "POST",
-      `/api/v1/identities/${encodeURIComponent(id)}/deactivate`
-    );
-  }
-  activate(id) {
-    return this.client.request(
-      "POST",
-      `/api/v1/identities/${encodeURIComponent(id)}/activate`
-    );
-  }
   /**
    * Every role this identity holds, and where — across all pages.
    *
@@ -634,7 +633,7 @@ var Identities = class {
    * Ends every session the identity holds, so the next refresh on any device
    * fails and the person signs in again. Access tokens already issued keep
    * working until their short lifetime runs out. For a suspected compromise;
-   * `deactivate` also refuses the next sign-in.
+   * `delete` also takes the identity out of this Environment.
    */
   revokeSessions(id) {
     return this.client.request(
@@ -1117,6 +1116,7 @@ var Canopy = class {
 
 // src/authorizer.ts
 var DEFAULT_TTL_MS = 6e4;
+var MAX_TTL_MS = 3e5;
 var MAX_WALK_DEPTH = 256;
 var LocalAuthorizer = class {
   client;
@@ -1143,6 +1143,11 @@ var LocalAuthorizer = class {
   constructor(client, options = {}) {
     this.client = client;
     this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    if (!Number.isFinite(this.ttlMs) || this.ttlMs < 0 || this.ttlMs > MAX_TTL_MS) {
+      throw new RangeError(
+        `ttlMs must be between 0 and ${MAX_TTL_MS} (five minutes); got ${String(this.ttlMs)}. It is how long a revoked user keeps access, so it is capped.`
+      );
+    }
     this.now = options.now ?? (() => Date.now());
     this.readOptions = {
       ...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs },
@@ -1210,7 +1215,9 @@ var LocalAuthorizer = class {
    * With no argument, everything goes: grants and the hierarchy tree. Not
    * needed in normal operation, where entries expire on their own; useful in
    * tests and after a change whose reach you cannot name (a role's
-   * permissions edited, a node moved).
+   * permissions edited, a role deactivated or reactivated, a node moved). A
+   * deactivated role grants nothing to anyone holding it, so until the cache
+   * is cleared or expires, its holders keep being allowed locally.
    *
    * Multi-instance honesty: an invalidation reaches THIS process only. A
    * webhook lands on one instance behind a load balancer; the others serve
@@ -1330,12 +1337,29 @@ var LocalAuthorizer = class {
 };
 
 // src/verify.ts
-var DEFAULT_ISSUER = "https://auth.canopy-io.com";
+var HOSTED_ORIGIN = "https://auth.canopy-io.com";
 var DEFAULT_JWKS_CACHE_MAX_AGE_MS = 10 * 60 * 1e3;
 var DEFAULT_JWKS_MIN_REFETCH_INTERVAL_MS = 30 * 1e3;
 var DEFAULT_JWKS_TIMEOUT_MS = 5e3;
 var PRINCIPAL_TYPES = /* @__PURE__ */ new Set(["user", "identity", "api_key", "platform"]);
 var DEFAULT_CLOCK_TOLERANCE_SEC = 60;
+function resolveIssuer(options) {
+  const { environmentId, issuer } = options;
+  if (environmentId && issuer) {
+    throw new TypeError(
+      "TokenVerifier takes environmentId or issuer, not both."
+    );
+  }
+  if (issuer) {
+    return withoutTrailingSlashes(issuer);
+  }
+  if (environmentId) {
+    return `${HOSTED_ORIGIN}/environments/${environmentId}`;
+  }
+  throw new TypeError(
+    "TokenVerifier needs environmentId (the Environment your tokens come from) or, on a custom auth domain or self-hosted instance, issuer."
+  );
+}
 function orgContext(claims) {
   const { org_id, org_role } = claims;
   if (typeof org_id !== "string" || org_id === "" || typeof org_role !== "string" || org_role === "") {
@@ -1380,7 +1404,7 @@ var TokenVerifier = class {
   /** In-flight fetch, so a burst of requests triggers one call, not N. */
   inFlight = null;
   constructor(options = {}) {
-    this.issuer = (options.issuer ?? DEFAULT_ISSUER).replace(/\/+$/, "");
+    this.issuer = resolveIssuer(options);
     this.audience = options.audience;
     this.jwksUri = options.jwksUri ?? `${this.issuer}/.well-known/jwks.json`;
     this.jwksCacheMaxAgeMs = options.jwksCacheMaxAgeMs ?? DEFAULT_JWKS_CACHE_MAX_AGE_MS;
@@ -1658,6 +1682,6 @@ function isWebhookEvent(delivery, name) {
   return delivery.event === name;
 }
 
-export { Assignments, Canopy, CanopyAuthorizerError, CanopyClient, CanopyConnectionError, CanopyError, CanopyTokenError, Identities, LocalAuthorizer, Organizations, Paginator, Permissions, Roles, TokenVerifier, isCanopyAuthorizerError, isCanopyConnectionError, isCanopyError, isCanopyTokenError, isCursorPagination, isWebhookEvent, orgContext, paginate, withConcurrency };
+export { Assignments, Canopy, CanopyAuthorizerError, CanopyClient, CanopyConnectionError, CanopyError, CanopyTokenError, Identities, LocalAuthorizer, MAX_TTL_MS, Organizations, Paginator, Permissions, Roles, TokenVerifier, isCanopyAuthorizerError, isCanopyConnectionError, isCanopyError, isCanopyTokenError, isCursorPagination, isWebhookEvent, orgContext, paginate, withConcurrency };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map