Function useFlags

packages/cli/test/mocks/flags.ts:229–583

(
  flagsList: Flag[] = defaultFlags,
  sdkKeysList: SdkKey[] = defaultSdkKeys,
  settings: FlagSettings = defaultFlagSettings,
  segmentsList: Segment[] = defaultSegments
)

];

export function useFlags(
  flagsList: Flag[] = defaultFlags,
  sdkKeysList: SdkKey[] = defaultSdkKeys,
  settings: FlagSettings = defaultFlagSettings,
  segmentsList: Segment[] = defaultSegments
) {
  // Get flag settings
  client.scenario.get(
    '/v1/projects/:projectId/feature-flags/settings',
    (_req, res) => {
      res.json(settings);
    }
  );

  // List flags (v2: paginated, supports tag/createdBy/maintainerId filters)
  client.scenario.get(
    '/v2/projects/:projectId/feature-flags/flags',
    (req, res) => {
      const state = req.query.state || 'active';
      const createdBy = req.query.createdBy as string | undefined;
      const tags = toArray(req.query.tags);
      const maintainerIds = toArray(req.query.maintainerIds);

      let filteredFlags = flagsList.filter(f => f.state === state);
      if (createdBy) {
        filteredFlags = filteredFlags.filter(f => f.createdBy === createdBy);
      }
      if (tags.length > 0) {
        filteredFlags = filteredFlags.filter(f =>
          tags.every(tag => (f.tags ?? []).includes(tag))
        );
      }
      if (maintainerIds.length > 0) {
        filteredFlags = filteredFlags.filter(f =>
          maintainerIds.some(id => (f.maintainerIds ?? []).includes(id))
        );
      }

      // The CLI always sends `limit`; fall back to a single full page otherwise.
      const limit = req.query.limit
        ? Number(req.query.limit)
        : filteredFlags.length;
      const offset = req.query.cursor ? Number(req.query.cursor) : 0;
      const page = filteredFlags.slice(offset, offset + limit);
      const nextOffset = offset + limit;
      const next =
        nextOffset < filteredFlags.length ? String(nextOffset) : null;

      res.json({ data: page, pagination: { next } });
    }
  );

  // Get single flag
  client.scenario.get(
    '/v1/projects/:projectId/feature-flags/flags/:flagIdOrSlug',
    (req, res) => {
      const { flagIdOrSlug } = req.params;
      const flag = flagsList.find(