emdash 0.0.0-b → 0.0.1

package/dist/types-DvhsUmSJ.d.mts

@@ -0,0 +1,1111 @@
+import { u as FieldType } from "./types-C4-fAxN3.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;
+  }>>;
+}
+/**
+ * Content item returned from content API
+ */
+interface ContentItem {
+  id: string;
+  type: string;
+  data: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+/**
+ * Content list options
+ */
+interface ContentListOptions {
+  limit?: number;
+  cursor?: string;
+  orderBy?: Record<string, "asc" | "desc">;
+}
+/**
+ * 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: Record<string, unknown>): Promise<ContentItem>;
+  update?(collection: string, id: string, data: Record<string, unknown>): Promise<ContentItem>;
+  delete?(collection: string, id: string): Promise<boolean>;
+}
+/**
+ * Full content access with write operations
+ */
+interface ContentAccessWithWrite extends ContentAccess {
+  create(collection: string, data: Record<string, unknown>): Promise<ContentItem>;
+  update(collection: string, id: string, data: Record<string, unknown>): 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 _emdash_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;
+}
+/**
+ * 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 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";
+/**
+ * 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;
+  title: 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 EmDashHead */
+  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;
+}
+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;
+  "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 running on Cloudflare Workers (via the `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 `@emdash-cms/blocks`.
+ * Plugin authors should use `@emdash-cms/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., "@emdash-cms/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>;
+  "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 { StandardRouteEntry as $, PageMetadataLinkRel as A, PluginRoute as B, ModerationDecision as C, PageMetadataContribution as D, PageFragmentHandler as E, PluginCapability as F, RequestMeta as G, PortableTextBlockConfig as H, PluginContext as I, ResolvedPluginHooks as J, ResolvedHook as K, PluginDefinition as L, PluginAdminConfig as M, PluginAdminExports as N, PageMetadataEvent as O, PluginAdminPage as P, StandardPluginDefinition as Q, PluginHooks as R, MediaUploadEvent as S, PageFragmentEvent as T, PortableTextBlockField as U, PluginStorageConfig as V, PublicPageContext as W, StandardHookEntry as X, RouteContext as Y, StandardHookHandler as Z, HttpAccess as _, CommentAfterModerateHandler as a, MediaAccess as b, CommentModerateEvent as c, ContentHookEvent as d, StandardRouteHandler as et, CronEvent as f, HookName as g, HookConfig as h, CommentAfterModerateEvent as i, Element as it, PagePlacement as j, PageMetadataHandler as k, CommentModerateHandler as l, FieldWidgetConfig as m, CommentAfterCreateEvent as n, StoredComment as nt, CommentBeforeCreateEvent as o, EmailMessage as p, ResolvedPlugin as q, CommentAfterCreateHandler as r, isStandardPluginDefinition as rt, CommentBeforeCreateHandler as s, CollectionCommentSettings as t, StorageCollection as tt, ContentAccess as u, KVAccess as v, PageFragmentContribution as w, MediaItem as x, LogAccess as y, PluginManifest as z };
+//# sourceMappingURL=types-DvhsUmSJ.d.mts.map