@pantechdynamic/sdk 0.1.0 → 0.2.0

package/dist/index.js

@@ -86,6 +86,18 @@ var OrderFailedError = class extends PantechError {
     this.order = order;
   }
 };
+var CloudFailedError = class extends PantechError {
+  name = "CloudFailedError";
+  /** `connection` or `scan`. */
+  kind;
+  /** The failed connection or scan, as the API returned it. */
+  resource;
+  constructor(message, kind, resource, init = {}) {
+    super(message, init);
+    this.kind = kind;
+    this.resource = resource;
+  }
+};
 var WaitTimeoutError = class extends PantechError {
   name = "WaitTimeoutError";
 };
@@ -773,6 +785,136 @@ var MeResource = class extends APIResource {
   }
 };
 
+// src/resources/migrate.ts
+var CONNECTION_WAIT_MS = 10 * 6e4;
+var SCAN_WAIT_MS = 30 * 6e4;
+function cloudFailed(kind, id, failure, resource) {
+  const detail = failure?.message ?? `The ${kind} failed.`;
+  const code = failure?.code;
+  return new CloudFailedError(
+    code ? `Cloud ${kind} ${id} failed: ${detail} (${code})` : `Cloud ${kind} ${id} failed: ${detail}`,
+    kind,
+    resource,
+    { code, detail }
+  );
+}
+var Migrate = class extends APIResource {
+  /** Connections to AWS accounts through a read-only role only Pantech can assume. */
+  connections = new CloudConnections(this._client);
+  /** Reads of everything a connection's role can see. */
+  scans = new CloudScans(this._client);
+  /** Plans to move what a scan found to Pantech. Nothing is created until you apply the Terraform. */
+  migrations = new Migrations(this._client);
+};
+var CloudConnections = class extends APIResource {
+  list(params = {}, options) {
+    return this._get("/cloud-connections", params, options);
+  }
+  listAll(params = {}, options) {
+    return this._listAll("/cloud-connections", params, options);
+  }
+  /**
+   * Starts a connection. Its `setup` holds the CloudFormation template (and,
+   * when offered, a one-click `quick_create_url`) that creates the read-only
+   * role in your AWS account; send the stack's `RoleArn` output with `update`.
+   */
+  create(body, options) {
+    return this._post("/cloud-connections", body, options);
+  }
+  get(connectionId, options) {
+    return this._get(path`/cloud-connections/${connectionId}`, void 0, options);
+  }
+  /** Renames the connection, sets its `role_arn`, or retries a failed check (`retry: true`). */
+  update(connectionId, body, options) {
+    return this._patch(path`/cloud-connections/${connectionId}`, body, options);
+  }
+  /** Removes the connection and its scans; plans made from it stay. Delete the stack in AWS to revoke the role there. */
+  delete(connectionId, options) {
+    return this._delete(path`/cloud-connections/${connectionId}`, options);
+  }
+  /**
+   * Polls the connection until it is `connected` (resolves with it) or its
+   * check fails (rejects with CloudFailedError). Set the role ARN with
+   * `update` first. Default timeout 10 minutes, polling every 5 seconds.
+   */
+  wait(connectionId, options = {}) {
+    return poll(
+      () => this.get(connectionId, { signal: options.signal }),
+      (c) => {
+        if (c.status === "failed") throw cloudFailed("connection", c.id, c.failure, c);
+        return c.status === "connected";
+      },
+      `Cloud connection ${connectionId}`,
+      { timeoutMs: CONNECTION_WAIT_MS, pollIntervalMs: 5e3, ...options }
+    );
+  }
+};
+var CloudScans = class extends APIResource {
+  /** A connection's scans, newest first, without their inventories. */
+  list(connectionId, params = {}, options) {
+    return this._get(path`/cloud-connections/${connectionId}/scans`, params, options);
+  }
+  listAll(connectionId, params = {}, options) {
+    return this._listAll(path`/cloud-connections/${connectionId}/scans`, params, options);
+  }
+  /** Queues a scan of a connected account. Follow it with `wait`. */
+  start(connectionId, options) {
+    return this._post(path`/cloud-connections/${connectionId}/scans`, void 0, options);
+  }
+  /** A scan's status and counts. Pass `{ include: "inventory" }` for everything it found. */
+  get(scanId, params = {}, options) {
+    return this._get(path`/cloud-scans/${scanId}`, params, options);
+  }
+  /**
+   * Polls the scan until it `succeeded` (resolves with it, without its
+   * inventory) or failed (rejects with CloudFailedError). Default timeout 30
+   * minutes, polling every 10 seconds.
+   */
+  wait(scanId, options = {}) {
+    return poll(
+      () => this.get(scanId, {}, { signal: options.signal }),
+      (s) => {
+        if (s.status === "failed") throw cloudFailed("scan", s.id, s.failure, s);
+        return s.status === "succeeded";
+      },
+      `Cloud scan ${scanId}`,
+      { timeoutMs: SCAN_WAIT_MS, pollIntervalMs: 1e4, ...options }
+    );
+  }
+};
+var Migrations = class extends APIResource {
+  /** Your migration plans, newest first, without their items or estimate. */
+  list(params = {}, options) {
+    return this._get("/migrations", params, options);
+  }
+  listAll(params = {}, options) {
+    return this._listAll("/migrations", params, options);
+  }
+  /** Builds a plan, with a price comparison, from a scan that succeeded. Nothing is created on Pantech. */
+  create(body, options) {
+    return this._post("/migrations", body, options);
+  }
+  /** A plan with every item, and a price comparison computed now. */
+  get(migrationId, options) {
+    return this._get(path`/migrations/${migrationId}`, void 0, options);
+  }
+  rename(migrationId, body, options) {
+    return this._patch(path`/migrations/${migrationId}`, body, options);
+  }
+  /** Deletes the plan. Nothing on Pantech or in the other cloud is touched. */
+  delete(migrationId, options) {
+    return this._delete(path`/migrations/${migrationId}`, options);
+  }
+  /** Changes one item, named by its `key`: exclude it, or change its plan, size, range, role or email. */
+  updateItem(migrationId, body, options) {
+    return this._patch(path`/migrations/${migrationId}/items`, body, options);
+  }
+  /** The plan's planned items as Terraform: `main.tf` and `variables.tf`. */
+  exportTerraform(migrationId, options) {
+    return this._get(path`/migrations/${migrationId}/terraform`, void 0, options);
+  }
+};
+
 // src/resources/networks.ts
 var Networks = class extends APIResource {
   /** A network's subnets: `client.networks.subnets.list(networkId)`. */
@@ -1183,7 +1325,7 @@ var WebhookDeliveries = class extends APIResource {
 };
 
 // src/version.ts
-var VERSION = "0.1.0";
+var VERSION = "0.2.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.pantechdynamics.com/public/v1";
@@ -1228,6 +1370,8 @@ var Pantech = class {
   databaseOrders;
   sshKeys;
   webhooks;
+  /** Move from another cloud: connections, scans and migration plans. */
+  migrate;
   operations;
   constructor(options = {}) {
     const apiKey = options.apiKey ?? readEnv("PANTECH_API_KEY");
@@ -1269,6 +1413,7 @@ var Pantech = class {
     this.databaseOrders = new DatabaseOrders(this);
     this.sshKeys = new SshKeys(this);
     this.webhooks = new Webhooks(this);
+    this.migrate = new Migrate(this);
   }
   /**
    * Sends one request and returns its decoded body (undefined for an empty
@@ -1484,6 +1629,6 @@ async function signWebhook(options) {
   return `t=${t},v1=${await hmacHex(options.secret, t, bytes(options.body))}`;
 }
 
-export { APIConnectionError, APITimeoutError, AuthenticationError, BadRequestError, ConflictError, DEFAULT_BASE_URL, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, InternalServerError, NotFoundError, OperationFailedError, OrderFailedError, Pantech, PantechError, PaymentRequiredError, PermissionDeniedError, RateLimitError, VERSION, ValidationError, WEBHOOK_SIGNATURE_HEADER, WaitTimeoutError, WebhookVerificationError, isPantechError, paginate, signWebhook, verifyWebhook };
+export { APIConnectionError, APITimeoutError, AuthenticationError, BadRequestError, CloudFailedError, ConflictError, DEFAULT_BASE_URL, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, InternalServerError, NotFoundError, OperationFailedError, OrderFailedError, Pantech, PantechError, PaymentRequiredError, PermissionDeniedError, RateLimitError, VERSION, ValidationError, WEBHOOK_SIGNATURE_HEADER, WaitTimeoutError, WebhookVerificationError, isPantechError, paginate, signWebhook, verifyWebhook };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map