@webiny/api-workflows 0.0.0-unstable.0156a4c312

package/features/review/shared/ReviewRepository.js

@@ -0,0 +1,344 @@
+import { Result } from "@webiny/feature/api";
+import { createIdentifier, parseIdentifier } from "@webiny/utils";
+import { CreateEntryUseCase } from "@webiny/api-headless-cms/features/contentEntry/CreateEntry/index.js";
+import { DeleteMultipleEntriesUseCase } from "@webiny/api-headless-cms/features/contentEntry/DeleteMultipleEntries/index.js";
+import { UpdateEntryUseCase } from "@webiny/api-headless-cms/features/contentEntry/UpdateEntry/index.js";
+import { GetEntryByIdUseCase } from "@webiny/api-headless-cms/features/contentEntry/GetEntryById/index.js";
+import { GetEntriesByIdsUseCase } from "@webiny/api-headless-cms/features/contentEntry/GetEntriesByIds/index.js";
+import { ListLatestEntriesUseCase } from "@webiny/api-headless-cms/features/contentEntry/ListEntries/index.js";
+import { GetUniqueFieldValuesUseCase } from "@webiny/api-headless-cms/features/contentEntry/GetUniqueFieldValues/index.js";
+import { ReviewModelProvider } from "../../../domain/review/abstractions/ReviewModelProvider.js";
+import { ReviewRepository } from "../../../domain/review/abstractions/ReviewRepository.js";
+import { ReviewNotFoundError, ReviewPersistenceError } from "../../../domain/review/errors.js";
+import { toChunks } from "../../../domain/toChunks.js";
+import { ReviewEntryMapper } from "./ReviewEntryMapper.js";
+const ENTRY_NOT_FOUND = "Cms/Entry/NotFound";
+const ACTIVE_BY_TARGET_LIMIT = 10;
+const COUNT_PAGE_SIZE = 100;
+const DELETE_MULTIPLE_LIMIT = 50;
+const TARGET_IDS_PER_QUERY = 100;
+const applyReadFilter = (where, read)=>{
+    const values = where.values ?? {};
+    where.values = values;
+    const ownOnlyModels = read.ownOnlyModels.filter((model)=>!read.models.includes(model));
+    const targetContext = {};
+    if (read.models.length > 0 && ownOnlyModels.length > 0) where.OR = [
+        {
+            values: {
+                model_in: [
+                    ...read.models
+                ]
+            }
+        },
+        {
+            values: {
+                model_in: ownOnlyModels,
+                targetContext: {
+                    author: {
+                        id: read.authorId
+                    }
+                }
+            }
+        }
+    ];
+    else if (read.models.length > 0) values.model_in = [
+        ...read.models
+    ];
+    else {
+        values.model_in = ownOnlyModels;
+        targetContext.author = {
+            id: read.authorId
+        };
+    }
+    if (read.deniedFolderIds.length > 0) targetContext.folder = {
+        id_not_in: [
+            ...read.deniedFolderIds
+        ]
+    };
+    if (Object.keys(targetContext).length > 0) values.targetContext = targetContext;
+};
+class ReviewRepositoryImpl {
+    constructor(modelProvider, getEntryById, getEntriesByIds, listLatestEntries, createEntry, updateEntry, deleteMultipleEntries, getUniqueFieldValues){
+        this.modelProvider = modelProvider;
+        this.getEntryById = getEntryById;
+        this.getEntriesByIds = getEntriesByIds;
+        this.listLatestEntries = listLatestEntries;
+        this.createEntry = createEntry;
+        this.updateEntry = updateEntry;
+        this.deleteMultipleEntries = deleteMultipleEntries;
+        this.getUniqueFieldValues = getUniqueFieldValues;
+    }
+    async get(id) {
+        const model = await this.modelProvider.get();
+        const result = await this.getEntryById.execute(model, createIdentifier({
+            id,
+            version: 1
+        }));
+        if (result.isFail()) {
+            if (result.error.code === ENTRY_NOT_FOUND) return Result.fail(new ReviewNotFoundError({
+                id
+            }));
+            return Result.fail(new ReviewPersistenceError(result.error));
+        }
+        return Result.ok(ReviewEntryMapper.fromEntry(result.value));
+    }
+    async getMany(ids) {
+        const uniqueIds = [
+            ...new Set(ids)
+        ];
+        if (0 === uniqueIds.length) return Result.ok([]);
+        const model = await this.modelProvider.get();
+        const revisionIds = uniqueIds.map((id)=>createIdentifier({
+                id,
+                version: 1
+            }));
+        const result = await this.getEntriesByIds.execute(model, revisionIds);
+        if (result.isFail()) return Result.fail(new ReviewPersistenceError(result.error));
+        const byId = new Map();
+        for (const entry of result.value){
+            const review = ReviewEntryMapper.fromEntry(entry);
+            byId.set(review.id, review);
+        }
+        const reviews = [];
+        for (const id of uniqueIds){
+            const review = byId.get(id);
+            if (review) reviews.push(review);
+        }
+        return Result.ok(reviews);
+    }
+    async getActiveByTarget(params) {
+        const model = await this.modelProvider.get();
+        const result = await this.listLatestEntries.execute(model, {
+            where: {
+                values: {
+                    model: params.model,
+                    targetRevisionId: params.targetRevisionId,
+                    isActive: true
+                }
+            },
+            sort: [
+                "createdOn_DESC"
+            ],
+            limit: ACTIVE_BY_TARGET_LIMIT
+        });
+        if (result.isFail()) return Result.fail(new ReviewPersistenceError(result.error));
+        const listedIds = result.value.entries.map((entry)=>parseIdentifier(entry.id).id);
+        const primary = await this.getMany(listedIds);
+        if (primary.isFail()) return Result.fail(primary.error);
+        const active = primary.value.find((review)=>review.isActive && review.model === params.model && review.targetRevisionId === params.targetRevisionId);
+        return Result.ok(active ?? null);
+    }
+    async listReviewedModels() {
+        const model = await this.modelProvider.get();
+        const result = await this.getUniqueFieldValues.execute(model, {
+            where: {
+                latest: true,
+                values: {
+                    isActive: true
+                }
+            },
+            fieldId: "model"
+        });
+        if (result.isFail()) return Result.fail(new ReviewPersistenceError(result.error));
+        const models = result.value.map((item)=>item.value).filter(Boolean);
+        return Result.ok(models);
+    }
+    async listInProgressByWorkflow(workflowId) {
+        return this.listConfirmed({
+            workflowId,
+            state: "inProgress"
+        }, (review)=>review.workflowId === workflowId && "inProgress" === review.state);
+    }
+    async listInReviewByOwners(ownerIds) {
+        if (0 === ownerIds.length) return Result.ok([]);
+        const model = await this.modelProvider.get();
+        const reviews = [];
+        let after = null;
+        do {
+            const result = await this.listLatestEntries.execute(model, {
+                where: {
+                    values: {
+                        currentOwnerId_in: [
+                            ...ownerIds
+                        ],
+                        currentStepState: "inReview",
+                        isActive: true
+                    }
+                },
+                sort: [
+                    "createdOn_ASC"
+                ],
+                limit: COUNT_PAGE_SIZE,
+                after
+            });
+            if (result.isFail()) return Result.fail(new ReviewPersistenceError(result.error));
+            for (const entry of result.value.entries){
+                const review = ReviewEntryMapper.fromEntry(entry);
+                if (review.isActive && "inReview" === review.currentStepState && null !== review.currentOwnerId && ownerIds.includes(review.currentOwnerId)) reviews.push(review);
+            }
+            const { meta } = result.value;
+            after = meta.hasMoreItems ? meta.cursor : null;
+        }while (after)
+        return Result.ok(reviews);
+    }
+    async listByTarget(params) {
+        const values = {
+            model: params.model,
+            targetId: params.targetId
+        };
+        if (params.targetRevisionId) values.targetRevisionId = params.targetRevisionId;
+        if (params.state) values.state = params.state;
+        return this.listConfirmed(values, (review)=>review.model === params.model && review.targetId === params.targetId && (!params.targetRevisionId || review.targetRevisionId === params.targetRevisionId) && (!params.state || review.state === params.state));
+    }
+    async listByTargets(params) {
+        const targetIds = [
+            ...new Set(params.targetIds)
+        ];
+        const reviews = [];
+        for (const chunk of toChunks(targetIds, TARGET_IDS_PER_QUERY)){
+            const values = {
+                model: params.model,
+                targetId_in: chunk
+            };
+            if (params.state) values.state = params.state;
+            const listed = await this.listConfirmed(values, (review)=>review.model === params.model && chunk.includes(review.targetId) && (!params.state || review.state === params.state));
+            if (listed.isFail()) return Result.fail(listed.error);
+            reviews.push(...listed.value);
+        }
+        return Result.ok(reviews);
+    }
+    async listConfirmed(values, keep) {
+        const model = await this.modelProvider.get();
+        const reviews = [];
+        let after = null;
+        do {
+            const result = await this.listLatestEntries.execute(model, {
+                where: {
+                    values
+                },
+                sort: [
+                    "createdOn_ASC"
+                ],
+                limit: COUNT_PAGE_SIZE,
+                after
+            });
+            if (result.isFail()) return Result.fail(new ReviewPersistenceError(result.error));
+            const listedIds = result.value.entries.map((entry)=>parseIdentifier(entry.id).id);
+            const primary = await this.getMany(listedIds);
+            if (primary.isFail()) return Result.fail(primary.error);
+            reviews.push(...primary.value.filter(keep));
+            const { meta } = result.value;
+            after = meta.hasMoreItems ? meta.cursor : null;
+        }while (after)
+        return Result.ok(reviews);
+    }
+    async list(params) {
+        const { where } = params;
+        const emptyIn = 0 === where.read.models.length && 0 === where.read.ownOnlyModels.length || where.currentCandidateTeamIds_in?.length === 0 || where.currentStepType_in?.length === 0;
+        if (emptyIn) return Result.ok({
+            items: [],
+            meta: {
+                cursor: null,
+                hasMoreItems: false,
+                totalCount: 0
+            }
+        });
+        const model = await this.modelProvider.get();
+        const values = {};
+        if (void 0 !== where.isActive) values.isActive = where.isActive;
+        if (void 0 !== where.state) values.state = where.state;
+        if (void 0 !== where.currentStepState) values.currentStepState = where.currentStepState;
+        if (void 0 !== where.currentOwnerId) values.currentOwnerId = where.currentOwnerId;
+        if (void 0 !== where.currentOwnerId_not) values.currentOwnerId_not = where.currentOwnerId_not;
+        if (void 0 !== where.currentCandidateTeamIds_in) values.currentCandidateTeamIds_in = [
+            ...where.currentCandidateTeamIds_in
+        ];
+        if (void 0 !== where.currentStepType_in) values.currentStepType_in = [
+            ...where.currentStepType_in
+        ];
+        if (void 0 !== where.title_contains) values.title_contains = where.title_contains;
+        if (void 0 !== where.lastChangedOn_gte) values.lastChangedOn_gte = where.lastChangedOn_gte;
+        if (void 0 !== where.lastChangedOn_lte) values.lastChangedOn_lte = where.lastChangedOn_lte;
+        const requester = {};
+        if (void 0 !== where.requesterId) requester.id = where.requesterId;
+        if (void 0 !== where.requesterId_not) requester.id_not = where.requesterId_not;
+        if (Object.keys(requester).length > 0) values.requester = requester;
+        const listWhere = {
+            values
+        };
+        applyReadFilter(listWhere, where.read);
+        if (where.id_not_in?.length) listWhere.entryId_not_in = [
+            ...where.id_not_in
+        ];
+        const result = await this.listLatestEntries.execute(model, {
+            where: listWhere,
+            sort: [
+                `values_${params.sort}`
+            ],
+            limit: params.limit,
+            after: params.after ?? null
+        });
+        if (result.isFail()) return Result.fail(new ReviewPersistenceError(result.error));
+        return Result.ok({
+            items: result.value.entries.map((entry)=>ReviewEntryMapper.fromEntry(entry)),
+            meta: result.value.meta
+        });
+    }
+    async create(review) {
+        const model = await this.modelProvider.get();
+        const created = await this.createEntry.execute(model, {
+            id: review.id,
+            createdOn: review.createdOn,
+            values: ReviewEntryMapper.toValues(review)
+        });
+        if (created.isFail()) return Result.fail(new ReviewPersistenceError(created.error));
+        return Result.ok(ReviewEntryMapper.fromEntry(created.value));
+    }
+    async update(review) {
+        const model = await this.modelProvider.get();
+        const id = createIdentifier({
+            id: review.id,
+            version: 1
+        });
+        const updated = await this.updateEntry.execute(model, id, {
+            values: ReviewEntryMapper.toValues(review)
+        });
+        if (updated.isFail()) {
+            if (updated.error.code === ENTRY_NOT_FOUND) return Result.fail(new ReviewNotFoundError({
+                id: review.id
+            }));
+            return Result.fail(new ReviewPersistenceError(updated.error));
+        }
+        return Result.ok(ReviewEntryMapper.fromEntry(updated.value));
+    }
+    async deleteMany(ids) {
+        const uniqueIds = [
+            ...new Set(ids)
+        ];
+        if (0 === uniqueIds.length) return Result.ok();
+        const model = await this.modelProvider.get();
+        for (const chunk of toChunks(uniqueIds, DELETE_MULTIPLE_LIMIT)){
+            const result = await this.deleteMultipleEntries.execute(model, {
+                entries: chunk
+            });
+            if (result.isFail()) return Result.fail(new ReviewPersistenceError(result.error));
+        }
+        return Result.ok();
+    }
+}
+const ReviewRepository_ReviewRepository = ReviewRepository.createImplementation({
+    implementation: ReviewRepositoryImpl,
+    dependencies: [
+        ReviewModelProvider,
+        GetEntryByIdUseCase,
+        GetEntriesByIdsUseCase,
+        ListLatestEntriesUseCase,
+        CreateEntryUseCase,
+        UpdateEntryUseCase,
+        DeleteMultipleEntriesUseCase,
+        GetUniqueFieldValuesUseCase
+    ]
+});
+export { ReviewRepository_ReviewRepository as ReviewRepository };
+
+//# sourceMappingURL=ReviewRepository.js.map

package/features/review/shared/ReviewRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/review/shared/ReviewRepository.js","sources":["../../../../src/features/review/shared/ReviewRepository.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { createIdentifier, parseIdentifier } from \"@webiny/utils\";\nimport type {\n    CmsEntryListWhere,\n    CmsEntryListWhereValues\n} from \"@webiny/api-headless-cms/types/index.js\";\nimport { CreateEntryUseCase } from \"@webiny/api-headless-cms/features/contentEntry/CreateEntry/index.js\";\nimport { DeleteMultipleEntriesUseCase } from \"@webiny/api-headless-cms/features/contentEntry/DeleteMultipleEntries/index.js\";\nimport { UpdateEntryUseCase } from \"@webiny/api-headless-cms/features/contentEntry/UpdateEntry/index.js\";\nimport { GetEntryByIdUseCase } from \"@webiny/api-headless-cms/features/contentEntry/GetEntryById/index.js\";\nimport { GetEntriesByIdsUseCase } from \"@webiny/api-headless-cms/features/contentEntry/GetEntriesByIds/index.js\";\nimport { ListLatestEntriesUseCase } from \"@webiny/api-headless-cms/features/contentEntry/ListEntries/index.js\";\nimport { GetUniqueFieldValuesUseCase } from \"@webiny/api-headless-cms/features/contentEntry/GetUniqueFieldValues/index.js\";\nimport { ReviewModelProvider } from \"~/domain/review/abstractions/ReviewModelProvider.js\";\nimport { ReviewRepository as ReviewRepositoryAbstraction } from \"~/domain/review/abstractions/ReviewRepository.js\";\nimport { ReviewNotFoundError, ReviewPersistenceError } from \"~/domain/review/errors.js\";\nimport type { ReviewData, ReviewListReadFilter } from \"~/domain/review/types.js\";\nimport { toChunks } from \"~/domain/toChunks.js\";\nimport { ReviewEntryMapper, type ReviewEntryValues } from \"./ReviewEntryMapper.js\";\n\nconst ENTRY_NOT_FOUND = \"Cms/Entry/NotFound\";\n/** At most one review per revision is active (D23); a few extra hits cover stale list results. */\nconst ACTIVE_BY_TARGET_LIMIT = 10;\nconst COUNT_PAGE_SIZE = 100;\n/** The most entries one `DeleteMultipleEntriesUseCase` call deletes. */\nconst DELETE_MULTIPLE_LIMIT = 50;\n/** Target ids per `targetId_in` query; keeps each query's terms list small. */\nconst TARGET_IDS_PER_QUERY = 100;\n\ntype ReviewEntryListPage = Awaited<ListLatestEntriesUseCase.Return<ReviewEntryValues>>;\n\n/** Keeps a confirmed primary row: the listed condition still holds on it (R18). */\ntype ConfirmedReviewFilter = (review: ReviewData) => boolean;\n\n/**\n * Adds the read filter of a list to its CMS where (Q77): readable namespaces with `model_in`,\n * own-only namespaces with `model_in` and the target author, the two as an `OR` when the viewer has\n * both kinds, and denied folders with `targetContext.folder.id_not_in`. A review in the root folder\n * has no folder id, which `not_in` never excludes. Changes `where` and its `values`.\n */\nconst applyReadFilter = (where: CmsEntryListWhere, read: ReviewListReadFilter): void => {\n    const values: CmsEntryListWhereValues = where.values ?? {};\n    where.values = values;\n    const ownOnlyModels = read.ownOnlyModels.filter(model => !read.models.includes(model));\n    const targetContext: CmsEntryListWhereValues = {};\n\n    if (read.models.length > 0 && ownOnlyModels.length > 0) {\n        where.OR = [\n            { values: { model_in: [...read.models] } },\n            {\n                values: {\n                    model_in: ownOnlyModels,\n                    targetContext: { author: { id: read.authorId } }\n                }\n            }\n        ];\n    } else if (read.models.length > 0) {\n        values.model_in = [...read.models];\n    } else {\n        values.model_in = ownOnlyModels;\n        targetContext.author = { id: read.authorId };\n    }\n\n    if (read.deniedFolderIds.length > 0) {\n        targetContext.folder = { id_not_in: [...read.deniedFolderIds] };\n    }\n    if (Object.keys(targetContext).length > 0) {\n        values.targetContext = targetContext;\n    }\n};\n\n/**\n * Lists go through `ListLatestEntriesUseCase`, which reads OpenSearch on ddb-os. OpenSearch is\n * filled asynchronously, so a listed hit can be stale (a cancelled review still `isActive: true`)\n * and a just-written review can be missing. Every hit is confirmed with a primary-storage read\n * before `isActive` or `state` is trusted (R18). A review written but not yet indexed is still\n * missed: two concurrent requests on one revision can both pass, and a delete can pass while a\n * request is in flight. That race is accepted, like D27 and D15.\n */\nclass ReviewRepositoryImpl implements ReviewRepositoryAbstraction.Interface {\n    constructor(\n        private modelProvider: ReviewModelProvider.Interface,\n        private getEntryById: GetEntryByIdUseCase.Interface,\n        private getEntriesByIds: GetEntriesByIdsUseCase.Interface,\n        private listLatestEntries: ListLatestEntriesUseCase.Interface,\n        private createEntry: CreateEntryUseCase.Interface,\n        private updateEntry: UpdateEntryUseCase.Interface,\n        private deleteMultipleEntries: DeleteMultipleEntriesUseCase.Interface,\n        private getUniqueFieldValues: GetUniqueFieldValuesUseCase.Interface\n    ) {}\n\n    async get(\n        id: string\n    ): Promise<Result<ReviewData, ReviewNotFoundError | ReviewPersistenceError>> {\n        const model = await this.modelProvider.get();\n        const result = await this.getEntryById.execute<ReviewEntryValues>(\n            model,\n            createIdentifier({ id, version: 1 })\n        );\n        if (result.isFail()) {\n            if (result.error.code === ENTRY_NOT_FOUND) {\n                return Result.fail(new ReviewNotFoundError({ id }));\n            }\n            return Result.fail(new ReviewPersistenceError(result.error));\n        }\n        return Result.ok(ReviewEntryMapper.fromEntry(result.value));\n    }\n\n    async getMany(ids: string[]): Promise<Result<ReviewData[], ReviewPersistenceError>> {\n        const uniqueIds = [...new Set(ids)];\n        if (uniqueIds.length === 0) {\n            return Result.ok([]);\n        }\n        const model = await this.modelProvider.get();\n        // A review is stored as revision 1 only, so a review id maps to one revision id.\n        const revisionIds = uniqueIds.map(id => createIdentifier({ id, version: 1 }));\n        const result = await this.getEntriesByIds.execute<ReviewEntryValues>(model, revisionIds);\n        if (result.isFail()) {\n            return Result.fail(new ReviewPersistenceError(result.error));\n        }\n\n        const byId = new Map<string, ReviewData>();\n        for (const entry of result.value) {\n            const review = ReviewEntryMapper.fromEntry(entry);\n            byId.set(review.id, review);\n        }\n        // Storage returns the entries in no particular order; keep the order of `ids`.\n        const reviews: ReviewData[] = [];\n        for (const id of uniqueIds) {\n            const review = byId.get(id);\n            if (review) {\n                reviews.push(review);\n            }\n        }\n        return Result.ok(reviews);\n    }\n\n    async getActiveByTarget(\n        params: ReviewRepositoryAbstraction.ActiveByTargetParams\n    ): Promise<Result<ReviewData | null, ReviewPersistenceError>> {\n        const model = await this.modelProvider.get();\n        const result = await this.listLatestEntries.execute<ReviewEntryValues>(model, {\n            where: {\n                values: {\n                    model: params.model,\n                    targetRevisionId: params.targetRevisionId,\n                    isActive: true\n                }\n            },\n            sort: [\"createdOn_DESC\"],\n            limit: ACTIVE_BY_TARGET_LIMIT\n        });\n        if (result.isFail()) {\n            return Result.fail(new ReviewPersistenceError(result.error));\n        }\n\n        // Primary-storage rows of the listed hits, in list order; a hit deleted since is left out.\n        const listedIds = result.value.entries.map(entry => parseIdentifier(entry.id).id);\n        const primary = await this.getMany(listedIds);\n        if (primary.isFail()) {\n            return Result.fail(primary.error);\n        }\n        const active = primary.value.find(review => {\n            return (\n                review.isActive &&\n                review.model === params.model &&\n                review.targetRevisionId === params.targetRevisionId\n            );\n        });\n        return Result.ok(active ?? null);\n    }\n\n    async listReviewedModels(): Promise<Result<string[], ReviewPersistenceError>> {\n        const model = await this.modelProvider.get();\n        const result = await this.getUniqueFieldValues.execute(model, {\n            // Active reviews only: the review lists return nothing else (`createReviewListWhere`\n            // sets `isActive: true`). The folder rules cover only these models, so if the lists\n            // ever return inactive reviews, this set must include them too.\n            where: { latest: true, values: { isActive: true } },\n            fieldId: \"model\"\n        });\n        if (result.isFail()) {\n            return Result.fail(new ReviewPersistenceError(result.error));\n        }\n        const models = result.value.map(item => item.value).filter(Boolean);\n        return Result.ok(models);\n    }\n\n    async listInProgressByWorkflow(\n        workflowId: string\n    ): Promise<Result<ReviewData[], ReviewPersistenceError>> {\n        // One batch read per page confirms the listed rows (R18, Q78).\n        return this.listConfirmed({ workflowId, state: \"inProgress\" }, review => {\n            return review.workflowId === workflowId && review.state === \"inProgress\";\n        });\n    }\n\n    async listInReviewByOwners(\n        ownerIds: string[]\n    ): Promise<Result<ReviewData[], ReviewPersistenceError>> {\n        // An empty `In` list throws on OpenSearch (DDB returns nothing): answer without querying.\n        if (ownerIds.length === 0) {\n            return Result.ok([]);\n        }\n        const model = await this.modelProvider.get();\n        const reviews: ReviewData[] = [];\n        let after: string | null = null;\n        do {\n            const result: ReviewEntryListPage =\n                // oxlint-disable-next-line no-await-in-loop -- one query per page of the owners' reviews.\n                await this.listLatestEntries.execute<ReviewEntryValues>(model, {\n                    where: {\n                        values: {\n                            currentOwnerId_in: [...ownerIds],\n                            currentStepState: \"inReview\",\n                            isActive: true\n                        }\n                    },\n                    sort: [\"createdOn_ASC\"],\n                    limit: COUNT_PAGE_SIZE,\n                    after\n                });\n            if (result.isFail()) {\n                return Result.fail(new ReviewPersistenceError(result.error));\n            }\n\n            for (const entry of result.value.entries) {\n                // Index rows, not confirmed (A46); the filter is checked again on the row.\n                const review = ReviewEntryMapper.fromEntry(entry);\n                if (\n                    review.isActive &&\n                    review.currentStepState === \"inReview\" &&\n                    review.currentOwnerId !== null &&\n                    ownerIds.includes(review.currentOwnerId)\n                ) {\n                    reviews.push(review);\n                }\n            }\n\n            const { meta } = result.value;\n            after = meta.hasMoreItems ? meta.cursor : null;\n        } while (after);\n\n        return Result.ok(reviews);\n    }\n\n    async listByTarget(\n        params: ReviewRepositoryAbstraction.ByTargetParams\n    ): Promise<Result<ReviewData[], ReviewPersistenceError>> {\n        const values: CmsEntryListWhereValues = {\n            model: params.model,\n            targetId: params.targetId\n        };\n        if (params.targetRevisionId) {\n            values.targetRevisionId = params.targetRevisionId;\n        }\n        if (params.state) {\n            values.state = params.state;\n        }\n        return this.listConfirmed(values, review => {\n            return (\n                review.model === params.model &&\n                review.targetId === params.targetId &&\n                (!params.targetRevisionId || review.targetRevisionId === params.targetRevisionId) &&\n                (!params.state || review.state === params.state)\n            );\n        });\n    }\n\n    async listByTargets(\n        params: ReviewRepositoryAbstraction.ByTargetsParams\n    ): Promise<Result<ReviewData[], ReviewPersistenceError>> {\n        const targetIds = [...new Set(params.targetIds)];\n        const reviews: ReviewData[] = [];\n        // One query per chunk: a fixed number of queries for any number of targets.\n        for (const chunk of toChunks(targetIds, TARGET_IDS_PER_QUERY)) {\n            const values: CmsEntryListWhereValues = {\n                model: params.model,\n                targetId_in: chunk\n            };\n            if (params.state) {\n                values.state = params.state;\n            }\n            // oxlint-disable-next-line no-await-in-loop -- one query per chunk of target ids.\n            const listed = await this.listConfirmed(values, review => {\n                return (\n                    review.model === params.model &&\n                    chunk.includes(review.targetId) &&\n                    (!params.state || review.state === params.state)\n                );\n            });\n            if (listed.isFail()) {\n                return Result.fail(listed.error);\n            }\n            reviews.push(...listed.value);\n        }\n        return Result.ok(reviews);\n    }\n\n    /**\n     * Every listed review matching `values`, page by page, each page confirmed with one batch read\n     * of primary storage (R18, Q78). `keep` checks the listed condition again on the primary row.\n     */\n    private async listConfirmed(\n        values: CmsEntryListWhereValues,\n        keep: ConfirmedReviewFilter\n    ): Promise<Result<ReviewData[], ReviewPersistenceError>> {\n        const model = await this.modelProvider.get();\n        const reviews: ReviewData[] = [];\n        let after: string | null = null;\n        do {\n            const result: ReviewEntryListPage =\n                // oxlint-disable-next-line no-await-in-loop -- one query per page.\n                await this.listLatestEntries.execute<ReviewEntryValues>(model, {\n                    where: { values },\n                    sort: [\"createdOn_ASC\"],\n                    limit: COUNT_PAGE_SIZE,\n                    after\n                });\n            if (result.isFail()) {\n                return Result.fail(new ReviewPersistenceError(result.error));\n            }\n\n            const listedIds = result.value.entries.map(entry => parseIdentifier(entry.id).id);\n            // oxlint-disable-next-line no-await-in-loop -- one batch read per page confirms the page.\n            const primary = await this.getMany(listedIds);\n            if (primary.isFail()) {\n                return Result.fail(primary.error);\n            }\n            reviews.push(...primary.value.filter(keep));\n\n            const { meta } = result.value;\n            after = meta.hasMoreItems ? meta.cursor : null;\n        } while (after);\n\n        return Result.ok(reviews);\n    }\n\n    async list(\n        params: ReviewRepositoryAbstraction.ListParams\n    ): Promise<Result<ReviewRepositoryAbstraction.ListResult, ReviewPersistenceError>> {\n        const { where } = params;\n        // An empty `In` list throws on OpenSearch (DDB returns nothing): answer without querying.\n        const emptyIn =\n            (where.read.models.length === 0 && where.read.ownOnlyModels.length === 0) ||\n            where.currentCandidateTeamIds_in?.length === 0 ||\n            where.currentStepType_in?.length === 0;\n        if (emptyIn) {\n            return Result.ok({\n                items: [],\n                meta: { cursor: null, hasMoreItems: false, totalCount: 0 }\n            });\n        }\n\n        const model = await this.modelProvider.get();\n        const values: CmsEntryListWhereValues = {};\n        if (where.isActive !== undefined) {\n            values.isActive = where.isActive;\n        }\n        if (where.state !== undefined) {\n            values.state = where.state;\n        }\n        if (where.currentStepState !== undefined) {\n            values.currentStepState = where.currentStepState;\n        }\n        if (where.currentOwnerId !== undefined) {\n            values.currentOwnerId = where.currentOwnerId;\n        }\n        if (where.currentOwnerId_not !== undefined) {\n            values.currentOwnerId_not = where.currentOwnerId_not;\n        }\n        if (where.currentCandidateTeamIds_in !== undefined) {\n            values.currentCandidateTeamIds_in = [...where.currentCandidateTeamIds_in];\n        }\n        if (where.currentStepType_in !== undefined) {\n            values.currentStepType_in = [...where.currentStepType_in];\n        }\n        if (where.title_contains !== undefined) {\n            values.title_contains = where.title_contains;\n        }\n        if (where.lastChangedOn_gte !== undefined) {\n            values.lastChangedOn_gte = where.lastChangedOn_gte;\n        }\n        if (where.lastChangedOn_lte !== undefined) {\n            values.lastChangedOn_lte = where.lastChangedOn_lte;\n        }\n        const requester: CmsEntryListWhereValues = {};\n        if (where.requesterId !== undefined) {\n            requester.id = where.requesterId;\n        }\n        if (where.requesterId_not !== undefined) {\n            requester.id_not = where.requesterId_not;\n        }\n        if (Object.keys(requester).length > 0) {\n            values.requester = requester;\n        }\n\n        const listWhere: CmsEntryListWhere = { values };\n        applyReadFilter(listWhere, where.read);\n        // An empty list would match nothing on some storages: leave the filter out.\n        if (where.id_not_in?.length) {\n            listWhere.entryId_not_in = [...where.id_not_in];\n        }\n\n        const result = await this.listLatestEntries.execute<ReviewEntryValues>(model, {\n            where: listWhere,\n            // Values fields sort with the `values_` prefix (CMS sort mapper).\n            sort: [`values_${params.sort}`],\n            limit: params.limit,\n            after: params.after ?? null\n        });\n        if (result.isFail()) {\n            return Result.fail(new ReviewPersistenceError(result.error));\n        }\n        return Result.ok({\n            items: result.value.entries.map(entry => ReviewEntryMapper.fromEntry(entry)),\n            meta: result.value.meta\n        });\n    }\n\n    async create(review: ReviewData): Promise<Result<ReviewData, ReviewPersistenceError>> {\n        const model = await this.modelProvider.get();\n        const created = await this.createEntry.execute<ReviewEntryValues>(model, {\n            id: review.id,\n            // The aggregate's `now`, so `createdOn` matches the `requested` fact (A5).\n            createdOn: review.createdOn,\n            values: ReviewEntryMapper.toValues(review)\n        });\n        if (created.isFail()) {\n            return Result.fail(new ReviewPersistenceError(created.error));\n        }\n        return Result.ok(ReviewEntryMapper.fromEntry(created.value));\n    }\n\n    async update(\n        review: ReviewData\n    ): Promise<Result<ReviewData, ReviewNotFoundError | ReviewPersistenceError>> {\n        const model = await this.modelProvider.get();\n        const id = createIdentifier({ id: review.id, version: 1 });\n        const updated = await this.updateEntry.execute<ReviewEntryValues>(model, id, {\n            values: ReviewEntryMapper.toValues(review)\n        });\n        if (updated.isFail()) {\n            if (updated.error.code === ENTRY_NOT_FOUND) {\n                return Result.fail(new ReviewNotFoundError({ id: review.id }));\n            }\n            return Result.fail(new ReviewPersistenceError(updated.error));\n        }\n        return Result.ok(ReviewEntryMapper.fromEntry(updated.value));\n    }\n\n    async deleteMany(ids: string[]): Promise<Result<void, ReviewPersistenceError>> {\n        const uniqueIds = [...new Set(ids)];\n        if (uniqueIds.length === 0) {\n            return Result.ok();\n        }\n        const model = await this.modelProvider.get();\n        // Deletes permanently (every revision); ids that are not found are skipped. The model is\n        // private, so its access checks pass and the workflows hooks ignore its events.\n        for (const chunk of toChunks(uniqueIds, DELETE_MULTIPLE_LIMIT)) {\n            // oxlint-disable-next-line no-await-in-loop -- one delete-multiple call per chunk of the CMS limit.\n            const result = await this.deleteMultipleEntries.execute(model, { entries: chunk });\n            if (result.isFail()) {\n                return Result.fail(new ReviewPersistenceError(result.error));\n            }\n        }\n        return Result.ok();\n    }\n}\n\nexport const ReviewRepository = ReviewRepositoryAbstraction.createImplementation({\n    implementation: ReviewRepositoryImpl,\n    dependencies: [\n        ReviewModelProvider,\n        GetEntryByIdUseCase,\n        GetEntriesByIdsUseCase,\n        ListLatestEntriesUseCase,\n        CreateEntryUseCase,\n        UpdateEntryUseCase,\n        DeleteMultipleEntriesUseCase,\n        GetUniqueFieldValuesUseCase\n    ]\n});\n"],"names":["ENTRY_NOT_FOUND","ACTIVE_BY_TARGET_LIMIT","COUNT_PAGE_SIZE","DELETE_MULTIPLE_LIMIT","TARGET_IDS_PER_QUERY","applyReadFilter","where","read","values","ownOnlyModels","model","targetContext","Object","ReviewRepositoryImpl","modelProvider","getEntryById","getEntriesByIds","listLatestEntries","createEntry","updateEntry","deleteMultipleEntries","getUniqueFieldValues","id","result","createIdentifier","Result","ReviewNotFoundError","ReviewPersistenceError","ReviewEntryMapper","ids","uniqueIds","Set","revisionIds","byId","Map","entry","review","reviews","params","listedIds","parseIdentifier","primary","active","models","item","Boolean","workflowId","ownerIds","after","meta","targetIds","chunk","toChunks","listed","keep","emptyIn","undefined","requester","listWhere","created","updated","ReviewRepository","ReviewRepositoryAbstraction","ReviewModelProvider","GetEntryByIdUseCase","GetEntriesByIdsUseCase","ListLatestEntriesUseCase","CreateEntryUseCase","UpdateEntryUseCase","DeleteMultipleEntriesUseCase","GetUniqueFieldValuesUseCase"],"mappings":"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"}

package/features/review/shared/events.d.ts

@@ -0,0 +1,38 @@
+import { DomainEvent } from "@webiny/api-core/features/eventPublisher/index.js";
+import type { IEventHandler } from "@webiny/api-core/features/eventPublisher/index.js";
+import type { ReviewStepFailedFact } from "../../../domain/review/facts.js";
+import type { ReviewData } from "../../../domain/review/types.js";
+import type { ReviewFact } from "../../../domain/review/facts.js";
+import type { ReviewRequestedEvent } from "../RequestReview/events.js";
+import type { ReviewStepApprovedEvent } from "../ApproveReviewStep/events.js";
+import type { ReviewApprovedEvent } from "../ApproveReviewStep/events.js";
+import type { ReviewStepRejectedEvent } from "../RejectReviewStep/events.js";
+import type { ReviewCancelledEvent } from "../CancelReview/events.js";
+import type { ReviewStepReassignedEvent } from "../ReassignReviewStep/events.js";
+import type { ReviewStepStartedEvent } from "../StartReviewStep/events.js";
+import type { ReviewStepTakenOverEvent } from "../TakeOverReviewStep/events.js";
+import type { ReviewStepRestartedEvent } from "../RestartReviewStep/events.js";
+import type { ReviewStepReachedEvent } from "../ReviewStepReacher/events.js";
+/**
+ * Every review event carries the persisted review (ids, workflow snapshot, steps) and the fact
+ * (actor, step id, from/to state, comment), enough for a later "Workflows" audit app (spec 9.5).
+ */
+export interface ReviewEventPayload<TFact extends ReviewFact> {
+    review: ReviewData;
+    fact: TFact;
+}
+/**
+ * ReviewStepFailedEvent - published after the review is saved.
+ * The review stays in progress; the step can be restarted, D8.
+ */
+export declare class ReviewStepFailedEvent extends DomainEvent<ReviewEventPayload<ReviewStepFailedFact>> {
+    eventType: "Workflows/Review/StepFailed";
+    getHandlerAbstraction(): import("@webiny/di").Abstraction<IEventHandler<ReviewStepFailedEvent>>;
+}
+export declare const ReviewStepFailedEventHandler: import("@webiny/di").Abstraction<IEventHandler<ReviewStepFailedEvent>>;
+export declare namespace ReviewStepFailedEventHandler {
+    type Interface = IEventHandler<ReviewStepFailedEvent>;
+    type Event = ReviewStepFailedEvent;
+}
+/** Every review event, one per `ReviewFact`; `ReviewSaver` publishes them. */
+export type ReviewEvent = ReviewRequestedEvent | ReviewStepReachedEvent | ReviewStepStartedEvent | ReviewStepTakenOverEvent | ReviewStepReassignedEvent | ReviewStepApprovedEvent | ReviewStepRejectedEvent | ReviewStepFailedEvent | ReviewStepRestartedEvent | ReviewCancelledEvent | ReviewApprovedEvent;

package/features/review/shared/events.js

@@ -0,0 +1,14 @@
+import { createAbstraction } from "@webiny/feature/api";
+import { DomainEvent } from "@webiny/api-core/features/eventPublisher/index.js";
+class ReviewStepFailedEvent extends DomainEvent {
+    getHandlerAbstraction() {
+        return ReviewStepFailedEventHandler;
+    }
+    constructor(...args){
+        super(...args), this.eventType = "Workflows/Review/StepFailed";
+    }
+}
+const ReviewStepFailedEventHandler = createAbstraction("ReviewStepFailedEventHandler");
+export { ReviewStepFailedEvent, ReviewStepFailedEventHandler };
+
+//# sourceMappingURL=events.js.map

package/features/review/shared/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/review/shared/events.js","sources":["../../../../src/features/review/shared/events.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport { DomainEvent } from \"@webiny/api-core/features/eventPublisher/index.js\";\nimport type { IEventHandler } from \"@webiny/api-core/features/eventPublisher/index.js\";\nimport type { ReviewStepFailedFact } from \"~/domain/review/facts.js\";\nimport type { ReviewData } from \"~/domain/review/types.js\";\nimport type { ReviewFact } from \"~/domain/review/facts.js\";\nimport type { ReviewRequestedEvent } from \"../RequestReview/events.js\";\nimport type { ReviewStepApprovedEvent } from \"../ApproveReviewStep/events.js\";\nimport type { ReviewApprovedEvent } from \"../ApproveReviewStep/events.js\";\nimport type { ReviewStepRejectedEvent } from \"../RejectReviewStep/events.js\";\nimport type { ReviewCancelledEvent } from \"../CancelReview/events.js\";\nimport type { ReviewStepReassignedEvent } from \"../ReassignReviewStep/events.js\";\nimport type { ReviewStepStartedEvent } from \"../StartReviewStep/events.js\";\nimport type { ReviewStepTakenOverEvent } from \"../TakeOverReviewStep/events.js\";\nimport type { ReviewStepRestartedEvent } from \"../RestartReviewStep/events.js\";\nimport type { ReviewStepReachedEvent } from \"../ReviewStepReacher/events.js\";\n\n/**\n * Every review event carries the persisted review (ids, workflow snapshot, steps) and the fact\n * (actor, step id, from/to state, comment), enough for a later \"Workflows\" audit app (spec 9.5).\n */\nexport interface ReviewEventPayload<TFact extends ReviewFact> {\n    review: ReviewData;\n    fact: TFact;\n}\n\n/**\n * ReviewStepFailedEvent - published after the review is saved.\n * The review stays in progress; the step can be restarted, D8.\n */\nexport class ReviewStepFailedEvent extends DomainEvent<ReviewEventPayload<ReviewStepFailedFact>> {\n    eventType = \"Workflows/Review/StepFailed\" as const;\n\n    getHandlerAbstraction() {\n        return ReviewStepFailedEventHandler;\n    }\n}\n\nexport const ReviewStepFailedEventHandler = createAbstraction<IEventHandler<ReviewStepFailedEvent>>(\n    \"ReviewStepFailedEventHandler\"\n);\n\nexport namespace ReviewStepFailedEventHandler {\n    export type Interface = IEventHandler<ReviewStepFailedEvent>;\n    export type Event = ReviewStepFailedEvent;\n}\n\n/** Every review event, one per `ReviewFact`; `ReviewSaver` publishes them. */\nexport type ReviewEvent =\n    | ReviewRequestedEvent\n    | ReviewStepReachedEvent\n    | ReviewStepStartedEvent\n    | ReviewStepTakenOverEvent\n    | ReviewStepReassignedEvent\n    | ReviewStepApprovedEvent\n    | ReviewStepRejectedEvent\n    | ReviewStepFailedEvent\n    | ReviewStepRestartedEvent\n    | ReviewCancelledEvent\n    | ReviewApprovedEvent;\n"],"names":["ReviewStepFailedEvent","DomainEvent","ReviewStepFailedEventHandler","createAbstraction"],"mappings":";;AA8BO,MAAMA,8BAA8BC;IAGvC,wBAAwB;QACpB,OAAOC;IACX;;QALG,qBACH,SAAS,GAAG;;AAKhB;AAEO,MAAMA,+BAA+BC,kBACxC"}

package/features/review/shared/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const ReviewSharedFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/features/review/shared/feature.js

@@ -0,0 +1,13 @@
+import { createFeature } from "@webiny/feature/api";
+import { ReviewModelProvider } from "./ReviewModelProvider.js";
+import { ReviewRepository } from "./ReviewRepository.js";
+const ReviewSharedFeature = createFeature({
+    name: "Workflows/ReviewShared",
+    register (container) {
+        container.register(ReviewModelProvider);
+        container.register(ReviewRepository).inSingletonScope();
+    }
+});
+export { ReviewSharedFeature };
+
+//# sourceMappingURL=feature.js.map

package/features/review/shared/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/review/shared/feature.js","sources":["../../../../src/features/review/shared/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { ReviewModelProvider } from \"./ReviewModelProvider.js\";\nimport { ReviewRepository } from \"./ReviewRepository.js\";\n\nexport const ReviewSharedFeature = createFeature({\n    name: \"Workflows/ReviewShared\",\n    register(container) {\n        container.register(ReviewModelProvider);\n        container.register(ReviewRepository).inSingletonScope();\n    }\n});\n"],"names":["ReviewSharedFeature","createFeature","container","ReviewModelProvider","ReviewRepository"],"mappings":";;;AAIO,MAAMA,sBAAsBC,cAAc;IAC7C,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;QACnBD,UAAU,QAAQ,CAACE,kBAAkB,gBAAgB;IACzD;AACJ"}

package/features/review/shared/types.d.ts

@@ -0,0 +1,36 @@
+import type { Actor, AiIssue } from "../../../domain/review/types.js";
+/**
+ * Input of step transitions. Internal (D132): the app wrapper builds the actor and team ids
+ * (`CurrentReviewViewer`) and checks target access.
+ */
+export interface ReviewActorInput {
+    reviewId: string;
+    /** The step the caller acted on; fails with `StepNotCurrent` when it is not current (R17). */
+    stepId: string;
+    actor: Actor;
+    /** The actor's teams, checked against the step's `candidateTeamIds` on start and take over. */
+    actorTeamIds: string[];
+}
+export interface ReviewDecisionInput extends ReviewActorInput {
+    comment?: string | null;
+    /**
+     * The findings of an AI decision (D39, R171), stored on the step; omitted means none. Only
+     * the engine's own callers set it: the app wrappers build their input from explicit fields
+     * and do not expose it (D132).
+     */
+    issues?: AiIssue[];
+}
+/** Cancel is review-level: no `stepId` (R17). */
+export interface CancelReviewInput {
+    reviewId: string;
+    /**
+     * Requester or `workflows.reassign`; the app wrapper checks target read access and
+     * `canCancelByPermission` (D132, D133).
+     */
+    actor: Actor;
+    /**
+     * Why the review is cancelled, recorded on the cancelled event; set when content is trashed or
+     * deleted with the review in progress (D134), omitted otherwise.
+     */
+    reason?: string | null;
+}

package/features/routing/InspectRouting/InspectRoutingUseCase.d.ts

@@ -0,0 +1,11 @@
+import { RoutingEvaluatorService } from "../../../features/routing/RoutingEvaluatorService/index.js";
+import { InspectRoutingUseCase as UseCase } from "./abstractions.js";
+declare class InspectRoutingUseCaseImpl implements UseCase.Interface {
+    private routing;
+    constructor(routing: RoutingEvaluatorService.Interface);
+    execute(input: UseCase.Input): UseCase.Return;
+}
+export declare const InspectRoutingUseCase: typeof InspectRoutingUseCaseImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IInspectRoutingUseCase>;
+};
+export {};

package/features/routing/InspectRouting/InspectRoutingUseCase.js

@@ -0,0 +1,92 @@
+import { Result } from "@webiny/feature/api";
+import { INSPECTION_CANDIDATE_LIMIT } from "../../../constants.js";
+import { reviewStepConfigSchema } from "../../../domain/workflow/reviewStepConfigSchema.js";
+import { WorkflowValidationError } from "../../../domain/workflow/errors.js";
+import { findReviewStepConfigProblem } from "../../../domain/workflow/findReviewStepConfigProblem.js";
+import { findRuleWithoutTarget } from "../../../domain/workflow/findRuleWithoutTarget.js";
+import { RULES_FIELD, RULE_TARGET_FIELD, RULE_TARGET_TEAM_OUTSIDE_TEAMS_MESSAGE, getRuleIdDuplicateMessage, getRuleTargetMissingMessage } from "../../../domain/workflow/ruleErrorMessages.js";
+import { RoutingDependencyError } from "../../../domain/routing/errors.js";
+import { findNarrowedTeamId } from "../../../domain/routing/findNarrowedTeamId.js";
+import { toInspectionTrace } from "../../../domain/routing/toInspectionTrace.js";
+import { RoutingEvaluatorService } from "../RoutingEvaluatorService/index.js";
+import { InspectRoutingUseCase } from "./abstractions.js";
+class InspectRoutingUseCaseImpl {
+    constructor(routing){
+        this.routing = routing;
+    }
+    async execute(input) {
+        const withoutTarget = findRuleWithoutTarget(input.stepConfig);
+        if (withoutTarget) return Result.fail(new WorkflowValidationError(getRuleTargetMissingMessage(null), {
+            field: RULE_TARGET_FIELD,
+            ruleId: withoutTarget.ruleId
+        }));
+        const parsed = reviewStepConfigSchema.safeParse(input.stepConfig);
+        if (!parsed.success) {
+            const [issue] = parsed.error.issues;
+            return Result.fail(new WorkflowValidationError(`The step configuration is invalid: ${issue?.message ?? "unknown error"}`));
+        }
+        const problem = findReviewStepConfigProblem(parsed.data);
+        if (problem?.type === "noTeams") return Result.fail(new WorkflowValidationError("The step configuration is invalid: the step needs at least one team."));
+        if (problem?.type === "duplicateRuleId") return Result.fail(new WorkflowValidationError(getRuleIdDuplicateMessage(null, problem.ruleId), {
+            field: RULES_FIELD
+        }));
+        if (problem?.type === "teamTargetOutsideTeams") return Result.fail(new WorkflowValidationError(RULE_TARGET_TEAM_OUTSIDE_TEAMS_MESSAGE, {
+            field: RULE_TARGET_FIELD,
+            ruleId: problem.ruleId
+        }));
+        let evaluated;
+        try {
+            evaluated = await this.routing.evaluate({
+                config: parsed.data,
+                model: input.model,
+                workflowId: null,
+                reviewId: null,
+                stepId: "",
+                requesterId: input.requesterId,
+                pickedUserId: null,
+                folder: input.folder ? {
+                    ...input.folder
+                } : null,
+                read: {
+                    type: "folder",
+                    folderId: input.folder?.id ?? null
+                },
+                now: input.now,
+                explain: true
+            });
+        } catch (error) {
+            return Result.fail(new RoutingDependencyError(error instanceof Error ? error : new Error(String(error))));
+        }
+        if (evaluated.isFail()) return Result.fail(evaluated.error);
+        const evaluation = evaluated.value;
+        const strategyOrder = evaluation.strategyOrder ?? [];
+        const firstCandidates = strategyOrder.slice(0, INSPECTION_CANDIDATE_LIMIT);
+        const candidateIds = firstCandidates.map((candidate)=>candidate.id);
+        const narrowedTeamId = findNarrowedTeamId(parsed.data.assignment.rules, evaluation.ruleId);
+        return Result.ok({
+            owner: evaluation.owner ? {
+                id: evaluation.owner.id,
+                displayName: evaluation.owner.displayName
+            } : null,
+            source: evaluation.source,
+            ruleId: evaluation.ruleId,
+            strategy: evaluation.strategy,
+            trace: toInspectionTrace(evaluation.trace),
+            skipped: evaluation.skipped.map((item)=>({
+                    ...item
+                })),
+            narrowedTeamId,
+            candidateIds,
+            candidateCount: strategyOrder.length
+        });
+    }
+}
+const InspectRoutingUseCase_InspectRoutingUseCase = InspectRoutingUseCase.createImplementation({
+    implementation: InspectRoutingUseCaseImpl,
+    dependencies: [
+        RoutingEvaluatorService
+    ]
+});
+export { InspectRoutingUseCase_InspectRoutingUseCase as InspectRoutingUseCase };
+
+//# sourceMappingURL=InspectRoutingUseCase.js.map