@molecule/api-resource-comment 1.1.0 → 1.1.2

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-15T14:22:29.350Z
+Generated: 2026-10-16T00:32:13.746Z
 -->
 
 # @molecule/api-resource-comment
@@ -86,20 +86,14 @@ interface CreateCommentInput {
 }
 ```
 
-#### `PaginatedResult`
+#### `UpdateCommentInput`
 
-A paginated result set.
+Input for updating an existing comment.
 
 ```typescript
-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
+interface UpdateCommentInput {
+  /** The updated comment body text. */
+  body: string
 }
 ```
 
@@ -116,14 +110,20 @@ interface PaginationOptions {
 }
 ```
 
-#### `UpdateCommentInput`
+#### `PaginatedResult`
 
-Input for updating an existing comment.
+A paginated result set.
 
 ```typescript
-interface UpdateCommentInput {
-  /** The updated comment body text. */
-  body: string
+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
 }
 ```
 
@@ -153,105 +153,104 @@ function commentCount(req: MoleculeRequest, res: MoleculeResponse): Promise<void
 - `req` — The request with `resourceType` and `resourceId` params.
 - `res` — The response object.
 
-#### `commentNumbers(commentIds)`
+#### `create(req, res)`
 
-The numbers of the given comments, for listing them with their numbers.
-Comments without a number are left out of the map.
+Creates a new comment on a resource.
 
 ```typescript
-function commentNumbers(commentIds: readonly string[]): Promise<Map<string, number>>
+function create(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
 ```
 
-- `commentIds` — The comments' UUIDs.
-
-**Returns:** Each numbered comment's UUID mapped to its number.
+- `req` — The request with `resourceType` and `resourceId` params and comment body.
+- `res` — The response object.
 
-#### `create(req, res)`
+#### `del(req, res)`
 
-Creates a new comment on a resource.
+Deletes a comment. Only the comment owner can delete.
 
 ```typescript
-function create(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
+function del(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
 ```
 
-- `req` — The request with `resourceType` and `resourceId` params and comment body.
+- `req` — The request with `commentId` param.
 - `res` — The response object.
 
-#### `createComment(resourceType, resourceId, userId, data)`
+#### `list(req, res)`
 
-Creates a new comment on a resource.
+Lists paginated top-level comments for a resource.
 
 ```typescript
-function createComment(
-  resourceType: string,
-  resourceId: string,
-  userId: string,
-  data: CreateCommentInput,
-): Promise<Comment>
+function list(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
 ```
 
-- `resourceType` — The type of resource being commented on.
-- `resourceId` — The ID of the resource being commented on.
-- `userId` — The ID of the commenting user.
-- `data` — The comment creation input.
-
-**Returns:** The created comment.
+- `req` — The request with `resourceType` and `resourceId` params.
+- `res` — The response object.
 
-#### `createNumberedComment(resourceType, resourceId, userId, data)`
+#### `read(req, res)`
 
-Creates a comment and its number together: both are written, or neither.
+Retrieves a single comment by ID.
 
 ```typescript
-function createNumberedComment(
-  resourceType: string,
-  resourceId: string,
-  userId: string,
-  data: CreateCommentInput,
-): Promise<NumberedComment>
+function read(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
 ```
 
-- `resourceType` — The type of resource being commented on.
-- `resourceId` — The ID of the resource being commented on.
-- `userId` — The ID of the commenting user.
-- `data` — The comment creation input.
-
-**Returns:** The created comment with its number.
+- `req` — The request with `commentId` param.
+- `res` — The response object.
 
-#### `del(req, res)`
+#### `replies(req, res)`
 
-Deletes a comment. Only the comment owner can delete.
+Lists paginated replies to a comment.
 
 ```typescript
-function del(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
+function replies(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
 ```
 
 - `req` — The request with `commentId` param.
 - `res` — The response object.
 
-#### `deleteComment(commentId, userId)`
+#### `update(req, res)`
 
-Deletes a comment. Only the comment owner can delete.
+Updates an existing comment. Only the comment owner can update.
 
 ```typescript
-function deleteComment(commentId: string, userId: string): Promise<boolean>
+function update(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
 ```
 
-- `commentId` — The comment ID to delete.
-- `userId` — The requesting user's ID (must match comment owner).
+- `req` — The request with `commentId` param and update body.
+- `res` — The response object.
 
-**Returns:** `true` if deleted, `false` if not found or unauthorized.
+#### `numberComment(commentId)`
 
-#### `getCommentById(commentId)`
+The comment's number, allocating the next one when it has none. Numbers are
+unique and increase.
 
-Retrieves a single comment by ID.
+```typescript
+function numberComment(commentId: string): Promise<number>
+```
+
+- `commentId` — The comment's UUID.
+
+**Returns:** Its sequential number.
+
+#### `createNumberedComment(resourceType, resourceId, userId, data)`
+
+Creates a comment and its number together: both are written, or neither.
 
 ```typescript
-function getCommentById(commentId: string): Promise<Comment | null>
+function createNumberedComment(
+  resourceType: string,
+  resourceId: string,
+  userId: string,
+  data: CreateCommentInput,
+): Promise<NumberedComment>
 ```
 
-- `commentId` — The comment ID to look up.
+- `resourceType` — The type of resource being commented on.
+- `resourceId` — The ID of the resource being commented on.
+- `userId` — The ID of the commenting user.
+- `data` — The comment creation input.
 
-**Returns:** The comment or `null` if not found.
+**Returns:** The created comment with its number.
 
 #### `getCommentByNumber(number)`
 
@@ -265,18 +264,38 @@ function getCommentByNumber(number: number): Promise<NumberedComment | null>
 
 **Returns:** The comment with its number, or `null` when no comment has it.
 
-#### `getCommentCount(resourceType, resourceId)`
+#### `commentNumbers(commentIds)`
 
-Returns the total number of comments on a resource (including replies).
+The numbers of the given comments, for listing them with their numbers.
+Comments without a number are left out of the map.
 
 ```typescript
-function getCommentCount(resourceType: string, resourceId: string): Promise<number>
+function commentNumbers(commentIds: readonly string[]): Promise<Map<string, number>>
 ```
 
-- `resourceType` — The type of resource.
-- `resourceId` — The ID of the resource.
+- `commentIds` — The comments' UUIDs.
 
-**Returns:** The total comment count.
+**Returns:** Each numbered comment's UUID mapped to its number.
+
+#### `createComment(resourceType, resourceId, userId, data)`
+
+Creates a new comment on a resource.
+
+```typescript
+function createComment(
+  resourceType: string,
+  resourceId: string,
+  userId: string,
+  data: CreateCommentInput,
+): Promise<Comment>
+```
+
+- `resourceType` — The type of resource being commented on.
+- `resourceId` — The ID of the resource being commented on.
+- `userId` — The ID of the commenting user.
+- `data` — The comment creation input.
+
+**Returns:** The created comment.
 
 #### `getCommentsByResource(resourceType, resourceId, options)`
 
@@ -297,110 +316,80 @@ function getCommentsByResource(
 
 **Returns:** A paginated result of comments.
 
-#### `getReplies(commentId, options)`
+#### `getCommentById(commentId)`
 
-Retrieves paginated replies to a comment, ordered by creation date ascending.
+Retrieves a single comment by ID.
 
 ```typescript
-function getReplies(
-  commentId: string,
-  options?: PaginationOptions,
-): Promise<PaginatedResult<Comment>>
+function getCommentById(commentId: string): Promise<Comment | null>
 ```
 
-- `commentId` — The parent comment ID.
-- `options` — Pagination options.
-
-**Returns:** A paginated result of reply comments.
-
-#### `list(req, res)`
-
-Lists paginated top-level comments for a resource.
-
-```typescript
-function list(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
-```
+- `commentId` — The comment ID to look up.
 
-- `req` — The request with `resourceType` and `resourceId` params.
-- `res` — The response object.
+**Returns:** The comment or `null` if not found.
 
-#### `numberComment(commentId)`
+#### `updateComment(commentId, userId, data)`
 
-The comment's number, allocating the next one when it has none. Numbers are
-unique and increase.
+Updates a comment. Only the comment owner can update.
 
 ```typescript
-function numberComment(commentId: string): Promise<number>
+function updateComment(
+  commentId: string,
+  userId: string,
+  data: UpdateCommentInput,
+): Promise<Comment | null>
 ```
 
-- `commentId` — The comment's UUID.
+- `commentId` — The comment ID to update.
+- `userId` — The requesting user's ID (must match comment owner).
+- `data` — The update input.
 
-**Returns:** Its sequential number.
+**Returns:** The updated comment or `null` if not found or unauthorized.
 
-#### `read(req, res)`
+#### `deleteComment(commentId, userId)`
 
-Retrieves a single comment by ID.
+Deletes a comment. Only the comment owner can delete.
 
 ```typescript
-function read(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
+function deleteComment(commentId: string, userId: string): Promise<boolean>
 ```
 
-- `req` — The request with `commentId` param.
-- `res` — The response object.
-
-#### `replies(req, res)`
-
-Lists paginated replies to a comment.
-
-```typescript
-function replies(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
-```
+- `commentId` — The comment ID to delete.
+- `userId` — The requesting user's ID (must match comment owner).
 
-- `req` — The request with `commentId` param.
-- `res` — The response object.
+**Returns:** `true` if deleted, `false` if not found or unauthorized.
 
-#### `update(req, res)`
+#### `getReplies(commentId, options)`
 
-Updates an existing comment. Only the comment owner can update.
+Retrieves paginated replies to a comment, ordered by creation date ascending.
 
 ```typescript
-function update(req: MoleculeRequest, res: MoleculeResponse): Promise<void>
+function getReplies(
+  commentId: string,
+  options?: PaginationOptions,
+): Promise<PaginatedResult<Comment>>
 ```
 
-- `req` — The request with `commentId` param and update body.
-- `res` — The response object.
+- `commentId` — The parent comment ID.
+- `options` — Pagination options.
 
-#### `updateComment(commentId, userId, data)`
+**Returns:** A paginated result of reply comments.
 
-Updates a comment. Only the comment owner can update.
+#### `getCommentCount(resourceType, resourceId)`
+
+Returns the total number of comments on a resource (including replies).
 
 ```typescript
-function updateComment(
-  commentId: string,
-  userId: string,
-  data: UpdateCommentInput,
-): Promise<Comment | null>
+function getCommentCount(resourceType: string, resourceId: string): Promise<number>
 ```
 
-- `commentId` — The comment ID to update.
-- `userId` — The requesting user's ID (must match comment owner).
-- `data` — The update input.
+- `resourceType` — The type of resource.
+- `resourceId` — The ID of the resource.
 
-**Returns:** The updated comment or `null` if not found or unauthorized.
+**Returns:** The total comment count.
 
 ### Constants
 
-#### `createCommentSchema`
-
-Schema for validating comment creation input.
-
-```typescript
-const createCommentSchema: z.ZodObject<
-  { body: z.ZodString; parentId: z.ZodOptional<z.ZodString> },
-  z.core.$strip
->
-```
-
 #### `requestHandlerMap`
 
 Handler map for comment routes.
@@ -460,6 +449,17 @@ const routes: readonly [
 ]
 ```
 
+#### `createCommentSchema`
+
+Schema for validating comment creation input.
+
+```typescript
+const createCommentSchema: z.ZodObject<
+  { body: z.ZodString; parentId: z.ZodOptional<z.ZodString> },
+  z.core.$strip
+>
+```
+
 #### `updateCommentSchema`
 
 Schema for validating comment update input.

package/dist/service.d.ts.map

@@ -1 +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"}
+{"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,CAczB;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

@@ -80,7 +80,9 @@ export async function updateComment(commentId, userId, data) {
     const result = await updateById(TABLE, commentId, {
         body: data.body,
         editedAt: new Date().toISOString(),
-        updatedAt: new Date().toISOString(),
+        // Strictly later than the last write: an edit in the same millisecond as the create
+        // still shows a changed updatedAt.
+        updatedAt: new Date(Math.max(Date.now(), (Date.parse(String(existing.updatedAt ?? '')) || 0) + 1)).toISOString(),
     });
     return result.data;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-resource-comment",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Threaded comments on any resource with polymorphic attachment and pagination",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
   ],
   "license": "Apache-2.0",
   "devDependencies": {
-    "@molecule/api-database": "1.1.0",
-    "@molecule/api-database-sqlite": "1.1.0",
+    "@molecule/api-database": "1.1.1",
+    "@molecule/api-database-sqlite": "1.2.2",
     "@types/node": "26.1.2",
     "typescript": "6.0.3",
     "vitest": "4.1.11",