@molecule/api-resource-comment 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Threaded comments resource for molecule.dev.
+ *
+ * Polymorphic comments that attach to any resource type. Supports threaded
+ * replies, pagination, and ownership-based authorization.
+ *
+ * @module
+ * @example
+ * ```typescript
+ * import { routes, requestHandlerMap } from '@molecule/api-resource-comment'
+ *
+ * // Wire routes into your Express app via mlcl inject
+ * // POST   /:resourceType/:resourceId/comments
+ * // GET    /:resourceType/:resourceId/comments
+ * // GET    /comments/:commentId
+ * // PUT    /comments/:commentId
+ * // DELETE /comments/:commentId
+ * // GET    /comments/:commentId/replies
+ * // GET    /:resourceType/:resourceId/comments/count — cheap badge counts
+ * ```
+ *
+ * @remarks
+ * - **List endpoints return a PAGINATED envelope** `{ data, total, limit, offset }`, not a
+ *   bare array — read the rows off `result.data` (server). On the client, `unwrapList(res)`
+ *   from `@molecule/app-http` normalizes this envelope (pass it the whole HttpResponse), so
+ *   the rows come back; reading the response as a bare array — or `res.data` alone (which is
+ *   the envelope) — yields an EMPTY list.
+ * - **Migration required.** `src/__setup__/comments.sql` ships with this package
+ *   and must exist in the target database before use (scaffolded apps apply it
+ *   automatically; existing apps must apply it first).
+ * - **Reads are PUBLIC by default.** `list`, `read`, `replies`, and `count` ship
+ *   with no auth middleware (comment threads on public content). If the
+ *   commented resources are private in your app, add an authorizer that checks
+ *   access to the PARENT resource before serving its comments.
+ * - **The author is always the session user.** Create/update/delete require
+ *   `authenticate`; the create handler ignores any client-supplied author id,
+ *   and update/delete verify ownership in the handler — keep those properties
+ *   in any custom path.
+ * - **The parent is polymorphic and unverified** (no FK on
+ *   `resourceType`/`resourceId`): validate that the target exists in your domain
+ *   code if orphaned threads matter, and reuse the same canonical type slugs as
+ *   your other polymorphic resources (bookmarks, activity feed).
+ *
+ * @e2e
+ * Integration checklist — drive the real UI (live preview, no mocks), adapt
+ * each item to this app's actual screens/flows, and check every box off one
+ * by one. A box you can't check is an integration bug to fix — not a skip:
+ * - [ ] Posting a comment on a commentable resource shows it in the thread
+ *   immediately and it persists across a full reload.
+ * - [ ] Replying to a comment renders the reply nested under its parent.
+ * - [ ] The author can edit their own comment and the updated text persists;
+ *   a DIFFERENT signed-in user gets no edit/delete controls on it and a
+ *   direct attempt is denied.
+ * - [ ] Deleting an own comment removes it per the app's policy (gone or
+ *   tombstone) and stays removed after reload.
+ * - [ ] A long thread paginates ("load more" fetches older comments) without
+ *   duplicating or dropping entries.
+ * - [ ] A resource with no comments shows a readable empty state.
+ */
+export * from './authorizers/index.js';
+export * from './browser-guard.js';
+export * from './handlers/index.js';
+export * from './requestHandlerMap.js';
+export * from './routes.js';
+export * from './service.js';
+export * from './types.js';
+export * from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,67 @@
+/**
+ * Threaded comments resource for molecule.dev.
+ *
+ * Polymorphic comments that attach to any resource type. Supports threaded
+ * replies, pagination, and ownership-based authorization.
+ *
+ * @module
+ * @example
+ * ```typescript
+ * import { routes, requestHandlerMap } from '@molecule/api-resource-comment'
+ *
+ * // Wire routes into your Express app via mlcl inject
+ * // POST   /:resourceType/:resourceId/comments
+ * // GET    /:resourceType/:resourceId/comments
+ * // GET    /comments/:commentId
+ * // PUT    /comments/:commentId
+ * // DELETE /comments/:commentId
+ * // GET    /comments/:commentId/replies
+ * // GET    /:resourceType/:resourceId/comments/count — cheap badge counts
+ * ```
+ *
+ * @remarks
+ * - **List endpoints return a PAGINATED envelope** `{ data, total, limit, offset }`, not a
+ *   bare array — read the rows off `result.data` (server). On the client, `unwrapList(res)`
+ *   from `@molecule/app-http` normalizes this envelope (pass it the whole HttpResponse), so
+ *   the rows come back; reading the response as a bare array — or `res.data` alone (which is
+ *   the envelope) — yields an EMPTY list.
+ * - **Migration required.** `src/__setup__/comments.sql` ships with this package
+ *   and must exist in the target database before use (scaffolded apps apply it
+ *   automatically; existing apps must apply it first).
+ * - **Reads are PUBLIC by default.** `list`, `read`, `replies`, and `count` ship
+ *   with no auth middleware (comment threads on public content). If the
+ *   commented resources are private in your app, add an authorizer that checks
+ *   access to the PARENT resource before serving its comments.
+ * - **The author is always the session user.** Create/update/delete require
+ *   `authenticate`; the create handler ignores any client-supplied author id,
+ *   and update/delete verify ownership in the handler — keep those properties
+ *   in any custom path.
+ * - **The parent is polymorphic and unverified** (no FK on
+ *   `resourceType`/`resourceId`): validate that the target exists in your domain
+ *   code if orphaned threads matter, and reuse the same canonical type slugs as
+ *   your other polymorphic resources (bookmarks, activity feed).
+ *
+ * @e2e
+ * Integration checklist — drive the real UI (live preview, no mocks), adapt
+ * each item to this app's actual screens/flows, and check every box off one
+ * by one. A box you can't check is an integration bug to fix — not a skip:
+ * - [ ] Posting a comment on a commentable resource shows it in the thread
+ *   immediately and it persists across a full reload.
+ * - [ ] Replying to a comment renders the reply nested under its parent.
+ * - [ ] The author can edit their own comment and the updated text persists;
+ *   a DIFFERENT signed-in user gets no edit/delete controls on it and a
+ *   direct attempt is denied.
+ * - [ ] Deleting an own comment removes it per the app's policy (gone or
+ *   tombstone) and stays removed after reload.
+ * - [ ] A long thread paginates ("load more" fetches older comments) without
+ *   duplicating or dropping entries.
+ * - [ ] A resource with no comments shows a readable empty state.
+ */
+export * from './authorizers/index.js';
+export * from './browser-guard.js';
+export * from './handlers/index.js';
+export * from './requestHandlerMap.js';
+export * from './routes.js';
+export * from './service.js';
+export * from './types.js';
+export * from './validation.js';

package/dist/requestHandlerMap.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Maps route handler names to their implementations.
+ *
+ * @module
+ */
+import { commentCount } from './handlers/count.js';
+import { create } from './handlers/create.js';
+import { del } from './handlers/del.js';
+import { list } from './handlers/list.js';
+import { read } from './handlers/read.js';
+import { replies } from './handlers/replies.js';
+import { update } from './handlers/update.js';
+/**
+ * Handler map for comment routes.
+ */
+export declare const requestHandlerMap: {
+    readonly create: typeof create;
+    readonly list: typeof list;
+    readonly commentCount: typeof commentCount;
+    readonly read: typeof read;
+    readonly update: typeof update;
+    readonly del: typeof del;
+    readonly replies: typeof replies;
+};
+//# sourceMappingURL=requestHandlerMap.d.ts.map

package/dist/requestHandlerMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestHandlerMap.d.ts","sourceRoot":"","sources":["../src/requestHandlerMap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;CAQpB,CAAA"}

package/dist/requestHandlerMap.js

@@ -0,0 +1,24 @@
+/**
+ * Maps route handler names to their implementations.
+ *
+ * @module
+ */
+import { commentCount } from './handlers/count.js';
+import { create } from './handlers/create.js';
+import { del } from './handlers/del.js';
+import { list } from './handlers/list.js';
+import { read } from './handlers/read.js';
+import { replies } from './handlers/replies.js';
+import { update } from './handlers/update.js';
+/**
+ * Handler map for comment routes.
+ */
+export const requestHandlerMap = {
+    create,
+    list,
+    commentCount,
+    read,
+    update,
+    del,
+    replies,
+};

package/dist/routes.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Comment route definitions.
+ *
+ * Declarative routing — mlcl inject reads these to generate the Express router.
+ *
+ * @module
+ */
+/**
+ * Routes for comment CRUD and threaded replies.
+ */
+export declare const routes: readonly [{
+    readonly method: "post";
+    readonly path: "/:resourceType/:resourceId/comments";
+    readonly handler: "create";
+    readonly middlewares: readonly ["authenticate"];
+}, {
+    readonly method: "get";
+    readonly path: "/:resourceType/:resourceId/comments";
+    readonly handler: "list";
+}, {
+    readonly method: "get";
+    readonly path: "/:resourceType/:resourceId/comments/count";
+    readonly handler: "commentCount";
+}, {
+    readonly method: "get";
+    readonly path: "/comments/:commentId";
+    readonly handler: "read";
+}, {
+    readonly method: "put";
+    readonly path: "/comments/:commentId";
+    readonly handler: "update";
+    readonly middlewares: readonly ["authenticate"];
+}, {
+    readonly method: "delete";
+    readonly path: "/comments/:commentId";
+    readonly handler: "del";
+    readonly middlewares: readonly ["authenticate"];
+}, {
+    readonly method: "get";
+    readonly path: "/comments/:commentId/replies";
+    readonly handler: "replies";
+}];
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaT,CAAA"}

package/dist/routes.js

@@ -0,0 +1,24 @@
+/**
+ * Comment route definitions.
+ *
+ * Declarative routing — mlcl inject reads these to generate the Express router.
+ *
+ * @module
+ */
+/**
+ * Routes for comment CRUD and threaded replies.
+ */
+export const routes = [
+    {
+        method: 'post',
+        path: '/:resourceType/:resourceId/comments',
+        handler: 'create',
+        middlewares: ['authenticate'],
+    },
+    { method: 'get', path: '/:resourceType/:resourceId/comments', handler: 'list' },
+    { method: 'get', path: '/:resourceType/:resourceId/comments/count', handler: 'commentCount' },
+    { method: 'get', path: '/comments/:commentId', handler: 'read' },
+    { method: 'put', path: '/comments/:commentId', handler: 'update', middlewares: ['authenticate'] },
+    { method: 'delete', path: '/comments/:commentId', handler: 'del', middlewares: ['authenticate'] },
+    { method: 'get', path: '/comments/:commentId/replies', handler: 'replies' },
+];

package/dist/service.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Comment business logic service.
+ *
+ * Uses the abstract DataStore from `@molecule/api-database` for all
+ * persistence — never raw SQL.
+ *
+ * @module
+ */
+import type { Comment, CreateCommentInput, PaginatedResult, PaginationOptions, UpdateCommentInput } from './types.js';
+/**
+ * Creates a new comment on a resource.
+ *
+ * @param resourceType - The type of resource being commented on.
+ * @param resourceId - The ID of the resource being commented on.
+ * @param userId - The ID of the commenting user.
+ * @param data - The comment creation input.
+ * @returns The created comment.
+ */
+export declare function createComment(resourceType: string, resourceId: string, userId: string, data: CreateCommentInput): Promise<Comment>;
+/**
+ * Retrieves paginated comments for a resource, ordered by creation date descending.
+ * Only returns top-level comments (no replies).
+ *
+ * @param resourceType - The type of resource.
+ * @param resourceId - The ID of the resource.
+ * @param options - Pagination options.
+ * @returns A paginated result of comments.
+ */
+export declare function getCommentsByResource(resourceType: string, resourceId: string, options?: PaginationOptions): Promise<PaginatedResult<Comment>>;
+/**
+ * Retrieves a single comment by ID.
+ *
+ * @param commentId - The comment ID to look up.
+ * @returns The comment or `null` if not found.
+ */
+export declare function getCommentById(commentId: string): Promise<Comment | null>;
+/**
+ * Updates a comment. Only the comment owner can update.
+ *
+ * @param commentId - The comment ID to update.
+ * @param userId - The requesting user's ID (must match comment owner).
+ * @param data - The update input.
+ * @returns The updated comment or `null` if not found or unauthorized.
+ */
+export declare function updateComment(commentId: string, userId: string, data: UpdateCommentInput): Promise<Comment | null>;
+/**
+ * Deletes a comment. Only the comment owner can delete.
+ *
+ * @param commentId - The comment ID to delete.
+ * @param userId - The requesting user's ID (must match comment owner).
+ * @returns `true` if deleted, `false` if not found or unauthorized.
+ */
+export declare function deleteComment(commentId: string, userId: string): Promise<boolean>;
+/**
+ * Retrieves paginated replies to a comment, ordered by creation date ascending.
+ *
+ * @param commentId - The parent comment ID.
+ * @param options - Pagination options.
+ * @returns A paginated result of reply comments.
+ */
+export declare function getReplies(commentId: string, options?: PaginationOptions): Promise<PaginatedResult<Comment>>;
+/**
+ * Returns the total number of comments on a resource (including replies).
+ *
+ * @param resourceType - The type of resource.
+ * @param resourceId - The ID of the resource.
+ * @returns The total comment count.
+ */
+export declare function getCommentCount(resourceType: string, resourceId: string): Promise<number>;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAInB;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAqBnC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAE/E;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAUzB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMvF;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAiBnC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK/F"}

package/dist/service.js

@@ -0,0 +1,135 @@
+/**
+ * Comment business logic service.
+ *
+ * Uses the abstract DataStore from `@molecule/api-database` for all
+ * persistence — never raw SQL.
+ *
+ * @module
+ */
+import { count, create as dbCreate, deleteById, findById, findMany, updateById, } from '@molecule/api-database';
+const TABLE = 'comments';
+/**
+ * Creates a new comment on a resource.
+ *
+ * @param resourceType - The type of resource being commented on.
+ * @param resourceId - The ID of the resource being commented on.
+ * @param userId - The ID of the commenting user.
+ * @param data - The comment creation input.
+ * @returns The created comment.
+ */
+export async function createComment(resourceType, resourceId, userId, data) {
+    const result = await dbCreate(TABLE, {
+        resourceType,
+        resourceId,
+        userId,
+        parentId: data.parentId ?? null,
+        body: data.body,
+        editedAt: null,
+    });
+    return result.data;
+}
+/**
+ * Retrieves paginated comments for a resource, ordered by creation date descending.
+ * Only returns top-level comments (no replies).
+ *
+ * @param resourceType - The type of resource.
+ * @param resourceId - The ID of the resource.
+ * @param options - Pagination options.
+ * @returns A paginated result of comments.
+ */
+export async function getCommentsByResource(resourceType, resourceId, options = {}) {
+    const limit = options.limit ?? 20;
+    const offset = options.offset ?? 0;
+    const where = [
+        { field: 'resourceType', operator: '=', value: resourceType },
+        { field: 'resourceId', operator: '=', value: resourceId },
+        { field: 'parentId', operator: 'is_null' },
+    ];
+    const [data, total] = await Promise.all([
+        findMany(TABLE, {
+            where,
+            orderBy: [{ field: 'createdAt', direction: 'desc' }],
+            limit,
+            offset,
+        }),
+        count(TABLE, where),
+    ]);
+    return { data, total, limit, offset };
+}
+/**
+ * Retrieves a single comment by ID.
+ *
+ * @param commentId - The comment ID to look up.
+ * @returns The comment or `null` if not found.
+ */
+export async function getCommentById(commentId) {
+    return findById(TABLE, commentId);
+}
+/**
+ * Updates a comment. Only the comment owner can update.
+ *
+ * @param commentId - The comment ID to update.
+ * @param userId - The requesting user's ID (must match comment owner).
+ * @param data - The update input.
+ * @returns The updated comment or `null` if not found or unauthorized.
+ */
+export async function updateComment(commentId, userId, data) {
+    const existing = await findById(TABLE, commentId);
+    if (!existing || existing.userId !== userId)
+        return null;
+    const result = await updateById(TABLE, commentId, {
+        body: data.body,
+        editedAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    });
+    return result.data;
+}
+/**
+ * Deletes a comment. Only the comment owner can delete.
+ *
+ * @param commentId - The comment ID to delete.
+ * @param userId - The requesting user's ID (must match comment owner).
+ * @returns `true` if deleted, `false` if not found or unauthorized.
+ */
+export async function deleteComment(commentId, userId) {
+    const existing = await findById(TABLE, commentId);
+    if (!existing || existing.userId !== userId)
+        return false;
+    await deleteById(TABLE, commentId);
+    return true;
+}
+/**
+ * Retrieves paginated replies to a comment, ordered by creation date ascending.
+ *
+ * @param commentId - The parent comment ID.
+ * @param options - Pagination options.
+ * @returns A paginated result of reply comments.
+ */
+export async function getReplies(commentId, options = {}) {
+    const limit = options.limit ?? 20;
+    const offset = options.offset ?? 0;
+    const where = [{ field: 'parentId', operator: '=', value: commentId }];
+    const [data, total] = await Promise.all([
+        findMany(TABLE, {
+            where,
+            orderBy: [{ field: 'createdAt', direction: 'asc' }],
+            limit,
+            offset,
+        }),
+        count(TABLE, where),
+    ]);
+    return { data, total, limit, offset };
+}
+/**
+ * Returns the total number of comments on a resource (including replies).
+ *
+ * @param resourceType - The type of resource.
+ * @param resourceId - The ID of the resource.
+ * @returns The total comment count.
+ */
+export async function getCommentCount(resourceType, resourceId) {
+    return count(TABLE, [
+        { field: 'resourceType', operator: '=', value: resourceType },
+        { field: 'resourceId', operator: '=', value: resourceId },
+    ]);
+}

package/dist/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Comment resource type definitions.
+ *
+ * Polymorphic comments that can attach to any resource type via
+ * `resourceType` and `resourceId`. Supports threaded replies via `parentId`.
+ *
+ * @module
+ */
+/**
+ * A comment attached to a resource, with optional threading via `parentId`.
+ */
+export interface Comment {
+    /** Unique comment identifier. */
+    id: string;
+    /** The type of resource this comment is attached to (e.g. 'project', 'post'). */
+    resourceType: string;
+    /** The ID of the resource this comment is attached to. */
+    resourceId: string;
+    /** The ID of the user who created this comment. */
+    userId: string;
+    /** The parent comment ID for threaded replies, or `null` for top-level comments. */
+    parentId: string | null;
+    /** The comment body text. */
+    body: string;
+    /** When the comment was last edited, or `null` if never edited. */
+    editedAt: string | null;
+    /** When the comment was created (ISO 8601). */
+    createdAt: string;
+    /** When the comment was last updated (ISO 8601). */
+    updatedAt: string;
+}
+/**
+ * Input for creating a new comment.
+ */
+export interface CreateCommentInput {
+    /** The comment body text. */
+    body: string;
+    /** Optional parent comment ID for threaded replies. */
+    parentId?: string;
+}
+/**
+ * Input for updating an existing comment.
+ */
+export interface UpdateCommentInput {
+    /** The updated comment body text. */
+    body: string;
+}
+/**
+ * Options for paginated queries.
+ */
+export interface PaginationOptions {
+    /** Maximum number of results to return. */
+    limit?: number;
+    /** Number of results to skip. */
+    offset?: number;
+}
+/**
+ * A paginated result set.
+ */
+export interface PaginatedResult<T> {
+    /** The result items for the current page. */
+    data: T[];
+    /** Total number of matching items across all pages. */
+    total: number;
+    /** Maximum number of results per page. */
+    limit: number;
+    /** Number of results skipped. */
+    offset: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAA;IAClB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,oFAAoF;IACpF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,mEAAmE;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,6CAA6C;IAC7C,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;CACf"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Comment resource type definitions.
+ *
+ * Polymorphic comments that can attach to any resource type via
+ * `resourceType` and `resourceId`. Supports threaded replies via `parentId`.
+ *
+ * @module
+ */
+export {};

package/dist/validation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Comment input validation schemas.
+ *
+ * @module
+ */
+import { z } from 'zod';
+/**
+ * Schema for validating comment creation input.
+ */
+export declare const createCommentSchema: z.ZodObject<{
+    body: z.ZodString;
+    parentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for validating comment update input.
+ */
+export declare const updateCommentSchema: z.ZodObject<{
+    body: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;iBAK9B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;iBAG9B,CAAA"}

package/dist/validation.js

@@ -0,0 +1,22 @@
+/**
+ * Comment input validation schemas.
+ *
+ * @module
+ */
+import { z } from 'zod';
+/**
+ * Schema for validating comment creation input.
+ */
+export const createCommentSchema = z.object({
+    /** The comment body text. Must be non-empty and at most 10,000 characters. */
+    body: z.string().min(1).max(10_000),
+    /** Optional parent comment ID for threaded replies. */
+    parentId: z.string().uuid().optional(),
+});
+/**
+ * Schema for validating comment update input.
+ */
+export const updateCommentSchema = z.object({
+    /** The updated comment body text. Must be non-empty and at most 10,000 characters. */
+    body: z.string().min(1).max(10_000),
+});