@better-i18n/mcp-types 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-i18n/mcp-types",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Type definitions and schemas for Better i18n MCP API",
   "type": "module",
   "main": "./src/index.ts",

package/src/client-types.ts

@@ -20,13 +20,21 @@ import type {
   PublishInput,
 } from "./schemas";
 
+import type {
+  ListContentModelsInput,
+  GetContentModelInput,
+  ListContentEntriesInput,
+  GetContentEntryInput,
+  CreateContentEntryInput,
+  UpdateContentEntryInput,
+  PublishContentEntryInput,
+  DeleteContentEntryInput,
+} from "./content-schemas";
+
 import type {
   ListProjectsResponse,
   GetAllTranslationsResponse,
   ListKeysResponse,
-  CreateKeysResponse,
-  UpdateKeysResponse,
-  DeleteKeysResponse,
   AddLanguageResponse,
   PublishResponse,
 } from "./types";
@@ -36,8 +44,22 @@ import type {
   CompactGetPendingChangesResponse,
   CompactGetSyncsResponse,
   CompactGetSyncResponse,
+  CompactCreateKeysResponse,
+  CompactUpdateKeysResponse,
+  CompactDeleteKeysResponse,
 } from "./compact-types";
 
+import type {
+  CompactListContentModelsResponse,
+  CompactGetContentModelResponse,
+  CompactListContentEntriesResponse,
+  CompactContentEntryDetail,
+  CompactCreateContentEntryResponse,
+  CompactUpdateContentEntryResponse,
+  CompactPublishContentEntryResponse,
+  CompactDeleteContentEntryResponse,
+} from "./content-compact-types";
+
 /**
  * MCP API client interface.
  *
@@ -59,7 +81,6 @@ import type {
  * - getSync - Returns CompactGetSyncResponse
  *
  * **Verbose Endpoints (unchanged):**
- * - All write operations (createKeys, updateKeys, deleteKeys)
  * - listProjects, getAllTranslations, listKeys
  * - publishTranslations
  */
@@ -79,13 +100,13 @@ export interface MCPClient {
     query: (input: ListKeysInput) => Promise<ListKeysResponse>;
   };
   createKeys: {
-    mutate: (input: CreateKeysInput) => Promise<CreateKeysResponse>;
+    mutate: (input: CreateKeysInput) => Promise<CompactCreateKeysResponse>;
   };
   updateKeys: {
-    mutate: (input: UpdateKeysInput) => Promise<UpdateKeysResponse>;
+    mutate: (input: UpdateKeysInput) => Promise<CompactUpdateKeysResponse>;
   };
   deleteKeys: {
-    mutate: (input: DeleteKeysInput) => Promise<DeleteKeysResponse>;
+    mutate: (input: DeleteKeysInput) => Promise<CompactDeleteKeysResponse>;
   };
   addLanguage: {
     mutate: (input: AddLanguageInput) => Promise<AddLanguageResponse>;
@@ -107,8 +128,64 @@ export interface MCPClient {
 }
 
 /**
- * Full API client interface with mcp namespace.
+ * MCP Content API client interface.
+ *
+ * Provides type-safe access to content MCP endpoints.
+ * All responses use compact format for AI token efficiency.
+ *
+ * **Read endpoints:**
+ * - listContentModels, getContentModel, listContentEntries, getContentEntry
+ *
+ * **Write endpoints:**
+ * - createContentEntry, updateContentEntry, publishContentEntry, deleteContentEntry
+ */
+export interface MCPContentClient {
+  listContentModels: {
+    query: (
+      input: ListContentModelsInput,
+    ) => Promise<CompactListContentModelsResponse>;
+  };
+  getContentModel: {
+    query: (
+      input: GetContentModelInput,
+    ) => Promise<CompactGetContentModelResponse>;
+  };
+  listContentEntries: {
+    query: (
+      input: ListContentEntriesInput,
+    ) => Promise<CompactListContentEntriesResponse>;
+  };
+  getContentEntry: {
+    query: (
+      input: GetContentEntryInput,
+    ) => Promise<CompactContentEntryDetail>;
+  };
+  createContentEntry: {
+    mutate: (
+      input: CreateContentEntryInput,
+    ) => Promise<CompactCreateContentEntryResponse>;
+  };
+  updateContentEntry: {
+    mutate: (
+      input: UpdateContentEntryInput,
+    ) => Promise<CompactUpdateContentEntryResponse>;
+  };
+  publishContentEntry: {
+    mutate: (
+      input: PublishContentEntryInput,
+    ) => Promise<CompactPublishContentEntryResponse>;
+  };
+  deleteContentEntry: {
+    mutate: (
+      input: DeleteContentEntryInput,
+    ) => Promise<CompactDeleteContentEntryResponse>;
+  };
+}
+
+/**
+ * Full API client interface with mcp and mcpContent namespaces.
  */
 export interface APIClient {
   mcp: MCPClient;
+  mcpContent: MCPContentClient;
 }

package/src/compact-types.ts

@@ -17,7 +17,7 @@
  * { prj: "acme/main", sl: "en", tk: 150 }
  */
 
-import type { SyncJobType, SyncJobStatus } from "./types";
+import type { SyncJobType, SyncJobStatus, PendingPublishHint } from "./types";
 
 // ============================================================================
 // Compact Project Types
@@ -319,3 +319,117 @@ export interface CompactGetSyncResponse {
   /** Affected keys */
   aff_k: CompactAffectedKey[];
 }
+
+// ============================================================================
+// Compact Write Response Types (createKeys, updateKeys, deleteKeys)
+// ============================================================================
+
+/**
+ * Compact pending publish hint.
+ *
+ * Field Mappings:
+ * - has: hasChanges
+ * - cnt: count
+ * - hint: hint (unchanged - already useful)
+ */
+export interface CompactPendingPublishHint {
+  /** Whether there are unpublished changes */
+  has: boolean;
+  /** Number of pending changes */
+  cnt: number;
+  /** Hint message for AI */
+  hint: string;
+}
+
+/**
+ * Compact response from createKeys endpoint.
+ *
+ * Field Mappings:
+ * - ok: success
+ * - cnt: keysCreated
+ * - new: created
+ * - ren: renamed
+ * - dup: duplicates
+ * - k: keys array [{ k, id, tr }]
+ * - skip: skipped
+ * - pub: pendingPublish
+ */
+export interface CompactCreateKeysResponse {
+  /** Operation success */
+  ok: boolean;
+  /** Total keys created */
+  cnt: number;
+  /** New keys inserted */
+  new: number;
+  /** Soft-deleted keys renamed */
+  ren: number;
+  /** Duplicate keys skipped */
+  dup: number;
+  /** Created keys */
+  k: Array<{
+    /** Key name */
+    k: string;
+    /** Key UUID */
+    id: string;
+    /** Translations added count */
+    tr: number;
+  }>;
+  /** Skipped keys */
+  skip?: Array<{ k: string; reason: string }>;
+  /** Pending publish hint */
+  pub?: CompactPendingPublishHint;
+}
+
+/**
+ * Compact response from updateKeys endpoint.
+ *
+ * Field Mappings:
+ * - ok: success
+ * - cnt: keysUpdated
+ * - upd: updates array [{ k, lng, src }]
+ * - pub: pendingPublish
+ */
+export interface CompactUpdateKeysResponse {
+  /** Operation success */
+  ok: boolean;
+  /** Number of keys updated */
+  cnt: number;
+  /** Updated key details */
+  upd: Array<{
+    /** Key name */
+    k: string;
+    /** Languages updated */
+    lng: string[];
+    /** Source text updated */
+    src: boolean;
+  }>;
+  /** Pending publish hint */
+  pub?: CompactPendingPublishHint;
+}
+
+/**
+ * Compact response from deleteKeys endpoint.
+ *
+ * Field Mappings:
+ * - ok: success
+ * - cnt: markedCount
+ * - mk: marked keys [{ id, k, ns }]
+ * - skip: skipped key IDs
+ */
+export interface CompactDeleteKeysResponse {
+  /** Operation success */
+  ok: boolean;
+  /** Number of keys marked for deletion */
+  cnt: number;
+  /** Marked keys */
+  mk: Array<{
+    /** Key UUID */
+    id: string;
+    /** Key name */
+    k: string;
+    /** Namespace */
+    ns: string | null;
+  }>;
+  /** Skipped key IDs (not found) */
+  skip?: string[];
+}

package/src/content-compact-types.ts

@@ -0,0 +1,296 @@
+/**
+ * MCP Content API Compact Types
+ *
+ * Compact field name versions of content MCP API response types
+ * for optimal AI token efficiency. 40-60% token reduction.
+ *
+ * Field Naming Convention:
+ * - dn: displayName
+ * - sl: slug
+ * - ec: entryCount
+ * - slang: sourceLanguage
+ * - langs: availableLanguages
+ * - cfv: customFieldValues
+ * - tr: translations
+ * - mdl: contentModel
+ * - pub_at: publishedAt
+ * - img: featuredImage
+ * - c_at: createdAt
+ * - u_at: updatedAt
+ * - desc: description
+ */
+
+// ============================================================================
+// Compact Content Model Types
+// ============================================================================
+
+/**
+ * Compact field definition.
+ *
+ * Field Mappings:
+ * - id: id (unchanged)
+ * - nm: name
+ * - dn: displayName
+ * - tp: type
+ * - loc: localized
+ * - req: required
+ * - ph: placeholder
+ * - ht: helpText
+ * - pos: position
+ */
+export interface CompactContentModelField {
+  id: string;
+  nm: string;
+  dn: string;
+  tp: string;
+  loc: boolean;
+  req: boolean;
+  ph: string | null;
+  ht: string | null;
+  pos: number;
+}
+
+/**
+ * Compact content model summary.
+ *
+ * Field Mappings:
+ * - id: id (unchanged)
+ * - sl: slug
+ * - dn: displayName
+ * - desc: description
+ * - kind: kind (unchanged - already short)
+ * - ico: icon
+ * - ec: entryCount
+ * - flds: fields
+ */
+export interface CompactContentModelSummary {
+  id: string;
+  sl: string;
+  dn: string;
+  desc: string | null;
+  kind: string;
+  ico: string | null;
+  ec: number;
+  flds: CompactContentModelField[];
+}
+
+/**
+ * Compact response from listContentModels.
+ */
+export interface CompactListContentModelsResponse {
+  mdls: CompactContentModelSummary[];
+}
+
+/**
+ * Compact response from getContentModel.
+ *
+ * Field Mappings:
+ * - id: id
+ * - sl: slug
+ * - dn: displayName
+ * - desc: description
+ * - kind: kind
+ * - ico: icon
+ * - vh: enableVersionHistory
+ * - flds: fields
+ */
+export interface CompactGetContentModelResponse {
+  id: string;
+  sl: string;
+  dn: string;
+  desc: string | null;
+  kind: string;
+  ico: string | null;
+  vh: boolean;
+  flds: CompactContentModelField[];
+}
+
+// ============================================================================
+// Compact Content Entry Types
+// ============================================================================
+
+/**
+ * Compact source translation summary.
+ *
+ * Field Mappings:
+ * - t: title
+ * - ex: excerpt
+ */
+export interface CompactSourceTranslationSummary {
+  t: string;
+  ex: string | null;
+}
+
+/**
+ * Compact author info.
+ *
+ * Field Mappings:
+ * - id: id
+ * - nm: name
+ * - img: image
+ */
+export interface CompactContentAuthor {
+  id: string;
+  nm: string | null;
+  img: string | null;
+}
+
+/**
+ * Compact content model reference.
+ *
+ * Field Mappings:
+ * - sl: slug
+ * - dn: displayName
+ * - kind: kind
+ */
+export interface CompactContentModelRef {
+  sl: string;
+  dn: string;
+  kind: string;
+}
+
+/**
+ * Compact content entry summary from listContentEntries.
+ *
+ * Field Mappings:
+ * - id: id
+ * - sl: slug
+ * - st: status
+ * - pub_at: publishedAt
+ * - c_at: createdAt
+ * - u_at: updatedAt
+ * - img: featuredImage
+ * - tags: tags (unchanged - already short)
+ * - mdl: contentModel
+ * - slang: sourceLanguage
+ * - src_tr: sourceTranslation
+ * - langs: availableLanguages
+ * - auth: author
+ * - cfv: customFieldValues
+ */
+export interface CompactContentEntrySummary {
+  id: string;
+  sl: string;
+  st: string;
+  pub_at: string | null;
+  c_at: string;
+  u_at: string;
+  img: string | null;
+  tags: string[];
+  mdl: CompactContentModelRef;
+  slang: string;
+  src_tr: CompactSourceTranslationSummary;
+  langs: string[];
+  auth: CompactContentAuthor | null;
+  cfv: Record<string, string | null>;
+}
+
+/**
+ * Compact response from listContentEntries.
+ *
+ * Field Mappings:
+ * - items: items (unchanged - standard pagination)
+ * - tot: total
+ * - more: hasMore
+ */
+export interface CompactListContentEntriesResponse {
+  items: CompactContentEntrySummary[];
+  tot: number;
+  more: boolean;
+}
+
+/**
+ * Compact full translation for a single language.
+ *
+ * Field Mappings:
+ * - id: id
+ * - lc: languageCode
+ * - t: title
+ * - ex: excerpt
+ * - body: body (unchanged - content payload)
+ * - mt: metaTitle
+ * - md: metaDescription
+ * - st: status
+ */
+export interface CompactContentEntryTranslation {
+  id: string;
+  lc: string;
+  t: string;
+  ex: string | null;
+  body: unknown;
+  mt: string | null;
+  md: string | null;
+  st: string;
+}
+
+/**
+ * Compact version history entry.
+ *
+ * Field Mappings:
+ * - id: id
+ * - v: version
+ * - lc: languageCode
+ * - chg: changeDescription
+ * - c_at: createdAt
+ * - by: createdBy
+ */
+export interface CompactContentEntryVersionInfo {
+  id: string;
+  v: number;
+  lc: string | null;
+  chg: string | null;
+  c_at: string;
+  by: CompactContentAuthor | null;
+}
+
+/**
+ * Compact full content entry detail from getContentEntry.
+ *
+ * Field Mappings:
+ * - id: id
+ * - sl: slug
+ * - st: status
+ * - pub_at: publishedAt
+ * - c_at: createdAt
+ * - u_at: updatedAt
+ * - img: featuredImage
+ * - tags: tags
+ * - slang: sourceLanguage
+ * - langs: availableLanguages
+ * - mdl: contentModel
+ * - auth: author
+ * - cfv: customFieldValues
+ * - tr: translations
+ * - vers: versions
+ */
+export interface CompactContentEntryDetail {
+  id: string;
+  sl: string;
+  st: string;
+  pub_at: string | null;
+  c_at: string;
+  u_at: string;
+  img: string | null;
+  tags: string[];
+  slang: string;
+  langs: string[];
+  mdl: CompactContentModelSummary;
+  auth: CompactContentAuthor | null;
+  cfv: Record<string, string | null>;
+  tr: Record<string, CompactContentEntryTranslation>;
+  vers: CompactContentEntryVersionInfo[];
+}
+
+/**
+ * Compact response from createContentEntry / updateContentEntry / publishContentEntry.
+ */
+export type CompactCreateContentEntryResponse = CompactContentEntryDetail;
+export type CompactUpdateContentEntryResponse = CompactContentEntryDetail;
+export type CompactPublishContentEntryResponse = CompactContentEntryDetail;
+
+/**
+ * Compact response from deleteContentEntry.
+ */
+export interface CompactDeleteContentEntryResponse {
+  ok: true;
+}

package/src/content-schemas.ts

@@ -0,0 +1,166 @@
+/**
+ * MCP Content API Schemas
+ *
+ * Zod validation schemas for content MCP router endpoints.
+ * These schemas use the projectIdentifierSchema base and add
+ * content-specific fields with .describe() for MCP tool descriptions.
+ */
+
+import { z } from "zod";
+import { projectIdentifierSchema } from "./schemas";
+
+// ============================================================================
+// Read Schemas
+// ============================================================================
+
+/**
+ * Input schema for listContentModels endpoint.
+ * Lists all content models for a project with entry counts.
+ */
+export const listContentModelsInput = projectIdentifierSchema;
+export type ListContentModelsInput = z.input<typeof listContentModelsInput>;
+
+/**
+ * Input schema for getContentModel endpoint.
+ * Gets a single content model by slug with its field definitions.
+ */
+export const getContentModelInput = projectIdentifierSchema.extend({
+  /** Content model slug (e.g., "blog-posts", "changelog") */
+  modelSlug: z.string().describe("Content model slug"),
+});
+export type GetContentModelInput = z.input<typeof getContentModelInput>;
+
+/**
+ * Input schema for listContentEntries endpoint.
+ * Paginated listing of content entries with filtering.
+ */
+export const listContentEntriesInput = projectIdentifierSchema.extend({
+  /** Filter by content model slug */
+  modelSlug: z
+    .string()
+    .optional()
+    .describe("Filter by content model slug"),
+  /** Search in title/excerpt */
+  search: z
+    .string()
+    .optional()
+    .describe("Search in title or excerpt"),
+  /** Filter by entry status */
+  status: z
+    .enum(["draft", "published", "archived"])
+    .optional()
+    .describe("Filter by entry status"),
+  /** Filter by language code */
+  language: z
+    .string()
+    .optional()
+    .describe("Filter by language code (entries with this translation)"),
+  /** Page number (1-indexed) */
+  page: z.number().min(1).default(1).describe("Page number (1-indexed)"),
+  /** Results per page */
+  limit: z.number().min(1).max(50).default(20).describe("Results per page (max 50)"),
+});
+export type ListContentEntriesInput = z.input<typeof listContentEntriesInput>;
+export type ListContentEntriesOutput = z.infer<typeof listContentEntriesInput>;
+
+/**
+ * Input schema for getContentEntry endpoint.
+ * Gets a single content entry with all translations and field values.
+ */
+export const getContentEntryInput = projectIdentifierSchema.extend({
+  /** Content entry UUID */
+  entryId: z.string().uuid().describe("Content entry UUID"),
+});
+export type GetContentEntryInput = z.input<typeof getContentEntryInput>;
+
+// ============================================================================
+// Write Schemas
+// ============================================================================
+
+/**
+ * Input schema for createContentEntry endpoint.
+ * Creates a new content entry with source translation.
+ */
+export const createContentEntryInput = projectIdentifierSchema.extend({
+  /** Content model slug to create entry in */
+  modelSlug: z.string().describe("Content model slug"),
+  /** Entry title (source language) */
+  title: z.string().describe("Entry title"),
+  /** URL slug for the entry */
+  slug: z.string().describe("URL slug"),
+  /** Short excerpt/summary */
+  excerpt: z.string().optional().describe("Short excerpt or summary"),
+  /** Plate editor JSON content */
+  body: z.unknown().optional().describe("Plate editor JSON content"),
+  /** Featured image URL */
+  featuredImage: z.string().url().optional().nullable().describe("Featured image URL"),
+  /** Tags for categorization */
+  tags: z.array(z.string()).optional().describe("Tags for categorization"),
+  /** Initial status */
+  status: z.enum(["draft", "published"]).default("draft").describe("Initial entry status"),
+  /** Custom field values (field_name → value) */
+  customFields: z
+    .record(z.string(), z.string().nullable())
+    .optional()
+    .default({})
+    .describe("Custom field values as { fieldName: value }"),
+});
+export type CreateContentEntryInput = z.input<typeof createContentEntryInput>;
+
+/**
+ * Input schema for updateContentEntry endpoint.
+ * Updates a content entry's translation and/or metadata.
+ */
+export const updateContentEntryInput = projectIdentifierSchema.extend({
+  /** Content entry UUID */
+  entryId: z.string().uuid().describe("Content entry UUID"),
+  /** Language to update translation for */
+  languageCode: z.string().describe("Language to update translation for"),
+  /** Updated title */
+  title: z.string().optional().describe("Updated title"),
+  /** Updated slug */
+  slug: z.string().optional().describe("Updated URL slug"),
+  /** Updated excerpt */
+  excerpt: z.string().optional().describe("Updated excerpt"),
+  /** Updated body content */
+  body: z.unknown().optional().describe("Updated Plate editor JSON content"),
+  /** SEO meta title */
+  metaTitle: z.string().optional().describe("SEO meta title"),
+  /** SEO meta description */
+  metaDescription: z.string().optional().describe("SEO meta description"),
+  /** Updated featured image */
+  featuredImage: z.string().url().optional().nullable().describe("Updated featured image URL"),
+  /** Updated tags */
+  tags: z.array(z.string()).optional().describe("Updated tags"),
+  /** Updated status */
+  status: z
+    .enum(["draft", "published", "archived"])
+    .optional()
+    .describe("Updated entry status"),
+  /** Updated custom field values */
+  customFields: z
+    .record(z.string(), z.string().nullable())
+    .optional()
+    .describe("Updated custom field values"),
+});
+export type UpdateContentEntryInput = z.input<typeof updateContentEntryInput>;
+
+/**
+ * Input schema for publishContentEntry endpoint.
+ * Sets entry status to published and approves source translation.
+ */
+export const publishContentEntryInput = projectIdentifierSchema.extend({
+  /** Content entry UUID */
+  entryId: z.string().uuid().describe("Content entry UUID"),
+});
+export type PublishContentEntryInput = z.input<typeof publishContentEntryInput>;
+
+/**
+ * Input schema for deleteContentEntry endpoint.
+ * Hard-deletes a content entry and all its translations.
+ */
+export const deleteContentEntryInput = projectIdentifierSchema.extend({
+  /** Content entry UUID */
+  entryId: z.string().uuid().describe("Content entry UUID"),
+});
+export type DeleteContentEntryInput = z.input<typeof deleteContentEntryInput>;

package/src/content-types.ts

@@ -0,0 +1,276 @@
+/**
+ * MCP Content API Types (Verbose)
+ *
+ * TypeScript interfaces for content MCP router responses.
+ * These types define the contract between the API and MCP clients.
+ */
+
+// ============================================================================
+// Content Model Types
+// ============================================================================
+
+/**
+ * Field definition within a content model.
+ */
+export interface ContentModelField {
+  /** Field UUID */
+  id: string;
+  /** Field name (snake_case identifier) */
+  name: string;
+  /** Display name */
+  displayName: string;
+  /** Field type */
+  type: string;
+  /** Whether field is localized per language */
+  localized: boolean;
+  /** Whether field is required */
+  required: boolean;
+  /** Placeholder text */
+  placeholder: string | null;
+  /** Help text */
+  helpText: string | null;
+  /** Sort position */
+  position: number;
+}
+
+/**
+ * Content model summary from listContentModels endpoint.
+ */
+export interface ContentModelSummary {
+  /** Model UUID */
+  id: string;
+  /** URL slug */
+  slug: string;
+  /** Display name */
+  displayName: string;
+  /** Description */
+  description: string | null;
+  /** Model kind (collection or single) */
+  kind: string;
+  /** Icon identifier */
+  icon: string | null;
+  /** Number of entries in this model */
+  entryCount: number;
+  /** Field definitions */
+  fields: ContentModelField[];
+}
+
+/**
+ * Response from listContentModels endpoint.
+ */
+export interface ListContentModelsResponse {
+  /** Content models */
+  models: ContentModelSummary[];
+}
+
+/**
+ * Response from getContentModel endpoint.
+ */
+export interface GetContentModelResponse {
+  /** Model UUID */
+  id: string;
+  /** URL slug */
+  slug: string;
+  /** Display name */
+  displayName: string;
+  /** Description */
+  description: string | null;
+  /** Model kind */
+  kind: string;
+  /** Icon identifier */
+  icon: string | null;
+  /** Whether version history is enabled */
+  enableVersionHistory: boolean;
+  /** Field definitions */
+  fields: ContentModelField[];
+}
+
+// ============================================================================
+// Content Entry Types
+// ============================================================================
+
+/**
+ * Source translation summary for list view.
+ */
+export interface SourceTranslationSummary {
+  /** Entry title */
+  title: string;
+  /** Entry excerpt */
+  excerpt: string | null;
+}
+
+/**
+ * Author info.
+ */
+export interface ContentAuthor {
+  /** User UUID */
+  id: string;
+  /** Display name */
+  name: string | null;
+  /** Avatar URL */
+  image: string | null;
+}
+
+/**
+ * Content model reference within an entry.
+ */
+export interface ContentModelRef {
+  /** Model slug */
+  slug: string;
+  /** Model display name */
+  displayName: string;
+  /** Model kind */
+  kind: string;
+}
+
+/**
+ * Content entry summary from listContentEntries endpoint.
+ */
+export interface ContentEntrySummary {
+  /** Entry UUID */
+  id: string;
+  /** URL slug */
+  slug: string;
+  /** Entry status */
+  status: string;
+  /** Published timestamp (ISO) or null */
+  publishedAt: string | null;
+  /** Created timestamp (ISO) */
+  createdAt: string;
+  /** Updated timestamp (ISO) */
+  updatedAt: string;
+  /** Featured image URL */
+  featuredImage: string | null;
+  /** Tags */
+  tags: string[];
+  /** Content model reference */
+  contentModel: ContentModelRef;
+  /** Source language code */
+  sourceLanguage: string;
+  /** Source translation (title + excerpt) */
+  sourceTranslation: SourceTranslationSummary;
+  /** Languages with translations */
+  availableLanguages: string[];
+  /** Author info */
+  author: ContentAuthor | null;
+  /** Custom field values (field_name → value) */
+  customFieldValues: Record<string, string | null>;
+}
+
+/**
+ * Response from listContentEntries endpoint.
+ */
+export interface ListContentEntriesResponse {
+  /** Content entries */
+  items: ContentEntrySummary[];
+  /** Total matching entries */
+  total: number;
+  /** Whether more pages exist */
+  hasMore: boolean;
+}
+
+/**
+ * Full translation for a single language within an entry.
+ */
+export interface ContentEntryTranslation {
+  /** Translation UUID */
+  id: string;
+  /** Language code */
+  languageCode: string;
+  /** Title */
+  title: string;
+  /** Excerpt */
+  excerpt: string | null;
+  /** Plate editor JSON body */
+  body: unknown;
+  /** SEO meta title */
+  metaTitle: string | null;
+  /** SEO meta description */
+  metaDescription: string | null;
+  /** Translation status */
+  status: string;
+}
+
+/**
+ * Version history entry.
+ */
+export interface ContentEntryVersionInfo {
+  /** Version UUID */
+  id: string;
+  /** Version number */
+  version: number;
+  /** Language code (null if applies to all languages) */
+  languageCode: string | null;
+  /** Change description */
+  changeDescription: string | null;
+  /** Created timestamp (ISO) */
+  createdAt: string;
+  /** Creator info */
+  createdBy: ContentAuthor | null;
+}
+
+/**
+ * Full content entry detail from getContentEntry endpoint.
+ */
+export interface ContentEntryDetail {
+  /** Entry UUID */
+  id: string;
+  /** URL slug */
+  slug: string;
+  /** Entry status */
+  status: string;
+  /** Published timestamp (ISO) or null */
+  publishedAt: string | null;
+  /** Created timestamp (ISO) */
+  createdAt: string;
+  /** Updated timestamp (ISO) */
+  updatedAt: string;
+  /** Featured image URL */
+  featuredImage: string | null;
+  /** Tags */
+  tags: string[];
+  /** Source language code */
+  sourceLanguage: string;
+  /** Languages with translations */
+  availableLanguages: string[];
+  /** Content model with fields */
+  contentModel: ContentModelSummary;
+  /** Author info */
+  author: ContentAuthor | null;
+  /** Custom field values */
+  customFieldValues: Record<string, string | null>;
+  /** Translations by language code */
+  translations: Record<string, ContentEntryTranslation>;
+  /** Version history */
+  versions: ContentEntryVersionInfo[];
+}
+
+// ============================================================================
+// Write Response Types
+// ============================================================================
+
+/**
+ * Response from createContentEntry endpoint.
+ * Returns the full entry detail.
+ */
+export type CreateContentEntryResponse = ContentEntryDetail;
+
+/**
+ * Response from updateContentEntry endpoint.
+ * Returns the full entry detail.
+ */
+export type UpdateContentEntryResponse = ContentEntryDetail;
+
+/**
+ * Response from publishContentEntry endpoint.
+ * Returns the full entry detail.
+ */
+export type PublishContentEntryResponse = ContentEntryDetail;
+
+/**
+ * Response from deleteContentEntry endpoint.
+ */
+export interface DeleteContentEntryResponse {
+  /** Operation success */
+  success: true;
+}

package/src/index.ts

@@ -19,3 +19,12 @@ export * from "./compact-types";
 
 // Re-export client types
 export * from "./client-types";
+
+// Re-export content schemas
+export * from "./content-schemas";
+
+// Re-export content types
+export * from "./content-types";
+
+// Re-export content compact types
+export * from "./content-compact-types";