@btst/stack 5.0.0 → 5.1.0

package/dist/shared/{stack.pi0FxoEa.d.ts → stack.Dcfg4GNN.d.ts}

@@ -2,7 +2,7 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { z } from 'zod';
 import { ResourceFormConfig, ResourceFormResult } from '@btst/stack/plugins/client/hooks';
 import { S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.js';
-import { c as createPostSchema, u as updatePostSchema } from './stack.CKc_Bais.js';
+import { c as createPostSchema, u as updatePostSchema } from './stack.Csi-4Mgz.js';
 
 /**
  * Options for the usePosts hook
@@ -136,10 +136,6 @@ declare function useSuspenseTags(): {
 declare function usePostForm<TValues>(config: ResourceFormConfig<TValues, SerializedPost | null, SerializedPost | null>): ResourceFormResult<TValues, SerializedPost | null, SerializedPost | null>;
 /** Create a new post */
 declare function useCreatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
-    title: string;
-    content: string;
-    excerpt: string;
-    published: boolean;
     tags: ({
         name: string;
     } | {
@@ -147,6 +143,10 @@ declare function useCreatePost(): _tanstack_react_query.UseMutationResult<Serial
         name: string;
         slug: string;
     })[];
+    title: string;
+    content: string;
+    excerpt: string;
+    published: boolean;
     slug?: string | undefined;
     publishedAt?: Date | undefined;
     createdAt?: Date | undefined;

package/dist/shared/{stack.3rxARhgS.d.cts → stack.DrB3L7Ih.d.cts}

@@ -106,16 +106,65 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
      */
     _relations?: Record<string, SerializedContentItemWithType[]>;
 }
+/** Output shape for CMS reads; omission retains the full editor envelope. */
+type CMSReadView = "content" | undefined;
+/** Literal top-level property names selected from parsed content. */
+type CMSContentFields = readonly string[] | undefined;
+/** Select known literal properties, or an honest partial shape for dynamic arrays. */
+type CMSSelectedData<TData, TFields extends CMSContentFields = undefined> = TFields extends readonly string[] ? string extends TFields[number] ? Partial<TData> : Pick<TData, Extract<TFields[number], keyof TData>> : TData;
+/** Optional output controls for CMS reads. These do not change access checks. */
+interface CMSReadOptions<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> {
+    /** Return identity, parsed content and timestamps without editor metadata. */
+    view?: TView;
+    /** Literal declared top-level content properties. Requires content view. */
+    fields?: TFields;
+}
+/** Serialized content envelope without raw JSON or editor metadata. */
+type SerializedContentItemContent<TData = Record<string, unknown>> = Pick<SerializedContentItemWithType<TData>, "id" | "slug" | "parsedData" | "createdAt" | "updatedAt">;
+/** Result envelope selected by a statically known read view. */
+type CMSContentItemResult<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> = TView extends "content" ? SerializedContentItemContent<CMSSelectedData<TData, TFields>> : SerializedContentItemWithType<TData>;
 /**
  * Paginated list response for content items
  * @template TData - The type of the parsed data (defaults to Record<string, unknown>)
  */
-interface PaginatedContentItems<TData = Record<string, unknown>> {
-    items: SerializedContentItemWithType<TData>[];
+interface PaginatedContentItems<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
+    items: CMSContentItemResult<TData, TView, TFields>[];
     total: number;
     limit: number;
     offset: number;
 }
+/**
+ * Type helper to define a map of content type slugs to their data types.
+ * Use with z.infer to get the type from your Zod schemas.
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod"
+ *
+ * // Define your schemas
+ * export const ProductSchema = z.object({
+ *   name: z.string(),
+ *   price: z.number(),
+ * })
+ *
+ * export const TestimonialSchema = z.object({
+ *   author: z.string(),
+ *   quote: z.string(),
+ * })
+ *
+ * // Create the type map
+ * export type MyCMSTypes = {
+ *   product: z.infer<typeof ProductSchema>
+ *   testimonial: z.infer<typeof TestimonialSchema>
+ * }
+ *
+ * // Use in hooks for type-safe parsedData
+ * const { items } = useContent<MyCMSTypes, "product">("product")
+ * // items[0].parsedData.name is typed as string
+ * // items[0].parsedData.price is typed as number
+ * ```
+ */
+type CMSContentTypeMap = Record<string, Record<string, unknown>>;
 /** JSON-safe values accepted at the CMS operation boundary. */
 type CMSOperationData = string | number | boolean | null | readonly CMSOperationData[] | {
     readonly [key: string]: CMSOperationData;
@@ -278,4 +327,4 @@ interface CMSBackendConfig {
     maxPageSize?: number;
 }
 
-export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentItem as b, SerializedContentItem as c, ContentItemWithType as d, ContentType as e, CMSBackendHooks as f, CMSCreateOperationContext as g, CMSCreateResultContext as h, CMSDeleteOperationContext as i, CMSDeleteResultContext as j, CMSOperationErrorContext as k, CMSOperationLifecycleContext as l, CMSUpdateOperationContext as m, CMSUpdateResultContext as n, ContentTypeConfig as o };
+export type { CMSReadOptions as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, CMSReadView as a, SerializedContentItemWithType as b, CMSContentFields as c, CMSContentItemResult as d, CMSContentTypeMap as e, CMSBackendConfig as f, CMSSelectedData as g, ContentItem as h, SerializedContentItem as i, ContentItemWithType as j, ContentType as k, CMSBackendHooks as l, CMSCreateOperationContext as m, CMSCreateResultContext as n, CMSDeleteOperationContext as o, CMSDeleteResultContext as p, CMSOperationErrorContext as q, CMSOperationLifecycleContext as r, CMSUpdateOperationContext as s, CMSUpdateResultContext as t, ContentTypeConfig as u, SerializedContentItemContent as v };

package/dist/shared/{stack.3rxARhgS.d.mts → stack.DrB3L7Ih.d.mts}

@@ -106,16 +106,65 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
      */
     _relations?: Record<string, SerializedContentItemWithType[]>;
 }
+/** Output shape for CMS reads; omission retains the full editor envelope. */
+type CMSReadView = "content" | undefined;
+/** Literal top-level property names selected from parsed content. */
+type CMSContentFields = readonly string[] | undefined;
+/** Select known literal properties, or an honest partial shape for dynamic arrays. */
+type CMSSelectedData<TData, TFields extends CMSContentFields = undefined> = TFields extends readonly string[] ? string extends TFields[number] ? Partial<TData> : Pick<TData, Extract<TFields[number], keyof TData>> : TData;
+/** Optional output controls for CMS reads. These do not change access checks. */
+interface CMSReadOptions<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> {
+    /** Return identity, parsed content and timestamps without editor metadata. */
+    view?: TView;
+    /** Literal declared top-level content properties. Requires content view. */
+    fields?: TFields;
+}
+/** Serialized content envelope without raw JSON or editor metadata. */
+type SerializedContentItemContent<TData = Record<string, unknown>> = Pick<SerializedContentItemWithType<TData>, "id" | "slug" | "parsedData" | "createdAt" | "updatedAt">;
+/** Result envelope selected by a statically known read view. */
+type CMSContentItemResult<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> = TView extends "content" ? SerializedContentItemContent<CMSSelectedData<TData, TFields>> : SerializedContentItemWithType<TData>;
 /**
  * Paginated list response for content items
  * @template TData - The type of the parsed data (defaults to Record<string, unknown>)
  */
-interface PaginatedContentItems<TData = Record<string, unknown>> {
-    items: SerializedContentItemWithType<TData>[];
+interface PaginatedContentItems<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
+    items: CMSContentItemResult<TData, TView, TFields>[];
     total: number;
     limit: number;
     offset: number;
 }
+/**
+ * Type helper to define a map of content type slugs to their data types.
+ * Use with z.infer to get the type from your Zod schemas.
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod"
+ *
+ * // Define your schemas
+ * export const ProductSchema = z.object({
+ *   name: z.string(),
+ *   price: z.number(),
+ * })
+ *
+ * export const TestimonialSchema = z.object({
+ *   author: z.string(),
+ *   quote: z.string(),
+ * })
+ *
+ * // Create the type map
+ * export type MyCMSTypes = {
+ *   product: z.infer<typeof ProductSchema>
+ *   testimonial: z.infer<typeof TestimonialSchema>
+ * }
+ *
+ * // Use in hooks for type-safe parsedData
+ * const { items } = useContent<MyCMSTypes, "product">("product")
+ * // items[0].parsedData.name is typed as string
+ * // items[0].parsedData.price is typed as number
+ * ```
+ */
+type CMSContentTypeMap = Record<string, Record<string, unknown>>;
 /** JSON-safe values accepted at the CMS operation boundary. */
 type CMSOperationData = string | number | boolean | null | readonly CMSOperationData[] | {
     readonly [key: string]: CMSOperationData;
@@ -278,4 +327,4 @@ interface CMSBackendConfig {
     maxPageSize?: number;
 }
 
-export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentItem as b, SerializedContentItem as c, ContentItemWithType as d, ContentType as e, CMSBackendHooks as f, CMSCreateOperationContext as g, CMSCreateResultContext as h, CMSDeleteOperationContext as i, CMSDeleteResultContext as j, CMSOperationErrorContext as k, CMSOperationLifecycleContext as l, CMSUpdateOperationContext as m, CMSUpdateResultContext as n, ContentTypeConfig as o };
+export type { CMSReadOptions as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, CMSReadView as a, SerializedContentItemWithType as b, CMSContentFields as c, CMSContentItemResult as d, CMSContentTypeMap as e, CMSBackendConfig as f, CMSSelectedData as g, ContentItem as h, SerializedContentItem as i, ContentItemWithType as j, ContentType as k, CMSBackendHooks as l, CMSCreateOperationContext as m, CMSCreateResultContext as n, CMSDeleteOperationContext as o, CMSDeleteResultContext as p, CMSOperationErrorContext as q, CMSOperationLifecycleContext as r, CMSUpdateOperationContext as s, CMSUpdateResultContext as t, ContentTypeConfig as u, SerializedContentItemContent as v };

package/dist/shared/{stack.3rxARhgS.d.ts → stack.DrB3L7Ih.d.ts}

@@ -106,16 +106,65 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
      */
     _relations?: Record<string, SerializedContentItemWithType[]>;
 }
+/** Output shape for CMS reads; omission retains the full editor envelope. */
+type CMSReadView = "content" | undefined;
+/** Literal top-level property names selected from parsed content. */
+type CMSContentFields = readonly string[] | undefined;
+/** Select known literal properties, or an honest partial shape for dynamic arrays. */
+type CMSSelectedData<TData, TFields extends CMSContentFields = undefined> = TFields extends readonly string[] ? string extends TFields[number] ? Partial<TData> : Pick<TData, Extract<TFields[number], keyof TData>> : TData;
+/** Optional output controls for CMS reads. These do not change access checks. */
+interface CMSReadOptions<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> {
+    /** Return identity, parsed content and timestamps without editor metadata. */
+    view?: TView;
+    /** Literal declared top-level content properties. Requires content view. */
+    fields?: TFields;
+}
+/** Serialized content envelope without raw JSON or editor metadata. */
+type SerializedContentItemContent<TData = Record<string, unknown>> = Pick<SerializedContentItemWithType<TData>, "id" | "slug" | "parsedData" | "createdAt" | "updatedAt">;
+/** Result envelope selected by a statically known read view. */
+type CMSContentItemResult<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> = TView extends "content" ? SerializedContentItemContent<CMSSelectedData<TData, TFields>> : SerializedContentItemWithType<TData>;
 /**
  * Paginated list response for content items
  * @template TData - The type of the parsed data (defaults to Record<string, unknown>)
  */
-interface PaginatedContentItems<TData = Record<string, unknown>> {
-    items: SerializedContentItemWithType<TData>[];
+interface PaginatedContentItems<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
+    items: CMSContentItemResult<TData, TView, TFields>[];
     total: number;
     limit: number;
     offset: number;
 }
+/**
+ * Type helper to define a map of content type slugs to their data types.
+ * Use with z.infer to get the type from your Zod schemas.
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod"
+ *
+ * // Define your schemas
+ * export const ProductSchema = z.object({
+ *   name: z.string(),
+ *   price: z.number(),
+ * })
+ *
+ * export const TestimonialSchema = z.object({
+ *   author: z.string(),
+ *   quote: z.string(),
+ * })
+ *
+ * // Create the type map
+ * export type MyCMSTypes = {
+ *   product: z.infer<typeof ProductSchema>
+ *   testimonial: z.infer<typeof TestimonialSchema>
+ * }
+ *
+ * // Use in hooks for type-safe parsedData
+ * const { items } = useContent<MyCMSTypes, "product">("product")
+ * // items[0].parsedData.name is typed as string
+ * // items[0].parsedData.price is typed as number
+ * ```
+ */
+type CMSContentTypeMap = Record<string, Record<string, unknown>>;
 /** JSON-safe values accepted at the CMS operation boundary. */
 type CMSOperationData = string | number | boolean | null | readonly CMSOperationData[] | {
     readonly [key: string]: CMSOperationData;
@@ -278,4 +327,4 @@ interface CMSBackendConfig {
     maxPageSize?: number;
 }
 
-export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentItem as b, SerializedContentItem as c, ContentItemWithType as d, ContentType as e, CMSBackendHooks as f, CMSCreateOperationContext as g, CMSCreateResultContext as h, CMSDeleteOperationContext as i, CMSDeleteResultContext as j, CMSOperationErrorContext as k, CMSOperationLifecycleContext as l, CMSUpdateOperationContext as m, CMSUpdateResultContext as n, ContentTypeConfig as o };
+export type { CMSReadOptions as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, CMSReadView as a, SerializedContentItemWithType as b, CMSContentFields as c, CMSContentItemResult as d, CMSContentTypeMap as e, CMSBackendConfig as f, CMSSelectedData as g, ContentItem as h, SerializedContentItem as i, ContentItemWithType as j, ContentType as k, CMSBackendHooks as l, CMSCreateOperationContext as m, CMSCreateResultContext as n, CMSDeleteOperationContext as o, CMSDeleteResultContext as p, CMSOperationErrorContext as q, CMSOperationLifecycleContext as r, CMSUpdateOperationContext as s, CMSUpdateResultContext as t, ContentTypeConfig as u, SerializedContentItemContent as v };