@btst/stack 1.8.0 → 1.9.0

package/dist/plugins/form-builder/api/index.d.cts

@@ -97,8 +97,8 @@ declare const formBuilderBackendPlugin: (config?: FormBuilderBackendConfig) => _
         };
         submittedAt: string;
         id: string;
-        data: string;
         formId: string;
+        data: string;
         submittedBy?: string | undefined;
         ipAddress?: string | undefined;
         userAgent?: string | undefined;

package/dist/plugins/form-builder/api/index.d.mts

@@ -97,8 +97,8 @@ declare const formBuilderBackendPlugin: (config?: FormBuilderBackendConfig) => _
         };
         submittedAt: string;
         id: string;
-        data: string;
         formId: string;
+        data: string;
         submittedBy?: string | undefined;
         ipAddress?: string | undefined;
         userAgent?: string | undefined;

package/dist/plugins/form-builder/api/index.d.ts

@@ -97,8 +97,8 @@ declare const formBuilderBackendPlugin: (config?: FormBuilderBackendConfig) => _
         };
         submittedAt: string;
         id: string;
-        data: string;
         formId: string;
+        data: string;
         submittedBy?: string | undefined;
         ipAddress?: string | undefined;
         userAgent?: string | undefined;

package/dist/shared/{stack.L-UFwz2G.d.cts → stack.oGOteE6g.d.cts}

@@ -58,6 +58,19 @@ type ContentItem = {
     createdAt: Date;
     updatedAt: Date;
 };
+/**
+ * Represents an inverse relation (content types that reference this type via belongsTo)
+ */
+interface InverseRelation {
+    /** The content type slug that has the belongsTo relation */
+    sourceType: string;
+    /** Display name of the source content type */
+    sourceTypeName: string;
+    /** The field name that contains the belongsTo relation */
+    fieldName: string;
+    /** Count of items with this relation (when itemId is provided) */
+    count: number;
+}
 /**
  * Serialized content type for API responses (dates as strings)
  */
@@ -81,6 +94,11 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
     parsedData: TData;
     /** Joined content type */
     contentType?: SerializedContentType;
+    /**
+     * Populated relation data (only present when using populated endpoints/hooks).
+     * Keys are field names, values are arrays of related content items.
+     */
+    _relations?: Record<string, SerializedContentItemWithType[]>;
 }
 /**
  * Paginated list response for content items
@@ -105,14 +123,18 @@ interface CMSHookContext {
 }
 /**
  * Hooks for customizing CMS backend behavior
+ *
+ * Note: Before hooks can only deny operations by returning `false`.
+ * They cannot modify the data being saved. This ensures consistency
+ * between the stored content item data and relation junction tables.
  */
 interface CMSBackendHooks {
-    /** Called before creating a content item */
-    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before creating a content item. Return false to deny the operation. */
+    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after creating a content item */
     onAfterCreate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
-    /** Called before updating a content item */
-    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before updating a content item. Return false to deny the operation. */
+    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after updating a content item */
     onAfterUpdate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
     /** Called before deleting a content item */
@@ -132,4 +154,4 @@ interface CMSBackendConfig {
     hooks?: CMSBackendHooks;
 }
 
-export type { CMSBackendConfig as C, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };
+export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };

package/dist/shared/{stack.L-UFwz2G.d.mts → stack.oGOteE6g.d.mts}

@@ -58,6 +58,19 @@ type ContentItem = {
     createdAt: Date;
     updatedAt: Date;
 };
+/**
+ * Represents an inverse relation (content types that reference this type via belongsTo)
+ */
+interface InverseRelation {
+    /** The content type slug that has the belongsTo relation */
+    sourceType: string;
+    /** Display name of the source content type */
+    sourceTypeName: string;
+    /** The field name that contains the belongsTo relation */
+    fieldName: string;
+    /** Count of items with this relation (when itemId is provided) */
+    count: number;
+}
 /**
  * Serialized content type for API responses (dates as strings)
  */
@@ -81,6 +94,11 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
     parsedData: TData;
     /** Joined content type */
     contentType?: SerializedContentType;
+    /**
+     * Populated relation data (only present when using populated endpoints/hooks).
+     * Keys are field names, values are arrays of related content items.
+     */
+    _relations?: Record<string, SerializedContentItemWithType[]>;
 }
 /**
  * Paginated list response for content items
@@ -105,14 +123,18 @@ interface CMSHookContext {
 }
 /**
  * Hooks for customizing CMS backend behavior
+ *
+ * Note: Before hooks can only deny operations by returning `false`.
+ * They cannot modify the data being saved. This ensures consistency
+ * between the stored content item data and relation junction tables.
  */
 interface CMSBackendHooks {
-    /** Called before creating a content item */
-    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before creating a content item. Return false to deny the operation. */
+    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after creating a content item */
     onAfterCreate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
-    /** Called before updating a content item */
-    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before updating a content item. Return false to deny the operation. */
+    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after updating a content item */
     onAfterUpdate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
     /** Called before deleting a content item */
@@ -132,4 +154,4 @@ interface CMSBackendConfig {
     hooks?: CMSBackendHooks;
 }
 
-export type { CMSBackendConfig as C, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };
+export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };

package/dist/shared/{stack.L-UFwz2G.d.ts → stack.oGOteE6g.d.ts}

@@ -58,6 +58,19 @@ type ContentItem = {
     createdAt: Date;
     updatedAt: Date;
 };
+/**
+ * Represents an inverse relation (content types that reference this type via belongsTo)
+ */
+interface InverseRelation {
+    /** The content type slug that has the belongsTo relation */
+    sourceType: string;
+    /** Display name of the source content type */
+    sourceTypeName: string;
+    /** The field name that contains the belongsTo relation */
+    fieldName: string;
+    /** Count of items with this relation (when itemId is provided) */
+    count: number;
+}
 /**
  * Serialized content type for API responses (dates as strings)
  */
@@ -81,6 +94,11 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
     parsedData: TData;
     /** Joined content type */
     contentType?: SerializedContentType;
+    /**
+     * Populated relation data (only present when using populated endpoints/hooks).
+     * Keys are field names, values are arrays of related content items.
+     */
+    _relations?: Record<string, SerializedContentItemWithType[]>;
 }
 /**
  * Paginated list response for content items
@@ -105,14 +123,18 @@ interface CMSHookContext {
 }
 /**
  * Hooks for customizing CMS backend behavior
+ *
+ * Note: Before hooks can only deny operations by returning `false`.
+ * They cannot modify the data being saved. This ensures consistency
+ * between the stored content item data and relation junction tables.
  */
 interface CMSBackendHooks {
-    /** Called before creating a content item */
-    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before creating a content item. Return false to deny the operation. */
+    onBeforeCreate?: (data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after creating a content item */
     onAfterCreate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
-    /** Called before updating a content item */
-    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /** Called before updating a content item. Return false to deny the operation. */
+    onBeforeUpdate?: (id: string, data: Record<string, unknown>, context: CMSHookContext) => Promise<false | void> | false | void;
     /** Called after updating a content item */
     onAfterUpdate?: (item: SerializedContentItem, context: CMSHookContext) => Promise<void> | void;
     /** Called before deleting a content item */
@@ -132,4 +154,4 @@ interface CMSBackendConfig {
     hooks?: CMSBackendHooks;
 }
 
-export type { CMSBackendConfig as C, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };
+export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/stack",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "A composable, plugin-based library for building full-stack applications.",
   "repository": {
     "type": "git",