@starpak/config 0.0.0-stage → 1.0.5

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024-present Spak Team
+Copyright (c) 2019-present Shigma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/index.d.ts

@@ -0,0 +1,29 @@
+export interface SpakConfig {
+    plugins: Record<string, any>;
+    cpc?: {
+        enabled?: boolean;
+        sandbox?: {
+            enabled?: boolean;
+        };
+        processIsolation?: {
+            enabled?: boolean;
+        };
+        ssetps?: {
+            enabled?: boolean;
+            /** Memory limit in MB for SSetPS RSS monitoring; 80% of this trips the warning + circuit breaker. */
+            memoryLimitMB?: number;
+        };
+    };
+}
+export declare function loadConfig(): SpakConfig;
+export declare function saveConfig(config: SpakConfig): void;
+export declare function getConfig(key: string): any;
+export declare function setConfig(key: string, value: any): SpakConfig;
+declare const _default: {
+    loadConfig: typeof loadConfig;
+    saveConfig: typeof saveConfig;
+    getConfig: typeof getConfig;
+    setConfig: typeof setConfig;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,GAAG,CAAC,EAAE;QACJ,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,OAAO,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;QAC/B,gBAAgB,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;QACxC,MAAM,CAAC,EAAE;YACP,OAAO,CAAC,EAAE,OAAO,CAAA;YACjB,qGAAqG;YACrG,aAAa,CAAC,EAAE,MAAM,CAAA;SACvB,CAAA;KACF,CAAA;CACF;AAYD,wBAAgB,UAAU,IAAI,UAAU,CAYvC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAoBnD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAS1C;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,UAAU,CAW7D;;;;;;;AAED,wBAA+D"}

package/lib/index.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.getConfig = getConfig;
+exports.setConfig = setConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const util_1 = require("@starpak/util");
+// 数据目录 = 项目源码根下的 data/（尊重 SPAK_DATA_DIR 覆盖，不写 ~/.spak）
+const CONFIG_DIR = (0, util_1.projectDataDir)();
+const CONFIG_FILE = (0, path_1.resolve)(CONFIG_DIR, 'config.json');
+const defaultConfig = {
+    plugins: {},
+};
+function ensureConfigDir() {
+    if (!(0, fs_1.existsSync)(CONFIG_DIR)) {
+        (0, fs_1.mkdirSync)(CONFIG_DIR, { recursive: true });
+    }
+}
+function loadConfig() {
+    ensureConfigDir();
+    if (!(0, fs_1.existsSync)(CONFIG_FILE)) {
+        saveConfig(defaultConfig);
+        return { ...defaultConfig };
+    }
+    try {
+        const data = (0, fs_1.readFileSync)(CONFIG_FILE, 'utf-8');
+        return { ...defaultConfig, ...JSON.parse(data) };
+    }
+    catch {
+        return { ...defaultConfig };
+    }
+}
+function saveConfig(config) {
+    ensureConfigDir();
+    // Atomic write: write to a temp file first, then rename into place.
+    // This prevents half-written JSON when the process crashes mid-write, and
+    // reduces the race window between two concurrent setConfig() calls.
+    const tmpFile = CONFIG_FILE + '.tmp.' + process.pid.toString(36);
+    try {
+        (0, fs_1.writeFileSync)(tmpFile, JSON.stringify(config, null, 2), 'utf-8');
+        // rename() is atomic on POSIX filesystems; on Windows we fallback to
+        // replace via copy+unlink if rename fails.
+        try {
+            require('fs').renameSync(tmpFile, CONFIG_FILE);
+        }
+        catch {
+            require('fs').copyFileSync(tmpFile, CONFIG_FILE);
+            require('fs').unlinkSync(tmpFile);
+        }
+    }
+    catch (err) {
+        try {
+            require('fs').unlinkSync(tmpFile);
+        }
+        catch { /* ignore */ }
+        throw err;
+    }
+}
+function getConfig(key) {
+    const config = loadConfig();
+    const parts = key.split('.');
+    let value = config;
+    for (const part of parts) {
+        if (value === undefined || value === null)
+            return undefined;
+        value = value[part];
+    }
+    return value;
+}
+function setConfig(key, value) {
+    const config = loadConfig();
+    const parts = key.split('.');
+    let obj = config;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!obj[parts[i]])
+            obj[parts[i]] = {};
+        obj = obj[parts[i]];
+    }
+    obj[parts[parts.length - 1]] = value;
+    saveConfig(config);
+    return config;
+}
+exports.default = { loadConfig, saveConfig, getConfig, setConfig };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,25 @@
 {
   "name": "@starpak/config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Spak Config - Central configuration manager",
+  "version": "1.0.5",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "author": "Spak Team",
+  "license": "MIT",
+  "dependencies": {
+    "@starpak/util": "^1.0.5"
+  }
 }

package/src/index.ts

@@ -0,0 +1,93 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs'
+import { resolve } from 'path'
+import { projectDataDir } from '@starpak/util'
+
+// 数据目录 = 项目源码根下的 data/（尊重 SPAK_DATA_DIR 覆盖，不写 ~/.spak）
+const CONFIG_DIR = projectDataDir()
+const CONFIG_FILE = resolve(CONFIG_DIR, 'config.json')
+
+export interface SpakConfig {
+  plugins: Record<string, any>
+  cpc?: {
+    enabled?: boolean
+    sandbox?: { enabled?: boolean }
+    processIsolation?: { enabled?: boolean }
+    ssetps?: {
+      enabled?: boolean
+      /** Memory limit in MB for SSetPS RSS monitoring; 80% of this trips the warning + circuit breaker. */
+      memoryLimitMB?: number
+    }
+  }
+}
+
+const defaultConfig: SpakConfig = {
+  plugins: {},
+}
+
+function ensureConfigDir() {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true })
+  }
+}
+
+export function loadConfig(): SpakConfig {
+  ensureConfigDir()
+  if (!existsSync(CONFIG_FILE)) {
+    saveConfig(defaultConfig)
+    return { ...defaultConfig }
+  }
+  try {
+    const data = readFileSync(CONFIG_FILE, 'utf-8')
+    return { ...defaultConfig, ...JSON.parse(data) }
+  } catch {
+    return { ...defaultConfig }
+  }
+}
+
+export function saveConfig(config: SpakConfig): void {
+  ensureConfigDir()
+  // Atomic write: write to a temp file first, then rename into place.
+  // This prevents half-written JSON when the process crashes mid-write, and
+  // reduces the race window between two concurrent setConfig() calls.
+  const tmpFile = CONFIG_FILE + '.tmp.' + process.pid.toString(36)
+  try {
+    writeFileSync(tmpFile, JSON.stringify(config, null, 2), 'utf-8')
+    // rename() is atomic on POSIX filesystems; on Windows we fallback to
+    // replace via copy+unlink if rename fails.
+    try {
+      require('fs').renameSync(tmpFile, CONFIG_FILE)
+    } catch {
+      require('fs').copyFileSync(tmpFile, CONFIG_FILE)
+      require('fs').unlinkSync(tmpFile)
+    }
+  } catch (err) {
+    try { require('fs').unlinkSync(tmpFile) } catch { /* ignore */ }
+    throw err
+  }
+}
+
+export function getConfig(key: string): any {
+  const config = loadConfig()
+  const parts = key.split('.')
+  let value: any = config
+  for (const part of parts) {
+    if (value === undefined || value === null) return undefined
+    value = value[part]
+  }
+  return value
+}
+
+export function setConfig(key: string, value: any): SpakConfig {
+  const config = loadConfig()
+  const parts = key.split('.')
+  let obj: any = config
+  for (let i = 0; i < parts.length - 1; i++) {
+    if (!obj[parts[i]]) obj[parts[i]] = {}
+    obj = obj[parts[i]]
+  }
+  obj[parts[parts.length - 1]] = value
+  saveConfig(config)
+  return config
+}
+
+export default { loadConfig, saveConfig, getConfig, setConfig }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.