@fmsim/api 1.0.87 → 2.0.0-beta.110

package/custom-elements.json

@@ -27,9 +27,133 @@
             }
           ]
         },
+        {
+          "kind": "function",
+          "name": "reorderBoard",
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "prevId",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "nextId",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "fetchPlayback",
+          "parameters": [
+            {
+              "name": "startTime",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "endTime",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "includeSnapshot",
+              "default": "true",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "count",
+              "optional": true,
+              "type": {
+                "text": "number"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "fetchCarrierLocationHistory",
+          "parameters": [
+            {
+              "name": "startTime",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "endTime",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "carrierName",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
         {
           "kind": "function",
           "name": "fetchBoardById",
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "cachedUpdatedAt",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "fetchBoardNameById",
+          "return": {
+            "type": {
+              "text": "Promise<string>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "fetchBoardNameInfoById",
+          "return": {
+            "type": {
+              "text": "Promise<{ name?: string; nameI18n?: string }>"
+            }
+          },
           "parameters": [
             {
               "name": "id",
@@ -80,6 +204,62 @@
               }
             }
           ]
+        },
+        {
+          "kind": "function",
+          "name": "searchFigureIds",
+          "return": {
+            "type": {
+              "text": "Promise<string[]>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "type",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "keyword",
+              "default": "''",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "opts",
+              "default": "{}",
+              "type": {
+                "text": "FigureIdSearchOptions"
+              }
+            }
+          ],
+          "description": "컴포넌트 타입 + 검색어로, MCS 에 이미 정의된 머신/유닛 ID 후보를 검색.\n보드 작화 시 컴포넌트 ID 를 자유 입력 대신 *검색해서 선택* 하기 위한 용도.\n\n서버에는 type(+unit 이면 machine)만 보내 후보 목록을 받고, keyword 는 받은 목록을\n클라이언트에서 **풀텍스트 매칭** 으로 필터한다 — 서버에 keyword 를 보내지 않는다.\n\n풀텍스트 전략: keyword 를 공백으로 토큰화하고, 각 토큰이 (순서 무관) 후보의 전체\n식별자(\"{machine} {unit}\", 대소문자 무관) 에 부분일치하면(AND) 매치로 본다.\n예) \"stk01 p03\" → STK01-P03 매치, \"p03 stk01\" 도 동일 매치.\n\n결과는 **1차원 id 리스트(string[])** — machine 타입이면 머신 id, unit 타입이면 unit id."
+        },
+        {
+          "kind": "function",
+          "name": "filterFigureIds",
+          "return": {
+            "type": {
+              "text": "string[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "ids",
+              "type": {
+                "text": "string[]"
+              }
+            },
+            {
+              "name": "keyword",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "머신/유닛 id 리스트를 keyword 로 **풀텍스트 필터** — 서버 재조회 없이 로컬에서 사용.\nkeyword 를 공백 토큰화하고, 각 토큰이 (순서 무관) id 에 부분일치(AND) 하면 통과.\n빈 keyword 는 전체 반환. 예: \"stk01 p03\" ↔ \"STK01-P03\", \"p03 stk01\" 동일."
         }
       ],
       "exports": [
@@ -91,6 +271,14 @@
             "module": "src/graphql"
           }
         },
+        {
+          "kind": "js",
+          "name": "FigureIdSearchOptions",
+          "declaration": {
+            "name": "FigureIdSearchOptions",
+            "module": "./restful"
+          }
+        },
         {
           "kind": "js",
           "name": "isRestfulAvailable",
@@ -115,6 +303,30 @@
             "module": "src/index.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "reorderBoard",
+          "declaration": {
+            "name": "reorderBoard",
+            "module": "src/index.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fetchPlayback",
+          "declaration": {
+            "name": "fetchPlayback",
+            "module": "src/index.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fetchCarrierLocationHistory",
+          "declaration": {
+            "name": "fetchCarrierLocationHistory",
+            "module": "src/index.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "fetchBoardById",
@@ -123,6 +335,22 @@
             "module": "src/index.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "fetchBoardNameById",
+          "declaration": {
+            "name": "fetchBoardNameById",
+            "module": "src/index.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fetchBoardNameInfoById",
+          "declaration": {
+            "name": "fetchBoardNameInfoById",
+            "module": "src/index.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "createBoard",
@@ -162,6 +390,22 @@
             "name": "getPopupData",
             "module": "src/index.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "searchFigureIds",
+          "declaration": {
+            "name": "searchFigureIds",
+            "module": "src/index.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "filterFigureIds",
+          "declaration": {
+            "name": "filterFigureIds",
+            "module": "src/index.ts"
+          }
         }
       ]
     },
@@ -188,6 +432,67 @@
             }
           ]
         },
+        {
+          "kind": "function",
+          "name": "fetchBoardNameById",
+          "return": {
+            "type": {
+              "text": "Promise<string>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "fetchBoardNameInfoById",
+          "return": {
+            "type": {
+              "text": "Promise<{ name?: string; nameI18n?: string }>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "대표명 + 다국어(nameI18n) 를 함께 반환 — 표시 측에서 현재 언어로 resolve 하기 위함."
+        },
+        {
+          "kind": "function",
+          "name": "reorderBoard",
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "prevId",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "nextId",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
         {
           "kind": "function",
           "name": "fetchBoardById",
@@ -197,6 +502,13 @@
               "type": {
                 "text": "string"
               }
+            },
+            {
+              "name": "cachedUpdatedAt",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
             }
           ]
         },
@@ -258,6 +570,30 @@
             "module": "src/graphql/board.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "fetchBoardNameById",
+          "declaration": {
+            "name": "fetchBoardNameById",
+            "module": "src/graphql/board.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fetchBoardNameInfoById",
+          "declaration": {
+            "name": "fetchBoardNameInfoById",
+            "module": "src/graphql/board.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "reorderBoard",
+          "declaration": {
+            "name": "reorderBoard",
+            "module": "src/graphql/board.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "fetchBoardById",
@@ -309,9 +645,32 @@
           "description": "",
           "name": "DataSubscriptionProviderImpl",
           "members": [
+            {
+              "kind": "field",
+              "name": "_paused",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_subscriptions",
+              "type": {
+                "text": "Map<Component, { tag: string; unsubscribe: () => void }>"
+              },
+              "privacy": "private",
+              "default": "new Map()"
+            },
             {
               "kind": "method",
               "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "Promise<{ unsubscribe: () => void }>"
+                }
+              },
               "parameters": [
                 {
                   "name": "tag",
@@ -327,6 +686,16 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "pause",
+              "description": "플레이백 시작: 모든 구독을 실제 해제"
+            },
+            {
+              "kind": "method",
+              "name": "resume",
+              "description": "플레이백 종료: 보관된 tag 로 재구독"
+            },
             {
               "kind": "method",
               "name": "dispose"
@@ -604,6 +973,106 @@
             "name": "*",
             "module": "src/graphql/theme"
           }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/graphql/playback"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/graphql/playback.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "fetchPlayback",
+          "return": {
+            "type": {
+              "text": "Promise<PlaybackResult>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "startTime",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "endTime",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "includeSnapshot",
+              "default": "true",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "count",
+              "optional": true,
+              "type": {
+                "text": "number"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "fetchCarrierLocationHistory",
+          "return": {
+            "type": {
+              "text": "Promise<CarrierLocationHistoryResult>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "startTime",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "endTime",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "carrierName",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "GraphQL — 단일 carrier 의 시계열 위치 이력 조회.\nRESTful 의 GET /mcs/lv/playback/carrier-location 미러.\n\n요청 시간 포맷: \"YYYY-MM-DD HH:mm:ss\" (스페이스 구분자, 기존 playback 동일).\n응답 time 포맷: \"YYYY-MM-DDTHH:mm:ss[.SSS]\" (T 구분자, 가변 ms).\n양쪽 모두 timezone suffix 없음 — 로컬타임 기준."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "fetchPlayback",
+          "declaration": {
+            "name": "fetchPlayback",
+            "module": "src/graphql/playback.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fetchCarrierLocationHistory",
+          "declaration": {
+            "name": "fetchCarrierLocationHistory",
+            "module": "src/graphql/playback.ts"
+          }
         }
       ]
     },
@@ -983,6 +1452,67 @@
             }
           ]
         },
+        {
+          "kind": "function",
+          "name": "fetchBoardNameById",
+          "return": {
+            "type": {
+              "text": "Promise<string>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "fetchBoardNameInfoById",
+          "return": {
+            "type": {
+              "text": "Promise<{ name?: string; nameI18n?: string }>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "대표명 + 다국어(nameI18n) 를 함께 반환 — 표시 측에서 현재 언어로 resolve 하기 위함."
+        },
+        {
+          "kind": "function",
+          "name": "reorderBoard",
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "prevId",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "nextId",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        },
         {
           "kind": "function",
           "name": "fetchBoardById",
@@ -992,6 +1522,13 @@
               "type": {
                 "text": "string"
               }
+            },
+            {
+              "name": "cachedUpdatedAt",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
             }
           ]
         },
@@ -1060,6 +1597,30 @@
             "module": "src/restful/board.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "fetchBoardNameById",
+          "declaration": {
+            "name": "fetchBoardNameById",
+            "module": "src/restful/board.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fetchBoardNameInfoById",
+          "declaration": {
+            "name": "fetchBoardNameInfoById",
+            "module": "src/restful/board.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "reorderBoard",
+          "declaration": {
+            "name": "reorderBoard",
+            "module": "src/restful/board.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "fetchBoardById",
@@ -1687,6 +2248,14 @@
             "name": "*",
             "module": "src/restful/theme"
           }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/restful/playback"
+          }
         }
       ]
     },
@@ -1711,6 +2280,31 @@
               }
             }
           ]
+        },
+        {
+          "kind": "function",
+          "name": "fetchFigureIds",
+          "return": {
+            "type": {
+              "text": "Promise<string[]>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "type",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "opts",
+              "default": "{}",
+              "type": {
+                "text": "FigureIdSearchOptions"
+              }
+            }
+          ],
+          "description": "Figure ID Mapping — 컴포넌트(figure) 타입으로 서버에 정의된 ID 후보를 조회.\n(id-lookup 백엔드 확정 명세: MCS LV RESTful)\n\n포커스 시 **항상 실제 HTTP 호출**. 대상은 getRestServiceFullPath() 가 결정:\n  - 프로덕션(fmsim-restful): lv_server_ip_port + /mcs/lv → MCS LV RESTful 호스트\n  - 테스트(fmsim): same-origin → fmsim 앱 서버 mock 라우트\n\n요청 규약 (확정):\n  GET {base}/resource/name?figureType={type}[&machineName={parentMachine}]\n  - figureType : 컴포넌트(figure) 타입\n  - machineName: 부모 머신 id — 조회 범위 한정 (unit 계열일 때). 없으면 생략.\n  - keyword 는 보내지 않는다 (후보 목록을 받아 클라이언트에서 풀텍스트 필터).\n\n응답 규약 (확정):\n  { \"data\": string[], \"errorMessage\": string | null, \"status\": boolean }\n  - status=false 면 빈 결과로 취급.\n  - data 는 1차원 id 리스트(string[]). (머신별 그룹핑 없음.)"
         }
       ],
       "exports": [
@@ -1721,6 +2315,107 @@
             "name": "getPopupData",
             "module": "src/restful/machine.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "fetchFigureIds",
+          "declaration": {
+            "name": "fetchFigureIds",
+            "module": "src/restful/machine.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/restful/playback.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "fetchPlayback",
+          "return": {
+            "type": {
+              "text": "Promise<PlaybackResult>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "startTime",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "endTime",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "includeSnapshot",
+              "default": "true",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "count",
+              "optional": true,
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "RESTful 플레이백 데이터 조회 — 명세에 따라 URL 이 2가지로 분리됨.\n\nv1 범위 조회:\n  GET /mcs/lv/playback?startTime=...&endTime=...&includeSnapshot=...\n\nv2 개수 조회:\n  GET /mcs/lv/playback/count?startTime=...&count=...&includeSnapshot=...\n\nendTime 이 주어지면 v1, count 가 주어지면 v2 로 라우팅.\n둘 다 주어지면 endTime 우선 (범위 우선 원칙).\n둘 다 없으면 파라미터 에러지만 서버가 처리."
+        },
+        {
+          "kind": "function",
+          "name": "fetchCarrierLocationHistory",
+          "return": {
+            "type": {
+              "text": "Promise<CarrierLocationHistoryResult>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "startTime",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "endTime",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "carrierName",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "RESTful — 단일 carrier 의 시계열 위치 이력 조회.\n\n  GET /mcs/lv/playback/carrier-location\n    ?startTime=YYYY-MM-DD HH:mm:ss\n    &endTime=YYYY-MM-DD HH:mm:ss\n    &carrierName=...\n\n요청 시간 포맷: \"YYYY-MM-DD HH:mm:ss\" (스페이스 구분자, 기존 /playback 동일).\n응답 time 포맷: \"YYYY-MM-DDTHH:mm:ss[.SSS]\" (T 구분자, 가변 ms).\n양쪽 모두 timezone suffix 없음 — 로컬타임 기준."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "fetchPlayback",
+          "declaration": {
+            "name": "fetchPlayback",
+            "module": "src/restful/playback.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fetchCarrierLocationHistory",
+          "declaration": {
+            "name": "fetchCarrierLocationHistory",
+            "module": "src/restful/playback.ts"
+          }
         }
       ]
     },