avrae-ls 0.4.0__tar.gz → 0.5.0__tar.gz

avrae_ls-0.5.0/.gitignore

@@ -0,0 +1,212 @@
+# Created by https://www.toptal.com/developers/gitignore/api/python,linux,visualstudiocode
+# Edit at https://www.toptal.com/developers/gitignore?templates=python,linux,visualstudiocode
+
+### Linux ###
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+### Python Patch ###
+# Poetry local configuration file - https://python-poetry.org/docs/configuration/#local-configuration
+poetry.toml
+
+# ruff
+.ruff_cache/
+
+# LSP config files
+pyrightconfig.json
+
+### VisualStudioCode ###
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/*.code-snippets
+
+# Local History for Visual Studio Code
+.history/
+
+# Built Visual Studio Code Extensions
+*.vsix
+
+### VisualStudioCode Patch ###
+# Ignore all local history of files
+.history
+.ionide
+
+# End of https://www.toptal.com/developers/gitignore/api/python,linux,visualstudiocode
+vscode-extension/node_modules/*
+vscode-extension/dist/

{avrae_ls-0.4.0/src/avrae_ls.egg-info → avrae_ls-0.5.0}/PKG-INFO

@@ -1,21 +1,41 @@
 Metadata-Version: 2.4
 Name: avrae-ls
-Version: 0.4.0
+Version: 0.5.0
 Summary: Language server for Avrae draconic aliases
 Author: 1drturtle
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
+License: MIT License
+        
+        Copyright (c) 2025
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
 License-File: LICENSE
-Requires-Dist: pygls>=1.3.1
-Requires-Dist: lsprotocol>=2023.0.1
-Requires-Dist: httpx>=0.27
+Requires-Python: >=3.11
 Requires-Dist: d20>=1.1.2
+Requires-Dist: httpx>=0.27
+Requires-Dist: lsprotocol>=2023.0.1
+Requires-Dist: pygls>=1.3.1
 Provides-Extra: dev
-Requires-Dist: pytest>=8.3; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
-Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
-Requires-Dist: ruff>=0.6; extra == "dev"
-Dynamic: license-file
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
 
 # Avrae Draconic Alias Language Server
 

{avrae_ls-0.4.0 → avrae_ls-0.5.0}/pyproject.toml

@@ -1,15 +1,15 @@
 [build-system]
-requires = ["setuptools>=68", "wheel"]
-build-backend = "setuptools.build_meta"
+requires = ["hatchling>=1.21"]
+build-backend = "hatchling.build"
 
 [project]
 name = "avrae-ls"
-version = "0.4.0"
+version = "0.5.0"
 description = "Language server for Avrae draconic aliases"
 authors = [
   { name = "1drturtle" }
 ]
-license-files = ["LICENSE"]
+license = { file = "LICENSE" }
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
@@ -30,8 +30,13 @@ dev = [
 [project.scripts]
 avrae-ls = "avrae_ls.__main__:main"
 
-[tool.setuptools.packages.find]
-where = ["src"]
+[tool.hatch.build.targets.wheel]
+packages = ["src/avrae_ls", "src/draconic"]
+
+[tool.hatch.build]
+include = [
+    "src/draconic/LICENSE",
+]
 
 [tool.ruff]
 line-length = 120
@@ -40,6 +45,3 @@ exclude = [
     "avrae",
     "src/draconic"
 ]
-
-[tool.setuptools.package-data]
-draconic = ["LICENSE"]

avrae_ls-0.4.0/PKG-INFO

@@ -1,86 +0,0 @@
-Metadata-Version: 2.4
-Name: avrae-ls
-Version: 0.4.0
-Summary: Language server for Avrae draconic aliases
-Author: 1drturtle
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pygls>=1.3.1
-Requires-Dist: lsprotocol>=2023.0.1
-Requires-Dist: httpx>=0.27
-Requires-Dist: d20>=1.1.2
-Provides-Extra: dev
-Requires-Dist: pytest>=8.3; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
-Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
-Requires-Dist: ruff>=0.6; extra == "dev"
-Dynamic: license-file
-
-# Avrae Draconic Alias Language Server
-
-Language Server Protocol (LSP) implementation targeting Avrae-style draconic aliases. It provides syntax/semantic diagnostics, a mocked execution command, and a thin configuration layer driven by a workspace `.avraels.json` file. Credit to Avrae team for all code yoinked!
-
-## Install (released package)
-
-- CLI/server via `uv tool` (preferred): `uv tool install avrae-ls` then `avrae-ls --help` to see stdio/TCP options (same as `python -m avrae_ls`). The VS Code extension uses this invocation by default. The draconic interpreter is vendored, so no Git deps are needed.
-
-## VS Code extension (released)
-
-- Install from VSIX: download `avrae-ls-client.vsix` from the GitHub releases page, then in VS Code run “Extensions: Install from VSIX” and select the file.
-- Open your alias workspace; commands like `Avrae: Show Alias Preview` and `Avrae: Run Alias` will be available.
-
-## Developing locally
-
-- Prereqs: [uv](https://github.com/astral-sh/uv) and Node.js.
-- Install deps: `uv sync --all-extras` then `make vscode-deps`.
-- Build everything locally: `make package` (wheel + VSIX in `dist/`).
-- Run tests/lint: `make check`.
-- Run via uv tool from source: `uv tool install --from . avrae-ls`.
-- Run diagnostics for a single file (stdout + stderr logs): `avrae-ls --analyze path/to/alias.txt --log-level DEBUG`.
-
-## How to test
-
-- Quick check (ruff + pytest): `make check` (uses `uv run ruff` and `uv run pytest` under the hood).
-- Lint only: `make lint` or `uv run ruff check src tests`.
-- Tests only (with coverage): `make test` or `uv run pytest tests --cov=src`.
-- CLI smoke test without installing: `uv run python -m avrae_ls --analyze path/to/alias.txt`.
-
-## Runtime differences (mock vs. live Avrae)
-
-- Mock execution never writes back to Avrae: cvar/uvar/gvar mutations only live for the current run and reset before the next.
-- Network is limited to gvar fetches (when `enableGvarFetch` is true) and `verify_signature`; other Avrae/Discord calls are replaced with mocked context data from `.avraels.json`.
-- `get_gvar`/`using` values are pulled from local var files first; remote fetches go to `https://api.avrae.io/customizations/gvars/<id>` (or your `avraeService.baseUrl`) using `avraeService.token` and are cached for the session.
-- `signature()` returns a mock string (`mock-signature:<int>`). `verify_signature()` POSTs to `/bot/signature/verify`, respects `verifySignatureTimeout`/`verifySignatureRetries`, reuses the last successful response per signature, and includes `avraeService.token` if present.
-
-## Troubleshooting gvar fetch / verify_signature
-
-- `get_gvar` returns `None` or `using(...)` raises `ModuleNotFoundError`: ensure the workspace `.avraels.json` sets `enableGvarFetch: true`, includes a valid `avraeService.token`, or seed the gvar in a var file referenced by `varFiles`.
-- HTTP 401/403/404 from fetch/verify calls: check the token (401/403) and the gvar/signature id (404). Override `avraeService.baseUrl` if you mirror the API.
-- Slow or flaky calls: tune `verifySignatureTimeout` / `verifySignatureRetries`, or disable remote fetches by flipping `enableGvarFetch` off to rely purely on local vars.
-
-## Other editors (stdio)
-
-- Any client can launch the server with stdio: `avrae-ls --stdio` (flag accepted for client compatibility) or `python -m avrae_ls`. The server will also auto-discover `.avraels.json` in parent folders.
-- Neovim (nvim-lspconfig example):
-  ```lua
-  require("lspconfig").avraels.setup({
-    cmd = { "avrae-ls", "--stdio" },
-    filetypes = { "avrae" },
-    root_dir = require("lspconfig.util").root_pattern(".avraels.json", ".git"),
-  })
-  ```
-- Emacs (lsp-mode snippet):
-  ```elisp
-  (lsp-register-client
-   (make-lsp-client
-    :new-connection (lsp-stdio-connection '("avrae-ls" "--stdio"))
-    :major-modes '(fundamental-mode)  ;; bind to your Avrae alias mode
-    :server-id 'avrae-ls))
-  ```
-- VS Code commands to mirror: `Avrae: Run Alias (Mock)`, `Avrae: Show Alias Preview`, and `Avrae: Reload Workspace Config` run against the same server binary.
-
-## Releasing (maintainers)
-
-1. Bump `pyproject.toml` / `package.json`
-2. Create Github release

avrae_ls-0.4.0/setup.cfg

@@ -1,4 +0,0 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-

avrae_ls-0.4.0/src/avrae_ls/__init__.py

@@ -1,3 +0,0 @@
-from .server import create_server
-
-__all__ = ["create_server"]

avrae_ls-0.4.0/src/avrae_ls/__main__.py

@@ -1,108 +0,0 @@
-from __future__ import annotations
-
-import argparse
-import asyncio
-import logging
-import sys
-from pathlib import Path
-from typing import Iterable
-
-from lsprotocol import types
-
-from .config import CONFIG_FILENAME, load_config
-from .context import ContextBuilder
-from .diagnostics import DiagnosticProvider
-from .runtime import MockExecutor
-from .server import create_server
-
-
-def main(argv: list[str] | None = None) -> None:
-    parser = argparse.ArgumentParser(description="Avrae draconic alias language server")
-    parser.add_argument("--tcp", action="store_true", help="Run in TCP mode instead of stdio")
-    parser.add_argument("--host", default="127.0.0.1", help="TCP host (when --tcp is set)")
-    parser.add_argument("--port", type=int, default=2087, help="TCP port (when --tcp is set)")
-    parser.add_argument("--stdio", action="store_true", help="Accept stdio flag for VS Code clients (ignored)")
-    parser.add_argument("--log-level", default="WARNING", help="Logging level (DEBUG, INFO, WARNING, ERROR)")
-    parser.add_argument("--analyze", metavar="FILE", help="Run diagnostics for a file and print them to stdout")
-    args = parser.parse_args(argv)
-
-    _configure_logging(args.log_level)
-
-    if args.analyze:
-        if args.tcp:
-            parser.error("--analyze cannot be combined with --tcp")
-        sys.exit(_run_analysis(Path(args.analyze)))
-
-    server = create_server()
-    if args.tcp:
-        server.start_tcp(args.host, args.port)
-    else:
-        server.start_io()
-
-
-def _configure_logging(level: str) -> None:
-    numeric = getattr(logging, level.upper(), logging.WARNING)
-    if not isinstance(numeric, int):
-        numeric = logging.WARNING
-    logging.basicConfig(
-        level=numeric,
-        format="%(levelname)s %(name)s: %(message)s",
-    )
-
-
-def _run_analysis(path: Path) -> int:
-    if not path.exists():
-        print(f"File not found: {path}", file=sys.stderr)
-        return 2
-
-    workspace_root = _discover_workspace_root(path)
-    log = logging.getLogger(__name__)
-    log.info("Analyzing %s (workspace root: %s)", path, workspace_root)
-
-    config, warnings = load_config(workspace_root)
-    for warning in warnings:
-        log.warning(warning)
-
-    builder = ContextBuilder(config)
-    ctx_data = builder.build()
-    executor = MockExecutor(config.service)
-    diagnostics = DiagnosticProvider(executor, config.diagnostics)
-
-    source = path.read_text()
-    results = asyncio.run(diagnostics.analyze(source, ctx_data, builder.gvar_resolver))
-    _print_diagnostics(path, results)
-    return 1 if results else 0
-
-
-def _discover_workspace_root(target: Path) -> Path:
-    current = target if target.is_dir() else target.parent
-    for folder in [current, *current.parents]:
-        if (folder / CONFIG_FILENAME).exists():
-            return folder
-    return current
-
-
-def _print_diagnostics(path: Path, diagnostics: Iterable[types.Diagnostic]) -> None:
-    diags = list(diagnostics)
-    if not diags:
-        print(f"{path}: no issues found")
-        return
-
-    for diag in diags:
-        start = diag.range.start
-        severity = _severity_label(diag.severity)
-        source = diag.source or "avrae-ls"
-        print(f"{path}:{start.line + 1}:{start.character + 1}: {severity} [{source}] {diag.message}")
-
-
-def _severity_label(severity: types.DiagnosticSeverity | None) -> str:
-    if severity is None:
-        return "info"
-    try:
-        return types.DiagnosticSeverity(severity).name.lower()
-    except Exception:
-        return str(severity).lower()
-
-
-if __name__ == "__main__":
-    main()

avrae_ls-0.4.0/src/avrae_ls/alias_preview.py

@@ -1,180 +0,0 @@
-from __future__ import annotations
-
-import re
-import shlex
-from dataclasses import dataclass
-from typing import Any, Optional, Tuple
-
-from .parser import DRACONIC_RE
-from .runtime import ExecutionResult, MockExecutor
-from .context import ContextData, GVarResolver
-from .argument_parsing import apply_argument_parsing
-
-
-@dataclass
-class RenderedAlias:
-    command: str
-    stdout: str
-    error: Optional[BaseException]
-    last_value: Any | None = None
-
-
-def _strip_alias_header(text: str) -> str:
-    lines = text.splitlines()
-    if lines and lines[0].lstrip().startswith("!alias"):
-        first = lines[0].lstrip()
-        parts = first.split(maxsplit=2)
-        remainder = parts[2] if len(parts) > 2 else ""
-        body = "\n".join(lines[1:])
-        if remainder:
-            return remainder + ("\n" + body if body else "")
-        return body
-    return text
-
-
-async def render_alias_command(
-    text: str,
-    executor: MockExecutor,
-    ctx_data: ContextData,
-    resolver: GVarResolver,
-    args: list[str] | None = None,
-) -> RenderedAlias:
-    """Replace <drac2> blocks with their evaluated values and return final command."""
-    body = _strip_alias_header(text)
-    body = apply_argument_parsing(body, args)
-    stdout_parts: list[str] = []
-    parts: list[str] = []
-    last_value = None
-    error: BaseException | None = None
-
-    pos = 0
-    for match in DRACONIC_RE.finditer(body):
-        parts.append(body[pos: match.start()])
-        code = match.group(1)
-        result: ExecutionResult = await executor.run(code, ctx_data, resolver)
-        if result.stdout:
-            stdout_parts.append(result.stdout)
-        if result.error:
-            error = result.error
-            break
-        last_value = result.value
-        parts.append("" if result.value is None else str(result.value))
-        pos = match.end()
-
-    if error is None:
-        parts.append(body[pos:])
-
-    final_command = "".join(parts)
-    return RenderedAlias(command=final_command, stdout="".join(stdout_parts), error=error, last_value=last_value)
-
-
-def validate_embed_payload(payload: str) -> Tuple[bool, str | None]:
-    """
-    Light validation for embed previews using Avrae-style flags.
-
-    Accepts strings such as "-title Foo -f \"T|Body\"" and validates arguments.
-    Returns (is_valid, error_message) without attempting to parse JSON objects.
-    """
-    text = payload.strip()
-    if not text:
-        return False, "Embed payload is empty."
-
-    return _validate_embed_flags(text)
-
-
-def _validate_embed_flags(text: str) -> Tuple[bool, str | None]:
-    """Validate embed flags according to Avrae's help text."""
-    if not text:
-        return False, "Embed payload is empty."
-
-    try:
-        tokens = shlex.split(text)
-    except ValueError as exc:  # pragma: no cover - defensive only
-        return False, f"Embed payload could not be parsed: {exc}"
-
-    flag_handlers = {
-        "-title": lambda val: _require_value("-title", val),
-        "-desc": lambda val: _require_value("-desc", val),
-        "-thumb": lambda val: _require_value("-thumb", val),
-        "-image": lambda val: _require_value("-image", val),
-        "-footer": lambda val: _require_value("-footer", val),
-        "-f": _validate_field_arg,
-        "-color": _validate_color_arg,
-        "-t": _validate_timeout_arg,
-    }
-
-    i = 0
-    while i < len(tokens):
-        tok = tokens[i]
-        key = tok.lower()
-        if not tok.startswith("-"):
-            i += 1
-            continue
-        if key not in flag_handlers:
-            return False, f"Embed payload contains unknown flag '{tok}'."
-        next_val = tokens[i + 1] if i + 1 < len(tokens) else None
-        ok, err, consumed = flag_handlers[key](next_val)
-        if not ok:
-            return False, err
-        i += consumed + 1
-    return True, None
-
-
-def _require_value(flag: str, value: str | None) -> Tuple[bool, str | None, int]:
-    if value is None or value.startswith("-"):
-        return False, f"Embed flag '{flag}' requires a value.", 0
-    return True, None, 1
-
-
-def _validate_field_arg(value: str | None) -> Tuple[bool, str | None, int]:
-    ok, err, consumed = _require_value("-f", value)
-    if not ok:
-        return ok, err, consumed
-    assert value is not None  # for type checker
-    parts = value.split("|")
-    if len(parts) < 2 or len(parts) > 3:
-        return False, "Embed field must be in the form \"Title|Text[|inline]\".", consumed
-    if not parts[0] or not parts[1]:
-        return False, "Embed field title and text cannot be empty.", consumed
-    if len(parts) == 3 and parts[2].lower() not in ("inline", ""):
-        return False, "Embed field inline value must be 'inline' or omitted.", consumed
-    return True, None, consumed
-
-
-def _validate_color_arg(value: str | None) -> Tuple[bool, str | None, int]:
-    if value is None or value.startswith("-"):
-        # Random color is allowed when omitted
-        return True, None, 0
-    if not re.match(r"^(?:#|0x)?[0-9a-fA-F]{6}$", value):
-        return False, "Embed color must be a 6-hex value (e.g. #ff00ff).", 1
-    return True, None, 1
-
-
-def _validate_timeout_arg(value: str | None) -> Tuple[bool, str | None, int]:
-    ok, err, consumed = _require_value("-t", value)
-    if not ok:
-        return ok, err, consumed
-    assert value is not None  # for type checker
-    try:
-        num = int(value)
-    except ValueError:
-        return False, "Embed timeout (-t) must be an integer.", consumed
-    if num < 0 or num > 600:
-        return False, "Embed timeout (-t) must be between 0 and 600 seconds.", consumed
-    return True, None, consumed
-
-
-def simulate_command(command: str) -> tuple[str | None, str | None, str | None]:
-    """Very small shim to preview common commands."""
-    text = command.strip()
-    if not text:
-        return None, None, None
-    head, *rest = text.split(maxsplit=1)
-    payload = rest[0] if rest else ""
-    lowered = head.lower()
-    if lowered == "echo":
-        return payload, "echo", None
-    if lowered == "embed":
-        valid, error = validate_embed_payload(payload)
-        return payload, "embed", error
-    return None, head, None