@loopstack/common 0.17.0 → 0.18.0-rc.1

package/dist/decorators/block.decorator.d.ts

@@ -1,3 +1,4 @@
+import { InjectionToken } from '@nestjs/common';
 import { z } from 'zod';
 import { BlockOptions } from '../interfaces';
 export declare const BLOCK_METADATA_KEY: unique symbol;
@@ -11,17 +12,17 @@ export interface WorkflowOptions {
     visible?: boolean;
 }
 export interface WorkflowDecoratorOptions {
-    token?: any;
+    token?: InjectionToken;
     options?: WorkflowOptions;
 }
 export declare const WORKFLOW_OPTIONS_KEY = "workflow:options";
 export declare function WithArguments<T extends z.ZodType>(schema: T): ClassDecorator;
 export declare function WithState<T extends z.ZodType>(schema: T): ClassDecorator;
 export declare function WithResult<T extends z.ZodType>(schema: T): ClassDecorator;
-export declare function getWorkflowOptions(target: any, propertyKey: string | symbol): WorkflowOptions;
+export declare function getWorkflowOptions(target: object, propertyKey: string | symbol): WorkflowOptions;
 export declare function BlockConfig(options: BlockOptions): ClassDecorator;
-export declare function Tool(token?: any): PropertyDecorator & MethodDecorator;
-export declare function Document(token?: any): PropertyDecorator & MethodDecorator;
+export declare function Tool(token?: InjectionToken): PropertyDecorator & MethodDecorator;
+export declare function Document(token?: InjectionToken): PropertyDecorator & MethodDecorator;
 export declare function Workflow(options?: WorkflowDecoratorOptions): PropertyDecorator & MethodDecorator;
 export declare function Helper(): MethodDecorator;
 export declare function Input(): PropertyDecorator;

package/dist/decorators/block.decorator.js

@@ -53,31 +53,38 @@ function WithResult(schema) {
     };
 }
 function getTools(target) {
-    const keys = Reflect.getMetadata(exports.TOOL_METADATA_KEY, target.prototype) || [];
+    const proto = target.prototype;
+    const keys = Reflect.getMetadata(exports.TOOL_METADATA_KEY, proto) ?? [];
     return keys.map((key) => String(key));
 }
 function getDocuments(target) {
-    const keys = Reflect.getMetadata(exports.DOCUMENT_METADATA_KEY, target.prototype) || [];
+    const proto = target.prototype;
+    const keys = Reflect.getMetadata(exports.DOCUMENT_METADATA_KEY, proto) ?? [];
     return keys.map((key) => String(key));
 }
 function getWorkflows(target) {
-    const keys = Reflect.getMetadata(exports.WORKFLOW_METADATA_KEY, target.prototype) || [];
+    const proto = target.prototype;
+    const keys = Reflect.getMetadata(exports.WORKFLOW_METADATA_KEY, proto) ?? [];
     return keys.map((key) => String(key));
 }
 function getHelpers(target) {
-    const keys = Reflect.getMetadata(exports.TEMPLATE_HELPER_METADATA_KEY, target.prototype) || [];
+    const proto = target.prototype;
+    const keys = Reflect.getMetadata(exports.TEMPLATE_HELPER_METADATA_KEY, proto) ?? [];
     return keys.map((key) => String(key));
 }
 function getWorkflowOptions(target, propertyKey) {
-    return Reflect.getMetadata(exports.WORKFLOW_OPTIONS_KEY, target, propertyKey) ?? { visible: true };
+    return (Reflect.getMetadata(exports.WORKFLOW_OPTIONS_KEY, target, propertyKey) ?? {
+        visible: true,
+    });
 }
 function BlockConfig(options) {
     return (target) => {
-        target.blockConfig = (0, block_config_builder_1.buildConfig)(options);
-        target.blockTools = getTools(target);
-        target.blockDocuments = getDocuments(target);
-        target.blockWorkflows = getWorkflows(target);
-        target.blockHelpers = getHelpers(target);
+        const ctor = target;
+        ctor.blockConfig = (0, block_config_builder_1.buildConfig)(options);
+        ctor.blockTools = getTools(ctor);
+        ctor.blockDocuments = getDocuments(ctor);
+        ctor.blockWorkflows = getWorkflows(ctor);
+        ctor.blockHelpers = getHelpers(ctor);
         Reflect.defineMetadata(exports.BLOCK_METADATA_KEY, options, target);
     };
 }
@@ -87,7 +94,7 @@ function Tool(token) {
         if (type) {
             (0, common_1.Inject)(type)(target, propertyKey);
         }
-        const existingTools = Reflect.getMetadata(exports.TOOL_METADATA_KEY, target) || [];
+        const existingTools = Reflect.getMetadata(exports.TOOL_METADATA_KEY, target) ?? [];
         Reflect.defineMetadata(exports.TOOL_METADATA_KEY, [...existingTools, propertyKey], target);
     };
 }
@@ -97,8 +104,8 @@ function Document(token) {
         if (type) {
             (0, common_1.Inject)(type)(target, propertyKey);
         }
-        const existingTools = Reflect.getMetadata(exports.DOCUMENT_METADATA_KEY, target) || [];
-        Reflect.defineMetadata(exports.DOCUMENT_METADATA_KEY, [...existingTools, propertyKey], target);
+        const existingDocuments = Reflect.getMetadata(exports.DOCUMENT_METADATA_KEY, target) ?? [];
+        Reflect.defineMetadata(exports.DOCUMENT_METADATA_KEY, [...existingDocuments, propertyKey], target);
     };
 }
 function Workflow(options) {
@@ -112,26 +119,26 @@ function Workflow(options) {
         if (type) {
             (0, common_1.Inject)(type)(target, propertyKey);
         }
-        const existingWorkflows = Reflect.getMetadata(exports.WORKFLOW_METADATA_KEY, target) || [];
+        const existingWorkflows = Reflect.getMetadata(exports.WORKFLOW_METADATA_KEY, target) ?? [];
         Reflect.defineMetadata(exports.WORKFLOW_METADATA_KEY, [...existingWorkflows, propertyKey], target);
         Reflect.defineMetadata(exports.WORKFLOW_OPTIONS_KEY, config, target, propertyKey);
     };
 }
 function Helper() {
     return (target, propertyKey) => {
-        const existing = Reflect.getMetadata(exports.TEMPLATE_HELPER_METADATA_KEY, target) || [];
+        const existing = Reflect.getMetadata(exports.TEMPLATE_HELPER_METADATA_KEY, target) ?? [];
         Reflect.defineMetadata(exports.TEMPLATE_HELPER_METADATA_KEY, [...existing, propertyKey], target);
     };
 }
 function Input() {
     return (target, propertyKey) => {
-        const existingInputs = Reflect.getMetadata(exports.INPUT_METADATA_KEY, target) || [];
+        const existingInputs = Reflect.getMetadata(exports.INPUT_METADATA_KEY, target) ?? [];
         Reflect.defineMetadata(exports.INPUT_METADATA_KEY, [...existingInputs, propertyKey], target);
     };
 }
 function Output() {
     return (target, propertyKey) => {
-        const existingOutputs = Reflect.getMetadata(exports.OUTPUT_METADATA_KEY, target) || [];
+        const existingOutputs = Reflect.getMetadata(exports.OUTPUT_METADATA_KEY, target) ?? [];
         Reflect.defineMetadata(exports.OUTPUT_METADATA_KEY, [...existingOutputs, propertyKey], target);
     };
 }

package/dist/decorators/capability-decorator.d.ts

@@ -1,2 +1,2 @@
 export declare const FACTORY_MODULE = "FACTORY_MODULE";
-export declare function CapabilityFactory(moduleClass: string): (target: any) => any;
+export declare function CapabilityFactory(moduleClass: string): <T extends new (...args: unknown[]) => object>(target: T) => T;

package/dist/entities/workflow.entity.d.ts

@@ -17,10 +17,10 @@ export declare class WorkflowEntity {
     updatedAt: Date;
     place: string;
     transitionResults: TransitionResultLookup | null;
-    inputData: Record<string, any>;
-    result: Record<string, any> | null;
+    inputData: Record<string, unknown>;
+    result: Record<string, unknown> | null;
     availableTransitions: WorkflowTransitionType[] | null;
-    history: any[] | null;
+    history: unknown[] | null;
     schema: JSONSchemaConfigType | null;
     error: z.ZodError | null;
     ui: UiFormType | null;

package/dist/interfaces/current-user.interface.d.ts

@@ -1,6 +1,7 @@
+import { UserTypeEnum } from '../enums';
 export interface CurrentUserInterface {
     userId: string;
-    type: string;
+    type: UserTypeEnum;
     workerId: string;
     roles: string[];
 }

package/dist/utils/normalize-deep-serialize.util.d.ts

@@ -1 +1 @@
-export declare function normalizeDeepSerializeUtil(obj: any): string;
+export declare function normalizeDeepSerializeUtil(obj: unknown): string;

package/dist/utils/normalize-deep-serialize.util.js

@@ -9,12 +9,13 @@ function normalizeDeepSerializeUtil(obj) {
         return JSON.stringify(obj.map(normalizeDeepSerializeUtil).sort());
     }
     else if (typeof obj === 'object' && obj !== null) {
-        return JSON.stringify(Object.keys(obj)
+        const record = obj;
+        return JSON.stringify(Object.keys(record)
             .sort()
             .reduce((result, key) => {
-            result[key] = normalizeDeepSerializeUtil(obj[key]); // Recursively sort nested objects
+            result[key] = normalizeDeepSerializeUtil(record[key]); // Recursively sort nested objects
             return result;
         }, {}));
     }
-    return obj?.toString();
+    return String(obj);
 }

package/dist/utils/normalize-object.d.ts

@@ -1 +1 @@
-export declare function normalizeObject(object: Record<string, any>): Record<string, any>;
+export declare function normalizeObject<T extends Record<string, unknown>>(object: T): T;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@loopstack/common",
   "displayName": "Loopstack Common Module",
   "description": "A collection of utils and dtos shared between nestjs modules",
-  "version": "0.17.0",
+  "version": "0.18.0-rc.1",
   "license": "BSL",
   "author": {
     "name": "Jakob Klippel",
@@ -11,47 +11,21 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "watch": "tsc --watch",
+    "build": "nest build",
     "compile": "tsc --noEmit",
+    "format": "prettier --write .",
     "lint": "eslint .",
-    "format": "prettier --write ."
-  },
-  "peerDependencies": {
-    "@nestjs/typeorm": "^11.0.0",
-    "typeorm": "^0.3.25"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "@nestjs/common": "^11.0.1",
-    "@nestjs/typeorm": "^11.0.0",
-    "@trivago/prettier-plugin-sort-imports": "^6.0.1",
-    "@types/node": "^22.13.4",
-    "eslint": "^9.39.1",
-    "eslint-config-prettier": "^10.1.5",
-    "eslint-plugin-prettier": "^5.4.1",
-    "globals": "^16.5.0",
-    "husky": "^9.1.7",
-    "lint-staged": "^16.2.7",
-    "prettier": "^3.7.4",
-    "typeorm": "^0.3.25",
-    "typescript": "^5.7.3",
-    "typescript-eslint": "^8.46.3"
-  },
-  "lint-staged": {
-    "*.{ts,tsx}": [
-      "eslint"
-    ],
-    "*.{json,md,css,yaml,yml}": [
-      "prettier --check"
-    ]
+    "watch": "nest build --watch"
   },
   "dependencies": {
-    "@loopstack/contracts": "^0.16.0",
+    "@loopstack/contracts": "^0.18.0-rc.1",
     "fast-json-stable-stringify": "^2.1.0",
     "murmurhash": "^2.0.1",
     "reflect-metadata": "^0.2.2",
-    "yaml": "^2.8.1",
-    "zod": "^3.25.76"
-  }
+    "yaml": "^2.8.2",
+    "zod": "^4.3.5"
+  },
+  "files": [
+    "dist"
+  ]
 }

package/.github/workflows/publish-npm.yml

@@ -1,83 +0,0 @@
-name: 'Publish to NPM Workflow'
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-
-jobs:
-  publish:
-    name: 'Build & Publish to NPM'
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    permissions:
-      contents: write
-      id-token: write
-    steps:
-      - name: Checkout Code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Check if tag is on main branch
-        run: |
-          git fetch origin main
-          if ! git branch -r --contains ${{ github.ref }} | grep -q 'origin/main'; then
-            echo "❌ Tag is not on main branch"
-            exit 1
-          fi
-          echo "✅ Tag is on main branch"
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          cache: 'npm'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Extract Package Version
-        id: package
-        run: |
-          echo "name=$(node -p "require('./package.json').name")" >> $GITHUB_OUTPUT
-          echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
-
-      - name: Validate Version Matches Tag
-        run: |
-          TAG_VERSION=${GITHUB_REF#refs/tags/v}
-          PKG_VERSION=${{ steps.package.outputs.version }}
-          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
-            echo "❌ Tag version ($TAG_VERSION) does not match package.json version ($PKG_VERSION)"
-            exit 1
-          fi
-          echo "✅ Versions match"
-
-      - name: Install Dependencies
-        run: npm ci
-
-      - name: Build Package
-        run: npm run build --if-present
-
-      - name: Publish to NPM
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        if: success()
-        with:
-          tag_name: ${{ github.ref_name }}
-          body: |
-            ## 📦 NPM Package
-
-            **Package:** [${{ steps.package.outputs.name }}](https://www.npmjs.com/package/${{ steps.package.outputs.name }}/v/${{ steps.package.outputs.version }})
-            **Version:** ${{ steps.package.outputs.version }}
-
-            Install with:
-            ```bash
-            npm install ${{ steps.package.outputs.name }}@${{ steps.package.outputs.version }}
-            ```
-          draft: false
-          prerelease: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.prettierignore

@@ -1,15 +0,0 @@
-# Build output
-dist
-
-# Dependencies
-node_modules
-
-# Lock files
-pnpm-lock.yaml
-
-# Minified files
-*.min.js
-*.min.css
-
-# Auto-generated
-src/components/ui

package/LICENSE

@@ -1,43 +0,0 @@
-Business Source License 1.1
-
-Parameters
-----------
-Licensor:             Loopstack GmbH
-Licensed Work:        Loopstack Shared Module (the "Licensed Work")
-Additional Use Grant: You may freely use, copy, modify, and distribute the Licensed Work
-                      for both personal and commercial purposes, subject to the conditions below.
-Change Date:          Four years after the release date of each version.
-Change License:       Apache License, Version 2.0
-
-Terms
------
-1. License Grant
-   The Licensed Work is made available under the terms of this Business Source License (the "License").
-   You are granted the right to use, copy, modify, and distribute the Licensed Work for any
-   personal or commercial purpose, provided that:
-
-   - You do not provide the Licensed Work to third parties as a managed or hosted service
-     where the primary value of the service is the Licensed Work itself, or a substantial
-     substitute for it.
-   - You comply with attribution requirements by including this License file with any distribution.
-
-2. Change License
-   On the Change Date, each version of the Licensed Work will automatically be
-   made available under the Change License (Apache License 2.0).
-
-3. Contributions
-   Any contributions to the Licensed Work will be licensed under the terms of this License
-   until the Change Date, and under the Change License thereafter.
-
-4. Disclaimer
-   The Licensed Work is provided "as is," without warranty of any kind, express or implied.
-
-Additional Terms
-----------------
-- This License does not grant you any rights to use the Licensor's trademarks or brand.
-- This License explicitly permits both personal and commercial use of the Licensed Work,
-  including incorporation into commercial products and services, subject to the restrictions
-  outlined in Section 1.
-
-For details on the Apache License 2.0 (effective after the Change Date), see:
-https://www.apache.org/licenses/LICENSE-2.0

package/README.md

@@ -1,7 +0,0 @@
-# Loopstack Common Module
-
-This is a submodule of the **Loopstack** framework.
-
-For full documentation, contribution guidelines, and to get started with Loopstack, please visit the main repository:
-
-👉 [github.com/loopstack-ai/loopstack](https://github.com/loopstack-ai/loopstack)

package/eslint.config.mjs

@@ -1,21 +0,0 @@
-import js from '@eslint/js';
-import prettier from 'eslint-plugin-prettier/recommended';
-import { defineConfig, globalIgnores } from 'eslint/config';
-import globals from 'globals';
-import tseslint from 'typescript-eslint';
-
-export default defineConfig([
-  globalIgnores(['dist', 'src/components/ai-elements']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [js.configs.recommended, tseslint.configs.recommended, prettier],
-    languageOptions: {
-      ecmaVersion: 2020,
-      globals: globals.browser,
-    },
-    rules: {
-      //for now we ignore this, fix later
-      '@typescript-eslint/no-explicit-any': 'off',
-    },
-  },
-]);

package/prettier.config.mjs

@@ -1,19 +0,0 @@
-export default {
-  plugins: ['@trivago/prettier-plugin-sort-imports'],
-  importOrder: [
-    '<THIRD_PARTY_MODULES>', // Imports not matched by other special phrases
-    '^@loopstack/(.*)$', // Internal packages
-    '^@/(.*)$', // Path aliases
-    '^[./]', // Relative imports
-  ],
-  importOrderSortSpecifiers: true,
-  importOrderParserPlugins: ['typescript', 'jsx', 'decorators-legacy'],
-  printWidth: 120,
-  singleQuote: true,
-  trailingComma: 'all',
-  semi: true,
-  tabWidth: 2,
-  bracketSpacing: true,
-  arrowParens: 'always',
-  endOfLine: 'lf',
-};