@23blocks/block-content 3.3.7 → 3.4.0

package/dist/index.esm.js

@@ -1373,7 +1373,15 @@ function createSeriesService(transport, _config) {
     };
 }
 
-function createContentBlock(transport, config) {
+/**
+ * Create the Content block.
+ *
+ * @example
+ * ```typescript
+ * const block = createContentBlock(transport, { appId: 'xxx' });
+ * const posts = await block.posts.list({ page: 1 });
+ * ```
+ */ function createContentBlock(transport, config) {
     return {
         posts: createPostsService(transport),
         postVersions: createPostVersionsService(transport),

package/dist/src/lib/content.block.d.ts

@@ -1,21 +1,48 @@
 import type { Transport, BlockConfig, BlockMetadata } from '@23blocks/contracts';
 import { type PostsService, type PostVersionsService, type PostTemplatesService, type CommentsService, type CategoriesService, type TagsService, type ContentUsersService, type ModerationService, type ActivityService, type SeriesService } from './services/index.js';
+/**
+ * Configuration for the Content block.
+ */
 export interface ContentBlockConfig extends BlockConfig {
+    /** Application ID */
     appId: string;
+    /** Tenant ID (optional, for multi-tenant setups) */
     tenantId?: string;
 }
+/**
+ * Content management block interface.
+ */
 export interface ContentBlock {
+    /** Post CRUD operations */
     posts: PostsService;
+    /** Post version history management */
     postVersions: PostVersionsService;
+    /** Post template management */
     postTemplates: PostTemplatesService;
+    /** Comment management */
     comments: CommentsService;
+    /** Content category management */
     categories: CategoriesService;
+    /** Content tag management */
     tags: TagsService;
+    /** Content user management */
     users: ContentUsersService;
+    /** Content moderation operations */
     moderation: ModerationService;
+    /** Activity feed management */
     activity: ActivityService;
+    /** Content series management */
     series: SeriesService;
 }
+/**
+ * Create the Content block.
+ *
+ * @example
+ * ```typescript
+ * const block = createContentBlock(transport, { appId: 'xxx' });
+ * const posts = await block.posts.list({ page: 1 });
+ * ```
+ */
 export declare function createContentBlock(transport: Transport, config: ContentBlockConfig): ContentBlock;
 export declare const contentBlockMetadata: BlockMetadata;
 //# sourceMappingURL=content.block.d.ts.map

package/dist/src/lib/content.block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.block.d.ts","sourceRoot":"","sources":["../../../src/lib/content.block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAWL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,mBAAmB,CAAC;IAClC,aAAa,EAAE,oBAAoB,CAAC;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,GACzB,YAAY,CAad;AAED,eAAO,MAAM,oBAAoB,EAAE,aAiBlC,CAAC"}
+{"version":3,"file":"content.block.d.ts","sourceRoot":"","sources":["../../../src/lib/content.block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAWL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,mBAAmB,CAAC;IAClC,+BAA+B;IAC/B,aAAa,EAAE,oBAAoB,CAAC;IACpC,yBAAyB;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,kCAAkC;IAClC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,6BAA6B;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,8BAA8B;IAC9B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,oCAAoC;IACpC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,+BAA+B;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,gCAAgC;IAChC,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,GACzB,YAAY,CAad;AAED,eAAO,MAAM,oBAAoB,EAAE,aAiBlC,CAAC"}

package/dist/src/lib/services/activity.service.d.ts

@@ -7,14 +7,23 @@ import type { Comment, ListCommentsParams } from '../types/comment.js';
 export interface ActivityService {
     /**
      * Get activities for an identity (user)
+     * @param identityUniqueId - Unique ID of the identity to retrieve activities for
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of Activity records with pagination metadata
      */
     getActivities(identityUniqueId: string, params?: ListActivitiesParams): Promise<PageResult<Activity>>;
     /**
      * Get comments by an identity (user)
+     * @param identityUniqueId - Unique ID of the identity to retrieve comments for
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of Comment records with pagination metadata
      */
     getComments(identityUniqueId: string, params?: ListCommentsParams): Promise<PageResult<Comment>>;
     /**
      * Get the user's activity feed (activities from followed users)
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of Activity records from followed users with pagination metadata
+     * @note Returns activities from users the current user follows, not the user's own activities
      */
     getFeed(params?: ListActivitiesParams): Promise<PageResult<Activity>>;
 }

package/dist/src/lib/services/activity.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/activity.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,aAAa,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtG;;OAEG;IACH,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjG;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACzB,eAAe,CAqDjB"}
+{"version":3,"file":"activity.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/activity.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,aAAa,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtG;;;;;OAKG;IACH,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjG;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACzB,eAAe,CAqDjB"}

package/dist/src/lib/services/categories.service.d.ts

@@ -3,15 +3,21 @@ import type { Category, CreateCategoryRequest, ListCategoriesParams } from '../t
 export interface CategoriesService {
     /**
      * List all categories
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of Category records with pagination metadata
      */
     list(params?: ListCategoriesParams): Promise<PageResult<Category>>;
     /**
      * Get a category by unique ID
+     * @param uniqueId - Unique ID of the category to retrieve
+     * @returns The matching Category record
      */
     get(uniqueId: string): Promise<Category>;
     /**
      * Create a new category
-     * Note: The API does not support update or delete operations for categories
+     * @param data - Category creation payload
+     * @returns The newly created Category record
+     * @note The API does not support update or delete operations for categories
      */
     create(data: CreateCategoryRequest): Promise<Category>;
 }

package/dist/src/lib/services/categories.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"categories.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/categories.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEnE;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEzC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxD;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAqC3G"}
+{"version":3,"file":"categories.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/categories.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEnE;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxD;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAqC3G"}

package/dist/src/lib/services/comments.service.d.ts

@@ -3,33 +3,90 @@ import type { Comment, CreateCommentRequest, UpdateCommentRequest, ListCommentsP
 export interface CommentsService {
     /**
      * List comments for a post
+     * @param postUniqueId - Unique ID of the post to list comments for
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of Comment records with pagination metadata
      */
     list(postUniqueId: string, params?: ListCommentsParams): Promise<PageResult<Comment>>;
     /**
      * Get a specific comment
+     * @param postUniqueId - Unique ID of the parent post
+     * @param uniqueId - Unique ID of the comment to retrieve
+     * @returns The matching Comment record
      */
     get(postUniqueId: string, uniqueId: string): Promise<Comment>;
     /**
      * Create a new comment on a post
+     * @param postUniqueId - Unique ID of the post to comment on
+     * @param data - Comment creation payload
+     * @returns The newly created Comment record
      */
     create(postUniqueId: string, data: CreateCommentRequest): Promise<Comment>;
     /**
      * Update a comment
+     * @param postUniqueId - Unique ID of the parent post
+     * @param uniqueId - Unique ID of the comment to update
+     * @param data - Fields to update on the comment
+     * @returns The updated Comment record
      */
     update(postUniqueId: string, uniqueId: string, data: UpdateCommentRequest): Promise<Comment>;
     /**
      * Delete a comment
+     * @param postUniqueId - Unique ID of the parent post
+     * @param uniqueId - Unique ID of the comment to delete
+     * @returns void on successful deletion
      */
     delete(postUniqueId: string, uniqueId: string): Promise<void>;
     /**
      * Reply to a comment (creates a nested comment)
+     * @param postUniqueId - Unique ID of the parent post
+     * @param parentCommentUniqueId - Unique ID of the comment being replied to
+     * @param data - Reply content (parentId is set automatically from parentCommentUniqueId)
+     * @returns The newly created reply Comment record
+     * @note The parentId field is omitted from the request since it is derived from parentCommentUniqueId
      */
     reply(postUniqueId: string, parentCommentUniqueId: string, data: Omit<CreateCommentRequest, 'parentId'>): Promise<Comment>;
+    /**
+     * Like a comment
+     * @param postUniqueId - Unique ID of the parent post
+     * @param uniqueId - Unique ID of the comment to like
+     * @returns The updated Comment record with engagement state
+     */
     like(postUniqueId: string, uniqueId: string): Promise<Comment>;
+    /**
+     * Dislike a comment
+     * @param postUniqueId - Unique ID of the parent post
+     * @param uniqueId - Unique ID of the comment to dislike
+     * @returns The updated Comment record with engagement state
+     */
     dislike(postUniqueId: string, uniqueId: string): Promise<Comment>;
+    /**
+     * Save a comment to the user's saved items
+     * @param postUniqueId - Unique ID of the parent post
+     * @param uniqueId - Unique ID of the comment to save
+     * @returns The updated Comment record with engagement state
+     */
     save(postUniqueId: string, uniqueId: string): Promise<Comment>;
+    /**
+     * Remove a comment from the user's saved items
+     * @param postUniqueId - Unique ID of the parent post
+     * @param uniqueId - Unique ID of the comment to unsave
+     * @returns The updated Comment record with engagement state
+     */
     unsave(postUniqueId: string, uniqueId: string): Promise<Comment>;
+    /**
+     * Follow a comment to receive notifications on updates
+     * @param postUniqueId - Unique ID of the parent post
+     * @param uniqueId - Unique ID of the comment to follow
+     * @returns The updated Comment record with engagement state
+     */
     follow(postUniqueId: string, uniqueId: string): Promise<Comment>;
+    /**
+     * Unfollow a comment to stop receiving notifications
+     * @param postUniqueId - Unique ID of the parent post
+     * @param uniqueId - Unique ID of the comment to unfollow
+     * @returns The updated Comment record with engagement state
+     */
     unfollow(postUniqueId: string, uniqueId: string): Promise<Comment>;
 }
 export declare function createCommentsService(transport: Transport, _config: {

package/dist/src/lib/services/comments.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comments.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/comments.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtF;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9D;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3E;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7F;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;OAEG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAG3H,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAmGvG"}
+{"version":3,"file":"comments.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/comments.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtF;;;;;OAKG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3E;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7F;;;;;OAKG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;;;OAOG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3H;;;;;OAKG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElE;;;;;OAKG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAmGvG"}

package/dist/src/lib/services/moderation.service.d.ts

@@ -6,30 +6,50 @@ import type { ModerationResult, ModerateContentRequest, ContentFlag, CreateConte
 export interface ModerationService {
     /**
      * Moderate a post
+     * @param postUniqueId - Unique ID of the post to moderate
+     * @param request - Moderation action and reason
+     * @returns ModerationResult with success status, action taken, and timestamp
      */
     moderatePost(postUniqueId: string, request: ModerateContentRequest): Promise<ModerationResult>;
     /**
      * Moderate a comment
+     * @param postUniqueId - Unique ID of the parent post
+     * @param commentUniqueId - Unique ID of the comment to moderate
+     * @param request - Moderation action and reason
+     * @returns ModerationResult with success status, action taken, and timestamp
+     * @note Uses HTTP DELETE internally despite accepting a request body
      */
     moderateComment(postUniqueId: string, commentUniqueId: string, request: ModerateContentRequest): Promise<ModerationResult>;
     /**
      * List content flags
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of ContentFlag records with pagination metadata
      */
     listFlags(params?: ListContentFlagsParams): Promise<PageResult<ContentFlag>>;
     /**
      * Get a specific flag
+     * @param flagUniqueId - Unique ID of the flag to retrieve
+     * @returns The matching ContentFlag record
      */
     getFlag(flagUniqueId: string): Promise<ContentFlag>;
     /**
      * Create a content flag (report content)
+     * @param request - Flag details including content type, content ID, reason, and category
+     * @returns The newly created ContentFlag record
      */
     createFlag(request: CreateContentFlagRequest): Promise<ContentFlag>;
     /**
      * Resolve a content flag
+     * @param flagUniqueId - Unique ID of the flag to resolve
+     * @param resolution - Resolution description
+     * @returns The updated ContentFlag record with resolution applied
      */
     resolveFlag(flagUniqueId: string, resolution: string): Promise<ContentFlag>;
     /**
      * Dismiss a content flag
+     * @param flagUniqueId - Unique ID of the flag to dismiss
+     * @param reason - Optional reason for dismissal
+     * @returns void on successful dismissal
      */
     dismissFlag(flagUniqueId: string, reason?: string): Promise<void>;
 }

package/dist/src/lib/services/moderation.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"moderation.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/moderation.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,wBAAwB,EACxB,sBAAsB,EAEvB,MAAM,wBAAwB,CAAC;AAGhC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE/F;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE3H;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAE7E;;OAEG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpE;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5E;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACzB,iBAAiB,CA+FnB"}
+{"version":3,"file":"moderation.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/moderation.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,wBAAwB,EACxB,sBAAsB,EAEvB,MAAM,wBAAwB,CAAC;AAGhC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE/F;;;;;;;OAOG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE3H;;;;OAIG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAE7E;;;;OAIG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpD;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5E;;;;;OAKG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACzB,iBAAiB,CA+FnB"}

package/dist/src/lib/services/post-templates.service.d.ts

@@ -1,10 +1,36 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { PostTemplate, CreatePostTemplateRequest, UpdatePostTemplateRequest, ListPostTemplatesParams } from '../types/post-template.js';
 export interface PostTemplatesService {
+    /**
+     * List all post templates
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of PostTemplate records with pagination metadata
+     */
     list(params?: ListPostTemplatesParams): Promise<PageResult<PostTemplate>>;
+    /**
+     * Get a post template by unique ID
+     * @param uniqueId - Unique ID of the template to retrieve
+     * @returns The matching PostTemplate record
+     */
     get(uniqueId: string): Promise<PostTemplate>;
+    /**
+     * Create a new post template
+     * @param data - Template creation payload including name, slug, and field definitions
+     * @returns The newly created PostTemplate record
+     */
     create(data: CreatePostTemplateRequest): Promise<PostTemplate>;
+    /**
+     * Update a post template
+     * @param uniqueId - Unique ID of the template to update
+     * @param data - Fields to update on the template
+     * @returns The updated PostTemplate record
+     */
     update(uniqueId: string, data: UpdatePostTemplateRequest): Promise<PostTemplate>;
+    /**
+     * Delete a post template
+     * @param uniqueId - Unique ID of the template to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
 }
 export declare function createPostTemplatesService(transport: Transport, _config: {

package/dist/src/lib/services/post-templates.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-templates.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/post-templates.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACjF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CA+DjH"}
+{"version":3,"file":"post-templates.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/post-templates.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAE1E;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE7C;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjF;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CA+DjH"}

package/dist/src/lib/services/post-versions.service.d.ts

@@ -3,14 +3,25 @@ import type { PostVersion, ListPostVersionsParams } from '../types/post-version.
 export interface PostVersionsService {
     /**
      * List all versions of a post
+     * @param postUniqueId - Unique ID of the post to list versions for
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of PostVersion records with pagination metadata
+     * @note Versions are extracted from the post's included relationships rather than a dedicated endpoint
      */
     list(postUniqueId: string, params?: ListPostVersionsParams): Promise<PageResult<PostVersion>>;
     /**
      * Get a specific version of a post
+     * @param postUniqueId - Unique ID of the parent post
+     * @param versionUniqueId - Unique ID of the version to retrieve
+     * @returns The matching PostVersion record
+     * @note Fetches the post with included versions and filters to the requested version; throws if not found
      */
     get(postUniqueId: string, versionUniqueId: string): Promise<PostVersion>;
     /**
      * Publish a specific version (makes it the current live version)
+     * @param postUniqueId - Unique ID of the parent post
+     * @param versionUniqueId - Unique ID of the version to publish
+     * @returns The published PostVersion record
      */
     publish(postUniqueId: string, versionUniqueId: string): Promise<PostVersion>;
 }

package/dist/src/lib/services/post-versions.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-versions.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/post-versions.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGpF,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAE9F;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzE;;OAEG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CAuD/G"}
+{"version":3,"file":"post-versions.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/post-versions.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGpF,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAE9F;;;;;;OAMG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CAuD/G"}

package/dist/src/lib/services/posts.service.d.ts

@@ -2,24 +2,127 @@ import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Post, CreatePostRequest, UpdatePostRequest, ListPostsParams } from '../types/post.js';
 import type { PostValidationResult } from '../types/post-template.js';
 export interface PostsService {
+    /**
+     * List all posts
+     * @param params - Optional filtering, sorting, and pagination parameters
+     * @returns Paginated list of Post records with pagination metadata
+     */
     list(params?: ListPostsParams): Promise<PageResult<Post>>;
+    /**
+     * Query posts using advanced filters via POST
+     * @param params - Required filtering and pagination parameters
+     * @returns Paginated list of Post records with pagination metadata
+     * @note Uses POST for complex query payloads unlike the GET-based list method
+     */
     query(params: ListPostsParams): Promise<PageResult<Post>>;
+    /**
+     * Get a post by unique ID
+     * @param uniqueId - Unique ID of the post to retrieve
+     * @returns The matching Post record
+     */
     get(uniqueId: string): Promise<Post>;
+    /**
+     * Create a new post
+     * @param data - Post creation payload
+     * @returns The newly created Post record
+     */
     create(data: CreatePostRequest): Promise<Post>;
+    /**
+     * Update a post (partial update)
+     * @param uniqueId - Unique ID of the post to update
+     * @param data - Fields to update on the post
+     * @returns The updated Post record
+     */
     update(uniqueId: string, data: UpdatePostRequest): Promise<Post>;
+    /**
+     * Replace a post (full replacement)
+     * @param uniqueId - Unique ID of the post to replace
+     * @param data - Complete post data to replace the existing record
+     * @returns The replaced Post record
+     * @note Unlike update, this replaces the entire post content rather than merging fields
+     */
     replace(uniqueId: string, data: UpdatePostRequest): Promise<Post>;
+    /**
+     * Delete a post (soft delete)
+     * @param uniqueId - Unique ID of the post to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * Recover a previously deleted post
+     * @param uniqueId - Unique ID of the deleted post to recover
+     * @returns The recovered Post record
+     */
     recover(uniqueId: string): Promise<Post>;
+    /**
+     * Search posts by query string
+     * @param query - Search query text
+     * @param params - Optional pagination parameters
+     * @returns Paginated list of matching Post records with pagination metadata
+     */
     search(query: string, params?: ListPostsParams): Promise<PageResult<Post>>;
+    /**
+     * List soft-deleted posts
+     * @param params - Optional pagination parameters
+     * @returns Paginated list of deleted Post records with pagination metadata
+     */
     listDeleted(params?: ListPostsParams): Promise<PageResult<Post>>;
+    /**
+     * Transfer ownership of a post to another user
+     * @param uniqueId - Unique ID of the post to transfer
+     * @param newOwnerUniqueId - Unique ID of the new owner
+     * @returns The updated Post record with new ownership
+     */
     changeOwner(uniqueId: string, newOwnerUniqueId: string): Promise<Post>;
+    /**
+     * Publish a specific version of a post
+     * @param uniqueId - Unique ID of the post
+     * @param versionUniqueId - Unique ID of the version to publish
+     * @returns The updated Post record reflecting the published version
+     */
     publishVersion(uniqueId: string, versionUniqueId: string): Promise<Post>;
+    /**
+     * Like a post
+     * @param uniqueId - Unique ID of the post to like
+     * @returns The updated Post record with engagement state
+     */
     like(uniqueId: string): Promise<Post>;
+    /**
+     * Remove a like from a post
+     * @param uniqueId - Unique ID of the post to dislike
+     * @returns The updated Post record with engagement state
+     */
     dislike(uniqueId: string): Promise<Post>;
+    /**
+     * Save a post to the user's saved items
+     * @param uniqueId - Unique ID of the post to save
+     * @returns The updated Post record with engagement state
+     */
     save(uniqueId: string): Promise<Post>;
+    /**
+     * Remove a post from the user's saved items
+     * @param uniqueId - Unique ID of the post to unsave
+     * @returns The updated Post record with engagement state
+     */
     unsave(uniqueId: string): Promise<Post>;
+    /**
+     * Follow a post to receive notifications on updates
+     * @param uniqueId - Unique ID of the post to follow
+     * @returns The updated Post record with engagement state
+     */
     follow(uniqueId: string): Promise<Post>;
+    /**
+     * Unfollow a post to stop receiving notifications
+     * @param uniqueId - Unique ID of the post to unfollow
+     * @returns The updated Post record with engagement state
+     */
     unfollow(uniqueId: string): Promise<Post>;
+    /**
+     * Validate a post against a post template
+     * @param uniqueId - Unique ID of the post to validate
+     * @param templateUniqueId - Unique ID of the template to validate against
+     * @returns PostValidationResult indicating whether the post conforms to the template
+     */
     validate(uniqueId: string, templateUniqueId: string): Promise<PostValidationResult>;
 }
 export declare function createPostsService(transport: Transport, _config: {

package/dist/src/lib/services/posts.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"posts.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/posts.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,IAAI,EACJ,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAItE,MAAM,WAAW,YAAY;IAE3B,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,WAAW,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAGjE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGzE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrF;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CA6LjG"}
+{"version":3,"file":"posts.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/posts.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,IAAI,EACJ,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAItE,MAAM,WAAW,YAAY;IAG3B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1D;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3E;;;;OAIG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAIjE;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIvE;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIzE;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAI1C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrF;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CA6LjG"}

package/dist/src/lib/services/series.service.d.ts

@@ -2,21 +2,106 @@ import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Series, CreateSeriesRequest, UpdateSeriesRequest, ListSeriesParams, QuerySeriesParams, ReorderPostsRequest } from '../types/series.js';
 import type { Post } from '../types/post.js';
 export interface SeriesService {
+    /**
+     * List all series
+     * @param params - Optional pagination parameters
+     * @returns Paginated list of Series records with pagination metadata
+     */
     list(params?: ListSeriesParams): Promise<PageResult<Series>>;
+    /**
+     * Query series using advanced filters via POST
+     * @param params - Required filtering and pagination parameters
+     * @returns Paginated list of Series records with pagination metadata
+     */
     query(params: QuerySeriesParams): Promise<PageResult<Series>>;
+    /**
+     * Get a series by unique ID
+     * @param uniqueId - Unique ID of the series to retrieve
+     * @returns The matching Series record
+     */
     get(uniqueId: string): Promise<Series>;
+    /**
+     * Create a new series
+     * @param data - Series creation payload
+     * @returns The newly created Series record
+     */
     create(data: CreateSeriesRequest): Promise<Series>;
+    /**
+     * Update a series
+     * @param uniqueId - Unique ID of the series to update
+     * @param data - Fields to update on the series
+     * @returns The updated Series record
+     */
     update(uniqueId: string, data: UpdateSeriesRequest): Promise<Series>;
+    /**
+     * Delete a series
+     * @param uniqueId - Unique ID of the series to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * Like a series
+     * @param uniqueId - Unique ID of the series to like
+     * @returns The updated Series record with engagement state
+     */
     like(uniqueId: string): Promise<Series>;
+    /**
+     * Remove a like from a series
+     * @param uniqueId - Unique ID of the series to dislike
+     * @returns The updated Series record with engagement state
+     */
     dislike(uniqueId: string): Promise<Series>;
+    /**
+     * Follow a series to receive notifications on updates
+     * @param uniqueId - Unique ID of the series to follow
+     * @returns The updated Series record with engagement state
+     */
     follow(uniqueId: string): Promise<Series>;
+    /**
+     * Unfollow a series to stop receiving notifications
+     * @param uniqueId - Unique ID of the series to unfollow
+     * @returns void on successful unfollow
+     */
     unfollow(uniqueId: string): Promise<void>;
+    /**
+     * Save a series to the user's saved items
+     * @param uniqueId - Unique ID of the series to save
+     * @returns The updated Series record with engagement state
+     */
     save(uniqueId: string): Promise<Series>;
+    /**
+     * Remove a series from the user's saved items
+     * @param uniqueId - Unique ID of the series to unsave
+     * @returns void on successful unsave
+     */
     unsave(uniqueId: string): Promise<void>;
+    /**
+     * Get all posts belonging to a series
+     * @param uniqueId - Unique ID of the series
+     * @returns Array of Post records in the series
+     */
     getPosts(uniqueId: string): Promise<Post[]>;
+    /**
+     * Add a post to a series
+     * @param seriesUniqueId - Unique ID of the series
+     * @param postUniqueId - Unique ID of the post to add
+     * @param sequence - Optional position in the series ordering
+     * @returns void on successful addition
+     */
     addPost(seriesUniqueId: string, postUniqueId: string, sequence?: number): Promise<void>;
+    /**
+     * Remove a post from a series
+     * @param seriesUniqueId - Unique ID of the series
+     * @param postUniqueId - Unique ID of the post to remove
+     * @returns void on successful removal
+     */
     removePost(seriesUniqueId: string, postUniqueId: string): Promise<void>;
+    /**
+     * Reorder posts within a series
+     * @param uniqueId - Unique ID of the series
+     * @param data - Array of post-sequence pairs defining the new order
+     * @returns The updated Series record
+     */
     reorderPosts(uniqueId: string, data: ReorderPostsRequest): Promise<Series>;
 }
 export declare function createSeriesService(transport: Transport, _config: {

package/dist/src/lib/services/series.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"series.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/series.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,MAAM,EACN,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C,MAAM,WAAW,aAAa;IAE5B,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGxC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CA4HnG"}
+{"version":3,"file":"series.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/series.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,MAAM,EACN,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C,MAAM,WAAW,aAAa;IAG5B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7D;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9D;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIxC;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3C;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIxC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE5C;;;;;;OAMG;IACH,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExF;;;;;OAKG;IACH,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CA4HnG"}

package/dist/src/lib/services/tags.service.d.ts

@@ -1,10 +1,36 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Tag, CreateTagRequest, UpdateTagRequest, ListTagsParams } from '../types/tag.js';
 export interface TagsService {
+    /**
+     * List all tags
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of Tag records with pagination metadata
+     */
     list(params?: ListTagsParams): Promise<PageResult<Tag>>;
+    /**
+     * Get a tag by unique ID
+     * @param uniqueId - Unique ID of the tag to retrieve
+     * @returns The matching Tag record
+     */
     get(uniqueId: string): Promise<Tag>;
+    /**
+     * Create a new tag
+     * @param data - Tag creation payload
+     * @returns The newly created Tag record
+     */
     create(data: CreateTagRequest): Promise<Tag>;
+    /**
+     * Update a tag
+     * @param uniqueId - Unique ID of the tag to update
+     * @param data - Fields to update on the tag
+     * @returns The updated Tag record
+     */
     update(uniqueId: string, data: UpdateTagRequest): Promise<Tag>;
+    /**
+     * Delete a tag
+     * @param uniqueId - Unique ID of the tag to delete
+     * @returns void on successful deletion
+     */
     delete(uniqueId: string): Promise<void>;
 }
 export declare function createTagsService(transport: Transport, _config: {

package/dist/src/lib/services/tags.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tags.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/tags.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,GAAG,EACH,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAmD/F"}
+{"version":3,"file":"tags.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/tags.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,GAAG,EACH,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAExD;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE/D;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAmD/F"}

package/dist/src/lib/services/users.service.d.ts

@@ -3,19 +3,95 @@ import type { ContentUser, Following, RegisterContentUserRequest, UpdateContentU
 import type { Post } from '../types/post.js';
 import type { Comment } from '../types/comment.js';
 export interface ContentUsersService {
+    /**
+     * List all content users
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of ContentUser records with pagination metadata
+     */
     list(params?: ListContentUsersParams): Promise<PageResult<ContentUser>>;
+    /**
+     * Get a content user by unique ID
+     * @param uniqueId - Unique ID of the user to retrieve
+     * @returns The matching ContentUser record
+     */
     get(uniqueId: string): Promise<ContentUser>;
+    /**
+     * Register a user in the content system
+     * @param uniqueId - Unique ID of the user to register
+     * @param data - Registration payload with profile details
+     * @returns The newly registered ContentUser record
+     */
     register(uniqueId: string, data: RegisterContentUserRequest): Promise<ContentUser>;
+    /**
+     * Update a content user's profile
+     * @param uniqueId - Unique ID of the user to update
+     * @param data - Fields to update on the user profile
+     * @returns The updated ContentUser record
+     */
     update(uniqueId: string, data: UpdateContentUserRequest): Promise<ContentUser>;
+    /**
+     * Get a user's draft posts
+     * @param uniqueId - Unique ID of the user
+     * @returns Array of draft Post records
+     */
     getDrafts(uniqueId: string): Promise<Post[]>;
+    /**
+     * Get a user's published posts
+     * @param uniqueId - Unique ID of the user
+     * @returns Array of Post records
+     */
     getPosts(uniqueId: string): Promise<Post[]>;
+    /**
+     * Get a user's comments
+     * @param uniqueId - Unique ID of the user
+     * @returns Array of Comment records
+     */
     getComments(uniqueId: string): Promise<Comment[]>;
+    /**
+     * Get a user's activity history
+     * @param uniqueId - Unique ID of the user
+     * @returns Array of UserActivity records with activity type, target, and timestamp
+     */
     getActivities(uniqueId: string): Promise<UserActivity[]>;
+    /**
+     * Add a tag to a content user
+     * @param uniqueId - Unique ID of the user
+     * @param tagUniqueId - Unique ID of the tag to add
+     * @returns The updated ContentUser record
+     */
     addTag(uniqueId: string, tagUniqueId: string): Promise<ContentUser>;
+    /**
+     * Remove a tag from a content user
+     * @param uniqueId - Unique ID of the user
+     * @param tagUniqueId - Unique ID of the tag to remove
+     * @returns void on successful removal
+     */
     removeTag(uniqueId: string, tagUniqueId: string): Promise<void>;
+    /**
+     * Get a user's followers
+     * @param uniqueId - Unique ID of the user
+     * @returns Array of Following records with full relationship data
+     */
     getFollowers(uniqueId: string): Promise<Following[]>;
+    /**
+     * Get users that a user is following
+     * @param uniqueId - Unique ID of the user
+     * @returns Array of Following records with full relationship data
+     */
     getFollowing(uniqueId: string): Promise<Following[]>;
+    /**
+     * Follow another user
+     * @param uniqueId - Unique ID of the current user
+     * @param targetUserUniqueId - Unique ID of the user to follow
+     * @returns void on successful follow
+     */
     followUser(uniqueId: string, targetUserUniqueId: string): Promise<void>;
+    /**
+     * Unfollow another user
+     * @param uniqueId - Unique ID of the current user
+     * @param targetUserUniqueId - Unique ID of the user to unfollow
+     * @returns void on successful unfollow
+     */
     unfollowUser(uniqueId: string, targetUserUniqueId: string): Promise<void>;
 }
 export declare function createContentUsersService(transport: Transport, _config: {

package/dist/src/lib/services/users.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/users.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACxE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAG/E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAClD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAGzD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGhE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CAkH/G"}
+{"version":3,"file":"users.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/users.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAExE;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAI/E;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE5C;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAElD;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAIzD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIhE;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAErD;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAErD;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CAkH/G"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@23blocks/block-content",
-  "version": "3.3.7",
+  "version": "3.4.0",
   "type": "module",
   "repository": {
     "type": "git",