@dev.smartpricing/message-composer-utils 4.3.1 → 4.3.2-chat.0

package/dist/schemas/dynamic-values.js

@@ -1,6 +1,9 @@
 import { z } from "zod";
+import { MESSAGE_GROUP_PRODUCTS, } from "../types/index.js";
 export const dynamicValuesQuerySchema = z.object({
-    product: z.string({ error: "product query parameter is required" }),
+    product: z.enum(MESSAGE_GROUP_PRODUCTS, {
+        error: "product query parameter is required and must be a Product",
+    }),
     context: z.string().optional(),
     language: z.string().default("en"),
 });

package/dist/schemas/dynamic-values.js.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-values.js","sourceRoot":"","sources":["../../src/schemas/dynamic-values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IACnE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CACjD,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,MAAM,CAAC;IACP,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC,CACH;CACF,CAAC,CACwC,CAAC"}
+{"version":3,"file":"dynamic-values.js","sourceRoot":"","sources":["../../src/schemas/dynamic-values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,EAAE;QACtC,KAAK,EAAE,2DAA2D;KACnE,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CACjD,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,MAAM,CAAC;IACP,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC,CACH;CACF,CAAC,CACwC,CAAC"}

package/dist/schemas/index.js

@@ -1,4 +1,5 @@
 export * from "./common.js";
+export * from "./pagination.js";
 export * from "./ai-integration.js";
 export * from "./brand.js";
 export * from "./dynamic-values.js";

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

package/dist/schemas/message-group.js

@@ -1,21 +1,39 @@
 import { z } from "zod";
-import { MESSAGE_GROUP_CATEGORIES, MESSAGE_GROUP_VISIBILITY, MESSAGE_STATUS, MESSAGE_RENDER_TYPES, } from "../types/index.js";
+import { MESSAGE_GROUP_CATEGORIES, MESSAGE_GROUP_LIST_SORT, MESSAGE_GROUP_LIST_VISIBILITY, MESSAGE_GROUP_PRODUCTS, MESSAGE_GROUP_VISIBILITY, MESSAGE_STATUS, MESSAGE_RENDER_TYPES, SORT_ORDER, } from "../types/index.js";
 import { dbTimestampSchema } from "./common.js";
+import { paginatedResponseSchema, paginationQuerySchema, } from "./pagination.js";
 import { messageResponseSchema } from "./message.js";
-export const listMessageGroupsQuerySchema = z.object({
-    render_type: z.string().optional(),
-    tags: z.union([z.string(), z.array(z.string())]).optional(),
-    tags_mode: z.enum(["and", "or"]).default("and"),
+/**
+ * GET /message-groups: server-side filter, sort and pagination (ADR 0012).
+ * `visibility` other than `public` is admin-only (403 otherwise, enforced by
+ * the route). An empty or whitespace `search` is treated as absent.
+ */
+export const listMessageGroupsQuerySchema = paginationQuerySchema.extend({
+    search: z
+        .string()
+        .trim()
+        .max(200)
+        .optional()
+        .transform((value) => (value === "" ? undefined : value)),
+    category: z.enum(MESSAGE_GROUP_CATEGORIES).optional(),
+    status: z.enum(MESSAGE_STATUS).optional(),
+    product: z.enum(MESSAGE_GROUP_PRODUCTS).optional(),
+    visibility: z.enum(MESSAGE_GROUP_LIST_VISIBILITY).default("public"),
+    render_type: z.enum(MESSAGE_RENDER_TYPES).optional(),
+    sort: z.enum(MESSAGE_GROUP_LIST_SORT).default("updated_at"),
+    order: z.enum(SORT_ORDER).default("desc"),
 });
 export const updateMessageGroupBodySchema = z.object({
     name: z
         .string()
         .refine((name) => name.trim() !== "", "Name is required and cannot be empty"),
+    product: z.enum(MESSAGE_GROUP_PRODUCTS).optional(),
     brand_id: z.string().nullable().optional(),
 });
 export const createMessageGroupBodySchema = z.object({
     name: z.string(),
     category: z.enum(MESSAGE_GROUP_CATEGORIES),
+    product: z.enum(MESSAGE_GROUP_PRODUCTS),
     visibility: z.enum(MESSAGE_GROUP_VISIBILITY).optional(),
     brand_id: z.string().nullable().optional(),
 });
@@ -23,6 +41,7 @@ export const duplicateMessageGroupBodySchema = z
     .object({
     name: z.string().optional(),
     visibility: z.enum(MESSAGE_GROUP_VISIBILITY).optional(),
+    product: z.enum(MESSAGE_GROUP_PRODUCTS).optional(),
     brand_id: z.string().nullable().optional(),
 })
     .optional();
@@ -31,6 +50,7 @@ export const messageGroupResponseSchema = z.object({
     id: z.uuid(),
     name: z.string(),
     category: z.enum(MESSAGE_GROUP_CATEGORIES),
+    product: z.enum(MESSAGE_GROUP_PRODUCTS),
     visibility: z.enum(MESSAGE_GROUP_VISIBILITY).nullable().optional(),
     brand_id: z.string().nullable().optional(),
     organization_id: z.string().nullable().optional(),
@@ -55,7 +75,8 @@ export const messageGroupWithMessageSummaryResponseSchema = messageGroupWithTags
         render_type: z.enum(MESSAGE_RENDER_TYPES),
     })),
 });
-export const messageGroupSummaryListResponseSchema = z.array(messageGroupWithMessageSummaryResponseSchema);
+/** Paginated envelope of list items (ADR 0012). */
+export const messageGroupSummaryListResponseSchema = paginatedResponseSchema(messageGroupWithMessageSummaryResponseSchema);
 export const messageGroupValidationResponseSchema = z.object({
     valid: z.boolean(),
     errors: z.object({

package/dist/schemas/message-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-group.js","sourceRoot":"","sources":["../../src/schemas/message-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAIL,wBAAwB,EACxB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3D,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAC5B,sCAAsC,CACvC;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC;IAC1C,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC7C,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC;KACD,QAAQ,EAA6D,CAAC;AAEzE,yDAAyD;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;IACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC;IAC1C,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE,iBAAiB;CAC9B,CAAkD,CAAC;AAEpD,MAAM,CAAC,MAAM,sCAAsC,GACjD,0BAA0B,CAAC,MAAM,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,kCAAkC,GAC7C,0BAA0B,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAC;AAEL,2EAA2E;AAC3E,MAAM,CAAC,MAAM,4CAA4C,GACvD,kCAAkC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;QACZ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;QAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;KAC1C,CAAC,CACH;CACF,CAA8D,CAAC;AAElE,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CAC1D,4CAA4C,CAC7C,CAAC;AAEF,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC3B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,CACf,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC5B,CAAC,CACH;KACF,CAAC;CACH,CAAC,CAAC"}
+{"version":3,"file":"message-group.js","sourceRoot":"","sources":["../../src/schemas/message-group.ts"],"names":[],"mappings":"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"}

package/dist/schemas/onboarding.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { brandDefaultEmailSettingsSchema, brandDefaultButtonSettingsSchema, brandSocialsSchema, } from "../types/index.js";
+import { MESSAGE_GROUP_PRODUCTS, brandDefaultEmailSettingsSchema, brandDefaultButtonSettingsSchema, brandSocialsSchema, } from "../types/index.js";
 import { messageGroupWithMessagesResponseSchema } from "./message-group.js";
 export const onboardingResponseSchema = z.object({
     messageGroups: z.array(messageGroupWithMessagesResponseSchema),
@@ -15,6 +15,8 @@ export const onboardingBodySchema = z.object({
     userId: z
         .string({ error: "Both organizationId and userId are required" })
         .min(1, "Both organizationId and userId are required"),
+    // Required, no fallback to the sm-product header (ADR 0011)
+    product: z.enum(MESSAGE_GROUP_PRODUCTS),
     tags: z.array(z.string()).optional(),
 });
 export const createDefaultBrandBodySchema = z.object({

package/dist/schemas/onboarding.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/schemas/onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sCAAsC,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,sCAAsC,CAAC;IAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,cAAc,EAAE,CAAC;SACd,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;IACxD,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,cAAc,EAAE,CAAC;SACd,MAAM,CAAC,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;SAC3E,GAAG,CAAC,CAAC,EAAE,wDAAwD,CAAC;IACnE,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;SAC3E,GAAG,CAAC,CAAC,EAAE,wDAAwD,CAAC;IACnE,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;SAC3E,GAAG,CAAC,CAAC,EAAE,wDAAwD,CAAC;IACnE,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;SAC3E,GAAG,CAAC,CAAC,EAAE,wDAAwD,CAAC;IACnE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,oBAAoB,EAAE,+BAA+B,CAAC,QAAQ,EAAE;IAChE,qBAAqB,EAAE,gCAAgC,CAAC,QAAQ,EAAE;IAClE,cAAc,EAAE,kBAAkB;CACnC,CAAC,CAAC"}
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/schemas/onboarding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sCAAsC,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,sCAAsC,CAAC;IAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,cAAc,EAAE,CAAC;SACd,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;IACxD,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;IACxD,4DAA4D;IAC5D,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,cAAc,EAAE,CAAC;SACd,MAAM,CAAC,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;SAC3E,GAAG,CAAC,CAAC,EAAE,wDAAwD,CAAC;IACnE,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;SAC3E,GAAG,CAAC,CAAC,EAAE,wDAAwD,CAAC;IACnE,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;SAC3E,GAAG,CAAC,CAAC,EAAE,wDAAwD,CAAC;IACnE,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;SAC3E,GAAG,CAAC,CAAC,EAAE,wDAAwD,CAAC;IACnE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,oBAAoB,EAAE,+BAA+B,CAAC,QAAQ,EAAE;IAChE,qBAAqB,EAAE,gCAAgC,CAAC,QAAQ,EAAE;IAClE,cAAc,EAAE,kBAAkB;CACnC,CAAC,CAAC"}

package/dist/schemas/pagination.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+export const PAGINATION_DEFAULT_PER_PAGE = 25;
+export const PAGINATION_MAX_PER_PAGE = 100;
+/** Laravel-style offset pagination query params (ADR 0012). */
+export const paginationQuerySchema = z.object({
+    page: z.coerce.number().int().min(1).default(1),
+    per_page: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(PAGINATION_MAX_PER_PAGE)
+        .default(PAGINATION_DEFAULT_PER_PAGE),
+});
+export const paginationLinksSchema = z.object({
+    first: z.string(),
+    last: z.string(),
+    prev: z.string().nullable(),
+    next: z.string().nullable(),
+});
+export const paginationMetaSchema = z.object({
+    current_page: z.number().int(),
+    from: z.number().int().nullable(),
+    last_page: z.number().int(),
+    path: z.string(),
+    per_page: z.number().int(),
+    to: z.number().int().nullable(),
+    total: z.number().int(),
+});
+/**
+ * Laravel API resource-collection envelope around `item`:
+ * `{ data, links: { first, last, prev, next }, meta: { … } }`, no `meta.links`.
+ */
+export function paginatedResponseSchema(item) {
+    return z.object({
+        data: z.array(item),
+        links: paginationLinksSchema,
+        meta: paginationMetaSchema,
+    });
+}
+//# sourceMappingURL=pagination.js.map

package/dist/schemas/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/schemas/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM;SACf,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,uBAAuB,CAAC;SAC5B,OAAO,CAAC,2BAA2B,CAAC;CACxC,CAA+C,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAA+C,CAAC;AAEjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CACxB,CAA8C,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAsB,IAAO;IAClE,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACnB,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,oBAAoB;KAC3B,CAAC,CAAC;AACL,CAAC"}

package/dist/schemas/pagination.test.js

@@ -0,0 +1,82 @@
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { paginationQuerySchema, paginatedResponseSchema, } from "./pagination.js";
+describe("paginationQuerySchema", () => {
+    it("defaults to page 1 and 25 per page", () => {
+        expect(paginationQuerySchema.parse({})).toEqual({ page: 1, per_page: 25 });
+    });
+    it("coerces query-string numbers", () => {
+        expect(paginationQuerySchema.parse({ page: "3", per_page: "50" })).toEqual({
+            page: 3,
+            per_page: 50,
+        });
+    });
+    it("accepts the bounds 1 and 100 for per_page", () => {
+        expect(paginationQuerySchema.parse({ per_page: "1" }).per_page).toBe(1);
+        expect(paginationQuerySchema.parse({ per_page: "100" }).per_page).toBe(100);
+    });
+    it("rejects page 0, per_page 0 and per_page 101", () => {
+        expect(paginationQuerySchema.safeParse({ page: "0" }).success).toBe(false);
+        expect(paginationQuerySchema.safeParse({ per_page: "0" }).success).toBe(false);
+        expect(paginationQuerySchema.safeParse({ per_page: "101" }).success).toBe(false);
+    });
+    it("rejects non-integer values", () => {
+        expect(paginationQuerySchema.safeParse({ page: "1.5" }).success).toBe(false);
+        expect(paginationQuerySchema.safeParse({ page: "abc" }).success).toBe(false);
+    });
+});
+describe("paginatedResponseSchema", () => {
+    const schema = paginatedResponseSchema(z.object({ id: z.string() }));
+    it("accepts the Laravel resource-collection envelope", () => {
+        const envelope = {
+            data: [{ id: "a" }],
+            links: { first: "/x?page=1", last: "/x?page=1", prev: null, next: null },
+            meta: {
+                current_page: 1,
+                from: 1,
+                last_page: 1,
+                path: "/x",
+                per_page: 25,
+                to: 1,
+                total: 1,
+            },
+        };
+        expect(schema.parse(envelope)).toEqual(envelope);
+    });
+    it("allows null from/to on an empty page and has no meta.links", () => {
+        const parsed = schema.parse({
+            data: [],
+            links: { first: "/x?page=1", last: "/x?page=1", prev: null, next: null },
+            meta: {
+                current_page: 1,
+                from: null,
+                last_page: 1,
+                path: "/x",
+                per_page: 25,
+                to: null,
+                total: 0,
+                links: [{ url: null, label: "x", active: false }],
+            },
+        });
+        expect(parsed.meta.from).toBeNull();
+        expect(parsed.meta.to).toBeNull();
+        expect("links" in parsed.meta).toBe(false);
+    });
+    it("validates items with the given schema", () => {
+        const result = schema.safeParse({
+            data: [{ id: 1 }],
+            links: { first: "/x?page=1", last: "/x?page=1", prev: null, next: null },
+            meta: {
+                current_page: 1,
+                from: 1,
+                last_page: 1,
+                path: "/x",
+                per_page: 25,
+                to: 1,
+                total: 1,
+            },
+        });
+        expect(result.success).toBe(false);
+    });
+});
+//# sourceMappingURL=pagination.test.js.map

package/dist/schemas/pagination.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.test.js","sourceRoot":"","sources":["../../src/schemas/pagination.test.ts"],"names":[],"mappings":"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"}

package/dist/types/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/types/app.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,qBAAqB,EAAE,uBAAuB;IAC9C,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,+BAA+B,EAAE,iCAAiC;IAClE,6BAA6B,EAAE,+BAA+B;IAC9D,gCAAgC,EAAE,kCAAkC;IACpE,kCAAkC,EAAE,oCAAoC;IACxE,qBAAqB,EAAE,uBAAuB;IAC9C,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;IAC9C,sBAAsB,EAAE,wBAAwB;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,uBAAuB,EAAE,yBAAyB;IAClD,eAAe,EAAE,iBAAiB;IAClC,0BAA0B,EAAE,4BAA4B;CAChD,CAAC;AAuDX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/types/app.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,qBAAqB,EAAE,uBAAuB;IAC9C,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,+BAA+B,EAAE,iCAAiC;IAClE,6BAA6B,EAAE,+BAA+B;IAC9D,gCAAgC,EAAE,kCAAkC;IACpE,kCAAkC,EAAE,oCAAoC;IACxE,qBAAqB,EAAE,uBAAuB;IAC9C,kBAAkB,EAAE,oBAAoB;IACxC,qBAAqB,EAAE,uBAAuB;IAC9C,sBAAsB,EAAE,wBAAwB;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,uBAAuB,EAAE,yBAAyB;IAClD,eAAe,EAAE,iBAAiB;IAClC,0BAA0B,EAAE,4BAA4B;CAChD,CAAC;AA0DX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC"}

package/dist/types/index.js

@@ -13,4 +13,5 @@ export * from "./submission-job.js";
 export * from "./kafka-events.js";
 export * from "./dynamic-values.js";
 export * from "./brand.js";
+export * from "./pagination.js";
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/types/message.js

@@ -9,6 +9,28 @@ export const MESSAGE_STATUS = [
 ];
 export const MESSAGE_GROUP_CATEGORIES = ["marketing", "utility"];
 export const MESSAGE_GROUP_VISIBILITY = ["public", "internal"];
+/** `visibility` filter of the list route; `internal` and `all` are admin-only. */
+export const MESSAGE_GROUP_LIST_VISIBILITY = [
+    ...MESSAGE_GROUP_VISIBILITY,
+    "all",
+];
+/** Sortable columns of the list route (ADR 0012); aggregates are not sortable. */
+export const MESSAGE_GROUP_LIST_SORT = [
+    "name",
+    "category",
+    "created_at",
+    "updated_at",
+];
+/**
+ * The Smartness application a Message Group is authored for (ADR 0011).
+ * Anything outside this list is not a Product and is rejected on write.
+ */
+export const MESSAGE_GROUP_PRODUCTS = [
+    "connect",
+    "chat",
+    "pms",
+    "pricing",
+];
 /**
  * Brand cascade data schema for preview validation.
  * Subset of BrandFromDb used at compile time.

package/dist/types/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,aAAa,EAAE,UAAU,CAAU,CAAC;AAGzE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,OAAO;IACP,UAAU;IACV,UAAU;CACF,CAAC;AAmDX,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,WAAW,EAAE,SAAS,CAAU,CAAC;AAG1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAU,CAAC;AA8DxE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,sBAAsB,EAAE,+BAA+B;IACvD,uBAAuB,EAAE,gCAAgC;IACzD,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC5C,CAAC;QACF,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvD,CAAC;SACD,WAAW,EAAE;IAChB,KAAK,EAAE,sBAAsB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC"}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,aAAa,EAAE,UAAU,CAAU,CAAC;AAGzE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,OAAO;IACP,UAAU;IACV,UAAU;CACF,CAAC;AAmDX,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,WAAW,EAAE,SAAS,CAAU,CAAC;AAG1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAU,CAAC;AAGxE,kFAAkF;AAClF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,GAAG,wBAAwB;IAC3B,KAAK;CACG,CAAC;AAIX,kFAAkF;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM;IACN,UAAU;IACV,YAAY;IACZ,YAAY;CACJ,CAAC;AAkBX;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS;IACT,MAAM;IACN,KAAK;IACL,SAAS;CACD,CAAC;AA+DX;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,sBAAsB,EAAE,+BAA+B;IACvD,uBAAuB,EAAE,gCAAgC;IACzD,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC5C,CAAC;QACF,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACvD,CAAC;SACD,WAAW,EAAE;IAChB,KAAK,EAAE,sBAAsB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC"}

package/dist/types/pagination.js

@@ -0,0 +1,2 @@
+export const SORT_ORDER = ["asc", "desc"];
+//# sourceMappingURL=pagination.js.map

package/dist/types/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/types/pagination.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev.smartpricing/message-composer-utils",
-  "version": "4.3.1",
+  "version": "4.3.2-chat.0",
   "description": "Shared types and utilities for the message composer",
   "type": "module",
   "exports": {

package/src/schemas/dynamic-values.ts

@@ -1,8 +1,13 @@
 import { z } from "zod";
-import { DynamicValuesResponse } from "../types/index.js";
+import {
+  DynamicValuesResponse,
+  MESSAGE_GROUP_PRODUCTS,
+} from "../types/index.js";
 
 export const dynamicValuesQuerySchema = z.object({
-  product: z.string({ error: "product query parameter is required" }),
+  product: z.enum(MESSAGE_GROUP_PRODUCTS, {
+    error: "product query parameter is required and must be a Product",
+  }),
   context: z.string().optional(),
   language: z.string().default("en"),
 });

package/src/schemas/index.ts

@@ -1,4 +1,5 @@
 export * from "./common.js";
+export * from "./pagination.js";
 export * from "./ai-integration.js";
 export * from "./brand.js";
 export * from "./dynamic-values.js";

package/src/schemas/message-group.ts

@@ -1,21 +1,46 @@
 import { z } from "zod";
 import {
   DuplicateMessageGroupBody,
+  ListMessageGroupsQuery,
   MessageGroupFromDb,
   MessageGroupWithMessageSummary,
   MESSAGE_GROUP_CATEGORIES,
+  MESSAGE_GROUP_LIST_SORT,
+  MESSAGE_GROUP_LIST_VISIBILITY,
+  MESSAGE_GROUP_PRODUCTS,
   MESSAGE_GROUP_VISIBILITY,
   MESSAGE_STATUS,
   MESSAGE_RENDER_TYPES,
+  SORT_ORDER,
 } from "../types/index.js";
 import { dbTimestampSchema } from "./common.js";
+import {
+  paginatedResponseSchema,
+  paginationQuerySchema,
+} from "./pagination.js";
 import { messageResponseSchema } from "./message.js";
 
-export const listMessageGroupsQuerySchema = z.object({
-  render_type: z.string().optional(),
-  tags: z.union([z.string(), z.array(z.string())]).optional(),
-  tags_mode: z.enum(["and", "or"]).default("and"),
-});
+/**
+ * GET /message-groups: server-side filter, sort and pagination (ADR 0012).
+ * `visibility` other than `public` is admin-only (403 otherwise, enforced by
+ * the route). An empty or whitespace `search` is treated as absent.
+ */
+export const listMessageGroupsQuerySchema = paginationQuerySchema.extend({
+  search: z
+    .string()
+    .trim()
+    .max(200)
+    .optional()
+    .transform((value) => (value === "" ? undefined : value)),
+  category: z.enum(MESSAGE_GROUP_CATEGORIES).optional(),
+  status: z.enum(MESSAGE_STATUS).optional(),
+  product: z.enum(MESSAGE_GROUP_PRODUCTS).optional(),
+  visibility: z.enum(MESSAGE_GROUP_LIST_VISIBILITY).default("public"),
+  render_type: z.enum(MESSAGE_RENDER_TYPES).optional(),
+  sort: z.enum(MESSAGE_GROUP_LIST_SORT).default("updated_at"),
+  order: z.enum(SORT_ORDER).default("desc"),
+}) satisfies z.ZodType<ListMessageGroupsQuery, unknown>;
+export type { ListMessageGroupsQuery };
 
 export const updateMessageGroupBodySchema = z.object({
   name: z
@@ -24,12 +49,14 @@ export const updateMessageGroupBodySchema = z.object({
       (name) => name.trim() !== "",
       "Name is required and cannot be empty",
     ),
+  product: z.enum(MESSAGE_GROUP_PRODUCTS).optional(),
   brand_id: z.string().nullable().optional(),
 });
 
 export const createMessageGroupBodySchema = z.object({
   name: z.string(),
   category: z.enum(MESSAGE_GROUP_CATEGORIES),
+  product: z.enum(MESSAGE_GROUP_PRODUCTS),
   visibility: z.enum(MESSAGE_GROUP_VISIBILITY).optional(),
   brand_id: z.string().nullable().optional(),
 });
@@ -38,6 +65,7 @@ export const duplicateMessageGroupBodySchema = z
   .object({
     name: z.string().optional(),
     visibility: z.enum(MESSAGE_GROUP_VISIBILITY).optional(),
+    product: z.enum(MESSAGE_GROUP_PRODUCTS).optional(),
     brand_id: z.string().nullable().optional(),
   })
   .optional() satisfies z.ZodType<DuplicateMessageGroupBody | undefined>;
@@ -47,6 +75,7 @@ export const messageGroupResponseSchema = z.object({
   id: z.uuid(),
   name: z.string(),
   category: z.enum(MESSAGE_GROUP_CATEGORIES),
+  product: z.enum(MESSAGE_GROUP_PRODUCTS),
   visibility: z.enum(MESSAGE_GROUP_VISIBILITY).nullable().optional(),
   brand_id: z.string().nullable().optional(),
   organization_id: z.string().nullable().optional(),
@@ -80,7 +109,8 @@ export const messageGroupWithMessageSummaryResponseSchema =
     ),
   }) satisfies z.ZodType<unknown, MessageGroupWithMessageSummary>;
 
-export const messageGroupSummaryListResponseSchema = z.array(
+/** Paginated envelope of list items (ADR 0012). */
+export const messageGroupSummaryListResponseSchema = paginatedResponseSchema(
   messageGroupWithMessageSummaryResponseSchema,
 );
 

package/src/schemas/onboarding.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import {
+  MESSAGE_GROUP_PRODUCTS,
   brandDefaultEmailSettingsSchema,
   brandDefaultButtonSettingsSchema,
   brandSocialsSchema,
@@ -21,6 +22,8 @@ export const onboardingBodySchema = z.object({
   userId: z
     .string({ error: "Both organizationId and userId are required" })
     .min(1, "Both organizationId and userId are required"),
+  // Required, no fallback to the sm-product header (ADR 0011)
+  product: z.enum(MESSAGE_GROUP_PRODUCTS),
   tags: z.array(z.string()).optional(),
 });
 

package/src/schemas/pagination.test.ts

@@ -0,0 +1,101 @@
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import {
+  paginationQuerySchema,
+  paginatedResponseSchema,
+} from "./pagination.js";
+
+describe("paginationQuerySchema", () => {
+  it("defaults to page 1 and 25 per page", () => {
+    expect(paginationQuerySchema.parse({})).toEqual({ page: 1, per_page: 25 });
+  });
+
+  it("coerces query-string numbers", () => {
+    expect(paginationQuerySchema.parse({ page: "3", per_page: "50" })).toEqual({
+      page: 3,
+      per_page: 50,
+    });
+  });
+
+  it("accepts the bounds 1 and 100 for per_page", () => {
+    expect(paginationQuerySchema.parse({ per_page: "1" }).per_page).toBe(1);
+    expect(paginationQuerySchema.parse({ per_page: "100" }).per_page).toBe(100);
+  });
+
+  it("rejects page 0, per_page 0 and per_page 101", () => {
+    expect(paginationQuerySchema.safeParse({ page: "0" }).success).toBe(false);
+    expect(paginationQuerySchema.safeParse({ per_page: "0" }).success).toBe(
+      false,
+    );
+    expect(paginationQuerySchema.safeParse({ per_page: "101" }).success).toBe(
+      false,
+    );
+  });
+
+  it("rejects non-integer values", () => {
+    expect(paginationQuerySchema.safeParse({ page: "1.5" }).success).toBe(
+      false,
+    );
+    expect(paginationQuerySchema.safeParse({ page: "abc" }).success).toBe(
+      false,
+    );
+  });
+});
+
+describe("paginatedResponseSchema", () => {
+  const schema = paginatedResponseSchema(z.object({ id: z.string() }));
+
+  it("accepts the Laravel resource-collection envelope", () => {
+    const envelope = {
+      data: [{ id: "a" }],
+      links: { first: "/x?page=1", last: "/x?page=1", prev: null, next: null },
+      meta: {
+        current_page: 1,
+        from: 1,
+        last_page: 1,
+        path: "/x",
+        per_page: 25,
+        to: 1,
+        total: 1,
+      },
+    };
+    expect(schema.parse(envelope)).toEqual(envelope);
+  });
+
+  it("allows null from/to on an empty page and has no meta.links", () => {
+    const parsed = schema.parse({
+      data: [],
+      links: { first: "/x?page=1", last: "/x?page=1", prev: null, next: null },
+      meta: {
+        current_page: 1,
+        from: null,
+        last_page: 1,
+        path: "/x",
+        per_page: 25,
+        to: null,
+        total: 0,
+        links: [{ url: null, label: "x", active: false }],
+      },
+    });
+    expect(parsed.meta.from).toBeNull();
+    expect(parsed.meta.to).toBeNull();
+    expect("links" in parsed.meta).toBe(false);
+  });
+
+  it("validates items with the given schema", () => {
+    const result = schema.safeParse({
+      data: [{ id: 1 }],
+      links: { first: "/x?page=1", last: "/x?page=1", prev: null, next: null },
+      meta: {
+        current_page: 1,
+        from: 1,
+        last_page: 1,
+        path: "/x",
+        per_page: 25,
+        to: 1,
+        total: 1,
+      },
+    });
+    expect(result.success).toBe(false);
+  });
+});

package/src/schemas/pagination.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import type {
+  PaginationLinks,
+  PaginationMeta,
+  PaginationQuery,
+} from "../types/index.js";
+
+export const PAGINATION_DEFAULT_PER_PAGE = 25;
+export const PAGINATION_MAX_PER_PAGE = 100;
+
+/** Laravel-style offset pagination query params (ADR 0012). */
+export const paginationQuerySchema = z.object({
+  page: z.coerce.number().int().min(1).default(1),
+  per_page: z.coerce
+    .number()
+    .int()
+    .min(1)
+    .max(PAGINATION_MAX_PER_PAGE)
+    .default(PAGINATION_DEFAULT_PER_PAGE),
+}) satisfies z.ZodType<PaginationQuery, unknown>;
+
+export const paginationLinksSchema = z.object({
+  first: z.string(),
+  last: z.string(),
+  prev: z.string().nullable(),
+  next: z.string().nullable(),
+}) satisfies z.ZodType<unknown, PaginationLinks>;
+
+export const paginationMetaSchema = z.object({
+  current_page: z.number().int(),
+  from: z.number().int().nullable(),
+  last_page: z.number().int(),
+  path: z.string(),
+  per_page: z.number().int(),
+  to: z.number().int().nullable(),
+  total: z.number().int(),
+}) satisfies z.ZodType<unknown, PaginationMeta>;
+
+/**
+ * Laravel API resource-collection envelope around `item`:
+ * `{ data, links: { first, last, prev, next }, meta: { … } }`, no `meta.links`.
+ */
+export function paginatedResponseSchema<T extends z.ZodType>(item: T) {
+  return z.object({
+    data: z.array(item),
+    links: paginationLinksSchema,
+    meta: paginationMetaSchema,
+  });
+}

package/src/types/api/apiMessages.ts

@@ -1,6 +1,7 @@
 import type {
   MessageFromDb,
   MessageGroupFromDb,
+  MessageGroupProduct,
   MessageGroupVisibility,
   MessageStatus,
   RenderType,
@@ -14,6 +15,8 @@ export type MessageGroupWithMessages = MessageGroupFromDb & {
 export interface DuplicateMessageGroupBody {
   name?: string;
   visibility?: MessageGroupVisibility;
+  /** Defaults to the source group's Product. */
+  product?: MessageGroupProduct;
   brand_id?: string | null;
 }
 

package/src/types/app.ts

@@ -1,3 +1,5 @@
+import type { MessageGroupProduct } from "./message.js";
+
 export const errorCodes = {
   INTERNAL_SERVER_ERROR: "INTERNAL_SERVER_ERROR",
   UNAUTHORIZED: "UNAUTHORIZED",
@@ -34,7 +36,8 @@ export interface AppError {
 export interface AppContextConfig {
   /** @deprecated No longer used — auth is cookie-based via platform layer */
   authenticationToken?: string;
-  product?: "connect" | "chat" | "pms" | "pricing" | "browser";
+  /** The Product the host app embeds the composer in (ADR 0011). Required. */
+  product: MessageGroupProduct;
   strategy?: "embed" | "native";
   channels?: Array<"email" | "whatsapp">;
   languages?: string[];
@@ -45,7 +48,9 @@ export interface AppContextConfig {
   default_tags?: string[];
 }
 
-export interface AppContextState extends AppContextConfig {
+export interface AppContextState extends Omit<AppContextConfig, "product"> {
+  /** Undefined when the host gave no Product; surfaced as a validation error. */
+  product?: MessageGroupProduct;
   initializationSource:
     | "query"
     | "postMessage"

package/src/types/index.ts

@@ -13,3 +13,4 @@ export * from "./submission-job.js";
 export * from "./kafka-events.js";
 export * from "./dynamic-values.js";
 export * from "./brand.js";
+export * from "./pagination.js";

package/src/types/kafka-events.ts

@@ -1,10 +1,16 @@
-import type { MessageStatus, MessageGroupCategory } from "./message.js";
+import type {
+  MessageStatus,
+  MessageGroupCategory,
+  MessageGroupProduct,
+} from "./message.js";
 
 export interface KafkaEventBase {
   event_id: string;
   event_type: string;
   timestamp: string;
   message_group_id: string;
+  /** Product of the Message Group the event is about (ADR 0011). */
+  product: MessageGroupProduct;
   organization_id?: string | null;
   user_id: string;
 }

package/src/types/message.ts

@@ -8,6 +8,7 @@ import type {
   ButtonBlockV1,
 } from "./whatsappblocks.v1.js";
 import type { EmailBlock, EmailGlobalSettings } from "./emailblocks.v1.js";
+import type { PaginationQuery, SortOrder } from "./pagination.js";
 import {
   brandDefaultEmailSettingsSchema,
   brandDefaultButtonSettingsSchema,
@@ -79,10 +80,55 @@ export type MessageGroupCategory = (typeof MESSAGE_GROUP_CATEGORIES)[number];
 export const MESSAGE_GROUP_VISIBILITY = ["public", "internal"] as const;
 export type MessageGroupVisibility = (typeof MESSAGE_GROUP_VISIBILITY)[number];
 
+/** `visibility` filter of the list route; `internal` and `all` are admin-only. */
+export const MESSAGE_GROUP_LIST_VISIBILITY = [
+  ...MESSAGE_GROUP_VISIBILITY,
+  "all",
+] as const;
+export type MessageGroupListVisibility =
+  (typeof MESSAGE_GROUP_LIST_VISIBILITY)[number];
+
+/** Sortable columns of the list route (ADR 0012); aggregates are not sortable. */
+export const MESSAGE_GROUP_LIST_SORT = [
+  "name",
+  "category",
+  "created_at",
+  "updated_at",
+] as const;
+export type MessageGroupListSort = (typeof MESSAGE_GROUP_LIST_SORT)[number];
+
+/**
+ * Parsed query of `GET /message-groups` (ADR 0012): what the route handler
+ * receives after defaults. The layer sends any subset of these as query params.
+ */
+export interface ListMessageGroupsQuery extends PaginationQuery {
+  search?: string;
+  category?: MessageGroupCategory;
+  status?: MessageStatus;
+  product?: MessageGroupProduct;
+  visibility: MessageGroupListVisibility;
+  render_type?: RenderType;
+  sort: MessageGroupListSort;
+  order: SortOrder;
+}
+
+/**
+ * The Smartness application a Message Group is authored for (ADR 0011).
+ * Anything outside this list is not a Product and is rejected on write.
+ */
+export const MESSAGE_GROUP_PRODUCTS = [
+  "connect",
+  "chat",
+  "pms",
+  "pricing",
+] as const;
+export type MessageGroupProduct = (typeof MESSAGE_GROUP_PRODUCTS)[number];
+
 export interface MessageGroup extends DbEntity {
   id: string;
   name: string;
   category: MessageGroupCategory;
+  product: MessageGroupProduct;
   visibility?: MessageGroupVisibility | null;
   brand_id?: string | null;
   organization_id?: string | null;

package/src/types/pagination.ts

@@ -0,0 +1,36 @@
+/**
+ * Laravel API resource-collection envelope for paginated lists (ADR 0012).
+ * Links are relative (path + query, no host); `meta.links` is omitted.
+ */
+export interface PaginationLinks {
+  first: string;
+  last: string;
+  prev: string | null;
+  next: string | null;
+}
+
+export interface PaginationMeta {
+  current_page: number;
+  /** 1-based index of the first item on this page; null on an empty page. */
+  from: number | null;
+  last_page: number;
+  path: string;
+  per_page: number;
+  /** 1-based index of the last item on this page; null on an empty page. */
+  to: number | null;
+  total: number;
+}
+
+export interface PaginatedResponse<T> {
+  data: T[];
+  links: PaginationLinks;
+  meta: PaginationMeta;
+}
+
+export interface PaginationQuery {
+  page: number;
+  per_page: number;
+}
+
+export const SORT_ORDER = ["asc", "desc"] as const;
+export type SortOrder = (typeof SORT_ORDER)[number];