@adland/embed 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# @adland/embed
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [488490a]
+- Updated dependencies [859ebec]
+  - @adland/react@0.18.1
+  - @adland/data@0.16.3
+
+## 0.1.0
+
+### Minor Changes
+
+- b32cc89: Publisher SDK: platform-agnostic config, action adapters, and a framework-free web component.
+
+  - **@adland/react**: optional `AdlandProvider` supplying `endpoint`/`gateway`/`rpcUrl`/`chainId`/`consent`/`onEvent` defaults (all overridable per-`Ad`); stable `AdEvent` shape mirrored to a publisher `onEvent`; consent-gated analytics beacon (default `granted`); `context` → `placement` with `context` kept as a deprecated alias. New `ActionAdapter` seam with `WebActionAdapter`/`FarcasterActionAdapter` (default preserves current behavior); injectable viem chain registry + `subgraphUrl`. New React-free `./core` and `./farcaster` subpath exports.
+  - **@adland/embed** (new): `<adland-slot>` custom element with `render-mode` `isolated` (sandboxed iframe, default) and `inline` (shadow DOM with `::part()` hooks), CSS custom-property theming, and impression/click tracking. Dual self-contained CDN bundles — `adland.js` (web, zero Farcaster) and `adland-farcaster.js` (Mini App). Copy-paste simple by default, deeply customizable when wanted.
+  - **@adland/data**: guard `process.env` access so the module is safe when bundled into browser builds.
+
+- 55d2d70: Verified-impression handshake (opt-in).
+
+  - `@adland/react/core`: `trackVerifiedImpression` requests a single-use nonce from `/v1/serve` on mount, waits for a viewability dwell, then posts a verified `/v1/event`, falling back to the legacy `/track` beacon if the verified path is unavailable — an impression is never lost. Opt in with the new `verified` prop on `Ad` (or the provider). `tracking` was refactored to separate the local `onEvent` mirror from the network beacon.
+  - `@adland/embed`: opt in with a `verified` attribute on `<adland-slot>`.
+
+  Server support (`apps/api`, unpublished): `/v1/serve` + `/v1/event` with an origin bound to the request header, a single-use nonce store, and additive `verified`/`placement`/`viewable_ms` columns on `events`. Legacy `/track` continues to work and records `verified: false`.
+
+- cf1313d: Make the ad render path version-proof and drop the 0xSlots SDK from the bundle.
+
+  Reading a slot's creative used to go through the SDK's `getSlotInfo()`, which decodes a large struct whose shape changes as the protocol evolves — a slot deployed after the `module` → `utility` rename fails to decode against an older SDK ABI, breaking rendering entirely. The render path now issues two single-value reads instead (`module()` on the slot, then `tokenURI(slot)` on the module), which cannot drift that way.
+
+  With the last value import of `@0xslots/sdk` removed (`SlotsChain.BASE` is now a plain constant), the SDK no longer ends up in a publisher's bundle at all.
+
+  Breaking for two low-level exports — `<Ad>` and `<adland-slot>` are unchanged:
+
+  - `createReadClient` now returns a viem `PublicClient` instead of a `SlotsClient`, and no longer takes a `subgraphUrl` argument.
+  - `fetchMetadataURI` now takes a viem `PublicClient`.
+  - `AdlandConfig.subgraphUrl` is removed; reads need RPC only.
+
+### Patch Changes
+
+- Updated dependencies [b32cc89]
+- Updated dependencies [55d2d70]
+- Updated dependencies [cf1313d]
+  - @adland/react@0.18.0
+  - @adland/data@0.16.2

package/README.md

@@ -0,0 +1,72 @@
+# @adland/embed
+
+Framework-free `<adland-slot>` web component for embedding AdLand ad slots on any
+site — no React required.
+
+## Copy & paste
+
+```html
+<script src="https://cdn.adland.space/v1/adland.js" async></script>
+
+<adland-slot slot="0xYourSlotAddress"></adland-slot>
+```
+
+That renders a polished ad card in a sandboxed iframe (`render-mode="isolated"`,
+the safe default). Nothing else to configure.
+
+For Farcaster Mini Apps, use the Mini App bundle instead — same element, Farcaster
+click routing:
+
+```html
+<script src="https://cdn.adland.space/v1/adland-farcaster.js" async></script>
+```
+
+## Attributes
+
+| Attribute       | Description                                                        |
+| --------------- | ------------------------------------------------------------------ |
+| `slot`          | Slot contract address (required unless `data-ad` is set)           |
+| `chain`         | Chain id (default `8453`)                                          |
+| `render-mode`   | `isolated` (default, sandboxed iframe) or `inline` (shadow DOM)    |
+| `placement`     | Label sent with events (e.g. `sidebar`)                           |
+| `gateway`       | IPFS gateway origin                                                |
+| `endpoint`      | Analytics API base URL                                             |
+| `consent`       | `pending` \| `granted` \| `denied` (gates the beacon)             |
+| `rpc-url`       | Read RPC override                                                 |
+| `base-link-url` | Base URL for the empty-slot CTA                                    |
+| `data-ad`       | Inline ad JSON to render without an on-chain read                 |
+
+## Styling
+
+Three levels, pick what you need:
+
+1. **Nothing** — the default card looks good out of the box.
+2. **Quick theming** — set `--adland-*` custom properties on the element. These
+   apply in both render modes (they're copied into the isolated iframe):
+
+   ```html
+   <adland-slot
+     slot="0x…"
+     style="--adland-bg:#111;--adland-fg:#fff;--adland-radius:16px"
+   ></adland-slot>
+   ```
+
+3. **Deep control** — use `render-mode="inline"` and style the exposed parts:
+
+   ```css
+   adland-slot::part(card) { border: 2px solid hotpink; }
+   adland-slot::part(title) { font-family: "Georgia"; }
+   ```
+
+   Parts: `card`, `media`, `body`, `title`, `description`, `badge`, `label`.
+
+React users wanting full control should use the compound components in
+[`@adland/react`](../react) instead.
+
+## Programmatic use
+
+```ts
+import { registerAdlandSlot, WebActionAdapter } from "@adland/embed";
+// Auto-registered with the web adapter on import; call again to customize.
+registerAdlandSlot(WebActionAdapter);
+```