@graphext/cuery 0.10.6 → 0.11.0

package/script/src/helpers/seedKeywords.d.ts

@@ -1,68 +0,0 @@
-/**
- * Seed Keyword Functions
- *
- * Pure functions for collecting and grouping seed keywords.
- * No external dependencies - safe to import in both frontend and backend.
- */
-export type { SeedKeyword, SeedKeywordSource } from '../schemas/seedKeyword.schema.js';
-import type { SeedKeyword } from '../schemas/seedKeyword.schema.js';
-interface PortfolioItemLike {
-    name: string;
-    keywordSeeds?: Array<string>;
-}
-interface PersonaLike {
-    name: string;
-    keywordSeeds?: Array<string>;
-}
-interface FunnelCategoryLike {
-    name: string;
-    keywordSeeds?: Array<string>;
-}
-interface FunnelStageLike {
-    stage: string;
-    categories?: Array<FunnelCategoryLike>;
-}
-interface CompetitorLike {
-    name: string;
-    portfolio?: Array<PortfolioItemLike>;
-}
-export interface CollectSeedKeywordsParams {
-    brandPortfolio?: Array<PortfolioItemLike>;
-    personas?: Array<PersonaLike>;
-    funnelStages?: Array<FunnelStageLike>;
-    competitors?: Array<CompetitorLike>;
-    customKeywords?: Array<string>;
-}
-/**
- * Collects seed keywords from all sources and creates SeedKeyword objects
- * with proper metadata (id, source, sourceId, sourceName).
- */
-export declare function collectSeedKeywords({ brandPortfolio, personas, funnelStages, competitors, customKeywords }: CollectSeedKeywordsParams): Array<SeedKeyword>;
-/**
- * Groups seed keywords by their source, maintaining order within each source.
- * Keywords from the same portfolio item, competitor product, or funnel category
- * are grouped together.
- *
- * @param seedKeywords - Flat array of seed keywords
- * @param generateIdeasFromSeeds - When true, returns grouped keywords for idea generation.
- *                                  When false, returns all keywords flattened into a single group.
- * @returns Array of grouped keywords (arrays for same-source groups, single items for personas/custom)
- */
-export declare function groupSeedKeywords(seedKeywords: Array<SeedKeyword>, generateIdeasFromSeeds?: boolean): Array<Array<SeedKeyword> | SeedKeyword>;
-/**
- * Groups seed keywords and extracts just the keyword strings.
- * Convenience wrapper around groupSeedKeywords for cases where
- * only the keyword text is needed (not the full metadata).
- */
-export declare function groupKeywordStrings(seedKeywords: Array<SeedKeyword>, generateIdeasFromSeeds?: boolean): Array<Array<string> | string>;
-/**
- * Collects and groups seed keywords in one step, returning only keyword strings.
- * This is a convenience function for pipelines that need grouped keyword strings
- * without the full SeedKeyword metadata.
- *
- * @param params - Same parameters as collectSeedKeywords
- * @param generateIdeasFromSeeds - When true, returns grouped keywords. When false, returns flat.
- * @returns Grouped keyword strings (arrays for same-source groups, single strings otherwise)
- */
-export declare function collectAndGroupKeywordStrings(params: CollectSeedKeywordsParams, generateIdeasFromSeeds?: boolean): Array<Array<string> | string>;
-//# sourceMappingURL=seedKeywords.d.ts.map

package/script/src/helpers/seedKeywords.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"seedKeywords.d.ts","sourceRoot":"","sources":["../../../src/src/helpers/seedKeywords.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAOpE,UAAU,iBAAiB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,UAAU,WAAW;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,UAAU,kBAAkB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,UAAU,eAAe;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;CACvC;AAED,UAAU,cAAc;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;CACrC;AAMD,MAAM,WAAW,yBAAyB;IACzC,cAAc,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EACnC,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,cAAc,EACd,EAAE,yBAAyB,GAAG,KAAK,CAAC,WAAW,CAAC,CA+EhD;AAcD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAChC,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,EAChC,sBAAsB,GAAE,OAAc,GACpC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC,CA8FzC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,EAChC,sBAAsB,GAAE,OAAc,GACpC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAS/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC5C,MAAM,EAAE,yBAAyB,EACjC,sBAAsB,GAAE,OAAc,GACpC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAG/B"}

package/script/src/helpers/seedKeywords.js

@@ -1,220 +0,0 @@
-"use strict";
-/**
- * Seed Keyword Functions
- *
- * Pure functions for collecting and grouping seed keywords.
- * No external dependencies - safe to import in both frontend and backend.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.collectSeedKeywords = collectSeedKeywords;
-exports.groupSeedKeywords = groupSeedKeywords;
-exports.groupKeywordStrings = groupKeywordStrings;
-exports.collectAndGroupKeywordStrings = collectAndGroupKeywordStrings;
-/**
- * Collects seed keywords from all sources and creates SeedKeyword objects
- * with proper metadata (id, source, sourceId, sourceName).
- */
-function collectSeedKeywords({ brandPortfolio, personas, funnelStages, competitors, customKeywords }) {
-    const keywords = [];
-    // Brand portfolio keywords
-    brandPortfolio?.forEach((portfolioItem) => {
-        if (portfolioItem.keywordSeeds && portfolioItem.keywordSeeds.length > 0) {
-            portfolioItem.keywordSeeds.forEach((keyword) => {
-                keywords.push({
-                    id: `brand-portfolio-${portfolioItem.name}-${keyword}`,
-                    keyword,
-                    source: 'brand-portfolio',
-                    sourceId: portfolioItem.name,
-                    sourceName: portfolioItem.name
-                });
-            });
-        }
-    });
-    // Persona keywords
-    personas?.forEach((persona) => {
-        if (persona.keywordSeeds && persona.keywordSeeds.length > 0) {
-            persona.keywordSeeds.forEach((keyword) => {
-                keywords.push({
-                    id: `persona-${persona.name}-${keyword}`,
-                    keyword,
-                    source: 'persona',
-                    sourceId: persona.name,
-                    sourceName: persona.name
-                });
-            });
-        }
-    });
-    // Funnel category keywords
-    funnelStages?.forEach((stage) => {
-        stage.categories?.forEach((category) => {
-            if (category.keywordSeeds && category.keywordSeeds.length > 0) {
-                category.keywordSeeds.forEach((example) => {
-                    keywords.push({
-                        id: `funnel-${stage.stage}-${category.name}-${example}`,
-                        keyword: example,
-                        source: 'funnel',
-                        sourceId: `${stage.stage}::${category.name}`,
-                        sourceName: `${stage.stage} > ${category.name}`
-                    });
-                });
-            }
-        });
-    });
-    // Competitor portfolio keywords
-    competitors?.forEach((competitor) => {
-        if (competitor.portfolio && competitor.portfolio.length > 0) {
-            competitor.portfolio.forEach((portfolioItem) => {
-                if (portfolioItem.keywordSeeds && portfolioItem.keywordSeeds.length > 0) {
-                    portfolioItem.keywordSeeds.forEach((keyword) => {
-                        keywords.push({
-                            id: `portfolio-${competitor.name}-${portfolioItem.name}-${keyword}`,
-                            keyword,
-                            source: 'portfolio',
-                            sourceId: portfolioItem.name,
-                            sourceName: `${competitor.name} > ${portfolioItem.name}`
-                        });
-                    });
-                }
-            });
-        }
-    });
-    // Custom keywords
-    customKeywords?.forEach((keyword, index) => {
-        keywords.push({
-            id: `custom-${index}-${keyword}`,
-            keyword,
-            source: 'custom'
-        });
-    });
-    return keywords;
-}
-/**
- * Groups seed keywords by their source, maintaining order within each source.
- * Keywords from the same portfolio item, competitor product, or funnel category
- * are grouped together.
- *
- * @param seedKeywords - Flat array of seed keywords
- * @param generateIdeasFromSeeds - When true, returns grouped keywords for idea generation.
- *                                  When false, returns all keywords flattened into a single group.
- * @returns Array of grouped keywords (arrays for same-source groups, single items for personas/custom)
- */
-function groupSeedKeywords(seedKeywords, generateIdeasFromSeeds = true) {
-    let group;
-    const keywords = seedKeywords.reduce((acc, item) => {
-        if (item.source === 'brand-portfolio') {
-            if (item.sourceName === group) {
-                acc.brandInfoKeywords[acc.brandInfoKeywords.length - 1].push(item);
-                return acc;
-            }
-            else {
-                group = item.sourceName;
-                acc.brandInfoKeywords.push([item]);
-            }
-        }
-        else if (item.source === 'portfolio') {
-            if (item.sourceName === group) {
-                acc.competitorKeywords[acc.competitorKeywords.length - 1].push(item);
-                return acc;
-            }
-            else {
-                group = item.sourceName;
-                acc.competitorKeywords.push([item]);
-            }
-        }
-        else if (item.source === 'persona') {
-            group = undefined;
-            acc.personasKeywords.push(item);
-        }
-        else if (item.source === 'funnel') {
-            if (item.sourceName === group) {
-                acc.funnelKeywords[acc.funnelKeywords.length - 1].push(item);
-                return acc;
-            }
-            else {
-                group = item.sourceName;
-                acc.funnelKeywords.push([item]);
-            }
-        }
-        else if (item.source === 'custom') {
-            group = undefined;
-            acc.customKeywords.push(item);
-        }
-        return acc;
-    }, {
-        brandInfoKeywords: [],
-        competitorKeywords: [],
-        personasKeywords: [],
-        funnelKeywords: [],
-        customKeywords: []
-    });
-    const groupedKeywords = [
-        ...keywords.brandInfoKeywords,
-        ...keywords.competitorKeywords,
-        ...keywords.personasKeywords,
-        ...keywords.funnelKeywords,
-        ...keywords.customKeywords
-    ];
-    if (!generateIdeasFromSeeds) {
-        return [[...new Set(groupedKeywords.flat())]].filter(g => g.length > 0);
-    }
-    const normalizeKeyword = (keyword) => ({
-        ...keyword,
-        keyword: keyword.keyword.trim().toLowerCase()
-    });
-    const dedupeKeywordArray = (kws) => {
-        const seen = new Set();
-        return kws.filter(kw => {
-            const normalized = normalizeKeyword(kw);
-            if (seen.has(normalized.keyword)) {
-                return false;
-            }
-            seen.add(normalized.keyword);
-            return true;
-        });
-    };
-    const uniqueKeywordsSet = new Set();
-    const deduplicatedGroupedKeywords = groupedKeywords.reduce((acc, item) => {
-        if (Array.isArray(item)) {
-            const deduped = dedupeKeywordArray(item);
-            if (deduped.length > 0) {
-                acc.push(deduped);
-            }
-            return acc;
-        }
-        const normalized = normalizeKeyword(item);
-        if (uniqueKeywordsSet.has(normalized.keyword)) {
-            return acc;
-        }
-        uniqueKeywordsSet.add(normalized.keyword);
-        acc.push(item);
-        return acc;
-    }, []);
-    return deduplicatedGroupedKeywords;
-}
-/**
- * Groups seed keywords and extracts just the keyword strings.
- * Convenience wrapper around groupSeedKeywords for cases where
- * only the keyword text is needed (not the full metadata).
- */
-function groupKeywordStrings(seedKeywords, generateIdeasFromSeeds = true) {
-    const groupedSeedKeywords = groupSeedKeywords(seedKeywords, generateIdeasFromSeeds);
-    return groupedSeedKeywords.map(g => {
-        if (Array.isArray(g)) {
-            return g.map(kw => kw.keyword);
-        }
-        return g.keyword;
-    });
-}
-/**
- * Collects and groups seed keywords in one step, returning only keyword strings.
- * This is a convenience function for pipelines that need grouped keyword strings
- * without the full SeedKeyword metadata.
- *
- * @param params - Same parameters as collectSeedKeywords
- * @param generateIdeasFromSeeds - When true, returns grouped keywords. When false, returns flat.
- * @returns Grouped keyword strings (arrays for same-source groups, single strings otherwise)
- */
-function collectAndGroupKeywordStrings(params, generateIdeasFromSeeds = true) {
-    const seedKeywords = collectSeedKeywords(params);
-    return groupKeywordStrings(seedKeywords, generateIdeasFromSeeds);
-}

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

@@ -1,15 +0,0 @@
-/**
- * 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/script/src/schemas/seedKeyword.schema.d.ts.map

@@ -1 +0,0 @@
-{"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/script/src/schemas/seedKeyword.schema.js

@@ -1,8 +0,0 @@
-"use strict";
-/**
- * Seed Keyword Types
- *
- * Pure TypeScript types for seed keywords.
- * No runtime dependencies - safe to import in both frontend and backend.
- */
-Object.defineProperty(exports, "__esModule", { value: true });