@authyon/server 0.2.0-beta.1 → 0.2.0-beta.3

package/dist/index.js

@@ -1,32 +1,287 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+
+// src/client/credentialManagement.ts
+function segment(value) {
+  if (typeof value !== "string" || !value.trim() || value === "." || value === ".." || [...value].some((character) => character.charCodeAt(0) < 32 || character.charCodeAt(0) === 127)) {
+    throw new TypeError("Authyon: invalid route identifier.");
+  }
+  return encodeURIComponent(value);
+}
+function permissionsBody(input) {
+  if (input.permissions !== void 0 && input.scopes !== void 0) {
+    throw new TypeError("Authyon: supply permissions or scopes, not both.");
+  }
+  const values = input.permissions ?? input.scopes;
+  if (!Array.isArray(values) || values.length === 0) {
+    throw new TypeError("Authyon: explicit credential permissions are required.");
+  }
+  const permissions = values.map((value) => {
+    if (typeof value !== "string") throw new TypeError("Authyon: invalid permission.");
+    const normalized = value.trim().toLowerCase();
+    if (!/^(?:\*|[a-z][a-z0-9_-]*):(?:\*|[a-z][a-z0-9_-]*):(?:\*|[a-z][a-z0-9_-]*)$/u.test(normalized)) {
+      throw new TypeError("Authyon: permissions must have namespace:resource:action format.");
+    }
+    return normalized;
+  });
+  return { permissions: [...new Set(permissions)] };
+}
+function lifetimeBody(input) {
+  if (input.lifetimeDays === void 0 || input.lifetimeDays === null) return {};
+  if (!Number.isInteger(input.lifetimeDays) || input.lifetimeDays < 1 || input.lifetimeDays > 3650) {
+    throw new RangeError("Authyon: lifetimeDays must be between 1 and 3650.");
+  }
+  return { lifetimeDays: input.lifetimeDays };
+}
+function credentialQuery(options = {}) {
+  const { skip, take, search } = options;
+  if (skip !== void 0 && (!Number.isInteger(skip) || skip < 0 || skip > 2147483647))
+    throw new RangeError("Authyon: invalid skip.");
+  if (take !== void 0 && (!Number.isInteger(take) || take < 1 || take > 100))
+    throw new RangeError("Authyon: take must be between 1 and 100.");
+  if (search !== void 0 && (typeof search !== "string" || search.trim().length > 200))
+    throw new RangeError("Authyon: search must contain at most 200 characters.");
+  return { search: search?.trim() || void 0, skip, take };
+}
+function credentialSummary(value) {
+  return {
+    id: value.id,
+    clientId: value.clientId,
+    description: value.description,
+    createdAt: value.createdAt,
+    lastUsedAt: value.lastUsedAt,
+    revokedAt: value.revokedAt,
+    expiresAt: value.expiresAt ?? null,
+    isActive: value.isActive,
+    permissions: [...value.permissions]
+  };
+}
+function credentialDetail(value) {
+  return {
+    ...credentialSummary(value),
+    createdBy: value.createdBy == null ? null : {
+      id: value.createdBy.id,
+      type: value.createdBy.type,
+      displayName: value.createdBy.displayName
+    },
+    updatedAt: value.updatedAt,
+    secretRotatedAt: value.secretRotatedAt,
+    expiresAt: value.expiresAt ?? null,
+    ageSeconds: value.ageSeconds,
+    lifetimeSeconds: value.lifetimeSeconds,
+    accessTokenLifetimeSeconds: value.accessTokenLifetimeSeconds
+  };
+}
+async function credentialPage(request, path, options = {}) {
+  const query = credentialQuery(options);
+  const page = await request(path, { query });
+  if (!page || !Array.isArray(page.data))
+    throw new TypeError("Authyon: expected a paginated credential response.");
+  return {
+    data: page.data.map(credentialSummary),
+    ...page.perPage === void 0 ? {} : { perPage: page.perPage },
+    pageSize: page.pageSize,
+    total: page.total,
+    pages: page.pages,
+    hasNext: page.hasNext,
+    hasPrev: page.hasPrev
+  };
+}
+async function allCredentials(request, path) {
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  let skip = 0;
+  for (let iteration = 0; iteration < 1e3; iteration++) {
+    const page = await request(
+      path,
+      iteration === 0 ? {} : { query: { skip, take: 100 } }
+    );
+    if (Array.isArray(page)) {
+      if (iteration !== 0)
+        throw new Error("Authyon: credential pagination changed during listing.");
+      return page.map(credentialSummary);
+    }
+    if (!page || !Array.isArray(page.data))
+      throw new TypeError("Authyon: invalid credential page.");
+    for (const row of page.data) {
+      if (seen.has(row.id))
+        throw new Error("Authyon: credential pages overlapped; retry the listing.");
+      seen.add(row.id);
+      result.push(credentialSummary(row));
+    }
+    if (!page.hasNext) return result;
+    if (page.data.length === 0) throw new Error("Authyon: credential pagination made no progress.");
+    skip += page.data.length;
+  }
+  throw new Error("Authyon: use listPage for more than 1000 credential pages.");
+}
+
+// src/client/scopedManagementClient.ts
+function scopedRequest(request, source) {
+  return async (path, options = {}) => {
+    const token = typeof source === "function" ? await source() : source;
+    if (typeof token !== "string" || !token.trim() || /\s/u.test(token))
+      throw new TypeError("Authyon: a valid access token is required.");
+    return request(path, {
+      ...options,
+      headers: { ...options.headers, Authorization: `Bearer ${token}` }
+    });
+  };
+}
+function environmentPath(scope) {
+  return `/platform/workspaces/${segment(scope.workspaceId)}/environments/${segment(scope.environmentId)}`;
+}
+function tenantPath(scope) {
+  return `${environmentPath(scope)}/tenants/${segment(scope.tenantId)}`;
+}
+function credentialPath(scope) {
+  return `${scope.tenantId === void 0 ? environmentPath(scope) : tenantPath(scope)}/credentials`;
+}
+function workspacePath(id) {
+  return `/platform/workspaces/${segment(id)}`;
+}
+function workspaceRole(role) {
+  if (role !== "admin" && role !== "auditor")
+    throw new TypeError("Authyon: workspace role must be admin or auditor.");
+  return role;
+}
+var _request;
+var PlatformScopedClient = class {
+  /** @hidden */
+  constructor(request, token) {
+    __privateAdd(this, _request);
+    this.credentials = {
+      list: (scope, options = {}) => credentialPage(__privateGet(this, _request), credentialPath(scope), options),
+      get: async (scope, credentialId) => credentialDetail(await __privateGet(this, _request).call(this, `${credentialPath(scope)}/${segment(credentialId)}`)),
+      create: (scope, input) => __privateGet(this, _request).call(this, credentialPath(scope), {
+        method: "POST",
+        body: { description: input.description, ...lifetimeBody(input), ...permissionsBody(input) }
+      }),
+      updatePermissions: (scope, credentialId, input) => __privateGet(this, _request).call(this, `${credentialPath(scope)}/${segment(credentialId)}/permissions`, {
+        method: "PUT",
+        body: permissionsBody(input)
+      }),
+      updateScopes: (scope, credentialId, scopes) => this.credentials.updatePermissions(scope, credentialId, { scopes }),
+      /** Returns a new secret once. API may require an explicit step-up first. */
+      rotate: (scope, credentialId) => __privateGet(this, _request).call(this, `${credentialPath(scope)}/${segment(credentialId)}/rotate`, { method: "POST" }),
+      revoke: (scope, credentialId) => __privateGet(this, _request).call(this, `${credentialPath(scope)}/${segment(credentialId)}`, { method: "DELETE" })
+    };
+    this.workspaces = {
+      team: (workspaceId) => __privateGet(this, _request).call(this, `${workspacePath(workspaceId)}/team`),
+      members: {
+        invite: (workspaceId, input) => __privateGet(this, _request).call(this, `${workspacePath(workspaceId)}/invites`, {
+          method: "POST",
+          body: { email: input.email, role: workspaceRole(input.role) }
+        }),
+        /** memberId comes from team.members; it is not the platform userId. */
+        remove: (workspaceId, memberId) => __privateGet(this, _request).call(this, `${workspacePath(workspaceId)}/members/${segment(memberId)}`, {
+          method: "DELETE"
+        }),
+        changeRole: (workspaceId, memberId, role) => __privateGet(this, _request).call(this, `${workspacePath(workspaceId)}/members/${segment(memberId)}`, {
+          method: "PATCH",
+          body: { role: workspaceRole(role) }
+        })
+      },
+      invites: {
+        create: (workspaceId, input) => this.workspaces.members.invite(workspaceId, input),
+        revoke: (workspaceId, inviteId) => __privateGet(this, _request).call(this, `${workspacePath(workspaceId)}/invites/${segment(inviteId)}`, {
+          method: "DELETE"
+        })
+      }
+    };
+    this.tenants = {
+      members: {
+        list: (scope, options = {}) => __privateGet(this, _request).call(this, `${tenantPath(scope)}/members`, { query: options }),
+        add: (scope, userId, roles) => __privateGet(this, _request).call(this, `${tenantPath(scope)}/members`, { method: "POST", body: { userId, roles } }),
+        remove: (scope, userId) => __privateGet(this, _request).call(this, `${tenantPath(scope)}/members/${segment(userId)}`, { method: "DELETE" })
+      }
+    };
+    this.auth = {
+      /** Explicitly confirms the current platform session; passwords are not retained. */
+      stepUp: (currentPassword) => __privateGet(this, _request).call(this, "/platform/auth/step-up", { method: "POST", body: { currentPassword } })
+    };
+    __privateSet(this, _request, scopedRequest(request, token));
+  }
+};
+_request = new WeakMap();
+var _request2;
+var UserScopedClient = class {
+  /** @hidden */
+  constructor(request, token) {
+    __privateAdd(this, _request2);
+    this.tenants = {
+      members: {
+        list: (tenantId, options = {}) => __privateGet(this, _request2).call(this, `/auth/tenants/${segment(tenantId)}/members`, { query: options }),
+        /** Adds an existing environment user by email; does not send an invitation email. */
+        invite: (tenantId, input) => __privateGet(this, _request2).call(this, `/auth/tenants/${segment(tenantId)}/members`, {
+          method: "POST",
+          body: { email: input.email, roles: input.roles }
+        }),
+        remove: (tenantId, userId) => __privateGet(this, _request2).call(this, `/auth/tenants/${segment(tenantId)}/members/${segment(userId)}`, {
+          method: "DELETE"
+        })
+      }
+    };
+    __privateSet(this, _request2, scopedRequest(request, token));
+  }
+};
+_request2 = new WeakMap();
+var _request3;
+var WorkspaceInvitesClient = class {
+  /** @hidden */
+  constructor(request) {
+    __privateAdd(this, _request3);
+    __privateSet(this, _request3, request);
+  }
+  preview(token) {
+    return __privateGet(this, _request3).call(this, `/platform/workspace-invites/${segment(token)}`);
+  }
+  accept(token, input = {}) {
+    return __privateGet(this, _request3).call(this, `/platform/workspace-invites/${segment(token)}/accept`, {
+      method: "POST",
+      body: { name: input.name, password: input.password }
+    });
+  }
+};
+_request3 = new WeakMap();
+
 // ../../internal/core/config/defaults.ts
 var DEFAULT_BASE_URL = "https://api.authyon.com";
 var DEFAULT_EXPIRY_SKEW_MS = 3e4;
 
 // ../../internal/core/auth/expiringTokenProvider.ts
+var _token, _inFlight;
 var ExpiringTokenProvider = class {
   constructor(acquire, expirySkewMs = DEFAULT_EXPIRY_SKEW_MS) {
     this.acquire = acquire;
     this.expirySkewMs = expirySkewMs;
-    this.token = null;
-    this.inFlight = null;
+    __privateAdd(this, _token, null);
+    __privateAdd(this, _inFlight, null);
   }
   async getAccessToken() {
-    if (this.token && Date.now() < this.token.expiresAt - this.expirySkewMs) {
-      return this.token.accessToken;
+    if (__privateGet(this, _token) && Date.now() < __privateGet(this, _token).expiresAt - this.expirySkewMs) {
+      return __privateGet(this, _token).accessToken;
     }
-    if (this.inFlight) return this.inFlight;
-    this.inFlight = this.acquire().then((token) => {
-      this.token = token;
+    if (__privateGet(this, _inFlight)) return __privateGet(this, _inFlight);
+    __privateSet(this, _inFlight, this.acquire().then((token) => {
+      __privateSet(this, _token, token);
       return token.accessToken;
     }).finally(() => {
-      this.inFlight = null;
-    });
-    return this.inFlight;
+      __privateSet(this, _inFlight, null);
+    }));
+    return __privateGet(this, _inFlight);
   }
   clear() {
-    this.token = null;
+    __privateSet(this, _token, null);
   }
 };
+_token = new WeakMap();
+_inFlight = new WeakMap();
 
 // ../../internal/core/errors/authyonError.ts
 var ErrorCodes = {
@@ -157,7 +412,8 @@ var FetchHttpAdapter = class {
       method: request.method,
       headers: request.headers,
       body: request.body,
-      signal: request.signal
+      signal: request.signal,
+      redirect: "error"
     });
   }
 };
@@ -209,6 +465,10 @@ function defaultHttpLogger(event) {
 }
 function sanitizeUrl(value) {
   const url = new URL(value);
+  url.username = "";
+  url.password = "";
+  url.hash = "";
+  url.pathname = url.pathname.replace(/(\/platform\/workspace-invites\/)[^/]+/u, "$1REDACTED");
   const queryKeys = /* @__PURE__ */ new Set();
   url.searchParams.forEach((_value, key) => queryKeys.add(key));
   url.search = queryKeys.size > 0 ? [...queryKeys].map((key) => `${encodeURIComponent(key)}=REDACTED`).join("&") : "";
@@ -494,8 +754,10 @@ function isRecord(value) {
 }
 
 // src/client/authyonServerClient.ts
+var _clientSecret;
 var AuthyonServerClient = class {
   constructor(options = {}) {
+    __privateAdd(this, _clientSecret);
     // ── Discovery ──────────────────────────────────────────────────────────────
     this.discovery = {
       /** GET /.well-known/jwks.json — the environment's public signing keys. */
@@ -531,6 +793,9 @@ var AuthyonServerClient = class {
         }
       })
     };
+    this.workspaceInvites = new WorkspaceInvitesClient(
+      (path, options) => this.http.request(path, options)
+    );
     // ── Environment management (users, tenants, roles, permissions, audit) ───
     this.environment = {
       users: {
@@ -622,8 +887,49 @@ var AuthyonServerClient = class {
         )
       },
       tenants: {
-        /** GET /env/tenants — list tenants in the environment. */
-        list: () => this.request("/env/tenants", { envBearer: true }),
+        credentials: {
+          /** GET /env/tenants/{tenantId}/credentials. Returns metadata only, including revoked credentials. */
+          list: (tenantId) => allCredentials(
+            (path, options) => this.request(path, { ...options, envBearer: true }),
+            `/env/tenants/${segment(tenantId)}/credentials`
+          ),
+          /** Paginated searchable listing. Prefer this over loading every credential. */
+          listPage: (tenantId, options = {}) => credentialPage(
+            (path, requestOptions) => this.request(path, { ...requestOptions, envBearer: true }),
+            `/env/tenants/${segment(tenantId)}/credentials`,
+            options
+          ),
+          get: async (tenantId, credentialId) => credentialDetail(
+            await this.request(
+              `/env/tenants/${segment(tenantId)}/credentials/${segment(credentialId)}`,
+              { envBearer: true }
+            )
+          ),
+          /** Explicit scopes/permissions; only issuance returns the client secret. */
+          create: (tenantId, input) => this.request(`/env/tenants/${segment(tenantId)}/credentials`, {
+            method: "POST",
+            envBearer: true,
+            body: { description: input.description, ...lifetimeBody(input), ...permissionsBody(input) }
+          }),
+          /** Returns a new secret once while keeping the same client id. */
+          rotate: (tenantId, credentialId) => this.request(
+            `/env/tenants/${segment(tenantId)}/credentials/${segment(credentialId)}/rotate`,
+            { method: "POST", envBearer: true }
+          ),
+          updatePermissions: (tenantId, credentialId, input) => this.request(
+            `/env/tenants/${segment(tenantId)}/credentials/${segment(credentialId)}/permissions`,
+            { method: "PUT", envBearer: true, body: permissionsBody(input) }
+          ),
+          updateScopes: (tenantId, credentialId, scopes) => this.environment.tenants.credentials.updatePermissions(tenantId, credentialId, {
+            scopes
+          }),
+          revoke: (tenantId, credentialId) => this.request(`/env/tenants/${segment(tenantId)}/credentials/${segment(credentialId)}`, {
+            method: "DELETE",
+            envBearer: true
+          })
+        },
+        /** GET /env/tenants — paginated, searchable list of tenants in the environment. */
+        list: (params = {}) => this.request("/env/tenants", { envBearer: true, query: params }),
         /** POST /env/tenants — create a tenant in the environment. */
         create: (input) => this.request("/env/tenants", { method: "POST", envBearer: true, body: input }),
         /** GET /env/tenants/{tenantId} — fetch a tenant by id. */
@@ -768,7 +1074,7 @@ var AuthyonServerClient = class {
     };
     this.envKey = options.envKey;
     this.clientId = options.clientId;
-    this.clientSecret = options.clientSecret;
+    __privateSet(this, _clientSecret, options.clientSecret);
     this.transport = createSharedTransport({
       baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
       allowInsecureHttp: options.allowInsecureHttp,
@@ -779,14 +1085,14 @@ var AuthyonServerClient = class {
     });
     this.http = new JsonHttpClient(this.transport);
     this.environmentTokenProvider = new ExpiringTokenProvider(async () => {
-      if (!this.clientId || !this.clientSecret) {
+      if (!this.clientId || !__privateGet(this, _clientSecret)) {
         throw new Error(
           "Authyon: `clientId`/`clientSecret` are required for environment management calls (mint a pair in the console, under the environment's OAuth clients)."
         );
       }
       const token = await this.environmentAuth.token({
         clientId: this.clientId,
-        clientSecret: this.clientSecret
+        clientSecret: __privateGet(this, _clientSecret)
       });
       return {
         accessToken: token.access_token,
@@ -855,6 +1161,14 @@ var AuthyonServerClient = class {
   tenant(credentials) {
     return new TenantScopedClient(this, credentials);
   }
+  /** Uses only the supplied platform-user access token. */
+  platform(token) {
+    return new PlatformScopedClient((path, options) => this.http.request(path, options), token);
+  }
+  /** Uses an end-user token; the configured environment key selects the environment. */
+  user(token) {
+    return new UserScopedClient((path, options) => this.request(path, options), token);
+  }
   /** @internal used by {@link TenantScopedClient} to share the base URL/fetch/error handling. */
   _requestAsTenant(accessToken, path, options = {}) {
     return this.request(path, {
@@ -864,6 +1178,7 @@ var AuthyonServerClient = class {
     });
   }
 };
+_clientSecret = new WeakMap();
 var TenantScopedClient = class {
   constructor(server, credentials) {
     this.members = {
@@ -942,40 +1257,42 @@ function createClient(options = {}) {
 }
 
 // src/client/authyonServerClientBuilder.ts
+var _options;
 var AuthyonServerClientBuilder = class {
   constructor() {
-    this.options = {};
+    __privateAdd(this, _options, {});
   }
   withEnvironmentKey(envKey) {
-    this.options.envKey = envKey;
+    __privateGet(this, _options).envKey = envKey;
     return this;
   }
   withEnvironmentCredentials(clientId, clientSecret) {
-    this.options.clientId = clientId;
-    this.options.clientSecret = clientSecret;
+    __privateGet(this, _options).clientId = clientId;
+    __privateGet(this, _options).clientSecret = clientSecret;
     return this;
   }
   withBaseUrl(baseUrl, allowInsecureHttp = false) {
-    this.options.baseUrl = baseUrl;
-    this.options.allowInsecureHttp = allowInsecureHttp;
+    __privateGet(this, _options).baseUrl = baseUrl;
+    __privateGet(this, _options).allowInsecureHttp = allowInsecureHttp;
     return this;
   }
   withTimeout(timeoutMs) {
-    this.options.timeoutMs = timeoutMs;
+    __privateGet(this, _options).timeoutMs = timeoutMs;
     return this;
   }
   withHttpAdapter(httpAdapter) {
-    this.options.httpAdapter = httpAdapter;
+    __privateGet(this, _options).httpAdapter = httpAdapter;
     return this;
   }
   withHttpLogger(httpLogger) {
-    this.options.httpLogger = httpLogger;
+    __privateGet(this, _options).httpLogger = httpLogger;
     return this;
   }
   build() {
-    return new AuthyonServerClient({ ...this.options });
+    return new AuthyonServerClient({ ...__privateGet(this, _options) });
   }
 };
+_options = new WeakMap();
 
 // ../../internal/core/authorization/ability.ts
 var AuthyonAbility = class {
@@ -1039,6 +1356,17 @@ var AuthyonAbilityBuilder = class {
 function createAuthyonAbility(source = {}, options = {}) {
   return new AuthyonAbility(createAuthyonRules(source, options), options.detectSubjectType);
 }
+function hasPermission(source, requiredPermission) {
+  const requirement = permissionToRule(requiredPermission);
+  if (!requirement || typeof requirement.action !== "string" || typeof requirement.subject !== "string") {
+    return false;
+  }
+  const permissionSource = isPermissionList(source) ? { permissions: source } : source;
+  return createAuthyonAbility(permissionSource).can(requirement.action, requirement.subject);
+}
+function isPermissionList(source) {
+  return Array.isArray(source);
+}
 function createAuthyonRules(source = {}, options = {}) {
   const permissions = /* @__PURE__ */ new Set([
     ...source.permissions ?? [],
@@ -1068,9 +1396,14 @@ function permissionToRule(permission) {
 }
 function matchesToken(value, expected, wildcard) {
   return (Array.isArray(value) ? value : [value]).some(
-    (candidate) => candidate === expected || candidate === wildcard || candidate === "*"
+    (candidate) => candidate === expected || candidate === wildcard || candidate === "*" || matchesSegments(candidate, expected)
   );
 }
+function matchesSegments(pattern, value) {
+  const patternSegments = pattern.split(":");
+  const valueSegments = value.split(":");
+  return patternSegments.length === valueSegments.length && patternSegments.every((segment2, index) => segment2 === "*" || segment2 === valueSegments[index]);
+}
 function matchesField(pattern, field) {
   if (pattern === "*" || pattern === field) return true;
   return pattern.endsWith(".*") && field.startsWith(pattern.slice(0, -1));
@@ -1273,8 +1606,11 @@ export {
   FetchHttpAdapter,
   JwksTokenVerifier,
   LoggingHttpAdapter,
+  PlatformScopedClient,
   TenantScopedClient,
   TokenVerificationError,
+  UserScopedClient,
+  WorkspaceInvitesClient,
   authorizeRequest,
   authorizeToken,
   createAuthorizationErrorResponse,
@@ -1282,5 +1618,6 @@ export {
   createAuthyonRules,
   createClient,
   createExpressAuthorizationMiddleware,
+  hasPermission,
   normalizeClientIp
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@authyon/server",
-  "version": "0.2.0-beta.1",
+  "version": "0.2.0-beta.3",
   "description": "Authyon SDK for backends — server-to-server organization/member management and access-token verification.",
   "license": "MIT",
   "type": "module",