@sixtyninecommerce/admin 0.9.0 → 0.11.0

package/dist/users/index.d.ts

@@ -1,5 +1,6 @@
 import type { Transport } from '@sixtyninecommerce/core';
 import type { Call } from '../types.js';
+import { type UserWarehousesModule } from './warehouses.js';
 /**
  * What `users.ensure` did. A newer engine may name an outcome this SDK does not know yet; it is
  * passed through, lower-cased, rather than dropped.
@@ -98,6 +99,8 @@ export interface UsersModule {
      * Someone outside the active store answers `ENTITY_NOT_FOUND`.
      */
     update(input: UpdateUserInput, call?: Call): Promise<StaffUser>;
+    /** Which of the store's warehouses a staff member works in. See {@link UserWarehousesModule}. */
+    warehouses: UserWarehousesModule;
 }
 export declare const ENSURE_ADMINISTRATOR_MUTATION = "\n  mutation EnsureAdministrator($input: EnsureAdministratorInput!) {\n    ensureAdministrator(input: $input) {\n      outcome\n      invitationSent\n      administrator { \n  id\n  firstName\n  lastName\n  emailAddress\n  user {\n    roles {\n      id\n      code\n    }\n  }\n }\n    }\n  }\n";
 export declare const UPDATE_ADMINISTRATOR_MUTATION = "\n  mutation UpdateStaffUser($input: UpdateAdministratorInput!) {\n    updateAdministrator(input: $input) { \n  id\n  firstName\n  lastName\n  emailAddress\n  user {\n    roles {\n      id\n      code\n    }\n  }\n }\n  }\n";

package/dist/users/index.js

@@ -1,3 +1,4 @@
+import { createUserWarehousesModule } from './warehouses.js';
 const STAFF_USER_FIELDS = /* GraphQL */ `
   id
   firstName
@@ -76,5 +77,6 @@ export function createUsersModule(transport) {
             }, call);
             return staffUserOf(data.updateAdministrator);
         },
+        warehouses: createUserWarehousesModule(transport),
     };
 }

package/dist/users/warehouses.d.ts

@@ -0,0 +1,50 @@
+import { type Transport } from '@sixtyninecommerce/core';
+import type { Call } from '../types.js';
+/** A warehouse (stock location) a staff member is assigned to, by name. */
+export interface AssignedWarehouse {
+    id: string;
+    name: string;
+}
+/**
+ * `admin.users.warehouses`: which of the store's warehouses a staff member works in (spec §12.3,
+ * Settings → Team → a user → Warehouses). A user on the Warehouse role sees and ships only from
+ * the warehouses assigned here, and from none without any; a user who manages orders sees every
+ * warehouse whatever is assigned.
+ *
+ * Needs the store's `warehouse` entitlement: without it every method is refused
+ * `WAREHOUSE_NOT_ENABLED` (`BusinessRuleError`). Needs `ManageWarehouseAssignments` or
+ * `UpdateAdministrator` (either one, so no `@permission` tag: the tag can only say "all of
+ * these").
+ *
+ * Per store: the assignments of the store the client is on, never another store's. A staff member
+ * who holds no role in this store, a deleted one and a malformed id are refused alike, as a
+ * `ValidationError` naming the user.
+ *
+ * A credential restricted with `locationIds` (an API token or app) manages only those
+ * locations: `get` lists only the assigned warehouses among them, and `set` keeps the person's
+ * assignments at the store's other warehouses as they are.
+ */
+export interface UserWarehousesModule {
+    /**
+     * The warehouses the staff member is assigned to in this store, by name.
+     *
+     * @effect read
+     */
+    get(administratorId: string, options?: Call): Promise<AssignedWarehouse[]>;
+    /**
+     * Assign exactly these warehouses (an empty list: none), replacing the person's assignments in
+     * this store, and answer them. Repeating the call changes nothing.
+     *
+     * Refused before anything is written:
+     * - a warehouse that is not one of this store's (deleted, another store's, a malformed id) as a
+     *   `ValidationError` naming it; for a credential restricted with `locationIds`, any id outside
+     *   its locations is `LOCATION_OUT_OF_SCOPE` (`BusinessRuleError`) instead;
+     * - more than 200 warehouses (`ValidationError`).
+     *
+     * @effect write
+     */
+    set(administratorId: string, stockLocationIds: readonly string[], options?: Call): Promise<AssignedWarehouse[]>;
+}
+export declare const ADMINISTRATOR_WAREHOUSES_QUERY = "\n  query AdministratorWarehouses($administratorId: ID!) {\n    administratorWarehouses(administratorId: $administratorId) {\n      id\n      name\n    }\n  }\n";
+export declare const SET_ADMINISTRATOR_WAREHOUSES_MUTATION = "\n  mutation SetAdministratorWarehouses($administratorId: ID!, $stockLocationIds: [ID!]!) {\n    setAdministratorWarehouses(administratorId: $administratorId, stockLocationIds: $stockLocationIds) {\n      id\n      name\n    }\n  }\n";
+export declare function createUserWarehousesModule(transport: Transport): UserWarehousesModule;

package/dist/users/warehouses.js

@@ -0,0 +1,51 @@
+import { ValidationError } from '@sixtyninecommerce/core';
+import { fieldOf } from '../catalog/types.js';
+export const ADMINISTRATOR_WAREHOUSES_QUERY = /* GraphQL */ `
+  query AdministratorWarehouses($administratorId: ID!) {
+    administratorWarehouses(administratorId: $administratorId) {
+      id
+      name
+    }
+  }
+`;
+export const SET_ADMINISTRATOR_WAREHOUSES_MUTATION = /* GraphQL */ `
+  mutation SetAdministratorWarehouses($administratorId: ID!, $stockLocationIds: [ID!]!) {
+    setAdministratorWarehouses(administratorId: $administratorId, stockLocationIds: $stockLocationIds) {
+      id
+      name
+    }
+  }
+`;
+const invalidInput = (message) => new ValidationError({
+    code: 'USER_WAREHOUSES_INPUT_INVALID',
+    message,
+    status: 400,
+    service: 'vendure',
+});
+function assertAdministratorId(administratorId) {
+    if (typeof administratorId !== 'string' || administratorId.trim() === '') {
+        throw invalidInput('administratorId must be a staff member id.');
+    }
+}
+const toWarehouse = (wire) => ({
+    id: wire.id,
+    name: wire.name,
+});
+export function createUserWarehousesModule(transport) {
+    return {
+        async get(administratorId, options) {
+            assertAdministratorId(administratorId);
+            const rows = await fieldOf(transport, ADMINISTRATOR_WAREHOUSES_QUERY, 'administratorWarehouses', { administratorId }, options);
+            return rows.map(toWarehouse);
+        },
+        async set(administratorId, stockLocationIds, options) {
+            assertAdministratorId(administratorId);
+            if (!Array.isArray(stockLocationIds) ||
+                !stockLocationIds.every((id) => typeof id === 'string' && id.trim() !== '')) {
+                throw invalidInput('stockLocationIds must be a list of stock location ids.');
+            }
+            const rows = await fieldOf(transport, SET_ADMINISTRATOR_WAREHOUSES_MUTATION, 'setAdministratorWarehouses', { administratorId, stockLocationIds: [...stockLocationIds] }, options);
+            return rows.map(toWarehouse);
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixtyninecommerce/admin",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Back-office SDK for sixtynine-commerce: every capability of the platform as a method",
   "homepage": "https://github.com/SIXTYNINE-digital/sixtynine-commerce-engine/tree/main/packages/admin-client#readme",
   "repository": {
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@sixtyninecommerce/core": "^0.5.0"
+    "@sixtyninecommerce/core": "^0.6.0"
   },
   "devDependencies": {
     "@types/node": "22.19.7",