@shipstatic/types 2.26.0-beta.3 → 2.26.0-beta.4

package/dist/index.d.ts

@@ -489,17 +489,14 @@ export interface DomainValidateResponse {
      * It answers "would creating this be new", not "would a write succeed": `PUT
      * /domains/:domain` is an upsert, which is how a domain is re-pointed, so a
      * caller's OWN domain is unavailable here and writable there. Availability
-     * does not depend on the kind of name; a custom domain answered `true`
-     * whoever owned it until 2026-09-17.
+     * does not depend on the kind of name.
      */
     available: boolean | null;
     /**
-     * Why the name is unusable, null when it IS usable — displayed verbatim.
-     *
-     * A name is unusable when it is invalid OR unavailable, and both carry a
-     * reason. This said "null when valid" until 2026-09-17, which was already
-     * untrue of the endpoint it described: a registered name is valid, is
-     * unusable, and had no reason at all, which is why every client invented one.
+     * Why the name is unusable, displayed verbatim; null exactly when it IS
+     * usable. A name is unusable when it is invalid OR unavailable, and both
+     * carry a reason, so a client reads this field alone for the verdict and
+     * invents no copy of its own.
      */
     reason: string | null;
 }
@@ -1840,6 +1837,15 @@ export declare function formatDuration(seconds: number): string;
  * why that case is `null` rather than a sentence.
  */
 export declare function formatTimeRemaining(expires: number, now?: number): string | null;
+/**
+ * A byte count as a person reads it: `"180 KB"`, `"2.5 MB"`, `"0 Bytes"`.
+ *
+ * Binary units, one decimal by default, and `decimals` for a surface with its
+ * own density (a dense table reads `"3 MB"` at 0). A deployment's size reads
+ * this way on every surface that states one: the console, the CLI, the deploy
+ * card and the API's own refusals, so one deployment is one number everywhere.
+ */
+export declare function formatFileSize(bytes: number, decimals?: number): string;
 /**
  * Universal deploy input — the union of every shape the SDK accepts.
  *

package/dist/index.js

@@ -1776,6 +1776,25 @@ function countOf(count, unit) {
     return `${count} ${unit}${count === 1 ? '' : 's'}`;
 }
 // =============================================================================
+// FILE SIZE
+// =============================================================================
+/**
+ * A byte count as a person reads it: `"180 KB"`, `"2.5 MB"`, `"0 Bytes"`.
+ *
+ * Binary units, one decimal by default, and `decimals` for a surface with its
+ * own density (a dense table reads `"3 MB"` at 0). A deployment's size reads
+ * this way on every surface that states one: the console, the CLI, the deploy
+ * card and the API's own refusals, so one deployment is one number everywhere.
+ */
+export function formatFileSize(bytes, decimals = 1) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${Number.parseFloat((bytes / k ** i).toFixed(decimals))} ${sizes[i]}`;
+}
+// =============================================================================
 // FILE UPLOAD TYPES
 // =============================================================================
 /**

package/package.json

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

package/src/index.ts

@@ -548,17 +548,14 @@ export interface DomainValidateResponse {
    * It answers "would creating this be new", not "would a write succeed": `PUT
    * /domains/:domain` is an upsert, which is how a domain is re-pointed, so a
    * caller's OWN domain is unavailable here and writable there. Availability
-   * does not depend on the kind of name; a custom domain answered `true`
-   * whoever owned it until 2026-09-17.
+   * does not depend on the kind of name.
    */
   available: boolean | null;
   /**
-   * Why the name is unusable, null when it IS usable — displayed verbatim.
-   *
-   * A name is unusable when it is invalid OR unavailable, and both carry a
-   * reason. This said "null when valid" until 2026-09-17, which was already
-   * untrue of the endpoint it described: a registered name is valid, is
-   * unusable, and had no reason at all, which is why every client invented one.
+   * Why the name is unusable, displayed verbatim; null exactly when it IS
+   * usable. A name is unusable when it is invalid OR unavailable, and both
+   * carry a reason, so a client reads this field alone for the verdict and
+   * invents no copy of its own.
    */
   reason: string | null;
 }
@@ -2716,6 +2713,26 @@ function countOf(count: number, unit: string): string {
   return `${count} ${unit}${count === 1 ? '' : 's'}`;
 }
 
+// =============================================================================
+// FILE SIZE
+// =============================================================================
+
+/**
+ * A byte count as a person reads it: `"180 KB"`, `"2.5 MB"`, `"0 Bytes"`.
+ *
+ * Binary units, one decimal by default, and `decimals` for a surface with its
+ * own density (a dense table reads `"3 MB"` at 0). A deployment's size reads
+ * this way on every surface that states one: the console, the CLI, the deploy
+ * card and the API's own refusals, so one deployment is one number everywhere.
+ */
+export function formatFileSize(bytes: number, decimals: number = 1): string {
+  if (bytes === 0) return '0 Bytes';
+  const k = 1024;
+  const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${Number.parseFloat((bytes / k ** i).toFixed(decimals))} ${sizes[i]}`;
+}
+
 // =============================================================================
 // RESOURCE INTERFACE CONTRACTS
 // =============================================================================