@sixtyninecommerce/client 0.24.0 → 0.25.0

package/README.md

@@ -134,6 +134,27 @@ client.setAuthToken(token);
 const data = await client.graphql(`query { activeChannel { id } }`);
 ```
 
+## Deprecated: the `/admin` surface
+
+`@sixtyninecommerce/client/admin` (`createCommerceAdminClient`) is **deprecated**. Use
+[`@sixtyninecommerce/admin`](https://www.npmjs.com/package/@sixtyninecommerce/admin) instead: it
+carries the platform's error hierarchy, cursor pagination and tenant context, and it is where every
+other back-office capability lands. It covers forms (list, read by id or slug, slug upsert, delete)
+and redirects (list, create, update, delete).
+
+Five things have no successor yet, and are the reason to stay on this surface:
+
+| Here | Why the successor cannot do it |
+|---|---|
+| `forms.update` | the only way to RENAME a slug — `upsertBySlug` keys on it |
+| `forms.addField` / `updateField` / `removeField` | the slug upsert is non-destructive, so a field can be added but never removed |
+| `forms.listSubmissions` | no successor |
+| `redirects.import` | bulk upsert by source path with per-row rejections — the migration case |
+| `redirects.upsert` | create-or-update one redirect by source path |
+
+This surface still works and is unchanged; it will be removed in a future major, not before those
+land.
+
 ## Modules
 
 | Module | Description |

package/dist/admin/forms.js

@@ -1,4 +1,9 @@
 import { StorefrontError } from '../errors.js';
+/**
+ * The admin surface speaks the CMS's snake_case DTOs; these mappers translate
+ * the camelCase SDK inputs. Only defined keys are forwarded so PATCH stays a
+ * true partial update.
+ */
 function fieldTranslationBody(t) {
     const body = { language_code: t.languageCode, label: t.label };
     if (t.placeholder !== undefined)
@@ -61,6 +66,17 @@ function formBody(input) {
         body.fields = input.fields.map((f) => fieldBody(f));
     return body;
 }
+/**
+ * `GET /forms/by-slug/:slug` is a PUBLIC CMS route with OPTIONAL auth: an
+ * invalid or expired admin token — and equally a valid one whose user has no
+ * access to the requested channel — is not rejected. The CMS answers 200 with
+ * the storefront projection, which carries neither `channelId` nor field ids.
+ * Returning that as an `AdminFormRecord` would hand the caller `undefined`
+ * under a `string` type, and the next `removeField`/`updateField` call would
+ * fail as an opaque "uuid is expected" 400 that names neither the token nor
+ * the channel. `channelId` is the discriminator — the entity always has it,
+ * the projection never does.
+ */
 function assertAdminForm(form, slug) {
     if (form && typeof form.channelId === 'string' && form.channelId.length > 0)
         return;
@@ -69,6 +85,9 @@ function assertAdminForm(form, slug) {
 export function createFormsAdminMethods(http) {
     return {
         async getBySlug(slug, options) {
+            // Same route the public client reads, but the admin token makes the CMS
+            // return the raw entity (field ids, settings, notification emails)
+            // instead of the storefront projection.
             const res = await http.request('GET', `/forms/by-slug/${encodeURIComponent(slug)}`, undefined, options);
             assertAdminForm(res.data, slug);
             return res.data;

package/dist/admin/forms.js.map

@@ -1 +1 @@
-{"version":3,"file":"forms.js","sourceRoot":"","sources":["../../src/admin/forms.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"forms.js","sourceRoot":"","sources":["../../src/admin/forms.ts"],"names":[],"mappings":"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"}

package/dist/admin/http.d.ts

@@ -1,7 +1,16 @@
 import { type ServiceName } from '../errors.js';
 import type { RequestOptions } from '../types.js';
+/**
+ * Minimal authenticated HTTP client for the admin (authoring) surfaces, which
+ * live on the CMS (forms) and the plugins service (redirects). Every request
+ * carries the admin Bearer token and the target channel. Kept separate from the
+ * public `core/http` client (which never sends admin auth) so the credential
+ * path is unmistakable.
+ */
 export interface AdminHttpConfig {
+    /** Origin of the service this client talks to. */
     baseUrl: string;
+    /** Which service — used to label thrown `StorefrontError`s. */
     service: ServiceName;
     channelId: string;
     adminToken: string;

package/dist/admin/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/admin/http.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,WAAW,EAAmB,MAAM,cAAc,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAUlD,MAAM,WAAW,eAAe;IAE9B,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChG;AAkCD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAgElE"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/admin/http.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,WAAW,EAAmB,MAAM,cAAc,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChG;AAkCD,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAgElE"}

package/dist/admin/http.js

@@ -1,5 +1,6 @@
 import { REQUEST_TIMEOUT_MS } from '../constants.js';
 import { StorefrontError } from '../errors.js';
+/** Parse a non-2xx response into a structured StorefrontError. */
 async function toAdminError(response, service) {
     let body = {};
     try {
@@ -9,6 +10,7 @@ async function toAdminError(response, service) {
         }
     }
     catch {
+        // Non-JSON error body — fall back to the status line.
     }
     const rawMessage = body.message;
     const message = Array.isArray(rawMessage)
@@ -50,6 +52,7 @@ export function createAdminHttp(config) {
             if (!response.ok) {
                 throw await toAdminError(response, config.service);
             }
+            // 204 No Content (DELETE) — nothing to parse.
             if (response.status === 204) {
                 return undefined;
             }

package/dist/admin/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/admin/http.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/admin/http.ts"],"names":[],"mappings":"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"}

package/dist/admin/index.d.ts

@@ -1,4 +1,67 @@
+/**
+ * `@sixtyninecommerce/client/admin` — the ADMIN (authoring) surface.
+ *
+ * DEPRECATED in favour of
+ * [`@sixtyninecommerce/admin`](https://www.npmjs.com/package/@sixtyninecommerce/admin). The
+ * machine-readable `@deprecated` tag is on {@link createCommerceAdminClient} itself, NOT here: a
+ * module-level tag above an `import` attaches to that import declaration and marks no exported
+ * symbol, so no consumer's editor would ever strike the call through.
+ *
+ * Unlike the public storefront client, every call here is permission-gated and
+ * requires a Vendure admin session token (or an `s69t_` API token) holding the
+ * relevant permissions — CreateCmsForm/UpdateCmsForm/ReadCmsForm for `forms`,
+ * UpdateChannel for `redirects`. It is a deliberately separate factory so the
+ * credential requirement is impossible to miss. Use it for server-side
+ * authoring (e.g. scaffolding a contact form or registering redirects during a
+ * migration); never ship an admin token to a browser.
+ *
+ * `forms` talks to the CMS; `redirects` talks to the plugins service, so set
+ * `pluginsUrl` when you use it against a non-default host.
+ *
+ * @example
+ * ```ts
+ * import { createCommerceAdminClient } from '@sixtyninecommerce/client/admin';
+ *
+ * const admin = createCommerceAdminClient({
+ *   cmsUrl: 'https://cms.example.com',
+ *   channelId: '<tenant-channel-id>',
+ *   adminToken: process.env.SIXTYNINE_COMMERCE_API_TOKEN!,
+ * });
+ *
+ * await admin.forms.upsertBySlug('contact', {
+ *   name: 'Contact',
+ *   notificationEmails: 'team@example.com',
+ *   fields: [{ name: 'Email', slug: 'email', fieldType: 'email', isRequired: true }],
+ * });
+ *
+ * await admin.redirects.create({ oldPath: '/old-page', newPath: '/new-page' });
+ * ```
+ */
 import type { CommerceAdminClient, CommerceAdminClientConfig } from './types.js';
+/**
+ * Create the admin (authoring) client.
+ *
+ * @deprecated Use [`@sixtyninecommerce/admin`](https://www.npmjs.com/package/@sixtyninecommerce/admin)
+ * instead — `createAdminClient` — on the platform's own error hierarchy, cursor
+ * pagination and tenant context, and where every other back-office capability
+ * lands.
+ *
+ * What it covers today: forms — list, read by id or slug, slug upsert, delete;
+ * redirects — list, create, update, delete.
+ *
+ * What has NO successor yet, and is the reason to stay here:
+ * - `forms.update` — the only way to RENAME a form's slug (`upsertBySlug` keys
+ *   on the slug and cannot change it);
+ * - `forms.addField` / `updateField` / `removeField` — the slug upsert is
+ *   non-destructive, so a field can be added but never removed through it;
+ * - `forms.listSubmissions`;
+ * - `redirects.import` — bulk upsert by source path with per-row rejections,
+ *   which is the migration case this surface exists for;
+ * - `redirects.upsert` — create-or-update one redirect by source path.
+ *
+ * This surface still works and is unchanged; it will be removed in a future
+ * major, not before those land.
+ */
 export declare function createCommerceAdminClient(config: CommerceAdminClientConfig): CommerceAdminClient;
 export type { AdminFormFieldRecord, AdminFormRecord, AdminRedirectRecord, CommerceAdminClient, CommerceAdminClientConfig, FormCreateInput, FormFieldInput, FormFieldTranslationInput, FormSubmissionListOptions, FormSubmissionListResult, FormSubmissionRecord, FormsAdminModule, FormTranslationInput, FormUpdateInput, FormUpsertInput, RedirectCreateInput, RedirectImportRejection, RedirectImportResult, RedirectsAdminModule, RedirectUpdateInput, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEjF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,mBAAmB,CA+ChG;AAED,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,mBAAmB,CA+ChG;AAED,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/admin/index.js

@@ -1,6 +1,69 @@
+/**
+ * `@sixtyninecommerce/client/admin` — the ADMIN (authoring) surface.
+ *
+ * DEPRECATED in favour of
+ * [`@sixtyninecommerce/admin`](https://www.npmjs.com/package/@sixtyninecommerce/admin). The
+ * machine-readable `@deprecated` tag is on {@link createCommerceAdminClient} itself, NOT here: a
+ * module-level tag above an `import` attaches to that import declaration and marks no exported
+ * symbol, so no consumer's editor would ever strike the call through.
+ *
+ * Unlike the public storefront client, every call here is permission-gated and
+ * requires a Vendure admin session token (or an `s69t_` API token) holding the
+ * relevant permissions — CreateCmsForm/UpdateCmsForm/ReadCmsForm for `forms`,
+ * UpdateChannel for `redirects`. It is a deliberately separate factory so the
+ * credential requirement is impossible to miss. Use it for server-side
+ * authoring (e.g. scaffolding a contact form or registering redirects during a
+ * migration); never ship an admin token to a browser.
+ *
+ * `forms` talks to the CMS; `redirects` talks to the plugins service, so set
+ * `pluginsUrl` when you use it against a non-default host.
+ *
+ * @example
+ * ```ts
+ * import { createCommerceAdminClient } from '@sixtyninecommerce/client/admin';
+ *
+ * const admin = createCommerceAdminClient({
+ *   cmsUrl: 'https://cms.example.com',
+ *   channelId: '<tenant-channel-id>',
+ *   adminToken: process.env.SIXTYNINE_COMMERCE_API_TOKEN!,
+ * });
+ *
+ * await admin.forms.upsertBySlug('contact', {
+ *   name: 'Contact',
+ *   notificationEmails: 'team@example.com',
+ *   fields: [{ name: 'Email', slug: 'email', fieldType: 'email', isRequired: true }],
+ * });
+ *
+ * await admin.redirects.create({ oldPath: '/old-page', newPath: '/new-page' });
+ * ```
+ */
 import { createFormsAdminMethods } from './forms.js';
 import { createAdminHttp } from './http.js';
 import { createRedirectsAdminMethods } from './redirects.js';
+/**
+ * Create the admin (authoring) client.
+ *
+ * @deprecated Use [`@sixtyninecommerce/admin`](https://www.npmjs.com/package/@sixtyninecommerce/admin)
+ * instead — `createAdminClient` — on the platform's own error hierarchy, cursor
+ * pagination and tenant context, and where every other back-office capability
+ * lands.
+ *
+ * What it covers today: forms — list, read by id or slug, slug upsert, delete;
+ * redirects — list, create, update, delete.
+ *
+ * What has NO successor yet, and is the reason to stay here:
+ * - `forms.update` — the only way to RENAME a form's slug (`upsertBySlug` keys
+ *   on the slug and cannot change it);
+ * - `forms.addField` / `updateField` / `removeField` — the slug upsert is
+ *   non-destructive, so a field can be added but never removed through it;
+ * - `forms.listSubmissions`;
+ * - `redirects.import` — bulk upsert by source path with per-row rejections,
+ *   which is the migration case this surface exists for;
+ * - `redirects.upsert` — create-or-update one redirect by source path.
+ *
+ * This surface still works and is unchanged; it will be removed in a future
+ * major, not before those land.
+ */
 export function createCommerceAdminClient(config) {
     if (!config.adminToken) {
         throw new Error('createCommerceAdminClient requires an adminToken (a Vendure admin session token holding the CmsForm permissions).');
@@ -19,6 +82,10 @@ export function createCommerceAdminClient(config) {
         adminToken: config.adminToken,
         fetch: fetchFn,
     });
+    // `pluginsUrl` stays optional so the pre-existing forms-only signature keeps
+    // working — but it must never silently DEFAULT, or a self-hosted caller who
+    // passed only `cmsUrl` would ship their admin token to the hosted SaaS host.
+    // Fail on first use of `redirects` instead.
     const pluginsHttp = config.pluginsUrl
         ? createAdminHttp({
             baseUrl: config.pluginsUrl,

package/dist/admin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAkB,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAG7D,MAAM,UAAU,yBAAyB,CAAC,MAAiC;IACzE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,mHAAmH,CACpH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IACjD,MAAM,OAAO,GAAG,eAAe,CAAC;QAC9B,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK,EAAE,OAAO;KACf,CAAC,CAAC;IAKH,MAAM,WAAW,GAAc,MAAM,CAAC,UAAU;QAC9C,CAAC,CAAC,eAAe,CAAC;YACd,OAAO,EAAE,MAAM,CAAC,UAAU;YAC1B,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,OAAO;SACf,CAAC;QACJ,CAAC,CAAC;YACE,OAAO;gBACL,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,qHAAqH,CACtH,CACF,CAAC;YACJ,CAAC;SACF,CAAC;IAEN,OAAO;QACL,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC;QACvC,SAAS,EAAE,2BAA2B,CAAC,WAAW,CAAC;KACpD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAkB,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiC;IACzE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,mHAAmH,CACpH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IACjD,MAAM,OAAO,GAAG,eAAe,CAAC;QAC9B,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK,EAAE,OAAO;KACf,CAAC,CAAC;IACH,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,4CAA4C;IAC5C,MAAM,WAAW,GAAc,MAAM,CAAC,UAAU;QAC9C,CAAC,CAAC,eAAe,CAAC;YACd,OAAO,EAAE,MAAM,CAAC,UAAU;YAC1B,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,OAAO;SACf,CAAC;QACJ,CAAC,CAAC;YACE,OAAO;gBACL,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,qHAAqH,CACtH,CACF,CAAC;YACJ,CAAC;SACF,CAAC;IAEN,OAAO;QACL,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC;QACvC,SAAS,EAAE,2BAA2B,CAAC,WAAW,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/admin/redirects.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Admin (authoring) surface for the tenant's URL redirects, on the plugins
+ * service. Reads and writes here are permission-gated (`UpdateChannel`); the
+ * unauthenticated map a storefront middleware consumes is the separate
+ * `redirects` module on the public client.
+ */
 import type { RedirectStatusCode } from '../redirects/types.js';
 import type { AdminHttp } from './http.js';
 import type { RedirectsAdminModule } from './types.js';

package/dist/admin/redirects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/admin/redirects.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAIV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAUpB,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,GAAG,oBAAoB,CAqDjF;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/admin/redirects.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAIV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAUpB,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,GAAG,oBAAoB,CAqDjF;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/admin/redirects.js

@@ -1,3 +1,9 @@
+/**
+ * Admin (authoring) surface for the tenant's URL redirects, on the plugins
+ * service. Reads and writes here are permission-gated (`UpdateChannel`); the
+ * unauthenticated map a storefront middleware consumes is the separate
+ * `redirects` module on the public client.
+ */
 function toWire(input) {
     const body = {};
     if (input.oldPath !== undefined)
@@ -9,6 +15,8 @@ function toWire(input) {
     return body;
 }
 export function createRedirectsAdminMethods(http) {
+    // Captured in a local so `upsert` does not depend on `this` — every other
+    // module surface in this SDK survives `const { upsert } = admin.redirects`.
     const importRedirects = (redirects, options) => http.request('POST', '/redirects/import', { redirects: redirects.map(toWire) }, options);
     return {
         list(options) {
@@ -24,6 +32,10 @@ export function createRedirectsAdminMethods(http) {
             await http.request('DELETE', `/redirects/${encodeURIComponent(id)}`, undefined, options);
         },
         import: importRedirects,
+        /**
+         * Create-or-update by source path. The platform's bulk endpoint already
+         * upserts on `old_path`, so a single-item import is the idempotent write.
+         */
         async upsert(input, options) {
             const result = await importRedirects([input], options);
             const rejection = result.rejected[0];

package/dist/admin/redirects.js.map

@@ -1 +1 @@
-{"version":3,"file":"redirects.js","sourceRoot":"","sources":["../../src/admin/redirects.ts"],"names":[],"mappings":"AAiBA,SAAS,MAAM,CAAC,KAAgD;IAC9D,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/D,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/D,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAe;IAGzD,MAAM,eAAe,GAAmC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,CAC7E,IAAI,CAAC,OAAO,CACV,MAAM,EACN,mBAAmB,EACnB,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EACpC,OAAO,CACR,CAAC;IAEJ,OAAO;QACL,IAAI,CAAC,OAAO;YACV,OAAO,IAAI,CAAC,OAAO,CAAwB,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,CAAC,KAAK,EAAE,OAAO;YACnB,OAAO,IAAI,CAAC,OAAO,CAAsB,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO;YACvB,OAAO,IAAI,CAAC,OAAO,CACjB,OAAO,EACP,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACtC,MAAM,CAAC,KAAK,CAAC,EACb,OAAO,CACR,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO;YACtB,MAAM,IAAI,CAAC,OAAO,CAChB,QAAQ,EACR,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACtC,SAAS,EACT,OAAO,CACR,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,eAAe;QAMvB,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO;YACzB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"redirects.js","sourceRoot":"","sources":["../../src/admin/redirects.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,SAAS,MAAM,CAAC,KAAgD;IAC9D,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/D,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/D,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAe;IACzD,0EAA0E;IAC1E,4EAA4E;IAC5E,MAAM,eAAe,GAAmC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,CAC7E,IAAI,CAAC,OAAO,CACV,MAAM,EACN,mBAAmB,EACnB,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EACpC,OAAO,CACR,CAAC;IAEJ,OAAO;QACL,IAAI,CAAC,OAAO;YACV,OAAO,IAAI,CAAC,OAAO,CAAwB,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,CAAC,KAAK,EAAE,OAAO;YACnB,OAAO,IAAI,CAAC,OAAO,CAAsB,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO;YACvB,OAAO,IAAI,CAAC,OAAO,CACjB,OAAO,EACP,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACtC,MAAM,CAAC,KAAK,CAAC,EACb,OAAO,CACR,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO;YACtB,MAAM,IAAI,CAAC,OAAO,CAChB,QAAQ,EACR,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACtC,SAAS,EACT,OAAO,CACR,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,eAAe;QAEvB;;;WAGG;QACH,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO;YACzB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/admin/types.d.ts

@@ -1,9 +1,28 @@
 import type { RequestOptions } from '../types.js';
+/**
+ * Admin (authoring) surface types. These endpoints are PERMISSION-GATED and
+ * require a Vendure admin session token holding CreateCmsForm/UpdateCmsForm/
+ * ReadCmsForm — never a storefront/anonymous token. Kept in a separate module
+ * from the public storefront client so the credential requirement is explicit.
+ */
 export interface CommerceAdminClientConfig {
+    /** Base CMS URL, e.g. `https://cms.example.com`. Required for `forms`. */
     cmsUrl: string;
+    /**
+     * Base plugins-service URL, e.g. `https://plugins.example.com`. REQUIRED to
+     * use `redirects` — there is deliberately no default, so a self-hosted caller
+     * can never send an admin token to the hosted SaaS host by omission. Omit it
+     * only when you use `forms` alone; the first `redirects` call then rejects.
+     */
     pluginsUrl?: string;
+    /** Target tenant channel id (sent as `x-channel-id`). */
     channelId: string;
+    /**
+     * A Vendure admin session token holding the CmsForm permissions. Sent as
+     * `Authorization: Bearer <token>` — treat it as a secret.
+     */
     adminToken: string;
+    /** Fetch implementation (defaults to `globalThis.fetch`). */
     fetch?: typeof globalThis.fetch;
 }
 export interface FormTranslationInput {
@@ -23,10 +42,13 @@ export interface FormFieldTranslationInput {
 export interface FormFieldInput {
     name: string;
     slug: string;
+    /** One of the registry field types (see FORM_FIELD_TYPES / getFormFieldTypes). */
     fieldType: string;
     isRequired?: boolean;
     position?: number;
+    /** Presentational config (e.g. select option labels). */
     config?: Record<string, unknown>;
+    /** Validation constraints (authoritative over `config` for the same keys). */
     validation?: Record<string, unknown>;
     translations?: FormFieldTranslationInput[];
 }
@@ -48,6 +70,7 @@ export interface FormUpdateInput {
     settings?: Record<string, unknown>;
     translations?: FormTranslationInput[];
 }
+/** Body for the idempotent upsert-by-slug. The slug travels in the URL. */
 export interface FormUpsertInput {
     name: string;
     notificationEmails?: string;
@@ -55,8 +78,10 @@ export interface FormUpsertInput {
     submitAction?: string;
     settings?: Record<string, unknown>;
     translations?: FormTranslationInput[];
+    /** Fields to upsert by slug. Fields not listed are left untouched. */
     fields?: FormFieldInput[];
 }
+/** A form field row as returned by the admin (full-entity) responses. */
 export interface AdminFormFieldRecord {
     id: string;
     formId: string;
@@ -67,8 +92,10 @@ export interface AdminFormFieldRecord {
     position: number;
     config: Record<string, unknown> | null;
     validation: Record<string, unknown> | null;
+    /** Forward-compat: additional entity fields (translations, timestamps, …). */
     [key: string]: unknown;
 }
+/** A form as returned by the admin (full-entity) responses. */
 export interface AdminFormRecord {
     id: string;
     channelId: string;
@@ -79,6 +106,7 @@ export interface AdminFormRecord {
     notificationEmails: string | null;
     settings: Record<string, unknown> | null;
     fields?: AdminFormFieldRecord[];
+    /** Forward-compat: translations, timestamps, and any additional entity fields. */
     [key: string]: unknown;
 }
 export interface FormSubmissionRecord {
@@ -103,34 +131,65 @@ export interface FormSubmissionListResult {
     };
 }
 export interface FormsAdminModule {
+    /**
+     * Read a form by slug as the FULL admin entity — including each field's `id`,
+     * which the public projection omits. Needed to address a field for
+     * update/removal.
+     *
+     * The underlying CMS route is public with optional auth, so an unaccepted
+     * admin token yields the storefront projection with a 200 rather than a 401.
+     * This method REJECTS that response with a `StorefrontError` instead of
+     * returning a record whose `channelId`/field ids are `undefined`.
+     */
     getBySlug(slug: string, options?: RequestOptions): Promise<AdminFormRecord>;
+    /** Create a form (create-only; 409 if the slug exists). Needs CreateCmsForm. */
     create(input: FormCreateInput, options?: RequestOptions): Promise<AdminFormRecord>;
+    /** Update a form by id. Needs UpdateCmsForm. */
     update(id: string, input: FormUpdateInput, options?: RequestOptions): Promise<AdminFormRecord>;
+    /** Idempotent create-or-update by slug, upserting listed fields. Needs Create or Update. */
     upsertBySlug(slug: string, input: FormUpsertInput, options?: RequestOptions): Promise<AdminFormRecord>;
+    /** Soft-delete a form by id. Needs DeleteCmsForm. */
     remove(id: string, options?: RequestOptions): Promise<void>;
+    /** Add a field to a form. Needs CreateCmsForm. */
     addField(formId: string, input: FormFieldInput, options?: RequestOptions): Promise<AdminFormFieldRecord>;
+    /** Update a field. Needs UpdateCmsForm. */
     updateField(formId: string, fieldId: string, input: Partial<FormFieldInput>, options?: RequestOptions): Promise<AdminFormFieldRecord>;
+    /** Soft-delete a field. Needs DeleteCmsForm. */
     removeField(formId: string, fieldId: string, options?: RequestOptions): Promise<void>;
+    /** List a form's submissions (offset-paginated). Needs ReadCmsForm. */
     listSubmissions(formId: string, options?: FormSubmissionListOptions & RequestOptions): Promise<FormSubmissionListResult>;
 }
 export interface CommerceAdminClient {
     forms: FormsAdminModule;
     redirects: RedirectsAdminModule;
 }
+/**
+ * A stored redirect as the plugins service returns it. Writes take snake_case
+ * (`old_path`), reads come back as the entity's camelCase fields — the same
+ * asymmetry the forms admin surface has.
+ */
 export interface AdminRedirectRecord {
     id: string;
     channelId: string;
     oldPath: string;
     newPath: string;
     statusCode: number;
+    /** `manual`, `import`, or `auto` (created by the URL-change engine). */
     source?: string;
     createdAt: string;
     updatedAt: string;
+    /** Forward-compat: any additional entity fields. */
     [key: string]: unknown;
 }
 export interface RedirectCreateInput {
+    /**
+     * Source path — a literal site-relative path, e.g. `/old-page`. Wildcards,
+     * `[slug]`/`:param` segments and query strings are rejected.
+     */
     oldPath: string;
+    /** Destination — a path (`/new-page`) or an absolute `https://` URL. */
     newPath: string;
+    /** 301 (default), 302, 303, 307 or 308. */
     statusCode?: import('../redirects/types.js').RedirectStatusCode;
 }
 export interface RedirectUpdateInput {
@@ -138,6 +197,7 @@ export interface RedirectUpdateInput {
     newPath?: string;
     statusCode?: import('../redirects/types.js').RedirectStatusCode;
 }
+/** A row the platform refused, identified by its index in the submitted batch. */
 export interface RedirectImportRejection {
     index: number;
     oldPath: string;
@@ -146,6 +206,7 @@ export interface RedirectImportRejection {
 export interface RedirectImportResult {
     created: number;
     updated: number;
+    /** Rows that failed validation. The rest of the batch still landed. */
     rejected: RedirectImportRejection[];
 }
 export interface RedirectsAdminModule {
@@ -153,7 +214,9 @@ export interface RedirectsAdminModule {
     create(input: RedirectCreateInput, options?: RequestOptions): Promise<AdminRedirectRecord>;
     update(id: string, input: RedirectUpdateInput, options?: RequestOptions): Promise<AdminRedirectRecord>;
     remove(id: string, options?: RequestOptions): Promise<void>;
+    /** Bulk upsert by source path. Bad rows are reported, never fatal. */
     import(inputs: RedirectCreateInput[], options?: RequestOptions): Promise<RedirectImportResult>;
+    /** Create-or-update one redirect by source path. Throws if the row is rejected. */
     upsert(input: RedirectCreateInput, options?: RequestOptions): Promise<RedirectImportResult>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/admin/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/admin/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/admin/types.ts"],"names":[],"mappings":"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"}

package/dist/cache-tags.d.ts

@@ -1,6 +1,25 @@
+/**
+ * The cache-tag convention shared by this SDK's fetches and its revalidation
+ * handlers. One module, so the tag a fetch is stamped with and the tag an event
+ * purges can never be spelled differently.
+ *
+ * - `product:<productId>` — Vendure product id. Purged by `product.*` and
+ *   `product_variant.price_changed`.
+ * - `collection:<collectionId>` — Vendure collection id. Purged by
+ *   `collection.membership_changed`.
+ * - `seo-artifact` — the platform-rendered sitemap/robots/llms.txt proxied by
+ *   `createSeoArtifactHandler`. The event handler purges it with every plan
+ *   that revalidates anything; the legacy dispatcher lists it in every
+ *   delivery's `tags`.
+ */
 export declare const SEO_ARTIFACT_TAG = "seo-artifact";
 export declare function productCacheTag(productId: string): string;
 export declare function collectionCacheTag(collectionId: string): string;
+/**
+ * The tags a page resolved from a routes-manifest entry should read with: the
+ * entry's own id tag for a product or collection, none for a CMS page (content
+ * events revalidate those by path).
+ */
 export declare function cacheTagsForRoute(route: {
     readonly type: string;
     readonly id: string;

package/dist/cache-tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-tags.d.ts","sourceRoot":"","sources":["../src/cache-tags.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/D;AAOD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAIjG"}
+{"version":3,"file":"cache-tags.d.ts","sourceRoot":"","sources":["../src/cache-tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAIjG"}