Module firstparty 

First-party standard adapters embedded in the toolchain (v0.17 §4.2).

The bynk conformance surface is shipped with the compiler rather than authored by the user. When a project consumes bynk, the driver injects the adapter source below as a synthetic unit and provides its binding for the selected Platform. The bynk root namespace is reserved (bynk.namespace.reserved) so user code can never collide with it.

Enums

Platform

The deploy platform — a selection axis distinct from the --target {bundle,workers} emit mode (§6.2). It chooses which bynk-<platform>.ts binding is linked for the bynk surface. v0.17 shipped cloudflare; v0.18 adds node, making the axis observable (and giving v0.19’s platform-lock enforcement a second platform to fire against).

Constants

BYNK_ADAPTER_SRC

The reserved bynk conformance-surface adapter (env-free core). It has no binding clause — the toolchain supplies one per platform (see Platform::bynk_binding_source).

BYNK_LIST_SRC

bynk.list — combinators over the List kernel (fold, prepend, length, get, foldEff), written in ordinary Bynk (decision 0034): the first real consumer of v0.20a generics, lambdas, and effectful traversal. Order-preserving combinators build with fold + prepend and a final reverse — O(n) builds, never append (which would be O(n²) over the array lowering).

BYNK_LOCALE_SRC

bynk.locale — the bundle-free render/renderArg helpers and the message/withText/withWhole/withNum/withMoment builder API (slice 1: render formats code plus a deterministic sorted-by-key rendering of params; no lookup, no locale-dependent behaviour). uses bynk.locale.types for the types its own signatures name.

BYNK_LOCALE_TYPES_SRC

bynk.locale.types — LocaleTag, MessageArg, Message: a dependency-free leaf (no uses of its own) so any consumer, including the bynk adapter itself, can reach these types without also reaching bynk.locale’s value-level API.

BYNK_MAP_SRC

bynk.map — combinators over the Map kernel (empty, insert, get, keys, length). fromList is deliberately absent: Bynk has no pair type to spell a List[(K, V)] with, so map construction is Map.empty()

BYNK_STRING_SRC

bynk.string — Bynk-written helpers over the v0.22a string kernel (concat, the List fold, and the Option kernel methods). The kernel itself is compiler built-in (ADR 0046); only derived helpers live here. join folds to Option[String] so empty-string elements are joined faithfully (a bare "" accumulator could not tell “nothing yet” from “first element was empty”).

BYNK_SURFACE_CAPABILITIES

The capabilities the env-free bynk surface exports (its exports capability { … } line in bynk.bynk). First-party symbols live on synthetic files and are excluded from the binding index, so the unknown-name quick-fix (#852) offering consumes bynk { … } needs this explicit list. Kept in sync with the adapter source by bynk_surface_capabilities_match_the_adapter.

BYNK_UNIT

The unit name of the reserved first-party surface adapter.

CLOUDFLARE_ADAPTER_SRC

The first-party Cloudflare platform adapter (v0.19): the platform’s real infrastructure capabilities, as they are — no portable intersection (decision 0016). The v0.19 surface was the minimal, collection-free Kv (decision 0023); v0.23 adds the list drain and putTtl (0050/0051); structured values are v0.22-codec composition, and Queue remains its own future increment. Like the bynk surface it has no binding clause — the toolchain supplies the binding.

CLOUDFLARE_BINDING_FILENAME

The output path of the Cloudflare platform adapter’s binding module, beside the adapter’s emitted bynk/cloudflare.ts (distinct from the bynk surface’s per-platform bynk-cloudflare.ts).

CLOUDFLARE_UNIT

The unit name of the first-party Cloudflare platform adapter (v0.19, decision 0026): inside the reserved bynk.* prefix, so no separate reservation rule is needed. The surface unit bynk stays the portability marker; bynk.<platform> units are the platform-locked ones.

FIRSTPARTY_SOURCES

Every first-party .bynk source, paired with its unit name — the single list every consumer iterates: hover (describe_firstparty_symbol), completion (EMBEDDED_UNITS), and the parse guard (every_first_party_source_parses). Before this list each consumer kept its own hand-maintained copy, and bynk.locale/bynk.locale.types were added to none of them — so the whole locale surface hovered as nothing and was absent from completion (#901). Add a first-party commons here once; the firstparty_sources_cover_every_src_const drift guard (bynkc/tests/firstparty_sources.rs) fails if a *_SRC const is left out.

KV_BINDING_NAME

The fixed Worker binding name for the Kv namespace (decision C1, v0.19): one namespace, one [[kv_namespaces]] stanza, one env.KV field.

LIST_UNIT

The unit names of the first-party collection commons (v0.20b): the Bynk-written combinator stdlib over the built-in List/Map kernel. Inside the reserved bynk.* prefix; injected when uses-imported.

LOCALE_TYPES_UNIT

Inside the reserved bynk.* prefix; injected when uses-imported. Also uses-imported by the bynk adapter itself, to give capability Locale’s current() -> Effect[LocaleTag] a type to name (an adapter may uses a commons; a commons cannot in turn reference an adapter). Split out of bynk.locale (locale-negotiation-slice-2 follow-up, #886) specifically so a context can reach LocaleTag without also pulling in bynk.locale’s own render — which previously collided with a message-bundle commons’s own synthesised render (ADR 0272) the moment a context needed both.

LOCALE_UNIT

Inside the reserved bynk.* prefix; injected when uses-imported by application code (a message-bundle commons, ADR 0272) — never directly by the bynk adapter itself any more (see LOCALE_TYPES_UNIT).

MAP_UNIT

STRING_UNIT

Inside the reserved bynk.* prefix; injected when uses-imported.

Functions

cloudflare_binding_source

The toolchain-supplied binding for the Cloudflare platform adapter.

platform_of

v0.19 decision 0024: which first-party units are platform-native — consuming one locks its deployment unit to the returned platform. This is the metadata that drives effective-platform computation, env resource typing, and wrangler.toml stanza derivation; no user-facing marker syntax exists (additive later, when third-party platform adapters become a goal).

provider_takes_env

v0.18 decision 0021 / v0.19 decision 0025: which first-party provider classes take the Worker env as a constructor argument, keyed by (unit, provider class). SecretsProvider accepts an optional env with a globalThis probe fallback; WorkersKv requires env on use — KV namespaces exist only on the Worker env, never on globalThis.