@greensecurity/javascript-sdk 0.47.0-beta.1 → 0.47.0-beta.10

package/src/admin-funcs/doAdmin.ts

@@ -341,10 +341,27 @@ export async function $doPostForm(
   return $doPostBody(route, form, {}, options);
 }
 
-export async function $doPut<T extends object>(
+export function $doPut<T extends object>(
   route: string,
   putData: T,
   options?: RequestOptions,
+): ReturnType<typeof $doJsonRequest> {
+  return $doJsonRequest("PUT", route, putData, options);
+}
+
+export function $doDelete(
+  route: string,
+  options?: RequestOptions,
+): ReturnType<typeof $doJsonRequest> {
+  return $doJsonRequest("DELETE", route, undefined, options);
+}
+
+// PUT and DELETE share everything but the method; a DELETE sends no body.
+async function $doJsonRequest(
+  method: "PUT" | "DELETE",
+  route: string,
+  data: object | undefined,
+  options?: RequestOptions,
 ): Promise<
   [
     Result<
@@ -367,7 +384,7 @@ export async function $doPut<T extends object>(
     throw new Error("GreenSecurityCore client is not initialized.");
   }
 
-  const body = encodeJSON("body", putData, { explode: true });
+  const body = data === undefined ? undefined : encodeJSON("body", data, { explode: true });
 
   // Extract the path parameters from the request object
   const pathParams = {}; //extractRouteParameters(route, request);
@@ -399,7 +416,7 @@ export async function $doPut<T extends object>(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "PUT",
+    method,
     baseURL: options?.serverURL,
     path: path,
     headers: headers,

package/src/admin-funcs/lookupsAddressAutocomplete.ts

@@ -0,0 +1,23 @@
+import { APIPromise } from "../types/async.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { $doGetSingle, hashToQueryString, internalApiResult } from "./doAdmin.js";
+
+// Returns Google Places address suggestions for a partly typed street address.
+export function lookupsAddressAutocomplete(
+  vendorCredentialId: number,
+  input: string,
+  sessionToken: string,
+  country?: string,
+  options?: RequestOptions,
+): internalApiResult {
+  const params: Record<string, string> = {
+    vendor_credential_id: String(vendorCredentialId),
+    input,
+    session_token: sessionToken,
+  };
+  if (country) params["country"] = country;
+
+  return new APIPromise(
+    $doGetSingle(`/lookups/address-autocomplete?${hashToQueryString(params)}`, {}, options),
+  );
+}

package/src/admin-funcs/lookupsAddressPlace.ts

@@ -0,0 +1,20 @@
+import { APIPromise } from "../types/async.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { $doGetSingle, hashToQueryString, internalApiResult } from "./doAdmin.js";
+
+// Returns the address fields for an autocomplete suggestion the user picked. Pass the same sessionToken used for
+// the autocomplete requests.
+export function lookupsAddressPlace(
+  vendorCredentialId: number,
+  placeId: string,
+  sessionToken: string,
+  options?: RequestOptions,
+): internalApiResult {
+  const query = hashToQueryString({
+    vendor_credential_id: vendorCredentialId,
+    place_id: placeId,
+    session_token: sessionToken,
+  });
+
+  return new APIPromise($doGetSingle(`/lookups/address-place?${query}`, {}, options));
+}

package/src/admin-funcs/lookupsAddressValidation.ts

@@ -0,0 +1,21 @@
+import { APIPromise } from "../types/async.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { $doPost, internalApiResult } from "./doAdmin.js";
+
+export type lookupsAddressValidationRequest = {
+  vendor_credential_id: number;
+  address1: string;
+  address2?: string;
+  city?: string;
+  state?: string;
+  postal_code?: string;
+  country?: string;
+};
+
+// Checks a shipping address with Google's Address Validation API
+export function lookupsAddressValidation(
+  request: lookupsAddressValidationRequest,
+  options?: RequestOptions,
+): internalApiResult {
+  return new APIPromise($doPost("/lookups/address-validation", request, options));
+}

package/src/admin-funcs/networksCreate.ts

@@ -10,6 +10,9 @@ export type networkEthernetSettings = {
   ip_address?: string;
   netmask?: string;
   gateway_address?: string;
+  // DNS servers for a static address; the gateway needs a primary one.
+  primary_dns?: string;
+  secondary_dns?: string;
 };
 
 export type networkWifiSettings = {
@@ -23,6 +26,8 @@ export type networkWifiSettings = {
   ip_address?: string;
   netmask?: string;
   gateway_address?: string;
+  primary_dns?: string;
+  secondary_dns?: string;
 };
 
 // A file to send with the create. React Native's FormData takes this shape rather than a Blob.

package/src/admin-funcs/vendorCredentialCreateFormQuote.ts

@@ -1,12 +1,31 @@
 import { APIPromise } from "../types/async.js";
+import { RequestOptions } from "../lib/sdks.js";
 import { $doPost, internalApiResult } from "./doAdmin.js";
 
+/**
+ * Quotes the fee the given form answers incur on a credential.
+ *
+ * `useCredits` declares that the payer intends to settle the order from their credit balance
+ * before their payment method is charged. It only affects how the convenience fee is tiered --
+ * the fee pays for card processing, so it is assessed on what the card is left to cover, and an
+ * order the balance covers in full carries none. No credits are debited here, and the balance is
+ * read from the payer's own ledger rather than taken from this call.
+ *
+ * Answers with: `{ id, is_quote, tax, convenience_fee, total, success }`. The three money
+ * fields are in cents, matching what the invoice endpoints report, so the quote prices the
+ * order on its own and no follow-up fetch of the invoice is needed.
+ */
 export function vendorCredentialCreateFormQuote(
   vendorCredentialId: number,
   jsonData: string,
+  useCredits = false,
+  /** Carries the caller's AbortSignal: the form re-prices as it is filled in, so a
+   *  superseded request has to be droppable in flight. */
+  options?: RequestOptions,
 ): internalApiResult {
   return new APIPromise($doPost(
     `/vendors/credentials/${vendorCredentialId}/quote`,
-    { json_data: jsonData },
+    { json_data: jsonData, use_credits: useCredits },
+    options,
   ));
 }

package/src/admin-funcs/vendorCredentialGetFormLineItems.ts

@@ -1,12 +1,17 @@
 import { APIPromise } from "../types/async.js";
+import { RequestOptions } from "../lib/sdks.js";
 import { $doPost, internalApiResult } from "./doAdmin.js";
 
 export function vendorCredentialGetFormLineItems(
   vendorCredentialId: number,
   jsonData: string,
+  /** Carries the caller's AbortSignal: the form re-prices as it is filled in, so a
+   *  superseded request has to be droppable in flight. */
+  options?: RequestOptions,
 ): internalApiResult {
   return new APIPromise($doPost(
     `/vendors/credentials/${vendorCredentialId}/line-items`,
     { json_data: jsonData },
+    options,
   ));
 }

package/src/admin-funcs/zoneDevicesDelete.ts

@@ -0,0 +1,8 @@
+import { APIPromise } from "../types/async.js";
+import { $doDelete, internalApiResult } from "./doAdmin.js";
+
+// Removes a gateway from the Gatekeeper device details screen and revokes its AWS IoT thing.
+// Internal for the same reason as zoneDevicesCreate. 404 covers a gateway outside the caller's scope.
+export function zoneDevicesDelete(zoneDeviceId: number): internalApiResult {
+  return new APIPromise($doDelete(`/zone-devices/${zoneDeviceId}`));
+}

package/src/admin-funcs/zoneDevicesList.ts

@@ -6,6 +6,7 @@ export type zoneDevicesListSortField = "id" | "name";
 export type zoneDevicesListRequest = {
   facilityId?: number;
   zoneId?: number;
+  networkId?: number;
   page?: number;
   itemsPerPage?: number;
   sort?: zoneDevicesListSortField;
@@ -36,6 +37,9 @@ export function zoneDevicesList(
   if (request.zoneId !== undefined) {
     query["zone_id"] = request.zoneId;
   }
+  if (request.networkId !== undefined) {
+    query["network_id"] = request.networkId;
+  }
   if (request.page !== undefined) {
     query["page"] = request.page;
   }

package/src/admin-funcs/zoneDevicesProvisioning.ts

@@ -0,0 +1,12 @@
+import { APIPromise } from "../types/async.js";
+import { $doPost, internalApiResult } from "./doAdmin.js";
+
+// Everything the Gatekeeper app writes to a gateway when it provisions it over the gateway's own
+// Wi-Fi: the admin password, the AWS IoT certificate and broker, and the settings and
+// secrets of the network it joins. The first call mints the password and certificate, hence POST.
+//
+// Internal for the same reason as zoneDevicesCreate. The response carries secrets: callers keep it
+// in memory for the provisioning run and never persist or log it.
+export function zoneDevicesProvisioning(zoneDeviceId: number): internalApiResult {
+  return new APIPromise($doPost(`/zone-devices/${zoneDeviceId}/provisioning`, {}));
+}

package/src/admin-funcs/zoneDevicesUpdate.ts

@@ -0,0 +1,21 @@
+import { APIPromise } from "../types/async.js";
+import { $doPut, internalApiResult } from "./doAdmin.js";
+import type { zoneDeviceConnectionType } from "./zoneDevicesCreate.js";
+
+// Wire names, posted verbatim like zoneDevicesCreateRequest. Every field is optional: only what
+// the edit changed is sent.
+export type zoneDevicesUpdateRequest = {
+  zone_id?: number;
+  network_id?: number;
+  connection_type?: zoneDeviceConnectionType;
+  name?: string;
+};
+
+// Edits a gateway from the Gatekeeper device details screen. This only updates the record; the
+// app pushes the new network to the hardware using zoneDevicesProvisioning.
+//
+// Internal for the same reason as zoneDevicesCreate. 404 covers a gateway, zone or network outside
+// the caller's scope, and a network not linked to the zone's facility.
+export function zoneDevicesUpdate(zoneDeviceId: number, request: zoneDevicesUpdateRequest): internalApiResult {
+  return new APIPromise($doPut(`/zone-devices/${zoneDeviceId}`, request));
+}

package/src/apps/components.ts

@@ -8,6 +8,11 @@
  *
  * Styling is tokens only. There is no `style`, `className` or colour value an app can pass, and
  * every URL-shaped prop is typed so the host can refuse what the manifest did not grant.
+ *
+ * The Apps guides show screenshots of representative states and options for each component
+ * (not every contract state, such as a disabled Link, is pictured). A new component, or a change to
+ * how one looks or behaves, needs new or recaptured pictures in the same change; see
+ * .github/instructions/app-platform-ui.instructions.md.
  */
 
 import { isHttpsUrl } from "./url.js";

package/src/index.extras.ts

@@ -66,6 +66,12 @@ import { zoneDevicesList } from "./admin-funcs/zoneDevicesList.js";
 import { zoneDevicesGet } from "./admin-funcs/zoneDevicesGet.js";
 import { zoneDevicesCreate } from "./admin-funcs/zoneDevicesCreate.js";
 import { zoneDevicesMacAvailability } from "./admin-funcs/zoneDevicesMacAvailability.js";
+import { zoneDevicesUpdate } from "./admin-funcs/zoneDevicesUpdate.js";
+import { zoneDevicesProvisioning } from "./admin-funcs/zoneDevicesProvisioning.js";
+import { zoneDevicesDelete } from "./admin-funcs/zoneDevicesDelete.js";
+import { lookupsAddressValidation } from "./admin-funcs/lookupsAddressValidation.js";
+import { lookupsAddressAutocomplete } from "./admin-funcs/lookupsAddressAutocomplete.js";
+import { lookupsAddressPlace } from "./admin-funcs/lookupsAddressPlace.js";
 
 // Third-party app platform contract (surfaces, manifest, host/sandbox protocol, components).
 export * as apps from "./apps/index.js";
@@ -139,6 +145,12 @@ export const __internal = {
     dismiss: dismissCommunication
   },
 
+  lookups: {
+    validateAddress: lookupsAddressValidation,
+    autocompleteAddress: lookupsAddressAutocomplete,
+    getAddressPlace: lookupsAddressPlace
+  },
+
   // Third-party app platform host (web-mobile-client, docs/third-party-apps/plan.md C8).
   apps: {
     listInstalledApps: appsListInstalledApps,
@@ -181,6 +193,9 @@ export const __internal = {
     list: zoneDevicesList,
     get: zoneDevicesGet,
     create: zoneDevicesCreate,
+    update: zoneDevicesUpdate,
+    provisioning: zoneDevicesProvisioning,
+    delete: zoneDevicesDelete,
     macAvailability: zoneDevicesMacAvailability
   }
 };

package/src/lib/config.ts

@@ -80,8 +80,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.46.0",
-  sdkVersion: "0.47.0-beta.1",
-  genVersion: "2.943.0",
+  sdkVersion: "0.47.0-beta.10",
+  genVersion: "2.948.4",
   userAgent:
-    "speakeasy-sdk/typescript 0.47.0-beta.1 2.943.0 0.46.0 @greensecurity/javascript-sdk",
+    "speakeasy-sdk/typescript 0.47.0-beta.10 2.948.4 0.46.0 @greensecurity/javascript-sdk",
 } as const;

package/src/models/operations/createinvoice.ts

@@ -58,6 +58,10 @@ export type Five = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 export const CreateInvoiceRequestBodyInvoicesPaymentHandler = {
@@ -105,6 +109,10 @@ export type Four = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 export const CreateInvoiceRequestBodyPaymentHandler = {
@@ -152,6 +160,10 @@ export type Three = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 export const RequestBodyPaymentHandler = {
@@ -197,6 +209,10 @@ export type CreateInvoiceRequestBody2 = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 export const PaymentHandler = {
@@ -240,6 +256,10 @@ export type RequestBody1 = {
    * A campaign opt-in code, taken from the link that carried the offer Deliberately not an enumeration. The server decides which codes are live, what each one grants, and who qualifies for it. These decisions change as campaigns come and go. The server ignores an unrecognized code, or one the account does not qualify for, and creates the invoice as if the code were absent, never returning an error. The server adds any line item the code earns, and it appears on the quote.
    */
   promo?: string | undefined;
+  /**
+   * Set to `true` when the payer intends to settle this order from their credit balance before their payment method is charged. This affects only how the convenience fee is calculated: the fee pays for card processing, so it is assessed on the amount the card is left to cover once credits have been applied, and an order a balance covers in full carries none. No credits are debited here, and the balance is read from the payer's own ledger rather than taken from this request. Settle the credits with `POST /invoices/{id}/payment` and `use_credits: true`.
+   */
+  useCredits?: boolean | undefined;
 };
 
 /**
@@ -336,6 +356,7 @@ export type Five$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -350,11 +371,13 @@ export const Five$outboundSchema: z.ZodType<Five$Outbound, z.ZodTypeDef, Five> =
       CreateInvoiceRequestBodyInvoicesRequestInvoiceType$outboundSchema
         .optional(),
     promo: z.string().optional(),
+    useCredits: z.boolean().default(false),
   }).transform((v) => {
     return remap$(v, {
       vendorCredentialId: "vendor_credential_id",
       credentialPricingIds: "credential_pricing_ids",
       invoiceType: "invoice_type",
+      useCredits: "use_credits",
     });
   });
 
@@ -432,6 +455,7 @@ export type Four$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -445,11 +469,13 @@ export const Four$outboundSchema: z.ZodType<Four$Outbound, z.ZodTypeDef, Four> =
     invoiceType: CreateInvoiceRequestBodyInvoicesInvoiceType$outboundSchema
       .optional(),
     promo: z.string().optional(),
+    useCredits: z.boolean().default(false),
   }).transform((v) => {
     return remap$(v, {
       systemId: "system_id",
       credentialPricingIds: "credential_pricing_ids",
       invoiceType: "invoice_type",
+      useCredits: "use_credits",
     });
   });
 
@@ -529,6 +555,7 @@ export type Three$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -543,11 +570,13 @@ export const Three$outboundSchema: z.ZodType<
   credentialPricingIds: z.nullable(z.array(z.number().int())).optional(),
   invoiceType: CreateInvoiceRequestBodyInvoiceType$outboundSchema.optional(),
   promo: z.string().optional(),
+  useCredits: z.boolean().default(false),
 }).transform((v) => {
   return remap$(v, {
     facilityId: "facility_id",
     credentialPricingIds: "credential_pricing_ids",
     invoiceType: "invoice_type",
+    useCredits: "use_credits",
   });
 });
 
@@ -622,6 +651,7 @@ export type CreateInvoiceRequestBody2$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -635,11 +665,13 @@ export const CreateInvoiceRequestBody2$outboundSchema: z.ZodType<
   credentialPricingIds: z.nullable(z.array(z.number().int())).optional(),
   invoiceType: RequestBodyInvoiceType$outboundSchema.optional(),
   promo: z.string().optional(),
+  useCredits: z.boolean().default(false),
 }).transform((v) => {
   return remap$(v, {
     companyId: "company_id",
     credentialPricingIds: "credential_pricing_ids",
     invoiceType: "invoice_type",
+    useCredits: "use_credits",
   });
 });
 
@@ -713,6 +745,7 @@ export type RequestBody1$Outbound = {
   credential_pricing_ids?: Array<number> | null | undefined;
   invoice_type?: string | undefined;
   promo?: string | undefined;
+  use_credits: boolean;
 };
 
 /** @internal */
@@ -726,11 +759,13 @@ export const RequestBody1$outboundSchema: z.ZodType<
   credentialPricingIds: z.nullable(z.array(z.number().int())).optional(),
   invoiceType: InvoiceType$outboundSchema.optional(),
   promo: z.string().optional(),
+  useCredits: z.boolean().default(false),
 }).transform((v) => {
   return remap$(v, {
     vendorId: "vendor_id",
     credentialPricingIds: "credential_pricing_ids",
     invoiceType: "invoice_type",
+    useCredits: "use_credits",
   });
 });
 

package/src/types/smartUnion.ts

@@ -33,13 +33,13 @@ export function smartUnion<
 > {
   return z.unknown().transform((input, ctx) => {
     const candidates: Candidate[] = [];
-    const errors: z.ZodIssue[][] = options.map(() => []);
+    const errors: z.ZodIssue[][] = [];
 
     const parentUnrecognizedCtr = startCountingUnrecognized();
     const parentZeroDefaultCtr = startCountingDefaultToZeroValue();
 
     // Filter out invalid options
-    for (const [i, option] of options.entries()) {
+    for (const option of options) {
       const unrecognizedCtr = startCountingUnrecognized();
       const zeroDefaultCtr = startCountingDefaultToZeroValue();
       const result = option.safeParse(input);
@@ -54,7 +54,7 @@ export function smartUnion<
         });
         continue;
       }
-      errors[i]!.push(...result.error.issues);
+      errors.push(result.error.issues);
     }
 
     // No valid options