@airdraft/core 0.1.0

package/dist/fields.js

@@ -0,0 +1,181 @@
+/**
+ * Validate a single field value against its FieldConfig.
+ * Returns an array of error messages (empty = valid).
+ */
+export function validateField(fieldName, value, config) {
+    const errors = [];
+    if (config.required && (value === undefined || value === null || value === '')) {
+        errors.push({ field: fieldName, message: 'This field is required.' });
+        return errors;
+    }
+    if (value === undefined || value === null)
+        return errors;
+    switch (config.type) {
+        case 'string':
+        case 'text':
+        case 'image':
+        case 'relation': {
+            if (typeof value !== 'string') {
+                errors.push({ field: fieldName, message: `Expected a string.` });
+                break;
+            }
+            if (config.pattern) {
+                const re = new RegExp(config.pattern);
+                if (!re.test(value)) {
+                    errors.push({ field: fieldName, message: `Does not match pattern "${config.pattern}".` });
+                }
+            }
+            break;
+        }
+        case 'rich-text': {
+            if (typeof value !== 'string') {
+                errors.push({ field: fieldName, message: `Expected a string (MDX body).` });
+            }
+            break;
+        }
+        case 'number': {
+            if (typeof value !== 'number') {
+                errors.push({ field: fieldName, message: `Expected a number.` });
+                break;
+            }
+            if (config.min !== undefined && value < config.min) {
+                errors.push({ field: fieldName, message: `Must be ≥ ${config.min}.` });
+            }
+            if (config.max !== undefined && value > config.max) {
+                errors.push({ field: fieldName, message: `Must be ≤ ${config.max}.` });
+            }
+            break;
+        }
+        case 'boolean': {
+            if (typeof value !== 'boolean') {
+                errors.push({ field: fieldName, message: `Expected a boolean.` });
+            }
+            break;
+        }
+        case 'date':
+        case 'datetime': {
+            if (typeof value !== 'string' || isNaN(Date.parse(value))) {
+                errors.push({ field: fieldName, message: `Expected a valid ISO date string.` });
+            }
+            break;
+        }
+        case 'select': {
+            if (typeof value !== 'string') {
+                errors.push({ field: fieldName, message: `Expected a string.` });
+                break;
+            }
+            if (config.options && !config.options.includes(value)) {
+                errors.push({ field: fieldName, message: `Must be one of: ${config.options.join(', ')}.` });
+            }
+            break;
+        }
+        case 'multiselect': {
+            if (!Array.isArray(value)) {
+                errors.push({ field: fieldName, message: `Expected an array.` });
+                break;
+            }
+            if (config.options) {
+                for (const item of value) {
+                    if (typeof item !== 'string' || !config.options.includes(item)) {
+                        errors.push({
+                            field: fieldName,
+                            message: `All items must be one of: ${config.options.join(', ')}.`,
+                        });
+                        break;
+                    }
+                }
+            }
+            break;
+        }
+        case 'list': {
+            if (!Array.isArray(value)) {
+                errors.push({ field: fieldName, message: `Expected an array.` });
+                break;
+            }
+            if (config.min !== undefined && value.length < config.min) {
+                errors.push({ field: fieldName, message: `Must have at least ${config.min} items.` });
+            }
+            if (config.max !== undefined && value.length > config.max) {
+                errors.push({ field: fieldName, message: `Must have at most ${config.max} items.` });
+            }
+            break;
+        }
+        case 'relations': {
+            if (!Array.isArray(value)) {
+                errors.push({ field: fieldName, message: `Expected an array.` });
+                break;
+            }
+            for (const item of value) {
+                if (typeof item !== 'string' || item.trim() === '') {
+                    errors.push({ field: fieldName, message: `Each item must be a non-empty string.` });
+                    break;
+                }
+            }
+            if (config.min !== undefined && value.length < config.min) {
+                errors.push({ field: fieldName, message: `Must have at least ${config.min} items.` });
+            }
+            if (config.max !== undefined && value.length > config.max) {
+                errors.push({ field: fieldName, message: `Must have at most ${config.max} items.` });
+            }
+            break;
+        }
+        case 'object': {
+            if (typeof value !== 'object' || Array.isArray(value)) {
+                errors.push({ field: fieldName, message: `Expected an object.` });
+                break;
+            }
+            if (config.fields) {
+                const nested = value;
+                for (const [subName, subConfig] of Object.entries(config.fields)) {
+                    const subErrors = validateField(`${fieldName}.${subName}`, nested[subName], subConfig);
+                    errors.push(...subErrors);
+                }
+            }
+            break;
+        }
+    }
+    return errors;
+}
+/**
+ * Validate all fields in an entry payload against a collection's field schema.
+ * Returns all collected errors.
+ */
+export function validateFields(data, fields) {
+    const errors = [];
+    for (const [name, config] of Object.entries(fields)) {
+        errors.push(...validateField(name, data[name], config));
+    }
+    return errors;
+}
+/**
+ * Incompatible field/format checks.
+ * Returns an error message if the collection config has an inconsistency, otherwise null.
+ */
+export function checkFormatCompatibility(format, fields) {
+    if (format !== 'mdx') {
+        for (const [name, config] of Object.entries(fields)) {
+            if (config.type === 'rich-text') {
+                return `Field "${name}" uses type "rich-text" which is only compatible with format "mdx".`;
+            }
+        }
+    }
+    return null;
+}
+/** Build a Zod-compatible FieldType enum for schema export. */
+export const FIELD_TYPES = [
+    'string',
+    'text',
+    'number',
+    'boolean',
+    'date',
+    'datetime',
+    'list',
+    'select',
+    'multiselect',
+    'rich-text',
+    'relation',
+    'relations',
+    'object',
+    'image',
+];
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './types.js';
+export * from './config.js';
+export * from './engine.js';
+export * from './fields.js';
+export * from './slug.js';
+export * from './publish.js';
+export * from './errors.js';
+export * from './adapters/LocalAdapter.js';
+export * from './adapters/GitHubAdapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// @airdraft/core — public surface
+export * from './types.js';
+export * from './config.js';
+export * from './engine.js';
+export * from './fields.js';
+export * from './slug.js';
+export * from './publish.js';
+export * from './errors.js';
+export * from './adapters/LocalAdapter.js';
+export * from './adapters/GitHubAdapter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA"}

package/dist/publish.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Liveness rule for publish-workflow collections:
+ *
+ * An entry is LIVE iff:
+ *   published === true
+ *   AND (publishedAt === null OR publishedAt <= now)
+ *
+ * Liveness is evaluated at read/filter time.
+ * No background state mutation occurs.
+ */
+export declare function isLive(published: boolean, publishedAt: string | null | undefined): boolean;
+/**
+ * Build the initial publish fields for a newly created entry.
+ * New entries always start as drafts.
+ */
+export declare function initialPublishFields(): {
+    published: boolean;
+    publishedAt: null;
+};
+//# sourceMappingURL=publish.d.ts.map

package/dist/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../src/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAI1F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,IAAI,CAAA;CAAE,CAEhF"}

package/dist/publish.js

@@ -0,0 +1,25 @@
+/**
+ * Liveness rule for publish-workflow collections:
+ *
+ * An entry is LIVE iff:
+ *   published === true
+ *   AND (publishedAt === null OR publishedAt <= now)
+ *
+ * Liveness is evaluated at read/filter time.
+ * No background state mutation occurs.
+ */
+export function isLive(published, publishedAt) {
+    if (!published)
+        return false;
+    if (publishedAt == null)
+        return true;
+    return new Date(publishedAt).getTime() <= Date.now();
+}
+/**
+ * Build the initial publish fields for a newly created entry.
+ * New entries always start as drafts.
+ */
+export function initialPublishFields() {
+    return { published: false, publishedAt: null };
+}
+//# sourceMappingURL=publish.js.map

package/dist/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../src/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,WAAsC;IAC/E,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA;IAC5B,IAAI,WAAW,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IACpC,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;AAChD,CAAC"}

package/dist/slug.d.ts

@@ -0,0 +1,21 @@
+/** Slug regex: lowercase alphanumeric, hyphen-separated. */
+export declare const SLUG_REGEX: RegExp;
+/**
+ * Validate a slug string against the Airdraft slug format.
+ * Returns the slug unchanged if valid, throws otherwise.
+ */
+export declare function validateSlug(slug: string): string;
+/**
+ * Convert an arbitrary string into a valid Airdraft slug.
+ * - Lowercases
+ * - Converts accented characters to ASCII equivalents
+ * - Replaces non-alphanumeric sequences with a single hyphen
+ * - Strips leading/trailing hyphens
+ */
+export declare function slugify(input: string): string;
+/**
+ * Derive a slug from an entry's data object, using the given source field.
+ * Throws if the resolved value is not a non-empty string.
+ */
+export declare function deriveSlug(data: Record<string, unknown>, slugSource?: string): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,eAAO,MAAM,UAAU,QAA+B,CAAA;AAEtD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,GAAE,MAAgB,GAC3B,MAAM,CAQR"}

package/dist/slug.js

@@ -0,0 +1,39 @@
+/** Slug regex: lowercase alphanumeric, hyphen-separated. */
+export const SLUG_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/**
+ * Validate a slug string against the Airdraft slug format.
+ * Returns the slug unchanged if valid, throws otherwise.
+ */
+export function validateSlug(slug) {
+    if (!SLUG_REGEX.test(slug)) {
+        throw new Error(`Invalid slug "${slug}". Slugs must match /^[a-z0-9]+(?:-[a-z0-9]+)*$/`);
+    }
+    return slug;
+}
+/**
+ * Convert an arbitrary string into a valid Airdraft slug.
+ * - Lowercases
+ * - Converts accented characters to ASCII equivalents
+ * - Replaces non-alphanumeric sequences with a single hyphen
+ * - Strips leading/trailing hyphens
+ */
+export function slugify(input) {
+    return input
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * Derive a slug from an entry's data object, using the given source field.
+ * Throws if the resolved value is not a non-empty string.
+ */
+export function deriveSlug(data, slugSource = 'title') {
+    const raw = data[slugSource];
+    if (typeof raw !== 'string' || raw.trim() === '') {
+        throw new Error(`slugSource field "${slugSource}" must be a non-empty string to auto-generate a slug`);
+    }
+    return slugify(raw);
+}
+//# sourceMappingURL=slug.js.map

package/dist/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAG,4BAA4B,CAAA;AAEtD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,kDAAkD,CACxE,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,IAA6B,EAC7B,aAAqB,OAAO;IAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;IAC5B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,qBAAqB,UAAU,sDAAsD,CACtF,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAA;AACrB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,326 @@
+/**
+ * Maps a FieldConfig to its runtime TypeScript primitive.
+ * Works best when CollectionConfig is defined inline with `as const`.
+ *
+ * @example
+ * const postsCollection = {
+ *   fields: {
+ *     title: { type: 'string', required: true },
+ *     tags:  { type: 'list' },
+ *   }
+ * } satisfies CollectionConfig
+ *
+ * type PostData = InferCollectionData<typeof postsCollection>
+ * // => { title: string; tags?: string[] }
+ */
+type FieldToPrimitive<F extends FieldConfig> = F['type'] extends 'string' | 'text' | 'rich-text' | 'select' | 'relation' | 'image' ? string : F['type'] extends 'number' ? number : F['type'] extends 'boolean' ? boolean : F['type'] extends 'date' | 'datetime' ? string : F['type'] extends 'list' | 'multiselect' | 'relations' ? string[] : F['type'] extends 'object' ? Record<string, unknown> : unknown;
+/** Picks required fields and makes them non-optional. */
+type RequiredFields<Fields extends Record<string, FieldConfig>> = {
+    [K in keyof Fields as Fields[K]['required'] extends true ? K : never]: FieldToPrimitive<Fields[K]>;
+};
+/** Picks optional (non-required) fields. */
+type OptionalFields<Fields extends Record<string, FieldConfig>> = {
+    [K in keyof Fields as Fields[K]['required'] extends true ? never : K]?: FieldToPrimitive<Fields[K]>;
+};
+/**
+ * For every `image` field named `foo`, the server stores two extra fields:
+ * `foo_url` (the resolved CDN URL) and `foo_media` (the full MediaItem object).
+ */
+type ImageAuxFields<Fields extends Record<string, FieldConfig>> = {
+    [K in keyof Fields as Fields[K]['type'] extends 'image' ? `${K & string}_url` : never]?: string;
+} & {
+    [K in keyof Fields as Fields[K]['type'] extends 'image' ? `${K & string}_media` : never]?: MediaItem;
+};
+/** Publish-workflow fields injected when `collection.publish === true`. */
+interface PublishFields {
+    published?: boolean;
+    publishedAt?: string | null;
+}
+/**
+ * Infer the `data` shape of entries for a given CollectionConfig.
+ * Requires the collection to be defined inline (not loaded from a JSON file).
+ */
+export type InferCollectionData<C extends CollectionConfig> = RequiredFields<C['fields']> & OptionalFields<C['fields']> & ImageAuxFields<C['fields']> & PublishFields;
+export type FieldType = 'string' | 'text' | 'number' | 'boolean' | 'date' | 'datetime' | 'list' | 'select' | 'multiselect' | 'rich-text' | 'relation' | 'relations' | 'object' | 'image';
+export interface FieldConfig {
+    type: FieldType;
+    label?: string;
+    required?: boolean;
+    default?: unknown;
+    hidden?: boolean;
+    of?: FieldType;
+    options?: string[];
+    collection?: string;
+    min?: number;
+    max?: number;
+    pattern?: string;
+    fields?: Record<string, FieldConfig>;
+}
+export interface CollectionConfig {
+    /** File path template; {slug} is replaced with the entry slug. */
+    path: string;
+    label?: string;
+    fields: Record<string, FieldConfig>;
+    defaultSort?: {
+        field: string;
+        order: 'asc' | 'desc';
+    };
+    /**
+     * Source field for server-side slug generation when create payload omits `slug`.
+     * Must resolve to a top-level string field. Default: 'title'.
+     */
+    slugSource?: string;
+    previewUrl?: string;
+    format: 'mdx' | 'json' | 'yaml';
+    /**
+     * Enable draft/publish workflow. When true, injects reserved system fields:
+     *   - `published: boolean`
+     *   - `publishedAt: datetime | null`
+     */
+    publish?: boolean;
+}
+export type CollectionMap = Record<string, CollectionConfig>;
+export interface EntryMeta {
+    /** GitHub blob SHA; required for optimistic concurrency on PUT/DELETE. */
+    sha: string;
+}
+export interface Entry {
+    slug: string;
+    meta: EntryMeta;
+    /** Field values keyed by field name. */
+    data: Record<string, unknown>;
+    published?: boolean;
+    publishedAt?: string | null;
+}
+export interface FileResult {
+    content: string;
+    sha: string;
+    path: string;
+}
+export interface WriteOptions {
+    message: string;
+    sha?: string;
+    branch?: string;
+}
+export interface DeleteOptions {
+    message: string;
+    sha: string;
+    branch?: string;
+}
+export interface FileListItem {
+    path: string;
+    sha: string;
+}
+export interface StorageAdapter {
+    read(path: string): Promise<FileResult | null>;
+    write(path: string, content: string, options: WriteOptions): Promise<void>;
+    delete(path: string, options: DeleteOptions): Promise<void>;
+    list(glob: string): Promise<FileListItem[]>;
+}
+export interface SchemaAdapter {
+    read(): Promise<CollectionMap>;
+    write(collections: CollectionMap): Promise<void>;
+}
+export interface ReadContext {
+    collection: string;
+    slug?: string;
+    adapter: StorageAdapter;
+}
+export interface WriteContext {
+    collection: string;
+    slug: string;
+    data: Record<string, unknown>;
+    adapter: StorageAdapter;
+    next: () => Promise<void>;
+}
+export interface DeleteContext {
+    collection: string;
+    slug: string;
+    sha: string;
+    adapter: StorageAdapter;
+    next: () => Promise<void>;
+}
+/** Context injected into plugin route handlers by the HTTP adapter. */
+export interface PluginRouteContext {
+    adapter: StorageAdapter;
+    config: CmsConfig;
+}
+export type RouteHandler = (req: Request, ctx: PluginRouteContext) => Promise<Response>;
+export interface FieldHandler {
+    serialize: (value: unknown) => string;
+    deserialize: (raw: string) => unknown;
+    validate: (value: unknown, config: FieldConfig) => string | null;
+}
+export interface Plugin {
+    name: string;
+    fields?: Record<string, FieldHandler>;
+    routes?: Record<string, RouteHandler>;
+    /**
+     * Called by HTTP-layer adapters (e.g. @airdraft/next) before routing.
+     * Throw `UnauthorizedError` (401) or `ForbiddenError` (403) to block the request.
+     */
+    middleware?: (request: Request) => Promise<void> | void;
+    hooks?: {
+        beforeRead?: (ctx: ReadContext) => Promise<void> | void;
+        afterRead?: (ctx: ReadContext) => Promise<void> | void;
+        beforeWrite?: (ctx: WriteContext) => Promise<void> | void;
+        afterWrite?: (ctx: WriteContext) => Promise<void> | void;
+        beforeDelete?: (ctx: DeleteContext) => Promise<void> | void;
+        afterDelete?: (ctx: DeleteContext) => Promise<void> | void;
+        /**
+         * Called after an entry is read from the storage adapter. Receives the entry
+         * (or the entry returned by the previous plugin in the chain) and must return
+         * the (optionally mutated) entry. Used by plugin-media to inject `{field}_url`
+         * companion fields for image-type fields.
+         */
+        transformEntry?: (entry: Entry, collection: CollectionConfig) => Promise<Entry> | Entry;
+        /**
+         * Called once per CMS request, at completion, with a wide audit event
+         * containing method, path, action, status code, duration, and error info.
+         * Implement this to persist, forward, or react to every operation.
+         */
+        onAuditEvent?: (event: AuditEvent) => void | Promise<void>;
+    };
+    schema?: (schema: CmsSchema) => CmsSchema;
+}
+export type UploadBody = File | Blob | ReadableStream | ArrayBuffer | string;
+export interface UploadOptions {
+    mimeType?: string;
+}
+export interface UrlOptions {
+    /** Signed URL lifetime in seconds. Absent = permanent/provider-default. */
+    expiresIn?: number;
+}
+export interface MediaListOptions {
+    prefix?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface MediaUploadResult {
+    key: string;
+    url: string;
+    size: number;
+    mimeType: string;
+    name: string;
+    width?: number;
+    height?: number;
+    meta?: Record<string, string>;
+}
+export interface MediaListItem {
+    key: string;
+    url: string;
+    size: number;
+    mimeType: string;
+    name: string;
+    lastModified?: string;
+}
+export interface MediaListResult {
+    items: MediaListItem[];
+    cursor?: string;
+}
+/**
+ * A fully enriched media item combining adapter-level data with sidecar
+ * metadata stored via the content StorageAdapter (`_media/{key}.json`).
+ * Returned by all library-mode HTTP endpoints and @airdraft/client media methods.
+ */
+export interface MediaItem {
+    key: string;
+    name: string;
+    mimeType: string;
+    size: number;
+    uploadedAt: string;
+    url: string;
+    isIndexed: boolean;
+    alt?: string;
+    caption?: string;
+    title?: string;
+    tags?: string[];
+    width?: number;
+    height?: number;
+    uploadedBy?: string;
+}
+export interface MediaLibraryResult {
+    items: MediaItem[];
+    cursor?: string;
+}
+export interface MediaAdapter {
+    upload(key: string, body: UploadBody, options?: UploadOptions): Promise<MediaUploadResult>;
+    url(key: string, options?: UrlOptions): Promise<string>;
+    list(options?: MediaListOptions): Promise<MediaListResult>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * A wide audit event emitted once per CMS request, at completion.
+ * Follows the canonical log-line pattern: one rich, structured event per request.
+ *
+ * action values:
+ *   collection.list | collection.get | collection.create | collection.update | collection.delete
+ *   plugin.media.upload | plugin.media.list | plugin.media.*.url | plugin.media.*
+ *   schema.get | unknown
+ */
+export interface AuditEvent {
+    /** Unique identifier for this request. */
+    requestId: string;
+    /** ISO 8601 timestamp at the start of the request. */
+    timestamp: string;
+    /** Wall-clock duration of the full operation, in milliseconds. */
+    durationMs: number;
+    /** HTTP method (GET, POST, PUT, DELETE). */
+    method: string;
+    /** Full request path (e.g. /api/cms/posts/hello). */
+    path: string;
+    /** Classified CMS action (e.g. collection.create, plugin.media.upload). */
+    action: string;
+    /** Collection name when the operation targets a collection. */
+    collection?: string;
+    /** Entry slug when the operation targets a single entry. */
+    slug?: string;
+    /** HTTP status code returned to the client. */
+    statusCode: number;
+    /**
+     * Identity of the caller — the raw API key or bearer token value.
+     * Redact or hash this before persisting to external systems.
+     */
+    actor?: string;
+    /** Structured request context: query params and any other relevant request fields. */
+    request?: Record<string, unknown>;
+    /** Structured response context: entry count, created slug, media key, etc. */
+    response?: Record<string, unknown>;
+    /** Error details when the operation resulted in a 4xx or 5xx response. */
+    error?: {
+        message: string;
+        code?: string;
+    };
+}
+export interface CmsSchema {
+    collections: CollectionMap;
+}
+export interface ListOptions {
+    filter?: Record<string, unknown>;
+    sort?: {
+        field: string;
+        order: 'asc' | 'desc';
+    };
+    limit?: number;
+    offset?: number;
+    /** default: 'all'. Silently ignored on non-publish collections. */
+    status?: 'published' | 'draft' | 'all';
+    /** Field names to expand from slug(s) to full entry objects. Depth limited to 1. */
+    expand?: string[];
+}
+export interface GetOptions {
+    /** Field names to expand from slug(s) to full entry objects. Depth limited to 1. */
+    expand?: string[];
+}
+export interface CmsConfig {
+    adapter: StorageAdapter;
+    collections: CollectionMap;
+    plugins: Plugin[];
+    basePath: string;
+    defaultLocale?: string;
+    revalidation?: Record<string, (entry: Entry) => string[]>;
+    /** Path to the airdraft.schema.json file, when using file-based schema. */
+    schemaPath?: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map