@helioslx/core 0.2.0

package/dist/http.d.ts

@@ -0,0 +1,643 @@
+import { F as ViewerPacket, O as SacnSourceContract, R as ViewerServiceContract, b as OutputSnapshot, c as EngineTelemetry } from "./contracts-C4kpAdZq.js";
+import { Elysia } from "elysia";
+//#region src/http.d.ts
+interface HttpAuthContext {
+  readonly request: Request;
+}
+type HttpAuthHook = (context: HttpAuthContext) => boolean | Response | void | Promise<boolean | Response | void>;
+interface SacnHttpAdapterOptions {
+  readonly source: SacnSourceContract;
+  readonly viewer?: ViewerServiceContract;
+  /** Defaults to `/sacn`. */
+  readonly prefix?: string;
+  /** Authentication hook; returning false produces 401, and Response is forwarded. */
+  readonly auth?: HttpAuthHook;
+  /** Called for every normalized viewer packet; useful for WebSocket/SSE bridges. */
+  readonly onViewerPacket?: (packet: ViewerPacket) => void;
+  /** Value used by deprecated compatibility routes. */
+  readonly sunset?: string;
+  /** OpenAPI document path. Defaults to `/openapi`. */
+  readonly openapiPath?: string;
+  /** Maximum concurrent viewer WebSocket clients. Defaults to 64. */
+  readonly maxWebSocketClients?: number;
+  /** Coalesced packet queue per WebSocket client. Defaults to 32 universes. */
+  readonly webSocketQueueCapacity?: number;
+}
+/**
+ * Creates an unbound Elysia route plugin. CORS and server binding deliberately
+ * remain the host application's responsibility.
+ */
+declare const createSacnHttpAdapter: (options: SacnHttpAdapterOptions) => Elysia<string, {
+  decorator: {};
+  store: {};
+  derive: {};
+  resolve: {};
+}, {
+  typebox: {};
+  error: {};
+} & {
+  typebox: {};
+  error: {};
+}, {
+  schema: {};
+  standaloneSchema: {};
+  macro: {};
+  macroFn: {};
+  parser: {};
+  response: {};
+} & {
+  schema: {};
+  standaloneSchema: {};
+  macro: {};
+  macroFn: {};
+  parser: {};
+  response: {};
+}, {
+  [x: string]: {};
+} & {
+  [x: string]: {
+    health: {
+      live: {
+        get: {
+          body: unknown;
+          params: {};
+          query: unknown;
+          headers: unknown;
+          response: {
+            200: {
+              status: "ok";
+            };
+            422: {
+              type: 'validation';
+              on: string;
+              summary?: string;
+              message?: string;
+              found?: unknown;
+              property?: string;
+              expected?: string;
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    health: {
+      ready: {
+        get: {
+          body: unknown;
+          params: {};
+          query: unknown;
+          headers: unknown;
+          response: {
+            200: {
+              status: "ready";
+            };
+            422: {
+              type: 'validation';
+              on: string;
+              summary?: string;
+              message?: string;
+              found?: unknown;
+              property?: string;
+              expected?: string;
+            };
+            503: {
+              status: "not-ready";
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    universes: {
+      get: {
+        body: unknown;
+        params: {};
+        query: unknown;
+        headers: unknown;
+        response: {
+          200: readonly OutputSnapshot[] | Response | {
+            error: string;
+          } | {
+            error: string;
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    engine: {
+      telemetry: {
+        get: {
+          body: unknown;
+          params: {};
+          query: unknown;
+          headers: unknown;
+          response: {
+            200: EngineTelemetry | Response | {
+              error: string;
+            } | {
+              error: string;
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    universes: {
+      ":universe": {
+        priorities: {
+          ":priority": {
+            get: {
+              body: unknown;
+              params: {
+                universe: string;
+                priority: string;
+              };
+              query: unknown;
+              headers: unknown;
+              response: {
+                200: OutputSnapshot | Response | {
+                  error: string;
+                } | {
+                  error: string;
+                };
+                422: {
+                  type: 'validation';
+                  on: string;
+                  summary?: string;
+                  message?: string;
+                  found?: unknown;
+                  property?: string;
+                  expected?: string;
+                };
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    universes: {
+      ":universe": {
+        priorities: {
+          ":priority": {
+            put: {
+              body: {
+                cid?: string;
+                idleFps?: number;
+                sourceName?: string;
+                initialValues?: number[];
+                values?: number[];
+                durationMs?: number;
+              };
+              params: {
+                universe: string;
+                priority: string;
+              };
+              query: unknown;
+              headers: unknown;
+              response: {
+                200: OutputSnapshot | Response | {
+                  error: string;
+                } | {
+                  error: string;
+                };
+                422: {
+                  type: 'validation';
+                  on: string;
+                  summary?: string;
+                  message?: string;
+                  found?: unknown;
+                  property?: string;
+                  expected?: string;
+                };
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    universes: {
+      ":universe": {
+        priorities: {
+          ":priority": {
+            channels: {
+              post: {
+                body: {
+                  cid?: string;
+                  idleFps?: number;
+                  sourceName?: string;
+                  channels: {
+                    channel: number;
+                    value: number;
+                    durationMs?: number;
+                  }[] | {
+                    [x: string]: number;
+                  };
+                  durationMs?: number;
+                } | {
+                  cid?: string;
+                  idleFps?: number;
+                  sourceName?: string;
+                  changes: {
+                    channel: number;
+                    value: number;
+                    durationMs?: number;
+                  }[];
+                  durationMs?: number;
+                };
+                params: {
+                  universe: string;
+                  priority: string;
+                };
+                query: unknown;
+                headers: unknown;
+                response: {
+                  200: OutputSnapshot | Response | {
+                    error: string;
+                  } | {
+                    error: string;
+                  };
+                  422: {
+                    type: 'validation';
+                    on: string;
+                    summary?: string;
+                    message?: string;
+                    found?: unknown;
+                    property?: string;
+                    expected?: string;
+                  };
+                };
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    universes: {
+      ":universe": {
+        priorities: {
+          ":priority": {
+            frame: {
+              post: {
+                body: {
+                  cid?: string;
+                  idleFps?: number;
+                  sourceName?: string;
+                  values: number[];
+                  durationMs?: number;
+                };
+                params: {
+                  universe: string;
+                  priority: string;
+                };
+                query: unknown;
+                headers: unknown;
+                response: {
+                  200: OutputSnapshot | Response | {
+                    error: string;
+                  } | {
+                    error: string;
+                  };
+                  422: {
+                    type: 'validation';
+                    on: string;
+                    summary?: string;
+                    message?: string;
+                    found?: unknown;
+                    property?: string;
+                    expected?: string;
+                  };
+                };
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    universes: {
+      ":universe": {
+        priorities: {
+          ":priority": {
+            delete: {
+              body: unknown;
+              params: {
+                universe: string;
+                priority: string;
+              };
+              query: unknown;
+              headers: unknown;
+              response: {
+                200: Response | {
+                  error: string;
+                } | {
+                  error: string;
+                } | {
+                  ok: true;
+                };
+                422: {
+                  type: 'validation';
+                  on: string;
+                  summary?: string;
+                  message?: string;
+                  found?: unknown;
+                  property?: string;
+                  expected?: string;
+                };
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    outputs: {
+      get: {
+        body: unknown;
+        params: {};
+        query: unknown;
+        headers: unknown;
+        response: {
+          200: readonly OutputSnapshot[] | Response | {
+            error: string;
+          } | {
+            error: string;
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    telemetry: {
+      get: {
+        body: unknown;
+        params: {};
+        query: unknown;
+        headers: unknown;
+        response: {
+          200: EngineTelemetry | Response | {
+            error: string;
+          } | {
+            error: string;
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    outputs: {
+      ":universe": {
+        ":priority": {
+          get: {
+            body: unknown;
+            params: {
+              universe: string;
+              priority: string;
+            };
+            query: unknown;
+            headers: unknown;
+            response: {
+              200: OutputSnapshot | Response | {
+                error: string;
+              } | {
+                error: string;
+              };
+              422: {
+                type: 'validation';
+                on: string;
+                summary?: string;
+                message?: string;
+                found?: unknown;
+                property?: string;
+                expected?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    outputs: {
+      ":universe": {
+        ":priority": {
+          put: {
+            body: {
+              cid?: string;
+              idleFps?: number;
+              sourceName?: string;
+              initialValues?: number[];
+              values?: number[];
+              durationMs?: number;
+            };
+            params: {
+              universe: string;
+              priority: string;
+            };
+            query: unknown;
+            headers: unknown;
+            response: {
+              200: OutputSnapshot | Response | {
+                error: string;
+              } | {
+                error: string;
+              };
+              422: {
+                type: 'validation';
+                on: string;
+                summary?: string;
+                message?: string;
+                found?: unknown;
+                property?: string;
+                expected?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    outputs: {
+      ":universe": {
+        ":priority": {
+          channels: {
+            post: {
+              body: {
+                cid?: string;
+                idleFps?: number;
+                sourceName?: string;
+                channels: {
+                  channel: number;
+                  value: number;
+                  durationMs?: number;
+                }[] | {
+                  [x: string]: number;
+                };
+                durationMs?: number;
+              } | {
+                cid?: string;
+                idleFps?: number;
+                sourceName?: string;
+                changes: {
+                  channel: number;
+                  value: number;
+                  durationMs?: number;
+                }[];
+                durationMs?: number;
+              };
+              params: {
+                universe: string;
+                priority: string;
+              };
+              query: unknown;
+              headers: unknown;
+              response: {
+                200: OutputSnapshot | Response | {
+                  error: string;
+                } | {
+                  error: string;
+                };
+                422: {
+                  type: 'validation';
+                  on: string;
+                  summary?: string;
+                  message?: string;
+                  found?: unknown;
+                  property?: string;
+                  expected?: string;
+                };
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    outputs: {
+      ":universe": {
+        ":priority": {
+          frame: {
+            post: {
+              body: {
+                cid?: string;
+                idleFps?: number;
+                sourceName?: string;
+                values: number[];
+                durationMs?: number;
+              };
+              params: {
+                universe: string;
+                priority: string;
+              };
+              query: unknown;
+              headers: unknown;
+              response: {
+                200: OutputSnapshot | Response | {
+                  error: string;
+                } | {
+                  error: string;
+                };
+                422: {
+                  type: 'validation';
+                  on: string;
+                  summary?: string;
+                  message?: string;
+                  found?: unknown;
+                  property?: string;
+                  expected?: string;
+                };
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    outputs: {
+      ":universe": {
+        ":priority": {
+          delete: {
+            body: unknown;
+            params: {
+              universe: string;
+              priority: string;
+            };
+            query: unknown;
+            headers: unknown;
+            response: {
+              200: Response | {
+                error: string;
+              } | {
+                error: string;
+              } | {
+                ok: true;
+              };
+              422: {
+                type: 'validation';
+                on: string;
+                summary?: string;
+                message?: string;
+                found?: unknown;
+                property?: string;
+                expected?: string;
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {};
+}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {
+    200: Response | {
+      error: string;
+    } | {
+      error: string;
+    };
+  };
+}>;
+/** Connects viewer packets to a host-owned WebSocket or SSE implementation. */
+declare const subscribeViewerPackets: (viewer: ViewerServiceContract, listener: (packet: ViewerPacket) => void) => (() => void);
+//#endregion
+export { HttpAuthContext, HttpAuthHook, SacnHttpAdapterOptions, createSacnHttpAdapter, subscribeViewerPackets };
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","names":[],"sources":["../src/http.ts"],"mappings":";;;UAqBiB;WACN,SAAS;;KAGR,gBACV,SAAS,8BACI,kBAAkB,kBAAkB;UAElC;WACN,QAAQ;WACR,SAAS;;WAET;;WAEA,OAAO;;WAEP,kBAAkB,QAAQ;;WAE1B;;WAEA;;WAEA;;WAEA;;;;;;cAsXE,wBAAqB,SAAa,2BAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAAtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsqBlC,yBAAsB,QACzB,uBAAqB,WAClB,QAAQ"}