@greensecurity/javascript-sdk 0.46.0-beta.8 → 0.46.0-beta.9

package/src/models/components/deviceauthorizationrequest.ts

@@ -0,0 +1,86 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { ClosedEnum } from "../../types/enums.js";
+
+/**
+ * The client starting the flow. `greensecurity-apps-cli` is the only registered client; any other value is `401` `invalid_client`.
+ */
+export const ClientId = {
+  GreensecurityAppsCli: "greensecurity-apps-cli",
+} as const;
+/**
+ * The client starting the flow. `greensecurity-apps-cli` is the only registered client; any other value is `401` `invalid_client`.
+ */
+export type ClientId = ClosedEnum<typeof ClientId>;
+
+/**
+ * Optional. `apps:develop` is the only scope, and the default when this is left out.
+ *
+ * @remarks
+ * Any other value is `400` `invalid_scope`.
+ */
+export const Scope = {
+  AppsDevelop: "apps:develop",
+} as const;
+/**
+ * Optional. `apps:develop` is the only scope, and the default when this is left out.
+ *
+ * @remarks
+ * Any other value is `400` `invalid_scope`.
+ */
+export type Scope = ClosedEnum<typeof Scope>;
+
+export type DeviceAuthorizationRequest = {
+  /**
+   * The client starting the flow. `greensecurity-apps-cli` is the only registered client; any other value is `401` `invalid_client`.
+   */
+  clientId: ClientId;
+  /**
+   * Optional. `apps:develop` is the only scope, and the default when this is left out.
+   *
+   * @remarks
+   * Any other value is `400` `invalid_scope`.
+   */
+  scope?: Scope | undefined;
+};
+
+/** @internal */
+export const ClientId$outboundSchema: z.ZodNativeEnum<typeof ClientId> = z
+  .nativeEnum(ClientId);
+
+/** @internal */
+export const Scope$outboundSchema: z.ZodNativeEnum<typeof Scope> = z.nativeEnum(
+  Scope,
+);
+
+/** @internal */
+export type DeviceAuthorizationRequest$Outbound = {
+  client_id: string;
+  scope?: string | undefined;
+};
+
+/** @internal */
+export const DeviceAuthorizationRequest$outboundSchema: z.ZodType<
+  DeviceAuthorizationRequest$Outbound,
+  z.ZodTypeDef,
+  DeviceAuthorizationRequest
+> = z.object({
+  clientId: ClientId$outboundSchema,
+  scope: Scope$outboundSchema.optional(),
+}).transform((v) => {
+  return remap$(v, {
+    clientId: "client_id",
+  });
+});
+
+export function deviceAuthorizationRequestToJSON(
+  deviceAuthorizationRequest: DeviceAuthorizationRequest,
+): string {
+  return JSON.stringify(
+    DeviceAuthorizationRequest$outboundSchema.parse(deviceAuthorizationRequest),
+  );
+}

package/src/models/components/deviceauthorizationresponse.ts

@@ -0,0 +1,72 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * RFC 8628 section 3.2.
+ */
+export type DeviceAuthorizationResponse = {
+  /**
+   * A secret the CLI polls `POST /oauth/token` with. Never show it to the user.
+   */
+  deviceCode: string;
+  /**
+   * The short code the user confirms on the approval screen.
+   */
+  userCode: string;
+  /**
+   * The approval screen, where the user enters `user_code` while signed in.
+   */
+  verificationUri: string;
+  /**
+   * `verification_uri` with `user_code` already filled in. Open it in a browser, or render it as a QR code.
+   */
+  verificationUriComplete: string;
+  /**
+   * Seconds until `device_code` and `user_code` expire.
+   */
+  expiresIn: number;
+  /**
+   * The minimum number of seconds to wait between polls of `POST /oauth/token`.
+   */
+  interval: number;
+};
+
+/** @internal */
+export const DeviceAuthorizationResponse$inboundSchema: z.ZodType<
+  DeviceAuthorizationResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  device_code: types.string(),
+  user_code: types.string(),
+  verification_uri: types.string(),
+  verification_uri_complete: types.string(),
+  expires_in: types.number(),
+  interval: types.number(),
+}).transform((v) => {
+  return remap$(v, {
+    "device_code": "deviceCode",
+    "user_code": "userCode",
+    "verification_uri": "verificationUri",
+    "verification_uri_complete": "verificationUriComplete",
+    "expires_in": "expiresIn",
+  });
+});
+
+export function deviceAuthorizationResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<DeviceAuthorizationResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DeviceAuthorizationResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DeviceAuthorizationResponse' from JSON`,
+  );
+}

package/src/models/components/devsession.ts

@@ -0,0 +1,111 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  AppDevManifest,
+  AppDevManifest$inboundSchema,
+} from "./appdevmanifest.js";
+import { EcPublicJwk, EcPublicJwk$inboundSchema } from "./ecpublicjwk.js";
+
+/**
+ * A registered dev session: the host shows the developer's local build instead of the
+ *
+ * @remarks
+ * published bundle, to that developer only. It lasts 12 hours, and counts as inactive
+ * after 2 minutes without a heartbeat.
+ */
+export type DevSession = {
+  /**
+   * The session's public id, used in preview links. URL-safe, at most 64 characters.
+   */
+  id: string;
+  appId: number;
+  activationId: number;
+  developerUserId: number;
+  /**
+   * When the session expires, in milliseconds since the Unix epoch.
+   */
+  expiresAt: number;
+  origin: string;
+  /**
+   * An ECDSA P-256 public key as a JWK (RFC 7517), as `crypto.subtle.exportKey("jwk", …)`
+   *
+   * @remarks
+   * returns it for the public half of the key pair. Only the members listed here are
+   * accepted: a key with any other member, including a private one such as `d`, is refused
+   * with `422`, as is a point that is not on the P-256 curve. The session stores, and returns,
+   * only `kty`, `crv`, `x` and `y`.
+   */
+  publicKeyJwk: EcPublicJwk;
+  /**
+   * The manifest a dev session runs: `green-app.json` with `green-app.dev.json` merged over
+   *
+   * @remarks
+   * it. It must satisfy the `AppManifest` schema, with one view per viewport and the
+   * 4096-character CSP budget, except that CSP sources may also be local http origins or
+   * paths under the session's `origin`. `id` must be the app in the path, and the whole
+   * manifest is at most 128 KB as JSON.
+   *
+   * A dev session previews `ui_extensions.views`, `ui_extensions.csp` and `constants`.
+   * Everything else must match the app as it is published:
+   *
+   * - `permissions`, `post_install_action`, `ui_extensions.bundle` and
+   *   `ui_extensions.routes` must equal the published values. An app that has published
+   *   none may not declare any. For `post_install_action`, send exactly what you
+   *   published, or leave it out if you left it out there. `permissions` may be listed in
+   *   any order, but `routes` must be in the published order.
+   * - `name`, `icon`, `short_description`, `configuration_instructions`,
+   *   `support_instructions` and `version` must equal the published values once the app
+   *   has published a manifest with a `version`. Until then a dev session may use its own.
+   *
+   * Any of these failures is a `422` whose `error` names each field that differs, for
+   * example ``Invalid manifest: permissions cannot differ from the published manifest in a
+   * dev session (added: vendors.update; removed: vendors.view; purpose changed:
+   * facilities.view); publish it with `gs-apps upload` first``. For `permissions`, the
+   * message lists the permissions you added, the ones you removed, and the ones whose
+   * `purpose` changed. The response's `errors` lists the same messages one by one (see
+   * `DevSessionErrorResponse`). Publish the change with `gs-apps upload` first.
+   */
+  manifest: AppDevManifest;
+};
+
+/** @internal */
+export const DevSession$inboundSchema: z.ZodType<
+  DevSession,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: types.string(),
+  app_id: types.number(),
+  activation_id: types.number(),
+  developer_user_id: types.number(),
+  expires_at: types.number(),
+  origin: types.string(),
+  public_key_jwk: EcPublicJwk$inboundSchema,
+  manifest: AppDevManifest$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "app_id": "appId",
+    "activation_id": "activationId",
+    "developer_user_id": "developerUserId",
+    "expires_at": "expiresAt",
+    "public_key_jwk": "publicKeyJwk",
+  });
+});
+
+export function devSessionFromJSON(
+  jsonString: string,
+): SafeParseResult<DevSession, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => DevSession$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'DevSession' from JSON`,
+  );
+}

package/src/models/components/devsessioncreate.ts

@@ -0,0 +1,126 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import {
+  AppDevManifest,
+  AppDevManifest$Outbound,
+  AppDevManifest$outboundSchema,
+} from "./appdevmanifest.js";
+import {
+  EcPublicJwk,
+  EcPublicJwk$Outbound,
+  EcPublicJwk$outboundSchema,
+} from "./ecpublicjwk.js";
+
+export type DevSessionCreate = {
+  /**
+   * The manifest a dev session runs: `green-app.json` with `green-app.dev.json` merged over
+   *
+   * @remarks
+   * it. It must satisfy the `AppManifest` schema, with one view per viewport and the
+   * 4096-character CSP budget, except that CSP sources may also be local http origins or
+   * paths under the session's `origin`. `id` must be the app in the path, and the whole
+   * manifest is at most 128 KB as JSON.
+   *
+   * A dev session previews `ui_extensions.views`, `ui_extensions.csp` and `constants`.
+   * Everything else must match the app as it is published:
+   *
+   * - `permissions`, `post_install_action`, `ui_extensions.bundle` and
+   *   `ui_extensions.routes` must equal the published values. An app that has published
+   *   none may not declare any. For `post_install_action`, send exactly what you
+   *   published, or leave it out if you left it out there. `permissions` may be listed in
+   *   any order, but `routes` must be in the published order.
+   * - `name`, `icon`, `short_description`, `configuration_instructions`,
+   *   `support_instructions` and `version` must equal the published values once the app
+   *   has published a manifest with a `version`. Until then a dev session may use its own.
+   *
+   * Any of these failures is a `422` whose `error` names each field that differs, for
+   * example ``Invalid manifest: permissions cannot differ from the published manifest in a
+   * dev session (added: vendors.update; removed: vendors.view; purpose changed:
+   * facilities.view); publish it with `gs-apps upload` first``. For `permissions`, the
+   * message lists the permissions you added, the ones you removed, and the ones whose
+   * `purpose` changed. The response's `errors` lists the same messages one by one (see
+   * `DevSessionErrorResponse`). Publish the change with `gs-apps upload` first.
+   */
+  manifest: AppDevManifest;
+  /**
+   * Origin of the CLI's dev server: a scheme, a host and a port, with no path, query,
+   *
+   * @remarks
+   * credentials or trailing slash.
+   *
+   * - `http://` only to `localhost`, `127.0.0.1`, the Android emulator's `10.0.2.2` or a
+   *   private RFC 1918 address (`10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`), and
+   *   always with an explicit port (1-65535, no leading zeros).
+   * - `https://` to a DNS name written in lowercase, such as a tunnel, with an optional
+   *   port. An IP address is refused: the last label must be letters, or an IDN
+   *   `xn--` label.
+   */
+  origin: string;
+  /**
+   * A random capability token the dev server requires as `Authorization: Bearer` on every
+   *
+   * @remarks
+   * route: 32 to 512 base64url or base64 characters. Only the host of the developer who
+   * owns the session receives it. It is encrypted at rest and never logged, and a token
+   * already used by any session is refused with `409`, so generate a new one each time.
+   */
+  serverToken: string;
+  /**
+   * An ECDSA P-256 public key as a JWK (RFC 7517), as `crypto.subtle.exportKey("jwk", …)`
+   *
+   * @remarks
+   * returns it for the public half of the key pair. Only the members listed here are
+   * accepted: a key with any other member, including a private one such as `d`, is refused
+   * with `422`, as is a point that is not on the P-256 curve. The session stores, and returns,
+   * only `kty`, `crv`, `x` and `y`.
+   */
+  publicKeyJwk: EcPublicJwk;
+  /**
+   * The activation to preview under. It must be an installation of this app that covers
+   *
+   * @remarks
+   * you (`403` otherwise). Optional when exactly one does; when several do and it is
+   * left out, the request is refused with `422`.
+   */
+  activationId?: number | undefined;
+};
+
+/** @internal */
+export type DevSessionCreate$Outbound = {
+  manifest: AppDevManifest$Outbound;
+  origin: string;
+  server_token: string;
+  public_key_jwk: EcPublicJwk$Outbound;
+  activation_id?: number | undefined;
+};
+
+/** @internal */
+export const DevSessionCreate$outboundSchema: z.ZodType<
+  DevSessionCreate$Outbound,
+  z.ZodTypeDef,
+  DevSessionCreate
+> = z.object({
+  manifest: AppDevManifest$outboundSchema,
+  origin: z.string(),
+  serverToken: z.string(),
+  publicKeyJwk: EcPublicJwk$outboundSchema,
+  activationId: z.number().int().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    serverToken: "server_token",
+    publicKeyJwk: "public_key_jwk",
+    activationId: "activation_id",
+  });
+});
+
+export function devSessionCreateToJSON(
+  devSessionCreate: DevSessionCreate,
+): string {
+  return JSON.stringify(
+    DevSessionCreate$outboundSchema.parse(devSessionCreate),
+  );
+}

package/src/models/components/ecpublicjwk.ts

@@ -0,0 +1,140 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * If present, must be `ES256`.
+ */
+export const Alg = {
+  Es256: "ES256",
+} as const;
+/**
+ * If present, must be `ES256`.
+ */
+export type Alg = ClosedEnum<typeof Alg>;
+
+export const KeyOps = {
+  Verify: "verify",
+} as const;
+export type KeyOps = ClosedEnum<typeof KeyOps>;
+
+/**
+ * An ECDSA P-256 public key as a JWK (RFC 7517), as `crypto.subtle.exportKey("jwk", …)`
+ *
+ * @remarks
+ * returns it for the public half of the key pair. Only the members listed here are
+ * accepted: a key with any other member, including a private one such as `d`, is refused
+ * with `422`, as is a point that is not on the P-256 curve. The session stores, and returns,
+ * only `kty`, `crv`, `x` and `y`.
+ */
+export type EcPublicJwk = {
+  kty: "EC";
+  crv: "P-256";
+  /**
+   * The x coordinate, 32 bytes as unpadded base64url.
+   */
+  x: string;
+  /**
+   * The y coordinate, 32 bytes as unpadded base64url.
+   */
+  y: string;
+  /**
+   * If present, must be `ES256`.
+   */
+  alg?: Alg | undefined;
+  /**
+   * If present, may only contain `verify`.
+   */
+  keyOps?: Array<KeyOps> | undefined;
+  ext?: boolean | undefined;
+  kid?: string | undefined;
+  use?: string | undefined;
+};
+
+/** @internal */
+export const Alg$inboundSchema: z.ZodNativeEnum<typeof Alg> = z.nativeEnum(Alg);
+/** @internal */
+export const Alg$outboundSchema: z.ZodNativeEnum<typeof Alg> =
+  Alg$inboundSchema;
+
+/** @internal */
+export const KeyOps$inboundSchema: z.ZodNativeEnum<typeof KeyOps> = z
+  .nativeEnum(KeyOps);
+/** @internal */
+export const KeyOps$outboundSchema: z.ZodNativeEnum<typeof KeyOps> =
+  KeyOps$inboundSchema;
+
+/** @internal */
+export const EcPublicJwk$inboundSchema: z.ZodType<
+  EcPublicJwk,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  kty: types.literal("EC"),
+  crv: types.literal("P-256"),
+  x: types.string(),
+  y: types.string(),
+  alg: types.optional(Alg$inboundSchema),
+  key_ops: types.optional(z.array(KeyOps$inboundSchema)),
+  ext: types.optional(types.boolean()),
+  kid: types.optional(types.string()),
+  use: types.optional(types.string()),
+}).transform((v) => {
+  return remap$(v, {
+    "key_ops": "keyOps",
+  });
+});
+/** @internal */
+export type EcPublicJwk$Outbound = {
+  kty: "EC";
+  crv: "P-256";
+  x: string;
+  y: string;
+  alg?: string | undefined;
+  key_ops?: Array<string> | undefined;
+  ext?: boolean | undefined;
+  kid?: string | undefined;
+  use?: string | undefined;
+};
+
+/** @internal */
+export const EcPublicJwk$outboundSchema: z.ZodType<
+  EcPublicJwk$Outbound,
+  z.ZodTypeDef,
+  EcPublicJwk
+> = z.object({
+  kty: z.literal("EC"),
+  crv: z.literal("P-256"),
+  x: z.string(),
+  y: z.string(),
+  alg: Alg$outboundSchema.optional(),
+  keyOps: z.array(KeyOps$outboundSchema).optional(),
+  ext: z.boolean().optional(),
+  kid: z.string().optional(),
+  use: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    keyOps: "key_ops",
+  });
+});
+
+export function ecPublicJwkToJSON(ecPublicJwk: EcPublicJwk): string {
+  return JSON.stringify(EcPublicJwk$outboundSchema.parse(ecPublicJwk));
+}
+export function ecPublicJwkFromJSON(
+  jsonString: string,
+): SafeParseResult<EcPublicJwk, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => EcPublicJwk$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'EcPublicJwk' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -4,7 +4,38 @@
 
 export * from "./activestatus.js";
 export * from "./alert.js";
+export * from "./appbundle.js";
+export * from "./appconstantvalue.js";
+export * from "./appcsp.js";
+export * from "./appdevcsp.js";
+export * from "./appdeveloper.js";
+export * from "./appdeveloperadd.js";
+export * from "./appdeveloperaddbyemail.js";
+export * from "./appdeveloperaddbyuserid.js";
+export * from "./appdeveloperrole.js";
+export * from "./appdevmanifest.js";
+export * from "./appdevuiextensions.js";
+export * from "./appmanifest.js";
+export * from "./appmanifestid.js";
+export * from "./appmanifestpermission.js";
 export * from "./appointmentsummary.js";
+export * from "./apppostinstallaction.js";
+export * from "./appreviewreason.js";
+export * from "./approute.js";
+export * from "./appsecret.js";
+export * from "./appsecretdeleted.js";
+export * from "./appsecretdeleterequest.js";
+export * from "./appsecretinstallationscope.js";
+export * from "./appsecretscope.js";
+export * from "./appsecretsetrequest.js";
+export * from "./appsecretuserscope.js";
+export * from "./apptokenkind.js";
+export * from "./appuiextensions.js";
+export * from "./appversioninstalls.js";
+export * from "./appview.js";
+export * from "./appviewport.js";
+export * from "./appwebhookendpointsecret.js";
+export * from "./appwebhooks.js";
 export * from "./authenticatesuccessresponse.js";
 export * from "./backgroundcheckresult.js";
 export * from "./company.js";
@@ -30,11 +61,16 @@ export * from "./department.js";
 export * from "./departmentmembership.js";
 export * from "./departmentsummary.js";
 export * from "./desc.js";
+export * from "./deviceauthorizationrequest.js";
+export * from "./deviceauthorizationresponse.js";
 export * from "./devicecountpair.js";
 export * from "./devicecounts.js";
+export * from "./devsession.js";
+export * from "./devsessioncreate.js";
 export * from "./distributor.js";
 export * from "./distributorcreate.js";
 export * from "./distributorupdate.js";
+export * from "./ecpublicjwk.js";
 export * from "./emailpreferences.js";
 export * from "./event.js";
 export * from "./expand.js";
@@ -61,6 +97,9 @@ export * from "./loginrequirementsfromemail.js";
 export * from "./manufacturer.js";
 export * from "./manufacturercreate.js";
 export * from "./manufacturerupdate.js";
+export * from "./marketplaceappactivation.js";
+export * from "./marketplaceappactivationcoverage.js";
+export * from "./marketplaceappactivationevent.js";
 export * from "./medicalproduct.js";
 export * from "./medicalproductcategory.js";
 export * from "./medicalproductcategorycreate.js";
@@ -77,6 +116,14 @@ export * from "./medicalproductspec.js";
 export * from "./medicalproductspecinput.js";
 export * from "./medicalproductupdate.js";
 export * from "./mfarequiredresponse.js";
+export * from "./oauthclientcredentialsgrant.js";
+export * from "./oauthclirefreshtokengrant.js";
+export * from "./oauthdevicecodegrant.js";
+export * from "./oautherrorcode.js";
+export * from "./oauthrefreshtokengrant.js";
+export * from "./oauthtokenexchangegrant.js";
+export * from "./oauthtokenrequest.js";
+export * from "./oauthtokentypehint.js";
 export * from "./pager.js";
 export * from "./passwordnotsetresponse.js";
 export * from "./passwordrequiredresponse.js";
@@ -99,6 +146,10 @@ export * from "./supportarticle.js";
 export * from "./system.js";
 export * from "./systemsummary.js";
 export * from "./targetfacilitystatuschange.js";
+export * from "./tokenintrospection.js";
+export * from "./tokenintrospectionrequest.js";
+export * from "./tokenresponse.js";
+export * from "./tokenrevocationrequest.js";
 export * from "./uploadhistoryitem.js";
 export * from "./user.js";
 export * from "./userdetails.js";

package/src/models/components/marketplaceappactivation.ts

@@ -0,0 +1,71 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  MarketplaceAppActivationCoverage,
+  MarketplaceAppActivationCoverage$inboundSchema,
+} from "./marketplaceappactivationcoverage.js";
+
+/**
+ * One installation of your app. Its `id` is the `activation_id` your backend passes to
+ *
+ * @remarks
+ * `POST /oauth/token` with `grant_type=client_credentials` to get an installation token
+ * narrowed to it.
+ */
+export type MarketplaceAppActivation = {
+  /**
+   * The activation id.
+   */
+  id: number;
+  /**
+   * The app that was installed.
+   */
+  marketplaceAppId: number;
+  /**
+   * What one activation of your app covers: the site, health system, facility, company or
+   *
+   * @remarks
+   * user it was installed for. An install is made at one of these, so one id is set and the
+   * others are null. A site install covers everything in the site, and a health system
+   * install covers its facilities.
+   */
+  coverage: MarketplaceAppActivationCoverage;
+  /**
+   * When the app was installed. Null for installations made before this was recorded.
+   */
+  created: Date | null;
+};
+
+/** @internal */
+export const MarketplaceAppActivation$inboundSchema: z.ZodType<
+  MarketplaceAppActivation,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: types.number(),
+  marketplace_app_id: types.number(),
+  coverage: MarketplaceAppActivationCoverage$inboundSchema,
+  created: types.nullable(types.date()),
+}).transform((v) => {
+  return remap$(v, {
+    "marketplace_app_id": "marketplaceAppId",
+  });
+});
+
+export function marketplaceAppActivationFromJSON(
+  jsonString: string,
+): SafeParseResult<MarketplaceAppActivation, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MarketplaceAppActivation$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MarketplaceAppActivation' from JSON`,
+  );
+}