@lowdefy/docs 3.23.2 → 4.0.0-alpha.6

package/CHANGELOG.md

@@ -3,7 +3,39 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [3.23.2](https://github.com/lowdefy/lowdefy/compare/v3.23.1...v3.23.2) (2021-11-29)
+# [4.0.0-alpha.6](https://github.com/lowdefy/lowdefy/compare/v4.0.0-alpha.5...v4.0.0-alpha.6) (2022-01-20)
+
+
+### Bug Fixes
+
+* **docs:** Added redis connection documentation. ([ee1620b](https://github.com/lowdefy/lowdefy/commit/ee1620bb41d8aa3f32e05e9b7e03c7986365c59f))
+
+
+### Features
+
+* Add _diff to client operators as well as server. ([4e23fec](https://github.com/lowdefy/lowdefy/commit/4e23fec8a4985d7453dfcf750298bc0bedeb34a2))
+
+
+
+
+
+# [4.0.0-alpha.5](https://github.com/lowdefy/lowdefy/compare/v4.0.0-alpha.4...v4.0.0-alpha.5) (2021-11-27)
+
+**Note:** Version bump only for package @lowdefy/docs
+
+
+
+
+
+# [4.0.0-alpha.4](https://github.com/lowdefy/lowdefy/compare/v4.0.0-alpha.3...v4.0.0-alpha.4) (2021-11-25)
+
+**Note:** Version bump only for package @lowdefy/docs
+
+
+
+
+
+# [4.0.0-alpha.3](https://github.com/lowdefy/lowdefy/compare/v4.0.0-alpha.2...v4.0.0-alpha.3) (2021-11-25)
 
 **Note:** Version bump only for package @lowdefy/docs
 
@@ -11,6 +43,41 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 
 
+# [4.0.0-alpha.2](https://github.com/lowdefy/lowdefy/compare/v4.0.0-alpha.1...v4.0.0-alpha.2) (2021-11-25)
+
+**Note:** Version bump only for package @lowdefy/docs
+
+
+
+
+
+# [4.0.0-alpha.1](https://github.com/lowdefy/lowdefy/compare/v3.23.1...v4.0.0-alpha.1) (2021-11-25)
+
+
+### Bug Fixes
+
+* **docs:** Document that _index operator is client side only. ([72c8228](https://github.com/lowdefy/lowdefy/commit/72c82282a3e6bcd3eb2eeaf3c09b395a0f152405))
+* Replace all front end testing with @testing-library/react, jest and other updates. ([22ec295](https://github.com/lowdefy/lowdefy/commit/22ec2954047853096aabcddba7a2c509342f95f2))
+
+
+### Features
+
+* **blocksAntd:** Add HolderOutlined icon. ([c39c387](https://github.com/lowdefy/lowdefy/commit/c39c38752e4a681a1146e44b6638ff8486ff9da9))
+* **blocksAntd:** Convert Alert to container and add action content area. ([49c6baa](https://github.com/lowdefy/lowdefy/commit/49c6baabeedd4ed5aaaf14f1d7b4ae5d2545d6cf))
+* **blocksAntd:** Drawer: Add extra content area and contentWrapperStyle property. ([9273fac](https://github.com/lowdefy/lowdefy/commit/9273facac41e5ee6341c80e698f4367b7d8686f3))
+* **blocks:** Convert all context category blocks to container. ([6bc03c8](https://github.com/lowdefy/lowdefy/commit/6bc03c86b80a3506c2b85076626ae15a401bcdfc))
+* **blockTools:** Update to @emotion/css, optimize makeCssClass standarise jest settings. ([947defa](https://github.com/lowdefy/lowdefy/commit/947defa3d8934e061933b1e218b79f2f97456054))
+* Replace server side state with payload and _payload operator. ([1f928d9](https://github.com/lowdefy/lowdefy/commit/1f928d93db4cbe886d322a1a3998a817d769485f))
+
+
+### BREAKING CHANGES
+
+* The _event, _global, _input, _state, and _url_query operators are no longer evaluated in connections or requests.
+
+
+
+
+
 ## [3.23.1](https://github.com/lowdefy/lowdefy/compare/v3.23.0...v3.23.1) (2021-11-20)
 
 **Note:** Version bump only for package @lowdefy/docs

package/actions/JsAction.yaml

@@ -66,7 +66,7 @@ _ref:
       ```yaml
       # lowdefy.yaml
       name: intercom-example
-      lowdefy: '3.23.2'
+      lowdefy: '3.23.1'
       app:
         html:
           appendBody: |
@@ -137,7 +137,7 @@ _ref:
       ```yaml
       # file: lowdefy.yaml
       name: text-highlight-example
-      lowdefy: '3.23.2'
+      lowdefy: '3.23.1'
       app:
         html:
           # Load the custom modules into the index.html head tag.

package/blocks/all_icons.yaml

@@ -409,6 +409,7 @@
 - { label: 'HighlightOutlined', value: 'HighlightOutlined' }
 - { label: 'HighlightTwoTone', value: 'HighlightTwoTone' }
 - { label: 'HistoryOutlined', value: 'HistoryOutlined' }
+- { label: 'HolderOutlined', value: 'HolderOutlined' }
 - { label: 'HomeFilled', value: 'HomeFilled' }
 - { label: 'HomeOutlined', value: 'HomeOutlined' }
 - { label: 'HomeTwoTone', value: 'HomeTwoTone' }

package/blocks/{display → container}/Alert.yaml

@@ -16,11 +16,12 @@ _ref:
   path: templates/blocks/template.yaml.njk
   vars:
     block_type: Alert
-    category: display
+    category: container
     schema: ../blocks/blocksAntd/src/blocks/Alert/Alert.json
     filePath: blocks/display/Alert.yaml
     init_property_values:
       message: Alerts help to highlight important information.
     description_content: |
       Alert is used to render user feedback messages in a Alert styled frame.
-
+    areas:
+      - action

package/blocks/{display → container}/Descriptions.yaml

@@ -16,7 +16,7 @@ _ref:
   path: templates/blocks/template.yaml.njk
   vars:
     block_type: Descriptions
-    category: display
+    category: container
     schema: ../blocks/blocksAntd/src/blocks/Descriptions/Descriptions.json
     filePath: blocks/display/Descriptions.yaml
     init_state_values:
@@ -47,3 +47,5 @@ _ref:
               Location: South Africa
               Temperature: 22
               Date: 2021-02-02
+    areas:
+      - extra

package/blocks/container/Drawer.yaml

@@ -26,6 +26,7 @@ _ref:
       > To open the drawer, invoke a drawer method.
     areas:
       - content
+      - extra
     methods:
       - name: toggleOpen
         onClick:

package/blocks/{context → container}/PageHCF.yaml

@@ -16,9 +16,9 @@ _ref:
   path: templates/blocks/template.yaml.njk
   vars:
     block_type: PageHCF
-    category: context
+    category: container
     schema: ../blocks/blocksAntd/src/blocks/PageHCF/PageHCF.json
-    filePath: blocks/context/PageHCF.yaml
+    filePath: blocks/container/PageHCF.yaml
     description_content: |
       Page HCF provides a minimal layout structure for a page container with a header, content and footer area.
 

package/blocks/{context → container}/PageHCSF.yaml

@@ -16,9 +16,9 @@ _ref:
   path: templates/blocks/template.yaml.njk
   vars:
     block_type: PageHCSF
-    category: context
+    category: container
     schema: ../blocks/blocksAntd/src/blocks/PageHCSF/PageHCSF.json
-    filePath: blocks/context/PageHCSF.yaml
+    filePath: blocks/container/PageHCSF.yaml
     description_content: |
       Page HCSF provides a minimal layout structure for a page container with a header, content, sider and footer arrangement.
 

package/blocks/{context → container}/PageHSCF.yaml

@@ -16,9 +16,9 @@ _ref:
   path: templates/blocks/template.yaml.njk
   vars:
     block_type: PageHSCF
-    category: context
+    category: container
     schema: ../blocks/blocksAntd/src/blocks/PageHSCF/PageHSCF.json
-    filePath: blocks/context/PageHSCF.yaml
+    filePath: blocks/container/PageHSCF.yaml
     description_content: |
       Page HSCF provides a minimal layout structure for a page container with a header, sider, content, and footer arrangement.
 

package/blocks/{context → container}/PageHeaderMenu.yaml

@@ -16,9 +16,9 @@ _ref:
   path: templates/blocks/template.yaml.njk
   vars:
     block_type: PageHeaderMenu
-    category: context
+    category: container
     schema: ../blocks/blocksAntd/src/blocks/PageHeaderMenu/PageHeaderMenu.json
-    filePath: blocks/context/PageHeaderMenu.yaml
+    filePath: blocks/container/PageHeaderMenu.yaml
     description_content: |
       The Page Header Menu block provides a structured layout for a page with a header containing a menu, content and footer area.
     init_state_values:

package/blocks/{context → container}/PageSHCF.yaml

@@ -16,9 +16,9 @@ _ref:
   path: templates/blocks/template.yaml.njk
   vars:
     block_type: PageSHCF
-    category: context
+    category: container
     schema: ../blocks/blocksAntd/src/blocks/PageSHCF/PageSHCF.json
-    filePath: blocks/context/PageSHCF.yaml
+    filePath: blocks/container/PageSHCF.yaml
     description_content: |
       Page SHCF provides a minimal layout structure for a page container with a sider, header, content, and footer arrangement.
 

package/blocks/{context → container}/PageSiderMenu.yaml

@@ -16,9 +16,9 @@ _ref:
   path: templates/blocks/template.yaml.njk
   vars:
     block_type: PageSiderMenu
-    category: context
+    category: container
     schema: ../blocks/blocksAntd/src/blocks/PageSiderMenu/PageSiderMenu.json
-    filePath: blocks/context/PageSiderMenu.yaml
+    filePath: blocks/container/PageSiderMenu.yaml
     description_content: |
       The Page Sider Menu block provides a structured layout for a page with a header, sider including menu, content and footer area.
     init_state_values:

package/blocks/display/Img.yaml

@@ -36,5 +36,5 @@ _ref:
           type: Img
           properties:
             src: https://docs.lowdefy.com/public/logo-light-theme.png
-            srcset: https://docs.lowdefy.com/public/logo-square-light-theme.png 40w, https://docs.lowdefy.com/public/logo-light-theme.png 577w
+            srcSet: https://docs.lowdefy.com/public/logo-square-light-theme.png 40w, https://docs.lowdefy.com/public/logo-light-theme.png 577w
             sizes: '(max-width: 576px) 40px, 577px'

package/concepts/custom-blocks.yaml

@@ -45,7 +45,7 @@ _ref:
 
             ```yaml
             name: dashboard-app
-            lowdefy: 3.23.2
+            lowdefy: 3.23.1
             types:
               AmChartsXY:
                 url: https://blocks-cdn.lowdefy.com/v3.10.1/blocks-amcharts/meta/AmChartsXY.json
@@ -95,7 +95,7 @@ _ref:
 
             ```yaml
             name: dashboard-app
-            lowdefy: 3.23.2
+            lowdefy: 3.23.1
             types:
               MyCustomBlock:
                 url: http://localhost:3002/meta/MyCustomBlock.json

package/concepts/custom-code.yaml

@@ -53,7 +53,7 @@ _ref:
 
             ```yaml
             name: google-analytics-example
-            lowdefy: 3.23.2
+            lowdefy: 3.23.1
             # ...
             app:
               html:
@@ -98,7 +98,7 @@ _ref:
             ```yaml
             # /lowdefy.yaml
             name: json-todos
-            lowdefy: 3.23.2
+            lowdefy: 3.23.1
             app:
               html:
                 appendHead:
@@ -156,7 +156,7 @@ _ref:
             ```yaml
             # /lowdefy.yaml
             name: operator-example
-            lowdefy: 3.23.2
+            lowdefy: 3.23.1
             app:
               html:
                 appendHead:

package/connections/AxiosHttp.yaml

@@ -88,7 +88,7 @@ _ref:
             ###### A basic full example requesting data from https://jsonplaceholder.typicode.com
 
             ```yaml
-            lowdefy: 3.23.2
+            lowdefy: 3.23.1
             name: Lowdefy starter
             connections:
               - id: my_api

package/connections/Redis.yaml

@@ -0,0 +1,147 @@
+# Copyright 2020-2021 Lowdefy, Inc
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+
+#     http://www.apache.org/licenses/LICENSE-2.0
+
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+_ref:
+  path: templates/general.yaml.njk
+  vars:
+    pageId: Redis
+    pageTitle: Redis
+    section: Connections
+    filePath: connections/Redis.yaml
+    content:
+      - id: markdown_intro
+        type: MarkdownWithCode
+        properties:
+          content: |
+            [`Redis`](http://redis.io/) is an open-source, in-memory key-value data structure store. Redis offers a set of versatile in-memory data structures (strings, hashes, lists, sets, sorted sets with range queries, bitmaps, hyperloglogs, geospatial indexes, and streams) that allow the creation of many custom applications. Key use cases for Redis include database, caching, session management and message broker.
+
+            Lowdefy integrates with Redis using the one of the recommended [Node.js clients (node-redis)](https://github.com/redis/node-redis).
+
+      - id: markdown_connection
+        type: MarkdownWithCode
+        properties:
+          content: |
+            ## Connections
+
+            Connection types:
+              - Redis
+
+            ### Redis
+
+            #### Properties
+            - `connection: object | string `: __Required__ - Connection object or string to pass to the [`redis client`](https://github.com/redis/node-redis) redis client.
+
+            The connection object accepts will be passed to the redis client verbatim, so check out the [configuration instructions](https://github.com/redis/node-redis/blob/master/docs/client-configuration.md).
+
+            #### Examples
+
+            ###### Redis with connection object:
+            ```yaml
+            connections:
+              - id: redis
+                type: Redis
+                properties:
+                  connection:
+                    username: 
+                      _secret: REDIS_USERNAME
+                    password: 
+                      _secret: REDIS_PASSWORD
+                    database:
+                      _secret: REDIS_DATABASE
+                    socket:
+                      host:
+                        _secret: REDIS_HOST
+                      port:
+                        _secret: REDIS_PORT
+            ```
+            Environment variables:
+            ```
+            LOWDEFY_SECRET_REDIS_USERNAME = user
+            LOWDEFY_SECRET_REDIS_PASSWORD = password
+            LOWDEFY_SECRET_REDIS_DATABASE = 4
+            LOWDEFY_SECRET_REDIS_HOST = redis.server.com
+            LOWDEFY_SECRET_REDIS_PORT = 5000
+            ```
+
+            ###### Redis with connection string:
+            ```yaml
+            connections:
+              - id: redis
+                type: Redis
+                properties:
+                  connection:
+                    _secret: REDIS_CONNECTION_STRING
+            ```
+            Environment variables:
+            ```
+            LOWDEFY_SECRET_REDIS_CONNECTION_STRING = redis://user:password@redis:server.com:5000/4'
+            ```
+      - id: markdown_requests
+        type: MarkdownWithCode
+        properties:
+          content: |
+            ## Requests
+
+            Request types:
+              - Redis
+
+            ### Redis
+
+            #### Properties
+
+            - `command: string`: **Required** - Redis command to be executed, accepts all of the [out-of-the-box Redis commands](https://redis.io/commands).
+            - `parameters: array`: An array of parameters to be passed to the redis command.
+            - `modifiers: object`: The redis modififers to be passed to the redis command.
+
+            #### Examples
+
+            ###### Setting a key-value pair in redis:
+
+            ```yaml
+            id: redisRequest
+            type: Redis
+            connectionId: redis
+            properties:
+              command: set
+              parameters:
+                - key
+                - value
+            ```
+
+            ###### Getting a value from redis:
+
+            ```yaml
+            id: redisRequest
+            type: Redis
+            connectionId: redis
+            properties:
+              command: get
+              parameters:
+                - key
+            ```
+
+            ###### Setting a key-value pair only if key does not exist:
+
+            ````yaml
+            id: redisRequest
+            type: Redis
+            connectionId: redis
+            properties:
+              command: set
+              parameters:
+                - key
+                - value
+              modififers:
+                nx: true
+            ```

package/deployment/aws-lambda.yaml

@@ -55,10 +55,10 @@ _ref:
             COPY  --chown=node:node  . .
 
             # Build the Lowdefy config using the Lowdefy CLI
-            RUN npx lowdefy@3.23.2 build
+            RUN npx lowdefy@3.23.1 build
 
             # Use the correct Lowdefy base image
-            FROM lowdefy/lowdefy-aws-lambda:3.23.2
+            FROM lowdefy/lowdefy-aws-lambda:3.23.1
 
             # Copy build output from build stage
             COPY --from=build /home/node/lowdefy/.lowdefy/build ./build

package/deployment/docker.yaml

@@ -65,10 +65,10 @@ _ref:
             COPY  --chown=node:node  . .
 
             # Build the Lowdefy config using the Lowdefy CLI
-            RUN npx lowdefy@3.23.2 build
+            RUN npx lowdefy@3.23.1 build
 
             # Use the correct Lowdefy base image
-            FROM lowdefy/lowdefy:3.23.2
+            FROM lowdefy/lowdefy:3.23.1
 
             # Copy build output from build stage
             COPY --from=build --chown=node:node /home/node/lowdefy/.lowdefy/build ./build

package/howto/generate-csv.yaml.njk

@@ -184,7 +184,7 @@ _ref:
 
             ###### /lowdefy.yaml
             ```yaml
-            lowdefy: 3.23.2
+            lowdefy: 3.23.1
             name: Generate PDF from data with Lowdefy
 
             app:

package/howto/generate-pdf.yaml.njk

@@ -237,7 +237,7 @@ _ref:
             ###### /lowdefy.yaml
             ```yaml
             name: Generate a PDF
-            lowdefy: 3.23.2
+            lowdefy: 3.23.1
 
             app:
               html:
@@ -302,7 +302,7 @@ _ref:
 
             ###### /lowdefy.yaml
             ```yaml
-            lowdefy: 3.23.2
+            lowdefy: 3.23.1
             name: Generate PDF from data with Lowdefy
 
             app:

package/howto/generateCsv/lowdefy.yaml

@@ -1,4 +1,4 @@
-lowdefy: 3.23.2
+lowdefy: 3.23.1
 name: Generate PDF from data with Lowdefy
 
 app:

package/howto/generatePdf/lowdefy.yaml

@@ -1,4 +1,4 @@
-lowdefy: 3.23.2
+lowdefy: 3.23.1
 name: Generate PDF from data with Lowdefy
 
 app:

package/howto/use-refrences.md

@@ -0,0 +1,5 @@
+# How to use references
+
+When starting a new Lowdefy application, your app is simple, uncomplicated and easy to navigate between pages, blocks, requests and actions. Unfortunately as with any software application, as you add more functionality, your app code start to grow to thousands of lines of code. When writing an app using conventional tools like javascript, you'd deal with this complexity by splitting your app into methods, files and folders. A experienced programmer will make design choices to best abstract portions of the code to make the app more understandable and maintainable.
+
+With Lowdefy the built configuration is served in one giant JSON blob. you can do the same by splitting portions of your Lowdefy config into separate files and folders, and stich them together and

package/lowdefy.yaml

@@ -13,7 +13,7 @@
 # limitations under the License.
 
 name: '@lowdefy/docs'
-lowdefy: 3.23.2
+lowdefy: 3.23.1
 licence: Apache-2.0
 
 cli:

package/menus.yaml

@@ -413,31 +413,6 @@
         - id: Modal
           type: MenuLink
           pageId: Modal
-        - id: Result
-          type: MenuLink
-          pageId: Result
-        - id: Span
-          type: MenuLink
-          pageId: Span
-        - id: Spin
-          type: MenuLink
-          pageId: Spin
-        - id: Tabs
-          type: MenuLink
-          pageId: Tabs
-        - id: Tooltip
-          type: MenuLink
-          pageId: Tooltip
-
-    - id: blocks_context
-      type: MenuGroup
-      properties:
-        title: Context Blocks
-        icon: GroupOutlined
-      links:
-        - id: Context
-          type: MenuLink
-          pageId: Context
         - id: PageHCF
           type: MenuLink
           pageId: PageHCF
@@ -456,6 +431,22 @@
         - id: PageSiderMenu
           type: MenuLink
           pageId: PageSiderMenu
+        - id: Result
+          type: MenuLink
+          pageId: Result
+        - id: Span
+          type: MenuLink
+          pageId: Span
+        - id: Spin
+          type: MenuLink
+          pageId: Spin
+        - id: Tabs
+          type: MenuLink
+          pageId: Tabs
+        - id: Tooltip
+          type: MenuLink
+          pageId: Tooltip
+
     - id: blocks_list
       type: MenuGroup
       properties:
@@ -524,6 +515,9 @@
         - id: PostgreSQL
           type: MenuLink
           pageId: PostgreSQL
+        - id: Redis
+          type: MenuLink
+          pageId: Redis
         - id: SendGridMail
           type: MenuLink
           pageId: SendGridMail
@@ -779,11 +773,11 @@
         title: Lowdefy Versions
         icon: BranchesOutlined
       links:
-        - id: v3.23.2
+        - id: v3.23.1
           type: MenuLink
           url: https://docs.lowdefy.com
           properties:
-            title: v3.23.2
+            title: v3.23.1
         - id: v3.22.0
           type: MenuLink
           url: https://61519bcb8b8ed4412aae3057--lowdefy-docs.netlify.app

package/operators/_actions.yaml

@@ -77,7 +77,7 @@ _ref:
       First register a custom JavaScript action: `getNormalizedEigenvector`
       ```yaml
       # file: lowdefy.yaml
-      lowdefy: '3.23.2'
+      lowdefy: '3.23.1'
       app:
         html:
           appendHead: |

package/operators/_diff.yaml

@@ -19,7 +19,6 @@ _ref:
     pageId: _diff
     pageTitle: _diff
     filePath: operators/_diff.yaml
-    env: Server Only
     methods:
       - name: deep
         types: |

package/operators/_event.yaml

@@ -19,6 +19,7 @@ _ref:
     pageId: _event
     pageTitle: _event
     filePath: operators/_event.yaml
+    env: Client Only
     types: |
       ```
       (key: string): any

package/operators/_global.yaml

@@ -19,6 +19,7 @@ _ref:
     pageId: _global
     pageTitle: _global
     filePath: operators/_global.yaml
+    env: Client Only
     types: |
       ```
       (key: string): any

package/operators/_index.yaml

@@ -19,6 +19,7 @@ _ref:
     pageId: _index
     pageTitle: _index
     filePath: operators/_index.yaml
+    env: Client Only
     types: |
       ```
       (key: string): any

package/operators/_input.yaml

@@ -19,6 +19,7 @@ _ref:
     pageId: _input
     pageTitle: _input
     filePath: operators/_input.yaml
+    env: Client Only
     types: |
       ```
       (key: string): any