@mgsoftwarebv/mcp-server-bridge 3.5.1 → 3.5.3

package/dist/index.js

@@ -97301,6 +97301,21 @@ var invoiceProducts = pgTable(
     // Array of ProductOptionGroup (see @refront/invoice/types). Null/empty for
     // plain catalog products.
     options: jsonb().$type(),
+    // Structured catalog metadata for richer package/quote composition. All
+    // nullable/defaulted so existing products keep working. Validated at the
+    // app/MCP layer (see @refront/invoice/types constants).
+    // "one_time" | "monthly" | "yearly"
+    billingType: text("billing_type"),
+    // "website" | "addon" | "hosting" | "support" | "other"
+    category: text(),
+    // List of included parts shown to the customer (e.g. "Basis SEO").
+    includedItems: jsonb("included_items").$type(),
+    // Whether this product is an optional add-on rather than a base package.
+    optional: boolean3().default(false).notNull(),
+    // Optional preset/tier label, e.g. start/growth/pro or bronze/silver/gold.
+    tier: text(),
+    // Manual ordering hint for catalog presentation (lower shows first).
+    sortOrder: integer2("sort_order").default(0).notNull(),
     isActive: boolean3().default(true).notNull(),
     usageCount: integer2("usage_count").default(0).notNull(),
     lastUsedAt: timestamp("last_used_at", {
@@ -106480,7 +106495,7 @@ var TOOLS = [
   },
   {
     name: "get-products",
-    description: "List catalog products used on invoices AND quotes (the shared `invoice_products` catalog). Each entry includes its ID (UUID), name, unit price, currency, unit, active/archived flag, configurable flag, and usage stats. Editing or archiving a catalog product never changes existing invoices/quotes \u2014 those keep an immutable line-item snapshot; catalog changes only affect documents created afterwards.",
+    description: "List catalog products used on invoices AND quotes (the shared `invoice_products` catalog). Each entry includes its ID (UUID), name, unit price, currency, unit, active/archived flag, configurable flag, usage stats, and structured package metadata (category, billingType, tier, optional add-on flag and includedItems). Editing or archiving a catalog product never changes existing invoices/quotes \u2014 those keep an immutable line-item snapshot; catalog changes only affect documents created afterwards.",
     inputSchema: {
       type: "object",
       properties: {
@@ -106506,7 +106521,7 @@ var TOOLS = [
   },
   {
     name: "get-product-by-id",
-    description: "Get a single catalog product by its ID (UUID), including name, unit price, currency, unit, active/archived flag, configurable flag, and usage stats.",
+    description: "Get a single catalog product by its ID (UUID), including name, unit price, currency, unit, active/archived flag, configurable flag, usage stats, and structured package metadata (category, billingType, tier, optional add-on flag and includedItems).",
     inputSchema: {
       type: "object",
       properties: {
@@ -106518,7 +106533,7 @@ var TOOLS = [
   },
   {
     name: "create-product",
-    description: "Create a catalog product for use on invoices and quotes. Stored in the shared `invoice_products` catalog. This only adds a reusable catalog entry; it does not place the product on any document. Returns the created product with its ID and normalized fields.",
+    description: "Create a catalog product for use on invoices and quotes. Stored in the shared `invoice_products` catalog. This only adds a reusable catalog entry; it does not place the product on any document. Supports structured package metadata (billingType, category, includedItems, optional add-on flag, tier, sortOrder) so website packages, add-ons, hosting and support subscriptions can be modelled richly. Returns the created product with its ID and normalized fields.",
     inputSchema: {
       type: "object",
       properties: {
@@ -106533,6 +106548,34 @@ var TOOLS = [
         unit: {
           type: "string",
           description: "Unit label (e.g. hour, piece, month)"
+        },
+        billingType: {
+          type: "string",
+          enum: ["one_time", "monthly", "yearly"],
+          description: "Billing cadence for this product"
+        },
+        category: {
+          type: "string",
+          enum: ["website", "addon", "hosting", "support", "other"],
+          description: "Product category for catalog filtering"
+        },
+        includedItems: {
+          type: "array",
+          items: { type: "string" },
+          description: "Parts included in the package (e.g. ['Basis SEO', 'Contactformulier'])"
+        },
+        optional: {
+          type: "boolean",
+          description: "Optional add-on (true) vs base package (false)"
+        },
+        tier: {
+          type: "string",
+          enum: ["start", "growth", "pro", "bronze", "silver", "gold"],
+          description: "Optional preset/tier label"
+        },
+        sortOrder: {
+          type: "number",
+          description: "Manual ordering hint (lower shows first)"
         }
       },
       required: ["name"]
@@ -106540,7 +106583,7 @@ var TOOLS = [
   },
   {
     name: "update-product",
-    description: "Update a catalog product's editable fields (name, description, price, currency, unit) or reactivate it (isActive: true). Only provided fields change. IMPORTANT: updates apply only to FUTURE invoices/quotes. Existing/sent/accepted/paid documents keep their immutable line-item snapshot and are never mutated. Find the product id via get-products.",
+    description: "Update a catalog product's editable fields (name, description, price, currency, unit), its package metadata (billingType, category, includedItems, optional, tier, sortOrder), or reactivate it (isActive: true). Only provided fields change. IMPORTANT: updates apply only to FUTURE invoices/quotes. Existing/sent/accepted/paid documents keep their immutable line-item snapshot and are never mutated. Find the product id via get-products.",
     inputSchema: {
       type: "object",
       properties: {
@@ -106557,6 +106600,34 @@ var TOOLS = [
         isActive: {
           type: "boolean",
           description: "Set true to reactivate an archived product"
+        },
+        billingType: {
+          type: ["string", "null"],
+          enum: ["one_time", "monthly", "yearly", null],
+          description: "Billing cadence; null clears it"
+        },
+        category: {
+          type: ["string", "null"],
+          enum: ["website", "addon", "hosting", "support", "other", null],
+          description: "Product category; null clears it"
+        },
+        includedItems: {
+          type: ["array", "null"],
+          items: { type: "string" },
+          description: "Parts included in the package; null/[] clears it"
+        },
+        optional: {
+          type: "boolean",
+          description: "Optional add-on (true) vs base package (false)"
+        },
+        tier: {
+          type: ["string", "null"],
+          enum: ["start", "growth", "pro", "bronze", "silver", "gold", null],
+          description: "Preset/tier label; null clears it"
+        },
+        sortOrder: {
+          type: "number",
+          description: "Manual ordering hint (lower shows first)"
         }
       },
       required: ["productId"]
@@ -114088,6 +114159,22 @@ The project had no tickets, hours, trips, or templates. Any project-scoped confi
 
 // src/tools/products.ts
 var PRODUCT_STATUSES = ["active", "archived", "all"];
+var BILLING_TYPES = ["one_time", "monthly", "yearly"];
+var CATEGORIES = [
+  "website",
+  "addon",
+  "hosting",
+  "support",
+  "other"
+];
+var TIERS = [
+  "start",
+  "growth",
+  "pro",
+  "bronze",
+  "silver",
+  "gold"
+];
 var PRODUCT_COLUMNS = {
   id: schema_exports.invoiceProducts.id,
   teamId: schema_exports.invoiceProducts.teamId,
@@ -114097,6 +114184,12 @@ var PRODUCT_COLUMNS = {
   currency: schema_exports.invoiceProducts.currency,
   unit: schema_exports.invoiceProducts.unit,
   isConfigurable: schema_exports.invoiceProducts.isConfigurable,
+  billingType: schema_exports.invoiceProducts.billingType,
+  category: schema_exports.invoiceProducts.category,
+  includedItems: schema_exports.invoiceProducts.includedItems,
+  optional: schema_exports.invoiceProducts.optional,
+  tier: schema_exports.invoiceProducts.tier,
+  sortOrder: schema_exports.invoiceProducts.sortOrder,
   isActive: schema_exports.invoiceProducts.isActive,
   usageCount: schema_exports.invoiceProducts.usageCount,
   lastUsedAt: schema_exports.invoiceProducts.lastUsedAt,
@@ -114113,13 +114206,34 @@ function formatPrice(p3) {
 function formatProduct(p3) {
   const flags = [p3.isActive ? "active" : "archived"];
   if (p3.isConfigurable) flags.push("configurable");
+  if (p3.optional) flags.push("add-on");
+  const meta5 = [];
+  if (p3.category) meta5.push(`category=${p3.category}`);
+  if (p3.billingType) meta5.push(`billing=${p3.billingType}`);
+  if (p3.tier) meta5.push(`tier=${p3.tier}`);
+  const included = p3.includedItems && p3.includedItems.length > 0 ? `Included: ${p3.includedItems.join(", ")}
+` : "";
   return `**${p3.name}** (${flags.join(", ")})
 ID: ${p3.id}
 Price: ${formatPrice(p3)}
-${p3.description ? `Description: ${p3.description}
+${meta5.length > 0 ? `${meta5.join(", ")}
+` : ""}` + included + `${p3.description ? `Description: ${p3.description}
 ` : ""}Used: ${p3.usageCount}x${p3.lastUsedAt ? ` (last ${new Date(p3.lastUsedAt).toLocaleDateString()})` : ""}
 `;
 }
+function validateEnum(label, value, allowed) {
+  if (value === void 0 || value === null) return null;
+  if (typeof value !== "string" || !allowed.includes(value)) {
+    return `Error: invalid ${label} "${String(value)}". Allowed: ${allowed.join(", ")}.`;
+  }
+  return null;
+}
+function normalizeIncludedItems(value) {
+  if (value === void 0) return void 0;
+  if (value === null) return null;
+  const cleaned = value.map((item) => typeof item === "string" ? item.trim() : "").filter((item) => item.length > 0);
+  return cleaned.length > 0 ? cleaned : null;
+}
 async function handleGetProducts(input) {
   const { q: q3, currency, pageSize = 20 } = input;
   const status = input.status ?? "active";
@@ -114200,6 +114314,8 @@ async function handleCreateProduct(input) {
   if (!name21 || name21.trim().length === 0) {
     return textResponse3("Error: `name` is required.");
   }
+  const enumError = validateEnum("billingType", input.billingType, BILLING_TYPES) ?? validateEnum("category", input.category, CATEGORIES) ?? validateEnum("tier", input.tier, TIERS);
+  if (enumError) return textResponse3(enumError);
   const resolved = await resolveTeamId(input.teamId);
   if (!resolved.ok) return resolved.response;
   const [created] = await db.insert(schema_exports.invoiceProducts).values({
@@ -114209,6 +114325,12 @@ async function handleCreateProduct(input) {
     price: price ?? null,
     currency: currency ?? null,
     unit: unit ?? null,
+    billingType: input.billingType ?? null,
+    category: input.category ?? null,
+    includedItems: normalizeIncludedItems(input.includedItems) ?? null,
+    optional: input.optional ?? false,
+    tier: input.tier ?? null,
+    sortOrder: input.sortOrder ?? 0,
     isActive: true,
     lastUsedAt: (/* @__PURE__ */ new Date()).toISOString()
   }).returning(PRODUCT_COLUMNS);
@@ -114230,6 +114352,8 @@ async function handleUpdateProduct(input) {
       `Product ${productId} not found, or it is not owned by this team.`
     );
   }
+  const enumError = validateEnum("billingType", input.billingType, BILLING_TYPES) ?? validateEnum("category", input.category, CATEGORIES) ?? validateEnum("tier", input.tier, TIERS);
+  if (enumError) return textResponse3(enumError);
   const updates = {};
   if (input.name !== void 0) {
     if (!input.name || input.name.trim().length === 0) {
@@ -114242,9 +114366,17 @@ async function handleUpdateProduct(input) {
   if (input.currency !== void 0) updates.currency = input.currency;
   if (input.unit !== void 0) updates.unit = input.unit;
   if (input.isActive !== void 0) updates.isActive = input.isActive;
+  if (input.billingType !== void 0) updates.billingType = input.billingType;
+  if (input.category !== void 0) updates.category = input.category;
+  if (input.includedItems !== void 0) {
+    updates.includedItems = normalizeIncludedItems(input.includedItems);
+  }
+  if (input.optional !== void 0) updates.optional = input.optional;
+  if (input.tier !== void 0) updates.tier = input.tier;
+  if (input.sortOrder !== void 0) updates.sortOrder = input.sortOrder;
   if (Object.keys(updates).length === 0) {
     return textResponse3(
-      "No fields to update. Provide at least one of: name, description, price, currency, unit, isActive."
+      "No fields to update. Provide at least one of: name, description, price, currency, unit, isActive, billingType, category, includedItems, optional, tier, sortOrder."
     );
   }
   updates.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -114320,7 +114452,12 @@ function snapshotFromProduct(product, defaults, now2 = () => (/* @__PURE__ */ ne
     capturedAt: now2(),
     metadata: {
       isConfigurable: product.isConfigurable,
-      options: product.options ?? null
+      options: product.options ?? null,
+      billingType: product.billingType ?? null,
+      category: product.category ?? null,
+      includedItems: product.includedItems ?? null,
+      optional: product.optional ?? false,
+      tier: product.tier ?? null
     }
   };
 }
@@ -114444,7 +114581,12 @@ async function loadProductsInTeam(productIds, teamId) {
     currency: schema_exports.invoiceProducts.currency,
     unit: schema_exports.invoiceProducts.unit,
     isConfigurable: schema_exports.invoiceProducts.isConfigurable,
-    options: schema_exports.invoiceProducts.options
+    options: schema_exports.invoiceProducts.options,
+    billingType: schema_exports.invoiceProducts.billingType,
+    category: schema_exports.invoiceProducts.category,
+    includedItems: schema_exports.invoiceProducts.includedItems,
+    optional: schema_exports.invoiceProducts.optional,
+    tier: schema_exports.invoiceProducts.tier
   }).from(schema_exports.invoiceProducts).where(
     and(
       inArray(schema_exports.invoiceProducts.id, productIds),
@@ -114780,12 +114922,22 @@ async function handleAddProductToQuote(input) {
     lastUsedAt: (/* @__PURE__ */ new Date()).toISOString()
   }).where(eq(schema_exports.invoiceProducts.id, product.id));
   const snap = newItem.productSnapshot;
+  const meta5 = snap.metadata;
+  const metaParts = [];
+  if (meta5.category) metaParts.push(`category=${meta5.category}`);
+  if (meta5.billingType) metaParts.push(`billing=${meta5.billingType}`);
+  if (meta5.tier) metaParts.push(`tier=${meta5.tier}`);
+  if (meta5.optional) metaParts.push("optional add-on");
+  if (meta5.includedItems && meta5.includedItems.length > 0) {
+    metaParts.push(`included=[${meta5.includedItems.join(", ")}]`);
+  }
   return textResponse4(
     `\u2705 **Product added to draft quote ${updated.quotationNumber ?? updated.id}**
 
 Line item: ${newItem.name} \xD7 ${newItem.quantity}${newItem.unit ? ` ${newItem.unit}` : ""} @ ${newItem.price} ${snap.currency}
 Snapshot: name="${snap.name}", unitPrice=${snap.unitPrice}, currency=${snap.currency}, vatRate=${snap.vatRate}%, unit=${snap.unit ?? "-"}
-
+${metaParts.length > 0 ? `Metadata: ${metaParts.join(", ")}
+` : ""}
 New quote total: ${updated.amount} ${updated.currency} (subtotal ${updated.subtotal}, VAT ${updated.vat})
 The snapshot is immutable: later catalog edits won't change this quote.`
   );
@@ -121555,7 +121707,7 @@ function attemptedLockedFields(update) {
 
 // src/tools/trips.ts
 var TRIP_TYPES = ["private", "business"];
-var BILLING_TYPES = TRIP_BILLING_TYPES;
+var BILLING_TYPES2 = TRIP_BILLING_TYPES;
 function textResponse7(text3) {
   return { content: [{ type: "text", text: text3 }] };
 }
@@ -121616,9 +121768,9 @@ async function handleGetTrips(input) {
       `Error: invalid tripType "${input.tripType}". Allowed: ${TRIP_TYPES.join(", ")}.`
     );
   }
-  if (input.billingType && !BILLING_TYPES.includes(input.billingType)) {
+  if (input.billingType && !BILLING_TYPES2.includes(input.billingType)) {
     return textResponse7(
-      `Error: invalid billingType "${input.billingType}". Allowed: ${BILLING_TYPES.join(", ")}.`
+      `Error: invalid billingType "${input.billingType}". Allowed: ${BILLING_TYPES2.join(", ")}.`
     );
   }
   const scope = await resolveTeamScope(input.teamId);
@@ -121738,9 +121890,9 @@ async function handleCreateTrip(input) {
     );
   }
   const billingType = input.billingType ?? "not_billable";
-  if (!BILLING_TYPES.includes(billingType)) {
+  if (!BILLING_TYPES2.includes(billingType)) {
     return textResponse7(
-      `Error: invalid billingType "${input.billingType}". Allowed: ${BILLING_TYPES.join(", ")}.`
+      `Error: invalid billingType "${input.billingType}". Allowed: ${BILLING_TYPES2.join(", ")}.`
     );
   }
   const resolved = await resolveTeamId(input.teamId);
@@ -121819,9 +121971,9 @@ async function handleUpdateTrip(input) {
       `Error: invalid tripType "${input.tripType}". Allowed: ${TRIP_TYPES.join(", ")}.`
     );
   }
-  if (input.billingType && !BILLING_TYPES.includes(input.billingType)) {
+  if (input.billingType && !BILLING_TYPES2.includes(input.billingType)) {
     return textResponse7(
-      `Error: invalid billingType "${input.billingType}". Allowed: ${BILLING_TYPES.join(", ")}.`
+      `Error: invalid billingType "${input.billingType}". Allowed: ${BILLING_TYPES2.join(", ")}.`
     );
   }
   const resolved = await resolveTeamId(input.teamId);
@@ -122215,13 +122367,13 @@ async function handleGetTicketById(input) {
   }).from(schema_exports.ticketAttachments).leftJoin(
     schema_exports.users,
     eq(schema_exports.users.id, schema_exports.ticketAttachments.userId)
-  ).where(eq(schema_exports.ticketAttachments.ticketId, id)).orderBy(asc(schema_exports.ticketAttachments.createdAt));
+  ).where(eq(schema_exports.ticketAttachments.ticketId, resolved.id)).orderBy(asc(schema_exports.ticketAttachments.createdAt));
   const comments = await db.select({
     id: schema_exports.ticketComments.id,
     content: schema_exports.ticketComments.content,
     createdAt: schema_exports.ticketComments.createdAt,
     userId: schema_exports.ticketComments.userId
-  }).from(schema_exports.ticketComments).where(eq(schema_exports.ticketComments.ticketId, id)).orderBy(asc(schema_exports.ticketComments.createdAt));
+  }).from(schema_exports.ticketComments).where(eq(schema_exports.ticketComments.ticketId, resolved.id)).orderBy(asc(schema_exports.ticketComments.createdAt));
   const commentUserIds = [
     ...new Set(
       comments.map((c6) => c6.userId).filter((v2) => Boolean(v2))
@@ -122284,8 +122436,8 @@ ${text3.split("\n").map((l4) => `     ${l4}`).join("\n")}`;
 ` : ticketRow.requester ? `Assignee: (unassigned) \u2014 use requester id ${ticketRow.requester.id} for review handoff
 ` : `Assignee: (unassigned)
 `;
-  const ticketTagRows = await getTagsForTickets([id]);
-  const ticketTags2 = ticketTagRows.get(id) ?? [];
+  const ticketTagRows = await getTagsForTickets([resolved.id]);
+  const ticketTags2 = ticketTagRows.get(resolved.id) ?? [];
   const tagsLine = ticketTags2.length > 0 ? `Tags: ${formatTagList(ticketTags2)}
 ` : `Tags: (none)
 `;
@@ -122472,7 +122624,7 @@ ${tagErrors.map((e6) => `   \u2022 ${e6}`).join("\n")}
 }
 
 // src/server.ts
-var SERVER_VERSION = "3.5.0";
+var SERVER_VERSION = "3.5.1";
 function createMcpServer() {
   const server = new Server(
     {