@siteoshq/cli 1.6.0 → 1.7.0

package/dist/cli.js

@@ -484,7 +484,8 @@ var siteOSServiceAudienceSchema = z.enum([
   "siteos-forms",
   "siteos-pulse",
   "siteos-search",
-  "siteos-seo"
+  "siteos-seo",
+  "siteos-analytics"
 ]);
 var siteOSServiceScopeSchema = z.string().min(1).max(160).regex(/^[a-z][a-z0-9-]*(?::[a-z][a-z0-9-]*){2,}$/);
 var scopeNamespaceByAudience = {
@@ -495,7 +496,8 @@ var scopeNamespaceByAudience = {
   "siteos-forms": "forms",
   "siteos-pulse": "pulse",
   "siteos-search": "search",
-  "siteos-seo": "seo"
+  "siteos-seo": "seo",
+  "siteos-analytics": "analytics"
 };
 function matchingServiceScopes(value, context) {
   const prefix = `${scopeNamespaceByAudience[value.audience]}:`;
@@ -1445,7 +1447,8 @@ var PROJECT_SERVICES = [
   "forms",
   "search",
   "trace",
-  "seo"
+  "seo",
+  "analytics"
 ];
 var ProjectSchema = z4.object({
   id: z4.string().min(1),
@@ -1499,7 +1502,7 @@ var OverviewSchema = z4.object({
 });
 function createProjectApi(input) {
   const origin = resolveSiteOSAuthBaseUrl(input.env);
-  async function request(path31, schema, body, method) {
+  async function request(path32, schema, body, method) {
     const scope = body === void 0 ? "projects:workspace:read" : "projects:workspace:write";
     const grant = await input.grants.acquire({
       audience: "siteos-projects",
@@ -1513,7 +1516,7 @@ function createProjectApi(input) {
         message: "SiteOS API access is unavailable."
       });
     const response = await input.fetchImpl(
-      `${origin}/api/projects/v1/projects${path31}`,
+      `${origin}/api/projects/v1/projects${path32}`,
       {
         method: method ?? (body === void 0 ? "GET" : "POST"),
         headers: {
@@ -1709,14 +1712,14 @@ async function commonServiceContext(options, service, environmentSlug) {
   const binding = attachment.environments.find(
     (item) => item.environmentId === context.environment.id
   );
-  if (["pulse", "cookie", "seo"].includes(service) && !binding)
+  if (["pulse", "cookie", "seo", "analytics"].includes(service) && !binding)
     throw new SiteOSAuthApiError({
       code: "PROJECT_ENVIRONMENT_NOT_CONFIGURED",
       message: `Set up ${service} in ${context.environment.name} with \`siteos project connect ${service}\`.`
     });
   return {
     ...context,
-    resourceId: ["pulse", "cookie", "seo"].includes(service) ? binding.resourceId : attachment.resourceId,
+    resourceId: ["pulse", "cookie", "seo", "analytics"].includes(service) ? binding.resourceId : attachment.resourceId,
     environmentBinding: binding
   };
 }
@@ -9229,13 +9232,13 @@ Usage:
   siteos project use <id-or-slug> [--json]
   siteos project update [--name <name>] [--slug <slug>] [--url <production-url>] [--json]
   siteos project status [--json]
-  siteos project connect <pulse|cookie|forms|search|trace|seo> [--resource <id>] [--json]
+  siteos project connect <pulse|cookie|forms|search|trace|seo|analytics> [--resource <id>] [--json]
   siteos project environment list [--json]
   siteos project environment create --name <name> --slug <slug> [--url <url>] [--json]
   siteos project environment use <slug> [--json]
   siteos project environment update <slug> [--name <name>] [--url <url>] [--json]
-  siteos project environment resources <pulse|cookie|forms|search|trace|seo> [--json]
-  siteos project environment connect <pulse|cookie|forms|search|trace|seo> --environment <slug> [--resource <id>] [--json]
+  siteos project environment resources <pulse|cookie|forms|search|trace|seo|analytics> [--json]
+  siteos project environment connect <pulse|cookie|forms|search|trace|seo|analytics> --environment <slug> [--resource <id>] [--json]
 
 Select a Project once per repository. Service commands use its configured resources.
 Connect creates a draft workspace, or explicitly attaches an existing resource.
@@ -9333,7 +9336,7 @@ Run \`siteos project status\` to inspect its services.`;
         const service = parsed.positionals[0];
         if (!PROJECT_SERVICES.includes(service))
           throw new Error(
-            "Choose pulse, cookie, forms, search, trace or seo. Organization connections use `siteos integrations`. "
+            "Choose pulse, cookie, forms, search, trace, seo or analytics. Organization connections use `siteos integrations`. "
           );
         overview = await api.connect(
           overview.project.id,
@@ -9389,7 +9392,9 @@ async function runEnvironmentCommand3(options) {
     throw new Error("Environment create requires --name and --slug.");
   const service = positionals[0];
   if ((action === "connect" || action === "resources") && !PROJECT_SERVICES.includes(service))
-    throw new Error("Choose pulse, cookie, forms, search, trace or seo.");
+    throw new Error(
+      "Choose pulse, cookie, forms, search, trace, seo or analytics."
+    );
   if (action === "connect" && !values.environment)
     throw new Error("Choose a Project environment with --environment <slug>.");
   const context = await readCommonProject(
@@ -9836,19 +9841,376 @@ async function runServiceCommand(service, options) {
   }
 }
 
+// src/services/analytics-command.ts
+import { readFile as readFile17, stat as stat2 } from "fs/promises";
+import path29 from "path";
+import { parseArgs as parseArgs4 } from "util";
+import { z as z16 } from "zod";
+var ANALYTICS_HELP = `Set up website Analytics in the selected Project environment.
+
+Usage:
+  siteos analytics status [--environment <slug>] [--json]
+  siteos analytics installation [--environment <slug>] [--json]
+  siteos analytics report [--days <1|7|28>] [--event <name>] [--country <ISO|unknown>] [--campaign <id>] [--environment <slug>] [--json]
+  siteos analytics realtime [--country <ISO|unknown>] [--campaign <id>] [--environment <slug>] [--json]
+  siteos analytics settings show [--environment <slug>] [--json]
+  siteos analytics settings set --revision <number> [--enabled <true|false>] [--cookie-events <true|false>] [--minimal-realtime <true|false>] [--environment <slug>] [--json]
+  siteos analytics events list [--environment <slug>] [--json]
+  siteos analytics events create --file <event.json> [--environment <slug>] [--json]
+  siteos analytics events snippet <name> [--environment <slug>] [--json]
+  siteos analytics campaigns list [--environment <slug>] [--json]
+  siteos analytics campaigns create --file <campaign.json> [--environment <slug>] [--json]
+  siteos analytics goals list [--environment <slug>] [--json]
+  siteos analytics goals create --file <goal.json> [--environment <slug>] [--json]
+  siteos analytics goals archive <id> [--environment <slug>] [--json]
+  siteos analytics funnels list [--environment <slug>] [--json]
+  siteos analytics funnels create --file <funnel.json> [--environment <slug>] [--json]
+  siteos analytics funnels archive <id> [--environment <slug>] [--json]
+  siteos analytics monitoring prepare [--environment <slug>] [--json]
+
+Connect first: siteos project connect analytics. Cookie and Trace are optional.
+Use project environment use <slug> to select an environment; no resource fallback is allowed.
+Analytics starts independently. Consent control is configured and published in Cookie.
+An external CMP can gate its loader explicitly; privacy opt-outs still apply.
+Settings require an owner/admin, the current revision and at least one change.
+Catalog files are bounded JSON using the documented event/campaign/goal/funnel contracts.
+Monitoring preparation creates a Trace draft only; publication remains a separate operation.
+Analytics is Unlimited during early access. No synthetic events are sent by these commands.`;
+var EventInput = z16.object({
+  name: z16.string().regex(/^[a-z][a-z0-9_]{0,63}$/u).refine((v) => v !== "pageview" && !v.startsWith("cookie_")),
+  label: z16.string().trim().min(1).max(80),
+  properties: z16.record(
+    z16.string().regex(/^[a-z][a-z0-9_]{0,39}$/u),
+    z16.array(
+      z16.string().min(1).max(80).regex(/^[a-zA-Z0-9 _./:-]+$/u)
+    ).min(1).max(20)
+  ).refine((v) => Object.keys(v).length <= 8)
+}).strict();
+var Resource = z16.object({
+  id: z16.string(),
+  organizationId: z16.string(),
+  name: z16.string(),
+  slug: z16.string(),
+  origin: z16.string().url(),
+  publicKey: z16.string(),
+  revision: z16.number().int().positive(),
+  enabled: z16.boolean(),
+  cookieEvents: z16.boolean(),
+  minimalRealtime: z16.boolean()
+});
+var readKeys = [
+  "days",
+  "from",
+  "to",
+  "totals",
+  "trend",
+  "pages",
+  "sources",
+  "countries",
+  "countryDetectionConfigured",
+  "countryFilter",
+  "campaignFilter",
+  "eventCounts",
+  "recent",
+  "lastReceivedAt",
+  "campaigns",
+  "goals",
+  "funnels",
+  "convertedVisits"
+];
+var liveKeys = [
+  "at",
+  "from",
+  "activeSince",
+  "collectionEnabled",
+  "countryFilter",
+  "campaignFilter",
+  "activeVisitors",
+  "visitors",
+  "pageviews",
+  "events",
+  "trend",
+  "pages",
+  "sources",
+  "countries",
+  "eventCounts",
+  "minimal"
+];
+var pick = (value, keys) => Object.fromEntries(
+  keys.filter((key) => Object.hasOwn(value, key)).map((key) => [key, value[key]])
+);
+async function runAnalyticsCommand(options) {
+  if (!options.args.length || options.args.some((v) => ["--help", "-h"].includes(v)))
+    return { exitCode: 0, stdout: ANALYTICS_HELP };
+  const json = options.args.includes("--json");
+  try {
+    const { positionals, values } = parseArgs4({
+      args: options.args,
+      strict: true,
+      allowPositionals: true,
+      options: {
+        json: { type: "boolean" },
+        environment: { type: "string" },
+        days: { type: "string" },
+        event: { type: "string" },
+        country: { type: "string" },
+        campaign: { type: "string" },
+        revision: { type: "string" },
+        enabled: { type: "string" },
+        "cookie-events": { type: "string" },
+        "minimal-realtime": { type: "string" },
+        file: { type: "string" }
+      }
+    });
+    const route = positionals.slice(0, 2).join(" "), action = positionals[0];
+    const operations = {
+      status: { args: 1, flags: [] },
+      installation: { args: 1, flags: [] },
+      report: { args: 1, flags: ["days", "event", "country", "campaign"] },
+      realtime: { args: 1, flags: ["country", "campaign"] },
+      "settings show": { args: 2, flags: [] },
+      "settings set": {
+        args: 2,
+        flags: ["revision", "enabled", "cookie-events", "minimal-realtime"],
+        scope: "analytics:workspace:write"
+      },
+      "events list": { args: 2, flags: [] },
+      "events snippet": { args: 3, flags: [] },
+      "events create": {
+        args: 2,
+        flags: ["file"],
+        scope: "analytics:events:write"
+      },
+      "campaigns list": { args: 2, flags: [] },
+      "campaigns create": {
+        args: 2,
+        flags: ["file"],
+        scope: "analytics:reports:write"
+      },
+      "goals list": { args: 2, flags: [] },
+      "goals create": {
+        args: 2,
+        flags: ["file"],
+        scope: "analytics:reports:write"
+      },
+      "goals archive": { args: 3, flags: [], scope: "analytics:reports:write" },
+      "funnels list": { args: 2, flags: [] },
+      "funnels create": {
+        args: 2,
+        flags: ["file"],
+        scope: "analytics:reports:write"
+      },
+      "funnels archive": {
+        args: 3,
+        flags: [],
+        scope: "analytics:reports:write"
+      },
+      "monitoring prepare": {
+        args: 2,
+        flags: [],
+        scope: "analytics:monitoring:write"
+      }
+    };
+    const operation = operations[route];
+    if (!operation || positionals.length !== operation.args || Object.keys(values).some(
+      (key) => !["json", "environment", ...operation.flags].includes(key)
+    ))
+      throw new Error(
+        "Invalid Analytics operation or flags. Run `siteos analytics --help`."
+      );
+    if (values.days && !["1", "7", "28"].includes(values.days))
+      throw new Error("Use --days 1, 7 or 28.");
+    if (values.country && !/^(?:[A-Z]{2}|unknown)$/u.test(values.country))
+      throw new Error("Use an uppercase ISO country code or unknown.");
+    if (values.campaign) z16.string().uuid().parse(values.campaign);
+    const setting = route === "settings set", creating = positionals[1] === "create", archive = positionals[1] === "archive";
+    let body;
+    if (setting) {
+      if (!/^[1-9]\d{0,8}$/u.test(values.revision ?? ""))
+        throw new Error(
+          "Read settings first and supply the current positive --revision."
+        );
+      body = { revision: Number(values.revision) };
+      for (const [flag, key] of [
+        ["enabled", "enabled"],
+        ["cookie-events", "cookieEvents"],
+        ["minimal-realtime", "minimalRealtime"]
+      ]) {
+        if (values[flag] === void 0) continue;
+        if (!["true", "false"].includes(values[flag]))
+          throw new Error(`Use --${flag} true|false.`);
+        body[key] = values[flag] === "true";
+      }
+      if (Object.keys(body).length < 2)
+        throw new Error("Provide at least one setting to change.");
+    } else if (creating) {
+      if (!values.file)
+        throw new Error("Creation requires --file with a JSON definition.");
+      const filename = path29.resolve(options.cwd ?? process.cwd(), values.file);
+      if ((await stat2(filename)).size > 16384)
+        throw new Error("The definition must not exceed 16 KiB.");
+      const text = await readFile17(filename, "utf8");
+      if (Buffer.byteLength(text) > 16384)
+        throw new Error("The definition must not exceed 16 KiB.");
+      let definition;
+      try {
+        definition = JSON.parse(text);
+      } catch {
+        throw new Error("The definition must contain valid JSON.");
+      }
+      body = z16.record(z16.unknown()).parse(definition);
+      if (action === "events") body = EventInput.parse(body);
+    } else if (archive) body = { id: z16.string().uuid().parse(positionals[2]) };
+    const context = await commonServiceContext(
+      options,
+      "analytics",
+      values.environment
+    );
+    if (!context)
+      throw new Error(
+        "Select a SiteOS Project with `siteos project use` first."
+      );
+    const runtime = commonProjectRuntime(options), scope = operation.scope ?? "analytics:workspace:read";
+    const grant = await runtime.grants.acquire({
+      audience: "siteos-analytics",
+      scopes: [scope]
+    });
+    if (grant.grant.audience !== "siteos-analytics" || grant.grant.scopes.length !== 1 || grant.grant.scopes[0] !== scope || grant.grant.organizationId !== context.overview.project.organizationId)
+      throw new SiteOSAuthApiError({
+        code: "AUTH_INVALID_RESPONSE",
+        message: "The Analytics grant does not match this Project and operation."
+      });
+    const query = new URLSearchParams();
+    for (const key of ["days", "event", "country", "campaign"])
+      if (values[key]) query.set(key, values[key]);
+    const suffix = action === "realtime" ? `/realtime?${query}` : setting ? "/settings" : creating || archive ? `/${action}` : route === "monitoring prepare" ? "/monitoring" : `?${query}`;
+    if (!options.fetchImpl)
+      throw new Error("SiteOS API access is unavailable.");
+    const response = await options.fetchImpl(
+      `${runtime.api.origin}/api/analytics/v1/resources/${encodeURIComponent(context.resourceId)}${suffix}`,
+      {
+        method: setting ? "PATCH" : archive ? "DELETE" : operation.scope ? "POST" : "GET",
+        headers: {
+          Accept: "application/json",
+          Authorization: `Bearer ${grant.accessToken}`,
+          ...body ? { "Content-Type": "application/json" } : {}
+        },
+        ...body ? { body: JSON.stringify(body) } : {},
+        signal: AbortSignal.timeout(3e4)
+      }
+    );
+    const value = await response.json();
+    if (!response.ok) {
+      const error = z16.object({
+        error: z16.object({ code: z16.string(), message: z16.string().max(500) })
+      }).safeParse(value);
+      throw new SiteOSAuthApiError({
+        code: error.success ? error.data.error.code : "ANALYTICS_REQUEST_FAILED",
+        message: error.success ? error.data.error.message : "The Analytics request failed.",
+        status: response.status
+      });
+    }
+    const record = z16.object({
+      contractVersion: z16.literal(1),
+      resourceId: z16.literal(context.resourceId)
+    }).passthrough().parse(value);
+    let output;
+    if (setting) {
+      const saved = Resource.parse(record);
+      if (saved.id !== context.resourceId || saved.organizationId !== context.overview.project.organizationId || saved.revision !== Number(values.revision) + 1 || Object.entries(body).some(
+        ([key, val]) => key !== "revision" && saved[key] !== val
+      ))
+        throw new Error("The saved settings do not match this change.");
+      output = saved;
+    } else if (creating) {
+      if (action === "events") {
+        output = EventInput.parse(
+          pick(record, ["name", "label", "properties"])
+        );
+        if (JSON.stringify(output) !== JSON.stringify(body))
+          throw new Error("The saved event does not match this definition.");
+      } else
+        output = {
+          id: z16.string().uuid().parse(record.id),
+          ...pick(
+            record,
+            action === "campaigns" ? ["label", "source", "medium", "campaign"] : action === "goals" ? ["label", "match"] : ["label", "steps"]
+          )
+        };
+    } else if (archive)
+      output = { archived: z16.literal(true).parse(record.archived) };
+    else if (route === "monitoring prepare")
+      output = { state: z16.literal("prepared").parse(record.state) };
+    else if (action === "realtime") output = pick(record, liveKeys);
+    else {
+      const resource = Resource.parse(record.resource);
+      if (resource.id !== context.resourceId || resource.organizationId !== context.overview.project.organizationId)
+        throw new Error(
+          "The Analytics response belongs to a different resource."
+        );
+      if (action === "status")
+        output = {
+          resource,
+          lastReceivedAt: record.lastReceivedAt,
+          consentSource: z16.object({
+            consentSource: z16.enum([
+              "cookie",
+              "external",
+              "waiting_for_cookie",
+              "not_required"
+            ])
+          }).parse(record.configuration).consentSource
+        };
+      else if (route === "settings show") output = resource;
+      else if (action === "installation")
+        output = {
+          resource,
+          installation: z16.string().parse(record.installation),
+          configuration: record.configuration
+        };
+      else if (action === "events") {
+        const definitions = z16.array(EventInput).parse(record.definitions);
+        if (route === "events snippet") {
+          const definition = definitions.find((d) => d.name === positionals[2]);
+          if (!definition)
+            throw new Error(
+              "Create the event definition before requesting its snippet."
+            );
+          output = {
+            name: definition.name,
+            javascript: `window.SiteOSAnalytics?.track(${JSON.stringify(definition.name)}, ${JSON.stringify(Object.fromEntries(Object.entries(definition.properties).map(([key, values2]) => [key, values2[0]])))});`,
+            guidance: "Trigger only after the business action succeeds; substitute declared categorical values."
+          };
+        } else output = { definitions, eventCounts: record.eventCounts };
+      } else
+        output = action === "report" ? pick(record, readKeys) : { [action]: z16.array(z16.unknown()).parse(record[action]) };
+    }
+    return { exitCode: 0, stdout: JSON.stringify(output, null, 2) };
+  } catch (cause) {
+    const error = cause instanceof SiteOSAuthApiError ? { code: cause.code, message: cause.message } : {
+      code: "ANALYTICS_COMMAND_FAILED",
+      message: cause instanceof z16.ZodError ? "The Analytics input or response does not match the supported contract." : cause instanceof Error ? cause.message : "The Analytics command failed."
+    };
+    return {
+      exitCode: cause instanceof SiteOSAuthApiError ? 1 : 2,
+      ...json ? { stdout: JSON.stringify({ error }) } : { stderr: error.message }
+    };
+  }
+}
+
 // src/services/seo-command.ts
 import { writeFile as writeFile9 } from "fs/promises";
-import path30 from "path";
-import { parseArgs as parseArgs5 } from "util";
-import { z as z17 } from "zod";
+import path31 from "path";
+import { parseArgs as parseArgs6 } from "util";
+import { z as z18 } from "zod";
 
 // src/services/seo-performance-command.ts
 import { randomUUID as randomUUID6 } from "crypto";
 import { writeFile as writeFile8 } from "fs/promises";
-import path29 from "path";
+import path30 from "path";
 import { setTimeout as setTimeout2 } from "timers/promises";
-import { parseArgs as parseArgs4 } from "util";
-import { z as z16 } from "zod";
+import { parseArgs as parseArgs5 } from "util";
+import { z as z17 } from "zod";
 var PERFORMANCE_HELP = `
   siteos seo performance run --audit <id> --url <url> [--url <url>...] [--device <mobile|desktop>] [--idempotency-key <key>] [--environment <slug>] [--json]
   siteos seo performance list [--device <mobile|desktop>] [--environment <slug>] [--json]
@@ -9865,7 +10227,7 @@ Reuse the returned idempotency key after an uncertain run response. Wait default
 async function runSeoPerformanceCommand(options) {
   let idempotencyKey;
   try {
-    const { values, positionals } = parseArgs4({
+    const { values, positionals } = parseArgs5({
       args: options.args.slice(1),
       strict: true,
       allowPositionals: true,
@@ -9936,12 +10298,12 @@ async function runSeoPerformanceCommand(options) {
     const runtime = commonProjectRuntime(options);
     const writing = ["run", "cancel"].includes(action);
     const scope = writing ? "seo:audits:write" : "seo:workspace:read";
-    const batchSchema = z16.object({
-      id: z16.string(),
-      resourceId: z16.literal(context.resourceId),
-      organizationId: z16.literal(context.overview.project.organizationId),
-      sourceAuditId: z16.string(),
-      state: z16.enum([
+    const batchSchema = z17.object({
+      id: z17.string(),
+      resourceId: z17.literal(context.resourceId),
+      organizationId: z17.literal(context.overview.project.organizationId),
+      sourceAuditId: z17.string(),
+      state: z17.enum([
         "queued",
         "running",
         "completed",
@@ -9949,8 +10311,8 @@ async function runSeoPerformanceCommand(options) {
         "failed",
         "cancelled"
       ]),
-      device: z16.enum(["mobile", "desktop"]),
-      urls: z16.array(z16.string()).min(1).max(10)
+      device: z17.enum(["mobile", "desktop"]),
+      urls: z17.array(z17.string()).min(1).max(10)
     }).passthrough();
     const query = new URLSearchParams();
     if (values.device) query.set("device", values.device);
@@ -9998,17 +10360,17 @@ async function runSeoPerformanceCommand(options) {
           );
         const text = await response.text();
         if (values.format === "json") {
-          const parsed = z16.object({
-            contractVersion: z16.literal(1),
+          const parsed = z17.object({
+            contractVersion: z17.literal(1),
             batch: batchSchema,
-            pages: z16.array(z16.unknown())
+            pages: z17.array(z17.unknown())
           }).parse(JSON.parse(text));
           if (parsed.batch.id !== id)
             throw new Error(
               "The export response does not match the selected check."
             );
         }
-        const output = path29.resolve(
+        const output = path30.resolve(
           options.cwd ?? process.cwd(),
           values.output
         );
@@ -10024,8 +10386,8 @@ async function runSeoPerformanceCommand(options) {
       }
       const data = await response.json();
       if (!response.ok) {
-        const error = z16.object({
-          error: z16.object({ code: z16.string(), message: z16.string().max(500) })
+        const error = z17.object({
+          error: z17.object({ code: z17.string(), message: z17.string().max(500) })
         }).safeParse(data);
         throw new SiteOSAuthApiError({
           code: error.success ? error.data.error.code : "SEO_REQUEST_FAILED",
@@ -10033,8 +10395,8 @@ async function runSeoPerformanceCommand(options) {
           status: response.status
         });
       }
-      const record = z16.object({ contractVersion: z16.literal(1) }).passthrough().parse(data);
-      if (action === "cancel") z16.literal(true).parse(record.cancelled);
+      const record = z17.object({ contractVersion: z17.literal(1) }).passthrough().parse(data);
+      if (action === "cancel") z17.literal(true).parse(record.cancelled);
       else if (action === "run") {
         const accepted = batchSchema.parse(record.batch);
         const normalize = (url) => {
@@ -10047,8 +10409,8 @@ async function runSeoPerformanceCommand(options) {
             "The queued check does not match the requested source, device and URLs."
           );
       } else {
-        z16.literal(context.resourceId).parse(record.resourceId);
-        z16.array(batchSchema).parse(record.batches);
+        z17.literal(context.resourceId).parse(record.resourceId);
+        z17.array(batchSchema).parse(record.batches);
         const selected = batchSchema.nullable().parse(record.batch);
         if (id && selected?.id !== id)
           throw new Error(
@@ -10075,7 +10437,7 @@ async function runSeoPerformanceCommand(options) {
   } catch (cause) {
     const error = {
       code: cause instanceof SiteOSAuthApiError ? cause.code : "SEO_COMMAND_FAILED",
-      message: cause instanceof z16.ZodError ? "The SEO service returned an invalid response." : cause instanceof Error ? cause.message : "The performance command failed."
+      message: cause instanceof z17.ZodError ? "The SEO service returned an invalid response." : cause instanceof Error ? cause.message : "The performance command failed."
     };
     return {
       exitCode: cause instanceof SiteOSAuthApiError ? 1 : 2,
@@ -10128,7 +10490,7 @@ async function runSeoCommand(options) {
     return runSeoPerformanceCommand(options);
   const json = options.args.includes("--json");
   try {
-    const { positionals, values } = parseArgs5({
+    const { positionals, values } = parseArgs6({
       args: options.args,
       strict: true,
       allowPositionals: true,
@@ -10341,17 +10703,17 @@ async function runSeoCommand(options) {
         );
       const text = await response.text();
       if (values.format === "json")
-        z17.object({
-          contractVersion: z17.literal(1),
-          audit: z17.object({
-            id: z17.literal(values.audit),
-            resourceId: z17.literal(context.resourceId)
+        z18.object({
+          contractVersion: z18.literal(1),
+          audit: z18.object({
+            id: z18.literal(values.audit),
+            resourceId: z18.literal(context.resourceId)
           }),
-          kind: z17.literal(values.kind),
-          totalRows: z17.literal(rows),
-          rows: z17.array(z17.unknown()).length(rows)
+          kind: z18.literal(values.kind),
+          totalRows: z18.literal(rows),
+          rows: z18.array(z18.unknown()).length(rows)
         }).parse(JSON.parse(text));
-      const output = path30.resolve(options.cwd ?? process.cwd(), values.output);
+      const output = path31.resolve(options.cwd ?? process.cwd(), values.output);
       await writeFile9(output, text, { flag: "wx", mode: 384 });
       return {
         exitCode: 0,
@@ -10370,8 +10732,8 @@ async function runSeoCommand(options) {
     }
     const data = await response.json();
     if (!response.ok) {
-      const result = z17.object({
-        error: z17.object({ code: z17.string(), message: z17.string().max(500) })
+      const result = z18.object({
+        error: z18.object({ code: z18.string(), message: z18.string().max(500) })
       }).safeParse(data);
       throw new SiteOSAuthApiError({
         code: result.success ? result.data.error.code : "SEO_REQUEST_FAILED",
@@ -10379,34 +10741,34 @@ async function runSeoCommand(options) {
         status: response.status
       });
     }
-    const record = z17.object({ contractVersion: z17.literal(1) }).passthrough().parse(data);
+    const record = z18.object({ contractVersion: z18.literal(1) }).passthrough().parse(data);
     if (automation) {
-      z17.literal(context.resourceId).parse(record.resourceId);
-      const schedule = z17.object({
-        enabled: z17.boolean(),
-        weekday: z17.number().int().min(1).max(7),
-        time: z17.string(),
-        timeZone: z17.string(),
-        revision: z17.number().int().min(0),
-        nextRunAt: z17.string().nullable()
+      z18.literal(context.resourceId).parse(record.resourceId);
+      const schedule = z18.object({
+        enabled: z18.boolean(),
+        weekday: z18.number().int().min(1).max(7),
+        time: z18.string(),
+        timeZone: z18.string(),
+        revision: z18.number().int().min(0),
+        nextRunAt: z18.string().nullable()
       });
-      const notificationRoute = z17.object({
-        enabled: z17.boolean(),
-        minimumSeverity: z17.enum(["error", "warning"]),
-        includeFailures: z17.boolean(),
-        revision: z17.number().int().min(0),
-        destinationId: z17.string().nullable()
+      const notificationRoute = z18.object({
+        enabled: z18.boolean(),
+        minimumSeverity: z18.enum(["error", "warning"]),
+        includeFailures: z18.boolean(),
+        revision: z18.number().int().min(0),
+        destinationId: z18.string().nullable()
       });
       if (retryNotification) {
-        z17.literal(true).parse(record.retryQueued);
-        z17.literal(positionals[2]).parse(record.notificationId);
+        z18.literal(true).parse(record.retryQueued);
+        z18.literal(positionals[2]).parse(record.notificationId);
       } else if (route === "notifications destinations")
-        z17.object({
-          candidates: z17.array(
-            z17.object({
-              candidateId: z17.string(),
-              label: z17.string(),
-              availability: z17.literal("available")
+        z18.object({
+          candidates: z18.array(
+            z18.object({
+              candidateId: z18.string(),
+              label: z18.string(),
+              availability: z18.literal("available")
             })
           )
         }).parse(record);
@@ -10419,46 +10781,46 @@ async function runSeoCommand(options) {
         notificationRoute.parse(record.route);
       }
     } else if (!writing) {
-      const validated = z17.object({
-        resource: z17.object({
-          id: z17.literal(context.resourceId),
-          organizationId: z17.literal(context.overview.project.organizationId)
+      const validated = z18.object({
+        resource: z18.object({
+          id: z18.literal(context.resourceId),
+          organizationId: z18.literal(context.overview.project.organizationId)
         }),
-        audits: z17.array(z17.object({ id: z17.string() }).passthrough()),
-        audit: z17.object({
-          id: z17.string(),
-          resourceId: z17.literal(context.resourceId)
+        audits: z18.array(z18.object({ id: z18.string() }).passthrough()),
+        audit: z18.object({
+          id: z18.string(),
+          resourceId: z18.literal(context.resourceId)
         }).passthrough().nullable(),
-        pages: z17.array(z17.unknown()),
-        issues: z17.array(z17.unknown()),
-        changes: z17.array(z17.unknown()),
-        totalChanges: z17.number(),
-        dispositions: z17.array(z17.unknown())
+        pages: z18.array(z18.unknown()),
+        issues: z18.array(z18.unknown()),
+        changes: z18.array(z18.unknown()),
+        totalChanges: z18.number(),
+        dispositions: z18.array(z18.unknown())
       }).passthrough().parse(record);
       const selected = query.get("audit");
       if (selected && validated.audit?.id !== selected)
         throw new Error("The SEO response does not match the requested audit.");
     } else if (record.audit)
-      z17.object({
-        id: z17.string(),
-        resourceId: z17.literal(context.resourceId),
-        organizationId: z17.literal(context.overview.project.organizationId),
-        state: z17.literal("queued")
+      z18.object({
+        id: z18.string(),
+        resourceId: z18.literal(context.resourceId),
+        organizationId: z18.literal(context.overview.project.organizationId),
+        state: z18.literal("queued")
       }).parse(record.audit);
-    else if (route === "audit cancel") z17.literal(true).parse(record.cancelled);
+    else if (route === "audit cancel") z18.literal(true).parse(record.cancelled);
     else if (action === "issue")
-      z17.object({
-        url: z17.literal(values.url),
-        ruleId: z17.literal(values.rule),
-        ignored: z17.literal(positionals[1] === "ignore"),
-        revision: z17.literal(Number(values.revision) + 1)
+      z18.object({
+        url: z18.literal(values.url),
+        ruleId: z18.literal(values.rule),
+        ignored: z18.literal(positionals[1] === "ignore"),
+        revision: z18.literal(Number(values.revision) + 1)
       }).parse(record.disposition);
     else throw new Error("The SEO service returned an invalid response.");
     return { exitCode: 0, stdout: JSON.stringify(record, null, 2) };
   } catch (cause) {
     const error = {
       code: cause instanceof SiteOSAuthApiError ? cause.code : "SEO_COMMAND_FAILED",
-      message: cause instanceof z17.ZodError ? "The SEO service returned an invalid response." : cause instanceof Error ? cause.message : "The SEO command failed."
+      message: cause instanceof z18.ZodError ? "The SEO service returned an invalid response." : cause instanceof Error ? cause.message : "The SEO command failed."
     };
     return {
       exitCode: cause instanceof SiteOSAuthApiError ? 1 : 2,
@@ -10500,6 +10862,12 @@ if (!command || command === "--help" || command === "-h") {
 }
 function rootCommandRegistry() {
   return createCommandRegistry({
+    analytics: (args2) => runAnalyticsCommand({
+      args: args2,
+      cwd: process.cwd(),
+      env: process.env,
+      fetchImpl: globalThis.fetch
+    }),
     seo: (args2) => runSeoCommand({
       args: args2,
       cwd: process.cwd(),
@@ -10613,6 +10981,7 @@ Usage:
   siteos project --help
   siteos cookie --help
   siteos trace --help
+  siteos analytics --help
   siteos seo --help
   siteos integrations --help
   siteos pulse --help
@@ -10625,6 +10994,7 @@ Commands:
   project       Select one Project and configure its services and environments.
   cookie        Configure, publish, and inspect the Project\u2019s cookie banner.
   trace         Configure analytics observation and inspect evidence.
+  analytics     Configure website Analytics, events and realtime reports.
   seo           Audit HTML, inspect changes and verify fixes.
   integrations  Manage Organization connections and destinations.
   pulse         Manage monitoring checks, tests, and deployments.