@kosdev-code/kos-freestyle-sdk 3.0.21 → 3.0.23

package/models/utils/services/{kos.ext.freestyle → freestyle}/daily/service.d.ts

@@ -1,7 +1,7 @@
 import { ClientResponse, HttpMethod, IKosServiceRequestParams, KosExecutionContext, PathsByMethod } from '@kosdev-code/kos-ui-sdk';
 import { paths } from './openapi';
 /**
- * Type aliases for kos.ext.freestyle API
+ * Type aliases for freestyle API
  */
 export type Api = paths;
 export type ApiPath = keyof paths;
@@ -13,22 +13,22 @@ export type ValidPaths = PathsByMethod<paths>;
  */
 export type SupportedMethod = "get" | "post" | "put" | "delete" | "patch";
 /**
- * Get client response type for kos.ext.freestyle API
+ * Get client response type for freestyle API
  */
 export type ApiResponse<Path extends ApiPath, Method extends SupportedMethod = "get"> = ClientResponse<paths, Path, Method>;
 /**
- * Get execution context type for kos.ext.freestyle API
+ * Get execution context type for freestyle 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.freestyle API types
+ * Typed decorator factory for @kosServiceRequest with freestyle API types
  *
  * Provides full IntelliSense and type safety for path, query params, and body
- * based on the kos.ext.freestyle OpenAPI schema.
+ * based on the freestyle OpenAPI schema.
  *
  * @example
  * ```typescript
- * import { kosServiceRequest } from '../../utils/services/kos.ext.freestyle/daily/service';
+ * import { kosServiceRequest } from '../../utils/services/freestyle/daily/service';
  * import { DependencyLifecycle } from '@kosdev-code/kos-ui-sdk';
  *
  * @kosServiceRequest({
@@ -37,13 +37,13 @@ export type ExecutionContext<Path extends ApiPath = ApiPath, Method extends Http
  *   lifecycle: DependencyLifecycle.LOAD
  * })
  * private onDataLoaded(): void {
- *   // Fully typed based on kos.ext.freestyle API
+ *   // Fully typed based on freestyle 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.freestyle API: a path and the method it is called with.
+ * One endpoint of the freestyle API: a path and the method it is called with.
  */
 export interface Endpoint {
     path: ApiPath;
@@ -96,10 +96,42 @@ export type EndpointResponse<E extends Endpoint> = ApiResponse<E["path"], E["met
  */
 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.freestyle
+ * `serviceRequest` for an endpoint the generated types do not declare yet.
+ *
+ * There is no `paths` entry to derive anything from, so the response shape is
+ * supplied by hand instead: `Raw` is what the backend is expected to serve (the
+ * UNWRAPPED `data` payload — the client strips the `{status, data}` envelope
+ * before `transform` runs) and `Transformed` is what `transform` returns. Path
+ * and query params are untyped for the same reason.
+ *
+ * Every use is a debt, and the name is there to be grepped. When the endpoint
+ * lands: re-run `api:generate`, drop the `as ApiPath` cast on its `endpoint(...)`
+ * entry, point the raw type at `EndpointResponse<...>`, and switch back to
+ * `serviceRequest`. The transform survives all of it unchanged.
+ *
+ * @example
+ * ```typescript
+ * export const BoardApi = {
+ *   // PROVISIONAL — no /api/board/grants in the generated types yet.
+ *   loadGrants: endpoint("/api/board/grants" as ApiPath, "get"),
+ * } as const;
+ *
+ * @provisionalServiceRequest<GrantBean[], Grant[]>(BoardApi.loadGrants, {
+ *   lifecycle: DependencyLifecycle.LOAD,
+ *   transform: toGrants,
+ * })
+ * onGrantsLoaded(error: string | null, grants: Grant[]) {}
+ * ```
+ */
+export declare function provisionalServiceRequest<Raw, Transformed = Raw>(ep: {
+    readonly path: string;
+    readonly method: string;
+}, opts?: Partial<IKosServiceRequestParams<Record<string, any>, string, HttpMethod, Raw, Transformed>>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Create an API client for freestyle
  */
 export declare const api: {
-    get: <K extends "/api/ext/kos.ext.freestyle/studio/rfid/blanks" | "/api/ext/kos.ext.freestyle/studio/rfid/tags" | "/api/ext/kos.ext.freestyle/cartridges" | "/api/ext/kos.ext.freestyle/cartridges/{id}" | "/api/ext/kos.ext.freestyle/fuelGauges/{holder}" | "/api/ext/kos.ext.freestyle/brandset/nutrition/{bevId}" | "/api/ext/kos.ext.freestyle/brandset/grantProperties" | "/api/ext/kos.ext.freestyle/fcm/calibration/{pump}/baseline" | "/api/ext/kos.ext.freestyle/can/read/float/{boardPath}/{index}/{subIndex}" | "/api/ext/kos.ext.freestyle/can/read/int/{boardPath}/{index}/{subIndex}" | "/api/ext/kos.ext.freestyle/can/stats" | "/api/ext/kos.ext.freestyle/can/stats/raw" | "/api/ext/kos.ext.freestyle/microCalibration/report/{board}" | "/api/ext/kos.ext.freestyle/microCalibration/history/{pump}" | "/api/ext/kos.ext.freestyle/microCalibration/cal/{pump}">(endpoint: K, params?: (paths[K]["get"] extends {
+    get: <K extends "/api/ext/freestyle/can/read/float/{boardPath}/{index}/{subIndex}" | "/api/ext/freestyle/can/read/int/{boardPath}/{index}/{subIndex}" | "/api/ext/freestyle/can/stats" | "/api/ext/freestyle/can/stats/raw" | "/api/ext/freestyle/microCalibration/report/{board}" | "/api/ext/freestyle/microCalibration/history/{pump}" | "/api/ext/freestyle/microCalibration/cal/{pump}" | "/api/ext/freestyle/brandset/nutrition/{bevId}" | "/api/ext/freestyle/brandset/grantProperties" | "/api/ext/freestyle/fcm/calibration/{pump}/baseline" | "/api/ext/freestyle/fuelGauges/{holder}" | "/api/ext/freestyle/cartridges" | "/api/ext/freestyle/cartridges/{id}" | "/api/ext/freestyle/studio/rfid/blanks" | "/api/ext/freestyle/studio/rfid/tags">(endpoint: K, params?: (paths[K]["get"] extends {
         parameters: infer P;
     } ? P : never) | undefined, options?: {
         ordered?: boolean | undefined;
@@ -115,7 +147,7 @@ export declare const api: {
         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.freestyle/studio/rfid/update/{holder}" | "/api/ext/kos.ext.freestyle/studio/rfid/initialize/{holder}" | "/api/ext/kos.ext.freestyle/fuelGauges/{holder}/{val}" | "/api/ext/kos.ext.freestyle/microCalibration/pour/{pump}/calibrate" | "/api/ext/kos.ext.freestyle/microCalibration/pour/{pump}/preCalibrate" | "/api/ext/kos.ext.freestyle/microCalibration/pour/{pump}/verify" | "/api/ext/kos.ext.freestyle/microCalibration/pour/{pump}/complete" | "/api/ext/kos.ext.freestyle/brandset/grantProperties" | "/api/ext/kos.ext.freestyle/fcm/calibration/{pump}/calibrate" | "/api/ext/kos.ext.freestyle/fcm/calibration/{pump}/preCalibrate" | "/api/ext/kos.ext.freestyle/fcm/calibration/{pump}/verify/{calVolume}" | "/api/ext/kos.ext.freestyle/fcm/calibration/{pump}/baseline/{value}" | "/api/ext/kos.ext.freestyle/fcm/calibration/{pump}/complete/{calVolume}/{verifyVolume}" | "/api/ext/kos.ext.freestyle/can/stats" | "/api/ext/kos.ext.freestyle/can/write/byte/{boardPath}/{index}/{subIndex}/{val}" | "/api/ext/kos.ext.freestyle/can/write/short/{boardPath}/{index}/{subIndex}/{val}" | "/api/ext/kos.ext.freestyle/can/write/float/{boardPath}/{index}/{subIndex}/{val}" | "/api/ext/kos.ext.freestyle/can/write/int/{boardPath}/{index}/{subIndex}/{val}" | "/api/ext/kos.ext.freestyle/microCalibration/cal/{pump}/running/{val}" | "/api/ext/kos.ext.freestyle/microCalibration/cal/{pump}/code/{code}" | "/api/ext/kos.ext.freestyle/microCalibration/cal/{pump}/baseline/{val}" | "/api/ext/kos.ext.freestyle/microCalibration/cal/{pump}/both/{val}" | "/api/ext/kos.ext.freestyle/fcm/diagnostics/{pump}/pressureTest" | "/api/ext/kos.ext.freestyle/fcm/diagnostics/{pump}/opennessTest" | "/api/ext/kos.ext.freestyle/fcm/diagnostics/{pump}/flowTest" | "/api/ext/kos.ext.freestyle/fcm/diagnostics/{pump}/electricalTest">(endpoint: K, params?: (paths[K]["post"] extends {
+    post: <K extends "/api/ext/freestyle/can/stats" | "/api/ext/freestyle/can/write/byte/{boardPath}/{index}/{subIndex}/{val}" | "/api/ext/freestyle/can/write/short/{boardPath}/{index}/{subIndex}/{val}" | "/api/ext/freestyle/can/write/float/{boardPath}/{index}/{subIndex}/{val}" | "/api/ext/freestyle/can/write/int/{boardPath}/{index}/{subIndex}/{val}" | "/api/ext/freestyle/fcm/diagnostics/{pump}/pressureTest" | "/api/ext/freestyle/fcm/diagnostics/{pump}/opennessTest" | "/api/ext/freestyle/fcm/diagnostics/{pump}/flowTest" | "/api/ext/freestyle/fcm/diagnostics/{pump}/electricalTest" | "/api/ext/freestyle/microCalibration/cal/{pump}/running/{val}" | "/api/ext/freestyle/microCalibration/cal/{pump}/code/{code}" | "/api/ext/freestyle/microCalibration/cal/{pump}/baseline/{val}" | "/api/ext/freestyle/microCalibration/cal/{pump}/both/{val}" | "/api/ext/freestyle/brandset/grantProperties" | "/api/ext/freestyle/fcm/calibration/{pump}/calibrate" | "/api/ext/freestyle/fcm/calibration/{pump}/preCalibrate" | "/api/ext/freestyle/fcm/calibration/{pump}/verify/{calVolume}" | "/api/ext/freestyle/fcm/calibration/{pump}/baseline/{value}" | "/api/ext/freestyle/fcm/calibration/{pump}/complete/{calVolume}/{verifyVolume}" | "/api/ext/freestyle/microCalibration/pour/{pump}/calibrate" | "/api/ext/freestyle/microCalibration/pour/{pump}/preCalibrate" | "/api/ext/freestyle/microCalibration/pour/{pump}/verify" | "/api/ext/freestyle/microCalibration/pour/{pump}/complete" | "/api/ext/freestyle/fuelGauges/{holder}/{val}" | "/api/ext/freestyle/studio/rfid/update/{holder}" | "/api/ext/freestyle/studio/rfid/initialize/{holder}">(endpoint: K, params?: (paths[K]["post"] extends {
         parameters: infer P;
     } ? P : never) | undefined, body?: (paths[K]["post"] extends {
         requestBody: {

package/models/utils/services/freestyle/daily/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/kos-freestyle-sdk/src/models/utils/services/freestyle/daily/service.ts"],"names":[],"mappings":"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"}

package/models/utils/services/handle/daily/openapi.d.ts

@@ -22,7 +22,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["39828b9e-3345-484d-a0e1-6ec4e87b667e"];
+                        "application/json": components["schemas"]["e6dbca22-ae4e-4544-a474-a3640a0b4b80"];
                     };
                 };
             };
@@ -60,7 +60,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["d72bcc25-786e-4cfe-aa6b-ccd9591f0b75"];
+                        "application/json": components["schemas"]["c696049c-492c-45eb-bf0e-c0711a5d4636"];
                     };
                 };
             };
@@ -96,7 +96,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["d72bcc25-786e-4cfe-aa6b-ccd9591f0b75"];
+                        "application/json": components["schemas"]["c696049c-492c-45eb-bf0e-c0711a5d4636"];
                     };
                 };
             };
@@ -132,7 +132,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["d72bcc25-786e-4cfe-aa6b-ccd9591f0b75"];
+                        "application/json": components["schemas"]["c696049c-492c-45eb-bf0e-c0711a5d4636"];
                     };
                 };
             };
@@ -206,7 +206,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["21b48331-b86e-49a4-bae5-a91a7bd68e35"];
+                        "application/json": components["schemas"]["fbf3a7bf-d3a5-4bdb-9bc2-6565f61fef04"];
                     };
                 };
             };
@@ -278,7 +278,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["d72bcc25-786e-4cfe-aa6b-ccd9591f0b75"];
+                        "application/json": components["schemas"]["c696049c-492c-45eb-bf0e-c0711a5d4636"];
                     };
                 };
             };
@@ -312,7 +312,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["fdfbaa4d-5b93-4610-943e-e87fb52fc50e"];
+                        "application/json": components["schemas"]["af6b2491-abc1-49f3-b75c-9a28b8d91e33"];
                     };
                 };
             };
@@ -329,14 +329,14 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
-        "39828b9e-3345-484d-a0e1-6ec4e87b667e": string[];
-        "d72bcc25-786e-4cfe-aa6b-ccd9591f0b75": {
+        "e6dbca22-ae4e-4544-a474-a3640a0b4b80": string[];
+        "c696049c-492c-45eb-bf0e-c0711a5d4636": {
             reason?: string;
             note?: string;
             /** @description (typeName=com.kosdev.kos.commons.util.ReasonData) */
-            reasonData?: components["schemas"]["36b7150d-aafa-4f88-9feb-8ba47b4778ee"];
+            reasonData?: components["schemas"]["a3d76e5d-ac91-4e10-b74d-d5f31a031b3e"];
             /** @description (typeName=com.kosdev.kos.commons.util.concurrent.future.FutureWork) */
-            rootFuture?: components["schemas"]["d72bcc25-786e-4cfe-aa6b-ccd9591f0b75"];
+            rootFuture?: components["schemas"]["c696049c-492c-45eb-bf0e-c0711a5d4636"];
             tracker?: string;
             /** Format: int64 */
             remainingTimeMs?: number;
@@ -344,54 +344,54 @@ export interface components {
             /** Format: int32 */
             progress?: number;
             /** @description (typeName=java.util.Map<java.lang.String, com.kosdev.kos.commons.util.json.JsonViewWrapper>) */
-            clientAttributes?: components["schemas"]["00bfb95a-1677-4a31-b1ed-b229a2cd257b"];
+            clientAttributes?: components["schemas"]["8682a312-d949-4d05-86ba-33d00fb60653"];
             /** Format: int32 */
             id?: number;
             /** Format: int32 */
             abortAbandonedTimeoutMs?: number;
             /** @description (typeName=com.kosdev.kos.commons.util.json.JsonViewWrapper) */
-            clientData?: components["schemas"]["7ce965e4-1283-4832-b758-ddff1e1c45c3"];
+            clientData?: components["schemas"]["770d8f94-6438-461c-8b40-b8bae6e64e66"];
         };
-        "36b7150d-aafa-4f88-9feb-8ba47b4778ee": {
+        "a3d76e5d-ac91-4e10-b74d-d5f31a031b3e": {
             /** @description (typeName=java.lang.Class<?>) */
-            view?: components["schemas"]["6a79c1a3-037d-4bf4-b0ce-b1b5bdbb7a79"];
+            view?: components["schemas"]["06799842-9abc-4984-8093-c04ccbf2631f"];
             data?: Record<string, never>;
         };
-        "6a79c1a3-037d-4bf4-b0ce-b1b5bdbb7a79": unknown;
+        "06799842-9abc-4984-8093-c04ccbf2631f": unknown;
         /** @description (typeName=com.kosdev.kos.commons.util.json.JsonViewWrapper) */
-        "00bfb95a-1677-4a31-b1ed-b229a2cd257b": components["schemas"]["7ce965e4-1283-4832-b758-ddff1e1c45c3"];
-        "7ce965e4-1283-4832-b758-ddff1e1c45c3": {
+        "8682a312-d949-4d05-86ba-33d00fb60653": components["schemas"]["770d8f94-6438-461c-8b40-b8bae6e64e66"];
+        "770d8f94-6438-461c-8b40-b8bae6e64e66": {
             /** @description (typeName=java.lang.Class<?>) */
-            view?: components["schemas"]["6a79c1a3-037d-4bf4-b0ce-b1b5bdbb7a79"];
+            view?: components["schemas"]["06799842-9abc-4984-8093-c04ccbf2631f"];
             data?: Record<string, never>;
         };
         /** @description (typeName=com.tccc.kos.ext.freestyle.service.cartridgeagitation.AgitationTracker) */
-        "21b48331-b86e-49a4-bae5-a91a7bd68e35": components["schemas"]["389070a3-4f74-4b30-a65c-84c688878780"];
-        "389070a3-4f74-4b30-a65c-84c688878780": {
+        "fbf3a7bf-d3a5-4bdb-9bc2-6565f61fef04": components["schemas"]["09c6a984-9ec9-408d-8be6-1185edbb96df"];
+        "09c6a984-9ec9-408d-8be6-1185edbb96df": {
             /** @description (typeName=com.tccc.kos.ext.freestyle.service.cartridgeagitation.AgitationAction) */
-            action?: components["schemas"]["fdfbaa4d-5b93-4610-943e-e87fb52fc50e"];
+            action?: components["schemas"]["af6b2491-abc1-49f3-b75c-9a28b8d91e33"];
             /** Format: int32 */
             state?: number;
             /** @description (typeName=java.util.List<com.tccc.kos.ext.freestyle.service.cartridgeagitation.Agitation>) */
-            agitations?: components["schemas"]["d20757ef-6df3-4137-9cfa-8b905c43e138"];
+            agitations?: components["schemas"]["6bbd1b5f-b0ab-4dae-858b-7b80e50e99b0"];
         };
-        "fdfbaa4d-5b93-4610-943e-e87fb52fc50e": {
+        "af6b2491-abc1-49f3-b75c-9a28b8d91e33": {
             /** Format: int32 */
             delayMs?: number;
             holderPath?: string;
             /** Format: int32 */
             state?: number;
             /** @description (typeName=com.tccc.kos.ext.freestyle.service.cartridgeagitation.AgitationAction$Type) */
-            type?: components["schemas"]["d9c8d0f8-471d-40cc-bc8c-de19e49bedf7"];
+            type?: components["schemas"]["0dd8fcbe-2134-4f12-b0ea-393b8b874126"];
             containerId?: string;
             /** Format: int32 */
             durationMs?: number;
             /** Format: int32 */
             rpm?: number;
         };
-        "d9c8d0f8-471d-40cc-bc8c-de19e49bedf7": unknown;
-        "d20757ef-6df3-4137-9cfa-8b905c43e138": components["schemas"]["117b7114-663a-4c7e-88b6-d42b5d64ef2c"][];
-        "117b7114-663a-4c7e-88b6-d42b5d64ef2c": {
+        "0dd8fcbe-2134-4f12-b0ea-393b8b874126": unknown;
+        "6bbd1b5f-b0ab-4dae-858b-7b80e50e99b0": components["schemas"]["9a63ddeb-ba08-4ffd-ab78-ccd8d2eaa0d6"][];
+        "9a63ddeb-ba08-4ffd-ab78-ccd8d2eaa0d6": {
             /** Format: int32 */
             duration?: number;
             /** Format: int64 */

package/models/utils/services/handle/daily/service.d.ts

@@ -95,6 +95,38 @@ export type EndpointResponse<E extends Endpoint> = ApiResponse<E["path"], E["met
  * ```
  */
 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;
+/**
+ * `serviceRequest` for an endpoint the generated types do not declare yet.
+ *
+ * There is no `paths` entry to derive anything from, so the response shape is
+ * supplied by hand instead: `Raw` is what the backend is expected to serve (the
+ * UNWRAPPED `data` payload — the client strips the `{status, data}` envelope
+ * before `transform` runs) and `Transformed` is what `transform` returns. Path
+ * and query params are untyped for the same reason.
+ *
+ * Every use is a debt, and the name is there to be grepped. When the endpoint
+ * lands: re-run `api:generate`, drop the `as ApiPath` cast on its `endpoint(...)`
+ * entry, point the raw type at `EndpointResponse<...>`, and switch back to
+ * `serviceRequest`. The transform survives all of it unchanged.
+ *
+ * @example
+ * ```typescript
+ * export const BoardApi = {
+ *   // PROVISIONAL — no /api/board/grants in the generated types yet.
+ *   loadGrants: endpoint("/api/board/grants" as ApiPath, "get"),
+ * } as const;
+ *
+ * @provisionalServiceRequest<GrantBean[], Grant[]>(BoardApi.loadGrants, {
+ *   lifecycle: DependencyLifecycle.LOAD,
+ *   transform: toGrants,
+ * })
+ * onGrantsLoaded(error: string | null, grants: Grant[]) {}
+ * ```
+ */
+export declare function provisionalServiceRequest<Raw, Transformed = Raw>(ep: {
+    readonly path: string;
+    readonly method: string;
+}, opts?: Partial<IKosServiceRequestParams<Record<string, any>, string, HttpMethod, Raw, Transformed>>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
  * Create an API client for handle
  */

package/models/utils/services/handle/daily/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/kos-freestyle-sdk/src/models/utils/services/handle/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"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/kos-freestyle-sdk/src/models/utils/services/handle/daily/service.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-export * as FREESTYLE_SERVICE from './services/kos.ext.freestyle/daily/service';
+export * as FREESTYLE_SERVICE from './services/freestyle/daily/service';
 export * as FREESTYLE_SERVICE_1_6_5 from './services/freestyle/1.6.5/service';
 export * as FREESTYLE_SERVICE_1_8_1 from './services/freestyle/1.8.1/service';
 export * as HANDLE_SERVICE from './services/handle/daily/service';

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

@@ -1 +1 @@
-{"version":3,"file":"services-index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-freestyle-sdk/src/models/utils/services-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,iBAAiB,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,uBAAuB,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,uBAAuB,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,cAAc,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,oBAAoB,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"services-index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-freestyle-sdk/src/models/utils/services-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,iBAAiB,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,uBAAuB,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,uBAAuB,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,cAAc,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,oBAAoB,MAAM,iCAAiC,CAAC"}

package/models.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const service = require("./service-BdkksbW6.cjs");
-const extensionUtils = require("./extension-utils-BgIVPDP-.cjs");
+const service = require("./service-D4aX0z2P.cjs");
+const extensionUtils = require("./extension-utils-oabjo9KD.cjs");
 exports.AGITATION_REQUIRED_TROUBLE = service.AGITATION_REQUIRED_TROUBLE;
 exports.AgitationRequiredTrouble = service.AgitationRequiredTrouble;
 exports.CarbAgitator = service.CarbAgitator;

package/models.js

@@ -1,5 +1,5 @@
-import { A, a, C, b, c, d, e, s, f, g, F, h, i, j, k, l, m, I, n, K, L, S, r } from "./service-CbUm_Gcm.js";
-import { E, i as i2, F as F2, a as a2, b as b2, K as K2, c as c2 } from "./extension-utils-Cq7rNoBR.js";
+import { A, a, C, b, c, d, e, s, f, g, F, h, i, j, k, l, m, I, n, K, L, S, r } from "./service-eFbVjaFu.js";
+import { E, i as i2, F as F2, a as a2, b as b2, K as K2, c as c2 } from "./extension-utils-BJAnNxer.js";
 export {
   A as AGITATION_REQUIRED_TROUBLE,
   a as AgitationRequiredTrouble,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-freestyle-sdk",
-  "version": "3.0.21",
+  "version": "3.0.23",
   "type": "module",
   "types": "./index.d.ts",
   "main": "./index.js",
@@ -31,7 +31,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "a5481c29ff5f1e4f0c89ed967aea9b0f0b9ee171"
+      "gitHash": "78a2bbd25c176cfbcb4add6ee11dd660941657c2"
     }
   }
 }