finatic-server-python 1.0.4__tar.gz → 1.0.5__tar.gz

{finatic_server_python-1.0.4 → finatic_server_python-1.0.5}/.github/workflows/ci.yml

@@ -23,6 +23,10 @@ jobs:
         run: echo "Skipping heavy product CI for Dependabot or chore(release) PRs (Actions cost control)."
       - uses: actions/checkout@v7
         if: github.actor != 'dependabot[bot]' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository || startsWith(github.event.pull_request.title, 'chore(release):') == false)
+        with:
+          # The generated-tree gate verifies legacy files against a pinned
+          # develop commit, so that object must be present in the CI clone.
+          fetch-depth: 0
 
       - uses: actions/setup-python@v7
         if: github.actor != 'dependabot[bot]' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository || startsWith(github.event.pull_request.title, 'chore(release):') == false)
@@ -44,6 +48,10 @@ jobs:
         if: github.actor != 'dependabot[bot]' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository || startsWith(github.event.pull_request.title, 'chore(release):') == false)
         run: uv run python -m compileall finatic_server_python src tests
 
+      - name: Verify generated OpenAPI account surface
+        if: matrix.python-version == '3.12' && github.actor != 'dependabot[bot]' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository || startsWith(github.event.pull_request.title, 'chore(release):') == false)
+        run: uv run python scripts/regenerate_openapi.py
+
       - name: Run unit tests with coverage gate
         if: github.actor != 'dependabot[bot]' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository || startsWith(github.event.pull_request.title, 'chore(release):') == false)
         run: >

{finatic_server_python-1.0.4 → finatic_server_python-1.0.5}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.0.5
+
+- Release from d4277ef3e830b95a4d337992784833d864d679f1.
+
+## Unreleased
+
+- Regenerate the account-resource client from FinaticAPI PR #748 and expose
+  typed instrument descriptors for orders, fills, events, positions, lots, and
+  lot fills.
+- Add typed canonical `finaticInstrumentId` placement while preserving the
+  provider-native `instrumentId`, arbitrary provider fields, raw dictionaries,
+  account scoping, and idempotency behavior.
+
 ## 1.0.4
 
 - Release from 1f12f4e6b4f0eba77d315913d338d90aef8adfd9.

{finatic_server_python-1.0.4 → finatic_server_python-1.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: finatic-server-python
-Version: 1.0.4
+Version: 1.0.5
 Summary: Python SDK for Finatic Server API
 Project-URL: Homepage, https://github.com/FinaticORG/FinaticServerSDK-Python
 Project-URL: Documentation, https://docs.finatic.com/python
@@ -126,6 +126,36 @@ created = await finatic.v1.create_account_order(
 
 Python wraps the dict as `{"order": ...}` on the wire. `idempotency_key` is required.
 
+### Exact instrument identity
+
+Order, fill, event, position, lot, and lot-fill responses expose the generated
+`FDXInstrumentDescriptor` contract. `future.identityQuality` distinguishes an
+exact contract such as `MGCZ6` from a root-only identity such as `MGC`; optional
+month, expiry, MIC, and provenance fields remain absent when the API did not
+prove them.
+
+```python
+from finatic_server_python import AccountOrderPayload, FDXInstrumentDescriptor
+
+order = AccountOrderPayload.from_dict(
+    {
+        "finaticInstrumentId": "finatic:future:MGCZ6",
+        "instrumentId": 611092087,  # provider-native identity remains supported
+        "symbol": "MGCZ6",
+    }
+)
+result = await finatic.v1.create_account_order(
+    account_id, order, idempotency_key="unique-command-key"
+)
+```
+
+The server authorizes and resolves identities in account/provider scope. The
+SDK preserves both identifiers and never infers an exact contract from a root.
+The v1 facade continues to return dictionaries; its generated `TypedDict`
+annotations make descriptor keys discoverable without changing existing
+mapping access. Generated model classes remain available when explicit
+validation or construction is desired.
+
 ## Package layout
 
 | Name | Role |

{finatic_server_python-1.0.4 → finatic_server_python-1.0.5}/README.md

@@ -79,6 +79,36 @@ created = await finatic.v1.create_account_order(
 
 Python wraps the dict as `{"order": ...}` on the wire. `idempotency_key` is required.
 
+### Exact instrument identity
+
+Order, fill, event, position, lot, and lot-fill responses expose the generated
+`FDXInstrumentDescriptor` contract. `future.identityQuality` distinguishes an
+exact contract such as `MGCZ6` from a root-only identity such as `MGC`; optional
+month, expiry, MIC, and provenance fields remain absent when the API did not
+prove them.
+
+```python
+from finatic_server_python import AccountOrderPayload, FDXInstrumentDescriptor
+
+order = AccountOrderPayload.from_dict(
+    {
+        "finaticInstrumentId": "finatic:future:MGCZ6",
+        "instrumentId": 611092087,  # provider-native identity remains supported
+        "symbol": "MGCZ6",
+    }
+)
+result = await finatic.v1.create_account_order(
+    account_id, order, idempotency_key="unique-command-key"
+)
+```
+
+The server authorizes and resolves identities in account/provider scope. The
+SDK preserves both identifiers and never infers an exact contract from a root.
+The v1 facade continues to return dictionaries; its generated `TypedDict`
+annotations make descriptor keys discoverable without changing existing
+mapping access. Generated model classes remain available when explicit
+validation or construction is desired.
+
 ## Package layout
 
 | Name | Role |