@agnocon/piece-bigcommerce 0.1.11

package/src/lib/triggers/order-status-updated.ts

@@ -0,0 +1,60 @@
+import { createTrigger, TriggerStrategy } from '@agnocon/pieces-framework';
+import { bigcommerceAuth } from '../common/auth';
+import { bigCommerceApiService } from '../common/requests';
+
+const TRIGGER_NAME = 'order status updated';
+const CACHE_KEY = `${TRIGGER_NAME}-trigger-store-key`;
+const TRIGGER_SCOPE = 'store/order/statusUpdated';
+
+export const orderStatusUpdated = createTrigger({
+  auth: bigcommerceAuth,
+  name: 'orderStatusUpdated',
+  displayName: 'Order Status Updated',
+  description: 'Triggers when an order status has changed',
+  aiMetadata: {
+    description:
+      'Fires specifically when an order’s status changes in the BigCommerce store (e.g. moves to shipped or completed). Use this instead of Order Updated when you only care about status transitions. The event identifies the affected order.',
+  },
+  props: {},
+  sampleData: {
+    producer: 'stores/xqcaklwsso',
+    hash: 'd7b899890f5e0e98a3e074f018b14b07d5d89360',
+    created_at: 1761808595,
+    store_id: '1003425529',
+    scope: 'store/order/statusUpdated',
+    data: {
+      type: 'order',
+      id: 2,
+    },
+  },
+  type: TriggerStrategy.WEBHOOK,
+  async onEnable(context) {
+    const webhook = await bigCommerceApiService.createWebhook({
+      auth: context.auth.props,
+      payload: {
+        scope: TRIGGER_SCOPE,
+        destination: context.webhookUrl,
+        is_active: true,
+      },
+    });
+
+    await context.store.put(CACHE_KEY, webhook.data.id);
+  },
+  async onDisable(context) {
+    const webhookId = (await context.store.get(CACHE_KEY)) as string;
+
+    if (webhookId) {
+      await bigCommerceApiService
+        .deleteWebhook({
+          auth: context.auth.props,
+          webhookId,
+        })
+        .then(async () => {
+          await context.store.delete(CACHE_KEY);
+        });
+    }
+  },
+  async run(context) {
+    return [context.payload.body];
+  },
+});

package/src/lib/triggers/order-updated.ts

@@ -0,0 +1,60 @@
+import { createTrigger, TriggerStrategy } from '@agnocon/pieces-framework';
+import { bigcommerceAuth } from '../common/auth';
+import { bigCommerceApiService } from '../common/requests';
+
+const TRIGGER_NAME = 'order updated';
+const CACHE_KEY = `${TRIGGER_NAME}-trigger-store-key`;
+const TRIGGER_SCOPE = 'store/order/updated';
+
+export const orderUpdated = createTrigger({
+  auth: bigcommerceAuth,
+  name: 'orderUpdated',
+  displayName: 'Order Updated',
+  description: 'Triggers when an order is updated',
+  aiMetadata: {
+    description:
+      'Fires when an existing order is updated in the BigCommerce store (any change to the order, not just its status). The event identifies the affected order; pair with Get Order for full details.',
+  },
+  props: {},
+  sampleData: {
+    producer: 'stores/xqcaklwsso',
+    hash: 'd7b899890f5e0e98a3e074f018b14b07d5d89360',
+    created_at: 1761808595,
+    store_id: '1003425529',
+    scope: 'store/order/updated',
+    data: {
+      type: 'order',
+      id: 2,
+    },
+  },
+  type: TriggerStrategy.WEBHOOK,
+  async onEnable(context) {
+    const webhook = await bigCommerceApiService.createWebhook({
+      auth: context.auth.props,
+      payload: {
+        scope: TRIGGER_SCOPE,
+        destination: context.webhookUrl,
+        is_active: true,
+      },
+    });
+
+    await context.store.put(CACHE_KEY, webhook.data.id);
+  },
+  async onDisable(context) {
+    const webhookId = (await context.store.get(CACHE_KEY)) as string;
+
+    if (webhookId) {
+      await bigCommerceApiService
+        .deleteWebhook({
+          auth: context.auth.props,
+          webhookId,
+        })
+        .then(async () => {
+          await context.store.delete(CACHE_KEY);
+        });
+    }
+  },
+  async run(context) {
+    return [context.payload.body];
+  },
+});

package/src/lib/triggers/product-created.ts

@@ -0,0 +1,60 @@
+import { createTrigger, TriggerStrategy } from '@agnocon/pieces-framework';
+import { bigcommerceAuth } from '../common/auth';
+import { bigCommerceApiService } from '../common/requests';
+
+const TRIGGER_NAME = 'product created';
+const CACHE_KEY = `${TRIGGER_NAME}-trigger-store-key`;
+const TRIGGER_SCOPE = 'store/product/created';
+
+export const productCreated = createTrigger({
+  auth: bigcommerceAuth,
+  name: 'productCreated',
+  displayName: 'Product Created',
+  description: 'Triggers when a new product is created',
+  aiMetadata: {
+    description:
+      'Fires when a new product is added to the BigCommerce store catalog. The event identifies the new product.',
+  },
+  props: {},
+  sampleData: {
+    producer: 'stores/xqcaklwsso',
+    hash: 'c6db17090e98d2c58c0cb1988b5e9ace48215e22',
+    created_at: 1761808831,
+    store_id: '1003425529',
+    scope: 'store/product/created',
+    data: {
+      type: 'product',
+      id: 113,
+    },
+  },
+  type: TriggerStrategy.WEBHOOK,
+  async onEnable(context) {
+    const webhook = await bigCommerceApiService.createWebhook({
+      auth: context.auth.props,
+      payload: {
+        scope: TRIGGER_SCOPE,
+        destination: context.webhookUrl,
+        is_active: true,
+      },
+    });
+
+    await context.store.put(CACHE_KEY, webhook.data.id);
+  },
+  async onDisable(context) {
+    const webhookId = (await context.store.get(CACHE_KEY)) as string;
+
+    if (webhookId) {
+      await bigCommerceApiService
+        .deleteWebhook({
+          auth: context.auth.props,
+          webhookId,
+        })
+        .then(async () => {
+          await context.store.delete(CACHE_KEY);
+        });
+    }
+  },
+  async run(context) {
+    return [context.payload.body];
+  },
+});

package/src/lib/triggers/shipment-created.ts

@@ -0,0 +1,61 @@
+import { createTrigger, TriggerStrategy } from '@agnocon/pieces-framework';
+import { bigcommerceAuth } from '../common/auth';
+import { bigCommerceApiService } from '../common/requests';
+
+const TRIGGER_NAME = 'shipment created';
+const CACHE_KEY = `${TRIGGER_NAME}-trigger-store-key`;
+const TRIGGER_SCOPE = 'store/shipment/created';
+
+export const shipmentCreated = createTrigger({
+  auth: bigcommerceAuth,
+  name: 'shipmentCreated',
+  displayName: 'Shipment Created',
+  description: 'Triggers when a new shipment is created',
+  aiMetadata: {
+    description:
+      'Fires when a new shipment is created for an order in the BigCommerce store (items are shipped/fulfilled). The event identifies the new shipment.',
+  },
+  props: {},
+  sampleData:{
+    producer: 'stores/xqcaklwsso',
+    hash: 'd7b899890f5e0e98a3e074f018b14b07d5d89360',
+    created_at: 1761808595,
+    store_id: '1003425529',
+    scope: 'store/shipment/created',
+    data: {
+      type: 'shipment',
+      id: 2,
+     
+    },
+  },
+  type: TriggerStrategy.WEBHOOK,
+  async onEnable(context) {
+    const webhook = await bigCommerceApiService.createWebhook({
+      auth: context.auth.props,
+      payload: {
+        scope: TRIGGER_SCOPE,
+        destination: context.webhookUrl,
+        is_active: true,
+      },
+    });
+
+    await context.store.put(CACHE_KEY, webhook.data.id);
+  },
+  async onDisable(context) {
+    const webhookId = (await context.store.get(CACHE_KEY)) as string;
+
+    if (webhookId) {
+      await bigCommerceApiService
+        .deleteWebhook({
+          auth: context.auth.props,
+          webhookId,
+        })
+        .then(async () => {
+          await context.store.delete(CACHE_KEY);
+        });
+    }
+  },
+  async run(context) {
+    return [context.payload.body];
+  },
+});