@spark-apps/quickpeek 1.1.3 → 1.2.1

package/dist/{voices-BtYZey4Y.d.mts → scraping-CHN4ClyT.d.mts}

@@ -1,7 +1,7 @@
 /**
  * Configuration types and defaults for QuickPeek
  */
-declare const VERSION = "1.1.1";
+declare const VERSION = "1.2.1";
 declare const CONFIG_FILE = "quickpeek.config.json";
 type UserTier = 'free' | 'pro';
 interface Config {
@@ -65,8 +65,13 @@ declare const DEFAULT_CAPTIONS: CaptionStyle;
  * AI API client — Spark AI communication
  * Handles token management, rate limiting, and retries
  *
- * The API key is embedded at build time via tsup `define`.
- * Per-user rate limiting is handled server-side via email.
+ * Two transports:
+ * - Relay (default for the published CLI): quickpeek-web mints a short-lived
+ *   per-user token from a registered email and proxies the chat server-side.
+ *   No credential ships in the npm bundle.
+ * - Direct (dev/server only): when SPARK_AI_KEY is present in the runtime
+ *   environment (never baked at build time), call Spark AI directly. This is
+ *   the path quickpeek-web itself uses server-side.
  */
 
 interface RateLimitInfo {
@@ -89,9 +94,15 @@ interface AIError {
 }
 type AIResult = AIResponse | AIError;
 /**
- * Call Spark AI chat endpoint. Automatically retries on rate limit using Retry-After header.
+ * Direct Spark AI call using the runtime SPARK_AI_KEY (dev + server-side use).
  */
 declare function callAI(systemPrompt: string, userPrompt: string, tier?: UserTier): Promise<AIResult>;
+/**
+ * Relayed Spark AI call for the published CLI: authenticates with the user's
+ * registered email via quickpeek-web, which holds the real key server-side
+ * and enforces per-user daily limits.
+ */
+declare function callAIViaRelay(systemPrompt: string, userPrompt: string, email: string, tier?: UserTier): Promise<AIResult>;
 /**
  * Parse AI-generated plan JSON from response text
  */
@@ -170,14 +181,19 @@ interface Plan {
 
 /**
  * Crawl a page and extract interactive elements with smart selectors
+ * Results are cached in-memory for a few minutes to avoid duplicate browser launches
  * @param url - URL to crawl
  * @param task - Optional progress reporter (CLI uses ora spinners, web can omit)
  */
 declare function crawlPage(url: string, task?: (text: string) => {
     succeed: (text?: string) => void;
+}, storageStatePath?: string, viewport?: {
+    width: number;
+    height: number;
 }): Promise<{
     title: string;
     elements: ElementInfo[];
+    scrollable: number;
 }>;
 
 /**
@@ -187,19 +203,12 @@ declare function crawlPage(url: string, task?: (text: string) => {
  * Get full language name from ISO code
  */
 declare function getLanguageName(lang?: string): string | null;
-/**
- * Convert hex color (#RRGGBB) to ASS subtitle format (&HAABBGGRR)
- */
-declare function hexToASS(hex: string, alpha?: number): string;
+
 /**
  * Convert rgba() or rgb() color string to hex
  */
 declare function rgbaToHex(color: string): string;
-/**
- * Convert a Windows absolute path (D:\...) to WSL mount format (/mnt/d/...).
- * Returns null if the path is not a Windows drive-letter path.
- */
-declare function windowsPathToWSL(path: string): string | null;
+
 /**
  * Parse partial field "start-end" into trim values
  * e.g., "0-3.5" -> { trimStart: 0, trimEnd: 3.5 }
@@ -224,19 +233,7 @@ declare function toTitleCase(text: string): string;
  */
 
 declare function buildSystemPrompt(maxSteps: number): string;
-declare function buildUserPrompt(url: string, title: string, elements: ElementInfo[], langName: string | null, description: string | undefined, maxSteps: number): string;
-
-/**
- * Shared constants for page scraping and element filtering
- * Used by both CLI and web versions
- */
-declare const EXCLUDED_LINK_PATTERNS: string[];
-/** CSS selectors for interactive page elements */
-declare const INTERACTIVE_SELECTORS: string[];
-/** Check if link text or href matches an excluded pattern */
-declare function isExcludedLink(text: string, href?: string): boolean;
-/** Check if a link should be skipped during crawling */
-declare function shouldSkipLink(text: string, href: string, currentPath: string): boolean;
+declare function buildUserPrompt(url: string, title: string, elements: ElementInfo[], langName: string | null, description: string | undefined, maxSteps: number, scrollable?: number): string;
 
 type Tier = 'free' | 'pro';
 declare const FEATURES: Record<string, string[]>;
@@ -282,6 +279,16 @@ declare function pricingUrl(opts?: {
     returnUrl?: string;
 }): string;
 
-declare const LANGUAGE_VOICES: Record<string, string>;
+/**
+ * Shared constants for page scraping and element filtering
+ * Used by both CLI and web versions
+ */
+declare const EXCLUDED_LINK_PATTERNS: string[];
+/** CSS selectors for interactive page elements */
+declare const INTERACTIVE_SELECTORS: string[];
+/** Check if link text or href matches an excluded pattern */
+declare function isExcludedLink(text: string, href?: string): boolean;
+/** Check if a link should be skipped during crawling */
+declare function shouldSkipLink(text: string, href: string, currentPath: string): boolean;
 
-export { type AIError as A, isPaid as B, type Config as C, DEFAULT_CAPTIONS as D, EXCLUDED_LINK_PATTERNS as E, FEATURES as F, isVerified as G, type HighlightMode as H, INTERACTIVE_SELECTORS as I, normalizeUrl as J, parseAIPlanResponse as K, LANGUAGE_VOICES as L, parsePartial as M, pricingUrl as N, rgbaToHex as O, type Plan as P, shouldSkipLink as Q, type RateLimitInfo as R, type SparkStatus as S, type Tier as T, type UserTier as U, VERSION as V, showPaywall as W, toTitleCase as X, windowsPathToWSL as Y, getTier as Z, type AIResponse as a, type AIResult as b, CONFIG_FILE as c, type CaptionStyle as d, type CaptionWordStyle as e, DEFAULT_CONFIG as f, type ElementInfo as g, type ElementType as h, type SparkSubscription as i, type SparkTrial as j, type Step as k, type SuggestedAction as l, buildSystemPrompt as m, buildUserPrompt as n, callAI as o, crawlPage as p, getErrorMessage as q, getLanguageName as r, getStatus as s, getStatusCached as t, getTierByEmail as u, hasAccess as v, hasTrialRemaining as w, hexToASS as x, isCanceling as y, isExcludedLink as z };
+export { type AIError as A, isPaid as B, type Config as C, DEFAULT_CAPTIONS as D, EXCLUDED_LINK_PATTERNS as E, FEATURES as F, isVerified as G, type HighlightMode as H, INTERACTIVE_SELECTORS as I, normalizeUrl as J, parseAIPlanResponse as K, parsePartial as L, pricingUrl as M, rgbaToHex as N, shouldSkipLink as O, type Plan as P, showPaywall as Q, type RateLimitInfo as R, type SparkStatus as S, type Tier as T, type UserTier as U, VERSION as V, toTitleCase as W, getTier as X, type AIResponse as a, type AIResult as b, CONFIG_FILE as c, type CaptionStyle as d, type CaptionWordStyle as e, DEFAULT_CONFIG as f, type ElementInfo as g, type ElementType as h, type SparkSubscription as i, type SparkTrial as j, type Step as k, type SuggestedAction as l, buildSystemPrompt as m, buildUserPrompt as n, callAI as o, callAIViaRelay as p, crawlPage as q, getErrorMessage as r, getLanguageName as s, getStatus as t, getStatusCached as u, getTierByEmail as v, hasAccess as w, hasTrialRemaining as x, isCanceling as y, isExcludedLink as z };

package/dist/web.d.mts

@@ -1,4 +1,45 @@
-export { A as AIError, a as AIResponse, b as AIResult, E as EXCLUDED_LINK_PATTERNS, g as ElementInfo, h as ElementType, F as FEATURES, H as HighlightMode, I as INTERACTIVE_SELECTORS, L as LANGUAGE_VOICES, P as Plan, R as RateLimitInfo, S as SparkStatus, i as SparkSubscription, j as SparkTrial, k as Step, l as SuggestedAction, T as Tier, m as buildSystemPrompt, n as buildUserPrompt, o as callAI, p as crawlPage, q as getErrorMessage, r as getLanguageName, s as getStatus, t as getStatusCached, Z as getTier, u as getTierByEmail, v as hasAccess, w as hasTrialRemaining, x as hexToASS, y as isCanceling, z as isExcludedLink, B as isPaid, G as isVerified, J as normalizeUrl, K as parseAIPlanResponse, M as parsePartial, N as pricingUrl, O as rgbaToHex, Q as shouldSkipLink, W as showPaywall, X as toTitleCase, Y as windowsPathToWSL } from './voices-BtYZey4Y.mjs';
+import { P as Plan } from './scraping-CHN4ClyT.mjs';
+export { A as AIError, a as AIResponse, b as AIResult, E as EXCLUDED_LINK_PATTERNS, g as ElementInfo, h as ElementType, F as FEATURES, H as HighlightMode, I as INTERACTIVE_SELECTORS, R as RateLimitInfo, S as SparkStatus, i as SparkSubscription, j as SparkTrial, k as Step, l as SuggestedAction, T as Tier, m as buildSystemPrompt, n as buildUserPrompt, o as callAI, q as crawlPage, r as getErrorMessage, s as getLanguageName, t as getStatus, u as getStatusCached, X as getTier, v as getTierByEmail, w as hasAccess, x as hasTrialRemaining, y as isCanceling, z as isExcludedLink, B as isPaid, G as isVerified, J as normalizeUrl, K as parseAIPlanResponse, L as parsePartial, M as pricingUrl, N as rgbaToHex, O as shouldSkipLink, Q as showPaywall, W as toTitleCase } from './scraping-CHN4ClyT.mjs';
+export { WIDE_VOICES as LANGUAGE_VOICES, hexToAss as hexToASS, windowsDrivePathToWsl as windowsPathToWSL } from '@spark-apps/video-kit';
+
+/**
+ * The plan file, and handing it to the browser editor.
+ *
+ * The JSON on disk is the source of truth: the CLI records from it, and the
+ * editor is a view onto it. The handover travels in a URL fragment, which no
+ * browser sends to a server — so editing a demo costs no upload, no account,
+ * and leaves no stored copy that can drift from the file being recorded.
+ *
+ * Mirrors VidLet's lib/project validate + file-io split, so whoever maintains
+ * both codebases finds the same shape in each.
+ */
+
+type ParseResult = {
+    ok: true;
+    plan: Plan;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Browsers accept far longer URLs than this, but shells, terminals and the
+ * `open` handlers in between are the weak link. Past it, the editor is opened
+ * empty and the user picks the file by hand.
+ */
+declare const MAX_HANDOFF_URL_CHARS = 32000;
+/** Canonical on-disk form: 2-space JSON with a trailing newline. */
+declare function serializePlan(plan: Plan): string;
+/**
+ * Parse plan JSON, rejecting anything the recorder could not act on. Steps
+ * missing an id are numbered rather than refused: the editor drops ids when
+ * a user adds a step by hand, and renumbering is what the CLI would do too.
+ */
+declare function parsePlanText(text: string): ParseResult;
+declare function encodePlan(plan: Plan): string;
+/** Decode a `#plan=` fragment. Same validation as reading the file. */
+declare function decodePlan(encoded: string): ParseResult;
+/** The editor URL carrying a plan, or null when it is too long to hand over. */
+declare function planEditorUrl(baseUrl: string, plan: Plan): string | null;
 
 /**
  * Plan Validation - Shared between CLI and Web
@@ -99,4 +140,4 @@ declare function restorePreservedValues<T extends BaseStep & {
     mediaIdx: number;
 };
 
-export { ACTIONS_REQUIRING_TARGET, type BaseStep, type CLIPlan, type CLIStep, FIX_PLAN_SYSTEM_PROMPT, INVALID_TARGETS, type PreservedValues, REFINE_PLAN_SYSTEM_PROMPT, type StepAction, type StepFailure, collectPreservedValues, filterValidSteps, isInvalidTarget, isValidStep, restorePreservedValues, validateStep };
+export { ACTIONS_REQUIRING_TARGET, type BaseStep, type CLIPlan, type CLIStep, FIX_PLAN_SYSTEM_PROMPT, INVALID_TARGETS, MAX_HANDOFF_URL_CHARS, type ParseResult, Plan, type PreservedValues, REFINE_PLAN_SYSTEM_PROMPT, type StepAction, type StepFailure, collectPreservedValues, decodePlan, encodePlan, filterValidSteps, isInvalidTarget, isValidStep, parsePlanText, planEditorUrl, restorePreservedValues, serializePlan, validateStep };