@shipstatic/types 2.21.2 → 2.22.0-beta.2

package/dist/index.d.ts

@@ -326,6 +326,12 @@ export interface DnsRecord {
 export 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 @@ export 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 @@ export 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;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipstatic/types",
-  "version": "2.21.2",
+  "version": "2.22.0-beta.2",
   "description": "Shared TypeScript types for the ShipStatic platform.",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -354,6 +354,12 @@ export interface DnsRecord {
 export 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;
 }
 
 /**
@@ -691,7 +697,14 @@ export 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
@@ -741,11 +754,10 @@ export 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;
   /**