@fugood/bricks-project 2.24.0-beta.4 → 2.24.0-beta.41

package/types/generators/BleCentral.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Bluetooth Low Energy central: scan, connect, and communicate with BLE peripherals
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Start scan */
 export type GeneratorBleCentralActionStartScan = Action & {
@@ -178,37 +182,53 @@ Default property:
     /* Event for state change */
     onStateChange?: Array<EventAction>
     /* Event for error occurred */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['BleCentral']['onError']>>
     /* Event for start scan */
     onStartScan?: Array<EventAction>
     /* Event for stop scan */
     onStopScan?: Array<EventAction>
     /* Event for discover device */
-    onDiscoverDevice?: Array<EventAction>
+    onDiscoverDevice?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['BleCentral']['onDiscoverDevice']>
+    >
     /* Event for device connected */
-    onConnectDevice?: Array<EventAction>
+    onConnectDevice?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['BleCentral']['onConnectDevice']>
+    >
     /* Event for device disconnected */
     onDisconnectDevice?: Array<EventAction>
     /* Event for receive on read */
-    onReadReceive?: Array<EventAction>
+    onReadReceive?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['BleCentral']['onReadReceive']>
+    >
     /* Event for receive on monitor */
-    onMonitorReceive?: Array<EventAction>
+    onMonitorReceive?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['BleCentral']['onMonitorReceive']>
+    >
   }
   outlets?: {
     /* Is scaning */
-    isScaning?: () => Data
+    isScaning?: () => Data<boolean>
     /* Discovered device list */
-    discoveredDeviceList?: () => Data
+    discoveredDeviceList?: () => Data<
+      Array<{
+        id?: string
+        name?: string
+        rssi?: number
+        advertising?: { [key: string]: any }
+        [key: string]: any
+      }>
+    >
     /* Error message */
-    errorMessage?: () => Data
+    errorMessage?: () => Data<string>
   }
 }
 
-/* BLE Central Mode Generator */
+/* Bluetooth Low Energy central: scan, connect, and communicate with BLE peripherals */
 export type GeneratorBleCentral = Generator &
   GeneratorBleCentralDef & {
     templateKey: 'GENERATOR_BLE_CENTRAL'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorBleCentralDef & {
           conds?: Array<{

package/types/generators/BlePeripheral.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Bluetooth Low Energy peripheral: advertise services and respond to central connections
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Start advertise */
 export type GeneratorBlePeripheralActionStart = Action & {
@@ -149,7 +153,7 @@ Default property:
     beaconsEnable?: boolean | DataLink
     /* Measured RSSI @ 1m, used for calculate distance */
     beaconsTxPower?: number | DataLink
-    /* Beacon configs  
+    /* Beacon configs
   presets has pre-defined layout and manufacturerId  
   layout string is like AltBeacon's Beacon Layout, but replace "x" as extra data  
   id and data could be 0x prefixed hex, hex string, decimal or UUID  
@@ -173,19 +177,19 @@ Default property:
   events?: {}
   outlets?: {
     /* Is advertising */
-    isAdvertising?: () => Data
+    isAdvertising?: () => Data<boolean>
     /* Last receive written */
-    lastWrite?: () => Data
+    lastWrite?: () => Data<{ [key: string]: any }>
     /* Error message */
-    errorMessage?: () => Data
+    errorMessage?: () => Data<string>
   }
 }
 
-/* BLE Peripheral Mode Generator */
+/* Bluetooth Low Energy peripheral: advertise services and respond to central connections */
 export type GeneratorBlePeripheral = Generator &
   GeneratorBlePeripheralDef & {
     templateKey: 'GENERATOR_BLE_PERIPHERAL'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorBlePeripheralDef & {
           conds?: Array<{

package/types/generators/CanvasMap.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Trigger canvas navigation by setup rules
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 interface GeneratorCanvasMapDef {
   /*
@@ -35,15 +39,15 @@ Default property:
   }
   events?: {
     /* Event triggered when a rule matches and canvas navigation occurs */
-    onNavigate?: Array<EventAction>
+    onNavigate?: Array<EventAction<string & keyof TemplateEventPropsMap['CanvasMap']['onNavigate']>>
   }
   outlets?: {
     /* Last matched trigger rule that caused canvas navigation */
-    lastMatchedRule?: () => Data
+    lastMatchedRule?: () => Data<{ [key: string]: any }>
     /* Index of the last matched rule in triggerList */
-    lastMatchedIndex?: () => Data
+    lastMatchedIndex?: () => Data<number>
     /* Total count of canvas navigations triggered by this generator */
-    navigationCount?: () => Data
+    navigationCount?: () => Data<number>
   }
 }
 
@@ -51,7 +55,7 @@ Default property:
 export type GeneratorCanvasMap = Generator &
   GeneratorCanvasMapDef & {
     templateKey: 'GENERATOR_CANVAS_MAP'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorCanvasMapDef & {
           conds?: Array<{

package/types/generators/CastlesPay.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Payment processing integration for Castles payment terminals
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Sale */
 export type GeneratorCastlesPayActionSale = ActionWithParams & {
@@ -44,23 +48,27 @@ Default property:
   property?: {}
   events?: {
     /* Action Success */
-    onActionSuccess?: Array<EventAction>
+    onActionSuccess?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['CastlesPay']['onActionSuccess']>
+    >
     /* Action Error */
-    onActionError?: Array<EventAction>
+    onActionError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['CastlesPay']['onActionError']>
+    >
   }
   outlets?: {
     /* Last Transaction Result */
-    lastTransactionResult?: () => Data
+    lastTransactionResult?: () => Data<{ [key: string]: any }>
     /* Last Error */
-    lastError?: () => Data
+    lastError?: () => Data<string>
   }
 }
 
-/* Castles Pay */
+/* Payment processing integration for Castles payment terminals */
 export type GeneratorCastlesPay = Generator &
   GeneratorCastlesPayDef & {
     templateKey: 'GENERATOR_CASTLES_PAY'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorCastlesPayDef & {
           conds?: Array<{

package/types/generators/DataBank.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Access and subscribe to shared Data properties from the project Data Bank
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Run Data Bank fetch */
 export type GeneratorDataBankActionFetch = Action & {
@@ -71,7 +75,7 @@ Default property:
     spacekey?: string | DataLink
     /* Data need to be fetched */
     properties?: Array<string | DataLink> | DataLink
-    /* Determine the cache behavior  
+    /* Determine the cache behavior
   
  cache-first: Cache first if existing, then fetch from network  
  network-and-cache: Fetch from network, then save cache  
@@ -82,31 +86,62 @@ Default property:
   }
   events?: {
     /* Event of Data Bank fetch response */
-    onFetchResponse?: Array<EventAction>
+    onFetchResponse?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['DataBank']['onFetchResponse']>
+    >
     /* Event of Data Bank change from subscription */
     onChange?: Array<EventAction>
     /* Event of Data Bank fetch error */
     onFetchError?: Array<EventAction>
     /* Event of error */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['DataBank']['onError']>>
     /* Event of subscription on connection */
     subscribeDataOnConnect?: Array<EventAction>
     /* Server connections error of subscription */
-    subscribeDataOnConnectError?: Array<EventAction>
+    subscribeDataOnConnectError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['DataBank']['subscribeDataOnConnectError']>
+    >
   }
   outlets?: {
     /* Response for Data Bank fetch request, it will save to Data */
-    response?: () => Data
+    response?: () => Data<
+      Array<{
+        __typename?: string
+        id?: string
+        createAt?: string
+        updateAt?: string
+        spaceId?: string
+        propertyId?: string
+        definition?: {
+          type?: string
+          title?: string
+          schema?: { [key: string]: any }
+          [key: string]: any
+        }
+        meta?: string
+        value?: any
+        lastUpdateHash?: string
+        lastUpdateNote?: string
+        lastUpdateKey?: {
+          name?: string
+          enable_expired?: boolean
+          expired_at?: any
+          jwt?: boolean
+          [key: string]: any
+        }
+        [key: string]: any
+      }>
+    >
     /* Server response error of Data Bank fetch request,    it will save to Data */
-    error?: () => Data
+    error?: () => Data<string>
   }
 }
 
-/* Get Data or subscribe to Data changes from Data Bank */
+/* Access and subscribe to shared Data properties from the project Data Bank */
 export type GeneratorDataBank = Generator &
   GeneratorDataBankDef & {
     templateKey: 'GENERATOR_DATA_BANK'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorDataBankDef & {
           conds?: Array<{

package/types/generators/File.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * File system operations: read, write, copy, delete, and list files
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Read stats */
 export type GeneratorFileActionReadStats = Action & {
@@ -259,69 +263,144 @@ Default property:
   }
   events?: {
     /* On file handler init error */
-    initError?: Array<EventAction>
+    initError?: Array<EventAction<string & keyof TemplateEventPropsMap['File']['initError']>>
     /* On file status change */
-    onFileStatusChange?: Array<EventAction>
+    onFileStatusChange?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onFileStatusChange']>
+    >
     /* On read stats error */
-    onReadStatsError?: Array<EventAction>
+    onReadStatsError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onReadStatsError']>
+    >
     /* On read content error */
-    onReadContentError?: Array<EventAction>
+    onReadContentError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onReadContentError']>
+    >
     /* On read content error */
-    onAppendContentError?: Array<EventAction>
+    onAppendContentError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onAppendContentError']>
+    >
     /* On write content error */
-    onWriteContentError?: Array<EventAction>
+    onWriteContentError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onWriteContentError']>
+    >
     /* On upload progress */
-    onUploadProgress?: Array<EventAction>
+    onUploadProgress?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onUploadProgress']>
+    >
     /* On upload error */
-    onUploadError?: Array<EventAction>
+    onUploadError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onUploadError']>
+    >
     /* On upload complete */
-    onUploadComplete?: Array<EventAction>
+    onUploadComplete?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onUploadComplete']>
+    >
     /* On upload all done */
-    onUploadAllComplete?: Array<EventAction>
+    onUploadAllComplete?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onUploadAllComplete']>
+    >
     /* On download progress */
-    onDownloadProgress?: Array<EventAction>
+    onDownloadProgress?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onDownloadProgress']>
+    >
     /* On download error */
-    onDownloadError?: Array<EventAction>
+    onDownloadError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onDownloadError']>
+    >
     /* On download complete */
-    onDownloadComplete?: Array<EventAction>
+    onDownloadComplete?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onDownloadComplete']>
+    >
     /* On download all done */
-    onDownloadAllComplete?: Array<EventAction>
+    onDownloadAllComplete?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['File']['onDownloadAllComplete']>
+    >
   }
   outlets?: {
     /* File init error result will be stored in Data */
-    initError?: () => Data
+    initError?: () => Data<string>
     /* File read stats result will be stored in Data */
-    readStats?: () => Data
+    readStats?: () => Data<{
+      path?: string
+      size?: number
+      isDirectory?: boolean
+      mtime?: string
+      ctime?: string
+      mode?: number
+      originalFilepath?: string
+      [key: string]: any
+    }>
     /* File read content result will be stored in Data */
-    readContent?: () => Data
+    readContent?: () => Data<any>
     /* File read details result will be stored in Data */
-    readDetails?: () => Data
+    readDetails?: () => Data<{
+      path?: string
+      content?: any
+      size?: number
+      exists?: boolean
+      [key: string]: any
+    }>
     /* File read error result will be stored in Data */
-    readError?: () => Data
+    readError?: () => Data<string>
     /* File append content result will be stored in Data */
-    appendDetails?: () => Data
+    appendDetails?: () => Data<{
+      path?: string
+      appended?: boolean
+      contentLength?: number
+      [key: string]: any
+    }>
     /* File append error result will be stored in Data */
-    appendError?: () => Data
+    appendError?: () => Data<string>
     /* File write details result will be stored in Data */
-    writeDetails?: () => Data
+    writeDetails?: () => Data<{
+      path?: string
+      written?: boolean
+      contentLength?: number
+      [key: string]: any
+    }>
     /* File write error result will be stored in Data */
-    writeError?: () => Data
+    writeError?: () => Data<string>
     /* File upload progress result will be stored in Data */
-    uploadProgress?: () => Data
+    uploadProgress?: () => Data<{
+      id?: string
+      path?: string
+      uri?: string
+      hash?: string
+      hashType?: string
+      headers?: { [key: string]: any }
+      fields?: { [key: string]: any }
+      method?: string
+      progress?: number
+      isLastUpdated?: boolean
+      [key: string]: any
+    }>
     /* File upload complete result will be stored in Data */
-    uploadResult?: () => Data
+    uploadResult?: () => Data<any>
     /* File download progress result will be stored in Data */
-    downloadProgress?: () => Data
+    downloadProgress?: () => Data<{
+      id?: string
+      path?: string
+      uri?: string
+      hash?: string
+      hashType?: string
+      headers?: { [key: string]: any }
+      fields?: { [key: string]: any }
+      method?: string
+      progress?: number
+      isLastUpdated?: boolean
+      [key: string]: any
+    }>
     /* File download complete result will be stored in Data */
-    downloadResult?: () => Data
+    downloadResult?: () => Data<any>
   }
 }
 
-/* File handling */
+/* File system operations: read, write, copy, delete, and list files */
 export type GeneratorFile = Generator &
   GeneratorFileDef & {
     templateKey: 'GENERATOR_FILE'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorFileDef & {
           conds?: Array<{

package/types/generators/GraphQl.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * GraphQL client for Query, Mutation, and Subscription (WebSocket) with response caching and optional Firebase Realtime Database link
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Execute GraphQL request with defined properties */
 export type GeneratorGraphQLActionRunQuery = ActionWithParams & {
@@ -93,21 +97,23 @@ Default property:
     /* Event triggered when subscription connection is successful */
     subscriptionOnConnection?: Array<EventAction>
     /* Event triggered when subscription connection error occurs */
-    subscriptionOnConnectionError?: Array<EventAction>
+    subscriptionOnConnectionError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['Graphql']['subscriptionOnConnectionError']>
+    >
   }
   outlets?: {
     /* Response for GraphQL request, it will save to Data */
-    response?: () => Data
+    response?: () => Data<{ [key: string]: any }>
     /* Server response error of GraphQL request,    it will save to Data */
-    error?: () => Data
+    error?: () => Data<string>
   }
 }
 
-/* Execute GraphQL Query / Mutation / Subscriptions */
+/* GraphQL client for Query, Mutation, and Subscription (WebSocket) with response caching and optional Firebase Realtime Database link */
 export type GeneratorGraphQL = Generator &
   GeneratorGraphQLDef & {
     templateKey: 'GENERATOR_GRAPHQL'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorGraphQLDef & {
           conds?: Array<{

package/types/generators/Http.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * HTTP client supporting all methods (GET/POST/PUT/DELETE/PATCH/...), response parsing (JSON/text/XML/CSV), SSE event streams, and multipart file uploads
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Run HTTP request with defined properties */
 export type GeneratorHTTPActionRunRequest = ActionWithParams & {
@@ -141,7 +145,7 @@ Default property:
     redirect?: 'manual' | 'follow' | 'error' | DataLink
     /* Referrer of HTTP request */
     referrer?: 'no-referrer' | 'client' | DataLink
-    /* HTTP request body,  it will transform depends on `headers.Content-Type`    (`application/json`, `application/x-www-form-urlencoded` or `multipart/form-data`)  
+    /* HTTP request body,  it will transform depends on `headers.Content-Type`    (`application/json`, `application/x-www-form-urlencoded` or `multipart/form-data`)
   The multipart schema like `{ file: { uri: File, type: File MIME, name: File Name }, field: "value" }` */
     body?: {} | DataLink
     /* HTTP response type */
@@ -156,25 +160,44 @@ Default property:
   events?: {}
   outlets?: {
     /* Response for HTTP request */
-    response?: () => Data
+    response?: () => Data<string | { [key: string]: any }>
     /* Response details for HTTP request */
-    responseDetails?: () => Data
+    responseDetails?: () => Data<{
+      ok?: boolean
+      redirected?: boolean
+      type?: string
+      status?: number
+      statusText?: string
+      headers?: { [key: string]: any }
+      body?: any
+      event?: string
+      id?: string
+      data?: any
+      [key: string]: any
+    }>
     /* All received data from event stream */
-    eventLog?: () => Data
+    eventLog?: () => Data<Array<any>>
     /* All received event details from event stream */
-    eventLogDetails?: () => Data
+    eventLogDetails?: () => Data<
+      Array<{
+        event?: string
+        id?: string
+        data?: any
+        [key: string]: any
+      }>
+    >
     /* EventSource state */
-    sseState?: () => Data
+    sseState?: () => Data<string>
     /* Server response error of HTTP request */
-    error?: () => Data
+    error?: () => Data<string>
   }
 }
 
-/* Execute HTTP requests */
+/* HTTP client supporting all methods (GET/POST/PUT/DELETE/PATCH/...), response parsing (JSON/text/XML/CSV), SSE event streams, and multipart file uploads */
 export type GeneratorHTTP = Generator &
   GeneratorHTTPDef & {
     templateKey: 'GENERATOR_HTTP'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorHTTPDef & {
           conds?: Array<{