@canonry/canonry 4.177.3 → 4.178.1

package/dist/{chunk-PQT3ECM3.js → chunk-OYDIND7Q.js}

@@ -53,6 +53,9 @@ function quotaExceeded(metric, details) {
 function providerError(message, details) {
   return new AppError("PROVIDER_ERROR", message, 502, details);
 }
+function providerAuthError(message, details) {
+  return new AppError("PROVIDER_AUTH", message, 502, details);
+}
 function noProvider(projectName, details) {
   return new AppError(
     "NO_PROVIDER",
@@ -8305,6 +8308,84 @@ var googleAdsRawSnapshotDtoSchema = z20.object({
     context.addIssue({ code: z20.ZodIssueCode.custom, path: ["payload", "kind"], message: "Snapshot metadata and payload kinds must match." });
   }
 });
+var googleAdsMetricsWindowSchema = z20.enum(["7d", "14d", "30d"]);
+var googleAdsMetricTotalsSchema = z20.object({
+  impressions: z20.number().int().nonnegative(),
+  clicks: z20.number().int().nonnegative(),
+  costMicros: z20.number().int().nonnegative(),
+  /** FLOAT: Google reports fractional conversions, so 0.5 is a real value. */
+  conversions: z20.number().nonnegative(),
+  /** Null when no row in scope reported a value. */
+  conversionValueMicros: z20.number().int().nonnegative().nullable(),
+  /** clicks / impressions. Null when impressions === 0. */
+  ctr: z20.number().nullable(),
+  /** Math.round(costMicros / clicks). Null when clicks === 0. */
+  cpcMicros: z20.number().int().nonnegative().nullable(),
+  /** conversions / clicks. Null when clicks === 0. */
+  conversionRate: z20.number().nullable(),
+  /** Math.round(costMicros / conversions). Null when conversions === 0. */
+  costPerConversionMicros: z20.number().int().nonnegative().nullable()
+});
+var googleAdsMetricsDailyPointSchema = z20.object({
+  date: calendarDateSchema,
+  origin: z20.enum(["provider", "filled"]),
+  impressions: z20.number().int().nonnegative(),
+  clicks: z20.number().int().nonnegative(),
+  costMicros: z20.number().int().nonnegative(),
+  conversions: z20.number().nonnegative(),
+  ctr: z20.number().nullable()
+});
+var googleAdsCampaignPerformanceSchema = z20.object({
+  campaignId: opaqueIdSchema,
+  /** Null when the metrics snapshot names a campaign the inventory snapshot does not. */
+  name: z20.string().nullable(),
+  status: googleAdsCampaignStatusSchema,
+  totals: googleAdsMetricTotalsSchema
+});
+var googleAdsPerformanceSourceSchema = z20.object({
+  snapshotId: opaqueIdSchema,
+  capturedAt: z20.string(),
+  customerId: opaqueIdSchema,
+  currencyCode: z20.string().nullable(),
+  timeZone: z20.string().nullable(),
+  /** Newest CLOSED day. Every window ends here. */
+  asOfDate: calendarDateSchema,
+  openDate: calendarDateSchema.nullable(),
+  /** True when the provider row cap was hit, so totals are a subset sum. */
+  truncated: z20.boolean(),
+  campaignsQueried: z20.number().int().nonnegative(),
+  campaignsInInventory: z20.number().int().nonnegative()
+});
+var googleAdsPerformancePeriodSchema = z20.object({
+  startDate: calendarDateSchema,
+  endDate: calendarDateSchema,
+  days: z20.number().int().positive(),
+  totals: googleAdsMetricTotalsSchema
+});
+var googleAdsPerformanceComparisonSchema = z20.object({
+  days: z20.number().int().positive(),
+  prior: googleAdsPerformancePeriodSchema,
+  change: z20.object({
+    impressions: z20.number().nullable(),
+    clicks: z20.number().nullable(),
+    costMicros: z20.number().nullable(),
+    conversions: z20.number().nullable(),
+    ctr: z20.number().nullable(),
+    conversionRate: z20.number().nullable()
+  })
+});
+var googleAdsPerformanceDtoSchema = z20.object({
+  window: googleAdsMetricsWindowSchema,
+  startDate: calendarDateSchema,
+  endDate: calendarDateSchema,
+  days: z20.number().int().positive(),
+  totals: googleAdsMetricTotalsSchema,
+  daily: z20.array(googleAdsMetricsDailyPointSchema),
+  campaigns: z20.array(googleAdsCampaignPerformanceSchema),
+  comparison: googleAdsPerformanceComparisonSchema.nullable(),
+  comparisonUnavailableReason: z20.enum(["insufficient-history", "no-snapshot"]).nullable(),
+  source: googleAdsPerformanceSourceSchema.nullable()
+});
 
 // ../contracts/src/google-tag-manager.ts
 import { z as z21 } from "zod";
@@ -8774,6 +8855,32 @@ var conversionTrackingIntegrityAssessmentDtoSchema = z22.object({
   findings: z22.array(conversionTrackingIntegrityFindingDtoSchema),
   evaluatedAt: z22.string()
 }).strict();
+var conversionTrackingOptionSchema = z22.object({
+  id: opaqueIdSchema3,
+  /** Human label the operator recognises, e.g. "Booking completed". */
+  name: z22.string(),
+  /** Secondary line: the Ads category, or the GTM tag type. */
+  detail: z22.string(),
+  /**
+   * False when the option exists but is not a sensible target: a removed Ads
+   * action, or a paused GTM tag. Offered but flagged, never silently hidden,
+   * because a contract may legitimately point at one.
+   */
+  active: z22.boolean()
+});
+var conversionTrackingOptionsDtoSchema = z22.object({
+  googleAds: z22.object({
+    /** Null when Google Ads is not connected or no customer is selected. */
+    customerId: opaqueIdSchema3.nullable(),
+    syncedAt: z22.string().nullable(),
+    conversionActions: z22.array(conversionTrackingOptionSchema)
+  }),
+  gtm: z22.object({
+    containerId: opaqueIdSchema3.nullable(),
+    syncedAt: z22.string().nullable(),
+    tags: z22.array(conversionTrackingOptionSchema)
+  })
+});
 
 // ../contracts/src/google-marketing.ts
 import { z as z23 } from "zod";
@@ -16053,6 +16160,44 @@ function serializeForInlineScript(value) {
   return JSON.stringify(value).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
 }
 
+// ../contracts/src/provider-errors.ts
+var PROVIDER_ERROR_PRIORITY = [
+  "PROVIDER_AUTH",
+  "RATE_LIMITED",
+  "TIMEOUT",
+  "NETWORK",
+  "PARSE_ERROR",
+  "UNKNOWN"
+];
+function classifyProviderErrorMessage(message) {
+  if (/\b401\b|\b403\b|unauthorized|forbidden|invalid[_ -]?api[_ -]?key|missing[_ -]?api[_ -]?key|authentication/i.test(message)) {
+    return "PROVIDER_AUTH";
+  }
+  if (/\b429\b|rate[_ -]?limit|too many requests|quota[_ -]?exceeded/i.test(message)) {
+    return "RATE_LIMITED";
+  }
+  if (/timeout|timed out|ETIMEDOUT/i.test(message)) {
+    return "TIMEOUT";
+  }
+  if (/ECONNRESET|ECONNREFUSED|ENOTFOUND|EAI_AGAIN|network|fetch failed|socket hang up/i.test(message)) {
+    return "NETWORK";
+  }
+  if (/parse|unexpected token|invalid json|malformed|JSON\.parse/i.test(message)) {
+    return "PARSE_ERROR";
+  }
+  return "UNKNOWN";
+}
+function classifyProviderErrorMessages(messages) {
+  const codes = /* @__PURE__ */ new Set();
+  for (const message of messages) {
+    codes.add(classifyProviderErrorMessage(message));
+  }
+  for (const code of PROVIDER_ERROR_PRIORITY) {
+    if (codes.has(code)) return code;
+  }
+  return "UNKNOWN";
+}
+
 // ../contracts/src/telemetry.ts
 import { z as z54 } from "zod";
 var ONBOARDING_FLOW_VERSION = 1;
@@ -16091,12 +16236,24 @@ var onboardingBlockReasonSchema = z54.enum([
   "run_rejected",
   "run_failed",
   "run_cancelled",
+  // Provider-side failures the query-generation step actually hits. Without
+  // these every one of them reported `unknown`, which is why the queries step
+  // was the only blocker nobody could diagnose.
+  "rate_limited",
+  "provider_auth",
+  "network",
   "unknown"
 ]);
+var onboardingSurfaceSchema = z54.enum([
+  "wizard",
+  "platform",
+  "site_health"
+]);
 var onboardingEventBaseSchema = z54.object({
   eventId: z54.string().uuid(),
   flowVersion: z54.literal(ONBOARDING_FLOW_VERSION),
-  onboardingSessionId: z54.string().uuid()
+  onboardingSessionId: z54.string().uuid(),
+  surface: onboardingSurfaceSchema.optional()
 });
 var onboardingTelemetryEventSchema = z54.discriminatedUnion("event", [
   onboardingEventBaseSchema.extend({
@@ -16120,11 +16277,24 @@ var onboardingTelemetryEventSchema = z54.discriminatedUnion("event", [
     event: z54.literal("run.requested"),
     origin: z54.literal("dashboard_setup"),
     result: z54.enum(["queued", "rejected"]),
+    /**
+     * What kind of run was asked for. A site-health crawl has no providers and
+     * no tracked queries, so its buckets are legitimately `0`; without this
+     * field that is indistinguishable from a misconfigured visibility sweep.
+     * Optional on the wire and defaulted at collection for the same reason as
+     * `surface`: a documented fallback that nothing applies becomes a null
+     * bucket downstream.
+     */
+    kind: z54.enum(["answer_visibility", "site_health"]).optional(),
     providerCountBucket: onboardingCountBucketSchema,
     queryCountBucket: onboardingCountBucketSchema,
     reasonCode: onboardingBlockReasonSchema.optional()
   }).strict()
 ]);
+function normalizeOnboardingEventForCollection(event) {
+  const surfaced = { ...event, surface: event.surface ?? "wizard" };
+  return surfaced.event === "run.requested" ? { ...surfaced, kind: surfaced.kind ?? "answer_visibility" } : surfaced;
+}
 var telemetryEventAcceptedDtoSchema = z54.object({
   accepted: z54.boolean()
 });
@@ -16169,6 +16339,7 @@ export {
   forbidden,
   quotaExceeded,
   providerError,
+  providerAuthError,
   noProvider,
   noQueries,
   runInProgress,
@@ -16414,6 +16585,8 @@ export {
   googleAdsCampaignMetricsQuerySchema,
   GoogleAdsSnapshotKinds,
   googleAdsRawSnapshotDtoSchema,
+  googleAdsMetricsWindowSchema,
+  googleAdsPerformanceDtoSchema,
   GtmConnectionStates,
   gtmAccountsResponseSchema,
   gtmContainerListResponseSchema,
@@ -16434,6 +16607,7 @@ export {
   ConversionTrackingRuntimeObservations,
   deriveConversionTrackingIntegrityStatus,
   conversionTrackingIntegrityAssessmentDtoSchema,
+  conversionTrackingOptionsDtoSchema,
   canonicalizeGtmAccountId,
   canonicalizeGtmContainerId,
   canonicalizeGoogleAdsCustomerSelection,
@@ -16849,9 +17023,12 @@ export {
   normalizeIdTokens,
   embedClientConfigForRequest,
   serializeForInlineScript,
+  classifyProviderErrorMessage,
+  classifyProviderErrorMessages,
   ONBOARDING_FLOW_VERSION,
   bucketOnboardingCount,
   onboardingTelemetryEventSchema,
+  normalizeOnboardingEventForCollection,
   telemetryEventAcceptedDtoSchema,
   isGhostTelemetryEvent,
   MIN_TREND_POINTS,