@coffer-org/sdk 1.9.0 → 2.1.0

package/dist/fields.d.ts

@@ -94,7 +94,7 @@ export interface FieldClient {
     options?: OptionItem[];
     relation?: {
         library: string;
-        type: string;
+        shelf: string;
     };
     virtual?: boolean;
     default?: string | number | boolean | null;

package/dist/fields.js

@@ -466,7 +466,7 @@ export function relation(raw) {
         prim: 'relation',
         column: multi ? 'text' : 'integer',
         hints: { multi, displayKey: o.displayKey ?? 'name' },
-        relation: { library: raw.options.library, type: raw.options.shelf },
+        relation: { library: raw.options.library, shelf: raw.options.shelf },
         ...(multi && { json: true }),
         zod: optionalize(s, required),
     };
@@ -789,15 +789,34 @@ export function period(raw) {
     };
     return wrapKey(o, meta);
 }
+const FILE_KEYS = new Set(['name', 'mime', 'size']);
+const FILE_URL_KEYS = ['url', 'src', 'href', 'link'];
+function fileEntryIssue(it) {
+    if (typeof it !== 'object' || it === null || Array.isArray(it))
+        return 'file_structure';
+    const rec = it;
+    if (FILE_URL_KEYS.some((k) => k in rec))
+        return 'file_remote_url';
+    const name = rec['name'];
+    if (typeof name !== 'string' || name === '')
+        return 'file_structure';
+    if (name.includes('://') || name.startsWith('//'))
+        return 'file_remote_url';
+    if (/[\\/]/.test(name) || name.includes('..'))
+        return 'file_name';
+    for (const k of Object.keys(rec))
+        if (!FILE_KEYS.has(k))
+            return 'file_unknown_key';
+    if (rec['mime'] !== undefined && typeof rec['mime'] !== 'string')
+        return 'file_structure';
+    if (rec['size'] !== undefined && typeof rec['size'] !== 'number')
+        return 'file_structure';
+    return null;
+}
 function makeFile(kind, raw) {
     const o = normalizeOpts(raw);
     const required = o.required ?? false;
     const multiple = o.multiple ?? false;
-    const rowSchema = z.object({
-        name: z.string().min(1),
-        mime: z.string().optional(),
-        size: z.number().optional(),
-    });
     const s = z.unknown().superRefine((raw, ctx) => {
         if (typeof raw === 'string') {
             try {
@@ -811,8 +830,9 @@ function makeFile(kind, raw) {
         const parsed = jsonValue(raw);
         const items = Array.isArray(parsed) ? parsed : [parsed];
         for (const it of items) {
-            if (!rowSchema.safeParse(it).success) {
-                ctx.addIssue({ code: z.ZodIssueCode.custom, message: vmsg('file_structure') });
+            const code = fileEntryIssue(it);
+            if (code) {
+                ctx.addIssue({ code: z.ZodIssueCode.custom, message: vmsg(code) });
                 return;
             }
         }

package/dist/shelf.d.ts

@@ -1,10 +1,14 @@
 import { z } from 'zod';
 import type { FieldMeta, LayoutEl, ColumnType } from './fields.ts';
 import type { FieldClient, GroupEl, PseudoEl } from './fields.ts';
+export interface ShelfListView {
+    kind?: string;
+    fields: string[];
+}
 export interface ShelfViews {
     title?: string;
     inline?: string[];
-    table?: string[];
+    list?: ShelfListView;
     groupBy?: string[];
     defaultGroupBy?: string;
     select?: {
@@ -25,6 +29,7 @@ export interface ShelfDef {
 }
 export declare function fieldEntries(items: LayoutEl[]): [string, FieldMeta][];
 export declare function storageColumns(key: string, field: FieldMeta): [string, ColumnType][];
+export declare function cellValue(field: FieldMeta, key: string, row: Record<string, unknown>): unknown;
 export interface CollectionEntry {
     key: string;
     group: GroupEl;
@@ -40,7 +45,8 @@ export declare function textSearchKeys(m: ShelfDef): string[];
 export declare function inlineKeys(m: ShelfDef): string[];
 export declare function inlineImageKey(m: ShelfDef): string | undefined;
 export declare function inlineText(m: ShelfDef, row: Record<string, unknown>): string;
-export declare function tableKeys(m: ShelfDef): string[];
+export declare function viewKeys(m: ShelfDef): string[];
+export declare function listKind(m: ShelfDef): string;
 export declare function groupableFields(m: ShelfDef): string[];
 export declare function defaultGroupField(m: ShelfDef): string | undefined;
 export declare function coverKey(m: ShelfDef): string | undefined;

package/dist/shelf.js

@@ -24,6 +24,22 @@ export function storageColumns(key, field) {
         return Object.entries(field.columns).map(([sub, col]) => [`${key}__${sub}`, col]);
     return [[key, field.column]];
 }
+export function cellValue(field, key, row) {
+    if (!field.columns)
+        return row[key];
+    if (row[key] !== undefined)
+        return row[key];
+    const out = {};
+    let filled = false;
+    for (const sub of Object.keys(field.columns)) {
+        const v = row[`${key}__${sub}`];
+        if (v == null || v === '')
+            continue;
+        out[sub] = v;
+        filled = true;
+    }
+    return filled ? out : undefined;
+}
 export function collectionGroups(items) {
     const out = [];
     for (const it of items) {
@@ -52,8 +68,8 @@ export function defineShelf(m) {
     const dup = keys.find((k, i) => keys.indexOf(k) !== i);
     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`);
+    if (m.standalone !== false && !m.views?.list?.fields?.length)
+        console.warn(`[shelf] ${m.library}/${m.shelf}: standalone shelf without an explicit views.list`);
     return m;
 }
 export const SYSTEM_FIELDS = ['id', 'createdAt', 'updatedAt'];
@@ -108,13 +124,16 @@ export function inlineText(m, row) {
     }, []);
     return parts.join(' ').trim() || recordTitle(m, row);
 }
-export function tableKeys(m) {
+export function viewKeys(m) {
     const tk = titleKey(m);
-    const rest = m.views?.table?.length
-        ? realKeys(m, m.views.table.filter((k) => k !== tk))
+    const rest = m.views?.list?.fields?.length
+        ? realKeys(m, m.views.list.fields.filter((k) => k !== tk))
         : [];
     return [tk, ...rest];
 }
+export function listKind(m) {
+    return m.views?.list?.kind ?? 'table';
+}
 const GROUPABLE_PRIMS = new Set(['select', 'checkbox', 'relation']);
 export function groupableFields(m) {
     if (m.views?.groupBy?.length)
@@ -146,7 +165,7 @@ export function listKeys(m) {
         out.push(k);
     };
     add(titleKey(m));
-    tableKeys(m).forEach(add);
+    viewKeys(m).forEach(add);
     groupableFields(m).forEach(add);
     inlineKeys(m).forEach(add);
     add(inlineImageKey(m));

package/dist/users-shelf.js

@@ -5,7 +5,7 @@ export const USERS_SHELF = defineShelf({
     library: '',
     label: 'auth.usersTitle',
     icon: 'lucide:users',
-    views: { table: ['login', 'displayName', 'role', 'disabled'] },
+    views: { list: { fields: ['login', 'displayName', 'role', 'disabled'] } },
     fields: [
         field.string({ key: 'login', label: 'auth.fieldLogin' }),
         field.string({ key: 'displayName', label: 'auth.fieldDisplayName' }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/sdk",
-  "version": "1.9.0",
+  "version": "2.1.0",
   "type": "module",
   "engines": {
     "node": ">=24"