yuzuha 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +29 -1
- package/README.md +22 -14
- package/VERSIONING.md +56 -7
- package/benchmarks/parser.mjs +1 -1
- package/benchmarks/run.mjs +3 -2
- package/dist/canvas/card.d.ts +10 -0
- package/dist/canvas/card.d.ts.map +1 -0
- package/dist/canvas/card.js +11 -0
- package/dist/canvas/card.js.map +1 -0
- package/dist/canvas.d.ts +30 -9
- package/dist/canvas.d.ts.map +1 -1
- package/dist/canvas.js +64 -9
- package/dist/canvas.js.map +1 -1
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +2 -1
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/lint.d.ts.map +1 -1
- package/dist/cli/lint.js +1 -2
- package/dist/cli/lint.js.map +1 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +8 -9
- package/dist/cli/main.js.map +1 -1
- package/dist/cli/scaffold.js +1 -1
- package/dist/cli/scaffold.js.map +1 -1
- package/dist/cli/scenarios.d.ts.map +1 -1
- package/dist/cli/scenarios.js +2 -1
- package/dist/cli/scenarios.js.map +1 -1
- package/dist/commands/context.d.ts.map +1 -1
- package/dist/commands/context.js +7 -2
- package/dist/commands/context.js.map +1 -1
- package/dist/domain/resource-batches.d.ts +6 -0
- package/dist/domain/resource-batches.d.ts.map +1 -1
- package/dist/domain/resource-batches.js +31 -0
- package/dist/domain/resource-batches.js.map +1 -1
- package/dist/framework/bot.d.ts +9 -5
- package/dist/framework/bot.d.ts.map +1 -1
- package/dist/framework/bot.js +51 -27
- package/dist/framework/bot.js.map +1 -1
- package/dist/framework/command-registry.d.ts +8 -7
- package/dist/framework/command-registry.d.ts.map +1 -1
- package/dist/framework/command-registry.js +14 -11
- package/dist/framework/command-registry.js.map +1 -1
- package/dist/framework/options.d.ts +3 -3
- package/dist/framework/options.d.ts.map +1 -1
- package/dist/framework/options.js.map +1 -1
- package/dist/{scripting → functions}/builtins/arguments.d.ts.map +1 -1
- package/dist/{scripting → functions}/builtins/arguments.js.map +1 -1
- package/dist/functions/builtins/canvas.d.ts +2 -0
- package/dist/functions/builtins/canvas.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/canvas.js +1 -1
- package/dist/{scripting → functions}/builtins/canvas.js.map +1 -1
- package/dist/functions/builtins/context.d.ts +2 -0
- package/dist/functions/builtins/context.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/context.js.map +1 -1
- package/dist/{scripting → functions}/builtins/definition.d.ts +1 -1
- package/dist/functions/builtins/definition.d.ts.map +1 -0
- package/dist/functions/builtins/definition.js.map +1 -0
- package/dist/functions/builtins/embeds.d.ts +3 -0
- package/dist/{scripting → functions}/builtins/embeds.d.ts.map +1 -1
- package/dist/{scripting → functions}/builtins/embeds.js +1 -1
- package/dist/functions/builtins/embeds.js.map +1 -0
- package/dist/functions/builtins/events.d.ts +2 -0
- package/dist/functions/builtins/events.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/events.js.map +1 -1
- package/dist/functions/builtins/flow.d.ts +2 -0
- package/dist/functions/builtins/flow.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/flow.js +2 -2
- package/dist/functions/builtins/flow.js.map +1 -0
- package/dist/functions/builtins/guards.d.ts +2 -0
- package/dist/functions/builtins/guards.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/guards.js +1 -1
- package/dist/functions/builtins/guards.js.map +1 -0
- package/dist/functions/builtins/http.d.ts +2 -0
- package/dist/functions/builtins/http.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/http.js +2 -2
- package/dist/functions/builtins/http.js.map +1 -0
- package/dist/functions/builtins/index.d.ts +5 -0
- package/dist/functions/builtins/index.d.ts.map +1 -0
- package/dist/functions/builtins/index.js.map +1 -0
- package/dist/functions/builtins/language/array-callbacks.d.ts +2 -0
- package/dist/functions/builtins/language/array-callbacks.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/language/array-callbacks.js +1 -1
- package/dist/{scripting → functions}/builtins/language/array-callbacks.js.map +1 -1
- package/dist/functions/builtins/language/arrays.d.ts +2 -0
- package/dist/functions/builtins/language/arrays.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/language/arrays.js +1 -1
- package/dist/{scripting → functions}/builtins/language/arrays.js.map +1 -1
- package/dist/{scripting → functions}/builtins/language/common.d.ts.map +1 -1
- package/dist/{scripting → functions}/builtins/language/common.js.map +1 -1
- package/dist/functions/builtins/language/decimals.d.ts +2 -0
- package/dist/functions/builtins/language/decimals.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/language/decimals.js.map +1 -1
- package/dist/functions/builtins/language/index.d.ts +3 -0
- package/dist/functions/builtins/language/index.d.ts.map +1 -0
- package/dist/functions/builtins/language/index.js.map +1 -0
- package/dist/functions/builtins/language/loops.d.ts +4 -0
- package/dist/{scripting → functions}/builtins/language/loops.d.ts.map +1 -1
- package/dist/{scripting → functions}/builtins/language/loops.js +3 -3
- package/dist/{scripting → functions}/builtins/language/loops.js.map +1 -1
- package/dist/functions/builtins/language/numbers.d.ts +2 -0
- package/dist/functions/builtins/language/numbers.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/language/numbers.js.map +1 -1
- package/dist/{scripting → functions}/builtins/language/objects.d.ts +1 -1
- package/dist/{scripting → functions}/builtins/language/objects.d.ts.map +1 -1
- package/dist/{scripting → functions}/builtins/language/objects.js.map +1 -1
- package/dist/functions/builtins/language/regex.d.ts +2 -0
- package/dist/functions/builtins/language/regex.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/language/regex.js +1 -1
- package/dist/{scripting → functions}/builtins/language/regex.js.map +1 -1
- package/dist/functions/builtins/language/sort.d.ts +2 -0
- package/dist/functions/builtins/language/sort.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/language/sort.js.map +1 -1
- package/dist/{scripting → functions}/builtins/language/state.d.ts +1 -1
- package/dist/{scripting → functions}/builtins/language/state.d.ts.map +1 -1
- package/dist/{scripting → functions}/builtins/language/state.js.map +1 -1
- package/dist/functions/builtins/language/texts.d.ts +2 -0
- package/dist/functions/builtins/language/texts.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/language/texts.js.map +1 -1
- package/dist/functions/builtins/messages.d.ts +2 -0
- package/dist/functions/builtins/messages.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/messages.js.map +1 -1
- package/dist/functions/builtins/moderation.d.ts +2 -0
- package/dist/functions/builtins/moderation.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/moderation.js.map +1 -1
- package/dist/functions/builtins/native-channels.d.ts +2 -0
- package/dist/functions/builtins/native-channels.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/native-channels.js.map +1 -1
- package/dist/functions/builtins/native-collectors.d.ts +2 -0
- package/dist/functions/builtins/native-collectors.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/native-collectors.js.map +1 -1
- package/dist/functions/builtins/native-expressions.d.ts +2 -0
- package/dist/functions/builtins/native-expressions.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/native-expressions.js.map +1 -1
- package/dist/functions/builtins/native-invites.d.ts +2 -0
- package/dist/functions/builtins/native-invites.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/native-invites.js.map +1 -1
- package/dist/functions/builtins/native-messages.d.ts +2 -0
- package/dist/functions/builtins/native-messages.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/native-messages.js.map +1 -1
- package/dist/functions/builtins/native-roles.d.ts +2 -0
- package/dist/functions/builtins/native-roles.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/native-roles.js.map +1 -1
- package/dist/functions/builtins/native-threads.d.ts +2 -0
- package/dist/functions/builtins/native-threads.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/native-threads.js.map +1 -1
- package/dist/functions/builtins/native-users.d.ts +2 -0
- package/dist/functions/builtins/native-users.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/native-users.js.map +1 -1
- package/dist/functions/builtins/native-webhooks.d.ts +2 -0
- package/dist/functions/builtins/native-webhooks.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/native-webhooks.js.map +1 -1
- package/dist/{scripting → functions}/builtins/payload.d.ts +2 -2
- package/dist/functions/builtins/payload.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/payload.js +1 -1
- package/dist/functions/builtins/payload.js.map +1 -0
- package/dist/functions/builtins/resource-extras.d.ts +2 -0
- package/dist/functions/builtins/resource-extras.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/resource-extras.js.map +1 -1
- package/dist/functions/builtins/schedule.d.ts +2 -0
- package/dist/functions/builtins/schedule.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/schedule.js.map +1 -1
- package/dist/functions/builtins/storage.d.ts +2 -0
- package/dist/functions/builtins/storage.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/storage.js.map +1 -1
- package/dist/functions/builtins/values.d.ts +2 -0
- package/dist/functions/builtins/values.d.ts.map +1 -0
- package/dist/{scripting → functions}/builtins/values.js +1 -1
- package/dist/functions/builtins/values.js.map +1 -0
- package/dist/functions/runtime/ast.d.ts.map +1 -0
- package/dist/functions/runtime/ast.js.map +1 -0
- package/dist/{scripting → functions/runtime}/canvas-execution.d.ts +1 -1
- package/dist/functions/runtime/canvas-execution.d.ts.map +1 -0
- package/dist/functions/runtime/canvas-execution.js.map +1 -0
- package/dist/functions/runtime/control-flow.d.ts.map +1 -0
- package/dist/functions/runtime/control-flow.js.map +1 -0
- package/dist/{scripting → functions/runtime}/evaluator.d.ts +1 -1
- package/dist/functions/runtime/evaluator.d.ts.map +1 -0
- package/dist/{scripting → functions/runtime}/evaluator.js +1 -1
- package/dist/functions/runtime/evaluator.js.map +1 -0
- package/dist/functions/runtime/limits.d.ts.map +1 -0
- package/dist/{scripting → functions/runtime}/limits.js +1 -1
- package/dist/functions/runtime/limits.js.map +1 -0
- package/dist/functions/runtime/parser.d.ts.map +1 -0
- package/dist/{scripting → functions/runtime}/parser.js +1 -1
- package/dist/functions/runtime/parser.js.map +1 -0
- package/dist/functions/runtime/regex.d.ts.map +1 -0
- package/dist/{scripting → functions/runtime}/regex.js +1 -1
- package/dist/functions/runtime/regex.js.map +1 -0
- package/dist/functions/runtime/registry.d.ts.map +1 -0
- package/dist/{scripting → functions/runtime}/registry.js +1 -1
- package/dist/functions/runtime/registry.js.map +1 -0
- package/dist/{scripting → functions/runtime}/runtime.d.ts +3 -1
- package/dist/functions/runtime/runtime.d.ts.map +1 -0
- package/dist/{scripting → functions/runtime}/runtime.js +3 -0
- package/dist/functions/runtime/runtime.js.map +1 -0
- package/dist/{scripting → functions/runtime}/types.d.ts +1 -1
- package/dist/functions/runtime/types.d.ts.map +1 -0
- package/dist/functions/runtime/types.js.map +1 -0
- package/dist/functions/runtime/values.d.ts.map +1 -0
- package/dist/functions/runtime/values.js.map +1 -0
- package/dist/functions.d.ts +19 -8
- package/dist/functions.d.ts.map +1 -1
- package/dist/functions.js +18 -6
- package/dist/functions.js.map +1 -1
- package/dist/index.d.ts +7 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/infrastructure/canvas/napi.d.ts +4 -0
- package/dist/infrastructure/canvas/napi.d.ts.map +1 -0
- package/dist/infrastructure/canvas/napi.js +17 -0
- package/dist/infrastructure/canvas/napi.js.map +1 -0
- package/dist/infrastructure/fluxer/resources/cache.d.ts +4 -0
- package/dist/infrastructure/fluxer/resources/cache.d.ts.map +1 -0
- package/dist/infrastructure/fluxer/resources/cache.js +68 -0
- package/dist/infrastructure/fluxer/resources/cache.js.map +1 -0
- package/dist/infrastructure/fluxer/resources/channels.d.ts +3 -2
- package/dist/infrastructure/fluxer/resources/channels.d.ts.map +1 -1
- package/dist/infrastructure/fluxer/resources/channels.js +54 -2
- package/dist/infrastructure/fluxer/resources/channels.js.map +1 -1
- package/dist/infrastructure/fluxer/resources/collectors.d.ts.map +1 -1
- package/dist/infrastructure/fluxer/resources/collectors.js +86 -4
- package/dist/infrastructure/fluxer/resources/collectors.js.map +1 -1
- package/dist/infrastructure/fluxer/resources/expressions.d.ts.map +1 -1
- package/dist/infrastructure/fluxer/resources/expressions.js +8 -1
- package/dist/infrastructure/fluxer/resources/expressions.js.map +1 -1
- package/dist/infrastructure/fluxer/resources/gateway.d.ts +4 -0
- package/dist/infrastructure/fluxer/resources/gateway.d.ts.map +1 -0
- package/dist/infrastructure/fluxer/resources/gateway.js +31 -0
- package/dist/infrastructure/fluxer/resources/gateway.js.map +1 -0
- package/dist/infrastructure/fluxer/resources/instance.d.ts +4 -0
- package/dist/infrastructure/fluxer/resources/instance.d.ts.map +1 -0
- package/dist/infrastructure/fluxer/resources/instance.js +96 -0
- package/dist/infrastructure/fluxer/resources/instance.js.map +1 -0
- package/dist/infrastructure/fluxer/resources/messages.d.ts +3 -1
- package/dist/infrastructure/fluxer/resources/messages.d.ts.map +1 -1
- package/dist/infrastructure/fluxer/resources/messages.js +91 -36
- package/dist/infrastructure/fluxer/resources/messages.js.map +1 -1
- package/dist/infrastructure/fluxer/resources/roles.d.ts.map +1 -1
- package/dist/infrastructure/fluxer/resources/roles.js +8 -0
- package/dist/infrastructure/fluxer/resources/roles.js.map +1 -1
- package/dist/infrastructure/fluxer/resources/self.d.ts +4 -0
- package/dist/infrastructure/fluxer/resources/self.d.ts.map +1 -0
- package/dist/infrastructure/fluxer/resources/self.js +36 -0
- package/dist/infrastructure/fluxer/resources/self.js.map +1 -0
- package/dist/infrastructure/fluxer/resources/threads.d.ts.map +1 -1
- package/dist/infrastructure/fluxer/resources/threads.js +15 -0
- package/dist/infrastructure/fluxer/resources/threads.js.map +1 -1
- package/dist/infrastructure/fluxer/resources/users.d.ts +5 -2
- package/dist/infrastructure/fluxer/resources/users.d.ts.map +1 -1
- package/dist/infrastructure/fluxer/resources/users.js +36 -3
- package/dist/infrastructure/fluxer/resources/users.js.map +1 -1
- package/dist/infrastructure/fluxer/resources/webhooks.d.ts.map +1 -1
- package/dist/infrastructure/fluxer/resources/webhooks.js +9 -0
- package/dist/infrastructure/fluxer/resources/webhooks.js.map +1 -1
- package/dist/infrastructure/fluxer/resources.d.ts +4 -0
- package/dist/infrastructure/fluxer/resources.d.ts.map +1 -1
- package/dist/infrastructure/fluxer/resources.js +12 -0
- package/dist/infrastructure/fluxer/resources.js.map +1 -1
- package/dist/ports/resources/cache.d.ts +74 -0
- package/dist/ports/resources/cache.d.ts.map +1 -0
- package/dist/ports/resources/cache.js +2 -0
- package/dist/ports/resources/cache.js.map +1 -0
- package/dist/ports/resources/channels.d.ts +17 -0
- package/dist/ports/resources/channels.d.ts.map +1 -1
- package/dist/ports/resources/channels.js.map +1 -1
- package/dist/ports/resources/collectors.d.ts +18 -0
- package/dist/ports/resources/collectors.d.ts.map +1 -1
- package/dist/ports/resources/collectors.js.map +1 -1
- package/dist/ports/resources/common.d.ts +2 -0
- package/dist/ports/resources/common.d.ts.map +1 -1
- package/dist/ports/resources/common.js.map +1 -1
- package/dist/ports/resources/expressions.d.ts +8 -0
- package/dist/ports/resources/expressions.d.ts.map +1 -1
- package/dist/ports/resources/expressions.js.map +1 -1
- package/dist/ports/resources/gateway.d.ts +48 -0
- package/dist/ports/resources/gateway.d.ts.map +1 -0
- package/dist/ports/resources/gateway.js +2 -0
- package/dist/ports/resources/gateway.js.map +1 -0
- package/dist/ports/resources/instance.d.ts +101 -0
- package/dist/ports/resources/instance.d.ts.map +1 -0
- package/dist/ports/resources/instance.js +2 -0
- package/dist/ports/resources/instance.js.map +1 -0
- package/dist/ports/resources/messages.d.ts +27 -0
- package/dist/ports/resources/messages.d.ts.map +1 -1
- package/dist/ports/resources/messages.js.map +1 -1
- package/dist/ports/resources/roles.d.ts +6 -0
- package/dist/ports/resources/roles.d.ts.map +1 -1
- package/dist/ports/resources/roles.js.map +1 -1
- package/dist/ports/resources/self.d.ts +30 -0
- package/dist/ports/resources/self.d.ts.map +1 -0
- package/dist/ports/resources/self.js +2 -0
- package/dist/ports/resources/self.js.map +1 -0
- package/dist/ports/resources/threads.d.ts +16 -0
- package/dist/ports/resources/threads.d.ts.map +1 -1
- package/dist/ports/resources/threads.js.map +1 -1
- package/dist/ports/resources/users.d.ts +30 -0
- package/dist/ports/resources/users.d.ts.map +1 -1
- package/dist/ports/resources/users.js.map +1 -1
- package/dist/ports/resources/webhooks.d.ts +5 -0
- package/dist/ports/resources/webhooks.d.ts.map +1 -1
- package/dist/ports/resources/webhooks.js.map +1 -1
- package/dist/ports/resources.d.ts +8 -0
- package/dist/ports/resources.d.ts.map +1 -1
- package/dist/ports/resources.js.map +1 -1
- package/dist/ports/script-engine.d.ts +45 -0
- package/dist/ports/script-engine.d.ts.map +1 -0
- package/dist/ports/script-engine.js +2 -0
- package/dist/ports/script-engine.js.map +1 -0
- package/dist/sdk/builders.d.ts +2 -0
- package/dist/sdk/builders.d.ts.map +1 -0
- package/dist/sdk/builders.js +2 -0
- package/dist/sdk/builders.js.map +1 -0
- package/dist/sdk/client.d.ts +2 -0
- package/dist/sdk/client.d.ts.map +1 -0
- package/dist/sdk/client.js +2 -0
- package/dist/sdk/client.js.map +1 -0
- package/dist/sdk/cluster.d.ts +2 -0
- package/dist/sdk/cluster.d.ts.map +1 -0
- package/dist/sdk/cluster.js +2 -0
- package/dist/sdk/cluster.js.map +1 -0
- package/dist/sdk/collection.d.ts +2 -0
- package/dist/sdk/collection.d.ts.map +1 -0
- package/dist/sdk/collection.js +2 -0
- package/dist/sdk/collection.js.map +1 -0
- package/dist/sdk/errors.d.ts +2 -0
- package/dist/sdk/errors.d.ts.map +1 -0
- package/dist/sdk/errors.js +2 -0
- package/dist/sdk/errors.js.map +1 -0
- package/dist/sdk/internal.d.ts +2 -0
- package/dist/sdk/internal.d.ts.map +1 -0
- package/dist/sdk/internal.js +2 -0
- package/dist/sdk/internal.js.map +1 -0
- package/dist/sdk/message.d.ts +2 -0
- package/dist/sdk/message.d.ts.map +1 -0
- package/dist/sdk/message.js +2 -0
- package/dist/sdk/message.js.map +1 -0
- package/dist/sdk/rest/request-manager.d.ts +2 -0
- package/dist/sdk/rest/request-manager.d.ts.map +1 -0
- package/dist/sdk/rest/request-manager.js +2 -0
- package/dist/sdk/rest/request-manager.js.map +1 -0
- package/dist/sdk/rest.d.ts +2 -0
- package/dist/sdk/rest.d.ts.map +1 -0
- package/dist/sdk/rest.js +2 -0
- package/dist/sdk/rest.js.map +1 -0
- package/dist/sdk/sharding.d.ts +2 -0
- package/dist/sdk/sharding.d.ts.map +1 -0
- package/dist/sdk/sharding.js +2 -0
- package/dist/sdk/sharding.js.map +1 -0
- package/dist/sdk/types/routes.d.ts +2 -0
- package/dist/sdk/types/routes.d.ts.map +1 -0
- package/dist/sdk/types/routes.js +2 -0
- package/dist/sdk/types/routes.js.map +1 -0
- package/dist/sdk/types.d.ts +2 -0
- package/dist/sdk/types.d.ts.map +1 -0
- package/dist/sdk/types.js +2 -0
- package/dist/sdk/types.js.map +1 -0
- package/dist/sdk/util.d.ts +2 -0
- package/dist/sdk/util.d.ts.map +1 -0
- package/dist/sdk/util.js +2 -0
- package/dist/sdk/util.js.map +1 -0
- package/dist/sdk/voice.d.ts +2 -0
- package/dist/sdk/voice.d.ts.map +1 -0
- package/dist/sdk/voice.js +2 -0
- package/dist/sdk/voice.js.map +1 -0
- package/dist/sdk/ws.d.ts +2 -0
- package/dist/sdk/ws.d.ts.map +1 -0
- package/dist/sdk/ws.js +2 -0
- package/dist/sdk/ws.js.map +1 -0
- package/dist/services/canvas-image.d.ts +12 -0
- package/dist/services/canvas-image.d.ts.map +1 -0
- package/dist/services/canvas-image.js +56 -0
- package/dist/services/canvas-image.js.map +1 -0
- package/dist/services/canvas.d.ts +12 -2
- package/dist/services/canvas.d.ts.map +1 -1
- package/dist/services/canvas.js +91 -5
- package/dist/services/canvas.js.map +1 -1
- package/dist/services/moderation.d.ts +1 -0
- package/dist/services/moderation.d.ts.map +1 -1
- package/dist/services/moderation.js +11 -0
- package/dist/services/moderation.js.map +1 -1
- package/dist/services/native-moderation.d.ts +6 -1
- package/dist/services/native-moderation.d.ts.map +1 -1
- package/dist/services/native-moderation.js +11 -1
- package/dist/services/native-moderation.js.map +1 -1
- package/dist/services/resource-authorization.d.ts.map +1 -1
- package/dist/services/resource-authorization.js +95 -3
- package/dist/services/resource-authorization.js.map +1 -1
- package/dist/testing.d.ts.map +1 -1
- package/dist/testing.js +4 -0
- package/dist/testing.js.map +1 -1
- package/docs/API.md +8 -7
- package/docs/ARCHITECTURE.md +14 -9
- package/docs/BENCHMARKS.md +1 -1
- package/docs/CANVAS.md +70 -15
- package/docs/EDITOR.md +1 -1
- package/docs/FRAMEWORK.md +2 -3
- package/docs/HTTP.md +1 -1
- package/docs/IMAGES.md +2 -1
- package/docs/NATIVE.md +45 -14
- package/docs/PARITY-MATRIX.md +853 -843
- package/docs/PARITY.md +24 -12
- package/docs/PLAN.md +14 -3
- package/docs/QUICKSTART.md +5 -5
- package/docs/README.md +7 -7
- package/docs/REPOSITORY.md +1 -1
- package/docs/SCHEDULER.md +1 -1
- package/docs/TROUBLESHOOTING.md +1 -1
- package/docs/VALIDATION.md +5 -5
- package/docs/{FUNCTION-GAPS.md → functions/FUNCTION-GAPS.md} +18 -13
- package/docs/{LANGUAGE.md → functions/LANGUAGE.md} +7 -7
- package/docs/functions/README.md +33 -0
- package/docs/tutorials/DATA.md +2 -2
- package/docs/tutorials/FUNCTION-MODE.md +2 -2
- package/examples/canvas/napi-style.ts +24 -0
- package/examples/canvas/output/napi-style.png +0 -0
- package/examples/canvas/profile.d.mts +1 -1
- package/examples/canvas/profile.mjs +2 -2
- package/examples/canvas/profile.ts +3 -3
- package/examples/canvas/ranking.d.mts +1 -1
- package/examples/canvas/ranking.mjs +2 -2
- package/examples/canvas/ranking.ts +3 -3
- package/examples/canvas/render.ts +2 -1
- package/examples/canvas/welcome.d.mts +1 -1
- package/examples/canvas/welcome.mjs +2 -2
- package/examples/canvas/welcome.ts +3 -3
- package/examples/embeds/complete-embed-functions.ts +2 -2
- package/examples/function-mode.ts +3 -3
- package/examples/yuzuha.config.js +2 -0
- package/package.json +26 -1
- package/src/canvas/card.ts +20 -0
- package/src/canvas.ts +69 -17
- package/src/cli/config.ts +2 -1
- package/src/cli/lint.ts +1 -2
- package/src/cli/main.ts +8 -9
- package/src/cli/scaffold.ts +1 -1
- package/src/cli/scenarios.ts +2 -1
- package/src/commands/context.ts +9 -2
- package/src/domain/resource-batches.ts +31 -0
- package/src/framework/bot.ts +44 -27
- package/src/framework/command-registry.ts +15 -10
- package/src/framework/options.ts +3 -3
- package/src/{scripting → functions}/builtins/canvas.ts +2 -2
- package/src/{scripting → functions}/builtins/context.ts +1 -1
- package/src/{scripting → functions}/builtins/definition.ts +1 -1
- package/src/{scripting → functions}/builtins/embeds.ts +1 -1
- package/src/{scripting → functions}/builtins/flow.ts +2 -2
- package/src/{scripting → functions}/builtins/guards.ts +1 -1
- package/src/{scripting → functions}/builtins/http.ts +2 -2
- package/src/{scripting → functions}/builtins/index.ts +2 -2
- package/src/{scripting → functions}/builtins/language/array-callbacks.ts +2 -2
- package/src/{scripting → functions}/builtins/language/arrays.ts +1 -1
- package/src/{scripting → functions}/builtins/language/index.ts +1 -1
- package/src/{scripting → functions}/builtins/language/loops.ts +4 -4
- package/src/{scripting → functions}/builtins/language/regex.ts +1 -1
- package/src/{scripting → functions}/builtins/moderation.ts +1 -1
- package/src/{scripting → functions}/builtins/native-channels.ts +1 -1
- package/src/{scripting → functions}/builtins/native-roles.ts +1 -1
- package/src/{scripting → functions}/builtins/native-users.ts +1 -1
- package/src/{scripting → functions}/builtins/payload.ts +2 -2
- package/src/{scripting → functions}/builtins/resource-extras.ts +1 -1
- package/src/{scripting → functions}/builtins/values.ts +1 -1
- package/src/{scripting → functions/runtime}/canvas-execution.ts +1 -1
- package/src/{scripting → functions/runtime}/evaluator.ts +2 -2
- package/src/{scripting → functions/runtime}/limits.ts +1 -1
- package/src/{scripting → functions/runtime}/parser.ts +1 -1
- package/src/{scripting → functions/runtime}/regex.ts +1 -1
- package/src/{scripting → functions/runtime}/registry.ts +1 -1
- package/src/{scripting → functions/runtime}/runtime.ts +6 -1
- package/src/{scripting → functions/runtime}/types.ts +1 -1
- package/src/functions.ts +28 -8
- package/src/index.ts +9 -2
- package/src/infrastructure/canvas/napi.ts +17 -0
- package/src/infrastructure/fluxer/resources/cache.ts +69 -0
- package/src/infrastructure/fluxer/resources/channels.ts +51 -3
- package/src/infrastructure/fluxer/resources/collectors.ts +87 -4
- package/src/infrastructure/fluxer/resources/expressions.ts +7 -1
- package/src/infrastructure/fluxer/resources/gateway.ts +33 -0
- package/src/infrastructure/fluxer/resources/instance.ts +105 -0
- package/src/infrastructure/fluxer/resources/messages.ts +84 -36
- package/src/infrastructure/fluxer/resources/roles.ts +8 -0
- package/src/infrastructure/fluxer/resources/self.ts +39 -0
- package/src/infrastructure/fluxer/resources/threads.ts +14 -0
- package/src/infrastructure/fluxer/resources/users.ts +40 -4
- package/src/infrastructure/fluxer/resources/webhooks.ts +9 -0
- package/src/infrastructure/fluxer/resources.ts +12 -0
- package/src/ports/resources/cache.ts +81 -0
- package/src/ports/resources/channels.ts +12 -0
- package/src/ports/resources/collectors.ts +20 -0
- package/src/ports/resources/common.ts +2 -0
- package/src/ports/resources/expressions.ts +6 -0
- package/src/ports/resources/gateway.ts +49 -0
- package/src/ports/resources/instance.ts +109 -0
- package/src/ports/resources/messages.ts +30 -0
- package/src/ports/resources/roles.ts +3 -0
- package/src/ports/resources/self.ts +30 -0
- package/src/ports/resources/threads.ts +15 -0
- package/src/ports/resources/users.ts +33 -0
- package/src/ports/resources/webhooks.ts +6 -0
- package/src/ports/resources.ts +8 -0
- package/src/ports/script-engine.ts +42 -0
- package/src/sdk/builders.ts +1 -0
- package/src/sdk/client.ts +1 -0
- package/src/sdk/cluster.ts +1 -0
- package/src/sdk/collection.ts +1 -0
- package/src/sdk/errors.ts +1 -0
- package/src/sdk/internal.ts +1 -0
- package/src/sdk/message.ts +1 -0
- package/src/sdk/rest/request-manager.ts +1 -0
- package/src/sdk/rest.ts +1 -0
- package/src/sdk/sharding.ts +1 -0
- package/src/sdk/types/routes.ts +1 -0
- package/src/sdk/types.ts +1 -0
- package/src/sdk/util.ts +1 -0
- package/src/sdk/voice.ts +1 -0
- package/src/sdk/ws.ts +1 -0
- package/src/services/canvas-image.ts +54 -0
- package/src/services/canvas.ts +89 -6
- package/src/services/moderation.ts +4 -0
- package/src/services/native-moderation.ts +11 -1
- package/src/services/resource-authorization.ts +89 -3
- package/src/testing.ts +4 -0
- package/dist/parser.d.ts +0 -3
- package/dist/parser.d.ts.map +0 -1
- package/dist/parser.js +0 -2
- package/dist/parser.js.map +0 -1
- package/dist/runtime.d.ts +0 -5
- package/dist/runtime.d.ts.map +0 -1
- package/dist/runtime.js +0 -4
- package/dist/runtime.js.map +0 -1
- package/dist/scripting/ast.d.ts.map +0 -1
- package/dist/scripting/ast.js.map +0 -1
- package/dist/scripting/builtins/canvas.d.ts +0 -2
- package/dist/scripting/builtins/canvas.d.ts.map +0 -1
- package/dist/scripting/builtins/context.d.ts +0 -2
- package/dist/scripting/builtins/context.d.ts.map +0 -1
- package/dist/scripting/builtins/definition.d.ts.map +0 -1
- package/dist/scripting/builtins/definition.js.map +0 -1
- package/dist/scripting/builtins/embeds.d.ts +0 -3
- package/dist/scripting/builtins/embeds.js.map +0 -1
- package/dist/scripting/builtins/events.d.ts +0 -2
- package/dist/scripting/builtins/events.d.ts.map +0 -1
- package/dist/scripting/builtins/flow.d.ts +0 -2
- package/dist/scripting/builtins/flow.d.ts.map +0 -1
- package/dist/scripting/builtins/flow.js.map +0 -1
- package/dist/scripting/builtins/guards.d.ts +0 -2
- package/dist/scripting/builtins/guards.d.ts.map +0 -1
- package/dist/scripting/builtins/guards.js.map +0 -1
- package/dist/scripting/builtins/http.d.ts +0 -2
- package/dist/scripting/builtins/http.d.ts.map +0 -1
- package/dist/scripting/builtins/http.js.map +0 -1
- package/dist/scripting/builtins/index.d.ts +0 -5
- package/dist/scripting/builtins/index.d.ts.map +0 -1
- package/dist/scripting/builtins/index.js.map +0 -1
- package/dist/scripting/builtins/language/array-callbacks.d.ts +0 -2
- package/dist/scripting/builtins/language/array-callbacks.d.ts.map +0 -1
- package/dist/scripting/builtins/language/arrays.d.ts +0 -2
- package/dist/scripting/builtins/language/arrays.d.ts.map +0 -1
- package/dist/scripting/builtins/language/decimals.d.ts +0 -2
- package/dist/scripting/builtins/language/decimals.d.ts.map +0 -1
- package/dist/scripting/builtins/language/index.d.ts +0 -3
- package/dist/scripting/builtins/language/index.d.ts.map +0 -1
- package/dist/scripting/builtins/language/index.js.map +0 -1
- package/dist/scripting/builtins/language/loops.d.ts +0 -4
- package/dist/scripting/builtins/language/numbers.d.ts +0 -2
- package/dist/scripting/builtins/language/numbers.d.ts.map +0 -1
- package/dist/scripting/builtins/language/regex.d.ts +0 -2
- package/dist/scripting/builtins/language/regex.d.ts.map +0 -1
- package/dist/scripting/builtins/language/sort.d.ts +0 -2
- package/dist/scripting/builtins/language/sort.d.ts.map +0 -1
- package/dist/scripting/builtins/language/texts.d.ts +0 -2
- package/dist/scripting/builtins/language/texts.d.ts.map +0 -1
- package/dist/scripting/builtins/messages.d.ts +0 -2
- package/dist/scripting/builtins/messages.d.ts.map +0 -1
- package/dist/scripting/builtins/moderation.d.ts +0 -2
- package/dist/scripting/builtins/moderation.d.ts.map +0 -1
- package/dist/scripting/builtins/native-channels.d.ts +0 -2
- package/dist/scripting/builtins/native-channels.d.ts.map +0 -1
- package/dist/scripting/builtins/native-collectors.d.ts +0 -2
- package/dist/scripting/builtins/native-collectors.d.ts.map +0 -1
- package/dist/scripting/builtins/native-expressions.d.ts +0 -2
- package/dist/scripting/builtins/native-expressions.d.ts.map +0 -1
- package/dist/scripting/builtins/native-invites.d.ts +0 -2
- package/dist/scripting/builtins/native-invites.d.ts.map +0 -1
- package/dist/scripting/builtins/native-messages.d.ts +0 -2
- package/dist/scripting/builtins/native-messages.d.ts.map +0 -1
- package/dist/scripting/builtins/native-roles.d.ts +0 -2
- package/dist/scripting/builtins/native-roles.d.ts.map +0 -1
- package/dist/scripting/builtins/native-threads.d.ts +0 -2
- package/dist/scripting/builtins/native-threads.d.ts.map +0 -1
- package/dist/scripting/builtins/native-users.d.ts +0 -2
- package/dist/scripting/builtins/native-users.d.ts.map +0 -1
- package/dist/scripting/builtins/native-webhooks.d.ts +0 -2
- package/dist/scripting/builtins/native-webhooks.d.ts.map +0 -1
- package/dist/scripting/builtins/payload.d.ts.map +0 -1
- package/dist/scripting/builtins/payload.js.map +0 -1
- package/dist/scripting/builtins/resource-extras.d.ts +0 -2
- package/dist/scripting/builtins/resource-extras.d.ts.map +0 -1
- package/dist/scripting/builtins/schedule.d.ts +0 -2
- package/dist/scripting/builtins/schedule.d.ts.map +0 -1
- package/dist/scripting/builtins/storage.d.ts +0 -2
- package/dist/scripting/builtins/storage.d.ts.map +0 -1
- package/dist/scripting/builtins/values.d.ts +0 -2
- package/dist/scripting/builtins/values.d.ts.map +0 -1
- package/dist/scripting/builtins/values.js.map +0 -1
- package/dist/scripting/canvas-execution.d.ts.map +0 -1
- package/dist/scripting/canvas-execution.js.map +0 -1
- package/dist/scripting/control-flow.d.ts.map +0 -1
- package/dist/scripting/control-flow.js.map +0 -1
- package/dist/scripting/evaluator.d.ts.map +0 -1
- package/dist/scripting/evaluator.js.map +0 -1
- package/dist/scripting/limits.d.ts.map +0 -1
- package/dist/scripting/limits.js.map +0 -1
- package/dist/scripting/parser.d.ts.map +0 -1
- package/dist/scripting/parser.js.map +0 -1
- package/dist/scripting/regex.d.ts.map +0 -1
- package/dist/scripting/regex.js.map +0 -1
- package/dist/scripting/registry.d.ts.map +0 -1
- package/dist/scripting/registry.js.map +0 -1
- package/dist/scripting/runtime.d.ts.map +0 -1
- package/dist/scripting/runtime.js.map +0 -1
- package/dist/scripting/types.d.ts.map +0 -1
- package/dist/scripting/types.js.map +0 -1
- package/dist/scripting/values.d.ts.map +0 -1
- package/dist/scripting/values.js.map +0 -1
- package/src/parser.ts +0 -2
- package/src/runtime.ts +0 -4
- /package/dist/{scripting → functions}/builtins/arguments.d.ts +0 -0
- /package/dist/{scripting → functions}/builtins/arguments.js +0 -0
- /package/dist/{scripting → functions}/builtins/context.js +0 -0
- /package/dist/{scripting → functions}/builtins/definition.js +0 -0
- /package/dist/{scripting → functions}/builtins/events.js +0 -0
- /package/dist/{scripting → functions}/builtins/index.js +0 -0
- /package/dist/{scripting → functions}/builtins/language/common.d.ts +0 -0
- /package/dist/{scripting → functions}/builtins/language/common.js +0 -0
- /package/dist/{scripting → functions}/builtins/language/decimals.js +0 -0
- /package/dist/{scripting → functions}/builtins/language/index.js +0 -0
- /package/dist/{scripting → functions}/builtins/language/numbers.js +0 -0
- /package/dist/{scripting → functions}/builtins/language/objects.js +0 -0
- /package/dist/{scripting → functions}/builtins/language/sort.js +0 -0
- /package/dist/{scripting → functions}/builtins/language/state.js +0 -0
- /package/dist/{scripting → functions}/builtins/language/texts.js +0 -0
- /package/dist/{scripting → functions}/builtins/messages.js +0 -0
- /package/dist/{scripting → functions}/builtins/moderation.js +0 -0
- /package/dist/{scripting → functions}/builtins/native-channels.js +0 -0
- /package/dist/{scripting → functions}/builtins/native-collectors.js +0 -0
- /package/dist/{scripting → functions}/builtins/native-expressions.js +0 -0
- /package/dist/{scripting → functions}/builtins/native-invites.js +0 -0
- /package/dist/{scripting → functions}/builtins/native-messages.js +0 -0
- /package/dist/{scripting → functions}/builtins/native-roles.js +0 -0
- /package/dist/{scripting → functions}/builtins/native-threads.js +0 -0
- /package/dist/{scripting → functions}/builtins/native-users.js +0 -0
- /package/dist/{scripting → functions}/builtins/native-webhooks.js +0 -0
- /package/dist/{scripting → functions}/builtins/resource-extras.js +0 -0
- /package/dist/{scripting → functions}/builtins/schedule.js +0 -0
- /package/dist/{scripting → functions}/builtins/storage.js +0 -0
- /package/dist/{scripting → functions/runtime}/ast.d.ts +0 -0
- /package/dist/{scripting → functions/runtime}/ast.js +0 -0
- /package/dist/{scripting → functions/runtime}/canvas-execution.js +0 -0
- /package/dist/{scripting → functions/runtime}/control-flow.d.ts +0 -0
- /package/dist/{scripting → functions/runtime}/control-flow.js +0 -0
- /package/dist/{scripting → functions/runtime}/limits.d.ts +0 -0
- /package/dist/{scripting → functions/runtime}/parser.d.ts +0 -0
- /package/dist/{scripting → functions/runtime}/regex-worker.mjs +0 -0
- /package/dist/{scripting → functions/runtime}/regex.d.ts +0 -0
- /package/dist/{scripting → functions/runtime}/registry.d.ts +0 -0
- /package/dist/{scripting → functions/runtime}/types.js +0 -0
- /package/dist/{scripting → functions/runtime}/values.d.ts +0 -0
- /package/dist/{scripting → functions/runtime}/values.js +0 -0
- /package/docs/{FUNCTIONS.md → functions/FUNCTIONS.md} +0 -0
- /package/docs/{LANGUAGE-EXTENSIONS.md → functions/LANGUAGE-EXTENSIONS.md} +0 -0
- /package/src/{scripting → functions}/builtins/arguments.ts +0 -0
- /package/src/{scripting → functions}/builtins/events.ts +0 -0
- /package/src/{scripting → functions}/builtins/language/common.ts +0 -0
- /package/src/{scripting → functions}/builtins/language/decimals.ts +0 -0
- /package/src/{scripting → functions}/builtins/language/numbers.ts +0 -0
- /package/src/{scripting → functions}/builtins/language/objects.ts +0 -0
- /package/src/{scripting → functions}/builtins/language/sort.ts +0 -0
- /package/src/{scripting → functions}/builtins/language/state.ts +0 -0
- /package/src/{scripting → functions}/builtins/language/texts.ts +0 -0
- /package/src/{scripting → functions}/builtins/messages.ts +0 -0
- /package/src/{scripting → functions}/builtins/native-collectors.ts +0 -0
- /package/src/{scripting → functions}/builtins/native-expressions.ts +0 -0
- /package/src/{scripting → functions}/builtins/native-invites.ts +0 -0
- /package/src/{scripting → functions}/builtins/native-messages.ts +0 -0
- /package/src/{scripting → functions}/builtins/native-threads.ts +0 -0
- /package/src/{scripting → functions}/builtins/native-webhooks.ts +0 -0
- /package/src/{scripting → functions}/builtins/schedule.ts +0 -0
- /package/src/{scripting → functions}/builtins/storage.ts +0 -0
- /package/src/{scripting → functions/runtime}/ast.ts +0 -0
- /package/src/{scripting → functions/runtime}/control-flow.ts +0 -0
- /package/src/{scripting → functions/runtime}/regex-worker.mjs +0 -0
- /package/src/{scripting → functions/runtime}/values.ts +0 -0
package/docs/PARITY.md
CHANGED
|
@@ -17,39 +17,51 @@ públicos da raiz do pacote e seus tipos. `bot.client` é uma instância real de
|
|
|
17
17
|
`Client`; `SDK` na raiz do Yuzuha é um namespace do mesmo pacote. O acesso nativo
|
|
18
18
|
não é uma reprodução parcial do client.
|
|
19
19
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
20
|
+
Os subpaths do pacote e os pacotes satélites do monorepo também são espelhados:
|
|
21
|
+
`yuzuha/sdk/client`, `yuzuha/sdk/errors`, `yuzuha/sdk/message`,
|
|
22
|
+
`yuzuha/sdk/cluster` e `yuzuha/sdk/internal` equivalem a `@fluxerjs/core/*`;
|
|
23
|
+
`yuzuha/sdk/types`, `yuzuha/sdk/types/routes`, `yuzuha/sdk/rest`,
|
|
24
|
+
`yuzuha/sdk/rest/request-manager`, `yuzuha/sdk/ws`, `yuzuha/sdk/builders`,
|
|
25
|
+
`yuzuha/sdk/collection` e `yuzuha/sdk/util` reexportam os pacotes homônimos, que
|
|
26
|
+
passam a ser dependências diretas do Yuzuha. `yuzuha/sdk/voice` e
|
|
27
|
+
`yuzuha/sdk/sharding` reexportam os pacotes opcionais homônimos, exigindo o peer
|
|
28
|
+
instalado. O teste de consumidor compara os exports de cada subpath `yuzuha/sdk*`
|
|
29
|
+
aos do pacote correspondente instalado.
|
|
30
|
+
|
|
31
|
+
Isso não significa que cada método tem uma função `$...`. `@fluxerjs/sharding`
|
|
32
|
+
declara peer em `@fluxerjs/core` 3.0.0 exato; consumidores que o instalarem
|
|
33
|
+
precisam de `overrides` para o core fixado, como no manifesto do Yuzuha.
|
|
23
34
|
|
|
24
35
|
| Área | JS/TS pelo client/SDK | Function mode |
|
|
25
36
|
|---|---|---|
|
|
26
|
-
| Gateway, conexão, heartbeat e reconexão | Herdado do SDK | Via inicialização do bot |
|
|
37
|
+
| Gateway, conexão, heartbeat e reconexão | Herdado do SDK; pedidos brutos por `ctx.resources.gateway` (membros, contagens, não lidos de fórum, assinatura de threads, envio por shard) | Via inicialização do bot |
|
|
27
38
|
| Eventos | `bot.on/once/off`, `bot.event`, `bot.scriptEvent` e `bot.client.on` | Eventos de membros, edição/exclusão de mensagens e reações, com contexto próprio |
|
|
28
39
|
| Mensagens e replies | API completa do SDK | reply, sendMessage, editMessage, deleteMessage, fetchMessage, messages com cursores, pin/unpin, pinnedMessagesPage, dm, forward, searchMessages, searchMessagesAdvanced e preloadMessages |
|
|
29
|
-
| Reações e collectors | API do SDK | react, removeReaction, clearReactions, reactionUsers e reactionUsersPage com metadados de paginação, awaitMessage, awaitReaction, confirm |
|
|
40
|
+
| Reações e collectors | API do SDK; streams `collectMessages`/`collectReactions` como `AsyncIterable` | react, removeReaction, clearReactions, reactionUsers e reactionUsersPage com metadados de paginação, awaitMessage, awaitReaction, confirm |
|
|
30
41
|
| Embeds e anexos | Builders do SDK, sendBytes e sendAttachments | Embeds completos (autor, link, data, campos, alt text e rodapé com ícone), até 10 embeds, opções de envio com autorização, anexos URL/base64 e múltiplos anexos; leitura normalizada em `$fetchMessage` |
|
|
31
42
|
| Membros, cargos, canais e permissões | API do SDK e `ctx.members` | User/member, perfil completo, contagens ao vivo, nickname, roles, canais de link, avisos, posição, categorias e overwrites |
|
|
32
43
|
| Ban, kick, timeout, unban e moderação de voz | SDK + `ctx.mod` e `ctx.moderate` | Versões simples e mod* com casos, incluindo move/mute/deafen |
|
|
33
44
|
| Servidor, convites, webhooks e expressões | API do SDK e auxiliares autorizados | guildFeatures, leaveGuild, editGuild, convites/vanity, clonagem e mutações de emojis/stickers, createEmojisBulk; CRUD e envio de webhooks |
|
|
34
45
|
| Threads e fóruns | API do SDK | Criação, edição, busca, posts, membros, threadMember e listagens ativas/arquivadas com paginação |
|
|
35
46
|
| Presença | `client.user.setPresence` | setPresence, setStatus e setActivity |
|
|
36
|
-
| Cache e presença |
|
|
37
|
-
|
|
|
47
|
+
| Cache e presença | `ctx.resources.cache` (estatísticas, limites e limpezas) e opções do SDK | Acesso nativo |
|
|
48
|
+
| Usuário autenticado | `ctx.resources.self` (fetch, guilds, saída e limpeza com verificação sudo) | setPresence, setStatus, setActivity e leaveGuild |
|
|
49
|
+
| Instância e aplicação | `ctx.resources.instance` (describe, gatewayInfo, application, oauthApplications, metadados de emoji/sticker, resolveEmoji); `Client.fromDiscovery`, client injetado | Mesmo adaptador do client |
|
|
38
50
|
| Áudio em voz | `FluxerVoice` sobre `@fluxerjs/voice` opcional; Lavalink v4 com plugin de áudio, `FluxerLavalinkBridge`, filas editáveis e recuperação em `yuzuha/music` | Sem wrappers de reprodução; moderação de membros usa o SDK core |
|
|
39
|
-
| Sharding |
|
|
40
|
-
| Cluster/subpaths |
|
|
51
|
+
| Sharding | `yuzuha/sdk/sharding` reexporta `@fluxerjs/sharding` (peer opcional) | Sem coordenação própria |
|
|
52
|
+
| Cluster/subpaths | `yuzuha/sdk/cluster` e demais subpaths `yuzuha/sdk/*` espelham `@fluxerjs/core/*` e os pacotes satélites | Sem wrapper próprio |
|
|
41
53
|
| Estado e casos | `ctx.data`, TTL, userFor, transaction entre chaves e stores | Variáveis, TTL, incrementos, listas, casos e dataTransaction com operações declarativas |
|
|
42
54
|
| Agendamentos | `ctx.scheduler`, cron/fusos, concorrência limitada, histórico, heartbeat e controles | schedule, scheduleEvery, scheduleCron, controles, histórico, reexecução e retry com jitter |
|
|
43
55
|
| HTTP | `request`, `requestBytes`, `stream`, `multipart`, `withPolicy` e cancelamento | `$http`, `$httpJson`, `$httpMultipart` e download de imagens com política de rede por comando |
|
|
44
56
|
| CLI, plugins, comandos e middleware | Recursos próprios do Yuzuha; lint/catálogos/cenários e manutenção de dados | 336 funções canônicas; comandos e eventos de script |
|
|
45
|
-
| Composição de cartões | `ctx.canvas` e `yuzuha/canvas
|
|
57
|
+
| Composição de cartões | `ctx.canvas`, `yuzuha/canvas` (napi em processo) e `yuzuha/canvas/card` (builder isolado), com peer opcional `@napi-rs/canvas`; envio pelo contexto | 12 funções `$canvas*` para cenas privadas por execução; envio sem retorno automático |
|
|
46
58
|
|
|
47
59
|
A camada nativa do Yuzuha — o caminho principal — acrescenta schemas de argumentos
|
|
48
60
|
e flags com inferência, subcomandos, ajuda detalhada, checks e middleware por comando, eventos com encaminhamento de
|
|
49
61
|
erros e plugins que agrupam comandos e eventos. Os mesmos contratos de recursos atendem scripts
|
|
50
62
|
e comandos nativos, e `ctx.scheduler`/`ctx.http` expõem agendamento e rede sem
|
|
51
63
|
duplicar regras. Veja o [guia nativo](NATIVE.md) e o
|
|
52
|
-
[inventário de lacunas](FUNCTION-GAPS.md), que separa wrappers ausentes de
|
|
64
|
+
[inventário de lacunas](functions/FUNCTION-GAPS.md), que separa wrappers ausentes de
|
|
53
65
|
recursos já acessíveis no SDK.
|
|
54
66
|
|
|
55
67
|
Canvas é um módulo de composição com builder, imagens, texto e formas. Ele não
|
|
@@ -114,7 +126,7 @@ retorno e limites próprios, publicados na referência gerada:
|
|
|
114
126
|
acrescentam casos e definem `$caseID`.
|
|
115
127
|
|
|
116
128
|
Ao adaptar um script, revise cada chamada com a referência gerada em
|
|
117
|
-
[FUNCTIONS.md](FUNCTIONS.md). Use a matriz acima para distinguir funções de script
|
|
129
|
+
[FUNCTIONS.md](functions/FUNCTIONS.md). Use a matriz acima para distinguir funções de script
|
|
118
130
|
dos recursos acessíveis pelo SDK nativo.
|
|
119
131
|
|
|
120
132
|
## Extensões opcionais e ferramentas
|
package/docs/PLAN.md
CHANGED
|
@@ -43,9 +43,9 @@ recursos. O runtime de scripts só é registrado quando o function mode é usado
|
|
|
43
43
|
2. Entrypoints: `yuzuha` é nativo; `yuzuha/functions` contém parser, AST,
|
|
44
44
|
evaluator, `Runtime`, `registerBuiltins` e `script()`. `yuzuha/sdk`,
|
|
45
45
|
`yuzuha/testing` e os auxiliares de editor em `yuzuha/tooling` completam a superfície pública.
|
|
46
|
-
3. Ativação do function mode:
|
|
47
|
-
`
|
|
48
|
-
|
|
46
|
+
3. Ativação do function mode: comandos com `code` e eventos de script exigem um
|
|
47
|
+
engine explícito — `engine: functions()` nas opções ou `bot.useEngine(engine)`.
|
|
48
|
+
A CLI injeta `functions()` automaticamente. Bots 100% nativos não carregam o runtime.
|
|
49
49
|
4. Transporte: interface pequena, tipada e substituível. Adaptador Fluxer real e
|
|
50
50
|
adaptador em memória para testes sem token. Objetos de mensagens preservam os
|
|
51
51
|
dados usados pelo contexto; acesso ao objeto original é explícito.
|
|
@@ -73,6 +73,17 @@ recursos. O runtime de scripts só é registrado quando o function mode é usado
|
|
|
73
73
|
|
|
74
74
|
## Entregas e dependências
|
|
75
75
|
|
|
76
|
+
A atualização 0.3.0 isola o function mode da raiz e abre o canvas em processo:
|
|
77
|
+
`yuzuha/canvas` passa a espelhar `@napi-rs/canvas` com `createCanvas`,
|
|
78
|
+
`loadImage` via `HttpService` e `registerFonts`, enquanto o builder de cartões
|
|
79
|
+
vai para `yuzuha/canvas/card` como `createCard`. O runtime de scripts migra para
|
|
80
|
+
`src/functions/` atrás do port `ScriptEngine` (`src/ports/script-engine.ts`) —
|
|
81
|
+
bots com `code` ou `scriptEvent` instalam `engine: functions()` ou
|
|
82
|
+
`bot.useEngine(...)`, e a CLI injeta o engine sozinha. `bot.runtime`,
|
|
83
|
+
`enableFunctions()` e `YuzuhaOptions.limits` saem. A documentação passa a tratar
|
|
84
|
+
JS/TS como experiência principal e move os guias do function mode para
|
|
85
|
+
`docs/functions/`.
|
|
86
|
+
|
|
76
87
|
A atualização 0.2.0 completa os embeds: `url`, `timestamp`, `author`, ícones, alt
|
|
77
88
|
text em imagem e miniatura, campos incrementais e `$embedFromObject`. Mensagens
|
|
78
89
|
passam a aceitar até 10 embeds, `tts`, `stickerIds`, `flags` e `allowedMentions`
|
package/docs/QUICKSTART.md
CHANGED
|
@@ -10,13 +10,13 @@ Use Node >=22.13 e npm. Em um projeto ESM existente, instale a versão desta
|
|
|
10
10
|
documentação:
|
|
11
11
|
|
|
12
12
|
```sh
|
|
13
|
-
npm install yuzuha@0.
|
|
13
|
+
npm install yuzuha@0.3.0
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
Para gerar um bot em uma pasta nova, execute:
|
|
17
17
|
|
|
18
18
|
```sh
|
|
19
|
-
npx yuzuha@0.
|
|
19
|
+
npx yuzuha@0.3.0 init ./meu-bot --ts
|
|
20
20
|
cd meu-bot
|
|
21
21
|
npm install
|
|
22
22
|
npm run check
|
|
@@ -156,12 +156,12 @@ export default script({
|
|
|
156
156
|
});
|
|
157
157
|
```
|
|
158
158
|
|
|
159
|
-
|
|
160
|
-
|
|
159
|
+
Comandos com `code` exigem um engine de function mode: passe
|
|
160
|
+
`engine: functions()` de `yuzuha/functions` nas opções do bot. Um comando executável aceita
|
|
161
161
|
exatamente um entre `code` e `run`. Grupos também podem declarar somente
|
|
162
162
|
`subcommands`.
|
|
163
163
|
|
|
164
|
-
Consulte a [sintaxe do function mode](LANGUAGE.md), o
|
|
164
|
+
Consulte a [sintaxe do function mode](functions/LANGUAGE.md), o
|
|
165
165
|
[tutorial do primeiro script](tutorials/FUNCTION-MODE.md) e os
|
|
166
166
|
[grupos e subcomandos nativos](NATIVE.md).
|
|
167
167
|
|
package/docs/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Documentação da Yuzuha
|
|
2
2
|
|
|
3
|
-
Esta documentação cobre a Yuzuha 0.
|
|
3
|
+
Esta documentação cobre a Yuzuha 0.3.0, em JavaScript ESM e TypeScript, para
|
|
4
4
|
Node >=22.13. O pacote usa `@fluxerjs/core` 3.3.0.
|
|
5
5
|
|
|
6
6
|
JS/TS é o caminho principal da biblioteca. Function mode (`$...`) é opcional e
|
|
@@ -14,8 +14,8 @@ conectam ao Fluxer.
|
|
|
14
14
|
|---|---|
|
|
15
15
|
| Criar o primeiro bot | [Instale e gere o projeto](QUICKSTART.md), depois [crie e teste o comando `!hello`](tutorials/FIRST-COMMAND.md) |
|
|
16
16
|
| Programar com a API nativa | Aprenda [comandos, eventos e plugins em JS/TS](NATIVE.md) e consulte os [contratos da API pública](API.md) |
|
|
17
|
-
| Escrever comandos em function mode | [Crie o primeiro script](tutorials/FUNCTION-MODE.md) e consulte a [sintaxe e as regras de avaliação](LANGUAGE.md) |
|
|
18
|
-
| Consultar referências | Use a [referência da API pública](API.md), o [catálogo de funções](FUNCTIONS.md) e a [referência da CLI](CLI.md) |
|
|
17
|
+
| Escrever comandos em function mode | [Crie o primeiro script](tutorials/FUNCTION-MODE.md) e consulte a [sintaxe e as regras de avaliação](functions/LANGUAGE.md) |
|
|
18
|
+
| Consultar referências | Use a [referência da API pública](API.md), o [catálogo de funções](functions/FUNCTIONS.md) e a [referência da CLI](CLI.md) |
|
|
19
19
|
|
|
20
20
|
## Desenvolver e integrar
|
|
21
21
|
|
|
@@ -24,9 +24,9 @@ conectam ao Fluxer.
|
|
|
24
24
|
| [Guia nativo JS/TS](NATIVE.md) | Argumentos inferidos, contexto, moderação, dados, eventos e plugins |
|
|
25
25
|
| [Framework](FRAMEWORK.md) | Registro de comandos, contexto, plugins, middleware e function mode |
|
|
26
26
|
| [API pública](API.md) | Entrypoints, opções, métodos, contratos e erros |
|
|
27
|
-
| [Function mode](LANGUAGE.md) | Sintaxe, funções, escopo e limites dos scripts |
|
|
28
|
-
| [Referência de funções](FUNCTIONS.md) | Assinaturas geradas do registro executável |
|
|
29
|
-
| [Funções ausentes](FUNCTION-GAPS.md) | Inventário auditado, propostas de wrappers e limites de cobertura |
|
|
27
|
+
| [Function mode](functions/LANGUAGE.md) | Sintaxe, funções, escopo e limites dos scripts |
|
|
28
|
+
| [Referência de funções](functions/FUNCTIONS.md) | Assinaturas geradas do registro executável |
|
|
29
|
+
| [Funções ausentes](functions/FUNCTION-GAPS.md) | Inventário auditado, propostas de wrappers e limites de cobertura |
|
|
30
30
|
| [Contador e dados por escopo](tutorials/DATA.md) | Incrementos atômicos, leitura, escrita, TTL e escolha do store |
|
|
31
31
|
| [Estado e execução](STORAGE.md) | JSON/SQLite, transações, fechamento, limites e falhas parciais |
|
|
32
32
|
| [Eventos de scripts](EVENTS.md) | Payloads, contexto, guards e ciclo de vida |
|
|
@@ -66,7 +66,7 @@ Os exemplos usam imports públicos de `yuzuha`, `yuzuha/functions`, `yuzuha/sdk`
|
|
|
66
66
|
`yuzuha/testing`. Caminhos em `src/` aparecem para explicar a implementação e
|
|
67
67
|
não são subpaths novos do pacote.
|
|
68
68
|
|
|
69
|
-
Consulte também os guias de [loops, regex e decimais](LANGUAGE-EXTENSIONS.md),
|
|
69
|
+
Consulte também os guias de [loops, regex e decimais](functions/LANGUAGE-EXTENSIONS.md),
|
|
70
70
|
[transformação de imagens e streams de anexos](IMAGES.md) e
|
|
71
71
|
[integrações e sharding](INTEGRATIONS.md).
|
|
72
72
|
|
package/docs/REPOSITORY.md
CHANGED
|
@@ -45,7 +45,7 @@ padrão e os exemplos de consumidor estão no [guia inicial](QUICKSTART.md).
|
|
|
45
45
|
|
|
46
46
|
## Editar a documentação
|
|
47
47
|
|
|
48
|
-
Edite os guias em `docs/`. A referência de funções em `docs/FUNCTIONS.md` e o
|
|
48
|
+
Edite os guias em `docs/`. A referência de funções em `docs/functions/FUNCTIONS.md` e o
|
|
49
49
|
catálogo do editor são gerados a partir dos metadados dos builtins:
|
|
50
50
|
|
|
51
51
|
```sh
|
package/docs/SCHEDULER.md
CHANGED
|
@@ -123,4 +123,4 @@ local: comandos com efeitos externos devem ser idempotentes. Falhas automáticas
|
|
|
123
123
|
de store chegam a `onError` e aos eventos do scheduler; não são descartadas.
|
|
124
124
|
|
|
125
125
|
Veja também [armazenamento](STORAGE.md), [observabilidade](OBSERVABILITY.md) e
|
|
126
|
-
[referência de funções](FUNCTIONS.md).
|
|
126
|
+
[referência de funções](functions/FUNCTIONS.md).
|
package/docs/TROUBLESHOOTING.md
CHANGED
|
@@ -46,7 +46,7 @@ comprova validade do token, disponibilidade do servidor ou permissões remotas.
|
|
|
46
46
|
|
|
47
47
|
Funções não distinguem maiúsculas e minúsculas; variáveis distinguem.
|
|
48
48
|
`$reply[]` não possui argumento e é inválido. Consulte a
|
|
49
|
-
[linguagem](LANGUAGE.md) e a [referência gerada](FUNCTIONS.md).
|
|
49
|
+
[linguagem](functions/LANGUAGE.md) e a [referência gerada](functions/FUNCTIONS.md).
|
|
50
50
|
|
|
51
51
|
Se o script usa uma função de plugin, valide a config em vez da pasta isolada:
|
|
52
52
|
`yuzuha check yuzuha.config.ts`.
|
package/docs/VALIDATION.md
CHANGED
|
@@ -99,7 +99,7 @@ O índice SQLite é derivado e reconstruído na primeira consulta após escrita;
|
|
|
99
99
|
as escritas ainda serializam o estado integral. Anexos recebidos por stream
|
|
100
100
|
são acumulados antes do upload exigido pelo SDK. Componentes interativos e
|
|
101
101
|
comandos de aplicação continuam sem contrato equivalente verificado.
|
|
102
|
-
[FUNCTION-GAPS.md](FUNCTION-GAPS.md) e [INTEGRATIONS.md](INTEGRATIONS.md)
|
|
102
|
+
[FUNCTION-GAPS.md](functions/FUNCTION-GAPS.md) e [INTEGRATIONS.md](INTEGRATIONS.md)
|
|
103
103
|
registram essas limitações. Não houve publicação ou ações reais de bot.
|
|
104
104
|
|
|
105
105
|
## Monorepo e documentação web — rodada anterior
|
|
@@ -259,7 +259,7 @@ no Fluxer real. Ambiente: Linux, Node **26.11.1**, npm **12.2.1** e
|
|
|
259
259
|
|---|---|
|
|
260
260
|
| `npm run check` | PASS: tipos, arquitetura, testes, build, editor, referência e documentação |
|
|
261
261
|
| Testes de comportamento | PASS: **386 testes**, nenhuma falha, cancelamento ou skip |
|
|
262
|
-
| Dependências entre camadas | PASS: **147 módulos**; domínio, ports, serviços e
|
|
262
|
+
| Dependências entre camadas | PASS: **147 módulos**; domínio, ports, serviços e functions isolados |
|
|
263
263
|
| Referência e documentação | PASS: **288 funções**, 28 arquivos Markdown e links locais |
|
|
264
264
|
| Manifest, lockfile e changelog | PASS: versão `0.1.4`, título Hory `v0.1.4` |
|
|
265
265
|
| `npm run smoke:package` | PASS: tarball instalado em consumidor externo e scaffolds JS/TS |
|
|
@@ -322,9 +322,9 @@ reabertura JSON/SQLite, histórico/retry de tarefas e isolamento por autor/guild
|
|
|
322
322
|
Também inclui parser e limites, dados de usuário inertes, caminhos/propriedades
|
|
323
323
|
próprias, diagnósticos UTF-16 e o host simulado da extensão VS Code.
|
|
324
324
|
|
|
325
|
-
A raiz nativa continua sem exports de parser/runtime
|
|
326
|
-
|
|
327
|
-
|
|
325
|
+
A raiz nativa continua sem exports de parser/runtime e não carrega o function mode;
|
|
326
|
+
comandos com `code` e eventos de script exigem `engine: functions()` de `yuzuha/functions`.
|
|
327
|
+
Reload, fechamento, store injetado e identidade das
|
|
328
328
|
classes públicas em configs/comandos TS continuam cobertos.
|
|
329
329
|
|
|
330
330
|
## Limites da evidência
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Funções que ainda faltam
|
|
2
2
|
|
|
3
|
-
Inventário da versão **0.2.
|
|
3
|
+
Inventário da versão **0.2.1**, comparando o registro executável do Yuzuha com os
|
|
4
4
|
tipos públicos de **@fluxerjs/core 3.3.0**, fixado no lockfile. O inventário tem
|
|
5
5
|
**336 funções canônicas**; aliases não aumentam esse número.
|
|
6
6
|
|
|
@@ -10,10 +10,15 @@ ideias de API: **não estão registrados e não podem ser usados em scripts**.
|
|
|
10
10
|
|
|
11
11
|
## Cobertura atual
|
|
12
12
|
|
|
13
|
-
O function mode tem 336 funções canônicas
|
|
13
|
+
O function mode tem 336 funções canônicas. O SDK continua
|
|
14
14
|
disponível em JS/TS, com recursos injetáveis e testáveis offline.
|
|
15
15
|
Esta tabela é um mapa dos recursos entregues pelo Yuzuha e das APIs nativas
|
|
16
|
-
disponíveis para escrever novos comandos.
|
|
16
|
+
disponíveis para escrever novos comandos. Desde a 0.2.1, `ctx.resources` inclui
|
|
17
|
+
as áreas `gateway` (pedidos brutos), `instance` (descoberta e aplicação), `self`
|
|
18
|
+
(usuário autenticado com verificação sudo) e `cache` (estatísticas e limpezas);
|
|
19
|
+
`collectors` ganhou streams `AsyncIterable` e `messages` ganhou `bulkFetch` e
|
|
20
|
+
`searchAll`. Os subpaths `yuzuha/sdk/*` espelham `@fluxerjs/core/*` e os pacotes
|
|
21
|
+
satélites do monorepo.
|
|
17
22
|
|
|
18
23
|
| Área | Funções | Cobertura |
|
|
19
24
|
|---|---|---|
|
|
@@ -21,7 +26,7 @@ disponíveis para escrever novos comandos.
|
|
|
21
26
|
| Cargos | `$role`, `$roles`, `$hasRole`, `$addRole`, `$removeRole`, `$createRole`, `$editRole`, `$deleteRole`, `$moveRole` | Resolução por nome, ID ou menção, mutações e posição |
|
|
22
27
|
| Canais | `$channel`, `$channels`, `$createChannel`, `$editChannel`, `$deleteChannel`, `$channelPerms`, `$channelPermsOf`, `$slowmode`, `$moveChannel`, `$setCategory` | Criação, edição, exclusão, posição, categoria, overwrites e permissões efetivas |
|
|
23
28
|
| Mensagens | `$fetchMessage`, `$messages`, `$pin`, `$unpin`, `$pinnedMessages`, `$pinnedMessagesPage`, `$searchMessagesAdvanced`, `$sendFiles`, `$removeReaction`, `$clearReactions`, `$reactionUsers`, `$reactionUsersPage` | Histórico, páginas de fixadas por timestamp, busca com filtros do SDK, anexos por URL e reações com metadados de paginação |
|
|
24
|
-
| Embeds | `$embed`, `$author`, `$url`, `$embedTimestamp`, `$footerIcon`, `$imageAlt`, `$fields`, `$addField`, `$removeField`, `$editField`, `$embedFromObject`, `$embeds`, `$addEmbed`, `$messageOptions` | Partes tipadas, campos incrementais, lista de até 10 embeds, URLs HTTP(S), limites do SDK e opções de envio com permissão; detalhes em [EMBEDS.md](EMBEDS.md) |
|
|
29
|
+
| Embeds | `$embed`, `$author`, `$url`, `$embedTimestamp`, `$footerIcon`, `$imageAlt`, `$fields`, `$addField`, `$removeField`, `$editField`, `$embedFromObject`, `$embeds`, `$addEmbed`, `$messageOptions` | Partes tipadas, campos incrementais, lista de até 10 embeds, URLs HTTP(S), limites do SDK e opções de envio com permissão; detalhes em [EMBEDS.md](../EMBEDS.md) |
|
|
25
30
|
| Coletores | `$awaitMessage`, `$awaitReaction`, `$confirm` | Espera com timeout, filtro por autor e múltiplos emojis |
|
|
26
31
|
| Servidor e convites | `$invite`, `$createInvite`, `$deleteInvite` | Convite por código/URL e criação com duração |
|
|
27
32
|
| Webhooks | `$webhooks`, `$createWebhook`, `$sendWebhook`, `$editWebhook`, `$deleteWebhook` | CRUD e envio com ou sem token |
|
|
@@ -76,12 +81,12 @@ assíncronos dentro do store. A extensão cobre as 336 funções internas.
|
|
|
76
81
|
| Mensagens | `$preloadMessages` | Última mensagem por canal; array de 1 a 100 IDs, com entradas ausentes normalizadas como null |
|
|
77
82
|
| Expressões | `$createEmojisBulk` | 1 a 50 objetos name/image base64, até 10 MB; success/failed preservam falhas parciais |
|
|
78
83
|
| Autorização | Cargos, canais e webhooks em `ctx.resources` | Guards de autor/bot compartilhados entre nativo e script, servidor, permissões locais e hierarquia; token de webhook não contorna a política |
|
|
79
|
-
| Eventos | `$eventName`, `$eventUserID`, `$eventGuildID`, `$eventChannelID`, `$eventMessageID`, `$eventContent`, `$eventOldContent`, `$eventEmoji` | Seis eventos de SDK, ausências null, metadados imutáveis, ator explícito e cancelamento; veja [EVENTS.md](EVENTS.md) |
|
|
84
|
+
| Eventos | `$eventName`, `$eventUserID`, `$eventGuildID`, `$eventChannelID`, `$eventMessageID`, `$eventContent`, `$eventOldContent`, `$eventEmoji` | Seis eventos de SDK, ausências null, metadados imutáveis, ator explícito e cancelamento; veja [EVENTS.md](../EVENTS.md) |
|
|
80
85
|
| Arrays | `$arrayUnion`, `$arrayIntersection`, `$arrayDifference` | Operações de conjuntos preservando ordem e igualdade profunda |
|
|
81
86
|
| Números | `$formatBytes`, `$percent`, `$toBase`, `$fromBase` | Bytes SI/IEC, percentuais e conversão exata de inteiros em bases 2–36 |
|
|
82
|
-
| Agendamentos | `$scheduleCron` | Cron de cinco campos em fuso IANA, missedRun e retryJitter; veja [SCHEDULER.md](SCHEDULER.md) |
|
|
83
|
-
| HTTP | `$httpMultipart`; `HttpService.stream`/`withPolicy` nativos | Upload limitado, streaming cancelável e políticas restritivas por comando; veja [HTTP.md](HTTP.md) |
|
|
84
|
-
| Ferramentas e estado | `lint`, catálogos JSON, cenários offline e `StateMaintenance` | Diagnósticos sem importar módulos; estatísticas, limpeza limitada, backup e restauração simulável; veja [STORAGE.md](STORAGE.md) |
|
|
87
|
+
| Agendamentos | `$scheduleCron` | Cron de cinco campos em fuso IANA, missedRun e retryJitter; veja [SCHEDULER.md](../SCHEDULER.md) |
|
|
88
|
+
| HTTP | `$httpMultipart`; `HttpService.stream`/`withPolicy` nativos | Upload limitado, streaming cancelável e políticas restritivas por comando; veja [HTTP.md](../HTTP.md) |
|
|
89
|
+
| Ferramentas e estado | `lint`, catálogos JSON, cenários offline e `StateMaintenance` | Diagnósticos sem importar módulos; estatísticas, limpeza limitada, backup e restauração simulável; veja [STORAGE.md](../STORAGE.md) |
|
|
85
90
|
|
|
86
91
|
## Cobertura adicional da 0.1.7
|
|
87
92
|
|
|
@@ -100,11 +105,11 @@ assíncronos dentro do store. A extensão cobre as 336 funções internas.
|
|
|
100
105
|
- `$httpStream`, `$httpChunk` e `$httpChunkIndex` processam trechos UTF-8 sem
|
|
101
106
|
carregar a resposta inteira e preservam política HTTP e cancelamento.
|
|
102
107
|
- Agendamentos têm prioridade e capacidade compartilhada por claims SQLite;
|
|
103
|
-
veja os requisitos de configuração no [guia](SCHEDULER.md).
|
|
108
|
+
veja os requisitos de configuração no [guia](../SCHEDULER.md).
|
|
104
109
|
|
|
105
110
|
- `yuzuha/images` transforma PNG/JPEG/WebP por processos isolados com Sharp opcional.
|
|
106
111
|
`ctx.sendStream` recebe anexos por stream com limite, acumulando antes do upload
|
|
107
|
-
exigido pelo SDK. Veja [IMAGES.md](IMAGES.md).
|
|
112
|
+
exigido pelo SDK. Veja [IMAGES.md](../IMAGES.md).
|
|
108
113
|
|
|
109
114
|
Veja contratos e exemplos no [guia de operações de dados](LANGUAGE-EXTENSIONS.md).
|
|
110
115
|
|
|
@@ -132,7 +137,7 @@ nomes novos para métodos do SDK.
|
|
|
132
137
|
|
|
133
138
|
Não há `$eval` de JavaScript nem reinterpretação de texto de usuário como código.
|
|
134
139
|
Funções JS/TS próprias podem ser registradas explicitamente. Para operações
|
|
135
|
-
complexas, use o [guia nativo](NATIVE.md).
|
|
140
|
+
complexas, use o [guia nativo](../NATIVE.md).
|
|
136
141
|
|
|
137
142
|
## Limites de escopo do Yuzuha
|
|
138
143
|
|
|
@@ -142,7 +147,7 @@ complexas, use o [guia nativo](NATIVE.md).
|
|
|
142
147
|
voz oficial opcional e controle Lavalink em `yuzuha/music`, sem wrappers de
|
|
143
148
|
reprodução em scripts. O core aceita configuração de shards via clientOptions;
|
|
144
149
|
gerência de processos exige `@fluxerjs/sharding`, não incluído no pacote.
|
|
145
|
-
Veja a [auditoria de integrações](INTEGRATIONS.md).
|
|
150
|
+
Veja a [auditoria de integrações](../INTEGRATIONS.md).
|
|
146
151
|
- Economia, XP, rankings e tickets são sistemas de produto. Ter variáveis,
|
|
147
152
|
moderação ou acesso ao SDK não significa que esses sistemas já estejam prontos.
|
|
148
153
|
- LSP e migração automática de scripts de outros runtimes ainda não são ferramentas entregues.
|
|
@@ -162,7 +167,7 @@ dependência instalada. Não mede compatibilidade com catálogos de outros runti
|
|
|
162
167
|
|
|
163
168
|
## Evidências
|
|
164
169
|
|
|
165
|
-
O inventário vem de `src/
|
|
170
|
+
O inventário vem de `src/functions/builtins/` e [FUNCTIONS.md](FUNCTIONS.md).
|
|
166
171
|
Os recursos nativos foram conferidos nas declarações distribuídas em
|
|
167
172
|
`node_modules/@fluxerjs/core/dist/index.d.ts` e nos arquivos `.d.ts` reexportados
|
|
168
173
|
por ela, incluindo `Guild`, `GuildMember`, `Channel`, `Message`, `Webhook` e
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Function mode: linguagem de scripts
|
|
2
2
|
|
|
3
|
-
O function mode é opcional
|
|
4
|
-
|
|
5
|
-
usam esta linguagem.
|
|
3
|
+
O function mode é opcional e exige um engine: passe `engine: functions()`
|
|
4
|
+
de `yuzuha/functions` nas opções do bot (ou `bot.useEngine(...)`); a CLI injeta
|
|
5
|
+
o engine automaticamente. Comandos nativos não usam esta linguagem.
|
|
6
6
|
|
|
7
7
|
## Sintaxe
|
|
8
8
|
|
|
@@ -411,7 +411,7 @@ $reply[Prazo restante: $ttlGuildVar[evento] ms]
|
|
|
411
411
|
As variantes `Var` e `UserVar` seguem as mesmas regras. `$dataTransaction` recebe
|
|
412
412
|
um array de até 100 operações JSON para ler, escrever, apagar, incrementar e
|
|
413
413
|
alterar/consultar TTL em vários escopos atomicamente. Uma operação inválida ou
|
|
414
|
-
saída acima do orçamento desfaz tudo; veja [STORAGE.md](STORAGE.md).
|
|
414
|
+
saída acima do orçamento desfaz tudo; veja [STORAGE.md](../STORAGE.md).
|
|
415
415
|
Não há execução de scripts assíncronos dentro de transações do store.
|
|
416
416
|
|
|
417
417
|
`$modMoveMember[usuário;canal;motivo]`, `$modMuteMember[usuário;true;motivo]`
|
|
@@ -520,7 +520,7 @@ separados por vírgula ou quebra de linha.
|
|
|
520
520
|
O cliente bloqueia por padrão loopback, redes privadas e endereços de metadados,
|
|
521
521
|
inclusive após redirecionamentos. Também aplica timeout, limite de bytes e uma
|
|
522
522
|
allowlist opcional de hosts. As opções ficam em `new HttpService({ ... })`;
|
|
523
|
-
veja [API](API.md). Use `http: false` para remover o serviço do contexto.
|
|
523
|
+
veja [API](../API.md). Use `http: false` para remover o serviço do contexto.
|
|
524
524
|
|
|
525
525
|
## Diagnóstico e limites
|
|
526
526
|
|
|
@@ -528,7 +528,7 @@ Scripts são analisados antes de registrar os comandos. Função desconhecida,
|
|
|
528
528
|
aridade incorreta e delimitadores incompletos são erros com arquivo/linha/coluna.
|
|
529
529
|
O runtime envolve falhas com o local da chamada e mantém a causa para o handler.
|
|
530
530
|
O editor também aponta esses problemas enquanto digita e pode ler metadados de
|
|
531
|
-
plugins em JSON, conforme [EDITOR.md](EDITOR.md). Cancelamento HTTP/collectors
|
|
531
|
+
plugins em JSON, conforme [EDITOR.md](../EDITOR.md). Cancelamento HTTP/collectors
|
|
532
532
|
do contexto interrompe a espera e não é capturado por `$try`.
|
|
533
533
|
O usuário recebe um erro genérico nas falhas internas; guards usam suas próprias
|
|
534
|
-
mensagens. Confira os limites e o modelo de confiança em [STORAGE.md](STORAGE.md).
|
|
534
|
+
mensagens. Confira os limites e o modelo de confiança em [STORAGE.md](../STORAGE.md).
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Function mode (opcional)
|
|
2
|
+
|
|
3
|
+
O function mode é uma linguagem de scripts declarativa opcional. Ele não faz
|
|
4
|
+
parte da superfície nativa: a raiz `yuzuha` não carrega parser, runtime nem
|
|
5
|
+
builtins. Para usá-lo em comandos com `code`, eventos de script ou plugins com
|
|
6
|
+
`functions`, instale um engine explicitamente:
|
|
7
|
+
|
|
8
|
+
Uma engine compila programas opacos; cada programa executa sempre na engine que o compilou.
|
|
9
|
+
|
|
10
|
+
```ts
|
|
11
|
+
import { Yuzuha, MemoryStore } from 'yuzuha';
|
|
12
|
+
import { functions, script } from 'yuzuha/functions';
|
|
13
|
+
|
|
14
|
+
const bot = new Yuzuha({
|
|
15
|
+
transport,
|
|
16
|
+
store: new MemoryStore(),
|
|
17
|
+
engine: functions(),
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
bot.command(script({ name: 'ola', code: '$reply[Olá, $username!]' }));
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Também é possível instalar depois com `bot.useEngine(engine)`. Registrar
|
|
24
|
+
`code` ou `scriptEvent` sem engine falha com `FUNCTIONS_REQUIRED`. A CLI injeta
|
|
25
|
+
`functions()` automaticamente, então `yuzuha.config.js` e `init --functions`
|
|
26
|
+
não exigem configuração extra.
|
|
27
|
+
|
|
28
|
+
## Documentos
|
|
29
|
+
|
|
30
|
+
- [LANGUAGE.md](LANGUAGE.md): sintaxe da linguagem de scripts.
|
|
31
|
+
- [FUNCTIONS.md](FUNCTIONS.md): referência gerada das 336 funções.
|
|
32
|
+
- [LANGUAGE-EXTENSIONS.md](LANGUAGE-EXTENSIONS.md): operações de dados e extensões.
|
|
33
|
+
- [FUNCTION-GAPS.md](FUNCTION-GAPS.md): lacunas conhecidas e como contorná-las.
|
package/docs/tutorials/DATA.md
CHANGED
|
@@ -96,5 +96,5 @@ da configuração durante seu próprio ciclo de vida.
|
|
|
96
96
|
|
|
97
97
|
Para transações entre chaves, backup, restauração e falhas parciais, consulte o
|
|
98
98
|
[guia de estado e persistência](../STORAGE.md). Para scripts, veja as
|
|
99
|
-
[transações declarativas](../LANGUAGE.md) e a assinatura de
|
|
100
|
-
[`$dataTransaction` no catálogo de funções](../FUNCTIONS.md).
|
|
99
|
+
[transações declarativas](../functions/LANGUAGE.md) e a assinatura de
|
|
100
|
+
[`$dataTransaction` no catálogo de funções](../functions/FUNCTIONS.md).
|
|
@@ -95,6 +95,6 @@ A busca ignora maiúsculas e procura nome, aliases e descrição. Na documentaç
|
|
|
95
95
|
a área Funções separa o catálogo por categoria e oferece uma página para cada
|
|
96
96
|
assinatura. Aliases não aumentam a contagem canônica de funções.
|
|
97
97
|
|
|
98
|
-
Consulte a [sintaxe e as regras de avaliação](../LANGUAGE.md), o
|
|
99
|
-
[catálogo completo de funções](../FUNCTIONS.md) e os
|
|
98
|
+
Consulte a [sintaxe e as regras de avaliação](../functions/LANGUAGE.md), o
|
|
99
|
+
[catálogo completo de funções](../functions/FUNCTIONS.md) e os
|
|
100
100
|
[eventos de script](../EVENTS.md).
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { mkdir, readFile, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { createCanvas, loadImage, registerFonts } from 'yuzuha/canvas';
|
|
3
|
+
|
|
4
|
+
const output = new URL('./output/', import.meta.url);
|
|
5
|
+
await mkdir(output, { recursive: true });
|
|
6
|
+
|
|
7
|
+
registerFonts(new URL('../../assets/canvas/', import.meta.url).pathname);
|
|
8
|
+
|
|
9
|
+
const avatar = await loadImage(new URL('./fixtures/avatar.png', import.meta.url).pathname);
|
|
10
|
+
const canvas = createCanvas(640, 240);
|
|
11
|
+
const ctx = canvas.getContext('2d');
|
|
12
|
+
ctx.fillStyle = '#101722';
|
|
13
|
+
ctx.fillRect(0, 0, 640, 240);
|
|
14
|
+
ctx.drawImage(avatar, 24, 56, 128, 128);
|
|
15
|
+
ctx.font = '700 48px Inter';
|
|
16
|
+
ctx.fillStyle = '#f2f4f5';
|
|
17
|
+
ctx.fillText('Ada Monteiro', 184, 110);
|
|
18
|
+
ctx.font = '24px Inter';
|
|
19
|
+
ctx.fillStyle = '#aebac6';
|
|
20
|
+
ctx.fillText('Desenho direto com a API napi.', 184, 152);
|
|
21
|
+
|
|
22
|
+
const png = new Uint8Array(await canvas.encode('png'));
|
|
23
|
+
await writeFile(new URL('napi-style.png', output), png);
|
|
24
|
+
console.log(`PNG gravado em ${new URL('napi-style.png', output).pathname}`);
|
|
Binary file
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { createCard } from 'yuzuha/canvas/card';
|
|
2
2
|
|
|
3
3
|
export function buildProfile(name, avatar) {
|
|
4
|
-
return
|
|
4
|
+
return createCard(1000, 340, { scale: 2, background: '#101722' })
|
|
5
5
|
.rect({ x: 0, y: 0, width: 8, height: 340, fill: '#70d8bc' })
|
|
6
6
|
.avatar(avatar, { x: 44, y: 92, size: 156, border: { color: '#8ce5c9', width: 3 } })
|
|
7
7
|
.text('COMMUNITY MEMBER', { x: 230, y: 38, maxWidth: 600, fontSize: 14, weight: 700, color: '#70d8bc' })
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import type { CanvasBuilder, CanvasCreateOptions, CanvasSource } from 'yuzuha/canvas';
|
|
1
|
+
import { createCard } from 'yuzuha/canvas/card';
|
|
2
|
+
import type { CanvasBuilder, CanvasCreateOptions, CanvasSource } from 'yuzuha/canvas/card';
|
|
3
3
|
import type { CommandContext } from 'yuzuha';
|
|
4
4
|
|
|
5
5
|
type CanvasCreate = (width: number, height: number, options?: CanvasCreateOptions) => CanvasBuilder;
|
|
@@ -24,7 +24,7 @@ function composeProfile(create: CanvasCreate, name: string, avatar: CanvasSource
|
|
|
24
24
|
}
|
|
25
25
|
|
|
26
26
|
export function buildProfile(name: string, avatar: CanvasSource): CanvasBuilder {
|
|
27
|
-
return composeProfile(
|
|
27
|
+
return composeProfile(createCard, name, avatar);
|
|
28
28
|
}
|
|
29
29
|
|
|
30
30
|
export async function sendProfile(ctx: CommandContext, avatar: CanvasSource = 'asset:avatar'): Promise<string> {
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { createCard } from 'yuzuha/canvas/card';
|
|
2
2
|
|
|
3
3
|
const sampleEntries = [
|
|
4
4
|
{ name: 'Lia', score: 96 }, { name: 'Domingos Ribeiro', score: 88 }, { name: 'Samira', score: 82 },
|
|
@@ -9,7 +9,7 @@ const sampleEntries = [
|
|
|
9
9
|
|
|
10
10
|
export function buildRanking(entries = sampleEntries) {
|
|
11
11
|
if (entries.length !== 10) throw new RangeError('O exemplo de ranking recebe dez posições.');
|
|
12
|
-
const canvas =
|
|
12
|
+
const canvas = createCard(1000, 700, { background: '#101722' })
|
|
13
13
|
.rect({ x: 0, y: 0, width: 8, height: 700, fill: '#70d8bc' })
|
|
14
14
|
.text('Community activity', { x: 42, y: 34, maxWidth: 600, fontSize: 34, weight: 700, color: '#f2f4f5' })
|
|
15
15
|
.text('Ten sample positions · demonstration data', { x: 42, y: 78, maxWidth: 700, fontSize: 16, color: '#9ca9b5' })
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import type { CanvasBuilder, CanvasCreateOptions } from 'yuzuha/canvas';
|
|
1
|
+
import { createCard } from 'yuzuha/canvas/card';
|
|
2
|
+
import type { CanvasBuilder, CanvasCreateOptions } from 'yuzuha/canvas/card';
|
|
3
3
|
import type { CommandContext } from 'yuzuha';
|
|
4
4
|
|
|
5
5
|
export interface RankingEntry { name: string; score: number }
|
|
@@ -31,7 +31,7 @@ function composeRanking(create: CanvasCreate, entries: readonly RankingEntry[]):
|
|
|
31
31
|
}
|
|
32
32
|
|
|
33
33
|
export function buildRanking(entries: readonly RankingEntry[] = sampleEntries): CanvasBuilder {
|
|
34
|
-
return composeRanking(
|
|
34
|
+
return composeRanking(createCard, entries);
|
|
35
35
|
}
|
|
36
36
|
|
|
37
37
|
export async function sendRanking(ctx: CommandContext, entries: readonly RankingEntry[] = sampleEntries): Promise<string> {
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { mkdir, readFile, writeFile } from 'node:fs/promises';
|
|
2
2
|
import { resolve } from 'node:path';
|
|
3
3
|
import { MemoryStore, Yuzuha } from 'yuzuha';
|
|
4
|
+
import { functions } from 'yuzuha/functions';
|
|
4
5
|
import { MockTransport, mockMessage, mockResources } from 'yuzuha/testing';
|
|
5
6
|
import { buildProfile } from './profile.js';
|
|
6
7
|
import { buildWelcome } from './welcome.js';
|
|
@@ -28,7 +29,7 @@ for (const name of ['profile', 'welcome', 'ranking']) {
|
|
|
28
29
|
const source = await readFile(new URL(`./functions/${name}.yuzuha`, directory), 'utf8');
|
|
29
30
|
let data: Uint8Array | undefined;
|
|
30
31
|
const bot = new Yuzuha({ prefix: '!', store: new MemoryStore(), scheduler: false, http: false,
|
|
31
|
-
transport: new MockTransport(), canvas: { assets: { avatar } },
|
|
32
|
+
engine: functions(), transport: new MockTransport(), canvas: { assets: { avatar } },
|
|
32
33
|
resources: mockResources({ messages: { async sendBytes(_channelID, files) { data = new Uint8Array(files[0]!.data); return 'offline'; } } }) });
|
|
33
34
|
try {
|
|
34
35
|
if (name === 'welcome') {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { createCard } from 'yuzuha/canvas/card';
|
|
2
2
|
|
|
3
3
|
export function buildWelcome(name, avatar) {
|
|
4
|
-
return
|
|
4
|
+
return createCard(980, 300, { background: '#111923' })
|
|
5
5
|
.rect({ x: 0, y: 0, width: 12, height: 300, fill: '#d8a36b' })
|
|
6
6
|
.avatar(avatar, { x: 42, y: 74, size: 152, border: { color: '#f0c38c', width: 3 } })
|
|
7
7
|
.text('A NEW VOICE IN THE ROOM', { x: 232, y: 42, maxWidth: 700, fontSize: 13, weight: 700, color: '#e9b87e' })
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import type { CanvasBuilder, CanvasCreateOptions, CanvasSource } from 'yuzuha/canvas';
|
|
1
|
+
import { createCard } from 'yuzuha/canvas/card';
|
|
2
|
+
import type { CanvasBuilder, CanvasCreateOptions, CanvasSource } from 'yuzuha/canvas/card';
|
|
3
3
|
import type { EventContext } from 'yuzuha';
|
|
4
4
|
|
|
5
5
|
type CanvasCreate = (width: number, height: number, options?: CanvasCreateOptions) => CanvasBuilder;
|
|
@@ -18,7 +18,7 @@ function composeWelcome(create: CanvasCreate, name: string, avatar: CanvasSource
|
|
|
18
18
|
}
|
|
19
19
|
|
|
20
20
|
export function buildWelcome(name: string, avatar: CanvasSource): CanvasBuilder {
|
|
21
|
-
return composeWelcome(
|
|
21
|
+
return composeWelcome(createCard, name, avatar);
|
|
22
22
|
}
|
|
23
23
|
|
|
24
24
|
export async function welcomeEvent(ctx: EventContext, avatar: CanvasSource = 'asset:avatar'): Promise<string> {
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { MemoryStore, Yuzuha } from 'yuzuha';
|
|
2
|
-
import { script } from 'yuzuha/functions';
|
|
2
|
+
import { functions, script } from 'yuzuha/functions';
|
|
3
3
|
import { MockTransport, mockMessage } from 'yuzuha/testing';
|
|
4
4
|
|
|
5
5
|
// Mesmo embed do exemplo nativo, montado em function mode. Cada parte é validada pelas mesmas regras.
|
|
@@ -22,7 +22,7 @@ const code = [
|
|
|
22
22
|
].join('');
|
|
23
23
|
|
|
24
24
|
const transport = new MockTransport();
|
|
25
|
-
const bot = new Yuzuha({ transport, store: new MemoryStore() });
|
|
25
|
+
const bot = new Yuzuha({ transport, store: new MemoryStore(), engine: functions() });
|
|
26
26
|
|
|
27
27
|
bot.command(script({ name: 'relatorio', code }));
|
|
28
28
|
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import { MemoryStore, Yuzuha } from 'yuzuha';
|
|
2
|
-
import { script } from 'yuzuha/functions';
|
|
2
|
+
import { functions, script } from 'yuzuha/functions';
|
|
3
3
|
import { MockTransport, mockMessage } from 'yuzuha/testing';
|
|
4
4
|
|
|
5
5
|
const transport = new MockTransport();
|
|
6
|
-
const bot = new Yuzuha({ transport, store: new MemoryStore() });
|
|
6
|
+
const bot = new Yuzuha({ transport, store: new MemoryStore(), engine: functions() });
|
|
7
7
|
|
|
8
|
-
//
|
|
8
|
+
// Comandos com `code` exigem um engine de function mode instalado no bot.
|
|
9
9
|
bot.command(script({
|
|
10
10
|
name: 'ban',
|
|
11
11
|
code: '$modBan[$mentioned[1];$messageSlice[1]]$reply[Membro banido. Caso #$caseID.]',
|