pacc 4.28.0 → 4.29.1

package/README.md

@@ -154,13 +154,16 @@ Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/G
 
 ## attributeIterator
 
-iterate over all attributes.
+Iterate over all attributes.
 
 ### Parameters
 
 *   `definition` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
+*   `filter` **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)** 
 *   `path` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>**  (optional, default `[]`)
 
+Returns **Iterable<\[[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>, [object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)]>**&#x20;
+
 ## AttributeDefinition
 
 Type: [Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)
@@ -178,6 +181,8 @@ Type: [Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Globa
 *   `default` **any?** the default value
 *   `set` **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)?** set the value
 *   `get` **[Function](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function)?** get the value can be used to calculate default values
+*   `values` **[Set](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Set)\<any>?** allowed values
+*   `externalName` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** attrubute name used by external system
 *   `env` **([Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)> | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))?** environment variable(s) used to provide the value
 
 ## default\_attribute

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pacc",
-  "version": "4.28.0",
+  "version": "4.29.1",
   "publishConfig": {
     "access": "public",
     "provenance": true

package/src/attributes.mjs

@@ -102,8 +102,11 @@ export function* writableAttributeIterator(definition) {
 }
 
 export function prepareValue(value, attribute) {
-  if (attribute?.type?.prepareValue) {
-    return attribute.type.prepareValue(value, attribute);
+  if (attribute) {
+    const prepareValue = attribute.prepareValue ?? attribute.type?.prepareValue;
+    if (prepareValue) {
+      return prepareValue(value, attribute);
+    }
   }
   return value;
 }

package/src/common-attributes.mjs

@@ -12,6 +12,8 @@
  * @property {any} [default] the default value
  * @property {Function} [set] set the value
  * @property {Function} [get] get the value can be used to calculate default values
+ * @property {Set<any>} [values] allowed values
+ * @property {string} [externalName] attrubute name used by external system
  * @property {string[]|string} [env] environment variable(s) used to provide the value
  */
 

package/src/properties.mjs

@@ -12,8 +12,9 @@ export function definePropertiesFromAttributes(
 
   for (const [path, attribute] of attributeIterator(attributes)) {
     const name = path.join(".");
+    const externalName = attribute.externalName ?? name;
 
-    let value = getAttribute(initialValues, name, attribute) ?? initialValues?.[name] ?? attribute.default;
+    let value = getAttribute(initialValues, externalName, attribute) ?? initialValues?.[externalName] ?? attribute.default;
 
     if (value !== undefined) {
       if (path.length === 1) {

package/types/common-attributes.d.mts

@@ -12,6 +12,8 @@
  * @property {any} [default] the default value
  * @property {Function} [set] set the value
  * @property {Function} [get] get the value can be used to calculate default values
+ * @property {Set<any>} [values] allowed values
+ * @property {string} [externalName] attrubute name used by external system
  * @property {string[]|string} [env] environment variable(s) used to provide the value
  */
 /**
@@ -37,6 +39,8 @@ export namespace string_collection_attribute {
     export { _default as default };
     export let set: Function;
     export let get: Function;
+    export let values: Set<any>;
+    export let externalName: string;
     export let env: string[] | string;
 }
 /**
@@ -190,6 +194,14 @@ export type AttributeDefinition = {
      * get the value can be used to calculate default values
      */
     get?: Function;
+    /**
+     * allowed values
+     */
+    values?: Set<any>;
+    /**
+     * attrubute name used by external system
+     */
+    externalName?: string;
     /**
      * environment variable(s) used to provide the value
      */