@liforma/publisher 0.5.0 → 0.7.1

package/dist/resources/costumes.js

@@ -0,0 +1,43 @@
+import { projectPath, publisherRequest } from '../http.js';
+import { waitForJob } from '../jobs.js';
+import { startJobFromEnvelope } from '../publishStart.js';
+import { wardrobePublishBody } from './clothes.js';
+import { createCostumePublishResponseSchema, deletedResourceResponseSchema, getCostumeResponseSchema } from '../schemas.js';
+export function createCostumesClient(http) {
+    const get = async (id, options) => {
+        const { data } = await publisherRequest(http, projectPath(http, `/costumes/${encodeURIComponent(id)}`), getCostumeResponseSchema, { method: 'GET', signal: options?.signal, retry: true });
+        return data.costume;
+    };
+    const startCreate = async (input, options) => startJobFromEnvelope(http, '/costumes', createCostumePublishResponseSchema, wardrobePublishBody(input), options?.signal);
+    return {
+        startCreate,
+        create: async (input, options = {}) => {
+            const started = await startCreate(input, options);
+            const completed = await waitForJob(http, started.id, options);
+            return get(completed.targetId, options);
+        },
+        get,
+        update: async (id, patch, options) => {
+            const { data } = await publisherRequest(http, projectPath(http, `/costumes/${encodeURIComponent(id)}`), getCostumeResponseSchema, {
+                method: 'PATCH',
+                body: { name: patch.name },
+                signal: options?.signal,
+                retry: true
+            });
+            return data.costume;
+        },
+        archive: async (id, options) => {
+            const { data } = await publisherRequest(http, projectPath(http, `/costumes/${encodeURIComponent(id)}/archive`), getCostumeResponseSchema, { method: 'POST', signal: options?.signal });
+            return data.costume;
+        },
+        restore: async (id, options) => {
+            const { data } = await publisherRequest(http, projectPath(http, `/costumes/${encodeURIComponent(id)}/restore`), getCostumeResponseSchema, { method: 'POST', signal: options?.signal });
+            return data.costume;
+        },
+        delete: async (id, options) => {
+            const { data } = await publisherRequest(http, projectPath(http, `/costumes/${encodeURIComponent(id)}`), deletedResourceResponseSchema, { method: 'DELETE', signal: options?.signal });
+            return data;
+        }
+    };
+}
+//# sourceMappingURL=costumes.js.map

package/dist/resources/costumes.js.map

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

package/dist/resources/createFrom.d.ts

@@ -0,0 +1,93 @@
+import { type PublisherHttp } from '../http.js';
+import { type ImageSource } from '../imageSource.js';
+import { type BackdropResource, type CharacterResource, type ClothesResource, type CostumeResource, type ExperienceResource, type ExperienceInteractionInput, type HairResource, type PersonaEthnicity, type PersonaGender, type PublishJob, type SetResource } from '../schemas.js';
+import type { BackgroundMode } from './clothes.js';
+export type PlateCreate = {
+    readonly image: ImageSource;
+    readonly name?: string;
+    readonly backgroundMode?: BackgroundMode;
+    readonly externalId?: string;
+    readonly forceNew?: boolean;
+};
+export type PlateOrId = {
+    readonly id: string;
+} | PlateCreate;
+export type BackdropCreate = {
+    readonly image: ImageSource;
+    readonly name?: string;
+    readonly externalId?: string;
+    readonly forceNew?: boolean;
+    readonly depth?: {
+        readonly image: ImageSource;
+        readonly depthMapType?: 'disparity';
+        readonly metersPerDepth?: number;
+    };
+};
+export type CreateFromBackdropInput = {
+    readonly id: string;
+} | BackdropCreate;
+export type CreateFromCharacterCreate = {
+    readonly avatarId: string;
+    readonly name: string;
+    readonly voice: string;
+    readonly sttLang: string;
+    readonly costume?: PlateOrId;
+    readonly clothes?: PlateOrId;
+    readonly hair?: PlateOrId;
+    readonly personality?: string;
+    readonly generalInstructions?: string;
+    readonly gender?: PersonaGender;
+    readonly age?: number;
+    readonly ethnicity?: PersonaEthnicity;
+    readonly externalId?: string;
+};
+export type CreateFromCharacterInput = {
+    readonly id: string;
+} | CreateFromCharacterCreate;
+export type CreateFromExperienceInput = {
+    readonly title: string;
+    readonly backdrop: CreateFromBackdropInput;
+    readonly character: CreateFromCharacterInput;
+    readonly set?: {
+        readonly name?: string;
+        readonly externalId?: string;
+    };
+    readonly slug?: string;
+    readonly attributes?: Record<string, string>;
+    readonly startingMessage?: string;
+    readonly systemInstructions?: string;
+    readonly introduction?: string;
+    readonly interaction?: ExperienceInteractionInput;
+    readonly publish?: boolean;
+    readonly externalId?: string;
+};
+export type CreateFromStage = 'backdrop' | 'costume' | 'clothes' | 'hair';
+export type CreateFromProgress = {
+    readonly stage: CreateFromStage;
+    readonly job: PublishJob;
+};
+export type CreateFromOptions = {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+    readonly onProgress?: (progress: CreateFromProgress) => void;
+};
+export type CreateFromResult = {
+    readonly experience: ExperienceResource;
+    readonly character: CharacterResource;
+    readonly set: SetResource;
+    readonly backdrop: BackdropResource;
+    readonly costume?: CostumeResource;
+    readonly clothes?: ClothesResource;
+    readonly hair?: HairResource;
+    readonly created: {
+        readonly experience: boolean;
+        readonly character: boolean;
+        readonly set: boolean;
+        readonly backdrop: boolean;
+        readonly costume?: boolean;
+        readonly clothes?: boolean;
+        readonly hair?: boolean;
+    };
+};
+export declare function createExperienceFrom(http: PublisherHttp, input: CreateFromExperienceInput, options?: CreateFromOptions): Promise<CreateFromResult>;
+//# sourceMappingURL=createFrom.d.ts.map

package/dist/resources/createFrom.d.ts.map

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

package/dist/resources/createFrom.js

@@ -0,0 +1,494 @@
+import { LiformaPublisherError } from '../errors.js';
+import { projectPath, publisherRequest } from '../http.js';
+import { resolveImageSource } from '../imageSource.js';
+import { waitForJob } from '../jobs.js';
+import { startJobWithOutcome } from '../publishStart.js';
+import { createBackdropPublishResponseSchema, createCharacterResponseSchema, createClothesPublishResponseSchema, createCostumePublishResponseSchema, createHairPublishResponseSchema, createSetResponseSchema, experienceResponseSchema, getBackdropResponseSchema, getClothesResponseSchema, getCostumeResponseSchema, getHairResponseSchema } from '../schemas.js';
+import { requireInput, requiredString } from '../validate.js';
+import { wardrobePublishBody } from './clothes.js';
+/** Prefer explicit `{ id }` reuse when both id and create fields are present. */
+function reuseId(value) {
+    if (!('id' in value))
+        return null;
+    const id = value.id;
+    if (typeof id !== 'string' || !id.trim())
+        return null;
+    return id.trim();
+}
+function withContext(error, step) {
+    if (error instanceof LiformaPublisherError) {
+        if (error.context?.operation === 'experiences.createFrom') {
+            return error;
+        }
+        return new LiformaPublisherError(error.message, {
+            code: error.code,
+            status: error.status,
+            requestId: error.requestId,
+            details: error.details,
+            retryable: error.retryable,
+            job: error.job,
+            cause: error,
+            context: {
+                operation: 'experiences.createFrom',
+                step
+            }
+        });
+    }
+    return new LiformaPublisherError(error instanceof Error ? error.message : 'experiences.createFrom failed.', {
+        code: 'UNKNOWN',
+        cause: error,
+        context: { operation: 'experiences.createFrom', step }
+    });
+}
+async function runStep(step, fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        throw withContext(error, step);
+    }
+}
+async function resolveUpload(http, image, options, purpose = 'colour') {
+    return runStep('resolveImage', () => resolveImageSource(http, image, { signal: options.signal, purpose }));
+}
+async function waitPlate(http, jobId, stage, options) {
+    return waitForJob(http, jobId, {
+        signal: options.signal,
+        timeoutMs: options.timeoutMs,
+        onProgress: options.onProgress
+            ? (job) => {
+                options.onProgress?.({ stage, job });
+            }
+            : undefined
+    });
+}
+async function getBackdrop(http, id, options) {
+    const { data } = await publisherRequest(http, projectPath(http, `/backdrops/${encodeURIComponent(id)}`), getBackdropResponseSchema, { method: 'GET', signal: options.signal, retry: true });
+    return data.backdrop;
+}
+async function getSet(http, id, options) {
+    const { data } = await publisherRequest(http, projectPath(http, `/sets/${encodeURIComponent(id)}`), createSetResponseSchema, { method: 'GET', signal: options.signal, retry: true });
+    return data.set;
+}
+async function getCharacter(http, id, options) {
+    const { data } = await publisherRequest(http, projectPath(http, `/characters/${encodeURIComponent(id)}`), createCharacterResponseSchema, { method: 'GET', signal: options.signal, retry: true });
+    return data.character;
+}
+async function resolveBackdrop(http, input, options, defaultName) {
+    const id = reuseId(input);
+    if (id) {
+        return runStep('backdrop', async () => ({
+            backdrop: await getBackdrop(http, id, options),
+            created: false
+        }));
+    }
+    if (!('image' in input)) {
+        throw new LiformaPublisherError('backdrop must be { id } or include image.', { code: 'INVALID_BODY' });
+    }
+    const create = input;
+    return runStep('backdrop', async () => {
+        const image = await resolveUpload(http, create.image, options, 'colour');
+        const depth = create.depth
+            ? {
+                image: await resolveUpload(http, create.depth.image, options, 'depth'),
+                ...(create.depth.depthMapType !== undefined
+                    ? { depthMapType: create.depth.depthMapType }
+                    : {}),
+                ...(create.depth.metersPerDepth !== undefined
+                    ? { metersPerDepth: create.depth.metersPerDepth }
+                    : {})
+            }
+            : undefined;
+        const metersPerDepth = depth?.metersPerDepth;
+        if (metersPerDepth !== undefined && (!Number.isFinite(metersPerDepth) || metersPerDepth <= 0)) {
+            throw new LiformaPublisherError('depth.metersPerDepth must be a positive number.', {
+                code: 'INVALID_BODY'
+            });
+        }
+        const started = await startJobWithOutcome(http, '/backdrops', createBackdropPublishResponseSchema, {
+            name: create.name?.trim() || defaultName,
+            uploadId: typeof image === 'string' ? image : image.uploadId,
+            ...(create.externalId !== undefined ? { externalId: create.externalId } : {}),
+            ...(create.forceNew !== undefined ? { forceNew: create.forceNew } : {}),
+            ...(depth
+                ? {
+                    depth: {
+                        uploadId: typeof depth.image === 'string' ? depth.image : depth.image.uploadId,
+                        ...(depth.depthMapType !== undefined
+                            ? { depthMapType: depth.depthMapType }
+                            : {}),
+                        ...(metersPerDepth !== undefined ? { metersPerDepth } : {})
+                    }
+                }
+                : {})
+        }, options.signal);
+        const completed = await waitPlate(http, started.job.id, 'backdrop', options);
+        return {
+            backdrop: await getBackdrop(http, completed.targetId, options),
+            created: started.created
+        };
+    });
+}
+async function resolveWardrobePlate(http, args) {
+    const { plate, stage, options } = args;
+    const id = reuseId(plate);
+    if (id) {
+        return runStep(stage, async () => {
+            const { data } = await publisherRequest(http, projectPath(http, args.getPath(id)), args.getSchema, { method: 'GET', signal: options.signal, retry: true });
+            return { resource: args.pick(data), created: false };
+        });
+    }
+    if (!('image' in plate)) {
+        throw new LiformaPublisherError(`${stage} must be { id } or include image.`, {
+            code: 'INVALID_BODY'
+        });
+    }
+    const create = plate;
+    return runStep(stage, async () => {
+        const image = await resolveUpload(http, create.image, options, 'colour');
+        const started = await startJobWithOutcome(http, args.path, args.startSchema, wardrobePublishBody({
+            avatarId: args.avatarId,
+            image,
+            name: create.name,
+            backgroundMode: create.backgroundMode ?? 'remove',
+            externalId: create.externalId,
+            forceNew: create.forceNew
+        }), options.signal);
+        const completed = await waitPlate(http, started.job.id, stage, options);
+        const { data } = await publisherRequest(http, projectPath(http, args.getPath(completed.targetId)), args.getSchema, { method: 'GET', signal: options.signal, retry: true });
+        return { resource: args.pick(data), created: started.created };
+    });
+}
+function assertAppearanceExclusive(character) {
+    const hasCostume = character.costume !== undefined;
+    const hasClothes = character.clothes !== undefined;
+    const hasHair = character.hair !== undefined;
+    if (hasCostume && (hasClothes || hasHair)) {
+        throw new LiformaPublisherError('Provide costume or clothes+hair, not both.', {
+            code: 'INVALID_BODY'
+        });
+    }
+    if (hasClothes !== hasHair) {
+        throw new LiformaPublisherError('clothes and hair must both be provided, or both omitted.', { code: 'INVALID_BODY' });
+    }
+}
+async function resolveAppearance(http, character, options) {
+    assertAppearanceExclusive(character);
+    if (character.costume) {
+        const costume = await resolveWardrobePlate(http, {
+            plate: character.costume,
+            stage: 'costume',
+            avatarId: character.avatarId,
+            path: '/costumes',
+            startSchema: createCostumePublishResponseSchema,
+            getPath: (id) => `/costumes/${encodeURIComponent(id)}`,
+            getSchema: getCostumeResponseSchema,
+            pick: (data) => data.costume,
+            options
+        });
+        return {
+            costume: costume.resource,
+            costumeId: costume.resource.id,
+            created: { costume: costume.created }
+        };
+    }
+    if (character.clothes && character.hair) {
+        const [clothes, hair] = await Promise.all([
+            resolveWardrobePlate(http, {
+                plate: character.clothes,
+                stage: 'clothes',
+                avatarId: character.avatarId,
+                path: '/clothes',
+                startSchema: createClothesPublishResponseSchema,
+                getPath: (id) => `/clothes/${encodeURIComponent(id)}`,
+                getSchema: getClothesResponseSchema,
+                pick: (data) => data.clothes,
+                options
+            }),
+            resolveWardrobePlate(http, {
+                plate: character.hair,
+                stage: 'hair',
+                avatarId: character.avatarId,
+                path: '/hair',
+                startSchema: createHairPublishResponseSchema,
+                getPath: (id) => `/hair/${encodeURIComponent(id)}`,
+                getSchema: getHairResponseSchema,
+                pick: (data) => data.hair,
+                options
+            })
+        ]);
+        return {
+            clothes: clothes.resource,
+            hair: hair.resource,
+            clothesId: clothes.resource.id,
+            hairId: hair.resource.id,
+            created: { clothes: clothes.created, hair: hair.created }
+        };
+    }
+    return { created: {} };
+}
+function characterCreateBody(body, appearance) {
+    return {
+        avatarId: requiredString(body.avatarId, 'character.avatarId'),
+        name: requiredString(body.name, 'character.name'),
+        voice: requiredString(body.voice, 'character.voice'),
+        sttLang: requiredString(body.sttLang, 'character.sttLang'),
+        ...(appearance?.costumeId !== undefined ? { costumeId: appearance.costumeId } : {}),
+        ...(appearance?.clothesId !== undefined ? { clothesId: appearance.clothesId } : {}),
+        ...(appearance?.hairId !== undefined ? { hairId: appearance.hairId } : {}),
+        ...(body.personality !== undefined ? { personality: body.personality } : {}),
+        ...(body.generalInstructions !== undefined
+            ? { generalInstructions: body.generalInstructions }
+            : {}),
+        ...(body.gender !== undefined ? { gender: body.gender } : {}),
+        ...(body.age !== undefined ? { age: body.age } : {}),
+        ...(body.ethnicity !== undefined ? { ethnicity: body.ethnicity } : {}),
+        ...(body.externalId !== undefined ? { externalId: body.externalId } : {})
+    };
+}
+function parseCharacterInput(input) {
+    const id = reuseId(input);
+    if (id) {
+        return { reuseId: id, create: null };
+    }
+    if (!('avatarId' in input)) {
+        throw new LiformaPublisherError('character must be { id } or include avatarId, name, voice, and sttLang.', { code: 'INVALID_BODY' });
+    }
+    requiredString(input.avatarId, 'character.avatarId');
+    requiredString(input.name, 'character.name');
+    requiredString(input.voice, 'character.voice');
+    requiredString(input.sttLang, 'character.sttLang');
+    assertAppearanceExclusive(input);
+    return { reuseId: null, create: input };
+}
+async function loadAppearanceFromCharacter(http, character, options) {
+    const created = {};
+    const out = { created };
+    if (character.costumeId) {
+        const { data } = await publisherRequest(http, projectPath(http, `/costumes/${encodeURIComponent(character.costumeId)}`), getCostumeResponseSchema, { method: 'GET', signal: options.signal, retry: true });
+        out.costume = data.costume;
+        out.costumeId = data.costume.id;
+        created.costume = false;
+    }
+    if (character.clothesId) {
+        const { data } = await publisherRequest(http, projectPath(http, `/clothes/${encodeURIComponent(character.clothesId)}`), getClothesResponseSchema, { method: 'GET', signal: options.signal, retry: true });
+        out.clothes = data.clothes;
+        out.clothesId = data.clothes.id;
+        created.clothes = false;
+    }
+    if (character.hairId) {
+        const { data } = await publisherRequest(http, projectPath(http, `/hair/${encodeURIComponent(character.hairId)}`), getHairResponseSchema, { method: 'GET', signal: options.signal, retry: true });
+        out.hair = data.hair;
+        out.hairId = data.hair.id;
+        created.hair = false;
+    }
+    return out;
+}
+/**
+ * Resolve character with externalId-safe wardrobe:
+ * - reuse `{ id }` → GET, no wardrobe create
+ * - create with externalId → probe create without appearance; on reuse skip wardrobe;
+ *   on new create, build wardrobe then PATCH appearance
+ * - create without externalId → wardrobe first, then create with appearance
+ */
+async function resolveCharacter(http, parsed, options, appearanceFactory) {
+    return runStep('character', async () => {
+        if (parsed.reuseId) {
+            const character = await getCharacter(http, parsed.reuseId, options);
+            const appearance = await loadAppearanceFromCharacter(http, character, options);
+            return { character, created: false, appearance };
+        }
+        const body = parsed.create;
+        const wantsAppearance = body.costume !== undefined || body.clothes !== undefined || body.hair !== undefined;
+        if (body.externalId) {
+            const { data, status } = await publisherRequest(http, projectPath(http, '/characters'), createCharacterResponseSchema, {
+                method: 'POST',
+                body: characterCreateBody(body),
+                signal: options.signal
+            });
+            const created = status === 201;
+            if (!created) {
+                const appearance = await loadAppearanceFromCharacter(http, data.character, options);
+                return { character: data.character, created: false, appearance };
+            }
+            if (!wantsAppearance) {
+                return { character: data.character, created: true, appearance: { created: {} } };
+            }
+            const appearance = await appearanceFactory();
+            const { data: patched } = await publisherRequest(http, projectPath(http, `/characters/${encodeURIComponent(data.character.id)}`), createCharacterResponseSchema, {
+                method: 'PATCH',
+                body: {
+                    ...(appearance.costumeId !== undefined
+                        ? { costumeId: appearance.costumeId }
+                        : {}),
+                    ...(appearance.clothesId !== undefined
+                        ? { clothesId: appearance.clothesId }
+                        : {}),
+                    ...(appearance.hairId !== undefined ? { hairId: appearance.hairId } : {})
+                },
+                signal: options.signal,
+                retry: true
+            });
+            return { character: patched.character, created: true, appearance };
+        }
+        const appearance = wantsAppearance
+            ? await appearanceFactory()
+            : { created: {} };
+        const { data, status } = await publisherRequest(http, projectPath(http, '/characters'), createCharacterResponseSchema, {
+            method: 'POST',
+            body: characterCreateBody(body, appearance),
+            signal: options.signal
+        });
+        return {
+            character: data.character,
+            created: status === 201,
+            appearance
+        };
+    });
+}
+export async function createExperienceFrom(http, input, options = {}) {
+    requireInput(input);
+    const title = requiredString(input.title, 'title');
+    if (!input.backdrop || typeof input.backdrop !== 'object') {
+        throw new LiformaPublisherError('backdrop is required.', { code: 'INVALID_BODY' });
+    }
+    if (!input.character || typeof input.character !== 'object') {
+        throw new LiformaPublisherError('character is required.', { code: 'INVALID_BODY' });
+    }
+    const defaultName = title;
+    let parsedCharacter;
+    try {
+        parsedCharacter = parseCharacterInput(input.character);
+    }
+    catch (error) {
+        throw withContext(error, 'character');
+    }
+    const appearanceFactory = () => {
+        if (!parsedCharacter.create) {
+            return Promise.resolve({ created: {} });
+        }
+        return resolveAppearance(http, parsedCharacter.create, options);
+    };
+    // Backdrop can run in parallel with character probe / wardrobe when safe.
+    // Character with externalId probes first (inside resolveCharacter) before wardrobe.
+    const backdropPromise = resolveBackdrop(http, input.backdrop, options, defaultName);
+    const characterNeedsWardrobeFirst = parsedCharacter.create &&
+        !parsedCharacter.create.externalId &&
+        (parsedCharacter.create.costume !== undefined ||
+            parsedCharacter.create.clothes !== undefined ||
+            parsedCharacter.create.hair !== undefined);
+    let backdropOutcome;
+    let characterOutcome;
+    if (characterNeedsWardrobeFirst) {
+        const [backdrop, appearance] = await Promise.all([
+            backdropPromise,
+            appearanceFactory()
+        ]);
+        backdropOutcome = backdrop;
+        characterOutcome = await resolveCharacter(http, parsedCharacter, options, async () => appearance);
+    }
+    else {
+        const [backdrop, character] = await Promise.all([
+            backdropPromise,
+            resolveCharacter(http, parsedCharacter, options, appearanceFactory)
+        ]);
+        backdropOutcome = backdrop;
+        characterOutcome = character;
+    }
+    const setOutcome = await runStep('set', async () => {
+        const { data, status } = await publisherRequest(http, projectPath(http, '/sets'), createSetResponseSchema, {
+            method: 'POST',
+            body: {
+                backdropId: backdropOutcome.backdrop.id,
+                ...(input.set?.name !== undefined
+                    ? { name: input.set.name }
+                    : { name: defaultName }),
+                ...(input.set?.externalId !== undefined
+                    ? { externalId: input.set.externalId }
+                    : {})
+            },
+            signal: options.signal
+        });
+        const created = status === 201;
+        if (!created) {
+            // Idempotent set reuse: return the set's real backdrop for a coherent snapshot.
+            const set = data.set;
+            const backdrop = await getBackdrop(http, set.backdropId, options);
+            backdropOutcome = { backdrop, created: false };
+            return { set, created: false };
+        }
+        return { set: data.set, created: true };
+    });
+    const experienceOutcome = await runStep('experience', async () => {
+        const { data, status } = await publisherRequest(http, projectPath(http, '/experiences'), experienceResponseSchema, {
+            method: 'POST',
+            body: {
+                title,
+                characterId: characterOutcome.character.id,
+                setId: setOutcome.set.id,
+                ...(input.slug !== undefined ? { slug: input.slug } : {}),
+                ...(input.attributes !== undefined ? { attributes: input.attributes } : {}),
+                ...(input.startingMessage !== undefined
+                    ? { startingMessage: input.startingMessage }
+                    : {}),
+                ...(input.systemInstructions !== undefined
+                    ? { systemInstructions: input.systemInstructions }
+                    : {}),
+                ...(input.introduction !== undefined ? { introduction: input.introduction } : {}),
+                ...(input.interaction !== undefined ? { interaction: input.interaction } : {}),
+                ...(input.publish !== undefined ? { publish: input.publish } : {}),
+                ...(input.externalId !== undefined ? { externalId: input.externalId } : {})
+            },
+            signal: options.signal
+        });
+        return { experience: data.experience, created: status === 201 };
+    });
+    // Experience externalId reuse: rebuild composition from the returned experience
+    // so the snapshot matches what is actually live (not orphans from this call).
+    if (!experienceOutcome.created) {
+        const experience = experienceOutcome.experience;
+        const characterId = experience.characterId;
+        const setId = experience.setId ?? experience.placeId;
+        if (!characterId || !setId) {
+            throw new LiformaPublisherError('Reused experience is missing characterId or setId.', { code: 'INVALID_RESPONSE' });
+        }
+        const character = await getCharacter(http, characterId, options);
+        const set = await getSet(http, setId, options);
+        const backdrop = await getBackdrop(http, set.backdropId, options);
+        const appearance = await loadAppearanceFromCharacter(http, character, options);
+        return {
+            experience,
+            character,
+            set,
+            backdrop,
+            ...(appearance.costume ? { costume: appearance.costume } : {}),
+            ...(appearance.clothes ? { clothes: appearance.clothes } : {}),
+            ...(appearance.hair ? { hair: appearance.hair } : {}),
+            created: {
+                experience: false,
+                character: false,
+                set: false,
+                backdrop: false,
+                ...appearance.created
+            }
+        };
+    }
+    const appearance = characterOutcome.appearance;
+    return {
+        experience: experienceOutcome.experience,
+        character: characterOutcome.character,
+        set: setOutcome.set,
+        backdrop: backdropOutcome.backdrop,
+        ...(appearance.costume ? { costume: appearance.costume } : {}),
+        ...(appearance.clothes ? { clothes: appearance.clothes } : {}),
+        ...(appearance.hair ? { hair: appearance.hair } : {}),
+        created: {
+            experience: experienceOutcome.created,
+            character: characterOutcome.created,
+            set: setOutcome.created,
+            backdrop: backdropOutcome.created,
+            ...appearance.created
+        }
+    };
+}
+//# sourceMappingURL=createFrom.js.map