@kosdev-code/kos-dispense-sdk 3.0.19 → 3.0.21

package/models/utils/services/kos.ext.dispense/daily/service.d.ts

@@ -0,0 +1,180 @@
+import { ClientResponse, HttpMethod, IKosServiceRequestParams, KosExecutionContext, PathsByMethod } from '@kosdev-code/kos-ui-sdk';
+import { paths } from './openapi';
+/**
+ * Type aliases for kos.ext.dispense API
+ */
+export type Api = paths;
+export type ApiPath = keyof paths;
+export type ValidPaths = PathsByMethod<paths>;
+/**
+ * Methods a response type can be derived for — the lowercase subset of
+ * HttpMethod. The uppercase spellings HttpMethod also permits do not match the
+ * keys of an OpenAPI `paths` object, so they would silently yield `unknown`.
+ */
+export type SupportedMethod = "get" | "post" | "put" | "delete" | "patch";
+/**
+ * Get client response type for kos.ext.dispense API
+ */
+export type ApiResponse<Path extends ApiPath, Method extends SupportedMethod = "get"> = ClientResponse<paths, Path, Method>;
+/**
+ * Get execution context type for kos.ext.dispense API
+ */
+export type ExecutionContext<Path extends ApiPath = ApiPath, Method extends HttpMethod = "get", Transformed = ApiResponse<Path, SupportedMethod & Method>> = KosExecutionContext<paths, Path, Method, Transformed>;
+/**
+ * Typed decorator factory for @kosServiceRequest with kos.ext.dispense API types
+ *
+ * Provides full IntelliSense and type safety for path, query params, and body
+ * based on the kos.ext.dispense OpenAPI schema.
+ *
+ * @example
+ * ```typescript
+ * import { kosServiceRequest } from '../../utils/services/kos.ext.dispense/daily/service';
+ * import { DependencyLifecycle } from '@kosdev-code/kos-ui-sdk';
+ *
+ * @kosServiceRequest({
+ *   path: '/api/...',
+ *   method: 'get',
+ *   lifecycle: DependencyLifecycle.LOAD
+ * })
+ * private onDataLoaded(): void {
+ *   // Fully typed based on kos.ext.dispense API
+ * }
+ * ```
+ */
+export declare function kosServiceRequest<Path extends ApiPath, Method extends HttpMethod = "get", Response = any, TransformedResponse = Response>(params: IKosServiceRequestParams<paths, Path, Method, Response, TransformedResponse>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * One endpoint of the kos.ext.dispense API: a path and the method it is called with.
+ */
+export interface Endpoint {
+    path: ApiPath;
+    method: SupportedMethod;
+}
+/**
+ * Declare an endpoint once. The decorator config, the execution context type
+ * and the response type are all derived from the result, so a path string is
+ * never restated — and never drifts between the three.
+ *
+ * @example
+ * ```typescript
+ * export const BoardApi = {
+ *   list: endpoint("/api/board", "get"),
+ *   update: endpoint("/api/board/{id}", "put"),
+ * } as const;
+ * ```
+ */
+export declare function endpoint<Path extends ApiPath, Method extends SupportedMethod>(path: Path, method: Method): {
+    readonly path: Path;
+    readonly method: Method;
+};
+/**
+ * Execution context for an endpoint — the method-driven `$ctx` parameter type.
+ * Pass `Transformed` when the decorator declares a `transform`, so what the
+ * method receives is typed as the mapper's output rather than the raw response.
+ */
+export type EndpointCtx<E extends Endpoint, Transformed = EndpointResponse<E>> = ExecutionContext<E["path"], E["method"], Transformed>;
+/** Response body type for an endpoint. */
+export type EndpointResponse<E extends Endpoint> = ApiResponse<E["path"], E["method"]>;
+/**
+ * @kosServiceRequest preconfigured from an endpoint descriptor, defaulting to
+ * log-and-continue error handling. Pass overrides (lifecycle, errorHandler,
+ * cache, …) as the second argument.
+ *
+ * A `transform` narrows what the model receives: its return type becomes the
+ * handler's data type, so the raw response shape stops at the mapper.
+ *
+ * @example
+ * ```typescript
+ * @serviceRequest(BoardApi.update)
+ * async renameBoard(name: string, $ctx?: EndpointCtx<typeof BoardApi.update>) {
+ *   const data = await executeServiceRequest(this, $ctx, {
+ *     pathParams: { id: this.id },
+ *     body: { name },
+ *   });
+ *   if (!data) return;
+ * }
+ * ```
+ */
+export declare function serviceRequest<E extends Endpoint, Transformed = EndpointResponse<E>>(ep: E, opts?: Partial<IKosServiceRequestParams<paths, E["path"], E["method"], EndpointResponse<E>, Transformed>>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Create an API client for kos.ext.dispense
+ */
+export declare const api: {
+    get: <K extends "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/select" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/availability" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/availability/groups/{group}" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/graph/node/{id}" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/graph/beverages" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/graph/nodes" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/ingredient/intent/{path}/{intent}" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/ingredient/intent/{path}/{intent}/volume" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/ingredient/intent/{path}/{intent}/time" | "/api/ext/kos.ext.dispense/soldOuts/troubles" | "/api/ext/kos.ext.dispense/soldOuts/db" | "/api/ext/kos.ext.dispense/ingredients" | "/api/ext/kos.ext.dispense/ingredients/sources" | "/api/ext/kos.ext.dispense/insertion/filters" | "/api/ext/kos.ext.dispense/metrics" | "/api/ext/kos.ext.dispense/metrics/names" | "/api/ext/kos.ext.dispense/metrics/{name}" | "/api/ext/kos.ext.dispense/metrics/{nozzle}/names" | "/api/ext/kos.ext.dispense/metrics/{nozzle}/{name}" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/engine/nutrition/{bevId}" | "/api/ext/kos.ext.dispense/assignments">(endpoint: K, params?: (paths[K]["get"] extends {
+        parameters: infer P;
+    } ? P : never) | undefined, options?: {
+        ordered?: boolean | undefined;
+        tracker?: string | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
+        headers?: Record<string, string> | undefined;
+        signal?: AbortSignal | undefined;
+        studio?: boolean | undefined;
+        fos?: boolean | undefined;
+        timeout?: number | undefined;
+        stream?: boolean | undefined;
+        responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
+        retry?: (boolean | import('@kosdev-code/kos-ui-sdk').RetryConfig) | undefined;
+    }) => Promise<import('@kosdev-code/kos-ui-sdk').ServiceResponse<ClientResponse<paths, K, "get">>>;
+    post: <K extends "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/select" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/stop" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/stop/{reason}" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/pour" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/pour/sequence" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/pour/selected/volume/{volume}" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/pour/selected/namedVolume/{name}" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/pour/selected/maxVolume" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/fixed/{name}" | "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/ingredient/pour/{path}/{intent}" | "/api/ext/kos.ext.dispense/soldOuts/container/{pump}/{reason}" | "/api/ext/kos.ext.dispense/soldOuts/slice/{pump}/{reason}" | "/api/ext/kos.ext.dispense/pumpBlocks/bev/{pump}" | "/api/ext/kos.ext.dispense/pumpBlocks/ing/{pump}" | "/api/ext/kos.ext.dispense/metrics/{name}" | "/api/ext/kos.ext.dispense/metrics/{nozzle}/{name}" | "/api/ext/kos.ext.dispense/pumpEvents/replaceLine/{holder}" | "/api/ext/kos.ext.dispense/pumpEvents/replacePump/{pump}" | "/api/ext/kos.ext.dispense/assignments">(endpoint: K, params?: (paths[K]["post"] extends {
+        parameters: infer P;
+    } ? P : never) | undefined, body?: (paths[K]["post"] extends {
+        requestBody: {
+            content: infer B;
+        };
+    } ? B[keyof B] : never) | undefined, options?: {
+        ordered?: boolean | undefined;
+        tracker?: string | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
+        headers?: Record<string, string> | undefined;
+        signal?: AbortSignal | undefined;
+        studio?: boolean | undefined;
+        fos?: boolean | undefined;
+        timeout?: number | undefined;
+        stream?: boolean | undefined;
+        responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
+        retry?: (boolean | import('@kosdev-code/kos-ui-sdk').RetryConfig) | undefined;
+    }) => Promise<import('@kosdev-code/kos-ui-sdk').ServiceResponse<ClientResponse<paths, K, "post">>>;
+    put: <K extends never>(endpoint: K, params?: (paths[K]["put"] extends {
+        parameters: infer P;
+    } ? P : never) | undefined, body?: (paths[K]["put"] extends {
+        requestBody: {
+            content: infer B;
+        };
+    } ? B[keyof B] : never) | undefined, options?: {
+        ordered?: boolean | undefined;
+        tracker?: string | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
+        headers?: Record<string, string> | undefined;
+        signal?: AbortSignal | undefined;
+        studio?: boolean | undefined;
+        fos?: boolean | undefined;
+        timeout?: number | undefined;
+        stream?: boolean | undefined;
+        responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
+        retry?: (boolean | import('@kosdev-code/kos-ui-sdk').RetryConfig) | undefined;
+    }) => Promise<import('@kosdev-code/kos-ui-sdk').ServiceResponse<ClientResponse<paths, K, "put">>>;
+    delete: <K extends "/api/ext/kos.ext.dispense/nozzle/nozzle/pipeline/beverage/select" | "/api/ext/kos.ext.dispense/pumpBlocks/bev/{pump}" | "/api/ext/kos.ext.dispense/pumpBlocks/ing/{pump}" | "/api/ext/kos.ext.dispense/metrics/{name}" | "/api/ext/kos.ext.dispense/metrics/{nozzle}/{name}" | "/api/ext/kos.ext.dispense/assignments/{holderPath}">(endpoint: K, params?: (paths[K]["delete"] extends {
+        parameters: infer P;
+    } ? P : never) | undefined, body?: (paths[K]["put"] extends {
+        requestBody: {
+            content: infer B;
+        };
+    } ? B[keyof B] : never) | undefined, options?: {
+        ordered?: boolean | undefined;
+        tracker?: string | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
+        headers?: Record<string, string> | undefined;
+        signal?: AbortSignal | undefined;
+        studio?: boolean | undefined;
+        fos?: boolean | undefined;
+        timeout?: number | undefined;
+        stream?: boolean | undefined;
+        responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
+        retry?: (boolean | import('@kosdev-code/kos-ui-sdk').RetryConfig) | undefined;
+    }) => Promise<import('@kosdev-code/kos-ui-sdk').ServiceResponse<ClientResponse<paths, K, "delete">>>;
+};
+export default api;
+//# sourceMappingURL=service.d.ts.map

package/models/utils/services/kos.ext.dispense/daily/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/kos-dispense-sdk/src/models/utils/services/kos.ext.dispense/daily/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC;AACxB,MAAM,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC;AAClC,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,WAAW,CACrB,IAAI,SAAS,OAAO,EACpB,MAAM,SAAS,eAAe,GAAG,KAAK,IACpC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAC1B,IAAI,SAAS,OAAO,GAAG,OAAO,EAC9B,MAAM,SAAS,UAAU,GAAG,KAAK,EACjC,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,IACvD,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,SAAS,OAAO,EACpB,MAAM,SAAS,UAAU,GAAG,KAAK,EACjC,QAAQ,GAAG,GAAG,EACd,mBAAmB,GAAG,QAAQ,EAE9B,MAAM,EAAE,wBAAwB,CAC9B,KAAK,EACL,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,mBAAmB,CACpB,4FASF;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,SAAS,OAAO,EAAE,MAAM,SAAS,eAAe,EAC3E,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM;;;EAGf;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,CACrB,CAAC,SAAS,QAAQ,EAClB,WAAW,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAC/B,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;AAE1D,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,QAAQ,IAAI,WAAW,CAC5D,CAAC,CAAC,MAAM,CAAC,EACT,CAAC,CAAC,QAAQ,CAAC,CACZ,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,CAAC,SAAS,QAAQ,EAClB,WAAW,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAEjC,EAAE,EAAE,CAAC,EACL,IAAI,CAAC,EAAE,OAAO,CACZ,wBAAwB,CACtB,KAAK,EACL,CAAC,CAAC,MAAM,CAAC,EACT,CAAC,CAAC,QAAQ,CAAC,EACX,gBAAgB,CAAC,CAAC,CAAC,EACnB,WAAW,CACZ,CACF,4FAaF;AAED;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAwB,CAAC;AAEzC,eAAe,GAAG,CAAC"}

package/models/utils/services-index.d.ts

@@ -1,4 +1,4 @@
+export * as DISPENSE_SERVICE from './services/kos.ext.dispense/daily/service';
 export * as DISPENSE_SERVICE_1_6_5 from './services/dispense/1.6.5/service';
 export * as DISPENSE_SERVICE_1_8_1 from './services/dispense/1.8.1/service';
-export * as DISPENSE_SERVICE from './services/dispense/daily/service';
 //# sourceMappingURL=services-index.d.ts.map

package/models/utils/services-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services-index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-dispense-sdk/src/models/utils/services-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,sBAAsB,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,sBAAsB,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,gBAAgB,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"services-index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-dispense-sdk/src/models/utils/services-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,gBAAgB,MAAM,2CAA2C,CAAC;AAC9E,OAAO,KAAK,sBAAsB,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,sBAAsB,MAAM,mCAAmC,CAAC"}

package/models.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const dispenseRegistrationManager = require("./dispense-registration-manager-Dtb31fcI.cjs");
-const extensionUtils = require("./extension-utils-CwctwFhK.cjs");
+const dispenseRegistrationManager = require("./dispense-registration-manager-D4Gn04LB.cjs");
+const extensionUtils = require("./extension-utils-CBfTBxbG.cjs");
 exports.Assembly = dispenseRegistrationManager.Assembly;
 exports.Availability = dispenseRegistrationManager.Availability;
 exports.Board = dispenseRegistrationManager.Board;

package/models.js

@@ -1,5 +1,5 @@
-import { A, a, B, b, c, C, d, D, e, E, G, H, f, I, g, K, N, P, h, i, j, T, k, l, m, n, o, r } from "./dispense-registration-manager-Da9CW_cN.js";
-import { i as i2, a as a2, D as D2, b as b2, c as c2, d as d2, K as K2, e as e2, f as f2, g as g2 } from "./extension-utils-C_pwmFbZ.js";
+import { A, a, B, b, c, C, d, D, e, E, G, H, f, I, g, K, N, P, h, i, j, T, k, l, m, n, o, r } from "./dispense-registration-manager-RsMBDeiI.js";
+import { i as i2, a as a2, D as D2, b as b2, c as c2, d as d2, K as K2, e as e2, f as f2, g as g2 } from "./extension-utils-tiVf_hXX.js";
 export {
   A as Assembly,
   i2 as AssemblyServices,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-dispense-sdk",
-  "version": "3.0.19",
+  "version": "3.0.21",
   "type": "module",
   "types": "./index.d.ts",
   "main": "./index.js",
@@ -46,7 +46,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "442efeac4f5ebe09b50bc6dfa13190bc3799fbbe"
+      "gitHash": "a5481c29ff5f1e4f0c89ed967aea9b0f0b9ee171"
     }
   }
 }

package/{pump-provider-CAKW652V.js → pump-provider-BlScBYrQ.js}

@@ -1,6 +1,6 @@
 import { jsx } from "@emotion/react/jsx-runtime";
 import { useKosModel, getKosCompanionModel, kosAutoEffect, KosLog, usePressGesture, EventBus, TimerManager } from "@kosdev-code/kos-ui-sdk";
-import { A as Assembly$1, a as Availability$1, B as Board$1, b as BoardContainer$1, N as Nozzle$1, D as DeviceAssembly, H as Holder$1, f as HolderContainer$1, I as Ingredient$1, g as IngredientContainer$1, G as GenericPour, h as Pump$1 } from "./dispense-registration-manager-Da9CW_cN.js";
+import { A as Assembly$1, a as Availability$1, B as Board$1, b as BoardContainer$1, N as Nozzle$1, D as DeviceAssembly, H as Holder$1, f as HolderContainer$1, I as Ingredient$1, g as IngredientContainer$1, G as GenericPour, h as Pump$1 } from "./dispense-registration-manager-RsMBDeiI.js";
 import React, { createContext, useMemo, useContext, useState, useCallback, useEffect, useRef } from "react";
 const useAssembly = () => {
   const modelId = Assembly$1.type;
@@ -1801,4 +1801,4 @@ export {
   useCuiKit as y,
   useCuiKitTimers as z
 };
-//# sourceMappingURL=pump-provider-CAKW652V.js.map
+//# sourceMappingURL=pump-provider-BlScBYrQ.js.map