@tool-bridge/server 0.21.1 → 0.22.1

package/dist/umami-42RS2EPS.js

@@ -0,0 +1,389 @@
+import {
+  createAuthedClient
+} from "./chunk-RTW5VRTK.js";
+import "./chunk-BNMLA2RC.js";
+import {
+  asJsonObject,
+  trimmedText
+} from "./chunk-JXHMDBAY.js";
+import {
+  createProviderPlugin,
+  upstreamError
+} from "./chunk-X7ZUTKHR.js";
+import "./chunk-7ISGFRC6.js";
+import "./chunk-UY6ANCOY.js";
+import {
+  TBError
+} from "./chunk-HA4BGL6C.js";
+import "./chunk-U67V476Y.js";
+
+// ../plugins/src/umami/api.ts
+var SERVICE = "umami";
+var API_BASE = "https://api.umami.is";
+var http = createAuthedClient({
+  baseUrl: `${API_BASE}/`,
+  service: SERVICE,
+  auth: { kind: "bearer" },
+  headers: { accept: "application/json" },
+  errorMessage: {
+    // 错误消息藏在 `error`(字符串或对象)与 `message` 三处之一,纯文本体则整段拿来用。
+    keys: ["error", "error.message", "message"],
+    fallback: (status, statusText) => statusText || `umami \u8FD4\u56DE HTTP ${status}`
+  },
+  mapTransportError: ({ message }) => upstreamError(
+    502,
+    message === void 0 ? "umami \u8BF7\u6C42\u5931\u8D25" : `umami \u8BF7\u6C42\u5931\u8D25: ${message}`
+  )
+});
+function requiredText(value, field) {
+  const text = trimmedText(value);
+  if (text === void 0) throw new TBError("invalid_argument", `${field} \u4E0D\u80FD\u4E3A\u7A7A`);
+  return text;
+}
+async function request(ctx, path, query = {}) {
+  const response = await http.request(ctx, {
+    path,
+    query: Object.entries(query),
+    invalidJson: "text"
+  });
+  if (response.bodyKind === "invalid-json") throw upstreamError(502, "umami \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94");
+  return response.bodyKind === "empty" ? null : response.data;
+}
+function responseRecord(value, field) {
+  const object = asJsonObject(value);
+  if (object === void 0) throw upstreamError(502, `umami \u54CD\u5E94\u7684 ${field} \u4E0D\u662F\u5BF9\u8C61`);
+  return object;
+}
+function responseArray(value, field) {
+  if (!Array.isArray(value)) throw upstreamError(502, `umami \u54CD\u5E94\u7684 ${field} \u4E0D\u662F\u6570\u7EC4`);
+  return value;
+}
+function objectArray(value, field) {
+  return responseArray(value, field).map((item) => responseRecord(item, `${field} \u5217\u8868\u9879`));
+}
+function responseInteger(value, field, min) {
+  if (typeof value !== "number" || !Number.isInteger(value) || value < min) {
+    throw upstreamError(502, `umami \u54CD\u5E94\u7684 ${field} \u4E0D\u662F\u5408\u6CD5\u6574\u6570`);
+  }
+  return value;
+}
+function dateRangeQuery(input) {
+  return {
+    startAt: String(input.startAt),
+    endAt: String(input.endAt),
+    timezone: requiredText(input.timezone, "timezone"),
+    url: trimmedText(input.url),
+    referrer: trimmedText(input.referrer),
+    title: trimmedText(input.title),
+    host: trimmedText(input.host),
+    os: trimmedText(input.os),
+    browser: trimmedText(input.browser),
+    device: trimmedText(input.device),
+    country: trimmedText(input.country),
+    region: trimmedText(input.region),
+    city: trimmedText(input.city)
+  };
+}
+function websitePath(websiteId, suffix = "") {
+  return `/api/websites/${encodeURIComponent(requiredText(websiteId, "websiteId"))}${suffix}`;
+}
+function paginated(payload, listKey) {
+  const envelope = responseRecord(payload, "\u5206\u9875");
+  return {
+    [listKey]: objectArray(envelope.data, "data"),
+    count: responseInteger(envelope.count, "count", 0),
+    page: responseInteger(envelope.page, "page", 1),
+    pageSize: responseInteger(envelope.pageSize, "pageSize", 1),
+    raw: envelope
+  };
+}
+async function getCurrentUser(_input, ctx) {
+  const user = responseRecord(await request(ctx, "/api/me"), "user");
+  return { user, raw: user };
+}
+async function listWebsites(input, ctx) {
+  const payload = await request(ctx, "/api/websites", {
+    query: trimmedText(input.query),
+    page: input.page === void 0 ? void 0 : String(input.page),
+    pageSize: input.pageSize === void 0 ? void 0 : String(input.pageSize)
+  });
+  return paginated(payload, "websites");
+}
+async function getWebsite(input, ctx) {
+  const website = responseRecord(await request(ctx, websitePath(input.websiteId)), "website");
+  return { website, raw: website };
+}
+async function getWebsiteStats(input, ctx) {
+  const path = websitePath(input.websiteId, "/stats");
+  const stats = responseRecord(await request(ctx, path, dateRangeQuery(input)), "stats");
+  return { stats, raw: stats };
+}
+async function getPageviews(input, ctx) {
+  const path = websitePath(input.websiteId, "/pageviews");
+  const query = { ...dateRangeQuery(input), unit: trimmedText(input.unit) };
+  const pageviews = responseRecord(await request(ctx, path, query), "pageviews");
+  return { pageviews, raw: pageviews };
+}
+async function getMetrics(input, ctx) {
+  const path = websitePath(input.websiteId, "/metrics");
+  const query = {
+    ...dateRangeQuery(input),
+    type: requiredText(input.type, "type"),
+    limit: input.limit === void 0 ? void 0 : String(input.limit)
+  };
+  const payload = await request(ctx, path, query);
+  return { metrics: objectArray(payload, "metrics"), raw: responseArray(payload, "metrics") };
+}
+async function getRealtime(input, ctx) {
+  const path = `/api/realtime/${encodeURIComponent(requiredText(input.websiteId, "websiteId"))}`;
+  const realtime = responseRecord(await request(ctx, path), "realtime");
+  return { realtime, raw: realtime };
+}
+async function listEvents(input, ctx) {
+  const path = websitePath(input.websiteId, "/events");
+  const query = {
+    ...dateRangeQuery(input),
+    query: trimmedText(input.query),
+    page: input.page === void 0 ? void 0 : String(input.page),
+    pageSize: input.pageSize === void 0 ? void 0 : String(input.pageSize)
+  };
+  return paginated(await request(ctx, path, query), "events");
+}
+
+// ../plugins/src/umami/schema.ts
+import { z } from "zod/v4";
+var getCurrentUserInput = z.strictObject({}).describe("No input is required to get the current Umami user.");
+var getCurrentUserOutput = z.strictObject({
+  user: z.looseObject({
+    id: z.string().describe("User ID.").optional(),
+    username: z.string().describe("Username.").optional(),
+    role: z.string().describe("User role.").optional(),
+    isAdmin: z.boolean().describe("Whether the user has administrator privileges.").optional()
+  }).describe("Umami user profile."),
+  raw: z.looseObject({}).describe("Raw Umami response payload.")
+}).describe("Current Umami user response.");
+var listWebsitesInput = z.strictObject({
+  query: z.string().describe("Search query filter for the endpoint.").optional(),
+  page: z.int().min(1).describe("One-based page number for paginated Umami endpoints.").optional(),
+  pageSize: z.int().min(1).describe("Number of items to return per page.").optional()
+}).describe("Optional pagination and search parameters for listing Umami websites.");
+var listWebsitesOutput = z.strictObject({
+  websites: z.array(z.looseObject({
+    id: z.string().describe("Website ID.").optional(),
+    name: z.string().describe("Website name.").optional(),
+    domain: z.string().describe("Website domain.").optional(),
+    shareId: z.string().describe("Public share ID when sharing is enabled.").nullable().optional()
+  }).describe("Umami website.")).describe("Websites returned by Umami."),
+  count: z.int().min(0).describe("Total number of websites matching the query."),
+  page: z.int().min(1).describe("Current page number."),
+  pageSize: z.int().min(1).describe("Page size used by Umami."),
+  raw: z.looseObject({
+    data: z.array(z.looseObject({
+      id: z.string().describe("Website ID.").optional(),
+      name: z.string().describe("Website name.").optional(),
+      domain: z.string().describe("Website domain.").optional(),
+      shareId: z.string().describe("Public share ID when sharing is enabled.").nullable().optional()
+    }).describe("Umami website.")).describe("Websites returned by Umami.").optional(),
+    count: z.int().min(0).describe("Total number of websites matching the query.").optional(),
+    page: z.int().min(1).describe("Current page number.").optional(),
+    pageSize: z.int().min(1).describe("Page size used by Umami.").optional()
+  }).describe("Paginated Umami websites response.")
+}).describe("Umami website list response.");
+var getWebsiteInput = z.strictObject({
+  websiteId: z.string().min(1).describe("The Umami website ID.")
+}).describe("Request parameters for retrieving an Umami website.");
+var getWebsiteOutput = z.strictObject({
+  website: z.looseObject({
+    id: z.string().describe("Website ID.").optional(),
+    name: z.string().describe("Website name.").optional(),
+    domain: z.string().describe("Website domain.").optional(),
+    shareId: z.string().describe("Public share ID when sharing is enabled.").nullable().optional()
+  }).describe("Umami website."),
+  raw: z.looseObject({}).describe("Raw Umami response payload.")
+}).describe("Umami website response.");
+var getWebsiteStatsInput = z.strictObject({
+  websiteId: z.string().min(1).describe("The Umami website ID."),
+  startAt: z.int().min(0).describe("Start timestamp in milliseconds since the Unix epoch."),
+  endAt: z.int().min(0).describe("End timestamp in milliseconds since the Unix epoch."),
+  timezone: z.string().min(1).describe("IANA timezone name used by Umami for date grouping."),
+  url: z.string().describe("URL path filter for the query.").optional(),
+  referrer: z.string().describe("Referrer filter for the query.").optional(),
+  title: z.string().describe("Page title filter for the query.").optional(),
+  host: z.string().describe("Host filter for the query.").optional(),
+  os: z.string().describe("Operating system filter for the query.").optional(),
+  browser: z.string().describe("Browser filter for the query.").optional(),
+  device: z.string().describe("Device filter for the query.").optional(),
+  country: z.string().describe("Country filter for the query.").optional(),
+  region: z.string().describe("Region filter for the query.").optional(),
+  city: z.string().describe("City filter for the query.").optional()
+}).describe("Request parameters for retrieving Umami website statistics.");
+var getWebsiteStatsOutput = z.strictObject({
+  stats: z.looseObject({
+    pageviews: z.unknown().describe("Pageview count or comparison object returned by Umami.").optional(),
+    visitors: z.unknown().describe("Visitor count or comparison object returned by Umami.").optional(),
+    visits: z.unknown().describe("Visit count or comparison object returned by Umami.").optional(),
+    bounces: z.unknown().describe("Bounce count or comparison object returned by Umami.").optional(),
+    totaltime: z.unknown().describe("Total time count or comparison object returned by Umami.").optional()
+  }).describe("Umami website statistics."),
+  raw: z.looseObject({}).describe("Raw Umami response payload.")
+}).describe("Umami website statistics response.");
+var getPageviewsInput = z.strictObject({
+  websiteId: z.string().min(1).describe("The Umami website ID."),
+  startAt: z.int().min(0).describe("Start timestamp in milliseconds since the Unix epoch."),
+  endAt: z.int().min(0).describe("End timestamp in milliseconds since the Unix epoch."),
+  timezone: z.string().min(1).describe("IANA timezone name used by Umami for date grouping."),
+  url: z.string().describe("URL path filter for the query.").optional(),
+  referrer: z.string().describe("Referrer filter for the query.").optional(),
+  title: z.string().describe("Page title filter for the query.").optional(),
+  host: z.string().describe("Host filter for the query.").optional(),
+  os: z.string().describe("Operating system filter for the query.").optional(),
+  browser: z.string().describe("Browser filter for the query.").optional(),
+  device: z.string().describe("Device filter for the query.").optional(),
+  country: z.string().describe("Country filter for the query.").optional(),
+  region: z.string().describe("Region filter for the query.").optional(),
+  city: z.string().describe("City filter for the query.").optional(),
+  unit: z.enum(["hour", "day", "month", "year"]).describe("Time unit used for timeseries grouping.").optional()
+}).describe("Request parameters for retrieving Umami pageview timeseries.");
+var getPageviewsOutput = z.strictObject({
+  pageviews: z.looseObject({}).describe("Raw Umami response payload."),
+  raw: z.looseObject({}).describe("Raw Umami response payload.")
+}).describe("Umami pageview timeseries response.");
+var getMetricsInput = z.strictObject({
+  websiteId: z.string().min(1).describe("The Umami website ID."),
+  startAt: z.int().min(0).describe("Start timestamp in milliseconds since the Unix epoch."),
+  endAt: z.int().min(0).describe("End timestamp in milliseconds since the Unix epoch."),
+  timezone: z.string().min(1).describe("IANA timezone name used by Umami for date grouping."),
+  url: z.string().describe("URL path filter for the query.").optional(),
+  referrer: z.string().describe("Referrer filter for the query.").optional(),
+  title: z.string().describe("Page title filter for the query.").optional(),
+  host: z.string().describe("Host filter for the query.").optional(),
+  os: z.string().describe("Operating system filter for the query.").optional(),
+  browser: z.string().describe("Browser filter for the query.").optional(),
+  device: z.string().describe("Device filter for the query.").optional(),
+  country: z.string().describe("Country filter for the query.").optional(),
+  region: z.string().describe("Region filter for the query.").optional(),
+  city: z.string().describe("City filter for the query.").optional(),
+  type: z.enum(["url", "referrer", "browser", "os", "device", "country", "region", "city", "language", "event"]).describe("Website metric dimension to return."),
+  limit: z.int().min(1).describe("Maximum number of metric rows to return.").optional()
+}).describe("Request parameters for retrieving grouped Umami website metrics.");
+var getMetricsOutput = z.strictObject({
+  metrics: z.array(z.looseObject({
+    x: z.unknown().describe("Metric dimension value returned by Umami.").optional(),
+    y: z.number().describe("Metric count returned by Umami.").optional()
+  }).describe("Umami metric row.")).describe("Metric rows returned by Umami."),
+  raw: z.array(z.unknown().describe("Raw Umami array item.")).describe("Raw Umami response array.")
+}).describe("Umami website metrics response.");
+var getRealtimeInput = z.strictObject({
+  websiteId: z.string().min(1).describe("The Umami website ID.")
+}).describe("Request parameters for retrieving Umami realtime data.");
+var getRealtimeOutput = z.strictObject({
+  realtime: z.looseObject({}).describe("Raw Umami response payload."),
+  raw: z.looseObject({}).describe("Raw Umami response payload.")
+}).describe("Umami realtime response.");
+var listEventsInput = z.strictObject({
+  websiteId: z.string().min(1).describe("The Umami website ID."),
+  startAt: z.int().min(0).describe("Start timestamp in milliseconds since the Unix epoch."),
+  endAt: z.int().min(0).describe("End timestamp in milliseconds since the Unix epoch."),
+  timezone: z.string().min(1).describe("IANA timezone name used by Umami for date grouping."),
+  url: z.string().describe("URL path filter for the query.").optional(),
+  referrer: z.string().describe("Referrer filter for the query.").optional(),
+  title: z.string().describe("Page title filter for the query.").optional(),
+  host: z.string().describe("Host filter for the query.").optional(),
+  os: z.string().describe("Operating system filter for the query.").optional(),
+  browser: z.string().describe("Browser filter for the query.").optional(),
+  device: z.string().describe("Device filter for the query.").optional(),
+  country: z.string().describe("Country filter for the query.").optional(),
+  region: z.string().describe("Region filter for the query.").optional(),
+  city: z.string().describe("City filter for the query.").optional(),
+  query: z.string().describe("Search query filter for the endpoint.").optional(),
+  page: z.int().min(1).describe("One-based page number for paginated Umami endpoints.").optional(),
+  pageSize: z.int().min(1).describe("Number of items to return per page.").optional()
+}).describe("Request parameters for listing Umami events.");
+var listEventsOutput = z.strictObject({
+  events: z.array(z.looseObject({
+    id: z.string().describe("Event ID.").optional(),
+    websiteId: z.string().describe("Website ID.").optional(),
+    sessionId: z.string().describe("Session ID.").optional(),
+    eventName: z.string().describe("Event name.").optional(),
+    urlPath: z.string().describe("URL path associated with the event.").optional(),
+    createdAt: z.string().describe("Event creation timestamp returned by Umami.").optional()
+  }).describe("Umami event row.")).describe("Events returned by Umami."),
+  count: z.int().min(0).describe("Total number of events matching the query."),
+  page: z.int().min(1).describe("Current page number."),
+  pageSize: z.int().min(1).describe("Page size used by Umami."),
+  raw: z.looseObject({}).describe("Raw Umami event list response.")
+}).describe("Umami event list response.");
+var umamiActions = {
+  get_current_user: {
+    description: "Get the current Umami user for the configured API token.",
+    effect: "read",
+    inputSchema: getCurrentUserInput,
+    outputSchema: z.toJSONSchema(getCurrentUserOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_websites: {
+    description: "List Umami websites available to the configured API token.",
+    effect: "read",
+    inputSchema: listWebsitesInput,
+    outputSchema: z.toJSONSchema(listWebsitesOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_website: {
+    description: "Get metadata for a single Umami website.",
+    effect: "read",
+    inputSchema: getWebsiteInput,
+    outputSchema: z.toJSONSchema(getWebsiteOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_website_stats: {
+    description: "Get aggregate pageview, visitor, visit, bounce, and time statistics for a website.",
+    effect: "read",
+    inputSchema: getWebsiteStatsInput,
+    outputSchema: z.toJSONSchema(getWebsiteStatsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_pageviews: {
+    description: "Get Umami pageview and session timeseries for a website.",
+    effect: "read",
+    inputSchema: getPageviewsInput,
+    outputSchema: z.toJSONSchema(getPageviewsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_metrics: {
+    description: "Get grouped Umami website metrics such as URLs, referrers, browsers, or countries.",
+    effect: "read",
+    inputSchema: getMetricsInput,
+    outputSchema: z.toJSONSchema(getMetricsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_realtime: {
+    description: "Get realtime active visitor data for an Umami website.",
+    effect: "read",
+    inputSchema: getRealtimeInput,
+    outputSchema: z.toJSONSchema(getRealtimeOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_events: {
+    description: "List tracked Umami events for a website within a time range.",
+    effect: "read",
+    inputSchema: listEventsInput,
+    outputSchema: z.toJSONSchema(listEventsOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/umami/index.ts
+function createUmamiPlugin() {
+  return createProviderPlugin({
+    description: "Umami",
+    actions: umamiActions,
+    credentialProbe: "get_current_user",
+    handlers: {
+      get_current_user: getCurrentUser,
+      list_websites: listWebsites,
+      get_website: getWebsite,
+      get_website_stats: getWebsiteStats,
+      get_pageviews: getPageviews,
+      get_metrics: getMetrics,
+      get_realtime: getRealtime,
+      list_events: listEvents
+    }
+  });
+}
+var umami_default = createUmamiPlugin();
+export {
+  createUmamiPlugin,
+  umami_default as default
+};