@coffer-org/plugin-documents 3.1.1 → 3.1.2

package/dist/index.js

@@ -5,7 +5,7 @@ import personIdentity from "./person_identity/index.js";
 export default definePlugin({
     id: 'documents',
     version: '1.0.0',
-    dependsOn: ['people'],
+    dependsOn: ['people', 'things'],
     libraries: [
         {
             meta: defineLibrary({

package/dist/schema.js

@@ -4946,7 +4946,8 @@ function source(raw) {
 		hints: {
 			ext,
 			maxBytes,
-			noEditControl: true
+			noEditControl: true,
+			...o.key ? { fileName: o.key } : {}
 		},
 		zod: optionalize(s, required)
 	});
@@ -6425,10 +6426,27 @@ function select(raw) {
 		zod: optionalize(s, required)
 	}, o.multiple ?? false));
 }
+/**
+* Reject anything beyond a flat equality map: an operator key (`$in`, `$and`, …), an
+* object-valued entry (which is how a nested operator like `{ type: { $in: [...] } }`
+* would smuggle itself in), or an explicit `undefined` value all throw, naming the
+* offending key. `undefined` is rejected alongside objects because it would otherwise
+* slip through every later layer unnoticed: `Condition` types it as a valid value,
+* `conditionKeys` skips it so compose validates nothing against the target shelf, and
+* the picker's query-string builder turns it into the literal string `'undefined'`
+* (an empty picker with no error anywhere).
+*/
+function assertFlatEqualityFilter(filter) {
+	for (const [key, value] of Object.entries(filter)) {
+		if (key.startsWith("$")) throw new Error(`[relation] filter key '${key}' is an operator — only flat equality is allowed here`);
+		if (value === void 0 || value !== null && typeof value === "object") throw new Error(`[relation] filter key '${key}' has a non-scalar value — only flat equality is allowed here`);
+	}
+}
 function relation(raw) {
 	const o = normalizeOpts(raw);
 	const required = o.required ?? false;
 	const multi = o.multiple ?? false;
+	if (raw.options.filter) assertFlatEqualityFilter(raw.options.filter);
 	let s;
 	if (multi) s = unknown().superRefine((raw, ctx) => {
 		const arr = jsonValue(raw);
@@ -6450,7 +6468,8 @@ function relation(raw) {
 		},
 		relation: {
 			library: raw.options.library,
-			shelf: raw.options.shelf
+			shelf: raw.options.shelf,
+			...raw.options.filter && { filter: raw.options.filter }
 		},
 		...multi && { json: true },
 		zod: optionalize(s, required)
@@ -8169,7 +8188,7 @@ nationality — ISO alpha-2. variants — given/family name per language (field.
 var src_default = definePlugin({
 	id: "documents",
 	version: "1.0.0",
-	dependsOn: ["people"],
+	dependsOn: ["people", "things"],
 	libraries: [{
 		meta: defineLibrary({
 			id: "documents",

package/locales/en.json

@@ -0,0 +1,62 @@
+{
+  "documents": {
+    "plugin": {
+      "label": "Documents",
+      "description": "Personal documents and identity."
+    },
+    "library": {
+      "label": "Documents"
+    },
+    "person_identity": {
+      "label": "Identity",
+      "fields": {
+        "nationality": "Nationality",
+        "variants": "Variants (languages)"
+      },
+      "variants": {
+        "lang": "Language",
+        "name": "First name",
+        "surname": "Last name"
+      }
+    },
+    "personal_document": {
+      "label": "Document",
+      "fields": {
+        "logo": "Front side",
+        "description": "Description",
+        "surname": "Surname",
+        "given_names": "Given names",
+        "sex": "Sex",
+        "birth_date": "Date of birth",
+        "nationality": "Nationality",
+        "number": "Document number",
+        "record_no": "Record No.",
+        "issued": "Date of issue",
+        "expires": "Expiry date",
+        "authority": "Issuing authority",
+        "storage": "Storage location",
+        "mrz": "MRZ (machine-readable zone)",
+        "owner": "Owner",
+        "photos": "Other photos",
+        "notes": "Notes",
+        "tags": "Tags"
+      },
+      "options": {
+        "sex": {
+          "M": "Male",
+          "F": "Female"
+        },
+        "type": {
+          "P": "Passport",
+          "PA": "Passport (biometric)",
+          "TP": "Temporary protection",
+          "ID": "ID card",
+          "DL": "Driver's licence",
+          "BR": "Birth certificate",
+          "MC": "Medical card / policy",
+          "OT": "Other"
+        }
+      }
+    }
+  }
+}

package/locales/ru.json

@@ -0,0 +1,62 @@
+{
+  "documents": {
+    "plugin": {
+      "label": "Документы",
+      "description": "Личные документы и идентичность."
+    },
+    "library": {
+      "label": "Документы"
+    },
+    "person_identity": {
+      "label": "Идентичность",
+      "fields": {
+        "nationality": "Гражданство",
+        "variants": "Варианты (языки)"
+      },
+      "variants": {
+        "lang": "Язык",
+        "name": "Имя",
+        "surname": "Фамилия"
+      }
+    },
+    "personal_document": {
+      "label": "Документ",
+      "fields": {
+        "logo": "Лицевая сторона",
+        "description": "Описание",
+        "surname": "Фамилия",
+        "given_names": "Имя и отчество",
+        "sex": "Пол",
+        "birth_date": "Дата рождения",
+        "nationality": "Гражданство",
+        "number": "Номер документа",
+        "record_no": "Запись №",
+        "issued": "Выдан",
+        "expires": "Действителен до",
+        "authority": "Кем выдан",
+        "storage": "Место хранения",
+        "mrz": "MRZ (строка)",
+        "owner": "Владелец",
+        "photos": "Другие фото",
+        "notes": "Заметки",
+        "tags": "Теги"
+      },
+      "options": {
+        "sex": {
+          "M": "Мужской",
+          "F": "Женский"
+        },
+        "type": {
+          "P": "Паспорт",
+          "PA": "Паспорт (биометрический)",
+          "TP": "Временная защита",
+          "ID": "ID-карта",
+          "DL": "Водительское удостоверение",
+          "BR": "Свидетельство о рождении",
+          "MC": "Медицинская карта / полис",
+          "OT": "Другое"
+        }
+      }
+    }
+  }
+}

package/locales/uk.json

@@ -0,0 +1,62 @@
+{
+  "documents": {
+    "plugin": {
+      "label": "Документи",
+      "description": "Особисті документи та ідентичність."
+    },
+    "library": {
+      "label": "Документи"
+    },
+    "person_identity": {
+      "label": "Ідентичність",
+      "fields": {
+        "nationality": "Громадянство",
+        "variants": "Варіанти (мови)"
+      },
+      "variants": {
+        "lang": "Мова",
+        "name": "Ім'я",
+        "surname": "Прізвище"
+      }
+    },
+    "personal_document": {
+      "label": "Документ",
+      "fields": {
+        "logo": "Лицьова сторона",
+        "description": "Опис",
+        "surname": "Прізвище",
+        "given_names": "Ім'я та по батькові",
+        "sex": "Стать",
+        "birth_date": "Дата народження",
+        "nationality": "Громадянство",
+        "number": "Номер документа",
+        "record_no": "Запис №",
+        "issued": "Виданий",
+        "expires": "Дійсний до",
+        "authority": "Ким виданий",
+        "storage": "Де зберігається",
+        "mrz": "MRZ (машиночитаємий рядок)",
+        "owner": "Власник",
+        "photos": "Інші фото",
+        "notes": "Нотатки",
+        "tags": "Теги"
+      },
+      "options": {
+        "sex": {
+          "M": "Чоловіча",
+          "F": "Жіноча"
+        },
+        "type": {
+          "P": "Паспорт",
+          "PA": "Паспорт (біометричний)",
+          "TP": "Тимчасовий захист",
+          "ID": "ID-картка",
+          "DL": "Посвідчення водія",
+          "BR": "Свідоцтво про народження",
+          "MC": "Медична картка / полюс",
+          "OT": "Інше"
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@coffer-org/plugin-documents",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "type": "module",
   "engines": {
     "node": ">=24"
   },
   "files": [
     "dist",
-    "seed"
+    "seed",
+    "locales"
   ],
   "exports": {
     ".": {
@@ -25,7 +26,7 @@
     "postpack": "node ../../scripts/swap-exports.mjs src"
   },
   "dependencies": {
-    "@coffer-org/plugin-people": "^3.1.1",
+    "@coffer-org/plugin-people": "^3.1.2",
     "@coffer-org/sdk": "^3.0.0",
     "@coffer-org/server": "^3.0.0"
   },