@bigfootai/bigfoot-types 5.4.290 → 5.4.292

package/src/metadata/providers/freshdesk.ts

@@ -0,0 +1,136 @@
+import { BlockType } from '../../block-type.js';
+import { FieldType } from '../../field-type.js';
+import { FieldVariation } from '../../field-variation.js';
+import type { Provider, ProviderApplication } from '../../provider.js';
+import { type QueryMetadata, SearchOperator } from '../../query-metadata.js';
+import { TagType } from '../../tag-type.js';
+
+const TicketQuery: QueryMetadata = {
+	label: 'Ticket',
+	description: 'Search for tickets in Freshdesk',
+	metadataType: 'ticket',
+	searchFields: [
+		{
+			field: {
+				label: 'Status',
+				name: 'status',
+				description: 'The status of the ticket',
+				fieldType: FieldType.Select,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+				options: [
+					{ label: 'Open', value: '2' },
+					{ label: 'Pending', value: '3' },
+					{ label: 'Resolved', value: '4' },
+					{ label: 'Closed', value: '5' },
+				],
+			},
+			operators: [SearchOperator.Equals],
+		},
+		{
+			field: {
+				label: 'Priority',
+				name: 'priority',
+				description: 'The priority of the ticket',
+				fieldType: FieldType.Select,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+				options: [
+					{ label: 'Low', value: '1' },
+					{ label: 'Medium', value: '2' },
+					{ label: 'High', value: '3' },
+					{ label: 'Urgent', value: '4' },
+				],
+			},
+			operators: [SearchOperator.Equals],
+		},
+		{
+			field: {
+				label: 'Tag',
+				name: 'tag',
+				description: 'A tag applied to the ticket',
+				fieldType: FieldType.Text,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+			},
+			operators: [SearchOperator.Equals],
+		},
+		{
+			field: {
+				label: 'Created At',
+				name: 'created_at',
+				description: 'When the ticket was created',
+				fieldType: FieldType.Text,
+				fieldVariation: FieldVariation.Date,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+			},
+			operators: [SearchOperator.Gte, SearchOperator.Lte, SearchOperator.Between],
+		},
+	],
+};
+
+export const FreshdeskSupport: ProviderApplication = {
+	name: 'support',
+	sobjects: {
+		calendar: false,
+		transcription: false,
+		message: false,
+		email: false,
+		table: true,
+		function: false,
+	},
+	linkSubscriptions: ['*.freshdesk.com'],
+	// Agent-portal URLs: https://<sub>.freshdesk.com/a/{tickets|contacts|companies}/{id}
+	linkToExternalIdRegex: '/a/(?:tickets|contacts|companies)/(\\d+)',
+	tableSubscriptions: ['ticket'],
+	queryTypeSubscriptions: [TicketQuery.metadataType],
+	description: "Add Ticket previews and monitor changes over time so you're always up-to-date.",
+	iconUrl: 'https://connect-freshdesk-dev.getnoded.ai/images/logo.png',
+	label: 'Freshdesk Support',
+	authentication: true,
+	externalStorage: true,
+	externalInsights: false,
+	externalIds: [
+		{
+			label: 'Company',
+			blockType: BlockType.Record,
+			tagType: TagType.Topic,
+			tagSubType: 'organization',
+			metadataType: 'company',
+		},
+		{
+			label: 'Requester',
+			blockType: BlockType.Record,
+			tagType: TagType.Person,
+			tagSubType: 'contact',
+			metadataType: 'contact',
+		},
+		{
+			label: 'Agent',
+			blockType: BlockType.Record,
+			tagType: TagType.Person,
+			tagSubType: 'user',
+			metadataType: 'agent',
+		},
+	],
+};
+
+export const Freshdesk: Provider = {
+	_id: 'e248e537ab81831ae8563aa6',
+	archived: false,
+	dateCreated: 0,
+	dateUpdated: 0,
+	name: 'freshdesk',
+	description: 'Freshdesk automation for Noded',
+	instanceUrl: 'https://connect-freshdesk-dev.getnoded.ai',
+	applications: [FreshdeskSupport],
+	label: 'Freshdesk',
+	iconUrl: 'https://connect-freshdesk-dev.getnoded.ai/images/logo.png',
+	promptMetadata: [],
+	queryMetadata: [TicketQuery],
+};

package/src/metadata/providers/generate.ts

@@ -1,22 +1,22 @@
-// import * as fs from 'node:fs';
-// import { G2 } from './g2.js';
-// import { Gong } from './gong.js';
-// import { Zoom } from './zoom.js';
-// import { Google } from './google.js';
-// import { HubSpot } from './hubspot.js';
-// import { Linear } from './linear.js';
-// import { Noded } from './noded.js';
-// import { Salesforce } from './salesforce.js';
-// import { Slack } from './slack.js';
+/*import * as fs from 'node:fs';
+import * as path from 'node:path';
+import type { Provider } from '../../provider.js';
+import { ClickHouse } from './clickhouse.js';
+import { Freshdesk } from './freshdesk.js';
+import { HubSpot } from './hubspot.js';
+import { Intercom } from './intercom.js';
+import { PowerBI } from './powerbi.js';
 
-// export const generateProviders = () => {
-//     fs.writeFileSync('g2.json', JSON.stringify(G2, null, 2));
-//     fs.writeFileSync('gong.json', JSON.stringify(Gong, null, 2));
-//     fs.writeFileSync('zoom.json', JSON.stringify(Zoom, null, 2));
-//     fs.writeFileSync('google.json', JSON.stringify(Google, null, 2));
-//     fs.writeFileSync('hubspot.json', JSON.stringify(HubSpot, null, 2));
-//     fs.writeFileSync('linear.json', JSON.stringify(Linear, null, 2));
-//     fs.writeFileSync('noded.json', JSON.stringify(Noded, null, 2));
-//     fs.writeFileSync('salesforce.json', JSON.stringify(Salesforce, null, 2));
-//     fs.writeFileSync('stack.json', JSON.stringify(Slack, null, 2));
-// };
+const providers: Provider[] = [ClickHouse, Freshdesk, HubSpot, Intercom, PowerBI];
+
+export const generateProviders = (outDir: string = import.meta.dirname) => {
+	for (const provider of providers) {
+		fs.writeFileSync(path.join(outDir, `${provider.name}.json`), JSON.stringify(provider, null, 2));
+	}
+};
+
+// Run directly: `tsx generate.ts` to (re)generate the provider JSON files.
+if (process.argv[1] === import.meta.filename) {
+	generateProviders();
+}
+*/

package/src/metadata/providers/hubspot.ts

@@ -1,8 +1,72 @@
 import { BlockType } from '../../block-type.js';
 import { ORGANIZATION } from '../../constants.js';
+import { FieldType } from '../../field-type.js';
+import { FieldVariation } from '../../field-variation.js';
 import type { Provider, ProviderApplication } from '../../provider.js';
+import { type QueryMetadata, SearchOperator } from '../../query-metadata.js';
 import { TagType } from '../../tag-type.js';
 
+const CompanyQuery: QueryMetadata = {
+	label: 'Company',
+	description: 'Search for companies in HubSpot CRM',
+	metadataType: 'companies',
+	searchFields: [
+		{
+			field: {
+				label: 'Company Name',
+				name: 'name',
+				description: 'The name of the company',
+				fieldType: FieldType.Text,
+				fieldVariation: null,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+			},
+			defaultFor: 'name',
+			operators: [SearchOperator.Equals, SearchOperator.Contains, SearchOperator.StartsWith],
+		},
+		{
+			field: {
+				label: 'Domain',
+				name: 'domain',
+				description: 'The primary domain of the company',
+				fieldType: FieldType.Text,
+				fieldVariation: FieldVariation.Url,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+			},
+			defaultFor: 'url',
+			operators: [SearchOperator.Equals, SearchOperator.Contains, SearchOperator.StartsWith],
+		},
+		{
+			field: {
+				label: 'Phone',
+				name: 'phone',
+				description: 'The primary phone number of the company',
+				fieldType: FieldType.Text,
+				fieldVariation: FieldVariation.Phone,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+			},
+			operators: [SearchOperator.Equals, SearchOperator.Contains],
+		},
+		{
+			field: {
+				label: 'Industry',
+				name: 'industry',
+				description: 'The industry the company belongs to',
+				fieldType: FieldType.Select,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+			},
+			operators: [SearchOperator.Equals],
+		},
+	],
+};
+
 export const HubSpotCrm: ProviderApplication = {
 	name: 'crm',
 	sobjects: {
@@ -15,35 +79,40 @@ export const HubSpotCrm: ProviderApplication = {
 	},
 	// CRM record pages only (universal /record/ route covers Contacts, Companies, Deals, and custom objects). Reports, settings, marketing surfaces fall through to website ingestion.
 	linkSubscriptions: ['^https://app\\.hubspot\\.com/contacts/\\d+/record/'],
-	linkToExternalIdRegex: '/(d+)$/',
-	tableSubscriptions: ['noded.opportunity', 'noded.case'],
+	// Record id is the trailing numeric path segment: .../record/{objectTypeId}/{recordId}
+	linkToExternalIdRegex: '(?<=/record/[\\w-]+/)\\d+',
+	tableSubscriptions: ['noded.opportunity', 'noded.case', 'companies', 'contacts', 'deals', 'tickets'],
+	queryTypeSubscriptions: [CompanyQuery.metadataType],
 	description: "Add Ticket and Deal previews and monitor changes over time so you're always up-to-date.",
 	iconUrl: 'https://cdn.icon-icons.com/icons2/2699/PNG/512/hubspot_logo_icon_170009.png',
 	label: 'HubSpot CRM',
 	authentication: true,
 	externalStorage: true,
-	externalInsights: false,
+	externalInsights: true,
 	externalIds: [
 		{
-			label: 'Account',
+			label: 'Company',
 			blockType: BlockType.Record,
 			tagType: TagType.Topic,
 			tagSubType: ORGANIZATION,
-			metadataType: 'account',
+			metadataType: 'companies',
+			requireExternalId: true,
 		},
 		{
 			label: 'Contact',
 			blockType: BlockType.Record,
 			tagType: TagType.Person,
 			tagSubType: 'contact',
-			metadataType: 'contact',
+			metadataType: 'contacts',
+			requireExternalId: true,
 		},
 		{
-			label: 'User',
+			label: 'Owner',
 			blockType: BlockType.Record,
 			tagType: TagType.Person,
 			tagSubType: 'user',
-			metadataType: 'user',
+			metadataType: 'owners',
+			requireExternalId: true,
 		},
 	],
 };
@@ -60,4 +129,5 @@ export const HubSpot: Provider = {
 	label: 'HubSpot',
 	iconUrl: 'https://cdn.icon-icons.com/icons2/2699/PNG/512/hubspot_logo_icon_170009.png',
 	promptMetadata: [],
+	queryMetadata: [CompanyQuery],
 };

package/src/metadata/providers/index.ts

@@ -1,16 +1,19 @@
 export * from './atlassian.js';
+export * from './clickhouse.js';
 export * from './databricks.js';
 export * from './fathom.js';
+export * from './freshdesk.js';
 export * from './g2.js';
-export * from './generate.js';
 export * from './gong.js';
 export * from './google.js';
 export * from './granola.js';
 export * from './hubspot.js';
+export * from './intercom.js';
 export * from './linear.js';
 export * from './linkedin.js';
 export * from './microsoft.js';
 export * from './noded.js';
+export * from './powerbi.js';
 export * from './salesforce.js';
 export * from './slack.js';
 export * from './zendesk.js';

package/src/metadata/providers/intercom.ts

@@ -0,0 +1,106 @@
+import { BlockType } from '../../block-type.js';
+import { FieldType } from '../../field-type.js';
+import { FieldVariation } from '../../field-variation.js';
+import type { Provider, ProviderApplication } from '../../provider.js';
+import { type QueryMetadata, SearchOperator } from '../../query-metadata.js';
+import { TagType } from '../../tag-type.js';
+
+const ContactQuery: QueryMetadata = {
+	label: 'Contact',
+	description: 'Search for contacts (users and leads) in Intercom',
+	metadataType: 'contact',
+	searchFields: [
+		{
+			field: {
+				label: 'Name',
+				name: 'name',
+				description: 'The name of the contact',
+				fieldType: FieldType.Text,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+			},
+			operators: [SearchOperator.Equals, SearchOperator.Contains, SearchOperator.StartsWith],
+		},
+		{
+			field: {
+				label: 'Email',
+				name: 'email',
+				description: 'The email address of the contact',
+				fieldType: FieldType.Text,
+				fieldVariation: FieldVariation.Email,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+			},
+			operators: [SearchOperator.Equals, SearchOperator.Contains],
+		},
+		{
+			field: {
+				label: 'Created At',
+				name: 'created_at',
+				description: 'When the contact was created',
+				fieldType: FieldType.Text,
+				fieldVariation: FieldVariation.Date,
+				readOnly: true,
+				visible: true,
+				source: 'system',
+			},
+			operators: [SearchOperator.Gte, SearchOperator.Lte, SearchOperator.Between],
+		},
+	],
+};
+
+export const IntercomSupport: ProviderApplication = {
+	name: 'support',
+	sobjects: {
+		calendar: false,
+		transcription: false,
+		message: false,
+		email: false,
+		table: true,
+		function: false,
+	},
+	linkSubscriptions: ['*.intercom.com'],
+	// App URLs: https://app.intercom.com/a/apps/<workspace>/{inbox/conversation|users|companies}/<id>
+	linkToExternalIdRegex: '/(?:conversation|users|companies)/([a-f0-9]+)',
+	tableSubscriptions: ['conversation'],
+	queryTypeSubscriptions: [ContactQuery.metadataType],
+	description: "Add Conversation previews and monitor changes over time so you're always up-to-date.",
+	iconUrl: 'https://connect-intercom-dev.getnoded.ai/images/logo.png',
+	label: 'Intercom Support',
+	authentication: true,
+	externalStorage: true,
+	externalInsights: false,
+	externalIds: [
+		{
+			label: 'Company',
+			blockType: BlockType.Record,
+			tagType: TagType.Topic,
+			tagSubType: 'organization',
+			metadataType: 'company',
+		},
+		{
+			label: 'Contact',
+			blockType: BlockType.Record,
+			tagType: TagType.Person,
+			tagSubType: 'contact',
+			metadataType: 'contact',
+		},
+	],
+};
+
+export const Intercom: Provider = {
+	_id: '6a4d13ca7864df33248d993a',
+	archived: false,
+	dateCreated: 0,
+	dateUpdated: 0,
+	name: 'intercom',
+	description: 'Intercom automation for Noded',
+	instanceUrl: 'https://connect-intercom-dev.getnoded.ai',
+	applications: [IntercomSupport],
+	label: 'Intercom',
+	iconUrl: 'https://connect-intercom-dev.getnoded.ai/images/logo.png',
+	promptMetadata: [],
+	queryMetadata: [ContactQuery],
+};

package/src/metadata/providers/powerbi.ts

@@ -0,0 +1,47 @@
+import { BlockType } from '../../block-type.js';
+import { ORGANIZATION } from '../../constants.js';
+import type { Provider, ProviderApplication } from '../../provider.js';
+import { TagType } from '../../tag-type.js';
+
+export const PowerBIAnalytics: ProviderApplication = {
+	name: 'analytics',
+	sobjects: {
+		calendar: false,
+		transcription: false,
+		message: false,
+		email: false,
+		table: true,
+		function: false,
+	},
+	description: 'Query Power BI semantic models to surface insights directly in Noded.',
+	iconUrl: 'https://connect-powerbi-dev.getnoded.ai/images/logo.svg',
+	label: 'Power BI Analytics',
+	authentication: true,
+	externalStorage: false,
+	externalInsights: true,
+	externalIds: [
+		{
+			label: 'Account',
+			blockType: BlockType.Record,
+			tagType: TagType.Topic,
+			metadataType: 'account',
+			tagSubType: ORGANIZATION,
+			requireExternalId: true,
+		},
+	],
+};
+
+export const PowerBI: Provider = {
+	_id: '4b06b68fccd5edd7193f6397',
+	archived: false,
+	dateCreated: 0,
+	dateUpdated: 0,
+	name: 'powerbi',
+	description: 'Power BI integration for Noded',
+	instanceUrl: 'https://connect-powerbi-dev.getnoded.ai',
+	applications: [PowerBIAnalytics],
+	label: 'Power BI',
+	iconUrl: 'https://connect-powerbi-dev.getnoded.ai/images/logo.svg',
+	promptMetadata: [],
+	tableMetadata: [],
+};

package/src/recommendation.ts

@@ -40,6 +40,7 @@ export enum RecommendationType {
 	Message = 'message',
 	Notification = 'notification',
 	OnboardingComplete = 'onboarding_complete',
+	OnboardingStarted = 'onboarding_started',
 	PriorityTasks = 'priority_tasks',
 	Reaction = 'reaction',
 	Share = 'share',

package/src/types.ts

@@ -322,6 +322,7 @@ export enum RecommendationType {
 	Message = 'message',
 	Notification = 'notification',
 	OnboardingComplete = 'onboarding_complete',
+	OnboardingStarted = 'onboarding_started',
 	PriorityTasks = 'priority_tasks',
 	Reaction = 'reaction',
 	Share = 'share',
@@ -2410,9 +2411,11 @@ export interface FindSearchInput {
 export const FindSearchesInputQL = `
 input FindSearchesInput {
   ${PaginatedInputFieldsQL}
+  _ids: [String]
   archived: Boolean! = false
 }`;
 export interface FindSearchesInput extends PaginatedInput {
+	_ids?: string[];
 	archived: boolean;
 }
 
@@ -2606,6 +2609,7 @@ enum RecommendationType {
   ${RecommendationType.Share.toUpperCase()}
   ${RecommendationType.Upsert.toUpperCase()}
   ${RecommendationType.Notification.toUpperCase()}
+  ${RecommendationType.OnboardingStarted.toUpperCase()}
   ${RecommendationType.OnboardingComplete.toUpperCase()}
   ${RecommendationType.Ingestion.toUpperCase()}
   ${RecommendationType.SyncPaused.toUpperCase()}