@graphext/cuery 0.2.0

package/script/src/async.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Async utilities: sleep, retry with backoff, and parallel execution.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RETRY_DEFAULTS = void 0;
+exports.sleep = sleep;
+exports.withRetries = withRetries;
+exports.mapParallel = mapParallel;
+// ============================================================================
+// Sleep
+// ============================================================================
+/**
+ * Sleeps for a specified duration. If an AbortSignal is provided and triggered,
+ * the promise rejects with the abort reason and the timeout is cleared.
+ */
+const dntShim = __importStar(require("../_dnt.shims.js"));
+function sleep(ms, abortSignal) {
+    return new Promise((resolve, reject) => {
+        if (abortSignal?.aborted) {
+            return reject(abortSignal.reason ?? new DOMException('Aborted', 'AbortError'));
+        }
+        const timeoutId = setTimeout(() => {
+            cleanup();
+            resolve();
+        }, ms);
+        function onAbort() {
+            cleanup();
+            reject(abortSignal?.reason ?? new DOMException('Aborted', 'AbortError'));
+        }
+        function cleanup() {
+            if (abortSignal) {
+                abortSignal.removeEventListener('abort', onAbort);
+            }
+            clearTimeout(timeoutId);
+        }
+        abortSignal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+exports.RETRY_DEFAULTS = {
+    maxRetries: 3,
+    initialDelay: 1000,
+    maxDelay: 30000,
+    backoffMultiplier: 2,
+    statusCodes: [429, 500]
+};
+/**
+ * Executes a fetch operation with exponential backoff retry logic.
+ * Only retries on network errors or specific HTTP status codes (default: 429, 500).
+ */
+async function withRetries(fn, { maxRetries = exports.RETRY_DEFAULTS.maxRetries, initialDelay = exports.RETRY_DEFAULTS.initialDelay, maxDelay = exports.RETRY_DEFAULTS.maxDelay, backoffMultiplier = exports.RETRY_DEFAULTS.backoffMultiplier, statusCodes = exports.RETRY_DEFAULTS.statusCodes } = {}) {
+    let lastError;
+    let lastResponse;
+    let delay = initialDelay;
+    const abortSignal = dntShim.dntGlobalThis.abortSignal;
+    if (abortSignal?.aborted) {
+        throw new Error('Operation aborted');
+    }
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const response = await fn();
+            // Return immediately if successful and not in retry status codes
+            if (response.ok && !statusCodes.includes(response.status)) {
+                return response;
+            }
+            // Return on last attempt regardless of status
+            if (attempt === maxRetries) {
+                return response;
+            }
+            lastResponse = response;
+            await sleep(delay, abortSignal);
+            delay = Math.min(delay * backoffMultiplier, maxDelay);
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === maxRetries) {
+                break;
+            }
+            await sleep(delay, abortSignal);
+            delay = Math.min(delay * backoffMultiplier, maxDelay);
+        }
+    }
+    if (lastResponse != null) {
+        return lastResponse;
+    }
+    throw new Error(`Network request failed after ${maxRetries + 1} attempts: ${lastError?.message || 'Unknown error'}`);
+}
+// ============================================================================
+// Parallel Execution
+// ============================================================================
+/**
+ * Executes an async callback on each item in an iterable with limited concurrency.
+ * Results are returned in the same order as the input.
+ */
+async function mapParallel(iterable, nWorkers, callback) {
+    let size = null;
+    if (Array.isArray(iterable)) {
+        size = iterable.length;
+    }
+    if (!('next' in iterable)) {
+        iterable = iterable[Symbol.iterator]();
+    }
+    nWorkers = Math.max(1, Math.min(nWorkers, size || Number.MAX_VALUE));
+    const result = [];
+    let myIndex = 0;
+    const workerPromises = Array(nWorkers).fill(0).map(async () => {
+        let iterResult;
+        while (!(iterResult = iterable.next()).done) {
+            const index = myIndex++;
+            result[index] = await callback(iterResult.value, index);
+        }
+    });
+    await Promise.all(workerPromises);
+    return result;
+}

package/script/src/models.d.ts

@@ -0,0 +1,18 @@
+import type { ModelIdentifier } from './schemas/models.schema.js';
+/**
+ * Will eventually contain helpers to get metadata about models, e.g. pricing.
+ *
+ * Represents a model identifier with optional provider and model name.
+ * Can parse strings like "openai/gpt-4" or just "gpt-4".
+ */
+export declare class ModelId {
+    readonly name: string;
+    readonly provider: string | null;
+    constructor(name: ModelIdentifier);
+    toString(): string;
+    toJSON(): string;
+    inspect(): string;
+    equals(other: ModelId | string): boolean;
+    columnName(includeProvider?: boolean): string;
+}
+//# sourceMappingURL=models.d.ts.map

package/script/src/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/src/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE;;;;;GAKG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;gBAErB,IAAI,EAAE,eAAe;IAYjC,QAAQ,IAAI,MAAM;IAOlB,MAAM,IAAI,MAAM;IAIhB,OAAO,IAAI,MAAM;IAIjB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO;IAUxC,UAAU,CAAC,eAAe,GAAE,OAAe,GAAG,MAAM;CAMpD"}

package/script/src/models.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelId = void 0;
+const utils_js_1 = require("./utils.js");
+/**
+ * Will eventually contain helpers to get metadata about models, e.g. pricing.
+ *
+ * Represents a model identifier with optional provider and model name.
+ * Can parse strings like "openai/gpt-4" or just "gpt-4".
+ */
+class ModelId {
+    name;
+    provider;
+    constructor(name) {
+        if (!name.includes('/')) {
+            this.provider = null;
+            this.name = name.toLowerCase();
+            return;
+        }
+        const parts = name.split('/', 2);
+        this.provider = parts[0];
+        this.name = parts[1];
+    }
+    toString() {
+        if (this.provider) {
+            return `${this.provider}/${this.name}`;
+        }
+        return this.name;
+    }
+    toJSON() {
+        return this.toString();
+    }
+    inspect() {
+        return `ModelId(provider=${JSON.stringify(this.provider)}, name=${JSON.stringify(this.name)})`;
+    }
+    equals(other) {
+        if (typeof other === 'string') {
+            return this.toString() === other;
+        }
+        if (other instanceof ModelId) {
+            return this.provider === other.provider && this.name === other.name;
+        }
+        return false;
+    }
+    columnName(includeProvider = false) {
+        if (includeProvider && this.provider) {
+            return (0, utils_js_1.cleanColumnName)(`${this.provider}_${this.name}`);
+        }
+        return (0, utils_js_1.cleanColumnName)(this.name);
+    }
+}
+exports.ModelId = ModelId;

package/script/src/openai.d.ts

@@ -0,0 +1,17 @@
+import OpenAI from 'openai';
+import { z } from '../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+export type AIConversation = Array<OpenAI.Responses.EasyInputMessage>;
+export type AIParams = Omit<OpenAI.Responses.ResponseCreateParams, 'model' | 'input' | 'text'>;
+export type AIOutput = Array<OpenAI.Responses.ResponseOutputItem>;
+export type AIResult<T = string> = {
+    parsed: T | null;
+    output_text: string | null;
+    output: AIOutput | null;
+    error: Error | null;
+};
+/**
+ * Safely calls askOpenAI with retry logic.
+ * On each retry, prefixes the prompt with context about the previous failure.
+ */
+export declare function askOpenAISafe<T = string>(prompt: string | AIConversation, model: string, schema?: z.ZodType<T> | null, extraParams?: AIParams, maxRetries?: number, onError?: 'throw' | 'return'): Promise<AIResult<T>>;
+//# sourceMappingURL=openai.d.ts.map

package/script/src/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/src/openai.ts"],"names":[],"mappings":"AAGA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,6CAA6C,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;AACtE,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,oBAAoB,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;AAC/F,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;AAElE,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,MAAM,IAAI;IAClC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACpB,CAAC;AAoFF;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,MAAM,EAC7C,MAAM,EAAE,MAAM,GAAG,cAAc,EAC/B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC5B,WAAW,CAAC,EAAE,QAAQ,EACtB,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,OAAO,GAAG,QAAkB,GACnC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAkEtB"}

package/script/src/openai.js

@@ -0,0 +1,175 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askOpenAISafe = askOpenAISafe;
+/* eslint no-console: ["warn", { allow: ["log", "warn", "error"] }] */
+const dntShim = __importStar(require("../_dnt.shims.js"));
+const openai_1 = __importDefault(require("openai"));
+const index_js_1 = require("../deps/jsr.io/@zod/zod/4.1.12/src/index.js");
+async function askOpenAI(prompt, model, schema, extraParams, onError = 'throw') {
+    const openAIClient = new openai_1.default({
+        apiKey: dntShim.Deno.env.get('OPENAI_API_KEY'),
+        fetchOptions: {
+            signal: dntShim.dntGlobalThis.abortSignal // Pass through abort signal if available
+        }
+    });
+    const { output_parsed, output_text, output } = await openAIClient.responses.parse({
+        ...extraParams,
+        model,
+        input: Array.isArray(prompt) ? prompt : [{
+                role: 'user',
+                content: prompt
+            }],
+        ...(schema != null ? {
+            text: {
+                format: getCachedZodTextFormat(schema, 'response')
+            }
+        } : {})
+    });
+    if (schema == null) {
+        return {
+            parsed: output_text,
+            output_text,
+            output
+        };
+    }
+    if (output_parsed instanceof Error && onError === 'throw') {
+        throw output_parsed;
+    }
+    return {
+        parsed: output_parsed,
+        output_text,
+        output
+    };
+}
+class ZodValidationError extends Error {
+}
+;
+/**
+ * Safely calls askOpenAI with retry logic.
+ * On each retry, prefixes the prompt with context about the previous failure.
+ */
+async function askOpenAISafe(prompt, model, schema, extraParams, maxRetries = 3, onError = 'throw') {
+    let lastResult = null;
+    let currentPrompt = Array.isArray(prompt) ? prompt : [{
+            role: 'user',
+            content: prompt
+        }];
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const result = await askOpenAI(currentPrompt, model, schema, extraParams, 'return');
+            if (result.parsed instanceof Error) {
+                lastResult = {
+                    parsed: null,
+                    output_text: result.output_text,
+                    output: result.output,
+                    error: result.parsed
+                };
+            }
+            else {
+                return {
+                    parsed: result.parsed,
+                    output_text: result.output_text,
+                    output: result.output,
+                    error: null
+                };
+            }
+        }
+        catch (error) {
+            lastResult = {
+                parsed: null,
+                output_text: null,
+                output: null,
+                error: error instanceof Error ? error : new Error(JSON.stringify(error))
+            };
+        }
+        lastResult = lastResult;
+        if (attempt < maxRetries) {
+            let errorMessage;
+            if (lastResult.error instanceof ZodValidationError) {
+                errorMessage = `Previous attempt failed with Zod parsing error:\n${lastResult.error.message}.\nYour raw response was:\n${lastResult.output_text}.`;
+                currentPrompt = [
+                    ...currentPrompt,
+                    {
+                        role: 'system',
+                        content: errorMessage
+                    }
+                ];
+            }
+            else if (lastResult.error instanceof Error) {
+                errorMessage = `Previous attempt failed with error: ${lastResult.error.message}`;
+            }
+            else {
+                errorMessage = 'Previous attempt failed with an unknown error.';
+            }
+            console.log(`askOpenAISafe retrying! Previous attempt ${attempt + 1} failed with: ${errorMessage}`);
+        }
+    }
+    if (onError === 'return') {
+        return lastResult;
+    }
+    throw lastResult.error;
+}
+const zodTextFormatCache = new Map();
+function getCachedZodTextFormat(zodObject, name) {
+    const cached = zodTextFormatCache.get(zodObject);
+    if (cached && cached.name === name) {
+        return cached;
+    }
+    const format = zodTextFormat(zodObject, name);
+    zodTextFormatCache.set(zodObject, format);
+    return format;
+}
+function zodTextFormat(zodObject, name) {
+    return {
+        type: 'json_schema',
+        name,
+        strict: true,
+        schema: index_js_1.z.toJSONSchema(zodObject, { target: 'draft-7' }),
+        $brand: 'auto-parseable-response-format',
+        $parseRaw: (content) => {
+            try {
+                return zodObject.parse(JSON.parse(content));
+            }
+            catch (error) {
+                return new ZodValidationError(error instanceof Error ? error.message : String(error));
+            }
+        },
+        __output: undefined
+    };
+}

package/script/src/schemas/brand.schema.d.ts

@@ -0,0 +1,182 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+import type { SearchOptions } from './search.schema.js';
+/**
+ * Zod schemas for brand information.
+ * Used for validation in backend and type inference in frontend.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+/**
+ * Schema for a product or service offered by a brand.
+ */
+declare const ProductSchema: z.ZodObject<{
+    name: z.ZodString;
+    category: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for brand information including products, markets, and positioning.
+ */
+export declare const BrandSchema: z.ZodObject<{
+    name: z.ZodString;
+    shortName: z.ZodString;
+    description: z.ZodString;
+    domain: z.ZodString;
+    sectors: z.ZodArray<z.ZodString>;
+    markets: z.ZodArray<z.ZodString>;
+    portfolio: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        category: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    marketPosition: z.ZodEnum<{
+        leader: "leader";
+        challenger: "challenger";
+        niche: "niche";
+        follower: "follower";
+    }>;
+    favicon: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Base TypeScript type inferred from ProductSchema.
+ * Extended with keywordSeeds which is added after OpenAI response.
+ */
+export type Product = z.infer<typeof ProductSchema> & {
+    keywordSeeds?: Array<string>;
+};
+/**
+ * TypeScript type inferred from BrandSchema.
+ * Extended to use the enriched Product type for portfolio.
+ * Safe to import in frontend with `import type`.
+ */
+export type Brand = Omit<z.infer<typeof BrandSchema>, 'portfolio'> & {
+    portfolio: Array<Product>;
+};
+/**
+ * Brand with additional context fields for pipeline processing.
+ * Extends Brand with optional fields that provide context for analysis.
+ */
+export type BrandContext = Brand & {
+    /** Language of the brand information (ISO 639-1 code). */
+    language: string;
+    /** Primary market/country for the brand (ISO or free text). */
+    country: string;
+    /** Primary sector for the brand. */
+    sector: string;
+    /** Additional context or briefing about the brand. */
+    briefing: string | null;
+};
+/**
+ * Base schema for brand list endpoints (e.g., /ai_audit/competitors).
+ * Exported schema adds uniqueness validation below.
+ */
+declare const BrandListBaseSchema: z.ZodObject<{
+    brands: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        shortName: z.ZodString;
+        description: z.ZodString;
+        domain: z.ZodString;
+        sectors: z.ZodArray<z.ZodString>;
+        markets: z.ZodArray<z.ZodString>;
+        portfolio: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            category: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        marketPosition: z.ZodEnum<{
+            leader: "leader";
+            challenger: "challenger";
+            niche: "niche";
+            follower: "follower";
+        }>;
+        favicon: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    explanation: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Response schema for brand list endpoints (e.g., /ai_audit/competitors).
+ */
+export declare const BrandListSchema: z.ZodObject<{
+    brands: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        shortName: z.ZodString;
+        description: z.ZodString;
+        domain: z.ZodString;
+        sectors: z.ZodArray<z.ZodString>;
+        markets: z.ZodArray<z.ZodString>;
+        portfolio: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            category: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        marketPosition: z.ZodEnum<{
+            leader: "leader";
+            challenger: "challenger";
+            niche: "niche";
+            follower: "follower";
+        }>;
+        favicon: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    explanation: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Response type for brand list endpoints including explanation.
+ */
+export type BrandListResponse = z.infer<typeof BrandListBaseSchema>;
+/**
+ * Helper type for brands with competitor flag.
+ * Used in frontend to distinguish own brands from competitors.
+ */
+export type FlaggedBrand = Brand & {
+    isCompetitor: boolean;
+};
+/**
+ * Base options for brand-related operations.
+ */
+export type BrandOptions = {
+    /** User's preferred language, for response localization. */
+    userLanguage?: string | null;
+    /** Name of the brand to search for or analyze. */
+    brand?: string;
+    /** Official website domain of the brand (e.g., "tesla.com"). */
+    brandDomain?: string;
+    /** Language for the returned keywords, default is English ("en"), for both info and keywords. */
+    language: string;
+    /** Industry sector the brand operates in (e.g., "automotive", "technology"), will be used to
+     * specify the initial brand context and the keywords sector, default value for keywords is 'general' */
+    sector?: string | null;
+    /** Geographical market or region (e.g., "United States", "Europe"), will be used to
+     * specify the initial brand context and the keywords market, default value for keywords is 'global' */
+    market?: string | null;
+    /** Additional context or briefing about the brand, will be added to the initial brand context. */
+    briefing?: string | null;
+};
+/**
+ * Options for competitor search operations.
+ */
+interface CompetitorOptions extends Omit<BrandOptions, 'brand' | 'brandDomain'> {
+    /** Single brand name or array of brand names to search competitors for. */
+    brand?: string | Array<string>;
+    /** Single brand domain or array of brand domains. */
+    brandDomain?: string | Array<string>;
+    /** Only consider as competitors those that do NOT belong to the same parent
+     * company as the original brand(s) (e.g. Fanta is NOT a competitor of Coca-Cola
+     * in this sense). Default is true. */
+    strict?: boolean;
+    /** Additional instructions for the competitor search. */
+    instructions?: string | null;
+    /** List of brands the user already has information about. */
+    brands?: Array<Brand> | null;
+}
+/**
+ * Options for competitor search combining competitor-specific options with search parameters.
+ */
+export type CompetitorSearchOptions = CompetitorOptions & Omit<SearchOptions, 'prompt'>;
+/**
+ * Options for brand information search operations.
+ * Combines brand-specific options with general search parameters.
+ */
+export type BrandSearchOptions = BrandOptions & Omit<SearchOptions, 'prompt'> & {
+    /** ISO 3166-1 alpha-2 country code to narrow search results for the brand info
+     * to a specific country (e.g., "US", "ES", "FR"). */
+    countryISOCode?: string | null;
+};
+export {};
+//# sourceMappingURL=brand.schema.d.ts.map

package/script/src/schemas/brand.schema.d.ts.map

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

package/script/src/schemas/brand.schema.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrandListSchema = exports.BrandSchema = void 0;
+const index_js_1 = require("../../deps/jsr.io/@zod/zod/4.1.12/src/index.js");
+/**
+ * Zod schemas for brand information.
+ * Used for validation in backend and type inference in frontend.
+ *
+ * ⚠️ This file should contain ONLY schema definitions.
+ * No business logic, prompts, or function implementations.
+ */
+/**
+ * Schema for a product or service offered by a brand.
+ */
+const ProductSchema = index_js_1.z.object({
+    name: index_js_1.z.string().describe('Name of the product or service.'),
+    category: index_js_1.z.string().nullable().describe('Category of the product or service.')
+}).describe('Represents a product or service offered by a brand.');
+/**
+ * Schema for brand information including products, markets, and positioning.
+ */
+exports.BrandSchema = index_js_1.z.object({
+    name: index_js_1.z.string().describe('Full name of the brand. E.g. "Tesla, Inc." or "Automobiles Peugeot".'),
+    shortName: index_js_1.z.string().describe('Short, common/canonical name of the brand, if different from the official name. ' +
+        'E.g. "Tesla" instead of "Tesla, Inc.", or "Peugeot" instead of "Automobiles Peugeot".'),
+    description: index_js_1.z.string().describe('Description of the brand.'),
+    domain: index_js_1.z.string().min(1).describe('Official website of the brand.'),
+    sectors: index_js_1.z.array(index_js_1.z.string()).describe('List of main industrial sectors the brand operates in.'),
+    markets: index_js_1.z.array(index_js_1.z.string()).describe('List of main geographical markets the brand operates in.'),
+    portfolio: index_js_1.z.array(ProductSchema).describe('List of products or services offered by the brand.'),
+    marketPosition: index_js_1.z.enum(['leader', 'challenger', 'niche', 'follower']).describe('Market position of the brand.'),
+    favicon: index_js_1.z.string().nullable().describe('URL of the brand\'s favicon, if available.')
+}).describe('Represents a brand and its attributes.');
+/**
+ * Base schema for brand list endpoints (e.g., /ai_audit/competitors).
+ * Exported schema adds uniqueness validation below.
+ */
+const BrandListBaseSchema = index_js_1.z.object({
+    brands: index_js_1.z.array(exports.BrandSchema).min(3).describe('List of brands.'),
+    explanation: index_js_1.z.string().describe('Brief explanation of the identified competitors and the reasoning behind their selection')
+}).describe('List of brands.');
+/**
+ * Response schema for brand list endpoints (e.g., /ai_audit/competitors).
+ */
+exports.BrandListSchema = BrandListBaseSchema.refine((data) => {
+    const shortNames = data.brands.map(brand => brand.shortName);
+    const uniqueShortNames = new Set(shortNames);
+    return shortNames.length === uniqueShortNames.size;
+}, {
+    message: 'All brands must be unique! Don\'t repeat the same brand!'
+}).describe('List of brands.');
+;

package/script/src/schemas/entity.schema.d.ts

@@ -0,0 +1,14 @@
+import { z } from '../../deps/jsr.io/@zod/zod/4.1.12/src/index.js';
+export declare const EntitySchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+}, z.core.$strip>;
+export declare const EntitiesSchema: z.ZodObject<{
+    entities: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Entity = z.infer<typeof EntitySchema>;
+export type Entities = z.infer<typeof EntitiesSchema>;
+//# sourceMappingURL=entity.schema.d.ts.map