@replayablejs/export 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Replayable contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @replayablejs/export
+
+Turn existing playable builds into network-specific delivery artifacts.
+
+Part of [Replayable](https://github.com/replayablejs/replayable) **0.1.0-alpha.0**.
+APIs may change during the alpha series.
+
+## Install
+
+```sh
+pnpm add -D @replayablejs/export@0.1.0-alpha.0
+```
+
+## Public surface
+
+`exportProject`, `ExportProjectOptions`, `ExportProjectResult`, `ExportVariantResult`.
+
+[Usage and reference](https://github.com/replayablejs/replayable/blob/main/docs/reference/export.md).
+The package manifest defines supported import paths; internal source files are not public APIs.
+
+## Development
+
+From the repository root, install with `pnpm install --frozen-lockfile` and build dependencies
+with `pnpm build`. Run `pnpm --filter @replayablejs/export test` for this package's tests.
+
+## License
+
+Original code is [MIT licensed](https://github.com/replayablejs/replayable/blob/main/LICENSE). Bundled third-party resources retain
+their accompanying license terms.

package/dist/browser/compressed-module-loader.js

@@ -0,0 +1,44 @@
+//#region src/shared/compression-protocol.ts
+/** Identifies the inert script element that stores one Replayable module. */
+const COMPRESSED_ENTRY_ATTRIBUTE = "data-replayable-compressed-entry";
+//#endregion
+//#region src/browser/execute-module.ts
+/**
+* Awaits native module evaluation, including top-level await and its failures.
+*
+* A script-element error event does not report every evaluation failure. Import's
+* promise does, without global error listeners or an appended completion event.
+* Each entry is a self-contained build, so it has no relative imports to resolve.
+*/
+async function executeModule(source, role) {
+	const url = URL.createObjectURL(new Blob([source], { type: "text/javascript" }));
+	try {
+		await import(
+			/* @vite-ignore */
+			url
+);
+	} catch (cause) {
+		throw new Error(`Failed to execute compressed Replayable ${role} entry.`, { cause });
+	} finally {
+		URL.revokeObjectURL(url);
+	}
+}
+//#endregion
+//#region src/browser/compressed-module-loader.ts
+for (const role of ["assets", "application"]) {
+	const payload = document.querySelector(`script[${COMPRESSED_ENTRY_ATTRIBUTE}="${role}"]`);
+	if (!(payload instanceof HTMLScriptElement)) throw new Error(`Missing compressed Replayable ${role} entry.`);
+	const payloadSource = payload.textContent;
+	if (payloadSource === null || payloadSource.trim().length === 0) throw new Error(`Compressed Replayable ${role} entry is empty.`);
+	try {
+		await executeModule(payload.getAttribute("data-replayable-entry-encoding") === "deflate" ? inflateSource(payloadSource) : payloadSource, role);
+	} finally {
+		payload.remove();
+	}
+}
+/** Restores one Base64-encoded Deflate payload to its original JavaScript. */
+function inflateSource(payload) {
+	const bytes = Uint8Array.from(atob(payload.trim()), (character) => character.charCodeAt(0));
+	return pako.inflate(bytes, { to: "string" });
+}
+//#endregion

package/dist/index.d.mts

@@ -0,0 +1,38 @@
+import { ReplayableConfigInput } from "@replayablejs/config";
+//#region src/types/export.d.ts
+/** Explicit project and destination choices for one export operation. */
+interface ExportProjectOptions {
+  /** Optional output directory, resolved from the project root and defaulting to `exports`. */
+  readonly outputDirectory?: string;
+  /** Root directory of the authored Replayable project. */
+  readonly projectRoot: string;
+}
+/** One upload-ready artifact produced from an existing playable variant build. */
+interface ExportVariantResult {
+  /** Absolute path to the exported delivery artifact. */
+  readonly file: string;
+  /** Final artifact size in bytes. */
+  readonly size: number;
+  /** ID of the concrete version, network, and language that was exported. */
+  readonly variantId: string;
+}
+/** Delivery artifacts produced by one successful project export. */
+interface ExportProjectResult {
+  /** Absolute directory containing every configured network's artifacts. */
+  readonly outputDirectory: string;
+  /** Exported variants in deterministic configuration order. */
+  readonly variants: readonly ExportVariantResult[];
+}
+//#endregion
+//#region src/pipeline/export-project.d.ts
+/**
+ * Produces every upload-ready artifact from an existing Replayable project build.
+ *
+ * Resolution verifies the builds and assigns destinations. Preparation creates
+ * every artifact in memory. Emission replaces the previous export directory only
+ * after all preparation succeeds, preserving the last successful export on error.
+ */
+declare function exportProject(config: ReplayableConfigInput, options: ExportProjectOptions): Promise<ExportProjectResult>;
+//#endregion
+export { type ExportProjectOptions, type ExportProjectResult, type ExportVariantResult, exportProject };
+//# sourceMappingURL=index.d.mts.map