@fakeware/plugin-pickware 0.0.1 → 1.1.0

package/README.md

@@ -2,139 +2,3 @@
 
 A [fakeware](https://github.com/fakeware-sh/fakeware) plugin for **Pickware ERP** —
 seed warehouses, bin locations, and stock into a Shopware 6 shop running Pickware.
-
-It teaches fakeware about Pickware's DAL entities so you can author them with
-`define(...)` in your data files, and contributes a fetcher that loads the shop's
-existing warehouses into the run context.
-
-> **Status: minimal v1.** Covers `pickware_erp_warehouse`, `pickware_erp_bin_location`,
-> and `pickware_erp_stock_movement`. Suppliers, purchasing, stocktakes, and the
-> WMS/POS/Shipping entities are intentionally out of scope for now.
-
-## Install
-
-```sh
-bun add -D @fakeware/plugin-pickware
-# @fakeware/core is a peer dependency — your fakeware project already has it.
-```
-
-## Usage
-
-Register the plugin in `fakeware.config.ts`:
-
-```ts
-import { defineConfig } from '@fakeware/core/config'
-import { pickware } from '@fakeware/plugin-pickware'
-
-export default defineConfig({
-  shopware: {
-    url: process.env.SHOPWARE_URL!,
-    clientId: process.env.SHOPWARE_CLIENT_ID!,
-    clientSecret: process.env.SHOPWARE_CLIENT_SECRET!,
-  },
-  plugins: [pickware()],
-})
-```
-
-Author Pickware data in `data/*.ts`. Importing the package augments fakeware's
-`EntityRegistry`, so the `pickware_erp_*` entity names are fully type-checked:
-
-`data/pickware.ts`:
-
-```ts
-import { define, ref } from '@fakeware/core'
-import { stockMovementIn } from '@fakeware/plugin-pickware'
-
-define('pickware_erp_warehouse', { $key: 'main', name: 'Main', code: 'WH-01' })
-
-define('pickware_erp_bin_location', {
-  $key: 'a1',
-  code: 'A1',
-  warehouseId: ref('pickware_erp_warehouse/main'),
-})
-
-define(
-  'pickware_erp_stock_movement',
-  stockMovementIn({
-    productId: ref('product/my-product'),
-    warehouseId: ref('pickware_erp_warehouse/main'),
-    quantity: 100,
-  }),
-)
-```
-
-Bin locations referencing a warehouse via `ref()` are written after it
-automatically. Seed stock through `pickware_erp_stock_movement` (an append-only
-ledger) — never write `product.stock` directly while Pickware is active.
-
-Run it with the fakeware CLI:
-
-```sh
-fakeware up --dry-run
-fakeware up
-```
-
-### Referencing existing warehouses
-
-`pickware()` adds a fetcher that loads the shop's current warehouses into the run
-context. Read them in a plugin `setup` hook or any code with access to the context:
-
-```ts
-import { pickwareWarehouses } from '@fakeware/plugin-pickware'
-
-const existing = pickwareWarehouses(shopContext.extensions)
-const main = existing.find((w) => w.code === 'WH-01')
-```
-
-## ⚠️ Verify field names against your install
-
-Pickware publishes **no Shopware 6 API documentation**, so the entity *field
-names* in this plugin (especially `destinationWarehouseId` on the stock movement)
-are best-effort. **Before a live `up`, confirm them against your shop:**
-
-```sh
-curl -H "Authorization: Bearer <token>" \
-  https://your-shop.example/api/_info/entity-schema.json \
-  | jq 'keys | map(select(startswith("pickware_erp")))'
-```
-
-Inspect the `pickware_erp_warehouse`, `pickware_erp_bin_location`, and
-`pickware_erp_stock_movement` field definitions there (or watch the Pickware
-admin module's network requests) and adjust the record shapes in
-`src/entities.ts` / the `stockMovementIn` helper to match.
-
-Key facts the plugin is built around:
-
-- Stock is owned by Pickware's **append-only ledger** (`pickware_erp_stock_movement`).
-  You change stock by **adding movements**; Pickware recomputes
-  `pickware_erp_stock` and mirrors the total back into `product.stock`.
-- Writing `product.stock` directly via the standard API while Pickware is active
-  **nulls** the Pickware warehouses — don't do it.
-
-## Publishing
-
-This repo publishes `@fakeware/plugin-pickware` to npm via
-[release-please](https://github.com/googleapis/release-please) — the same flow as
-the fakeware monorepo. Conventional commits on `main` open a release PR; merging
-it tags a version and publishes.
-
-**One-time repo setup** (in GitHub → Settings):
-
-- Add an npm publish credential for the `@fakeware` scope. The release workflow
-  uses npm provenance (`id-token: write`) — configure a trusted publisher on npm,
-  or add an `NPM_TOKEN` secret and wire it into `.github/workflows/release.yml`.
-- The default `GITHUB_TOKEN` is sufficient for release-please's PR/tagging.
-
-## Development
-
-```sh
-bun install
-bun run build
-bun run typecheck
-bun test
-bun run check
-```
-
-## License
-
-MIT

package/dist/index.d.mts

@@ -1,27 +1,72 @@
-import { FakewarePlugin, ShopContextFetcher } from "@fakeware/core";
+import { AnyToken, FakewarePlugin, ShopContextFetcher } from "@fakeware/core";
 
 //#region src/entities.d.ts
-interface PickwareWarehouseRecord {
+declare const PICKWARE_LIVE_VERSION = "0fa91ce3e96a4bc2be4bd9ce752c3425";
+type Id = string | AnyToken;
+interface PickwareBinLocationRecord {
   $key?: string;
-  name: string;
   code: string;
+  warehouseId: Id;
 }
-interface PickwareBinLocationRecord {
+interface PickwareSupplierRecord {
   $key?: string;
-  code: string;
-  warehouseId: string;
+  number: string;
+  name: string;
+  languageId: Id;
+  customerNumber?: string;
+}
+interface PickwarePrice {
+  currencyId: Id;
+  gross: number;
+  net: number;
+  linked: boolean;
 }
-interface PickwareStockMovementRecord {
+interface PickwareProductSupplierConfigurationRecord {
   $key?: string;
-  productId: string;
+  productId: Id;
+  productVersionId?: string;
+  supplierId: Id;
+  minPurchase: number;
+  purchaseSteps: number;
+  purchasePrices: PickwarePrice[];
+  supplierIsDefault: boolean;
+}
+type PickwareReturnReason = 'wrong_item' | 'defective' | 'other';
+interface PickwareReturnOrderLineItemRecord {
+  $key?: string;
+  versionId?: string;
+  type?: string;
+  name: string;
   quantity: number;
-  destinationWarehouseId: string;
+  position: number;
+  reason: PickwareReturnReason;
+  priceDefinition: object;
+  price: object;
+  productId?: Id;
+  productVersionId?: string;
+  orderLineItemId?: Id;
+  orderLineItemVersionId?: string;
+}
+interface PickwareReturnOrderRecord {
+  $key?: string;
+  versionId?: string;
+  number: string;
+  stateId?: Id;
+  orderId: Id;
+  orderVersionId?: string;
+  price: object;
+  shippingCosts?: object;
+  internalComment?: string;
+  warehouseId?: Id;
+  lineItems: PickwareReturnOrderLineItemRecord[];
 }
 declare module '@fakeware/core' {
   interface EntityRegistry {
-    pickware_erp_warehouse: PickwareWarehouseRecord;
     pickware_erp_bin_location: PickwareBinLocationRecord;
-    pickware_erp_stock_movement: PickwareStockMovementRecord;
+    pickware_erp_supplier: PickwareSupplierRecord;
+    pickware_erp_product_supplier_configuration: PickwareProductSupplierConfigurationRecord;
+    pickware_erp_return_order: PickwareReturnOrderRecord;
+    pickware_erp_return_order_line_item: PickwareReturnOrderLineItemRecord;
   }
 }
 //#endregion
@@ -34,19 +79,61 @@ interface PickwareWarehouseRow {
 }
 declare const PICKWARE_WAREHOUSES_KEY = "pickwareWarehouses";
 declare function pickwareWarehouses(extensions: Record<string, unknown>): PickwareWarehouseRow[];
+declare function warehouseIdByCode(extensions: Record<string, unknown>, code: string): string;
 declare const warehousesFetcher: ShopContextFetcher;
 //#endregion
 //#region src/helpers.d.ts
-interface StockMovementInInput {
-  productId: string;
-  warehouseId: string;
+declare const RETURN_ORDER_STATE_MACHINE = "pickware_erp_return_order.state";
+type PickwareReturnState = 'requested' | 'announced' | 'partially_received' | 'received' | 'completed' | 'cancelled' | 'declined';
+declare const RETURN_ORDER_INITIAL_STATE: PickwareReturnState;
+interface BinLocationInput {
+  $key?: string;
+  code: string;
+  warehouseCode: string;
+}
+declare function binLocation(input: BinLocationInput): PickwareBinLocationRecord;
+interface SupplierInput {
+  $key?: string;
+  number: string;
+  name: string;
+  customerNumber?: string;
+  languageId?: Id;
+}
+declare function supplier(input: SupplierInput): PickwareSupplierRecord;
+interface ProductSupplierConfigInput {
+  $key?: string;
+  productId: Id;
+  supplierId: Id;
+  purchasePrices: PickwarePrice[];
+  minPurchase?: number;
+  purchaseSteps?: number;
+  supplierIsDefault?: boolean;
+}
+declare function productSupplierConfig(input: ProductSupplierConfigInput): PickwareProductSupplierConfigurationRecord;
+interface ReturnLineInput {
+  name: string;
   quantity: number;
+  position?: number;
+  reason?: PickwareReturnReason;
+  price: object;
+  priceDefinition: object;
+  productId?: Id;
+  orderLineItemId?: Id;
+}
+interface ReturnOrderInput {
   $key?: string;
+  number: string;
+  orderId: Id;
+  price: object;
+  state?: PickwareReturnState;
+  internalComment?: string;
+  warehouseId?: Id;
+  lineItems: ReturnLineInput[];
 }
-declare function stockMovementIn(input: StockMovementInInput): PickwareStockMovementRecord;
+declare function returnOrder(input: ReturnOrderInput): PickwareReturnOrderRecord;
 //#endregion
 //#region src/plugin.d.ts
 declare function pickware(): FakewarePlugin;
 //#endregion
-export { PICKWARE_WAREHOUSES_KEY, type PickwareBinLocationRecord, type PickwareStockMovementRecord, type PickwareWarehouseRecord, type PickwareWarehouseRow, type StockMovementInInput, pickware, pickwareWarehouses, stockMovementIn, warehousesFetcher };
+export { type BinLocationInput, type Id, PICKWARE_LIVE_VERSION, PICKWARE_WAREHOUSES_KEY, type PickwareBinLocationRecord, type PickwarePrice, type PickwareProductSupplierConfigurationRecord, type PickwareReturnOrderLineItemRecord, type PickwareReturnOrderRecord, type PickwareReturnReason, type PickwareReturnState, type PickwareSupplierRecord, type PickwareWarehouseRow, type ProductSupplierConfigInput, RETURN_ORDER_INITIAL_STATE, RETURN_ORDER_STATE_MACHINE, type ReturnLineInput, type ReturnOrderInput, type SupplierInput, binLocation, pickware, pickwareWarehouses, productSupplierConfig, returnOrder, supplier, warehouseIdByCode, warehousesFetcher };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,27 +1,129 @@
-import { definePlugin } from "@fakeware/core";
+import { definePlugin, shop, shopToken } from "@fakeware/core";
+//#region src/entities.ts
+const PICKWARE_LIVE_VERSION = "0fa91ce3e96a4bc2be4bd9ce752c3425";
+//#endregion
 //#region src/fetchers.ts
 const PICKWARE_WAREHOUSES_KEY = "pickwareWarehouses";
+const SEARCH_OPERATION = "searchPickwareWarehouse post /search/pickware-erp-warehouse";
+const SEARCH_LIMIT = 500;
 function pickwareWarehouses(extensions) {
 	return extensions["pickwareWarehouses"] ?? [];
 }
+function warehouseIdByCode(extensions, code) {
+	const warehouses = pickwareWarehouses(extensions);
+	const wanted = code.trim().toLowerCase();
+	const match = warehouses.find((w) => w.code?.trim().toLowerCase() === wanted);
+	if (!match) {
+		const known = warehouses.map((w) => w.code).filter(Boolean).join(", ") || "(none)";
+		throw new Error(`pickware: no warehouse with code "${code}". Available warehouse codes: ${known}.`);
+	}
+	return match.id;
+}
+function rowsOf(raw) {
+	let value = raw;
+	while (value && typeof value === "object" && !Array.isArray(value) && "data" in value) value = value.data;
+	return Array.isArray(value) ? value : [];
+}
+function totalOf(raw) {
+	let value = raw;
+	while (value && typeof value === "object" && !Array.isArray(value)) {
+		const record = value;
+		if (typeof record.total === "number") return record.total;
+		if (!("data" in record)) break;
+		value = record.data;
+	}
+}
 const warehousesFetcher = {
 	entity: "pickware warehouses",
-	fetch: (client) => client.invoke("post /search/pickware-erp-warehouse", { body: { limit: 500 } }),
+	fetch: async (client) => {
+		const invoke = client.invoke;
+		const collected = [];
+		let page = 1;
+		for (;;) {
+			const raw = await invoke(SEARCH_OPERATION, { body: {
+				page,
+				limit: SEARCH_LIMIT,
+				"total-count-mode": 1
+			} });
+			const pageRows = rowsOf(raw);
+			collected.push(...pageRows);
+			const total = totalOf(raw);
+			if (pageRows.length === 0) break;
+			if (total !== void 0 && collected.length >= total) break;
+			if (total === void 0 && pageRows.length < SEARCH_LIMIT) break;
+			page += 1;
+		}
+		return { data: collected };
+	},
 	merge: (data, raw) => {
-		const rows = raw?.data ?? [];
-		data.extensions[PICKWARE_WAREHOUSES_KEY] = rows;
+		data.extensions[PICKWARE_WAREHOUSES_KEY] = rowsOf(raw);
 	}
 };
 //#endregion
 //#region src/helpers.ts
-function stockMovementIn(input) {
-	if (!Number.isFinite(input.quantity) || input.quantity <= 0) throw new Error(`stockMovementIn: quantity must be a positive number, got ${input.quantity}.`);
-	return {
-		...input.$key ? { $key: input.$key } : {},
+const RETURN_ORDER_STATE_MACHINE = "pickware_erp_return_order.state";
+const RETURN_ORDER_INITIAL_STATE = "requested";
+function pruneUndefined(record) {
+	for (const key of Object.keys(record)) if (record[key] === void 0) delete record[key];
+	return record;
+}
+function binLocation(input) {
+	return pruneUndefined({
+		$key: input.$key,
+		code: input.code,
+		warehouseId: shopToken(`pickwareWarehouse:${input.warehouseCode}`, (s) => warehouseIdByCode(s.extensions, input.warehouseCode))
+	});
+}
+function supplier(input) {
+	return pruneUndefined({
+		$key: input.$key,
+		number: input.number,
+		name: input.name,
+		customerNumber: input.customerNumber,
+		languageId: input.languageId ?? shop.defaultLanguage
+	});
+}
+function productSupplierConfig(input) {
+	return pruneUndefined({
+		$key: input.$key,
 		productId: input.productId,
-		quantity: input.quantity,
-		destinationWarehouseId: input.warehouseId
-	};
+		productVersionId: PICKWARE_LIVE_VERSION,
+		supplierId: input.supplierId,
+		minPurchase: input.minPurchase ?? 1,
+		purchaseSteps: input.purchaseSteps ?? 1,
+		purchasePrices: input.purchasePrices,
+		supplierIsDefault: input.supplierIsDefault ?? true
+	});
+}
+function returnLine(line, index) {
+	return pruneUndefined({
+		versionId: PICKWARE_LIVE_VERSION,
+		type: "product",
+		name: line.name,
+		quantity: line.quantity,
+		position: line.position ?? index + 1,
+		reason: line.reason ?? "other",
+		priceDefinition: line.priceDefinition,
+		price: line.price,
+		productId: line.productId,
+		productVersionId: line.productId ? PICKWARE_LIVE_VERSION : void 0,
+		orderLineItemId: line.orderLineItemId,
+		orderLineItemVersionId: line.orderLineItemId ? PICKWARE_LIVE_VERSION : void 0
+	});
+}
+function returnOrder(input) {
+	return pruneUndefined({
+		$key: input.$key,
+		versionId: PICKWARE_LIVE_VERSION,
+		number: input.number,
+		stateId: shop.stateMachineState(RETURN_ORDER_STATE_MACHINE, input.state ?? "requested"),
+		orderId: input.orderId,
+		orderVersionId: PICKWARE_LIVE_VERSION,
+		price: input.price,
+		internalComment: input.internalComment,
+		warehouseId: input.warehouseId,
+		lineItems: input.lineItems.map(returnLine)
+	});
 }
 //#endregion
 //#region src/plugin.ts
@@ -32,6 +134,6 @@ function pickware() {
 	});
 }
 //#endregion
-export { PICKWARE_WAREHOUSES_KEY, pickware, pickwareWarehouses, stockMovementIn, warehousesFetcher };
+export { PICKWARE_LIVE_VERSION, PICKWARE_WAREHOUSES_KEY, RETURN_ORDER_INITIAL_STATE, RETURN_ORDER_STATE_MACHINE, binLocation, pickware, pickwareWarehouses, productSupplierConfig, returnOrder, supplier, warehouseIdByCode, warehousesFetcher };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/fetchers.ts","../src/helpers.ts","../src/plugin.ts"],"sourcesContent":["import type { ShopContextFetcher } from '@fakeware/core'\n\nexport interface PickwareWarehouseRow {\n  id: string\n  name?: string\n  code?: string\n  [key: string]: unknown\n}\n\nexport const PICKWARE_WAREHOUSES_KEY = 'pickwareWarehouses'\n\nexport function pickwareWarehouses(extensions: Record<string, unknown>): PickwareWarehouseRow[] {\n  return (extensions[PICKWARE_WAREHOUSES_KEY] as PickwareWarehouseRow[] | undefined) ?? []\n}\n\nexport const warehousesFetcher: ShopContextFetcher = {\n  entity: 'pickware warehouses',\n  fetch: (client) =>\n    (client.invoke as (path: string, params: unknown) => Promise<unknown>)(\n      'post /search/pickware-erp-warehouse',\n      { body: { limit: 500 } },\n    ),\n  merge: (data, raw) => {\n    const rows = (raw as { data?: PickwareWarehouseRow[] } | null)?.data ?? []\n    data.extensions[PICKWARE_WAREHOUSES_KEY] = rows\n  },\n}\n","import type { PickwareStockMovementRecord } from './entities'\n\nexport interface StockMovementInInput {\n  productId: string\n  warehouseId: string\n  quantity: number\n  $key?: string\n}\n\nexport function stockMovementIn(input: StockMovementInInput): PickwareStockMovementRecord {\n  if (!Number.isFinite(input.quantity) || input.quantity <= 0) {\n    throw new Error(`stockMovementIn: quantity must be a positive number, got ${input.quantity}.`)\n  }\n  return {\n    ...(input.$key ? { $key: input.$key } : {}),\n    productId: input.productId,\n    quantity: input.quantity,\n    destinationWarehouseId: input.warehouseId,\n  }\n}\n","import { definePlugin, type FakewarePlugin } from '@fakeware/core'\nimport { warehousesFetcher } from './fetchers'\n\nexport function pickware(): FakewarePlugin {\n  return definePlugin({\n    name: 'pickware',\n    fetchers: [warehousesFetcher],\n  })\n}\n"],"mappings":";;AASA,MAAa,0BAA0B;AAEvC,SAAgB,mBAAmB,YAA6D;CAC9F,OAAQ,WAAA,yBAA8E,CAAC;AACzF;AAEA,MAAa,oBAAwC;CACnD,QAAQ;CACR,QAAQ,WACL,OAAO,OACN,uCACA,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE,CACzB;CACF,QAAQ,MAAM,QAAQ;EACpB,MAAM,OAAQ,KAAkD,QAAQ,CAAC;EACzE,KAAK,WAAW,2BAA2B;CAC7C;AACF;;;ACjBA,SAAgB,gBAAgB,OAA0D;CACxF,IAAI,CAAC,OAAO,SAAS,MAAM,QAAQ,KAAK,MAAM,YAAY,GACxD,MAAM,IAAI,MAAM,4DAA4D,MAAM,SAAS,EAAE;CAE/F,OAAO;EACL,GAAI,MAAM,OAAO,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;EACzC,WAAW,MAAM;EACjB,UAAU,MAAM;EAChB,wBAAwB,MAAM;CAChC;AACF;;;AChBA,SAAgB,WAA2B;CACzC,OAAO,aAAa;EAClB,MAAM;EACN,UAAU,CAAC,iBAAiB;CAC9B,CAAC;AACH"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/entities.ts","../src/fetchers.ts","../src/helpers.ts","../src/plugin.ts"],"sourcesContent":["import type { AnyToken } from '@fakeware/core'\n\nexport const PICKWARE_LIVE_VERSION = '0fa91ce3e96a4bc2be4bd9ce752c3425'\n\nexport type Id = string | AnyToken\n\nexport interface PickwareBinLocationRecord {\n  $key?: string\n  code: string\n  warehouseId: Id\n}\n\nexport interface PickwareSupplierRecord {\n  $key?: string\n  number: string\n  name: string\n  languageId: Id\n  customerNumber?: string\n}\n\nexport interface PickwarePrice {\n  currencyId: Id\n  gross: number\n  net: number\n  linked: boolean\n}\n\nexport interface PickwareProductSupplierConfigurationRecord {\n  $key?: string\n  productId: Id\n  productVersionId?: string\n  supplierId: Id\n  minPurchase: number\n  purchaseSteps: number\n  purchasePrices: PickwarePrice[]\n  supplierIsDefault: boolean\n}\n\nexport type PickwareReturnReason = 'wrong_item' | 'defective' | 'other'\n\nexport interface PickwareReturnOrderLineItemRecord {\n  $key?: string\n  versionId?: string\n  type?: string\n  name: string\n  quantity: number\n  position: number\n  reason: PickwareReturnReason\n  priceDefinition: object\n  price: object\n  productId?: Id\n  productVersionId?: string\n  orderLineItemId?: Id\n  orderLineItemVersionId?: string\n}\n\nexport interface PickwareReturnOrderRecord {\n  $key?: string\n  versionId?: string\n  number: string\n  stateId?: Id\n  orderId: Id\n  orderVersionId?: string\n  price: object\n  shippingCosts?: object\n  internalComment?: string\n  warehouseId?: Id\n  lineItems: PickwareReturnOrderLineItemRecord[]\n}\n\ndeclare module '@fakeware/core' {\n  interface EntityRegistry {\n    pickware_erp_bin_location: PickwareBinLocationRecord\n    pickware_erp_supplier: PickwareSupplierRecord\n    pickware_erp_product_supplier_configuration: PickwareProductSupplierConfigurationRecord\n    pickware_erp_return_order: PickwareReturnOrderRecord\n    pickware_erp_return_order_line_item: PickwareReturnOrderLineItemRecord\n  }\n}\n","import type { ShopContextFetcher } from '@fakeware/core'\n\nexport interface PickwareWarehouseRow {\n  id: string\n  name?: string\n  code?: string\n  [key: string]: unknown\n}\n\nexport const PICKWARE_WAREHOUSES_KEY = 'pickwareWarehouses'\n\nconst SEARCH_OPERATION = 'searchPickwareWarehouse post /search/pickware-erp-warehouse'\nconst SEARCH_LIMIT = 500\n\nexport function pickwareWarehouses(extensions: Record<string, unknown>): PickwareWarehouseRow[] {\n  return (extensions[PICKWARE_WAREHOUSES_KEY] as PickwareWarehouseRow[] | undefined) ?? []\n}\n\nexport function warehouseIdByCode(extensions: Record<string, unknown>, code: string): string {\n  const warehouses = pickwareWarehouses(extensions)\n  const wanted = code.trim().toLowerCase()\n  const match = warehouses.find((w) => w.code?.trim().toLowerCase() === wanted)\n  if (!match) {\n    const known =\n      warehouses\n        .map((w) => w.code)\n        .filter(Boolean)\n        .join(', ') || '(none)'\n    throw new Error(\n      `pickware: no warehouse with code \"${code}\". Available warehouse codes: ${known}.`,\n    )\n  }\n  return match.id\n}\n\nfunction rowsOf(raw: unknown): unknown[] {\n  let value = raw\n  while (value && typeof value === 'object' && !Array.isArray(value) && 'data' in value) {\n    value = (value as { data?: unknown }).data\n  }\n  return Array.isArray(value) ? value : []\n}\n\nfunction totalOf(raw: unknown): number | undefined {\n  let value = raw\n  while (value && typeof value === 'object' && !Array.isArray(value)) {\n    const record = value as { total?: unknown; data?: unknown }\n    if (typeof record.total === 'number') return record.total\n    if (!('data' in record)) break\n    value = record.data\n  }\n  return undefined\n}\n\ntype Invoke = (operation: string, options: { body: Record<string, unknown> }) => Promise<unknown>\n\nexport const warehousesFetcher: ShopContextFetcher = {\n  entity: 'pickware warehouses',\n  fetch: async (client) => {\n    const invoke = client.invoke as unknown as Invoke\n    const collected: unknown[] = []\n    let page = 1\n    for (;;) {\n      const raw = await invoke(SEARCH_OPERATION, {\n        body: { page, limit: SEARCH_LIMIT, 'total-count-mode': 1 },\n      })\n      const pageRows = rowsOf(raw)\n      collected.push(...pageRows)\n      const total = totalOf(raw)\n      if (pageRows.length === 0) break\n      if (total !== undefined && collected.length >= total) break\n      if (total === undefined && pageRows.length < SEARCH_LIMIT) break\n      page += 1\n    }\n    return { data: collected }\n  },\n  merge: (data, raw) => {\n    data.extensions[PICKWARE_WAREHOUSES_KEY] = rowsOf(raw) as PickwareWarehouseRow[]\n  },\n}\n","import { shop, shopToken } from '@fakeware/core'\nimport {\n  type Id,\n  PICKWARE_LIVE_VERSION,\n  type PickwareBinLocationRecord,\n  type PickwarePrice,\n  type PickwareProductSupplierConfigurationRecord,\n  type PickwareReturnOrderLineItemRecord,\n  type PickwareReturnOrderRecord,\n  type PickwareReturnReason,\n  type PickwareSupplierRecord,\n} from './entities'\nimport { warehouseIdByCode } from './fetchers'\n\nexport const RETURN_ORDER_STATE_MACHINE = 'pickware_erp_return_order.state'\n\nexport type PickwareReturnState =\n  | 'requested'\n  | 'announced'\n  | 'partially_received'\n  | 'received'\n  | 'completed'\n  | 'cancelled'\n  | 'declined'\n\nexport const RETURN_ORDER_INITIAL_STATE: PickwareReturnState = 'requested'\n\nfunction pruneUndefined<T extends Record<string, unknown>>(record: T): T {\n  for (const key of Object.keys(record)) {\n    if (record[key] === undefined) delete record[key]\n  }\n  return record\n}\n\nexport interface BinLocationInput {\n  $key?: string\n  code: string\n  warehouseCode: string\n}\n\nexport function binLocation(input: BinLocationInput): PickwareBinLocationRecord {\n  return pruneUndefined({\n    $key: input.$key,\n    code: input.code,\n    warehouseId: shopToken(`pickwareWarehouse:${input.warehouseCode}`, (s) =>\n      warehouseIdByCode(s.extensions, input.warehouseCode),\n    ),\n  })\n}\n\nexport interface SupplierInput {\n  $key?: string\n  number: string\n  name: string\n  customerNumber?: string\n  languageId?: Id\n}\n\nexport function supplier(input: SupplierInput): PickwareSupplierRecord {\n  return pruneUndefined({\n    $key: input.$key,\n    number: input.number,\n    name: input.name,\n    customerNumber: input.customerNumber,\n    languageId: input.languageId ?? shop.defaultLanguage,\n  })\n}\n\nexport interface ProductSupplierConfigInput {\n  $key?: string\n  productId: Id\n  supplierId: Id\n  purchasePrices: PickwarePrice[]\n  minPurchase?: number\n  purchaseSteps?: number\n  supplierIsDefault?: boolean\n}\n\nexport function productSupplierConfig(\n  input: ProductSupplierConfigInput,\n): PickwareProductSupplierConfigurationRecord {\n  return pruneUndefined({\n    $key: input.$key,\n    productId: input.productId,\n    productVersionId: PICKWARE_LIVE_VERSION,\n    supplierId: input.supplierId,\n    minPurchase: input.minPurchase ?? 1,\n    purchaseSteps: input.purchaseSteps ?? 1,\n    purchasePrices: input.purchasePrices,\n    supplierIsDefault: input.supplierIsDefault ?? true,\n  })\n}\n\nexport interface ReturnLineInput {\n  name: string\n  quantity: number\n  position?: number\n  reason?: PickwareReturnReason\n  price: object\n  priceDefinition: object\n  productId?: Id\n  orderLineItemId?: Id\n}\n\nexport interface ReturnOrderInput {\n  $key?: string\n  number: string\n  orderId: Id\n  price: object\n  state?: PickwareReturnState\n  internalComment?: string\n  warehouseId?: Id\n  lineItems: ReturnLineInput[]\n}\n\nfunction returnLine(line: ReturnLineInput, index: number): PickwareReturnOrderLineItemRecord {\n  return pruneUndefined({\n    versionId: PICKWARE_LIVE_VERSION,\n    type: 'product',\n    name: line.name,\n    quantity: line.quantity,\n    position: line.position ?? index + 1,\n    reason: line.reason ?? 'other',\n    priceDefinition: line.priceDefinition,\n    price: line.price,\n    productId: line.productId,\n    productVersionId: line.productId ? PICKWARE_LIVE_VERSION : undefined,\n    orderLineItemId: line.orderLineItemId,\n    orderLineItemVersionId: line.orderLineItemId ? PICKWARE_LIVE_VERSION : undefined,\n  })\n}\n\nexport function returnOrder(input: ReturnOrderInput): PickwareReturnOrderRecord {\n  return pruneUndefined({\n    $key: input.$key,\n    versionId: PICKWARE_LIVE_VERSION,\n    number: input.number,\n    stateId: shop.stateMachineState(\n      RETURN_ORDER_STATE_MACHINE,\n      input.state ?? RETURN_ORDER_INITIAL_STATE,\n    ),\n    orderId: input.orderId,\n    orderVersionId: PICKWARE_LIVE_VERSION,\n    price: input.price,\n    internalComment: input.internalComment,\n    warehouseId: input.warehouseId,\n    lineItems: input.lineItems.map(returnLine),\n  })\n}\n","import { definePlugin, type FakewarePlugin } from '@fakeware/core'\nimport { warehousesFetcher } from './fetchers'\n\nexport function pickware(): FakewarePlugin {\n  return definePlugin({\n    name: 'pickware',\n    fetchers: [warehousesFetcher],\n  })\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fakeware/plugin-pickware",
-  "version": "0.0.1",
-  "description": "Pickware ERP plugin for fakeware. Seed warehouses, bin locations and stock into a Shopware 6 shop running Pickware",
+  "version": "1.1.0",
+  "description": "Pickware ERP plugin for fakeware. Seed bin locations, suppliers, product-supplier configurations and return orders into a Shopware 6 shop running Pickware",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -46,10 +46,10 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.16",
-    "@fakeware/core": "0.0.9",
+    "@fakeware/core": "^0.0.10",
     "@types/bun": "1.3.14",
     "publint": "0.3.21",
-    "tsdown": "^0.22.2",
+    "tsdown": "^0.22.3",
     "typescript": "^6.0.3"
   }
 }