@kmlckj/licos-platform-sdk 0.8.6 → 0.10.0

package/README.md

@@ -161,25 +161,62 @@ Use `uns.openPath(path)` when business code targets an existing enterprise UNS
 path without creating or changing `UNS.json`:
 
 ```js
-const temperature = uns.openPath('project:/production-line/temperature');
-const current = await temperature.pointCurrent();
+const temperature = uns.openPath('project:/production-line/temperature');
+const current = await temperature.pointCurrent();
+```
+
+Realtime point consumers expose only an application-local WebSocket path. The
+SDK resolves the DataFactory endpoint, registers each UNS node, handles
+heartbeat/reconnect, and does not expose upstream addresses or runtime tokens to
+application code or browsers:
+
+```js
+const detachRealtime = uns.attachPointRealtimeRelay({
+  server,
+  path: '/ws/uns/points',
+  codes: ['TEMP_01'],
+});
 ```
+
+Resource apply, data writes, point writes, and video controls require explicit
+confirmation. Data deletion accepts the exact rows returned by a prior query
+and also requires explicit confirmation. Point writes require a reason and ticket. The browser entry
+does not export UNS helpers.
 
-Realtime point consumers obtain the server-side WebSocket endpoint through the
-authorized project runtime API. Create one upstream connection per returned
-`nodeCode`; do not derive or hardcode a DataFactory address:
+## Direct Industrial Integration
+
+The server-only `industrial` facade manages collection and video resources
+without creating DataFactory UNS nodes. Use it only when the user explicitly
+selects direct collector integration; UNS failures must not trigger this mode.
 
 ```js
-const realtime = await uns.pointRealtimeConfig('TEMP_01');
-// Connect to realtime.websocketUrl and register with realtime.nodeCode.
+import { industrial } from '@kmlckj/licos-platform-sdk';
+
+const points = await industrial.searchResources('collectionPoint', {
+  scope: 'project',
+  keyword: 'temperature',
+});
+
+const current = await industrial.pointCurrent(points.items[0].id);
+const detachRealtime = industrial.attachRealtimeRelay({
+  server: httpServer,
+  path: '/ws/industrial/realtime',
+  pointIds: [points.items[0].id],
+  transport: 'websocket',
+});
 ```
 
-Resource apply, data writes, point writes, and video controls require explicit
-confirmation. Data deletion accepts the exact rows returned by a prior query
-and also requires explicit confirmation. Point writes require a reason and ticket. The browser entry
-does not export UNS helpers.
-
-## OAuth2 Application Management
+Realtime subscription defaults to upstream WebSocket and supports explicitly
+selected MQTT. Point control defaults to HTTP and supports explicitly selected
+MQTT. Neither direction silently falls back. Resource writes use a reviewed
+`IndustrialChangeSet`; point and video writes require independent confirmation.
+`attachRealtimeRelay` exchanges and refreshes the platform user token inside the
+SDK, authenticates the upstream WebSocket, sends the subscription, and relays
+messages on the exact local path. Application code must not read runtime identity
+variables or construct an `Authorization` header. The browser entry does not
+export industrial helpers or external credentials.
+
+## OAuth2 Application Management
 
 OAuth2 management is available only from trusted Node runtime code. It uses the
 current project owner's platform identity and is not exported by the browser

package/dist/index.d.ts

@@ -28,7 +28,8 @@ export interface RuntimeConfig {
 export function runtimeConfig(options?: { environmentOverrideEnv?: string }): Promise<RuntimeConfig>;
 export function authHeaders(config: RuntimeConfig, contentType?: string): Record<string, string>;
 
-export * from './uns.js';
+export * from './uns.js';
+export * from './industrial.js';
 
 export type OAuthLoginAudience = 'ALL' | 'OWNER_TENANT';
 

package/dist/index.js

@@ -1 +1 @@
-export{PlatformSdkError,ConfigurationError,ApiError}from"./shared.js";export{runtimeConfig,authHeaders}from"./runtime.js";export*from"./database.js";export*from"./knowledge.js";export*from"./oauth.js";export*from"./oauth-runtime.js";export*from"./storage.js";export*from"./uns.js";export{studioDatabase}from"./studio-database.js";
+export{PlatformSdkError,ConfigurationError,ApiError}from"./shared.js";export{runtimeConfig,authHeaders}from"./runtime.js";export*from"./database.js";export*from"./knowledge.js";export*from"./industrial.js";export*from"./oauth.js";export*from"./oauth-runtime.js";export*from"./storage.js";export*from"./uns.js";export{studioDatabase}from"./studio-database.js";

package/dist/industrial.d.ts

@@ -0,0 +1,130 @@
+export type IndustrialResourceType =
+  | 'edgeAgent'
+  | 'connection'
+  | 'collectionTask'
+  | 'collectionPoint'
+  | 'videoEdge'
+  | 'videoGateway'
+  | 'videoDevice'
+  | 'videoChannel';
+
+export type IndustrialSubscriptionTransport = 'auto' | 'websocket' | 'mqtt';
+export type IndustrialControlTransport = 'auto' | 'http' | 'mqtt';
+
+export function getIndustrialProtocolSchema(protocol: string): Promise<Record<string, unknown>>;
+export function searchIndustrialResources(
+  resourceType: IndustrialResourceType | string,
+  options?: {
+    protocol?: string;
+    keyword?: string;
+    scope?: 'project' | 'enterprise';
+    selector?: Record<string, unknown>;
+    page?: number;
+    pageSize?: number;
+    page_size?: number;
+  },
+): Promise<Record<string, unknown>>;
+export function getIndustrialResource(
+  resourceType: IndustrialResourceType | string,
+  resourceId: string,
+): Promise<Record<string, unknown>>;
+export function validateIndustrialChanges(document: Record<string, unknown>): Promise<Record<string, unknown>>;
+export function planIndustrialChanges(document: Record<string, unknown>): Promise<Record<string, unknown>>;
+export function applyIndustrialChanges(
+  document: Record<string, unknown>,
+  options: {
+    expectedDocumentHash?: string;
+    expected_document_hash?: string;
+    expectedPlanHash?: string;
+    expected_plan_hash?: string;
+    confirmed: boolean;
+    impactConfirmed?: boolean;
+    impact_confirmed?: boolean;
+  },
+): Promise<Record<string, unknown>>;
+export function getIndustrialRuntimeCapabilities(): Promise<Record<string, unknown>>;
+export function getIndustrialRealtimeConnection(options: {
+  pointIds?: string[];
+  point_ids?: string[];
+  tagCodes?: string[];
+  tag_codes?: string[];
+  transport?: IndustrialSubscriptionTransport;
+}): Promise<{
+  url: string;
+  authentication: string;
+  subscribe: {
+    type: 'subscribe';
+    transport: IndustrialSubscriptionTransport;
+    pointIds: string[];
+    tagCodes: string[];
+  };
+}>;
+export function attachIndustrialRealtimeRelay(options: {
+  server: import('node:http').Server;
+  path: string;
+  pointIds?: string[];
+  point_ids?: string[];
+  tagCodes?: string[];
+  tag_codes?: string[];
+  transport?: IndustrialSubscriptionTransport;
+}): () => void;
+export function getIndustrialPointCurrent(pointId: string): Promise<Record<string, unknown>>;
+export function getIndustrialPointHistory(
+  pointId: string,
+  options: {
+    startTime?: string;
+    start_time?: string;
+    endTime?: string;
+    end_time?: string;
+    page?: number;
+    pageSize?: number;
+    page_size?: number;
+  },
+): Promise<Record<string, unknown>>;
+export function writeIndustrialPoint(
+  pointId: string,
+  value: unknown,
+  options: {
+    reason: string;
+    ticket: string;
+    transport?: IndustrialControlTransport;
+    requestId?: string;
+    request_id?: string;
+    dryRun?: boolean;
+    dry_run?: boolean;
+    confirmed?: boolean;
+  },
+): Promise<Record<string, unknown>>;
+export function getIndustrialVideoStreamOptions(channelId: string): Promise<Record<string, unknown>>;
+export function startIndustrialVideoPreview(
+  channelId: string,
+  options: {
+    confirmed: boolean;
+    preferredProtocol?: string;
+    preferred_protocol?: string;
+    preferredProtocolOrder?: string[];
+    preferred_protocol_order?: string[];
+  },
+): Promise<Record<string, unknown>>;
+export function stopIndustrialVideoPreview(
+  channelId: string,
+  options: { confirmed: boolean },
+): Promise<Record<string, unknown>>;
+
+export const industrial: {
+  protocolSchema: typeof getIndustrialProtocolSchema;
+  searchResources: typeof searchIndustrialResources;
+  resource: typeof getIndustrialResource;
+  validateChanges: typeof validateIndustrialChanges;
+  planChanges: typeof planIndustrialChanges;
+  applyChanges: typeof applyIndustrialChanges;
+  runtimeCapabilities: typeof getIndustrialRuntimeCapabilities;
+  realtimeConnection: typeof getIndustrialRealtimeConnection;
+  attachRealtimeRelay: typeof attachIndustrialRealtimeRelay;
+  pointCurrent: typeof getIndustrialPointCurrent;
+  pointHistory: typeof getIndustrialPointHistory;
+  writePoint: typeof writeIndustrialPoint;
+  videoStreamOptions: typeof getIndustrialVideoStreamOptions;
+  startVideoPreview: typeof startIndustrialVideoPreview;
+  stopVideoPreview: typeof stopIndustrialVideoPreview;
+};

package/dist/industrial.js

@@ -0,0 +1 @@
+import{ApiError as e}from"./shared.js";import{authHeaders as t,refreshRuntimeConfig as r,runtimeConfig as n,shouldRefreshUserToken as o}from"./runtime.js";import{WebSocket as i,WebSocketServer as a}from"ws";function s(e){return Object.fromEntries(Object.entries(e).filter(([,e])=>null!=e))}function c(e,t){return`/projects/${encodeURIComponent(e.projectId)}${t}`}async function u(i,a,{body:c,config:u}={}){let d=u||await n();for(let n=0;n<2;n+=1)try{const r=await fetch(new URL(`${d.baseUrl}/api/v1${a}`),{method:i,headers:t(d,void 0===c?void 0:"application/json"),body:void 0===c?void 0:JSON.stringify(s(c))}),n=await r.text();let o=null;try{o=n?JSON.parse(n):null}catch{throw new e(n||`platform industrial API returned ${r.status}`,{status:r.status,details:n})}if(!r.ok||o&&void 0!==o.code&&0!==o.code||!1===o?.success)throw new e(o?.message||n||"platform industrial API failed",{status:r.status,code:"number"==typeof o?.code?o.code:void 0,details:o});return o&&"object"==typeof o?o.data:o}catch(e){if(0===n&&o(e)){d=await r(d);continue}throw e}throw new e("platform industrial API failed")}export async function getIndustrialProtocolSchema(e){const t=await n();return u("GET",c(t,`/industrial/protocols/${encodeURIComponent(e)}/schema`),{config:t})}export async function searchIndustrialResources(e,t={}){const r=await n();return u("POST",c(r,"/industrial/resources/search"),{body:{resourceType:e,protocol:t.protocol,keyword:t.keyword,scope:t.scope||"project",selector:t.selector||{},page:t.page??1,pageSize:t.pageSize??t.page_size??20},config:r})}export async function getIndustrialResource(e,t){const r=await n();return u("GET",c(r,`/industrial/resources/${encodeURIComponent(e)}/${encodeURIComponent(t)}`),{config:r})}async function d(e,t){const r=await n();return u("POST",c(r,`/industrial/changes/${e}`),{body:{document:t},config:r})}export function validateIndustrialChanges(e){return d("validate",e)}export function planIndustrialChanges(e){return d("plan",e)}export async function applyIndustrialChanges(e,t={}){const r=String(t.expectedDocumentHash??t.expected_document_hash??"").trim(),o=String(t.expectedPlanHash??t.expected_plan_hash??"").trim();if(!0!==t.confirmed)throw new TypeError("industrial changes apply requires explicit confirmation");if(!r||!o)throw new TypeError("industrial changes apply requires document and plan hashes");const i=await n();return u("POST",c(i,"/industrial/changes/apply"),{body:{document:e,expectedDocumentHash:r,expectedPlanHash:o,confirmed:!0,impactConfirmed:!0===t.impactConfirmed||!0===t.impact_confirmed},config:i})}export async function getIndustrialRuntimeCapabilities(){const e=await n();return u("GET",c(e,"/industrial/runtime/capabilities"),{config:e})}function l(e,t={}){const r=(t.pointIds||t.point_ids||[]).map(String).map(e=>e.trim()).filter(Boolean),n=(t.tagCodes||t.tag_codes||[]).map(String).map(e=>e.trim()).filter(Boolean);if(0===r.length&&0===n.length)throw new TypeError("pointIds or tagCodes must be provided");const o=new URL(e.baseUrl);return o.protocol="https:"===o.protocol?"wss:":"ws:",o.pathname=`/api/v1${c(e,"/industrial/runtime/points/realtime")}`,o.search="",o.hash="",{url:o.toString(),authentication:"use platform session or Authorization header",subscribe:{type:"subscribe",transport:t.transport||"auto",pointIds:r,tagCodes:n}}}export async function getIndustrialRealtimeConnection(e={}){return l(await n(),e)}function p(r,n,o){const a=l(r,n);return new Promise((n,s)=>{const c=new i(a.url,{headers:t(r,null)});let u=!1;const d=e=>{u||s(e)};c.on("message",(e,t)=>{u&&o.onMessage(e,t)}),c.on("close",(e,t)=>{u&&o.onClose(e,t)}),c.on("error",e=>{u?o.onError(e):d(e)}),c.once("unexpected-response",(t,r)=>{r.resume(),d(function(t,r){const n=new e(t,{status:r});return n.status=r,n}(`platform industrial realtime returned ${r.statusCode||500}`,r.statusCode||500))}),c.once("open",()=>{u=!0,c.send(JSON.stringify(a.subscribe)),o.onOpen(),n(c)})})}function f(e,t){e.readyState===i.OPEN&&e.send(JSON.stringify(t))}export function attachIndustrialRealtimeRelay(e={}){const t=e.server;if(!t||"function"!=typeof t.on||"function"!=typeof t.removeListener)throw new TypeError("industrial realtime relay requires a Node HTTP server");const s=function(e){const t=String(e||"").trim();if(!t.startsWith("/")||t.includes("?")||t.includes("#"))throw new TypeError("industrial realtime relay path must be an absolute path without query or hash");return t}(e.path),c={pointIds:e.pointIds??e.point_ids,tagCodes:e.tagCodes??e.tag_codes,transport:e.transport||"websocket"};l({baseUrl:"http://localhost",projectId:"validation"},c);const u=new a({noServer:!0}),d=new Set;u.on("connection",e=>{(async e=>{let t=null;const a=()=>{t&&(d.delete(t),t.readyState!==i.OPEN&&t.readyState!==i.CONNECTING||t.close(),t=null)};e.once("close",a),e.once("error",a);try{if(t=await async function(e,t){let i=await n();try{return await p(i,e,t)}catch(n){if(!o(n))throw n;return i=await r(i),p(i,e,t)}}(c,{onOpen:()=>f(e,{type:"status",status:"connected"}),onMessage:(t,r)=>{e.readyState===i.OPEN&&e.send(t,{binary:r})},onClose:()=>{t&&d.delete(t),f(e,{type:"upstream.close",message:"上游连接已关闭"})},onError:()=>f(e,{type:"upstream.error",message:"上游连接失败"})}),e.readyState!==i.OPEN)return void a();d.add(t)}catch{f(e,{type:"error",message:"建立实时连接失败"}),e.close()}})(e)});const m=(e,t,r)=>{let n;try{n=new URL(e.url||"/",`http://${e.headers.host||"localhost"}`).pathname}catch{return}n===s&&u.handleUpgrade(e,t,r,t=>{u.emit("connection",t,e)})};return t.on("upgrade",m),()=>{t.removeListener("upgrade",m);for(const e of d)e.close();d.clear();for(const e of u.clients)e.close(1001,"relay closed");u.close()}}function m(e,t,r){return c(e,`/industrial/runtime/points/${encodeURIComponent(t)}/${r}`)}export async function getIndustrialPointCurrent(e){const t=await n();return u("GET",m(t,e,"current"),{config:t})}export async function getIndustrialPointHistory(e,t={}){const r=await n();return u("POST",m(r,e,"history"),{body:{startTime:t.startTime??t.start_time,endTime:t.endTime??t.end_time,page:t.page??1,pageSize:t.pageSize??t.page_size??100},config:r})}export async function writeIndustrialPoint(e,t,r={}){const o=String(r.reason||"").trim(),i=String(r.ticket||"").trim(),a=!0===r.dryRun||!0===r.dry_run;if(!a&&!0!==r.confirmed)throw new TypeError("industrial point write requires explicit confirmation");if(!o||!i)throw new TypeError("industrial point write requires reason and ticket");const s=await n();return u("POST",m(s,e,"write"),{body:{value:t,transport:r.transport||"auto",reason:o,ticket:i,requestId:r.requestId??r.request_id,dryRun:a,confirmed:!0===r.confirmed},config:s})}async function h(e,t,r,o){const i=await n();return u(e,c(i,`/industrial/runtime/video/channels/${encodeURIComponent(t)}/${r}`),{body:o,config:i})}export function getIndustrialVideoStreamOptions(e){return h("GET",e,"stream-options")}export function startIndustrialVideoPreview(e,t={}){if(!0!==t.confirmed)throw new TypeError("industrial video preview start requires explicit confirmation");return h("POST",e,"preview/start",{preferredProtocol:t.preferredProtocol??t.preferred_protocol??"http-flv",preferredProtocolOrder:t.preferredProtocolOrder??t.preferred_protocol_order??["http-flv","webrtc","hls"],confirmed:!0})}export function stopIndustrialVideoPreview(e,t={}){if(!0!==t.confirmed)throw new TypeError("industrial video preview stop requires explicit confirmation");return h("POST",e,"preview/stop",{confirmed:!0})}export const industrial={protocolSchema:getIndustrialProtocolSchema,searchResources:searchIndustrialResources,resource:getIndustrialResource,validateChanges:validateIndustrialChanges,planChanges:planIndustrialChanges,applyChanges:applyIndustrialChanges,runtimeCapabilities:getIndustrialRuntimeCapabilities,realtimeConnection:getIndustrialRealtimeConnection,attachRealtimeRelay:attachIndustrialRealtimeRelay,pointCurrent:getIndustrialPointCurrent,pointHistory:getIndustrialPointHistory,writePoint:writeIndustrialPoint,videoStreamOptions:getIndustrialVideoStreamOptions,startVideoPreview:startIndustrialVideoPreview,stopVideoPreview:stopIndustrialVideoPreview};

package/dist/uns.d.ts

@@ -84,11 +84,19 @@ export function deleteUnsNodeData(nodeCode: string, rows: UnsObject[], options:
 export function queryUnsPathData(path: string, options?: UnsDataQueryOptions): Promise<UnsObject>;
 export function writeUnsPathData(path: string, fieldValues: UnsObject, options: { confirmed: boolean }): Promise<UnsObject>;
 export function deleteUnsPathData(path: string, rows: UnsObject[], options: { confirmed: boolean }): Promise<UnsObject>;
-export function getUnsPointCurrent(nodeCode: string): Promise<UnsObject>;
-export function getUnsPathPointCurrent(path: string): Promise<UnsObject>;
+export function getUnsPointCurrent(nodeCode: string): Promise<UnsObject>;
+export function getUnsPathPointCurrent(path: string): Promise<UnsObject>;
 export function getUnsPointRealtimeConfig(nodeCode: string): Promise<UnsObject>;
 export function getUnsPathPointRealtimeConfig(path: string): Promise<UnsObject>;
-export function getUnsPointHistory(nodeCode: string, options: UnsPointHistoryOptions): Promise<UnsObject>;
+export function attachUnsPointRealtimeRelay(options: {
+  server: import('node:http').Server;
+  path: string;
+  codes?: string[];
+  nodeCodes?: string[];
+  node_codes?: string[];
+  paths?: string[];
+}): () => void;
+export function getUnsPointHistory(nodeCode: string, options: UnsPointHistoryOptions): Promise<UnsObject>;
 export function getUnsPathPointHistory(path: string, options: UnsPointHistoryOptions): Promise<UnsObject>;
 export function writeUnsPoint(nodeCode: string, value: unknown, options: UnsPointWriteOptions): Promise<UnsObject>;
 export function writeUnsPathPoint(path: string, value: unknown, options: UnsPointWriteOptions): Promise<UnsObject>;
@@ -105,10 +113,10 @@ export class UnsPathNode {
   resolve(): Promise<UnsObject>;
   queryData(options?: UnsDataQueryOptions): Promise<UnsObject>;
   writeData(fieldValues: UnsObject, options: { confirmed: boolean }): Promise<UnsObject>;
-  deleteData(rows: UnsObject[], options: { confirmed: boolean }): Promise<UnsObject>;
-  pointCurrent(): Promise<UnsObject>;
-  pointRealtimeConfig(): Promise<UnsObject>;
-  pointHistory(options: UnsPointHistoryOptions): Promise<UnsObject>;
+  deleteData(rows: UnsObject[], options: { confirmed: boolean }): Promise<UnsObject>;
+  pointCurrent(): Promise<UnsObject>;
+  pointRealtimeConfig(): Promise<UnsObject>;
+  pointHistory(options: UnsPointHistoryOptions): Promise<UnsObject>;
   writePoint(value: unknown, options: UnsPointWriteOptions): Promise<UnsObject>;
   videoStreamOptions(): Promise<UnsObject>;
   videoSnapshot(): Promise<UnsObject>;
@@ -139,11 +147,12 @@ export const uns: {
   queryPathData: typeof queryUnsPathData;
   writePathData: typeof writeUnsPathData;
   deletePathData: typeof deleteUnsPathData;
-  pointCurrent: typeof getUnsPointCurrent;
-  pathPointCurrent: typeof getUnsPathPointCurrent;
+  pointCurrent: typeof getUnsPointCurrent;
+  pathPointCurrent: typeof getUnsPathPointCurrent;
   pointRealtimeConfig: typeof getUnsPointRealtimeConfig;
   pathPointRealtimeConfig: typeof getUnsPathPointRealtimeConfig;
-  pointHistory: typeof getUnsPointHistory;
+  attachPointRealtimeRelay: typeof attachUnsPointRealtimeRelay;
+  pointHistory: typeof getUnsPointHistory;
   pathPointHistory: typeof getUnsPathPointHistory;
   writePoint: typeof writeUnsPoint;
   writePathPoint: typeof writeUnsPathPoint;

package/dist/uns.js

@@ -1 +1 @@
-import{ApiError as t}from"./shared.js";import{authHeaders as e,refreshRuntimeConfig as n,runtimeConfig as o,shouldRefreshUserToken as r}from"./runtime.js";function a(t){return Object.fromEntries(Object.entries(t).filter(([,t])=>null!=t))}function i(t,e){return`/projects/${encodeURIComponent(t.projectId)}${e}`}function s(t,e,n,o){return i(t,`/uns/runtime/${e}/${encodeURIComponent(n)}/${o}`)}function c(t,e,n){const o=String(n||"").trim();if(!o)throw new TypeError("UNS path cannot be empty");return`${i(t,`/uns/runtime/path/${e}`)}?${new URLSearchParams({path:o})}`}function p(t,e){return new URL(`${t.baseUrl}/api/v1${e}`)}async function u(e){const n=await e.text();let o=null;try{o=n?JSON.parse(n):null}catch{throw new t(n||`platform UNS API returned ${e.status}`,{status:e.status,details:n})}if(!e.ok)throw new t(o?.message||n||`platform UNS API returned ${e.status}`,{status:e.status,code:"number"==typeof o?.code?o.code:void 0,details:o});if(!o||"object"!=typeof o)return o;if(void 0!==o.code&&0!==o.code||!1===o.success)throw new t(o.message||"platform UNS API failed",{status:e.status,code:"number"==typeof o.code?o.code:void 0,details:o});return o.data}async function d(i,s,{body:c,config:d}={}){let h=d||await o();for(let t=0;t<2;t+=1)try{const t="function"==typeof s?s(h):s,n=await fetch(p(h,t),{method:i,headers:e(h,void 0===c?void 0:"application/json"),body:void 0===c?void 0:JSON.stringify(a(c))});return await u(n)}catch(e){if(0===t&&r(e)){h=await n(h);continue}throw e}throw new t("platform UNS API failed")}export function getCurrentUnsSchema(){return d("GET","/uns/schemas/current")}export function getUnsSchema(t="1.0"){return d("GET",`/uns/schemas/${encodeURIComponent(t)}`)}export function listUnsSchemaBlocks(t="1.0"){return d("GET",`/uns/schemas/${encodeURIComponent(t)}/blocks`)}export function getUnsSchemaBlock(t,{version:e="1.0",depth:n=1}={}){return d("GET",`/uns/schemas/${encodeURIComponent(e)}/blocks/${encodeURIComponent(t)}?depth=${encodeURIComponent(n)}`)}export function getUnsProtocolSchema(t,{version:e="1.0"}={}){return d("GET",`/uns/schemas/${encodeURIComponent(e)}/blocks/collection-point/protocols/${encodeURIComponent(t)}`)}export async function discoverUnsResources({resourceTypes:t=[],protocols:e=[]}={}){const n=await o();return d("POST",i(n,"/uns/discover"),{body:{resourceTypes:t,protocols:e},config:n})}export async function searchUnsResources(t,e={}){const n=await o();return d("POST",i(n,"/uns/resources/search"),{body:{resourceType:t,protocol:e.protocol,keyword:e.keyword,selector:e.selector||{},page:e.page??1,pageSize:e.pageSize??e.page_size??20},config:n})}export async function listUnsBindings(){const t=await o();return d("GET",i(t,"/uns/bindings"),{config:t})}export async function resolveUnsPath(t){const e=await o();return d("GET",c(e,"resolve",t),{config:e})}export async function validateUnsDocument(t){const e=await o();return d("POST",i(e,"/uns/validate"),{body:{document:t},config:e})}export async function planUnsDocument(t){const e=await o();return d("POST",i(e,"/uns/plan"),{body:{document:t},config:e})}export async function applyUnsDocument(t,e={}){const n=String(e.expectedDocumentHash??e.expected_document_hash??"").trim(),r=String(e.expectedPlanHash??e.expected_plan_hash??"").trim();if(!0!==e.confirmed)throw new TypeError("UNS apply requires explicit confirmation");if(!n||!r)throw new TypeError("UNS apply requires document and plan hashes");const a=await o();return d("POST",i(a,"/uns/apply"),{body:{document:t,expectedDocumentHash:n,expectedPlanHash:r,confirmed:!0},config:a})}export async function validateUnsChanges(t){const e=await o();return d("POST",i(e,"/uns/changes/validate"),{body:{document:t},config:e})}export async function planUnsChanges(t){const e=await o();return d("POST",i(e,"/uns/changes/plan"),{body:{document:t},config:e})}export async function applyUnsChanges(t,e={}){const n=String(e.expectedDocumentHash??e.expected_document_hash??"").trim(),r=String(e.expectedPlanHash??e.expected_plan_hash??"").trim();if(!0!==e.confirmed)throw new TypeError("UNS changes apply requires explicit confirmation");if(!n||!r)throw new TypeError("UNS changes apply requires document and plan hashes");const a=await o();return d("POST",i(a,"/uns/changes/apply"),{body:{document:t,expectedDocumentHash:n,expectedPlanHash:r,confirmed:!0,impactConfirmed:!0===e.impactConfirmed||!0===e.impact_confirmed},config:a})}function h(t={}){return a({pageNum:t.pageNum??t.page_num??1,pageSize:t.pageSize??t.page_size??50,paginationMode:t.paginationMode??t.pagination_mode??"OFFSET",pageToken:t.pageToken??t.page_token})}export async function queryUnsNodeData(t,e={}){const n=await o();return d("POST",s(n,"nodes",t,"query"),{body:h(e),config:n})}function f(t,e){if(!0!==e)throw new TypeError("UNS data write requires explicit confirmation");if(!t||"object"!=typeof t||0===Object.keys(t).length)throw new TypeError("UNS data write field values cannot be empty")}export async function writeUnsNodeData(t,e,{confirmed:n=!1}={}){f(e,n);const r=await o();return d("POST",s(r,"nodes",t,"write"),{body:{fieldValues:e,environment:r.environment,confirmed:!0},config:r})}function m(t,e){if(!0!==e)throw new TypeError("UNS data deletion requires explicit confirmation");if(!Array.isArray(t)||0===t.length||t.some(t=>!t||"object"!=typeof t||Array.isArray(t)||0===Object.keys(t).length))throw new TypeError("UNS data deletion rows cannot be empty")}export async function deleteUnsNodeData(t,e,{confirmed:n=!1}={}){m(e,n);const r=await o();return d("POST",s(r,"nodes",t,"delete"),{body:{rows:e,confirmed:!0},config:r})}export async function queryUnsPathData(t,e={}){const n=await o();return d("POST",c(n,"data/query",t),{body:h(e),config:n})}export async function writeUnsPathData(t,e,{confirmed:n=!1}={}){f(e,n);const r=await o();return d("POST",c(r,"data/write",t),{body:{fieldValues:e,environment:r.environment,confirmed:!0},config:r})}export async function deleteUnsPathData(t,e,{confirmed:n=!1}={}){m(e,n);const r=await o();return d("POST",c(r,"data/delete",t),{body:{rows:e,confirmed:!0},config:r})}export async function getUnsPointCurrent(t){const e=await o();return d("GET",s(e,"points",t,"current"),{config:e})}export async function getUnsPathPointCurrent(t){const e=await o();return d("GET",c(e,"point/current",t),{config:e})}export async function getUnsPointRealtimeConfig(t){const e=await o();return d("GET",s(e,"points",t,"realtime-config"),{config:e})}export async function getUnsPathPointRealtimeConfig(t){const e=await o();return d("GET",c(e,"point/realtime-config",t),{config:e})}function l(t={}){return{startTime:t.startTime??t.start_time,endTime:t.endTime??t.end_time,page:t.page??1,pageSize:t.pageSize??t.page_size??100}}export async function getUnsPointHistory(t,e){const n=await o();return d("POST",s(n,"points",t,"history"),{body:l(e),config:n})}export async function getUnsPathPointHistory(t,e){const n=await o();return d("POST",c(n,"point/history",t),{body:l(e),config:n})}function y(t,e={}){const n=String(e.reason||"").trim(),o=String(e.ticket||"").trim(),r=e.dryRun??e.dry_run??!1,i=e.confirmed??!1;if(!r&&!0!==i)throw new TypeError("UNS point write requires explicit confirmation");if(!n||!o)throw new TypeError("UNS point write requires reason and ticket");return a({value:t,reason:n,ticket:o,requestId:e.requestId??e.request_id,dryRun:r,confirmed:i})}export async function writeUnsPoint(t,e,n={}){const r=y(e,n),a=await o();return d("POST",s(a,"points",t,"write"),{body:r,config:a})}export async function writeUnsPathPoint(t,e,n={}){const r=y(e,n),a=await o();return d("POST",c(a,"point/write",t),{body:r,config:a})}export async function getUnsVideoStreamOptions(t){const e=await o();return d("GET",s(e,"videos",t,"stream-options"),{config:e})}export async function getUnsPathVideoStreamOptions(t){const e=await o();return d("GET",c(e,"video/stream-options",t),{config:e})}export async function createUnsVideoSnapshot(t){const e=await o();return d("POST",s(e,"videos",t,"snapshot"),{config:e})}export async function createUnsPathVideoSnapshot(t){const e=await o();return d("POST",c(e,"video/snapshot",t),{config:e})}function g(t,e={}){if(!0!==e.confirmed)throw new TypeError("UNS video control requires explicit confirmation");return{action:t,parameters:e.parameters||{},confirmed:!0}}export async function controlUnsVideo(t,e,n={}){const r=g(e,n),a=await o();return d("POST",s(a,"videos",t,"control"),{body:r,config:a})}export async function controlUnsPathVideo(t,e,n={}){const r=g(e,n),a=await o();return d("POST",c(a,"video/control",t),{body:r,config:a})}export class UnsPathNode{constructor(t){if(this.path=String(t||"").trim(),!this.path)throw new TypeError("UNS path cannot be empty")}resolve(){return resolveUnsPath(this.path)}queryData(t){return queryUnsPathData(this.path,t)}writeData(t,e){return writeUnsPathData(this.path,t,e)}deleteData(t,e){return deleteUnsPathData(this.path,t,e)}pointCurrent(){return getUnsPathPointCurrent(this.path)}pointRealtimeConfig(){return getUnsPathPointRealtimeConfig(this.path)}pointHistory(t){return getUnsPathPointHistory(this.path,t)}writePoint(t,e){return writeUnsPathPoint(this.path,t,e)}videoStreamOptions(){return getUnsPathVideoStreamOptions(this.path)}videoSnapshot(){return createUnsPathVideoSnapshot(this.path)}controlVideo(t,e){return controlUnsPathVideo(this.path,t,e)}}export function openUnsPath(t){return new UnsPathNode(t)}export const uns={schemaCurrent:getCurrentUnsSchema,schema:getUnsSchema,schemaBlocks:listUnsSchemaBlocks,schemaBlock:getUnsSchemaBlock,protocolSchema:getUnsProtocolSchema,discover:discoverUnsResources,searchResources:searchUnsResources,bindings:listUnsBindings,resolvePath:resolveUnsPath,validate:validateUnsDocument,plan:planUnsDocument,apply:applyUnsDocument,validateChanges:validateUnsChanges,planChanges:planUnsChanges,applyChanges:applyUnsChanges,queryNodeData:queryUnsNodeData,writeNodeData:writeUnsNodeData,deleteNodeData:deleteUnsNodeData,queryPathData:queryUnsPathData,writePathData:writeUnsPathData,deletePathData:deleteUnsPathData,pointCurrent:getUnsPointCurrent,pathPointCurrent:getUnsPathPointCurrent,pointRealtimeConfig:getUnsPointRealtimeConfig,pathPointRealtimeConfig:getUnsPathPointRealtimeConfig,pointHistory:getUnsPointHistory,pathPointHistory:getUnsPathPointHistory,writePoint:writeUnsPoint,writePathPoint:writeUnsPathPoint,videoStreamOptions:getUnsVideoStreamOptions,pathVideoStreamOptions:getUnsPathVideoStreamOptions,videoSnapshot:createUnsVideoSnapshot,pathVideoSnapshot:createUnsPathVideoSnapshot,controlVideo:controlUnsVideo,controlPathVideo:controlUnsPathVideo,openPath:openUnsPath};
+import{ApiError as e}from"./shared.js";import{authHeaders as t,refreshRuntimeConfig as n,runtimeConfig as o,shouldRefreshUserToken as r}from"./runtime.js";import{WebSocket as a,WebSocketServer as i}from"ws";function s(e){return Object.fromEntries(Object.entries(e).filter(([,e])=>null!=e))}function c(e,t){return`/projects/${encodeURIComponent(e.projectId)}${t}`}function p(e,t,n,o){return c(e,`/uns/runtime/${t}/${encodeURIComponent(n)}/${o}`)}function u(e,t,n){const o=String(n||"").trim();if(!o)throw new TypeError("UNS path cannot be empty");return`${c(e,`/uns/runtime/path/${t}`)}?${new URLSearchParams({path:o})}`}function d(e,t){return new URL(`${e.baseUrl}/api/v1${t}`)}async function l(t){const n=await t.text();let o=null;try{o=n?JSON.parse(n):null}catch{throw new e(n||`platform UNS API returned ${t.status}`,{status:t.status,details:n})}if(!t.ok)throw new e(o?.message||n||`platform UNS API returned ${t.status}`,{status:t.status,code:"number"==typeof o?.code?o.code:void 0,details:o});if(!o||"object"!=typeof o)return o;if(void 0!==o.code&&0!==o.code||!1===o.success)throw new e(o.message||"platform UNS API failed",{status:t.status,code:"number"==typeof o.code?o.code:void 0,details:o});return o.data}async function h(a,i,{body:c,config:p}={}){let u=p||await o();for(let e=0;e<2;e+=1)try{const e="function"==typeof i?i(u):i,n=await fetch(d(u,e),{method:a,headers:t(u,void 0===c?void 0:"application/json"),body:void 0===c?void 0:JSON.stringify(s(c))});return await l(n)}catch(t){if(0===e&&r(t)){u=await n(u);continue}throw t}throw new e("platform UNS API failed")}export function getCurrentUnsSchema(){return h("GET","/uns/schemas/current")}export function getUnsSchema(e="1.0"){return h("GET",`/uns/schemas/${encodeURIComponent(e)}`)}export function listUnsSchemaBlocks(e="1.0"){return h("GET",`/uns/schemas/${encodeURIComponent(e)}/blocks`)}export function getUnsSchemaBlock(e,{version:t="1.0",depth:n=1}={}){return h("GET",`/uns/schemas/${encodeURIComponent(t)}/blocks/${encodeURIComponent(e)}?depth=${encodeURIComponent(n)}`)}export function getUnsProtocolSchema(e,{version:t="1.0"}={}){return h("GET",`/uns/schemas/${encodeURIComponent(t)}/blocks/collection-point/protocols/${encodeURIComponent(e)}`)}export async function discoverUnsResources({resourceTypes:e=[],protocols:t=[]}={}){const n=await o();return h("POST",c(n,"/uns/discover"),{body:{resourceTypes:e,protocols:t},config:n})}export async function searchUnsResources(e,t={}){const n=await o();return h("POST",c(n,"/uns/resources/search"),{body:{resourceType:e,protocol:t.protocol,keyword:t.keyword,selector:t.selector||{},page:t.page??1,pageSize:t.pageSize??t.page_size??20},config:n})}export async function listUnsBindings(){const e=await o();return h("GET",c(e,"/uns/bindings"),{config:e})}export async function resolveUnsPath(e){const t=await o();return h("GET",u(t,"resolve",e),{config:t})}export async function validateUnsDocument(e){const t=await o();return h("POST",c(t,"/uns/validate"),{body:{document:e},config:t})}export async function planUnsDocument(e){const t=await o();return h("POST",c(t,"/uns/plan"),{body:{document:e},config:t})}export async function applyUnsDocument(e,t={}){const n=String(t.expectedDocumentHash??t.expected_document_hash??"").trim(),r=String(t.expectedPlanHash??t.expected_plan_hash??"").trim();if(!0!==t.confirmed)throw new TypeError("UNS apply requires explicit confirmation");if(!n||!r)throw new TypeError("UNS apply requires document and plan hashes");const a=await o();return h("POST",c(a,"/uns/apply"),{body:{document:e,expectedDocumentHash:n,expectedPlanHash:r,confirmed:!0},config:a})}export async function validateUnsChanges(e){const t=await o();return h("POST",c(t,"/uns/changes/validate"),{body:{document:e},config:t})}export async function planUnsChanges(e){const t=await o();return h("POST",c(t,"/uns/changes/plan"),{body:{document:e},config:t})}export async function applyUnsChanges(e,t={}){const n=String(t.expectedDocumentHash??t.expected_document_hash??"").trim(),r=String(t.expectedPlanHash??t.expected_plan_hash??"").trim();if(!0!==t.confirmed)throw new TypeError("UNS changes apply requires explicit confirmation");if(!n||!r)throw new TypeError("UNS changes apply requires document and plan hashes");const a=await o();return h("POST",c(a,"/uns/changes/apply"),{body:{document:e,expectedDocumentHash:n,expectedPlanHash:r,confirmed:!0,impactConfirmed:!0===t.impactConfirmed||!0===t.impact_confirmed},config:a})}function f(e={}){return s({pageNum:e.pageNum??e.page_num??1,pageSize:e.pageSize??e.page_size??50,paginationMode:e.paginationMode??e.pagination_mode??"OFFSET",pageToken:e.pageToken??e.page_token})}export async function queryUnsNodeData(e,t={}){const n=await o();return h("POST",p(n,"nodes",e,"query"),{body:f(t),config:n})}function m(e,t){if(!0!==t)throw new TypeError("UNS data write requires explicit confirmation");if(!e||"object"!=typeof e||0===Object.keys(e).length)throw new TypeError("UNS data write field values cannot be empty")}export async function writeUnsNodeData(e,t,{confirmed:n=!1}={}){m(t,n);const r=await o();return h("POST",p(r,"nodes",e,"write"),{body:{fieldValues:t,environment:r.environment,confirmed:!0},config:r})}function y(e,t){if(!0!==t)throw new TypeError("UNS data deletion requires explicit confirmation");if(!Array.isArray(e)||0===e.length||e.some(e=>!e||"object"!=typeof e||Array.isArray(e)||0===Object.keys(e).length))throw new TypeError("UNS data deletion rows cannot be empty")}export async function deleteUnsNodeData(e,t,{confirmed:n=!1}={}){y(t,n);const r=await o();return h("POST",p(r,"nodes",e,"delete"),{body:{rows:t,confirmed:!0},config:r})}export async function queryUnsPathData(e,t={}){const n=await o();return h("POST",u(n,"data/query",e),{body:f(t),config:n})}export async function writeUnsPathData(e,t,{confirmed:n=!1}={}){m(t,n);const r=await o();return h("POST",u(r,"data/write",e),{body:{fieldValues:t,environment:r.environment,confirmed:!0},config:r})}export async function deleteUnsPathData(e,t,{confirmed:n=!1}={}){y(t,n);const r=await o();return h("POST",u(r,"data/delete",e),{body:{rows:t,confirmed:!0},config:r})}export async function getUnsPointCurrent(e){const t=await o();return h("GET",p(t,"points",e,"current"),{config:t})}export async function getUnsPathPointCurrent(e){const t=await o();return h("GET",u(t,"point/current",e),{config:t})}export async function getUnsPointRealtimeConfig(e){const t=await o();return h("GET",p(t,"points",e,"realtime-config"),{config:t})}export async function getUnsPathPointRealtimeConfig(e){const t=await o();return h("GET",u(t,"point/realtime-config",e),{config:t})}function g(e,t){if(null==e)return[];if(!Array.isArray(e))throw new TypeError(`${t} must be an array`);return e.map(String).map(e=>e.trim()).filter(Boolean)}function w(e,t){const n="string"==typeof e?e.trim():"";if(!n)throw new TypeError(`UNS point realtime config is missing ${t}`);return n}function U(e,t){return"string"==typeof e&&e.trim()?e.trim():t}function P(e){return"code"===e.kind?{code:e.value}:{path:e.value}}function S(e,t){e.readyState===a.OPEN&&e.send(JSON.stringify(t))}export function attachUnsPointRealtimeRelay(e={}){const t=e.server;if(!t||"function"!=typeof t.on||"function"!=typeof t.removeListener)throw new TypeError("UNS point realtime relay requires a Node HTTP server");const n=function(e){const t=String(e||"").trim();if(!t.startsWith("/")||t.includes("?")||t.includes("#"))throw new TypeError("UNS point realtime relay path must be an absolute path without query or hash");return t}(e.path),o=function(e){const t=g(e.codes??e.nodeCodes??e.node_codes,"codes"),n=g(e.paths,"paths"),o=[...t.map(e=>({kind:"code",value:e})),...n.map(e=>({kind:"path",value:e}))],r=new Map(o.map(e=>[`${e.kind}:${e.value}`,e]));if(0===r.size)throw new TypeError("UNS point realtime relay requires at least one code or path");return[...r.values()]}(e),r=new i({noServer:!0});let c=!1;const p=o.map(e=>({target:e,socket:null,reconnectTimer:null,reconnectAttempt:0,status:"connecting",statusMessage:void 0,lastMessage:null,messageFingerprints:new Set})),u=e=>s({type:"uns.point.status",target:P(e.target),status:e.status,message:e.statusMessage}),d=e=>{for(const t of r.clients)S(t,e)},l=(e,t,n)=>{e.status=t,e.statusMessage=n,d(u(e))},h=async e=>{if(c)return;let t,n;l(e,"connecting");try{const n="code"===e.target.kind?await getUnsPointRealtimeConfig(e.target.value):await getUnsPathPointRealtimeConfig(e.target.value);t=function(e){if(!e||"object"!=typeof e||Array.isArray(e))throw new TypeError("UNS point realtime config must be an object");const t=e.registration&&"object"==typeof e.registration&&!Array.isArray(e.registration)?e.registration:{},n=w(e.nodeCode,"nodeCode"),o=new URL(w(e.websocketUrl,"websocketUrl"));if("ws:"!==o.protocol&&"wss:"!==o.protocol)throw new TypeError("UNS point realtime websocketUrl must use ws or wss");const r=U(t.queryParameter,"clientKey");return o.searchParams.set(r,n),{nodeCode:n,websocketUrl:o.toString(),queryParameter:r,connectedType:U(t.connectedType,"CONNECTED"),registerType:U(t.registerType,"REGISTER"),registeredType:U(t.registeredType,"REGISTERED"),messageType:U(t.messageType,"UNS_POINT_MESSAGE"),pingType:U(t.pingType,"PING"),pongType:U(t.pongType,"PONG")}}(n)}catch{return void l(e,"error","无法获取 UNS 点位实时连接配置")}if(c)return;try{n=new a(t.websocketUrl)}catch{return void l(e,"error","无法建立数据工厂实时连接")}e.socket=n;let o=!1,r=!1;n.on("open",()=>{c||e.socket!==n||l(e,"connected")}),n.on("message",(i,s)=>{if(c||e.socket!==n)return;const p=function(e,t){if(t)return null;try{const t=JSON.parse(e.toString());return t&&"object"==typeof t&&!Array.isArray(t)?t:null}catch{return null}}(i,s);if(!p)return;const u="string"==typeof p.type?p.type:"";if(u===t.pingType)return void(n.readyState===a.OPEN&&n.send(JSON.stringify({type:t.pongType})));if(u===t.connectedType&&!o&&!r)return r=!0,void n.send(JSON.stringify({type:t.registerType,[t.queryParameter]:t.nodeCode}));if(u===t.registeredType)return o=!0,e.reconnectAttempt=0,void l(e,"registered");if(u!==t.messageType||!o)return;if(void 0!==p.nodeCode&&String(p.nodeCode)!==t.nodeCode)return void l(e,"error","数据工厂返回了不匹配的 UNS 点位消息");if(!function(e,t){const n=function(e){try{return JSON.stringify([e.nodeCode,e.topicName,e.receivedAt,e.status,e.message])}catch{return null}}(t);return!n||!e.messageFingerprints.has(n)&&(e.messageFingerprints.add(n),e.messageFingerprints.size>256&&e.messageFingerprints.delete(e.messageFingerprints.values().next().value),!0)}(e,p))return;const h={type:"uns.point.message",target:P(e.target),payload:p};e.lastMessage=h,d(h)}),n.on("error",()=>{c||e.socket!==n||l(e,"error","数据工厂实时连接失败")}),n.on("close",t=>{e.socket===n&&(e.socket=null,o=!1,c||(1e3!==t&&1001!==t?((e,t)=>{if(c||e.reconnectTimer)return;e.reconnectAttempt+=1;const n=Math.min(3e4,500*2**Math.min(e.reconnectAttempt-1,6)),o=Math.round(n*(.75+.5*Math.random()));l(e,"reconnecting","数据工厂实时连接已断开，正在重连"),e.reconnectTimer=setTimeout(()=>{e.reconnectTimer=null,t(e)},o)})(e,h):l(e,"disconnected")))})};r.on("connection",e=>{for(const t of p)S(e,u(t)),t.lastMessage&&S(e,t.lastMessage)});const f=(e,t,o)=>{let a;try{a=new URL(e.url||"/",`http://${e.headers.host||"localhost"}`).pathname}catch{return}a===n&&r.handleUpgrade(e,t,o,t=>{r.emit("connection",t,e)})};t.on("upgrade",f);for(const e of p)h(e);return()=>{if(!c){c=!0,t.removeListener("upgrade",f);for(const e of p)e.reconnectTimer&&clearTimeout(e.reconnectTimer),!e.socket||e.socket.readyState!==a.OPEN&&e.socket.readyState!==a.CONNECTING||e.socket.close(1001,"relay closed"),e.socket=null;for(const e of r.clients)e.close(1001,"relay closed");r.close()}}}function T(e={}){return{startTime:e.startTime??e.start_time,endTime:e.endTime??e.end_time,page:e.page??1,pageSize:e.pageSize??e.page_size??100}}export async function getUnsPointHistory(e,t){const n=await o();return h("POST",p(n,"points",e,"history"),{body:T(t),config:n})}export async function getUnsPathPointHistory(e,t){const n=await o();return h("POST",u(n,"point/history",e),{body:T(t),config:n})}function v(e,t={}){const n=String(t.reason||"").trim(),o=String(t.ticket||"").trim(),r=t.dryRun??t.dry_run??!1,a=t.confirmed??!1;if(!r&&!0!==a)throw new TypeError("UNS point write requires explicit confirmation");if(!n||!o)throw new TypeError("UNS point write requires reason and ticket");return s({value:e,reason:n,ticket:o,requestId:t.requestId??t.request_id,dryRun:r,confirmed:a})}export async function writeUnsPoint(e,t,n={}){const r=v(t,n),a=await o();return h("POST",p(a,"points",e,"write"),{body:r,config:a})}export async function writeUnsPathPoint(e,t,n={}){const r=v(t,n),a=await o();return h("POST",u(a,"point/write",e),{body:r,config:a})}export async function getUnsVideoStreamOptions(e){const t=await o();return h("GET",p(t,"videos",e,"stream-options"),{config:t})}export async function getUnsPathVideoStreamOptions(e){const t=await o();return h("GET",u(t,"video/stream-options",e),{config:t})}export async function createUnsVideoSnapshot(e){const t=await o();return h("POST",p(t,"videos",e,"snapshot"),{config:t})}export async function createUnsPathVideoSnapshot(e){const t=await o();return h("POST",u(t,"video/snapshot",e),{config:t})}function x(e,t={}){if(!0!==t.confirmed)throw new TypeError("UNS video control requires explicit confirmation");return{action:e,parameters:t.parameters||{},confirmed:!0}}export async function controlUnsVideo(e,t,n={}){const r=x(t,n),a=await o();return h("POST",p(a,"videos",e,"control"),{body:r,config:a})}export async function controlUnsPathVideo(e,t,n={}){const r=x(t,n),a=await o();return h("POST",u(a,"video/control",e),{body:r,config:a})}export class UnsPathNode{constructor(e){if(this.path=String(e||"").trim(),!this.path)throw new TypeError("UNS path cannot be empty")}resolve(){return resolveUnsPath(this.path)}queryData(e){return queryUnsPathData(this.path,e)}writeData(e,t){return writeUnsPathData(this.path,e,t)}deleteData(e,t){return deleteUnsPathData(this.path,e,t)}pointCurrent(){return getUnsPathPointCurrent(this.path)}pointRealtimeConfig(){return getUnsPathPointRealtimeConfig(this.path)}pointHistory(e){return getUnsPathPointHistory(this.path,e)}writePoint(e,t){return writeUnsPathPoint(this.path,e,t)}videoStreamOptions(){return getUnsPathVideoStreamOptions(this.path)}videoSnapshot(){return createUnsPathVideoSnapshot(this.path)}controlVideo(e,t){return controlUnsPathVideo(this.path,e,t)}}export function openUnsPath(e){return new UnsPathNode(e)}export const uns={schemaCurrent:getCurrentUnsSchema,schema:getUnsSchema,schemaBlocks:listUnsSchemaBlocks,schemaBlock:getUnsSchemaBlock,protocolSchema:getUnsProtocolSchema,discover:discoverUnsResources,searchResources:searchUnsResources,bindings:listUnsBindings,resolvePath:resolveUnsPath,validate:validateUnsDocument,plan:planUnsDocument,apply:applyUnsDocument,validateChanges:validateUnsChanges,planChanges:planUnsChanges,applyChanges:applyUnsChanges,queryNodeData:queryUnsNodeData,writeNodeData:writeUnsNodeData,deleteNodeData:deleteUnsNodeData,queryPathData:queryUnsPathData,writePathData:writeUnsPathData,deletePathData:deleteUnsPathData,pointCurrent:getUnsPointCurrent,pathPointCurrent:getUnsPathPointCurrent,pointRealtimeConfig:getUnsPointRealtimeConfig,pathPointRealtimeConfig:getUnsPathPointRealtimeConfig,attachPointRealtimeRelay:attachUnsPointRealtimeRelay,pointHistory:getUnsPointHistory,pathPointHistory:getUnsPathPointHistory,writePoint:writeUnsPoint,writePathPoint:writeUnsPathPoint,videoStreamOptions:getUnsVideoStreamOptions,pathVideoStreamOptions:getUnsPathVideoStreamOptions,videoSnapshot:createUnsVideoSnapshot,pathVideoSnapshot:createUnsPathVideoSnapshot,controlVideo:controlUnsVideo,controlPathVideo:controlUnsPathVideo,openPath:openUnsPath};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmlckj/licos-platform-sdk",
-  "version": "0.8.6",
+  "version": "0.10.0",
   "description": "LICOS platform SDK package shell for browser and Node runtimes",
   "author": "kmlckj",
   "type": "module",
@@ -34,12 +34,15 @@
     "dist",
     "README.md"
   ],
-  "scripts": {
+  "scripts": {
     "build": "node build.mjs",
     "prepack": "npm run build",
     "test": "node --test"
-  },
-  "devDependencies": {
+  },
+  "dependencies": {
+    "ws": "8.21.1"
+  },
+  "devDependencies": {
     "terser": "5.48.0"
   },
   "license": "MIT",