wexample-wex-addon-dev-javascript 7.10.10__tar.gz → 7.11.0__tar.gz

{wexample_wex_addon_dev_javascript-7.10.10 → wexample_wex_addon_dev_javascript-7.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-javascript
-Version: 7.10.10
+Version: 7.11.0
 Summary: Python dev addon for wex
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -11,8 +11,10 @@ Project-URL: homepage, https://github.com/wexample/python-wex-dev-python
 Requires-Python: >=3.10
 Requires-Dist: attrs>=23.1.0
 Requires-Dist: cattrs>=23.1.0
+Requires-Dist: wexample-api>=6.2.0
 Requires-Dist: wexample-filestate-javascript>=6.3.0
-Requires-Dist: wexample-wex-addon-app>=22.0.0
+Requires-Dist: wexample-wex-addon-ai>=8.0.0
+Requires-Dist: wexample-wex-addon-app>=23.0.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -20,7 +22,7 @@ Description-Content-Type: text/markdown
 
 # wex_addon_dev_javascript
 
-Version: 7.10.10
+Version: 7.11.0
 
 Python dev addon for wex
 
@@ -102,8 +104,10 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 
 - attrs: >=23.1.0
 - cattrs: >=23.1.0
+- wexample-api: >=6.2.0
 - wexample-filestate-javascript: >=6.3.0
-- wexample-wex-addon-app: >=22.0.0
+- wexample-wex-addon-ai: >=8.0.0
+- wexample-wex-addon-app: >=23.0.0
 
 ## Versioning & Compatibility Policy
 

{wexample_wex_addon_dev_javascript-7.10.10 → wexample_wex_addon_dev_javascript-7.11.0}/README.md

@@ -1,6 +1,6 @@
 # wex_addon_dev_javascript
 
-Version: 7.10.10
+Version: 7.11.0
 
 Python dev addon for wex
 
@@ -82,8 +82,10 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 
 - attrs: >=23.1.0
 - cattrs: >=23.1.0
+- wexample-api: >=6.2.0
 - wexample-filestate-javascript: >=6.3.0
-- wexample-wex-addon-app: >=22.0.0
+- wexample-wex-addon-ai: >=8.0.0
+- wexample-wex-addon-app: >=23.0.0
 
 ## Versioning & Compatibility Policy
 

{wexample_wex_addon_dev_javascript-7.10.10 → wexample_wex_addon_dev_javascript-7.11.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-javascript"
-version = "7.10.10"
+version = "7.11.0"
 description = "Python dev addon for wex"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -20,8 +20,10 @@ classifiers = [
 dependencies = [
     "attrs>=23.1.0",
     "cattrs>=23.1.0",
+    "wexample-api>=6.2.0",
     "wexample-filestate-javascript>=6.3.0",
-    "wexample-wex-addon-app>=22.0.0",
+    "wexample-wex-addon-ai>=8.0.0",
+    "wexample-wex-addon-app>=23.0.0",
 ]
 
 [project.readme]

wexample_wex_addon_dev_javascript-7.11.0/src/wexample_wex_addon_dev_javascript/common/npm_registry_gateway.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+from wexample_api.common.abstract_gateway import AbstractGateway
+from wexample_helpers.classes.field import public_field
+from wexample_helpers.decorator.base_class import base_class
+
+
+@base_class
+class NpmRegistryGateway(AbstractGateway):
+    """Thin HTTP gateway over an npm registry JSON API.
+
+    Targets public npm (`https://registry.npmjs.org`) and private registries
+    that expose the same package-manifest layout (e.g. GitLab npm registry).
+    Optional Bearer auth via `token`.
+    """
+
+    token: str | None = public_field(
+        default=None,
+        description="Optional Bearer token for private registries.",
+    )
+
+    def __attrs_post_init__(self) -> None:
+        super().__attrs_post_init__()
+        if self.token:
+            self.default_headers["Authorization"] = f"Bearer {self.token}"
+
+    def has_version(self, package: str, version: str) -> bool:
+        """Return True iff `package@version` is published on this registry.
+
+        Fetches the package manifest and looks up the version in the
+        `versions` map — works for both public npm and private (GitLab)
+        registries that don't expose per-version URLs. Returns False on
+        404 (unknown package or version not yet propagated).
+        """
+        encoded = package.replace("/", "%2F")
+        response = self.make_request(
+            endpoint=encoded,
+            expected_status_codes=[200, 404],
+            fatal_if_unexpected=False,
+            quiet=True,
+        )
+        if response is None or response.status_code != 200:
+            return False
+        return version in (response.json().get("versions") or {})

wexample_wex_addon_dev_javascript-7.11.0/src/wexample_wex_addon_dev_javascript/const/tags.py

@@ -0,0 +1,11 @@
+"""Domain tags exposed by this addon — one entry per `domain:*` value its commands use."""
+
+from __future__ import annotations
+
+
+class DomainTag:
+    """Functional domain this addon's commands touch."""
+
+    DEV_SERVER = "domain:dev-server"
+    FRONTEND = "domain:frontend"
+    SERVICE = "domain:service"

{wexample_wex_addon_dev_javascript-7.10.10 → wexample_wex_addon_dev_javascript-7.11.0}/src/wexample_wex_addon_dev_javascript/services/vite/commands/service/install.py

@@ -2,9 +2,12 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+from wexample_cli.const.tags import AudienceTag, EffectTag, ScopeTag
 from wexample_cli.decorator.command import command
 from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
 
+from wexample_wex_addon_dev_javascript.const.tags import DomainTag
+
 if TYPE_CHECKING:
     from wexample_cli.context.execution_context import ExecutionContext
     from wexample_wex_addon_app.service.app_service import AppService
@@ -13,6 +16,15 @@ if TYPE_CHECKING:
 @command(
     type=COMMAND_TYPE_SERVICE,
     description="Patch vite.config.ts to allow all hosts (needed behind a reverse proxy)",
+    tags=[
+        DomainTag.DEV_SERVER,
+        DomainTag.FRONTEND,
+        DomainTag.SERVICE,
+        EffectTag.WRITE,
+        AudienceTag.AGENT_SAFE,
+        ScopeTag.APP,
+        ScopeTag.LOCAL,
+    ],
 )
 def vite__service__install(
     context: ExecutionContext,

{wexample_wex_addon_dev_javascript-7.10.10 → wexample_wex_addon_dev_javascript-7.11.0}/src/wexample_wex_addon_dev_javascript/services/vite/commands/service/ready.py

@@ -2,9 +2,12 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+from wexample_cli.const.tags import AudienceTag, EffectTag, ScopeTag
 from wexample_cli.decorator.command import command
 from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
 
+from wexample_wex_addon_dev_javascript.const.tags import DomainTag
+
 if TYPE_CHECKING:
     from wexample_app.response.boolean_response import BooleanResponse
     from wexample_cli.context.execution_context import ExecutionContext
@@ -12,7 +15,20 @@ if TYPE_CHECKING:
 
 
 @command(
-    type=COMMAND_TYPE_SERVICE, description="Check if the Vite dev server is responding"
+    type=COMMAND_TYPE_SERVICE,
+    description="Check if the Vite dev server is responding",
+    tags=[
+        DomainTag.DEV_SERVER,
+        DomainTag.FRONTEND,
+        DomainTag.SERVICE,
+        EffectTag.IDEMPOTENT,
+        EffectTag.NETWORK_CALL,
+        EffectTag.READ_ONLY,
+        EffectTag.SUBPROCESS_SPAWN,
+        AudienceTag.AGENT_SAFE,
+        ScopeTag.APP,
+        ScopeTag.LOCAL,
+    ],
 )
 def vite__service__ready(
     context: ExecutionContext,

{wexample_wex_addon_dev_javascript-7.10.10 → wexample_wex_addon_dev_javascript-7.11.0}/src/wexample_wex_addon_dev_javascript/workdir/javascript_package_workdir.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+from wexample_helpers.decorator.base_class import base_class
 from wexample_helpers.helpers.string import string_to_kebab_case
 from wexample_helpers_git.helpers.git import (
     git_tag_annotated,
@@ -22,6 +23,7 @@ if TYPE_CHECKING:
     )
 
 
+@base_class
 class JavascriptPackageWorkdir(JavascriptWorkdir):
     def get_package_dependency_name(self) -> str:
         return self.get_package_import_name()
@@ -155,45 +157,33 @@ class JavascriptPackageWorkdir(JavascriptWorkdir):
     def _wait_for_registry(self) -> None:
         """Poll the configured npm registry until the current version is available (max 20 min).
 
-        Fetches the package manifest and checks for the version in 'versions' — compatible
-        with both public npm and private registries (e.g. GitLab) that don't expose
-        per-version URLs.
+        Works for both public npm and private registries (e.g. GitLab) that
+        don't expose per-version URLs — relies on the package manifest's
+        `versions` map.
         """
-        import json
-        import urllib.error
-        import urllib.request
-
         from wexample_helpers.helpers.polling_callback_manager import (
             PollingCallbackManager,
         )
 
+        from wexample_wex_addon_dev_javascript.common.npm_registry_gateway import (
+            NpmRegistryGateway,
+        )
+
         package = self.get_project_name()
         version = self.get_setup_version()
 
         registry_base = (
             self.get_runtime_config().search("npm.registry_url").get_str_or_none()
+            or "https://registry.npmjs.org"
         )
         token = self.get_runtime_config().search("npm.api_token").get_str_or_none()
 
-        encoded = package.replace("/", "%2F")
-        url = f"{(registry_base or 'https://registry.npmjs.org').rstrip('/')}/{encoded}"
-
-        def check_available() -> bool | None:
-            try:
-                req = urllib.request.Request(url)
-                if token:
-                    req.add_header("Authorization", f"Bearer {token}")
-                with urllib.request.urlopen(req, timeout=10) as resp:
-                    if resp.status == 200:
-                        data = json.loads(resp.read())
-                        if version in data.get("versions", {}):
-                            return True
-            except urllib.error.HTTPError as e:
-                if e.code != 404:
-                    raise
-            except Exception:
-                pass
-            return None
+        gateway = NpmRegistryGateway(
+            base_url=registry_base,
+            token=token,
+            io=self.io,
+            timeout=10,
+        )
 
         max_attempts = 40
         delay_seconds = 30
@@ -206,7 +196,7 @@ class JavascriptPackageWorkdir(JavascriptWorkdir):
             )
 
         PollingCallbackManager(
-            callback=check_available,
+            callback=lambda: True if gateway.has_version(package, version) else None,
             max_attempts=max_attempts,
             delay_seconds_callback=lambda _attempt: delay_seconds,
             on_retry_callback=on_retry,

{wexample_wex_addon_dev_javascript-7.10.10 → wexample_wex_addon_dev_javascript-7.11.0}/src/wexample_wex_addon_dev_javascript/workdir/javascript_packages_suite_workdir.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+from wexample_helpers.decorator.base_class import base_class
 from wexample_wex_addon_app.workdir.framework_packages_suite_workdir import (
     FrameworkPackageSuiteWorkdir,
 )
@@ -12,6 +13,7 @@ if TYPE_CHECKING:
     from wexample_wex_addon_app.workdir.code_base_workdir import CodeBaseWorkdir
 
 
+@base_class
 class JavascriptPackagesSuiteWorkdir(FrameworkPackageSuiteWorkdir):
     def _child_is_package_directory(self, entry: Path) -> bool:
         return entry.is_dir() and (entry / "package.json").is_file()

{wexample_wex_addon_dev_javascript-7.10.10 → wexample_wex_addon_dev_javascript-7.11.0}/src/wexample_wex_addon_dev_javascript/workdir/javascript_workdir.py

@@ -5,6 +5,10 @@ from typing import TYPE_CHECKING
 from wexample_config.options_provider.abstract_options_provider import (
     AbstractOptionsProvider,
 )
+from wexample_helpers.decorator.base_class import base_class
+from wexample_wex_addon_ai.workdir.mixin.with_ai_workdir_mixin import (
+    WithAiWorkdirMixin,
+)
 from wexample_wex_addon_app.workdir.code_base_workdir import CodeBaseWorkdir
 
 if TYPE_CHECKING:
@@ -18,7 +22,8 @@ if TYPE_CHECKING:
     )
 
 
-class JavascriptWorkdir(CodeBaseWorkdir):
+@base_class
+class JavascriptWorkdir(WithAiWorkdirMixin, CodeBaseWorkdir):
     def get_app_config_file(self, reload: bool = True) -> JavascriptPackageJsonFile:
         from wexample_wex_addon_dev_javascript.file.javascript_package_json_file import (
             JavascriptPackageJsonFile,
@@ -63,6 +68,8 @@ class JavascriptWorkdir(CodeBaseWorkdir):
 
         raw_value = super().prepare_value(raw_value=raw_value)
 
+        self.append_agents(config=raw_value)
+
         # Ensure a package.json file exists for any JavaScript package project
         children = raw_value["children"]