@particle-academy/google-analytics-ui 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/index.cjs

@@ -0,0 +1,150 @@
+'use strict';
+
+var connectors = require('@particle-academy/fancy-flow/connectors');
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var GOOGLE_ANALYTICS_SERVICE = {
+  service: "google_analytics",
+  serviceTitle: "Google Analytics",
+  domain: "analytics",
+  sandbox: "none"
+};
+var GOOGLE_ANALYTICS_CREDENTIALS = [
+  {
+    "key": "clientId",
+    "label": "OAuth client ID",
+    "scope": "provider",
+    "secret": false,
+    "help": "From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account."
+  },
+  {
+    "key": "clientSecret",
+    "label": "OAuth client secret",
+    "scope": "provider",
+    "secret": true,
+    "help": "The client secret for the same OAuth app. One value for the whole installation."
+  },
+  {
+    "key": "accessToken",
+    "label": "Access token",
+    "scope": "account",
+    "secret": true,
+    "help": "Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token."
+  },
+  {
+    "key": "refreshToken",
+    "label": "Refresh token",
+    "scope": "account",
+    "secret": true,
+    "help": "Per connected Google account. Google issues one only when the consent request asks for offline access."
+  }
+];
+var GOOGLE_ANALYTICS_OAUTH = {
+  "flow": "authorization_code",
+  "authorizeUrl": "https://accounts.google.com/o/oauth2/v2/auth",
+  "tokenUrl": "https://oauth2.googleapis.com/token",
+  "scopes": [
+    "https://www.googleapis.com/auth/analytics.readonly"
+  ],
+  "accessTokenCredential": "accessToken",
+  "refreshTokenCredential": "refreshToken",
+  "accessTokenTtlSeconds": 3600
+};
+function googleAnalyticsMeta(role, operation, docs) {
+  return { ...GOOGLE_ANALYTICS_SERVICE, role, operation, docs };
+}
+var GOOGLE_ANALYTICS_REPORT_KIND = "@particle-academy/google_analytics_report";
+var GOOGLE_ANALYTICS_REPORT_OPERATION = "report_run";
+var GOOGLE_ANALYTICS_REPORT_META = googleAnalyticsMeta("action", "run a report", "https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport");
+var GOOGLE_ANALYTICS_REPORT_OUTPUT = [
+  {
+    "path": "data.rows",
+    "type": "array",
+    "description": "One entry per combination of dimension values. Each carries dimensionValues and metricValues, in the order requested."
+  },
+  {
+    "path": "data.rowCount",
+    "type": "number",
+    "description": "Total rows matching the query, which can exceed the rows returned."
+  },
+  {
+    "path": "data.metricHeaders",
+    "type": "array",
+    "description": "The metrics in the order their values appear in each row -- the only thing that says which number is which."
+  }
+];
+var googleAnalyticsReportKind = connectors.defineConnectorKind(GOOGLE_ANALYTICS_REPORT_META, {
+  name: GOOGLE_ANALYTICS_REPORT_KIND,
+  aliases: ["google_analytics_report"],
+  label: "Google Analytics report",
+  description: "Run a report against a Google Analytics 4 property.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GOOGLE_ANALYTICS_REPORT_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "property",
+      "label": "Property",
+      "required": true,
+      "default": "properties/",
+      "description": "The GA4 property, written as `properties/1234567890`. The numeric id alone is not accepted."
+    },
+    {
+      "type": "text",
+      "key": "startDate",
+      "label": "Start date",
+      "required": true,
+      "default": "28daysAgo",
+      "description": "YYYY-MM-DD, or a relative form Google accepts such as `28daysAgo`, `yesterday` or `today`."
+    },
+    {
+      "type": "text",
+      "key": "endDate",
+      "label": "End date",
+      "required": true,
+      "default": "today",
+      "description": "YYYY-MM-DD, or a relative form such as `today`."
+    },
+    {
+      "type": "text",
+      "key": "metrics",
+      "label": "Metrics",
+      "required": true,
+      "default": "activeUsers,sessions",
+      "description": "Metric names, comma separated. For example activeUsers, sessions, screenPageViews."
+    },
+    {
+      "type": "text",
+      "key": "dimensions",
+      "label": "Dimensions",
+      "default": "date",
+      "description": "Dimension names, comma separated. For example date, country, pagePath. Leave empty for a single total row."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GOOGLE_ANALYTICS_REPORT_META, config, "run a report")
+});
+
+// src/index.ts
+var GOOGLE_ANALYTICS_KINDS = [
+  googleAnalyticsReportKind
+];
+
+exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
+exports.GOOGLE_ANALYTICS_CREDENTIALS = GOOGLE_ANALYTICS_CREDENTIALS;
+exports.GOOGLE_ANALYTICS_KINDS = GOOGLE_ANALYTICS_KINDS;
+exports.GOOGLE_ANALYTICS_OAUTH = GOOGLE_ANALYTICS_OAUTH;
+exports.GOOGLE_ANALYTICS_REPORT_KIND = GOOGLE_ANALYTICS_REPORT_KIND;
+exports.GOOGLE_ANALYTICS_REPORT_META = GOOGLE_ANALYTICS_REPORT_META;
+exports.GOOGLE_ANALYTICS_REPORT_OPERATION = GOOGLE_ANALYTICS_REPORT_OPERATION;
+exports.GOOGLE_ANALYTICS_REPORT_OUTPUT = GOOGLE_ANALYTICS_REPORT_OUTPUT;
+exports.GOOGLE_ANALYTICS_SERVICE = GOOGLE_ANALYTICS_SERVICE;
+exports.googleAnalyticsMeta = googleAnalyticsMeta;
+exports.googleAnalyticsReportKind = googleAnalyticsReportKind;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/service.ts","../src/kinds/report-run.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\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's identity on the authoring surface, shared by every Google\n * Analytics node.\n *\n * This file must import nothing from the js package: a PHP or Python project\n * installs the ui package and never that one, and the import would be a\n * dangling module the moment it did.\n *\n * ## The sandbox trap\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 { ConnectorMeta } from \"@particle-academy/fancy-flow/connectors\";\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.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\n/** The parts of a connector's identity that belong to the SERVICE, not the node. */\nexport const GOOGLE_ANALYTICS_SERVICE = {\n  service: \"google_analytics\",\n  serviceTitle: \"Google Analytics\",\n  domain: \"analytics\",\n  sandbox: \"none\",\n} as const satisfies Pick<ConnectorMeta, \"service\" | \"serviceTitle\" | \"domain\" | \"sandbox\">;\n\n/** The credentials a Google Analytics connection holds. */\nexport const GOOGLE_ANALYTICS_CREDENTIALS = [\n  {\n    \"key\": \"clientId\",\n    \"label\": \"OAuth client ID\",\n    \"scope\": \"provider\",\n    \"secret\": false,\n    \"help\": \"From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account.\"\n  },\n  {\n    \"key\": \"clientSecret\",\n    \"label\": \"OAuth client secret\",\n    \"scope\": \"provider\",\n    \"secret\": true,\n    \"help\": \"The client secret for the same OAuth app. One value for the whole installation.\"\n  },\n  {\n    \"key\": \"accessToken\",\n    \"label\": \"Access token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.\"\n  },\n  {\n    \"key\": \"refreshToken\",\n    \"label\": \"Refresh token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account. Google issues one only when the consent request asks for offline access.\"\n  }\n] as const;\n\n/**\n * The OAuth2 exchange Google Analytics requires — DECLARED here, performed by\n * the host.\n *\n * A consent screen needs a browser, a redirect URI and somewhere to persist\n * the result, and all three belong to the host; a package that ran the dance\n * itself would have to own a web server. So this says precisely enough for a\n * host to do it.\n *\n * The access token lasts 3600 seconds. A host that never refreshes will work\n * all afternoon and be broken by morning, which is why the lifetime is stated\n * rather than left to be discovered.\n */\nexport const GOOGLE_ANALYTICS_OAUTH = {\n  \"flow\": \"authorization_code\",\n  \"authorizeUrl\": \"https://accounts.google.com/o/oauth2/v2/auth\",\n  \"tokenUrl\": \"https://oauth2.googleapis.com/token\",\n  \"scopes\": [\n    \"https://www.googleapis.com/auth/analytics.readonly\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Analytics node's connector metadata from the operation it performs. */\nexport function googleAnalyticsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_ANALYTICS_SERVICE, role, operation, docs };\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 * Google Analytics report — Run a report against a Google Analytics 4\n * property.\n *\n * https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleAnalyticsMeta } from \"../service.js\";\n\nexport const GOOGLE_ANALYTICS_REPORT_KIND = \"@particle-academy/google_analytics_report\";\nexport const GOOGLE_ANALYTICS_REPORT_OPERATION = \"report_run\";\n\nexport const GOOGLE_ANALYTICS_REPORT_META = googleAnalyticsMeta(\"action\", \"run a report\", \"https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_ANALYTICS_REPORT_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.rows\",\n    \"type\": \"array\",\n    \"description\": \"One entry per combination of dimension values. Each carries dimensionValues and metricValues, in the order requested.\"\n  },\n  {\n    \"path\": \"data.rowCount\",\n    \"type\": \"number\",\n    \"description\": \"Total rows matching the query, which can exceed the rows returned.\"\n  },\n  {\n    \"path\": \"data.metricHeaders\",\n    \"type\": \"array\",\n    \"description\": \"The metrics in the order their values appear in each row -- the only thing that says which number is which.\"\n  }\n];\n\nexport const googleAnalyticsReportKind: NodeKindDefinition = defineConnectorKind(GOOGLE_ANALYTICS_REPORT_META, {\n  name: GOOGLE_ANALYTICS_REPORT_KIND,\n  aliases: [\"google_analytics_report\"],\n  label: \"Google Analytics report\",\n  description: \"Run a report against a Google Analytics 4 property.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GOOGLE_ANALYTICS_REPORT_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"property\",\n      \"label\": \"Property\",\n      \"required\": true,\n      \"default\": \"properties/\",\n      \"description\": \"The GA4 property, written as `properties/1234567890`. The numeric id alone is not accepted.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"startDate\",\n      \"label\": \"Start date\",\n      \"required\": true,\n      \"default\": \"28daysAgo\",\n      \"description\": \"YYYY-MM-DD, or a relative form Google accepts such as `28daysAgo`, `yesterday` or `today`.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"endDate\",\n      \"label\": \"End date\",\n      \"required\": true,\n      \"default\": \"today\",\n      \"description\": \"YYYY-MM-DD, or a relative form such as `today`.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"metrics\",\n      \"label\": \"Metrics\",\n      \"required\": true,\n      \"default\": \"activeUsers,sessions\",\n      \"description\": \"Metric names, comma separated. For example activeUsers, sessions, screenPageViews.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"dimensions\",\n      \"label\": \"Dimensions\",\n      \"default\": \"date\",\n      \"description\": \"Dimension names, comma separated. For example date, country, pagePath. Leave empty for a single total row.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_ANALYTICS_REPORT_META, config as Record<string, unknown>, \"run a report\"),\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's node kinds for fancy-flow.\n *\n * Install this on every host. The TypeScript executors live in the js\n * package's `./flow` subpath; PHP and Python hosts run their own and need only\n * this.\n */\n\nexport * from \"./service.js\";\nexport * from \"./kinds/report-run.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleAnalyticsReportKind } from \"./kinds/report-run.js\";\n\n/** Every Google Analytics kind, for a host that registers the lot. */\nexport const GOOGLE_ANALYTICS_KINDS: NodeKindDefinition[] = [\n  googleAnalyticsReportKind,\n];\n"]}

package/dist/index.d.cts

@@ -0,0 +1,130 @@
+import * as _particle_academy_fancy_flow_connectors from '@particle-academy/fancy-flow/connectors';
+import { ConnectorMeta, OutputField } from '@particle-academy/fancy-flow/connectors';
+import { NodeKindDefinition } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * 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's identity on the authoring surface, shared by every Google
+ * Analytics node.
+ *
+ * This file must import nothing from the js package: a PHP or Python project
+ * installs the ui package and never that one, and the import would be a
+ * dangling module the moment it did.
+ *
+ * ## The sandbox trap
+ *
+ * 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.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+/** The parts of a connector's identity that belong to the SERVICE, not the node. */
+declare const GOOGLE_ANALYTICS_SERVICE: {
+    readonly service: "google_analytics";
+    readonly serviceTitle: "Google Analytics";
+    readonly domain: "analytics";
+    readonly sandbox: "none";
+};
+/** The credentials a Google Analytics connection holds. */
+declare const GOOGLE_ANALYTICS_CREDENTIALS: readonly [{
+    readonly key: "clientId";
+    readonly label: "OAuth client ID";
+    readonly scope: "provider";
+    readonly secret: false;
+    readonly help: "From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account.";
+}, {
+    readonly key: "clientSecret";
+    readonly label: "OAuth client secret";
+    readonly scope: "provider";
+    readonly secret: true;
+    readonly help: "The client secret for the same OAuth app. One value for the whole installation.";
+}, {
+    readonly key: "accessToken";
+    readonly label: "Access token";
+    readonly scope: "account";
+    readonly secret: true;
+    readonly help: "Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.";
+}, {
+    readonly key: "refreshToken";
+    readonly label: "Refresh token";
+    readonly scope: "account";
+    readonly secret: true;
+    readonly help: "Per connected Google account. Google issues one only when the consent request asks for offline access.";
+}];
+/**
+ * The OAuth2 exchange Google Analytics requires — DECLARED here, performed by
+ * the host.
+ *
+ * A consent screen needs a browser, a redirect URI and somewhere to persist
+ * the result, and all three belong to the host; a package that ran the dance
+ * itself would have to own a web server. So this says precisely enough for a
+ * host to do it.
+ *
+ * The access token lasts 3600 seconds. A host that never refreshes will work
+ * all afternoon and be broken by morning, which is why the lifetime is stated
+ * rather than left to be discovered.
+ */
+declare const GOOGLE_ANALYTICS_OAUTH: {
+    readonly flow: "authorization_code";
+    readonly authorizeUrl: "https://accounts.google.com/o/oauth2/v2/auth";
+    readonly tokenUrl: "https://oauth2.googleapis.com/token";
+    readonly scopes: readonly ["https://www.googleapis.com/auth/analytics.readonly"];
+    readonly accessTokenCredential: "accessToken";
+    readonly refreshTokenCredential: "refreshToken";
+    readonly accessTokenTtlSeconds: 3600;
+};
+/** Build a Google Analytics node's connector metadata from the operation it performs. */
+declare function googleAnalyticsMeta(role: ConnectorMeta["role"], operation: string, docs: string): ConnectorMeta;
+
+declare const GOOGLE_ANALYTICS_REPORT_KIND = "@particle-academy/google_analytics_report";
+declare const GOOGLE_ANALYTICS_REPORT_OPERATION = "report_run";
+declare const GOOGLE_ANALYTICS_REPORT_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GOOGLE_ANALYTICS_REPORT_OUTPUT: OutputField[];
+declare const googleAnalyticsReportKind: NodeKindDefinition;
+
+/**
+ * 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's node kinds for fancy-flow.
+ *
+ * Install this on every host. The TypeScript executors live in the js
+ * package's `./flow` subpath; PHP and Python hosts run their own and need only
+ * this.
+ */
+
+/** Every Google Analytics kind, for a host that registers the lot. */
+declare const GOOGLE_ANALYTICS_KINDS: NodeKindDefinition[];
+
+export { CONNECTOR_API_VERSION, GOOGLE_ANALYTICS_CREDENTIALS, GOOGLE_ANALYTICS_KINDS, GOOGLE_ANALYTICS_OAUTH, GOOGLE_ANALYTICS_REPORT_KIND, GOOGLE_ANALYTICS_REPORT_META, GOOGLE_ANALYTICS_REPORT_OPERATION, GOOGLE_ANALYTICS_REPORT_OUTPUT, GOOGLE_ANALYTICS_SERVICE, googleAnalyticsMeta, googleAnalyticsReportKind };

package/dist/index.d.ts

@@ -0,0 +1,130 @@
+import * as _particle_academy_fancy_flow_connectors from '@particle-academy/fancy-flow/connectors';
+import { ConnectorMeta, OutputField } from '@particle-academy/fancy-flow/connectors';
+import { NodeKindDefinition } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * 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's identity on the authoring surface, shared by every Google
+ * Analytics node.
+ *
+ * This file must import nothing from the js package: a PHP or Python project
+ * installs the ui package and never that one, and the import would be a
+ * dangling module the moment it did.
+ *
+ * ## The sandbox trap
+ *
+ * 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.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+/** The parts of a connector's identity that belong to the SERVICE, not the node. */
+declare const GOOGLE_ANALYTICS_SERVICE: {
+    readonly service: "google_analytics";
+    readonly serviceTitle: "Google Analytics";
+    readonly domain: "analytics";
+    readonly sandbox: "none";
+};
+/** The credentials a Google Analytics connection holds. */
+declare const GOOGLE_ANALYTICS_CREDENTIALS: readonly [{
+    readonly key: "clientId";
+    readonly label: "OAuth client ID";
+    readonly scope: "provider";
+    readonly secret: false;
+    readonly help: "From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account.";
+}, {
+    readonly key: "clientSecret";
+    readonly label: "OAuth client secret";
+    readonly scope: "provider";
+    readonly secret: true;
+    readonly help: "The client secret for the same OAuth app. One value for the whole installation.";
+}, {
+    readonly key: "accessToken";
+    readonly label: "Access token";
+    readonly scope: "account";
+    readonly secret: true;
+    readonly help: "Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.";
+}, {
+    readonly key: "refreshToken";
+    readonly label: "Refresh token";
+    readonly scope: "account";
+    readonly secret: true;
+    readonly help: "Per connected Google account. Google issues one only when the consent request asks for offline access.";
+}];
+/**
+ * The OAuth2 exchange Google Analytics requires — DECLARED here, performed by
+ * the host.
+ *
+ * A consent screen needs a browser, a redirect URI and somewhere to persist
+ * the result, and all three belong to the host; a package that ran the dance
+ * itself would have to own a web server. So this says precisely enough for a
+ * host to do it.
+ *
+ * The access token lasts 3600 seconds. A host that never refreshes will work
+ * all afternoon and be broken by morning, which is why the lifetime is stated
+ * rather than left to be discovered.
+ */
+declare const GOOGLE_ANALYTICS_OAUTH: {
+    readonly flow: "authorization_code";
+    readonly authorizeUrl: "https://accounts.google.com/o/oauth2/v2/auth";
+    readonly tokenUrl: "https://oauth2.googleapis.com/token";
+    readonly scopes: readonly ["https://www.googleapis.com/auth/analytics.readonly"];
+    readonly accessTokenCredential: "accessToken";
+    readonly refreshTokenCredential: "refreshToken";
+    readonly accessTokenTtlSeconds: 3600;
+};
+/** Build a Google Analytics node's connector metadata from the operation it performs. */
+declare function googleAnalyticsMeta(role: ConnectorMeta["role"], operation: string, docs: string): ConnectorMeta;
+
+declare const GOOGLE_ANALYTICS_REPORT_KIND = "@particle-academy/google_analytics_report";
+declare const GOOGLE_ANALYTICS_REPORT_OPERATION = "report_run";
+declare const GOOGLE_ANALYTICS_REPORT_META: _particle_academy_fancy_flow_connectors.ConnectorMeta;
+/**
+ * What this node emits — the "ingredients" a downstream node can reference.
+ *
+ * fancy-flow reads `outputShape` off the kind and offers it in the variable
+ * picker, so declaring it is the whole of the work: an author configuring the
+ * next node picks `{{ $json.data.id }}` off a list instead of typing a path
+ * and hoping.
+ */
+declare const GOOGLE_ANALYTICS_REPORT_OUTPUT: OutputField[];
+declare const googleAnalyticsReportKind: NodeKindDefinition;
+
+/**
+ * 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's node kinds for fancy-flow.
+ *
+ * Install this on every host. The TypeScript executors live in the js
+ * package's `./flow` subpath; PHP and Python hosts run their own and need only
+ * this.
+ */
+
+/** Every Google Analytics kind, for a host that registers the lot. */
+declare const GOOGLE_ANALYTICS_KINDS: NodeKindDefinition[];
+
+export { CONNECTOR_API_VERSION, GOOGLE_ANALYTICS_CREDENTIALS, GOOGLE_ANALYTICS_KINDS, GOOGLE_ANALYTICS_OAUTH, GOOGLE_ANALYTICS_REPORT_KIND, GOOGLE_ANALYTICS_REPORT_META, GOOGLE_ANALYTICS_REPORT_OPERATION, GOOGLE_ANALYTICS_REPORT_OUTPUT, GOOGLE_ANALYTICS_SERVICE, googleAnalyticsMeta, googleAnalyticsReportKind };

package/dist/index.js

@@ -0,0 +1,138 @@
+import { defineConnectorKind, summarize } from '@particle-academy/fancy-flow/connectors';
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var GOOGLE_ANALYTICS_SERVICE = {
+  service: "google_analytics",
+  serviceTitle: "Google Analytics",
+  domain: "analytics",
+  sandbox: "none"
+};
+var GOOGLE_ANALYTICS_CREDENTIALS = [
+  {
+    "key": "clientId",
+    "label": "OAuth client ID",
+    "scope": "provider",
+    "secret": false,
+    "help": "From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account."
+  },
+  {
+    "key": "clientSecret",
+    "label": "OAuth client secret",
+    "scope": "provider",
+    "secret": true,
+    "help": "The client secret for the same OAuth app. One value for the whole installation."
+  },
+  {
+    "key": "accessToken",
+    "label": "Access token",
+    "scope": "account",
+    "secret": true,
+    "help": "Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token."
+  },
+  {
+    "key": "refreshToken",
+    "label": "Refresh token",
+    "scope": "account",
+    "secret": true,
+    "help": "Per connected Google account. Google issues one only when the consent request asks for offline access."
+  }
+];
+var GOOGLE_ANALYTICS_OAUTH = {
+  "flow": "authorization_code",
+  "authorizeUrl": "https://accounts.google.com/o/oauth2/v2/auth",
+  "tokenUrl": "https://oauth2.googleapis.com/token",
+  "scopes": [
+    "https://www.googleapis.com/auth/analytics.readonly"
+  ],
+  "accessTokenCredential": "accessToken",
+  "refreshTokenCredential": "refreshToken",
+  "accessTokenTtlSeconds": 3600
+};
+function googleAnalyticsMeta(role, operation, docs) {
+  return { ...GOOGLE_ANALYTICS_SERVICE, role, operation, docs };
+}
+var GOOGLE_ANALYTICS_REPORT_KIND = "@particle-academy/google_analytics_report";
+var GOOGLE_ANALYTICS_REPORT_OPERATION = "report_run";
+var GOOGLE_ANALYTICS_REPORT_META = googleAnalyticsMeta("action", "run a report", "https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport");
+var GOOGLE_ANALYTICS_REPORT_OUTPUT = [
+  {
+    "path": "data.rows",
+    "type": "array",
+    "description": "One entry per combination of dimension values. Each carries dimensionValues and metricValues, in the order requested."
+  },
+  {
+    "path": "data.rowCount",
+    "type": "number",
+    "description": "Total rows matching the query, which can exceed the rows returned."
+  },
+  {
+    "path": "data.metricHeaders",
+    "type": "array",
+    "description": "The metrics in the order their values appear in each row -- the only thing that says which number is which."
+  }
+];
+var googleAnalyticsReportKind = defineConnectorKind(GOOGLE_ANALYTICS_REPORT_META, {
+  name: GOOGLE_ANALYTICS_REPORT_KIND,
+  aliases: ["google_analytics_report"],
+  label: "Google Analytics report",
+  description: "Run a report against a Google Analytics 4 property.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GOOGLE_ANALYTICS_REPORT_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "property",
+      "label": "Property",
+      "required": true,
+      "default": "properties/",
+      "description": "The GA4 property, written as `properties/1234567890`. The numeric id alone is not accepted."
+    },
+    {
+      "type": "text",
+      "key": "startDate",
+      "label": "Start date",
+      "required": true,
+      "default": "28daysAgo",
+      "description": "YYYY-MM-DD, or a relative form Google accepts such as `28daysAgo`, `yesterday` or `today`."
+    },
+    {
+      "type": "text",
+      "key": "endDate",
+      "label": "End date",
+      "required": true,
+      "default": "today",
+      "description": "YYYY-MM-DD, or a relative form such as `today`."
+    },
+    {
+      "type": "text",
+      "key": "metrics",
+      "label": "Metrics",
+      "required": true,
+      "default": "activeUsers,sessions",
+      "description": "Metric names, comma separated. For example activeUsers, sessions, screenPageViews."
+    },
+    {
+      "type": "text",
+      "key": "dimensions",
+      "label": "Dimensions",
+      "default": "date",
+      "description": "Dimension names, comma separated. For example date, country, pagePath. Leave empty for a single total row."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => summarize(GOOGLE_ANALYTICS_REPORT_META, config, "run a report")
+});
+
+// src/index.ts
+var GOOGLE_ANALYTICS_KINDS = [
+  googleAnalyticsReportKind
+];
+
+export { CONNECTOR_API_VERSION, GOOGLE_ANALYTICS_CREDENTIALS, GOOGLE_ANALYTICS_KINDS, GOOGLE_ANALYTICS_OAUTH, GOOGLE_ANALYTICS_REPORT_KIND, GOOGLE_ANALYTICS_REPORT_META, GOOGLE_ANALYTICS_REPORT_OPERATION, GOOGLE_ANALYTICS_REPORT_OUTPUT, GOOGLE_ANALYTICS_SERVICE, googleAnalyticsMeta, googleAnalyticsReportKind };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/service.ts","../src/kinds/report-run.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\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's identity on the authoring surface, shared by every Google\n * Analytics node.\n *\n * This file must import nothing from the js package: a PHP or Python project\n * installs the ui package and never that one, and the import would be a\n * dangling module the moment it did.\n *\n * ## The sandbox trap\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 { ConnectorMeta } from \"@particle-academy/fancy-flow/connectors\";\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.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\n/** The parts of a connector's identity that belong to the SERVICE, not the node. */\nexport const GOOGLE_ANALYTICS_SERVICE = {\n  service: \"google_analytics\",\n  serviceTitle: \"Google Analytics\",\n  domain: \"analytics\",\n  sandbox: \"none\",\n} as const satisfies Pick<ConnectorMeta, \"service\" | \"serviceTitle\" | \"domain\" | \"sandbox\">;\n\n/** The credentials a Google Analytics connection holds. */\nexport const GOOGLE_ANALYTICS_CREDENTIALS = [\n  {\n    \"key\": \"clientId\",\n    \"label\": \"OAuth client ID\",\n    \"scope\": \"provider\",\n    \"secret\": false,\n    \"help\": \"From Google Cloud Console -> APIs & Services -> Credentials. ONE value for the whole installation, not per connected account.\"\n  },\n  {\n    \"key\": \"clientSecret\",\n    \"label\": \"OAuth client secret\",\n    \"scope\": \"provider\",\n    \"secret\": true,\n    \"help\": \"The client secret for the same OAuth app. One value for the whole installation.\"\n  },\n  {\n    \"key\": \"accessToken\",\n    \"label\": \"Access token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.\"\n  },\n  {\n    \"key\": \"refreshToken\",\n    \"label\": \"Refresh token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account. Google issues one only when the consent request asks for offline access.\"\n  }\n] as const;\n\n/**\n * The OAuth2 exchange Google Analytics requires — DECLARED here, performed by\n * the host.\n *\n * A consent screen needs a browser, a redirect URI and somewhere to persist\n * the result, and all three belong to the host; a package that ran the dance\n * itself would have to own a web server. So this says precisely enough for a\n * host to do it.\n *\n * The access token lasts 3600 seconds. A host that never refreshes will work\n * all afternoon and be broken by morning, which is why the lifetime is stated\n * rather than left to be discovered.\n */\nexport const GOOGLE_ANALYTICS_OAUTH = {\n  \"flow\": \"authorization_code\",\n  \"authorizeUrl\": \"https://accounts.google.com/o/oauth2/v2/auth\",\n  \"tokenUrl\": \"https://oauth2.googleapis.com/token\",\n  \"scopes\": [\n    \"https://www.googleapis.com/auth/analytics.readonly\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Google Analytics node's connector metadata from the operation it performs. */\nexport function googleAnalyticsMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GOOGLE_ANALYTICS_SERVICE, role, operation, docs };\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 * Google Analytics report — Run a report against a Google Analytics 4\n * property.\n *\n * https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { googleAnalyticsMeta } from \"../service.js\";\n\nexport const GOOGLE_ANALYTICS_REPORT_KIND = \"@particle-academy/google_analytics_report\";\nexport const GOOGLE_ANALYTICS_REPORT_OPERATION = \"report_run\";\n\nexport const GOOGLE_ANALYTICS_REPORT_META = googleAnalyticsMeta(\"action\", \"run a report\", \"https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GOOGLE_ANALYTICS_REPORT_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.rows\",\n    \"type\": \"array\",\n    \"description\": \"One entry per combination of dimension values. Each carries dimensionValues and metricValues, in the order requested.\"\n  },\n  {\n    \"path\": \"data.rowCount\",\n    \"type\": \"number\",\n    \"description\": \"Total rows matching the query, which can exceed the rows returned.\"\n  },\n  {\n    \"path\": \"data.metricHeaders\",\n    \"type\": \"array\",\n    \"description\": \"The metrics in the order their values appear in each row -- the only thing that says which number is which.\"\n  }\n];\n\nexport const googleAnalyticsReportKind: NodeKindDefinition = defineConnectorKind(GOOGLE_ANALYTICS_REPORT_META, {\n  name: GOOGLE_ANALYTICS_REPORT_KIND,\n  aliases: [\"google_analytics_report\"],\n  label: \"Google Analytics report\",\n  description: \"Run a report against a Google Analytics 4 property.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GOOGLE_ANALYTICS_REPORT_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"property\",\n      \"label\": \"Property\",\n      \"required\": true,\n      \"default\": \"properties/\",\n      \"description\": \"The GA4 property, written as `properties/1234567890`. The numeric id alone is not accepted.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"startDate\",\n      \"label\": \"Start date\",\n      \"required\": true,\n      \"default\": \"28daysAgo\",\n      \"description\": \"YYYY-MM-DD, or a relative form Google accepts such as `28daysAgo`, `yesterday` or `today`.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"endDate\",\n      \"label\": \"End date\",\n      \"required\": true,\n      \"default\": \"today\",\n      \"description\": \"YYYY-MM-DD, or a relative form such as `today`.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"metrics\",\n      \"label\": \"Metrics\",\n      \"required\": true,\n      \"default\": \"activeUsers,sessions\",\n      \"description\": \"Metric names, comma separated. For example activeUsers, sessions, screenPageViews.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"dimensions\",\n      \"label\": \"Dimensions\",\n      \"default\": \"date\",\n      \"description\": \"Dimension names, comma separated. For example date, country, pagePath. Leave empty for a single total row.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GOOGLE_ANALYTICS_REPORT_META, config as Record<string, unknown>, \"run a report\"),\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's node kinds for fancy-flow.\n *\n * Install this on every host. The TypeScript executors live in the js\n * package's `./flow` subpath; PHP and Python hosts run their own and need only\n * this.\n */\n\nexport * from \"./service.js\";\nexport * from \"./kinds/report-run.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { googleAnalyticsReportKind } from \"./kinds/report-run.js\";\n\n/** Every Google Analytics kind, for a host that registers the lot. */\nexport const GOOGLE_ANALYTICS_KINDS: NodeKindDefinition[] = [\n  googleAnalyticsReportKind,\n];\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@particle-academy/google-analytics-ui",
+  "version": "0.1.0",
+  "description": "Google Analytics's authoring surface for fancy-flow — the node kinds, their config schemas and their declared output shapes. React on every host; carries no executor.",
+  "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"
+      }
+    },
+    "./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": {},
+  "peerDependencies": {
+    "@particle-academy/fancy-flow": ">=0.48.0 <2.0"
+  },
+  "devDependencies": {
+    "@particle-academy/fancy-flow": ">=0.48.0 <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",
+    "fancy-flow",
+    "fancy-ui",
+    "particle-academy"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  }
+}