@graphext/cuery 0.2.0

package/esm/src/schemas/funnel.schema.d.ts

@@ -0,0 +1,94 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+/**
+ * Zod schemas for marketing funnel stages and categories.
+ * Used for validation in backend and type inference in frontend.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+/**
+ * A category of Google search keywords within a marketing funnel stage.
+ */
+export declare const FunnelCategorySchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    keywordPatterns: z.ZodArray<z.ZodString>;
+    intent: z.ZodString;
+    keywordSeeds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type FunnelCategory = z.infer<typeof FunnelCategorySchema>;
+/**
+ * A stage in the marketing funnel containing multiple keyword categories.
+ */
+export declare const FunnelStageSchema: z.ZodObject<{
+    stage: z.ZodString;
+    goal: z.ZodString;
+    categories: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        keywordPatterns: z.ZodArray<z.ZodString>;
+        intent: z.ZodString;
+        keywordSeeds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FunnelStage = z.infer<typeof FunnelStageSchema>;
+/**
+ * A complete marketing funnel with multiple stages.
+ */
+export declare const FunnelSchema: z.ZodObject<{
+    stages: z.ZodArray<z.ZodObject<{
+        stage: z.ZodString;
+        goal: z.ZodString;
+        categories: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            keywordPatterns: z.ZodArray<z.ZodString>;
+            intent: z.ZodString;
+            keywordSeeds: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Funnel = z.infer<typeof FunnelSchema>;
+/**
+ * Funnel schema with AI explanation - used for OpenAI response_format
+ * which requires all fields to be in the 'required' array.
+ */
+export declare const FunnelWithExplanationSchema: z.ZodObject<{
+    stages: z.ZodArray<z.ZodObject<{
+        stage: z.ZodString;
+        goal: z.ZodString;
+        categories: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            keywordPatterns: z.ZodArray<z.ZodString>;
+            intent: z.ZodString;
+            keywordSeeds: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    explanation: z.ZodString;
+}, z.core.$strip>;
+export type FunnelWithExplanation = z.infer<typeof FunnelWithExplanationSchema>;
+/**
+ * A list of seed keywords for a particular funnel category.
+ */
+export declare const SeedsSchema: z.ZodObject<{
+    seeds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Seeds = z.infer<typeof SeedsSchema>;
+export type FunnelOptions = {
+    /** Industry sector (e.g., "automotive", "technology") */
+    sector: string;
+    /** Language for the funnel keywords (e.g., "en" for English) */
+    language: string;
+    /** Optional user language preference (e.g., "en" for English) */
+    userLanguage?: string | null;
+    /** Optional country to be used as market for the funnel (e.g., "US" for United States), default is "global" */
+    country?: string | null;
+    briefing?: string | null;
+    instructions?: string | null;
+    /** AI model to use for generation (e.g., "gpt-4.1"), default is "gpt-4.1" */
+    model?: string | null;
+    funnel?: Funnel | Array<FunnelStage> | null;
+    maxConcurrency?: number;
+};
+//# sourceMappingURL=funnel.schema.d.ts.map

package/esm/src/schemas/funnel.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/funnel.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,gDAAgD,CAAC;AAEnE;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;iBAM/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;iBAI5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;iBAEvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAGtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,WAAW;;iBAEtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC3B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC"}

package/esm/src/schemas/funnel.schema.js

@@ -0,0 +1,46 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+/**
+ * Zod schemas for marketing funnel stages and categories.
+ * Used for validation in backend and type inference in frontend.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+/**
+ * A category of Google search keywords within a marketing funnel stage.
+ */
+export const FunnelCategorySchema = z.object({
+    name: z.string().describe('The name of a keyword category within a marketing funnel stage.'),
+    description: z.string().describe('A brief description of the category and its purpose.'),
+    keywordPatterns: z.array(z.string()).describe('Common keyword patterns or phrases associated with this category.'),
+    intent: z.string().describe('The primary search intent for this category (e.g., Informational, Commercial, Transactional, Navigational).'),
+    keywordSeeds: z.array(z.string()).describe('Example Google search keywords that fit within this category.')
+});
+/**
+ * A stage in the marketing funnel containing multiple keyword categories.
+ */
+export const FunnelStageSchema = z.object({
+    stage: z.string().describe('The name of the marketing funnel stage (e.g., Awareness, Consideration).'),
+    goal: z.string().describe('The primary goal or objective of this funnel stage.'),
+    categories: z.array(FunnelCategorySchema).describe('A list of keyword categories within this funnel stage.')
+});
+/**
+ * A complete marketing funnel with multiple stages.
+ */
+export const FunnelSchema = z.object({
+    stages: z.array(FunnelStageSchema)
+});
+/**
+ * Funnel schema with AI explanation - used for OpenAI response_format
+ * which requires all fields to be in the 'required' array.
+ */
+export const FunnelWithExplanationSchema = z.object({
+    stages: z.array(FunnelStageSchema),
+    explanation: z.string().describe('Brief explanation of the customized funnel and the reasoning behind the adaptations')
+});
+/**
+ * A list of seed keywords for a particular funnel category.
+ */
+export const SeedsSchema = z.object({
+    seeds: z.array(z.string()).min(3).max(10)
+});

package/esm/src/schemas/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Central export for all Edge Function schemas and types.
+ *
+ * For backend (Deno): Import schemas with runtime validation
+ * For frontend (Node/TypeScript): Import types only using `import type`
+ *
+ * Types are inferred from Zod schemas using z.infer<typeof Schema>
+ * This ensures a single source of truth.
+ *
+ * NOTE: For seed keyword functions, import from '@supabase/lib/seedKeywords' (frontend)
+ * or 'shared/cuery/lib/seedKeywords/index.ts' (backend).
+ */
+export type * from './persona.schema.js';
+export type * from './brand.schema.js';
+export type * from './funnel.schema.js';
+export type * from './keyword.schema.js';
+export type * from './pipeline.schema.js';
+export type * from './models.schema.js';
+export type * from './seedKeyword.schema.js';
+export type * from './topics.schema.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/src/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,qBAAqB,CAAC;AACzC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC"}

package/esm/src/schemas/index.js

@@ -0,0 +1,13 @@
+/**
+ * Central export for all Edge Function schemas and types.
+ *
+ * For backend (Deno): Import schemas with runtime validation
+ * For frontend (Node/TypeScript): Import types only using `import type`
+ *
+ * Types are inferred from Zod schemas using z.infer<typeof Schema>
+ * This ensures a single source of truth.
+ *
+ * NOTE: For seed keyword functions, import from '@supabase/lib/seedKeywords' (frontend)
+ * or 'shared/cuery/lib/seedKeywords/index.ts' (backend).
+ */
+export {};

package/esm/src/schemas/keyword.schema.d.ts

@@ -0,0 +1,44 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+import type { Brand } from './brand.schema.js';
+import type { Funnel } from './funnel.schema.js';
+import type { Persona } from './persona.schema.js';
+export declare const KeywordSchema: z.ZodString;
+export declare const KeywordsResponseSchema: z.ZodObject<{
+    keywords: z.ZodArray<z.ZodString>;
+    explanation: z.ZodString;
+}, z.core.$strip>;
+export type Keyword = z.infer<typeof KeywordSchema>;
+export type KeywordsResponse = z.infer<typeof KeywordsResponseSchema>;
+/**
+ * Options for keyword generation.
+ * Requires sector and market to be specified.
+ */
+export interface KeywordsOptions {
+    /** Industry sector (e.g., "running shoes", "CRM software"). */
+    sector: string;
+    /** Geographic market (e.g., "United States", "Spain", "global"). */
+    market: string;
+    /** Brand name to analyze. */
+    brand?: string;
+    /** Brand domain to analyze. */
+    brandDomain?: string;
+    /** Language for keyword output. Default is 'english'. */
+    language?: string;
+    /** Language for system messages (defaults to language). */
+    userLanguage?: string | null;
+    /** OpenAI model to use. Default is 'gpt-4.1'. */
+    model?: string;
+    /** Additional context about the brand. */
+    briefing?: string;
+    /** Specific instructions for keyword generation. */
+    instructions?: string;
+    /** Existing keywords to maintain or modify. */
+    keywords?: Array<Keyword> | null;
+    /** Brand information including competitors. */
+    brands?: Array<Brand> | null;
+    /** Customer personas to target. */
+    personas?: Array<Persona> | null;
+    /** Marketing funnel with stages and categories. */
+    funnel?: Funnel | null;
+}
+//# sourceMappingURL=keyword.schema.d.ts.map

package/esm/src/schemas/keyword.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/keyword.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,gDAAgD,CAAC;AAEnE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,eAAO,MAAM,aAAa,aAAiD,CAAC;AAE5E,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACjC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACjC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/esm/src/schemas/keyword.schema.js

@@ -0,0 +1,6 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+export const KeywordSchema = z.string().describe('A search keyword phrase');
+export const KeywordsResponseSchema = z.object({
+    keywords: z.array(KeywordSchema).describe('List of keyword phrases for the brand and sector'),
+    explanation: z.string().describe('Brief explanation of the generated keywords and the reasoning behind them')
+});

package/esm/src/schemas/models.schema.d.ts

@@ -0,0 +1,6 @@
+import type { SearchResult } from './search.schema.js';
+export type ModelIdentifier = 'openai/chatgpt' | 'google/ai-overview' | 'google/ai-mode';
+export type ModelResult = {
+    prompt: string;
+} & SearchResult;
+//# sourceMappingURL=models.schema.d.ts.map

package/esm/src/schemas/models.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/models.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,eAAe,GACxB,gBAAgB,GAChB,oBAAoB,GACpB,gBAAgB,CAAC;AAEpB,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAAC"}

package/esm/src/schemas/models.schema.js

@@ -0,0 +1 @@
+export {};

package/esm/src/schemas/persona.schema.d.ts

@@ -0,0 +1,50 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+import type { BrandOptions } from './brand.schema.js';
+/**
+ * Zod schema for customer persona.
+ * Used for validation in backend and type inference in frontend.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+export declare const PersonaSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    keywordSeeds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from PersonaSchema.
+ * Safe to import in frontend with `import type`.
+ */
+export type Persona = z.infer<typeof PersonaSchema>;
+/**
+ * Response schema for /ai_audit/personas endpoint.
+ */
+export declare const PersonasResponseSchema: z.ZodObject<{
+    personas: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        keywordSeeds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    explanation: z.ZodString;
+}, z.core.$strip>;
+export type PersonasResponse = z.infer<typeof PersonasResponseSchema>;
+/**
+ * Options for persona generation.
+ * Requires sector and market to be specified (overrides BrandOptions optionality).
+ */
+export interface PersonasOptions extends Omit<BrandOptions, 'sector' | 'market'> {
+    /** Industry sector the brand operates in (required for persona generation). */
+    sector: string;
+    /** Geographical market or region (required for persona generation). */
+    market: string;
+    /** Number of personas to generate. */
+    count?: number;
+    /** AI model to use for generation. */
+    model?: string;
+    /** Additional instructions for persona generation. */
+    instructions?: string | null;
+    /** Existing personas to consider during generation. */
+    personas?: Array<Persona> | null;
+}
+//# sourceMappingURL=persona.schema.d.ts.map

package/esm/src/schemas/persona.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/persona.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,gDAAgD,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;iBAIxB,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;iBAGjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/E,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CACjC"}

package/esm/src/schemas/persona.schema.js

@@ -0,0 +1,21 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+/**
+ * Zod schema for customer persona.
+ * Used for validation in backend and type inference in frontend.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+export const PersonaSchema = z.object({
+    name: z.string().describe('A short and catchy name for the persona'),
+    description: z.string().describe('A brief description of the persona\'s characteristics, needs, and behaviors'),
+    keywordSeeds: z.array(z.string()).describe('List of keyword seed phrases this persona would typically search for')
+});
+/**
+ * Response schema for /ai_audit/personas endpoint.
+ */
+export const PersonasResponseSchema = z.object({
+    personas: z.array(PersonaSchema),
+    explanation: z.string().describe('Brief explanation of the generated personas and the reasoning behind them')
+});
+;

package/esm/src/schemas/pipeline.schema.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Pipeline Context Type Definitions
+ *
+ * These types define the structure for pipeline execution contexts.
+ * They are shared between client and server code.
+ *
+ * IMPORTANT: This type must be kept in sync with the dynamically generated
+ * type from: supabase/functions/pipelines/workflows/audit.ts
+ *
+ * The actual pipeline generates:
+ * export type AiAuditPromptsPipelineContext = OrchestratorRunContext<typeof promptsPipeline>;
+ *
+ * This static definition serves as a contract for client-side usage.
+ * It represents the union of all context types required by the pipeline nodes.
+ */
+import type { Brand, BrandContext, FlaggedBrand } from './brand.schema.js';
+import type { Funnel } from './funnel.schema.js';
+import type { ModelIdentifier } from './models.schema.js';
+import type { Persona } from './persona.schema.js';
+import type { TopicType } from './topics.schema.js';
+export interface KeywordPlannerOptions {
+    url?: string;
+    urlAsExpandRelevanceContext?: string;
+    generateIdeasFromSeeds?: boolean;
+}
+export interface AiAuditPromptsPipelineOptions {
+    filterLowRelevanceKeywords?: boolean;
+    /** When true, adds deduplicatedKeywords column with all keywords sharing the same metrics */
+    includeDeduplicatedKeywords?: boolean;
+    /** When true, includes seedKeywords column in output records. Defaults to false. */
+    includeSeedKeywords?: boolean;
+    /** When true, generates a separate dataset with all keywords (dedup by keyword only). Defaults to false. */
+    includeAllKeywordsDataset?: boolean;
+}
+/**
+ * AI Audit Pipeline Request Structure
+ *
+ * This represents the structure of the request sent to the /pipelines/run endpoint.
+ * The `context` field should match the AiAuditPromptsPipelineContext from the orchestrator.
+ */
+export interface AiAuditPromptsPipelineRequest {
+    pipelineName: 'promptsPipeline';
+    context: AiAuditPromptsPipelineContext;
+}
+/**
+ * AI Audit Answers Pipeline Request Structure
+ *
+ * This represents the structure of the request sent to the /pipelines/run endpoint.
+ * The `context` field should match the AiAuditAnswersPipelineContext from the orchestrator.
+ */
+export interface AiAuditAnswersPipelineRequest {
+    pipelineName: 'answersPipeline';
+    context: AiAuditAnswersPipelineContext;
+}
+/**
+ * AI Audit Prompts Pipeline Context Data - Static Definition
+ *
+ * This represents the union of all context parameters required by the
+ * various nodes in the AI audit prompts pipeline:
+ *
+ * - { keywordPlanner }: Keyword Planner parameters & seed sources
+ * - { options }: Pipeline-level flags
+ * - { workspaceId, projectName }: Project creation parameters
+ * - { funnel }: Funnel assignment parameters
+ * - { brand }: Brand-specific processing parameters
+ * - { brands }: Brand collection parameters
+ */
+export interface AiAuditPromptsPipelineContext {
+    clientUserEmail: string;
+    workspaceId: number;
+    projectName?: string;
+    /** Optional existing project to append prompts into. */
+    projectId?: number;
+    keywordPlanner: KeywordPlannerOptions;
+    /** ISO 639-1 language code for prompts/keywords (e.g., "en"). */
+    languageCode?: string;
+    /** ISO 3166-1 alpha-2 country code to localize sources (e.g., "US"). */
+    countryISOCode?: string;
+    /**
+     * Custom prompts provided by the user.
+     * These go directly to the prompt dataset without keyword expansion.
+     */
+    directPrompts?: Array<string>;
+    /**
+     * Custom seed keywords provided by the user.
+     * These are processed through keyword expansion like other seed keywords.
+     */
+    customSeedKeywords?: Array<string>;
+    funnel?: Funnel;
+    brand: BrandContext;
+    competitors: Array<FlaggedBrand | Brand>;
+    personas: Array<Persona>;
+    options?: AiAuditPromptsPipelineOptions;
+    topics?: Array<TopicType>;
+}
+/**
+ * AI Audit Answers Pipeline Context Data
+ *
+ * Context parameters required by the answers pipeline.
+ */
+export interface AiAuditAnswersPipelineContext {
+    clientUserEmail: string;
+    projectId: number;
+    promptIds: Array<number>;
+    models: Array<ModelIdentifier>;
+    countryISOCode?: string;
+    brand: BrandContext;
+    competitors?: Array<FlaggedBrand | Brand>;
+    /**
+     * Panel ID for grouping answers by execution source.
+     * When present (scheduled cron execution), answers are grouped by panelId.
+     */
+    panelId?: number;
+}
+/**
+ * Persisted project configuration (pipeline context without user metadata).
+ */
+export type AiAuditProjectConfig = Omit<AiAuditPromptsPipelineContext, 'clientUserEmail' | 'projectId'>;
+/**
+ * Topic Update Pipeline Request Structure
+ *
+ * This represents the structure of the request sent to the /pipelines/run endpoint
+ * for updating topic hierarchy in existing prompts.
+ */
+export interface TopicUpdatePipelineRequest {
+    pipelineName: 'topicUpdatePipeline';
+    context: TopicUpdatePipelineContext;
+}
+/**
+ * Topic Update Pipeline Context Data
+ *
+ * Context parameters required by the topic update pipeline.
+ * This pipeline downloads the prompts dataset, re-assigns topics using AI
+ * based on the provided taxonomy, and uploads the updated dataset back to the project.
+ */
+export interface TopicUpdatePipelineContext {
+    clientUserEmail: string;
+    projectId: number;
+    /**
+     * The topics taxonomy to use for assigning topics.
+     * Each topic contains a name and a list of subtopics.
+     * The AI will classify each prompt into the appropriate topic/subtopic.
+     */
+    topics: Array<TopicType>;
+}
+//# sourceMappingURL=pipeline.schema.d.ts.map

package/esm/src/schemas/pipeline.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/pipeline.schema.ts"],"names":[],"mappings":"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"}

package/esm/src/schemas/pipeline.schema.js

@@ -0,0 +1,16 @@
+/**
+ * Pipeline Context Type Definitions
+ *
+ * These types define the structure for pipeline execution contexts.
+ * They are shared between client and server code.
+ *
+ * IMPORTANT: This type must be kept in sync with the dynamically generated
+ * type from: supabase/functions/pipelines/workflows/audit.ts
+ *
+ * The actual pipeline generates:
+ * export type AiAuditPromptsPipelineContext = OrchestratorRunContext<typeof promptsPipeline>;
+ *
+ * This static definition serves as a contract for client-side usage.
+ * It represents the union of all context types required by the pipeline nodes.
+ */
+export {};

package/esm/src/schemas/search.schema.d.ts

@@ -0,0 +1,29 @@
+import type { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+import type { Source, SearchSource } from './sources.schema.js';
+export type ContextSize = 'low' | 'medium' | 'high';
+export type ReasoningEffort = 'low' | 'medium' | 'high';
+export interface SearchResult {
+    answer: string;
+    sources: Array<Source>;
+    searchQueries?: Array<string>;
+    searchSources?: Array<SearchSource>;
+}
+export type SearchOptions = {
+    prompt: string;
+    model?: string;
+    useSearch?: boolean;
+    /** To refine search results based on geography, you can specify an approximate user location
+     * using countryISOCode. The country field is a two-letter ISO country code, like US. */
+    countryISOCode?: string | null;
+    contextSize?: ContextSize;
+    reasoningEffort?: ReasoningEffort;
+    searchTool?: 'web_search' | 'web_search_preview';
+};
+export type FormattedSearchOptions<T> = SearchOptions & {
+    responseSchema: z.ZodType<T>;
+};
+export type BatchSearchOptions = Omit<SearchOptions, 'prompt'> & {
+    prompts: Array<string>;
+    maxConcurrency?: number;
+};
+//# sourceMappingURL=search.schema.d.ts.map

package/esm/src/schemas/search.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/search.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,gDAAgD,CAAC;AAExE,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACpD,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAGxD,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;4FACwF;IACxF,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,UAAU,CAAC,EAAE,YAAY,GAAG,oBAAoB,CAAA;CAChD,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,aAAa,GAAG;IACvD,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG;IAChE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA"}

package/esm/src/schemas/search.schema.js

@@ -0,0 +1 @@
+export {};

package/esm/src/schemas/seedKeyword.schema.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Seed Keyword Types
+ *
+ * Pure TypeScript types for seed keywords.
+ * No runtime dependencies - safe to import in both frontend and backend.
+ */
+export type SeedKeywordSource = 'persona' | 'funnel' | 'portfolio' | 'custom' | 'brand-portfolio';
+export interface SeedKeyword {
+    id: string;
+    keyword: string;
+    source: SeedKeywordSource;
+    sourceId?: string;
+    sourceName?: string;
+}
+//# sourceMappingURL=seedKeyword.schema.d.ts.map

package/esm/src/schemas/seedKeyword.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedKeyword.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/seedKeyword.schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAElG,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/esm/src/schemas/seedKeyword.schema.js

@@ -0,0 +1,7 @@
+/**
+ * Seed Keyword Types
+ *
+ * Pure TypeScript types for seed keywords.
+ * No runtime dependencies - safe to import in both frontend and backend.
+ */
+export {};

package/esm/src/schemas/sentiment.schema.d.ts

@@ -0,0 +1,22 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+export declare const ABSentimentSchema: z.ZodObject<{
+    aspect: z.ZodString;
+    sentiment: z.ZodEnum<{
+        positive: "positive";
+        negative: "negative";
+    }>;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const ABSentimentsSchema: z.ZodObject<{
+    aspects: z.ZodArray<z.ZodObject<{
+        aspect: z.ZodString;
+        sentiment: z.ZodEnum<{
+            positive: "positive";
+            negative: "negative";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ABSentiment = z.infer<typeof ABSentimentSchema>;
+export type ABSentiments = z.infer<typeof ABSentimentsSchema>;
+//# sourceMappingURL=sentiment.schema.d.ts.map

package/esm/src/schemas/sentiment.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentiment.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/sentiment.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,gDAAgD,CAAC;AAEnE,eAAO,MAAM,iBAAiB;;;;;;;iBAI5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;iBAE7B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/esm/src/schemas/sentiment.schema.js

@@ -0,0 +1,9 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+export const ABSentimentSchema = z.object({
+    aspect: z.string().describe('The specific entity or aspect mentioned in the text.'),
+    sentiment: z.enum(['positive', 'negative']).describe('The sentiment expressed toward the aspect, either positive or negative.'),
+    reason: z.string().describe('A brief explanation of why this sentiment was assigned to the aspect.')
+});
+export const ABSentimentsSchema = z.object({
+    aspects: z.array(ABSentimentSchema).describe('A list of aspects with their associated sentiments and reasons.')
+});

package/esm/src/schemas/sources.schema.d.ts

@@ -0,0 +1,29 @@
+export interface Source {
+    title: string;
+    url: string;
+    domain: string;
+    cited?: boolean;
+    positions?: Array<number>;
+}
+/**
+ * Extended Source with brand mentions and links.
+ * Mentions refer to the source title, and links refer to the source URL.
+ */
+export interface EnrichedSource extends Source {
+    mentionedBrands: Array<string>;
+    mentionedCompetitors: Array<string>;
+    linkedBrand: string | null;
+    linkedCompetitor: string | null;
+}
+/**
+ * Source with category information from WEB_TAXONOMY.
+ */
+export interface CategorizedSource extends EnrichedSource {
+    category: string | null;
+    subcategory: string | null;
+}
+export interface SearchSource extends Source {
+    rank: number;
+    datePublished: string | null;
+}
+//# sourceMappingURL=sources.schema.d.ts.map

package/esm/src/schemas/sources.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.schema.d.ts","sourceRoot":"","sources":["../../../src/src/schemas/sources.schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC7C,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,oBAAoB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACxD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}

package/esm/src/schemas/sources.schema.js

@@ -0,0 +1 @@
+export {};