@whatsscale-app/piece-medilink 0.1.2 → 0.1.4

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "@whatsscale-app/piece-medilink",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Medilink clinic management integration for pip0",
-  "keywords": ["medilink", "healthatom", "clinic", "pip0", "automation"],
+  "keywords": [
+    "medilink",
+    "healthatom",
+    "clinic",
+    "pip0",
+    "automation"
+  ],
   "homepage": "https://pip0.ai",
   "repository": {
     "type": "git",
@@ -10,9 +16,12 @@
   },
   "license": "MIT",
   "author": "WhatsScale <mahi@whatsscale.com>",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": ["dist/", "package.json"],
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "files": [
+    "src/",
+    "package.json"
+  ],
   "dependencies": {
     "@activepieces/pieces-common": "0.11.7",
     "@activepieces/pieces-framework": "0.25.6",
@@ -20,7 +29,7 @@
     "tslib": "2.6.2"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.lib.json && cp package.json dist/",
+    "build": "tsc -p tsconfig.lib.json && cp dist/packages/pieces/community/medilink/index.js src/index.js && cp dist/packages/pieces/community/medilink/index.d.ts src/index.d.ts && cp -r dist/packages/pieces/community/medilink/src/lib src/lib",
     "lint": "eslint 'src/**/*.ts'"
   },
   "devDependencies": {

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

@@ -0,0 +1,77 @@
+import { createAction, Property } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { Cita, MedilinkSingleResponse } from '../common/types';
+
+export const createAppointmentAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_create_appointment',
+  displayName: 'Create Appointment',
+  description: 'Create a new appointment (cita) in Medilink.',
+  props: {
+    id_paciente: Property.Number({
+      displayName: 'Patient ID',
+      required: true,
+    }),
+    id_dentista: Property.Number({
+      displayName: 'Practitioner ID',
+      required: true,
+    }),
+    id_sucursal: Property.Number({
+      displayName: 'Branch ID',
+      required: true,
+    }),
+    fecha: Property.ShortText({
+      displayName: 'Date (YYYY-MM-DD)',
+      required: true,
+    }),
+    hora_inicio: Property.ShortText({
+      displayName: 'Start Time (HH:MM)',
+      required: true,
+    }),
+    hora_fin: Property.ShortText({
+      displayName: 'End Time (HH:MM)',
+      required: true,
+    }),
+    id_tratamiento: Property.Number({
+      displayName: 'Treatment ID',
+      required: false,
+    }),
+    comentarios: Property.LongText({
+      displayName: 'Comments',
+      required: false,
+    }),
+  },
+  async run(context) {
+    const {
+      id_paciente,
+      id_dentista,
+      id_sucursal,
+      fecha,
+      hora_inicio,
+      hora_fin,
+      id_tratamiento,
+      comentarios,
+    } = context.propsValue;
+
+    const body: Record<string, unknown> = {
+      id_paciente,
+      id_dentista,
+      id_sucursal,
+      fecha,
+      hora_inicio,
+      hora_fin,
+    };
+    if (id_tratamiento) body['id_tratamiento'] = id_tratamiento;
+    if (comentarios)    body['comentarios']    = comentarios;
+
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.POST,
+      '/citas',
+      body
+    );
+    return (res.body as MedilinkSingleResponse<Cita>).data;
+  },
+});

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

@@ -0,0 +1,56 @@
+import { createAction, Property } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { MedilinkSingleResponse, Paciente } from '../common/types';
+
+export const createPatientAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_create_patient',
+  displayName: 'Create Patient',
+  description: 'Create a new patient record in Medilink.',
+  props: {
+    nombre: Property.ShortText({
+      displayName: 'First Name',
+      required: true,
+    }),
+    apellidos: Property.ShortText({
+      displayName: 'Last Names',
+      required: true,
+    }),
+    celular: Property.ShortText({
+      displayName: 'Mobile Phone',
+      description: 'International format: +56912345678',
+      required: false,
+    }),
+    email: Property.ShortText({
+      displayName: 'Email',
+      required: false,
+    }),
+    rut: Property.ShortText({
+      displayName: 'RUT (Chilean ID)',
+      required: false,
+    }),
+    fecha_nacimiento: Property.ShortText({
+      displayName: 'Date of Birth (YYYY-MM-DD)',
+      required: false,
+    }),
+  },
+  async run(context) {
+    const { nombre, apellidos, celular, email, rut, fecha_nacimiento } = context.propsValue;
+
+    const body: Record<string, unknown> = { nombre, apellidos };
+    if (celular)          body['celular']          = celular;
+    if (email)            body['email']            = email;
+    if (rut)              body['rut']              = rut;
+    if (fecha_nacimiento) body['fecha_nacimiento'] = fecha_nacimiento;
+
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.POST,
+      '/pacientes',
+      body
+    );
+    return (res.body as MedilinkSingleResponse<Paciente>).data;
+  },
+});

package/src/lib/actions/get-appointment.ts

@@ -0,0 +1,24 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { medilinkProps } from '../common/props';
+import { Cita, MedilinkSingleResponse } from '../common/types';
+
+export const getAppointmentAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_get_appointment',
+  displayName: 'Get Appointment',
+  description: 'Retrieve a single appointment (cita) by ID.',
+  props: {
+    citaId: medilinkProps.citaId,
+  },
+  async run(context) {
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.GET,
+      `/citas/${context.propsValue.citaId}`
+    );
+    return (res.body as MedilinkSingleResponse<Cita>).data;
+  },
+});

package/src/lib/actions/get-branch.ts

@@ -0,0 +1,24 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { medilinkProps } from '../common/props';
+import { MedilinkSingleResponse, Sucursal } from '../common/types';
+
+export const getBranchAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_get_branch',
+  displayName: 'Get Branch',
+  description: 'Retrieve a clinic branch (sucursal) by ID.',
+  props: {
+    sucursalId: medilinkProps.sucursalId,
+  },
+  async run(context) {
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.GET,
+      `/sucursales/${context.propsValue.sucursalId}`
+    );
+    return (res.body as MedilinkSingleResponse<Sucursal>).data;
+  },
+});

package/src/lib/actions/get-patient-payments.ts

@@ -0,0 +1,24 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { medilinkProps } from '../common/props';
+import { MedilinkListResponse, Pago } from '../common/types';
+
+export const getPatientPaymentsAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_get_patient_payments',
+  displayName: 'Get Patient Payments',
+  description: 'Retrieve all payments (pagos) for a specific patient.',
+  props: {
+    patientId: medilinkProps.patientId,
+  },
+  async run(context) {
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.GET,
+      `/pacientes/${context.propsValue.patientId}/pagos`
+    );
+    return (res.body as MedilinkListResponse<Pago>).data;
+  },
+});

package/src/lib/actions/get-patient.test.ts

@@ -0,0 +1,66 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { getPatientAction } from './get-patient';
+import * as clientModule from '../common/client';
+
+vi.mock('../common/client', () => ({ medilinkClient: vi.fn() }));
+
+const mockClient = vi.mocked(clientModule.medilinkClient);
+const MOCK_AUTH = { access_token: 'test-token', timezone: 'America/Santiago' } as any;
+const MOCK_PACIENTE = {
+  id: 15396,
+  nombre: 'Rogelio',
+  apellidos: 'Catrileo Sanchez',
+  celular: '+56988208169',
+  telefono: '',
+  email: '',
+  rut: '12345678-9',
+  fecha_nacimiento: '1985-03-12',
+  habilitado: 1,
+};
+
+beforeEach(() => vi.clearAllMocks());
+
+describe('getPatientAction', () => {
+  it('calls GET /pacientes/:id', async () => {
+    mockClient.mockResolvedValueOnce({ body: { data: MOCK_PACIENTE } } as any);
+    await (getPatientAction as any).run({
+      auth: MOCK_AUTH,
+      propsValue: { patientId: '15396' },
+    });
+    expect(mockClient.mock.calls[0][2]).toBe('/pacientes/15396');
+  });
+
+  it('passes access_token as first arg', async () => {
+    mockClient.mockResolvedValueOnce({ body: { data: MOCK_PACIENTE } } as any);
+    await (getPatientAction as any).run({
+      auth: MOCK_AUTH,
+      propsValue: { patientId: '15396' },
+    });
+    expect(mockClient.mock.calls[0][0]).toBe('test-token');
+  });
+
+  it('returns response.body.data', async () => {
+    mockClient.mockResolvedValueOnce({ body: { data: MOCK_PACIENTE } } as any);
+    const result = await (getPatientAction as any).run({
+      auth: MOCK_AUTH,
+      propsValue: { patientId: '15396' },
+    });
+    expect(result).toEqual(MOCK_PACIENTE);
+  });
+
+  it('returns celular in international format', async () => {
+    mockClient.mockResolvedValueOnce({ body: { data: MOCK_PACIENTE } } as any);
+    const result = await (getPatientAction as any).run({
+      auth: MOCK_AUTH,
+      propsValue: { patientId: '15396' },
+    });
+    expect(result.celular).toMatch(/^\+/);
+  });
+
+  it('surfaces thrown error (401)', async () => {
+    mockClient.mockRejectedValueOnce(new Error('Medilink authentication failed'));
+    await expect(
+      (getPatientAction as any).run({ auth: MOCK_AUTH, propsValue: { patientId: '1' } })
+    ).rejects.toThrow('authentication failed');
+  });
+});

package/src/lib/actions/get-patient.ts

@@ -0,0 +1,24 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { medilinkProps } from '../common/props';
+import { MedilinkSingleResponse, Paciente } from '../common/types';
+
+export const getPatientAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_get_patient',
+  displayName: 'Get Patient',
+  description: 'Retrieve a patient record by ID. Returns celular in international format (+56XXXXXXXXX).',
+  props: {
+    patientId: medilinkProps.patientId,
+  },
+  async run(context) {
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.GET,
+      `/pacientes/${context.propsValue.patientId}`
+    );
+    return (res.body as MedilinkSingleResponse<Paciente>).data;
+  },
+});

package/src/lib/actions/get-practitioner.ts

@@ -0,0 +1,24 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { medilinkProps } from '../common/props';
+import { Dentista, MedilinkSingleResponse } from '../common/types';
+
+export const getPractitionerAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_get_practitioner',
+  displayName: 'Get Practitioner',
+  description: 'Retrieve a practitioner (dentista/profesional) by ID.',
+  props: {
+    dentistaId: medilinkProps.dentistaId,
+  },
+  async run(context) {
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.GET,
+      `/dentistas/${context.propsValue.dentistaId}`
+    );
+    return (res.body as MedilinkSingleResponse<Dentista>).data;
+  },
+});

package/src/lib/actions/get-treatment-plan.ts

@@ -0,0 +1,24 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { medilinkProps } from '../common/props';
+import { Atencion, MedilinkSingleResponse } from '../common/types';
+
+export const getTreatmentPlanAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_get_treatment_plan',
+  displayName: 'Get Treatment Plan',
+  description: 'Retrieve a treatment plan (atencion) by ID. Requires /atenciones API access on your Medilink plan.',
+  props: {
+    atencionId: medilinkProps.atencionId,
+  },
+  async run(context) {
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.GET,
+      `/atenciones/${context.propsValue.atencionId}`
+    );
+    return (res.body as MedilinkSingleResponse<Atencion>).data;
+  },
+});

package/src/lib/actions/list-patient-appointments.ts

@@ -0,0 +1,24 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { medilinkProps } from '../common/props';
+import { Cita, MedilinkListResponse } from '../common/types';
+
+export const listPatientAppointmentsAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_list_patient_appointments',
+  displayName: 'List Patient Appointments',
+  description: 'Retrieve all appointments (citas) for a specific patient.',
+  props: {
+    patientId: medilinkProps.patientId,
+  },
+  async run(context) {
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.GET,
+      `/pacientes/${context.propsValue.patientId}/citas`
+    );
+    return (res.body as MedilinkListResponse<Cita>).data;
+  },
+});

package/src/lib/actions/list-today-appointments.ts

@@ -0,0 +1,38 @@
+import { createAction } from '@activepieces/pieces-framework';
+import { HttpMethod } from '@activepieces/pieces-common';
+import { medilinkAuth } from '../auth';
+import { medilinkClient } from '../common/client';
+import { medilinkProps } from '../common/props';
+import { Cita, MedilinkListResponse } from '../common/types';
+
+export const listTodayAppointmentsAction = createAction({
+  auth: medilinkAuth,
+  name: 'medilink_list_today_appointments',
+  displayName: 'List Today\'s Appointments',
+  description: 'Retrieve all appointments scheduled for today in the clinic\'s timezone, sorted by start time.',
+  props: {
+    sucursal: medilinkProps.sucursal,
+  },
+  async run(context) {
+    // Use clinic timezone from auth to determine "today"
+    const today = new Intl.DateTimeFormat('en-CA', {
+      timeZone: (context.auth as any).timezone,
+      year: 'numeric',
+      month: '2-digit',
+      day: '2-digit',
+    }).format(new Date()); // returns YYYY-MM-DD
+
+    const res = await medilinkClient(
+      (context.auth as any).access_token,
+      HttpMethod.GET,
+      '/citas',
+      undefined,
+      { fecha: { eq: today } },
+      'hora_inicio:asc'
+    );
+
+    const { data } = res.body as MedilinkListResponse<Cita>;
+    const { sucursal } = context.propsValue;
+    return sucursal ? data.filter((c) => String(c.id_sucursal) === sucursal) : data;
+  },
+});