@contember/engine-tenant-api 2.1.0-rc.3 → 2.2.0-alpha.10

package/dist/production/src/model/service/idp/BackchannelLogoutManager.js

@@ -0,0 +1,84 @@
+import { IdentityProviderBySlugQuery } from "../../queries/idp/IdentityProviderBySlugQuery.js";
+import { IdpSessionsBySidQuery } from "../../queries/idp/IdpSessionsBySidQuery.js";
+import { IdpSessionsBySubQuery } from "../../queries/idp/IdpSessionsBySubQuery.js";
+import { ApiKeyByIdQuery } from "../../queries/apiKey/ApiKeyQuery.js";
+import "../../type/ApiKey.js";
+import "@contember/database";
+import "node:crypto";
+import { DisableApiKeyCommand } from "../../commands/apiKey/DisableApiKeyCommand.js";
+import { CreateAuthLogEntryCommand } from "../../commands/authLog/CreateAuthLogEntryCommand.js";
+import { IDPValidationError } from "./IDPValidationError.js";
+class BackchannelLogoutManager {
+  constructor(idpRegistry) {
+    this.idpRegistry = idpRegistry;
+  }
+  async logout(db, providerSlug, logoutToken) {
+    const provider = await db.queryHandler.fetch(new IdentityProviderBySlugQuery(providerSlug));
+    if (!provider) {
+      return { status: "provider_not_found" };
+    }
+    const handler = this.idpRegistry.getHandlerOrNull(provider.type);
+    if (!handler?.validateLogoutToken) {
+      return { status: "not_supported" };
+    }
+    let config;
+    try {
+      config = handler.validateConfiguration(provider.configuration);
+    } catch (e) {
+      return { status: "invalid_token", message: "IdP configuration is invalid" };
+    }
+    let claims;
+    try {
+      claims = await handler.validateLogoutToken(config, logoutToken);
+    } catch (e) {
+      return { status: "invalid_token", message: e instanceof IDPValidationError ? e.message : "Invalid logout token" };
+    }
+    const sessions = await this.resolveTargetSessions(db, provider.id, claims);
+    let revokedCount = 0;
+    for (const session of sessions) {
+      const disabled = await db.commandBus.execute(new DisableApiKeyCommand(session.apiKeyId));
+      if (disabled) {
+        revokedCount++;
+      }
+    }
+    await this.audit(db, provider.id, claims, revokedCount, sessions[0]?.apiKeyId);
+    return { status: "ok", revokedCount };
+  }
+  async resolveTargetSessions(db, identityProviderId, claims) {
+    if (claims.sid) {
+      return db.queryHandler.fetch(new IdpSessionsBySidQuery(identityProviderId, claims.sid));
+    }
+    if (claims.sub) {
+      return db.queryHandler.fetch(new IdpSessionsBySubQuery(identityProviderId, claims.sub));
+    }
+    return [];
+  }
+  async audit(db, identityProviderId, claims, revokedCount, targetApiKeyId) {
+    let invokedById;
+    let personId;
+    if (targetApiKeyId) {
+      const apiKeyRow = await db.queryHandler.fetch(new ApiKeyByIdQuery(targetApiKeyId));
+      if (apiKeyRow) {
+        invokedById = apiKeyRow.identity_id;
+        personId = apiKeyRow.person_id ?? void 0;
+      }
+    }
+    try {
+      await db.commandBus.execute(
+        new CreateAuthLogEntryCommand({
+          type: "idp_backchannel_logout",
+          invokedById,
+          personId,
+          identityProviderId,
+          success: true,
+          eventData: { sid: claims.sid ?? null, sub: claims.sub ?? null, revokedCount }
+        })
+      );
+    } catch {
+    }
+  }
+}
+export {
+  BackchannelLogoutManager
+};
+//# sourceMappingURL=BackchannelLogoutManager.js.map

package/dist/production/src/model/service/idp/BackchannelLogoutManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackchannelLogoutManager.js","sources":["../../../../../../../packages/engine-tenant-api/src/model/service/idp/BackchannelLogoutManager.ts"],"sourcesContent":["import { DatabaseContext } from '../../utils/index.js'\nimport { IdentityProviderBySlugQuery } from '../../queries/idp/IdentityProviderBySlugQuery.js'\nimport { IdpSessionBySidRow, IdpSessionsBySidQuery } from '../../queries/idp/IdpSessionsBySidQuery.js'\nimport { IdpSessionsBySubQuery } from '../../queries/idp/IdpSessionsBySubQuery.js'\nimport { ApiKeyByIdQuery } from '../../queries/apiKey/ApiKeyQuery.js'\nimport { DisableApiKeyCommand } from '../../commands/index.js'\nimport { CreateAuthLogEntryCommand } from '../../commands/authLog/CreateAuthLogEntryCommand.js'\nimport { IDPHandlerRegistry } from './IDPHandlerRegistry.js'\nimport { IDPValidationError } from './IDPValidationError.js'\n\nexport type BackchannelLogoutResult =\n\t| { status: 'ok'; revokedCount: number }\n\t| { status: 'provider_not_found' }\n\t| { status: 'not_supported' }\n\t| { status: 'invalid_token'; message: string }\n\n/**\n * Handles an incoming OIDC Back-Channel Logout request (A10). Runs entirely on the HTTP auth path\n * (no GraphQL resolver), so — like {@link IdpSessionRevalidator} — it owns its own audit write\n * rather than deferring to a resolver. Flow:\n *   1. resolve the IdP by slug (the back-channel endpoint carries a `?provider=` query param, since\n *      the IdP only knows which client it is calling, not the Contember tenant/provider record);\n *   2. validate the IdP-signed logout token and extract `sid` / `sub`;\n *   3. look up the local federated session(s) the token targets and revoke their api_key(s).\n *\n * A logout token with a `sid` targets that single IdP session; a `sub`-only token (rare — most IdPs\n * send a `sid`) targets *all* of that subject's federated sessions under the provider. Either way, a\n * token that matches no live session is reported as `revokedCount: 0` and audited, not failed.\n */\nexport class BackchannelLogoutManager {\n\tconstructor(\n\t\tprivate readonly idpRegistry: IDPHandlerRegistry,\n\t) {}\n\n\tasync logout(db: DatabaseContext, providerSlug: string, logoutToken: string): Promise<BackchannelLogoutResult> {\n\t\tconst provider = await db.queryHandler.fetch(new IdentityProviderBySlugQuery(providerSlug))\n\t\tif (!provider) {\n\t\t\treturn { status: 'provider_not_found' }\n\t\t}\n\n\t\tconst handler = this.idpRegistry.getHandlerOrNull(provider.type)\n\t\tif (!handler?.validateLogoutToken) {\n\t\t\treturn { status: 'not_supported' }\n\t\t}\n\n\t\tlet config: {}\n\t\ttry {\n\t\t\tconfig = handler.validateConfiguration(provider.configuration)\n\t\t} catch (e) {\n\t\t\treturn { status: 'invalid_token', message: 'IdP configuration is invalid' }\n\t\t}\n\n\t\tlet claims: { sid?: string; sub?: string }\n\t\ttry {\n\t\t\tclaims = await handler.validateLogoutToken(config, logoutToken)\n\t\t} catch (e) {\n\t\t\treturn { status: 'invalid_token', message: e instanceof IDPValidationError ? e.message : 'Invalid logout token' }\n\t\t}\n\n\t\tconst sessions = await this.resolveTargetSessions(db, provider.id, claims)\n\t\tlet revokedCount = 0\n\t\tfor (const session of sessions) {\n\t\t\tconst disabled = await db.commandBus.execute(new DisableApiKeyCommand(session.apiKeyId))\n\t\t\tif (disabled) {\n\t\t\t\trevokedCount++\n\t\t\t}\n\t\t}\n\n\t\tawait this.audit(db, provider.id, claims, revokedCount, sessions[0]?.apiKeyId)\n\n\t\treturn { status: 'ok', revokedCount }\n\t}\n\n\tprivate async resolveTargetSessions(\n\t\tdb: DatabaseContext,\n\t\tidentityProviderId: string,\n\t\tclaims: { sid?: string; sub?: string },\n\t): Promise<IdpSessionBySidRow[]> {\n\t\t// Prefer `sid` (targets one session); fall back to `sub` (targets all the subject's sessions).\n\t\tif (claims.sid) {\n\t\t\treturn db.queryHandler.fetch(new IdpSessionsBySidQuery(identityProviderId, claims.sid))\n\t\t}\n\t\tif (claims.sub) {\n\t\t\treturn db.queryHandler.fetch(new IdpSessionsBySubQuery(identityProviderId, claims.sub))\n\t\t}\n\t\treturn []\n\t}\n\n\tprivate async audit(\n\t\tdb: DatabaseContext,\n\t\tidentityProviderId: string,\n\t\tclaims: { sid?: string; sub?: string },\n\t\trevokedCount: number,\n\t\ttargetApiKeyId: string | undefined,\n\t): Promise<void> {\n\t\t// Resolve the affected identity for the audit `invoked_by_id` from a targeted session, when\n\t\t// one resolves. Otherwise leave it unset (→ NULL) — the provider id is NOT a valid identity id\n\t\t// and inserting it would violate the `invoked_by_id` FK (the provider is recorded separately\n\t\t// in `identity_provider_id`).\n\t\tlet invokedById: string | undefined\n\t\tlet personId: string | undefined\n\t\tif (targetApiKeyId) {\n\t\t\tconst apiKeyRow = await db.queryHandler.fetch(new ApiKeyByIdQuery(targetApiKeyId))\n\t\t\tif (apiKeyRow) {\n\t\t\t\tinvokedById = apiKeyRow.identity_id\n\t\t\t\tpersonId = apiKeyRow.person_id ?? undefined\n\t\t\t}\n\t\t}\n\n\t\ttry {\n\t\t\tawait db.commandBus.execute(\n\t\t\t\tnew CreateAuthLogEntryCommand({\n\t\t\t\t\ttype: 'idp_backchannel_logout',\n\t\t\t\t\tinvokedById,\n\t\t\t\t\tpersonId,\n\t\t\t\t\tidentityProviderId,\n\t\t\t\t\tsuccess: true,\n\t\t\t\t\teventData: { sid: claims.sid ?? null, sub: claims.sub ?? null, revokedCount },\n\t\t\t\t}),\n\t\t\t)\n\t\t} catch {\n\t\t\t// best-effort observability — never fail the logout because the audit write failed\n\t\t}\n\t}\n}\n"],"names":[],"mappings":";;;;;;;;;;AA6BO,MAAM,yBAAyB;AAAA,EACrC,YACkB,aAChB;AADgB,SAAA,cAAA;AAAA,EACf;AAAA,EAEH,MAAM,OAAO,IAAqB,cAAsB,aAAuD;AAC9G,UAAM,WAAW,MAAM,GAAG,aAAa,MAAM,IAAI,4BAA4B,YAAY,CAAC;AAC1F,QAAI,CAAC,UAAU;AACd,aAAO,EAAE,QAAQ,qBAAA;AAAA,IAClB;AAEA,UAAM,UAAU,KAAK,YAAY,iBAAiB,SAAS,IAAI;AAC/D,QAAI,CAAC,SAAS,qBAAqB;AAClC,aAAO,EAAE,QAAQ,gBAAA;AAAA,IAClB;AAEA,QAAI;AACJ,QAAI;AACH,eAAS,QAAQ,sBAAsB,SAAS,aAAa;AAAA,IAC9D,SAAS,GAAG;AACX,aAAO,EAAE,QAAQ,iBAAiB,SAAS,+BAAA;AAAA,IAC5C;AAEA,QAAI;AACJ,QAAI;AACH,eAAS,MAAM,QAAQ,oBAAoB,QAAQ,WAAW;AAAA,IAC/D,SAAS,GAAG;AACX,aAAO,EAAE,QAAQ,iBAAiB,SAAS,aAAa,qBAAqB,EAAE,UAAU,uBAAA;AAAA,IAC1F;AAEA,UAAM,WAAW,MAAM,KAAK,sBAAsB,IAAI,SAAS,IAAI,MAAM;AACzE,QAAI,eAAe;AACnB,eAAW,WAAW,UAAU;AAC/B,YAAM,WAAW,MAAM,GAAG,WAAW,QAAQ,IAAI,qBAAqB,QAAQ,QAAQ,CAAC;AACvF,UAAI,UAAU;AACb;AAAA,MACD;AAAA,IACD;AAEA,UAAM,KAAK,MAAM,IAAI,SAAS,IAAI,QAAQ,cAAc,SAAS,CAAC,GAAG,QAAQ;AAE7E,WAAO,EAAE,QAAQ,MAAM,aAAA;AAAA,EACxB;AAAA,EAEA,MAAc,sBACb,IACA,oBACA,QACgC;AAEhC,QAAI,OAAO,KAAK;AACf,aAAO,GAAG,aAAa,MAAM,IAAI,sBAAsB,oBAAoB,OAAO,GAAG,CAAC;AAAA,IACvF;AACA,QAAI,OAAO,KAAK;AACf,aAAO,GAAG,aAAa,MAAM,IAAI,sBAAsB,oBAAoB,OAAO,GAAG,CAAC;AAAA,IACvF;AACA,WAAO,CAAA;AAAA,EACR;AAAA,EAEA,MAAc,MACb,IACA,oBACA,QACA,cACA,gBACgB;AAKhB,QAAI;AACJ,QAAI;AACJ,QAAI,gBAAgB;AACnB,YAAM,YAAY,MAAM,GAAG,aAAa,MAAM,IAAI,gBAAgB,cAAc,CAAC;AACjF,UAAI,WAAW;AACd,sBAAc,UAAU;AACxB,mBAAW,UAAU,aAAa;AAAA,MACnC;AAAA,IACD;AAEA,QAAI;AACH,YAAM,GAAG,WAAW;AAAA,QACnB,IAAI,0BAA0B;AAAA,UAC7B,MAAM;AAAA,UACN;AAAA,UACA;AAAA,UACA;AAAA,UACA,SAAS;AAAA,UACT,WAAW,EAAE,KAAK,OAAO,OAAO,MAAM,KAAK,OAAO,OAAO,MAAM,aAAA;AAAA,QAAa,CAC5E;AAAA,MAAA;AAAA,IAEH,QAAQ;AAAA,IAER;AAAA,EACD;AACD;"}

package/dist/production/src/model/service/idp/ClaimMapping.cjs

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const Typesafe = require("@contember/typesafe");
+function _interopNamespaceDefault(e) {
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
+  if (e) {
+    for (const k in e) {
+      if (k !== "default") {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+const Typesafe__namespace = /* @__PURE__ */ _interopNamespaceDefault(Typesafe);
+const ClaimValueSource = Typesafe__namespace.noExtraProps(Typesafe__namespace.intersection(
+  Typesafe__namespace.object({
+    /** Claim to read: the exact name first (URL-namespaced names work), then as a dot-path (e.g. `profile.languages`). */
+    claim: Typesafe__namespace.string
+  }),
+  Typesafe__namespace.partial({
+    /** Split each string value on this delimiter (e.g. `,` or ` `): a scalar string claim and every string element of an array claim. A no-op for non-string values. */
+    split: Typesafe__namespace.string,
+    /** For an array-of-objects claim, take this (dot-path) field from each element. */
+    pick: Typesafe__namespace.string,
+    /** For an array-of-objects claim, keep only elements whose `field` equals `equals`. */
+    where: Typesafe__namespace.noExtraProps(Typesafe__namespace.object({
+      field: Typesafe__namespace.string,
+      equals: Typesafe__namespace.scalar
+    }))
+  })
+));
+const ClaimMappingVariable = Typesafe__namespace.noExtraProps(Typesafe__namespace.intersection(
+  Typesafe__namespace.object({
+    name: Typesafe__namespace.string
+  }),
+  Typesafe__namespace.partial({
+    /** Constant values, set regardless of any claim (the original static form). */
+    values: Typesafe__namespace.array(Typesafe__namespace.string),
+    /** Derive (additional) values from a claim. */
+    from: ClaimValueSource,
+    /** Lookup table applied to each raw value from `from`. A raw value with no entry is dropped unless `passthrough`. */
+    map: Typesafe__namespace.record(Typesafe__namespace.string, Typesafe__namespace.array(Typesafe__namespace.string)),
+    /** When `true`, a raw value from `from` not present in `map` is set verbatim. See the security note above. */
+    passthrough: Typesafe__namespace.boolean,
+    /** Allowlist applied to the values derived from `from` (constants in `values` are unaffected). */
+    allow: Typesafe__namespace.array(Typesafe__namespace.string)
+  })
+));
+const ClaimMappingMembership = Typesafe__namespace.noExtraProps(Typesafe__namespace.intersection(
+  Typesafe__namespace.object({
+    project: Typesafe__namespace.string,
+    role: Typesafe__namespace.string
+  }),
+  Typesafe__namespace.partial({
+    /**
+     * Membership variables to set. Each is constant (`values`, e.g. `[{ name: 'locale', values: ['cs'] }]`)
+     * and/or claim-derived (`from`, e.g. map a `languages` claim through a lookup table to locale ids).
+     */
+    variables: Typesafe__namespace.array(ClaimMappingVariable)
+  })
+));
+const ClaimMappingRule = Typesafe__namespace.noExtraProps(Typesafe__namespace.intersection(
+  Typesafe__namespace.object({
+    /** Claim/attribute from the IdP response to inspect: the exact name first, then as a dot-path into nested objects. */
+    claim: Typesafe__namespace.string
+  }),
+  Typesafe__namespace.partial({
+    /** Match when the claim equals this value (array claims: when it contains this element). */
+    equals: Typesafe__namespace.scalar,
+    /** Match when the claim contains this value (substring for strings, element for arrays). */
+    contains: Typesafe__namespace.scalar,
+    /** Project membership to grant when the rule matches. */
+    grantMembership: ClaimMappingMembership
+  })
+));
+const ClaimMapping = Typesafe__namespace.intersection(
+  Typesafe__namespace.object({
+    rules: Typesafe__namespace.array(ClaimMappingRule)
+  }),
+  Typesafe__namespace.partial({
+    /**
+     * When to apply the mapping:
+     * - `always` (default) — re-sync memberships on every sign-in (and on every OIDC session refresh).
+     * - `sticky`           — apply only when the account is first created by auto-sign-up; existing
+     *                        accounts (including one being linked to this IdP for the first time) are
+     *                        left untouched.
+     */
+    syncPolicy: Typesafe__namespace.enumeration("always", "sticky"),
+    /**
+     * How to treat existing grants the mapping does NOT (re)assign on this sign-in:
+     * - `keep`   (default, safer) — leave pre-existing memberships untouched.
+     * - `remove` — strip memberships that the mapping no longer grants (IdP becomes the source of
+     *              truth). Only ever touches grants the mapping itself could have made; memberships
+     *              outside the mapping's vocabulary are never removed.
+     */
+    unmatched: Typesafe__namespace.enumeration("keep", "remove")
+  })
+);
+const DEFAULT_SYNC_POLICY = "always";
+const DEFAULT_UNMATCHED = "keep";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const parseClaimMapping = (configuration) => {
+  const raw = configuration.claimMapping;
+  if (!isRecord(raw) || raw.rules === void 0 || raw.rules === null) {
+    return null;
+  }
+  const input = { rules: raw.rules };
+  if (raw.syncPolicy !== void 0) {
+    input.syncPolicy = raw.syncPolicy;
+  }
+  if (raw.unmatched !== void 0) {
+    input.unmatched = raw.unmatched;
+  }
+  return ClaimMapping(input, ["claimMapping"]);
+};
+const REMOVED_RULE_KEYS = ["grantRoles"];
+const findRemovedRuleKeys = (configuration) => {
+  const raw = configuration.claimMapping;
+  if (!isRecord(raw) || !Array.isArray(raw.rules)) {
+    return [];
+  }
+  const found = /* @__PURE__ */ new Set();
+  for (const rule of raw.rules) {
+    if (isRecord(rule)) {
+      for (const key of REMOVED_RULE_KEYS) {
+        if (key in rule) {
+          found.add(key);
+        }
+      }
+    }
+  }
+  return [...found];
+};
+const findClaimMappingShapeErrors = (mapping) => {
+  const errors = [];
+  for (const rule of mapping.rules) {
+    if (rule.grantMembership === void 0) {
+      errors.push(
+        `claimMapping rule for claim '${rule.claim}' has no 'grantMembership', so it matches but grants nothing; add a 'grantMembership'`
+      );
+    }
+    if (rule.equals !== void 0 && rule.contains !== void 0) {
+      errors.push(`claimMapping rule for claim '${rule.claim}' sets both 'equals' and 'contains'; a rule may use at most one`);
+    }
+    if (typeof rule.equals === "string" && rule.equals.trim() === "") {
+      errors.push(
+        `claimMapping rule for claim '${rule.claim}' has an empty 'equals' value; omit both 'equals' and 'contains' to match on the claim's mere presence, or set a non-empty value`
+      );
+    }
+    if (typeof rule.contains === "string" && rule.contains.trim() === "") {
+      errors.push(
+        `claimMapping rule for claim '${rule.claim}' has an empty 'contains' value, which would substring-match every string value of the claim (a match-everything grant); omit both 'equals' and 'contains' to match on the claim's mere presence, or set a non-empty value`
+      );
+    }
+    for (const variable of rule.grantMembership?.variables ?? []) {
+      if (variable.from?.where !== void 0 && variable.from.pick === void 0) {
+        errors.push(
+          `claimMapping variable '${variable.name}' uses 'from.where' without 'from.pick'; it can only ever resolve to no values — set 'pick' (the field to take from each matched element)`
+        );
+      }
+      if (variable.from?.split === "") {
+        errors.push(
+          `claimMapping variable '${variable.name}' has an empty 'from.split' delimiter, which splits every claim value into its individual characters; omit 'split' to keep the value whole, or set a non-empty delimiter`
+        );
+      }
+    }
+  }
+  return errors;
+};
+exports.ClaimMapping = ClaimMapping;
+exports.ClaimMappingMembership = ClaimMappingMembership;
+exports.ClaimMappingRule = ClaimMappingRule;
+exports.ClaimMappingVariable = ClaimMappingVariable;
+exports.ClaimValueSource = ClaimValueSource;
+exports.DEFAULT_SYNC_POLICY = DEFAULT_SYNC_POLICY;
+exports.DEFAULT_UNMATCHED = DEFAULT_UNMATCHED;
+exports.findClaimMappingShapeErrors = findClaimMappingShapeErrors;
+exports.findRemovedRuleKeys = findRemovedRuleKeys;
+exports.isRecord = isRecord;
+exports.parseClaimMapping = parseClaimMapping;
+//# sourceMappingURL=ClaimMapping.cjs.map

package/dist/production/src/model/service/idp/ClaimMapping.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaimMapping.cjs","sources":["../../../../../../../packages/engine-tenant-api/src/model/service/idp/ClaimMapping.ts"],"sourcesContent":["import * as Typesafe from '@contember/typesafe'\n\n/**\n * Provider-agnostic mapping of IdP claims/attributes to Contember project memberships (A09).\n * Stored on an IdP's `configuration.claimMapping`, so it rides inside the existing\n * `identity_provider.configuration` JSONB and needs no schema change — `addIDP` / `updateIDP`\n * already accept an opaque configuration object.\n *\n * The mapping grants **project memberships only** (a project role plus optional membership\n * variables). It deliberately does NOT grant global/tenant roles: those are privilege-bearing\n * and granting them from external claims would be a privilege-escalation path, so global-role\n * mapping was dropped. A project membership stays within what the IdP configurer\n * (`project_admin`, holding `IDP_ADD` / `IDP_UPDATE`) may already grant directly.\n *\n * Coexistence: the OIDC provider also uses `configuration.claimMapping` for an unrelated\n * identity-field remap (`email` / `name` / `externalIdentifier` / `attributesKey`). A09 only\n * looks at the `rules` field, so the two coexist in the same object — {@link parseClaimMapping}\n * returns `null` when no `rules` are present (an OIDC-only remap) instead of rejecting it.\n *\n * Each rule inspects one `claim` from the IdP response (the raw claims flow through verbatim,\n * since `IDPResponse` is `& Record<string, unknown>`) and, when it matches, grants a project\n * membership. Rules are independent and additive — every matching rule contributes; a\n * non-matching rule is simply skipped.\n *\n * Matching is declarative, never code:\n * - `equals`   — the claim equals the value (scalar compare; for array claims, the value is one\n *                of the elements).\n * - `contains` — the claim contains the value: substring for string claims, membership for array\n *                claims. This is the natural fit for multi-valued `groups`.\n * - neither    — the rule matches whenever the claim is merely present (and truthy for booleans).\n */\n/**\n * Where a membership variable's values come from when they are not constant. Reads one `claim` from the\n * IdP response — by exact name first (a URL-namespaced claim with literal dots works), then as a dot-path\n * (nested claims like `profile.languages`) — and shapes the raw value(s) into a flat list of strings:\n * - array claim       → its elements (`languages: ['cs','en']`)\n * - `split`           → split a delimited string claim (`'cs,en'`, OIDC-style `'cs en'`) into elements\n * - `pick` / `where`  → for an array-of-objects claim, keep elements matching `where` and take their\n *                       `pick` field (`orgs: [{ code, role }]` → codes of the elements where role matches)\n *\n * The extracted raw values are then run through {@link ClaimMappingVariable}'s `map` / `passthrough`.\n */\nexport const ClaimValueSource = Typesafe.noExtraProps(Typesafe.intersection(\n\tTypesafe.object({\n\t\t/** Claim to read: the exact name first (URL-namespaced names work), then as a dot-path (e.g. `profile.languages`). */\n\t\tclaim: Typesafe.string,\n\t}),\n\tTypesafe.partial({\n\t\t/** Split each string value on this delimiter (e.g. `,` or ` `): a scalar string claim and every string element of an array claim. A no-op for non-string values. */\n\t\tsplit: Typesafe.string,\n\t\t/** For an array-of-objects claim, take this (dot-path) field from each element. */\n\t\tpick: Typesafe.string,\n\t\t/** For an array-of-objects claim, keep only elements whose `field` equals `equals`. */\n\t\twhere: Typesafe.noExtraProps(Typesafe.object({\n\t\t\tfield: Typesafe.string,\n\t\t\tequals: Typesafe.scalar,\n\t\t})),\n\t}),\n))\n\nexport type ClaimValueSource = ReturnType<typeof ClaimValueSource>\n\n/**\n * One membership variable to set on a granted membership. Either constant (`values`), claim-derived\n * (`from`), or both — the two sets are unioned. When derived from a claim:\n * - `map`         — lookup table from a raw claim value to the value(s) actually set, e.g.\n *                   `{ cs: ['<locale-uuid>'] }`. A raw value absent from the map is dropped…\n * - `passthrough` — …unless `passthrough` is `true`, in which case it is set verbatim. Off by\n *                   default: raw external claim values then flow straight into row-level ACL\n *                   variables, so enable it only when the variable legitimately holds claim values\n *                   (not opaque ids), and prefer `map` / `allow` to bound what an IdP can inject.\n * - `allow`       — optional allowlist applied to the claim-derived values (constants are never filtered).\n */\nexport const ClaimMappingVariable = Typesafe.noExtraProps(Typesafe.intersection(\n\tTypesafe.object({\n\t\tname: Typesafe.string,\n\t}),\n\tTypesafe.partial({\n\t\t/** Constant values, set regardless of any claim (the original static form). */\n\t\tvalues: Typesafe.array(Typesafe.string),\n\t\t/** Derive (additional) values from a claim. */\n\t\tfrom: ClaimValueSource,\n\t\t/** Lookup table applied to each raw value from `from`. A raw value with no entry is dropped unless `passthrough`. */\n\t\tmap: Typesafe.record(Typesafe.string, Typesafe.array(Typesafe.string)),\n\t\t/** When `true`, a raw value from `from` not present in `map` is set verbatim. See the security note above. */\n\t\tpassthrough: Typesafe.boolean,\n\t\t/** Allowlist applied to the values derived from `from` (constants in `values` are unaffected). */\n\t\tallow: Typesafe.array(Typesafe.string),\n\t}),\n))\n\nexport type ClaimMappingVariable = ReturnType<typeof ClaimMappingVariable>\n\nexport const ClaimMappingMembership = Typesafe.noExtraProps(Typesafe.intersection(\n\tTypesafe.object({\n\t\tproject: Typesafe.string,\n\t\trole: Typesafe.string,\n\t}),\n\tTypesafe.partial({\n\t\t/**\n\t\t * Membership variables to set. Each is constant (`values`, e.g. `[{ name: 'locale', values: ['cs'] }]`)\n\t\t * and/or claim-derived (`from`, e.g. map a `languages` claim through a lookup table to locale ids).\n\t\t */\n\t\tvariables: Typesafe.array(ClaimMappingVariable),\n\t}),\n))\n\nexport type ClaimMappingMembership = ReturnType<typeof ClaimMappingMembership>\n\nexport const ClaimMappingRule = Typesafe.noExtraProps(Typesafe.intersection(\n\tTypesafe.object({\n\t\t/** Claim/attribute from the IdP response to inspect: the exact name first, then as a dot-path into nested objects. */\n\t\tclaim: Typesafe.string,\n\t}),\n\tTypesafe.partial({\n\t\t/** Match when the claim equals this value (array claims: when it contains this element). */\n\t\tequals: Typesafe.scalar,\n\t\t/** Match when the claim contains this value (substring for strings, element for arrays). */\n\t\tcontains: Typesafe.scalar,\n\t\t/** Project membership to grant when the rule matches. */\n\t\tgrantMembership: ClaimMappingMembership,\n\t}),\n))\n\nexport type ClaimMappingRule = ReturnType<typeof ClaimMappingRule>\n\n/**\n * The validated A09 mapping. `rules` is required here — {@link parseClaimMapping} only returns a\n * mapping once it has confirmed `rules` is present, and returns `null` otherwise (so an OIDC-only\n * `claimMapping` is treated as \"no role mapping\", not an error).\n */\nexport const ClaimMapping = Typesafe.intersection(\n\tTypesafe.object({\n\t\trules: Typesafe.array(ClaimMappingRule),\n\t}),\n\tTypesafe.partial({\n\t\t/**\n\t\t * When to apply the mapping:\n\t\t * - `always` (default) — re-sync memberships on every sign-in (and on every OIDC session refresh).\n\t\t * - `sticky`           — apply only when the account is first created by auto-sign-up; existing\n\t\t *                        accounts (including one being linked to this IdP for the first time) are\n\t\t *                        left untouched.\n\t\t */\n\t\tsyncPolicy: Typesafe.enumeration('always', 'sticky'),\n\t\t/**\n\t\t * How to treat existing grants the mapping does NOT (re)assign on this sign-in:\n\t\t * - `keep`   (default, safer) — leave pre-existing memberships untouched.\n\t\t * - `remove` — strip memberships that the mapping no longer grants (IdP becomes the source of\n\t\t *              truth). Only ever touches grants the mapping itself could have made; memberships\n\t\t *              outside the mapping's vocabulary are never removed.\n\t\t */\n\t\tunmatched: Typesafe.enumeration('keep', 'remove'),\n\t}),\n)\n\nexport type ClaimMapping = ReturnType<typeof ClaimMapping>\n\nexport const DEFAULT_SYNC_POLICY: NonNullable<ClaimMapping['syncPolicy']> = 'always'\nexport const DEFAULT_UNMATCHED: NonNullable<ClaimMapping['unmatched']> = 'keep'\n\nexport const isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * Parse the optional A09 `claimMapping` out of an IdP `configuration` blob. Returns `null` when no\n * A09 mapping is present — either no `claimMapping` at all, or a `claimMapping` that carries no\n * `rules` (e.g. the OIDC identity-field remap, which shares this key). Returning `null` keeps both\n * the pre-A09 sign-in path and the OIDC remap untouched.\n *\n * Only the A09 fields (`rules`, `syncPolicy`, `unmatched`) are validated; any other keys on the\n * `claimMapping` object (the OIDC remap fields) are ignored, so the two features coexist. Throws via\n * Typesafe when `rules` is present but structurally malformed (e.g. a rule missing its required\n * `claim`), so an A09 misconfiguration surfaces loudly rather than silently dropping grants.\n *\n * The nested A09 schemas (rule / membership / variable / value-source) are wrapped in\n * `Typesafe.noExtraProps`, so a typo'd key on any of them (e.g. `grantMembershp`, `equls`) is\n * REJECTED, not silently stripped — a misconfiguration surfaces loudly instead of degrading into a\n * grants-nothing or match-everyone rule. The one exception is the top-level `claimMapping` object\n * itself: it is the key SHARED with the OIDC identity-remap (`email`/`name`/`externalIdentifier`/\n * `attributesKey`), so this parse first projects only the A09 fields (`rules`/`syncPolicy`/`unmatched`)\n * into a fresh object (above) and deliberately does NOT apply `noExtraProps` there — the OIDC remap\n * fields must coexist. The `map` lookup table is likewise a `record` (arbitrary keys are legitimate),\n * not a strict object. The removed `grantRoles` key is still caught separately by\n * {@link findRemovedRuleKeys} (run before this parse) for a clearer message than the generic\n * extra-property error `noExtraProps` would otherwise raise.\n */\nexport const parseClaimMapping = (configuration: Record<string, unknown>): ClaimMapping | null => {\n\tconst raw = configuration.claimMapping\n\tif (!isRecord(raw) || raw.rules === undefined || raw.rules === null) {\n\t\treturn null\n\t}\n\tconst input: Record<string, unknown> = { rules: raw.rules }\n\tif (raw.syncPolicy !== undefined) {\n\t\tinput.syncPolicy = raw.syncPolicy\n\t}\n\tif (raw.unmatched !== undefined) {\n\t\tinput.unmatched = raw.unmatched\n\t}\n\treturn ClaimMapping(input, ['claimMapping'])\n}\n\n/**\n * The set of A09 rule keys that were removed when global-role mapping was dropped. Detected\n * explicitly (rather than relying on Typesafe's generic \"extra property\" rejection) so a config\n * that still tries to grant global roles gets an actionable error.\n */\nconst REMOVED_RULE_KEYS = ['grantRoles'] as const\n\n/**\n * Returns the removed rule keys (currently only `grantRoles`) still present in a raw `claimMapping`,\n * so config-time validation can reject them with a clear message pointing at `grantMembership`.\n */\nexport const findRemovedRuleKeys = (configuration: Record<string, unknown>): string[] => {\n\tconst raw = configuration.claimMapping\n\tif (!isRecord(raw) || !Array.isArray(raw.rules)) {\n\t\treturn []\n\t}\n\tconst found = new Set<string>()\n\tfor (const rule of raw.rules) {\n\t\tif (isRecord(rule)) {\n\t\t\tfor (const key of REMOVED_RULE_KEYS) {\n\t\t\t\tif (key in rule) {\n\t\t\t\t\tfound.add(key)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\treturn [...found]\n}\n\n/**\n * Semantic checks on a parsed mapping that the Typesafe shape cannot express. Returns one\n * human-readable message per problem (empty = ok); run at config time (IdP add/update) so a\n * contradictory rule is rejected loudly rather than silently mis-matching or granting nothing:\n * - a rule may use at most one of `equals` / `contains` ({@link ruleMatches} only ever honours `equals`\n *   when both are set, so the other would be silently ignored);\n * - a rule's `equals` / `contains` must not be an empty string: an empty `contains` substring-matches EVERY\n *   string claim (`'...'.includes('')` is always true), i.e. a match-everything grant to every user of the\n *   IdP, and an empty `equals` is an always-no-op footgun — to match on the claim's mere presence, omit both;\n * - a rule must carry a `grantMembership` — a rule with none matches but grants nothing. (A *misspelled*\n *   `grantMembership`, e.g. `grantMembershp`, is now rejected earlier by `noExtraProps` during\n *   {@link parseClaimMapping}; this check remains for a `grantMembership` that is genuinely OMITTED,\n *   which the `partial` schema permits.)\n * - a variable's `from.where` requires a `from.pick` — `where` filters elements but without `pick` there\n *   is nothing to project, so the source can only ever resolve to no values;\n * - a variable's `from.split` must not be the empty string — `''.split('')` explodes every claim value\n *   into its individual characters (the same class of footgun as an empty `equals` / `contains`).\n */\nexport const findClaimMappingShapeErrors = (mapping: ClaimMapping): string[] => {\n\tconst errors: string[] = []\n\tfor (const rule of mapping.rules) {\n\t\tif (rule.grantMembership === undefined) {\n\t\t\terrors.push(\n\t\t\t\t`claimMapping rule for claim '${rule.claim}' has no 'grantMembership', so it matches but grants nothing; add a 'grantMembership'`,\n\t\t\t)\n\t\t}\n\t\tif (rule.equals !== undefined && rule.contains !== undefined) {\n\t\t\terrors.push(`claimMapping rule for claim '${rule.claim}' sets both 'equals' and 'contains'; a rule may use at most one`)\n\t\t}\n\t\tif (typeof rule.equals === 'string' && rule.equals.trim() === '') {\n\t\t\terrors.push(\n\t\t\t\t`claimMapping rule for claim '${rule.claim}' has an empty 'equals' value; omit both 'equals' and 'contains' to match on the claim's mere presence, or set a non-empty value`,\n\t\t\t)\n\t\t}\n\t\tif (typeof rule.contains === 'string' && rule.contains.trim() === '') {\n\t\t\terrors.push(\n\t\t\t\t`claimMapping rule for claim '${rule.claim}' has an empty 'contains' value, which would substring-match every string value of the claim (a match-everything grant); omit both 'equals' and 'contains' to match on the claim's mere presence, or set a non-empty value`,\n\t\t\t)\n\t\t}\n\t\tfor (const variable of rule.grantMembership?.variables ?? []) {\n\t\t\tif (variable.from?.where !== undefined && variable.from.pick === undefined) {\n\t\t\t\terrors.push(\n\t\t\t\t\t`claimMapping variable '${variable.name}' uses 'from.where' without 'from.pick'; it can only ever resolve to no values — set 'pick' (the field to take from each matched element)`,\n\t\t\t\t)\n\t\t\t}\n\t\t\tif (variable.from?.split === '') {\n\t\t\t\terrors.push(\n\t\t\t\t\t`claimMapping variable '${variable.name}' has an empty 'from.split' delimiter, which splits every claim value into its individual characters; omit 'split' to keep the value whole, or set a non-empty delimiter`,\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t}\n\treturn errors\n}\n"],"names":["Typesafe"],"mappings":"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"}

package/dist/production/src/model/service/idp/ClaimMapping.js

@@ -0,0 +1,170 @@
+import * as Typesafe from "@contember/typesafe";
+const ClaimValueSource = Typesafe.noExtraProps(Typesafe.intersection(
+  Typesafe.object({
+    /** Claim to read: the exact name first (URL-namespaced names work), then as a dot-path (e.g. `profile.languages`). */
+    claim: Typesafe.string
+  }),
+  Typesafe.partial({
+    /** Split each string value on this delimiter (e.g. `,` or ` `): a scalar string claim and every string element of an array claim. A no-op for non-string values. */
+    split: Typesafe.string,
+    /** For an array-of-objects claim, take this (dot-path) field from each element. */
+    pick: Typesafe.string,
+    /** For an array-of-objects claim, keep only elements whose `field` equals `equals`. */
+    where: Typesafe.noExtraProps(Typesafe.object({
+      field: Typesafe.string,
+      equals: Typesafe.scalar
+    }))
+  })
+));
+const ClaimMappingVariable = Typesafe.noExtraProps(Typesafe.intersection(
+  Typesafe.object({
+    name: Typesafe.string
+  }),
+  Typesafe.partial({
+    /** Constant values, set regardless of any claim (the original static form). */
+    values: Typesafe.array(Typesafe.string),
+    /** Derive (additional) values from a claim. */
+    from: ClaimValueSource,
+    /** Lookup table applied to each raw value from `from`. A raw value with no entry is dropped unless `passthrough`. */
+    map: Typesafe.record(Typesafe.string, Typesafe.array(Typesafe.string)),
+    /** When `true`, a raw value from `from` not present in `map` is set verbatim. See the security note above. */
+    passthrough: Typesafe.boolean,
+    /** Allowlist applied to the values derived from `from` (constants in `values` are unaffected). */
+    allow: Typesafe.array(Typesafe.string)
+  })
+));
+const ClaimMappingMembership = Typesafe.noExtraProps(Typesafe.intersection(
+  Typesafe.object({
+    project: Typesafe.string,
+    role: Typesafe.string
+  }),
+  Typesafe.partial({
+    /**
+     * Membership variables to set. Each is constant (`values`, e.g. `[{ name: 'locale', values: ['cs'] }]`)
+     * and/or claim-derived (`from`, e.g. map a `languages` claim through a lookup table to locale ids).
+     */
+    variables: Typesafe.array(ClaimMappingVariable)
+  })
+));
+const ClaimMappingRule = Typesafe.noExtraProps(Typesafe.intersection(
+  Typesafe.object({
+    /** Claim/attribute from the IdP response to inspect: the exact name first, then as a dot-path into nested objects. */
+    claim: Typesafe.string
+  }),
+  Typesafe.partial({
+    /** Match when the claim equals this value (array claims: when it contains this element). */
+    equals: Typesafe.scalar,
+    /** Match when the claim contains this value (substring for strings, element for arrays). */
+    contains: Typesafe.scalar,
+    /** Project membership to grant when the rule matches. */
+    grantMembership: ClaimMappingMembership
+  })
+));
+const ClaimMapping = Typesafe.intersection(
+  Typesafe.object({
+    rules: Typesafe.array(ClaimMappingRule)
+  }),
+  Typesafe.partial({
+    /**
+     * When to apply the mapping:
+     * - `always` (default) — re-sync memberships on every sign-in (and on every OIDC session refresh).
+     * - `sticky`           — apply only when the account is first created by auto-sign-up; existing
+     *                        accounts (including one being linked to this IdP for the first time) are
+     *                        left untouched.
+     */
+    syncPolicy: Typesafe.enumeration("always", "sticky"),
+    /**
+     * How to treat existing grants the mapping does NOT (re)assign on this sign-in:
+     * - `keep`   (default, safer) — leave pre-existing memberships untouched.
+     * - `remove` — strip memberships that the mapping no longer grants (IdP becomes the source of
+     *              truth). Only ever touches grants the mapping itself could have made; memberships
+     *              outside the mapping's vocabulary are never removed.
+     */
+    unmatched: Typesafe.enumeration("keep", "remove")
+  })
+);
+const DEFAULT_SYNC_POLICY = "always";
+const DEFAULT_UNMATCHED = "keep";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const parseClaimMapping = (configuration) => {
+  const raw = configuration.claimMapping;
+  if (!isRecord(raw) || raw.rules === void 0 || raw.rules === null) {
+    return null;
+  }
+  const input = { rules: raw.rules };
+  if (raw.syncPolicy !== void 0) {
+    input.syncPolicy = raw.syncPolicy;
+  }
+  if (raw.unmatched !== void 0) {
+    input.unmatched = raw.unmatched;
+  }
+  return ClaimMapping(input, ["claimMapping"]);
+};
+const REMOVED_RULE_KEYS = ["grantRoles"];
+const findRemovedRuleKeys = (configuration) => {
+  const raw = configuration.claimMapping;
+  if (!isRecord(raw) || !Array.isArray(raw.rules)) {
+    return [];
+  }
+  const found = /* @__PURE__ */ new Set();
+  for (const rule of raw.rules) {
+    if (isRecord(rule)) {
+      for (const key of REMOVED_RULE_KEYS) {
+        if (key in rule) {
+          found.add(key);
+        }
+      }
+    }
+  }
+  return [...found];
+};
+const findClaimMappingShapeErrors = (mapping) => {
+  const errors = [];
+  for (const rule of mapping.rules) {
+    if (rule.grantMembership === void 0) {
+      errors.push(
+        `claimMapping rule for claim '${rule.claim}' has no 'grantMembership', so it matches but grants nothing; add a 'grantMembership'`
+      );
+    }
+    if (rule.equals !== void 0 && rule.contains !== void 0) {
+      errors.push(`claimMapping rule for claim '${rule.claim}' sets both 'equals' and 'contains'; a rule may use at most one`);
+    }
+    if (typeof rule.equals === "string" && rule.equals.trim() === "") {
+      errors.push(
+        `claimMapping rule for claim '${rule.claim}' has an empty 'equals' value; omit both 'equals' and 'contains' to match on the claim's mere presence, or set a non-empty value`
+      );
+    }
+    if (typeof rule.contains === "string" && rule.contains.trim() === "") {
+      errors.push(
+        `claimMapping rule for claim '${rule.claim}' has an empty 'contains' value, which would substring-match every string value of the claim (a match-everything grant); omit both 'equals' and 'contains' to match on the claim's mere presence, or set a non-empty value`
+      );
+    }
+    for (const variable of rule.grantMembership?.variables ?? []) {
+      if (variable.from?.where !== void 0 && variable.from.pick === void 0) {
+        errors.push(
+          `claimMapping variable '${variable.name}' uses 'from.where' without 'from.pick'; it can only ever resolve to no values — set 'pick' (the field to take from each matched element)`
+        );
+      }
+      if (variable.from?.split === "") {
+        errors.push(
+          `claimMapping variable '${variable.name}' has an empty 'from.split' delimiter, which splits every claim value into its individual characters; omit 'split' to keep the value whole, or set a non-empty delimiter`
+        );
+      }
+    }
+  }
+  return errors;
+};
+export {
+  ClaimMapping,
+  ClaimMappingMembership,
+  ClaimMappingRule,
+  ClaimMappingVariable,
+  ClaimValueSource,
+  DEFAULT_SYNC_POLICY,
+  DEFAULT_UNMATCHED,
+  findClaimMappingShapeErrors,
+  findRemovedRuleKeys,
+  isRecord,
+  parseClaimMapping
+};
+//# sourceMappingURL=ClaimMapping.js.map

package/dist/production/src/model/service/idp/ClaimMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaimMapping.js","sources":["../../../../../../../packages/engine-tenant-api/src/model/service/idp/ClaimMapping.ts"],"sourcesContent":["import * as Typesafe from '@contember/typesafe'\n\n/**\n * Provider-agnostic mapping of IdP claims/attributes to Contember project memberships (A09).\n * Stored on an IdP's `configuration.claimMapping`, so it rides inside the existing\n * `identity_provider.configuration` JSONB and needs no schema change — `addIDP` / `updateIDP`\n * already accept an opaque configuration object.\n *\n * The mapping grants **project memberships only** (a project role plus optional membership\n * variables). It deliberately does NOT grant global/tenant roles: those are privilege-bearing\n * and granting them from external claims would be a privilege-escalation path, so global-role\n * mapping was dropped. A project membership stays within what the IdP configurer\n * (`project_admin`, holding `IDP_ADD` / `IDP_UPDATE`) may already grant directly.\n *\n * Coexistence: the OIDC provider also uses `configuration.claimMapping` for an unrelated\n * identity-field remap (`email` / `name` / `externalIdentifier` / `attributesKey`). A09 only\n * looks at the `rules` field, so the two coexist in the same object — {@link parseClaimMapping}\n * returns `null` when no `rules` are present (an OIDC-only remap) instead of rejecting it.\n *\n * Each rule inspects one `claim` from the IdP response (the raw claims flow through verbatim,\n * since `IDPResponse` is `& Record<string, unknown>`) and, when it matches, grants a project\n * membership. Rules are independent and additive — every matching rule contributes; a\n * non-matching rule is simply skipped.\n *\n * Matching is declarative, never code:\n * - `equals`   — the claim equals the value (scalar compare; for array claims, the value is one\n *                of the elements).\n * - `contains` — the claim contains the value: substring for string claims, membership for array\n *                claims. This is the natural fit for multi-valued `groups`.\n * - neither    — the rule matches whenever the claim is merely present (and truthy for booleans).\n */\n/**\n * Where a membership variable's values come from when they are not constant. Reads one `claim` from the\n * IdP response — by exact name first (a URL-namespaced claim with literal dots works), then as a dot-path\n * (nested claims like `profile.languages`) — and shapes the raw value(s) into a flat list of strings:\n * - array claim       → its elements (`languages: ['cs','en']`)\n * - `split`           → split a delimited string claim (`'cs,en'`, OIDC-style `'cs en'`) into elements\n * - `pick` / `where`  → for an array-of-objects claim, keep elements matching `where` and take their\n *                       `pick` field (`orgs: [{ code, role }]` → codes of the elements where role matches)\n *\n * The extracted raw values are then run through {@link ClaimMappingVariable}'s `map` / `passthrough`.\n */\nexport const ClaimValueSource = Typesafe.noExtraProps(Typesafe.intersection(\n\tTypesafe.object({\n\t\t/** Claim to read: the exact name first (URL-namespaced names work), then as a dot-path (e.g. `profile.languages`). */\n\t\tclaim: Typesafe.string,\n\t}),\n\tTypesafe.partial({\n\t\t/** Split each string value on this delimiter (e.g. `,` or ` `): a scalar string claim and every string element of an array claim. A no-op for non-string values. */\n\t\tsplit: Typesafe.string,\n\t\t/** For an array-of-objects claim, take this (dot-path) field from each element. */\n\t\tpick: Typesafe.string,\n\t\t/** For an array-of-objects claim, keep only elements whose `field` equals `equals`. */\n\t\twhere: Typesafe.noExtraProps(Typesafe.object({\n\t\t\tfield: Typesafe.string,\n\t\t\tequals: Typesafe.scalar,\n\t\t})),\n\t}),\n))\n\nexport type ClaimValueSource = ReturnType<typeof ClaimValueSource>\n\n/**\n * One membership variable to set on a granted membership. Either constant (`values`), claim-derived\n * (`from`), or both — the two sets are unioned. When derived from a claim:\n * - `map`         — lookup table from a raw claim value to the value(s) actually set, e.g.\n *                   `{ cs: ['<locale-uuid>'] }`. A raw value absent from the map is dropped…\n * - `passthrough` — …unless `passthrough` is `true`, in which case it is set verbatim. Off by\n *                   default: raw external claim values then flow straight into row-level ACL\n *                   variables, so enable it only when the variable legitimately holds claim values\n *                   (not opaque ids), and prefer `map` / `allow` to bound what an IdP can inject.\n * - `allow`       — optional allowlist applied to the claim-derived values (constants are never filtered).\n */\nexport const ClaimMappingVariable = Typesafe.noExtraProps(Typesafe.intersection(\n\tTypesafe.object({\n\t\tname: Typesafe.string,\n\t}),\n\tTypesafe.partial({\n\t\t/** Constant values, set regardless of any claim (the original static form). */\n\t\tvalues: Typesafe.array(Typesafe.string),\n\t\t/** Derive (additional) values from a claim. */\n\t\tfrom: ClaimValueSource,\n\t\t/** Lookup table applied to each raw value from `from`. A raw value with no entry is dropped unless `passthrough`. */\n\t\tmap: Typesafe.record(Typesafe.string, Typesafe.array(Typesafe.string)),\n\t\t/** When `true`, a raw value from `from` not present in `map` is set verbatim. See the security note above. */\n\t\tpassthrough: Typesafe.boolean,\n\t\t/** Allowlist applied to the values derived from `from` (constants in `values` are unaffected). */\n\t\tallow: Typesafe.array(Typesafe.string),\n\t}),\n))\n\nexport type ClaimMappingVariable = ReturnType<typeof ClaimMappingVariable>\n\nexport const ClaimMappingMembership = Typesafe.noExtraProps(Typesafe.intersection(\n\tTypesafe.object({\n\t\tproject: Typesafe.string,\n\t\trole: Typesafe.string,\n\t}),\n\tTypesafe.partial({\n\t\t/**\n\t\t * Membership variables to set. Each is constant (`values`, e.g. `[{ name: 'locale', values: ['cs'] }]`)\n\t\t * and/or claim-derived (`from`, e.g. map a `languages` claim through a lookup table to locale ids).\n\t\t */\n\t\tvariables: Typesafe.array(ClaimMappingVariable),\n\t}),\n))\n\nexport type ClaimMappingMembership = ReturnType<typeof ClaimMappingMembership>\n\nexport const ClaimMappingRule = Typesafe.noExtraProps(Typesafe.intersection(\n\tTypesafe.object({\n\t\t/** Claim/attribute from the IdP response to inspect: the exact name first, then as a dot-path into nested objects. */\n\t\tclaim: Typesafe.string,\n\t}),\n\tTypesafe.partial({\n\t\t/** Match when the claim equals this value (array claims: when it contains this element). */\n\t\tequals: Typesafe.scalar,\n\t\t/** Match when the claim contains this value (substring for strings, element for arrays). */\n\t\tcontains: Typesafe.scalar,\n\t\t/** Project membership to grant when the rule matches. */\n\t\tgrantMembership: ClaimMappingMembership,\n\t}),\n))\n\nexport type ClaimMappingRule = ReturnType<typeof ClaimMappingRule>\n\n/**\n * The validated A09 mapping. `rules` is required here — {@link parseClaimMapping} only returns a\n * mapping once it has confirmed `rules` is present, and returns `null` otherwise (so an OIDC-only\n * `claimMapping` is treated as \"no role mapping\", not an error).\n */\nexport const ClaimMapping = Typesafe.intersection(\n\tTypesafe.object({\n\t\trules: Typesafe.array(ClaimMappingRule),\n\t}),\n\tTypesafe.partial({\n\t\t/**\n\t\t * When to apply the mapping:\n\t\t * - `always` (default) — re-sync memberships on every sign-in (and on every OIDC session refresh).\n\t\t * - `sticky`           — apply only when the account is first created by auto-sign-up; existing\n\t\t *                        accounts (including one being linked to this IdP for the first time) are\n\t\t *                        left untouched.\n\t\t */\n\t\tsyncPolicy: Typesafe.enumeration('always', 'sticky'),\n\t\t/**\n\t\t * How to treat existing grants the mapping does NOT (re)assign on this sign-in:\n\t\t * - `keep`   (default, safer) — leave pre-existing memberships untouched.\n\t\t * - `remove` — strip memberships that the mapping no longer grants (IdP becomes the source of\n\t\t *              truth). Only ever touches grants the mapping itself could have made; memberships\n\t\t *              outside the mapping's vocabulary are never removed.\n\t\t */\n\t\tunmatched: Typesafe.enumeration('keep', 'remove'),\n\t}),\n)\n\nexport type ClaimMapping = ReturnType<typeof ClaimMapping>\n\nexport const DEFAULT_SYNC_POLICY: NonNullable<ClaimMapping['syncPolicy']> = 'always'\nexport const DEFAULT_UNMATCHED: NonNullable<ClaimMapping['unmatched']> = 'keep'\n\nexport const isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * Parse the optional A09 `claimMapping` out of an IdP `configuration` blob. Returns `null` when no\n * A09 mapping is present — either no `claimMapping` at all, or a `claimMapping` that carries no\n * `rules` (e.g. the OIDC identity-field remap, which shares this key). Returning `null` keeps both\n * the pre-A09 sign-in path and the OIDC remap untouched.\n *\n * Only the A09 fields (`rules`, `syncPolicy`, `unmatched`) are validated; any other keys on the\n * `claimMapping` object (the OIDC remap fields) are ignored, so the two features coexist. Throws via\n * Typesafe when `rules` is present but structurally malformed (e.g. a rule missing its required\n * `claim`), so an A09 misconfiguration surfaces loudly rather than silently dropping grants.\n *\n * The nested A09 schemas (rule / membership / variable / value-source) are wrapped in\n * `Typesafe.noExtraProps`, so a typo'd key on any of them (e.g. `grantMembershp`, `equls`) is\n * REJECTED, not silently stripped — a misconfiguration surfaces loudly instead of degrading into a\n * grants-nothing or match-everyone rule. The one exception is the top-level `claimMapping` object\n * itself: it is the key SHARED with the OIDC identity-remap (`email`/`name`/`externalIdentifier`/\n * `attributesKey`), so this parse first projects only the A09 fields (`rules`/`syncPolicy`/`unmatched`)\n * into a fresh object (above) and deliberately does NOT apply `noExtraProps` there — the OIDC remap\n * fields must coexist. The `map` lookup table is likewise a `record` (arbitrary keys are legitimate),\n * not a strict object. The removed `grantRoles` key is still caught separately by\n * {@link findRemovedRuleKeys} (run before this parse) for a clearer message than the generic\n * extra-property error `noExtraProps` would otherwise raise.\n */\nexport const parseClaimMapping = (configuration: Record<string, unknown>): ClaimMapping | null => {\n\tconst raw = configuration.claimMapping\n\tif (!isRecord(raw) || raw.rules === undefined || raw.rules === null) {\n\t\treturn null\n\t}\n\tconst input: Record<string, unknown> = { rules: raw.rules }\n\tif (raw.syncPolicy !== undefined) {\n\t\tinput.syncPolicy = raw.syncPolicy\n\t}\n\tif (raw.unmatched !== undefined) {\n\t\tinput.unmatched = raw.unmatched\n\t}\n\treturn ClaimMapping(input, ['claimMapping'])\n}\n\n/**\n * The set of A09 rule keys that were removed when global-role mapping was dropped. Detected\n * explicitly (rather than relying on Typesafe's generic \"extra property\" rejection) so a config\n * that still tries to grant global roles gets an actionable error.\n */\nconst REMOVED_RULE_KEYS = ['grantRoles'] as const\n\n/**\n * Returns the removed rule keys (currently only `grantRoles`) still present in a raw `claimMapping`,\n * so config-time validation can reject them with a clear message pointing at `grantMembership`.\n */\nexport const findRemovedRuleKeys = (configuration: Record<string, unknown>): string[] => {\n\tconst raw = configuration.claimMapping\n\tif (!isRecord(raw) || !Array.isArray(raw.rules)) {\n\t\treturn []\n\t}\n\tconst found = new Set<string>()\n\tfor (const rule of raw.rules) {\n\t\tif (isRecord(rule)) {\n\t\t\tfor (const key of REMOVED_RULE_KEYS) {\n\t\t\t\tif (key in rule) {\n\t\t\t\t\tfound.add(key)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\treturn [...found]\n}\n\n/**\n * Semantic checks on a parsed mapping that the Typesafe shape cannot express. Returns one\n * human-readable message per problem (empty = ok); run at config time (IdP add/update) so a\n * contradictory rule is rejected loudly rather than silently mis-matching or granting nothing:\n * - a rule may use at most one of `equals` / `contains` ({@link ruleMatches} only ever honours `equals`\n *   when both are set, so the other would be silently ignored);\n * - a rule's `equals` / `contains` must not be an empty string: an empty `contains` substring-matches EVERY\n *   string claim (`'...'.includes('')` is always true), i.e. a match-everything grant to every user of the\n *   IdP, and an empty `equals` is an always-no-op footgun — to match on the claim's mere presence, omit both;\n * - a rule must carry a `grantMembership` — a rule with none matches but grants nothing. (A *misspelled*\n *   `grantMembership`, e.g. `grantMembershp`, is now rejected earlier by `noExtraProps` during\n *   {@link parseClaimMapping}; this check remains for a `grantMembership` that is genuinely OMITTED,\n *   which the `partial` schema permits.)\n * - a variable's `from.where` requires a `from.pick` — `where` filters elements but without `pick` there\n *   is nothing to project, so the source can only ever resolve to no values;\n * - a variable's `from.split` must not be the empty string — `''.split('')` explodes every claim value\n *   into its individual characters (the same class of footgun as an empty `equals` / `contains`).\n */\nexport const findClaimMappingShapeErrors = (mapping: ClaimMapping): string[] => {\n\tconst errors: string[] = []\n\tfor (const rule of mapping.rules) {\n\t\tif (rule.grantMembership === undefined) {\n\t\t\terrors.push(\n\t\t\t\t`claimMapping rule for claim '${rule.claim}' has no 'grantMembership', so it matches but grants nothing; add a 'grantMembership'`,\n\t\t\t)\n\t\t}\n\t\tif (rule.equals !== undefined && rule.contains !== undefined) {\n\t\t\terrors.push(`claimMapping rule for claim '${rule.claim}' sets both 'equals' and 'contains'; a rule may use at most one`)\n\t\t}\n\t\tif (typeof rule.equals === 'string' && rule.equals.trim() === '') {\n\t\t\terrors.push(\n\t\t\t\t`claimMapping rule for claim '${rule.claim}' has an empty 'equals' value; omit both 'equals' and 'contains' to match on the claim's mere presence, or set a non-empty value`,\n\t\t\t)\n\t\t}\n\t\tif (typeof rule.contains === 'string' && rule.contains.trim() === '') {\n\t\t\terrors.push(\n\t\t\t\t`claimMapping rule for claim '${rule.claim}' has an empty 'contains' value, which would substring-match every string value of the claim (a match-everything grant); omit both 'equals' and 'contains' to match on the claim's mere presence, or set a non-empty value`,\n\t\t\t)\n\t\t}\n\t\tfor (const variable of rule.grantMembership?.variables ?? []) {\n\t\t\tif (variable.from?.where !== undefined && variable.from.pick === undefined) {\n\t\t\t\terrors.push(\n\t\t\t\t\t`claimMapping variable '${variable.name}' uses 'from.where' without 'from.pick'; it can only ever resolve to no values — set 'pick' (the field to take from each matched element)`,\n\t\t\t\t)\n\t\t\t}\n\t\t\tif (variable.from?.split === '') {\n\t\t\t\terrors.push(\n\t\t\t\t\t`claimMapping variable '${variable.name}' has an empty 'from.split' delimiter, which splits every claim value into its individual characters; omit 'split' to keep the value whole, or set a non-empty delimiter`,\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t}\n\treturn errors\n}\n"],"names":[],"mappings":"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"}