@shipstatic/ship 2.8.2 → 2.9.0-beta.1

package/dist/index.d.cts

@@ -326,6 +326,12 @@ interface DnsRecord {
 interface DnsProvider {
     /** Provider name (e.g., "Cloudflare", "GoDaddy"), null if unknown */
     name: string | null;
+    /**
+     * The provider's DNS dashboard, where the records get added, null where the
+     * provider is unknown or has no known console. Optional on the type by the
+     * additive-evolution law: published API versions may predate the field.
+     */
+    url?: string | null;
 }
 /**
  * Response for domain DNS provider lookup
@@ -616,7 +622,14 @@ interface Account {
     readonly name: string | null;
     /** User profile picture URL, null if not set */
     readonly picture: string | null;
-    /** The account's tier. */
+    /**
+     * The tier the account stands at. A sponsored account is Pro that nobody
+     * bills, so it reports `pro` here with {@link billed} false; the grant
+     * itself is the operator's fact, seen on the operator's surfaces and never
+     * here. A console therefore treats a sponsored account exactly as a Pro one
+     * everywhere, and the one difference it can see is the one that is real:
+     * there is no Subscription.
+     */
     readonly plan: AccountPlanType;
     /**
      * True while the operator has suspended the account: reads and deletes
@@ -666,11 +679,10 @@ interface Account {
     readonly billed: boolean;
     /**
      * The next plan up the ladder this account could move to, or `null` when
-     * there is none: the top billed tier, every granted plan, and any plan not
-     * on the menu answer `null`. One server-side fact so that no surface
-     * derives "can this account upgrade, and to what" from the menu — a
-     * grandfathered row has no menu price to compare, and a granted account
-     * must never be sent to Checkout.
+     * there is none: the top billed tier, a plan sold by conversation, and any
+     * plan not on the menu answer `null`. One server-side fact so that no surface derives "can this account
+     * upgrade, and to what" from the menu — a grandfathered row has no menu
+     * price to compare, and a conversation plan must never be sent to Checkout.
      */
     readonly upgrade: AccountPlanType | null;
     /**
@@ -877,7 +889,7 @@ declare const ErrorType: {
      * purpose, and deployed sites keep serving throughout.
      *
      * Distinct from `Api` at 503, which the platform already uses for a
-     * dependency that failed (moderation unavailable). A consumer has to tell
+     * dependency that failed. A consumer has to tell
      * "we closed the door" from "something broke": the two get opposite words
      * and opposite retry behaviour.
      */

package/dist/index.d.ts

@@ -326,6 +326,12 @@ interface DnsRecord {
 interface DnsProvider {
     /** Provider name (e.g., "Cloudflare", "GoDaddy"), null if unknown */
     name: string | null;
+    /**
+     * The provider's DNS dashboard, where the records get added, null where the
+     * provider is unknown or has no known console. Optional on the type by the
+     * additive-evolution law: published API versions may predate the field.
+     */
+    url?: string | null;
 }
 /**
  * Response for domain DNS provider lookup
@@ -616,7 +622,14 @@ interface Account {
     readonly name: string | null;
     /** User profile picture URL, null if not set */
     readonly picture: string | null;
-    /** The account's tier. */
+    /**
+     * The tier the account stands at. A sponsored account is Pro that nobody
+     * bills, so it reports `pro` here with {@link billed} false; the grant
+     * itself is the operator's fact, seen on the operator's surfaces and never
+     * here. A console therefore treats a sponsored account exactly as a Pro one
+     * everywhere, and the one difference it can see is the one that is real:
+     * there is no Subscription.
+     */
     readonly plan: AccountPlanType;
     /**
      * True while the operator has suspended the account: reads and deletes
@@ -666,11 +679,10 @@ interface Account {
     readonly billed: boolean;
     /**
      * The next plan up the ladder this account could move to, or `null` when
-     * there is none: the top billed tier, every granted plan, and any plan not
-     * on the menu answer `null`. One server-side fact so that no surface
-     * derives "can this account upgrade, and to what" from the menu — a
-     * grandfathered row has no menu price to compare, and a granted account
-     * must never be sent to Checkout.
+     * there is none: the top billed tier, a plan sold by conversation, and any
+     * plan not on the menu answer `null`. One server-side fact so that no surface derives "can this account
+     * upgrade, and to what" from the menu — a grandfathered row has no menu
+     * price to compare, and a conversation plan must never be sent to Checkout.
      */
     readonly upgrade: AccountPlanType | null;
     /**
@@ -877,7 +889,7 @@ declare const ErrorType: {
      * purpose, and deployed sites keep serving throughout.
      *
      * Distinct from `Api` at 503, which the platform already uses for a
-     * dependency that failed (moderation unavailable). A consumer has to tell
+     * dependency that failed. A consumer has to tell
      * "we closed the door" from "something broke": the two get opposite words
      * and opposite retry behaviour.
      */