@flightdev/cms 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,221 @@
+/**
+ * @flightdev/cms
+ *
+ * Unified CMS adapters for Flight Framework.
+ * One API to rule them all - Strapi, Contentful, Sanity, and more.
+ *
+ * Philosophy: Flight doesn't impose - you choose your CMS.
+ * All adapters are optional, swap providers without code changes.
+ *
+ * @example
+ * ```typescript
+ * import { createCMS } from '@flightdev/cms';
+ * import { strapi } from '@flightdev/cms/strapi';
+ *
+ * const cms = createCMS(strapi({
+ *     url: process.env.STRAPI_URL,
+ *     token: process.env.STRAPI_TOKEN,
+ * }));
+ *
+ * const posts = await cms.findMany('posts', {
+ *     limit: 10,
+ *     populate: ['author', 'cover'],
+ * });
+ * ```
+ */
+/**
+ * Options for finding a single entity.
+ */
+interface FindOneOptions {
+    /** Filter conditions */
+    where?: Record<string, unknown>;
+    /** Relations to populate */
+    populate?: string[] | Record<string, PopulateOptions>;
+    /** Locale for i18n content */
+    locale?: string;
+    /** Select specific fields */
+    fields?: string[];
+    /** Enable draft/preview mode */
+    preview?: boolean;
+}
+/**
+ * Nested populate configuration.
+ */
+interface PopulateOptions {
+    fields?: string[];
+    populate?: string[] | Record<string, PopulateOptions>;
+}
+/**
+ * Options for finding multiple entities.
+ */
+interface FindManyOptions extends FindOneOptions {
+    /** Maximum number of results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Page number (alternative to offset) */
+    page?: number;
+    /** Page size (used with page) */
+    pageSize?: number;
+    /** Sort order */
+    sort?: Record<string, 'asc' | 'desc'> | string[];
+}
+/**
+ * Paginated result from CMS queries.
+ */
+interface CMSResult<T> {
+    /** Array of entities */
+    data: T[];
+    /** Pagination metadata */
+    meta: {
+        total: number;
+        page: number;
+        pageSize: number;
+        pageCount: number;
+    };
+}
+/**
+ * CMS adapter interface.
+ * All CMS adapters must implement this interface.
+ */
+interface CMSAdapter {
+    /** Adapter name for identification */
+    name: string;
+    /**
+     * Find a single entity by ID or filter.
+     *
+     * @example
+     * ```typescript
+     * // By ID
+     * const post = await cms.findOne('posts', { where: { id: '123' } });
+     *
+     * // By slug
+     * const post = await cms.findOne('posts', { where: { slug: 'hello-world' } });
+     * ```
+     */
+    findOne<T = unknown>(collection: string, options?: FindOneOptions): Promise<T | null>;
+    /**
+     * Find multiple entities with pagination.
+     *
+     * @example
+     * ```typescript
+     * const { data, meta } = await cms.findMany('posts', {
+     *     limit: 10,
+     *     sort: { publishedAt: 'desc' },
+     *     populate: ['author'],
+     * });
+     * ```
+     */
+    findMany<T = unknown>(collection: string, options?: FindManyOptions): Promise<CMSResult<T>>;
+    /**
+     * Find entity by unique identifier.
+     *
+     * @example
+     * ```typescript
+     * const post = await cms.findById('posts', '123');
+     * ```
+     */
+    findById<T = unknown>(collection: string, id: string | number, options?: Omit<FindOneOptions, 'where'>): Promise<T | null>;
+    /**
+     * Create a new entity.
+     * Only available if the adapter supports write operations.
+     *
+     * @example
+     * ```typescript
+     * const post = await cms.create('posts', {
+     *     title: 'New Post',
+     *     content: 'Hello world',
+     * });
+     * ```
+     */
+    create?<T = unknown>(collection: string, data: Partial<T>): Promise<T>;
+    /**
+     * Update an existing entity.
+     *
+     * @example
+     * ```typescript
+     * const updated = await cms.update('posts', '123', {
+     *     title: 'Updated Title',
+     * });
+     * ```
+     */
+    update?<T = unknown>(collection: string, id: string | number, data: Partial<T>): Promise<T>;
+    /**
+     * Delete an entity.
+     *
+     * @example
+     * ```typescript
+     * await cms.delete('posts', '123');
+     * ```
+     */
+    delete?(collection: string, id: string | number): Promise<void>;
+    /**
+     * Get raw client for advanced operations.
+     * Type depends on the adapter.
+     */
+    getClient?(): unknown;
+}
+/**
+ * CMS instance with fully typed adapter methods.
+ */
+interface CMSInstance extends CMSAdapter {
+    /** The underlying adapter */
+    adapter: CMSAdapter;
+}
+/**
+ * Create a CMS instance from an adapter.
+ *
+ * @param adapter - CMS adapter (strapi, contentful, sanity, etc.)
+ * @returns CMS instance with unified API
+ *
+ * @example
+ * ```typescript
+ * import { createCMS } from '@flightdev/cms';
+ * import { strapi } from '@flightdev/cms/strapi';
+ *
+ * const cms = createCMS(strapi({
+ *     url: 'http://localhost:1337',
+ *     token: 'your-api-token',
+ * }));
+ *
+ * // Same API regardless of CMS
+ * const posts = await cms.findMany('posts');
+ * ```
+ */
+declare function createCMS(adapter: CMSAdapter): CMSInstance;
+/**
+ * Type helper for CMS entities.
+ */
+type CMSEntity<T = Record<string, unknown>> = T & {
+    id: string | number;
+    createdAt?: string;
+    updatedAt?: string;
+};
+/**
+ * Type helper for media/asset fields.
+ */
+interface CMSMedia {
+    id: string | number;
+    url: string;
+    alternativeText?: string;
+    caption?: string;
+    width?: number;
+    height?: number;
+    formats?: Record<string, {
+        url: string;
+        width: number;
+        height: number;
+    }>;
+    mime?: string;
+    size?: number;
+}
+/**
+ * Helper to check if adapter supports write operations.
+ */
+declare function isWritable(cms: CMSInstance): boolean;
+/**
+ * Helper to build where clauses from filters.
+ */
+declare function buildWhere(filters: Record<string, unknown>): Record<string, unknown>;
+
+export { type CMSAdapter as Adapter, type CMSAdapter, type CMSEntity, type CMSInstance, type CMSMedia, type CMSResult, type FindManyOptions, type FindOneOptions, type CMSInstance as Instance, type PopulateOptions, type CMSResult as Result, buildWhere, createCMS, isWritable };

package/dist/index.js

@@ -0,0 +1,29 @@
+// src/index.ts
+function createCMS(adapter) {
+  return {
+    name: adapter.name,
+    adapter,
+    findOne: adapter.findOne.bind(adapter),
+    findMany: adapter.findMany.bind(adapter),
+    findById: adapter.findById.bind(adapter),
+    create: adapter.create?.bind(adapter),
+    update: adapter.update?.bind(adapter),
+    delete: adapter.delete?.bind(adapter),
+    getClient: adapter.getClient?.bind(adapter)
+  };
+}
+function isWritable(cms) {
+  return typeof cms.create === "function";
+}
+function buildWhere(filters) {
+  return Object.entries(filters).reduce((acc, [key, value]) => {
+    if (value !== void 0 && value !== null) {
+      acc[key] = value;
+    }
+    return acc;
+  }, {});
+}
+
+export { buildWhere, createCMS, isWritable };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AA+NO,SAAS,UAAU,OAAA,EAAkC;AACxD,EAAA,OAAO;AAAA,IACH,MAAM,OAAA,CAAQ,IAAA;AAAA,IACd,OAAA;AAAA,IAEA,OAAA,EAAS,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,OAAO,CAAA;AAAA,IACrC,QAAA,EAAU,OAAA,CAAQ,QAAA,CAAS,IAAA,CAAK,OAAO,CAAA;AAAA,IACvC,QAAA,EAAU,OAAA,CAAQ,QAAA,CAAS,IAAA,CAAK,OAAO,CAAA;AAAA,IACvC,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAQ,IAAA,CAAK,OAAO,CAAA;AAAA,IACpC,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAQ,IAAA,CAAK,OAAO,CAAA;AAAA,IACpC,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAQ,IAAA,CAAK,OAAO,CAAA;AAAA,IACpC,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAW,IAAA,CAAK,OAAO;AAAA,GAC9C;AACJ;AAqCO,SAAS,WAAW,GAAA,EAA2B;AAClD,EAAA,OAAO,OAAO,IAAI,MAAA,KAAW,UAAA;AACjC;AAKO,SAAS,WACZ,OAAA,EACuB;AACvB,EAAA,OAAO,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,CAAE,MAAA,CAAO,CAAC,GAAA,EAAK,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM;AACzD,IAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AACvC,MAAA,GAAA,CAAI,GAAG,CAAA,GAAI,KAAA;AAAA,IACf;AACA,IAAA,OAAO,GAAA;AAAA,EACX,CAAA,EAAG,EAA6B,CAAA;AACpC","file":"index.js","sourcesContent":["/**\r\n * @flightdev/cms\r\n * \r\n * Unified CMS adapters for Flight Framework.\r\n * One API to rule them all - Strapi, Contentful, Sanity, and more.\r\n * \r\n * Philosophy: Flight doesn't impose - you choose your CMS.\r\n * All adapters are optional, swap providers without code changes.\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createCMS } from '@flightdev/cms';\r\n * import { strapi } from '@flightdev/cms/strapi';\r\n * \r\n * const cms = createCMS(strapi({\r\n *     url: process.env.STRAPI_URL,\r\n *     token: process.env.STRAPI_TOKEN,\r\n * }));\r\n * \r\n * const posts = await cms.findMany('posts', {\r\n *     limit: 10,\r\n *     populate: ['author', 'cover'],\r\n * });\r\n * ```\r\n */\r\n\r\n// =============================================================================\r\n// Types\r\n// =============================================================================\r\n\r\n/**\r\n * Options for finding a single entity.\r\n */\r\nexport interface FindOneOptions {\r\n    /** Filter conditions */\r\n    where?: Record<string, unknown>;\r\n    /** Relations to populate */\r\n    populate?: string[] | Record<string, PopulateOptions>;\r\n    /** Locale for i18n content */\r\n    locale?: string;\r\n    /** Select specific fields */\r\n    fields?: string[];\r\n    /** Enable draft/preview mode */\r\n    preview?: boolean;\r\n}\r\n\r\n/**\r\n * Nested populate configuration.\r\n */\r\nexport interface PopulateOptions {\r\n    fields?: string[];\r\n    populate?: string[] | Record<string, PopulateOptions>;\r\n}\r\n\r\n/**\r\n * Options for finding multiple entities.\r\n */\r\nexport interface FindManyOptions extends FindOneOptions {\r\n    /** Maximum number of results */\r\n    limit?: number;\r\n    /** Offset for pagination */\r\n    offset?: number;\r\n    /** Page number (alternative to offset) */\r\n    page?: number;\r\n    /** Page size (used with page) */\r\n    pageSize?: number;\r\n    /** Sort order */\r\n    sort?: Record<string, 'asc' | 'desc'> | string[];\r\n}\r\n\r\n/**\r\n * Paginated result from CMS queries.\r\n */\r\nexport interface CMSResult<T> {\r\n    /** Array of entities */\r\n    data: T[];\r\n    /** Pagination metadata */\r\n    meta: {\r\n        total: number;\r\n        page: number;\r\n        pageSize: number;\r\n        pageCount: number;\r\n    };\r\n}\r\n\r\n/**\r\n * CMS adapter interface.\r\n * All CMS adapters must implement this interface.\r\n */\r\nexport interface CMSAdapter {\r\n    /** Adapter name for identification */\r\n    name: string;\r\n\r\n    /**\r\n     * Find a single entity by ID or filter.\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * // By ID\r\n     * const post = await cms.findOne('posts', { where: { id: '123' } });\r\n     * \r\n     * // By slug\r\n     * const post = await cms.findOne('posts', { where: { slug: 'hello-world' } });\r\n     * ```\r\n     */\r\n    findOne<T = unknown>(\r\n        collection: string,\r\n        options?: FindOneOptions\r\n    ): Promise<T | null>;\r\n\r\n    /**\r\n     * Find multiple entities with pagination.\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * const { data, meta } = await cms.findMany('posts', {\r\n     *     limit: 10,\r\n     *     sort: { publishedAt: 'desc' },\r\n     *     populate: ['author'],\r\n     * });\r\n     * ```\r\n     */\r\n    findMany<T = unknown>(\r\n        collection: string,\r\n        options?: FindManyOptions\r\n    ): Promise<CMSResult<T>>;\r\n\r\n    /**\r\n     * Find entity by unique identifier.\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * const post = await cms.findById('posts', '123');\r\n     * ```\r\n     */\r\n    findById<T = unknown>(\r\n        collection: string,\r\n        id: string | number,\r\n        options?: Omit<FindOneOptions, 'where'>\r\n    ): Promise<T | null>;\r\n\r\n    /**\r\n     * Create a new entity.\r\n     * Only available if the adapter supports write operations.\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * const post = await cms.create('posts', {\r\n     *     title: 'New Post',\r\n     *     content: 'Hello world',\r\n     * });\r\n     * ```\r\n     */\r\n    create?<T = unknown>(\r\n        collection: string,\r\n        data: Partial<T>\r\n    ): Promise<T>;\r\n\r\n    /**\r\n     * Update an existing entity.\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * const updated = await cms.update('posts', '123', {\r\n     *     title: 'Updated Title',\r\n     * });\r\n     * ```\r\n     */\r\n    update?<T = unknown>(\r\n        collection: string,\r\n        id: string | number,\r\n        data: Partial<T>\r\n    ): Promise<T>;\r\n\r\n    /**\r\n     * Delete an entity.\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * await cms.delete('posts', '123');\r\n     * ```\r\n     */\r\n    delete?(collection: string, id: string | number): Promise<void>;\r\n\r\n    /**\r\n     * Get raw client for advanced operations.\r\n     * Type depends on the adapter.\r\n     */\r\n    getClient?(): unknown;\r\n}\r\n\r\n/**\r\n * CMS instance with fully typed adapter methods.\r\n */\r\nexport interface CMSInstance extends CMSAdapter {\r\n    /** The underlying adapter */\r\n    adapter: CMSAdapter;\r\n}\r\n\r\n// =============================================================================\r\n// Factory\r\n// =============================================================================\r\n\r\n/**\r\n * Create a CMS instance from an adapter.\r\n * \r\n * @param adapter - CMS adapter (strapi, contentful, sanity, etc.)\r\n * @returns CMS instance with unified API\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createCMS } from '@flightdev/cms';\r\n * import { strapi } from '@flightdev/cms/strapi';\r\n * \r\n * const cms = createCMS(strapi({\r\n *     url: 'http://localhost:1337',\r\n *     token: 'your-api-token',\r\n * }));\r\n * \r\n * // Same API regardless of CMS\r\n * const posts = await cms.findMany('posts');\r\n * ```\r\n */\r\nexport function createCMS(adapter: CMSAdapter): CMSInstance {\r\n    return {\r\n        name: adapter.name,\r\n        adapter,\r\n\r\n        findOne: adapter.findOne.bind(adapter),\r\n        findMany: adapter.findMany.bind(adapter),\r\n        findById: adapter.findById.bind(adapter),\r\n        create: adapter.create?.bind(adapter),\r\n        update: adapter.update?.bind(adapter),\r\n        delete: adapter.delete?.bind(adapter),\r\n        getClient: adapter.getClient?.bind(adapter),\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Utilities\r\n// =============================================================================\r\n\r\n/**\r\n * Type helper for CMS entities.\r\n */\r\nexport type CMSEntity<T = Record<string, unknown>> = T & {\r\n    id: string | number;\r\n    createdAt?: string;\r\n    updatedAt?: string;\r\n};\r\n\r\n/**\r\n * Type helper for media/asset fields.\r\n */\r\nexport interface CMSMedia {\r\n    id: string | number;\r\n    url: string;\r\n    alternativeText?: string;\r\n    caption?: string;\r\n    width?: number;\r\n    height?: number;\r\n    formats?: Record<string, {\r\n        url: string;\r\n        width: number;\r\n        height: number;\r\n    }>;\r\n    mime?: string;\r\n    size?: number;\r\n}\r\n\r\n/**\r\n * Helper to check if adapter supports write operations.\r\n */\r\nexport function isWritable(cms: CMSInstance): boolean {\r\n    return typeof cms.create === 'function';\r\n}\r\n\r\n/**\r\n * Helper to build where clauses from filters.\r\n */\r\nexport function buildWhere(\r\n    filters: Record<string, unknown>\r\n): Record<string, unknown> {\r\n    return Object.entries(filters).reduce((acc, [key, value]) => {\r\n        if (value !== undefined && value !== null) {\r\n            acc[key] = value;\r\n        }\r\n        return acc;\r\n    }, {} as Record<string, unknown>);\r\n}\r\n\r\n// Re-export types for convenience\r\nexport type {\r\n    CMSAdapter as Adapter,\r\n    CMSResult as Result,\r\n    CMSInstance as Instance,\r\n};\r\n"]}

package/dist/react/index.d.ts

@@ -0,0 +1,165 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { Instance as CMSInstance, FindOneOptions, FindManyOptions, Result as CMSResult } from '../index.js';
+
+interface CMSContextValue {
+    cms: CMSInstance;
+}
+/**
+ * CMS Provider component.
+ * Provides CMS instance to all child components.
+ *
+ * @example
+ * ```typescript
+ * <CMSProvider cms={cms}>
+ *     <App />
+ * </CMSProvider>
+ * ```
+ */
+declare function CMSProvider({ cms, children, }: {
+    cms: CMSInstance;
+    children: ReactNode;
+}): react.FunctionComponentElement<react.ProviderProps<CMSContextValue | null>>;
+/**
+ * Get CMS instance from context.
+ * Must be used within a CMSProvider.
+ */
+declare function useCMS(): CMSInstance;
+interface QueryState<T> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+}
+interface QueryResult<T> extends QueryState<T> {
+    refetch: () => Promise<void>;
+}
+interface ListQueryResult<T> extends Omit<QueryResult<T[]>, 'data'> {
+    data: T[];
+    meta: CMSResult<T>['meta'] | null;
+}
+/**
+ * Query a single entity from the CMS.
+ *
+ * @example
+ * ```typescript
+ * function PostPage({ slug }) {
+ *     const { data: post, loading, error } = useCMSOne('posts', {
+ *         where: { slug },
+ *         populate: ['author'],
+ *     });
+ *
+ *     if (loading) return <Skeleton />;
+ *     if (error || !post) return <NotFound />;
+ *
+ *     return <Post post={post} />;
+ * }
+ * ```
+ */
+declare function useCMSOne<T = unknown>(collection: string, options?: FindOneOptions): QueryResult<T>;
+/**
+ * Query multiple entities from the CMS with pagination.
+ *
+ * @example
+ * ```typescript
+ * function PostList() {
+ *     const { data: posts, meta, loading, refetch } = useCMSQuery('posts', {
+ *         limit: 10,
+ *         sort: { publishedAt: 'desc' },
+ *         populate: ['author', 'cover'],
+ *     });
+ *
+ *     return (
+ *         <div>
+ *             {posts.map(post => <PostCard key={post.id} post={post} />)}
+ *             {meta && <p>Total: {meta.total}</p>}
+ *             <button onClick={refetch}>Refresh</button>
+ *         </div>
+ *     );
+ * }
+ * ```
+ */
+declare function useCMSQuery<T = unknown>(collection: string, options?: FindManyOptions): ListQueryResult<T>;
+/**
+ * Query an entity by ID.
+ *
+ * @example
+ * ```typescript
+ * function PostPage({ id }) {
+ *     const { data: post, loading } = useCMSById('posts', id, {
+ *         populate: ['author'],
+ *     });
+ *
+ *     if (loading) return <Skeleton />;
+ *     return <Post post={post} />;
+ * }
+ * ```
+ */
+declare function useCMSById<T = unknown>(collection: string, id: string | number, options?: Omit<FindOneOptions, 'where'>): QueryResult<T>;
+interface MutationState<T> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+}
+interface MutationResult<T, TInput> extends MutationState<T> {
+    mutate: (input: TInput) => Promise<T>;
+    reset: () => void;
+}
+/**
+ * Create a new entity in the CMS.
+ *
+ * @example
+ * ```typescript
+ * function CreatePostForm() {
+ *     const { mutate, loading, error } = useCMSCreate<Post>('posts');
+ *
+ *     const handleSubmit = async (data) => {
+ *         const post = await mutate(data);
+ *         router.push(`/posts/${post.id}`);
+ *     };
+ *
+ *     return <form onSubmit={handleSubmit}>...</form>;
+ * }
+ * ```
+ */
+declare function useCMSCreate<T = unknown, TInput = Partial<T>>(collection: string): MutationResult<T, TInput>;
+/**
+ * Update an entity in the CMS.
+ *
+ * @example
+ * ```typescript
+ * function EditPostForm({ post }) {
+ *     const { mutate, loading } = useCMSUpdate<Post>('posts');
+ *
+ *     const handleSubmit = async (data) => {
+ *         await mutate(post.id, data);
+ *         toast('Post updated!');
+ *     };
+ *
+ *     return <form onSubmit={handleSubmit}>...</form>;
+ * }
+ * ```
+ */
+declare function useCMSUpdate<T = unknown, TInput = Partial<T>>(collection: string): MutationResult<T, {
+    id: string | number;
+    data: TInput;
+}>;
+/**
+ * Delete an entity from the CMS.
+ *
+ * @example
+ * ```typescript
+ * function DeleteButton({ post }) {
+ *     const { mutate, loading } = useCMSDelete('posts');
+ *
+ *     const handleDelete = async () => {
+ *         await mutate(post.id);
+ *         router.push('/posts');
+ *     };
+ *
+ *     return <button onClick={handleDelete} disabled={loading}>Delete</button>;
+ * }
+ * ```
+ */
+declare function useCMSDelete(collection: string): MutationResult<void, string | number>;
+
+export { CMSProvider, useCMS, useCMSById, useCMSCreate, useCMSDelete, useCMSOne, useCMSQuery, useCMSUpdate };

package/dist/react/index.js

@@ -0,0 +1,175 @@
+import { createContext, useMemo, createElement, useContext, useState, useCallback, useEffect } from 'react';
+
+// src/react/index.ts
+var CMSContext = createContext(null);
+function CMSProvider({
+  cms,
+  children
+}) {
+  const value = useMemo(() => ({ cms }), [cms]);
+  return createElement(CMSContext.Provider, { value }, children);
+}
+function useCMS() {
+  const context = useContext(CMSContext);
+  if (!context) {
+    throw new Error("useCMS must be used within a CMSProvider");
+  }
+  return context.cms;
+}
+function useCMSOne(collection, options) {
+  const cms = useCMS();
+  const [state, setState] = useState({
+    data: null,
+    loading: true,
+    error: null
+  });
+  const optionsKey = JSON.stringify(options);
+  const fetch = useCallback(async () => {
+    setState((prev) => ({ ...prev, loading: true, error: null }));
+    try {
+      const data = await cms.findOne(collection, options);
+      setState({ data, loading: false, error: null });
+    } catch (error) {
+      setState({ data: null, loading: false, error });
+    }
+  }, [cms, collection, optionsKey]);
+  useEffect(() => {
+    fetch();
+  }, [fetch]);
+  return { ...state, refetch: fetch };
+}
+function useCMSQuery(collection, options) {
+  const cms = useCMS();
+  const [state, setState] = useState({
+    data: [],
+    meta: null,
+    loading: true,
+    error: null
+  });
+  const optionsKey = JSON.stringify(options);
+  const fetch = useCallback(async () => {
+    setState((prev) => ({ ...prev, loading: true, error: null }));
+    try {
+      const result = await cms.findMany(collection, options);
+      setState({
+        data: result.data,
+        meta: result.meta,
+        loading: false,
+        error: null
+      });
+    } catch (error) {
+      setState((prev) => ({
+        ...prev,
+        loading: false,
+        error
+      }));
+    }
+  }, [cms, collection, optionsKey]);
+  useEffect(() => {
+    fetch();
+  }, [fetch]);
+  return { ...state, refetch: fetch };
+}
+function useCMSById(collection, id, options) {
+  const cms = useCMS();
+  const [state, setState] = useState({
+    data: null,
+    loading: true,
+    error: null
+  });
+  const optionsKey = JSON.stringify(options);
+  const fetch = useCallback(async () => {
+    setState((prev) => ({ ...prev, loading: true, error: null }));
+    try {
+      const data = await cms.findById(collection, id, options);
+      setState({ data, loading: false, error: null });
+    } catch (error) {
+      setState({ data: null, loading: false, error });
+    }
+  }, [cms, collection, id, optionsKey]);
+  useEffect(() => {
+    fetch();
+  }, [fetch]);
+  return { ...state, refetch: fetch };
+}
+function useCMSCreate(collection) {
+  const cms = useCMS();
+  const [state, setState] = useState({
+    data: null,
+    loading: false,
+    error: null
+  });
+  const mutate = useCallback(async (input) => {
+    if (!cms.create) {
+      throw new Error("CMS adapter does not support create operations");
+    }
+    setState({ data: null, loading: true, error: null });
+    try {
+      const data = await cms.create(collection, input);
+      setState({ data, loading: false, error: null });
+      return data;
+    } catch (error) {
+      setState({ data: null, loading: false, error });
+      throw error;
+    }
+  }, [cms, collection]);
+  const reset = useCallback(() => {
+    setState({ data: null, loading: false, error: null });
+  }, []);
+  return { ...state, mutate, reset };
+}
+function useCMSUpdate(collection) {
+  const cms = useCMS();
+  const [state, setState] = useState({
+    data: null,
+    loading: false,
+    error: null
+  });
+  const mutate = useCallback(async ({ id, data }) => {
+    if (!cms.update) {
+      throw new Error("CMS adapter does not support update operations");
+    }
+    setState({ data: null, loading: true, error: null });
+    try {
+      const result = await cms.update(collection, id, data);
+      setState({ data: result, loading: false, error: null });
+      return result;
+    } catch (error) {
+      setState({ data: null, loading: false, error });
+      throw error;
+    }
+  }, [cms, collection]);
+  const reset = useCallback(() => {
+    setState({ data: null, loading: false, error: null });
+  }, []);
+  return { ...state, mutate, reset };
+}
+function useCMSDelete(collection) {
+  const cms = useCMS();
+  const [state, setState] = useState({
+    data: null,
+    loading: false,
+    error: null
+  });
+  const mutate = useCallback(async (id) => {
+    if (!cms.delete) {
+      throw new Error("CMS adapter does not support delete operations");
+    }
+    setState({ data: null, loading: true, error: null });
+    try {
+      await cms.delete(collection, id);
+      setState({ data: void 0, loading: false, error: null });
+    } catch (error) {
+      setState({ data: null, loading: false, error });
+      throw error;
+    }
+  }, [cms, collection]);
+  const reset = useCallback(() => {
+    setState({ data: null, loading: false, error: null });
+  }, []);
+  return { ...state, mutate, reset };
+}
+
+export { CMSProvider, useCMS, useCMSById, useCMSCreate, useCMSDelete, useCMSOne, useCMSQuery, useCMSUpdate };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.ts"],"names":[],"mappings":";;;AAkDA,IAAM,UAAA,GAAa,cAAsC,IAAI,CAAA;AAatD,SAAS,WAAA,CAAY;AAAA,EACxB,GAAA;AAAA,EACA;AACJ,CAAA,EAGG;AACC,EAAA,MAAM,KAAA,GAAQ,QAAQ,OAAO,EAAE,KAAI,CAAA,EAAI,CAAC,GAAG,CAAC,CAAA;AAE5C,EAAA,OAAO,cAAc,UAAA,CAAW,QAAA,EAAU,EAAE,KAAA,IAAS,QAAQ,CAAA;AACjE;AAMO,SAAS,MAAA,GAAsB;AAClC,EAAA,MAAM,OAAA,GAAU,WAAW,UAAU,CAAA;AAErC,EAAA,IAAI,CAAC,OAAA,EAAS;AACV,IAAA,MAAM,IAAI,MAAM,0CAA0C,CAAA;AAAA,EAC9D;AAEA,EAAA,OAAO,OAAA,CAAQ,GAAA;AACnB;AAuCO,SAAS,SAAA,CACZ,YACA,OAAA,EACc;AACd,EAAA,MAAM,MAAM,MAAA,EAAO;AACnB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA,CAAwB;AAAA,IAC9C,IAAA,EAAM,IAAA;AAAA,IACN,OAAA,EAAS,IAAA;AAAA,IACT,KAAA,EAAO;AAAA,GACV,CAAA;AAGD,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA;AAEzC,EAAA,MAAM,KAAA,GAAQ,YAAY,YAAY;AAClC,IAAA,QAAA,CAAS,CAAA,IAAA,MAAS,EAAE,GAAG,IAAA,EAAM,SAAS,IAAA,EAAM,KAAA,EAAO,MAAK,CAAE,CAAA;AAE1D,IAAA,IAAI;AACA,MAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,OAAA,CAAW,YAAY,OAAO,CAAA;AACrD,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,MAAM,CAAA;AAAA,IAClD,SAAS,KAAA,EAAO;AACZ,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,OAAuB,CAAA;AAAA,IAClE;AAAA,EACJ,CAAA,EAAG,CAAC,GAAA,EAAK,UAAA,EAAY,UAAU,CAAC,CAAA;AAEhC,EAAA,SAAA,CAAU,MAAM;AACZ,IAAA,KAAA,EAAM;AAAA,EACV,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,EAAE,GAAG,KAAA,EAAO,OAAA,EAAS,KAAA,EAAM;AACtC;AAwBO,SAAS,WAAA,CACZ,YACA,OAAA,EACkB;AAClB,EAAA,MAAM,MAAM,MAAA,EAAO;AACnB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA,CAKvB;AAAA,IACC,MAAM,EAAC;AAAA,IACP,IAAA,EAAM,IAAA;AAAA,IACN,OAAA,EAAS,IAAA;AAAA,IACT,KAAA,EAAO;AAAA,GACV,CAAA;AAED,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA;AAEzC,EAAA,MAAM,KAAA,GAAQ,YAAY,YAAY;AAClC,IAAA,QAAA,CAAS,CAAA,IAAA,MAAS,EAAE,GAAG,IAAA,EAAM,SAAS,IAAA,EAAM,KAAA,EAAO,MAAK,CAAE,CAAA;AAE1D,IAAA,IAAI;AACA,MAAA,MAAM,MAAA,GAAS,MAAM,GAAA,CAAI,QAAA,CAAY,YAAY,OAAO,CAAA;AACxD,MAAA,QAAA,CAAS;AAAA,QACL,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,OAAA,EAAS,KAAA;AAAA,QACT,KAAA,EAAO;AAAA,OACV,CAAA;AAAA,IACL,SAAS,KAAA,EAAO;AACZ,MAAA,QAAA,CAAS,CAAA,IAAA,MAAS;AAAA,QACd,GAAG,IAAA;AAAA,QACH,OAAA,EAAS,KAAA;AAAA,QACT;AAAA,OACJ,CAAE,CAAA;AAAA,IACN;AAAA,EACJ,CAAA,EAAG,CAAC,GAAA,EAAK,UAAA,EAAY,UAAU,CAAC,CAAA;AAEhC,EAAA,SAAA,CAAU,MAAM;AACZ,IAAA,KAAA,EAAM;AAAA,EACV,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,EAAE,GAAG,KAAA,EAAO,OAAA,EAAS,KAAA,EAAM;AACtC;AAiBO,SAAS,UAAA,CACZ,UAAA,EACA,EAAA,EACA,OAAA,EACc;AACd,EAAA,MAAM,MAAM,MAAA,EAAO;AACnB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA,CAAwB;AAAA,IAC9C,IAAA,EAAM,IAAA;AAAA,IACN,OAAA,EAAS,IAAA;AAAA,IACT,KAAA,EAAO;AAAA,GACV,CAAA;AAED,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA;AAEzC,EAAA,MAAM,KAAA,GAAQ,YAAY,YAAY;AAClC,IAAA,QAAA,CAAS,CAAA,IAAA,MAAS,EAAE,GAAG,IAAA,EAAM,SAAS,IAAA,EAAM,KAAA,EAAO,MAAK,CAAE,CAAA;AAE1D,IAAA,IAAI;AACA,MAAA,MAAM,OAAO,MAAM,GAAA,CAAI,QAAA,CAAY,UAAA,EAAY,IAAI,OAAO,CAAA;AAC1D,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,MAAM,CAAA;AAAA,IAClD,SAAS,KAAA,EAAO;AACZ,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,OAAuB,CAAA;AAAA,IAClE;AAAA,EACJ,GAAG,CAAC,GAAA,EAAK,UAAA,EAAY,EAAA,EAAI,UAAU,CAAC,CAAA;AAEpC,EAAA,SAAA,CAAU,MAAM;AACZ,IAAA,KAAA,EAAM;AAAA,EACV,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,EAAE,GAAG,KAAA,EAAO,OAAA,EAAS,KAAA,EAAM;AACtC;AAkCO,SAAS,aACZ,UAAA,EACyB;AACzB,EAAA,MAAM,MAAM,MAAA,EAAO;AACnB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA,CAA2B;AAAA,IACjD,IAAA,EAAM,IAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IACT,KAAA,EAAO;AAAA,GACV,CAAA;AAED,EAAA,MAAM,MAAA,GAAS,WAAA,CAAY,OAAO,KAAA,KAA8B;AAC5D,IAAA,IAAI,CAAC,IAAI,MAAA,EAAQ;AACb,MAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,IACpE;AAEA,IAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,SAAS,IAAA,EAAM,KAAA,EAAO,MAAM,CAAA;AAEnD,IAAA,IAAI;AACA,MAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,MAAA,CAAU,YAAY,KAAmB,CAAA;AAChE,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,MAAM,CAAA;AAC9C,MAAA,OAAO,IAAA;AAAA,IACX,SAAS,KAAA,EAAO;AACZ,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,OAAuB,CAAA;AAC9D,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ,CAAA,EAAG,CAAC,GAAA,EAAK,UAAU,CAAC,CAAA;AAEpB,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC5B,IAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,SAAS,KAAA,EAAO,KAAA,EAAO,MAAM,CAAA;AAAA,EACxD,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,EAAE,GAAG,KAAA,EAAO,MAAA,EAAQ,KAAA,EAAM;AACrC;AAmBO,SAAS,aACZ,UAAA,EACwD;AACxD,EAAA,MAAM,MAAM,MAAA,EAAO;AACnB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA,CAA2B;AAAA,IACjD,IAAA,EAAM,IAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IACT,KAAA,EAAO;AAAA,GACV,CAAA;AAED,EAAA,MAAM,SAAS,WAAA,CAAY,OAAO,EAAE,EAAA,EAAI,MAAK,KAAyD;AAClG,IAAA,IAAI,CAAC,IAAI,MAAA,EAAQ;AACb,MAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,IACpE;AAEA,IAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,SAAS,IAAA,EAAM,KAAA,EAAO,MAAM,CAAA;AAEnD,IAAA,IAAI;AACA,MAAA,MAAM,SAAS,MAAM,GAAA,CAAI,MAAA,CAAU,UAAA,EAAY,IAAI,IAAkB,CAAA;AACrE,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,KAAA,EAAO,KAAA,EAAO,MAAM,CAAA;AACtD,MAAA,OAAO,MAAA;AAAA,IACX,SAAS,KAAA,EAAO;AACZ,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,OAAuB,CAAA;AAC9D,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ,CAAA,EAAG,CAAC,GAAA,EAAK,UAAU,CAAC,CAAA;AAEpB,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC5B,IAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,SAAS,KAAA,EAAO,KAAA,EAAO,MAAM,CAAA;AAAA,EACxD,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,EAAE,GAAG,KAAA,EAAO,MAAA,EAAQ,KAAA,EAAM;AACrC;AAmBO,SAAS,aACZ,UAAA,EACqC;AACrC,EAAA,MAAM,MAAM,MAAA,EAAO;AACnB,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA,CAA8B;AAAA,IACpD,IAAA,EAAM,IAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IACT,KAAA,EAAO;AAAA,GACV,CAAA;AAED,EAAA,MAAM,MAAA,GAAS,WAAA,CAAY,OAAO,EAAA,KAAuC;AACrE,IAAA,IAAI,CAAC,IAAI,MAAA,EAAQ;AACb,MAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,IACpE;AAEA,IAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,SAAS,IAAA,EAAM,KAAA,EAAO,MAAM,CAAA;AAEnD,IAAA,IAAI;AACA,MAAA,MAAM,GAAA,CAAI,MAAA,CAAO,UAAA,EAAY,EAAE,CAAA;AAC/B,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,KAAA,CAAA,EAAW,SAAS,KAAA,EAAO,KAAA,EAAO,MAAM,CAAA;AAAA,IAC7D,SAAS,KAAA,EAAO;AACZ,MAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,OAAuB,CAAA;AAC9D,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ,CAAA,EAAG,CAAC,GAAA,EAAK,UAAU,CAAC,CAAA;AAEpB,EAAA,MAAM,KAAA,GAAQ,YAAY,MAAM;AAC5B,IAAA,QAAA,CAAS,EAAE,IAAA,EAAM,IAAA,EAAM,SAAS,KAAA,EAAO,KAAA,EAAO,MAAM,CAAA;AAAA,EACxD,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,EAAE,GAAG,KAAA,EAAO,MAAA,EAAQ,KAAA,EAAM;AACrC","file":"index.js","sourcesContent":["/**\r\n * React hooks for @flightdev/cms\r\n * \r\n * @example\r\n * ```typescript\r\n * import { CMSProvider, useCMS, useCMSQuery } from '@flightdev/cms/react';\r\n * import { createCMS } from '@flightdev/cms';\r\n * import { strapi } from '@flightdev/cms/strapi';\r\n * \r\n * const cms = createCMS(strapi({ url: '...', token: '...' }));\r\n * \r\n * function App() {\r\n *     return (\r\n *         <CMSProvider cms={cms}>\r\n *             <PostList />\r\n *         </CMSProvider>\r\n *     );\r\n * }\r\n * \r\n * function PostList() {\r\n *     const { data, loading, error } = useCMSQuery('posts', { limit: 10 });\r\n *     \r\n *     if (loading) return <div>Loading...</div>;\r\n *     if (error) return <div>Error: {error.message}</div>;\r\n *     \r\n *     return <ul>{data.map(post => <li key={post.id}>{post.title}</li>)}</ul>;\r\n * }\r\n * ```\r\n */\r\n\r\nimport {\r\n    createContext,\r\n    useContext,\r\n    useState,\r\n    useEffect,\r\n    useCallback,\r\n    useMemo,\r\n    createElement,\r\n    type ReactNode,\r\n} from 'react';\r\nimport type { CMSInstance, CMSResult, FindManyOptions, FindOneOptions } from '../index';\r\n\r\n// =============================================================================\r\n// Context\r\n// =============================================================================\r\n\r\ninterface CMSContextValue {\r\n    cms: CMSInstance;\r\n}\r\n\r\nconst CMSContext = createContext<CMSContextValue | null>(null);\r\n\r\n/**\r\n * CMS Provider component.\r\n * Provides CMS instance to all child components.\r\n * \r\n * @example\r\n * ```typescript\r\n * <CMSProvider cms={cms}>\r\n *     <App />\r\n * </CMSProvider>\r\n * ```\r\n */\r\nexport function CMSProvider({\r\n    cms,\r\n    children,\r\n}: {\r\n    cms: CMSInstance;\r\n    children: ReactNode;\r\n}) {\r\n    const value = useMemo(() => ({ cms }), [cms]);\r\n\r\n    return createElement(CMSContext.Provider, { value }, children);\r\n}\r\n\r\n/**\r\n * Get CMS instance from context.\r\n * Must be used within a CMSProvider.\r\n */\r\nexport function useCMS(): CMSInstance {\r\n    const context = useContext(CMSContext);\r\n\r\n    if (!context) {\r\n        throw new Error('useCMS must be used within a CMSProvider');\r\n    }\r\n\r\n    return context.cms;\r\n}\r\n\r\n// =============================================================================\r\n// Query Hooks\r\n// =============================================================================\r\n\r\ninterface QueryState<T> {\r\n    data: T | null;\r\n    loading: boolean;\r\n    error: Error | null;\r\n}\r\n\r\ninterface QueryResult<T> extends QueryState<T> {\r\n    refetch: () => Promise<void>;\r\n}\r\n\r\ninterface ListQueryResult<T> extends Omit<QueryResult<T[]>, 'data'> {\r\n    data: T[];\r\n    meta: CMSResult<T>['meta'] | null;\r\n}\r\n\r\n/**\r\n * Query a single entity from the CMS.\r\n * \r\n * @example\r\n * ```typescript\r\n * function PostPage({ slug }) {\r\n *     const { data: post, loading, error } = useCMSOne('posts', {\r\n *         where: { slug },\r\n *         populate: ['author'],\r\n *     });\r\n *     \r\n *     if (loading) return <Skeleton />;\r\n *     if (error || !post) return <NotFound />;\r\n *     \r\n *     return <Post post={post} />;\r\n * }\r\n * ```\r\n */\r\nexport function useCMSOne<T = unknown>(\r\n    collection: string,\r\n    options?: FindOneOptions\r\n): QueryResult<T> {\r\n    const cms = useCMS();\r\n    const [state, setState] = useState<QueryState<T>>({\r\n        data: null,\r\n        loading: true,\r\n        error: null,\r\n    });\r\n\r\n    // Memoize options to prevent infinite loops\r\n    const optionsKey = JSON.stringify(options);\r\n\r\n    const fetch = useCallback(async () => {\r\n        setState(prev => ({ ...prev, loading: true, error: null }));\r\n\r\n        try {\r\n            const data = await cms.findOne<T>(collection, options);\r\n            setState({ data, loading: false, error: null });\r\n        } catch (error) {\r\n            setState({ data: null, loading: false, error: error as Error });\r\n        }\r\n    }, [cms, collection, optionsKey]);\r\n\r\n    useEffect(() => {\r\n        fetch();\r\n    }, [fetch]);\r\n\r\n    return { ...state, refetch: fetch };\r\n}\r\n\r\n/**\r\n * Query multiple entities from the CMS with pagination.\r\n * \r\n * @example\r\n * ```typescript\r\n * function PostList() {\r\n *     const { data: posts, meta, loading, refetch } = useCMSQuery('posts', {\r\n *         limit: 10,\r\n *         sort: { publishedAt: 'desc' },\r\n *         populate: ['author', 'cover'],\r\n *     });\r\n *     \r\n *     return (\r\n *         <div>\r\n *             {posts.map(post => <PostCard key={post.id} post={post} />)}\r\n *             {meta && <p>Total: {meta.total}</p>}\r\n *             <button onClick={refetch}>Refresh</button>\r\n *         </div>\r\n *     );\r\n * }\r\n * ```\r\n */\r\nexport function useCMSQuery<T = unknown>(\r\n    collection: string,\r\n    options?: FindManyOptions\r\n): ListQueryResult<T> {\r\n    const cms = useCMS();\r\n    const [state, setState] = useState<{\r\n        data: T[];\r\n        meta: CMSResult<T>['meta'] | null;\r\n        loading: boolean;\r\n        error: Error | null;\r\n    }>({\r\n        data: [],\r\n        meta: null,\r\n        loading: true,\r\n        error: null,\r\n    });\r\n\r\n    const optionsKey = JSON.stringify(options);\r\n\r\n    const fetch = useCallback(async () => {\r\n        setState(prev => ({ ...prev, loading: true, error: null }));\r\n\r\n        try {\r\n            const result = await cms.findMany<T>(collection, options);\r\n            setState({\r\n                data: result.data,\r\n                meta: result.meta,\r\n                loading: false,\r\n                error: null,\r\n            });\r\n        } catch (error) {\r\n            setState(prev => ({\r\n                ...prev,\r\n                loading: false,\r\n                error: error as Error,\r\n            }));\r\n        }\r\n    }, [cms, collection, optionsKey]);\r\n\r\n    useEffect(() => {\r\n        fetch();\r\n    }, [fetch]);\r\n\r\n    return { ...state, refetch: fetch };\r\n}\r\n\r\n/**\r\n * Query an entity by ID.\r\n * \r\n * @example\r\n * ```typescript\r\n * function PostPage({ id }) {\r\n *     const { data: post, loading } = useCMSById('posts', id, {\r\n *         populate: ['author'],\r\n *     });\r\n *     \r\n *     if (loading) return <Skeleton />;\r\n *     return <Post post={post} />;\r\n * }\r\n * ```\r\n */\r\nexport function useCMSById<T = unknown>(\r\n    collection: string,\r\n    id: string | number,\r\n    options?: Omit<FindOneOptions, 'where'>\r\n): QueryResult<T> {\r\n    const cms = useCMS();\r\n    const [state, setState] = useState<QueryState<T>>({\r\n        data: null,\r\n        loading: true,\r\n        error: null,\r\n    });\r\n\r\n    const optionsKey = JSON.stringify(options);\r\n\r\n    const fetch = useCallback(async () => {\r\n        setState(prev => ({ ...prev, loading: true, error: null }));\r\n\r\n        try {\r\n            const data = await cms.findById<T>(collection, id, options);\r\n            setState({ data, loading: false, error: null });\r\n        } catch (error) {\r\n            setState({ data: null, loading: false, error: error as Error });\r\n        }\r\n    }, [cms, collection, id, optionsKey]);\r\n\r\n    useEffect(() => {\r\n        fetch();\r\n    }, [fetch]);\r\n\r\n    return { ...state, refetch: fetch };\r\n}\r\n\r\n// =============================================================================\r\n// Mutation Hooks\r\n// =============================================================================\r\n\r\ninterface MutationState<T> {\r\n    data: T | null;\r\n    loading: boolean;\r\n    error: Error | null;\r\n}\r\n\r\ninterface MutationResult<T, TInput> extends MutationState<T> {\r\n    mutate: (input: TInput) => Promise<T>;\r\n    reset: () => void;\r\n}\r\n\r\n/**\r\n * Create a new entity in the CMS.\r\n * \r\n * @example\r\n * ```typescript\r\n * function CreatePostForm() {\r\n *     const { mutate, loading, error } = useCMSCreate<Post>('posts');\r\n *     \r\n *     const handleSubmit = async (data) => {\r\n *         const post = await mutate(data);\r\n *         router.push(`/posts/${post.id}`);\r\n *     };\r\n *     \r\n *     return <form onSubmit={handleSubmit}>...</form>;\r\n * }\r\n * ```\r\n */\r\nexport function useCMSCreate<T = unknown, TInput = Partial<T>>(\r\n    collection: string\r\n): MutationResult<T, TInput> {\r\n    const cms = useCMS();\r\n    const [state, setState] = useState<MutationState<T>>({\r\n        data: null,\r\n        loading: false,\r\n        error: null,\r\n    });\r\n\r\n    const mutate = useCallback(async (input: TInput): Promise<T> => {\r\n        if (!cms.create) {\r\n            throw new Error('CMS adapter does not support create operations');\r\n        }\r\n\r\n        setState({ data: null, loading: true, error: null });\r\n\r\n        try {\r\n            const data = await cms.create<T>(collection, input as Partial<T>);\r\n            setState({ data, loading: false, error: null });\r\n            return data;\r\n        } catch (error) {\r\n            setState({ data: null, loading: false, error: error as Error });\r\n            throw error;\r\n        }\r\n    }, [cms, collection]);\r\n\r\n    const reset = useCallback(() => {\r\n        setState({ data: null, loading: false, error: null });\r\n    }, []);\r\n\r\n    return { ...state, mutate, reset };\r\n}\r\n\r\n/**\r\n * Update an entity in the CMS.\r\n * \r\n * @example\r\n * ```typescript\r\n * function EditPostForm({ post }) {\r\n *     const { mutate, loading } = useCMSUpdate<Post>('posts');\r\n *     \r\n *     const handleSubmit = async (data) => {\r\n *         await mutate(post.id, data);\r\n *         toast('Post updated!');\r\n *     };\r\n *     \r\n *     return <form onSubmit={handleSubmit}>...</form>;\r\n * }\r\n * ```\r\n */\r\nexport function useCMSUpdate<T = unknown, TInput = Partial<T>>(\r\n    collection: string\r\n): MutationResult<T, { id: string | number; data: TInput }> {\r\n    const cms = useCMS();\r\n    const [state, setState] = useState<MutationState<T>>({\r\n        data: null,\r\n        loading: false,\r\n        error: null,\r\n    });\r\n\r\n    const mutate = useCallback(async ({ id, data }: { id: string | number; data: TInput }): Promise<T> => {\r\n        if (!cms.update) {\r\n            throw new Error('CMS adapter does not support update operations');\r\n        }\r\n\r\n        setState({ data: null, loading: true, error: null });\r\n\r\n        try {\r\n            const result = await cms.update<T>(collection, id, data as Partial<T>);\r\n            setState({ data: result, loading: false, error: null });\r\n            return result;\r\n        } catch (error) {\r\n            setState({ data: null, loading: false, error: error as Error });\r\n            throw error;\r\n        }\r\n    }, [cms, collection]);\r\n\r\n    const reset = useCallback(() => {\r\n        setState({ data: null, loading: false, error: null });\r\n    }, []);\r\n\r\n    return { ...state, mutate, reset };\r\n}\r\n\r\n/**\r\n * Delete an entity from the CMS.\r\n * \r\n * @example\r\n * ```typescript\r\n * function DeleteButton({ post }) {\r\n *     const { mutate, loading } = useCMSDelete('posts');\r\n *     \r\n *     const handleDelete = async () => {\r\n *         await mutate(post.id);\r\n *         router.push('/posts');\r\n *     };\r\n *     \r\n *     return <button onClick={handleDelete} disabled={loading}>Delete</button>;\r\n * }\r\n * ```\r\n */\r\nexport function useCMSDelete(\r\n    collection: string\r\n): MutationResult<void, string | number> {\r\n    const cms = useCMS();\r\n    const [state, setState] = useState<MutationState<void>>({\r\n        data: null,\r\n        loading: false,\r\n        error: null,\r\n    });\r\n\r\n    const mutate = useCallback(async (id: string | number): Promise<void> => {\r\n        if (!cms.delete) {\r\n            throw new Error('CMS adapter does not support delete operations');\r\n        }\r\n\r\n        setState({ data: null, loading: true, error: null });\r\n\r\n        try {\r\n            await cms.delete(collection, id);\r\n            setState({ data: undefined, loading: false, error: null });\r\n        } catch (error) {\r\n            setState({ data: null, loading: false, error: error as Error });\r\n            throw error;\r\n        }\r\n    }, [cms, collection]);\r\n\r\n    const reset = useCallback(() => {\r\n        setState({ data: null, loading: false, error: null });\r\n    }, []);\r\n\r\n    return { ...state, mutate, reset };\r\n}\r\n"]}