@dyrected/knowledge 0.2.0

package/dist/index.js

@@ -0,0 +1,2776 @@
+// src/generated/recipes.ts
+var recipes = [
+  {
+    "id": "auto-slug",
+    "title": "Generate a slug from a title",
+    "description": "Generate stable URL slugs on the server while showing editors the value live in the Admin UI.",
+    "category": "data-lifecycle",
+    "intents": [
+      "make the URL follow the title",
+      "automatically generate a slug",
+      "create friendly URLs from titles",
+      "keep a slug synchronized with a title"
+    ],
+    "concepts": [
+      "beforeChange",
+      "admin.hooks.onChange",
+      "promoted",
+      "unique"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection } from "@dyrected/core";\n\nexport const toSlug = (value: unknown) =>\n  String(value ?? "")\n    .toLowerCase()\n    .trim()\n    .replace(/[^a-z0-9]+/g, "-")\n    .replace(/(^-|-$)/g, "");\n\nexport const Posts = defineCollection({\n  slug: "posts",\n  hooks: {\n    beforeChange: [\n      ({ data, operation }) => {\n        if (operation === "create" || data.title !== undefined) {\n          return { ...data, slug: toSlug(data.title) };\n        }\n        return data;\n      },\n    ],\n  },\n  fields: [\n    { name: "title", type: "text", label: "Title", required: true },\n    {\n      name: "slug",\n      type: "text",\n      label: "Slug",\n      required: true,\n      unique: true,\n      promoted: true,\n      admin: {\n        hooks: {\n          onChange: ({ siblingData }) => toSlug(siblingData.title),\n        },\n      },\n    },\n  ],\n});',
+    "docsPath": "/docs/recipes/auto-slug"
+  },
+  {
+    "id": "conditional-admin-field",
+    "title": "Show an Admin field only when it is relevant",
+    "description": "Use a serializable Admin condition to reveal a field from the editor's current form values.",
+    "category": "admin-experience",
+    "intents": [
+      "show a field conditionally",
+      "hide irrelevant form fields",
+      "show discount only with a coupon",
+      "make the admin form react to another field"
+    ],
+    "concepts": [
+      "admin.condition",
+      "Jexl",
+      "conditional fields"
+    ],
+    "requires": [],
+    "source": `import { defineCollection } from "@dyrected/core";
+
+export const Orders = defineCollection({
+  slug: "orders",
+  fields: [
+    { name: "couponCode", type: "text", label: "Coupon code" },
+    {
+      name: "discountPercent",
+      type: "number",
+      label: "Discount percentage",
+      admin: { condition: "couponCode != null && couponCode != ''" },
+    },
+  ],
+});`,
+    "docsPath": "/docs/recipes/conditional-admin-field"
+  },
+  {
+    "id": "cross-field-validation",
+    "title": "Validate related fields before saving",
+    "description": "Reject invalid combinations of field values before they reach the database.",
+    "category": "data-lifecycle",
+    "intents": [
+      "validate fields before saving",
+      "make sure an end date is after the start date",
+      "reject invalid form submissions",
+      "validate multiple fields together"
+    ],
+    "concepts": [
+      "beforeChange",
+      "validation",
+      "throw to abort"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection } from "@dyrected/core";\n\nexport const Events = defineCollection({\n  slug: "events",\n  hooks: {\n    beforeChange: [\n      ({ data, doc }) => {\n        const startsAt = data.startsAt ?? doc?.startsAt;\n        const endsAt = data.endsAt ?? doc?.endsAt;\n\n        const start = startsAt ? new Date(startsAt) : undefined;\n        const end = endsAt ? new Date(endsAt) : undefined;\n\n        if (start && Number.isNaN(start.getTime())) {\n          throw new Error("The event start time must be a valid date.");\n        }\n        if (end && Number.isNaN(end.getTime())) {\n          throw new Error("The event end time must be a valid date.");\n        }\n        if (start && end && end <= start) {\n          throw new Error("The event end time must be after its start time.");\n        }\n\n        return data;\n      },\n    ],\n  },\n  fields: [\n    { name: "title", type: "text", label: "Title", required: true },\n    {\n      name: "startsAt",\n      type: "datetime",\n      label: "Starts at",\n      required: true,\n    },\n    {\n      name: "endsAt",\n      type: "datetime",\n      label: "Ends at",\n      required: true,\n    },\n  ],\n});',
+    "docsPath": "/docs/recipes/cross-field-validation"
+  },
+  {
+    "id": "dependent-dropdown",
+    "title": "Update a dropdown from another field",
+    "description": "Change available Admin UI options immediately when an editor changes a related field.",
+    "category": "admin-experience",
+    "intents": [
+      "make one dropdown depend on another",
+      "show states based on the selected country",
+      "create a cascading dropdown",
+      "update select options while editing"
+    ],
+    "concepts": [
+      "admin.hooks.options",
+      "select",
+      "siblingData"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection } from "@dyrected/core";\n\nexport const Locations = defineCollection({\n  slug: "locations",\n  fields: [\n    {\n      name: "country",\n      type: "select",\n      label: "Country",\n      required: true,\n      options: [\n        { label: "Nigeria", value: "ng" },\n        { label: "United States", value: "us" },\n      ],\n    },\n    {\n      name: "region",\n      type: "select",\n      label: "State or region",\n      required: true,\n      options: [],\n      admin: {\n        hooks: {\n          options: ({ siblingData }) => {\n            if (siblingData.country === "ng") return ["Lagos", "Abuja", "Oyo"];\n            if (siblingData.country === "us")\n              return ["California", "New York", "Texas"];\n            return [];\n          },\n        },\n      },\n    },\n  ],\n});',
+    "docsPath": "/docs/recipes/dependent-dropdown"
+  },
+  {
+    "id": "editorial-publishing-workflow",
+    "title": "Add draft, review, and publishing states",
+    "description": "Attach Dyrected's standard editorial workflow and its capability-aware transitions to a collection.",
+    "category": "workflows",
+    "intents": [
+      "add draft and publish states",
+      "require review before publishing",
+      "create an editorial workflow",
+      "let editors submit content for approval"
+    ],
+    "concepts": [
+      "publishingWorkflow",
+      "workflow transitions",
+      "capabilities"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection, publishingWorkflow } from "@dyrected/core";\n\nexport const Posts = defineCollection({\n  slug: "posts",\n  workflow: publishingWorkflow(),\n  fields: [\n    { name: "title", type: "text", label: "Title", required: true },\n    { name: "body", type: "richText", label: "Body", required: true },\n  ],\n});',
+    "docsPath": "/docs/recipes/editorial-publishing-workflow"
+  },
+  {
+    "id": "owner-scoped-access",
+    "title": "Limit documents to their owner",
+    "description": "Return a where constraint from access control so authenticated users only read their own records.",
+    "category": "access-control",
+    "intents": [
+      "users should only see their own records",
+      "add row level access",
+      "scope documents by owner",
+      "prevent users reading another user's data"
+    ],
+    "concepts": [
+      "access.read",
+      "where",
+      "row-level access"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection } from "@dyrected/core";\n\nexport const Projects = defineCollection({\n  slug: "projects",\n  access: {\n    read: ({ user }) => (user ? { owner: { equals: user.sub } } : false),\n    create: ({ user }) => Boolean(user),\n    update: ({ user }) => (user ? { owner: { equals: user.sub } } : false),\n    delete: ({ user }) => (user ? { owner: { equals: user.sub } } : false),\n  },\n  hooks: {\n    beforeChange: [\n      ({ data, operation, user }) => {\n        if (operation !== "create") return data;\n        if (!user) throw new Error("Authentication is required to create a project.");\n        return { ...data, owner: user.sub };\n      },\n    ],\n  },\n  fields: [\n    { name: "name", type: "text", label: "Project name", required: true },\n    {\n      name: "owner",\n      type: "relationship",\n      label: "Owner",\n      relationTo: "users",\n      required: true,\n      admin: { readOnly: true },\n    },\n  ],\n});',
+    "docsPath": "/docs/recipes/owner-scoped-access"
+  },
+  {
+    "id": "page-builder-blocks",
+    "title": "Build flexible pages from reusable blocks",
+    "description": "Define labeled hero, rich-text, and call-to-action blocks for an editor-controlled page layout.",
+    "category": "content-modeling",
+    "intents": [
+      "build a page builder",
+      "let editors arrange page sections",
+      "create reusable content blocks",
+      "model flexible landing pages"
+    ],
+    "concepts": [
+      "blocks",
+      "Block",
+      "content modeling"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection } from "@dyrected/core";\nimport type { Block } from "@dyrected/core";\n\nexport const HeroBlock = {\n  slug: "hero",\n  labels: { singular: "Hero", plural: "Heroes" },\n  fields: [\n    { name: "heading", type: "text", label: "Heading", required: true },\n    { name: "body", type: "textarea", label: "Body" },\n  ],\n} satisfies Block;\n\nexport const CallToActionBlock = {\n  slug: "callToAction",\n  labels: { singular: "Call to action", plural: "Calls to action" },\n  fields: [\n    { name: "label", type: "text", label: "Link label", required: true },\n    { name: "url", type: "url", label: "URL", required: true },\n  ],\n} satisfies Block;\n\nexport const Pages = defineCollection({\n  slug: "pages",\n  fields: [\n    { name: "title", type: "text", label: "Title", required: true },\n    {\n      name: "layout",\n      type: "blocks",\n      label: "Page layout",\n      blocks: [HeroBlock, CallToActionBlock],\n    },\n  ],\n});',
+    "docsPath": "/docs/recipes/page-builder-blocks"
+  },
+  {
+    "id": "relationship-and-reverse-join",
+    "title": "Model a relationship and its reverse lookup",
+    "description": "Store an author relationship on posts and expose the author's posts through a virtual join field.",
+    "category": "content-modeling",
+    "intents": [
+      "connect posts to authors",
+      "show every post written by a user",
+      "create a reverse relationship",
+      "model one-to-many content"
+    ],
+    "concepts": [
+      "relationship",
+      "join",
+      "relationTo",
+      "depth"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection } from "@dyrected/core";\n\nexport const Users = defineCollection({\n  slug: "users",\n  auth: true,\n  fields: [\n    { name: "name", type: "text", label: "Name", required: true },\n    {\n      name: "posts",\n      type: "join",\n      label: "Posts",\n      collection: "posts",\n      on: "author",\n      limit: 20,\n    },\n  ],\n});\n\nexport const Posts = defineCollection({\n  slug: "posts",\n  fields: [\n    { name: "title", type: "text", label: "Title", required: true },\n    {\n      name: "author",\n      type: "relationship",\n      label: "Author",\n      relationTo: "users",\n      required: true,\n    },\n  ],\n});',
+    "docsPath": "/docs/recipes/relationship-and-reverse-join"
+  },
+  {
+    "id": "role-based-access",
+    "title": "Restrict content operations by user role",
+    "description": "Allow public reads, editor writes, and administrator deletion with collection access rules.",
+    "category": "access-control",
+    "intents": [
+      "only editors can update content",
+      "restrict deletion to admins",
+      "make content publicly readable",
+      "add role based access"
+    ],
+    "concepts": [
+      "access",
+      "AuthenticatedUser",
+      "roles"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection } from "@dyrected/core";\n\nexport const Articles = defineCollection({\n  slug: "articles",\n  access: {\n    read: () => true,\n    create: ({ user }) => user?.roles?.some((role) => role === "editor" || role === "admin") ?? false,\n    update: ({ user }) => user?.roles?.some((role) => role === "editor" || role === "admin") ?? false,\n    delete: ({ user }) => user?.roles?.includes("admin") ?? false,\n  },\n  fields: [{ name: "title", type: "text", label: "Title", required: true }],\n});',
+    "docsPath": "/docs/recipes/role-based-access"
+  },
+  {
+    "id": "safe-field-rename",
+    "title": "Rename a field without orphaning existing data",
+    "description": "Use renameTo and a safe default while documents migrate lazily to a new field name.",
+    "category": "data-lifecycle",
+    "intents": [
+      "rename a field safely",
+      "change a field name without losing data",
+      "migrate an existing schema",
+      "keep old documents working after a rename"
+    ],
+    "concepts": [
+      "renameTo",
+      "defaultValue",
+      "schema evolution"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection } from "@dyrected/core";\n\nexport const Customers = defineCollection({\n  slug: "customers",\n  fields: [\n    {\n      name: "fullName",\n      type: "text",\n      label: "Full name",\n      renameTo: "name",\n      defaultValue: "",\n      required: true,\n    },\n  ],\n});',
+    "docsPath": "/docs/recipes/safe-field-rename"
+  },
+  {
+    "id": "upload-collection",
+    "title": "Create a media upload collection",
+    "description": "Enable file uploads and capture accessible metadata in a dedicated media collection.",
+    "category": "integrations",
+    "intents": [
+      "let editors upload images",
+      "create a media library",
+      "store uploaded files",
+      "add image uploads to my project"
+    ],
+    "concepts": [
+      "upload",
+      "StorageAdapter",
+      "media"
+    ],
+    "requires": [],
+    "source": 'import { defineCollection } from "@dyrected/core";\n\nexport const Media = defineCollection({\n  slug: "media",\n  upload: {\n    allowedMimeTypes: ["image/jpeg", "image/png", "image/webp"],\n    maxFileSize: 10 * 1024 * 1024,\n  },\n  fields: [\n    { name: "alt", type: "text", label: "Alternative text", required: true },\n    { name: "caption", type: "textarea", label: "Caption" },\n  ],\n});',
+    "docsPath": "/docs/recipes/upload-collection"
+  }
+];
+
+// src/generated/references.ts
+var references = [
+  {
+    "id": "@dyrected/core:AdminConfig",
+    "name": "AdminConfig",
+    "kind": "interface",
+    "category": "configuration",
+    "sourcePackage": "@dyrected/core",
+    "description": "Branding and metadata options for the Dyrected Admin UI.",
+    "signature": "export interface AdminConfig {\n  /** Custom component slots around the built-in dashboard. */\n  components?: AdminDashboardComponentSlots;\n  branding?: {\n    /** Full logo image shown in the expanded sidebar. URL or imported image asset. */\n    logo?: string;\n    /** Compact logo mark used in the collapsed sidebar state. */\n    logoMark?: string;\n    /** Text alternative or addition to the logo image. */\n    logoText?: string;\n    /**\n     * Primary accent colour as any CSS colour value.\n     * @example '#6366f1'\n     * @example 'hsl(240 50% 60%)'\n     */\n    primaryColor?: string;\n    /** Browser tab favicon URL. */\n    favicon?: string;\n    /** Font family for body and UI text. Must be loaded separately. */\n    fontSans?: string;\n    /** Font family for headings. Must be loaded separately. */\n    fontSerif?: string;\n  };\n  meta?: {\n    /**\n     * String appended to every Admin page's `<title>`.\n     * @default '- Dyrected'\n     */\n    titleSuffix?: string;\n  };\n}",
+    "members": [
+      {
+        "name": "components",
+        "signature": "components?: AdminDashboardComponentSlots",
+        "description": "Custom component slots around the built-in dashboard."
+      },
+      {
+        "name": "branding",
+        "signature": "branding?: {\n    /** Full logo image shown in the expanded sidebar. URL or imported image asset. */\n    logo?: string;\n    /** Compact logo mark used in the collapsed sidebar state. */\n    logoMark?: string;\n    /** Text alternative or addition to the logo image. */\n    logoText?: string;\n    /**\n     * Primary accent colour as any CSS colour value.\n     * @example '#6366f1'\n     * @example 'hsl(240 50% 60%)'\n     */\n    primaryColor?: string;\n    /** Browser tab favicon URL. */\n    favicon?: string;\n    /** Font family for body and UI text. Must be loaded separately. */\n    fontSans?: string;\n    /** Font family for headings. Must be loaded separately. */\n    fontSerif?: string;\n  }",
+        "description": ""
+      },
+      {
+        "name": "meta",
+        "signature": "meta?: {\n    /**\n     * String appended to every Admin page's `<title>`.\n     * @default '- Dyrected'\n     */\n    titleSuffix?: string;\n  }",
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:AuthDocFields",
+    "name": "AuthDocFields",
+    "kind": "type",
+    "category": "fields",
+    "sourcePackage": "@dyrected/core",
+    "description": "Fields automatically injected into collections with `auth: true`.\n`password` is part of the schema but is stripped from API read responses.",
+    "signature": "export type AuthDocFields = {\n  email: string;\n  password?: string;\n  roles?: string[];\n};",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:AuthenticatedUser",
+    "name": "AuthenticatedUser",
+    "kind": "interface",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "Base shape of an authenticated user as decoded from the JWT.\n\nThe actual shape will include every field on your auth collection \u2014 this\ninterface only guarantees the properties that Dyrected always stamps on the\ntoken. Extend it in your own codebase for stronger typing:",
+    "signature": "export interface AuthenticatedUser {\n  /** The user's document ID in the database. */\n  sub: string;\n  /** The user's email address. */\n  email?: string;\n  /** Slug of the collection this user was authenticated against. */\n  collection: string;\n  /** Array of role strings, if your auth collection has a `roles` field. */\n  roles?: string[];\n  /** Any additional fields from the auth collection document. */\n  [key: string]: unknown;\n}",
+    "members": [
+      {
+        "name": "sub",
+        "signature": "sub: string",
+        "description": "The user's document ID in the database."
+      },
+      {
+        "name": "email",
+        "signature": "email?: string",
+        "description": "The user's email address."
+      },
+      {
+        "name": "collection",
+        "signature": "collection: string",
+        "description": "Slug of the collection this user was authenticated against."
+      },
+      {
+        "name": "roles",
+        "signature": "roles?: string[]",
+        "description": "Array of role strings, if your auth collection has a `roles` field."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:availableWorkflowTransitions",
+    "name": "availableWorkflowTransitions",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export function availableWorkflowTransitions(\n  workflow: WorkflowConfig,\n  state: string,\n  user?: AuthenticatedUser,\n): WorkflowTransition[]",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:canViewWorkflowDraft",
+    "name": "canViewWorkflowDraft",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export function canViewWorkflowDraft(workflow: WorkflowConfig, user?: AuthenticatedUser): boolean",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:CollectionAfterChangeHook",
+    "name": "CollectionAfterChangeHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "Runs **after** a document is created or updated in the database.\n\n**Isolation**: errors thrown inside this hook are caught by the framework,\nlogged to the console, and then discarded. The HTTP response returns the\nsaved document as if nothing went wrong \u2014 because from the database's\nperspective, nothing did. This means a transient email failure or webhook\ntimeout will never turn a successful write into a 500 for the caller.\n\nThe return value is ignored \u2014 this hook is for side-effects only (emails,\nwebhooks, cache revalidation, search index updates, etc.).\n\n**Awaiting vs fire-and-forget**: `await`ing inside this hook is fine for\nfast, reliable calls. For slow or unreliable external services prefer\nfire-and-forget with your own `.catch()` so the response doesn't block:\n\n```ts\n// \u2713 fast & reliable \u2014 safe to await\nafterChange: [async ({ doc }) => {\n  await revalidatePath(`/posts/${doc.slug}`)\n}]\n\n// \u2713 slow or unreliable \u2014 fire-and-forget\nafterChange: [({ doc }) => {\n  sendEmail({ to: doc.email, ... }).catch(console.error)\n}]\n```",
+    "signature": "export type CollectionAfterChangeHook<\n  TDoc extends object = Record<string, unknown>,\n> = (args: {\n  /** The document as it was written to the database. */\n  doc: TDoc;\n  /**\n   * Snapshot of the document before the write. Only present on `'update'`\n   * operations; `undefined` on `'create'`.\n   */\n  previousDoc?: TDoc;\n  /** The HTTP request context. */\n  req: HookRequestContext;\n  /** The authenticated user, or `undefined` for unauthenticated requests. */\n  user?: AuthenticatedUser;\n  /** Whether this was a new document or an update. */\n  operation: \"create\" | \"update\";\n  /**\n   * Database adapter with full read/write access. The DB write for this\n   * operation has already committed \u2014 safe for side-effect writes.\n   */\n  db: DatabaseAdapter;\n}) => void | Promise<void>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:CollectionAfterDeleteHook",
+    "name": "CollectionAfterDeleteHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export type CollectionAfterDeleteHook<\n  TDoc extends object = Record<string, unknown>,\n> = (args: {\n  /** The ID of the deleted document. */\n  id: string;\n  /** The document as it was just before deletion. */\n  doc: TDoc;\n  /** The HTTP request context. */\n  req: HookRequestContext;\n  /** The authenticated user, or `undefined` for unauthenticated requests. */\n  user?: AuthenticatedUser;\n  /**\n   * Database adapter with full read/write access. The deletion has already\n   * committed \u2014 safe for cascade deletes or cleanup writes.\n   */\n  db: DatabaseAdapter;\n}) => void | Promise<void>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:CollectionAfterReadHook",
+    "name": "CollectionAfterReadHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "Runs after a document (or list of documents) is fetched from the database,\nbefore the response is sent to the client.\n\nReturn a modified document to send instead. Useful for adding computed\nvirtual fields or transforming the shape of the response.",
+    "signature": "export type CollectionAfterReadHook<\n  TDoc extends object = Record<string, unknown>,\n> = (args: {\n  /** The document as fetched from the database (with defaults applied). */\n  doc: TDoc;\n  /** The HTTP request context. */\n  req: HookRequestContext;\n  /** The authenticated user, or `undefined` for unauthenticated requests. */\n  user?: AuthenticatedUser;\n  /**\n   * Database adapter for cross-collection reads. Write operations (create,\n   * update, delete) will throw \u2014 use `afterChange`/`afterDelete` for writes.\n   */\n  db: ReadonlyDatabaseAdapter;\n}) => TDoc | Promise<TDoc>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:CollectionAfterTransitionHook",
+    "name": "CollectionAfterTransitionHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export type CollectionAfterTransitionHook<\n  TDoc extends object = Record<string, unknown>,\n> = (\n  args: WorkflowTransitionContext<TDoc> & { event: LifecycleEvent },\n) => void | Promise<void>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:CollectionBeforeChangeHook",
+    "name": "CollectionBeforeChangeHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "Runs **before** a document is created or updated in the database.\n\nReturn a modified data object to write instead of the original. This is the\nright place for data transformation, normalisation, slug generation, and\nvalidation (throw to abort the write).",
+    "signature": "export type CollectionBeforeChangeHook<\n  TDoc extends object = Record<string, unknown>,\n> = (args: {\n  /** The incoming data payload being written. */\n  data: Partial<TDoc>;\n  /**\n   * The existing document before this update. Only present on `'update'`\n   * operations; `undefined` on `'create'`.\n   */\n  doc?: TDoc;\n  /** The HTTP request context. */\n  req: HookRequestContext;\n  /** The authenticated user, or `undefined` for unauthenticated requests. */\n  user?: AuthenticatedUser;\n  /** Whether this is a new document or an update to an existing one. */\n  operation: \"create\" | \"update\";\n  /**\n   * Database adapter for cross-collection reads. Write operations (create,\n   * update, delete) will throw \u2014 use `afterChange`/`afterDelete` for writes.\n   */\n  db: ReadonlyDatabaseAdapter;\n}) => Partial<TDoc> | void | Promise<Partial<TDoc> | void>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:CollectionBeforeDeleteHook",
+    "name": "CollectionBeforeDeleteHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "Runs **before** a document is deleted from the database.\n\nThrow an error to cancel the deletion \u2014 the document will not be removed\nand the API will return a `500` with your error message.",
+    "signature": "export type CollectionBeforeDeleteHook<\n  TDoc extends object = Record<string, unknown>,\n> = (args: {\n  /** The ID of the document about to be deleted. */\n  id: string;\n  /** The full document about to be deleted. */\n  doc: TDoc;\n  /** The HTTP request context. */\n  req: HookRequestContext;\n  /** The authenticated user, or `undefined` for unauthenticated requests. */\n  user?: AuthenticatedUser;\n  /**\n   * Database adapter for cross-collection reads. Write operations (create,\n   * update, delete) will throw \u2014 use `afterDelete` for post-deletion writes.\n   */\n  db: ReadonlyDatabaseAdapter;\n}) => void | Promise<void>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:CollectionBeforeReadHook",
+    "name": "CollectionBeforeReadHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "Runs before Dyrected queries the database for a list or single-document fetch.\n\nReturn a new `where` query object to override or extend the current filter.\nReturn `undefined` (or nothing) to leave the query unchanged.",
+    "signature": "export type CollectionBeforeReadHook = (args: {\n  /** The HTTP request context. */\n  req: HookRequestContext;\n  /** The current `where` query filter. Modify and return to override. */\n  query?: Record<string, unknown>;\n  /** The authenticated user, or `undefined` for unauthenticated requests. */\n  user?: AuthenticatedUser;\n  /**\n   * Database adapter for cross-collection reads. Write operations (create,\n   * update, delete) will throw \u2014 use `afterChange`/`afterDelete` for writes.\n   */\n  db: ReadonlyDatabaseAdapter;\n}) => Record<string, unknown> | void | Promise<Record<string, unknown> | void>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:CollectionBeforeTransitionHook",
+    "name": "CollectionBeforeTransitionHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export type CollectionBeforeTransitionHook<\n  TDoc extends object = Record<string, unknown>,\n> = (args: WorkflowTransitionContext<TDoc>) => void | Promise<void>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:CollectionConfig",
+    "name": "CollectionConfig",
+    "kind": "interface",
+    "category": "configuration",
+    "sourcePackage": "@dyrected/core",
+    "description": "Defines a Dyrected collection \u2014 a named set of documents with a shared schema.\n\nPass your document's TypeScript type as the generic parameter `TDoc` to get\nfully typed hooks and access functions:\n\n```ts\ninterface Post {\n  id: string\n  title: string\n  slug: string\n  status: 'draft' | 'published'\n  publishedAt?: string\n}\n\nexport const Posts = defineCollection<Post>({\n  slug: 'posts',\n  hooks: {\n    beforeChange: [({ data, operation }) => {\n      // `data` is typed as Partial<Post>\n      if (operation === 'create') return { ...data, status: 'draft' }\n      return data\n    }],\n    afterChange: [({ doc, previousDoc }) => {\n      // `doc` and `previousDoc` are typed as Post\n      if (doc.status !== previousDoc?.status) notifySubscribers(doc)\n    }],\n  },\n  fields: [...],\n})\n```",
+    "signature": "export interface CollectionConfig<\n  TDoc extends object = Record<string, unknown>,\n> {\n  /**\n   * Unique identifier for this collection.\n   * Used as the URL segment (`/api/collections/:slug`) and the database table/collection name.\n   * Use kebab-case, e.g. `'blog-posts'`.\n   */\n  slug: string;\n\n  /**\n   * Restricts this collection to a specific site in a multi-tenant deployment.\n   * When set, only requests bearing a matching `X-Site-Id` header can access it.\n   */\n  siteId?: string;\n\n  /**\n   * If `true`, this collection is shared across all sites in a multi-tenant\n   * deployment and accessible regardless of the `X-Site-Id` header.\n   */\n  shared?: boolean;\n\n  /** Human-readable names for documents in this collection, shown in the Admin UI. */\n  labels?: {\n    singular: string;\n    plural: string;\n  };\n\n  /**\n   * If `true`, this collection is an **auth collection** \u2014 it gains\n   * `POST /api/collections/:slug/login` and `POST /api/collections/:slug/logout`\n   * endpoints, and documents are expected to have a `password` field.\n   */\n  auth?: boolean;\n\n  /**\n   * If `true` (or a config object), this collection supports **file uploads**.\n   * Documents gain file-related fields (`url`, `filename`, `mimeType`, etc.)\n   * and the create endpoint accepts `multipart/form-data`.\n   */\n  upload?: boolean | UploadConfig;\n\n  /** Field definitions that make up the document schema for this collection. */\n  fields: Field[];\n\n  /**\n   * If `true`, Dyrected automatically adds `createdAt` and `updatedAt`\n   * timestamp fields to every document. Defaults to `true`.\n   */\n  timestamps?: boolean;\n\n  /**\n   * Initial documents to seed into this collection the first time it is\n   * fetched and found to be empty (e.g. for demo data or defaults).\n   */\n  initialData?: Partial<TDoc>[];\n\n  /**\n   * If `true`, every create, update, and delete operation on this collection\n   * is logged to the `__audit` collection with before/after snapshots and the\n   * acting user's identity.\n   */\n  audit?: boolean;\n\n  /**\n   * Optional state-machine workflow for this collection. Workflow-enabled\n   * entries keep an editable working revision and an independent public\n   * snapshot, so editing published content never changes the live response.\n   */\n  workflow?: WorkflowConfig<TDoc>;\n\n  /**\n   * Collection-level access control.\n   *\n   * Each key is an operation; the value is a function (or Jexl string) that\n   * returns `true` to allow or `false` to deny. Returning a `where`-style\n   * object grants access only to matching documents.\n   *\n   * @example\n   * access: {\n   *   read: () => true,               // public read\n   *   create: ({ user }) => !!user,   // logged-in users only\n   *   update: ({ user }) => user?.roles?.includes('editor') ?? false,\n   *   delete: ({ user }) => user?.roles?.includes('admin') ?? false,\n   * }\n   */\n  access?: {\n    read?: AccessFunction<TDoc> | string;\n    create?: AccessFunction<TDoc> | string;\n    update?: AccessFunction<TDoc> | string;\n    delete?: AccessFunction<TDoc> | string;\n  };\n\n  /**\n   * Collection-level lifecycle hooks.\n   *\n   * Hooks run in the order they appear in the array. The return value of each\n   * hook is passed as the input to the next. Throwing inside any hook aborts\n   * the operation and returns a `500` error.\n   *\n   * See the [Hooks reference](/docs/concepts/hooks) for the full lifecycle diagram.\n   */\n  hooks?: {\n    /**\n     * Runs before the database is queried. Return a modified `where` object\n     * to override the query filter.\n     */\n    beforeRead?: CollectionBeforeReadHook[];\n\n    /**\n     * Runs after documents are fetched. Return a modified doc to change what\n     * the client receives. Runs on every document in a list response.\n     */\n    afterRead?: CollectionAfterReadHook<TDoc>[];\n\n    /**\n     * Runs before create or update. Return modified data to change what is\n     * written to the database. Throw to abort the write entirely.\n     */\n    beforeChange?: CollectionBeforeChangeHook<TDoc>[];\n\n    /**\n     * Runs after create or update is committed. For side-effects only \u2014\n     * webhooks, cache busting, notifications. Return value is ignored.\n     *\n     * Errors are **isolated**: caught, logged, and discarded so a failing\n     * side-effect never turns a successful write into an HTTP 500.\n     * See {@link CollectionAfterChangeHook} for the await-vs-fire-and-forget guidance.\n     */\n    afterChange?: CollectionAfterChangeHook<TDoc>[];\n\n    /**\n     * Runs before a document is deleted. Throw to cancel the deletion.\n     */\n    beforeDelete?: CollectionBeforeDeleteHook<TDoc>[];\n\n    /**\n     * Runs after a document has been deleted. For cleanup side-effects only.\n     *\n     * Errors are **isolated**: caught, logged, and discarded \u2014 the deletion is\n     * already committed and will not be undone.\n     */\n    afterDelete?: CollectionAfterDeleteHook<TDoc>[];\n  };\n\n  /** Admin UI configuration for this collection. */\n  admin?: {\n    /**\n     * Lucide icon displayed beside this collection in the Admin sidebar.\n     * Uses Lucide component names, e.g. `'Newspaper'` or `'ShoppingBag'`.\n     */\n    icon?: AdminIconName;\n\n    /** Custom component slots for this collection's list view. */\n    components?: CollectionListComponentSlots;\n\n    /**\n     * The field name used as the document's display title in the Admin list\n     * view and breadcrumbs. Defaults to `'title'` if the field exists.\n     */\n    useAsTitle?: string;\n\n    /**\n     * Field names to show as columns in the Admin list view.\n     * Defaults to a sensible set of the first few non-structural fields.\n     */\n    defaultColumns?: string[];\n\n    /**\n     * Groups this collection under a named section in the Admin sidebar.\n     * Collections with the same `group` are visually grouped together.\n     */\n    group?: string;\n\n    /** If `true`, this collection is not shown in the Admin UI sidebar. */\n    hidden?: boolean;\n\n    /** If `false`, disables the filter UI entirely for this collection. Defaults to `true`. */\n    filterable?: boolean;\n\n    /**\n     * URL to open in the Live Preview pane when editing a document.\n     * Pass a function to derive the URL from the document's fields.\n     *\n     * @example\n     * previewUrl: (doc) => `https://mysite.com/blog/${doc.slug}`\n     */\n    previewUrl?:\n      | string\n      | ((doc: TDoc, opts: { locale?: string }) => string | null);\n\n    /**\n     * How the Live Preview pane communicates with the frontend.\n     * - `'postMessage'` (default) \u2014 sends a `postMessage` with the current doc data.\n     * - `'token'` \u2014 passes a short-lived preview token as a query parameter.\n     */\n    previewMode?: \"postMessage\" | \"token\";\n\n    /**\n     * Frontend URL pattern for this collection, used by `url` fields to\n     * resolve internal links. Use `{fieldName}` placeholders.\n     *\n     * @example\n     * urlPattern: '/blog/{slug}'   // \u2192 /blog/my-post\n     * urlPattern: '/{slug}'        // \u2192 /about\n     */\n    urlPattern?: string;\n  };\n}",
+    "members": [
+      {
+        "name": "slug",
+        "signature": "slug: string",
+        "description": "Unique identifier for this collection.\nUsed as the URL segment (`/api/collections/:slug`) and the database table/collection name.\nUse kebab-case, e.g. `'blog-posts'`."
+      },
+      {
+        "name": "siteId",
+        "signature": "siteId?: string",
+        "description": "Restricts this collection to a specific site in a multi-tenant deployment.\nWhen set, only requests bearing a matching `X-Site-Id` header can access it."
+      },
+      {
+        "name": "shared",
+        "signature": "shared?: boolean",
+        "description": "If `true`, this collection is shared across all sites in a multi-tenant\ndeployment and accessible regardless of the `X-Site-Id` header."
+      },
+      {
+        "name": "labels",
+        "signature": "labels?: {\n    singular: string;\n    plural: string;\n  }",
+        "description": "Human-readable names for documents in this collection, shown in the Admin UI."
+      },
+      {
+        "name": "auth",
+        "signature": "auth?: boolean",
+        "description": "If `true`, this collection is an **auth collection** \u2014 it gains\n`POST /api/collections/:slug/login` and `POST /api/collections/:slug/logout`\nendpoints, and documents are expected to have a `password` field."
+      },
+      {
+        "name": "upload",
+        "signature": "upload?: boolean | UploadConfig",
+        "description": "If `true` (or a config object), this collection supports **file uploads**.\nDocuments gain file-related fields (`url`, `filename`, `mimeType`, etc.)\nand the create endpoint accepts `multipart/form-data`."
+      },
+      {
+        "name": "fields",
+        "signature": "fields: Field[]",
+        "description": "Field definitions that make up the document schema for this collection."
+      },
+      {
+        "name": "timestamps",
+        "signature": "timestamps?: boolean",
+        "description": "If `true`, Dyrected automatically adds `createdAt` and `updatedAt`\ntimestamp fields to every document. Defaults to `true`."
+      },
+      {
+        "name": "initialData",
+        "signature": "initialData?: Partial<TDoc>[]",
+        "description": "Initial documents to seed into this collection the first time it is\nfetched and found to be empty (e.g. for demo data or defaults)."
+      },
+      {
+        "name": "audit",
+        "signature": "audit?: boolean",
+        "description": "If `true`, every create, update, and delete operation on this collection\nis logged to the `__audit` collection with before/after snapshots and the\nacting user's identity."
+      },
+      {
+        "name": "workflow",
+        "signature": "workflow?: WorkflowConfig<TDoc>",
+        "description": "Optional state-machine workflow for this collection. Workflow-enabled\nentries keep an editable working revision and an independent public\nsnapshot, so editing published content never changes the live response."
+      },
+      {
+        "name": "access",
+        "signature": "access?: {\n    read?: AccessFunction<TDoc> | string;\n    create?: AccessFunction<TDoc> | string;\n    update?: AccessFunction<TDoc> | string;\n    delete?: AccessFunction<TDoc> | string;\n  }",
+        "description": "Collection-level access control.\n\nEach key is an operation; the value is a function (or Jexl string) that\nreturns `true` to allow or `false` to deny. Returning a `where`-style\nobject grants access only to matching documents."
+      },
+      {
+        "name": "hooks",
+        "signature": "hooks?: {\n    /**\n     * Runs before the database is queried. Return a modified `where` object\n     * to override the query filter.\n     */\n    beforeRead?: CollectionBeforeReadHook[];\n\n    /**\n     * Runs after documents are fetched. Return a modified doc to change what\n     * the client receives. Runs on every document in a list response.\n     */\n    afterRead?: CollectionAfterReadHook<TDoc>[];\n\n    /**\n     * Runs before create or update. Return modified data to change what is\n     * written to the database. Throw to abort the write entirely.\n     */\n    beforeChange?: CollectionBeforeChangeHook<TDoc>[];\n\n    /**\n     * Runs after create or update is committed. For side-effects only \u2014\n     * webhooks, cache busting, notifications. Return value is ignored.\n     *\n     * Errors are **isolated**: caught, logged, and discarded so a failing\n     * side-effect never turns a successful write into an HTTP 500.\n     * See {@link CollectionAfterChangeHook} for the await-vs-fire-and-forget guidance.\n     */\n    afterChange?: CollectionAfterChangeHook<TDoc>[];\n\n    /**\n     * Runs before a document is deleted. Throw to cancel the deletion.\n     */\n    beforeDelete?: CollectionBeforeDeleteHook<TDoc>[];\n\n    /**\n     * Runs after a document has been deleted. For cleanup side-effects only.\n     *\n     * Errors are **isolated**: caught, logged, and discarded \u2014 the deletion is\n     * already committed and will not be undone.\n     */\n    afterDelete?: CollectionAfterDeleteHook<TDoc>[];\n  }",
+        "description": "Collection-level lifecycle hooks.\n\nHooks run in the order they appear in the array. The return value of each\nhook is passed as the input to the next. Throwing inside any hook aborts\nthe operation and returns a `500` error.\n\nSee the [Hooks reference](/docs/concepts/hooks) for the full lifecycle diagram."
+      },
+      {
+        "name": "admin",
+        "signature": "admin?: {\n    /**\n     * Lucide icon displayed beside this collection in the Admin sidebar.\n     * Uses Lucide component names, e.g. `'Newspaper'` or `'ShoppingBag'`.\n     */\n    icon?: AdminIconName;\n\n    /** Custom component slots for this collection's list view. */\n    components?: CollectionListComponentSlots;\n\n    /**\n     * The field name used as the document's display title in the Admin list\n     * view and breadcrumbs. Defaults to `'title'` if the field exists.\n     */\n    useAsTitle?: string;\n\n    /**\n     * Field names to show as columns in the Admin list view.\n     * Defaults to a sensible set of the first few non-structural fields.\n     */\n    defaultColumns?: string[];\n\n    /**\n     * Groups this collection under a named section in the Admin sidebar.\n     * Collections with the same `group` are visually grouped together.\n     */\n    group?: string;\n\n    /** If `true`, this collection is not shown in the Admin UI sidebar. */\n    hidden?: boolean;\n\n    /** If `false`, disables the filter UI entirely for this collection. Defaults to `true`. */\n    filterable?: boolean;\n\n    /**\n     * URL to open in the Live Preview pane when editing a document.\n     * Pass a function to derive the URL from the document's fields.\n     *\n     * @example\n     * previewUrl: (doc) => `https://mysite.com/blog/${doc.slug}`\n     */\n    previewUrl?:\n      | string\n      | ((doc: TDoc, opts: { locale?: string }) => string | null);\n\n    /**\n     * How the Live Preview pane communicates with the frontend.\n     * - `'postMessage'` (default) \u2014 sends a `postMessage` with the current doc data.\n     * - `'token'` \u2014 passes a short-lived preview token as a query parameter.\n     */\n    previewMode?: \"postMessage\" | \"token\";\n\n    /**\n     * Frontend URL pattern for this collection, used by `url` fields to\n     * resolve internal links. Use `{fieldName}` placeholders.\n     *\n     * @example\n     * urlPattern: '/blog/{slug}'   // \u2192 /blog/my-post\n     * urlPattern: '/{slug}'        // \u2192 /about\n     */\n    urlPattern?: string;\n  }",
+        "description": "Admin UI configuration for this collection."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:createLifecycleEvent",
+    "name": "createLifecycleEvent",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export function createLifecycleEvent(args: {\n  name: LifecycleEventName;\n  collection: string;\n  documentId: string;\n  actorId?: string;\n  payload: Record<string, unknown>;\n}): LifecycleEvent",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:createWorkflowDocument",
+    "name": "createWorkflowDocument",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export async function createWorkflowDocument(args: {\n  config: DyrectedConfig;\n  collection: CollectionConfig;\n  data: Record<string, unknown>;\n  user?: AuthenticatedUser;\n}): Promise<{ doc: BaseDocument; event: LifecycleEvent }>",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:DatabaseAdapter",
+    "name": "DatabaseAdapter",
+    "kind": "interface",
+    "category": "adapters",
+    "sourcePackage": "@dyrected/core",
+    "description": "The interface every database adapter must implement.\n\nDyrected ships adapters for PostgreSQL, MySQL, SQLite, and MongoDB.\nImplement this interface to connect any other database.",
+    "signature": "export interface DatabaseAdapter {\n  /** Find a paginated list of documents in a collection. */\n  find(args: {\n    collection: string;\n    where?: Record<string, unknown>;\n    limit?: number;\n    page?: number;\n    sort?: string;\n  }): Promise<PaginatedResult>;\n\n  /** Find a single document by its ID. Returns `null` if not found. */\n  findOne(args: {\n    collection: string;\n    id: string;\n  }): Promise<BaseDocument | null>;\n\n  /** Insert a new document and return it with its generated `id`. */\n  create(args: {\n    collection: string;\n    data: Record<string, unknown>;\n  }): Promise<BaseDocument>;\n\n  /** Update a document by ID and return the updated document. */\n  update(args: {\n    collection: string;\n    id: string;\n    data: Record<string, unknown>;\n  }): Promise<BaseDocument>;\n\n  /** Delete a document by ID. Return value is intentionally untyped \u2014 callers do not use it. */\n  delete(args: { collection: string; id: string }): Promise<unknown>;\n\n  /** Fetch the singleton document for a global. Returns an empty object if not yet initialised. */\n  getGlobal(args: { slug: string }): Promise<Record<string, unknown>>;\n\n  /** Create or replace the singleton document for a global. */\n  updateGlobal(args: {\n    slug: string;\n    data: Record<string, unknown>;\n  }): Promise<Record<string, unknown>>;\n\n  /**\n   * Sync the database schema with the current collection and global configs.\n   * Called on startup to create tables/collections that don't exist yet.\n   * Not all adapters implement this (e.g. MongoDB is schema-less).\n   */\n  sync?(\n    collections: CollectionConfig[],\n    globals: GlobalConfig[],\n  ): Promise<void>;\n\n  /**\n   * Execute a raw SQL query or database command.\n   * Optional \u2014 not all adapters support raw access.\n   */\n  execute?(query: string, params?: unknown[]): Promise<unknown>;\n\n  /**\n   * Run all adapter operations in `callback` as one atomic transaction.\n   * Shipped adapters implement this; workflow transitions require it.\n   */\n  transaction?<T>(callback: (db: DatabaseAdapter) => Promise<T>): Promise<T>;\n}",
+    "members": [
+      {
+        "name": "find",
+        "signature": "find(args: {\n    collection: string;\n    where?: Record<string, unknown>;\n    limit?: number;\n    page?: number;\n    sort?: string;\n  }): Promise<PaginatedResult>",
+        "description": "Find a paginated list of documents in a collection."
+      },
+      {
+        "name": "findOne",
+        "signature": "findOne(args: {\n    collection: string;\n    id: string;\n  }): Promise<BaseDocument | null>",
+        "description": "Find a single document by its ID. Returns `null` if not found."
+      },
+      {
+        "name": "create",
+        "signature": "create(args: {\n    collection: string;\n    data: Record<string, unknown>;\n  }): Promise<BaseDocument>",
+        "description": "Insert a new document and return it with its generated `id`."
+      },
+      {
+        "name": "update",
+        "signature": "update(args: {\n    collection: string;\n    id: string;\n    data: Record<string, unknown>;\n  }): Promise<BaseDocument>",
+        "description": "Update a document by ID and return the updated document."
+      },
+      {
+        "name": "delete",
+        "signature": "delete(args: { collection: string; id: string }): Promise<unknown>",
+        "description": "Delete a document by ID. Return value is intentionally untyped \u2014 callers do not use it."
+      },
+      {
+        "name": "getGlobal",
+        "signature": "getGlobal(args: { slug: string }): Promise<Record<string, unknown>>",
+        "description": "Fetch the singleton document for a global. Returns an empty object if not yet initialised."
+      },
+      {
+        "name": "updateGlobal",
+        "signature": "updateGlobal(args: {\n    slug: string;\n    data: Record<string, unknown>;\n  }): Promise<Record<string, unknown>>",
+        "description": "Create or replace the singleton document for a global."
+      },
+      {
+        "name": "sync",
+        "signature": "sync(collections: CollectionConfig[], globals: GlobalConfig[]): Promise<void>",
+        "description": "Sync the database schema with the current collection and global configs.\nCalled on startup to create tables/collections that don't exist yet.\nNot all adapters implement this (e.g. MongoDB is schema-less)."
+      },
+      {
+        "name": "execute",
+        "signature": "execute(query: string, params?: unknown[]): Promise<unknown>",
+        "description": "Execute a raw SQL query or database command.\nOptional \u2014 not all adapters support raw access."
+      },
+      {
+        "name": "transaction",
+        "signature": "transaction<T>(callback: (db: DatabaseAdapter) => Promise<T>): Promise<T>",
+        "description": "Run all adapter operations in `callback` as one atomic transaction.\nShipped adapters implement this; workflow transitions require it."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:dispatchLifecycleEvent",
+    "name": "dispatchLifecycleEvent",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export async function dispatchLifecycleEvent(config: DyrectedConfig, event: LifecycleEvent): Promise<void>",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:dispatchPendingLifecycleEvents",
+    "name": "dispatchPendingLifecycleEvents",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export async function dispatchPendingLifecycleEvents(config: DyrectedConfig, limit = 50): Promise<number>",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:DyrectedConfig",
+    "name": "DyrectedConfig",
+    "kind": "interface",
+    "category": "configuration",
+    "sourcePackage": "@dyrected/core",
+    "description": "The root configuration object passed to `createDyrectedApp`.\n\nThis is the single source of truth for your entire Dyrected instance \u2014\ncollections, globals, database adapter, storage, email, and more.",
+    "signature": "export interface DyrectedConfig {\n  /** Collection definitions. Each collection maps to a database table/collection. */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  collections: CollectionConfig<any>[];\n\n  /** Global (singleton) definitions. Each global maps to a single document. */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  globals: GlobalConfig<any>[];\n\n  /**\n   * The database adapter. Required for all data operations.\n   * @see {@link DatabaseAdapter}\n   */\n  db?: DatabaseAdapter;\n\n  /**\n   * The storage adapter for file uploads.\n   * Required when any collection has `upload: true`.\n   * @see {@link StorageAdapter}\n   */\n  storage?: StorageAdapter;\n\n  /**\n   * The image processing service. Required when any upload collection\n   * defines `imageSizes`.\n   * @see {@link ImageService}\n   */\n  image?: ImageService;\n\n  /** Admin UI branding and metadata. */\n  admin?: AdminConfig;\n\n  /**\n   * Email transport configuration. Required for welcome emails, password\n   * resets, and invite links.\n   *\n   * @example\n   * email: {\n   *   from: 'no-reply@myapp.com',\n   *   send: async ({ to, subject, html }) => {\n   *     await resend.emails.send({ from, to, subject, html })\n   *   },\n   * }\n   */\n  email?: {\n    /** The `From` address for all outbound emails. */\n    from: string;\n    /** The send function. Wire in any email provider (Resend, SendGrid, SES, etc.). */\n    send: (args: {\n      to: string;\n      subject: string;\n      html: string;\n    }) => Promise<void>;\n    /** Override the default email templates. */\n    templates?: {\n      welcome?: (args: { email: string }) => { subject?: string; html: string };\n      invite?: (args: { token: string; invitedByEmail?: string }) => {\n        subject?: string;\n        html: string;\n      };\n      resetPassword?: (args: { token: string; url?: string }) => {\n        subject?: string;\n        html: string;\n      };\n      passwordChanged?: (args: { email: string }) => {\n        subject?: string;\n        html: string;\n      };\n    };\n  };\n\n  /**\n   * Redis connection URL. Required for distributed caching of dynamic option\n   * resolvers and other server-side caches in multi-instance deployments.\n   *\n   * @example\n   * redis: { url: process.env.REDIS_URL }\n   */\n  redis?: {\n    url: string;\n  };\n\n  /** Durable lifecycle-event delivery configuration. */\n  events?: {\n    handlers: LifecycleEventHandler[];\n    /** Maximum delivery attempts before an event remains failed. Defaults to 8. */\n    maxAttempts?: number;\n    /** Initial exponential-backoff delay in milliseconds. Defaults to 1000. */\n    retryDelayMs?: number;\n  };\n\n  /**\n   * Cross-Origin Resource Sharing (CORS) configuration.\n   * List all origins that are allowed to call the Dyrected API.\n   *\n   * @example\n   * cors: { origins: ['https://myapp.com', 'https://www.myapp.com'] }\n   */\n  cors?: {\n    origins: string[];\n  };\n\n  /**\n   * Callback to dynamically fetch additional collections and globals for a\n   * given site ID at request time. Used in multi-tenant deployments where each\n   * site has its own schema stored in the database.\n   *\n   * @param siteId  The `X-Site-Id` header value from the incoming request.\n   * @returns       Extra collections and globals to merge into the config for this request.\n   *\n   * @example\n   * onSchemaFetch: async (siteId) => {\n   *   const site = await db.findOne({ collection: 'sites', id: siteId })\n   *   return buildSchemaFromSiteConfig(site)\n   * }\n   */\n  onSchemaFetch?: (\n    siteId: string,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ) => Promise<{\n    collections?: CollectionConfig<any>[];\n    globals?: GlobalConfig<any>[];\n  }>;\n}",
+    "members": [
+      {
+        "name": "collections",
+        "signature": "collections: CollectionConfig<any>[]",
+        "description": "Collection definitions. Each collection maps to a database table/collection."
+      },
+      {
+        "name": "globals",
+        "signature": "globals: GlobalConfig<any>[]",
+        "description": "Global (singleton) definitions. Each global maps to a single document."
+      },
+      {
+        "name": "db",
+        "signature": "db?: DatabaseAdapter",
+        "description": "The database adapter. Required for all data operations."
+      },
+      {
+        "name": "storage",
+        "signature": "storage?: StorageAdapter",
+        "description": "The storage adapter for file uploads.\nRequired when any collection has `upload: true`."
+      },
+      {
+        "name": "image",
+        "signature": "image?: ImageService",
+        "description": "The image processing service. Required when any upload collection\ndefines `imageSizes`."
+      },
+      {
+        "name": "admin",
+        "signature": "admin?: AdminConfig",
+        "description": "Admin UI branding and metadata."
+      },
+      {
+        "name": "email",
+        "signature": "email?: {\n    /** The `From` address for all outbound emails. */\n    from: string;\n    /** The send function. Wire in any email provider (Resend, SendGrid, SES, etc.). */\n    send: (args: {\n      to: string;\n      subject: string;\n      html: string;\n    }) => Promise<void>;\n    /** Override the default email templates. */\n    templates?: {\n      welcome?: (args: { email: string }) => { subject?: string; html: string };\n      invite?: (args: { token: string; invitedByEmail?: string }) => {\n        subject?: string;\n        html: string;\n      };\n      resetPassword?: (args: { token: string; url?: string }) => {\n        subject?: string;\n        html: string;\n      };\n      passwordChanged?: (args: { email: string }) => {\n        subject?: string;\n        html: string;\n      };\n    };\n  }",
+        "description": "Email transport configuration. Required for welcome emails, password\nresets, and invite links."
+      },
+      {
+        "name": "redis",
+        "signature": "redis?: {\n    url: string;\n  }",
+        "description": "Redis connection URL. Required for distributed caching of dynamic option\nresolvers and other server-side caches in multi-instance deployments."
+      },
+      {
+        "name": "events",
+        "signature": "events?: {\n    handlers: LifecycleEventHandler[];\n    /** Maximum delivery attempts before an event remains failed. Defaults to 8. */\n    maxAttempts?: number;\n    /** Initial exponential-backoff delay in milliseconds. Defaults to 1000. */\n    retryDelayMs?: number;\n  }",
+        "description": "Durable lifecycle-event delivery configuration."
+      },
+      {
+        "name": "cors",
+        "signature": "cors?: {\n    origins: string[];\n  }",
+        "description": "Cross-Origin Resource Sharing (CORS) configuration.\nList all origins that are allowed to call the Dyrected API."
+      },
+      {
+        "name": "onSchemaFetch",
+        "signature": "onSchemaFetch?: (\n    siteId: string,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ) => Promise<{\n    collections?: CollectionConfig<any>[];\n    globals?: GlobalConfig<any>[];\n  }>",
+        "description": "Callback to dynamically fetch additional collections and globals for a\ngiven site ID at request time. Used in multi-tenant deployments where each\nsite has its own schema stored in the database."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:Field",
+    "name": "Field",
+    "kind": "type",
+    "category": "fields",
+    "sourcePackage": "@dyrected/core",
+    "description": "Defines a single field on a collection or global.\n\n## Typed `value` in hook callbacks\n\nThree hook callbacks automatically receive a `value` typed to the field's\nown value type \u2014 no manual annotations needed:\n\n| Hook | When it runs |\n|------|-------------|\n| `hooks.beforeChange` | Server \u2014 before the value is written to the DB |\n| `hooks.afterRead`    | Server \u2014 after the value is read, before the API response |\n| `admin.hooks.onChange` | Browser \u2014 whenever a sibling field changes in the Admin UI |\n\nType mapping by `type` property:\n- `text / textarea / email / url / icon / date / select / radio` \u2192 `string`\n- `number` \u2192 `number`\n- `boolean` \u2192 `boolean`\n- `multiSelect` \u2192 `string[]`\n- `relationship / image` \u2192 `string | string[]`\n- `richText / json` \u2192 `Record<string, unknown>`\n- `object / array / blocks` \u2192 `unknown`\n\n```ts\n{\n  name: 'slug', type: 'text',\n  hooks: {\n    beforeChange: [({ value }) => value.toLowerCase()],  // value: string \u2713\n    afterRead:    [({ value }) => value.trim()],         // value: string \u2713\n  },\n  admin: {\n    hooks: {\n      onChange: ({ value, siblingData }) =>              // value: string \u2713\n        (siblingData.title as string ?? '').toLowerCase().replace(/\\s+/g, '-'),\n    },\n  },\n}\n```\n\n**Important**: write `type` as a plain string literal \u2014 do **not** use `as const`.\nTypeScript's `const` generic inference already preserves literal types, and\nadding `as const` to the discriminant property prevents the contextual type\nfrom flowing into the hook callbacks.\n\n```ts\n// \u2713 correct\n{ name: 'slug', type: 'text', hooks: { beforeChange: [({ value }) => value.toLowerCase()] } }\n\n// \u2717 breaks value typing\n{ name: 'slug', type: 'text' as const, hooks: { beforeChange: [({ value }) => value.toLowerCase()] } }\n```",
+    "signature": 'export type Field = FieldBase &\n  (\n    | ({\n        type:\n          | "text"\n          | "textarea"\n          | "email"\n          | "url"\n          | "icon"\n          | "date"\n          | "datetime"\n          | "time"\n          | "select"\n          | "radio";\n      } & FieldHooks<string> &\n        FieldAdminHooks<string>)\n    | ({ type: "number" } & FieldHooks<number> & FieldAdminHooks<number>)\n    | ({ type: "boolean" } & FieldHooks<boolean> & FieldAdminHooks<boolean>)\n    | ({ type: "multiSelect" } & FieldHooks<string[]> &\n        FieldAdminHooks<string[]>)\n    | ({ type: "relationship" | "image" } & FieldHooks<string | string[]> &\n        FieldAdminHooks<string | string[]>)\n    | ({ type: "richText" | "json" } & FieldHooks<Record<string, unknown>> &\n        FieldAdminHooks<Record<string, unknown>>)\n    | ({\n        type: "object" | "array" | "blocks" | "join" | "row";\n      } & FieldHooks<unknown> &\n        FieldAdminHooks<unknown>)\n  );',
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:FieldAfterReadHook",
+    "name": "FieldAfterReadHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "A hook that runs **after a field value is read** from the database, before\nthe response is sent to the client.\n\nReturn the transformed value to return to the client. Use this for masking,\nformatting, or adding computed properties.",
+    "signature": "export type FieldAfterReadHook<\n  TValue = unknown,\n  TDoc extends object = Record<string, unknown>,\n> = (args: {\n  /** The raw field value as stored in the database. */\n  value: TValue;\n  /** The full document being returned (with defaults applied). */\n  doc: TDoc;\n  /** The authenticated user, or `undefined` for unauthenticated requests. */\n  user?: AuthenticatedUser;\n  /**\n   * Database adapter for cross-collection reads. Write operations (create,\n   * update, delete) will throw \u2014 use `afterChange`/`afterDelete` for writes.\n   */\n  db: ReadonlyDatabaseAdapter;\n}) => TValue | undefined | Promise<TValue | undefined>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:FieldBeforeChangeHook",
+    "name": "FieldBeforeChangeHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "A hook that runs **before a field value is saved** to the database.\n\nReturn the transformed value to persist. Return `undefined` to leave the\nvalue unchanged (same as returning the original `value`).\n\nField `beforeChange` hooks run recursively inside `array`, `object`, and\n`blocks` fields \u2014 every nested item is processed automatically.",
+    "signature": "export type FieldBeforeChangeHook<\n  TValue = unknown,\n  TDoc extends object = Record<string, unknown>,\n> = (args: {\n  /** The current value of this field (after any previous hooks in the chain). */\n  value: TValue;\n  /** The full document as it existed before this update. `undefined` on create. */\n  originalDoc?: TDoc;\n  /** The full incoming data payload being written. */\n  data: Partial<TDoc>;\n  /** The authenticated user, or `undefined` for unauthenticated requests. */\n  user?: AuthenticatedUser;\n  /**\n   * Database adapter for cross-collection reads. Write operations (create,\n   * update, delete) will throw \u2014 use `afterChange`/`afterDelete` for writes.\n   */\n  db: ReadonlyDatabaseAdapter;\n}) => TValue | undefined | Promise<TValue | undefined>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:FieldHook",
+    "name": "FieldHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export type FieldHook<\n  TDoc extends object = Record<string, unknown>,\n  TValue = unknown,\n> = FieldBeforeChangeHook<TValue, TDoc>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:FieldType",
+    "name": "FieldType",
+    "kind": "type",
+    "category": "fields",
+    "sourcePackage": "@dyrected/core",
+    "description": "Every field type supported by Dyrected.\n\n- Text group:    `text`, `textarea`, `richText`, `email`, `url`, `icon`\n- Number/Bool:   `number`, `boolean`\n- Date:          `date`, `datetime`, `time`\n- Selection:     `select`, `multiSelect`, `radio`\n- Relationship:  `relationship`, `join`\n- Structural:    `array`, `object`, `blocks`, `json`\n- Layout:        `row`\n- Media:         `image`",
+    "signature": 'export type FieldType =\n  | "text"\n  | "textarea"\n  | "richText"\n  | "number"\n  | "boolean"\n  | "date"\n  | "datetime"\n  | "time"\n  | "select"\n  | "multiSelect"\n  | "radio"\n  | "relationship"\n  | "array"\n  | "object"\n  | "json"\n  | "blocks"\n  | "image"\n  | "email"\n  | "url"\n  | "icon"\n  | "join"\n  | "row";',
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:FileData",
+    "name": "FileData",
+    "kind": "interface",
+    "category": "adapters",
+    "sourcePackage": "@dyrected/core",
+    "description": "Metadata returned after a file is uploaded and stored.\nStored on the document in upload collections.",
+    "signature": "export interface FileData {\n  filename: string;\n  filesize?: number;\n  mimeType: string;\n  /** Public URL of the stored file. */\n  url: string;\n  width?: number;\n  height?: number;\n  focalPoint?: { x: number; y: number };\n  /** Base64-encoded BlurHash string for progressive image loading. */\n  blurhash?: string;\n  /** `'upload'` for server-stored files; `'external'` for provider-managed files. */\n  type?: \"upload\" | \"external\";\n  provider?: string;\n  provider_metadata?: unknown;\n  [key: string]: unknown;\n}",
+    "members": [
+      {
+        "name": "filename",
+        "signature": "filename: string",
+        "description": ""
+      },
+      {
+        "name": "filesize",
+        "signature": "filesize?: number",
+        "description": ""
+      },
+      {
+        "name": "mimeType",
+        "signature": "mimeType: string",
+        "description": ""
+      },
+      {
+        "name": "url",
+        "signature": "url: string",
+        "description": "Public URL of the stored file."
+      },
+      {
+        "name": "width",
+        "signature": "width?: number",
+        "description": ""
+      },
+      {
+        "name": "height",
+        "signature": "height?: number",
+        "description": ""
+      },
+      {
+        "name": "focalPoint",
+        "signature": "focalPoint?: { x: number; y: number }",
+        "description": ""
+      },
+      {
+        "name": "blurhash",
+        "signature": "blurhash?: string",
+        "description": "Base64-encoded BlurHash string for progressive image loading."
+      },
+      {
+        "name": "type",
+        "signature": 'type?: "upload" | "external"',
+        "description": "`'upload'` for server-stored files; `'external'` for provider-managed files."
+      },
+      {
+        "name": "provider",
+        "signature": "provider?: string",
+        "description": ""
+      },
+      {
+        "name": "provider_metadata",
+        "signature": "provider_metadata?: unknown",
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:GlobalAfterChangeHook",
+    "name": "GlobalAfterChangeHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": 'export type GlobalAfterChangeHook<\n  TDoc extends object = Record<string, unknown>,\n> = (args: {\n  doc: TDoc;\n  previousDoc?: TDoc;\n  req: HookRequestContext;\n  user?: AuthenticatedUser;\n  operation: "update";\n  /**\n   * Database adapter with full read/write access. The DB write for this\n   * operation has already committed \u2014 safe for side-effect writes.\n   */\n  db: DatabaseAdapter;\n}) => void | Promise<void>;',
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:GlobalAfterReadHook",
+    "name": "GlobalAfterReadHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "Runs after the global document is fetched, before the response is sent.",
+    "signature": "export type GlobalAfterReadHook<TDoc extends object = Record<string, unknown>> =\n  (args: {\n    doc: TDoc;\n    req: HookRequestContext;\n    user?: AuthenticatedUser;\n    /**\n     * Database adapter for cross-collection reads. Write operations (create,\n     * update, delete) will throw \u2014 use `afterChange` for writes.\n     */\n    db: ReadonlyDatabaseAdapter;\n  }) => TDoc | Promise<TDoc>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:GlobalBeforeChangeHook",
+    "name": "GlobalBeforeChangeHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "Runs before the global document is updated.\nOperation is always `'update'` (globals cannot be created or deleted).",
+    "signature": 'export type GlobalBeforeChangeHook<\n  TDoc extends object = Record<string, unknown>,\n> = (args: {\n  data: Partial<TDoc>;\n  doc?: TDoc;\n  req: HookRequestContext;\n  user?: AuthenticatedUser;\n  operation: "update";\n  /**\n   * Database adapter for cross-collection reads. Write operations (create,\n   * update, delete) will throw \u2014 use `afterChange` for writes.\n   */\n  db: ReadonlyDatabaseAdapter;\n}) => Partial<TDoc> | void | Promise<Partial<TDoc> | void>;',
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:GlobalBeforeReadHook",
+    "name": "GlobalBeforeReadHook",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export type GlobalBeforeReadHook = CollectionBeforeReadHook;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:GlobalConfig",
+    "name": "GlobalConfig",
+    "kind": "interface",
+    "category": "configuration",
+    "sourcePackage": "@dyrected/core",
+    "description": "Defines a Dyrected global \u2014 a singleton document without pagination or IDs.\n\nGlobals are ideal for site-wide settings, feature flags, or any data where\nthere is always exactly one record (e.g. `site-settings`, `navigation`, `theme`).\n\nPass your document's TypeScript type as the generic parameter `TDoc` to get\nfully typed hooks:\n\n```ts\ninterface SiteSettings {\n  siteName: string\n  tagline: string\n  maintenanceMode: boolean\n}\n\nexport const Settings = defineGlobal<SiteSettings>({\n  slug: 'site-settings',\n  hooks: {\n    afterChange: [({ doc }) => {\n      // `doc` is typed as SiteSettings\n      if (doc.maintenanceMode) alertOnCall()\n    }],\n  },\n  fields: [...],\n})\n```",
+    "signature": "export interface GlobalConfig<TDoc extends object = Record<string, unknown>> {\n  /**\n   * Unique identifier for this global.\n   * Used as the URL segment (`/api/globals/:slug`) and the storage key.\n   */\n  slug: string;\n\n  /** Restricts this global to a specific site in a multi-tenant deployment. */\n  siteId?: string;\n\n  /**\n   * If `true`, this global is shared across all sites in a multi-tenant\n   * deployment.\n   */\n  shared?: boolean;\n\n  /** Human-readable label shown in the Admin UI sidebar. */\n  label?: string;\n\n  /** Field definitions for this global's document schema. */\n  fields: Field[];\n\n  /** Access control for reading and updating this global. */\n  access?: {\n    read?: AccessFunction<TDoc>;\n    update?: AccessFunction<TDoc>;\n  };\n\n  /**\n   * Global-level lifecycle hooks.\n   * Globals support `beforeRead`, `afterRead`, `beforeChange`, and `afterChange`.\n   * There are no delete hooks since globals cannot be deleted.\n   */\n  hooks?: {\n    beforeRead?: GlobalBeforeReadHook[];\n    afterRead?: GlobalAfterReadHook<TDoc>[];\n    beforeChange?: GlobalBeforeChangeHook<TDoc>[];\n    afterChange?: GlobalAfterChangeHook<TDoc>[];\n  };\n\n  /** Admin UI configuration for this global. */\n  admin?: {\n    /**\n     * Lucide icon displayed beside this global in the Admin sidebar.\n     * Uses Lucide component names, e.g. `'Settings2'` or `'Palette'`.\n     */\n    icon?: AdminIconName;\n    /** Groups this global under a named section in the Admin sidebar. */\n    group?: string;\n    /** If `true`, this global is not shown in the Admin UI sidebar. */\n    hidden?: boolean;\n  };\n\n  /**\n   * Initial data to seed this global with the first time it is fetched and\n   * found to be empty.\n   */\n  initialData?: Partial<TDoc>;\n}",
+    "members": [
+      {
+        "name": "slug",
+        "signature": "slug: string",
+        "description": "Unique identifier for this global.\nUsed as the URL segment (`/api/globals/:slug`) and the storage key."
+      },
+      {
+        "name": "siteId",
+        "signature": "siteId?: string",
+        "description": "Restricts this global to a specific site in a multi-tenant deployment."
+      },
+      {
+        "name": "shared",
+        "signature": "shared?: boolean",
+        "description": "If `true`, this global is shared across all sites in a multi-tenant\ndeployment."
+      },
+      {
+        "name": "label",
+        "signature": "label?: string",
+        "description": "Human-readable label shown in the Admin UI sidebar."
+      },
+      {
+        "name": "fields",
+        "signature": "fields: Field[]",
+        "description": "Field definitions for this global's document schema."
+      },
+      {
+        "name": "access",
+        "signature": "access?: {\n    read?: AccessFunction<TDoc>;\n    update?: AccessFunction<TDoc>;\n  }",
+        "description": "Access control for reading and updating this global."
+      },
+      {
+        "name": "hooks",
+        "signature": "hooks?: {\n    beforeRead?: GlobalBeforeReadHook[];\n    afterRead?: GlobalAfterReadHook<TDoc>[];\n    beforeChange?: GlobalBeforeChangeHook<TDoc>[];\n    afterChange?: GlobalAfterChangeHook<TDoc>[];\n  }",
+        "description": "Global-level lifecycle hooks.\nGlobals support `beforeRead`, `afterRead`, `beforeChange`, and `afterChange`.\nThere are no delete hooks since globals cannot be deleted."
+      },
+      {
+        "name": "admin",
+        "signature": "admin?: {\n    /**\n     * Lucide icon displayed beside this global in the Admin sidebar.\n     * Uses Lucide component names, e.g. `'Settings2'` or `'Palette'`.\n     */\n    icon?: AdminIconName;\n    /** Groups this global under a named section in the Admin sidebar. */\n    group?: string;\n    /** If `true`, this global is not shown in the Admin UI sidebar. */\n    hidden?: boolean;\n  }",
+        "description": "Admin UI configuration for this global."
+      },
+      {
+        "name": "initialData",
+        "signature": "initialData?: Partial<TDoc>",
+        "description": "Initial data to seed this global with the first time it is fetched and\nfound to be empty."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:HookFunction",
+    "name": "HookFunction",
+    "kind": "type",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": 'export type HookFunction<TDoc extends object = Record<string, unknown>> =\n  (args: {\n    data?: Partial<TDoc>;\n    doc?: TDoc;\n    user?: AuthenticatedUser;\n    req?: HookRequestContext;\n    operation?: "create" | "update" | "delete";\n    db?: DatabaseAdapter;\n    [key: string]: unknown;\n  }) => unknown | Promise<unknown>;',
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:HookRequestContext",
+    "name": "HookRequestContext",
+    "kind": "interface",
+    "category": "hooks",
+    "sourcePackage": "@dyrected/core",
+    "description": "Minimum HTTP request context passed to every server-side hook and resolver.\n\nThe full Web Standard `Request` is available as `raw` when you need it, but\nmost hooks only need `query` (URL search parameters).",
+    "signature": "export interface HookRequestContext {\n  /** Parsed URL query-string parameters, e.g. `{ page: '2', search: 'hello' }`. */\n  query: Record<string, string>;\n  /** Incoming HTTP headers, lowercased. */\n  headers: Record<string, string>;\n  /** The raw Web Standard `Request` object. Useful for streaming or advanced header inspection. */\n  raw?: Request;\n}",
+    "members": [
+      {
+        "name": "query",
+        "signature": "query: Record<string, string>",
+        "description": "Parsed URL query-string parameters, e.g. `{ page: '2', search: 'hello' }`."
+      },
+      {
+        "name": "headers",
+        "signature": "headers: Record<string, string>",
+        "description": "Incoming HTTP headers, lowercased."
+      },
+      {
+        "name": "raw",
+        "signature": "raw?: Request",
+        "description": "The raw Web Standard `Request` object. Useful for streaming or advanced header inspection."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:ImageService",
+    "name": "ImageService",
+    "kind": "interface",
+    "category": "adapters",
+    "sourcePackage": "@dyrected/core",
+    "description": "Processes uploaded images \u2014 generates metadata (dimensions, BlurHash) and\nproduces resized variants defined in `UploadConfig.imageSizes`.",
+    "signature": 'export interface ImageService {\n  process(args: {\n    buffer: Uint8Array;\n    mimeType: string;\n    config?: CollectionConfig["upload"];\n    focalPoint?: { x: number; y: number };\n  }): Promise<{\n    metadata: {\n      width?: number;\n      height?: number;\n      /** Base64-encoded BlurHash for progressive loading. */\n      blurhash?: string;\n    };\n    /** Generated image sizes keyed by their `name`. */\n    sizes?: Record<\n      string,\n      { buffer: Uint8Array; width: number; height: number; filename: string }\n    >;\n  }>;\n}',
+    "members": [
+      {
+        "name": "process",
+        "signature": 'process(args: {\n    buffer: Uint8Array;\n    mimeType: string;\n    config?: CollectionConfig["upload"];\n    focalPoint?: { x: number; y: number };\n  }): Promise<{\n    metadata: {\n      width?: number;\n      height?: number;\n      /** Base64-encoded BlurHash for progressive loading. */\n      blurhash?: string;\n    };\n    /** Generated image sizes keyed by their `name`. */\n    sizes?: Record<\n      string,\n      { buffer: Uint8Array; width: number; height: number; filename: string }\n    >;\n  }>',
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:InferDocShape",
+    "name": "InferDocShape",
+    "kind": "type",
+    "category": "fields",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export type InferDocShape<Fields extends readonly Field[]> =\n  Fields extends readonly []\n    ? Record<never, never>\n    : Fields extends readonly [\n          infer Head extends Field,\n          ...infer Tail extends readonly Field[],\n        ]\n      ? InferFieldEntry<Head> & InferDocShape<Tail>\n      : Record<string, unknown>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:initializeWorkflowDocument",
+    "name": "initializeWorkflowDocument",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export function initializeWorkflowDocument(data: Record<string, unknown>, workflow: WorkflowConfig)",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:LIFECYCLE_EVENTS_COLLECTION",
+    "name": "LIFECYCLE_EVENTS_COLLECTION",
+    "kind": "constant",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": 'export const LIFECYCLE_EVENTS_COLLECTION = "__lifecycle_events";',
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:LifecycleEvent",
+    "name": "LifecycleEvent",
+    "kind": "interface",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": 'export interface LifecycleEvent<TPayload = Record<string, unknown>> {\n  id: string;\n  name: LifecycleEventName;\n  collection: string;\n  documentId: string;\n  occurredAt: string;\n  actorId?: string;\n  payload: TPayload;\n  attempts: number;\n  status: "pending" | "processing" | "delivered" | "failed";\n  nextAttemptAt?: string;\n  deliveredAt?: string;\n  lastError?: string;\n}',
+    "members": [
+      {
+        "name": "id",
+        "signature": "id: string",
+        "description": ""
+      },
+      {
+        "name": "name",
+        "signature": "name: LifecycleEventName",
+        "description": ""
+      },
+      {
+        "name": "collection",
+        "signature": "collection: string",
+        "description": ""
+      },
+      {
+        "name": "documentId",
+        "signature": "documentId: string",
+        "description": ""
+      },
+      {
+        "name": "occurredAt",
+        "signature": "occurredAt: string",
+        "description": ""
+      },
+      {
+        "name": "actorId",
+        "signature": "actorId?: string",
+        "description": ""
+      },
+      {
+        "name": "payload",
+        "signature": "payload: TPayload",
+        "description": ""
+      },
+      {
+        "name": "attempts",
+        "signature": "attempts: number",
+        "description": ""
+      },
+      {
+        "name": "status",
+        "signature": 'status: "pending" | "processing" | "delivered" | "failed"',
+        "description": ""
+      },
+      {
+        "name": "nextAttemptAt",
+        "signature": "nextAttemptAt?: string",
+        "description": ""
+      },
+      {
+        "name": "deliveredAt",
+        "signature": "deliveredAt?: string",
+        "description": ""
+      },
+      {
+        "name": "lastError",
+        "signature": "lastError?: string",
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:LifecycleEventHandler",
+    "name": "LifecycleEventHandler",
+    "kind": "type",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export type LifecycleEventHandler = (\n  event: LifecycleEvent,\n) => void | Promise<void>;",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:LifecycleEventName",
+    "name": "LifecycleEventName",
+    "kind": "type",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export type LifecycleEventName = (typeof LIFECYCLE_EVENT_NAMES)[number];",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:materializeWorkflowDocument",
+    "name": "materializeWorkflowDocument",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export function materializeWorkflowDocument(\n  doc: BaseDocument,\n  workflow: WorkflowConfig,\n  user?: AuthenticatedUser,\n): BaseDocument | null",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:PaginatedResult",
+    "name": "PaginatedResult",
+    "kind": "interface",
+    "category": "adapters",
+    "sourcePackage": "@dyrected/core",
+    "description": "The envelope returned by collection list endpoints (`GET /api/collections/:slug`).",
+    "signature": "export interface PaginatedResult<T = Record<string, any>> {\n  /** The documents on the current page. */\n  docs: T[];\n  /** Total number of documents matching the query (across all pages). */\n  total: number;\n  /** Maximum number of documents per page as requested. */\n  limit: number;\n  /** The current page number (1-indexed). */\n  page: number;\n  /** Total number of pages given the current `limit`. */\n  totalPages: number;\n  /** Whether a next page exists. */\n  hasNextPage: boolean;\n  /** Whether a previous page exists. */\n  hasPrevPage: boolean;\n}",
+    "members": [
+      {
+        "name": "docs",
+        "signature": "docs: T[]",
+        "description": "The documents on the current page."
+      },
+      {
+        "name": "total",
+        "signature": "total: number",
+        "description": "Total number of documents matching the query (across all pages)."
+      },
+      {
+        "name": "limit",
+        "signature": "limit: number",
+        "description": "Maximum number of documents per page as requested."
+      },
+      {
+        "name": "page",
+        "signature": "page: number",
+        "description": "The current page number (1-indexed)."
+      },
+      {
+        "name": "totalPages",
+        "signature": "totalPages: number",
+        "description": "Total number of pages given the current `limit`."
+      },
+      {
+        "name": "hasNextPage",
+        "signature": "hasNextPage: boolean",
+        "description": "Whether a next page exists."
+      },
+      {
+        "name": "hasPrevPage",
+        "signature": "hasPrevPage: boolean",
+        "description": "Whether a previous page exists."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:publishingWorkflow",
+    "name": "publishingWorkflow",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export function publishingWorkflow(): WorkflowConfig",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:ReadonlyDatabaseAdapter",
+    "name": "ReadonlyDatabaseAdapter",
+    "kind": "type",
+    "category": "adapters",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": 'export type ReadonlyDatabaseAdapter = Pick<\n  DatabaseAdapter,\n  "find" | "findOne" | "getGlobal"\n>;',
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:saveWorkflowDraft",
+    "name": "saveWorkflowDraft",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export async function saveWorkflowDraft(args: {\n  config: DyrectedConfig;\n  collection: CollectionConfig;\n  id: string;\n  originalDoc: BaseDocument;\n  data: Record<string, unknown>;\n  user?: AuthenticatedUser;\n}): Promise<{ doc: BaseDocument; event: LifecycleEvent }>",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:StorageAdapter",
+    "name": "StorageAdapter",
+    "kind": "interface",
+    "category": "adapters",
+    "sourcePackage": "@dyrected/core",
+    "description": "The interface every storage adapter must implement.\n\nDyrected ships adapters for local disk, S3, Cloudflare R2, Cloudinary, and\nBackblaze B2. Implement this interface to use any other storage provider.",
+    "signature": "export interface StorageAdapter {\n  /**\n   * Upload a file and return its metadata (URL, dimensions, etc.).\n   * The `prefix` is a path prefix used for multi-tenant setups.\n   */\n  upload(args: {\n    filename: string;\n    buffer: Uint8Array;\n    mimeType: string;\n    prefix?: string;\n  }): Promise<FileData>;\n\n  /** Delete a file by its stored filename. */\n  delete(args: { filename: string }): Promise<void>;\n\n  /** Return the public URL for a stored file. */\n  getURL(args: { filename: string }): string;\n\n  /**\n   * Retrieve the file's raw bytes and MIME type for serving via the API.\n   * Only needed by adapters that serve files through the Dyrected API\n   * (e.g. `LocalStorage`). Cloud adapters return `null` here and rely on\n   * direct CDN URLs instead.\n   */\n  resolve?(args: {\n    filename: string;\n  }): Promise<{ buffer: Uint8Array; mimeType: string } | null>;\n}",
+    "members": [
+      {
+        "name": "upload",
+        "signature": "upload(args: {\n    filename: string;\n    buffer: Uint8Array;\n    mimeType: string;\n    prefix?: string;\n  }): Promise<FileData>",
+        "description": "Upload a file and return its metadata (URL, dimensions, etc.).\nThe `prefix` is a path prefix used for multi-tenant setups."
+      },
+      {
+        "name": "delete",
+        "signature": "delete(args: { filename: string }): Promise<void>",
+        "description": "Delete a file by its stored filename."
+      },
+      {
+        "name": "getURL",
+        "signature": "getURL(args: { filename: string }): string",
+        "description": "Return the public URL for a stored file."
+      },
+      {
+        "name": "resolve",
+        "signature": "resolve(args: {\n    filename: string;\n  }): Promise<{ buffer: Uint8Array; mimeType: string } | null>",
+        "description": "Retrieve the file's raw bytes and MIME type for serving via the API.\nOnly needed by adapters that serve files through the Dyrected API\n(e.g. `LocalStorage`). Cloud adapters return `null` here and rely on\ndirect CDN URLs instead."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:SystemDocFields",
+    "name": "SystemDocFields",
+    "kind": "type",
+    "category": "fields",
+    "sourcePackage": "@dyrected/core",
+    "description": "Audit fields automatically injected into every collection document at runtime.\nThey are always present in API responses but hidden in the Admin UI by default.",
+    "signature": "export type SystemDocFields = {\n  createdAt?: string;\n  updatedAt?: string;\n  /** ID of the user who created the document. */\n  createdBy?: string;\n  /** ID of the user who last updated the document. */\n  updatedBy?: string;\n};",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:transitionWorkflow",
+    "name": "transitionWorkflow",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export async function transitionWorkflow(args: {\n  config: DyrectedConfig;\n  collection: CollectionConfig;\n  id: string;\n  transitionName: string;\n  expectedRevision?: number;\n  comment?: string;\n  user?: AuthenticatedUser;\n  req: HookRequestContext;\n}): Promise<BaseDocument>",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:UploadConfig",
+    "name": "UploadConfig",
+    "kind": "interface",
+    "category": "configuration",
+    "sourcePackage": "@dyrected/core",
+    "description": "Upload configuration for collections that store files.\nSet `upload: true` on the collection to use all defaults, or pass this\nobject to customise allowed types, size limits, and image processing.",
+    "signature": "export interface UploadConfig {\n  /**\n   * Allowed MIME types. Requests with other MIME types are rejected with `400`.\n   * @example ['image/jpeg', 'image/png', 'image/webp', 'application/pdf']\n   */\n  allowedMimeTypes?: string[];\n\n  /**\n   * Maximum file size in **bytes**.\n   * @example 10 * 1024 * 1024  // 10 MB\n   */\n  maxFileSize?: number;\n\n  /**\n   * Local filesystem path where files are stored.\n   * Only used by the `LocalStorage` adapter.\n   */\n  staticDir?: string;\n\n  /**\n   * Public URL prefix prepended to filenames when generating download URLs.\n   * Only used by the `LocalStorage` adapter.\n   * @example '/uploads'\n   */\n  staticURL?: string;\n\n  /**\n   * The `imageSizes` entry name to use as the thumbnail in the Admin media grid.\n   * @example 'thumbnail'\n   */\n  adminThumbnail?: string;\n\n  /**\n   * Additional image sizes to generate when an image is uploaded.\n   * Requires an `ImageService` to be configured (e.g. `@dyrected/image-sharp`).\n   *\n   * @example\n   * imageSizes: [\n   *   { name: 'thumbnail', width: 300, height: 300, fit: 'cover' },\n   *   { name: 'card', width: 800 },\n   * ]\n   */\n  imageSizes?: {\n    /** Identifier used to access this size, e.g. `doc.sizes.thumbnail`. */\n    name: string;\n    /** Target width in pixels. */\n    width?: number;\n    /** Target height in pixels. */\n    height?: number;\n    /** sharp crop strategy (`'entropy'`, `'attention'`, etc.). */\n    crop?: string;\n    /**\n     * sharp fit strategy.\n     * @see https://sharp.pixelplumbing.com/api-resize#parameters\n     */\n    fit?: string;\n    /**\n     * If `true`, images smaller than the target size are not upscaled.\n     * @default true\n     */\n    withoutEnlargement?: boolean;\n    /** Additional sharp format options forwarded to the output pipeline. */\n    formatOptions?: Record<string, unknown>;\n  }[];\n}",
+    "members": [
+      {
+        "name": "allowedMimeTypes",
+        "signature": "allowedMimeTypes?: string[]",
+        "description": "Allowed MIME types. Requests with other MIME types are rejected with `400`."
+      },
+      {
+        "name": "maxFileSize",
+        "signature": "maxFileSize?: number",
+        "description": "Maximum file size in **bytes**."
+      },
+      {
+        "name": "staticDir",
+        "signature": "staticDir?: string",
+        "description": "Local filesystem path where files are stored.\nOnly used by the `LocalStorage` adapter."
+      },
+      {
+        "name": "staticURL",
+        "signature": "staticURL?: string",
+        "description": "Public URL prefix prepended to filenames when generating download URLs.\nOnly used by the `LocalStorage` adapter."
+      },
+      {
+        "name": "adminThumbnail",
+        "signature": "adminThumbnail?: string",
+        "description": "The `imageSizes` entry name to use as the thumbnail in the Admin media grid."
+      },
+      {
+        "name": "imageSizes",
+        "signature": "imageSizes?: {\n    /** Identifier used to access this size, e.g. `doc.sizes.thumbnail`. */\n    name: string;\n    /** Target width in pixels. */\n    width?: number;\n    /** Target height in pixels. */\n    height?: number;\n    /** sharp crop strategy (`'entropy'`, `'attention'`, etc.). */\n    crop?: string;\n    /**\n     * sharp fit strategy.\n     * @see https://sharp.pixelplumbing.com/api-resize#parameters\n     */\n    fit?: string;\n    /**\n     * If `true`, images smaller than the target size are not upscaled.\n     * @default true\n     */\n    withoutEnlargement?: boolean;\n    /** Additional sharp format options forwarded to the output pipeline. */\n    formatOptions?: Record<string, unknown>;\n  }[]",
+        "description": "Additional image sizes to generate when an image is uploaded.\nRequires an `ImageService` to be configured (e.g. `@dyrected/image-sharp`)."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:UploadDocFields",
+    "name": "UploadDocFields",
+    "kind": "type",
+    "category": "fields",
+    "sourcePackage": "@dyrected/core",
+    "description": "Fields automatically added to upload/media collection documents.\nThese mirror the `FileData` interface returned by storage adapters.",
+    "signature": "export type UploadDocFields = {\n  filename: string;\n  filesize?: number;\n  mimeType: string;\n  /** Public URL of the stored file. */\n  url: string;\n  width?: number;\n  height?: number;\n  focalPoint?: { x: number; y: number };\n  /** Base64 BlurHash for progressive image loading. */\n  blurhash?: string;\n  sizes?: Record<\n    string,\n    { filename?: string; url?: string; width?: number; height?: number }\n  >;\n};",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:WORKFLOW_HISTORY_COLLECTION",
+    "name": "WORKFLOW_HISTORY_COLLECTION",
+    "kind": "constant",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": 'export const WORKFLOW_HISTORY_COLLECTION = "__workflow_history";',
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:workflowCapabilities",
+    "name": "workflowCapabilities",
+    "kind": "function",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export function workflowCapabilities(workflow: WorkflowConfig, user?: AuthenticatedUser): Set<string>",
+    "members": []
+  },
+  {
+    "id": "@dyrected/core:WorkflowConfig",
+    "name": "WorkflowConfig",
+    "kind": "interface",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export interface WorkflowConfig<TDoc extends object = Record<string, unknown>> {\n  initialState: string;\n  /** State used for a new working revision created from published content. */\n  draftState?: string;\n  states: WorkflowState[];\n  transitions: WorkflowTransition[];\n  /** Maps values in `user.roles` to workflow capabilities. */\n  roles?: WorkflowRole[];\n  hooks?: {\n    beforeTransition?: CollectionBeforeTransitionHook<TDoc>[];\n    afterTransition?: CollectionAfterTransitionHook<TDoc>[];\n  };\n}",
+    "members": [
+      {
+        "name": "initialState",
+        "signature": "initialState: string",
+        "description": ""
+      },
+      {
+        "name": "draftState",
+        "signature": "draftState?: string",
+        "description": "State used for a new working revision created from published content."
+      },
+      {
+        "name": "states",
+        "signature": "states: WorkflowState[]",
+        "description": ""
+      },
+      {
+        "name": "transitions",
+        "signature": "transitions: WorkflowTransition[]",
+        "description": ""
+      },
+      {
+        "name": "roles",
+        "signature": "roles?: WorkflowRole[]",
+        "description": "Maps values in `user.roles` to workflow capabilities."
+      },
+      {
+        "name": "hooks",
+        "signature": "hooks?: {\n    beforeTransition?: CollectionBeforeTransitionHook<TDoc>[];\n    afterTransition?: CollectionAfterTransitionHook<TDoc>[];\n  }",
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:WorkflowMetadata",
+    "name": "WorkflowMetadata",
+    "kind": "interface",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export interface WorkflowMetadata {\n  state: string;\n  revision: number;\n  publishedRevision?: number;\n  publishedAt?: string;\n  publishedBy?: string;\n  /** Transitions currently allowed for the requesting user. Response-only. */\n  availableTransitions?: string[];\n}",
+    "members": [
+      {
+        "name": "state",
+        "signature": "state: string",
+        "description": ""
+      },
+      {
+        "name": "revision",
+        "signature": "revision: number",
+        "description": ""
+      },
+      {
+        "name": "publishedRevision",
+        "signature": "publishedRevision?: number",
+        "description": ""
+      },
+      {
+        "name": "publishedAt",
+        "signature": "publishedAt?: string",
+        "description": ""
+      },
+      {
+        "name": "publishedBy",
+        "signature": "publishedBy?: string",
+        "description": ""
+      },
+      {
+        "name": "availableTransitions",
+        "signature": "availableTransitions?: string[]",
+        "description": "Transitions currently allowed for the requesting user. Response-only."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:WorkflowRole",
+    "name": "WorkflowRole",
+    "kind": "interface",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export interface WorkflowRole {\n  /** Existing user role value, for example `editor` or `publisher`. */\n  role: string;\n  capabilities: string[];\n}",
+    "members": [
+      {
+        "name": "role",
+        "signature": "role: string",
+        "description": "Existing user role value, for example `editor` or `publisher`."
+      },
+      {
+        "name": "capabilities",
+        "signature": "capabilities: string[]",
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:WorkflowState",
+    "name": "WorkflowState",
+    "kind": "interface",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": 'export interface WorkflowState {\n  /** Stable machine-readable state key. */\n  name: string;\n  /** Label rendered in the Admin UI. */\n  label: string;\n  /** Marks the state whose revision is visible to public readers. */\n  published?: boolean;\n  /** Optional visual tone used by the Admin UI. */\n  color?: "neutral" | "warning" | "success" | "danger" | "info";\n}',
+    "members": [
+      {
+        "name": "name",
+        "signature": "name: string",
+        "description": "Stable machine-readable state key."
+      },
+      {
+        "name": "label",
+        "signature": "label: string",
+        "description": "Label rendered in the Admin UI."
+      },
+      {
+        "name": "published",
+        "signature": "published?: boolean",
+        "description": "Marks the state whose revision is visible to public readers."
+      },
+      {
+        "name": "color",
+        "signature": 'color?: "neutral" | "warning" | "success" | "danger" | "info"',
+        "description": "Optional visual tone used by the Admin UI."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:WorkflowTransition",
+    "name": "WorkflowTransition",
+    "kind": "interface",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export interface WorkflowTransition {\n  /** Stable transition key used by the REST and SDK APIs. */\n  name: string;\n  label: string;\n  from: string | string[];\n  to: string;\n  /** Every listed capability is required. */\n  requiredCapabilities?: string[];\n  /** Require a non-empty comment when performing the transition. */\n  requireComment?: boolean;\n  /** Remove the public snapshot after this transition commits. */\n  unpublish?: boolean;\n}",
+    "members": [
+      {
+        "name": "name",
+        "signature": "name: string",
+        "description": "Stable transition key used by the REST and SDK APIs."
+      },
+      {
+        "name": "label",
+        "signature": "label: string",
+        "description": ""
+      },
+      {
+        "name": "from",
+        "signature": "from: string | string[]",
+        "description": ""
+      },
+      {
+        "name": "to",
+        "signature": "to: string",
+        "description": ""
+      },
+      {
+        "name": "requiredCapabilities",
+        "signature": "requiredCapabilities?: string[]",
+        "description": "Every listed capability is required."
+      },
+      {
+        "name": "requireComment",
+        "signature": "requireComment?: boolean",
+        "description": "Require a non-empty comment when performing the transition."
+      },
+      {
+        "name": "unpublish",
+        "signature": "unpublish?: boolean",
+        "description": "Remove the public snapshot after this transition commits."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/core:WorkflowTransitionContext",
+    "name": "WorkflowTransitionContext",
+    "kind": "interface",
+    "category": "workflows",
+    "sourcePackage": "@dyrected/core",
+    "description": "",
+    "signature": "export interface WorkflowTransitionContext<\n  TDoc extends object = Record<string, unknown>,\n> {\n  transition: WorkflowTransition;\n  from: string;\n  to: string;\n  doc: TDoc;\n  user?: AuthenticatedUser;\n  comment?: string;\n  req: HookRequestContext;\n  db: DatabaseAdapter;\n}",
+    "members": [
+      {
+        "name": "transition",
+        "signature": "transition: WorkflowTransition",
+        "description": ""
+      },
+      {
+        "name": "from",
+        "signature": "from: string",
+        "description": ""
+      },
+      {
+        "name": "to",
+        "signature": "to: string",
+        "description": ""
+      },
+      {
+        "name": "doc",
+        "signature": "doc: TDoc",
+        "description": ""
+      },
+      {
+        "name": "user",
+        "signature": "user?: AuthenticatedUser",
+        "description": ""
+      },
+      {
+        "name": "comment",
+        "signature": "comment?: string",
+        "description": ""
+      },
+      {
+        "name": "req",
+        "signature": "req: HookRequestContext",
+        "description": ""
+      },
+      {
+        "name": "db",
+        "signature": "db: DatabaseAdapter",
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/sdk:BaseSchema",
+    "name": "BaseSchema",
+    "kind": "interface",
+    "category": "sdk",
+    "sourcePackage": "@dyrected/sdk",
+    "description": "",
+    "signature": "export interface BaseSchema {\n  collections: Record<string, any>;\n  globals: Record<string, any>;\n}",
+    "members": [
+      {
+        "name": "collections",
+        "signature": "collections: Record<string, any>",
+        "description": ""
+      },
+      {
+        "name": "globals",
+        "signature": "globals: Record<string, any>",
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/sdk:createClient",
+    "name": "createClient",
+    "kind": "function",
+    "category": "sdk",
+    "sourcePackage": "@dyrected/sdk",
+    "description": "",
+    "signature": "export function createClient<\n  TSchema extends { collections: any; globals: any } = any,\n>(config: DyrectedClientConfig): DyrectedClient<TSchema>",
+    "members": []
+  },
+  {
+    "id": "@dyrected/sdk:DyrectedClient",
+    "name": "DyrectedClient",
+    "kind": "class",
+    "category": "sdk",
+    "sourcePackage": "@dyrected/sdk",
+    "description": "",
+    "signature": "export class DyrectedClient<TSchema extends BaseSchema = any> {\n}",
+    "members": [
+      {
+        "name": "setToken",
+        "signature": "setToken(token: string): void",
+        "description": "Update the Authorization header with a Bearer token.\nCall this after a successful login."
+      },
+      {
+        "name": "clearToken",
+        "signature": "clearToken(): void",
+        "description": "Remove the Authorization header.\nCall this after logout."
+      },
+      {
+        "name": "getAuthHeaders",
+        "signature": "getAuthHeaders(): Record<string, string>",
+        "description": "Returns the headers needed to authenticate raw `fetch()` calls made outside\nthe SDK client (e.g. streaming endpoints, dynamic options).  Includes the\nAuthorization bearer token (if set), x-api-key, and x-site-id."
+      },
+      {
+        "name": "getBaseUrl",
+        "signature": "getBaseUrl()",
+        "description": ""
+      },
+      {
+        "name": "getSchemas",
+        "signature": "getSchemas(): Promise<{ collections: any[]; globals: any[] }>",
+        "description": ""
+      },
+      {
+        "name": "getPreference",
+        "signature": "getPreference<T = unknown>(key: string): Promise<{ key: string; value: T | null }>",
+        "description": ""
+      },
+      {
+        "name": "setPreference",
+        "signature": "setPreference<T = unknown>(key: string, value: T): Promise<{ key: string; value: T }>",
+        "description": ""
+      },
+      {
+        "name": "getPreviewData",
+        "signature": "getPreviewData(token: string): Promise<any>",
+        "description": 'Fetch draft data for a specific preview token.\nUsed in "token" preview mode.'
+      },
+      {
+        "name": "find",
+        "signature": 'find<K extends keyof TSchema["collections"]>(collection: K & string, args: QueryArgs = {}): Promise<PaginatedResult<TSchema["collections"][K]>>',
+        "description": ""
+      },
+      {
+        "name": "collection",
+        "signature": 'collection<K extends keyof TSchema["collections"]>(slug: K & string)',
+        "description": "Returns a fluent query builder for a collection."
+      },
+      {
+        "name": "global",
+        "signature": 'global<K extends keyof TSchema["globals"]>(slug: K & string)',
+        "description": "Access a global by its slug with a fluent builder."
+      },
+      {
+        "name": "findOne",
+        "signature": "findOne<T = any>(collection: string, id: string, args: { depth?: number; initialData?: T } = {}): Promise<T>",
+        "description": ""
+      },
+      {
+        "name": "create",
+        "signature": "create<T = any>(collection: string, data: any): Promise<T>",
+        "description": ""
+      },
+      {
+        "name": "update",
+        "signature": "update<T = any>(collection: string, id: string, data: any): Promise<T>",
+        "description": ""
+      },
+      {
+        "name": "delete",
+        "signature": "delete(collection: string, id: string): Promise<{ message: string }>",
+        "description": ""
+      },
+      {
+        "name": "transition",
+        "signature": "transition<T = WorkflowDocument>(collection: string, id: string, transitionName: string, opts: TransitionOptions = {}): Promise<T>",
+        "description": "Perform a workflow transition on a document.\n\nSends `POST /api/collections/:collection/:id/transitions/:transition`.\nRequires the client to have a valid bearer token set via `setToken()`."
+      },
+      {
+        "name": "workflowHistory",
+        "signature": "workflowHistory(collection: string, id: string, args: { limit?: number } = {}): Promise<PaginatedResult<WorkflowHistoryEntry>>",
+        "description": "Fetch the workflow history for a document.\n\nSends `GET /api/collections/:collection/:id/workflow-history`."
+      },
+      {
+        "name": "deleteMany",
+        "signature": "deleteMany(collection: string, ids: string[]): Promise<{ message: string }>",
+        "description": ""
+      },
+      {
+        "name": "getGlobal",
+        "signature": "getGlobal<T = any>(slug: string, args: { depth?: number; initialData?: T } = {}): Promise<T>",
+        "description": ""
+      },
+      {
+        "name": "updateGlobal",
+        "signature": "updateGlobal<T = any>(slug: string, data: any): Promise<T>",
+        "description": ""
+      },
+      {
+        "name": "listMedia",
+        "signature": 'listMedia(args: QueryArgs = {}, collection: string = "media"): Promise<PaginatedResult<Media>>',
+        "description": ""
+      },
+      {
+        "name": "uploadMedia",
+        "signature": 'uploadMedia(file: File, collection: string = "media"): Promise<Media>',
+        "description": ""
+      },
+      {
+        "name": "deleteMedia",
+        "signature": 'deleteMedia(id: string, collection: string = "media"): Promise<{ message: string }>',
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/sdk:DyrectedClientConfig",
+    "name": "DyrectedClientConfig",
+    "kind": "interface",
+    "category": "sdk",
+    "sourcePackage": "@dyrected/sdk",
+    "description": "",
+    "signature": "export interface DyrectedClientConfig {\n  baseUrl: string;\n  apiKey?: string;\n  siteId?: string;\n  headers?: Record<string, string>;\n  fetch?: typeof fetch;\n  /** Default depth for relationship population. Applied to every request unless overridden per-call. */\n  defaultDepth?: number;\n}",
+    "members": [
+      {
+        "name": "baseUrl",
+        "signature": "baseUrl: string",
+        "description": ""
+      },
+      {
+        "name": "apiKey",
+        "signature": "apiKey?: string",
+        "description": ""
+      },
+      {
+        "name": "siteId",
+        "signature": "siteId?: string",
+        "description": ""
+      },
+      {
+        "name": "headers",
+        "signature": "headers?: Record<string, string>",
+        "description": ""
+      },
+      {
+        "name": "fetch",
+        "signature": "fetch?: typeof fetch",
+        "description": ""
+      },
+      {
+        "name": "defaultDepth",
+        "signature": "defaultDepth?: number",
+        "description": "Default depth for relationship population. Applied to every request unless overridden per-call."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/sdk:DyrectedError",
+    "name": "DyrectedError",
+    "kind": "class",
+    "category": "sdk",
+    "sourcePackage": "@dyrected/sdk",
+    "description": "Structured error thrown by the SDK when the server returns a non-2xx response.",
+    "signature": "export class DyrectedError extends Error {\n}",
+    "members": [
+      {
+        "name": "statusCode",
+        "signature": "readonly statusCode: number",
+        "description": ""
+      },
+      {
+        "name": "errors",
+        "signature": "readonly errors: { field?: string; message: string }[]",
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/sdk:InferSchema",
+    "name": "InferSchema",
+    "kind": "type",
+    "category": "sdk",
+    "sourcePackage": "@dyrected/sdk",
+    "description": "Derives a typed `TSchema` from your exported collection and global config constants.\n\nPass it to `createClient<Schema>()` so every `find`, `findOne`, `create`,\n`update`, `global().get()` call returns the inferred document shape \u2014 no\nmanual interfaces required.",
+    "signature": "export type InferSchema<\n  TCollections extends Record<string, CollectionConfig<any>>,\n  TGlobals extends Record<string, GlobalConfig<any>> = Record<never, never>,\n> = {\n  collections: { [K in keyof TCollections]: ExtractDoc<TCollections[K]> };\n  globals: { [K in keyof TGlobals]: ExtractDoc<TGlobals[K]> };\n};",
+    "members": []
+  },
+  {
+    "id": "@dyrected/sdk:TransitionOptions",
+    "name": "TransitionOptions",
+    "kind": "interface",
+    "category": "sdk",
+    "sourcePackage": "@dyrected/sdk",
+    "description": "Options accepted by `client.transition()`.",
+    "signature": "export interface TransitionOptions {\n  /**\n   * The revision number currently shown to the user. When provided, the server\n   * rejects the transition if the document has changed since it was loaded,\n   * preventing lost-update races.\n   */\n  expectedRevision?: number;\n  /** Required for transitions that have `requireComment: true` (e.g. `reject`). */\n  comment?: string;\n}",
+    "members": [
+      {
+        "name": "expectedRevision",
+        "signature": "expectedRevision?: number",
+        "description": "The revision number currently shown to the user. When provided, the server\nrejects the transition if the document has changed since it was loaded,\npreventing lost-update races."
+      },
+      {
+        "name": "comment",
+        "signature": "comment?: string",
+        "description": "Required for transitions that have `requireComment: true` (e.g. `reject`)."
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/sdk:WorkflowDocument",
+    "name": "WorkflowDocument",
+    "kind": "interface",
+    "category": "sdk",
+    "sourcePackage": "@dyrected/sdk",
+    "description": "Shape of a document returned from a workflow-enabled collection.",
+    "signature": "export interface WorkflowDocument {\n  id: string;\n  _workflow: WorkflowMetadata;\n  [key: string]: unknown;\n}",
+    "members": [
+      {
+        "name": "id",
+        "signature": "id: string",
+        "description": ""
+      },
+      {
+        "name": "_workflow",
+        "signature": "_workflow: WorkflowMetadata",
+        "description": ""
+      }
+    ]
+  },
+  {
+    "id": "@dyrected/sdk:WorkflowHistoryEntry",
+    "name": "WorkflowHistoryEntry",
+    "kind": "interface",
+    "category": "sdk",
+    "sourcePackage": "@dyrected/sdk",
+    "description": "A single workflow history entry returned by `client.workflowHistory()`.",
+    "signature": "export interface WorkflowHistoryEntry {\n  id: string;\n  collection: string;\n  documentId: string;\n  transition: string;\n  from: string;\n  to: string;\n  revision: number;\n  comment: string | null;\n  actorId: string | null;\n  createdAt: string;\n}",
+    "members": [
+      {
+        "name": "id",
+        "signature": "id: string",
+        "description": ""
+      },
+      {
+        "name": "collection",
+        "signature": "collection: string",
+        "description": ""
+      },
+      {
+        "name": "documentId",
+        "signature": "documentId: string",
+        "description": ""
+      },
+      {
+        "name": "transition",
+        "signature": "transition: string",
+        "description": ""
+      },
+      {
+        "name": "from",
+        "signature": "from: string",
+        "description": ""
+      },
+      {
+        "name": "to",
+        "signature": "to: string",
+        "description": ""
+      },
+      {
+        "name": "revision",
+        "signature": "revision: number",
+        "description": ""
+      },
+      {
+        "name": "comment",
+        "signature": "comment: string | null",
+        "description": ""
+      },
+      {
+        "name": "actorId",
+        "signature": "actorId: string | null",
+        "description": ""
+      },
+      {
+        "name": "createdAt",
+        "signature": "createdAt: string",
+        "description": ""
+      }
+    ]
+  }
+];
+var endpoints = [
+  {
+    "id": "GET /api/collections/media",
+    "method": "GET",
+    "path": "/api/collections/media",
+    "summary": "Find Media",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "limit",
+        "in": "query",
+        "required": false
+      },
+      {
+        "name": "page",
+        "in": "query",
+        "required": false
+      },
+      {
+        "name": "where",
+        "in": "query",
+        "required": false,
+        "description": "JSON filter"
+      },
+      {
+        "name": "sort",
+        "in": "query",
+        "required": false,
+        "description": "Sort field (e.g. -createdAt)"
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/media",
+    "method": "POST",
+    "path": "/api/collections/media",
+    "summary": "Create Media item",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "201"
+    ]
+  },
+  {
+    "id": "DELETE /api/collections/media/{id}",
+    "method": "DELETE",
+    "path": "/api/collections/media/{id}",
+    "summary": "Delete Media item",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "204"
+    ]
+  },
+  {
+    "id": "GET /api/collections/media/{id}",
+    "method": "GET",
+    "path": "/api/collections/media/{id}",
+    "summary": "Get a single Media item",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "PATCH /api/collections/media/{id}",
+    "method": "PATCH",
+    "path": "/api/collections/media/{id}",
+    "summary": "Update Media item",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "DELETE /api/collections/media/delete-many",
+    "method": "DELETE",
+    "path": "/api/collections/media/delete-many",
+    "summary": "Delete multiple Media",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/collections/media/media",
+    "method": "GET",
+    "path": "/api/collections/media/media",
+    "summary": "List Media",
+    "tags": [
+      "Media"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/media/media",
+    "method": "POST",
+    "path": "/api/collections/media/media",
+    "summary": "Upload Media item",
+    "tags": [
+      "Media"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "201"
+    ]
+  },
+  {
+    "id": "GET /api/collections/media/media/{filename}",
+    "method": "GET",
+    "path": "/api/collections/media/media/{filename}",
+    "summary": "Serve Media item bytes",
+    "tags": [
+      "Media"
+    ],
+    "authenticated": false,
+    "parameters": [
+      {
+        "name": "filename",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200",
+      "404"
+    ]
+  },
+  {
+    "id": "POST /api/collections/media/seed",
+    "method": "POST",
+    "path": "/api/collections/media/seed",
+    "summary": "Seed initial Media",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/collections/posts",
+    "method": "GET",
+    "path": "/api/collections/posts",
+    "summary": "Find Posts",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "limit",
+        "in": "query",
+        "required": false
+      },
+      {
+        "name": "page",
+        "in": "query",
+        "required": false
+      },
+      {
+        "name": "where",
+        "in": "query",
+        "required": false,
+        "description": "JSON filter"
+      },
+      {
+        "name": "sort",
+        "in": "query",
+        "required": false,
+        "description": "Sort field (e.g. -createdAt)"
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/posts",
+    "method": "POST",
+    "path": "/api/collections/posts",
+    "summary": "Create Post",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "201"
+    ]
+  },
+  {
+    "id": "DELETE /api/collections/posts/{id}",
+    "method": "DELETE",
+    "path": "/api/collections/posts/{id}",
+    "summary": "Delete Post",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "204"
+    ]
+  },
+  {
+    "id": "GET /api/collections/posts/{id}",
+    "method": "GET",
+    "path": "/api/collections/posts/{id}",
+    "summary": "Get a single Post",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "PATCH /api/collections/posts/{id}",
+    "method": "PATCH",
+    "path": "/api/collections/posts/{id}",
+    "summary": "Update Post",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/posts/{id}/transitions/{transition}",
+    "method": "POST",
+    "path": "/api/collections/posts/{id}/transitions/{transition}",
+    "summary": "Transition Post workflow",
+    "tags": [
+      "Workflows"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      },
+      {
+        "name": "transition",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200",
+      "400",
+      "403",
+      "409"
+    ]
+  },
+  {
+    "id": "GET /api/collections/posts/{id}/workflow-history",
+    "method": "GET",
+    "path": "/api/collections/posts/{id}/workflow-history",
+    "summary": "Get Post workflow history",
+    "tags": [
+      "Workflows"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      },
+      {
+        "name": "limit",
+        "in": "query",
+        "required": false
+      }
+    ],
+    "responses": [
+      "200",
+      "403"
+    ]
+  },
+  {
+    "id": "DELETE /api/collections/posts/delete-many",
+    "method": "DELETE",
+    "path": "/api/collections/posts/delete-many",
+    "summary": "Delete multiple Posts",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/posts/seed",
+    "method": "POST",
+    "path": "/api/collections/posts/seed",
+    "summary": "Seed initial Posts",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/collections/users",
+    "method": "GET",
+    "path": "/api/collections/users",
+    "summary": "Find Users",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "limit",
+        "in": "query",
+        "required": false
+      },
+      {
+        "name": "page",
+        "in": "query",
+        "required": false
+      },
+      {
+        "name": "where",
+        "in": "query",
+        "required": false,
+        "description": "JSON filter"
+      },
+      {
+        "name": "sort",
+        "in": "query",
+        "required": false,
+        "description": "Sort field (e.g. -createdAt)"
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users",
+    "method": "POST",
+    "path": "/api/collections/users",
+    "summary": "Create User",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "201"
+    ]
+  },
+  {
+    "id": "DELETE /api/collections/users/{id}",
+    "method": "DELETE",
+    "path": "/api/collections/users/{id}",
+    "summary": "Delete User",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "204"
+    ]
+  },
+  {
+    "id": "GET /api/collections/users/{id}",
+    "method": "GET",
+    "path": "/api/collections/users/{id}",
+    "summary": "Get a single User",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "PATCH /api/collections/users/{id}",
+    "method": "PATCH",
+    "path": "/api/collections/users/{id}",
+    "summary": "Update User",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/{id}/change-password",
+    "method": "POST",
+    "path": "/api/collections/users/{id}/change-password",
+    "summary": "Change a User password",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "id",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/accept-invite",
+    "method": "POST",
+    "path": "/api/collections/users/accept-invite",
+    "summary": "Accept an invitation",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": false,
+    "parameters": [],
+    "responses": [
+      "200",
+      "400"
+    ]
+  },
+  {
+    "id": "DELETE /api/collections/users/delete-many",
+    "method": "DELETE",
+    "path": "/api/collections/users/delete-many",
+    "summary": "Delete multiple Users",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/first-user",
+    "method": "POST",
+    "path": "/api/collections/users/first-user",
+    "summary": "Register the first User",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": false,
+    "parameters": [],
+    "responses": [
+      "200",
+      "400"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/forgot-password",
+    "method": "POST",
+    "path": "/api/collections/users/forgot-password",
+    "summary": "Request a password reset",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": false,
+    "parameters": [],
+    "responses": [
+      "200",
+      "400"
+    ]
+  },
+  {
+    "id": "GET /api/collections/users/init",
+    "method": "GET",
+    "path": "/api/collections/users/init",
+    "summary": "Get Users initialization state",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": false,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/invite",
+    "method": "POST",
+    "path": "/api/collections/users/invite",
+    "summary": "Invite a User",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/login",
+    "method": "POST",
+    "path": "/api/collections/users/login",
+    "summary": "Log in to Users",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": false,
+    "parameters": [],
+    "responses": [
+      "200",
+      "401"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/logout",
+    "method": "POST",
+    "path": "/api/collections/users/logout",
+    "summary": "Log out of Users",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/collections/users/me",
+    "method": "GET",
+    "path": "/api/collections/users/me",
+    "summary": "Get the current User",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/refresh-token",
+    "method": "POST",
+    "path": "/api/collections/users/refresh-token",
+    "summary": "Refresh an authentication token",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/reset-password",
+    "method": "POST",
+    "path": "/api/collections/users/reset-password",
+    "summary": "Reset a password",
+    "tags": [
+      "Authentication"
+    ],
+    "authenticated": false,
+    "parameters": [],
+    "responses": [
+      "200",
+      "400"
+    ]
+  },
+  {
+    "id": "POST /api/collections/users/seed",
+    "method": "POST",
+    "path": "/api/collections/users/seed",
+    "summary": "Seed initial Users",
+    "tags": [
+      "Collections"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/docs",
+    "method": "GET",
+    "path": "/api/docs",
+    "summary": "Open interactive API documentation",
+    "tags": [
+      "System"
+    ],
+    "authenticated": false,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/dyrected/options/{collection}/{field}",
+    "method": "GET",
+    "path": "/api/dyrected/options/{collection}/{field}",
+    "summary": "Resolve dynamic field options",
+    "tags": [
+      "System"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "collection",
+        "in": "path",
+        "required": true
+      },
+      {
+        "name": "field",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/globals/settings",
+    "method": "GET",
+    "path": "/api/globals/settings",
+    "summary": "Get Site settings",
+    "tags": [
+      "Globals"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "PATCH /api/globals/settings",
+    "method": "PATCH",
+    "path": "/api/globals/settings",
+    "summary": "Update Site settings",
+    "tags": [
+      "Globals"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/globals/settings/seed",
+    "method": "POST",
+    "path": "/api/globals/settings/seed",
+    "summary": "Seed Site settings",
+    "tags": [
+      "Globals"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/media/{filename}",
+    "method": "GET",
+    "path": "/api/media/{filename}",
+    "summary": "Serve a stored file",
+    "tags": [
+      "Media"
+    ],
+    "authenticated": false,
+    "parameters": [
+      {
+        "name": "filename",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200",
+      "404"
+    ]
+  },
+  {
+    "id": "GET /api/openapi.json",
+    "method": "GET",
+    "path": "/api/openapi.json",
+    "summary": "Get the OpenAPI specification",
+    "tags": [
+      "System"
+    ],
+    "authenticated": false,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/preferences/{key}",
+    "method": "GET",
+    "path": "/api/preferences/{key}",
+    "summary": "Get an authenticated user preference",
+    "tags": [
+      "Preferences"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "key",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "PUT /api/preferences/{key}",
+    "method": "PUT",
+    "path": "/api/preferences/{key}",
+    "summary": "Set an authenticated user preference",
+    "tags": [
+      "Preferences"
+    ],
+    "authenticated": true,
+    "parameters": [
+      {
+        "name": "key",
+        "in": "path",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/preview-data",
+    "method": "GET",
+    "path": "/api/preview-data",
+    "summary": "Resolve preview data from a token",
+    "tags": [
+      "Preview"
+    ],
+    "authenticated": false,
+    "parameters": [
+      {
+        "name": "token",
+        "in": "query",
+        "required": true
+      }
+    ],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "POST /api/preview-token",
+    "method": "POST",
+    "path": "/api/preview-token",
+    "summary": "Create a preview token",
+    "tags": [
+      "Preview"
+    ],
+    "authenticated": true,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  },
+  {
+    "id": "GET /api/schemas",
+    "method": "GET",
+    "path": "/api/schemas",
+    "summary": "Get the serialized Dyrected schema",
+    "tags": [
+      "System"
+    ],
+    "authenticated": false,
+    "parameters": [],
+    "responses": [
+      "200"
+    ]
+  }
+];
+
+// src/search.ts
+var ignoredWords = /* @__PURE__ */ new Set([
+  "a",
+  "an",
+  "and",
+  "for",
+  "from",
+  "in",
+  "of",
+  "the",
+  "to",
+  "with"
+]);
+function tokens(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, " ").split(" ").filter((token) => token.length > 1 && !ignoredWords.has(token));
+}
+function findRecipesByIntent(query, catalogue, options = {}) {
+  const queryTokens = new Set(tokens(query));
+  if (queryTokens.size === 0) return [];
+  const minimumScore = options.minimumScore ?? 1;
+  const matches = catalogue.map((recipe) => {
+    const intentText = recipe.intents.join(" ").toLowerCase();
+    const titleText = `${recipe.title} ${recipe.description}`.toLowerCase();
+    const conceptText = recipe.concepts.join(" ").toLowerCase();
+    let score = intentText.includes(query.toLowerCase()) ? 20 : 0;
+    for (const token of queryTokens) {
+      if (intentText.includes(token)) score += 5;
+      if (titleText.includes(token)) score += 3;
+      if (conceptText.includes(token)) score += 2;
+    }
+    return { recipe, score };
+  }).filter((match) => match.score >= minimumScore).sort(
+    (left, right) => right.score - left.score || left.recipe.title.localeCompare(right.recipe.title)
+  );
+  return matches.slice(0, options.limit ?? 5);
+}
+
+// src/generated/ai.ts
+var AI_RULES = '# Dyrected AI Rules\n\nThis file combines authored operating rules with facts generated by `@dyrected/knowledge`.\n\n## Before writing code\n\n1. Check `package.json` and the workspace root to confirm `@dyrected/core` is installed.\n2. If it is not installed, use `npx @dyrected/cli init` and verify lint, types, and build before adding collections.\n3. If it is installed, inspect its installed version, public exports, and the existing `dyrected.config.ts`.\n4. When documentation and installed types disagree, follow the installed package.\n5. Detect the project\'s framework, database adapter, storage adapter, package manager, and deployment target before changing setup.\n\n## Hard constraints\n\n- Every named field must have an explicit human-readable `label`.\n- Never invent fields, hooks, configuration properties, SDK methods, adapter methods, or routes.\n- Never use `client.collections`; use `client.collection(\'slug\')`.\n- Never define `email` or `password` on an `auth: true` collection.\n- Never add custom authentication middleware around Dyrected Admin routes.\n- Never remove or directly rename a persisted field. Use `renameTo`, and give new fields on existing schemas a safe `defaultValue`.\n- Use server hooks for correctness. Browser Admin hooks are an optional feedback layer, not the only implementation.\n- Use Jexl strings for `admin.condition` when the schema must synchronize with Dyrected Cloud.\n- Prefer the smallest required access permissions and enforce them in server configuration.\n\n## Setup and verification\n\n- New project: initialize, configure environment variables, database, storage and Admin route, then run lint, type checking and build.\n- Existing project: read the UI and current content model before proposing collections or globals. Preserve existing content and routes.\n- Existing Dyrected project: read the config first and make schema changes in small, verifiable batches.\n- Self-hosted and Cloud projects can have different schema synchronization and serialization constraints. Confirm the target before advising commands.\n\n## Modeling and migration guidance\n\n- Use `defineGlobal` for one shared settings document and `defineCollection` for repeatable entries.\n- Use `relationship` for the stored owning reference and `join` for a virtual reverse lookup.\n- Use `depth: 0` on lightweight lists; increase depth only when the view needs hydrated relations.\n- Use field hooks for one value and collection hooks for cross-field validation or derived data.\n- Use `workflow: publishingWorkflow()` for capability-controlled draft, review, and publication.\n- Treat collection slugs, field names, block slugs, and public URL patterns as persisted contracts.\n\n### Rename a field safely\n\n```ts\n{\n  name: "fullName",\n  type: "text",\n  label: "Full name",\n  renameTo: "name",\n  defaultValue: "",\n}\n```\n\nKeep `renameTo` until production documents have been migrated and verified.\n\n## Security boundaries\n\n- Admin visibility and conditions are presentation, not authorization or validation.\n- Set ownership and other trusted fields in server hooks; do not trust client-submitted owner or role values.\n- Keep API keys and storage credentials out of browser bundles.\n- Grant destructive operations and workflow capabilities independently.\n- Use `expectedRevision` when workflow transitions can race with another editor.\n\n## Uploads and dynamic options\n\nUse `allowedMimeTypes` and `maxFileSize` for upload collections, consume returned URLs, and validate untrusted file contents. Use server option resolvers for database/secret-backed choices and Admin option hooks only for browser-safe dependent choices.\n\n## Supported field types\n\n<!-- GENERATED:FIELD_TYPES:START -->\n`text`, `textarea`, `richText`, `number`, `boolean`, `date`, `datetime`, `time`, `select`, `multiSelect`, `radio`, `relationship`, `array`, `object`, `json`, `blocks`, `image`, `email`, `url`, `icon`, `join`, `row`\n<!-- GENERATED:FIELD_TYPES:END -->\n\n## Compiled recipes\n\n<!-- GENERATED:RECIPES:START -->\n- [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug) \u2014 Generate stable URL slugs on the server while showing editors the value live in the Admin UI.\n- [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field) \u2014 Use a serializable Admin condition to reveal a field from the editor\'s current form values.\n- [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation) \u2014 Reject invalid combinations of field values before they reach the database.\n- [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown) \u2014 Change available Admin UI options immediately when an editor changes a related field.\n- [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow) \u2014 Attach Dyrected\'s standard editorial workflow and its capability-aware transitions to a collection.\n- [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access) \u2014 Return a where constraint from access control so authenticated users only read their own records.\n- [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks) \u2014 Define labeled hero, rich-text, and call-to-action blocks for an editor-controlled page layout.\n- [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join) \u2014 Store an author relationship on posts and expose the author\'s posts through a virtual join field.\n- [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access) \u2014 Allow public reads, editor writes, and administrator deletion with collection access rules.\n- [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename) \u2014 Use renameTo and a safe default while documents migrate lazily to a new field name.\n- [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection) \u2014 Enable file uploads and capture accessible metadata in a dedicated media collection.\n<!-- GENERATED:RECIPES:END -->\n\n## Intent-to-pattern index\n\n<!-- GENERATED:INTENTS:START -->\n- \u201Cmake the URL follow the title\u201D \u2192 [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug)\n- \u201Cautomatically generate a slug\u201D \u2192 [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug)\n- \u201Ccreate friendly URLs from titles\u201D \u2192 [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug)\n- \u201Ckeep a slug synchronized with a title\u201D \u2192 [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug)\n- \u201Cshow a field conditionally\u201D \u2192 [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field)\n- \u201Chide irrelevant form fields\u201D \u2192 [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field)\n- \u201Cshow discount only with a coupon\u201D \u2192 [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field)\n- \u201Cmake the admin form react to another field\u201D \u2192 [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field)\n- \u201Cvalidate fields before saving\u201D \u2192 [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation)\n- \u201Cmake sure an end date is after the start date\u201D \u2192 [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation)\n- \u201Creject invalid form submissions\u201D \u2192 [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation)\n- \u201Cvalidate multiple fields together\u201D \u2192 [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation)\n- \u201Cmake one dropdown depend on another\u201D \u2192 [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown)\n- \u201Cshow states based on the selected country\u201D \u2192 [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown)\n- \u201Ccreate a cascading dropdown\u201D \u2192 [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown)\n- \u201Cupdate select options while editing\u201D \u2192 [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown)\n- \u201Cadd draft and publish states\u201D \u2192 [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow)\n- \u201Crequire review before publishing\u201D \u2192 [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow)\n- \u201Ccreate an editorial workflow\u201D \u2192 [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow)\n- \u201Clet editors submit content for approval\u201D \u2192 [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow)\n- \u201Cusers should only see their own records\u201D \u2192 [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access)\n- \u201Cadd row level access\u201D \u2192 [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access)\n- \u201Cscope documents by owner\u201D \u2192 [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access)\n- \u201Cprevent users reading another user\'s data\u201D \u2192 [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access)\n- \u201Cbuild a page builder\u201D \u2192 [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks)\n- \u201Clet editors arrange page sections\u201D \u2192 [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks)\n- \u201Ccreate reusable content blocks\u201D \u2192 [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks)\n- \u201Cmodel flexible landing pages\u201D \u2192 [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks)\n- \u201Cconnect posts to authors\u201D \u2192 [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join)\n- \u201Cshow every post written by a user\u201D \u2192 [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join)\n- \u201Ccreate a reverse relationship\u201D \u2192 [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join)\n- \u201Cmodel one-to-many content\u201D \u2192 [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join)\n- \u201Conly editors can update content\u201D \u2192 [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access)\n- \u201Crestrict deletion to admins\u201D \u2192 [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access)\n- \u201Cmake content publicly readable\u201D \u2192 [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access)\n- \u201Cadd role based access\u201D \u2192 [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access)\n- \u201Crename a field safely\u201D \u2192 [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename)\n- \u201Cchange a field name without losing data\u201D \u2192 [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename)\n- \u201Cmigrate an existing schema\u201D \u2192 [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename)\n- \u201Ckeep old documents working after a rename\u201D \u2192 [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename)\n- \u201Clet editors upload images\u201D \u2192 [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection)\n- \u201Ccreate a media library\u201D \u2192 [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection)\n- \u201Cstore uploaded files\u201D \u2192 [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection)\n- \u201Cadd image uploads to my project\u201D \u2192 [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection)\n<!-- GENERATED:INTENTS:END -->\n\n## Canonical references\n\n<!-- GENERATED:REFERENCES:START -->\n- [Configuration](https://docs.dyrected.com/docs/reference/configuration)\n- [Fields and hooks](https://docs.dyrected.com/docs/reference/fields)\n- [Database adapters](https://docs.dyrected.com/docs/adapters/databases)\n- [Storage adapters](https://docs.dyrected.com/docs/adapters/storage)\n- [SDK](https://docs.dyrected.com/docs/reference/sdk)\n- [Workflows](https://docs.dyrected.com/docs/reference/generated-workflows)\n- [REST and OpenAPI](https://docs.dyrected.com/docs/reference/rest-api)\n<!-- GENERATED:REFERENCES:END -->\n\n## Completion checks\n\nRun the repository\'s lint, type-check, tests and build. Confirm generated files are current, configuration fields remain labeled, schema migrations preserve stored data, and authentication/access behavior is enforced server-side.\n';
+var SKILL = '---\nname: dyrected\ndescription: Work correctly with Dyrected in new and existing projects using installation checks, schema safety rules, and compiled implementation recipes.\n---\n\n# Dyrected\n\nDyrected is a declarative, schema-driven headless CMS configured primarily through `dyrected.config.ts`.\n\n## Step 0 \u2014 determine the project state\n\nBefore changing code, inspect the nearest `package.json` and the workspace root.\n\n### Dyrected is not installed\n\nUse the CLI:\n\n```bash\nnpx @dyrected/cli init\n```\n\nDetect the framework, package manager, database requirements, storage requirements and deployment target. Let the CLI scaffold configuration, environment variables, Admin integration and AI rules. Verify lint, types and build before modeling content.\n\nFor an existing website, first inventory editable content and distinguish repeatable entries from singleton settings. Preserve the existing interface, content, URLs and behavior. Do not invent a new content model merely because it is convenient.\n\n### Dyrected is installed\n\nRead `dyrected.config.ts`, the installed `@dyrected/core` version and its public exports. Inspect the configured database, storage, email, collections, globals, authentication and workflows before proposing changes. Installed types take precedence over remembered APIs or newer documentation.\n\n## Operational rules\n\n1. Use public package imports such as `@dyrected/core` and `@dyrected/sdk`; do not reach into another workspace package\'s source directory.\n2. Every named field must define an explicit `label`.\n3. Never invent field types, hook names, configuration keys, adapter methods, SDK methods or REST routes.\n4. Use `client.collection(\'slug\')`, never `client.collections`.\n5. Do not wrap Dyrected Admin routes in custom auth/session middleware.\n6. Do not define `email` or `password` fields on `auth: true` collections; Dyrected injects them.\n7. Do not delete or directly rename persisted fields. Use `renameTo`; add a safe `defaultValue` when introducing fields to existing schemas.\n8. Use server hooks for data correctness. Admin hooks improve live editor feedback but API writes bypass them.\n9. Use serializable Jexl conditions for Cloud-compatible schemas.\n10. Enforce permissions in server access configuration, not only by hiding Admin controls.\n\n## Core imports\n\nImport public APIs from package entry points:\n\n```ts\nimport { defineCollection, defineConfig, defineGlobal } from "@dyrected/core";\nimport { createClient, type InferSchema } from "@dyrected/sdk";\n```\n\nNever import from a monorepo source path such as `packages/core/src`. Verify the installed package exports when documentation and local types disagree.\n\n## Schema and deployment safety\n\n- Read the existing schema before editing it.\n- Make related changes in small batches and verify each batch.\n- Confirm whether the project is Cloud or self-hosted before giving schema synchronization instructions.\n- MongoDB is schema-less; relational adapters may require synchronization for promoted fields.\n- Use `relationship` for the owning stored reference and `join` for a virtual reverse lookup.\n- Use `depth: 0` for lightweight lists and increase depth only when related documents are required.\n- Use hooks for derived values, validation, side effects and revalidation.\n- Use `workflow: publishingWorkflow()` when the requirement is draft, review and publication rather than inventing status logic.\n- Use `defineGlobal` for singleton settings and `defineCollection` for repeatable entries.\n\n### Rename a field safely\n\nThe current `name` is the new key and `renameTo` is the previous stored key:\n\n```ts\n{\n  name: "fullName",\n  type: "text",\n  label: "Full name",\n  renameTo: "name",\n  defaultValue: "",\n}\n```\n\nKeep the fallback until production documents are migrated and verified. For relational adapters, test promoted or unique changes in staging before synchronization.\n\n### Zero-state behavior\n\nUse `initialData` only when deliberate seed/fallback behavior is desired:\n\n```ts\nconst { docs } = await client.collection("posts").find({ initialData: [] });\nconst settings = await client\n  .global("site-settings")\n  .get({ initialData: { siteName: "My site" } });\n```\n\nDo not convert authentication, validation, or network failures into empty successful states.\n\n## Relationships and depth\n\n`relationship` is the stored owning reference. `join` is a virtual reverse lookup.\n\n```ts\n{ name: "author", type: "relationship", label: "Author", relationTo: "users" }\n{\n  name: "posts",\n  type: "join",\n  label: "Posts",\n  collection: "posts",\n  on: "author",\n  limit: 20,\n}\n```\n\nUse `depth: 0` for lightweight lists and increase depth only when related values are needed. Bound joins and account for their query cost.\n\n## Auth and access\n\n`auth: true` injects authentication fields and endpoints. Do not redefine `email` or `password`. Treat roles as trusted only when clients cannot assign them to themselves.\n\n```ts\nexport const Users = defineCollection({\n  slug: "users",\n  auth: true,\n  fields: [\n    { name: "name", type: "text", label: "Name" },\n    {\n      name: "role",\n      type: "select",\n      label: "Role",\n      options: ["member", "editor", "admin"],\n    },\n  ],\n});\n```\n\nGrant read, create, update, delete, and workflow capabilities independently. UI visibility is not authorization.\n\n## Uploads\n\n```ts\nexport const Media = defineCollection({\n  slug: "media",\n  upload: {\n    allowedMimeTypes: ["image/jpeg", "image/png", "image/webp"],\n    maxFileSize: 5_000_000,\n  },\n  fields: [\n    { name: "alt", type: "text", label: "Alternative text", required: true },\n  ],\n});\n```\n\nConsume the returned URL, keep provider credentials server-side, and validate untrusted file contents in addition to MIME metadata.\n\n## Dynamic and conditional fields\n\n- Static `options`: fixed choices.\n- Server `options` resolver: database access, secrets, user filtering, or caching.\n- `admin.hooks.options`: instant browser-only dependent choices.\n- `admin.condition`: presentation only; use Jexl strings for Cloud synchronization.\n\nServer validation is still required when a dependent choice or condition is part of the data contract.\n\n## Custom Admin components\n\nReference custom inputs and slots with registered string keys in serializable configuration. Register the actual framework component in the Admin integration. Keep validation and access in the server field definition.\n\n## Supported field types\n\n<!-- GENERATED:FIELD_TYPES:START -->\n`text`, `textarea`, `richText`, `number`, `boolean`, `date`, `datetime`, `time`, `select`, `multiSelect`, `radio`, `relationship`, `array`, `object`, `json`, `blocks`, `image`, `email`, `url`, `icon`, `join`, `row`\n<!-- GENERATED:FIELD_TYPES:END -->\n\n## Compiled recipes\n\nThese recipes are compiled and behavior-tested. Select them from the user\'s desired outcome; do not require the user to know Dyrected terminology.\n\n<!-- GENERATED:RECIPES:START -->\n- [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug) \u2014 Generate stable URL slugs on the server while showing editors the value live in the Admin UI.\n- [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field) \u2014 Use a serializable Admin condition to reveal a field from the editor\'s current form values.\n- [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation) \u2014 Reject invalid combinations of field values before they reach the database.\n- [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown) \u2014 Change available Admin UI options immediately when an editor changes a related field.\n- [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow) \u2014 Attach Dyrected\'s standard editorial workflow and its capability-aware transitions to a collection.\n- [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access) \u2014 Return a where constraint from access control so authenticated users only read their own records.\n- [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks) \u2014 Define labeled hero, rich-text, and call-to-action blocks for an editor-controlled page layout.\n- [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join) \u2014 Store an author relationship on posts and expose the author\'s posts through a virtual join field.\n- [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access) \u2014 Allow public reads, editor writes, and administrator deletion with collection access rules.\n- [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename) \u2014 Use renameTo and a safe default while documents migrate lazily to a new field name.\n- [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection) \u2014 Enable file uploads and capture accessible metadata in a dedicated media collection.\n<!-- GENERATED:RECIPES:END -->\n\n## Intent-to-pattern index\n\n<!-- GENERATED:INTENTS:START -->\n- \u201Cmake the URL follow the title\u201D \u2192 [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug)\n- \u201Cautomatically generate a slug\u201D \u2192 [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug)\n- \u201Ccreate friendly URLs from titles\u201D \u2192 [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug)\n- \u201Ckeep a slug synchronized with a title\u201D \u2192 [Generate a slug from a title](https://docs.dyrected.com/docs/recipes/auto-slug)\n- \u201Cshow a field conditionally\u201D \u2192 [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field)\n- \u201Chide irrelevant form fields\u201D \u2192 [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field)\n- \u201Cshow discount only with a coupon\u201D \u2192 [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field)\n- \u201Cmake the admin form react to another field\u201D \u2192 [Show an Admin field only when it is relevant](https://docs.dyrected.com/docs/recipes/conditional-admin-field)\n- \u201Cvalidate fields before saving\u201D \u2192 [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation)\n- \u201Cmake sure an end date is after the start date\u201D \u2192 [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation)\n- \u201Creject invalid form submissions\u201D \u2192 [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation)\n- \u201Cvalidate multiple fields together\u201D \u2192 [Validate related fields before saving](https://docs.dyrected.com/docs/recipes/cross-field-validation)\n- \u201Cmake one dropdown depend on another\u201D \u2192 [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown)\n- \u201Cshow states based on the selected country\u201D \u2192 [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown)\n- \u201Ccreate a cascading dropdown\u201D \u2192 [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown)\n- \u201Cupdate select options while editing\u201D \u2192 [Update a dropdown from another field](https://docs.dyrected.com/docs/recipes/dependent-dropdown)\n- \u201Cadd draft and publish states\u201D \u2192 [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow)\n- \u201Crequire review before publishing\u201D \u2192 [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow)\n- \u201Ccreate an editorial workflow\u201D \u2192 [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow)\n- \u201Clet editors submit content for approval\u201D \u2192 [Add draft, review, and publishing states](https://docs.dyrected.com/docs/recipes/editorial-publishing-workflow)\n- \u201Cusers should only see their own records\u201D \u2192 [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access)\n- \u201Cadd row level access\u201D \u2192 [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access)\n- \u201Cscope documents by owner\u201D \u2192 [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access)\n- \u201Cprevent users reading another user\'s data\u201D \u2192 [Limit documents to their owner](https://docs.dyrected.com/docs/recipes/owner-scoped-access)\n- \u201Cbuild a page builder\u201D \u2192 [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks)\n- \u201Clet editors arrange page sections\u201D \u2192 [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks)\n- \u201Ccreate reusable content blocks\u201D \u2192 [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks)\n- \u201Cmodel flexible landing pages\u201D \u2192 [Build flexible pages from reusable blocks](https://docs.dyrected.com/docs/recipes/page-builder-blocks)\n- \u201Cconnect posts to authors\u201D \u2192 [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join)\n- \u201Cshow every post written by a user\u201D \u2192 [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join)\n- \u201Ccreate a reverse relationship\u201D \u2192 [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join)\n- \u201Cmodel one-to-many content\u201D \u2192 [Model a relationship and its reverse lookup](https://docs.dyrected.com/docs/recipes/relationship-and-reverse-join)\n- \u201Conly editors can update content\u201D \u2192 [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access)\n- \u201Crestrict deletion to admins\u201D \u2192 [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access)\n- \u201Cmake content publicly readable\u201D \u2192 [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access)\n- \u201Cadd role based access\u201D \u2192 [Restrict content operations by user role](https://docs.dyrected.com/docs/recipes/role-based-access)\n- \u201Crename a field safely\u201D \u2192 [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename)\n- \u201Cchange a field name without losing data\u201D \u2192 [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename)\n- \u201Cmigrate an existing schema\u201D \u2192 [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename)\n- \u201Ckeep old documents working after a rename\u201D \u2192 [Rename a field without orphaning existing data](https://docs.dyrected.com/docs/recipes/safe-field-rename)\n- \u201Clet editors upload images\u201D \u2192 [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection)\n- \u201Ccreate a media library\u201D \u2192 [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection)\n- \u201Cstore uploaded files\u201D \u2192 [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection)\n- \u201Cadd image uploads to my project\u201D \u2192 [Create a media upload collection](https://docs.dyrected.com/docs/recipes/upload-collection)\n<!-- GENERATED:INTENTS:END -->\n\n## Generated contract map\n\n<!-- GENERATED:REFERENCES:START -->\n- [Configuration](https://docs.dyrected.com/docs/reference/configuration)\n- [Fields and hooks](https://docs.dyrected.com/docs/reference/fields)\n- [Database adapters](https://docs.dyrected.com/docs/adapters/databases)\n- [Storage adapters](https://docs.dyrected.com/docs/adapters/storage)\n- [SDK](https://docs.dyrected.com/docs/reference/sdk)\n- [Workflows](https://docs.dyrected.com/docs/reference/generated-workflows)\n- [REST and OpenAPI](https://docs.dyrected.com/docs/reference/rest-api)\n<!-- GENERATED:REFERENCES:END -->\n\n## Work sequence\n\n1. Inspect installation, versions, framework and existing configuration.\n2. Translate the plain-language outcome into the matching recipe or documented contract.\n3. Implement no more than three related collections or globals in one batch.\n4. Keep every field labeled and preserve stored data during schema evolution.\n5. Run lint, types, focused tests and build; fix failures before expanding scope.\n6. Explain decisions in the user\'s language. Do not ask them to choose between technical CMS concepts when the intent determines the correct pattern.\n\n## Troubleshooting\n\n- Missing export: inspect the installed package version; do not substitute an internal source import.\n- Admin route failure: remove custom auth wrappers and verify the framework integration generated by the CLI.\n- Empty frontend: provide an intentional zero-state or SDK `initialData` fallback.\n- Relationship payload too large: lower query depth.\n- Cloud condition missing: replace callback conditions with Jexl strings.\n- Existing records fail after a schema change: restore the old key through `renameTo` and add a compatible default.\n\n## Completion checklist\n\n- Installed package APIs were verified.\n- Existing configuration and content were inspected.\n- Named fields have labels.\n- Access and auth are server-enforced.\n- Migrations preserve existing data.\n- Generated knowledge is current.\n- Lint, type checking, tests and build pass.\n';
+function buildAiRules() {
+  return AI_RULES;
+}
+
+// src/index.ts
+function findRecipesByIntent2(query, options) {
+  return findRecipesByIntent(query, recipes, options);
+}
+function getRecipe(id) {
+  return recipes.find((recipe) => recipe.id === id);
+}
+function getReference(id) {
+  return references.find((reference) => reference.id === id);
+}
+function getEndpoint(method, path) {
+  return endpoints.find(
+    (endpoint) => endpoint.method === method.toUpperCase() && endpoint.path === path
+  );
+}
+export {
+  AI_RULES,
+  SKILL,
+  buildAiRules,
+  endpoints,
+  findRecipesByIntent2 as findRecipesByIntent,
+  getEndpoint,
+  getRecipe,
+  getReference,
+  recipes,
+  references
+};