@flightdev/cms 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Flight Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,188 @@
+# @flight-framework/cms
+
+Unified CMS adapters for Flight Framework. One API for Strapi, Contentful, Sanity, and more.
+
+## Philosophy
+
+**Flight doesn't impose** - you choose your CMS. All adapters are optional, swap providers without changing your code.
+
+## Features
+
+- **Adapter pattern** - Same API for any CMS
+- **Zero lock-in** - Switch CMS providers without code changes
+- **React hooks** - useCMSQuery, useCMSOne, mutations
+- **Vue composables** - Reactive queries with auto-refetch
+- **Full CRUD** - Read, create, update, delete
+- **i18n support** - Locale-aware queries
+- **Preview mode** - Draft content for editors
+
+## Installation
+
+```bash
+npm install @flight-framework/cms
+```
+
+## Quick Start
+
+```typescript
+import { createCMS } from '@flight-framework/cms';
+import { strapi } from '@flight-framework/cms/strapi';
+
+const cms = createCMS(strapi({
+    url: process.env.STRAPI_URL,
+    token: process.env.STRAPI_TOKEN,
+}));
+
+// Query posts
+const { data: posts, meta } = await cms.findMany('posts', {
+    limit: 10,
+    sort: { publishedAt: 'desc' },
+    populate: ['author', 'cover'],
+});
+
+// Get single post
+const post = await cms.findOne('posts', {
+    where: { slug: 'hello-world' },
+});
+```
+
+## Adapters
+
+### Strapi
+
+```typescript
+import { strapi } from '@flight-framework/cms/strapi';
+
+const adapter = strapi({
+    url: 'http://localhost:1337',
+    token: 'your-api-token',
+    preview: true, // Enable draft mode
+});
+```
+
+### Contentful
+
+```typescript
+import { contentful } from '@flight-framework/cms/contentful';
+
+const adapter = contentful({
+    spaceId: 'your-space-id',
+    accessToken: 'your-access-token',
+    environment: 'master',
+    preview: true,
+    previewToken: 'preview-token',
+});
+```
+
+### Sanity
+
+```typescript
+import { sanity } from '@flight-framework/cms/sanity';
+
+const adapter = sanity({
+    projectId: 'your-project-id',
+    dataset: 'production',
+    token: 'your-token', // Optional for public datasets
+    useCdn: true,
+});
+```
+
+## React Integration
+
+```tsx
+import { CMSProvider, useCMSQuery, useCMSOne } from '@flight-framework/cms/react';
+
+// App
+function App() {
+    return (
+        <CMSProvider cms={cms}>
+            <PostList />
+        </CMSProvider>
+    );
+}
+
+// Query many
+function PostList() {
+    const { data: posts, loading, meta, refetch } = useCMSQuery('posts', {
+        limit: 10,
+        populate: ['author'],
+    });
+    
+    if (loading) return <Skeleton />;
+    
+    return (
+        <>
+            {posts.map(post => <PostCard key={post.id} post={post} />)}
+            <p>Total: {meta?.total}</p>
+        </>
+    );
+}
+
+// Query one
+function PostPage({ slug }) {
+    const { data: post, loading, error } = useCMSOne('posts', {
+        where: { slug },
+    });
+    
+    if (loading) return <Skeleton />;
+    if (!post) return <NotFound />;
+    
+    return <Post post={post} />;
+}
+```
+
+## Vue Integration
+
+```vue
+<script setup>
+import { provideCMS, useCMSQuery } from '@flight-framework/cms/vue';
+
+// Provide CMS in root component
+provideCMS(cms);
+
+// Query posts
+const { data: posts, loading, meta } = useCMSQuery('posts', {
+    limit: 10,
+    sort: { publishedAt: 'desc' },
+});
+</script>
+
+<template>
+    <div v-if="loading">Loading...</div>
+    <PostGrid v-else :posts="posts" />
+</template>
+```
+
+## API Reference
+
+### Query Options
+
+```typescript
+interface FindManyOptions {
+    where?: Record<string, unknown>;   // Filter conditions
+    populate?: string[];               // Relations to include
+    limit?: number;                    // Max results
+    offset?: number;                   // Skip results
+    page?: number;                     // Page number
+    pageSize?: number;                 // Items per page
+    sort?: Record<string, 'asc' | 'desc'>; // Sort order
+    fields?: string[];                 // Select fields
+    locale?: string;                   // Content locale
+    preview?: boolean;                 // Draft mode
+}
+```
+
+### CMS Methods
+
+| Method | Description |
+|--------|-------------|
+| `findOne(collection, options)` | Get single entity |
+| `findMany(collection, options)` | Get multiple with pagination |
+| `findById(collection, id, options)` | Get by ID |
+| `create(collection, data)` | Create entity |
+| `update(collection, id, data)` | Update entity |
+| `delete(collection, id)` | Delete entity |
+
+## License
+
+MIT

package/dist/adapters/contentful.d.ts

@@ -0,0 +1,51 @@
+import { Adapter as CMSAdapter } from '../index.js';
+
+/**
+ * Contentful CMS Adapter
+ *
+ * Integration with Contentful Content Delivery API.
+ *
+ * @example
+ * ```typescript
+ * import { createCMS } from '@flightdev/cms';
+ * import { contentful } from '@flightdev/cms/contentful';
+ *
+ * const cms = createCMS(contentful({
+ *     spaceId: process.env.CONTENTFUL_SPACE_ID,
+ *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN,
+ * }));
+ *
+ * const posts = await cms.findMany('blogPost', {
+ *     limit: 10,
+ *     sort: { 'fields.publishDate': 'desc' },
+ * });
+ * ```
+ */
+
+interface ContentfulConfig {
+    /** Contentful Space ID */
+    spaceId: string;
+    /** Content Delivery API access token */
+    accessToken: string;
+    /** Environment (default: master) */
+    environment?: string;
+    /** Use Preview API for draft content */
+    preview?: boolean;
+    /** Preview API access token (required if preview is true) */
+    previewToken?: string;
+    /** API host (default: cdn.contentful.com) */
+    host?: string;
+    /** Request timeout in ms */
+    timeout?: number;
+    /** Custom fetch function */
+    fetch?: typeof fetch;
+}
+/**
+ * Create a Contentful CMS adapter.
+ *
+ * @param config - Contentful configuration
+ * @returns CMS adapter instance
+ */
+declare function contentful(config: ContentfulConfig): CMSAdapter;
+
+export { type ContentfulConfig, contentful };

package/dist/adapters/contentful.js

@@ -0,0 +1,182 @@
+// src/adapters/contentful.ts
+function contentful(config) {
+  const {
+    spaceId,
+    accessToken,
+    environment = "master",
+    preview = false,
+    previewToken,
+    host = preview ? "preview.contentful.com" : "cdn.contentful.com",
+    timeout = 3e4,
+    fetch: customFetch = globalThis.fetch
+  } = config;
+  const token = preview && previewToken ? previewToken : accessToken;
+  const baseUrl = `https://${host}/spaces/${spaceId}/environments/${environment}`;
+  async function request(path) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+      const response = await customFetch(`${baseUrl}${path}`, {
+        headers: {
+          "Authorization": `Bearer ${token}`,
+          "Content-Type": "application/json"
+        },
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        const error = await response.json().catch(() => ({}));
+        throw new Error(
+          `Contentful error: ${response.status} - ${error.message || response.statusText}`
+        );
+      }
+      return response.json();
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  function buildQuery(contentType, options) {
+    const params = new URLSearchParams();
+    params.append("content_type", contentType);
+    if (options) {
+      if (options.where) {
+        for (const [key, value] of Object.entries(options.where)) {
+          if (value !== void 0 && value !== null) {
+            const fieldKey = key.startsWith("fields.") ? key : `fields.${key}`;
+            params.append(fieldKey, String(value));
+          }
+        }
+      }
+      if (options.limit !== void 0) {
+        params.append("limit", String(options.limit));
+      }
+      if (options.offset !== void 0) {
+        params.append("skip", String(options.offset));
+      }
+      if (options.page !== void 0 && options.pageSize !== void 0) {
+        params.append("skip", String((options.page - 1) * options.pageSize));
+        params.append("limit", String(options.pageSize));
+      }
+      if (options.sort) {
+        if (Array.isArray(options.sort)) {
+          params.append("order", options.sort.join(","));
+        } else {
+          const sortFields = Object.entries(options.sort).map(([field, order]) => `${order === "desc" ? "-" : ""}${field}`).join(",");
+          params.append("order", sortFields);
+        }
+      }
+      if (options.fields) {
+        params.append("select", options.fields.map((f) => `fields.${f}`).join(","));
+      }
+      if (options.locale) {
+        params.append("locale", options.locale);
+      }
+      if (options.populate) {
+        params.append("include", "2");
+      }
+    }
+    return `?${params.toString()}`;
+  }
+  function transformEntry(entry, includes) {
+    const result = {
+      id: entry.sys.id,
+      contentType: entry.sys.contentType?.sys.id,
+      createdAt: entry.sys.createdAt,
+      updatedAt: entry.sys.updatedAt
+    };
+    for (const [key, value] of Object.entries(entry.fields)) {
+      result[key] = resolveLinks(value, includes);
+    }
+    return result;
+  }
+  function resolveLinks(value, includes) {
+    if (!value || typeof value !== "object") {
+      return value;
+    }
+    if ("sys" in value && value.sys.type === "Link") {
+      const link = value;
+      if (link.sys.linkType === "Entry" && includes?.Entry) {
+        const entry = includes.Entry.find((e) => e.sys.id === link.sys.id);
+        if (entry) {
+          return transformEntry(entry, includes);
+        }
+      }
+      if (link.sys.linkType === "Asset" && includes?.Asset) {
+        const asset = includes.Asset.find((a) => a.sys.id === link.sys.id);
+        if (asset) {
+          return transformAsset(asset);
+        }
+      }
+      return null;
+    }
+    if (Array.isArray(value)) {
+      return value.map((item) => resolveLinks(item, includes));
+    }
+    return value;
+  }
+  function transformAsset(asset) {
+    const file = asset.fields.file;
+    return {
+      id: asset.sys.id,
+      title: asset.fields.title,
+      description: asset.fields.description,
+      url: file?.url ? `https:${file.url}` : void 0,
+      width: file?.details?.image?.width,
+      height: file?.details?.image?.height,
+      size: file?.details?.size,
+      mime: file?.contentType
+    };
+  }
+  return {
+    name: "contentful",
+    async findOne(collection, options) {
+      const query = buildQuery(collection, { ...options, limit: 1 });
+      const response = await request(`/entries${query}`);
+      if (!response.items || response.items.length === 0) {
+        return null;
+      }
+      return transformEntry(response.items[0], response.includes);
+    },
+    async findMany(collection, options) {
+      const query = buildQuery(collection, options);
+      const response = await request(`/entries${query}`);
+      return {
+        data: response.items.map((entry) => transformEntry(entry, response.includes)),
+        meta: {
+          total: response.total,
+          page: Math.floor(response.skip / response.limit) + 1,
+          pageSize: response.limit,
+          pageCount: Math.ceil(response.total / response.limit)
+        }
+      };
+    },
+    async findById(collection, id, options) {
+      const params = new URLSearchParams();
+      if (options?.locale) {
+        params.append("locale", options.locale);
+      }
+      if (options?.populate) {
+        params.append("include", "2");
+      }
+      const queryString = params.toString();
+      const query = queryString ? `?${queryString}` : "";
+      try {
+        const response = await request(`/entries/${id}${query}`);
+        return transformEntry(response);
+      } catch (error) {
+        if (error.message.includes("404")) {
+          return null;
+        }
+        throw error;
+      }
+    },
+    // Contentful CDA is read-only
+    // Use Management API for write operations
+    getClient() {
+      return { request, baseUrl };
+    }
+  };
+}
+
+export { contentful };
+//# sourceMappingURL=contentful.js.map
+//# sourceMappingURL=contentful.js.map

package/dist/adapters/contentful.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/contentful.ts"],"names":[],"mappings":"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","file":"contentful.js","sourcesContent":["/**\r\n * Contentful CMS Adapter\r\n * \r\n * Integration with Contentful Content Delivery API.\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createCMS } from '@flightdev/cms';\r\n * import { contentful } from '@flightdev/cms/contentful';\r\n * \r\n * const cms = createCMS(contentful({\r\n *     spaceId: process.env.CONTENTFUL_SPACE_ID,\r\n *     accessToken: process.env.CONTENTFUL_ACCESS_TOKEN,\r\n * }));\r\n * \r\n * const posts = await cms.findMany('blogPost', {\r\n *     limit: 10,\r\n *     sort: { 'fields.publishDate': 'desc' },\r\n * });\r\n * ```\r\n */\r\n\r\nimport type { CMSAdapter, CMSResult, FindOneOptions, FindManyOptions } from '../index';\r\n\r\n// =============================================================================\r\n// Types\r\n// =============================================================================\r\n\r\nexport interface ContentfulConfig {\r\n    /** Contentful Space ID */\r\n    spaceId: string;\r\n    /** Content Delivery API access token */\r\n    accessToken: string;\r\n    /** Environment (default: master) */\r\n    environment?: string;\r\n    /** Use Preview API for draft content */\r\n    preview?: boolean;\r\n    /** Preview API access token (required if preview is true) */\r\n    previewToken?: string;\r\n    /** API host (default: cdn.contentful.com) */\r\n    host?: string;\r\n    /** Request timeout in ms */\r\n    timeout?: number;\r\n    /** Custom fetch function */\r\n    fetch?: typeof fetch;\r\n}\r\n\r\ninterface ContentfulEntry {\r\n    sys: {\r\n        id: string;\r\n        type: string;\r\n        contentType?: {\r\n            sys: { id: string };\r\n        };\r\n        createdAt: string;\r\n        updatedAt: string;\r\n    };\r\n    fields: Record<string, unknown>;\r\n}\r\n\r\ninterface ContentfulResponse {\r\n    sys: { type: string };\r\n    total: number;\r\n    skip: number;\r\n    limit: number;\r\n    items: ContentfulEntry[];\r\n    includes?: {\r\n        Entry?: ContentfulEntry[];\r\n        Asset?: ContentfulAsset[];\r\n    };\r\n}\r\n\r\ninterface ContentfulAsset {\r\n    sys: { id: string };\r\n    fields: {\r\n        title?: string;\r\n        description?: string;\r\n        file?: {\r\n            url: string;\r\n            details?: {\r\n                size: number;\r\n                image?: { width: number; height: number };\r\n            };\r\n            contentType?: string;\r\n        };\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Adapter Implementation\r\n// =============================================================================\r\n\r\n/**\r\n * Create a Contentful CMS adapter.\r\n * \r\n * @param config - Contentful configuration\r\n * @returns CMS adapter instance\r\n */\r\nexport function contentful(config: ContentfulConfig): CMSAdapter {\r\n    const {\r\n        spaceId,\r\n        accessToken,\r\n        environment = 'master',\r\n        preview = false,\r\n        previewToken,\r\n        host = preview ? 'preview.contentful.com' : 'cdn.contentful.com',\r\n        timeout = 30000,\r\n        fetch: customFetch = globalThis.fetch,\r\n    } = config;\r\n\r\n    const token = preview && previewToken ? previewToken : accessToken;\r\n    const baseUrl = `https://${host}/spaces/${spaceId}/environments/${environment}`;\r\n\r\n    /**\r\n     * Make a request to Contentful API.\r\n     */\r\n    async function request<T>(path: string): Promise<T> {\r\n        const controller = new AbortController();\r\n        const timeoutId = setTimeout(() => controller.abort(), timeout);\r\n\r\n        try {\r\n            const response = await customFetch(`${baseUrl}${path}`, {\r\n                headers: {\r\n                    'Authorization': `Bearer ${token}`,\r\n                    'Content-Type': 'application/json',\r\n                },\r\n                signal: controller.signal,\r\n            });\r\n\r\n            if (!response.ok) {\r\n                const error = await response.json().catch(() => ({}));\r\n                throw new Error(\r\n                    `Contentful error: ${response.status} - ${error.message || response.statusText}`\r\n                );\r\n            }\r\n\r\n            return response.json();\r\n        } finally {\r\n            clearTimeout(timeoutId);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Build query string from options.\r\n     */\r\n    function buildQuery(\r\n        contentType: string,\r\n        options?: FindOneOptions & FindManyOptions\r\n    ): string {\r\n        const params = new URLSearchParams();\r\n\r\n        params.append('content_type', contentType);\r\n\r\n        if (options) {\r\n            // Filters (where)\r\n            if (options.where) {\r\n                for (const [key, value] of Object.entries(options.where)) {\r\n                    if (value !== undefined && value !== null) {\r\n                        // Support nested field syntax\r\n                        const fieldKey = key.startsWith('fields.') ? key : `fields.${key}`;\r\n                        params.append(fieldKey, String(value));\r\n                    }\r\n                }\r\n            }\r\n\r\n            // Pagination\r\n            if (options.limit !== undefined) {\r\n                params.append('limit', String(options.limit));\r\n            }\r\n            if (options.offset !== undefined) {\r\n                params.append('skip', String(options.offset));\r\n            }\r\n            if (options.page !== undefined && options.pageSize !== undefined) {\r\n                params.append('skip', String((options.page - 1) * options.pageSize));\r\n                params.append('limit', String(options.pageSize));\r\n            }\r\n\r\n            // Sort\r\n            if (options.sort) {\r\n                if (Array.isArray(options.sort)) {\r\n                    params.append('order', options.sort.join(','));\r\n                } else {\r\n                    const sortFields = Object.entries(options.sort)\r\n                        .map(([field, order]) => `${order === 'desc' ? '-' : ''}${field}`)\r\n                        .join(',');\r\n                    params.append('order', sortFields);\r\n                }\r\n            }\r\n\r\n            // Fields selection\r\n            if (options.fields) {\r\n                params.append('select', options.fields.map(f => `fields.${f}`).join(','));\r\n            }\r\n\r\n            // Locale\r\n            if (options.locale) {\r\n                params.append('locale', options.locale);\r\n            }\r\n\r\n            // Include linked entries (populate)\r\n            if (options.populate) {\r\n                params.append('include', '2'); // 2 levels of linked entries\r\n            }\r\n        }\r\n\r\n        return `?${params.toString()}`;\r\n    }\r\n\r\n    /**\r\n     * Transform Contentful entry to normalized format.\r\n     */\r\n    function transformEntry<T>(\r\n        entry: ContentfulEntry,\r\n        includes?: ContentfulResponse['includes']\r\n    ): T {\r\n        const result: Record<string, unknown> = {\r\n            id: entry.sys.id,\r\n            contentType: entry.sys.contentType?.sys.id,\r\n            createdAt: entry.sys.createdAt,\r\n            updatedAt: entry.sys.updatedAt,\r\n        };\r\n\r\n        // Transform fields\r\n        for (const [key, value] of Object.entries(entry.fields)) {\r\n            result[key] = resolveLinks(value, includes);\r\n        }\r\n\r\n        return result as T;\r\n    }\r\n\r\n    /**\r\n     * Resolve linked entries and assets.\r\n     */\r\n    function resolveLinks(\r\n        value: unknown,\r\n        includes?: ContentfulResponse['includes']\r\n    ): unknown {\r\n        if (!value || typeof value !== 'object') {\r\n            return value;\r\n        }\r\n\r\n        // Check if it's a link\r\n        if ('sys' in value && (value as any).sys.type === 'Link') {\r\n            const link = value as { sys: { linkType: string; id: string } };\r\n\r\n            if (link.sys.linkType === 'Entry' && includes?.Entry) {\r\n                const entry = includes.Entry.find(e => e.sys.id === link.sys.id);\r\n                if (entry) {\r\n                    return transformEntry(entry, includes);\r\n                }\r\n            }\r\n\r\n            if (link.sys.linkType === 'Asset' && includes?.Asset) {\r\n                const asset = includes.Asset.find(a => a.sys.id === link.sys.id);\r\n                if (asset) {\r\n                    return transformAsset(asset);\r\n                }\r\n            }\r\n\r\n            return null; // Unresolved link\r\n        }\r\n\r\n        // Recursively resolve arrays\r\n        if (Array.isArray(value)) {\r\n            return value.map(item => resolveLinks(item, includes));\r\n        }\r\n\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Transform Contentful asset to normalized format.\r\n     */\r\n    function transformAsset(asset: ContentfulAsset) {\r\n        const file = asset.fields.file;\r\n        return {\r\n            id: asset.sys.id,\r\n            title: asset.fields.title,\r\n            description: asset.fields.description,\r\n            url: file?.url ? `https:${file.url}` : undefined,\r\n            width: file?.details?.image?.width,\r\n            height: file?.details?.image?.height,\r\n            size: file?.details?.size,\r\n            mime: file?.contentType,\r\n        };\r\n    }\r\n\r\n    return {\r\n        name: 'contentful',\r\n\r\n        async findOne<T>(collection: string, options?: FindOneOptions): Promise<T | null> {\r\n            const query = buildQuery(collection, { ...options, limit: 1 });\r\n            const response = await request<ContentfulResponse>(`/entries${query}`);\r\n\r\n            if (!response.items || response.items.length === 0) {\r\n                return null;\r\n            }\r\n\r\n            return transformEntry<T>(response.items[0], response.includes);\r\n        },\r\n\r\n        async findMany<T>(collection: string, options?: FindManyOptions): Promise<CMSResult<T>> {\r\n            const query = buildQuery(collection, options);\r\n            const response = await request<ContentfulResponse>(`/entries${query}`);\r\n\r\n            return {\r\n                data: response.items.map(entry => transformEntry<T>(entry, response.includes)),\r\n                meta: {\r\n                    total: response.total,\r\n                    page: Math.floor(response.skip / response.limit) + 1,\r\n                    pageSize: response.limit,\r\n                    pageCount: Math.ceil(response.total / response.limit),\r\n                },\r\n            };\r\n        },\r\n\r\n        async findById<T>(\r\n            collection: string,\r\n            id: string | number,\r\n            options?: Omit<FindOneOptions, 'where'>\r\n        ): Promise<T | null> {\r\n            const params = new URLSearchParams();\r\n\r\n            if (options?.locale) {\r\n                params.append('locale', options.locale);\r\n            }\r\n            if (options?.populate) {\r\n                params.append('include', '2');\r\n            }\r\n\r\n            const queryString = params.toString();\r\n            const query = queryString ? `?${queryString}` : '';\r\n\r\n            try {\r\n                const response = await request<ContentfulEntry>(`/entries/${id}${query}`);\r\n                return transformEntry<T>(response);\r\n            } catch (error) {\r\n                if ((error as Error).message.includes('404')) {\r\n                    return null;\r\n                }\r\n                throw error;\r\n            }\r\n        },\r\n\r\n        // Contentful CDA is read-only\r\n        // Use Management API for write operations\r\n\r\n        getClient() {\r\n            return { request, baseUrl };\r\n        },\r\n    };\r\n}\r\n"]}

package/dist/adapters/sanity.d.ts

@@ -0,0 +1,73 @@
+import { Adapter as CMSAdapter } from '../index.js';
+
+/**
+ * Sanity CMS Adapter
+ *
+ * Integration with Sanity.io using GROQ queries.
+ *
+ * @example
+ * ```typescript
+ * import { createCMS } from '@flightdev/cms';
+ * import { sanity } from '@flightdev/cms/sanity';
+ *
+ * const cms = createCMS(sanity({
+ *     projectId: process.env.SANITY_PROJECT_ID,
+ *     dataset: 'production',
+ *     token: process.env.SANITY_TOKEN, // Optional for public datasets
+ * }));
+ *
+ * const posts = await cms.findMany('post', {
+ *     limit: 10,
+ *     sort: { publishedAt: 'desc' },
+ * });
+ * ```
+ */
+
+interface SanityConfig {
+    /** Sanity Project ID */
+    projectId: string;
+    /** Dataset name (default: production) */
+    dataset?: string;
+    /** API Token (for private datasets or mutations) */
+    token?: string;
+    /** API version (default: v2024-01-01) */
+    apiVersion?: string;
+    /** Use CDN for faster reads (default: true) */
+    useCdn?: boolean;
+    /** Enable draft preview */
+    preview?: boolean;
+    /** Request timeout in ms */
+    timeout?: number;
+    /** Custom fetch function */
+    fetch?: typeof fetch;
+}
+/**
+ * Create a Sanity CMS adapter.
+ *
+ * @param config - Sanity configuration
+ * @returns CMS adapter instance
+ */
+declare function sanity(config: SanityConfig): CMSAdapter;
+/**
+ * Helper to build GROQ queries manually.
+ * Use when you need more control than the standard adapter methods.
+ *
+ * @example
+ * ```typescript
+ * import { sanity, groq } from '@flightdev/cms/sanity';
+ *
+ * const cms = createCMS(sanity({ projectId: '...' }));
+ * const client = cms.getClient() as { query: Function };
+ *
+ * const posts = await client.query(groq`
+ *     *[_type == "post" && publishedAt < now()] | order(publishedAt desc) {
+ *         title,
+ *         slug,
+ *         "author": author->name
+ *     }
+ * `);
+ * ```
+ */
+declare function groq(strings: TemplateStringsArray, ...values: unknown[]): string;
+
+export { type SanityConfig, groq, sanity };