ApiLogicServer 15.0.20__py3-none-any.whl → 15.0.22__py3-none-any.whl

api_logic_server_cli/api_logic_server.py

@@ -12,10 +12,10 @@ ApiLogicServer CLI: given a database url, create [and run] customizable ApiLogic
 Called from api_logic_server_cli.py, by instantiating the ProjectRun object.
 '''
 
-__version__ = "15.00.20"  # last public release: 15.00.19 (15.00.12)
+__version__ = "15.00.22"  # last public release: 15.00.19 (15.00.12)
 recent_changes = \
     f'\n\nRecent Changes:\n' +\
-    "\t06/19/2024 - 15.00.20: Tech Preview: als genai-app, import fix, bug [96] \n"\
+    "\t06/22/2024 - 15.00.21: Tech Preview: als genai-app w/ sra provider, import fix, bug [96] \n"\
     "\t06/10/2024 - 15.00.12: MCP Security, win fixes for readme, graphics quotes \n"\
     "\t06/08/2024 - 15.00.10: MCP, optional shortening of stacktrace lines, bugfix[92] \n"\
     "\t05/16/2024 - 14.05.00: safrs 3.1.7, running mcp preview \n"\

api_logic_server_cli/api_logic_server_info.yaml

@@ -1,3 +1,3 @@
-last_created_date: June 19, 2025 16:11:17
+last_created_date: June 22, 2025 16:02:13
 last_created_project_name: ../../../servers/basic_demo
-last_created_version: 15.00.19
+last_created_version: 15.00.20

api_logic_server_cli/genai/genai_admin_app.py

@@ -53,7 +53,9 @@ class GenAIAdminApp:
         self.app_templates_path = genai_svcs.get_manager_path(use_env=True).joinpath('system/genai/app_templates')
         self.react_admin_template_path = self.app_templates_path / 'react-admin-template'
         self.prompts_path = self.app_templates_path / "app_learning"
-        self.admin_app_learning = utils.read_file(self.prompts_path / "Admin-App-Learning-Prompt.md")
+        # self.admin_app_learning = utils.read_file(self.prompts_path / "Admin-App-Learning-Prompt.md")
+        self.admin_app_resource_learning = utils.read_file(self.prompts_path / "Admin-App-Resource-Learning-Prompt.md")
+        self.admin_app_js_learning = utils.read_file(self.prompts_path / "Admin-App-js-Learning-Prompt.md")
         self.image_url = self.prompts_path / 'Order-Page.png'  # did not seem to help, made it 2x slower
 
         # self.schema = utils.read_file(self.dbml_path)
@@ -126,7 +128,7 @@ class GenAIAdminApp:
             ]
             messages = [
                 {"role": "user", "content": "You are a helpful expert in react and JavaScript"},
-                {"role": "user", "content": self.admin_app_learning},
+                {"role": "user", "content": self.admin_app_resource_learning},
                 # {"role": "user", "content": example_image_content},
                 {"role": "user", "content": f'Schema:\n{self.schema_yaml}'},
                 {"role": "user", "content": f'Generate the full javascript source code for the `{each_resource_name}.js` React Admin file, formatted as a JSResponseFormat'}]
@@ -143,10 +145,23 @@ class GenAIAdminApp:
 
 
     def b_generate_app_js(self):
+
+        def fix_app(raw_source: str) -> str:
+            ''' Remove code occasional begin/end code markers <br>
+            '''
+            source_lines = raw_source.splitlines()
+            result_lines = []
+            data_provider_import = False
+            do_fixup = False
+            for each_line in source_lines:
+                # fixes here
+                result_lines.append(each_line)                
+            return "\n".join(result_lines)  # return source_lines as a string
+
         messages = []
         messages = [
             {"role": "user", "content": "You are a helpful expert in react and JavaScript"},
-            {"role": "user", "content": self.admin_app_learning},
+            {"role": "user", "content": self.admin_app_js_learning},
             {"role": "user", "content": f'Schema:\n{self.schema_yaml}'},
             {"role": "user", "content": f'Generate the complete App.js that wires together the above resources. for the `app.js` React Admin file, formatted as a JSResponseFormat.'}]
         save_response = self.project_root / f"docs/admin_app/app.js"
@@ -156,7 +171,9 @@ class GenAIAdminApp:
                                             response_as=JSResponseFormat)
         response_dict = json.loads(output)
         target_file = self.ui_src_path / "App.js"
-        utils.write_file(target_file, response_dict['code'])
+        source_code = response_dict['code']
+        source_code = fix_app(source_code)
+        utils.write_file(target_file, source_code)
 
         log.info(f"✅ Wrote: {target_file}\n")
 

api_logic_server_cli/prototypes/manager/system/genai/app_templates/app_learning/Admin-App-Resource-Learning-Prompt.md

@@ -0,0 +1,119 @@
+## Context
+
+Generate a per-resource file for a React Admin application using the following instructions.  
+The result must be a runnable React app (`npm start`) that connects to the supplied JSON:API, with fully implemented components (no placeholders or empty files).
+
+
+---
+
+### Per-Resource Files (Required)
+
+For each resource (`Customer`, `Order` etc):
+
+* Create a source file under `src/`, e.g., `Customer.js`
+* Each file must **fully** implement:
+    * `CustomerList`
+    * `CustomerShow`
+    * `CustomerCreate`
+    * `CustomerEdit`
+
+Use:
+
+- `<ReferenceField>` for foreign key displays
+- `<ReferenceInput>` for foreign key input
+- `<ReferenceManyField>` for tabbed child lists
+- For show pages
+
+  * Always start with `<SimpleShowLayout>`, followed by a `<TabbedShowLayout>` for related data
+    * DO NOT start with `<TabbedShowLayout>`
+
+ALWAYS include these 2 imports at the top of the file, with this EXACT formatting, whether or not they are used:
+
+```jsx
+import React from 'react';
+import { List, FunctionField, Datagrid, TextField, DateField, NumberField, ReferenceField, ReferenceManyField, Show, TabbedShowLayout, Tab, SimpleShowLayout, TextInput, NumberInput, DateTimeInput, ReferenceInput, SelectInput, Create, SimpleForm, Edit, Filter, Pagination, BooleanField, BooleanInput } from 'react-admin';  // mandatory import
+```
+You may add other imports, but be sure all those are included.
+
+DO NOT use `<EmailInput>` - use `<TextInput>`.
+
+DO NOT put `<ReferenceField>` in `<Datagrid>`.
+
+Do **not leave any file empty**.
+
+---
+
+## App Features
+
+### Multi-Page
+
+For each resource:
+
+- Create a **List page** showing 7 user-friendly columns
+- Add **pagination**, **sorting**, and **filtering**
+- Link each row to a **Display (Show) page**
+
+### Multi-Resource
+
+Each **Display Page** should:
+
+- Show all fields in a **multi-column layout**
+- Include a **tab sheet** (`<TabbedShowLayout>`) for each related resource using `<ReferenceManyField>`
+- Link child rows to their own display page
+
+Example:  
+
+- Customer Display has tab for OrderList 
+
+  - The tab (with OrderList) is shown *below* all the Customer fields.
+- Each Order in the tab links to Order Display
+
+### Automatic Joins
+
+For foreign keys:
+
+- Display joined value (e.g., `product.name` instead of `product_id`)
+- Use first string field from parent table containing `name`, `title`, or `description`
+
+Numeric Primary key fields:
+
+- Display at the end of forms/lists
+
+### Lookups (Foreign Keys)
+
+For foreign key fields:
+
+- Provide auto-complete dropdown (`<ReferenceInput>`)
+- For numeric foreign keys, use the joined string field as lookup text
+
+### Cascade Add
+
+When adding a child row as a detail in a Master / Detail,
+default the Foreign Key to the Parent (Master) Primary Key.
+
+## Implementation
+
+### Architecture
+
+- **Framework**: React 18 + react-admin 4.x
+- **Data Provider**: Custom pre-built in src/rav4-jsonapi-client
+- **CORS**: Ensure API allows `http://localhost:3000`
+
+```py
+  from flask_cors import CORS  
+  CORS(app, origins='*')  # or restrict to localhost:3000
+```
+- **Project Setup**:
+
+  - Use `create-react-app`
+  - Include: `react-admin`, `@mui/material`, `@emotion/react`, `@emotion/styled`, `react-router-dom`
+  - Do not use any deprecated or unmaintained libraries
+  - Include complete and correct `App.js`, `index.js`, `dataProvider.js`, and `index.html`
+---
+
+## Response Format
+
+Format the response as a JSResponseFormat:
+
+class JSResponseFormat(BaseModel):  # must match system/genai/prompt_inserts/response_format.prompt
+    code : str # generated javascript code (only)

api_logic_server_cli/prototypes/manager/system/genai/app_templates/app_learning/Admin-App-js-Learning-Prompt.md

@@ -0,0 +1,71 @@
+
+
+### App Wiring
+
+Sample code for react `App.js` (follow these guidelines EXACTLY):
+
+```jsx
+// begin constant imports (always included) -- generate this code EXACTLY
+import React from 'react';
+import { Admin, Resource, Loading } from 'react-admin';  // val? loading
+import { jsonapiClient } from "./rav4-jsonapi-client/ra-jsonapi-client";
+import { createTheme } from '@mui/material/styles';
+import { useConf, loadHomeConf } from "./Config";  // val ??
+// end constant imports
+
+// import each resource, e.g.
+import { CustomerList, CustomerShow, CustomerCreate, CustomerEdit } from './Customer';
+...
+
+const theme = createTheme({
+    palette: {
+        primary: { main: '#1976d2' },    // Material-UI default blue
+        secondary: { main: '#1565c0' },  // A darker blue, or choose another color
+    },
+    typography: { fontSize: 14 },
+});
+
+const App = () => {
+  const [conf, setConf] = React.useState({});
+  
+  React.useEffect(() => {
+    const fetchData = async () => {
+      try {
+        console.log('loading HomeConf-1')
+        const conf = await loadHomeConf()
+        setConf(conf)
+        setLoading(false);
+        console.log('AppConf0: ', conf);
+      } catch (error) {
+        console.error('Error fetching data:', error);
+        sessionStorage.removeItem("raSpa");
+      }
+    };
+    fetchData();
+  }, []);
+
+  if (loading) {
+    return <Loading loadingPrimary="Loading..." loadingSecondary="Please wait" />;
+  }
+  const dataProvider = jsonapiClient(conf.api_root, { conf: {} }, null);
+
+  return (
+        // register each resource (do NOT generate {dataProvider(conf.api_root)}...
+        <Admin dataProvider={dataProvider} theme={theme}>
+            <Resource name="Customer" list={CustomerList} show={CustomerShow} edit={CustomerEdit} create={CustomerCreate} />
+...
+        </Admin>
+    );
+};
+
+export default App;
+```
+
+---
+
+## Response Format
+
+Format the response as a JSResponseFormat:
+
+class JSResponseFormat(BaseModel):  # must match system/genai/prompt_inserts/response_format.prompt
+    code : str # generated javascript code (only)

api_logic_server_cli/prototypes/manager/system/genai/app_templates/app_learning/{Admin-App-Learning-Prompt.md → z-unused-Admin-App-Learning-Prompt.md}

@@ -56,12 +56,7 @@ default the Foreign Key to the Parent (Master) Primary Key.
 ### Architecture
 
 - **Framework**: React 18 + react-admin 4.x
-- **Data Provider**: Custom `dataProvider.js` using `fetchUtils` (no external `ra-jsonapi-client`)
-
-  - Must support: `getList`, `getOne`, `getMany`, `getManyReference`, `create`, `update`, `delete`
-  - Must support: filters, joins, sorting, pagination
-
-- **Backend**: JSON:API per `mcp_discovery.json`
+- **Data Provider**: Custom pre-built in src/rav4-jsonapi-client
 - **CORS**: Ensure API allows `http://localhost:3000`
 
 ```py
@@ -116,19 +111,19 @@ Do **not leave any file empty**.
 
 ### App Wiring
 
-Sample code for `App.js`:
-
+Sample code for `App.js` (follow these guidelines EXACTLY):
 
 ```jsx
+// begin constant imports (always included) -- generate this code EXACTLY
 import React from 'react';
-import { Admin, Resource } from 'react-admin';
+import { Admin, Resource, Loading } from 'react-admin';  // val? loading
 import { createTheme } from '@mui/material/styles';
+import { useConf, loadHomeConf } from "./Config";  // val ??
+// end constant imports
 
-// import each resource
+// import each resource, e.g.
 import { CustomerList, CustomerShow, CustomerCreate, CustomerEdit } from './Customer';
 ...
-// import the data provider
-import { dataProvider } from './dataProvider';
 
 const theme = createTheme({
     palette: {
@@ -139,8 +134,32 @@ const theme = createTheme({
 });
 
 const App = () => {
-    return (
-        <Admin dataProvider={dataProvider}>  // register each resource...
+  const [conf, setConf] = React.useState({});
+  
+  React.useEffect(() => {
+    const fetchData = async () => {
+      try {
+        console.log('loading HomeConf-1')
+        const conf = await loadHomeConf()
+        setConf(conf)
+        setLoading(false);
+        console.log('AppConf0: ', conf);
+      } catch (error) {
+        console.error('Error fetching data:', error);
+        sessionStorage.removeItem("raSpa");
+      }
+    };
+    fetchData();
+  }, []);
+
+  if (loading) {
+    return <Loading loadingPrimary="Loading..." loadingSecondary="Please wait" />;
+  }
+  const dataProvider = jsonapiClient(conf.api_root, { conf: {} }, null);
+
+  return (
+        // register each resource (do NOT generate {dataProvider(conf.api_root)}...
+        <Admin dataProvider={dataProvider} theme={theme}>
             <Resource name="Customer" list={CustomerList} show={CustomerShow} edit={CustomerEdit} create={CustomerCreate} />
 ...
         </Admin>
@@ -150,16 +169,6 @@ const App = () => {
 export default App;
 ```
 
-For dataProvider:
-
-1. be sure it includes the braces: `import { dataProvider }`
-2. Do Not generate either:
-
-```jsx
-import jsonServerProvider from 'ra-data-json-server'
-const dataProvider = jsonServerProvider('http://api.example.com');
-```
-
 ---
 
 ## Response Format

api_logic_server_cli/prototypes/manager/system/genai/app_templates/react-admin-template/package.json

@@ -10,11 +10,14 @@
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^13.5.0",
+    "compare-versions": "^6.1.1",
+    "keycloak-js": "^26.2.0",
     "react": "^19.1.0",
     "react-admin": "^5.8.3",
     "react-dom": "^19.1.0",
     "react-router-dom": "^7.6.2",
     "react-scripts": "5.0.1",
+    "url-join": "^5.0.0",
     "web-vitals": "^2.1.4"
   },
   "scripts": {