syncrbx 1.0.0 → 1.1.1

package/converters.js

@@ -68,6 +68,28 @@ function determineScriptType(filename) {
     return null;
 }
 
+// Class a file becomes in Studio, judged by its name alone (the file may
+// already be deleted). Returns ANY_CLASS for .model.json, whose class is inside
+// the file, and null for files SyncRbx does not sync (README.md, meta files...).
+const ANY_CLASS = '*';
+
+function classFromFileName(filename) {
+    const lower = filename.toLowerCase();
+    if (lower.endsWith('.meta.json') || lower === 'meta.json') return null;
+    if (lower.endsWith('.model.json')) return ANY_CLASS;
+    if (lower.endsWith('.remoteevent')) return 'RemoteEvent';
+    if (lower.endsWith('.remotefunction')) return 'RemoteFunction';
+    if (lower.endsWith('.bindableevent')) return 'BindableEvent';
+    if (lower.endsWith('.bindablefunction')) return 'BindableFunction';
+    if (lower.endsWith('.txt')) return 'StringValue';
+    if (lower.endsWith('.json')) return 'ModuleScript';
+    return determineScriptType(lower);
+}
+
+function isInitFile(filename) {
+    return filename.startsWith('init.') && (filename.endsWith('.lua') || filename.endsWith('.luau'));
+}
+
 // Phase 4 - #7: File checksum
 function fileChecksum(filePath) {
     try {
@@ -298,7 +320,8 @@ function instanceToFile(instanceData) {
     const name = instanceData.name || instanceData.Name || 'Untitled';
     const className = instanceData.className || instanceData.ClassName || 'Folder';
     const source = instanceData.source || (instanceData.Properties && instanceData.Properties.Source) || '';
-    const value = instanceData.value || (instanceData.Properties && instanceData.Properties.Value) || '';
+    // ?? keeps false and 0, which || would turn into ''.
+    const value = instanceData.value ?? (instanceData.Properties && instanceData.Properties.Value) ?? '';
 
     if (className === 'Folder') {
         return { fileName: name, content: null, isDirectory: true };
@@ -359,24 +382,44 @@ function filePathToInstancePath(filePath, projectRoot) {
 // ---------------------------------------------------------------------------
 // Phase 2 - #4: Project config loader
 // ---------------------------------------------------------------------------
+const PROJECT_CONFIG_FILE = 'syncrbx.project.json';
+
+// Keeps only known Roblox services, without duplicates. Returns null when the
+// value is not a list, meaning "not chosen yet".
+function sanitizeServices(services) {
+    if (!Array.isArray(services)) return null;
+    return [...new Set(services.filter(s => typeof s === 'string' && ROOT_SERVICES.includes(s)))];
+}
+
+function readProjectConfigFile(projectRoot) {
+    const configPath = path.join(projectRoot, PROJECT_CONFIG_FILE);
+    if (!fs.existsSync(configPath)) return {};
+    try {
+        return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    } catch (e) {
+        console.error(`[WARN] Error parsing ${PROJECT_CONFIG_FILE}: ${e.message}`);
+        return {};
+    }
+}
+
 function loadProjectConfig(projectRoot) {
-    const configPath = path.join(projectRoot, 'syncrbx.project.json');
     const defaults = {
         name: path.basename(projectRoot),
         port: 34872,
         ignore: ['*.conflict.bak', 'node_modules', '.git', '.vscode'],
         tree: null, // null = auto-detect from folder names
+        services: null, // null = the user has not chosen which services to sync
     };
+    const config = { ...defaults, ...readProjectConfigFile(projectRoot) };
+    config.services = sanitizeServices(config.services);
+    return config;
+}
 
-    if (fs.existsSync(configPath)) {
-        try {
-            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-            return { ...defaults, ...config };
-        } catch (e) {
-            console.error(`[WARN] Error parsing syncrbx.project.json: ${e.message}`);
-        }
-    }
-    return defaults;
+// Saves the chosen services, keeping any other settings already in the file.
+function saveProjectServices(projectRoot, services) {
+    const config = readProjectConfigFile(projectRoot);
+    config.services = services;
+    fs.writeFileSync(path.join(projectRoot, PROJECT_CONFIG_FILE), JSON.stringify(config, null, 2) + '\n', 'utf8');
 }
 
 module.exports = {
@@ -384,8 +427,11 @@ module.exports = {
     STARTER_PLAYER_CHILDREN,
     KNOWN_EXTENSIONS,
     VALUE_CLASSES,
+    ANY_CLASS,
     stripExtension,
     determineScriptType,
+    classFromFileName,
+    isInitFile,
     jsonToLuaTable,
     convertFile,
     processDirectory,
@@ -394,5 +440,8 @@ module.exports = {
     filePathToInstancePath,
     getMetaProperties,
     loadProjectConfig,
+    saveProjectServices,
+    sanitizeServices,
+    PROJECT_CONFIG_FILE,
     fileChecksum,
 };