cards/packages/cards-domain/src/protocol/payloads.ts

// TEMPORARY MIRROR — siehe envelope.ts.
//
// Payload-Schemas für die `accepts[]` aus dem Cards-Manifest:
// `mana/quote`, `mana/url`, `mana/text`. Andere known types
// (`mana/transcript`, `mana/link`, `mana/note`, etc.) werden wir
// erst ergänzen, wenn Cards sie aktiv akzeptiert.

import { z } from 'zod';

export const MANA_TYPE_QUOTE = 'mana/quote' as const;
export const MANA_TYPE_URL = 'mana/url' as const;
export const MANA_TYPE_TEXT = 'mana/text' as const;

export const QuotePayloadSchema = z
	.object({
		text: z.string().min(1).max(8000),
		source: z.string().max(500).optional(),
		source_url: z.string().url().optional(),
		source_kind: z
			.enum(['book', 'article', 'talk', 'conversation', 'transcript', 'link', 'manual', 'other'])
			.optional(),
		language: z
			.string()
			.regex(/^[a-z]{2}(-[A-Z]{2})?$/)
			.optional(),
		tags: z.array(z.string().max(64)).max(50).optional(),
	})
	.strict();
export type QuotePayload = z.infer<typeof QuotePayloadSchema>;

/**
 * `mana/url` — externe Web-Adresse mit optionalen OG-Metadaten.
 * (Mana-Spec nennt dies `mana/link`. Wir akzeptieren dieselben
 * Felder, aber unter unserem deklarierten Type-Namen `mana/url`.)
 */
export const UrlPayloadSchema = z
	.object({
		url: z.string().url(),
		title: z.string().max(500).optional(),
		description: z.string().max(2000).optional(),
		snippet: z.string().max(2000).optional(),
		image_url: z.string().url().optional(),
		site_name: z.string().max(200).optional(),
		favicon_url: z.string().url().optional(),
	})
	.strict();
export type UrlPayload = z.infer<typeof UrlPayloadSchema>;

export const TextPayloadSchema = z
	.object({
		text: z.string().min(1).max(50000),
		format: z.enum(['plain', 'markdown', 'html']).default('plain'),
		source: z.string().max(500).optional(),
		source_url: z.string().url().optional(),
	})
	.strict();
export type TextPayload = z.infer<typeof TextPayloadSchema>;

/** Map vom Type-String zum Payload-Schema. */
export const PAYLOAD_SCHEMAS = {
	[MANA_TYPE_QUOTE]: QuotePayloadSchema,
	[MANA_TYPE_URL]: UrlPayloadSchema,
	[MANA_TYPE_TEXT]: TextPayloadSchema,
} as const;

export type AcceptedShareType = keyof typeof PAYLOAD_SCHEMAS;

export function validatePayloadForType(
	type: string,
	payload: unknown
): { success: true; data: unknown } | { success: false; error: 'unknown_type' | 'invalid_payload'; issues?: string[] } {
	const schema = PAYLOAD_SCHEMAS[type as AcceptedShareType];
	if (!schema) return { success: false, error: 'unknown_type' };
	const r = schema.safeParse(payload);
	if (!r.success) {
		return {
			success: false,
			error: 'invalid_payload',
			issues: r.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
		};
	}
	return { success: true, data: r.data };
}