@dashadmin/dash-app-common 1.3.25 → 1.3.28

package/src/defaults/pages/Static/DashDefaultStaticPage.tsx

@@ -0,0 +1,75 @@
+/**
+ * Default Static Page
+ * 
+ * Generic static page component that can be used for terms, privacy policy, etc.
+ */
+import React from 'react';
+import { useNavigate } from 'react-router-dom';
+import { 
+    Box, 
+    Typography, 
+    Button, 
+    Container,
+    Paper
+} from '@mui/material';
+import ArrowBackIcon from '@mui/icons-material/ArrowBack';
+
+interface DefaultStaticPageProps {
+    title?: string;
+    content?: string | React.ReactNode;
+    showBackButton?: boolean;
+    maxWidth?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+}
+
+const DefaultStaticPage: React.FC<DefaultStaticPageProps> = ({
+    title = 'Static Page',
+    content,
+    showBackButton = true,
+    maxWidth = 'md',
+}) => {
+    const navigate = useNavigate();
+
+    const handleGoBack = () => {
+        navigate(-1);
+    };
+
+    return (
+        <Container maxWidth={maxWidth}>
+            <Paper 
+                elevation={0} 
+                sx={{ 
+                    p: 4,
+                    my: 4
+                }}
+            >
+                {showBackButton && (
+                    <Box sx={{ mb: 3 }}>
+                        <Button 
+                            variant="text" 
+                            startIcon={<ArrowBackIcon />}
+                            onClick={handleGoBack}
+                        >
+                            Back
+                        </Button>
+                    </Box>
+                )}
+                
+                <Typography variant="h4" component="h1" gutterBottom>
+                    {title}
+                </Typography>
+                
+                {typeof content === 'string' ? (
+                    <Typography 
+                        variant="body1" 
+                        component="div"
+                        dangerouslySetInnerHTML={{ __html: content }}
+                    />
+                ) : (
+                    content
+                )}
+            </Paper>
+        </Container>
+    );
+};
+
+export default DefaultStaticPage;

package/src/defaults/pages/Static/DashDefaultTermsPage.tsx

@@ -0,0 +1,69 @@
+/**
+ * Default Terms Page
+ * 
+ * Terms of service page template.
+ */
+import React from 'react';
+import DashDefaultStaticPage from './DashDefaultStaticPage';
+
+
+interface DefaultTermsPageProps {
+    companyName?: string;
+    effectiveDate?: string;
+    content?: string | React.ReactNode;
+}
+
+const DefaultTermsPage: React.FC<DefaultTermsPageProps> = ({
+    companyName = 'Our Company',
+    effectiveDate = new Date().toLocaleDateString(),
+    content,
+}) => {
+    const defaultContent = (
+        <div>
+            <p><strong>Effective Date:</strong> {effectiveDate}</p>
+            
+            <h2>1. Acceptance of Terms</h2>
+            <p>
+                By accessing and using this service, you accept and agree to be bound by the terms 
+                and provision of this agreement.
+            </p>
+            
+            <h2>2. Use License</h2>
+            <p>
+                Permission is granted to temporarily access the materials (information or software) 
+                on {companyName}'s website for personal, non-commercial transitory viewing only.
+            </p>
+            
+            <h2>3. Disclaimer</h2>
+            <p>
+                The materials on {companyName}'s website are provided on an 'as is' basis. 
+                {companyName} makes no warranties, expressed or implied, and hereby disclaims and 
+                negates all other warranties including, without limitation, implied warranties or 
+                conditions of merchantability, fitness for a particular purpose, or non-infringement 
+                of intellectual property or other violation of rights.
+            </p>
+            
+            <h2>4. Limitations</h2>
+            <p>
+                In no event shall {companyName} or its suppliers be liable for any damages 
+                (including, without limitation, damages for loss of data or profit, or due to 
+                business interruption) arising out of the use or inability to use the materials 
+                on {companyName}'s website.
+            </p>
+            
+            <h2>5. Contact Information</h2>
+            <p>
+                If you have any questions about these Terms, please contact us.
+            </p>
+        </div>
+    );
+
+    return (
+        <DashDefaultStaticPage 
+            title="Terms of Service"
+            content={content || defaultContent}
+        />
+    );
+};
+
+export default DefaultTermsPage;

package/src/defaults/pages/Static/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Static Pages Module
+ * 
+ * Exports all default static pages.
+ */
+export { default as DashDefaultStaticPage } from './DashDefaultStaticPage';
+export { default as DashDefaultTermsPage } from './DashDefaultTermsPage';
+export { default as DashDefaultPrivacyPage } from './DashDefaultPrivacyPage';

package/src/defaults/pages/index.ts

@@ -0,0 +1,28 @@
+/**
+ * Default Pages Index
+ * 
+ * Default page components for common application pages.
+ */
+
+// Auth pages (standalone - no react-admin dependency)
+export { default as DashDefaultLogin } from './DashDefaultLogin';
+
+// Account pages
+export { default as DashDefaultRegisterPage } from './Account/DashDefaultRegister';
+export { default as DashDefaultSignUpPage } from './Account/DashDefaultSignUp';
+export { default as DashDefaultSignUpSuccessPage } from './Account/DashDefaultSignUpSuccess';
+
+// Misc pages (Error pages)
+export { default as DashDefaultNotFoundPage } from './Misc/DashDefaultNotFound';
+export { default as DashDefaultUnauthorizedPage } from './Misc/DashDefaultUnauthorized';
+export { default as DashDefaultServerErrorPage } from './Misc/DashDefaultServerError';
+
+// Static pages
+export { default as DashDefaultStaticPage } from './Static/DashDefaultStaticPage';
+export { default as DashDefaultTermsPage } from './Static/DashDefaultTermsPage';
+export { default as DashDefaultPrivacyPage } from './Static/DashDefaultPrivacyPage';
+
+// Re-export modules
+export * from './Account';
+export * from './Misc';
+export * from './Static';

package/src/defaults/schemas/dashDefaultSchema.tsx

@@ -0,0 +1,25 @@
+/**
+ * Dash Default Base Schema
+ * 
+ * Base schema configuration with common attributes.
+ * This schema can be extended or merged with resource-specific schemas.
+ */
+import { IDashAutoAdminAttribute } from 'dash-auto-admin';
+
+/**
+ * Dash default schema with basic ID field
+ * Most resources will need an ID field, so this provides
+ * a sensible default configuration.
+ */
+const dashDefaultSchema: IDashAutoAdminAttribute[] = [
+    {
+        attribute: 'id',
+        label: 'ID',
+        type: String,
+        sortable: true,
+        inEdit: false,
+        inCreate: false,
+    },
+];
+
+export default dashDefaultSchema;

package/src/defaults/schemas/demo/dashDefaultTodoSchema.tsx

@@ -0,0 +1,39 @@
+/**
+ * Dash Default Demo Schema (Todo)
+ * 
+ * Example schema configuration for a Todo resource.
+ * Demonstrates common field types and configurations.
+ */
+import { IDashAutoAdminAttribute } from "dash-auto-admin";
+
+/**
+ * Dash default demo Todo schema
+ * 
+ * Demonstrates:
+ * - String fields (name)
+ * - Textarea fields (description)
+ * - Boolean fields (completed)
+ * - Tab grouping
+ */
+const dashDefaultTodoSchema: IDashAutoAdminAttribute[] = [
+    {
+        tab: 'Details',
+        attribute: 'name',
+        label: 'Name',
+        type: String,
+    },
+    {
+        tab: 'Details',
+        attribute: 'description',
+        label: 'Description',
+        type: 'textarea',
+    },
+    {
+        tab: 'Status',
+        attribute: 'completed',
+        label: 'Completed',
+        type: Boolean,
+    }
+];
+
+export default dashDefaultTodoSchema;

package/src/defaults/schemas/demo/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Demo Schemas Module
+ * 
+ * Exports demo schema configurations.
+ */
+export { default as dashDefaultTodoSchema } from './dashDefaultTodoSchema';

package/src/defaults/schemas/index.ts

@@ -0,0 +1,14 @@
+/**
+ * Default Schemas Index
+ * 
+ * Default schema configurations for resources.
+ * These schemas provide common field configurations that can be
+ * customized or extended for specific resources.
+ */
+
+// Base schema
+export { default as dashDefaultSchema } from './dashDefaultSchema';
+
+// Demo schemas
+export * from './demo';
+export { default as dashDefaultTodoSchema } from './demo/dashDefaultTodoSchema';

package/src/filters/demo/todoFilters.tsx

@@ -0,0 +1,39 @@
+import Dot from "@mui/icons-material/FiberManualRecord";
+import React from "react";
+import IReferenceFilter from "dash-auto-admin/src/interfaces/IReferenceFilter";
+import { SelectInput } from "react-admin";
+
+const demoFilters:  IReferenceFilter[] = [
+    {
+        id: 'name',
+        label: 'Nombre',
+        source: 'name',
+        alwaysOn: true,
+        reference: null,
+        optionText: null,
+    },
+
+    {
+        id: 'description',
+        label: 'Descripción',
+        source: 'description',
+        alwaysOn: true,
+        reference: null,
+        optionText: null,
+    },
+
+    {
+		id: 'completed',
+		label: 'Status',
+		source: 'completed',
+		reference: [
+			{ id: '1', name: 'Completado' },
+			{ id: '0', name: 'Incompleto' },
+		],
+		optionText: 'completed', // field from the model
+		alwaysOn: true,
+		referenceComponent: SelectInput,
+	}
+];
+
+export default demoFilters;

package/src/index.ts

@@ -0,0 +1,131 @@
+/**
+ * dash-app-common
+ * 
+ * This package provides a simplified application shell for Dash applications.
+ * 
+ * Main Components:
+ * - DashApp: Simple app shell that handles Router + Auth + Public/Private rendering
+ * - DashAppLoader: Legacy/advanced loader (wraps DashBootstrap for complex scenarios)
+ * 
+ * Recommended Usage (Simple):
+ * ```tsx
+ * import { DashApp } from 'dash-app-common';
+ * 
+ * // Zero-config (uses default routes)
+ * <DashApp />
+ * 
+ * // With custom private app
+ * <DashApp PrivateApp={MyAdminApp} />
+ * 
+ * // With custom routes
+ * <DashApp
+ *     publicRoutes={myPublicRoutes}
+ *     privateRoutes={myPrivateRoutes}
+ * />
+ * ```
+ * 
+ * Legacy Usage (DashAppLoader):
+ * ```tsx
+ * import DashAppLoader from 'dash-app-common';
+ * 
+ * <DashAppLoader
+ *     publicAppImport={() => import('./PublicApp')}
+ *     privateAppImport={() => import('./PrivateApp')}
+ * />
+ * ```
+ * 
+ * @packageDocumentation
+ */
+
+// ============================================================================
+// NEW SIMPLIFIED API
+// ============================================================================
+
+// Main simplified component
+export { DashApp, default as DashAppSimple } from './DashApp';
+
+// ============================================================================
+// LEGACY/ADVANCED API (DashAppLoader)
+// ============================================================================
+
+// Re-export base DashAppLoader for backward compatibility
+export {
+    DashAppLoader,
+    createDashAppLoader,
+    type DashAppLoaderProps,
+    type DashAppLoaderConfig,
+    type IDashAuthState,
+    type IDashAppState,
+    type IDashAuthService,
+    type IDashReduxActions,
+    // Default fallback components
+    DefaultLoadingFallback,
+    DefaultErrorFallback,
+} from './DashAppLoader';
+
+// Re-export framework services for advanced customization
+export {
+    DASHAuthenticationService,
+    DASH_REDUX_ACTIONS,
+    ACTION_UPDATE_AUTH,
+    AppLoadingFallback,
+} from './DashAppLoader';
+
+// Re-export default apps and routes for customization
+export {
+    DashDefaultPublicApp,
+    DashDefaultPrivateApp,
+} from './DashAppLoader';
+
+// ============================================================================
+// RESOURCE MANIFEST LOADING
+// ============================================================================
+
+// Resource loader for manifest-based dynamic resource loading
+export {
+    DashPrivateAppWithManifest,
+    DashPrivateApp,
+    useDashResourceManifest,
+    loadResourcesFromManifest,
+    clearResourceCache,
+    isResourceManifest,
+    isResourceArray,
+    type ResourceImportFn,
+    type ResourceManifest,
+    type UseDashResourceManifestResult,
+    type DashPrivateAppWithManifestProps,
+    type DashPrivateAppProps,
+} from './components/DashResourceLoader';
+
+// ============================================================================
+// DEFAULT ROUTES
+// ============================================================================
+
+export { dashDefaultPublicRoutes } from './defaults/extensions/router/dashDefaultPublicRoutes';
+export { dashDefaultPrivateRoutes } from './defaults/extensions/router/dashDefaultPrivateRoutes';
+
+// ============================================================================
+// DEFAULTS (extensions, pages, filters, schemas)
+// ============================================================================
+
+// Re-export all defaults
+export * from './defaults';
+
+// Re-export default extensions by category
+export * from './defaults/extensions';
+
+// Re-export default pages
+export * from './defaults/pages';
+
+// Re-export default filters
+export * from './defaults/filters';
+
+// Re-export default schemas
+export * from './defaults/schemas';
+
+// ============================================================================
+// DEFAULT EXPORT
+// ============================================================================
+
+// Default export is the legacy DashAppLoader for backward compatibility
+export { default } from './DashAppLoader';

package/src/resources/demo/todoResource.tsx

@@ -0,0 +1,68 @@
+import ResourceTemplate from 'dash-admin/src/templates/ResourceTemplate';
+import { IDashAutoAdminResourceConfig } from 'dash-auto-admin';
+import Dot from "@mui/icons-material/FiberManualRecord";
+import React from "react";
+import {DASHAppConstants} from "dash-constants";
+import todoSchema from '../../schemas/demo/todoSchema';
+import todoFilters from '../../filters/demo/todoFilters';
+
+const Icon = Dot as unknown as React.FC;
+
+const enableTrash = true;
+const TodoResource: IDashAutoAdminResourceConfig =
+{
+    roles:[DASHAppConstants.system.SYSTEM_ROLE],
+    component: ResourceTemplate,
+    //trash: true,
+    model: "example/todo",
+    label: "Todo",
+    schema: todoSchema,
+    icon: <Icon />,
+    group: "Example",
+    trash: enableTrash,
+    menu: [
+        {
+            title: "List",
+            redirect: "/example/todo",
+        },
+        ...(enableTrash ? [{
+            title: "Trash",
+            redirect: "/example/todo/trash",
+        }] : []),
+    ],
+
+    referenceFilters: todoFilters,
+
+    mainAction: {
+        title: "Crear Todo",
+        mode: "create",
+        fn:"virtualhash",
+        redirect: "inline/create",
+    },
+
+    view: true,
+    create: true,
+    edit: true,
+    
+    drawer: true,
+    drawerOptions: {
+        create: true,
+        edit: true,
+        view: true
+    },
+
+    isFormData: true,
+    formGroupMode: "tabs",
+
+    postFormatter: (params) => {
+        return params;
+    },
+
+    mutationMode: "pessimistic",
+    saveButtonAlwaysEnabled: true,
+    listProps: {storeKey: false},
+    resetSelectedIdsOnLoad: true,
+
+};
+
+export default TodoResource;

package/src/schemas/defaultSchema.tsx

@@ -0,0 +1,14 @@
+import { IDashAutoAdminAttribute } from 'dash-auto-admin';
+
+const defaultSchema: IDashAutoAdminAttribute[] = [
+	{
+		attribute: 'id',
+		label: 'Id',
+		type: String,
+		sortable: true,
+		inEdit: false,
+		inCreate: false,
+	},
+];
+
+export default defaultSchema;

package/src/schemas/demo/todoSchema.tsx

@@ -0,0 +1,27 @@
+
+import { IDashAutoAdminAttribute } from "dash-auto-admin";
+
+const todoSchema: IDashAutoAdminAttribute[] = [
+    {
+            tab: 'Todo',
+            attribute: 'name',
+            label: 'Nombre',
+            type: String,
+    },
+{
+            tab: 'Todo',
+            attribute: 'description',
+            label: 'Description',
+            type: 'textarea',
+    },
+{
+            tab: 'Todo',
+            attribute: 'completed',
+            label: 'Completed',
+            type: Boolean,
+    }
+
+];
+
+
+export default todoSchema;