dineway 0.1.3

package/dist/types-D38djUXv.d.mts

@@ -0,0 +1,1196 @@
+import { u as FieldType } from "./types-BgQeVaPj.mjs";
+import { z } from "astro/zod";
+import { JSX } from "astro/jsx-runtime";
+
+//#region ../blocks/dist/validation-BG2u9jAE.d.ts
+//#region src/types.d.ts
+interface ConfirmDialog {
+  title: string;
+  text: string;
+  confirm: string;
+  deny: string;
+  style?: "danger";
+}
+interface ButtonElement {
+  type: "button";
+  action_id: string;
+  label: string;
+  style?: "primary" | "danger" | "secondary";
+  value?: unknown;
+  confirm?: ConfirmDialog;
+}
+interface TextInputElement {
+  type: "text_input";
+  action_id: string;
+  label: string;
+  placeholder?: string;
+  initial_value?: string;
+  multiline?: boolean;
+}
+interface NumberInputElement {
+  type: "number_input";
+  action_id: string;
+  label: string;
+  initial_value?: number;
+  min?: number;
+  max?: number;
+}
+interface SelectElement {
+  type: "select";
+  action_id: string;
+  label: string;
+  options: Array<{
+    label: string;
+    value: string;
+  }>;
+  initial_value?: string;
+  /** Plugin route that returns `{ items: Array<{ id, name }> }` to populate options dynamically */
+  optionsRoute?: string;
+}
+interface ToggleElement {
+  type: "toggle";
+  action_id: string;
+  label: string;
+  description?: string;
+  initial_value?: boolean;
+}
+interface SecretInputElement {
+  type: "secret_input";
+  action_id: string;
+  label: string;
+  placeholder?: string;
+  has_value?: boolean;
+}
+interface CheckboxElement {
+  type: "checkbox";
+  action_id: string;
+  label: string;
+  options: Array<{
+    label: string;
+    value: string;
+  }>;
+  initial_value?: string[];
+}
+interface DateInputElement {
+  type: "date_input";
+  action_id: string;
+  label: string;
+  initial_value?: string;
+  placeholder?: string;
+}
+interface ComboboxElement {
+  type: "combobox";
+  action_id: string;
+  label: string;
+  options: Array<{
+    label: string;
+    value: string;
+  }>;
+  initial_value?: string;
+  placeholder?: string;
+}
+interface RadioElement {
+  type: "radio";
+  action_id: string;
+  label: string;
+  options: Array<{
+    label: string;
+    value: string;
+  }>;
+  initial_value?: string;
+}
+type Element = ButtonElement | TextInputElement | NumberInputElement | SelectElement | ToggleElement | SecretInputElement | CheckboxElement | DateInputElement | ComboboxElement | RadioElement;
+//#endregion
+//#region src/plugins/types.d.ts
+/**
+ * Plugin capabilities determine what APIs are available in context
+ */
+type PluginCapability = "network:fetch" | "network:fetch:any" | "read:content" | "write:content" | "read:media" | "write:media" | "read:users" | "email:send" | "email:provide" | "email:intercept" | "page:inject";
+/**
+ * Storage collection declaration in plugin definition
+ */
+interface StorageCollectionConfig {
+  /**
+   * Fields to index for querying.
+   * Each entry can be a single field name or an array for composite indexes.
+   */
+  indexes: Array<string | string[]>;
+  /**
+   * Fields with unique constraints.
+   * Each entry can be a single field name or an array for composite unique indexes.
+   * Unique indexes are also queryable (no need to duplicate in `indexes`).
+   */
+  uniqueIndexes?: Array<string | string[]>;
+}
+/**
+ * Plugin storage configuration
+ */
+type PluginStorageConfig = Record<string, StorageCollectionConfig>;
+/**
+ * Query filter operators
+ */
+interface RangeFilter {
+  gt?: number | string;
+  gte?: number | string;
+  lt?: number | string;
+  lte?: number | string;
+}
+interface InFilter {
+  in: Array<string | number>;
+}
+interface StartsWithFilter {
+  startsWith: string;
+}
+/**
+ * Where clause value types
+ */
+type WhereValue = string | number | boolean | null | RangeFilter | InFilter | StartsWithFilter;
+/**
+ * Where clause for storage queries
+ */
+type WhereClause = Record<string, WhereValue>;
+/**
+ * Query options for storage.query()
+ */
+interface QueryOptions {
+  where?: WhereClause;
+  orderBy?: Record<string, "asc" | "desc">;
+  limit?: number;
+  cursor?: string;
+}
+/**
+ * Paginated result (used by storage.query, content.list, media.list)
+ */
+interface PaginatedResult<T> {
+  items: T[];
+  cursor?: string;
+  hasMore: boolean;
+}
+/**
+ * Storage collection interface - the API exposed to plugins
+ * No async iterators - all operations return promises with pagination
+ */
+interface StorageCollection<T = unknown> {
+  get(id: string): Promise<T | null>;
+  put(id: string, data: T): Promise<void>;
+  delete(id: string): Promise<boolean>;
+  exists(id: string): Promise<boolean>;
+  getMany(ids: string[]): Promise<Map<string, T>>;
+  putMany(items: Array<{
+    id: string;
+    data: T;
+  }>): Promise<void>;
+  deleteMany(ids: string[]): Promise<number>;
+  query(options?: QueryOptions): Promise<PaginatedResult<{
+    id: string;
+    data: T;
+  }>>;
+  count(where?: WhereClause): Promise<number>;
+}
+/**
+ * Plugin storage context - typed based on declared collections
+ */
+type PluginStorage<T extends PluginStorageConfig> = { [K in keyof T]: StorageCollection };
+/**
+ * KV store interface - unified replacement for settings + options
+ *
+ * Convention:
+ * - `settings:*` - User-configurable preferences (shown in admin UI)
+ * - `state:*` - Internal plugin state (not shown to users)
+ */
+interface KVAccess {
+  get<T>(key: string): Promise<T | null>;
+  set(key: string, value: unknown): Promise<void>;
+  delete(key: string): Promise<boolean>;
+  list(prefix?: string): Promise<Array<{
+    key: string;
+    value: unknown;
+  }>>;
+}
+/**
+ * SEO metadata for a content item, as stored in the core SEO panel.
+ *
+ * Only present on items in collections with `has_seo = 1`. For collections
+ * without SEO enabled, `ContentItem.seo` is `undefined`.
+ */
+interface ContentItemSeo {
+  title: string | null;
+  description: string | null;
+  image: string | null;
+  canonical: string | null;
+  noIndex: boolean;
+}
+/**
+ * SEO input accepted by content write operations.
+ *
+ * All fields are optional — only fields that are present overwrite existing
+ * values. An empty object is treated as a no-op.
+ */
+interface ContentItemSeoInput {
+  title?: string | null;
+  description?: string | null;
+  image?: string | null;
+  canonical?: string | null;
+  noIndex?: boolean;
+}
+/**
+ * Content item returned from content API
+ */
+interface ContentItem {
+  id: string;
+  type: string;
+  data: Record<string, unknown>;
+  /**
+   * SEO metadata, populated when the collection has SEO enabled
+   * (`has_seo = 1`). `undefined` for non-SEO collections.
+   */
+  seo?: ContentItemSeo;
+  createdAt: string;
+  updatedAt: string;
+}
+/**
+ * Content list options
+ */
+interface ContentListOptions {
+  limit?: number;
+  cursor?: string;
+  orderBy?: Record<string, "asc" | "desc">;
+}
+/**
+ * Input accepted by `content.create` / `content.update`.
+ *
+ * Most entries are field slugs mapped to their values. The reserved `seo`
+ * key is extracted and routed to the core SEO panel (the `_dineway_seo`
+ * table), matching the shape accepted by the REST API. Passing `seo` for a
+ * collection that does not have SEO enabled throws a validation error.
+ */
+type ContentWriteInput = Record<string, unknown> & {
+  seo?: ContentItemSeoInput;
+};
+/**
+ * Content access interface - capability-gated
+ */
+interface ContentAccess {
+  get(collection: string, id: string): Promise<ContentItem | null>;
+  list(collection: string, options?: ContentListOptions): Promise<PaginatedResult<ContentItem>>;
+  create?(collection: string, data: ContentWriteInput): Promise<ContentItem>;
+  update?(collection: string, id: string, data: ContentWriteInput): Promise<ContentItem>;
+  delete?(collection: string, id: string): Promise<boolean>;
+}
+/**
+ * Full content access with write operations
+ */
+interface ContentAccessWithWrite extends ContentAccess {
+  create(collection: string, data: ContentWriteInput): Promise<ContentItem>;
+  update(collection: string, id: string, data: ContentWriteInput): Promise<ContentItem>;
+  delete(collection: string, id: string): Promise<boolean>;
+}
+/**
+ * Media item returned from media API
+ */
+interface MediaItem {
+  id: string;
+  filename: string;
+  mimeType: string;
+  size: number | null;
+  url: string;
+  createdAt: string;
+}
+/**
+ * Media list options
+ */
+interface MediaListOptions {
+  limit?: number;
+  cursor?: string;
+  mimeType?: string;
+}
+/**
+ * Media access interface - capability-gated
+ */
+interface MediaAccess {
+  get(id: string): Promise<MediaItem | null>;
+  list(options?: MediaListOptions): Promise<PaginatedResult<MediaItem>>;
+  getUploadUrl?(filename: string, contentType: string): Promise<{
+    uploadUrl: string;
+    mediaId: string;
+  }>;
+  /**
+   * Upload media bytes directly. Preferred in sandboxed mode where
+   * plugins cannot make external requests to a presigned URL.
+   * Returns the created media item.
+   */
+  upload?(filename: string, contentType: string, bytes: ArrayBuffer): Promise<{
+    mediaId: string;
+    storageKey: string;
+    url: string;
+  }>;
+  delete?(id: string): Promise<boolean>;
+}
+/**
+ * Full media access with write operations
+ */
+interface MediaAccessWithWrite extends MediaAccess {
+  getUploadUrl(filename: string, contentType: string): Promise<{
+    uploadUrl: string;
+    mediaId: string;
+  }>;
+  upload(filename: string, contentType: string, bytes: ArrayBuffer): Promise<{
+    mediaId: string;
+    storageKey: string;
+    url: string;
+  }>;
+  delete(id: string): Promise<boolean>;
+}
+/**
+ * HTTP client interface - requires network:fetch capability
+ */
+interface HttpAccess {
+  fetch(url: string, init?: RequestInit): Promise<Response>;
+}
+/**
+ * Logger interface - always available
+ */
+interface LogAccess {
+  debug(message: string, data?: unknown): void;
+  info(message: string, data?: unknown): void;
+  warn(message: string, data?: unknown): void;
+  error(message: string, data?: unknown): void;
+}
+/**
+ * Site information available to all plugins
+ */
+interface SiteInfo {
+  /** Site name (from settings) */
+  name: string;
+  /** Site URL (from settings or request) */
+  url: string;
+  /** Site locale (from settings, defaults to "en") */
+  locale: string;
+}
+/**
+ * Read-only user information exposed to plugins.
+ * Sensitive fields (password hashes, sessions, passkeys) are excluded.
+ */
+interface UserInfo {
+  id: string;
+  email: string;
+  name: string | null;
+  role: number;
+  createdAt: string;
+}
+/**
+ * User access interface - requires read:users capability
+ */
+interface UserAccess {
+  /** Get a user by ID */
+  get(id: string): Promise<UserInfo | null>;
+  /** Get a user by email */
+  getByEmail(email: string): Promise<UserInfo | null>;
+  /** List users with optional filters */
+  list(opts?: {
+    role?: number;
+    limit?: number;
+    cursor?: string;
+  }): Promise<{
+    items: UserInfo[];
+    nextCursor?: string;
+  }>;
+}
+/**
+ * The unified plugin context - same shape for all hooks and routes
+ */
+interface PluginContext<TStorage extends PluginStorageConfig = PluginStorageConfig> {
+  /** Plugin metadata */
+  plugin: {
+    id: string;
+    version: string;
+  };
+  /** Storage collections - only if plugin declares storage */
+  storage: PluginStorage<TStorage>;
+  /** Key-value store for config and state */
+  kv: KVAccess;
+  /** Content access - only if read:content or write:content capability */
+  content?: ContentAccess | ContentAccessWithWrite;
+  /** Media access - only if read:media or write:media capability */
+  media?: MediaAccess | MediaAccessWithWrite;
+  /** HTTP client - only if network:fetch capability */
+  http?: HttpAccess;
+  /** Logger - always available */
+  log: LogAccess;
+  /** Site information - always available */
+  site: SiteInfo;
+  /** URL helper - generates absolute URLs from paths. Always available. */
+  url(path: string): string;
+  /** User access - only if read:users capability */
+  users?: UserAccess;
+  /** Cron task scheduling - always available, scoped to plugin */
+  cron?: CronAccess;
+  /** Email access - only if email:send capability and a provider is configured */
+  email?: EmailAccess;
+}
+/**
+ * Cron access interface �� always available on plugin context, scoped to plugin.
+ */
+interface CronAccess {
+  /** Schedule a recurring or one-shot task */
+  schedule(name: string, opts: {
+    schedule: string;
+    data?: Record<string, unknown>;
+  }): Promise<void>;
+  /** Cancel a scheduled task */
+  cancel(name: string): Promise<void>;
+  /** List this plugin's scheduled tasks */
+  list(): Promise<CronTaskInfo[]>;
+}
+/**
+ * Task info returned from CronAccess.list()
+ */
+interface CronTaskInfo {
+  name: string;
+  schedule: string;
+  nextRunAt: string;
+  lastRunAt: string | null;
+}
+/**
+ * Event passed to the `cron` hook handler
+ */
+interface CronEvent {
+  name: string;
+  data?: Record<string, unknown>;
+  scheduledAt: string;
+}
+/**
+ * Cron hook handler type
+ */
+type CronHandler = (event: CronEvent, ctx: PluginContext) => Promise<void>;
+/**
+ * Email access interface — requires `email:send` capability.
+ * Undefined when no `email:deliver` provider is configured.
+ *
+ * Related capabilities:
+ * - `email:send` — grants ctx.email (this interface)
+ * - `email:provide` — allows registering the `email:deliver` exclusive hook
+ * - `email:intercept` — allows registering `email:beforeSend` / `email:afterSend` hooks
+ */
+interface EmailAccess {
+  send(message: EmailMessage): Promise<void>;
+}
+/**
+ * Email message shape
+ */
+interface EmailMessage {
+  to: string;
+  subject: string;
+  text: string;
+  html?: string;
+}
+/**
+ * Event passed to email:beforeSend hooks (middleware — transform, validate, cancel)
+ */
+interface EmailBeforeSendEvent {
+  message: EmailMessage;
+  /** Where the email originated — "system" for auth emails, plugin ID for plugin emails */
+  source: string;
+}
+/**
+ * Event passed to email:deliver hook (exclusive — exactly one provider delivers)
+ */
+interface EmailDeliverEvent {
+  message: EmailMessage;
+  source: string;
+}
+/**
+ * Event passed to email:afterSend hooks (logging, analytics, fire-and-forget)
+ */
+interface EmailAfterSendEvent {
+  message: EmailMessage;
+  source: string;
+}
+/**
+ * Handler type for email:beforeSend hooks.
+ * Returns modified message, or false to cancel delivery.
+ */
+type EmailBeforeSendHandler = (event: EmailBeforeSendEvent, ctx: PluginContext) => Promise<EmailMessage | false>;
+/**
+ * Handler type for email:deliver hooks (exclusive provider).
+ */
+type EmailDeliverHandler = (event: EmailDeliverEvent, ctx: PluginContext) => Promise<void>;
+/**
+ * Handler type for email:afterSend hooks (fire-and-forget).
+ */
+type EmailAfterSendHandler = (event: EmailAfterSendEvent, ctx: PluginContext) => Promise<void>;
+/**
+ * Collection comment settings (read from _dineway_collections)
+ */
+interface CollectionCommentSettings {
+  commentsEnabled: boolean;
+  commentsModeration: "all" | "first_time" | "none";
+  commentsClosedAfterDays: number;
+  commentsAutoApproveUsers: boolean;
+}
+/**
+ * Event passed to comment:beforeCreate hooks (middleware — transform, enrich, reject)
+ */
+interface CommentBeforeCreateEvent {
+  comment: {
+    collection: string;
+    contentId: string;
+    parentId: string | null;
+    authorName: string;
+    authorEmail: string;
+    authorUserId: string | null;
+    body: string;
+    ipHash: string | null;
+    userAgent: string | null;
+  };
+  /** Metadata bag — plugins can attach signals for the moderator */
+  metadata: Record<string, unknown>;
+}
+/**
+ * Event passed to comment:moderate hook (exclusive — decides initial status)
+ */
+interface CommentModerateEvent {
+  comment: CommentBeforeCreateEvent["comment"];
+  metadata: Record<string, unknown>;
+  collectionSettings: CollectionCommentSettings;
+  /** Number of prior approved comments from this email address */
+  priorApprovedCount: number;
+}
+/**
+ * Moderation decision returned by the comment:moderate handler
+ */
+interface ModerationDecision {
+  status: "approved" | "pending" | "spam";
+  /** Optional reason for admin visibility */
+  reason?: string;
+}
+/**
+ * Stored comment shape (full record with id, status, timestamps)
+ */
+interface StoredComment {
+  id: string;
+  collection: string;
+  contentId: string;
+  parentId: string | null;
+  authorName: string;
+  authorEmail: string;
+  authorUserId: string | null;
+  body: string;
+  status: string;
+  moderationMetadata: Record<string, unknown> | null;
+  createdAt: string;
+  updatedAt: string;
+}
+/**
+ * Event passed to comment:afterCreate hooks (fire-and-forget)
+ */
+interface CommentAfterCreateEvent {
+  comment: StoredComment;
+  metadata: Record<string, unknown>;
+  /** The content item the comment is on */
+  content: {
+    id: string;
+    collection: string;
+    slug: string;
+    title?: string;
+  };
+  /** The content author (for notifications) */
+  contentAuthor?: {
+    id: string;
+    name: string | null;
+    email: string;
+  };
+}
+/**
+ * Event passed to comment:afterModerate hooks (fire-and-forget, admin status change)
+ */
+interface CommentAfterModerateEvent {
+  comment: StoredComment;
+  previousStatus: string;
+  newStatus: string;
+  /** The admin who moderated */
+  moderator: {
+    id: string;
+    name: string | null;
+  };
+}
+/**
+ * Handler type for comment:beforeCreate hooks.
+ * Returns modified event, or false to reject the comment.
+ */
+type CommentBeforeCreateHandler = (event: CommentBeforeCreateEvent, ctx: PluginContext) => Promise<CommentBeforeCreateEvent | false | void>;
+/**
+ * Handler type for comment:moderate hook (exclusive provider).
+ */
+type CommentModerateHandler = (event: CommentModerateEvent, ctx: PluginContext) => Promise<ModerationDecision>;
+/**
+ * Handler type for comment:afterCreate hooks (fire-and-forget).
+ */
+type CommentAfterCreateHandler = (event: CommentAfterCreateEvent, ctx: PluginContext) => Promise<void>;
+/**
+ * Handler type for comment:afterModerate hooks (fire-and-forget).
+ */
+type CommentAfterModerateHandler = (event: CommentAfterModerateEvent, ctx: PluginContext) => Promise<void>;
+/**
+ * Hook configuration
+ */
+interface HookConfig<THandler> {
+  /** Explicit ordering - lower numbers run first (default: 100) */
+  priority?: number;
+  /** Max execution time in ms (default: 5000) */
+  timeout?: number;
+  /** Run after these plugins */
+  dependencies?: string[];
+  /** Error handling policy */
+  errorPolicy?: "continue" | "abort";
+  /**
+   * Mark this hook as exclusive — only one plugin can be the active provider.
+   * Exclusive hooks skip the priority pipeline and dispatch only to the
+   * admin-selected provider. Used for email:deliver, search, image optimization, etc.
+   */
+  exclusive?: boolean;
+  /** The hook handler */
+  handler: THandler;
+}
+/**
+ * Content hook event
+ */
+interface ContentHookEvent {
+  content: Record<string, unknown>;
+  collection: string;
+  isNew: boolean;
+}
+/**
+ * Content delete hook event
+ */
+interface ContentDeleteEvent {
+  id: string;
+  collection: string;
+}
+/**
+ * Content publish state change hook event (fired after publish or unpublish)
+ */
+interface ContentPublishStateChangeEvent {
+  content: Record<string, unknown>;
+  collection: string;
+}
+/**
+ * Media hook event
+ */
+interface MediaUploadEvent {
+  file: {
+    name: string;
+    type: string;
+    size: number;
+  };
+}
+/**
+ * Media after upload event
+ */
+interface MediaAfterUploadEvent {
+  media: MediaItem;
+}
+/**
+ * Lifecycle hook event
+ */
+interface LifecycleEvent {}
+/**
+ * Uninstall hook event
+ */
+interface UninstallEvent {
+  deleteData: boolean;
+}
+type ContentBeforeSaveHandler = (event: ContentHookEvent, ctx: PluginContext) => Promise<Record<string, unknown> | void>;
+type ContentAfterSaveHandler = (event: ContentHookEvent, ctx: PluginContext) => Promise<void>;
+type ContentBeforeDeleteHandler = (event: ContentDeleteEvent, ctx: PluginContext) => Promise<boolean | void>;
+type ContentAfterDeleteHandler = (event: ContentDeleteEvent, ctx: PluginContext) => Promise<void>;
+type ContentAfterPublishHandler = (event: ContentPublishStateChangeEvent, ctx: PluginContext) => Promise<void>;
+type ContentAfterUnpublishHandler = (event: ContentPublishStateChangeEvent, ctx: PluginContext) => Promise<void>;
+type MediaBeforeUploadHandler = (event: MediaUploadEvent, ctx: PluginContext) => Promise<{
+  name: string;
+  type: string;
+  size: number;
+} | void>;
+type MediaAfterUploadHandler = (event: MediaAfterUploadEvent, ctx: PluginContext) => Promise<void>;
+type LifecycleHandler = (event: LifecycleEvent, ctx: PluginContext) => Promise<void>;
+type UninstallHandler = (event: UninstallEvent, ctx: PluginContext) => Promise<void>;
+/** Placement targets for page fragment contributions */
+type PagePlacement = "head" | "body:start" | "body:end";
+/**
+ * A single breadcrumb trail item. Used by `PublicPageContext.breadcrumbs`
+ * so themes can publish breadcrumb trails that SEO plugins consume.
+ */
+interface BreadcrumbItem {
+  /** Display name for this crumb (e.g. "Home", "Blog", "My Post"). */
+  name: string;
+  /** Absolute or root-relative URL for this crumb. */
+  url: string;
+}
+/**
+ * Describes the page being rendered. Passed to page hooks so plugins
+ * can decide what to contribute without fetching content themselves.
+ */
+interface PublicPageContext {
+  url: string;
+  path: string;
+  locale: string | null;
+  kind: "content" | "custom";
+  pageType: string;
+  /** Full document title for the rendered page */
+  title: string | null;
+  /** Page-only title for OG/Twitter/JSON-LD headline output */
+  pageTitle?: string | null;
+  description: string | null;
+  canonical: string | null;
+  image: string | null;
+  content?: {
+    collection: string;
+    id: string;
+    slug: string | null;
+  };
+  /** SEO meta for base metadata generation in DinewayHead */
+  seo?: {
+    ogTitle?: string | null;
+    ogDescription?: string | null;
+    ogImage?: string | null;
+    robots?: string | null;
+  };
+  /** Article metadata for Open Graph article: tags */
+  articleMeta?: {
+    publishedTime?: string | null;
+    modifiedTime?: string | null;
+    author?: string | null;
+  };
+  /** Site name for structured data and og:site_name */
+  siteName?: string;
+  /**
+   * Optional breadcrumb trail for this page, root first. When set,
+   * SEO plugins should use this verbatim rather than deriving a trail
+   * from `path`. Themes typically populate this at the point they
+   * build the context (e.g. from a content hierarchy walk, taxonomy
+   * lookup, or per-`pageType` routing logic).
+   *
+   * Semantics for consumers:
+   *   - `undefined` — theme has no opinion; consumer falls back to
+   *     its own derivation.
+   *   - `[]` — this page has no breadcrumbs (e.g. homepage); consumer
+   *     should skip `BreadcrumbList` emission entirely.
+   *   - Non-empty array — used verbatim for `BreadcrumbList` output.
+   */
+  breadcrumbs?: BreadcrumbItem[];
+  /** Public-facing site URL (origin) for structured data */
+  siteUrl?: string;
+}
+interface PageMetadataEvent {
+  page: PublicPageContext;
+}
+/**
+ * Allowed rel values for link contributions.
+ * This is a security-critical allowlist -- sandboxed plugins can only inject
+ * link tags with these rel values. Adding "stylesheet", "prefetch", "prerender"
+ * etc. would allow sandboxed plugins to inject external resources.
+ */
+type PageMetadataLinkRel = "canonical" | "alternate" | "author" | "license" | "site.standard.document";
+type PageMetadataContribution = {
+  kind: "meta";
+  name: string;
+  content: string;
+  key?: string;
+} | {
+  kind: "property";
+  property: string;
+  content: string;
+  key?: string;
+} | {
+  kind: "link";
+  rel: PageMetadataLinkRel;
+  href: string;
+  hreflang?: string;
+  key?: string;
+} | {
+  kind: "jsonld";
+  id?: string;
+  graph: Record<string, unknown> | Array<Record<string, unknown>>;
+};
+type PageMetadataHandler = (event: PageMetadataEvent, ctx: PluginContext) => PageMetadataContribution | PageMetadataContribution[] | null | Promise<PageMetadataContribution | PageMetadataContribution[] | null>;
+interface PageFragmentEvent {
+  page: PublicPageContext;
+}
+type PageFragmentContribution = {
+  kind: "external-script";
+  placement: PagePlacement;
+  src: string;
+  async?: boolean;
+  defer?: boolean;
+  attributes?: Record<string, string>;
+  key?: string;
+} | {
+  kind: "inline-script";
+  placement: PagePlacement;
+  code: string;
+  attributes?: Record<string, string>;
+  key?: string;
+} | {
+  kind: "html";
+  placement: PagePlacement;
+  html: string;
+  key?: string;
+};
+type PageFragmentHandler = (event: PageFragmentEvent, ctx: PluginContext) => PageFragmentContribution | PageFragmentContribution[] | null | Promise<PageFragmentContribution | PageFragmentContribution[] | null>;
+/**
+ * Plugin hooks definition
+ */
+interface PluginHooks {
+  "plugin:install"?: HookConfig<LifecycleHandler> | LifecycleHandler;
+  "plugin:activate"?: HookConfig<LifecycleHandler> | LifecycleHandler;
+  "plugin:deactivate"?: HookConfig<LifecycleHandler> | LifecycleHandler;
+  "plugin:uninstall"?: HookConfig<UninstallHandler> | UninstallHandler;
+  "content:beforeSave"?: HookConfig<ContentBeforeSaveHandler> | ContentBeforeSaveHandler;
+  "content:afterSave"?: HookConfig<ContentAfterSaveHandler> | ContentAfterSaveHandler;
+  "content:beforeDelete"?: HookConfig<ContentBeforeDeleteHandler> | ContentBeforeDeleteHandler;
+  "content:afterDelete"?: HookConfig<ContentAfterDeleteHandler> | ContentAfterDeleteHandler;
+  "content:afterPublish"?: HookConfig<ContentAfterPublishHandler> | ContentAfterPublishHandler;
+  "content:afterUnpublish"?: HookConfig<ContentAfterUnpublishHandler> | ContentAfterUnpublishHandler;
+  "media:beforeUpload"?: HookConfig<MediaBeforeUploadHandler> | MediaBeforeUploadHandler;
+  "media:afterUpload"?: HookConfig<MediaAfterUploadHandler> | MediaAfterUploadHandler;
+  cron?: HookConfig<CronHandler> | CronHandler;
+  "email:beforeSend"?: HookConfig<EmailBeforeSendHandler> | EmailBeforeSendHandler;
+  "email:deliver"?: HookConfig<EmailDeliverHandler> | EmailDeliverHandler;
+  "email:afterSend"?: HookConfig<EmailAfterSendHandler> | EmailAfterSendHandler;
+  "comment:beforeCreate"?: HookConfig<CommentBeforeCreateHandler> | CommentBeforeCreateHandler;
+  "comment:moderate"?: HookConfig<CommentModerateHandler> | CommentModerateHandler;
+  "comment:afterCreate"?: HookConfig<CommentAfterCreateHandler> | CommentAfterCreateHandler;
+  "comment:afterModerate"?: HookConfig<CommentAfterModerateHandler> | CommentAfterModerateHandler;
+  "page:metadata"?: HookConfig<PageMetadataHandler> | PageMetadataHandler;
+  "page:fragments"?: HookConfig<PageFragmentHandler> | PageFragmentHandler;
+}
+/**
+ * Hook names
+ */
+type HookName = keyof PluginHooks;
+/**
+ * Hook metadata entry in a plugin manifest.
+ * Replaces the plain hook name string with structured metadata.
+ */
+interface ManifestHookEntry {
+  name: string;
+  exclusive?: boolean;
+  priority?: number;
+  timeout?: number;
+}
+/**
+ * Route metadata entry in a plugin manifest.
+ * Replaces the plain route name string with structured metadata.
+ */
+interface ManifestRouteEntry {
+  name: string;
+  public?: boolean;
+}
+/**
+ * Resolved hook with normalized config
+ */
+interface ResolvedHook<THandler> {
+  priority: number;
+  timeout: number;
+  dependencies: string[];
+  errorPolicy: "continue" | "abort";
+  /** Whether this hook is exclusive (provider pattern) */
+  exclusive: boolean;
+  handler: THandler;
+  pluginId: string;
+}
+/**
+ * Geographic location information derived from the request.
+ * Available when the host runtime provides geographic request metadata
+ * (for example via a `request.cf` object).
+ */
+interface GeoInfo {
+  country: string | null;
+  region: string | null;
+  city: string | null;
+}
+/**
+ * Normalized request metadata available to plugin route handlers.
+ * Extracted from request headers and platform-specific properties.
+ */
+interface RequestMeta {
+  ip: string | null;
+  userAgent: string | null;
+  referer: string | null;
+  geo: GeoInfo | null;
+}
+/**
+ * Route handler context extends plugin context with request-specific data
+ */
+interface RouteContext<TInput = unknown> extends PluginContext {
+  /** Validated input from request body */
+  input: TInput;
+  /** Original request */
+  request: Request;
+  /** Normalized request metadata (IP, user agent, geo) */
+  requestMeta: RequestMeta;
+}
+/**
+ * Route definition
+ */
+interface PluginRoute<TInput = unknown> {
+  /** Zod schema for input validation */
+  input?: z.ZodType<TInput>;
+  /**
+   * Mark this route as publicly accessible (no authentication required).
+   * Public routes skip session/token auth and CSRF checks.
+   */
+  public?: boolean;
+  /** Route handler */
+  handler: (ctx: RouteContext<TInput>) => Promise<unknown>;
+}
+/**
+ * Admin page definition
+ */
+interface PluginAdminPage {
+  path: string;
+  label: string;
+  icon?: string;
+}
+/**
+ * Dashboard widget definition
+ */
+interface PluginDashboardWidget {
+  id: string;
+  size?: "full" | "half" | "third";
+  title?: string;
+}
+/**
+ * Settings field types (for admin UI generation)
+ */
+type SettingFieldType = "string" | "number" | "boolean" | "select" | "secret";
+interface BaseSettingField {
+  type: SettingFieldType;
+  label: string;
+  description?: string;
+}
+interface StringSettingField extends BaseSettingField {
+  type: "string";
+  default?: string;
+  multiline?: boolean;
+}
+interface NumberSettingField extends BaseSettingField {
+  type: "number";
+  default?: number;
+  min?: number;
+  max?: number;
+}
+interface BooleanSettingField extends BaseSettingField {
+  type: "boolean";
+  default?: boolean;
+}
+interface SelectSettingField extends BaseSettingField {
+  type: "select";
+  options: Array<{
+    value: string;
+    label: string;
+  }>;
+  default?: string;
+}
+interface SecretSettingField extends BaseSettingField {
+  type: "secret";
+}
+type SettingField = StringSettingField | NumberSettingField | BooleanSettingField | SelectSettingField | SecretSettingField;
+/**
+ * Block Kit element for block editing fields.
+ * This is the `Element` discriminated union from `@dineway-ai/blocks`.
+ * Plugin authors should use `@dineway-ai/blocks` builder functions to create these.
+ */
+type PortableTextBlockField = Element;
+/**
+ * Configuration for a Portable Text block type contributed by a plugin
+ */
+interface PortableTextBlockConfig {
+  /** Block type name (must match the `_type` in Portable Text) */
+  type: string;
+  /** Human-readable label shown in slash commands and modals */
+  label: string;
+  /** Icon key (e.g., "video", "code", "link", "link-external") */
+  icon?: string;
+  /** Description shown in slash command menu */
+  description?: string;
+  /** Placeholder text for the URL input */
+  placeholder?: string;
+  /** Block Kit form fields for the editing UI. If declared, replaces the simple URL input. */
+  fields?: PortableTextBlockField[];
+}
+/**
+ * Configuration for a field widget type contributed by a plugin.
+ * A field widget provides a custom editing UI for a schema field.
+ * The field references the widget via `widget: "pluginId:widgetName"`.
+ */
+interface FieldWidgetConfig {
+  /** Widget name (without plugin ID prefix) */
+  name: string;
+  /** Human-readable label for the admin UI */
+  label: string;
+  /** Which field types this widget can edit (e.g., ["json", "string"]) */
+  fieldTypes: FieldType[];
+  /** Block Kit elements for sandboxed rendering. Omit for trusted plugins using React. */
+  elements?: Element[];
+}
+/**
+ * Admin configuration
+ */
+interface PluginAdminConfig {
+  /** Module specifier for admin UI exports (e.g., "@dineway-ai/plugin-audit-log/admin") */
+  entry?: string;
+  /** Settings schema for auto-generated UI */
+  settingsSchema?: Record<string, SettingField>;
+  /** Admin pages */
+  pages?: PluginAdminPage[];
+  /** Dashboard widgets */
+  widgets?: PluginDashboardWidget[];
+  /** Portable Text block types this plugin provides */
+  portableTextBlocks?: PortableTextBlockConfig[];
+  /** Field widget types this plugin provides */
+  fieldWidgets?: FieldWidgetConfig[];
+}
+/**
+ * Plugin definition - input to definePlugin()
+ */
+interface PluginDefinition<TStorage extends PluginStorageConfig = PluginStorageConfig> {
+  /** Unique plugin identifier */
+  id: string;
+  /** Plugin version (semver) */
+  version: string;
+  /** Declared capabilities */
+  capabilities?: PluginCapability[];
+  /** Allowed hosts for network:fetch (wildcards supported: *.example.com) */
+  allowedHosts?: string[];
+  /** Storage collections with indexes */
+  storage?: TStorage;
+  /** Hooks */
+  hooks?: PluginHooks;
+  /** API routes */
+  routes?: Record<string, PluginRoute>;
+  /** Admin UI configuration */
+  admin?: PluginAdminConfig;
+}
+/**
+ * Resolved plugin - after definePlugin() processing
+ */
+interface ResolvedPlugin<TStorage extends PluginStorageConfig = PluginStorageConfig> {
+  id: string;
+  version: string;
+  capabilities: PluginCapability[];
+  allowedHosts: string[];
+  storage: TStorage;
+  hooks: ResolvedPluginHooks;
+  routes: Record<string, PluginRoute>;
+  admin: PluginAdminConfig;
+}
+/**
+ * Resolved hooks with normalized config
+ */
+interface ResolvedPluginHooks {
+  "plugin:install"?: ResolvedHook<LifecycleHandler>;
+  "plugin:activate"?: ResolvedHook<LifecycleHandler>;
+  "plugin:deactivate"?: ResolvedHook<LifecycleHandler>;
+  "plugin:uninstall"?: ResolvedHook<UninstallHandler>;
+  "content:beforeSave"?: ResolvedHook<ContentBeforeSaveHandler>;
+  "content:afterSave"?: ResolvedHook<ContentAfterSaveHandler>;
+  "content:beforeDelete"?: ResolvedHook<ContentBeforeDeleteHandler>;
+  "content:afterDelete"?: ResolvedHook<ContentAfterDeleteHandler>;
+  "content:afterPublish"?: ResolvedHook<ContentAfterPublishHandler>;
+  "content:afterUnpublish"?: ResolvedHook<ContentAfterUnpublishHandler>;
+  "media:beforeUpload"?: ResolvedHook<MediaBeforeUploadHandler>;
+  "media:afterUpload"?: ResolvedHook<MediaAfterUploadHandler>;
+  cron?: ResolvedHook<CronHandler>;
+  "email:beforeSend"?: ResolvedHook<EmailBeforeSendHandler>;
+  "email:deliver"?: ResolvedHook<EmailDeliverHandler>;
+  "email:afterSend"?: ResolvedHook<EmailAfterSendHandler>;
+  "comment:beforeCreate"?: ResolvedHook<CommentBeforeCreateHandler>;
+  "comment:moderate"?: ResolvedHook<CommentModerateHandler>;
+  "comment:afterCreate"?: ResolvedHook<CommentAfterCreateHandler>;
+  "comment:afterModerate"?: ResolvedHook<CommentAfterModerateHandler>;
+  "page:metadata"?: ResolvedHook<PageMetadataHandler>;
+  "page:fragments"?: ResolvedHook<PageFragmentHandler>;
+}
+/**
+ * Standard plugin hook handler -- same as sandbox entry format.
+ * Receives the event as the first argument and a PluginContext as the second.
+ *
+ * Plugin authors annotate their event parameters with specific types for IDE
+ * support. At the type level, we accept any function with compatible arity.
+ */
+type StandardHookHandler = (...args: any[]) => Promise<any>;
+/**
+ * Standard plugin hook entry -- either a bare handler or a config object.
+ */
+type StandardHookEntry = StandardHookHandler | {
+  handler: StandardHookHandler;
+  priority?: number;
+  timeout?: number;
+  dependencies?: string[];
+  errorPolicy?: "continue" | "abort";
+  exclusive?: boolean;
+};
+/**
+ * Standard plugin route handler -- takes (routeCtx, pluginCtx) like sandbox entries.
+ * The routeCtx contains input and request info; pluginCtx is the full plugin context.
+ *
+ * Uses `any` for routeCtx to allow plugins to access properties like
+ * `routeCtx.request.url` without needing exact type matches across
+ * trusted (Request object) and sandboxed (plain object) modes.
+ */
+type StandardRouteHandler = (routeCtx: any, ctx: PluginContext) => Promise<unknown>;
+/**
+ * Standard plugin route entry -- either a config object with handler, or just a handler.
+ */
+interface StandardRouteEntry {
+  handler: StandardRouteHandler;
+  input?: unknown;
+  public?: boolean;
+}
+/**
+ * Standard plugin definition -- the sandbox entry format.
+ * Used by standard plugins that work in both trusted and sandboxed modes.
+ * No id/version/capabilities -- those come from the descriptor.
+ *
+ * This is the input to definePlugin() for standard-format plugins.
+ *
+ * The hooks and routes use permissive types (Record<string, any>) so that
+ * plugin authors can annotate their handlers with specific event types
+ * without type errors from strictFunctionTypes contravariance.
+ */
+interface StandardPluginDefinition {
+  hooks?: Record<string, any>;
+  routes?: Record<string, any>;
+}
+/**
+ * Check if a value is a StandardPluginDefinition (has hooks/routes but no id/version).
+ */
+declare function isStandardPluginDefinition(value: unknown): value is StandardPluginDefinition;
+/**
+ * What a plugin exports from its /admin entrypoint
+ * Uses generic component type to avoid React dependency
+ */
+interface PluginAdminExports {
+  widgets?: Record<string, JSX.Element>;
+  pages?: Record<string, JSX.Element>;
+  fields?: Record<string, JSX.Element>;
+}
+/**
+ * Plugin manifest - the metadata portion of a plugin bundle
+ * Used for sandboxed plugins loaded from marketplace
+ */
+interface PluginManifest {
+  id: string;
+  version: string;
+  capabilities: PluginCapability[];
+  allowedHosts: string[];
+  storage: PluginStorageConfig;
+  /** Hook declarations — either plain name strings or structured objects */
+  hooks: Array<ManifestHookEntry | HookName>;
+  /** Route declarations — either plain name strings or structured objects */
+  routes: Array<ManifestRouteEntry | string>;
+  admin: PluginAdminConfig;
+}
+//#endregion
+export { StandardPluginDefinition as $, PageMetadataHandler as A, PluginManifest as B, MediaUploadEvent as C, PageFragmentHandler as D, PageFragmentEvent as E, PluginAdminPage as F, PublicPageContext as G, PluginStorageConfig as H, PluginCapability as I, ResolvedPlugin as J, RequestMeta as K, PluginContext as L, PagePlacement as M, PluginAdminConfig as N, PageMetadataContribution as O, PluginAdminExports as P, StandardHookHandler as Q, PluginDefinition as R, MediaItem as S, PageFragmentContribution as T, PortableTextBlockConfig as U, PluginRoute as V, PortableTextBlockField as W, RouteContext as X, ResolvedPluginHooks as Y, StandardHookEntry as Z, HookName as _, CommentAfterModerateEvent as a, Element as at, LogAccess as b, CommentBeforeCreateHandler as c, ContentAccess as d, StandardRouteEntry as et, ContentHookEvent as f, HookConfig as g, FieldWidgetConfig as h, CommentAfterCreateHandler as i, isStandardPluginDefinition as it, PageMetadataLinkRel as j, PageMetadataEvent as k, CommentModerateEvent as l, EmailMessage as m, CollectionCommentSettings as n, StorageCollection as nt, CommentAfterModerateHandler as o, CronEvent as p, ResolvedHook as q, CommentAfterCreateEvent as r, StoredComment as rt, CommentBeforeCreateEvent as s, BreadcrumbItem as t, StandardRouteHandler as tt, CommentModerateHandler as u, HttpAccess as v, ModerationDecision as w, MediaAccess as x, KVAccess as y, PluginHooks as z };