@xpufx/paseo-forges 0.1.0

package/client/vendor/paseo-plugin-helper/utils/clipboard.ts

@@ -0,0 +1,149 @@
+import type { HostToast } from "../host";
+import { getOptionalClientHost } from "../host";
+
+export interface CopyToClipboardOptions {
+  toast?: HostToast;
+  toastMessage?: string;
+}
+
+export type ClipboardTier = "navigator" | "host" | "rnAsync" | "rnSync" | "execCommand";
+
+export interface ClipboardEnvironment {
+  hasNavigatorClipboard: boolean;
+  hasHostCopyText: boolean;
+  hasRnClipboard: boolean;
+  hasRnSetStringAsync: boolean;
+  isDom: boolean;
+}
+
+/**
+ * Deterministic tier order for an explicit copy.
+ *
+ * Web's `navigator.clipboard.writeText` is the only API that rejects when the
+ * clipboard did not change, so it leads. The synchronous
+ * `react-native-web` `Clipboard.setString` reports success even when its
+ * `document.execCommand("copy")` fails, which leaves the previous clipboard
+ * item in place while the UI claims success (xpufx-org/paseo#278); it is only
+ * usable off-DOM (native), where it is the real platform clipboard. In a DOM
+ * the checked `execCommand` fallback is preferred to that unverifiable path.
+ */
+export function clipboardTierOrder(env: ClipboardEnvironment): ClipboardTier[] {
+  const tiers: ClipboardTier[] = [];
+  if (env.hasNavigatorClipboard) tiers.push("navigator");
+  if (env.hasHostCopyText) tiers.push("host");
+  if (env.hasRnSetStringAsync) {
+    tiers.push("rnAsync");
+  } else if (env.hasRnClipboard && !env.isDom) {
+    tiers.push("rnSync");
+  }
+  tiers.push("execCommand");
+  return tiers;
+}
+
+/**
+ * Robust cross-platform clipboard copy helper for Paseo plugins.
+ * Works seamlessly across React Native (mobile), web, and desktop.
+ *
+ * Tier order comes from `clipboardTierOrder`; every tier reports failure
+ * honestly so a denied or blocked write never leaves the previous clipboard
+ * item behind under a fake success.
+ */
+export async function copyToClipboard(
+  text: string,
+  options?: CopyToClipboardOptions,
+): Promise<boolean> {
+  if (text === null || text === undefined) return false;
+  const str = String(text);
+
+  const globalObj = typeof globalThis !== "undefined" ? (globalThis as any) : {};
+
+  let rn: any;
+  try {
+    rn = require("react-native");
+  } catch {
+    // Ignore require error if not in RN context
+  }
+  const rnClipboard = rn?.Clipboard;
+  const rnSetStringAsync =
+    typeof rnClipboard?.setStringAsync === "function" ? rnClipboard.setStringAsync : undefined;
+  const rnSetString =
+    typeof rnClipboard?.setString === "function" ? rnClipboard.setString : undefined;
+  const copyText = getOptionalClientHost()?.copyText;
+
+  const isDom =
+    typeof globalObj.document !== "undefined" &&
+    typeof globalObj.document?.createElement === "function";
+
+  const tiers = clipboardTierOrder({
+    hasNavigatorClipboard: Boolean(globalObj.navigator?.clipboard?.writeText),
+    hasHostCopyText: Boolean(copyText),
+    hasRnClipboard: Boolean(rnSetStringAsync ?? rnSetString),
+    hasRnSetStringAsync: Boolean(rnSetStringAsync),
+    isDom,
+  });
+
+  let success = false;
+  for (const tier of tiers) {
+    if (success) break;
+    try {
+      switch (tier) {
+        case "navigator":
+          await globalObj.navigator.clipboard.writeText(str);
+          success = true;
+          break;
+        case "host":
+          if (copyText) {
+            await copyText(str);
+            success = true;
+          }
+          break;
+        case "rnAsync":
+          // Expo's async API returns a boolean; a rejected promise falls through.
+          success = (await rnSetStringAsync(str)) !== false;
+          break;
+        case "rnSync":
+          // Only reached off-DOM, where this is the native platform clipboard.
+          rnSetString(str);
+          success = true;
+          break;
+        case "execCommand": {
+          const doc = globalObj.document;
+          if (doc?.createElement && doc?.body) {
+            const textarea = doc.createElement("textarea");
+            textarea.value = str;
+            textarea.style.position = "fixed";
+            textarea.style.opacity = "0";
+            textarea.style.left = "-9999px";
+            doc.body.appendChild(textarea);
+            textarea.focus();
+            textarea.select();
+            const res = doc.execCommand("copy");
+            doc.body.removeChild(textarea);
+            success = res === true;
+          }
+          break;
+        }
+      }
+    } catch {
+      // Tier failed; try the next one.
+    }
+  }
+
+  if (success && options?.toast) {
+    try {
+      const toastAny = options.toast as any;
+      if (typeof toastAny.copied === "function") {
+        toastAny.copied(options.toastMessage);
+      } else if (typeof toastAny.show === "function") {
+        const msg = options.toastMessage
+          ? `Copied ${options.toastMessage} to clipboard`
+          : "Copied to clipboard";
+        toastAny.show(msg, { variant: "success" });
+      }
+    } catch {
+      // Ignore toast failure
+    }
+  }
+
+  return success;
+}

package/client/vendor/paseo-plugin-helper/utils/haptics.ts

@@ -0,0 +1,34 @@
+export type HapticFeedbackType =
+  | "light"
+  | "medium"
+  | "heavy"
+  | "success"
+  | "warning"
+  | "error";
+
+const PATTERNS: Record<HapticFeedbackType, number | number[]> = {
+  light: 10,
+  medium: 25,
+  heavy: 45,
+  success: [15, 40, 20],
+  warning: [30, 50, 30],
+  error: [40, 60, 40, 60, 40],
+};
+
+/**
+ * Cross-platform haptic feedback helper for Paseo plugins.
+ * Supports web vibration API and graceful fallback when vibration is unavailable.
+ */
+export function triggerHaptic(type: HapticFeedbackType = "light"): boolean {
+  try {
+    const globalObj = typeof globalThis !== "undefined" ? (globalThis as any) : {};
+    const nav = globalObj.navigator;
+    if (typeof nav?.vibrate === "function") {
+      const pattern = PATTERNS[type] ?? 15;
+      return Boolean(nav.vibrate(pattern));
+    }
+  } catch {
+    // Ignore environments where vibration permissions are denied or unavailable
+  }
+  return false;
+}

package/client/webhook-card.tsx

@@ -0,0 +1,198 @@
+import React from "react";
+import { Linking, Pressable, StyleSheet, Text, View } from "react-native";
+import type {
+  PluginTimelineItemProps,
+  PluginTimelineRendererContribution,
+  PluginTimelineTransformerContribution,
+} from "@getpaseo/plugin/client";
+import type { PluginTheme } from "@getpaseo/plugin";
+import { Badge, ForgeIcon, Icon } from "paseo-plugin-helper/client";
+import {
+  forgejoWebhookCardSchema,
+  forgejoWebhookItem,
+  subjectLinkUrl,
+  type ForgejoSubject,
+  type ForgejoWebhookCardData,
+} from "../shared/webhook.js";
+
+/**
+ * Forgejo webhook timeline transformer: incoming hook deliveries become typed
+ * `forgejo-webhook` items so the composer renders the event card below instead
+ * of a raw chat line. Registered before the linkifier because hook messages
+ * carry a bare issue URL the linkifier would otherwise claim first.
+ *
+ * Presentation-only: `PluginTimelineTransformerContribution.transform` returns
+ * `PluginTimelineItem[]`, a client-side render target. It has no reference to
+ * mutate the source `AgentTimelineItem`, so the raw envelope + human line stays
+ * verbatim in the agent's context. Nothing below may echo that text.
+ */
+export const forgejoWebhookUserTransformer: PluginTimelineTransformerContribution<"user_message"> = {
+  id: "forgejo-webhook",
+  query: { itemType: "user_message" },
+  transform({ item }) {
+    return forgejoWebhookItem(item.text) as any;
+  },
+};
+
+function openUrl(url: string) {
+  Linking.openURL(url).catch(() => {});
+}
+
+function SubjectRow({ theme, subject }: { theme: PluginTheme; subject: ForgejoSubject }) {
+  const link = subjectLinkUrl(subject);
+  const onPress = link ? () => openUrl(link) : undefined;
+  const isPush = subject.kind === "push";
+  return (
+    <View style={styles.subjectRow}>
+      <Icon
+        name={isPush ? "GitCommit" : "GitPullRequest"}
+        size={13}
+        color={theme.colors.foregroundMuted}
+      />
+      {subject.number != null ? <Badge variant="info" label={`#${subject.number}`} /> : null}
+      <View style={styles.subjectBody}>
+        {subject.title ? (
+          onPress ? (
+            <Pressable onPress={onPress} hitSlop={8} accessibilityRole="link">
+              <Text style={[styles.subjectTitle, styles.link, { color: theme.colors.accent }]}>
+                {subject.title}
+              </Text>
+            </Pressable>
+          ) : (
+            <Text style={[styles.subjectTitle, { color: theme.colors.foreground }]}>
+              {subject.title}
+            </Text>
+          )
+        ) : null}
+        {subject.ref ? (
+          <Text style={[styles.subjectMeta, { color: theme.colors.foregroundMuted }]}>
+            {subject.ref}
+          </Text>
+        ) : null}
+        {subject.commits != null ? (
+          <Text style={[styles.subjectMeta, { color: theme.colors.foregroundMuted }]}>
+            {subject.commits} {subject.commits === 1 ? "commit" : "commits"}
+          </Text>
+        ) : null}
+        {subject.commentId != null ? (
+          <Text style={[styles.subjectMeta, { color: theme.colors.foregroundMuted }]}>
+            comment #{subject.commentId}
+          </Text>
+        ) : null}
+        {link ? (
+          <Pressable onPress={onPress} hitSlop={8} accessibilityRole="link">
+            <Text style={[styles.subjectUrl, styles.link, { color: theme.colors.accent }]}>
+              {link}
+            </Text>
+          </Pressable>
+        ) : null}
+      </View>
+    </View>
+  );
+}
+
+export function ForgejoWebhookCard({ item, theme }: PluginTimelineItemProps<ForgejoWebhookCardData>) {
+  const data = item.data;
+  const repoLink = data.repoUrl ? () => openUrl(data.repoUrl as string) : undefined;
+  return (
+    <View
+      style={[
+        styles.card,
+        { backgroundColor: theme.colors.surface1, borderColor: theme.colors.border },
+      ]}
+    >
+      <View style={styles.header}>
+        <ForgeIcon host={data.repoUrl} size={14} color={theme.colors.accent} />
+        <Text style={[styles.title, { color: theme.colors.foreground }]}>Forgejo webhook</Text>
+        <Badge
+          variant="info"
+          label={data.action ? `${data.event}:${data.action}` : data.event}
+        />
+      </View>
+      <View style={styles.metaRow}>
+        {repoLink ? (
+          <Pressable onPress={repoLink} hitSlop={8} accessibilityRole="link">
+            <Text style={[styles.meta, styles.link, { color: theme.colors.accent }]}>
+              {data.repo}
+            </Text>
+          </Pressable>
+        ) : (
+          <Text style={[styles.meta, { color: theme.colors.foregroundMuted }]}>{data.repo}</Text>
+        )}
+        {data.sender ? (
+          <Text style={[styles.meta, { color: theme.colors.foregroundMuted }]}>
+            · by {data.sender}
+          </Text>
+        ) : null}
+      </View>
+      {data.subject ? <SubjectRow theme={theme} subject={data.subject} /> : null}
+      <Text style={[styles.footer, { color: theme.colors.foregroundMuted }]}>
+        via forges
+      </Text>
+    </View>
+  );
+}
+
+export const forgejoWebhookRenderer: PluginTimelineRendererContribution<
+  typeof forgejoWebhookCardSchema
+> = {
+  kind: "forgejo-webhook",
+  version: 1,
+  schema: forgejoWebhookCardSchema,
+  Component: ForgejoWebhookCard,
+};
+
+const styles = StyleSheet.create({
+  card: {
+    borderRadius: 8,
+    borderWidth: 1,
+    padding: 8,
+    marginVertical: 2,
+    gap: 6,
+  },
+  header: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 6,
+  },
+  title: {
+    fontSize: 12,
+    fontWeight: "600",
+    flex: 1,
+  },
+  metaRow: {
+    flexDirection: "row",
+    alignItems: "center",
+    flexWrap: "wrap",
+    gap: 4,
+  },
+  meta: {
+    fontSize: 11,
+  },
+  subjectRow: {
+    flexDirection: "row",
+    alignItems: "flex-start",
+    gap: 8,
+  },
+  subjectBody: {
+    flex: 1,
+    gap: 2,
+  },
+  subjectTitle: {
+    fontSize: 13,
+    fontWeight: "600",
+  },
+  subjectMeta: {
+    fontSize: 11,
+  },
+  subjectUrl: {
+    fontSize: 11,
+  },
+  link: {
+    textDecorationLine: "underline",
+  },
+  footer: {
+    fontSize: 10,
+    fontStyle: "italic",
+  },
+});