@allma/core-sdk 1.0.7 → 1.0.8

package/dist/config-validator.d.ts

@@ -0,0 +1,26 @@
+import { AllmaExportFormat } from '@allma/core-types';
+/**
+ * The structured result of a validation operation.
+ */
+export type ValidationResult = {
+    success: true;
+    data: AllmaExportFormat;
+} | {
+    success: false;
+    error: {
+        formErrors: string[];
+        fieldErrors: Record<string, string[]>;
+    };
+};
+/**
+ * Validates the raw data for an import operation with detailed, item-by-item checks.
+ * This function is centralized in the SDK to be reusable by both the CDK pre-validation
+ * step and the backend importer services. It performs in-memory hydration of flows
+ * using step definitions from the same import bundle before validation.
+ *
+ * @param rawData The raw, unparsed data from the import request.
+ * @param sourceFileName Optional name of the source file for more descriptive error messages.
+ * @returns A discriminated union indicating success with parsed data, or failure with structured errors.
+ */
+export declare function validateAllmaConfig(rawData: unknown, sourceFileName?: string): ValidationResult;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../src/config-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAWlB,MAAM,mBAAmB,CAAC;AAI3B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC1C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAA;CAAE,CAAC;AAE/F;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA4G/F"}

package/dist/config-validator.js

@@ -0,0 +1,111 @@
+import { StepDefinitionSchema, FlowDefinitionSchema, PromptTemplateSchema, McpConnectionSchema, AgentSchema, } from '@allma/core-types';
+import { deepMerge } from './objectUtils.js';
+import { z } from 'zod';
+/**
+ * Validates the raw data for an import operation with detailed, item-by-item checks.
+ * This function is centralized in the SDK to be reusable by both the CDK pre-validation
+ * step and the backend importer services. It performs in-memory hydration of flows
+ * using step definitions from the same import bundle before validation.
+ *
+ * @param rawData The raw, unparsed data from the import request.
+ * @param sourceFileName Optional name of the source file for more descriptive error messages.
+ * @returns A discriminated union indicating success with parsed data, or failure with structured errors.
+ */
+export function validateAllmaConfig(rawData, sourceFileName) {
+    const filePrefix = sourceFileName ? `[${sourceFileName}] ` : '';
+    // Define a simple schema for top-level validation of the export format structure.
+    const topLevelSchema = z.object({
+        formatVersion: z.literal('1.0'),
+        exportedAt: z.string().datetime(),
+    });
+    const topLevelValidation = topLevelSchema.safeParse(rawData);
+    if (!topLevelValidation.success) {
+        return { success: false, error: topLevelValidation.error.flatten() };
+    }
+    const data = rawData;
+    const fieldErrors = {};
+    const formErrors = [];
+    // Helper to process Zod issues and build precise error paths for better feedback.
+    const processIssues = (issues, arrayName, itemIndex, itemIdentifier) => {
+        for (const issue of issues) {
+            if (issue.path.length === 0) {
+                formErrors.push(`${filePrefix}${itemIdentifier}: ${issue.message}`);
+            }
+            else {
+                const key = `${arrayName}[${itemIndex}].${issue.path.join('.')}`;
+                fieldErrors[key] = (fieldErrors[key] || []).concat(`${filePrefix}${issue.message}`);
+            }
+        }
+    };
+    // Create a map of step definitions from this import file for in-memory hydration.
+    const bundledStepMap = new Map((data.stepDefinitions || []).map(s => [s.id, s]));
+    // Validate each flow individually
+    if (data.flows && Array.isArray(data.flows)) {
+        data.flows.forEach((flow, index) => {
+            // Hydrate the flow in-memory before validation by merging referenced step definitions.
+            const hydratedFlow = JSON.parse(JSON.stringify(flow));
+            if (hydratedFlow.steps) {
+                for (const [stepId, stepInstance] of Object.entries(hydratedFlow.steps)) {
+                    if (stepInstance.stepDefinitionId) {
+                        const baseDef = bundledStepMap.get(stepInstance.stepDefinitionId);
+                        if (baseDef) {
+                            const { id, name, version, createdAt, updatedAt, ...defProps } = baseDef;
+                            const merged = deepMerge(defProps, stepInstance);
+                            hydratedFlow.steps[stepId] = merged;
+                        }
+                    }
+                }
+            }
+            const flowValidation = FlowDefinitionSchema.safeParse(hydratedFlow);
+            if (!flowValidation.success) {
+                const flowIdentifier = flow?.id ? `Flow '${flow.id}' (v${flow.version})` : `Flow at index ${index}`;
+                processIssues(flowValidation.error.issues, 'flows', index, flowIdentifier);
+            }
+        });
+    }
+    // Validate each step definition individually
+    if (data.stepDefinitions && Array.isArray(data.stepDefinitions)) {
+        data.stepDefinitions.forEach((step, index) => {
+            const stepValidation = StepDefinitionSchema.safeParse(step);
+            if (!stepValidation.success) {
+                const stepIdentifier = step?.id ? `Step Definition '${step.id}'` : `Step Definition at index ${index}`;
+                processIssues(stepValidation.error.issues, 'stepDefinitions', index, stepIdentifier);
+            }
+        });
+    }
+    // Validate each prompt template individually
+    if (data.promptTemplates && Array.isArray(data.promptTemplates)) {
+        data.promptTemplates.forEach((prompt, index) => {
+            const promptValidation = PromptTemplateSchema.safeParse(prompt);
+            if (!promptValidation.success) {
+                const promptIdentifier = prompt?.id ? `Prompt '${prompt.id}' (v${prompt.version})` : `Prompt at index ${index}`;
+                processIssues(promptValidation.error.issues, 'promptTemplates', index, promptIdentifier);
+            }
+        });
+    }
+    // Validate each MCP connection individually
+    if (data.mcpConnections && Array.isArray(data.mcpConnections)) {
+        data.mcpConnections.forEach((conn, index) => {
+            const connValidation = McpConnectionSchema.safeParse(conn);
+            if (!connValidation.success) {
+                const connIdentifier = conn?.id ? `MCP Connection '${conn.id}'` : `MCP Connection at index ${index}`;
+                processIssues(connValidation.error.issues, 'mcpConnections', index, connIdentifier);
+            }
+        });
+    }
+    // Validate each agent individually
+    if (data.agents && Array.isArray(data.agents)) {
+        data.agents.forEach((agent, index) => {
+            const agentValidation = AgentSchema.safeParse(agent);
+            if (!agentValidation.success) {
+                const agentIdentifier = agent?.id ? `Agent '${agent.id}'` : `Agent at index ${index}`;
+                processIssues(agentValidation.error.issues, 'agents', index, agentIdentifier);
+            }
+        });
+    }
+    if (formErrors.length > 0 || Object.keys(fieldErrors).length > 0) {
+        return { success: false, error: { formErrors, fieldErrors } };
+    }
+    return { success: true, data: data };
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/config-validator.js.map

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

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export * from './s3Utils.js';
 export * from './tokenEstimator.js';
 export * from './storageUtils.js';
 export * from './objectUtils.js';
+export * from './config-validator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -8,4 +8,5 @@ export * from './s3Utils.js';
 export * from './tokenEstimator.js';
 export * from './storageUtils.js';
 export * from './objectUtils.js';
+export * from './config-validator.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allma/core-sdk",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Core SDK with shared utilities (logging, auth, S3 utils) for building on the Allma serverless AI orchestration platform.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",