@ignitify-integrations/stream 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,9 @@
+ignitify integrations
+Copyright 2026 The ignitify integrations authors
+
+This product includes software developed by the ignitify integrations authors.
+
+integrations/stream serves hls.js (https://github.com/video-dev/hls.js), Apache-2.0, from its npm package at run time.
+integrations/stream drives ffmpeg (https://ffmpeg.org) as a separate process. ffmpeg is not distributed by this project;
+it is installed in the task image as a system package and keeps its own licence (LGPL-2.1-or-later, or GPL when
+built with GPL components).

package/README.md

@@ -1,3 +1,60 @@
-# Temporary Holding Version
+# stream
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Let a task serve a live audio or video stream that viewers open in any browser. ffmpeg does the media work; this package does the platform plumbing (server, player page, viewer link, progress, stop on cancel).
+
+## Add it
+
+```bash
+ignitify integration:add stream --task live
+```
+
+The plan line says `runs ffmpeg`. The plan adds `ffmpeg` to `build.system_packages`, a bidirectional network with port 8080 and the route `/live/`, a long continuous execution, and at least the `std.medium` preset.
+
+**You add one host** when the source is an `https://` URL: the source host (for example `raw.githubusercontent.com`) in `execution.network.egress_allow`. A file on the VM needs no host.
+
+## Use it
+
+```ts
+import { stream } from '@ignitify-integrations/stream';
+
+export async function run(payload, ctx) {
+  return stream(ctx, { source: payload.url, seconds: payload.seconds });
+}
+```
+
+The first chunk the caller gets is `{ status: 'live', watch, playlist }`. A viewer opens `watch` (the deployment's public host + `/live/`). Then progress chunks follow: `{ status: 'streaming', time_s, of_s, speed }`, at most every 2 s.
+
+| Option          | Default              | Meaning                                                                                                                       |
+| :-------------- | :------------------- | :---------------------------------------------------------------------------------------------------------------------------- |
+| `source`        | —                    | `https://` URL, or an absolute file path on the VM                                                                            |
+| `profile`       | `'video'`            | `'video'` (x264 + AAC) or `'audio'` (AAC only)                                                                                |
+| `seconds`       | whole source         | Stop after this many seconds; `run.timeout_sec` is the safety stop                                                            |
+| `height`        | 480                  | Output height in pixels (1–2160); ignored for `audio`                                                                         |
+| `startDelaySec` | 0                    | Serve the player first, start the stream later                                                                                |
+| `after`         | `'replay'`           | `'replay'`: keep serving the recording until cancel (or `lingerSec`). `'stop'`: return when ffmpeg ends                       |
+| `lingerSec`     | none                 | With `replay`: stop this long after the end                                                                                   |
+| `route`, `port` | `'/live/'`, 8080     | Must equal `inbound_routes` and `inbound_port` in `task.yaml`                                                                 |
+| `ffmpegArgs`    | —                    | `(defaults, paths) => args`: change the encoder arguments. Keep `-progress pipe:1` and write the playlist to `paths.playlist` |
+| `onProgress`    | —                    | Called for every ffmpeg progress report                                                                                       |
+| `signal`        | `SIGTERM` / `SIGINT` | An `AbortSignal` that stops the stream                                                                                        |
+
+The result is `{ success: true, stage: 'streamed', cancelled, watch, streamed_s, height, wall_ms }`, or `{ success: true, cancelled: true, stage: 'before-stream' }` when it is stopped during the start delay. A failed ffmpeg run throws, with the end of ffmpeg's error output in the message.
+
+## Grow your task
+
+- **A radio-style stream.** Use `profile: 'audio'`.
+- **Give viewers time to join.** Use `startDelaySec`, and send the link first: `watchUrl(ctx)` returns it before the stream starts (for example, in a chat message).
+- **Keep the recording.** Use `after: 'stop'`; the playlist and segments stay in `$HOME/hls` until the next stream starts. To return one playable link, upload each segment with [`s3-storage`](https://github.com/ignitify-dev/ignitify-integrations/tree/master/integrations/s3-storage)'s `put` under one prefix, keeping its file name (`key: 'rec/<file>'`), then the playlist with `putAndLink` and the same prefix, and return that link. The player fetches the segments by plain URL, so the prefix must allow public read. With a private bucket, return one link per file.
+- **Your own encoding.** Change bitrate, codec or filters with `ffmpegArgs`; the package still runs the server and the progress.
+- **React to progress.** Use `onProgress`, for example to stop early on a condition with your own `AbortController` and `signal`.
+
+## Limits
+
+- Serves **HLS over HTTPS** only, with a few seconds of delay. It reads the source over HTTPS or from disk.
+- **No ingest.** Inbound is HTTPS only, so RTMP, SRT and WebRTC cannot reach the task. You cannot stream from OBS into a task.
+- **One stream per task, for a small audience.** Many viewers need a CDN or a media server.
+- The memory need of the `audio` profile is not measured; the minimum preset stays `std.medium`.
+
+## Licence of ffmpeg
+
+FFmpeg is LGPL-2.1-or-later; builds with libx264 (as distribution builds are) are GPL. This package runs the OS package unmodified as a separate process and links none of it. hls.js (Apache-2.0) is an npm dependency, served from `node_modules`.

package/dist/constants.d.ts

@@ -0,0 +1,67 @@
+/** Must equal the manifest's `inbound_routes` prefix and `inbound_port`; the CLI writes these. */
+export declare const DEFAULT_ROUTE = "/live/";
+export declare const DEFAULT_PORT = 8080;
+export declare const DEFAULT_HEIGHT = 480;
+export declare const PROFILES: readonly ["video", "audio"];
+export declare const AFTER_MODES: readonly ["replay", "stop"];
+/** 4K. Above it a live x264 encode does not fit any sold preset. */
+export declare const HEIGHT_MAX = 2160;
+/**
+ * Same rule as the manifest schema's route prefix: starts and ends with "/", is not "/" itself.
+ * It also keeps the route safe to inline in the player page (no quotes or angle brackets).
+ */
+export declare const ROUTE_PATTERN: RegExp;
+export declare const HTTPS = "https:";
+export declare const FFMPEG_BIN = "ffmpeg";
+/** The VM has no /tmp: the only writable disk is the scratch disk, which is the task's HOME. */
+export declare const SCRATCH_HOME_FALLBACK = "/mnt/scratch";
+export declare const HLS_SUBDIR = "hls";
+export declare const PLAYLIST_FILE = "index.m3u8";
+/** hls.js is served from the installed package, so a viewer's browser needs no third-party CDN. */
+export declare const PLAYER_SCRIPT_FILE = "hls.min.js";
+export declare const HLS_JS_DIST = "hls.js/dist/hls.min.js";
+/** ffmpeg writes MPEG-TS segments for both profiles (an audio-only HLS output is `.ts` too). */
+export declare const MEDIA_TYPES: Readonly<Record<string, string>>;
+export declare const HTML_TYPE = "text/html; charset=utf-8";
+export declare const SCRIPT_TYPE = "text/javascript; charset=utf-8";
+export declare const NO_CACHE = "no-cache";
+/** ffmpeg names its files from the playlist stem: `index.m3u8`, `index0.ts`, … */
+export declare const MEDIA_STEM_PATTERN: RegExp;
+export declare const READ_METHODS: readonly string[];
+/** One progress chunk + metric per interval; the last report is always sent. */
+export declare const PROGRESS_EVERY_MS = 2000;
+/** How often the player page asks whether the playlist exists yet. */
+export declare const PLAYER_POLL_MS = 2000;
+export declare const STDERR_TAIL_CHARS = 2000;
+export declare const METRIC_STREAMED_SECONDS = "streamed_seconds";
+export declare const MS_PER_SEC = 1000;
+export declare const US_PER_SEC = 1000000;
+/** Chunk times are rounded to tenths of a second: enough for a progress bar, short on the wire. */
+export declare const TIME_DECIMALS = 1;
+export declare const STATUS: {
+    readonly live: "live";
+    readonly waiting: "waiting";
+    readonly streaming: "streaming";
+    readonly ended: "ended";
+};
+export declare const MESSAGES: {
+    readonly progressHandlerFailed: (error: unknown) => string;
+    readonly badSource: (source: unknown) => string;
+    readonly badProfile: (profile: unknown) => string;
+    readonly badAfter: (after: unknown) => string;
+    readonly badPositive: (name: string, value: unknown) => string;
+    readonly badNonNegative: (name: string, value: unknown) => string;
+    readonly badHeight: (value: unknown) => string;
+    readonly badPort: (value: unknown) => string;
+    readonly badRoute: (value: unknown) => string;
+    readonly badFunction: (name: string) => string;
+    readonly lingerNeedsReplay: "lingerSec applies only with after: 'replay'";
+    readonly ffmpegMissing: "ffmpeg is not installed: add it to build.system_packages in task.yaml";
+    readonly ffmpegFailed: (code: number | null, tail: string) => string;
+    readonly serving: (route: string, port: number, watch: string | null) => string;
+    readonly waiting: (sec: number) => string;
+    readonly ended: (replayUntil: string) => string;
+    readonly replayUntilCancel: "run:cancel";
+    readonly replayUntilLinger: (sec: number) => string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA,kGAAkG;AAClG,eAAO,MAAM,aAAa,WAAW,CAAC;AACtC,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,eAAO,MAAM,QAAQ,6BAA8B,CAAC;AACpD,eAAO,MAAM,WAAW,6BAA8B,CAAC;AAEvD,oEAAoE;AACpE,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAmC,CAAC;AAE9D,eAAO,MAAM,KAAK,WAAW,CAAC;AAC9B,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AACpD,eAAO,MAAM,UAAU,QAAQ,CAAC;AAChC,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAC/C,eAAO,MAAM,WAAW,2BAA2B,CAAC;AAEpD,gGAAgG;AAChG,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGxD,CAAC;AACF,eAAO,MAAM,SAAS,6BAA6B,CAAC;AACpD,eAAO,MAAM,WAAW,mCAAmC,CAAC;AAC5D,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,QAAqB,CAAC;AACrD,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAoB,CAAC;AAE/D,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,sEAAsE;AACtE,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,eAAO,MAAM,UAAU,OAAO,CAAC;AAC/B,eAAO,MAAM,UAAU,UAAY,CAAC;AACpC,mGAAmG;AACnG,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAEX,eAAO,MAAM,QAAQ;4CACY,OAAO;iCAElB,OAAO;mCAEL,OAAO;+BACX,OAAO;iCACL,MAAM,SAAS,OAAO;oCACnB,MAAM,SAAS,OAAO;gCAC1B,OAAO;8BACT,OAAO;+BAEN,OAAO;iCAEL,MAAM;;;kCAGL,MAAM,GAAG,IAAI,QAAQ,MAAM;8BAC/B,MAAM,QAAQ,MAAM,SAAS,MAAM,GAAG,IAAI;4BAE5C,MAAM;kCACA,MAAM;;sCAEF,MAAM;CACvB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,72 @@
+// Defaults, limits and messages of the stream integration. A change here is a code change, not config.
+import { INBOUND_PORT_MAX, INBOUND_PORT_MIN, ROUTE_PREFIX_PATTERN } from '@ignitify-integrations/runtime';
+/** Must equal the manifest's `inbound_routes` prefix and `inbound_port`; the CLI writes these. */
+export const DEFAULT_ROUTE = '/live/';
+export const DEFAULT_PORT = 8080;
+export const DEFAULT_HEIGHT = 480;
+export const PROFILES = ['video', 'audio'];
+export const AFTER_MODES = ['replay', 'stop'];
+/** 4K. Above it a live x264 encode does not fit any sold preset. */
+export const HEIGHT_MAX = 2160;
+/**
+ * Same rule as the manifest schema's route prefix: starts and ends with "/", is not "/" itself.
+ * It also keeps the route safe to inline in the player page (no quotes or angle brackets).
+ */
+export const ROUTE_PATTERN = new RegExp(ROUTE_PREFIX_PATTERN);
+export const HTTPS = 'https:';
+export const FFMPEG_BIN = 'ffmpeg';
+/** The VM has no /tmp: the only writable disk is the scratch disk, which is the task's HOME. */
+export const SCRATCH_HOME_FALLBACK = '/mnt/scratch';
+export const HLS_SUBDIR = 'hls';
+export const PLAYLIST_FILE = 'index.m3u8';
+/** hls.js is served from the installed package, so a viewer's browser needs no third-party CDN. */
+export const PLAYER_SCRIPT_FILE = 'hls.min.js';
+export const HLS_JS_DIST = 'hls.js/dist/hls.min.js';
+/** ffmpeg writes MPEG-TS segments for both profiles (an audio-only HLS output is `.ts` too). */
+export const MEDIA_TYPES = {
+    '.m3u8': 'application/vnd.apple.mpegurl',
+    '.ts': 'video/mp2t',
+};
+export const HTML_TYPE = 'text/html; charset=utf-8';
+export const SCRIPT_TYPE = 'text/javascript; charset=utf-8';
+export const NO_CACHE = 'no-cache';
+/** ffmpeg names its files from the playlist stem: `index.m3u8`, `index0.ts`, … */
+export const MEDIA_STEM_PATTERN = /^[A-Za-z0-9_-]+$/;
+export const READ_METHODS = ['GET', 'HEAD'];
+/** One progress chunk + metric per interval; the last report is always sent. */
+export const PROGRESS_EVERY_MS = 2000;
+/** How often the player page asks whether the playlist exists yet. */
+export const PLAYER_POLL_MS = 2000;
+export const STDERR_TAIL_CHARS = 2000;
+export const METRIC_STREAMED_SECONDS = 'streamed_seconds';
+export const MS_PER_SEC = 1000;
+export const US_PER_SEC = 1_000_000;
+/** Chunk times are rounded to tenths of a second: enough for a progress bar, short on the wire. */
+export const TIME_DECIMALS = 1;
+export const STATUS = {
+    live: 'live',
+    waiting: 'waiting',
+    streaming: 'streaming',
+    ended: 'ended',
+};
+export const MESSAGES = {
+    progressHandlerFailed: (error) => `onProgress threw, the stream goes on: ${error instanceof Error ? error.message : String(error)}`,
+    badSource: (source) => `source ${JSON.stringify(source)} must be an https:// URL or an absolute file path (use path.resolve for a relative one)`,
+    badProfile: (profile) => `profile ${JSON.stringify(profile)} must be one of ${PROFILES.join(', ')}`,
+    badAfter: (after) => `after ${JSON.stringify(after)} must be one of ${AFTER_MODES.join(', ')}`,
+    badPositive: (name, value) => `${name} ${JSON.stringify(value)} must be a number above 0`,
+    badNonNegative: (name, value) => `${name} ${JSON.stringify(value)} must be a number of 0 or more`,
+    badHeight: (value) => `height ${JSON.stringify(value)} must be an integer from 1 to ${HEIGHT_MAX}`,
+    badPort: (value) => `port ${JSON.stringify(value)} must be an integer from ${INBOUND_PORT_MIN} to ${INBOUND_PORT_MAX}`,
+    badRoute: (value) => `route ${JSON.stringify(value)} must start and end with "/", must not be "/", and must match ${ROUTE_PATTERN}`,
+    badFunction: (name) => `${name} must be a function`,
+    lingerNeedsReplay: `lingerSec applies only with after: 'replay'`,
+    ffmpegMissing: `ffmpeg is not installed: add it to build.system_packages in task.yaml`,
+    ffmpegFailed: (code, tail) => `ffmpeg exited with ${code ?? 'a signal'}: ${tail}`,
+    serving: (route, port, watch) => `serving ${route} on :${port}${watch === null ? '' : `, public at ${watch}`}`,
+    waiting: (sec) => `streaming starts in ${sec} s`,
+    ended: (replayUntil) => `stream ended; serving the replay until ${replayUntil}`,
+    replayUntilCancel: 'run:cancel',
+    replayUntilLinger: (sec) => `${sec} s`,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/ffmpeg-args.d.ts

@@ -0,0 +1,10 @@
+import type { StreamConfig } from './options.js';
+/** Where the engine writes. The HLS folder is the only folder the server reads from. */
+export interface StreamPaths {
+    readonly hlsDir: string;
+    readonly playlist: string;
+}
+export type FfmpegArgsFn = (defaults: readonly string[], paths: StreamPaths) => readonly string[];
+/** The arguments ffmpeg runs with: the profile, passed through the task's `ffmpegArgs` if it has one. */
+export declare const ffmpegArgs: (config: Pick<StreamConfig, "source" | "seconds" | "height" | "profile" | "ffmpegArgs">, paths: StreamPaths) => readonly string[];
+//# sourceMappingURL=ffmpeg-args.d.ts.map

package/dist/ffmpeg-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg-args.d.ts","sourceRoot":"","sources":["../src/ffmpeg-args.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,KAAK,SAAS,MAAM,EAAE,CAAC;AA2DlG,yGAAyG;AACzG,eAAO,MAAM,UAAU,GACrB,QAAQ,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC,EACtF,OAAO,WAAW,KACjB,SAAS,MAAM,EAGjB,CAAC"}

package/dist/ffmpeg-args.js

@@ -0,0 +1,56 @@
+// The engine arguments: one pure profile per output kind. This is the only media logic of this integration,
+// and a task can change or replace it with the `ffmpegArgs` option.
+const AUDIO_CODEC = ['-c:a', 'aac', '-b:a', '128k'];
+// `-progress pipe:1` feeds the progress reports; a replacement must keep it to keep them.
+// `-re` reads at playback speed, so the stream is live, not a fast transcode.
+const input = (p) => [
+    '-hide_banner',
+    '-nostats',
+    '-loglevel',
+    'error',
+    '-progress',
+    'pipe:1',
+    '-re',
+    '-i',
+    p.source,
+    ...(p.seconds === null ? [] : ['-t', String(p.seconds)]),
+];
+// A keyframe every 48 frames with no scene-cut keyframes gives segments of an even length.
+const video = (p) => [
+    '-vf',
+    `scale=-2:${p.height}`,
+    '-c:v',
+    'libx264',
+    '-preset',
+    'veryfast',
+    '-g',
+    '48',
+    '-sc_threshold',
+    '0',
+    ...AUDIO_CODEC,
+];
+const audio = () => ['-vn', ...AUDIO_CODEC];
+// An "event" playlist keeps every segment, so a late viewer can seek to the start and replay it.
+const hls = (paths) => [
+    '-f',
+    'hls',
+    '-hls_time',
+    '4',
+    '-hls_list_size',
+    '0',
+    '-hls_playlist_type',
+    'event',
+    paths.playlist,
+];
+const PROFILE_ARGS = { video, audio };
+const defaultArgs = (config, paths) => [
+    ...input(config),
+    ...PROFILE_ARGS[config.profile](config),
+    ...hls(paths),
+];
+/** The arguments ffmpeg runs with: the profile, passed through the task's `ffmpegArgs` if it has one. */
+export const ffmpegArgs = (config, paths) => {
+    const defaults = defaultArgs(config, paths);
+    return config.ffmpegArgs === null ? defaults : config.ffmpegArgs(defaults, paths);
+};
+//# sourceMappingURL=ffmpeg-args.js.map

package/dist/ffmpeg-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg-args.js","sourceRoot":"","sources":["../src/ffmpeg-args.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,oEAAoE;AAcpE,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAE7D,0FAA0F;AAC1F,8EAA8E;AAC9E,MAAM,KAAK,GAAG,CAAC,CAAe,EAAqB,EAAE,CAAC;IACpD,cAAc;IACd,UAAU;IACV,WAAW;IACX,OAAO;IACP,WAAW;IACX,QAAQ;IACR,KAAK;IACL,IAAI;IACJ,CAAC,CAAC,MAAM;IACR,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACzD,CAAC;AAEF,2FAA2F;AAC3F,MAAM,KAAK,GAAG,CAAC,CAAe,EAAqB,EAAE,CAAC;IACpD,KAAK;IACL,YAAY,CAAC,CAAC,MAAM,EAAE;IACtB,MAAM;IACN,SAAS;IACT,SAAS;IACT,UAAU;IACV,IAAI;IACJ,IAAI;IACJ,eAAe;IACf,GAAG;IACH,GAAG,WAAW;CACf,CAAC;AAEF,MAAM,KAAK,GAAG,GAAsB,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,WAAW,CAAC,CAAC;AAE/D,iGAAiG;AACjG,MAAM,GAAG,GAAG,CAAC,KAAkB,EAAqB,EAAE,CAAC;IACrD,IAAI;IACJ,KAAK;IACL,WAAW;IACX,GAAG;IACH,gBAAgB;IAChB,GAAG;IACH,oBAAoB;IACpB,OAAO;IACP,KAAK,CAAC,QAAQ;CACf,CAAC;AAEF,MAAM,YAAY,GAAsE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAEzG,MAAM,WAAW,GAAG,CAAC,MAAoD,EAAE,KAAkB,EAAqB,EAAE,CAAC;IACnH,GAAG,KAAK,CAAC,MAAM,CAAC;IAChB,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACvC,GAAG,GAAG,CAAC,KAAK,CAAC;CACd,CAAC;AAEF,yGAAyG;AACzG,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAsF,EACtF,KAAkB,EACC,EAAE;IACrB,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACpF,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { stream, type StreamResult } from './stream.js';
+export { watchUrl } from './routes.js';
+export type { StreamOptions, Profile, AfterMode, ProgressHandler } from './options.js';
+export type { FfmpegArgsFn, StreamPaths } from './ffmpeg-args.js';
+export type { ProgressReport } from './progress.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvF,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { stream } from './stream.js';
+export { watchUrl } from './routes.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,42 @@
+import { type Result } from '@ignitify-integrations/runtime';
+import { AFTER_MODES, PROFILES } from './constants.js';
+import type { FfmpegArgsFn } from './ffmpeg-args.js';
+import type { ProgressReport } from './progress.js';
+export type Profile = (typeof PROFILES)[number];
+export type AfterMode = (typeof AFTER_MODES)[number];
+export type ProgressHandler = (report: ProgressReport) => void;
+export interface StreamOptions {
+    /** An https:// URL, or an absolute path of a file on the VM (for example on the scratch disk). */
+    readonly source: string;
+    readonly profile?: Profile;
+    /** Stop after this many seconds. Default: the whole source. */
+    readonly seconds?: number;
+    /** Output height in pixels (video profile only). */
+    readonly height?: number;
+    readonly startDelaySec?: number;
+    readonly after?: AfterMode;
+    /** With `after: 'replay'`: stop on its own this long after the stream ends. */
+    readonly lingerSec?: number;
+    readonly route?: string;
+    readonly port?: number;
+    readonly ffmpegArgs?: FfmpegArgsFn;
+    /** Called for every ffmpeg progress report, next to the built-in chunk and metric. */
+    readonly onProgress?: ProgressHandler;
+    /** Stop source. Default: the first SIGTERM (run:cancel) or SIGINT. */
+    readonly signal?: AbortSignal;
+}
+export interface StreamConfig {
+    readonly source: string;
+    readonly profile: Profile;
+    readonly seconds: number | null;
+    readonly height: number;
+    readonly startDelaySec: number;
+    readonly after: AfterMode;
+    readonly lingerSec: number | null;
+    readonly route: string;
+    readonly port: number;
+    readonly ffmpegArgs: FfmpegArgsFn | null;
+    readonly onProgress: ProgressHandler | null;
+}
+export declare const parseOptions: (options: StreamOptions) => Result<StreamConfig, readonly string[]>;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAIA,OAAO,EAA+C,KAAK,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAC1G,OAAO,EACL,WAAW,EAOX,QAAQ,EAET,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAChD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;IACnC,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7C;AAoED,eAAO,MAAM,YAAY,GAAI,SAAS,aAAa,KAAG,MAAM,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAkB3F,CAAC"}

package/dist/options.js

@@ -0,0 +1,80 @@
+// Options in, a checked config out. Pure. Every refusal is collected, so one run shows them all.
+// Values are checked at run time too: they usually come straight from a JSON payload.
+import { isAbsolute } from 'node:path';
+import { err, INBOUND_PORT_MAX, INBOUND_PORT_MIN, ok } from '@ignitify-integrations/runtime';
+import { AFTER_MODES, DEFAULT_HEIGHT, DEFAULT_PORT, DEFAULT_ROUTE, HEIGHT_MAX, HTTPS, MESSAGES, PROFILES, ROUTE_PATTERN, } from './constants.js';
+/** JSON payloads carry `null` for "not set" as often as they leave the key out. */
+const absent = (value) => value === undefined || value === null;
+const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+const isIntIn = (value, min, max) => Number.isInteger(value) && value >= min && value <= max;
+const parseSource = (value) => {
+    if (typeof value !== 'string' || value === '')
+        return err(MESSAGES.badSource(value));
+    // An absolute path cannot be read by ffmpeg as a protocol ("concat:", "pipe:", …).
+    if (isAbsolute(value))
+        return ok(value);
+    if (!URL.canParse(value))
+        return err(MESSAGES.badSource(value));
+    const url = new URL(value);
+    return url.protocol === HTTPS ? ok(url.toString()) : err(MESSAGES.badSource(value));
+};
+const oneOf = (all, value, fallback, message) => {
+    if (absent(value))
+        return ok(fallback);
+    return all.includes(value) ? ok(value) : err(message(value));
+};
+const positiveOrNull = (name, value) => {
+    if (absent(value))
+        return ok(null);
+    return isFiniteNumber(value) && value > 0 ? ok(value) : err(MESSAGES.badPositive(name, value));
+};
+const nonNegative = (name, value) => {
+    if (absent(value))
+        return ok(0);
+    return isFiniteNumber(value) && value >= 0 ? ok(value) : err(MESSAGES.badNonNegative(name, value));
+};
+const intIn = (value, fallback, min, max, message) => {
+    if (absent(value))
+        return ok(fallback);
+    return isIntIn(value, min, max) ? ok(value) : err(message(value));
+};
+const route = (value) => {
+    if (absent(value))
+        return ok(DEFAULT_ROUTE);
+    return typeof value === 'string' && ROUTE_PATTERN.test(value) ? ok(value) : err(MESSAGES.badRoute(value));
+};
+const fnOrNull = (name, value) => {
+    if (absent(value))
+        return ok(null);
+    return typeof value === 'function' ? ok(value) : err(MESSAGES.badFunction(name));
+};
+/** All fields ok → their values; else every error, in field order. */
+const collect = (fields) => {
+    const entries = Object.entries(fields);
+    const errors = entries.flatMap(([, r]) => (r.ok ? [] : [r.error]));
+    if (errors.length > 0)
+        return err(errors);
+    return ok(Object.fromEntries(entries.map(([key, r]) => [key, r.ok ? r.value : undefined])));
+};
+export const parseOptions = (options) => {
+    const fields = collect({
+        source: parseSource(options.source),
+        profile: oneOf(PROFILES, options.profile, 'video', MESSAGES.badProfile),
+        seconds: positiveOrNull('seconds', options.seconds),
+        height: intIn(options.height, DEFAULT_HEIGHT, 1, HEIGHT_MAX, MESSAGES.badHeight),
+        startDelaySec: nonNegative('startDelaySec', options.startDelaySec),
+        after: oneOf(AFTER_MODES, options.after, 'replay', MESSAGES.badAfter),
+        lingerSec: positiveOrNull('lingerSec', options.lingerSec),
+        route: route(options.route),
+        port: intIn(options.port, DEFAULT_PORT, INBOUND_PORT_MIN, INBOUND_PORT_MAX, MESSAGES.badPort),
+        ffmpegArgs: fnOrNull('ffmpegArgs', options.ffmpegArgs),
+        onProgress: fnOrNull('onProgress', options.onProgress),
+    });
+    if (!fields.ok)
+        return fields;
+    // A linger with `stop` would be silently ignored; refuse it so the intent is visible.
+    if (fields.value.after === 'stop' && fields.value.lingerSec !== null)
+        return err([MESSAGES.lingerNeedsReplay]);
+    return fields;
+};
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"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"}

package/dist/progress.d.ts

@@ -0,0 +1,23 @@
+export interface ProgressReport {
+    /** Seconds of output written so far. */
+    readonly doneSec: number;
+    /** ffmpeg's speed, as it prints it ("1.01x", or "N/A" at the start). */
+    readonly speed: string;
+    /** True on the last report of the run. */
+    readonly end: boolean;
+}
+/** Carry-over between stdout reads: a partial line, and the fields of the open report. */
+export interface ProgressState {
+    readonly partial: string;
+    readonly fields: Readonly<Record<string, string>>;
+}
+export declare const PROGRESS_START: ProgressState;
+/** Text in, finished reports out. A read may end mid-line; that line waits in `partial`. */
+export declare const parseProgress: (state: ProgressState, text: string) => {
+    readonly state: ProgressState;
+    readonly reports: readonly ProgressReport[];
+};
+/** At most one emit per interval, and always the last report. */
+export declare const shouldEmit: (report: ProgressReport, lastEmitMs: number | null, nowMs: number) => boolean;
+export declare const roundTime: (sec: number) => number;
+//# sourceMappingURL=progress.d.ts.map

package/dist/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,cAAc,EAAE,aAA2C,CAAC;AAWzE,4FAA4F;AAC5F,eAAO,MAAM,aAAa,GACxB,OAAO,aAAa,EACpB,MAAM,MAAM,KACX;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;CAkB9E,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,EAAE,YAAY,MAAM,GAAG,IAAI,EAAE,OAAO,MAAM,KAAG,OAChB,CAAC;AAE/E,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,MAA4C,CAAC"}

package/dist/progress.js

@@ -0,0 +1,36 @@
+// The ffmpeg `-progress` parser and the report throttle. Pure: text and times in, decisions out.
+// `-progress` prints `key=value` lines; a `progress=continue|end` line closes one report.
+import { PROGRESS_EVERY_MS, TIME_DECIMALS, US_PER_SEC } from './constants.js';
+export const PROGRESS_START = { partial: '', fields: {} };
+const END_VALUE = 'end';
+const CLOSING_KEY = 'progress';
+// ffmpeg prints "N/A" for out_time_us before the first frame is out.
+const toSeconds = (us) => {
+    const value = Number(us);
+    return Number.isFinite(value) && value > 0 ? value / US_PER_SEC : 0;
+};
+/** Text in, finished reports out. A read may end mid-line; that line waits in `partial`. */
+export const parseProgress = (state, text) => {
+    const lines = (state.partial + text).split('\n');
+    const partial = lines.pop() ?? '';
+    let fields = state.fields;
+    const reports = [];
+    for (const line of lines) {
+        const at = line.indexOf('=');
+        if (at <= 0)
+            continue;
+        const key = line.slice(0, at).trim();
+        const value = line.slice(at + 1).trim();
+        if (key !== CLOSING_KEY) {
+            fields = { ...fields, [key]: value };
+            continue;
+        }
+        reports.push({ doneSec: toSeconds(fields.out_time_us), speed: fields.speed ?? '', end: value === END_VALUE });
+        fields = {};
+    }
+    return { state: { partial, fields }, reports };
+};
+/** At most one emit per interval, and always the last report. */
+export const shouldEmit = (report, lastEmitMs, nowMs) => report.end || lastEmitMs === null || nowMs - lastEmitMs >= PROGRESS_EVERY_MS;
+export const roundTime = (sec) => Number(sec.toFixed(TIME_DECIMALS));
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,0FAA0F;AAE1F,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAiB9E,MAAM,CAAC,MAAM,cAAc,GAAkB,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAEzE,MAAM,SAAS,GAAG,KAAK,CAAC;AACxB,MAAM,WAAW,GAAG,UAAU,CAAC;AAE/B,qEAAqE;AACrE,MAAM,SAAS,GAAG,CAAC,EAAsB,EAAU,EAAE;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAoB,EACpB,IAAY,EACoE,EAAE;IAClF,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,IAAI,CAAC;YAAE,SAAS;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC,CAAC;QAC9G,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAsB,EAAE,UAAyB,EAAE,KAAa,EAAW,EAAE,CACtG,MAAM,CAAC,GAAG,IAAI,UAAU,KAAK,IAAI,IAAI,KAAK,GAAG,UAAU,IAAI,iBAAiB,CAAC;AAE/E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC"}

package/dist/routes.d.ts

@@ -0,0 +1,23 @@
+import type { TaskCtx } from '@ignitify-integrations/runtime';
+export type Route = {
+    readonly kind: 'player';
+} | {
+    readonly kind: 'script';
+} | {
+    readonly kind: 'media';
+    readonly name: string;
+    readonly type: string;
+} | {
+    readonly kind: 'none';
+};
+/** `route` is a checked prefix such as `/live/`; `urlPath` is the request's decoded-or-not pathname. */
+export declare const resolveRoute: (urlPath: string, route: string) => Route;
+/** The public viewer address: this deployment's host (from the callback URL) + the route. */
+export declare const viewerUrl: (callbackUrl: string | null, route: string) => string | null;
+/**
+ * The viewer link, for task code that tells people about the stream before or while it runs
+ * (stream() sends the same link to the caller as its first chunk). Null when the run has no callback.
+ */
+export declare const watchUrl: (ctx: Pick<TaskCtx, "callback">, route?: string) => string | null;
+export declare const playerPage: (route: string) => string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAU9D,MAAM,MAAM,KAAK,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAI9B,wGAAwG;AACxG,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,KAAG,KAS7D,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,SAAS,GAAI,aAAa,MAAM,GAAG,IAAI,EAAE,OAAO,MAAM,KAAG,MAAM,GAAG,IACP,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,QAAO,MAAsB,KAAG,MAAM,GAAG,IACrD,CAAC;AAK9C,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAc1B,CAAC"}

package/dist/routes.js

@@ -0,0 +1,47 @@
+// What the inbound server answers, decided from the URL path alone. Pure.
+// Under the route: the player page, hls.js, and the `.m3u8` / `.ts` files of ONE folder.
+// Everything else is 404: no sub-folders, no dot names, no other extensions.
+import { extname } from 'node:path';
+import { DEFAULT_ROUTE, MEDIA_STEM_PATTERN, MEDIA_TYPES, PLAYER_POLL_MS, PLAYER_SCRIPT_FILE, PLAYLIST_FILE, } from './constants.js';
+const NONE = { kind: 'none' };
+/** `route` is a checked prefix such as `/live/`; `urlPath` is the request's decoded-or-not pathname. */
+export const resolveRoute = (urlPath, route) => {
+    if (urlPath === route || urlPath === route.slice(0, -1))
+        return { kind: 'player' };
+    if (!urlPath.startsWith(route))
+        return NONE;
+    const name = urlPath.slice(route.length);
+    if (name === PLAYER_SCRIPT_FILE)
+        return { kind: 'script' };
+    const ext = extname(name);
+    const type = MEDIA_TYPES[ext];
+    if (type === undefined || !MEDIA_STEM_PATTERN.test(name.slice(0, -ext.length)))
+        return NONE;
+    return { kind: 'media', name, type };
+};
+/** The public viewer address: this deployment's host (from the callback URL) + the route. */
+export const viewerUrl = (callbackUrl, route) => callbackUrl === null ? null : `${new URL(callbackUrl).origin}${route}`;
+/**
+ * The viewer link, for task code that tells people about the stream before or while it runs
+ * (stream() sends the same link to the caller as its first chunk). Null when the run has no callback.
+ */
+export const watchUrl = (ctx, route = DEFAULT_ROUTE) => viewerUrl(ctx.callback?.url ?? null, route);
+// Paths are absolute so the page works at both `/live/` and `/live`. The playlist does not exist
+// until the first segment is written, so the page polls until it does, then plays. Safari plays
+// HLS natively; every other browser uses hls.js.
+export const playerPage = (route) => `<!doctype html><meta charset="utf-8"><title>Live</title>
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<body style="margin:0;background:#000">
+<video id="v" controls autoplay muted playsinline style="width:100%;height:100vh"></video>
+<script src="${route}${PLAYER_SCRIPT_FILE}"></script>
+<script>
+  const v = document.getElementById("v"), src = "${route}${PLAYLIST_FILE}";
+  const play = () => {
+    if (v.canPlayType("application/vnd.apple.mpegurl")) v.src = src;
+    else { const h = new Hls(); h.loadSource(src); h.attachMedia(v); }
+  };
+  const retry = () => setTimeout(wait, ${PLAYER_POLL_MS});
+  const wait = () => fetch(src, { cache: "no-store" }).then((r) => (r.ok ? play() : retry()), retry);
+  wait();
+</script></body>`;
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yFAAyF;AACzF,6EAA6E;AAE7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAQxB,MAAM,IAAI,GAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAErC,wGAAwG;AACxG,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,KAAa,EAAS,EAAE;IACpE,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACnF,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,kBAAkB;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC,CAAC;AAEF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,WAA0B,EAAE,KAAa,EAAiB,EAAE,CACpF,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAA8B,EAAE,QAAgB,aAAa,EAAiB,EAAE,CACvG,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;AAE9C,iGAAiG;AACjG,gGAAgG;AAChG,iDAAiD;AACjD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC;;;;eAItC,KAAK,GAAG,kBAAkB;;mDAEU,KAAK,GAAG,aAAa;;;;;yCAK/B,cAAc;;;iBAGtC,CAAC"}

package/dist/stream.d.ts

@@ -0,0 +1,24 @@
+import { type TaskCtx } from '@ignitify-integrations/runtime';
+import { type StreamOptions } from './options.js';
+export type StreamResult = {
+    readonly success: true;
+    readonly cancelled: true;
+    readonly stage: 'before-stream';
+} | {
+    readonly success: true;
+    readonly cancelled: boolean;
+    readonly stage: 'streamed';
+    readonly watch: string | null;
+    /** Seconds of output ffmpeg wrote (its last progress report). */
+    readonly streamed_s: number;
+    /** `null` for the audio profile. */
+    readonly height: number | null;
+    /** From the start of ffmpeg to the end of the run, replay included. */
+    readonly wall_ms: number;
+};
+/**
+ * Serve a live HLS stream of `options.source` from this task: player page, playlist, viewer URL,
+ * progress, stop on cancel. Throws on bad options and when ffmpeg fails.
+ */
+export declare function stream(ctx: TaskCtx, options: StreamOptions): Promise<StreamResult>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AASA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAkBtE,OAAO,EAAmC,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAInF,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACrF;IACE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AA4HN;;;GAGG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAoDxF"}

package/dist/stream.js

@@ -0,0 +1,165 @@
+// The shell: HTTP server, ffmpeg child process, stop signal. Every decision it acts on comes from
+// the pure modules (options, ffmpeg-args, progress, routes).
+import { spawn } from 'node:child_process';
+import { mkdir, readFile, rm } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { setTimeout as sleep } from 'node:timers/promises';
+import { unwrap } from '@ignitify-integrations/runtime';
+import { FFMPEG_BIN, HLS_JS_DIST, HLS_SUBDIR, HTML_TYPE, MESSAGES, METRIC_STREAMED_SECONDS, MS_PER_SEC, NO_CACHE, PLAYLIST_FILE, READ_METHODS, SCRATCH_HOME_FALLBACK, SCRIPT_TYPE, STATUS, STDERR_TAIL_CHARS, } from './constants.js';
+import { ffmpegArgs } from './ffmpeg-args.js';
+import { parseOptions } from './options.js';
+import { PROGRESS_START, parseProgress, roundTime, shouldEmit } from './progress.js';
+import { playerPage, resolveRoute, viewerUrl } from './routes.js';
+const STOP_SIGNALS = ['SIGTERM', 'SIGINT'];
+const NOT_FOUND = 404;
+const NOT_ALLOWED = 405;
+const OK = 200;
+// A run:cancel arrives as SIGTERM. Node's default would exit at once and leave ffmpeg running,
+// so stream() takes the signal over for the length of the stream, then gives it back.
+const processStop = () => {
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    STOP_SIGNALS.forEach((s) => process.once(s, abort));
+    return { signal: controller.signal, release: () => STOP_SIGNALS.forEach((s) => process.off(s, abort)) };
+};
+const whenAborted = (signal) => new Promise((resolve) => {
+    if (signal.aborted)
+        resolve();
+    else
+        signal.addEventListener('abort', () => resolve(), { once: true });
+});
+/** Wait `sec`, or less if the stop comes first. The only rejection of an aborted sleep is the abort. */
+const sleepUnlessStopped = (sec, signal) => sleep(sec * MS_PER_SEC, undefined, { signal }).catch(() => undefined);
+const hlsPaths = () => {
+    const hlsDir = join(process.env.HOME || SCRATCH_HOME_FALLBACK, HLS_SUBDIR);
+    return { hlsDir, playlist: join(hlsDir, PLAYLIST_FILE) };
+};
+// Resolved at run time from the installed package: never a CDN, never a copy in this repo.
+const loadPlayerScript = () => readFile(createRequire(import.meta.url).resolve(HLS_JS_DIST));
+const handler = (route, player, script, hlsDir) => (req, res) => {
+    if (!READ_METHODS.includes(req.method ?? '')) {
+        res.writeHead(NOT_ALLOWED, { allow: READ_METHODS.join(', ') }).end();
+        return;
+    }
+    // Split, not `new URL`: a malformed request line must not throw inside the server.
+    const path = (req.url ?? '').split(/[?#]/, 1)[0] ?? '';
+    const r = resolveRoute(path, route);
+    if (r.kind === 'player')
+        res.writeHead(OK, { 'content-type': HTML_TYPE }).end(player);
+    else if (r.kind === 'script')
+        res.writeHead(OK, { 'content-type': SCRIPT_TYPE }).end(script);
+    else if (r.kind === 'none')
+        res.writeHead(NOT_FOUND).end();
+    else
+        readFile(join(hlsDir, r.name)).then((body) => res.writeHead(OK, { 'content-type': r.type, 'cache-control': NO_CACHE }).end(body), () => res.writeHead(NOT_FOUND).end());
+};
+const listen = (server, port) => new Promise((resolve, reject) => {
+    server.once('error', reject);
+    server.listen(port, () => {
+        server.off('error', reject);
+        resolve();
+    });
+});
+const close = (server) => new Promise((resolve) => {
+    server.close(() => resolve());
+    server.closeAllConnections();
+});
+// Runs ffmpeg to its end. Progress → onProgress (every report) and chunk + metric (throttled).
+const runEngine = (ctx, config, args, signal) => new Promise((resolve, reject) => {
+    const ff = spawn(FFMPEG_BIN, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+    const kill = () => void ff.kill('SIGTERM');
+    signal.addEventListener('abort', kill, { once: true });
+    let progress = PROGRESS_START;
+    let lastEmitMs = null;
+    let streamedSec = 0;
+    let tail = '';
+    const report = (r) => {
+        streamedSec = r.doneSec;
+        // Best-effort: the tenant's progress handler is observability and must never stop the stream.
+        try {
+            config.onProgress?.(r);
+        }
+        catch (error) {
+            console.error(MESSAGES.progressHandlerFailed(error));
+        }
+        const now = Date.now();
+        if (!shouldEmit(r, lastEmitMs, now))
+            return;
+        lastEmitMs = now;
+        ctx.chunk({ status: STATUS.streaming, time_s: roundTime(r.doneSec), of_s: config.seconds, speed: r.speed });
+        ctx.metric(METRIC_STREAMED_SECONDS, r.doneSec, 'gauge');
+    };
+    ff.stdout.setEncoding('utf8').on('data', (text) => {
+        const parsed = parseProgress(progress, text);
+        progress = parsed.state;
+        parsed.reports.forEach(report);
+    });
+    ff.stderr.setEncoding('utf8').on('data', (text) => {
+        console.error(text.trimEnd());
+        tail = (tail + text).slice(-STDERR_TAIL_CHARS);
+    });
+    ff.once('error', (e) => {
+        signal.removeEventListener('abort', kill);
+        reject(e.code === 'ENOENT' ? new Error(MESSAGES.ffmpegMissing) : e);
+    });
+    ff.once('close', (code) => {
+        signal.removeEventListener('abort', kill);
+        resolve({ code, stderrTail: tail.trim(), streamedSec });
+    });
+});
+/**
+ * Serve a live HLS stream of `options.source` from this task: player page, playlist, viewer URL,
+ * progress, stop on cancel. Throws on bad options and when ffmpeg fails.
+ */
+export async function stream(ctx, options) {
+    const config = unwrap(parseOptions(options));
+    const stop = options.signal === undefined ? processStop() : { signal: options.signal, release: () => undefined };
+    const { signal } = stop;
+    const paths = hlsPaths();
+    const script = await loadPlayerScript();
+    await rm(paths.hlsDir, { recursive: true, force: true });
+    await mkdir(paths.hlsDir, { recursive: true });
+    const server = createServer(handler(config.route, playerPage(config.route), script, paths.hlsDir));
+    try {
+        await listen(server, config.port);
+        ctx.ready();
+        const watch = viewerUrl(ctx.callback?.url ?? null, config.route);
+        ctx.chunk({ status: STATUS.live, watch, playlist: watch === null ? null : `${watch}${PLAYLIST_FILE}` });
+        console.log(MESSAGES.serving(config.route, config.port, watch));
+        // Serve the player first, so a viewer can open the link before the stream starts.
+        if (config.startDelaySec > 0) {
+            ctx.chunk({ status: STATUS.waiting, start_in_s: config.startDelaySec, watch });
+            console.log(MESSAGES.waiting(config.startDelaySec));
+            await sleepUnlessStopped(config.startDelaySec, signal);
+        }
+        if (signal.aborted)
+            return { success: true, cancelled: true, stage: 'before-stream' };
+        const started = Date.now();
+        const exit = await runEngine(ctx, config, ffmpegArgs(config, paths), signal);
+        // ffmpeg exits non-zero when it is stopped; that is a cancel, not a failure.
+        if (exit.code !== 0 && !signal.aborted)
+            throw new Error(MESSAGES.ffmpegFailed(exit.code, exit.stderrTail));
+        if (!signal.aborted && config.after === 'replay') {
+            const until = config.lingerSec === null ? MESSAGES.replayUntilCancel : MESSAGES.replayUntilLinger(config.lingerSec);
+            ctx.chunk({ status: STATUS.ended, replay_until: until, watch });
+            console.log(MESSAGES.ended(until));
+            await (config.lingerSec === null ? whenAborted(signal) : sleepUnlessStopped(config.lingerSec, signal));
+        }
+        return {
+            success: true,
+            cancelled: signal.aborted,
+            stage: 'streamed',
+            watch,
+            streamed_s: roundTime(exit.streamedSec),
+            height: config.profile === 'video' ? config.height : null,
+            wall_ms: Date.now() - started,
+        };
+    }
+    finally {
+        await close(server);
+        stop.release();
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,6DAA6D;AAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,YAAY,EAA0D,MAAM,WAAW,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAgB,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,QAAQ,EACR,uBAAuB,EACvB,UAAU,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,MAAM,EACN,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAoB,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAyC,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAuB,MAAM,eAAe,CAAC;AAC1G,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAiBlE,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AACpD,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,EAAE,GAAG,GAAG,CAAC;AAEf,+FAA+F;AAC/F,sFAAsF;AACtF,MAAM,WAAW,GAAG,GAAmE,EAAE;IACvF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,GAAS,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC7C,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACpD,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;AAC1G,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAiB,EAAE,CACzD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;;QACzB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEL,wGAAwG;AACxG,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAE,MAAmB,EAAiB,EAAE,CAC7E,KAAK,CAAC,GAAG,GAAG,UAAU,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAExE,MAAM,QAAQ,GAAG,GAAgB,EAAE;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,qBAAqB,EAAE,UAAU,CAAC,CAAC;IAC3E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC;AAC3D,CAAC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,gBAAgB,GAAG,GAAoB,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AAE9G,MAAM,OAAO,GACX,CAAC,KAAa,EAAE,MAAc,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE,CAClE,CAAC,GAAoB,EAAE,GAAmB,EAAQ,EAAE;IAClD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACrE,OAAO;IACT,CAAC;IACD,mFAAmF;IACnF,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;SACjF,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;SACxF,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;QAAE,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC;;QAEzD,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CACjC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAC5F,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CACrC,CAAC;AACN,CAAC,CAAC;AAEJ,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,IAAY,EAAiB,EAAE,CAC7D,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACvB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,KAAK,GAAG,CAAC,MAAc,EAAiB,EAAE,CAC9C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9B,MAAM,CAAC,mBAAmB,EAAE,CAAC;AAC/B,CAAC,CAAC,CAAC;AAQL,+FAA+F;AAC/F,MAAM,SAAS,GAAG,CAChB,GAAY,EACZ,MAAoB,EACpB,IAAuB,EACvB,MAAmB,EACE,EAAE,CACvB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvD,IAAI,QAAQ,GAAG,cAAc,CAAC;IAC9B,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,MAAM,GAAG,CAAC,CAAiB,EAAQ,EAAE;QACzC,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC;QACxB,8FAA8F;QAC9F,IAAI,CAAC;YACH,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC;YAAE,OAAO;QAC5C,UAAU,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5G,GAAG,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC,CAAC;IACF,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACxD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7C,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;QACxB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACxD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAwB,EAAE,EAAE;QAC5C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAY,EAAE,OAAsB;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IACjH,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAExC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnG,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,GAAG,CAAC,KAAK,EAAE,CAAC;QAEZ,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACjE,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,aAAa,EAAE,EAAE,CAAC,CAAC;QACxG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAEhE,kFAAkF;QAClF,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/E,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;YACpD,MAAM,kBAAkB,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QAEtF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7E,6EAA6E;QAC7E,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAE3G,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjD,MAAM,KAAK,GACT,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACxG,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QACzG,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,MAAM,CAAC,OAAO;YACzB,KAAK,EAAE,UAAU;YACjB,KAAK;YACL,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;YACvC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;YACzD,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SAC9B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACpB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/integration.yaml

@@ -0,0 +1,16 @@
+schema_version: 1
+name: stream
+runtimes: [node]
+network:
+  type: bidirectional
+  # Only an https source needs egress; its host varies, so the plan prints this hint.
+  egress_hint: 'the host of an https source (for example raw.githubusercontent.com); none for a local file'
+  inbound_port: 8080 # must equal the `port` option (default 8080)
+  inbound_routes:
+    - prefix: /live/ # must equal the `route` option (default /live/)
+  inbound_max_concurrent: 16 # in-flight requests; an HLS player fetches one segment every 4 s
+execution:
+  duration: long
+  interaction: continuous # ctx.chunk is dropped under boundary-only
+system_packages: [ffmpeg]
+min_preset: std.medium # live x264 runs out of memory on std.micro; the audio profile is not measured

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@ignitify-integrations/stream",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Live audio and video streaming (HLS over HTTPS) from an ignitify task, as glue over ffmpeg",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ignitify-dev/ignitify-integrations.git",
+    "directory": "integrations/stream"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "integration.yaml",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@ignitify-integrations/runtime": "^0.1.0",
+    "hls.js": "^1.7.4"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}