chore: import upstream snapshot with attribution

bots/clog/bot.definition.ts

@@ -0,0 +1,41 @@
+import * as sdk from '@botpress/sdk'
+import slack from 'bp_modules/slack'
+
+export default new sdk.BotDefinition({
+  states: {
+    metaApiVersions: {
+      type: 'bot',
+      schema: sdk.z.object({
+        currentGraphApiVersion: sdk.z
+          .string()
+          .optional()
+          .describe("The current Meta's Graph API version")
+          .title('Current Graph API Version'),
+      }),
+    },
+  },
+  events: {
+    timeToCheckApi: {
+      schema: sdk.z.object({}),
+    },
+  },
+  recurringEvents: {
+    timeToCheckApi: {
+      type: 'timeToCheckApi',
+      schedule: { cron: '0 * * * *' },
+      payload: sdk.z.object({}),
+    },
+  },
+}).addIntegration(slack, {
+  enabled: true,
+  configurationType: null,
+  configuration: {
+    typingIndicatorEmoji: false,
+    botName: 'Clog',
+    botAvatarUrl: 'https://files.bpcontent.cloud/2025/06/16/20/20250616204038-BRUW6C2R.svg',
+    replyBehaviour: {
+      location: 'channel',
+      onlyOnBotMention: false,
+    },
+  },
+})

bots/clog/eslint.config.mjs

@@ -0,0 +1,13 @@
+import rootConfig from '../../eslint.config.mjs'
+
+export default [
+  ...rootConfig,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+]

bots/clog/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@bp-bots/clog",
+  "scripts": {
+    "check:type": "tsc --noEmit",
+    "check:bplint": "bp lint",
+    "build": "bp add -y && bp build"
+  },
+  "private": true,
+  "dependencies": {
+    "@botpress/client": "workspace:*",
+    "@botpress/sdk": "workspace:*",
+    "cheerio": "^1.1.2"
+  },
+  "devDependencies": {
+    "@botpress/cli": "workspace:*",
+    "@botpress/sdk": "workspace:*",
+    "@botpresshub/slack": "workspace:*"
+  },
+  "bpDependencies": {
+    "slack": "../../integrations/slack"
+  }
+}

bots/clog/src/index.ts

@@ -0,0 +1,90 @@
+import * as cheerio from 'cheerio'
+import * as bp from '.botpress'
+
+const SLACK_CHANNEL_TO_PING = 'alert-squid'
+
+const bot = new bp.Bot({
+  actions: {},
+})
+
+const _resolveSlackChannelId = async (client: bp.Client, channelName: string): Promise<string | undefined> => {
+  const { output } = await client.callAction({
+    type: 'slack:findTarget',
+    input: { query: channelName, channel: 'channel' },
+  })
+  const exact = output.targets.find((t) => t.displayName === channelName)
+  return (exact ?? output.targets[0])?.tags.id
+}
+
+const _handleApiChange = async (
+  message: string,
+  newGraphApiVersion: string | undefined,
+  props: bp.EventHandlerProps
+): Promise<void> => {
+  const { client, logger } = props
+  logger.info(message)
+  const channelId = await _resolveSlackChannelId(client, SLACK_CHANNEL_TO_PING)
+  if (!channelId) {
+    logger.error(`Could not find Slack channel '${SLACK_CHANNEL_TO_PING}'`)
+    return
+  }
+  const response = await client.callAction({
+    type: 'slack:getOrCreateChannelConversation',
+    input: { conversation: { channelId } },
+  })
+  await client.createMessage({
+    type: 'text',
+    conversationId: response.output.conversationId,
+    tags: {},
+    userId: props.ctx.botId,
+    payload: {
+      text: message,
+    },
+  })
+  await client.setState({
+    name: 'metaApiVersions',
+    type: 'bot',
+    id: props.ctx.botId,
+    payload: { currentGraphApiVersion: newGraphApiVersion },
+  })
+}
+
+// Checks if starts with v, has a number of at least one digit, a dot and a single digit (e.g. v00.0)
+const versionRegexp: RegExp = /v\d+.\d/i
+const isVersionString = (s: string): boolean => versionRegexp.test(s)
+
+bot.on.event('timeToCheckApi', async (props) => {
+  const { client, ctx, logger } = props
+  const { state } = await client.getOrSetState({
+    name: 'metaApiVersions',
+    type: 'bot',
+    id: ctx.botId,
+    payload: { currentGraphApiVersion: undefined },
+  })
+  const currentGraphApiVersion = state.payload.currentGraphApiVersion
+
+  const response = await fetch('https://developers.facebook.com/docs/graph-api/changelog/')
+  const html = await response.text()
+  const selector = cheerio.load(html)
+  const newGraphApiVersion = selector('code').first().text().trim()
+
+  if (!isVersionString(newGraphApiVersion)) {
+    await _handleApiChange(
+      `I failed reading the Meta's API version, I received\n${newGraphApiVersion}`,
+      undefined,
+      props
+    )
+  } else if (currentGraphApiVersion === undefined) {
+    await _handleApiChange(
+      `I'll notify you when Meta's Graph API version will change.\nThe current version is ${newGraphApiVersion}`,
+      newGraphApiVersion,
+      props
+    )
+  } else if (currentGraphApiVersion !== newGraphApiVersion) {
+    await _handleApiChange(`Meta's Graph API version changed to: ${newGraphApiVersion}`, newGraphApiVersion, props)
+  } else {
+    logger.info(`Meta's Graph API version is ${newGraphApiVersion}`)
+  }
+})
+
+export default bot

bots/clog/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "paths": { "*": ["./*"] },
+    "outDir": "dist"
+  },
+  "include": [".botpress/**/*", "src/**/*", "*.ts"]
+}