oro-sdk-apis 1.53.0 → 1.54.0-dev1

package/dist/services/practice.d.ts

@@ -1,5 +1,5 @@
-import { ConsultRequestMetadata, PracticeAccount, Uuid } from '../models';
-import { Assignment, AssignmentRequest, PlanType, Practice, PracticeConfigKind, PracticeConfigs, PracticeInvoice, PracticePayment, PracticePaymentIntent, PracticePlan, PracticePlanPrices, PracticeWorkflow, PracticeWorkflowWithTagSpecialty, Practitioner, PractitionerLicense, PractitionerPreference, PractitionerQuota, PractitionerRole, WorkflowType } from '../models/practice';
+import { PracticeAccount, Uuid } from '../models';
+import { Assignment, AssignmentRequest, PaymentIntentRequestMetadata, PlanType, Practice, PracticeConfigKind, PracticeConfigs, PracticeInvoice, PracticePayment, PracticePaymentIntent, PracticePlan, PracticePlanPrices, PracticeWorkflow, PracticeWorkflowWithTagSpecialty, Practitioner, PractitionerLicense, PractitionerPreference, PractitionerQuota, PractitionerRole, WorkflowType } from '../models/practice';
 import { APIService } from './api';
 export declare class PracticeService {
     private api;
@@ -76,10 +76,10 @@ export declare class PracticeService {
      * @param isoLocality (optional) the desired locality
      * @param url_subdomain  (optional) the url of the sub domain (@bruno-morel need you to document that)
      * @param promotionCode (optional) promotion code to apply
-     * @param consultRequest (optional) consult request to use. If defined, when payment service call our hooks in practice, it will try to create a consult with these infos.
+     * @param requestMetadata (optional) the request metadata to use. If defined, when payment service call our hooks in practice, it will use it to do required action (create a consult, refill a consult, etc.).
      * @returns
      */
-    practiceCreatePaymentsIntent(practiceUuid: Uuid, planId: number, userEmail: string, isoLocality?: string, url_subdomain?: string, consultRequest?: ConsultRequestMetadata): Promise<PracticePaymentIntent>;
+    practiceCreatePaymentsIntent(practiceUuid: Uuid, planId: number, userEmail: string, isoLocality?: string, url_subdomain?: string, requestMetadata?: PaymentIntentRequestMetadata): Promise<PracticePaymentIntent>;
     practiceGetPaymentsIntent(practiceUuid: Uuid, paymentIntentId: number): Promise<PracticePaymentIntent>;
     /**
      * Updates a PracticePaymentIntent

package/package.json

@@ -1,5 +1,5 @@
 {
-    "version": "1.53.0",
+    "version": "1.54.0-dev1",
     "main": "dist/index.js",
     "typings": "dist/index.d.ts",
     "files": [

package/src/models/practice.ts

@@ -534,11 +534,47 @@ export interface PracticePaymentIntent {
  * It will be used to create the consult when stripe use our hook.
  */
 export interface ConsultRequestMetadata {
+    /**
+     * Defines the kind of `PaymentIntentRequestMetadata` it is
+     *
+     * Note: it can be `undefined` to handle backward compatibility when this interface didn't had a `kind`
+     */
+    kind: 'ConsultRequestMetadata' | undefined
+    /**
+     * The specialty required by the consultation
+     */
     tagSpecialtyRequired: string
+    /**
+     * The locality required for the consultation in iso. COUNTRY (ISO 3166) - PROVINCE - COUNTY - CITY
+     */
     isoLocalityRequired?: string
+    /**
+     * The language required for the consultation. Should respect ISO 639-3 https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
+     */
     isoLanguageRequired: string
 }
 
+/**
+ * This interface is used as metadata when creating Stripe Invoice.
+ * It will be used to create the consult when stripe use our hook.
+ */
+export interface RefillTreatmentRequestMetadata {
+    /**
+     * Defines the kind of `PaymentIntentRequestMetadata` it is
+     */
+    kind: 'RefillTreatmentRequestMetadata'
+    /**
+     * The consult uuid to refill
+     */
+    consultUuid: string
+}
+
+/**
+ * This interface is used as metadata when creating Stripe Invoice.
+ * It will be used when stripe use our hook.
+ */
+export type PaymentIntentRequestMetadata = ConsultRequestMetadata | RefillTreatmentRequestMetadata
+
 export interface AssignmentRequest {
     uuidAssignor: string //defaulting for insertion to the default practice admin
     uuidPractitioner?: string
@@ -716,4 +752,4 @@ export interface PracticeSecret {
      * It's decrypted on the fly when returned by the api.
      */
     payload: string
-}
+}

package/src/services/practice.ts

@@ -1,8 +1,9 @@
 import { hashToBase64String } from '../helpers'
-import { ConsultRequestMetadata, PracticeAccount, Uuid } from '../models'
+import { PracticeAccount, Uuid } from '../models'
 import {
     Assignment,
     AssignmentRequest,
+    PaymentIntentRequestMetadata,
     PlanType,
     Practice,
     PracticeConfigKind,
@@ -122,7 +123,7 @@ export class PracticeService {
             params: { kind },
         })
     }
-    
+
     public practiceGetWorkflow(
         practiceUuid: Uuid,
         workflowType: WorkflowType
@@ -193,7 +194,7 @@ export class PracticeService {
      * @param isoLocality (optional) the desired locality
      * @param url_subdomain  (optional) the url of the sub domain (@bruno-morel need you to document that)
      * @param promotionCode (optional) promotion code to apply
-     * @param consultRequest (optional) consult request to use. If defined, when payment service call our hooks in practice, it will try to create a consult with these infos.
+     * @param requestMetadata (optional) the request metadata to use. If defined, when payment service call our hooks in practice, it will use it to do required action (create a consult, refill a consult, etc.).
      * @returns
      */
     public practiceCreatePaymentsIntent(
@@ -202,7 +203,7 @@ export class PracticeService {
         userEmail: string,
         isoLocality?: string,
         url_subdomain?: string,
-        consultRequest?: ConsultRequestMetadata
+        requestMetadata?: PaymentIntentRequestMetadata
     ): Promise<PracticePaymentIntent> {
         return this.api.post<PracticePaymentIntent>(
             `${this.baseURL}/v1/practices/${practiceUuid}/payments/intents/`,
@@ -210,7 +211,7 @@ export class PracticeService {
                 idPlan: planId,
                 hashUserEmail: userEmail ? this.getPaymentIntentHashedEmail(userEmail) : undefined,
                 isoLocality,
-                consultRequest,
+                requestMetadata,
             },
             { params: { url_subdomain } }
         )

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2021 ORO Health Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.