@coffer-org/sdk 1.6.0 → 1.8.0

package/dist/fields/convert.d.ts

@@ -0,0 +1,14 @@
+import type { ColumnType } from '../fields.ts';
+export interface ColumnConversion {
+    from: string[];
+    to: {
+        name: string;
+        type: ColumnType;
+    }[];
+    map(src: Record<string, unknown>): Record<string, unknown>;
+}
+export declare const URL_PARTS: readonly ["scheme", "username", "password", "host", "port", "path", "query", "hash"];
+export declare function urlToLink(key: string): ColumnConversion;
+export declare function linkToUrl(key: string): ColumnConversion;
+export declare function scalarToArray(key: string): ColumnConversion;
+export declare function arrayToScalar(key: string): ColumnConversion;

package/dist/fields/convert.js

@@ -0,0 +1,79 @@
+import { parseUrl, buildUrl } from "./url.js";
+export const URL_PARTS = ['scheme', 'username', 'password', 'host', 'port', 'path', 'query', 'hash'];
+const urlColumns = (key) => URL_PARTS.map((p) => ({ name: `${key}__${p}`, type: p === 'port' ? 'integer' : 'text' }));
+function partsToValue(key, src) {
+    const v = {};
+    for (const p of URL_PARTS) {
+        const raw = src[`${key}__${p}`];
+        if (raw == null || raw === '')
+            continue;
+        if (p === 'port') {
+            const n = Number(raw);
+            if (Number.isFinite(n))
+                v.port = n;
+        }
+        else {
+            v[p] = String(raw);
+        }
+    }
+    return v;
+}
+export function urlToLink(key) {
+    return {
+        from: URL_PARTS.map((p) => `${key}__${p}`),
+        to: [{ name: key, type: 'text' }],
+        map: (src) => ({ [key]: buildUrl(partsToValue(key, src)) || null }),
+    };
+}
+export function linkToUrl(key) {
+    return {
+        from: [key],
+        to: urlColumns(key),
+        map: (src) => {
+            const raw = src[key];
+            const v = raw == null ? null : parseUrl(String(raw));
+            const out = {};
+            for (const p of URL_PARTS)
+                out[`${key}__${p}`] = v?.[p] ?? null;
+            return out;
+        },
+    };
+}
+export function scalarToArray(key) {
+    return {
+        from: [key],
+        to: [{ name: key, type: 'text' }],
+        map: (src) => {
+            const raw = src[key];
+            if (raw == null || raw === '')
+                return { [key]: null };
+            if (isJsonArray(raw))
+                return { [key]: raw };
+            return { [key]: JSON.stringify([raw]) };
+        },
+    };
+}
+export function arrayToScalar(key) {
+    return {
+        from: [key],
+        to: [{ name: key, type: 'text' }],
+        map: (src) => {
+            const raw = src[key];
+            if (raw == null || raw === '')
+                return { [key]: null };
+            if (!isJsonArray(raw))
+                return { [key]: raw };
+            try {
+                const arr = JSON.parse(String(raw));
+                const first = arr[0];
+                return { [key]: first == null ? null : typeof first === 'object' ? JSON.stringify(first) : first };
+            }
+            catch {
+                return { [key]: raw };
+            }
+        },
+    };
+}
+function isJsonArray(v) {
+    return typeof v === 'string' && v.trimStart().startsWith('[');
+}

package/dist/fields.d.ts

@@ -105,6 +105,7 @@ export interface FieldClient {
 export declare function group(o: {
     key?: string;
     label?: string;
+    icon?: string;
     fields: LayoutEl[];
     multiple?: boolean;
     required?: boolean;
@@ -115,34 +116,27 @@ export declare function group(o: {
     view?: {
         display?: GroupDisplay;
         kind?: string;
-        icon?: string;
     };
 }): GroupEl;
 export declare function row(o: {
     label?: string;
+    icon?: string;
     fields: LayoutEl[];
-    view?: {
-        icon?: string;
-    };
 }): GroupEl;
 export declare function table(o: {
     key: string;
     label: string;
+    icon?: string;
     fields: LayoutEl[];
     rules?: {
         unique?: string[];
     };
     required?: boolean;
-    view?: {
-        icon?: string;
-    };
 }): GroupEl;
 export declare function sheet(o: {
     label?: string;
+    icon?: string;
     fields: LayoutEl[][];
-    view?: {
-        icon?: string;
-    };
 }): GroupEl;
 export declare function url(o: {
     key: string;
@@ -153,15 +147,13 @@ type ContainerFactory = typeof row | typeof group | typeof table;
 export declare function keyed(o: {
     key: string;
     label: string;
+    icon?: string;
     container?: ContainerFactory;
     by: FieldItem;
     fields: LayoutEl[];
     fixed?: boolean;
     unique?: string[];
     required?: boolean;
-    view?: {
-        icon?: string;
-    };
 }): GroupEl;
 export declare const isStorageGroup: (g: GroupEl) => boolean;
 export declare const isCollectionGroup: (g: GroupEl) => boolean;
@@ -208,6 +200,7 @@ export interface FieldMeta extends FieldClient {
 export declare function isJsonStored(field: FieldMeta | FieldClient): boolean;
 export { LANGUAGES, SEX_OPTIONS, WEEKDAY_OPTIONS } from './fields/constants.ts';
 export { parseUrl, buildUrl, hrefOf, type UrlValue } from './fields/url.ts';
+export { URL_PARTS, urlToLink, linkToUrl, scalarToArray, arrayToScalar, type ColumnConversion, } from './fields/convert.ts';
 export declare function applyMultiple(base: FieldMeta, multiple: boolean): FieldMeta;
 export type StringOpts = FieldCoreOpts;
 export declare function string(o: StringOpts & {

package/dist/fields.js

@@ -35,7 +35,7 @@ export function group(o) {
         required: o.required,
         unique: r.unique,
         label: o.label,
-        icon: v.icon,
+        icon: o.icon,
         display: v.display ?? 'wrap',
         kind: v.kind,
         fixed: r.fixed,
@@ -43,17 +43,18 @@ export function group(o) {
     };
 }
 export function row(o) {
-    return group({ label: o.label, fields: o.fields, view: { ...o.view, display: 'scroll' } });
+    return group({ label: o.label, icon: o.icon, fields: o.fields, view: { display: 'scroll' } });
 }
 export function table(o) {
     return group({
         key: o.key,
         label: o.label,
+        icon: o.icon,
         fields: o.fields,
         multiple: true,
         required: o.required,
         rules: o.rules,
-        view: { ...o.view, display: 'table' },
+        view: { display: 'table' },
     });
 }
 export function sheet(o) {
@@ -63,7 +64,7 @@ export function sheet(o) {
             flat.push(brk());
         flat.push(...rowFields);
     });
-    return group({ label: o.label, fields: flat, view: { ...o.view, display: 'sheet' } });
+    return group({ label: o.label, icon: o.icon, fields: flat, view: { display: 'sheet' } });
 }
 export function url(o) {
     return group({
@@ -87,7 +88,7 @@ export function keyed(o) {
     if (o.fixed && o.by.type.prim !== 'select')
         throw new Error(`[field.keyed] fixed requires by=select (enumerated), got '${o.by.type.prim}'`);
     const make = (o.container ?? group);
-    const g = make({ label: o.label, fields: [o.by, ...o.fields], view: o.view });
+    const g = make({ label: o.label, icon: o.icon, fields: [o.by, ...o.fields] });
     return {
         ...g,
         key: o.key,
@@ -139,6 +140,7 @@ export function isJsonStored(field) {
 }
 export { LANGUAGES, SEX_OPTIONS, WEEKDAY_OPTIONS } from "./fields/constants.js";
 export { parseUrl, buildUrl, hrefOf } from "./fields/url.js";
+export { URL_PARTS, urlToLink, linkToUrl, scalarToArray, arrayToScalar, } from "./fields/convert.js";
 function resolveDate(v) {
     return v === 'today' ? new Date().toISOString().slice(0, 10) : v;
 }

package/dist/shelf.d.ts

@@ -43,6 +43,9 @@ export declare function inlineText(m: ShelfDef, row: Record<string, unknown>): s
 export declare function tableKeys(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;
+export declare function listKeys(m: ShelfDef): string[];
+export declare function storageColumnsFor(m: ShelfDef, keys: string[]): string[];
 export declare function buildShape(fields: LayoutEl[], partial: boolean): z.ZodRawShape;
 export declare function buildZodObject(m: ShelfDef): z.ZodTypeAny;
 export declare function buildZodObjectPartial(m: ShelfDef): z.ZodTypeAny;

package/dist/shelf.js

@@ -132,6 +132,45 @@ export function defaultGroupField(m) {
     }
     return groupableFields(m)[0];
 }
+export function coverKey(m) {
+    return fieldEntries(m.fields).find(([, f]) => f.kind === 'cover')?.[0];
+}
+export function listKeys(m) {
+    const fm = fieldMap(m.fields);
+    const out = [];
+    const add = (k) => {
+        if (!k || k === 'id' || out.includes(k))
+            return;
+        if (!fm[k] || fm[k].virtual)
+            return;
+        out.push(k);
+    };
+    add(titleKey(m));
+    tableKeys(m).forEach(add);
+    groupableFields(m).forEach(add);
+    inlineKeys(m).forEach(add);
+    add(inlineImageKey(m));
+    add(coverKey(m));
+    const sel = m.views?.select;
+    if (sel) {
+        add(sel.icon);
+        (Array.isArray(sel.title) ? sel.title : [sel.title]).forEach(add);
+        add(sel.subtitle);
+    }
+    return ['id', ...out];
+}
+export function storageColumnsFor(m, keys) {
+    const fm = fieldMap(m.fields);
+    const out = new Set(['id']);
+    for (const k of keys) {
+        const f = fm[k];
+        if (!f || f.virtual)
+            continue;
+        for (const [col] of storageColumns(k, f))
+            out.add(col);
+    }
+    return [...out];
+}
 export function buildShape(fields, partial) {
     const shape = {};
     for (const it of fields) {

package/package.json

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