@sonordev/site-kit 8.1.0 → 8.3.0

package/dist/chunk-X4IJS7LV.js

@@ -0,0 +1,319 @@
+import { sonorFetch } from './chunk-OIWFXUVD.js';
+import { readPublishedApiConfig } from './chunk-W7OPEMGJ.js';
+
+// src/forms/formsApi.ts
+var config = null;
+function configureFormsApi(options) {
+  config = options;
+}
+function getConfig() {
+  if (config) return config;
+  const { apiUrl, apiKey } = readPublishedApiConfig();
+  if (apiUrl && apiKey) {
+    return { baseUrl: apiUrl, apiKey };
+  }
+  throw new Error(
+    "Forms API not configured. Use SiteKitLayout in your root layout or call configureFormsApi() first."
+  );
+}
+async function apiRequest(method, path, body) {
+  const { baseUrl, apiKey, getAuthToken } = getConfig();
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (apiKey) {
+    headers["x-api-key"] = apiKey;
+  } else if (getAuthToken) {
+    const token = await getAuthToken();
+    headers["Authorization"] = `Bearer ${token}`;
+  }
+  const response = await sonorFetch(`${baseUrl}${path}`, {
+    method,
+    headers,
+    body: body ? JSON.stringify(body) : void 0
+  }, { retries: 0 });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(error.message || `API error: ${response.status}`);
+  }
+  if (response.status === 204) {
+    return void 0;
+  }
+  return response.json();
+}
+var formsApi = {
+  /**
+   * List all forms for a project
+   */
+  async list(options = {}) {
+    const params = new URLSearchParams();
+    if (options.projectId) params.set("projectId", options.projectId);
+    if (options.formType) params.set("formType", options.formType);
+    if (options.isActive !== void 0) params.set("isActive", String(options.isActive));
+    if (options.search) params.set("search", options.search);
+    const query = params.toString();
+    const result = await apiRequest("GET", `/forms${query ? `?${query}` : ""}`);
+    return result.data;
+  },
+  /**
+   * Get a single form by ID or slug
+   */
+  async get(idOrSlug) {
+    return apiRequest("GET", `/forms/${idOrSlug}`);
+  },
+  /**
+   * Create a new form
+   */
+  async create(input) {
+    return apiRequest("POST", "/forms", input);
+  },
+  /**
+   * Update an existing form
+   */
+  async update(id, input) {
+    return apiRequest("PUT", `/forms/${id}`, input);
+  },
+  /**
+   * Delete a form
+   */
+  async delete(id) {
+    return apiRequest("DELETE", `/forms/${id}`);
+  },
+  /**
+   * Add a field to an existing form
+   */
+  async addField(formId, field2) {
+    const form = await formsApi.get(formId);
+    const maxSortOrder = Math.max(0, ...(form.fields || []).map((f) => f.sortOrder || 0));
+    return formsApi.update(formId, {
+      fields: [
+        ...form.fields || [],
+        { ...field2, sortOrder: field2.sortOrder ?? maxSortOrder + 1 }
+      ]
+    });
+  },
+  /**
+   * Update a field in an existing form
+   */
+  async updateField(formId, fieldSlug, updates) {
+    const form = await formsApi.get(formId);
+    return formsApi.update(formId, {
+      fields: (form.fields || []).map(
+        (f) => f.slug === fieldSlug ? { ...f, ...updates } : f
+      )
+    });
+  },
+  /**
+   * Remove a field from a form
+   */
+  async removeField(formId, fieldSlug) {
+    const form = await formsApi.get(formId);
+    return formsApi.update(formId, {
+      fields: (form.fields || []).filter((f) => f.slug !== fieldSlug)
+    });
+  },
+  /**
+   * Reorder fields in a form
+   */
+  async reorderFields(formId, fieldSlugs) {
+    const form = await formsApi.get(formId);
+    const fieldsMap = new Map((form.fields || []).map((f) => [f.slug, f]));
+    const orderedFields = fieldSlugs.map((slug, index) => {
+      const field2 = fieldsMap.get(slug);
+      if (!field2) throw new Error(`Field not found: ${slug}`);
+      return { ...field2, sortOrder: index };
+    });
+    return formsApi.update(formId, { fields: orderedFields });
+  },
+  /**
+   * Clone a form
+   */
+  async clone(formId, newSlug, newName) {
+    const form = await formsApi.get(formId);
+    return formsApi.create({
+      projectId: form.projectId,
+      slug: newSlug,
+      name: newName || `${form.name} (Copy)`,
+      description: form.description,
+      formType: form.formType,
+      successMessage: form.successMessage,
+      redirectUrl: form.redirectUrl,
+      notificationEmails: form.notificationEmails,
+      submitButtonText: form.submitButtonText,
+      layout: form.layout,
+      showProgress: form.showProgress,
+      enableSaveDraft: form.enableSaveDraft,
+      isActive: false,
+      // Clone as inactive
+      fields: (form.fields || []).map(({ id, ...field2 }) => field2),
+      // Remove IDs
+      steps: (form.steps || []).map(({ id, ...step }) => step)
+      // Remove IDs
+    });
+  },
+  /**
+   * Activate or deactivate a form
+   */
+  async setActive(formId, isActive) {
+    return formsApi.update(formId, { isActive });
+  },
+  /**
+   * Sync a form definition to the backend
+   * Creates the form if it doesn't exist, updates if it does
+   * Perfect for defining forms in code during development
+   * 
+   * @example
+   * ```tsx
+   * // In your app initialization or form component
+   * await formsApi.sync({
+   *   slug: 'contact',
+   *   name: 'Contact Form',
+   *   formType: 'prospect',
+   *   fields: [
+   *     field.text('name', 'Your Name', { isRequired: true }),
+   *     field.email('email', 'Email Address'),
+   *     field.phone('phone', 'Phone Number'),
+   *     field.textarea('message', 'Message'),
+   *   ]
+   * })
+   * ```
+   */
+  async sync(input) {
+    return apiRequest(
+      "POST",
+      "/api/public/forms/sync",
+      input
+    );
+  },
+  /**
+   * Sync multiple forms at once
+   * Useful for initializing all forms in your app
+   *
+   * Runs sequentially to avoid bursting the API (many hosts throttle concurrent POSTs → 429).
+   */
+  async syncAll(forms) {
+    const results = [];
+    for (const form of forms) {
+      results.push(await formsApi.sync(form));
+    }
+    return results;
+  }
+};
+var field = {
+  text: (slug, label, options) => ({
+    slug,
+    label,
+    fieldType: "text",
+    ...options
+  }),
+  email: (slug, label, options) => ({
+    slug,
+    label,
+    fieldType: "email",
+    isRequired: true,
+    ...options
+  }),
+  phone: (slug, label, options) => ({
+    slug,
+    label,
+    fieldType: "phone",
+    ...options
+  }),
+  textarea: (slug, label, options) => ({
+    slug,
+    label,
+    fieldType: "textarea",
+    ...options
+  }),
+  select: (slug, label, choices, options) => ({
+    slug,
+    label,
+    fieldType: "select",
+    options: choices,
+    ...options
+  }),
+  radio: (slug, label, choices, options) => ({
+    slug,
+    label,
+    fieldType: "radio",
+    options: choices,
+    ...options
+  }),
+  checkbox: (slug, label, options) => ({
+    slug,
+    label,
+    fieldType: "checkbox",
+    ...options
+  }),
+  date: (slug, label, options) => ({
+    slug,
+    label,
+    fieldType: "date",
+    ...options
+  }),
+  number: (slug, label, options) => ({
+    slug,
+    label,
+    fieldType: "number",
+    ...options
+  }),
+  rating: (slug, label, options) => ({
+    slug,
+    label,
+    fieldType: "rating",
+    ...options
+  }),
+  file: (slug, label, options) => ({
+    slug,
+    label,
+    fieldType: "file",
+    ...options
+  }),
+  hidden: (slug, defaultValue) => ({
+    slug,
+    label: "",
+    fieldType: "hidden",
+    defaultValue
+  }),
+  heading: (slug, label) => ({
+    slug,
+    label,
+    fieldType: "heading"
+  }),
+  paragraph: (slug, label) => ({
+    slug,
+    label,
+    fieldType: "paragraph"
+  })
+};
+function defineForm(definition) {
+  const fieldsWithOrder = definition.fields.map((f, index) => ({
+    ...f,
+    sortOrder: f.sortOrder ?? index
+  }));
+  return {
+    ...definition,
+    fields: fieldsWithOrder,
+    formType: definition.formType || "contact",
+    successMessage: definition.successMessage || "Thank you for your submission!",
+    submitButtonText: definition.submitButtonText || "Submit",
+    layout: definition.layout || "stacked",
+    isActive: definition.isActive ?? true
+  };
+}
+async function initializeForms(forms) {
+  if (typeof window === "undefined") {
+    console.log(`[Site-Kit] ${forms.length} form(s) ready to sync: ${forms.map((f) => f.slug).join(", ")}`);
+    return;
+  }
+  try {
+    const results = await formsApi.syncAll(forms);
+    const created = results.filter((r) => r.created).length;
+    const updated = results.filter((r) => r.updated).length;
+    console.log(`[Site-Kit] Forms synced: ${created} created, ${updated} updated`);
+  } catch (error) {
+    console.error("[Site-Kit] Failed to sync forms:", error);
+  }
+}
+
+export { configureFormsApi, defineForm, field, formsApi, initializeForms };

package/dist/{chunk-JIH32RH2.js → chunk-XA7Q2VQA.js}

@@ -1,7 +1,7 @@
 import { freshFetch } from './chunk-UAYAJPEP.js';
 import { LLM_GEO_CONTRACT_VERSION } from './chunk-NZ4RXN3G.js';
 import { withSiteParam } from './chunk-MJP63SSS.js';
-import { getClientApiConfig } from './chunk-3G7YABRA.js';
+import { getClientApiConfig } from './chunk-W7OPEMGJ.js';
 import { cache } from 'react';
 
 function getApiConfig() {

package/dist/{chunk-5L467Z5Q.js → chunk-XLAXYPTK.js}

@@ -1,6 +1,6 @@
 'use client';
-import { countStageViews, countStageQuestions, useFieldControls } from './chunk-XUCU3LX4.js';
-import { useFormLoadedAt, useFormTracking, submitForm, useRecaptchaWarmup, useForm } from './chunk-S6IGQYHW.js';
+import { countStageViews, countStageQuestions, useFieldControls } from './chunk-DPSNMOMZ.js';
+import { useFormLoadedAt, useFormTracking, submitForm, useRecaptchaWarmup, useForm } from './chunk-MQ4REMTH.js';
 import { readAgentSubmit, formToolAttributes } from './chunk-Q6E4OPGG.js';
 import { isFieldVisible, validateField, isFieldComplete, isDisplayOnly, unseenControlValues } from './chunk-C2FZBUSS.js';
 import { HoneypotField } from './chunk-DXO6SBMD.js';
@@ -63,7 +63,7 @@ function FormClient({
       return;
     }
     let cancelled = false;
-    const load = resolvedExperience === "stage" ? import('./FormStage-CJUSCSAL.js').then((m) => m.FormStage) : import('./FormSpotlight-VGC4CZL4.js').then((m) => m.FormSpotlight);
+    const load = resolvedExperience === "stage" ? import('./FormStage-RC3WHHXP.js').then((m) => m.FormStage) : import('./FormSpotlight-JFH2ENKQ.js').then((m) => m.FormSpotlight);
     load.then((Component) => {
       if (!cancelled) setExperience(() => Component);
     }).catch((err) => {

package/dist/client/index.js

@@ -1,5 +1,6 @@
 'use client';
-import { publishSiteCredential } from '../chunk-6VHDCJIZ.js';
+export { SiteKitCredential } from '../chunk-IEGDPRQB.js';
+import '../chunk-U7Y3QG3A.js';
 export { VISUAL_VIEWPORT_GAP_PROPERTY, VisualViewportGap, useVisualViewportGap } from '../chunk-6T6CQVNL.js';
 export { useDeferredActivation } from '../chunk-YC7ELZS3.js';
 import '../chunk-FESKKJAS.js';
@@ -8,19 +9,6 @@ export { trackConversion, trackEvent } from '../chunk-LCDVPAMR.js';
 export { getOrCreateSessionId, getOrCreateVisitorId, useSiteKitIdentity } from '../chunk-ZKADJNR2.js';
 import '../chunk-5TM3WPCI.js';
 import '../chunk-GJWI74ZZ.js';
-import '../chunk-F2VYN3QL.js';
-import '../chunk-NWVB75ER.js';
+import '../chunk-C4AFNZT2.js';
+import '../chunk-C2UROFGZ.js';
 import '../chunk-PKBMQBKP.js';
-
-// src/client/SiteKitCredential.tsx
-function SiteKitCredential({
-  apiKey,
-  apiUrl,
-  site,
-  debug
-}) {
-  publishSiteCredential({ apiKey, apiUrl, site, debug });
-  return null;
-}
-
-export { SiteKitCredential };

package/dist/contracts/editorial-media.d.ts

@@ -0,0 +1,39 @@
+/** Shared article placement and source eligibility rules. Pure, server/client safe. */
+export type EditorialPhotoPlacement = {
+    kind: 'after_intro';
+} | {
+    kind: 'after_heading';
+    heading: string;
+    headingId?: string;
+};
+export type ArticlePhotoPlacementStatus = 'placed' | 'missing_heading' | 'ambiguous_heading' | 'no_paragraph' | 'already_present' | 'unassigned';
+export interface EditorialHeadingTarget {
+    id: string;
+    text: string;
+    level: number;
+    eligible: boolean;
+}
+export declare function editorialPlainText(value: string): string;
+/** A text identity, never a positional index. Editing the meaning requires a new assignment. */
+export declare function editorialTextId(kind: 'section' | 'takeaway', text: string): string;
+export declare function resolveArticlePhotoPlacements(html: string, photos?: Array<{
+    placement?: EditorialPhotoPlacement;
+    url?: string;
+}>): {
+    headings: {
+        id: string;
+        text: string;
+        level: number;
+        eligible: boolean;
+    }[];
+    placements: {
+        index: number;
+        status: ArticlePhotoPlacementStatus;
+        offset?: number;
+    }[];
+};
+export declare const EDITORIAL_PHOTO_MIME_TYPES: readonly ['image/jpeg', 'image/jpg', 'image/png', 'image/webp', 'image/avif'];
+export declare const EDITORIAL_PHOTO_MAX_BYTES: number;
+/** The same generated-art path exclusion is used by the picker and source resolver. */
+export declare const FINISHED_EDITORIAL_ART_PATHS: readonly ['Blog/Cards', 'Blog/Carousel', 'Broadcast/Cards', 'Broadcast/StylePreview', 'Reviews/Broadcast', 'Reviews/Photo', 'Reviews/StylePreview'];
+export declare function isFinishedEditorialArtwork(path: string): boolean;

package/dist/contracts/entries.d.ts

@@ -4,5 +4,5 @@
  * tsup config, its package.json check and the boundary test, so a new
  * contract is added in one place.
  */
-export declare const CONTRACT_ENTRIES: readonly ['forms', 'llms', 'slots', 'slot-content', 'site-cache', 'site-edit', 'website', 'color', 'fleet', 'sites', 'seo-pages', 'seo-meta', 'portfolio', 'voice', 'proposal-sitemap', 'error-page', 'schema-placeholders', 'sentences', 'knowledge'];
+export declare const CONTRACT_ENTRIES: readonly ['forms', 'llms', 'slots', 'slot-content', 'site-cache', 'site-edit', 'website', 'color', 'fleet', 'sites', 'seo-pages', 'seo-meta', 'portfolio', 'voice', 'proposal-sitemap', 'error-page', 'schema-placeholders', 'sentences', 'knowledge', 'editorial-media'];
 export type ContractEntry = (typeof CONTRACT_ENTRIES)[number];

package/dist/fleet/index.js

@@ -1,11 +1,11 @@
 'use client';
-export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-RSBMQFZW.js';
+export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-LPKKSYKX.js';
 export { FLEET_CONTRACT_VERSION, FLEET_MODULES, FLEET_MODULES_MAX, FLEET_SITE_MAX_LENGTH, FLEET_VERSION_MAX_LENGTH, FLEET_VERSION_PATTERN, buildFleetHeartbeatPayload, isFleetModule, normalizeFleetModules, normalizeFleetSite, sanitizeFleetVersion } from '../chunk-ZTZQPYP6.js';
 import '../chunk-YC7ELZS3.js';
-import '../chunk-CAH4Y4PY.js';
+import '../chunk-JO76F5WP.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-3G7YABRA.js';
-import '../chunk-WPOFTCKL.js';
-import '../chunk-F2VYN3QL.js';
-import '../chunk-NWVB75ER.js';
+import '../chunk-OIWFXUVD.js';
+import '../chunk-C4AFNZT2.js';
+import '../chunk-W7OPEMGJ.js';
+import '../chunk-C2UROFGZ.js';
 import '../chunk-PKBMQBKP.js';