veryfront 0.0.49 → 0.0.51

package/dist/integrations/figma/files/lib/types.ts

@@ -0,0 +1,503 @@
+/**
+ * Comprehensive type definitions for Figma API
+ * Based on Figma REST API v1 specification
+ */
+
+// ============================================================================
+// Core Types
+// ============================================================================
+
+export type NodeType =
+  | "DOCUMENT"
+  | "CANVAS"
+  | "FRAME"
+  | "GROUP"
+  | "VECTOR"
+  | "BOOLEAN_OPERATION"
+  | "STAR"
+  | "LINE"
+  | "ELLIPSE"
+  | "REGULAR_POLYGON"
+  | "RECTANGLE"
+  | "TEXT"
+  | "SLICE"
+  | "COMPONENT"
+  | "COMPONENT_SET"
+  | "INSTANCE";
+
+export type BlendMode =
+  | "NORMAL"
+  | "DARKEN"
+  | "MULTIPLY"
+  | "LINEAR_BURN"
+  | "COLOR_BURN"
+  | "LIGHTEN"
+  | "SCREEN"
+  | "LINEAR_DODGE"
+  | "COLOR_DODGE"
+  | "OVERLAY"
+  | "SOFT_LIGHT"
+  | "HARD_LIGHT"
+  | "DIFFERENCE"
+  | "EXCLUSION"
+  | "HUE"
+  | "SATURATION"
+  | "COLOR"
+  | "LUMINOSITY";
+
+export type EasingType =
+  | "EASE_IN"
+  | "EASE_OUT"
+  | "EASE_IN_AND_OUT"
+  | "LINEAR";
+
+// ============================================================================
+// Geometry Types
+// ============================================================================
+
+export interface Vector2D {
+  x: number;
+  y: number;
+}
+
+export interface Rectangle {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+export interface Transform {
+  /** 2D transformation matrix [[a, b, tx], [c, d, ty]] */
+  matrix: [[number, number, number], [number, number, number]];
+}
+
+// ============================================================================
+// Paint Types
+// ============================================================================
+
+export type PaintType =
+  | "SOLID"
+  | "GRADIENT_LINEAR"
+  | "GRADIENT_RADIAL"
+  | "GRADIENT_ANGULAR"
+  | "GRADIENT_DIAMOND"
+  | "IMAGE"
+  | "EMOJI";
+
+export interface Color {
+  r: number;
+  g: number;
+  b: number;
+  a: number;
+}
+
+export interface ColorStop {
+  position: number;
+  color: Color;
+}
+
+export interface Paint {
+  type: PaintType;
+  visible?: boolean;
+  opacity?: number;
+  color?: Color;
+  blendMode?: BlendMode;
+  gradientHandlePositions?: Vector2D[];
+  gradientStops?: ColorStop[];
+  scaleMode?: "FILL" | "FIT" | "TILE" | "STRETCH";
+  imageTransform?: Transform;
+  scalingFactor?: number;
+  imageRef?: string;
+  gifRef?: string;
+}
+
+// ============================================================================
+// Effect Types
+// ============================================================================
+
+export type EffectType =
+  | "INNER_SHADOW"
+  | "DROP_SHADOW"
+  | "LAYER_BLUR"
+  | "BACKGROUND_BLUR";
+
+export interface Effect {
+  type: EffectType;
+  visible?: boolean;
+  radius?: number;
+  color?: Color;
+  blendMode?: BlendMode;
+  offset?: Vector2D;
+  spread?: number;
+}
+
+// ============================================================================
+// Layout Types
+// ============================================================================
+
+export type LayoutConstraintVertical = "TOP" | "BOTTOM" | "CENTER" | "TOP_BOTTOM" | "SCALE";
+export type LayoutConstraintHorizontal = "LEFT" | "RIGHT" | "CENTER" | "LEFT_RIGHT" | "SCALE";
+
+export interface LayoutConstraint {
+  vertical: LayoutConstraintVertical;
+  horizontal: LayoutConstraintHorizontal;
+}
+
+export type LayoutAlign = "MIN" | "CENTER" | "MAX" | "STRETCH" | "INHERIT";
+
+export type LayoutMode = "NONE" | "HORIZONTAL" | "VERTICAL";
+
+export interface LayoutGrid {
+  pattern: "COLUMNS" | "ROWS" | "GRID";
+  sectionSize?: number;
+  visible?: boolean;
+  color?: Color;
+  alignment?: "MIN" | "MAX" | "CENTER" | "STRETCH";
+  gutterSize?: number;
+  offset?: number;
+  count?: number;
+}
+
+// ============================================================================
+// Typography Types
+// ============================================================================
+
+export type TextAlignHorizontal = "LEFT" | "CENTER" | "RIGHT" | "JUSTIFIED";
+export type TextAlignVertical = "TOP" | "CENTER" | "BOTTOM";
+export type TextCase = "ORIGINAL" | "UPPER" | "LOWER" | "TITLE";
+export type TextDecoration = "NONE" | "STRIKETHROUGH" | "UNDERLINE";
+
+export interface TypeStyle {
+  fontFamily: string;
+  fontPostScriptName?: string;
+  paragraphSpacing?: number;
+  paragraphIndent?: number;
+  italic?: boolean;
+  fontWeight: number;
+  fontSize: number;
+  textAlignHorizontal?: TextAlignHorizontal;
+  textAlignVertical?: TextAlignVertical;
+  letterSpacing?: number;
+  fills?: Paint[];
+  lineHeightPx?: number;
+  lineHeightPercent?: number;
+  lineHeightPercentFontSize?: number;
+  lineHeightUnit?: "PIXELS" | "FONT_SIZE_%" | "INTRINSIC_%";
+}
+
+// ============================================================================
+// Component Types
+// ============================================================================
+
+export interface Component {
+  key: string;
+  name: string;
+  description: string;
+  componentSetId?: string;
+  documentationLinks: string[];
+  remote?: boolean;
+}
+
+export interface ComponentSet {
+  key: string;
+  name: string;
+  description: string;
+  documentationLinks: string[];
+  remote?: boolean;
+}
+
+// ============================================================================
+// Style Types
+// ============================================================================
+
+export type StyleType = "FILL" | "TEXT" | "EFFECT" | "GRID";
+
+export interface Style {
+  key: string;
+  name: string;
+  description: string;
+  styleType: StyleType;
+  remote?: boolean;
+}
+
+// ============================================================================
+// Export Types
+// ============================================================================
+
+export type ExportFormat = "JPG" | "PNG" | "SVG" | "PDF";
+
+export interface ExportSettings {
+  suffix: string;
+  format: ExportFormat;
+  constraint?: {
+    type: "SCALE" | "WIDTH" | "HEIGHT";
+    value: number;
+  };
+}
+
+// ============================================================================
+// Comment Types
+// ============================================================================
+
+export interface Comment {
+  id: string;
+  file_key: string;
+  parent_id?: string;
+  user: User;
+  created_at: string;
+  resolved_at?: string;
+  message: string;
+  client_meta: CommentClientMeta;
+  order_id: string;
+}
+
+export interface CommentClientMeta {
+  x?: number;
+  y?: number;
+  node_id?: string[];
+  node_offset?: Vector2D;
+}
+
+export interface User {
+  id: string;
+  handle: string;
+  img_url: string;
+  email?: string;
+}
+
+// ============================================================================
+// File Types
+// ============================================================================
+
+export interface FileResponse {
+  document: Node;
+  components: Record<string, Component>;
+  componentSets: Record<string, ComponentSet>;
+  schemaVersion: number;
+  styles: Record<string, Style>;
+  name: string;
+  lastModified: string;
+  thumbnailUrl: string;
+  version: string;
+  role: "owner" | "editor" | "viewer";
+  editorType: "figma" | "figjam";
+  linkAccess: "view" | "edit" | "org_view" | "org_edit";
+}
+
+// ============================================================================
+// Node Types (Base)
+// ============================================================================
+
+export interface NodeBase {
+  id: string;
+  name: string;
+  visible?: boolean;
+  type: NodeType;
+  pluginData?: unknown;
+  sharedPluginData?: unknown;
+  locked?: boolean;
+}
+
+export interface NodeWithChildren extends NodeBase {
+  children: Node[];
+}
+
+// ============================================================================
+// Specific Node Types
+// ============================================================================
+
+export interface DocumentNode extends NodeWithChildren {
+  type: "DOCUMENT";
+}
+
+export interface CanvasNode extends NodeWithChildren {
+  type: "CANVAS";
+  backgroundColor: Color;
+  prototypeStartNodeID?: string;
+  prototypeDevice?: {
+    type: string;
+    rotation: "NONE" | "CCW_90";
+  };
+  exportSettings?: ExportSettings[];
+}
+
+export interface FrameNode extends NodeWithChildren {
+  type: "FRAME";
+  absoluteBoundingBox?: Rectangle;
+  absoluteRenderBounds?: Rectangle;
+  constraints?: LayoutConstraint;
+  clipsContent?: boolean;
+  background: Paint[];
+  backgroundColor?: Color;
+  fills?: Paint[];
+  strokes?: Paint[];
+  strokeWeight?: number;
+  strokeAlign?: "INSIDE" | "OUTSIDE" | "CENTER";
+  strokeDashes?: number[];
+  cornerRadius?: number;
+  rectangleCornerRadii?: [number, number, number, number];
+  exportSettings?: ExportSettings[];
+  blendMode?: BlendMode;
+  preserveRatio?: boolean;
+  layoutAlign?: LayoutAlign;
+  layoutGrow?: number;
+  layoutMode?: LayoutMode;
+  primaryAxisSizingMode?: "FIXED" | "AUTO";
+  counterAxisSizingMode?: "FIXED" | "AUTO";
+  primaryAxisAlignItems?: LayoutAlign;
+  counterAxisAlignItems?: LayoutAlign;
+  paddingLeft?: number;
+  paddingRight?: number;
+  paddingTop?: number;
+  paddingBottom?: number;
+  itemSpacing?: number;
+  layoutGrids?: LayoutGrid[];
+  effects?: Effect[];
+  isMask?: boolean;
+  isMaskOutline?: boolean;
+  transitionNodeID?: string;
+  transitionDuration?: number;
+  transitionEasing?: EasingType;
+  opacity?: number;
+}
+
+export interface GroupNode extends NodeWithChildren {
+  type: "GROUP";
+  absoluteBoundingBox?: Rectangle;
+  absoluteRenderBounds?: Rectangle;
+  constraints?: LayoutConstraint;
+  clipsContent?: boolean;
+  blendMode?: BlendMode;
+  effects?: Effect[];
+  opacity?: number;
+}
+
+export interface VectorNode extends NodeBase {
+  type:
+    | "VECTOR"
+    | "BOOLEAN_OPERATION"
+    | "STAR"
+    | "LINE"
+    | "ELLIPSE"
+    | "REGULAR_POLYGON"
+    | "RECTANGLE";
+  absoluteBoundingBox?: Rectangle;
+  absoluteRenderBounds?: Rectangle;
+  constraints?: LayoutConstraint;
+  fills?: Paint[];
+  fillGeometry?: unknown[];
+  strokes?: Paint[];
+  strokeWeight?: number;
+  strokeCap?: "NONE" | "ROUND" | "SQUARE" | "LINE_ARROW" | "TRIANGLE_ARROW";
+  strokeJoin?: "MITER" | "BEVEL" | "ROUND";
+  strokeDashes?: number[];
+  strokeAlign?: "INSIDE" | "OUTSIDE" | "CENTER";
+  strokeGeometry?: unknown[];
+  cornerRadius?: number;
+  rectangleCornerRadii?: [number, number, number, number];
+  exportSettings?: ExportSettings[];
+  blendMode?: BlendMode;
+  preserveRatio?: boolean;
+  layoutAlign?: LayoutAlign;
+  layoutGrow?: number;
+  effects?: Effect[];
+  isMask?: boolean;
+  opacity?: number;
+}
+
+export interface TextNode extends NodeBase {
+  type: "TEXT";
+  absoluteBoundingBox?: Rectangle;
+  absoluteRenderBounds?: Rectangle;
+  constraints?: LayoutConstraint;
+  fills?: Paint[];
+  strokes?: Paint[];
+  strokeWeight?: number;
+  strokeAlign?: "INSIDE" | "OUTSIDE" | "CENTER";
+  strokeDashes?: number[];
+  exportSettings?: ExportSettings[];
+  blendMode?: BlendMode;
+  preserveRatio?: boolean;
+  layoutAlign?: LayoutAlign;
+  layoutGrow?: number;
+  effects?: Effect[];
+  characters: string;
+  style: TypeStyle;
+  characterStyleOverrides?: number[];
+  styleOverrideTable?: Record<number, TypeStyle>;
+  opacity?: number;
+}
+
+export interface ComponentNode extends FrameNode {
+  type: "COMPONENT";
+}
+
+export interface ComponentSetNode extends FrameNode {
+  type: "COMPONENT_SET";
+}
+
+export interface InstanceNode extends FrameNode {
+  type: "INSTANCE";
+  componentId: string;
+  overrides?: unknown[];
+}
+
+// ============================================================================
+// Union Type for All Nodes
+// ============================================================================
+
+export type Node =
+  | DocumentNode
+  | CanvasNode
+  | FrameNode
+  | GroupNode
+  | VectorNode
+  | TextNode
+  | ComponentNode
+  | ComponentSetNode
+  | InstanceNode;
+
+// ============================================================================
+// Project & Team Types
+// ============================================================================
+
+export interface Project {
+  id: string;
+  name: string;
+}
+
+export interface FileReference {
+  key: string;
+  name: string;
+  thumbnail_url: string;
+  last_modified: string;
+}
+
+export interface ProjectFilesResponse {
+  files: FileReference[];
+}
+
+export interface TeamProjectsResponse {
+  projects: Project[];
+}
+
+// ============================================================================
+// Version Types
+// ============================================================================
+
+export interface Version {
+  id: string;
+  created_at: string;
+  label?: string;
+  description?: string;
+  user: User;
+  thumbnail_url?: string;
+}
+
+export interface VersionsResponse {
+  versions: Version[];
+  pagination?: {
+    next_page?: number;
+  };
+}

package/dist/integrations/freshdesk/connector.json

@@ -0,0 +1,85 @@
+{
+  "name": "freshdesk",
+  "displayName": "Freshdesk",
+  "icon": "freshdesk.svg",
+  "description": "Manage customer support tickets and contacts in Freshdesk",
+  "auth": {
+    "type": "oauth2",
+    "provider": "freshdesk",
+    "authorizationUrl": "https://accounts.freshworks.com/authorize",
+    "tokenUrl": "https://accounts.freshworks.com/oauth/token",
+    "scopes": ["freshdesk"],
+    "callbackPath": "/api/auth/freshdesk/callback",
+    "requiredApis": [
+      {
+        "name": "Freshdesk Developer Portal",
+        "enableUrl": "https://developers.freshdesk.com/apps/"
+      }
+    ]
+  },
+  "envVars": [
+    {
+      "name": "FRESHDESK_CLIENT_ID",
+      "description": "Freshdesk OAuth Client ID",
+      "required": true,
+      "sensitive": false,
+      "docsUrl": "https://developers.freshdesk.com/api/"
+    },
+    {
+      "name": "FRESHDESK_CLIENT_SECRET",
+      "description": "Freshdesk OAuth Client Secret",
+      "required": true,
+      "sensitive": true,
+      "docsUrl": "https://developers.freshdesk.com/api/"
+    }
+  ],
+  "tools": [
+    {
+      "id": "list-tickets",
+      "name": "List Tickets",
+      "description": "List support tickets from Freshdesk",
+      "requiresWrite": false
+    },
+    {
+      "id": "get-ticket",
+      "name": "Get Ticket",
+      "description": "Get details of a specific ticket",
+      "requiresWrite": false
+    },
+    {
+      "id": "create-ticket",
+      "name": "Create Ticket",
+      "description": "Create a new support ticket",
+      "requiresWrite": true
+    },
+    {
+      "id": "update-ticket",
+      "name": "Update Ticket",
+      "description": "Update an existing ticket",
+      "requiresWrite": true
+    },
+    {
+      "id": "list-contacts",
+      "name": "List Contacts",
+      "description": "List customer contacts in Freshdesk",
+      "requiresWrite": false
+    }
+  ],
+  "prompts": [
+    {
+      "id": "my-tickets",
+      "title": "Show my tickets",
+      "prompt": "List all open support tickets assigned to me with their priority and status.",
+      "category": "support",
+      "icon": "inbox"
+    },
+    {
+      "id": "create-ticket",
+      "title": "Create a ticket",
+      "prompt": "Create a new support ticket with a subject, description, priority, and contact.",
+      "category": "support",
+      "icon": "plus"
+    }
+  ],
+  "suggestedWith": ["slack", "intercom", "zendesk"]
+}

package/dist/integrations/freshdesk/files/_env.example

@@ -0,0 +1,4 @@
+# Freshdesk OAuth Configuration
+# Get your credentials from https://developers.freshdesk.com/apps/
+FRESHDESK_CLIENT_ID=your-client-id
+FRESHDESK_CLIENT_SECRET=your-client-secret

package/dist/integrations/freshdesk/files/ai/tools/create-ticket.ts

@@ -0,0 +1,60 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { createTicket, TicketStatus, TicketPriority } from "../../lib/freshdesk-client.ts";
+
+export default tool({
+  id: "create-ticket",
+  description: "Create a new support ticket in Freshdesk.",
+  inputSchema: z.object({
+    subject: z.string().describe("The subject/title of the ticket"),
+    description: z.string().describe("Description or details of the ticket"),
+    email: z.string().email().describe("Email address of the requester"),
+    priority: z
+      .enum(["low", "medium", "high", "urgent"])
+      .default("medium")
+      .describe("Priority level of the ticket"),
+    status: z
+      .enum(["open", "pending"])
+      .default("open")
+      .describe("Initial status of the ticket"),
+    type: z
+      .string()
+      .optional()
+      .describe("Type of ticket (e.g., 'Question', 'Incident', 'Problem', 'Feature Request')"),
+    tags: z.array(z.string()).optional().describe("Tags to add to the ticket"),
+  }),
+  async execute({ subject, description, email, priority, status, type, tags }) {
+    const priorityMap = {
+      low: TicketPriority.LOW,
+      medium: TicketPriority.MEDIUM,
+      high: TicketPriority.HIGH,
+      urgent: TicketPriority.URGENT,
+    };
+
+    const statusMap = {
+      open: TicketStatus.OPEN,
+      pending: TicketStatus.PENDING,
+    };
+
+    const ticket = await createTicket({
+      subject,
+      description,
+      email,
+      priority: priorityMap[priority],
+      status: statusMap[status],
+      type,
+      tags,
+    });
+
+    return {
+      success: true,
+      ticket: {
+        id: ticket.id,
+        subject: ticket.subject,
+        status: Object.keys(statusMap).find((key) => statusMap[key as keyof typeof statusMap] === ticket.status) || "unknown",
+        priority: Object.keys(priorityMap).find((key) => priorityMap[key as keyof typeof priorityMap] === ticket.priority) || "unknown",
+        createdAt: ticket.created_at,
+      },
+    };
+  },
+});

package/dist/integrations/freshdesk/files/ai/tools/get-ticket.ts

@@ -0,0 +1,46 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { getTicket, TicketStatus, TicketPriority } from "../../lib/freshdesk-client.ts";
+
+export default tool({
+  id: "get-ticket",
+  description: "Get details of a specific Freshdesk support ticket by its ID.",
+  inputSchema: z.object({
+    ticketId: z.number().describe("The ID of the ticket to retrieve"),
+  }),
+  async execute({ ticketId }) {
+    const ticket = await getTicket(ticketId);
+
+    const statusMap = {
+      [TicketStatus.OPEN]: "open",
+      [TicketStatus.PENDING]: "pending",
+      [TicketStatus.RESOLVED]: "resolved",
+      [TicketStatus.CLOSED]: "closed",
+    };
+
+    const priorityMap = {
+      [TicketPriority.LOW]: "low",
+      [TicketPriority.MEDIUM]: "medium",
+      [TicketPriority.HIGH]: "high",
+      [TicketPriority.URGENT]: "urgent",
+    };
+
+    return {
+      id: ticket.id,
+      subject: ticket.subject,
+      description: ticket.description,
+      descriptionText: ticket.description_text,
+      status: statusMap[ticket.status] || "unknown",
+      priority: priorityMap[ticket.priority] || "unknown",
+      type: ticket.type,
+      requesterId: ticket.requester_id,
+      responderId: ticket.responder_id,
+      dueBy: ticket.due_by,
+      firstResponseDueBy: ticket.fr_due_by,
+      createdAt: ticket.created_at,
+      updatedAt: ticket.updated_at,
+      tags: ticket.tags,
+      customFields: ticket.custom_fields,
+    };
+  },
+});