@shipstatic/types 0.4.24 → 0.5.0

package/dist/index.d.ts

@@ -26,8 +26,8 @@ export interface Deployment {
     status: DeploymentStatusType;
     /** Whether deployment has configuration */
     readonly config?: boolean;
-    /** Optional array of tags for categorization and filtering (lowercase, alphanumeric with separators) */
-    tags?: string[];
+    /** Optional array of labels for categorization and filtering (lowercase, alphanumeric with separators) */
+    labels?: string[];
     /** The client/tool used to create this deployment (e.g., 'web', 'sdk', 'cli') */
     readonly via?: string;
     /** The deployment URL */
@@ -75,8 +75,8 @@ export interface Domain {
     deployment: string | null;
     /** Current domain status */
     status: DomainStatusType;
-    /** Optional array of tags for categorization and filtering (lowercase, alphanumeric with separators) */
-    tags?: string[];
+    /** Optional array of labels for categorization and filtering (lowercase, alphanumeric with separators) */
+    labels?: string[];
     /** The domain URL - internal (subdomain) or external (custom domain) */
     readonly url: string;
     /** Unix timestamp (seconds) when domain was created */
@@ -177,8 +177,8 @@ export interface Token {
     readonly account: string;
     /** Optional IP address locking for security */
     readonly ip?: string;
-    /** Optional array of tags for categorization and filtering (lowercase, alphanumeric with separators) */
-    tags?: string[];
+    /** Optional array of labels for categorization and filtering (lowercase, alphanumeric with separators) */
+    labels?: string[];
     /** Unix timestamp (seconds) when token was created */
     readonly created: number;
     /** Unix timestamp (seconds) when token expires, or null for never */
@@ -417,7 +417,7 @@ export interface ConfigResponse {
  * - Explicit allowlist (only approved formats, reject unknown)
  * ============================================================================
  */
-export declare const ALLOWED_MIME_TYPES: readonly ["text/html", "text/css", "text/plain", "text/markdown", "text/xml", "text/csv", "text/yaml", "text/vtt", "text/calendar", "text/javascript", "text/typescript", "text/tsx", "text/jsx", "text/x-scss", "text/x-sass", "text/less", "text/x-less", "text/stylus", "text/x-vue", "text/x-svelte", "image/", "audio/", "video/", "font/", "application/javascript", "application/ecmascript", "application/x-javascript", "application/wasm", "application/json", "application/ld+json", "application/manifest+json", "application/source-map", "application/xml", "application/xhtml+xml", "application/rss+xml", "application/atom+xml", "application/yaml", "application/toml", "application/pdf", "model/gltf+json", "model/gltf-binary", "application/mp4", "application/font-woff", "application/font-woff2", "application/x-font-woff", "application/x-woff", "application/vnd.ms-fontobject", "application/x-font-ttf", "application/x-font-truetype", "application/x-font-otf", "application/x-font-opentype"];
+export declare const ALLOWED_MIME_TYPES: readonly ["text/html", "text/css", "text/plain", "text/markdown", "text/xml", "text/csv", "text/tab-separated-values", "text/yaml", "text/vcard", "text/mdx", "text/x-mdx", "text/vtt", "text/srt", "text/calendar", "text/javascript", "text/typescript", "application/x-typescript", "text/tsx", "text/jsx", "text/x-scss", "text/x-sass", "text/less", "text/x-less", "text/stylus", "text/x-vue", "text/x-svelte", "text/x-sql", "text/x-diff", "text/x-patch", "text/x-protobuf", "text/x-ini", "text/x-tex", "text/x-latex", "text/x-bibtex", "text/x-r-markdown", "image/", "audio/", "video/", "font/", "application/javascript", "application/ecmascript", "application/x-javascript", "application/wasm", "application/json", "application/ld+json", "application/geo+json", "application/manifest+json", "application/x-ipynb+json", "application/x-ndjson", "application/ndjson", "text/x-ndjson", "application/jsonl", "text/jsonl", "application/json5", "text/json5", "application/schema+json", "application/source-map", "application/xml", "application/xhtml+xml", "application/rss+xml", "application/atom+xml", "application/feed+json", "application/vnd.google-earth.kml+xml", "application/yaml", "application/toml", "application/pdf", "application/x-subrip", "application/sql", "application/graphql", "application/graphql+json", "application/x-protobuf", "application/x-ini", "application/x-tex", "application/x-bibtex", "model/gltf+json", "model/gltf-binary", "application/mp4", "application/font-woff", "application/font-woff2", "application/x-font-woff", "application/x-woff", "application/vnd.ms-fontobject", "application/x-font-ttf", "application/x-font-truetype", "application/x-font-otf", "application/x-font-opentype"];
 /**
  * Check if a MIME type is allowed for upload.
  *
@@ -581,8 +581,8 @@ export type DeployInput = File[] | string | string[];
  * SDK implementations may extend with additional options (timeout, signal, callbacks, etc.).
  */
 export interface DeploymentCreateOptions {
-    /** Optional tags for categorization and filtering */
-    tags?: string[];
+    /** Optional labels for categorization and filtering */
+    labels?: string[];
     /** Optional subdomain suggestion for the deployment */
     subdomain?: string;
     /** Client identifier (e.g., 'cli', 'sdk', 'web') */
@@ -596,7 +596,7 @@ export interface DeploymentResource {
     list: () => Promise<DeploymentListResponse>;
     get: (id: string) => Promise<Deployment>;
     set: (id: string, options: {
-        tags: string[];
+        labels: string[];
     }) => Promise<Deployment>;
     remove: (id: string) => Promise<void>;
 }
@@ -606,7 +606,7 @@ export interface DeploymentResource {
 export interface DomainResource {
     set: (name: string, options?: {
         deployment?: string;
-        tags?: string[];
+        labels?: string[];
     }) => Promise<Domain>;
     list: () => Promise<DomainListResponse>;
     get: (name: string) => Promise<Domain>;
@@ -634,7 +634,7 @@ export interface AccountResource {
 export interface TokenResource {
     create: (options?: {
         ttl?: number;
-        tags?: string[];
+        labels?: string[];
     }) => Promise<TokenCreateResponse>;
     list: () => Promise<TokenListResponse>;
     remove: (token: string) => Promise<void>;
@@ -696,7 +696,7 @@ export interface KeysResource {
  * All activity event types logged in the system.
  * Uses dot notation consistently: {resource}.{action}
  */
-export type ActivityEvent = 'account.create' | 'account.update' | 'account.delete' | 'account.key.generate' | 'account.plan.paid' | 'account.plan.transition' | 'account.suspended' | 'deployment.create' | 'deployment.update' | 'deployment.delete' | 'deployment.claim' | 'domain.create' | 'domain.update' | 'domain.delete' | 'domain.verify' | 'token.create' | 'token.consume' | 'admin.account.plan.update' | 'admin.account.ref.update' | 'admin.account.billing.update' | 'admin.account.tags.update' | 'admin.deployment.delete' | 'admin.domain.delete' | 'admin.billing.sync' | 'admin.billing.terminated' | 'billing.active' | 'billing.canceled' | 'billing.paused' | 'billing.expired' | 'billing.paid' | 'billing.trialing' | 'billing.scheduled_cancel' | 'billing.unpaid' | 'billing.update' | 'billing.past_due' | 'refund.created' | 'dispute.created';
+export type ActivityEvent = 'account.create' | 'account.update' | 'account.delete' | 'account.key.generate' | 'account.plan.paid' | 'account.plan.transition' | 'account.suspended' | 'deployment.create' | 'deployment.update' | 'deployment.delete' | 'deployment.claim' | 'domain.create' | 'domain.update' | 'domain.delete' | 'domain.verify' | 'token.create' | 'token.consume' | 'admin.account.plan.update' | 'admin.account.ref.update' | 'admin.account.billing.update' | 'admin.account.labels.update' | 'admin.deployment.delete' | 'admin.domain.delete' | 'admin.billing.sync' | 'admin.billing.terminated' | 'billing.active' | 'billing.canceled' | 'billing.paused' | 'billing.expired' | 'billing.paid' | 'billing.trialing' | 'billing.scheduled_cancel' | 'billing.unpaid' | 'billing.update' | 'billing.past_due' | 'refund.created' | 'dispute.created';
 /**
  * Activity events visible to users in the dashboard
  */
@@ -733,8 +733,8 @@ export interface ActivityMeta {
     wasVerified?: boolean;
     /** Previous deployment ID before relinking */
     previousDeployment?: string;
-    /** Tags that were set/updated */
-    tags?: string[];
+    /** Labels that were set/updated */
+    labels?: string[];
     /** OAuth provider name */
     provider?: string;
     /** Account email */
@@ -772,24 +772,15 @@ export declare const FileValidationStatus: {
 };
 export type FileValidationStatusType = typeof FileValidationStatus[keyof typeof FileValidationStatus];
 /**
- * Types of validation issues that can occur during file validation
- */
-export type ValidationIssueType = 'empty_file' | 'file_too_large' | 'total_size_exceeded' | 'invalid_mime_type' | 'invalid_filename' | 'mime_extension_mismatch' | 'file_count_exceeded' | 'processing_error';
-/**
- * A validation issue with severity level
+ * A validation issue with a display-ready message
  *
- * Issues are categorized by severity:
- * - **error**: Blocks deployment, user must fix
- * - **warning**: Excludes file but allows deployment to proceed
+ * Issues are either errors (in errors[] array) or warnings (in warnings[] array).
+ * The array position determines severity - no need to duplicate it in the object.
  */
 export interface ValidationIssue {
     /** File path that triggered this issue */
     file: string;
-    /** Severity level determines deployment behavior */
-    severity: 'error' | 'warning';
-    /** Issue type for programmatic handling */
-    type: ValidationIssueType;
-    /** Human-readable message explaining the issue */
+    /** Display-ready message explaining the issue */
     message: string;
 }
 /**
@@ -892,43 +883,43 @@ export declare function generateDeploymentUrl(deployment: string, platformDomain
  */
 export declare function generateDomainUrl(domain: string): string;
 /**
- * Tag validation constraints shared across UI and API.
- * These rules define the single source of truth for tag validation.
+ * Label validation constraints shared across UI and API.
+ * These rules define the single source of truth for label validation.
  */
-export declare const TAG_CONSTRAINTS: {
-    /** Minimum tag length in characters */
+export declare const LABEL_CONSTRAINTS: {
+    /** Minimum label length in characters */
     readonly MIN_LENGTH: 3;
-    /** Maximum tag length in characters (concise tags, matches Stack Overflow's original limit) */
+    /** Maximum label length in characters (concise labels, matches Stack Overflow's original limit) */
     readonly MAX_LENGTH: 25;
-    /** Maximum number of tags allowed per resource */
+    /** Maximum number of labels allowed per resource */
     readonly MAX_COUNT: 10;
-    /** Allowed separator characters between tag segments */
+    /** Allowed separator characters between label segments */
     readonly SEPARATORS: "._-";
 };
 /**
- * Tag validation pattern.
+ * Label validation pattern.
  * Must start and end with alphanumeric (a-z, 0-9).
  * Can contain separators (. _ -) between segments, but not consecutive.
  *
  * Valid examples: 'production', 'v1.2.3', 'api_v2', 'us-east-1'
  * Invalid examples: 'ab' (too short), '-prod' (starts with separator), 'foo--bar' (consecutive separators)
  */
-export declare const TAG_PATTERN: RegExp;
+export declare const LABEL_PATTERN: RegExp;
 /**
- * Serialize tags array to JSON string for database storage.
+ * Serialize labels array to JSON string for database storage.
  * Returns null for empty or undefined arrays.
  *
- * @example serializeTags(['web', 'production']) → '["web","production"]'
- * @example serializeTags([]) → null
- * @example serializeTags(undefined) → null
+ * @example serializeLabels(['web', 'production']) → '["web","production"]'
+ * @example serializeLabels([]) → null
+ * @example serializeLabels(undefined) → null
  */
-export declare function serializeTags(tags: string[] | undefined): string | null;
+export declare function serializeLabels(labels: string[] | undefined): string | null;
 /**
- * Deserialize tags from JSON string to array.
+ * Deserialize labels from JSON string to array.
  * Returns undefined for null/empty strings.
  *
- * @example deserializeTags('["web","production"]') → ['web', 'production']
- * @example deserializeTags(null) → undefined
- * @example deserializeTags('') → undefined
+ * @example deserializeLabels('["web","production"]') → ['web', 'production']
+ * @example deserializeLabels(null) → undefined
+ * @example deserializeLabels('') → undefined
  */
-export declare function deserializeTags(tagsJson: string | null): string[] | undefined;
+export declare function deserializeLabels(labelsJson: string | null): string[] | undefined;

package/dist/index.js

@@ -277,14 +277,21 @@ export const ALLOWED_MIME_TYPES = [
     'text/xml', // XML files
     // Data formats
     'text/csv', // CSV data files
+    'text/tab-separated-values', // TSV data files
     'text/yaml', // YAML config files
+    'text/vcard', // VCard contact files (.vcf)
+    // Modern documentation formats
+    'text/mdx', // MDX (Markdown with JSX) - Next.js, Docusaurus, Nextra
+    'text/x-mdx', // MDX (alternative MIME type)
     // Web-specific formats
     'text/vtt', // WebVTT video subtitles/captions (accessibility)
+    'text/srt', // SRT subtitles (SubRip format, legacy video captions)
     'text/calendar', // iCalendar (.ics) event files
     // JavaScript (legacy MIME type, still widely used by ~50% of servers)
     'text/javascript',
     // Modern web development formats (uncompiled source)
     'text/typescript', // TypeScript source (.ts)
+    'application/x-typescript', // TypeScript (alternative MIME type, .d.ts declarations)
     'text/tsx', // TypeScript JSX (.tsx)
     'text/jsx', // React JSX (.jsx)
     'text/x-scss', // SCSS preprocessor
@@ -294,6 +301,17 @@ export const ALLOWED_MIME_TYPES = [
     'text/stylus', // Stylus preprocessor
     'text/x-vue', // Vue single-file components (.vue)
     'text/x-svelte', // Svelte components (.svelte)
+    // Developer documentation formats
+    'text/x-sql', // SQL files (database schemas, migrations)
+    'text/x-diff', // Diff files (code comparisons, patches)
+    'text/x-patch', // Patch files (version upgrades, migrations)
+    'text/x-protobuf', // Protocol Buffers text format (gRPC schemas)
+    'text/x-ini', // INI configuration files
+    // Academic/research formats
+    'text/x-tex', // LaTeX documents
+    'text/x-latex', // LaTeX documents (alternative)
+    'text/x-bibtex', // BibTeX citations
+    'text/x-r-markdown', // R Markdown (statistical documentation)
     // =========================================================================
     // MEDIA (prefix matching - covers all common subtypes)
     // =========================================================================
@@ -317,7 +335,18 @@ export const ALLOWED_MIME_TYPES = [
     // JSON and structured data
     'application/json',
     'application/ld+json', // JSON-LD for structured data / SEO (Schema.org, Open Graph)
+    'application/geo+json', // GeoJSON for mapping (Leaflet, Mapbox)
     'application/manifest+json', // PWA web app manifests
+    'application/x-ipynb+json', // Jupyter Notebooks (data science, ML tutorials)
+    // JSON variants (AI/ML, streaming data, configs)
+    'application/x-ndjson', // Newline-Delimited JSON (training datasets, logs)
+    'application/ndjson', // NDJSON (alternative MIME type)
+    'text/x-ndjson', // NDJSON (text variant)
+    'application/jsonl', // JSON Lines (Hugging Face, OpenAI fine-tuning)
+    'text/jsonl', // JSON Lines (text variant)
+    'application/json5', // JSON5 (JSON with comments, trailing commas)
+    'text/json5', // JSON5 (text variant)
+    'application/schema+json', // JSON Schema (API specs, model definitions)
     // Development tools
     'application/source-map', // Source maps (.js.map, .css.map) for debugging
     // XML and feeds
@@ -325,11 +354,24 @@ export const ALLOWED_MIME_TYPES = [
     'application/xhtml+xml', // XHTML - XML-compliant HTML (legacy sites)
     'application/rss+xml', // RSS feeds (blogs, podcasts)
     'application/atom+xml', // Atom feeds
+    'application/feed+json', // JSON Feed (modern RSS alternative)
+    'application/vnd.google-earth.kml+xml', // KML for mapping (Google Earth, GIS)
     // Configuration formats
     'application/yaml', // YAML configs (static site generators)
     'application/toml', // TOML configs (Cargo, Netlify, Rust projects)
     // Documents
     'application/pdf', // PDF documents
+    // Media metadata
+    'application/x-subrip', // SRT subtitles (SubRip format)
+    // Developer tools and schemas
+    'application/sql', // SQL files (database schemas, queries)
+    'application/graphql', // GraphQL schemas (API documentation)
+    'application/graphql+json', // GraphQL with JSON encoding
+    'application/x-protobuf', // Protocol Buffers binary (gRPC)
+    'application/x-ini', // INI configuration files
+    // Academic formats
+    'application/x-tex', // LaTeX documents
+    'application/x-bibtex', // BibTeX citations
     // =========================================================================
     // 3D FORMATS (industry standard only)
     // =========================================================================
@@ -522,57 +564,57 @@ export function generateDomainUrl(domain) {
     return `https://${domain}`;
 }
 // =============================================================================
-// TAG UTILITIES
+// LABEL UTILITIES
 // =============================================================================
 /**
- * Tag validation constraints shared across UI and API.
- * These rules define the single source of truth for tag validation.
+ * Label validation constraints shared across UI and API.
+ * These rules define the single source of truth for label validation.
  */
-export const TAG_CONSTRAINTS = {
-    /** Minimum tag length in characters */
+export const LABEL_CONSTRAINTS = {
+    /** Minimum label length in characters */
     MIN_LENGTH: 3,
-    /** Maximum tag length in characters (concise tags, matches Stack Overflow's original limit) */
+    /** Maximum label length in characters (concise labels, matches Stack Overflow's original limit) */
     MAX_LENGTH: 25,
-    /** Maximum number of tags allowed per resource */
+    /** Maximum number of labels allowed per resource */
     MAX_COUNT: 10,
-    /** Allowed separator characters between tag segments */
+    /** Allowed separator characters between label segments */
     SEPARATORS: '._-',
 };
 /**
- * Tag validation pattern.
+ * Label validation pattern.
  * Must start and end with alphanumeric (a-z, 0-9).
  * Can contain separators (. _ -) between segments, but not consecutive.
  *
  * Valid examples: 'production', 'v1.2.3', 'api_v2', 'us-east-1'
  * Invalid examples: 'ab' (too short), '-prod' (starts with separator), 'foo--bar' (consecutive separators)
  */
-export const TAG_PATTERN = /^[a-z0-9]+(?:[._-][a-z0-9]+)*$/;
+export const LABEL_PATTERN = /^[a-z0-9]+(?:[._-][a-z0-9]+)*$/;
 /**
- * Serialize tags array to JSON string for database storage.
+ * Serialize labels array to JSON string for database storage.
  * Returns null for empty or undefined arrays.
  *
- * @example serializeTags(['web', 'production']) → '["web","production"]'
- * @example serializeTags([]) → null
- * @example serializeTags(undefined) → null
+ * @example serializeLabels(['web', 'production']) → '["web","production"]'
+ * @example serializeLabels([]) → null
+ * @example serializeLabels(undefined) → null
  */
-export function serializeTags(tags) {
-    if (!tags || tags.length === 0)
+export function serializeLabels(labels) {
+    if (!labels || labels.length === 0)
         return null;
-    return JSON.stringify(tags);
+    return JSON.stringify(labels);
 }
 /**
- * Deserialize tags from JSON string to array.
+ * Deserialize labels from JSON string to array.
  * Returns undefined for null/empty strings.
  *
- * @example deserializeTags('["web","production"]') → ['web', 'production']
- * @example deserializeTags(null) → undefined
- * @example deserializeTags('') → undefined
+ * @example deserializeLabels('["web","production"]') → ['web', 'production']
+ * @example deserializeLabels(null) → undefined
+ * @example deserializeLabels('') → undefined
  */
-export function deserializeTags(tagsJson) {
-    if (!tagsJson)
+export function deserializeLabels(labelsJson) {
+    if (!labelsJson)
         return undefined;
     try {
-        const parsed = JSON.parse(tagsJson);
+        const parsed = JSON.parse(labelsJson);
         return Array.isArray(parsed) && parsed.length > 0 ? parsed : undefined;
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipstatic/types",
-  "version": "0.4.24",
+  "version": "0.5.0",
   "description": "Shared types for Shipstatic platform",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,10 +34,12 @@
   },
   "devDependencies": {
     "@types/node": "^24.10.9",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.8"
   },
   "scripts": {
     "build": "tsc",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "vitest"
   }
 }

package/src/index.ts

@@ -33,8 +33,8 @@ export interface Deployment {
   status: DeploymentStatusType; // Mutable - can be updated
   /** Whether deployment has configuration */
   readonly config?: boolean;
-  /** Optional array of tags for categorization and filtering (lowercase, alphanumeric with separators) */
-  tags?: string[];
+  /** Optional array of labels for categorization and filtering (lowercase, alphanumeric with separators) */
+  labels?: string[];
   /** The client/tool used to create this deployment (e.g., 'web', 'sdk', 'cli') */
   readonly via?: string;
   /** The deployment URL */
@@ -91,8 +91,8 @@ export interface Domain {
   deployment: string | null; // Mutable - can be updated to point to different deployment
   /** Current domain status */
   status: DomainStatusType; // Mutable - can be updated
-  /** Optional array of tags for categorization and filtering (lowercase, alphanumeric with separators) */
-  tags?: string[];
+  /** Optional array of labels for categorization and filtering (lowercase, alphanumeric with separators) */
+  labels?: string[];
   /** The domain URL - internal (subdomain) or external (custom domain) */
   readonly url: string;
   /** Unix timestamp (seconds) when domain was created */
@@ -204,8 +204,8 @@ export interface Token {
   readonly account: string;
   /** Optional IP address locking for security */
   readonly ip?: string;
-  /** Optional array of tags for categorization and filtering (lowercase, alphanumeric with separators) */
-  tags?: string[];
+  /** Optional array of labels for categorization and filtering (lowercase, alphanumeric with separators) */
+  labels?: string[];
   /** Unix timestamp (seconds) when token was created */
   readonly created: number;
   /** Unix timestamp (seconds) when token expires, or null for never */
@@ -585,10 +585,17 @@ export const ALLOWED_MIME_TYPES = [
 
   // Data formats
   'text/csv',                      // CSV data files
+  'text/tab-separated-values',     // TSV data files
   'text/yaml',                     // YAML config files
+  'text/vcard',                    // VCard contact files (.vcf)
+
+  // Modern documentation formats
+  'text/mdx',                      // MDX (Markdown with JSX) - Next.js, Docusaurus, Nextra
+  'text/x-mdx',                    // MDX (alternative MIME type)
 
   // Web-specific formats
   'text/vtt',                      // WebVTT video subtitles/captions (accessibility)
+  'text/srt',                      // SRT subtitles (SubRip format, legacy video captions)
   'text/calendar',                 // iCalendar (.ics) event files
 
   // JavaScript (legacy MIME type, still widely used by ~50% of servers)
@@ -596,6 +603,7 @@ export const ALLOWED_MIME_TYPES = [
 
   // Modern web development formats (uncompiled source)
   'text/typescript',               // TypeScript source (.ts)
+  'application/x-typescript',      // TypeScript (alternative MIME type, .d.ts declarations)
   'text/tsx',                      // TypeScript JSX (.tsx)
   'text/jsx',                      // React JSX (.jsx)
   'text/x-scss',                   // SCSS preprocessor
@@ -606,6 +614,19 @@ export const ALLOWED_MIME_TYPES = [
   'text/x-vue',                    // Vue single-file components (.vue)
   'text/x-svelte',                 // Svelte components (.svelte)
 
+  // Developer documentation formats
+  'text/x-sql',                    // SQL files (database schemas, migrations)
+  'text/x-diff',                   // Diff files (code comparisons, patches)
+  'text/x-patch',                  // Patch files (version upgrades, migrations)
+  'text/x-protobuf',               // Protocol Buffers text format (gRPC schemas)
+  'text/x-ini',                    // INI configuration files
+
+  // Academic/research formats
+  'text/x-tex',                    // LaTeX documents
+  'text/x-latex',                  // LaTeX documents (alternative)
+  'text/x-bibtex',                 // BibTeX citations
+  'text/x-r-markdown',             // R Markdown (statistical documentation)
+
   // =========================================================================
   // MEDIA (prefix matching - covers all common subtypes)
   // =========================================================================
@@ -637,7 +658,19 @@ export const ALLOWED_MIME_TYPES = [
   // JSON and structured data
   'application/json',
   'application/ld+json',           // JSON-LD for structured data / SEO (Schema.org, Open Graph)
+  'application/geo+json',          // GeoJSON for mapping (Leaflet, Mapbox)
   'application/manifest+json',     // PWA web app manifests
+  'application/x-ipynb+json',      // Jupyter Notebooks (data science, ML tutorials)
+
+  // JSON variants (AI/ML, streaming data, configs)
+  'application/x-ndjson',          // Newline-Delimited JSON (training datasets, logs)
+  'application/ndjson',            // NDJSON (alternative MIME type)
+  'text/x-ndjson',                 // NDJSON (text variant)
+  'application/jsonl',             // JSON Lines (Hugging Face, OpenAI fine-tuning)
+  'text/jsonl',                    // JSON Lines (text variant)
+  'application/json5',             // JSON5 (JSON with comments, trailing commas)
+  'text/json5',                    // JSON5 (text variant)
+  'application/schema+json',       // JSON Schema (API specs, model definitions)
 
   // Development tools
   'application/source-map',        // Source maps (.js.map, .css.map) for debugging
@@ -647,6 +680,8 @@ export const ALLOWED_MIME_TYPES = [
   'application/xhtml+xml',         // XHTML - XML-compliant HTML (legacy sites)
   'application/rss+xml',           // RSS feeds (blogs, podcasts)
   'application/atom+xml',          // Atom feeds
+  'application/feed+json',         // JSON Feed (modern RSS alternative)
+  'application/vnd.google-earth.kml+xml', // KML for mapping (Google Earth, GIS)
 
   // Configuration formats
   'application/yaml',              // YAML configs (static site generators)
@@ -655,6 +690,20 @@ export const ALLOWED_MIME_TYPES = [
   // Documents
   'application/pdf',               // PDF documents
 
+  // Media metadata
+  'application/x-subrip',          // SRT subtitles (SubRip format)
+
+  // Developer tools and schemas
+  'application/sql',               // SQL files (database schemas, queries)
+  'application/graphql',           // GraphQL schemas (API documentation)
+  'application/graphql+json',      // GraphQL with JSON encoding
+  'application/x-protobuf',        // Protocol Buffers binary (gRPC)
+  'application/x-ini',             // INI configuration files
+
+  // Academic formats
+  'application/x-tex',             // LaTeX documents
+  'application/x-bibtex',          // BibTeX citations
+
   // =========================================================================
   // 3D FORMATS (industry standard only)
   // =========================================================================
@@ -954,8 +1003,8 @@ export type DeployInput = File[] | string | string[];
  * SDK implementations may extend with additional options (timeout, signal, callbacks, etc.).
  */
 export interface DeploymentCreateOptions {
-  /** Optional tags for categorization and filtering */
-  tags?: string[];
+  /** Optional labels for categorization and filtering */
+  labels?: string[];
   /** Optional subdomain suggestion for the deployment */
   subdomain?: string;
   /** Client identifier (e.g., 'cli', 'sdk', 'web') */
@@ -969,7 +1018,7 @@ export interface DeploymentResource {
   create: (input: DeployInput, options?: DeploymentCreateOptions) => Promise<Deployment>;
   list: () => Promise<DeploymentListResponse>;
   get: (id: string) => Promise<Deployment>;
-  set: (id: string, options: { tags: string[] }) => Promise<Deployment>;
+  set: (id: string, options: { labels: string[] }) => Promise<Deployment>;
   remove: (id: string) => Promise<void>;
 }
 
@@ -977,7 +1026,7 @@ export interface DeploymentResource {
  * Domain resource interface - the contract all implementations must follow
  */
 export interface DomainResource {
-  set: (name: string, options?: { deployment?: string; tags?: string[] }) => Promise<Domain>;
+  set: (name: string, options?: { deployment?: string; labels?: string[] }) => Promise<Domain>;
   list: () => Promise<DomainListResponse>;
   get: (name: string) => Promise<Domain>;
   remove: (name: string) => Promise<void>;
@@ -999,7 +1048,7 @@ export interface AccountResource {
  * Token resource interface - the contract all implementations must follow
  */
 export interface TokenResource {
-  create: (options?: { ttl?: number; tags?: string[] }) => Promise<TokenCreateResponse>;
+  create: (options?: { ttl?: number; labels?: string[] }) => Promise<TokenCreateResponse>;
   list: () => Promise<TokenListResponse>;
   remove: (token: string) => Promise<void>;
 }
@@ -1100,7 +1149,7 @@ export type ActivityEvent =
   | 'admin.account.plan.update'
   | 'admin.account.ref.update'
   | 'admin.account.billing.update'
-  | 'admin.account.tags.update'
+  | 'admin.account.labels.update'
   | 'admin.deployment.delete'
   | 'admin.domain.delete'
   | 'admin.billing.sync'
@@ -1175,8 +1224,8 @@ export interface ActivityMeta {
   wasVerified?: boolean;
   /** Previous deployment ID before relinking */
   previousDeployment?: string;
-  /** Tags that were set/updated */
-  tags?: string[];
+  /** Labels that were set/updated */
+  labels?: string[];
 
   // Account events
   /** OAuth provider name */
@@ -1226,40 +1275,18 @@ export const FileValidationStatus = {
 
 export type FileValidationStatusType = typeof FileValidationStatus[keyof typeof FileValidationStatus];
 
-/**
- * Types of validation issues that can occur during file validation
- */
-export type ValidationIssueType =
-  // Warnings (exclude file but don't block deployment)
-  | 'empty_file'
-
-  // Errors (block deployment)
-  | 'file_too_large'
-  | 'total_size_exceeded'
-  | 'invalid_mime_type'
-  | 'invalid_filename'
-  | 'mime_extension_mismatch'
-  | 'file_count_exceeded'
-  | 'processing_error';
 
 /**
- * A validation issue with severity level
+ * A validation issue with a display-ready message
  *
- * Issues are categorized by severity:
- * - **error**: Blocks deployment, user must fix
- * - **warning**: Excludes file but allows deployment to proceed
+ * Issues are either errors (in errors[] array) or warnings (in warnings[] array).
+ * The array position determines severity - no need to duplicate it in the object.
  */
 export interface ValidationIssue {
   /** File path that triggered this issue */
   file: string;
 
-  /** Severity level determines deployment behavior */
-  severity: 'error' | 'warning';
-
-  /** Issue type for programmatic handling */
-  type: ValidationIssueType;
-
-  /** Human-readable message explaining the issue */
+  /** Display-ready message explaining the issue */
   message: string;
 }
 
@@ -1394,59 +1421,59 @@ export function generateDomainUrl(domain: string): string {
 }
 
 // =============================================================================
-// TAG UTILITIES
+// LABEL UTILITIES
 // =============================================================================
 
 /**
- * Tag validation constraints shared across UI and API.
- * These rules define the single source of truth for tag validation.
+ * Label validation constraints shared across UI and API.
+ * These rules define the single source of truth for label validation.
  */
-export const TAG_CONSTRAINTS = {
-  /** Minimum tag length in characters */
+export const LABEL_CONSTRAINTS = {
+  /** Minimum label length in characters */
   MIN_LENGTH: 3,
-  /** Maximum tag length in characters (concise tags, matches Stack Overflow's original limit) */
+  /** Maximum label length in characters (concise labels, matches Stack Overflow's original limit) */
   MAX_LENGTH: 25,
-  /** Maximum number of tags allowed per resource */
+  /** Maximum number of labels allowed per resource */
   MAX_COUNT: 10,
-  /** Allowed separator characters between tag segments */
+  /** Allowed separator characters between label segments */
   SEPARATORS: '._-',
 } as const;
 
 /**
- * Tag validation pattern.
+ * Label validation pattern.
  * Must start and end with alphanumeric (a-z, 0-9).
  * Can contain separators (. _ -) between segments, but not consecutive.
  *
  * Valid examples: 'production', 'v1.2.3', 'api_v2', 'us-east-1'
  * Invalid examples: 'ab' (too short), '-prod' (starts with separator), 'foo--bar' (consecutive separators)
  */
-export const TAG_PATTERN = /^[a-z0-9]+(?:[._-][a-z0-9]+)*$/;
+export const LABEL_PATTERN = /^[a-z0-9]+(?:[._-][a-z0-9]+)*$/;
 
 /**
- * Serialize tags array to JSON string for database storage.
+ * Serialize labels array to JSON string for database storage.
  * Returns null for empty or undefined arrays.
  *
- * @example serializeTags(['web', 'production']) → '["web","production"]'
- * @example serializeTags([]) → null
- * @example serializeTags(undefined) → null
+ * @example serializeLabels(['web', 'production']) → '["web","production"]'
+ * @example serializeLabels([]) → null
+ * @example serializeLabels(undefined) → null
  */
-export function serializeTags(tags: string[] | undefined): string | null {
-  if (!tags || tags.length === 0) return null;
-  return JSON.stringify(tags);
+export function serializeLabels(labels: string[] | undefined): string | null {
+  if (!labels || labels.length === 0) return null;
+  return JSON.stringify(labels);
 }
 
 /**
- * Deserialize tags from JSON string to array.
+ * Deserialize labels from JSON string to array.
  * Returns undefined for null/empty strings.
  *
- * @example deserializeTags('["web","production"]') → ['web', 'production']
- * @example deserializeTags(null) → undefined
- * @example deserializeTags('') → undefined
+ * @example deserializeLabels('["web","production"]') → ['web', 'production']
+ * @example deserializeLabels(null) → undefined
+ * @example deserializeLabels('') → undefined
  */
-export function deserializeTags(tagsJson: string | null): string[] | undefined {
-  if (!tagsJson) return undefined;
+export function deserializeLabels(labelsJson: string | null): string[] | undefined {
+  if (!labelsJson) return undefined;
   try {
-    const parsed = JSON.parse(tagsJson);
+    const parsed = JSON.parse(labelsJson);
     return Array.isArray(parsed) && parsed.length > 0 ? parsed : undefined;
   } catch {
     return undefined;