@nestledjs/data-browser 0.1.13 → 0.1.16

package/lib/types/index.d.ts

@@ -47,6 +47,9 @@ export type AdminListAction = {
     payload: Record<string, unknown>;
 } | {
     type: 'TOGGLE_FILTERS';
+} | {
+    type: 'SET_SHOW_FILTERS';
+    payload: boolean;
 } | {
     type: 'RESET_PAGINATION';
 } | {

package/lib/utils/get-plural-names.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pluralizes a word using the pluralize library, with special handling for words
+ * where the singular and plural forms are the same (like "data", "sheep").
+ * In those cases, appends "List" to make it clear it's a collection.
+ * Also includes overrides for known uncountable nouns that the pluralize library
+ * incorrectly pluralizes.
+ *
+ * @param name - The word to pluralize
+ * @returns The pluralized form, or the word + "List" if singular equals plural or is uncountable
+ *
+ * @example
+ * ```typescript
+ * getPluralName('user')     // 'users'
+ * getPluralName('category') // 'categories'
+ * getPluralName('data')     // 'dataList' (because 'data' plural is also 'data')
+ * getPluralName('sheep')    // 'sheepList' (because 'sheep' plural is also 'sheep')
+ * getPluralName('luggage')  // 'luggageList' (override: pluralize incorrectly returns 'luggages')
+ * getPluralName('furniture') // 'furnitureList' (override: pluralize incorrectly returns 'furnitures')
+ * ```
+ */
+export declare function getPluralName(name: string): string;

package/lib/utils/get-plural-names.js

@@ -0,0 +1,41 @@
+import pluralize from "pluralize";
+const UNCOUNTABLE_OVERRIDES = /* @__PURE__ */ new Set([
+  "advice",
+  "anger",
+  "art",
+  "beauty",
+  "courage",
+  "evidence",
+  "feedback",
+  "furniture",
+  "happiness",
+  "hardware",
+  "homework",
+  "housework",
+  "knowledge",
+  "love",
+  "luggage",
+  "music",
+  "news",
+  "progress",
+  "research",
+  "software",
+  "traffic",
+  "weather",
+  "wisdom"
+]);
+function getPluralName(name) {
+  if (!name || typeof name !== "string") {
+    throw new Error(
+      `getPluralName: name must be a non-empty string, received type: ${typeof name}, value: ${String(name)}`
+    );
+  }
+  if (UNCOUNTABLE_OVERRIDES.has(name.toLowerCase())) {
+    return name + "List";
+  }
+  const plural = pluralize(name);
+  return plural === name ? name + "List" : plural;
+}
+export {
+  getPluralName
+};

package/lib/utils/graphql-utils.d.ts

@@ -17,7 +17,7 @@ export declare function getMutationName(model: DatabaseModel, operation: 'create
 /**
  * Build form fields for a model and operation
  */
-export declare function buildFormFields(sdk: any, model: DatabaseModel, operation: 'create' | 'update', currentItem?: any, isSubmitting?: boolean, basePath?: string): FormField[];
+export declare function buildFormFields(sdk: any, model: DatabaseModel, operation: 'create' | 'update', currentItem?: any, isSubmitting?: boolean, basePath?: string, databaseModels?: DatabaseModel[]): FormField[];
 /**
  * Clean form input data for GraphQL mutations
  * Removes Apollo metadata and system fields

package/lib/utils/graphql-utils.js

@@ -1,8 +1,8 @@
 import React from "react";
 import { Link } from "react-router";
 import { FormFieldClass } from "@nestledjs/forms";
-import { getPluralName } from "@nestledjs/helpers";
 import { RelationFieldWrapper } from "../components/RelationFieldWrapper.js";
+import { getPluralName } from "./get-plural-names.js";
 function getEnumValues(sdk, enumType) {
   try {
     const enumObject = sdk[enumType];
@@ -16,7 +16,6 @@ function getEnumValues(sdk, enumType) {
     }
     return values;
   } catch (error) {
-    console.warn(`Failed to get enum values for type ${enumType}:`, error);
     return null;
   }
 }
@@ -53,15 +52,6 @@ function getAdminDocuments(sdk, model) {
   if (!documents.update) missingDocuments.push(updateDocumentName);
   if (!documents.delete) missingDocuments.push(deleteDocumentName);
   if (missingDocuments.length > 0) {
-    console.error(`[GraphQL Documents] Missing documents for model "${model.name}":`, {
-      model: model.name,
-      normalizedModelName,
-      normalizedPluralName,
-      missingDocuments,
-      availableDocuments: Object.keys(sdk).filter(
-        (key) => key.includes("Admin") && key.includes("Document")
-      )
-    });
     throw new Error(
       `Missing GraphQL documents for model "${model.name}": ${missingDocuments.join(", ")}. Please ensure the API server is running and the GraphQL schema is up to date.`
     );
@@ -88,7 +78,19 @@ function toLowerCamelCase(str) {
   if (!str) return "";
   return str.charAt(0).toLowerCase() + str.slice(1);
 }
-function buildFormFields(sdk, model, operation, currentItem, isSubmitting, basePath = "/admin/data") {
+function findForeignKeyFieldName(relatedModel, currentModelName, relationName) {
+  var _a;
+  if (!relatedModel) return null;
+  const foreignKeyField = relatedModel.fields.find((f) => {
+    if (f.type !== currentModelName) return false;
+    if (!f.relationName) return false;
+    if (f.isList) return false;
+    if (relationName && f.relationName !== relationName) return false;
+    return true;
+  });
+  return ((_a = foreignKeyField == null ? void 0 : foreignKeyField.relationFromFields) == null ? void 0 : _a[0]) || null;
+}
+function buildFormFields(sdk, model, operation, currentItem, isSubmitting, basePath = "/admin/data", databaseModels) {
   const editableFields = model.fields.filter((field) => {
     if (operation === "create" && field.isId) return false;
     if (field.isReadOnly || field.isGenerated) return false;
@@ -113,7 +115,6 @@ function buildFormFields(sdk, model, operation, currentItem, isSubmitting, baseP
             initialValue = isoString.substring(0, 16);
           }
         } catch (e) {
-          console.warn(`Failed to convert date value for field ${field.name}:`, e);
           initialValue = "";
         }
       }
@@ -261,9 +262,6 @@ function buildFormFields(sdk, model, operation, currentItem, isSubmitting, baseP
             });
             break;
           } else {
-            console.warn(
-              `GraphQL document ${adminDocumentName} or ${regularDocumentName} not found for relation ${field.type}. Using text input instead.`
-            );
             formField = FormFieldClass.text(relationFieldName, {
               label: `${label} ID`,
               required: options.required,
@@ -291,16 +289,17 @@ function buildFormFields(sdk, model, operation, currentItem, isSubmitting, baseP
     formFields.push(formField);
   });
   listRelationFields.forEach((field) => {
-    var _a, _b;
+    var _a;
     const label = field.name.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/^./, (str) => str.toUpperCase());
     if (operation === "update" && currentItem) {
       const pluralModelName = getPluralName(field.type);
       const relatedModelKebab = toKebabCase(pluralModelName);
       const displayName = field.type.replace(/([a-z])([A-Z])/g, "$1 $2");
       const pluralDisplayName = getPluralName(displayName);
-      const foreignKeyFieldName = ((_a = field.relationToFields) == null ? void 0 : _a[0]) || `${toLowerCamelCase(model.name)}Id`;
+      const relatedModel = databaseModels == null ? void 0 : databaseModels.find((m) => m.name === field.type);
+      const foreignKeyFieldName = findForeignKeyFieldName(relatedModel, model.name, field.relationName) || `${toLowerCamelCase(model.name)}Id`;
       const filterUrl = `${basePath}/${relatedModelKebab}?${foreignKeyFieldName}=${currentItem.id}`;
-      const countData = (_b = currentItem._count) == null ? void 0 : _b[field.name];
+      const countData = (_a = currentItem._count) == null ? void 0 : _a[field.name];
       const countText = countData !== void 0 ? ` (${countData})` : "";
       const formField = FormFieldClass.content(field.name, {
         content: React.createElement("div", { className: "py-2" }, [
@@ -384,7 +383,6 @@ function convertStringValue(value, field) {
       const date = new Date(value);
       return date.toISOString();
     } catch (e) {
-      console.warn(`Failed to convert datetime-local value: ${value}`);
       return value;
     }
   }

package/lib/utils/secure-storage.js

@@ -47,19 +47,16 @@ const SecureAdminLocalStorage = {
         return { version: ADMIN_CONFIG_VERSION, models: {} };
       }
       if (stored.length > MAX_CONFIG_SIZE) {
-        console.warn("[AdminLocalStorage] Config exceeds size limit, resetting");
         localStorage.removeItem(ADMIN_CONFIG_KEY);
         return { version: ADMIN_CONFIG_VERSION, models: {} };
       }
       const parsed = JSON.parse(stored);
       if (!validateAdminConfig(parsed)) {
-        console.warn("[AdminLocalStorage] Invalid config detected, resetting");
         localStorage.removeItem(ADMIN_CONFIG_KEY);
         return { version: ADMIN_CONFIG_VERSION, models: {} };
       }
       return parsed;
     } catch (error) {
-      console.warn("[AdminLocalStorage] Failed to load config:", error);
       try {
         localStorage.removeItem(ADMIN_CONFIG_KEY);
       } catch {
@@ -71,18 +68,15 @@ const SecureAdminLocalStorage = {
   setConfig: (config) => {
     try {
       if (!validateAdminConfig(config)) {
-        console.warn("[AdminLocalStorage] Invalid config provided");
         return false;
       }
       const serialized = JSON.stringify(config);
       if (serialized.length > MAX_CONFIG_SIZE) {
-        console.warn("[AdminLocalStorage] Config too large to store");
         return false;
       }
       localStorage.setItem(ADMIN_CONFIG_KEY, serialized);
       return true;
     } catch (error) {
-      console.warn("[AdminLocalStorage] Failed to save config:", error);
       return false;
     }
   },
@@ -154,12 +148,10 @@ const SecureAdminLocalStorage = {
     try {
       const config = SecureAdminLocalStorage.getConfig();
       if (!validateAdminConfig(config)) {
-        console.warn("[AdminLocalStorage] Cannot export invalid config");
         return null;
       }
       return JSON.stringify(config, null, 2);
     } catch (error) {
-      console.warn("[AdminLocalStorage] Failed to export config:", error);
       return null;
     }
   },
@@ -168,12 +160,10 @@ const SecureAdminLocalStorage = {
     try {
       const sanitizedJson = sanitizeString(configJson);
       if (!sanitizedJson || sanitizedJson.length > MAX_CONFIG_SIZE) {
-        console.warn("[AdminLocalStorage] Invalid or oversized config JSON");
         return false;
       }
       const config = JSON.parse(sanitizedJson);
       if (!validateAdminConfig(config)) {
-        console.warn("[AdminLocalStorage] Failed config validation during import");
         return false;
       }
       const serialized = JSON.stringify(config);
@@ -186,13 +176,11 @@ const SecureAdminLocalStorage = {
       ];
       for (const pattern of suspiciousPatterns) {
         if (pattern.test(serialized)) {
-          console.warn("[AdminLocalStorage] Suspicious content detected in config");
           return false;
         }
       }
       return SecureAdminLocalStorage.setConfig(config);
     } catch (error) {
-      console.warn("[AdminLocalStorage] Failed to import config:", error);
       return false;
     }
   },
@@ -202,7 +190,6 @@ const SecureAdminLocalStorage = {
       localStorage.removeItem(ADMIN_CONFIG_KEY);
       return true;
     } catch (error) {
-      console.warn("[AdminLocalStorage] Failed to clear config:", error);
       return false;
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestledjs/data-browser",
-  "version": "0.1.13",
+  "version": "0.1.16",
   "description": "Universal admin data browser for Nestled framework projects with full CRUD operations",
   "main": "./index.js",
   "module": "./index.js",
@@ -38,8 +38,7 @@
     "@apollo/client": "^4.0.0",
     "@heroicons/react": "^2.0.0",
     "@nestledjs/forms": "^0.5.0",
-    "@nestledjs/helpers": "^0.1.0",
-    "@nestledjs/shared-components": "^0.1.12",
+    "@nestledjs/shared-components": "^0.1.16",
     "react": "^19.0.0",
     "react-router": "^7.0.0"
   },