@lafken/common 0.14.3 → 0.15.0

package/README.md

@@ -107,7 +107,7 @@ class NotificationService {
 | ------------- | ------------------- | --------------------------------------------- |
 | `timeout`     | `number`            | Execution timeout in seconds                  |
 | `memory`      | `number`            | Memory allocation in MB                       |
-| `runtime`     | `24 \| 22 \| 20`   | Node.js runtime version                       |
+| `runtime`     | `24 \| 22`   | Node.js runtime version                       |
 | `services`    | `ServicesValues`    | IAM service permissions                       |
 | `env`         | `EnvironmentValue`  | Environment variables (static or dynamic)     |
 | `tags`        | `Record<string, string>` | Resource tags                            |

package/lib/decorators/field/field.js

@@ -76,6 +76,7 @@ const getFieldMetadata = (props) => {
             let items;
             if (arrayPrimitiveType) {
                 items = {
+                    ...fieldProps.overrideItems,
                     type: arrayPrimitiveType,
                     name: arrayPrimitiveType,
                     destinationName: arrayPrimitiveType,
@@ -110,6 +111,15 @@ const getFieldMetadata = (props) => {
         type: 'Any',
     };
 };
+/**
+ * Drops the fields resolved by `getFieldMetadata` so a decorator's own metadata
+ * can be applied last without overwriting them, along with `overrideItems`,
+ * which is a directive rather than metadata.
+ */
+const omitResolvedFields = (metadata) => {
+    const { type, name, destinationName, items, overrideItems, ...rest } = metadata;
+    return rest;
+};
 const createFieldDecorator = ({ prefix, enableInLambdaInvocation, disablePropertiesValidation, getMetadata, }) => (props) => (target, destinationName) => {
     if (!(0, build_env_utils_1.isBuildEnvironment)() && !enableInLambdaInvocation) {
         return;
@@ -117,21 +127,23 @@ const createFieldDecorator = ({ prefix, enableInLambdaInvocation, disablePropert
     const filedKey = (0, exports.createFieldName)(prefix, field_types_1.FieldProperties.field);
     const fields = (0, utils_1.getMetadataByKey)(target, filedKey) || [];
     const propertyType = Reflect.getMetadata('design:type', target, destinationName).name;
-    const parentMetadata = getMetadata(props);
+    const declaredMetadata = getMetadata(props);
+    const parentMetadata = omitResolvedFields(declaredMetadata);
     const metadata = [
         ...fields,
         {
-            ...parentMetadata,
             ...getFieldMetadata({
                 destinationName,
                 type: propertyType,
                 fieldProps: {
                     ...props,
                     type: parentMetadata.forceType ?? props?.type,
+                    overrideItems: declaredMetadata.overrideItems,
                 },
                 prefix,
                 disablePropertiesValidation,
             }),
+            ...parentMetadata,
         },
     ];
     Reflect.defineMetadata(filedKey, metadata, target);

package/lib/decorators/field/field.types.d.ts

@@ -65,12 +65,25 @@ export interface CreateFieldDecoratorProps<P extends FieldProps, M> {
     disablePropertiesValidation?: boolean;
     getMetadata: (props?: P) => Omit<M, keyof FieldMetadata> & {
         forceType?: any;
+        /**
+         * Declared metadata for the elements of an array field, forwarded to
+         * `getFieldMetadata` as `overrideItems`. The resolved element identity
+         * always wins over it.
+         */
+        overrideItems?: Record<string, unknown>;
     };
 }
 export interface GetFieldMetadataProps {
     type: string;
     prefix: string;
     destinationName: string;
-    fieldProps?: FieldProps;
+    fieldProps?: FieldProps & {
+        /**
+         * Declared metadata for the elements of an array field. Merged under the
+         * resolved element identity, which always wins, so a decorator can describe
+         * its items without overwriting the type derived from the declaration.
+         */
+        overrideItems?: Record<string, unknown>;
+    };
     disablePropertiesValidation?: boolean;
 }

package/lib/decorators/lambda/lambda.types.d.ts

@@ -115,9 +115,8 @@ export interface LambdaProps {
      * Supported values:
      * - `24` → Node.js 24
      * - `22` → Node.js 22
-     * - `20` → Node.js 20
      */
-    runtime?: 24 | 22 | 20;
+    runtime?: 24 | 22;
     /**
      * Lambda services.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lafken/common",
-  "version": "0.14.3",
+  "version": "0.15.0",
   "private": false,
   "description": "Lafken utilities - TypeScript decorator factories and metadata reflection for infrastructure-as-code decorators",
   "keywords": [
@@ -35,13 +35,13 @@
     "@swc/core": "^1.15.47",
     "@swc/helpers": "^0.5.23",
     "@vitest/runner": "^4.1.10",
-    "cdktn-vitest": "^1.0.0",
+    "@cdktn/vitest": "^0.1.0",
     "typescript": "7.0.2",
     "unplugin-swc": "^1.5.10",
     "vitest": "^4.1.10"
   },
   "engines": {
-    "node": ">=20.19"
+    "node": ">=22.13"
   },
   "publishConfig": {
     "access": "public"