basaltic-sdk-python 0.2.0__tar.gz → 0.4.0__tar.gz

{basaltic_sdk_python-0.2.0 → basaltic_sdk_python-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: basaltic-sdk-python
-Version: 0.2.0
+Version: 0.4.0
 Summary: Official typed synchronous and asynchronous Python SDK for Basaltic
 Project-URL: Homepage, https://basaltic.sh
 Project-URL: Documentation, https://docs.basaltic.sh
@@ -209,3 +209,17 @@ python -m pip install -r requirements-dev.txt -e .
 python scripts/check.py
 python scripts/check_package.py
 ```
+
+## KMS key rotation
+
+The KMS client supports automatic rotation policies, on-demand rotation, paginated
+rotation history, public keys by material version, and ciphertext rewrapping.
+Reuse an idempotency key when retrying the same on-demand rotation. A `202`
+response represents accepted work; poll its rotation ID until it completes.
+Persist the material version returned by signing and supply it when verifying
+or retrieving a public key. Verification without a version remains compatible
+with older signatures. Rotation retains existing key identities and historical
+material; it does not rewrite stored ciphertext.
+
+See [KMS rotation](https://docs.basaltic.sh/kms/rotation) for the lifecycle,
+permissions, and migration workflow.

{basaltic_sdk_python-0.2.0 → basaltic_sdk_python-0.4.0}/README.md

@@ -189,3 +189,17 @@ python -m pip install -r requirements-dev.txt -e .
 python scripts/check.py
 python scripts/check_package.py
 ```
+
+## KMS key rotation
+
+The KMS client supports automatic rotation policies, on-demand rotation, paginated
+rotation history, public keys by material version, and ciphertext rewrapping.
+Reuse an idempotency key when retrying the same on-demand rotation. A `202`
+response represents accepted work; poll its rotation ID until it completes.
+Persist the material version returned by signing and supply it when verifying
+or retrieving a public key. Verification without a version remains compatible
+with older signatures. Rotation retains existing key identities and historical
+material; it does not rewrite stored ciphertext.
+
+See [KMS rotation](https://docs.basaltic.sh/kms/rotation) for the lifecycle,
+permissions, and migration workflow.

{basaltic_sdk_python-0.2.0 → basaltic_sdk_python-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "basaltic-sdk-python"
-version = "0.2.0"
+version = "0.4.0"
 description = "Official typed synchronous and asynchronous Python SDK for Basaltic"
 readme = "README.md"
 requires-python = ">=3.11"

{basaltic_sdk_python-0.2.0 → basaltic_sdk_python-0.4.0}/src/basaltic/_version.py

@@ -1,3 +1,3 @@
 """Basaltic SDK version."""
 
-__version__ = "0.2.0"
+__version__ = "0.4.0"

{basaltic_sdk_python-0.2.0 → basaltic_sdk_python-0.4.0}/src/basaltic/models/audit.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Literal, NotRequired, TypeAlias, TypedDict
+from typing import Literal, NotRequired, Required, TypeAlias, TypedDict
 
 AuditLogResponse = TypedDict(
     "AuditLogResponse", {"audit_log": "NotRequired[AuditLog]"}, total=False
@@ -23,12 +23,33 @@ AuditLog = TypedDict(
         "ip_address": "NotRequired[str | None]",
         "user_agent": "NotRequired[str | None]",
         "request_id": "NotRequired[str | None]",
-        "details": "NotRequired[dict[str, object]]",
+        "details": "NotRequired[AuditLogDetails]",
         "error_code": "NotRequired[str | None]",
         "error_message": "NotRequired[str | None]",
     },
     total=False,
 )
+AuditLogDetails = TypedDict(
+    "AuditLogDetails", {"auth_chain": "NotRequired[list[AuditAuthenticationStep]]"}, total=False
+)
+AuditAuthenticationStep = TypedDict(
+    "AuditAuthenticationStep",
+    {
+        "principal_id": "Required[str]",
+        "principal_type": "Required[str]",
+        "principal_crn": "NotRequired[str]",
+        "name": "NotRequired[str]",
+        "issuer": "NotRequired[str]",
+        "subject": "NotRequired[str]",
+        "email": "NotRequired[str]",
+        "session_id": "NotRequired[str]",
+        "session_crn": "NotRequired[str]",
+        "session_name": "NotRequired[str]",
+        "grant_type": "NotRequired[str]",
+        "issued_at": "NotRequired[str]",
+    },
+    total=False,
+)
 GetAuditLogResponse: TypeAlias = "AuditLogResponse"
 GetAuditLogResource: TypeAlias = "AuditLog"
 GetAuditLogScope = TypedDict(

{basaltic_sdk_python-0.2.0 → basaltic_sdk_python-0.4.0}/src/basaltic/models/billing.py

@@ -7,24 +7,37 @@ from typing import Literal, NotRequired, Required, TypeAlias, TypedDict
 BillingProfile = TypedDict(
     "BillingProfile",
     {
-        "customer_type": "NotRequired[Literal['', 'individual', 'company']]",
-        "company_name": "NotRequired[str]",
-        "country": "NotRequired[str]",
-        "tax_id": "NotRequired[str]",
-        "foreign_tax_id": "NotRequired[str]",
-        "no_tax_id_reason": "NotRequired[str]",
-        "email": "NotRequired[str]",
-        "phone": "NotRequired[str]",
+        "customer_type": "Required[Literal['', 'individual', 'company']]",
+        "company_name": "Required[str]",
+        "tax_id": "Required[str]",
+        "tax_id_kind": "Required[str]",
+        "no_tax_id_reason": "Required[str]",
+        "email": "Required[str]",
+        "phone": "Required[str]",
+        "country": "Required[ResourceRef]",
+        "state": "Required[ResourceRef | Literal[None] | None]",
+        "city": "Required[ResourceRef | Literal[None] | None]",
+        "address": "Required[BillingAddress]",
+        "ready": "Required[bool]",
+        "missing_fields": "Required[list[str]]",
+    },
+    total=False,
+)
+ResourceRef = TypedDict(
+    "ResourceRef",
+    {"id": "Required[str]", "crn": "Required[str]", "name": "NotRequired[str]"},
+    total=False,
+)
+BillingAddress = TypedDict(
+    "BillingAddress",
+    {
         "street_name": "NotRequired[str]",
         "street_number": "NotRequired[str]",
         "complement": "NotRequired[str]",
         "neighborhood": "NotRequired[str]",
         "city": "NotRequired[str]",
-        "municipality_code": "NotRequired[str]",
         "state": "NotRequired[str]",
         "postal_code": "NotRequired[str]",
-        "ready": "NotRequired[bool]",
-        "missing_fields": "NotRequired[list[str]]",
     },
     total=False,
 )
@@ -258,27 +271,35 @@ Transaction = TypedDict(
 )
 ListTransactionsResponse: TypeAlias = "TransactionListResponse"
 ListTransactionsItem: TypeAlias = "Transaction"
-BillingProfileInput = TypedDict(
-    "BillingProfileInput",
+BillingProfileUpdateInput = TypedDict(
+    "BillingProfileUpdateInput",
     {
         "customer_type": "NotRequired[Literal['', 'individual', 'company']]",
         "company_name": "NotRequired[str]",
-        "country": "NotRequired[str]",
         "tax_id": "NotRequired[str]",
-        "foreign_tax_id": "NotRequired[str]",
+        "tax_id_kind": "NotRequired[str]",
         "no_tax_id_reason": "NotRequired[str]",
         "email": "NotRequired[str]",
         "phone": "NotRequired[str]",
+        "country": "NotRequired[str]",
+        "state": "NotRequired[str]",
+        "city": "NotRequired[str]",
+        "address": "NotRequired[BillingAddressInput]",
+    },
+    total=False,
+)
+BillingAddressInput = TypedDict(
+    "BillingAddressInput",
+    {
         "street_name": "NotRequired[str]",
         "street_number": "NotRequired[str]",
         "complement": "NotRequired[str]",
         "neighborhood": "NotRequired[str]",
         "city": "NotRequired[str]",
-        "municipality_code": "NotRequired[str]",
         "state": "NotRequired[str]",
         "postal_code": "NotRequired[str]",
     },
     total=False,
 )
-UpdateBillingProfileBody: TypeAlias = "BillingProfileInput"
+UpdateBillingProfileBody: TypeAlias = "BillingProfileUpdateInput"
 UpdateBillingProfileResponse: TypeAlias = "BillingProfile"

basaltic_sdk_python-0.4.0/src/basaltic/models/catalog.py

@@ -0,0 +1,187 @@
+"""Generated API models. Dictionary keys retain their wire names."""
+
+from __future__ import annotations
+
+from typing import Literal, NotRequired, Required, TypeAlias, TypedDict
+
+GetCountryResult = TypedDict(
+    "GetCountryResult", {"country": "Required[CountryDetail]"}, total=False
+)
+CountryDetail = TypedDict(
+    "CountryDetail",
+    {
+        "id": "Required[str]",
+        "crn": "Required[str]",
+        "code": "Required[str]",
+        "iso3": "Required[str]",
+        "name": "Required[str]",
+        "calling_code": "Required[str]",
+        "rules": "Required[CountryRules]",
+        "postal_lookup": "Required[bool]",
+    },
+    total=False,
+)
+CountryRules = TypedDict(
+    "CountryRules",
+    {
+        "customer_types": "Required[list[Literal['individual', 'company']]]",
+        "name_labels": "Required[dict[str, str]]",
+        "tax_ids": "Required[dict[str, list[TaxIDRule]]]",
+        "fields": "Required[list[AddressField]]",
+    },
+    total=False,
+)
+TaxIDRule = TypedDict(
+    "TaxIDRule",
+    {
+        "kind": "Required[str]",
+        "label": "Required[str]",
+        "mask": "NotRequired[str]",
+        "pattern": "NotRequired[str]",
+        "validator": "NotRequired[Literal['br_cpf', 'br_cnpj', 'ar_cuit', 'cl_rut']]",
+        "example": "NotRequired[str]",
+        "required": "Required[bool]",
+    },
+    total=False,
+)
+AddressField = TypedDict(
+    "AddressField",
+    {
+        "key": "Required[Literal['street_name', 'street_number', 'complement', 'neighborhood', 'city', 'state', 'postal_code']]",
+        "label": "Required[str]",
+        "required": "Required[bool]",
+        "max": "NotRequired[int]",
+        "mask": "NotRequired[str]",
+        "pattern": "NotRequired[str]",
+        "example": "NotRequired[str]",
+        "source": "NotRequired[Literal['list', 'free']]",
+        "require_metadata": "NotRequired[str]",
+    },
+    total=False,
+)
+GetCountryResponse: TypeAlias = "GetCountryResult"
+Region = TypedDict(
+    "Region",
+    {
+        "state": "Required[Literal['planned', 'active', 'restricted', 'retiring', 'retired']]",
+        "accepting_new_resources": "Required[bool]",
+        "crn": "Required[str]",
+        "code": "Required[str]",
+        "name": "Required[str]",
+        "location": "Required[str]",
+        "country_code": "Required[str]",
+        "available": "Required[bool]",
+        "coming_soon": "Required[bool]",
+    },
+    total=False,
+)
+GetRegionResponse: TypeAlias = "Region"
+GetRegionResource: TypeAlias = "GetRegionResponse"
+GetRegionScope = TypedDict("GetRegionScope", {}, total=False)
+ListCitiesParameters = TypedDict(
+    "ListCitiesParameters",
+    {
+        "state": "NotRequired[str]",
+        "country": "NotRequired[str]",
+        "q": "NotRequired[str]",
+        "limit": "NotRequired[int]",
+    },
+    total=False,
+)
+ListCitiesQuery: TypeAlias = "ListCitiesParameters"
+ListCitiesResult = TypedDict(
+    "ListCitiesResult", {"cities": "Required[list[City]]", "meta": "Required[GeoPage]"}, total=False
+)
+City = TypedDict(
+    "City",
+    {
+        "id": "Required[str]",
+        "crn": "Required[str]",
+        "name": "Required[str]",
+        "country": "Required[ResourceRef]",
+        "state": "Required[ResourceRef | Literal[None] | None]",
+    },
+    total=False,
+)
+ResourceRef = TypedDict(
+    "ResourceRef",
+    {"id": "Required[str]", "crn": "Required[str]", "name": "NotRequired[str]"},
+    total=False,
+)
+GeoPage = TypedDict(
+    "GeoPage",
+    {"total": "Required[int]", "limit": "Required[int]", "has_more": "Required[bool]"},
+    total=False,
+)
+ListCitiesResponse: TypeAlias = "ListCitiesResult"
+ListCitiesItem: TypeAlias = "City"
+ListCountriesResult = TypedDict(
+    "ListCountriesResult",
+    {"countries": "Required[list[Country]]", "meta": "Required[GeoPage]"},
+    total=False,
+)
+Country = TypedDict(
+    "Country",
+    {
+        "id": "Required[str]",
+        "crn": "Required[str]",
+        "code": "Required[str]",
+        "iso3": "Required[str]",
+        "name": "Required[str]",
+        "calling_code": "Required[str]",
+    },
+    total=False,
+)
+ListCountriesResponse: TypeAlias = "ListCountriesResult"
+ListCountriesItem: TypeAlias = "Country"
+ListRegionsParameters = TypedDict(
+    "ListRegionsParameters", {"name": "NotRequired[str]", "crn": "NotRequired[str]"}, total=False
+)
+ListRegionsQuery: TypeAlias = "ListRegionsParameters"
+ListRegionsResult = TypedDict(
+    "ListRegionsResult",
+    {"regions": "Required[list[Region]]", "default": "Required[str]"},
+    total=False,
+)
+ListRegionsResponse: TypeAlias = "ListRegionsResult"
+ListRegionsItem: TypeAlias = "Region"
+ListStatesParameters = TypedDict("ListStatesParameters", {"country": "Required[str]"}, total=False)
+ListStatesQuery: TypeAlias = "ListStatesParameters"
+ListStatesResult = TypedDict(
+    "ListStatesResult",
+    {"states": "Required[list[State]]", "meta": "Required[GeoPage]"},
+    total=False,
+)
+State = TypedDict(
+    "State",
+    {
+        "id": "Required[str]",
+        "crn": "Required[str]",
+        "code": "Required[str]",
+        "name": "Required[str]",
+        "country": "Required[ResourceRef]",
+    },
+    total=False,
+)
+ListStatesResponse: TypeAlias = "ListStatesResult"
+ListStatesItem: TypeAlias = "State"
+LookupPostalCodeParameters = TypedDict(
+    "LookupPostalCodeParameters", {"country": "Required[str]"}, total=False
+)
+LookupPostalCodeQuery: TypeAlias = "LookupPostalCodeParameters"
+LookupPostalCodeResult = TypedDict(
+    "LookupPostalCodeResult", {"postal_code": "Required[PostalCode]"}, total=False
+)
+PostalCode = TypedDict(
+    "PostalCode",
+    {
+        "code": "Required[str]",
+        "country": "Required[ResourceRef]",
+        "state": "Required[ResourceRef | Literal[None] | None]",
+        "city": "Required[ResourceRef | Literal[None] | None]",
+        "address": "Required[dict[str, str]]",
+        "source": "Required[str]",
+    },
+    total=False,
+)
+LookupPostalCodeResponse: TypeAlias = "LookupPostalCodeResult"

{basaltic_sdk_python-0.2.0 → basaltic_sdk_python-0.4.0}/src/basaltic/models/kms.py

@@ -82,6 +82,79 @@ GetKeyScope = TypedDict(
     "GetKeyScope", {"limit": "NotRequired[int]", "state": "NotRequired[KeyStateInput]"}, total=False
 )
 KeyStateInput: TypeAlias = "Literal['enabled', 'disabled', 'pending_deletion']"
+KeyRotationResponse = TypedDict(
+    "KeyRotationResponse", {"rotation": "Required[KeyRotation]"}, total=False
+)
+KeyRotation = TypedDict(
+    "KeyRotation",
+    {
+        "id": "Required[str]",
+        "key_id": "Required[str]",
+        "trigger": "Required[Literal['on_demand', 'automatic']]",
+        "status": "Required[Literal['pending', 'in_progress', 'reconciliation_required', 'succeeded', 'failed']]",
+        "previous_version": "Required[int | None]",
+        "key_version": "Required[int | None]",
+        "requested_at": "Required[str]",
+        "started_at": "Required[str | None]",
+        "completed_at": "Required[str | None]",
+        "error_code": "Required[str | None]",
+    },
+    total=False,
+)
+GetKeyRotationResponse: TypeAlias = "KeyRotationResponse"
+KeyRotationStatusResponse = TypedDict(
+    "KeyRotationStatusResponse", {"rotation": "Required[KeyRotationStatus]"}, total=False
+)
+KeyRotationStatus = TypedDict(
+    "KeyRotationStatus",
+    {
+        "enabled": "Required[bool]",
+        "rotation_period_days": "Required[int]",
+        "next_rotation_at": "Required[str | None]",
+        "current_version": "Required[int]",
+    },
+    total=False,
+)
+GetKeyRotationStatusResponse: TypeAlias = "KeyRotationStatusResponse"
+GetPublicKeyParameters = TypedDict(
+    "GetPublicKeyParameters", {"key_version": "NotRequired[int]"}, total=False
+)
+GetPublicKeyQuery: TypeAlias = "GetPublicKeyParameters"
+PublicKeyResponse = TypedDict(
+    "PublicKeyResponse",
+    {
+        "key_crn": "Required[str]",
+        "key_version": "Required[int]",
+        "key_spec": "Required[KeySpec]",
+        "key_usage": "Required[KeyUsage]",
+        "public_key": "Required[str]",
+    },
+    total=False,
+)
+GetPublicKeyResponse: TypeAlias = "PublicKeyResponse"
+ListKeyRotationsParameters = TypedDict(
+    "ListKeyRotationsParameters",
+    {"limit": "NotRequired[int]", "marker": "NotRequired[str]"},
+    total=False,
+)
+ListKeyRotationsQuery: TypeAlias = "ListKeyRotationsParameters"
+KeyRotationListResponse = TypedDict(
+    "KeyRotationListResponse",
+    {"rotations": "Required[list[KeyRotation]]", "meta": "Required[PaginationMeta]"},
+    total=False,
+)
+PaginationMeta = TypedDict(
+    "PaginationMeta",
+    {
+        "total": "NotRequired[int]",
+        "limit": "NotRequired[int]",
+        "marker": "NotRequired[str]",
+        "has_more": "NotRequired[bool]",
+    },
+    total=False,
+)
+ListKeyRotationsResponse: TypeAlias = "KeyRotationListResponse"
+ListKeyRotationsItem: TypeAlias = "KeyRotation"
 ListKeysParameters = TypedDict(
     "ListKeysParameters",
     {
@@ -99,23 +172,36 @@ KeyListResponse = TypedDict(
     {"keys": "NotRequired[list[Key]]", "meta": "NotRequired[PaginationMeta]"},
     total=False,
 )
-PaginationMeta = TypedDict(
-    "PaginationMeta",
-    {
-        "total": "NotRequired[int]",
-        "limit": "NotRequired[int]",
-        "marker": "NotRequired[str]",
-        "has_more": "NotRequired[bool]",
-    },
-    total=False,
-)
 ListKeysResponse: TypeAlias = "KeyListResponse"
 ListKeysItem: TypeAlias = "Key"
+RewrapRequestInput = TypedDict("RewrapRequestInput", {"ciphertext": "Required[str]"}, total=False)
+RewrapBody: TypeAlias = "RewrapRequestInput"
+RewrapResponse: TypeAlias = "EncryptResponse2"
+RotateKeyOnDemandResponse: TypeAlias = "KeyRotationResponse"
 ScheduleKeyDeletionRequestInput = TypedDict(
     "ScheduleKeyDeletionRequestInput", {"recovery_window_days": "NotRequired[int]"}, total=False
 )
 ScheduleKeyDeletionBody: TypeAlias = "ScheduleKeyDeletionRequestInput"
 ScheduleKeyDeletionResponse: TypeAlias = "KeyResponse"
+SetKeyRotationRequestInput = TypedDict(
+    "SetKeyRotationRequestInput",
+    {"enabled": "Required[bool]", "rotation_period_days": "NotRequired[int]"},
+    total=False,
+)
+SetKeyRotationBody: TypeAlias = "SetKeyRotationRequestInput"
+KeyRotationPolicyResponse = TypedDict(
+    "KeyRotationPolicyResponse", {"rotation": "Required[KeyRotationPolicy]"}, total=False
+)
+KeyRotationPolicy = TypedDict(
+    "KeyRotationPolicy",
+    {
+        "enabled": "Required[bool]",
+        "rotation_period_days": "Required[int]",
+        "next_rotation_at": "Required[str | None]",
+    },
+    total=False,
+)
+SetKeyRotationResponse: TypeAlias = "KeyRotationPolicyResponse"
 SignRequestInput = TypedDict(
     "SignRequestInput",
     {"message": "Required[str]", "signing_algorithm": "NotRequired[SigningAlgorithmInput]"},
@@ -127,7 +213,11 @@ SigningAlgorithmInput: TypeAlias = (
 SignBody: TypeAlias = "SignRequestInput"
 SignResponse2 = TypedDict(
     "SignResponse2",
-    {"signature": "NotRequired[str]", "signing_algorithm": "NotRequired[SigningAlgorithm]"},
+    {
+        "key_version": "NotRequired[int]",
+        "signature": "NotRequired[str]",
+        "signing_algorithm": "NotRequired[SigningAlgorithm]",
+    },
     total=False,
 )
 SigningAlgorithm: TypeAlias = (
@@ -144,6 +234,7 @@ UpdateKeyResponse: TypeAlias = "KeyResponse"
 VerifyRequestInput = TypedDict(
     "VerifyRequestInput",
     {
+        "key_version": "NotRequired[int]",
         "message": "Required[str]",
         "signature": "Required[str]",
         "signing_algorithm": "NotRequired[SigningAlgorithmInput]",

{basaltic_sdk_python-0.2.0 → basaltic_sdk_python-0.4.0}/src/basaltic/models/storage.py

@@ -74,6 +74,8 @@ Snapshot = TypedDict(
         "description": "NotRequired[str]",
         "tags": "NotRequired[Tags]",
         "size_gb": "NotRequired[int]",
+        "logical_size_bytes": "NotRequired[int]",
+        "snapshot_usage": "NotRequired[SnapshotUsage]",
         "status": "NotRequired[SnapshotStatus]",
         "faults": "Required[list[Fault]]",
         "created_at": "NotRequired[str]",
@@ -82,6 +84,17 @@ Snapshot = TypedDict(
     total=False,
 )
 Tags: TypeAlias = "dict[str, str]"
+SnapshotUsage = TypedDict(
+    "SnapshotUsage",
+    {
+        "state": "Required[Literal['unknown', 'stale', 'measured']]",
+        "scope": "Required[Literal['volume_lineage']]",
+        "billable": "Required[Literal[False]]",
+        "measured_at": "Required[str | None]",
+        "lineage_retained_bytes": "Required[int | None]",
+    },
+    total=False,
+)
 SnapshotStatus: TypeAlias = "Literal['creating', 'available', 'deleting', 'error']"
 Fault = TypedDict(
     "Fault",