ApiLogicServer 15.0.19__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.19"  # 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/17/2024 - 15.00.19: Tech Preview: als genai-app \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"\
@@ -1174,7 +1174,7 @@ from database import <project.bind_key>_models
     @staticmethod                               
     def set_provider(from_value: str, to_value: str, config_file: str) -> None:
         """ update import statement to set provider type in config.py """
-        if from_value == to_value:
+        if from_value == to_value or to_value == "None":
             pass
             # log.debug(f'.. .. (provider type unchanged)')
         else:
@@ -1243,7 +1243,7 @@ from database import <project.bind_key>_models
         provider_note = f"Setting security provider type = {self.auth_provider_type}, @server = {self.auth_db_url} \n"
         #                    f'(was: {was_provider_type}, {is_enabled_note})\n'
 
-        if self.auth_provider_type == 'none':  # none means disable
+        if self.auth_provider_type in ['none', 'None']:  # none means disable
             if is_enabled:
                 log.info(f'\n\n.. ..Disabling security for current provider type: {was_provider_type}\n')
                 create_utils.assign_value_to_key_in_file(value=False, 

api_logic_server_cli/api_logic_server_info.yaml

@@ -1,3 +1,3 @@
-last_created_date: June 17, 2025 12:36:00
+last_created_date: June 22, 2025 16:02:13
 last_created_project_name: ../../../servers/basic_demo
-last_created_version: 15.00.18
+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)
@@ -77,7 +79,7 @@ class GenAIAdminApp:
 
         log.info(f"✅ Next Steps:\n")
         log.info('Start the API Logic Project: F5')
-        log.info('> cd ui/react-admin')
+        log.info(f'> cd ui/{app_name}')
         log.info('> npm install')
         log.info('> npm start')
 
@@ -85,10 +87,13 @@ class GenAIAdminApp:
     def a_generate_resource_files(self):
 
         def fix_source(raw_source: str) -> str:
-            ''' remove code occasional begin/end code markers '''
+            ''' Remove code occasional begin/end code markers <br>
+            ToDo: lint, and repeat generation if errors detected
+            '''
             source_lines = raw_source.splitlines()
-            result_lines = []
-            found_start_marker = False
+            result_lines = ["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"]
+            found_from_react_admin = False
             for each_line in source_lines:
                 if each_line.startswith("```"):
                     if each_line.startswith("```jsx") or each_line.startswith("```javascript"):
@@ -96,7 +101,11 @@ class GenAIAdminApp:
                         continue
                     else:
                         break
-                result_lines.append(each_line)
+                if "from 'react-admin'" in each_line:  # sigh: missing imports 20% of the time - override
+                    found_from_react_admin = True
+                    continue
+                if found_from_react_admin == True:
+                    result_lines.append(each_line)
                 
             # return source_lines as a string
             return "\n".join(result_lines)
@@ -119,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'}]
@@ -136,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"
@@ -149,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}

@@ -8,6 +8,7 @@ The result must be a runnable React app (`npm start`) that connects to the suppl
 ### 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**
@@ -15,27 +16,33 @@ For each resource:
 ### 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
 
@@ -46,20 +53,18 @@ default the Foreign Key to the Parent (Master) Primary Key.
 
 ## Implementation
 
-
 ### 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
+
+```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
@@ -70,31 +75,35 @@ default the Foreign Key to the Parent (Master) Primary Key.
 ### 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`
+
+* 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>
 
-Be sure to include all required imports.  ALWAYS use the following AS IS, plus whatever else is required:
+  * 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 { 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';
+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 use `<EmailInput>` - use `<TextInput>`.
 
-DO NOT put <ReferenceField> in <Datagrid>.
+DO NOT put `<ReferenceField>` in `<Datagrid>`.
 
 Do **not leave any file empty**.
 
@@ -102,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: {
@@ -125,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>
@@ -136,14 +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": {