veryfront 0.0.49 → 0.0.51

package/dist/integrations/posthog/files/lib/posthog-client.ts

@@ -0,0 +1,286 @@
+import { getApiKey } from "./token-store.ts";
+
+const DEFAULT_POSTHOG_HOST = "https://app.posthog.com";
+
+// Types
+export interface PostHogInsight {
+  id: number;
+  name: string;
+  derived_name: string | null;
+  description: string;
+  filters: Record<string, unknown>;
+  result: unknown;
+  created_at: string;
+  created_by: {
+    id: number;
+    uuid: string;
+    distinct_id: string;
+    first_name: string;
+    email: string;
+  } | null;
+}
+
+export interface PostHogTrend {
+  action: {
+    id: string;
+    name: string;
+    type: string;
+  };
+  label: string;
+  count: number;
+  data: number[];
+  labels: string[];
+  days: string[];
+}
+
+export interface PostHogFunnel {
+  id: number;
+  name: string;
+  steps: Array<{
+    action_id: string;
+    name: string;
+    order: number;
+    count: number;
+    average_conversion_time: number | null;
+  }>;
+  filters: Record<string, unknown>;
+}
+
+export interface PostHogFeatureFlag {
+  id: number;
+  name: string;
+  key: string;
+  filters: {
+    groups: Array<{
+      properties: unknown[];
+      rollout_percentage: number | null;
+    }>;
+  };
+  deleted: boolean;
+  active: boolean;
+  created_at: string;
+  created_by: {
+    id: number;
+    uuid: string;
+    distinct_id: string;
+    first_name: string;
+    email: string;
+  } | null;
+  is_simple_flag: boolean;
+  rollout_percentage: number | null;
+  ensure_experience_continuity: boolean;
+}
+
+export interface PostHogPerson {
+  id: string;
+  name: string;
+  distinct_ids: string[];
+  properties: Record<string, unknown>;
+  created_at: string;
+  uuid: string;
+}
+
+export interface PostHogEvent {
+  event: string;
+  distinct_id: string;
+  properties?: Record<string, unknown>;
+  timestamp?: string;
+}
+
+interface PostHogListResponse<T> {
+  next: string | null;
+  previous: string | null;
+  results: T[];
+}
+
+interface PostHogError {
+  type: string;
+  code: string;
+  detail: string;
+  attr: string | null;
+}
+
+// Helper function to get PostHog host
+function getPostHogHost(): string {
+  return process.env.POSTHOG_HOST || DEFAULT_POSTHOG_HOST;
+}
+
+// Helper function for PostHog API calls
+async function posthogFetch<T>(
+  endpoint: string,
+  options: RequestInit & { params?: Record<string, string | number | boolean> } = {},
+): Promise<T> {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    throw new Error("Not authenticated with PostHog. Please set POSTHOG_API_KEY.");
+  }
+
+  const host = getPostHogHost();
+
+  // Build URL with query parameters
+  let url = `${host}/api${endpoint}`;
+  if (options.params) {
+    const params = new URLSearchParams();
+    Object.entries(options.params).forEach(([key, value]) => {
+      params.append(key, String(value));
+    });
+    url += `?${params.toString()}`;
+  }
+
+  const headers: Record<string, string> = {
+    "Authorization": `Bearer ${apiKey}`,
+    "Content-Type": "application/json",
+    ...options.headers as Record<string, string>,
+  };
+
+  const response = await fetch(url, {
+    ...options,
+    headers,
+  });
+
+  const data = await response.json();
+
+  if (!response.ok) {
+    const error = data as PostHogError;
+    throw new Error(
+      `PostHog API error: ${response.status} ${error.detail || response.statusText}`,
+    );
+  }
+
+  return data as T;
+}
+
+// Insights operations
+export function getInsights(options?: {
+  limit?: number;
+}): Promise<PostHogListResponse<PostHogInsight>> {
+  const params: Record<string, string | number> = {};
+
+  if (options?.limit) {
+    params.limit = options.limit;
+  }
+
+  return posthogFetch<PostHogListResponse<PostHogInsight>>("/projects/@current/insights/", {
+    params,
+  });
+}
+
+// Trends operations
+export function getTrends(options: {
+  events?: Array<{ id: string; name?: string; type?: string }>;
+  date_from?: string;
+  date_to?: string;
+  interval?: "hour" | "day" | "week" | "month";
+  properties?: Record<string, unknown>[];
+}): Promise<PostHogTrend[]> {
+  const body = {
+    events: options.events || [{ id: "$pageview", name: "$pageview", type: "events" }],
+    date_from: options.date_from || "-7d",
+    date_to: options.date_to || "now",
+    interval: options.interval || "day",
+    properties: options.properties || [],
+  };
+
+  return posthogFetch<PostHogTrend[]>("/projects/@current/insights/trend/", {
+    method: "POST",
+    body: JSON.stringify(body),
+  });
+}
+
+// Funnels operations
+export function getFunnels(options: {
+  events?: Array<{ id: string; name?: string; order: number }>;
+  date_from?: string;
+  date_to?: string;
+}): Promise<PostHogFunnel> {
+  const body = {
+    events: options.events || [],
+    date_from: options.date_from || "-7d",
+    date_to: options.date_to || "now",
+  };
+
+  return posthogFetch<PostHogFunnel>("/projects/@current/insights/funnel/", {
+    method: "POST",
+    body: JSON.stringify(body),
+  });
+}
+
+// Feature flags operations
+export function getFeatureFlags(options?: {
+  limit?: number;
+}): Promise<PostHogListResponse<PostHogFeatureFlag>> {
+  const params: Record<string, string | number> = {};
+
+  if (options?.limit) {
+    params.limit = options.limit;
+  }
+
+  return posthogFetch<PostHogListResponse<PostHogFeatureFlag>>(
+    "/projects/@current/feature_flags/",
+    { params },
+  );
+}
+
+export function getFeatureFlag(flagId: number): Promise<PostHogFeatureFlag> {
+  return posthogFetch<PostHogFeatureFlag>(`/projects/@current/feature_flags/${flagId}/`);
+}
+
+// Persons operations
+export function listPersons(options?: {
+  limit?: number;
+  search?: string;
+}): Promise<PostHogListResponse<PostHogPerson>> {
+  const params: Record<string, string | number> = {};
+
+  if (options?.limit) {
+    params.limit = options.limit;
+  }
+
+  if (options?.search) {
+    params.search = options.search;
+  }
+
+  return posthogFetch<PostHogListResponse<PostHogPerson>>("/projects/@current/persons/", {
+    params,
+  });
+}
+
+export function getPerson(personId: string): Promise<PostHogPerson> {
+  return posthogFetch<PostHogPerson>(`/projects/@current/persons/${personId}/`);
+}
+
+// Event capture operations
+export function captureEvent(event: PostHogEvent): Promise<{ status: number }> {
+  const body = {
+    api_key: getApiKey(),
+    event: event.event,
+    distinct_id: event.distinct_id,
+    properties: event.properties || {},
+    timestamp: event.timestamp || new Date().toISOString(),
+  };
+
+  return posthogFetch<{ status: number }>("/capture/", {
+    method: "POST",
+    body: JSON.stringify(body),
+  });
+}
+
+// Helper functions
+export function formatDate(dateString: string): string {
+  return new Date(dateString).toISOString();
+}
+
+export function calculateConversionRate(funnel: PostHogFunnel): number {
+  if (!funnel.steps || funnel.steps.length < 2) {
+    return 0;
+  }
+
+  const firstStep = funnel.steps[0];
+  const lastStep = funnel.steps[funnel.steps.length - 1];
+
+  if (!firstStep || !lastStep || firstStep.count === 0) {
+    return 0;
+  }
+
+  return (lastStep.count / firstStep.count) * 100;
+}

package/dist/integrations/quickbooks/connector.json

@@ -0,0 +1,85 @@
+{
+  "name": "quickbooks",
+  "displayName": "QuickBooks",
+  "icon": "quickbooks.svg",
+  "description": "Manage invoices, customers, and accounting in QuickBooks",
+  "auth": {
+    "type": "oauth2",
+    "provider": "quickbooks",
+    "authorizationUrl": "https://appcenter.intuit.com/connect/oauth2",
+    "tokenUrl": "https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer",
+    "scopes": ["com.intuit.quickbooks.accounting"],
+    "callbackPath": "/api/auth/quickbooks/callback",
+    "requiredApis": [
+      {
+        "name": "QuickBooks Developer Portal",
+        "enableUrl": "https://developer.intuit.com/app/developer/myapps"
+      }
+    ]
+  },
+  "envVars": [
+    {
+      "name": "QUICKBOOKS_CLIENT_ID",
+      "description": "QuickBooks OAuth Client ID",
+      "required": true,
+      "sensitive": false,
+      "docsUrl": "https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0"
+    },
+    {
+      "name": "QUICKBOOKS_CLIENT_SECRET",
+      "description": "QuickBooks OAuth Client Secret",
+      "required": true,
+      "sensitive": true,
+      "docsUrl": "https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0"
+    }
+  ],
+  "tools": [
+    {
+      "id": "list-invoices",
+      "name": "List Invoices",
+      "description": "List invoices from QuickBooks",
+      "requiresWrite": false
+    },
+    {
+      "id": "get-invoice",
+      "name": "Get Invoice",
+      "description": "Get details of a specific invoice",
+      "requiresWrite": false
+    },
+    {
+      "id": "create-invoice",
+      "name": "Create Invoice",
+      "description": "Create a new invoice in QuickBooks",
+      "requiresWrite": true
+    },
+    {
+      "id": "list-customers",
+      "name": "List Customers",
+      "description": "List all customers in QuickBooks",
+      "requiresWrite": false
+    },
+    {
+      "id": "get-customer",
+      "name": "Get Customer",
+      "description": "Get details of a specific customer",
+      "requiresWrite": false
+    }
+  ],
+  "prompts": [
+    {
+      "id": "recent-invoices",
+      "title": "Show recent invoices",
+      "prompt": "List the most recent invoices from QuickBooks with their status and amounts.",
+      "category": "accounting",
+      "icon": "receipt"
+    },
+    {
+      "id": "create-invoice",
+      "title": "Create an invoice",
+      "prompt": "Create a new invoice for a customer with line items and amounts.",
+      "category": "accounting",
+      "icon": "plus"
+    }
+  ],
+  "suggestedWith": ["stripe", "xero", "hubspot"]
+}

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

@@ -0,0 +1,4 @@
+# QuickBooks OAuth Configuration
+# Get your credentials from https://developer.intuit.com/app/developer/myapps
+QUICKBOOKS_CLIENT_ID=your-client-id
+QUICKBOOKS_CLIENT_SECRET=your-client-secret

package/dist/integrations/quickbooks/files/ai/tools/create-invoice.ts

@@ -0,0 +1,48 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { createInvoice } from "../../lib/quickbooks-client.ts";
+
+export default tool({
+  id: "create-invoice",
+  description: "Create a new invoice in QuickBooks.",
+  inputSchema: z.object({
+    customerId: z.string().describe("The ID of the customer to invoice"),
+    lineItems: z.array(
+      z.object({
+        description: z.string().optional().describe("Description of the line item"),
+        amount: z.number().describe("Total amount for this line item"),
+        itemId: z.string().optional().describe("QuickBooks item/service ID"),
+        quantity: z.number().optional().describe("Quantity of items"),
+        unitPrice: z.number().optional().describe("Price per unit"),
+      }),
+    ).describe("Line items for the invoice"),
+    txnDate: z.string().optional().describe("Transaction date in YYYY-MM-DD format"),
+    dueDate: z.string().optional().describe("Due date in YYYY-MM-DD format"),
+    customerMemo: z.string().optional().describe("Memo/note for the customer"),
+  }),
+  async execute({ customerId, lineItems, txnDate, dueDate, customerMemo }) {
+    const invoice = await createInvoice({
+      customerId,
+      lineItems,
+      txnDate,
+      dueDate,
+      customerMemo,
+    });
+
+    return {
+      success: true,
+      invoice: {
+        id: invoice.Id,
+        docNumber: invoice.DocNumber,
+        txnDate: invoice.TxnDate,
+        dueDate: invoice.DueDate,
+        totalAmount: invoice.TotalAmt,
+        balance: invoice.Balance,
+        customer: {
+          id: invoice.CustomerRef.value,
+          name: invoice.CustomerRef.name,
+        },
+      },
+    };
+  },
+});

package/dist/integrations/quickbooks/files/ai/tools/get-customer.ts

@@ -0,0 +1,36 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { getCustomer } from "../../lib/quickbooks-client.ts";
+
+export default tool({
+  id: "get-customer",
+  description: "Get details of a specific QuickBooks customer by their ID.",
+  inputSchema: z.object({
+    customerId: z.string().describe("The ID of the customer to retrieve"),
+  }),
+  async execute({ customerId }) {
+    const customer = await getCustomer(customerId);
+
+    return {
+      id: customer.Id,
+      displayName: customer.DisplayName,
+      companyName: customer.CompanyName,
+      givenName: customer.GivenName,
+      familyName: customer.FamilyName,
+      email: customer.PrimaryEmailAddr?.Address,
+      phone: customer.PrimaryPhone?.FreeFormNumber,
+      address: customer.BillAddr ? {
+        line1: customer.BillAddr.Line1,
+        city: customer.BillAddr.City,
+        state: customer.BillAddr.CountrySubDivisionCode,
+        postalCode: customer.BillAddr.PostalCode,
+      } : undefined,
+      balance: customer.Balance,
+      active: customer.Active,
+      metadata: {
+        createTime: customer.MetaData?.CreateTime,
+        lastUpdatedTime: customer.MetaData?.LastUpdatedTime,
+      },
+    };
+  },
+});

package/dist/integrations/quickbooks/files/ai/tools/get-invoice.ts

@@ -0,0 +1,46 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { getInvoice } from "../../lib/quickbooks-client.ts";
+
+export default tool({
+  id: "get-invoice",
+  description: "Get details of a specific QuickBooks invoice by its ID.",
+  inputSchema: z.object({
+    invoiceId: z.string().describe("The ID of the invoice to retrieve"),
+  }),
+  async execute({ invoiceId }) {
+    const invoice = await getInvoice(invoiceId);
+
+    return {
+      id: invoice.Id,
+      docNumber: invoice.DocNumber,
+      txnDate: invoice.TxnDate,
+      dueDate: invoice.DueDate,
+      totalAmount: invoice.TotalAmt,
+      balance: invoice.Balance,
+      customer: {
+        id: invoice.CustomerRef.value,
+        name: invoice.CustomerRef.name,
+      },
+      status: invoice.TxnStatus,
+      emailStatus: invoice.EmailStatus,
+      billEmail: invoice.BillEmail?.Address,
+      lineItems: invoice.Line.map((line) => ({
+        id: line.Id,
+        lineNum: line.LineNum,
+        description: line.Description,
+        amount: line.Amount,
+        detailType: line.DetailType,
+        salesItemLineDetail: line.SalesItemLineDetail ? {
+          itemName: line.SalesItemLineDetail.ItemRef.name,
+          quantity: line.SalesItemLineDetail.Qty,
+          unitPrice: line.SalesItemLineDetail.UnitPrice,
+        } : undefined,
+      })),
+      metadata: {
+        createTime: invoice.MetaData?.CreateTime,
+        lastUpdatedTime: invoice.MetaData?.LastUpdatedTime,
+      },
+    };
+  },
+});

package/dist/integrations/quickbooks/files/ai/tools/list-customers.ts

@@ -0,0 +1,37 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { listCustomers } from "../../lib/quickbooks-client.ts";
+
+export default tool({
+  id: "list-customers",
+  description:
+    "List customers from QuickBooks. Can optionally filter by active status.",
+  inputSchema: z.object({
+    active: z.boolean().optional().describe("Filter by active status (true for active, false for inactive)"),
+    maxResults: z.number().min(1).max(100).default(20).describe("Maximum number of customers to return"),
+  }),
+  async execute({ active, maxResults }) {
+    const customers = await listCustomers({
+      active,
+      maxResults,
+    });
+
+    return customers.map((customer) => ({
+      id: customer.Id,
+      displayName: customer.DisplayName,
+      companyName: customer.CompanyName,
+      givenName: customer.GivenName,
+      familyName: customer.FamilyName,
+      email: customer.PrimaryEmailAddr?.Address,
+      phone: customer.PrimaryPhone?.FreeFormNumber,
+      address: customer.BillAddr ? {
+        line1: customer.BillAddr.Line1,
+        city: customer.BillAddr.City,
+        state: customer.BillAddr.CountrySubDivisionCode,
+        postalCode: customer.BillAddr.PostalCode,
+      } : undefined,
+      balance: customer.Balance,
+      active: customer.Active,
+    }));
+  },
+});

package/dist/integrations/quickbooks/files/ai/tools/list-invoices.ts

@@ -0,0 +1,40 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { listInvoices } from "../../lib/quickbooks-client.ts";
+
+export default tool({
+  id: "list-invoices",
+  description:
+    "List invoices from QuickBooks. Can optionally filter by customer ID.",
+  inputSchema: z.object({
+    customerId: z.string().optional().describe("Customer ID to filter invoices by"),
+    maxResults: z.number().min(1).max(100).default(20).describe("Maximum number of invoices to return"),
+  }),
+  async execute({ customerId, maxResults }) {
+    const invoices = await listInvoices({
+      customerId,
+      maxResults,
+    });
+
+    return invoices.map((invoice) => ({
+      id: invoice.Id,
+      docNumber: invoice.DocNumber,
+      txnDate: invoice.TxnDate,
+      dueDate: invoice.DueDate,
+      totalAmount: invoice.TotalAmt,
+      balance: invoice.Balance,
+      customer: {
+        id: invoice.CustomerRef.value,
+        name: invoice.CustomerRef.name,
+      },
+      status: invoice.TxnStatus,
+      emailStatus: invoice.EmailStatus,
+      lineItems: invoice.Line.map((line) => ({
+        description: line.Description,
+        amount: line.Amount,
+        quantity: line.SalesItemLineDetail?.Qty,
+        unitPrice: line.SalesItemLineDetail?.UnitPrice,
+      })),
+    }));
+  },
+});

package/dist/integrations/quickbooks/files/app/api/auth/quickbooks/callback/route.ts

@@ -0,0 +1,11 @@
+/**
+ * QuickBooks OAuth Callback
+ */
+
+import { quickbooksConfig, createOAuthCallbackHandler, memoryTokenStore } from "veryfront/oauth";
+
+export const GET = createOAuthCallbackHandler(quickbooksConfig, {
+  tokenStore: memoryTokenStore,
+  onSuccess: () => "/",
+  onError: () => "/",
+});

package/dist/integrations/quickbooks/files/app/api/auth/quickbooks/route.ts

@@ -0,0 +1,7 @@
+/**
+ * QuickBooks OAuth Init
+ */
+
+import { quickbooksConfig, createOAuthInitHandler } from "veryfront/oauth";
+
+export const GET = createOAuthInitHandler(quickbooksConfig);