lambda-api-decorators-cdk 0.4.6__tar.gz → 0.4.7__tar.gz

{lambda_api_decorators_cdk-0.4.6 → lambda_api_decorators_cdk-0.4.7}/.github/workflows/release.yml

@@ -81,5 +81,8 @@ jobs:
           print(f"Wheel metadata version: {metadata['Version']}")
           PY
 
+      - name: Verify packaged API contract
+        run: python tests/verify_contract_artifacts.py dist
+
       - name: Publish distributions to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1

{lambda_api_decorators_cdk-0.4.6 → lambda_api_decorators_cdk-0.4.7}/AGENTS.md

@@ -230,3 +230,11 @@ Keep public APIs intentionally small.
 When an implementation detail is not useful to callers, keep it private.
 
 If repository behavior contradicts an assumption in the task, report the conflict rather than silently redesigning unrelated code.
+
+## Packaged contract
+
+When available, use `lambda-api-decorators-development` and load the local
+`_agent/api-contract.json` and `_agent/behavior.md` before changing public
+behavior. Public changes update the contract and focused tests together; the
+contract contains no package version or future release. Validate focused and
+full tests, `compileall`, built artifacts, and `git diff --check`.

{lambda_api_decorators_cdk-0.4.6 → lambda_api_decorators_cdk-0.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lambda-api-decorators-cdk
-Version: 0.4.6
+Version: 0.4.7
 Summary: AWS CDK integration for Lambda API Decorators. Generate AWS Lambda and API Gateway infrastructure from decorated Python handlers.
 Author: Mateo Marcos, Emanuel Arguinarena, Lucas Picchi
 License: MIT License

{lambda_api_decorators_cdk-0.4.6 → lambda_api_decorators_cdk-0.4.7}/pyproject.toml

@@ -99,6 +99,9 @@ Repository = "https://github.com/infrastructure-as-decorator/lambda-api-decorato
 # If you are using a different build backend, you will need to change this.
 [tool.setuptools]
 
+[tool.setuptools.package-data]
+lambda_api_decorators_cdk = ["_agent/api-contract.json", "_agent/behavior.md"]
+
 [tool.setuptools_scm]
 tag_regex = '^v(?P<version>[0-9]+\.[0-9]+\.[0-9]+)$'
 

lambda_api_decorators_cdk-0.4.7/src/lambda_api_decorators_cdk/_agent/api-contract.json

@@ -0,0 +1,23 @@
+{
+  "schema_version": "1.0",
+  "distribution": "lambda-api-decorators-cdk",
+  "import_package": "lambda_api_decorators_cdk",
+  "exports": ["ApiType", "SourceLayout", "LambdaApi", "LambdaApiConfig", "ResourceBuilder"],
+  "functions": [],
+  "decorators": [],
+  "classes": [
+    {"name": "ApiType", "signature": "ApiType", "methods": [], "members": [{"name": "REST", "value": "rest"}, {"name": "HTTP", "value": "http"}]},
+    {"name": "SourceLayout", "signature": "SourceLayout", "methods": [], "members": [{"name": "ROOT", "value": "root"}, {"name": "SERVICE", "value": "service"}]},
+    {"name": "LambdaApi", "signature": "LambdaApi(scope: Construct, construct_id: str, *, lambda_path: str, source_layout: SourceLayout = SourceLayout.ROOT, layers_path: Optional[str] = None, api = None, api_type: Optional[ApiType] = None, config: Optional[LambdaApiConfig] = None)", "methods": [{"name": "api", "kind": "property", "returns": {"type": "IRestApi | HttpApi"}}, {"name": "api_type", "kind": "property", "returns": {"type": "ApiType"}}]},
+    {"name": "LambdaApiConfig", "signature": "LambdaApiConfig(*, runtime=None, timeout=None, memory_size=None, vpc=None, vpc_subnets=None, role=None, layers=None, security_groups=None, environment=None, dynamodb_tables=None, s3_buckets=None, authorizers=None, default_authorizer=None, default_runtime=None, default_role=None, common_environment=None, role_registry=None, environment_registry=None, layer_registry=None, security_group_registry=None, vpc_registry=None, dynamodb_table_registry=None, s3_bucket_registry=None, authorizer_registry=None)", "methods": [
+      {"name": "set_default_runtime", "signature": "set_default_runtime(runtime: Optional[Runtime]) -> None"}, {"name": "set_default_timeout", "signature": "set_default_timeout(timeout: Optional[Duration]) -> None"}, {"name": "set_default_memory_size", "signature": "set_default_memory_size(memory_size: Optional[int]) -> None"}, {"name": "set_default_vpc", "signature": "set_default_vpc(vpc: Optional[IVpc], vpc_subnets: Optional[SubnetSelection] = None) -> None"}, {"name": "set_default_role", "signature": "set_default_role(role: Optional[IRole]) -> None"},
+      {"name": "add_common_layer", "signature": "add_common_layer(layer: ILayerVersion) -> None"}, {"name": "add_common_security_group", "signature": "add_common_security_group(security_group: ISecurityGroup) -> None"}, {"name": "add_custom_runtime", "signature": "add_custom_runtime(key: str, runtime: Runtime) -> None"}, {"name": "add_custom_role", "signature": "add_custom_role(key: str, role: IRole) -> None"}, {"name": "add_custom_layer", "signature": "add_custom_layer(key: str, layer: ILayerVersion) -> None"}, {"name": "add_custom_environment", "signature": "add_custom_environment(key: str, value: str) -> None"}, {"name": "add_custom_security_group", "signature": "add_custom_security_group(key: str, security_group: ISecurityGroup) -> None"}, {"name": "add_custom_vpc", "signature": "add_custom_vpc(key: str, vpc: IVpc, vpc_subnets: Optional[SubnetSelection] = None) -> None"},
+      {"name": "add_dynamodb_table", "signature": "add_dynamodb_table(key: str, table: ITable) -> None"}, {"name": "add_s3_bucket", "signature": "add_s3_bucket(key: str, bucket: IBucket) -> None"}, {"name": "add_authorizer", "signature": "add_authorizer(key: str, authorizer: object) -> None"}, {"name": "register_role", "signature": "register_role(key: str, role: IRole) -> None"}, {"name": "register_environment", "signature": "register_environment(key: str, value: Mapping[str, str]) -> None"}, {"name": "register_layer", "signature": "register_layer(key: str, layer: ILayerVersion) -> None"}, {"name": "register_security_group", "signature": "register_security_group(key: str, security_group: ISecurityGroup) -> None"}, {"name": "register_vpc", "signature": "register_vpc(key: str, vpc: IVpc, vpc_subnets: Optional[SubnetSelection] = None) -> None"}, {"name": "register_dynamodb_table", "signature": "register_dynamodb_table(key: str, table: ITable) -> None"}, {"name": "register_s3_bucket", "signature": "register_s3_bucket(key: str, bucket: IBucket) -> None"}, {"name": "register_authorizer", "signature": "register_authorizer(key: str, authorizer: object) -> None"}, {"name": "set_default_authorizer", "signature": "set_default_authorizer(key: Optional[str]) -> None"}
+    ]},
+    {"name": "ResourceBuilder", "signature": "ResourceBuilder(default_runtime=None, default_timeout=None, default_memory_size=None, default_vpc=None, default_role=None, common_layers=None, common_security_groups=None, common_environments=None, custom_runtimes=None, custom_roles=None, custom_layers=None, custom_environments=None, custom_security_groups=None, custom_vpcs=None, dynamodb_tables=None, s3_buckets=None, authorizers=None, default_authorizer=None)", "methods": [
+      {"name": "set_default_runtime"}, {"name": "set_default_timeout"}, {"name": "set_default_memory_size"}, {"name": "set_default_vpc"}, {"name": "set_default_role"}, {"name": "add_common_layer"}, {"name": "add_common_security_group"}, {"name": "add_custom_vpc"}, {"name": "add_custom_environment"}, {"name": "add_custom_runtime"}, {"name": "add_custom_role"}, {"name": "add_custom_layer"}, {"name": "add_custom_security_group"}, {"name": "get_default_runtime"}, {"name": "get_default_timeout"}, {"name": "get_default_memory_size"}, {"name": "get_default_vpc"}, {"name": "get_default_role"}, {"name": "get_common_layers"}, {"name": "get_common_layer"}, {"name": "get_common_security_groups"}, {"name": "get_common_security_group"}, {"name": "get_common_environments"}, {"name": "get_common_environment"}, {"name": "get_custom_layer"}, {"name": "get_custom_roles"}, {"name": "get_custom_role"}, {"name": "get_custom_security_group"}, {"name": "get_custom_environment"}, {"name": "get_custom_runtime"}, {"name": "get_custom_vpc"}, {"name": "build"}, {"name": "build_http"}, {"name": "get_options"}, {"name": "build_from_graph"}, {"name": "build_http_from_graph"}
+    ]}
+  ],
+  "exceptions": [],
+  "behavior_ref": "behavior.md"
+}

lambda_api_decorators_cdk-0.4.7/src/lambda_api_decorators_cdk/_agent/behavior.md

@@ -0,0 +1,15 @@
+# CDK behavior
+
+## Construction and precedence
+
+`LambdaApi` selects REST by default, infers the API family from a supplied concrete REST or HTTP API, and rejects a conflicting explicit `api_type`. Configuration must be complete before construction; `LambdaApiConfig` creates an isolated `ResourceBuilder` snapshot and does not deep-copy CDK constructs.
+
+Explicit configuration wins over convention. Runtime, role, environment, layer, VPC, security group, table, bucket, and authorizer registries resolve named decorator values. A registry is a lookup mechanism, not an authorization grant.
+
+## Routes and authorization
+
+The runtime contract permits one HTTP route per callable. CDK discovers those declarations and builds the matching REST or HTTP resources. `public` suppresses the effective authorizer for that callable; otherwise a callable override, the configured default authorizer, or no authorizer is resolved according to the current builder behavior.
+
+## Grants
+
+`grant_dynamodb` and `grant_s3` resolve either a registered logical resource or a physical resource name. `read` applies read access and `write` applies cumulative write access as implemented by the builder. Generic `permission` statements are applied separately. Missing registry entries, invalid authorizers, conflicting defaults, and unsupported API/resource combinations produce errors or CDK diagnostics rather than silently changing the runtime metadata.

{lambda_api_decorators_cdk-0.4.6 → lambda_api_decorators_cdk-0.4.7}/src/lambda_api_decorators_cdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lambda-api-decorators-cdk
-Version: 0.4.6
+Version: 0.4.7
 Summary: AWS CDK integration for Lambda API Decorators. Generate AWS Lambda and API Gateway infrastructure from decorated Python handlers.
 Author: Mateo Marcos, Emanuel Arguinarena, Lucas Picchi
 License: MIT License

{lambda_api_decorators_cdk-0.4.6 → lambda_api_decorators_cdk-0.4.7}/src/lambda_api_decorators_cdk.egg-info/SOURCES.txt

@@ -19,6 +19,8 @@ src/lambda_api_decorators_cdk.egg-info/requires.txt
 src/lambda_api_decorators_cdk.egg-info/scm_file_list.json
 src/lambda_api_decorators_cdk.egg-info/scm_version.json
 src/lambda_api_decorators_cdk.egg-info/top_level.txt
+src/lambda_api_decorators_cdk/_agent/api-contract.json
+src/lambda_api_decorators_cdk/_agent/behavior.md
 tests/conftest.py
 tests/test_ast_decorator_invocations.py
 tests/test_ast_helper.py
@@ -31,6 +33,7 @@ tests/test_authorization_rest.py
 tests/test_authorizer_config.py
 tests/test_config_override_diagnostics.py
 tests/test_config_resource_registries.py
+tests/test_contract_packaging.py
 tests/test_http_builder.py
 tests/test_lambda_api.py
 tests/test_lambda_api_config.py
@@ -45,4 +48,5 @@ tests/test_resource_builder_state.py
 tests/test_resource_graph.py
 tests/test_resource_registries.py
 tests/test_rest_builder.py
-tests/test_source_layout.py
+tests/test_source_layout.py
+tests/verify_contract_artifacts.py

{lambda_api_decorators_cdk-0.4.6 → lambda_api_decorators_cdk-0.4.7}/src/lambda_api_decorators_cdk.egg-info/scm_file_list.json

@@ -8,6 +8,8 @@
     "README.md",
     "pyproject.toml",
     "src/lambda_api_decorators_cdk/__init__.py",
+    "src/lambda_api_decorators_cdk/_agent/api-contract.json",
+    "src/lambda_api_decorators_cdk/_agent/behavior.md",
     "src/lambda_api_decorators_cdk/api_type.py",
     "src/lambda_api_decorators_cdk/ast_helper.py",
     "src/lambda_api_decorators_cdk/lambda_api.py",
@@ -26,6 +28,7 @@
     "tests/test_authorizer_config.py",
     "tests/test_config_override_diagnostics.py",
     "tests/test_config_resource_registries.py",
+    "tests/test_contract_packaging.py",
     "tests/test_http_builder.py",
     "tests/test_lambda_api.py",
     "tests/test_lambda_api_config.py",
@@ -40,6 +43,7 @@
     "tests/test_resource_graph.py",
     "tests/test_resource_registries.py",
     "tests/test_rest_builder.py",
-    "tests/test_source_layout.py"
+    "tests/test_source_layout.py",
+    "tests/verify_contract_artifacts.py"
   ]
 }

lambda_api_decorators_cdk-0.4.7/src/lambda_api_decorators_cdk.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.4.7",
+  "distance": 0,
+  "node": "g36671bffe3f623004723fd7963cc3f3ea198fb54",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-09-25"
+}

lambda_api_decorators_cdk-0.4.7/tests/test_contract_packaging.py

@@ -0,0 +1,21 @@
+import json
+from pathlib import Path
+
+
+def test_public_contract_is_present_and_version_free():
+    contract_path = Path(__file__).parents[1] / "src/lambda_api_decorators_cdk/_agent/api-contract.json"
+    contract = json.loads(contract_path.read_text())
+    assert contract["schema_version"] == "1.0"
+    assert "version" not in contract
+    assert contract["exports"] == ["ApiType", "SourceLayout", "LambdaApi", "LambdaApiConfig", "ResourceBuilder"]
+    assert contract_path.with_name("behavior.md").read_text().strip()
+
+
+def test_contract_covers_public_configuration_and_types():
+    contract_path = Path(__file__).parents[1] / "src/lambda_api_decorators_cdk/_agent/api-contract.json"
+    contract = json.loads(contract_path.read_text())
+    classes = {item["name"]: item for item in contract["classes"]}
+    assert {"LambdaApi", "LambdaApiConfig", "ResourceBuilder", "ApiType", "SourceLayout"} <= classes.keys()
+    config_methods = {item["name"] for item in classes["LambdaApiConfig"]["methods"]}
+    assert {"register_role", "register_environment", "register_authorizer", "set_default_authorizer"} <= config_methods
+    assert classes["LambdaApi"]["methods"][0]["kind"] == "property"

lambda_api_decorators_cdk-0.4.7/tests/verify_contract_artifacts.py

@@ -0,0 +1,38 @@
+"""Verify that built CDK artifacts carry the public contract."""
+import json
+import sys
+import tarfile
+import zipfile
+from pathlib import Path
+
+
+def validate(payload):
+    required = {"schema_version", "distribution", "import_package", "exports", "functions", "decorators", "classes", "exceptions"}
+    assert payload["schema_version"] == "1.0"
+    assert required <= payload.keys()
+    assert "version" not in payload
+
+
+def main(dist_dir):
+    dist = Path(dist_dir)
+    wheels = list(dist.glob("*.whl"))
+    sdists = list(dist.glob("*.tar.gz"))
+    assert len(wheels) == len(sdists) == 1, (wheels, sdists)
+    with zipfile.ZipFile(wheels[0]) as archive:
+        names = archive.namelist()
+        contract = [name for name in names if name.endswith("/_agent/api-contract.json")]
+        behavior = [name for name in names if name.endswith("/_agent/behavior.md")]
+        assert len(contract) == len(behavior) == 1, (contract, behavior)
+        validate(json.loads(archive.read(contract[0])))
+    with tarfile.open(sdists[0], "r:gz") as archive:
+        names = archive.getnames()
+        contract = [name for name in names if name.endswith("/_agent/api-contract.json")]
+        behavior = [name for name in names if name.endswith("/_agent/behavior.md")]
+        assert len(contract) == len(behavior) == 1, (contract, behavior)
+        member = archive.extractfile(contract[0])
+        assert member is not None
+        validate(json.load(member))
+
+
+if __name__ == "__main__":
+    main(sys.argv[1])

lambda_api_decorators_cdk-0.4.6/src/lambda_api_decorators_cdk.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "0.4.6",
-  "distance": 0,
-  "node": "ge7e5b769f9a7510bcc89ce540d18572ac2ad8960",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-09-24"
-}