@adonis-agora/media 0.8.1 → 0.9.0

package/dist/src/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAIjD;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAG/C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IAJnC,QAAQ,CAAC,IAAI,mCAAmC;gBAErC,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACjC,QAAQ,EAAE,SAAS,MAAM,EAAE;CAO9B;AAED;;;;;;;;;GASG;AACH,qBAAa,iCAAkC,SAAQ,KAAK;IAGxD,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE;IAJtC,QAAQ,CAAC,IAAI,4CAA4C;gBAE9C,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,QAAQ,EAAE,SAAS,MAAM,EAAE;CASvC;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,6BAA6B;gBAC9B,IAAI,EAAE,MAAM;CAMzB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,4BAA4B;gBAC7B,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAMtC;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,oCAAoC;gBACrC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAInD;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,qCAAqC;;CAKnD;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,+BAA+B;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,kCAAkC;gBACnC,IAAI,EAAE,MAAM,EAAE,SAAS,SAA4B;CAMhE;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,sCAAsC;gBACvC,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAGhD,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAH3B,QAAQ,CAAC,IAAI,oCAAoC;gBAEtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;CAK5B;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,oCAAoC;gBACrC,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,kCAAmC,SAAQ,KAAK;IAC3D,QAAQ,CAAC,IAAI,sCAAsC;;CAOpD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,kCAAkC;gBACnC,IAAI,EAAE,MAAM;CAMzB;AAED,qBAAa,oCAAqC,SAAQ,KAAK;IAC7D,QAAQ,CAAC,IAAI,iDAAiD;gBAClD,IAAI,EAAE,MAAM;CAMzB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/src/errors.js

@@ -82,6 +82,102 @@ export class ConversionNotDefinedError extends Error {
         this.name = 'ConversionNotDefinedError';
     }
 }
+/**
+ * A conversion was requested by a name that names neither an image preset nor a transformer of the
+ * record's collection — the transformer counterpart of {@link ConversionNotDefinedError}, raised by
+ * `MediaLibrary.transform`.
+ */
+export class TransformerNotDefinedError extends Error {
+    code = 'E_MEDIA_TRANSFORMER_NOT_DEFINED';
+    constructor(collection, transformer) {
+        super(`Transformer "${transformer}" is not defined for collection "${collection}"`);
+        this.name = 'TransformerNotDefinedError';
+    }
+}
+/**
+ * A transformer-produced conversion was read (`url` / `deliver` / HLS delivery) before it was
+ * generated. Deliberately NOT generated lazily on read like image conversions: a transform is
+ * assumed heavy (a video remux takes minutes), and a read path is the wrong place to pay that.
+ * Generate it explicitly — `media.library.transform(id, name)` from a job — then read again.
+ */
+export class TransformNotReadyError extends Error {
+    mediaId;
+    transformer;
+    code = 'E_MEDIA_TRANSFORM_NOT_READY';
+    constructor(mediaId, transformer) {
+        super(`Conversion "${transformer}" of media "${mediaId}" has not been generated yet. Transformer conversions are never generated inside a read path — run \`media.library.transform('${mediaId}', '${transformer}')\` (idempotent; call it from a job) and retry.`);
+        this.mediaId = mediaId;
+        this.transformer = transformer;
+        this.name = 'TransformNotReadyError';
+    }
+}
+/**
+ * Two derivatives of one collection claim the same name. Presets and transformers persist into the
+ * same `record.conversions` map, so the namespace is shared; raised at registry construction (boot),
+ * not on first attach.
+ */
+export class TransformerConflictError extends Error {
+    code = 'E_MEDIA_TRANSFORMER_CONFLICT';
+    constructor(collection, name) {
+        super(`Collection "${collection}" defines more than one conversion or transformer named "${name}". Preset and transformer names share the \`record.conversions\` namespace, so each name may appear once per collection.`);
+        this.name = 'TransformerConflictError';
+    }
+}
+/**
+ * A transformer needs a runtime capability the host doesn't provide — an optional peer that isn't
+ * installed (`mediabunny`), or an API the runtime lacks (WebCodecs in Node). Thrown by the built-in
+ * transformers and available for custom ones, so "this environment can't do that" always surfaces
+ * as one clear, typed error instead of a deep import/undefined crash.
+ */
+export class TransformerRuntimeMissingError extends Error {
+    transformer;
+    requirement;
+    code = 'E_MEDIA_TRANSFORMER_RUNTIME_MISSING';
+    constructor(transformer, requirement, hint) {
+        super(`Transformer "${transformer}" requires ${requirement}, which is not available in this runtime.${hint ? ` ${hint}` : ''}`);
+        this.transformer = transformer;
+        this.requirement = requirement;
+        this.name = 'TransformerRuntimeMissingError';
+    }
+}
+/**
+ * A transformer violated the output contract: wrote outside its prefix (`..`/absolute path),
+ * declared an `entry` it never wrote, or wrote artifacts without declaring an entry. These are
+ * programming errors in the transformer, surfaced with the transformer's name so the broken one is
+ * obvious.
+ */
+export class TransformerOutputError extends Error {
+    code = 'E_MEDIA_TRANSFORMER_OUTPUT_INVALID';
+    constructor(transformer, reason) {
+        super(`Transformer "${transformer}" produced an invalid output: ${reason}`);
+        this.name = 'TransformerOutputError';
+    }
+}
+/**
+ * A metadata-only conversion (a probe, a blurhash) was asked for its file — `url`, `signedUrl` or
+ * `deliver` — but it has no artifact; only `record.conversions[name].meta` exists. Read the record
+ * instead of a URL.
+ */
+export class ConversionArtifactMissingError extends Error {
+    code = 'E_MEDIA_CONVERSION_ARTIFACT_MISSING';
+    constructor(mediaId, conversion) {
+        super(`Conversion "${conversion}" of media "${mediaId}" is metadata-only — it has no artifact to deliver. Its result lives on \`record.conversions['${conversion}'].meta\`.`);
+        this.name = 'ConversionArtifactMissingError';
+    }
+}
+/**
+ * The HLS transformer could not stream-copy the source: a track's codec cannot be carried by the
+ * segment format (MPEG-TS wants h264/aac), and no re-encode path exists in this runtime. Definitive
+ * for the file — retrying cannot fix it; re-encode the source, or provide a WebCodecs
+ * implementation (see `transformers.hls({ webcodecs })`).
+ */
+export class HlsSourceUnsupportedError extends Error {
+    code = 'E_MEDIA_HLS_SOURCE_UNSUPPORTED';
+    constructor(details) {
+        super(`HLS remux is impossible for this source: ${details}. Without an encoder (WebCodecs) the tracks can only be stream-copied, so an incompatible codec is definitive — re-encode the source to h264/aac, or configure \`transformers.hls({ webcodecs })\` with a WebCodecs implementation to enable the re-encode fallback.`);
+        this.name = 'HlsSourceUnsupportedError';
+    }
+}
 export class ImageProcessorMissingError extends Error {
     code = 'E_MEDIA_IMAGE_PROCESSOR_MISSING';
     constructor() {
@@ -128,6 +224,55 @@ export class UploadSessionExpiredError extends Error {
         this.name = 'UploadSessionExpiredError';
     }
 }
+/**
+ * A part size the S3 multipart API cannot honour: below the 5 MiB minimum (every part but the last
+ * must reach it, or `CompleteMultipartUpload` fails with `EntityTooSmall` AFTER the client uploaded
+ * everything), or small enough that the file would need more than the 10,000 parts S3 allows.
+ * Raised at `initiate`, where it costs nothing — the alternative is discovering it at complete,
+ * when the whole file has already crossed the wire.
+ */
+export class UploadPartSizeError extends Error {
+    code = 'E_MEDIA_UPLOAD_PART_SIZE';
+    constructor(detail) {
+        super(`Invalid multipart part size: ${detail}`);
+        this.name = 'UploadPartSizeError';
+    }
+}
+/** A confirmed part number outside `1..totalParts` for the session — a client slicing with the wrong part size. */
+export class UploadPartOutOfRangeError extends Error {
+    partNumber;
+    totalParts;
+    code = 'E_MEDIA_UPLOAD_PART_OUT_OF_RANGE';
+    constructor(partNumber, totalParts) {
+        super(`Part number ${partNumber} is outside this upload's range (1..${totalParts}). The client must slice the file with the partSize the session was created with.`);
+        this.partNumber = partNumber;
+        this.totalParts = totalParts;
+        this.name = 'UploadPartOutOfRangeError';
+    }
+}
+/**
+ * `complete()` was asked to assemble an upload whose parts are not all accounted for (neither
+ * confirmed to the session nor supplied in the call). Failing fast here names the EXACT missing
+ * part numbers; letting S3 discover it returns an opaque `InvalidPart` after a round-trip.
+ */
+export class UploadPartsIncompleteError extends Error {
+    sessionId;
+    missingParts;
+    code = 'E_MEDIA_UPLOAD_PARTS_INCOMPLETE';
+    constructor(sessionId, missingParts) {
+        super(`Cannot complete upload session ${sessionId}: no ETag for part(s) ${missingParts.join(', ')}. Upload and confirm them (or pass them to complete()) first — status() lists what is pending.`);
+        this.sessionId = sessionId;
+        this.missingParts = missingParts;
+        this.name = 'UploadPartsIncompleteError';
+    }
+}
+export class DirectUploadsNotConfiguredError extends Error {
+    code = 'E_MEDIA_DIRECT_NOT_CONFIGURED';
+    constructor() {
+        super("Session-backed direct uploads are not configured. Set `uploads.direct` in config/media.ts (e.g. `direct: { store: 'lucid', stores: { lucid: uploadSessions.lucid() } }`) to enable the direct upload session store.");
+        this.name = 'DirectUploadsNotConfiguredError';
+    }
+}
 export class ResumableUploadsNotConfiguredError extends Error {
     code = 'E_MEDIA_RESUMABLE_NOT_CONFIGURED';
     constructor() {

package/dist/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,YAAY,UAAkB,EAAE,QAAgB;QAC9C,KAAK,CAAC,cAAc,QAAQ,mCAAmC,UAAU,GAAG,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAGtC;IACA;IACA;IAJF,IAAI,GAAG,+BAA+B,CAAC;IAChD,YACW,UAAkB,EAClB,gBAAwB,EACxB,gBAAwB,EACjC,QAA2B;QAE3B,KAAK,CACH,+BAA+B,gBAAgB,2DAA2D,gBAAgB,kBAAkB,UAAU,cAAc,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAC5L,CAAC;QAPO,eAAU,GAAV,UAAU,CAAQ;QAClB,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,qBAAgB,GAAhB,gBAAgB,CAAQ;QAMjC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IAG/C;IACA;IACA;IAJF,IAAI,GAAG,wCAAwC,CAAC;IACzD,YACW,UAAkB,EAClB,gBAAoC,EACpC,QAA2B;QAEpC,KAAK,CACH,gDACE,gBAAgB,CAAC,CAAC,CAAC,sBAAsB,gBAAgB,GAAG,CAAC,CAAC,CAAC,EACjE,iBAAiB,UAAU,8CAA8C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,4EAA4E,CACzK,CAAC;QARO,eAAU,GAAV,UAAU,CAAQ;QAClB,qBAAgB,GAAhB,gBAAgB,CAAoB;QACpC,aAAQ,GAAR,QAAQ,CAAmB;QAOpC,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;IAClD,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,yBAAyB,CAAC;IAC1C,YAAY,IAAY;QACtB,KAAK,CACH,wBAAwB,IAAI,yRAAyR,CACtT,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,YAAY,EAAU;QACpB,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,GAAG,wBAAwB,CAAC;IACzC,YAAY,IAAY,EAAE,GAAW;QACnC,KAAK,CACH,qBAAqB,GAAG,cAAc,IAAI,+JAA+J,CAC1M,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,GAAG,gCAAgC,CAAC;IACjD,YAAY,UAAkB,EAAE,UAAkB;QAChD,KAAK,CAAC,eAAe,UAAU,oCAAoC,UAAU,GAAG,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,iCAAiC,CAAC;IAClD,YAAY,UAAkB,EAAE,WAAmB;QACjD,KAAK,CAAC,gBAAgB,WAAW,oCAAoC,UAAU,GAAG,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAGpC;IACA;IAHF,IAAI,GAAG,6BAA6B,CAAC;IAC9C,YACW,OAAe,EACf,WAAmB;QAE5B,KAAK,CACH,eAAe,WAAW,eAAe,OAAO,iIAAiI,OAAO,OAAO,WAAW,kDAAkD,CAC7P,CAAC;QALO,YAAO,GAAP,OAAO,CAAQ;QACf,gBAAW,GAAX,WAAW,CAAQ;QAK5B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,IAAI,GAAG,8BAA8B,CAAC;IAC/C,YAAY,UAAkB,EAAE,IAAY;QAC1C,KAAK,CACH,eAAe,UAAU,4DAA4D,IAAI,0HAA0H,CACpN,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAG5C;IACA;IAHF,IAAI,GAAG,qCAAqC,CAAC;IACtD,YACW,WAAmB,EACnB,WAAmB,EAC5B,IAAa;QAEb,KAAK,CACH,gBAAgB,WAAW,cAAc,WAAW,4CAA4C,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACzH,CAAC;QANO,gBAAW,GAAX,WAAW,CAAQ;QACnB,gBAAW,GAAX,WAAW,CAAQ;QAM5B,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,IAAI,GAAG,oCAAoC,CAAC;IACrD,YAAY,WAAmB,EAAE,MAAc;QAC7C,KAAK,CAAC,gBAAgB,WAAW,iCAAiC,MAAM,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAC9C,IAAI,GAAG,qCAAqC,CAAC;IACtD,YAAY,OAAe,EAAE,UAAkB;QAC7C,KAAK,CACH,eAAe,UAAU,eAAe,OAAO,iGAAiG,UAAU,YAAY,CACvK,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,GAAG,gCAAgC,CAAC;IACjD,YAAY,OAAe;QACzB,KAAK,CACH,4CAA4C,OAAO,sQAAsQ,CAC1T,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,iCAAiC,CAAC;IAClD;QACE,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,2BAA2B,CAAC;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,8BAA8B,OAAO,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,GAAG,8BAA8B,CAAC;IAC/C,YAAY,IAAY,EAAE,SAAS,GAAG,yBAAyB;QAC7D,KAAK,CACH,SAAS,IAAI,sBAAsB,SAAS,oFAAoF,CACjI,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,kCAAkC,CAAC;IACnD,YAAY,EAAU;QACpB,KAAK,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAGvC;IACA;IAHF,IAAI,GAAG,gCAAgC,CAAC;IACjD,YACW,QAAgB,EAChB,QAAgB;QAEzB,KAAK,CAAC,oCAAoC,QAAQ,cAAc,QAAQ,EAAE,CAAC,CAAC;QAHnE,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;QAGzB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,GAAG,gCAAgC,CAAC;IACjD,YAAY,EAAU;QACpB,KAAK,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,YAAY,MAAc;QACxB,KAAK,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,mHAAmH;AACnH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAGvC;IACA;IAHF,IAAI,GAAG,kCAAkC,CAAC;IACnD,YACW,UAAkB,EAClB,UAAkB;QAE3B,KAAK,CACH,eAAe,UAAU,uCAAuC,UAAU,mFAAmF,CAC9J,CAAC;QALO,eAAU,GAAV,UAAU,CAAQ;QAClB,eAAU,GAAV,UAAU,CAAQ;QAK3B,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAGxC;IACA;IAHF,IAAI,GAAG,iCAAiC,CAAC;IAClD,YACW,SAAiB,EACjB,YAA+B;QAExC,KAAK,CACH,kCAAkC,SAAS,yBAAyB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,gGAAgG,CAC5L,CAAC;QALO,cAAS,GAAT,SAAS,CAAQ;QACjB,iBAAY,GAAZ,YAAY,CAAmB;QAKxC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAC/C,IAAI,GAAG,+BAA+B,CAAC;IAChD;QACE,KAAK,CACH,qNAAqN,CACtN,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,OAAO,kCAAmC,SAAQ,KAAK;IAClD,IAAI,GAAG,kCAAkC,CAAC;IACnD;QACE,KAAK,CACH,wNAAwN,CACzN,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oCAAoC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,GAAG,8BAA8B,CAAC;IAC/C,YAAY,IAAY;QACtB,KAAK,CACH,+BAA+B,IAAI,gEAAgE,IAAI,2CAA2C,IAAI,sEAAsE,CAC7N,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,oCAAqC,SAAQ,KAAK;IACpD,IAAI,GAAG,6CAA6C,CAAC;IAC9D,YAAY,IAAY;QACtB,KAAK,CACH,iDAAiD,IAAI,oGAAoG,IAAI,2CAA2C,IAAI,sFAAsF,CACnS,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sCAAsC,CAAC;IACrD,CAAC;CACF"}

package/dist/src/hls/delivery.d.ts

@@ -0,0 +1,112 @@
+import type { DeliveryResult } from '../delivery.js';
+import type { MediaLibrary } from '../media_library.js';
+/** Identifies one file of a media's HLS package, handed to the URL callbacks. */
+export interface HlsFileRef {
+    mediaId: string;
+    /** Package-relative artifact path (`'index.m3u8'`, `'playlist-1.m3u8'`, `'segment-0-3.ts'`). */
+    file: string;
+}
+/** Builds the URL a rewritten playlist reference should point at. */
+export type HlsUrlBuilder = (ref: HlsFileRef) => string | Promise<string>;
+/** What {@link HlsDeliveryHandler.handle} is asked to serve. */
+export interface HlsDeliveryRequest {
+    mediaId: string;
+    /**
+     * Which file of the package, relative to the conversion prefix. Omit for the entry (master)
+     * playlist. Validated against the conversion's persisted artifact list, so a request can never
+     * reach outside the package.
+     */
+    file?: string | undefined;
+}
+/**
+ * What serving one HLS package file yields: playlists come back as rewritten text (they are
+ * *always* rewritten, never proxied raw — raw ones reference the storage layout, not URLs), and
+ * media files come back as the usual {@link DeliveryResult} (`redirect` to a signed URL, or a
+ * `stream` to pipe).
+ */
+export type HlsDeliveryResult = {
+    kind: 'playlist';
+    content: string;
+    contentType: string;
+    fileName: string;
+} | DeliveryResult;
+export interface HlsDeliveryHandlerOptions {
+    /** The {@link MediaLibrary} records are resolved from — or a `MediaManager`, whose `.library` is used. */
+    library: MediaLibrary | {
+        library: MediaLibrary;
+    };
+    /** Name of the HLS conversion on the record. Default `'hls'` (the {@link HlsTransformer} default). */
+    conversion?: string | undefined;
+    /**
+     * URL for a **sub-playlist** reference (master → media playlists, audio renditions). Required,
+     * and it should point back at a route of yours that calls this handler again — playlists must be
+     * rewritten on every hop, and your route is where your authorization runs. There is no safe
+     * library default: presigning a playlist would serve it raw from storage, whose relative
+     * references then resolve against the storage host and break (or leak).
+     */
+    urlForPlaylist: HlsUrlBuilder;
+    /**
+     * URL for a **media** reference (segments, init sections). Default: a presigned URL straight to
+     * the object on the disk (`segmentTtlSeconds` lifetime) — the common case, letting players pull
+     * segments from storage/CDN without the bytes transiting your app. Point it at your own proxy
+     * route instead when storage isn't reachable from clients (then serve those requests with
+     * {@link HlsDeliveryHandler.handle}, which streams media files per `segmentDelivery`).
+     */
+    urlForSegment?: HlsUrlBuilder | undefined;
+    /** Lifetime of default presigned segment URLs, seconds. Default 300. */
+    segmentTtlSeconds?: number | undefined;
+    /**
+     * How {@link HlsDeliveryHandler.handle} answers a request for a media file (it always answers
+     * playlists with rewritten text): `'redirect'` (default) to a presigned URL, or `'stream'` to
+     * proxy the bytes through the app.
+     */
+    segmentDelivery?: 'redirect' | 'stream' | undefined;
+}
+/**
+ * Framework-agnostic HLS read path — the {@link MediaDeliveryHandler} of a transformer-generated
+ * HLS package. One route of yours receives `(:mediaId, :file?)` and delegates here; the handler
+ * resolves the record's HLS conversion, validates the requested file against the package's
+ * persisted artifact list, and:
+ *
+ * - for a **playlist**: returns its content with every relative reference rewritten — sub-playlist
+ *   references through your `urlForPlaylist` (auth stays yours), media references through
+ *   `urlForSegment` or a presigned URL;
+ * - for a **media file**: returns a `redirect` (presigned) or a `stream`, per `segmentDelivery`.
+ *
+ * ```ts
+ * const hls = new HlsDeliveryHandler({
+ *   library: media,
+ *   urlForPlaylist: ({ mediaId, file }) => router.makeUrl('videos.hls', { id: mediaId, file }),
+ * })
+ *
+ * router.get('/videos/:id/hls/:file?', async ({ params, response, auth }) => {
+ *   await authorize(auth.user, params.id)             // ← the app's job, as everywhere
+ *   const result = await hls.handle({ mediaId: params.id, file: params.file })
+ *   if (result.kind === 'redirect') return response.redirect(result.url)
+ *   if (result.kind === 'stream') {
+ *     response.header('content-type', result.mimeType)
+ *     return response.stream(result.stream)
+ *   }
+ *   response.header('content-type', result.contentType)
+ *   return response.send(result.content)
+ * }).use(middleware.auth())
+ * ```
+ *
+ * **This handler performs NO authorization** — the same split as {@link MediaDeliveryHandler} and
+ * `TusUploadHandler`: guard the route before calling `handle`. Note that a presigned segment URL
+ * (the default) is itself a capability: whoever holds it can fetch that segment until the TTL
+ * expires. That is the standard HLS trade-off — keep `segmentTtlSeconds` short, or use
+ * `segmentDelivery: 'stream'` with a segment `urlForSegment` pointing back at your route to keep
+ * every byte behind your auth.
+ */
+export declare class HlsDeliveryHandler {
+    private readonly library;
+    private readonly conversion;
+    private readonly urlForPlaylist;
+    private readonly urlForSegment;
+    private readonly segmentTtlSeconds;
+    private readonly segmentDelivery;
+    constructor(options: HlsDeliveryHandlerOptions);
+    handle(request: HlsDeliveryRequest): Promise<HlsDeliveryResult>;
+}
+//# sourceMappingURL=delivery.d.ts.map

package/dist/src/hls/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../src/hls/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQxD,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1E,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5E,cAAc,CAAC;AAEnB,MAAM,WAAW,yBAAyB;IACxC,0GAA0G;IAC1G,OAAO,EAAE,YAAY,GAAG;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC;IAClD,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;;;;;OAMG;IACH,cAAc,EAAE,aAAa,CAAC;IAC9B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;OAIG;IACH,eAAe,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4B;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;gBAE5C,OAAO,EAAE,yBAAyB;IAUxC,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA+DtE"}

package/dist/src/hls/delivery.js

@@ -0,0 +1,118 @@
+import { DEFAULT_DELIVERY_SIGNED_TTL_SECONDS } from '../delivery.js';
+import { ConversionArtifactMissingError, MediaNotFoundError, TransformNotReadyError, } from '../errors.js';
+import { HLS_PLAYLIST_CONTENT_TYPE, hlsArtifactContentType, resolvePackagePath, rewriteHlsPlaylist, } from './playlist.js';
+/**
+ * Framework-agnostic HLS read path — the {@link MediaDeliveryHandler} of a transformer-generated
+ * HLS package. One route of yours receives `(:mediaId, :file?)` and delegates here; the handler
+ * resolves the record's HLS conversion, validates the requested file against the package's
+ * persisted artifact list, and:
+ *
+ * - for a **playlist**: returns its content with every relative reference rewritten — sub-playlist
+ *   references through your `urlForPlaylist` (auth stays yours), media references through
+ *   `urlForSegment` or a presigned URL;
+ * - for a **media file**: returns a `redirect` (presigned) or a `stream`, per `segmentDelivery`.
+ *
+ * ```ts
+ * const hls = new HlsDeliveryHandler({
+ *   library: media,
+ *   urlForPlaylist: ({ mediaId, file }) => router.makeUrl('videos.hls', { id: mediaId, file }),
+ * })
+ *
+ * router.get('/videos/:id/hls/:file?', async ({ params, response, auth }) => {
+ *   await authorize(auth.user, params.id)             // ← the app's job, as everywhere
+ *   const result = await hls.handle({ mediaId: params.id, file: params.file })
+ *   if (result.kind === 'redirect') return response.redirect(result.url)
+ *   if (result.kind === 'stream') {
+ *     response.header('content-type', result.mimeType)
+ *     return response.stream(result.stream)
+ *   }
+ *   response.header('content-type', result.contentType)
+ *   return response.send(result.content)
+ * }).use(middleware.auth())
+ * ```
+ *
+ * **This handler performs NO authorization** — the same split as {@link MediaDeliveryHandler} and
+ * `TusUploadHandler`: guard the route before calling `handle`. Note that a presigned segment URL
+ * (the default) is itself a capability: whoever holds it can fetch that segment until the TTL
+ * expires. That is the standard HLS trade-off — keep `segmentTtlSeconds` short, or use
+ * `segmentDelivery: 'stream'` with a segment `urlForSegment` pointing back at your route to keep
+ * every byte behind your auth.
+ */
+export class HlsDeliveryHandler {
+    library;
+    conversion;
+    urlForPlaylist;
+    urlForSegment;
+    segmentTtlSeconds;
+    segmentDelivery;
+    constructor(options) {
+        const source = options.library;
+        this.library = 'library' in source ? source.library : source;
+        this.conversion = options.conversion ?? 'hls';
+        this.urlForPlaylist = options.urlForPlaylist;
+        this.urlForSegment = options.urlForSegment;
+        this.segmentTtlSeconds = options.segmentTtlSeconds ?? DEFAULT_DELIVERY_SIGNED_TTL_SECONDS;
+        this.segmentDelivery = options.segmentDelivery ?? 'redirect';
+    }
+    async handle(request) {
+        const { mediaId } = request;
+        const record = await this.library.find(mediaId);
+        if (!record)
+            throw new MediaNotFoundError(mediaId);
+        const variant = record.conversions[this.conversion];
+        if (!variant)
+            throw new TransformNotReadyError(mediaId, this.conversion);
+        if (variant.path === undefined || variant.disk === undefined) {
+            throw new ConversionArtifactMissingError(mediaId, this.conversion);
+        }
+        // The package's shape comes from what the transformer persisted; a hand-registered
+        // single-file conversion degrades to a one-file package.
+        const prefix = variant.prefix ?? variant.path.slice(0, variant.path.lastIndexOf('/') + 1);
+        const files = variant.files ?? [variant.path.slice(prefix.length)];
+        const entry = variant.path.slice(prefix.length);
+        const requested = request.file === undefined || request.file === '' ? entry : request.file;
+        // Membership in the persisted artifact list is the whole access check: no path arithmetic on
+        // caller input ever reaches the disk, so traversal is structurally impossible.
+        if (!files.includes(requested)) {
+            throw new MediaNotFoundError(`${mediaId}#${this.conversion}:${requested}`);
+        }
+        const disk = this.library.storage.disk(variant.disk);
+        const key = `${prefix}${requested}`;
+        if (requested.toLowerCase().endsWith('.m3u8')) {
+            const content = Buffer.from(await disk.getBytes(key)).toString('utf8');
+            const rewritten = await rewriteHlsPlaylist(content, async (ref) => {
+                const target = resolvePackagePath(requested, ref.uri);
+                // A relative reference that escapes the package or names a file the transformer never
+                // wrote is not ours to rewrite — leave it exactly as it was.
+                if (target === null || !files.includes(target))
+                    return ref.uri;
+                if (ref.kind === 'playlist')
+                    return this.urlForPlaylist({ mediaId, file: target });
+                if (this.urlForSegment)
+                    return this.urlForSegment({ mediaId, file: target });
+                return disk.getSignedUrl(`${prefix}${target}`, { expiresIn: this.segmentTtlSeconds });
+            });
+            return {
+                kind: 'playlist',
+                content: rewritten,
+                contentType: HLS_PLAYLIST_CONTENT_TYPE,
+                fileName: requested,
+            };
+        }
+        if (this.segmentDelivery === 'redirect') {
+            return {
+                kind: 'redirect',
+                url: await disk.getSignedUrl(key, { expiresIn: this.segmentTtlSeconds }),
+            };
+        }
+        const metadata = await disk.getMetaData(key);
+        return {
+            kind: 'stream',
+            stream: await disk.getStream(key),
+            mimeType: metadata.contentType ?? hlsArtifactContentType(requested) ?? 'application/octet-stream',
+            size: metadata.contentLength,
+            fileName: requested.slice(requested.lastIndexOf('/') + 1),
+        };
+    }
+}
+//# sourceMappingURL=delivery.js.map

package/dist/src/hls/delivery.js.map

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

package/dist/src/hls/playlist.d.ts

@@ -0,0 +1,67 @@
+/**
+ * HLS playlist (`.m3u8`) reference rewriting — the read-side half of the HLS transformer.
+ *
+ * Playlists are STORED with references relative to the package's storage layout (that is what the
+ * muxer emits, and it keeps the stored artifacts location-agnostic). At serve time those
+ * references must become URLs the player can actually fetch — the app's authenticated proxy
+ * routes, presigned object URLs, a CDN — and only the app knows which. This module does the part
+ * that is the same everywhere: find every reference in a playlist, classify it, and let a
+ * callback decide the URL. See {@link HlsDeliveryHandler} for the assembled read path.
+ */
+/** Content type playlists are served with (RFC 8216's `application/vnd.apple.mpegurl`). */
+export declare const HLS_PLAYLIST_CONTENT_TYPE = "application/vnd.apple.mpegurl";
+/** Content type for MPEG-TS segments. */
+export declare const HLS_SEGMENT_CONTENT_TYPE = "video/mp2t";
+/** One URI reference found in a playlist, handed to the {@link HlsUriRewriter}. */
+export interface HlsUriRef {
+    /** The reference exactly as it appears in the playlist (may carry a query string). */
+    uri: string;
+    /**
+     * `'playlist'` for `.m3u8` references (variant streams in a master playlist, audio/subtitle
+     * renditions via `#EXT-X-MEDIA`), `'media'` for everything else (segments, `#EXT-X-MAP` init
+     * sections, keys). Classified by extension, ignoring any query/fragment.
+     */
+    kind: 'playlist' | 'media';
+    /**
+     * The tag whose `URI="…"` attribute holds this reference (`'EXT-X-MEDIA'`, `'EXT-X-MAP'`,
+     * `'EXT-X-I-FRAME-STREAM-INF'`, …), or `undefined` for a plain URI line.
+     */
+    tag?: string;
+}
+/**
+ * Maps one playlist reference to the URI that should replace it. Return the input unchanged to
+ * keep a reference as-is. May be async — building the replacement routinely involves presigning.
+ */
+export type HlsUriRewriter = (ref: HlsUriRef) => string | Promise<string>;
+/**
+ * Rewrite every **relative** URI reference in an HLS playlist through `rewrite`, covering all the
+ * places RFC 8216 puts one:
+ *
+ * - plain URI lines (segments in a media playlist, variant playlists in a master playlist),
+ * - `URI="…"` attributes on tags (`#EXT-X-MEDIA` audio/subtitle renditions, `#EXT-X-MAP` init
+ *   sections, `#EXT-X-I-FRAME-STREAM-INF`, `#EXT-X-KEY`, …).
+ *
+ * Untouched, by design:
+ * - **absolute** references (`https://…`, protocol-relative `//…`, root-relative `/…`) — they no
+ *   longer describe the storage layout, so rewriting them is not this function's business;
+ * - comments and every other tag/line, byte for byte (line endings included).
+ */
+export declare function rewriteHlsPlaylist(content: string, rewrite: HlsUriRewriter): Promise<string>;
+/**
+ * Whether a playlist reference is relative to the playlist's own location — the only kind that
+ * describes the storage layout and therefore the only kind {@link rewriteHlsPlaylist} rewrites.
+ * Anything carrying a scheme (`https:`, `data:`), protocol-relative (`//cdn/…`) or root-relative
+ * (`/api/…`) is already an address, not a layout detail.
+ */
+export declare function isRelativeUri(uri: string): boolean;
+/** Classify a reference by extension (query/fragment ignored): `.m3u8` ⇒ playlist, else media. */
+export declare function classifyUri(uri: string): 'playlist' | 'media';
+/**
+ * Resolve a reference found in playlist `fromFile` (both package-relative) to the package-relative
+ * path it points at, collapsing `.`/`..` segments. Returns `null` when the reference escapes the
+ * package root — the caller treats that as "not one of ours" and leaves it alone.
+ */
+export declare function resolvePackagePath(fromFile: string, uri: string): string | null;
+/** Content type for one artifact of an HLS package, by extension. */
+export declare function hlsArtifactContentType(file: string): string | undefined;
+//# sourceMappingURL=playlist.d.ts.map

package/dist/src/hls/playlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playlist.d.ts","sourceRoot":"","sources":["../../../src/hls/playlist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AAEzE,yCAAyC;AACzC,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,sFAAsF;IACtF,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAyBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe/E;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASvE"}

package/dist/src/hls/playlist.js

@@ -0,0 +1,126 @@
+/**
+ * HLS playlist (`.m3u8`) reference rewriting — the read-side half of the HLS transformer.
+ *
+ * Playlists are STORED with references relative to the package's storage layout (that is what the
+ * muxer emits, and it keeps the stored artifacts location-agnostic). At serve time those
+ * references must become URLs the player can actually fetch — the app's authenticated proxy
+ * routes, presigned object URLs, a CDN — and only the app knows which. This module does the part
+ * that is the same everywhere: find every reference in a playlist, classify it, and let a
+ * callback decide the URL. See {@link HlsDeliveryHandler} for the assembled read path.
+ */
+/** Content type playlists are served with (RFC 8216's `application/vnd.apple.mpegurl`). */
+export const HLS_PLAYLIST_CONTENT_TYPE = 'application/vnd.apple.mpegurl';
+/** Content type for MPEG-TS segments. */
+export const HLS_SEGMENT_CONTENT_TYPE = 'video/mp2t';
+/**
+ * Rewrite every **relative** URI reference in an HLS playlist through `rewrite`, covering all the
+ * places RFC 8216 puts one:
+ *
+ * - plain URI lines (segments in a media playlist, variant playlists in a master playlist),
+ * - `URI="…"` attributes on tags (`#EXT-X-MEDIA` audio/subtitle renditions, `#EXT-X-MAP` init
+ *   sections, `#EXT-X-I-FRAME-STREAM-INF`, `#EXT-X-KEY`, …).
+ *
+ * Untouched, by design:
+ * - **absolute** references (`https://…`, protocol-relative `//…`, root-relative `/…`) — they no
+ *   longer describe the storage layout, so rewriting them is not this function's business;
+ * - comments and every other tag/line, byte for byte (line endings included).
+ */
+export async function rewriteHlsPlaylist(content, rewrite) {
+    // Split keeping the separators, so CRLF/LF survive exactly as they came.
+    const parts = content.split(/(\r?\n)/);
+    for (let i = 0; i < parts.length; i += 2) {
+        const line = parts[i];
+        if (line === undefined || line === '')
+            continue;
+        if (line.startsWith('#')) {
+            if (line.startsWith('#EXT'))
+                parts[i] = await rewriteTagUris(line, rewrite);
+            continue; // plain comment: untouched
+        }
+        const uri = line.trim();
+        if (uri === '' || !isRelativeUri(uri))
+            continue;
+        const replacement = await rewrite({ uri, kind: classifyUri(uri) });
+        // Preserve any surrounding whitespace on the line, replacing only the URI itself.
+        parts[i] = line.replace(uri, replacement);
+    }
+    return parts.join('');
+}
+const TAG_URI_ATTRIBUTE = /URI="([^"]*)"/g;
+/** Rewrite every relative `URI="…"` attribute on one tag line. */
+async function rewriteTagUris(line, rewrite) {
+    const colon = line.indexOf(':');
+    const tag = (colon === -1 ? line.slice(1) : line.slice(1, colon)).trim();
+    let output = '';
+    let consumed = 0;
+    for (const match of line.matchAll(TAG_URI_ATTRIBUTE)) {
+        const uri = match[1];
+        output += line.slice(consumed, match.index);
+        if (uri !== '' && isRelativeUri(uri)) {
+            const replacement = await rewrite({ uri, kind: classifyUri(uri), tag });
+            output += `URI="${replacement}"`;
+        }
+        else {
+            output += match[0];
+        }
+        consumed = match.index + match[0].length;
+    }
+    return output + line.slice(consumed);
+}
+/**
+ * Whether a playlist reference is relative to the playlist's own location — the only kind that
+ * describes the storage layout and therefore the only kind {@link rewriteHlsPlaylist} rewrites.
+ * Anything carrying a scheme (`https:`, `data:`), protocol-relative (`//cdn/…`) or root-relative
+ * (`/api/…`) is already an address, not a layout detail.
+ */
+export function isRelativeUri(uri) {
+    if (uri.startsWith('/'))
+        return false; // covers '//' too
+    return !/^[a-z][a-z0-9+.-]*:/i.test(uri);
+}
+/** Classify a reference by extension (query/fragment ignored): `.m3u8` ⇒ playlist, else media. */
+export function classifyUri(uri) {
+    const clean = uri.split(/[?#]/, 1)[0];
+    return clean.toLowerCase().endsWith('.m3u8') ? 'playlist' : 'media';
+}
+/**
+ * Resolve a reference found in playlist `fromFile` (both package-relative) to the package-relative
+ * path it points at, collapsing `.`/`..` segments. Returns `null` when the reference escapes the
+ * package root — the caller treats that as "not one of ours" and leaves it alone.
+ */
+export function resolvePackagePath(fromFile, uri) {
+    const clean = uri.split(/[?#]/, 1)[0];
+    const slash = fromFile.lastIndexOf('/');
+    const base = slash === -1 ? '' : fromFile.slice(0, slash + 1);
+    const resolved = [];
+    for (const segment of `${base}${clean}`.split('/')) {
+        if (segment === '' || segment === '.')
+            continue;
+        if (segment === '..') {
+            if (resolved.length === 0)
+                return null;
+            resolved.pop();
+            continue;
+        }
+        resolved.push(segment);
+    }
+    return resolved.length === 0 ? null : resolved.join('/');
+}
+/** Content type for one artifact of an HLS package, by extension. */
+export function hlsArtifactContentType(file) {
+    const lower = file.toLowerCase();
+    if (lower.endsWith('.m3u8'))
+        return HLS_PLAYLIST_CONTENT_TYPE;
+    if (lower.endsWith('.ts'))
+        return HLS_SEGMENT_CONTENT_TYPE;
+    if (lower.endsWith('.m4s') || lower.endsWith('.mp4'))
+        return 'video/mp4';
+    if (lower.endsWith('.aac'))
+        return 'audio/aac';
+    if (lower.endsWith('.mp3'))
+        return 'audio/mpeg';
+    if (lower.endsWith('.vtt'))
+        return 'text/vtt';
+    return undefined;
+}
+//# sourceMappingURL=playlist.js.map