@fps-games/editor 0.2.1-beta.2 → 0.2.1-beta.4

package/node_modules/@fps-games/editor-playable-sdk/dist/local-harness/forge-play-types.d.ts

@@ -1,4 +1,4 @@
-import type { PlayableLocalEditorDataSafetyOperation, PlayableLocalEditorInteractionPolicy, PlayableLocalEditorLoadingOverlayContent, PlayableLocalEditorSaveFailureState, PlayableLocalEditorUnsavedChangesState } from './types';
+import type { PlayableLocalEditorDataSafetyOperation, PlayableLocalEditorInteractionPolicy, PlayableLocalEditorLoadingOverlayContent, PlayableLocalEditorPreparedAuthoringSource, PlayableLocalEditorSaveFailureState, PlayableLocalEditorUnsavedChangesState } from './types';
 export type PlayableForgePlayMode = 'play' | 'edit';
 export interface PlayableForgePlayMessageEvent {
     source: unknown;
@@ -72,7 +72,25 @@ export interface PlayableForgePlaySaveState {
 }
 export interface PlayableForgePlayDocumentExportResult {
     documentFingerprint: string | null;
+    documentRevision: number | null;
+    expectedVersion?: number;
+    preparedAuthoringSource?: PlayableLocalEditorPreparedAuthoringSource;
 }
+export type PlayableForgePlaySaveTransactionPhase = 'idle' | 'preparing-authoring' | 'awaiting-platform-commit' | 'committing' | 'committed' | 'rejected';
+export interface PlayableForgePlaySaveTransactionRejection {
+    code: string;
+    message?: string;
+}
+export interface PlayableForgePlaySaveTransactionSnapshot {
+    readonly requestId: string | null;
+    readonly phase: PlayableForgePlaySaveTransactionPhase;
+    readonly stage: 'document.export' | 'document.commit' | null;
+    readonly expectedVersion?: number;
+    readonly actualVersion?: number;
+    readonly rejection: Readonly<PlayableForgePlaySaveTransactionRejection> | null;
+}
+/** @deprecated Use PlayableForgePlaySaveTransactionSnapshot. */
+export type PlayableForgePlaySaveTransaction = PlayableForgePlaySaveTransactionSnapshot;
 export interface PlayableForgePlayBridgeInstallOptions {
     window: PlayableForgePlayWindowLike;
     harness: PlayableForgePlayBridgeHarness;
@@ -94,6 +112,8 @@ export interface PlayableForgePlayBridgeInstallOptions {
         payload: Record<string, unknown>;
         saveState: PlayableForgePlaySaveState;
         documentFingerprint: string | null;
+        documentRevision: number | null;
+        preparedAuthoringSource?: PlayableLocalEditorPreparedAuthoringSource;
     }) => Promise<void>;
     exitEditor?: (reason: 'save' | 'discard') => Promise<boolean>;
     handleProjectAssetCommand?: (name: string, payload: Record<string, unknown>) => Promise<void>;
@@ -106,6 +126,8 @@ export interface PlayableForgePlayBridgeInstallOptions {
     reportError?: (error: unknown) => void;
     initialMode?: PlayableForgePlayMode;
     overlayHideDelayMs?: number;
+    /** Test hook for deterministic bridge-session assertions. */
+    createSessionId?: () => string;
 }
 export interface PlayableForgePlayModeBridge {
     switchMode(mode: PlayableForgePlayMode, options?: {
@@ -113,7 +135,11 @@ export interface PlayableForgePlayModeBridge {
     }): Promise<void>;
     commitPlatformSave(): Promise<void>;
     getMode(): PlayableForgePlayMode;
+    getSessionId(): string;
     getSaveState(): PlayableForgePlaySaveState;
+    getSaveTransaction(): PlayableForgePlaySaveTransactionSnapshot;
+    acknowledgeEditorSessionReady(): void;
+    postEvent(name: string, payload?: Record<string, unknown>): void;
     dispose(): void;
 }
 //# sourceMappingURL=forge-play-types.d.ts.map

package/node_modules/@fps-games/editor-playable-sdk/dist/local-harness/forge-play-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forge-play-types.d.ts","sourceRoot":"","sources":["../../src/local-harness/forge-play-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"forge-play-types.d.ts","sourceRoot":"","sources":["../../src/local-harness/forge-play-types.ts"],"names":[],"mappings":"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"}

package/node_modules/@fps-games/editor-playable-sdk/dist/local-harness/forge-play-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"forge-play-types.js","sourceRoot":"","sources":["../../src/local-harness/forge-play-types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  PlayableLocalEditorDataSafetyOperation,\n  PlayableLocalEditorInteractionPolicy,\n  PlayableLocalEditorLoadingOverlayContent,\n  PlayableLocalEditorSaveFailureState,\n  PlayableLocalEditorUnsavedChangesState,\n} from './types';\n\nexport type PlayableForgePlayMode = 'play' | 'edit';\n\nexport interface PlayableForgePlayMessageEvent {\n  source: unknown;\n  data: unknown;\n  stopImmediatePropagation?: () => void;\n}\n\nexport interface PlayableForgePlayWindowLike {\n  parent: {\n    postMessage(message: unknown, targetOrigin: string): void;\n  } | null;\n  addEventListener(\n    type: 'message',\n    listener: (event: PlayableForgePlayMessageEvent) => void,\n    options?: { capture?: boolean },\n  ): void;\n  removeEventListener(\n    type: 'message',\n    listener: (event: PlayableForgePlayMessageEvent) => void,\n    options?: { capture?: boolean },\n  ): void;\n  setTimeout(handler: () => void, timeout: number): unknown;\n  clearTimeout(id: unknown): void;\n  queueMicrotask?(handler: () => void): void;\n}\n\nexport type PlayableForgePlayOperationOrigin = 'user' | 'agent' | 'system';\nexport type PlayableForgePlayProjectionWaitPolicy = 'none' | 'settled';\nexport type PlayableForgePlayHistoryOperation = 'undo' | 'redo';\n\nexport interface PlayableForgePlayHistoryOperationOptions {\n  origin?: PlayableForgePlayOperationOrigin;\n  waitForProjection?: PlayableForgePlayProjectionWaitPolicy;\n}\n\nexport interface PlayableForgePlayHistoryProjectionResult {\n  waitPolicy: PlayableForgePlayProjectionWaitPolicy;\n  idle: boolean;\n  activeBatchIds: number[];\n  lastBatch: unknown | null;\n}\n\nexport interface PlayableForgePlayHistoryStateResult {\n  canUndo: boolean;\n  canRedo: boolean;\n}\n\nexport interface PlayableForgePlayHistoryOperationResult<TDocument = unknown> {\n  ok: boolean;\n  operation: PlayableForgePlayHistoryOperation;\n  origin: PlayableForgePlayOperationOrigin;\n  waitForProjection: PlayableForgePlayProjectionWaitPolicy;\n  documentChanged: boolean;\n  transactionLabel: string | null;\n  workingDocument: TDocument | null;\n  dirty: boolean;\n  history: PlayableForgePlayHistoryStateResult;\n  status: string;\n  projection: PlayableForgePlayHistoryProjectionResult;\n  error?: string;\n}\n\nexport interface PlayableForgePlayBridgeHarness {\n  enterEditor(): Promise<void>;\n  saveScene(): Promise<boolean>;\n  discardAndRunGame(): Promise<void>;\n  render(): void;\n  getWorkingDocument(): unknown | null;\n  getUnsavedChangesState?(): PlayableLocalEditorUnsavedChangesState;\n  getSaveFailureState?(): PlayableLocalEditorSaveFailureState | null;\n  undo?(options?: PlayableForgePlayHistoryOperationOptions): Promise<PlayableForgePlayHistoryOperationResult>;\n  redo?(options?: PlayableForgePlayHistoryOperationOptions): Promise<PlayableForgePlayHistoryOperationResult>;\n}\n\nexport interface PlayableForgePlayBridgeLoadingOverlay {\n  show(content: PlayableLocalEditorLoadingOverlayContent): void;\n  hide(): void;\n  isVisible(): boolean;\n}\n\nexport interface PlayableForgePlaySaveState {\n  preparedRevision: number;\n  committedRevision: number;\n}\n\nexport interface PlayableForgePlayDocumentExportResult {\n  documentFingerprint: string | null;\n}\n\nexport interface PlayableForgePlayBridgeInstallOptions {\n  window: PlayableForgePlayWindowLike;\n  harness: PlayableForgePlayBridgeHarness;\n  loadingOverlay: PlayableForgePlayBridgeLoadingOverlay;\n  loadingContent: {\n    saveScene: PlayableLocalEditorLoadingOverlayContent;\n    saveAndRunGame: PlayableLocalEditorLoadingOverlayContent;\n    discardAndRunGame: PlayableLocalEditorLoadingOverlayContent;\n  };\n  exportDocument?: (input: {\n    payload: Record<string, unknown>;\n    saveState: PlayableForgePlaySaveState;\n    postEvent: (name: string, payload?: Record<string, unknown>) => void;\n  }) => Promise<PlayableForgePlayDocumentExportResult> | PlayableForgePlayDocumentExportResult;\n  saveDocument?: (operation: PlayableLocalEditorDataSafetyOperation) => Promise<boolean>;\n  saveAndExitEditor?: (operation: PlayableLocalEditorDataSafetyOperation) => Promise<boolean>;\n  preflightRun?: () => Promise<boolean>;\n  commitDocument?: (input: {\n    payload: Record<string, unknown>;\n    saveState: PlayableForgePlaySaveState;\n    documentFingerprint: string | null;\n  }) => Promise<void>;\n  exitEditor?: (reason: 'save' | 'discard') => Promise<boolean>;\n  handleProjectAssetCommand?: (name: string, payload: Record<string, unknown>) => Promise<void>;\n  handleAssetDrop?: (payload: Record<string, unknown>) => void;\n  hasUnsavedPlatformChanges?: () => boolean;\n  interactions?: PlayableLocalEditorInteractionPolicy;\n  waitForPaint?: () => Promise<void>;\n  renderAfterEnter?: boolean;\n  readMode?: () => PlayableForgePlayMode;\n  reportError?: (error: unknown) => void;\n  initialMode?: PlayableForgePlayMode;\n  overlayHideDelayMs?: number;\n}\n\nexport interface PlayableForgePlayModeBridge {\n  switchMode(mode: PlayableForgePlayMode, options?: { save?: boolean }): Promise<void>;\n  commitPlatformSave(): Promise<void>;\n  getMode(): PlayableForgePlayMode;\n  getSaveState(): PlayableForgePlaySaveState;\n  dispose(): void;\n}\n"]}
+{"version":3,"file":"forge-play-types.js","sourceRoot":"","sources":["../../src/local-harness/forge-play-types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  PlayableLocalEditorDataSafetyOperation,\n  PlayableLocalEditorInteractionPolicy,\n  PlayableLocalEditorLoadingOverlayContent,\n  PlayableLocalEditorPreparedAuthoringSource,\n  PlayableLocalEditorSaveFailureState,\n  PlayableLocalEditorUnsavedChangesState,\n} from './types';\n\nexport type PlayableForgePlayMode = 'play' | 'edit';\n\nexport interface PlayableForgePlayMessageEvent {\n  source: unknown;\n  data: unknown;\n  stopImmediatePropagation?: () => void;\n}\n\nexport interface PlayableForgePlayWindowLike {\n  parent: {\n    postMessage(message: unknown, targetOrigin: string): void;\n  } | null;\n  addEventListener(\n    type: 'message',\n    listener: (event: PlayableForgePlayMessageEvent) => void,\n    options?: { capture?: boolean },\n  ): void;\n  removeEventListener(\n    type: 'message',\n    listener: (event: PlayableForgePlayMessageEvent) => void,\n    options?: { capture?: boolean },\n  ): void;\n  setTimeout(handler: () => void, timeout: number): unknown;\n  clearTimeout(id: unknown): void;\n  queueMicrotask?(handler: () => void): void;\n}\n\nexport type PlayableForgePlayOperationOrigin = 'user' | 'agent' | 'system';\nexport type PlayableForgePlayProjectionWaitPolicy = 'none' | 'settled';\nexport type PlayableForgePlayHistoryOperation = 'undo' | 'redo';\n\nexport interface PlayableForgePlayHistoryOperationOptions {\n  origin?: PlayableForgePlayOperationOrigin;\n  waitForProjection?: PlayableForgePlayProjectionWaitPolicy;\n}\n\nexport interface PlayableForgePlayHistoryProjectionResult {\n  waitPolicy: PlayableForgePlayProjectionWaitPolicy;\n  idle: boolean;\n  activeBatchIds: number[];\n  lastBatch: unknown | null;\n}\n\nexport interface PlayableForgePlayHistoryStateResult {\n  canUndo: boolean;\n  canRedo: boolean;\n}\n\nexport interface PlayableForgePlayHistoryOperationResult<TDocument = unknown> {\n  ok: boolean;\n  operation: PlayableForgePlayHistoryOperation;\n  origin: PlayableForgePlayOperationOrigin;\n  waitForProjection: PlayableForgePlayProjectionWaitPolicy;\n  documentChanged: boolean;\n  transactionLabel: string | null;\n  workingDocument: TDocument | null;\n  dirty: boolean;\n  history: PlayableForgePlayHistoryStateResult;\n  status: string;\n  projection: PlayableForgePlayHistoryProjectionResult;\n  error?: string;\n}\n\nexport interface PlayableForgePlayBridgeHarness {\n  enterEditor(): Promise<void>;\n  saveScene(): Promise<boolean>;\n  discardAndRunGame(): Promise<void>;\n  render(): void;\n  getWorkingDocument(): unknown | null;\n  getUnsavedChangesState?(): PlayableLocalEditorUnsavedChangesState;\n  getSaveFailureState?(): PlayableLocalEditorSaveFailureState | null;\n  undo?(options?: PlayableForgePlayHistoryOperationOptions): Promise<PlayableForgePlayHistoryOperationResult>;\n  redo?(options?: PlayableForgePlayHistoryOperationOptions): Promise<PlayableForgePlayHistoryOperationResult>;\n}\n\nexport interface PlayableForgePlayBridgeLoadingOverlay {\n  show(content: PlayableLocalEditorLoadingOverlayContent): void;\n  hide(): void;\n  isVisible(): boolean;\n}\n\nexport interface PlayableForgePlaySaveState {\n  preparedRevision: number;\n  committedRevision: number;\n}\n\nexport interface PlayableForgePlayDocumentExportResult {\n  documentFingerprint: string | null;\n  documentRevision: number | null;\n  expectedVersion?: number;\n  preparedAuthoringSource?: PlayableLocalEditorPreparedAuthoringSource;\n}\n\nexport type PlayableForgePlaySaveTransactionPhase =\n  | 'idle'\n  | 'preparing-authoring'\n  | 'awaiting-platform-commit'\n  | 'committing'\n  | 'committed'\n  | 'rejected';\n\nexport interface PlayableForgePlaySaveTransactionRejection {\n  code: string;\n  message?: string;\n}\n\nexport interface PlayableForgePlaySaveTransactionSnapshot {\n  readonly requestId: string | null;\n  readonly phase: PlayableForgePlaySaveTransactionPhase;\n  readonly stage: 'document.export' | 'document.commit' | null;\n  readonly expectedVersion?: number;\n  readonly actualVersion?: number;\n  readonly rejection: Readonly<PlayableForgePlaySaveTransactionRejection> | null;\n}\n\n/** @deprecated Use PlayableForgePlaySaveTransactionSnapshot. */\nexport type PlayableForgePlaySaveTransaction = PlayableForgePlaySaveTransactionSnapshot;\n\nexport interface PlayableForgePlayBridgeInstallOptions {\n  window: PlayableForgePlayWindowLike;\n  harness: PlayableForgePlayBridgeHarness;\n  loadingOverlay: PlayableForgePlayBridgeLoadingOverlay;\n  loadingContent: {\n    saveScene: PlayableLocalEditorLoadingOverlayContent;\n    saveAndRunGame: PlayableLocalEditorLoadingOverlayContent;\n    discardAndRunGame: PlayableLocalEditorLoadingOverlayContent;\n  };\n  exportDocument?: (input: {\n    payload: Record<string, unknown>;\n    saveState: PlayableForgePlaySaveState;\n    postEvent: (name: string, payload?: Record<string, unknown>) => void;\n  }) => Promise<PlayableForgePlayDocumentExportResult> | PlayableForgePlayDocumentExportResult;\n  saveDocument?: (operation: PlayableLocalEditorDataSafetyOperation) => Promise<boolean>;\n  saveAndExitEditor?: (operation: PlayableLocalEditorDataSafetyOperation) => Promise<boolean>;\n  preflightRun?: () => Promise<boolean>;\n  commitDocument?: (input: {\n    payload: Record<string, unknown>;\n    saveState: PlayableForgePlaySaveState;\n    documentFingerprint: string | null;\n    documentRevision: number | null;\n    preparedAuthoringSource?: PlayableLocalEditorPreparedAuthoringSource;\n  }) => Promise<void>;\n  exitEditor?: (reason: 'save' | 'discard') => Promise<boolean>;\n  handleProjectAssetCommand?: (name: string, payload: Record<string, unknown>) => Promise<void>;\n  handleAssetDrop?: (payload: Record<string, unknown>) => void;\n  hasUnsavedPlatformChanges?: () => boolean;\n  interactions?: PlayableLocalEditorInteractionPolicy;\n  waitForPaint?: () => Promise<void>;\n  renderAfterEnter?: boolean;\n  readMode?: () => PlayableForgePlayMode;\n  reportError?: (error: unknown) => void;\n  initialMode?: PlayableForgePlayMode;\n  overlayHideDelayMs?: number;\n  /** Test hook for deterministic bridge-session assertions. */\n  createSessionId?: () => string;\n}\n\nexport interface PlayableForgePlayModeBridge {\n  switchMode(mode: PlayableForgePlayMode, options?: { save?: boolean }): Promise<void>;\n  commitPlatformSave(): Promise<void>;\n  getMode(): PlayableForgePlayMode;\n  getSessionId(): string;\n  getSaveState(): PlayableForgePlaySaveState;\n  getSaveTransaction(): PlayableForgePlaySaveTransactionSnapshot;\n  acknowledgeEditorSessionReady(): void;\n  postEvent(name: string, payload?: Record<string, unknown>): void;\n  dispose(): void;\n}\n"]}

package/node_modules/@fps-games/editor-playable-sdk/dist/local-harness/forge-play.d.ts

@@ -19,11 +19,13 @@ export declare const PLAYABLE_FORGE_PLAY_COMMAND: {
 };
 export declare const PLAYABLE_FORGE_PLAY_EVENT: {
     readonly SCENE_READY: "scene.ready";
+    readonly EDITOR_SESSION_READY: "editor.session.ready";
     readonly FIRST_FRAME: "scene.first_frame";
     readonly MODE_CHANGE: "mode.change";
     readonly HISTORY_UNDO_RESULT: "history.undo.result";
     readonly HISTORY_REDO_RESULT: "history.redo.result";
     readonly DOCUMENT_EXPORTED: "document.exported";
+    readonly DOCUMENT_COMMITTED: "document.committed";
     readonly ASSET_IMPORT_RESULT: "asset.import.result";
     readonly ASSET_UPDATE_RESULT: "asset.update.result";
     readonly ASSET_LIBRARY_REFRESHED: "asset.library.refreshed";

package/node_modules/@fps-games/editor-playable-sdk/dist/local-harness/forge-play.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forge-play.d.ts","sourceRoot":"","sources":["../../src/local-harness/forge-play.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qCAAqC,EACrC,iCAAiC,EACjC,wCAAwC,EAIxC,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,oBAAoB,CAAC;AAQ5B,eAAO,MAAM,iCAAiC,2BAA2B,CAAC;AAE1E,eAAO,MAAM,gCAAgC;;;CAGnC,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;;;;;;;;;;CAY9B,CAAC;AAEX,eAAO,MAAM,yBAAyB;;;;;;;;;;;;CAY5B,CAAC;AAEX,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAY/E,CAAC;AAEF,eAAO,MAAM,mCAAmC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAYtE,CAAC;AAEF,eAAO,MAAM,0CAA0C,aAMrD,CAAC;AAEH,eAAO,MAAM,oCAAoC,aAG/C,CAAC;AAEH,wBAAgB,gCAAgC,IAAI,0BAA0B,CAK7E;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGnF;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAInG;AAED,wBAAgB,4CAA4C,CAC1D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,wCAAwC,CAK1C;AAED,wBAAgB,0CAA0C,CACxD,SAAS,EAAE,iCAAiC,GAC3C,MAAM,CAIR;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,CAAC,EACvD,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,IAAI,CAcN;AAQD,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,qCAAqC,GAC7C,2BAA2B,CAid7B;AAED,wBAAgB,0CAA0C,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAO3F"}
+{"version":3,"file":"forge-play.d.ts","sourceRoot":"","sources":["../../src/local-harness/forge-play.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qCAAqC,EACrC,iCAAiC,EACjC,wCAAwC,EAIxC,2BAA2B,EAC3B,0BAA0B,EAG1B,2BAA2B,EAC5B,MAAM,oBAAoB,CAAC;AAS5B,eAAO,MAAM,iCAAiC,2BAA2B,CAAC;AAE1E,eAAO,MAAM,gCAAgC;;;CAGnC,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;;;;;;;;;;CAY9B,CAAC;AAEX,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;CAc5B,CAAC;AAEX,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAc/E,CAAC;AAEF,eAAO,MAAM,mCAAmC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAYtE,CAAC;AAEF,eAAO,MAAM,0CAA0C,aAMrD,CAAC;AAEH,eAAO,MAAM,oCAAoC,aAG/C,CAAC;AAEH,wBAAgB,gCAAgC,IAAI,0BAA0B,CAK7E;AAiBD,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGnF;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAInG;AAED,wBAAgB,4CAA4C,CAC1D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,wCAAwC,CAK1C;AAED,wBAAgB,0CAA0C,CACxD,SAAS,EAAE,iCAAiC,GAC3C,MAAM,CAIR;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,CAAC,EACvD,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,IAAI,CAcN;AAQD,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,qCAAqC,GAC7C,2BAA2B,CA0pB7B;AAED,wBAAgB,0CAA0C,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAO3F"}

package/node_modules/@fps-games/editor-playable-sdk/dist/local-harness/forge-play.js

@@ -19,11 +19,13 @@ export const PLAYABLE_FORGE_PLAY_COMMAND = {
 };
 export const PLAYABLE_FORGE_PLAY_EVENT = {
     SCENE_READY: 'scene.ready',
+    EDITOR_SESSION_READY: 'editor.session.ready',
     FIRST_FRAME: 'scene.first_frame',
     MODE_CHANGE: 'mode.change',
     HISTORY_UNDO_RESULT: 'history.undo.result',
     HISTORY_REDO_RESULT: 'history.redo.result',
     DOCUMENT_EXPORTED: 'document.exported',
+    DOCUMENT_COMMITTED: 'document.committed',
     ASSET_IMPORT_RESULT: 'asset.import.result',
     ASSET_UPDATE_RESULT: 'asset.update.result',
     ASSET_LIBRARY_REFRESHED: 'asset.library.refreshed',
@@ -32,11 +34,13 @@ export const PLAYABLE_FORGE_PLAY_EVENT = {
 };
 export const PLAYABLE_FORGE_PLAY_EVENT_ALIASES = {
     [PLAYABLE_FORGE_PLAY_EVENT.SCENE_READY]: ['scene:ready', 'lifecycle:ready'],
+    [PLAYABLE_FORGE_PLAY_EVENT.EDITOR_SESSION_READY]: ['editor:session:ready'],
     [PLAYABLE_FORGE_PLAY_EVENT.FIRST_FRAME]: ['scene:first_frame', 'lifecycle:firstFrame'],
     [PLAYABLE_FORGE_PLAY_EVENT.MODE_CHANGE]: ['mode:change', 'mode:changed'],
     [PLAYABLE_FORGE_PLAY_EVENT.HISTORY_UNDO_RESULT]: ['history:undo:result'],
     [PLAYABLE_FORGE_PLAY_EVENT.HISTORY_REDO_RESULT]: ['history:redo:result'],
     [PLAYABLE_FORGE_PLAY_EVENT.DOCUMENT_EXPORTED]: ['document:exported'],
+    [PLAYABLE_FORGE_PLAY_EVENT.DOCUMENT_COMMITTED]: ['document:committed'],
     [PLAYABLE_FORGE_PLAY_EVENT.ASSET_IMPORT_RESULT]: ['asset:import:result'],
     [PLAYABLE_FORGE_PLAY_EVENT.ASSET_UPDATE_RESULT]: ['asset:update:result'],
     [PLAYABLE_FORGE_PLAY_EVENT.ASSET_LIBRARY_REFRESHED]: ['asset:library:refreshed'],
@@ -73,6 +77,19 @@ export function createPlayableForgePlaySaveState() {
         committedRevision: 0,
     };
 }
+function createPlayableForgePlaySaveTransaction() {
+    return {
+        requestId: null,
+        phase: 'idle',
+        stage: null,
+        rejection: null,
+    };
+}
+function readPlayableForgePlayPlatformVersion(payload) {
+    return typeof payload.version === 'number' && Number.isFinite(payload.version)
+        ? payload.version
+        : undefined;
+}
 export function normalizePlayableForgePlayCommandName(value) {
     if (typeof value !== 'string')
         return null;
@@ -118,9 +135,15 @@ function readPlayableForgePlayHistoryOrigin(value) {
 }
 export function installPlayableForgePlayModeBridge(options) {
     let currentMode = options.initialMode ?? 'play';
+    const sessionId = options.createSessionId?.()
+        ?? `fps-${Date.now()}-${Math.random().toString(36).slice(2)}`;
     let inFlight = null;
     const saveState = createPlayableForgePlaySaveState();
+    let saveTransaction = createPlayableForgePlaySaveTransaction();
     let preparedDocumentFingerprint = null;
+    let preparedDocumentRevision = null;
+    let preparedCommittedDocumentFingerprint = null;
+    let preparedAuthoringSource = null;
     let committedDocumentFingerprint = null;
     let preparedRequestId = null;
     let commitInFlight = null;
@@ -131,10 +154,46 @@ export function installPlayableForgePlayModeBridge(options) {
     const invalidatePreparedPlatformSave = () => {
         saveState.preparedRevision = saveState.committedRevision;
         preparedDocumentFingerprint = null;
+        preparedDocumentRevision = null;
+        preparedCommittedDocumentFingerprint = null;
+        preparedAuthoringSource = null;
         preparedRequestId = null;
     };
+    const setSaveTransaction = (phase, input = {}) => {
+        const value = (key, fallback) => (Object.prototype.hasOwnProperty.call(input, key) ? input[key] : fallback);
+        const expectedVersion = value('expectedVersion', saveTransaction.expectedVersion);
+        const actualVersion = value('actualVersion', saveTransaction.actualVersion);
+        saveTransaction = {
+            requestId: value('requestId', saveTransaction.requestId),
+            phase,
+            stage: value('stage', saveTransaction.stage),
+            ...(expectedVersion === undefined ? {} : { expectedVersion }),
+            ...(actualVersion === undefined ? {} : { actualVersion }),
+            rejection: value('rejection', null),
+        };
+    };
     const postEvent = (name, payload = {}) => {
-        postPlayableForgePlayEvent(options.window, name, payload);
+        postPlayableForgePlayEvent(options.window, name, { ...payload, sessionId });
+    };
+    const acknowledgeEditorSessionReady = () => {
+        if (readMode() !== 'edit' || options.harness.getWorkingDocument() === null)
+            return;
+        postEvent(PLAYABLE_FORGE_PLAY_EVENT.EDITOR_SESSION_READY, {
+            mode: 'edit',
+            editorSessionReady: true,
+        });
+    };
+    const reportSaveTransactionError = (input) => {
+        const has = (key) => Object.prototype.hasOwnProperty.call(input, key);
+        postEvent(PLAYABLE_FORGE_PLAY_EVENT.SYSTEM_ERROR, {
+            code: input.code,
+            stage: input.stage,
+            expectedRequestId: has('expectedRequestId') ? input.expectedRequestId : saveTransaction.requestId,
+            actualRequestId: input.actualRequestId,
+            expectedVersion: has('expectedVersion') ? input.expectedVersion : saveTransaction.expectedVersion,
+            actualVersion: has('actualVersion') ? input.actualVersion : null,
+            ...(input.message ? { message: input.message } : {}),
+        });
     };
     const notifySaveFailed = async (operation, error) => {
         const notify = options.interactions?.notifySaveFailed;
@@ -248,6 +307,8 @@ export function installPlayableForgePlayModeBridge(options) {
             await inFlight;
         if (readMode() === mode && !shouldRunExit()) {
             postEvent(PLAYABLE_FORGE_PLAY_EVENT.MODE_CHANGE, { mode });
+            if (mode === 'edit')
+                acknowledgeEditorSessionReady();
             return;
         }
         inFlight = (async () => {
@@ -269,8 +330,12 @@ export function installPlayableForgePlayModeBridge(options) {
                     saveState.preparedRevision = 0;
                     saveState.committedRevision = 0;
                     preparedDocumentFingerprint = null;
+                    preparedDocumentRevision = null;
+                    preparedCommittedDocumentFingerprint = null;
+                    preparedAuthoringSource = null;
                     committedDocumentFingerprint = null;
                     preparedRequestId = null;
+                    saveTransaction = createPlayableForgePlaySaveTransaction();
                     await options.harness.enterEditor();
                     if (options.renderAfterEnter !== false)
                         options.harness.render();
@@ -369,41 +434,112 @@ export function installPlayableForgePlayModeBridge(options) {
         })();
         try {
             await inFlight;
+            if (mode === 'edit')
+                acknowledgeEditorSessionReady();
         }
         finally {
             inFlight = null;
         }
     };
     const commitPlatformSave = async (payload = {}) => {
+        const requestId = readPlayableForgePlayRequestId(payload) ?? null;
+        const actualVersion = readPlayableForgePlayPlatformVersion(payload);
+        if (!requestId) {
+            reportSaveTransactionError({
+                code: 'document_commit_request_id_required',
+                stage: 'document.commit',
+                actualRequestId: null,
+                actualVersion,
+            });
+            return;
+        }
         if (inFlight)
             await inFlight;
-        const requestId = readPlayableForgePlayRequestId(payload) ?? null;
-        if (!requestId || !preparedRequestId || requestId !== preparedRequestId)
+        if (saveTransaction.phase === 'committed' && requestId === saveTransaction.requestId)
+            return;
+        if (!preparedRequestId) {
+            reportSaveTransactionError({
+                code: 'document_commit_no_pending',
+                stage: 'document.commit',
+                actualRequestId: requestId,
+                actualVersion,
+            });
+            return;
+        }
+        if (requestId !== preparedRequestId) {
+            reportSaveTransactionError({
+                code: 'document_commit_request_id_mismatch',
+                stage: 'document.commit',
+                actualRequestId: requestId,
+                expectedRequestId: preparedRequestId,
+                actualVersion,
+            });
             return;
+        }
         if (commitInFlight) {
             if (commitInFlight.requestId === requestId)
                 return commitInFlight.promise;
             await commitInFlight.promise;
             return commitPlatformSave(payload);
         }
-        if (saveState.preparedRevision <= saveState.committedRevision)
+        if (saveState.preparedRevision <= saveState.committedRevision) {
+            reportSaveTransactionError({
+                code: 'document_commit_no_pending',
+                stage: 'document.commit',
+                actualRequestId: requestId,
+                expectedRequestId: preparedRequestId,
+                actualVersion,
+            });
             return;
+        }
+        setSaveTransaction('committing', {
+            requestId,
+            stage: 'document.commit',
+            actualVersion,
+        });
         const commitOperation = (async () => {
             try {
                 const currentDocumentFingerprint = createPlayableForgePlayDocumentFingerprint(options.harness.getWorkingDocument());
-                if (currentDocumentFingerprint !== preparedDocumentFingerprint) {
+                const hasProjectServiceTransaction = typeof preparedAuthoringSource?.serviceTransactionId === 'string'
+                    && preparedAuthoringSource.serviceTransactionId.length > 0;
+                if (!hasProjectServiceTransaction
+                    && currentDocumentFingerprint !== preparedDocumentFingerprint) {
                     throw new Error('Editor document changed after export; prepare a new export before commit.');
                 }
                 await options.commitDocument?.({
                     payload,
                     saveState,
                     documentFingerprint: preparedDocumentFingerprint,
+                    documentRevision: preparedDocumentRevision,
+                    ...(preparedAuthoringSource ? { preparedAuthoringSource } : {}),
                 });
                 saveState.committedRevision = saveState.preparedRevision;
-                committedDocumentFingerprint = preparedDocumentFingerprint;
+                committedDocumentFingerprint = preparedCommittedDocumentFingerprint
+                    ?? preparedDocumentFingerprint;
+                setSaveTransaction('committed', {
+                    requestId,
+                    stage: 'document.commit',
+                    actualVersion,
+                });
+                postEvent(PLAYABLE_FORGE_PLAY_EVENT.DOCUMENT_COMMITTED, {
+                    requestId,
+                    ...(saveTransaction.expectedVersion === undefined
+                        ? {}
+                        : { expectedVersion: saveTransaction.expectedVersion }),
+                    ...(actualVersion === undefined ? {} : { actualVersion }),
+                });
             }
             catch (error) {
                 invalidatePreparedPlatformSave();
+                setSaveTransaction('rejected', {
+                    requestId,
+                    stage: 'document.commit',
+                    actualVersion,
+                    rejection: {
+                        code: 'document_commit_failed',
+                        message: error instanceof Error ? error.message : String(error),
+                    },
+                });
                 throw error;
             }
         })();
@@ -443,6 +579,15 @@ export function installPlayableForgePlayModeBridge(options) {
         if (message.type !== PLAYABLE_FORGE_PLAY_POST_MESSAGE.COMMAND)
             return;
         const payload = readRecord(message.payload);
+        const hasSessionId = Object.prototype.hasOwnProperty.call(payload, 'sessionId');
+        if (hasSessionId && payload.sessionId !== sessionId) {
+            postEvent(PLAYABLE_FORGE_PLAY_EVENT.SYSTEM_ERROR, {
+                code: 'editor_session_mismatch',
+                expectedSessionId: sessionId,
+                actualSessionId: payload.sessionId,
+            });
+            return;
+        }
         const commandName = normalizePlayableForgePlayCommandName(payload.name);
         if (commandName === PLAYABLE_FORGE_PLAY_COMMAND.ASSETS_DROP) {
             options.handleAssetDrop?.(payload);
@@ -471,6 +616,18 @@ export function installPlayableForgePlayModeBridge(options) {
             const requestId = readPlayableForgePlayRequestId(payload);
             if (!requestId) {
                 scheduleSaveOverlayHide();
+                setSaveTransaction('rejected', {
+                    requestId: null,
+                    stage: 'document.export',
+                    rejection: { code: 'document_export_request_id_required' },
+                });
+                reportSaveTransactionError({
+                    code: 'document_export_request_id_required',
+                    stage: 'document.export',
+                    actualRequestId: null,
+                    expectedRequestId: null,
+                    expectedVersion: null,
+                });
                 postEvent(PLAYABLE_FORGE_PLAY_EVENT.DOCUMENT_EXPORTED, {
                     error: 'document_export_request_id_required',
                 });
@@ -484,10 +641,20 @@ export function installPlayableForgePlayModeBridge(options) {
                 });
                 return;
             }
+            setSaveTransaction('preparing-authoring', {
+                requestId,
+                stage: 'document.export',
+                expectedVersion: undefined,
+                actualVersion: undefined,
+                rejection: null,
+            });
             const exportDocument = options.exportDocument;
             const revisionBeforeExport = saveState.preparedRevision;
             const committedRevisionBeforeExport = saveState.committedRevision;
             const preparedFingerprintBeforeExport = preparedDocumentFingerprint;
+            const preparedDocumentRevisionBeforeExport = preparedDocumentRevision;
+            const preparedCommittedFingerprintBeforeExport = preparedCommittedDocumentFingerprint;
+            const preparedAuthoringSourceBeforeExport = preparedAuthoringSource;
             const committedFingerprintBeforeExport = committedDocumentFingerprint;
             const preparedRequestIdBeforeExport = preparedRequestId;
             const exported = exportDocument
@@ -499,15 +666,38 @@ export function installPlayableForgePlayModeBridge(options) {
                         throw new Error('Document export did not return the exported document fingerprint.');
                     }
                     preparedDocumentFingerprint = result.documentFingerprint;
+                    preparedDocumentRevision = result.documentRevision;
+                    preparedAuthoringSource = result.preparedAuthoringSource ?? null;
+                    preparedCommittedDocumentFingerprint = result.preparedAuthoringSource
+                        ? createPlayableForgePlayDocumentFingerprint(result.preparedAuthoringSource.document)
+                        : result.documentFingerprint;
                     committedDocumentFingerprint = null;
                     preparedRequestId = requestId;
+                    setSaveTransaction('awaiting-platform-commit', {
+                        requestId,
+                        stage: 'document.export',
+                        expectedVersion: result.expectedVersion,
+                        actualVersion: undefined,
+                        rejection: null,
+                    });
                 }
             }).catch(async (error) => {
                 saveState.preparedRevision = revisionBeforeExport;
                 saveState.committedRevision = committedRevisionBeforeExport;
                 preparedDocumentFingerprint = preparedFingerprintBeforeExport;
+                preparedDocumentRevision = preparedDocumentRevisionBeforeExport;
+                preparedCommittedDocumentFingerprint = preparedCommittedFingerprintBeforeExport;
+                preparedAuthoringSource = preparedAuthoringSourceBeforeExport;
                 committedDocumentFingerprint = committedFingerprintBeforeExport;
                 preparedRequestId = preparedRequestIdBeforeExport;
+                setSaveTransaction('rejected', {
+                    requestId,
+                    stage: 'document.export',
+                    rejection: {
+                        code: 'document_export_failed',
+                        message: error instanceof Error ? error.message : String(error),
+                    },
+                });
                 options.loadingOverlay.hide();
                 await notifySaveFailed('forge-play-document-export', error);
                 postEvent(PLAYABLE_FORGE_PLAY_EVENT.DOCUMENT_EXPORTED, {
@@ -545,9 +735,15 @@ export function installPlayableForgePlayModeBridge(options) {
     };
     options.window.addEventListener('message', onMessage, { capture: true });
     const postReadyEvents = () => {
-        postEvent(PLAYABLE_FORGE_PLAY_EVENT.SCENE_READY, { mode: readMode() });
+        const editorSessionReady = readMode() === 'edit' && options.harness.getWorkingDocument() !== null;
+        postEvent(PLAYABLE_FORGE_PLAY_EVENT.SCENE_READY, {
+            mode: readMode(),
+            editorSessionReady,
+        });
         postEvent(PLAYABLE_FORGE_PLAY_EVENT.FIRST_FRAME);
         postEvent(PLAYABLE_FORGE_PLAY_EVENT.MODE_CHANGE, { mode: readMode() });
+        if (editorSessionReady)
+            acknowledgeEditorSessionReady();
     };
     if (options.window.queueMicrotask)
         options.window.queueMicrotask(postReadyEvents);
@@ -559,9 +755,20 @@ export function installPlayableForgePlayModeBridge(options) {
         getMode() {
             return readMode();
         },
+        getSessionId() {
+            return sessionId;
+        },
         getSaveState() {
             return saveState;
         },
+        getSaveTransaction() {
+            return Object.freeze({
+                ...saveTransaction,
+                rejection: saveTransaction.rejection ? Object.freeze({ ...saveTransaction.rejection }) : null,
+            });
+        },
+        acknowledgeEditorSessionReady,
+        postEvent,
         dispose() {
             clearOverlayHideTimer();
             options.window.removeEventListener('message', onMessage, { capture: true });