@decaf-ts/integrations 0.3.4 → 0.3.6

package/lib/types/graph/nodes/triggers.d.cts

@@ -0,0 +1,53 @@
+/**
+ * @module integrations/graph/nodes/triggers
+ * @summary Production trigger node kind declarations (DECAF-32 §22.2.1).
+ * @description Canonical `@node`-decorated classes for the six ALFRED-5 trigger
+ * kinds. Triggers are metadata-only entrypoints: they define how a workflow
+ * starts and produce a trigger payload on their `@output` ports. They have no
+ * `@input` ports (nothing feeds a trigger) and no built-in executors — the
+ * engine's execution model starts from workflow inputs (§5.8) and treats
+ * trigger nodes as metadata-only entrypoints.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+/**
+ * Manual trigger — user clicks Run; input form generated from `inputSchema`.
+ */
+export declare class ManualTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Webhook trigger — HTTP request received; path/method/auth/responseMode config.
+ */
+export declare class WebhookTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Schedule trigger — cron-like schedule; timezone + payload config.
+ */
+export declare class ScheduleTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Event trigger — internal event bus topic subscriber.
+ */
+export declare class EventTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Form trigger — generated public/internal form; field definitions.
+ */
+export declare class FormTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Chat trigger — chat message entrypoint; message/sessionId/userId schema.
+ */
+export declare class ChatTriggerNode extends Model {
+    message: string;
+    sessionId: string;
+    userId: string;
+}
+/**
+ * All built-in trigger node constructors.
+ */
+export declare const GRAPH_TRIGGER_NODES: readonly [typeof ManualTriggerNode, typeof WebhookTriggerNode, typeof ScheduleTriggerNode, typeof EventTriggerNode, typeof FormTriggerNode, typeof ChatTriggerNode];

package/lib/types/graph/nodes/triggers.d.mts

@@ -0,0 +1,53 @@
+/**
+ * @module integrations/graph/nodes/triggers
+ * @summary Production trigger node kind declarations (DECAF-32 §22.2.1).
+ * @description Canonical `@node`-decorated classes for the six ALFRED-5 trigger
+ * kinds. Triggers are metadata-only entrypoints: they define how a workflow
+ * starts and produce a trigger payload on their `@output` ports. They have no
+ * `@input` ports (nothing feeds a trigger) and no built-in executors — the
+ * engine's execution model starts from workflow inputs (§5.8) and treats
+ * trigger nodes as metadata-only entrypoints.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+/**
+ * Manual trigger — user clicks Run; input form generated from `inputSchema`.
+ */
+export declare class ManualTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Webhook trigger — HTTP request received; path/method/auth/responseMode config.
+ */
+export declare class WebhookTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Schedule trigger — cron-like schedule; timezone + payload config.
+ */
+export declare class ScheduleTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Event trigger — internal event bus topic subscriber.
+ */
+export declare class EventTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Form trigger — generated public/internal form; field definitions.
+ */
+export declare class FormTriggerNode extends Model {
+    payload: unknown;
+}
+/**
+ * Chat trigger — chat message entrypoint; message/sessionId/userId schema.
+ */
+export declare class ChatTriggerNode extends Model {
+    message: string;
+    sessionId: string;
+    userId: string;
+}
+/**
+ * All built-in trigger node constructors.
+ */
+export declare const GRAPH_TRIGGER_NODES: readonly [typeof ManualTriggerNode, typeof WebhookTriggerNode, typeof ScheduleTriggerNode, typeof EventTriggerNode, typeof FormTriggerNode, typeof ChatTriggerNode];

package/lib/types/graph/types.d.cts

@@ -134,6 +134,10 @@ export interface GraphLoopMetadata {
 }
 /**
  * Definition of a condition evaluated by the loop condition evaluator.
+ *
+ * When the condition object carries an `op` field (see {@link ConditionExpression}),
+ * the {@link GraphConditionEvaluator} dispatches to the {@link ConditionExpressionEvaluator}
+ * instead of the built-in `type`-based switch.
  */
 export interface GraphConditionDefinition {
     type: "truthy" | "falsy" | "equals" | "notEquals" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "exists" | "custom";
@@ -142,6 +146,104 @@ export interface GraphConditionDefinition {
     evaluator?: string;
     metadata?: Record<string, unknown>;
 }
+/**
+ * A value reference inside a {@link ConditionExpression}.
+ *
+ * - `{ const: x }` — a literal constant.
+ * - `{ path: "a.b" }` — a dotted path resolved against the current loop state.
+ * - `{ step: "nodeId", path: "out" }` — a cross-node reference (resolved from
+ *   the execution state in v1; reserved for future multi-step evaluation).
+ */
+export type ExprValue = {
+    const: unknown;
+} | {
+    path: string;
+} | {
+    step: string;
+    path: string;
+};
+/**
+ * Declarative, serializable condition expression DSL (ALFRED-5 §8 / DECAF-32 §22.3).
+ *
+ * The engine's {@link GraphConditionEvaluator} recognises this DSL when the
+ * condition object carries an `op` field and dispatches to the
+ * {@link ConditionExpressionEvaluator}.
+ */
+export type ConditionExpression = {
+    op: "eq";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "neq";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "gt";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "gte";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "lt";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "lte";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "and";
+    conditions: ConditionExpression[];
+} | {
+    op: "or";
+    conditions: ConditionExpression[];
+} | {
+    op: "not";
+    condition: ConditionExpression;
+} | {
+    op: "exists";
+    value: ExprValue;
+};
+/**
+ * A code-based condition evaluated in a restricted VM sandbox (§22.4).
+ *
+ * The engine does NOT implement the sandbox directly — a pluggable
+ * {@link CodeSandboxEvaluator} must be registered for code conditions to work.
+ * The code must follow the same restrictions as the Code Node (§22.4):
+ * no system API access, placeholder syntax for workflow data references.
+ */
+export interface CodeCondition {
+    type: "code";
+    code: string;
+    language?: "javascript" | "typescript";
+}
+/**
+ * A condition on a Switch case — either a declarative
+ * {@link ConditionExpression} (graphical mode) or a {@link CodeCondition}
+ * (code mode).
+ */
+export type SwitchCaseCondition = ConditionExpression | CodeCondition;
+/**
+ * A single case in a Switch node.
+ *
+ * Each case pairs a condition with a dedicated output port. When the
+ * condition evaluates to `true`, the input is routed to `outputPort`.
+ */
+export interface SwitchCase {
+    id: string;
+    label: string;
+    condition: SwitchCaseCondition;
+    outputPort: string;
+}
+/**
+ * Metadata for a Switch node, stored in `metadata.switch`.
+ */
+export interface SwitchNodeMetadata {
+    cases: SwitchCase[];
+    defaultPort?: string;
+}
 /**
  * Pinning metadata attached to a node via `@pinnable()`.
  */

package/lib/types/graph/types.d.mts

@@ -134,6 +134,10 @@ export interface GraphLoopMetadata {
 }
 /**
  * Definition of a condition evaluated by the loop condition evaluator.
+ *
+ * When the condition object carries an `op` field (see {@link ConditionExpression}),
+ * the {@link GraphConditionEvaluator} dispatches to the {@link ConditionExpressionEvaluator}
+ * instead of the built-in `type`-based switch.
  */
 export interface GraphConditionDefinition {
     type: "truthy" | "falsy" | "equals" | "notEquals" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "exists" | "custom";
@@ -142,6 +146,104 @@ export interface GraphConditionDefinition {
     evaluator?: string;
     metadata?: Record<string, unknown>;
 }
+/**
+ * A value reference inside a {@link ConditionExpression}.
+ *
+ * - `{ const: x }` — a literal constant.
+ * - `{ path: "a.b" }` — a dotted path resolved against the current loop state.
+ * - `{ step: "nodeId", path: "out" }` — a cross-node reference (resolved from
+ *   the execution state in v1; reserved for future multi-step evaluation).
+ */
+export type ExprValue = {
+    const: unknown;
+} | {
+    path: string;
+} | {
+    step: string;
+    path: string;
+};
+/**
+ * Declarative, serializable condition expression DSL (ALFRED-5 §8 / DECAF-32 §22.3).
+ *
+ * The engine's {@link GraphConditionEvaluator} recognises this DSL when the
+ * condition object carries an `op` field and dispatches to the
+ * {@link ConditionExpressionEvaluator}.
+ */
+export type ConditionExpression = {
+    op: "eq";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "neq";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "gt";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "gte";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "lt";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "lte";
+    left: ExprValue;
+    right: ExprValue;
+} | {
+    op: "and";
+    conditions: ConditionExpression[];
+} | {
+    op: "or";
+    conditions: ConditionExpression[];
+} | {
+    op: "not";
+    condition: ConditionExpression;
+} | {
+    op: "exists";
+    value: ExprValue;
+};
+/**
+ * A code-based condition evaluated in a restricted VM sandbox (§22.4).
+ *
+ * The engine does NOT implement the sandbox directly — a pluggable
+ * {@link CodeSandboxEvaluator} must be registered for code conditions to work.
+ * The code must follow the same restrictions as the Code Node (§22.4):
+ * no system API access, placeholder syntax for workflow data references.
+ */
+export interface CodeCondition {
+    type: "code";
+    code: string;
+    language?: "javascript" | "typescript";
+}
+/**
+ * A condition on a Switch case — either a declarative
+ * {@link ConditionExpression} (graphical mode) or a {@link CodeCondition}
+ * (code mode).
+ */
+export type SwitchCaseCondition = ConditionExpression | CodeCondition;
+/**
+ * A single case in a Switch node.
+ *
+ * Each case pairs a condition with a dedicated output port. When the
+ * condition evaluates to `true`, the input is routed to `outputPort`.
+ */
+export interface SwitchCase {
+    id: string;
+    label: string;
+    condition: SwitchCaseCondition;
+    outputPort: string;
+}
+/**
+ * Metadata for a Switch node, stored in `metadata.switch`.
+ */
+export interface SwitchNodeMetadata {
+    cases: SwitchCase[];
+    defaultPort?: string;
+}
 /**
  * Pinning metadata attached to a node via `@pinnable()`.
  */

package/lib/types/index.d.cts

@@ -5,6 +5,6 @@
  */
 export * from "./utils.d.cts";
 export declare const VERSION: string;
-export declare const COMMIT = "b8214ff";
-export declare const FULL_VERSION = "0.3.3-b8214ff";
+export declare const COMMIT = "02ba094";
+export declare const FULL_VERSION = "0.3.5-02ba094";
 export declare const PACKAGE_NAME: string;

package/lib/types/index.d.mts

@@ -5,6 +5,6 @@
  */
 export * from "./utils.d.mts";
 export declare const VERSION: string;
-export declare const COMMIT = "b8214ff";
-export declare const FULL_VERSION = "0.3.3-b8214ff";
+export declare const COMMIT = "02ba094";
+export declare const FULL_VERSION = "0.3.5-02ba094";
 export declare const PACKAGE_NAME: string;

package/lib/types/keycloak/services/runtime.d.cts

@@ -0,0 +1,6 @@
+type ProductionResolver = () => boolean;
+export declare function setKeycloakProductionResolver(resolver: ProductionResolver): void;
+export declare function resolveKeycloakIsProduction(config?: {
+    isProduction?: () => boolean;
+}): boolean;
+export {};

package/lib/types/keycloak/services/runtime.d.mts

@@ -0,0 +1,6 @@
+type ProductionResolver = () => boolean;
+export declare function setKeycloakProductionResolver(resolver: ProductionResolver): void;
+export declare function resolveKeycloakIsProduction(config?: {
+    isProduction?: () => boolean;
+}): boolean;
+export {};

package/lib/types/kibana/services/runtime.d.cts

@@ -0,0 +1,6 @@
+type ProductionResolver = () => boolean;
+export declare function setKibanaProductionResolver(resolver: ProductionResolver): void;
+export declare function resolveKibanaIsProduction(config?: {
+    isProduction?: () => boolean;
+}): boolean;
+export {};

package/lib/types/kibana/services/runtime.d.mts

@@ -0,0 +1,6 @@
+type ProductionResolver = () => boolean;
+export declare function setKibanaProductionResolver(resolver: ProductionResolver): void;
+export declare function resolveKibanaIsProduction(config?: {
+    isProduction?: () => boolean;
+}): boolean;
+export {};

package/lib/types/nest/authService.d.cts

@@ -33,6 +33,7 @@ export declare class AuthService {
     private readonly excludedClients;
     private jwks;
     constructor(options?: AuthServiceOptions);
+    isTokenVerificationEnabled(): boolean;
     getTokenPayload(jwt: string): KeycloakAccessTokenPayload | null;
     getRoles(jwt: string): string[];
     getUser(jwt: string): KeycloakUser | undefined;

package/lib/types/nest/authService.d.mts

@@ -33,6 +33,7 @@ export declare class AuthService {
     private readonly excludedClients;
     private jwks;
     constructor(options?: AuthServiceOptions);
+    isTokenVerificationEnabled(): boolean;
     getTokenPayload(jwt: string): KeycloakAccessTokenPayload | null;
     getRoles(jwt: string): string[];
     getUser(jwt: string): KeycloakUser | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/integrations",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.mts",