@sixtyninecommerce/admin 0.10.0 → 0.12.0

package/dist/platform/geo.d.ts

@@ -0,0 +1,123 @@
+import { type Transport } from '@sixtyninecommerce/core';
+import type { AdminClientConfig } from '../client.js';
+import { type Country, type ZoneWithMembers } from '../geo/index.js';
+import type { Call } from '../types.js';
+/** A new zone, as {@link PlatformZonesModule.create} takes it. */
+export interface CreateZoneInput {
+    name: string;
+    /** The countries in it (`geo.countries.list` ids). None when left out. */
+    memberIds?: string[];
+}
+/** A change to a zone. A field left out keeps what the zone has; members have their own calls. */
+export interface UpdateZoneInput {
+    name?: string;
+}
+/** A country's name in one language. */
+export interface CountryTranslationInput {
+    /** As the engine spells it: `en`, `nl`, `pt_BR`. */
+    languageCode: string;
+    name: string;
+}
+/**
+ * A change to a country. A field left out keeps what the country has.
+ *
+ * The ISO code is not changeable here: tax class mappings, a store's ship-to list and every
+ * address carry it, so a changed code would silently re-route them.
+ */
+export interface UpdateCountryInput {
+    /**
+     * A disabled country is kept for history; checkout and address forms refuse it, in every
+     * store.
+     */
+    enabled?: boolean;
+    /** Writing a language the country has replaces that name; another language is added. */
+    translations?: CountryTranslationInput[];
+}
+/**
+ * `admin.platform.geo.zones` — the SuperAdmin writes of the platform's zones: the named sets
+ * of countries every store's tax rates and default zones point at (spec §9.2 `platform`, ruling
+ * G128). Reads are `geo.zones.list()` / `geo.zones.get()`. Every write answers the zone with its
+ * members, as `geo.zones.get()` reads it.
+ *
+ * Every method needs a human SuperAdmin session: an API token or an app credential is refused
+ * with `PLATFORM_REQUIRES_SESSION` (`PermissionDeniedError`, 403) BEFORE anything is sent, and a
+ * store administrator is refused by the engine with `PLATFORM_SETTINGS_NOT_ALLOWED`
+ * (`PermissionDeniedError`, 403) before anything is read or written. No tenant is needed on the
+ * client.
+ */
+export interface PlatformZonesModule {
+    /**
+     * Create a zone. A member id that names no country is skipped by the engine, so read the
+     * answer's `members` for what the zone holds.
+     *
+     * `INVALID_ZONE_INPUT` (`ValidationError`, 400): a missing or blank name, or `memberIds` that
+     * is not a list of ids, refused here before anything is sent.
+     *
+     * @effect write
+     */
+    create(input: CreateZoneInput, options?: Call): Promise<ZoneWithMembers>;
+    /**
+     * Rename a zone. `ENTITY_NOT_FOUND` (`NotFoundError`, 404): no zone has that id.
+     *
+     * @effect write
+     */
+    update(id: string, patch: UpdateZoneInput, options?: Call): Promise<ZoneWithMembers>;
+    /**
+     * Delete a zone.
+     *
+     * - `ZONE_NOT_DELETED` (`ConflictError`, 409): a store uses it as its default tax or shipping
+     *   zone, or a tax rate prices in it; the engine's reason names the store codes or the rates.
+     *   Nothing is deleted.
+     * - `ENTITY_NOT_FOUND` (`NotFoundError`, 404): no zone has that id.
+     *
+     * @effect destructive
+     */
+    delete(id: string, options?: Call): Promise<void>;
+    /**
+     * Add countries to a zone. A country already in it stays once, and an id that names no
+     * country is skipped by the engine: read the answer's `members` for what the zone holds.
+     *
+     * `INVALID_ZONE_INPUT` (`ValidationError`, 400): no ids, refused here. `ENTITY_NOT_FOUND`
+     * (`NotFoundError`, 404): no zone has that id.
+     *
+     * @effect write
+     */
+    addMembers(zoneId: string, memberIds: string[], options?: Call): Promise<ZoneWithMembers>;
+    /**
+     * Take countries out of a zone. An id that is not a member is ignored.
+     *
+     * `INVALID_ZONE_INPUT` (`ValidationError`, 400): no ids, refused here. `ENTITY_NOT_FOUND`
+     * (`NotFoundError`, 404): no zone has that id.
+     *
+     * @effect write
+     */
+    removeMembers(zoneId: string, memberIds: string[], options?: Call): Promise<ZoneWithMembers>;
+}
+/**
+ * `admin.platform.geo.countries` — the SuperAdmin write of the platform's countries (G128).
+ * Reads are `geo.countries.list()`. The same session rules as {@link PlatformZonesModule}.
+ */
+export interface PlatformCountriesModule {
+    /**
+     * Switch a country on or off, or rename it in a language, and answer it as read.
+     *
+     * `INVALID_COUNTRY_INPUT` (`ValidationError`, 400): an `enabled` that is not a boolean, a
+     * translation without a language or a name, or a `code` (not changeable here), refused before
+     * anything is sent. `ENTITY_NOT_FOUND` (`NotFoundError`, 404): no country has that id.
+     *
+     * @effect write
+     */
+    update(id: string, patch: UpdateCountryInput, options?: Call): Promise<Country>;
+}
+/** `admin.platform.geo`: SuperAdmin writes of the platform's zones and countries (G128). */
+export interface PlatformGeoModule {
+    zones: PlatformZonesModule;
+    countries: PlatformCountriesModule;
+}
+export declare const CREATE_ZONE_MUTATION = "\n  mutation PlatformCreateZone($input: CreateZoneInput!) {\n    createZone(input: $input) { \n  id\n  name\n  createdAt\n  updatedAt\n \n  members {\n    id\n    name\n    code\n    enabled\n    type\n  }\n }\n  }\n";
+export declare const UPDATE_ZONE_MUTATION = "\n  mutation PlatformUpdateZone($input: UpdateZoneInput!) {\n    updateZone(input: $input) { \n  id\n  name\n  createdAt\n  updatedAt\n \n  members {\n    id\n    name\n    code\n    enabled\n    type\n  }\n }\n  }\n";
+export declare const DELETE_ZONE_MUTATION = "\n  mutation PlatformDeleteZone($id: ID!) {\n    deleteZone(id: $id) { \n  result\n  message\n }\n  }\n";
+export declare const ADD_MEMBERS_TO_ZONE_MUTATION = "\n  mutation PlatformAddMembersToZone($zoneId: ID!, $memberIds: [ID!]!) {\n    addMembersToZone(zoneId: $zoneId, memberIds: $memberIds) { \n  id\n  name\n  createdAt\n  updatedAt\n \n  members {\n    id\n    name\n    code\n    enabled\n    type\n  }\n }\n  }\n";
+export declare const REMOVE_MEMBERS_FROM_ZONE_MUTATION = "\n  mutation PlatformRemoveMembersFromZone($zoneId: ID!, $memberIds: [ID!]!) {\n    removeMembersFromZone(zoneId: $zoneId, memberIds: $memberIds) { \n  id\n  name\n  createdAt\n  updatedAt\n \n  members {\n    id\n    name\n    code\n    enabled\n    type\n  }\n }\n  }\n";
+export declare const UPDATE_COUNTRY_MUTATION = "\n  mutation PlatformUpdateCountry($input: UpdateCountryInput!) {\n    updateCountry(input: $input) { \n  id\n  name\n  code\n  enabled\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare function createPlatformGeoModule(transport: Transport, config: AdminClientConfig): PlatformGeoModule;

package/dist/platform/geo.js

@@ -0,0 +1,144 @@
+import { ValidationError } from '@sixtyninecommerce/core';
+import { assertDeleted, DELETION_FIELDS, fieldOf, } from '../catalog/types.js';
+import { COUNTRY_FIELDS, ZONE_FIELDS, ZONE_MEMBER_FIELDS, } from '../geo/index.js';
+import { requireHumanSession } from './guard.js';
+const ZONE_ANSWER = `${ZONE_FIELDS} ${ZONE_MEMBER_FIELDS}`;
+export const CREATE_ZONE_MUTATION = /* GraphQL */ `
+  mutation PlatformCreateZone($input: CreateZoneInput!) {
+    createZone(input: $input) { ${ZONE_ANSWER} }
+  }
+`;
+export const UPDATE_ZONE_MUTATION = /* GraphQL */ `
+  mutation PlatformUpdateZone($input: UpdateZoneInput!) {
+    updateZone(input: $input) { ${ZONE_ANSWER} }
+  }
+`;
+export const DELETE_ZONE_MUTATION = /* GraphQL */ `
+  mutation PlatformDeleteZone($id: ID!) {
+    deleteZone(id: $id) { ${DELETION_FIELDS} }
+  }
+`;
+export const ADD_MEMBERS_TO_ZONE_MUTATION = /* GraphQL */ `
+  mutation PlatformAddMembersToZone($zoneId: ID!, $memberIds: [ID!]!) {
+    addMembersToZone(zoneId: $zoneId, memberIds: $memberIds) { ${ZONE_ANSWER} }
+  }
+`;
+export const REMOVE_MEMBERS_FROM_ZONE_MUTATION = /* GraphQL */ `
+  mutation PlatformRemoveMembersFromZone($zoneId: ID!, $memberIds: [ID!]!) {
+    removeMembersFromZone(zoneId: $zoneId, memberIds: $memberIds) { ${ZONE_ANSWER} }
+  }
+`;
+export const UPDATE_COUNTRY_MUTATION = /* GraphQL */ `
+  mutation PlatformUpdateCountry($input: UpdateCountryInput!) {
+    updateCountry(input: $input) { ${COUNTRY_FIELDS} }
+  }
+`;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const refusal = (code) => (message) => new ValidationError({ code, message, status: 400, service: 'vendure' });
+const zoneRefusal = refusal('INVALID_ZONE_INPUT');
+const countryRefusal = refusal('INVALID_COUNTRY_INPUT');
+const isId = (value) => typeof value === 'string' && value.trim() !== '';
+function requireId(id, what, refuse) {
+    if (!isId(id))
+        throw refuse(`${what} must be an id.`);
+    return id;
+}
+function memberIdsInput(value, allowEmpty) {
+    if (!Array.isArray(value) || !value.every(isId)) {
+        throw zoneRefusal('memberIds must be a list of country ids.');
+    }
+    if (!allowEmpty && value.length === 0) {
+        throw zoneRefusal('Name at least one country.');
+    }
+    return [...value];
+}
+function zoneInput(input, creating) {
+    if (!isObject(input))
+        throw zoneRefusal('A zone input must be an object.');
+    const out = {};
+    if (input.name !== undefined || creating) {
+        if (typeof input.name !== 'string' || input.name.trim() === '') {
+            throw zoneRefusal('A zone needs a name.');
+        }
+        out.name = input.name;
+    }
+    if (creating && input.memberIds !== undefined) {
+        out.memberIds = memberIdsInput(input.memberIds, true);
+    }
+    return out;
+}
+function countryInput(input) {
+    if (!isObject(input))
+        throw countryRefusal('A country change must be an object.');
+    if (input.code !== undefined) {
+        throw countryRefusal('A country keeps its ISO code: tax class mappings, ship-to lists and addresses carry it.');
+    }
+    const out = {};
+    if (input.enabled !== undefined) {
+        if (typeof input.enabled !== 'boolean')
+            throw countryRefusal('enabled must be a boolean.');
+        out.enabled = input.enabled;
+    }
+    if (input.translations !== undefined) {
+        const rows = input.translations;
+        if (!Array.isArray(rows) ||
+            !rows.every((row) => isObject(row) &&
+                typeof row.languageCode === 'string' &&
+                row.languageCode !== '' &&
+                typeof row.name === 'string' &&
+                row.name.trim() !== '')) {
+            throw countryRefusal('translations must be a list of { languageCode, name } with strings.');
+        }
+        out.translations = rows.map((row) => ({
+            languageCode: row.languageCode,
+            name: row.name,
+        }));
+    }
+    return out;
+}
+export function createPlatformGeoModule(transport, config) {
+    // Platform-wide rows: no store is involved, so no tenant is needed. Scoped to a store instead,
+    // the transport would first resolve it through the CMS channel mirror and fail on one missing
+    // there.
+    const unscoped = (call) => ({ ...call, allowUnscoped: true });
+    return {
+        zones: {
+            async create(input, options) {
+                requireHumanSession(config);
+                return fieldOf(transport, CREATE_ZONE_MUTATION, 'createZone', { input: zoneInput(input, true) }, unscoped(options));
+            },
+            async update(id, patch, options) {
+                requireHumanSession(config);
+                const zoneId = requireId(id, 'id', zoneRefusal);
+                return fieldOf(transport, UPDATE_ZONE_MUTATION, 'updateZone', { input: { ...zoneInput(patch, false), id: zoneId } }, unscoped(options));
+            },
+            async delete(id, options) {
+                requireHumanSession(config);
+                assertDeleted('ZONE_NOT_DELETED', [
+                    await fieldOf(transport, DELETE_ZONE_MUTATION, 'deleteZone', { id: requireId(id, 'id', zoneRefusal) }, unscoped(options)),
+                ]);
+            },
+            async addMembers(zoneId, memberIds, options) {
+                requireHumanSession(config);
+                return fieldOf(transport, ADD_MEMBERS_TO_ZONE_MUTATION, 'addMembersToZone', {
+                    zoneId: requireId(zoneId, 'zoneId', zoneRefusal),
+                    memberIds: memberIdsInput(memberIds, false),
+                }, unscoped(options));
+            },
+            async removeMembers(zoneId, memberIds, options) {
+                requireHumanSession(config);
+                return fieldOf(transport, REMOVE_MEMBERS_FROM_ZONE_MUTATION, 'removeMembersFromZone', {
+                    zoneId: requireId(zoneId, 'zoneId', zoneRefusal),
+                    memberIds: memberIdsInput(memberIds, false),
+                }, unscoped(options));
+            },
+        },
+        countries: {
+            async update(id, patch, options) {
+                requireHumanSession(config);
+                const countryId = requireId(id, 'id', countryRefusal);
+                return fieldOf(transport, UPDATE_COUNTRY_MUTATION, 'updateCountry', { input: { ...countryInput(patch), id: countryId } }, unscoped(options));
+            },
+        },
+    };
+}

package/dist/platform/tax.d.ts

@@ -0,0 +1,162 @@
+import { type Transport } from '@sixtyninecommerce/core';
+import type { AdminClientConfig } from '../client.js';
+import { type TaxCategory, type TaxRate } from '../tax/index.js';
+import type { Call } from '../types.js';
+/** A new platform-wide tax category, as {@link PlatformTaxCategoriesModule.create} takes it. */
+export interface CreateTaxCategoryInput {
+    name: string;
+    /**
+     * Make it the platform's default category. Only one category is the default: setting it here
+     * takes the mark off the one that had it. Not the default when left out.
+     */
+    isDefault?: boolean;
+}
+/** A change to a tax category. A field left out keeps what the category has. */
+export interface UpdateTaxCategoryInput {
+    name?: string;
+    /** `true` moves the default mark here (off the category that had it). */
+    isDefault?: boolean;
+}
+/** A new platform-wide tax rate, as {@link PlatformTaxRatesModule.create} takes it. */
+export interface CreateTaxRateInput {
+    name: string;
+    /**
+     * A percentage from 0 to 100, both included: `21` is 21 %. Not money. The engine keeps two
+     * decimals (`5.5`, `20.75`), so a third one is rounded when it is stored; the answer carries
+     * the stored value. A value outside 0–100 is refused as sent, before any rounding
+     * (`TAX_RATE_VALUE_INVALID`).
+     */
+    value: number;
+    /** A disabled rate is never applied. Required: a rate is applied from the moment it exists. */
+    enabled: boolean;
+    /** The tax category it prices (`tax.categories.list`). */
+    categoryId: string;
+    /** The zone it prices that category in (`geo.zones.list`). */
+    zoneId: string;
+    /** Only for customers of this group. Left out, the rate applies to every customer. */
+    customerGroupId?: string;
+}
+/**
+ * A change to a tax rate. A field left out keeps what the rate has.
+ *
+ * There is no way to take the customer group OFF a rate: the engine ignores a null group and
+ * keeps the one stored, so `customerGroupId: null` is refused here rather than silently
+ * dropped. To widen a group-limited rate to every customer, create a rate without a group and
+ * delete the old one.
+ */
+export interface UpdateTaxRateInput {
+    name?: string;
+    /** See {@link CreateTaxRateInput.value}. */
+    value?: number;
+    enabled?: boolean;
+    categoryId?: string;
+    zoneId?: string;
+    /** Move the rate to another customer group. */
+    customerGroupId?: string;
+}
+/**
+ * `admin.platform.tax.categories` — the SuperAdmin writes of the platform-wide tax categories
+ * every store shares (spec §9.2 `platform`, ruling G128). Reads are `tax.categories.list()`.
+ *
+ * Every method needs a human SuperAdmin session: an API token or an app credential is refused
+ * with `PLATFORM_REQUIRES_SESSION` (`PermissionDeniedError`, 403) BEFORE anything is sent, and a
+ * store administrator is refused by the engine with `PLATFORM_SETTINGS_NOT_ALLOWED`
+ * (`PermissionDeniedError`, 403) before anything is read or written. No tenant is needed on the
+ * client.
+ */
+export interface PlatformTaxCategoriesModule {
+    /**
+     * Create a tax category, and answer it as `tax.categories.list()` reads it.
+     *
+     * `INVALID_TAX_CATEGORY_INPUT` (`ValidationError`, 400): a missing or blank name, or an
+     * `isDefault` that is not a boolean, refused here before anything is sent.
+     *
+     * @effect write
+     */
+    create(input: CreateTaxCategoryInput, options?: Call): Promise<TaxCategory>;
+    /**
+     * Rename a tax category or move the default mark to it, and answer it as read. Every store
+     * mapping a tax class onto it, and every rate pricing it, keeps pointing at it.
+     *
+     * `ENTITY_NOT_FOUND` (`NotFoundError`, 404): no category has that id.
+     *
+     * @effect write
+     */
+    update(id: string, patch: UpdateTaxCategoryInput, options?: Call): Promise<TaxCategory>;
+    /**
+     * Delete a tax category nothing uses any more.
+     *
+     * - `TAX_CATEGORY_IN_USE` (`ConflictError`, 409): something still prices or carries it. The
+     *   message names what: the tax rates pricing it, each store's tax class mapped to it (by key
+     *   and store code), how many product variants carry it, and whether deleted variants or
+     *   orders were taxed with it. Rates, classes and live variants can be moved to another
+     *   category; deleted variants and orders keep it for good, so such a category can never be
+     *   deleted. Nothing is deleted.
+     * - `TAX_CATEGORY_NOT_DELETED` (`ConflictError`, 409): the engine refused it for a reason it
+     *   answered as a result rather than an error, with that reason.
+     * - `ENTITY_NOT_FOUND` (`NotFoundError`, 404): no category has that id.
+     *
+     * @effect destructive
+     */
+    delete(id: string, options?: Call): Promise<void>;
+}
+/**
+ * `admin.platform.tax.rates` — the SuperAdmin writes of the platform-wide tax rates: what a tax
+ * category costs in a zone. One rate serves every store, so a change reaches every store selling
+ * into that zone. Reads are `tax.rates.list()`.
+ *
+ * Every method needs a human SuperAdmin session (`PLATFORM_REQUIRES_SESSION` before anything is
+ * sent; `PLATFORM_SETTINGS_NOT_ALLOWED` from the engine for a store administrator, both
+ * `PermissionDeniedError`, 403). No tenant is needed on the client.
+ */
+export interface PlatformTaxRatesModule {
+    /**
+     * Create a tax rate, and answer it as `tax.rates.list()` reads it.
+     *
+     * - `INVALID_TAX_RATE_INPUT` (`ValidationError`, 400): a missing name, category, zone or
+     *   `enabled`, or a value that is not a finite number, refused here before anything is sent.
+     * - `TAX_RATE_VALUE_INVALID` (`ValidationError`, 400): a value below 0 or above 100. Refused
+     *   here before anything is sent, and by the engine for any other caller, with the same code
+     *   and `details[0].field` `/input/value` (`code` `minimum` or `maximum`), so a form can put
+     *   the sentence on the rate field whichever side refused it.
+     * - `ENTITY_NOT_FOUND` (`NotFoundError`, 404): the category, zone or customer group does not
+     *   exist.
+     *
+     * Tagged `money`: a rate decides the tax every store selling into its zone charges from the
+     * moment it exists.
+     *
+     * @effect money
+     */
+    create(input: CreateTaxRateInput, options?: Call): Promise<TaxRate>;
+    /**
+     * Change a tax rate, and answer it as read. Refused as {@link create} is, plus
+     * `INVALID_TAX_RATE_INPUT` for `customerGroupId: null` (see {@link UpdateTaxRateInput}) and
+     * `ENTITY_NOT_FOUND` for an unknown rate. Only a value the patch SENDS is held to 0–100: a
+     * rate stored outside it before the bound existed can still be renamed or switched off
+     * without one.
+     *
+     * @effect money
+     */
+    update(id: string, patch: UpdateTaxRateInput, options?: Call): Promise<TaxRate>;
+    /**
+     * Delete a tax rate, for every store.
+     *
+     * - `TAX_RATE_NOT_DELETED` (`ConflictError`, 409): the engine refused it, with its reason.
+     * - `ENTITY_NOT_FOUND` (`NotFoundError`, 404): no rate has that id.
+     *
+     * @effect destructive
+     */
+    delete(id: string, options?: Call): Promise<void>;
+}
+/** `admin.platform.tax`: SuperAdmin writes of the platform-wide tax tables (G128). */
+export interface PlatformTaxModule {
+    categories: PlatformTaxCategoriesModule;
+    rates: PlatformTaxRatesModule;
+}
+export declare const CREATE_TAX_CATEGORY_MUTATION = "\n  mutation PlatformCreateTaxCategory($input: CreateTaxCategoryInput!) {\n    createTaxCategory(input: $input) { \n  id\n  name\n  isDefault\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const UPDATE_TAX_CATEGORY_MUTATION = "\n  mutation PlatformUpdateTaxCategory($input: UpdateTaxCategoryInput!) {\n    updateTaxCategory(input: $input) { \n  id\n  name\n  isDefault\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const DELETE_TAX_CATEGORY_MUTATION = "\n  mutation PlatformDeleteTaxCategory($id: ID!) {\n    deleteTaxCategory(id: $id) { \n  result\n  message\n }\n  }\n";
+export declare const CREATE_TAX_RATE_MUTATION = "\n  mutation PlatformCreateTaxRate($input: CreateTaxRateInput!) {\n    createTaxRate(input: $input) { \n  id\n  name\n  value\n  enabled\n  category { id name }\n  zone { id name }\n  customerGroup { id name }\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const UPDATE_TAX_RATE_MUTATION = "\n  mutation PlatformUpdateTaxRate($input: UpdateTaxRateInput!) {\n    updateTaxRate(input: $input) { \n  id\n  name\n  value\n  enabled\n  category { id name }\n  zone { id name }\n  customerGroup { id name }\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const DELETE_TAX_RATE_MUTATION = "\n  mutation PlatformDeleteTaxRate($id: ID!) {\n    deleteTaxRate(id: $id) { \n  result\n  message\n }\n  }\n";
+export declare function createPlatformTaxModule(transport: Transport, config: AdminClientConfig): PlatformTaxModule;

package/dist/platform/tax.js

@@ -0,0 +1,169 @@
+import { ValidationError } from '@sixtyninecommerce/core';
+import { assertDeleted, DELETION_FIELDS, fieldOf, } from '../catalog/types.js';
+import { TAX_CATEGORY_FIELDS, TAX_RATE_FIELDS, } from '../tax/index.js';
+import { requireHumanSession } from './guard.js';
+export const CREATE_TAX_CATEGORY_MUTATION = /* GraphQL */ `
+  mutation PlatformCreateTaxCategory($input: CreateTaxCategoryInput!) {
+    createTaxCategory(input: $input) { ${TAX_CATEGORY_FIELDS} }
+  }
+`;
+export const UPDATE_TAX_CATEGORY_MUTATION = /* GraphQL */ `
+  mutation PlatformUpdateTaxCategory($input: UpdateTaxCategoryInput!) {
+    updateTaxCategory(input: $input) { ${TAX_CATEGORY_FIELDS} }
+  }
+`;
+export const DELETE_TAX_CATEGORY_MUTATION = /* GraphQL */ `
+  mutation PlatformDeleteTaxCategory($id: ID!) {
+    deleteTaxCategory(id: $id) { ${DELETION_FIELDS} }
+  }
+`;
+export const CREATE_TAX_RATE_MUTATION = /* GraphQL */ `
+  mutation PlatformCreateTaxRate($input: CreateTaxRateInput!) {
+    createTaxRate(input: $input) { ${TAX_RATE_FIELDS} }
+  }
+`;
+export const UPDATE_TAX_RATE_MUTATION = /* GraphQL */ `
+  mutation PlatformUpdateTaxRate($input: UpdateTaxRateInput!) {
+    updateTaxRate(input: $input) { ${TAX_RATE_FIELDS} }
+  }
+`;
+export const DELETE_TAX_RATE_MUTATION = /* GraphQL */ `
+  mutation PlatformDeleteTaxRate($id: ID!) {
+    deleteTaxRate(id: $id) { ${DELETION_FIELDS} }
+  }
+`;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const refusal = (code) => (message) => new ValidationError({ code, message, status: 400, service: 'vendure' });
+const categoryRefusal = refusal('INVALID_TAX_CATEGORY_INPUT');
+const rateRefusal = refusal('INVALID_TAX_RATE_INPUT');
+/** The bounds of a rate's percentage; the engine holds every caller to the same ones. */
+const TAX_RATE_MIN_PERCENT = 0;
+const TAX_RATE_MAX_PERCENT = 100;
+/**
+ * The engine's own refusal of a value outside 0–100 % (`TAX_RATE_VALUE_INVALID`), word for word,
+ * with the detail on `/input/value` the engine answers, so a caller cannot tell which side
+ * refused it.
+ */
+function rateValueOutOfRange(value) {
+    const below = value < TAX_RATE_MIN_PERCENT;
+    const range = `from ${String(TAX_RATE_MIN_PERCENT)} to ${String(TAX_RATE_MAX_PERCENT)}`;
+    return new ValidationError({
+        code: 'TAX_RATE_VALUE_INVALID',
+        message: below
+            ? `A tax rate cannot be below ${String(TAX_RATE_MIN_PERCENT)} %: ${String(value)} % was sent. Enter a percentage ${range}.`
+            : `A tax rate cannot be above ${String(TAX_RATE_MAX_PERCENT)} %: ${String(value)} % was sent. Enter a percentage ${range}.`,
+        status: 400,
+        service: 'vendure',
+        details: [
+            {
+                field: '/input/value',
+                code: below ? 'minimum' : 'maximum',
+                message: `Enter a rate ${range}.`,
+            },
+        ],
+    });
+}
+function requireId(id, what, refuse) {
+    if (typeof id !== 'string' || id.trim() === '')
+        throw refuse(`${what} must be an id.`);
+    return id;
+}
+function categoryInput(input, creating) {
+    if (!isObject(input))
+        throw categoryRefusal('A tax category input must be an object.');
+    const out = {};
+    if (input.name !== undefined || creating) {
+        if (typeof input.name !== 'string' || input.name.trim() === '') {
+            throw categoryRefusal('A tax category needs a name.');
+        }
+        out.name = input.name;
+    }
+    if (input.isDefault !== undefined) {
+        if (typeof input.isDefault !== 'boolean')
+            throw categoryRefusal('isDefault must be a boolean.');
+        out.isDefault = input.isDefault;
+    }
+    return out;
+}
+function rateInput(input, creating) {
+    if (!isObject(input))
+        throw rateRefusal('A tax rate input must be an object.');
+    const out = {};
+    if (input.name !== undefined || creating) {
+        if (typeof input.name !== 'string' || input.name.trim() === '') {
+            throw rateRefusal('A tax rate needs a name.');
+        }
+        out.name = input.name;
+    }
+    if (input.value !== undefined || creating) {
+        if (typeof input.value !== 'number' || !Number.isFinite(input.value)) {
+            throw rateRefusal('value must be a finite number: the percentage, 21 for 21 %.');
+        }
+        if (input.value < TAX_RATE_MIN_PERCENT || input.value > TAX_RATE_MAX_PERCENT) {
+            throw rateValueOutOfRange(input.value);
+        }
+        out.value = input.value;
+    }
+    if (input.enabled !== undefined || creating) {
+        if (typeof input.enabled !== 'boolean')
+            throw rateRefusal('enabled must be a boolean.');
+        out.enabled = input.enabled;
+    }
+    if (input.categoryId !== undefined || creating) {
+        out.categoryId = requireId(input.categoryId, 'categoryId', rateRefusal);
+    }
+    if (input.zoneId !== undefined || creating) {
+        out.zoneId = requireId(input.zoneId, 'zoneId', rateRefusal);
+    }
+    if (input.customerGroupId === null && !creating) {
+        // The engine reads a null group as "keep the stored one": a request that seems to widen a
+        // group-limited rate to every customer would answer success and change nothing.
+        throw rateRefusal('A tax rate cannot lose its customer group: create a rate without one and delete this one.');
+    }
+    if (input.customerGroupId !== undefined && input.customerGroupId !== null) {
+        out.customerGroupId = requireId(input.customerGroupId, 'customerGroupId', rateRefusal);
+    }
+    return out;
+}
+export function createPlatformTaxModule(transport, config) {
+    // Platform-wide rows: no store is involved, so no tenant is needed. Scoped to a store instead,
+    // the transport would first resolve it through the CMS channel mirror and fail on one missing
+    // there.
+    const unscoped = (call) => ({ ...call, allowUnscoped: true });
+    return {
+        categories: {
+            async create(input, options) {
+                requireHumanSession(config);
+                return fieldOf(transport, CREATE_TAX_CATEGORY_MUTATION, 'createTaxCategory', { input: categoryInput(input, true) }, unscoped(options));
+            },
+            async update(id, patch, options) {
+                requireHumanSession(config);
+                const categoryId = requireId(id, 'id', categoryRefusal);
+                return fieldOf(transport, UPDATE_TAX_CATEGORY_MUTATION, 'updateTaxCategory', { input: { ...categoryInput(patch, false), id: categoryId } }, unscoped(options));
+            },
+            async delete(id, options) {
+                requireHumanSession(config);
+                assertDeleted('TAX_CATEGORY_NOT_DELETED', [
+                    await fieldOf(transport, DELETE_TAX_CATEGORY_MUTATION, 'deleteTaxCategory', { id: requireId(id, 'id', categoryRefusal) }, unscoped(options)),
+                ]);
+            },
+        },
+        rates: {
+            async create(input, options) {
+                requireHumanSession(config);
+                return fieldOf(transport, CREATE_TAX_RATE_MUTATION, 'createTaxRate', { input: rateInput(input, true) }, unscoped(options));
+            },
+            async update(id, patch, options) {
+                requireHumanSession(config);
+                const rateId = requireId(id, 'id', rateRefusal);
+                return fieldOf(transport, UPDATE_TAX_RATE_MUTATION, 'updateTaxRate', { input: { ...rateInput(patch, false), id: rateId } }, unscoped(options));
+            },
+            async delete(id, options) {
+                requireHumanSession(config);
+                assertDeleted('TAX_RATE_NOT_DELETED', [
+                    await fieldOf(transport, DELETE_TAX_RATE_MUTATION, 'deleteTaxRate', { id: requireId(id, 'id', rateRefusal) }, unscoped(options)),
+                ]);
+            },
+        },
+    };
+}