@agnocon/piece-bitly 0.1.7

package/dist/lib/triggers/new-bitlink-created.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-bitlink-created.js","sourceRoot":"","sources":["../../../src/lib/triggers/new-bitlink-created.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@agnocon/piece-bitly",
+  "version": "0.1.7",
+  "description": "AgnoCon bitly connector",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE.MIT-AP"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "vendor": "node ../scripts/vendor-ap.mjs piece-bitly"
+  },
+  "dependencies": {
+    "@agnocon/core-utils": "0.2.0",
+    "@agnocon/piece-types": "0.3.1",
+    "@agnocon/pieces-common": "0.12.8",
+    "@agnocon/pieces-framework": "0.36.0",
+    "tslib": "2.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "20.17.6",
+    "typescript": "5.5.4"
+  },
+  "license": "MIT",
+  "agnocon": {
+    "originVersion": "0.1.7"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "tag": "latest"
+  },
+  "keywords": [
+    "agnocon",
+    "connector"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,38 @@
+import { createCustomApiCallAction } from '@agnocon/pieces-common';
+import { createPiece } from '@agnocon/pieces-framework';
+import { PieceCategory } from '@agnocon/pieces-framework';
+import { bitlyAuth } from './lib/common/auth';
+import { newBitlinkCreatedTrigger } from './lib/triggers/new-bitlink-created';
+import { archiveBitlinkAction } from './lib/actions/archive-bitlink';
+import { createBitlinkAction } from './lib/actions/create-bitlink';
+import { createQrCodeAction } from './lib/actions/create-qr-code';
+import { getBitlinkDetailsAction } from './lib/actions/get-bitlink-details';
+import { updateBitlinkAction } from './lib/actions/update-bitlink';
+
+export const bitly = createPiece({
+  displayName: 'Bitly',
+  description: 'URL shortening and link management platform with analytics.',
+  auth: bitlyAuth,
+  minimumSupportedRelease: '0.20.0',
+  logoUrl: 'https://cdn.activepieces.com/pieces/bitly.png',
+  authors: ['aryel780'],
+  categories: [PieceCategory.MARKETING],
+  actions: [
+    archiveBitlinkAction,
+    createBitlinkAction,
+    createQrCodeAction,
+    getBitlinkDetailsAction,
+    updateBitlinkAction,
+    createCustomApiCallAction({
+      auth: bitlyAuth,
+      baseUrl: () => 'https://api-ssl.bitly.com/v4',
+      authMapping: async (auth) => {
+        const { accessToken } = auth.props;
+        return {
+          Authorization: `Bearer ${accessToken}`,
+        };
+      },
+    }),
+  ],
+  triggers: [ newBitlinkCreatedTrigger ],
+});

package/src/lib/actions/archive-bitlink.ts

@@ -0,0 +1,59 @@
+import { HttpMethod } from '@agnocon/pieces-common';
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { bitlyApiCall } from '../common/client';
+import { bitlyAuth } from '../common/auth';
+import { bitlinkDropdown, groupGuid } from '../common/props';
+
+export const archiveBitlinkAction = createAction({
+  auth: bitlyAuth,
+  name: 'archive_bitlink',
+  displayName: 'Archive Bitlink',
+  description: 'Archive a Bitlink to stop redirects.',
+  audience: 'both',
+  aiMetadata: { description: 'Archives an existing Bitlink so it stops redirecting, identified by its Bitlink ID (e.g. bit.ly/xyz123). Use to retire or disable a short link. Idempotent: re-archiving an already-archived link leaves it archived with no additional effect.', idempotent: true },
+  props: {
+    group_guid: groupGuid,
+    bitlink: bitlinkDropdown,
+  },
+  async run(context) {
+    const { bitlink } = context.propsValue;
+
+    try {
+      const body = {
+        archived: true,
+      };
+
+      return await bitlyApiCall({
+        method: HttpMethod.PATCH,
+        auth: context.auth.props,
+        resourceUri: `/bitlinks/${bitlink}`,
+        body,
+      });
+
+    } catch (error: any) {
+      const errorMessage = error.response?.data?.description || error.response?.data?.message || error.message;
+
+      if (error.response?.status === 429) {
+        throw new Error(
+          'Rate limit exceeded. Please wait before trying again.'
+        );
+      }
+
+      if (error.response?.status === 404) {
+        throw new Error(
+          `Bitlink not found: ${errorMessage}. Please verify the link (e.g., 'bit.ly/xyz123') is correct.`
+        );
+      }
+
+      if (error.response?.status === 401 || error.response?.status === 403) {
+        throw new Error(
+          `Authentication failed or forbidden: ${errorMessage}. Please check your Access Token and permissions.`
+        );
+      }
+
+      throw new Error(
+        `Failed to archive Bitlink: ${errorMessage || 'Unknown error occurred'}`
+      );
+    }
+  },
+});

package/src/lib/actions/create-bitlink.ts

@@ -0,0 +1,158 @@
+import { HttpMethod } from '@agnocon/pieces-common';
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { bitlyApiCall } from '../common/client';
+import { bitlyAuth } from '../common/auth';
+import { groupGuid, domain } from '../common/props';
+
+export const createBitlinkAction = createAction({
+  auth: bitlyAuth,
+  name: 'create_bitlink',
+  displayName: 'Create Bitlink',
+  description: 'Shorten a long URL with optional customization.',
+  audience: 'both',
+  aiMetadata: { description: 'Shortens a long URL into a Bitlink, optionally setting title, tags, custom branded domain, and mobile app deeplinks. Use to create a trackable short link from a destination URL (must start with http:// or https://). Not idempotent: each call creates a link, though Bitly may return an existing Bitlink for the same URL unless Force New Link is enabled.', idempotent: false },
+  props: {
+    long_url: Property.ShortText({
+      displayName: 'Long URL',
+      description: 'The URL to shorten (must include http:// or https://).',
+      required: true,
+    }),
+    group_guid: groupGuid,
+    domain: {
+      ...domain,
+      defaultValue: 'bit.ly',
+    },
+    title: Property.ShortText({
+      displayName: 'Title',
+      description: 'Custom title for the Bitlink.',
+      required: false,
+    }),
+    tags: Property.Array({
+      displayName: 'Tags',
+      description: 'Tags to apply to the Bitlink.',
+      required: false,
+    }),
+    force_new_link: Property.Checkbox({
+      displayName: 'Force New Link',
+      description: 'Create new link even if one exists for this URL.',
+      required: false,
+      defaultValue: false,
+    }),
+    // Mobile App Deeplink Configuration
+    app_id: Property.ShortText({
+      displayName: 'Mobile App ID',
+      description: 'Mobile app identifier (e.g., com.yourapp.name).',
+      required: false,
+    }),
+    app_uri_path: Property.ShortText({
+      displayName: 'App URI Path',
+      description: 'Path within the mobile app (e.g., /product/123).',
+      required: false,
+    }),
+    install_url: Property.LongText({
+      displayName: 'App Install URL',
+      description: 'URL where users can install the mobile app.',
+      required: false,
+    }),
+    install_type: Property.StaticDropdown({
+      displayName: 'Install Type',
+      description: 'How to handle app installation.',
+      required: false,
+      options: {
+        disabled: false,
+        options: [
+          { label: 'No Install', value: 'no_install' },
+          { label: 'Auto Install', value: 'auto_install' },
+          { label: 'Promote Install', value: 'promote_install' },
+        ],
+      },
+    }),
+  },
+  async run(context) {
+    const {
+      long_url,
+      group_guid,
+      domain,
+      title,
+      tags,
+      force_new_link,
+      app_id,
+      app_uri_path,
+      install_url,
+      install_type,
+    } = context.propsValue;
+
+    try {
+      // Pre-flight validation
+      if (!long_url.startsWith('http://') && !long_url.startsWith('https://')) {
+        throw new Error(
+          "Invalid Long URL. It must start with 'http://' or 'https://'."
+        );
+      }
+
+      const body: Record<string, unknown> = { long_url };
+
+      if (group_guid) {
+        body['group_guid'] = group_guid;
+      }
+      if (domain) {
+        body['domain'] = domain;
+      }
+      if (title) {
+        body['title'] = title;
+      }
+      if (tags && tags.length > 0) {
+        body['tags'] = tags;
+      }
+      if (force_new_link) {
+        body['force_new_link'] = force_new_link;
+      }
+      
+      // Build deeplinks array if app configuration is provided
+      if (app_id && app_uri_path && install_url && install_type) {
+        body['deeplinks'] = [
+          {
+            app_id,
+            app_uri_path,
+            install_url,
+            install_type,
+          },
+        ];
+      }
+
+      return await bitlyApiCall({
+        method: HttpMethod.POST,
+        auth: context.auth.props,
+        resourceUri: '/bitlinks',
+        body,
+      });
+    } catch (error: any) {
+      const errorMessage =
+        error.response?.data?.description ||
+        error.response?.data?.message ||
+        error.message;
+
+      if (error.response?.status === 429) {
+        throw new Error(
+          'Rate limit exceeded. Please wait before trying again.'
+        );
+      }
+
+      if (error.response?.status === 422) {
+        throw new Error(
+          `Unprocessable Entity: ${errorMessage}. Please check the format of your Long URL or other inputs.`
+        );
+      }
+
+      if (error.response?.status === 401 || error.response?.status === 403) {
+        throw new Error(
+          `Authentication failed or forbidden: ${errorMessage}. Please check your Access Token and permissions.`
+        );
+      }
+
+      throw new Error(
+        `Failed to create Bitlink: ${errorMessage || 'Unknown error occurred'}`
+      );
+    }
+  },
+});