@particle-academy/google-analytics-js 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+All notable changes to `@particle-academy/google-analytics-ui`,
+`@particle-academy/google-analytics-js`,
+`particle-academy/google-analytics-php` and `fancy-google-analytics`.
+
+The four packages share one version, because they are generated from one
+`provider/` definition and a version that meant something different in each
+would be a version nobody could reason about.
+
+## [0.1.0] — 2026-08-23
+
+First release.
+
+### Added
+
+- `report_run` — run a report against a GA4 property.
+  `POST /v1beta/{+property}:runReport`.
+- A faker for it, so a flow can be built with no Google account.
+
+### `{+property}` — the plus is the whole point
+
+RFC 6570 **reserved expansion**. The value is `properties/1234567890` and the
+**slash must survive**: percent-encoded it becomes `properties%2F1234567890` and
+Google answers 404.
+
+That is the exact opposite of Google Sheets, where a sheet named `Q1/Q2` *must*
+have its slash escaped or the request reaches a different document. The two
+templates are **one character apart** and both fail silently when confused — so
+each runtime now picks its encoder from the `+`: `encodeURI` rather than
+`encodeURIComponent`, `quote(safe="/")` rather than `quote(safe="")`, and in PHP
+the slash is put back after `rawurlencode`, since PHP has no reserved-expansion
+encoder at all.
+
+### `metrics` is a list of NAMED OBJECTS
+
+Google asks for `[{"name": "activeUsers"}]`, not `["activeUsers"]`; a bare list
+of strings is refused as the wrong type. That is `encoding: "objects"` with an
+`itemKey`, declared rather than guessed — a guess that fits one provider is
+still a guess.
+
+### The only read-only action in the estate
+
+`sideEffects: "none"`. Running the same report twice returns the same numbers
+and changes nothing, so a durable run may replay it freely and there is no
+idempotency question at all.
+
+The scope is `analytics.readonly`, not `analytics`. The discovery document lists
+both for this method, and granting write access to run a report would let an
+automation modify property configuration it never needs to touch.
+
+### Metric values are STRINGS
+
+Google sends `"412"`, not `412` — including for integer metrics. The faker says
+so, because a fixture that emitted numbers would let an author write arithmetic
+that works against the fake and concatenates against the real thing.
+
+[0.1.0]: https://github.com/Fancy-Friends/google-analytics/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Particle Academy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# Google Analytics
+
+Google Analytics for [fancy-flow][flow] — as **four imported, versioned packages**, one
+per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
+change.
+
+[flow]: https://github.com/Particle-Academy/fancy-flow
+
+| Runtime | Package | Install |
+|---|---|---|
+| Authoring surface (every host) | `@particle-academy/google-analytics-ui` | `npm install @particle-academy/google-analytics-ui` |
+| Node | `@particle-academy/google-analytics-js` | `npm install @particle-academy/google-analytics-js` |
+| PHP 8.4+ | `particle-academy/google-analytics-php` | `composer require particle-academy/google-analytics-php` |
+| Python 3.11+ | `fancy-google-analytics` | `pip install fancy-google-analytics` |
+
+The `ui` package is the editor surface and is React on every host — a PHP or
+Python project installs it *and* its own runtime package, and never the `js` one.
+
+## What it costs you
+
+One dependency: `@particle-academy/fancy-connector-core` (or
+`particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
+packages pull in themselves. The Python package has **zero** runtime
+dependencies.
+
+**No Google Analytics SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
+subject to the kit's full approval bar, and one per provider is hundreds of
+dependencies nobody is tracking.
+
+## Run it before you have credentials
+
+Every operation ships a **faker**, whether or not Google Analytics has a sandbox. Set a
+node's mode to `fake` and it returns the shape Google Analytics actually publishes — the
+same field names, deterministically — so you can wire the downstream nodes before
+touching an account, a key, or a network.
+
+## This repository is generated
+
+`provider/` is the source. Everything under `packages/` is emitted from it and
+**must not be hand-edited** — CI regenerates and diffs on every push, and the
+next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
+
+## Two namespaces, which do not match on purpose
+
+The repo is `github.com/Fancy-Friends/google-analytics`; the packages publish under
+`particle-academy`. Nothing derives one from the other — the names come from
+weaver's `friends.json` and nowhere else.
+
+## Licence
+
+MIT.

package/dist/chunk-NY2RRZPH.js

@@ -0,0 +1,153 @@
+import { callConnector } from '@particle-academy/fancy-connector-core';
+
+// src/faker.ts
+function fakeReportRun({ config, fake }) {
+  return {
+    "dimensionHeaders": [
+      {
+        "name": "date"
+      }
+    ],
+    "metricHeaders": [
+      {
+        "name": "activeUsers",
+        "type": "TYPE_INTEGER"
+      },
+      {
+        "name": "sessions",
+        "type": "TYPE_INTEGER"
+      }
+    ],
+    "rows": [
+      {
+        "dimensionValues": [
+          {
+            "value": "20260821"
+          }
+        ],
+        "metricValues": [
+          {
+            "value": "412"
+          },
+          {
+            "value": "530"
+          }
+        ]
+      },
+      {
+        "dimensionValues": [
+          {
+            "value": "20260822"
+          }
+        ],
+        "metricValues": [
+          {
+            "value": "389"
+          },
+          {
+            "value": "501"
+          }
+        ]
+      }
+    ],
+    "rowCount": 2,
+    "kind": "analyticsData#runReport"
+  };
+}
+var googleAnalyticsFaker = (operation, request) => {
+  switch (operation) {
+    case "report_run":
+      return fakeReportRun(request);
+    default:
+      throw new Error(
+        `google_analytics: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var GOOGLE_ANALYTICS_BASE_URLS = {
+  "live": "https://analyticsdata.googleapis.com"
+};
+var GOOGLE_ANALYTICS_REQUIRES = [
+  "accessToken",
+  "refreshToken",
+  "clientId",
+  "clientSecret"
+];
+function googleAnalyticsAuthorize(credentials, request, _mode) {
+  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
+}
+var GOOGLE_ANALYTICS = {
+  service: "google_analytics",
+  title: "Google Analytics",
+  sandbox: "none",
+  baseUrls: { ...GOOGLE_ANALYTICS_BASE_URLS },
+  requires: [...GOOGLE_ANALYTICS_REQUIRES],
+  authorize: googleAnalyticsAuthorize,
+  faker: googleAnalyticsFaker
+};
+var REPORT_RUN_OPERATION = "report_run";
+async function googleAnalyticsReportRun(options) {
+  const config = options.config ?? {};
+  if (config.property === void 0 || config.property === null || config.property === "") {
+    throw new Error(`report_run: "property" is required (Property).`);
+  }
+  if (config.startDate === void 0 || config.startDate === null || config.startDate === "") {
+    throw new Error(`report_run: "startDate" is required (Start date).`);
+  }
+  if (config.endDate === void 0 || config.endDate === null || config.endDate === "") {
+    throw new Error(`report_run: "endDate" is required (End date).`);
+  }
+  if (config.metrics === void 0 || config.metrics === null || config.metrics === "") {
+    throw new Error(`report_run: "metrics" is required (Metrics).`);
+  }
+  return callConnector(GOOGLE_ANALYTICS, {
+    operation: REPORT_RUN_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/v1beta/${encodeURI(String(config.property))}:runReport`,
+      json: nestFields({
+        "dateRanges.0.startDate": String(config.startDate),
+        "dateRanges.0.endDate": String(config.endDate),
+        "metrics": metricsList(config.metrics).map((item) => ({ "name": item })),
+        ...config.dimensions !== void 0 && config.dimensions !== null && config.dimensions !== "" ? { "dimensions": dimensionsList(config.dimensions).map((item) => ({ "name": item })) } : {}
+      })
+    }
+  });
+}
+function nestFields(flat) {
+  const out = {};
+  for (const [path, value] of Object.entries(flat)) {
+    const parts = path.split(".");
+    let node = out;
+    while (parts.length > 1) {
+      const key = parts.shift();
+      const wantsArray = /^\d+$/.test(parts[0] ?? "");
+      if (typeof node[key] !== "object" || node[key] === null) node[key] = wantsArray ? [] : {};
+      node = node[key];
+    }
+    node[parts[0]] = value;
+  }
+  return out;
+}
+function metricsList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+function dimensionsList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+
+export { CONNECTOR_API_VERSION, GOOGLE_ANALYTICS, GOOGLE_ANALYTICS_BASE_URLS, GOOGLE_ANALYTICS_REQUIRES, REPORT_RUN_OPERATION, googleAnalyticsAuthorize, googleAnalyticsFaker, googleAnalyticsReportRun };
+//# sourceMappingURL=chunk-NY2RRZPH.js.map
+//# sourceMappingURL=chunk-NY2RRZPH.js.map

package/dist/chunk-NY2RRZPH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/report-run.ts"],"names":[],"mappings":"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","file":"chunk-NY2RRZPH.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * The Google Analytics faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Analytics actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeReportRun({ config, fake }: FakeRequest): unknown {\n  return {\n    \"dimensionHeaders\": [\n      {\n        \"name\": \"date\",\n      },\n    ],\n    \"metricHeaders\": [\n      {\n        \"name\": \"activeUsers\",\n        \"type\": \"TYPE_INTEGER\",\n      },\n      {\n        \"name\": \"sessions\",\n        \"type\": \"TYPE_INTEGER\",\n      },\n    ],\n    \"rows\": [\n      {\n        \"dimensionValues\": [\n          {\n            \"value\": \"20260821\",\n          },\n        ],\n        \"metricValues\": [\n          {\n            \"value\": \"412\",\n          },\n          {\n            \"value\": \"530\",\n          },\n        ],\n      },\n      {\n        \"dimensionValues\": [\n          {\n            \"value\": \"20260822\",\n          },\n        ],\n        \"metricValues\": [\n          {\n            \"value\": \"389\",\n          },\n          {\n            \"value\": \"501\",\n          },\n        ],\n      },\n    ],\n    \"rowCount\": 2,\n    \"kind\": \"analyticsData#runReport\",\n  };\n}\n\nexport const googleAnalyticsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"report_run\":\n      return fakeReportRun(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_analytics: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * Google Analytics, as one service descriptor shared by every Google Analytics\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Analytics: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google Analytics has no sandbox. A report reads a real property's real data\n * and spends real quota. The faker returns a plausibly-shaped report so a flow\n * can be built without a Google account.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleAnalyticsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_ANALYTICS_BASE_URLS = {\n  \"live\": \"https://analyticsdata.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_ANALYTICS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Analytics's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleAnalyticsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Analytics service, for the TypeScript runtime. */\nexport const GOOGLE_ANALYTICS: ServiceDescriptor = {\n  service: \"google_analytics\",\n  title: \"Google Analytics\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_ANALYTICS_BASE_URLS },\n  requires: [...GOOGLE_ANALYTICS_REQUIRES],\n  authorize: googleAnalyticsAuthorize,\n  faker: googleAnalyticsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/report-run.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/report-run.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * Run a report against a Google Analytics 4 property.\n *\n * POST /v1beta/{+property}:runReport —\n * https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Analytics or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_ANALYTICS } from \"../service.js\";\n\nexport const REPORT_RUN_OPERATION = \"report_run\";\n\nexport type ReportRunOptions = {\n  /** The node's resolved config. Keys: property, startDate, endDate, metrics, dimensions. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleAnalyticsReportRun(options: ReportRunOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.property === undefined || config.property === null || config.property === \"\") {\n    throw new Error(`report_run: \"property\" is required (Property).`);\n  }\n\n  if (config.startDate === undefined || config.startDate === null || config.startDate === \"\") {\n    throw new Error(`report_run: \"startDate\" is required (Start date).`);\n  }\n\n  if (config.endDate === undefined || config.endDate === null || config.endDate === \"\") {\n    throw new Error(`report_run: \"endDate\" is required (End date).`);\n  }\n\n  if (config.metrics === undefined || config.metrics === null || config.metrics === \"\") {\n    throw new Error(`report_run: \"metrics\" is required (Metrics).`);\n  }\n\n  return callConnector(GOOGLE_ANALYTICS, {\n    operation: REPORT_RUN_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1beta/${encodeURI(String(config.property))}:runReport`,\n      json: nestFields({\n        \"dateRanges.0.startDate\": String(config.startDate),\n        \"dateRanges.0.endDate\": String(config.endDate),\n        \"metrics\": metricsList(config.metrics).map((item) => ({ \"name\": item })),\n        ...(config.dimensions !== undefined && config.dimensions !== null && config.dimensions !== \"\" ? { \"dimensions\": dimensionsList(config.dimensions).map((item) => ({ \"name\": item })) } : {}),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction metricsList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction dimensionsList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n"]}

package/dist/flow.cjs

@@ -0,0 +1,177 @@
+'use strict';
+
+var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
+var googleAnalyticsUi = require('@particle-academy/google-analytics-ui');
+
+// src/flow.ts
+
+// src/faker.ts
+function fakeReportRun({ config, fake }) {
+  return {
+    "dimensionHeaders": [
+      {
+        "name": "date"
+      }
+    ],
+    "metricHeaders": [
+      {
+        "name": "activeUsers",
+        "type": "TYPE_INTEGER"
+      },
+      {
+        "name": "sessions",
+        "type": "TYPE_INTEGER"
+      }
+    ],
+    "rows": [
+      {
+        "dimensionValues": [
+          {
+            "value": "20260821"
+          }
+        ],
+        "metricValues": [
+          {
+            "value": "412"
+          },
+          {
+            "value": "530"
+          }
+        ]
+      },
+      {
+        "dimensionValues": [
+          {
+            "value": "20260822"
+          }
+        ],
+        "metricValues": [
+          {
+            "value": "389"
+          },
+          {
+            "value": "501"
+          }
+        ]
+      }
+    ],
+    "rowCount": 2,
+    "kind": "analyticsData#runReport"
+  };
+}
+var googleAnalyticsFaker = (operation, request) => {
+  switch (operation) {
+    case "report_run":
+      return fakeReportRun(request);
+    default:
+      throw new Error(
+        `google_analytics: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var GOOGLE_ANALYTICS_BASE_URLS = {
+  "live": "https://analyticsdata.googleapis.com"
+};
+var GOOGLE_ANALYTICS_REQUIRES = [
+  "accessToken",
+  "refreshToken",
+  "clientId",
+  "clientSecret"
+];
+function googleAnalyticsAuthorize(credentials, request, _mode) {
+  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
+}
+var GOOGLE_ANALYTICS = {
+  service: "google_analytics",
+  title: "Google Analytics",
+  sandbox: "none",
+  baseUrls: { ...GOOGLE_ANALYTICS_BASE_URLS },
+  requires: [...GOOGLE_ANALYTICS_REQUIRES],
+  authorize: googleAnalyticsAuthorize,
+  faker: googleAnalyticsFaker
+};
+var REPORT_RUN_OPERATION = "report_run";
+async function googleAnalyticsReportRun(options) {
+  const config = options.config ?? {};
+  if (config.property === void 0 || config.property === null || config.property === "") {
+    throw new Error(`report_run: "property" is required (Property).`);
+  }
+  if (config.startDate === void 0 || config.startDate === null || config.startDate === "") {
+    throw new Error(`report_run: "startDate" is required (Start date).`);
+  }
+  if (config.endDate === void 0 || config.endDate === null || config.endDate === "") {
+    throw new Error(`report_run: "endDate" is required (End date).`);
+  }
+  if (config.metrics === void 0 || config.metrics === null || config.metrics === "") {
+    throw new Error(`report_run: "metrics" is required (Metrics).`);
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_ANALYTICS, {
+    operation: REPORT_RUN_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/v1beta/${encodeURI(String(config.property))}:runReport`,
+      json: nestFields({
+        "dateRanges.0.startDate": String(config.startDate),
+        "dateRanges.0.endDate": String(config.endDate),
+        "metrics": metricsList(config.metrics).map((item) => ({ "name": item })),
+        ...config.dimensions !== void 0 && config.dimensions !== null && config.dimensions !== "" ? { "dimensions": dimensionsList(config.dimensions).map((item) => ({ "name": item })) } : {}
+      })
+    }
+  });
+}
+function nestFields(flat) {
+  const out = {};
+  for (const [path, value] of Object.entries(flat)) {
+    const parts = path.split(".");
+    let node = out;
+    while (parts.length > 1) {
+      const key = parts.shift();
+      const wantsArray = /^\d+$/.test(parts[0] ?? "");
+      if (typeof node[key] !== "object" || node[key] === null) node[key] = wantsArray ? [] : {};
+      node = node[key];
+    }
+    node[parts[0]] = value;
+  }
+  return out;
+}
+function metricsList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+function dimensionsList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+
+// src/flow.ts
+var googleAnalyticsReportExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleAnalyticsReportRun({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_analytics report_run ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var GOOGLE_ANALYTICS_RUNNABLE_KINDS = [
+  { ...googleAnalyticsUi.googleAnalyticsReportKind, executor: googleAnalyticsReportExecutor }
+];
+
+exports.GOOGLE_ANALYTICS_RUNNABLE_KINDS = GOOGLE_ANALYTICS_RUNNABLE_KINDS;
+exports.googleAnalyticsReportExecutor = googleAnalyticsReportExecutor;
+//# sourceMappingURL=flow.cjs.map
+//# sourceMappingURL=flow.cjs.map

package/dist/flow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/report-run.ts","../src/flow.ts"],"names":["callConnector","googleAnalyticsReportKind"],"mappings":"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","file":"flow.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * The Google Analytics faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Analytics actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeReportRun({ config, fake }: FakeRequest): unknown {\n  return {\n    \"dimensionHeaders\": [\n      {\n        \"name\": \"date\",\n      },\n    ],\n    \"metricHeaders\": [\n      {\n        \"name\": \"activeUsers\",\n        \"type\": \"TYPE_INTEGER\",\n      },\n      {\n        \"name\": \"sessions\",\n        \"type\": \"TYPE_INTEGER\",\n      },\n    ],\n    \"rows\": [\n      {\n        \"dimensionValues\": [\n          {\n            \"value\": \"20260821\",\n          },\n        ],\n        \"metricValues\": [\n          {\n            \"value\": \"412\",\n          },\n          {\n            \"value\": \"530\",\n          },\n        ],\n      },\n      {\n        \"dimensionValues\": [\n          {\n            \"value\": \"20260822\",\n          },\n        ],\n        \"metricValues\": [\n          {\n            \"value\": \"389\",\n          },\n          {\n            \"value\": \"501\",\n          },\n        ],\n      },\n    ],\n    \"rowCount\": 2,\n    \"kind\": \"analyticsData#runReport\",\n  };\n}\n\nexport const googleAnalyticsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"report_run\":\n      return fakeReportRun(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_analytics: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * Google Analytics, as one service descriptor shared by every Google Analytics\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Analytics: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google Analytics has no sandbox. A report reads a real property's real data\n * and spends real quota. The faker returns a plausibly-shaped report so a flow\n * can be built without a Google account.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleAnalyticsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_ANALYTICS_BASE_URLS = {\n  \"live\": \"https://analyticsdata.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_ANALYTICS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Analytics's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleAnalyticsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Analytics service, for the TypeScript runtime. */\nexport const GOOGLE_ANALYTICS: ServiceDescriptor = {\n  service: \"google_analytics\",\n  title: \"Google Analytics\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_ANALYTICS_BASE_URLS },\n  requires: [...GOOGLE_ANALYTICS_REQUIRES],\n  authorize: googleAnalyticsAuthorize,\n  faker: googleAnalyticsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/report-run.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/report-run.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * Run a report against a Google Analytics 4 property.\n *\n * POST /v1beta/{+property}:runReport —\n * https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Analytics or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_ANALYTICS } from \"../service.js\";\n\nexport const REPORT_RUN_OPERATION = \"report_run\";\n\nexport type ReportRunOptions = {\n  /** The node's resolved config. Keys: property, startDate, endDate, metrics, dimensions. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleAnalyticsReportRun(options: ReportRunOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.property === undefined || config.property === null || config.property === \"\") {\n    throw new Error(`report_run: \"property\" is required (Property).`);\n  }\n\n  if (config.startDate === undefined || config.startDate === null || config.startDate === \"\") {\n    throw new Error(`report_run: \"startDate\" is required (Start date).`);\n  }\n\n  if (config.endDate === undefined || config.endDate === null || config.endDate === \"\") {\n    throw new Error(`report_run: \"endDate\" is required (End date).`);\n  }\n\n  if (config.metrics === undefined || config.metrics === null || config.metrics === \"\") {\n    throw new Error(`report_run: \"metrics\" is required (Metrics).`);\n  }\n\n  return callConnector(GOOGLE_ANALYTICS, {\n    operation: REPORT_RUN_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1beta/${encodeURI(String(config.property))}:runReport`,\n      json: nestFields({\n        \"dateRanges.0.startDate\": String(config.startDate),\n        \"dateRanges.0.endDate\": String(config.endDate),\n        \"metrics\": metricsList(config.metrics).map((item) => ({ \"name\": item })),\n        ...(config.dimensions !== undefined && config.dimensions !== null && config.dimensions !== \"\" ? { \"dimensions\": dimensionsList(config.dimensions).map((item) => ({ \"name\": item })) } : {}),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction metricsList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction dimensionsList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * Google Analytics's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-analytics-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_ANALYTICS } from \"./service.js\";\n\nimport {\n  googleAnalyticsReportKind,\n} from \"@particle-academy/google-analytics-ui\";\n\nimport { googleAnalyticsReportRun } from \"./actions/report-run.js\";\n\nexport const googleAnalyticsReportExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleAnalyticsReportRun({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_analytics report_run ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_ANALYTICS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleAnalyticsReportKind, executor: googleAnalyticsReportExecutor },\n];\n"]}

package/dist/flow.d.cts

@@ -0,0 +1,26 @@
+import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/ + triggers/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/ + triggers/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_analytics
+ */
+/**
+ * Google Analytics's node kinds with their TypeScript executors attached — for
+ * hosts that EXECUTE on TS.
+ *
+ * The authoring surface in @particle-academy/google-analytics-ui carries no
+ * executor: the editor is React on every host, so a PHP or Python project
+ * installs the ui package and never this one.
+ */
+
+declare const googleAnalyticsReportExecutor: NodeExecutor;
+/** The kinds a TypeScript host registers. */
+declare const GOOGLE_ANALYTICS_RUNNABLE_KINDS: NodeKindDefinition[];
+
+export { GOOGLE_ANALYTICS_RUNNABLE_KINDS, googleAnalyticsReportExecutor };

package/dist/flow.d.ts

@@ -0,0 +1,26 @@
+import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/ + triggers/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/ + triggers/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_analytics
+ */
+/**
+ * Google Analytics's node kinds with their TypeScript executors attached — for
+ * hosts that EXECUTE on TS.
+ *
+ * The authoring surface in @particle-academy/google-analytics-ui carries no
+ * executor: the editor is React on every host, so a PHP or Python project
+ * installs the ui package and never this one.
+ */
+
+declare const googleAnalyticsReportExecutor: NodeExecutor;
+/** The kinds a TypeScript host registers. */
+declare const GOOGLE_ANALYTICS_RUNNABLE_KINDS: NodeKindDefinition[];
+
+export { GOOGLE_ANALYTICS_RUNNABLE_KINDS, googleAnalyticsReportExecutor };

package/dist/flow.js

@@ -0,0 +1,25 @@
+import { googleAnalyticsReportRun } from './chunk-NY2RRZPH.js';
+import '@particle-academy/fancy-connector-core';
+import { googleAnalyticsReportKind } from '@particle-academy/google-analytics-ui';
+
+var googleAnalyticsReportExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const result = await googleAnalyticsReportRun({
+    config,
+    input: ctx.inputs?.in
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `google_analytics report_run ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var GOOGLE_ANALYTICS_RUNNABLE_KINDS = [
+  { ...googleAnalyticsReportKind, executor: googleAnalyticsReportExecutor }
+];
+
+export { GOOGLE_ANALYTICS_RUNNABLE_KINDS, googleAnalyticsReportExecutor };
+//# sourceMappingURL=flow.js.map
+//# sourceMappingURL=flow.js.map

package/dist/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":";;;;AAoCO,IAAM,6BAAA,GAA8C,OAAO,GAAA,KAAQ;AACxE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAEpF,EAAA,MAAM,MAAA,GAAS,MAAM,wBAAA,CAAyB;AAAA,IAC5C,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ;AAAA,GACpB,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,4BAAA,EAAgC,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GAC7F,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,+BAAA,GAAwD;AAAA,EACnE,EAAE,GAAG,yBAAA,EAA2B,QAAA,EAAU,6BAAA;AAC5C","file":"flow.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * Google Analytics's node kinds with their TypeScript executors attached — for\n * hosts that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/google-analytics-ui carries no\n * executor: the editor is React on every host, so a PHP or Python project\n * installs the ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_ANALYTICS } from \"./service.js\";\n\nimport {\n  googleAnalyticsReportKind,\n} from \"@particle-academy/google-analytics-ui\";\n\nimport { googleAnalyticsReportRun } from \"./actions/report-run.js\";\n\nexport const googleAnalyticsReportExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  const result = await googleAnalyticsReportRun({\n    config,\n    input: ctx.inputs?.in,\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `google_analytics report_run ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const GOOGLE_ANALYTICS_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...googleAnalyticsReportKind, executor: googleAnalyticsReportExecutor },\n];\n"]}

package/dist/index.cjs

@@ -0,0 +1,162 @@
+'use strict';
+
+var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
+
+// src/faker.ts
+function fakeReportRun({ config, fake }) {
+  return {
+    "dimensionHeaders": [
+      {
+        "name": "date"
+      }
+    ],
+    "metricHeaders": [
+      {
+        "name": "activeUsers",
+        "type": "TYPE_INTEGER"
+      },
+      {
+        "name": "sessions",
+        "type": "TYPE_INTEGER"
+      }
+    ],
+    "rows": [
+      {
+        "dimensionValues": [
+          {
+            "value": "20260821"
+          }
+        ],
+        "metricValues": [
+          {
+            "value": "412"
+          },
+          {
+            "value": "530"
+          }
+        ]
+      },
+      {
+        "dimensionValues": [
+          {
+            "value": "20260822"
+          }
+        ],
+        "metricValues": [
+          {
+            "value": "389"
+          },
+          {
+            "value": "501"
+          }
+        ]
+      }
+    ],
+    "rowCount": 2,
+    "kind": "analyticsData#runReport"
+  };
+}
+var googleAnalyticsFaker = (operation, request) => {
+  switch (operation) {
+    case "report_run":
+      return fakeReportRun(request);
+    default:
+      throw new Error(
+        `google_analytics: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var GOOGLE_ANALYTICS_BASE_URLS = {
+  "live": "https://analyticsdata.googleapis.com"
+};
+var GOOGLE_ANALYTICS_REQUIRES = [
+  "accessToken",
+  "refreshToken",
+  "clientId",
+  "clientSecret"
+];
+function googleAnalyticsAuthorize(credentials, request, _mode) {
+  request.headers.Authorization = `Bearer ${credentials.accessToken ?? ""}`;
+}
+var GOOGLE_ANALYTICS = {
+  service: "google_analytics",
+  title: "Google Analytics",
+  sandbox: "none",
+  baseUrls: { ...GOOGLE_ANALYTICS_BASE_URLS },
+  requires: [...GOOGLE_ANALYTICS_REQUIRES],
+  authorize: googleAnalyticsAuthorize,
+  faker: googleAnalyticsFaker
+};
+var REPORT_RUN_OPERATION = "report_run";
+async function googleAnalyticsReportRun(options) {
+  const config = options.config ?? {};
+  if (config.property === void 0 || config.property === null || config.property === "") {
+    throw new Error(`report_run: "property" is required (Property).`);
+  }
+  if (config.startDate === void 0 || config.startDate === null || config.startDate === "") {
+    throw new Error(`report_run: "startDate" is required (Start date).`);
+  }
+  if (config.endDate === void 0 || config.endDate === null || config.endDate === "") {
+    throw new Error(`report_run: "endDate" is required (End date).`);
+  }
+  if (config.metrics === void 0 || config.metrics === null || config.metrics === "") {
+    throw new Error(`report_run: "metrics" is required (Metrics).`);
+  }
+  return fancyConnectorCore.callConnector(GOOGLE_ANALYTICS, {
+    operation: REPORT_RUN_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: `/v1beta/${encodeURI(String(config.property))}:runReport`,
+      json: nestFields({
+        "dateRanges.0.startDate": String(config.startDate),
+        "dateRanges.0.endDate": String(config.endDate),
+        "metrics": metricsList(config.metrics).map((item) => ({ "name": item })),
+        ...config.dimensions !== void 0 && config.dimensions !== null && config.dimensions !== "" ? { "dimensions": dimensionsList(config.dimensions).map((item) => ({ "name": item })) } : {}
+      })
+    }
+  });
+}
+function nestFields(flat) {
+  const out = {};
+  for (const [path, value] of Object.entries(flat)) {
+    const parts = path.split(".");
+    let node = out;
+    while (parts.length > 1) {
+      const key = parts.shift();
+      const wantsArray = /^\d+$/.test(parts[0] ?? "");
+      if (typeof node[key] !== "object" || node[key] === null) node[key] = wantsArray ? [] : {};
+      node = node[key];
+    }
+    node[parts[0]] = value;
+  }
+  return out;
+}
+function metricsList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+function dimensionsList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+
+exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
+exports.GOOGLE_ANALYTICS = GOOGLE_ANALYTICS;
+exports.GOOGLE_ANALYTICS_BASE_URLS = GOOGLE_ANALYTICS_BASE_URLS;
+exports.GOOGLE_ANALYTICS_REQUIRES = GOOGLE_ANALYTICS_REQUIRES;
+exports.REPORT_RUN_OPERATION = REPORT_RUN_OPERATION;
+exports.googleAnalyticsAuthorize = googleAnalyticsAuthorize;
+exports.googleAnalyticsFaker = googleAnalyticsFaker;
+exports.googleAnalyticsReportRun = googleAnalyticsReportRun;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/report-run.ts"],"names":["callConnector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * The Google Analytics faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Google Analytics actually publishes, so an author can wire {{\n * $json.data.id }} against a fake and have it keep working against the real\n * thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeReportRun({ config, fake }: FakeRequest): unknown {\n  return {\n    \"dimensionHeaders\": [\n      {\n        \"name\": \"date\",\n      },\n    ],\n    \"metricHeaders\": [\n      {\n        \"name\": \"activeUsers\",\n        \"type\": \"TYPE_INTEGER\",\n      },\n      {\n        \"name\": \"sessions\",\n        \"type\": \"TYPE_INTEGER\",\n      },\n    ],\n    \"rows\": [\n      {\n        \"dimensionValues\": [\n          {\n            \"value\": \"20260821\",\n          },\n        ],\n        \"metricValues\": [\n          {\n            \"value\": \"412\",\n          },\n          {\n            \"value\": \"530\",\n          },\n        ],\n      },\n      {\n        \"dimensionValues\": [\n          {\n            \"value\": \"20260822\",\n          },\n        ],\n        \"metricValues\": [\n          {\n            \"value\": \"389\",\n          },\n          {\n            \"value\": \"501\",\n          },\n        ],\n      },\n    ],\n    \"rowCount\": 2,\n    \"kind\": \"analyticsData#runReport\",\n  };\n}\n\nexport const googleAnalyticsFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"report_run\":\n      return fakeReportRun(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `google_analytics: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * Google Analytics, as one service descriptor shared by every Google Analytics\n * operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Google Analytics: its base URL, its\n * auth scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Google Analytics has no sandbox. A report reads a real property's real data\n * and spends real quota. The faker returns a plausibly-shaped report so a flow\n * can be built without a Google account.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { googleAnalyticsFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const GOOGLE_ANALYTICS_BASE_URLS = {\n  \"live\": \"https://analyticsdata.googleapis.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const GOOGLE_ANALYTICS_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Google Analytics's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function googleAnalyticsAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Google Analytics service, for the TypeScript runtime. */\nexport const GOOGLE_ANALYTICS: ServiceDescriptor = {\n  service: \"google_analytics\",\n  title: \"Google Analytics\",\n  sandbox: \"none\",\n  baseUrls: { ...GOOGLE_ANALYTICS_BASE_URLS },\n  requires: [...GOOGLE_ANALYTICS_REQUIRES],\n  authorize: googleAnalyticsAuthorize,\n  faker: googleAnalyticsFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/report-run.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/report-run.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- google_analytics\n */\n\n/**\n * Run a report against a Google Analytics 4 property.\n *\n * POST /v1beta/{+property}:runReport —\n * https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Google Analytics or calls the\n * faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { GOOGLE_ANALYTICS } from \"../service.js\";\n\nexport const REPORT_RUN_OPERATION = \"report_run\";\n\nexport type ReportRunOptions = {\n  /** The node's resolved config. Keys: property, startDate, endDate, metrics, dimensions. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function googleAnalyticsReportRun(options: ReportRunOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.property === undefined || config.property === null || config.property === \"\") {\n    throw new Error(`report_run: \"property\" is required (Property).`);\n  }\n\n  if (config.startDate === undefined || config.startDate === null || config.startDate === \"\") {\n    throw new Error(`report_run: \"startDate\" is required (Start date).`);\n  }\n\n  if (config.endDate === undefined || config.endDate === null || config.endDate === \"\") {\n    throw new Error(`report_run: \"endDate\" is required (End date).`);\n  }\n\n  if (config.metrics === undefined || config.metrics === null || config.metrics === \"\") {\n    throw new Error(`report_run: \"metrics\" is required (Metrics).`);\n  }\n\n  return callConnector(GOOGLE_ANALYTICS, {\n    operation: REPORT_RUN_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: `/v1beta/${encodeURI(String(config.property))}:runReport`,\n      json: nestFields({\n        \"dateRanges.0.startDate\": String(config.startDate),\n        \"dateRanges.0.endDate\": String(config.endDate),\n        \"metrics\": metricsList(config.metrics).map((item) => ({ \"name\": item })),\n        ...(config.dimensions !== undefined && config.dimensions !== null && config.dimensions !== \"\" ? { \"dimensions\": dimensionsList(config.dimensions).map((item) => ({ \"name\": item })) } : {}),\n      }),\n    },\n  });\n}\n\n/**\n * `{\"properties.email\": x}` -> `{properties: {email: x}}`.\n *\n * A dotted `as` means NESTING, and only a JSON body can nest. The validator\n * refuses that spelling anywhere else, because in a form body it already means\n * something different — a literal dotted key.\n */\nfunction nestFields(flat: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n\n  for (const [path, value] of Object.entries(flat)) {\n    const parts = path.split(\".\");\n    let node = out;\n\n    while (parts.length > 1) {\n      const key = parts.shift() as string;\n      // A NUMERIC segment is an array index: `dateRanges.0.startDate` has to\n      // become `[{startDate}]`, not `{\"0\": {startDate}}`. PHP produced the\n      // array by accident (its integer-keyed arrays serialise as JSON lists)\n      // and the other two produced an object, which the provider rejects as\n      // the wrong type. The parity suite is what caught the disagreement.\n      const wantsArray = /^\\d+$/.test(parts[0] ?? \"\");\n\n      if (typeof node[key] !== \"object\" || node[key] === null) node[key] = wantsArray ? [] : {};\n      node = node[key] as Record<string, unknown>;\n    }\n\n    node[parts[0] as string] = value;\n  }\n\n  return out;\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction metricsList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction dimensionsList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,115 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/manifest.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/manifest.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_analytics
+ */
+/**
+ * Google Analytics, as one service descriptor shared by every Google Analytics
+ * operation.
+ *
+ * @particle-academy/fancy-connector-core carries what is true of ALL
+ * connectors. This carries what is true of Google Analytics: its base URL, its
+ * auth scheme, its idempotency header, and its faker.
+ *
+ * ## The sandbox trap, written down where it is used
+ *
+ * Google Analytics has no sandbox. A report reads a real property's real data
+ * and spends real quota. The faker returns a plausibly-shaped report so a flow
+ * can be built without a Google account.
+ */
+
+/**
+ * The connector API version this package was GENERATED against.
+ *
+ * A literal, never imported. An imported constant lets an upgrade rewrite the
+ * very claim it exists to detect, after which the copy agrees with itself
+ * forever.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+declare const GOOGLE_ANALYTICS_BASE_URLS: {
+    readonly live: "https://analyticsdata.googleapis.com";
+};
+/** Credential keys a remote call cannot proceed without. */
+declare const GOOGLE_ANALYTICS_REQUIRES: readonly ["accessToken", "refreshToken", "clientId", "clientSecret"];
+/**
+ * Apply Google Analytics's auth scheme to an outgoing request.
+ *
+ *
+ *
+ * The mode is passed in because for some providers auth and estate are the
+ * same decision expressed in the URL; here it is unused, and saying so is
+ * cheaper than wondering later whether it was forgotten.
+ */
+declare function googleAnalyticsAuthorize(credentials: Record<string, string | undefined>, request: PreparedRequest, _mode: ConnectorMode): void;
+/** The Google Analytics service, for the TypeScript runtime. */
+declare const GOOGLE_ANALYTICS: ServiceDescriptor;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/fixtures/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/fixtures/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_analytics
+ */
+/**
+ * The Google Analytics faker.
+ *
+ * Shapes, not behaviour: the goal is that a downstream node sees the field
+ * NAMES Google Analytics actually publishes, so an author can wire {{
+ * $json.data.id }} against a fake and have it keep working against the real
+ * thing.
+ *
+ * Deterministic — same inputs, same output. A faker returning a fresh uuid
+ * every call cannot be asserted on, so its fixtures degrade to "it did not
+ * throw", which is the assertion that catches nothing.
+ */
+
+declare const googleAnalyticsFaker: ConnectorFaker;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/report-run.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/report-run.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_analytics
+ */
+/**
+ * Run a report against a Google Analytics 4 property.
+ *
+ * POST /v1beta/{+property}:runReport —
+ * https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Google Analytics or calls the
+ * faker.
+ */
+
+declare const REPORT_RUN_OPERATION = "report_run";
+type ReportRunOptions = {
+    /** The node's resolved config. Keys: property, startDate, endDate, metrics, dimensions. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function googleAnalyticsReportRun(options: ReportRunOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, GOOGLE_ANALYTICS, GOOGLE_ANALYTICS_BASE_URLS, GOOGLE_ANALYTICS_REQUIRES, REPORT_RUN_OPERATION, type ReportRunOptions, googleAnalyticsAuthorize, googleAnalyticsFaker, googleAnalyticsReportRun };

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/manifest.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/manifest.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_analytics
+ */
+/**
+ * Google Analytics, as one service descriptor shared by every Google Analytics
+ * operation.
+ *
+ * @particle-academy/fancy-connector-core carries what is true of ALL
+ * connectors. This carries what is true of Google Analytics: its base URL, its
+ * auth scheme, its idempotency header, and its faker.
+ *
+ * ## The sandbox trap, written down where it is used
+ *
+ * Google Analytics has no sandbox. A report reads a real property's real data
+ * and spends real quota. The faker returns a plausibly-shaped report so a flow
+ * can be built without a Google account.
+ */
+
+/**
+ * The connector API version this package was GENERATED against.
+ *
+ * A literal, never imported. An imported constant lets an upgrade rewrite the
+ * very claim it exists to detect, after which the copy agrees with itself
+ * forever.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+declare const GOOGLE_ANALYTICS_BASE_URLS: {
+    readonly live: "https://analyticsdata.googleapis.com";
+};
+/** Credential keys a remote call cannot proceed without. */
+declare const GOOGLE_ANALYTICS_REQUIRES: readonly ["accessToken", "refreshToken", "clientId", "clientSecret"];
+/**
+ * Apply Google Analytics's auth scheme to an outgoing request.
+ *
+ *
+ *
+ * The mode is passed in because for some providers auth and estate are the
+ * same decision expressed in the URL; here it is unused, and saying so is
+ * cheaper than wondering later whether it was forgotten.
+ */
+declare function googleAnalyticsAuthorize(credentials: Record<string, string | undefined>, request: PreparedRequest, _mode: ConnectorMode): void;
+/** The Google Analytics service, for the TypeScript runtime. */
+declare const GOOGLE_ANALYTICS: ServiceDescriptor;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/fixtures/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/fixtures/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_analytics
+ */
+/**
+ * The Google Analytics faker.
+ *
+ * Shapes, not behaviour: the goal is that a downstream node sees the field
+ * NAMES Google Analytics actually publishes, so an author can wire {{
+ * $json.data.id }} against a fake and have it keep working against the real
+ * thing.
+ *
+ * Deterministic — same inputs, same output. A faker returning a fresh uuid
+ * every call cannot be asserted on, so its fixtures degrade to "it did not
+ * throw", which is the assertion that catches nothing.
+ */
+
+declare const googleAnalyticsFaker: ConnectorFaker;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/report-run.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/report-run.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- google_analytics
+ */
+/**
+ * Run a report against a Google Analytics 4 property.
+ *
+ * POST /v1beta/{+property}:runReport —
+ * https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Google Analytics or calls the
+ * faker.
+ */
+
+declare const REPORT_RUN_OPERATION = "report_run";
+type ReportRunOptions = {
+    /** The node's resolved config. Keys: property, startDate, endDate, metrics, dimensions. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function googleAnalyticsReportRun(options: ReportRunOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, GOOGLE_ANALYTICS, GOOGLE_ANALYTICS_BASE_URLS, GOOGLE_ANALYTICS_REQUIRES, REPORT_RUN_OPERATION, type ReportRunOptions, googleAnalyticsAuthorize, googleAnalyticsFaker, googleAnalyticsReportRun };

package/dist/index.js

@@ -0,0 +1,3 @@
+export { CONNECTOR_API_VERSION, GOOGLE_ANALYTICS, GOOGLE_ANALYTICS_BASE_URLS, GOOGLE_ANALYTICS_REQUIRES, REPORT_RUN_OPERATION, googleAnalyticsAuthorize, googleAnalyticsFaker, googleAnalyticsReportRun } from './chunk-NY2RRZPH.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@particle-academy/google-analytics-js",
+  "version": "0.1.0",
+  "description": "Google Analytics for Node — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP on @particle-academy/fancy-connector-core; no vendor SDK.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Fancy-Friends/google-analytics.git"
+  },
+  "homepage": "https://github.com/Fancy-Friends/google-analytics#readme",
+  "bugs": "https://github.com/Fancy-Friends/google-analytics/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./flow": {
+      "import": {
+        "types": "./dist/flow.d.ts",
+        "default": "./dist/flow.js"
+      },
+      "require": {
+        "types": "./dist/flow.d.cts",
+        "default": "./dist/flow.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "lint": "tsc --noEmit",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "prepublishOnly": "tsup"
+  },
+  "dependencies": {
+    "@particle-academy/fancy-connector-core": ">=0.3.1 <2.0",
+    "@particle-academy/google-analytics-ui": "0.1.0"
+  },
+  "peerDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0"
+  },
+  "peerDependenciesMeta": {
+    "@particle-academy/fancy-flow": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
+    "@types/node": "^26.2.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "google_analytics",
+    "analytics",
+    "connector",
+    "api",
+    "fancy-ui",
+    "particle-academy"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  }
+}