@airdraft/core 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to `@airdraft/core` will be documented here.
+
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

package/dist/adapters/GitHubAdapter.d.ts

@@ -0,0 +1,69 @@
+import type { StorageAdapter, FileResult, WriteOptions, DeleteOptions, FileListItem } from '../types.js';
+export interface GitHubAdapterOptions {
+    /**
+     * GitHub App ID. Required when `tokenProvider` is not supplied.
+     */
+    appId?: string;
+    /**
+     * GitHub App private key (PEM). Required when `tokenProvider` is not supplied.
+     */
+    privateKey?: string;
+    /**
+     * GitHub App installation ID. Required when `tokenProvider` is not supplied.
+     */
+    installationId?: string;
+    /**
+     * Alternative to appId/privateKey/installationId. A function that returns a
+     * valid GitHub installation access token. When present, local JWT signing is
+     * skipped entirely. Used for mode 1 (cloud runtime) and mode 2 (self-hosted
+     * via Airdraft token relay).
+     */
+    tokenProvider?: () => Promise<string>;
+    /** "owner/repo" */
+    repo: string;
+    /** Defaults to repo default branch. */
+    branch?: string;
+    committer?: {
+        name: string;
+        email: string;
+    };
+    /**
+     * Read cache TTL in milliseconds (D3). Default: 30_000 (30 seconds).
+     * Set to 0 to disable caching.
+     */
+    cacheTtlMs?: number;
+    /**
+     * Maximum cached entries (D3). Default: 500.
+     */
+    cacheMaxSize?: number;
+    /**
+     * Override the default commit message template (D1).
+     * Receives action ('Create' | 'Update' | 'Delete'), collection name, and slug.
+     * Default: `"{Action} {collection}/{slug}"`
+     */
+    commitMessage?: (action: 'Create' | 'Update' | 'Delete', collection: string, slug: string) => string;
+}
+export interface CommitAuthor {
+    name: string;
+    email: string;
+}
+export declare class GitHubAdapter implements StorageAdapter {
+    private readonly opts;
+    private tokenCache;
+    private readonly readCache;
+    private readonly buildCommitMessage;
+    constructor(options: GitHubAdapterOptions);
+    private getToken;
+    private authHeaders;
+    private contentsUrl;
+    private fetch;
+    read(path: string): Promise<FileResult | null>;
+    write(path: string, content: string, options: WriteOptions & {
+        author?: CommitAuthor;
+    }): Promise<void>;
+    delete(path: string, options: DeleteOptions & {
+        author?: CommitAuthor;
+    }): Promise<void>;
+    list(glob: string): Promise<FileListItem[]>;
+}
+//# sourceMappingURL=GitHubAdapter.d.ts.map

package/dist/adapters/GitHubAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/GitHubAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAQxG,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IACrC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CACrG;AAMD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAgID,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IACtC,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsF;gBAE7G,OAAO,EAAE,oBAAoB;YA4B3B,QAAQ;YAoCR,WAAW;IASzB,OAAO,CAAC,WAAW;YAUL,KAAK;IA8Bb,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA2B9C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCtG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCvF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAoBlD"}

package/dist/adapters/GitHubAdapter.js

@@ -0,0 +1,278 @@
+import { GitHubError, AdapterError } from '../errors.js';
+import { createSign } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// JWT helpers (Node.js 18+ crypto.subtle — no external deps)
+// ---------------------------------------------------------------------------
+function base64url(input) {
+    const buf = Buffer.isBuffer(input) ? input : Buffer.from(input);
+    return buf.toString('base64')
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=+$/, '');
+}
+async function signJwt(appId, privateKeyPem) {
+    const now = Math.floor(Date.now() / 1000);
+    const header = base64url(Buffer.from(JSON.stringify({ alg: 'RS256', typ: 'JWT' })));
+    const payload = base64url(Buffer.from(JSON.stringify({ iat: now - 60, exp: now + 540, iss: appId })));
+    const signingInput = `${header}.${payload}`;
+    const normalizedKey = privateKeyPem.replace(/\\n/g, '\n');
+    const sign = createSign('RSA-SHA256');
+    sign.update(signingInput);
+    const signature = sign.sign(normalizedKey);
+    return `${signingInput}.${base64url(signature)}`;
+}
+class LruCache {
+    maxSize;
+    ttlMs;
+    map = new Map();
+    constructor(maxSize, ttlMs) {
+        this.maxSize = maxSize;
+        this.ttlMs = ttlMs;
+    }
+    get(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.map.delete(key);
+            return undefined;
+        }
+        // Refresh LRU order
+        this.map.delete(key);
+        this.map.set(key, entry);
+        return entry.value;
+    }
+    set(key, value) {
+        if (this.map.has(key))
+            this.map.delete(key);
+        else if (this.map.size >= this.maxSize) {
+            // Evict the oldest entry (first key in insertion-order Map)
+            const oldest = this.map.keys().next().value;
+            if (oldest !== undefined)
+                this.map.delete(oldest);
+        }
+        this.map.set(key, { value, expiresAt: Date.now() + this.ttlMs });
+    }
+    delete(key) {
+        this.map.delete(key);
+    }
+    clear() {
+        this.map.clear();
+    }
+}
+// ---------------------------------------------------------------------------
+// Default commit message template  (D1)
+// ---------------------------------------------------------------------------
+function defaultCommitMessage(action, collection, slug) {
+    return `${action} ${collection}/${slug}`;
+}
+export class GitHubAdapter {
+    opts;
+    tokenCache = null;
+    readCache;
+    buildCommitMessage;
+    constructor(options) {
+        const hasSigningCreds = options.appId && options.privateKey && options.installationId;
+        const hasProvider = typeof options.tokenProvider === 'function';
+        if (!hasSigningCreds && !hasProvider) {
+            throw new AdapterError('GitHubAdapter requires either (appId + privateKey + installationId) or a tokenProvider function');
+        }
+        this.opts = {
+            branch: '',
+            cacheTtlMs: 30_000,
+            cacheMaxSize: 500,
+            commitMessage: defaultCommitMessage,
+            ...options,
+        };
+        const ttl = options.cacheTtlMs ?? 30_000;
+        this.readCache = ttl > 0
+            ? new LruCache(options.cacheMaxSize ?? 500, ttl)
+            : new LruCache(0, 0); // effectively disabled
+        this.buildCommitMessage = options.commitMessage ?? defaultCommitMessage;
+    }
+    // -------------------------------------------------------------------------
+    // Token management
+    // -------------------------------------------------------------------------
+    async getToken() {
+        // Mode 1/2: delegate entirely to the provided token function
+        if (this.opts.tokenProvider) {
+            return this.opts.tokenProvider();
+        }
+        // Mode 3: local JWT signing path
+        const fiveMinutes = 5 * 60 * 1000;
+        if (this.tokenCache && this.tokenCache.expiresAt - Date.now() > fiveMinutes) {
+            return this.tokenCache.token;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const jwt = await signJwt(this.opts.appId, this.opts.privateKey);
+        const res = await this.fetch(
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        `https://api.github.com/app/installations/${this.opts.installationId}/access_tokens`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${jwt}`,
+                Accept: 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+            },
+        }, 0 // no retry for token fetch
+        );
+        const body = await res.json();
+        this.tokenCache = {
+            token: body.token,
+            expiresAt: new Date(body.expires_at).getTime(),
+        };
+        return this.tokenCache.token;
+    }
+    async authHeaders() {
+        const token = await this.getToken();
+        return {
+            Authorization: `Bearer ${token}`,
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+        };
+    }
+    contentsUrl(path) {
+        const [owner, repo] = this.opts.repo.split('/');
+        const base = `https://api.github.com/repos/${owner}/${repo}/contents/${path}`;
+        return this.opts.branch ? `${base}?ref=${this.opts.branch}` : base;
+    }
+    // -------------------------------------------------------------------------
+    // Fetch with retry
+    // -------------------------------------------------------------------------
+    async fetch(url, init, maxRetries = 3) {
+        let lastErr;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            if (attempt > 0) {
+                await sleep(Math.min(1000 * 2 ** (attempt - 1), 8000));
+            }
+            let res;
+            try {
+                res = await fetch(url, init);
+            }
+            catch (err) {
+                lastErr = err;
+                continue;
+            }
+            if (res.ok)
+                return res;
+            // Non-retriable
+            if ([400, 401, 403, 404, 409, 422].includes(res.status)) {
+                return res;
+            }
+            // Retriable (5xx, 429)
+            lastErr = new GitHubError(`GitHub API ${res.status}: ${url}`);
+        }
+        throw new GitHubError(`GitHub API call failed after ${maxRetries + 1} attempts: ${String(lastErr)}`);
+    }
+    // -------------------------------------------------------------------------
+    // StorageAdapter implementation
+    // -------------------------------------------------------------------------
+    async read(path) {
+        // Check LRU cache first (D3)
+        const cacheKey = `${this.opts.repo}/${this.opts.branch}/${path}`;
+        const cached = this.readCache.get(cacheKey);
+        if (cached !== undefined)
+            return cached;
+        const headers = await this.authHeaders();
+        const res = await this.fetch(this.contentsUrl(path), { headers });
+        if (res.status === 404) {
+            this.readCache.set(cacheKey, null);
+            return null;
+        }
+        if (!res.ok) {
+            throw new GitHubError(`Failed to read "${path}": ${res.status} ${res.statusText}`);
+        }
+        const data = await res.json();
+        if (data.encoding !== 'base64') {
+            throw new AdapterError(`Unexpected encoding "${data.encoding}" for "${path}"`);
+        }
+        const content = atob(data.content.replace(/\n/g, ''));
+        const result = { content, sha: data.sha, path };
+        this.readCache.set(cacheKey, result);
+        return result;
+    }
+    async write(path, content, options) {
+        const headers = await this.authHeaders();
+        const encoded = btoa(unescape(encodeURIComponent(content)));
+        // Derive collection + slug from path for commit message (D1)
+        const [, collection = 'unknown', slug = 'unknown'] = path.match(/^([^/]+)\/(.+?)(?:\.[^.]+)?$/) ?? [];
+        const body = {
+            message: options.message || this.buildCommitMessage('Update', collection, slug),
+            content: encoded,
+        };
+        if (options.sha)
+            body['sha'] = options.sha;
+        if (options.branch ?? this.opts.branch)
+            body['branch'] = options.branch ?? this.opts.branch;
+        if (this.opts.committer)
+            body['committer'] = this.opts.committer;
+        // Co-authored-by trailer (D2)
+        if (options.author) {
+            body['message'] = `${body['message']}\n\nCo-authored-by: ${options.author.name} <${options.author.email}>`;
+        }
+        const res = await this.fetch(this.contentsUrl(path), {
+            method: 'PUT',
+            headers: { ...headers, 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new GitHubError(`Failed to write "${path}": ${res.status} ${err.message ?? res.statusText}`);
+        }
+        // Invalidate cache on write (D3)
+        const cacheKey = `${this.opts.repo}/${this.opts.branch}/${path}`;
+        this.readCache.delete(cacheKey);
+    }
+    async delete(path, options) {
+        const headers = await this.authHeaders();
+        const [owner, repo] = this.opts.repo.split('/');
+        const url = `https://api.github.com/repos/${owner}/${repo}/contents/${path}`;
+        // Derive collection + slug from path for commit message (D1)
+        const [, collection = 'unknown', slug = 'unknown'] = path.match(/^([^/]+)\/(.+?)(?:\.[^.]+)?$/) ?? [];
+        let message = options.message || this.buildCommitMessage('Delete', collection, slug);
+        // Co-authored-by trailer (D2)
+        if (options.author) {
+            message = `${message}\n\nCo-authored-by: ${options.author.name} <${options.author.email}>`;
+        }
+        const body = { message, sha: options.sha };
+        if (options.branch ?? this.opts.branch)
+            body['branch'] = options.branch ?? this.opts.branch;
+        if (this.opts.committer)
+            body['committer'] = this.opts.committer;
+        const res = await this.fetch(url, {
+            method: 'DELETE',
+            headers: { ...headers, 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new GitHubError(`Failed to delete "${path}": ${res.status} ${err.message ?? res.statusText}`);
+        }
+        // Invalidate cache on delete (D3)
+        const cacheKey = `${this.opts.repo}/${this.opts.branch}/${path}`;
+        this.readCache.delete(cacheKey);
+    }
+    async list(glob) {
+        // Resolve directory from glob prefix (before first wildcard)
+        const prefix = glob.split('*')[0];
+        const dir = prefix.endsWith('/') ? prefix.slice(0, -1) : prefix.split('/').slice(0, -1).join('/');
+        const headers = await this.authHeaders();
+        const [owner, repo] = this.opts.repo.split('/');
+        const branch = this.opts.branch ? `?ref=${this.opts.branch}` : '';
+        const url = `https://api.github.com/repos/${owner}/${repo}/contents/${dir}${branch}`;
+        const res = await this.fetch(url, { headers });
+        if (res.status === 404)
+            return [];
+        if (!res.ok) {
+            throw new GitHubError(`Failed to list "${dir}": ${res.status} ${res.statusText}`);
+        }
+        const items = await res.json();
+        return items
+            .filter((item) => item.type === 'file')
+            .map((item) => ({ path: item.path, sha: item.sha }));
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=GitHubAdapter.js.map

package/dist/adapters/GitHubAdapter.js.map

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

package/dist/adapters/LocalAdapter.d.ts

@@ -0,0 +1,21 @@
+import type { StorageAdapter, FileResult, WriteOptions, DeleteOptions, FileListItem } from '../types.js';
+export interface LocalAdapterOptions {
+    /** Absolute or cwd-relative root directory for content files. */
+    root: string;
+}
+/**
+ * LocalAdapter — reads/writes files directly on disk.
+ * Designed for local development and testing.
+ * Set GITCMS_LOCAL=true (with no GitHub env vars) to activate automatically.
+ */
+export declare class LocalAdapter implements StorageAdapter {
+    private readonly root;
+    constructor(options: LocalAdapterOptions);
+    private abs;
+    private sha;
+    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[]>;
+}
+//# sourceMappingURL=LocalAdapter.d.ts.map

package/dist/adapters/LocalAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/LocalAdapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAGxG,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,cAAc;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;gBAEjB,OAAO,EAAE,mBAAmB;IAIxC,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,GAAG;IAIL,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAW9C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAclD"}

package/dist/adapters/LocalAdapter.js

@@ -0,0 +1,109 @@
+import { readFile, writeFile, rm, readdir, stat } from 'node:fs/promises';
+import { resolve, join, relative, dirname } from 'node:path';
+import { mkdir } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { AdapterError } from '../errors.js';
+/**
+ * LocalAdapter — reads/writes files directly on disk.
+ * Designed for local development and testing.
+ * Set GITCMS_LOCAL=true (with no GitHub env vars) to activate automatically.
+ */
+export class LocalAdapter {
+    root;
+    constructor(options) {
+        this.root = resolve(process.cwd(), options.root);
+    }
+    abs(path) {
+        return join(this.root, path);
+    }
+    sha(content) {
+        return createHash('sha1').update(content).digest('hex');
+    }
+    async read(path) {
+        const abs = this.abs(path);
+        try {
+            const content = await readFile(abs, 'utf8');
+            return { content, sha: this.sha(content), path };
+        }
+        catch (err) {
+            if (isNodeError(err) && err.code === 'ENOENT')
+                return null;
+            throw new AdapterError(`Failed to read "${path}"`, err);
+        }
+    }
+    async write(path, content, _options) {
+        const abs = this.abs(path);
+        try {
+            await mkdir(dirname(abs), { recursive: true });
+            await writeFile(abs, content, 'utf8');
+        }
+        catch (err) {
+            throw new AdapterError(`Failed to write "${path}"`, err);
+        }
+    }
+    async delete(path, _options) {
+        const abs = this.abs(path);
+        try {
+            await rm(abs, { force: true });
+        }
+        catch (err) {
+            throw new AdapterError(`Failed to delete "${path}"`, err);
+        }
+    }
+    async list(glob) {
+        // Simple glob: supports a single leading segment + trailing '*' or '**' wildcard
+        // For production a proper glob library will replace this minimal impl
+        const prefix = glob.replace(/\*.*$/, '');
+        const dir = this.abs(prefix);
+        try {
+            const results = [];
+            await walk(dir, dir, glob.replace(prefix, ''), results, this.root);
+            return results;
+        }
+        catch (err) {
+            if (isNodeError(err) && err.code === 'ENOENT')
+                return [];
+            throw new AdapterError(`Failed to list "${glob}"`, err);
+        }
+    }
+}
+async function walk(base, dir, suffix, out, root) {
+    // Derive an optional extension filter from the suffix glob (e.g. '*.md' → '.md').
+    // A bare '*' or '**' means accept all extensions.
+    const extFilter = /^\*\.(\w+)$/.exec(suffix)?.[1]
+        ? `.${/^\*\.(\w+)$/.exec(suffix)[1]}`
+        : null;
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry);
+        const s = await stat(full).catch(() => null);
+        if (!s)
+            continue;
+        if (s.isDirectory()) {
+            await walk(base, full, suffix, out, root);
+        }
+        else {
+            if (extFilter && !entry.endsWith(extFilter))
+                continue;
+            const rel = relative(root, full);
+            let content;
+            try {
+                content = await readFile(full, 'utf8');
+            }
+            catch {
+                continue;
+            }
+            out.push({ path: rel, sha: createHash('sha1').update(content).digest('hex') });
+        }
+    }
+}
+function isNodeError(err) {
+    return typeof err === 'object' && err !== null && 'code' in err;
+}
+//# sourceMappingURL=LocalAdapter.js.map

package/dist/adapters/LocalAdapter.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,21 @@
+import type { CmsConfig, CollectionMap, Plugin, StorageAdapter, Entry } from './types.js';
+export interface DefineConfigOptions {
+    adapter: StorageAdapter;
+    /** Inline collection definitions. Mutually exclusive with `schemaPath`. */
+    collections?: CollectionMap;
+    /**
+     * Path to an `airdraft.schema.json` file (relative to `process.cwd()`).
+     * Mutually exclusive with `collections`.
+     */
+    schemaPath?: string;
+    plugins?: Plugin[];
+    basePath?: string;
+    defaultLocale?: string;
+    revalidation?: Record<string, (entry: Entry) => string[]>;
+}
+/**
+ * Entry point for all Airdraft configuration.
+ * Returns a typed CmsConfig object consumed by framework adapters.
+ */
+export declare function defineConfig(options: DefineConfigOptions): CmsConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEzF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAA;IACvB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,aAAa,CAAA;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,EAAE,CAAC,CAAA;CAC1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CA2BpE"}

package/dist/config.js

@@ -0,0 +1,34 @@
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
+/**
+ * Entry point for all Airdraft configuration.
+ * Returns a typed CmsConfig object consumed by framework adapters.
+ */
+export function defineConfig(options) {
+    if (options.collections && options.schemaPath) {
+        throw new Error('[airdraft] defineConfig: "collections" and "schemaPath" are mutually exclusive.');
+    }
+    if (!options.collections && !options.schemaPath) {
+        throw new Error('[airdraft] defineConfig: one of "collections" or "schemaPath" must be provided.');
+    }
+    let collections;
+    if (options.schemaPath) {
+        const absPath = resolve(process.cwd(), options.schemaPath);
+        const raw = readFileSync(absPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        collections = parsed.collections;
+    }
+    else {
+        collections = options.collections;
+    }
+    return {
+        adapter: options.adapter,
+        collections,
+        plugins: options.plugins ?? [],
+        basePath: options.basePath ?? '/api/cms',
+        defaultLocale: options.defaultLocale,
+        revalidation: options.revalidation,
+        schemaPath: options.schemaPath,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAkB9B;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAA;IACpG,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAA;IACpG,CAAC;IAED,IAAI,WAA0B,CAAA;IAC9B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;QAC1D,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqD,CAAA;QAClF,WAAW,GAAG,MAAM,CAAC,WAAW,CAAA;IAClC,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,OAAO,CAAC,WAAY,CAAA;IACpC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW;QACX,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,UAAU;QACxC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAA;AACH,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,26 @@
+import type { CmsConfig, CollectionConfig, CmsSchema, Entry, ListOptions, GetOptions } from './types.js';
+/**
+ * The core runtime class. Instantiated by framework adapters.
+ * Not part of the public API surface — do not use directly in application code.
+ */
+export declare class CmsEngine {
+    private readonly config;
+    /** Collections after all plugin.schema() transforms have been applied. */
+    private readonly resolvedCollections;
+    constructor(config: CmsConfig);
+    getSchema(): CmsSchema;
+    getCollection(name: string): CollectionConfig | null;
+    private requireCollection;
+    listEntries(collection: string, options?: ListOptions): Promise<Entry[]>;
+    getEntry(collection: string, slug: string, options?: GetOptions): Promise<Entry | null>;
+    createEntry(collection: string, slugOrUndefined: string | undefined, data: Record<string, unknown>): Promise<Entry>;
+    updateEntry(collection: string, slug: string, data: Record<string, unknown>): Promise<Entry>;
+    deleteEntry(collection: string, slug: string, sha: string): Promise<void>;
+    private buildEntry;
+    private extractSlugFromPath;
+    private runReadHooks;
+    private runWriteHooks;
+    private runDeleteHooks;
+    private expandEntry;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAEhB,SAAS,EACT,KAAK,EACL,WAAW,EACX,UAAU,EAIX,MAAM,YAAY,CAAA;AAwGnB;;;GAGG;AACH,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAe;gBAEtB,MAAM,EAAE,SAAS;IAY9C,SAAS,IAAI,SAAS;IAItB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIpD,OAAO,CAAC,iBAAiB;IAUnB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAmE5E,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAsB3F,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,KAAK,CAAC;IAoDX,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,KAAK,CAAC;IAiDX,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/E,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,mBAAmB;YASb,YAAY;YAMZ,aAAa;YAUb,cAAc;YAcd,WAAW;CA4B1B"}