emdash 0.37.0 → 0.39.0

package/dist/patterns-Do3iqi7N.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns-Do3iqi7N.mjs","names":[],"sources":["../src/redirects/patterns.ts"],"sourcesContent":["/**\n * URL pattern matching for redirects.\n *\n * Uses Astro's route syntax: [param] for named segments, [...rest] for catch-all.\n * Compiles patterns to safe regexes -- no user-supplied regex, no ReDoS risk.\n *\n * @example\n * ```ts\n * const compiled = compilePattern(\"/old-blog/[...path]\");\n * const match = matchPattern(compiled, \"/old-blog/2024/01/post\");\n * // match = { path: \"2024/01/post\" }\n *\n * interpolateDestination(\"/blog/[...path]\", match);\n * // \"/blog/2024/01/post\"\n * ```\n */\n\n/** Matches [paramName] placeholders */\nconst PARAM_PATTERN = /\\[(\\w+)\\]/g;\n\n/** Matches [...splatName] placeholders */\nconst SPLAT_PATTERN = /\\[\\.\\.\\.(\\w+)\\]/g;\n\n/** Combined pattern for validation: matches both [param] and [...splat] */\nconst ANY_PLACEHOLDER = /\\[(?:\\.\\.\\.)?(\\w+)\\]/g;\n\n/** Nested brackets check: [foo[ */\nconst NESTED_BRACKETS = /\\[[^\\]]*\\[/;\n\n/** Empty brackets: [] */\nconst EMPTY_BRACKETS = /\\[\\]/;\n\n/** Count open brackets */\nconst OPEN_BRACKET = /\\[/g;\n\n/** Count close brackets */\nconst CLOSE_BRACKET = /\\]/g;\n\n/** Split on capture groups in compiled regex string */\nconst CAPTURE_GROUP_SPLIT = /(\\([^)]+\\))/;\n\n/** Escape regex-special characters in literal parts */\nconst REGEX_SPECIAL_CHARS = /[.*+?^${}|\\\\]/g;\n\nexport interface CompiledPattern {\n\tregex: RegExp;\n\tparamNames: string[];\n\tsource: string;\n}\n\n/**\n * Returns true if a source string contains [param] or [...splat] placeholders.\n */\nexport function isPattern(source: string): boolean {\n\t// Use match() instead of test() to avoid lastIndex issues with the global regex\n\treturn source.match(ANY_PLACEHOLDER) !== null;\n}\n\n/**\n * Validate that a pattern string is well-formed.\n * Returns null if valid, or an error message if invalid.\n */\nexport function validatePattern(source: string): string | null {\n\tif (!source.startsWith(\"/\")) {\n\t\treturn \"Pattern must start with /\";\n\t}\n\n\t// Check for nested brackets\n\tif (NESTED_BRACKETS.test(source)) {\n\t\treturn \"Nested brackets are not allowed\";\n\t}\n\n\t// Check for empty brackets\n\tif (EMPTY_BRACKETS.test(source)) {\n\t\treturn \"Empty brackets are not allowed\";\n\t}\n\n\t// Check for unmatched brackets\n\tconst openCount = (source.match(OPEN_BRACKET) ?? []).length;\n\tconst closeCount = (source.match(CLOSE_BRACKET) ?? []).length;\n\tif (openCount !== closeCount) {\n\t\treturn \"Unmatched brackets\";\n\t}\n\n\t// Check that [...splat] is only in the last segment\n\tconst segments = source.split(\"/\").filter(Boolean);\n\tfor (let i = 0; i < segments.length; i++) {\n\t\tconst segment = segments[i];\n\t\tif (SPLAT_PATTERN.test(segment) && i !== segments.length - 1) {\n\t\t\tSPLAT_PATTERN.lastIndex = 0;\n\t\t\treturn \"Catch-all [...param] must be in the last segment\";\n\t\t}\n\t\tSPLAT_PATTERN.lastIndex = 0;\n\t}\n\n\t// Check that a segment is either all literal or a single placeholder\n\tfor (const segment of segments) {\n\t\tconst placeholders = segment.match(ANY_PLACEHOLDER);\n\t\tif (placeholders && placeholders.length > 1) {\n\t\t\treturn \"Each segment can contain at most one placeholder\";\n\t\t}\n\t\tif (placeholders && placeholders[0] !== segment) {\n\t\t\treturn \"A placeholder must be the entire segment, not mixed with literal text\";\n\t\t}\n\t}\n\n\t// Check for duplicate param names\n\tconst names: string[] = [];\n\tfor (const m of source.matchAll(ANY_PLACEHOLDER)) {\n\t\tconst name = m[1];\n\t\tif (names.includes(name)) {\n\t\t\treturn `Duplicate parameter name: ${name}`;\n\t\t}\n\t\tnames.push(name);\n\t}\n\n\treturn null;\n}\n\n/**\n * Validate that all placeholders in a destination exist in the source.\n * Returns null if valid, or an error message if invalid.\n */\nexport function validateDestinationParams(source: string, destination: string): string | null {\n\tconst sourceNames = new Set<string>();\n\tfor (const m of source.matchAll(ANY_PLACEHOLDER)) {\n\t\tsourceNames.add(m[1]);\n\t}\n\n\tfor (const m of destination.matchAll(ANY_PLACEHOLDER)) {\n\t\tconst name = m[1];\n\t\tif (!sourceNames.has(name)) {\n\t\t\treturn `Destination references [${name}] which is not captured in the source pattern`;\n\t\t}\n\t}\n\n\treturn null;\n}\n\n/**\n * Compile a URL pattern into a regex for matching.\n *\n * - `[param]` matches a single path segment (`[^/]+`)\n * - `[...rest]` matches one or more remaining segments (`.+`)\n */\nexport function compilePattern(source: string): CompiledPattern {\n\tconst paramNames: string[] = [];\n\n\t// Replace [...splat] first (before [param]) since [...x] contains [x]\n\tlet regexStr = source.replace(SPLAT_PATTERN, (_match, name: string) => {\n\t\tparamNames.push(name);\n\t\treturn \"(.+)\";\n\t});\n\n\t// Then replace [param]\n\tregexStr = regexStr.replace(PARAM_PATTERN, (_match, name: string) => {\n\t\tparamNames.push(name);\n\t\treturn \"([^/]+)\";\n\t});\n\n\t// Escape any regex-special characters in the literal parts\n\t// We need to be careful: the replacement groups are already valid regex\n\t// Split on capture groups, escape literals, rejoin\n\tconst parts = regexStr.split(CAPTURE_GROUP_SPLIT);\n\tconst escaped = parts\n\t\t.map((part, i) => {\n\t\t\t// Odd indices are the capture groups -- leave them alone\n\t\t\tif (i % 2 === 1) return part;\n\t\t\t// Even indices are literal text -- escape special regex chars\n\t\t\treturn part.replace(REGEX_SPECIAL_CHARS, \"\\\\$&\");\n\t\t})\n\t\t.join(\"\");\n\n\treturn {\n\t\tregex: new RegExp(`^${escaped}$`),\n\t\tparamNames,\n\t\tsource,\n\t};\n}\n\n/**\n * Match a path against a compiled pattern.\n * Returns captured params or null if no match.\n */\nexport function matchPattern(\n\tcompiled: CompiledPattern,\n\tpath: string,\n): Record<string, string> | null {\n\tconst match = path.match(compiled.regex);\n\tif (!match) return null;\n\n\tconst params: Record<string, string> = {};\n\tfor (let i = 0; i < compiled.paramNames.length; i++) {\n\t\tconst value = match[i + 1];\n\t\tif (value !== undefined) {\n\t\t\tparams[compiled.paramNames[i]] = value;\n\t\t}\n\t}\n\treturn params;\n}\n\n/**\n * Interpolate captured params into a destination pattern.\n *\n * @example\n * interpolateDestination(\"/blog/[...path]\", { path: \"2024/01/post\" })\n * // \"/blog/2024/01/post\"\n */\nexport function interpolateDestination(\n\tdestination: string,\n\tparams: Record<string, string>,\n): string {\n\t// Replace [...splat] first\n\tlet result = destination.replace(SPLAT_PATTERN, (_match, name: string) => {\n\t\treturn params[name] ?? \"\";\n\t});\n\n\t// Then [param]\n\tresult = result.replace(PARAM_PATTERN, (_match, name: string) => {\n\t\treturn params[name] ?? \"\";\n\t});\n\n\treturn result;\n}\n"],"mappings":"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"}

package/dist/placeholder-CubPFn_L.d.mts

@@ -0,0 +1,306 @@
+//#region src/media/types.d.ts
+/**
+ * Media Provider Types
+ *
+ * Media providers are pluggable sources for browsing, uploading, and embedding media.
+ * They enable integration with external services (Unsplash, Cloudinary, Mux, etc.)
+ * alongside the built-in local media library.
+ */
+/**
+ * Serializable media provider configuration descriptor
+ * Returned by provider config functions (e.g., unsplash(), mux())
+ */
+interface MediaProviderDescriptor<TConfig = Record<string, unknown>> {
+  /** Unique identifier, used in MediaValue.provider */
+  id: string;
+  /** Display name for admin UI */
+  name: string;
+  /** Icon for tab UI (emoji or URL) */
+  icon?: string;
+  /** Module path exporting createMediaProvider function */
+  entrypoint: string;
+  /** Optional React component module for custom admin UI */
+  adminModule?: string;
+  /** Capability flags determine UI behavior */
+  capabilities: MediaProviderCapabilities;
+  /** Serializable config passed to createMediaProvider at runtime */
+  config: TConfig;
+}
+/**
+ * Provider capabilities determine what UI elements to show
+ */
+interface MediaProviderCapabilities {
+  /** Can list/browse media */
+  browse: boolean;
+  /** Supports text search */
+  search: boolean;
+  /** Can upload new media */
+  upload: boolean;
+  /** Can delete media */
+  delete: boolean;
+}
+/**
+ * Options for listing media
+ */
+interface MediaListOptions {
+  /** Pagination cursor */
+  cursor?: string;
+  /** Max items to return (default 20) */
+  limit?: number;
+  /** Search query (if capabilities.search is true) */
+  query?: string;
+  /** Filter by MIME type prefix, e.g., "image/", "video/" */
+  mimeType?: string;
+}
+/**
+ * Result from listing media
+ */
+interface MediaListResult {
+  items: MediaProviderItem[];
+  nextCursor?: string;
+}
+/**
+ * A media item as returned by a provider
+ * This is the provider's view of the item, before it's selected
+ */
+interface MediaProviderItem {
+  /** Provider-specific ID */
+  id: string;
+  /** Original filename */
+  filename: string;
+  /** MIME type */
+  mimeType: string;
+  /** File size in bytes (if known) */
+  size?: number;
+  /** Dimensions (for images/video) */
+  width?: number;
+  height?: number;
+  /** Default focal point for cover-cropped displays */
+  focalX?: number;
+  focalY?: number;
+  /** LQIP blurhash placeholder (images only) */
+  blurhash?: string;
+  /** LQIP dominant-color placeholder, as a CSS color (images only) */
+  dominantColor?: string;
+  /** Accessibility text */
+  alt?: string;
+  /** Preview URL for admin UI thumbnail */
+  previewUrl?: string;
+  /** Provider-specific metadata */
+  meta?: Record<string, unknown>;
+}
+/**
+ * Input for uploading media
+ */
+interface MediaUploadInput {
+  file: File;
+  filename: string;
+  alt?: string;
+}
+/**
+ * Options for generating embed
+ */
+interface EmbedOptions {
+  /** Desired width (provider may use for optimization) */
+  width?: number;
+  /** Desired height */
+  height?: number;
+  /** Image format preference */
+  format?: "webp" | "avif" | "jpeg" | "png" | "auto";
+}
+/**
+ * Embed result types
+ */
+type EmbedResult = ImageEmbed | VideoEmbed | AudioEmbed | ComponentEmbed;
+interface ImageEmbed {
+  type: "image";
+  src: string;
+  srcset?: string;
+  sizes?: string;
+  width?: number;
+  height?: number;
+  /** LQIP blurhash placeholder for rendering before the image loads */
+  blurhash?: string;
+  /** LQIP dominant-color placeholder, as a CSS color */
+  dominantColor?: string;
+  alt?: string;
+  /** Base URL without transforms, for responsive image generation */
+  cdnBaseUrl?: string;
+  /** For providers with URL-based transforms (Cloudinary, imgix) */
+  getSrc?: (opts: {
+    width?: number;
+    height?: number;
+    format?: string;
+  }) => string;
+}
+interface VideoEmbed {
+  type: "video";
+  /** Single source URL */
+  src?: string;
+  /** Multiple sources for format fallback */
+  sources?: Array<{
+    src: string;
+    type: string;
+  }>;
+  /** Poster/thumbnail image */
+  poster?: string;
+  width?: number;
+  height?: number;
+  /** Player controls */
+  controls?: boolean;
+  autoplay?: boolean;
+  muted?: boolean;
+  loop?: boolean;
+  playsinline?: boolean;
+  preload?: "none" | "metadata" | "auto";
+  crossorigin?: "anonymous" | "use-credentials";
+}
+interface AudioEmbed {
+  type: "audio";
+  src?: string;
+  sources?: Array<{
+    src: string;
+    type: string;
+  }>;
+  controls?: boolean;
+  autoplay?: boolean;
+  muted?: boolean;
+  loop?: boolean;
+  preload?: "none" | "metadata" | "auto";
+}
+interface ComponentEmbed {
+  type: "component";
+  /** Package to import from, e.g., "@mux/player-react" */
+  package: string;
+  /** Named export (default export if not specified) */
+  export?: string;
+  /** Props to pass to the component */
+  props: Record<string, unknown>;
+}
+/**
+ * Options for thumbnail generation
+ */
+interface ThumbnailOptions {
+  /** Desired width */
+  width?: number;
+  /** Desired height */
+  height?: number;
+}
+/**
+ * Runtime media provider interface
+ * Implemented by provider entrypoints
+ */
+interface MediaProvider {
+  /**
+   * List/search media items
+   */
+  list(options: MediaListOptions): Promise<MediaListResult>;
+  /**
+   * Get a single item by ID (optional, for refresh/validation)
+   */
+  get?(id: string): Promise<MediaProviderItem | null>;
+  /**
+   * Upload new media (if capabilities.upload is true)
+   */
+  upload?(input: MediaUploadInput): Promise<MediaProviderItem>;
+  /**
+   * Delete media (if capabilities.delete is true)
+   */
+  delete?(id: string): Promise<void>;
+  /**
+   * Get embed information for rendering this media item
+   * Called at runtime when rendering content
+   */
+  getEmbed(value: MediaValue, options?: EmbedOptions): Promise<EmbedResult> | EmbedResult;
+  /**
+   * Get a thumbnail URL for admin display
+   * For images: returns a resized image URL
+   * For videos: returns a poster/thumbnail URL
+   */
+  getThumbnailUrl?(id: string, mimeType?: string, options?: ThumbnailOptions): string;
+}
+/**
+ * Function signature for provider entrypoint modules
+ */
+type CreateMediaProviderFn<TConfig = Record<string, unknown>> = (config: TConfig) => MediaProvider;
+/**
+ * Media value stored in content fields
+ * This is what gets persisted when media is selected
+ *
+ * For backwards compatibility:
+ * - `provider` defaults to "local" if not specified
+ * - `src` is supported for legacy data or external URLs
+ */
+interface MediaValue {
+  /** Provider ID, e.g., "local", "unsplash", "mux" (defaults to "local") */
+  provider?: string;
+  /** Provider-specific item ID */
+  id: string;
+  /** Direct URL (for local media or legacy data) */
+  src?: string;
+  /** Preview URL for admin display (external providers) */
+  previewUrl?: string;
+  /** Cached metadata for display without runtime lookup */
+  filename?: string;
+  mimeType?: string;
+  width?: number;
+  height?: number;
+  /** Default focal point copied when the media item is selected */
+  focalX?: number;
+  focalY?: number;
+  /** Cached LQIP blurhash placeholder (images only) */
+  blurhash?: string;
+  /** Cached LQIP dominant-color placeholder, as a CSS color (images only) */
+  dominantColor?: string;
+  alt?: string;
+  /** Provider-specific data needed for embedding */
+  meta?: Record<string, unknown>;
+}
+/**
+ * Convert a MediaProviderItem to a MediaValue for storage
+ */
+declare function mediaItemToValue(providerId: string, item: MediaProviderItem): MediaValue;
+//#endregion
+//#region src/media/normalize.d.ts
+/**
+ * Normalize a media field value into a consistent MediaValue shape.
+ *
+ * - `null`/`undefined` → `null`
+ * - Bare URL string → `{ provider: "external", id: "", src: url }`
+ * - Bare internal media URL → resolved via local provider's `get()`
+ * - Bare local media ID → resolved via local provider's `get()`
+ * - Object with `provider` + `id` → enriched with missing fields from provider
+ */
+declare function normalizeMediaValue(value: unknown, getProvider: (id: string) => MediaProvider | undefined): Promise<MediaValue | null>;
+//#endregion
+//#region src/media/placeholder.d.ts
+/**
+ * Image Placeholder Generation
+ *
+ * Generates blurhash and dominant color from image buffers for LQIP support.
+ * Decodes images via jpeg-js (pure JS) and upng-js (pure JS, uses pako for
+ * deflate). No Node-specific dependencies — works in Workers and Node SSR.
+ */
+interface PlaceholderData {
+  blurhash: string;
+  dominantColor: string;
+}
+/**
+ * Generate blurhash and dominant color from an image buffer.
+ * Returns null for non-image MIME types or on failure.
+ *
+ * @param dimensions - Optional pre-known dimensions. When present they are
+ *   trusted verbatim (the caller has typically already read them via
+ *   readDimensions); otherwise dimensions are read from this buffer's header.
+ *   Generation is skipped (returns null) when no dimensions are available at
+ *   all, or when the decoded size (width * height * 4) exceeds
+ *   MAX_DECODED_BYTES — both guards avoid OOM from unbounded decodes on
+ *   memory-constrained runtimes.
+ */
+declare function generatePlaceholder(buffer: Uint8Array, mimeType: string, dimensions?: {
+  width: number;
+  height: number;
+}): Promise<PlaceholderData | null>;
+//#endregion
+export { MediaValue as _, ComponentEmbed as a, mediaItemToValue as b, EmbedResult as c, MediaListResult as d, MediaProvider as f, MediaUploadInput as g, MediaProviderItem as h, AudioEmbed as i, ImageEmbed as l, MediaProviderDescriptor as m, generatePlaceholder as n, CreateMediaProviderFn as o, MediaProviderCapabilities as p, normalizeMediaValue as r, EmbedOptions as s, PlaceholderData as t, MediaListOptions as u, ThumbnailOptions as v, VideoEmbed as y };
+//# sourceMappingURL=placeholder-CubPFn_L.d.mts.map

package/dist/placeholder-CubPFn_L.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-CubPFn_L.d.mts","names":[],"sources":["../src/media/types.ts","../src/media/normalize.ts","../src/media/placeholder.ts"],"mappings":"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"}

package/dist/plugin-test-runtime.d.mts

@@ -0,0 +1,97 @@
+import { a as CollectionWithFields } from "./types-DQeU2SR7.mjs";
+import "./parse-tj9XLNO_.mjs";
+import "./types-CbwqGOXm.mjs";
+import { Kt as PluginEditorDraftFieldSelector, Nn as UserInfo } from "./types-DEHidMEk.mjs";
+import "./options-DAknChnw.mjs";
+import "./entry-lock-DX7QkqEg.mjs";
+import { cr as EmDashRuntime, dr as RuntimeDependencies, gr as PluginContentCacheInvalidator, ji as TaxonomyRepository, ki as RedirectRepository, lr as PluginEditorExtensionDispatch, or as handlePluginSettingsGet, sr as handlePluginSettingsUpdate } from "./config-DS7e4EZ9.mjs";
+import "./runner-3gfxRsJG.mjs";
+import "./storage-query-CPctdMKX.mjs";
+import { T as BylineRepository } from "./index-CDwKDkTq.mjs";
+import { o as setI18nConfig, r as getI18nConfig } from "./config-D3HhLON3.mjs";
+import "./types-CCR3ivXE.mjs";
+import "./hreflang-BgS2FqhH.mjs";
+import "./validate-CyQ7I3xF.mjs";
+import { EditorDraftInvocationReceipt, EditorDraftPatchEffect, EditorDraftSnapshot } from "@emdash-cms/blocks";
+
+//#region src/plugins/http-route-dispatch.d.ts
+interface PluginApiRequestContext {
+  runtime: EmDashRuntime;
+  pluginId: string;
+  path: string;
+  request: Request;
+  user?: UserInfo | null;
+  tokenScopes?: string[];
+  invalidateContentCache?: PluginContentCacheInvalidator;
+  editorDispatch?: PluginEditorExtensionDispatch;
+}
+/** Dispatch a request through the production plugin-route policy boundary. */
+declare function dispatchPluginApiRequest({
+  runtime,
+  pluginId,
+  path,
+  request,
+  user,
+  tokenScopes,
+  invalidateContentCache,
+  editorDispatch
+}: PluginApiRequestContext): Promise<Response>;
+interface PluginEditorExtensionApiRequestContext {
+  runtime: EmDashRuntime;
+  pluginId: string;
+  kind: "panel" | "action";
+  extensionId: string;
+  collection: string;
+  entryId: string;
+  request: Request;
+  user?: UserInfo | null;
+  tokenScopes?: string[];
+  invalidateContentCache?: PluginContentCacheInvalidator;
+}
+/** Dispatch a saved-entry extension through ownership, route, and isolate policy. */
+declare function dispatchPluginEditorExtensionApiRequest({
+  runtime,
+  pluginId,
+  kind,
+  extensionId,
+  collection,
+  entryId,
+  request,
+  user,
+  tokenScopes,
+  invalidateContentCache
+}: PluginEditorExtensionApiRequestContext): Promise<Response>;
+//#endregion
+//#region src/plugins/editor-draft.d.ts
+type EditorDraftErrorCode = "EDITOR_DRAFT_STALE" | "EDITOR_DRAFT_FIELD_FORBIDDEN" | "EDITOR_DRAFT_INVALID" | "EDITOR_DRAFT_UNSUPPORTED_FIELD_TYPE" | "EDITOR_DRAFT_TOO_LARGE" | "EDITOR_DRAFT_CAPABILITY_REQUIRED";
+interface EditorDraftValidationError {
+  code: EditorDraftErrorCode;
+  message: string;
+}
+interface ValidatedEditorDraftRequest {
+  snapshot: EditorDraftSnapshot;
+  receipt: EditorDraftInvocationReceipt;
+  readFields: ReadonlySet<string>;
+  patchFields: ReadonlySet<string>;
+}
+declare function validateEditorDraftRequest(input: {
+  request: unknown;
+  collection: CollectionWithFields;
+  entry: {
+    id: string;
+    locale: string | null;
+    revision: string;
+  };
+  readSelector?: PluginEditorDraftFieldSelector;
+  patchSelector?: PluginEditorDraftFieldSelector;
+  canRead: boolean;
+  canPatch: boolean;
+}): ValidatedEditorDraftRequest | EditorDraftValidationError;
+declare function validateEditorDraftPatch(input: {
+  patch: unknown;
+  collection: CollectionWithFields;
+  allowedFields: ReadonlySet<string>;
+}): EditorDraftPatchEffect | EditorDraftValidationError;
+//#endregion
+export { BylineRepository, EmDashRuntime, type PluginApiRequestContext, RedirectRepository, type RuntimeDependencies, TaxonomyRepository, type UserInfo, dispatchPluginApiRequest, dispatchPluginEditorExtensionApiRequest, getI18nConfig, handlePluginSettingsGet, handlePluginSettingsUpdate, setI18nConfig, validateEditorDraftPatch, validateEditorDraftRequest };
+//# sourceMappingURL=plugin-test-runtime.d.mts.map

package/dist/plugin-test-runtime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-test-runtime.d.mts","names":[],"sources":["../src/plugins/http-route-dispatch.ts","../src/plugins/editor-draft.ts"],"mappings":";;;;;;;;;;;;;;;;;UAgFiB,uBAAA;EAChB,OAAA,EAAS,aAAA;EACT,QAAA;EACA,IAAA;EACA,OAAA,EAAS,OAAA;EACT,IAAA,GAAO,QAAA;EACP,WAAA;EACA,sBAAA,GAAyB,6BAAA;EACzB,cAAA,GAAiB,6BAAA;AAAA;;iBAII,wBAAA,CAAA;EACrB,OAAA;EACA,QAAA;EACA,IAAA;EACA,OAAA;EACA,IAAA;EACA,WAAA;EACA,sBAAA;EACA;AAAA,GACE,uBAAA,GAA0B,OAAA,CAAQ,QAAA;AAAA,UAiEpB,sCAAA;EAChB,OAAA,EAAS,aAAA;EACT,QAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA;EACA,OAAA;EACA,OAAA,EAAS,OAAA;EACT,IAAA,GAAO,QAAA;EACP,WAAA;EACA,sBAAA,GAAyB,6BAAA;AAAA;;iBAMJ,uCAAA,CAAA;EACrB,OAAA;EACA,QAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA;EACA,OAAA;EACA,OAAA;EACA,IAAA;EACA,WAAA;EACA;AAAA,GACE,sCAAA,GAAyC,OAAA,CAAQ,QAAA;;;KC5KxC,oBAAA;AAAA,UAQK,0BAAA;EAChB,IAAA,EAAM,oBAAA;EACN,OAAA;AAAA;AAAA,UAagB,2BAAA;EAChB,QAAA,EAAU,mBAAA;EACV,OAAA,EAAS,4BAAA;EACT,UAAA,EAAY,WAAA;EACZ,WAAA,EAAa,WAAA;AAAA;AAAA,iBA2DE,0BAAA,CAA2B,KAAA;EAC1C,OAAA;EACA,UAAA,EAAY,oBAAA;EACZ,KAAA;IAAS,EAAA;IAAY,MAAA;IAAuB,QAAA;EAAA;EAC5C,YAAA,GAAe,8BAAA;EACf,aAAA,GAAgB,8BAAA;EAChB,OAAA;EACA,QAAA;AAAA,IACG,2BAAA,GAA8B,0BAAA;AAAA,iBAwGlB,wBAAA,CAAyB,KAAA;EACxC,KAAA;EACA,UAAA,EAAY,oBAAA;EACZ,aAAA,EAAe,WAAA;AAAA,IACZ,sBAAA,GAAyB,0BAAA"}

package/dist/plugin-test-runtime.mjs

@@ -0,0 +1,105 @@
+import "./runner-ClrleR8A.mjs";
+import "./dialect-helpers-CtYdsX4W.mjs";
+import { r as getI18nConfig, s as setI18nConfig } from "./config-CGVeT8Hc.mjs";
+import "./datetime-normalization-PeiEdcRY.mjs";
+import "./menus-DbgU9z5Q.mjs";
+import "./after-PcEvMY_6.mjs";
+import "./options-D5WcorD5.mjs";
+import "./base64-DvnNgP7e.mjs";
+import "./secrets-DNgVgz_e.mjs";
+import "./content-DZ3B5qtA.mjs";
+import "./object-cache-DlSVbn5Y.mjs";
+import "./slugify-T5GHH42D.mjs";
+import "./types-BkUg2yHx.mjs";
+import "./media-TBlKCwo7.mjs";
+import "./user-DroRntkx.mjs";
+import { t as TaxonomyRepository } from "./taxonomy-Dj1vpw5E.mjs";
+import "./comment-DcT8qdPK.mjs";
+import "./context-B195kjqZ.mjs";
+import "./menus-Wy8m5NcH.mjs";
+import "./resolve-BJIS8wKr.mjs";
+import { t as RedirectRepository } from "./redirect-D2Yo-b6S.mjs";
+import "./request-cache-DaMhSQdx.mjs";
+import "./byline-registry-D6lWzXk6.mjs";
+import "./field-defs-cache-B337z8UJ.mjs";
+import { t as BylineRepository } from "./byline-Doh-wt99.mjs";
+import "./relation-XTAtOpJO.mjs";
+import "./dist-2hDLsLeq.mjs";
+import "./enrich-C2Mk0lwE.mjs";
+import "./entry-locks-CO_KaoU5.mjs";
+import "./seo-_4qmazxz.mjs";
+import "./cache-B0pOlXdM.mjs";
+import "./fts-manager-DMb0sbIQ.mjs";
+import "./loader-t4TxaFiQ.mjs";
+import "./collection-slugs-cache-D9auiKmI.mjs";
+import "./taxonomies-BpqpXJUE.mjs";
+import { _ as handlePluginSettingsGet, v as handlePluginSettingsUpdate } from "./api-DmjKxPCY.mjs";
+import "./dashboard-CZD4G7k_.mjs";
+import "./capture-triggers-gxQxnxrJ.mjs";
+import "./activation-CaMfdBt1.mjs";
+import "./collection-deletion-C3Xixmkx.mjs";
+import "./content-refresh-BHLHJgyt.mjs";
+import "./registry-CkuPoZs7.mjs";
+import "./hash-CLVFzWvx.mjs";
+import "./media-folders-ClIRLUQv.mjs";
+import "./media-usage-work-Cu5DqewW.mjs";
+import "./content-repair-BVll5WNl.mjs";
+import "./media-usage-C4NolTpQ.mjs";
+import "./media-usage-activation-CAhmb14O.mjs";
+import "./media-usage-work-DJr3rOEN.mjs";
+import "./query-D7kHKOws.mjs";
+import "./zod-generator-D_yHIWfs.mjs";
+import "./schema-DEERRrKS.mjs";
+import "./schema-CPhPM9Do.mjs";
+import "./seo-BtU70b7l.mjs";
+import "./settings-DmroR53o.mjs";
+import "./sections-BIpd4Cxf.mjs";
+import "./settings-g2F2a3Ub.mjs";
+import "./taxonomies-ClCo4IGO.mjs";
+import "./manifest-schema-Bkh8SeHd.mjs";
+import "./artifact-fetch-COiMhVgk.mjs";
+import "./ssrf-Co1GGFZz.mjs";
+import "./authoritative-records-DbqshfKD.mjs";
+import "./config-B2acLeC5.mjs";
+import "./error-CCTCskie.mjs";
+import "./parse-Cr379Av9.mjs";
+import "./redirects-BCiTaIQ-.mjs";
+import "./entry-lock-D3C99MXS.mjs";
+import "./comments-BVzzt6x5.mjs";
+import "./relations-B4w-G5U9.mjs";
+import "./status-DLoBmcDz.mjs";
+import "./query-D-lxiOgn.mjs";
+import "./import-DFr5B_hC.mjs";
+import "./redirects-ByItliuu.mjs";
+import "./ssrf-BRpTDMV6.mjs";
+import "./cron-BcR3RN4K.mjs";
+import "./email-console-gc-E3Eqj.mjs";
+import "./media-usage-write-fence-DW5oHT7q.mjs";
+import "./route-wire-D66L2oaZ.mjs";
+import "./routes-DYsTe-oR.mjs";
+import "./utils-CC2oNGV8.mjs";
+import "./tokens-Ns02GAma.mjs";
+import "./preview-Cup2bj8c.mjs";
+import "./hreflang-CrJwqoeb.mjs";
+import "./comment-reaction-DY5-y8Y5.mjs";
+import "./bylines-kpBzHPr8.mjs";
+import "./widgets-wQ7Xcgq8.mjs";
+import "./validate-BCP9HNDn.mjs";
+import "./apply-drpfmqrR.mjs";
+import "./load-Cu5bvCZh.mjs";
+import "./search-lami_Ota.mjs";
+import "./policy-lyZnjpwz.mjs";
+import { n as EmDashRuntime } from "./emdash-runtime-DZGinqTL.mjs";
+import "./site-url-DjhYCaep.mjs";
+import "./public-submission-Cs-pFMQK.mjs";
+import "./snapshot-C32Xuv3o.mjs";
+import "./backup-BsPQdwnS.mjs";
+import "./comments-B67VRNGw.mjs";
+import "./service-Bpy5iTX0.mjs";
+import "./lifecycle-7e-Lt_kX.mjs";
+import "./api-tokens-DS1VzN7_.mjs";
+import "./authorize-BXpfMpp0.mjs";
+import "./scopes-Bn8_rCSt.mjs";
+import { i as validateEditorDraftRequest, n as dispatchPluginEditorExtensionApiRequest, r as validateEditorDraftPatch, t as dispatchPluginApiRequest } from "./http-route-dispatch-DAKlanXb.mjs";
+
+export { BylineRepository, EmDashRuntime, RedirectRepository, TaxonomyRepository, dispatchPluginApiRequest, dispatchPluginEditorExtensionApiRequest, getI18nConfig, handlePluginSettingsGet, handlePluginSettingsUpdate, setI18nConfig, validateEditorDraftPatch, validateEditorDraftRequest };

package/dist/plugin-types.d.mts

@@ -1,7 +1,9 @@
-import { $ as MediaUploadEvent, A as CronHandler, Bt as UserInfo, C as ContentDeleteEvent, D as ContentScheduleStateChangeEvent, E as ContentRestoreStateChangeEvent, F as EmailBeforeSendEvent, G as LifecycleEvent, I as EmailBeforeSendHandler, K as LifecycleHandler, L as EmailDeliverEvent, N as EmailAfterSendEvent, O as ContentStateChangeEvent, P as EmailAfterSendHandler, R as EmailDeliverHandler, Rt as UninstallEvent, T as ContentPublishStateChangeEvent, X as MediaAfterUploadHandler, Y as MediaAfterUploadEvent, Z as MediaBeforeUploadHandler, _ as ContentAfterScheduleHandler, a as CommentAfterCreateHandler, at as PageMetadataEvent, b as ContentBeforeDeleteHandler, c as CommentBeforeCreateEvent, d as CommentModerateHandler, g as ContentAfterSaveHandler, h as ContentAfterRestoreHandler, i as CommentAfterCreateEvent, k as CronEvent, l as CommentBeforeCreateHandler, m as ContentAfterPublishHandler, mt as PluginContext, nt as PageFragmentEvent, o as CommentAfterModerateEvent, ot as PageMetadataHandler, p as ContentAfterDeleteHandler, rt as PageFragmentHandler, s as CommentAfterModerateHandler, u as CommentModerateEvent, v as ContentAfterUnpublishHandler, w as ContentHookEvent, x as ContentBeforeSaveHandler, y as ContentAfterUnscheduleHandler, zt as UninstallHandler } from "./types-B6GrPic4.mjs";
-import { r as SandboxHookErrorEnvelope } from "./hook-result-DCh2WUpe.mjs";
+import { A as ContentBeforePublishHandler, An as UninstallHandler, B as ContentPolicyEvent, C as ContentAfterPublishHandler, Ct as MediaMetadataPatch, D as ContentAfterUnpublishHandler, E as ContentAfterScheduleHandler, Et as NumericDelta, F as ContentDeleteEvent, Fn as VersionedRedirect, Ft as PaginatedResult, G as ContentScheduleStateChangeEvent, H as ContentRestoreStateChangeEvent, I as ContentHookEvent, In as VersionedValue, K as ContentStateChangeEvent, M as ContentBeforeScheduleHandler, Mn as UpdateIfResult, Mt as PageMetadataHandler, N as ContentBeforeUnpublishHandler, Nn as UserInfo, O as ContentAfterUnscheduleHandler, Ot as PageFragmentEvent, S as ContentAfterDeleteHandler, St as MediaItem, T as ContentAfterSaveHandler, Ut as PluginContext, V as ContentPublishStateChangeEvent, W as ContentSchedulePolicyEvent, X as CronEvent, Z as CronHandler, _ as ConditionalDeleteResult, an as RedirectAccessWithWrite, at as EmailDeliverEvent, bt as MediaBeforeUploadHandler, c as CommentAfterCreateHandler, cn as RedirectListOptions, d as CommentBeforeCreateEvent, f as CommentBeforeCreateHandler, g as CommentModerateHandler, h as CommentModerateEvent, ht as LifecycleHandler, in as RedirectAccess, it as EmailBeforeSendHandler, j as ContentBeforeSaveHandler, jn as UpdateIfArgs, jt as PageMetadataEvent, k as ContentBeforeDeleteHandler, kn as UninstallEvent, kt as PageFragmentHandler, l as CommentAfterModerateEvent, ln as RedirectStatus, mt as LifecycleEvent, nt as EmailAfterSendHandler, on as RedirectCreateInput, ot as EmailDeliverHandler, rt as EmailBeforeSendEvent, s as CommentAfterCreateEvent, sn as RedirectInfo, t as ActorInfo, tt as EmailAfterSendEvent, u as CommentAfterModerateHandler, un as RedirectUpdateInput, v as ConditionalWriteResult, vn as SettingsAccess, vt as MediaAfterUploadEvent, w as ContentAfterRestoreHandler, wt as MediaUploadEvent, x as ContentActionOrigin, xt as MediaBytes, yt as MediaAfterUploadHandler, z as ContentPolicyDecision } from "./types-DEHidMEk.mjs";
+import { r as SandboxHookErrorEnvelope } from "./hook-result-KY1jq21o.mjs";
 import { ZodType } from "zod";
 import { Permission } from "@emdash-cms/auth";
+import { PluginFormData, PluginFormData as PluginFormData$1, PluginFormDataFileEntry, PluginFormDataTextEntry, PluginRouteBodyMode, PluginRouteMethod, PluginRouteQuery, PluginRouteQuery as PluginRouteQuery$1, PluginRouteRequest, PluginRouteResponseMode } from "@emdash-cms/plugin-types";
+import { PluginUiContext, PluginUiContext as PluginUiContext$1 } from "@emdash-cms/blocks/server";
 
 //#region src/plugin-types.d.ts
 /**
@@ -20,6 +22,9 @@ interface HookHandlers {
   "content:afterSave": ContentAfterSaveHandler;
   "content:beforeDelete": ContentBeforeDeleteHandler;
   "content:afterDelete": ContentAfterDeleteHandler;
+  "content:beforePublish": ContentBeforePublishHandler;
+  "content:beforeSchedule": ContentBeforeScheduleHandler;
+  "content:beforeUnpublish": ContentBeforeUnpublishHandler;
   "content:afterPublish": ContentAfterPublishHandler;
   "content:afterUnpublish": ContentAfterUnpublishHandler;
   "content:afterRestore": ContentAfterRestoreHandler;
@@ -78,6 +83,26 @@ interface SandboxedRequest {
   method: string;
   headers: Record<string, string>;
 }
+type PluginRouteInput<TMode extends PluginRouteBodyMode> = TMode extends "none" ? PluginRouteQuery$1 : TMode extends "text" ? string : TMode extends "bytes" ? Uint8Array : TMode extends "form-data" ? PluginFormData$1 : unknown;
+type PluginResponseBody = {
+  kind: "text";
+  value: string;
+} | {
+  kind: "bytes";
+  value: Uint8Array;
+};
+interface PluginResponseInit {
+  status?: number;
+  headers?: HeadersInit;
+  body?: PluginResponseBody | null;
+}
+interface PluginResponse {
+  readonly __emdashPluginResponse: true;
+  readonly status: number;
+  readonly headers: Array<[string, string]>;
+  readonly body: PluginResponseBody | null;
+}
+declare function pluginResponse(init?: PluginResponseInit): PluginResponse;
 /**
  * Context passed to a route handler. Routes get an extra `routeCtx`
  * argument with the call-site input + the originating request, in
@@ -90,6 +115,8 @@ interface SandboxedRouteContext {
   input: unknown;
   request: SandboxedRequest;
   requestMeta?: unknown;
+  /** Host-attested context for a validated Block Kit request. */
+  ui?: PluginUiContext$1;
   /**
    * Authenticated caller, if the route is private. Resolved and
    * authorized by the host before dispatch — trust it over any user id
@@ -107,23 +134,34 @@ interface SandboxedRouteContext {
  * Return type is `unknown` because routes serialise their return value
  * to JSON for the caller; authors define their own response shape.
  */
-type RouteHandler = (routeCtx: SandboxedRouteContext, ctx: PluginContext) => Promise<unknown>;
-/**
- * Route entry — either a bare handler or the config form with
- * `public`, `input` schema, and so on. The build probe accepts both.
- */
-type RouteEntry = RouteHandler | {
-  handler: RouteHandler;
+type RouteHandler<TInput = unknown> = {
+  bivarianceHack(routeCtx: Omit<SandboxedRouteContext, "input"> & {
+    input: TInput;
+  }, ctx: PluginContext): Promise<unknown>;
+}["bivarianceHack"];
+interface RouteConfigBase {
   public?: boolean;
-  /**
-   * Cache-Control value for successful GET responses. Only honored on
-   * routes that are also `public: true` — authenticated responses
-   * always keep `private, no-store`.
-   */
   cacheControl?: string;
   input?: unknown;
   permission?: Permission;
+  methods?: PluginRouteMethod[];
+  response?: PluginRouteResponseMode;
+}
+type PluginRouteConfig<TMode extends PluginRouteBodyMode> = RouteConfigBase & {
+  request: PluginRouteRequest & {
+    body: TMode;
+  };
+  handler: RouteHandler<PluginRouteInput<TMode>>;
 };
+declare function pluginRoute<TMode extends PluginRouteBodyMode>(config: PluginRouteConfig<TMode>): PluginRouteConfig<TMode>;
+/**
+ * Route entry — either a bare handler or the config form with
+ * `public`, `input` schema, and so on. The build probe accepts both.
+ */
+type RouteEntry = RouteHandler | (RouteConfigBase & {
+  handler: RouteHandler;
+  request?: PluginRouteRequest;
+});
 interface SandboxedMcpTool {
   description: string;
   route: string;
@@ -152,5 +190,5 @@ interface SandboxedContentBeforeSaveConfig extends Omit<HookConfig<"content:befo
   handler: SandboxedContentBeforeSaveHandler;
 }
 //#endregion
-export { type CommentAfterCreateEvent, type CommentAfterModerateEvent, type CommentBeforeCreateEvent, type CommentModerateEvent, type ContentDeleteEvent, type ContentHookEvent, type ContentPublishStateChangeEvent, type ContentRestoreStateChangeEvent, type ContentScheduleStateChangeEvent, type ContentStateChangeEvent, type CronEvent, type EmailAfterSendEvent, type EmailBeforeSendEvent, type EmailDeliverEvent, HookConfig, HookEntry, HookHandlers, type LifecycleEvent, type MediaAfterUploadEvent, type MediaUploadEvent, type PageFragmentEvent, type PageMetadataEvent, type PluginContext, RouteEntry, RouteHandler, type SandboxHookErrorEnvelope, SandboxedContentBeforeSaveConfig, SandboxedContentBeforeSaveHandler, SandboxedMcpTool, SandboxedPlugin, SandboxedRequest, SandboxedRouteContext, type UninstallEvent };
+export { type ActorInfo, type CommentAfterCreateEvent, type CommentAfterModerateEvent, type CommentBeforeCreateEvent, type CommentModerateEvent, type ConditionalDeleteResult, type ConditionalWriteResult, type ContentActionOrigin, type ContentDeleteEvent, type ContentHookEvent, type ContentPolicyDecision, type ContentPolicyEvent, type ContentPublishStateChangeEvent, type ContentRestoreStateChangeEvent, type ContentSchedulePolicyEvent, type ContentScheduleStateChangeEvent, type ContentStateChangeEvent, type CronEvent, type EmailAfterSendEvent, type EmailBeforeSendEvent, type EmailDeliverEvent, HookConfig, HookEntry, HookHandlers, type LifecycleEvent, type MediaAfterUploadEvent, type MediaBytes, type MediaItem, type MediaMetadataPatch, type MediaUploadEvent, type NumericDelta, type PageFragmentEvent, type PageMetadataEvent, type PaginatedResult, type PluginContext, type PluginFormData, type PluginFormDataFileEntry, type PluginFormDataTextEntry, PluginResponse, PluginResponseBody, PluginResponseInit, PluginRouteConfig, PluginRouteInput, type PluginRouteQuery, type PluginUiContext, type RedirectAccess, type RedirectAccessWithWrite, type RedirectCreateInput, type RedirectInfo, type RedirectListOptions, type RedirectStatus, type RedirectUpdateInput, RouteEntry, RouteHandler, type SandboxHookErrorEnvelope, SandboxedContentBeforeSaveConfig, SandboxedContentBeforeSaveHandler, SandboxedMcpTool, SandboxedPlugin, SandboxedRequest, SandboxedRouteContext, type SettingsAccess, type UninstallEvent, type UpdateIfArgs, type UpdateIfResult, type VersionedRedirect, type VersionedValue, pluginResponse, pluginRoute };
 //# sourceMappingURL=plugin-types.d.mts.map