lumera 0.28.0.dev1__tar.gz → 0.28.0.dev2__tar.gz

{lumera-0.28.0.dev1 → lumera-0.28.0.dev2}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: lumera
-Version: 0.28.0.dev1
+Version: 0.28.0.dev2
 Summary: SDK for building on Lumera platform
 Requires-Python: >=3.11
 Requires-Dist: requests
 Requires-Dist: python-dotenv
 Requires-Dist: google-api-python-client==2.173.0
-Requires-Dist: pydantic<3.0.0,>=2.12.3
 Requires-Dist: simple-salesforce==1.12.6
 Requires-Dist: slack_sdk==3.35.0
 Provides-Extra: dev
@@ -29,6 +28,7 @@ Requires-Dist: openai-agents<1.0.0,>=0.6.5; extra == "full"
 Requires-Dist: openpyxl==3.1.5; extra == "full"
 Requires-Dist: pandas==2.3.0; extra == "full"
 Requires-Dist: pdfplumber; extra == "full"
+Requires-Dist: pydantic<3.0.0,>=2.12.3; extra == "full"
 Requires-Dist: PyGithub==2.6.1; extra == "full"
 Requires-Dist: python-dotenv==1.1.0; extra == "full"
 Requires-Dist: pyzmq; extra == "full"

lumera-0.28.0.dev2/lumera/__init__.py

@@ -0,0 +1,175 @@
+"""
+Lumera Agent SDK
+
+This SDK provides helpers for automations running within the Lumera environment
+to interact with the Lumera API and define dynamic user interfaces.
+"""
+
+from importlib import import_module as _import_module
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("lumera")
+except PackageNotFoundError:
+    __version__ = "unknown"  # Not installed (e.g. running from source)
+
+# Define what ``from lumera import *`` imports. Keep this list stable: callers
+# have historically imported these modules, helpers, types, and exceptions from
+# the package root.
+__all__ = [
+    # Authentication & utilities
+    "Credentials",
+    "get_access_token",
+    "get_credentials",
+    "get_google_access_token",  # Kept for backwards compatibility
+    "list_integration_connections",
+    "list_integrations",
+    "log_timed",
+    # Feature flags (read the sandbox snapshot)
+    "feature_flag",
+    "feature_flags",
+    "is_feature_enabled",
+    # Collections (low-level API)
+    "list_collections",
+    "get_collection",
+    "create_collection",
+    "update_collection",
+    "delete_collection",
+    # Records (low-level API)
+    "list_records",
+    "search_records",
+    "get_record",
+    "get_record_by_external_id",
+    "create_record",
+    "update_record",
+    "upsert_record",
+    "delete_record",
+    # Other operations
+    "replay_hook",
+    "query_sql",
+    "run_automation",
+    "get_automation_run",
+    "update_automation_run",
+    "upload_lumera_file",
+    "save_to_lumera",
+    # Type definitions
+    "CollectionField",
+    "HookReplayResult",
+    "LumeraFile",
+    "LumeraFiles",
+    # Exceptions
+    "LumeraAPIError",
+    "RecordNotUniqueError",
+    "IntegrationNotEnabledForProjectError",
+    "LumeraError",
+    "ValidationError",
+    "UniqueConstraintError",
+    "RecordNotFoundError",
+    # High-level modules (use as lumera.pb, lumera.storage, etc.)
+    "agents",
+    "automations",
+    "email",
+    "pb",
+    "storage",
+    "llm",
+    "exceptions",
+    "webhooks",
+    "integrations",
+]
+
+# Importing the package root used to import every SDK module, including all
+# feature-specific integration clients. Resolve the same public API on first
+# access so existing import statements retain their behavior without paying
+# that cost when the corresponding feature is unused.
+_LAZY_MODULES = {
+    "_utils": "._utils",
+    "agents": ".agents",
+    "automations": ".automations",
+    "email": ".email",
+    "exceptions": ".exceptions",
+    "files": ".files",
+    "flags": ".flags",
+    "integrations": ".integrations",
+    "llm": ".llm",
+    "pb": ".pb",
+    "sdk": ".sdk",
+    "storage": ".storage",
+    "webhooks": ".webhooks",
+}
+
+_LAZY_ATTRIBUTES = {
+    # ._utils
+    "Credentials": ("._utils", "Credentials"),
+    "IntegrationNotEnabledForProjectError": (
+        "._utils",
+        "IntegrationNotEnabledForProjectError",
+    ),
+    "LumeraAPIError": ("._utils", "LumeraAPIError"),
+    "RecordNotUniqueError": ("._utils", "RecordNotUniqueError"),
+    "get_access_token": ("._utils", "get_access_token"),
+    "get_credentials": ("._utils", "get_credentials"),
+    "get_google_access_token": ("._utils", "get_google_access_token"),
+    "list_integration_connections": ("._utils", "list_integration_connections"),
+    "list_integrations": ("._utils", "list_integrations"),
+    "log_timed": ("._utils", "log_timed"),
+    # .exceptions
+    "LumeraError": (".exceptions", "LumeraError"),
+    "RecordNotFoundError": (".exceptions", "RecordNotFoundError"),
+    "UniqueConstraintError": (".exceptions", "UniqueConstraintError"),
+    "ValidationError": (".exceptions", "ValidationError"),
+    # .files
+    "LumeraFile": (".files", "LumeraFile"),
+    "LumeraFiles": (".files", "LumeraFiles"),
+    # .flags
+    "feature_flag": (".flags", "feature_flag"),
+    "feature_flags": (".flags", "feature_flags"),
+    "is_feature_enabled": (".flags", "is_feature_enabled"),
+    # .sdk
+    "CollectionField": (".sdk", "CollectionField"),
+    "HookReplayResult": (".sdk", "HookReplayResult"),
+    "create_collection": (".sdk", "create_collection"),
+    "create_record": (".sdk", "create_record"),
+    "delete_collection": (".sdk", "delete_collection"),
+    "delete_record": (".sdk", "delete_record"),
+    "get_automation_run": (".sdk", "get_automation_run"),
+    "get_collection": (".sdk", "get_collection"),
+    "get_record": (".sdk", "get_record"),
+    "get_record_by_external_id": (".sdk", "get_record_by_external_id"),
+    "list_collections": (".sdk", "list_collections"),
+    "list_records": (".sdk", "list_records"),
+    "query_sql": (".sdk", "query_sql"),
+    "replay_hook": (".sdk", "replay_hook"),
+    "run_automation": (".sdk", "run_automation"),
+    "save_to_lumera": (".sdk", "save_to_lumera"),
+    "search_records": (".sdk", "search_records"),
+    "update_automation_run": (".sdk", "update_automation_run"),
+    "update_collection": (".sdk", "update_collection"),
+    "update_record": (".sdk", "update_record"),
+    "upload_lumera_file": (".sdk", "upload_lumera_file"),
+    "upsert_record": (".sdk", "upsert_record"),
+}
+
+
+def __getattr__(name: str) -> object:
+    """Load a root SDK export the first time it is requested."""
+
+    module_name = _LAZY_MODULES.get(name)
+    if module_name is not None:
+        value = _import_module(module_name, __name__)
+        globals()[name] = value
+        return value
+
+    attribute = _LAZY_ATTRIBUTES.get(name)
+    if attribute is not None:
+        module_name, attribute_name = attribute
+        value = getattr(_import_module(module_name, __name__), attribute_name)
+        globals()[name] = value
+        return value
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    """Include lazily available exports in interactive discovery."""
+
+    return sorted(set(globals()) | set(__all__) | set(_LAZY_MODULES))

{lumera-0.28.0.dev1 → lumera-0.28.0.dev2}/lumera/integrations/netsuite.py

@@ -3,9 +3,9 @@ Lumera NetSuite Integration
 
 Provides two NetSuite clients:
 
-* :class:`NetSuiteProxyClient` is recommended for new code. It routes requests
-  through Lumera's integration proxy, so NetSuite credentials stay inside the
-  Lumera backend.
+* :class:`NetSuiteProxyClient` is recommended for new code. It routes SuiteQL,
+  REST records, and RESTlets through Lumera's integration proxy, so NetSuite
+  credentials stay inside the Lumera backend.
 * :class:`NetSuiteClient` preserves the existing direct-call behavior for
   backward compatibility. It downloads the NetSuite access token into the
   automation process and calls SuiteTalk directly.
@@ -99,6 +99,10 @@ def _base_url(account_id: str) -> str:
     return f"https://{account_id.lower()}.suitetalk.api.netsuite.com"
 
 
+def _restlet_base_url(account_id: str) -> str:
+    return f"https://{account_id.lower()}.restlets.api.netsuite.com"
+
+
 def _fetch_account_id(api_name: str) -> str:
     """Resolve the NetSuite account ID from connection metadata (no secrets)."""
     cached = _account_id_cache.get(api_name)
@@ -417,6 +421,39 @@ class NetSuiteProxyClient:
             timeout=self._timeout,
         )
 
+    def call_restlet(
+        self,
+        script_id: str | int,
+        deployment_id: str | int,
+        *,
+        method: str = "POST",
+        body: dict[str, Any] | list[Any] | str | None = None,
+        headers: dict[str, str] | None = None,
+        params: dict[str, Any] | None = None,
+    ) -> requests.Response:
+        """Call a deployed RESTlet through Lumera's integration proxy.
+
+        RESTlet access must first be enabled for the NetSuite connection in
+        Lumera. The raw response is returned so callers can handle each
+        RESTlet's custom response format.
+        """
+        query: dict[str, Any] = {
+            "script": script_id,
+            "deploy": deployment_id,
+        }
+        for key, value in (params or {}).items():
+            if key not in query:
+                query[key] = value
+        url = f"{_restlet_base_url(self.account_id)}/app/site/hosting/restlet.nl?{urlencode(query)}"
+        return _proxy_request(
+            self._api_name,
+            method.upper(),
+            url,
+            body=body,
+            headers=headers,
+            timeout=self._timeout,
+        )
+
     # ── SuiteQL ──────────────────────────────────────────────────────────
 
     def suiteql(

{lumera-0.28.0.dev1 → lumera-0.28.0.dev2}/lumera.egg-info/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: lumera
-Version: 0.28.0.dev1
+Version: 0.28.0.dev2
 Summary: SDK for building on Lumera platform
 Requires-Python: >=3.11
 Requires-Dist: requests
 Requires-Dist: python-dotenv
 Requires-Dist: google-api-python-client==2.173.0
-Requires-Dist: pydantic<3.0.0,>=2.12.3
 Requires-Dist: simple-salesforce==1.12.6
 Requires-Dist: slack_sdk==3.35.0
 Provides-Extra: dev
@@ -29,6 +28,7 @@ Requires-Dist: openai-agents<1.0.0,>=0.6.5; extra == "full"
 Requires-Dist: openpyxl==3.1.5; extra == "full"
 Requires-Dist: pandas==2.3.0; extra == "full"
 Requires-Dist: pdfplumber; extra == "full"
+Requires-Dist: pydantic<3.0.0,>=2.12.3; extra == "full"
 Requires-Dist: PyGithub==2.6.1; extra == "full"
 Requires-Dist: python-dotenv==1.1.0; extra == "full"
 Requires-Dist: pyzmq; extra == "full"

{lumera-0.28.0.dev1 → lumera-0.28.0.dev2}/lumera.egg-info/SOURCES.txt

@@ -19,11 +19,6 @@ lumera.egg-info/SOURCES.txt
 lumera.egg-info/dependency_links.txt
 lumera.egg-info/requires.txt
 lumera.egg-info/top_level.txt
-lumera/functions/__init__.py
-lumera/functions/__main__.py
-lumera/functions/_bundle.py
-lumera/functions/_core.py
-lumera/functions/_runner.py
 lumera/integrations/__init__.py
 lumera/integrations/bill.py
 lumera/integrations/google.py
@@ -33,8 +28,8 @@ lumera/integrations/slack.py
 tests/test_agents_live.py
 tests/test_automations.py
 tests/test_flags.py
-tests/test_functions.py
 tests/test_integrations_netsuite.py
 tests/test_integrations_salesforce.py
+tests/test_lazy_imports.py
 tests/test_sdk.py
 tests/test_webhooks.py

{lumera-0.28.0.dev1 → lumera-0.28.0.dev2}/pyproject.toml

@@ -1,13 +1,12 @@
 [project]
 name = "lumera"
-version = "0.28.0.dev1"
+version = "0.28.0.dev2"
 description = "SDK for building on Lumera platform"
 requires-python = ">=3.11"
 dependencies = [
     "requests",
     "python-dotenv",
     "google-api-python-client==2.173.0",
-    "pydantic>=2.12.3,<3.0.0",
     "simple-salesforce==1.12.6",
     "slack_sdk==3.35.0",
 ]
@@ -37,6 +36,7 @@ full = [
     "openpyxl==3.1.5",
     "pandas==2.3.0",
     "pdfplumber",
+    "pydantic>=2.12.3,<3.0.0",
     "PyGithub==2.6.1",
     "python-dotenv==1.1.0",
     "pyzmq",

{lumera-0.28.0.dev1 → lumera-0.28.0.dev2}/tests/test_integrations_netsuite.py

@@ -177,6 +177,33 @@ def test_proxy_client_request_builds_url_with_params(monkeypatch: pytest.MonkeyP
     assert "body" not in payload
 
 
+def test_proxy_client_call_restlet_uses_restlet_host(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    session = MockSession(proxy_responses=[DummyResponse(json_data={"fileId": "42"})])
+    _install(monkeypatch, session)
+
+    ns = netsuite.NetSuiteProxyClient(api_name="netsuite_prod", timeout=120)
+    resp = ns.call_restlet(
+        990,
+        1,
+        body={"journalEntryId": "123"},
+        params={"mode": "attach"},
+    )
+
+    assert resp.json() == {"fileId": "42"}
+    call = session.post_calls[0]
+    payload = call["json"]
+    assert payload["api_name"] == "netsuite_prod"
+    assert payload["method"] == "POST"
+    assert payload["url"] == (
+        "https://12345_sb1.restlets.api.netsuite.com"
+        "/app/site/hosting/restlet.nl?script=990&deploy=1&mode=attach"
+    )
+    assert payload["body"] == {"journalEntryId": "123"}
+    assert payload["timeout_seconds"] == 120
+
+
 def test_proxy_timeout_is_bounded_and_requires_positive_value(
     monkeypatch: pytest.MonkeyPatch,
 ) -> None:

lumera-0.28.0.dev2/tests/test_lazy_imports.py

@@ -0,0 +1,230 @@
+import json
+import subprocess
+import sys
+from textwrap import dedent
+
+EXPECTED_ROOT_EXPORTS = {
+    "CollectionField",
+    "Credentials",
+    "HookReplayResult",
+    "IntegrationNotEnabledForProjectError",
+    "LumeraAPIError",
+    "LumeraError",
+    "LumeraFile",
+    "LumeraFiles",
+    "RecordNotFoundError",
+    "RecordNotUniqueError",
+    "UniqueConstraintError",
+    "ValidationError",
+    "agents",
+    "automations",
+    "create_collection",
+    "create_record",
+    "delete_collection",
+    "delete_record",
+    "email",
+    "exceptions",
+    "feature_flag",
+    "feature_flags",
+    "get_access_token",
+    "get_automation_run",
+    "get_collection",
+    "get_credentials",
+    "get_google_access_token",
+    "get_record",
+    "get_record_by_external_id",
+    "integrations",
+    "is_feature_enabled",
+    "list_collections",
+    "list_integration_connections",
+    "list_integrations",
+    "list_records",
+    "llm",
+    "log_timed",
+    "pb",
+    "query_sql",
+    "replay_hook",
+    "run_automation",
+    "save_to_lumera",
+    "search_records",
+    "storage",
+    "update_automation_run",
+    "update_collection",
+    "update_record",
+    "upload_lumera_file",
+    "upsert_record",
+    "webhooks",
+}
+
+
+def _run_isolated(script: str) -> dict:
+    completed = subprocess.run(
+        [sys.executable, "-c", dedent(script)],
+        check=True,
+        capture_output=True,
+        text=True,
+    )
+    return json.loads(completed.stdout)
+
+
+def test_public_root_export_contract_is_unchanged() -> None:
+    import lumera
+
+    assert set(lumera.__all__) == EXPECTED_ROOT_EXPORTS
+    assert EXPECTED_ROOT_EXPORTS <= set(dir(lumera))
+
+
+def test_importing_package_root_does_not_load_feature_modules() -> None:
+    result = _run_isolated(
+        """
+        import json
+        import sys
+
+        import lumera
+
+        watched = [
+            "lumera.agents",
+            "lumera.automations",
+            "lumera.integrations",
+            "lumera.llm",
+            "lumera.pb",
+            "lumera.sdk",
+            "googleapiclient",
+            "simple_salesforce",
+        ]
+        print(json.dumps({
+            "loaded": [name for name in watched if name in sys.modules],
+            "has_version": bool(lumera.__version__),
+        }))
+        """
+    )
+
+    assert result == {"loaded": [], "has_version": True}
+
+
+def test_accessing_root_helper_loads_only_its_defining_module() -> None:
+    result = _run_isolated(
+        """
+        import json
+        import sys
+
+        import lumera
+
+        helper = lumera.get_credentials
+        from lumera._utils import get_credentials
+
+        print(json.dumps({
+            "same_helper": helper is get_credentials,
+            "utils_loaded": "lumera._utils" in sys.modules,
+            "integrations_loaded": "lumera.integrations" in sys.modules,
+            "google_loaded": "googleapiclient" in sys.modules,
+            "salesforce_loaded": "simple_salesforce" in sys.modules,
+        }))
+        """
+    )
+
+    assert result == {
+        "same_helper": True,
+        "utils_loaded": True,
+        "integrations_loaded": False,
+        "google_loaded": False,
+        "salesforce_loaded": False,
+    }
+
+
+def test_existing_root_exports_resolve_to_original_objects() -> None:
+    result = _run_isolated(
+        """
+        import json
+
+        import lumera
+        from lumera import (
+            LumeraFile,
+            RecordNotFoundError,
+            agents,
+            automations,
+            create_record,
+            feature_flag,
+            integrations,
+        )
+        from lumera.exceptions import RecordNotFoundError as DirectRecordNotFoundError
+        from lumera.files import LumeraFile as DirectLumeraFile
+        from lumera.flags import feature_flag as direct_feature_flag
+        from lumera.sdk import create_record as direct_create_record
+
+        print(json.dumps({
+            "agents": agents is lumera.agents,
+            "automations": automations is lumera.automations,
+            "integrations": integrations is lumera.integrations,
+            "create_record": create_record is direct_create_record,
+            "feature_flag": feature_flag is direct_feature_flag,
+            "file_type": LumeraFile is DirectLumeraFile,
+            "exception": RecordNotFoundError is DirectRecordNotFoundError,
+        }))
+        """
+    )
+
+    assert all(result.values())
+
+
+def test_legacy_root_module_attributes_remain_available() -> None:
+    result = _run_isolated(
+        """
+        import importlib
+        import json
+
+        import lumera
+
+        module_names = ["_utils", "files", "flags", "sdk"]
+        print(json.dumps({
+            name: getattr(lumera, name) is importlib.import_module(f"lumera.{name}")
+            for name in module_names
+        }))
+        """
+    )
+
+    assert all(result.values())
+
+
+def test_star_import_retains_the_existing_public_api() -> None:
+    result = _run_isolated(
+        """
+        import json
+
+        import lumera
+
+        expected = set(lumera.__all__)
+        namespace = {}
+        exec("from lumera import *", namespace)
+
+        print(json.dumps({
+            "missing": sorted(expected - namespace.keys()),
+            "unexpected": sorted(
+                name for name in namespace if not name.startswith("__") and name not in expected
+            ),
+        }))
+        """
+    )
+
+    assert result == {"missing": [], "unexpected": []}
+
+
+def test_unknown_root_attribute_raises_standard_attribute_error() -> None:
+    result = _run_isolated(
+        """
+        import json
+
+        import lumera
+
+        try:
+            lumera.not_a_real_sdk_export
+        except AttributeError as exc:
+            error = str(exc)
+        else:
+            error = ""
+
+        print(json.dumps({"error": error}))
+        """
+    )
+
+    assert result == {"error": "module 'lumera' has no attribute 'not_a_real_sdk_export'"}