ghostfill 0.1.2 → 0.2.0

package/dist/server.d.mts

@@ -0,0 +1,12 @@
+import { b as GhostFillAIRequest, F as FieldFillData, D as DetectedField, c as GhostFillPromptField } from './types-B3DGbZyx.mjs';
+export { d as PROVIDERS, P as Provider } from './types-B3DGbZyx.mjs';
+
+declare const SYSTEM_PROMPT = "You are a form-filling assistant. Given a list of form fields and an optional user prompt, generate realistic fake data to fill ALL fields.\n\nRules:\n- Return ONLY a JSON object with a \"fields\" array of objects, each with \"index\" and \"value\" keys\n- You MUST fill EVERY field \u2014 do not skip any\n- Match the field type (email \u2192 valid email, phone \u2192 valid phone with country code, date \u2192 YYYY-MM-DD, datetime-local \u2192 YYYY-MM-DDTHH:MM, etc.)\n- For select/dropdown fields: you MUST pick one of the listed options EXACTLY as written\n- For checkboxes: add a \"checked\" boolean (true or false)\n- For radio buttons: only fill one per group, use the option value\n- Respect min/max constraints and patterns\n- Generate contextually coherent data (same person's name, matching city/state/zip, etc.)\n- If no user prompt is given, infer appropriate data from the field labels\n- Do NOT request or rely on secrets, tokens, passwords, or existing form values\n- Do NOT wrap the JSON in markdown code blocks \u2014 return raw JSON only";
+declare function toPromptFields(fields: DetectedField[]): GhostFillPromptField[];
+declare function buildFillMessages(request: GhostFillAIRequest): Array<{
+    role: "system" | "user";
+    content: string;
+}>;
+declare function parseFillDataPayload(payload: unknown): FieldFillData[];
+
+export { FieldFillData, GhostFillAIRequest, GhostFillPromptField, SYSTEM_PROMPT, buildFillMessages, parseFillDataPayload, toPromptFields };

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+import { b as GhostFillAIRequest, F as FieldFillData, D as DetectedField, c as GhostFillPromptField } from './types-B3DGbZyx.js';
+export { d as PROVIDERS, P as Provider } from './types-B3DGbZyx.js';
+
+declare const SYSTEM_PROMPT = "You are a form-filling assistant. Given a list of form fields and an optional user prompt, generate realistic fake data to fill ALL fields.\n\nRules:\n- Return ONLY a JSON object with a \"fields\" array of objects, each with \"index\" and \"value\" keys\n- You MUST fill EVERY field \u2014 do not skip any\n- Match the field type (email \u2192 valid email, phone \u2192 valid phone with country code, date \u2192 YYYY-MM-DD, datetime-local \u2192 YYYY-MM-DDTHH:MM, etc.)\n- For select/dropdown fields: you MUST pick one of the listed options EXACTLY as written\n- For checkboxes: add a \"checked\" boolean (true or false)\n- For radio buttons: only fill one per group, use the option value\n- Respect min/max constraints and patterns\n- Generate contextually coherent data (same person's name, matching city/state/zip, etc.)\n- If no user prompt is given, infer appropriate data from the field labels\n- Do NOT request or rely on secrets, tokens, passwords, or existing form values\n- Do NOT wrap the JSON in markdown code blocks \u2014 return raw JSON only";
+declare function toPromptFields(fields: DetectedField[]): GhostFillPromptField[];
+declare function buildFillMessages(request: GhostFillAIRequest): Array<{
+    role: "system" | "user";
+    content: string;
+}>;
+declare function parseFillDataPayload(payload: unknown): FieldFillData[];
+
+export { FieldFillData, GhostFillAIRequest, GhostFillPromptField, SYSTEM_PROMPT, buildFillMessages, parseFillDataPayload, toPromptFields };

package/dist/server.js

@@ -0,0 +1,165 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  PROVIDERS: () => PROVIDERS,
+  SYSTEM_PROMPT: () => SYSTEM_PROMPT,
+  buildFillMessages: () => buildFillMessages,
+  parseFillDataPayload: () => parseFillDataPayload,
+  toPromptFields: () => toPromptFields
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/detector.ts
+var INPUT_SELECTORS = [
+  "input:not([type=hidden]):not([type=submit]):not([type=button]):not([type=reset]):not([type=image])",
+  "textarea",
+  "select",
+  // Custom dropdown triggers (Headless UI Listbox, Radix, etc.)
+  "button[role=combobox]",
+  "[role=combobox]:not(input)",
+  "button[aria-haspopup=listbox]"
+].join(", ");
+function describeFields(fields) {
+  return fields.map((f, i) => {
+    let desc = `[${i}] "${f.label}" (type: ${f.type}`;
+    if (f.required) desc += ", required";
+    if (f.options?.length) desc += `, options: [${f.options.join(", ")}]`;
+    if (f.min) desc += `, min: ${f.min}`;
+    if (f.max) desc += `, max: ${f.max}`;
+    if (f.pattern) desc += `, pattern: ${f.pattern}`;
+    desc += ")";
+    return desc;
+  }).join("\n");
+}
+
+// src/ai.ts
+var SYSTEM_PROMPT = `You are a form-filling assistant. Given a list of form fields and an optional user prompt, generate realistic fake data to fill ALL fields.
+
+Rules:
+- Return ONLY a JSON object with a "fields" array of objects, each with "index" and "value" keys
+- You MUST fill EVERY field \u2014 do not skip any
+- Match the field type (email \u2192 valid email, phone \u2192 valid phone with country code, date \u2192 YYYY-MM-DD, datetime-local \u2192 YYYY-MM-DDTHH:MM, etc.)
+- For select/dropdown fields: you MUST pick one of the listed options EXACTLY as written
+- For checkboxes: add a "checked" boolean (true or false)
+- For radio buttons: only fill one per group, use the option value
+- Respect min/max constraints and patterns
+- Generate contextually coherent data (same person's name, matching city/state/zip, etc.)
+- If no user prompt is given, infer appropriate data from the field labels
+- Do NOT request or rely on secrets, tokens, passwords, or existing form values
+- Do NOT wrap the JSON in markdown code blocks \u2014 return raw JSON only`;
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function toFieldFillData(value) {
+  if (!isRecord(value)) {
+    throw new Error("AI response item is not an object");
+  }
+  const index = value.index;
+  const rawValue = value.value;
+  const checked = value.checked;
+  if (typeof index !== "number" || !Number.isInteger(index)) {
+    throw new Error("AI response item is missing a numeric index");
+  }
+  if (typeof rawValue !== "string") {
+    throw new Error("AI response item is missing a string value");
+  }
+  return {
+    index,
+    value: rawValue,
+    checked: typeof checked === "boolean" ? checked : void 0
+  };
+}
+function toPromptFields(fields) {
+  return fields.map((field, index) => ({
+    index,
+    type: field.type,
+    name: field.name,
+    label: field.label,
+    options: field.options,
+    required: field.required,
+    min: field.min,
+    max: field.max,
+    pattern: field.pattern
+  }));
+}
+function buildFillMessages(request) {
+  const fieldDescription = describeFields(request.fields);
+  let userContent = `Form fields:
+${fieldDescription}`;
+  if (request.prompt) {
+    userContent += `
+
+User instructions: ${request.prompt}`;
+  } else {
+    userContent += "\n\nNo specific instructions \u2014 generate realistic, contextually appropriate data for all fields.";
+  }
+  return [
+    {
+      role: "system",
+      content: request.systemPrompt ? `${request.systemPrompt}
+
+${SYSTEM_PROMPT}` : SYSTEM_PROMPT
+    },
+    {
+      role: "user",
+      content: userContent
+    }
+  ];
+}
+function parseFillDataPayload(payload) {
+  if (typeof payload === "string") {
+    const jsonMatch = payload.match(/```(?:json)?\s*([\s\S]*?)```/) || [null, payload];
+    return parseFillDataPayload(JSON.parse(jsonMatch[1].trim()));
+  }
+  if (Array.isArray(payload)) {
+    return payload.map(toFieldFillData);
+  }
+  if (isRecord(payload)) {
+    if (Array.isArray(payload.choices)) {
+      const content = payload.choices[0]?.message;
+      if (typeof content?.content === "string") {
+        return parseFillDataPayload(content.content);
+      }
+    }
+    const candidate = payload.fields ?? payload.data ?? payload.items ?? payload.result;
+    if (Array.isArray(candidate)) {
+      return candidate.map(toFieldFillData);
+    }
+  }
+  throw new Error("AI response is not an array of field fills");
+}
+
+// src/types.ts
+var PROVIDERS = {
+  openai: { label: "OpenAI", model: "gpt-4o-mini", baseURL: "https://api.openai.com/v1", helpText: "Uses gpt-4o-mini \u2014 fast & cheap" },
+  xai: { label: "xAI", model: "grok-4-fast", baseURL: "https://api.x.ai/v1", helpText: "Uses Grok 4 Fast" },
+  moonshot: { label: "Moonshot", model: "kimi-k2", baseURL: "https://api.moonshot.ai/v1", helpText: "Uses Kimi K2 \u2014 fast & cheap" }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PROVIDERS,
+  SYSTEM_PROMPT,
+  buildFillMessages,
+  parseFillDataPayload,
+  toPromptFields
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/detector.ts","../src/ai.ts","../src/types.ts"],"sourcesContent":["export {\n  SYSTEM_PROMPT,\n  buildFillMessages,\n  parseFillDataPayload,\n  toPromptFields,\n} from \"./ai\";\nexport { PROVIDERS } from \"./types\";\nexport type {\n  FieldFillData,\n  GhostFillAIRequest,\n  GhostFillPromptField,\n  Provider,\n} from \"./types\";\n","import type { DetectedField, GhostFillPromptField } from \"./types\";\n\nconst INPUT_SELECTORS = [\n  \"input:not([type=hidden]):not([type=submit]):not([type=button]):not([type=reset]):not([type=image])\",\n  \"textarea\",\n  \"select\",\n  // Custom dropdown triggers (Headless UI Listbox, Radix, etc.)\n  \"button[role=combobox]\",\n  \"[role=combobox]:not(input)\",\n  \"button[aria-haspopup=listbox]\",\n].join(\", \");\n\n/** Find the label text for a form field */\nfunction findLabel(el: HTMLElement): string {\n  // 1. Explicit <label for=\"id\">\n  if (el.id) {\n    const label = document.querySelector<HTMLLabelElement>(\n      `label[for=\"${CSS.escape(el.id)}\"]`\n    );\n    if (label?.textContent?.trim()) return label.textContent.trim();\n  }\n\n  // 2. Wrapping <label>\n  const parentLabel = el.closest(\"label\");\n  if (parentLabel) {\n    // Get text content excluding the input itself\n    const clone = parentLabel.cloneNode(true) as HTMLElement;\n    clone.querySelectorAll(\"input, textarea, select\").forEach((c) => c.remove());\n    const text = clone.textContent?.trim();\n    if (text) return text;\n  }\n\n  // 3. aria-label\n  const ariaLabel = el.getAttribute(\"aria-label\");\n  if (ariaLabel?.trim()) return ariaLabel.trim();\n\n  // 4. aria-labelledby\n  const labelledBy = el.getAttribute(\"aria-labelledby\");\n  if (labelledBy) {\n    const parts = labelledBy\n      .split(/\\s+/)\n      .map((id) => document.getElementById(id)?.textContent?.trim())\n      .filter(Boolean);\n    if (parts.length) return parts.join(\" \");\n  }\n\n  // 5. placeholder\n  if (\"placeholder\" in el) {\n    const ph = (el as HTMLInputElement).placeholder;\n    if (ph?.trim()) return ph.trim();\n  }\n\n  // 6. title\n  const title = el.getAttribute(\"title\");\n  if (title?.trim()) return title.trim();\n\n  // 7. Preceding sibling text (common pattern: <span>Label</span><input>)\n  const prev = el.previousElementSibling;\n  if (prev && ![\"INPUT\", \"TEXTAREA\", \"SELECT\"].includes(prev.tagName)) {\n    const prevText = prev.textContent?.trim();\n    if (prevText && prevText.length < 60) return prevText;\n  }\n\n  // 8. Parent's first text node or heading\n  const parent = el.parentElement;\n  if (parent) {\n    // Look for a heading or label-like element before this input in the parent\n    for (const child of Array.from(parent.children)) {\n      if (child === el) break;\n      if ([\"LABEL\", \"SPAN\", \"P\", \"H1\", \"H2\", \"H3\", \"H4\", \"H5\", \"H6\", \"LEGEND\", \"DIV\"].includes(child.tagName)) {\n        const text = child.textContent?.trim();\n        if (text && text.length < 60 && !child.querySelector(\"input, textarea, select\")) {\n          return text;\n        }\n      }\n    }\n  }\n\n  // 9. id attribute humanized\n  if (el.id) return el.id.replace(/[_\\-]/g, \" \").replace(/([a-z])([A-Z])/g, \"$1 $2\").trim();\n\n  // 10. name attribute as fallback\n  const name = el.getAttribute(\"name\");\n  if (name) return name.replace(/[_\\-[\\]]/g, \" \").replace(/([a-z])([A-Z])/g, \"$1 $2\").trim();\n\n  return \"unknown\";\n}\n\n/** Detect all fillable fields within a container element */\nexport function detectFields(container: HTMLElement): DetectedField[] {\n  const elements = container.querySelectorAll<\n    HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement\n  >(INPUT_SELECTORS);\n\n  const fields: DetectedField[] = [];\n\n  elements.forEach((el) => {\n    // Skip disabled fields\n    if ((el as HTMLInputElement).disabled) return;\n    if ((el as HTMLInputElement).readOnly) return;\n    // Skip hidden elements\n    if (el.offsetParent === null && (el as HTMLInputElement).type !== \"hidden\") return;\n\n    // Custom combobox / listbox (Headless UI, Radix, etc.)\n    const isCustomDropdown =\n      (el.getAttribute(\"role\") === \"combobox\" && !(el instanceof HTMLInputElement)) ||\n      el.getAttribute(\"aria-haspopup\") === \"listbox\";\n    if (isCustomDropdown) {\n      // Find listbox options: aria-controls, sibling [role=listbox], or Headless UI pattern\n      const listboxId = el.getAttribute(\"aria-controls\");\n      let listbox: Element | null = listboxId ? document.getElementById(listboxId) : null;\n      if (!listbox) {\n        // Headless UI puts the listbox as a sibling inside the same relative container\n        listbox = el.parentElement?.querySelector(\"[role=listbox]\") || null;\n      }\n\n      const options: string[] = [];\n      if (listbox) {\n        listbox.querySelectorAll(\"[role=option]\").forEach((opt) => {\n          const text = opt.textContent?.trim();\n          if (text) options.push(text);\n        });\n      }\n\n      // Get current display value from button text\n      const buttonText = el.textContent?.trim() || \"\";\n      // Check if it looks like a placeholder\n      const looksLikePlaceholder = buttonText.toLowerCase().startsWith(\"select\") || buttonText === \"\";\n\n      const field: DetectedField = {\n        element: el as any,\n        type: \"select\",\n        name: el.id || el.getAttribute(\"name\") || \"\",\n        label: findLabel(el),\n        required: el.getAttribute(\"aria-required\") === \"true\",\n        currentValue: looksLikePlaceholder ? \"\" : buttonText,\n        options: options.length > 0 ? options : undefined,\n      };\n      fields.push(field);\n      return;\n    }\n\n    const field: DetectedField = {\n      element: el as HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement,\n      type: el instanceof HTMLSelectElement ? \"select\" : (el as HTMLInputElement).type || \"text\",\n      name: (el as HTMLInputElement).name || el.id || \"\",\n      label: findLabel(el),\n      required: (el as HTMLInputElement).required || el.getAttribute(\"aria-required\") === \"true\",\n      currentValue: (el as HTMLInputElement).value,\n    };\n\n    // Collect select options\n    if (el instanceof HTMLSelectElement) {\n      field.options = Array.from(el.options)\n        .filter((opt) => opt.value && !opt.disabled)\n        .map((opt) => opt.textContent?.trim() || opt.value);\n    }\n\n    // Collect constraints\n    if (\"min\" in el && (el as HTMLInputElement).min) {\n      field.min = (el as HTMLInputElement).min;\n    }\n    if (\"max\" in el && (el as HTMLInputElement).max) {\n      field.max = (el as HTMLInputElement).max;\n    }\n    if (\"pattern\" in el && (el as HTMLInputElement).pattern) {\n      field.pattern = (el as HTMLInputElement).pattern;\n    }\n\n    fields.push(field);\n  });\n\n  return fields;\n}\n\n/** Build a description of fields for the AI prompt */\nexport function describeFields(\n  fields: Array<\n    Pick<\n      DetectedField | GhostFillPromptField,\n      \"type\" | \"label\" | \"required\" | \"options\" | \"min\" | \"max\" | \"pattern\"\n    >\n  >\n): string {\n  return fields\n    .map((f, i) => {\n      let desc = `[${i}] \"${f.label}\" (type: ${f.type}`;\n      if (f.required) desc += \", required\";\n      if (f.options?.length) desc += `, options: [${f.options.join(\", \")}]`;\n      if (f.min) desc += `, min: ${f.min}`;\n      if (f.max) desc += `, max: ${f.max}`;\n      if (f.pattern) desc += `, pattern: ${f.pattern}`;\n      desc += \")\";\n      return desc;\n    })\n    .join(\"\\n\");\n}\n","import { describeFields } from \"./detector\";\nimport type {\n  DetectedField,\n  FieldFillData,\n  GhostFillAIOptions,\n  GhostFillAIRequest,\n  GhostFillPromptField,\n  Provider,\n} from \"./types\";\n\nexport const SYSTEM_PROMPT = `You are a form-filling assistant. Given a list of form fields and an optional user prompt, generate realistic fake data to fill ALL fields.\n\nRules:\n- Return ONLY a JSON object with a \"fields\" array of objects, each with \"index\" and \"value\" keys\n- You MUST fill EVERY field — do not skip any\n- Match the field type (email → valid email, phone → valid phone with country code, date → YYYY-MM-DD, datetime-local → YYYY-MM-DDTHH:MM, etc.)\n- For select/dropdown fields: you MUST pick one of the listed options EXACTLY as written\n- For checkboxes: add a \"checked\" boolean (true or false)\n- For radio buttons: only fill one per group, use the option value\n- Respect min/max constraints and patterns\n- Generate contextually coherent data (same person's name, matching city/state/zip, etc.)\n- If no user prompt is given, infer appropriate data from the field labels\n- Do NOT request or rely on secrets, tokens, passwords, or existing form values\n- Do NOT wrap the JSON in markdown code blocks — return raw JSON only`;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction toFieldFillData(value: unknown): FieldFillData {\n  if (!isRecord(value)) {\n    throw new Error(\"AI response item is not an object\");\n  }\n\n  const index = value.index;\n  const rawValue = value.value;\n  const checked = value.checked;\n\n  if (typeof index !== \"number\" || !Number.isInteger(index)) {\n    throw new Error(\"AI response item is missing a numeric index\");\n  }\n\n  if (typeof rawValue !== \"string\") {\n    throw new Error(\"AI response item is missing a string value\");\n  }\n\n  return {\n    index,\n    value: rawValue,\n    checked: typeof checked === \"boolean\" ? checked : undefined,\n  };\n}\n\nexport function toPromptFields(fields: DetectedField[]): GhostFillPromptField[] {\n  return fields.map((field, index) => ({\n    index,\n    type: field.type,\n    name: field.name,\n    label: field.label,\n    options: field.options,\n    required: field.required,\n    min: field.min,\n    max: field.max,\n    pattern: field.pattern,\n  }));\n}\n\nexport function buildFillMessages(\n  request: GhostFillAIRequest\n): Array<{ role: \"system\" | \"user\"; content: string }> {\n  const fieldDescription = describeFields(request.fields);\n  let userContent = `Form fields:\\n${fieldDescription}`;\n\n  if (request.prompt) {\n    userContent += `\\n\\nUser instructions: ${request.prompt}`;\n  } else {\n    userContent +=\n      \"\\n\\nNo specific instructions — generate realistic, contextually appropriate data for all fields.\";\n  }\n\n  return [\n    {\n      role: \"system\",\n      content: request.systemPrompt\n        ? `${request.systemPrompt}\\n\\n${SYSTEM_PROMPT}`\n        : SYSTEM_PROMPT,\n    },\n    {\n      role: \"user\",\n      content: userContent,\n    },\n  ];\n}\n\nexport function parseFillDataPayload(payload: unknown): FieldFillData[] {\n  if (typeof payload === \"string\") {\n    const jsonMatch =\n      payload.match(/```(?:json)?\\s*([\\s\\S]*?)```/) || [null, payload];\n    return parseFillDataPayload(JSON.parse(jsonMatch[1]!.trim()));\n  }\n\n  if (Array.isArray(payload)) {\n    return payload.map(toFieldFillData);\n  }\n\n  if (isRecord(payload)) {\n    if (Array.isArray(payload.choices)) {\n      const content = (payload.choices[0] as Record<string, unknown> | undefined)\n        ?.message as Record<string, unknown> | undefined;\n      if (typeof content?.content === \"string\") {\n        return parseFillDataPayload(content.content);\n      }\n    }\n\n    const candidate =\n      payload.fields ?? payload.data ?? payload.items ?? payload.result;\n    if (Array.isArray(candidate)) {\n      return candidate.map(toFieldFillData);\n    }\n  }\n\n  throw new Error(\"AI response is not an array of field fills\");\n}\n\nfunction createRequest(\n  fields: DetectedField[],\n  userPrompt: string,\n  provider: Provider,\n  systemPrompt?: string\n): GhostFillAIRequest {\n  return {\n    provider,\n    prompt: userPrompt,\n    systemPrompt,\n    fields: toPromptFields(fields),\n  };\n}\n\n/** Call a secure backend or callback to generate fill data. */\nexport async function generateFillData(\n  fields: DetectedField[],\n  userPrompt: string,\n  provider: Provider,\n  transport: GhostFillAIOptions,\n  systemPrompt?: string\n): Promise<FieldFillData[]> {\n  const request = createRequest(fields, userPrompt, provider, systemPrompt);\n\n  if (transport.requestFillData) {\n    return transport.requestFillData(request);\n  }\n\n  const endpoint = transport.endpoint ?? \"/api/ghostfill\";\n  const response = await fetch(endpoint, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify(request),\n  });\n\n  if (!response.ok) {\n    const error = await response.text();\n    throw new Error(`AI API error (${response.status}): ${error}`);\n  }\n\n  const contentType = response.headers.get(\"content-type\") || \"\";\n  const payload = contentType.includes(\"application/json\")\n    ? await response.json()\n    : await response.text();\n\n  return parseFillDataPayload(payload);\n}\n","/** Configuration options for GhostFill */\nexport interface GhostFillOptions {\n  /**\n   * @deprecated Browser API keys are insecure and ignored.\n   * Configure `ai` and keep provider credentials on your backend instead.\n   */\n  apiKey?: string;\n  /** Keyboard shortcut to toggle GhostFill (default: \"Alt+G\") */\n  shortcut?: string;\n  /** Custom system prompt to prepend */\n  systemPrompt?: string;\n  /** Secure AI transport configuration */\n  ai?: GhostFillAIOptions;\n}\n\nexport type Provider = \"openai\" | \"xai\" | \"moonshot\";\n\nexport const PROVIDERS: Record<Provider, { label: string; model: string; baseURL: string; helpText: string }> = {\n  openai: { label: \"OpenAI\", model: \"gpt-4o-mini\", baseURL: \"https://api.openai.com/v1\", helpText: \"Uses gpt-4o-mini — fast & cheap\" },\n  xai: { label: \"xAI\", model: \"grok-4-fast\", baseURL: \"https://api.x.ai/v1\", helpText: \"Uses Grok 4 Fast\" },\n  moonshot: { label: \"Moonshot\", model: \"kimi-k2\", baseURL: \"https://api.moonshot.ai/v1\", helpText: \"Uses Kimi K2 — fast & cheap\" },\n};\n\n/** Non-secret field metadata sent to an AI backend */\nexport interface GhostFillPromptField {\n  index: number;\n  type: string;\n  name: string;\n  label: string;\n  options?: string[];\n  required: boolean;\n  min?: string;\n  max?: string;\n  pattern?: string;\n}\n\n/** Secure AI request payload for a backend route or callback */\nexport interface GhostFillAIRequest {\n  provider: Provider;\n  prompt: string;\n  systemPrompt?: string;\n  fields: GhostFillPromptField[];\n}\n\nexport type GhostFillAIHandler = (\n  request: GhostFillAIRequest\n) => Promise<FieldFillData[]>;\n\n/** Secure AI configuration. Requests must go through a backend or custom handler. */\nexport interface GhostFillAIOptions {\n  /** Same-origin backend route. Defaults to `/api/ghostfill` when `ai` is enabled. */\n  endpoint?: string;\n  /** Optional custom transport that forwards requests to a secure backend. */\n  requestFillData?: GhostFillAIHandler;\n  /** Default provider shown in the UI. */\n  provider?: Provider;\n}\n\n/** A saved prompt preset */\nexport interface Preset {\n  id: string;\n  name: string;\n  prompt: string;\n}\n\n/** Persisted settings (localStorage) */\nexport interface GhostFillSettings {\n  apiKey: string;\n  provider: Provider;\n  highlightColor: string;\n  theme: \"dark\" | \"light\";\n  useAI: boolean;\n  presets: Preset[];\n  activePresetId: string | null;\n}\n\n/** A detected form field */\nexport interface DetectedField {\n  /** The DOM element */\n  element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;\n  /** Field type: text, email, number, select, textarea, checkbox, radio, date, etc. */\n  type: string;\n  /** Field name attribute */\n  name: string;\n  /** Field label (from <label>, aria-label, or placeholder) */\n  label: string;\n  /** For <select>, the available options */\n  options?: string[];\n  /** Whether the field is required */\n  required: boolean;\n  /** Current value */\n  currentValue: string;\n  /** Min/max for number/date fields */\n  min?: string;\n  max?: string;\n  /** Pattern attribute */\n  pattern?: string;\n}\n\n/** Field data returned by the AI */\nexport interface FieldFillData {\n  /** Index matching the DetectedField array */\n  index: number;\n  /** Value to fill */\n  value: string;\n  /** For checkboxes: whether to check */\n  checked?: boolean;\n}\n\n/** Internal state */\nexport interface GhostFillState {\n  active: boolean;\n  selecting: boolean;\n  selectedBlock: HTMLElement | null;\n  fields: DetectedField[];\n  overlay: HTMLElement | null;\n  shadowRoot: ShadowRoot | null;\n}\n"],"mappings":"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","names":[]}

package/dist/server.mjs

@@ -0,0 +1,15 @@
+import {
+  PROVIDERS,
+  SYSTEM_PROMPT,
+  buildFillMessages,
+  parseFillDataPayload,
+  toPromptFields
+} from "./chunk-VMCU3BNJ.mjs";
+export {
+  PROVIDERS,
+  SYSTEM_PROMPT,
+  buildFillMessages,
+  parseFillDataPayload,
+  toPromptFields
+};
+//# sourceMappingURL=server.mjs.map

package/dist/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types-B3DGbZyx.d.mts

@@ -0,0 +1,83 @@
+/** Configuration options for GhostFill */
+interface GhostFillOptions {
+    /**
+     * @deprecated Browser API keys are insecure and ignored.
+     * Configure `ai` and keep provider credentials on your backend instead.
+     */
+    apiKey?: string;
+    /** Keyboard shortcut to toggle GhostFill (default: "Alt+G") */
+    shortcut?: string;
+    /** Custom system prompt to prepend */
+    systemPrompt?: string;
+    /** Secure AI transport configuration */
+    ai?: GhostFillAIOptions;
+}
+type Provider = "openai" | "xai" | "moonshot";
+declare const PROVIDERS: Record<Provider, {
+    label: string;
+    model: string;
+    baseURL: string;
+    helpText: string;
+}>;
+/** Non-secret field metadata sent to an AI backend */
+interface GhostFillPromptField {
+    index: number;
+    type: string;
+    name: string;
+    label: string;
+    options?: string[];
+    required: boolean;
+    min?: string;
+    max?: string;
+    pattern?: string;
+}
+/** Secure AI request payload for a backend route or callback */
+interface GhostFillAIRequest {
+    provider: Provider;
+    prompt: string;
+    systemPrompt?: string;
+    fields: GhostFillPromptField[];
+}
+type GhostFillAIHandler = (request: GhostFillAIRequest) => Promise<FieldFillData[]>;
+/** Secure AI configuration. Requests must go through a backend or custom handler. */
+interface GhostFillAIOptions {
+    /** Same-origin backend route. Defaults to `/api/ghostfill` when `ai` is enabled. */
+    endpoint?: string;
+    /** Optional custom transport that forwards requests to a secure backend. */
+    requestFillData?: GhostFillAIHandler;
+    /** Default provider shown in the UI. */
+    provider?: Provider;
+}
+/** A detected form field */
+interface DetectedField {
+    /** The DOM element */
+    element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+    /** Field type: text, email, number, select, textarea, checkbox, radio, date, etc. */
+    type: string;
+    /** Field name attribute */
+    name: string;
+    /** Field label (from <label>, aria-label, or placeholder) */
+    label: string;
+    /** For <select>, the available options */
+    options?: string[];
+    /** Whether the field is required */
+    required: boolean;
+    /** Current value */
+    currentValue: string;
+    /** Min/max for number/date fields */
+    min?: string;
+    max?: string;
+    /** Pattern attribute */
+    pattern?: string;
+}
+/** Field data returned by the AI */
+interface FieldFillData {
+    /** Index matching the DetectedField array */
+    index: number;
+    /** Value to fill */
+    value: string;
+    /** For checkboxes: whether to check */
+    checked?: boolean;
+}
+
+export { type DetectedField as D, type FieldFillData as F, type GhostFillAIOptions as G, type Provider as P, type GhostFillOptions as a, type GhostFillAIRequest as b, type GhostFillPromptField as c, PROVIDERS as d };

package/dist/types-B3DGbZyx.d.ts

@@ -0,0 +1,83 @@
+/** Configuration options for GhostFill */
+interface GhostFillOptions {
+    /**
+     * @deprecated Browser API keys are insecure and ignored.
+     * Configure `ai` and keep provider credentials on your backend instead.
+     */
+    apiKey?: string;
+    /** Keyboard shortcut to toggle GhostFill (default: "Alt+G") */
+    shortcut?: string;
+    /** Custom system prompt to prepend */
+    systemPrompt?: string;
+    /** Secure AI transport configuration */
+    ai?: GhostFillAIOptions;
+}
+type Provider = "openai" | "xai" | "moonshot";
+declare const PROVIDERS: Record<Provider, {
+    label: string;
+    model: string;
+    baseURL: string;
+    helpText: string;
+}>;
+/** Non-secret field metadata sent to an AI backend */
+interface GhostFillPromptField {
+    index: number;
+    type: string;
+    name: string;
+    label: string;
+    options?: string[];
+    required: boolean;
+    min?: string;
+    max?: string;
+    pattern?: string;
+}
+/** Secure AI request payload for a backend route or callback */
+interface GhostFillAIRequest {
+    provider: Provider;
+    prompt: string;
+    systemPrompt?: string;
+    fields: GhostFillPromptField[];
+}
+type GhostFillAIHandler = (request: GhostFillAIRequest) => Promise<FieldFillData[]>;
+/** Secure AI configuration. Requests must go through a backend or custom handler. */
+interface GhostFillAIOptions {
+    /** Same-origin backend route. Defaults to `/api/ghostfill` when `ai` is enabled. */
+    endpoint?: string;
+    /** Optional custom transport that forwards requests to a secure backend. */
+    requestFillData?: GhostFillAIHandler;
+    /** Default provider shown in the UI. */
+    provider?: Provider;
+}
+/** A detected form field */
+interface DetectedField {
+    /** The DOM element */
+    element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+    /** Field type: text, email, number, select, textarea, checkbox, radio, date, etc. */
+    type: string;
+    /** Field name attribute */
+    name: string;
+    /** Field label (from <label>, aria-label, or placeholder) */
+    label: string;
+    /** For <select>, the available options */
+    options?: string[];
+    /** Whether the field is required */
+    required: boolean;
+    /** Current value */
+    currentValue: string;
+    /** Min/max for number/date fields */
+    min?: string;
+    max?: string;
+    /** Pattern attribute */
+    pattern?: string;
+}
+/** Field data returned by the AI */
+interface FieldFillData {
+    /** Index matching the DetectedField array */
+    index: number;
+    /** Value to fill */
+    value: string;
+    /** For checkboxes: whether to check */
+    checked?: boolean;
+}
+
+export { type DetectedField as D, type FieldFillData as F, type GhostFillAIOptions as G, type Provider as P, type GhostFillOptions as a, type GhostFillAIRequest as b, type GhostFillPromptField as c, PROVIDERS as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ghostfill",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Dev tool that fills form fields with relevant sample data — select a block, click fill, done",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -10,6 +10,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.js"
     }
   },
   "files": [