Reorganize repo structure and standards references

This commit is contained in:
david committed 2026-06-29 05:03:42 +02:00
1 parent 3cb93a81be
commit be2054274d
5885 files changed
+2588 -195

No files matched your search

@@ -0,0 +1,104 @@
import { evaluateEntitlement, type EntitlementDecision, type EntitlementLimitType } from "./evaluate.js";
import { type FeatureKey } from "./features.js";
import { getProductBlueprint, type ProductBlueprintId } from "./blueprints.js";
export type TenantFeatureOverride = "enabled" | "disabled" | "inherit";
export interface ProductAccessInput {
readonly blueprintId: ProductBlueprintId | string;
readonly featureKey: FeatureKey | string;
readonly hasSubscription: boolean;
readonly limitType?: EntitlementLimitType;
readonly limit?: number | null;
readonly used?: number | null;
readonly tenantOverride?: TenantFeatureOverride;
readonly tenantRolePermissionNames?: readonly string[];
readonly period?: string;
}
export type ProductAccessDecisionReason =
| EntitlementDecision["reason"]
| "blueprint-disabled"
| "tenant-override-disabled"
| "tenant-override-not-toggleable"
| "tenant-role-missing";
export interface ProductAccessDecision extends Omit<EntitlementDecision, "reason"> {
readonly reason: ProductAccessDecisionReason;
readonly blueprintId: string;
readonly tenantOverride: TenantFeatureOverride;
readonly requiredTenantRolePermission?: string;
}
export function evaluateProductAccess(input: ProductAccessInput): ProductAccessDecision {
const blueprint = getProductBlueprint(input.blueprintId);
const blueprintFeature = blueprint?.features.find((feature) => feature.featureKey === input.featureKey);
const tenantOverride = input.tenantOverride ?? "inherit";
const base = {
blueprintId: input.blueprintId,
featureKey: input.featureKey,
tenantOverride,
};
if (!blueprint || !blueprintFeature?.defaultEnabled) {
return {
...base,
allowed: false,
reason: "blueprint-disabled",
period: input.period,
};
}
if (tenantOverride === "disabled") {
return {
...base,
allowed: false,
reason: "tenant-override-disabled",
period: input.period,
};
}
if (tenantOverride === "enabled" && !blueprintFeature.tenantToggleable) {
return {
...base,
allowed: false,
reason: "tenant-override-not-toggleable",
period: input.period,
};
}
const entitlement = evaluateEntitlement({
featureKey: input.featureKey,
hasSubscription: input.hasSubscription,
limitType: input.limitType,
limit: input.limit,
used: input.used,
period: input.period,
});
if (!entitlement.allowed && tenantOverride !== "enabled") {
return { ...entitlement, blueprintId: input.blueprintId, tenantOverride };
}
const requiredPermission = blueprintFeature.requiresTenantRolePermission;
const hasRolePermission = !requiredPermission || input.tenantRolePermissionNames?.includes(requiredPermission);
if (!hasRolePermission) {
return {
...entitlement,
blueprintId: input.blueprintId,
tenantOverride,
allowed: false,
reason: "tenant-role-missing",
requiredTenantRolePermission: requiredPermission,
};
}
return {
...entitlement,
blueprintId: input.blueprintId,
tenantOverride,
allowed: true,
reason: tenantOverride === "enabled" && !entitlement.allowed ? "included" : entitlement.reason,
requiredTenantRolePermission: requiredPermission,
};
}