@adonis-agora/authkit-core 0.7.0 → 0.8.0

package/build/index.d.ts

@@ -1,4 +1,5 @@
 export type { Identity, SessionResolver } from './src/types/identity.js';
+export { ORG_ID_CLAIMS, deriveOrgId, deriveOrgSlug, deriveOrgRole, } from './src/types/identity.js';
 export type { ClientConfig, TtlConfig, JwksConfig, KeystoreStoreConfig, ObservabilityConfig, ResolvedAuthServerConfig, AccessTokenFormat, AccessTokenResourceConfig, AccessTokensConfig, } from './src/types/server_config.js';
 export { AUTHKIT_METRICS } from './src/metrics.js';
 export type { AuthkitMetricName } from './src/metrics.js';

package/build/index.js

@@ -1,2 +1,3 @@
+export { ORG_ID_CLAIMS, deriveOrgId, deriveOrgSlug, deriveOrgRole, } from './src/types/identity.js';
 export { AUTHKIT_METRICS } from './src/metrics.js';
 export { InMemorySnapshot, NoopRecorder } from './src/metrics_recorder.js';

package/build/src/metrics_recorder.js

@@ -18,7 +18,11 @@ export class InMemorySnapshot {
         this.#updatedAt = Date.now();
     }
     read() {
-        return { counters: { ...this.#counters }, histograms: { ...this.#histograms }, updatedAt: this.#updatedAt };
+        return {
+            counters: { ...this.#counters },
+            histograms: { ...this.#histograms },
+            updatedAt: this.#updatedAt,
+        };
     }
 }
 /** No-op: usado quando observability está desligada. */

package/build/src/types/identity.d.ts

@@ -16,6 +16,18 @@ export interface Identity {
     };
     /** `sid` quando presente */
     sessionId?: string;
+    /**
+     * Organização (tenant) ATIVA da sessão, derivada das claims — `null` quando o
+     * usuário não tem org ativa. Campo de primeira classe (e não só
+     * `raw.org_id`) porque é o eixo de multi-tenancy: é o que o app usa para
+     * escopar queries e o que a ponte de contexto publica como `tenantId` para o
+     * `@adonis-agora/authz`. Ver {@link ORG_ID_CLAIMS} para os aliases aceitos.
+     */
+    orgId?: string | null;
+    /** Slug da org ativa (claim `org_slug`), quando presente. */
+    orgSlug?: string | null;
+    /** Papel do usuário DENTRO da org ativa (claim `org_role`), quando presente. */
+    orgRole?: string | null;
     /** `iat` em epoch ms */
     issuedAt: number;
     /** `exp` em epoch ms */
@@ -30,3 +42,19 @@ export interface Identity {
 export interface SessionResolver {
     resolve(ctx: HttpContext): Promise<Identity | null>;
 }
+/**
+ * Claims OIDC candidatas a "organização/tenant ativo", em ordem de precedência.
+ * A primeira presente (string não vazia) vence.
+ *
+ * A lista existe porque o authkit é apenas UM dos IdPs possíveis: quando o app
+ * está atrás de um IdP de terceiro (ver `byo-idp`), o tenant chega com outro
+ * nome (`tid` no Entra ID, `organization_id` em vários). Derivar em UM lugar só
+ * evita que cada app — e cada lib do Agora — reescreva essa tabela.
+ */
+export declare const ORG_ID_CLAIMS: readonly ["active_organization_id", "org_id", "organization_id", "tenant_id", "tid"];
+/** Deriva a org/tenant ativo das claims cruas. `null` quando ausente. */
+export declare function deriveOrgId(claims: Record<string, unknown> | undefined): string | null;
+/** Deriva o slug da org ativa das claims cruas. `null` quando ausente. */
+export declare function deriveOrgSlug(claims: Record<string, unknown> | undefined): string | null;
+/** Deriva o papel do usuário na org ativa. `null` quando ausente. */
+export declare function deriveOrgRole(claims: Record<string, unknown> | undefined): string | null;

package/build/src/types/identity.js

@@ -1 +1,39 @@
-export {};
+/**
+ * Claims OIDC candidatas a "organização/tenant ativo", em ordem de precedência.
+ * A primeira presente (string não vazia) vence.
+ *
+ * A lista existe porque o authkit é apenas UM dos IdPs possíveis: quando o app
+ * está atrás de um IdP de terceiro (ver `byo-idp`), o tenant chega com outro
+ * nome (`tid` no Entra ID, `organization_id` em vários). Derivar em UM lugar só
+ * evita que cada app — e cada lib do Agora — reescreva essa tabela.
+ */
+export const ORG_ID_CLAIMS = [
+    'active_organization_id',
+    'org_id',
+    'organization_id',
+    'tenant_id',
+    'tid',
+];
+/** Lê a primeira claim string não-vazia de `names`, ou `null`. */
+function firstStringClaim(claims, names) {
+    if (!claims)
+        return null;
+    for (const name of names) {
+        const value = claims[name];
+        if (typeof value === 'string' && value.length > 0)
+            return value;
+    }
+    return null;
+}
+/** Deriva a org/tenant ativo das claims cruas. `null` quando ausente. */
+export function deriveOrgId(claims) {
+    return firstStringClaim(claims, ORG_ID_CLAIMS);
+}
+/** Deriva o slug da org ativa das claims cruas. `null` quando ausente. */
+export function deriveOrgSlug(claims) {
+    return firstStringClaim(claims, ['org_slug', 'organization_slug']);
+}
+/** Deriva o papel do usuário na org ativa. `null` quando ausente. */
+export function deriveOrgRole(claims) {
+    return firstStringClaim(claims, ['org_role', 'organization_role']);
+}

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@adonis-agora/authkit-core",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Shared core types and utilities for AuthKit — the AdonisJS OIDC/OAuth2 server and client toolkits.",
   "license": "MIT",
   "author": "dudousxd",
-  "homepage": "https://github.com/DavideCarvalho/adonis-authkit/tree/main/packages/authkit-core#readme",
+  "homepage": "https://github.com/DavideCarvalho/adonis-agora-authkit/tree/main/packages/authkit-core#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/DavideCarvalho/adonis-authkit.git",
+    "url": "https://github.com/DavideCarvalho/adonis-agora-authkit.git",
     "directory": "packages/authkit-core"
   },
   "bugs": {
-    "url": "https://github.com/DavideCarvalho/adonis-authkit/issues"
+    "url": "https://github.com/DavideCarvalho/adonis-agora-authkit/issues"
   },
   "keywords": [
     "adonisjs",
@@ -35,13 +35,17 @@
     "./types": "./build/index.js"
   },
   "devDependencies": {
-    "@adonisjs/core": "7.3.3",
+    "@adonisjs/core": "7.4.0",
     "@adonisjs/tsconfig": "2.0.0",
+    "@japa/assert": "4.2.0",
+    "@japa/runner": "5.3.0",
+    "@poppinss/ts-exec": "1.4.4",
     "@types/node": "25.9.1",
     "typescript": "6.0.3"
   },
   "scripts": {
     "build": "tsc",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.tests.json",
+    "test": "node --import=@poppinss/ts-exec bin/test.ts"
   }
 }