@nkzw/codiff-core 1.8.1

package/dist/share.d.ts

@@ -0,0 +1,301 @@
+import { type InferOutput } from 'valibot';
+export declare const planShareManifestV1Schema: import("valibot").LooseObjectSchema<{
+    readonly codiffVersion: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+    readonly document: import("valibot").LooseObjectSchema<{
+        readonly content: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+        readonly name: import("valibot").SchemaWithPipe<readonly [import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, import("valibot").CheckAction<string, "Invalid plan file name.">]>;
+        readonly title: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+    }, undefined>;
+    readonly exportedAt: import("valibot").SchemaWithPipe<readonly [import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, import("valibot").CheckAction<string, "Invalid timestamp.">]>;
+    readonly kind: import("valibot").LiteralSchema<"codiff-plan-share", undefined>;
+    readonly preferences: import("valibot").LooseObjectSchema<{
+        readonly theme: import("valibot").PicklistSchema<["dark", "light", "system"], undefined>;
+    }, undefined>;
+    readonly review: import("valibot").LooseObjectSchema<{
+        readonly threads: import("valibot").SchemaWithPipe<readonly [import("valibot").ArraySchema<import("valibot").LooseObjectSchema<{
+            readonly anchor: import("valibot").UnionSchema<[import("valibot").LooseObjectSchema<{
+                readonly block: import("valibot").LooseObjectSchema<{
+                    readonly fingerprint: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                    readonly path: import("valibot").SchemaWithPipe<readonly [import("valibot").ArraySchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<undefined>, import("valibot").IntegerAction<number, undefined>, import("valibot").MinValueAction<number, 0, undefined>, import("valibot").MaxValueAction<number, 1000000, undefined>]>, undefined>, import("valibot").MaxLengthAction<number[], 64, undefined>]>;
+                    readonly runtimeKey: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+                    readonly text: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                    readonly type: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                }, undefined>;
+                readonly kind: import("valibot").LiteralSchema<"block", undefined>;
+                readonly version: import("valibot").LiteralSchema<1, undefined>;
+            }, undefined>, import("valibot").SchemaWithPipe<readonly [import("valibot").LooseObjectSchema<{
+                readonly block: import("valibot").LooseObjectSchema<{
+                    readonly fingerprint: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                    readonly path: import("valibot").SchemaWithPipe<readonly [import("valibot").ArraySchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<undefined>, import("valibot").IntegerAction<number, undefined>, import("valibot").MinValueAction<number, 0, undefined>, import("valibot").MaxValueAction<number, 1000000, undefined>]>, undefined>, import("valibot").MaxLengthAction<number[], 64, undefined>]>;
+                    readonly runtimeKey: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+                    readonly text: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                    readonly type: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                }, undefined>;
+                readonly kind: import("valibot").LiteralSchema<"text", undefined>;
+                readonly quote: import("valibot").LooseObjectSchema<{
+                    readonly end: import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<undefined>, import("valibot").IntegerAction<number, undefined>, import("valibot").MinValueAction<number, 0, undefined>, import("valibot").MaxValueAction<number, 1000000, undefined>]>;
+                    readonly exact: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                    readonly prefix: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                    readonly start: import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<undefined>, import("valibot").IntegerAction<number, undefined>, import("valibot").MinValueAction<number, 0, undefined>, import("valibot").MaxValueAction<number, 1000000, undefined>]>;
+                    readonly suffix: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                }, undefined>;
+                readonly version: import("valibot").LiteralSchema<1, undefined>;
+            }, undefined>, import("valibot").CheckAction<{
+                block: {
+                    fingerprint: string;
+                    path: number[];
+                    runtimeKey?: string | undefined;
+                    text: string;
+                    type: string;
+                } & {
+                    [key: string]: unknown;
+                };
+                kind: "text";
+                quote: {
+                    end: number;
+                    exact: string;
+                    prefix: string;
+                    start: number;
+                    suffix: string;
+                } & {
+                    [key: string]: unknown;
+                };
+                version: 1;
+            } & {
+                [key: string]: unknown;
+            }, "Invalid quote range.">]>], undefined>;
+            readonly createdAt: import("valibot").SchemaWithPipe<readonly [import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, import("valibot").CheckAction<string, "Invalid timestamp.">]>;
+            readonly createdBy: import("valibot").LooseObjectSchema<{
+                readonly avatarUrl: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+                readonly email: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+                readonly id: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                readonly name: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                readonly username: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+            }, undefined>;
+            readonly id: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+            readonly messages: import("valibot").SchemaWithPipe<readonly [import("valibot").ArraySchema<import("valibot").LooseObjectSchema<{
+                readonly author: import("valibot").LooseObjectSchema<{
+                    readonly avatarUrl: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+                    readonly email: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+                    readonly id: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                    readonly name: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                    readonly username: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+                }, undefined>;
+                readonly body: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                readonly createdAt: import("valibot").SchemaWithPipe<readonly [import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, import("valibot").CheckAction<string, "Invalid timestamp.">]>;
+                readonly id: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>;
+                readonly updatedAt: import("valibot").SchemaWithPipe<readonly [import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, import("valibot").CheckAction<string, "Invalid timestamp.">]>;
+            }, undefined>, undefined>, import("valibot").MinLengthAction<({
+                author: {
+                    avatarUrl?: string | undefined;
+                    email?: string | undefined;
+                    id: string;
+                    name: string;
+                    username?: string | undefined;
+                } & {
+                    [key: string]: unknown;
+                };
+                body: string;
+                createdAt: string;
+                id: string;
+                updatedAt: string;
+            } & {
+                [key: string]: unknown;
+            })[], 1, undefined>, import("valibot").MaxLengthAction<({
+                author: {
+                    avatarUrl?: string | undefined;
+                    email?: string | undefined;
+                    id: string;
+                    name: string;
+                    username?: string | undefined;
+                } & {
+                    [key: string]: unknown;
+                };
+                body: string;
+                createdAt: string;
+                id: string;
+                updatedAt: string;
+            } & {
+                [key: string]: unknown;
+            })[], 100, undefined>, import("valibot").CheckAction<({
+                author: {
+                    avatarUrl?: string | undefined;
+                    email?: string | undefined;
+                    id: string;
+                    name: string;
+                    username?: string | undefined;
+                } & {
+                    [key: string]: unknown;
+                };
+                body: string;
+                createdAt: string;
+                id: string;
+                updatedAt: string;
+            } & {
+                [key: string]: unknown;
+            })[], "Duplicate message ID.">]>;
+            readonly status: import("valibot").PicklistSchema<["open", "resolved"], undefined>;
+            readonly updatedAt: import("valibot").SchemaWithPipe<readonly [import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 1, undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, import("valibot").CheckAction<string, "Invalid timestamp.">]>;
+        }, undefined>, undefined>, import("valibot").MaxLengthAction<({
+            anchor: ({
+                block: {
+                    fingerprint: string;
+                    path: number[];
+                    runtimeKey?: string | undefined;
+                    text: string;
+                    type: string;
+                } & {
+                    [key: string]: unknown;
+                };
+                kind: "text";
+                quote: {
+                    end: number;
+                    exact: string;
+                    prefix: string;
+                    start: number;
+                    suffix: string;
+                } & {
+                    [key: string]: unknown;
+                };
+                version: 1;
+            } & {
+                [key: string]: unknown;
+            }) | ({
+                block: {
+                    fingerprint: string;
+                    path: number[];
+                    runtimeKey?: string | undefined;
+                    text: string;
+                    type: string;
+                } & {
+                    [key: string]: unknown;
+                };
+                kind: "block";
+                version: 1;
+            } & {
+                [key: string]: unknown;
+            });
+            createdAt: string;
+            createdBy: {
+                avatarUrl?: string | undefined;
+                email?: string | undefined;
+                id: string;
+                name: string;
+                username?: string | undefined;
+            } & {
+                [key: string]: unknown;
+            };
+            id: string;
+            messages: ({
+                author: {
+                    avatarUrl?: string | undefined;
+                    email?: string | undefined;
+                    id: string;
+                    name: string;
+                    username?: string | undefined;
+                } & {
+                    [key: string]: unknown;
+                };
+                body: string;
+                createdAt: string;
+                id: string;
+                updatedAt: string;
+            } & {
+                [key: string]: unknown;
+            })[];
+            status: "open" | "resolved";
+            updatedAt: string;
+        } & {
+            [key: string]: unknown;
+        })[], 1000, undefined>, import("valibot").CheckAction<({
+            anchor: ({
+                block: {
+                    fingerprint: string;
+                    path: number[];
+                    runtimeKey?: string | undefined;
+                    text: string;
+                    type: string;
+                } & {
+                    [key: string]: unknown;
+                };
+                kind: "text";
+                quote: {
+                    end: number;
+                    exact: string;
+                    prefix: string;
+                    start: number;
+                    suffix: string;
+                } & {
+                    [key: string]: unknown;
+                };
+                version: 1;
+            } & {
+                [key: string]: unknown;
+            }) | ({
+                block: {
+                    fingerprint: string;
+                    path: number[];
+                    runtimeKey?: string | undefined;
+                    text: string;
+                    type: string;
+                } & {
+                    [key: string]: unknown;
+                };
+                kind: "block";
+                version: 1;
+            } & {
+                [key: string]: unknown;
+            });
+            createdAt: string;
+            createdBy: {
+                avatarUrl?: string | undefined;
+                email?: string | undefined;
+                id: string;
+                name: string;
+                username?: string | undefined;
+            } & {
+                [key: string]: unknown;
+            };
+            id: string;
+            messages: ({
+                author: {
+                    avatarUrl?: string | undefined;
+                    email?: string | undefined;
+                    id: string;
+                    name: string;
+                    username?: string | undefined;
+                } & {
+                    [key: string]: unknown;
+                };
+                body: string;
+                createdAt: string;
+                id: string;
+                updatedAt: string;
+            } & {
+                [key: string]: unknown;
+            })[];
+            status: "open" | "resolved";
+            updatedAt: string;
+        } & {
+            [key: string]: unknown;
+        })[], "Duplicate thread ID.">]>;
+        readonly version: import("valibot").LiteralSchema<1, undefined>;
+    }, undefined>;
+    readonly source: import("valibot").OptionalSchema<import("valibot").LooseObjectSchema<{
+        readonly agent: import("valibot").OptionalSchema<import("valibot").PicklistSchema<["claude", "codex", "opencode", "pi"], undefined>, undefined>;
+        readonly sessionId: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+    }, undefined>, undefined>;
+    readonly version: import("valibot").LiteralSchema<1, undefined>;
+}, undefined>;
+declare const uploaderSchema: import("valibot").LooseObjectSchema<{
+    readonly email: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+    readonly name: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MaxLengthAction<string, number, undefined>]>, undefined>;
+}, undefined>;
+export type PlanShareManifestV1 = InferOutput<typeof planShareManifestV1Schema>;
+export type ShareUploader = InferOutput<typeof uploaderSchema>;
+export declare const parsePlanShareManifest: (value: unknown) => PlanShareManifestV1;
+export declare const parsePlanShareUpload: (value: unknown) => {
+    snapshot: PlanShareManifestV1;
+    uploader?: ShareUploader;
+};
+export {};

package/dist/share.mjs

@@ -0,0 +1,103 @@
+import { array, check, integer, literal, looseObject, maxLength, maxValue, minLength, minValue, number, optional, parse, picklist, pipe, safeParse, string, union } from "valibot";
+//#region share.ts
+const maxDocumentLength = 2 * 1024 * 1024;
+const maxCommentLength = 128 * 1024;
+const maxAnchorTextLength = 64 * 1024;
+const boundedString = (maximum) => pipe(string(), maxLength(maximum));
+const nonEmptyString = (maximum) => pipe(string(), minLength(1), maxLength(maximum));
+const timestamp = pipe(nonEmptyString(64), check((value) => Number.isFinite(Date.parse(value)), "Invalid timestamp."));
+const index = pipe(number(), integer(), minValue(0), maxValue(1e6));
+const authorSchema = looseObject({
+	avatarUrl: optional(boundedString(2048)),
+	email: optional(boundedString(320)),
+	id: nonEmptyString(200),
+	name: nonEmptyString(200),
+	username: optional(boundedString(200))
+});
+const blockSchema = looseObject({
+	fingerprint: nonEmptyString(256),
+	path: pipe(array(index), maxLength(64)),
+	runtimeKey: optional(boundedString(256)),
+	text: boundedString(maxAnchorTextLength),
+	type: nonEmptyString(64)
+});
+const blockAnchorSchema = looseObject({
+	block: blockSchema,
+	kind: literal("block"),
+	version: literal(1)
+});
+const textAnchorSchema = pipe(looseObject({
+	block: blockSchema,
+	kind: literal("text"),
+	quote: looseObject({
+		end: index,
+		exact: boundedString(maxAnchorTextLength),
+		prefix: boundedString(1024),
+		start: index,
+		suffix: boundedString(1024)
+	}),
+	version: literal(1)
+}), check(({ quote }) => quote.end >= quote.start, "Invalid quote range."));
+const messageSchema = looseObject({
+	author: authorSchema,
+	body: boundedString(maxCommentLength),
+	createdAt: timestamp,
+	id: nonEmptyString(200),
+	updatedAt: timestamp
+});
+const threadSchema = looseObject({
+	anchor: union([blockAnchorSchema, textAnchorSchema]),
+	createdAt: timestamp,
+	createdBy: authorSchema,
+	id: nonEmptyString(200),
+	messages: pipe(array(messageSchema), minLength(1), maxLength(100), check((messages) => new Set(messages.map(({ id }) => id)).size === messages.length, "Duplicate message ID.")),
+	status: picklist(["open", "resolved"]),
+	updatedAt: timestamp
+});
+const planShareManifestV1Schema = looseObject({
+	codiffVersion: nonEmptyString(100),
+	document: looseObject({
+		content: boundedString(maxDocumentLength),
+		name: pipe(nonEmptyString(300), check((value) => !value.includes("/") && !value.includes("\\") && /\.md$/i.test(value), "Invalid plan file name.")),
+		title: nonEmptyString(300)
+	}),
+	exportedAt: timestamp,
+	kind: literal("codiff-plan-share"),
+	preferences: looseObject({ theme: picklist([
+		"dark",
+		"light",
+		"system"
+	]) }),
+	review: looseObject({
+		threads: pipe(array(threadSchema), maxLength(1e3), check((threads) => new Set(threads.map(({ id }) => id)).size === threads.length, "Duplicate thread ID.")),
+		version: literal(1)
+	}),
+	source: optional(looseObject({
+		agent: optional(picklist([
+			"claude",
+			"codex",
+			"opencode",
+			"pi"
+		])),
+		sessionId: optional(boundedString(200))
+	})),
+	version: literal(1)
+});
+const planShareUploadEnvelopeSchema = looseObject({
+	snapshot: planShareManifestV1Schema,
+	uploader: optional(looseObject({
+		email: optional(boundedString(320)),
+		name: optional(boundedString(200))
+	}))
+});
+const parsePlanShareManifest = (value) => parse(planShareManifestV1Schema, value);
+const parsePlanShareUpload = (value) => {
+	const envelope = safeParse(planShareUploadEnvelopeSchema, value);
+	if (envelope.success) return {
+		snapshot: envelope.output.snapshot,
+		...envelope.output.uploader ? { uploader: envelope.output.uploader } : {}
+	};
+	return { snapshot: parsePlanShareManifest(value) };
+};
+//#endregion
+export { parsePlanShareManifest, parsePlanShareUpload, planShareManifestV1Schema };