@worknice/js-sdk 0.0.2 → 0.0.4

package/dist/employee-records/validatePersonDataTransferLinePostalAddress.d.ts

@@ -1,4 +1,5 @@
 import { PartialPersonDataTransferLine, PersonDataTransferLine } from './_types.js';
+import '../api/_generated.js';
 
 declare const validatePersonDataTransferLinePostalAddress: (value: PartialPersonDataTransferLine["postalAddress"]) => PersonDataTransferLine["postalAddress"];
 

package/dist/employee-records/validatePersonDataTransferLineResidentialAddress.d.ts

@@ -1,4 +1,5 @@
 import { PartialPersonDataTransferLine, PersonDataTransferLine } from './_types.js';
+import '../api/_generated.js';
 
 declare const validatePersonDataTransferLineResidentialAddress: (value: PartialPersonDataTransferLine["residentialAddress"]) => PersonDataTransferLine["residentialAddress"];
 

package/dist/employee-records/validatePersonDataTransferLineSuperFunds.d.ts

@@ -1,4 +1,5 @@
 import { PartialPersonDataTransferLine, PersonDataTransferLine } from './_types.js';
+import '../api/_generated.js';
 
 declare const validatePersonDataTransferLineSuperFunds: (value: PartialPersonDataTransferLine["superFunds"]) => PersonDataTransferLine["superFunds"];
 

package/dist/employee-records/validatePersonDataTransferLineTaxDetails.d.ts

@@ -1,4 +1,5 @@
 import { PartialPersonDataTransferLine, PersonDataTransferLine } from './_types.js';
+import '../api/_generated.js';
 
 declare const validatePersonDataTransferLineTaxDetails: (value: PartialPersonDataTransferLine["taxDetails"]) => PersonDataTransferLine["taxDetails"];
 

package/dist/employee-records/validatePersonDataTransferLineTenure.d.ts

@@ -1,4 +1,5 @@
 import { PartialPersonDataTransferLine, PersonDataTransferLine } from './_types.js';
+import '../api/_generated.js';
 
 declare const validatePersonDataTransferLineTenure: (value: PartialPersonDataTransferLine["tenure"]) => PersonDataTransferLine["tenure"];
 

package/dist/helpers/_types.d.ts

@@ -1,4 +1,5 @@
-import { W as WorkniceClient } from '../_types-DsB4q143.js';
+import { W as WorkniceClient } from '../_types-BXw9D0Qi.js';
+import WorkniceIntegrationLogger, { Logger } from '../api/WorkniceIntegrationLogger.js';
 import '../api/_generated.js';
 
 type HandlerOptions = {
@@ -6,12 +7,12 @@ type HandlerOptions = {
     debug?: boolean;
     logger?: Logger;
 };
-type Logger = Pick<Console, "info" | "error">;
-type TaskContext<T> = {
-    log: Logger;
-    payload: T;
+type TaskContext<Payload, Env = null> = {
+    env: Env;
+    logger: WorkniceIntegrationLogger;
+    payload: Payload;
     request: Request;
     worknice: WorkniceClient;
 };
 
-export type { HandlerOptions, Logger, TaskContext };
+export type { HandlerOptions, TaskContext };

package/dist/helpers/handleCreateIntegrationWebhook.d.ts

@@ -1,7 +1,8 @@
 import { CreateIntegrationRequestPayload } from '../webhooks.js';
 import { HandlerOptions, TaskContext } from './_types.js';
-import '../_types-DsB4q143.js';
+import '../_types-BXw9D0Qi.js';
 import '../api/_generated.js';
+import '../api/WorkniceIntegrationLogger.js';
 
 type Tasks = {
     persistDetails: (context: TaskContext<CreateIntegrationRequestPayload>) => Promise<void>;

package/dist/helpers/handleCreateIntegrationWebhook.js

@@ -3,10 +3,12 @@ const handleCreateIntegrationWebhook = async (request, { persistDetails }, optio
   request,
   {
     getApiToken: async ({ payload }) => payload.apiToken,
-    handleRequest: async ({ log, payload, request: request2, worknice }) => {
-      log.info("Persisting details\u2026");
-      await persistDetails({ log, payload, request: request2, worknice });
-      log.info("Initializing integration\u2026");
+    getEnv: async () => null,
+    handleRequest: async (context) => {
+      const { logger, payload, worknice } = context;
+      logger.debug("Persisting details\u2026");
+      await persistDetails(context);
+      logger.debug("Initializing integration\u2026");
       await worknice.initializeIntegration({ id: payload.integrationId });
     },
     parsePayload: async ({ request: request2 }) => request2.json()

package/dist/helpers/handleCreateIntegrationWebhook.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/helpers/handleCreateIntegrationWebhook.ts"],"sourcesContent":["import type { CreateIntegrationRequestPayload } from \"../webhooks.js\";\nimport type { HandlerOptions, TaskContext } from \"./_types.js\";\nimport handleRequestWithWorknice from \"./handleRequestWithWorknice.js\";\n\ntype Tasks = {\n  persistDetails: (context: TaskContext<CreateIntegrationRequestPayload>) => Promise<void>;\n};\n\nconst handleCreateIntegrationWebhook = async (\n  request: Request,\n  { persistDetails }: Tasks,\n  options?: HandlerOptions,\n) =>\n  handleRequestWithWorknice<CreateIntegrationRequestPayload>(\n    request,\n    {\n      getApiToken: async ({ payload }) => payload.apiToken,\n      handleRequest: async ({ log, payload, request, worknice }) => {\n        log.info(\"Persisting details…\");\n        await persistDetails({ log, payload, request, worknice });\n        log.info(\"Initializing integration…\");\n        await worknice.initializeIntegration({ id: payload.integrationId });\n      },\n      parsePayload: async ({ request }) => request.json(),\n    },\n    options,\n  );\n\nexport default handleCreateIntegrationWebhook;\n"],"mappings":"AAEA,OAAO,+BAA+B;AAMtC,MAAM,iCAAiC,OACrC,SACA,EAAE,eAAe,GACjB,YAEA;AAAA,EACE;AAAA,EACA;AAAA,IACE,aAAa,OAAO,EAAE,QAAQ,MAAM,QAAQ;AAAA,IAC5C,eAAe,OAAO,EAAE,KAAK,SAAS,SAAAA,UAAS,SAAS,MAAM;AAC5D,UAAI,KAAK,0BAAqB;AAC9B,YAAM,eAAe,EAAE,KAAK,SAAS,SAAAA,UAAS,SAAS,CAAC;AACxD,UAAI,KAAK,gCAA2B;AACpC,YAAM,SAAS,sBAAsB,EAAE,IAAI,QAAQ,cAAc,CAAC;AAAA,IACpE;AAAA,IACA,cAAc,OAAO,EAAE,SAAAA,SAAQ,MAAMA,SAAQ,KAAK;AAAA,EACpD;AAAA,EACA;AACF;AAEF,IAAO,yCAAQ;","names":["request"]}
+{"version":3,"sources":["../../src/helpers/handleCreateIntegrationWebhook.ts"],"sourcesContent":["import type { CreateIntegrationRequestPayload } from \"../webhooks.js\";\nimport type { HandlerOptions, TaskContext } from \"./_types.js\";\nimport handleRequestWithWorknice from \"./handleRequestWithWorknice.js\";\n\ntype Tasks = {\n  persistDetails: (context: TaskContext<CreateIntegrationRequestPayload>) => Promise<void>;\n};\n\nconst handleCreateIntegrationWebhook = async (\n  request: Request,\n  { persistDetails }: Tasks,\n  options?: HandlerOptions,\n) =>\n  handleRequestWithWorknice<CreateIntegrationRequestPayload>(\n    request,\n    {\n      getApiToken: async ({ payload }) => payload.apiToken,\n      getEnv: async () => null,\n      handleRequest: async (context) => {\n        const { logger, payload, worknice } = context;\n        logger.debug(\"Persisting details…\");\n        await persistDetails(context);\n        logger.debug(\"Initializing integration…\");\n        await worknice.initializeIntegration({ id: payload.integrationId });\n      },\n      parsePayload: async ({ request }) => request.json(),\n    },\n    options,\n  );\n\nexport default handleCreateIntegrationWebhook;\n"],"mappings":"AAEA,OAAO,+BAA+B;AAMtC,MAAM,iCAAiC,OACrC,SACA,EAAE,eAAe,GACjB,YAEA;AAAA,EACE;AAAA,EACA;AAAA,IACE,aAAa,OAAO,EAAE,QAAQ,MAAM,QAAQ;AAAA,IAC5C,QAAQ,YAAY;AAAA,IACpB,eAAe,OAAO,YAAY;AAChC,YAAM,EAAE,QAAQ,SAAS,SAAS,IAAI;AACtC,aAAO,MAAM,0BAAqB;AAClC,YAAM,eAAe,OAAO;AAC5B,aAAO,MAAM,gCAA2B;AACxC,YAAM,SAAS,sBAAsB,EAAE,IAAI,QAAQ,cAAc,CAAC;AAAA,IACpE;AAAA,IACA,cAAc,OAAO,EAAE,SAAAA,SAAQ,MAAMA,SAAQ,KAAK;AAAA,EACpD;AAAA,EACA;AACF;AAEF,IAAO,yCAAQ;","names":["request"]}

package/dist/helpers/handleGetAuthorizationUrlWebhook.d.ts

@@ -1,7 +1,8 @@
 import { GetAuthorizationUrlRequestPayload } from '../webhooks.js';
 import { HandlerOptions, TaskContext } from './_types.js';
-import '../_types-DsB4q143.js';
+import '../_types-BXw9D0Qi.js';
 import '../api/_generated.js';
+import '../api/WorkniceIntegrationLogger.js';
 
 type Tasks = {
     getAuthorisationUrl: (context: TaskContext<GetAuthorizationUrlRequestPayload>) => Promise<string>;

package/dist/helpers/handleGetAuthorizationUrlWebhook.js

@@ -2,8 +2,11 @@ import handleRequestWithWorknice from "./handleRequestWithWorknice.js";
 const handleGetAuthorizationUrlWebhook = async (request, { getAuthorisationUrl }, options) => handleRequestWithWorknice(
   request,
   {
+    getApiToken: async () => void 0,
+    getEnv: async () => null,
     handleRequest: async (context) => {
-      context.log.info("Getting authorization url\u2026");
+      const { logger } = context;
+      logger.debug("Getting authorization url\u2026");
       return {
         authorizationUrl: await getAuthorisationUrl(context)
       };

package/dist/helpers/handleGetAuthorizationUrlWebhook.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/helpers/handleGetAuthorizationUrlWebhook.ts"],"sourcesContent":["import type {\n  GetAuthorizationUrlRequestPayload,\n  GetAuthorizationUrlResponsePayload,\n} from \"../webhooks.js\";\nimport type { HandlerOptions, TaskContext } from \"./_types.js\";\nimport handleRequestWithWorknice from \"./handleRequestWithWorknice.js\";\n\ntype Tasks = {\n  getAuthorisationUrl: (context: TaskContext<GetAuthorizationUrlRequestPayload>) => Promise<string>;\n};\n\nconst handleGetAuthorizationUrlWebhook = async (\n  request: Request,\n  { getAuthorisationUrl }: Tasks,\n  options?: HandlerOptions,\n) =>\n  handleRequestWithWorknice<GetAuthorizationUrlRequestPayload, GetAuthorizationUrlResponsePayload>(\n    request,\n    {\n      handleRequest: async (context) => {\n        context.log.info(\"Getting authorization url…\");\n        return {\n          authorizationUrl: await getAuthorisationUrl(context),\n        };\n      },\n      parsePayload: async ({ request }) => request.json(),\n    },\n    options,\n  );\n\nexport default handleGetAuthorizationUrlWebhook;\n"],"mappings":"AAKA,OAAO,+BAA+B;AAMtC,MAAM,mCAAmC,OACvC,SACA,EAAE,oBAAoB,GACtB,YAEA;AAAA,EACE;AAAA,EACA;AAAA,IACE,eAAe,OAAO,YAAY;AAChC,cAAQ,IAAI,KAAK,iCAA4B;AAC7C,aAAO;AAAA,QACL,kBAAkB,MAAM,oBAAoB,OAAO;AAAA,MACrD;AAAA,IACF;AAAA,IACA,cAAc,OAAO,EAAE,SAAAA,SAAQ,MAAMA,SAAQ,KAAK;AAAA,EACpD;AAAA,EACA;AACF;AAEF,IAAO,2CAAQ;","names":["request"]}
+{"version":3,"sources":["../../src/helpers/handleGetAuthorizationUrlWebhook.ts"],"sourcesContent":["import type {\n  GetAuthorizationUrlRequestPayload,\n  GetAuthorizationUrlResponsePayload,\n} from \"../webhooks.js\";\nimport type { HandlerOptions, TaskContext } from \"./_types.js\";\nimport handleRequestWithWorknice from \"./handleRequestWithWorknice.js\";\n\ntype Tasks = {\n  getAuthorisationUrl: (context: TaskContext<GetAuthorizationUrlRequestPayload>) => Promise<string>;\n};\n\nconst handleGetAuthorizationUrlWebhook = async (\n  request: Request,\n  { getAuthorisationUrl }: Tasks,\n  options?: HandlerOptions,\n) =>\n  handleRequestWithWorknice<GetAuthorizationUrlRequestPayload, GetAuthorizationUrlResponsePayload>(\n    request,\n    {\n      getApiToken: async () => undefined,\n      getEnv: async () => null,\n      handleRequest: async (context) => {\n        const { logger } = context;\n        logger.debug(\"Getting authorization url…\");\n        return {\n          authorizationUrl: await getAuthorisationUrl(context),\n        };\n      },\n      parsePayload: async ({ request }) => request.json(),\n    },\n    options,\n  );\n\nexport default handleGetAuthorizationUrlWebhook;\n"],"mappings":"AAKA,OAAO,+BAA+B;AAMtC,MAAM,mCAAmC,OACvC,SACA,EAAE,oBAAoB,GACtB,YAEA;AAAA,EACE;AAAA,EACA;AAAA,IACE,aAAa,YAAY;AAAA,IACzB,QAAQ,YAAY;AAAA,IACpB,eAAe,OAAO,YAAY;AAChC,YAAM,EAAE,OAAO,IAAI;AACnB,aAAO,MAAM,iCAA4B;AACzC,aAAO;AAAA,QACL,kBAAkB,MAAM,oBAAoB,OAAO;AAAA,MACrD;AAAA,IACF;AAAA,IACA,cAAc,OAAO,EAAE,SAAAA,SAAQ,MAAMA,SAAQ,KAAK;AAAA,EACpD;AAAA,EACA;AACF;AAEF,IAAO,2CAAQ;","names":["request"]}

package/dist/helpers/handleGetLeaveBalancesWebhook.d.ts

@@ -0,0 +1,14 @@
+import { GetLeaveBalancesResponsePayload, GetLeaveBalancesRequestPayload } from '../webhooks.js';
+import { HandlerOptions, TaskContext } from './_types.js';
+import '../_types-BXw9D0Qi.js';
+import '../api/_generated.js';
+import '../api/WorkniceIntegrationLogger.js';
+
+type Context<Env> = TaskContext<GetLeaveBalancesRequestPayload, Env>;
+type Tasks<Env> = {
+    getEnv: (context: Pick<Context<Env>, "logger" | "payload" | "request">) => Promise<Env>;
+    getLeaveBalances: (context: Context<Env>) => Promise<GetLeaveBalancesResponsePayload>;
+};
+declare const handleGetLeaveBalancesWebhook: <Env>(request: Request, { getEnv, getLeaveBalances }: Tasks<Env>, options?: HandlerOptions) => Promise<Response>;
+
+export { handleGetLeaveBalancesWebhook as default };

package/dist/helpers/handleGetLeaveBalancesWebhook.js

@@ -0,0 +1,22 @@
+import handleRequestWithWorknice from "./handleRequestWithWorknice.js";
+const handleGetLeaveBalancesWebhook = async (request, { getEnv, getLeaveBalances }, options) => handleRequestWithWorknice(
+  request,
+  {
+    getApiToken: async () => void 0,
+    getEnv,
+    handleRequest: async (context) => {
+      const { logger } = context;
+      logger.info("Retrieving leave balances\u2026");
+      const result = await getLeaveBalances(context);
+      logger.info(`Retrieved ${result.length} leave balances.`);
+      return result;
+    },
+    parsePayload: async ({ request: request2 }) => request2.json()
+  },
+  options
+);
+var handleGetLeaveBalancesWebhook_default = handleGetLeaveBalancesWebhook;
+export {
+  handleGetLeaveBalancesWebhook_default as default
+};
+//# sourceMappingURL=handleGetLeaveBalancesWebhook.js.map

package/dist/helpers/handleGetLeaveBalancesWebhook.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/helpers/handleGetLeaveBalancesWebhook.ts"],"sourcesContent":["import type {\n  GetLeaveBalancesRequestPayload,\n  GetLeaveBalancesResponsePayload,\n} from \"../webhooks.js\";\nimport type { HandlerOptions, TaskContext } from \"./_types.js\";\nimport handleRequestWithWorknice from \"./handleRequestWithWorknice.js\";\n\ntype Context<Env> = TaskContext<GetLeaveBalancesRequestPayload, Env>;\n\ntype Tasks<Env> = {\n  getEnv: (context: Pick<Context<Env>, \"logger\" | \"payload\" | \"request\">) => Promise<Env>;\n  getLeaveBalances: (context: Context<Env>) => Promise<GetLeaveBalancesResponsePayload>;\n};\n\nconst handleGetLeaveBalancesWebhook = async <Env>(\n  request: Request,\n  { getEnv, getLeaveBalances }: Tasks<Env>,\n  options?: HandlerOptions,\n) =>\n  handleRequestWithWorknice<GetLeaveBalancesRequestPayload, GetLeaveBalancesResponsePayload, Env>(\n    request,\n    {\n      getApiToken: async () => undefined,\n      getEnv,\n      handleRequest: async (context) => {\n        const { logger } = context;\n        logger.info(\"Retrieving leave balances…\");\n        const result = await getLeaveBalances(context);\n        logger.info(`Retrieved ${result.length} leave balances.`);\n        return result;\n      },\n      parsePayload: async ({ request }) => request.json(),\n    },\n    options,\n  );\n\nexport default handleGetLeaveBalancesWebhook;\n"],"mappings":"AAKA,OAAO,+BAA+B;AAStC,MAAM,gCAAgC,OACpC,SACA,EAAE,QAAQ,iBAAiB,GAC3B,YAEA;AAAA,EACE;AAAA,EACA;AAAA,IACE,aAAa,YAAY;AAAA,IACzB;AAAA,IACA,eAAe,OAAO,YAAY;AAChC,YAAM,EAAE,OAAO,IAAI;AACnB,aAAO,KAAK,iCAA4B;AACxC,YAAM,SAAS,MAAM,iBAAiB,OAAO;AAC7C,aAAO,KAAK,aAAa,OAAO,MAAM,kBAAkB;AACxD,aAAO;AAAA,IACT;AAAA,IACA,cAAc,OAAO,EAAE,SAAAA,SAAQ,MAAMA,SAAQ,KAAK;AAAA,EACpD;AAAA,EACA;AACF;AAEF,IAAO,wCAAQ;","names":["request"]}

package/dist/helpers/handleRequestWithWorknice.d.ts

@@ -1,19 +1,14 @@
-import { HandlerOptions, Logger, TaskContext } from './_types.js';
-import '../_types-DsB4q143.js';
+import { HandlerOptions, TaskContext } from './_types.js';
+import '../_types-BXw9D0Qi.js';
 import '../api/_generated.js';
+import '../api/WorkniceIntegrationLogger.js';
 
-type Tasks<RequestPayload, ResponsePayload> = {
-    getApiToken?: (context: {
-        log: Logger;
-        payload: RequestPayload;
-        request: Request;
-    }) => Promise<string>;
-    handleRequest: (context: TaskContext<RequestPayload>) => Promise<ResponsePayload>;
-    parsePayload: (context: {
-        log: Logger;
-        request: Request;
-    }) => Promise<RequestPayload>;
+type Tasks<RequestPayload, ResponsePayload, Env = null> = {
+    getApiToken: (context: Pick<TaskContext<RequestPayload, Env>, "env" | "logger" | "payload" | "request">) => Promise<string | undefined>;
+    getEnv: (context: Pick<TaskContext<RequestPayload, Env>, "logger" | "payload" | "request">) => Promise<Env>;
+    handleRequest: (context: TaskContext<RequestPayload, Env>) => Promise<ResponsePayload>;
+    parsePayload: (context: Pick<TaskContext<RequestPayload, Env>, "logger" | "request">) => Promise<RequestPayload>;
 };
-declare const handleRequestWithWorknice: <RequestPayload, ResponsePayload extends object | undefined = undefined>(request: Request, tasks: Tasks<RequestPayload, ResponsePayload>, options?: HandlerOptions) => Promise<Response>;
+declare const handleRequestWithWorknice: <RequestPayload, ResponsePayload extends Response | object | undefined = undefined, Env = null>(request: Request, tasks: Tasks<RequestPayload, ResponsePayload, Env>, options?: HandlerOptions) => Promise<Response>;
 
 export { handleRequestWithWorknice as default };

package/dist/helpers/handleRequestWithWorknice.js

@@ -1,39 +1,60 @@
 import createWorkniceClient from "../api/createWorkniceClient.js";
+import WorkniceIntegrationLogger from "../api/WorkniceIntegrationLogger.js";
 import errorToString from "../utils/errorToString.js";
 const handleRequestWithWorknice = async (request, tasks, options) => {
-  const log = options?.logger ?? console;
+  const logger = new WorkniceIntegrationLogger(options?.logger ?? console);
   try {
-    log.info("Parsing request payload\u2026");
-    const payload = await tasks.parsePayload({ log, request });
-    log.info("Getting Worknice API token\u2026");
-    const apiToken = tasks.getApiToken ? await tasks.getApiToken({ log, payload, request }) : void 0;
-    log.info("Creating Worknice client\u2026");
+    logger.debug("Parsing request payload\u2026");
+    const payload = await tasks.parsePayload({ logger, request });
+    logger.indent("Initialising environment\u2026");
+    const env = await tasks.getEnv({ logger, payload, request });
+    logger.dedent("Finished initialising environment.");
+    logger.indent("Initialising Worknice client\u2026");
+    const apiToken = await tasks.getApiToken({ env, logger, payload, request });
+    logger.info("Retrieved Worknice API token.");
     const worknice = createWorkniceClient({
       accessToken: apiToken,
       apiUrl: options?.apiUrl
     });
-    log.info("Handling request\u2026");
-    const response = await tasks.handleRequest({
-      log,
+    logger.info("Created Worknice client.");
+    logger.dedent("Finished initialising Worknice client.");
+    logger.debug("Handling request\u2026");
+    const result = await tasks.handleRequest({
+      env,
+      logger,
       payload,
       request,
       worknice
     });
-    log.info("Serializing response\u2026");
-    const responseBody = typeof response === "object" ? JSON.stringify(response) : "ok";
-    log.info("Request complete.");
-    return new Response(responseBody, {
-      headers: {
-        "Content-Type": "application/json"
-      },
-      status: 200
-    });
+    logger.debug("Generating response\u2026");
+    let response;
+    if (result instanceof Response) {
+      response = result;
+    } else if (typeof result === "object") {
+      response = new Response(JSON.stringify(result), {
+        headers: {
+          "Content-Type": "application/json"
+        },
+        status: 200
+      });
+    } else {
+      response = new Response("ok", {
+        headers: {
+          "Content-Type": "application/json"
+        },
+        status: 200
+      });
+    }
+    logger.debug("Request complete.");
+    await logger.flush();
+    return response;
   } catch (error) {
     const message = errorToString(error, {
       format: options?.debug ? "chain" : "simple",
       stack: options?.debug ?? false
     });
-    log.error(message);
+    logger.error(message);
+    await logger.flush();
     return new Response(message, {
       status: 500
     });

package/dist/helpers/handleRequestWithWorknice.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/helpers/handleRequestWithWorknice.ts"],"sourcesContent":["import createWorkniceClient from \"../api/createWorkniceClient.js\";\nimport errorToString from \"../utils/errorToString.js\";\nimport type { HandlerOptions, Logger, TaskContext } from \"./_types.js\";\n\ntype Tasks<RequestPayload, ResponsePayload> = {\n  getApiToken?: (context: {\n    log: Logger;\n    payload: RequestPayload;\n    request: Request;\n  }) => Promise<string>;\n  handleRequest: (context: TaskContext<RequestPayload>) => Promise<ResponsePayload>;\n  parsePayload: (context: { log: Logger; request: Request }) => Promise<RequestPayload>;\n};\n\nconst handleRequestWithWorknice = async <\n  RequestPayload,\n  ResponsePayload extends object | undefined = undefined,\n>(\n  request: Request,\n  tasks: Tasks<RequestPayload, ResponsePayload>,\n  options?: HandlerOptions,\n) => {\n  const log = options?.logger ?? console;\n\n  try {\n    log.info(\"Parsing request payload…\");\n\n    const payload = await tasks.parsePayload({ log, request });\n\n    log.info(\"Getting Worknice API token…\");\n\n    const apiToken = tasks.getApiToken\n      ? await tasks.getApiToken({ log, payload, request })\n      : undefined;\n\n    log.info(\"Creating Worknice client…\");\n\n    const worknice = createWorkniceClient({\n      accessToken: apiToken,\n      apiUrl: options?.apiUrl,\n    });\n\n    log.info(\"Handling request…\");\n\n    const response = await tasks.handleRequest({\n      log,\n      payload,\n      request,\n      worknice,\n    });\n\n    log.info(\"Serializing response…\");\n\n    const responseBody = typeof response === \"object\" ? JSON.stringify(response) : \"ok\";\n\n    log.info(\"Request complete.\");\n\n    return new Response(responseBody, {\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n      status: 200,\n    });\n  } catch (error) {\n    const message = errorToString(error, {\n      format: options?.debug ? \"chain\" : \"simple\",\n      stack: options?.debug ?? false,\n    });\n\n    log.error(message);\n\n    return new Response(message, {\n      status: 500,\n    });\n  }\n};\n\nexport default handleRequestWithWorknice;\n"],"mappings":"AAAA,OAAO,0BAA0B;AACjC,OAAO,mBAAmB;AAa1B,MAAM,4BAA4B,OAIhC,SACA,OACA,YACG;AACH,QAAM,MAAM,SAAS,UAAU;AAE/B,MAAI;AACF,QAAI,KAAK,+BAA0B;AAEnC,UAAM,UAAU,MAAM,MAAM,aAAa,EAAE,KAAK,QAAQ,CAAC;AAEzD,QAAI,KAAK,kCAA6B;AAEtC,UAAM,WAAW,MAAM,cACnB,MAAM,MAAM,YAAY,EAAE,KAAK,SAAS,QAAQ,CAAC,IACjD;AAEJ,QAAI,KAAK,gCAA2B;AAEpC,UAAM,WAAW,qBAAqB;AAAA,MACpC,aAAa;AAAA,MACb,QAAQ,SAAS;AAAA,IACnB,CAAC;AAED,QAAI,KAAK,wBAAmB;AAE5B,UAAM,WAAW,MAAM,MAAM,cAAc;AAAA,MACzC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,KAAK,4BAAuB;AAEhC,UAAM,eAAe,OAAO,aAAa,WAAW,KAAK,UAAU,QAAQ,IAAI;AAE/E,QAAI,KAAK,mBAAmB;AAE5B,WAAO,IAAI,SAAS,cAAc;AAAA,MAChC,SAAS;AAAA,QACP,gBAAgB;AAAA,MAClB;AAAA,MACA,QAAQ;AAAA,IACV,CAAC;AAAA,EACH,SAAS,OAAO;AACd,UAAM,UAAU,cAAc,OAAO;AAAA,MACnC,QAAQ,SAAS,QAAQ,UAAU;AAAA,MACnC,OAAO,SAAS,SAAS;AAAA,IAC3B,CAAC;AAED,QAAI,MAAM,OAAO;AAEjB,WAAO,IAAI,SAAS,SAAS;AAAA,MAC3B,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACF;AAEA,IAAO,oCAAQ;","names":[]}
+{"version":3,"sources":["../../src/helpers/handleRequestWithWorknice.ts"],"sourcesContent":["import createWorkniceClient from \"../api/createWorkniceClient.js\";\nimport WorkniceIntegrationLogger from \"../api/WorkniceIntegrationLogger.js\";\nimport errorToString from \"../utils/errorToString.js\";\nimport type { HandlerOptions, TaskContext } from \"./_types.js\";\n\ntype Tasks<RequestPayload, ResponsePayload, Env = null> = {\n  getApiToken: (\n    context: Pick<TaskContext<RequestPayload, Env>, \"env\" | \"logger\" | \"payload\" | \"request\">,\n  ) => Promise<string | undefined>;\n  getEnv: (\n    context: Pick<TaskContext<RequestPayload, Env>, \"logger\" | \"payload\" | \"request\">,\n  ) => Promise<Env>;\n  handleRequest: (context: TaskContext<RequestPayload, Env>) => Promise<ResponsePayload>;\n  parsePayload: (\n    context: Pick<TaskContext<RequestPayload, Env>, \"logger\" | \"request\">,\n  ) => Promise<RequestPayload>;\n};\n\nconst handleRequestWithWorknice = async <\n  RequestPayload,\n  ResponsePayload extends Response | object | undefined = undefined,\n  Env = null,\n>(\n  request: Request,\n  tasks: Tasks<RequestPayload, ResponsePayload, Env>,\n  options?: HandlerOptions,\n) => {\n  const logger = new WorkniceIntegrationLogger(options?.logger ?? console);\n\n  try {\n    logger.debug(\"Parsing request payload…\");\n\n    const payload = await tasks.parsePayload({ logger, request });\n\n    logger.indent(\"Initialising environment…\");\n\n    const env = await tasks.getEnv({ logger, payload, request });\n\n    logger.dedent(\"Finished initialising environment.\");\n\n    logger.indent(\"Initialising Worknice client…\");\n\n    const apiToken = await tasks.getApiToken({ env, logger, payload, request });\n\n    logger.info(\"Retrieved Worknice API token.\");\n\n    const worknice = createWorkniceClient({\n      accessToken: apiToken,\n      apiUrl: options?.apiUrl,\n    });\n\n    logger.info(\"Created Worknice client.\");\n\n    logger.dedent(\"Finished initialising Worknice client.\");\n\n    logger.debug(\"Handling request…\");\n\n    const result = await tasks.handleRequest({\n      env,\n      logger,\n      payload,\n      request,\n      worknice,\n    });\n\n    logger.debug(\"Generating response…\");\n\n    let response: Response;\n\n    if (result instanceof Response) {\n      response = result;\n    } else if (typeof result === \"object\") {\n      response = new Response(JSON.stringify(result), {\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        status: 200,\n      });\n    } else {\n      response = new Response(\"ok\", {\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        status: 200,\n      });\n    }\n\n    logger.debug(\"Request complete.\");\n\n    await logger.flush();\n\n    return response;\n  } catch (error) {\n    const message = errorToString(error, {\n      format: options?.debug ? \"chain\" : \"simple\",\n      stack: options?.debug ?? false,\n    });\n\n    logger.error(message);\n\n    await logger.flush();\n\n    return new Response(message, {\n      status: 500,\n    });\n  }\n};\n\nexport default handleRequestWithWorknice;\n"],"mappings":"AAAA,OAAO,0BAA0B;AACjC,OAAO,+BAA+B;AACtC,OAAO,mBAAmB;AAgB1B,MAAM,4BAA4B,OAKhC,SACA,OACA,YACG;AACH,QAAM,SAAS,IAAI,0BAA0B,SAAS,UAAU,OAAO;AAEvE,MAAI;AACF,WAAO,MAAM,+BAA0B;AAEvC,UAAM,UAAU,MAAM,MAAM,aAAa,EAAE,QAAQ,QAAQ,CAAC;AAE5D,WAAO,OAAO,gCAA2B;AAEzC,UAAM,MAAM,MAAM,MAAM,OAAO,EAAE,QAAQ,SAAS,QAAQ,CAAC;AAE3D,WAAO,OAAO,oCAAoC;AAElD,WAAO,OAAO,oCAA+B;AAE7C,UAAM,WAAW,MAAM,MAAM,YAAY,EAAE,KAAK,QAAQ,SAAS,QAAQ,CAAC;AAE1E,WAAO,KAAK,+BAA+B;AAE3C,UAAM,WAAW,qBAAqB;AAAA,MACpC,aAAa;AAAA,MACb,QAAQ,SAAS;AAAA,IACnB,CAAC;AAED,WAAO,KAAK,0BAA0B;AAEtC,WAAO,OAAO,wCAAwC;AAEtD,WAAO,MAAM,wBAAmB;AAEhC,UAAM,SAAS,MAAM,MAAM,cAAc;AAAA,MACvC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO,MAAM,2BAAsB;AAEnC,QAAI;AAEJ,QAAI,kBAAkB,UAAU;AAC9B,iBAAW;AAAA,IACb,WAAW,OAAO,WAAW,UAAU;AACrC,iBAAW,IAAI,SAAS,KAAK,UAAU,MAAM,GAAG;AAAA,QAC9C,SAAS;AAAA,UACP,gBAAgB;AAAA,QAClB;AAAA,QACA,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,OAAO;AACL,iBAAW,IAAI,SAAS,MAAM;AAAA,QAC5B,SAAS;AAAA,UACP,gBAAgB;AAAA,QAClB;AAAA,QACA,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAEA,WAAO,MAAM,mBAAmB;AAEhC,UAAM,OAAO,MAAM;AAEnB,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,UAAU,cAAc,OAAO;AAAA,MACnC,QAAQ,SAAS,QAAQ,UAAU;AAAA,MACnC,OAAO,SAAS,SAAS;AAAA,IAC3B,CAAC;AAED,WAAO,MAAM,OAAO;AAEpB,UAAM,OAAO,MAAM;AAEnB,WAAO,IAAI,SAAS,SAAS;AAAA,MAC3B,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AACF;AAEA,IAAO,oCAAQ;","names":[]}

package/dist/helpers/handleTriggerIntegrationSyncWebhook.d.ts

@@ -0,0 +1,73 @@
+import { W as WorkniceClient } from '../_types-BXw9D0Qi.js';
+import { PartialPersonDataTransferLine } from '../employee-records/_types.js';
+import { TriggerIntegrationSyncRequestPayload } from '../webhooks.js';
+import { HandlerOptions, TaskContext } from './_types.js';
+import '../api/_generated.js';
+import '../api/WorkniceIntegrationLogger.js';
+
+type Context<Env> = TaskContext<TriggerIntegrationSyncRequestPayload, Env> & {
+    integration: Awaited<ReturnType<WorkniceClient["getIntegration"]>>;
+};
+type Person = PartialPersonDataTransferLine & {
+    metadata: {
+        deleted: boolean;
+        employeeCode: string | null;
+        sourceId: string;
+        targetId: string | null;
+        updatedAt: string;
+    };
+    profile: {
+        displayName: string;
+        profileEmail: string | null;
+    } | null;
+};
+type Tasks<Env> = {
+    createRemotePerson?: (person: Person, context: Context<Env>) => Promise<{
+        id: string;
+        name: string;
+    }>;
+    getApiToken: (context: Pick<Context<Env>, "env" | "logger" | "payload" | "request">) => Promise<string>;
+    getConfig: (context: Context<Env>) => Promise<Config>;
+    getEnv: (context: Pick<Context<Env>, "logger" | "payload" | "request">) => Promise<Env>;
+    getRemotePeople: (context: Context<Env>) => Promise<Array<Person>>;
+    updateRemotePerson?: (person: Person, context: Context<Env>) => Promise<unknown>;
+};
+type Config = {
+    appName: string;
+    automaticMatching?: boolean;
+    mode?: "connection-only" | "one-way" | "two-way";
+    syncFields?: {
+        bankAccounts?: boolean;
+        emergencyContacts?: boolean;
+        personalDetails?: boolean;
+        postalAddress?: boolean;
+        profile?: boolean;
+        remuneration?: boolean;
+        residentialAddress?: boolean;
+        superFunds?: boolean;
+        taxDetails?: boolean;
+        tenure?: boolean;
+    };
+};
+/**
+ * The process for syncing has four steps:
+ *
+ * 1. Update person connections: Create new person connections for Worknice
+ *    people or remote people that don't have existing connections. If needed,
+ *    update names of existing person connections. If enabled, automatically
+ *    match connections.
+ *
+ * 2. Update merged people: Copy details from the Worknice people to remote
+ *    people or vice-versa (based on whichever one was updated most recently)
+ *    for person connections that are already marked as merged.
+ *
+ * 3. Merge matched people: Update both Worknice people and remote people for
+ *    person connections that are marked as matched using details from both
+ *    people merged together. Mark the connections as merged.
+ *
+ * 4. Add new people to the remote app: Create new people in the remote app for
+ *    connections are unmatched and local-only. Mark the connections as merged.
+ */
+declare const handleTriggerIntegrationSyncWebhook: <Env>(request: Request, { createRemotePerson, getApiToken, getConfig, getEnv, getRemotePeople, updateRemotePerson, }: Tasks<Env>, options?: HandlerOptions) => Promise<Response>;
+
+export { handleTriggerIntegrationSyncWebhook as default };