emdash 0.39.0 → 0.40.0

package/dist/types-BcrBrE6-.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BcrBrE6-.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 * 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\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/** Collection-level admin presentation options. */\nexport interface CollectionAdminConfig {\n\t/** Custom field slugs to show in the content list. */\n\tlistColumns?: string[];\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];\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;;AA6ChC,MAAa,2BAA2B;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AAmCD,MAAa,8BAA8B;;AAG3C,MAAa,8BAA8B;;;;;;;AAmN3C,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;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-CAZgq9fO.d.mts

@@ -0,0 +1,124 @@
+//#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.
+   * Only anonymous visitors are affected — preview and edit requests bypass the
+   * cache.
+   *
+   * 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-CAZgq9fO.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-CAZgq9fO.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;;;;;;;AAwFtB;;UA7EiB,qBAAA;EA6EgF;EA3EhG,UAAA;EA2EyC;EAzEzC,MAAA,EAAQ,wBAAA;AAAA;;;;;;;;UAUQ,wBAAA;;;;;;;;;;;EAWhB,UAAA;;;;;;;;;;;;;;;;;;EAkBA,UAAA;;;;;;;EAOA,SAAA;;;;;;;;;;;;;;;EAeA,OAAA;;GAEC,GAAA;AAAA;;;;;;;;KAUU,0BAAA,IAA8B,MAAA,EAAQ,wBAAA,KAA6B,kBAAA"}

package/dist/types-Cd-O03VG.d.mts

@@ -0,0 +1,363 @@
+import { PortableTextBlock } from "@emdash-cms/gutenberg-to-portable-text";
+
+//#region src/import/types.d.ts
+/** Author info from WordPress */
+interface WpAuthorInfo {
+  id?: number;
+  login?: string;
+  email?: string;
+  displayName?: string;
+  postCount: number;
+}
+/** File-based input (WXR upload) */
+interface FileInput {
+  type: "file";
+  file: File;
+}
+/** URL-based input (REST API probe) */
+interface UrlInput {
+  type: "url";
+  url: string;
+  /** Optional auth token for authenticated requests */
+  token?: string;
+}
+/** OAuth-based input (WordPress.com) */
+interface OAuthInput {
+  type: "oauth";
+  url: string;
+  accessToken: string;
+  /** Site ID for WordPress.com */
+  siteId?: string;
+}
+type SourceInput = FileInput | UrlInput | OAuthInput;
+/** Auth requirements for an import source */
+interface SourceAuth {
+  type: "oauth" | "token" | "password" | "none";
+  /** OAuth provider identifier */
+  provider?: string;
+  /** OAuth authorization URL */
+  oauthUrl?: string;
+  /** Human-readable instructions */
+  instructions?: string;
+}
+/** What the source can provide */
+interface SourceCapabilities {
+  /** Can fetch published content without auth */
+  publicContent: boolean;
+  /** Can fetch drafts/private (may need auth) */
+  privateContent: boolean;
+  /** Can fetch all custom post types */
+  customPostTypes: boolean;
+  /** Can fetch all meta fields */
+  allMeta: boolean;
+  /** Can stream media directly */
+  mediaStream: boolean;
+}
+/** Suggested next action after probe */
+type SuggestedAction = {
+  type: "proceed";
+} | {
+  type: "oauth";
+  url: string;
+  provider: string;
+} | {
+  type: "upload";
+  instructions: string;
+} | {
+  type: "install-plugin";
+  instructions: string;
+};
+/** Detected i18n/multilingual plugin info */
+interface I18nDetection {
+  /** Multilingual plugin name (e.g. "wpml", "polylang") */
+  plugin: string;
+  /** BCP 47 default locale */
+  defaultLocale: string;
+  /** All configured locales */
+  locales: string[];
+}
+/** Result of probing a URL for a specific source */
+interface SourceProbeResult {
+  /** Which source can handle this */
+  sourceId: string;
+  /** Confidence level */
+  confidence: "definite" | "likely" | "possible";
+  /** What we detected */
+  detected: {
+    platform: string;
+    version?: string;
+    siteTitle?: string;
+    siteUrl?: string;
+  };
+  /** What capabilities are available */
+  capabilities: SourceCapabilities;
+  /** What auth is needed, if any */
+  auth?: SourceAuth;
+  /** Suggested next step */
+  suggestedAction: SuggestedAction;
+  /** Preview data if available (e.g., post counts from REST API) */
+  preview?: {
+    posts?: number;
+    pages?: number;
+    media?: number;
+  };
+  /** Detected multilingual plugin. Absent when none detected. */
+  i18n?: I18nDetection;
+}
+/** Combined probe result from all sources */
+interface ProbeResult {
+  url: string;
+  isWordPress: boolean;
+  /** Best matching source (highest confidence) */
+  bestMatch: SourceProbeResult | null;
+  /** All matching sources */
+  allMatches: SourceProbeResult[];
+}
+/** Field definition for import */
+interface ImportFieldDef {
+  slug: string;
+  label: string;
+  type: string;
+  required: boolean;
+  searchable?: boolean;
+}
+/** Field compatibility with existing schema */
+type FieldCompatibility = "compatible" | "type_mismatch" | "missing";
+/** Schema status for a collection */
+interface CollectionSchemaStatus {
+  exists: boolean;
+  fieldStatus: Record<string, {
+    status: FieldCompatibility;
+    existingType?: string;
+    requiredType: string;
+  }>;
+  canImport: boolean;
+  reason?: string;
+}
+/** Analysis of a single post type */
+interface PostTypeAnalysis {
+  name: string;
+  count: number;
+  suggestedCollection: string;
+  requiredFields: ImportFieldDef[];
+  schemaStatus: CollectionSchemaStatus;
+}
+/** Attachment/media info */
+interface AttachmentInfo {
+  id?: number;
+  title?: string;
+  url?: string;
+  filename?: string;
+  mimeType?: string;
+  alt?: string;
+  caption?: string;
+  width?: number;
+  height?: number;
+}
+/** Navigation menu analysis */
+interface NavMenuAnalysis {
+  /** Menu name/slug */
+  name: string;
+  /** Menu display label */
+  label: string;
+  /** Number of items in this menu */
+  itemCount: number;
+}
+/** Custom taxonomy analysis */
+interface TaxonomyAnalysis {
+  /** Taxonomy slug (e.g., 'genre', 'portfolio_category') */
+  slug: string;
+  /** Number of terms in this taxonomy */
+  termCount: number;
+  /** Sample term names */
+  sampleTerms: string[];
+}
+/** Reusable block analysis (wp_block post type) */
+interface ReusableBlockAnalysis {
+  /** Original WP ID */
+  id: number;
+  /** Block title */
+  title: string;
+  /** Block slug */
+  slug: string;
+}
+/** Normalized analysis result - same format for all sources */
+interface ImportAnalysis {
+  /** Source that produced this analysis */
+  sourceId: string;
+  site: {
+    title: string;
+    url: string;
+  };
+  postTypes: PostTypeAnalysis[];
+  attachments: {
+    count: number;
+    items: AttachmentInfo[];
+  };
+  categories: number;
+  tags: number;
+  authors: WpAuthorInfo[];
+  /** Navigation menus found in the export */
+  navMenus?: NavMenuAnalysis[];
+  /** Custom taxonomies (beyond categories/tags) */
+  customTaxonomies?: TaxonomyAnalysis[];
+  /** Reusable blocks (wp_block post type) - will be imported as sections */
+  reusableBlocks?: ReusableBlockAnalysis[];
+  /** Source-specific custom fields analysis */
+  customFields?: Array<{
+    key: string;
+    count: number;
+    samples: string[];
+    suggestedField: string;
+    suggestedType: "string" | "number" | "boolean" | "date" | "json";
+    isInternal: boolean;
+  }>;
+  /** Detected multilingual plugin. Absent when none detected. */
+  i18n?: I18nDetection;
+}
+/** Normalized content item - produced by all sources */
+interface NormalizedItem {
+  /** Original ID from source */
+  sourceId: string | number;
+  /** WordPress post type */
+  postType: string;
+  /** Content status */
+  status: "publish" | "draft" | "pending" | "private" | "future";
+  /** URL slug */
+  slug: string;
+  /** Title */
+  title: string;
+  /** Content as Portable Text (already converted) */
+  content: PortableTextBlock[];
+  /** Excerpt/summary */
+  excerpt?: string;
+  /** Publication date */
+  date: Date;
+  /** Last modified date */
+  modified?: Date;
+  /** Author identifier */
+  author?: string;
+  /** Category slugs */
+  categories?: string[];
+  /** Tag slugs */
+  tags?: string[];
+  /** Custom meta fields */
+  meta?: Record<string, unknown>;
+  /** Featured image URL */
+  featuredImage?: string;
+  /** Parent post ID (for hierarchical content like pages) */
+  parentId?: string | number;
+  /** Menu order for sorting */
+  menuOrder?: number;
+  /** Custom taxonomy assignments beyond categories/tags */
+  customTaxonomies?: Record<string, string[]>;
+  /** BCP 47 locale code. When omitted, defaults to defaultLocale. */
+  locale?: string;
+  /**
+   * Source-side translation group ID (opaque string from the origin system).
+   * Items sharing the same translationGroup are linked as translations.
+   * Resolved to an EmDash translation_group ULID during execute.
+   */
+  translationGroup?: string;
+}
+/** Post type mapping configuration */
+interface PostTypeMapping {
+  enabled: boolean;
+  collection: string;
+}
+/** Import configuration */
+interface ImportConfig {
+  postTypeMappings: Record<string, PostTypeMapping>;
+  skipExisting?: boolean;
+}
+/** Options for fetching content */
+interface FetchOptions {
+  /** Post types to fetch */
+  postTypes: string[];
+  /** Whether to include drafts */
+  includeDrafts?: boolean;
+  /** Limit number of items (for testing) */
+  limit?: number;
+}
+/** Import result */
+interface ImportResult {
+  success: boolean;
+  imported: number;
+  skipped: number;
+  errors: Array<{
+    title: string;
+    error: string;
+  }>;
+  byCollection: Record<string, number>;
+  /** Number of taxonomy term assignments written (plugin import) */
+  taxonomyAssignments?: number;
+  /** Source taxonomies skipped because no matching EmDash taxonomy def exists */
+  missingTaxonomies?: string[];
+  /** Custom taxonomy defs auto-created during the import (plugin import) */
+  taxonomiesCreated?: string[];
+  /** Navigation menu import summary (plugin import) */
+  menus?: {
+    created: number;
+    items: number;
+  };
+  /** Comment import summary (plugin import) */
+  comments?: {
+    imported: number;
+    skipped: number;
+  };
+  /** Site settings applied from the source (plugin import) */
+  siteSettings?: string[];
+}
+/**
+ * An import source provides content from an external system.
+ * All sources produce the same normalized analysis and content format.
+ */
+interface ImportSource {
+  /** Unique identifier */
+  id: string;
+  /** Display name */
+  name: string;
+  /** Description for UI */
+  description: string;
+  /** Icon identifier */
+  icon: "upload" | "globe" | "wordpress" | "plug";
+  /** Whether this source requires a file upload */
+  requiresFile?: boolean;
+  /** Whether this source can probe URLs */
+  canProbe?: boolean;
+  /**
+   * Probe a URL to see if this source can handle it.
+   * Returns null if not applicable.
+   */
+  probe?(url: string): Promise<SourceProbeResult | null>;
+  /**
+   * Analyze content from this source.
+   * Returns normalized ImportAnalysis.
+   */
+  analyze(input: SourceInput, context: ImportContext): Promise<ImportAnalysis>;
+  /**
+   * Stream content items for import.
+   * Yields normalized content items.
+   */
+  fetchContent(input: SourceInput, options: FetchOptions): AsyncGenerator<NormalizedItem>;
+  /**
+   * Fetch a media item's data.
+   * Used for media import.
+   */
+  fetchMedia?(url: string, input: SourceInput): Promise<Blob>;
+}
+/** Context passed to import sources */
+interface ImportContext {
+  /** Database connection for schema checks */
+  db?: unknown;
+  /** Function to check existing collections */
+  getExistingCollections?: () => Promise<Map<string, {
+    slug: string;
+    fields: Map<string, {
+      type: string;
+    }>;
+  }>>;
+}
+//#endregion
+export { UrlInput as S, SourceAuth as _, FileInput as a, SourceProbeResult as b, ImportContext as c, ImportSource as d, NormalizedItem as f, ProbeResult as g, PostTypeMapping as h, FieldCompatibility as i, ImportFieldDef as l, PostTypeAnalysis as m, CollectionSchemaStatus as n, ImportAnalysis as o, OAuthInput as p, FetchOptions as r, ImportConfig as s, AttachmentInfo as t, ImportResult as u, SourceCapabilities as v, SuggestedAction as x, SourceInput as y };
+//# sourceMappingURL=types-Cd-O03VG.d.mts.map

package/dist/types-Cd-O03VG.d.mts.map

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