@ainyc/canonry 3.6.3 → 4.1.1

package/dist/{chunk-RDX6GBWM.js → chunk-O5JZQUPX.js}

@@ -168,8 +168,8 @@ var groundingSourceSchema = z2.object({
 var querySnapshotDtoSchema = z2.object({
   id: z2.string(),
   runId: z2.string(),
-  keywordId: z2.string(),
-  keyword: z2.string().optional(),
+  queryId: z2.string(),
+  query: z2.string().optional(),
   provider: providerNameSchema,
   citationState: citationStateSchema,
   answerMentioned: z2.boolean().optional(),
@@ -191,8 +191,8 @@ var snapshotListResponseSchema = z2.object({
   total: z2.number().int().nonnegative()
 });
 var snapshotDiffRowSchema = z2.object({
-  keywordId: z2.string().nullable(),
-  keyword: z2.string().nullable(),
+  queryId: z2.string().nullable(),
+  query: z2.string().nullable(),
   run1State: citationStateSchema.nullable(),
   run2State: citationStateSchema.nullable(),
   run1AnswerMentioned: z2.boolean().nullable(),
@@ -311,18 +311,27 @@ var projectDtoSchema = z4.object({
   createdAt: z4.string().optional(),
   updatedAt: z4.string().optional()
 });
+var queryDtoSchema = z4.object({
+  id: z4.string(),
+  query: z4.string(),
+  createdAt: z4.string()
+});
 var keywordDtoSchema = z4.object({
   id: z4.string(),
   keyword: z4.string(),
   createdAt: z4.string()
 });
+var queryBatchRequestSchema = z4.object({
+  queries: z4.array(z4.string().trim().min(1)).min(1)
+});
 var keywordBatchRequestSchema = z4.object({
   keywords: z4.array(z4.string().trim().min(1)).min(1)
 });
-var keywordGenerateRequestSchema = z4.object({
+var queryGenerateRequestSchema = z4.object({
   provider: providerNameSchema,
   count: z4.number().int().min(1).max(20).optional()
 });
+var keywordGenerateRequestSchema = queryGenerateRequestSchema;
 var competitorDtoSchema = z4.object({
   id: z4.string(),
   domain: z4.string(),
@@ -444,13 +453,15 @@ var configGoogleSchema = z5.object({
     cron: z5.string().optional()
   }).optional()
 }).optional();
+var configQueryListSchema = z5.array(z5.string().min(1));
 var configSpecSchema = z5.object({
   displayName: z5.string().min(1),
   canonicalDomain: z5.string().min(1),
   ownedDomains: z5.array(z5.string().min(1)).optional().default([]),
   country: z5.string().length(2),
   language: z5.string().min(2),
-  keywords: z5.array(z5.string().min(1)).optional().default([]),
+  queries: configQueryListSchema.optional(),
+  keywords: configQueryListSchema.optional(),
   competitors: z5.array(z5.string().min(1)).optional().default([]),
   providers: z5.array(providerNameSchema).optional().default([]),
   locations: z5.array(locationContextSchema).optional().default([]),
@@ -460,6 +471,13 @@ var configSpecSchema = z5.object({
   google: configGoogleSchema,
   autoExtractBacklinks: z5.boolean().optional().default(false)
 }).superRefine((spec, ctx) => {
+  if (spec.queries !== void 0 && spec.keywords !== void 0) {
+    ctx.addIssue({
+      code: "custom",
+      message: "Use spec.queries; spec.keywords is accepted only as a legacy alias when spec.queries is omitted",
+      path: ["keywords"]
+    });
+  }
   const duplicateLabels = findDuplicateLocationLabels(spec.locations);
   if (duplicateLabels.length > 0) {
     ctx.addIssue({
@@ -482,6 +500,9 @@ var projectConfigSchema = z5.object({
   metadata: configMetadataSchema,
   spec: configSpecSchema
 });
+function resolveConfigSpecQueries(spec) {
+  return spec.queries ?? spec.keywords ?? [];
+}
 
 // ../contracts/src/errors.ts
 var AppError = class extends Error {
@@ -870,12 +891,25 @@ function isAgentProviderId(value) {
 // ../contracts/src/snapshot.ts
 import { z as z9 } from "zod";
 var snapshotAccuracySchema = z9.enum(["yes", "no", "unknown", "not-mentioned"]);
+var snapshotQueryListSchema = z9.array(z9.string().min(1));
 var snapshotRequestSchema = z9.object({
   companyName: z9.string().min(1),
   domain: z9.string().min(1),
-  phrases: z9.array(z9.string().min(1)).optional().default([]),
+  queries: snapshotQueryListSchema.optional(),
+  phrases: snapshotQueryListSchema.optional(),
   competitors: z9.array(z9.string().min(1)).optional().default([])
+}).superRefine((input, ctx) => {
+  if (input.queries !== void 0 && input.phrases !== void 0) {
+    ctx.addIssue({
+      code: "custom",
+      message: "Use queries; phrases is accepted only as a legacy alias when queries is omitted",
+      path: ["phrases"]
+    });
+  }
 });
+function resolveSnapshotRequestQueries(input) {
+  return input.queries ?? input.phrases ?? [];
+}
 var snapshotCompetitorEntrySchema = z9.object({
   name: z9.string(),
   count: z9.number().int().nonnegative()
@@ -925,7 +959,7 @@ var snapshotProviderResultSchema = z9.object({
   error: z9.string().nullable().optional()
 });
 var snapshotQueryResultSchema = z9.object({
-  phrase: z9.string(),
+  query: z9.string(),
   providerResults: z9.array(snapshotProviderResultSchema).default([])
 });
 var snapshotSummarySchema = z9.object({
@@ -944,7 +978,7 @@ var snapshotReportSchema = z9.object({
   domain: z9.string(),
   homepageUrl: z9.string(),
   generatedAt: z9.string(),
-  phrases: z9.array(z9.string()).default([]),
+  queries: z9.array(z9.string()).default([]),
   competitors: z9.array(z9.string()).default([]),
   profile: snapshotProfileSchema,
   audit: snapshotAuditSchema,
@@ -1264,18 +1298,20 @@ function extractAnswerMentions(answerText, displayName, domains) {
   if (matchesNormalized || matchesBrandKey) {
     matchedTerms.push(displayName);
   }
-  const tokens = collectDistinctiveTokens(displayName, domains);
+  const brandTokens = collectBrandTokens(displayName, domains);
+  const allTokens = [...brandTokens.primary, ...brandTokens.secondary];
+  const secondarySet = new Set(brandTokens.secondary);
   let tokenMatches = 0;
-  const matchedTokens = [];
-  for (const token of tokens) {
+  const matchedPrimary = [];
+  for (const token of allTokens) {
     if (new RegExp(`\\b${escapeRegExp(token)}\\b`).test(lowerAnswer)) {
       tokenMatches++;
-      matchedTokens.push(token);
+      if (!secondarySet.has(token)) matchedPrimary.push(token);
     }
   }
-  const tokenThresholdMet = tokens.length > 0 && (tokens.length === 1 && tokenMatches >= 1 || tokenMatches >= Math.min(2, tokens.length));
+  const tokenThresholdMet = allTokens.length > 0 && (allTokens.length === 1 && tokenMatches >= 1 || tokenMatches >= Math.min(2, allTokens.length));
   if (tokenThresholdMet) {
-    matchedTerms.push(...matchedTokens);
+    matchedTerms.push(...matchedPrimary);
   }
   const unique = [...new Set(matchedTerms)];
   const domainMatches = unique.filter((t) => t.includes("."));
@@ -1303,18 +1339,24 @@ function domainMentioned(lowerAnswer, normalizedDomain) {
   ];
   return patterns.some((pattern) => pattern.test(lowerAnswer));
 }
-function collectDistinctiveTokens(displayName, domains) {
-  const tokens = /* @__PURE__ */ new Set();
-  for (const token of extractDistinctiveTokens(displayName)) {
-    tokens.add(token);
+function collectBrandTokens(displayName, domains) {
+  const primary = /* @__PURE__ */ new Set();
+  const secondary = /* @__PURE__ */ new Set();
+  const distinctiveWords = extractDistinctiveTokens(displayName);
+  if (distinctiveWords.length > 0) {
+    primary.add(distinctiveWords[0]);
+    for (let i = 1; i < distinctiveWords.length; i++) {
+      secondary.add(distinctiveWords[i]);
+    }
   }
   for (const domain of domains) {
     const reg = registrableDomain(domain);
     const brand = reg ? brandLabelFromDomain(reg) : normalizeProjectDomain(domain).split("/")[0]?.split(".")[0] ?? "";
     const token = brand.replace(/[^a-z0-9]/gi, "").toLowerCase();
-    if (isDistinctiveToken(token)) tokens.add(token);
+    if (isDistinctiveToken(token)) primary.add(token);
   }
-  return [...tokens];
+  for (const t of primary) secondary.delete(t);
+  return { primary: [...primary], secondary: [...secondary] };
 }
 function extractDistinctiveTokens(value) {
   return normalizeText(value).split(" ").filter(isDistinctiveToken);
@@ -1455,11 +1497,11 @@ var projectSearchSnapshotHitSchema = z15.object({
   kind: z15.literal("snapshot"),
   id: z15.string(),
   runId: z15.string(),
-  keyword: z15.string(),
+  query: z15.string(),
   provider: z15.string(),
   model: z15.string().nullable(),
   citationState: citationStateSchema,
-  matchedField: z15.enum(["answerText", "citedDomains", "searchQueries", "keyword"]),
+  matchedField: z15.enum(["answerText", "citedDomains", "searchQueries", "query"]),
   snippet: z15.string(),
   createdAt: z15.string()
 });
@@ -1470,9 +1512,9 @@ var projectSearchInsightHitSchema = z15.object({
   type: z15.enum(["regression", "gain", "opportunity"]),
   severity: z15.enum(["critical", "high", "medium", "low"]),
   title: z15.string(),
-  keyword: z15.string(),
+  query: z15.string(),
   provider: z15.string(),
-  matchedField: z15.enum(["title", "keyword", "recommendation", "cause"]),
+  matchedField: z15.enum(["title", "query", "recommendation", "cause"]),
   snippet: z15.string(),
   dismissed: z15.boolean(),
   createdAt: z15.string()
@@ -1785,16 +1827,16 @@ var citationCoverageProviderSchema = z18.object({
   runCreatedAt: z18.string()
 });
 var citationCoverageRowSchema = z18.object({
-  keywordId: z18.string(),
-  keyword: z18.string(),
+  queryId: z18.string(),
+  query: z18.string(),
   providers: z18.array(citationCoverageProviderSchema),
   citedCount: z18.number().int().nonnegative(),
   mentionedCount: z18.number().int().nonnegative(),
   totalProviders: z18.number().int().nonnegative()
 });
 var competitorGapRowSchema = z18.object({
-  keywordId: z18.string(),
-  keyword: z18.string(),
+  queryId: z18.string(),
+  query: z18.string(),
   provider: z18.string(),
   citingCompetitors: z18.array(z18.string()),
   runId: z18.string(),
@@ -1804,23 +1846,23 @@ var citationVisibilitySummarySchema = z18.object({
   providersConfigured: z18.number().int().nonnegative(),
   providersCiting: z18.number().int().nonnegative(),
   providersMentioning: z18.number().int().nonnegative(),
-  totalKeywords: z18.number().int().nonnegative(),
-  // Cross-tab buckets — each tracked keyword with at least one snapshot lands
-  // in exactly one of these. Keywords with zero snapshots are not counted in
-  // any bucket; (sum of buckets) ≤ totalKeywords.
-  keywordsCitedAndMentioned: z18.number().int().nonnegative(),
-  keywordsCitedOnly: z18.number().int().nonnegative(),
-  keywordsMentionedOnly: z18.number().int().nonnegative(),
-  keywordsInvisible: z18.number().int().nonnegative(),
+  totalQueries: z18.number().int().nonnegative(),
+  // Cross-tab buckets — each tracked query with at least one snapshot lands
+  // in exactly one of these. Queries with zero snapshots are not counted in
+  // any bucket; (sum of buckets) ≤ totalQueries.
+  queriesCitedAndMentioned: z18.number().int().nonnegative(),
+  queriesCitedOnly: z18.number().int().nonnegative(),
+  queriesMentionedOnly: z18.number().int().nonnegative(),
+  queriesInvisible: z18.number().int().nonnegative(),
   latestRunId: z18.string().nullable(),
   latestRunAt: z18.string().nullable()
 });
 var citationVisibilityResponseSchema = z18.object({
   summary: citationVisibilitySummarySchema,
-  byKeyword: z18.array(citationCoverageRowSchema),
+  byQuery: z18.array(citationCoverageRowSchema),
   competitorGaps: z18.array(competitorGapRowSchema),
   status: z18.enum(["ready", "no-data"]),
-  reason: z18.enum(["no-runs-yet", "no-keywords"]).optional()
+  reason: z18.enum(["no-runs-yet", "no-queries"]).optional()
 });
 function emptyCitationVisibility(reason) {
   return {
@@ -1828,15 +1870,15 @@ function emptyCitationVisibility(reason) {
       providersConfigured: 0,
       providersCiting: 0,
       providersMentioning: 0,
-      totalKeywords: 0,
-      keywordsCitedAndMentioned: 0,
-      keywordsCitedOnly: 0,
-      keywordsMentionedOnly: 0,
-      keywordsInvisible: 0,
+      totalQueries: 0,
+      queriesCitedAndMentioned: 0,
+      queriesCitedOnly: 0,
+      queriesMentionedOnly: 0,
+      queriesInvisible: 0,
       latestRunId: null,
       latestRunAt: null
     },
-    byKeyword: [],
+    byQuery: [],
     competitorGaps: [],
     status: "no-data",
     reason
@@ -1865,7 +1907,9 @@ export {
   findDuplicateLocationLabels,
   hasLocationLabel,
   projectUpsertRequestSchema,
+  queryBatchRequestSchema,
   keywordBatchRequestSchema,
+  queryGenerateRequestSchema,
   keywordGenerateRequestSchema,
   competitorBatchRequestSchema,
   normalizeProjectDomain,
@@ -1873,6 +1917,7 @@ export {
   brandLabelFromDomain,
   effectiveDomains,
   projectConfigSchema,
+  resolveConfigSpecQueries,
   AppError,
   notFound,
   validationError,
@@ -1901,6 +1946,7 @@ export {
   serializeRunError,
   formatRunErrorOneLine,
   snapshotRequestSchema,
+  resolveSnapshotRequestQueries,
   scheduleUpsertRequestSchema,
   parseWindow,
   windowCutoff,