@nestjs-dash/core 0.0.1 → 0.1.0

package/dist/forms/json-fields.js

@@ -1,5 +1,5 @@
-import { jsonTextareaFieldKey } from '@nestjs-dash/support';
-const JSON_ARRAY_FIELD_KINDS = new Set(['tags-input', 'repeater']);
+import { jsonTextareaFieldKey } from "@nestjs-dash/support";
+const JSON_ARRAY_FIELD_KINDS = new Set(["tags-input", "repeater"]);
 export function collectJsonArrayFields(node) {
     if (!node)
         return [];
@@ -15,7 +15,7 @@ export function collectJsonArrayFields(node) {
 function parseJsonArray(raw) {
     if (Array.isArray(raw))
         return raw;
-    if (typeof raw !== 'string' || raw.trim() === '')
+    if (typeof raw !== "string" || raw.trim() === "")
         return [];
     try {
         const parsed = JSON.parse(raw);
@@ -31,14 +31,14 @@ export function parseJsonArrayFields(body, form) {
         return body;
     const payload = { ...body };
     for (const field of fields) {
-        const name = String(field.name ?? field.props.name ?? '');
+        const name = String(field.name ?? field.props.name ?? "");
         if (!name || !(name in payload))
             continue;
         payload[name] = parseJsonArray(payload[name]);
     }
     return payload;
 }
-const JSON_PROJECTABLE_FIELD_KINDS = new Set(['textarea', 'rich-box']);
+const JSON_PROJECTABLE_FIELD_KINDS = new Set(["textarea", "rich-box"]);
 export function collectJsonTextareaFields(node) {
     if (!node)
         return [];
@@ -52,14 +52,14 @@ export function collectJsonTextareaFields(node) {
     return out;
 }
 function isPlainObject(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
+    return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseJsonValue(raw) {
     if (raw == null)
         return null;
-    if (typeof raw !== 'string')
+    if (typeof raw !== "string")
         return raw;
-    if (raw.trim() === '')
+    if (raw.trim() === "")
         return null;
     try {
         return JSON.parse(raw);
@@ -75,10 +75,10 @@ export function parseJsonTextareaFields(body, form, existingRecord) {
     const payload = { ...body };
     const merged = new Map();
     for (const field of fields) {
-        const name = String(field.name ?? field.props.name ?? '');
+        const name = String(field.name ?? field.props.name ?? "");
         if (!name)
             continue;
-        const property = typeof field.props.jsonProperty === 'string' ? field.props.jsonProperty : undefined;
+        const property = typeof field.props.jsonProperty === "string" ? field.props.jsonProperty : undefined;
         const inputKey = jsonTextareaFieldKey(name, property);
         if (!(inputKey in payload))
             continue;
@@ -105,18 +105,18 @@ export function stringifyJsonTextareaFields(values, form) {
         return values;
     const result = { ...values };
     for (const field of fields) {
-        const name = String(field.name ?? field.props.name ?? '');
+        const name = String(field.name ?? field.props.name ?? "");
         if (!name || !(name in values))
             continue;
-        const property = typeof field.props.jsonProperty === 'string' ? field.props.jsonProperty : undefined;
+        const property = typeof field.props.jsonProperty === "string" ? field.props.jsonProperty : undefined;
         const original = values[name];
         if (property) {
             const source = isPlainObject(original) ? original[property] : undefined;
             result[jsonTextareaFieldKey(name, property)] =
-                source == null ? '' : typeof source === 'string' ? source : JSON.stringify(source);
+                source == null ? "" : typeof source === "string" ? source : JSON.stringify(source);
         }
-        else if (typeof original !== 'string') {
-            result[name] = original == null ? '' : JSON.stringify(original, null, 2);
+        else if (typeof original !== "string") {
+            result[name] = original == null ? "" : JSON.stringify(original, null, 2);
         }
     }
     return result;

package/dist/forms/validation.d.ts

@@ -1,5 +1,5 @@
-import type { SchemaNode } from '@nestjs-dash/support';
-import type { ZodType } from 'zod';
+import type { SchemaNode } from "@nestjs-dash/support";
+import type { ZodType } from "zod";
 export declare function registerFieldValidation(schema: ZodType): string;
 export declare function resolveFieldValidation(key: string): ZodType | undefined;
 export declare function collectFieldValidations(node: SchemaNode | undefined | null): Array<{

package/dist/forms/validation.js

@@ -14,9 +14,9 @@ export function collectFieldValidations(node) {
         return [];
     const out = [];
     const key = node.props.validationKey;
-    if (typeof key === 'string') {
+    if (typeof key === "string") {
         const schema = resolveFieldValidation(key);
-        const name = String(node.name ?? node.props.name ?? '');
+        const name = String(node.name ?? node.props.name ?? "");
         if (schema && name) {
             out.push({ name, schema });
         }

package/dist/index.d.ts

@@ -1,21 +1,21 @@
-import { type DatabaseAdapter, type ListQueryConfig, type RecordData, type RelationDefinition, type RelationType, type ResourceAdapter } from '@nestjs-dash/adapter';
-import type { ChartSpec, SchemaNode } from '@nestjs-dash/support';
-import { Schema } from './schemas/index.js';
-import { Table, type TableSchema } from './tables/index.js';
-import type { PanelThemeColors, PanelThemeOverrides } from './theme/index.js';
-export * from '@nestjs-dash/adapter';
-export * from './actions/index.js';
-export * from './charts/index.js';
-export * from './forms/index.js';
-export * from './schemas/index.js';
-export * from './tables/index.js';
-export * from './theme/index.js';
-export * from '@nestjs-dash/support';
-export type ResourceApiMethod = 'list' | 'get' | 'create' | 'update' | 'delete';
+import { type DatabaseAdapter, type ListQueryConfig, type RecordData, type RelationDefinition, type RelationType, type ResourceAdapter } from "@nestjs-dash/adapter";
+import type { ChartSpec, SchemaNode } from "@nestjs-dash/support";
+import { Schema } from "./schemas/index.js";
+import { Table, type TableSchema } from "./tables/index.js";
+import type { PanelThemeColors, PanelThemeOverrides } from "./theme/index.js";
+export * from "@nestjs-dash/adapter";
+export * from "./actions/index.js";
+export * from "./charts/index.js";
+export * from "./forms/index.js";
+export * from "./schemas/index.js";
+export * from "./tables/index.js";
+export * from "./theme/index.js";
+export * from "@nestjs-dash/support";
+export type ResourceApiMethod = "list" | "get" | "create" | "update" | "delete";
 export interface ResourceApiFieldConfig {
-    create?: string[] | '*';
-    update?: string[] | '*';
-    response?: string[] | '*';
+    create?: string[] | "*";
+    update?: string[] | "*";
+    response?: string[] | "*";
 }
 export interface ResourceApiConfig {
     enabled?: boolean;
@@ -106,16 +106,16 @@ export type ResourcePanelClass = {
     new (...args: never[]): ResourcePanelInstance;
 };
 export interface DashboardWidget {
-    slot?: 'main' | 'side';
+    slot?: "main" | "side";
     render?(ctx: PageRenderContext): string | Promise<string>;
     chart?(ctx: PageRenderContext): ChartSpec | Promise<ChartSpec>;
     canAccess?(ctx: AdminPolicyContext): boolean | Promise<boolean>;
 }
 export type DashboardWidgetPayload = {
-    type: 'html';
+    type: "html";
     html: string;
 } | {
-    type: 'chart';
+    type: "chart";
     chart: ChartSpec;
 };
 export type DashboardWidgets = {
@@ -132,7 +132,7 @@ export interface AdminPolicyContext {
     request: unknown;
     action?: string;
 }
-export type NavigationItemType = 'resource' | 'page' | 'link';
+export type NavigationItemType = "resource" | "page" | "link";
 export interface NavigationItem {
     label: string;
     slug: string;
@@ -171,9 +171,9 @@ export interface SerializedResourceApi {
     enabled: boolean;
     methods: readonly ResourceApiMethod[];
     fields: {
-        create: string[] | '*';
-        update: string[] | '*';
-        response: string[] | '*';
+        create: string[] | "*";
+        update: string[] | "*";
+        response: string[] | "*";
     };
     strict: boolean;
 }
@@ -279,8 +279,8 @@ export declare function resolveResourceSlug(resource: ResourceClass): string;
 export declare function resolveResourceLabel(resource: ResourceClass): string;
 export declare function extractFormFieldNames(form: SchemaNode | null): string[];
 export declare function resolveResourceApi(resource: ResourceClass, form: SchemaNode | null): SerializedResourceApi;
-export declare function pickFields(data: Record<string, unknown>, allowed: string[] | '*'): Record<string, unknown>;
-export declare function assertAllowedFields(data: Record<string, unknown>, allowed: string[] | '*', strict: boolean): {
+export declare function pickFields(data: Record<string, unknown>, allowed: string[] | "*"): Record<string, unknown>;
+export declare function assertAllowedFields(data: Record<string, unknown>, allowed: string[] | "*", strict: boolean): {
     data: Record<string, unknown>;
     rejected: string[];
 };
@@ -306,7 +306,7 @@ export declare class Panel {
     path(value: string): this;
     apiPath(value: string): this;
     brandName(value: string): this;
-    theme(value: 'light' | 'dark' | 'system'): this;
+    theme(value: "light" | "dark" | "system"): this;
     stylesheetUrl(value: string): this;
     colors(value: PanelThemeColors): this;
     darkColors(value: PanelThemeColors): this;
@@ -330,7 +330,7 @@ export declare class Panel {
     getPath(): string;
     getApiPath(): string;
     getBrandName(): string;
-    getTheme(): 'light' | 'dark' | 'system';
+    getTheme(): "light" | "dark" | "system";
     getStylesheetUrl(): string | null;
     getThemeOverrides(): PanelThemeOverrides;
     getResources(): ResourceClass[];
@@ -349,5 +349,5 @@ export declare class Panel {
 }
 export declare function resolvePageSlug(page: PageClass): string;
 export declare function groupNavigationItems(items: NavigationItem[]): NavigationGroup[];
-export type { RelationDefinition, RelationType } from '@nestjs-dash/adapter';
+export type { RelationDefinition, RelationType } from "@nestjs-dash/adapter";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,18 +1,18 @@
-import { isSoftDeleteCapable, } from '@nestjs-dash/adapter';
-import { Schema } from './schemas/index.js';
-import { Table } from './tables/index.js';
-export * from '@nestjs-dash/adapter';
-export * from './actions/index.js';
-export * from './charts/index.js';
-export * from './forms/index.js';
-export * from './schemas/index.js';
-export * from './tables/index.js';
-export * from './theme/index.js';
-export * from '@nestjs-dash/support';
+import { isSoftDeleteCapable, } from "@nestjs-dash/adapter";
+import { Schema } from "./schemas/index.js";
+import { Table } from "./tables/index.js";
+export * from "@nestjs-dash/adapter";
+export * from "./actions/index.js";
+export * from "./charts/index.js";
+export * from "./forms/index.js";
+export * from "./schemas/index.js";
+export * from "./tables/index.js";
+export * from "./theme/index.js";
+export * from "@nestjs-dash/support";
 export class NavigationLink {
     data;
     constructor(label) {
-        this.data = { label, url: '#' };
+        this.data = { label, url: "#" };
     }
     static make(label) {
         return new NavigationLink(label);
@@ -42,9 +42,9 @@ export class NavigationLink {
         return this;
     }
     toNavigationItem(panelPath) {
-        const href = this.data.url.startsWith('http')
+        const href = this.data.url.startsWith("http")
             ? this.data.url
-            : this.data.url.startsWith('/')
+            : this.data.url.startsWith("/")
                 ? this.data.url
                 : `${panelPath}/${this.data.url}`;
         return {
@@ -52,10 +52,10 @@ export class NavigationLink {
             slug: this.data.slug ??
                 this.data.label
                     .toLowerCase()
-                    .replace(/[^a-z0-9]+/g, '-')
-                    .replace(/^-|-$/g, ''),
+                    .replace(/[^a-z0-9]+/g, "-")
+                    .replace(/^-|-$/g, ""),
             href,
-            type: 'link',
+            type: "link",
             group: this.data.group ?? null,
             sort: this.data.sort ?? 100,
             icon: this.data.icon,
@@ -90,8 +90,8 @@ export class Page {
     }
 }
 export class RelationManager {
-    static relationship = '';
-    static type = 'has-many';
+    static relationship = "";
+    static type = "has-many";
     static title;
     static icon;
     static relatedResource;
@@ -106,9 +106,9 @@ export class RelationManager {
 }
 function humanize(value) {
     return value
-        .replace(/([a-z])([A-Z])/g, '$1 $2')
-        .replace(/[-_]/g, ' ')
-        .replace(/\s+resource$/i, '')
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/[-_]/g, " ")
+        .replace(/\s+resource$/i, "")
         .trim();
 }
 export function resolveResourceSlug(resource) {
@@ -116,8 +116,8 @@ export function resolveResourceSlug(resource) {
         return resource.slug;
     }
     return resource.name
-        .replace(/Resource$/i, '')
-        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/Resource$/i, "")
+        .replace(/([a-z])([A-Z])/g, "$1-$2")
         .toLowerCase();
 }
 export function resolveResourceLabel(resource) {
@@ -130,7 +130,7 @@ export function extractFormFieldNames(form) {
     const names = [];
     const walk = (nodes) => {
         for (const node of nodes) {
-            if (node.kind === 'html') {
+            if (node.kind === "html") {
                 continue;
             }
             if (node.children?.length) {
@@ -138,7 +138,7 @@ export function extractFormFieldNames(form) {
                 continue;
             }
             const name = node.name ?? node.props.name;
-            if (typeof name === 'string' && name.length > 0) {
+            if (typeof name === "string" && name.length > 0) {
                 names.push(name);
             }
         }
@@ -146,7 +146,7 @@ export function extractFormFieldNames(form) {
     walk(form.children);
     return names;
 }
-const ALL_API_METHODS = ['list', 'get', 'create', 'update', 'delete'];
+const ALL_API_METHODS = ["list", "get", "create", "update", "delete"];
 export function resolveResourceApi(resource, form) {
     const formFields = extractFormFieldNames(form);
     const config = resource.api ?? {};
@@ -154,15 +154,15 @@ export function resolveResourceApi(resource, form) {
         enabled: config.enabled !== false,
         methods: config.methods?.length ? config.methods : [...ALL_API_METHODS],
         fields: {
-            create: config.fields?.create ?? (formFields.length ? formFields : '*'),
-            update: config.fields?.update ?? (formFields.length ? formFields : '*'),
-            response: config.fields?.response ?? '*',
+            create: config.fields?.create ?? (formFields.length ? formFields : "*"),
+            update: config.fields?.update ?? (formFields.length ? formFields : "*"),
+            response: config.fields?.response ?? "*",
         },
         strict: config.strict !== false,
     };
 }
 export function pickFields(data, allowed) {
-    if (allowed === '*') {
+    if (allowed === "*") {
         return { ...data };
     }
     const result = {};
@@ -174,7 +174,7 @@ export function pickFields(data, allowed) {
     return result;
 }
 export function assertAllowedFields(data, allowed, strict) {
-    if (allowed === '*') {
+    if (allowed === "*") {
         return { data: { ...data }, rejected: [] };
     }
     const allowedSet = new Set(allowed);
@@ -193,16 +193,16 @@ export function serializeRelationManager(manager) {
     let tableSchema = null;
     let listQueryConfig = null;
     let formSchema = null;
-    if (typeof manager.table === 'function') {
+    if (typeof manager.table === "function") {
         const table = manager.table(Table.make());
         tableSchema = table.toSchema();
         listQueryConfig = table.toListQueryConfig();
     }
-    if (typeof manager.form === 'function') {
+    if (typeof manager.form === "function") {
         formSchema = manager.form(Schema.make()).toSchema();
     }
     const relatedResource = manager.relatedResource ?? relationship;
-    const ownerKey = manager.ownerKey ?? 'id';
+    const ownerKey = manager.ownerKey ?? "id";
     const pivotFields = manager.pivotFields ?? [];
     const definition = {
         name: relationship,
@@ -242,17 +242,17 @@ export function relationsFromResource(resource) {
     return (resource.relationManagers ?? []).map((manager) => serializeRelationManager(manager).definition);
 }
 export class Panel {
-    panelId = 'admin';
-    panelPath = '/admin';
-    panelApiPath = '/api';
-    panelBrand = 'Nestjs-Dash';
+    panelId = "admin";
+    panelPath = "/admin";
+    panelApiPath = "/api";
+    panelBrand = "Nestjs-Dash";
     resourceClasses = [];
     pageClasses = [];
     panelWidgets = [];
     customNavLinks = [];
     panelPlugins = [];
     adapters = [];
-    panelTheme = 'system';
+    panelTheme = "system";
     panelStylesheetUrl = null;
     panelThemeOverrides = {};
     panelNavigationOverrides = {};
@@ -264,11 +264,11 @@ export class Panel {
         return this;
     }
     path(value) {
-        this.panelPath = value.startsWith('/') ? value : `/${value}`;
+        this.panelPath = value.startsWith("/") ? value : `/${value}`;
         return this;
     }
     apiPath(value) {
-        this.panelApiPath = value.startsWith('/') ? value : `/${value}`;
+        this.panelApiPath = value.startsWith("/") ? value : `/${value}`;
         return this;
     }
     brandName(value) {
@@ -473,7 +473,7 @@ export class Panel {
                 label: resourceClass.navigationLabel ?? serialized.label,
                 slug,
                 href: `${this.panelPath}/${slug}`,
-                type: 'resource',
+                type: "resource",
                 group: resourceClass.navigationGroup ?? null,
                 sort: resourceClass.navigationSort ?? 0,
                 icon: resourceClass.navigationIcon,
@@ -488,7 +488,7 @@ export class Panel {
                 label: page.navigationLabel,
                 slug: page.slug,
                 href: `${this.panelPath}/pages/${page.slug}`,
-                type: 'page',
+                type: "page",
                 group: page.navigationGroup ?? null,
                 sort: page.navigationSort ?? 50,
                 icon: page.navigationIcon,
@@ -531,12 +531,12 @@ export class Panel {
         let tableSchema = null;
         let listQueryConfig = null;
         let formSchema = null;
-        if (typeof resource.table === 'function') {
+        if (typeof resource.table === "function") {
             const table = resource.table(Table.make());
             tableSchema = table.toSchema();
             listQueryConfig = table.toListQueryConfig();
         }
-        if (typeof resource.form === 'function') {
+        if (typeof resource.form === "function") {
             formSchema = resource.form(Schema.make()).toSchema();
         }
         const relationManagers = (resource.relationManagers ?? []).map((manager) => serializeRelationManager(manager));
@@ -562,16 +562,16 @@ export function resolvePageSlug(page) {
     if (page.slug) {
         return page.slug;
     }
-    return (page.name ?? 'page')
-        .replace(/Page$/i, '')
-        .replace(/([a-z])([A-Z])/g, '$1-$2')
+    return (page.name ?? "page")
+        .replace(/Page$/i, "")
+        .replace(/([a-z])([A-Z])/g, "$1-$2")
         .toLowerCase();
 }
 export function groupNavigationItems(items) {
     const order = [];
     const buckets = new Map();
     for (const item of items) {
-        const key = item.group?.trim() || '';
+        const key = item.group?.trim() || "";
         if (!buckets.has(key)) {
             buckets.set(key, []);
             order.push(key);
@@ -579,7 +579,7 @@ export function groupNavigationItems(items) {
         buckets.get(key).push(item);
     }
     return order.map((key) => ({
-        label: key || 'Main',
+        label: key || "Main",
         items: buckets.get(key) ?? [],
         collapsible: key.length > 0,
         collapsed: false,

package/dist/schemas/index.d.ts

@@ -1,36 +1,36 @@
-import type { JsonObject, SchemaNode } from '@nestjs-dash/support';
+import type { JsonObject, SchemaNode } from "@nestjs-dash/support";
 export declare abstract class ComponentBuilder {
-    abstract readonly kind: SchemaNode['kind'];
+    abstract readonly kind: SchemaNode["kind"];
     protected props: JsonObject;
     protected children: SchemaNode[];
     protected setProp(key: string, value: unknown): this;
     toSchema(): SchemaNode;
 }
 export declare class Schema extends ComponentBuilder {
-    readonly kind: 'schema';
+    readonly kind: "schema";
     static make(): Schema;
     components(components: ComponentBuilder[]): this;
 }
 export declare class Section extends ComponentBuilder {
-    readonly kind: 'section';
+    readonly kind: "section";
     static make(heading?: string): Section;
     components(components: ComponentBuilder[]): this;
     collapsible(value?: boolean): this;
 }
 export declare class Grid extends ComponentBuilder {
-    readonly kind: 'grid';
+    readonly kind: "grid";
     static make(columns?: number): Grid;
     components(components: ComponentBuilder[]): this;
 }
 export declare class Tab extends ComponentBuilder {
-    readonly kind: 'tab';
+    readonly kind: "tab";
     static make(label: string): Tab;
     id(value: string): this;
     icon(value: string): this;
     components(components: ComponentBuilder[]): this;
 }
 export declare class Tabs extends ComponentBuilder {
-    readonly kind: 'tabs';
+    readonly kind: "tabs";
     static make(): Tabs;
     tabs(items: Tab[]): this;
 }
@@ -41,14 +41,14 @@ export interface HtmlRenderContext {
         label: string;
     };
     path: string;
-    mode: 'create' | 'edit';
+    mode: "create" | "edit";
 }
 export type HtmlContentFn = (ctx: HtmlRenderContext) => string;
 export declare function resolveHtmlContent(key: string): HtmlContentFn | undefined;
 export declare class Html extends ComponentBuilder {
-    readonly kind: 'html';
+    readonly kind: "html";
     static make(content: string | HtmlContentFn): Html;
     key(value: string): this;
 }
-export { type SchemaNode } from '@nestjs-dash/support';
+export { type SchemaNode } from "@nestjs-dash/support";
 //# sourceMappingURL=index.d.ts.map