@graphext/cuery 0.7.0 → 0.9.0

package/esm/mod.d.ts

@@ -20,9 +20,9 @@ export * from './src/tools/summarize.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
 export * from './src/tools/prompts.js';
+export * from './src/tools/scorer.js';
 export * from './src/helpers/seedKeywords.js';
 export * from './src/tools/generic.js';
-export * from './src/api.js';
 export * from './src/apis/chatgptScraper/index.js';
 export * from './src/apis/googleAds/keywordPlanner.js';
 export * from './src/schemas/index.js';

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}

package/esm/mod.js

@@ -22,9 +22,9 @@ export * from './src/tools/summarize.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
 export * from './src/tools/prompts.js';
+export * from './src/tools/scorer.js';
 export * from './src/helpers/seedKeywords.js';
 export * from './src/tools/generic.js';
-export * from './src/api.js';
 export * from './src/apis/chatgptScraper/index.js';
 export * from './src/apis/googleAds/keywordPlanner.js';
 export * from './src/schemas/index.js';

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

@@ -20,6 +20,7 @@ declare const ProductSchema: z.ZodObject<{
 export declare const BrandSchema: z.ZodObject<{
     name: z.ZodString;
     shortName: z.ZodString;
+    aliases: z.ZodArray<z.ZodString>;
     description: z.ZodString;
     domain: z.ZodString;
     sectors: z.ZodArray<z.ZodString>;
@@ -46,10 +47,13 @@ export type Product = z.infer<typeof ProductSchema> & {
 /**
  * TypeScript type inferred from BrandSchema.
  * Extended to use the enriched Product type for portfolio.
+ * Keeps aliases optional at type-level for backward compatibility with
+ * legacy persisted Brand payloads that may not include this field.
  * Safe to import in frontend with `import type`.
  */
-export type Brand = Omit<z.infer<typeof BrandSchema>, 'portfolio'> & {
+export type Brand = Omit<z.infer<typeof BrandSchema>, 'portfolio' | 'aliases'> & {
     portfolio: Array<Product>;
+    aliases?: Array<string>;
 };
 /**
  * Brand with additional context fields for pipeline processing.
@@ -73,6 +77,7 @@ declare const BrandListBaseSchema: z.ZodObject<{
     brands: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         shortName: z.ZodString;
+        aliases: z.ZodArray<z.ZodString>;
         description: z.ZodString;
         domain: z.ZodString;
         sectors: z.ZodArray<z.ZodString>;
@@ -98,6 +103,7 @@ export declare const BrandListSchema: z.ZodObject<{
     brands: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         shortName: z.ZodString;
+        aliases: z.ZodArray<z.ZodString>;
         description: z.ZodString;
         domain: z.ZodString;
         sectors: z.ZodArray<z.ZodString>;

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

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

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

@@ -20,6 +20,8 @@ export const BrandSchema = z.object({
     name: z.string().describe('Full name of the brand. E.g. "Tesla, Inc." or "Automobiles Peugeot".'),
     shortName: 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".'),
+    aliases: z.array(z.string()).describe('Alternative names for the same brand (e.g., local variants, abbreviations, or common misspellings). ' +
+        'Always include this field; use [] when no reliable aliases are known.'),
     description: z.string().describe('Description of the brand.'),
     domain: z.string().min(1).describe('Official website of the brand.'),
     sectors: z.array(z.string()).describe('List of main industrial sectors the brand operates in.'),

package/esm/src/tools/brands.d.ts

@@ -18,7 +18,7 @@ export declare function generatePortfolioKeywords(product: Product, sector: stri
  * Generate seed keywords for all portfolio items in a brand concurrently,
  * updating the keywordSeeds field in-place for each product.
  */
-export declare function enrichBrandPortfolioWithKeywords(brand: Brand, language?: string, model?: string, maxConcurrency?: number, sector?: string | null, market?: string | null): Promise<Brand>;
+export declare function enrichBrandPortfolioWithKeywords<T extends Brand>(brand: T, language?: string, model?: string, maxConcurrency?: number, sector?: string | null, market?: string | null): Promise<T>;
 export declare function generateCompetitorsInfo({ brand, brandDomain, sector, market, briefing, strict, instructions, brands, language, userLanguage, model, useSearch, countryISOCode, contextSize, reasoningEffort }: CompetitorSearchOptions): Promise<BrandListResponse>;
 export declare function generateBrandInfo({ brand, brandDomain, language, userLanguage, sector, market, briefing, model, useSearch, countryISOCode, contextSize, reasoningEffort }: BrandSearchOptions): Promise<Brand>;
 export declare function concatBrands(ownBrands: Array<Brand>, competitors: Array<Brand>): Array<FlaggedBrand>;

package/esm/src/tools/brands.d.ts.map

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

package/esm/src/tools/brands.js

@@ -77,6 +77,8 @@ should have the following fields:
 - shortName: A short, common/canonical name of the competitor brand, if different from the official name.
   E.g. "Tesla" instead of "Tesla, Inc.", or "Peugeot" instead of "Automobiles Peugeot". If not applicable,
   set same as name.
+- aliases: Array of alternative names for the competitor brand (e.g., local variants, abbreviations,
+  common misspellings, legacy names). Always include this field; if no reliable aliases are known, use [].
 - description: A brief description of the competitor brand's main activity.
 - domain: The official website of the competitor brand, if available.
 - sectors: A list of main industrial sectors the competitor brand operates in.
@@ -91,6 +93,7 @@ It's more important to be comprehensive than selective, so include more competit
 Try to order them by relevance, with the most direct and bigger competitors first.
 
 Return the answer (field values) in the language "{language}".
+Always include "aliases" for every brand object, even if it is an empty array.
 
 Also provide an "explanation" field with a brief summary (2-3 sentences) explaining the reasoning behind
 the competitors you identified: what makes them relevant competitors, how they relate to the original brand,
@@ -126,6 +129,8 @@ Find out the following information about this brand:
 - shortName: A 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". If not applicable,
   set same as name.
+- aliases: Array of alternative names for the same brand (local variants, abbreviations, common misspellings,
+  or legacy names). Always include this field; if no reliable aliases are known, use [].
 - description: A brief description of the brand's main activity.
 - domain: The official website of the brand, if available.
 - sectors: A list of specific industrial sectors the brand operates in, ordered by relevance. Be precise and concrete rather than generic - for example, instead of "education", use "professional training for unemployed", "corporate learning and development", or "online coding bootcamps". Adapt the specificity level to match the brand's actual focus and niche.
@@ -137,7 +142,16 @@ Find out the following information about this brand:
 - favicon: URL of the brand's favicon, if available.
 
 Return the answer as a JSON object with field values in the language "{language}".
+Always include "aliases", even when empty.
 `);
+function ensureBrandAliases(brand) {
+    return {
+        ...brand,
+        aliases: Array.isArray(brand.aliases)
+            ? brand.aliases
+            : []
+    };
+}
 /**
  * Generate seed keywords for a single portfolio item using an LLM.
  */
@@ -199,10 +213,12 @@ export async function generateCompetitorsInfo({ brand, brandDomain, sector = nul
         reasoningEffort
     });
     // Make sure these are clean domains
-    response.brands.map(brand => {
+    response.brands = response.brands.map((brand) => {
+        const normalizedBrand = ensureBrandAliases(brand);
         if (brand.domain) {
-            brand.domain = extractDomain(brand.domain);
+            normalizedBrand.domain = extractDomain(brand.domain);
         }
+        return normalizedBrand;
     });
     const enrichedBrands = await mapParallel(response.brands, 100, async (brand) => enrichBrandPortfolioWithKeywords(brand, language, model, undefined, sector, market));
     return {
@@ -233,18 +249,19 @@ export async function generateBrandInfo({ brand, brandDomain, language = 'en', u
         reasoningEffort: reasoningEffort,
         useSearch
     });
+    const normalizedBrandInfo = ensureBrandAliases(brandInfo);
     // Make sure this is a clean domain
-    brandInfo.domain = extractDomain(brandInfo.domain);
-    const enrichedBrand = await enrichBrandPortfolioWithKeywords(brandInfo, language, model, undefined, sector, market);
+    normalizedBrandInfo.domain = extractDomain(normalizedBrandInfo.domain);
+    const enrichedBrand = await enrichBrandPortfolioWithKeywords(normalizedBrandInfo, language, model, undefined, sector, market);
     return enrichedBrand;
 }
 export function concatBrands(ownBrands, competitors) {
     const ownBrandsWithFlag = ownBrands.map((brand) => ({
-        ...brand,
+        ...ensureBrandAliases(brand),
         isCompetitor: false
     }));
     const competitorsWithFlag = competitors.map((brand) => ({
-        ...brand,
+        ...ensureBrandAliases(brand),
         isCompetitor: true
     }));
     return [...ownBrandsWithFlag, ...competitorsWithFlag];
@@ -377,11 +394,16 @@ export function rankBrandsInText(text, brands, entities) {
     // Create a normalized version of text for pattern matching (expands CamelCase, etc.)
     const normalizedText = normalizeTextForMatching(text);
     const brandEntities = entities?.filter(entity => entity.type.toLowerCase() === 'brand') ?? [];
-    // Build a map from ultra-normalized FlaggedBrand name to the entity text variation (if any)
-    // Using createBrandMatchKey to handle cases like "acmeco" matching "Acme&Co"
+    // Build a map from ultra-normalized brand token to the entity text variation (if any)
+    // Using createBrandMatchKey to handle cases like "acmeco" matching "Acme&Co".
+    // This map is used for shortName and aliases alike.
     const entityTextByNormalizedBrand = new Map();
     for (const entity of brandEntities) {
-        entityTextByNormalizedBrand.set(createBrandMatchKey(entity.name), entity.name);
+        const key = createBrandMatchKey(entity.name);
+        if (!key || entityTextByNormalizedBrand.has(key)) {
+            continue;
+        }
+        entityTextByNormalizedBrand.set(key, entity.name);
     }
     // Set of ultra-normalized entity names that match a FlaggedBrand (to exclude from separate processing)
     const matchedEntityNames = new Set();
@@ -400,10 +422,19 @@ export function rankBrandsInText(text, brands, entities) {
     // Process FlaggedBrands, using entity text as an additional search variant when available
     for (const brand of brands) {
         let earliestPosition = Infinity;
-        const normalizedShortName = createBrandMatchKey(brand.shortName);
-        // Check if there's a matching entity for this brand (using ultra-normalized comparison)
-        const entityText = entityTextByNormalizedBrand.get(normalizedShortName);
-        if (entityText != null) {
+        const brandNameVariants = [
+            brand.shortName,
+            ...(Array.isArray(brand.aliases) ? brand.aliases : [])
+        ].filter((value) => value != null && value.trim() !== '');
+        const normalizedBrandVariants = new Set(brandNameVariants
+            .map((value) => createBrandMatchKey(value))
+            .filter((value) => value.length > 0));
+        // Check if there's a matching entity for this brand (shortName or alias key match)
+        for (const normalizedVariant of normalizedBrandVariants) {
+            const entityText = entityTextByNormalizedBrand.get(normalizedVariant);
+            if (entityText == null) {
+                continue;
+            }
             matchedEntityNames.add(createBrandMatchKey(entityText));
             // Use flexible pattern matching to find the entity in text (handles CamelCase, &/and, etc.)
             const entityPattern = createBrandMatchPattern(entityText);
@@ -412,9 +443,9 @@ export function rankBrandsInText(text, brands, entities) {
                 earliestPosition = Math.min(earliestPosition, position);
             }
         }
-        // Check for shortName using flexible pattern matching
-        if (brand.shortName != null && brand.shortName.trim() !== '') {
-            const brandPattern = createBrandMatchPattern(brand.shortName);
+        // Check shortName + aliases using flexible pattern matching
+        for (const brandNameVariant of brandNameVariants) {
+            const brandPattern = createBrandMatchPattern(brandNameVariant);
             const position = findPatternPosition(brandPattern);
             if (position !== -1) {
                 earliestPosition = Math.min(earliestPosition, position);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphext/cuery",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Cuery tools for AI-powered keyword research and brand analysis",
   "repository": {
     "type": "git",

package/script/mod.d.ts

@@ -20,9 +20,9 @@ export * from './src/tools/summarize.js';
 export * from './src/tools/sources.js';
 export * from './src/tools/entities.js';
 export * from './src/tools/prompts.js';
+export * from './src/tools/scorer.js';
 export * from './src/helpers/seedKeywords.js';
 export * from './src/tools/generic.js';
-export * from './src/api.js';
 export * from './src/apis/chatgptScraper/index.js';
 export * from './src/apis/googleAds/keywordPlanner.js';
 export * from './src/schemas/index.js';

package/script/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,GACd,MAAM,0BAA0B,CAAC;AAGlC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC"}

package/script/mod.js

@@ -45,9 +45,9 @@ __exportStar(require("./src/tools/summarize.js"), exports);
 __exportStar(require("./src/tools/sources.js"), exports);
 __exportStar(require("./src/tools/entities.js"), exports);
 __exportStar(require("./src/tools/prompts.js"), exports);
+__exportStar(require("./src/tools/scorer.js"), exports);
 __exportStar(require("./src/helpers/seedKeywords.js"), exports);
 __exportStar(require("./src/tools/generic.js"), exports);
-__exportStar(require("./src/api.js"), exports);
 __exportStar(require("./src/apis/chatgptScraper/index.js"), exports);
 __exportStar(require("./src/apis/googleAds/keywordPlanner.js"), exports);
 __exportStar(require("./src/schemas/index.js"), exports);

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

@@ -20,6 +20,7 @@ declare const ProductSchema: z.ZodObject<{
 export declare const BrandSchema: z.ZodObject<{
     name: z.ZodString;
     shortName: z.ZodString;
+    aliases: z.ZodArray<z.ZodString>;
     description: z.ZodString;
     domain: z.ZodString;
     sectors: z.ZodArray<z.ZodString>;
@@ -46,10 +47,13 @@ export type Product = z.infer<typeof ProductSchema> & {
 /**
  * TypeScript type inferred from BrandSchema.
  * Extended to use the enriched Product type for portfolio.
+ * Keeps aliases optional at type-level for backward compatibility with
+ * legacy persisted Brand payloads that may not include this field.
  * Safe to import in frontend with `import type`.
  */
-export type Brand = Omit<z.infer<typeof BrandSchema>, 'portfolio'> & {
+export type Brand = Omit<z.infer<typeof BrandSchema>, 'portfolio' | 'aliases'> & {
     portfolio: Array<Product>;
+    aliases?: Array<string>;
 };
 /**
  * Brand with additional context fields for pipeline processing.
@@ -73,6 +77,7 @@ declare const BrandListBaseSchema: z.ZodObject<{
     brands: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         shortName: z.ZodString;
+        aliases: z.ZodArray<z.ZodString>;
         description: z.ZodString;
         domain: z.ZodString;
         sectors: z.ZodArray<z.ZodString>;
@@ -98,6 +103,7 @@ export declare const BrandListSchema: z.ZodObject<{
     brands: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         shortName: z.ZodString;
+        aliases: z.ZodArray<z.ZodString>;
         description: z.ZodString;
         domain: z.ZodString;
         sectors: z.ZodArray<z.ZodString>;

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

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

@@ -23,6 +23,8 @@ 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".'),
+    aliases: index_js_1.z.array(index_js_1.z.string()).describe('Alternative names for the same brand (e.g., local variants, abbreviations, or common misspellings). ' +
+        'Always include this field; use [] when no reliable aliases are known.'),
     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.'),

package/script/src/tools/brands.d.ts

@@ -18,7 +18,7 @@ export declare function generatePortfolioKeywords(product: Product, sector: stri
  * Generate seed keywords for all portfolio items in a brand concurrently,
  * updating the keywordSeeds field in-place for each product.
  */
-export declare function enrichBrandPortfolioWithKeywords(brand: Brand, language?: string, model?: string, maxConcurrency?: number, sector?: string | null, market?: string | null): Promise<Brand>;
+export declare function enrichBrandPortfolioWithKeywords<T extends Brand>(brand: T, language?: string, model?: string, maxConcurrency?: number, sector?: string | null, market?: string | null): Promise<T>;
 export declare function generateCompetitorsInfo({ brand, brandDomain, sector, market, briefing, strict, instructions, brands, language, userLanguage, model, useSearch, countryISOCode, contextSize, reasoningEffort }: CompetitorSearchOptions): Promise<BrandListResponse>;
 export declare function generateBrandInfo({ brand, brandDomain, language, userLanguage, sector, market, briefing, model, useSearch, countryISOCode, contextSize, reasoningEffort }: BrandSearchOptions): Promise<Brand>;
 export declare function concatBrands(ownBrands: Array<Brand>, competitors: Array<Brand>): Array<FlaggedBrand>;

package/script/src/tools/brands.d.ts.map

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

package/script/src/tools/brands.js

@@ -89,6 +89,8 @@ should have the following fields:
 - shortName: A short, common/canonical name of the competitor brand, if different from the official name.
   E.g. "Tesla" instead of "Tesla, Inc.", or "Peugeot" instead of "Automobiles Peugeot". If not applicable,
   set same as name.
+- aliases: Array of alternative names for the competitor brand (e.g., local variants, abbreviations,
+  common misspellings, legacy names). Always include this field; if no reliable aliases are known, use [].
 - description: A brief description of the competitor brand's main activity.
 - domain: The official website of the competitor brand, if available.
 - sectors: A list of main industrial sectors the competitor brand operates in.
@@ -103,6 +105,7 @@ It's more important to be comprehensive than selective, so include more competit
 Try to order them by relevance, with the most direct and bigger competitors first.
 
 Return the answer (field values) in the language "{language}".
+Always include "aliases" for every brand object, even if it is an empty array.
 
 Also provide an "explanation" field with a brief summary (2-3 sentences) explaining the reasoning behind
 the competitors you identified: what makes them relevant competitors, how they relate to the original brand,
@@ -138,6 +141,8 @@ Find out the following information about this brand:
 - shortName: A 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". If not applicable,
   set same as name.
+- aliases: Array of alternative names for the same brand (local variants, abbreviations, common misspellings,
+  or legacy names). Always include this field; if no reliable aliases are known, use [].
 - description: A brief description of the brand's main activity.
 - domain: The official website of the brand, if available.
 - sectors: A list of specific industrial sectors the brand operates in, ordered by relevance. Be precise and concrete rather than generic - for example, instead of "education", use "professional training for unemployed", "corporate learning and development", or "online coding bootcamps". Adapt the specificity level to match the brand's actual focus and niche.
@@ -149,7 +154,16 @@ Find out the following information about this brand:
 - favicon: URL of the brand's favicon, if available.
 
 Return the answer as a JSON object with field values in the language "{language}".
+Always include "aliases", even when empty.
 `);
+function ensureBrandAliases(brand) {
+    return {
+        ...brand,
+        aliases: Array.isArray(brand.aliases)
+            ? brand.aliases
+            : []
+    };
+}
 /**
  * Generate seed keywords for a single portfolio item using an LLM.
  */
@@ -211,10 +225,12 @@ async function generateCompetitorsInfo({ brand, brandDomain, sector = null, mark
         reasoningEffort
     });
     // Make sure these are clean domains
-    response.brands.map(brand => {
+    response.brands = response.brands.map((brand) => {
+        const normalizedBrand = ensureBrandAliases(brand);
         if (brand.domain) {
-            brand.domain = (0, urls_js_1.extractDomain)(brand.domain);
+            normalizedBrand.domain = (0, urls_js_1.extractDomain)(brand.domain);
         }
+        return normalizedBrand;
     });
     const enrichedBrands = await (0, async_js_1.mapParallel)(response.brands, 100, async (brand) => enrichBrandPortfolioWithKeywords(brand, language, model, undefined, sector, market));
     return {
@@ -245,18 +261,19 @@ async function generateBrandInfo({ brand, brandDomain, language = 'en', userLang
         reasoningEffort: reasoningEffort,
         useSearch
     });
+    const normalizedBrandInfo = ensureBrandAliases(brandInfo);
     // Make sure this is a clean domain
-    brandInfo.domain = (0, urls_js_1.extractDomain)(brandInfo.domain);
-    const enrichedBrand = await enrichBrandPortfolioWithKeywords(brandInfo, language, model, undefined, sector, market);
+    normalizedBrandInfo.domain = (0, urls_js_1.extractDomain)(normalizedBrandInfo.domain);
+    const enrichedBrand = await enrichBrandPortfolioWithKeywords(normalizedBrandInfo, language, model, undefined, sector, market);
     return enrichedBrand;
 }
 function concatBrands(ownBrands, competitors) {
     const ownBrandsWithFlag = ownBrands.map((brand) => ({
-        ...brand,
+        ...ensureBrandAliases(brand),
         isCompetitor: false
     }));
     const competitorsWithFlag = competitors.map((brand) => ({
-        ...brand,
+        ...ensureBrandAliases(brand),
         isCompetitor: true
     }));
     return [...ownBrandsWithFlag, ...competitorsWithFlag];
@@ -389,11 +406,16 @@ function rankBrandsInText(text, brands, entities) {
     // Create a normalized version of text for pattern matching (expands CamelCase, etc.)
     const normalizedText = normalizeTextForMatching(text);
     const brandEntities = entities?.filter(entity => entity.type.toLowerCase() === 'brand') ?? [];
-    // Build a map from ultra-normalized FlaggedBrand name to the entity text variation (if any)
-    // Using createBrandMatchKey to handle cases like "acmeco" matching "Acme&Co"
+    // Build a map from ultra-normalized brand token to the entity text variation (if any)
+    // Using createBrandMatchKey to handle cases like "acmeco" matching "Acme&Co".
+    // This map is used for shortName and aliases alike.
     const entityTextByNormalizedBrand = new Map();
     for (const entity of brandEntities) {
-        entityTextByNormalizedBrand.set(createBrandMatchKey(entity.name), entity.name);
+        const key = createBrandMatchKey(entity.name);
+        if (!key || entityTextByNormalizedBrand.has(key)) {
+            continue;
+        }
+        entityTextByNormalizedBrand.set(key, entity.name);
     }
     // Set of ultra-normalized entity names that match a FlaggedBrand (to exclude from separate processing)
     const matchedEntityNames = new Set();
@@ -412,10 +434,19 @@ function rankBrandsInText(text, brands, entities) {
     // Process FlaggedBrands, using entity text as an additional search variant when available
     for (const brand of brands) {
         let earliestPosition = Infinity;
-        const normalizedShortName = createBrandMatchKey(brand.shortName);
-        // Check if there's a matching entity for this brand (using ultra-normalized comparison)
-        const entityText = entityTextByNormalizedBrand.get(normalizedShortName);
-        if (entityText != null) {
+        const brandNameVariants = [
+            brand.shortName,
+            ...(Array.isArray(brand.aliases) ? brand.aliases : [])
+        ].filter((value) => value != null && value.trim() !== '');
+        const normalizedBrandVariants = new Set(brandNameVariants
+            .map((value) => createBrandMatchKey(value))
+            .filter((value) => value.length > 0));
+        // Check if there's a matching entity for this brand (shortName or alias key match)
+        for (const normalizedVariant of normalizedBrandVariants) {
+            const entityText = entityTextByNormalizedBrand.get(normalizedVariant);
+            if (entityText == null) {
+                continue;
+            }
             matchedEntityNames.add(createBrandMatchKey(entityText));
             // Use flexible pattern matching to find the entity in text (handles CamelCase, &/and, etc.)
             const entityPattern = createBrandMatchPattern(entityText);
@@ -424,9 +455,9 @@ function rankBrandsInText(text, brands, entities) {
                 earliestPosition = Math.min(earliestPosition, position);
             }
         }
-        // Check for shortName using flexible pattern matching
-        if (brand.shortName != null && brand.shortName.trim() !== '') {
-            const brandPattern = createBrandMatchPattern(brand.shortName);
+        // Check shortName + aliases using flexible pattern matching
+        for (const brandNameVariant of brandNameVariants) {
+            const brandPattern = createBrandMatchPattern(brandNameVariant);
             const position = findPatternPosition(brandPattern);
             if (position !== -1) {
                 earliestPosition = Math.min(earliestPosition, position);

package/esm/src/api.d.ts

@@ -1,73 +0,0 @@
-import { type JobId } from './apis/chatgptScraper/index.js';
-import { type Entity } from './schemas/entity.schema.js';
-import { type Funnel } from './schemas/funnel.schema.js';
-import type { ModelIdentifier } from './schemas/models.schema.js';
-import { type Persona } from './schemas/persona.schema.js';
-import { type BrandContext } from './schemas/brand.schema.js';
-import { type Source, type EnrichedSource, type SearchSource } from './schemas/sources.schema.js';
-export type ModelResponse = {
-    prompt: string;
-    model: string;
-    answer: string;
-    sources: Array<Source>;
-    searchQueries: Array<string>;
-    searchSources: Array<SearchSource>;
-};
-export type EnrichedModelResponse = {
-    prompt: string;
-    model: string;
-    answer: string;
-    sources: Array<EnrichedSource>;
-    fanout?: Array<string>;
-    rankedBrandsInAnswer: Array<string>;
-    rankedBrandsInSourceTitles: Array<string>;
-    rankedBrandsInSourceDomains: Array<string>;
-};
-export declare function queryModel(prompts: Array<string | JobId>, model: ModelIdentifier, searchCountry?: string | null): Promise<Array<ModelResponse>>;
-export declare function classifyIntent(texts: Array<string>): Promise<Array<string | null>>;
-export declare function extractTopics(params: {
-    records: Array<Record<string, unknown>>;
-    maxSamples?: number;
-    instructions?: string;
-    language?: string;
-    model?: string;
-}): Promise<{
-    topics: {
-        topic: string;
-        subtopics: string[];
-    }[];
-} | null>;
-export declare function generatePersonas(params: {
-    sector: string;
-    market: string;
-    language: string;
-    brand?: string;
-    brandDomain?: string;
-    count?: number;
-    briefing?: string;
-    instructions?: string;
-    userLanguage?: string;
-    personas?: Array<Persona>;
-    model?: string;
-}): Promise<{
-    personas: {
-        name: string;
-        description: string;
-        keywordSeeds: string[];
-    }[];
-    explanation: string;
-} | null>;
-export declare function extractAndAssignTopics(texts: Array<string>): Promise<Array<{
-    topic: string | null;
-    subtopic: string | null;
-}>>;
-export declare function assignFunnelStages(texts: Array<string>, funnel: Funnel): Promise<Array<{
-    funnelStage: string | null;
-    funnelCategory: string | null;
-}>>;
-export declare function classifyIntoPersonas(texts: Array<string>, personas: Array<Persona>): Promise<Array<Array<string> | null>>;
-export declare function classifyBrandedNonBranded(texts: Array<string>): Promise<Array<string | null>>;
-export declare function extractEntities(texts: Array<string>): Promise<Array<Array<Entity> | null>>;
-export declare function scorePurchaseProbability(texts: Array<string>, numDays?: number): Promise<Array<number | null>>;
-export declare function scoreRelevance(prompts: Array<string>, context: BrandContext): Promise<Array<number | null>>;
-//# sourceMappingURL=api.d.ts.map

package/esm/src/api.d.ts.map

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