@kosdev-code/kos-ui-sdk 0.1.0-next.867 → 0.1.0-next.871

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

@@ -8,14 +8,20 @@ import { paths } from './openapi';
 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 API
  */
-export type ApiResponse<Path extends ApiPath, Method extends "get" | "post" | "put" | "delete" = "get"> = ClientResponse<paths, Path, Method>;
+export type ApiResponse<Path extends ApiPath, Method extends SupportedMethod = "get"> = ClientResponse<paths, Path, Method>;
 /**
  * Get execution context type for kos API
  */
-export type ExecutionContext<Path extends ApiPath = ApiPath, Method extends HttpMethod = "get"> = KosExecutionContext<paths, Path, Method>;
+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 API types
  *
@@ -38,11 +44,64 @@ export type ExecutionContext<Path extends ApiPath = ApiPath, Method extends Http
  * ```
  */
 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 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
  */
 export declare const api: {
-    get: <K extends "/api/kos/network/interfaces" | "/api/kos/ui/plugins/context/{*name}" | "/api/kos/ui/plugins/contexts" | "/api/kos/localization/context/{*path}" | "/api/kos/localization/contexts" | "/api/kos/browser" | "/api/kos/browser/redirect" | "/api/kos/future/traces" | "/api/kos/future/traces/{traceId}/events" | "/api/kos/ota/paused" | "/api/kos/ota/artifacts" | "/api/kos/state/paths" | "/api/kos/state/{path}" | "/api/kos/hardware/resolver/identityMappings" | "/api/kos/config/schema" | "/api/kos/config/schema/{path}" | "/api/kos/config/{path}" | "/api/kos/config/details/{options}" | "/api/kos/config/details/{path}/{options}" | "/api/kos/config/value/merged/{scopedPath}/{attr}" | "/api/kos/config/value/{scopedPath}/{attr}" | "/api/kos/config/bean/defaults/{scopedPath}" | "/api/kos/config/bean/merged/{path}" | "/api/kos/config/bean/overrides/{scopedPath}" | "/api/kos/storage/devices" | "/api/kos/update/available" | "/api/kos/troubles" | "/api/kos/troubles/{troubleId}" | "/api/kos/handles" | "/api/kos/handles/{path}" | "/api/kos/handles/{path}/{view}" | "/api/kos/handles/views" | "/api/kos/openapi/{*baseUrl}" | "/api/kos/manifest/node" | "/api/kos/manifest/device" | "/api/kos/manifest/info" | "/api/kos/apps" | "/api/kos/apps/started" | "/api/kos/time/timezone" | "/api/kos/regions" | "/api/kos/regions/info" | "/api/kos/descriptor/{path}" | "/api/kos/descriptor/{path}/{dotted}" | "/api/kos/logs/rotateAll" | "/api/kos/logs/node/{nodeId}/streams" | "/api/kos/logs/node/{nodeId}/{stream}/blocks" | "/api/kos/logs/node/{nodeId}/{stream}/blocks/{blockId}" | "/api/kos/logs/rotate/{stream}" | "/api/kos/logs/overrides" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests" | "/api/kos/nodeMgr/blockedManifests" | "/api/kos/logs/groups" | "/api/kos/logs/overrides/{nodeType}" | "/api/kos/logs/overrides/{nodeType}/{typePrefix}" | "/api/kos/studio/properties" | "/api/kos/criticalData/sources" | "/api/kos/criticalData/data" | "/api/kos/criticalData/data/{name}" | "/api/kos/device" | "/api/kos/device/assemblies" | "/api/kos/device/serialNumber">(endpoint: K, params?: (paths[K]["get"] extends {
+    get: <K extends "/api/kos/network/interfaces" | "/api/kos/ui/plugins/context/{*name}" | "/api/kos/ui/plugins/contexts" | "/api/kos/localization/context/{*path}" | "/api/kos/localization/contexts" | "/api/kos/browser" | "/api/kos/browser/redirect" | "/api/kos/future/traces" | "/api/kos/future/traces/{traceId}/events" | "/api/kos/ota/paused" | "/api/kos/ota/artifacts" | "/api/kos/state/paths" | "/api/kos/state/{path}" | "/api/kos/hardware/resolver/identityMappings" | "/api/kos/config/schema" | "/api/kos/config/schema/{path}" | "/api/kos/config/{path}" | "/api/kos/config/details/{options}" | "/api/kos/config/details/{path}/{options}" | "/api/kos/config/value/merged/{scopedPath}/{attr}" | "/api/kos/config/value/{scopedPath}/{attr}" | "/api/kos/config/bean/defaults/{scopedPath}" | "/api/kos/config/bean/merged/{path}" | "/api/kos/config/bean/overrides/{scopedPath}" | "/api/kos/storage/devices" | "/api/kos/update/available" | "/api/kos/troubles" | "/api/kos/troubles/{troubleId}" | "/api/kos/handles" | "/api/kos/handles/{path}" | "/api/kos/handles/{path}/{view}" | "/api/kos/handles/views" | "/api/kos/openapi/{*baseUrl}" | "/api/kos/manifest/node" | "/api/kos/manifest/device" | "/api/kos/manifest/info" | "/api/kos/apps" | "/api/kos/apps/started" | "/api/kos/time/timezone" | "/api/kos/regions" | "/api/kos/regions/info" | "/api/kos/descriptor/{path}" | "/api/kos/descriptor/{path}/{dotted}" | "/api/kos/logs/rotateAll" | "/api/kos/logs/node/{nodeId}/streams" | "/api/kos/logs/node/{nodeId}/{stream}/blocks" | "/api/kos/logs/node/{nodeId}/{stream}/blocks/{blockId}" | "/api/kos/logs/rotate/{stream}" | "/api/kos/logs/overrides" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests" | "/api/kos/nodeMgr/blockedManifests" | "/api/kos/logs/groups" | "/api/kos/logs/overrides/{nodeType}" | "/api/kos/logs/overrides/{nodeType}/{typePrefix}" | "/api/kos/studio/properties" | "/api/kos/criticalData/sources" | "/api/kos/criticalData/data" | "/api/kos/criticalData/data/{name}" | "/api/kos/device" | "/api/kos/device/assemblies" | "/api/kos/device/serialNumber" | "/api/kos/future/active" | "/api/kos/udev/devices" | "/api/kos/udev/monitors" | "/api/kos/nodeMgr/node/{nodeId}/fallbacks" | "/api/kos/nodeMgr/node/{nodeId}/queues" | "/api/kos/nodeMgr/node/{nodeId}/queues/meta/activeQueue" | "/api/kos/nodeMgr/node/{nodeId}/queues/meta/effectiveQueueAtBoot" | "/api/kos/nodeMgr/node/{nodeId}/queues/meta/activeQueueAtBoot" | "/api/kos/nodeMgr/node/{nodeId}/queues/{name}" | "/api/kos/nodeMgr/node/{nodeId}/manifests/{queue}/{manifestId}/props" | "/api/kos/nodeMgr/node/{nodeId}/manifests/{queue}/{manifestId}/props/{key}" | "/api/kos/nodeMgr/node/{nodeId}/fallback/{queue}" | "/api/kos/context" | "/api/kos/gpio/chips" | "/api/kos/gpio/pins">(endpoint: K, params?: (paths[K]["get"] extends {
         parameters: infer P;
     } ? P : never) | undefined, options?: {
         ordered?: boolean | undefined;
@@ -58,7 +117,7 @@ export declare const api: {
         responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
         retry?: (boolean | import('../../../../..').RetryConfig) | undefined;
     }) => Promise<import('../../../../../core/util/kos-service-request').ServiceResponse<ClientResponse<paths, K, "get">>>;
-    post: <K extends "/api/kos/network/set-connection/{nodeId}" | "/api/kos/network/connect-node-to-wifi" | "/api/kos/browser/{nodeId}" | "/api/kos/browser/{nodeId}/{name}" | "/api/kos/browser/intent" | "/api/kos/browser/url" | "/api/kos/future/{futureId}/cancel" | "/api/kos/ota/resume/{name}" | "/api/kos/ota/cancel" | "/api/kos/ota/cancel/{name}" | "/api/kos/ota/pause/{name}" | "/api/kos/hardware/resolver/identityMappings/{boardPath}" | "/api/kos/config/{path}" | "/api/kos/config/bulk" | "/api/kos/update/install" | "/api/kos/troubles/resolve" | "/api/kos/troubles/resolve/{troubleId}" | "/api/kos/time/date" | "/api/kos/time/timezone" | "/api/kos/time/time" | "/api/kos/logs/node/{nodeId}/{stream}/subscribe" | "/api/kos/logs/node/{nodeId}/{stream}/unsubscribe" | "/api/kos/logs/overrides" | "/api/kos/nodeMgr/reboot" | "/api/kos/nodeMgr/node/{nodeId}/reboot" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests/{manifestId}" | "/api/kos/nodeMgr/blockedManifests/{manifestId}" | "/api/kos/criticalData/data" | "/api/kos/criticalData/data/{name}" | "/api/kos/device/serialNumber/{serialNum}">(endpoint: K, params?: (paths[K]["post"] extends {
+    post: <K extends "/api/kos/network/set-connection/{nodeId}" | "/api/kos/network/connect-node-to-wifi" | "/api/kos/browser/{nodeId}" | "/api/kos/browser/{nodeId}/{name}" | "/api/kos/browser/intent" | "/api/kos/browser/url" | "/api/kos/future/{futureId}/cancel" | "/api/kos/ota/resume/{name}" | "/api/kos/ota/cancel" | "/api/kos/ota/cancel/{name}" | "/api/kos/ota/pause/{name}" | "/api/kos/hardware/resolver/identityMappings/{boardPath}" | "/api/kos/config/{path}" | "/api/kos/config/bulk" | "/api/kos/update/install" | "/api/kos/troubles/resolve" | "/api/kos/troubles/resolve/{troubleId}" | "/api/kos/time/date" | "/api/kos/time/timezone" | "/api/kos/time/time" | "/api/kos/logs/node/{nodeId}/{stream}/subscribe" | "/api/kos/logs/node/{nodeId}/{stream}/unsubscribe" | "/api/kos/logs/overrides" | "/api/kos/nodeMgr/reboot" | "/api/kos/nodeMgr/node/{nodeId}/reboot" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests/{manifestId}" | "/api/kos/nodeMgr/blockedManifests/{manifestId}" | "/api/kos/criticalData/data" | "/api/kos/criticalData/data/{name}" | "/api/kos/device/serialNumber/{serialNum}" | "/api/kos/nodeMgr/node/{nodeId}/queues/meta/activeQueue/{name}" | "/api/kos/nodeMgr/node/{nodeId}/queues/{name}" | "/api/kos/nodeMgr/node/{nodeId}/queues/{queue}/{newName}" | "/api/kos/nodeMgr/node/{nodeId}/manifests/{queue}/{manifestId}/active" | "/api/kos/nodeMgr/node/{nodeId}/manifests/{queue}/{manifestId}/props" | "/api/kos/nodeMgr/node/{nodeId}/fallback/{queue}/{fallbackQueue}" | "/api/kos/update/internalUpdate" | "/api/kos/update/internalUpdateAndReboot">(endpoint: K, params?: (paths[K]["post"] extends {
         parameters: infer P;
     } ? P : never) | undefined, body?: (paths[K]["post"] extends {
         requestBody: {
@@ -98,7 +157,7 @@ export declare const api: {
         responseType?: "text" | "json" | "arraybuffer" | "blob" | undefined;
         retry?: (boolean | import('../../../../..').RetryConfig) | undefined;
     }) => Promise<import('../../../../../core/util/kos-service-request').ServiceResponse<ClientResponse<paths, K, "put">>>;
-    delete: <K extends "/api/kos/hardware/resolver/identityMappings/{boardPath}" | "/api/kos/logs/overrides" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests/{manifestId}" | "/api/kos/nodeMgr/blockedManifests/{manifestId}" | "/api/kos/criticalData/data/{name}">(endpoint: K, params?: (paths[K]["delete"] extends {
+    delete: <K extends "/api/kos/hardware/resolver/identityMappings/{boardPath}" | "/api/kos/logs/overrides" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests" | "/api/kos/nodeMgr/node/{nodeId}/blockedManifests/{manifestId}" | "/api/kos/nodeMgr/blockedManifests/{manifestId}" | "/api/kos/criticalData/data/{name}" | "/api/kos/nodeMgr/node/{nodeId}/queues/{name}" | "/api/kos/nodeMgr/node/{nodeId}/manifests/{queue}/{manifestId}" | "/api/kos/nodeMgr/node/{nodeId}/manifests/{queue}/{manifestId}/active" | "/api/kos/nodeMgr/node/{nodeId}/manifests/{queue}/{manifestId}/props/{key}">(endpoint: K, params?: (paths[K]["delete"] extends {
         parameters: infer P;
     } ? P : never) | undefined, body?: (paths[K]["put"] extends {
         requestBody: {

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

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/kos-ui-sdk/src/models/utils/services/kos/daily/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EACzB,MAAM,yDAAyD,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAGnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAClF,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;;GAEG;AACH,MAAM,MAAM,WAAW,CACrB,IAAI,SAAS,OAAO,EACpB,MAAM,SAAS,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,IACtD,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,IAC/B,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;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,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAwB,CAAC;AAEzC,eAAe,GAAG,CAAC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/kos-ui-sdk/src/models/utils/services/kos/daily/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EACzB,MAAM,yDAAyD,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAGnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAClF,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/vfs/daily/openapi.d.ts

@@ -1,51 +1,51 @@
 export interface paths {
-  "/api/vfs": {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    /** Return the structure of the VFS. (v1.0) */
-    get: {
-      parameters: {
-        query?: never;
-        header?: never;
-        path?: never;
-        cookie?: never;
-      };
-      requestBody?: never;
-      responses: {
-        /** @description OK */
-        200: {
-          headers: {
-            [name: string]: unknown;
-          };
-          content: {
-            "application/json": components["schemas"]["7482934b-52af-489c-ba46-d05c45c33100"];
-          };
+    "/api/vfs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Return the structure of the VFS. (v1.0) */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["7377fe1a-07be-4d53-a475-50b722868d11"];
+                    };
+                };
+            };
         };
-      };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
     };
-    put?: never;
-    post?: never;
-    delete?: never;
-    options?: never;
-    head?: never;
-    patch?: never;
-    trace?: never;
-  };
 }
 export type webhooks = Record<string, never>;
 export interface components {
-  schemas: {
-    "7482934b-52af-489c-ba46-d05c45c33100": unknown;
-  };
-  responses: never;
-  parameters: never;
-  requestBodies: never;
-  headers: never;
-  pathItems: never;
+    schemas: {
+        "7377fe1a-07be-4d53-a475-50b722868d11": unknown;
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
 }
 export type $defs = Record<string, never>;
 export type operations = Record<string, never>;

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

@@ -8,14 +8,20 @@ import { paths } from './openapi';
 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 vfs API
  */
-export type ApiResponse<Path extends ApiPath, Method extends "get" | "post" | "put" | "delete" = "get"> = ClientResponse<paths, Path, Method>;
+export type ApiResponse<Path extends ApiPath, Method extends SupportedMethod = "get"> = ClientResponse<paths, Path, Method>;
 /**
  * Get execution context type for vfs API
  */
-export type ExecutionContext<Path extends ApiPath = ApiPath, Method extends HttpMethod = "get"> = KosExecutionContext<paths, Path, Method>;
+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 vfs API types
  *
@@ -38,6 +44,59 @@ export type ExecutionContext<Path extends ApiPath = ApiPath, Method extends Http
  * ```
  */
 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 vfs 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 vfs
  */

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

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/kos-ui-sdk/src/models/utils/services/vfs/daily/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EACzB,MAAM,yDAAyD,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAGnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAClF,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;;GAEG;AACH,MAAM,MAAM,WAAW,CACrB,IAAI,SAAS,OAAO,EACpB,MAAM,SAAS,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,IACtD,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,IAC/B,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;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,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAwB,CAAC;AAEzC,eAAe,GAAG,CAAC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/kos-ui-sdk/src/models/utils/services/vfs/daily/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,KAAK,EACV,UAAU,EACV,wBAAwB,EACzB,MAAM,yDAAyD,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAGnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAClF,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,9 +1,9 @@
+export * as KOS_SERVICE from './services/kos/daily/service';
 export * as KOS_SERVICE_1_6_5 from './services/kos/1.6.5/service';
 export * as KOS_SERVICE_1_8_1 from './services/kos/1.8.1/service';
 export * as KOS_SERVICE_1_9_X from './services/kos/1.9.x/service';
-export * as KOS_SERVICE from './services/kos/daily/service';
+export * as VFS_SERVICE from './services/vfs/daily/service';
 export * as VFS_SERVICE_1_6_5 from './services/vfs/1.6.5/service';
 export * as VFS_SERVICE_1_8_1 from './services/vfs/1.8.1/service';
 export * as VFS_SERVICE_1_9_X from './services/vfs/1.9.x/service';
-export * as VFS_SERVICE from './services/vfs/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-ui-sdk/src/models/utils/services-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,WAAW,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,WAAW,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"services-index.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-ui-sdk/src/models/utils/services-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,WAAW,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,iBAAiB,MAAM,8BAA8B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-ui-sdk",
-  "version": "0.1.0-next.867",
+  "version": "0.1.0-next.871",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",
@@ -50,7 +50,7 @@
     "react-router-dom": "^6.11.2"
   },
   "dependencies": {
-    "@kosdev-code/kos-api-levels": "0.1.0-next.867",
+    "@kosdev-code/kos-api-levels": "0.1.0-next.871",
     "mobx": "^6.9.0",
     "mobx-react-lite": "^3.4.3",
     "date-fns": "^2.30.0",
@@ -59,7 +59,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "582b99ec0f379e7d51b412e78c045aa16c65d693"
+      "gitHash": "e137eed4b414b79d2a5afcde28f43544a56eb557"
     }
   }
 }

package/testing.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("mobx");
-const service = require("./index-D8aw-T5w.cjs");
+const service = require("./index-DsRhHHtS.cjs");
 require("loglevel");
 let booted;
 function bootKosCore(registration, options = {}) {

package/testing.js

@@ -1,5 +1,5 @@
 import "mobx";
-import { b0 as KosMock, l as KosCore } from "./index-CvCXisvT.js";
+import { b0 as KosMock, l as KosCore } from "./index-D64IOwMG.js";
 import "loglevel";
 let booted;
 function bootKosCore(registration, options = {}) {