trigger_system 1.0.0

package/dist/node.d.ts

@@ -0,0 +1,4 @@
+export * from "./index";
+export * from "./core/persistence.node";
+export * from "./io/loader.node";
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAC;AAGxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC"}

package/dist/sdk/builder.d.ts

@@ -0,0 +1,39 @@
+import type { TriggerRule, RuleCondition, Action, ActionGroup, ComparisonOperator, ExecutionMode } from "../types";
+export declare class ConditionBuilder {
+    private conditions;
+    private op;
+    constructor(operator?: 'AND' | 'OR');
+    where(field: string, operator: ComparisonOperator, value: any): this;
+    and(sub: (builder: ConditionBuilder) => ConditionBuilder): this;
+    or(sub: (builder: ConditionBuilder) => ConditionBuilder): this;
+    build(): RuleCondition;
+}
+export declare class ActionBuilder {
+    private actions;
+    private mode;
+    setMode(mode: ExecutionMode): this;
+    add(type: string, params?: Record<string, any>, options?: {
+        delay?: number;
+        probability?: number;
+    }): this;
+    build(): Action | Action[] | ActionGroup;
+}
+export declare class RuleBuilder {
+    private rule;
+    withId(id: string): this;
+    withName(name: string): this;
+    withDescription(description: string): this;
+    withPriority(priority: number): this;
+    withCooldown(cooldown: number): this;
+    withTags(tags: string[]): this;
+    on(event: string): this;
+    if(field: string, operator: ComparisonOperator, value: any): this;
+    ifComplex(sub: (builder: ConditionBuilder) => ConditionBuilder): this;
+    do(type: string, params?: Record<string, any>, options?: {
+        delay?: number;
+        probability?: number;
+    }): this;
+    doComplex(sub: (builder: ActionBuilder) => ActionBuilder): this;
+    build(): TriggerRule;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/sdk/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/sdk/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,MAAM,EACN,WAAW,EACX,kBAAkB,EAClB,aAAa,EAGd,MAAM,UAAU,CAAC;AAElB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,EAAE,CAAuB;gBAErB,QAAQ,GAAE,KAAK,GAAG,IAAY;IAI1C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAKpE,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,gBAAgB,GAAG,IAAI;IAM/D,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,gBAAgB,GAAG,IAAI;IAM9D,KAAK,IAAI,aAAa;CAavB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,IAAI,CAAwB;IAEpC,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAKlC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IASzG,KAAK,IAAI,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW;CAgBzC;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAGV;IAEF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5B,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK1C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAK9B,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKvB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAWjE,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,gBAAgB,GAAG,IAAI;IAOrE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAcxG,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,aAAa,GAAG,IAAI;IAQ/D,KAAK,IAAI,WAAW;CAOrB"}

package/dist/sdk/exporter.d.ts

@@ -0,0 +1,13 @@
+import type { TriggerRule } from "../types";
+export declare class RuleExporter {
+    /**
+     * Converts a rule or array of rules to a YAML string.
+     */
+    static toYaml(rules: TriggerRule | TriggerRule[]): string;
+    /**
+     * For Node.js only: Saves a rule or array of rules to a file.
+     * This is part of the 'Server SDK' functionality.
+     */
+    static saveToFile(rules: TriggerRule | TriggerRule[], filePath: string): Promise<void>;
+}
+//# sourceMappingURL=exporter.d.ts.map

package/dist/sdk/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../src/sdk/exporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAI5C,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE,GAAG,MAAM;IAMzD;;;OAGG;WACU,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAY7F"}

package/dist/sdk/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./builder";
+export * from "./exporter";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Agnostic Trigger System Types
+ * Designed to be generic and extensible for any event-driven application.
+ */
+export interface RuleMetadata {
+    id: string;
+    name?: string;
+    description?: string;
+    priority?: number;
+    enabled?: boolean;
+    cooldown?: number;
+    tags?: string[];
+}
+export type ComparisonOperator = 'EQ' | '==' | 'NEQ' | '!=' | 'GT' | '>' | 'GTE' | '>=' | 'LT' | '<' | 'LTE' | '<=' | 'IN' | 'NOT_IN' | 'CONTAINS' | 'MATCHES' | 'SINCE' | 'AFTER' | 'BEFORE' | 'UNTIL' | 'RANGE';
+export interface Condition {
+    field: string;
+    operator: ComparisonOperator;
+    value: any;
+}
+export interface ConditionGroup {
+    operator: 'AND' | 'OR';
+    conditions: (Condition | ConditionGroup)[];
+}
+export type RuleCondition = Condition | ConditionGroup;
+export interface Action {
+    type: string;
+    params?: Record<string, any>;
+    delay?: number;
+    probability?: number;
+}
+export type ExecutionMode = 'ALL' | 'EITHER' | 'SEQUENCE';
+export interface ActionGroup {
+    mode: ExecutionMode;
+    actions: Action[];
+}
+export interface TriggerRule extends RuleMetadata {
+    on: string;
+    if?: RuleCondition | RuleCondition[];
+    do: Action | Action[] | ActionGroup;
+}
+export interface TriggerContext {
+    event: string;
+    timestamp: number;
+    data: Record<string, any>;
+    id?: string;
+    globals?: Record<string, any>;
+    state?: Record<string, any>;
+    helpers?: Record<string, Function>;
+}
+export interface TriggerResult {
+    ruleId: string;
+    success: boolean;
+    executedActions: {
+        type: string;
+        result?: any;
+        error?: any;
+        timestamp: number;
+    }[];
+    error?: Error;
+}
+export interface RuleEngineConfig {
+    rules: TriggerRule[];
+    globalSettings: {
+        debugMode?: boolean;
+        evaluateAll?: boolean;
+        strictActions?: boolean;
+    };
+}
+export type TriggerCondition = Condition;
+export type TriggerAction = Action;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/emitter.d.ts

@@ -0,0 +1,25 @@
+type Handler<T = any> = (data: T) => void;
+/**
+ * Enumeration of all built-in engine events.
+ * Use these constants instead of raw strings to ensure type safety.
+ */
+export declare enum EngineEvent {
+    ENGINE_START = "engine:start",
+    ENGINE_DONE = "engine:done",
+    RULE_MATCH = "rule:match",
+    ACTION_SUCCESS = "action:success",
+    ACTION_ERROR = "action:error"
+}
+export declare const engineEvents: typeof EngineEvent;
+export declare class TriggerEmitter {
+    private static instance;
+    private handlers;
+    private constructor();
+    static getInstance(): TriggerEmitter;
+    on<T = any>(event: EngineEvent | string, handler: Handler<T>): () => void;
+    off(event: EngineEvent | string, handler: Handler): void;
+    emit<T = any>(event: EngineEvent | string, data: T): void;
+}
+export declare const triggerEmitter: TriggerEmitter;
+export {};
+//# sourceMappingURL=emitter.d.ts.map

package/dist/utils/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/utils/emitter.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE1C;;;GAGG;AACH,oBAAY,WAAW;IACrB,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;CAC9B;AACD,eAAO,MAAM,YAAY,oBAAc,CAAC;AACxC,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAmC;IAEnD,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAWzE,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQxD,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;CAc1D;AAGD,eAAO,MAAM,cAAc,gBAA+B,CAAC"}

package/dist/utils/utils.d.ts

@@ -0,0 +1,18 @@
+import type { TriggerContext } from "../types";
+export declare class TriggerUtils {
+    /**
+     * Retrieves a nested value from the context using dot notation.
+     * supports: data.field, globals.envVal, computed.result
+     */
+    static getNestedValue(path: string, context: TriggerContext): any;
+    /**
+     * Interpolates a string with values from the context.
+     * Example: "Hello ${data.username}" -> "Hello Steve"
+     */
+    static interpolate(template: string, context: TriggerContext): string;
+    /**
+     * Checks if a value satisfies a comparison operator against a criteria.
+     */
+    static compare(actual: any, operator: string, criteria: any): boolean;
+}
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,qBAAa,YAAY;IACvB;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,GAAG;IAcjE;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAgBrE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO;CA2CtE"}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "trigger_system",
+  "version": "1.0.0",
+  "description": "A powerful rule engine and trigger system for JavaScript/TypeScript applications",
+  "main": "dist/node/index.js",
+  "browser": "dist/browser/index.browser.js",
+  "types": "dist/node/index.d.ts",
+  "keywords": [
+    "rule-engine",
+    "trigger-system",
+    "event-driven",
+    "stateful",
+    "typescript",
+    "yaml",
+    "automation",
+    "workflow"
+  ],
+  "author": "memelser <nglmercer@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nglmercer/trigger_system.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nglmercer/trigger_system/issues"
+  },
+  "homepage": "https://github.com/nglmercer/trigger_system#readme",
+  "exports": {
+    ".": {
+      "node": {
+        "import": "./dist/node/index.js",
+        "require": "./dist/node/index.js",
+        "types": "./dist/node/index.d.ts"
+      },
+      "browser": {
+        "import": "./dist/browser/index.browser.js",
+        "require": "./dist/browser/index.browser.js",
+        "types": "./dist/browser/index.browser.d.ts"
+      },
+      "default": "./dist/node/index.js"
+    },
+    "./node": {
+      "import": "./dist/node/node.js",
+      "require": "./dist/node/node.js",
+      "types": "./dist/node/node.d.ts"
+    },
+    "./client": {
+      "import": "./dist/browser/index.browser.js",
+      "require": "./dist/browser/index.browser.js",
+      "types": "./dist/browser/index.browser.d.ts"
+    },
+    "./browser": {
+      "import": "./dist/browser/index.browser.js",
+      "require": "./dist/browser/index.browser.js",
+      "types": "./dist/browser/index.browser.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "type-check": "tsc --noEmit",
+    "build": "bun run build:types && bun run build:node && bun run build:browser && bun run build:lsp",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:node": "bun build src/index.ts --outdir dist/node --target node --minify --sourcemap=external && bun build src/node.ts --outdir dist/node --target node --minify --sourcemap=external",
+    "build:browser": "bun build src/index.browser.ts --outdir dist/browser --target browser --minify --sourcemap=external",
+    "build:lsp": "bun build src/lsp/server.ts --outfile vscode-extension/dist/lsp/server.bundle.js --target node --minify",
+    "build:vscode": "bun build vscode-extension/src/extension.ts --outfile vscode-extension/out/extension.js --external vscode --format cjs --target node --minify",
+    "build:all": "bun run build:lsp && bun run build:vscode",
+    "package:vscode": "cd vscode-extension && vsce package",
+    "test": "bun test",
+    "validate": "bun run src/cli/validate.ts",
+    "lsp": "bun run src/lsp/server.ts --stdio",
+    "package": "bun run build:all && cd vscode-extension && vsce package",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "arktype": "^2.1.29",
+    "vscode-languageserver": "^9.0.1",
+    "vscode-languageserver-textdocument": "^1.0.12",
+    "yaml": "^2.8.2"
+  }
+}