@konitif/workbench 0.285.7 → 0.285.8

package/dist/application/experience/experienceLifecycle.d.ts

@@ -60,4 +60,5 @@ export declare function transitionWorkbenchExperienceLifecycle<TMetadata>(input:
     experience: WorkbenchExperience<TMetadata>;
     expected: Exclude<ExperienceLifecycleStatus, 'tombstoned'>;
     next: ExperienceLifecycleStatus;
+    metadata?: TMetadata;
 }): ExperienceLifecycleResult<WorkbenchExperience<TMetadata>>;

package/dist/application/experience/experienceLifecycle.js

@@ -83,7 +83,11 @@ export function transitionWorkbenchExperienceLifecycle(input) {
     if (!isAllowedTransition(input.experience.lifecycle, input.next)) {
         return refused('experience.lifecycle.status-conflict', '$.next', `Experience lifecycle cannot transition from ${input.experience.lifecycle} to ${input.next}.`, undefined, input.next);
     }
-    return accepted({ ...input.experience, lifecycle: input.next });
+    return accepted({
+        ...input.experience,
+        lifecycle: input.next,
+        metadata: input.metadata ?? input.experience.metadata,
+    });
 }
 function isAllowedTransition(current, next) {
     return next === 'tombstoned'

package/dist/application/experience/experienceRepository.d.ts

@@ -38,5 +38,6 @@ export interface WorkbenchExperienceRepository<TMetadata = unknown, TSpecializat
         experienceId: ExperienceIdentity;
         expected: Exclude<ExperienceLifecycleStatus, 'tombstoned'>;
         next: ExperienceLifecycleStatus;
+        metadata?: TMetadata;
     }): Promise<WorkbenchExperienceRepositoryResult<WorkbenchExperience<TMetadata>>>;
 }

package/dist/infrastructure/persistence/BrowserExperienceRepository.d.ts

@@ -1,8 +1,11 @@
-import type { WorkbenchExperienceRepository } from "../../application/experience/experienceRepository.js";
+import type { WorkbenchExperienceRepository, WorkbenchExperienceRepositoryResult, WorkbenchExperienceRepositorySnapshot } from "../../application/experience/experienceRepository.js";
 export interface BrowserExperienceRepositoryStorage {
     getItem(key: string): string | null;
     setItem(key: string, value: string): void;
 }
+export interface BrowserWorkbenchExperienceRepository<TMetadata = unknown, TSpecialization = unknown> extends WorkbenchExperienceRepository<TMetadata, TSpecialization> {
+    initialize(snapshot: WorkbenchExperienceRepositorySnapshot<TMetadata, TSpecialization>): Promise<WorkbenchExperienceRepositoryResult<WorkbenchExperienceRepositorySnapshot<TMetadata, TSpecialization>>>;
+}
 /**
  * Browser persistence adapter for the generic Workbench Experience authority.
  * Products choose the storage key and keep migration and specialization policy
@@ -11,4 +14,4 @@ export interface BrowserExperienceRepositoryStorage {
 export declare function createBrowserWorkbenchExperienceRepository<TMetadata = unknown, TSpecialization = unknown>(input: {
     storageKey: string;
     storage?: BrowserExperienceRepositoryStorage | null;
-}): WorkbenchExperienceRepository<TMetadata, TSpecialization>;
+}): BrowserWorkbenchExperienceRepository<TMetadata, TSpecialization>;

package/dist/infrastructure/persistence/BrowserExperienceRepository.js

@@ -10,6 +10,18 @@ export function createBrowserWorkbenchExperienceRepository(input) {
     const storageKey = requireStorageKey(input.storageKey);
     return {
         hydrate: () => hydrate(storage, storageKey),
+        async initialize(snapshot) {
+            const current = await hydrate(storage, storageKey);
+            if (!current.ok)
+                return current;
+            if (current.value.experiences.length > 0 || current.value.revisions.length > 0) {
+                return refused('experience.repository.already-exists', 'Browser Experience repository is already initialized.');
+            }
+            if (!isRepositorySnapshot(snapshot)) {
+                return refused('experience.repository.invalid-artifact', 'Initial Experience snapshot does not match the Workbench contract.');
+            }
+            return persist(storage, storageKey, snapshot);
+        },
         async list() {
             const snapshot = await hydrate(storage, storageKey);
             return snapshot.ok ? accepted(snapshot.value.experiences) : snapshot;
@@ -78,6 +90,7 @@ export function createBrowserWorkbenchExperienceRepository(input) {
                 experience,
                 expected: value.expected,
                 next: value.next,
+                metadata: value.metadata,
             });
             if (!transitioned.ok)
                 return lifecycleRefused(transitioned.diagnostics[0]);
@@ -141,6 +154,11 @@ function isStoredRepository(value) {
         || !Array.isArray(value.experiences)
         || !Array.isArray(value.revisions))
         return false;
+    return isRepositorySnapshot(value);
+}
+function isRepositorySnapshot(value) {
+    if (!isRecord(value) || !Array.isArray(value.experiences) || !Array.isArray(value.revisions))
+        return false;
     const experiences = value.experiences;
     const revisions = value.revisions;
     if (!experiences.every(isWorkbenchExperience) || !revisions.every(isWorkbenchExperienceRevision))
@@ -149,7 +167,9 @@ function isStoredRepository(value) {
         && isIdentity(revision.experienceId, 'experience')
         && isIdentity(revision.id, 'experience-revision')
         && revision.experienceId.value === experience.id.value
-        && revision.id.value === experience.headRevisionId.value));
+        && revision.id.value === experience.headRevisionId.value)) && revisions.every(revision => experiences.some(experience => isRecord(revision)
+        && isIdentity(revision.experienceId, 'experience')
+        && revision.experienceId.value === experience.id.value));
 }
 function isWorkbenchExperience(value) {
     return isRecord(value)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@konitif/workbench",
   "license": "PolyForm-Noncommercial-1.0.0",
-  "version": "0.285.7",
+  "version": "0.285.8",
   "description": "Workspace composition, docking, registries and hosting contracts for KONITIF.",
   "repository": {
     "type": "git",