@deskwork/core 0.13.0 → 0.14.0

package/dist/schema/draft-annotation.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Zod schema mirror of `DraftAnnotation` from `../review/types.ts`.
+ *
+ * The TS interface union in `review/types.ts` is the source of truth for
+ * the *shape*. This file provides a runtime validator for the same shape
+ * so journal events carrying a `DraftAnnotation` payload can be parsed
+ * via `JournalEventSchema.safeParse` at the read boundary.
+ *
+ * The union variants here mirror `CommentAnnotation | EditAnnotation |
+ * ApproveAnnotation | RejectAnnotation | ResolveAnnotation |
+ * AddressAnnotation`. If a new variant is added there, mirror it here.
+ */
+import { z } from 'zod';
+export declare const DraftAnnotationSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"comment">;
+    version: z.ZodNumber;
+    range: z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        start: number;
+        end: number;
+    }, {
+        start: number;
+        end: number;
+    }>;
+    text: z.ZodString;
+    category: z.ZodOptional<z.ZodEnum<["voice-drift", "missing-receipt", "tutorial-framing", "saas-vocabulary", "fake-authority", "structural", "other"]>>;
+    anchor: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    workflowId: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "comment";
+    version: number;
+    range: {
+        start: number;
+        end: number;
+    };
+    text: string;
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    category?: "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | "other" | undefined;
+    anchor?: string | undefined;
+}, {
+    type: "comment";
+    version: number;
+    range: {
+        start: number;
+        end: number;
+    };
+    text: string;
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    category?: "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | "other" | undefined;
+    anchor?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"edit">;
+    beforeVersion: z.ZodNumber;
+    afterMarkdown: z.ZodString;
+    diff: z.ZodString;
+    createdAt: z.ZodString;
+    workflowId: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "edit";
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    beforeVersion: number;
+    afterMarkdown: string;
+    diff: string;
+}, {
+    type: "edit";
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    beforeVersion: number;
+    afterMarkdown: string;
+    diff: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"approve">;
+    version: z.ZodNumber;
+    createdAt: z.ZodString;
+    workflowId: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "approve";
+    version: number;
+    createdAt: string;
+    workflowId: string;
+    id: string;
+}, {
+    type: "approve";
+    version: number;
+    createdAt: string;
+    workflowId: string;
+    id: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"reject">;
+    version: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    workflowId: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "reject";
+    version: number;
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    reason?: string | undefined;
+}, {
+    type: "reject";
+    version: number;
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    reason?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"resolve">;
+    commentId: z.ZodString;
+    resolved: z.ZodBoolean;
+    createdAt: z.ZodString;
+    workflowId: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "resolve";
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    commentId: string;
+    resolved: boolean;
+}, {
+    type: "resolve";
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    commentId: string;
+    resolved: boolean;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"address">;
+    commentId: z.ZodString;
+    version: z.ZodNumber;
+    disposition: z.ZodEnum<["addressed", "deferred", "wontfix"]>;
+    reason: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    workflowId: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "address";
+    version: number;
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    commentId: string;
+    disposition: "addressed" | "deferred" | "wontfix";
+    reason?: string | undefined;
+}, {
+    type: "address";
+    version: number;
+    createdAt: string;
+    workflowId: string;
+    id: string;
+    commentId: string;
+    disposition: "addressed" | "deferred" | "wontfix";
+    reason?: string | undefined;
+}>]>;
+//# sourceMappingURL=draft-annotation.d.ts.map

package/dist/schema/draft-annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-annotation.d.ts","sourceRoot":"","sources":["../../src/schema/draft-annotation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4ExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOhC,CAAC"}

package/dist/schema/draft-annotation.js

@@ -0,0 +1,87 @@
+/**
+ * Zod schema mirror of `DraftAnnotation` from `../review/types.ts`.
+ *
+ * The TS interface union in `review/types.ts` is the source of truth for
+ * the *shape*. This file provides a runtime validator for the same shape
+ * so journal events carrying a `DraftAnnotation` payload can be parsed
+ * via `JournalEventSchema.safeParse` at the read boundary.
+ *
+ * The union variants here mirror `CommentAnnotation | EditAnnotation |
+ * ApproveAnnotation | RejectAnnotation | ResolveAnnotation |
+ * AddressAnnotation`. If a new variant is added there, mirror it here.
+ */
+import { z } from 'zod';
+const AnnotationCategoryEnum = z.enum([
+    'voice-drift',
+    'missing-receipt',
+    'tutorial-framing',
+    'saas-vocabulary',
+    'fake-authority',
+    'structural',
+    'other',
+]);
+const RangeSchema = z.object({
+    start: z.number().int().nonnegative(),
+    end: z.number().int().nonnegative(),
+});
+const BaseFields = {
+    /** ISO-8601 timestamp when the annotation was recorded. */
+    createdAt: z.string().datetime(),
+    /** Workflow the annotation belongs to (legacy field; entry-keyed
+     * annotations still carry it for type compatibility with the
+     * workflow-keyed `DraftAnnotation` union, but the entry-store does
+     * not key off it). */
+    workflowId: z.string(),
+    /** Server-assigned id. */
+    id: z.string(),
+};
+const CommentAnnotation = z.object({
+    ...BaseFields,
+    type: z.literal('comment'),
+    version: z.number().int(),
+    range: RangeSchema,
+    text: z.string(),
+    category: AnnotationCategoryEnum.optional(),
+    anchor: z.string().optional(),
+});
+const EditAnnotation = z.object({
+    ...BaseFields,
+    type: z.literal('edit'),
+    beforeVersion: z.number().int(),
+    afterMarkdown: z.string(),
+    diff: z.string(),
+});
+const ApproveAnnotation = z.object({
+    ...BaseFields,
+    type: z.literal('approve'),
+    version: z.number().int(),
+});
+const RejectAnnotation = z.object({
+    ...BaseFields,
+    type: z.literal('reject'),
+    version: z.number().int(),
+    reason: z.string().optional(),
+});
+const ResolveAnnotation = z.object({
+    ...BaseFields,
+    type: z.literal('resolve'),
+    commentId: z.string(),
+    resolved: z.boolean(),
+});
+const AddressAnnotation = z.object({
+    ...BaseFields,
+    type: z.literal('address'),
+    commentId: z.string(),
+    version: z.number().int(),
+    disposition: z.enum(['addressed', 'deferred', 'wontfix']),
+    reason: z.string().optional(),
+});
+export const DraftAnnotationSchema = z.discriminatedUnion('type', [
+    CommentAnnotation,
+    EditAnnotation,
+    ApproveAnnotation,
+    RejectAnnotation,
+    ResolveAnnotation,
+    AddressAnnotation,
+]);
+//# sourceMappingURL=draft-annotation.js.map

package/dist/schema/draft-annotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-annotation.js","sourceRoot":"","sources":["../../src/schema/draft-annotation.ts"],"names":[],"mappings":"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"}