@btst/stack 2.6.2 → 2.8.0

package/dist/shared/stack.C-b3Sn8j.d.mts

@@ -0,0 +1,142 @@
+/**
+ * Comment status values
+ */
+type CommentStatus = "pending" | "approved" | "spam";
+/**
+ * A comment record as stored in the database
+ */
+type Comment = {
+    id: string;
+    resourceId: string;
+    resourceType: string;
+    parentId: string | null;
+    authorId: string;
+    body: string;
+    status: CommentStatus;
+    likes: number;
+    editedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+};
+/**
+ * A comment enriched with server-resolved author info and like status.
+ * All dates are ISO strings (safe for serialisation over HTTP / React Query cache).
+ */
+interface SerializedComment {
+    id: string;
+    resourceId: string;
+    resourceType: string;
+    parentId: string | null;
+    authorId: string;
+    /** Resolved from resolveUser(authorId). Falls back to "[deleted]" when user cannot be found. */
+    resolvedAuthorName: string;
+    /** Resolved avatar URL or null */
+    resolvedAvatarUrl: string | null;
+    body: string;
+    status: CommentStatus;
+    /** Denormalized counter — updated atomically on toggleLike */
+    likes: number;
+    /** True when the currentUserId query param matches an existing commentLike row */
+    isLikedByCurrentUser: boolean;
+    /** ISO string set when the comment body was edited; null for unedited comments */
+    editedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    /**
+     * Number of direct replies visible to the requesting user.
+     * Includes approved replies plus any pending replies authored by `currentUserId`.
+     * Always 0 for reply comments (non-null parentId).
+     */
+    replyCount: number;
+}
+/**
+ * Paginated list result for comments
+ */
+interface CommentListResult {
+    items: SerializedComment[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+
+/**
+ * Internal query key constants for the Comments plugin.
+ * Shared between query-keys.ts (HTTP path) and any SSG/direct DB path
+ * to prevent key drift between loaders and prefetch calls.
+ */
+interface CommentsListDiscriminator {
+    resourceId: string | undefined;
+    resourceType: string | undefined;
+    parentId: string | null | undefined;
+    status: string | undefined;
+    currentUserId: string | undefined;
+    authorId: string | undefined;
+    sort: string | undefined;
+    limit: number;
+    offset: number;
+}
+interface CommentCountDiscriminator {
+    resourceId: string;
+    resourceType: string;
+    status: string | undefined;
+}
+/**
+ * Discriminator for the infinite thread query (top-level comments only).
+ * Intentionally excludes `offset` — pages are driven by `pageParam`, not the key.
+ */
+interface CommentsThreadDiscriminator {
+    resourceId: string | undefined;
+    resourceType: string | undefined;
+    parentId: string | null | undefined;
+    status: string | undefined;
+    currentUserId: string | undefined;
+    limit: number;
+}
+/** Full query key builders — use with queryClient.setQueryData() */
+declare const COMMENTS_QUERY_KEYS: {
+    /**
+     * Key for comments list query.
+     * Full key: ["comments", "list", { resourceId, resourceType, parentId, status, currentUserId, limit, offset }]
+     */
+    commentsList: (params?: {
+        resourceId?: string;
+        resourceType?: string;
+        parentId?: string | null;
+        status?: string;
+        currentUserId?: string;
+        authorId?: string;
+        sort?: string;
+        limit?: number;
+        offset?: number;
+    }) => readonly ["comments", "list", CommentsListDiscriminator];
+    /**
+     * Key for a single comment detail query.
+     * Full key: ["comments", "detail", id]
+     */
+    commentDetail: (id: string) => readonly ["comments", "detail", string];
+    /**
+     * Key for comment count query.
+     * Full key: ["comments", "count", { resourceId, resourceType, status }]
+     */
+    commentCount: (params: {
+        resourceId: string;
+        resourceType: string;
+        status?: string;
+    }) => readonly ["comments", "count", CommentCountDiscriminator];
+    /**
+     * Key for the infinite thread query (top-level comments, load-more).
+     * Full key: ["commentsThread", "list", { resourceId, resourceType, parentId, status, currentUserId, limit }]
+     * Offset is excluded — it is driven by `pageParam`, not baked into the key.
+     */
+    commentsThread: (params?: {
+        resourceId?: string;
+        resourceType?: string;
+        parentId?: string | null;
+        status?: string;
+        currentUserId?: string;
+        limit?: number;
+    }) => readonly ["commentsThread", "list", CommentsThreadDiscriminator];
+};
+
+export { COMMENTS_QUERY_KEYS as e };
+export type { CommentListResult as C, SerializedComment as S, CommentsThreadDiscriminator as a, CommentsListDiscriminator as b, CommentCountDiscriminator as c, Comment as d };

package/dist/shared/stack.C-b3Sn8j.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Comment status values
+ */
+type CommentStatus = "pending" | "approved" | "spam";
+/**
+ * A comment record as stored in the database
+ */
+type Comment = {
+    id: string;
+    resourceId: string;
+    resourceType: string;
+    parentId: string | null;
+    authorId: string;
+    body: string;
+    status: CommentStatus;
+    likes: number;
+    editedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+};
+/**
+ * A comment enriched with server-resolved author info and like status.
+ * All dates are ISO strings (safe for serialisation over HTTP / React Query cache).
+ */
+interface SerializedComment {
+    id: string;
+    resourceId: string;
+    resourceType: string;
+    parentId: string | null;
+    authorId: string;
+    /** Resolved from resolveUser(authorId). Falls back to "[deleted]" when user cannot be found. */
+    resolvedAuthorName: string;
+    /** Resolved avatar URL or null */
+    resolvedAvatarUrl: string | null;
+    body: string;
+    status: CommentStatus;
+    /** Denormalized counter — updated atomically on toggleLike */
+    likes: number;
+    /** True when the currentUserId query param matches an existing commentLike row */
+    isLikedByCurrentUser: boolean;
+    /** ISO string set when the comment body was edited; null for unedited comments */
+    editedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    /**
+     * Number of direct replies visible to the requesting user.
+     * Includes approved replies plus any pending replies authored by `currentUserId`.
+     * Always 0 for reply comments (non-null parentId).
+     */
+    replyCount: number;
+}
+/**
+ * Paginated list result for comments
+ */
+interface CommentListResult {
+    items: SerializedComment[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+
+/**
+ * Internal query key constants for the Comments plugin.
+ * Shared between query-keys.ts (HTTP path) and any SSG/direct DB path
+ * to prevent key drift between loaders and prefetch calls.
+ */
+interface CommentsListDiscriminator {
+    resourceId: string | undefined;
+    resourceType: string | undefined;
+    parentId: string | null | undefined;
+    status: string | undefined;
+    currentUserId: string | undefined;
+    authorId: string | undefined;
+    sort: string | undefined;
+    limit: number;
+    offset: number;
+}
+interface CommentCountDiscriminator {
+    resourceId: string;
+    resourceType: string;
+    status: string | undefined;
+}
+/**
+ * Discriminator for the infinite thread query (top-level comments only).
+ * Intentionally excludes `offset` — pages are driven by `pageParam`, not the key.
+ */
+interface CommentsThreadDiscriminator {
+    resourceId: string | undefined;
+    resourceType: string | undefined;
+    parentId: string | null | undefined;
+    status: string | undefined;
+    currentUserId: string | undefined;
+    limit: number;
+}
+/** Full query key builders — use with queryClient.setQueryData() */
+declare const COMMENTS_QUERY_KEYS: {
+    /**
+     * Key for comments list query.
+     * Full key: ["comments", "list", { resourceId, resourceType, parentId, status, currentUserId, limit, offset }]
+     */
+    commentsList: (params?: {
+        resourceId?: string;
+        resourceType?: string;
+        parentId?: string | null;
+        status?: string;
+        currentUserId?: string;
+        authorId?: string;
+        sort?: string;
+        limit?: number;
+        offset?: number;
+    }) => readonly ["comments", "list", CommentsListDiscriminator];
+    /**
+     * Key for a single comment detail query.
+     * Full key: ["comments", "detail", id]
+     */
+    commentDetail: (id: string) => readonly ["comments", "detail", string];
+    /**
+     * Key for comment count query.
+     * Full key: ["comments", "count", { resourceId, resourceType, status }]
+     */
+    commentCount: (params: {
+        resourceId: string;
+        resourceType: string;
+        status?: string;
+    }) => readonly ["comments", "count", CommentCountDiscriminator];
+    /**
+     * Key for the infinite thread query (top-level comments, load-more).
+     * Full key: ["commentsThread", "list", { resourceId, resourceType, parentId, status, currentUserId, limit }]
+     * Offset is excluded — it is driven by `pageParam`, not baked into the key.
+     */
+    commentsThread: (params?: {
+        resourceId?: string;
+        resourceType?: string;
+        parentId?: string | null;
+        status?: string;
+        currentUserId?: string;
+        limit?: number;
+    }) => readonly ["commentsThread", "list", CommentsThreadDiscriminator];
+};
+
+export { COMMENTS_QUERY_KEYS as e };
+export type { CommentListResult as C, SerializedComment as S, CommentsThreadDiscriminator as a, CommentsListDiscriminator as b, CommentCountDiscriminator as c, Comment as d };

package/dist/shared/{stack.CFECM0ew.d.cts → stack.C1nXGBr6.d.cts}

@@ -1,4 +1,4 @@
-import { C as ComponentLayer, V as Variable } from './stack.DmpPDPxA.cjs';
+import { C as ComponentLayer, V as Variable } from './stack.BOCvd9HK.cjs';
 
 /**
  * UI Builder Page data structure

package/dist/shared/{stack.C9Mg2Q46.d.cts → stack.C9zoS1TN.d.cts}

@@ -2,7 +2,7 @@ import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { a as SerializedContentItemWithType, S as SerializedContentType, b as ContentType, c as ContentItem, d as SerializedContentItem, e as ContentItemWithType, f as CMSBackendConfig, I as InverseRelation } from './stack.B8QD11QU.cjs';
 import * as better_call from 'better-call';
 import { z } from 'zod';
-import { Adapter } from '@btst/db';
+import { DBAdapter } from '@btst/db';
 import { QueryClient } from '@tanstack/react-query';
 
 /**
@@ -29,7 +29,7 @@ declare function serializeContentItemWithType(item: ContentItemWithType): Serial
  *
  * @param adapter - The database adapter
  */
-declare function getAllContentTypes(adapter: Adapter): Promise<SerializedContentType[]>;
+declare function getAllContentTypes(adapter: DBAdapter): Promise<SerializedContentType[]>;
 /**
  * Retrieve all content items for a given content type, with optional pagination.
  * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
@@ -42,7 +42,7 @@ declare function getAllContentTypes(adapter: Adapter): Promise<SerializedContent
  * @param contentTypeSlug - The slug of the content type to query
  * @param params - Optional filter/pagination parameters
  */
-declare function getAllContentItems(adapter: Adapter, contentTypeSlug: string, params?: {
+declare function getAllContentItems(adapter: DBAdapter, contentTypeSlug: string, params?: {
     slug?: string;
     limit?: number;
     offset?: number;
@@ -63,7 +63,7 @@ declare function getAllContentItems(adapter: Adapter, contentTypeSlug: string, p
  * @param adapter - The database adapter
  * @param id - The content item ID (UUID)
  */
-declare function getContentItemById(adapter: Adapter, id: string): Promise<SerializedContentItemWithType | null>;
+declare function getContentItemById(adapter: DBAdapter, id: string): Promise<SerializedContentItemWithType | null>;
 /**
  * Retrieve a single content item by its slug within a content type.
  * Returns null if the content type or item is not found.
@@ -76,7 +76,7 @@ declare function getContentItemById(adapter: Adapter, id: string): Promise<Seria
  * @param contentTypeSlug - The slug of the content type
  * @param slug - The slug of the content item
  */
-declare function getContentItemBySlug(adapter: Adapter, contentTypeSlug: string, slug: string): Promise<SerializedContentItemWithType | null>;
+declare function getContentItemBySlug(adapter: DBAdapter, contentTypeSlug: string, slug: string): Promise<SerializedContentItemWithType | null>;
 
 /**
  * Input for creating a new CMS content item.
@@ -105,7 +105,7 @@ interface CreateCMSContentItemInput {
  * @param contentTypeSlug - Slug of the target content type
  * @param input - Item slug and data payload
  */
-declare function createCMSContentItem(adapter: Adapter, contentTypeSlug: string, input: CreateCMSContentItemInput): Promise<SerializedContentItem>;
+declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput): Promise<SerializedContentItem>;
 
 /**
  * Route keys for the CMS plugin — matches the keys returned by
@@ -129,7 +129,7 @@ interface CMSPrefetchForRoute {
  * @param config - Configuration with content types and optional hooks
  */
 declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugins_api.BackendPlugin<{
-    listContentTypes: better_call.StrictEndpoint<"/content-types", {
+    listContentTypes: better_call.StrictEndpoint<"/content-types", {} & {
         method: "GET";
     }, {
         itemCount: number;
@@ -144,21 +144,28 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
         autoFormVersion?: number | undefined;
     }[]>;
     getContentTypeBySlug: better_call.StrictEndpoint<"/content-types/:slug", {
-        method: "GET";
         params: z.ZodObject<{
             slug: z.ZodString;
         }, z.core.$strip>;
+    } & {
+        method: "GET";
     }, SerializedContentType>;
     listContentItems: better_call.StrictEndpoint<"/content/:typeSlug", {
-        method: "GET";
         params: z.ZodObject<{
             typeSlug: z.ZodString;
         }, z.core.$strip>;
-        query: z.ZodObject<{
-            slug: z.ZodOptional<z.ZodString>;
-            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-            offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            slug?: string | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            slug?: string | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
     }, {
         items: SerializedContentItemWithType[];
         total: number;
@@ -166,21 +173,30 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
         offset?: number;
     }>;
     getContentItem: better_call.StrictEndpoint<"/content/:typeSlug/:id", {
-        method: "GET";
         params: z.ZodObject<{
             typeSlug: z.ZodString;
             id: z.ZodString;
         }, z.core.$strip>;
+    } & {
+        method: "GET";
     }, SerializedContentItemWithType<Record<string, unknown>>>;
     createContentItem: better_call.StrictEndpoint<"/content/:typeSlug", {
-        method: "POST";
         params: z.ZodObject<{
             typeSlug: z.ZodString;
         }, z.core.$strip>;
-        body: z.ZodObject<{
-            slug: z.ZodString;
-            data: z.ZodObject<{}, z.core.$loose>;
-        }, z.core.$strip>;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            slug: string;
+            data: {
+                [x: string]: unknown;
+            };
+        }, {
+            slug: string;
+            data: {
+                [x: string]: unknown;
+            };
+        }>;
     }, {
         parsedData: Record<string, unknown>;
         createdAt: string;
@@ -192,31 +208,42 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
         authorId?: string | undefined;
     }>;
     updateContentItem: better_call.StrictEndpoint<"/content/:typeSlug/:id", {
-        method: "PUT";
         params: z.ZodObject<{
             typeSlug: z.ZodString;
             id: z.ZodString;
         }, z.core.$strip>;
-        body: z.ZodObject<{
-            slug: z.ZodOptional<z.ZodString>;
-            data: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
-        }, z.core.$strip>;
+    } & {
+        method: "PUT";
+        body: better_call.StandardSchemaV1<{
+            slug?: string | undefined;
+            data?: {
+                [x: string]: unknown;
+            } | undefined;
+        }, {
+            slug?: string | undefined;
+            data?: {
+                [x: string]: unknown;
+            } | undefined;
+        }>;
     }, SerializedContentItemWithType<Record<string, unknown>>>;
     deleteContentItem: better_call.StrictEndpoint<"/content/:typeSlug/:id", {
-        method: "DELETE";
         params: z.ZodObject<{
             typeSlug: z.ZodString;
             id: z.ZodString;
         }, z.core.$strip>;
+    } & {
+        method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
     }, {
         success: boolean;
     }>;
     getContentItemPopulated: better_call.StrictEndpoint<"/content/:typeSlug/:id/populated", {
-        method: "GET";
         params: z.ZodObject<{
             typeSlug: z.ZodString;
             id: z.ZodString;
         }, z.core.$strip>;
+    } & {
+        method: "GET";
     }, {
         _relations: Record<string, SerializedContentItemWithType<Record<string, unknown>>[]>;
         parsedData: Record<string, unknown>;
@@ -230,16 +257,23 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
         authorId?: string | undefined;
     }>;
     listContentByRelation: better_call.StrictEndpoint<"/content/:typeSlug/by-relation", {
-        method: "GET";
         params: z.ZodObject<{
             typeSlug: z.ZodString;
         }, z.core.$strip>;
-        query: z.ZodObject<{
-            field: z.ZodString;
-            targetId: z.ZodString;
-            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-            offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            field: string;
+            targetId: string;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            field: string;
+            targetId: string;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
     }, {
         items: SerializedContentItemWithType<Record<string, unknown>>[];
         total: number;
@@ -247,28 +281,39 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
         offset: number;
     }>;
     getInverseRelations: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations", {
-        method: "GET";
         params: z.ZodObject<{
             slug: z.ZodString;
         }, z.core.$strip>;
-        query: z.ZodObject<{
-            itemId: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            itemId?: string | undefined;
+        }, {
+            itemId?: string | undefined;
+        }>;
     }, {
         inverseRelations: InverseRelation[];
     }>;
     listInverseRelationItems: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations/:sourceType", {
-        method: "GET";
         params: z.ZodObject<{
             slug: z.ZodString;
             sourceType: z.ZodString;
         }, z.core.$strip>;
-        query: z.ZodObject<{
-            itemId: z.ZodString;
-            fieldName: z.ZodString;
-            limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-            offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
-        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            itemId: string;
+            fieldName: string;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            itemId: string;
+            fieldName: string;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
     }, {
         items: SerializedContentItemWithType<Record<string, unknown>>[];
         total: number;