@lokalise/chatter-api-contracts 0.0.0-stage → 0.0.0

package/dist/api/contracts/comments/post-comment.d.ts

@@ -0,0 +1,178 @@
+import z from 'zod/v4';
+declare const POST_COMMENT_PATH_PARAMS_SCHEMA: z.ZodObject<{
+    teamId: z.ZodUUID;
+}, z.core.$strip>;
+export type PostCommentPathParams = z.infer<typeof POST_COMMENT_PATH_PARAMS_SCHEMA>;
+declare const POST_COMMENT_REQUEST_BODY_SCHEMA: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    entityType: z.ZodLiteral<"SEGMENT">;
+    entityId: z.ZodUUID;
+    projectId: z.ZodUUID;
+    message: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"paragraph">;
+            content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"userMention">;
+                userId: z.ZodUUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"link">;
+                href: z.ZodURL;
+                text: z.ZodString;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "entityType">;
+export type PostCommentRequestBody = z.infer<typeof POST_COMMENT_REQUEST_BODY_SCHEMA>;
+declare const POST_COMMENT_RESPONSE_BODY_SCHEMA: z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodUUID;
+        teamId: z.ZodUUID;
+        projectId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        entityType: z.ZodEnum<{
+            readonly SEGMENT: 'SEGMENT';
+        }>;
+        entityId: z.ZodUUID;
+        status: z.ZodEnum<{
+            readonly OPEN: 'OPEN';
+            readonly RESOLVED: 'RESOLVED';
+        }>;
+        message: z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"paragraph">;
+                content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"userMention">;
+                    userId: z.ZodUUID;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"link">;
+                    href: z.ZodURL;
+                    text: z.ZodString;
+                }, z.core.$strip>], "type">>;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>;
+        messageUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        resolvedBy: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        resolvedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        replyCount: z.ZodInt;
+        lastActivityAt: z.ZodISODateTime;
+        lastReadAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        subscribed: z.ZodBoolean;
+        createdBy: z.ZodUUID;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type PostCommentResponseBody = z.infer<typeof POST_COMMENT_RESPONSE_BODY_SCHEMA>;
+export declare const postCommentContract: Omit<{
+    readonly method: "post";
+    readonly visibility: "internal";
+    readonly summary: "Create a comment";
+    readonly description: "Creates a comment on an entity, starting a new thread. The requesting user is its author.";
+    readonly tags: readonly ["Comments"];
+    readonly requestHeaderSchema: z.ZodObject<{
+        authorization: z.ZodString;
+    }, z.core.$strip>;
+    readonly requestPathParamsSchema: z.ZodObject<{
+        teamId: z.ZodUUID;
+    }, z.core.$strip>;
+    readonly requestBodySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        entityType: z.ZodLiteral<"SEGMENT">;
+        entityId: z.ZodUUID;
+        projectId: z.ZodUUID;
+        message: z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"paragraph">;
+                content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"userMention">;
+                    userId: z.ZodUUID;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"link">;
+                    href: z.ZodURL;
+                    text: z.ZodString;
+                }, z.core.$strip>], "type">>;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "entityType">;
+    readonly pathResolver: ({ teamId }: {
+        teamId: string;
+    }) => `/v1/teams/${string}/comments`;
+    readonly responsesByStatusCode: {
+        201: z.ZodObject<{
+            data: z.ZodObject<{
+                id: z.ZodUUID;
+                teamId: z.ZodUUID;
+                projectId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+                entityType: z.ZodEnum<{
+                    readonly SEGMENT: 'SEGMENT';
+                }>;
+                entityId: z.ZodUUID;
+                status: z.ZodEnum<{
+                    readonly OPEN: 'OPEN';
+                    readonly RESOLVED: 'RESOLVED';
+                }>;
+                message: z.ZodObject<{
+                    version: z.ZodLiteral<1>;
+                    blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"paragraph">;
+                        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"text">;
+                            text: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"userMention">;
+                            userId: z.ZodUUID;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"link">;
+                            href: z.ZodURL;
+                            text: z.ZodString;
+                        }, z.core.$strip>], "type">>;
+                    }, z.core.$strip>], "type">>;
+                }, z.core.$strip>;
+                messageUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+                resolvedBy: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+                resolvedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+                replyCount: z.ZodInt;
+                lastActivityAt: z.ZodISODateTime;
+                lastReadAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+                subscribed: z.ZodBoolean;
+                createdBy: z.ZodUUID;
+                createdAt: z.ZodISODateTime;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        400: z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodString;
+            errorCode: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+        401: z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodString;
+            errorCode: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+        403: z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodString;
+            errorCode: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+        500: z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodString;
+            errorCode: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+    };
+}, "visibility"> & {
+    visibility: import("@lokalise/api-contracts").RouteVisibility;
+};
+export {};

package/dist/api/contracts/comments/post-comment.js

@@ -0,0 +1,47 @@
+import { defineApiContract } from '@lokalise/api-contracts';
+import z from 'zod/v4';
+import { COMMENT_SCHEMA, CommentEntityTypeEnum } from '../../objects/comment.js';
+import { MESSAGE_SCHEMA } from '../../objects/message.js';
+import { OpenApiTags } from '../../open-api-tags.js';
+import { AUTH_HEADERS, ERROR_RESPONSE_SCHEMA } from '../common.js';
+// ------------------------------------------------------------
+// POST /v1/teams/:teamId/comments
+// ------------------------------------------------------------
+const POST_COMMENT_PATH_PARAMS_SCHEMA = z.compile(z.object({
+    teamId: z.uuid().describe('Id of the team'),
+}));
+// One option per entity type, as each type decides which fields it requires
+const POST_COMMENT_REQUEST_BODY_SCHEMA = z.compile(z.discriminatedUnion('entityType', [
+    z
+        .object({
+        entityType: z
+            .literal(CommentEntityTypeEnum.SEGMENT)
+            .describe('Type of the commented entity'),
+        entityId: z.uuid().describe('Id of the commented entity'),
+        projectId: z.uuid().describe('Id of the project of the commented entity'),
+        message: MESSAGE_SCHEMA,
+    })
+        .describe('Comment on an entity'),
+]));
+const POST_COMMENT_RESPONSE_BODY_SCHEMA = z.compile(z.object({
+    data: COMMENT_SCHEMA,
+}));
+export const postCommentContract = defineApiContract({
+    method: 'post',
+    visibility: 'internal',
+    summary: 'Create a comment',
+    description: 'Creates a comment on an entity, starting a new thread. The requesting user is its author.',
+    tags: [OpenApiTags.Comments.name],
+    requestHeaderSchema: AUTH_HEADERS,
+    requestPathParamsSchema: POST_COMMENT_PATH_PARAMS_SCHEMA,
+    requestBodySchema: POST_COMMENT_REQUEST_BODY_SCHEMA,
+    pathResolver: ({ teamId }) => `/v1/teams/${teamId}/comments`,
+    responsesByStatusCode: {
+        201: POST_COMMENT_RESPONSE_BODY_SCHEMA,
+        400: ERROR_RESPONSE_SCHEMA,
+        401: ERROR_RESPONSE_SCHEMA,
+        403: ERROR_RESPONSE_SCHEMA,
+        500: ERROR_RESPONSE_SCHEMA,
+    },
+});
+//# sourceMappingURL=post-comment.js.map

package/dist/api/contracts/comments/post-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-comment.js","sourceRoot":"","sources":["../../../../src/api/contracts/comments/post-comment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,CAAC,MAAM,QAAQ,CAAA;AACtB,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAElE,+DAA+D;AAC/D,kCAAkC;AAClC,+DAA+D;AAC/D,MAAM,+BAA+B,GAAG,CAAC,CAAC,OAAO,CAC/C,CAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CAC5C,CAAC,CACH,CAAA;AAGD,4EAA4E;AAC5E,MAAM,gCAAgC,GAAG,CAAC,CAAC,OAAO,CAChD,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE;IACjC,CAAC;SACE,MAAM,CAAC;QACN,UAAU,EAAE,CAAC;aACV,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC;aACtC,QAAQ,CAAC,8BAA8B,CAAC;QAC3C,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACzD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACzE,OAAO,EAAE,cAAc;KACxB,CAAC;SACD,QAAQ,CAAC,sBAAsB,CAAC;CACpC,CAAC,CACH,CAAA;AAGD,MAAM,iCAAiC,GAAG,CAAC,CAAC,OAAO,CACjD,CAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,cAAc;CACrB,CAAC,CACH,CAAA;AAGD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;IACnD,MAAM,EAAE,MAAM;IACd,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,kBAAkB;IAC3B,WAAW,EACT,2FAA2F;IAC7F,IAAI,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC;IACjC,mBAAmB,EAAE,YAAY;IACjC,uBAAuB,EAAE,+BAA+B;IACxD,iBAAiB,EAAE,gCAAgC;IACnD,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,aAAa,MAAM,WAAW;IAC5D,qBAAqB,EAAE;QACrB,GAAG,EAAE,iCAAiC;QACtC,GAAG,EAAE,qBAAqB;QAC1B,GAAG,EAAE,qBAAqB;QAC1B,GAAG,EAAE,qBAAqB;QAC1B,GAAG,EAAE,qBAAqB;KAC3B;CACF,CAAC,CAAA"}

package/dist/api/contracts/comments/post-comments-actions-search.d.ts

@@ -0,0 +1,167 @@
+import z from 'zod/v4';
+declare const POST_SEARCH_COMMENTS_PATH_PARAMS_SCHEMA: z.ZodObject<{
+    teamId: z.ZodUUID;
+}, z.core.$strip>;
+export type PostSearchCommentsPathParams = z.infer<typeof POST_SEARCH_COMMENTS_PATH_PARAMS_SCHEMA>;
+export declare const POST_SEARCH_COMMENTS_QUERY_SCHEMA: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    after: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PostSearchCommentsQuery = z.infer<typeof POST_SEARCH_COMMENTS_QUERY_SCHEMA>;
+declare const POST_SEARCH_COMMENTS_REQUEST_BODY_SCHEMA: z.ZodObject<{
+    entityTypes: z.ZodArray<z.ZodEnum<{
+        readonly SEGMENT: 'SEGMENT';
+    }>>;
+    entityIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    projectIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+}, z.core.$strip>;
+export type PostSearchCommentsRequestBody = z.infer<typeof POST_SEARCH_COMMENTS_REQUEST_BODY_SCHEMA>;
+declare const POST_SEARCH_COMMENTS_RESPONSE_BODY_SCHEMA: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        teamId: z.ZodUUID;
+        projectId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        entityType: z.ZodEnum<{
+            readonly SEGMENT: 'SEGMENT';
+        }>;
+        entityId: z.ZodUUID;
+        status: z.ZodEnum<{
+            readonly OPEN: 'OPEN';
+            readonly RESOLVED: 'RESOLVED';
+        }>;
+        message: z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"paragraph">;
+                content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"userMention">;
+                    userId: z.ZodUUID;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"link">;
+                    href: z.ZodURL;
+                    text: z.ZodString;
+                }, z.core.$strip>], "type">>;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>;
+        messageUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        resolvedBy: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+        resolvedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        replyCount: z.ZodInt;
+        lastActivityAt: z.ZodISODateTime;
+        lastReadAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        subscribed: z.ZodBoolean;
+        createdBy: z.ZodUUID;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    meta: z.ZodObject<{
+        count: z.ZodNumber;
+        cursor: z.ZodOptional<z.ZodString>;
+        hasMore: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type PostSearchCommentsResponseBody = z.infer<typeof POST_SEARCH_COMMENTS_RESPONSE_BODY_SCHEMA>;
+export declare const postSearchCommentsContract: Omit<{
+    readonly method: "post";
+    readonly visibility: "internal";
+    readonly summary: "Search comments";
+    readonly description: string;
+    readonly tags: readonly ["Comments"];
+    readonly requestHeaderSchema: z.ZodObject<{
+        authorization: z.ZodString;
+    }, z.core.$strip>;
+    readonly requestPathParamsSchema: z.ZodObject<{
+        teamId: z.ZodUUID;
+    }, z.core.$strip>;
+    readonly requestQuerySchema: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        after: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly requestBodySchema: z.ZodObject<{
+        entityTypes: z.ZodArray<z.ZodEnum<{
+            readonly SEGMENT: 'SEGMENT';
+        }>>;
+        entityIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+        projectIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    }, z.core.$strip>;
+    readonly pathResolver: ({ teamId }: {
+        teamId: string;
+    }) => `/v1/teams/${string}/comments/actions/search`;
+    readonly responsesByStatusCode: {
+        200: z.ZodObject<{
+            data: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                teamId: z.ZodUUID;
+                projectId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+                entityType: z.ZodEnum<{
+                    readonly SEGMENT: 'SEGMENT';
+                }>;
+                entityId: z.ZodUUID;
+                status: z.ZodEnum<{
+                    readonly OPEN: 'OPEN';
+                    readonly RESOLVED: 'RESOLVED';
+                }>;
+                message: z.ZodObject<{
+                    version: z.ZodLiteral<1>;
+                    blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"paragraph">;
+                        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"text">;
+                            text: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"userMention">;
+                            userId: z.ZodUUID;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"link">;
+                            href: z.ZodURL;
+                            text: z.ZodString;
+                        }, z.core.$strip>], "type">>;
+                    }, z.core.$strip>], "type">>;
+                }, z.core.$strip>;
+                messageUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+                resolvedBy: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+                resolvedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+                replyCount: z.ZodInt;
+                lastActivityAt: z.ZodISODateTime;
+                lastReadAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+                subscribed: z.ZodBoolean;
+                createdBy: z.ZodUUID;
+                createdAt: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            meta: z.ZodObject<{
+                count: z.ZodNumber;
+                cursor: z.ZodOptional<z.ZodString>;
+                hasMore: z.ZodBoolean;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        400: z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodString;
+            errorCode: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+        401: z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodString;
+            errorCode: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+        403: z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodString;
+            errorCode: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+        500: z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodString;
+            errorCode: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+    };
+}, "visibility"> & {
+    visibility: import("@lokalise/api-contracts").RouteVisibility;
+};
+export {};

package/dist/api/contracts/comments/post-comments-actions-search.js

@@ -0,0 +1,69 @@
+import { paginatedResponseSchema } from '@lokalise/api-common';
+import { defineApiContract } from '@lokalise/api-contracts';
+import z from 'zod/v4';
+import { COMMENT_SCHEMA, CommentEntityTypeEnum } from '../../objects/comment.js';
+import { OpenApiTags } from '../../open-api-tags.js';
+import { AUTH_HEADERS, ERROR_RESPONSE_SCHEMA } from '../common.js';
+// ------------------------------------------------------------
+// POST /v1/teams/:teamId/comments/actions/search
+// ------------------------------------------------------------
+const POST_SEARCH_COMMENTS_PATH_PARAMS_SCHEMA = z.compile(z.object({
+    teamId: z.uuid().describe('Id of the team'),
+}));
+const COMMENTS_DEFAULT_LIMIT = 100;
+const COMMENTS_MAX_LIMIT = 100;
+export const POST_SEARCH_COMMENTS_QUERY_SCHEMA = z.compile(z.object({
+    limit: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(COMMENTS_MAX_LIMIT)
+        .default(COMMENTS_DEFAULT_LIMIT)
+        .describe('Number of comments to return per page'),
+    after: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Opaque cursor from the previous response `meta.cursor`. Omit to read the first page'),
+}));
+const COMMENTS_MAX_FILTER_IDS = 100;
+const POST_SEARCH_COMMENTS_REQUEST_BODY_SCHEMA = z.compile(z.object({
+    entityTypes: z
+        .array(z.enum(CommentEntityTypeEnum))
+        .min(1)
+        .describe('Types of the commented entities'),
+    entityIds: z
+        .array(z.uuid())
+        .min(1)
+        .max(COMMENTS_MAX_FILTER_IDS)
+        .optional()
+        .describe('Ids of the commented entities'),
+    projectIds: z
+        .array(z.uuid())
+        .min(1)
+        .max(COMMENTS_MAX_FILTER_IDS)
+        .optional()
+        .describe('Only comments of these projects'),
+}));
+const POST_SEARCH_COMMENTS_RESPONSE_BODY_SCHEMA = paginatedResponseSchema(COMMENT_SCHEMA);
+export const postSearchCommentsContract = defineApiContract({
+    method: 'post',
+    visibility: 'internal',
+    summary: 'Search comments',
+    description: 'Lists the root comments of the threads on the given entities, oldest first, one page at a time. ' +
+        'Pass `meta.cursor` from a response as `after` to read the next page.',
+    tags: [OpenApiTags.Comments.name],
+    requestHeaderSchema: AUTH_HEADERS,
+    requestPathParamsSchema: POST_SEARCH_COMMENTS_PATH_PARAMS_SCHEMA,
+    requestQuerySchema: POST_SEARCH_COMMENTS_QUERY_SCHEMA,
+    requestBodySchema: POST_SEARCH_COMMENTS_REQUEST_BODY_SCHEMA,
+    pathResolver: ({ teamId }) => `/v1/teams/${teamId}/comments/actions/search`,
+    responsesByStatusCode: {
+        200: POST_SEARCH_COMMENTS_RESPONSE_BODY_SCHEMA,
+        400: ERROR_RESPONSE_SCHEMA,
+        401: ERROR_RESPONSE_SCHEMA,
+        403: ERROR_RESPONSE_SCHEMA,
+        500: ERROR_RESPONSE_SCHEMA,
+    },
+});
+//# sourceMappingURL=post-comments-actions-search.js.map

package/dist/api/contracts/comments/post-comments-actions-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-comments-actions-search.js","sourceRoot":"","sources":["../../../../src/api/contracts/comments/post-comments-actions-search.ts"],"names":[],"mappings":"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"}

package/dist/api/contracts/common.d.ts

@@ -0,0 +1,10 @@
+import z from 'zod/v4';
+export declare const AUTH_HEADERS: z.ZodObject<{
+    authorization: z.ZodString;
+}, z.core.$strip>;
+export declare const ERROR_RESPONSE_SCHEMA: z.ZodObject<{
+    message: z.ZodString;
+    code: z.ZodString;
+    errorCode: z.ZodString;
+    details: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;

package/dist/api/contracts/common.js

@@ -0,0 +1,11 @@
+import z from 'zod/v4';
+export const AUTH_HEADERS = z.compile(z.object({
+    authorization: z.string().describe('Bearer token authorizing the request'),
+}));
+export const ERROR_RESPONSE_SCHEMA = z.compile(z.object({
+    message: z.string().describe('Human-readable error message'),
+    code: z.string().describe('Machine-readable error code'),
+    errorCode: z.string().describe('Machine-readable error code (legacy alias of `code`)'),
+    details: z.unknown().optional().describe('Optional structured error details'),
+}));
+//# sourceMappingURL=common.js.map

package/dist/api/contracts/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/api/contracts/common.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AAEtB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,OAAO,CACnC,CAAC,CAAC,MAAM,CAAC;IACP,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CAC3E,CAAC,CACH,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,OAAO,CAC5C,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACxD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IACtF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CAC9E,CAAC,CACH,CAAA"}

package/dist/api/contracts/hello/get-hello.d.ts

@@ -0,0 +1,30 @@
+import z from 'zod/v4';
+declare const GET_HELLO_RESPONSE_BODY_SCHEMA: z.ZodObject<{
+    message: z.ZodString;
+}, z.core.$strip>;
+export type GetHelloResponseBody = z.infer<typeof GET_HELLO_RESPONSE_BODY_SCHEMA>;
+export declare const getHelloContract: Omit<{
+    readonly method: "get";
+    readonly summary: "Say hello";
+    readonly description: "Returns a greeting. Placeholder endpoint until the first real chatter module lands.";
+    readonly tags: readonly ["Hello"];
+    readonly visibility: "public";
+    readonly requestHeaderSchema: z.ZodObject<{
+        authorization: z.ZodString;
+    }, z.core.$strip>;
+    readonly pathResolver: () => "/hello";
+    readonly responsesByStatusCode: {
+        200: z.ZodObject<{
+            message: z.ZodString;
+        }, z.core.$strip>;
+        500: z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodString;
+            errorCode: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+    };
+}, "visibility"> & {
+    visibility: import("@lokalise/api-contracts").RouteVisibility;
+};
+export {};

package/dist/api/contracts/hello/get-hello.js

@@ -0,0 +1,22 @@
+import { defineApiContract } from '@lokalise/api-contracts';
+import z from 'zod/v4';
+import { OpenApiTags } from '../../open-api-tags.js';
+import { AUTH_HEADERS, ERROR_RESPONSE_SCHEMA } from '../common.js';
+// GET /hello
+const GET_HELLO_RESPONSE_BODY_SCHEMA = z.compile(z.object({
+    message: z.string().describe('Greeting message'),
+}));
+export const getHelloContract = defineApiContract({
+    method: 'get',
+    summary: 'Say hello',
+    description: 'Returns a greeting. Placeholder endpoint until the first real chatter module lands.',
+    tags: [OpenApiTags.Hello.name],
+    visibility: 'public',
+    requestHeaderSchema: AUTH_HEADERS,
+    pathResolver: () => '/hello',
+    responsesByStatusCode: {
+        200: GET_HELLO_RESPONSE_BODY_SCHEMA,
+        500: ERROR_RESPONSE_SCHEMA,
+    },
+});
+//# sourceMappingURL=get-hello.js.map

package/dist/api/contracts/hello/get-hello.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-hello.js","sourceRoot":"","sources":["../../../../src/api/contracts/hello/get-hello.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,CAAC,MAAM,QAAQ,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAElE,aAAa;AACb,MAAM,8BAA8B,GAAG,CAAC,CAAC,OAAO,CAC9C,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CACjD,CAAC,CACH,CAAA;AAGD,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;IAChD,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,WAAW;IACpB,WAAW,EACT,qFAAqF;IACvF,IAAI,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;IAC9B,UAAU,EAAE,QAAQ;IACpB,mBAAmB,EAAE,YAAY;IACjC,YAAY,EAAE,GAAG,EAAE,CAAC,QAAQ;IAC5B,qBAAqB,EAAE;QACrB,GAAG,EAAE,8BAA8B;QACnC,GAAG,EAAE,qBAAqB;KAC3B;CACF,CAAC,CAAA"}

package/dist/api/contracts/index.d.ts

@@ -0,0 +1,10 @@
+export * from './comments/delete-comment.ts';
+export * from './comments/delete-comment-reply.ts';
+export * from './comments/get-comment-replies.ts';
+export * from './comments/get-comments.ts';
+export * from './comments/patch-comment.ts';
+export * from './comments/patch-comment-reply.ts';
+export * from './comments/post-comment.ts';
+export * from './comments/post-comment-reply.ts';
+export * from './comments/post-comments-actions-search.ts';
+export * from './hello/get-hello.ts';

package/dist/api/contracts/index.js

@@ -0,0 +1,11 @@
+export * from './comments/delete-comment.js';
+export * from './comments/delete-comment-reply.js';
+export * from './comments/get-comment-replies.js';
+export * from './comments/get-comments.js';
+export * from './comments/patch-comment.js';
+export * from './comments/patch-comment-reply.js';
+export * from './comments/post-comment.js';
+export * from './comments/post-comment-reply.js';
+export * from './comments/post-comments-actions-search.js';
+export * from './hello/get-hello.js';
+//# sourceMappingURL=index.js.map

package/dist/api/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,mCAAmC,CAAA;AACjD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kCAAkC,CAAA;AAChD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,sBAAsB,CAAA"}

package/dist/api/errors/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/api/errors/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/api/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAA"}

package/dist/api/objects/comment-reply.d.ts

@@ -0,0 +1,26 @@
+import z from 'zod/v4';
+export declare const COMMENT_REPLY_SCHEMA: z.ZodObject<{
+    id: z.ZodUUID;
+    commentId: z.ZodUUID;
+    message: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"paragraph">;
+            content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"userMention">;
+                userId: z.ZodUUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"link">;
+                href: z.ZodURL;
+                text: z.ZodString;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strip>;
+    messageUpdatedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    createdBy: z.ZodUUID;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type CommentReply = z.infer<typeof COMMENT_REPLY_SCHEMA>;

package/dist/api/objects/comment-reply.js

@@ -0,0 +1,16 @@
+import z from 'zod/v4';
+import { MESSAGE_SCHEMA } from './message.js';
+export const COMMENT_REPLY_SCHEMA = z.compile(z
+    .object({
+    id: z.uuid().describe('Id of the reply'),
+    commentId: z.uuid().describe('Id of the thread the reply belongs to'),
+    message: MESSAGE_SCHEMA,
+    messageUpdatedAt: z.iso
+        .datetime()
+        .nullish()
+        .describe('Last edit of the message. `null` if the message was never edited'),
+    createdBy: z.uuid().describe('Id of the author'),
+    createdAt: z.iso.datetime().describe('Creation time'),
+})
+    .describe('Reply in a thread'));
+//# sourceMappingURL=comment-reply.js.map

package/dist/api/objects/comment-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-reply.js","sourceRoot":"","sources":["../../../src/api/objects/comment-reply.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,OAAO,CAC3C,CAAC;KACE,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACrE,OAAO,EAAE,cAAc;IACvB,gBAAgB,EAAE,CAAC,CAAC,GAAG;SACpB,QAAQ,EAAE;SACV,OAAO,EAAE;SACT,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;CACtD,CAAC;KACD,QAAQ,CAAC,mBAAmB,CAAC,CACjC,CAAA"}