@neopress/mcp 1.1.3 → 1.2.0

package/dist/index.d.ts

@@ -1,77 +1,908 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { ServerRequest, ServerNotification } from '@modelcontextprotocol/sdk/types.js';
-import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
-import { NeopressClient } from './client.js';
-import { z } from 'zod';
-import { Server } from 'node:http';
-import { AddressInfo } from 'node:net';
-
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { Server } from "node:http";
+import { ServerNotification, ServerRequest } from "@modelcontextprotocol/sdk/types.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { AddressInfo } from "node:net";
+//#region ../sdk/dist/types.d.ts
+/**
+ * @neopress/sdk — First-party API types
+ *
+ * These types mirror the API response format (camelCase).
+ * They are separate from the DB types used internally.
+ */
+interface PaginationMeta {
+  page: number;
+  limit: number;
+  totalCount: number;
+  hasMore: boolean;
+}
+interface ApiResponse<T> {
+  data: T;
+}
+interface PaginatedResponse<T> {
+  data: T[];
+  pagination: PaginationMeta;
+}
+/** Sort direction for list endpoints that support opt-in created_at ordering. */
+type SortOrder = 'asc' | 'desc';
+interface Site {
+  id: number;
+  name: string | null;
+  handle: string;
+  status: string | null;
+  customDomain: string | null;
+  customDomainVerified: boolean | null;
+  plan: string | null;
+  metadata: unknown;
+  localeConfig: {
+    defaultLocale: string;
+    locales: string[];
+    localePrefix?: 'as-needed';
+  } | null;
+  createdAt: string | null;
+  updatedAt: string | null;
+}
+interface Template {
+  id: number;
+  name: string;
+  description: string | null;
+  referenceUrl: string;
+  previewImgUrls: string[] | null;
+  previewVideoUrl: string | null;
+  createdAt: string | null;
+}
+interface TemplateListItem {
+  siteId: number;
+  handle: string | null;
+  siteName: string | null;
+  name: string;
+  referenceUrl: string;
+  previewImgUrls: string[] | null;
+  description: string | null;
+  createdAt: string;
+}
+interface Page {
+  id: number;
+  siteId: number;
+  path: string;
+  title: string | null;
+  type: string | null;
+  status: string;
+  visibility: string;
+  collectionId: number | null;
+  metadata: unknown;
+  draftTsx: string | null;
+  draftJs: string | null;
+  draftI18n: unknown;
+  draftPublicLocales: string[] | null;
+  draftMeta: unknown;
+  prodPath: string | null;
+  prodTsx: string | null;
+  prodJs: string | null;
+  prodI18n: unknown;
+  prodPublicLocales: string[] | null;
+  prodMeta: unknown;
+  publishedAt: string | null;
+  createdAt: string | null;
+  updatedAt: string | null;
+}
+interface Collection {
+  id: number;
+  siteId: number;
+  name: string;
+  presetType: string | null;
+  draftSchema: unknown;
+  prodSchema: unknown;
+  createdAt: string | null;
+  updatedAt: string | null;
+}
+interface Entry {
+  id: number;
+  siteId: number;
+  collectionId: number;
+  locale: string | null;
+  translationGroupId: string | null;
+  slug: string;
+  title: string | null;
+  data: unknown;
+  metadata: unknown;
+  status: string;
+  publishedAt: string | null;
+  publishedVersionId: number | null;
+  createdAt: string | null;
+  updatedAt: string | null;
+}
+interface EntryVersion {
+  id: number;
+  entryId: number | null;
+  locale: string | null;
+  translationGroupId: string | null;
+  slug: string | null;
+  title: string | null;
+  data: unknown;
+  status: string | null;
+  pinned: boolean;
+  source: string;
+  comment: string | null;
+  createdAt: string;
+  updatedAt: string | null;
+}
+interface Form {
+  id: number;
+  siteId: number;
+  name: string;
+  draftSchema: unknown;
+  draftLayout?: unknown;
+  draftStyle?: unknown;
+  draftI18n?: unknown;
+  prodSchema: unknown;
+  prodLayout?: unknown;
+  prodStyle?: unknown;
+  prodI18n?: unknown;
+  settings: unknown;
+  createdAt: string | null;
+  updatedAt: string | null;
+}
+interface FormResponse {
+  id: number;
+  formId: number;
+  data: unknown;
+  metadata: unknown;
+  readAt: string | null;
+  deletedAt: string | null;
+  createdAt: string | null;
+}
+interface Asset {
+  id: number;
+  siteId: number | null;
+  displayName: string | null;
+  assetUrl: string | null;
+  mimeType: string | null;
+  size: number | null;
+  altText: string | null;
+  description: string | null;
+  tags: string[] | null;
+  folderPath: string | null;
+  metadata: unknown;
+  createdAt: string;
+}
+interface RedirectRule {
+  id: number;
+  siteId: number;
+  source: string;
+  destination: string;
+  mode: 'redirect' | 'proxy';
+  redirectType: number;
+  includeChildren: boolean;
+  preservePath: boolean;
+  enabled: boolean;
+  priority: number;
+  createdAt: string;
+  updatedAt: string;
+}
+interface EntryReference {
+  id: number;
+  siteId: number;
+  fromEntryId: number;
+  toEntryId: number;
+  fieldKey: string;
+  createdAt: string;
+}
+interface SiteLayout {
+  siteId: number;
+  draftTsx: string | null;
+  draftGlobalCss: string | null;
+  draftNotFoundTsx: string | null;
+  prodTsx: string | null;
+  prodJs: string | null;
+  prodGlobalCss: string | null;
+  prodNotFoundTsx: string | null;
+  prodNotFoundJs: string | null;
+}
+interface Headshot {
+  id: number;
+  imageUrl: string;
+  width: number;
+  height: number;
+  aspectRatio: string;
+  mimeType: string;
+  byteSize: number | null;
+  ageBand: string;
+  gender: string;
+  ethnicity: string;
+  attire: string;
+  variationIndex: number;
+  gptPrompt: string | null;
+  tags: string[];
+  isActive: boolean;
+  createdAt: string | null;
+  updatedAt: string | null;
+}
+interface Logo {
+  id: number;
+  imageUrl: string;
+  width: number;
+  height: number;
+  aspectRatio: string;
+  mimeType: string;
+  byteSize: number | null;
+  type: string;
+  font: string;
+  color: string;
+  hue: number;
+  tone: string;
+  toneScore: number | null;
+  name: string;
+  variant: string | null;
+  sha256: string | null;
+  tags: string[];
+  isActive: boolean;
+  createdAt: string | null;
+  updatedAt: string | null;
+}
+type AnalyticsQueryValue = string | number | boolean;
+interface AnalyticsQueryParams {
+  pipe: string;
+  dateFrom?: string;
+  dateTo?: string;
+  timezone?: string;
+  limit?: number;
+  params?: Record<string, AnalyticsQueryValue>;
+}
+type AnalyticsQueryResult = Record<string, unknown>;
+interface AnalyticsDateRangeParams {
+  dateFrom?: string;
+  dateTo?: string;
+  timezone?: string;
+  limit?: number;
+  params?: Record<string, AnalyticsQueryValue>;
+}
+type SearchConsoleDimension = 'query' | 'page' | 'country' | 'device';
+interface SearchConsoleQueryParams {
+  dateFrom: string;
+  dateTo: string;
+  dimensions?: SearchConsoleDimension[];
+  queryFilter?: string;
+  pageFilter?: string;
+  rowLimit?: number;
+}
+interface SearchConsoleRow {
+  keys: string[];
+  clicks: number;
+  impressions: number;
+  ctr: number;
+  position: number;
+}
+interface SearchConsoleQueryResult {
+  connected: boolean;
+  rows: SearchConsoleRow[];
+  totals: {
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+  };
+  error?: string;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/pages.d.ts
+interface PageListParams {
+  page?: number;
+  limit?: number;
+  status?: 'draft' | 'published';
+  fields?: string[];
+  /** When set, sort by created_at instead of path. */
+  order?: SortOrder;
+}
+interface PageCreateParams {
+  path: string;
+  title?: string;
+  type?: 'static' | 'dynamic';
+  status?: 'draft' | 'published';
+  visibility?: 'public' | 'hidden';
+  draftTsx?: string;
+  draftI18n?: unknown;
+  draftPublicLocales?: string[] | null;
+  draftMeta?: unknown;
+  collectionId?: number;
+  metadata?: unknown;
+}
+interface PageUpdateParams {
+  path?: string;
+  title?: string;
+  type?: string;
+  status?: string;
+  visibility?: 'public' | 'hidden';
+  draftTsx?: string;
+  draftI18n?: unknown;
+  draftPublicLocales?: string[] | null;
+  draftMeta?: unknown;
+  metadata?: unknown;
+  collectionId?: number;
+}
+declare class PagesEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  private get basePath();
+  list(params?: PageListParams): Promise<PaginatedResponse<Page>>;
+  get(pageId: number): Promise<Page>;
+  create(data: PageCreateParams): Promise<Page>;
+  update(pageId: number, data: PageUpdateParams): Promise<Page>;
+  delete(pageId: number): Promise<void>;
+  compile(pageId: number): Promise<{
+    compiled: boolean;
+    jsLength: number;
+  }>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/collections.d.ts
+interface CollectionCreateParams {
+  name: string;
+  presetType?: string;
+  draftSchema?: unknown;
+}
+declare class CollectionsEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  private get basePath();
+  list(params?: {
+    order?: SortOrder;
+  }): Promise<Collection[]>;
+  get(collectionId: number): Promise<Collection>;
+  create(data: CollectionCreateParams): Promise<Collection>;
+  update(collectionId: number, data: Partial<CollectionCreateParams>): Promise<Collection>;
+  delete(collectionId: number): Promise<void>;
+  getSchema(collectionId: number): Promise<{
+    collectionId: number;
+    draftSchema: unknown;
+    prodSchema: unknown;
+  }>;
+  /**
+   * Updates the collection's draft_schema directly in Supabase.
+   * validateApiCollectionSchema (app-local) is skipped — CLI/MCP callers are trusted.
+   */
+  updateSchema(collectionId: number, schema: unknown): Promise<{
+    collectionId: number;
+    draftSchema: unknown;
+    prodSchema: unknown;
+  }>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/entries.d.ts
+interface EntryListParams {
+  page?: number;
+  limit?: number;
+  status?: 'draft' | 'published' | 'archived';
+  locale?: string;
+  /** created_at sort direction. Defaults to 'desc' (newest first). */
+  order?: SortOrder;
+}
+interface EntryCreateParams {
+  slug?: string;
+  title?: string;
+  locale?: string;
+  data: unknown;
+  metadata?: unknown;
+  status?: string;
+}
+interface EntryUpdateParams {
+  slug?: string;
+  title?: string;
+  locale?: string;
+  data?: unknown;
+  metadata?: unknown;
+  status?: string;
+}
+declare class EntriesEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  list(collectionId: number, params?: EntryListParams): Promise<PaginatedResponse<Entry>>;
+  get(entryId: number): Promise<Entry>;
+  create(collectionId: number, data: EntryCreateParams): Promise<Entry>;
+  update(entryId: number, data: EntryUpdateParams): Promise<Entry>;
+  delete(entryId: number): Promise<void>;
+  revalidateReaderCache(entryId: number): Promise<void>;
+  publish(entryId: number): Promise<{
+    id: number;
+    status: string;
+    publishedAt: string | null;
+  }>;
+  unpublish(entryId: number): Promise<{
+    id: number;
+    status: string;
+  }>;
+  listVersions(entryId: number): Promise<EntryVersion[]>;
+  pinVersion(entryId: number, versionId: number): Promise<{
+    id: number;
+    pinned: boolean;
+  }>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/forms.d.ts
+interface FormCreateParams {
+  name: string;
+  draftSchema?: unknown;
+  draftLayout?: unknown;
+  draftStyle?: unknown;
+  draftI18n?: unknown;
+  settings?: unknown;
+}
+interface FormUpdateParams {
+  name?: string;
+  draftSchema?: unknown;
+  draftLayout?: unknown;
+  draftStyle?: unknown;
+  draftI18n?: unknown;
+  settings?: unknown;
+}
+declare class FormsEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  private get basePath();
+  list(params?: {
+    order?: SortOrder;
+  }): Promise<Form[]>;
+  get(formId: number): Promise<Form>;
+  create(data: FormCreateParams): Promise<Form>;
+  update(formId: number, data: FormUpdateParams): Promise<Form>;
+  delete(formId: number): Promise<void>;
+  publish(formId: number): Promise<{
+    id: number;
+    draftSchema: unknown;
+    prodSchema: unknown;
+  }>;
+  listResponses(formId: number, params?: {
+    page?: number;
+    limit?: number;
+  }): Promise<PaginatedResponse<FormResponse>>;
+  deleteResponse(formId: number, responseId: number): Promise<void>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/assets.d.ts
+interface AssetRegisterParams {
+  assetUrl: string;
+  displayName?: string;
+  mimeType?: string;
+  size?: number;
+  altText?: string;
+  description?: string;
+  tags?: string[];
+  folderPath?: string;
+  metadata?: unknown;
+}
+interface AssetPresignParams {
+  fileKey: string;
+  contentType: string;
+  contentLength: number;
+}
+declare class AssetsEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  private get basePath();
+  list(params?: {
+    page?: number;
+    limit?: number;
+    order?: SortOrder;
+  }): Promise<PaginatedResponse<Asset>>;
+  get(assetId: number): Promise<Asset>;
+  register(data: AssetRegisterParams): Promise<Asset>;
+  update(assetId: number, data: Partial<Omit<AssetRegisterParams, 'assetUrl'>>): Promise<Asset>;
+  delete(assetId: number): Promise<void>;
+  presign(data: AssetPresignParams): Promise<{
+    presignedUrl: string;
+    publicUrl: string;
+    fileKey: string;
+  }>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/site.d.ts
+interface SiteWithRole extends Site {
+  role: string;
+}
+interface SiteCreateParams {
+  siteName?: string;
+  siteHandle?: string;
+  prompt?: string;
+  language?: string;
+  placeholder?: boolean;
+}
+declare class SiteEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  list(params?: {
+    order?: SortOrder;
+  }): Promise<SiteWithRole[]>;
+  get(): Promise<Site>;
+  create(data: SiteCreateParams): Promise<Site>;
+  update(data: Partial<Pick<Site, 'name' | 'metadata' | 'localeConfig'>> & {
+    globalCss?: string;
+    instructions?: unknown;
+  }): Promise<Site>;
+  getLayout(): Promise<SiteLayout>;
+  updateLayout(data: {
+    draftTsx?: string;
+    draftNotFoundTsx?: string;
+    draftGlobalCss?: string;
+  }): Promise<SiteLayout>;
+  delete(): Promise<{
+    siteId: number;
+    deleted: true;
+  }>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/redirects.d.ts
+interface RedirectCreateParams {
+  source: string;
+  destination: string;
+  redirectType?: 307 | 308;
+  includeChildren?: boolean;
+  preservePath?: boolean;
+  enabled?: boolean;
+  priority?: number;
+}
+declare class RedirectsEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  list(params?: {
+    order?: SortOrder;
+  }): Promise<RedirectRule[]>;
+  create(data: RedirectCreateParams): Promise<RedirectRule>;
+  private assertRedirectRuleWritable;
+  update(ruleId: number, data: Partial<RedirectCreateParams>): Promise<RedirectRule>;
+  delete(ruleId: number): Promise<void>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/publish.d.ts
+declare class PublishEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  preview(): Promise<unknown>;
+  site(): Promise<unknown>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/entry-references.d.ts
+interface EntryReferenceListParams {
+  fromEntryId?: number;
+  toEntryId?: number;
+  /** created_at sort direction. Defaults to 'desc' (newest first). */
+  order?: SortOrder;
+}
+interface EntryReferenceCreateParams {
+  fromEntryId: number;
+  toEntryId: number;
+  fieldKey: string;
+}
+declare class EntryReferencesEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  list(params?: EntryReferenceListParams): Promise<EntryReference[]>;
+  create(data: EntryReferenceCreateParams): Promise<EntryReference>;
+  delete(referenceId: number): Promise<void>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/analytics.d.ts
+declare class AnalyticsEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  private get basePath();
+  query(params: AnalyticsQueryParams): Promise<AnalyticsQueryResult>;
+  pageviews(params?: AnalyticsDateRangeParams): Promise<AnalyticsQueryResult>;
+  summary(params?: AnalyticsDateRangeParams): Promise<AnalyticsQueryResult>;
+  topPages(params?: AnalyticsDateRangeParams): Promise<AnalyticsQueryResult>;
+  trafficSources(params?: AnalyticsDateRangeParams): Promise<AnalyticsQueryResult>;
+  formAnalytics(params?: AnalyticsDateRangeParams): Promise<AnalyticsQueryResult>;
+  crawlerSummary(params?: AnalyticsDateRangeParams): Promise<AnalyticsQueryResult>;
+  searchConsole(params: SearchConsoleQueryParams): Promise<SearchConsoleQueryResult>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/templates.d.ts
+interface TemplateMarkParams {
+  name: string;
+  description?: string | null;
+  referenceUrl: string;
+  previewImgUrls?: string[] | null;
+}
+interface TemplateDeleteResult {
+  siteId: number;
+  deleted: true;
+}
+declare class TemplatesEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  private get basePath();
+  get(): Promise<Template>;
+  mark(data: TemplateMarkParams): Promise<Template>;
+  delete(): Promise<TemplateDeleteResult>;
+  /**
+   * List templates across the sites the caller can access.
+   *
+   * Direct-DB: `templates` is public-read and `sites` RLS scopes the visible set
+   * (own active memberships, or all sites for the super admin), so no server
+   * route is needed — the two RLS-scoped queries reproduce the old handler.
+   */
+  list(params?: {
+    namePrefix?: string;
+    limit?: number;
+    order?: SortOrder;
+  }): Promise<TemplateListItem[]>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/headshots.d.ts
+type HeadshotAgeBand = 'young' | 'middle';
+type HeadshotGender = 'male' | 'female';
+type HeadshotEthnicity = 'asian' | 'white' | 'black' | 'latino';
+type HeadshotAttire = 'formal' | 'casual';
+interface HeadshotListParams {
+  page?: number;
+  limit?: number;
+  ageBand?: HeadshotAgeBand;
+  gender?: HeadshotGender;
+  ethnicity?: HeadshotEthnicity;
+  attire?: HeadshotAttire;
+  isActive?: boolean;
+  /** When set, sort by created_at instead of the demographic key order. */
+  order?: SortOrder;
+}
+interface HeadshotCreateParams {
+  imageUrl: string;
+  ageBand: HeadshotAgeBand;
+  gender: HeadshotGender;
+  ethnicity: HeadshotEthnicity;
+  variationIndex: number;
+  attire?: HeadshotAttire;
+  width?: number;
+  height?: number;
+  aspectRatio?: string;
+  mimeType?: string;
+  byteSize?: number | null;
+  gptPrompt?: string | null;
+  tags?: string[];
+  isActive?: boolean;
+}
+interface HeadshotUpdateParams {
+  imageUrl?: string;
+  ageBand?: HeadshotAgeBand;
+  gender?: HeadshotGender;
+  ethnicity?: HeadshotEthnicity;
+  attire?: HeadshotAttire;
+  variationIndex?: number;
+  width?: number;
+  height?: number;
+  aspectRatio?: string;
+  mimeType?: string;
+  byteSize?: number | null;
+  gptPrompt?: string | null;
+  tags?: string[];
+  isActive?: boolean;
+}
+interface HeadshotDeleteResult {
+  id: number;
+  deleted: true;
+}
+/**
+ * headshot_pool is a GLOBAL (not site-scoped) admin table. RLS exposes it only to
+ * the super-admin user, so these direct-DB calls return empty/forbidden for any
+ * other account. No site id is used.
+ */
+declare class HeadshotsEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  list(params?: HeadshotListParams): Promise<PaginatedResponse<Headshot>>;
+  get(id: number): Promise<Headshot>;
+  create(params: HeadshotCreateParams): Promise<Headshot>;
+  update(id: number, params: HeadshotUpdateParams): Promise<Headshot>;
+  delete(id: number): Promise<HeadshotDeleteResult>;
+}
+//#endregion
+//#region ../sdk/dist/endpoints/logos.d.ts
+type LogoType = 'wordmark' | 'lockup' | 'signature';
+type LogoTone = 'playful' | 'neutral' | 'serious';
+interface LogoListParams {
+  page?: number;
+  limit?: number;
+  type?: LogoType;
+  tone?: LogoTone;
+  font?: string;
+  hue?: number;
+  isActive?: boolean;
+  /** When set, sort by created_at instead of the diversity-axis key order. */
+  order?: SortOrder;
+}
+interface LogoCreateParams {
+  imageUrl: string;
+  type: LogoType;
+  font: string;
+  color: string;
+  hue: number;
+  tone: LogoTone;
+  name: string;
+  toneScore?: number | null;
+  variant?: string | null;
+  sha256?: string | null;
+  width?: number;
+  height?: number;
+  aspectRatio?: string;
+  mimeType?: string;
+  byteSize?: number | null;
+  tags?: string[];
+  isActive?: boolean;
+}
+interface LogoUpdateParams {
+  imageUrl?: string;
+  type?: LogoType;
+  font?: string;
+  color?: string;
+  hue?: number;
+  tone?: LogoTone;
+  name?: string;
+  toneScore?: number | null;
+  variant?: string | null;
+  sha256?: string | null;
+  width?: number;
+  height?: number;
+  aspectRatio?: string;
+  mimeType?: string;
+  byteSize?: number | null;
+  tags?: string[];
+  isActive?: boolean;
+}
+interface LogoDeleteResult {
+  id: number;
+  deleted: true;
+}
+/**
+ * logo_pool is a GLOBAL (not site-scoped) admin table. RLS exposes it only to the
+ * super-admin user, so these direct-DB calls return empty/forbidden for any other
+ * account. No site id is used.
+ */
+declare class LogosEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  list(params?: LogoListParams): Promise<PaginatedResponse<Logo>>;
+  get(id: number): Promise<Logo>;
+  create(params: LogoCreateParams): Promise<Logo>;
+  update(id: number, params: LogoUpdateParams): Promise<Logo>;
+  delete(id: number): Promise<LogoDeleteResult>;
+}
+//#endregion
+//#region ../sdk/dist/client.d.ts
+interface NeopressClientOptions {
+  /** OAuth access token */
+  accessToken?: string;
+  /** Site ID to operate on */
+  siteId: number | string;
+  /** Base URL (default: https://app.neopress.ai) — used by orchestration/analytics (HTTP) routes */
+  baseUrl?: string;
+  /** Request timeout in ms (default: 30000) */
+  timeout?: number;
+  /** Supabase project URL — enables direct-DB reads/CRUD (transparent routing). */
+  supabaseUrl?: string;
+  /** Supabase anon key (paired with the user accessToken so RLS applies). */
+  supabaseAnonKey?: string;
+}
+declare class NeopressClient {
+  private readonly baseUrl;
+  private readonly accessToken;
+  private readonly siteId;
+  private readonly timeout;
+  private readonly supabaseUrl?;
+  private readonly supabaseAnonKey?;
+  private _db;
+  readonly pages: PagesEndpoint;
+  readonly collections: CollectionsEndpoint;
+  readonly entries: EntriesEndpoint;
+  readonly forms: FormsEndpoint;
+  readonly assets: AssetsEndpoint;
+  readonly site: SiteEndpoint;
+  readonly redirects: RedirectsEndpoint;
+  readonly publish: PublishEndpoint;
+  readonly entryReferences: EntryReferencesEndpoint;
+  readonly analytics: AnalyticsEndpoint;
+  readonly templates: TemplatesEndpoint;
+  readonly headshots: HeadshotsEndpoint;
+  readonly logos: LogosEndpoint;
+  constructor(options: NeopressClientOptions);
+  get siteBasePath(): string;
+  /** Numeric site id for direct DB queries. */
+  get siteIdNumber(): number;
+  /**
+   * Authenticated user's profile id, decoded locally from the access token's
+   * JWT `sub` claim (no network round-trip). Returns null if there is no token
+   * or it cannot be parsed. Subsequent DB queries are RLS-protected, so a local
+   * decode is sufficient — no server-side validation is required here.
+   */
+  get authUserId(): string | null;
+  /** Mirror of v1 parsePagination(defaultLimit=20, maxLimit=100). */
+  resolvePagination(params?: {
+    page?: number;
+    limit?: number;
+  }): {
+    page: number;
+    limit: number;
+    offset: number;
+  };
+  /** Build the paginated envelope matching the v1 API. */
+  paginationMeta(page: number, limit: number, offset: number, totalCount: number): PaginationMeta;
+  request<T>(method: string, path: string, body?: unknown): Promise<T>;
+  get<T>(path: string): Promise<ApiResponse<T>>;
+  getList<T>(path: string): Promise<PaginatedResponse<T>>;
+  post<T>(path: string, body?: unknown): Promise<ApiResponse<T>>;
+  patch<T>(path: string, body: unknown): Promise<ApiResponse<T>>;
+  delete<T>(path: string): Promise<ApiResponse<T>>;
+}
+//#endregion
+//#region src/config.d.ts
 interface ClientOptions {
-    siteId?: number;
-    requireSite?: boolean;
+  siteId?: number;
+  requireSite?: boolean;
 }
-
+//#endregion
+//#region src/tools.d.ts
 interface ToolContext {
-    createClient(options?: ClientOptions, extra?: ToolRequestExtra): Promise<NeopressClient>;
-    readFile(filePath: string): Buffer;
-    stat(filePath: string): {
-        size: number;
-    };
-    fetch: typeof fetch;
-    setActiveSiteId(siteId: number, extra?: ToolRequestExtra): void;
-    getBaseUrl(): string;
+  createClient(options?: ClientOptions, extra?: ToolRequestExtra): Promise<NeopressClient>;
+  readFile(filePath: string): Buffer;
+  stat(filePath: string): {
+    size: number;
+  };
+  fetch: typeof fetch;
+  setActiveSiteId(siteId: number, extra?: ToolRequestExtra): void;
+  getBaseUrl(): string;
 }
 interface NeopressToolDefinition {
-    name: string;
-    title: string;
-    description: string;
-    inputSchema: Record<string, z.ZodTypeAny>;
-    handler(input: Record<string, unknown>, context: ToolContext, extra?: ToolRequestExtra): Promise<unknown>;
+  name: string;
+  title: string;
+  description: string;
+  inputSchema: Record<string, z.ZodTypeAny>;
+  handler(input: Record<string, unknown>, context: ToolContext, extra?: ToolRequestExtra): Promise<unknown>;
 }
 type ToolRequestExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
 declare const toolDefinitions: NeopressToolDefinition[];
 declare function registerNeopressTools(server: McpServer, context?: ToolContext, options?: {
-    disabledTools?: Iterable<string>;
+  disabledTools?: Iterable<string>;
 }): void;
-
+//#endregion
+//#region src/server.d.ts
 interface NeopressMcpServerOptions {
-    toolContext?: ToolContext;
-    disabledTools?: Iterable<string>;
+  toolContext?: ToolContext;
+  disabledTools?: Iterable<string>;
 }
 declare function createNeopressMcpServer(options?: NeopressMcpServerOptions): McpServer;
-
+//#endregion
+//#region src/remote/context.d.ts
 interface RemoteSiteSelectionStore {
-    get(userKey: string): number | undefined;
-    set(userKey: string, siteId: number): void;
+  get(userKey: string): number | undefined;
+  set(userKey: string, siteId: number): void;
 }
 interface RemoteToolContextOptions {
-    baseUrl: string;
-    siteSelectionStore?: RemoteSiteSelectionStore;
+  baseUrl: string;
+  siteSelectionStore?: RemoteSiteSelectionStore;
 }
 declare function createMemoryRemoteSiteSelectionStore(): RemoteSiteSelectionStore;
 declare function createRemoteToolContext(options: RemoteToolContextOptions): ToolContext;
-
+//#endregion
+//#region src/remote/http-server.d.ts
 type RemoteMcpAuthMode = 'oauth' | 'none';
 interface NeopressMcpHttpServerOptions {
-    authMode?: RemoteMcpAuthMode;
-    baseUrl?: string;
-    corsOrigins?: string[] | '*';
-    fetch?: typeof fetch;
-    host?: string;
-    oauthClientSecret?: string;
-    oauthProvider?: string;
-    port?: number;
-    publicUrl?: string;
-    siteSelectionStore?: RemoteSiteSelectionStore;
-    supabaseAnonKey?: string;
-    supabaseUrl?: string;
+  authMode?: RemoteMcpAuthMode;
+  baseUrl?: string;
+  corsOrigins?: string[] | '*';
+  fetch?: typeof fetch;
+  host?: string;
+  oauthClientSecret?: string;
+  oauthProvider?: string;
+  port?: number;
+  publicUrl?: string;
+  siteSelectionStore?: RemoteSiteSelectionStore;
+  supabaseAnonKey?: string;
+  supabaseUrl?: string;
 }
 interface NeopressMcpHttpServer {
-    address(): AddressInfo | string | null;
-    close(): Promise<void>;
-    listen(port?: number, host?: string): Promise<AddressInfo | string | null>;
-    server: Server;
+  address(): AddressInfo | string | null;
+  close(): Promise<void>;
+  listen(port?: number, host?: string): Promise<AddressInfo | string | null>;
+  server: Server;
 }
 declare function createNeopressMcpHttpServer(rawOptions?: NeopressMcpHttpServerOptions): NeopressMcpHttpServer;
-
-export { type NeopressMcpHttpServer, type NeopressMcpHttpServerOptions, type NeopressMcpServerOptions, type NeopressToolDefinition, type RemoteMcpAuthMode, type ToolContext, type ToolRequestExtra, createMemoryRemoteSiteSelectionStore, createNeopressMcpHttpServer, createNeopressMcpServer, createRemoteToolContext, registerNeopressTools, toolDefinitions };
+//#endregion
+export { type NeopressMcpHttpServer, type NeopressMcpHttpServerOptions, type NeopressMcpServerOptions, type NeopressToolDefinition, type RemoteMcpAuthMode, type ToolContext, type ToolRequestExtra, createMemoryRemoteSiteSelectionStore, createNeopressMcpHttpServer, createNeopressMcpServer, createRemoteToolContext, registerNeopressTools, toolDefinitions };