@btst/plugin-cms 0.0.0-stage → 1.0.0-beta.0

package/dist/api/query-key-defs.cjs

@@ -0,0 +1,44 @@
+'use strict';
+
+const schemas = require('../schemas.cjs');
+
+function contentReadDiscriminator(options) {
+  return {
+    ...options?.view ? { view: options.view } : {},
+    ...options?.fields !== void 0 ? { fields: schemas.normalizeContentFields(options.fields) } : {}
+  };
+}
+function contentReadKey(options) {
+  return options?.view || options?.fields !== void 0 ? [contentReadDiscriminator(options)] : [];
+}
+function contentListDiscriminator(params) {
+  return {
+    ...contentReadDiscriminator(params),
+    typeSlug: params.typeSlug,
+    limit: params.limit ?? 20,
+    offset: params.offset ?? 0,
+    search: params.search !== void 0 && params.search.trim() === "" ? void 0 : params.search
+  };
+}
+const CMS_QUERY_KEYS = {
+  /**
+   * Key for the cmsTypes.list() query.
+   * Full key: ["cmsTypes", "list", "list"]
+   */
+  typesList: () => ["cmsTypes", "list", "list"],
+  /**
+   * Key for the cmsContent.list({ typeSlug, limit, offset }) query.
+   * Full key: ["cmsContent", "list", { typeSlug, limit, offset, search }]
+   */
+  contentList: (params) => ["cmsContent", "list", contentListDiscriminator(params)],
+  /**
+   * Key for the cmsContent.detail(typeSlug, id) query.
+   * Full key: ["cmsContent", "detail", typeSlug, id]
+   */
+  contentDetail: (typeSlug, id, options) => ["cmsContent", "detail", typeSlug, id, ...contentReadKey(options)]
+};
+
+exports.CMS_QUERY_KEYS = CMS_QUERY_KEYS;
+exports.contentListDiscriminator = contentListDiscriminator;
+exports.contentReadDiscriminator = contentReadDiscriminator;
+exports.contentReadKey = contentReadKey;

package/dist/api/query-key-defs.mjs

@@ -0,0 +1,39 @@
+import { normalizeContentFields } from '../schemas.mjs';
+
+function contentReadDiscriminator(options) {
+  return {
+    ...options?.view ? { view: options.view } : {},
+    ...options?.fields !== void 0 ? { fields: normalizeContentFields(options.fields) } : {}
+  };
+}
+function contentReadKey(options) {
+  return options?.view || options?.fields !== void 0 ? [contentReadDiscriminator(options)] : [];
+}
+function contentListDiscriminator(params) {
+  return {
+    ...contentReadDiscriminator(params),
+    typeSlug: params.typeSlug,
+    limit: params.limit ?? 20,
+    offset: params.offset ?? 0,
+    search: params.search !== void 0 && params.search.trim() === "" ? void 0 : params.search
+  };
+}
+const CMS_QUERY_KEYS = {
+  /**
+   * Key for the cmsTypes.list() query.
+   * Full key: ["cmsTypes", "list", "list"]
+   */
+  typesList: () => ["cmsTypes", "list", "list"],
+  /**
+   * Key for the cmsContent.list({ typeSlug, limit, offset }) query.
+   * Full key: ["cmsContent", "list", { typeSlug, limit, offset, search }]
+   */
+  contentList: (params) => ["cmsContent", "list", contentListDiscriminator(params)],
+  /**
+   * Key for the cmsContent.detail(typeSlug, id) query.
+   * Full key: ["cmsContent", "detail", typeSlug, id]
+   */
+  contentDetail: (typeSlug, id, options) => ["cmsContent", "detail", typeSlug, id, ...contentReadKey(options)]
+};
+
+export { CMS_QUERY_KEYS, contentListDiscriminator, contentReadDiscriminator, contentReadKey };

package/dist/api/relations.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+function extractRelationFields(contentType) {
+  const jsonSchema = JSON.parse(
+    contentType.jsonSchema
+  );
+  const properties = jsonSchema.properties || {};
+  const relationFields = {};
+  for (const [fieldName, fieldSchema] of Object.entries(properties)) {
+    if (fieldSchema.fieldType === "relation" && fieldSchema.relation) {
+      relationFields[fieldName] = fieldSchema.relation;
+    }
+  }
+  return relationFields;
+}
+function isNewRelationValue(value) {
+  return typeof value === "object" && value !== null && "_new" in value && value._new === true && "data" in value;
+}
+function isExistingRelationValue(value) {
+  return typeof value === "object" && value !== null && "id" in value && typeof value.id === "string";
+}
+function collectExistingRelationIds(data, relationFields) {
+  const relationIds = {};
+  for (const [fieldName, relationConfig] of Object.entries(relationFields)) {
+    if (!(fieldName in data)) continue;
+    const fieldValue = data[fieldName];
+    if (!fieldValue) {
+      relationIds[fieldName] = [];
+      continue;
+    }
+    const ids = [];
+    if (relationConfig.type === "belongsTo") {
+      const value = fieldValue;
+      if (isExistingRelationValue(value)) {
+        ids.push(value.id);
+      }
+    } else {
+      const values = Array.isArray(fieldValue) ? fieldValue : [];
+      for (const value of values) {
+        if (isExistingRelationValue(value)) {
+          ids.push(value.id);
+        }
+      }
+    }
+    relationIds[fieldName] = ids;
+  }
+  return relationIds;
+}
+async function syncRelations(adapter, sourceId, relationIds) {
+  for (const [fieldName, targetIds] of Object.entries(relationIds)) {
+    await adapter.delete({
+      model: "contentRelation",
+      where: [
+        { field: "sourceId", value: sourceId, operator: "eq" },
+        { field: "fieldName", value: fieldName, operator: "eq" }
+      ]
+    });
+    for (const targetId of targetIds) {
+      await adapter.create({
+        model: "contentRelation",
+        data: {
+          sourceId,
+          targetId,
+          fieldName,
+          createdAt: /* @__PURE__ */ new Date()
+        }
+      });
+    }
+  }
+}
+
+exports.collectExistingRelationIds = collectExistingRelationIds;
+exports.extractRelationFields = extractRelationFields;
+exports.isExistingRelationValue = isExistingRelationValue;
+exports.isNewRelationValue = isNewRelationValue;
+exports.syncRelations = syncRelations;

package/dist/api/relations.mjs

@@ -0,0 +1,70 @@
+function extractRelationFields(contentType) {
+  const jsonSchema = JSON.parse(
+    contentType.jsonSchema
+  );
+  const properties = jsonSchema.properties || {};
+  const relationFields = {};
+  for (const [fieldName, fieldSchema] of Object.entries(properties)) {
+    if (fieldSchema.fieldType === "relation" && fieldSchema.relation) {
+      relationFields[fieldName] = fieldSchema.relation;
+    }
+  }
+  return relationFields;
+}
+function isNewRelationValue(value) {
+  return typeof value === "object" && value !== null && "_new" in value && value._new === true && "data" in value;
+}
+function isExistingRelationValue(value) {
+  return typeof value === "object" && value !== null && "id" in value && typeof value.id === "string";
+}
+function collectExistingRelationIds(data, relationFields) {
+  const relationIds = {};
+  for (const [fieldName, relationConfig] of Object.entries(relationFields)) {
+    if (!(fieldName in data)) continue;
+    const fieldValue = data[fieldName];
+    if (!fieldValue) {
+      relationIds[fieldName] = [];
+      continue;
+    }
+    const ids = [];
+    if (relationConfig.type === "belongsTo") {
+      const value = fieldValue;
+      if (isExistingRelationValue(value)) {
+        ids.push(value.id);
+      }
+    } else {
+      const values = Array.isArray(fieldValue) ? fieldValue : [];
+      for (const value of values) {
+        if (isExistingRelationValue(value)) {
+          ids.push(value.id);
+        }
+      }
+    }
+    relationIds[fieldName] = ids;
+  }
+  return relationIds;
+}
+async function syncRelations(adapter, sourceId, relationIds) {
+  for (const [fieldName, targetIds] of Object.entries(relationIds)) {
+    await adapter.delete({
+      model: "contentRelation",
+      where: [
+        { field: "sourceId", value: sourceId, operator: "eq" },
+        { field: "fieldName", value: fieldName, operator: "eq" }
+      ]
+    });
+    for (const targetId of targetIds) {
+      await adapter.create({
+        model: "contentRelation",
+        data: {
+          sourceId,
+          targetId,
+          fieldName,
+          createdAt: /* @__PURE__ */ new Date()
+        }
+      });
+    }
+  }
+}
+
+export { collectExistingRelationIds, extractRelationFields, isExistingRelationValue, isNewRelationValue, syncRelations };

package/dist/client/components/forms/content-form.cjs

@@ -0,0 +1,286 @@
+'use client';
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const React = require('react');
+const z = require('zod');
+const steppedAutoForm = require('../../../ui/src/components/auto-form/stepped-auto-form.cjs');
+const helpers = require('../../../ui/src/components/auto-form/helpers.cjs');
+const schemaConverter = require('../../../ui/src/lib/schema-converter.cjs');
+const input = require('../../../ui/src/components/input.cjs');
+const label = require('../../../ui/src/components/label.cjs');
+const badge = require('../../../ui/src/components/badge.cjs');
+const context = require('@btst/stack/context');
+const constants = require('../../constants.cjs');
+const utils = require('../../../utils.cjs');
+const fileUpload = require('./file-upload.cjs');
+const relationField = require('./relation-field.cjs');
+
+function useServerFieldErrors(form, fieldErrors) {
+  const appliedFieldsRef = React.useRef([]);
+  React.useEffect(() => {
+    if (!form) return;
+    for (const field of appliedFieldsRef.current) {
+      if (field in fieldErrors) continue;
+      const { error } = form.getFieldState(field);
+      if (error?.type === "server") {
+        form.clearErrors(field);
+      }
+    }
+    appliedFieldsRef.current = Object.keys(fieldErrors);
+    for (const [field, message] of Object.entries(fieldErrors)) {
+      form.setError(field, {
+        type: "server",
+        message: Array.isArray(message) ? message.join(", ") : message
+      });
+    }
+  }, [fieldErrors, form]);
+}
+function buildFieldConfigFromJsonSchema(jsonSchema, uploadImage, fieldComponents, imagePicker, imageInputField) {
+  const baseConfig = helpers.buildFieldConfigFromJsonSchema(jsonSchema, fieldComponents);
+  const properties = jsonSchema.properties;
+  if (!properties) return baseConfig;
+  const injectCustomFieldTypes = (props, targetConfig) => {
+    for (const [key, prop] of Object.entries(props)) {
+      const existing = targetConfig[key] ?? {};
+      let updated = existing;
+      if (prop.fieldType === "file" && !fieldComponents?.["file"]) {
+        if (!uploadImage && !imageInputField) {
+          updated = {
+            ...updated,
+            fieldType: () => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "rounded-md border border-destructive bg-destructive/10 p-3 text-sm text-destructive", children: [
+              "File upload requires an ",
+              /* @__PURE__ */ jsxRuntime.jsx("code", { children: "uploadImage" }),
+              " or",
+              " ",
+              /* @__PURE__ */ jsxRuntime.jsx("code", { children: "imageInputField" }),
+              " function in CMS overrides."
+            ] })
+          };
+        } else {
+          updated = {
+            ...updated,
+            fieldType: (componentProps) => /* @__PURE__ */ jsxRuntime.jsx(
+              fileUpload.CMSFileUpload,
+              {
+                ...componentProps,
+                uploadImage: uploadImage ?? (() => Promise.resolve("")),
+                imageInputField,
+                imagePicker
+              }
+            )
+          };
+        }
+      }
+      if (prop.fieldType === "relation" && prop.relation && !fieldComponents?.["relation"]) {
+        const relationConfig = prop.relation;
+        updated = {
+          ...updated,
+          fieldType: (componentProps) => /* @__PURE__ */ jsxRuntime.jsx(relationField.RelationField, { ...componentProps, relation: relationConfig })
+        };
+      }
+      if (prop.properties) {
+        injectCustomFieldTypes(
+          prop.properties,
+          updated
+        );
+      }
+      const items = prop.items;
+      if (items?.properties) {
+        injectCustomFieldTypes(
+          items.properties,
+          updated
+        );
+      }
+      if (Object.keys(updated).length > 0) {
+        targetConfig[key] = updated;
+      }
+    }
+  };
+  injectCustomFieldTypes(
+    properties,
+    baseConfig
+  );
+  return baseConfig;
+}
+function findSlugSourceField(jsonSchema) {
+  const properties = jsonSchema.properties;
+  if (!properties) return null;
+  const priorityFields = ["name", "title", "heading", "label"];
+  for (const field of priorityFields) {
+    if (properties[field]?.type === "string") {
+      return field;
+    }
+  }
+  for (const [key, value] of Object.entries(properties)) {
+    if (value.type === "string") {
+      return key;
+    }
+  }
+  return null;
+}
+function ContentForm({
+  contentType,
+  initialData = {},
+  initialSlug = "",
+  isEditing = false,
+  onSubmit,
+  onCancel,
+  fieldErrors,
+  errorMessage,
+  isSubmitting: isSubmittingProp
+}) {
+  const t = context.useTranslate();
+  const {
+    localization,
+    uploadImage,
+    imagePicker,
+    imageInputField,
+    fieldComponents
+  } = context.usePluginOverrides(constants.CMS_PLUGIN_ID);
+  const [slug, setSlug] = React.useState(initialSlug);
+  const [slugManuallyEdited, setSlugManuallyEdited] = React.useState(isEditing);
+  const [isSubmittingLocal, setIsSubmittingLocal] = React.useState(false);
+  const [formData, setFormData] = React.useState(initialData);
+  const [slugError, setSlugError] = React.useState(null);
+  const [submitError, setSubmitError] = React.useState(null);
+  const isSubmitting = isSubmittingProp || isSubmittingLocal;
+  const [formInstance, setFormInstance] = React.useState(null);
+  const serverFieldErrors = React.useMemo(() => fieldErrors ?? {}, [fieldErrors]);
+  useServerFieldErrors(formInstance, serverFieldErrors);
+  const hasFieldErrors = Object.keys(serverFieldErrors).length > 0;
+  const hasSyncedPrefillRef = React.useRef(false);
+  React.useEffect(() => {
+    const hasData = Object.keys(initialData).length > 0;
+    const shouldSync = hasData && (isEditing || !hasSyncedPrefillRef.current);
+    if (shouldSync) {
+      setFormData(initialData);
+      if (!isEditing) {
+        hasSyncedPrefillRef.current = true;
+      }
+    }
+  }, [initialData, isEditing]);
+  React.useEffect(() => {
+    if (isEditing && initialSlug) {
+      setSlug(initialSlug);
+    }
+  }, [initialSlug, isEditing]);
+  const jsonSchema = React.useMemo(() => {
+    try {
+      return JSON.parse(contentType.jsonSchema);
+    } catch {
+      return {};
+    }
+  }, [contentType.jsonSchema]);
+  const zodSchema = React.useMemo(() => {
+    try {
+      return schemaConverter.formSchemaToZod(jsonSchema);
+    } catch {
+      return z.z.object({});
+    }
+  }, [jsonSchema]);
+  const fieldConfig = React.useMemo(
+    () => buildFieldConfigFromJsonSchema(
+      jsonSchema,
+      uploadImage,
+      fieldComponents,
+      imagePicker,
+      imageInputField
+    ),
+    [jsonSchema, uploadImage, fieldComponents, imagePicker, imageInputField]
+  );
+  const slugSourceField = React.useMemo(
+    () => findSlugSourceField(jsonSchema),
+    [jsonSchema]
+  );
+  const handleValuesChange = (values, form) => {
+    if (form) {
+      setFormInstance((current) => current === form ? current : form);
+    }
+    setFormData(values);
+    if (!isEditing && !slugManuallyEdited && slugSourceField) {
+      const sourceValue = values[slugSourceField];
+      if (typeof sourceValue === "string" && sourceValue.trim()) {
+        setSlug(utils.slugify(sourceValue));
+      }
+    }
+  };
+  const handleSubmit = async (data) => {
+    setSlugError(null);
+    setSubmitError(null);
+    if (!slug.trim()) {
+      setSlugError(
+        localization?.CMS_EDITOR_SLUG_REQUIRED ?? t("cms.editor.slugRequired", "Slug is required")
+      );
+      return;
+    }
+    setIsSubmittingLocal(true);
+    try {
+      await onSubmit({ slug, data });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : localization?.CMS_TOAST_ERROR ?? t("cms.toasts.error", "An error occurred. Please try again.");
+      setSubmitError(message);
+    } finally {
+      setIsSubmittingLocal(false);
+    }
+  };
+  const bannerMessage = errorMessage ?? submitError ?? (hasFieldErrors && !formInstance ? Object.entries(serverFieldErrors).map(
+    ([field, message]) => `${field}: ${Array.isArray(message) ? message.join(", ") : message}`
+  ).join(" \xB7 ") : void 0);
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-6", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-2", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
+        /* @__PURE__ */ jsxRuntime.jsx(label.Label, { htmlFor: "slug", children: localization?.CMS_LABEL_SLUG ?? t("cms.common.slugLabel", "Slug") }),
+        !isEditing && /* @__PURE__ */ jsxRuntime.jsx(badge.Badge, { variant: "outline", className: "text-xs", children: slugManuallyEdited ? localization?.CMS_EDITOR_SLUG_MANUAL ?? t("cms.editor.slugManual", "Manually set") : localization?.CMS_EDITOR_SLUG_AUTO ?? t("cms.editor.slugAuto", "Auto-generated from first field") })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        input.Input,
+        {
+          id: "slug",
+          value: slug,
+          onChange: (e) => {
+            setSlug(e.target.value);
+            setSlugError(null);
+            if (!isEditing) {
+              setSlugManuallyEdited(true);
+            }
+          },
+          disabled: isEditing,
+          placeholder: slugSourceField ? (localization?.CMS_EDITOR_SLUG_PLACEHOLDER_AUTO ?? t(
+            "cms.editor.slugPlaceholderAuto",
+            "Auto-generated from {field}"
+          )).replace("{field}", slugSourceField) : localization?.CMS_EDITOR_SLUG_PLACEHOLDER ?? t("cms.editor.slugPlaceholder", "Enter slug...")
+        }
+      ),
+      slugError && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-destructive", children: slugError }),
+      /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-muted-foreground", children: localization?.CMS_LABEL_SLUG_DESCRIPTION ?? t(
+        "cms.common.slugDescription",
+        "URL-friendly identifier for this item"
+      ) })
+    ] }),
+    bannerMessage && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "rounded-md border border-destructive/50 bg-destructive/10 p-3", children: /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm text-destructive", children: bannerMessage }) }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      steppedAutoForm.SteppedAutoForm,
+      {
+        formSchema: zodSchema,
+        values: formData,
+        onValuesChange: handleValuesChange,
+        onSubmit: handleSubmit,
+        fieldConfig,
+        isSubmitting,
+        submitButtonText: isSubmitting ? localization?.CMS_STATUS_SAVING ?? t("cms.common.saving", "Saving...") : localization?.CMS_BUTTON_SAVE ?? t("cms.common.save", "Save"),
+        children: onCancel && /* @__PURE__ */ jsxRuntime.jsx(
+          "button",
+          {
+            type: "button",
+            onClick: onCancel,
+            className: "px-4 py-2 text-sm text-muted-foreground hover:text-foreground",
+            children: localization?.CMS_BUTTON_CANCEL ?? t("cms.common.cancel", "Cancel")
+          }
+        )
+      }
+    )
+  ] });
+}
+
+exports.ContentForm = ContentForm;