@ue-shed/map-history 0.1.0

package/dist/fast-history-target.js

@@ -0,0 +1,248 @@
+import { resolve } from "node:path";
+import { Effect } from "effect";
+import { actorIdentityKey, actorIdentityOf } from "./diff.js";
+import { MapHistoryError } from "./errors.js";
+import { PerforceHistorySource } from "./perforce.js";
+import { depotPackageFileSpec, projectRelativePathForPackageName, resolvePresentDayMapScope } from "./perforce-map-scope.js";
+const ZERO_GUID = /^0{8}-0{8}-0{8}-0{8}$/;
+function targetError(message, recovery) {
+    return new MapHistoryError({
+        kind: "invalid_target",
+        message,
+        recovery,
+        retrySafe: false
+    });
+}
+function actorsMatchingIdentity(actors, identity) {
+    const key = actorIdentityKey(identity);
+    return actors.filter((actor) => actorIdentityKey(actorIdentityOf(actor)) === key);
+}
+function isUsableGuid(guid) {
+    return guid !== undefined && guid.length > 0 && !ZERO_GUID.test(guid);
+}
+function proveActorPackage(options) {
+    const { actor, identity, scope } = options;
+    const packageName = actor.packageName;
+    const inMapPackage = packageName === scope.mapPackageName;
+    let packageProjectRelativePath;
+    if (inMapPackage) {
+        packageProjectRelativePath = scope.mapProjectRelativePath;
+    }
+    else {
+        packageProjectRelativePath = projectRelativePathForPackageName(packageName, ".uasset");
+        if (packageProjectRelativePath === undefined) {
+            return targetError(`Actor package ${packageName} cannot be converted to a project-relative saved package path.`, "Confirm the SavedWorld actor projection reports a /Game package name.");
+        }
+        if (scope.sourceKind === "world_partition") {
+            const externalRoot = scope.externalActorProjectRoot;
+            if (externalRoot === undefined) {
+                return targetError("The World Partition map did not report an external-actor root for the Investigation Target.", "Confirm the map's saved external-actor layout can be read, then retry.");
+            }
+            if (packageProjectRelativePath !== externalRoot &&
+                !packageProjectRelativePath.startsWith(`${externalRoot}/`)) {
+                return targetError(`Actor package ${packageName} is outside the selected map's proven external-actor scope.`, "Select an actor that belongs to the map's matching World Partition external-actor subtree.");
+            }
+        }
+        else {
+            return targetError(`Conventional map actor package ${packageName} is not the selected map package.`, "Select an actor stored in the conventional map package, or use Deep History.");
+        }
+    }
+    return {
+        actor,
+        identity,
+        packageName,
+        packageProjectRelativePath
+    };
+}
+/**
+ * Proves one present-day SavedWorld actor is the Investigation Target and derives its package path
+ * from the existing actor projection. Returns a typed failure when continuity or package scope
+ * cannot be established without guessing.
+ */
+export function proveFastHistoryActorTarget(options) {
+    if (options.target.kind !== "actor") {
+        return targetError("Fast History only supports a single-actor Investigation Target in this slice.", "Select one present-day actor by GUID or exact package/object path.");
+    }
+    const matches = actorsMatchingIdentity(options.world.actors, options.target.identity);
+    if (matches.length === 0) {
+        return targetError("The Investigation Target actor is not present in the selected map's current saved world.", "Choose an actor that exists in the present-day map projection, or use Deep History.");
+    }
+    if (matches.length > 1) {
+        return targetError("The Investigation Target matches multiple present-day actors, so its package scope is ambiguous.", "Identify the actor by a unique GUID or exact package and object path.");
+    }
+    const actor = matches[0];
+    if (actor === undefined) {
+        return targetError("The Investigation Target actor is not present in the selected map's current saved world.", "Choose an actor that exists in the present-day map projection, or use Deep History.");
+    }
+    return proveActorPackage({
+        actor,
+        identity: options.target.identity,
+        scope: options.scope
+    });
+}
+/** Proves every current actor in an exact class target without inferring historical membership. */
+export function proveFastHistoryActorClassTargets(options) {
+    if (options.target.kind !== "actor_class") {
+        return targetError("Fast History class targeting requires an exact actor class path.", "Choose a class path or select one present-day actor.");
+    }
+    const classPath = options.target.classPath;
+    const matches = options.world.actors.filter((actor) => actor.classPath === classPath);
+    if (matches.length === 0) {
+        return targetError(`No current actors match class ${classPath} in the selected map.`, "Choose a class with current actors, or use Deep History to find deleted or reclassified actors.");
+    }
+    const proven = [];
+    for (const actor of matches) {
+        const target = proveActorPackage({
+            actor,
+            identity: actorIdentityOf(actor),
+            scope: options.scope
+        });
+        if (target instanceof MapHistoryError)
+            return target;
+        proven.push(target);
+    }
+    return proven;
+}
+/** Builds the explicit targeted-coverage document Fast History must return with every result. */
+export function fastHistoryTargetedCoverage(options) {
+    const { actor, identity, packageName } = options.proven;
+    const mapPackage = {
+        depotFileSpec: options.mapDepotFileSpec,
+        packageName: options.mapPackageName,
+        role: "selected_map"
+    };
+    const acquiredPackages = packageName === options.mapPackageName
+        ? [mapPackage]
+        : [
+            mapPackage,
+            {
+                depotFileSpec: options.targetDepotFileSpec,
+                packageName,
+                role: "investigation_target_actor"
+            }
+        ];
+    return {
+        acquiredPackages,
+        claimsCompleteMapCoverage: false,
+        claimsHistoricalClassCoverage: false,
+        investigationTarget: {
+            ...(isUsableGuid(actor.actorGuid) ? { actorGuid: actor.actorGuid } : {}),
+            actorPath: actor.actorPath,
+            classPath: actor.classPath,
+            identity,
+            kind: "actor",
+            packageName
+        },
+        kind: "targeted"
+    };
+}
+/** Builds explicit coverage metadata for an exact current actor-class target. */
+export function fastHistoryActorClassTargetedCoverage(options) {
+    const acquiredPackages = [
+        {
+            depotFileSpec: options.mapDepotFileSpec,
+            packageName: options.mapPackageName,
+            role: "selected_map"
+        }
+    ];
+    const acquiredPackageNames = new Set([options.mapPackageName]);
+    for (const targetPackage of options.targetPackages) {
+        if (acquiredPackageNames.has(targetPackage.proven.packageName))
+            continue;
+        acquiredPackageNames.add(targetPackage.proven.packageName);
+        acquiredPackages.push({
+            depotFileSpec: targetPackage.depotFileSpec,
+            packageName: targetPackage.proven.packageName,
+            role: "investigation_target_class"
+        });
+    }
+    return {
+        acquiredPackages,
+        claimsCompleteMapCoverage: false,
+        claimsHistoricalClassCoverage: false,
+        investigationTarget: {
+            classPath: options.target.classPath,
+            currentActorCount: options.proven.length,
+            kind: "actor_class"
+        },
+        kind: "targeted"
+    };
+}
+/**
+ * Resolves Fast History acquisition to the selected map plus proven Investigation Target packages.
+ * Unrelated external-actor packages never enter the Perforce file specs or allowlist.
+ */
+export function resolvePerforceFastMapScope(query) {
+    return Effect.fn("MapHistory.resolvePerforceFastMapScope")(function* () {
+        const perforce = yield* PerforceHistorySource;
+        const { scope: mapScope, world } = yield* resolvePresentDayMapScope(query);
+        const provenTargets = query.target.kind === "actor"
+            ? (() => {
+                const proven = proveFastHistoryActorTarget({
+                    scope: mapScope,
+                    target: query.target,
+                    world
+                });
+                return proven instanceof MapHistoryError ? proven : [proven];
+            })()
+            : proveFastHistoryActorClassTargets({
+                scope: mapScope,
+                target: query.target,
+                world
+            });
+        if (provenTargets instanceof MapHistoryError)
+            return yield* Effect.fail(provenTargets);
+        const proven = provenTargets[0];
+        if (proven === undefined) {
+            return yield* Effect.fail(targetError("Fast History could not prove any current Investigation Target package.", "Choose a current actor or class, then retry."));
+        }
+        const mapDepotFileSpec = depotPackageFileSpec(mapScope.mapDepotPath);
+        const targetPackages = [];
+        const mappedPackageNames = new Set();
+        for (const target of provenTargets) {
+            if (target.packageName === mapScope.mapPackageName ||
+                mappedPackageNames.has(target.packageName))
+                continue;
+            mappedPackageNames.add(target.packageName);
+            const targetLocalPath = resolve(query.projectRoot, target.packageProjectRelativePath);
+            const targetMapping = yield* perforce.resolveLocalPath(targetLocalPath);
+            targetPackages.push({
+                depotFileSpec: depotPackageFileSpec(targetMapping.depotPath),
+                proven: target
+            });
+        }
+        const allowedPackageNames = new Set([
+            mapScope.mapPackageName,
+            ...provenTargets.map((target) => target.packageName)
+        ]);
+        const fileSpecs = [
+            mapDepotFileSpec,
+            ...targetPackages.map((target) => target.depotFileSpec)
+        ];
+        const coverage = query.target.kind === "actor_class"
+            ? fastHistoryActorClassTargetedCoverage({
+                mapDepotFileSpec,
+                mapPackageName: mapScope.mapPackageName,
+                proven: provenTargets,
+                target: query.target,
+                targetPackages
+            })
+            : fastHistoryTargetedCoverage({
+                mapDepotFileSpec,
+                mapPackageName: mapScope.mapPackageName,
+                proven,
+                targetDepotFileSpec: targetPackages[0]?.depotFileSpec ?? mapDepotFileSpec
+            });
+        return {
+            coverage,
+            proven,
+            provenTargets,
+            scope: {
+                ...mapScope,
+                allowedPackageNames,
+                fileSpecs
+            }
+        };
+    })();
+}
+//# sourceMappingURL=fast-history-target.js.map

package/dist/fast-history-target.js.map

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

package/dist/historical-project-tree.d.ts

@@ -0,0 +1,18 @@
+import { Effect, Schema, Scope } from "effect";
+import { MapHistoryError } from "./errors.js";
+export declare const HistoricalFileMutation: Schema.Union<readonly [Schema.Struct<{
+    readonly action: Schema.Literals<readonly ["add", "edit"]>;
+    readonly materializedPath: Schema.NonEmptyString;
+    readonly projectRelativePath: Schema.NonEmptyString;
+}>, Schema.Struct<{
+    readonly action: Schema.Literal<"delete">;
+    readonly projectRelativePath: Schema.NonEmptyString;
+}>]>;
+export type HistoricalFileMutation = Schema.Schema.Type<typeof HistoricalFileMutation>;
+export interface HistoricalProjectTree {
+    readonly materializationRoot: string;
+    readonly projectRoot: string;
+    readonly applyRevision: (mutations: readonly HistoricalFileMutation[]) => Effect.Effect<void, MapHistoryError>;
+}
+export declare function acquireHistoricalProjectTree(): Effect.Effect<HistoricalProjectTree, MapHistoryError, Scope.Scope>;
+//# sourceMappingURL=historical-project-tree.d.ts.map

package/dist/historical-project-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical-project-tree.d.ts","sourceRoot":"","sources":["../src/historical-project-tree.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI9C,eAAO,MAAM,sBAAsB;;;;;;;IAUjC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvF,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,CACvB,SAAS,EAAE,SAAS,sBAAsB,EAAE,KACxC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;CAC1C;AAwHD,wBAAgB,4BAA4B,IAAI,MAAM,CAAC,MAAM,CAC5D,qBAAqB,EACrB,eAAe,EACf,KAAK,CAAC,KAAK,CACX,CAoBA"}

package/dist/historical-project-tree.js

@@ -0,0 +1,123 @@
+import { copyFile, mkdir, mkdtemp, rename, rm } from "node:fs/promises";
+import { basename, dirname, isAbsolute, relative, resolve } from "node:path";
+import { tmpdir } from "node:os";
+import { Effect, Schema, Scope } from "effect";
+import { MapHistoryError } from "./errors.js";
+const TEMPORARY_PROJECT_PREFIX = "ue-shed-map-history-";
+export const HistoricalFileMutation = Schema.Union([
+    Schema.Struct({
+        action: Schema.Literals(["add", "edit"]),
+        materializedPath: Schema.NonEmptyString,
+        projectRelativePath: Schema.NonEmptyString
+    }),
+    Schema.Struct({
+        action: Schema.Literal("delete"),
+        projectRelativePath: Schema.NonEmptyString
+    })
+]);
+function temporaryStorageError(operation, path, cause) {
+    return new MapHistoryError({
+        cause,
+        kind: "temporary_storage",
+        message: `${operation} failed for ${path}: ${String(cause)}`,
+        recovery: "Check temporary-directory permissions and available disk space, then retry.",
+        retrySafe: true
+    });
+}
+function invalidTarget(path, message) {
+    return new MapHistoryError({
+        kind: "invalid_target",
+        message,
+        recovery: "Use a non-empty project-relative path contained by the historical project.",
+        retrySafe: false
+    });
+}
+function resolveContainedPath(projectRoot, projectRelativePath) {
+    if (projectRelativePath.length === 0 || isAbsolute(projectRelativePath)) {
+        throw invalidTarget(projectRelativePath, `Historical package path must be project-relative: ${projectRelativePath}`);
+    }
+    const target = resolve(projectRoot, projectRelativePath);
+    const relativeTarget = relative(projectRoot, target);
+    if (relativeTarget.length === 0 ||
+        relativeTarget === ".." ||
+        relativeTarget.startsWith(`..\\`) ||
+        relativeTarget.startsWith("../") ||
+        isAbsolute(relativeTarget)) {
+        throw invalidTarget(projectRelativePath, `Historical package path escapes the temporary project: ${projectRelativePath}`);
+    }
+    return target;
+}
+function isContainedPath(root, path) {
+    const contained = relative(resolve(root), resolve(path));
+    return (contained.length > 0 &&
+        contained !== ".." &&
+        !contained.startsWith("..\\") &&
+        !contained.startsWith("../") &&
+        !isAbsolute(contained));
+}
+function validateMutations(projectRoot, mutations) {
+    const targets = new Set();
+    return mutations.map((mutation) => {
+        const target = resolveContainedPath(projectRoot, mutation.projectRelativePath);
+        const key = target.toLocaleLowerCase("en-US");
+        if (targets.has(key)) {
+            throw invalidTarget(mutation.projectRelativePath, `Historical revision contains duplicate target ${mutation.projectRelativePath}.`);
+        }
+        targets.add(key);
+        return { mutation, target };
+    });
+}
+function makeHistoricalProjectTree(operationRoot) {
+    const projectRoot = resolve(operationRoot, "project");
+    const materializationRoot = resolve(operationRoot, "materialized");
+    const applyRevision = Effect.fn("HistoricalProjectTree.applyRevision")(function* (mutations) {
+        const validated = yield* Effect.try({
+            try: () => validateMutations(projectRoot, mutations),
+            catch: (cause) => cause instanceof MapHistoryError
+                ? cause
+                : invalidTarget("", `Historical revision targets are invalid: ${String(cause)}`)
+        });
+        for (const { mutation, target } of validated) {
+            if (mutation.action === "delete") {
+                yield* Effect.tryPromise({
+                    try: () => rm(target, { force: true }),
+                    catch: (cause) => temporaryStorageError("Delete historical package", target, cause)
+                });
+                continue;
+            }
+            yield* Effect.tryPromise({
+                try: async () => {
+                    await mkdir(dirname(target), { recursive: true });
+                    if (isContainedPath(materializationRoot, mutation.materializedPath)) {
+                        await rm(target, { force: true });
+                        await rename(mutation.materializedPath, target);
+                    }
+                    else {
+                        await copyFile(mutation.materializedPath, target);
+                    }
+                },
+                catch: (cause) => temporaryStorageError("Copy historical package", target, cause)
+            });
+        }
+    });
+    return { applyRevision, materializationRoot, projectRoot };
+}
+function isOwnedTemporaryProject(path) {
+    return (dirname(path) === resolve(tmpdir()) && basename(path).startsWith(TEMPORARY_PROJECT_PREFIX));
+}
+export function acquireHistoricalProjectTree() {
+    return Effect.acquireRelease(Effect.tryPromise({
+        try: async () => {
+            const operationRoot = await mkdtemp(resolve(tmpdir(), TEMPORARY_PROJECT_PREFIX));
+            await Promise.all([
+                mkdir(resolve(operationRoot, "materialized")),
+                mkdir(resolve(operationRoot, "project"))
+            ]);
+            return operationRoot;
+        },
+        catch: (cause) => temporaryStorageError("Create historical project", tmpdir(), cause)
+    }).pipe(Effect.map(makeHistoricalProjectTree)), (tree) => isOwnedTemporaryProject(dirname(tree.projectRoot))
+        ? Effect.promise(() => rm(dirname(tree.projectRoot), { force: true, recursive: true }))
+        : Effect.void);
+}
+//# sourceMappingURL=historical-project-tree.js.map

package/dist/historical-project-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical-project-tree.js","sourceRoot":"","sources":["../src/historical-project-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAExD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,KAAK,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,gBAAgB,EAAE,MAAM,CAAC,cAAc;QACvC,mBAAmB,EAAE,MAAM,CAAC,cAAc;KAC1C,CAAC;IACF,MAAM,CAAC,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QAChC,mBAAmB,EAAE,MAAM,CAAC,cAAc;KAC1C,CAAC;CACF,CAAC,CAAC;AAWH,SAAS,qBAAqB,CAAC,SAAiB,EAAE,IAAY,EAAE,KAAc;IAC7E,OAAO,IAAI,eAAe,CAAC;QAC1B,KAAK;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,GAAG,SAAS,eAAe,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE;QAC5D,QAAQ,EAAE,6EAA6E;QACvF,SAAS,EAAE,IAAI;KACf,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,OAAe;IACnD,OAAO,IAAI,eAAe,CAAC;QAC1B,IAAI,EAAE,gBAAgB;QACtB,OAAO;QACP,QAAQ,EAAE,4EAA4E;QACtF,SAAS,EAAE,KAAK;KAChB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAmB,EAAE,mBAA2B;IAC7E,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACzE,MAAM,aAAa,CAClB,mBAAmB,EACnB,qDAAqD,mBAAmB,EAAE,CAC1E,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACrD,IACC,cAAc,CAAC,MAAM,KAAK,CAAC;QAC3B,cAAc,KAAK,IAAI;QACvB,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC;QACjC,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC;QAChC,UAAU,CAAC,cAAc,CAAC,EACzB,CAAC;QACF,MAAM,aAAa,CAClB,mBAAmB,EACnB,0DAA0D,mBAAmB,EAAE,CAC/E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,IAAY;IAClD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,OAAO,CACN,SAAS,CAAC,MAAM,GAAG,CAAC;QACpB,SAAS,KAAK,IAAI;QAClB,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC;QAC7B,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;QAC5B,CAAC,UAAU,CAAC,SAAS,CAAC,CACtB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACzB,WAAmB,EACnB,SAA4C;IAE5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,aAAa,CAClB,QAAQ,CAAC,mBAAmB,EAC5B,iDAAiD,QAAQ,CAAC,mBAAmB,GAAG,CAChF,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,aAAqB;IACvD,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,qCAAqC,CAAC,CAAC,QAAQ,CAAC,EAC/E,SAA4C;QAE5C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACnC,GAAG,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC;YACpD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAChB,KAAK,YAAY,eAAe;gBAC/B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,4CAA4C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;SAClF,CAAC,CAAC;QACH,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAClC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;oBACxB,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;oBACtC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAChB,qBAAqB,CAAC,2BAA2B,EAAE,MAAM,EAAE,KAAK,CAAC;iBAClE,CAAC,CAAC;gBACH,SAAS;YACV,CAAC;YACD,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;gBACxB,GAAG,EAAE,KAAK,IAAI,EAAE;oBACf,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAClD,IAAI,eAAe,CAAC,mBAAmB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;wBACrE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;wBAClC,MAAM,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;oBACjD,CAAC;yBAAM,CAAC;wBACP,MAAM,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;oBACnD,CAAC;gBACF,CAAC;gBACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,yBAAyB,EAAE,MAAM,EAAE,KAAK,CAAC;aACjF,CAAC,CAAC;QACJ,CAAC;IACF,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAY;IAC5C,OAAO,CACN,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAC1F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B;IAK3C,OAAO,MAAM,CAAC,cAAc,CAC3B,MAAM,CAAC,UAAU,CAAC;QACjB,GAAG,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;YACjF,MAAM,OAAO,CAAC,GAAG,CAAC;gBACjB,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;gBAC7C,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;aACxC,CAAC,CAAC;YACH,OAAO,aAAa,CAAC;QACtB,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,2BAA2B,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC;KACrF,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,EAC9C,CAAC,IAAI,EAAE,EAAE,CACR,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CACpB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAC/D;QACF,CAAC,CAAC,MAAM,CAAC,IAAI,CACf,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./baseline-materialization.js";
+export * from "./diff.js";
+export * from "./errors.js";
+export * from "./fast-history-target.js";
+export * from "./map-history.js";
+export * from "./package-correlation.js";
+export * from "./playback.js";
+export * from "./perforce.js";
+export * from "./perforce-map-scope.js";
+export * from "./revision-plan.js";
+export * from "./revision-materialization.js";
+export * from "./schema.js";
+export * from "./submitted-change-selection.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,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,aAAa,CAAC;AAC5B,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from "./baseline-materialization.js";
+export * from "./diff.js";
+export * from "./errors.js";
+export * from "./fast-history-target.js";
+export * from "./map-history.js";
+export * from "./package-correlation.js";
+export * from "./playback.js";
+export * from "./perforce.js";
+export * from "./perforce-map-scope.js";
+export * from "./revision-plan.js";
+export * from "./revision-materialization.js";
+export * from "./schema.js";
+export * from "./submitted-change-selection.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,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,aAAa,CAAC;AAC5B,cAAc,iCAAiC,CAAC"}

package/dist/map-history.d.ts

@@ -0,0 +1,24 @@
+import { Context, Effect, Layer } from "effect";
+import { AssetReader } from "@ue-shed/unreal-assets";
+import { MapHistoryError } from "./errors.js";
+import { PerforceHistorySource } from "./perforce.js";
+import { type MapHistoryProgress, type PerforceFastMapHistory, type PerforceFastMapHistoryQuery, type PerforceMapHistory, type PerforceMapHistoryQuery } from "./schema.js";
+export interface MapHistoryShape {
+    readonly progress: () => Effect.Effect<MapHistoryProgress>;
+    readonly readPerforceMapHistory: (query: PerforceMapHistoryQuery) => Effect.Effect<PerforceMapHistory, MapHistoryError>;
+    readonly readPerforceFastMapHistory: (query: PerforceFastMapHistoryQuery) => Effect.Effect<PerforceFastMapHistory, MapHistoryError>;
+}
+declare const MapHistory_base: Context.ServiceClass<MapHistory, "@ue-shed/map-history/MapHistory", MapHistoryShape>;
+/** The Perforce-first Map History workflow. It owns no credentials or source-control policy. */
+export declare class MapHistory extends MapHistory_base {
+}
+/** Builds Map History from injected snapshot and Perforce boundaries. */
+export declare const mapHistoryLayer: Layer.Layer<MapHistory, never, AssetReader | PerforceHistorySource>;
+/** The optional default layer uses the configured asset reader and local Perforce configuration. */
+export declare const mapHistoryLiveLayer: Layer.Layer<MapHistory, import("effect/Config").ConfigError, never>;
+export declare function makeMapHistoryTestLayer(service: MapHistoryShape): Layer.Layer<MapHistory>;
+export declare function readPerforceMapHistory(query: PerforceMapHistoryQuery): Effect.Effect<PerforceMapHistory, MapHistoryError, MapHistory>;
+export declare function readPerforceFastMapHistory(query: PerforceFastMapHistoryQuery): Effect.Effect<PerforceFastMapHistory, MapHistoryError, MapHistory>;
+export declare function mapHistoryProgress(): Effect.Effect<MapHistoryProgress, never, MapHistory>;
+export {};
+//# sourceMappingURL=map-history.d.ts.map

package/dist/map-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-history.d.ts","sourceRoot":"","sources":["../src/map-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAQ,KAAK,EAAO,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,WAAW,EAA0C,MAAM,wBAAwB,CAAC;AAI7F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,EAGN,qBAAqB,EAErB,MAAM,eAAe,CAAC;AAUvB,OAAO,EAEN,KAAK,kBAAkB,EAIvB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAI5B,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC3D,QAAQ,CAAC,sBAAsB,EAAE,CAChC,KAAK,EAAE,uBAAuB,KAC1B,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;IACxD,QAAQ,CAAC,0BAA0B,EAAE,CACpC,KAAK,EAAE,2BAA2B,KAC9B,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;CAC5D;;AAED,gGAAgG;AAChG,qBAAa,UAAW,SAAQ,eAE/B;CAAG;AAiaJ,yEAAyE;AACzE,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,qBAAqB,CA4C9F,CAAC;AAEH,oGAAoG;AACpG,eAAO,MAAM,mBAAmB,qEAG/B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAEzF;AAED,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,uBAAuB,GAC5B,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,EAAE,UAAU,CAAC,CAEhE;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,2BAA2B,GAChC,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,eAAe,EAAE,UAAU,CAAC,CAEpE;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,EAAE,UAAU,CAAC,CAEzF"}