Récupère la liste des groupes de rayons, utilisés pour organiser les catégories de produits. Chaque groupe peut regrouper plusieurs rayons.

Instructions

Implementation Reference

• src/tools/data.ts:90-114 (handler)

  The handler function for the tool (shared with other simple list tools). It resolves authentication, fetches data from the specific PHP endpoint using the 'get' HTTP client with shopId, apiKey, and format params, logs the result, structures the data, and returns it or an error message.

  async ({ format }: CommonArgs, ctx: Ctx) => {
      try {
          const { shopId, apiKey } = resolveAuth(undefined, ctx);
          const data = await get(path, { idboutique: shopId, key: apiKey, format });
  
          process.stderr.write(
              `[caisse][tool:${toolName}] ok type=${Array.isArray(data) ? 'array' : typeof data}`
              + (Array.isArray(data) ? ` len=${data.length}` : '')
              + '\n'
          );
          //Array.isArray(data) ? data.slice(0, 50) : data
          const funcResult = structData( data);
          process.stderr.write(`[caisse][RES]  ${JSON.stringify(data)} \n`);
          process.stderr.write(`[caisse][RES] funcResult ${JSON.stringify(funcResult)} \n`);
          return funcResult;
          //return { content, structuredContent: isText ? undefined : data };
      } catch (e) {
          process.stderr.write(`[caisse][tool:${toolName}][error]\n`);
          process.stderr.write(`[caisse][tool:${toolName}][error] ${(e as Error).message}\n`);
          // renvoyer un message "propre" plutôt que laisser l’exception devenir un 424
          return {
              content: [{ type: 'text', text: `Erreur pendant la préparation de la réponse: ${(e as Error).message}` }],
              is_error: true,
          };
      }

• src/tools/data.ts:11-13 (schema)

  Input schema used for the tool: optional 'format' parameter defaulting to 'json'.

  const CommonShape = {
      format: z.enum(['json', 'csv', 'html']).default('json'),
  } satisfies Record<string, ZodTypeAny>;

• src/tools/data.ts:124-124 (registration)

  Specific registration of the 'data_list_department_groups' tool using the registerSimple helper, specifying the PHP endpoint '/workers/getDepartmentsGroups.php'.

  registerSimple(server, 'data_list_department_groups', '/workers/getDepartmentsGroups.php', t('tools.data_list_department_groups.description'), t('tools.data_list_department_groups.title'));

• src/tools/data.ts:75-117 (helper)

  registerSimple helper function that performs the server.registerTool call, defining title, description, inputSchema, and the generic handler for list tools.

  function registerSimple(
      server: McpServer | any,
      toolName: string,
      path: string,
      title: string,
      entityLabel: string
  ) {
      server.registerTool(
          toolName,
          {
              title,
              description: `Liste des ${entityLabel}`,
              inputSchema: CommonShape, // ZodRawShape,
              annotations: { readOnlyHint: true }
          },
          async ({ format }: CommonArgs, ctx: Ctx) => {
              try {
                  const { shopId, apiKey } = resolveAuth(undefined, ctx);
                  const data = await get(path, { idboutique: shopId, key: apiKey, format });
  
                  process.stderr.write(
                      `[caisse][tool:${toolName}] ok type=${Array.isArray(data) ? 'array' : typeof data}`
                      + (Array.isArray(data) ? ` len=${data.length}` : '')
                      + '\n'
                  );
                  //Array.isArray(data) ? data.slice(0, 50) : data
                  const funcResult = structData( data);
                  process.stderr.write(`[caisse][RES]  ${JSON.stringify(data)} \n`);
                  process.stderr.write(`[caisse][RES] funcResult ${JSON.stringify(funcResult)} \n`);
                  return funcResult;
                  //return { content, structuredContent: isText ? undefined : data };
              } catch (e) {
                  process.stderr.write(`[caisse][tool:${toolName}][error]\n`);
                  process.stderr.write(`[caisse][tool:${toolName}][error] ${(e as Error).message}\n`);
                  // renvoyer un message "propre" plutôt que laisser l’exception devenir un 424
                  return {
                      content: [{ type: 'text', text: `Erreur pendant la préparation de la réponse: ${(e as Error).message}` }],
                      is_error: true,
                  };
              }
          }
      );
  }

• src/tools/data.ts:52-73 (helper)

  Helper function used in the handler to format the response with a text preview and structuredContent.

  function structData(data: any) {
      // on ne touche PAS à structuredContent (c’est ce que ChatGPT utilise)
      const light = Array.isArray(data)
          ? data.slice(0, 5000)//.map(({ id, nom, email, tel, ...r }) => ({ id, nom, email, tel }))
          : data;
  
      const maxLength = 40000;
      const preview =
          typeof light === 'string'
              ? (light.length > maxLength ? light.slice(0, maxLength) + '…(truncated)' : light)
              : safeStringify(light, 2, maxLength);   // <-- aperçu court et “safe”
      const wrapped =
          Array.isArray(data)
              ? { data: data }
              : data && typeof data === 'object'
                  ? data
                  : { data: data };
      return {
          content: [{ type: 'text', text: preview }],
          structuredContent: wrapped,
      };
  }