@mearl/preset 3.0.0-beta.7 → 3.0.0-beta.9

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { PresetError, validatePreset, clonePresetDefaults } from './manifest.js';
 export { mergePresetDefaults, resolvePreset } from './resolve.js';
 export type * from './types.js';
+export { parseSetupManagement, setupManagementCommand, setupRuntimeCompatible } from './management.js';
+export type { SetupManagement } from './management.js';
 export { prepareNodeBundleSnapshot, prepareCapabilitySnapshot, verifyCapabilitySnapshot, verifyCapabilityActivation, validateCapabilityConfig, resolveCapabilityConfig, MAX_CAPABILITY_SELECTION_BYTES } from './capabilitySnapshot.js';
 export type { CapabilitySelection, CapabilitySnapshot, CapabilityActivation } from './capabilitySnapshot.js';
 export { parseToolboxCatalogs } from './toolboxCatalogs.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 export { PresetError, validatePreset, clonePresetDefaults } from './manifest.js';
 export { mergePresetDefaults, resolvePreset } from './resolve.js';
+export { parseSetupManagement, setupManagementCommand, setupRuntimeCompatible } from './management.js';
 export { prepareNodeBundleSnapshot, prepareCapabilitySnapshot, verifyCapabilitySnapshot, verifyCapabilityActivation, validateCapabilityConfig, resolveCapabilityConfig, MAX_CAPABILITY_SELECTION_BYTES } from './capabilitySnapshot.js';
 export { parseToolboxCatalogs } from './toolboxCatalogs.js';

package/dist/management.d.ts

@@ -0,0 +1,10 @@
+export interface SetupManagement {
+    package: string;
+    version: string;
+    registry?: string;
+    runtime?: string;
+}
+/** Declarative installation guidance; never accepts commands, arguments or executable hooks. */
+export declare function parseSetupManagement(value: unknown): SetupManagement | undefined;
+export declare function setupManagementCommand(setup: SetupManagement): string;
+export declare function setupRuntimeCompatible(setup: SetupManagement, version: string, targetLine?: string): boolean;

package/dist/management.js

@@ -0,0 +1,36 @@
+import { valid, validRange, satisfies, subset } from 'semver';
+import { isJsonObject, PresetError } from './manifest.js';
+/** Declarative installation guidance; never accepts commands, arguments or executable hooks. */
+export function parseSetupManagement(value) {
+    if (value === undefined)
+        return;
+    const invalid = () => { throw new PresetError('PRESET_INVALID', 'Invalid defaults.management.setup declaration'); };
+    if (!isJsonObject(value) || Object.keys(value).some(key => key !== 'setup') || !isJsonObject(value.setup))
+        return invalid();
+    const setup = value.setup;
+    if (Object.keys(setup).some(key => !['package', 'version', 'registry', 'runtime'].includes(key)) ||
+        typeof setup.package !== 'string' || setup.package.length > 214 || !/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/.test(setup.package) ||
+        typeof setup.version !== 'string' || setup.version.length > 64 || !(valid(setup.version) === setup.version || /^[a-z][a-z0-9.-]*$/.test(setup.version)))
+        return invalid();
+    if (setup.registry !== undefined) {
+        if (typeof setup.registry !== 'string' || setup.registry.length > 2048 || !/^https:\/\/[a-zA-Z0-9./:_-]+$/.test(setup.registry))
+            return invalid();
+        try {
+            const url = new URL(setup.registry);
+            if (!url.hostname || url.username || url.password || url.search || url.hash)
+                return invalid();
+        }
+        catch {
+            return invalid();
+        }
+    }
+    if (setup.runtime !== undefined && (typeof setup.runtime !== 'string' || setup.runtime.length > 128 || !validRange(setup.runtime)))
+        return invalid();
+    return { ...setup };
+}
+export function setupManagementCommand(setup) {
+    return `npx${setup.registry ? ` --registry=${setup.registry}` : ''} ${setup.package}@${setup.version}`;
+}
+export function setupRuntimeCompatible(setup, version, targetLine) {
+    return !setup.runtime || (satisfies(version, setup.runtime, { includePrerelease: true }) && (!targetLine || subset(targetLine, setup.runtime, { includePrerelease: true })));
+}

package/dist/resolve.js

@@ -1,4 +1,5 @@
 import { parseToolboxCatalogs } from './toolboxCatalogs.js';
+import { parseSetupManagement } from './management.js';
 import { satisfies, valid } from 'semver';
 import { clonePresetDefaults, isJsonObject, PresetError, validatePreset } from './manifest.js';
 const kinds = ['packages', 'skills', 'providers'];
@@ -128,6 +129,7 @@ export async function resolvePreset(source, options) {
         return result;
     };
     const result = await load(sourceUrl(source));
+    parseSetupManagement(result.defaults.management);
     const extension = result.defaults.extension;
     if (isJsonObject(extension))
         parseToolboxCatalogs(extension.toolCatalogs);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/preset",
-  "version": "3.0.0-beta.7",
+  "version": "3.0.0-beta.9",
   "description": "Browser-compatible preset validation, inheritance and capability resolution for Mearl",
   "type": "module",
   "license": "Apache-2.0",