@farming-labs/docs 0.2.60 → 0.2.62
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/README.md +1 -1
- package/package.json +11 -1
- package/dist/agent-BFqyqEnC.mjs +0 -4547
- package/dist/agent-DlxriaTs.mjs +0 -624
- package/dist/agent-evals-kJs2Y9xR.mjs +0 -2144
- package/dist/agent-export-BgUaiW8f.mjs +0 -869
- package/dist/agent-scope-CCaIY1aK.mjs +0 -283
- package/dist/agents-Djh-HXih.mjs +0 -219
- package/dist/analytics-Bx44lg6d.mjs +0 -177
- package/dist/cli/index.d.mts +0 -15
- package/dist/cli/index.mjs +0 -452
- package/dist/client/react.d.mts +0 -45
- package/dist/client/react.mjs +0 -223
- package/dist/cloud-BH_sHX64.mjs +0 -1615
- package/dist/cloud-analytics-CSyFE6SS.mjs +0 -132
- package/dist/cloud-ask-ai-B2WnG4fF.d.mts +0 -23
- package/dist/cloud-ask-ai-hnJfj8-X.mjs +0 -382
- package/dist/code-blocks-qe0T8-xe.mjs +0 -871
- package/dist/codeblocks-Bq67u32v.mjs +0 -250
- package/dist/config-DASewQ0x.mjs +0 -363
- package/dist/dev-DgY5xGl9.mjs +0 -1333
- package/dist/docs-cloud-server.d.mts +0 -70
- package/dist/docs-cloud-server.mjs +0 -310
- package/dist/doctor-CO1VMcF_.mjs +0 -1906
- package/dist/downgrade-BZs86NVr.mjs +0 -184
- package/dist/errors-CVqZ3kOO.mjs +0 -20
- package/dist/golden-evaluations-BN9u2wxw.mjs +0 -1483
- package/dist/i18n-CAlj1ADU.mjs +0 -40
- package/dist/index.d.mts +0 -1099
- package/dist/index.mjs +0 -9
- package/dist/init-Bd_k06bR.mjs +0 -1233
- package/dist/mcp-B_yXL5G5.mjs +0 -137
- package/dist/mcp.d.mts +0 -287
- package/dist/mcp.mjs +0 -4135
- package/dist/metadata-BDuewuzq.mjs +0 -237
- package/dist/package-version-qik_4J6C.mjs +0 -128
- package/dist/reading-time-BkEft6SD.mjs +0 -741
- package/dist/review-NC-sOdXn.mjs +0 -665
- package/dist/robots-DskPvGPw.mjs +0 -178
- package/dist/robots-ltltiLJF.mjs +0 -197
- package/dist/search-C1JitPwi.d.mts +0 -397
- package/dist/search-D57JXQLj.mjs +0 -1758
- package/dist/search-o4Ud6OXv.mjs +0 -102
- package/dist/server.d.mts +0 -341
- package/dist/server.mjs +0 -11
- package/dist/sitemap-Cq-Yj_iA.mjs +0 -247
- package/dist/sitemap-server-C1ibVKOy.mjs +0 -1137
- package/dist/templates-DNw15P-x.mjs +0 -2373
- package/dist/types-XHABMh_f.d.mts +0 -3248
- package/dist/upgrade-BCJTCW3O.mjs +0 -56
- package/dist/utils-6UCLxv4B.mjs +0 -225
package/dist/client/react.mjs
DELETED
|
@@ -1,223 +0,0 @@
|
|
|
1
|
-
"use client";
|
|
2
|
-
|
|
3
|
-
import { n as sendDocsCloudAnalyticsEvent } from "../cloud-analytics-CSyFE6SS.mjs";
|
|
4
|
-
import { useEffect } from "react";
|
|
5
|
-
|
|
6
|
-
//#region src/docs-cloud-client.ts
|
|
7
|
-
const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";
|
|
8
|
-
const DOCS_CLOUD_PROJECT_ID_ENVS = [
|
|
9
|
-
"NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID",
|
|
10
|
-
"PUBLIC_DOCS_CLOUD_PROJECT_ID",
|
|
11
|
-
"DOCS_CLOUD_PROJECT_ID"
|
|
12
|
-
];
|
|
13
|
-
const DOCS_CLOUD_API_BASE_URL_ENVS = [
|
|
14
|
-
"NEXT_PUBLIC_DOCS_CLOUD_URL",
|
|
15
|
-
"PUBLIC_DOCS_CLOUD_URL",
|
|
16
|
-
"DOCS_CLOUD_API_BASE_URL",
|
|
17
|
-
"DOCS_CLOUD_API_URL"
|
|
18
|
-
];
|
|
19
|
-
const DOCS_CLOUD_ANALYTICS_ENDPOINT_ENVS = [
|
|
20
|
-
"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT",
|
|
21
|
-
"PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT",
|
|
22
|
-
"DOCS_CLOUD_ANALYTICS_ENDPOINT"
|
|
23
|
-
];
|
|
24
|
-
const DOCS_CLOUD_ANALYTICS_ENABLED_ENVS = [
|
|
25
|
-
"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED",
|
|
26
|
-
"PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED",
|
|
27
|
-
"DOCS_CLOUD_ANALYTICS_ENABLED"
|
|
28
|
-
];
|
|
29
|
-
const DOCS_CLOUD_ANALYTICS_KEY_ENVS = [
|
|
30
|
-
"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY",
|
|
31
|
-
"PUBLIC_DOCS_CLOUD_ANALYTICS_KEY",
|
|
32
|
-
"DOCS_CLOUD_ANALYTICS_KEY"
|
|
33
|
-
];
|
|
34
|
-
function normalizeRuntimeString(value) {
|
|
35
|
-
return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
|
|
36
|
-
}
|
|
37
|
-
function resolveRuntimeValue(value) {
|
|
38
|
-
return (typeof value === "function" ? value() : value) ?? void 0;
|
|
39
|
-
}
|
|
40
|
-
function resolveRuntimeString(value) {
|
|
41
|
-
return normalizeRuntimeString(resolveRuntimeValue(value));
|
|
42
|
-
}
|
|
43
|
-
function resolveRuntimeEnv(env) {
|
|
44
|
-
return typeof env === "function" ? env() : env ?? {};
|
|
45
|
-
}
|
|
46
|
-
function readProcessEnv(name) {
|
|
47
|
-
if (typeof process === "undefined") return void 0;
|
|
48
|
-
if (!process.env) return void 0;
|
|
49
|
-
switch (name) {
|
|
50
|
-
case "NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID);
|
|
51
|
-
case "NEXT_PUBLIC_DOCS_CLOUD_URL": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_URL);
|
|
52
|
-
case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT);
|
|
53
|
-
case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED);
|
|
54
|
-
case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY);
|
|
55
|
-
default: return;
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
function readEnv(name, env) {
|
|
59
|
-
return normalizeRuntimeString(env[name]) ?? readProcessEnv(name);
|
|
60
|
-
}
|
|
61
|
-
function readFirstEnv(names, env) {
|
|
62
|
-
for (const name of names) {
|
|
63
|
-
const value = readEnv(name, env);
|
|
64
|
-
if (value) return value;
|
|
65
|
-
}
|
|
66
|
-
}
|
|
67
|
-
function isFalsy(value) {
|
|
68
|
-
if (value === false) return true;
|
|
69
|
-
if (typeof value !== "string") return false;
|
|
70
|
-
return /^(0|false|no|off)$/i.test(value.trim());
|
|
71
|
-
}
|
|
72
|
-
function stripTrailingSlash(value) {
|
|
73
|
-
return value.replace(/\/+$/, "");
|
|
74
|
-
}
|
|
75
|
-
function mergeRecords(...records) {
|
|
76
|
-
const merged = {};
|
|
77
|
-
for (const record of records) {
|
|
78
|
-
if (!record) continue;
|
|
79
|
-
Object.assign(merged, record);
|
|
80
|
-
}
|
|
81
|
-
return Object.keys(merged).length > 0 ? merged : void 0;
|
|
82
|
-
}
|
|
83
|
-
function getBrowserLocation() {
|
|
84
|
-
return typeof window !== "undefined" ? window.location : void 0;
|
|
85
|
-
}
|
|
86
|
-
function getBrowserReferrer() {
|
|
87
|
-
if (typeof document === "undefined") return void 0;
|
|
88
|
-
return document.referrer || void 0;
|
|
89
|
-
}
|
|
90
|
-
function createDocsCloudClient(options = {}) {
|
|
91
|
-
function env() {
|
|
92
|
-
return resolveRuntimeEnv(options.env);
|
|
93
|
-
}
|
|
94
|
-
function projectId() {
|
|
95
|
-
const runtimeEnv = env();
|
|
96
|
-
return resolveRuntimeString(options.projectId) ?? readFirstEnv(DOCS_CLOUD_PROJECT_ID_ENVS, runtimeEnv);
|
|
97
|
-
}
|
|
98
|
-
function apiBaseUrl() {
|
|
99
|
-
const runtimeEnv = env();
|
|
100
|
-
return stripTrailingSlash(resolveRuntimeString(options.apiBaseUrl) ?? readFirstEnv(DOCS_CLOUD_API_BASE_URL_ENVS, runtimeEnv) ?? DEFAULT_DOCS_CLOUD_API_BASE_URL);
|
|
101
|
-
}
|
|
102
|
-
function endpoint() {
|
|
103
|
-
const runtimeEnv = env();
|
|
104
|
-
return resolveRuntimeString(options.endpoint) ?? resolveRuntimeString(options.analyticsEndpoint) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_ENDPOINT_ENVS, runtimeEnv) ?? `${apiBaseUrl()}/v1/analytics/events`;
|
|
105
|
-
}
|
|
106
|
-
function analyticsKey() {
|
|
107
|
-
const runtimeEnv = env();
|
|
108
|
-
return resolveRuntimeString(options.analyticsKey) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_KEY_ENVS, runtimeEnv);
|
|
109
|
-
}
|
|
110
|
-
function enabled() {
|
|
111
|
-
const runtimeEnv = env();
|
|
112
|
-
return !isFalsy(resolveRuntimeValue(options.enabled) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_ENABLED_ENVS, runtimeEnv));
|
|
113
|
-
}
|
|
114
|
-
function includeInputs() {
|
|
115
|
-
return resolveRuntimeValue(options.includeInputs) === true;
|
|
116
|
-
}
|
|
117
|
-
function getConfig() {
|
|
118
|
-
const id = projectId();
|
|
119
|
-
return {
|
|
120
|
-
enabled: enabled(),
|
|
121
|
-
configured: Boolean(id),
|
|
122
|
-
...id ? { projectId: id } : {},
|
|
123
|
-
endpoint: endpoint()
|
|
124
|
-
};
|
|
125
|
-
}
|
|
126
|
-
async function trackEvent(event, trackOptions = {}) {
|
|
127
|
-
const config = getConfig();
|
|
128
|
-
if (!config.enabled || !config.projectId) return false;
|
|
129
|
-
const location = getBrowserLocation();
|
|
130
|
-
const normalized = {
|
|
131
|
-
...event,
|
|
132
|
-
source: event.source ?? "client",
|
|
133
|
-
timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
|
|
134
|
-
url: event.url ?? location?.href,
|
|
135
|
-
path: event.path ?? location?.pathname,
|
|
136
|
-
referrer: event.referrer ?? getBrowserReferrer(),
|
|
137
|
-
locale: event.locale ?? trackOptions.locale,
|
|
138
|
-
metadata: mergeRecords(options.metadata, trackOptions.metadata, event.metadata),
|
|
139
|
-
properties: mergeRecords(options.properties, trackOptions.properties, event.properties)
|
|
140
|
-
};
|
|
141
|
-
if (!includeInputs()) delete normalized.input;
|
|
142
|
-
await sendDocsCloudAnalyticsEvent({
|
|
143
|
-
endpoint: config.endpoint,
|
|
144
|
-
projectId: config.projectId,
|
|
145
|
-
apiKey: analyticsKey(),
|
|
146
|
-
fetch: options.fetch
|
|
147
|
-
}, normalized);
|
|
148
|
-
return true;
|
|
149
|
-
}
|
|
150
|
-
return {
|
|
151
|
-
analytics: { track: trackEvent },
|
|
152
|
-
trackEvent,
|
|
153
|
-
getConfig,
|
|
154
|
-
isConfigured() {
|
|
155
|
-
const config = getConfig();
|
|
156
|
-
return config.enabled && config.configured;
|
|
157
|
-
}
|
|
158
|
-
};
|
|
159
|
-
}
|
|
160
|
-
|
|
161
|
-
//#endregion
|
|
162
|
-
//#region src/client/react.ts
|
|
163
|
-
function isDocsCloudAnalyticsDisabled(analytics, enabled) {
|
|
164
|
-
return Boolean(enabled === false || analytics === false || analytics && typeof analytics === "object" && (analytics.enabled === false || analytics.cloud === false));
|
|
165
|
-
}
|
|
166
|
-
function callAnalyticsHandler(handler, event) {
|
|
167
|
-
if (!handler) return;
|
|
168
|
-
try {
|
|
169
|
-
Promise.resolve(handler(event)).catch(() => {});
|
|
170
|
-
} catch {}
|
|
171
|
-
}
|
|
172
|
-
function DocsCloudAnalytics({ analytics, children, projectId, endpoint, analyticsEndpoint, apiBaseUrl, analyticsKey, enabled, includeInputs, env, fetch, metadata, properties }) {
|
|
173
|
-
useEffect(() => {
|
|
174
|
-
if (typeof window === "undefined") return;
|
|
175
|
-
if (isDocsCloudAnalyticsDisabled(analytics, enabled)) return;
|
|
176
|
-
const client = createDocsCloudClient({
|
|
177
|
-
projectId,
|
|
178
|
-
endpoint,
|
|
179
|
-
analyticsEndpoint,
|
|
180
|
-
apiBaseUrl,
|
|
181
|
-
analyticsKey,
|
|
182
|
-
enabled,
|
|
183
|
-
includeInputs: includeInputs ?? (typeof analytics === "object" && analytics.includeInputs === true),
|
|
184
|
-
env,
|
|
185
|
-
fetch,
|
|
186
|
-
metadata,
|
|
187
|
-
properties
|
|
188
|
-
});
|
|
189
|
-
if (!client.isConfigured()) return;
|
|
190
|
-
const target = window;
|
|
191
|
-
const previous = target.__fdAnalytics__;
|
|
192
|
-
const handler = (event) => {
|
|
193
|
-
callAnalyticsHandler(previous, event);
|
|
194
|
-
client.trackEvent(event).catch(() => {});
|
|
195
|
-
};
|
|
196
|
-
target.__fdAnalytics__ = handler;
|
|
197
|
-
const queued = target.__fdAnalyticsQueue__ ?? [];
|
|
198
|
-
delete target.__fdAnalyticsQueue__;
|
|
199
|
-
for (const event of queued) handler(event);
|
|
200
|
-
return () => {
|
|
201
|
-
if (target.__fdAnalytics__ === handler) if (typeof previous === "function") target.__fdAnalytics__ = previous;
|
|
202
|
-
else delete target.__fdAnalytics__;
|
|
203
|
-
};
|
|
204
|
-
}, [
|
|
205
|
-
analytics,
|
|
206
|
-
analyticsEndpoint,
|
|
207
|
-
analyticsKey,
|
|
208
|
-
apiBaseUrl,
|
|
209
|
-
enabled,
|
|
210
|
-
endpoint,
|
|
211
|
-
env,
|
|
212
|
-
fetch,
|
|
213
|
-
includeInputs,
|
|
214
|
-
metadata,
|
|
215
|
-
projectId,
|
|
216
|
-
properties
|
|
217
|
-
]);
|
|
218
|
-
return children ?? null;
|
|
219
|
-
}
|
|
220
|
-
const DocsCloudAnalyticsProvider = DocsCloudAnalytics;
|
|
221
|
-
|
|
222
|
-
//#endregion
|
|
223
|
-
export { DocsCloudAnalytics, DocsCloudAnalyticsProvider };
|