@nocobase/app-plugin-projects 0.0.0-stage → 0.1.0-beta.1

package/dist/server/domains/issues/issue.service.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Issue writes: create, update, and an administrator's delete and restore. Each write records its activities and emits
+ * `issue.changed` plus an event saying what happened, and hands the change to the triggers in the same transaction.
+ */
+import type { ApprovalRequest } from '../../../shared/approvals.js';
+import { type WorkflowEvent } from '../../../shared/workflows.js';
+import type { CreateIssueRequest, Executor, Issue, UpdateIssueRequest } from '../../../shared/issues.js';
+import { type Viewer } from '../../access/viewer.js';
+import type { ActivityRecorder } from '../../kernel/activity.js';
+import { type Actor } from '../../kernel/actor.js';
+import type { IdSource } from '../../kernel/ids.js';
+import type { Tx, TxRunner } from '../../kernel/tx.js';
+import type { SettingsService } from '../settings/index.js';
+import './issue.events.js';
+import { type FieldDeps } from './issue.fields.js';
+import { type IssueApprovals, type IssueRelations, type IssueTriggers } from './ports.js';
+/** Whether a change may start work now; the client asks when it would. */
+interface StartOption {
+    readonly start?: boolean;
+}
+/**
+ * The issue after an update. When the status change waits for approval, the issue is unchanged (nothing in the
+ * request was applied) and `pendingApproval` is the request that holds it.
+ */
+export type IssueUpdateOutcome = Issue & {
+    readonly pendingApproval?: ApprovalRequest;
+};
+export interface IssueService {
+    create(viewer: Viewer, input: CreateIssueRequest & StartOption): Promise<Issue>;
+    update(viewer: Viewer, idOrKey: string, patch: UpdateIssueRequest & StartOption): Promise<IssueUpdateOutcome>;
+    remove(viewer: Viewer, idOrKey: string): Promise<void>;
+    /**
+     * For the plugin whose principal can no longer take work (an agent archived or deleted): clears `executor` from every
+     * live issue it executes that has not finished (a status outside the done and closed categories), in one
+     * transaction, as `cause.actor`. Each is recorded as `executor_changed` to nobody with `reason: 'executorRemoved'` and
+     * the executor's `name`, and goes to the triggers like any change of executor. Answers the issues it changed.
+     */
+    releaseExecutor(executor: Executor, cause: {
+        readonly actor: Actor;
+        readonly name: string;
+    }): Promise<string[]>;
+    /**
+     * For undoing a plan: soft-deletes an issue the viewer created (or any, for one who may delete issues), as `remove`
+     * does, recorded as retracted. Not offered over HTTP; the plans domain checks that its plan created the issue.
+     */
+    retract(viewer: Viewer, idOrKey: string): Promise<void>;
+    restore(viewer: Viewer, idOrKey: string): Promise<Issue>;
+    /**
+     * For the approvals domain, in its transaction: the move an approver accepted, checked again as the requester's
+     * (who may, and the guards) and recorded as the system's with the approver named. Null when it moved, else why not.
+     */
+    applyApproved(tx: Tx, request: {
+        readonly id: string;
+        readonly issueId: string;
+        readonly fromStatus: string;
+        readonly toStatus: string;
+        readonly requestedByType: string;
+        readonly requestedById: string;
+    }, approver: Actor): Promise<{
+        readonly code: string;
+        readonly message: string;
+    } | null>;
+    /**
+     * In the caller's transaction (the subtasks domain's, or a contributed event's through `workflowEvents.fire`): moves
+     * the issue where a workflow event takes it, as the system. The activity names the event and its cause, and is
+     * recorded as `cause.actor` when given (the person whose action the event reports). A guard's refusal is recorded
+     * as `auto_move_skipped` and nothing moves; without an event transition from its status nothing happens. A finished
+     * issue ignores the built-in events.
+     */
+    fireEvent(tx: Tx, issueId: string, event: WorkflowEvent, cause: EventCause): Promise<EventMove>;
+    /**
+     * Where `fireEvent` would take the issue, without moving it: the status its workflow's transition on the event
+     * enters, or why there is none. Entry conditions are not checked, so a move this answers may still be refused.
+     */
+    eventTarget(conn: Tx['conn'], issueId: string, event: WorkflowEvent): Promise<EventTarget>;
+}
+/** Where a workflow event would take an issue (`eventTarget`). */
+export type EventTarget = {
+    readonly issueId: string;
+    readonly from: string;
+    readonly to: string;
+} | {
+    readonly issueId: string;
+    readonly to: null;
+    /** As `EventMove`'s `ignored`: no such live issue, no transition on the event, or finished and built in. */
+    readonly reason: 'notFound' | 'noTransition' | 'finished';
+};
+/** What made a workflow event happen, as the activity records it. */
+export interface EventCause {
+    /** The issue whose change caused it (the last sub-issue finished). */
+    readonly issueId?: string;
+    /** Who the activity names; the system when left out. The move itself is always the system's. */
+    readonly actor?: Actor;
+    /** A short phrase shown with the move, as it is (`#12 merged`). */
+    readonly note?: string;
+    /** Kept with the activity, opaque to this plugin. */
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+/** What a workflow event did to one issue. */
+export type EventMove = {
+    readonly issueId: string;
+    readonly outcome: 'moved';
+    readonly from: string;
+    readonly to: string;
+} | {
+    readonly issueId: string;
+    readonly outcome: 'ignored';
+    /** No such live issue, no transition on the event from its status, or a finished issue and a built-in event. */
+    readonly reason: 'notFound' | 'noTransition' | 'finished';
+} | {
+    readonly issueId: string;
+    readonly outcome: 'refused';
+    readonly from: string;
+    readonly to: string;
+    /** The guard's code, such as `CHECKLIST_INCOMPLETE`, and its message. */
+    readonly code: string;
+    readonly message: string;
+};
+export interface IssueDeps extends FieldDeps {
+    readonly tx: TxRunner;
+    readonly ids: IdSource;
+    readonly activity: ActivityRecorder;
+    readonly settings: Pick<SettingsService, 'allocateIssueNumber'>;
+    readonly triggers: () => IssueTriggers;
+    readonly approvals: () => IssueApprovals;
+    readonly relations: () => IssueRelations;
+}
+export declare function createIssueService(deps: IssueDeps): IssueService;
+export {};
+//# sourceMappingURL=issue.service.d.ts.map

package/dist/server/domains/issues/issue.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.service.d.ts","sourceRoot":"","sources":["../../../../server/domains/issues/issue.service.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/issues/issue.service.js

@@ -0,0 +1,374 @@
+import { isBuiltInEvent, } from '../../../shared/workflows.js';
+import { scopeOf } from '../../access/viewer.js';
+import { SYSTEM_ACTOR } from '../../kernel/actor.js';
+import { DomainError, forbidden, invalid, notFound, } from '../../kernel/errors.js';
+import { mentions, newMentions } from '../../kernel/mentions.js';
+import { updateProject } from '../projects/index.js';
+import { requireDeleter, requireCreator, requireEditor, requireVisible, } from './issue.access.js';
+import './issue.events.js';
+import { resolveCreate, resolveUpdate, } from './issue.fields.js';
+import { findIssue, insertIssue, issuesExecutedBy, setIssueLabels, updateIssue, } from './issue.store.js';
+import { moveIssue } from './issue.status.js';
+import { isTerminal, } from './ports.js';
+function eventActor(actor) {
+    return { type: actor.type, id: actor.id };
+}
+function changeSet(before, after) {
+    const mentioned = newMentions(before.description, after.description);
+    return {
+        ...(before.statusKey === after.statusKey
+            ? {}
+            : { status: { from: before.statusKey, to: after.statusKey } }),
+        ...(before.ownerUserId === after.ownerUserId
+            ? {}
+            : { owner: { from: before.ownerUserId, to: after.ownerUserId } }),
+        ...(before.executor?.type === after.executor?.type &&
+            before.executor?.id === after.executor?.id
+            ? {}
+            : { executor: { from: before.executor, to: after.executor } }),
+        ...(mentioned.length > 0 ? { mentions: mentioned } : {}),
+    };
+}
+async function reload(tx, id) {
+    return (await findIssue(tx.conn, id));
+}
+export function createIssueService(deps) {
+    const record = (tx, issueId, actor, action, details = {}) => deps.activity.record(tx.conn, { issueId, actor, action, details });
+    /** After an update is written: the triggers, the stale approvals, and what changed. */
+    async function announce(tx, before, after, actor, start, approvedRequest) {
+        await deps.triggers().onIssueChanged(tx, { before, after, actor, start });
+        if (before.statusKey !== after.statusKey)
+            await deps
+                .approvals()
+                .supersede(tx, after.id, after.statusKey, approvedRequest);
+        await deps.relations().changed(tx, { before, after, actor });
+        tx.emit({ type: 'issue.changed', issueId: after.id });
+        for (const parentId of new Set([before.parentIssueId, after.parentIssueId]))
+            if (parentId)
+                tx.emit({ type: 'issue.changed', issueId: parentId });
+        const changes = changeSet(before, after);
+        if (Object.keys(changes).length > 0)
+            tx.emit({
+                type: 'issue.updated',
+                issueId: after.id,
+                actor: eventActor(actor),
+                changes,
+                revision: after.revision,
+            });
+    }
+    const service = {
+        async create(viewer, input) {
+            requireCreator(viewer);
+            return deps.tx.run(async (tx) => {
+                const values = await resolveCreate({ ...deps, conn: tx.conn, viewer }, input);
+                const { number, identifier } = await deps.settings.allocateIssueNumber(tx);
+                const id = deps.ids.next();
+                const now = new Date().toISOString();
+                await insertIssue(tx.conn, {
+                    id,
+                    number,
+                    identifier,
+                    title: values.title,
+                    description: values.description,
+                    statusKey: values.statusKey,
+                    priority: values.priority,
+                    ownerUserId: values.ownerUserId,
+                    executorType: values.executor?.type ?? null,
+                    executorId: values.executor?.id ?? null,
+                    parentIssueId: values.parentIssueId,
+                    stage: values.stage,
+                    projectId: values.projectId,
+                    startDate: values.startDate,
+                    dueDate: values.dueDate,
+                    createdById: viewer.userId,
+                    lastActivityAt: now,
+                    createdAt: now,
+                    updatedAt: now,
+                });
+                if (values.labelIds.length > 0)
+                    await setIssueLabels(tx.conn, () => deps.ids.next(), id, values.labelIds);
+                await record(tx, id, viewer.actor, 'issue_created', { identifier });
+                // Every issue created in the project from now on waits for this one until it is finished.
+                if (values.projectSetup && values.projectId)
+                    await updateProject(tx.conn, values.projectId, { setupIssueId: id });
+                if (values.parentIssueId) {
+                    await record(tx, values.parentIssueId, viewer.actor, 'subtask_added', {
+                        issueId: id,
+                        identifier,
+                    });
+                    tx.emit({ type: 'issue.changed', issueId: values.parentIssueId });
+                }
+                const issue = await reload(tx, id);
+                await deps.relations().created(tx, issue, values.blockedBy, viewer);
+                await deps.triggers().onIssueChanged(tx, {
+                    before: null,
+                    after: issue,
+                    actor: viewer.actor,
+                    start: input.start !== false,
+                });
+                tx.emit({ type: 'issue.changed', issueId: id });
+                tx.emit({
+                    type: 'issue.created',
+                    issueId: id,
+                    actor: eventActor(viewer.actor),
+                    mentions: mentions(values.description),
+                });
+                return issue;
+            });
+        },
+        async update(viewer, idOrKey, patch) {
+            if (!Number.isInteger(patch?.revision))
+                throw invalid('REVISION_REQUIRED', 'revision is required.');
+            return deps.tx.run(async (tx) => {
+                const before = await requireVisible(tx.conn, viewer, idOrKey);
+                requireEditor(viewer);
+                const { values, activities, labelIds, status, placed } = await resolveUpdate({ ...deps, conn: tx.conn, viewer }, before, patch);
+                let written = false;
+                const write = async () => {
+                    const labels = labelIds
+                        ? await setIssueLabels(tx.conn, () => deps.ids.next(), before.id, labelIds)
+                        : { added: [], removed: [] };
+                    if (labels.added.length > 0 || labels.removed.length > 0)
+                        activities.push({ action: 'labels_changed', details: labels });
+                    if (activities.length === 0)
+                        return;
+                    const now = new Date().toISOString();
+                    await updateIssue(tx.conn, before.id, { ...values, updatedAt: now, lastActivityAt: now }, patch.revision);
+                    for (const { action, details } of activities)
+                        await record(tx, before.id, viewer.actor, action, details);
+                    written = true;
+                };
+                if (status) {
+                    const moved = await moveIssue(deps, tx, {
+                        issue: before,
+                        catalog: status.catalog,
+                        to: status.to,
+                        actor: viewer.actor,
+                        write,
+                    });
+                    if (moved.outcome === 'pending') {
+                        const pendingApproval = await deps.approvals().request(tx, {
+                            issue: before,
+                            toStatus: status.to,
+                            actor: viewer.actor,
+                            approvers: moved.approvers,
+                            approverIds: moved.approverIds,
+                        });
+                        return { ...before, pendingApproval };
+                    }
+                    if (moved.outcome === 'moved' && moved.approval !== 'none')
+                        await record(tx, before.id, viewer.actor, moved.approval === 'self'
+                            ? 'approval_self'
+                            : 'approval_no_approver', { from: before.statusKey, to: status.to });
+                }
+                else
+                    await write();
+                if (!written)
+                    return before;
+                const after = await reload(tx, before.id);
+                if (placed)
+                    await deps.relations().placed(tx, after);
+                await announce(tx, before, after, viewer.actor, patch.start !== false);
+                return after;
+            });
+        },
+        async applyApproved(tx, request, approver) {
+            const issue = await findIssue(tx.conn, request.issueId);
+            if (!issue || issue.deletedAt)
+                return { code: 'ISSUE_GONE', message: 'The issue was deleted.' };
+            if (issue.statusKey !== request.fromStatus)
+                return {
+                    code: 'STATUS_CHANGED',
+                    message: `The issue left ${request.fromStatus} meanwhile.`,
+                };
+            const catalog = await deps.statuses.forProject(tx.conn, issue.projectId);
+            try {
+                await moveIssue(deps, tx, {
+                    issue,
+                    catalog,
+                    to: request.toStatus,
+                    actor: { type: request.requestedByType, id: request.requestedById },
+                    approved: true,
+                    write: async () => {
+                        const now = new Date().toISOString();
+                        await updateIssue(tx.conn, issue.id, {
+                            statusKey: request.toStatus,
+                            updatedAt: now,
+                            lastActivityAt: now,
+                        });
+                        await record(tx, issue.id, SYSTEM_ACTOR, 'status_changed', {
+                            from: issue.statusKey,
+                            to: request.toStatus,
+                            requestId: request.id,
+                            approvedById: approver.id,
+                        });
+                    },
+                });
+            }
+            catch (error) {
+                if (error instanceof DomainError)
+                    return { code: error.code, message: error.message };
+                throw error;
+            }
+            await announce(tx, issue, await reload(tx, issue.id), SYSTEM_ACTOR, true, request.id);
+            return null;
+        },
+        async eventTarget(conn, issueId, event) {
+            const issue = await findIssue(conn, issueId);
+            if (!issue || issue.deletedAt)
+                return { issueId, to: null, reason: 'notFound' };
+            const catalog = await deps.statuses.forProject(conn, issue.projectId);
+            if (isBuiltInEvent(event) && isTerminal(catalog, issue.statusKey))
+                return { issueId: issue.id, to: null, reason: 'finished' };
+            const to = catalog.machine.eventTarget(issue.statusKey, event);
+            return to === null
+                ? { issueId: issue.id, to: null, reason: 'noTransition' }
+                : { issueId: issue.id, from: issue.statusKey, to };
+        },
+        async fireEvent(tx, issueId, event, cause) {
+            const issue = await findIssue(tx.conn, issueId);
+            if (!issue || issue.deletedAt)
+                return { issueId, outcome: 'ignored', reason: 'notFound' };
+            const catalog = await deps.statuses.forProject(tx.conn, issue.projectId);
+            if (isBuiltInEvent(event) && isTerminal(catalog, issue.statusKey))
+                return { issueId: issue.id, outcome: 'ignored', reason: 'finished' };
+            const to = catalog.machine.eventTarget(issue.statusKey, event);
+            if (to === null)
+                return {
+                    issueId: issue.id,
+                    outcome: 'ignored',
+                    reason: 'noTransition',
+                };
+            const recorded = cause.actor ?? SYSTEM_ACTOR;
+            try {
+                await moveIssue(deps, tx, {
+                    issue,
+                    catalog,
+                    to,
+                    actor: SYSTEM_ACTOR,
+                    approved: true,
+                    event,
+                    write: async () => {
+                        const now = new Date().toISOString();
+                        await updateIssue(tx.conn, issue.id, {
+                            statusKey: to,
+                            updatedAt: now,
+                            lastActivityAt: now,
+                        });
+                        await record(tx, issue.id, recorded, 'status_changed', {
+                            from: issue.statusKey,
+                            to,
+                            event,
+                            ...(cause.issueId ? { causeIssueId: cause.issueId } : {}),
+                            ...(cause.note ? { note: cause.note } : {}),
+                            ...(cause.details ? { cause: cause.details } : {}),
+                        });
+                    },
+                });
+            }
+            catch (error) {
+                if (!(error instanceof DomainError))
+                    throw error;
+                await record(tx, issue.id, recorded, 'auto_move_skipped', {
+                    event,
+                    to,
+                    code: error.code,
+                    message: error.message,
+                    ...(cause.note ? { note: cause.note } : {}),
+                });
+                tx.emit({ type: 'issue.changed', issueId: issue.id });
+                return {
+                    issueId: issue.id,
+                    outcome: 'refused',
+                    from: issue.statusKey,
+                    to,
+                    code: error.code,
+                    message: error.message,
+                };
+            }
+            await announce(tx, issue, await reload(tx, issue.id), SYSTEM_ACTOR, true);
+            return { issueId: issue.id, outcome: 'moved', from: issue.statusKey, to };
+        },
+        async remove(viewer, idOrKey) {
+            requireDeleter(viewer);
+            await softDelete(viewer, idOrKey, false);
+        },
+        releaseExecutor: (executor, cause) => deps.tx.run(async (tx) => {
+            const released = [];
+            for (const before of await issuesExecutedBy(tx.conn, executor)) {
+                const catalog = await deps.statuses.forProject(tx.conn, before.projectId);
+                if (isTerminal(catalog, before.statusKey))
+                    continue;
+                const now = new Date().toISOString();
+                await updateIssue(tx.conn, before.id, {
+                    executorType: null,
+                    executorId: null,
+                    updatedAt: now,
+                    lastActivityAt: now,
+                });
+                await record(tx, before.id, cause.actor, 'executor_changed', {
+                    from: before.executor,
+                    to: null,
+                    reason: 'executorRemoved',
+                    name: cause.name,
+                });
+                await announce(tx, before, await reload(tx, before.id), cause.actor, false);
+                released.push(before.id);
+            }
+            return released;
+        }),
+        async retract(viewer, idOrKey) {
+            await softDelete(viewer, idOrKey, true);
+        },
+        async restore(viewer, idOrKey) {
+            requireDeleter(viewer);
+            return deps.tx.run(async (tx) => {
+                const issue = await findIssue(tx.conn, idOrKey);
+                if (!issue?.deletedAt)
+                    throw notFound('Deleted issue');
+                const now = new Date().toISOString();
+                await updateIssue(tx.conn, issue.id, {
+                    deletedAt: null,
+                    deletedById: null,
+                    updatedAt: now,
+                });
+                await record(tx, issue.id, viewer.actor, 'issue_restored');
+                tx.emit({ type: 'issue.changed', issueId: issue.id });
+                tx.emit({
+                    type: 'issue.restored',
+                    issueId: issue.id,
+                    actor: eventActor(viewer.actor),
+                });
+                return reload(tx, issue.id);
+            });
+        },
+    };
+    return service;
+    /** `remove`, or with `retracted` the creator's own removal of what a plan created. */
+    async function softDelete(viewer, idOrKey, retracted) {
+        await deps.tx.run(async (tx) => {
+            const issue = await requireVisible(tx.conn, viewer, idOrKey);
+            if (retracted &&
+                issue.createdById !== viewer.userId &&
+                scopeOf(viewer, 'pm.issues', 'delete') !== 'all')
+                throw forbidden('Only its creator may take an issue back.');
+            const now = new Date().toISOString();
+            await updateIssue(tx.conn, issue.id, {
+                deletedAt: now,
+                deletedById: viewer.userId,
+                updatedAt: now,
+            });
+            await record(tx, issue.id, viewer.actor, 'issue_deleted', retracted ? { retracted: true } : {});
+            await deps
+                .relations()
+                .removed(tx, { ...issue, deletedAt: now }, viewer.actor);
+            tx.emit({ type: 'issue.changed', issueId: issue.id });
+            tx.emit({
+                type: 'issue.deleted',
+                issueId: issue.id,
+                actor: eventActor(viewer.actor),
+            });
+        });
+    }
+}
+//# sourceMappingURL=issue.service.js.map

package/dist/server/domains/issues/issue.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.service.js","sourceRoot":"","sources":["../../../../server/domains/issues/issue.service.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/issues/issue.status.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Moving an issue to another status: the workflow's machine and rules (`server/lifecycle`), run in the caller's
+ * transaction. The lifecycle's refusals become this plugin's errors: an unknown status is 400 `INVALID_STATUS`, a move
+ * nobody allowed 400 `TRANSITION_NOT_ALLOWED`, and a guard's refusal 400 with the guard's own code (such as
+ * `CHECKLIST_INCOMPLETE`).
+ *
+ * Entry actions run each in a savepoint, with their events kept only when they succeed; one that fails is recorded as
+ * `stage_action_failed` and the move stands. What the rules other plugins contribute did is recorded too
+ * (`stage_action_applied`, or `stage_action_skipped` with its reason, `unavailable` when the rule's plugin is gone).
+ */
+import type { Issue } from '../../../shared/issues.js';
+import type { ActivityRecorder } from '../../kernel/activity.js';
+import type { Actor } from '../../kernel/actor.js';
+import type { Tx } from '../../kernel/tx.js';
+import { type MoveResult } from '../../lifecycle/index.js';
+import type { StatusCatalog } from './ports.js';
+export interface IssueMove {
+    readonly issue: Issue;
+    readonly catalog: StatusCatalog;
+    readonly to: string;
+    readonly actor: Actor;
+    /** The move was approved already. */
+    readonly approved?: boolean;
+    /** The workflow event the move answers: only that event's transitions are taken. */
+    readonly event?: string;
+    /** Writes the change; runs only when the move may happen now. */
+    readonly write: () => Promise<void>;
+}
+export declare function moveIssue(deps: {
+    readonly activity: ActivityRecorder;
+}, tx: Tx, input: IssueMove): Promise<MoveResult>;
+//# sourceMappingURL=issue.status.d.ts.map

package/dist/server/domains/issues/issue.status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.status.d.ts","sourceRoot":"","sources":["../../../../server/domains/issues/issue.status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAkBD,wBAAsB,SAAS,CAC7B,IAAI,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,EAC7C,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,UAAU,CAAC,CAoErB"}