@apteva/integrations 0.3.19 → 0.3.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@apteva/integrations",
3
- "version": "0.3.19",
3
+ "version": "0.3.20",
4
4
  "description": "Local integrations, connections, and webhooks for Apteva. Self-contained app templates, OAuth engine, and trigger provider.",
5
5
  "author": "Apteva <hello@apteva.com>",
6
6
  "license": "Elastic-2.0",
@@ -33,23 +33,17 @@
33
33
  "tools": [
34
34
  {
35
35
  "name": "list_sources",
36
- "description": "Get available analytics sources (web, patreon, youtube, stripe, etc.) and their metrics. Shows which sources have data and summary statistics.",
36
+ "description": "ALWAYS call this first before importing or querying metrics. Returns all configured analytics sources with their available metric names, including sources without data yet. The response contains the exact metric_name values needed for import-metrics and query-metrics. Sources with has_data=false still have valid metrics that can be imported into.",
37
37
  "method": "GET",
38
38
  "path": "/analytics/sources",
39
39
  "input_schema": {
40
40
  "type": "object",
41
- "properties": {
42
- "include_empty": {
43
- "type": "boolean",
44
- "description": "Include sources without data (shows all configured sources)",
45
- "default": true
46
- }
47
- }
41
+ "properties": {}
48
42
  }
49
43
  },
50
44
  {
51
45
  "name": "import_metrics",
52
- "description": "Import external/platform-specific metrics directly. Supports single metric or bulk import. Use for YouTube views, Patreon patrons, social media stats, etc.",
46
+ "description": "Import metrics data. First call list-sources to discover the exact metric_name values available for each source. Supports single metric or bulk import via the metrics array.",
53
47
  "method": "POST",
54
48
  "path": "/analytics/metrics/import",
55
49
  "input_schema": {
@@ -57,7 +51,7 @@
57
51
  "properties": {
58
52
  "metric_name": {
59
53
  "type": "string",
60
- "description": "Metric name for single import (e.g., 'youtube_views', 'patreon_patrons')"
54
+ "description": "Metric name for single import - use exact values from list-sources"
61
55
  },
62
56
  "value": {
63
57
  "type": "number",
@@ -83,7 +77,7 @@
83
77
  },
84
78
  "source": {
85
79
  "type": "string",
86
- "description": "Source platform (e.g., 'youtube', 'patreon', 'twitter', 'instagram', 'stripe')"
80
+ "description": "Source platform identifier - use the source id from list-sources"
87
81
  },
88
82
  "dimensions": {
89
83
  "type": "object",
@@ -133,7 +127,7 @@
133
127
  },
134
128
  {
135
129
  "name": "query_metrics",
136
- "description": "Query pre-aggregated metrics data with flexible filtering, grouping, and date ranges. Returns time-series data for charts and reports.",
130
+ "description": "Query metrics data with flexible filtering, grouping, and date ranges. First call list-sources to discover available metric_name values. Returns time-series data for charts and reports.",
137
131
  "method": "GET",
138
132
  "path": "/analytics/metrics/{metric_name}",
139
133
  "input_schema": {