unbuilt

Author: shipstatic-com

package.json

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

src/index.ts

@@ -571,6 +571,30 @@ export function isBlockedExtension(filename: string): boolean {
   return BLOCKED_EXTENSIONS.has(ext);
 }
 
+// =============================================================================
+// UNBUILT PROJECT MARKERS
+// =============================================================================
+
+/**
+ * Directory names that indicate an unbuilt project was uploaded instead of build output.
+ * Used for early detection in CLI, browser, and server validation.
+ */
+export const UNBUILT_PROJECT_MARKERS: ReadonlySet<string> = new Set([
+  'node_modules',
+]);
+
+/**
+ * Check if a file path contains an unbuilt project marker directory.
+ *
+ * @example
+ * hasUnbuiltMarker('node_modules/react/index.js')  // true
+ * hasUnbuiltMarker('dist/index.html')               // false
+ */
+export function hasUnbuiltMarker(filePath: string): boolean {
+  const segments = filePath.replace(/\\/g, '/').split('/').filter(Boolean);
+  return segments.some(s => UNBUILT_PROJECT_MARKERS.has(s));
+}
+
 // =============================================================================
 // COMMON RESPONSE PATTERNS
 // =============================================================================

tests/validation-constants.test.ts

@@ -2,6 +2,8 @@ import { describe, it, expect } from 'vitest';
 import {
   BLOCKED_EXTENSIONS,
   isBlockedExtension,
+  UNBUILT_PROJECT_MARKERS,
+  hasUnbuiltMarker,
   FileValidationStatus,
   LABEL_PATTERN,
   LABEL_CONSTRAINTS,
@@ -118,6 +120,60 @@ describe('Validation Constants - @shipstatic/types', () => {
     });
   });
 
+  describe('UNBUILT_PROJECT_MARKERS', () => {
+    it('should contain node_modules', () => {
+      expect(UNBUILT_PROJECT_MARKERS.has('node_modules')).toBe(true);
+    });
+
+    it('should NOT match partial names', () => {
+      expect(UNBUILT_PROJECT_MARKERS.has('node')).toBe(false);
+      expect(UNBUILT_PROJECT_MARKERS.has('modules')).toBe(false);
+    });
+
+    it('should be case-sensitive', () => {
+      expect(UNBUILT_PROJECT_MARKERS.has('Node_Modules')).toBe(false);
+      expect(UNBUILT_PROJECT_MARKERS.has('NODE_MODULES')).toBe(false);
+    });
+  });
+
+  describe('hasUnbuiltMarker()', () => {
+    it('should detect node_modules in paths', () => {
+      expect(hasUnbuiltMarker('node_modules/react/index.js')).toBe(true);
+      expect(hasUnbuiltMarker('project/node_modules/lodash/lodash.js')).toBe(true);
+    });
+
+    it('should detect node_modules as a standalone segment', () => {
+      expect(hasUnbuiltMarker('node_modules')).toBe(true);
+    });
+
+    it('should handle backslash paths', () => {
+      expect(hasUnbuiltMarker('project\\node_modules\\react\\index.js')).toBe(true);
+    });
+
+    it('should return false for clean build output paths', () => {
+      expect(hasUnbuiltMarker('dist/index.html')).toBe(false);
+      expect(hasUnbuiltMarker('build/static/app.js')).toBe(false);
+      expect(hasUnbuiltMarker('out/index.html')).toBe(false);
+      expect(hasUnbuiltMarker('index.html')).toBe(false);
+    });
+
+    it('should not match partial directory names', () => {
+      expect(hasUnbuiltMarker('my_node_modules_backup/file.js')).toBe(false);
+      expect(hasUnbuiltMarker('not_node_modules/file.js')).toBe(false);
+    });
+
+    it('should be case-sensitive', () => {
+      expect(hasUnbuiltMarker('Node_Modules/react/index.js')).toBe(false);
+      expect(hasUnbuiltMarker('NODE_MODULES/react/index.js')).toBe(false);
+    });
+
+    it('should handle edge cases', () => {
+      expect(hasUnbuiltMarker('')).toBe(false);
+      expect(hasUnbuiltMarker('/')).toBe(false);
+      expect(hasUnbuiltMarker('//')).toBe(false);
+    });
+  });
+
   describe('ConfigResponse', () => {
     it('should have correct shape with 3 fields', () => {
       const config: ConfigResponse = {