managarten/packages/website-blocks/src/moduleEmbed/schema.ts
Till JS 015a2c18ee feat(todo): M4.b — tasks adopt the unified visibility system
Fourth consumer of @mana/shared-privacy. Tasks now carry a
VisibilityLevel flipped via <VisibilityPicker> in the Todo DetailView;
a new todo.tasks embed source powers the "public roadmap" use-case
(mark a handful of tasks public, drop the embed on the Website).

Changes:
- todo/types: visibility + unlistedToken + visibilityChangedAt +
  visibilityChangedBy on LocalTask; Task (UI type) requires visibility
- todo/queries: toTask forwards visibility with 'space' fallback for
  legacy rows (pre-M4.b records have no field set; Dexie hook stamped
  'space' since spaces-foundation v28)
- todo/stores/tasks: createTask stamps
  defaultVisibilityFor(activeSpace.type); new setVisibility(id, level)
  mints/clears the unlisted token on the transition boundary and
  emits cross-module VisibilityChanged
- todo/views/DetailView: <VisibilityPicker> dropped in as the first
  prop-row above Priorität so the user sees exposure state at a glance
  whenever they open a task

website embed:
- website-blocks/moduleEmbed/schema: 'todo.tasks' added to
  EmbedSourceSchema; filter docstring explains the todo-specific shape
  (status + tagIds for the typical "shipped items with #public" filter)
- website/embeds: resolveTodoTasks gates hard on canEmbedOnWebsite,
  maps the optional status filter ('completed' → isCompleted=true),
  joins the N:N taskTags table for the optional tagIds filter, sorts
  newest-first with id as stable tiebreaker. Inlined EmbedItem is
  whitelist-only — title + status label ('Erledigt' / 'In Arbeit').
  Description, subtasks, LLM-labels, due-dates, and project
  memberships stay out of the public snapshot (per plan §2 redaction
  policy)

Verified:
- pnpm check (web): 7450 files, 0 errors
- pnpm test todo + website: 38/38

Next: M4.c — Goals. Lives under $lib/companion/goals/ (not in the
standard /modules/ tree), so the adoption path is slightly different
and gets its own commit.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 02:37:32 +02:00

82 lines
2.7 KiB
TypeScript

import { z } from 'zod';
/**
* Resolved item shape — every embed provider returns items in this
* normalized form so the renderer doesn't care about the source.
*/
export const EmbedItemSchema = z.object({
title: z.string(),
subtitle: z.string().optional(),
imageUrl: z.string().optional(),
/** External link — for library entries, a page URL. */
href: z.string().optional(),
});
export type EmbedItem = z.infer<typeof EmbedItemSchema>;
export const EmbedResolvedSchema = z.object({
items: z.array(EmbedItemSchema),
/** If resolution failed, the error message surfaces in public mode. */
error: z.string().optional(),
/** ISO timestamp of when resolution happened. */
resolvedAt: z.string().optional(),
});
/**
* Supported embed sources. Add new sources here + a matching provider
* in the editor's publish resolver.
*/
export const EmbedSourceSchema = z.enum([
'picture.board',
'library.entries',
'calendar.events',
'todo.tasks',
]);
export type EmbedSource = z.infer<typeof EmbedSourceSchema>;
export const ModuleEmbedSchema = z.object({
source: EmbedSourceSchema.default('picture.board'),
/** Target id — board id for picture, empty for "all entries" in library. */
sourceId: z.string().max(64).default(''),
/** Display title. Optional; renderer falls back to source default. */
title: z.string().max(160).default(''),
layout: z.enum(['grid', 'list']).default('grid'),
maxItems: z.number().int().min(1).max(48).default(12),
/**
* Optional filters depending on source.
* library.entries: { isFavorite?, status?, kind? }
* picture.board: ignored (board is the source)
* calendar.events: { upcomingDays?, tagIds? } — omit upcomingDays
* to include past events; tagIds OR-filter on
* event tag assignments
* todo.tasks: { status?, tagIds? } — typical public-roadmap
* shape: status='completed' filters to shipped
* items; tagIds restricts to a "public" label
*/
filter: z
.object({
isFavorite: z.boolean().optional(),
status: z.string().max(32).optional(),
kind: z.string().max(32).optional(),
upcomingDays: z.number().int().min(1).max(365).optional(),
tagIds: z.array(z.string().max(64)).max(16).optional(),
})
.default({}),
/**
* Filled at publish time. The public renderer reads this directly —
* no Dexie, no API round-trip. The editor shows a "nicht aufgelöst"
* placeholder when missing.
*/
resolved: EmbedResolvedSchema.optional(),
});
export type ModuleEmbedProps = z.infer<typeof ModuleEmbedSchema>;
export const MODULE_EMBED_DEFAULTS: ModuleEmbedProps = {
source: 'picture.board',
sourceId: '',
title: '',
layout: 'grid',
maxItems: 12,
filter: {},
};