@btst/stack 2.12.2 → 3.0.0-rc.2

package/dist/plugins/cms/client/index.d.ts

@@ -1,10 +1,12 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _btst_yar from '@btst/yar';
+import * as React from 'react';
 import { ComponentType } from 'react';
+import { D as DashboardPageComponent } from '../../../shared/stack.DIZh2qIJ.js';
 import { QueryClient } from '@tanstack/react-query';
 import { A as AutoFormInputComponentProps } from '../../../shared/stack.CPsYC2-Z.js';
 export { b as FormSchemaMetadata, F as FormStep, f as formSchemaToZod, a as getStepGroupMap, g as getSteps, h as hasSteps, z as zodToFormSchema } from '../../../shared/stack.Co034Fpm.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react-hook-form';
 import 'zod';
 
@@ -104,16 +106,22 @@ interface CMSClientConfig {
         dashboard?: ComponentType;
         /** Replaces the content list page */
         contentList?: ComponentType<{
-            typeSlug: string;
+            params: {
+                typeSlug: string;
+            };
         }>;
         /** Replaces the new content editor page */
         newContent?: ComponentType<{
-            typeSlug: string;
+            params: {
+                typeSlug: string;
+            };
         }>;
         /** Replaces the edit content editor page */
         editContent?: ComponentType<{
-            typeSlug: string;
-            id: string;
+            params: {
+                typeSlug: string;
+                id: string;
+            };
         }>;
     };
 }
@@ -122,99 +130,89 @@ interface CMSClientConfig {
  * Provides routes and components for the CMS admin interface
  */
 declare const cmsClientPlugin: (config: CMSClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
-    dashboard: {
-        (inputCtx_0?: _btst_yar.InputContext<"/cms", _btst_yar.RouteOptions> | undefined): {
-            PageComponent?: ComponentType<{}> | undefined;
-            LoadingComponent?: ComponentType<{}> | undefined;
-            ErrorComponent?: ComponentType<{}> | undefined;
-            loader?: (() => Promise<void>) | undefined;
-            meta?: (() => ({
-                title: string;
-                name?: undefined;
-                content?: undefined;
-            } | {
-                name: string;
-                content: string;
-                title?: undefined;
-            })[]) | undefined;
-            extra?: (() => any) | undefined;
-        };
-        options: _btst_yar.RouteOptions | undefined;
-        path: "/cms";
-        meta: _btst_yar.RouteMeta | undefined;
-    };
-    contentList: {
-        (inputCtx_0: _btst_yar.InputContext<"/cms/:typeSlug", _btst_yar.RouteOptions>): {
-            PageComponent?: ComponentType<unknown> | undefined;
-            LoadingComponent?: ComponentType<unknown> | undefined;
-            ErrorComponent?: ComponentType<unknown> | undefined;
-            loader?: (() => Promise<void>) | undefined;
-            meta?: (() => ({
-                title: string;
-                name?: undefined;
-                content?: undefined;
-            } | {
-                name: string;
-                content: string;
-                title?: undefined;
-            })[]) | undefined;
-            extra?: (() => any) | undefined;
-        };
-        options: _btst_yar.RouteOptions | undefined;
-        path: "/cms/:typeSlug";
-        meta: _btst_yar.RouteMeta | undefined;
-    };
-    newContent: {
-        (inputCtx_0: _btst_yar.InputContext<"/cms/:typeSlug/new", _btst_yar.RouteOptions>): {
-            PageComponent?: ComponentType<unknown> | undefined;
-            LoadingComponent?: ComponentType<unknown> | undefined;
-            ErrorComponent?: ComponentType<unknown> | undefined;
-            loader?: (() => Promise<void>) | undefined;
-            meta?: (() => ({
-                title: string;
-                name?: undefined;
-                content?: undefined;
-            } | {
-                name: string;
-                content: string;
-                title?: undefined;
-            })[]) | undefined;
-            extra?: (() => any) | undefined;
-        };
-        options: _btst_yar.RouteOptions | undefined;
-        path: "/cms/:typeSlug/new";
-        meta: _btst_yar.RouteMeta | undefined;
-    };
-    editContent: {
-        (inputCtx_0: _btst_yar.InputContext<"/cms/:typeSlug/:id", _btst_yar.RouteOptions>): {
-            PageComponent?: ComponentType<unknown> | undefined;
-            LoadingComponent?: ComponentType<unknown> | undefined;
-            ErrorComponent?: ComponentType<unknown> | undefined;
-            loader?: (() => Promise<void>) | undefined;
-            meta?: (() => ({
-                title: string;
-                name?: undefined;
-                content?: undefined;
-            } | {
-                name: string;
-                content: string;
-                title?: undefined;
-            })[]) | undefined;
-            extra?: (() => any) | undefined;
-        };
-        options: _btst_yar.RouteOptions | undefined;
-        path: "/cms/:typeSlug/:id";
-        meta: _btst_yar.RouteMeta | undefined;
-    };
+    dashboard: _btst_yar.DefinedRoute<"/cms", {
+        readonly page: React.LazyExoticComponent<typeof DashboardPageComponent>;
+        readonly loader: () => Promise<void>;
+        readonly meta: () => ({
+            title: string;
+            name?: undefined;
+            content?: undefined;
+        } | {
+            name: string;
+            content: string;
+            title?: undefined;
+        })[];
+    }, _btst_yar.RouteMeta>;
+    contentList: _btst_yar.DefinedRoute<"/cms/:typeSlug", {
+        readonly page: ({ params }: _btst_yar.RouteContext<"/cms/:typeSlug", _btst_yar.RouteOptions>) => react_jsx_runtime.JSX.Element;
+        readonly loader: ({ params }: _btst_yar.RouteContext<"/cms/:typeSlug", _btst_yar.RouteOptions>) => Promise<void>;
+        readonly meta: ({ params }: _btst_yar.RouteContext<"/cms/:typeSlug", _btst_yar.RouteOptions>) => ({
+            title: string;
+            name?: undefined;
+            content?: undefined;
+        } | {
+            name: string;
+            content: string;
+            title?: undefined;
+        })[];
+    }, _btst_yar.RouteMeta>;
+    newContent: _btst_yar.DefinedRoute<"/cms/:typeSlug/new", {
+        readonly page: ({ params }: _btst_yar.RouteContext<"/cms/:typeSlug/new", _btst_yar.RouteOptions>) => react_jsx_runtime.JSX.Element;
+        readonly loader: ({ params }: _btst_yar.RouteContext<"/cms/:typeSlug/new", _btst_yar.RouteOptions>) => Promise<void>;
+        readonly meta: ({ params }: _btst_yar.RouteContext<"/cms/:typeSlug/new", _btst_yar.RouteOptions>) => ({
+            title: string;
+            name?: undefined;
+            content?: undefined;
+        } | {
+            name: string;
+            content: string;
+            title?: undefined;
+        })[];
+    }, _btst_yar.RouteMeta>;
+    editContent: _btst_yar.DefinedRoute<"/cms/:typeSlug/:id", {
+        readonly page: ({ params }: _btst_yar.RouteContext<"/cms/:typeSlug/:id", _btst_yar.RouteOptions>) => react_jsx_runtime.JSX.Element;
+        readonly loader: ({ params }: _btst_yar.RouteContext<"/cms/:typeSlug/:id", _btst_yar.RouteOptions>) => Promise<void>;
+        readonly meta: ({ params }: _btst_yar.RouteContext<"/cms/:typeSlug/:id", _btst_yar.RouteOptions>) => ({
+            title: string;
+            name?: undefined;
+            content?: undefined;
+        } | {
+            name: string;
+            content: string;
+            title?: undefined;
+        })[];
+    }, _btst_yar.RouteMeta>;
 }>;
 
 declare const CMS_LOCALIZATION: {
+    CMS_RELATION_LOADING: string;
+    CMS_RELATION_SELECT_PLACEHOLDER: string;
+    CMS_RELATION_SELECT_PLACEHOLDER_MULTI: string;
+    CMS_RELATION_EMPTY: string;
+    CMS_RELATION_CREATE_TITLE: string;
+    CMS_RELATION_NAME_PLACEHOLDER: string;
+    CMS_RELATION_DESCRIPTION_LABEL: string;
+    CMS_RELATION_DESCRIPTION_PLACEHOLDER: string;
+    CMS_RELATION_CREATE_BUTTON: string;
+    CMS_RELATION_CREATING: string;
+    CMS_RELATION_CREATE_ERROR: string;
+    CMS_RELATED_ITEMS_TITLE: string;
+    CMS_RELATED_EMPTY: string;
+    CMS_RELATED_ADD: string;
+    CMS_RELATED_DELETE_TITLE: string;
+    CMS_RELATED_DELETE_DESCRIPTION: string;
+    CMS_RELATED_DELETE_ERROR: string;
     CMS_EDITOR_TITLE_NEW: string;
     CMS_EDITOR_TITLE_EDIT: string;
     CMS_EDITOR_SLUG_AUTO: string;
     CMS_EDITOR_SLUG_MANUAL: string;
     CMS_EDITOR_DELETE_CONFIRM: string;
     CMS_EDITOR_UNSAVED_CHANGES: string;
+    CMS_EDITOR_SLUG_PLACEHOLDER: string;
+    CMS_EDITOR_SLUG_PLACEHOLDER_AUTO: string;
+    CMS_EDITOR_SLUG_REQUIRED: string;
+    CMS_EDITOR_FILE_INVALID_TYPE: string;
+    CMS_EDITOR_FILE_UPLOAD_FAILED: string;
     CMS_LIST_TITLE: string;
     CMS_LIST_EMPTY: string;
     CMS_LIST_EMPTY_DESCRIPTION: string;
@@ -227,6 +225,9 @@ declare const CMS_LOCALIZATION: {
     CMS_LIST_PAGINATION_SHOWING: string;
     CMS_LIST_PAGINATION_PREVIOUS: string;
     CMS_LIST_PAGINATION_NEXT: string;
+    CMS_LIST_SEARCH_PLACEHOLDER: string;
+    CMS_LIST_SEARCH_EMPTY: string;
+    CMS_LIST_SEARCH_EMPTY_DESCRIPTION: string;
     CMS_DASHBOARD_TITLE: string;
     CMS_DASHBOARD_SUBTITLE: string;
     CMS_DASHBOARD_NO_TYPES: string;
@@ -257,6 +258,11 @@ declare const CMS_LOCALIZATION: {
     CMS_ERROR_GENERIC: string;
     CMS_ERROR_NOT_FOUND: string;
     CMS_ERROR_VALIDATION: string;
+    CMS_ERROR_TYPE_NOT_FOUND_DESCRIPTION: string;
+    CMS_ERROR_ITEM_NOT_FOUND_DESCRIPTION: string;
+    CMS_404_TITLE: string;
+    CMS_404_DESCRIPTION: string;
+    CMS_404_BACK: string;
     CMS_ATTRIBUTION: string;
 };
 type CMSLocalization = typeof CMS_LOCALIZATION;
@@ -288,26 +294,10 @@ interface RouteContext {
 /**
  * Overridable components and functions for the CMS plugin
  *
- * External consumers can provide their own implementations of these
- * to customize the behavior for their framework (Next.js, React Router, etc.)
+ * External consumers can provide their own implementations to customize
+ * plugin-specific components and behavior.
  */
 interface CMSPluginOverrides {
-    /**
-     * Link component for navigation
-     */
-    Link?: ComponentType<React.ComponentProps<"a"> & Record<string, unknown>>;
-    /**
-     * Navigation function for programmatic navigation
-     */
-    navigate: (path: string) => void | Promise<void>;
-    /**
-     * Refresh function to invalidate server-side cache (e.g., Next.js router.refresh())
-     */
-    refresh?: () => void | Promise<void>;
-    /**
-     * Image component for displaying images
-     */
-    Image?: ComponentType<React.ImgHTMLAttributes<HTMLImageElement> & Record<string, unknown>>;
     /**
      * Function used to upload a new image file and return its URL.
      * Used by the default "file" field component when not selecting an existing
@@ -395,14 +385,6 @@ interface CMSPluginOverrides {
      * Localization object for the CMS plugin
      */
     localization?: CMSLocalization;
-    /**
-     * API base URL
-     */
-    apiBaseURL: string;
-    /**
-     * API base path
-     */
-    apiBasePath: string;
     /**
      * Whether to show the attribution
      */
@@ -424,27 +406,6 @@ interface CMSPluginOverrides {
      * @param context - Route context
      */
     onRouteError?: (routeName: string, error: Error, context: RouteContext) => void | Promise<void>;
-    /**
-     * Called before the dashboard page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @param context - Route context
-     */
-    onBeforeDashboardRendered?: (context: RouteContext) => boolean;
-    /**
-     * Called before the content list page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @param typeSlug - The content type slug
-     * @param context - Route context
-     */
-    onBeforeListRendered?: (typeSlug: string, context: RouteContext) => boolean;
-    /**
-     * Called before the content editor page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @param typeSlug - The content type slug
-     * @param id - The content item ID (null for new items)
-     * @param context - Route context
-     */
-    onBeforeEditorRendered?: (typeSlug: string, id: string | null, context: RouteContext) => boolean;
 }
 
 /**

package/dist/plugins/cms/query-keys.cjs

@@ -1,138 +1,172 @@
 'use strict';
 
-const queryKeyFactory = require('@lukemorales/query-key-factory');
+const client = require('@btst/stack/plugins/client');
 const queryKeyDefs = require('../../packages/stack/src/plugins/cms/api/query-key-defs.cjs');
 
-function isErrorResponse(response) {
-  if (typeof response !== "object" || response === null) {
-    return false;
-  }
-  const obj = response;
-  return "error" in obj && obj.error !== null && obj.error !== void 0;
-}
-function toError(error) {
-  if (error instanceof Error) {
-    return error;
-  }
-  if (typeof error === "object" && error !== null) {
-    const errorObj = error;
-    const message = (typeof errorObj.message === "string" ? errorObj.message : null) || (typeof errorObj.error === "string" ? errorObj.error : null) || JSON.stringify(error);
-    const err = new Error(message);
-    Object.assign(err, error);
-    return err;
-  }
-  return new Error(String(error));
-}
-function createCMSQueryKeys(client, headers) {
-  const contentTypes = createContentTypesQueries(client, headers);
-  const content = createContentQueries(client, headers);
-  return queryKeyFactory.mergeQueryKeys(contentTypes, content);
+function normalizeSearch(search) {
+  return search !== void 0 && search.trim() === "" ? void 0 : search;
 }
-function createContentTypesQueries(client, headers) {
-  return queryKeyFactory.createQueryKeys("cmsTypes", {
-    list: () => ({
-      queryKey: ["list"],
-      queryFn: async () => {
-        try {
-          const response = await client("/content-types", {
-            method: "GET",
-            headers
-          });
-          if (isErrorResponse(response)) {
-            throw toError(response.error);
-          }
-          return response.data ?? [];
-        } catch (error) {
-          throw error;
-        }
-      }
-    }),
-    detail: (slug) => ({
-      queryKey: [slug],
-      queryFn: async () => {
-        if (!slug) return null;
-        try {
-          const response = await client("/content-types/:slug", {
-            method: "GET",
-            params: { slug },
-            headers
-          });
-          if (isErrorResponse(response)) {
-            throw toError(response.error);
-          }
-          return response.data;
-        } catch (error) {
-          throw error;
-        }
-      }
-    })
-  });
+function paginatedNextPageParam(lastPage, allPages, limit) {
+  const items = Array.isArray(lastPage?.items) ? lastPage.items : [];
+  if (items.length < limit) return void 0;
+  const loadedCount = allPages.reduce(
+    (sum, page) => sum + (Array.isArray(page?.items) ? page.items.length : 0),
+    0
+  );
+  const total = lastPage?.total ?? 0;
+  if (loadedCount >= total) return void 0;
+  return loadedCount;
 }
-function createContentQueries(client, headers) {
-  return queryKeyFactory.createQueryKeys("cmsContent", {
-    list: (params) => ({
-      queryKey: [queryKeyDefs.contentListDiscriminator(params)],
-      queryFn: async () => {
-        try {
-          const response = await client("/content/:typeSlug", {
-            method: "GET",
-            params: { typeSlug: params.typeSlug },
-            query: {
-              limit: params.limit ?? 20,
-              offset: params.offset ?? 0
-            },
-            headers
-          });
-          if (isErrorResponse(response)) {
-            throw toError(response.error);
-          }
-          return response.data;
-        } catch (error) {
-          throw error;
-        }
+const cmsResources = {
+  cmsTypes: {
+    queries: {
+      list: {
+        path: "/content-types",
+        key: () => ["list"],
+        select: (data) => data ?? []
+      },
+      detail: {
+        path: "/content-types/:slug",
+        params: (slug) => ({ slug }),
+        key: (slug) => [slug],
+        select: (data, _slug) => data ?? null,
+        skip: (slug) => !slug
+      },
+      inverseRelations: {
+        path: "/content-types/:slug/inverse-relations",
+        params: (p) => ({ slug: p.slug }),
+        query: (p) => ({ itemId: p.itemId }),
+        key: (p) => [p.slug, p.itemId],
+        select: (data) => data?.inverseRelations ?? []
+      },
+      inverseRelationItems: {
+        path: "/content-types/:slug/inverse-relations/:sourceType",
+        params: (p) => ({
+          slug: p.slug,
+          sourceType: p.sourceType
+        }),
+        query: (p) => ({
+          itemId: p.itemId,
+          fieldName: p.fieldName
+        }),
+        key: (p) => [
+          p.slug,
+          p.sourceType,
+          p.itemId,
+          p.fieldName
+        ],
+        select: (data) => data ?? { items: [], total: 0 }
       }
-    }),
-    detail: (typeSlug, id) => ({
-      queryKey: [typeSlug, id],
-      queryFn: async () => {
-        if (!typeSlug || !id) return null;
-        try {
-          const response = await client("/content/:typeSlug/:id", {
-            method: "GET",
-            params: { typeSlug, id },
-            headers
-          });
-          if (isErrorResponse(response)) {
-            throw toError(response.error);
-          }
-          return response.data;
-        } catch (error) {
-          throw error;
-        }
+    }
+  },
+  cmsContent: {
+    queries: {
+      list: {
+        path: "/content/:typeSlug",
+        params: (p) => ({ typeSlug: p.typeSlug }),
+        query: (p) => ({
+          limit: p.limit ?? 20,
+          search: normalizeSearch(p.search)
+        }),
+        key: (p) => [queryKeyDefs.contentListDiscriminator(p)],
+        select: (data, _p) => data,
+        infinite: true,
+        pageSize: (p) => p.limit ?? 20,
+        nextPageParam: (lastPage, allPages, p) => paginatedNextPageParam(lastPage, allPages, p.limit ?? 20)
+      },
+      detail: {
+        path: "/content/:typeSlug/:id",
+        params: (typeSlug, id) => ({ typeSlug, id }),
+        key: (typeSlug, id) => [typeSlug, id],
+        select: (data, _typeSlug, _id) => data ?? null,
+        skip: (typeSlug, id) => !typeSlug || !id
+      },
+      bySlug: {
+        path: "/content/:typeSlug",
+        params: (typeSlug, _slug) => ({ typeSlug }),
+        query: (_typeSlug, slug) => ({ slug, limit: 1 }),
+        key: (typeSlug, slug) => ["bySlug", typeSlug, slug],
+        select: (data) => data?.items?.[0] ?? null,
+        skip: (typeSlug, slug) => !typeSlug || !slug
+      },
+      populated: {
+        path: "/content/:typeSlug/:id/populated",
+        params: (typeSlug, id) => ({ typeSlug, id }),
+        key: (typeSlug, id) => [typeSlug, id],
+        select: (data) => data ?? null,
+        skip: (typeSlug, id) => !typeSlug || !id
+      },
+      byRelation: {
+        path: "/content/:typeSlug/by-relation",
+        params: (p) => ({ typeSlug: p.typeSlug }),
+        query: (p) => ({
+          field: p.field,
+          targetId: p.targetId,
+          limit: p.limit ?? 20
+        }),
+        key: (p) => [p.typeSlug, p.field, p.targetId],
+        select: (data, _p) => data,
+        infinite: true,
+        pageSize: (p) => p.limit ?? 20,
+        nextPageParam: (lastPage, allPages, p) => paginatedNextPageParam(lastPage, allPages, p.limit ?? 20)
+      },
+      // Non-infinite options query for relation pickers (useSelect)
+      options: {
+        path: "/content/:typeSlug",
+        params: (p) => ({ typeSlug: p.typeSlug }),
+        query: (p) => ({
+          search: normalizeSearch(p.search),
+          limit: p.limit ?? 50
+        }),
+        key: (p) => [
+          "options",
+          p.typeSlug,
+          normalizeSearch(p.search),
+          p.limit ?? 50
+        ],
+        select: (data, _p) => data?.items ?? []
       }
-    }),
-    bySlug: (typeSlug, slug) => ({
-      queryKey: ["bySlug", typeSlug, slug],
-      queryFn: async () => {
-        if (!typeSlug || !slug) return null;
-        try {
-          const response = await client("/content/:typeSlug", {
-            method: "GET",
-            params: { typeSlug },
-            query: { slug, limit: 1 },
-            headers
-          });
-          if (isErrorResponse(response)) {
-            throw toError(response.error);
-          }
-          const data = response.data;
-          return data.items[0] ?? null;
-        } catch (error) {
-          throw error;
+    },
+    mutations: {
+      create: {
+        path: "@post/content/:typeSlug",
+        method: "POST",
+        input: (vars) => ({
+          params: { typeSlug: vars.typeSlug },
+          body: { slug: vars.slug, data: vars.data }
+        }),
+        select: (data) => data,
+        invalidates: ["cmsContent.list", "cmsTypes.list"]
+      },
+      update: {
+        path: "@put/content/:typeSlug/:id",
+        method: "PUT",
+        input: (vars) => ({
+          params: { typeSlug: vars.typeSlug, id: vars.id },
+          body: vars.data
+        }),
+        select: (data) => data,
+        invalidates: ["cmsContent.list"],
+        setData: {
+          query: "detail",
+          args: (updated) => updated?.contentType?.slug ? [updated.contentType.slug, updated.id] : null
         }
+      },
+      delete: {
+        path: "@delete/content/:typeSlug/:id",
+        method: "DELETE",
+        input: (vars) => ({
+          params: { typeSlug: vars.typeSlug, id: vars.id }
+        }),
+        select: (data) => data,
+        invalidates: ["cmsContent", "cmsTypes.list"]
       }
-    })
-  });
+    }
+  }
+};
+function createCMSQueryKeys(client$1, headers) {
+  return client.createResourceQueryKeys(client$1, cmsResources, headers);
 }
 
+exports.cmsResources = cmsResources;
 exports.createCMSQueryKeys = createCMSQueryKeys;