s-librarykit 0.2.0__tar.gz → 0.3.1__tar.gz

{s_librarykit-0.2.0 → s_librarykit-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s-librarykit
-Version: 0.2.0
+Version: 0.3.1
 Summary: Жирный КОРЕНЬ китов: единая error-иерархия, config/retry/paths-утили, checkpoint/resume, транспорт/auth/sessions — общий код для clikit, adapterkit и доменных пакетов.
 Author: Dmitry
 License: MIT

{s_librarykit-0.2.0 → s_librarykit-0.3.1}/librarykit/__init__.py

@@ -10,6 +10,11 @@ from __future__ import annotations
 
 # blocks (W8): GENERIC draft.js richtext block-хелперы (текст/заголовок/список).
 from librarykit import blocks
+
+# antibot warmup-минт (W4): генерик-«монетный двор» одноразовых токенов тёплой
+# страницей (обобщение chatgpt Sentinel). Механика в ките, семантика (trigger/
+# match) — у сервиса. Тянет только stdlib — реэкспорт наверх безопасен.
+from librarykit.antibot import TokenHarvest, WarmupTokenMinter
 from librarykit.auth import (
     CSRF_DEFAULT_HEADER,
     BrowserLoginAuth,
@@ -244,158 +249,100 @@ from librarykit.windows import (
     parse_window,
 )
 
-__version__ = "0.2.0"
+__version__ = "0.3.1"
 
 __all__ = [
     "__version__",
-    # checkpoint
-    "Checkpoint",
-    "JsonlSink",
-    "RunMetrics",
-    # errors (единая иерархия ERROR-HUB)
-    "CliError",
-    "ApiError",
-    "AuthRequired",
-    "SessionExpired",
-    "RateLimited",
-    "ValidationError",
-    "NotImplementedYet",
-    "NotFoundError",
-    "ServerError",
-    "TransportError",
-    "Blocked",
-    "RETRYABLE",
-    "AdapterError",
-    "NotFound",
-    "GraphQLError",
-    # config_util / paths
-    "deep_merge",
-    "interpolate_env",
-    "load_dotenv",
-    "slugify",
-    "normalize_account_id",
-    "atomic_write_text",
-    "chmod_600",
-    "AppPaths",
-    # session_paths — единый резолвер браузерных сессий (~/.sessions)
-    "sessions_home",
-    "browser_profile_dir",
-    "shared_google_profile_dir",
-    "make_profile_dir_resolver",
-    "make_session_store",
-    # contract — generic «талия» (Protocol + enums + DTO координат сессии/кредов)
-    "PaginationMode",
-    "AuthMode",
+    # requesting: транспорт-исполнители + режимы/протоколы запроса
     "TransportKind",
     "RequestExecutionMode",
-    "SessionRef",
-    "Creds",
     "RequestBody",
     "ResponseLike",
     "Transport",
     "SyncTransport",
     "HttpRequestExecutor",
     "SyncHttpRequestExecutor",
-    "StreamTransport",
+    "Codec",
+    "make_transport",
+    "register_transport",
+    "create_request_executor",
+    "register_request_provider",
+    "HttpxTransport",
+    "HttpxRequestExecutor",
+    "HttpClient",
+    "RestHttpClient",
+    "HttpxSyncTransport",
+    "HttpxSyncRequestExecutor",
+    "SyncHttpClient",
+    # browser/сессии: ЖЦ браузер-сессии + профили + warmup-минт
     "BrowserBackend",
     "SyncBrowserBackend",
     "BrowserSession",
     "SyncBrowserSession",
-    "Codec",
-    "Auth",
-    # factory — нейтральный выбор транспорта/браузера по роли (Enum → фабрика → реестр)
     "BrowserEngine",
     "BrowserProvider",
     "AutomationDriver",
     "BrowserOptions",
     "BrowserSessionSettings",
-    "make_transport",
-    "register_transport",
-    "create_request_executor",
-    "register_request_provider",
     "make_browser_backend",
     "register_browser_backend",
     "create_browser_session",
     "register_browser_provider",
+    "sessions_home",
+    "browser_profile_dir",
+    "shared_google_profile_dir",
+    "make_profile_dir_resolver",
+    "make_session_store",
+    "WarmupTokenMinter",
+    "TokenHarvest",
+    # auth + refresh: стратегии авторизации + проактивное обновление сессии
+    "AuthMode",
+    "Auth",
     "Refreshable",
     "ProactiveRefreshable",
     "SyncRefreshable",
     "SyncProactiveRefreshable",
-    "ErrorMapper",
-    "Paginator",
+    "TokenAuth",
+    "CookieSessionAuth",
+    "OAuth2Auth",
+    "BrowserLoginAuth",
+    "CsrfHeaderAuth",
+    "CSRF_DEFAULT_HEADER",
+    "extract_token_from_text",
+    "dump_settings",
+    "load_settings",
+    "encrypt_settings",
+    "decrypt_settings",
+    "RotatingAuth",
+    "Keepalive",
+    "RefreshableChain",
+    "DEFAULT_ROTATE_INTERVAL",
+    # sessions + secrets: envelope-хранилище сессий + креды + keyring-стор
+    "SessionRef",
+    "Creds",
     "SessionStoreProtocol",
-    # contract — квоты/лимиты (generic DTO)
-    "QuotaScope",
-    "QuotaInfo",
-    "LimitSpec",
-    # protocols — онбординг/health контракты (опциональные)
-    "LoginMode",
-    "LoginRequirements",
-    "InteractiveFlow",
-    "OnboardingProtocol",
-    "HealthState",
-    "HealthStatus",
-    "HealthProtocol",
-    # entities (W6) — нейтральные data-классы оркестраторов (почва под W7)
-    "Session",
-    "SessionChanges",
-    "SessionContext",
-    "HealthReport",
-    # secret_store — keyring + file-fallback
-    "SecretStore",
-    # sessions (W4): envelope-шифрованное хранилище сессий (spec §4)
     "SessionStore",
     "SessionStoreError",
     "KekUnavailableError",
     "resolve_kek",
-    # transport (W4): конкретный httpx-транспорт + choke-point клиент
-    "HttpxTransport",
-    "HttpxRequestExecutor",
-    "HttpClient",
-    "RestHttpClient",
-    # transport sync-сиблинги (для навыков без event-loop)
-    "HttpxSyncTransport",
-    "HttpxSyncRequestExecutor",
-    "SyncHttpClient",
-    # forms (W8): кодек form-urlencoded тел с nested-JSON полями
-    "FormCodec",
-    # graphql (W8): GENERIC GraphQL-клиент поверх RestHttpClient/HttpClient
-    "GraphQLClient",
-    # upload (W8): GENERIC resumable chunked uploader
-    "ChunkedUploader",
-    "UploadResult",
-    # blocks (W8): GENERIC draft.js richtext block-хелперы
-    "blocks",
-    "text_block",
-    "block_end",
-    "header_block",
-    "list_item_block",
-    "paragraphs",
-    "decode_text_block",
-    # limit: проактивный конфигуратор троттлинга / rate-limit по scope
-    "LimitWindow",
-    "LimitPolicy",
-    "LimitScope",
-    "RateLimiter",
-    # windows: обобщённые ОКНА лимитов (rolling/calendar/fixed) + фабрика
-    "Window",
-    "RollingWindow",
-    "CalendarWindow",
-    "FixedWindow",
-    "parse_window",
-    # pool: балансер N аккаунтов одного сервиса (селектор поверх SessionStore)
-    "SessionPool",
-    "PoolChoice",
-    "DEFAULT_SKIP_STATUSES",
-    # rpc (E1): codec-слой + RPC choke-point поверх HttpClient
-    "JsonCodec",
-    "PrefixedJsonCodec",
-    "RpcClient",
-    # stream (E1): WS-подобные persistent-транспорты (Stub + websockets reference)
-    "StubStreamTransport",
-    "WebSocketsStreamTransport",
-    "StreamClosedError",
-    # errmap (W4): декларативная карта HTTP-ответ → доменная ошибка
+    "SecretStore",
+    # errors + errmap: единая иерархия ERROR-HUB + карта ответ→ошибка
+    "CliError",
+    "ApiError",
+    "AuthRequired",
+    "SessionExpired",
+    "RateLimited",
+    "ValidationError",
+    "NotImplementedYet",
+    "NotFoundError",
+    "ServerError",
+    "TransportError",
+    "Blocked",
+    "RETRYABLE",
+    "AdapterError",
+    "NotFound",
+    "GraphQLError",
+    "ErrorMapper",
     "ErrorMap",
     "ErrorMapBuilder",
     "BodyRule",
@@ -403,7 +350,27 @@ __all__ = [
     "AuthExpired",
     "build_error_map",
     "DEFAULT_ERROR_MAP",
-    # pagination (W4): листатель ресурса (offset/cursor/page) tweepy-стиля
+    # reliability: retry / limit / pool / checkpoint
+    "RetryPolicy",
+    "DEFAULT_RETRY",
+    "SimpleRetryPolicy",
+    "DEFAULT_SIMPLE_RETRY",
+    "LimitWindow",
+    "LimitPolicy",
+    "LimitScope",
+    "RateLimiter",
+    "LimitSpec",
+    "QuotaScope",
+    "QuotaInfo",
+    "SessionPool",
+    "PoolChoice",
+    "DEFAULT_SKIP_STATUSES",
+    "Checkpoint",
+    "JsonlSink",
+    "RunMetrics",
+    # pagination / bulk / upload: листание ресурса + батчи + resumable-догрузка
+    "PaginationMode",
+    "Paginator",
     "CursorPaginator",
     "PageParams",
     "DEFAULT_PAGE_PARAMS",
@@ -412,40 +379,52 @@ __all__ = [
     "default_extract_items",
     "default_extract_cursor",
     "with_page_params",
-    # pagination flat-page (W8): offset/total на верхнем уровне тела
     "FlatPage",
     "parse_flat_page",
     "next_flat_offset",
-    # auth (W4): стратегии авторизации + персистентность сессии
-    "TokenAuth",
-    "CookieSessionAuth",
-    "OAuth2Auth",
-    "BrowserLoginAuth",
-    "CsrfHeaderAuth",
-    "CSRF_DEFAULT_HEADER",
-    "extract_token_from_text",
-    "dump_settings",
-    "load_settings",
-    "encrypt_settings",
-    "decrypt_settings",
-    # refresh: проактивное обновление ротируемой сессии + keepalive + fallback
-    "RotatingAuth",
-    "Keepalive",
-    "RefreshableChain",
-    "DEFAULT_ROTATE_INTERVAL",
-    # retry
-    "RetryPolicy",
-    "DEFAULT_RETRY",
-    "SimpleRetryPolicy",
-    "DEFAULT_SIMPLE_RETRY",
-    # bulk: движок батч-операций над набором id (per-item outcome, не роняет батч)
     "BulkOutcome",
     "BulkOperationError",
     "BulkError",
     "BulkOperationResult",
     "run_bulk",
     "run_bulk_async",
-    # redaction: маски секретов + truncation для HTTP-заголовков/body (audit/логи)
+    "ChunkedUploader",
+    "UploadResult",
+    # orchestration / protocols / entities: онбординг/health + нейтральные data-классы
+    "LoginMode",
+    "LoginRequirements",
+    "InteractiveFlow",
+    "OnboardingProtocol",
+    "HealthState",
+    "HealthStatus",
+    "HealthProtocol",
+    "Session",
+    "SessionChanges",
+    "SessionContext",
+    "HealthReport",
+    # rpc / stream / graphql: codec-слой + persistent-транспорты + GraphQL-клиент
+    "StreamTransport",
+    "JsonCodec",
+    "PrefixedJsonCodec",
+    "RpcClient",
+    "StubStreamTransport",
+    "WebSocketsStreamTransport",
+    "StreamClosedError",
+    "GraphQLClient",
+    # blocks / forms / windows / redaction / config: примитивы тел, окна, маски, утили путей
+    "blocks",
+    "text_block",
+    "block_end",
+    "header_block",
+    "list_item_block",
+    "paragraphs",
+    "decode_text_block",
+    "FormCodec",
+    "Window",
+    "RollingWindow",
+    "CalendarWindow",
+    "FixedWindow",
+    "parse_window",
     "SECRET_MASK",
     "HEADER_BLACKLIST",
     "BODY_FIELD_PATTERNS",
@@ -453,4 +432,12 @@ __all__ = [
     "sanitize_body",
     "truncate_body",
     "excerpt_response_body",
+    "deep_merge",
+    "interpolate_env",
+    "load_dotenv",
+    "slugify",
+    "normalize_account_id",
+    "atomic_write_text",
+    "chmod_600",
+    "AppPaths",
 ]

{s_librarykit-0.2.0 → s_librarykit-0.3.1}/librarykit/antibot/__init__.py

@@ -91,12 +91,14 @@ from .page_evaluate import (
     page_fetch,
     sync_page_fetch,
 )
+from .warmup_minter import TokenHarvest, WarmupTokenMinter
 
 # Первичные ролевые имена исполнителей запроса (роль снаружи, вендор — внутри):
 #   ImpersonatedHttpExecutor  — TLS/JA3-impersonate (curl-cffi) [было CurlCffiTransport];
 #   BrowserRequestExecutor    — запрос «руками браузера» по CDP/CamouFox [было CdpTransport];
 #   BorrowedPageRequestExecutor — запрос в ЗАИМСТВОВАННОЙ странице [было PageEvaluateTransport];
-#   BrowserRequester          — роль «умеет выполнить запрос в браузере» [было CdpBrowserBackend].
+#   BrowserRequester          — роль «умеет выполнить запрос в браузере» ПОВЕРХ живой
+#                               contract.BrowserSession (fetch, не ЖЦ) [было CdpBrowserBackend].
 # Старые имена остаются deprecated-псевдонимами (ничего не удалено).
 ImpersonatedHttpExecutor = CurlCffiTransport
 BrowserRequestExecutor = CdpTransport
@@ -116,6 +118,9 @@ __all__ = [
     "page_fetch",
     "sync_page_fetch",
     "pick_chrome_impersonate",
+    # warmup-минт одноразовых токенов тёплой страницей (генерик chatgpt-паттерна)
+    "WarmupTokenMinter",
+    "TokenHarvest",
     # первичные ролевые имена (псевдонимы вендор-классов выше)
     "ImpersonatedHttpExecutor",
     "BrowserRequestExecutor",

{s_librarykit-0.2.0 → s_librarykit-0.3.1}/librarykit/antibot/cdp.py

@@ -23,12 +23,28 @@ from ._helpers import _as_transport_error, _to_httpx_response
 
 @runtime_checkable
 class CdpBrowserBackend(Protocol):
-    """Контракт «движка реального браузера» под `CdpTransport` (точка DI).
+    """Контракт «умеет ВЫПОЛНИТЬ запрос в браузере» (роль `BrowserRequester`), под
+    `CdpTransport` (точка DI).
 
     Скрывает за собой запуск системного Edge/Chrome с `--remote-debugging-port`
     и `connect_over_cdp` (см. recipes/antibot `cdp_real_browser.py`). Реализация —
     в `librarykit.browser` (Playwright/patchright); здесь — только контракт, чтобы
     `antibot` не тащил тяжёлый browser-стек и тестировался фейком той же формы.
+
+    Разделение с `librarykit.contract.BrowserSession` (= `BrowserBackend`) — это
+    ДВЕ РАЗНЫЕ роли, а не одна:
+
+    - `BrowserSession` — ЖИЗНЕННЫЙ ЦИКЛ живой сессии: поднять/держать/закрыть
+      браузер и отдать страницу с контекстом (`ensure_page`/`context`/`aclose`);
+    - `CdpBrowserBackend` (`BrowserRequester`) — СПОСОБНОСТЬ выполнить HTTP-запрос
+      руками уже живой сессии (`fetch`), поверх её страницы/контекста.
+
+    Как Protocol'ы они пересекаются лишь по `aclose()`; ни один не является
+    структурным подтипом другого (у Requester нет `ensure_page`/`context`, у
+    Session нет `fetch`). Конкретные бэкенды `librarykit.browser`
+    (`CdpChromeBackend`/`CamoufoxBackend`) реализуют ОБА контракта одним объектом:
+    он И держит живую сессию, И умеет `fetch` поверх неё — то есть
+    `BrowserRequester` НАДСТРАИВАЕТ исполнение запроса над сессией, не заменяя её.
     """
 
     async def fetch(
@@ -174,11 +190,17 @@ class CdpTransport(Transport):
 
 @runtime_checkable
 class SyncCdpBrowserBackend(Protocol):
-    """Sync-сиблинг `CdpBrowserBackend`: движок реального/stealth-браузера БЕЗ await.
+    """Sync-сиблинг `CdpBrowserBackend`: роль `SyncBrowserRequester` БЕЗ await.
 
-    Та же роль (выполнить запрос внутри живого браузера, вернуть ответоподобный
+    Та же роль «умеет ВЫПОЛНИТЬ запрос в браузере» (`fetch` → ответоподобный
     объект под `_to_httpx_response`), но синхронная сигнатура — для навыков без
     event-loop. Реализация — `librarykit.browser.SyncCamoufoxBackend`.
+
+    То же разделение, что у async-версии: это СПОСОБНОСТЬ исполнить запрос поверх
+    живой сессии, а не её жизненный цикл — ЖЦ (поднять/держать/закрыть, страница+
+    контекст) несёт `librarykit.contract.SyncBrowserSession` (= `SyncBrowserBackend`,
+    `ensure_page`/`context`). Пересечение Protocol'ов — только семантика закрытия;
+    конкретный sync-бэкенд реализует обе роли одним объектом.
     """
 
     def fetch(