sh3-core 0.4.1 → 0.4.3

package/dist/apps/types.d.ts

@@ -28,6 +28,12 @@ export interface AppManifest {
      * user customization.
      */
     layoutVersion: number;
+    /**
+     * When true, the app is only visible on the shell home screen in
+     * admin mode. Server-side routes may still enforce their own auth
+     * independently. Defaults to false (visible to everyone).
+     */
+    admin?: boolean;
 }
 /**
  * Context object passed to `App.activate`. Provides app-scoped state zones

package/dist/build.js

@@ -112,7 +112,7 @@ export function sh3Artifact(options = {}) {
             }
         },
         async closeBundle() {
-            var _a;
+            var _a, _b, _c, _d;
             if (!entryFileName)
                 return;
             const clientSrc = join(outDir, entryFileName);
@@ -122,7 +122,7 @@ export function sh3Artifact(options = {}) {
             try {
                 source = readFileSync(clientSrc, 'utf-8');
             }
-            catch (_b) {
+            catch (_e) {
                 console.warn('[sh3-artifact] Could not read entry chunk:', clientSrc);
                 return;
             }
@@ -148,8 +148,28 @@ export function sh3Artifact(options = {}) {
                 copyFileSync(options.serverEntry, join(outDir, 'server.js'));
                 hasServer = true;
             }
+            // --- Read fallback metadata from package.json ---
+            let pkgDescription;
+            let pkgAuthor;
+            try {
+                const pkg = JSON.parse(readFileSync('package.json', 'utf-8'));
+                pkgDescription = typeof pkg.description === 'string' ? pkg.description : undefined;
+                pkgAuthor = typeof pkg.author === 'string'
+                    ? pkg.author
+                    : typeof ((_a = pkg.author) === null || _a === void 0 ? void 0 : _a.name) === 'string' ? pkg.author.name : undefined;
+            }
+            catch ( /* no package.json or unreadable */_f) { /* no package.json or unreadable */ }
             // --- Write manifest.json ---
-            const manifest = Object.assign(Object.assign({ id: id || 'unknown', type, label: label || id || 'unknown', version: version || '0.0.0', contractVersion: 1, client: 'client.js' }, (hasServer ? { server: 'server.js' } : {})), ((_a = options.manifest) !== null && _a !== void 0 ? _a : {}));
+            const overrides = (_b = options.manifest) !== null && _b !== void 0 ? _b : {};
+            const finalDescription = (_c = overrides.description) !== null && _c !== void 0 ? _c : pkgDescription;
+            const finalAuthor = (_d = overrides.author) !== null && _d !== void 0 ? _d : pkgAuthor;
+            if (!finalDescription) {
+                throw new Error('[sh3-artifact] Missing "description". Add it to package.json or pass it via sh3Artifact({ manifest: { description } }).');
+            }
+            if (!finalAuthor) {
+                throw new Error('[sh3-artifact] Missing "author". Add it to package.json or pass it via sh3Artifact({ manifest: { author } }).');
+            }
+            const manifest = Object.assign(Object.assign(Object.assign({ id: id || 'unknown', type, label: label || id || 'unknown', version: version || '0.0.0', contractVersion: 1, client: 'client.js' }, (hasServer ? { server: 'server.js' } : {})), { description: finalDescription, author: finalAuthor }), overrides);
             writeFileSync(join(outDir, 'manifest.json'), JSON.stringify(manifest, null, 2) + '\n');
             // --- Log summary ---
             const files = ['manifest.json', 'client.js'];

package/dist/diagnostic/diagnosticApp.js

@@ -13,6 +13,7 @@ export const diagnosticApp = {
         version: '0.1.0',
         requiredShards: ['diagnostic'],
         layoutVersion: 1,
+        admin: true,
     },
     initialLayout: {
         type: 'tabs',

package/dist/host-entry.d.ts

@@ -7,6 +7,5 @@ export { HttpDocumentBackend } from './documents/http-backend';
 export { installPackage, uninstallPackage, listInstalledPackages, loadInstalledPackages, } from './registry/index';
 export type { InstalledPackage, InstallResult, PackageMeta } from './registry/types';
 export { initAuth, elevate, deescalate } from './auth/index';
-export { adminAppIds } from './host';
 export { createShell } from './createShell';
 export type { ShellConfig } from './createShell';

package/dist/host-entry.js

@@ -12,6 +12,5 @@ export { HttpDocumentBackend } from './documents/http-backend';
 export { installPackage, uninstallPackage, listInstalledPackages, loadInstalledPackages, } from './registry/index';
 // Admin mode (host-only — elevate/deescalate drive the shell UI, initAuth runs at boot).
 export { initAuth, elevate, deescalate } from './auth/index';
-export { adminAppIds } from './host';
 // Shell boot factory.
 export { createShell } from './createShell';

package/dist/host.d.ts

@@ -14,9 +14,4 @@ export interface BootstrapConfig {
     excludeApps?: string[];
 }
 export declare function bootstrap(config?: BootstrapConfig): Promise<void>;
-/**
- * Set of app IDs that require admin mode. Framework-internal — used by
- * the shell home to gate visibility. Not part of the app contract.
- */
-export declare const adminAppIds: ReadonlySet<string>;
 export { installPackage, listInstalledPackages } from './registry/installer';

package/dist/host.js

@@ -77,9 +77,4 @@ export async function bootstrap(config) {
         await launchApp(lastId);
     }
 }
-/**
- * Set of app IDs that require admin mode. Framework-internal — used by
- * the shell home to gate visibility. Not part of the app contract.
- */
-export const adminAppIds = new Set(['sh3-store-app', 'diagnostic-app']);
 export { installPackage, listInstalledPackages } from './registry/installer';

package/dist/registry/client.js

@@ -82,9 +82,8 @@ export async function fetchRegistries(urls) {
  */
 export async function fetchBundle(version, sourceRegistry) {
     let url = version.bundleUrl;
-    if (sourceRegistry && url.startsWith('/')) {
-        const base = new URL(sourceRegistry);
-        url = `${base.origin}${url}`;
+    if (sourceRegistry && !/^https?:\/\//i.test(url)) {
+        url = new URL(url, sourceRegistry).href;
     }
     const response = await fetch(url);
     if (!response.ok) {

package/dist/registry/schema.js

@@ -71,7 +71,7 @@ function validatePackageEntry(data, path) {
     }
     const obj = data;
     requireString(obj, 'id', path);
-    requireOneOf(obj, 'type', ['shard', 'app'], path);
+    requireOneOf(obj, 'type', ['shard', 'app', 'combo'], path);
     requireString(obj, 'label', path);
     requireString(obj, 'description', path);
     // author: { name: string }

package/dist/registry/types.d.ts

@@ -47,7 +47,7 @@ export interface PackageEntry {
      * Whether this package is a shard (module that contributes views/commands)
      * or an app (composition document that wires shards into a layout).
      */
-    type: 'shard' | 'app';
+    type: 'shard' | 'app' | 'combo';
     /**
      * Human-readable display name shown in the store UI.
      * Should be short (under 40 characters).
@@ -161,7 +161,7 @@ export interface InstalledPackage {
     /**
      * Whether this is a shard or an app.
      */
-    type: 'shard' | 'app';
+    type: 'shard' | 'app' | 'combo';
     /**
      * The version that was installed.
      */
@@ -226,7 +226,7 @@ export interface PackageMeta {
     /**
      * Whether this is a shard or an app.
      */
-    type: 'shard' | 'app';
+    type: 'shard' | 'app' | 'combo';
     /**
      * The version being installed. Matches `PackageVersion.version`.
      */

package/dist/shell-shard/ShellHome.svelte

@@ -8,11 +8,10 @@
 
   import { listRegisteredApps, launchApp, isAdmin } from '../api';
   import { elevate, deescalate } from '../auth/index';
-  import { adminAppIds } from '../host';
 
   const apps = $derived(listRegisteredApps());
-  const userApps = $derived(apps.filter(m => !adminAppIds.has(m.id)));
-  const adminApps = $derived(apps.filter(m => adminAppIds.has(m.id)));
+  const userApps = $derived(apps.filter(m => !m.admin));
+  const adminApps = $derived(apps.filter(m => m.admin));
   const elevated = $derived(isAdmin());
 
   let keyInput = $state('');

package/dist/store/storeApp.d.ts

@@ -4,8 +4,7 @@
  * packages.
  *
  * Framework-shipped: registered in host.ts during bootstrap.
- * Admin-gated: the shell home checks adminAppIds to gate visibility;
- * the AppManifest itself carries no admin flag (ADR-011).
+ * Admin-gated via manifest flag (ADR-011).
  */
 import type { App } from '../apps/types';
 export declare const storeApp: App;

package/dist/store/storeApp.js

@@ -4,8 +4,7 @@
  * packages.
  *
  * Framework-shipped: registered in host.ts during bootstrap.
- * Admin-gated: the shell home checks adminAppIds to gate visibility;
- * the AppManifest itself carries no admin flag (ADR-011).
+ * Admin-gated via manifest flag (ADR-011).
  */
 export const storeApp = {
     manifest: {
@@ -14,6 +13,7 @@ export const storeApp = {
         version: '0.1.0',
         requiredShards: ['sh3-store'],
         layoutVersion: 1,
+        admin: true,
     },
     initialLayout: {
         type: 'tabs',

package/package.json

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