@coffer-org/sdk 2.1.3 → 2.2.1

package/dist/countries.js

@@ -144,7 +144,12 @@ export const COUNTRIES = [
     { code: 'RW', name: 'Руанда', nameRu: 'Руанда', nameEn: 'Rwanda' },
     { code: 'KN', name: 'Сент-Кітс і Невіс', nameRu: 'Сент-Китс и Невис', nameEn: 'St. Kitts & Nevis' },
     { code: 'LC', name: 'Сент-Люсія', nameRu: 'Сент-Люсия', nameEn: 'St. Lucia' },
-    { code: 'VC', name: 'Сент-Вінсент і Гренадіни', nameRu: 'Сент-Винсент и Гренадины', nameEn: 'St. Vincent & Grenadines' },
+    {
+        code: 'VC',
+        name: 'Сент-Вінсент і Гренадіни',
+        nameRu: 'Сент-Винсент и Гренадины',
+        nameEn: 'St. Vincent & Grenadines',
+    },
     { code: 'WS', name: 'Самоа', nameRu: 'Самоа', nameEn: 'Samoa' },
     { code: 'SM', name: 'Сан-Марино', nameRu: 'Сан-Марино', nameEn: 'San Marino' },
     { code: 'ST', name: 'Сан-Томе і Принсіпі', nameRu: 'Сан-Томе и Принсипи', nameEn: 'São Tomé & Príncipe' },

package/dist/field-presets.d.ts

@@ -152,6 +152,22 @@ export declare function snippet(o: CodeOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
+export declare const SOURCE_DEFAULT_MAX_BYTES = 262144;
+export declare function isBinaryText(v: string): boolean;
+export interface SourceOpts extends FieldCoreOpts {
+    label?: string;
+}
+export declare function source(o: SourceOpts & {
+    key: string;
+}): FieldItem;
+export declare function source(o: SourceOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function source(o: SourceOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
 export interface RatingOpts extends FieldCoreOpts {
     label?: string;
 }
@@ -242,6 +258,7 @@ export declare const presets: {
     tags: typeof tags;
     markdown: typeof markdown;
     snippet: typeof snippet;
+    source: typeof source;
     rating: typeof rating;
     duration: typeof duration;
     reminder: typeof reminder;

package/dist/field-presets.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { real, int, text, date, select, string, group, vmsg, jsonRefined, typeErr, optionalize, applyMultiple, wrapKey, normalizeOpts, } from "./fields.js";
+import { real, int, text, date, select, string, group, vmsg, jsonRefined, typeErr, reqTypeErr, optionalize, applyMultiple, wrapKey, normalizeOpts, } from "./fields.js";
 export function email(raw) {
     const o = normalizeOpts(raw);
     const required = o.required ?? false;
@@ -71,11 +71,7 @@ export function internalOauthGrants(o) {
         label: o.label ?? o.key,
         multiple: true,
         view: { kind: 'internalOauthGrants' },
-        fields: [
-            string({ key: 'clientName' }),
-            string({ key: 'createdAt' }),
-            string({ key: 'lastUsedAt' }),
-        ],
+        fields: [string({ key: 'clientName' }), string({ key: 'createdAt' }), string({ key: 'lastUsedAt' })],
     });
 }
 const SLUG_RE = /^[a-z0-9-]+$/;
@@ -164,24 +160,155 @@ export function link(raw) {
 const TEL_RE = /^\+?[\d\s()-]{4,}$/;
 const LINK_RE = /^([a-z][a-z0-9+.-]*:\/\/\S+|[\w-]+(\.[\w-]+)+(:\d+)?(\/\S*)?)$/i;
 const CSS_COLOR_NAMES = new Set([
-    'aliceblue', 'antiquewhite', 'aqua', 'aquamarine', 'azure', 'beige', 'bisque', 'black', 'blanchedalmond', 'blue',
-    'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk',
-    'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki',
-    'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen',
-    'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue',
-    'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'fuchsia', 'gainsboro', 'ghostwhite',
-    'gold', 'goldenrod', 'gray', 'green', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory',
-    'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan',
-    'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen',
-    'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'lime', 'limegreen', 'linen',
-    'magenta', 'maroon', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen',
-    'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream',
-    'mistyrose', 'moccasin', 'navajowhite', 'navy', 'oldlace', 'olive', 'olivedrab', 'orange', 'orangered', 'orchid',
-    'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum',
-    'powderblue', 'purple', 'rebeccapurple', 'red', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown',
-    'seagreen', 'seashell', 'sienna', 'silver', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen',
-    'steelblue', 'tan', 'teal', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'white', 'whitesmoke', 'yellow',
-    'yellowgreen', 'transparent',
+    'aliceblue',
+    'antiquewhite',
+    'aqua',
+    'aquamarine',
+    'azure',
+    'beige',
+    'bisque',
+    'black',
+    'blanchedalmond',
+    'blue',
+    'blueviolet',
+    'brown',
+    'burlywood',
+    'cadetblue',
+    'chartreuse',
+    'chocolate',
+    'coral',
+    'cornflowerblue',
+    'cornsilk',
+    'crimson',
+    'cyan',
+    'darkblue',
+    'darkcyan',
+    'darkgoldenrod',
+    'darkgray',
+    'darkgreen',
+    'darkgrey',
+    'darkkhaki',
+    'darkmagenta',
+    'darkolivegreen',
+    'darkorange',
+    'darkorchid',
+    'darkred',
+    'darksalmon',
+    'darkseagreen',
+    'darkslateblue',
+    'darkslategray',
+    'darkslategrey',
+    'darkturquoise',
+    'darkviolet',
+    'deeppink',
+    'deepskyblue',
+    'dimgray',
+    'dimgrey',
+    'dodgerblue',
+    'firebrick',
+    'floralwhite',
+    'forestgreen',
+    'fuchsia',
+    'gainsboro',
+    'ghostwhite',
+    'gold',
+    'goldenrod',
+    'gray',
+    'green',
+    'greenyellow',
+    'grey',
+    'honeydew',
+    'hotpink',
+    'indianred',
+    'indigo',
+    'ivory',
+    'khaki',
+    'lavender',
+    'lavenderblush',
+    'lawngreen',
+    'lemonchiffon',
+    'lightblue',
+    'lightcoral',
+    'lightcyan',
+    'lightgoldenrodyellow',
+    'lightgray',
+    'lightgreen',
+    'lightgrey',
+    'lightpink',
+    'lightsalmon',
+    'lightseagreen',
+    'lightskyblue',
+    'lightslategray',
+    'lightslategrey',
+    'lightsteelblue',
+    'lightyellow',
+    'lime',
+    'limegreen',
+    'linen',
+    'magenta',
+    'maroon',
+    'mediumaquamarine',
+    'mediumblue',
+    'mediumorchid',
+    'mediumpurple',
+    'mediumseagreen',
+    'mediumslateblue',
+    'mediumspringgreen',
+    'mediumturquoise',
+    'mediumvioletred',
+    'midnightblue',
+    'mintcream',
+    'mistyrose',
+    'moccasin',
+    'navajowhite',
+    'navy',
+    'oldlace',
+    'olive',
+    'olivedrab',
+    'orange',
+    'orangered',
+    'orchid',
+    'palegoldenrod',
+    'palegreen',
+    'paleturquoise',
+    'palevioletred',
+    'papayawhip',
+    'peachpuff',
+    'peru',
+    'pink',
+    'plum',
+    'powderblue',
+    'purple',
+    'rebeccapurple',
+    'red',
+    'rosybrown',
+    'royalblue',
+    'saddlebrown',
+    'salmon',
+    'sandybrown',
+    'seagreen',
+    'seashell',
+    'sienna',
+    'silver',
+    'skyblue',
+    'slateblue',
+    'slategray',
+    'slategrey',
+    'snow',
+    'springgreen',
+    'steelblue',
+    'tan',
+    'teal',
+    'thistle',
+    'tomato',
+    'turquoise',
+    'violet',
+    'wheat',
+    'white',
+    'whitesmoke',
+    'yellow',
+    'yellowgreen',
+    'transparent',
 ]);
 export function tag(raw) {
     const o = normalizeOpts(raw);
@@ -225,6 +352,34 @@ export function snippet(raw) {
     };
     return wrapKey(norm, meta);
 }
+export const SOURCE_DEFAULT_MAX_BYTES = 262_144;
+export function isBinaryText(v) {
+    return v.includes('\x00') || v.includes('�');
+}
+export function source(raw) {
+    const o = normalizeOpts(raw);
+    const required = o.required ?? false;
+    const ext = o.ext ?? 'txt';
+    const maxBytes = o.maxBytes ?? SOURCE_DEFAULT_MAX_BYTES;
+    const s = z.string(reqTypeErr()).superRefine((v, ctx) => {
+        if (isBinaryText(v)) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: vmsg('source_binary') });
+            return;
+        }
+        if (new TextEncoder().encode(v).length > maxBytes)
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: vmsg('source_too_large', { maxBytes }) });
+    });
+    const meta = {
+        kind: 'source',
+        label: o.label ?? '',
+        required,
+        prim: 'text',
+        column: 'text',
+        hints: { ext, maxBytes, noEditControl: true },
+        zod: optionalize(s, required),
+    };
+    return wrapKey(o, meta);
+}
 export function rating(raw) {
     const o = normalizeOpts(raw);
     const required = o.required ?? false;
@@ -328,6 +483,7 @@ export const presets = {
     tags,
     markdown,
     snippet,
+    source,
     rating,
     duration,
     reminder,

package/dist/fields/normalize.d.ts

@@ -13,6 +13,8 @@ export interface Rules {
     unique?: string[];
     fixed?: boolean;
     exts?: string[];
+    ext?: string;
+    maxBytes?: number;
     lead?: number;
     by?: FieldItem;
 }
@@ -66,6 +68,8 @@ export type NormalizedOpts = {
     unique?: string[];
     fixed?: boolean;
     exts?: string[];
+    ext?: string;
+    maxBytes?: number;
     lead?: number;
     by?: FieldItem;
     min?: number | string;

package/dist/fields/normalize.js

@@ -28,6 +28,8 @@ export function normalizeOpts(rawIn) {
         unique: r.unique,
         fixed: r.fixed,
         exts: r.exts,
+        ext: r.ext,
+        maxBytes: r.maxBytes,
         lead: r.lead,
         by: r.by,
         min: r.min,

package/dist/fields.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export { vmsg, reqErr, typeErr, reqTypeErr, jsonRefined, optionalize, jsonValue, decodeVmsg, validateField } from './fields/validation.ts';
+export { vmsg, reqErr, typeErr, reqTypeErr, jsonRefined, optionalize, jsonValue, decodeVmsg, validateField, } from './fields/validation.ts';
 import type { Condition } from './condition.ts';
 export type { Rules, View, FieldConfig } from './fields/normalize.ts';
 export { normalizeOpts } from './fields/normalize.ts';
@@ -355,7 +355,7 @@ export declare function triState(o: TriStateOpts & {
     value?: undefined;
 }): FieldMeta;
 export interface SelectOpts extends FieldCoreOpts {
-    options?: FieldOptions;
+    options?: string | (OptionItem | string)[];
 }
 export declare function select(o: SelectOpts & {
     key: string;

package/dist/fields.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { resolveUnits } from "./units.js";
 import { isCurrencyCode } from "./currencies.js";
 import { vmsg, reqErr, typeErr, reqTypeErr, jsonRefined, optionalize, jsonValue } from "./fields/validation.js";
-export { vmsg, reqErr, typeErr, reqTypeErr, jsonRefined, optionalize, jsonValue, decodeVmsg, validateField } from "./fields/validation.js";
+export { vmsg, reqErr, typeErr, reqTypeErr, jsonRefined, optionalize, jsonValue, decodeVmsg, validateField, } from "./fields/validation.js";
 export { normalizeOpts } from "./fields/normalize.js";
 import { normalizeOpts } from "./fields/normalize.js";
 import { presets } from "./field-presets.js";
@@ -185,7 +185,13 @@ export function applyMultiple(base, multiple) {
     if (!multiple)
         return base;
     const s = multipleZod(base.zod);
-    return { ...base, column: 'text', hints: { ...base.hints, multiple: true }, json: true, zod: optionalize(s, base.required) };
+    return {
+        ...base,
+        column: 'text',
+        hints: { ...base.hints, multiple: true },
+        json: true,
+        zod: optionalize(s, base.required),
+    };
 }
 export function string(raw) {
     const o = normalizeOpts(raw);
@@ -421,11 +427,14 @@ export function triState(raw) {
     };
     return wrapKey(o, meta);
 }
+function toOptionItem(o) {
+    return typeof o === 'string' ? { value: o, title: o } : o;
+}
 export function select(raw) {
     const o = normalizeOpts(raw);
     const required = o.required ?? false;
     const source = typeof o.options === 'string' ? o.options : null;
-    const inlineOpts = Array.isArray(o.options) ? o.options : [];
+    const inlineOpts = Array.isArray(o.options) ? o.options.map(toOptionItem) : [];
     const s = inlineOpts.length > 0
         ? z.enum(inlineOpts.map((x) => x.value), { error: () => vmsg('enum') })
         : z.string(reqErr());
@@ -455,7 +464,10 @@ export function relation(raw) {
         });
     }
     else {
-        s = z.coerce.number().int().positive({ message: vmsg('int') });
+        s = z.coerce
+            .number()
+            .int()
+            .positive({ message: vmsg('int') });
     }
     const meta = {
         kind: 'relation',
@@ -509,9 +521,7 @@ export function check(raw) {
     const required = o.required ?? false;
     const multiple = o.multiple ?? false;
     const slots = o.slots && o.slots.length > 0 ? o.slots : [''];
-    const contentFields = o.fields?.length
-        ? o.fields
-        : [string({ key: 'text', label: 'core.fields.text' })];
+    const contentFields = o.fields?.length ? o.fields : [string({ key: 'text', label: 'core.fields.text' })];
     const contentKeys = new Set();
     for (const f of contentFields) {
         if (contentKeys.has(f.key))
@@ -525,7 +535,14 @@ export function check(raw) {
     const checkFields = slots.map((label, i) => boolean({ key: `check${i}`, label: label || 'core.fields.check' }));
     if (multiple) {
         const fields = [...checkFields, ...contentFields];
-        return group({ key: o.key, label: o.label ?? o.key, multiple: true, required: required, fields, view: { kind: 'checklist' } });
+        return group({
+            key: o.key,
+            label: o.label ?? o.key,
+            multiple: true,
+            required: required,
+            fields,
+            view: { kind: 'checklist' },
+        });
     }
     const shape = {};
     const columns = {};

package/dist/shelf.d.ts

@@ -24,6 +24,7 @@ export interface ShelfDef {
     icon?: string;
     claude?: string;
     standalone?: boolean;
+    single?: boolean;
     views?: ShelfViews;
     fields: LayoutEl[];
 }

package/dist/shelf.js

@@ -68,7 +68,9 @@ 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?.list?.fields?.length)
+    if (m.single && !m.claude)
+        throw new Error(`[shelf] ${m.library}/${m.shelf}: single shelf requires \`claude\` — the agent cannot find it otherwise`);
+    if (m.standalone !== false && !m.single && !m.views?.list?.fields?.length)
         console.warn(`[shelf] ${m.library}/${m.shelf}: standalone shelf without an explicit views.list`);
     return m;
 }

package/package.json

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