ersatztv/web/src/api/templates.ts

import { ApiError, request, requestWithMeta, type ResponseWithMeta } from './client';
import type { components } from './generated/v1';

export type TemplateGroup = components['schemas']['TemplateGroupResponseModel'];
export type Template = components['schemas']['TemplateResponseModel'];
export type TemplateItem = components['schemas']['TemplateItemResponseModel'];
export type TemplateWithItems = components['schemas']['TemplateWithItemsResponseModel'];
export type CreateTemplateGroupRequest = components['schemas']['CreateTemplateGroupRequest'];
export type CreateTemplateRequest = components['schemas']['CreateTemplateRequest'];
export type ReplaceTemplateRequest = components['schemas']['ReplaceTemplateRequest'];
export type TemplateItemRequest = components['schemas']['TemplateItemRequest'];
export type CopyTemplateRequest = components['schemas']['CopyTemplateRequest'];

// Template groups

export function getTemplateGroups(): Promise<TemplateGroup[]> {
  return request<TemplateGroup[]>('/api/v1/templates/groups');
}

export function createTemplateGroup(body: CreateTemplateGroupRequest): Promise<TemplateGroup> {
  return request<TemplateGroup>('/api/v1/templates/groups', { body, method: 'POST' });
}

export function deleteTemplateGroup(id: number): Promise<void> {
  return request<void>(`/api/v1/templates/groups/${id}`, { method: 'DELETE' });
}

// Templates

export function getTemplates(): Promise<Template[]> {
  return request<Template[]>('/api/v1/templates');
}

export function getTemplate(id: number): Promise<Template> {
  return request<Template>(`/api/v1/templates/${id}`);
}

export function createTemplate(body: CreateTemplateRequest): Promise<Template> {
  return request<Template>('/api/v1/templates', { body, method: 'POST' });
}

export function deleteTemplate(id: number): Promise<void> {
  return request<void>(`/api/v1/templates/${id}`, { method: 'DELETE' });
}

export function getTemplateItems(id: number): Promise<TemplateItem[]> {
  return request<TemplateItem[]>(`/api/v1/templates/${id}/items`);
}

/** Load template items together with the template's concurrency ETag (issue #253). */
export function getTemplateItemsWithMeta(id: number): Promise<ResponseWithMeta<TemplateItem[]>> {
  return requestWithMeta<TemplateItem[]>(`/api/v1/templates/${id}/items`);
}

/**
 * Replace a template. Pass the last-seen ETag as `If-Match` to reject a stale overwrite with 412;
 * the resolved value carries the new ETag for a subsequent save (issue #253).
 */
export function replaceTemplate(
  id: number,
  body: ReplaceTemplateRequest,
  ifMatch?: string | null
): Promise<ResponseWithMeta<TemplateWithItems>> {
  return requestWithMeta<TemplateWithItems>(`/api/v1/templates/${id}`, {
    body,
    method: 'PUT',
    headers: ifMatch ? { 'If-Match': ifMatch } : undefined
  });
}

export function copyTemplate(id: number, body: CopyTemplateRequest): Promise<Template> {
  return request<Template>(`/api/v1/templates/${id}/copy`, { body, method: 'POST' });
}

export function messageFromTemplateError(error: unknown, fallback = 'Unable to load templates'): string {
  if (error instanceof ApiError) {
    return error.detail ?? error.message;
  }

  if (error instanceof Error) {
    return error.message;
  }

  return fallback;
}