跳到主要内容

V2.1.0

· 阅读需 3 分钟
Co-creator of yunzaijs 1
注意

除却订阅hook外，其他内容都将向下兼容。

一 、新增用于内部的cbp协议，扩展性更强。如支持作为服务，让子服务进行连接。同时也支持了在现有服务上定义接口

二、 新增局部的响应中间件。

三、增强加载平台包的稳定性，主要是实现代码崩溃可自动重启。

四、优化hook的设计，包括消息发送和事件订阅等。

五、支持更多的个性化配置。

六、新增更直观且执行效率更高的路由系统。

七、支持发送md、buttons等数据格式。

八、整理了一批常用的工具函数。

九、新增更适用于新架构的hook，以调用平台原生接口。

十、修复若干BUG。

新功能示例​

useSubscribe​

!!! useSubscribe 和 2.0 不兼容

import { Text, useMessage } from 'alemonjs'
const selects = onSelects(['message.create'])
export default onResponse(selects, event => {
  const [subscribe] = useSubscribe(event, selects)
  subscribe.monut(Res.current, ['UserId']) // res 响应之前

  // more ...
  subscribe.create(Res.current, []) // res 创建之后
  subscribe.unmonut(Res.current, []) // res 响应之后
})

useMessage​

import { Text, useMessage } from 'alemonjs'
const selects = onSelects(['message.create'])
export default onResponse(selects, event => {
  const [message] = useMessage(event)
  message.send(format(Text('Hello Word!')))
})

useClient​

import {
  platform as qqbot,
  useClient
} from '@alemonjs/qq-bot'
const selects = onSelects(['message.create'])
export default onResponse(selects, event => {
  if (event.platform === qqbot) {
    const [client, value] = useClient(event)
    // 使用原生api和数据
  }
})

defineResponse​

支持定义路由规则来更细致化的控制和管理响应。有效提高匹配效率。

src/router.ts
import { lazy } from 'alemonjs'
export default defineResponse([
  {
    // 用户验证中间件。这是局部的，仅对 children 下的响应规则生效
    handler: lazy(() => import('@src/response/mw')),
    children: [
      {
        // 匹配正则
        regular: /^(!|！|\/|#|＃)?我的信息/,
        handler: lazy(
          () =>
            import('@src/response/user-message/base/res')
        )
      }
    ]
  }
])

defineMiddleware​

支持定义中间件路由规则来更细致化的控制和管理响应。有效提高匹配效率。

src/router-mw.ts
import { lazy } from 'alemonjs'
export default defineMiddleware([
  {
    handler: lazy(() => import('./middleware/mw'))
  }
])

Route​

import { Context } from 'koa'

// GET
export const GET = (ctx: Context, next) => {
  ctx.status = 200
  ctx.body = {
    message: 'hello word !'
  }
}

// POST
export const POST = (ctx: Context, next) => {
  ctx.status = 200
  ctx.body = {
    message: 'hello word !'
  }
}

// DELETE
// PUT

V2.0.16

· 阅读需 1 分钟
Co-creator of yunzaijs 1
  • 简化Selects

原来的

import { createSelects } from 'alemonjs'
const selects = createSelects(['message.create'])

更改为

const selects = onSelects(['message.create'])
  • 废弃

useObserver 废弃

应使用 useSubscribe

// 创建观察者
const [_, observer] = useSubscribe(event, selects)

createDataFormat 废弃

应使用format

  • 新增 useSends
import { Text, useSends } from 'alemonjs'
const selects = onSelects(['message.create'])
export default onResponse(selects, event => {
  const [send] = useSend(event)
  send(format(Text('Hello Word!')))
})

V2.0.4

· 阅读需 2 分钟
Co-creator of yunzaijs 1
  • 【Fix】中间件的regular 没生效。
import { createSelects } from 'alemonjs'
const selects = createSelects(['message.create'])
// 仅限 # 和 / 开头的消息才执行该中间件
export const regular = /^(#|\/)/
export default onMiddleware(selects, (event, next) => {
  next()
})
  • 【Feat】支持return对象以描述其他行为
import { createSelects } from 'alemonjs'
const selects = createSelects(['message.create'])
export default onResponse(selects, event => {
  const res = {
    // any
  }
  return {
    // 允许分组，等同于 return true
    allowGrouping: true,
    // 即将要发送的数据
    data: [],
    ...res
  }
})
  • 【Feat】支持内部存储实例
import { Logger, logger as log } from 'alemonjs'
const logger = new Logger().value // 同 logger as log
import { Response } from 'alemonjs'
// 内部所有的res索引
const res = new Response().value
import { Middleware } from 'alemonjs'
// 内部所有的mws索引
const res = new Middleware().value
import { SubscribeList } from 'alemonjs'
// 所有的 create + message.create 订阅
// 即 onSubscribe
const subscribeList = new SubscribeList(
  'create',
  'message.create'
).value
// const subscribeList = new SubscribeList('mount', 'message.create').value
// const subscribeList = new SubscribeList('unmount', 'message.create').value
import { StateSubscribe } from 'alemonjs'
const stateList = new StateSubscribe(
  'create',
  'message.create'
)
stateList.on(() => {}) // onState
stateList.un(() => {}) // unState
const stateSubscribe = stateList.value
import { State } from 'alemonjs'
// 即 useState
const stateList = new State('main:res:name') // new State('main:apps:name')
stateList.value = true // 设置为 true
stateList.value = false // 设置为 false
import { ChildrenApp } from 'alemonjs'
// 默认 main。
// 得到内部res、mw、周期等
const app = new ChildrenApp('main')?.value

V2.0.0

· 阅读需 1 分钟
Co-creator of yunzaijs 1
  • jsx
import React from 'react'
import { createSelects } from 'alemonjs'
import { Text, useSend } from 'alemonjs/jsx'
const selects = createSelects(['message.create'])
// 导出响应
export default onResponse(selects, event => {
  // 创建接口
  const Send = useSend(event)
  // 发送文本
  Send(<Text>hello</Text>)
})

V2.0.0-rc.94

· 阅读需 1 分钟
Co-creator of yunzaijs 1
  • 主动消息

部分平台可能仅支持有限或不支持主动消息机制

import { sendToChannel, sendToUser, Text } from 'alemonjs'
// 向指定频道发送消息
sendToChannel('ChannelID', [Text('hello word')])
// 向指定用户发送消息
sendToUser('UserID', [Text('hello word')])
  • 数据格式
import { createDataFormat } from 'alemonjs'

const data = createDataFormat(Text('hello word'))

// 例1
sendToChannel('ChannelID', data)

// 例2
Send(...data)

V2.0.0-rc.88

· 阅读需 1 分钟
Co-creator of yunzaijs 1
  • 图片数据扩展
import { ImageURL, useSend } from 'alemonjs'
const Send = useSend({})
// 网络图片地址
Send(ImageURL('https://xxx.yyy.com/image.png'))
import { ImageFile, useSend } from 'alemonjs'
import img_url from '@src/asstes/test.png'
const Send = useSend({})
// 本地图片地址
Send(ImageFile(img_url))

V2.0.0-rc.84

· 阅读需 1 分钟
Co-creator of yunzaijs 1
  • 订阅事件数据结构更改为链表

避免随着事件的增加，而数据长度增加

class Node<T> {
  data: T // 节点数据
  next: Node<T> | null // 指向下一个节点的指针
  constructor(data: T) {
    this.data = data
    this.next = null
  }
}

export class SinglyLinkedList<T> {
  private head: Node<T> | null // 链表的头节点
  private size: number // 链表的大小
  private current: Node<T> | null // 当前节点指针
  constructor(initialValues?: T[]) {}
}

V2.0.0-rc.81

· 阅读需 1 分钟
Co-creator of yunzaijs 1
  • useState

声明res/mw的状态,可用于管理是否启用

apps/**/*/res.ts
export name = 'login'
export const regular = /^(#|\/)?login$/
export default OnResponse((event, next) => {
  // login code ...
}, 'message.create')
apps/**/*/res.ts
import { Text, useSend, useState } from 'alemonjs'
export const regular = /^(#|\/)?close:/
export default OnResponse((event, next) => {
  //   /close:login
  const name = event.MessageText.replace(regular, '')
  const [state, setState] = useState(name)
  if (state) {
    next()
    return
  }
  setState(false)
  const Send = useSend(event)
  Send(Text('关闭成功'))
  return
}, 'message.create')

可以在任意地方订阅状态的更改。

apps/**/*/res.ts
import { eventState, unEventState } from 'alemonjs'

const login = state => {}

eventState('login', login)
unEventState('login', login)
  • 分组

复用逻辑,共用一个next

const Res = OnResponse((event, next) => {
  console.log('text', event.MessageText)
  // 允许在同组响应中，继续后续的函数
  return true
}, 'message.create')

export default OnResponse(
  [
    // add
    Res.current,
    (event, next) => {
      console.log('完成')
    }
  ],
  'message.create'
)

V2.0.0-rc.78

· 阅读需 1 分钟
Co-creator of yunzaijs 1
  • 新增regular
// 不匹配该正则，自动进行next
export const regular = /^(#|\/)?hello$/
export default OnResponse((event, next) => {
  //
}, 'message.create')

V2.0.0-rc.76

· 阅读需 1 分钟
Co-creator of yunzaijs 1
  • 新增useSubscribe
// [事件创建之后，事件被中间件处理之后，事件被处理完成之后,]
const [create, monut, unmonut] = useSubscribe(event, <select event type>)
create(Res.current, [])
// 等同于 Observer ，它正是 SubscribeMount 的简写
monut(Res.current, [])
unmonut(Res.current, [])
  • 新增next(bool)
const current = async (event, next) => {
  // 当前周期中进行
  next()
  // 下一个周期中进行
  next(true)
  // 下下个周期中进行
  next(true, true)
  // 以此类推
}