@shipstatic/types 0.5.4 → 0.6.1

package/dist/index.d.ts

@@ -224,6 +224,13 @@ export declare const AccountPlan: {
     readonly TERMINATED: "terminated";
 };
 export type AccountPlanType = typeof AccountPlan[keyof typeof AccountPlan];
+/**
+ * Account usage metrics — always available regardless of billing provider.
+ */
+export interface AccountUsage {
+    /** Number of active custom domains (excludes paused) */
+    customDomains: number;
+}
 /**
  * Core account object - used in both API responses and SDK
  * All fields are readonly to prevent accidental mutations
@@ -237,6 +244,8 @@ export interface Account {
     readonly picture: string | null;
     /** Account plan status */
     readonly plan: AccountPlanType;
+    /** Account usage metrics (custom domains, etc.) */
+    readonly usage: AccountUsage;
     /** Unix timestamp (seconds) when account was created */
     readonly created: number;
     /** Unix timestamp (seconds) when account was activated (first deployment), null if not yet activated */
@@ -345,99 +354,38 @@ export declare class ShipError extends Error {
  */
 export declare function isShipError(error: unknown): error is ShipError;
 /**
- * Platform configuration response from API
- *
- * Contains ONLY dynamic, runtime-specific values (plan-based limits).
- * Static constants (MIME types, validation rules) live as exported constants.
+ * Dynamic platform configuration returned by the /config endpoint.
+ * Contains plan-based limits that vary by account.
  */
 export interface ConfigResponse {
-    /** Maximum individual file size in bytes */
     maxFileSize: number;
-    /** Maximum number of files per deployment */
     maxFilesCount: number;
-    /** Maximum total deployment size in bytes */
     maxTotalSize: number;
 }
 /**
- * Allowed MIME types for static web hosting.
- *
- * This is a static platform constant, not per-user configuration.
- * Safe to share across frontend/backend due to atomic deploys.
- *
- * Validation rules:
- * - Exact match: 'application/json' allows only 'application/json'
- * - Prefix match: 'image/' allows all image types (png, jpeg, webp, etc.)
- *
- * Coverage: 100% of browser-renderable web content
- * - Core web (HTML, CSS, JS, WASM)
- * - Media (images, audio, video, fonts)
- * - Documents (PDF, Markdown, data formats)
- * - Modern web (PWA, 3D, structured data)
- *
- * ============================================================================
- * INTENTIONALLY EXCLUDED (Security & Platform Integrity)
- * ============================================================================
+ * Blocked file extensions — files that cannot be uploaded.
  *
- * We are a WEB HOSTING platform, not a file distribution service.
- * GitHub Pages-style parity for renderable content, more restrictive for downloads.
+ * We accept any file type by default and derive Content-Type from the
+ * extension at serve time (via mime-db in the API worker). Unknown extensions
+ * are served as `application/octet-stream` with `X-Content-Type-Options: nosniff`.
  *
- * 1. EXECUTABLES (Malware Distribution)
- *    → .exe, .msi, .dmg, .deb, .rpm, .app, .apk, .jar
- *    → Reason: Direct malware delivery vector
- *    → Alternative: Use GitHub Releases or dedicated software distribution CDN
- *
- * 2. ARCHIVES (Piracy & Abuse)
- *    → .zip, .rar, .tar, .gz, .7z, .bz2
- *    → Reason: File sharing abuse, can contain executables, no web rendering
- *    → Alternative: Use file hosting service (Dropbox, Google Drive) or GitHub Releases
- *
- * 3. SERVER-SIDE SCRIPTS (Credential Leakage)
- *    → .php, .asp, .jsp, .cgi
- *    → Reason: Source code exposure (database passwords, API keys, secrets)
- *    → Alternative: Static hosting only - use serverless functions for backends
- *
- * 4. SHELL SCRIPTS (OS Execution)
- *    → .sh, .bash, .bat, .cmd, .ps1, .vbs
- *    → Reason: Execute on user's OS outside browser sandbox, social engineering risk
- *    → Alternative: Embed code examples in HTML <pre><code> or link to GitHub repo
- *
- * 5. PROGRAMMING LANGUAGE SOURCE (Platform Scope)
- *    → .py, .rb, .pl, .java, .c, .cpp, .cs, .go, .rs
- *    → Reason: Not web-renderable, better served by GitHub/GitLab/Bitbucket
- *    → Alternative: Use GitHub for code hosting, link to repository
- *
- * 6. OFFICE DOCUMENTS (Macro Malware)
- *    → .doc, .docx, .xls, .xlsx, .ppt, .pptx
- *    → Reason: Can contain VBA macros, active exploits in the wild
- *    → Alternative: Use PDF for documents (fully supported)
- *
- * 7. GENERIC BINARIES (Unvalidatable)
- *    → application/octet-stream
- *    → Reason: Too broad - allows any binary format, cannot moderate effectively
- *    → Alternative: Use specific MIME types for known formats
- *
- * ============================================================================
- * Security Model:
- * - Browser sandbox (JS/WASM execute safely in controlled environment)
- * - AI content moderation (scans text/image content for abuse)
- * - No server-side execution (static files only)
- * - Explicit allowlist (only approved formats, reject unknown)
- * ============================================================================
+ * The blocklist targets file types that pose direct security risks when hosted:
+ * executables, disk images, malware vectors, dangerous scripts, and shortcuts.
  */
-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"];
+export declare const BLOCKED_EXTENSIONS: ReadonlySet<string>;
 /**
- * Check if a MIME type is allowed for upload.
- *
- * Supports both exact matches and prefix matches:
- * - 'application/json' matches 'application/json' exactly
- * - 'text/' matches 'text/plain', 'text/html', etc.
+ * Check if a filename has a blocked extension.
+ * Extracts the extension from the filename and checks against the blocklist.
+ * Case-insensitive. Returns false for files without extensions.
  *
  * @example
- * isAllowedMimeType('text/plain')     // true (prefix match)
- * isAllowedMimeType('application/json') // true (exact match)
- * isAllowedMimeType('application/wasm') // false (not allowed)
+ * isBlockedExtension('virus.exe')     // true
+ * isBlockedExtension('app.dmg')       // true
+ * isBlockedExtension('style.css')     // false
+ * isBlockedExtension('data.custom')   // false
+ * isBlockedExtension('README')        // false
  */
-export declare function isAllowedMimeType(mimeType: string): boolean;
+export declare function isBlockedExtension(filename: string): boolean;
 /**
  * Simple ping response for health checks
  */
@@ -651,8 +599,6 @@ export interface BillingStatus {
     billing: string | null;
     /** Number of billing units (1 unit = 1 custom domain), null if no billing */
     units: number | null;
-    /** Number of custom domains currently in use, null if no billing */
-    usage: number | null;
     /** Billing status from Creem (active, trialing, canceled, etc.), null if no billing */
     status: string | null;
     /** Link to Creem customer portal for billing management, null if unavailable */
@@ -788,7 +734,6 @@ export interface ValidationIssue {
 export interface ValidatableFile {
     name: string;
     size: number;
-    type: string;
     status?: FileValidationStatusType;
     statusMessage?: string;
 }

package/dist/index.js

@@ -199,215 +199,55 @@ export function isShipError(error) {
         error.name === 'ShipError' &&
         'status' in error);
 }
+// =============================================================================
+// EXTENSION BLOCKLIST
+// =============================================================================
 /**
- * Allowed MIME types for static web hosting.
- *
- * This is a static platform constant, not per-user configuration.
- * Safe to share across frontend/backend due to atomic deploys.
- *
- * Validation rules:
- * - Exact match: 'application/json' allows only 'application/json'
- * - Prefix match: 'image/' allows all image types (png, jpeg, webp, etc.)
- *
- * Coverage: 100% of browser-renderable web content
- * - Core web (HTML, CSS, JS, WASM)
- * - Media (images, audio, video, fonts)
- * - Documents (PDF, Markdown, data formats)
- * - Modern web (PWA, 3D, structured data)
- *
- * ============================================================================
- * INTENTIONALLY EXCLUDED (Security & Platform Integrity)
- * ============================================================================
- *
- * We are a WEB HOSTING platform, not a file distribution service.
- * GitHub Pages-style parity for renderable content, more restrictive for downloads.
+ * Blocked file extensions — files that cannot be uploaded.
  *
- * 1. EXECUTABLES (Malware Distribution)
- *    → .exe, .msi, .dmg, .deb, .rpm, .app, .apk, .jar
- *    → Reason: Direct malware delivery vector
- *    → Alternative: Use GitHub Releases or dedicated software distribution CDN
+ * We accept any file type by default and derive Content-Type from the
+ * extension at serve time (via mime-db in the API worker). Unknown extensions
+ * are served as `application/octet-stream` with `X-Content-Type-Options: nosniff`.
  *
- * 2. ARCHIVES (Piracy & Abuse)
- *    → .zip, .rar, .tar, .gz, .7z, .bz2
- *    → Reason: File sharing abuse, can contain executables, no web rendering
- *    → Alternative: Use file hosting service (Dropbox, Google Drive) or GitHub Releases
- *
- * 3. SERVER-SIDE SCRIPTS (Credential Leakage)
- *    → .php, .asp, .jsp, .cgi
- *    → Reason: Source code exposure (database passwords, API keys, secrets)
- *    → Alternative: Static hosting only - use serverless functions for backends
- *
- * 4. SHELL SCRIPTS (OS Execution)
- *    → .sh, .bash, .bat, .cmd, .ps1, .vbs
- *    → Reason: Execute on user's OS outside browser sandbox, social engineering risk
- *    → Alternative: Embed code examples in HTML <pre><code> or link to GitHub repo
- *
- * 5. PROGRAMMING LANGUAGE SOURCE (Platform Scope)
- *    → .py, .rb, .pl, .java, .c, .cpp, .cs, .go, .rs
- *    → Reason: Not web-renderable, better served by GitHub/GitLab/Bitbucket
- *    → Alternative: Use GitHub for code hosting, link to repository
- *
- * 6. OFFICE DOCUMENTS (Macro Malware)
- *    → .doc, .docx, .xls, .xlsx, .ppt, .pptx
- *    → Reason: Can contain VBA macros, active exploits in the wild
- *    → Alternative: Use PDF for documents (fully supported)
- *
- * 7. GENERIC BINARIES (Unvalidatable)
- *    → application/octet-stream
- *    → Reason: Too broad - allows any binary format, cannot moderate effectively
- *    → Alternative: Use specific MIME types for known formats
- *
- * ============================================================================
- * Security Model:
- * - Browser sandbox (JS/WASM execute safely in controlled environment)
- * - AI content moderation (scans text/image content for abuse)
- * - No server-side execution (static files only)
- * - Explicit allowlist (only approved formats, reject unknown)
- * ============================================================================
+ * The blocklist targets file types that pose direct security risks when hosted:
+ * executables, disk images, malware vectors, dangerous scripts, and shortcuts.
  */
-export const ALLOWED_MIME_TYPES = [
-    // =========================================================================
-    // TEXT CONTENT (explicit list - no prefix matching for security)
-    // =========================================================================
-    // Core web documents
-    'text/html', // HTML pages
-    'text/css', // Stylesheets
-    'text/plain', // Plain text (robots.txt, .well-known/*, LICENSE, README.txt)
-    'text/markdown', // Markdown files (.md)
-    '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
-    'text/x-sass', // Sass preprocessor
-    'text/less', // Less preprocessor
-    'text/x-less', // Less preprocessor (alternative)
-    '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)
-    // =========================================================================
-    // Images: PNG, JPEG, GIF, SVG, WebP, AVIF, HEIC, BMP, TIFF, ICO, etc.
-    'image/',
-    // Audio: MP3, OGG, WAV, WebM, AAC, FLAC, Opus, etc.
-    'audio/',
-    // Video: MP4, WebM, OGG, QuickTime, etc.
-    'video/',
-    // Modern fonts: WOFF2, WOFF, TTF, OTF
-    'font/',
-    // =========================================================================
-    // CORE WEB APPLICATION TYPES
-    // =========================================================================
-    // JavaScript (multiple MIME types for compatibility)
-    'application/javascript', // Modern standard (RFC 9239)
-    'application/ecmascript', // ECMAScript (legacy but still used)
-    'application/x-javascript', // Legacy variant (old CDNs, Apache configs)
-    // WebAssembly (modern web apps, games, compute-heavy workloads)
-    'application/wasm',
-    // 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
-    'application/xml',
-    '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)
-    // =========================================================================
-    // glTF - Khronos standard for 3D web content
-    'model/gltf+json', // glTF JSON format
-    'model/gltf-binary', // GLB binary format
-    // =========================================================================
-    // LEGACY COMPATIBILITY
-    // =========================================================================
-    // Video (some tools detect MP4 as application/mp4)
-    'application/mp4',
-    // Legacy font MIME types (Bootstrap, Font Awesome, IE compatibility)
-    'application/font-woff',
-    'application/font-woff2',
-    'application/x-font-woff',
-    'application/x-woff',
-    'application/vnd.ms-fontobject', // EOT files (Internet Explorer)
-    'application/x-font-ttf',
-    'application/x-font-truetype',
-    'application/x-font-otf',
-    'application/x-font-opentype',
-];
+export const BLOCKED_EXTENSIONS = new Set([
+    // Executables
+    'exe', 'msi', 'dll', 'scr', 'bat', 'cmd', 'com', 'pif', 'app', 'deb', 'rpm',
+    // Installers
+    'pkg', 'mpkg',
+    // Disk images
+    'dmg', 'iso', 'img',
+    // Malware vectors
+    'cab', 'cpl', 'chm',
+    // Dangerous scripts
+    'ps1', 'vbs', 'vbe', 'ws', 'wsf', 'wsc', 'wsh', 'reg',
+    // Java
+    'jar', 'jnlp',
+    // Mobile/browser packages
+    'apk', 'crx',
+    // Shortcut/link
+    'lnk', 'inf', 'hta',
+]);
 /**
- * Check if a MIME type is allowed for upload.
- *
- * Supports both exact matches and prefix matches:
- * - 'application/json' matches 'application/json' exactly
- * - 'text/' matches 'text/plain', 'text/html', etc.
+ * Check if a filename has a blocked extension.
+ * Extracts the extension from the filename and checks against the blocklist.
+ * Case-insensitive. Returns false for files without extensions.
  *
  * @example
- * isAllowedMimeType('text/plain')     // true (prefix match)
- * isAllowedMimeType('application/json') // true (exact match)
- * isAllowedMimeType('application/wasm') // false (not allowed)
+ * isBlockedExtension('virus.exe')     // true
+ * isBlockedExtension('app.dmg')       // true
+ * isBlockedExtension('style.css')     // false
+ * isBlockedExtension('data.custom')   // false
+ * isBlockedExtension('README')        // false
  */
-export function isAllowedMimeType(mimeType) {
-    return ALLOWED_MIME_TYPES.some(allowed => mimeType === allowed || mimeType.startsWith(allowed));
+export function isBlockedExtension(filename) {
+    const dotIndex = filename.lastIndexOf('.');
+    if (dotIndex === -1 || dotIndex === filename.length - 1)
+        return false;
+    const ext = filename.slice(dotIndex + 1).toLowerCase();
+    return BLOCKED_EXTENSIONS.has(ext);
 }
 // API Key Configuration
 export const API_KEY_PREFIX = 'ship-';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipstatic/types",
-  "version": "0.5.4",
+  "version": "0.6.1",
   "description": "Shared types for Shipstatic platform",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -260,6 +260,14 @@ export const AccountPlan = {
 
 export type AccountPlanType = typeof AccountPlan[keyof typeof AccountPlan];
 
+/**
+ * Account usage metrics — always available regardless of billing provider.
+ */
+export interface AccountUsage {
+  /** Number of active custom domains (excludes paused) */
+  customDomains: number;
+}
+
 /**
  * Core account object - used in both API responses and SDK
  * All fields are readonly to prevent accidental mutations
@@ -273,6 +281,8 @@ export interface Account {
   readonly picture: string | null;
   /** Account plan status */
   readonly plan: AccountPlanType;
+  /** Account usage metrics (custom domains, etc.) */
+  readonly usage: AccountUsage;
   /** Unix timestamp (seconds) when account was created */
   readonly created: number;
   /** Unix timestamp (seconds) when account was activated (first deployment), null if not yet activated */
@@ -498,266 +508,69 @@ export function isShipError(error: unknown): error is ShipError {
 // =============================================================================
 
 /**
- * Platform configuration response from API
- *
- * Contains ONLY dynamic, runtime-specific values (plan-based limits).
- * Static constants (MIME types, validation rules) live as exported constants.
+ * Dynamic platform configuration returned by the /config endpoint.
+ * Contains plan-based limits that vary by account.
  */
 export interface ConfigResponse {
-  /** Maximum individual file size in bytes */
   maxFileSize: number;
-  /** Maximum number of files per deployment */
   maxFilesCount: number;
-  /** Maximum total deployment size in bytes */
   maxTotalSize: number;
 }
 
+// =============================================================================
+// EXTENSION BLOCKLIST
+// =============================================================================
+
 /**
- * Allowed MIME types for static web hosting.
- *
- * This is a static platform constant, not per-user configuration.
- * Safe to share across frontend/backend due to atomic deploys.
- *
- * Validation rules:
- * - Exact match: 'application/json' allows only 'application/json'
- * - Prefix match: 'image/' allows all image types (png, jpeg, webp, etc.)
- *
- * Coverage: 100% of browser-renderable web content
- * - Core web (HTML, CSS, JS, WASM)
- * - Media (images, audio, video, fonts)
- * - Documents (PDF, Markdown, data formats)
- * - Modern web (PWA, 3D, structured data)
+ * Blocked file extensions — files that cannot be uploaded.
  *
- * ============================================================================
- * INTENTIONALLY EXCLUDED (Security & Platform Integrity)
- * ============================================================================
+ * We accept any file type by default and derive Content-Type from the
+ * extension at serve time (via mime-db in the API worker). Unknown extensions
+ * are served as `application/octet-stream` with `X-Content-Type-Options: nosniff`.
  *
- * We are a WEB HOSTING platform, not a file distribution service.
- * GitHub Pages-style parity for renderable content, more restrictive for downloads.
- *
- * 1. EXECUTABLES (Malware Distribution)
- *    → .exe, .msi, .dmg, .deb, .rpm, .app, .apk, .jar
- *    → Reason: Direct malware delivery vector
- *    → Alternative: Use GitHub Releases or dedicated software distribution CDN
- *
- * 2. ARCHIVES (Piracy & Abuse)
- *    → .zip, .rar, .tar, .gz, .7z, .bz2
- *    → Reason: File sharing abuse, can contain executables, no web rendering
- *    → Alternative: Use file hosting service (Dropbox, Google Drive) or GitHub Releases
- *
- * 3. SERVER-SIDE SCRIPTS (Credential Leakage)
- *    → .php, .asp, .jsp, .cgi
- *    → Reason: Source code exposure (database passwords, API keys, secrets)
- *    → Alternative: Static hosting only - use serverless functions for backends
- *
- * 4. SHELL SCRIPTS (OS Execution)
- *    → .sh, .bash, .bat, .cmd, .ps1, .vbs
- *    → Reason: Execute on user's OS outside browser sandbox, social engineering risk
- *    → Alternative: Embed code examples in HTML <pre><code> or link to GitHub repo
- *
- * 5. PROGRAMMING LANGUAGE SOURCE (Platform Scope)
- *    → .py, .rb, .pl, .java, .c, .cpp, .cs, .go, .rs
- *    → Reason: Not web-renderable, better served by GitHub/GitLab/Bitbucket
- *    → Alternative: Use GitHub for code hosting, link to repository
- *
- * 6. OFFICE DOCUMENTS (Macro Malware)
- *    → .doc, .docx, .xls, .xlsx, .ppt, .pptx
- *    → Reason: Can contain VBA macros, active exploits in the wild
- *    → Alternative: Use PDF for documents (fully supported)
- *
- * 7. GENERIC BINARIES (Unvalidatable)
- *    → application/octet-stream
- *    → Reason: Too broad - allows any binary format, cannot moderate effectively
- *    → Alternative: Use specific MIME types for known formats
- *
- * ============================================================================
- * Security Model:
- * - Browser sandbox (JS/WASM execute safely in controlled environment)
- * - AI content moderation (scans text/image content for abuse)
- * - No server-side execution (static files only)
- * - Explicit allowlist (only approved formats, reject unknown)
- * ============================================================================
- */
-export const ALLOWED_MIME_TYPES = [
-  // =========================================================================
-  // TEXT CONTENT (explicit list - no prefix matching for security)
-  // =========================================================================
-
-  // Core web documents
-  'text/html',                     // HTML pages
-  'text/css',                      // Stylesheets
-  'text/plain',                    // Plain text (robots.txt, .well-known/*, LICENSE, README.txt)
-  'text/markdown',                 // Markdown files (.md)
-  '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
-  'text/x-sass',                   // Sass preprocessor
-  'text/less',                     // Less preprocessor
-  'text/x-less',                   // Less preprocessor (alternative)
-  '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)
-  // =========================================================================
-
-  // Images: PNG, JPEG, GIF, SVG, WebP, AVIF, HEIC, BMP, TIFF, ICO, etc.
-  'image/',
-
-  // Audio: MP3, OGG, WAV, WebM, AAC, FLAC, Opus, etc.
-  'audio/',
-
-  // Video: MP4, WebM, OGG, QuickTime, etc.
-  'video/',
-
-  // Modern fonts: WOFF2, WOFF, TTF, OTF
-  'font/',
-
-  // =========================================================================
-  // CORE WEB APPLICATION TYPES
-  // =========================================================================
-
-  // JavaScript (multiple MIME types for compatibility)
-  'application/javascript',        // Modern standard (RFC 9239)
-  'application/ecmascript',        // ECMAScript (legacy but still used)
-  'application/x-javascript',      // Legacy variant (old CDNs, Apache configs)
-
-  // WebAssembly (modern web apps, games, compute-heavy workloads)
-  'application/wasm',
-
-  // 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
-  'application/xml',
-  '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)
-  // =========================================================================
-
-  // glTF - Khronos standard for 3D web content
-  'model/gltf+json',               // glTF JSON format
-  'model/gltf-binary',             // GLB binary format
-
-  // =========================================================================
-  // LEGACY COMPATIBILITY
-  // =========================================================================
-
-  // Video (some tools detect MP4 as application/mp4)
-  'application/mp4',
-
-  // Legacy font MIME types (Bootstrap, Font Awesome, IE compatibility)
-  'application/font-woff',
-  'application/font-woff2',
-  'application/x-font-woff',
-  'application/x-woff',
-  'application/vnd.ms-fontobject',  // EOT files (Internet Explorer)
-  'application/x-font-ttf',
-  'application/x-font-truetype',
-  'application/x-font-otf',
-  'application/x-font-opentype',
-] as const;
-
-/**
- * Check if a MIME type is allowed for upload.
- *
- * Supports both exact matches and prefix matches:
- * - 'application/json' matches 'application/json' exactly
- * - 'text/' matches 'text/plain', 'text/html', etc.
+ * The blocklist targets file types that pose direct security risks when hosted:
+ * executables, disk images, malware vectors, dangerous scripts, and shortcuts.
+ */
+export const BLOCKED_EXTENSIONS: ReadonlySet<string> = new Set([
+  // Executables
+  'exe', 'msi', 'dll', 'scr', 'bat', 'cmd', 'com', 'pif', 'app', 'deb', 'rpm',
+  // Installers
+  'pkg', 'mpkg',
+  // Disk images
+  'dmg', 'iso', 'img',
+  // Malware vectors
+  'cab', 'cpl', 'chm',
+  // Dangerous scripts
+  'ps1', 'vbs', 'vbe', 'ws', 'wsf', 'wsc', 'wsh', 'reg',
+  // Java
+  'jar', 'jnlp',
+  // Mobile/browser packages
+  'apk', 'crx',
+  // Shortcut/link
+  'lnk', 'inf', 'hta',
+]);
+
+/**
+ * Check if a filename has a blocked extension.
+ * Extracts the extension from the filename and checks against the blocklist.
+ * Case-insensitive. Returns false for files without extensions.
  *
  * @example
- * isAllowedMimeType('text/plain')     // true (prefix match)
- * isAllowedMimeType('application/json') // true (exact match)
- * isAllowedMimeType('application/wasm') // false (not allowed)
- */
-export function isAllowedMimeType(mimeType: string): boolean {
-  return ALLOWED_MIME_TYPES.some(allowed =>
-    mimeType === allowed || mimeType.startsWith(allowed)
-  );
+ * isBlockedExtension('virus.exe')     // true
+ * isBlockedExtension('app.dmg')       // true
+ * isBlockedExtension('style.css')     // false
+ * isBlockedExtension('data.custom')   // false
+ * isBlockedExtension('README')        // false
+ */
+export function isBlockedExtension(filename: string): boolean {
+  const dotIndex = filename.lastIndexOf('.');
+  if (dotIndex === -1 || dotIndex === filename.length - 1) return false;
+  const ext = filename.slice(dotIndex + 1).toLowerCase();
+  return BLOCKED_EXTENSIONS.has(ext);
 }
 
 // =============================================================================
-// COMMON RESPONSE PATTERNS  
+// COMMON RESPONSE PATTERNS
 // =============================================================================
 
 /**
@@ -1068,8 +881,6 @@ export interface BillingStatus {
   billing: string | null;
   /** Number of billing units (1 unit = 1 custom domain), null if no billing */
   units: number | null;
-  /** Number of custom domains currently in use, null if no billing */
-  usage: number | null;
   /** Billing status from Creem (active, trialing, canceled, etc.), null if no billing */
   status: string | null;
   /** Link to Creem customer portal for billing management, null if unavailable */
@@ -1294,7 +1105,6 @@ export interface ValidationIssue {
 export interface ValidatableFile {
   name: string;
   size: number;
-  type: string;
   status?: FileValidationStatusType;
   statusMessage?: string;
 }