@webiny/api-workflows 0.0.0-unstable.a4f3e4ea8b → 0.0.0-unstable.a85ef555b2

package/domain/review/Review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/review/Review.js","sources":["../../../src/domain/review/Review.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport type { Workflow } from \"~/domain/workflow/types.js\";\nimport { canPickReviewer } from \"~/domain/workflow/canPickReviewer.js\";\nimport { REVIEW_STEP_TYPE } from \"~/domain/workflow/stepTypes.js\";\nimport type {\n    Actor,\n    AiIssue,\n    ReviewData,\n    ReviewPick,\n    ReviewState,\n    ReviewStep,\n    ReviewSystemWorkflow,\n    StepAssignmentResolution,\n    StepState,\n    TargetContext\n} from \"./types.js\";\nimport type { ReviewFact } from \"./facts.js\";\nimport {\n    ReviewActorNotUserError,\n    ReviewAlreadyOwnerError,\n    ReviewInvalidStateError,\n    ReviewNotCandidateError,\n    ReviewNotOwnerError,\n    ReviewRequesterCannotReviewError,\n    ReviewStepNotCurrentError,\n    ReviewStepNotReassignableError,\n    ReviewStepNotTakeableError,\n    type ReviewTransitionName,\n    ReviewValidationError\n} from \"./errors.js\";\n\n/** `reason` on the pool assignment when a resolver returns the requester as owner (spec 5.1). */\nconst REQUESTER_OWNER_REASON =\n    \"The resolved owner is the requester, who cannot review their own content.\";\n\n/** A requested title, trimmed, has at least this many characters (D100, D135). */\nexport const REVIEW_TITLE_MIN_LENGTH = 5;\n\n/** A rejection comment, trimmed, has at least this many characters (D100). */\nexport const REJECT_COMMENT_MIN_LENGTH = 10;\n\nexport interface ReviewRequestParams {\n    id: string;\n    workflow: Workflow;\n    model: string;\n    targetId: string;\n    targetRevisionId: string;\n    /** The target's title; the review title when `requestedTitle` is missing or blank. */\n    title: string;\n    /** The title the requester typed (D135); trimmed, at least 5 characters when given. */\n    requestedTitle?: string | null;\n    targetContext: TargetContext;\n    picks: ReviewPick[];\n    requester: Actor;\n    now: string;\n}\n\nexport interface ReviewReachParams {\n    resolution: StepAssignmentResolution;\n    /** Who caused the step to be reached. */\n    actor: Actor;\n    now: string;\n}\n\nexport interface ReviewStepParams {\n    /** The step the caller acts on; must be the current step (R17). */\n    stepId: string;\n}\n\n/** Who acts on the step. The checks take this; the transitions add `now`. */\nexport interface ReviewActorCheckParams extends ReviewStepParams {\n    actor: Actor;\n    /** Teams of the actor, resolved by the caller (the aggregate never reads identity, D5). */\n    actorTeamIds: string[];\n}\n\nexport interface ReviewActorParams extends ReviewActorCheckParams {\n    now: string;\n}\n\nexport interface ReviewTakeOverParams extends ReviewActorParams {\n    /** D111: whether the previous owner is told; omitted means true. Carried on the fact, never stored. */\n    notifyPreviousOwner?: boolean;\n}\n\n/** `actorTeamIds` is not read by approve or reject: only the owner decides (spec 5.1). */\nexport interface ReviewDecisionParams extends ReviewActorParams {\n    comment: string | null;\n    /** The findings of an AI decision, stored on the step (R171); omitted means none. */\n    issues?: AiIssue[];\n}\n\nexport interface ReviewCancelParams {\n    actor: Actor;\n    now: string;\n    /** Recorded on the cancelled fact (D134); omitted for a normal cancel. */\n    reason?: string | null;\n}\n\nexport interface ReviewReassignToCheckParams extends ReviewStepParams {\n    /** The chosen user; the current owner is refused (R126). */\n    userId: string;\n}\n\nexport interface ReviewReassignParams extends ReviewStepParams {\n    /** Who reassigns; recorded as `by` (D127). */\n    actor: Actor;\n    /** The chosen user, validated by the caller (R112, R119). */\n    owner: Actor;\n    now: string;\n}\n\nexport interface ReviewReachRunParams {\n    /** Who caused the step to be reached: the requester or the approver of the previous step. */\n    actor: Actor;\n    /** The automation actor (R141); `getAutomationActor(requester)`. */\n    owner: Actor;\n    /** The background task started for this attempt; `null` when none was started. */\n    taskId: string | null;\n    now: string;\n}\n\nexport interface ReviewFailParams extends ReviewStepParams {\n    /** A fixed reason text (R146); stored in the step's `comment` and on its `runs` entry. */\n    reason: string;\n    now: string;\n}\n\nexport interface ReviewRestartParams extends ReviewStepParams {\n    /** Who restarts; recorded on the fact (the wrapper checked it, D132). */\n    actor: Actor;\n    now: string;\n}\n\n/** A human-held `inReview` step and its owner, as the take-over guard found them. */\ninterface ReviewHeldStep {\n    step: ReviewStep;\n    owner: Actor;\n}\n\nexport type ReviewReviewerError =\n    | ReviewInvalidStateError\n    | ReviewStepNotCurrentError\n    | ReviewActorNotUserError\n    | ReviewRequesterCannotReviewError\n    | ReviewNotCandidateError;\n\nexport type ReviewTakeOverError =\n    | ReviewReviewerError\n    | ReviewAlreadyOwnerError\n    | ReviewStepNotTakeableError;\n\nexport type ReviewDecisionError =\n    | ReviewInvalidStateError\n    | ReviewStepNotCurrentError\n    | ReviewNotOwnerError;\n\n/** Reject adds the comment rule (D100) to the decision rules. */\nexport type ReviewRejectError = ReviewDecisionError | ReviewValidationError;\n\nexport type ReviewReassignError =\n    | ReviewInvalidStateError\n    | ReviewStepNotCurrentError\n    | ReviewStepNotReassignableError;\n\n/** With a chosen user, the reassign check adds the same-owner rule (R126). */\nexport type ReviewReassignCheckError = ReviewReassignError | ReviewAlreadyOwnerError;\n\n/** The transition adds the requester rule to the check (spec 5.1). */\nexport type ReviewReassignTransitionError =\n    | ReviewReassignCheckError\n    | ReviewRequesterCannotReviewError;\n\n/** Fail needs the current step; the check for a finished review is `InvalidState` (R140). */\nexport type ReviewFailError = ReviewInvalidStateError | ReviewStepNotCurrentError;\n\n/** Restart needs a failed current step (R140, R153). */\nexport type ReviewRestartError = ReviewInvalidStateError | ReviewStepNotCurrentError;\n\n/**\n * One run of a workflow on one target revision (spec 3, 4.2, 5.1). Transitions take an explicit\n * actor and `now`, never read identity, and record facts; `ReviewSaver` persists the review and\n * publishes one event per fact.\n *\n * Each transition has a pure `check*` twin that runs the same private guard (R31), so viewer\n * flags (spec 5.3) and the transitions cannot drift. Who may cancel or reassign is a permission\n * rule, not a domain rule: the app wrappers decide it with `canCancelByPermission` and\n * `canReassignByPermission` (D132, R41) and leave the state errors to these guards.\n */\nexport class Review {\n    private readonly facts: ReviewFact[] = [];\n\n    private constructor(private readonly data: ReviewData) {}\n\n    public static fromData(data: ReviewData): Review {\n        return new Review(structuredClone(data));\n    }\n\n    public static request(params: ReviewRequestParams): Result<Review, ReviewValidationError> {\n        // Callers guarantee both (RequestReview queries by `models_in`, the validator requires a\n        // step); checked here so the aggregate never holds a review it cannot progress.\n        if (!params.workflow.models.includes(params.model)) {\n            return Result.fail(\n                new ReviewValidationError(\n                    `The workflow \"${params.workflow.name}\" is not bound to the model \"${params.model}\".`\n                )\n            );\n        }\n        if (params.workflow.steps.length === 0) {\n            return Result.fail(\n                new ReviewValidationError(`The workflow \"${params.workflow.name}\" has no steps.`)\n            );\n        }\n        const requestedTitle = params.requestedTitle?.trim() ?? \"\";\n        if (requestedTitle && requestedTitle.length < REVIEW_TITLE_MIN_LENGTH) {\n            return Result.fail(\n                new ReviewValidationError(\n                    `The review title must have at least ${REVIEW_TITLE_MIN_LENGTH} characters.`\n                )\n            );\n        }\n\n        const picks = new Map<string, string>();\n        for (const pick of params.picks) {\n            const step = params.workflow.steps.find(item => item.id === pick.stepId);\n            if (!step) {\n                return Result.fail(\n                    new ReviewValidationError(\n                        `Step \"${pick.stepId}\" does not exist in workflow \"${params.workflow.name}\".`\n                    )\n                );\n            }\n            if (!canPickReviewer(step)) {\n                return Result.fail(\n                    new ReviewValidationError(\n                        `Step \"${step.title}\" does not allow picking a reviewer.`\n                    )\n                );\n            }\n            if (picks.has(step.id)) {\n                return Result.fail(\n                    new ReviewValidationError(`Step \"${step.title}\" has more than one pick.`)\n                );\n            }\n            picks.set(step.id, pick.userId);\n        }\n\n        const steps = params.workflow.steps.map((step): ReviewStep => ({\n            ...structuredClone(step),\n            state: \"pending\",\n            owner: null,\n            comment: null,\n            pickedUserId: picks.get(step.id) ?? null,\n            candidateTeamIds: [],\n            assignmentSource: null,\n            assignment: null,\n            reachedOn: null,\n            startedOn: null,\n            finishedOn: null,\n            taskId: null,\n            runs: [],\n            issues: []\n        }));\n\n        const review = new Review({\n            id: params.id,\n            workflowId: params.workflow.id,\n            model: params.model,\n            targetId: params.targetId,\n            targetRevisionId: params.targetRevisionId,\n            // Fixed from here on: no operation changes the title (D135).\n            title: requestedTitle || params.title,\n            isActive: true,\n            state: \"inProgress\",\n            currentStepId: null,\n            currentStepState: null,\n            currentStepType: null,\n            currentOwnerId: null,\n            currentCandidateTeamIds: [],\n            targetContext: structuredClone(params.targetContext),\n            workflow: {\n                name: params.workflow.name,\n                models: [...params.workflow.models]\n            },\n            steps,\n            createdBy: { ...params.requester },\n            cancelledBy: null,\n            createdOn: params.now,\n            savedOn: params.now,\n            lastChangedOn: params.now\n        });\n        review.facts.push({\n            type: \"requested\",\n            occurredOn: params.now,\n            actor: { ...params.requester }\n        });\n        return Result.ok(review);\n    }\n\n    public get id(): string {\n        return this.data.id;\n    }\n\n    /**\n     * The step transitions act on: the first step that is not approved; `null` when all are.\n     * Not the persisted `ReviewData.currentStepId`, which keeps the last step after the final\n     * approval (D75).\n     */\n    public get actionableStepId(): string | null {\n        return this.findCurrentStep()?.id ?? null;\n    }\n\n    public toData(): ReviewData {\n        return structuredClone(this.data);\n    }\n\n    /**\n     * The requester is a user. AI and automation actors carry the requester's id (D58) but are not\n     * the requester.\n     */\n    public isRequestedBy(actor: Actor): boolean {\n        return actor.type === \"user\" && actor.id === this.data.createdBy.id;\n    }\n\n    /** The task running for the current step, if any: only an in-review step has one (R151). */\n    public getRunningTaskId(): string | null {\n        const step = this.findCurrentStep();\n        if (!step || step.state !== \"inReview\") {\n            return null;\n        }\n        return step.taskId;\n    }\n\n    /**\n     * The task of every attempt of every step, in step order: a step's earlier attempts first,\n     * oldest first, then its current one (R256).\n     */\n    public getTaskIds(): string[] {\n        const taskIds: string[] = [];\n        for (const step of this.data.steps) {\n            for (const run of step.runs) {\n                if (run.taskId) {\n                    taskIds.push(run.taskId);\n                }\n            }\n            if (step.taskId) {\n                taskIds.push(step.taskId);\n            }\n        }\n        return taskIds;\n    }\n\n    /** The current step when it still has to be reached (spec 5.2). */\n    public getStepToReach(): ReviewStep | null {\n        if (this.data.state !== \"inProgress\") {\n            return null;\n        }\n        const step = this.findCurrentStep();\n        if (!step || step.state !== \"pending\") {\n            return null;\n        }\n        return structuredClone(step);\n    }\n\n    /** Reaches the `pending` current step of a review step; a run step is reached with `reachRun`. */\n    public reach(params: ReviewReachParams): Result<void, ReviewInvalidStateError> {\n        const current = this.getCurrentStepIn(\"reach\", \"pending\");\n        if (current.isFail()) {\n            return Result.fail(current.error);\n        }\n        const step = current.value;\n        if (step.type !== REVIEW_STEP_TYPE) {\n            return Result.fail(this.createInvalidStateError(\"reach\", step));\n        }\n        const resolution = this.withoutRequesterOwner(params.resolution);\n\n        step.candidateTeamIds = [...resolution.candidateTeamIds];\n        step.assignment = structuredClone(resolution.assignment);\n        step.assignmentSource = resolution.assignment.source;\n        step.reachedOn = params.now;\n        if (resolution.owner) {\n            step.owner = { ...resolution.owner };\n            step.state = \"inReview\";\n            step.startedOn = params.now;\n        } else {\n            step.owner = null;\n            step.state = \"awaiting\";\n        }\n\n        this.facts.push({\n            type: \"stepReached\",\n            occurredOn: params.now,\n            actor: { ...params.actor },\n            owner: step.owner ? { ...step.owner } : null,\n            change: { stepId: step.id, fromState: \"pending\", toState: step.state },\n            assignment: structuredClone(resolution.assignment),\n            taskId: null,\n            records: structuredClone(resolution.records)\n        });\n        return Result.ok();\n    }\n\n    /**\n     * Reaches the `pending` current step of an automation (spec 5.2, R140): the automation actor\n     * owns it at once, there is no pool and no assignment, and the id of the task started for it\n     * is stored. The caller triggered the task as the requester (R149) before saving.\n     */\n    public reachRun(params: ReviewReachRunParams): Result<void, ReviewInvalidStateError> {\n        const current = this.getCurrentStepIn(\"reach\", \"pending\");\n        if (current.isFail()) {\n            return Result.fail(current.error);\n        }\n        const step = current.value;\n        if (step.type === REVIEW_STEP_TYPE) {\n            return Result.fail(this.createInvalidStateError(\"reach\", step));\n        }\n\n        step.candidateTeamIds = [];\n        step.assignment = null;\n        step.assignmentSource = null;\n        step.owner = { ...params.owner };\n        step.state = \"inReview\";\n        step.reachedOn = params.now;\n        step.startedOn = params.now;\n        step.taskId = params.taskId;\n\n        this.facts.push({\n            type: \"stepReached\",\n            occurredOn: params.now,\n            actor: { ...params.actor },\n            owner: { ...params.owner },\n            change: { stepId: step.id, fromState: \"pending\", toState: \"inReview\" },\n            assignment: null,\n            taskId: params.taskId,\n            records: []\n        });\n        return Result.ok();\n    }\n\n    public checkStart(params: ReviewActorCheckParams): Result<void, ReviewReviewerError> {\n        return Review.toCheck(this.guardStart(params));\n    }\n\n    public start(params: ReviewActorParams): Result<void, ReviewReviewerError> {\n        const guard = this.guardStart(params);\n        if (guard.isFail()) {\n            return Result.fail(guard.error);\n        }\n        const step = guard.value;\n\n        step.owner = { ...params.actor };\n        step.state = \"inReview\";\n        step.startedOn = params.now;\n        step.assignmentSource = \"poolStart\";\n        step.assignment = { source: \"poolStart\" };\n\n        this.facts.push({\n            type: \"stepStarted\",\n            occurredOn: params.now,\n            actor: { ...params.actor },\n            change: { stepId: step.id, fromState: \"awaiting\", toState: \"inReview\" },\n            records: [\n                {\n                    kind: \"outcome\",\n                    userId: params.actor.id,\n                    source: \"poolStart\",\n                    ruleId: null,\n                    by: null,\n                    reason: null\n                }\n            ]\n        });\n        return Result.ok();\n    }\n\n    public checkTakeOver(params: ReviewActorCheckParams): Result<void, ReviewTakeOverError> {\n        return Review.toCheck(this.guardTakeOver(params));\n    }\n\n    public takeOver(params: ReviewTakeOverParams): Result<void, ReviewTakeOverError> {\n        const guard = this.guardTakeOver(params);\n        if (guard.isFail()) {\n            return Result.fail(guard.error);\n        }\n        const { step, owner: previousOwner } = guard.value;\n\n        step.owner = { ...params.actor };\n        step.assignmentSource = \"takeOver\";\n        step.assignment = { source: \"takeOver\", by: { ...params.actor } };\n\n        this.facts.push({\n            type: \"stepTakenOver\",\n            occurredOn: params.now,\n            actor: { ...params.actor },\n            change: { stepId: step.id, fromState: \"inReview\", toState: \"inReview\" },\n            previousOwner: { ...previousOwner },\n            notifyPreviousOwner: params.notifyPreviousOwner ?? true,\n            records: [\n                {\n                    kind: \"outcome\",\n                    userId: params.actor.id,\n                    source: \"takeOver\",\n                    ruleId: null,\n                    by: { ...params.actor },\n                    reason: null\n                }\n            ]\n        });\n        return Result.ok();\n    }\n\n    public checkApprove(params: ReviewActorCheckParams): Result<void, ReviewDecisionError> {\n        return Review.toCheck(this.getOwnedStep(\"approve\", params));\n    }\n\n    /**\n     * Owner (user, AI or automation) approves; the next step is reached by the caller (D6). The\n     * comment is optional: it is stored trimmed, and a blank one is stored as none.\n     */\n    public approve(params: ReviewDecisionParams): Result<void, ReviewDecisionError> {\n        const current = this.getOwnedStep(\"approve\", params);\n        if (current.isFail()) {\n            return Result.fail(current.error);\n        }\n        const step = current.value;\n        const comment = params.comment?.trim() || null;\n\n        step.state = \"approved\";\n        step.comment = comment;\n        step.issues = (params.issues ?? []).map(issue => ({ ...issue }));\n        step.finishedOn = params.now;\n        this.facts.push({\n            type: \"stepApproved\",\n            occurredOn: params.now,\n            actor: { ...params.actor },\n            change: { stepId: step.id, fromState: \"inReview\", toState: \"approved\" },\n            comment\n        });\n\n        if (this.data.steps.every(item => item.state === \"approved\")) {\n            this.data.state = \"approved\";\n            this.facts.push({\n                type: \"approved\",\n                occurredOn: params.now,\n                actor: { ...params.actor }\n            });\n        }\n        return Result.ok();\n    }\n\n    public checkReject(params: ReviewActorCheckParams): Result<void, ReviewDecisionError> {\n        return Review.toCheck(this.getOwnedStep(\"reject\", params));\n    }\n\n    /**\n     * Owner rejects; reject is final for the revision (D10). Needs a comment of at least 10\n     * characters after trimming (D100), checked after the state and owner rules. `checkReject`\n     * (the viewer flag) does not take a comment, so it leaves this rule out.\n     */\n    public reject(params: ReviewDecisionParams): Result<void, ReviewRejectError> {\n        const current = this.getOwnedStep(\"reject\", params);\n        if (current.isFail()) {\n            return Result.fail(current.error);\n        }\n        const comment = params.comment?.trim() ?? \"\";\n        if (comment.length < REJECT_COMMENT_MIN_LENGTH) {\n            return Result.fail(\n                new ReviewValidationError(\n                    `A rejection needs a comment of at least ${REJECT_COMMENT_MIN_LENGTH} characters.`\n                )\n            );\n        }\n        const step = current.value;\n\n        step.state = \"rejected\";\n        step.comment = comment;\n        step.issues = (params.issues ?? []).map(issue => ({ ...issue }));\n        step.finishedOn = params.now;\n        this.data.state = \"rejected\";\n        this.facts.push({\n            type: \"stepRejected\",\n            occurredOn: params.now,\n            actor: { ...params.actor },\n            change: { stepId: step.id, fromState: \"inReview\", toState: \"rejected\" },\n            comment\n        });\n        return Result.ok();\n    }\n\n    public checkCancel(): Result<void, ReviewInvalidStateError> {\n        return Review.toCheck(this.guardCancel());\n    }\n\n    /**\n     * Allowed while the review is in progress (D25, D75). Who may cancel (requester or\n     * `reassign`, D54) is checked by the app wrapper with `canCancelByPermission` (D132, R41).\n     */\n    public cancel(params: ReviewCancelParams): Result<void, ReviewInvalidStateError> {\n        const guard = this.guardCancel();\n        if (guard.isFail()) {\n            return Result.fail(guard.error);\n        }\n        const step = guard.value;\n\n        this.data.state = \"cancelled\";\n        this.data.cancelledBy = { ...params.actor };\n        this.facts.push({\n            type: \"cancelled\",\n            occurredOn: params.now,\n            actor: { ...params.actor },\n            stepId: step?.id ?? null,\n            stepState: step?.state ?? null,\n            reason: params.reason ?? null\n        });\n        return Result.ok();\n    }\n\n    /**\n     * Reassign is possible on an `awaiting` or human-owned `inReview` step (D33). Who may reassign\n     * (`reassign`) is checked by the app wrapper with `canReassignByPermission` (D132, R41).\n     */\n    public checkReassign(params: ReviewStepParams): Result<void, ReviewReassignError> {\n        return Review.toCheck(this.guardReassign(params));\n    }\n\n    /**\n     * `checkReassign` plus the same-owner rule for the chosen user (R126), so a reassign to the\n     * current owner is refused before the caller validates the user.\n     */\n    public checkReassignTo(\n        params: ReviewReassignToCheckParams\n    ): Result<void, ReviewReassignCheckError> {\n        return Review.toCheck(this.guardReassignTo(params));\n    }\n\n    /**\n     * Gives the step to the chosen user (spec 5.1, R119), through the same guard as\n     * `checkReassignTo`, with the new owner as the chosen user. The caller has validated the user\n     * like a pick (R112); the requester is refused here too, as on start and take over. An\n     * `awaiting` step starts now; an `inReview` step keeps its `startedOn`.\n     */\n    public reassign(params: ReviewReassignParams): Result<void, ReviewReassignTransitionError> {\n        const guard = this.guardReassignTo({ stepId: params.stepId, userId: params.owner.id });\n        if (guard.isFail()) {\n            return Result.fail(guard.error);\n        }\n        const step = guard.value;\n        if (this.isRequestedBy(params.owner)) {\n            return Result.fail(\n                new ReviewRequesterCannotReviewError({ reviewId: this.data.id, stepId: step.id })\n            );\n        }\n        const previousOwner = step.owner;\n        const fromState = step.state;\n\n        step.owner = { ...params.owner };\n        if (fromState === \"awaiting\") {\n            step.state = \"inReview\";\n            step.startedOn = params.now;\n        }\n        step.assignmentSource = \"reassign\";\n        step.assignment = { source: \"reassign\", by: { ...params.actor } };\n\n        this.facts.push({\n            type: \"stepReassigned\",\n            occurredOn: params.now,\n            actor: { ...params.actor },\n            change: { stepId: step.id, fromState, toState: \"inReview\" },\n            owner: { ...params.owner },\n            previousOwner: previousOwner ? { ...previousOwner } : null,\n            records: [\n                {\n                    kind: \"outcome\",\n                    userId: params.owner.id,\n                    source: \"reassign\",\n                    ruleId: null,\n                    by: { ...params.actor },\n                    reason: null\n                }\n            ]\n        });\n        return Result.ok();\n    }\n\n    /**\n     * Fails the current step with a reason (spec 5.1, D8, R140): a `pending` or `inReview` step,\n     * the owner kept, `comment` = the reason. The review stays in progress; the step can be\n     * restarted. An already failed step is a no-op without a fact, so a late hook, stuck\n     * detection or a second failure path cannot fail it twice or overwrite its reason.\n     */\n    public fail(params: ReviewFailParams): Result<void, ReviewFailError> {\n        const guard = this.guardFail(params.stepId);\n        if (guard.isFail()) {\n            return Result.fail(guard.error);\n        }\n        const step = guard.value;\n        if (step.state === \"failed\") {\n            return Result.ok();\n        }\n        const fromState = step.state;\n\n        step.state = \"failed\";\n        step.comment = params.reason;\n        step.finishedOn = params.now;\n\n        this.facts.push({\n            type: \"stepFailed\",\n            occurredOn: params.now,\n            actor: { ...(step.owner ?? this.data.createdBy) },\n            change: { stepId: step.id, fromState, toState: \"failed\" },\n            reason: params.reason\n        });\n        return Result.ok();\n    }\n\n    /**\n     * Restart is possible on a failed current step only (spec 5.1, D8, R153); a rejected step is\n     * final (D10). Who may restart (requester or `reassign`) is checked by the app wrapper with\n     * `canRestartByPermission` (D132, R41).\n     */\n    public checkRestart(params: ReviewStepParams): Result<void, ReviewRestartError> {\n        return Review.toCheck(this.guardRestart(params));\n    }\n\n    /**\n     * Moves the failed attempt into `runs` and makes the step `pending` again (R140, D82). The\n     * owner stays; the times of the attempt are cleared because a `pending` step has none. The\n     * caller re-reaches the step afterwards (`reachRun`).\n     */\n    public restart(params: ReviewRestartParams): Result<void, ReviewRestartError> {\n        const guard = this.guardRestart(params);\n        if (guard.isFail()) {\n            return Result.fail(guard.error);\n        }\n        const step = guard.value;\n        const previousTaskId = step.taskId;\n\n        step.runs.push({\n            taskId: step.taskId,\n            startedOn: step.startedOn ?? step.reachedOn ?? step.finishedOn ?? params.now,\n            finishedOn: step.finishedOn,\n            outcome: \"failed\",\n            reason: step.comment\n        });\n        step.state = \"pending\";\n        step.comment = null;\n        step.taskId = null;\n        step.issues = [];\n        step.reachedOn = null;\n        step.startedOn = null;\n        step.finishedOn = null;\n\n        this.facts.push({\n            type: \"stepRestarted\",\n            occurredOn: params.now,\n            actor: { ...params.actor },\n            change: { stepId: step.id, fromState: \"failed\", toState: \"pending\" },\n            previousTaskId\n        });\n        return Result.ok();\n    }\n\n    /**\n     * Called by the single save path before persisting (D19). Derives the review-level fields from\n     * the steps; `lastChangedOn` moves only when a review event happened (D119), and never\n     * backwards: it becomes the later of the stored value and the newest unpulled fact. Cancel\n     * moves it too: D119 does not list cancel, but a cancelled review leaves every list\n     * (`isActive: false`), so this is harmless and keeps the field monotonic.\n     */\n    public prepareForSave(): void {\n        const lastFact = this.facts[this.facts.length - 1];\n        if (lastFact && Date.parse(lastFact.occurredOn) > Date.parse(this.data.lastChangedOn)) {\n            this.data.lastChangedOn = lastFact.occurredOn;\n        }\n\n        const current = this.resolveCurrentStep();\n        if (!current) {\n            // Cancelled (D75): the review leaves every list and the target is unlocked.\n            this.data.isActive = false;\n            this.data.currentStepId = null;\n            this.data.currentStepState = null;\n            this.data.currentStepType = null;\n            this.data.currentOwnerId = null;\n            this.data.currentCandidateTeamIds = [];\n            return;\n        }\n        this.data.isActive = true;\n        this.data.state = Review.deriveState(current);\n        this.data.currentStepId = current.id;\n        this.data.currentStepState = current.state;\n        this.data.currentStepType = current.type;\n        this.data.currentOwnerId = current.owner?.type === \"user\" ? current.owner.id : null;\n        this.data.currentCandidateTeamIds = [...current.candidateTeamIds];\n    }\n\n    /**\n     * `system.workflow` for the target revision (spec 4.5). Derived from the steps, so it does not\n     * depend on `prepareForSave` having run.\n     */\n    public getSystemWorkflow(): ReviewSystemWorkflow | null {\n        const current = this.resolveCurrentStep();\n        if (!current) {\n            return null;\n        }\n        return {\n            workflowId: this.data.workflowId,\n            reviewState: Review.deriveState(current),\n            stepId: current.id,\n            stepName: current.title,\n            stepState: current.state\n        };\n    }\n\n    /** Returns and clears the facts recorded since the last call. */\n    public pullFacts(): ReviewFact[] {\n        return this.facts.splice(0, this.facts.length);\n    }\n\n    private guardStart(params: ReviewActorCheckParams): Result<ReviewStep, ReviewReviewerError> {\n        const current = this.getRequestedStepIn(\"start\", \"awaiting\", params.stepId);\n        if (current.isFail()) {\n            return Result.fail(current.error);\n        }\n        const step = current.value;\n        const reviewer = this.checkReviewer(step, params);\n        if (reviewer.isFail()) {\n            return Result.fail(reviewer.error);\n        }\n        return Result.ok(step);\n    }\n\n    private guardTakeOver(\n        params: ReviewActorCheckParams\n    ): Result<ReviewHeldStep, ReviewTakeOverError> {\n        const current = this.getRequestedStepIn(\"takeOver\", \"inReview\", params.stepId);\n        if (current.isFail()) {\n            return Result.fail(current.error);\n        }\n        const step = current.value;\n        const owner = step.owner;\n        if (!owner || owner.type !== \"user\") {\n            // AI and automation steps cannot be taken over (D9).\n            return Result.fail(\n                new ReviewStepNotTakeableError({\n                    reviewId: this.data.id,\n                    stepId: step.id,\n                    ownerType: owner?.type ?? null\n                })\n            );\n        }\n        const reviewer = this.checkReviewer(step, params);\n        if (reviewer.isFail()) {\n            return Result.fail(reviewer.error);\n        }\n        if (owner.id === params.actor.id) {\n            return Result.fail(\n                new ReviewAlreadyOwnerError({ reviewId: this.data.id, stepId: step.id })\n            );\n        }\n        return Result.ok({ step, owner });\n    }\n\n    /** The current step (if any) of a review that can still be cancelled. */\n    private guardCancel(): Result<ReviewStep | null, ReviewInvalidStateError> {\n        const step = this.findCurrentStep();\n        if (this.data.state !== \"inProgress\") {\n            return Result.fail(this.createInvalidStateError(\"cancel\", step));\n        }\n        return Result.ok(step);\n    }\n\n    private guardReassign(params: ReviewStepParams): Result<ReviewStep, ReviewReassignError> {\n        const awaiting = this.getRequestedStepIn(\"reassign\", \"awaiting\", params.stepId);\n        if (awaiting.isOk()) {\n            return Result.ok(awaiting.value);\n        }\n        const inReview = this.getRequestedStepIn(\"reassign\", \"inReview\", params.stepId);\n        if (inReview.isFail()) {\n            return Result.fail(inReview.error);\n        }\n        const step = inReview.value;\n        if (step.owner?.type !== \"user\") {\n            return Result.fail(\n                new ReviewStepNotReassignableError({\n                    reviewId: this.data.id,\n                    stepId: step.id,\n                    ownerType: step.owner?.type ?? null\n                })\n            );\n        }\n        return Result.ok(step);\n    }\n\n    /** The reassign guard, then the same-owner rule for the chosen user (R126). */\n    private guardReassignTo(\n        params: ReviewReassignToCheckParams\n    ): Result<ReviewStep, ReviewReassignCheckError> {\n        const guard = this.guardReassign(params);\n        if (guard.isFail()) {\n            return Result.fail(guard.error);\n        }\n        const step = guard.value;\n        if (step.owner?.type === \"user\" && step.owner.id === params.userId) {\n            return Result.fail(\n                new ReviewAlreadyOwnerError({ reviewId: this.data.id, stepId: step.id })\n            );\n        }\n        return Result.ok(step);\n    }\n\n    /** The current step when it can fail: `pending`, `inReview`, or already `failed` (R140). */\n    private guardFail(stepId: string): Result<ReviewStep, ReviewFailError> {\n        const step = this.findCurrentStep();\n        if (this.data.state === \"inProgress\" && step && step.id !== stepId) {\n            return Result.fail(\n                new ReviewStepNotCurrentError({\n                    reviewId: this.data.id,\n                    stepId,\n                    currentStepId: step.id\n                })\n            );\n        }\n        const failable =\n            step?.state === \"pending\" || step?.state === \"inReview\" || step?.state === \"failed\";\n        if (this.data.state !== \"inProgress\" || !step || !failable) {\n            return Result.fail(this.createInvalidStateError(\"fail\", step));\n        }\n        return Result.ok(step);\n    }\n\n    /** The current step when it is failed (R140): rejected, in review and the rest are refused. */\n    private guardRestart(params: ReviewStepParams): Result<ReviewStep, ReviewRestartError> {\n        return this.getRequestedStepIn(\"restart\", \"failed\", params.stepId);\n    }\n\n    /** Turns a guard's result into a check's result: same error, no step. */\n    private static toCheck<TError>(guard: Result<unknown, TError>): Result<void, TError> {\n        if (guard.isFail()) {\n            return Result.fail(guard.error);\n        }\n        return Result.ok();\n    }\n\n    /** The first step that is not approved; null when every step is approved. */\n    private findCurrentStep(): ReviewStep | null {\n        return this.data.steps.find(step => step.state !== \"approved\") ?? null;\n    }\n\n    private getCurrentStepIn(\n        transition: ReviewTransitionName,\n        stepState: StepState\n    ): Result<ReviewStep, ReviewInvalidStateError> {\n        const step = this.findCurrentStep();\n        if (this.data.state !== \"inProgress\" || !step || step.state !== stepState) {\n            return Result.fail(this.createInvalidStateError(transition, step));\n        }\n        return Result.ok(step);\n    }\n\n    private createInvalidStateError(\n        transition: ReviewTransitionName,\n        step: ReviewStep | null\n    ): ReviewInvalidStateError {\n        return new ReviewInvalidStateError({\n            reviewId: this.data.id,\n            transition,\n            reviewState: this.data.state,\n            stepId: step?.id ?? null,\n            stepState: step?.state ?? null\n        });\n    }\n\n    /**\n     * Like `getCurrentStepIn`, for transitions that name the step they act on (R17). While the\n     * review is in progress, a `stepId` other than the current step fails with `StepNotCurrent`.\n     */\n    private getRequestedStepIn(\n        transition: ReviewTransitionName,\n        stepState: StepState,\n        stepId: string\n    ): Result<ReviewStep, ReviewInvalidStateError | ReviewStepNotCurrentError> {\n        const current = this.findCurrentStep();\n        if (this.data.state === \"inProgress\" && current && current.id !== stepId) {\n            return Result.fail(\n                new ReviewStepNotCurrentError({\n                    reviewId: this.data.id,\n                    stepId,\n                    currentStepId: current.id\n                })\n            );\n        }\n        return this.getCurrentStepIn(transition, stepState);\n    }\n\n    /** The requester never reviews their own content (spec 5.1): such an owner goes to the pool. */\n    private withoutRequesterOwner(resolution: StepAssignmentResolution): StepAssignmentResolution {\n        const owner = resolution.owner;\n        if (!owner || !this.isRequestedBy(owner)) {\n            return resolution;\n        }\n        return {\n            owner: null,\n            candidateTeamIds: [...resolution.candidateTeamIds],\n            assignment: { source: \"pool\", reason: REQUESTER_OWNER_REASON },\n            // The resolver's skips stay; its outcome is replaced by the pool (R117).\n            records: [\n                ...resolution.records.filter(record => record.kind === \"skip\"),\n                {\n                    kind: \"outcome\",\n                    userId: null,\n                    source: \"pool\",\n                    ruleId: null,\n                    by: null,\n                    reason: REQUESTER_OWNER_REASON\n                }\n            ]\n        };\n    }\n\n    /**\n     * The step the review-level fields and `system.workflow` describe: the first step that is not\n     * approved, else the last step (after approve the last step stays current, after reject the\n     * rejecting step, D75). `null` for cancelled reviews. `request` guarantees at least one step.\n     */\n    private resolveCurrentStep(): ReviewStep | null {\n        if (this.data.state === \"cancelled\") {\n            return null;\n        }\n        return this.findCurrentStep() ?? this.data.steps.at(-1) ?? null;\n    }\n\n    private getOwnedStep(\n        transition: ReviewTransitionName,\n        params: ReviewActorCheckParams\n    ): Result<ReviewStep, ReviewDecisionError> {\n        const current = this.getRequestedStepIn(transition, \"inReview\", params.stepId);\n        if (current.isFail()) {\n            return Result.fail(current.error);\n        }\n        const step = current.value;\n        const actor = params.actor;\n        const owner = step.owner;\n        if (!owner || owner.type !== actor.type || owner.id !== actor.id) {\n            return Result.fail(\n                new ReviewNotOwnerError({ reviewId: this.data.id, stepId: step.id })\n            );\n        }\n        return Result.ok(step);\n    }\n\n    private static deriveState(current: ReviewStep): ReviewState {\n        if (current.state === \"rejected\") {\n            return \"rejected\";\n        }\n        if (current.state === \"approved\") {\n            return \"approved\";\n        }\n        return \"inProgress\";\n    }\n\n    /** Human actions: a user, not the requester, member of the step's candidate teams (spec 5.1). */\n    private checkReviewer(\n        step: ReviewStep,\n        params: ReviewActorCheckParams\n    ): Result<\n        void,\n        ReviewActorNotUserError | ReviewRequesterCannotReviewError | ReviewNotCandidateError\n    > {\n        if (params.actor.type !== \"user\") {\n            return Result.fail(\n                new ReviewActorNotUserError({\n                    reviewId: this.data.id,\n                    stepId: step.id,\n                    actorType: params.actor.type\n                })\n            );\n        }\n        if (this.isRequestedBy(params.actor)) {\n            return Result.fail(\n                new ReviewRequesterCannotReviewError({ reviewId: this.data.id, stepId: step.id })\n            );\n        }\n        const isCandidate = params.actorTeamIds.some(teamId =>\n            step.candidateTeamIds.includes(teamId)\n        );\n        if (!isCandidate) {\n            return Result.fail(\n                new ReviewNotCandidateError({ reviewId: this.data.id, stepId: step.id })\n            );\n        }\n        return Result.ok();\n    }\n}\n"],"names":["REQUESTER_OWNER_REASON","REVIEW_TITLE_MIN_LENGTH","REJECT_COMMENT_MIN_LENGTH","Review","data","structuredClone","params","Result","ReviewValidationError","requestedTitle","picks","Map","pick","step","item","canPickReviewer","steps","review","actor","taskIds","run","current","REVIEW_STEP_TYPE","resolution","guard","previousOwner","comment","issue","ReviewRequesterCannotReviewError","fromState","previousTaskId","lastFact","Date","reviewer","owner","ReviewStepNotTakeableError","ReviewAlreadyOwnerError","awaiting","inReview","ReviewStepNotReassignableError","stepId","ReviewStepNotCurrentError","failable","transition","stepState","ReviewInvalidStateError","record","ReviewNotOwnerError","ReviewActorNotUserError","isCandidate","teamId","ReviewNotCandidateError"],"mappings":";;;;AAgCA,MAAMA,yBACF;AAGG,MAAMC,0BAA0B;AAGhC,MAAMC,4BAA4B;AAsJlC,MAAMC;IAGT,YAAqCC,IAAgB,CAAE;aAAlBA,IAAI,GAAJA;aAFpB,KAAK,GAAiB,EAAE;IAEe;IAExD,OAAc,SAASA,IAAgB,EAAU;QAC7C,OAAO,IAAID,OAAOE,gBAAgBD;IACtC;IAEA,OAAc,QAAQE,MAA2B,EAAyC;QAGtF,IAAI,CAACA,OAAO,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAACA,OAAO,KAAK,GAC7C,OAAOC,OAAO,IAAI,CACd,IAAIC,sBACA,CAAC,cAAc,EAAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,6BAA6B,EAAEA,OAAO,KAAK,CAAC,EAAE,CAAC;QAIjG,IAAIA,AAAiC,MAAjCA,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,EAC5B,OAAOC,OAAO,IAAI,CACd,IAAIC,sBAAsB,CAAC,cAAc,EAAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC;QAGxF,MAAMG,iBAAiBH,OAAO,cAAc,EAAE,UAAU;QACxD,IAAIG,kBAAkBA,eAAe,MAAM,GAAGR,yBAC1C,OAAOM,OAAO,IAAI,CACd,IAAIC,sBACA,CAAC,oCAAoC,EAAEP,wBAAwB,YAAY,CAAC;QAKxF,MAAMS,QAAQ,IAAIC;QAClB,KAAK,MAAMC,QAAQN,OAAO,KAAK,CAAE;YAC7B,MAAMO,OAAOP,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAACQ,CAAAA,OAAQA,KAAK,EAAE,KAAKF,KAAK,MAAM;YACvE,IAAI,CAACC,MACD,OAAON,OAAO,IAAI,CACd,IAAIC,sBACA,CAAC,MAAM,EAAEI,KAAK,MAAM,CAAC,8BAA8B,EAAEN,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAIzF,IAAI,CAACS,gBAAgBF,OACjB,OAAON,OAAO,IAAI,CACd,IAAIC,sBACA,CAAC,MAAM,EAAEK,KAAK,KAAK,CAAC,oCAAoC,CAAC;YAIrE,IAAIH,MAAM,GAAG,CAACG,KAAK,EAAE,GACjB,OAAON,OAAO,IAAI,CACd,IAAIC,sBAAsB,CAAC,MAAM,EAAEK,KAAK,KAAK,CAAC,yBAAyB,CAAC;YAGhFH,MAAM,GAAG,CAACG,KAAK,EAAE,EAAED,KAAK,MAAM;QAClC;QAEA,MAAMI,QAAQV,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAACO,OAAsB;gBAC3D,GAAGR,gBAAgBQ,KAAK;gBACxB,OAAO;gBACP,OAAO;gBACP,SAAS;gBACT,cAAcH,MAAM,GAAG,CAACG,KAAK,EAAE,KAAK;gBACpC,kBAAkB,EAAE;gBACpB,kBAAkB;gBAClB,YAAY;gBACZ,WAAW;gBACX,WAAW;gBACX,YAAY;gBACZ,QAAQ;gBACR,MAAM,EAAE;gBACR,QAAQ,EAAE;YACd;QAEA,MAAMI,SAAS,IAAId,OAAO;YACtB,IAAIG,OAAO,EAAE;YACb,YAAYA,OAAO,QAAQ,CAAC,EAAE;YAC9B,OAAOA,OAAO,KAAK;YACnB,UAAUA,OAAO,QAAQ;YACzB,kBAAkBA,OAAO,gBAAgB;YAEzC,OAAOG,kBAAkBH,OAAO,KAAK;YACrC,UAAU;YACV,OAAO;YACP,eAAe;YACf,kBAAkB;YAClB,iBAAiB;YACjB,gBAAgB;YAChB,yBAAyB,EAAE;YAC3B,eAAeD,gBAAgBC,OAAO,aAAa;YACnD,UAAU;gBACN,MAAMA,OAAO,QAAQ,CAAC,IAAI;gBAC1B,QAAQ;uBAAIA,OAAO,QAAQ,CAAC,MAAM;iBAAC;YACvC;YACAU;YACA,WAAW;gBAAE,GAAGV,OAAO,SAAS;YAAC;YACjC,aAAa;YACb,WAAWA,OAAO,GAAG;YACrB,SAASA,OAAO,GAAG;YACnB,eAAeA,OAAO,GAAG;QAC7B;QACAW,OAAO,KAAK,CAAC,IAAI,CAAC;YACd,MAAM;YACN,YAAYX,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,SAAS;YAAC;QACjC;QACA,OAAOC,OAAO,EAAE,CAACU;IACrB;IAEA,IAAW,KAAa;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE;IACvB;IAOA,IAAW,mBAAkC;QACzC,OAAO,IAAI,CAAC,eAAe,IAAI,MAAM;IACzC;IAEO,SAAqB;QACxB,OAAOZ,gBAAgB,IAAI,CAAC,IAAI;IACpC;IAMO,cAAca,KAAY,EAAW;QACxC,OAAOA,AAAe,WAAfA,MAAM,IAAI,IAAeA,MAAM,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;IACvE;IAGO,mBAAkC;QACrC,MAAML,OAAO,IAAI,CAAC,eAAe;QACjC,IAAI,CAACA,QAAQA,AAAe,eAAfA,KAAK,KAAK,EACnB,OAAO;QAEX,OAAOA,KAAK,MAAM;IACtB;IAMO,aAAuB;QAC1B,MAAMM,UAAoB,EAAE;QAC5B,KAAK,MAAMN,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAE;YAChC,KAAK,MAAMO,OAAOP,KAAK,IAAI,CACvB,IAAIO,IAAI,MAAM,EACVD,QAAQ,IAAI,CAACC,IAAI,MAAM;YAG/B,IAAIP,KAAK,MAAM,EACXM,QAAQ,IAAI,CAACN,KAAK,MAAM;QAEhC;QACA,OAAOM;IACX;IAGO,iBAAoC;QACvC,IAAI,AAAoB,iBAApB,IAAI,CAAC,IAAI,CAAC,KAAK,EACf,OAAO;QAEX,MAAMN,OAAO,IAAI,CAAC,eAAe;QACjC,IAAI,CAACA,QAAQA,AAAe,cAAfA,KAAK,KAAK,EACnB,OAAO;QAEX,OAAOR,gBAAgBQ;IAC3B;IAGO,MAAMP,MAAyB,EAAyC;QAC3E,MAAMe,UAAU,IAAI,CAAC,gBAAgB,CAAC,SAAS;QAC/C,IAAIA,QAAQ,MAAM,IACd,OAAOd,OAAO,IAAI,CAACc,QAAQ,KAAK;QAEpC,MAAMR,OAAOQ,QAAQ,KAAK;QAC1B,IAAIR,KAAK,IAAI,KAAKS,kBACd,OAAOf,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAASM;QAE7D,MAAMU,aAAa,IAAI,CAAC,qBAAqB,CAACjB,OAAO,UAAU;QAE/DO,KAAK,gBAAgB,GAAG;eAAIU,WAAW,gBAAgB;SAAC;QACxDV,KAAK,UAAU,GAAGR,gBAAgBkB,WAAW,UAAU;QACvDV,KAAK,gBAAgB,GAAGU,WAAW,UAAU,CAAC,MAAM;QACpDV,KAAK,SAAS,GAAGP,OAAO,GAAG;QAC3B,IAAIiB,WAAW,KAAK,EAAE;YAClBV,KAAK,KAAK,GAAG;gBAAE,GAAGU,WAAW,KAAK;YAAC;YACnCV,KAAK,KAAK,GAAG;YACbA,KAAK,SAAS,GAAGP,OAAO,GAAG;QAC/B,OAAO;YACHO,KAAK,KAAK,GAAG;YACbA,KAAK,KAAK,GAAG;QACjB;QAEA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYP,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,OAAOO,KAAK,KAAK,GAAG;gBAAE,GAAGA,KAAK,KAAK;YAAC,IAAI;YACxC,QAAQ;gBAAE,QAAQA,KAAK,EAAE;gBAAE,WAAW;gBAAW,SAASA,KAAK,KAAK;YAAC;YACrE,YAAYR,gBAAgBkB,WAAW,UAAU;YACjD,QAAQ;YACR,SAASlB,gBAAgBkB,WAAW,OAAO;QAC/C;QACA,OAAOhB,OAAO,EAAE;IACpB;IAOO,SAASD,MAA4B,EAAyC;QACjF,MAAMe,UAAU,IAAI,CAAC,gBAAgB,CAAC,SAAS;QAC/C,IAAIA,QAAQ,MAAM,IACd,OAAOd,OAAO,IAAI,CAACc,QAAQ,KAAK;QAEpC,MAAMR,OAAOQ,QAAQ,KAAK;QAC1B,IAAIR,KAAK,IAAI,KAAKS,kBACd,OAAOf,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAASM;QAG7DA,KAAK,gBAAgB,GAAG,EAAE;QAC1BA,KAAK,UAAU,GAAG;QAClBA,KAAK,gBAAgB,GAAG;QACxBA,KAAK,KAAK,GAAG;YAAE,GAAGP,OAAO,KAAK;QAAC;QAC/BO,KAAK,KAAK,GAAG;QACbA,KAAK,SAAS,GAAGP,OAAO,GAAG;QAC3BO,KAAK,SAAS,GAAGP,OAAO,GAAG;QAC3BO,KAAK,MAAM,GAAGP,OAAO,MAAM;QAE3B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYA,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,QAAQ;gBAAE,QAAQO,KAAK,EAAE;gBAAE,WAAW;gBAAW,SAAS;YAAW;YACrE,YAAY;YACZ,QAAQP,OAAO,MAAM;YACrB,SAAS,EAAE;QACf;QACA,OAAOC,OAAO,EAAE;IACpB;IAEO,WAAWD,MAA8B,EAAqC;QACjF,OAAOH,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,CAACG;IAC1C;IAEO,MAAMA,MAAyB,EAAqC;QACvE,MAAMkB,QAAQ,IAAI,CAAC,UAAU,CAAClB;QAC9B,IAAIkB,MAAM,MAAM,IACZ,OAAOjB,OAAO,IAAI,CAACiB,MAAM,KAAK;QAElC,MAAMX,OAAOW,MAAM,KAAK;QAExBX,KAAK,KAAK,GAAG;YAAE,GAAGP,OAAO,KAAK;QAAC;QAC/BO,KAAK,KAAK,GAAG;QACbA,KAAK,SAAS,GAAGP,OAAO,GAAG;QAC3BO,KAAK,gBAAgB,GAAG;QACxBA,KAAK,UAAU,GAAG;YAAE,QAAQ;QAAY;QAExC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYP,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,QAAQ;gBAAE,QAAQO,KAAK,EAAE;gBAAE,WAAW;gBAAY,SAAS;YAAW;YACtE,SAAS;gBACL;oBACI,MAAM;oBACN,QAAQP,OAAO,KAAK,CAAC,EAAE;oBACvB,QAAQ;oBACR,QAAQ;oBACR,IAAI;oBACJ,QAAQ;gBACZ;aACH;QACL;QACA,OAAOC,OAAO,EAAE;IACpB;IAEO,cAAcD,MAA8B,EAAqC;QACpF,OAAOH,OAAO,OAAO,CAAC,IAAI,CAAC,aAAa,CAACG;IAC7C;IAEO,SAASA,MAA4B,EAAqC;QAC7E,MAAMkB,QAAQ,IAAI,CAAC,aAAa,CAAClB;QACjC,IAAIkB,MAAM,MAAM,IACZ,OAAOjB,OAAO,IAAI,CAACiB,MAAM,KAAK;QAElC,MAAM,EAAEX,IAAI,EAAE,OAAOY,aAAa,EAAE,GAAGD,MAAM,KAAK;QAElDX,KAAK,KAAK,GAAG;YAAE,GAAGP,OAAO,KAAK;QAAC;QAC/BO,KAAK,gBAAgB,GAAG;QACxBA,KAAK,UAAU,GAAG;YAAE,QAAQ;YAAY,IAAI;gBAAE,GAAGP,OAAO,KAAK;YAAC;QAAE;QAEhE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYA,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,QAAQ;gBAAE,QAAQO,KAAK,EAAE;gBAAE,WAAW;gBAAY,SAAS;YAAW;YACtE,eAAe;gBAAE,GAAGY,aAAa;YAAC;YAClC,qBAAqBnB,OAAO,mBAAmB,IAAI;YACnD,SAAS;gBACL;oBACI,MAAM;oBACN,QAAQA,OAAO,KAAK,CAAC,EAAE;oBACvB,QAAQ;oBACR,QAAQ;oBACR,IAAI;wBAAE,GAAGA,OAAO,KAAK;oBAAC;oBACtB,QAAQ;gBACZ;aACH;QACL;QACA,OAAOC,OAAO,EAAE;IACpB;IAEO,aAAaD,MAA8B,EAAqC;QACnF,OAAOH,OAAO,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,WAAWG;IACvD;IAMO,QAAQA,MAA4B,EAAqC;QAC5E,MAAMe,UAAU,IAAI,CAAC,YAAY,CAAC,WAAWf;QAC7C,IAAIe,QAAQ,MAAM,IACd,OAAOd,OAAO,IAAI,CAACc,QAAQ,KAAK;QAEpC,MAAMR,OAAOQ,QAAQ,KAAK;QAC1B,MAAMK,UAAUpB,OAAO,OAAO,EAAE,UAAU;QAE1CO,KAAK,KAAK,GAAG;QACbA,KAAK,OAAO,GAAGa;QACfb,KAAK,MAAM,GAAIP,AAAAA,CAAAA,OAAO,MAAM,IAAI,EAAC,EAAG,GAAG,CAACqB,CAAAA,QAAU;gBAAE,GAAGA,KAAK;YAAC;QAC7Dd,KAAK,UAAU,GAAGP,OAAO,GAAG;QAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYA,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,QAAQ;gBAAE,QAAQO,KAAK,EAAE;gBAAE,WAAW;gBAAY,SAAS;YAAW;YACtEa;QACJ;QAEA,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAACZ,CAAAA,OAAQA,AAAe,eAAfA,KAAK,KAAK,GAAkB;YAC1D,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG;YAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBACZ,MAAM;gBACN,YAAYR,OAAO,GAAG;gBACtB,OAAO;oBAAE,GAAGA,OAAO,KAAK;gBAAC;YAC7B;QACJ;QACA,OAAOC,OAAO,EAAE;IACpB;IAEO,YAAYD,MAA8B,EAAqC;QAClF,OAAOH,OAAO,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,UAAUG;IACtD;IAOO,OAAOA,MAA4B,EAAmC;QACzE,MAAMe,UAAU,IAAI,CAAC,YAAY,CAAC,UAAUf;QAC5C,IAAIe,QAAQ,MAAM,IACd,OAAOd,OAAO,IAAI,CAACc,QAAQ,KAAK;QAEpC,MAAMK,UAAUpB,OAAO,OAAO,EAAE,UAAU;QAC1C,IAAIoB,QAAQ,MAAM,GAAGxB,2BACjB,OAAOK,OAAO,IAAI,CACd,IAAIC,sBACA,CAAC,wCAAwC,EAAEN,0BAA0B,YAAY,CAAC;QAI9F,MAAMW,OAAOQ,QAAQ,KAAK;QAE1BR,KAAK,KAAK,GAAG;QACbA,KAAK,OAAO,GAAGa;QACfb,KAAK,MAAM,GAAIP,AAAAA,CAAAA,OAAO,MAAM,IAAI,EAAC,EAAG,GAAG,CAACqB,CAAAA,QAAU;gBAAE,GAAGA,KAAK;YAAC;QAC7Dd,KAAK,UAAU,GAAGP,OAAO,GAAG;QAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG;QAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYA,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,QAAQ;gBAAE,QAAQO,KAAK,EAAE;gBAAE,WAAW;gBAAY,SAAS;YAAW;YACtEa;QACJ;QACA,OAAOnB,OAAO,EAAE;IACpB;IAEO,cAAqD;QACxD,OAAOJ,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW;IAC1C;IAMO,OAAOG,MAA0B,EAAyC;QAC7E,MAAMkB,QAAQ,IAAI,CAAC,WAAW;QAC9B,IAAIA,MAAM,MAAM,IACZ,OAAOjB,OAAO,IAAI,CAACiB,MAAM,KAAK;QAElC,MAAMX,OAAOW,MAAM,KAAK;QAExB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG;QAClB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG;YAAE,GAAGlB,OAAO,KAAK;QAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYA,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,QAAQO,MAAM,MAAM;YACpB,WAAWA,MAAM,SAAS;YAC1B,QAAQP,OAAO,MAAM,IAAI;QAC7B;QACA,OAAOC,OAAO,EAAE;IACpB;IAMO,cAAcD,MAAwB,EAAqC;QAC9E,OAAOH,OAAO,OAAO,CAAC,IAAI,CAAC,aAAa,CAACG;IAC7C;IAMO,gBACHA,MAAmC,EACG;QACtC,OAAOH,OAAO,OAAO,CAAC,IAAI,CAAC,eAAe,CAACG;IAC/C;IAQO,SAASA,MAA4B,EAA+C;QACvF,MAAMkB,QAAQ,IAAI,CAAC,eAAe,CAAC;YAAE,QAAQlB,OAAO,MAAM;YAAE,QAAQA,OAAO,KAAK,CAAC,EAAE;QAAC;QACpF,IAAIkB,MAAM,MAAM,IACZ,OAAOjB,OAAO,IAAI,CAACiB,MAAM,KAAK;QAElC,MAAMX,OAAOW,MAAM,KAAK;QACxB,IAAI,IAAI,CAAC,aAAa,CAAClB,OAAO,KAAK,GAC/B,OAAOC,OAAO,IAAI,CACd,IAAIqB,iCAAiC;YAAE,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,QAAQf,KAAK,EAAE;QAAC;QAGvF,MAAMY,gBAAgBZ,KAAK,KAAK;QAChC,MAAMgB,YAAYhB,KAAK,KAAK;QAE5BA,KAAK,KAAK,GAAG;YAAE,GAAGP,OAAO,KAAK;QAAC;QAC/B,IAAIuB,AAAc,eAAdA,WAA0B;YAC1BhB,KAAK,KAAK,GAAG;YACbA,KAAK,SAAS,GAAGP,OAAO,GAAG;QAC/B;QACAO,KAAK,gBAAgB,GAAG;QACxBA,KAAK,UAAU,GAAG;YAAE,QAAQ;YAAY,IAAI;gBAAE,GAAGP,OAAO,KAAK;YAAC;QAAE;QAEhE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYA,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,QAAQ;gBAAE,QAAQO,KAAK,EAAE;gBAAEgB;gBAAW,SAAS;YAAW;YAC1D,OAAO;gBAAE,GAAGvB,OAAO,KAAK;YAAC;YACzB,eAAemB,gBAAgB;gBAAE,GAAGA,aAAa;YAAC,IAAI;YACtD,SAAS;gBACL;oBACI,MAAM;oBACN,QAAQnB,OAAO,KAAK,CAAC,EAAE;oBACvB,QAAQ;oBACR,QAAQ;oBACR,IAAI;wBAAE,GAAGA,OAAO,KAAK;oBAAC;oBACtB,QAAQ;gBACZ;aACH;QACL;QACA,OAAOC,OAAO,EAAE;IACpB;IAQO,KAAKD,MAAwB,EAAiC;QACjE,MAAMkB,QAAQ,IAAI,CAAC,SAAS,CAAClB,OAAO,MAAM;QAC1C,IAAIkB,MAAM,MAAM,IACZ,OAAOjB,OAAO,IAAI,CAACiB,MAAM,KAAK;QAElC,MAAMX,OAAOW,MAAM,KAAK;QACxB,IAAIX,AAAe,aAAfA,KAAK,KAAK,EACV,OAAON,OAAO,EAAE;QAEpB,MAAMsB,YAAYhB,KAAK,KAAK;QAE5BA,KAAK,KAAK,GAAG;QACbA,KAAK,OAAO,GAAGP,OAAO,MAAM;QAC5BO,KAAK,UAAU,GAAGP,OAAO,GAAG;QAE5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYA,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAIO,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE;YAChD,QAAQ;gBAAE,QAAQA,KAAK,EAAE;gBAAEgB;gBAAW,SAAS;YAAS;YACxD,QAAQvB,OAAO,MAAM;QACzB;QACA,OAAOC,OAAO,EAAE;IACpB;IAOO,aAAaD,MAAwB,EAAoC;QAC5E,OAAOH,OAAO,OAAO,CAAC,IAAI,CAAC,YAAY,CAACG;IAC5C;IAOO,QAAQA,MAA2B,EAAoC;QAC1E,MAAMkB,QAAQ,IAAI,CAAC,YAAY,CAAClB;QAChC,IAAIkB,MAAM,MAAM,IACZ,OAAOjB,OAAO,IAAI,CAACiB,MAAM,KAAK;QAElC,MAAMX,OAAOW,MAAM,KAAK;QACxB,MAAMM,iBAAiBjB,KAAK,MAAM;QAElCA,KAAK,IAAI,CAAC,IAAI,CAAC;YACX,QAAQA,KAAK,MAAM;YACnB,WAAWA,KAAK,SAAS,IAAIA,KAAK,SAAS,IAAIA,KAAK,UAAU,IAAIP,OAAO,GAAG;YAC5E,YAAYO,KAAK,UAAU;YAC3B,SAAS;YACT,QAAQA,KAAK,OAAO;QACxB;QACAA,KAAK,KAAK,GAAG;QACbA,KAAK,OAAO,GAAG;QACfA,KAAK,MAAM,GAAG;QACdA,KAAK,MAAM,GAAG,EAAE;QAChBA,KAAK,SAAS,GAAG;QACjBA,KAAK,SAAS,GAAG;QACjBA,KAAK,UAAU,GAAG;QAElB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,YAAYP,OAAO,GAAG;YACtB,OAAO;gBAAE,GAAGA,OAAO,KAAK;YAAC;YACzB,QAAQ;gBAAE,QAAQO,KAAK,EAAE;gBAAE,WAAW;gBAAU,SAAS;YAAU;YACnEiB;QACJ;QACA,OAAOvB,OAAO,EAAE;IACpB;IASO,iBAAuB;QAC1B,MAAMwB,WAAW,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE;QAClD,IAAIA,YAAYC,KAAK,KAAK,CAACD,SAAS,UAAU,IAAIC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,GAChF,IAAI,CAAC,IAAI,CAAC,aAAa,GAAGD,SAAS,UAAU;QAGjD,MAAMV,UAAU,IAAI,CAAC,kBAAkB;QACvC,IAAI,CAACA,SAAS;YAEV,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG;YACrB,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG;YAC1B,IAAI,CAAC,IAAI,CAAC,gBAAgB,GAAG;YAC7B,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG;YAC5B,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG;YAC3B,IAAI,CAAC,IAAI,CAAC,uBAAuB,GAAG,EAAE;YACtC;QACJ;QACA,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG;QACrB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAGlB,OAAO,WAAW,CAACkB;QACrC,IAAI,CAAC,IAAI,CAAC,aAAa,GAAGA,QAAQ,EAAE;QACpC,IAAI,CAAC,IAAI,CAAC,gBAAgB,GAAGA,QAAQ,KAAK;QAC1C,IAAI,CAAC,IAAI,CAAC,eAAe,GAAGA,QAAQ,IAAI;QACxC,IAAI,CAAC,IAAI,CAAC,cAAc,GAAGA,QAAQ,KAAK,EAAE,SAAS,SAASA,QAAQ,KAAK,CAAC,EAAE,GAAG;QAC/E,IAAI,CAAC,IAAI,CAAC,uBAAuB,GAAG;eAAIA,QAAQ,gBAAgB;SAAC;IACrE;IAMO,oBAAiD;QACpD,MAAMA,UAAU,IAAI,CAAC,kBAAkB;QACvC,IAAI,CAACA,SACD,OAAO;QAEX,OAAO;YACH,YAAY,IAAI,CAAC,IAAI,CAAC,UAAU;YAChC,aAAalB,OAAO,WAAW,CAACkB;YAChC,QAAQA,QAAQ,EAAE;YAClB,UAAUA,QAAQ,KAAK;YACvB,WAAWA,QAAQ,KAAK;QAC5B;IACJ;IAGO,YAA0B;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM;IACjD;IAEQ,WAAWf,MAA8B,EAA2C;QACxF,MAAMe,UAAU,IAAI,CAAC,kBAAkB,CAAC,SAAS,YAAYf,OAAO,MAAM;QAC1E,IAAIe,QAAQ,MAAM,IACd,OAAOd,OAAO,IAAI,CAACc,QAAQ,KAAK;QAEpC,MAAMR,OAAOQ,QAAQ,KAAK;QAC1B,MAAMY,WAAW,IAAI,CAAC,aAAa,CAACpB,MAAMP;QAC1C,IAAI2B,SAAS,MAAM,IACf,OAAO1B,OAAO,IAAI,CAAC0B,SAAS,KAAK;QAErC,OAAO1B,OAAO,EAAE,CAACM;IACrB;IAEQ,cACJP,MAA8B,EACa;QAC3C,MAAMe,UAAU,IAAI,CAAC,kBAAkB,CAAC,YAAY,YAAYf,OAAO,MAAM;QAC7E,IAAIe,QAAQ,MAAM,IACd,OAAOd,OAAO,IAAI,CAACc,QAAQ,KAAK;QAEpC,MAAMR,OAAOQ,QAAQ,KAAK;QAC1B,MAAMa,QAAQrB,KAAK,KAAK;QACxB,IAAI,CAACqB,SAASA,AAAe,WAAfA,MAAM,IAAI,EAEpB,OAAO3B,OAAO,IAAI,CACd,IAAI4B,2BAA2B;YAC3B,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YACtB,QAAQtB,KAAK,EAAE;YACf,WAAWqB,OAAO,QAAQ;QAC9B;QAGR,MAAMD,WAAW,IAAI,CAAC,aAAa,CAACpB,MAAMP;QAC1C,IAAI2B,SAAS,MAAM,IACf,OAAO1B,OAAO,IAAI,CAAC0B,SAAS,KAAK;QAErC,IAAIC,MAAM,EAAE,KAAK5B,OAAO,KAAK,CAAC,EAAE,EAC5B,OAAOC,OAAO,IAAI,CACd,IAAI6B,wBAAwB;YAAE,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,QAAQvB,KAAK,EAAE;QAAC;QAG9E,OAAON,OAAO,EAAE,CAAC;YAAEM;YAAMqB;QAAM;IACnC;IAGQ,cAAkE;QACtE,MAAMrB,OAAO,IAAI,CAAC,eAAe;QACjC,IAAI,AAAoB,iBAApB,IAAI,CAAC,IAAI,CAAC,KAAK,EACf,OAAON,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,UAAUM;QAE9D,OAAON,OAAO,EAAE,CAACM;IACrB;IAEQ,cAAcP,MAAwB,EAA2C;QACrF,MAAM+B,WAAW,IAAI,CAAC,kBAAkB,CAAC,YAAY,YAAY/B,OAAO,MAAM;QAC9E,IAAI+B,SAAS,IAAI,IACb,OAAO9B,OAAO,EAAE,CAAC8B,SAAS,KAAK;QAEnC,MAAMC,WAAW,IAAI,CAAC,kBAAkB,CAAC,YAAY,YAAYhC,OAAO,MAAM;QAC9E,IAAIgC,SAAS,MAAM,IACf,OAAO/B,OAAO,IAAI,CAAC+B,SAAS,KAAK;QAErC,MAAMzB,OAAOyB,SAAS,KAAK;QAC3B,IAAIzB,KAAK,KAAK,EAAE,SAAS,QACrB,OAAON,OAAO,IAAI,CACd,IAAIgC,+BAA+B;YAC/B,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YACtB,QAAQ1B,KAAK,EAAE;YACf,WAAWA,KAAK,KAAK,EAAE,QAAQ;QACnC;QAGR,OAAON,OAAO,EAAE,CAACM;IACrB;IAGQ,gBACJP,MAAmC,EACS;QAC5C,MAAMkB,QAAQ,IAAI,CAAC,aAAa,CAAClB;QACjC,IAAIkB,MAAM,MAAM,IACZ,OAAOjB,OAAO,IAAI,CAACiB,MAAM,KAAK;QAElC,MAAMX,OAAOW,MAAM,KAAK;QACxB,IAAIX,KAAK,KAAK,EAAE,SAAS,UAAUA,KAAK,KAAK,CAAC,EAAE,KAAKP,OAAO,MAAM,EAC9D,OAAOC,OAAO,IAAI,CACd,IAAI6B,wBAAwB;YAAE,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,QAAQvB,KAAK,EAAE;QAAC;QAG9E,OAAON,OAAO,EAAE,CAACM;IACrB;IAGQ,UAAU2B,MAAc,EAAuC;QACnE,MAAM3B,OAAO,IAAI,CAAC,eAAe;QACjC,IAAI,AAAoB,iBAApB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAqBA,QAAQA,KAAK,EAAE,KAAK2B,QACxD,OAAOjC,OAAO,IAAI,CACd,IAAIkC,0BAA0B;YAC1B,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YACtBD;YACA,eAAe3B,KAAK,EAAE;QAC1B;QAGR,MAAM6B,WACF7B,MAAM,UAAU,aAAaA,MAAM,UAAU,cAAcA,MAAM,UAAU;QAC/E,IAAI,AAAoB,iBAApB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAqB,CAACA,QAAQ,CAAC6B,UAC9C,OAAOnC,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,QAAQM;QAE5D,OAAON,OAAO,EAAE,CAACM;IACrB;IAGQ,aAAaP,MAAwB,EAA0C;QACnF,OAAO,IAAI,CAAC,kBAAkB,CAAC,WAAW,UAAUA,OAAO,MAAM;IACrE;IAGA,OAAe,QAAgBkB,KAA8B,EAAwB;QACjF,IAAIA,MAAM,MAAM,IACZ,OAAOjB,OAAO,IAAI,CAACiB,MAAM,KAAK;QAElC,OAAOjB,OAAO,EAAE;IACpB;IAGQ,kBAAqC;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAACM,CAAAA,OAAQA,AAAe,eAAfA,KAAK,KAAK,KAAoB;IACtE;IAEQ,iBACJ8B,UAAgC,EAChCC,SAAoB,EACuB;QAC3C,MAAM/B,OAAO,IAAI,CAAC,eAAe;QACjC,IAAI,AAAoB,iBAApB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAqB,CAACA,QAAQA,KAAK,KAAK,KAAK+B,WAC5D,OAAOrC,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAACoC,YAAY9B;QAEhE,OAAON,OAAO,EAAE,CAACM;IACrB;IAEQ,wBACJ8B,UAAgC,EAChC9B,IAAuB,EACA;QACvB,OAAO,IAAIgC,wBAAwB;YAC/B,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YACtBF;YACA,aAAa,IAAI,CAAC,IAAI,CAAC,KAAK;YAC5B,QAAQ9B,MAAM,MAAM;YACpB,WAAWA,MAAM,SAAS;QAC9B;IACJ;IAMQ,mBACJ8B,UAAgC,EAChCC,SAAoB,EACpBJ,MAAc,EACyD;QACvE,MAAMnB,UAAU,IAAI,CAAC,eAAe;QACpC,IAAI,AAAoB,iBAApB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAqBA,WAAWA,QAAQ,EAAE,KAAKmB,QAC9D,OAAOjC,OAAO,IAAI,CACd,IAAIkC,0BAA0B;YAC1B,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YACtBD;YACA,eAAenB,QAAQ,EAAE;QAC7B;QAGR,OAAO,IAAI,CAAC,gBAAgB,CAACsB,YAAYC;IAC7C;IAGQ,sBAAsBrB,UAAoC,EAA4B;QAC1F,MAAMW,QAAQX,WAAW,KAAK;QAC9B,IAAI,CAACW,SAAS,CAAC,IAAI,CAAC,aAAa,CAACA,QAC9B,OAAOX;QAEX,OAAO;YACH,OAAO;YACP,kBAAkB;mBAAIA,WAAW,gBAAgB;aAAC;YAClD,YAAY;gBAAE,QAAQ;gBAAQ,QAAQvB;YAAuB;YAE7D,SAAS;mBACFuB,WAAW,OAAO,CAAC,MAAM,CAACuB,CAAAA,SAAUA,AAAgB,WAAhBA,OAAO,IAAI;gBAClD;oBACI,MAAM;oBACN,QAAQ;oBACR,QAAQ;oBACR,QAAQ;oBACR,IAAI;oBACJ,QAAQ9C;gBACZ;aACH;QACL;IACJ;IAOQ,qBAAwC;QAC5C,IAAI,AAAoB,gBAApB,IAAI,CAAC,IAAI,CAAC,KAAK,EACf,OAAO;QAEX,OAAO,IAAI,CAAC,eAAe,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO;IAC/D;IAEQ,aACJ2C,UAAgC,EAChCrC,MAA8B,EACS;QACvC,MAAMe,UAAU,IAAI,CAAC,kBAAkB,CAACsB,YAAY,YAAYrC,OAAO,MAAM;QAC7E,IAAIe,QAAQ,MAAM,IACd,OAAOd,OAAO,IAAI,CAACc,QAAQ,KAAK;QAEpC,MAAMR,OAAOQ,QAAQ,KAAK;QAC1B,MAAMH,QAAQZ,OAAO,KAAK;QAC1B,MAAM4B,QAAQrB,KAAK,KAAK;QACxB,IAAI,CAACqB,SAASA,MAAM,IAAI,KAAKhB,MAAM,IAAI,IAAIgB,MAAM,EAAE,KAAKhB,MAAM,EAAE,EAC5D,OAAOX,OAAO,IAAI,CACd,IAAIwC,oBAAoB;YAAE,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,QAAQlC,KAAK,EAAE;QAAC;QAG1E,OAAON,OAAO,EAAE,CAACM;IACrB;IAEA,OAAe,YAAYQ,OAAmB,EAAe;QACzD,IAAIA,AAAkB,eAAlBA,QAAQ,KAAK,EACb,OAAO;QAEX,IAAIA,AAAkB,eAAlBA,QAAQ,KAAK,EACb,OAAO;QAEX,OAAO;IACX;IAGQ,cACJR,IAAgB,EAChBP,MAA8B,EAIhC;QACE,IAAIA,AAAsB,WAAtBA,OAAO,KAAK,CAAC,IAAI,EACjB,OAAOC,OAAO,IAAI,CACd,IAAIyC,wBAAwB;YACxB,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YACtB,QAAQnC,KAAK,EAAE;YACf,WAAWP,OAAO,KAAK,CAAC,IAAI;QAChC;QAGR,IAAI,IAAI,CAAC,aAAa,CAACA,OAAO,KAAK,GAC/B,OAAOC,OAAO,IAAI,CACd,IAAIqB,iCAAiC;YAAE,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,QAAQf,KAAK,EAAE;QAAC;QAGvF,MAAMoC,cAAc3C,OAAO,YAAY,CAAC,IAAI,CAAC4C,CAAAA,SACzCrC,KAAK,gBAAgB,CAAC,QAAQ,CAACqC;QAEnC,IAAI,CAACD,aACD,OAAO1C,OAAO,IAAI,CACd,IAAI4C,wBAAwB;YAAE,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,QAAQtC,KAAK,EAAE;QAAC;QAG9E,OAAON,OAAO,EAAE;IACpB;AACJ"}

package/domain/review/ReviewStepRunInfo.d.ts

@@ -0,0 +1,18 @@
+import type { StepRunOutcome } from "./types.js";
+/** How the background task of a step attempt stands, in workflows' own words (R257). */
+export type StepRunTaskStatus = "pending" | "running" | "done" | "failed" | "aborted";
+/**
+ * What workflows shows about one attempt of an AI or automation step (R257, D161): enough to tell
+ * whether it went wrong or ok, and nothing else. Never the task's input, output or logs, and
+ * never a raw error (R146): `reason` is the fixed text the review stored.
+ */
+export interface ReviewStepRunInfo {
+    taskId: string;
+    status: StepRunTaskStatus;
+    startedOn: string | null;
+    finishedOn: string | null;
+    /** How many times the step's runner ran; the waits for the task id are not counted. */
+    iterations: number;
+    outcome: StepRunOutcome | null;
+    reason: string | null;
+}

package/domain/review/abstractions/ReviewModelProvider.d.ts

@@ -0,0 +1,9 @@
+import type { CmsModel } from "@webiny/api-headless-cms/types/index.js";
+export interface IReviewModelProvider {
+    get(): Promise<CmsModel>;
+}
+/** Provides the tenant's `wbyWorkflowReview` model on demand. */
+export declare const ReviewModelProvider: import("@webiny/di").Abstraction<IReviewModelProvider>;
+export declare namespace ReviewModelProvider {
+    type Interface = IReviewModelProvider;
+}

package/domain/review/abstractions/ReviewModelProvider.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const ReviewModelProvider = createAbstraction("ReviewModelProvider");
+export { ReviewModelProvider };
+
+//# sourceMappingURL=ReviewModelProvider.js.map

package/domain/review/abstractions/ReviewModelProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/review/abstractions/ReviewModelProvider.js","sources":["../../../../src/domain/review/abstractions/ReviewModelProvider.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { CmsModel } from \"@webiny/api-headless-cms/types/index.js\";\n\nexport interface IReviewModelProvider {\n    get(): Promise<CmsModel>;\n}\n\n/** Provides the tenant's `wbyWorkflowReview` model on demand. */\nexport const ReviewModelProvider = createAbstraction<IReviewModelProvider>(\"ReviewModelProvider\");\n\nexport namespace ReviewModelProvider {\n    export type Interface = IReviewModelProvider;\n}\n"],"names":["ReviewModelProvider","createAbstraction"],"mappings":";AAQO,MAAMA,sBAAsBC,kBAAwC"}

package/domain/review/abstractions/ReviewRepository.d.ts

@@ -0,0 +1,122 @@
+import { type Result } from "@webiny/feature/api";
+import type { CmsEntryMeta } from "@webiny/api-headless-cms/types/index.js";
+import type { ReviewData, ReviewListReadFilter, ReviewListSort, ReviewState, StepState } from "../types.js";
+import type { ReviewNotFoundError, ReviewPersistenceError } from "../errors.js";
+export interface ReviewRepositoryActiveByTargetParams {
+    model: string;
+    targetRevisionId: string;
+}
+export interface ReviewRepositoryByTargetParams {
+    model: string;
+    targetId: string;
+    /** Only the reviews of this revision; every revision when omitted. */
+    targetRevisionId?: string;
+    /** Only the reviews in this state; every state when omitted. */
+    state?: ReviewState;
+}
+export interface ReviewRepositoryByTargetsParams {
+    model: string;
+    /** Target ids (entry ids, not revision ids); an empty list returns no reviews. */
+    targetIds: string[];
+    /** Only the reviews in this state; every state when omitted. */
+    state?: ReviewState;
+}
+/**
+ * Storage pre-filter of the review lists (R91). Keys combine with AND; omitted keys do not
+ * restrict. `ListReviewsUseCase` checks every condition again in code on the primary row (R18).
+ */
+export interface ReviewRepositoryListWhere {
+    /**
+     * What the viewer may read (Q77). No readable namespace (`models` and `ownOnlyModels` both
+     * empty) matches nothing and is answered without a query.
+     */
+    read: ReviewListReadFilter;
+    isActive?: boolean;
+    state?: ReviewState;
+    currentStepState?: StepState;
+    currentOwnerId?: string;
+    currentOwnerId_not?: string;
+    /** Any shared team; an empty list matches nothing and is answered without a query. */
+    currentCandidateTeamIds_in?: string[];
+    currentStepType_in?: string[];
+    /** The requester's id (stored as `requester.id`). */
+    requesterId?: string;
+    requesterId_not?: string;
+    title_contains?: string;
+    /** Changed at or after this time (ISO); where an ascending list cursor resumes. */
+    lastChangedOn_gte?: string;
+    /** Changed at or before this time (ISO); where a descending list cursor resumes. */
+    lastChangedOn_lte?: string;
+    /** Review ids to leave out; the rows a list cursor already examined at its time. */
+    id_not_in?: string[];
+}
+export interface ReviewRepositoryListParams {
+    where: ReviewRepositoryListWhere;
+    sort: ReviewListSort;
+    limit: number;
+    /** `meta.cursor` of the previous page. */
+    after?: string | null;
+}
+export interface ReviewRepositoryListResult {
+    items: ReviewData[];
+    meta: CmsEntryMeta;
+}
+export interface IReviewRepository {
+    get(id: string): Promise<Result<ReviewData, ReviewNotFoundError | ReviewPersistenceError>>;
+    /**
+     * Reviews by id from primary storage in one batch read (Q78), in the order of `ids`. Ids with
+     * no review are left out, so the result can be shorter than `ids`.
+     */
+    getMany(ids: string[]): Promise<Result<ReviewData[], ReviewPersistenceError>>;
+    /** At most one active review per target revision (D23). */
+    getActiveByTarget(params: ReviewRepositoryActiveByTargetParams): Promise<Result<ReviewData | null, ReviewPersistenceError>>;
+    /**
+     * The distinct namespaces of the active reviews (e.g. "cms.article", "wb.page"), in one query:
+     * the only rows the review lists return. A namespace missing here has no list row.
+     */
+    listReviewedModels(): Promise<Result<string[], ReviewPersistenceError>>;
+    /** Every in-progress review of a workflow, confirmed from primary storage (R18). */
+    listInProgressByWorkflow(workflowId: string): Promise<Result<ReviewData[], ReviewPersistenceError>>;
+    /**
+     * Active reviews whose current step is in review, owned by any of these users, in every
+     * namespace (least-loaded load, R115). Index rows, not confirmed from primary storage: a
+     * stale row only shifts a load count (A46). An empty list returns no reviews.
+     */
+    listInReviewByOwners(ownerIds: string[]): Promise<Result<ReviewData[], ReviewPersistenceError>>;
+    /** Every review of a target (active or not), confirmed from primary storage (R18). */
+    listByTarget(params: ReviewRepositoryByTargetParams): Promise<Result<ReviewData[], ReviewPersistenceError>>;
+    /**
+     * Every review (active or not) of any of these targets of one namespace, confirmed from
+     * primary storage (R18). One query per 100 target ids and one batch read per page, whatever
+     * the number of targets.
+     */
+    listByTargets(params: ReviewRepositoryByTargetsParams): Promise<Result<ReviewData[], ReviewPersistenceError>>;
+    /**
+     * One page of reviews as the list index has them, in `sort` order. Not confirmed from primary
+     * storage: on ddb-os a row can be stale, so callers confirm the page with `getMany` (R18).
+     */
+    list(params: ReviewRepositoryListParams): Promise<Result<ReviewRepositoryListResult, ReviewPersistenceError>>;
+    /** Stores a new review. Only `ReviewSaver` (the single save path) calls this. */
+    create(review: ReviewData): Promise<Result<ReviewData, ReviewPersistenceError>>;
+    /**
+     * Stores a change to an existing review. A review deleted since it was read fails with
+     * `ReviewNotFoundError` and is never created again. Only `ReviewSaver` calls this.
+     */
+    update(review: ReviewData): Promise<Result<ReviewData, ReviewNotFoundError | ReviewPersistenceError>>;
+    /**
+     * Permanently deletes reviews, in batches of the CMS delete-multiple limit; a missing review
+     * counts as deleted. Stops at the first failed batch.
+     */
+    deleteMany(ids: string[]): Promise<Result<void, ReviewPersistenceError>>;
+}
+/** Reads and writes reviews (entries of the private `wbyWorkflowReview` model, revision 1). */
+export declare const ReviewRepository: import("@webiny/di").Abstraction<IReviewRepository>;
+export declare namespace ReviewRepository {
+    type Interface = IReviewRepository;
+    type ActiveByTargetParams = ReviewRepositoryActiveByTargetParams;
+    type ByTargetParams = ReviewRepositoryByTargetParams;
+    type ByTargetsParams = ReviewRepositoryByTargetsParams;
+    type ListWhere = ReviewRepositoryListWhere;
+    type ListParams = ReviewRepositoryListParams;
+    type ListResult = ReviewRepositoryListResult;
+}

package/domain/review/abstractions/ReviewRepository.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const ReviewRepository = createAbstraction("ReviewRepository");
+export { ReviewRepository };
+
+//# sourceMappingURL=ReviewRepository.js.map

package/domain/review/abstractions/ReviewRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/review/abstractions/ReviewRepository.js","sources":["../../../../src/domain/review/abstractions/ReviewRepository.ts"],"sourcesContent":["import { createAbstraction, type Result } from \"@webiny/feature/api\";\nimport type { CmsEntryMeta } from \"@webiny/api-headless-cms/types/index.js\";\nimport type {\n    ReviewData,\n    ReviewListReadFilter,\n    ReviewListSort,\n    ReviewState,\n    StepState\n} from \"../types.js\";\nimport type { ReviewNotFoundError, ReviewPersistenceError } from \"../errors.js\";\n\nexport interface ReviewRepositoryActiveByTargetParams {\n    model: string;\n    targetRevisionId: string;\n}\n\nexport interface ReviewRepositoryByTargetParams {\n    model: string;\n    targetId: string;\n    /** Only the reviews of this revision; every revision when omitted. */\n    targetRevisionId?: string;\n    /** Only the reviews in this state; every state when omitted. */\n    state?: ReviewState;\n}\n\nexport interface ReviewRepositoryByTargetsParams {\n    model: string;\n    /** Target ids (entry ids, not revision ids); an empty list returns no reviews. */\n    targetIds: string[];\n    /** Only the reviews in this state; every state when omitted. */\n    state?: ReviewState;\n}\n\n/**\n * Storage pre-filter of the review lists (R91). Keys combine with AND; omitted keys do not\n * restrict. `ListReviewsUseCase` checks every condition again in code on the primary row (R18).\n */\nexport interface ReviewRepositoryListWhere {\n    /**\n     * What the viewer may read (Q77). No readable namespace (`models` and `ownOnlyModels` both\n     * empty) matches nothing and is answered without a query.\n     */\n    read: ReviewListReadFilter;\n    isActive?: boolean;\n    state?: ReviewState;\n    currentStepState?: StepState;\n    currentOwnerId?: string;\n    currentOwnerId_not?: string;\n    /** Any shared team; an empty list matches nothing and is answered without a query. */\n    currentCandidateTeamIds_in?: string[];\n    currentStepType_in?: string[];\n    /** The requester's id (stored as `requester.id`). */\n    requesterId?: string;\n    requesterId_not?: string;\n    title_contains?: string;\n    /** Changed at or after this time (ISO); where an ascending list cursor resumes. */\n    lastChangedOn_gte?: string;\n    /** Changed at or before this time (ISO); where a descending list cursor resumes. */\n    lastChangedOn_lte?: string;\n    /** Review ids to leave out; the rows a list cursor already examined at its time. */\n    id_not_in?: string[];\n}\n\nexport interface ReviewRepositoryListParams {\n    where: ReviewRepositoryListWhere;\n    sort: ReviewListSort;\n    limit: number;\n    /** `meta.cursor` of the previous page. */\n    after?: string | null;\n}\n\nexport interface ReviewRepositoryListResult {\n    items: ReviewData[];\n    meta: CmsEntryMeta;\n}\n\nexport interface IReviewRepository {\n    get(id: string): Promise<Result<ReviewData, ReviewNotFoundError | ReviewPersistenceError>>;\n    /**\n     * Reviews by id from primary storage in one batch read (Q78), in the order of `ids`. Ids with\n     * no review are left out, so the result can be shorter than `ids`.\n     */\n    getMany(ids: string[]): Promise<Result<ReviewData[], ReviewPersistenceError>>;\n    /** At most one active review per target revision (D23). */\n    getActiveByTarget(\n        params: ReviewRepositoryActiveByTargetParams\n    ): Promise<Result<ReviewData | null, ReviewPersistenceError>>;\n    /**\n     * The distinct namespaces of the active reviews (e.g. \"cms.article\", \"wb.page\"), in one query:\n     * the only rows the review lists return. A namespace missing here has no list row.\n     */\n    listReviewedModels(): Promise<Result<string[], ReviewPersistenceError>>;\n    /** Every in-progress review of a workflow, confirmed from primary storage (R18). */\n    listInProgressByWorkflow(\n        workflowId: string\n    ): Promise<Result<ReviewData[], ReviewPersistenceError>>;\n    /**\n     * Active reviews whose current step is in review, owned by any of these users, in every\n     * namespace (least-loaded load, R115). Index rows, not confirmed from primary storage: a\n     * stale row only shifts a load count (A46). An empty list returns no reviews.\n     */\n    listInReviewByOwners(ownerIds: string[]): Promise<Result<ReviewData[], ReviewPersistenceError>>;\n    /** Every review of a target (active or not), confirmed from primary storage (R18). */\n    listByTarget(\n        params: ReviewRepositoryByTargetParams\n    ): Promise<Result<ReviewData[], ReviewPersistenceError>>;\n    /**\n     * Every review (active or not) of any of these targets of one namespace, confirmed from\n     * primary storage (R18). One query per 100 target ids and one batch read per page, whatever\n     * the number of targets.\n     */\n    listByTargets(\n        params: ReviewRepositoryByTargetsParams\n    ): Promise<Result<ReviewData[], ReviewPersistenceError>>;\n    /**\n     * One page of reviews as the list index has them, in `sort` order. Not confirmed from primary\n     * storage: on ddb-os a row can be stale, so callers confirm the page with `getMany` (R18).\n     */\n    list(\n        params: ReviewRepositoryListParams\n    ): Promise<Result<ReviewRepositoryListResult, ReviewPersistenceError>>;\n    /** Stores a new review. Only `ReviewSaver` (the single save path) calls this. */\n    create(review: ReviewData): Promise<Result<ReviewData, ReviewPersistenceError>>;\n    /**\n     * Stores a change to an existing review. A review deleted since it was read fails with\n     * `ReviewNotFoundError` and is never created again. Only `ReviewSaver` calls this.\n     */\n    update(\n        review: ReviewData\n    ): Promise<Result<ReviewData, ReviewNotFoundError | ReviewPersistenceError>>;\n    /**\n     * Permanently deletes reviews, in batches of the CMS delete-multiple limit; a missing review\n     * counts as deleted. Stops at the first failed batch.\n     */\n    deleteMany(ids: string[]): Promise<Result<void, ReviewPersistenceError>>;\n}\n\n/** Reads and writes reviews (entries of the private `wbyWorkflowReview` model, revision 1). */\nexport const ReviewRepository = createAbstraction<IReviewRepository>(\"ReviewRepository\");\n\nexport namespace ReviewRepository {\n    export type Interface = IReviewRepository;\n    export type ActiveByTargetParams = ReviewRepositoryActiveByTargetParams;\n    export type ByTargetParams = ReviewRepositoryByTargetParams;\n    export type ByTargetsParams = ReviewRepositoryByTargetsParams;\n    export type ListWhere = ReviewRepositoryListWhere;\n    export type ListParams = ReviewRepositoryListParams;\n    export type ListResult = ReviewRepositoryListResult;\n}\n"],"names":["ReviewRepository","createAbstraction"],"mappings":";AA0IO,MAAMA,mBAAmBC,kBAAqC"}

package/domain/review/applyTargetAccess.d.ts

@@ -0,0 +1,6 @@
+import type { ReviewTargetAccess, ReviewViewerFlags } from "./types.js";
+/**
+ * ANDs the app wrapper's target read access into every viewer flag (R33, D133 point 7). Without
+ * read access nothing is allowed; otherwise the flags are returned unchanged. Pure.
+ */
+export declare const applyTargetAccess: (flags: ReviewViewerFlags, access: ReviewTargetAccess) => ReviewViewerFlags;

package/domain/review/applyTargetAccess.js

@@ -0,0 +1,17 @@
+const applyTargetAccess = (flags, access)=>{
+    if (!access.canRead) return {
+        canStart: false,
+        canTakeOver: false,
+        canApprove: false,
+        canReject: false,
+        canCancel: false,
+        canReassign: false,
+        canRestart: false
+    };
+    return {
+        ...flags
+    };
+};
+export { applyTargetAccess };
+
+//# sourceMappingURL=applyTargetAccess.js.map

package/domain/review/applyTargetAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/review/applyTargetAccess.js","sources":["../../../src/domain/review/applyTargetAccess.ts"],"sourcesContent":["import type { ReviewTargetAccess, ReviewViewerFlags } from \"./types.js\";\n\n/**\n * ANDs the app wrapper's target read access into every viewer flag (R33, D133 point 7). Without\n * read access nothing is allowed; otherwise the flags are returned unchanged. Pure.\n */\nexport const applyTargetAccess = (\n    flags: ReviewViewerFlags,\n    access: ReviewTargetAccess\n): ReviewViewerFlags => {\n    if (!access.canRead) {\n        return {\n            canStart: false,\n            canTakeOver: false,\n            canApprove: false,\n            canReject: false,\n            canCancel: false,\n            canReassign: false,\n            canRestart: false\n        };\n    }\n    return { ...flags };\n};\n"],"names":["applyTargetAccess","flags","access"],"mappings":"AAMO,MAAMA,oBAAoB,CAC7BC,OACAC;IAEA,IAAI,CAACA,OAAO,OAAO,EACf,OAAO;QACH,UAAU;QACV,aAAa;QACb,YAAY;QACZ,WAAW;QACX,WAAW;QACX,aAAa;QACb,YAAY;IAChB;IAEJ,OAAO;QAAE,GAAGD,KAAK;IAAC;AACtB"}

package/domain/review/canCancelByPermission.d.ts

@@ -0,0 +1,9 @@
+import type { ReviewData, ReviewPermissionViewer } from "./types.js";
+/**
+ * Who may cancel a review (D25, D54): the requesting user, or a viewer with `reassign` (full
+ * access included). Permission only (R41): the review's state is not read. App wrappers authorize
+ * cancel with it and leave state errors (`Workflows/Review/InvalidState`) to the engine;
+ * `getReviewViewerFlags` ANDs it with `Review.checkCancel`. AI and automation actors carry the
+ * requester's id (D58) but are not the requester.
+ */
+export declare const canCancelByPermission: (review: ReviewData, viewer: ReviewPermissionViewer) => boolean;

package/domain/review/canCancelByPermission.js

@@ -0,0 +1,8 @@
+import { Review } from "./Review.js";
+const canCancelByPermission = (review, viewer)=>{
+    if (viewer.permissions.reassign) return true;
+    return Review.fromData(review).isRequestedBy(viewer.actor);
+};
+export { canCancelByPermission };
+
+//# sourceMappingURL=canCancelByPermission.js.map

package/domain/review/canCancelByPermission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/review/canCancelByPermission.js","sources":["../../../src/domain/review/canCancelByPermission.ts"],"sourcesContent":["import { Review } from \"./Review.js\";\nimport type { ReviewData, ReviewPermissionViewer } from \"./types.js\";\n\n/**\n * Who may cancel a review (D25, D54): the requesting user, or a viewer with `reassign` (full\n * access included). Permission only (R41): the review's state is not read. App wrappers authorize\n * cancel with it and leave state errors (`Workflows/Review/InvalidState`) to the engine;\n * `getReviewViewerFlags` ANDs it with `Review.checkCancel`. AI and automation actors carry the\n * requester's id (D58) but are not the requester.\n */\nexport const canCancelByPermission = (\n    review: ReviewData,\n    viewer: ReviewPermissionViewer\n): boolean => {\n    if (viewer.permissions.reassign) {\n        return true;\n    }\n    return Review.fromData(review).isRequestedBy(viewer.actor);\n};\n"],"names":["canCancelByPermission","review","viewer","Review"],"mappings":";AAUO,MAAMA,wBAAwB,CACjCC,QACAC;IAEA,IAAIA,OAAO,WAAW,CAAC,QAAQ,EAC3B,OAAO;IAEX,OAAOC,OAAO,QAAQ,CAACF,QAAQ,aAAa,CAACC,OAAO,KAAK;AAC7D"}

package/domain/review/canReassignByPermission.d.ts

@@ -0,0 +1,7 @@
+import type { ReviewPermissionViewer } from "./types.js";
+/**
+ * Who may reassign (D33): a viewer with `reassign` (full access included). Permission only (R41):
+ * whether the step can be reassigned is the engine's `checkReassign` / reassign transition, which
+ * reports its own state errors.
+ */
+export declare const canReassignByPermission: (viewer: ReviewPermissionViewer) => boolean;

package/domain/review/canReassignByPermission.js

@@ -0,0 +1,4 @@
+const canReassignByPermission = (viewer)=>viewer.permissions.reassign;
+export { canReassignByPermission };
+
+//# sourceMappingURL=canReassignByPermission.js.map

package/domain/review/canReassignByPermission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/review/canReassignByPermission.js","sources":["../../../src/domain/review/canReassignByPermission.ts"],"sourcesContent":["import type { ReviewPermissionViewer } from \"./types.js\";\n\n/**\n * Who may reassign (D33): a viewer with `reassign` (full access included). Permission only (R41):\n * whether the step can be reassigned is the engine's `checkReassign` / reassign transition, which\n * reports its own state errors.\n */\nexport const canReassignByPermission = (viewer: ReviewPermissionViewer): boolean => {\n    return viewer.permissions.reassign;\n};\n"],"names":["canReassignByPermission","viewer"],"mappings":"AAOO,MAAMA,0BAA0B,CAACC,SAC7BA,OAAO,WAAW,CAAC,QAAQ"}

package/domain/review/canRestartByPermission.d.ts

@@ -0,0 +1,9 @@
+import type { ReviewData, ReviewPermissionViewer } from "./types.js";
+/**
+ * Who may restart a failed step (spec 5.1, D34, R153): the requesting user, or a viewer with
+ * `reassign` (full access included). Permission only (R41): the review's state is not read. App
+ * wrappers authorize restart with it and leave state errors (`Workflows/Review/InvalidState`,
+ * transition `"restart"`) to the engine; `getReviewViewerFlags` ANDs it with `Review.checkRestart`.
+ * AI and automation actors carry the requester's id (D58) but are not the requester.
+ */
+export declare const canRestartByPermission: (review: ReviewData, viewer: ReviewPermissionViewer) => boolean;

package/domain/review/canRestartByPermission.js

@@ -0,0 +1,8 @@
+import { Review } from "./Review.js";
+const canRestartByPermission = (review, viewer)=>{
+    if (viewer.permissions.reassign) return true;
+    return Review.fromData(review).isRequestedBy(viewer.actor);
+};
+export { canRestartByPermission };
+
+//# sourceMappingURL=canRestartByPermission.js.map

package/domain/review/canRestartByPermission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/review/canRestartByPermission.js","sources":["../../../src/domain/review/canRestartByPermission.ts"],"sourcesContent":["import { Review } from \"./Review.js\";\nimport type { ReviewData, ReviewPermissionViewer } from \"./types.js\";\n\n/**\n * Who may restart a failed step (spec 5.1, D34, R153): the requesting user, or a viewer with\n * `reassign` (full access included). Permission only (R41): the review's state is not read. App\n * wrappers authorize restart with it and leave state errors (`Workflows/Review/InvalidState`,\n * transition `\"restart\"`) to the engine; `getReviewViewerFlags` ANDs it with `Review.checkRestart`.\n * AI and automation actors carry the requester's id (D58) but are not the requester.\n */\nexport const canRestartByPermission = (\n    review: ReviewData,\n    viewer: ReviewPermissionViewer\n): boolean => {\n    if (viewer.permissions.reassign) {\n        return true;\n    }\n    return Review.fromData(review).isRequestedBy(viewer.actor);\n};\n"],"names":["canRestartByPermission","review","viewer","Review"],"mappings":";AAUO,MAAMA,yBAAyB,CAClCC,QACAC;IAEA,IAAIA,OAAO,WAAW,CAAC,QAAQ,EAC3B,OAAO;IAEX,OAAOC,OAAO,QAAQ,CAACF,QAAQ,aAAa,CAACC,OAAO,KAAK;AAC7D"}

package/domain/review/canViewStepRunByPermission.d.ts

@@ -0,0 +1,7 @@
+import type { ReviewPermissionViewer } from "./types.js";
+/**
+ * Who may read the background task of a step attempt (R258, D90): a viewer with `editor` or
+ * `reassign` (full access sets both). Permission only: the app wrappers combine it with read
+ * access to the review's target.
+ */
+export declare const canViewStepRunByPermission: (viewer: ReviewPermissionViewer) => boolean;

package/domain/review/canViewStepRunByPermission.js

@@ -0,0 +1,4 @@
+const canViewStepRunByPermission = (viewer)=>viewer.permissions.editor || viewer.permissions.reassign;
+export { canViewStepRunByPermission };
+
+//# sourceMappingURL=canViewStepRunByPermission.js.map

package/domain/review/canViewStepRunByPermission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/review/canViewStepRunByPermission.js","sources":["../../../src/domain/review/canViewStepRunByPermission.ts"],"sourcesContent":["import type { ReviewPermissionViewer } from \"./types.js\";\n\n/**\n * Who may read the background task of a step attempt (R258, D90): a viewer with `editor` or\n * `reassign` (full access sets both). Permission only: the app wrappers combine it with read\n * access to the review's target.\n */\nexport const canViewStepRunByPermission = (viewer: ReviewPermissionViewer): boolean => {\n    return viewer.permissions.editor || viewer.permissions.reassign;\n};\n"],"names":["canViewStepRunByPermission","viewer"],"mappings":"AAOO,MAAMA,6BAA6B,CAACC,SAChCA,OAAO,WAAW,CAAC,MAAM,IAAIA,OAAO,WAAW,CAAC,QAAQ"}