@pie-players/pie-assessment-toolkit 0.3.24 → 0.3.26

package/dist/services/tool-config-validation.js

@@ -0,0 +1,221 @@
+import { normalizeToolsConfig, } from "./tools-config-normalizer.js";
+import { createPackagedToolRegistry } from "./createDefaultToolRegistry.js";
+const DEFAULT_STRICTNESS = "error";
+export function normalizeToolConfigStrictness(value) {
+    if (value === "off" || value === "warn" || value === "error") {
+        return value;
+    }
+    return DEFAULT_STRICTNESS;
+}
+function createDiagnostic(diagnostic) {
+    return diagnostic;
+}
+function getRegistryToolMap(toolRegistry) {
+    if (!toolRegistry)
+        return new Map();
+    return new Map(toolRegistry
+        .getAllTools()
+        .slice()
+        .sort((left, right) => left.toolId.localeCompare(right.toolId))
+        .map((tool) => [tool.toolId, tool]));
+}
+function sanitizeProviderConfig(providerId, providerConfig, tool, diagnostics) {
+    if (!providerConfig || !tool?.provider?.sanitizeConfig)
+        return providerConfig;
+    try {
+        const sanitized = tool.provider.sanitizeConfig(providerConfig);
+        if (!sanitized || typeof sanitized !== "object" || Array.isArray(sanitized)) {
+            diagnostics.push(createDiagnostic({
+                code: "tools.providerSanitizeFailed",
+                severity: "error",
+                path: `providers.${providerId}`,
+                message: `Provider sanitizer for "${providerId}" must return an object.`,
+                providerId,
+                toolId: providerId,
+            }));
+            return providerConfig;
+        }
+        return sanitized;
+    }
+    catch (error) {
+        diagnostics.push(createDiagnostic({
+            code: "tools.providerSanitizeFailed",
+            severity: "error",
+            path: `providers.${providerId}`,
+            message: `Provider sanitizer failed for "${providerId}": ${error instanceof Error ? error.message : String(error)}`,
+            providerId,
+            toolId: providerId,
+        }));
+        return providerConfig;
+    }
+}
+function validateProviderConfig(providerId, providerConfig, tool, diagnostics) {
+    if (!providerConfig || !tool?.provider?.validateConfig)
+        return;
+    try {
+        const providerDiagnostics = tool.provider.validateConfig(providerConfig);
+        if (!Array.isArray(providerDiagnostics)) {
+            diagnostics.push(createDiagnostic({
+                code: "tools.invalidProviderValidation",
+                severity: "error",
+                path: `providers.${providerId}`,
+                message: `Provider validator for "${providerId}" must return an array.`,
+                providerId,
+                toolId: providerId,
+            }));
+            return;
+        }
+        for (const diagnostic of providerDiagnostics) {
+            diagnostics.push({
+                ...diagnostic,
+                path: diagnostic.path || `providers.${providerId}`,
+                providerId: diagnostic.providerId || providerId,
+                toolId: diagnostic.toolId || providerId,
+            });
+        }
+    }
+    catch (error) {
+        diagnostics.push(createDiagnostic({
+            code: "tools.providerValidateFailed",
+            severity: "error",
+            path: `providers.${providerId}`,
+            message: `Provider validator failed for "${providerId}": ${error instanceof Error ? error.message : String(error)}`,
+            providerId,
+            toolId: providerId,
+        }));
+    }
+}
+function collectPlacementDiagnostics(config, toolMap, diagnostics) {
+    if (toolMap.size === 0)
+        return;
+    const levelOrder = ["section", "item", "passage"];
+    for (const level of levelOrder) {
+        for (const toolId of config.placement[level]) {
+            const tool = toolMap.get(toolId);
+            if (!tool) {
+                diagnostics.push(createDiagnostic({
+                    code: "tools.unknownToolId",
+                    severity: "error",
+                    path: `placement.${level}`,
+                    message: `Unknown tool id "${toolId}" in placement.${level}.`,
+                    toolId,
+                }));
+                continue;
+            }
+            if (!tool.supportedLevels.includes(level)) {
+                diagnostics.push(createDiagnostic({
+                    code: "tools.unsupportedLevel",
+                    severity: "error",
+                    path: `placement.${level}`,
+                    message: `Tool "${toolId}" does not support level "${level}".`,
+                    toolId,
+                }));
+            }
+        }
+    }
+}
+function collectPolicyDiagnostics(config, toolMap, diagnostics) {
+    if (toolMap.size === 0)
+        return;
+    for (const toolId of config.policy.allowed || []) {
+        if (toolMap.has(toolId))
+            continue;
+        diagnostics.push(createDiagnostic({
+            code: "tools.unknownToolId",
+            severity: "error",
+            path: "policy.allowed",
+            message: `Unknown tool id "${toolId}" in policy.allowed.`,
+            toolId,
+        }));
+    }
+    for (const toolId of config.policy.blocked || []) {
+        if (toolMap.has(toolId))
+            continue;
+        diagnostics.push(createDiagnostic({
+            code: "tools.unknownToolId",
+            severity: "error",
+            path: "policy.blocked",
+            message: `Unknown tool id "${toolId}" in policy.blocked.`,
+            toolId,
+        }));
+    }
+}
+function collectProviderKeyDiagnostics(config, toolMap, hasDeprecatedTtsKey, diagnostics) {
+    if (hasDeprecatedTtsKey) {
+        diagnostics.push(createDiagnostic({
+            code: "tools.deprecatedProviderKey",
+            severity: "error",
+            path: "providers.tts",
+            message: `Provider key "tts" is no longer supported. Use "providers.textToSpeech".`,
+            providerId: "tts",
+            toolId: "textToSpeech",
+        }));
+    }
+    for (const providerId of Object.keys(config.providers).sort()) {
+        if (toolMap.size === 0 || toolMap.has(providerId))
+            continue;
+        diagnostics.push(createDiagnostic({
+            code: "tools.unknownProviderKey",
+            severity: "error",
+            path: `providers.${providerId}`,
+            message: `Unknown provider key "${providerId}".`,
+            providerId,
+            toolId: providerId,
+        }));
+    }
+}
+function emitWarnings(diagnostics, source) {
+    if (diagnostics.length === 0)
+        return;
+    for (const diagnostic of diagnostics) {
+        const prefix = `[tool-config-validation:${source}]`;
+        console.warn(`${prefix} ${diagnostic.path} - ${diagnostic.message}`);
+    }
+}
+function throwValidationError(diagnostics, source) {
+    const formatted = diagnostics
+        .map((diagnostic) => `- ${diagnostic.path}: ${diagnostic.message}`)
+        .join("\n");
+    throw new Error(`[tool-config-validation:${source}] Invalid tools config:\n${formatted}`);
+}
+export function normalizeAndValidateToolsConfig(input, options = {}) {
+    const strictness = normalizeToolConfigStrictness(options.strictness);
+    const source = options.source ?? "tools";
+    const registryTools = getRegistryToolMap(options.toolRegistry ?? createPackagedToolRegistry());
+    const normalized = normalizeToolsConfig(input);
+    const diagnostics = [];
+    const hasDeprecatedTtsKey = Object.prototype.hasOwnProperty.call(normalized.providers, "tts");
+    const nextProviders = {
+        ...(normalized.providers || {}),
+    };
+    for (const providerId of Object.keys(nextProviders).sort()) {
+        if (providerId === "tts") {
+            delete nextProviders.tts;
+            continue;
+        }
+        const tool = registryTools.get(providerId);
+        nextProviders[providerId] = sanitizeProviderConfig(providerId, nextProviders[providerId], tool, diagnostics);
+        validateProviderConfig(providerId, nextProviders[providerId], tool, diagnostics);
+    }
+    const nextConfig = {
+        ...normalized,
+        providers: nextProviders,
+    };
+    collectPlacementDiagnostics(nextConfig, registryTools, diagnostics);
+    collectPolicyDiagnostics(nextConfig, registryTools, diagnostics);
+    collectProviderKeyDiagnostics(nextConfig, registryTools, hasDeprecatedTtsKey, diagnostics);
+    if (hasDeprecatedTtsKey) {
+        throwValidationError(diagnostics.filter((entry) => entry.code === "tools.deprecatedProviderKey"), source);
+    }
+    if (strictness === "warn") {
+        emitWarnings(diagnostics, source);
+    }
+    if (strictness === "error" && diagnostics.length > 0) {
+        throwValidationError(diagnostics, source);
+    }
+    return {
+        config: nextConfig,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=tool-config-validation.js.map

package/dist/services/tool-config-validation.js.map

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

package/dist/services/toolbar-items.d.ts

@@ -21,6 +21,7 @@ export interface ToolbarLinkItem extends ToolbarItemBase {
 }
 export type ToolbarItem = ToolbarButtonItem | ToolbarLinkItem;
 export declare function isToolbarLinkItem(item: ToolbarItem): item is ToolbarLinkItem;
+export declare function isValidToolbarItemShape(value: unknown): value is ToolbarItem;
 export declare function isInlineSvgIcon(icon: string | undefined): boolean;
 export declare function isExternalIconUrl(icon: string | undefined): boolean;
 //# sourceMappingURL=toolbar-items.d.ts.map

package/dist/services/toolbar-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar-items.d.ts","sourceRoot":"","sources":["../../src/services/toolbar-items.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACzD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,GAAG,CAAC,EAAE,KAAK,CAAC;CACZ;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,IAAI,eAAe,CAE5E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE"}
+{"version":3,"file":"toolbar-items.d.ts","sourceRoot":"","sources":["../../src/services/toolbar-items.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACzD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,GAAG,CAAC,EAAE,KAAK,CAAC;CACZ;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,IAAI,eAAe,CAE5E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAgB5E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE"}

package/dist/services/toolbar-items.js

@@ -1,10 +1,36 @@
 export function isToolbarLinkItem(item) {
     return typeof item.href === "string";
 }
+export function isValidToolbarItemShape(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const item = value;
+    if (typeof item.id !== "string" || item.id.trim().length === 0)
+        return false;
+    if (typeof item.label !== "string" || item.label.trim().length === 0)
+        return false;
+    if (item.ariaLabel !== undefined && typeof item.ariaLabel !== "string")
+        return false;
+    if (item.icon !== undefined && typeof item.icon !== "string")
+        return false;
+    if (item.tooltip !== undefined && typeof item.tooltip !== "string")
+        return false;
+    if (item.active !== undefined && typeof item.active !== "boolean")
+        return false;
+    if (item.disabled !== undefined && typeof item.disabled !== "boolean")
+        return false;
+    const hasHref = typeof item.href === "string";
+    const hasOnClick = typeof item.onClick === "function";
+    if (hasHref === hasOnClick)
+        return false;
+    if (hasHref)
+        return true;
+    return hasOnClick;
+}
 export function isInlineSvgIcon(icon) {
-    return typeof icon === "string" && icon.startsWith("<svg");
+    return typeof icon === "string" && icon.trimStart().startsWith("<svg");
 }
 export function isExternalIconUrl(icon) {
-    return typeof icon === "string" && icon.startsWith("http");
+    return typeof icon === "string" && icon.trimStart().startsWith("http");
 }
 //# sourceMappingURL=toolbar-items.js.map

package/dist/services/toolbar-items.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar-items.js","sourceRoot":"","sources":["../../src/services/toolbar-items.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IAClD,OAAO,OAAQ,IAAwB,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAwB;IACvD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACzD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"toolbar-items.js","sourceRoot":"","sources":["../../src/services/toolbar-items.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IAClD,OAAO,OAAQ,IAAwB,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7E,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnF,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3E,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACjF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAChF,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAEpF,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC;IACtD,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAwB;IACvD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACzD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-assessment-toolkit",
-	"version": "0.3.24",
+	"version": "0.3.26",
 	"type": "module",
 	"description": "PIE assessment toolkit: composable services + reference implementation for assessment players and tool coordination",
 	"license": "MIT",
@@ -63,15 +63,15 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@pie-players/pie-calculator": "0.3.24",
-		"@pie-players/pie-context": "0.3.24",
-		"@pie-players/pie-players-shared": "0.3.24",
-		"@pie-players/pie-tts": "0.3.24",
+		"@pie-players/pie-calculator": "0.3.26",
+		"@pie-players/pie-context": "0.3.26",
+		"@pie-players/pie-players-shared": "0.3.26",
+		"@pie-players/pie-tts": "0.3.26",
 		"svelte": "^5.54.0"
 	},
 	"peerDependencies": {
-		"@pie-players/pie-calculator-desmos": "0.3.24",
-		"@pie-players/tts-client-server": "0.3.24"
+		"@pie-players/pie-calculator-desmos": "0.3.26",
+		"@pie-players/tts-client-server": "0.3.26"
 	},
 	"peerDependenciesMeta": {
 		"@pie-players/pie-calculator-desmos": {