sh3-core 0.5.0 → 0.5.2

package/dist/api.d.ts

@@ -23,4 +23,5 @@ export declare const capabilities: {
     readonly hotInstall: boolean;
 };
 export type { ServerShard, ServerShardContext } from './server-shard/types';
+export { VERSION } from './version';
 export { setTokenOverrides, clearTokenOverrides, getTokenOverrides, } from './theme';

package/dist/api.js

@@ -44,5 +44,7 @@ export const capabilities = {
     /** Whether this target supports hot-installing packages via dynamic import from blob URL. */
     hotInstall: typeof Blob !== 'undefined' && typeof URL.createObjectURL === 'function',
 };
+// Package version.
+export { VERSION } from './version';
 // Theme token override API (shell-level theming support).
 export { setTokenOverrides, clearTokenOverrides, getTokenOverrides, } from './theme';

package/dist/diagnostic/DiagnosticPanel.svelte

@@ -11,6 +11,7 @@
    * Reads through the public sh3 API surface only.
    */
 
+  import { onMount } from 'svelte';
   import {
     listRegisteredApps,
     getActiveApp,
@@ -25,11 +26,30 @@
   const regShards = $derived(Array.from(registeredShards.values()));
   const actShards = $derived(Array.from(activeShards.keys()));
 
+  let serverVersion = $state<string | null>(null);
+
+  onMount(async () => {
+    try {
+      const res = await fetch('/api/version');
+      if (res.ok) {
+        const data = await res.json();
+        serverVersion = data.version;
+      }
+    } catch {
+      // Server unreachable — leave null.
+    }
+  });
+
 </script>
 
 <div class="diagnostic">
   <h2>Diagnostic</h2>
 
+  <section>
+    <h3>Server version</h3>
+    <p>{serverVersion ?? '—'}</p>
+  </section>
+
   <section>
     <h3>Active app</h3>
     <p>{active ? `${active.label} (${active.id})` : 'none'}</p>

package/dist/shell-shard/ShellHome.svelte

@@ -6,7 +6,7 @@
    *   3. Elevate prompt — shown when not elevated
    */
 
-  import { listRegisteredApps, launchApp, isAdmin } from '../api';
+  import { listRegisteredApps, launchApp, isAdmin, VERSION } from '../api';
   import { elevate, deescalate } from '../auth/index';
 
   const apps = $derived(listRegisteredApps());
@@ -38,6 +38,7 @@
 <div class="shell-home">
   <header class="shell-home-header">
     <h1>SH3</h1>
+    <span class="shell-home-version">v{VERSION}</span>
     <span class="shell-home-alpha">alpha</span>
     {#if elevated}
       <button type="button" class="shell-home-deescalate" onclick={handleDeescalate}>
@@ -153,6 +154,11 @@
     color: var(--shell-accent);
     letter-spacing: 2px;
   }
+  .shell-home-version {
+    font-size: 13px;
+    color: var(--shell-fg-subtle);
+    letter-spacing: 0.04em;
+  }
   .shell-home-alpha {
     font-size: 11px;
     font-weight: 700;

package/dist/store/InstalledView.svelte

@@ -14,6 +14,8 @@
   const ctx = storeContext;
 
   let uninstallingIds = $state<Set<string>>(new Set());
+  let updatingIds = $state<Set<string>>(new Set());
+  let updateError = $state<string | null>(null);
 
   async function handleUninstall(id: string) {
     if (uninstallingIds.has(id)) return;
@@ -32,6 +34,23 @@
     }
   }
 
+  async function handleUpdate(id: string) {
+    if (updatingIds.has(id)) return;
+
+    updatingIds = new Set([...updatingIds, id]);
+    updateError = null;
+
+    try {
+      await ctx.updatePackage(id);
+    } catch (err) {
+      updateError = err instanceof Error ? err.message : String(err);
+    } finally {
+      const next = new Set(updatingIds);
+      next.delete(id);
+      updatingIds = next;
+    }
+  }
+
   function handleRefresh() {
     ctx.refreshInstalled();
   }
@@ -55,6 +74,10 @@
     <button class="installed-refresh" onclick={handleRefresh}>Refresh</button>
   </header>
 
+  {#if updateError}
+    <div class="installed-error">{updateError}</div>
+  {/if}
+
   {#if ctx.state.ephemeral.installed.length === 0}
     <div class="installed-empty">No packages installed.</div>
   {:else}
@@ -75,6 +98,17 @@
             <span>Installed: {formatDate(pkg.installedAt)}</span>
           </div>
           <div class="installed-item-actions">
+            {#if pkg.id in ctx.state.ephemeral.updatable}
+              {@const target = ctx.state.ephemeral.updatable[pkg.id]}
+              {@const updating = updatingIds.has(pkg.id)}
+              <button
+                class="installed-update-btn"
+                onclick={() => handleUpdate(pkg.id)}
+                disabled={updating || uninstalling}
+              >
+                {updating ? 'Updating...' : `Update -> ${target.latest.version}`}
+              </button>
+            {/if}
             <button
               class="installed-uninstall-btn"
               onclick={() => handleUninstall(pkg.id)}
@@ -182,6 +216,7 @@
   .installed-item-actions {
     display: flex;
     justify-content: flex-end;
+    gap: 8px;
   }
   .installed-uninstall-btn {
     padding: 4px 12px;
@@ -200,4 +235,30 @@
     opacity: 0.6;
     cursor: not-allowed;
   }
+  .installed-update-btn {
+    padding: 4px 12px;
+    background: var(--shell-warning, #ff9800);
+    color: #fff;
+    border: none;
+    border-radius: 4px;
+    cursor: pointer;
+    font-family: inherit;
+    font-size: 0.8125rem;
+  }
+  .installed-update-btn:hover:not(:disabled) {
+    filter: brightness(1.1);
+  }
+  .installed-update-btn:disabled {
+    opacity: 0.6;
+    cursor: not-allowed;
+  }
+  .installed-error {
+    padding: 8px 12px;
+    margin-bottom: 12px;
+    background: color-mix(in srgb, var(--shell-error, #d32f2f) 15%, transparent);
+    color: var(--shell-error, #d32f2f);
+    border: 1px solid var(--shell-error, #d32f2f);
+    border-radius: 4px;
+    font-size: 0.8125rem;
+  }
 </style>

package/dist/store/StoreView.svelte

@@ -17,6 +17,7 @@
   let search = $state('');
   let typeFilter = $state<'all' | 'shard' | 'app'>('all');
   let installingIds = $state<Set<string>>(new Set());
+  let updatingIds = $state<Set<string>>(new Set());
   let installError = $state<string | null>(null);
   let newRegistryUrl = $state('');
 
@@ -66,6 +67,31 @@
     return String(pkg.latest.contractVersion) !== String(contract.version);
   }
 
+  function hasUpdate(id: string): boolean {
+    return id in ctx.state.ephemeral.updatable;
+  }
+
+  function installedVersion(id: string): string {
+    return ctx.state.ephemeral.installed.find((p: InstalledPackage) => p.id === id)?.version ?? '';
+  }
+
+  async function handleUpdate(id: string) {
+    if (updatingIds.has(id)) return;
+
+    updatingIds = new Set([...updatingIds, id]);
+    installError = null;
+
+    try {
+      await ctx.updatePackage(id);
+    } catch (err) {
+      installError = err instanceof Error ? err.message : String(err);
+    } finally {
+      const next = new Set(updatingIds);
+      next.delete(id);
+      updatingIds = next;
+    }
+  }
+
   async function handleInstall(pkg: ResolvedPackage) {
     const id = pkg.entry.id;
     if (installingIds.has(id)) return;
@@ -181,6 +207,8 @@
       {@const installed = isInstalled(pkg.entry.id)}
       {@const mismatch = hasContractMismatch(pkg)}
       {@const installing = installingIds.has(pkg.entry.id)}
+      {@const updatable = hasUpdate(pkg.entry.id)}
+      {@const updating = updatingIds.has(pkg.entry.id)}
       <div class="store-card">
         <div class="store-card-header">
           <div class="store-card-icon">
@@ -208,7 +236,15 @@
           </div>
         {/if}
         <div class="store-card-actions">
-          {#if installed}
+          {#if installed && updatable}
+            <button
+              class="store-update-btn"
+              onclick={() => handleUpdate(pkg.entry.id)}
+              disabled={updating}
+            >
+              {updating ? 'Updating...' : `Update ${installedVersion(pkg.entry.id)} -> ${pkg.latest.version}`}
+            </button>
+          {:else if installed}
             <span class="store-installed-label">Installed</span>
           {:else}
             <button
@@ -423,6 +459,23 @@
     color: var(--shell-success, #4caf50);
     font-weight: 600;
   }
+  .store-update-btn {
+    padding: 5px 14px;
+    background: var(--shell-warning, #ff9800);
+    color: #fff;
+    border: none;
+    border-radius: 4px;
+    cursor: pointer;
+    font-family: inherit;
+    font-size: 0.8125rem;
+  }
+  .store-update-btn:hover:not(:disabled) {
+    filter: brightness(1.1);
+  }
+  .store-update-btn:disabled {
+    opacity: 0.6;
+    cursor: not-allowed;
+  }
   .store-empty {
     text-align: center;
     padding: 32px 16px;

package/dist/store/storeApp.js

@@ -10,7 +10,7 @@ export const storeApp = {
     manifest: {
         id: 'sh3-store-app',
         label: 'Package Store',
-        version: '0.1.0',
+        version: '0.2.0',
         requiredShards: ['sh3-store'],
         layoutVersion: 1,
         admin: true,

package/dist/store/storeShard.svelte.d.ts

@@ -13,6 +13,7 @@ interface StoreZoneSchema {
     ephemeral: {
         catalog: ResolvedPackage[];
         installed: InstalledPackage[];
+        updatable: Record<string, ResolvedPackage>;
         loading: boolean;
         error: string | null;
     };
@@ -24,6 +25,7 @@ export interface StoreContext {
     isAdmin: boolean;
     refreshCatalog(): Promise<void>;
     refreshInstalled(): Promise<void>;
+    updatePackage(id: string): Promise<void>;
     addRegistry(url: string): Promise<void>;
     removeRegistry(url: string): Promise<void>;
 }

package/dist/store/storeShard.svelte.js

@@ -14,9 +14,31 @@
 import { mount, unmount } from 'svelte';
 import StoreView from './StoreView.svelte';
 import InstalledView from './InstalledView.svelte';
-import { fetchRegistries } from '../registry/client';
-import { listInstalledPackages } from '../registry/installer';
-import { fetchServerPackages } from '../env/client';
+import { fetchRegistries, fetchBundle, buildPackageMeta } from '../registry/client';
+import { installPackage, listInstalledPackages } from '../registry/installer';
+import { loadBundle, savePackage } from '../registry/storage';
+import { serverInstallPackage, fetchServerPackages } from '../env/client';
+/**
+ * Compare two semver-like version strings.
+ * Returns true only if `available` is strictly greater than `installed`.
+ * Compares major.minor.patch left-to-right as integers.
+ * Non-numeric segments are treated as 0.
+ */
+function isNewerVersion(available, installed) {
+    var _a, _b;
+    const a = available.split('.').map((s) => parseInt(s, 10) || 0);
+    const b = installed.split('.').map((s) => parseInt(s, 10) || 0);
+    const len = Math.max(a.length, b.length);
+    for (let i = 0; i < len; i++) {
+        const av = (_a = a[i]) !== null && _a !== void 0 ? _a : 0;
+        const bv = (_b = b[i]) !== null && _b !== void 0 ? _b : 0;
+        if (av > bv)
+            return true;
+        if (av < bv)
+            return false;
+    }
+    return false;
+}
 /**
  * Module-level context set during activate(). Imported by the Svelte
  * view components so they can read/write store state and trigger refreshes.
@@ -26,7 +48,7 @@ export const storeShard = {
     manifest: {
         id: 'sh3-store',
         label: 'Package Store',
-        version: '0.1.0',
+        version: '0.2.0',
         views: [
             { id: 'sh3-store:browse', label: 'Store' },
             { id: 'sh3-store:installed', label: 'Installed' },
@@ -38,16 +60,28 @@ export const storeShard = {
             ephemeral: {
                 catalog: [],
                 installed: [],
+                updatable: {},
                 loading: false,
                 error: null,
             },
         });
+        function recomputeUpdatable() {
+            const result = {};
+            for (const pkg of state.ephemeral.installed) {
+                const catalogEntry = state.ephemeral.catalog.find((c) => c.entry.id === pkg.id);
+                if (catalogEntry && isNewerVersion(catalogEntry.latest.version, pkg.version)) {
+                    result[pkg.id] = catalogEntry;
+                }
+            }
+            state.ephemeral.updatable = result;
+        }
         async function refreshCatalog() {
             state.ephemeral.loading = true;
             state.ephemeral.error = null;
             try {
                 const results = await fetchRegistries(env.registries);
                 state.ephemeral.catalog = results;
+                recomputeUpdatable();
             }
             catch (err) {
                 state.ephemeral.error =
@@ -71,6 +105,7 @@ export const storeShard = {
                         installedAt: (_c = p.installedAt) !== null && _c !== void 0 ? _c : '',
                     });
                 });
+                recomputeUpdatable();
             }
             catch (err) {
                 console.warn('[sh3-store] Failed to list installed packages:', err instanceof Error ? err.message : err);
@@ -78,6 +113,7 @@ export const storeShard = {
                 try {
                     const packages = await listInstalledPackages();
                     state.ephemeral.installed = packages;
+                    recomputeUpdatable();
                 }
                 catch (_a) {
                     // Nothing to show.
@@ -95,12 +131,57 @@ export const storeShard = {
             const registries = env.registries.filter((r) => r !== url);
             await ctx.envUpdate({ registries });
         }
+        async function updatePackage(id) {
+            var _a, _b;
+            const catalogEntry = state.ephemeral.updatable[id];
+            if (!catalogEntry)
+                return;
+            const installedRecord = state.ephemeral.installed.find((p) => p.id === id);
+            if (!installedRecord)
+                return;
+            // 1. Fetch new bundle.
+            const bundle = await fetchBundle(catalogEntry.latest, catalogEntry.sourceRegistry);
+            const meta = buildPackageMeta(catalogEntry, catalogEntry.latest);
+            // 2. Snapshot current state for rollback.
+            const oldBundle = await loadBundle(id);
+            const oldRecord = Object.assign({}, installedRecord);
+            // 3. Push to server.
+            const manifest = {
+                id: meta.id,
+                type: meta.type,
+                label: catalogEntry.entry.label,
+                version: meta.version,
+                contractVersion: meta.contractVersion,
+                sourceRegistry: meta.sourceRegistry,
+                installedAt: new Date().toISOString(),
+            };
+            const serverResult = await serverInstallPackage(manifest, bundle);
+            if (!serverResult.ok) {
+                throw new Error((_a = serverResult.error) !== null && _a !== void 0 ? _a : 'Server update failed');
+            }
+            // 4. Install locally (overwrites IndexedDB + re-registers).
+            const result = await installPackage(bundle, meta);
+            if (!result.success) {
+                // Rollback: restore old bundle and metadata.
+                if (oldBundle) {
+                    try {
+                        await savePackage(id, oldBundle, oldRecord);
+                    }
+                    catch (rollbackErr) {
+                        console.warn(`[sh3-store] Rollback failed for "${id}":`, rollbackErr instanceof Error ? rollbackErr.message : rollbackErr);
+                    }
+                }
+                throw new Error((_b = result.error) !== null && _b !== void 0 ? _b : 'Local install failed during update');
+            }
+            await refreshInstalled();
+        }
         storeContext = {
             env,
             state,
             get isAdmin() { return ctx.isAdmin; },
             refreshCatalog,
             refreshInstalled,
+            updatePackage,
             addRegistry,
             removeRegistry,
         };

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+/** sh3-core package version. Keep in sync with package.json. */
+export declare const VERSION = "0.5.1";

package/dist/version.js

@@ -0,0 +1,2 @@
+/** sh3-core package version. Keep in sync with package.json. */
+export const VERSION = '0.5.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh3-core",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "type": "module",
   "files": [
     "dist"