@lockerverse/react 0.2.228 → 0.2.230
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.
- package/MIGRATIONS.md +30 -0
- package/README.md +7 -0
- package/dist/auction-item.js +1 -1
- package/dist/auction-item.js.map +1 -1
- package/dist/embed/chunks/auction-payment-view-OKQBWLYB.js +9 -0
- package/dist/embed/chunks/chunk-45NQLOLF.js +2 -0
- package/dist/embed/chunks/chunk-45NQLOLF.js.LEGAL.txt +51 -0
- package/dist/embed/chunks/chunk-6ZVB3IR2.js +2 -0
- package/dist/embed/chunks/chunk-6ZVB3IR2.js.LEGAL.txt +12 -0
- package/dist/embed/chunks/chunk-DCANE7XH.js +1 -0
- package/dist/embed/chunks/chunk-ZHBH4ZF6.js +1 -0
- package/dist/embed/chunks/lockerverse-auction-item-ZKKDIU3S.js +2 -0
- package/dist/embed/chunks/lockerverse-auction-item-ZKKDIU3S.js.LEGAL.txt +23 -0
- package/dist/embed/chunks/telemetry-6KTBIZ2M.js +6 -0
- package/dist/embed/chunks/telemetry-6KTBIZ2M.js.LEGAL.txt +1 -0
- package/dist/embed/lockerverse.js +2 -0
- package/dist/embed/runtime.js +11 -0
- package/dist/embed/runtime.js.LEGAL.txt +23 -0
- package/guides/auctions.md +1 -1
- package/guides/bookings.md +1 -1
- package/guides/browser-embed.md +125 -0
- package/guides/events.md +1 -1
- package/guides/integration.md +1 -1
- package/guides/payment-widgets.md +1 -1
- package/guides/signup.md +1 -1
- package/package.json +4 -3
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
Bundled license information:
|
|
2
|
+
|
|
3
|
+
scheduler/cjs/scheduler.production.js:
|
|
4
|
+
/**
|
|
5
|
+
* @license React
|
|
6
|
+
* scheduler.production.js
|
|
7
|
+
*
|
|
8
|
+
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
9
|
+
*
|
|
10
|
+
* This source code is licensed under the MIT license found in the
|
|
11
|
+
* LICENSE file in the root directory of this source tree.
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
react-dom/cjs/react-dom-client.production.js:
|
|
15
|
+
/**
|
|
16
|
+
* @license React
|
|
17
|
+
* react-dom-client.production.js
|
|
18
|
+
*
|
|
19
|
+
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
20
|
+
*
|
|
21
|
+
* This source code is licensed under the MIT license found in the
|
|
22
|
+
* LICENSE file in the root directory of this source tree.
|
|
23
|
+
*/
|
package/guides/auctions.md
CHANGED
package/guides/bookings.md
CHANGED
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
# Lockerverse browser-embed guide
|
|
2
|
+
|
|
3
|
+
Package: @lockerverse/react@0.2.230
|
|
4
|
+
|
|
5
|
+
Generated from this release's maintained documentation. Do not edit this copy.
|
|
6
|
+
|
|
7
|
+
Read [the shared integration guide](integration.md) first.
|
|
8
|
+
|
|
9
|
+
## Browser embed
|
|
10
|
+
|
|
11
|
+
The browser embed is an optional integration for sites that cannot use the React
|
|
12
|
+
SDK directly. It bundles React and the existing auction interface. The host does
|
|
13
|
+
not need to install React, configure a build tool, or provide an iframe.
|
|
14
|
+
|
|
15
|
+
Use the React SDK when the host already uses React and needs its full component
|
|
16
|
+
API. The embed has a smaller configuration surface. It does not provide template
|
|
17
|
+
slots, custom component renderers, or server-rendered auction content. It is a
|
|
18
|
+
fallback for frameworks without a dedicated Lockerverse integration, not a
|
|
19
|
+
promise of compatibility with every CMS or site security policy.
|
|
20
|
+
|
|
21
|
+
## Add an auction
|
|
22
|
+
|
|
23
|
+
This snippet uses `0.2.230`. Keep the version pinned so a package release does not change the
|
|
24
|
+
host's integration without a review.
|
|
25
|
+
|
|
26
|
+
```html
|
|
27
|
+
<script
|
|
28
|
+
type="module"
|
|
29
|
+
src="https://unpkg.com/@lockerverse/react@0.2.230/dist/embed/lockerverse.js"
|
|
30
|
+
></script>
|
|
31
|
+
|
|
32
|
+
<lockerverse-auctions
|
|
33
|
+
community="auburn"
|
|
34
|
+
auction="auburn-vs-georgia-memorabilia-october-2026"
|
|
35
|
+
theme="light"
|
|
36
|
+
></lockerverse-auctions>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
On first load, the element displays a placeholder while it loads the auction.
|
|
40
|
+
It starts the public catalog request alongside the interface download.
|
|
41
|
+
The host can provide its own placeholder inside the element for the time
|
|
42
|
+
before the script executes.
|
|
43
|
+
|
|
44
|
+
Load the script once per page. No separate stylesheet is required. Remove the
|
|
45
|
+
`auction` attribute to show all public auctions for the community. No API secret
|
|
46
|
+
or private credential belongs in the markup.
|
|
47
|
+
|
|
48
|
+
## Settings
|
|
49
|
+
|
|
50
|
+
| Attribute | Default | Purpose |
|
|
51
|
+
| --- | --- | --- |
|
|
52
|
+
| `community` | Required | Public community slug, such as `auburn`. |
|
|
53
|
+
| `auction` | Not set | Public auction slug. Omit it to start with the community's auctions. |
|
|
54
|
+
| `theme` | `light` | `light` or `dark`. Can change while the element is mounted. |
|
|
55
|
+
| `accent` | SDK default | Optional CSS color for the supported accent treatment. Can change while mounted. |
|
|
56
|
+
| `instance` | `main` | Stable name for this embed's URL parameters. Give each embed on a page a different name. |
|
|
57
|
+
| `nonce` | Not set | Optional server-generated CSP nonce, copied to the embedded stylesheet. Set it before inserting the element. |
|
|
58
|
+
| `environment` | `production` | `production` uses `https://portal.lockerverse.com/api`; `development` uses `https://portal-dev.lockerverse.com/api`. |
|
|
59
|
+
|
|
60
|
+
Treat `community`, `auction`, `environment`, and `instance` as fixed identity
|
|
61
|
+
settings while the element is mounted. To change them, replace it with a new element
|
|
62
|
+
with the new attributes. Moving the same element preserves its original state. Do not replace or remove the element
|
|
63
|
+
while a bid or payment is unresolved. Theme and accent updates do not require a
|
|
64
|
+
remount.
|
|
65
|
+
|
|
66
|
+
The interface uses an open shadow root to keep its styles separate from the host
|
|
67
|
+
page. The gallery overlay stays inside that root. Use the supported attributes
|
|
68
|
+
for appearance changes; internal DOM structure and CSS selectors are not a
|
|
69
|
+
public customization API. Give the element the width needed by the page layout.
|
|
70
|
+
Its content determines its height.
|
|
71
|
+
|
|
72
|
+
## Links and host routing
|
|
73
|
+
|
|
74
|
+
The embed uses page query parameters for auction and item links:
|
|
75
|
+
|
|
76
|
+
- `lv-main-auction` selects an auction.
|
|
77
|
+
- `lv-main-item` selects an item.
|
|
78
|
+
|
|
79
|
+
A custom `instance="vault"` changes these keys to `lv-vault-auction` and
|
|
80
|
+
`lv-vault-item`. Keep instance names stable so shared links continue to work.
|
|
81
|
+
The host must preserve these parameters and serve the page when they are
|
|
82
|
+
present. Confirm direct item links, reload, Back, Forward, and opening links in a
|
|
83
|
+
new tab in the host's router. Other host query parameters remain separate.
|
|
84
|
+
|
|
85
|
+
For Vue or another framework, the host can insert the element as ordinary DOM.
|
|
86
|
+
If its template compiler treats unknown tags as application components,
|
|
87
|
+
configure it to treat `lockerverse-auctions` as a custom element. The browser
|
|
88
|
+
script owns the element's contents; the host owns the surrounding page.
|
|
89
|
+
|
|
90
|
+
## Host requirements
|
|
91
|
+
|
|
92
|
+
The CMS must permit the script and custom element. The browser must support
|
|
93
|
+
JavaScript modules, custom elements, and shadow DOM. An editor that removes
|
|
94
|
+
scripts or rewrites the element needs a developer-controlled integration area.
|
|
95
|
+
|
|
96
|
+
If the site has a Content Security Policy, its team must permit the script CDN,
|
|
97
|
+
the selected Lockerverse API, auction media sources, and the Stripe resources
|
|
98
|
+
needed by checkout. The embed inserts a stylesheet into its shadow root. If
|
|
99
|
+
inline styles require a nonce, put the server-generated nonce on the element
|
|
100
|
+
and include that same nonce in the response policy. React also sets inline style
|
|
101
|
+
properties for layout and appearance; check those against the host policy.
|
|
102
|
+
Check the actual requests and the site's policy; do not
|
|
103
|
+
replace its policy with a broad allow-all rule. Payment methods can have their
|
|
104
|
+
own domain requirements. Confirm checkout on the final host domain before
|
|
105
|
+
announcing support for those methods.
|
|
106
|
+
|
|
107
|
+
This is a browser-rendered integration. The host still owns page titles,
|
|
108
|
+
metadata, accessibility of surrounding content, and search indexing. Do not use
|
|
109
|
+
it to replace a working server-rendered React integration solely to reduce the
|
|
110
|
+
host's setup code.
|
|
111
|
+
|
|
112
|
+
## Check the integration
|
|
113
|
+
|
|
114
|
+
After the script version is published, check the snippet on the target host:
|
|
115
|
+
|
|
116
|
+
1. Confirm the script and its assets load without policy or network errors.
|
|
117
|
+
2. Confirm the expected community, auction, item images, and prices appear.
|
|
118
|
+
3. Check mobile layout, item links, gallery controls, and browser navigation.
|
|
119
|
+
4. Confirm light/dark appearance and any accent setting fit the host page.
|
|
120
|
+
5. Inspect checkout loading and recovery behavior without submitting a live bid
|
|
121
|
+
or payment for an integration check.
|
|
122
|
+
|
|
123
|
+
The embed reuses the SDK's auction behavior. Shipping React inside the bundle
|
|
124
|
+
removes the host's React setup requirement; it does not remove network,
|
|
125
|
+
security-policy, browser, or payment-provider constraints.
|
package/guides/events.md
CHANGED
package/guides/integration.md
CHANGED
package/guides/signup.md
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lockerverse/react",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.230",
|
|
4
4
|
"description": "Tree-shakable React payment and signup UI for Lockerverse",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -146,7 +146,7 @@
|
|
|
146
146
|
"embla-carousel-react": "8.6.0",
|
|
147
147
|
"lucide-react": "0.536.0",
|
|
148
148
|
"valibot": "1.4.2",
|
|
149
|
-
"@lockerverse/sdk": "0.2.
|
|
149
|
+
"@lockerverse/sdk": "0.2.230"
|
|
150
150
|
},
|
|
151
151
|
"devDependencies": {
|
|
152
152
|
"@size-limit/file": "13.0.3",
|
|
@@ -156,6 +156,7 @@
|
|
|
156
156
|
"@types/react": "19.2.18",
|
|
157
157
|
"@types/react-dom": "19.2.4",
|
|
158
158
|
"@vitest/browser-playwright": "4.1.10",
|
|
159
|
+
"esbuild": "0.28.2",
|
|
159
160
|
"playwright": "1.62.1",
|
|
160
161
|
"prop-types": "15.8.1",
|
|
161
162
|
"react": "19.2.8",
|
|
@@ -243,7 +244,7 @@
|
|
|
243
244
|
}
|
|
244
245
|
],
|
|
245
246
|
"scripts": {
|
|
246
|
-
"build": "node ../../scripts/copy-package-instructions.mjs react && node ../../scripts/build-integration-guides.mjs && tsdown",
|
|
247
|
+
"build": "node ../../scripts/copy-package-instructions.mjs react && node ../../scripts/build-integration-guides.mjs && tsdown && node build-embed.mjs",
|
|
247
248
|
"pack:check": "pnpm build && pnpm pack --dry-run",
|
|
248
249
|
"size": "size-limit",
|
|
249
250
|
"pretest": "pnpm --filter @lockerverse/sdk build",
|