@financedistrict/saleor-agentic-commerce-nextjs 0.3.0 → 0.5.0

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/dist/config.d.ts CHANGED
@@ -23,6 +23,23 @@ export type AgenticCommerceConfig = {
23
23
  * and auto-configures itself. Env-based overrides still take priority.
24
24
  */
25
25
  configFromApp?: boolean;
26
+ /**
27
+ * Public URL of the Saleor Agentic Commerce App (e.g.
28
+ * `https://agentic-app.example.com`). When set, the SDK fetches config
29
+ * via the App's `/api/config-public` endpoint instead of querying
30
+ * Saleor's `{ app { privateMetadata } }` directly.
31
+ *
32
+ * Set this when the storefront's Saleor App token belongs to a
33
+ * DIFFERENT Saleor App than the Agentic Commerce App that holds the
34
+ * dashboard config (the typical setup — storefront has its own
35
+ * service-account App, the Agentic Commerce App is installed via the
36
+ * dashboard with its own identity). Saleor's `{ app }` query always
37
+ * returns the calling App's metadata, so the storefront can't read the
38
+ * Agentic Commerce App's metadata directly.
39
+ *
40
+ * Only used when `configFromApp: true`.
41
+ */
42
+ agenticCommerceAppUrl?: string;
26
43
  /**
27
44
  * Cache TTL in milliseconds for App config (default: 60000 = 60s).
28
45
  * Only used when configFromApp is true.
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,sBAAsB,EAEtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EAGrB,KAAK,uBAAuB,EAC7B,MAAM,+CAA+C,CAAA;AAMtD,MAAM,MAAM,qBAAqB,GAAG;IAClC,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,qBAAqB,GAAG,IAAI,CAAA;IACzF,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,eAAe,CAAC,EAAE,qBAAqB,EAAE,CAAA;CAC1C,CAAA;AAMD,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,YAAY,CAAA;IAC1B,eAAe,EAAE,sBAAsB,CAAA;IACvC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GAC1F,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,GAAG,WAAW,CAAC,GAC7D;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CACxB,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,GACtD,OAAO,CAAC,uBAAuB,CAAC,CAAA;AACnC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAAG;IAAE,aAAa,CAAC,EAAE,KAAK,CAAA;CAAE,GACxD,uBAAuB,CAAA;AAC1B,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAC5B,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,YAAY,EACZ,sBAAsB,EAEtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EAGrB,KAAK,uBAAuB,EAC7B,MAAM,+CAA+C,CAAA;AAMtD,MAAM,MAAM,qBAAqB,GAAG;IAClC,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;;;;;;;;;;;OAeG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,qBAAqB,GAAG,IAAI,CAAA;IACzF,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,eAAe,CAAC,EAAE,qBAAqB,EAAE,CAAA;CAC1C,CAAA;AAMD,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,YAAY,CAAA;IAC1B,eAAe,EAAE,sBAAsB,CAAA;IACvC,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GAC1F,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,GAAG,WAAW,CAAC,GAC7D;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CACxB,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,GACtD,OAAO,CAAC,uBAAuB,CAAC,CAAA;AACnC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAAG;IAAE,aAAa,CAAC,EAAE,KAAK,CAAA;CAAE,GACxD,uBAAuB,CAAA;AAC1B,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAC5B,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA"}
package/dist/config.js CHANGED
@@ -17,17 +17,19 @@ export function createAgenticCommerce(config) {
17
17
  if (config.configFromApp) {
18
18
  return createFromApp(config);
19
19
  }
20
- // Explicit config mode — storeName is required
21
- if (!config.storeName) {
22
- throw new Error("storeName is required (or use configFromApp: true)");
23
- }
24
- return buildInstance(config, config.storeName);
20
+ // Explicit config mode (Path A — no App). storeName falls back to a
21
+ // generic default so a storefront can boot from env vars alone without
22
+ // extra boilerplate. Merchants override via the `storeName` config field
23
+ // (or via env) when they care about how their store appears to agents
24
+ // during UCP/ACP discovery.
25
+ const storeName = config.storeName ?? "Saleor Store";
26
+ return buildInstance({ ...config, storeName }, storeName);
25
27
  }
26
28
  /**
27
29
  * Load config from App metadata and build the instance.
28
30
  */
29
31
  async function createFromApp(config) {
30
- const appConfig = await loadConfigFromAppCached(config.saleorApiUrl, config.saleorAuthToken, config.configCacheTtl);
32
+ const appConfig = await loadConfigFromAppCached(config.saleorApiUrl, config.saleorAuthToken, config.configCacheTtl, { agenticCommerceAppUrl: config.agenticCommerceAppUrl });
31
33
  // App config provides defaults; explicit config overrides
32
34
  const storeName = config.storeName || appConfig.storeName;
33
35
  if (!storeName) {
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@financedistrict/saleor-agentic-commerce-nextjs",
3
- "version": "0.3.0",
3
+ "version": "0.5.0",
4
4
  "description": "Drop-in Next.js route handlers that expose your Saleor storefront to AI shopping agents via UCP and ACP protocols.",
5
5
  "author": "Finance District <developers@fd.xyz>",
6
6
  "license": "MIT",
@@ -62,7 +62,7 @@
62
62
  },
63
63
  "dependencies": {},
64
64
  "peerDependencies": {
65
- "@financedistrict/saleor-agentic-commerce-core": "^0.3.0",
65
+ "@financedistrict/saleor-agentic-commerce-core": "^0.5.0",
66
66
  "next": ">=14.0.0"
67
67
  },
68
68
  "peerDependenciesMeta": {
@@ -72,7 +72,7 @@
72
72
  },
73
73
  "devDependencies": {
74
74
  "typescript": "^5.3.0",
75
- "@financedistrict/saleor-agentic-commerce-core": "0.3.0"
75
+ "@financedistrict/saleor-agentic-commerce-core": "0.5.0"
76
76
  },
77
77
  "scripts": {
78
78
  "build": "tsc",