@coffer-org/sdk 1.3.0 → 1.4.0

package/dist/fields.d.ts

@@ -201,8 +201,7 @@ 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 declare function applyMultiple(base: FieldMeta, multiple: boolean): FieldMeta;
-export interface StringOpts extends FieldCoreOpts {
-}
+export type StringOpts = FieldCoreOpts;
 export declare function string(o: StringOpts & {
     key: string;
 }): FieldItem;
@@ -214,10 +213,8 @@ export declare function string(o: StringOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface LocalPathOpts extends FieldCoreOpts {
-}
-export interface LocalFileOpts extends LocalPathOpts {
-}
+export type LocalPathOpts = FieldCoreOpts;
+export type LocalFileOpts = LocalPathOpts;
 export declare function localDir(o: LocalPathOpts & {
     key: string;
 }): FieldItem;
@@ -240,8 +237,7 @@ export declare function localFile(o: LocalFileOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface TextOpts extends FieldCoreOpts {
-}
+export type TextOpts = FieldCoreOpts;
 export declare function text(o: TextOpts & {
     key: string;
 }): FieldItem;
@@ -275,8 +271,7 @@ export declare function smallText(o: TextOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface RealOpts extends FieldCoreOpts {
-}
+export type RealOpts = FieldCoreOpts;
 export declare function real(o: RealOpts & {
     key: string;
 }): FieldItem;
@@ -288,8 +283,7 @@ export declare function real(o: RealOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface IntOpts extends FieldCoreOpts {
-}
+export type IntOpts = FieldCoreOpts;
 export declare function int(o: IntOpts & {
     key: string;
 }): FieldItem;
@@ -301,8 +295,7 @@ export declare function int(o: IntOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface DateOpts extends FieldCoreOpts {
-}
+export type DateOpts = FieldCoreOpts;
 export declare function date(o: DateOpts & {
     key: string;
 }): FieldItem;
@@ -314,8 +307,7 @@ export declare function date(o: DateOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface TimeOpts extends FieldCoreOpts {
-}
+export type TimeOpts = FieldCoreOpts;
 export declare function time(o: TimeOpts & {
     key: string;
 }): FieldItem;
@@ -327,8 +319,7 @@ export declare function time(o: TimeOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface DateTimeOpts extends FieldCoreOpts {
-}
+export type DateTimeOpts = FieldCoreOpts;
 export declare function datetime(o: DateTimeOpts & {
     key: string;
 }): FieldItem;
@@ -340,8 +331,7 @@ export declare function datetime(o: DateTimeOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface BooleanOpts extends FieldCoreOpts {
-}
+export type BooleanOpts = FieldCoreOpts;
 export declare function boolean(o: BooleanOpts & {
     key: string;
 }): FieldItem;
@@ -353,8 +343,7 @@ export declare function boolean(o: BooleanOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface TriStateOpts extends FieldCoreOpts {
-}
+export type TriStateOpts = FieldCoreOpts;
 export declare function triState(o: TriStateOpts & {
     key: string;
 }): FieldItem;
@@ -398,8 +387,7 @@ export declare function relation(o: RelationOpts & {
     value?: undefined;
 }): FieldMeta;
 export declare function bindSelectSourceZod(field: FieldMeta, values: string[]): void;
-export interface JsonOpts extends FieldCoreOpts {
-}
+export type JsonOpts = FieldCoreOpts;
 export declare function json(o: JsonOpts & {
     key: string;
 }): FieldItem;
@@ -439,8 +427,7 @@ export declare function measured(o: MeasuredOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface MoneyOpts extends FieldCoreOpts {
-}
+export type MoneyOpts = FieldCoreOpts;
 export declare function money(o: MoneyOpts & {
     key: string;
 }): FieldItem;
@@ -452,8 +439,7 @@ export declare function money(o: MoneyOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface CodeFieldOpts extends FieldCoreOpts {
-}
+export type CodeFieldOpts = FieldCoreOpts;
 export declare function code(o: CodeFieldOpts & {
     key: string;
 }): FieldItem;
@@ -465,8 +451,7 @@ export declare function code(o: CodeFieldOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface GeoOpts extends FieldCoreOpts {
-}
+export type GeoOpts = FieldCoreOpts;
 export declare function geo(o: GeoOpts & {
     key: string;
 }): FieldItem;
@@ -518,8 +503,7 @@ export declare function period(o: PeriodOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface FileOpts extends FieldCoreOpts {
-}
+export type FileOpts = FieldCoreOpts;
 export type ImageOpts = FileOpts;
 export declare function file(o: FileOpts & {
     key: string;
@@ -629,8 +613,7 @@ export interface KeyValueOpts extends FieldCoreOpts {
 export declare function keyValue(raw: KeyValueOpts & {
     key: string;
 }): GroupEl;
-export interface RangeOpts extends FieldCoreOpts {
-}
+export type RangeOpts = FieldCoreOpts;
 export declare function numberRange(o: RangeOpts & {
     key: string;
 }): FieldItem;
@@ -653,8 +636,7 @@ export declare function realRange(o: RangeOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
-export interface EmbedOpts extends FieldCoreOpts {
-}
+export type EmbedOpts = FieldCoreOpts;
 export declare function embed(o: EmbedOpts & {
     key: string;
 }): FieldItem;

package/dist/logger.d.ts

@@ -0,0 +1,18 @@
+export interface Logger {
+    debug(msg: string, extra?: Record<string, unknown>): void;
+    info(msg: string, extra?: Record<string, unknown>): void;
+    warn(msg: string, extra?: unknown): void;
+    error(msg: string, extra?: unknown): void;
+}
+export interface RootLogger {
+    child(bindings: Record<string, unknown>): RootLogger;
+    debug(obj: unknown, msg?: string): void;
+    info(obj: unknown, msg?: string): void;
+    warn(obj: unknown, msg?: string): void;
+    error(obj: unknown, msg?: string): void;
+}
+export declare const LOG_LEVEL: string;
+export declare function parseTags(raw: string | undefined): Set<string>;
+export declare function tagEnabled(tag: string, tags: Set<string>): boolean;
+export declare function setRootLogger(l: RootLogger | null): void;
+export declare function getLogger(tag: string): Logger;

package/dist/logger.js

@@ -0,0 +1,57 @@
+const LEVEL_NUM = { trace: 10, debug: 20, info: 30, warn: 40, error: 50 };
+export const LOG_LEVEL = process.env.LOG_LEVEL ?? 'info';
+export function parseTags(raw) {
+    return new Set((raw ?? '')
+        .split(',')
+        .map((t) => t.trim())
+        .filter(Boolean));
+}
+export function tagEnabled(tag, tags) {
+    return tags.size === 0 || tags.has(tag);
+}
+const TAGS = parseTags(process.env.LOG_TAGS);
+const CONSOLE_THRESHOLD = LEVEL_NUM[LOG_LEVEL] ?? LEVEL_NUM.info;
+let root = null;
+const children = new Map();
+export function setRootLogger(l) {
+    root = l;
+    children.clear();
+}
+export function getLogger(tag) {
+    const emit = (level, msg, extra) => {
+        if (!tagEnabled(tag, TAGS))
+            return;
+        if (root) {
+            let child = children.get(tag);
+            if (!child) {
+                child = root.child({ tag });
+                children.set(tag, child);
+            }
+            if (extra === undefined)
+                child[level](msg);
+            else if (extra instanceof Error)
+                child[level]({ err: extra }, msg);
+            else if (typeof extra === 'object')
+                child[level](extra, msg);
+            else
+                child[level]({ err: extra }, msg);
+            return;
+        }
+        if (LEVEL_NUM[level] < CONSOLE_THRESHOLD)
+            return;
+        const line = `[${tag}] ${msg}`;
+        const rest = extra === undefined ? [] : [extra];
+        if (level === 'error')
+            console.error(line, ...rest);
+        else if (level === 'warn')
+            console.warn(line, ...rest);
+        else
+            console.log(line, ...rest);
+    };
+    return {
+        debug: (msg, extra) => emit('debug', msg, extra),
+        info: (msg, extra) => emit('info', msg, extra),
+        warn: (msg, extra) => emit('warn', msg, extra),
+        error: (msg, extra) => emit('error', msg, extra),
+    };
+}

package/package.json

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