fimo 0.7.0 → 0.8.0-staging.1

package/assets/content-templates/hooks-template.eta

@@ -1,620 +1,63 @@
-<%
-/**
- * INPUT  ▸  model = {
- *            uid: "Post",       // matches src/schemas/<uid>.json (letters, numbers, underscores)
- *            pascal: "Post",    // pascalCase(uid), used for generated type names
- *            fields: {key: {type, required?, multiple?, many?, target?, targetPascal?}},
- *            relationImports: [{uid, pascal}]  // relation targets other than this schema
- *          }
- */
-%>
-// AUTO-GENERATED ⚠️ – do not edit by hand
-import { <% if (!model.isSingleton) { %>useInfiniteQuery, <% } %>useSuspenseQuery, useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-<% if (!model.isSingleton) { -%>
-import type { InfiniteData, UseInfiniteQueryResult, UseQueryResult, UseSuspenseQueryResult } from "@tanstack/react-query";
+// AUTO-GENERATED by `fimo` from src/schemas/<%= model.uid %>.json - DO NOT EDIT.
+// Change content fields in the schema, then run `fimo validate`.
+// Runtime implementation lives in the project-local fimo/ui package.
+<% if (model.isSingleton) { -%>
+import { createSingletonClient } from "fimo/ui";
+import type { SingletonContentClient } from "fimo/ui";
+<% } else { -%>
+import { createContentClient } from "fimo/ui";
+import type { CollectionContentClient } from "fimo/ui";
 <% } -%>
-import { FimoString, FimoMedia, FimoBoolean, FimoRichText, useLocale<% if (!model.isSingleton) { %>, parseCollectionResponse<% } %> } from "fimo/ui";
-// @ts-ignore - virtual module provided by Fimo's Vite plugin
-import fimoConfig from "virtual:fimo-config";
-import type { <%= model.pascal %>, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Result<% if (!model.isSingleton) { %>, <%= model.pascal %>Fields, <%= model.pascal %>Query<% } %> } from "./<%= model.pascal %>.types";
+
+import schema from "./<%= model.uid %>.json";
 <%
 if (model.referenceImports && model.referenceImports.length > 0) {
   model.referenceImports.forEach((referenceImport) => {
 -%>
-import { wrapWithSource as wrap<%= referenceImport.pascal %>WithSource } from "./<%= referenceImport.pascal %>";
+import * as <%= referenceImport.pascal %> from "./<%= referenceImport.pascal %>";
 <%
   });
 }
+if (model.isSingleton) {
 -%>
-export type { <%= model.pascal %>, <%= model.pascal %>Fields, <%= model.pascal %>FimoMeta, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Query, <%= model.pascal %>References, <%= model.pascal %>Result, <%= model.pascal %>Sort, <%= model.pascal %>Where } from "./<%= model.pascal %>.types";
-
-/*───────────────────────────────────────────────────────────────*/
-/*  ────────────  🎁  Source wrapping  ────────────              */
-/*───────────────────────────────────────────────────────────────*/
-
-/**
- * Wraps raw API data with Fimo types for source tracking
- */
-export function wrapWithSource(entry: Record<string, any>): <%= model.pascal %> {
-  const id = entry.id;
-  const entryId = entry.entryId;
-  const documentId = entry.documentId ?? id;
-  const locale = entry.locale ?? defaultLocale();
-  const sourcePrefix = `<%= model.pascal %>.id:${id}:${encodeURIComponent(locale)}`;
-  const entryFimo = entry.__fimo && typeof entry.__fimo === "object" ? entry.__fimo : {};
-
-  return {
-    id,
-    entryId,
-    documentId,
-    slug: entry.slug != null ? new FimoString(entry.slug, `${sourcePrefix}.slug`) : entry.slug,
-<% if (!model.isSingleton || model.localized) { -%>
-    locale,
-<% } else { -%>
-    ...(entry.locale ? { locale } : {}),
-<% } -%>
-    createdAt: entry.createdAt,
-    updatedAt: entry.updatedAt,
-    __fimo: {
-      contentType: typeof entryFimo.contentType === "string" ? entryFimo.contentType : "<%= model.uid %>",
-    },
-<%
-if (model.fields) {
-  Object.entries(model.fields).forEach(([key, field]) => {
-    const fieldSource = `\${sourcePrefix}.${key}`;
-    switch(field.type) {
-      case 'string':
--%>
-    <%= key %>: entry.<%= key %> != null ? new FimoString(entry.<%= key %>, `<%= fieldSource %>`) : entry.<%= key %>,
-<%
-        break;
-      case 'richtext':
--%>
-    <%= key %>: entry.<%= key %> != null ? new FimoRichText(entry.<%= key %>, `<%= fieldSource %>`) : entry.<%= key %>,
-<%
-        break;
-      case 'boolean':
--%>
-    <%= key %>: entry.<%= key %> != null ? new FimoBoolean(entry.<%= key %>, `<%= fieldSource %>`) : entry.<%= key %>,
-<%
-        break;
-      case 'media':
-        if (field.multiple) {
--%>
-    <%= key %>: entry.<%= key %>?.map((m: any, i: number) => new FimoMedia(m, `<%= fieldSource %>[${i}]`)) ?? entry.<%= key %>,
-<%
-        } else {
--%>
-    <%= key %>: entry.<%= key %> != null ? new FimoMedia(entry.<%= key %>, `<%= fieldSource %>`) : entry.<%= key %>,
-<%
-        }
-        break;
-      case 'reference': {
-        if (Array.isArray(field.targetRefs) && field.targetRefs.length > 0) {
-          const wrapperFor = (ref) => ref.uid === model.uid ? 'wrapWithSource' : `wrap${ref.pascal}WithSource`;
-          const wrappers = `{ ${field.targetRefs.map((ref) => `"${ref.uid}": ${wrapperFor(ref)}`).join(', ')} }`;
-          if (field.many) {
--%>
-    <%= key %>: Array.isArray(entry.<%= key %>) ? entry.<%= key %>.map((value: any) => wrapPolymorphic(value, <%= wrappers %>)) : entry.<%= key %>,
-<%
-          } else {
--%>
-    <%= key %>: wrapPolymorphic(entry.<%= key %>, <%= wrappers %>),
-<%
-          }
-          break;
-        }
-        const wrapper = field.target === model.uid ? 'wrapWithSource' : `wrap${field.targetPascal}WithSource`;
-        if (field.many) {
--%>
-    <%= key %>: Array.isArray(entry.<%= key %>) ? entry.<%= key %>.map((value: any) => isPopulatedEntry(value) ? <%= wrapper %>(value) : value) : entry.<%= key %>,
-<%
-        } else {
--%>
-    <%= key %>: isPopulatedEntry(entry.<%= key %>) ? <%= wrapper %>(entry.<%= key %>) : entry.<%= key %>,
-<%
-        }
-        break;
-      }
-      default:
--%>
-    <%= key %>: entry.<%= key %>,
-<%
-    }
-  });
-}
--%>
-  } as <%= model.pascal %>;
-}
-
-interface PopulatedEntryRecord extends Record<string, unknown> {
-  id: string;
-  __fimo: { contentType: string };
-}
-
-function isPopulatedEntry(value: unknown): value is PopulatedEntryRecord {
-  if (value == null || typeof value !== "object") {
-    return false;
-  }
-  const entry = value as Record<string, unknown>;
-  const fimo = entry.__fimo;
-  return typeof entry.id === "string"
-    && fimo != null
-    && typeof fimo === "object"
-    && typeof (fimo as Record<string, unknown>).contentType === "string";
-}
-
-<%
-const hasPolymorphicReferences = model.fields && Object.values(model.fields).some((field) => field.type === 'reference' && Array.isArray(field.targetRefs) && field.targetRefs.length > 0);
-if (hasPolymorphicReferences) {
--%>
-/**
- * Wraps one polymorphic reference value. Populated entries carry their type
- * marker; the wrapper picks the right per-type wrapping and stamps a
- * top-level $type so the generated union narrows in a switch. Raw
- * (unpopulated) values pass through untouched.
- */
-function wrapPolymorphic(value: any, wrappers: Record<string, (entry: Record<string, any>) => any>): any {
-  if (!isPopulatedEntry(value)) {
-    return value;
-  }
-  const contentType = value.__fimo && typeof value.__fimo.contentType === "string" ? value.__fimo.contentType : null;
-  const wrapper = contentType ? wrappers[contentType] : undefined;
-  if (!wrapper) return value;
-  const wrapped = wrapper(value) as Record<string, unknown>;
-  wrapped.$type = contentType;
-  return wrapped;
-}
-
-<%
-}
--%>
-/*───────────────────────────────────────────────────────────────*/
-/*  ────────────  🔌  Low-level fetch helpers  ────────────      */
-/*───────────────────────────────────────────────────────────────*/
-// @ts-ignore - meta.env is a vite feature
-const base = import.meta.env.VITE_API_URL;
-
-function defaultLocale(): string {
-  return (fimoConfig as { i18n?: { defaultLocale?: string } }).i18n?.defaultLocale ?? "en";
-}
-
-function useQueryLocale(locale?: string): string {
-  const activeLocale = useLocale().locale;
-  return locale ?? activeLocale ?? defaultLocale();
-}
-
-function withMutationLocale<T extends object>(payload: T, activeLocale: string): T & { locale: string } {
-  const locale = (payload as { locale?: string }).locale;
-  return { ...payload, locale: locale ?? activeLocale };
-}
-
-const LOCALIZED_CONTENT = <%= model.localized ? 'true' : 'false' %>;
-const LOCALIZED_REFERENCE_FIELDS = new Set<string>(<%= JSON.stringify(model.localizedReferenceFields) %>);
-
-function populateFields(populate: <%= model.pascal %>Populate | undefined): string[] {
-  if (populate == null) return [];
-  return typeof populate === "string" ? [populate] : [...populate];
-}
-
-function readLocale(
-  options: { locale?: string; populate?: <%= model.pascal %>Populate },
-  ownerUsesLocale: boolean,
-  fallbackLocale = defaultLocale()
-): string | undefined {
-<% if (!model.isSingleton) { -%>
-  return options.locale ?? fallbackLocale;
+import type { <%= model.pascal %>, <%= model.pascal %>Input } from "./<%= model.pascal %>.types";
 <% } else { -%>
-  const populatesLocalizedTarget = populateFields(options.populate).some((field) => LOCALIZED_REFERENCE_FIELDS.has(field));
-  return ownerUsesLocale || populatesLocalizedTarget ? options.locale ?? fallbackLocale : undefined;
+import type { <%= model.pascal %>, <%= model.pascal %>Fields, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Query } from "./<%= model.pascal %>.types";
 <% } -%>
-}
-
-function fimoHeaders(extra?: Record<string, string>): Record<string, string> {
-  const h: Record<string, string> = { ...extra };
-  // @ts-ignore
-  const branch = import.meta.env.VITE_FIMO_BRANCH;
-  if (branch) h["X-Fimo-Branch"] = branch;
-  return h;
-}
-
-function withReadOptions<TPopulate extends <%= model.pascal %>Populate | undefined>(
-  url: string,
-  options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {},
-  ownerUsesLocale = LOCALIZED_CONTENT
-): string {
-  const u = new URL(url, "http://fimo.local");
-  const locale = readLocale(options, ownerUsesLocale);
-  if (locale) u.searchParams.set("locale", locale);
-  if (options.populate != null) {
-    u.searchParams.set("populate", typeof options.populate === "string" ? options.populate : options.populate.join(","));
-  }
-  if (options.localeFallbacks) u.searchParams.set("localeFallbacks", "true");
-  return `${u.pathname}${u.search}`;
-}
-
-function splitWritePayload(payload: Partial<<%= model.pascal %>Input>): Record<string, unknown> {
-  const {
-    id,
-    entryId,
-    documentId,
-    locale,
-    createdAt,
-    updatedAt,
-    ...data
-  } = payload as Record<string, unknown>;
-  delete data.__fimo;
-
-  return {
-    data,
-    ...(typeof locale === "string" && locale.length > 0 ? { locale } : {}),
-    ...(typeof documentId === "string" && documentId.length > 0 ? { documentId } : {}),
-  };
-}
 
+export type { <%= model.pascal %>, <%= model.pascal %>Fields, <%= model.pascal %>FimoMeta, <%= model.pascal %>Input, <%= model.pascal %>Populate, <%= model.pascal %>Query, <%= model.pascal %>References, <%= model.pascal %>Result, <%= model.pascal %>Sort, <%= model.pascal %>Where } from "./<%= model.pascal %>.types";
 <% if (!model.isSingleton) { -%>
-export interface CollectionPageInfo {
-  readonly limit: number;
-  readonly offset: number;
-  readonly total: number;
-  readonly hasMore: boolean;
-  readonly nextOffset: number | null;
-}
-
-export interface CollectionPage<TItem> {
-  readonly items: TItem[];
-  readonly pageInfo: CollectionPageInfo;
-}
-
+export type { CollectionPage, CollectionPageInfo, InfiniteListResult } from "fimo/ui";
 export type InfiniteListQuery<
   TFields extends <%= model.pascal %>Fields | undefined = undefined,
   TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
 > = Omit<<%= model.pascal %>Query<TFields, TPopulate>, "offset">;
-
-export type InfiniteListResult<TItem> = UseInfiniteQueryResult<
-  InfiniteData<CollectionPage<TItem>>,
-  Error
-> & {
-  readonly items: TItem[];
-  readonly total: number;
-  readonly hasMore: boolean;
-  readonly loadMore: () => ReturnType<
-    UseInfiniteQueryResult<InfiniteData<CollectionPage<TItem>>, Error>["fetchNextPage"]
-  >;
-  readonly isLoadingMore: boolean;
-};
-
-export async function getById<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(
-  id: string,
-  options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}
-): Promise<<%= model.pascal %>Result<undefined, TPopulate>> {
-  const res = await fetch(`${base}${withReadOptions(`/entries/<%= model.uid %>/${id}`, options)}`, { headers: fimoHeaders() });
-  if (!res.ok) throw new Error(await res.text());
-  const data = await res.json();
-  return wrapWithSource(data.data) as <%= model.pascal %>Result<undefined, TPopulate>;
-}
-
-export async function getBySlug<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(
-  slug: string,
-  options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}
-): Promise<<%= model.pascal %>Result<undefined, TPopulate> | null> {
-  const res = await fetch(`${base}${withReadOptions(`/entries/<%= model.uid %>/slug/${encodeURIComponent(slug)}`, options)}`, { headers: fimoHeaders() });
-  if (res.status === 404) return null;
-  if (!res.ok) throw new Error(await res.text());
-  const data = await res.json();
-  return wrapWithSource(data.data) as <%= model.pascal %>Result<undefined, TPopulate>;
-}
-
-export async function getByField<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(
-  fieldName: string,
-  value: string,
-  options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}
-): Promise<<%= model.pascal %>Result<undefined, TPopulate> | null> {
-  const res = await fetch(`${base}${withReadOptions(`/entries/<%= model.uid %>/field/${encodeURIComponent(fieldName)}/${encodeURIComponent(value)}`, options)}`, { headers: fimoHeaders() });
-  if (res.status === 404) return null;
-  if (!res.ok) throw new Error(await res.text());
-  const data = await res.json();
-  return wrapWithSource(data.data) as <%= model.pascal %>Result<undefined, TPopulate>;
-}
-
-function toQueryString<
-  TFields extends <%= model.pascal %>Fields | undefined = undefined,
-  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
->(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>): string {
-  const { where, sort, fields, populate, locale: requestedLocale, ...flat } = params;
-  const query = new URLSearchParams();
-
-  for (const [key, value] of Object.entries(flat)) {
-    if (value == null) continue;
-    query.set(key, String(value));
-  }
-
-  if (sort != null) {
-    query.set("sort", Array.isArray(sort) ? sort.join(",") : sort);
-  }
-
-  if (fields != null) {
-    query.set("fields", typeof fields === "string" ? fields : fields.join(","));
-  }
-
-  if (populate != null) {
-    query.set("populate", typeof populate === "string" ? populate : populate.join(","));
-  }
-
-  if (where && Object.keys(where).length > 0) {
-    query.set("where", JSON.stringify(where));
-  }
-
-  const locale = readLocale({ locale: requestedLocale, populate }, LOCALIZED_CONTENT);
-  if (locale) query.set("locale", locale);
-
-  return query.toString();
-}
-
-export async function list<
-  TFields extends <%= model.pascal %>Fields | undefined = undefined,
-  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
->(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>): Promise<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>> {
-  const qs = toQueryString(params);
-  const res = await fetch(`${base}/entries/<%= model.uid %>${qs ? "?" + qs : ""}`, { headers: fimoHeaders() });
-  if (!res.ok) throw new Error(await res.text());
-  const data = parseCollectionResponse(await res.json());
-  const items = data.data.map(wrapWithSource) as <%= model.pascal %>Result<TFields, TPopulate>[];
-  const pageInfo: CollectionPageInfo = {
-    limit: data.meta.limit,
-    offset: data.meta.offset,
-    total: data.meta.total,
-    hasMore: data.meta.hasMore,
-    nextOffset: data.meta.hasMore ? data.meta.offset + data.meta.limit : null,
-  };
-  return { items, pageInfo };
-}
-
-export async function get<
-  TFields extends <%= model.pascal %>Fields | undefined = undefined,
-  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
->(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>): Promise<<%= model.pascal %>Result<TFields, TPopulate>[]> {
-  return (await list(params)).items;
-}
-
-export async function create(payload: <%= model.pascal %>Input): Promise<<%= model.pascal %>> {
-  const res = await fetch(`${base}/entries/<%= model.uid %>`, {
-    method: "POST",
-    headers: fimoHeaders({ "Content-Type": "application/json" }),
-    body: JSON.stringify(splitWritePayload(payload))
-  });
-  if (!res.ok) throw new Error(await res.text());
-  const data = await res.json();
-  return wrapWithSource(data.data);
-}
-
-export async function update(id: string, payload: Partial<<%= model.pascal %>Input>): Promise<<%= model.pascal %>> {
-  const write = splitWritePayload(payload) as { data: Record<string, unknown>; locale?: string };
-  const url = withReadOptions(`/entries/<%= model.uid %>/${id}`, { locale: write.locale });
-  const res = await fetch(`${base}${url}`, {
-    method: "PUT",
-    headers: fimoHeaders({ "Content-Type": "application/json" }),
-    body: JSON.stringify({ data: write.data })
-  });
-  if (!res.ok) throw new Error(await res.text());
-  const data = await res.json();
-  return wrapWithSource(data.data);
-}
-
-export async function remove(id: string, options: { locale?: string } = {}): Promise<void> {
-  const url = withReadOptions(`/entries/<%= model.uid %>/${id}`, options);
-  const res = await fetch(`${base}${url}`, { method: "DELETE", headers: fimoHeaders() });
-  if (!res.ok) throw new Error(await res.text());
-}
-<% } else { -%>
-export async function get<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(
-  options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}
-): Promise<<%= model.pascal %>Result<undefined, TPopulate>> {
-  const res = await fetch(`${base}${withReadOptions(`/documents/<%= model.uid %>`, options)}`, { headers: fimoHeaders() });
-  if (!res.ok) throw new Error(await res.text());
-  const data = await res.json();
-  return wrapWithSource(data.data) as <%= model.pascal %>Result<undefined, TPopulate>;
-}
-
-export async function update(payload: Partial<<%= model.pascal %>Input>): Promise<<%= model.pascal %>> {
-  const write = splitWritePayload(payload) as { data: Record<string, unknown>; locale?: string };
-  const url = withReadOptions(`/documents/<%= model.uid %>`, { locale: write.locale });
-  const res = await fetch(`${base}${url}`, {
-    method: "PUT",
-    headers: fimoHeaders({ "Content-Type": "application/json" }),
-    body: JSON.stringify({ data: write.data })
-  });
-  if (!res.ok) throw new Error(await res.text());
-  const data = await res.json();
-  return wrapWithSource(data.data);
-}
 <% } -%>
 
-/*───────────────────────────────────────────────────────────────*/
-/*  ────────────  🍯  React-Query hooks  ────────────            */
-/*───────────────────────────────────────────────────────────────*/
-
-<% if (!model.isSingleton) { -%>
-const qk = {
-  root       : ["<%= model.pascal %>"] as const,
-  byId       : <TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(id: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) => ["<%= model.pascal %>", "id", id, options.locale, options.populate] as const,
-  bySlug     : <TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(slug: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) => ["<%= model.pascal %>", "slug", slug, options.locale, options.populate] as const,
-  byField    : <TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(field: string, value: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) => ["<%= model.pascal %>", field, value, options.locale, options.populate] as const,
-  list       : (params: <%= model.pascal %>Query) => ["<%= model.pascal %>", params] as const,
-  infiniteList: <
-    TFields extends <%= model.pascal %>Fields | undefined = undefined,
-    TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
-  >(params: InfiniteListQuery<TFields, TPopulate>) => ["<%= model.pascal %>", "infinite", params] as const
-};
-
-export function useGetById<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(id: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}): UseQueryResult<<%= model.pascal %>Result<undefined, TPopulate>, Error> {
-  const locale = useQueryLocale(options.locale);
-  const localizedOptions = { ...options, locale };
-  return useQuery<<%= model.pascal %>Result<undefined, TPopulate>, Error>({ queryKey: qk.byId(id, localizedOptions), queryFn: () => getById(id, localizedOptions) });
-}
-
-export function useGetBySlug<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(slug: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) {
-  const locale = readLocale(options, LOCALIZED_CONTENT, useQueryLocale(options.locale));
-  const localizedOptions = { ...options, locale };
-  return useQuery<<%= model.pascal %>Result<undefined, TPopulate> | null, Error>({ queryKey: qk.bySlug(slug, localizedOptions), queryFn: () => getBySlug(slug, localizedOptions), enabled: !!slug });
-}
-
-export function useGetByField<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(fieldName: string, value: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) {
-  const locale = readLocale(options, LOCALIZED_CONTENT, useQueryLocale(options.locale));
-  const localizedOptions = { ...options, locale };
-  return useQuery<<%= model.pascal %>Result<undefined, TPopulate> | null, Error>({ queryKey: qk.byField(fieldName, value, localizedOptions), queryFn: () => getByField(fieldName, value, localizedOptions), enabled: !!value });
-}
-
-export function useGet<
-  TFields extends <%= model.pascal %>Fields | undefined = undefined,
-  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
->(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>) {
-  const locale = readLocale(params, LOCALIZED_CONTENT, useQueryLocale(params.locale));
-  const localizedParams = { ...params, locale };
-  return useQuery<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>, Error, <%= model.pascal %>Result<TFields, TPopulate>[]>({
-    queryKey: qk.list(localizedParams),
-    queryFn: () => list(localizedParams),
-    select: (page) => page.items,
-  });
-}
-
-export function useList<
-  TFields extends <%= model.pascal %>Fields | undefined = undefined,
-  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
->(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>): UseQueryResult<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>, Error> {
-  const locale = readLocale(params, LOCALIZED_CONTENT, useQueryLocale(params.locale));
-  const localizedParams = { ...params, locale };
-  return useQuery<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>, Error>({
-    queryKey: qk.list(localizedParams),
-    queryFn: () => list(localizedParams),
-  });
-}
-
-export function useInfiniteList<
-  TFields extends <%= model.pascal %>Fields | undefined = undefined,
-  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
->(params: InfiniteListQuery<TFields, TPopulate> = {} as InfiniteListQuery<TFields, TPopulate>): InfiniteListResult<<%= model.pascal %>Result<TFields, TPopulate>> {
-  const locale = readLocale(params, LOCALIZED_CONTENT, useQueryLocale(params.locale));
-  const localizedParams = { ...params, locale };
-  const query = useInfiniteQuery({
-    queryKey: qk.infiniteList(localizedParams),
-    queryFn: ({ pageParam }) => list({ ...localizedParams, offset: pageParam }),
-    initialPageParam: 0,
-    getNextPageParam: (lastPage) => lastPage.pageInfo.nextOffset ?? undefined,
-  });
-
-  return {
-    ...query,
-    items: query.data?.pages.flatMap((page) => page.items) ?? [],
-    total: query.data?.pages[0]?.pageInfo.total ?? 0,
-    hasMore: query.hasNextPage,
-    loadMore: () => query.fetchNextPage(),
-    isLoadingMore: query.isFetchingNextPage,
-  };
-}
-
-export function useSuspenseGetById<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(id: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}): UseSuspenseQueryResult<<%= model.pascal %>Result<undefined, TPopulate>, Error> {
-  const locale = useQueryLocale(options.locale);
-  const localizedOptions = { ...options, locale };
-  return useSuspenseQuery<<%= model.pascal %>Result<undefined, TPopulate>, Error>({ queryKey: qk.byId(id, localizedOptions), queryFn: () => getById(id, localizedOptions) });
-}
-
-export function useSuspenseGetBySlug<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(slug: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) {
-  const locale = readLocale(options, LOCALIZED_CONTENT, useQueryLocale(options.locale));
-  const localizedOptions = { ...options, locale };
-  return useSuspenseQuery<<%= model.pascal %>Result<undefined, TPopulate> | null, Error>({ queryKey: qk.bySlug(slug, localizedOptions), queryFn: () => getBySlug(slug, localizedOptions) });
-}
-
-export function useSuspenseGetByField<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(fieldName: string, value: string, options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) {
-  const locale = readLocale(options, LOCALIZED_CONTENT, useQueryLocale(options.locale));
-  const localizedOptions = { ...options, locale };
-  return useSuspenseQuery<<%= model.pascal %>Result<undefined, TPopulate> | null, Error>({ queryKey: qk.byField(fieldName, value, localizedOptions), queryFn: () => getByField(fieldName, value, localizedOptions) });
-}
-
-export function useSuspenseGet<
-  TFields extends <%= model.pascal %>Fields | undefined = undefined,
-  TPopulate extends <%= model.pascal %>Populate | undefined = undefined,
->(params: <%= model.pascal %>Query<TFields, TPopulate> = {} as <%= model.pascal %>Query<TFields, TPopulate>) {
-  const locale = readLocale(params, LOCALIZED_CONTENT, useQueryLocale(params.locale));
-  const localizedParams = { ...params, locale };
-  return useSuspenseQuery<CollectionPage<<%= model.pascal %>Result<TFields, TPopulate>>, Error, <%= model.pascal %>Result<TFields, TPopulate>[]>({
-    queryKey: qk.list(localizedParams),
-    queryFn: () => list(localizedParams),
-    select: (page) => page.items,
-  });
-}
-
-export function useCreate() {
-  const qc = useQueryClient();
-  const activeLocale = useQueryLocale();
-  return useMutation<<%= model.pascal %>, Error, <%= model.pascal %>Input>({
-    mutationFn   : (payload) => create(withMutationLocale(payload, activeLocale)),
-    onSuccess    : () => qc.invalidateQueries({ queryKey: qk.root })
-  });
-}
-
-export function useUpdate() {
-  const qc = useQueryClient();
-  const activeLocale = useQueryLocale();
-  return useMutation<<%= model.pascal %>, Error, { id: string; locale?: string } & Partial<<%= model.pascal %>Input>>({
-    mutationFn   : ({ id, ...patch }) => update(id, withMutationLocale(patch, activeLocale)),
-    onSuccess    : (_data, vars) => {
-      qc.invalidateQueries({ queryKey: qk.root });
-      qc.invalidateQueries({ queryKey: qk.byId(vars.id, { locale: vars.locale ?? activeLocale }) });
-    }
-  });
-}
-
-export function useRemove() {
-  const qc = useQueryClient();
-  const activeLocale = useQueryLocale();
-  return useMutation<void, Error, string | { id: string; locale?: string }>({
-    mutationFn   : (value) => {
-      const { id, locale } = typeof value === "string" ? { id: value, locale: activeLocale } : { ...value, locale: value.locale ?? activeLocale };
-      return remove(id, { locale });
-    },
-    onSuccess    : (_data, value) => {
-      const { id, locale } = typeof value === "string" ? { id: value, locale: activeLocale } : { ...value, locale: value.locale ?? activeLocale };
-      qc.invalidateQueries({ queryKey: qk.root });
-      qc.removeQueries({ queryKey: qk.byId(id, { locale }), exact: false });
-    }
-  });
-}
+<% if (model.isSingleton) { -%>
+const client: SingletonContentClient<<%= model.pascal %>, <%= model.pascal %>Input> = createSingletonClient<
+  <%= model.pascal %>,
+  <%= model.pascal %>Input
+>({
+  schema,
 <% } else { -%>
-const qk = {
-  root: ["<%= model.pascal %>"] as const,
-  document: <TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) => ["<%= model.pascal %>", "document", options.locale, options.populate] as const
-};
-
-export function useGet<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) {
-  const locale = readLocale(options, LOCALIZED_CONTENT, useQueryLocale(options.locale));
-  const localizedOptions = { ...options, locale };
-  return useQuery<<%= model.pascal %>Result<undefined, TPopulate>, Error>({ queryKey: qk.document(localizedOptions), queryFn: () => get(localizedOptions) });
-}
-
-export function useSuspenseGet<TPopulate extends <%= model.pascal %>Populate | undefined = undefined>(options: { locale?: string; populate?: TPopulate; localeFallbacks?: boolean } = {}) {
-  const locale = readLocale(options, LOCALIZED_CONTENT, useQueryLocale(options.locale));
-  const localizedOptions = { ...options, locale };
-  return useSuspenseQuery<<%= model.pascal %>Result<undefined, TPopulate>, Error>({ queryKey: qk.document(localizedOptions), queryFn: () => get(localizedOptions) });
-}
-
-export function useUpdate() {
-  const qc = useQueryClient();
-  const activeLocale = useQueryLocale();
-  return useMutation<<%= model.pascal %>, Error, Partial<<%= model.pascal %>Input>>({
-    mutationFn: (payload) => update(withMutationLocale(payload, activeLocale)),
-    onSuccess: () => qc.invalidateQueries({ queryKey: qk.root })
-  });
-}
+const client: CollectionContentClient<<%= model.pascal %>, <%= model.pascal %>Input> = createContentClient<
+  <%= model.pascal %>,
+  <%= model.pascal %>Input
+>({
+  schema,
 <% } -%>
+<% if (model.referenceImports && model.referenceImports.length > 0) { -%>
+  references: { <%= model.referenceImports.map((referenceImport) => referenceImport.pascal).join(", ") %> },
+<% } -%>
+});
 
-/*───────────────────────────────────────────────────────────────*/
-/*  ────────────  🎯  Default export  ────────────               */
-/*───────────────────────────────────────────────────────────────*/
-
-export default {
-<% if (!model.isSingleton) { -%>
-  /* async helpers */
+<% if (model.isSingleton) { -%>
+export const { get, update, useGet, useSuspenseGet, useUpdate, wrapWithSource, meta } = client;
+<% } else { -%>
+export const {
+  wrapWithSource,
+  meta,
   getById,
   getBySlug,
   getByField,
@@ -623,8 +66,6 @@ export default {
   create,
   update,
   remove,
-
-  /* hooks */
   useGetById,
   useGetBySlug,
   useGetByField,
@@ -637,12 +78,8 @@ export default {
   useSuspenseGetBySlug,
   useCreate,
   useUpdate,
-  useRemove
-<% } else { -%>
-  get,
-  update,
-  useGet,
-  useSuspenseGet,
-  useUpdate
+  useRemove,
+} = client;
 <% } -%>
-};
+
+export default client;