@decaf-ts/integrations 0.3.1 → 0.3.3

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

@@ -0,0 +1,39 @@
+/**
+ * @module integrations/graph/validation/GraphPortSchemaResolver
+ * @summary Resolves graph port definitions to Zod schemas.
+ * @description Prefers `@decaf-ts/as-zod` for model-backed ports and falls back to primitive type mapping.
+ */
+import type { GraphPortDefinition } from "@decaf-ts/ui-decorators/graph";
+/**
+ * Resolves a {@link GraphPortDefinition} to a Zod schema (or a lightweight
+ * validation function when Zod is not available).
+ *
+ * This implementation uses primitive type mapping. When the port's `model`
+ * field or underlying Decaf metadata references a `Model` class, consumers
+ * should use `modelToZod` from `@decaf-ts/as-zod` to build the schema.
+ */
+export declare class GraphPortSchemaResolver {
+    /**
+     * Resolves a single port to a schema descriptor.
+     *
+     * @returns A descriptor with the port name, a `validate` function, and
+     * optional Zod schema reference.
+     */
+    resolve(port: GraphPortDefinition): {
+        name: string;
+        required: boolean;
+        validate: (value: unknown) => boolean;
+    };
+    /**
+     * Resolves multiple ports into a map of name -> descriptor.
+     */
+    resolveAll(ports: GraphPortDefinition[]): Record<string, {
+        name: string;
+        required: boolean;
+        validate: (value: unknown) => boolean;
+    }>;
+    /**
+     * Creates a validation function based on the port's type.
+     */
+    private createValidator;
+}

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

@@ -0,0 +1,39 @@
+/**
+ * @module integrations/graph/validation/GraphPortSchemaResolver
+ * @summary Resolves graph port definitions to Zod schemas.
+ * @description Prefers `@decaf-ts/as-zod` for model-backed ports and falls back to primitive type mapping.
+ */
+import type { GraphPortDefinition } from "@decaf-ts/ui-decorators/graph";
+/**
+ * Resolves a {@link GraphPortDefinition} to a Zod schema (or a lightweight
+ * validation function when Zod is not available).
+ *
+ * This implementation uses primitive type mapping. When the port's `model`
+ * field or underlying Decaf metadata references a `Model` class, consumers
+ * should use `modelToZod` from `@decaf-ts/as-zod` to build the schema.
+ */
+export declare class GraphPortSchemaResolver {
+    /**
+     * Resolves a single port to a schema descriptor.
+     *
+     * @returns A descriptor with the port name, a `validate` function, and
+     * optional Zod schema reference.
+     */
+    resolve(port: GraphPortDefinition): {
+        name: string;
+        required: boolean;
+        validate: (value: unknown) => boolean;
+    };
+    /**
+     * Resolves multiple ports into a map of name -> descriptor.
+     */
+    resolveAll(ports: GraphPortDefinition[]): Record<string, {
+        name: string;
+        required: boolean;
+        validate: (value: unknown) => boolean;
+    }>;
+    /**
+     * Creates a validation function based on the port's type.
+     */
+    private createValidator;
+}

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

@@ -0,0 +1,27 @@
+/**
+ * @module integrations/graph/validation/GraphValueValidator
+ * @summary Validates runtime values against graph port definitions.
+ * @description Validates workflow inputs/outputs and node inputs/outputs using the schema resolver.
+ */
+import type { GraphNodeDefinition, GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { GraphPortSchemaResolver } from "./GraphPortSchemaResolver.d.cts";
+import type { GraphExecutionValues } from "../types.d.cts";
+/**
+ * Validates runtime values against port definitions.
+ */
+export declare class GraphValueValidator {
+    private readonly resolver;
+    constructor(resolver: GraphPortSchemaResolver);
+    /** Validates workflow-level input values. */
+    validateWorkflowInputs(workflow: GraphWorkflowDefinition, values: GraphExecutionValues): void;
+    /** Validates workflow-level output values. */
+    validateWorkflowOutputs(workflow: GraphWorkflowDefinition, values: GraphExecutionValues): void;
+    /** Validates a node's input values. */
+    validateNodeInputs(node: GraphNodeDefinition, values: GraphExecutionValues): void;
+    /** Validates a node's output values. */
+    validateNodeOutputs(node: GraphNodeDefinition, values: GraphExecutionValues): void;
+    /**
+     * Validates values against a set of port definitions.
+     */
+    private validatePorts;
+}

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

@@ -0,0 +1,27 @@
+/**
+ * @module integrations/graph/validation/GraphValueValidator
+ * @summary Validates runtime values against graph port definitions.
+ * @description Validates workflow inputs/outputs and node inputs/outputs using the schema resolver.
+ */
+import type { GraphNodeDefinition, GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { GraphPortSchemaResolver } from "./GraphPortSchemaResolver.d.mts";
+import type { GraphExecutionValues } from "../types.d.mts";
+/**
+ * Validates runtime values against port definitions.
+ */
+export declare class GraphValueValidator {
+    private readonly resolver;
+    constructor(resolver: GraphPortSchemaResolver);
+    /** Validates workflow-level input values. */
+    validateWorkflowInputs(workflow: GraphWorkflowDefinition, values: GraphExecutionValues): void;
+    /** Validates workflow-level output values. */
+    validateWorkflowOutputs(workflow: GraphWorkflowDefinition, values: GraphExecutionValues): void;
+    /** Validates a node's input values. */
+    validateNodeInputs(node: GraphNodeDefinition, values: GraphExecutionValues): void;
+    /** Validates a node's output values. */
+    validateNodeOutputs(node: GraphNodeDefinition, values: GraphExecutionValues): void;
+    /**
+     * Validates values against a set of port definitions.
+     */
+    private validatePorts;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * @module integrations/graph/validation
+ * @summary Graph validation utilities.
+ * @description Re-exports the definition validator, port schema resolver, and value validator.
+ */
+export * from "./GraphDefinitionValidator.d.cts";
+export * from "./GraphPortSchemaResolver.d.cts";
+export * from "./GraphValueValidator.d.cts";

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

@@ -0,0 +1,8 @@
+/**
+ * @module integrations/graph/validation
+ * @summary Graph validation utilities.
+ * @description Re-exports the definition validator, port schema resolver, and value validator.
+ */
+export * from "./GraphDefinitionValidator.d.mts";
+export * from "./GraphPortSchemaResolver.d.mts";
+export * from "./GraphValueValidator.d.mts";

package/lib/types/index.d.cts

@@ -5,6 +5,6 @@
  */
 export * from "./utils.d.cts";
 export declare const VERSION: string;
-export declare const COMMIT = "bf16ce1";
-export declare const FULL_VERSION = "0.3.0-bf16ce1";
+export declare const COMMIT = "805e7e1";
+export declare const FULL_VERSION = "0.3.2-805e7e1";
 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 = "bf16ce1";
-export declare const FULL_VERSION = "0.3.0-bf16ce1";
+export declare const COMMIT = "805e7e1";
+export declare const FULL_VERSION = "0.3.2-805e7e1";
 export declare const PACKAGE_NAME: string;

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

@@ -15,6 +15,7 @@ export declare class KeycloakService extends ClientBasedService<AxiosInstance, K
     protected identityProviderService: KeycloakIdentityProviderService;
     protected authService: KeycloakAuthService;
     constructor();
+    protected isProduction(): boolean;
     initialize(...args: MaybeContextualArg<any>): Promise<{
         config: KeycloakSetupConfig;
         client: AxiosInstance;

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

@@ -15,6 +15,7 @@ export declare class KeycloakService extends ClientBasedService<AxiosInstance, K
     protected identityProviderService: KeycloakIdentityProviderService;
     protected authService: KeycloakAuthService;
     constructor();
+    protected isProduction(): boolean;
     initialize(...args: MaybeContextualArg<any>): Promise<{
         config: KeycloakSetupConfig;
         client: AxiosInstance;

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

@@ -22,9 +22,6 @@ export interface KeycloakClientRoleConfig {
     claimValue: string;
     description?: string;
 }
-export interface ProductionAwareConfig {
-    isProduction(): boolean;
-}
 export interface KeycloakClientConfig {
     clientId: string;
     secret: string;
@@ -93,7 +90,7 @@ export interface KeycloakUserConfigOverrides {
 export interface KeycloakIdentityProviderConfigOverrides {
     payload?: Partial<Record<string, unknown>>;
 }
-export interface KeycloakSetupConfig extends ProductionAwareConfig {
+export interface KeycloakSetupConfig {
     id: string;
     host: string;
     protocol: "http" | "https";

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

@@ -22,9 +22,6 @@ export interface KeycloakClientRoleConfig {
     claimValue: string;
     description?: string;
 }
-export interface ProductionAwareConfig {
-    isProduction(): boolean;
-}
 export interface KeycloakClientConfig {
     clientId: string;
     secret: string;
@@ -93,7 +90,7 @@ export interface KeycloakUserConfigOverrides {
 export interface KeycloakIdentityProviderConfigOverrides {
     payload?: Partial<Record<string, unknown>>;
 }
-export interface KeycloakSetupConfig extends ProductionAwareConfig {
+export interface KeycloakSetupConfig {
     id: string;
     host: string;
     protocol: "http" | "https";

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

@@ -21,6 +21,7 @@ export declare class KibanaService extends ClientBasedService<AxiosInstance, Kib
     protected dashboardService: KibanaDashboardService;
     protected authService: KibanaAuthService;
     constructor();
+    protected isProduction(): boolean;
     initialize(...args: MaybeContextualArg<any>): Promise<{
         config: KibanaSetupConfig;
         client: AxiosInstance;

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

@@ -21,6 +21,7 @@ export declare class KibanaService extends ClientBasedService<AxiosInstance, Kib
     protected dashboardService: KibanaDashboardService;
     protected authService: KibanaAuthService;
     constructor();
+    protected isProduction(): boolean;
     initialize(...args: MaybeContextualArg<any>): Promise<{
         config: KibanaSetupConfig;
         client: AxiosInstance;

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

@@ -20,9 +20,6 @@ export interface KibanaSpaceConfig {
     solution?: string;
     imageUrl?: string;
 }
-export interface ProductionAwareConfig {
-    isProduction(): boolean;
-}
 /**
  * @module integrations/kibana/types
  * @summary Kibana configuration and payload types.
@@ -60,7 +57,7 @@ export interface KibanaRoleConfig {
     }>;
     metadata?: Record<string, unknown>;
 }
-export interface KibanaSetupConfig extends ProductionAwareConfig {
+export interface KibanaSetupConfig {
     id: string;
     host: string;
     es_host: string;

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

@@ -20,9 +20,6 @@ export interface KibanaSpaceConfig {
     solution?: string;
     imageUrl?: string;
 }
-export interface ProductionAwareConfig {
-    isProduction(): boolean;
-}
 /**
  * @module integrations/kibana/types
  * @summary Kibana configuration and payload types.
@@ -60,7 +57,7 @@ export interface KibanaRoleConfig {
     }>;
     metadata?: Record<string, unknown>;
 }
-export interface KibanaSetupConfig extends ProductionAwareConfig {
+export interface KibanaSetupConfig {
     id: string;
     host: string;
     es_host: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/integrations",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.mts",
@@ -202,6 +202,17 @@
         "default": "./lib/cjs/blob/memory/index.cjs"
       },
       "default": "./lib/esm/blob/memory/index.js"
+    },
+    "./graph": {
+      "import": {
+        "types": "./lib/types/graph/index.d.mts",
+        "default": "./lib/esm/graph/index.js"
+      },
+      "require": {
+        "types": "./lib/types/graph/index.d.cts",
+        "default": "./lib/cjs/graph/index.cjs"
+      },
+      "default": "./lib/esm/graph/index.js"
     }
   },
   "scripts": {
@@ -248,6 +259,7 @@
     "@decaf-ts/injectable-decorators": "latest",
     "@decaf-ts/logging": "latest",
     "@decaf-ts/transactional-decorators": "latest",
+    "@decaf-ts/ui-decorators": "latest",
     "axios": "^1.7.9",
     "node-fetch": "^3.3.2",
     "tslib": "^2.8.1",
@@ -257,7 +269,8 @@
     "@decaf-ts/cli": "latest",
     "@decaf-ts/for-http": "latest",
     "@decaf-ts/for-nano": "latest",
-    "@decaf-ts/for-nest": "0.11.2-refactor.5",
+    "@decaf-ts/as-zod": "latest",
+    "@decaf-ts/for-nest": "0.11.2-refactor.7",
     "@decaf-ts/utils": "latest",
     "@nestjs/common": "^11.0.0",
     "@nestjs/core": "^11.0.0",
@@ -272,7 +285,8 @@
   },
   "peerDependencies": {
     "@decaf-ts/for-http": "latest",
-    "@decaf-ts/for-nest": "0.11.2-refactor.5",
+    "@decaf-ts/as-zod": "latest",
+    "@decaf-ts/for-nest": "0.11.2-refactor.7",
     "jose": ">=5.0.0"
   },
   "peerDependenciesMeta": {