ochre-sdk 0.20.0 → 0.20.2

package/dist/index.d.mts

@@ -647,7 +647,37 @@ type PropertyValueQueryItem = {
  * Represents a query for Set items
  */
 type Query = {
-  target: "title" | "description" | "image" | "periods" | "bibliography" | "propertyValue";
+  target: "propertyValue";
+  dataType: Exclude<Exclude<PropertyValueContentType, "coordinate">, "date" | "dateTime">;
+  value: string;
+  from?: never;
+  to?: never;
+  matchMode: "includes" | "exact";
+  isCaseSensitive: boolean;
+  language: string;
+  operator?: "AND" | "OR";
+} | {
+  target: "propertyValue";
+  dataType: "date" | "dateTime";
+  value: string;
+  from: string;
+  to?: string;
+  matchMode: "includes" | "exact";
+  isCaseSensitive: boolean;
+  language: string;
+  operator?: "AND" | "OR";
+} | {
+  target: "propertyValue";
+  dataType: "date" | "dateTime";
+  value: string;
+  from?: string;
+  to: string;
+  matchMode: "includes" | "exact";
+  isCaseSensitive: boolean;
+  language: string;
+  operator?: "AND" | "OR";
+} | {
+  target: "title" | "description" | "image" | "periods" | "bibliography";
   value: string;
   matchMode: "includes" | "exact";
   isCaseSensitive: boolean;

package/dist/index.mjs

@@ -772,21 +772,60 @@ const setItemsParamsSchema = z.object({
 	setScopeUuids: z.array(uuidSchema).min(1, "At least one set scope UUID is required"),
 	belongsToCollectionScopeUuids: z.array(uuidSchema).default([]),
 	propertyVariableUuids: z.array(uuidSchema).default([]),
-	queries: z.array(z.object({
-		target: z.enum([
-			"title",
-			"description",
-			"image",
-			"periods",
-			"bibliography",
-			"propertyValue"
-		]),
-		value: z.string(),
-		matchMode: z.enum(["includes", "exact"]),
-		isCaseSensitive: z.boolean(),
-		language: z.string().default("eng"),
-		operator: z.enum(["AND", "OR"]).optional()
-	})).default([]),
+	queries: z.array(z.union([
+		z.object({
+			target: z.literal("propertyValue"),
+			dataType: z.enum([
+				"string",
+				"integer",
+				"decimal",
+				"boolean",
+				"time",
+				"IDREF"
+			]),
+			value: z.string(),
+			matchMode: z.enum(["includes", "exact"]),
+			isCaseSensitive: z.boolean(),
+			language: z.string().default("eng"),
+			operator: z.enum(["AND", "OR"]).optional()
+		}).strict(),
+		z.object({
+			target: z.literal("propertyValue"),
+			dataType: z.enum(["date", "dateTime"]),
+			value: z.string(),
+			from: z.string(),
+			to: z.string().optional(),
+			matchMode: z.enum(["includes", "exact"]),
+			isCaseSensitive: z.boolean(),
+			language: z.string().default("eng"),
+			operator: z.enum(["AND", "OR"]).optional()
+		}).strict(),
+		z.object({
+			target: z.literal("propertyValue"),
+			dataType: z.enum(["date", "dateTime"]),
+			value: z.string(),
+			from: z.string().optional(),
+			to: z.string(),
+			matchMode: z.enum(["includes", "exact"]),
+			isCaseSensitive: z.boolean(),
+			language: z.string().default("eng"),
+			operator: z.enum(["AND", "OR"]).optional()
+		}).strict(),
+		z.object({
+			target: z.enum([
+				"title",
+				"description",
+				"image",
+				"periods",
+				"bibliography"
+			]),
+			value: z.string(),
+			matchMode: z.enum(["includes", "exact"]),
+			isCaseSensitive: z.boolean(),
+			language: z.string().default("eng"),
+			operator: z.enum(["AND", "OR"]).optional()
+		}).strict()
+	])).default([]),
 	page: z.number().min(1, "Page must be positive").default(1),
 	pageSize: z.number().min(1, "Page size must be positive").default(DEFAULT_PAGE_SIZE)
 }).superRefine((value, ctx) => {
@@ -2073,42 +2112,72 @@ function buildStringMatchPredicate(params) {
 	return `${comparedPath} = ${comparedValueLiteral}`;
 }
 /**
+* Build a date/dateTime range predicate for an XQuery string.
+*/
+function buildDateRangePredicate(params) {
+	const { from, to } = params;
+	const conditions = [];
+	if (from != null) conditions.push(`(value/@rawValue ge ${stringLiteral(from)})`);
+	if (to != null) conditions.push(`(value/@rawValue le ${stringLiteral(to)})`);
+	return conditions.join(" and ");
+}
+/**
+* Build a property value predicate for an XQuery string
+* @param query - The propertyValue query
+* @returns The property value predicate
+*/
+function buildPropertyValuePredicate(query) {
+	if (query.dataType === "IDREF") return `.//properties//property[value[@uuid=${stringLiteral(query.value)}]]`;
+	if (query.dataType === "date" || query.dataType === "dateTime") return `.//properties//property[(label/@uuid=${stringLiteral(query.value)}) and ${buildDateRangePredicate({
+		from: query.from,
+		to: query.to
+	})}]`;
+	if (query.dataType === "time" || query.dataType === "integer" || query.dataType === "decimal" || query.dataType === "boolean") return `.//properties//property[value[@rawValue=${stringLiteral(query.value)}]]`;
+	return `.//properties//property[${buildStringMatchPredicate({
+		path: `string-join(value/content[@xml:lang="${query.language}"]/string, "")`,
+		value: query.value,
+		matchMode: query.matchMode,
+		isCaseSensitive: query.isCaseSensitive
+	})}]`;
+}
+/**
 * Build a query predicate for an XQuery string
 * @param query - The query to build the predicate for
 * @returns The query predicate
 */
 function buildQueryPredicate(query) {
-	const stringMatchParams = {
-		value: query.value,
-		matchMode: query.matchMode,
-		isCaseSensitive: query.isCaseSensitive,
-		language: query.language
-	};
 	switch (query.target) {
 		case "title": return buildStringMatchPredicate({
 			path: `string-join(identification/label/content[@xml:lang="${query.language}"]/string, "")`,
-			...stringMatchParams
+			value: query.value,
+			matchMode: query.matchMode,
+			isCaseSensitive: query.isCaseSensitive
 		});
 		case "description": return buildStringMatchPredicate({
 			path: `string-join(description/content[@xml:lang="${query.language}"]/string, "")`,
-			...stringMatchParams
+			value: query.value,
+			matchMode: query.matchMode,
+			isCaseSensitive: query.isCaseSensitive
 		});
 		case "periods": return buildStringMatchPredicate({
 			path: `string-join(periods/period/identification/label/content[@xml:lang="${query.language}"]/string, "")`,
-			...stringMatchParams
+			value: query.value,
+			matchMode: query.matchMode,
+			isCaseSensitive: query.isCaseSensitive
 		});
 		case "bibliography": return buildStringMatchPredicate({
 			path: `string-join(bibliographies/bibliography/identification/label/content[@xml:lang="${query.language}"]/string, "")`,
-			...stringMatchParams
+			value: query.value,
+			matchMode: query.matchMode,
+			isCaseSensitive: query.isCaseSensitive
 		});
 		case "image": return buildStringMatchPredicate({
 			path: `string-join(image/identification/label/content[@xml:lang="${query.language}"]/string, "")`,
-			...stringMatchParams
+			value: query.value,
+			matchMode: query.matchMode,
+			isCaseSensitive: query.isCaseSensitive
 		});
-		case "propertyValue": return `.//properties//property[${buildStringMatchPredicate({
-			path: `string-join(value/content[@xml:lang="${query.language}"]/string, "")`,
-			...stringMatchParams
-		})}]`;
+		case "propertyValue": return buildPropertyValuePredicate(query);
 	}
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ochre-sdk",
-  "version": "0.20.0",
+  "version": "0.20.2",
   "type": "module",
   "license": "MIT",
   "description": "Node.js library for working with OCHRE (Online Cultural and Historical Research Environment) data",
@@ -47,7 +47,7 @@
   },
   "devDependencies": {
     "@antfu/eslint-config": "^7.6.1",
-    "@types/node": "^24.10.13",
+    "@types/node": "^24.10.14",
     "bumpp": "^10.4.1",
     "eslint": "^10.0.2",
     "prettier": "^3.8.1",