@coffer-org/plugin-documents 1.3.0 → 1.4.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { defineVault } from '@coffer-org/sdk/vault';
+import { defineLibrary } from '@coffer-org/sdk/library';
 import { definePlugin } from '@coffer-org/sdk/plugin';
 import personal_document from "./personal_document/index.js";
 import personIdentity from "./person_identity/index.js";
@@ -6,10 +6,10 @@ export default definePlugin({
     id: 'documents',
     version: '1.0.0',
     dependsOn: ['people'],
-    vaults: [
+    libraries: [
         {
-            meta: defineVault({ id: 'documents', label: 'documents.vault.label', icon: 'lucide:id-card' }),
-            modules: [personal_document],
+            meta: defineLibrary({ id: 'documents', label: 'documents.library.label', icon: 'lucide:id-card', agent: 'Personal documents — IDs, passports, licences (personal_document); tracks expiry.' }),
+            shelves: [personal_document],
         },
     ],
     extends_: [personIdentity],

package/dist/person_identity/index.js

@@ -4,7 +4,7 @@ export default defineExtend({
     id: 'person_identity',
     label: 'documents.person_identity.label',
     icon: 'lucide:globe',
-    attachTo: [{ vault: 'people', module: 'person' }],
+    attachTo: [{ library: 'people', shelf: 'person' }],
     claude: `Canonical person identity (not tied to a physical document).
 nationality — ISO alpha-2. variants — given/family name per language (field.group multiple: lang+name+surname).`,
     fields: [

package/dist/personal_document/index.d.ts

@@ -1,2 +1,2 @@
-declare const _default: import("@coffer-org/sdk/module").ModuleDef;
+declare const _default: import("@coffer-org/sdk/shelf").ShelfDef;
 export default _default;

package/dist/personal_document/index.js

@@ -1,8 +1,8 @@
-import { defineModule } from '@coffer-org/sdk/module';
+import { defineShelf } from '@coffer-org/sdk/shelf';
 import { field } from '@coffer-org/sdk/fields';
-export default defineModule({
-    module: 'personal_document',
-    vault: 'documents',
+export default defineShelf({
+    shelf: 'personal_document',
+    library: 'documents',
     label: 'documents.personal_document.label',
     icon: 'lucide:id-card',
     views: {
@@ -29,12 +29,12 @@ export default defineModule({
         field.date({ key: 'issued', label: 'documents.personal_document.fields.issued' }),
         field.reminder({ key: 'expires', label: 'documents.personal_document.fields.expires', rules: { lead: 60 } }),
         field.string({ key: 'authority', label: 'documents.personal_document.fields.authority', rules: { max: 200 } }),
-        field.relation({ key: 'storage', label: 'documents.personal_document.fields.storage', options: { vault: 'things', module: 'storage_location' } }),
+        field.relation({ key: 'storage', label: 'documents.personal_document.fields.storage', options: { library: 'things', shelf: 'storage_location' } }),
         field.string({ key: 'mrz', label: 'documents.personal_document.fields.mrz', rules: { max: 200 } }),
         field.relation({
             key: 'owner',
             label: 'documents.personal_document.fields.owner',
-            options: { vault: 'people', module: 'person' },
+            options: { library: 'people', shelf: 'person' },
         }),
         field.image({ key: 'photos', label: 'documents.personal_document.fields.photos', multiple: true }),
         field.text({ key: 'notes', label: 'documents.personal_document.fields.notes', rules: { max: 1000 } }),

package/dist/runtime/index.js

@@ -1,7 +1,8 @@
-import { fileURLToPath } from 'node:url';
 import { localPost } from '@coffer-org/server/local-api';
-import { seedAsset } from '@coffer-org/server/uploads';
-const asset = (rel) => fileURLToPath(new URL(`../../seed/assets/${rel}`, import.meta.url));
+import { seedAsset, seedAssetPath } from '@coffer-org/server/uploads';
+import { getLogger } from '@coffer-org/sdk/logger';
+const log = getLogger('documents');
+const asset = seedAssetPath(import.meta.url);
 export const serverHooks = {
     migrations: [
         {
@@ -10,7 +11,7 @@ export const serverHooks = {
                 await table('documents__personal_document').changeType('storage', 'text', {
                     transform: (old) => {
                         if (old)
-                            console.warn(`[documents migration] storage reset: ${String(old)}`);
+                            log.warn(`migration: storage reset: ${String(old)}`);
                         return null;
                     },
                 });
@@ -83,8 +84,6 @@ export const serverHooks = {
         },
     ],
     agent: {
-        instructions: 'Vault documents — personal documents (personal_document): type, number, issued/expires (ISO), ' +
-            'authority, owner (relation to people). Expiring documents — count by expires.' +
-            ' When a document is reissued — update number/issued/expires via update_record.',
+        instructions: 'Expiring documents — count by expires. When a document is reissued — update number/issued/expires via update_record.',
     },
 };

package/dist/schema.js

@@ -21,8 +21,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-//#region ../sdk/src/vault.ts
-function defineVault(v) {
+//#region ../sdk/src/library.ts
+function defineLibrary(v) {
 	return v;
 }
 //#endregion
@@ -154,7 +154,10 @@ function assignProp(target, prop, value) {
 }
 function mergeDefs(...defs) {
 	const mergedDescriptors = {};
-	for (const def of defs) Object.assign(mergedDescriptors, Object.getOwnPropertyDescriptors(def));
+	for (const def of defs) {
+		const descriptors = Object.getOwnPropertyDescriptors(def);
+		Object.assign(mergedDescriptors, descriptors);
+	}
 	return Object.defineProperties({}, mergedDescriptors);
 }
 function esc(str) {
@@ -476,7 +479,7 @@ var _parse = (_Err) => (schema, value, _ctx, _params) => {
 	}, ctx);
 	if (result instanceof Promise) throw new $ZodAsyncError();
 	if (result.issues.length) {
-		const e = new (_params?.Err ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
+		const e = new ((_params?.Err) ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
 		captureStackTrace(e, _params?.callee);
 		throw e;
 	}
@@ -493,7 +496,7 @@ var _parseAsync = (_Err) => async (schema, value, _ctx, params) => {
 	}, ctx);
 	if (result instanceof Promise) result = await result;
 	if (result.issues.length) {
-		const e = new (params?.Err ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
+		const e = new ((params?.Err) ?? _Err)(result.issues.map((iss) => finalizeIssue(iss, ctx, config())));
 		captureStackTrace(e, params?.callee);
 		throw e;
 	}
@@ -1945,7 +1948,7 @@ var $ZodOptional = /*@__PURE__*/ $constructor("$ZodOptional", (inst, def) => {
 	inst._zod.optin = "optional";
 	inst._zod.optout = "optional";
 	defineLazy(inst._zod, "values", () => {
-		return def.innerType._zod.values ? new Set([...def.innerType._zod.values, void 0]) : void 0;
+		return def.innerType._zod.values ? /* @__PURE__ */ new Set([...def.innerType._zod.values, void 0]) : void 0;
 	});
 	defineLazy(inst._zod, "pattern", () => {
 		const pattern = def.innerType._zod.pattern;
@@ -1979,7 +1982,7 @@ var $ZodNullable = /*@__PURE__*/ $constructor("$ZodNullable", (inst, def) => {
 		return pattern ? new RegExp(`^(${cleanRegex(pattern.source)}|null)$`) : void 0;
 	});
 	defineLazy(inst._zod, "values", () => {
-		return def.innerType._zod.values ? new Set([...def.innerType._zod.values, null]) : void 0;
+		return def.innerType._zod.values ? /* @__PURE__ */ new Set([...def.innerType._zod.values, null]) : void 0;
 	});
 	inst._zod.parse = (payload, ctx) => {
 		if (payload.value === null) return payload;
@@ -4587,7 +4590,7 @@ function password(raw) {
 * Internal API-token list — keyValue-shaped collection (name + write-only
 * token + timestamps), custom renderer (`kind:'internalApiToken'`, own
 * create/revoke UI — same trick as url()/perWeekday()). "Internal" = not a
-* general-purpose field type for plugin modules, only for the core account
+* general-purpose field type for plugin shelves, only for the core account
 * settings page. `token` is `kind:'password'` so maskSecrets/preserveTree
 * already mask/preserve it for free.
 */
@@ -4686,7 +4689,7 @@ var TEL_RE = /^\+?[\d\s()-]{4,}$/;
 /** Loose URL: будь-який scheme:// АБО host-з-крапкою (+опц. порт/шлях). Без пробілів. */
 var LINK_RE = /^([a-z][a-z0-9+.-]*:\/\/\S+|[\w-]+(\.[\w-]+)+(:\d+)?(\/\S*)?)$/i;
 /** CSS named colors (CSS Color Module L4) — для f.colorname. */
-var CSS_COLOR_NAMES = new Set([
+var CSS_COLOR_NAMES = /* @__PURE__ */ new Set([
 	"aliceblue",
 	"antiquewhite",
 	"aqua",
@@ -5147,7 +5150,7 @@ var require_data = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		},
 		cs: {
 			name: "Czech",
-			nativeName: "Čeština"
+			nativeName: "čeština"
 		},
 		cu: {
 			name: "Old Church Slavonic",
@@ -5611,7 +5614,7 @@ var require_data = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		},
 		sk: {
 			name: "Slovak",
-			nativeName: "Slovenčina"
+			nativeName: "slovenčtina"
 		},
 		sl: {
 			name: "Slovenian",
@@ -5992,6 +5995,34 @@ function wrapKey(opts, meta) {
 			noEditControl: true
 		}
 	};
+	if (opts.emphasis) m = {
+		...m,
+		hints: {
+			...m.hints,
+			emphasis: opts.emphasis
+		}
+	};
+	if (opts.noLabel) m = {
+		...m,
+		hints: {
+			...m.hints,
+			noLabel: true
+		}
+	};
+	if (opts.role) m = {
+		...m,
+		hints: {
+			...m.hints,
+			role: opts.role
+		}
+	};
+	if (opts.pinned) m = {
+		...m,
+		hints: {
+			...m.hints,
+			pinned: true
+		}
+	};
 	if (opts.default !== void 0) m = {
 		...m,
 		default: opts.default
@@ -6355,8 +6386,8 @@ function relation(raw) {
 			displayKey: o.displayKey ?? "name"
 		},
 		relation: {
-			vault: raw.options.vault,
-			type: raw.options.module
+			library: raw.options.library,
+			type: raw.options.shelf
 		},
 		...multi && { json: true },
 		zod: optionalize(s, required)
@@ -7676,7 +7707,7 @@ var createDefaultQueryTester = function(query, options) {
 };
 createDefaultQueryTester.createEqualsOperation;
 //#endregion
-//#region ../sdk/src/module.ts
+//#region ../sdk/src/shelf.ts
 /** Flat [storageKey, FieldMeta] pairs of the parent table's columns.
 *  layout group → flattened; embedded group → prefix `key__`; collection → skipped. */
 function fieldEntries(items) {
@@ -7689,18 +7720,18 @@ function fieldEntries(items) {
 	}
 	return out;
 }
-function defineModule(m) {
+function defineShelf(m) {
 	const keys = fieldEntries(m.fields).map(([k]) => k);
 	const dup = keys.find((k, i) => keys.indexOf(k) !== i);
-	if (dup) throw new Error(`[module] ${m.vault}/${m.module}: duplicate key '${dup}'`);
-	if (m.standalone !== false && !m.views?.table?.length) console.warn(`[module] ${m.vault}/${m.module}: standalone module without an explicit views.table`);
+	if (dup) throw new Error(`[shelf] ${m.library}/${m.shelf}: duplicate key '${dup}'`);
+	if (m.standalone !== false && !m.views?.table?.length) console.warn(`[shelf] ${m.library}/${m.shelf}: standalone shelf without an explicit views.table`);
 	return m;
 }
 //#endregion
 //#region src/personal_document/index.ts
-var personal_document_default = defineModule({
-	module: "personal_document",
-	vault: "documents",
+var personal_document_default = defineShelf({
+	shelf: "personal_document",
+	library: "documents",
 	label: "documents.personal_document.label",
 	icon: "lucide:id-card",
 	views: { table: [
@@ -7781,8 +7812,8 @@ var personal_document_default = defineModule({
 			key: "storage",
 			label: "documents.personal_document.fields.storage",
 			options: {
-				vault: "things",
-				module: "storage_location"
+				library: "things",
+				shelf: "storage_location"
 			}
 		}),
 		field.string({
@@ -7794,8 +7825,8 @@ var personal_document_default = defineModule({
 			key: "owner",
 			label: "documents.personal_document.fields.owner",
 			options: {
-				vault: "people",
-				module: "person"
+				library: "people",
+				shelf: "person"
 			}
 		}),
 		field.image({
@@ -7873,8 +7904,8 @@ var person_identity_default = defineExtend({
 	label: "documents.person_identity.label",
 	icon: "lucide:globe",
 	attachTo: [{
-		vault: "people",
-		module: "person"
+		library: "people",
+		shelf: "person"
 	}],
 	claude: `Canonical person identity (not tied to a physical document).
 nationality — ISO alpha-2. variants — given/family name per language (field.group multiple: lang+name+surname).`,
@@ -7905,13 +7936,14 @@ var src_default = definePlugin({
 	id: "documents",
 	version: "1.0.0",
 	dependsOn: ["people"],
-	vaults: [{
-		meta: defineVault({
+	libraries: [{
+		meta: defineLibrary({
 			id: "documents",
-			label: "documents.vault.label",
-			icon: "lucide:id-card"
+			label: "documents.library.label",
+			icon: "lucide:id-card",
+			agent: "Personal documents — IDs, passports, licences (personal_document); tracks expiry."
 		}),
-		modules: [personal_document_default]
+		shelves: [personal_document_default]
 	}],
 	extends_: [person_identity_default]
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/plugin-documents",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -25,8 +25,8 @@
     "postpack": "node ../../scripts/swap-exports.mjs src"
   },
   "dependencies": {
-    "@coffer-org/sdk": "^1.3.0",
-    "@coffer-org/server": "^1.3.0"
+    "@coffer-org/sdk": "^1.5.0",
+    "@coffer-org/server": "^1.8.0"
   },
   "coffer": {
     "schema": "dist/schema.js"