@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/core/extensions/item-fields.js

@@ -1,262 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ce320988-b999-57c9-a786-a94ac66c5628")}catch(e){}}();
-import { normalizeItemFieldType, } from "./item-field-types.js";
-import { EXIT_CODE, ITEM_METADATA_KEY_ORDER } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-const reservedItemFieldNames = new Set(ITEM_METADATA_KEY_ORDER);
-/** Item metadata keys extension-provided fields may never shadow, exposed without mutation methods. */
-export const RESERVED_ITEM_FIELD_NAMES = Object.freeze({
-    get size() {
-        return reservedItemFieldNames.size;
-    },
-    has(value) {
-        return reservedItemFieldNames.has(value);
-    },
-    entries() {
-        return reservedItemFieldNames.entries();
-    },
-    keys() {
-        return reservedItemFieldNames.keys();
-    },
-    values() {
-        return reservedItemFieldNames.values();
-    },
-    forEach(callback, thisArg) {
-        reservedItemFieldNames.forEach((value) => callback.call(thisArg, value, value, RESERVED_ITEM_FIELD_NAMES));
-    },
-    [Symbol.iterator]() {
-        return reservedItemFieldNames.values();
-    },
-});
-function normalizeFieldName(value) {
-    if (typeof value !== "string") {
-        return null;
-    }
-    const normalized = value.trim();
-    return normalized.length > 0 ? normalized : null;
-}
-function normalizeFieldType(value) {
-    if (typeof value !== "string") {
-        return null;
-    }
-    return normalizeItemFieldType(value);
-}
-function cloneFieldValue(value) {
-    try {
-        return structuredClone(value);
-    }
-    catch {
-        return value;
-    }
-}
-function parseFieldAssignment(raw) {
-    const trimmed = raw.trim();
-    const separatorIndex = trimmed.indexOf("=");
-    if (separatorIndex <= 0) {
-        throw new PmCliError(`--field entries must use name=value syntax, received: ${raw}`, EXIT_CODE.USAGE);
-    }
-    // `separatorIndex > 0` guarantees a non-`=` first character on the already
-    // trimmed string, so the trimmed key is always non-empty here.
-    const key = trimmed.slice(0, separatorIndex).trim();
-    const value = trimmed.slice(separatorIndex + 1);
-    return { key, value };
-}
-/** Render the dedicated core CLI flag for one reserved metadata key. */
-function coreItemFieldFlag(fieldName) {
-    return `--${fieldName.replaceAll("_", "-")}`;
-}
-function parseJsonFieldValue(raw, fieldName, expectedType) {
-    try {
-        const parsed = JSON.parse(raw);
-        if (expectedType === "array" && Array.isArray(parsed)) {
-            return parsed;
-        }
-        if (expectedType === "object" &&
-            typeof parsed === "object" &&
-            parsed !== null &&
-            !Array.isArray(parsed)) {
-            return parsed;
-        }
-    }
-    catch {
-        // Fall through to the typed usage error below.
-    }
-    throw new PmCliError(`--field ${fieldName}=... must be valid JSON ${expectedType}`, EXIT_CODE.USAGE);
-}
-function coerceRegisteredFieldValue(fieldName, fieldType, raw) {
-    if (fieldType === "string") {
-        return raw;
-    }
-    if (fieldType === "number") {
-        const trimmed = raw.trim();
-        if (trimmed.length === 0) {
-            throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);
-        }
-        const parsed = Number(trimmed);
-        if (!Number.isFinite(parsed)) {
-            throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);
-        }
-        return parsed;
-    }
-    if (fieldType === "boolean") {
-        const normalized = raw.trim().toLowerCase();
-        if (normalized === "true" || normalized === "1" || normalized === "yes") {
-            return true;
-        }
-        if (normalized === "false" || normalized === "0" || normalized === "no") {
-            return false;
-        }
-        throw new PmCliError(`--field ${fieldName}=... must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);
-    }
-    if (fieldType === "string_array") {
-        return raw
-            .split(/[\n,|]/u)
-            .map((value) => value.trim())
-            .filter((value) => value.length > 0);
-    }
-    return parseJsonFieldValue(raw, fieldName, fieldType);
-}
-function collectRegisteredFieldDefinitions(registrations) {
-    const definitions = new Map();
-    if (!registrations) {
-        return definitions;
-    }
-    for (const registration of registrations.item_fields) {
-        for (const definition of registration.fields) {
-            const fieldName = normalizeFieldName(definition.name);
-            const fieldType = normalizeFieldType(definition.type);
-            if (!fieldName || !fieldType) {
-                continue;
-            }
-            const existing = definitions.get(fieldName);
-            if (existing && existing.type !== fieldType) {
-                throw new PmCliError(`Extension item field "${fieldName}" is declared with conflicting types: ${existing.type}, ${fieldType}`, EXIT_CODE.USAGE, {
-                    code: "extension_item_field_type_conflict",
-                    nextSteps: [
-                        "Make every active extension declaration for this field use the same type.",
-                    ],
-                });
-            }
-            definitions.set(fieldName, { name: fieldName, type: fieldType });
-        }
-    }
-    return definitions;
-}
-function assertNotReservedItemFieldName(fieldName) {
-    if (!RESERVED_ITEM_FIELD_NAMES.has(fieldName)) {
-        return;
-    }
-    throw new PmCliError(`Extension item field "${fieldName}" collides with built-in item metadata "${fieldName}"; rename the extension field with an extension-specific prefix. Reserved fields: ${[...RESERVED_ITEM_FIELD_NAMES].sort((left, right) => left.localeCompare(right)).join(", ")}.`, EXIT_CODE.USAGE, {
-        code: "extension_item_field_reserved",
-        nextSteps: [
-            "Rename the extension item field, preferably with an extension-specific prefix.",
-        ],
-    });
-}
-/** Implements collect registered item field names for the public runtime surface of this module. */
-export function collectRegisteredItemFieldNames(registrations) {
-    return [...collectRegisteredFieldDefinitions(registrations).keys()].sort((left, right) => left.localeCompare(right));
-}
-/** Implements parse registered item field assignments for the public runtime surface of this module. */
-export function parseRegisteredItemFieldAssignments(rawFields, registrations) {
-    if (!rawFields || rawFields.length === 0) {
-        return {};
-    }
-    const definitions = collectRegisteredFieldDefinitions(registrations);
-    const values = {};
-    for (const raw of rawFields) {
-        const { key, value } = parseFieldAssignment(raw);
-        const definition = definitions.get(key);
-        if (!definition) {
-            if (RESERVED_ITEM_FIELD_NAMES.has(key)) {
-                const flag = coreItemFieldFlag(key);
-                throw new PmCliError(`--field ${key} is a core item field, not an extension field`, EXIT_CODE.USAGE, {
-                    code: "core_item_field_requires_dedicated_flag",
-                    field: key,
-                    recovery: {
-                        provided_fields: [key],
-                        suggested_flags: [flag],
-                    },
-                    nextSteps: [
-                        `Set the core field with its dedicated flag: pm update <id> ${flag} <value>`,
-                        `When closing an item, pm close <id> also accepts ${flag} <value>.`,
-                    ],
-                });
-            }
-            const known = [...definitions.keys()].sort((left, right) => left.localeCompare(right));
-            throw new PmCliError(`--field ${key} is not declared by an active extension item-field registration`, EXIT_CODE.USAGE, {
-                code: "extension_item_field_unknown",
-                recovery: { provided_fields: known },
-                nextSteps: known.length > 0
-                    ? [`Use one of the declared fields: ${known.join(", ")}`]
-                    : [
-                        "Activate an extension that calls registerItemFields before setting extension fields.",
-                    ],
-            });
-        }
-        assertNotReservedItemFieldName(definition.name);
-        values[definition.name] = coerceRegisteredFieldValue(definition.name, definition.type, value);
-    }
-    return values;
-}
-function isValidFieldType(value, expectedType) {
-    if (expectedType === "string") {
-        return typeof value === "string";
-    }
-    if (expectedType === "number") {
-        return typeof value === "number" && Number.isFinite(value);
-    }
-    if (expectedType === "boolean") {
-        return typeof value === "boolean";
-    }
-    if (expectedType === "array") {
-        return Array.isArray(value);
-    }
-    if (expectedType === "string_array") {
-        return (Array.isArray(value) && value.every((entry) => typeof entry === "string"));
-    }
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isAllowedFieldValue(value, allowed) {
-    if (!allowed || allowed.length === 0) {
-        return true;
-    }
-    return allowed.some((candidate) => Object.is(candidate, value));
-}
-/** Implements apply registered item field defaults and validation for the public runtime surface of this module. */
-export function applyRegisteredItemFieldDefaultsAndValidation(itemMetadata, registrations, options = {}) {
-    if (!registrations) {
-        return;
-    }
-    collectRegisteredFieldDefinitions(registrations);
-    for (const registration of registrations.item_fields) {
-        for (const definition of registration.fields) {
-            const fieldName = normalizeFieldName(definition.name);
-            if (!fieldName) {
-                continue;
-            }
-            assertNotReservedItemFieldName(fieldName);
-            if (!(fieldName in itemMetadata) &&
-                !options.skipDefaultFields?.has(fieldName) &&
-                Object.prototype.hasOwnProperty.call(definition, "default")) {
-                itemMetadata[fieldName] = cloneFieldValue(definition.default);
-            }
-            const currentValue = itemMetadata[fieldName];
-            if (currentValue === undefined) {
-                continue;
-            }
-            const expectedType = normalizeFieldType(definition.type);
-            if (expectedType && !isValidFieldType(currentValue, expectedType)) {
-                throw new TypeError(`Item field "${fieldName}" must be of type ${expectedType}`);
-            }
-            const allowedValues = Array.isArray(definition.values)
-                ? definition.values
-                : undefined;
-            if (!isAllowedFieldValue(currentValue, allowedValues)) {
-                throw new TypeError(`Item field "${fieldName}" must match one of the configured allowed values`);
-            }
-        }
-    }
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="84305ac5-3641-52f5-80f2-22c0f0ae70ae")}catch(e2){}})();import{normalizeItemFieldType}from"./item-field-types.js";import{EXIT_CODE,ITEM_METADATA_KEY_ORDER}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";const reservedItemFieldNames=new Set(ITEM_METADATA_KEY_ORDER);const RESERVED_ITEM_FIELD_NAMES=Object.freeze({get size(){return reservedItemFieldNames.size},has(value){return reservedItemFieldNames.has(value)},entries(){return reservedItemFieldNames.entries()},keys(){return reservedItemFieldNames.keys()},values(){return reservedItemFieldNames.values()},forEach(callback,thisArg){reservedItemFieldNames.forEach(value=>callback.call(thisArg,value,value,RESERVED_ITEM_FIELD_NAMES))},[Symbol.iterator](){return reservedItemFieldNames.values()}});function normalizeFieldName(value){if(typeof value!=="string"){return null}const normalized=value.trim();return normalized.length>0?normalized:null}function normalizeFieldType(value){if(typeof value!=="string"){return null}return normalizeItemFieldType(value)}function cloneFieldValue(value){try{return structuredClone(value)}catch{return value}}function parseFieldAssignment(raw){const trimmed=raw.trim();const separatorIndex=trimmed.indexOf("=");if(separatorIndex<=0){throw new PmCliError(`--field entries must use name=value syntax, received: ${raw}`,EXIT_CODE.USAGE)}const key=trimmed.slice(0,separatorIndex).trim();const value=trimmed.slice(separatorIndex+1);return{key,value}}function coreItemFieldFlag(fieldName){return`--${fieldName.replaceAll("_","-")}`}function parseJsonFieldValue(raw,fieldName,expectedType){try{const parsed=JSON.parse(raw);if(expectedType==="array"&&Array.isArray(parsed)){return parsed}if(expectedType==="object"&&typeof parsed==="object"&&parsed!==null&&!Array.isArray(parsed)){return parsed}}catch{}throw new PmCliError(`--field ${fieldName}=... must be valid JSON ${expectedType}`,EXIT_CODE.USAGE)}function coerceRegisteredFieldValue(fieldName,fieldType,raw){if(fieldType==="string"){return raw}if(fieldType==="number"){const trimmed=raw.trim();if(trimmed.length===0){throw new PmCliError(`--field ${fieldName}=... must be a number`,EXIT_CODE.USAGE)}const parsed=Number(trimmed);if(!Number.isFinite(parsed)){throw new PmCliError(`--field ${fieldName}=... must be a number`,EXIT_CODE.USAGE)}return parsed}if(fieldType==="boolean"){const normalized=raw.trim().toLowerCase();if(normalized==="true"||normalized==="1"||normalized==="yes"){return true}if(normalized==="false"||normalized==="0"||normalized==="no"){return false}throw new PmCliError(`--field ${fieldName}=... must be one of true|false|1|0|yes|no`,EXIT_CODE.USAGE)}if(fieldType==="string_array"){return raw.split(/[\n,|]/u).map(value=>value.trim()).filter(value=>value.length>0)}return parseJsonFieldValue(raw,fieldName,fieldType)}function collectRegisteredFieldDefinitions(registrations){const definitions=new Map;if(!registrations){return definitions}for(const registration of registrations.item_fields){for(const definition of registration.fields){const fieldName=normalizeFieldName(definition.name);const fieldType=normalizeFieldType(definition.type);if(!fieldName||!fieldType){continue}const existing=definitions.get(fieldName);if(existing&&existing.type!==fieldType){throw new PmCliError(`Extension item field "${fieldName}" is declared with conflicting types: ${existing.type}, ${fieldType}`,EXIT_CODE.USAGE,{code:"extension_item_field_type_conflict",nextSteps:["Make every active extension declaration for this field use the same type."]})}definitions.set(fieldName,{name:fieldName,type:fieldType})}}return definitions}function assertNotReservedItemFieldName(fieldName){if(!RESERVED_ITEM_FIELD_NAMES.has(fieldName)){return}throw new PmCliError(`Extension item field "${fieldName}" collides with built-in item metadata "${fieldName}"; rename the extension field with an extension-specific prefix. Reserved fields: ${[...RESERVED_ITEM_FIELD_NAMES].sort((left,right)=>left.localeCompare(right)).join(", ")}.`,EXIT_CODE.USAGE,{code:"extension_item_field_reserved",nextSteps:["Rename the extension item field, preferably with an extension-specific prefix."]})}function collectRegisteredItemFieldNames(registrations){return[...collectRegisteredFieldDefinitions(registrations).keys()].sort((left,right)=>left.localeCompare(right))}function parseRegisteredItemFieldAssignments(rawFields,registrations){if(!rawFields||rawFields.length===0){return{}}const definitions=collectRegisteredFieldDefinitions(registrations);const values={};for(const raw of rawFields){const{key,value}=parseFieldAssignment(raw);const definition=definitions.get(key);if(!definition){if(RESERVED_ITEM_FIELD_NAMES.has(key)){const flag=coreItemFieldFlag(key);throw new PmCliError(`--field ${key} is a core item field, not an extension field`,EXIT_CODE.USAGE,{code:"core_item_field_requires_dedicated_flag",field:key,recovery:{provided_fields:[key],suggested_flags:[flag]},nextSteps:[`Set the core field with its dedicated flag: pm update <id> ${flag} <value>`,`When closing an item, pm close <id> also accepts ${flag} <value>.`]})}const known=[...definitions.keys()].sort((left,right)=>left.localeCompare(right));throw new PmCliError(`--field ${key} is not declared by an active extension item-field registration`,EXIT_CODE.USAGE,{code:"extension_item_field_unknown",recovery:{provided_fields:known},nextSteps:known.length>0?[`Use one of the declared fields: ${known.join(", ")}`]:["Activate an extension that calls registerItemFields before setting extension fields."]})}assertNotReservedItemFieldName(definition.name);values[definition.name]=coerceRegisteredFieldValue(definition.name,definition.type,value)}return values}function isValidFieldType(value,expectedType){if(expectedType==="string"){return typeof value==="string"}if(expectedType==="number"){return typeof value==="number"&&Number.isFinite(value)}if(expectedType==="boolean"){return typeof value==="boolean"}if(expectedType==="array"){return Array.isArray(value)}if(expectedType==="string_array"){return Array.isArray(value)&&value.every(entry=>typeof entry==="string")}return typeof value==="object"&&value!==null&&!Array.isArray(value)}function isAllowedFieldValue(value,allowed){if(!allowed||allowed.length===0){return true}return allowed.some(candidate=>Object.is(candidate,value))}function applyRegisteredItemFieldDefaultsAndValidation(itemMetadata,registrations,options={}){if(!registrations){return}collectRegisteredFieldDefinitions(registrations);for(const registration of registrations.item_fields){for(const definition of registration.fields){const fieldName=normalizeFieldName(definition.name);if(!fieldName){continue}assertNotReservedItemFieldName(fieldName);if(!(fieldName in itemMetadata)&&!options.skipDefaultFields?.has(fieldName)&&Object.prototype.hasOwnProperty.call(definition,"default")){itemMetadata[fieldName]=cloneFieldValue(definition.default)}const currentValue=itemMetadata[fieldName];if(currentValue===void 0){continue}const expectedType=normalizeFieldType(definition.type);if(expectedType&&!isValidFieldType(currentValue,expectedType)){throw new TypeError(`Item field "${fieldName}" must be of type ${expectedType}`)}const allowedValues=Array.isArray(definition.values)?definition.values:void 0;if(!isAllowedFieldValue(currentValue,allowedValues)){throw new TypeError(`Item field "${fieldName}" must match one of the configured allowed values`)}}}}export{RESERVED_ITEM_FIELD_NAMES,applyRegisteredItemFieldDefaultsAndValidation,collectRegisteredItemFieldNames,parseRegisteredItemFieldAssignments};
 //# sourceMappingURL=item-fields.js.map
-//# debugId=ce320988-b999-57c9-a786-a94ac66c5628