emdash 1.3.1 → 1.4.0

package/dist/types-CVXHwIBB.d.mts

@@ -0,0 +1,125 @@
+//#region src/object-cache/types.d.ts
+/**
+ * Object cache types
+ *
+ * The object cache is an optional, distributed read-through cache that sits
+ * *beneath* the per-request cache (`requestCached`) and *above* the database.
+ * Query results (content entries, settings, menus, taxonomies) are stored in a
+ * fast key/value store (Cloudflare KV, or an in-isolate memory store for Node)
+ * so repeat reads across requests and isolates skip the database entirely.
+ *
+ * Backends only ever deal in strings — serialization (including `Date`
+ * preservation) is handled by the core read-through layer in `./codec.ts`, so
+ * every backend behaves identically.
+ */
+/**
+ * A pluggable object-cache backend.
+ *
+ * Implementations must be safe to call concurrently and should never throw on
+ * cache misses — `get` returns `null` for a miss. A backend that throws (e.g.
+ * a transient KV error) degrades gracefully: the read-through layer treats a
+ * thrown `get` as a miss and a thrown `set` as a no-op, so the database
+ * remains the source of truth.
+ */
+interface ObjectCacheBackend {
+  /** Return the stored string for `key`, or `null` on a miss. */
+  get(key: string): Promise<string | null>;
+  /**
+   * Store `value` under `key`.
+   *
+   * @param ttlSeconds Optional time-to-live in seconds. Backends that don't
+   *   support TTLs may ignore it, but distributed backends (KV) should honor
+   *   it so orphaned, epoch-busted keys are eventually reclaimed.
+   */
+  set(key: string, value: string, ttlSeconds?: number): Promise<void>;
+  /** Remove `key`. Idempotent — deleting a missing key is not an error. */
+  delete(key: string): Promise<void>;
+}
+/**
+ * Serializable descriptor for an object-cache backend.
+ *
+ * Mirrors {@link import("../storage/types.js").StorageDescriptor}: `entrypoint`
+ * is a module specifier resolved at build time that exports a
+ * {@link CreateObjectCacheBackendFn} named `createObjectCache`; `config` is the
+ * plain, serializable runtime config passed to it.
+ */
+interface ObjectCacheDescriptor {
+  /** Module path exporting a `createObjectCache` function. */
+  entrypoint: string;
+  /** Serializable config passed to `createObjectCache` at runtime. */
+  config: ObjectCacheRuntimeConfig;
+}
+/**
+ * Runtime config shared by every backend, plus backend-specific keys.
+ *
+ * The read-through layer reads `defaultTtl`, `revalidate`, and `keyPrefix`;
+ * individual backends read their own keys (e.g. the KV backend reads
+ * `binding`).
+ */
+interface ObjectCacheRuntimeConfig {
+  /**
+   * Default time-to-live for cached entries, in seconds.
+   *
+   * Invalidation works by epoch comparison, not key deletion: a stale value
+   * is detected on read (its stored epoch no longer matches) and overwritten
+   * in place under the same key. The TTL is just a backstop that reclaims
+   * keys that are never read again.
+   *
+   * @default 3600 (1 hour)
+   */
+  defaultTtl?: number;
+  /**
+   * How long (milliseconds) an isolate may reuse a cached namespace epoch
+   * before re-reading it from the backend.
+   *
+   * After a write bumps a namespace's epoch, an isolate keeps serving the
+   * previous epoch's keys until its cached epoch expires after this window. It
+   * is only part of the cross-isolate staleness: a distributed backend adds its
+   * own propagation delay (KV's edge cache is eventually consistent, up to
+   * ~60s), so on KV the effective window is that propagation plus this value.
+   * Preview and edit requests bypass the cache. Renders that may fill Astro's
+   * route cache also bypass it, preventing an older KV snapshot from being
+   * stored as a fresh HTML response after a purge.
+   *
+   * Set to `0` to re-read the epoch on every query (strongest freshness, more
+   * backend reads).
+   *
+   * @default 1000
+   */
+  revalidate?: number;
+  /**
+   * Prefix applied to every cache key. Lets multiple EmDash sites share one
+   * KV namespace without colliding.
+   *
+   * @default "em"
+   */
+  keyPrefix?: string;
+  /**
+   * Maximum time (milliseconds) to wait for a single backend read before
+   * treating it as a cache miss and falling back to the database.
+   *
+   * Guards against a backend operation that stalls without resolving or
+   * rejecting (e.g. a cold cross-region KV read, or one queued behind the
+   * Workers simultaneous-connection limit), which would otherwise hang the
+   * request. A timed-out read degrades to a miss; the database remains the
+   * source of truth.
+   *
+   * Set to `0` to disable the timeout (not recommended on Cloudflare).
+   *
+   * @default 2000
+   */
+  timeout?: number;
+  /** Backend-specific keys (e.g. the KV binding name). */
+  [key: string]: unknown;
+}
+/**
+ * Factory signature exported as `createObjectCache` from a backend entrypoint.
+ *
+ * Each backend accesses its own resources directly: the KV backend imports
+ * bindings from `cloudflare:workers`; the memory backend uses an in-isolate
+ * map.
+ */
+type CreateObjectCacheBackendFn = (config: ObjectCacheRuntimeConfig) => ObjectCacheBackend;
+//#endregion
+export { ObjectCacheRuntimeConfig as i, ObjectCacheBackend as n, ObjectCacheDescriptor as r, CreateObjectCacheBackendFn as t };
+//# sourceMappingURL=types-CVXHwIBB.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-CVXHwIBB.d.mts","names":[],"sources":["../src/object-cache/types.ts"],"mappings":";;AAuBA;;;;;;;;;;;;;;;;;;;;;UAAiB,kBAAA;EAuBqB;EArBrC,GAAA,CAAI,GAAA,WAAc,OAAA;EAyBc;;;;;;AAUjC;EA3BC,GAAA,CAAI,GAAA,UAAa,KAAA,UAAe,UAAA,YAAsB,OAAA;;EAEtD,MAAA,CAAO,GAAA,WAAc,OAAA;AAAA;;;;;;;AAyFtB;;UA9EiB,qBAAA;EA8EgF;EA5EhG,UAAA;EA4EyC;EA1EzC,MAAA,EAAQ,wBAAA;AAAA;;;;;;;;UAUQ,wBAAA;;;;;;;;;;;EAWhB,UAAA;;;;;;;;;;;;;;;;;;;EAmBA,UAAA;;;;;;;EAOA,SAAA;;;;;;;;;;;;;;;EAeA,OAAA;;GAEC,GAAA;AAAA;;;;;;;;KAUU,0BAAA,IAA8B,MAAA,EAAQ,wBAAA,KAA6B,kBAAA"}

package/dist/types-C_asjp1J.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types-C_asjp1J.mjs","names":[],"sources":["../src/schema/types.ts"],"sourcesContent":["/**\n * Schema Registry Types\n *\n * These types represent the schema definitions stored in D1.\n * They are the source of truth for all collections and fields.\n */\n\nimport type { BlockType } from \"./block-types.js\";\n\n/**\n * Supported field types\n */\nexport type FieldType =\n\t| \"string\"\n\t| \"text\"\n\t| \"url\"\n\t| \"number\"\n\t| \"integer\"\n\t| \"boolean\"\n\t| \"datetime\"\n\t| \"select\"\n\t| \"multiSelect\"\n\t| \"portableText\"\n\t| \"image\"\n\t| \"file\"\n\t| \"reference\"\n\t| \"json\"\n\t| \"slug\"\n\t| \"repeater\"\n\t| \"blocks\";\n\n/**\n * Array of all field types for validation\n */\nexport const FIELD_TYPES: readonly FieldType[] = [\n\t\"string\",\n\t\"text\",\n\t\"url\",\n\t\"number\",\n\t\"integer\",\n\t\"boolean\",\n\t\"datetime\",\n\t\"select\",\n\t\"multiSelect\",\n\t\"portableText\",\n\t\"image\",\n\t\"file\",\n\t\"reference\",\n\t\"json\",\n\t\"slug\",\n\t\"repeater\",\n\t\"blocks\",\n] as const;\n\n/** Scalar field types that can be backed by a content-list query index. */\nexport const INDEXABLE_FIELD_TYPES: ReadonlySet<FieldType> = new Set([\n\t\"string\",\n\t\"url\",\n\t\"number\",\n\t\"integer\",\n\t\"boolean\",\n\t\"datetime\",\n\t\"select\",\n\t\"reference\",\n\t\"slug\",\n]);\n\nexport function isIndexableFieldType(type: FieldType): boolean {\n\treturn INDEXABLE_FIELD_TYPES.has(type);\n}\n\n/**\n * SQLite column types that map from field types\n */\nexport type ColumnType = \"TEXT\" | \"REAL\" | \"INTEGER\" | \"JSON\";\n\n/**\n * Map field types to their SQLite column types\n */\nexport const FIELD_TYPE_TO_COLUMN: Record<FieldType, ColumnType> = {\n\tstring: \"TEXT\",\n\ttext: \"TEXT\",\n\tnumber: \"REAL\",\n\tinteger: \"INTEGER\",\n\tboolean: \"INTEGER\",\n\tdatetime: \"TEXT\",\n\tselect: \"TEXT\",\n\tmultiSelect: \"JSON\",\n\tportableText: \"JSON\",\n\timage: \"TEXT\",\n\tfile: \"TEXT\",\n\treference: \"TEXT\",\n\tjson: \"JSON\",\n\tslug: \"TEXT\",\n\turl: \"TEXT\",\n\trepeater: \"JSON\",\n\tblocks: \"JSON\",\n};\n\nexport const MAX_BLOCKS_ITEMS = 100;\n\n/**\n * Field types that *can* persist no `ec_*` column — see `isStoragelessField`\n * for whether a given row actually does. The `FIELD_TYPE_TO_COLUMN` entry above\n * is retained deliberately: it doubles as the `isFieldType` guard.\n */\nexport const STORAGELESS_FIELD_TYPES: ReadonlySet<string> = new Set<FieldType>([\"reference\"]);\n\n/**\n * Whether a field row keeps its values outside the content table.\n *\n * Storage-less is a property of the row, not of the type. A `reference` field\n * is storage-less once it is bound to a relation: the selection lives as edges\n * in `_emdash_content_references`. A reference field created before relations\n * existed — or one whose target collection could not be resolved — still owns a\n * TEXT column holding an entry id, and behaves like a string field until\n * something wires it.\n */\nexport function isStoragelessField(field: {\n\ttype: string;\n\tvalidation?: FieldValidation | null;\n}): boolean {\n\tif (!STORAGELESS_FIELD_TYPES.has(field.type)) return false;\n\treturn typeof field.validation?.relation === \"string\" && field.validation.relation.length > 0;\n}\n\n/**\n * `isStoragelessField` for a raw `_emdash_fields` row, whose `validation` is\n * unparsed JSON. Malformed JSON reads as unwired: a field nothing can resolve a\n * relation for keeps its column.\n */\nexport function isStoragelessFieldRow(row: { type: string; validation: string | null }): boolean {\n\tif (!STORAGELESS_FIELD_TYPES.has(row.type) || !row.validation) return false;\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(row.validation);\n\t} catch {\n\t\treturn false;\n\t}\n\tif (typeof parsed !== \"object\" || parsed === null) return false;\n\treturn isStoragelessField({ type: row.type, validation: parsed });\n}\n\n/**\n * Features a collection can support\n */\nexport type CollectionSupport =\n\t| \"drafts\"\n\t| \"revisions\"\n\t| \"preview\"\n\t| \"scheduling\"\n\t| \"search\"\n\t| \"seo\";\n\n/**\n * Sources for how a collection was created\n */\nexport type CollectionSource =\n\t| `template:${string}`\n\t| `import:${string}`\n\t| \"manual\"\n\t| \"discovered\"\n\t| \"seed\";\n\n/**\n * Validation rules for a field\n */\n/** Sub-field definition for repeater fields */\nexport interface RepeaterSubField {\n\tslug: string;\n\ttype:\n\t\t| \"string\"\n\t\t| \"text\"\n\t\t| \"url\"\n\t\t| \"number\"\n\t\t| \"integer\"\n\t\t| \"boolean\"\n\t\t| \"datetime\"\n\t\t| \"select\"\n\t\t| \"image\";\n\tlabel: string;\n\trequired?: boolean;\n\toptions?: string[]; // For select sub-fields\n}\n\n/** Allowed types for repeater sub-fields (no nesting, no complex types) */\nexport const REPEATER_SUB_FIELD_TYPES = [\n\t\"string\",\n\t\"text\",\n\t\"url\",\n\t\"number\",\n\t\"integer\",\n\t\"boolean\",\n\t\"datetime\",\n\t\"select\",\n\t\"image\",\n] as const;\n\nexport interface FieldValidation {\n\trequired?: boolean;\n\tmin?: number;\n\tmax?: number;\n\tminLength?: number;\n\tmaxLength?: number;\n\tpattern?: string;\n\toptions?: string[]; // For select/multiSelect\n\tsubFields?: RepeaterSubField[]; // For repeater fields\n\tminItems?: number; // For repeater fields\n\tmaxItems?: number; // For repeater fields\n\tallowedMimeTypes?: string[];\n\t/** Reference fields: the relation's slug. */\n\trelation?: string;\n\t/**\n\t * Reference fields: which end of the relation this collection sits on.\n\t * `parent` picks children and controls their order; `child` picks parents\n\t * and is unordered, since `sort_order` is scoped to a parent.\n\t */\n\trelationSide?: \"parent\" | \"child\";\n\t/** Reference fields: the collection on the *other* end (derived from the\n\t * relation and the side, denormalized here). */\n\ttargetCollection?: string;\n\t/** Reference fields: allow selecting more than one entry (UI constraint). */\n\tmultiple?: boolean;\n\tallowedTypes?: string[]; // For blocks fields\n\tretiredTypes?: string[]; // Server-owned retained types for blocks fields\n}\n\n/**\n * Widget options for field rendering\n */\nexport interface FieldWidgetOptions {\n\trows?: number; // For textarea\n\tshowPreview?: boolean; // For image/file\n\tdarkVariant?: boolean; // For image: offer a second slot for a dark-color-scheme counterpart\n\tcollection?: string; // For reference - which collection to reference\n\tallowMultiple?: boolean; // For reference\n\t[key: string]: unknown;\n}\n\nexport interface UnsupportedFieldType {\n\ttype: string;\n\tpath: string;\n}\n\nexport const MAX_COLLECTION_LIST_COLUMNS = 4;\n\n/** Longest admin sidebar folder label a collection may declare. */\nexport const MAX_COLLECTION_GROUP_LENGTH = 100;\n\n/** Longest Phosphor icon name a collection may declare. */\nexport const MAX_COLLECTION_ICON_LENGTH = 64;\n\n/** Collection-level admin presentation options. */\nexport interface CollectionAdminConfig {\n\t/** Custom field slugs to show in the content list. */\n\tlistColumns?: string[];\n\t/** Show a \"new entry\" quick action on the dashboard. Defaults to true. */\n\tquickCreate?: boolean;\n}\n\n/**\n * A collection definition\n */\nexport interface Collection {\n\tid: string;\n\tslug: string;\n\tlabel: string;\n\tlabelSingular?: string;\n\tdescription?: string;\n\ticon?: string;\n\tadmin?: CollectionAdminConfig;\n\tsupports: CollectionSupport[];\n\tsource?: CollectionSource;\n\t/** Whether this collection has SEO metadata fields enabled */\n\thasSeo: boolean;\n\t/** Field slug powering the admin list Title column. Defaults to the standard title display. */\n\ttitleField?: string;\n\t/** Field slug powering the admin list Date column. Must be a `datetime` field. Defaults to last-updated. */\n\tdateField?: string;\n\t/** URL pattern with {slug} placeholder (e.g. \"/{slug}\", \"/blog/{slug}\") */\n\turlPattern?: string;\n\t/** Whether published entries require a public slug. Defaults to true. */\n\troutable?: boolean;\n\t/**\n\t * Omit this collection's auto-generated sidebar entry and dashboard quick\n\t * action. The collection stays fully functional everywhere else (API, MCP,\n\t * hooks, direct `/content/:collection` URLs), so a plugin that owns the\n\t * collection can point editors at its own admin UI.\n\t */\n\thidden: boolean;\n\t/**\n\t * Explicit position in the admin sidebar. Collections with a `sortOrder`\n\t * come first, in ascending order; the rest keep the alphabetical-by-slug\n\t * order and follow. `undefined` means \"no explicit position\".\n\t */\n\tsortOrder?: number;\n\t/**\n\t * Admin sidebar folder. Collections sharing a group render under one\n\t * collapsible entry labelled with the group; `undefined` keeps the\n\t * collection inline.\n\t */\n\tgroup?: string;\n\t/** Whether comments are enabled for this collection */\n\tcommentsEnabled: boolean;\n\t/** Moderation strategy: \"all\" | \"first_time\" | \"none\" */\n\tcommentsModeration: \"all\" | \"first_time\" | \"none\";\n\t/** Auto-close comments after N days. 0 = never close. */\n\tcommentsClosedAfterDays: number;\n\t/** Auto-approve comments from authenticated CMS users */\n\tcommentsAutoApproveUsers: boolean;\n\t/** Whether opening an entry takes an edit lock. Defaults to true. */\n\teditLocking: boolean;\n\tcreatedAt: string;\n\tupdatedAt: string;\n}\n\n/**\n * A field definition\n */\nexport interface Field {\n\tid: string;\n\tcollectionId: string;\n\tslug: string;\n\tlabel: string;\n\ttype: FieldType;\n\t/** Raw stored type metadata that this runtime cannot safely interpret. */\n\tunsupportedType?: UnsupportedFieldType;\n\tblockTypes?: BlockType[];\n\tblockTypeFingerprint?: string;\n\tcolumnType: ColumnType;\n\trequired: boolean;\n\tunique: boolean;\n\tdefaultValue?: unknown;\n\tvalidation?: FieldValidation;\n\twidget?: string;\n\toptions?: FieldWidgetOptions;\n\tsortOrder: number;\n\tsearchable: boolean;\n\t/** Whether this field has a physical index for structured list queries. */\n\tindexed: boolean;\n\t/** Whether this field is translatable (default true). Non-translatable fields are synced across locales. */\n\ttranslatable: boolean;\n\tcreatedAt: string;\n}\n\n/**\n * Input for creating a collection\n */\nexport interface CreateCollectionInput {\n\tslug: string;\n\tlabel: string;\n\tlabelSingular?: string;\n\tdescription?: string;\n\ticon?: string;\n\tadmin?: CollectionAdminConfig;\n\tsupports?: CollectionSupport[];\n\tsource?: CollectionSource;\n\turlPattern?: string;\n\troutable?: boolean;\n\thasSeo?: boolean;\n\t/** Omit the auto-generated sidebar entry and dashboard quick action (defaults to false) */\n\thidden?: boolean;\n\t/** Explicit admin sidebar position (omit for the alphabetical fallback) */\n\tsortOrder?: number | null;\n\t/** Admin sidebar folder shared with other collections of the same group */\n\tgroup?: string | null;\n\tcommentsEnabled?: boolean;\n\t/** Take an edit lock when an entry is opened (defaults to true) */\n\teditLocking?: boolean;\n}\n\n/**\n * Input for updating a collection\n */\nexport interface UpdateCollectionInput {\n\tlabel?: string;\n\tlabelSingular?: string;\n\tdescription?: string;\n\ticon?: string;\n\tadmin?: CollectionAdminConfig;\n\tsupports?: CollectionSupport[];\n\turlPattern?: string | null;\n\troutable?: boolean;\n\thasSeo?: boolean;\n\t/** Omit the auto-generated sidebar entry and dashboard quick action */\n\thidden?: boolean;\n\t/** Explicit admin sidebar position; `null` clears it back to alphabetical */\n\tsortOrder?: number | null;\n\t/** Admin sidebar folder; `null` moves the collection back inline */\n\tgroup?: string | null;\n\tcommentsEnabled?: boolean;\n\tcommentsModeration?: \"all\" | \"first_time\" | \"none\";\n\tcommentsClosedAfterDays?: number;\n\tcommentsAutoApproveUsers?: boolean;\n\t/** Take an edit lock when an entry is opened */\n\teditLocking?: boolean;\n\t/** Field slug for the Title column; `null`/`\"\"` clears back to the default. */\n\ttitleField?: string | null;\n\t/** Datetime field slug for the Date column; `null`/`\"\"` clears back to the default. */\n\tdateField?: string | null;\n}\n\n/**\n * Input for creating a field\n */\nexport interface CreateFieldInput {\n\tslug: string;\n\tlabel: string;\n\ttype: FieldType;\n\trequired?: boolean;\n\tunique?: boolean;\n\tdefaultValue?: unknown;\n\tvalidation?: FieldValidation | null;\n\twidget?: string;\n\toptions?: FieldWidgetOptions;\n\tsortOrder?: number;\n\t/** Whether this field should be indexed for search */\n\tsearchable?: boolean;\n\t/** Create a physical index for structured sorting. */\n\tindexed?: boolean;\n\t/** Whether this field is translatable (default true). Non-translatable fields are synced across locales. */\n\ttranslatable?: boolean;\n}\n\n/**\n * Input for updating a field\n */\nexport interface UpdateFieldInput {\n\tlabel?: string;\n\t/**\n\t * Change the field's type. Only storage-compatible text aliases (`string`,\n\t * `text`, and `slug`) can be changed in place. Other changes require an\n\t * explicit content migration. Omit to keep the current type.\n\t */\n\ttype?: FieldType;\n\trequired?: boolean;\n\tunique?: boolean;\n\tdefaultValue?: unknown;\n\tvalidation?: FieldValidation | null;\n\twidget?: string;\n\toptions?: FieldWidgetOptions;\n\tsortOrder?: number;\n\t/** Whether this field should be indexed for search */\n\tsearchable?: boolean;\n\t/** Create or remove the physical index used by structured sorting. */\n\tindexed?: boolean;\n\t/** Whether this field is translatable (default true). Non-translatable fields are synced across locales. */\n\ttranslatable?: boolean;\n}\n\n/**\n * A collection with its fields\n */\nexport interface CollectionWithFields extends Collection {\n\tfields: Field[];\n}\n\n/**\n * Reserved field slugs that cannot be used.\n *\n * Includes names reserved for runtime hydration (`terms`, `bylines`, `byline`)\n * so user-defined fields never shadow the auto-hydrated values on entry.data.\n */\nexport const RESERVED_FIELD_SLUGS = [\n\t\"id\",\n\t\"slug\",\n\t\"status\",\n\t\"author_id\",\n\t\"primary_byline_id\",\n\t\"created_at\",\n\t\"updated_at\",\n\t\"published_at\",\n\t\"scheduled_at\",\n\t\"deleted_at\",\n\t\"version\",\n\t\"live_revision_id\",\n\t\"draft_revision_id\",\n\t// Runtime-hydrated fields\n\t\"terms\",\n\t\"bylines\",\n\t\"byline\",\n];\n\n/**\n * Reserved collection slugs that cannot be used\n */\nexport const RESERVED_COLLECTION_SLUGS = [\n\t\"content\",\n\t\"media\",\n\t\"users\",\n\t\"revisions\",\n\t\"taxonomies\",\n\t\"options\",\n\t\"audit_logs\",\n\t// Shadowed by the static POST /schema/collections/reorder route: a\n\t// collection with this slug could never be addressed at its own URL.\n\t\"reorder\",\n\t// Shadowed by the static /content-types/relations admin route, for the same\n\t// reason: a collection with this slug would be unreachable in the admin.\n\t\"relations\",\n];\n\n/**\n * Byline custom fields (Discussion #1174).\n *\n * Sites declare site-specific byline metadata (`job_title`, `pronouns`,\n * `twitter_handle`, `company`, …) without touching emdash core. Definitions\n * live in `_emdash_byline_fields`; values in either\n * `_emdash_byline_field_values` (translatable, keyed by `byline_id`) or\n * `_emdash_byline_field_group_values` (non-translatable, keyed by\n * `translation_group`). The per-field `translatable` flag decides which\n * value table is used. See migration 041.\n */\n\n/**\n * The five v1 field types supported on byline custom fields. Deliberately\n * narrower than the content `FieldType` union — bylines don't need\n * `portableText`, `reference`, `image`, etc. v2 may extend this; v1 keeps\n * the storage and UI surfaces small.\n */\nexport type BylineFieldType = \"string\" | \"text\" | \"url\" | \"boolean\" | \"select\";\n\nexport const BYLINE_FIELD_TYPES: readonly BylineFieldType[] = [\n\t\"string\",\n\t\"text\",\n\t\"url\",\n\t\"boolean\",\n\t\"select\",\n] as const;\n\n/**\n * Validation rules for a byline custom field. v1 only exposes `options`\n * (the choice list for `select` fields). The shape mirrors the content-\n * field convention so the admin UI patterns transfer.\n */\nexport interface BylineFieldValidation {\n\t/** Choices for `select`-type fields. Ignored for other types. */\n\toptions?: string[];\n}\n\n/**\n * Runtime shape of a registered byline custom field. Stored in\n * `_emdash_byline_fields` (see migration 041).\n */\nexport interface BylineFieldDefinition {\n\tid: string;\n\tslug: string;\n\tlabel: string;\n\ttype: BylineFieldType;\n\trequired: boolean;\n\t/**\n\t * Whether values are stored per-locale (`true`, in\n\t * `_emdash_byline_field_values` keyed by `byline_id`) or shared across\n\t * every locale variant of the same byline identity (`false`, in\n\t * `_emdash_byline_field_group_values` keyed by `translation_group`).\n\t * Defaults to `true` at the DB level.\n\t */\n\ttranslatable: boolean;\n\tvalidation: BylineFieldValidation | null;\n\tsortOrder: number;\n\tcreatedAt: string;\n\tupdatedAt: string;\n}\n\n/**\n * Input for creating a byline custom field. `slug` and `type` are not\n * updatable post-create — changing either would invalidate stored values.\n */\nexport interface CreateBylineFieldInput {\n\tslug: string;\n\tlabel: string;\n\ttype: BylineFieldType;\n\trequired?: boolean;\n\ttranslatable?: boolean;\n\tvalidation?: BylineFieldValidation | null;\n\tsortOrder?: number;\n}\n\n/**\n * Input for updating a byline custom field. `slug` and `type` are\n * intentionally not present — see `CreateBylineFieldInput`.\n */\nexport interface UpdateBylineFieldInput {\n\tlabel?: string;\n\trequired?: boolean;\n\ttranslatable?: boolean;\n\tvalidation?: BylineFieldValidation | null;\n\tsortOrder?: number;\n}\n\n/**\n * Runtime value type for a byline custom field. The narrow union mirrors\n * what the five v1 field types can produce: `string`/`text`/`url`/`select`\n * → string, `boolean` → boolean, plus `null` for cleared values.\n */\nexport type CustomFieldValue = string | boolean | null;\n\n/**\n * Reserved byline-field slugs. Two reasons a slug ends up here:\n *\n * 1. **Column collision.** Slugs that match a fixed column on\n *    `_emdash_bylines` (migrations 031 + 040) would shadow that column\n *    on hydration. The first 12 entries cover this.\n * 2. **Route collision.** Static file routes under\n *    `/_emdash/api/admin/byline-fields/` take precedence over the\n *    `[slug].ts` dynamic route in Astro, so a custom field whose slug\n *    matches a sibling static file (e.g. `reorder.ts`) is unreachable\n *    via single-field CRUD — the static route handles only its own\n *    method (POST for `reorder`) and 405s everything else.\n *    `reorder` is the only such sibling today; new sibling routes\n *    (e.g. a hypothetical `import.ts`) must be added here.\n *    `[slug]/usage.ts` lives a level deeper so a slug of `usage` does\n *    not collide — it resolves cleanly to `[slug].ts`.\n *\n * Enforced at the registry layer (Phase 2) and the admin API zod layer\n * (Phase 4) so non-HTTP callers (seeds, scripts) get the same guarantee.\n */\nexport const RESERVED_BYLINE_FIELD_SLUGS = [\n\t// 1. Column-collision slugs (matches `_emdash_bylines` fixed columns).\n\t\"id\",\n\t\"slug\",\n\t\"display_name\",\n\t\"bio\",\n\t\"avatar_media_id\",\n\t\"website_url\",\n\t\"user_id\",\n\t\"is_guest\",\n\t\"locale\",\n\t\"translation_group\",\n\t\"created_at\",\n\t\"updated_at\",\n\t// 2. Route-collision slugs (matches static sibling files of `[slug].ts`).\n\t\"reorder\",\n] as const;\n"],"mappings":";;;;AAkCA,MAAa,cAAoC;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;AAGD,MAAa,wBAAgD,IAAI,IAAI;CACpE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAC;AAEF,SAAgB,qBAAqB,MAA0B;AAC9D,QAAO,sBAAsB,IAAI,KAAK;;;;;AAWvC,MAAa,uBAAsD;CAClE,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,SAAS;CACT,SAAS;CACT,UAAU;CACV,QAAQ;CACR,aAAa;CACb,cAAc;CACd,OAAO;CACP,MAAM;CACN,WAAW;CACX,MAAM;CACN,MAAM;CACN,KAAK;CACL,UAAU;CACV,QAAQ;CACR;AAED,MAAa,mBAAmB;;;;;;AAOhC,MAAa,0BAA+C,IAAI,IAAe,CAAC,YAAY,CAAC;;;;;;;;;;;AAY7F,SAAgB,mBAAmB,OAGvB;AACX,KAAI,CAAC,wBAAwB,IAAI,MAAM,KAAK,CAAE,QAAO;AACrD,QAAO,OAAO,MAAM,YAAY,aAAa,YAAY,MAAM,WAAW,SAAS,SAAS;;;;;;;AAQ7F,SAAgB,sBAAsB,KAA2D;AAChG,KAAI,CAAC,wBAAwB,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,WAAY,QAAO;CACtE,IAAI;AACJ,KAAI;AACH,WAAS,KAAK,MAAM,IAAI,WAAW;SAC5B;AACP,SAAO;;AAER,KAAI,OAAO,WAAW,YAAY,WAAW,KAAM,QAAO;AAC1D,QAAO,mBAAmB;EAAE,MAAM,IAAI;EAAM,YAAY;EAAQ,CAAC;;;AA8ClE,MAAa,2BAA2B;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AAgDD,MAAa,8BAA8B;;AAG3C,MAAa,8BAA8B;;AAG3C,MAAa,6BAA6B;;;;;;;AAqN1C,MAAa,uBAAuB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;;;;AAKD,MAAa,4BAA4B;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CAGA;CACA;AAsBD,MAAa,qBAAiD;CAC7D;CACA;CACA;CACA;CACA;CACA;;;;;;;;;;;;;;;;;;;;;AAyFD,MAAa,8BAA8B;CAE1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA"}
+{"version":3,"file":"types-C_asjp1J.mjs","names":[],"sources":["../src/schema/types.ts"],"sourcesContent":["/**\n * Schema Registry Types\n *\n * These types represent the schema definitions stored in D1.\n * They are the source of truth for all collections and fields.\n */\n\nimport type { BlockType } from \"./block-types.js\";\n\n/**\n * Supported field types\n */\nexport type FieldType =\n\t| \"string\"\n\t| \"text\"\n\t| \"url\"\n\t| \"number\"\n\t| \"integer\"\n\t| \"boolean\"\n\t| \"datetime\"\n\t| \"select\"\n\t| \"multiSelect\"\n\t| \"portableText\"\n\t| \"image\"\n\t| \"file\"\n\t| \"reference\"\n\t| \"json\"\n\t| \"slug\"\n\t| \"repeater\"\n\t| \"blocks\";\n\n/**\n * Array of all field types for validation\n */\nexport const FIELD_TYPES: readonly FieldType[] = [\n\t\"string\",\n\t\"text\",\n\t\"url\",\n\t\"number\",\n\t\"integer\",\n\t\"boolean\",\n\t\"datetime\",\n\t\"select\",\n\t\"multiSelect\",\n\t\"portableText\",\n\t\"image\",\n\t\"file\",\n\t\"reference\",\n\t\"json\",\n\t\"slug\",\n\t\"repeater\",\n\t\"blocks\",\n] as const;\n\n/** Scalar field types that can be backed by a content-list query index. */\nexport const INDEXABLE_FIELD_TYPES: ReadonlySet<FieldType> = new Set([\n\t\"string\",\n\t\"url\",\n\t\"number\",\n\t\"integer\",\n\t\"boolean\",\n\t\"datetime\",\n\t\"select\",\n\t\"reference\",\n\t\"slug\",\n]);\n\nexport function isIndexableFieldType(type: FieldType): boolean {\n\treturn INDEXABLE_FIELD_TYPES.has(type);\n}\n\n/**\n * SQLite column types that map from field types\n */\nexport type ColumnType = \"TEXT\" | \"REAL\" | \"INTEGER\" | \"JSON\";\n\n/**\n * Map field types to their SQLite column types\n */\nexport const FIELD_TYPE_TO_COLUMN: Record<FieldType, ColumnType> = {\n\tstring: \"TEXT\",\n\ttext: \"TEXT\",\n\tnumber: \"REAL\",\n\tinteger: \"INTEGER\",\n\tboolean: \"INTEGER\",\n\tdatetime: \"TEXT\",\n\tselect: \"TEXT\",\n\tmultiSelect: \"JSON\",\n\tportableText: \"JSON\",\n\timage: \"TEXT\",\n\tfile: \"TEXT\",\n\treference: \"TEXT\",\n\tjson: \"JSON\",\n\tslug: \"TEXT\",\n\turl: \"TEXT\",\n\trepeater: \"JSON\",\n\tblocks: \"JSON\",\n};\n\nexport const MAX_BLOCKS_ITEMS = 100;\n\n/**\n * Field types that *can* persist no `ec_*` column — see `isStoragelessField`\n * for whether a given row actually does. The `FIELD_TYPE_TO_COLUMN` entry above\n * is retained deliberately: it doubles as the `isFieldType` guard.\n */\nexport const STORAGELESS_FIELD_TYPES: ReadonlySet<string> = new Set<FieldType>([\"reference\"]);\n\n/**\n * Whether a field row keeps its values outside the content table.\n *\n * Storage-less is a property of the row, not of the type. A `reference` field\n * is storage-less once it is bound to a relation: the selection lives as edges\n * in `_emdash_content_references`. A reference field created before relations\n * existed — or one whose target collection could not be resolved — still owns a\n * TEXT column holding an entry id, and behaves like a string field until\n * something wires it.\n */\nexport function isStoragelessField(field: {\n\ttype: string;\n\tvalidation?: FieldValidation | null;\n}): boolean {\n\tif (!STORAGELESS_FIELD_TYPES.has(field.type)) return false;\n\treturn typeof field.validation?.relation === \"string\" && field.validation.relation.length > 0;\n}\n\n/**\n * `isStoragelessField` for a raw `_emdash_fields` row, whose `validation` is\n * unparsed JSON. Malformed JSON reads as unwired: a field nothing can resolve a\n * relation for keeps its column.\n */\nexport function isStoragelessFieldRow(row: { type: string; validation: string | null }): boolean {\n\tif (!STORAGELESS_FIELD_TYPES.has(row.type) || !row.validation) return false;\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(row.validation);\n\t} catch {\n\t\treturn false;\n\t}\n\tif (typeof parsed !== \"object\" || parsed === null) return false;\n\treturn isStoragelessField({ type: row.type, validation: parsed });\n}\n\n/**\n * Features a collection can support\n */\nexport type CollectionSupport =\n\t| \"drafts\"\n\t| \"revisions\"\n\t| \"preview\"\n\t| \"scheduling\"\n\t| \"search\"\n\t| \"seo\";\n\n/**\n * Sources for how a collection was created\n */\nexport type CollectionSource =\n\t| `template:${string}`\n\t| `import:${string}`\n\t| \"manual\"\n\t| \"discovered\"\n\t| \"seed\";\n\n/**\n * Validation rules for a field\n */\n/** Sub-field definition for repeater fields */\nexport interface RepeaterSubField {\n\tslug: string;\n\ttype:\n\t\t| \"string\"\n\t\t| \"text\"\n\t\t| \"url\"\n\t\t| \"number\"\n\t\t| \"integer\"\n\t\t| \"boolean\"\n\t\t| \"datetime\"\n\t\t| \"select\"\n\t\t| \"image\";\n\tlabel: string;\n\trequired?: boolean;\n\toptions?: string[]; // For select sub-fields\n}\n\n/** Allowed types for repeater sub-fields (no nesting, no complex types) */\nexport const REPEATER_SUB_FIELD_TYPES = [\n\t\"string\",\n\t\"text\",\n\t\"url\",\n\t\"number\",\n\t\"integer\",\n\t\"boolean\",\n\t\"datetime\",\n\t\"select\",\n\t\"image\",\n] as const;\n\nexport interface FieldValidation {\n\trequired?: boolean;\n\tmin?: number;\n\tmax?: number;\n\tminLength?: number;\n\tmaxLength?: number;\n\tpattern?: string;\n\toptions?: string[]; // For select/multiSelect\n\tsubFields?: RepeaterSubField[]; // For repeater fields\n\tminItems?: number; // For repeater fields\n\tmaxItems?: number; // For repeater fields\n\tallowedMimeTypes?: string[];\n\t/** Reference fields: the relation's slug. */\n\trelation?: string;\n\t/**\n\t * Reference fields: which end of the relation this collection sits on.\n\t * `parent` picks children and controls their order; `child` picks parents\n\t * and is unordered, since `sort_order` is scoped to a parent.\n\t */\n\trelationSide?: \"parent\" | \"child\";\n\t/** Reference fields: the collection on the *other* end (derived from the\n\t * relation and the side, denormalized here). */\n\ttargetCollection?: string;\n\t/** Reference fields: allow selecting more than one entry (UI constraint). */\n\tmultiple?: boolean;\n\tallowedTypes?: string[]; // For blocks fields\n\tretiredTypes?: string[]; // Server-owned retained types for blocks fields\n}\n\n/**\n * Widget options for field rendering\n */\nexport interface FieldWidgetOptions {\n\trows?: number; // For textarea\n\tshowPreview?: boolean; // For image/file\n\tdarkVariant?: boolean; // For image: offer a second slot for a dark-color-scheme counterpart\n\tcollection?: string; // For reference - which collection to reference\n\tallowMultiple?: boolean; // For reference\n\t[key: string]: unknown;\n}\n\nexport interface UnsupportedFieldType {\n\ttype: string;\n\tpath: string;\n}\n\nexport const MAX_COLLECTION_LIST_COLUMNS = 4;\n\n/** Longest admin sidebar folder label a collection may declare. */\nexport const MAX_COLLECTION_GROUP_LENGTH = 100;\n\n/** Longest Phosphor icon name a collection may declare. */\nexport const MAX_COLLECTION_ICON_LENGTH = 64;\n\n/** Collection-level admin presentation options. */\nexport interface CollectionAdminConfig {\n\t/** Custom field slugs to show in the content list. */\n\tlistColumns?: string[];\n\t/** Show a \"new entry\" quick action on the dashboard. Defaults to true. */\n\tquickCreate?: boolean;\n}\n\n/**\n * A collection definition\n */\nexport interface Collection {\n\tid: string;\n\tslug: string;\n\tlabel: string;\n\tlabelSingular?: string;\n\tdescription?: string;\n\ticon?: string;\n\tadmin?: CollectionAdminConfig;\n\tsupports: CollectionSupport[];\n\tsource?: CollectionSource;\n\t/** Whether this collection has SEO metadata fields enabled */\n\thasSeo: boolean;\n\t/** Field slug powering the admin list Title column. Defaults to the standard title display. */\n\ttitleField?: string;\n\t/** Field slug powering the admin list Date column. Must be a `datetime` field. Defaults to last-updated. */\n\tdateField?: string;\n\t/** URL pattern with {slug} placeholder (e.g. \"/{slug}\", \"/blog/{slug}\") */\n\turlPattern?: string;\n\t/** Whether published entries require a public slug. Defaults to true. */\n\troutable?: boolean;\n\t/**\n\t * Omit this collection's auto-generated sidebar entry, dashboard quick\n\t * action, and dashboard Content card row. The collection stays fully\n\t * functional everywhere else (API, MCP, hooks, direct `/content/:collection`\n\t * URLs), so a plugin that owns the collection can point editors at its own\n\t * admin UI.\n\t */\n\thidden: boolean;\n\t/**\n\t * Explicit position in the admin sidebar. Collections with a `sortOrder`\n\t * come first, in ascending order; the rest keep the alphabetical-by-slug\n\t * order and follow. `undefined` means \"no explicit position\".\n\t */\n\tsortOrder?: number;\n\t/**\n\t * Admin sidebar folder. Collections sharing a group render under one\n\t * collapsible entry labelled with the group; `undefined` keeps the\n\t * collection inline.\n\t */\n\tgroup?: string;\n\t/** Whether comments are enabled for this collection */\n\tcommentsEnabled: boolean;\n\t/** Moderation strategy: \"all\" | \"first_time\" | \"none\" */\n\tcommentsModeration: \"all\" | \"first_time\" | \"none\";\n\t/** Auto-close comments after N days. 0 = never close. */\n\tcommentsClosedAfterDays: number;\n\t/** Auto-approve comments from authenticated CMS users */\n\tcommentsAutoApproveUsers: boolean;\n\t/** Whether opening an entry takes an edit lock. Defaults to true. */\n\teditLocking: boolean;\n\tcreatedAt: string;\n\tupdatedAt: string;\n}\n\n/**\n * A field definition\n */\nexport interface Field {\n\tid: string;\n\tcollectionId: string;\n\tslug: string;\n\tlabel: string;\n\ttype: FieldType;\n\t/** Raw stored type metadata that this runtime cannot safely interpret. */\n\tunsupportedType?: UnsupportedFieldType;\n\tblockTypes?: BlockType[];\n\tblockTypeFingerprint?: string;\n\tcolumnType: ColumnType;\n\trequired: boolean;\n\tunique: boolean;\n\tdefaultValue?: unknown;\n\tvalidation?: FieldValidation;\n\twidget?: string;\n\toptions?: FieldWidgetOptions;\n\tsortOrder: number;\n\tsearchable: boolean;\n\t/** Whether this field has a physical index for structured list queries. */\n\tindexed: boolean;\n\t/** Whether this field is translatable (default true). Non-translatable fields are synced across locales. */\n\ttranslatable: boolean;\n\tcreatedAt: string;\n}\n\n/**\n * Input for creating a collection\n */\nexport interface CreateCollectionInput {\n\tslug: string;\n\tlabel: string;\n\tlabelSingular?: string;\n\tdescription?: string;\n\ticon?: string;\n\tadmin?: CollectionAdminConfig;\n\tsupports?: CollectionSupport[];\n\tsource?: CollectionSource;\n\turlPattern?: string;\n\troutable?: boolean;\n\thasSeo?: boolean;\n\t/** Omit the auto-generated sidebar entry, dashboard quick action, and dashboard Content card row (defaults to false) */\n\thidden?: boolean;\n\t/** Explicit admin sidebar position (omit for the alphabetical fallback) */\n\tsortOrder?: number | null;\n\t/** Admin sidebar folder shared with other collections of the same group */\n\tgroup?: string | null;\n\tcommentsEnabled?: boolean;\n\t/** Take an edit lock when an entry is opened (defaults to true) */\n\teditLocking?: boolean;\n}\n\n/**\n * Input for updating a collection\n */\nexport interface UpdateCollectionInput {\n\tlabel?: string;\n\tlabelSingular?: string;\n\tdescription?: string;\n\ticon?: string;\n\tadmin?: CollectionAdminConfig;\n\tsupports?: CollectionSupport[];\n\turlPattern?: string | null;\n\troutable?: boolean;\n\thasSeo?: boolean;\n\t/** Omit the auto-generated sidebar entry, dashboard quick action, and dashboard Content card row */\n\thidden?: boolean;\n\t/** Explicit admin sidebar position; `null` clears it back to alphabetical */\n\tsortOrder?: number | null;\n\t/** Admin sidebar folder; `null` moves the collection back inline */\n\tgroup?: string | null;\n\tcommentsEnabled?: boolean;\n\tcommentsModeration?: \"all\" | \"first_time\" | \"none\";\n\tcommentsClosedAfterDays?: number;\n\tcommentsAutoApproveUsers?: boolean;\n\t/** Take an edit lock when an entry is opened */\n\teditLocking?: boolean;\n\t/** Field slug for the Title column; `null`/`\"\"` clears back to the default. */\n\ttitleField?: string | null;\n\t/** Datetime field slug for the Date column; `null`/`\"\"` clears back to the default. */\n\tdateField?: string | null;\n}\n\n/**\n * Input for creating a field\n */\nexport interface CreateFieldInput {\n\tslug: string;\n\tlabel: string;\n\ttype: FieldType;\n\trequired?: boolean;\n\tunique?: boolean;\n\tdefaultValue?: unknown;\n\tvalidation?: FieldValidation | null;\n\twidget?: string;\n\toptions?: FieldWidgetOptions;\n\tsortOrder?: number;\n\t/** Whether this field should be indexed for search */\n\tsearchable?: boolean;\n\t/** Create a physical index for structured sorting. */\n\tindexed?: boolean;\n\t/** Whether this field is translatable (default true). Non-translatable fields are synced across locales. */\n\ttranslatable?: boolean;\n}\n\n/**\n * Input for updating a field\n */\nexport interface UpdateFieldInput {\n\tlabel?: string;\n\t/**\n\t * Change the field's type. Only storage-compatible text aliases (`string`,\n\t * `text`, and `slug`) can be changed in place. Other changes require an\n\t * explicit content migration. Omit to keep the current type.\n\t */\n\ttype?: FieldType;\n\trequired?: boolean;\n\tunique?: boolean;\n\tdefaultValue?: unknown;\n\tvalidation?: FieldValidation | null;\n\twidget?: string;\n\toptions?: FieldWidgetOptions;\n\tsortOrder?: number;\n\t/** Whether this field should be indexed for search */\n\tsearchable?: boolean;\n\t/** Create or remove the physical index used by structured sorting. */\n\tindexed?: boolean;\n\t/** Whether this field is translatable (default true). Non-translatable fields are synced across locales. */\n\ttranslatable?: boolean;\n}\n\n/**\n * A collection with its fields\n */\nexport interface CollectionWithFields extends Collection {\n\tfields: Field[];\n}\n\n/**\n * Reserved field slugs that cannot be used.\n *\n * Includes names reserved for runtime hydration (`terms`, `bylines`, `byline`)\n * so user-defined fields never shadow the auto-hydrated values on entry.data.\n */\nexport const RESERVED_FIELD_SLUGS = [\n\t\"id\",\n\t\"slug\",\n\t\"status\",\n\t\"author_id\",\n\t\"primary_byline_id\",\n\t\"created_at\",\n\t\"updated_at\",\n\t\"published_at\",\n\t\"scheduled_at\",\n\t\"deleted_at\",\n\t\"version\",\n\t\"live_revision_id\",\n\t\"draft_revision_id\",\n\t// Runtime-hydrated fields\n\t\"terms\",\n\t\"bylines\",\n\t\"byline\",\n];\n\n/**\n * Reserved collection slugs that cannot be used\n */\nexport const RESERVED_COLLECTION_SLUGS = [\n\t\"content\",\n\t\"media\",\n\t\"users\",\n\t\"revisions\",\n\t\"taxonomies\",\n\t\"options\",\n\t\"audit_logs\",\n\t// Shadowed by the static POST /schema/collections/reorder route: a\n\t// collection with this slug could never be addressed at its own URL.\n\t\"reorder\",\n\t// Shadowed by the static /content-types/relations admin route, for the same\n\t// reason: a collection with this slug would be unreachable in the admin.\n\t\"relations\",\n];\n\n/**\n * Byline custom fields (Discussion #1174).\n *\n * Sites declare site-specific byline metadata (`job_title`, `pronouns`,\n * `twitter_handle`, `company`, …) without touching emdash core. Definitions\n * live in `_emdash_byline_fields`; values in either\n * `_emdash_byline_field_values` (translatable, keyed by `byline_id`) or\n * `_emdash_byline_field_group_values` (non-translatable, keyed by\n * `translation_group`). The per-field `translatable` flag decides which\n * value table is used. See migration 041.\n */\n\n/**\n * The five v1 field types supported on byline custom fields. Deliberately\n * narrower than the content `FieldType` union — bylines don't need\n * `portableText`, `reference`, `image`, etc. v2 may extend this; v1 keeps\n * the storage and UI surfaces small.\n */\nexport type BylineFieldType = \"string\" | \"text\" | \"url\" | \"boolean\" | \"select\";\n\nexport const BYLINE_FIELD_TYPES: readonly BylineFieldType[] = [\n\t\"string\",\n\t\"text\",\n\t\"url\",\n\t\"boolean\",\n\t\"select\",\n] as const;\n\n/**\n * Validation rules for a byline custom field. v1 only exposes `options`\n * (the choice list for `select` fields). The shape mirrors the content-\n * field convention so the admin UI patterns transfer.\n */\nexport interface BylineFieldValidation {\n\t/** Choices for `select`-type fields. Ignored for other types. */\n\toptions?: string[];\n}\n\n/**\n * Runtime shape of a registered byline custom field. Stored in\n * `_emdash_byline_fields` (see migration 041).\n */\nexport interface BylineFieldDefinition {\n\tid: string;\n\tslug: string;\n\tlabel: string;\n\ttype: BylineFieldType;\n\trequired: boolean;\n\t/**\n\t * Whether values are stored per-locale (`true`, in\n\t * `_emdash_byline_field_values` keyed by `byline_id`) or shared across\n\t * every locale variant of the same byline identity (`false`, in\n\t * `_emdash_byline_field_group_values` keyed by `translation_group`).\n\t * Defaults to `true` at the DB level.\n\t */\n\ttranslatable: boolean;\n\tvalidation: BylineFieldValidation | null;\n\tsortOrder: number;\n\tcreatedAt: string;\n\tupdatedAt: string;\n}\n\n/**\n * Input for creating a byline custom field. `slug` and `type` are not\n * updatable post-create — changing either would invalidate stored values.\n */\nexport interface CreateBylineFieldInput {\n\tslug: string;\n\tlabel: string;\n\ttype: BylineFieldType;\n\trequired?: boolean;\n\ttranslatable?: boolean;\n\tvalidation?: BylineFieldValidation | null;\n\tsortOrder?: number;\n}\n\n/**\n * Input for updating a byline custom field. `slug` and `type` are\n * intentionally not present — see `CreateBylineFieldInput`.\n */\nexport interface UpdateBylineFieldInput {\n\tlabel?: string;\n\trequired?: boolean;\n\ttranslatable?: boolean;\n\tvalidation?: BylineFieldValidation | null;\n\tsortOrder?: number;\n}\n\n/**\n * Runtime value type for a byline custom field. The narrow union mirrors\n * what the five v1 field types can produce: `string`/`text`/`url`/`select`\n * → string, `boolean` → boolean, plus `null` for cleared values.\n */\nexport type CustomFieldValue = string | boolean | null;\n\n/**\n * Reserved byline-field slugs. Two reasons a slug ends up here:\n *\n * 1. **Column collision.** Slugs that match a fixed column on\n *    `_emdash_bylines` (migrations 031 + 040) would shadow that column\n *    on hydration. The first 12 entries cover this.\n * 2. **Route collision.** Static file routes under\n *    `/_emdash/api/admin/byline-fields/` take precedence over the\n *    `[slug].ts` dynamic route in Astro, so a custom field whose slug\n *    matches a sibling static file (e.g. `reorder.ts`) is unreachable\n *    via single-field CRUD — the static route handles only its own\n *    method (POST for `reorder`) and 405s everything else.\n *    `reorder` is the only such sibling today; new sibling routes\n *    (e.g. a hypothetical `import.ts`) must be added here.\n *    `[slug]/usage.ts` lives a level deeper so a slug of `usage` does\n *    not collide — it resolves cleanly to `[slug].ts`.\n *\n * Enforced at the registry layer (Phase 2) and the admin API zod layer\n * (Phase 4) so non-HTTP callers (seeds, scripts) get the same guarantee.\n */\nexport const RESERVED_BYLINE_FIELD_SLUGS = [\n\t// 1. Column-collision slugs (matches `_emdash_bylines` fixed columns).\n\t\"id\",\n\t\"slug\",\n\t\"display_name\",\n\t\"bio\",\n\t\"avatar_media_id\",\n\t\"website_url\",\n\t\"user_id\",\n\t\"is_guest\",\n\t\"locale\",\n\t\"translation_group\",\n\t\"created_at\",\n\t\"updated_at\",\n\t// 2. Route-collision slugs (matches static sibling files of `[slug].ts`).\n\t\"reorder\",\n] as const;\n"],"mappings":";;;;AAkCA,MAAa,cAAoC;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;AAGD,MAAa,wBAAgD,IAAI,IAAI;CACpE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAC;AAEF,SAAgB,qBAAqB,MAA0B;AAC9D,QAAO,sBAAsB,IAAI,KAAK;;;;;AAWvC,MAAa,uBAAsD;CAClE,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,SAAS;CACT,SAAS;CACT,UAAU;CACV,QAAQ;CACR,aAAa;CACb,cAAc;CACd,OAAO;CACP,MAAM;CACN,WAAW;CACX,MAAM;CACN,MAAM;CACN,KAAK;CACL,UAAU;CACV,QAAQ;CACR;AAED,MAAa,mBAAmB;;;;;;AAOhC,MAAa,0BAA+C,IAAI,IAAe,CAAC,YAAY,CAAC;;;;;;;;;;;AAY7F,SAAgB,mBAAmB,OAGvB;AACX,KAAI,CAAC,wBAAwB,IAAI,MAAM,KAAK,CAAE,QAAO;AACrD,QAAO,OAAO,MAAM,YAAY,aAAa,YAAY,MAAM,WAAW,SAAS,SAAS;;;;;;;AAQ7F,SAAgB,sBAAsB,KAA2D;AAChG,KAAI,CAAC,wBAAwB,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,WAAY,QAAO;CACtE,IAAI;AACJ,KAAI;AACH,WAAS,KAAK,MAAM,IAAI,WAAW;SAC5B;AACP,SAAO;;AAER,KAAI,OAAO,WAAW,YAAY,WAAW,KAAM,QAAO;AAC1D,QAAO,mBAAmB;EAAE,MAAM,IAAI;EAAM,YAAY;EAAQ,CAAC;;;AA8ClE,MAAa,2BAA2B;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AAgDD,MAAa,8BAA8B;;AAG3C,MAAa,8BAA8B;;AAG3C,MAAa,6BAA6B;;;;;;;AAsN1C,MAAa,uBAAuB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;;;;AAKD,MAAa,4BAA4B;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CAGA;CACA;AAsBD,MAAa,qBAAiD;CAC7D;CACA;CACA;CACA;CACA;CACA;;;;;;;;;;;;;;;;;;;;;AAyFD,MAAa,8BAA8B;CAE1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA"}

package/dist/types-CgfFGfO5.mjs

@@ -0,0 +1,16 @@
+//#region src/storage/types.ts
+/**
+* Storage error with additional context
+*/
+var EmDashStorageError = class extends Error {
+	constructor(message, code, cause) {
+		super(message);
+		this.code = code;
+		this.cause = cause;
+		this.name = "EmDashStorageError";
+	}
+};
+
+//#endregion
+export { EmDashStorageError as t };
+//# sourceMappingURL=types-CgfFGfO5.mjs.map

package/dist/types-CgfFGfO5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CgfFGfO5.mjs","names":[],"sources":["../src/storage/types.ts"],"sourcesContent":["/**\n * Storage Layer Types\n *\n * Defines the interface for S3-compatible storage backends.\n * Works with R2, AWS S3, Minio, and other S3-compatible services.\n */\n\n/**\n * Storage configuration for S3-compatible backends\n */\nexport interface S3StorageConfig {\n\t/** S3 endpoint URL (e.g., \"https://xxx.r2.cloudflarestorage.com\") */\n\tendpoint: string;\n\t/** Bucket name */\n\tbucket: string;\n\t/**\n\t * AWS access key ID.\n\t * May be resolved from the `S3_ACCESS_KEY_ID` env var at runtime on Node.\n\t * Must be provided together with `secretAccessKey`, or both omitted.\n\t */\n\taccessKeyId?: string;\n\t/**\n\t * AWS secret access key.\n\t * May be resolved from the `S3_SECRET_ACCESS_KEY` env var at runtime on Node.\n\t * Must be provided together with `accessKeyId`, or both omitted.\n\t */\n\tsecretAccessKey?: string;\n\t/** Optional region (defaults to \"auto\") */\n\tregion?: string;\n\t/** Optional public URL prefix for generated URLs (e.g., CDN URL) */\n\tpublicUrl?: string;\n}\n\n/**\n * Local filesystem storage for development\n */\nexport interface LocalStorageConfig {\n\t/** Directory path for storing files */\n\tdirectory: string;\n\t/** Base URL for serving files */\n\tbaseUrl: string;\n}\n\n/**\n * Storage adapter descriptor (serializable config)\n */\nexport interface StorageDescriptor {\n\t/** Module path exporting createStorage function */\n\tentrypoint: string;\n\t/** Serializable config passed to createStorage at runtime */\n\tconfig: Record<string, unknown>;\n}\n\n/**\n * Factory function signature for storage adapters\n *\n * Each adapter accesses its own bindings directly:\n * - R2: imports from cloudflare:workers\n * - S3: uses credentials from config\n * - Local: uses filesystem path from config\n */\nexport type CreateStorageFn = (config: Record<string, unknown>) => Storage;\n\n/**\n * Upload result\n */\nexport interface UploadResult {\n\t/** Storage key (path within bucket) */\n\tkey: string;\n\t/** Public URL to access the file */\n\turl: string;\n\t/** File size in bytes */\n\tsize: number;\n}\n\n/**\n * A single byte range of a file, as requested by an HTTP `Range` header\n */\nexport type ByteRange =\n\t/** `length` bytes from `offset`, or every byte from `offset` when `length` is omitted */\n\t| { offset: number; length?: number }\n\t/** The last `suffix` bytes */\n\t| { suffix: number };\n\n/**\n * Options for downloading a file\n */\nexport interface DownloadOptions {\n\t/**\n\t * Download only this part of the file. Adapters that can't serve it,\n\t * including when it starts past the end of the file, return the whole file.\n\t */\n\trange?: ByteRange;\n}\n\n/**\n * Download result\n */\nexport interface DownloadResult {\n\t/** File content as readable stream */\n\tbody: ReadableStream<Uint8Array>;\n\t/** MIME type */\n\tcontentType: string;\n\t/** Size of the whole file in bytes, even when `body` holds only part of it */\n\tsize: number;\n\t/**\n\t * The part of the file `body` holds, when the adapter served\n\t * `DownloadOptions.range`. Absent when `body` is the whole file.\n\t */\n\trange?: { offset: number; length: number };\n\t/** Last modification time of the stored object, when the backend can provide it. */\n\tlastModified?: Date;\n}\n\n/**\n * Signed URL for direct upload\n */\nexport interface SignedUploadUrl {\n\t/** Signed URL for PUT request */\n\turl: string;\n\t/** HTTP method (always PUT) */\n\tmethod: \"PUT\";\n\t/** Headers to include in the upload request */\n\theaders: Record<string, string>;\n\t/** URL expiration time (ISO string) */\n\texpiresAt: string;\n}\n\n/**\n * Options for generating signed upload URL\n */\nexport interface SignedUploadOptions {\n\t/** Storage key (path within bucket) */\n\tkey: string;\n\t/** MIME type of the file */\n\tcontentType: string;\n\t/** File size in bytes (for content-length validation) */\n\tsize?: number;\n\t/** URL expiration in seconds (default: 3600) */\n\texpiresIn?: number;\n}\n\n/**\n * File listing result\n */\nexport interface ListResult {\n\t/** List of files */\n\tfiles: FileInfo[];\n\t/** Cursor for next page (if more results) */\n\tnextCursor?: string;\n}\n\n/**\n * File info from listing\n */\nexport interface FileInfo {\n\t/** Storage key */\n\tkey: string;\n\t/** File size in bytes */\n\tsize: number;\n\t/** Last modified date */\n\tlastModified: Date;\n\t/** ETag (content hash) */\n\tetag?: string;\n}\n\n/**\n * Options for listing files\n */\nexport interface ListOptions {\n\t/** Filter by key prefix */\n\tprefix?: string;\n\t/** Maximum results per page */\n\tlimit?: number;\n\t/** Cursor from previous list call */\n\tcursor?: string;\n}\n\n/**\n * Storage interface\n *\n * All storage backends must implement this interface.\n */\nexport interface Storage {\n\t/**\n\t * Upload a file to storage\n\t */\n\tupload(options: {\n\t\tkey: string;\n\t\tbody: Buffer | Uint8Array | ReadableStream<Uint8Array>;\n\t\tcontentType: string;\n\t\t/** Optional HTTP cache policy stored with publicly served objects. */\n\t\tcacheControl?: string;\n\t}): Promise<UploadResult>;\n\n\t/**\n\t * Download a file from storage, or part of it with `options.range`\n\t */\n\tdownload(key: string, options?: DownloadOptions): Promise<DownloadResult>;\n\n\t/**\n\t * Delete a file from storage\n\t * Idempotent - does not throw if file doesn't exist\n\t */\n\tdelete(key: string): Promise<void>;\n\n\t/**\n\t * Check if a file exists\n\t */\n\texists(key: string): Promise<boolean>;\n\n\t/**\n\t * List files in storage\n\t */\n\tlist(options?: ListOptions): Promise<ListResult>;\n\n\t/**\n\t * Generate a signed URL for direct upload\n\t * Client uploads directly to storage, bypassing the server\n\t */\n\tgetSignedUploadUrl(options: SignedUploadOptions): Promise<SignedUploadUrl>;\n\n\t/**\n\t * Get public URL for a file\n\t */\n\tgetPublicUrl(key: string): string;\n\n\t/**\n\t * Get the origin the browser connects to for direct client uploads.\n\t * Used by the admin CSP when the storage descriptor has no static endpoint.\n\t */\n\tgetClientUploadOrigin?(): string;\n}\n\n/**\n * Storage error with additional context\n */\nexport class EmDashStorageError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic code: string,\n\t\tpublic override cause?: unknown,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"EmDashStorageError\";\n\t}\n}\n"],"mappings":";;;;AA6OA,IAAa,qBAAb,cAAwC,MAAM;CAC7C,YACC,SACA,AAAO,MACP,AAAgB,OACf;AACD,QAAM,QAAQ;EAHP;EACS;AAGhB,OAAK,OAAO"}

package/dist/types-Cj0_yZkn.mjs

@@ -0,0 +1,18 @@
+//#region src/search/types.ts
+/**
+* Search Types
+*
+* Type definitions for the EmDash search system.
+*/
+/**
+* Search configuration for a collection
+*/
+const SEARCH_TOKENIZERS = [
+	"porter unicode61",
+	"unicode61",
+	"trigram"
+];
+
+//#endregion
+export { SEARCH_TOKENIZERS as t };
+//# sourceMappingURL=types-Cj0_yZkn.mjs.map

package/dist/types-Cj0_yZkn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Cj0_yZkn.mjs","names":[],"sources":["../src/search/types.ts"],"sourcesContent":["/**\n * Search Types\n *\n * Type definitions for the EmDash search system.\n */\n\n/**\n * Search configuration for a collection\n */\nexport const SEARCH_TOKENIZERS = [\"porter unicode61\", \"unicode61\", \"trigram\"] as const;\n\nexport type SearchTokenizer = (typeof SEARCH_TOKENIZERS)[number];\n\nexport interface SearchConfig {\n\t/** Whether search is enabled for this collection */\n\tenabled: boolean;\n\t/** Field weights for ranking (higher = more important) */\n\tweights?: Record<string, number>;\n\t/** Field slug used as the result title, from the collection's titleField. */\n\ttitleField?: string;\n\t/** FTS5 tokenizer configuration (defaults to English Porter stemming) */\n\ttokenize?: SearchTokenizer;\n}\n\n/**\n * Options for search queries\n */\nexport interface SearchOptions {\n\t/** Collections to search (defaults to all searchable collections) */\n\tcollections?: string[];\n\t/** Filter by content status (defaults to 'published') */\n\tstatus?: string;\n\t/** Filter by locale (omit to search all locales) */\n\tlocale?: string;\n\t/** Maximum results to return (defaults to 20) */\n\tlimit?: number;\n\t/** Pagination cursor */\n\tcursor?: string;\n\t/**\n\t * Which indexed fields to match against (defaults to 'all').\n\t * With 'title', only the collection's title field is matched; collections\n\t * whose title field is not indexed for search return no results.\n\t */\n\tscope?: \"all\" | \"title\";\n}\n\n/**\n * Options for collection-specific search\n */\nexport interface CollectionSearchOptions {\n\t/** Filter by content status (defaults to 'published') */\n\tstatus?: string;\n\t/** Filter by locale (omit to search all locales) */\n\tlocale?: string;\n\t/** Maximum results to return (defaults to 20) */\n\tlimit?: number;\n\t/** Pagination cursor */\n\tcursor?: string;\n\t/** Which indexed fields to match against (defaults to 'all'). */\n\tscope?: \"all\" | \"title\";\n}\n\n/**\n * A single search result\n */\nexport interface SearchResult {\n\t/** Collection the result belongs to */\n\tcollection: string;\n\t/** Entry ID */\n\tid: string;\n\t/** Entry slug */\n\tslug: string | null;\n\t/** Content locale */\n\tlocale: string;\n\t/** Entry title (if available) */\n\ttitle?: string;\n\t/**\n\t * Highlighted snippet showing match context.\n\t *\n\t * Sanitized server-side to be safe for `set:html` / `innerHTML`:\n\t * all HTML metacharacters in the source text are escaped, and\n\t * matched terms are wrapped in literal `<mark>...</mark>` tags\n\t * (the only HTML the snippet is allowed to contain).\n\t */\n\tsnippet?: string;\n\t/** Relevance score (higher = more relevant) */\n\tscore: number;\n}\n\n/**\n * Response from a search query\n */\nexport interface SearchResponse {\n\t/** Search results */\n\titems: SearchResult[];\n\t/** Cursor for next page of results */\n\tnextCursor?: string;\n}\n\n/**\n * Options for suggestion/autocomplete queries\n */\nexport interface SuggestOptions {\n\t/** Collections to search (defaults to all searchable collections) */\n\tcollections?: string[];\n\t/** Filter by locale (omit to search all locales) */\n\tlocale?: string;\n\t/** Maximum suggestions to return (defaults to 5) */\n\tlimit?: number;\n}\n\n/**\n * A single suggestion result\n */\nexport interface Suggestion {\n\t/** Collection the suggestion belongs to */\n\tcollection: string;\n\t/** Entry ID */\n\tid: string;\n\t/** Entry slug, when available */\n\tslug?: string | null;\n\t/** Entry title */\n\ttitle: string;\n}\n\n/**\n * Search index statistics\n */\nexport interface SearchStats {\n\tcollections: Record<\n\t\tstring,\n\t\t{\n\t\t\t/** Number of indexed entries */\n\t\t\tindexed: number;\n\t\t\t/** When the index was last rebuilt */\n\t\t\tlastRebuilt?: string;\n\t\t}\n\t>;\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,oBAAoB;CAAC;CAAoB;CAAa;CAAU"}