@things-factory/auth-base 10.1.79 → 10.1.107

package/dist-server/controllers/access-request.js

@@ -0,0 +1,373 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACCESS_REQUEST_DENIAL_DAYS = exports.AccessDecisionRefused = void 0;
+exports.requestAccess = requestAccess;
+exports.latestDenial = latestDenial;
+exports.withdrawAccessRequest = withdrawAccessRequest;
+exports.findDeciderIds = findDeciderIds;
+exports.rolesGranting = rolesGranting;
+exports.collectDecisionFacts = collectDecisionFacts;
+exports.reviewDecision = reviewDecision;
+exports.decideAccessRequest = decideAccessRequest;
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const access_request_js_1 = require("../service/access-request/access-request.js");
+const privilege_js_1 = require("../service/privilege/privilege.js");
+const role_js_1 = require("../service/role/role.js");
+const user_js_1 = require("../service/user/user.js");
+const access_request_review_js_1 = require("../utils/access-request-review.js");
+const assignable_roles_js_1 = require("../utils/assignable-roles.js");
+const check_permission_js_1 = require("../utils/check-permission.js");
+const domain_ownership_js_1 = require("../utils/domain-ownership.js");
+/** Refuses a decision whose review blocks it - the first blocking issue names the refusal, all codes go along. */
+class AccessDecisionRefused extends shell_1.Refusal {
+    constructor(issues) {
+        const first = issues.find(issue => issue.blocking);
+        super(`access-decision-${first.code}`, { codes: issues.filter(i => i.blocking).map(i => i.code).join(',') }, `The decision cannot be made: ${first.code}.`);
+        this.issues = issues;
+    }
+}
+exports.AccessDecisionRefused = AccessDecisionRefused;
+/* ── asking ──────────────────────────────────────────────────────────────── */
+/**
+ * The caller asks for `category:privilege` in this domain.
+ *
+ * The server judges again whether a role would open it - the `because` a screen got with its refusal is not
+ * taken on trust (ADR-0103 decision 2). Asking again while one is pending adds to that one.
+ */
+async function requestAccess(input, context) {
+    const { domain, user, tx, unsafeIP, prohibitedPrivileges } = context.state;
+    const { category, privilege } = input;
+    const now = new Date();
+    if (!category || !privilege) {
+        throw new shell_1.Refusal('access-request-names-nothing', {}, 'An access request names a category and a privilege.');
+    }
+    const known = await (0, shell_1.getRepository)(privilege_js_1.Privilege, tx).findOneBy({ category, name: privilege });
+    if (!known) {
+        throw new shell_1.Refusal('access-request-unknown-privilege', { privilege: `${category}:${privilege}` }, `There is no privilege ${category}:${privilege}.`);
+    }
+    /* Asking is not a reflex - the reason is what the person deciding weighs, so there is no request without one. */
+    const reason = input.reason?.trim();
+    if (!reason) {
+        throw new shell_1.Refusal('access-request-needs-reason', {}, 'Write why you need it.');
+    }
+    const judgement = await (0, check_permission_js_1.judgePermission)({ category, privilege }, user, domain, unsafeIP, prohibitedPrivileges);
+    if (judgement.permitted === true) {
+        throw new shell_1.Refusal('access-request-already-holds', { privilege: `${category}:${privilege}` }, `You already have ${category}:${privilege}.`);
+    }
+    if (judgement.because !== 'role') {
+        throw new shell_1.Refusal('access-request-not-by-role', { privilege: `${category}:${privilege}`, because: judgement.because }, `A role would not open ${category}:${privilege} here (${judgement.because}).`);
+    }
+    await holdRequester(user.id, tx);
+    /*
+     * Denied lately: asking again is allowed, the same words are not - the person deciding has already answered them.
+     * The screen shows that answer before the person writes (ACCESS_REQUEST_DENIAL_DAYS).
+     */
+    const denied = await latestDenial(domain, user.id, category, privilege, now, tx);
+    if (denied && (denied.reason || '').trim() === reason) {
+        throw new shell_1.Refusal('access-request-same-reason-as-denied', { reason: denied.decisionReason || '' }, 'This was denied for the same reason lately - write what has changed.');
+    }
+    const repository = (0, shell_1.getRepository)(access_request_js_1.AccessRequest, tx);
+    const pending = await repository.findOne({
+        where: {
+            domain: { id: domain.id },
+            requester: { id: user.id },
+            category,
+            privilege,
+            state: access_request_js_1.AccessRequestStatus.PENDING
+        },
+        relations: ['domain', 'requester']
+    });
+    if (pending && (0, access_request_review_js_1.effectiveState)(pending.state, pending.expiresAt, now) === access_request_js_1.AccessRequestStatus.PENDING) {
+        pending.count = (pending.count || 1) + 1;
+        pending.lastRequestedAt = now;
+        pending.reason = reason;
+        if (input.operationName)
+            pending.operationName = input.operationName;
+        /* Merged - the people deciding were told once, when it was first asked. */
+        return await repository.save(pending);
+    }
+    if (pending) {
+        pending.state = access_request_js_1.AccessRequestStatus.EXPIRED;
+        await repository.save(pending);
+    }
+    const created = await repository.save({
+        domain,
+        requester: user,
+        category,
+        privilege,
+        operationName: input.operationName,
+        reason,
+        count: 1,
+        lastRequestedAt: now,
+        state: access_request_js_1.AccessRequestStatus.PENDING,
+        expiresAt: (0, access_request_review_js_1.expiryFrom)(now)
+    });
+    const deciders = await findDeciderIds(domain, user.id, tx);
+    tellLater(context, 'notify the people who decide access requests', async () => notifyEach(context, deciders, 'access-request.notify.asked', {
+        name: user.name || user.email || user.username,
+        privilege: `${category}:${privilege}`
+    }, `access-requests?id=${created.id}`));
+    return created;
+}
+/**
+ * At most one pending request per person and privilege, under concurrency. A partial unique index would say it and
+ * is not portable, so the person's own row is locked for the rest of the transaction: a second ask of the same
+ * moment waits, then finds the first and adds to it (measured on postgres - access-request-pg.test.ts).
+ *
+ * sqlite has no row locks and one connection, so its transactions already run one after another.
+ */
+async function holdRequester(userId, tx) {
+    if (!tx || tx.connection?.options?.type?.includes('sqlite'))
+        return;
+    await tx.getRepository(user_js_1.User).createQueryBuilder('HELD').setLock('pessimistic_write').where('HELD.id = :id', { id: userId }).getOne();
+}
+/** How long a denial is shown back to the person and holds against the same words (questions Q9 · 5). */
+exports.ACCESS_REQUEST_DENIAL_DAYS = 7;
+/** The latest denial of this person and privilege within ACCESS_REQUEST_DENIAL_DAYS, if any. */
+async function latestDenial(domain, requesterId, category, privilege, now, tx) {
+    const denied = await (0, shell_1.getRepository)(access_request_js_1.AccessRequest, tx).findOne({
+        where: { domain: { id: domain.id }, requester: { id: requesterId }, category, privilege, state: access_request_js_1.AccessRequestStatus.DENIED },
+        order: { decidedAt: 'DESC' }
+    });
+    if (!denied?.decidedAt)
+        return null;
+    return now.getTime() - new Date(denied.decidedAt).getTime() <= exports.ACCESS_REQUEST_DENIAL_DAYS * 24 * 60 * 60 * 1000 ? denied : null;
+}
+/** The requester takes back their own pending request. */
+async function withdrawAccessRequest(id, context) {
+    const { domain, user, tx } = context.state;
+    const repository = (0, shell_1.getRepository)(access_request_js_1.AccessRequest, tx);
+    const updated = await repository
+        .createQueryBuilder()
+        .update(access_request_js_1.AccessRequest)
+        .set({ state: access_request_js_1.AccessRequestStatus.WITHDRAWN })
+        .where('id = :id AND domain_id = :domainId AND requester_id = :userId AND state = :pending', {
+        id,
+        domainId: domain.id,
+        userId: user.id,
+        pending: access_request_js_1.AccessRequestStatus.PENDING
+    })
+        .execute();
+    if (!updated.affected) {
+        throw new shell_1.Refusal('access-request-not-withdrawable', { id }, 'There is no pending request of yours to withdraw.');
+    }
+    return await repository.findOne({ where: { id }, relations: ['domain', 'requester'] });
+}
+/* ── who decides ─────────────────────────────────────────────────────────── */
+/**
+ * The people who can decide: domain owners and holders of the role-granting privilege - the same pair the
+ * decision door declares (`@privilege(category: "user", privilege: "mutation", domainOwnerGranted: true)`).
+ * The requester is never one of them.
+ */
+async function findDeciderIds(domain, requesterId, tx) {
+    const owners = await (0, domain_ownership_js_1.findDomainOwnerUserIds)(domain, tx);
+    const qb = (0, shell_1.getRepository)(user_js_1.User, tx)
+        .createQueryBuilder('USER')
+        .select('USER.id', 'id')
+        .innerJoin('USER.domains', 'MEMBER', 'MEMBER.id = :memberOf', { memberOf: domain.id })
+        .innerJoin('USER.roles', 'role')
+        .innerJoin('role.privileges', 'PRIVILEGE')
+        .where('PRIVILEGE.category = :grantCategory', { grantCategory: access_request_review_js_1.ROLE_GRANTING_PRIVILEGE.category })
+        .andWhere('PRIVILEGE.name = :grantName', { grantName: access_request_review_js_1.ROLE_GRANTING_PRIVILEGE.privilege })
+        .andWhere('USER.status = :active', { active: user_js_1.UserStatus.ACTIVATED });
+    (0, shell_1.applyDomainInheritanceFilter)(qb, 'role', domain, shell_1.InheritedValueType.Include);
+    const holders = (await qb.getRawMany()).map(row => row.id);
+    return [...new Set([...owners, ...holders])].filter(id => id && id !== requesterId).sort();
+}
+/* ── reviewing ───────────────────────────────────────────────────────────── */
+/** Every assignable role that grants `category:privilege`, smallest first. */
+async function rolesGranting(category, privilege, domain, tx) {
+    const qb = (0, shell_1.getRepository)(role_js_1.Role, tx)
+        .createQueryBuilder('ROLE')
+        .innerJoin('ROLE.privileges', 'ASKED', 'ASKED.category = :askedCategory AND ASKED.name = :askedName', {
+        askedCategory: category,
+        askedName: privilege
+    });
+    const roles = await (0, assignable_roles_js_1.whereAssignableBy)(qb, 'ROLE', domain).getMany();
+    if (roles.length === 0)
+        return [];
+    const withPrivileges = await (0, shell_1.getRepository)(role_js_1.Role, tx).find({ where: { id: (0, typeorm_1.In)(roles.map(role => role.id)) }, relations: ['privileges'] });
+    return withPrivileges
+        .map(role => ({ id: role.id, name: role.name, privilegeCount: role.privileges?.length ?? 0, role }))
+        .sort((a, b) => a.privilegeCount - b.privilegeCount || a.name.localeCompare(b.name));
+}
+/** The facts `reviewAccessDecision` reads - collected as the person deciding, inside this domain. */
+async function collectDecisionFacts(input, context) {
+    const { domain, user: decider, tx } = context.state;
+    const now = new Date();
+    const request = await (0, shell_1.getRepository)(access_request_js_1.AccessRequest, tx).findOne({
+        where: { id: input.requestId, domain: { id: domain.id } },
+        relations: ['requester', 'requester.domains']
+    });
+    const base = {
+        request: null,
+        deciderId: decider.id,
+        decision: input.decision,
+        reason: input.reason,
+        requester: null,
+        requesterHoldsIt: false,
+        candidates: [],
+        deciderPrivileges: [],
+        deciderIsOwner: false,
+        now
+    };
+    if (!request)
+        return base;
+    const requester = request.requester;
+    const [candidates, chosen, deciderIsOwner, deciderPrivileges, requesterHoldsIt, deniedBefore] = await Promise.all([
+        rolesGranting(request.category, request.privilege, domain, tx),
+        input.roleId ? (0, assignable_roles_js_1.findAssignableRoles)([input.roleId], domain, tx) : Promise.resolve([]),
+        (0, domain_ownership_js_1.isDomainOwner)(domain, decider, tx),
+        user_js_1.User.getPrivilegesByDomain(decider, domain),
+        requester ? user_js_1.User.hasPrivilege(request.privilege, request.category, domain, requester) : Promise.resolve(false),
+        (0, shell_1.getRepository)(access_request_js_1.AccessRequest, tx).findOne({
+            where: {
+                domain: { id: domain.id },
+                requester: { id: requester?.id },
+                category: request.category,
+                privilege: request.privilege,
+                state: access_request_js_1.AccessRequestStatus.DENIED
+            },
+            relations: ['decidedBy'],
+            order: { decidedAt: 'DESC' }
+        })
+    ]);
+    const role = chosen[0]
+        ? await (0, shell_1.getRepository)(role_js_1.Role, tx).findOne({ where: { id: chosen[0].id }, relations: ['privileges'] })
+        : null;
+    return {
+        ...base,
+        request: {
+            state: request.state,
+            requesterId: requester?.id,
+            category: request.category,
+            privilege: request.privilege,
+            expiresAt: request.expiresAt
+        },
+        role: role
+            ? { id: role.id, name: role.name, privileges: (role.privileges || []).map(p => ({ category: p.category, privilege: p.name })) }
+            : null,
+        roleNamedButNotAssignable: !!input.roleId && !role,
+        requester: requester
+            ? {
+                active: requester.status === user_js_1.UserStatus.ACTIVATED,
+                inDomain: (requester.domains || []).some(d => d.id === domain.id)
+            }
+            : null,
+        requesterHoldsIt,
+        candidates: candidates.map(({ id, name, privilegeCount }) => ({ id, name, privilegeCount })),
+        deciderIsOwner,
+        deciderPrivileges: (deciderPrivileges || []).map((p) => ({ category: p.category, privilege: p.privilege })),
+        deniedBefore: deniedBefore && deniedBefore.id !== request.id
+            ? {
+                by: deniedBefore.decidedBy?.name || deniedBefore.decidedBy?.email || '',
+                at: deniedBefore.decidedAt,
+                reason: deniedBefore.decisionReason
+            }
+            : null
+    };
+}
+async function reviewDecision(input, context) {
+    return (0, access_request_review_js_1.reviewAccessDecision)(await collectDecisionFacts(input, context));
+}
+/* ── deciding ────────────────────────────────────────────────────────────── */
+/**
+ * Grants or denies. The review runs again here - the card and the screen were shown a moment ago, and another
+ * person may have decided since. The state moves PENDING → decided in one conditional update, so two people
+ * deciding at once cannot both win.
+ */
+async function decideAccessRequest(input, context) {
+    const { domain, user: decider, tx } = context.state;
+    const now = new Date();
+    const issues = await reviewDecision(input, context);
+    if ((0, access_request_review_js_1.isBlocked)(issues)) {
+        throw new AccessDecisionRefused(issues);
+    }
+    const repository = (0, shell_1.getRepository)(access_request_js_1.AccessRequest, tx);
+    const granting = input.decision === 'GRANT';
+    const moved = await repository
+        .createQueryBuilder()
+        .update(access_request_js_1.AccessRequest)
+        .set({
+        state: granting ? access_request_js_1.AccessRequestStatus.GRANTED : access_request_js_1.AccessRequestStatus.DENIED,
+        decidedBy: { id: decider.id },
+        decidedAt: now,
+        decisionReason: input.reason?.trim() || null,
+        grantedRole: granting ? { id: input.roleId } : null
+    })
+        .where('id = :id AND domain_id = :domainId AND state = :pending', {
+        id: input.requestId,
+        domainId: domain.id,
+        pending: access_request_js_1.AccessRequestStatus.PENDING
+    })
+        .execute();
+    if (!moved.affected) {
+        throw new AccessDecisionRefused([{ code: 'request-not-pending', blocking: true, field: 'request' }]);
+    }
+    const request = await repository.findOne({ where: { id: input.requestId }, relations: ['requester', 'requester.roles', 'grantedRole'] });
+    const requester = request.requester;
+    if (granting) {
+        await (0, assignable_roles_js_1.assignRoles)(requester, { add: [input.roleId] }, domain, tx);
+        await closeWhatTheGrantOpened(request, context);
+    }
+    tellLater(context, 'notify the requester of the decision', async () => notifyEach(context, [requester.id], granting ? 'access-request.notify.granted' : 'access-request.notify.denied', { privilege: `${request.category}:${request.privilege}`, role: request.grantedRole?.name ?? '', reason: request.decisionReason ?? '' }, 
+    /* The requester cannot read the list of everyone's requests - their own is where the answer is. */
+    'my-access-requests'));
+    return request;
+}
+/** Other pending requests of the same person that the role just given now answers - closed as granted with it. */
+async function closeWhatTheGrantOpened(granted, context) {
+    const { domain, user: decider, tx } = context.state;
+    const repository = (0, shell_1.getRepository)(access_request_js_1.AccessRequest, tx);
+    const others = await repository.find({
+        where: { domain: { id: domain.id }, requester: { id: granted.requester.id }, state: access_request_js_1.AccessRequestStatus.PENDING },
+        relations: ['requester']
+    });
+    for (const other of others) {
+        if (!(await user_js_1.User.hasPrivilege(other.privilege, other.category, domain, granted.requester)))
+            continue;
+        await repository.update({ id: other.id, state: access_request_js_1.AccessRequestStatus.PENDING }, { state: access_request_js_1.AccessRequestStatus.GRANTED, decidedBy: { id: decider.id }, decidedAt: new Date(), grantedRole: granted.grantedRole });
+    }
+}
+/* ── telling ─────────────────────────────────────────────────────────────── */
+/** After the commit when there is a transaction, at once otherwise - a failed notification never fails the decision. */
+function tellLater(context, name, run) {
+    const deferred = (0, shell_1.whenCommitted)(context.state.afterCommit, name, run);
+    if (!deferred)
+        void run().catch(() => { });
+}
+/**
+ * One notification per person, in that person's language (`User.locale`), linking to where they can act on it. `notify` is optional: it is there when
+ * the notification module is loaded, and nothing happens otherwise - the request list is the record.
+ */
+async function notifyEach(context, userIds, key, params, url) {
+    const notify = context.state.notify;
+    if (typeof notify !== 'function' || userIds.length === 0)
+        return;
+    const people = await (0, shell_1.getRepository)(user_js_1.User).find({ where: { id: (0, typeorm_1.In)(userIds) } });
+    const byLocale = new Map();
+    for (const person of people) {
+        const locale = person.locale || '';
+        byLocale.set(locale, [...(byLocale.get(locale) || []), person.id]);
+    }
+    for (const [locale, receivers] of byLocale) {
+        const say = (suffix) => translate(context, `${key}.${suffix}`, params, locale);
+        await notify({
+            receivers,
+            type: 'info',
+            subject: 'access-request',
+            title: say('title'),
+            body: say('body'),
+            url,
+            mode: 'background'
+        });
+    }
+}
+function translate(context, key, params, locale) {
+    const i18next = context?.i18next;
+    if (locale && i18next?.t)
+        return i18next.t(key, { ...params, lng: locale });
+    return typeof context?.t === 'function' ? context.t(key, { ...params }) : key;
+}
+//# sourceMappingURL=access-request.js.map

package/dist-server/controllers/access-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-request.js","sourceRoot":"","sources":["../../server/controllers/access-request.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, In } from 'typeorm'\n\nimport { applyDomainInheritanceFilter, Domain, getRepository, InheritedValueType, Refusal, whenCommitted } from '@things-factory/shell'\n\nimport { AccessRequest, AccessRequestStatus } from '../service/access-request/access-request.js'\nimport { Privilege } from '../service/privilege/privilege.js'\nimport { Role } from '../service/role/role.js'\nimport { User, UserStatus } from '../service/user/user.js'\nimport {\n  AccessDecisionKind,\n  DecisionFacts,\n  DecisionIssue,\n  effectiveState,\n  expiryFrom,\n  isBlocked,\n  reviewAccessDecision,\n  ROLE_GRANTING_PRIVILEGE\n} from '../utils/access-request-review.js'\nimport { assignRoles, findAssignableRoles, whereAssignableBy } from '../utils/assignable-roles.js'\nimport { judgePermission } from '../utils/check-permission.js'\nimport { findDomainOwnerUserIds, isDomainOwner } from '../utils/domain-ownership.js'\n\n/*\n * Access requests - asking, withdrawing, reviewing and deciding (ADR-0103, docs/design/access-request.md).\n *\n * Every door reads the domain and the person from the request, never from an argument.\n */\n\nexport type NewAccessRequestInput = { category: string; privilege: string; operationName?: string; reason?: string }\nexport type AccessDecisionInput = { requestId: string; decision: AccessDecisionKind; roleId?: string; reason?: string }\n\n/** Refuses a decision whose review blocks it - the first blocking issue names the refusal, all codes go along. */\nexport class AccessDecisionRefused extends Refusal {\n  constructor(readonly issues: DecisionIssue[]) {\n    const first = issues.find(issue => issue.blocking)\n    super(`access-decision-${first.code}`, { codes: issues.filter(i => i.blocking).map(i => i.code).join(',') }, `The decision cannot be made: ${first.code}.`)\n  }\n}\n\n/* ── asking ──────────────────────────────────────────────────────────────── */\n\n/**\n * The caller asks for `category:privilege` in this domain.\n *\n * The server judges again whether a role would open it - the `because` a screen got with its refusal is not\n * taken on trust (ADR-0103 decision 2). Asking again while one is pending adds to that one.\n */\nexport async function requestAccess(input: NewAccessRequestInput, context: ResolverContext): Promise<AccessRequest> {\n  const { domain, user, tx, unsafeIP, prohibitedPrivileges } = context.state\n  const { category, privilege } = input\n  const now = new Date()\n\n  if (!category || !privilege) {\n    throw new Refusal('access-request-names-nothing', {}, 'An access request names a category and a privilege.')\n  }\n\n  const known = await getRepository(Privilege, tx).findOneBy({ category, name: privilege })\n  if (!known) {\n    throw new Refusal('access-request-unknown-privilege', { privilege: `${category}:${privilege}` }, `There is no privilege ${category}:${privilege}.`)\n  }\n\n  /* Asking is not a reflex - the reason is what the person deciding weighs, so there is no request without one. */\n  const reason = input.reason?.trim()\n  if (!reason) {\n    throw new Refusal('access-request-needs-reason', {}, 'Write why you need it.')\n  }\n\n  const judgement = await judgePermission({ category, privilege }, user, domain, unsafeIP, prohibitedPrivileges)\n  if (judgement.permitted === true) {\n    throw new Refusal('access-request-already-holds', { privilege: `${category}:${privilege}` }, `You already have ${category}:${privilege}.`)\n  }\n  if (judgement.because !== 'role') {\n    throw new Refusal(\n      'access-request-not-by-role',\n      { privilege: `${category}:${privilege}`, because: judgement.because },\n      `A role would not open ${category}:${privilege} here (${judgement.because}).`\n    )\n  }\n\n  await holdRequester(user.id, tx)\n\n  /*\n   * Denied lately: asking again is allowed, the same words are not - the person deciding has already answered them.\n   * The screen shows that answer before the person writes (ACCESS_REQUEST_DENIAL_DAYS).\n   */\n  const denied = await latestDenial(domain, user.id, category, privilege, now, tx)\n  if (denied && (denied.reason || '').trim() === reason) {\n    throw new Refusal(\n      'access-request-same-reason-as-denied',\n      { reason: denied.decisionReason || '' },\n      'This was denied for the same reason lately - write what has changed.'\n    )\n  }\n\n  const repository = getRepository(AccessRequest, tx)\n  const pending = await repository.findOne({\n    where: {\n      domain: { id: domain.id },\n      requester: { id: user.id },\n      category,\n      privilege,\n      state: AccessRequestStatus.PENDING\n    },\n    relations: ['domain', 'requester']\n  })\n\n  if (pending && effectiveState(pending.state, pending.expiresAt, now) === AccessRequestStatus.PENDING) {\n    pending.count = (pending.count || 1) + 1\n    pending.lastRequestedAt = now\n    pending.reason = reason\n    if (input.operationName) pending.operationName = input.operationName\n    /* Merged - the people deciding were told once, when it was first asked. */\n    return await repository.save(pending)\n  }\n\n  if (pending) {\n    pending.state = AccessRequestStatus.EXPIRED\n    await repository.save(pending)\n  }\n\n  const created = await repository.save({\n    domain,\n    requester: user,\n    category,\n    privilege,\n    operationName: input.operationName,\n    reason,\n    count: 1,\n    lastRequestedAt: now,\n    state: AccessRequestStatus.PENDING,\n    expiresAt: expiryFrom(now)\n  } as Partial<AccessRequest>)\n\n  const deciders = await findDeciderIds(domain, user.id, tx)\n  tellLater(context, 'notify the people who decide access requests', async () =>\n    notifyEach(context, deciders, 'access-request.notify.asked', {\n      name: user.name || user.email || user.username,\n      privilege: `${category}:${privilege}`\n    }, `access-requests?id=${created.id}`)\n  )\n\n  return created\n}\n\n/**\n * At most one pending request per person and privilege, under concurrency. A partial unique index would say it and\n * is not portable, so the person's own row is locked for the rest of the transaction: a second ask of the same\n * moment waits, then finds the first and adds to it (measured on postgres - access-request-pg.test.ts).\n *\n * sqlite has no row locks and one connection, so its transactions already run one after another.\n */\nasync function holdRequester(userId: string, tx?: EntityManager) {\n  if (!tx || (tx.connection?.options?.type as string)?.includes('sqlite')) return\n  await tx.getRepository(User).createQueryBuilder('HELD').setLock('pessimistic_write').where('HELD.id = :id', { id: userId }).getOne()\n}\n\n/** How long a denial is shown back to the person and holds against the same words (questions Q9 · 5). */\nexport const ACCESS_REQUEST_DENIAL_DAYS = 7\n\n/** The latest denial of this person and privilege within ACCESS_REQUEST_DENIAL_DAYS, if any. */\nexport async function latestDenial(domain: Domain, requesterId: string, category: string, privilege: string, now: Date, tx?: EntityManager) {\n  const denied = await getRepository(AccessRequest, tx).findOne({\n    where: { domain: { id: domain.id }, requester: { id: requesterId }, category, privilege, state: AccessRequestStatus.DENIED },\n    order: { decidedAt: 'DESC' }\n  })\n  if (!denied?.decidedAt) return null\n  return now.getTime() - new Date(denied.decidedAt).getTime() <= ACCESS_REQUEST_DENIAL_DAYS * 24 * 60 * 60 * 1000 ? denied : null\n}\n\n/** The requester takes back their own pending request. */\nexport async function withdrawAccessRequest(id: string, context: ResolverContext): Promise<AccessRequest> {\n  const { domain, user, tx } = context.state\n  const repository = getRepository(AccessRequest, tx)\n\n  const updated = await repository\n    .createQueryBuilder()\n    .update(AccessRequest)\n    .set({ state: AccessRequestStatus.WITHDRAWN })\n    .where('id = :id AND domain_id = :domainId AND requester_id = :userId AND state = :pending', {\n      id,\n      domainId: domain.id,\n      userId: user.id,\n      pending: AccessRequestStatus.PENDING\n    })\n    .execute()\n\n  if (!updated.affected) {\n    throw new Refusal('access-request-not-withdrawable', { id }, 'There is no pending request of yours to withdraw.')\n  }\n  return await repository.findOne({ where: { id }, relations: ['domain', 'requester'] })\n}\n\n/* ── who decides ─────────────────────────────────────────────────────────── */\n\n/**\n * The people who can decide: domain owners and holders of the role-granting privilege - the same pair the\n * decision door declares (`@privilege(category: \"user\", privilege: \"mutation\", domainOwnerGranted: true)`).\n * The requester is never one of them.\n */\nexport async function findDeciderIds(domain: Domain, requesterId: string, tx?: EntityManager): Promise<string[]> {\n  const owners = await findDomainOwnerUserIds(domain, tx)\n\n  const qb = getRepository(User, tx)\n    .createQueryBuilder('USER')\n    .select('USER.id', 'id')\n    .innerJoin('USER.domains', 'MEMBER', 'MEMBER.id = :memberOf', { memberOf: domain.id })\n    .innerJoin('USER.roles', 'role')\n    .innerJoin('role.privileges', 'PRIVILEGE')\n    .where('PRIVILEGE.category = :grantCategory', { grantCategory: ROLE_GRANTING_PRIVILEGE.category })\n    .andWhere('PRIVILEGE.name = :grantName', { grantName: ROLE_GRANTING_PRIVILEGE.privilege })\n    .andWhere('USER.status = :active', { active: UserStatus.ACTIVATED })\n  applyDomainInheritanceFilter(qb, 'role', domain, InheritedValueType.Include)\n  const holders = (await qb.getRawMany()).map(row => row.id)\n\n  return [...new Set([...owners, ...holders])].filter(id => id && id !== requesterId).sort()\n}\n\n/* ── reviewing ───────────────────────────────────────────────────────────── */\n\n/** Every assignable role that grants `category:privilege`, smallest first. */\nexport async function rolesGranting(category: string, privilege: string, domain: Domain, tx?: EntityManager) {\n  const qb = getRepository(Role, tx)\n    .createQueryBuilder('ROLE')\n    .innerJoin('ROLE.privileges', 'ASKED', 'ASKED.category = :askedCategory AND ASKED.name = :askedName', {\n      askedCategory: category,\n      askedName: privilege\n    })\n  const roles = await whereAssignableBy(qb, 'ROLE', domain).getMany()\n  if (roles.length === 0) return []\n\n  const withPrivileges = await getRepository(Role, tx).find({ where: { id: In(roles.map(role => role.id)) }, relations: ['privileges'] })\n  return withPrivileges\n    .map(role => ({ id: role.id, name: role.name, privilegeCount: role.privileges?.length ?? 0, role }))\n    .sort((a, b) => a.privilegeCount - b.privilegeCount || a.name.localeCompare(b.name))\n}\n\n/** The facts `reviewAccessDecision` reads - collected as the person deciding, inside this domain. */\nexport async function collectDecisionFacts(input: AccessDecisionInput, context: ResolverContext): Promise<DecisionFacts> {\n  const { domain, user: decider, tx } = context.state\n  const now = new Date()\n\n  const request = await getRepository(AccessRequest, tx).findOne({\n    where: { id: input.requestId, domain: { id: domain.id } },\n    relations: ['requester', 'requester.domains']\n  })\n\n  const base: DecisionFacts = {\n    request: null,\n    deciderId: decider.id,\n    decision: input.decision,\n    reason: input.reason,\n    requester: null,\n    requesterHoldsIt: false,\n    candidates: [],\n    deciderPrivileges: [],\n    deciderIsOwner: false,\n    now\n  }\n  if (!request) return base\n\n  const requester = request.requester\n  const [candidates, chosen, deciderIsOwner, deciderPrivileges, requesterHoldsIt, deniedBefore] = await Promise.all([\n    rolesGranting(request.category, request.privilege, domain, tx),\n    input.roleId ? findAssignableRoles([input.roleId], domain, tx) : Promise.resolve([]),\n    isDomainOwner(domain, decider, tx),\n    User.getPrivilegesByDomain(decider, domain),\n    requester ? User.hasPrivilege(request.privilege, request.category, domain, requester) : Promise.resolve(false),\n    getRepository(AccessRequest, tx).findOne({\n      where: {\n        domain: { id: domain.id },\n        requester: { id: requester?.id },\n        category: request.category,\n        privilege: request.privilege,\n        state: AccessRequestStatus.DENIED\n      },\n      relations: ['decidedBy'],\n      order: { decidedAt: 'DESC' }\n    })\n  ])\n\n  const role = chosen[0]\n    ? await getRepository(Role, tx).findOne({ where: { id: chosen[0].id }, relations: ['privileges'] })\n    : null\n\n  return {\n    ...base,\n    request: {\n      state: request.state as any,\n      requesterId: requester?.id,\n      category: request.category,\n      privilege: request.privilege,\n      expiresAt: request.expiresAt\n    },\n    role: role\n      ? { id: role.id, name: role.name, privileges: (role.privileges || []).map(p => ({ category: p.category, privilege: p.name })) }\n      : null,\n    roleNamedButNotAssignable: !!input.roleId && !role,\n    requester: requester\n      ? {\n          active: requester.status === UserStatus.ACTIVATED,\n          inDomain: (requester.domains || []).some(d => d.id === domain.id)\n        }\n      : null,\n    requesterHoldsIt,\n    candidates: candidates.map(({ id, name, privilegeCount }) => ({ id, name, privilegeCount })),\n    deciderIsOwner,\n    deciderPrivileges: (deciderPrivileges || []).map((p: any) => ({ category: p.category, privilege: p.privilege })),\n    deniedBefore:\n      deniedBefore && deniedBefore.id !== request.id\n        ? {\n            by: deniedBefore.decidedBy?.name || deniedBefore.decidedBy?.email || '',\n            at: deniedBefore.decidedAt,\n            reason: deniedBefore.decisionReason\n          }\n        : null\n  }\n}\n\nexport async function reviewDecision(input: AccessDecisionInput, context: ResolverContext): Promise<DecisionIssue[]> {\n  return reviewAccessDecision(await collectDecisionFacts(input, context))\n}\n\n/* ── deciding ────────────────────────────────────────────────────────────── */\n\n/**\n * Grants or denies. The review runs again here - the card and the screen were shown a moment ago, and another\n * person may have decided since. The state moves PENDING → decided in one conditional update, so two people\n * deciding at once cannot both win.\n */\nexport async function decideAccessRequest(input: AccessDecisionInput, context: ResolverContext): Promise<AccessRequest> {\n  const { domain, user: decider, tx } = context.state\n  const now = new Date()\n\n  const issues = await reviewDecision(input, context)\n  if (isBlocked(issues)) {\n    throw new AccessDecisionRefused(issues)\n  }\n\n  const repository = getRepository(AccessRequest, tx)\n  const granting = input.decision === 'GRANT'\n\n  const moved = await repository\n    .createQueryBuilder()\n    .update(AccessRequest)\n    .set({\n      state: granting ? AccessRequestStatus.GRANTED : AccessRequestStatus.DENIED,\n      decidedBy: { id: decider.id } as User,\n      decidedAt: now,\n      decisionReason: input.reason?.trim() || null,\n      grantedRole: granting ? ({ id: input.roleId } as Role) : null\n    })\n    .where('id = :id AND domain_id = :domainId AND state = :pending', {\n      id: input.requestId,\n      domainId: domain.id,\n      pending: AccessRequestStatus.PENDING\n    })\n    .execute()\n\n  if (!moved.affected) {\n    throw new AccessDecisionRefused([{ code: 'request-not-pending', blocking: true, field: 'request' }])\n  }\n\n  const request = await repository.findOne({ where: { id: input.requestId }, relations: ['requester', 'requester.roles', 'grantedRole'] })\n  const requester = request.requester\n\n  if (granting) {\n    await assignRoles(requester, { add: [input.roleId] }, domain, tx)\n    await closeWhatTheGrantOpened(request, context)\n  }\n\n  tellLater(context, 'notify the requester of the decision', async () =>\n    notifyEach(\n      context,\n      [requester.id],\n      granting ? 'access-request.notify.granted' : 'access-request.notify.denied',\n      { privilege: `${request.category}:${request.privilege}`, role: request.grantedRole?.name ?? '', reason: request.decisionReason ?? '' },\n      /* The requester cannot read the list of everyone's requests - their own is where the answer is. */\n      'my-access-requests'\n    )\n  )\n\n  return request\n}\n\n/** Other pending requests of the same person that the role just given now answers - closed as granted with it. */\nasync function closeWhatTheGrantOpened(granted: AccessRequest, context: ResolverContext) {\n  const { domain, user: decider, tx } = context.state\n  const repository = getRepository(AccessRequest, tx)\n  const others = await repository.find({\n    where: { domain: { id: domain.id }, requester: { id: granted.requester.id }, state: AccessRequestStatus.PENDING },\n    relations: ['requester']\n  })\n\n  for (const other of others) {\n    if (!(await User.hasPrivilege(other.privilege, other.category, domain, granted.requester))) continue\n    await repository.update(\n      { id: other.id, state: AccessRequestStatus.PENDING },\n      { state: AccessRequestStatus.GRANTED, decidedBy: { id: decider.id } as User, decidedAt: new Date(), grantedRole: granted.grantedRole }\n    )\n  }\n}\n\n/* ── telling ─────────────────────────────────────────────────────────────── */\n\n/** After the commit when there is a transaction, at once otherwise - a failed notification never fails the decision. */\nfunction tellLater(context: ResolverContext, name: string, run: () => Promise<void>) {\n  const deferred = whenCommitted(context.state.afterCommit, name, run)\n  if (!deferred) void run().catch(() => {})\n}\n\n/**\n * One notification per person, in that person's language (`User.locale`), linking to where they can act on it. `notify` is optional: it is there when\n * the notification module is loaded, and nothing happens otherwise - the request list is the record.\n */\nasync function notifyEach(\n  context: ResolverContext,\n  userIds: string[],\n  key: string,\n  params: Record<string, string>,\n  url: string\n) {\n  const notify = (context.state as any).notify\n  if (typeof notify !== 'function' || userIds.length === 0) return\n\n  const people = await getRepository(User).find({ where: { id: In(userIds) } })\n  const byLocale = new Map<string, string[]>()\n  for (const person of people) {\n    const locale = person.locale || ''\n    byLocale.set(locale, [...(byLocale.get(locale) || []), person.id])\n  }\n\n  for (const [locale, receivers] of byLocale) {\n    const say = (suffix: string) => translate(context, `${key}.${suffix}`, params, locale)\n    await notify({\n      receivers,\n      type: 'info',\n      subject: 'access-request',\n      title: say('title'),\n      body: say('body'),\n      url,\n      mode: 'background'\n    })\n  }\n}\n\nfunction translate(context: any, key: string, params: Record<string, string>, locale: string): string {\n  const i18next = context?.i18next\n  if (locale && i18next?.t) return i18next.t(key, { ...params, lng: locale })\n  return typeof context?.t === 'function' ? context.t(key, { ...params }) : key\n}\n"]}

package/dist-server/index.d.ts

@@ -1,5 +1,8 @@
 import './routes.js';
 export * from './service/index.js';
+export * from './ai-entry/access-entry-targets.js';
+export * from './ai-entry/access-assistant.js';
+export type { EntryTargetDeclaration as AuthEntryTarget } from './ai-entry/entry-target-shape.js';
 export * from './migrations/index.js';
 export * from './middlewares/index.js';
 export * from './router/index.js';

package/dist-server/index.js

@@ -7,6 +7,9 @@ const privilege_axis_js_1 = require("./service/privilege/privilege-axis.js");
 const role_template_js_1 = require("./service/role-template/role-template.js");
 require("./routes.js");
 tslib_1.__exportStar(require("./service/index.js"), exports);
+/* AI 입력 declarations - plain data, registered by an application that runs the assistant (ADR-0103). */
+tslib_1.__exportStar(require("./ai-entry/access-entry-targets.js"), exports);
+tslib_1.__exportStar(require("./ai-entry/access-assistant.js"), exports);
 tslib_1.__exportStar(require("./migrations/index.js"), exports);
 tslib_1.__exportStar(require("./middlewares/index.js"), exports);
 tslib_1.__exportStar(require("./router/index.js"), exports);

package/dist-server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA,iDAAqD;AACrD,mEAA4D;AAC5D,6EAA0E;AAC1E,+EAAsF;AAEtF,uBAAoB;AAEpB,6DAAkC;AAClC,gEAAqC;AAErC,iEAAsC;AACtC,4DAAiC;AACjC,sDAA2B;AAE3B,sEAA2C;AAC3C,sEAA2C;AAC3C,yEAA8C;AAC9C,6EAAkD;AAClD,sEAA2C;AAC3C,gEAAqC;AACrC,+EAAoD;AACpD,yEAA8C;AAC9C,mEAAwC;AACxC,sEAA2C;AAC3C,yEAA8C;AAC9C,oEAAyC;AAEzC,4DAAiC;AAEjC,qDAA0B;AAE1B,OAAO,CAAC,EAAE,CAAC,wBAA+B,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAO,EAAE,EAAE;IACjF,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACxC,MAAM,mBAAmB,GAAG,IAAA,qBAAa,EAAC,wBAAS,CAAC,CAAA;IAEpD,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,UAA8B,CAAC,EAAE,CAAC;QAC7E,IAAI,CAAC,IAAI,CAAC,MAAM,mBAAmB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,mBAAmB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QACpD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAA;IAExF;;;;;OAKG;IACH,IAAA,8CAA2B,GAAE,CAAA;IAE7B;;;;;OAKG;IACH,IAAA,sCAAkB,GAAE,CAAA;AACtB,CAAC,CAAC,CAAA","sourcesContent":["import { getRepository } from '@things-factory/shell'\nimport { Privilege } from './service/privilege/privilege.js'\nimport { reportDeclaredAxes } from './service/privilege/privilege-axis.js'\nimport { reportUnknownTemplateGrants } from './service/role-template/role-template.js'\n\nimport './routes.js'\n\nexport * from './service/index.js'\nexport * from './migrations/index.js'\n\nexport * from './middlewares/index.js'\nexport * from './router/index.js'\nexport * from './routes.js'\n\nexport * from './utils/get-domain-users.js'\nexport * from './utils/get-user-domains.js'\nexport * from './utils/checkin-domain-rule.js'\nexport * from './utils/can-user-checkin-domain.js'\nexport * from './utils/domain-ownership.js'\nexport * from './utils/get-secret.js'\nexport * from './utils/check-user-belongs-domain.js'\nexport * from './utils/access-token-cookie.js'\nexport * from './utils/encrypt-state.js'\nexport * from './utils/check-permission.js'\nexport * from './utils/check-user-has-role.js'\nexport * from './utils/build-auth-url.js'\n\nexport * from './errors/index.js'\n\nexport * from './types.js'\n\nprocess.on('bootstrap-module-start' as any, async ({ app, config, client }: any) => {\n  const privileges = process['PRIVILEGES']\n  const privilegeRepository = getRepository(Privilege)\n\n  for (const [category, name] of Object.values(privileges as [string, string])) {\n    if (0 == (await privilegeRepository.count({ where: { category, name } }))) {\n      await privilegeRepository.save({ category, name })\n    }\n  }\n\n  console.log('[auth-base:bootstrap] Synchronization for privilege master has just done.')\n\n  /*\n   * Templates name privileges by (category, axis), and a category can move. A template\n   * that survives a rename becomes a role that grants nothing — the administrator picks\n   * \"quality inspector\", gets a role, and no door opens. Check the names once, here, where\n   * the privilege registry has just been filled.\n   */\n  reportUnknownTemplateGrants()\n\n  /*\n   * Say which axis vocabulary this installation ended up with. It cannot go in the SDL —\n   * it differs per installation, which is the whole point — so a boot line is the honest\n   * substitute, and it separates \"nobody declared, these are the defaults\" from \"someone\n   * declared exactly these\".\n   */\n  reportDeclaredAxes()\n})\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA,iDAAqD;AACrD,mEAA4D;AAC5D,6EAA0E;AAC1E,+EAAsF;AAEtF,uBAAoB;AAEpB,6DAAkC;AAClC,uGAAuG;AACvG,6EAAkD;AAClD,yEAA8C;AAE9C,gEAAqC;AAErC,iEAAsC;AACtC,4DAAiC;AACjC,sDAA2B;AAE3B,sEAA2C;AAC3C,sEAA2C;AAC3C,yEAA8C;AAC9C,6EAAkD;AAClD,sEAA2C;AAC3C,gEAAqC;AACrC,+EAAoD;AACpD,yEAA8C;AAC9C,mEAAwC;AACxC,sEAA2C;AAC3C,yEAA8C;AAC9C,oEAAyC;AAEzC,4DAAiC;AAEjC,qDAA0B;AAE1B,OAAO,CAAC,EAAE,CAAC,wBAA+B,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAO,EAAE,EAAE;IACjF,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACxC,MAAM,mBAAmB,GAAG,IAAA,qBAAa,EAAC,wBAAS,CAAC,CAAA;IAEpD,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,UAA8B,CAAC,EAAE,CAAC;QAC7E,IAAI,CAAC,IAAI,CAAC,MAAM,mBAAmB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,mBAAmB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QACpD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAA;IAExF;;;;;OAKG;IACH,IAAA,8CAA2B,GAAE,CAAA;IAE7B;;;;;OAKG;IACH,IAAA,sCAAkB,GAAE,CAAA;AACtB,CAAC,CAAC,CAAA","sourcesContent":["import { getRepository } from '@things-factory/shell'\nimport { Privilege } from './service/privilege/privilege.js'\nimport { reportDeclaredAxes } from './service/privilege/privilege-axis.js'\nimport { reportUnknownTemplateGrants } from './service/role-template/role-template.js'\n\nimport './routes.js'\n\nexport * from './service/index.js'\n/* AI 입력 declarations - plain data, registered by an application that runs the assistant (ADR-0103). */\nexport * from './ai-entry/access-entry-targets.js'\nexport * from './ai-entry/access-assistant.js'\nexport type { EntryTargetDeclaration as AuthEntryTarget } from './ai-entry/entry-target-shape.js'\nexport * from './migrations/index.js'\n\nexport * from './middlewares/index.js'\nexport * from './router/index.js'\nexport * from './routes.js'\n\nexport * from './utils/get-domain-users.js'\nexport * from './utils/get-user-domains.js'\nexport * from './utils/checkin-domain-rule.js'\nexport * from './utils/can-user-checkin-domain.js'\nexport * from './utils/domain-ownership.js'\nexport * from './utils/get-secret.js'\nexport * from './utils/check-user-belongs-domain.js'\nexport * from './utils/access-token-cookie.js'\nexport * from './utils/encrypt-state.js'\nexport * from './utils/check-permission.js'\nexport * from './utils/check-user-has-role.js'\nexport * from './utils/build-auth-url.js'\n\nexport * from './errors/index.js'\n\nexport * from './types.js'\n\nprocess.on('bootstrap-module-start' as any, async ({ app, config, client }: any) => {\n  const privileges = process['PRIVILEGES']\n  const privilegeRepository = getRepository(Privilege)\n\n  for (const [category, name] of Object.values(privileges as [string, string])) {\n    if (0 == (await privilegeRepository.count({ where: { category, name } }))) {\n      await privilegeRepository.save({ category, name })\n    }\n  }\n\n  console.log('[auth-base:bootstrap] Synchronization for privilege master has just done.')\n\n  /*\n   * Templates name privileges by (category, axis), and a category can move. A template\n   * that survives a rename becomes a role that grants nothing — the administrator picks\n   * \"quality inspector\", gets a role, and no door opens. Check the names once, here, where\n   * the privilege registry has just been filled.\n   */\n  reportUnknownTemplateGrants()\n\n  /*\n   * Say which axis vocabulary this installation ended up with. It cannot go in the SDL —\n   * it differs per installation, which is the whole point — so a boot line is the honest\n   * substitute, and it separates \"nobody declared, these are the defaults\" from \"someone\n   * declared exactly these\".\n   */\n  reportDeclaredAxes()\n})\n"]}

package/dist-server/service/access-request/access-request-mutation.d.ts

@@ -0,0 +1,17 @@
+import { AccessRequest } from './access-request.js';
+import { AccessDecisionInput, NewAccessRequest } from './access-request-types.js';
+export declare const DECIDE = "@privilege(category: \"user\", privilege: \"mutation\", domainOwnerGranted: true)";
+export declare class AccessRequestMutation {
+    /**
+     * Open by design (open-fields.ts): anyone in the domain who was refused for want of a role asks here. The
+     * door holds the rest - the caller asks only for themselves, the server judges again that a role would open it.
+     */
+    requestAccess(request: NewAccessRequest, context: ResolverContext): Promise<AccessRequest>;
+    /** Open by design: only the caller's own pending request can be withdrawn. */
+    withdrawAccessRequest(id: string, context: ResolverContext): Promise<AccessRequest>;
+    /**
+     * A person presses grant or deny - on the list screen, or on the AI 입력 draft card. The model never calls this
+     * (ADR-0103 decision 4); the review runs again inside.
+     */
+    decideAccessRequest(decision: AccessDecisionInput, context: ResolverContext): Promise<AccessRequest>;
+}

package/dist-server/service/access-request/access-request-mutation.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessRequestMutation = exports.DECIDE = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const access_request_js_1 = require("../../controllers/access-request.js");
+const access_request_js_2 = require("./access-request.js");
+const access_request_types_js_1 = require("./access-request-types.js");
+/* Deciding is putting somebody into a role - the same declaration as `updateUserRoles`, so who is told and who may decide are one set. */
+exports.DECIDE = '@privilege(category: "user", privilege: "mutation", domainOwnerGranted: true)';
+let AccessRequestMutation = class AccessRequestMutation {
+    /**
+     * Open by design (open-fields.ts): anyone in the domain who was refused for want of a role asks here. The
+     * door holds the rest - the caller asks only for themselves, the server judges again that a role would open it.
+     */
+    async requestAccess(request, context) {
+        return await (0, access_request_js_1.requestAccess)(request, context);
+    }
+    /** Open by design: only the caller's own pending request can be withdrawn. */
+    async withdrawAccessRequest(id, context) {
+        return await (0, access_request_js_1.withdrawAccessRequest)(id, context);
+    }
+    /**
+     * A person presses grant or deny - on the list screen, or on the AI 입력 draft card. The model never calls this
+     * (ADR-0103 decision 4); the review runs again inside.
+     */
+    async decideAccessRequest(decision, context) {
+        return await (0, access_request_js_1.decideAccessRequest)(decision, context);
+    }
+};
+exports.AccessRequestMutation = AccessRequestMutation;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => access_request_js_2.AccessRequest, { description: 'To ask for a privilege the caller was refused for want of a role. Asking again while one is pending adds to it.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('request', type => access_request_types_js_1.NewAccessRequest)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [access_request_types_js_1.NewAccessRequest, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], AccessRequestMutation.prototype, "requestAccess", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => access_request_js_2.AccessRequest, { description: "To withdraw the caller's own pending access request." }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], AccessRequestMutation.prototype, "withdrawAccessRequest", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)(exports.DECIDE),
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Mutation)(returns => access_request_js_2.AccessRequest, { description: 'To grant an access request by putting the requester into a role, or to deny it with a reason.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('decision', type => access_request_types_js_1.AccessDecisionInput)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [access_request_types_js_1.AccessDecisionInput, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], AccessRequestMutation.prototype, "decideAccessRequest", null);
+exports.AccessRequestMutation = AccessRequestMutation = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(access_request_js_2.AccessRequest),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
+], AccessRequestMutation);
+//# sourceMappingURL=access-request-mutation.js.map

package/dist-server/service/access-request/access-request-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-request-mutation.js","sourceRoot":"","sources":["../../../server/service/access-request/access-request-mutation.ts"],"names":[],"mappings":";;;;AAAA,+CAAqF;AAErF,iDAAqD;AAErD,2EAA+G;AAC/G,2DAAmD;AACnD,uEAAiF;AAEjF,0IAA0I;AAC7H,QAAA,MAAM,GAAG,+EAA+E,CAAA;AAI9F,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC;;;OAGG;IAGG,AAAN,KAAK,CAAC,aAAa,CAA2C,OAAyB,EAAS,OAAwB;QACtH,OAAO,MAAM,IAAA,iCAAa,EAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,8EAA8E;IAGxE,AAAN,KAAK,CAAC,qBAAqB,CAAY,EAAU,EAAS,OAAwB;QAChF,OAAO,MAAM,IAAA,yCAAqB,EAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;IAED;;;OAGG;IAIG,AAAN,KAAK,CAAC,mBAAmB,CAA+C,QAA6B,EAAS,OAAwB;QACpI,OAAO,MAAM,IAAA,uCAAmB,EAAC,QAAe,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;CACF,CAAA;AA5BY,sDAAqB;AAO1B;IAFL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,iCAAa,EAAE,EAAE,WAAW,EAAE,iHAAiH,EAAE,CAAC;IAClJ,mBAAA,IAAA,kBAAG,EAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,0CAAgB,CAAC,CAAA;IAA6B,mBAAA,IAAA,kBAAG,GAAE,CAAA;;6CAAxB,0CAAgB;;0DAEtF;AAKK;IAFL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,iCAAa,EAAE,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC;IAC/E,mBAAA,IAAA,kBAAG,EAAC,IAAI,CAAC,CAAA;IAAc,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;kEAExD;AASK;IAHL,IAAA,wBAAS,EAAC,cAAM,CAAC;IACjB,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,iCAAa,EAAE,EAAE,WAAW,EAAE,+FAA+F,EAAE,CAAC;IAC1H,mBAAA,IAAA,kBAAG,EAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,6CAAmB,CAAC,CAAA;IAAiC,mBAAA,IAAA,kBAAG,GAAE,CAAA;;6CAA3B,6CAAmB;;gEAEpG;gCA3BU,qBAAqB;IAFjC,IAAA,uBAAQ,EAAC,iCAAa,CAAC;IACvB,IAAA,4BAAa,EAAC,qBAAa,CAAC;GAChB,qBAAqB,CA4BjC","sourcesContent":["import { Arg, Ctx, Directive, Mutation, Resolver, UseMiddleware } from 'type-graphql'\n\nimport { SpeakRefusals } from '@things-factory/shell'\n\nimport { decideAccessRequest, requestAccess, withdrawAccessRequest } from '../../controllers/access-request.js'\nimport { AccessRequest } from './access-request.js'\nimport { AccessDecisionInput, NewAccessRequest } from './access-request-types.js'\n\n/* Deciding is putting somebody into a role - the same declaration as `updateUserRoles`, so who is told and who may decide are one set. */\nexport const DECIDE = '@privilege(category: \"user\", privilege: \"mutation\", domainOwnerGranted: true)'\n\n@Resolver(AccessRequest)\n@UseMiddleware(SpeakRefusals)\nexport class AccessRequestMutation {\n  /**\n   * Open by design (open-fields.ts): anyone in the domain who was refused for want of a role asks here. The\n   * door holds the rest - the caller asks only for themselves, the server judges again that a role would open it.\n   */\n  @Directive('@transaction')\n  @Mutation(returns => AccessRequest, { description: 'To ask for a privilege the caller was refused for want of a role. Asking again while one is pending adds to it.' })\n  async requestAccess(@Arg('request', type => NewAccessRequest) request: NewAccessRequest, @Ctx() context: ResolverContext): Promise<AccessRequest> {\n    return await requestAccess(request, context)\n  }\n\n  /** Open by design: only the caller's own pending request can be withdrawn. */\n  @Directive('@transaction')\n  @Mutation(returns => AccessRequest, { description: \"To withdraw the caller's own pending access request.\" })\n  async withdrawAccessRequest(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<AccessRequest> {\n    return await withdrawAccessRequest(id, context)\n  }\n\n  /**\n   * A person presses grant or deny - on the list screen, or on the AI 입력 draft card. The model never calls this\n   * (ADR-0103 decision 4); the review runs again inside.\n   */\n  @Directive(DECIDE)\n  @Directive('@transaction')\n  @Mutation(returns => AccessRequest, { description: 'To grant an access request by putting the requester into a role, or to deny it with a reason.' })\n  async decideAccessRequest(@Arg('decision', type => AccessDecisionInput) decision: AccessDecisionInput, @Ctx() context: ResolverContext): Promise<AccessRequest> {\n    return await decideAccessRequest(decision as any, context)\n  }\n}\n"]}

package/dist-server/service/access-request/access-request-query.d.ts

@@ -0,0 +1,16 @@
+import { ListParam } from '@things-factory/shell';
+import { AccessRequest } from './access-request.js';
+import { AccessDecisionInput, AccessDecisionIssue, AccessRequestList, AccessRoleCandidate } from './access-request-types.js';
+export declare class AccessRequestQuery {
+    accessRequests(params: ListParam, context: ResolverContext): Promise<AccessRequestList>;
+    /** Open by design: the caller's own requests - where they see what became of them. */
+    myAccessRequests(context: ResolverContext): Promise<AccessRequest[]>;
+    /**
+     * Open by design: how many people a request would reach - the popup says it before the person sends, so asking reads
+     * as what it is. A number, never who.
+     */
+    accessRequestDeciderCount(context: ResolverContext): Promise<number>;
+    rolesGranting(category: string, privilege: string, context: ResolverContext): Promise<AccessRoleCandidate[]>;
+    /** The same review the decision runs - the list screen and the AI draft card show this (ADR-0103 decision 4). */
+    reviewAccessDecision(decision: AccessDecisionInput, context: ResolverContext): Promise<AccessDecisionIssue[]>;
+}