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 +168 -0
- bydev/_api.py +157 -0
- bydev/_generated.py +271 -0
- bydev/_support.py +195 -0
- bydev/_tokens.py +131 -0
- bydev/_verifier.py +165 -0
- bydev/aio.py +55 -0
- bydev/client.py +160 -0
- bydev/defaults.py +117 -0
- bydev/errors.py +78 -0
- bydev/login.py +140 -0
- bydev/models.py +660 -0
- bydev/platform.py +403 -0
- bydev/ports.py +182 -0
- bydev/py.typed +0 -0
- bydev/server.py +90 -0
- bydev/session.py +556 -0
- bydev-0.1.0.dist-info/METADATA +185 -0
- bydev-0.1.0.dist-info/RECORD +22 -0
- bydev-0.1.0.dist-info/WHEEL +4 -0
- bydev-0.1.0.dist-info/licenses/LICENSE-APACHE +202 -0
- bydev-0.1.0.dist-info/licenses/LICENSE-MIT +21 -0
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")
|