@dyrected/core 2.5.53 → 2.5.55

package/dist/app-config-BLMX-9MN.d.cts

@@ -1,1045 +0,0 @@
-import { icons } from 'lucide-react';
-
-/**
- * Minimum HTTP request context passed to every server-side hook and resolver.
- *
- * The full Web Standard `Request` is available as `raw` when you need it, but
- * most hooks only need `query` (URL search parameters).
- */
-interface HookRequestContext {
-    /** Parsed URL query-string parameters, e.g. `{ page: '2', search: 'hello' }`. */
-    query: Record<string, string>;
-    /** Incoming HTTP headers, lowercased. */
-    headers: Record<string, string>;
-    /** The raw Web Standard `Request` object. Useful for streaming or advanced header inspection. */
-    raw?: Request;
-}
-/**
- * Base shape of an authenticated user as decoded from the JWT.
- *
- * The actual shape will include every field on your auth collection — this
- * interface only guarantees the properties that Dyrected always stamps on the
- * token. Extend it in your own codebase for stronger typing:
- *
- * @example
- * declare module '@dyrected/core' {
- *   interface AuthenticatedUser {
- *     role: 'admin' | 'editor'
- *     organizationId: string
- *   }
- * }
- */
-interface AuthenticatedUser {
-    /** The user's document ID in the database. */
-    sub: string;
-    /** The user's email address. */
-    email?: string;
-    /** Slug of the collection this user was authenticated against. */
-    collection: string;
-    /** Array of role strings, if your auth collection has a `roles` field. */
-    roles?: string[];
-    /** Any additional fields from the auth collection document. */
-    [key: string]: unknown;
-}
-
-/**
- * A function that determines whether the current user can perform an operation.
- *
- * Return `true` to allow, `false` to deny.
- * Return a `where`-style object to allow access only to matching documents
- * (useful for multi-tenant setups where users can only see their own data).
- *
- * Can also be expressed as a Jexl expression **string** for simple role checks
- * that need to be serialised (e.g. stored in the database or sent to the Admin UI).
- *
- * @template TDoc  The shape of the collection's document.
- *
- * @example
- * // Simple role check
- * access: {
- *   delete: ({ user }) => user?.roles?.includes('admin') ?? false,
- * }
- *
- * @example
- * // Row-level: users can only read their own documents
- * access: {
- *   read: ({ user }) => ({ owner: { equals: user?.sub } }),
- * }
- *
- * @example
- * // Jexl string — evaluated server-side
- * access: {
- *   update: "user.roles contains 'editor'",
- * }
- */
-type AccessFunction<TDoc extends object = Record<string, unknown>> = (args: {
-    user: AuthenticatedUser | undefined;
-    doc?: TDoc;
-    data?: Partial<TDoc>;
-    req: HookRequestContext;
-}) => boolean | Record<string, unknown> | Promise<boolean | Record<string, unknown>>;
-
-/**
- * The minimum shape of every document returned by the database layer.
- *
- * All documents have an `id` field assigned by the adapter. Additional fields
- * are stored as `unknown` until you narrow them with your own interface.
- *
- * Use this as the base when declaring your collection document types:
- * ```ts
- * interface Post extends BaseDocument {
- *   title: string
- *   slug: string
- * }
- * ```
- */
-interface BaseDocument {
-    /** The document's unique identifier, assigned by the database adapter. */
-    id: string;
-    [key: string]: any;
-}
-/**
- * The envelope returned by collection list endpoints (`GET /api/collections/:slug`).
- *
- * @template T  The document type.
- */
-interface PaginatedResult<T = Record<string, any>> {
-    /** The documents on the current page. */
-    docs: T[];
-    /** Total number of documents matching the query (across all pages). */
-    total: number;
-    /** Maximum number of documents per page as requested. */
-    limit: number;
-    /** The current page number (1-indexed). */
-    page: number;
-    /** Total number of pages given the current `limit`. */
-    totalPages: number;
-    /** Whether a next page exists. */
-    hasNextPage: boolean;
-    /** Whether a previous page exists. */
-    hasPrevPage: boolean;
-}
-/**
- * Metadata returned after a file is uploaded and stored.
- * Stored on the document in upload collections.
- */
-interface FileData {
-    filename: string;
-    filesize?: number;
-    mimeType: string;
-    /** Public URL of the stored file. */
-    url: string;
-    width?: number;
-    height?: number;
-    focalPoint?: {
-        x: number;
-        y: number;
-    };
-    /** Base64-encoded BlurHash string for progressive image loading. */
-    blurhash?: string;
-    /** `'upload'` for server-stored files; `'external'` for provider-managed files. */
-    type?: "upload" | "external";
-    provider?: string;
-    provider_metadata?: unknown;
-    [key: string]: unknown;
-}
-
-/** A valid icon component name from the Lucide icon set bundled with Dyrected Admin. */
-type AdminIconName = keyof typeof icons;
-/** Ordered custom component keys rendered around the built-in Admin dashboard. */
-interface AdminDashboardComponentSlots {
-    beforeDashboard?: string[];
-    afterDashboard?: string[];
-}
-/** Ordered custom component keys rendered around a collection's list content. */
-interface CollectionListComponentSlots {
-    beforeList?: string[];
-    beforeListTable?: string[];
-    afterListTable?: string[];
-    afterList?: string[];
-}
-/**
- * Branding and metadata options for the Dyrected Admin UI.
- *
- * @example
- * admin: {
- *   branding: {
- *     logo: '/logo.svg',
- *     primaryColor: '#6366f1',
- *   },
- *   meta: {
- *     titleSuffix: '- My App',
- *   },
- * }
- */
-interface AdminConfig {
-    /** Custom component slots around the built-in dashboard. */
-    components?: AdminDashboardComponentSlots;
-    branding?: {
-        /** Full logo image shown in the expanded sidebar. URL or imported image asset. */
-        logo?: string;
-        /** Compact logo mark used in the collapsed sidebar state. */
-        logoMark?: string;
-        /** Text alternative or addition to the logo image. */
-        logoText?: string;
-        /**
-         * Primary accent colour as any CSS colour value.
-         * @example '#6366f1'
-         * @example 'hsl(240 50% 60%)'
-         */
-        primaryColor?: string;
-        /** Browser tab favicon URL. */
-        favicon?: string;
-        /** Font family for body and UI text. Must be loaded separately. */
-        fontSans?: string;
-        /** Font family for headings. Must be loaded separately. */
-        fontSerif?: string;
-    };
-    meta?: {
-        /**
-         * String appended to every Admin page's `<title>`.
-         * @default '- Dyrected'
-         */
-        titleSuffix?: string;
-    };
-}
-
-type FieldType = "text" | "textarea" | "richText" | "number" | "boolean" | "date" | "datetime" | "time" | "select" | "multiSelect" | "radio" | "relationship" | "array" | "object" | "json" | "blocks" | "image" | "email" | "url" | "icon" | "join" | "row";
-interface DynamicOptionsResolverArgs {
-    /** Database adapter available to server-side option resolvers. */
-    db?: DatabaseAdapter;
-    /** Authenticated user making the request, if any. */
-    user?: AuthenticatedUser;
-    /** Current HTTP request context, including query parameters. */
-    req: HookRequestContext;
-}
-type DynamicOptionsResolver = (args: DynamicOptionsResolverArgs) => Promise<DynamicOptionItem[]> | DynamicOptionItem[];
-interface DynamicOptionsConfig {
-    /** Resolver function executed on the server to produce option items. */
-    resolve: DynamicOptionsResolver;
-    /** Cache duration in seconds for identical resolver calls. */
-    cacheTTL?: number;
-}
-type DynamicOptionItem = string | {
-    label: string;
-    value: unknown;
-};
-interface Block {
-    /** Stable identifier stored in each block row as `blockType`. */
-    slug: string;
-    /** Human-readable labels shown in the Admin block picker. */
-    labels?: {
-        /** Singular label, for example `Hero`. */
-        singular: string;
-        /** Plural label, for example `Heroes`. */
-        plural: string;
-    };
-    /** Fields that make up this block's payload. */
-    fields: Field[];
-}
-interface FieldBase {
-    /** Stored key for this field. Omit only for layout-only fields such as `row` or `join`. */
-    name?: string;
-    /** Human-readable label shown in the Admin UI. */
-    label?: string;
-    /** Whether the field must have a value when saving. */
-    required?: boolean;
-    /** Whether values for this field must be unique across the collection. */
-    unique?: boolean;
-    /** Default value used when a new document omits this field. */
-    defaultValue?: unknown;
-    /** Static or dynamic option source for supported selection fields. */
-    options?: string[] | {
-        label: string;
-        value: unknown;
-    }[] | DynamicOptionsResolver | DynamicOptionsConfig;
-    /** Target collection slug for `relationship` fields. */
-    relationTo?: string;
-    /** Whether the field stores multiple values instead of one. */
-    hasMany?: boolean;
-    /** Child fields for `object` and `array` field types. */
-    fields?: Field[];
-    /** Allowed block definitions for a `blocks` field. */
-    blocks?: Block[];
-    /** Target collection slug for `join` fields. */
-    collection?: string;
-    /** Back-reference field name on the joined collection. */
-    on?: string;
-    /** Maximum number of joined documents returned by a `join` field. */
-    limit?: number;
-    /** Field-level read and update access rules. */
-    access?: {
-        /** Controls whether this field is returned in API responses. */
-        read?: AccessFunction | string;
-        /** Controls whether incoming writes may change this field. */
-        update?: AccessFunction | string;
-    };
-    /** Admin-only presentation options for this field. */
-    admin?: BaseFieldAdmin;
-    /** Previous storage key to migrate from during schema sync. */
-    renameTo?: string;
-    /** Whether SQL adapters should promote this field into a first-class column. */
-    promoted?: boolean;
-}
-interface BaseFieldAdmin {
-    /** Placeholder text shown when the input has no value. */
-    placeholder?: string;
-    /** Custom component key registered in the Admin UI. */
-    component?: string;
-    /** Help text rendered below the field. */
-    description?: string;
-    /** Hides the field from the Admin form without deleting stored data. */
-    hidden?: boolean;
-    /** Excludes the field from Admin list filtering. */
-    filterable?: boolean;
-    /** Renders the field as non-editable in the Admin UI. */
-    readOnly?: boolean;
-    /** Reactive condition controlling whether the field is visible in the Admin UI. */
-    condition?: ((data: Record<string, unknown>, siblingData: Record<string, unknown>) => boolean) | string;
-    /** Tab name used when the edit form is rendered as tabs. */
-    tab?: string;
-    /** CSS width hint used when the field appears inside a `row`. */
-    width?: string;
-}
-interface FieldBeforeChangeHookArgs<TValue = unknown, TDoc extends object = Record<string, unknown>> {
-    /** Current field value after previous hooks in the chain. */
-    value: TValue;
-    /** Existing stored document before the write, if this is an update. */
-    originalDoc?: TDoc;
-    /** Full incoming payload being written. */
-    data: Record<string, unknown>;
-    /** Authenticated user performing the write, if any. */
-    user?: AuthenticatedUser;
-    /** Read-only database adapter for related lookups. */
-    db: ReadonlyDatabaseAdapter;
-}
-type FieldBeforeChangeHook<TValue = unknown, TDoc extends object = Record<string, unknown>> = (args: FieldBeforeChangeHookArgs<TValue, TDoc>) => unknown;
-interface FieldAfterReadHookArgs<TValue = unknown, TDoc extends object = Record<string, unknown>> {
-    /** Raw stored field value before this hook transforms it. */
-    value: TValue;
-    /** Full document currently being returned to the caller. */
-    doc: TDoc;
-    /** Authenticated user requesting the document, if any. */
-    user?: AuthenticatedUser;
-    /** Read-only database adapter for related lookups. */
-    db: ReadonlyDatabaseAdapter;
-}
-type FieldAfterReadHook<TValue = unknown, TDoc extends object = Record<string, unknown>> = (args: FieldAfterReadHookArgs<TValue, TDoc>) => unknown;
-type FieldHooks<TValue> = {
-    hooks?: {
-        beforeChange?: Array<FieldBeforeChangeHook<TValue>>;
-        afterRead?: Array<FieldAfterReadHook<TValue>>;
-    };
-};
-interface FieldAdminOnChangeHookArgs<TValue = unknown> {
-    /** Current field value in the form state. */
-    value: TValue;
-    /** Current values for sibling fields at the same nesting level. */
-    siblingData: Record<string, unknown>;
-    /** Current values for the entire form. */
-    data: Record<string, unknown>;
-    /** Imperative setter for async or derived updates. */
-    setValue: (value: unknown) => void;
-}
-type FieldAdminOnChangeHook<TValue = unknown> = (args: FieldAdminOnChangeHookArgs<TValue>) => unknown;
-type FieldAdminHooks<TValue> = {
-    admin?: {
-        hooks?: {
-            onChange?: FieldAdminOnChangeHook<TValue>;
-        };
-    };
-};
-interface FieldAdminOptionsHookArgs {
-    /** Current values for sibling fields at the same nesting level. */
-    siblingData: Record<string, unknown>;
-    /** Current values for the entire form. */
-    data: Record<string, unknown>;
-}
-type FieldAdminOptionsHookResult = Array<string | {
-    label: string;
-    value: unknown;
-}>;
-type FieldAdminOptionsHook = (args: FieldAdminOptionsHookArgs) => FieldAdminOptionsHookResult | Promise<FieldAdminOptionsHookResult>;
-type TypedField<TType extends FieldType, TValue, TAdminExtra = Record<never, never>> = Omit<FieldBase, "admin"> & {
-    type: TType;
-    admin?: BaseFieldAdmin & TAdminExtra;
-} & FieldHooks<TValue> & FieldAdminHooks<TValue>;
-type BooleanFieldAdmin = {
-    /** Boolean presentation style. */
-    layout?: "checkbox" | "switch";
-};
-type SelectFieldAdmin = {
-    /** Select presentation style. */
-    layout?: "radio" | "select";
-    /** Radio orientation when `layout: 'radio'` is used. */
-    direction?: "horizontal" | "vertical";
-    hooks?: {
-        /** Client-side option recalculation for dependent dropdowns or radios. */
-        options?: FieldAdminOptionsHook;
-    };
-};
-type RadioFieldAdmin = {
-    /** Radio group orientation. */
-    direction?: "horizontal" | "vertical";
-    hooks?: {
-        /** Client-side option recalculation for dependent radio groups. */
-        options?: FieldAdminOptionsHook;
-    };
-};
-type MultiSelectFieldAdmin = {
-    hooks?: {
-        /** Client-side option recalculation for dependent multi-select fields. */
-        options?: FieldAdminOptionsHook;
-    };
-};
-interface CharacterLimitFieldConfig {
-    /** Advisory maximum character count exposed to editors and client tooling. */
-    maxLength?: number;
-}
-interface WordLimitFieldConfig {
-    /** Advisory maximum word count exposed to editors and client tooling. */
-    maxWords?: number;
-}
-type CharacterLimitFieldAdmin = {
-    /** Admin-only compatibility alias for `field.maxLength`. Prefer the top-level field property. */
-    maxLength?: number;
-};
-type WordLimitFieldAdmin = {
-    /** Admin-only compatibility alias for `field.maxWords`. Prefer the top-level field property. */
-    maxWords?: number;
-};
-type TextFieldAdmin = CharacterLimitFieldAdmin & WordLimitFieldAdmin;
-type TextareaFieldAdmin = CharacterLimitFieldAdmin & WordLimitFieldAdmin;
-type EmailFieldAdmin = CharacterLimitFieldAdmin;
-type UrlFieldAdmin = CharacterLimitFieldAdmin;
-type IconFieldAdmin = CharacterLimitFieldAdmin;
-type TextField = TypedField<"text", string, TextFieldAdmin> & CharacterLimitFieldConfig & WordLimitFieldConfig;
-type TextareaField = TypedField<"textarea", string, TextareaFieldAdmin> & CharacterLimitFieldConfig & WordLimitFieldConfig;
-type EmailField = TypedField<"email", string, EmailFieldAdmin> & CharacterLimitFieldConfig;
-type UrlField = TypedField<"url", string, UrlFieldAdmin> & CharacterLimitFieldConfig;
-type IconField = TypedField<"icon", string, IconFieldAdmin> & CharacterLimitFieldConfig;
-type DateField = TypedField<"date", string>;
-type DateTimeField = TypedField<"datetime", string>;
-type TimeField = TypedField<"time", string>;
-type SelectField = TypedField<"select", string, SelectFieldAdmin>;
-type RadioField = TypedField<"radio", string, RadioFieldAdmin>;
-type NumberField = TypedField<"number", number>;
-type BooleanField = TypedField<"boolean", boolean, BooleanFieldAdmin>;
-type MultiSelectField = TypedField<"multiSelect", string[], MultiSelectFieldAdmin>;
-type RelationshipField = TypedField<"relationship", string | string[]>;
-type ImageField = TypedField<"image", string | string[]>;
-type RichTextField = TypedField<"richText", Record<string, unknown>>;
-type JsonField = TypedField<"json", Record<string, unknown>>;
-type ObjectField = TypedField<"object", unknown>;
-type ArrayField = TypedField<"array", unknown>;
-type BlocksField = TypedField<"blocks", unknown>;
-type JoinField = TypedField<"join", unknown>;
-type RowField = TypedField<"row", unknown>;
-type Field = TextField | TextareaField | EmailField | UrlField | IconField | DateField | DateTimeField | TimeField | SelectField | RadioField | NumberField | BooleanField | MultiSelectField | RelationshipField | ImageField | RichTextField | JsonField | ObjectField | ArrayField | BlocksField | JoinField | RowField;
-interface UploadConfig {
-    /** Allowed MIME types for uploaded files. */
-    allowedMimeTypes?: string[];
-    /** Maximum upload size in bytes. */
-    maxFileSize?: number;
-    /** Local filesystem destination used by disk-based storage adapters. */
-    staticDir?: string;
-    /** Public URL prefix for disk-based uploads. */
-    staticURL?: string;
-    /** Generated image size name used as the Admin media thumbnail. */
-    adminThumbnail?: string;
-    imageSizes?: {
-        /** Stable name used to reference this generated size. */
-        name: string;
-        /** Target width in pixels. */
-        width?: number;
-        /** Target height in pixels. */
-        height?: number;
-        /** Crop strategy forwarded to the image processor. */
-        crop?: string;
-        /** Resize fit strategy forwarded to the image processor. */
-        fit?: string;
-        /** Prevents upscaling smaller source images. */
-        withoutEnlargement?: boolean;
-        /** Format-specific options forwarded to the image processor. */
-        formatOptions?: Record<string, unknown>;
-    }[];
-}
-
-/**
- * @deprecated Use {@link FieldBeforeChangeHook} or `FieldAfterReadHook` instead.
- * This alias remains for backwards compatibility.
- */
-type FieldHook<TDoc extends object = Record<string, unknown>, TValue = unknown> = FieldBeforeChangeHook<TValue, TDoc>;
-/**
- * Runs before Dyrected queries the database for a list or single-document fetch.
- *
- * Return a new `where` query object to override or extend the current filter.
- * Return `undefined` (or nothing) to leave the query unchanged.
- */
-type CollectionBeforeReadHook = (args: {
-    req: HookRequestContext;
-    query?: Record<string, unknown>;
-    user?: AuthenticatedUser;
-    db: ReadonlyDatabaseAdapter;
-}) => Record<string, unknown> | void | Promise<Record<string, unknown> | void>;
-/**
- * Runs after a document (or list of documents) is fetched from the database,
- * before the response is sent to the client.
- */
-type CollectionAfterReadHook<TDoc extends object = Record<string, unknown>> = (args: {
-    doc: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    db: ReadonlyDatabaseAdapter;
-}) => TDoc | Promise<TDoc>;
-/**
- * Runs **before** a document is created or updated in the database.
- */
-type CollectionBeforeChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
-    data: Partial<TDoc>;
-    doc?: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    operation: "create" | "update";
-    db: ReadonlyDatabaseAdapter;
-}) => Partial<TDoc> | void | Promise<Partial<TDoc> | void>;
-/**
- * Runs **after** a document is created or updated in the database.
- */
-type CollectionAfterChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
-    doc: TDoc;
-    previousDoc?: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    operation: "create" | "update";
-    db: DatabaseAdapter;
-}) => void | Promise<void>;
-/**
- * Runs **before** a document is deleted from the database.
- */
-type CollectionBeforeDeleteHook<TDoc extends object = Record<string, unknown>> = (args: {
-    id: string;
-    doc: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    db: ReadonlyDatabaseAdapter;
-}) => void | Promise<void>;
-/**
- * Runs **after** a document has been deleted from the database.
- */
-type CollectionAfterDeleteHook<TDoc extends object = Record<string, unknown>> = (args: {
-    id: string;
-    doc: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    db: DatabaseAdapter;
-}) => void | Promise<void>;
-/** @see {@link CollectionBeforeReadHook} */
-type GlobalBeforeReadHook = CollectionBeforeReadHook;
-/**
- * Runs after the global document is fetched, before the response is sent.
- */
-type GlobalAfterReadHook<TDoc extends object = Record<string, unknown>> = (args: {
-    doc: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    db: ReadonlyDatabaseAdapter;
-}) => TDoc | Promise<TDoc>;
-/**
- * Runs before the global document is updated.
- * Operation is always `'update'` (globals cannot be created or deleted).
- */
-type GlobalBeforeChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
-    data: Partial<TDoc>;
-    doc?: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    operation: "update";
-    db: ReadonlyDatabaseAdapter;
-}) => Partial<TDoc> | void | Promise<Partial<TDoc> | void>;
-/**
- * Runs after the global document is updated. Side-effects only.
- */
-type GlobalAfterChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
-    doc: TDoc;
-    previousDoc?: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    operation: "update";
-    db: DatabaseAdapter;
-}) => void | Promise<void>;
-/**
- * @deprecated Use the specific hook types instead:
- * `CollectionBeforeChangeHook`, `CollectionAfterReadHook`, etc.
- *
- * This broad type remains for backwards compatibility with the internal hook runner.
- */
-type HookFunction<TDoc extends object = Record<string, unknown>> = (args: {
-    data?: Partial<TDoc>;
-    doc?: TDoc;
-    user?: AuthenticatedUser;
-    req?: HookRequestContext;
-    operation?: "create" | "update" | "delete";
-    db?: DatabaseAdapter;
-    [key: string]: unknown;
-}) => unknown | Promise<unknown>;
-
-declare const LIFECYCLE_EVENT_NAMES: readonly ["revision.created", "workflow.transitioned", "entry.published", "entry.unpublished"];
-type LifecycleEventName = (typeof LIFECYCLE_EVENT_NAMES)[number];
-interface WorkflowState {
-    /** Stable machine-readable state key. */
-    name: string;
-    /** Label rendered in the Admin UI. */
-    label: string;
-    /** Marks the state whose revision is visible to public readers. */
-    published?: boolean;
-    /** Optional visual tone used by the Admin UI. */
-    color?: "neutral" | "warning" | "success" | "danger" | "info";
-}
-interface WorkflowTransition {
-    /** Stable transition key used by the REST and SDK APIs. */
-    name: string;
-    label: string;
-    from: string | string[];
-    to: string;
-    /** Every listed capability is required. */
-    requiredCapabilities?: string[];
-    /** Require a non-empty comment when performing the transition. */
-    requireComment?: boolean;
-    /** Remove the public snapshot after this transition commits. */
-    unpublish?: boolean;
-}
-interface WorkflowRole {
-    /** Existing user role value, for example `editor` or `publisher`. */
-    role: string;
-    capabilities: string[];
-}
-interface WorkflowConfig<TDoc extends object = Record<string, unknown>> {
-    initialState: string;
-    /** State used for a new working revision created from published content. */
-    draftState?: string;
-    states: WorkflowState[];
-    transitions: WorkflowTransition[];
-    /** Maps values in `user.roles` to workflow capabilities. */
-    roles?: WorkflowRole[];
-    hooks?: {
-        beforeTransition?: CollectionBeforeTransitionHook<TDoc>[];
-        afterTransition?: CollectionAfterTransitionHook<TDoc>[];
-    };
-}
-interface WorkflowMetadata {
-    state: string;
-    revision: number;
-    publishedRevision?: number;
-    publishedAt?: string;
-    publishedBy?: string;
-    /** Transitions currently allowed for the requesting user. Response-only. */
-    availableTransitions?: string[];
-}
-interface WorkflowTransitionContext<TDoc extends object = Record<string, unknown>> {
-    transition: WorkflowTransition;
-    from: string;
-    to: string;
-    doc: TDoc;
-    user?: AuthenticatedUser;
-    comment?: string;
-    req: HookRequestContext;
-    db: DatabaseAdapter;
-}
-type CollectionBeforeTransitionHook<TDoc extends object = Record<string, unknown>> = (args: WorkflowTransitionContext<TDoc>) => void | Promise<void>;
-type CollectionAfterTransitionHook<TDoc extends object = Record<string, unknown>> = (args: WorkflowTransitionContext<TDoc> & {
-    event: LifecycleEvent;
-}) => void | Promise<void>;
-interface LifecycleEvent<TPayload = Record<string, unknown>> {
-    id: string;
-    name: LifecycleEventName;
-    collection: string;
-    documentId: string;
-    occurredAt: string;
-    actorId?: string;
-    payload: TPayload;
-    attempts: number;
-    status: "pending" | "processing" | "delivered" | "failed";
-    nextAttemptAt?: string;
-    deliveredAt?: string;
-    lastError?: string;
-}
-type LifecycleEventHandler = (event: LifecycleEvent) => void | Promise<void>;
-
-/**
- * Defines a Dyrected collection — a named set of documents with a shared schema.
- *
- * Pass your document's TypeScript type as the generic parameter `TDoc` to get
- * fully typed hooks and access functions.
- */
-interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
-    slug: string;
-    siteId?: string;
-    shared?: boolean;
-    labels?: {
-        singular: string;
-        plural: string;
-    };
-    auth?: boolean;
-    upload?: boolean | UploadConfig;
-    fields: Field[];
-    timestamps?: boolean;
-    initialData?: Partial<TDoc>[];
-    audit?: boolean;
-    workflow?: WorkflowConfig<TDoc>;
-    access?: {
-        read?: AccessFunction<TDoc> | string;
-        create?: AccessFunction<TDoc> | string;
-        update?: AccessFunction<TDoc> | string;
-        delete?: AccessFunction<TDoc> | string;
-    };
-    hooks?: {
-        beforeRead?: CollectionBeforeReadHook[];
-        afterRead?: CollectionAfterReadHook<TDoc>[];
-        beforeChange?: CollectionBeforeChangeHook<TDoc>[];
-        afterChange?: CollectionAfterChangeHook<TDoc>[];
-        beforeDelete?: CollectionBeforeDeleteHook<TDoc>[];
-        afterDelete?: CollectionAfterDeleteHook<TDoc>[];
-    };
-    admin?: {
-        icon?: AdminIconName;
-        components?: CollectionListComponentSlots;
-        useAsTitle?: string;
-        defaultColumns?: string[];
-        group?: string;
-        hidden?: boolean;
-        filterable?: boolean;
-        previewUrl?: string | ((doc: TDoc, opts: {
-            locale?: string;
-        }) => string | null);
-        previewMode?: "postMessage" | "token";
-        urlPattern?: string;
-    };
-}
-/**
- * Defines a Dyrected global — a singleton document without pagination or IDs.
- */
-interface GlobalConfig<TDoc extends object = Record<string, unknown>> {
-    slug: string;
-    siteId?: string;
-    shared?: boolean;
-    label?: string;
-    fields: Field[];
-    access?: {
-        read?: AccessFunction<TDoc>;
-        update?: AccessFunction<TDoc>;
-    };
-    hooks?: {
-        beforeRead?: GlobalBeforeReadHook[];
-        afterRead?: GlobalAfterReadHook<TDoc>[];
-        beforeChange?: GlobalBeforeChangeHook<TDoc>[];
-        afterChange?: GlobalAfterChangeHook<TDoc>[];
-    };
-    admin?: {
-        icon?: AdminIconName;
-        group?: string;
-        hidden?: boolean;
-    };
-    initialData?: Partial<TDoc>;
-}
-
-/**
- * The interface every database adapter must implement.
- *
- * Dyrected ships adapters for PostgreSQL, MySQL, SQLite, and MongoDB.
- * Implement this interface to connect any other database.
- */
-interface DatabaseAdapter {
-    /** Find a paginated list of documents in a collection. */
-    find(args: {
-        collection: string;
-        where?: Record<string, unknown>;
-        limit?: number;
-        page?: number;
-        sort?: string;
-    }): Promise<PaginatedResult>;
-    /** Find a single document by its ID. Returns `null` if not found. */
-    findOne(args: {
-        collection: string;
-        id: string;
-    }): Promise<BaseDocument | null>;
-    /** Insert a new document and return it with its generated `id`. */
-    create(args: {
-        collection: string;
-        data: Record<string, unknown>;
-    }): Promise<BaseDocument>;
-    /** Update a document by ID and return the updated document. */
-    update(args: {
-        collection: string;
-        id: string;
-        data: Record<string, unknown>;
-    }): Promise<BaseDocument>;
-    /** Delete a document by ID. Return value is intentionally untyped — callers do not use it. */
-    delete(args: {
-        collection: string;
-        id: string;
-    }): Promise<unknown>;
-    /** Fetch the singleton document for a global. Returns an empty object if not yet initialised. */
-    getGlobal(args: {
-        slug: string;
-    }): Promise<Record<string, unknown>>;
-    /** Create or replace the singleton document for a global. */
-    updateGlobal(args: {
-        slug: string;
-        data: Record<string, unknown>;
-    }): Promise<Record<string, unknown>>;
-    /**
-     * Sync the database schema with the current collection and global configs.
-     * Called on startup to create tables/collections that don't exist yet.
-     * Not all adapters implement this (e.g. MongoDB is schema-less).
-     */
-    sync?(collections: CollectionConfig[], globals: GlobalConfig[]): Promise<void>;
-    /**
-     * Execute a raw SQL query or database command.
-     * Optional — not all adapters support raw access.
-     */
-    execute?(query: string, params?: unknown[]): Promise<unknown>;
-    /**
-     * Run all adapter operations in `callback` as one atomic transaction.
-     * Shipped adapters implement this; workflow transitions require it.
-     */
-    transaction?<T>(callback: (db: DatabaseAdapter) => Promise<T>): Promise<T>;
-}
-/**
- * Read-only view of the database adapter. Exposes only `find`, `findOne`,
- * and `getGlobal` — no write operations.
- *
- * Passed to `beforeChange`, `beforeDelete`, `beforeRead`, `afterRead`,
- * and field-level hooks. Write operations are available in `afterChange`
- * and `afterDelete` hooks where the full {@link DatabaseAdapter} is provided.
- */
-type ReadonlyDatabaseAdapter = Pick<DatabaseAdapter, "find" | "findOne" | "getGlobal">;
-/**
- * The interface every storage adapter must implement.
- *
- * Dyrected ships adapters for local disk, S3, Cloudflare R2, Cloudinary, and
- * Backblaze B2. Implement this interface to use any other storage provider.
- */
-interface StorageAdapter {
-    /**
-     * Upload a file and return its metadata (URL, dimensions, etc.).
-     * The `prefix` is a path prefix used for multi-tenant setups.
-     */
-    upload(args: {
-        filename: string;
-        buffer: Uint8Array;
-        mimeType: string;
-        prefix?: string;
-    }): Promise<FileData>;
-    /** Delete a file by its stored filename. */
-    delete(args: {
-        filename: string;
-    }): Promise<void>;
-    /** Return the public URL for a stored file. */
-    getURL(args: {
-        filename: string;
-    }): string;
-    /**
-     * Retrieve the file's raw bytes and MIME type for serving via the API.
-     * Only needed by adapters that serve files through the Dyrected API
-     * (e.g. `LocalStorage`). Cloud adapters return `null` here and rely on
-     * direct CDN URLs instead.
-     */
-    resolve?(args: {
-        filename: string;
-    }): Promise<{
-        buffer: Uint8Array;
-        mimeType: string;
-    } | null>;
-}
-/**
- * Processes uploaded images — generates metadata (dimensions, BlurHash) and
- * produces resized variants defined in `UploadConfig.imageSizes`.
- *
- * @example
- * import { SharpImageService } from '@dyrected/image-sharp'
- * defineConfig({ image: new SharpImageService(), ... })
- */
-interface ImageService {
-    process(args: {
-        buffer: Uint8Array;
-        mimeType: string;
-        config?: boolean | UploadConfig;
-        focalPoint?: {
-            x: number;
-            y: number;
-        };
-    }): Promise<{
-        metadata: {
-            width?: number;
-            height?: number;
-            /** Base64-encoded BlurHash for progressive loading. */
-            blurhash?: string;
-        };
-        /** Generated image sizes keyed by their `name`. */
-        sizes?: Record<string, {
-            buffer: Uint8Array;
-            width: number;
-            height: number;
-            filename: string;
-        }>;
-    }>;
-}
-
-type AdminAuthProvisioningMode = "jit_only" | "jit_plus_membership_management" | "preprovisioned_only";
-interface AdminAuthClaimMapping {
-    sub?: string;
-    email?: string;
-    name?: string;
-    roles?: string;
-    groups?: string;
-    siteIds?: string;
-    workspaceIds?: string;
-}
-interface AdminAuthResolvedIdentity {
-    sub: string;
-    email?: string;
-    name?: string;
-    roles?: string[];
-    groups?: string[];
-    siteIds?: string[];
-    workspaceIds?: string[];
-    rawClaims?: Record<string, unknown>;
-}
-interface AdminAuthAccessResolution {
-    allowed: boolean;
-    roles?: string[];
-    data?: Record<string, unknown>;
-}
-interface AdminAuthResolveAccessArgs {
-    identity: AdminAuthResolvedIdentity;
-    providerId: string;
-    siteId?: string;
-    workspaceId?: string;
-    req: {
-        method: string;
-        path: string;
-        url: string;
-        headers: Record<string, string | undefined>;
-    };
-    user: Record<string, unknown> | null;
-}
-interface BaseAdminAuthProvider {
-    id: string;
-    type: "oidc" | "custom" | "cloud";
-    displayName?: string;
-    autoRedirect?: boolean;
-    allowJitProvisioning?: boolean;
-    claimMapping?: AdminAuthClaimMapping;
-}
-interface OIDCAdminAuthProvider extends BaseAdminAuthProvider {
-    type: "oidc";
-    issuer: string;
-    clientId: string;
-    clientSecret: string;
-    redirectUri?: string;
-    scopes?: string[];
-    authorizationEndpoint?: string;
-    tokenEndpoint?: string;
-    userInfoEndpoint?: string;
-}
-interface CustomAdminAuthProvider extends BaseAdminAuthProvider {
-    type: "custom" | "cloud";
-    startUrl?: string;
-    issuer?: string;
-    audience?: string;
-    secret?: string;
-    jwksUri?: string;
-    tokenParam?: string;
-}
-type AdminAuthProvider = OIDCAdminAuthProvider | CustomAdminAuthProvider;
-interface PublicAdminAuthProvider {
-    id: string;
-    type: AdminAuthProvider["type"];
-    displayName: string;
-    autoRedirect?: boolean;
-}
-interface PublicAdminAuthConfig {
-    mode: "local" | "external";
-    collectionSlug?: string;
-    provisioningMode?: AdminAuthProvisioningMode;
-    providers: PublicAdminAuthProvider[];
-}
-interface AdminAuthConfig {
-    mode: "local" | "external";
-    collectionSlug?: string;
-    provisioningMode?: AdminAuthProvisioningMode;
-    providers: AdminAuthProvider[];
-    resolveAccess?: (args: AdminAuthResolveAccessArgs) => Promise<AdminAuthAccessResolution> | AdminAuthAccessResolution;
-}
-
-/**
- * The root configuration object passed to `createDyrectedApp`.
- *
- * This is the single source of truth for your entire Dyrected instance —
- * collections, globals, database adapter, storage, email, and more.
- */
-interface DyrectedConfig {
-    collections: CollectionConfig<any>[];
-    globals: GlobalConfig<any>[];
-    db?: DatabaseAdapter;
-    storage?: StorageAdapter;
-    image?: ImageService;
-    admin?: AdminConfig;
-    adminAuth?: AdminAuthConfig;
-    email?: {
-        from: string;
-        send: (args: {
-            to: string;
-            subject: string;
-            html: string;
-        }) => Promise<void>;
-        templates?: {
-            welcome?: (args: {
-                email: string;
-            }) => {
-                subject?: string;
-                html: string;
-            };
-            invite?: (args: {
-                token: string;
-                invitedByEmail?: string;
-            }) => {
-                subject?: string;
-                html: string;
-            };
-            resetPassword?: (args: {
-                token: string;
-                url?: string;
-            }) => {
-                subject?: string;
-                html: string;
-            };
-            passwordChanged?: (args: {
-                email: string;
-            }) => {
-                subject?: string;
-                html: string;
-            };
-        };
-    };
-    redis?: {
-        url: string;
-    };
-    events?: {
-        handlers: LifecycleEventHandler[];
-        maxAttempts?: number;
-        retryDelayMs?: number;
-    };
-    cors?: {
-        origins: string[];
-    };
-    onSchemaFetch?: (siteId: string) => Promise<{
-        collections?: CollectionConfig<any>[];
-        globals?: GlobalConfig<any>[];
-        admin?: AdminConfig;
-        adminAuth?: AdminAuthConfig;
-    }>;
-}
-
-export { type FieldAfterReadHookArgs as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type CollectionBeforeTransitionHook as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type CollectionListComponentSlots as I, type CustomAdminAuthProvider as J, type DatabaseAdapter as K, type LifecycleEventName as L, type DateField as M, type DateTimeField as N, type DynamicOptionItem as O, type PublicAdminAuthConfig as P, type DynamicOptionsConfig as Q, type DynamicOptionsResolver as R, type DynamicOptionsResolverArgs as S, type EmailField as T, type FieldAdminOnChangeHook as U, type FieldAdminOnChangeHookArgs as V, type WorkflowConfig as W, type FieldAdminOptionsHook as X, type FieldAdminOptionsHookArgs as Y, type FieldAdminOptionsHookResult as Z, type FieldAfterReadHook as _, type AuthenticatedUser as a, type FieldBeforeChangeHook as a0, type FieldBeforeChangeHookArgs as a1, type FieldHook as a2, type FieldType as a3, type FileData as a4, type GlobalAfterChangeHook as a5, type GlobalAfterReadHook as a6, type GlobalBeforeChangeHook as a7, type GlobalBeforeReadHook as a8, type HookFunction as a9, type WorkflowMetadata as aA, type WorkflowRole as aB, type WorkflowState as aC, type WorkflowTransitionContext as aD, type IconField as aa, type ImageField as ab, type ImageService as ac, type JoinField as ad, type JsonField as ae, LIFECYCLE_EVENT_NAMES as af, type LifecycleEventHandler as ag, type MultiSelectField as ah, type NumberField as ai, type OIDCAdminAuthProvider as aj, type ObjectField as ak, type PaginatedResult as al, type PublicAdminAuthProvider as am, type RadioField as an, type ReadonlyDatabaseAdapter as ao, type RelationshipField as ap, type RichTextField as aq, type RowField as ar, type SelectField as as, type StorageAdapter as at, type TextField as au, type TextareaField as av, type TimeField as aw, type UploadConfig as ax, type UrlField as ay, type WordLimitFieldConfig as az, type WorkflowTransition as b, type LifecycleEvent as c, type BaseDocument as d, type AccessFunction as e, type AdminAuthAccessResolution as f, type AdminAuthClaimMapping as g, type AdminAuthProvider as h, type AdminAuthProvisioningMode as i, type AdminAuthResolveAccessArgs as j, type AdminAuthResolvedIdentity as k, type AdminConfig as l, type AdminDashboardComponentSlots as m, type AdminIconName as n, type ArrayField as o, type BaseAdminAuthProvider as p, type BlocksField as q, type BooleanField as r, type CharacterLimitFieldConfig as s, type CollectionAfterChangeHook as t, type CollectionAfterDeleteHook as u, type CollectionAfterReadHook as v, type CollectionAfterTransitionHook as w, type CollectionBeforeChangeHook as x, type CollectionBeforeDeleteHook as y, type CollectionBeforeReadHook as z };