@neopress/cli 4.8.1 → 4.10.0

package/dist/index.d.ts

@@ -19,7 +19,7 @@ interface PaginatedResponse<T> {
   pagination: PaginationMeta;
 }
 /** Sort direction for list endpoints that support opt-in created_at ordering. */
-type SortOrder = 'asc' | 'desc';
+type SortOrder = "asc" | "desc";
 interface Site {
   id: number;
   name: string | null;
@@ -32,7 +32,7 @@ interface Site {
   localeConfig: {
     defaultLocale: string;
     locales: string[];
-    localePrefix?: 'as-needed';
+    localePrefix?: "as-needed";
   } | null;
   createdAt: string | null;
   updatedAt: string | null;
@@ -44,6 +44,8 @@ interface Template {
   referenceUrl: string;
   previewImgUrls: string[] | null;
   previewVideoUrl: string | null;
+  /** Primary language of the template's content, as an ISO 639-1 code (ko/en/es). */
+  language: string | null;
   createdAt: string | null;
 }
 interface TemplateListItem {
@@ -54,6 +56,7 @@ interface TemplateListItem {
   referenceUrl: string;
   previewImgUrls: string[] | null;
   description: string | null;
+  language: string | null;
   createdAt: string;
 }
 interface Page {
@@ -166,7 +169,7 @@ interface RedirectRule {
   siteId: number;
   source: string;
   destination: string;
-  mode: 'redirect' | 'proxy';
+  mode: "redirect" | "proxy";
   redirectType: number;
   includeChildren: boolean;
   preservePath: boolean;
@@ -252,7 +255,7 @@ interface AnalyticsDateRangeParams {
   limit?: number;
   params?: Record<string, AnalyticsQueryValue>;
 }
-type SearchConsoleDimension = 'query' | 'page' | 'country' | 'device';
+type SearchConsoleDimension = "query" | "page" | "country" | "device";
 interface SearchConsoleQueryParams {
   dateFrom: string;
   dateTo: string;
@@ -279,12 +282,108 @@ interface SearchConsoleQueryResult {
   };
   error?: string;
 }
+type AnalyticsEventType = "custom" | "page" | "click" | "form" | "scroll" | "visibility" | "dwell";
+type FunnelFilterField = "event.path" | "event.url" | "event.referrer" | "event.referrer_source" | "event.property" | "session.referrer" | "session.referrer_source" | "session.traffic_category" | "session.utm_source" | "session.utm_medium" | "session.utm_campaign" | "session.utm_content" | "session.utm_term";
+type FunnelFilterOperator = "eq" | "neq" | "contains" | "not_contains" | "starts_with" | "ends_with" | "exists" | "not_exists" | "gt" | "gte" | "lt" | "lte";
+type AnalyticsFunnelFilterCondition = {
+  kind: "condition";
+  field: FunnelFilterField;
+  operator: FunnelFilterOperator;
+  key?: string;
+  value?: string | number;
+};
+type AnalyticsFunnelFilterGroup = {
+  kind: "group";
+  op: "and" | "or";
+  children: AnalyticsFunnelFilterNode[];
+};
+type AnalyticsFunnelFilterNode = AnalyticsFunnelFilterGroup | AnalyticsFunnelFilterCondition;
+type AnalyticsFunnelFilter = {
+  version: 1;
+  root: AnalyticsFunnelFilterGroup;
+};
+interface AnalyticsEventDefinition {
+  id: string;
+  chart_color: string | null;
+  name: string;
+  chart_visible: boolean;
+  is_pinned: boolean;
+  event_type: AnalyticsEventType;
+  event_name: string;
+  path: string;
+  selector: string;
+  form_id: string;
+  scroll_depth: number;
+  dwell_seconds: number;
+  tracking_version: number;
+  created_at: string;
+  updated_at: string;
+}
+interface AnalyticsEventDefinitionInput {
+  /** Optional client UUID; reuse it with the same payload after an uncertain create response. */
+  id?: string;
+  name: string;
+  eventType: AnalyticsEventType;
+  eventName?: string;
+  path?: string;
+  selector?: string;
+  formId?: string;
+  scrollDepth?: number;
+  dwellSeconds?: number;
+}
+type AnalyticsEventDefinitionUpdate = AnalyticsEventDefinitionInput | {
+  name: string;
+};
+interface AnalyticsEventDisplayUpdate {
+  chartVisible?: boolean;
+  pinned?: boolean;
+  chartColor?: string;
+}
+interface AnalyticsFunnelStepInput {
+  eventId: string;
+  path?: string;
+  filter?: AnalyticsFunnelFilter;
+}
+interface AnalyticsFunnelStep {
+  event_id: string;
+  path?: string;
+  filter?: AnalyticsFunnelFilter;
+}
+interface AnalyticsFunnelDefinition {
+  invalid?: true;
+  id: string;
+  name: string;
+  steps: AnalyticsFunnelStep[];
+  session_only: boolean;
+  window_minutes: number;
+  created_at: string;
+  updated_at: string;
+}
+interface AnalyticsTargets {
+  pages: Array<{
+    id: number;
+    name: string;
+    path: string;
+    locale: string;
+  }>;
+  forms: Array<{
+    id: number;
+    name: string;
+  }>;
+}
+interface AnalyticsFunnelDefinitionInput {
+  id?: string;
+  name: string;
+  steps: AnalyticsFunnelStepInput[];
+  windowMode: "session" | "time";
+  windowHours?: number;
+}
 //#endregion
 //#region ../sdk/src/endpoints/pages.d.ts
 interface PageListParams {
   page?: number;
   limit?: number;
-  status?: 'draft' | 'published';
+  status?: "draft" | "published";
   fields?: string[];
   /** When set, sort by created_at instead of path. */
   order?: SortOrder;
@@ -292,9 +391,9 @@ interface PageListParams {
 interface PageCreateParams {
   path: string;
   title?: string;
-  type?: 'static' | 'dynamic';
-  status?: 'draft' | 'published';
-  visibility?: 'public' | 'hidden';
+  type?: "static" | "dynamic";
+  status?: "draft" | "published";
+  visibility?: "public" | "hidden";
   draftTsx?: string;
   draftI18n?: unknown;
   draftPublicLocales?: string[] | null;
@@ -307,7 +406,7 @@ interface PageUpdateParams {
   title?: string;
   type?: string;
   status?: string;
-  visibility?: 'public' | 'hidden';
+  visibility?: string;
   draftTsx?: string;
   draftI18n?: unknown;
   draftPublicLocales?: string[] | null;
@@ -344,6 +443,12 @@ declare class CollectionsEndpoint {
     order?: SortOrder;
   }): Promise<Collection[]>;
   get(collectionId: number): Promise<Collection>;
+  /**
+   * Preset normalization (`normalizeCollectionPresetType` +
+   * `ensureCollectionPresetBaselineFields`) now runs server-side in
+   * `CollectionsApi.create`, which applies the identical pair in the identical
+   * order — the stored row is unchanged by the move to HTTP.
+   */
   create(data: CollectionCreateParams): Promise<Collection>;
   update(collectionId: number, data: Partial<CollectionCreateParams>): Promise<Collection>;
   delete(collectionId: number): Promise<void>;
@@ -352,10 +457,6 @@ declare class CollectionsEndpoint {
     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;
@@ -367,7 +468,7 @@ declare class CollectionsEndpoint {
 interface EntryListParams {
   page?: number;
   limit?: number;
-  status?: 'draft' | 'published' | 'archived';
+  status?: "draft" | "published" | "archived";
   locale?: string;
   /** created_at sort direction. Defaults to 'desc' (newest first). */
   order?: SortOrder;
@@ -391,9 +492,12 @@ interface EntryUpdateParams {
 declare class EntriesEndpoint {
   private readonly client;
   constructor(client: NeopressClient);
+  private get basePath();
   list(collectionId: number, params?: EntryListParams): Promise<PaginatedResponse<Entry>>;
   get(entryId: number): Promise<Entry>;
   create(collectionId: number, data: EntryCreateParams): Promise<Entry>;
+  /** Copy source content into a linked locale draft, or return its existing translation. */
+  createTranslation(entryId: number, locale: string): Promise<Entry>;
   update(entryId: number, data: EntryUpdateParams): Promise<Entry>;
   delete(entryId: number): Promise<void>;
   revalidateReaderCache(entryId: number): Promise<void>;
@@ -481,7 +585,12 @@ declare class AssetsEndpoint {
   }): Promise<PaginatedResponse<Asset>>;
   get(assetId: number): Promise<Asset>;
   register(data: AssetRegisterParams): Promise<Asset>;
-  update(assetId: number, data: Partial<Omit<AssetRegisterParams, 'assetUrl'>>): Promise<Asset>;
+  update(assetId: number, data: Partial<Omit<AssetRegisterParams, "assetUrl">>): Promise<Asset>;
+  /**
+   * Hard delete. The route additionally requires the caller to be the site
+   * owner, matching `assets_delete_policy` = `is_site_owner(site_id)` — the
+   * registry axes alone would have widened this (W7 mapping §3-B1).
+   */
   delete(assetId: number): Promise<void>;
   presign(data: AssetPresignParams): Promise<{
     presignedUrl: string;
@@ -492,6 +601,12 @@ declare class AssetsEndpoint {
 //#endregion
 //#region ../sdk/src/endpoints/site.d.ts
 interface SiteWithRole extends Site {
+  /** Project role of the caller on this site: "owner" | "admin" | "member". */
+  projectRole: string;
+  /**
+   * @deprecated Legacy site role derived from `projectRole` for backwards
+   * compatibility ("owner" | "admin" | "member"). Use `projectRole` instead.
+   */
   role: string;
 }
 interface SiteCreateParams {
@@ -499,18 +614,25 @@ interface SiteCreateParams {
   siteHandle?: string;
   prompt?: string;
   language?: string;
-  placeholder?: boolean;
 }
 declare class SiteEndpoint {
   private readonly client;
   constructor(client: NeopressClient);
+  /**
+   * Global (not site-scoped): lists the caller's own memberships, so it does not
+   * hang off `siteBasePath`. The membership + soft-delete filters that RLS used
+   * to apply now live in the route.
+   */
   list(params?: {
     order?: SortOrder;
   }): Promise<SiteWithRole[]>;
   get(): Promise<Site>;
   create(data: SiteCreateParams): Promise<Site>;
-  update(data: Partial<Pick<Site, 'name' | 'metadata' | 'localeConfig'>> & {
-    globalCss?: string;
+  /**
+   * Site settings only. The stylesheet is not here — it lives on the layout
+   * (`updateLayout({ draftGlobalCss })`), which is what the reader renders.
+   */
+  update(data: Partial<Pick<Site, "name" | "metadata" | "localeConfig">> & {
     instructions?: unknown;
   }): Promise<Site>;
   getLayout(): Promise<SiteLayout>;
@@ -538,11 +660,17 @@ interface RedirectCreateParams {
 declare class RedirectsEndpoint {
   private readonly client;
   constructor(client: NeopressClient);
+  private get basePath();
   list(params?: {
     order?: SortOrder;
   }): Promise<RedirectRule[]>;
   create(data: RedirectCreateParams): Promise<RedirectRule>;
-  private assertRedirectRuleWritable;
+  /**
+   * The proxy preflight that used to run here (`assertRedirectRuleWritable`)
+   * needs a DB read, so it moved into the route. Its two error codes —
+   * `REDIRECT_RULE_NOT_FOUND` and `REDIRECT_RULE_DASHBOARD_ONLY` — are returned
+   * by the server verbatim, so `NeopressApiError.code` is unchanged for callers.
+   */
   update(ruleId: number, data: Partial<RedirectCreateParams>): Promise<RedirectRule>;
   delete(ruleId: number): Promise<void>;
 }
@@ -570,6 +698,7 @@ interface EntryReferenceCreateParams {
 declare class EntryReferencesEndpoint {
   private readonly client;
   constructor(client: NeopressClient);
+  private get basePath();
   list(params?: EntryReferenceListParams): Promise<EntryReference[]>;
   create(data: EntryReferenceCreateParams): Promise<EntryReference>;
   delete(referenceId: number): Promise<void>;
@@ -578,6 +707,8 @@ declare class EntryReferencesEndpoint {
 //#region ../sdk/src/endpoints/analytics.d.ts
 declare class AnalyticsEndpoint {
   private readonly client;
+  readonly events: AnalyticsEventsEndpoint;
+  readonly funnels: AnalyticsFunnelsEndpoint;
   constructor(client: NeopressClient);
   private get basePath();
   query(params: AnalyticsQueryParams): Promise<AnalyticsQueryResult>;
@@ -588,6 +719,30 @@ declare class AnalyticsEndpoint {
   formAnalytics(params?: AnalyticsDateRangeParams): Promise<AnalyticsQueryResult>;
   crawlerSummary(params?: AnalyticsDateRangeParams): Promise<AnalyticsQueryResult>;
   searchConsole(params: SearchConsoleQueryParams): Promise<SearchConsoleQueryResult>;
+  /** Page/form targets that can be referenced by an event definition. */
+  targets(): Promise<AnalyticsTargets>;
+}
+declare class AnalyticsEventsEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  private get basePath();
+  list(): Promise<AnalyticsEventDefinition[]>;
+  get(eventId: string): Promise<AnalyticsEventDefinition>;
+  create(data: AnalyticsEventDefinitionInput): Promise<AnalyticsEventDefinition>;
+  update(eventId: string, data: AnalyticsEventDefinitionUpdate | {
+    display: AnalyticsEventDisplayUpdate;
+  }): Promise<AnalyticsEventDefinition>;
+  delete(eventId: string): Promise<void>;
+}
+declare class AnalyticsFunnelsEndpoint {
+  private readonly client;
+  constructor(client: NeopressClient);
+  private get basePath();
+  list(): Promise<AnalyticsFunnelDefinition[]>;
+  get(funnelId: string): Promise<AnalyticsFunnelDefinition>;
+  create(data: AnalyticsFunnelDefinitionInput): Promise<AnalyticsFunnelDefinition>;
+  update(funnelId: string, data: AnalyticsFunnelDefinitionInput): Promise<AnalyticsFunnelDefinition>;
+  delete(funnelId: string): Promise<void>;
 }
 //#endregion
 //#region ../sdk/src/endpoints/templates.d.ts
@@ -600,6 +755,11 @@ interface TemplateMarkParams {
    * card cross-fades from poster to video, so the poster must be the video's
    * first frame. Omit to leave an existing value untouched; `null` clears it. */
   previewVideoUrl?: string | null;
+  /** Primary language of the template's content — required, ISO 639-1 lowercase
+   * two-letter code (`ko`, `en`, `es`). Region-qualified locales (`en-US`) are
+   * rejected: the gallery filters on this key and must not see one language
+   * under two spellings. */
+  language: string;
 }
 interface TemplateDeleteResult {
   siteId: number;
@@ -615,9 +775,8 @@ declare class TemplatesEndpoint {
   /**
    * 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.
+   * Global (not site-scoped) — the accessible-site set is resolved server-side,
+   * where RLS used to do it.
    */
   list(params?: {
     namePrefix?: string;
@@ -627,10 +786,10 @@ declare class TemplatesEndpoint {
 }
 //#endregion
 //#region ../sdk/src/endpoints/headshots.d.ts
-type HeadshotAgeBand = 'young' | 'middle';
-type HeadshotGender = 'male' | 'female';
-type HeadshotEthnicity = 'asian' | 'white' | 'black' | 'latino';
-type HeadshotAttire = 'formal' | 'casual';
+type HeadshotAgeBand = "young" | "middle";
+type HeadshotGender = "male" | "female";
+type HeadshotEthnicity = "asian" | "white" | "black" | "latino";
+type HeadshotAttire = "formal" | "casual";
 interface HeadshotListParams {
   page?: number;
   limit?: number;
@@ -679,9 +838,11 @@ interface HeadshotDeleteResult {
   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.
+ * `headshot_pool` is a GLOBAL (not site-scoped) admin table, so these calls run
+ * over `/api/v1/headshots` — no `siteId` in the path — instead of the
+ * site-scoped `withAuth` routes (W7 T5). The routes gate on the super-admin
+ * user id, which is the same check the table's single RLS policy made; a
+ * non-super-admin now gets 403 where the direct-DB read returned an empty list.
  */
 declare class HeadshotsEndpoint {
   private readonly client;
@@ -694,8 +855,8 @@ declare class HeadshotsEndpoint {
 }
 //#endregion
 //#region ../sdk/src/endpoints/logos.d.ts
-type LogoType = 'wordmark' | 'lockup' | 'signature';
-type LogoTone = 'playful' | 'neutral' | 'serious';
+type LogoType = "wordmark" | "lockup" | "signature";
+type LogoTone = "playful" | "neutral" | "serious";
 interface LogoListParams {
   page?: number;
   limit?: number;
@@ -750,9 +911,11 @@ interface LogoDeleteResult {
   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.
+ * `logo_pool` is a GLOBAL (not site-scoped) admin table, so these calls run over
+ * `/api/v1/logos` — no `siteId` in the path — instead of the site-scoped
+ * `withAuth` routes (W7 T5). The routes gate on the super-admin user id, which
+ * is the same check the table's single RLS policy made; a non-super-admin now
+ * gets 403 where the direct-DB read returned an empty list.
  */
 declare class LogosEndpoint {
   private readonly client;
@@ -765,28 +928,29 @@ declare class LogosEndpoint {
 }
 //#endregion
 //#region ../sdk/src/client.d.ts
+/**
+ * ⚠️ No `supabaseUrl` / `supabaseAnonKey`. This client speaks HTTP to
+ * `/api/v1/**` and nothing else — the direct-DB escape hatch (`client.db`) was
+ * removed in W7 so the seven tables it wrote to could have their
+ * `authenticated` write grants revoked
+ * (`docs/plan/2026-08-17-w7-sdk-retirement.md`). `check-dist-contract.mjs` in
+ * `@neopress/cli` / `@neopress/mcp` fails the build if either option returns.
+ */
 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 */
+  /** Base URL (default: https://app.neopress.ai) */
   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;
@@ -802,26 +966,6 @@ declare class NeopressClient {
   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>>;