@contractspec/example.workflow-system 0.0.0-canary-20260113170453

package/dist/instance/instance.operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.operations.d.ts","names":[],"sources":["../../src/instance/instance.operations.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/instance/instance.operations.js

@@ -0,0 +1,464 @@
+import { InstanceStatusEnum } from "./instance.enum.js";
+import { StartWorkflowInputModel, TransitionInputModel, TransitionResultModel, WorkflowInstanceModel } from "./instance.schema.js";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts/operations";
+
+//#region src/instance/instance.operations.ts
+const OWNERS = ["@example.workflow-system"];
+/**
+* Start a new workflow instance.
+*/
+const StartWorkflowContract = defineCommand({
+	meta: {
+		key: "workflow.instance.start",
+		version: "1.0.0",
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"workflow",
+			"instance",
+			"start"
+		],
+		description: "Start a new workflow instance.",
+		goal: "Initiate a workflow for a business process.",
+		context: "Order creation, request submission, etc."
+	},
+	io: {
+		input: StartWorkflowInputModel,
+		output: WorkflowInstanceModel
+	},
+	policy: { auth: "user" },
+	sideEffects: {
+		emits: [{
+			key: "workflow.instance.started",
+			version: "1.0.0",
+			when: "Workflow starts",
+			payload: WorkflowInstanceModel
+		}, {
+			key: "workflow.step.entered",
+			version: "1.0.0",
+			when: "First step entered",
+			payload: WorkflowInstanceModel
+		}],
+		audit: ["workflow.instance.started"]
+	},
+	acceptance: {
+		scenarios: [{
+			key: "start-workflow-happy-path",
+			given: ["Workflow definition exists"],
+			when: ["User starts workflow"],
+			then: ["Instance is created and started"]
+		}],
+		examples: [{
+			key: "start-onboarding",
+			input: {
+				workflowKey: "onboarding-v1",
+				context: { employeeId: "emp-123" }
+			},
+			output: {
+				id: "inst-456",
+				status: "running"
+			}
+		}]
+	}
+});
+/**
+* Transition workflow to next step.
+*/
+const TransitionWorkflowContract = defineCommand({
+	meta: {
+		key: "workflow.instance.transition",
+		version: "1.0.0",
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"workflow",
+			"instance",
+			"transition",
+			"state-machine"
+		],
+		description: "Transition a workflow instance to the next step.",
+		goal: "Move workflow forward based on action.",
+		context: "Task completion, approval decisions."
+	},
+	io: {
+		input: TransitionInputModel,
+		output: TransitionResultModel
+	},
+	policy: { auth: "user" },
+	sideEffects: {
+		emits: [
+			{
+				key: "workflow.step.exited",
+				version: "1.0.0",
+				when: "Step is exited",
+				payload: WorkflowInstanceModel
+			},
+			{
+				key: "workflow.step.entered",
+				version: "1.0.0",
+				when: "New step is entered",
+				payload: WorkflowInstanceModel
+			},
+			{
+				key: "workflow.instance.completed",
+				version: "1.0.0",
+				when: "Workflow reaches end",
+				payload: WorkflowInstanceModel
+			}
+		],
+		audit: ["workflow.instance.transitioned"]
+	},
+	acceptance: {
+		scenarios: [{
+			key: "transition-workflow-happy-path",
+			given: ["Workflow instance is waiting at step"],
+			when: ["User provides input"],
+			then: ["Instance moves to next step"]
+		}],
+		examples: [{
+			key: "complete-task",
+			input: {
+				instanceId: "inst-456",
+				action: "complete",
+				data: { approved: true }
+			},
+			output: {
+				success: true,
+				nextStep: "notify-hr"
+			}
+		}]
+	}
+});
+/**
+* Pause a running workflow.
+*/
+const PauseWorkflowContract = defineCommand({
+	meta: {
+		key: "workflow.instance.pause",
+		version: "1.0.0",
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"workflow",
+			"instance",
+			"pause"
+		],
+		description: "Pause a running workflow instance.",
+		goal: "Temporarily halt workflow execution.",
+		context: "Administrative action, emergency stop."
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "PauseResumeInput",
+			fields: {
+				instanceId: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: false
+				},
+				reason: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: true
+				}
+			}
+		}),
+		output: WorkflowInstanceModel
+	},
+	policy: { auth: "user" },
+	sideEffects: {
+		emits: [{
+			key: "workflow.instance.paused",
+			version: "1.0.0",
+			when: "Workflow is paused",
+			payload: WorkflowInstanceModel
+		}],
+		audit: ["workflow.instance.paused"]
+	},
+	acceptance: {
+		scenarios: [{
+			key: "pause-workflow-happy-path",
+			given: ["Workflow is running"],
+			when: ["Admin pauses workflow"],
+			then: ["Instance status becomes PAUSED"]
+		}],
+		examples: [{
+			key: "pause-maintenance",
+			input: {
+				instanceId: "inst-456",
+				reason: "System maintenance"
+			},
+			output: {
+				id: "inst-456",
+				status: "paused"
+			}
+		}]
+	}
+});
+/**
+* Resume a paused workflow.
+*/
+const ResumeWorkflowContract = defineCommand({
+	meta: {
+		key: "workflow.instance.resume",
+		version: "1.0.0",
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"workflow",
+			"instance",
+			"resume"
+		],
+		description: "Resume a paused workflow instance.",
+		goal: "Continue workflow execution.",
+		context: "Administrative action."
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "PauseResumeInput",
+			fields: {
+				instanceId: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: false
+				},
+				reason: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: true
+				}
+			}
+		}),
+		output: WorkflowInstanceModel
+	},
+	policy: { auth: "user" },
+	sideEffects: {
+		emits: [{
+			key: "workflow.instance.resumed",
+			version: "1.0.0",
+			when: "Workflow is resumed",
+			payload: WorkflowInstanceModel
+		}],
+		audit: ["workflow.instance.resumed"]
+	},
+	acceptance: {
+		scenarios: [{
+			key: "resume-workflow-happy-path",
+			given: ["Workflow is paused"],
+			when: ["Admin resumes workflow"],
+			then: ["Instance status becomes RUNNING"]
+		}],
+		examples: [{
+			key: "resume-normal",
+			input: {
+				instanceId: "inst-456",
+				reason: "Issue resolved"
+			},
+			output: {
+				id: "inst-456",
+				status: "running"
+			}
+		}]
+	}
+});
+/**
+* Cancel a workflow instance.
+*/
+const CancelWorkflowContract = defineCommand({
+	meta: {
+		key: "workflow.instance.cancel",
+		version: "1.0.0",
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"workflow",
+			"instance",
+			"cancel"
+		],
+		description: "Cancel a workflow instance.",
+		goal: "Terminate workflow without completion.",
+		context: "User request, system cancellation."
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "CancelWorkflowInput",
+			fields: {
+				instanceId: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: false
+				},
+				reason: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: false
+				}
+			}
+		}),
+		output: WorkflowInstanceModel
+	},
+	policy: { auth: "user" },
+	sideEffects: {
+		emits: [{
+			key: "workflow.instance.cancelled",
+			version: "1.0.0",
+			when: "Workflow is cancelled",
+			payload: WorkflowInstanceModel
+		}],
+		audit: ["workflow.instance.cancelled"]
+	},
+	acceptance: {
+		scenarios: [{
+			key: "cancel-workflow-happy-path",
+			given: ["Workflow is running"],
+			when: ["User cancels workflow"],
+			then: ["Instance status becomes CANCELLED"]
+		}],
+		examples: [{
+			key: "cancel-mistake",
+			input: {
+				instanceId: "inst-456",
+				reason: "Created by mistake"
+			},
+			output: {
+				id: "inst-456",
+				status: "cancelled"
+			}
+		}]
+	}
+});
+/**
+* List workflow instances.
+*/
+const ListInstancesContract = defineQuery({
+	meta: {
+		key: "workflow.instance.list",
+		version: "1.0.0",
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"workflow",
+			"instance",
+			"list"
+		],
+		description: "List workflow instances with filtering.",
+		goal: "Browse and search running workflows.",
+		context: "Dashboard, monitoring."
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "ListInstancesInput",
+			fields: {
+				workflowKey: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: true
+				},
+				status: {
+					type: InstanceStatusEnum,
+					isOptional: true
+				},
+				referenceType: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: true
+				},
+				referenceId: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: true
+				},
+				triggeredBy: {
+					type: ScalarTypeEnum.String_unsecure(),
+					isOptional: true
+				},
+				limit: {
+					type: ScalarTypeEnum.Int_unsecure(),
+					isOptional: true,
+					defaultValue: 20
+				},
+				offset: {
+					type: ScalarTypeEnum.Int_unsecure(),
+					isOptional: true,
+					defaultValue: 0
+				}
+			}
+		}),
+		output: defineSchemaModel({
+			name: "ListInstancesOutput",
+			fields: {
+				instances: {
+					type: WorkflowInstanceModel,
+					isArray: true,
+					isOptional: false
+				},
+				total: {
+					type: ScalarTypeEnum.Int_unsecure(),
+					isOptional: false
+				}
+			}
+		})
+	},
+	policy: { auth: "user" },
+	acceptance: {
+		scenarios: [{
+			key: "list-instances-happy-path",
+			given: ["Workflow instances exist"],
+			when: ["User lists instances"],
+			then: ["List of instances is returned"]
+		}],
+		examples: [{
+			key: "list-running",
+			input: {
+				status: "running",
+				limit: 10
+			},
+			output: {
+				instances: [],
+				total: 5
+			}
+		}]
+	}
+});
+/**
+* Get a single workflow instance.
+*/
+const GetInstanceContract = defineQuery({
+	meta: {
+		key: "workflow.instance.get",
+		version: "1.0.0",
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"workflow",
+			"instance",
+			"get"
+		],
+		description: "Get a workflow instance with details.",
+		goal: "View workflow instance details.",
+		context: "Instance detail view."
+	},
+	io: {
+		input: defineSchemaModel({
+			name: "GetInstanceInput",
+			fields: { instanceId: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			} }
+		}),
+		output: WorkflowInstanceModel
+	},
+	policy: { auth: "user" },
+	acceptance: {
+		scenarios: [{
+			key: "get-instance-happy-path",
+			given: ["Instance exists"],
+			when: ["User requests instance details"],
+			then: ["Instance details are returned"]
+		}],
+		examples: [{
+			key: "get-details",
+			input: { instanceId: "inst-456" },
+			output: {
+				id: "inst-456",
+				workflowKey: "onboarding-v1"
+			}
+		}]
+	}
+});
+
+//#endregion
+export { CancelWorkflowContract, GetInstanceContract, ListInstancesContract, PauseWorkflowContract, ResumeWorkflowContract, StartWorkflowContract, TransitionWorkflowContract };
+//# sourceMappingURL=instance.operations.js.map

package/dist/instance/instance.operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.operations.js","names":[],"sources":["../../src/instance/instance.operations.ts"],"sourcesContent":["import {\n  defineCommand,\n  defineQuery,\n} from '@contractspec/lib.contracts/operations';\nimport { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\nimport { InstanceStatusEnum } from './instance.enum';\nimport {\n  StartWorkflowInputModel,\n  TransitionInputModel,\n  TransitionResultModel,\n  WorkflowInstanceModel,\n} from './instance.schema';\n\nconst OWNERS = ['@example.workflow-system'] as const;\n\n/**\n * Start a new workflow instance.\n */\nexport const StartWorkflowContract = defineCommand({\n  meta: {\n    key: 'workflow.instance.start',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['workflow', 'instance', 'start'],\n    description: 'Start a new workflow instance.',\n    goal: 'Initiate a workflow for a business process.',\n    context: 'Order creation, request submission, etc.',\n  },\n  io: {\n    input: StartWorkflowInputModel,\n    output: WorkflowInstanceModel,\n  },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'workflow.instance.started',\n        version: '1.0.0',\n        when: 'Workflow starts',\n        payload: WorkflowInstanceModel,\n      },\n      {\n        key: 'workflow.step.entered',\n        version: '1.0.0',\n        when: 'First step entered',\n        payload: WorkflowInstanceModel,\n      },\n    ],\n    audit: ['workflow.instance.started'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'start-workflow-happy-path',\n        given: ['Workflow definition exists'],\n        when: ['User starts workflow'],\n        then: ['Instance is created and started'],\n      },\n    ],\n    examples: [\n      {\n        key: 'start-onboarding',\n        input: {\n          workflowKey: 'onboarding-v1',\n          context: { employeeId: 'emp-123' },\n        },\n        output: { id: 'inst-456', status: 'running' },\n      },\n    ],\n  },\n});\n\n/**\n * Transition workflow to next step.\n */\nexport const TransitionWorkflowContract = defineCommand({\n  meta: {\n    key: 'workflow.instance.transition',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['workflow', 'instance', 'transition', 'state-machine'],\n    description: 'Transition a workflow instance to the next step.',\n    goal: 'Move workflow forward based on action.',\n    context: 'Task completion, approval decisions.',\n  },\n  io: {\n    input: TransitionInputModel,\n    output: TransitionResultModel,\n  },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'workflow.step.exited',\n        version: '1.0.0',\n        when: 'Step is exited',\n        payload: WorkflowInstanceModel,\n      },\n      {\n        key: 'workflow.step.entered',\n        version: '1.0.0',\n        when: 'New step is entered',\n        payload: WorkflowInstanceModel,\n      },\n      {\n        key: 'workflow.instance.completed',\n        version: '1.0.0',\n        when: 'Workflow reaches end',\n        payload: WorkflowInstanceModel,\n      },\n    ],\n    audit: ['workflow.instance.transitioned'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'transition-workflow-happy-path',\n        given: ['Workflow instance is waiting at step'],\n        when: ['User provides input'],\n        then: ['Instance moves to next step'],\n      },\n    ],\n    examples: [\n      {\n        key: 'complete-task',\n        input: {\n          instanceId: 'inst-456',\n          action: 'complete',\n          data: { approved: true },\n        },\n        output: { success: true, nextStep: 'notify-hr' },\n      },\n    ],\n  },\n});\n\n/**\n * Pause a running workflow.\n */\nexport const PauseWorkflowContract = defineCommand({\n  meta: {\n    key: 'workflow.instance.pause',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['workflow', 'instance', 'pause'],\n    description: 'Pause a running workflow instance.',\n    goal: 'Temporarily halt workflow execution.',\n    context: 'Administrative action, emergency stop.',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'PauseResumeInput',\n      fields: {\n        instanceId: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: false,\n        },\n        reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n      },\n    }),\n    output: WorkflowInstanceModel,\n  },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'workflow.instance.paused',\n        version: '1.0.0',\n        when: 'Workflow is paused',\n        payload: WorkflowInstanceModel,\n      },\n    ],\n    audit: ['workflow.instance.paused'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'pause-workflow-happy-path',\n        given: ['Workflow is running'],\n        when: ['Admin pauses workflow'],\n        then: ['Instance status becomes PAUSED'],\n      },\n    ],\n    examples: [\n      {\n        key: 'pause-maintenance',\n        input: { instanceId: 'inst-456', reason: 'System maintenance' },\n        output: { id: 'inst-456', status: 'paused' },\n      },\n    ],\n  },\n});\n\n/**\n * Resume a paused workflow.\n */\nexport const ResumeWorkflowContract = defineCommand({\n  meta: {\n    key: 'workflow.instance.resume',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['workflow', 'instance', 'resume'],\n    description: 'Resume a paused workflow instance.',\n    goal: 'Continue workflow execution.',\n    context: 'Administrative action.',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'PauseResumeInput',\n      fields: {\n        instanceId: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: false,\n        },\n        reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n      },\n    }),\n    output: WorkflowInstanceModel,\n  },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'workflow.instance.resumed',\n        version: '1.0.0',\n        when: 'Workflow is resumed',\n        payload: WorkflowInstanceModel,\n      },\n    ],\n    audit: ['workflow.instance.resumed'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'resume-workflow-happy-path',\n        given: ['Workflow is paused'],\n        when: ['Admin resumes workflow'],\n        then: ['Instance status becomes RUNNING'],\n      },\n    ],\n    examples: [\n      {\n        key: 'resume-normal',\n        input: { instanceId: 'inst-456', reason: 'Issue resolved' },\n        output: { id: 'inst-456', status: 'running' },\n      },\n    ],\n  },\n});\n\n/**\n * Cancel a workflow instance.\n */\nexport const CancelWorkflowContract = defineCommand({\n  meta: {\n    key: 'workflow.instance.cancel',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['workflow', 'instance', 'cancel'],\n    description: 'Cancel a workflow instance.',\n    goal: 'Terminate workflow without completion.',\n    context: 'User request, system cancellation.',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'CancelWorkflowInput',\n      fields: {\n        instanceId: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: false,\n        },\n        reason: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: false,\n        },\n      },\n    }),\n    output: WorkflowInstanceModel,\n  },\n  policy: { auth: 'user' },\n  sideEffects: {\n    emits: [\n      {\n        key: 'workflow.instance.cancelled',\n        version: '1.0.0',\n        when: 'Workflow is cancelled',\n        payload: WorkflowInstanceModel,\n      },\n    ],\n    audit: ['workflow.instance.cancelled'],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'cancel-workflow-happy-path',\n        given: ['Workflow is running'],\n        when: ['User cancels workflow'],\n        then: ['Instance status becomes CANCELLED'],\n      },\n    ],\n    examples: [\n      {\n        key: 'cancel-mistake',\n        input: { instanceId: 'inst-456', reason: 'Created by mistake' },\n        output: { id: 'inst-456', status: 'cancelled' },\n      },\n    ],\n  },\n});\n\n/**\n * List workflow instances.\n */\nexport const ListInstancesContract = defineQuery({\n  meta: {\n    key: 'workflow.instance.list',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['workflow', 'instance', 'list'],\n    description: 'List workflow instances with filtering.',\n    goal: 'Browse and search running workflows.',\n    context: 'Dashboard, monitoring.',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'ListInstancesInput',\n      fields: {\n        workflowKey: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: true,\n        },\n        status: { type: InstanceStatusEnum, isOptional: true },\n        referenceType: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: true,\n        },\n        referenceId: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: true,\n        },\n        triggeredBy: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: true,\n        },\n        limit: {\n          type: ScalarTypeEnum.Int_unsecure(),\n          isOptional: true,\n          defaultValue: 20,\n        },\n        offset: {\n          type: ScalarTypeEnum.Int_unsecure(),\n          isOptional: true,\n          defaultValue: 0,\n        },\n      },\n    }),\n    output: defineSchemaModel({\n      name: 'ListInstancesOutput',\n      fields: {\n        instances: {\n          type: WorkflowInstanceModel,\n          isArray: true,\n          isOptional: false,\n        },\n        total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n      },\n    }),\n  },\n  policy: { auth: 'user' },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'list-instances-happy-path',\n        given: ['Workflow instances exist'],\n        when: ['User lists instances'],\n        then: ['List of instances is returned'],\n      },\n    ],\n    examples: [\n      {\n        key: 'list-running',\n        input: { status: 'running', limit: 10 },\n        output: { instances: [], total: 5 },\n      },\n    ],\n  },\n});\n\n/**\n * Get a single workflow instance.\n */\nexport const GetInstanceContract = defineQuery({\n  meta: {\n    key: 'workflow.instance.get',\n    version: '1.0.0',\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['workflow', 'instance', 'get'],\n    description: 'Get a workflow instance with details.',\n    goal: 'View workflow instance details.',\n    context: 'Instance detail view.',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'GetInstanceInput',\n      fields: {\n        instanceId: {\n          type: ScalarTypeEnum.String_unsecure(),\n          isOptional: false,\n        },\n      },\n    }),\n    output: WorkflowInstanceModel,\n  },\n  policy: { auth: 'user' },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'get-instance-happy-path',\n        given: ['Instance exists'],\n        when: ['User requests instance details'],\n        then: ['Instance details are returned'],\n      },\n    ],\n    examples: [\n      {\n        key: 'get-details',\n        input: { instanceId: 'inst-456' },\n        output: { id: 'inst-456', workflowKey: 'onboarding-v1' },\n      },\n    ],\n  },\n});\n"],"mappings":"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"}