icore 0.1.38 → 1.0.0-alpha

package/dist/options.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeOptionsSchema = mergeOptionsSchema;
+exports.parseOptions = parseOptions;
+exports.parseOptionsDetailed = parseOptionsDetailed;
+/**
+ * Merges option schemas while preserving literal option definition types.
+ *
+ * Later schemas override earlier schemas with the same option name.
+ */
+function mergeOptionsSchema(schema, ...schemas) {
+    return Object.assign({}, schema, ...schemas);
+}
+/**
+ * Validates raw option values against a declarative option schema.
+ */
+function parseOptions(schema, values) {
+    return parseOptionsDetailed(schema, values).options;
+}
+/**
+ * Validates raw option values and returns parsed values with user-provided
+ * metadata.
+ */
+function parseOptionsDetailed(schema, values) {
+    const parsed = {};
+    const provided = {};
+    for (const name of Object.keys(values)) {
+        if (!Object.hasOwn(schema, name)) {
+            throw new Error(`Unexpected argument '--${name}'`);
+        }
+    }
+    for (const name of Object.keys(schema)) {
+        const definition = schema[name];
+        const value = values[String(name)];
+        if (definition === undefined) {
+            continue;
+        }
+        provided[name] = value !== undefined;
+        if (value === undefined) {
+            if ('default' in definition) {
+                parsed[name] = parseDefaultOptionValue(String(name), definition);
+                continue;
+            }
+            if (definition.required === true) {
+                throw new Error(`Expected required argument '--${String(name)}'`);
+            }
+            parsed[name] = undefined;
+            continue;
+        }
+        parsed[name] = parseOptionValue(String(name), definition, value);
+    }
+    return {
+        options: parsed,
+        provided: provided
+    };
+}
+function parseOptionValue(name, definition, value) {
+    if (definition.type === 'string') {
+        return parseStringOption(name, definition, value);
+    }
+    if (definition.type === 'boolean') {
+        return parseBooleanOption(name, value);
+    }
+    return parseNumberOption(name, definition, value);
+}
+function parseDefaultOptionValue(name, definition) {
+    const value = definition.default;
+    if (definition.type === 'string') {
+        if (typeof value !== 'string' || value.trim() === '') {
+            throw new Error(`Expected default for '--${name}' as string`);
+        }
+        assertChoice(name, definition.choices, value);
+        return value;
+    }
+    if (definition.type === 'boolean') {
+        if (typeof value !== 'boolean') {
+            throw new Error(`Expected default for '--${name}' as boolean`);
+        }
+        return value;
+    }
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error(`Expected default for '--${name}' as number`);
+    }
+    validateNumberConstraints(name, definition, value);
+    return value;
+}
+function parseStringOption(name, definition, value) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error(`Expected '--${name}' as string`);
+    }
+    assertChoice(name, definition.choices, value);
+    return value;
+}
+function parseBooleanOption(name, value) {
+    if (value !== true) {
+        throw new Error(`Expected '--${name}' as boolean flag`);
+    }
+    return true;
+}
+function parseNumberOption(name, definition, value) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error(`Expected '--${name}' as number`);
+    }
+    if (!/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/.test(value)) {
+        throw new Error(`Expected '--${name}' as number`);
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`Expected '--${name}' as number`);
+    }
+    validateNumberConstraints(name, definition, parsed);
+    return parsed;
+}
+function validateNumberConstraints(name, definition, parsed) {
+    if (definition.integer === true && !Number.isInteger(parsed)) {
+        throw new Error(`Expected '--${name}' as integer`);
+    }
+    if (definition.min !== undefined && parsed < definition.min) {
+        throw new Error(`Expected '--${name}' to be greater than or equal to ${String(definition.min)}`);
+    }
+    if (definition.max !== undefined && parsed > definition.max) {
+        throw new Error(`Expected '--${name}' to be less than or equal to ${String(definition.max)}`);
+    }
+    assertChoice(name, definition.choices, parsed);
+}
+function assertChoice(name, choices, value) {
+    if (choices === undefined || choices.includes(value)) {
+        return;
+    }
+    throw new Error(`Expected '--${name}' as one of: ${choices.join(', ')}`);
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

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

package/package.json

@@ -1,38 +1,43 @@
 {
   "name": "icore",
-  "version": "0.1.38",
-  "description": "High-level framework for creating strict web applications",
-  "scripts": {
-    "test": "mocha"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/woodger/icore"
-  },
+  "version": "1.0.0-alpha",
+  "description": "Build command line interface",
   "keywords": [
-    "server",
-    "router",
-    "nebbia"
+    "cli"
   ],
+  "license": "MIT",
   "author": {
     "name": "Stanislav Woodger",
     "email": "woodger@ya.ru"
   },
-  "license": "MIT",
-  "engines": {
-    "node": ">=8.12.0"
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/woodger/icore"
   },
-  "dependencies": {
-    "cookie-httponly": "^1.0.3",
-    "mime-types": "^2.1.21",
-    "type-enforcement": "^1.0.16"
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test dist/**/*.test.js",
+    "lint": "eslint src eslint.config.mjs"
+  },
+  "engines": {
+    "node": ">=20.19.0"
   },
+  "dependencies": {},
   "devDependencies": {
-    "get-port": "^5.0.0",
-    "mocha": "^6.1.4",
-    "mock-http": "^1.0.0",
-    "proxyquire": "^2.1.0",
-    "stream-mock": "^2.0.2",
-    "superagent": "^5.0.5"
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^26.0.1",
+    "eslint": "^9.39.4",
+    "globals": "^17.7.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.0"
   }
 }