@loopstack/common 0.14.0

package/dist/enums/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./pipeline-state.js"), exports);
+__exportStar(require("./workflow-state.enum.js"), exports);
+__exportStar(require("./user-type.enum.js"), exports);

package/dist/enums/pipeline-state.d.ts

@@ -0,0 +1,8 @@
+export declare enum PipelineState {
+    Pending = "pending",
+    Running = "running",
+    Paused = "paused",
+    Completed = "completed",
+    Failed = "failed",
+    Canceled = "canceled"
+}

package/dist/enums/pipeline-state.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineState = void 0;
+var PipelineState;
+(function (PipelineState) {
+    PipelineState["Pending"] = "pending";
+    PipelineState["Running"] = "running";
+    PipelineState["Paused"] = "paused";
+    PipelineState["Completed"] = "completed";
+    PipelineState["Failed"] = "failed";
+    PipelineState["Canceled"] = "canceled";
+})(PipelineState || (exports.PipelineState = PipelineState = {}));

package/dist/enums/user-type.enum.d.ts

@@ -0,0 +1,4 @@
+export declare enum UserTypeEnum {
+    Local = "local",
+    Cloud = "cloud"
+}

package/dist/enums/user-type.enum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserTypeEnum = void 0;
+var UserTypeEnum;
+(function (UserTypeEnum) {
+    UserTypeEnum["Local"] = "local";
+    UserTypeEnum["Cloud"] = "cloud";
+})(UserTypeEnum || (exports.UserTypeEnum = UserTypeEnum = {}));

package/dist/enums/workflow-state.enum.d.ts

@@ -0,0 +1,8 @@
+export declare enum WorkflowState {
+    Pending = "pending",
+    Running = "running",
+    Waiting = "waiting",
+    Completed = "completed",
+    Failed = "failed",
+    Canceled = "canceled"
+}

package/dist/enums/workflow-state.enum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowState = void 0;
+var WorkflowState;
+(function (WorkflowState) {
+    WorkflowState["Pending"] = "pending";
+    WorkflowState["Running"] = "running";
+    WorkflowState["Waiting"] = "waiting";
+    WorkflowState["Completed"] = "completed";
+    WorkflowState["Failed"] = "failed";
+    WorkflowState["Canceled"] = "canceled";
+})(WorkflowState || (exports.WorkflowState = WorkflowState = {}));

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+export * from './decorators/index.js';
+export * from './entities/index.js';
+export * from './enums/index.js';
+export * from './interfaces/index.js';
+export * from './utils/index.js';
+export * from './constants/index.js';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+__exportStar(require("./decorators/index.js"), exports);
+__exportStar(require("./entities/index.js"), exports);
+__exportStar(require("./enums/index.js"), exports);
+__exportStar(require("./interfaces/index.js"), exports);
+__exportStar(require("./utils/index.js"), exports);
+__exportStar(require("./constants/index.js"), exports);

package/dist/interfaces/ai-provider.interface.d.ts

@@ -0,0 +1,9 @@
+export interface AiProviderOptions {
+    apiKey: string;
+    model: string;
+    baseURL?: string;
+}
+export interface AiProviderInterface {
+    createClient(options: AiProviderOptions): any;
+    getModel(client: any, model: string): any;
+}

package/dist/interfaces/ai-provider.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/block.interface.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { Scope, Type } from '@nestjs/common';
+import type { BlockConfigType, JSONSchemaConfigType } from '@loopstack/contracts/types';
+export interface BlockOptions {
+    scope?: Scope;
+    imports?: any[];
+    config?: Partial<BlockConfigType>;
+    configFile?: string;
+    documentationFile?: string;
+    properties?: z.ZodType;
+    configSchema?: z.ZodType;
+}
+export interface BlockMetadata {
+    imports: Type<any>[];
+    config: BlockConfigType;
+    configFile?: string;
+    properties?: z.ZodType;
+    propertiesSchema?: JSONSchemaConfigType;
+    configSchema?: z.ZodType;
+    inputProperties: string[];
+    outputProperties: string[];
+}

package/dist/interfaces/block.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,6 @@
+export interface CurrentUserInterface {
+    userId: string;
+    type: string;
+    workerId: string;
+    roles: string[];
+}

package/dist/interfaces/current-user.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/handler.interface.d.ts

@@ -0,0 +1,11 @@
+import { DocumentEntity } from '../entities';
+export interface ToolSideEffects {
+    setTransitionPlace?: string;
+    addWorkflowDocuments?: DocumentEntity[];
+}
+export type HandlerCallResult = {
+    type?: 'text' | 'image' | 'file';
+    data?: any;
+    error?: string;
+    effects?: ToolSideEffects;
+};

package/dist/interfaces/handler.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/index.d.ts

@@ -0,0 +1,13 @@
+export * from './state-machine-validator.interface.js';
+export * from './handler.interface.js';
+export * from './permission.interface.js';
+export * from './role.interface.js';
+export * from './user.interface.js';
+export * from './ai-provider.interface.js';
+export * from './block.interface.js';
+export * from './transition-results.types.js';
+export * from './sso-validate-code.interface.js';
+export * from './sso-response.interface.js';
+export * from './state-machine-validator-result.interface.js';
+export * from './jwt-payload.interface.js';
+export * from './current-user.interface.js';

package/dist/interfaces/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./state-machine-validator.interface.js"), exports);
+__exportStar(require("./handler.interface.js"), exports);
+__exportStar(require("./permission.interface.js"), exports);
+__exportStar(require("./role.interface.js"), exports);
+__exportStar(require("./user.interface.js"), exports);
+__exportStar(require("./ai-provider.interface.js"), exports);
+__exportStar(require("./block.interface.js"), exports);
+__exportStar(require("./transition-results.types.js"), exports);
+__exportStar(require("./sso-validate-code.interface.js"), exports);
+__exportStar(require("./sso-response.interface.js"), exports);
+__exportStar(require("./state-machine-validator-result.interface.js"), exports);
+__exportStar(require("./jwt-payload.interface.js"), exports);
+__exportStar(require("./current-user.interface.js"), exports);

package/dist/interfaces/jwt-payload.interface.d.ts

@@ -0,0 +1,9 @@
+import { UserTypeEnum } from '../enums/user-type.enum';
+export interface JwtPayloadInterface {
+    sub: string;
+    type: UserTypeEnum;
+    workerId: string;
+    roles: string[];
+    iat?: number;
+    exp?: number;
+}

package/dist/interfaces/jwt-payload.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/permission.interface.d.ts

@@ -0,0 +1,7 @@
+export interface PermissionInterface {
+    id: string;
+    name: string;
+    resource: string;
+    action: string;
+    description?: string;
+}

package/dist/interfaces/permission.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/role.interface.d.ts

@@ -0,0 +1,7 @@
+import { PermissionInterface } from './permission.interface';
+export interface RoleInterface {
+    id: string;
+    name: string;
+    description?: string;
+    permissions: PermissionInterface[];
+}

package/dist/interfaces/role.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/sso-response.interface.d.ts

@@ -0,0 +1,24 @@
+import { UserInterface } from './user.interface';
+export interface IAuthorizationCodeResponse {
+    authCode: string;
+    expiresAt: Date;
+    expiresIn: number;
+}
+export interface IApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    message: string;
+    timestamp: Date;
+    correlationId?: string;
+}
+export interface IGenerateCodeResponse extends IApiResponse<IAuthorizationCodeResponse> {
+}
+export interface IValidateCodeResponse extends IApiResponse<UserInterface> {
+}
+export interface IErrorResponse {
+    statusCode: number;
+    message: string;
+    error: string;
+    timestamp: Date;
+    correlationId?: string;
+}

package/dist/interfaces/sso-response.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/sso-validate-code.interface.d.ts

@@ -0,0 +1,4 @@
+export interface SsoValidateCodeInterface {
+    code: string;
+    clientId: string;
+}

package/dist/interfaces/sso-validate-code.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/state-machine-validator-result.interface.d.ts

@@ -0,0 +1,4 @@
+export interface StateMachineValidatorResultInterface {
+    valid: boolean;
+    hashRecordUpdates: Record<string, string>;
+}

package/dist/interfaces/state-machine-validator-result.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/state-machine-validator.interface.d.ts

@@ -0,0 +1,8 @@
+import { WorkflowEntity } from '../entities';
+export interface StateMachineValidatorInterface {
+    validate(workflow: WorkflowEntity, args: Record<string, any> | undefined): {
+        valid: boolean;
+        target?: string;
+        hash?: string;
+    };
+}

package/dist/interfaces/state-machine-validator.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/transition-results.types.d.ts

@@ -0,0 +1,6 @@
+import { HandlerCallResult } from './handler.interface';
+export type StepResultLookup = Record<string, any>;
+export type ToolResultLookup = Record<string, HandlerCallResult>;
+export type TransitionResultLookup = Record<string, {
+    toolResults: ToolResultLookup;
+}>;

package/dist/interfaces/transition-results.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,12 @@
+import { RoleInterface } from './role.interface';
+export interface UserInterface {
+    id: string;
+    email: string;
+    password?: string;
+    firstName: string;
+    lastName: string;
+    isActive: boolean;
+    roles: RoleInterface[];
+    createdAt: Date;
+    updatedAt: Date;
+}

package/dist/interfaces/user.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/create-hash.util.d.ts

@@ -0,0 +1 @@
+export declare const createHash: (subject: any) => string;

package/dist/utils/create-hash.util.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHash = void 0;
+const murmurhash_1 = __importDefault(require("murmurhash"));
+const createHash = (subject) => {
+    const jsonString = JSON.stringify(subject);
+    return murmurhash_1.default.v3(jsonString).toString();
+};
+exports.createHash = createHash;

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './create-hash.util.js';
+export * from './normalize-deep-serialize.util.js';
+export * from './normalize-object.js';
+export * from './object-fingerprint.util.js';
+export * from './stable-json-transformer.js';

package/dist/utils/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-hash.util.js"), exports);
+__exportStar(require("./normalize-deep-serialize.util.js"), exports);
+__exportStar(require("./normalize-object.js"), exports);
+__exportStar(require("./object-fingerprint.util.js"), exports);
+__exportStar(require("./stable-json-transformer.js"), exports);

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

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

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

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeDeepSerializeUtil = normalizeDeepSerializeUtil;
+// create a normalized string representation of an object
+// that makes sure nested array and object keys are sorted
+// can be used to generate a fingerprint hash of an object
+function normalizeDeepSerializeUtil(obj) {
+    if (Array.isArray(obj)) {
+        return JSON.stringify(obj.map(normalizeDeepSerializeUtil).sort());
+    }
+    else if (typeof obj === 'object' && obj !== null) {
+        return JSON.stringify(Object.keys(obj)
+            .sort()
+            .reduce((result, key) => {
+            result[key] = normalizeDeepSerializeUtil(obj[key]); // Recursively sort nested objects
+            return result;
+        }, {}));
+    }
+    return obj?.toString();
+}

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

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

package/dist/utils/normalize-object.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeObject = normalizeObject;
+function normalizeObject(object) {
+    return object
+        ? Object.keys(object)
+            .sort()
+            .reduce((sortedObj, key) => {
+            sortedObj[key] = object[key];
+            return sortedObj;
+        }, {})
+        : {};
+}

package/dist/utils/object-fingerprint.util.d.ts

@@ -0,0 +1 @@
+export declare const generateObjectFingerprint: (obj: Record<string, any>) => string;

package/dist/utils/object-fingerprint.util.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateObjectFingerprint = void 0;
+const normalize_deep_serialize_util_1 = require("./normalize-deep-serialize.util");
+const create_hash_util_1 = require("./create-hash.util");
+const generateObjectFingerprint = (obj) => {
+    return (0, create_hash_util_1.createHash)((0, normalize_deep_serialize_util_1.normalizeDeepSerializeUtil)(obj));
+};
+exports.generateObjectFingerprint = generateObjectFingerprint;

package/dist/utils/stable-json-transformer.d.ts

@@ -0,0 +1,5 @@
+import { ValueTransformer } from 'typeorm';
+export declare class StableJsonTransformer implements ValueTransformer {
+    from(value: any): any;
+    to(value: any): any;
+}

package/dist/utils/stable-json-transformer.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StableJsonTransformer = void 0;
+const fast_json_stable_stringify_1 = __importDefault(require("fast-json-stable-stringify"));
+class StableJsonTransformer {
+    from(value) {
+        return value
+            ? typeof value === 'string'
+                ? JSON.parse(value)
+                : value
+            : value;
+    }
+    to(value) {
+        return value !== undefined ? (0, fast_json_stable_stringify_1.default)(value) : value;
+    }
+}
+exports.StableJsonTransformer = StableJsonTransformer;

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@loopstack/common",
+  "displayName": "Loopstack Common Module",
+  "description": "A collection of utils and dtos shared between nestjs modules",
+  "version": "0.14.0",
+  "license": "BSL",
+  "author": {
+    "name": "Jakob Klippel",
+    "url": "https://www.linkedin.com/in/jakob-klippel/"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "watch": "tsc --watch",
+    "prepare": "npm run build",
+    "compile": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@nestjs/typeorm": "^11.0.0",
+    "typeorm": "^0.3.25"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/typeorm": "^11.0.0",
+    "@types/node": "^22.13.4",
+    "typeorm": "^0.3.25",
+    "typescript": "^5.7.3"
+  },
+  "dependencies": {
+    "@loopstack/contracts": "^0.14.0",
+    "fast-json-stable-stringify": "^2.1.0",
+    "murmurhash": "^2.0.1",
+    "reflect-metadata": "^0.2.2",
+    "zod": "^3.25.76"
+  }
+}