bydev 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
bydev/__init__.py ADDED
@@ -0,0 +1,168 @@
1
+ """데브 라이선스 API의 공식 Python SDK(동작 명세 `sdks/spec`)."""
2
+
3
+ from ._generated import (
4
+ Codes,
5
+ DevicePlatform,
6
+ DistributionTarget,
7
+ EntitlementStatus,
8
+ GrantType,
9
+ InstallMode,
10
+ NeedsDecisionReason,
11
+ Route,
12
+ Routes,
13
+ Rules,
14
+ Scope,
15
+ SessionStateType,
16
+ Spec,
17
+ SubscriptionStatus,
18
+ UpdateCoverageType,
19
+ UpdateStatus,
20
+ )
21
+ from .client import SDK_VERSION, USER_AGENT, Config, LicenseClient
22
+ from .defaults import (
23
+ MemoryCredentialStore,
24
+ NoFingerprint,
25
+ SecureRandom,
26
+ SilentLog,
27
+ SystemClock,
28
+ ThreadScheduler,
29
+ UrllibTransport,
30
+ )
31
+ from .errors import BydevError
32
+ from .login import LoginAttempt, LoginResult
33
+ from .models import (
34
+ AccessClaims,
35
+ Device,
36
+ DevicePage,
37
+ DeviceRelease,
38
+ EntitledUpdate,
39
+ Entitlement,
40
+ EntitlementSubscription,
41
+ EntitlementTerm,
42
+ ExternalChannel,
43
+ LicenseClaims,
44
+ LicensePolicy,
45
+ LicenseTokenInfo,
46
+ ProductInstall,
47
+ Profile,
48
+ SessionInfo,
49
+ UpdateCheck,
50
+ UpdateCoverage,
51
+ UpdateLatest,
52
+ UpdateRelease,
53
+ )
54
+ from .ports import (
55
+ Cancel,
56
+ CredentialRecord,
57
+ CredentialStore,
58
+ FingerprintSource,
59
+ HttpRequest,
60
+ HttpResponse,
61
+ HttpTransport,
62
+ LogSink,
63
+ Ports,
64
+ RandomSource,
65
+ Signal,
66
+ TaskScheduler,
67
+ WallClock,
68
+ )
69
+ from .server import ServerVerifier, WebhookVerification, verify_webhook
70
+ from .session import (
71
+ Active,
72
+ ActiveSession,
73
+ AppInfo,
74
+ Degraded,
75
+ DeviceInfo,
76
+ ErrorView,
77
+ LicenseSession,
78
+ Locked,
79
+ NeedsDecision,
80
+ SessionState,
81
+ Starting,
82
+ Stopped,
83
+ Subscription,
84
+ )
85
+
86
+ __version__ = SDK_VERSION
87
+
88
+ __all__ = [
89
+ "SDK_VERSION",
90
+ "USER_AGENT",
91
+ "AccessClaims",
92
+ "Active",
93
+ "ActiveSession",
94
+ "AppInfo",
95
+ "BydevError",
96
+ "Cancel",
97
+ "Codes",
98
+ "Config",
99
+ "CredentialRecord",
100
+ "CredentialStore",
101
+ "Degraded",
102
+ "Device",
103
+ "DeviceInfo",
104
+ "DevicePage",
105
+ "DevicePlatform",
106
+ "DeviceRelease",
107
+ "DistributionTarget",
108
+ "EntitledUpdate",
109
+ "Entitlement",
110
+ "EntitlementStatus",
111
+ "EntitlementSubscription",
112
+ "EntitlementTerm",
113
+ "ErrorView",
114
+ "ExternalChannel",
115
+ "FingerprintSource",
116
+ "GrantType",
117
+ "HttpRequest",
118
+ "HttpResponse",
119
+ "HttpTransport",
120
+ "InstallMode",
121
+ "LicenseClaims",
122
+ "LicenseClient",
123
+ "LicensePolicy",
124
+ "LicenseSession",
125
+ "LicenseTokenInfo",
126
+ "Locked",
127
+ "LogSink",
128
+ "LoginAttempt",
129
+ "LoginResult",
130
+ "MemoryCredentialStore",
131
+ "NeedsDecision",
132
+ "NeedsDecisionReason",
133
+ "NoFingerprint",
134
+ "Ports",
135
+ "ProductInstall",
136
+ "Profile",
137
+ "RandomSource",
138
+ "Route",
139
+ "Routes",
140
+ "Rules",
141
+ "Scope",
142
+ "SecureRandom",
143
+ "ServerVerifier",
144
+ "SessionInfo",
145
+ "SessionState",
146
+ "SessionStateType",
147
+ "Signal",
148
+ "SilentLog",
149
+ "Spec",
150
+ "Starting",
151
+ "Stopped",
152
+ "Subscription",
153
+ "SubscriptionStatus",
154
+ "SystemClock",
155
+ "TaskScheduler",
156
+ "ThreadScheduler",
157
+ "UpdateCheck",
158
+ "UpdateCoverage",
159
+ "UpdateCoverageType",
160
+ "UpdateLatest",
161
+ "UpdateRelease",
162
+ "UpdateStatus",
163
+ "UrllibTransport",
164
+ "WallClock",
165
+ "WebhookVerification",
166
+ "__version__",
167
+ "verify_webhook",
168
+ ]
bydev/_api.py ADDED
@@ -0,0 +1,157 @@
1
+ """명세 3 · 4절 — 요청 만들기 · 응답 읽기 · 발견 문서."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import threading
6
+ from collections.abc import Mapping, Sequence
7
+ from dataclasses import dataclass
8
+ from typing import Any
9
+
10
+ from ._generated import Codes, Routes
11
+ from ._support import SingleFlight, dumps, loads
12
+ from .errors import BydevError, wrap
13
+ from .models import Discovery
14
+ from .ports import HttpRequest, ResolvedPorts
15
+
16
+ _UNRESERVED = frozenset(b"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~")
17
+
18
+
19
+ def _escape(text: str, *, space_plus: bool) -> str:
20
+ """경로 조각 — 예약되지 않은 문자(A–Z a–z 0–9 - . _ ~)만 그대로."""
21
+ out = []
22
+ for b in text.encode():
23
+ if b in _UNRESERVED:
24
+ out.append(chr(b))
25
+ elif b == 0x20 and space_plus:
26
+ out.append("+")
27
+ else:
28
+ out.append(f"%{b:02X}")
29
+ return "".join(out)
30
+
31
+
32
+ @dataclass(frozen=True)
33
+ class ApiResponse:
34
+ headers: dict[str, str]
35
+ json: Any
36
+
37
+
38
+ @dataclass(frozen=True)
39
+ class Req:
40
+ method: str
41
+ url: str
42
+ body: Any = None
43
+ bearer: str | None = None
44
+ idempotency_key: str | None = None
45
+
46
+
47
+ class Api:
48
+ def __init__(self, base_url: str, ports: ResolvedPorts, user_agent: str) -> None:
49
+ self.base_url = base_url.rstrip("/")
50
+ self.ports = ports
51
+ self._user_agent = user_agent
52
+ self._doc: Discovery | None = None
53
+ self._lock = threading.Lock()
54
+ self._discovering: SingleFlight[Discovery] = SingleFlight()
55
+
56
+ def url(
57
+ self, path: str, params: Mapping[str, str] | None = None, query: Sequence[tuple[str, str]] = ()
58
+ ) -> str:
59
+ """경로 `{이름}`을 채우고 질의를 붙인다(이름순 — 언어마다 같은 URL)."""
60
+ out = [self.base_url]
61
+ rest = path
62
+ while (open_ := rest.find("{")) >= 0:
63
+ close = rest.find("}", open_)
64
+ close = len(rest) if close < 0 else close
65
+ out.append(rest[:open_])
66
+ out.append(_escape((params or {}).get(rest[open_ + 1 : close], ""), space_plus=False))
67
+ rest = rest[close + 1 :]
68
+ out.append(rest)
69
+ if query:
70
+ pairs = sorted(query, key=lambda kv: kv[0])
71
+ out.append(
72
+ "?"
73
+ + "&".join(f"{_escape(k, space_plus=True)}={_escape(v, space_plus=True)}" for k, v in pairs)
74
+ )
75
+ return "".join(out)
76
+
77
+ def discovery(self) -> Discovery:
78
+ """처음 한 번 받아 클라이언트 수명 동안 둔다. 실패하면 두지 않는다(명세 4절)."""
79
+ with self._lock:
80
+ if self._doc is not None:
81
+ return self._doc
82
+
83
+ def fetch() -> Discovery:
84
+ res = self.send(Req("GET", self.base_url + Routes.GET_OPEN_ID_CONFIGURATION.path))
85
+ doc = Discovery.read(res.json)
86
+ if doc.issuer.rstrip("/") != self.base_url:
87
+ raise BydevError(
88
+ Codes.CONFIGURATION,
89
+ f"발견 문서의 issuer({doc.issuer})가 baseUrl({self.base_url})과 다르다",
90
+ )
91
+ with self._lock:
92
+ self._doc = doc
93
+ return doc
94
+
95
+ return self._discovering.run(self.ports.scheduler, fetch)
96
+
97
+ def send(self, req: Req) -> ApiResponse:
98
+ headers = {"accept": "application/json", "user-agent": self._user_agent}
99
+ body = None
100
+ if req.body is not None:
101
+ headers["content-type"] = "application/json"
102
+ body = dumps(req.body).encode()
103
+ if req.bearer is not None:
104
+ headers["authorization"] = f"Bearer {req.bearer}"
105
+ if req.idempotency_key is not None:
106
+ headers["idempotency-key"] = req.idempotency_key
107
+ try:
108
+ res = self.ports.transport.send(HttpRequest(req.method, req.url, headers, body))
109
+ except Exception as e:
110
+ raise wrap(e, Codes.NETWORK_ERROR, "API에 연결하지 못했다") from e
111
+ correlation = res.headers.get("x-correlation-id")
112
+ parsed = loads(res.body) if res.body else None
113
+ if 200 <= res.status < 300:
114
+ if parsed is None:
115
+ raise BydevError(
116
+ Codes.PROTOCOL_ERROR,
117
+ "응답 본문이 JSON이 아니다",
118
+ http_status=res.status,
119
+ correlation_id=correlation,
120
+ )
121
+ return ApiResponse(res.headers, parsed)
122
+ raise _error(res.status, res.headers, parsed, correlation)
123
+
124
+
125
+ def _error(status: int, headers: Mapping[str, str], parsed: Any, correlation: str | None) -> BydevError:
126
+ """3.2절. 실패 응답 → `BydevError`."""
127
+ retry: int | None = None
128
+ raw = headers.get("retry-after", "").strip()
129
+ if raw.isdigit() and int(raw) > 0:
130
+ retry = int(raw)
131
+ if (
132
+ isinstance(parsed, dict)
133
+ and isinstance(parsed.get("code"), str)
134
+ and isinstance(parsed.get("message"), str)
135
+ ):
136
+ sec = parsed.get("retryAfterSec")
137
+ if isinstance(sec, int | float) and not isinstance(sec, bool):
138
+ retry = int(sec)
139
+ details = parsed.get("details")
140
+ return BydevError(
141
+ parsed["code"],
142
+ parsed["message"],
143
+ http_status=status,
144
+ correlation_id=correlation,
145
+ retry_after_sec=retry,
146
+ details=details if isinstance(details, dict) else None,
147
+ )
148
+ code = (
149
+ Codes.INTERNAL_ERROR
150
+ if status >= 500
151
+ else Codes.RATE_LIMITED
152
+ if status == 429
153
+ else Codes.PROTOCOL_ERROR
154
+ )
155
+ return BydevError(
156
+ code, f"HTTP {status}", http_status=status, correlation_id=correlation, retry_after_sec=retry
157
+ )
bydev/_generated.py ADDED
@@ -0,0 +1,271 @@
1
+ # Code generated by sdks/codegen. DO NOT EDIT.
2
+ # 원천: packages/contracts · sdks/spec/rules.json — 다시 만들기: pnpm --filter @bydev/sdk-codegen generate
3
+ """생성된 상수 — 에러 코드 · 열린 문자열 열거 · 경로 · 규칙."""
4
+
5
+ from collections.abc import Mapping
6
+ from types import MappingProxyType
7
+ from typing import Final, NamedTuple
8
+
9
+
10
+ class Spec:
11
+ """이 SDK가 따르는 동작 명세 판."""
12
+
13
+ VERSION: Final = "1.2.0"
14
+ DEVICE_CODE_GRANT_TYPE: Final = "urn:ietf:params:oauth:grant-type:device_code"
15
+
16
+
17
+ class Codes:
18
+ """에러 코드 — API(contracts ERROR_CODES)와 SDK(명세 3.3). 분기는 이 값으로 한다."""
19
+
20
+ INVALID_CLIENT: Final = "INVALID_CLIENT"
21
+ AUTHORIZATION_PENDING: Final = "AUTHORIZATION_PENDING"
22
+ SLOW_DOWN: Final = "SLOW_DOWN"
23
+ EXPIRED_TOKEN: Final = "EXPIRED_TOKEN"
24
+ INVALID_GRANT: Final = "INVALID_GRANT"
25
+ SCOPE_INSUFFICIENT: Final = "SCOPE_INSUFFICIENT"
26
+ ENTITLEMENT_NOT_FOUND: Final = "ENTITLEMENT_NOT_FOUND"
27
+ ENTITLEMENT_EXPIRED: Final = "ENTITLEMENT_EXPIRED"
28
+ ENTITLEMENT_REVOKED: Final = "ENTITLEMENT_REVOKED"
29
+ ENTITLEMENT_SUSPENDED: Final = "ENTITLEMENT_SUSPENDED"
30
+ DEVICE_IN_USE: Final = "DEVICE_IN_USE"
31
+ INSTANCE_ALREADY_RUNNING: Final = "INSTANCE_ALREADY_RUNNING"
32
+ DEVICE_LIMIT_EXCEEDED: Final = "DEVICE_LIMIT_EXCEEDED"
33
+ SESSION_REVOKED: Final = "SESSION_REVOKED"
34
+ SESSION_SUPERSEDED: Final = "SESSION_SUPERSEDED"
35
+ TAKEOVER_LIMIT_EXCEEDED: Final = "TAKEOVER_LIMIT_EXCEEDED"
36
+ DEVICE_NOT_FOUND: Final = "DEVICE_NOT_FOUND"
37
+ DEVICE_RELEASE_LIMIT_EXCEEDED: Final = "DEVICE_RELEASE_LIMIT_EXCEEDED"
38
+ PRODUCT_NOT_FOUND: Final = "PRODUCT_NOT_FOUND"
39
+ PRODUCT_SUSPENDED: Final = "PRODUCT_SUSPENDED"
40
+ RATE_LIMITED: Final = "RATE_LIMITED"
41
+ IDEMPOTENCY_KEY_CONFLICT: Final = "IDEMPOTENCY_KEY_CONFLICT"
42
+ VALIDATION_FAILED: Final = "VALIDATION_FAILED"
43
+ TEST_MODE_ONLY: Final = "TEST_MODE_ONLY"
44
+ INTERNAL_ERROR: Final = "INTERNAL_ERROR"
45
+ ENTITLEMENT_VERSION_NOT_COVERED: Final = "ENTITLEMENT_VERSION_NOT_COVERED"
46
+ NETWORK_ERROR: Final = "NETWORK_ERROR"
47
+ PROTOCOL_ERROR: Final = "PROTOCOL_ERROR"
48
+ STORAGE_FAILED: Final = "STORAGE_FAILED"
49
+ NOT_SIGNED_IN: Final = "NOT_SIGNED_IN"
50
+ TOKEN_INVALID: Final = "TOKEN_INVALID"
51
+ GENERATION_REGRESSED: Final = "GENERATION_REGRESSED"
52
+ OFFLINE_EXPIRED: Final = "OFFLINE_EXPIRED"
53
+ DOWNLOAD_INTEGRITY: Final = "DOWNLOAD_INTEGRITY"
54
+ LOGIN_CANCELLED: Final = "LOGIN_CANCELLED"
55
+ CONFIGURATION: Final = "CONFIGURATION"
56
+ WEBHOOK_INVALID: Final = "WEBHOOK_INVALID"
57
+
58
+ #: API 에러 코드와 그 HTTP 상태.
59
+ API_HTTP_STATUS: Final[Mapping[str, int]] = MappingProxyType({
60
+ "INVALID_CLIENT": 401,
61
+ "AUTHORIZATION_PENDING": 400,
62
+ "SLOW_DOWN": 400,
63
+ "EXPIRED_TOKEN": 401,
64
+ "INVALID_GRANT": 400,
65
+ "SCOPE_INSUFFICIENT": 403,
66
+ "ENTITLEMENT_NOT_FOUND": 404,
67
+ "ENTITLEMENT_EXPIRED": 403,
68
+ "ENTITLEMENT_REVOKED": 403,
69
+ "ENTITLEMENT_SUSPENDED": 403,
70
+ "DEVICE_IN_USE": 409,
71
+ "INSTANCE_ALREADY_RUNNING": 409,
72
+ "DEVICE_LIMIT_EXCEEDED": 409,
73
+ "SESSION_REVOKED": 401,
74
+ "SESSION_SUPERSEDED": 401,
75
+ "TAKEOVER_LIMIT_EXCEEDED": 429,
76
+ "DEVICE_NOT_FOUND": 404,
77
+ "DEVICE_RELEASE_LIMIT_EXCEEDED": 429,
78
+ "PRODUCT_NOT_FOUND": 404,
79
+ "PRODUCT_SUSPENDED": 403,
80
+ "RATE_LIMITED": 429,
81
+ "IDEMPOTENCY_KEY_CONFLICT": 409,
82
+ "VALIDATION_FAILED": 400,
83
+ "TEST_MODE_ONLY": 403,
84
+ "INTERNAL_ERROR": 500,
85
+ "ENTITLEMENT_VERSION_NOT_COVERED": 403,
86
+ })
87
+ #: SDK가 만드는 에러 코드.
88
+ SDK: Final[tuple[str, ...]] = ("NETWORK_ERROR", "PROTOCOL_ERROR", "STORAGE_FAILED", "NOT_SIGNED_IN", "TOKEN_INVALID", "GENERATION_REGRESSED", "OFFLINE_EXPIRED", "DOWNLOAD_INTEGRITY", "LOGIN_CANCELLED", "CONFIGURATION", "WEBHOOK_INVALID")
89
+
90
+
91
+ class EntitlementStatus:
92
+ """EntitlementStatus 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
93
+
94
+ ACTIVE: Final = "ACTIVE"
95
+ EXPIRED: Final = "EXPIRED"
96
+ SUSPENDED: Final = "SUSPENDED"
97
+ REVOKED: Final = "REVOKED"
98
+ KNOWN: Final[tuple[str, ...]] = ("ACTIVE", "EXPIRED", "SUSPENDED", "REVOKED")
99
+
100
+
101
+ class SubscriptionStatus:
102
+ """SubscriptionStatus 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
103
+
104
+ ACTIVE: Final = "ACTIVE"
105
+ PAST_DUE: Final = "PAST_DUE"
106
+ CANCEL_SCHEDULED: Final = "CANCEL_SCHEDULED"
107
+ UNPAID: Final = "UNPAID"
108
+ EXPIRED: Final = "EXPIRED"
109
+ KNOWN: Final[tuple[str, ...]] = ("ACTIVE", "PAST_DUE", "CANCEL_SCHEDULED", "UNPAID", "EXPIRED")
110
+
111
+
112
+ class GrantType:
113
+ """GrantType 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
114
+
115
+ PURCHASE: Final = "PURCHASE"
116
+ RENEWAL: Final = "RENEWAL"
117
+ TRIAL: Final = "TRIAL"
118
+ COMPENSATION: Final = "COMPENSATION"
119
+ MANUAL: Final = "MANUAL"
120
+ TEST: Final = "TEST"
121
+ KNOWN: Final[tuple[str, ...]] = ("PURCHASE", "RENEWAL", "TRIAL", "COMPENSATION", "MANUAL", "TEST")
122
+
123
+
124
+ class UpdateStatus:
125
+ """UpdateStatus 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
126
+
127
+ UP_TO_DATE: Final = "UP_TO_DATE"
128
+ AVAILABLE: Final = "AVAILABLE"
129
+ REQUIRED: Final = "REQUIRED"
130
+ KNOWN: Final[tuple[str, ...]] = ("UP_TO_DATE", "AVAILABLE", "REQUIRED")
131
+
132
+
133
+ class InstallMode:
134
+ """InstallMode 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
135
+
136
+ HOSTED: Final = "HOSTED"
137
+ EXTERNAL: Final = "EXTERNAL"
138
+ KNOWN: Final[tuple[str, ...]] = ("HOSTED", "EXTERNAL")
139
+
140
+
141
+ class UpdateCoverageType:
142
+ """UpdateCoverageType 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
143
+
144
+ ALL: Final = "ALL"
145
+ UNTIL: Final = "UNTIL"
146
+ KNOWN: Final[tuple[str, ...]] = ("ALL", "UNTIL")
147
+
148
+
149
+ class DistributionTarget:
150
+ """DistributionTarget 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
151
+
152
+ WINDOWS_X64: Final = "WINDOWS_X64"
153
+ WINDOWS_ARM64: Final = "WINDOWS_ARM64"
154
+ MACOS_UNIVERSAL: Final = "MACOS_UNIVERSAL"
155
+ MACOS_ARM64: Final = "MACOS_ARM64"
156
+ MACOS_X64: Final = "MACOS_X64"
157
+ LINUX_X64: Final = "LINUX_X64"
158
+ LINUX_ARM64: Final = "LINUX_ARM64"
159
+ BROWSER_EXTENSION: Final = "BROWSER_EXTENSION"
160
+ ANDROID: Final = "ANDROID"
161
+ IOS: Final = "IOS"
162
+ SOURCE_ARCHIVE: Final = "SOURCE_ARCHIVE"
163
+ KNOWN: Final[tuple[str, ...]] = ("WINDOWS_X64", "WINDOWS_ARM64", "MACOS_UNIVERSAL", "MACOS_ARM64", "MACOS_X64", "LINUX_X64", "LINUX_ARM64", "BROWSER_EXTENSION", "ANDROID", "IOS", "SOURCE_ARCHIVE")
164
+
165
+
166
+ class DevicePlatform:
167
+ """DevicePlatform 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
168
+
169
+ WINDOWS: Final = "WINDOWS"
170
+ MACOS: Final = "MACOS"
171
+ LINUX: Final = "LINUX"
172
+ ANDROID: Final = "ANDROID"
173
+ IOS: Final = "IOS"
174
+ OTHER: Final = "OTHER"
175
+ KNOWN: Final[tuple[str, ...]] = ("WINDOWS", "MACOS", "LINUX", "ANDROID", "IOS", "OTHER")
176
+
177
+
178
+ class Scope:
179
+ """Scope 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
180
+
181
+ ENTITLEMENT_READ: Final = "entitlement.read"
182
+ SESSION_WRITE: Final = "session.write"
183
+ DEVICE_MANAGE: Final = "device.manage"
184
+ PROFILE_READ: Final = "profile.read"
185
+ PROFILE_EMAIL: Final = "profile.email"
186
+ VERSION_READ: Final = "version.read"
187
+ KNOWN: Final[tuple[str, ...]] = ("entitlement.read", "session.write", "device.manage", "profile.read", "profile.email", "version.read")
188
+
189
+
190
+ class SessionStateType:
191
+ """SessionStateType 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
192
+
193
+ STARTING: Final = "Starting"
194
+ ACTIVE: Final = "Active"
195
+ DEGRADED: Final = "Degraded"
196
+ NEEDS_DECISION: Final = "NeedsDecision"
197
+ LOCKED: Final = "Locked"
198
+ STOPPED: Final = "Stopped"
199
+ KNOWN: Final[tuple[str, ...]] = ("Starting", "Active", "Degraded", "NeedsDecision", "Locked", "Stopped")
200
+
201
+
202
+ class NeedsDecisionReason:
203
+ """NeedsDecisionReason 값 — 열린 열거다. 모르는 값도 문자열 그대로 담긴다(명세 0절 5)."""
204
+
205
+ DEVICE_IN_USE: Final = "DEVICE_IN_USE"
206
+ INSTANCE_ALREADY_RUNNING: Final = "INSTANCE_ALREADY_RUNNING"
207
+ DEVICE_LIMIT_EXCEEDED: Final = "DEVICE_LIMIT_EXCEEDED"
208
+ KNOWN: Final[tuple[str, ...]] = ("DEVICE_IN_USE", "INSTANCE_ALREADY_RUNNING", "DEVICE_LIMIT_EXCEEDED")
209
+
210
+
211
+ class Route(NamedTuple):
212
+ """공개 API 경로 (contracts routes)."""
213
+
214
+ method: str
215
+ path: str
216
+
217
+
218
+ class Routes:
219
+ """공개 API 경로."""
220
+
221
+ ACQUIRE_SESSION: Final = Route("POST", "/v1/sessions")
222
+ EXCHANGE_TOKEN: Final = Route("POST", "/v1/oauth/token")
223
+ GET_JWKS: Final = Route("GET", "/.well-known/jwks.json")
224
+ GET_LATEST_RELEASE: Final = Route("GET", "/v1/products/{id}/latest")
225
+ GET_MY_ENTITLEMENT: Final = Route("GET", "/v1/entitlements/me")
226
+ GET_OPEN_ID_CONFIGURATION: Final = Route("GET", "/.well-known/openid-configuration")
227
+ GET_PRODUCT_UPDATES: Final = Route("GET", "/v1/products/{id}/updates")
228
+ GET_PROFILE: Final = Route("GET", "/v1/profile")
229
+ HEARTBEAT_SESSION: Final = Route("POST", "/v1/sessions/{sid}/heartbeat")
230
+ ISSUE_DEVICE_CODE: Final = Route("POST", "/v1/oauth/device_code")
231
+ LIST_DEVICES: Final = Route("GET", "/v1/devices")
232
+ RELEASE_DEVICE: Final = Route("DELETE", "/v1/devices/{deviceId}")
233
+ RELEASE_SESSION: Final = Route("DELETE", "/v1/sessions/{sid}")
234
+ REVOKE_TOKEN: Final = Route("POST", "/v1/oauth/revoke")
235
+
236
+
237
+ class Rules:
238
+ """규칙 (sdks/spec/rules.json)."""
239
+
240
+ SPEC_VERSION: Final = "1.2.0"
241
+ API: Final = "v1"
242
+ USER_AGENT_LANGUAGES: Final[tuple[str, ...]] = ("typescript", "dotnet", "swift", "kotlin", "python", "go", "rust", "c")
243
+ USER_AGENT_PATTERN: Final = "^bydev-(typescript|dotnet|swift|kotlin|python|go|rust|c)/[0-9]+\\.[0-9]+\\.[0-9]+(-[0-9A-Za-z.-]+)?( .+)?$"
244
+ HTTP_TIMEOUT_SEC: Final = 30
245
+ LOGIN_POLL_JITTER_MIN: Final = 1.0
246
+ LOGIN_POLL_JITTER_MAX: Final = 1.15
247
+ LOGIN_SLOW_DOWN_INCREMENT_SEC: Final = 5
248
+ TOKEN_REFRESH_SKEW_SEC: Final = 60
249
+ TOKEN_REFRESH_RETRY_DELAYS_SEC: Final[tuple[float, ...]] = (1.0, 3.0, 7.0)
250
+ TOKEN_CLOCK_LEEWAY_SEC: Final = 60
251
+ SESSION_HEARTBEAT_JITTER_MIN: Final = 0.85
252
+ SESSION_HEARTBEAT_JITTER_MAX: Final = 1.15
253
+ SESSION_START_RETRY_DELAYS_SEC: Final[tuple[float, ...]] = (2.0, 5.0, 10.0, 30.0, 60.0)
254
+ JWKS_DEFAULT_MAX_AGE_SEC: Final = 300
255
+ JWKS_UNKNOWN_KID_REFETCH_MIN_INTERVAL_SEC: Final = 60
256
+ FINGERPRINT_ALGORITHM: Final = "SHA-256"
257
+ FINGERPRINT_SALT: Final = "bydev-device-v1"
258
+ FINGERPRINT_ENCODING: Final = "hex-lower"
259
+ FINGERPRINT_SOURCE_READ_ATTEMPTS: Final = 3
260
+ FINGERPRINT_SOURCE_READ_RETRY_DELAY_MS: Final = 300
261
+ STORAGE_SERVICE: Final = "dev.developedby.sdk"
262
+ STORAGE_RECORD_VERSION: Final = 1
263
+ TRANSIENT_CODES: Final[tuple[str, ...]] = ("NETWORK_ERROR", "RATE_LIMITED", "INTERNAL_ERROR")
264
+ TRANSIENT_UNKNOWN_CODE_STATUSES: Final[tuple[int, ...]] = (429,)
265
+ TRANSIENT_UNKNOWN_CODE_STATUS_RANGES: Final[tuple[tuple[int, int], ...]] = ((500, 599),)
266
+ WEBHOOK_SIGNATURE_VERSION: Final = "v1"
267
+ WEBHOOK_SECRET_PREFIX: Final = "whsec_"
268
+ WEBHOOK_TOLERANCE_SEC: Final = 300
269
+ SDK_ERROR_CODES: Final[tuple[str, ...]] = ("NETWORK_ERROR", "PROTOCOL_ERROR", "STORAGE_FAILED", "NOT_SIGNED_IN", "TOKEN_INVALID", "GENERATION_REGRESSED", "OFFLINE_EXPIRED", "DOWNLOAD_INTEGRITY", "LOGIN_CANCELLED", "CONFIGURATION", "WEBHOOK_INVALID")
270
+ SESSION_STATES: Final[tuple[str, ...]] = ("Starting", "Active", "Degraded", "NeedsDecision", "Locked", "Stopped")
271
+ NEEDS_DECISION_REASONS: Final[tuple[str, ...]] = ("DEVICE_IN_USE", "INSTANCE_ALREADY_RUNNING", "DEVICE_LIMIT_EXCEEDED")