@snowcone-app/sdk 0.3.5 → 0.3.6

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.3.6
+
+### Patch Changes
+
+- [#317](https://github.com/snowcone-app/snowcone-monorepo/pull/317) [`ef0f08e`](https://github.com/snowcone-app/snowcone-monorepo/commit/ef0f08ee3ffa14b1db3a4011e4a0f7e5e42340a1) Thanks [@kevinsproles](https://github.com/kevinsproles)! - Republish to ship two already-landed source fixes that never reached npm:
+  - **ui:** the `./package.json` export (added in #279) is in source but the live
+    `0.1.30` tarball still omits it, so `@snowcone-app/ui/package.json` resolution
+    throws `ERR_PACKAGE_PATH_NOT_EXPORTED` for anyone installing today. This bump
+    republishes with it.
+  - **sdk:** carries the corrected `RenderSession` `mockupIds` examples (JSDoc +
+    README) out to npm — they showed a placement name where opaque catalog scene
+    codes (`mockups[].id`, e.g. `FV1qjO`) belong.
+
+- [#322](https://github.com/snowcone-app/snowcone-monorepo/pull/322) [`4017a11`](https://github.com/snowcone-app/snowcone-monorepo/commit/4017a11385d3eab3cc1b86f27842e2f783e1f628) Thanks [@kevinsproles](https://github.com/kevinsproles)! - Fix client-side `mockupUrl()` base resolution: prefer the resolver
+  (`window.snowcone.resolver` / `NEXT_PUBLIC_MOCKUP_RESOLVER_URL` /
+  `SNOWCONE_IMAGE_URL`, default `img.snowcone.app`) and never fall back to the
+  renderer. `ShopProvider` publishes the renderer as `window.snowcone.mockupUrl`,
+  which `resolveMockupBaseUrl()` previously read first — so in the browser every
+  `mockupUrl()` built the resolver grammar against the renderer host and 400'd
+  with "required property 'seal'". (The prior fix only corrected the server path,
+  where `window.snowcone` is absent.)
+
+- [#321](https://github.com/snowcone-app/snowcone-monorepo/pull/321) [`3f693ac`](https://github.com/snowcone-app/snowcone-monorepo/commit/3f693ac8cd28405ffd7e14781432a2f43ddf2dc9) Thanks [@kevinsproles](https://github.com/kevinsproles)! - Fix `mockupUrl()` base host: it builds the public-image **resolver** grammar
+  (`/{code}?asset=&shop=…`, unsigned), so its base must be the resolver
+  (`img.snowcone.app`), which seals the URL and 302s to the renderer. It was
+  defaulting to the **renderer** (`cdn.snowcone.app`), which rejects unsigned
+  URLs with `400 … querystring must have required property 'seal'`. Now defaults
+  to `img.snowcone.app` (matching `getMockupUrl`) and prefers
+  `NEXT_PUBLIC_MOCKUP_RESOLVER_URL`.
+
 ## 0.3.5
 
 ### Patch Changes

package/README.md

@@ -204,7 +204,9 @@ import { RenderSession } from '@snowcone-app/sdk';
 const session = new RenderSession({
   shop: 'YOUR_SHOP_ID',            // publishable, like Stripe pk_
   grantUrl: '/api/realtime/grant', // your proxy above
-  product: { productId: 'BEEB77', mockupIds: ['Front'] },
+  // mockupIds are catalog SCENE CODES (product.mockups[].id) — not placement
+  // names. variantId is required for products with a color/size option.
+  product: { productId: 'BEEB77', mockupIds: ['FV1qjO'], variantId: 'Pv1sLC' },
 });
 
 session.onMockups((results) => { img.src = results[0].imageUrl; });

package/dist/index.cjs

@@ -1798,7 +1798,7 @@ function buildMockupUrl2(options, cfg) {
 }
 function resolveMockupBaseUrl() {
   const winConfig = typeof window !== "undefined" && window.snowcone || {};
-  return winConfig.mockupUrl || typeof process !== "undefined" && process.env?.SNOWCONE_IMAGE_URL || typeof process !== "undefined" && process.env?.NEXT_PUBLIC_MERCH_MOCKUP_URL || "https://cdn.snowcone.app";
+  return winConfig.resolver || typeof process !== "undefined" && process.env?.NEXT_PUBLIC_MOCKUP_RESOLVER_URL || typeof process !== "undefined" && process.env?.SNOWCONE_IMAGE_URL || "https://img.snowcone.app";
 }
 function resolveShop() {
   const winConfig = typeof window !== "undefined" && window.snowcone || {};

package/dist/index.d.cts

@@ -820,7 +820,8 @@ type UserSelection = Record<string, string>;
  * Config for the pure URL builder: the two things not on MockupGenerationOptions.
  */
 interface BuildMockupUrlConfig {
-    /** Base of the renderer/CDN, e.g. https://cdn.snowcone.app */
+    /** Base of the public-image RESOLVER, e.g. https://img.snowcone.app (it
+     *  seals the URL and 302s to the renderer). NOT the renderer host. */
     mockupBaseUrl: string;
     /** The shop's public Shop ID (= shop.id). */
     shop: string;
@@ -2581,9 +2582,13 @@ declare function fetchRealtimeGrant(grantUrl: string, shop: string, fetchImpl?:
  * const session = new RenderSession({
  *   shop: 'YOUR_SHOP_ID',
  *   grantUrl: '/api/realtime/grant', // your proxy → mintRealtimeGrant (server)
- *   product: { productId: 'BEEB77', mockupIds: ['front'] },
+ *   // mockupIds are opaque catalog SCENE CODES (product.mockups[].id) — NOT
+ *   // placement names. variantId is required for products with a color/size axis.
+ *   product: { productId: 'BEEB77', mockupIds: ['FV1qjO'], variantId: 'Pv1sLC' },
  * });
  * session.onMockups((results) => { img.src = results[0].imageUrl; });
+ * // First arg is the PLACEMENT name (placements[].label, e.g. 'Front') — a
+ * // different id space from mockupIds, and it must match a canvas artboard.
  * await session.renderState('Front', serializeStateForServer(canvasState));
  *
  * For the low-level escape hatch, use {@link RealtimeMockupService} directly.

package/dist/index.d.ts

@@ -820,7 +820,8 @@ type UserSelection = Record<string, string>;
  * Config for the pure URL builder: the two things not on MockupGenerationOptions.
  */
 interface BuildMockupUrlConfig {
-    /** Base of the renderer/CDN, e.g. https://cdn.snowcone.app */
+    /** Base of the public-image RESOLVER, e.g. https://img.snowcone.app (it
+     *  seals the URL and 302s to the renderer). NOT the renderer host. */
     mockupBaseUrl: string;
     /** The shop's public Shop ID (= shop.id). */
     shop: string;
@@ -2581,9 +2582,13 @@ declare function fetchRealtimeGrant(grantUrl: string, shop: string, fetchImpl?:
  * const session = new RenderSession({
  *   shop: 'YOUR_SHOP_ID',
  *   grantUrl: '/api/realtime/grant', // your proxy → mintRealtimeGrant (server)
- *   product: { productId: 'BEEB77', mockupIds: ['front'] },
+ *   // mockupIds are opaque catalog SCENE CODES (product.mockups[].id) — NOT
+ *   // placement names. variantId is required for products with a color/size axis.
+ *   product: { productId: 'BEEB77', mockupIds: ['FV1qjO'], variantId: 'Pv1sLC' },
  * });
  * session.onMockups((results) => { img.src = results[0].imageUrl; });
+ * // First arg is the PLACEMENT name (placements[].label, e.g. 'Front') — a
+ * // different id space from mockupIds, and it must match a canvas artboard.
  * await session.renderState('Front', serializeStateForServer(canvasState));
  *
  * For the low-level escape hatch, use {@link RealtimeMockupService} directly.

package/dist/index.js

@@ -1643,7 +1643,7 @@ function buildMockupUrl2(options, cfg) {
 }
 function resolveMockupBaseUrl() {
   const winConfig = typeof window !== "undefined" && window.snowcone || {};
-  return winConfig.mockupUrl || typeof process !== "undefined" && process.env?.SNOWCONE_IMAGE_URL || typeof process !== "undefined" && process.env?.NEXT_PUBLIC_MERCH_MOCKUP_URL || "https://cdn.snowcone.app";
+  return winConfig.resolver || typeof process !== "undefined" && process.env?.NEXT_PUBLIC_MOCKUP_RESOLVER_URL || typeof process !== "undefined" && process.env?.SNOWCONE_IMAGE_URL || "https://img.snowcone.app";
 }
 function resolveShop() {
   const winConfig = typeof window !== "undefined" && window.snowcone || {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snowcone-app/sdk",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Snowcone SDK for product mockups and print-on-demand",
   "keywords": [
     "merch",