emdash 1.3.0 → 1.3.1

package/dist/types-BqJgTL_y.d.mts

@@ -0,0 +1,293 @@
+import { r as ContentFieldFilters } from "./content-list-query-BK26u9Ly.mjs";
+import { l as CustomFieldValue } from "./types-Bgujop4S.mjs";
+
+//#region src/database/repositories/types.d.ts
+interface CreateContentInput {
+  /** Explicit content ID for stable seed imports. Omit to generate a ULID. */
+  id?: string;
+  type: string;
+  slug?: string | null;
+  data: Record<string, unknown>;
+  status?: string;
+  authorId?: string;
+  primaryBylineId?: string | null;
+  locale?: string;
+  translationOf?: string;
+  /** Field columns selected atomically from `translationOf` during the insert. */
+  inheritFields?: string[];
+  publishedAt?: string | null;
+  /** Override created_at (ISO 8601). Used by importers to preserve original dates. */
+  createdAt?: string | null;
+}
+interface UpdateContentInput {
+  /** Stored locale, supplied by the content handler for alias-aware slug checks. */
+  locale?: string;
+  data?: Record<string, unknown>;
+  status?: string;
+  slug?: string | null;
+  publishedAt?: string | null;
+  scheduledAt?: string | null;
+  /** Entry owner (`ec_{collection}.author_id`). */
+  authorId?: string | null;
+  /** Revision author, separate from entry ownership. */
+  revisionAuthorId?: string | null;
+  primaryBylineId?: string | null;
+  /** `null` drops the entry's draft revision pointer. */
+  draftRevisionId?: null;
+}
+/** SEO fields for content items */
+interface ContentSeo {
+  title: string | null;
+  description: string | null;
+  image: string | null;
+  canonical: string | null;
+  noIndex: boolean;
+}
+/** Input for updating SEO fields on content */
+interface ContentSeoInput {
+  title?: string | null;
+  description?: string | null;
+  image?: string | null;
+  canonical?: string | null;
+  noIndex?: boolean;
+}
+interface BylineSummary {
+  id: string;
+  slug: string;
+  displayName: string;
+  bio: string | null;
+  avatarMediaId: string | null;
+  /**
+   * The avatar media's storage key, folded in by a LEFT JOIN on the
+   * `media` table. Populated by the content-credit hydration path
+   * (`getContentBylines` / `getContentBylinesMany`, i.e. the
+   * `entry.data.bylines` populated by `getEmDashCollection` /
+   * `getEmDashEntry`) and by the single-row finders (`findById`,
+   * `findBySlug`, `findByUserId`, `findByUserIds`). `findMany` doesn't
+   * join media, so it leaves this null.
+   *
+   * Lets a page build a direct storage URL for an author avatar without a
+   * per-byline `MediaRepository.findById`, avoiding an N+1 when many distinct
+   * authors appear on one page.
+   *
+   * Optional so adding it is a non-breaking change for existing code that
+   * constructs a `BylineSummary` literal; the repositories always populate it
+   * (to `null` when there's no avatar or no media join).
+   */
+  avatarStorageKey?: string | null;
+  /** Avatar media alt text, from the same media join. Null when not joined. */
+  avatarAlt?: string | null;
+  /**
+   * Avatar media blurhash (LQIP placeholder, migration 024), folded in by the
+   * same media join as `avatarStorageKey`. Lets a renderer paint a blurred
+   * placeholder while the full avatar loads, with no extra media lookup.
+   * Null when the byline has no avatar, the media row has no blurhash, or the
+   * byline came from `findMany`, which doesn't join media.
+   */
+  avatarBlurhash?: string | null;
+  /**
+   * Avatar media dominant colour (LQIP placeholder, migration 024), from the
+   * same media join. Null under the same conditions as `avatarBlurhash`.
+   */
+  avatarDominantColor?: string | null;
+  websiteUrl: string | null;
+  userId: string | null;
+  isGuest: boolean;
+  createdAt: string;
+  updatedAt: string;
+  /**
+   * Locale this byline row is presented in. Added by migration 040.
+   * `(slug, locale)` is unique; a single slug can repeat across locales.
+   */
+  locale: string;
+  /**
+   * Shared across translations of the same byline. Added by migration 040.
+   * `_emdash_content_bylines.byline_id` and `ec_*.primary_byline_id` store
+   * this value, so a credit spans every locale variant of a byline.
+   * Nullable in storage for backwards compatibility; new rows always
+   * populate it.
+   */
+  translationGroup: string | null;
+  /**
+   * Custom field values registered via the byline-fields schema (migration
+   * 041, Discussion #1174). Optional in the TypeScript shape so existing
+   * object-literal consumers (test fixtures, plugin renderers) stay
+   * source-compatible; the runtime always returns `{}` when no fields are
+   * registered. Translatable values reflect this row's locale; non-
+   * translatable values are shared across every locale variant of the
+   * byline's `translation_group`.
+   */
+  customFields?: Record<string, CustomFieldValue>;
+}
+interface ContentBylineCredit {
+  byline: BylineSummary;
+  sortOrder: number;
+  roleLabel: string | null;
+  /** Whether this credit was explicitly assigned or inferred from authorId */
+  source?: "explicit" | "inferred";
+}
+/** A whitelisted timestamp column a content-list date range can filter on. */
+type ContentDateField = "createdAt" | "updatedAt" | "publishedAt";
+/**
+ * Inclusive date-range filter for a single whitelisted timestamp column.
+ * Bounds are compared lexicographically against the stored ISO 8601 strings,
+ * which is correct because every timestamp is written via `toISOString()`.
+ * Callers wanting an inclusive upper bound should pass an end-of-day value
+ * (e.g. `2024-12-31T23:59:59.999Z`); the repository does not widen `to`.
+ */
+interface ContentDateFilter {
+  field: ContentDateField;
+  from?: string;
+  to?: string;
+}
+/**
+ * Byline filter for a content list.
+ *
+ * `mode: "any"` matches entries credited to at least one of `bylineIds`;
+ * `mode: "none"` matches entries with no credit at all.
+ *
+ * `bylineIds` are `translation_group` values — what
+ * `_emdash_content_bylines.byline_id` stores since migration 040 — so a filter
+ * matches a byline across every locale variant.
+ *
+ * By default only explicit credits count. `includeInferred` widens the filter
+ * to the byline the list actually renders, which for an entry with no credits
+ * is the one linked to its `author_id` (see `hydrateBylinesMany`).
+ */
+interface ContentBylineFilter {
+  mode: "any" | "none";
+  /** Ignored when `mode` is `"none"`. An empty list matches nothing. */
+  bylineIds?: string[];
+  includeInferred?: boolean;
+  /**
+   * Locale a credit has to resolve at — the locale the list is scoped to.
+   * Applies to explicit credits as well as inferred ones, since a byline
+   * group credited to an entry renders only where it has a row at that
+   * locale. Defaults to each entry's own locale when the list spans locales.
+   */
+  locale?: string;
+}
+interface FindManyOptions {
+  where?: {
+    status?: string;
+    authorId?: string;
+    locale?: string; /** Case-insensitive substring to match against `searchColumns`. */
+    q?: string;
+    /**
+     * Columns the `q` substring filter is applied to (OR'd together).
+     * Resolved by the handler from the collection's display fields, slug,
+     * and any field marked searchable. Each name is validated as a SQL
+     * identifier.
+     */
+    searchColumns?: string[];
+    /**
+     * Serve `q` from the collection's FTS5 index (`_emdash_fts_<slug>`)
+     * instead of an unindexable substring LIKE. Set by the handler only
+     * when the collection has search enabled and the index exists
+     * (SQLite only). The repository combines a token-prefix MATCH with
+     * an index-served slug prefix so slug lookups keep working.
+     */
+    useFts?: boolean; /** Inclusive date range over a whitelisted timestamp column. */
+    dateFilter?: ContentDateFilter; /** Restrict to entries by their byline credits. */
+    bylineFilter?: ContentBylineFilter; /** AND-combined filters over custom fields explicitly marked as indexed. */
+    fieldFilters?: ContentFieldFilters;
+  };
+  orderBy?: {
+    field: string;
+    direction: "asc" | "desc";
+  };
+  /**
+   * Extra field slugs allowed as `orderBy` beyond the system columns — the
+   * collection's configured titleField/dateField. Resolved by the
+   * handler server-side so `orderBy` stays a closed set per request.
+   */
+  sortableExtras?: string[];
+  limit?: number;
+  cursor?: string;
+  /** Rows to skip before the page, for numbered pages. Cannot be combined with `cursor`. */
+  offset?: number;
+}
+interface FindManyResult<T> {
+  items: T[];
+  nextCursor?: string;
+  /**
+   * Total number of rows matching the where clause (ignoring pagination).
+   * Optional because not every caller needs it; repositories that compute
+   * it should set it so the UI can render a stable pagination denominator.
+   */
+  total?: number;
+}
+/**
+ * Thrown when a pagination cursor cannot be decoded.
+ *
+ * Repository callers should let this propagate; handler catch blocks
+ * map it to a structured `INVALID_CURSOR` error so client pagination
+ * bugs surface immediately rather than silently re-fetching the first
+ * page.
+ */
+declare class InvalidCursorError extends Error {
+  constructor(cursor: string);
+}
+interface ContentItem {
+  id: string;
+  type: string;
+  slug: string | null;
+  status: string;
+  data: Record<string, unknown>;
+  authorId: string | null;
+  primaryBylineId: string | null;
+  byline?: BylineSummary | null;
+  bylines?: ContentBylineCredit[];
+  createdAt: string;
+  updatedAt: string;
+  publishedAt: string | null;
+  scheduledAt: string | null;
+  liveRevisionId: string | null;
+  draftRevisionId: string | null;
+  version: number;
+  locale: string | null;
+  translationGroup: string | null;
+  /** SEO metadata — only populated for collections with `has_seo` enabled */
+  seo?: ContentSeo;
+  /**
+   * For collections that support `revisions`: when a draft revision exists,
+   * `data` reflects the unsaved draft and `liveData` carries the currently-
+   * published values. When no draft exists, `liveData` is undefined.
+   *
+   * Hydrated by `EmDashRuntime.hydrateDraftData()` — repositories themselves
+   * never set this field; it's purely a runtime-overlay concept that gives
+   * agents a clear picture of "draft vs. live" without re-fetching the
+   * revision history.
+   */
+  liveData?: Record<string, unknown>;
+  /**
+   * First page of each reference field's resolved selection, keyed by field
+   * slug. Only populated when the caller opts in via `handleContentGet`'s
+   * `referenceOptions` param (see content.ts) — hydration is never
+   * unconditional because it can leak draft ids/slugs to callers without
+   * `content:read_drafts`.
+   *
+   * Shape mirrors `EntryRef` from `api/handlers/relations.ts`, duplicated
+   * here (rather than imported) so the database layer doesn't depend on
+   * the api/handlers layer.
+   */
+  references?: Record<string, {
+    children: Array<{
+      id: string;
+      slug: string | null;
+      collection: string;
+      title: string | null;
+      locale: string | null;
+      translationGroup: string | null;
+      sortOrder?: number;
+    }>;
+    nextCursor?: string;
+  }>;
+}
+declare class EmDashValidationError extends Error {
+  details?: unknown | undefined;
+  constructor(message: string, details?: unknown | undefined);
+}
+//#endregion
+export { ContentSeo as a, EmDashValidationError as c, InvalidCursorError as d, UpdateContentInput as f, ContentItem as i, FindManyOptions as l, ContentBylineCredit as n, ContentSeoInput as o, ContentDateField as r, CreateContentInput as s, BylineSummary as t, FindManyResult as u };
+//# sourceMappingURL=types-BqJgTL_y.d.mts.map

package/dist/types-BqJgTL_y.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BqJgTL_y.d.mts","names":[],"sources":["../src/database/repositories/types.ts"],"mappings":";;;;UAciB,kBAAA;EAKV;EAHN,EAAA;EACA,IAAA;EACA,IAAA;EACA,IAAA,EAAM,MAAA;EACN,MAAA;EACA,QAAA;EACA,eAAA;EACA,MAAA;EACA,aAAA;EAKS;EAHT,aAAA;EACA,WAAA;;EAEA,SAAA;AAAA;AAAA,UAGgB,kBAAA;EAGT;EADP,MAAA;EACA,IAAA,GAAO,MAAA;EACP,MAAA;EACA,IAAA;EACA,WAAA;EACA,WAAA;EAKA;EAHA,QAAA;EAKe;EAHf,gBAAA;EACA,eAAA;EAM0B;EAJ1B,eAAA;AAAA;;UAIgB,UAAA;EAChB,KAAA;EACA,WAAA;EACA,KAAA;EACA,SAAA;EACA,OAAA;AAAA;;UAIgB,eAAA;EAChB,KAAA;EACA,WAAA;EACA,KAAA;EACA,SAAA;EACA,OAAA;AAAA;AAAA,UAGgB,aAAA;EAChB,EAAA;EACA,IAAA;EACA,WAAA;EACA,GAAA;EACA,aAAA;EAJA;;;;;;;;;;;;;;;;;EAsBA,gBAAA;EA2C8B;EAzC9B,SAAA;EAyC8C;AAG/C;;;;;;EApCC,cAAA;EAuCA;;;;EAlCA,mBAAA;EACA,UAAA;EACA,MAAA;EACA,OAAA;EACA,SAAA;EACA,SAAA;EA4CiC;;;;EAvCjC,MAAA;EAyCA;;;;AAkBD;;;EAnDC,gBAAA;EAoDA;;;;;;AAaD;;;EAvDC,YAAA,GAAe,MAAA,SAAe,gBAAA;AAAA;AAAA,UAGd,mBAAA;EAChB,MAAA,EAAQ,aAAA;EACR,SAAA;EACA,SAAA;EAmDC;EAjDD,MAAA;AAAA;;KAIW,gBAAA;;;;;;;;UASK,iBAAA;EAChB,KAAA,EAAO,gBAAA;EACP,IAAA;EACA,EAAA;AAAA;;;;;AA4ED;;;;;;;;;;UA3DiB,mBAAA;EAChB,IAAA;EAsH+B;EApH/B,SAAA;EACA,eAAA;EAmHuC;;;;;AAmExC;EA/KC,MAAA;AAAA;AAAA,UAGgB,eAAA;EAChB,KAAA;IACC,MAAA;IACA,QAAA;IACA,MAAA,WAsNW;IApNX,CAAA;IAiNkB;;;;;;IA1MlB,aAAA;IAoKK;;;;;;;IA5JL,MAAA,YAkKD;IAhKC,UAAA,GAAa,iBAAA,EAkKd;IAhKC,YAAA,GAAe,mBAAA,EAkKhB;IAhKC,YAAA,GAAe,mBAAA;EAAA;EAEhB,OAAA;IACC,KAAA;IACA,SAAA;EAAA;EA4KU;;;;;EArKX,cAAA;EACA,KAAA;EACA,MAAA;EAsLG;EApLH,MAAA;AAAA;AAAA,UAGgB,cAAA;EAChB,KAAA,EAAO,CAAA;EACP,UAAA;EAoLY;AAKb;;;;EAnLC,KAAA;AAAA;;;;;;;;;cAoDY,kBAAA,SAA2B,KAAA;cAC3B,MAAA;AAAA;AAAA,UAkEI,WAAA;EAChB,EAAA;EACA,IAAA;EACA,IAAA;EACA,MAAA;EACA,IAAA,EAAM,MAAA;EACN,QAAA;EACA,eAAA;EACA,MAAA,GAAS,aAAA;EACT,OAAA,GAAU,mBAAA;EACV,SAAA;EACA,SAAA;EACA,WAAA;EACA,WAAA;EACA,cAAA;EACA,eAAA;EACA,OAAA;EACA,MAAA;EACA,gBAAA;;EAEA,GAAA,GAAM,UAAA;;;;;;;;;;;EAWN,QAAA,GAAW,MAAA;;;;;;;;;;;;EAYX,UAAA,GAAa,MAAA;IAGX,QAAA,EAAU,KAAA;MACT,EAAA;MACA,IAAA;MACA,UAAA;MACA,KAAA;MACA,MAAA;MACA,gBAAA;MACA,SAAA;IAAA;IAED,UAAA;EAAA;AAAA;AAAA,cAKU,qBAAA,SAA8B,KAAA;EAGlC,OAAA;cADP,OAAA,UACO,OAAA;AAAA"}

package/dist/types-C-lrOt9T.d.mts

@@ -0,0 +1,87 @@
+//#region src/settings/types.d.ts
+/**
+ * Site Settings Types
+ *
+ * Global configuration for the site (title, logo, social links, etc.)
+ */
+/**
+ * Media reference for logo/favicon/seo.defaultOgImage.
+ *
+ * Stored shape is just `{ mediaId, alt? }`. The remaining fields are
+ * populated by `resolveMediaReference` on read so templates can emit
+ * correct head tags without a second round-trip to the media table.
+ *
+ * The Zod schemas at the REST/MCP boundary are split:
+ *  - `mediaReferenceInput` (used by `settingsUpdateBody`) defines only
+ *    `mediaId` and `alt`. Default strip-mode parsing discards any
+ *    resolved fields a client posts back, so they never reach storage.
+ *  - `mediaReferenceResponse` (used by `siteSettingsSchema`) includes
+ *    the resolved fields so generated OpenAPI clients see them.
+ *
+ * If you ever switch `mediaReferenceInput` to `passthrough`, you must
+ * also strip the resolved fields explicitly in `setSiteSettings`, or
+ * stored options will accumulate stale `url` / `contentType` / `width`
+ * / `height` snapshots.
+ */
+interface MediaReference {
+  mediaId: string;
+  alt?: string;
+  /** Resolved URL. Populated by `resolveMediaReference`; absent on raw stored values. */
+  url?: string;
+  /** Stored MIME type (e.g. `image/svg+xml`). Populated alongside `url`. */
+  contentType?: string;
+  /** Pixel width if known. Populated alongside `url`. */
+  width?: number;
+  /** Pixel height if known. Populated alongside `url`. */
+  height?: number;
+}
+/** Site-level SEO settings */
+interface SeoSettings {
+  /** Separator between page title and site title (e.g., " | ", " — ") */
+  titleSeparator?: string;
+  /** Default OG image when content has no seo_image */
+  defaultOgImage?: MediaReference;
+  /** Custom robots.txt content. If unset, a default is generated. */
+  robotsTxt?: string;
+  /** Add rules to robots.txt that ask AI crawlers not to use the site for training. */
+  disallowAiTraining?: boolean;
+  /** Google Search Console verification meta tag content */
+  googleVerification?: string;
+  /** Bing Webmaster Tools verification meta tag content */
+  bingVerification?: string;
+}
+/** Site settings schema */
+interface SiteSettings {
+  title: string;
+  tagline?: string;
+  logo?: MediaReference;
+  favicon?: MediaReference;
+  url?: string;
+  postsPerPage: number;
+  dateFormat: string;
+  timezone: string;
+  social?: {
+    twitter?: string;
+    github?: string;
+    facebook?: string;
+    instagram?: string;
+    linkedin?: string;
+    youtube?: string;
+  };
+  seo?: SeoSettings;
+}
+/** Partial SEO update. `null` removes the configured default image. */
+interface SeoSettingsUpdate extends Omit<SeoSettings, "defaultOgImage"> {
+  defaultOgImage?: MediaReference | null;
+}
+/** Site-settings write shape. `null` removes media references; omitted fields are unchanged. */
+interface SiteSettingsUpdate extends Omit<Partial<SiteSettings>, "logo" | "favicon" | "seo"> {
+  logo?: MediaReference | null;
+  favicon?: MediaReference | null;
+  seo?: SeoSettingsUpdate;
+}
+/** Keys that are valid site settings */
+type SiteSettingKey = keyof SiteSettings;
+//#endregion
+export { SiteSettings as a, SiteSettingKey as i, SeoSettings as n, SiteSettingsUpdate as o, SeoSettingsUpdate as r, MediaReference as t };
+//# sourceMappingURL=types-C-lrOt9T.d.mts.map

package/dist/types-C-lrOt9T.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-C-lrOt9T.d.mts","names":[],"sources":["../src/settings/types.ts"],"mappings":";;AAyBA;;;;;;;;;;;;AAcA;;;;;;;;;;;UAdiB,cAAA;EAChB,OAAA;EACA,GAAA;EA4B4B;EA1B5B,GAAA;EA8BO;EA5BP,WAAA;EAkDM;EAhDN,KAAA;EAgDiB;EA9CjB,MAAA;AAAA;;UAIgB,WAAA;EAqBhB;EAnBA,cAAA;EAsBA;EApBA,cAAA,GAAiB,cAAA;EAwBjB;EAtBA,SAAA;EA0BA;EAxBA,kBAAA;EA0BC;EAxBD,kBAAA;EA0BC;EAxBD,gBAAA;AAAA;;UAIgB,YAAA;EAEhB,KAAA;EACA,OAAA;EACA,IAAA,GAAO,cAAA;EACP,OAAA,GAAU,cAAA;EAGV,GAAA;EAGA,YAAA;EACA,UAAA;EACA,QAAA;EAGA,MAAA;IACC,OAAA;IACA,MAAA;IACA,QAAA;IACA,SAAA;IACA,QAAA;IACA,OAAA;EAAA;EAID,GAAA,GAAM,WAAA;AAAA;;UAIU,iBAAA,SAA0B,IAAA,CAAK,WAAA;EAC/C,cAAA,GAAiB,cAAA;AAAA;;UAID,kBAAA,SAA2B,IAAA,CAC3C,OAAA,CAAQ,YAAA;EAGR,IAAA,GAAO,cAAA;EACP,OAAA,GAAU,cAAA;EACV,GAAA,GAAM,iBAAA;AAAA;;KAIK,cAAA,SAAuB,YAAA"}