@egyptron/cease
v1.0.2
Published
Cease is a lightweight and fast programming language, mainly used for Discord Webhooks.
Maintainers
Readme
Cease 🛑
Cease is a modern, lightweight Domain Specific Language (DSL) built for Node.js. It is designed to simplify Discord Webhook automation through a clean, readable syntax that can be executed directly from the CLI or via scripted files.
LICENSE: MIT
✨ Features
- Hybrid Execution: Run commands directly in your terminal or via
.cescript files. - Interactive Builder: Built-in CLI prompts for creating complex Discord Embeds on the fly.
- Zero Dependencies: Lightweight and fast, utilizing native Node.js 2026 APIs.
- Global Access: Once installed via NPM, use the
ceasecommand from any directory.
🚀 Quick Start
1. Installation
Install the Cease interpreter globally using NPM:
npm install -g @egyptron/ceaseDocumentation
📘 Documentation & Technical Specs
1. Language Architecture
Cease is built using a Recursive Line-Scanner architecture. Unlike general-purpose languages that use complex Abstract Syntax Trees (AST), Cease uses a high-speed Pattern Matcher to identify flags and multi-line properties.
2. Command Anatomy
Every Cease command follows this structure:
[keyword] "[destination]" [flag] "[data]"
- Keyword (
cease): The entry point for the interpreter. - Destination: A double-quoted string containing a valid Discord Webhook URL.
- Flags:
--t: (Text Mode) Triggers acontentpayload.--e: (Embed Mode) Triggers a multi-lineembedspayload.
- Data: Contextual data (messages or property definitions).
3. Embed Property Keywords
When using the --e flag in a .ce file, the following keywords are reserved:
| Keyword | Accepted Value | Purpose |
| :--- | :--- | :--- |
| Title: | String | Sets the bold header of the embed. |
| Desc: | String | Sets the main body text of the embed. |
| Color: | Hex Code | Sets the sidebar color (e.g., #7289da). |
4. Interactive Mode
If the --e flag is detected in a Direct Terminal Command (no .ce file provided), Cease enters a Readline State.
- It pauses the Node.js process.
- It opens an asynchronous stream to
stdin. - It collects user input for each property and compiles them into a JSON object.
- It resolves the network request before closing the stream.
5. Execution Lifecycle
- Normalization: Code is stripped of whitespace and split into a command array.
- Flag Detection: The interpreter determines the payload type.
- Payload Construction: JSON is built according to Discord's API v10 specifications.
- Asynchronous Dispatch: The
fetchAPI sends the POST request. - Graceful Exit: The process sets
process.exitCodeto 0 and performs a natural cleanup to prevent Windows libuv errors.
🔒 Security & Requirements
- Node.js: Requires version 20.x or higher (Tested on v24+).
- Network: Requires an active internet connection to reach
discord.com. - Privacy: Cease does not log or store Webhook URLs; they are only used for the duration of the execution.
