@mondaydotcomorg/z2h-cli 0.13.0 → 0.13.2

package/src/util/tags.ts

@@ -0,0 +1,94 @@
+import { brokerBaseUrl, routingHeaders } from '../constants';
+import { readZthAuth } from './auth/auth-store';
+
+/** The dimension a tag categorizes an app by. */
+export type TagType = 'app_type' | 'team';
+
+/** The tag dimensions, in prompt order. */
+export const TAG_TYPES: TagType[] = ['app_type', 'team'];
+
+/** Human labels for each dimension (CLI prompts / output). */
+export const TAG_TYPE_LABELS: Record<TagType, string> = {
+  app_type: 'App type',
+  team: 'Team',
+};
+
+/** A catalog entry: one selectable tag with its dimension + global usage count. */
+export interface CatalogEntry {
+  name: string;
+  type: TagType;
+  count: number;
+}
+
+/** A tag assigned to an app — name + dimension. */
+export interface AppTag {
+  name: string;
+  type: TagType;
+}
+
+interface CatalogResponse {
+  tags?: CatalogEntry[];
+}
+
+interface AppTagsResponse {
+  tags?: AppTag[];
+}
+
+/**
+ * Authenticated request to the bigbrain-zth tag endpoints. Mirrors the Bearer
+ * pattern used by the STS broker / lock-release calls, with network-error
+ * wrapping, auth-failure guidance, and response-body inclusion on failure.
+ */
+async function tagFetch(method: 'GET' | 'PUT', path: string, body?: unknown): Promise<Response> {
+  const { token } = await readZthAuth();
+
+  let res: Response;
+  try {
+    res = await fetch(`${brokerBaseUrl()}${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${token}`,
+        Accept: 'application/json',
+        ...(body === undefined ? {} : { 'Content-Type': 'application/json' }),
+        ...routingHeaders(),
+      },
+      body: body === undefined ? undefined : JSON.stringify(body),
+    });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(`Z2H tag request failed: ${message}`);
+  }
+
+  if (res.status === 401 || res.status === 403) {
+    throw new Error(
+      `Z2H tag request rejected by the broker (${res.status}). Refresh your token by running 'z2h-cli generate-z2h-token'.`
+    );
+  }
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`Z2H tag request returned ${res.status}: ${text.slice(0, 1024)}`);
+  }
+
+  return res;
+}
+
+/** The full closed tag catalog (app types + teams), with usage counts. */
+export async function fetchTagCatalog(): Promise<CatalogEntry[]> {
+  const res = await tagFetch('GET', '/z2h-cli/tags');
+  const data = (await res.json()) as CatalogResponse;
+  return data.tags ?? [];
+}
+
+/** Tags currently assigned to an app (bare slug). */
+export async function fetchAppTags(appSlug: string): Promise<AppTag[]> {
+  const res = await tagFetch('GET', `/z2h-cli/tags/${encodeURIComponent(appSlug)}`);
+  const data = (await res.json()) as AppTagsResponse;
+  return data.tags ?? [];
+}
+
+/** Full-replace an app's tag set; returns the resulting tags. */
+export async function setAppTags(appSlug: string, tags: string[]): Promise<AppTag[]> {
+  const res = await tagFetch('PUT', `/z2h-cli/tags/${encodeURIComponent(appSlug)}`, { tags });
+  const data = (await res.json()) as AppTagsResponse;
+  return data.tags ?? [];
+}