@coasy/piece-coasy 0.0.11 → 0.1.0-rc.1

package/.eslintrc.json

@@ -0,0 +1,33 @@
+{
+  "extends": [
+    "../../../../.eslintrc.base.json"
+  ],
+  "ignorePatterns": [
+    "!**/*"
+  ],
+  "overrides": [
+    {
+      "files": [
+        "*.ts",
+        "*.tsx",
+        "*.js",
+        "*.jsx"
+      ],
+      "rules": {}
+    },
+    {
+      "files": [
+        "*.ts",
+        "*.tsx"
+      ],
+      "rules": {}
+    },
+    {
+      "files": [
+        "*.js",
+        "*.jsx"
+      ],
+      "rules": {}
+    }
+  ]
+}

package/README.md

@@ -1,7 +1,146 @@
-# pieces-coasy
+# Coasy Piece for Activepieces
 
-This library was generated with [Nx](https://nx.dev).
+This is the Coasy integration piece for Activepieces, providing actions and triggers to interact with the Coasy platform for funnel and webinar management.
 
-## Building
+## Overview
 
-Run `nx build pieces-coasy` to build the library.
+The Coasy piece includes:
+- **Actions**: Create funnel participants
+- **Triggers**: New funnel participants, new webinar participants, new auth events
+- **Authentication**: Custom auth with base URL and API key
+
+## Development Setup
+
+### Prerequisites
+1. Clone the activepieces repository
+2. Install dependencies: `npm install`
+3. Ensure you're in the root directory of the activepieces monorepo
+
+### Development Commands
+
+#### Building the Piece
+```bash
+# Build the coasy piece specifically
+nx build pieces-coasy
+
+# Build with watch mode for development
+nx build pieces-coasy --watch
+```
+
+#### Testing
+```bash
+# Run tests for the coasy piece
+nx test pieces-coasy
+
+# Run tests with watch mode
+nx test pieces-coasy --watch
+```
+
+#### Linting
+```bash
+# Lint the coasy piece
+nx lint pieces-coasy
+
+# Auto-fix lint issues
+nx lint pieces-coasy --fix
+```
+
+### Development Workflow
+
+#### 1. Start Development Environment
+```bash
+# Start the full development environment (frontend + backend + engine + pieces)
+npm run dev
+
+# Or start just backend services if only testing the piece
+npm run dev:backend
+```
+
+#### 2. Testing Your Changes
+- Navigate to `http://localhost:4200` (frontend)
+- Create a new flow and add Coasy actions/triggers
+- Test authentication with your Coasy credentials
+- Verify actions and triggers work as expected
+
+#### 3. Adding New Features
+
+**Adding a New Action:**
+1. Create a new file in `src/lib/actions/`
+2. Export the action from `src/index.ts`
+3. Follow the existing patterns in `create-funnel-participant.ts`
+
+**Adding a New Trigger:**
+1. Create a new file in `src/lib/triggers/`
+2. Export the trigger from `src/index.ts`
+3. Follow the existing patterns in `new-funnel-participant.ts`
+
+#### 4. File Structure
+```
+packages/pieces/community/coasy/
+├── README.md                 # This file
+├── package.json             # Package configuration
+├── project.json             # Nx project configuration
+├── tsconfig.json           # TypeScript config
+└── src/
+    ├── index.ts            # Main piece definition and exports
+    └── lib/
+        ├── actions/        # Action implementations
+        ├── triggers/       # Trigger implementations
+        └── common/         # Shared utilities
+```
+
+## Code Standards
+
+### Authentication
+The piece uses custom authentication with:
+- `baseUrl`: Coasy instance base URL
+- `apiKey`: API key for authentication
+
+### Error Handling
+- Use proper error messages for user-facing errors
+- Handle API errors gracefully
+- Validate inputs before making API calls
+
+### Properties
+- Use descriptive `displayName` and `description` for all properties
+- Mark required fields appropriately
+- Use proper property types from `@activepieces/pieces-framework`
+
+## Testing in Activepieces
+
+1. **Authentication Testing**:
+   - Verify connection works with valid credentials
+   - Test error handling with invalid credentials
+
+2. **Action Testing**:
+   - Test with valid inputs
+   - Test error scenarios
+   - Verify data transformation
+
+3. **Trigger Testing**:
+   - Set up webhooks/polling as needed
+   - Test trigger conditions
+   - Verify payload structure
+
+## Publishing
+
+The piece is published as `@coasy/piece-coasy` to npm. Version is currently `0.0.12`.
+
+To publish a new version:
+1. Navigate to the coasy piece directory:
+   ```bash
+   cd packages/pieces/community/coasy
+   ```
+2. Update the `version` in `package.json` (e.g., from `0.0.11` to `0.0.12`)
+3. Publish directly to npm:
+   ```bash
+   npm publish
+   ```
+
+**Note**: The monorepo's `npm run publish-piece` script currently has dependency resolution issues. Use the direct `npm publish` method above instead.
+
+## Resources
+
+- [Activepieces Documentation](https://www.activepieces.com/docs)
+- [Pieces Framework Reference](https://www.activepieces.com/docs/developers/piece-reference/properties)
+- [Piece Development Guide](https://www.activepieces.com/docs/developers/building-pieces/create-action)

package/package.json

@@ -1,19 +1,4 @@
 {
   "name": "@coasy/piece-coasy",
-  "version": "0.0.11",
-  "dependencies": {
-    "@sinclair/typebox": "0.26.8",
-    "axios": "1.6.7",
-    "dayjs": "1.11.9",
-    "is-base64": "1.1.0",
-    "lodash": "4.17.21",
-    "nanoid": "3.3.6",
-    "semver": "7.6.0",
-    "@activepieces/pieces-common": "0.2.12",
-    "@activepieces/pieces-framework": "0.7.29",
-    "@activepieces/shared": "0.10.104",
-    "tslib": "1.14.1"
-  },
-  "main": "./src/index.js",
-  "type": "commonjs"
-}
+  "version": "0.1.0-rc.1"
+}

package/project.json

@@ -0,0 +1,38 @@
+{
+  "name": "pieces-coasy",
+  "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/pieces/community/coasy/src",
+  "projectType": "library",
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": [
+        "{options.outputPath}"
+      ],
+      "options": {
+        "outputPath": "dist/packages/pieces/community/coasy",
+        "tsConfig": "packages/pieces/community/coasy/tsconfig.lib.json",
+        "packageJson": "packages/pieces/community/coasy/package.json",
+        "main": "packages/pieces/community/coasy/src/index.ts",
+        "assets": [
+          "packages/pieces/community/coasy/*.md"
+        ],
+        "buildableProjectDepsInPackageJsonType": "dependencies",
+        "updateBuildableProjectDepsInPackageJson": true
+      }
+    },
+    "publish": {
+      "command": "node tools/scripts/publish.mjs pieces-coasy {args.ver} {args.tag}",
+      "dependsOn": [
+        "build"
+      ]
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": [
+        "{options.outputFile}"
+      ]
+    }
+  },
+  "tags": []
+}

package/src/index.ts

@@ -0,0 +1,84 @@
+import {
+  createPiece,
+  PieceAuth,
+  Property,
+} from '@activepieces/pieces-framework';
+import { createEventParticipant } from './lib/actions/create-event-participant';
+import { createFunnelParticipant } from './lib/actions/create-funnel-participant';
+import { createVoucher } from './lib/actions/create-voucher';
+import { enrollUserCourse } from './lib/actions/enroll-user-course';
+import { findEvent } from './lib/actions/find-event';
+import { cancelledMembership } from './lib/triggers/cancelled-membership';
+import { cancelledOrder } from './lib/triggers/cancelled-order';
+import { cancelledOrderItem } from './lib/triggers/cancelled-order-item';
+import { cancelledOrderprocess } from './lib/triggers/cancelled-orderprocess';
+import { cancelledSubscription } from './lib/triggers/cancelled-subscription';
+import { getEvents } from './lib/triggers/get-events';
+import { newAppUserSignUp } from './lib/triggers/new-app-user-sign-up';
+import { newAuthEvent } from './lib/triggers/new-auth-event';
+import { newCustomer } from './lib/triggers/new-customer';
+import { newEventParticipant } from './lib/triggers/new-event-participant';
+import { newFunnelParticipant } from './lib/triggers/new-funnel-participant';
+import { newLead } from './lib/triggers/new-lead';
+import { newMembership } from './lib/triggers/new-membership';
+import { newOrder } from './lib/triggers/new-order';
+import { newOrderItem } from './lib/triggers/new-order-item';
+import { newSubscription } from './lib/triggers/new-subscription';
+import { newWebinarParticipant } from './lib/triggers/new-webinar-participant';
+import { webinarParticipantAttend } from './lib/triggers/webinar-participant-attend';
+import { webinarParticipantReminder } from './lib/triggers/webinar-participant-reminder';
+
+export const coasyAuth = PieceAuth.CustomAuth({
+  required: true,
+  description: 'Enter coasy authentication details',
+  props: {
+    baseUrl: Property.ShortText({
+      displayName: 'Base URL',
+      description: 'Enter the base URL',
+      required: false,
+      defaultValue: 'https://backend.api.prod.coasy.io',
+    }),
+    apiKey: PieceAuth.SecretText({
+      displayName: 'API Key',
+      description: 'Enter the api key',
+      required: true,
+    }),
+  },
+});
+
+export const coasy = createPiece({
+  displayName: 'Coasy',
+  auth: coasyAuth,
+  description: 'Communicate with Coasy',
+  minimumSupportedRelease: '0.20.0',
+  logoUrl: 'https://console.coasy.io/favicon/apple-icon.png',
+  authors: ['christian-schab'],
+  actions: [
+    createEventParticipant,
+    createFunnelParticipant,
+    createVoucher,
+    enrollUserCourse,
+    findEvent,
+  ],
+  triggers: [
+    cancelledMembership,
+    cancelledOrder,
+    cancelledOrderItem,
+    cancelledOrderprocess,
+    cancelledSubscription,
+    getEvents,
+    newAppUserSignUp,
+    newAuthEvent,
+    newCustomer,
+    newEventParticipant,
+    newFunnelParticipant,
+    newLead,
+    newMembership,
+    newOrder,
+    newOrderItem,
+    newSubscription,
+    newWebinarParticipant,
+    webinarParticipantAttend,
+    webinarParticipantReminder,
+  ],
+});

package/src/lib/actions/create-event-participant.ts

@@ -0,0 +1,34 @@
+import { createAction, Property } from "@activepieces/pieces-framework";
+import { coasyAuth } from "../..";
+import { CoasyClient } from "../common/coasyClient";
+
+export const createEventParticipant = createAction({
+  auth: coasyAuth,
+  name: "createEventParticipant",
+  displayName: "Create Event Participant",
+  description: "Creates a new event participant",
+  props: {
+    eventId: Property.ShortText({
+      displayName: "Event ID",
+      description: "ID of event",
+      required: true
+    }),
+    categoryId: Property.ShortText({
+      displayName: "Category ID",
+      description: "ID of category",
+      required: false
+    })
+  },
+  async run(configValue) {
+    const { propsValue, auth } = configValue;
+    const client = new CoasyClient(
+      auth.baseUrl ?? "https://backend.api.prod.coasy.io",
+      auth.apiKey
+    );
+    const request = {
+      eventId: propsValue.eventId,
+      categoryId: propsValue.categoryId
+    };
+    return client.action("createEventParticipant", request);
+  }
+});

package/src/lib/actions/create-funnel-participant.ts

@@ -0,0 +1,42 @@
+import { createAction, Property } from '@activepieces/pieces-framework';
+import { coasyAuth } from '../../index';
+import { CoasyClient } from '../common/coasyClient';
+
+export const createFunnelParticipant = createAction({
+  auth: coasyAuth,
+  name: 'createFunnelParticipant',
+  displayName: 'Create Funnel Participant',
+  description: 'Create a new funnel participant',
+  props: {
+    funnelId: Property.ShortText({
+      displayName: 'Funnel ID',
+      description: 'ID of funnel',
+      required: true
+    }),
+    firstName: Property.ShortText({
+      displayName: 'First name',
+      description: 'first name of participant',
+      required: true
+    }),
+    lastName: Property.ShortText({
+      displayName: 'Last name',
+      description: 'last name of participant',
+      required: false
+    }),
+    email: Property.ShortText({
+      displayName: 'Email',
+      description: 'email address of partipant',
+      required: true
+    })
+  },
+  async run(configValue) {
+    const { propsValue, auth } = configValue;
+    const client = new CoasyClient(auth.baseUrl ?? 'https://backend.api.prod.coasy.io', auth.apiKey);
+    const request = {
+      email: propsValue.email,
+      firstName: propsValue.firstName,
+      funnelId: propsValue.funnelId
+    };
+    return client.action('createFunnelParticipant', request);
+  }
+});

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

@@ -0,0 +1,28 @@
+import { createAction, Property } from '@activepieces/pieces-framework';
+import { coasyAuth } from '../..';
+import { CoasyClient } from '../common/coasyClient';
+
+export const createVoucher = createAction({
+  auth: coasyAuth,
+  name: 'createVoucher',
+  displayName: 'Create Voucher',
+  description: 'Creates a new voucher',
+  props: {
+    offerId: Property.ShortText({
+      displayName: 'Offer ID',
+      description: 'ID of offer',
+      required: true,
+    }),
+  },
+  async run(configValue) {
+    const { propsValue, auth } = configValue;
+    const client = new CoasyClient(
+      auth.baseUrl ?? 'https://backend.api.prod.coasy.io',
+      auth.apiKey
+    );
+    const request = {
+      offerId: propsValue.offerId,
+    };
+    return client.action('createVoucher', request);
+  },
+});

package/src/lib/actions/enroll-user-course.ts

@@ -0,0 +1,40 @@
+import { createAction, Property } from "@activepieces/pieces-framework";
+import { coasyAuth } from "../..";
+import { CoasyClient } from "../common/coasyClient";
+
+export const enrollUserCourse = createAction({
+  auth: coasyAuth,
+  name: "enrollUserCourse",
+  displayName: "Enroll User Course",
+  description: "Enrolls user course",
+  props: {
+    userId: Property.ShortText({
+      displayName: "User ID",
+      description: "ID of User",
+      required: true
+    }),
+    courseId: Property.ShortText({
+      displayName: "Course ID",
+      description: "ID of Course",
+      required: true
+    }),
+    directGrant: Property.Checkbox({
+      displayName: "Direct Grant",
+      description: "Give direct grant",
+      required: true
+    })
+  },
+  async run(configValue) {
+    const { propsValue, auth } = configValue;
+    const client = new CoasyClient(
+      auth.baseUrl ?? "https://backend.api.prod.coasy.io",
+      auth.apiKey
+    );
+    const request = {
+      userId: propsValue.userId,
+      courseId: propsValue.courseId,
+      directGrant: propsValue.directGrant
+    };
+    return client.action("enrollUserCourse", request);
+  }
+});

package/src/lib/actions/find-event.ts

@@ -0,0 +1,28 @@
+import { createAction, Property } from "@activepieces/pieces-framework";
+import { coasyAuth } from "../..";
+import { CoasyClient } from "../common/coasyClient";
+
+export const findEvent = createAction({
+  auth: coasyAuth,
+  name: "findEvent",
+  displayName: "Find Event",
+  description: "Finds Event",
+  props: {
+    title: Property.ShortText({
+      displayName: "Title",
+      description: "Title Name",
+      required: false
+    })
+  },
+  async run(configValue) {
+    const { propsValue, auth } = configValue;
+    const client = new CoasyClient(
+      auth.baseUrl ?? "https://backend.api.prod.coasy.io",
+      auth.apiKey
+    );
+    const request = {
+      title: propsValue.title
+    };
+    return client.action("findEvent", request);
+  }
+});

package/src/lib/common/coasyClient.ts

@@ -0,0 +1,58 @@
+import {
+  AuthenticationType,
+  httpClient,
+  HttpMethod,
+  HttpRequest,
+} from '@activepieces/pieces-common';
+
+export class CoasyClient {
+  private baseUrl: string;
+  private apiKey: string;
+
+  constructor(baseUrl: string, apiKey: string) {
+    this.baseUrl = baseUrl;
+    this.apiKey = apiKey;
+  }
+
+  async action(actionName: string, request: any) {
+    return this.request(`/apps/actions/${actionName}`, request);
+  }
+
+  async createTrigger(trigger: string, hookUrl: string, filter: any) {
+    return this.request(`/apps/triggers/create`, {
+      hookUrl,
+      trigger,
+      filter,
+    });
+  }
+
+  async destroyTrigger(webhookId: string) {
+    return this.request(`/apps/triggers/destroy`, { webhookId });
+  }
+
+  async listTriggerEvents(trigger: string) {
+    return this.request(`/apps/list`, {
+      trigger,
+    });
+  }
+
+  async request(path: string, requestBody: any) {
+    const request: HttpRequest<string> = {
+      method: HttpMethod.POST,
+      url: `${this.baseUrl}${path}`,
+      body: JSON.stringify(requestBody),
+      authentication: {
+        type: AuthenticationType.BEARER_TOKEN,
+        token: this.apiKey,
+      },
+    };
+
+    const response = await httpClient.sendRequest(request);
+
+    if (response.status !== 200) {
+      throw new Error(`Failed to communicate with Mailjet`);
+    } else {
+      return response.body;
+    }
+  }
+}

package/src/lib/common/triggers.ts

@@ -0,0 +1,58 @@
+
+import { CoasyClient } from './coasyClient';
+
+import { SecretTextProperty, ShortTextProperty, StaticPropsValue, Store } from '@activepieces/pieces-framework';
+
+export interface CreateTriggerRequest {
+  triggerName: string;
+  webhookUrl: string;
+  auth:  StaticPropsValue<{
+    baseUrl: ShortTextProperty<false>,
+    apiKey: SecretTextProperty<true>
+  }>
+  filter: any;
+  store: Store;
+}
+
+export interface DestroyTriggerRequest {
+  triggerName: string;
+  auth:  StaticPropsValue<{
+    baseUrl: ShortTextProperty<false>,
+    apiKey: SecretTextProperty<true>
+  }>
+  store: Store;
+}
+
+export interface TestTriggerRequest {
+  triggerName: string;
+  auth:  StaticPropsValue<{
+    baseUrl: ShortTextProperty<false>,
+    apiKey: SecretTextProperty<true>
+  }>
+}
+
+export const createCoasyTrigger = async (request: CreateTriggerRequest) => {
+  const { triggerName, webhookUrl, filter, auth, store} = request;
+  const client = new CoasyClient(auth.baseUrl ?? 'https://backend.api.prod.coasy.io', auth.apiKey);
+  const response = await client.createTrigger(triggerName, webhookUrl, filter);
+  if (!response.id) throw new Error(`Failed to create Trigger!`);
+  await store.put<string>(`${triggerName}__WEBHOOK_ID`, response.id);
+};
+
+export const destroyCoasyTrigger = async (request: DestroyTriggerRequest) =>  {
+  const { triggerName, auth, store} = request;
+  const webhookId = await store.get<string>(`${triggerName}__WEBHOOK_ID`);
+  if (!webhookId) throw new Error(`Webhook Id not found!`);
+
+  const client = new CoasyClient(auth.baseUrl ?? 'https://backend.api.prod.coasy.io', auth.apiKey);
+  await client.destroyTrigger(webhookId);
+}
+
+export const testCoasyTrigger = async (request: TestTriggerRequest): Promise<any[]> => {
+  const { triggerName, auth} = request;
+
+  const client = new CoasyClient(auth.baseUrl ?? 'https://backend.api.prod.coasy.io', auth.apiKey);
+  const response = await client.listTriggerEvents(triggerName);
+
+  return [{ test: true}];
+}

package/src/lib/triggers/cancelled-membership.ts

@@ -0,0 +1,34 @@
+import { createTrigger, Property, TriggerStrategy } from '@activepieces/pieces-framework';
+import { coasyAuth } from '../..';
+import { createCoasyTrigger, destroyCoasyTrigger, testCoasyTrigger } from '../common/triggers';
+
+const triggerName = "CANCELLED_MEMBERSHIP";
+
+export const cancelledMembership = createTrigger({
+  auth: coasyAuth,
+  name: 'cancelledMembership',
+  displayName: 'Cancelled Membership',
+  description: 'Triggers when a customer requests a membership cancellation.',
+  props: {},
+  sampleData: {},
+  type: TriggerStrategy.WEBHOOK,
+  onEnable: (context) => createCoasyTrigger({
+    triggerName,
+    webhookUrl: context.webhookUrl,
+    auth: context.auth,
+    filter: context.propsValue,
+    store: context.store
+  }),
+  onDisable: (context) => destroyCoasyTrigger({
+    triggerName,
+    auth: context.auth,
+    store: context.store
+  }),
+  test: (context) => testCoasyTrigger({
+    triggerName,
+    auth: context.auth
+  }),
+  async run(context) {
+    return [context.payload.body];
+  }
+});