@greensecurity/javascript-sdk 0.44.0-beta.7 → 0.44.0-beta.70

package/src/__tests__/webhooks.test.ts

@@ -20,7 +20,7 @@ test("Webhooks List All Webhook Endpoints", async () => {
   const testWebhookListForVendorUserResult = await greenSecurity.webhooks
     .listAllWebhookEndpoints({
       itemsPerPage: 25,
-      desc: 0,
+      desc: true,
       sort: "",
     });
   expect(testWebhookListForVendorUserResult).toBeDefined();
@@ -60,13 +60,13 @@ test("Webhooks Updates The Webhook Endpoint With The Given Id", async () => {
   const result = await greenSecurity.webhooks
     .updatesTheWebhookEndpointWithTheGivenId({
       id: 220782,
-      webhookEndpoint: {
-        id: 1,
+      webhookEndpointUpdate: {
         webhookUrl: "https://example.com/webhook/incoming",
-        subscriptions: [
-          "<value 1>",
-          "<value 2>",
-        ],
+        subscriptions: {
+          model: "Vendor",
+          action: "updated",
+          expands: "vendor.company,vendor.user",
+        },
         consumers: {
           systemId: 1,
           facilityId: 1,
@@ -81,8 +81,67 @@ test("Webhooks Updates The Webhook Endpoint With The Given Id", async () => {
     webhookUrl: "https://example.com/webhook/incoming",
     signatureAlgo: "sig_hmac_sha256",
     subscriptions: [
-      "<value 1>",
-      "<value 2>",
+      {
+        model: "Vendor",
+        action: "updated",
+      },
+      {
+        model: "Vendor",
+        action: "updated",
+      },
+    ],
+    consumers: {
+      systemId: 1,
+      facilityId: 1,
+      companyId: 1,
+      userId: 1,
+    },
+  });
+});
+
+test("Webhooks Create Webhook Endpoint", async () => {
+  const testHttpClient = createTestHTTPClient("createWebhookEndpoint");
+
+  const greenSecurity = new GreenSecurity({
+    serverURL: process.env["TEST_SERVER_URL"] ?? "https://localhost:3000/api",
+    httpClient: testHttpClient,
+    security: {
+      token: process.env["GREEN_SECURITY_TOKEN"] ?? "value",
+    },
+  });
+
+  const result = await greenSecurity.webhooks.createWebhookEndpoint({
+    webhookUrl: "https://example.com/webhook/incoming",
+    subscriptions: [
+      "Vendor.updated",
+      "Vendor.created",
+    ],
+    expand: [
+      "vendor.company",
+    ],
+    consumers: {
+      systemId: 1,
+      facilityId: 1,
+      companyId: 1,
+      userId: 1,
+    },
+  });
+  expect(result).toBeDefined();
+  expect(result).toEqual({
+    id: 1,
+    webhookUrl: "https://example.com/webhook/incoming",
+    signatureAlgo: "sig_hmac_sha256",
+    subscriptions: [
+      {
+        model: "Vendor",
+        action: "updated",
+        expands: "vendor.company,vendor.user",
+      },
+      {
+        model: "Vendor",
+        action: "created",
+        expands: "",
+      },
     ],
     consumers: {
       systemId: 1,
@@ -92,3 +151,23 @@ test("Webhooks Updates The Webhook Endpoint With The Given Id", async () => {
     },
   });
 });
+
+test("Webhooks Delete Webhook Endpoint", async () => {
+  const testHttpClient = createTestHTTPClient("deleteWebhookEndpoint");
+
+  const greenSecurity = new GreenSecurity({
+    serverURL: process.env["TEST_SERVER_URL"] ?? "https://localhost:3000/api",
+    httpClient: testHttpClient,
+    security: {
+      token: process.env["GREEN_SECURITY_TOKEN"] ?? "value",
+    },
+  });
+
+  const result = await greenSecurity.webhooks.deleteWebhookEndpoint({
+    id: 256003,
+  });
+  expect(result).toBeDefined();
+  expect(result).toEqual({
+    success: false,
+  });
+});

package/src/__tests__/zones.test.ts

@@ -42,22 +42,25 @@ test("Zones List Or Search Security Zones", async () => {
         facility: {
           contacts: {
             contact: {
-              status: "Inactive",
-              department: 123,
+              status: "Deleted",
+              department: null,
             },
             adminContact: null,
             techContact: {
-              status: "Active",
+              status: "Deleted",
               department: 123,
             },
-            greenSecurityCsm: null,
+            greenSecurityCsm: {
+              status: "Inactive",
+              department: null,
+            },
             accountManager: {
-              status: "Deleted",
+              status: "Inactive",
               department: 123,
             },
           },
           vendorGuestPolicy: {
-            enabled: true,
+            enabled: false,
             vendorGuestLimitAndOr: "and",
             vendorGuestRequireEmail: false,
           },
@@ -79,8 +82,9 @@ test("Zones Security Zone Checkin", async () => {
   });
 
   const result = await greenSecurity.zones.securityZoneCheckin({
-    qrCode: "<value>",
-    zoneId: 145454,
+    longitude: 1088.53,
+    latitude: 6020.88,
+    zoneId: 654096,
   });
   expect(result).toBeDefined();
   expect(result).toEqual({});

package/src/admin-funcs/companyManagerGetPaymentForm.ts

@@ -0,0 +1,6 @@
+import { APIPromise } from "../types/async.js";
+import { $doGetSingle, internalApiResult } from "./doAdmin.js";
+
+export function companyManagerGetPaymentForm(): internalApiResult {
+  return new APIPromise($doGetSingle("/company_managers/me/payment_form", {}));
+}

package/src/admin-funcs/registerEmail.ts

@@ -6,6 +6,17 @@ export type registerData = {
   email: string | null;
   override?: number;
   code?: string;
+
+  affiliate_id?: number;
+  vendor_group_id?: number;
+  managing_company_id?: number;
+
+  // Optional UTM parameters for tracking
+  utm_source?: string;
+  utm_medium?: string;
+  utm_campaign?: string;
+  utm_term?: string;
+  utm_content?: string;
 };
 
 export function submitEmailStep(request: registerData): internalApiResult {

package/src/admin-funcs/smartBadgeGetPsks.ts

@@ -0,0 +1,23 @@
+import { APIPromise } from "../types/async.js";
+import { $doGetSingle, internalApiResult } from "./doAdmin.js";
+import { smartBadgeMacAddressPathSegment } from "./smartBadgeMacAddress.js";
+
+// The pre-shared keys to try when writing to a smart badge, in the order worth trying.
+//
+// Badges from the two production runs carry different keys and only the badge can say which one it
+// holds, so the backend derives the candidates and the client works through them. This exists so
+// clients do not have to hold any key in code.
+//
+// macAddress may be bare hex, colon-separated or dash-separated, and the backend normalizes it. Not
+// the dot-separated form: Rails treats a dot in a path segment as a format separator, so
+// `c300.0083.ba4d` would not reach this route at all.
+//
+// Validated and encoded before it reaches the path, rather than interpolated raw: this builds the route
+// directly instead of going through pathToFunc, which is what applies charEncoding for generated
+// operations. See smartBadgeMacAddress for why encoding alone is not enough.
+export function smartBadgeGetPsks(macAddress: string): internalApiResult {
+  return new APIPromise($doGetSingle(
+      `/smart-badges/${smartBadgeMacAddressPathSegment(macAddress)}/psks`,
+      {}
+  ));
+}

package/src/admin-funcs/smartBadgeMacAddress.ts

@@ -0,0 +1,25 @@
+// Turns a badge MAC address into a path segment for the smart badge routes.
+//
+// Validated rather than only encoded. encodeURIComponent leaves `.` untouched — it is in the unreserved
+// set — and GreenSecurityCore._createRequest resolves the finished route with `new URL(path, baseURL)`
+// (lib/sdks.ts:136), which canonicalizes dot segments. So a macAddress of `..` survives encoding intact
+// and turns `/api/smart-badges/../psks` into `/api/psks`, leaving the intended route before the backend
+// validates anything; `.` collapses to `/api/smart-badges/psks` the same way. Encoding cannot close
+// that, because there is nothing to encode. Rejecting anything that is not a MAC address can.
+//
+// The accepted forms are bare hex, colon-separated and dash-separated, matching what the backend's
+// VendorScan.normalize_mac_address handles minus the dot-separated form: Rails treats a dot in a path
+// segment as a format separator, so that form never reaches these routes anyway. The backreference
+// keeps the separator consistent, so `c3:00-00:83:ba:4d` is not accepted either.
+const MAC_ADDRESS = /^(?:[0-9a-fA-F]{12}|[0-9a-fA-F]{2}([:-])(?:[0-9a-fA-F]{2}\1){4}[0-9a-fA-F]{2})$/;
+
+export function smartBadgeMacAddressPathSegment(macAddress: string): string {
+  if (!MAC_ADDRESS.test(macAddress)) {
+    throw new Error(
+      "Invalid smart badge MAC address: expected 12 hex digits, optionally colon- or dash-separated, " +
+        `got ${JSON.stringify(macAddress)}`
+    );
+  }
+
+  return encodeURIComponent(macAddress);
+}

package/src/admin-funcs/smartBadgeReportVerifiedPsk.ts

@@ -0,0 +1,25 @@
+import { APIPromise } from "../types/async.js";
+import { $doPost, internalApiResult } from "./doAdmin.js";
+import { smartBadgeMacAddressPathSegment } from "./smartBadgeMacAddress.js";
+
+export type smartBadgeReportVerifiedPskRequest = {
+  psk: string;
+};
+
+// Records which pre-shared key a badge actually accepted, so the next write to it goes straight to
+// that key instead of paying for a rejected handshake and a reconnect.
+//
+// The key travels in the body rather than the query string to keep it out of access and proxy logs.
+//
+// macAddress is validated and encoded for the same reason as in smartBadgeGetPsks, and it matters more
+// here: this request is an authenticated POST, so a value that escapes the route redirects that rather
+// than a read.
+export function smartBadgeReportVerifiedPsk(
+  macAddress: string,
+  request: smartBadgeReportVerifiedPskRequest
+): internalApiResult {
+  return new APIPromise($doPost(
+      `/smart-badges/${smartBadgeMacAddressPathSegment(macAddress)}/psk-verified`,
+      request
+  ));
+}

package/src/admin-funcs/subscriptionGetSmartBadgePrompt.ts

@@ -0,0 +1,13 @@
+import { APIPromise } from "../types/async.js";
+import { $doGetSingle, internalApiResult } from "./doAdmin.js";
+
+export type subscriptionGetSmartBadgePromptRequest = {
+  vendor_id: number;
+};
+
+export function subscriptionGetSmartBadgePrompt(request: subscriptionGetSmartBadgePromptRequest): internalApiResult {
+  return new APIPromise($doGetSingle(
+    "/subscription/smart-badge-prompt",
+    request
+  ));
+}

package/src/admin-funcs/vendorGetPaymentForm.ts

@@ -0,0 +1,6 @@
+import { APIPromise } from "../types/async.js";
+import { $doGetSingle, internalApiResult } from "./doAdmin.js";
+
+export function vendorGetPaymentForm(): internalApiResult {
+  return new APIPromise($doGetSingle("/vendors/me/payment_form", {}));
+}

package/src/admin-funcs/vendorGetSystemsRequiringSmartBadge.ts

@@ -0,0 +1,9 @@
+import { APIPromise } from "../types/async.js";
+import { $doGetSingle, internalApiResult } from "./doAdmin.js";
+
+export function vendorGetSystemsRequiringSmartBadge(vendorId: number | string): internalApiResult {
+  return new APIPromise($doGetSingle(
+      `/vendors/${vendorId}/systems-requiring-smart-badge`,
+      {}
+  ));
+}

package/src/funcs/alertsListAlerts.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery, queryJoin } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -223,7 +222,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/companiesListCompanyCredentials.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery, encodeSimple, queryJoin } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -234,7 +233,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/companiesListCompanyCredits.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery, encodeSimple, queryJoin } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -230,7 +229,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/companiesListCompanyManagers.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -226,7 +225,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/companiesListOrSearchCompanies.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery, queryJoin } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -227,7 +226,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/companiesLookupCompanies.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -220,7 +219,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/eventsListFeed.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -229,7 +228,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/eventsListLocations.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -222,7 +221,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/eventsListOrSearchVendorInvitees.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery, queryJoin } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -233,7 +232,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/eventsListPendingInvitations.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -226,7 +225,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/eventsListStandingAppointments.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -232,7 +231,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/fhirConfigsListOfFhirConfigurations.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -220,7 +219,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/invoicesInvoicesExport.ts

@@ -11,6 +11,7 @@ import { safeParse } from "../lib/schemas.js";
 import { RequestOptions } from "../lib/sdks.js";
 import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
 import { pathToFunc } from "../lib/url.js";
+import * as components from "../models/components/index.js";
 import { GreenSecurityError } from "../models/errors/greensecurityerror.js";
 import {
   ConnectionError,
@@ -41,7 +42,7 @@ export function invoicesInvoicesExport(
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    operations.InvoicesExportResponseBody,
+    components.CsvExportEnqueuedResponse,
     | errors.ApiErrorResponse
     | GreenSecurityError
     | ResponseValidationError
@@ -67,7 +68,7 @@ async function $do(
 ): Promise<
   [
     Result<
-      operations.InvoicesExportResponseBody,
+      components.CsvExportEnqueuedResponse,
       | errors.ApiErrorResponse
       | GreenSecurityError
       | ResponseValidationError
@@ -163,7 +164,7 @@ async function $do(
   };
 
   const [result] = await M.match<
-    operations.InvoicesExportResponseBody,
+    components.CsvExportEnqueuedResponse,
     | errors.ApiErrorResponse
     | GreenSecurityError
     | ResponseValidationError
@@ -174,7 +175,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, operations.InvoicesExportResponseBody$inboundSchema),
+    M.json(200, components.CsvExportEnqueuedResponse$inboundSchema),
     M.jsonErr([400, 401, 403], errors.ApiErrorResponse$inboundSchema),
     M.fail("4XX"),
     M.fail([500, "5XX"]),

package/src/funcs/invoicesListInvoices.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery, queryJoin } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -58,6 +57,7 @@ import {
  * - id (default)
  * - invoice_number
  * - date (processed date)
+ * - date_paid
  * - financial_status
  * - amount
  *
@@ -253,7 +253,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }