@mgsoftwarebv/mcp-server-bridge 3.4.0 → 3.4.1

package/dist/index.js

@@ -106277,6 +106277,106 @@ var TOOLS = [
       required: ["documentId", "invoiceId"]
     }
   },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        q: {
+          type: "string",
+          description: "Search query for product name/description"
+        },
+        status: {
+          type: "string",
+          enum: ["active", "archived", "all"],
+          default: "active",
+          description: "Filter by catalog status (archived = isActive false)"
+        },
+        currency: {
+          type: "string",
+          description: "Filter by currency code (e.g. EUR)"
+        },
+        pageSize: { type: "number", default: 20, maximum: 100 }
+      },
+      required: []
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        productId: { type: "string", description: "Product ID (UUID)" }
+      },
+      required: ["productId"]
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        name: { type: "string", description: "Product name" },
+        description: { type: "string" },
+        price: {
+          type: "number",
+          description: "Unit price (catalog default, excl. quantity)"
+        },
+        currency: { type: "string", description: "Currency code (e.g. EUR)" },
+        unit: {
+          type: "string",
+          description: "Unit label (e.g. hour, piece, month)"
+        }
+      },
+      required: ["name"]
+    }
+  },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        productId: { type: "string", description: "Product ID (UUID)" },
+        name: { type: "string" },
+        description: { type: ["string", "null"] },
+        price: {
+          type: ["number", "null"],
+          description: "Unit price (catalog default)"
+        },
+        currency: { type: ["string", "null"] },
+        unit: { type: ["string", "null"] },
+        isActive: {
+          type: "boolean",
+          description: "Set true to reactivate an archived product"
+        }
+      },
+      required: ["productId"]
+    }
+  },
+  {
+    name: "archive-product",
+    description: "Archive (soft-disable) a catalog product so it no longer appears in invoice/quote product pickers. Preferred over deletion: products referenced historically stay safe because invoices/quotes hold their own line-item snapshots. Reactivate later via update-product (isActive: true).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        productId: { type: "string", description: "Product ID (UUID)" },
+        reason: {
+          type: "string",
+          description: "Optional note about why it was archived (not persisted)"
+        }
+      },
+      required: ["productId"]
+    }
+  },
   {
     name: "log-hours",
     description: "Analyze current chat conversation and log hours as draft tracker entry. AI analyzes chat context to estimate hours as a senior developer would (without AI assistance). Cursor AI matches workspace name to correct project from list (optional).",
@@ -113005,6 +113105,203 @@ async function handleRemoveProjectMember(input) {
   return textResponse(text3);
 }
 
+// src/tools/products.ts
+var PRODUCT_STATUSES = ["active", "archived", "all"];
+var PRODUCT_COLUMNS = {
+  id: schema_exports.invoiceProducts.id,
+  teamId: schema_exports.invoiceProducts.teamId,
+  name: schema_exports.invoiceProducts.name,
+  description: schema_exports.invoiceProducts.description,
+  price: schema_exports.invoiceProducts.price,
+  currency: schema_exports.invoiceProducts.currency,
+  unit: schema_exports.invoiceProducts.unit,
+  isConfigurable: schema_exports.invoiceProducts.isConfigurable,
+  isActive: schema_exports.invoiceProducts.isActive,
+  usageCount: schema_exports.invoiceProducts.usageCount,
+  lastUsedAt: schema_exports.invoiceProducts.lastUsedAt,
+  createdAt: schema_exports.invoiceProducts.createdAt,
+  updatedAt: schema_exports.invoiceProducts.updatedAt
+};
+function textResponse2(text3) {
+  return { content: [{ type: "text", text: text3 }] };
+}
+function formatPrice(p3) {
+  if (p3.price == null) return "(no price)";
+  return `${p3.price}${p3.currency ? ` ${p3.currency}` : ""}${p3.unit ? ` / ${p3.unit}` : ""}`;
+}
+function formatProduct(p3) {
+  const flags = [p3.isActive ? "active" : "archived"];
+  if (p3.isConfigurable) flags.push("configurable");
+  return `**${p3.name}** (${flags.join(", ")})
+ID: ${p3.id}
+Price: ${formatPrice(p3)}
+${p3.description ? `Description: ${p3.description}
+` : ""}Used: ${p3.usageCount}x${p3.lastUsedAt ? ` (last ${new Date(p3.lastUsedAt).toLocaleDateString()})` : ""}
+`;
+}
+async function handleGetProducts(input) {
+  const { q: q3, currency, pageSize = 20 } = input;
+  const status = input.status ?? "active";
+  if (!PRODUCT_STATUSES.includes(status)) {
+    return textResponse2(
+      `Error: invalid status "${status}". Allowed: ${PRODUCT_STATUSES.join(", ")}.`
+    );
+  }
+  const scope = await resolveTeamScope(input.teamId);
+  if (!scope.ok) return scope.response;
+  if (scope.teamIds.length === 0) {
+    return textResponse2("No accessible teams found.");
+  }
+  const filters = [inArray(schema_exports.invoiceProducts.teamId, scope.teamIds)];
+  if (status === "active") {
+    filters.push(eq(schema_exports.invoiceProducts.isActive, true));
+  } else if (status === "archived") {
+    filters.push(eq(schema_exports.invoiceProducts.isActive, false));
+  }
+  if (currency) filters.push(eq(schema_exports.invoiceProducts.currency, currency));
+  if (q3) {
+    filters.push(
+      or(
+        sql`${schema_exports.invoiceProducts.fts} @@ plainto_tsquery('english', ${q3})`,
+        ilike(schema_exports.invoiceProducts.name, `%${q3}%`)
+      )
+    );
+  }
+  const rows = await db.select(PRODUCT_COLUMNS).from(schema_exports.invoiceProducts).where(and(...filters)).orderBy(
+    desc(schema_exports.invoiceProducts.usageCount),
+    desc(schema_exports.invoiceProducts.lastUsedAt),
+    asc(schema_exports.invoiceProducts.name)
+  ).limit(Math.min(pageSize, 100));
+  if (rows.length === 0) {
+    return textResponse2(
+      `No products found${status !== "all" ? ` (status: ${status})` : ""}.`
+    );
+  }
+  return textResponse2(
+    `Found ${rows.length} product(s):
+
+${rows.map(formatProduct).join("\n")}`
+  );
+}
+async function handleGetProductById(input) {
+  const { productId } = input;
+  if (!productId) return textResponse2("Error: `productId` is required.");
+  const scope = await resolveTeamScope(input.teamId);
+  if (!scope.ok) return scope.response;
+  if (scope.teamIds.length === 0) {
+    return textResponse2("No accessible teams found.");
+  }
+  const [row] = await db.select(PRODUCT_COLUMNS).from(schema_exports.invoiceProducts).where(
+    and(
+      eq(schema_exports.invoiceProducts.id, productId),
+      inArray(schema_exports.invoiceProducts.teamId, scope.teamIds)
+    )
+  ).limit(1);
+  if (!row) {
+    return textResponse2(
+      `Product ${productId} not found or you don't have access to it.`
+    );
+  }
+  return textResponse2(formatProduct(row));
+}
+async function loadProductInTeam(productId, teamId) {
+  const accessibleTeamIds = await getAccessibleTeamIds(teamId);
+  const [row] = await db.select(PRODUCT_COLUMNS).from(schema_exports.invoiceProducts).where(
+    and(
+      eq(schema_exports.invoiceProducts.id, productId),
+      inArray(schema_exports.invoiceProducts.teamId, accessibleTeamIds)
+    )
+  ).limit(1);
+  return row ?? null;
+}
+async function handleCreateProduct(input) {
+  const { name: name21, description, price, currency, unit } = input;
+  if (!name21 || name21.trim().length === 0) {
+    return textResponse2("Error: `name` is required.");
+  }
+  const resolved = await resolveTeamId(input.teamId);
+  if (!resolved.ok) return resolved.response;
+  const [created] = await db.insert(schema_exports.invoiceProducts).values({
+    teamId: resolved.teamId,
+    name: name21.trim(),
+    description: description ?? null,
+    price: price ?? null,
+    currency: currency ?? null,
+    unit: unit ?? null,
+    isActive: true,
+    lastUsedAt: (/* @__PURE__ */ new Date()).toISOString()
+  }).returning(PRODUCT_COLUMNS);
+  if (!created) return textResponse2("Failed to create product.");
+  return textResponse2(
+    `\u2705 **Product created**
+
+${formatProduct(created)}`
+  );
+}
+async function handleUpdateProduct(input) {
+  const { productId } = input;
+  if (!productId) return textResponse2("Error: `productId` is required.");
+  const resolved = await resolveTeamId(input.teamId);
+  if (!resolved.ok) return resolved.response;
+  const existing = await loadProductInTeam(productId, resolved.teamId);
+  if (!existing) {
+    return textResponse2(
+      `Product ${productId} not found, or it is not owned by this team.`
+    );
+  }
+  const updates = {};
+  if (input.name !== void 0) {
+    if (!input.name || input.name.trim().length === 0) {
+      return textResponse2("Error: `name` cannot be empty.");
+    }
+    updates.name = input.name.trim();
+  }
+  if (input.description !== void 0) updates.description = input.description;
+  if (input.price !== void 0) updates.price = input.price;
+  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 (Object.keys(updates).length === 0) {
+    return textResponse2(
+      "No fields to update. Provide at least one of: name, description, price, currency, unit, isActive."
+    );
+  }
+  updates.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const [updated] = await db.update(schema_exports.invoiceProducts).set(updates).where(eq(schema_exports.invoiceProducts.id, existing.id)).returning(PRODUCT_COLUMNS);
+  if (!updated) return textResponse2(`Failed to update product ${productId}.`);
+  return textResponse2(
+    `\u2705 **Product updated**
+
+${formatProduct(updated)}
+Note: this only affects future invoices/quotes. Existing documents keep their line-item snapshots.`
+  );
+}
+async function handleArchiveProduct(input) {
+  const { productId, reason } = input;
+  if (!productId) return textResponse2("Error: `productId` is required.");
+  const resolved = await resolveTeamId(input.teamId);
+  if (!resolved.ok) return resolved.response;
+  const existing = await loadProductInTeam(productId, resolved.teamId);
+  if (!existing) {
+    return textResponse2(
+      `Product ${productId} not found, or it is not owned by this team.`
+    );
+  }
+  if (!existing.isActive) {
+    return textResponse2(
+      `Product "${existing.name}" (${existing.id}) is already archived.`
+    );
+  }
+  const [archived] = await db.update(schema_exports.invoiceProducts).set({ isActive: false, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }).where(eq(schema_exports.invoiceProducts.id, existing.id)).returning(PRODUCT_COLUMNS);
+  if (!archived) return textResponse2(`Failed to archive product ${productId}.`);
+  return textResponse2(
+    `\u2705 **Product archived** (hidden from new invoices/quotes; existing documents are untouched).
+
+${formatProduct(archived)}${reason ? `Reason: ${reason}
+` : ""}Reactivate it with update-product (isActive: true).`
+  );
+}
+
 // src/tools/teams.ts
 async function handleGetTeams() {
   const ctx = getAuthContext();
@@ -118496,7 +118793,7 @@ var EXT_MIME = {
   ppt: "application/vnd.ms-powerpoint",
   pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
 };
-function textResponse2(text3) {
+function textResponse3(text3) {
   return { content: [{ type: "text", text: text3 }] };
 }
 function mimeFromName(name21) {
@@ -118577,12 +118874,12 @@ async function handleUploadTicketAttachment(input) {
     (v2) => typeof v2 === "string" && v2.trim().length > 0
   );
   if (sources.length === 0) {
-    return textResponse2(
+    return textResponse3(
       "Provide exactly one source: filePath (absolute local path), imageUrl, or base64Data."
     );
   }
   if (sources.length > 1) {
-    return textResponse2(
+    return textResponse3(
       "Provide only one source (filePath, imageUrl, or base64Data), not several."
     );
   }
@@ -118602,7 +118899,7 @@ async function handleUploadTicketAttachment(input) {
     } else if (input.imageUrl) {
       const res = await fetch(input.imageUrl);
       if (!res.ok) {
-        return textResponse2(
+        return textResponse3(
           `Could not download from URL: HTTP ${res.status}.`
         );
       }
@@ -118630,22 +118927,22 @@ async function handleUploadTicketAttachment(input) {
       }
     }
   } catch (error49) {
-    return textResponse2(
+    return textResponse3(
       `Failed to read the file: ${error49 instanceof Error ? error49.message : String(error49)}`
     );
   }
   if (buffer2.byteLength === 0) {
-    return textResponse2("The file is empty (0 bytes); nothing to upload.");
+    return textResponse3("The file is empty (0 bytes); nothing to upload.");
   }
   if (buffer2.byteLength > MAX_FILE_SIZE) {
-    return textResponse2(
+    return textResponse3(
       `File too large (${(buffer2.byteLength / 1024 / 1024).toFixed(
         1
       )} MB). Max: 25 MB.`
     );
   }
   if (!ALLOWED_MIME_TYPES.has(mimeType)) {
-    return textResponse2(
+    return textResponse3(
       `Unsupported file type: ${mimeType}. Allowed: JPEG, PNG, GIF, WebP, PDF, DOC(X), XLS(X), PPT(X), TXT, CSV.`
     );
   }
@@ -118658,7 +118955,7 @@ async function handleUploadTicketAttachment(input) {
       options: { contentType: mimeType, upsert: true }
     });
   } catch (error49) {
-    return textResponse2(
+    return textResponse3(
       `Upload failed: ${error49 instanceof Error ? error49.message : String(error49)}`
     );
   }
@@ -118681,7 +118978,7 @@ async function handleUploadTicketAttachment(input) {
     url3 = signed.url;
   } catch {
   }
-  return textResponse2(
+  return textResponse3(
     `\u{1F4CE} **Attached to ${ticket.ticketNumber}**
 File: ${fileName}
 Type: ${mimeType}
@@ -119825,7 +120122,7 @@ ${tagErrors.map((e6) => `   \u2022 ${e6}`).join("\n")}
 }
 
 // src/server.ts
-var SERVER_VERSION = "3.4.0";
+var SERVER_VERSION = "3.5.0";
 function createMcpServer() {
   const server = new Server(
     {
@@ -119949,6 +120246,24 @@ function createMcpServer() {
           return await handleLinkDocumentToInvoice(
             asToolArgs(toolArgs)
           );
+        case "get-products":
+          return await handleGetProducts(asToolArgs(toolArgs));
+        case "get-product-by-id":
+          return await handleGetProductById(
+            asToolArgs(toolArgs)
+          );
+        case "create-product":
+          return await handleCreateProduct(
+            asToolArgs(toolArgs)
+          );
+        case "update-product":
+          return await handleUpdateProduct(
+            asToolArgs(toolArgs)
+          );
+        case "archive-product":
+          return await handleArchiveProduct(
+            asToolArgs(toolArgs)
+          );
         case "log-hours":
           return await handleLogHours(asToolArgs(toolArgs));
         case "get-github-file":