ochre-sdk 1.0.13 → 1.0.14

package/dist/utils.mjs

@@ -0,0 +1,172 @@
+import * as v from "valibot";
+//#region src/utils.ts
+const PSEUDO_UUID_REGEX = /^[\da-f]{8}(?:-[\da-f]{4}){3}-[\da-f]{12}$/i;
+function isRecord(value) {
+	return typeof value === "object" && value != null;
+}
+function isSchemaValidationIssue(value) {
+	if (!isRecord(value)) return false;
+	return typeof value.kind === "string" && typeof value.type === "string" && typeof value.message === "string";
+}
+function isSchemaValidationIssues(value) {
+	if (!Array.isArray(value) || value.length === 0) return false;
+	for (const item of value) if (!isSchemaValidationIssue(item)) return false;
+	return true;
+}
+function getIssuePath(issue) {
+	const path = v.getDotPath(issue);
+	return path != null && path.length > 0 ? path : "(root)";
+}
+function formatPrimitiveValue(value) {
+	if (value == null) return String(value);
+	if (typeof value === "string") return JSON.stringify(value);
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint" || typeof value === "symbol") return String(value);
+	if (value instanceof Date) return value.toISOString();
+	if (value instanceof RegExp) return String(value);
+	return null;
+}
+function appendSchemaValidationIssues(lines, issues, depth = 0, prefix = "") {
+	let index = 0;
+	for (const issue of issues) {
+		index += 1;
+		const number = prefix.length > 0 ? `${prefix}.${index}` : String(index);
+		const indent = "  ".repeat(depth);
+		lines.push(`${indent}${number}. ${getIssuePath(issue)}`, `${indent}   Message: ${issue.message}`, `${indent}   Type: ${issue.kind}:${issue.type}`);
+		if (issue.expected != null) lines.push(`${indent}   Expected: ${issue.expected}`);
+		if (issue.received.length > 0) lines.push(`${indent}   Received: ${issue.received}`);
+		const input = formatPrimitiveValue(issue.input);
+		if (input != null) lines.push(`${indent}   Input: ${input}`);
+		const requirement = formatPrimitiveValue(issue.requirement);
+		if (requirement != null) lines.push(`${indent}   Requirement: ${requirement}`);
+		if (issue.issues != null && issue.issues.length > 0) {
+			lines.push(`${indent}   Nested issues:`);
+			appendSchemaValidationIssues(lines, issue.issues, depth + 1, number);
+		}
+	}
+}
+function formatCauseValue(value) {
+	if (typeof value === "string") return value.length > 0 ? value : null;
+	const primitiveValue = formatPrimitiveValue(value);
+	if (primitiveValue != null) return primitiveValue;
+	if (Array.isArray(value)) {
+		const values = [];
+		for (const item of value) {
+			const formattedItem = typeof item === "string" && item.length > 0 ? item : formatPrimitiveValue(item);
+			if (formattedItem != null && formattedItem.length > 0) values.push(formattedItem);
+		}
+		return values.length > 0 ? values.join(", ") : null;
+	}
+	if (isRecord(value)) {
+		const values = [];
+		for (const [key, entryValue] of Object.entries(value)) {
+			const formattedEntryValue = formatPrimitiveValue(entryValue);
+			if (formattedEntryValue != null) values.push(`${key}: ${formattedEntryValue}`);
+		}
+		return values.length > 0 ? values.join("; ") : null;
+	}
+	return null;
+}
+function appendDetailedError(lines, error, fallbackMessage, depth, seenErrors) {
+	const indent = "  ".repeat(depth);
+	if (error instanceof Error) {
+		if (seenErrors.has(error)) {
+			lines.push(`${indent}Error: [Circular cause]`);
+			return;
+		}
+		seenErrors.add(error);
+		lines.push(`${indent}Error`);
+		if (error.name !== "Error") lines.push(`${indent}Name: ${error.name}`);
+		lines.push(`${indent}Message: ${error.message}`);
+		if (error instanceof AggregateError && error.errors.length > 0) {
+			lines.push("", `${indent}Contained errors`);
+			let index = 0;
+			for (const containedError of error.errors) {
+				index += 1;
+				lines.push(`${indent}${index}.`);
+				appendDetailedError(lines, containedError, "Unknown error", depth + 1, seenErrors);
+			}
+		}
+		if (error.cause != null) {
+			const causeLines = [];
+			if (appendDetailedCause(causeLines, error.cause, depth, seenErrors)) lines.push("", ...causeLines);
+		}
+		return;
+	}
+	lines.push(`${indent}Error`, `${indent}Message: ${fallbackMessage}`);
+	const value = formatCauseValue(error);
+	if (value != null) lines.push(`${indent}Value: ${value}`);
+}
+function appendDetailedCause(lines, cause, depth, seenErrors) {
+	const indent = "  ".repeat(depth);
+	if (isSchemaValidationIssues(cause)) {
+		lines.push(`${indent}Schema validation`);
+		appendSchemaValidationIssues(lines, cause, depth);
+		return true;
+	}
+	if (cause instanceof Error) {
+		lines.push(`${indent}Cause`);
+		appendDetailedError(lines, cause, cause.message, depth + 1, seenErrors);
+		return true;
+	}
+	const formattedCause = formatCauseValue(cause);
+	if (formattedCause != null) {
+		lines.push(`${indent}Cause`, `${indent}${formattedCause}`);
+		return true;
+	}
+	return false;
+}
+function getErrorMessage(error, fallbackMessage) {
+	return error instanceof Error ? error.message : fallbackMessage;
+}
+function getDetailedError(error, fallbackMessage = "Unknown error") {
+	const lines = [];
+	appendDetailedError(lines, error, fallbackMessage, 0, /* @__PURE__ */ new Set());
+	return lines.join("\n");
+}
+function getErrorOutput(error, fallbackMessage) {
+	const message = getErrorMessage(error, fallbackMessage);
+	return {
+		error: message,
+		detailedError: getDetailedError(error, message)
+	};
+}
+function createSchemaValidationError(message, issues) {
+	return new Error(message, { cause: issues });
+}
+/**
+* Validates a pseudo-UUID string
+* @param value - The string to validate
+* @returns True if the string is a valid pseudo-UUID, false otherwise
+* @internal
+*/
+function isPseudoUuid(value) {
+	return PSEUDO_UUID_REGEX.test(value);
+}
+/**
+* Build a string literal for an XQuery string
+* @param value - The string value to escape
+* @returns The escaped string literal
+*/
+function stringLiteral(value) {
+	return `"${value.replaceAll("\"", "\"\"")}"`;
+}
+/**
+* Flatten a properties array
+* @param properties - The properties to flatten
+* @returns The flattened properties
+* @internal
+*/
+function flattenProperties(properties) {
+	const result = [];
+	for (const property of properties) {
+		result.push({
+			variable: property.variable,
+			values: property.values,
+			comment: property.comment
+		});
+		if ("properties" in property) result.push(...flattenProperties(property.properties));
+	}
+	return result;
+}
+//#endregion
+export { createSchemaValidationError, flattenProperties, getDetailedError, getErrorMessage, getErrorOutput, isPseudoUuid, stringLiteral };

package/dist/xml/metadata.d.mts

@@ -0,0 +1,5 @@
+//#region src/xml/metadata.d.ts
+declare function getXMLSourceIndex(value: unknown): number | null;
+declare function restoreXMLMetadata(output: unknown, input: unknown): void;
+//#endregion
+export { getXMLSourceIndex, restoreXMLMetadata };

package/dist/xml/metadata.mjs

@@ -0,0 +1,30 @@
+import { XMLParser } from "fast-xml-parser";
+//#region src/xml/metadata.ts
+const XML_METADATA_SYMBOL = XMLParser.getMetaDataSymbol();
+function isRecord(value) {
+	return typeof value === "object" && value != null;
+}
+function getXMLMetadata(value) {
+	if (!isRecord(value)) return null;
+	return value[XML_METADATA_SYMBOL] ?? null;
+}
+function getXMLSourceIndex(value) {
+	const startIndex = getXMLMetadata(value)?.startIndex;
+	return typeof startIndex === "number" ? startIndex : null;
+}
+function restoreXMLMetadata(output, input) {
+	if (!isRecord(output) || !isRecord(input)) return;
+	const metadata = getXMLMetadata(input);
+	if (metadata != null) Object.defineProperty(output, XML_METADATA_SYMBOL, {
+		value: metadata,
+		enumerable: false,
+		configurable: true
+	});
+	if (Array.isArray(output) && Array.isArray(input)) {
+		for (const [index, outputValue] of output.entries()) restoreXMLMetadata(outputValue, input[index]);
+		return;
+	}
+	for (const [key, outputValue] of Object.entries(output)) restoreXMLMetadata(outputValue, input[key]);
+}
+//#endregion
+export { getXMLSourceIndex, restoreXMLMetadata };

package/dist/xml/schemas.d.mts

@@ -0,0 +1,13 @@
+import { XMLData as XMLData$1, XMLDataItem as XMLDataItem$1, XMLGalleryData as XMLGalleryData$1, XMLItemLinksData as XMLItemLinksData$1, XMLLink as XMLLink$1, XMLSetItemsData as XMLSetItemsData$1, XMLWebsiteData as XMLWebsiteData$1 } from "./types.mjs";
+import * as v from "valibot";
+
+//#region src/xml/schemas.d.ts
+declare const XMLLink: v.GenericSchema<unknown, XMLLink$1>;
+declare const XMLDataItem: v.GenericSchema<unknown, XMLDataItem$1>;
+declare const XMLItemLinksData: v.GenericSchema<unknown, XMLItemLinksData$1>;
+declare const XMLGalleryData: v.GenericSchema<unknown, XMLGalleryData$1>;
+declare const XMLSetItemsData: v.GenericSchema<unknown, XMLSetItemsData$1>;
+declare const XMLData: v.GenericSchema<unknown, XMLData$1>;
+declare const XMLWebsiteData: v.GenericSchema<unknown, XMLWebsiteData$1>;
+//#endregion
+export { XMLData, XMLDataItem, XMLGalleryData, XMLItemLinksData, XMLLink, XMLSetItemsData, XMLWebsiteData };