sh3-core 0.25.0 → 0.25.1

package/dist/artifact.d.ts

@@ -10,6 +10,13 @@ export interface ArtifactManifest {
     id: string;
     /** Whether this is a shard or app (or both via combo bundle). */
     type: 'shard' | 'app' | 'combo';
+    /**
+     * Shard kind. Carried over from the source shard manifest so the server's
+     * project-allowlist middleware can auto-allow system-kind shards and
+     * resolve service-kind shards from `project.shardAllowlist`. Only set
+     * for `type: 'shard'`; apps and combos omit it.
+     */
+    kind?: 'system' | 'service';
     /** Human-readable display name. */
     label: string;
     /** Version string (semver). */

package/dist/build.d.ts

@@ -82,6 +82,14 @@ export declare function composeArtifactVersion(pkgVersion: string, suffix: strin
  * Exported for testing; used internally by sh3Artifact.
  */
 export declare function extractRequiredShardsFromBundle(bundleSource: string): string[];
+/**
+ * Read a shard `kind` field (`system` or `service`) from a single manifest
+ * block. Returns undefined when absent or set to any other value. Exported
+ * for testing; used by `sh3Artifact` to propagate the shard's runtime kind
+ * into the emitted `manifest.json` so server-side allowlist resolution can
+ * see it.
+ */
+export declare function extractShardKindFromBlock(block: string): 'system' | 'service' | undefined;
 /**
  * Collect all shard ids present in a bundle by scanning every `views: [` block.
  * Exported for testing.

package/dist/build.js

@@ -159,6 +159,17 @@ export function extractRequiredShardsFromBundle(bundleSource) {
         ids.push(m[1]);
     return ids;
 }
+/**
+ * Read a shard `kind` field (`system` or `service`) from a single manifest
+ * block. Returns undefined when absent or set to any other value. Exported
+ * for testing; used by `sh3Artifact` to propagate the shard's runtime kind
+ * into the emitted `manifest.json` so server-side allowlist resolution can
+ * see it.
+ */
+export function extractShardKindFromBlock(block) {
+    const m = block.match(/\bkind\s*:\s*["'](system|service)["']/);
+    return m ? m[1] : undefined;
+}
 /**
  * Collect all shard ids present in a bundle by scanning every `views: [` block.
  * Exported for testing.
@@ -301,15 +312,14 @@ export function sh3Artifact(options = {}) {
                 };
                 // Extract the requiredShards string-id array from the app manifest block.
                 const requiredShards = extractRequiredShardsFromBundle(block);
-                return {
-                    id: get(/\bid\s*:\s*["']([^"']+)["']/),
-                    label: get(/\blabel\s*:\s*["']([^"']+)["']/),
-                    requiredShards,
-                };
+                // Extract shard `kind` (system/service). Only meaningful when the
+                // anchored block is a shard block; app blocks won't carry it.
+                const kind = extractShardKindFromBlock(block);
+                return Object.assign(Object.assign({ id: get(/\bid\s*:\s*["']([^"']+)["']/), label: get(/\blabel\s*:\s*["']([^"']+)["']/) }, (kind ? { kind } : {})), { requiredShards });
             }
             // App first, then Shard.
             const extracted = (_a = extractFromBlock(/\brequiredShards\s*:\s*\[/)) !== null && _a !== void 0 ? _a : extractFromBlock(/\bviews\s*:\s*\[/);
-            const { id, label } = extracted;
+            const { id, label, kind } = extracted;
             let { requiredShards } = extracted;
             // Strip any shard ids that are bundled in this artifact from requiredShards.
             const bundledShardIds = extractBundledShardIds(source);
@@ -362,7 +372,7 @@ export function sh3Artifact(options = {}) {
             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(Object.assign(Object.assign({ id: id || 'unknown', type, label: label || id || 'unknown', version: artifactVersion, contractVersion: 1 }, (hasServer ? { server: 'server.js' } : {})), { description: finalDescription, author: finalAuthor }), ((type === 'app' || type === 'combo') ? { requiredShards } : {})), (type === 'combo' && bundledShardIds.size > 0 ? { bundledShards: [...bundledShardIds] } : {})), overrides);
+            const manifest = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ id: id || 'unknown', type, label: label || id || 'unknown', version: artifactVersion, contractVersion: 1 }, (type === 'shard' && kind ? { kind } : {})), (hasServer ? { server: 'server.js' } : {})), { description: finalDescription, author: finalAuthor }), ((type === 'app' || type === 'combo') ? { requiredShards } : {})), (type === 'combo' && bundledShardIds.size > 0 ? { bundledShards: [...bundledShardIds] } : {})), overrides);
             // Read the emitted JS files as bytes for the archive
             const clientBytes = readFileSync(join(outDir, 'client.js'));
             const serverBytes = hasServer ? readFileSync(join(outDir, 'server.js')) : undefined;

package/dist/build.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { composeArtifactVersion, extractRequiredShardsFromBundle, extractBundledShardIds } from './build';
+import { composeArtifactVersion, extractRequiredShardsFromBundle, extractBundledShardIds, extractShardKindFromBlock } from './build';
 describe('composeArtifactVersion', () => {
     it('returns pkgVersion unchanged when suffix is undefined', () => {
         expect(composeArtifactVersion('1.2.3', undefined)).toBe('1.2.3');
@@ -84,3 +84,29 @@ describe('extractBundledShardIds', () => {
         expect(filtered).toEqual(['external-dep']);
     });
 });
+describe('extractShardKindFromBlock', () => {
+    it('extracts kind: "system"', () => {
+        const block = `{ id: "ai", label: "AI", kind: "system", views: [] }`;
+        expect(extractShardKindFromBlock(block)).toBe('system');
+    });
+    it('extracts kind: "service"', () => {
+        const block = `{ id: "registry", kind: "service", views: [] }`;
+        expect(extractShardKindFromBlock(block)).toBe('service');
+    });
+    it('handles single-quoted kind', () => {
+        const block = `{ id: 'ai', kind: 'system', views: [] }`;
+        expect(extractShardKindFromBlock(block)).toBe('system');
+    });
+    it('handles minified format without spaces', () => {
+        const block = `{id:"ai",kind:"system",views:[]}`;
+        expect(extractShardKindFromBlock(block)).toBe('system');
+    });
+    it('returns undefined when kind is absent', () => {
+        const block = `{ id: "plain-shard", label: "Plain", views: [] }`;
+        expect(extractShardKindFromBlock(block)).toBeUndefined();
+    });
+    it('returns undefined for unrecognized kind values', () => {
+        const block = `{ id: "weird", kind: "widget", views: [] }`;
+        expect(extractShardKindFromBlock(block)).toBeUndefined();
+    });
+});

package/dist/platform/localSidecar.d.ts

@@ -0,0 +1,7 @@
+export interface TauriEnvProbe {
+    hasTauriInternals: boolean;
+    protocol: string;
+    hostname: string;
+}
+export declare function checkLocalTauriDesktop(env: TauriEnvProbe): boolean;
+export declare function isLocalTauriDesktop(): boolean;

package/dist/platform/localSidecar.js

@@ -0,0 +1,24 @@
+/*
+ * isLocalTauriDesktop — true iff we're in a Tauri webview AND the page
+ * was served by the local sh3-server sidecar (not the bundled frontend
+ * in remote-mode, and not Android's http://tauri.localhost shim).
+ *
+ * Synchronous: safe to call from action `disabled` predicates that run
+ * on every palette render. Logic is exposed via the pure
+ * `checkLocalTauriDesktop` so it can be unit-tested in the node project
+ * without a window/location shim.
+ */
+export function checkLocalTauriDesktop(env) {
+    return env.hasTauriInternals
+        && env.protocol === 'http:'
+        && env.hostname === 'localhost';
+}
+export function isLocalTauriDesktop() {
+    if (typeof window === 'undefined' || typeof location === 'undefined')
+        return false;
+    return checkLocalTauriDesktop({
+        hasTauriInternals: '__TAURI_INTERNALS__' in window,
+        protocol: location.protocol,
+        hostname: location.hostname,
+    });
+}

package/dist/platform/localSidecar.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/platform/localSidecar.test.js

@@ -0,0 +1,39 @@
+import { describe, it, expect } from 'vitest';
+import { checkLocalTauriDesktop } from './localSidecar';
+describe('checkLocalTauriDesktop', () => {
+    it('returns true for Tauri desktop sidecar (http://localhost)', () => {
+        expect(checkLocalTauriDesktop({
+            hasTauriInternals: true,
+            protocol: 'http:',
+            hostname: 'localhost',
+        })).toBe(true);
+    });
+    it('returns false in pure web (no Tauri)', () => {
+        expect(checkLocalTauriDesktop({
+            hasTauriInternals: false,
+            protocol: 'https:',
+            hostname: 'example.com',
+        })).toBe(false);
+    });
+    it('returns false in Tauri remote-mode desktop (tauri://localhost)', () => {
+        expect(checkLocalTauriDesktop({
+            hasTauriInternals: true,
+            protocol: 'tauri:',
+            hostname: 'localhost',
+        })).toBe(false);
+    });
+    it('returns false on Tauri Android (http://tauri.localhost)', () => {
+        expect(checkLocalTauriDesktop({
+            hasTauriInternals: true,
+            protocol: 'http:',
+            hostname: 'tauri.localhost',
+        })).toBe(false);
+    });
+    it('returns false for https://localhost (not the sidecar)', () => {
+        expect(checkLocalTauriDesktop({
+            hasTauriInternals: true,
+            protocol: 'https:',
+            hostname: 'localhost',
+        })).toBe(false);
+    });
+});

package/dist/sh3core-shard/folderActions.d.ts

@@ -0,0 +1,15 @@
+import type { ShardContext } from '../shards/types';
+/** Build the docs path for a user-or-project tenant id. Pure. */
+export declare function buildDocumentsPath(root: string, tenantId: string, join: (...parts: string[]) => string): string;
+export declare function disabledForApp(g: {
+    isLocal: boolean;
+}): boolean;
+export declare function disabledForUser(g: {
+    isLocal: boolean;
+    userId: string | null;
+}): boolean;
+export declare function disabledForProject(g: {
+    isLocal: boolean;
+    projectId: string | null;
+}): boolean;
+export declare function registerFolderActions(ctx: ShardContext): () => void;

package/dist/sh3core-shard/folderActions.js

@@ -0,0 +1,109 @@
+/*
+ * Palette-only "Open X folder" actions for the Tauri desktop sidecar.
+ * All three actions are registered unconditionally; visibility is gated
+ * by per-frame `disabled` predicates so changes in project scope or auth
+ * state take effect without re-registration.
+ *
+ * Targets:
+ *   sh3.openAppDataFolder           → appDataDir()
+ *   sh3.openUserDocumentsFolder     → appDataDir()/server/docs/<userId>
+ *   sh3.openProjectDocumentsFolder  → appDataDir()/server/docs/<activeProjectId>
+ *
+ * The `server/docs/<tenant>` layout matches sh3-server's doc-store on
+ * disk (see packages/sh3-server/src/doc-store/store.ts). The Tauri
+ * sidecar passes `appDataDir()/server` as sh3-server's --data arg.
+ *
+ * The runner uses dynamic `import()` for `@tauri-apps/api/path` and
+ * `@tauri-apps/plugin-opener` so Vite code-splits the Tauri deps into
+ * a separate chunk that only loads when the action runs. Mirrors the
+ * pattern used by `platform/index.ts` and `sh3Api/window.ts`.
+ */
+import { isLocalTauriDesktop } from '../platform/localSidecar';
+import { getUser } from '../auth/auth.svelte';
+import { sessionState } from '../projects/session-state.svelte';
+import { toastManager } from '../overlays/toast';
+/** Build the docs path for a user-or-project tenant id. Pure. */
+export function buildDocumentsPath(root, tenantId, join) {
+    return join(root, 'server', 'docs', tenantId);
+}
+export function disabledForApp(g) {
+    return !g.isLocal;
+}
+export function disabledForUser(g) {
+    return !g.isLocal || g.userId == null;
+}
+export function disabledForProject(g) {
+    return !g.isLocal || g.projectId == null;
+}
+async function openFolder(kind) {
+    try {
+        const [{ appDataDir, join }, { openPath }] = await Promise.all([
+            import('@tauri-apps/api/path'),
+            import('@tauri-apps/plugin-opener'),
+        ]);
+        const root = await appDataDir();
+        let target = root;
+        if (kind === 'user') {
+            const u = getUser();
+            if (!u)
+                return;
+            target = await join(root, 'server', 'docs', u.id);
+        }
+        else if (kind === 'project') {
+            const id = sessionState.activeProjectId;
+            if (!id)
+                return;
+            target = await join(root, 'server', 'docs', id);
+        }
+        await openPath(target);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        toastManager.notify(`Couldn't open folder: ${msg}`, { level: 'error', duration: 4000 });
+    }
+}
+export function registerFolderActions(ctx) {
+    const actions = [
+        {
+            id: 'sh3.openAppDataFolder',
+            label: 'Open SH3 data folder',
+            scope: ['home', 'app'],
+            contextItem: false,
+            paletteItem: true,
+            group: 'folders',
+            disabled: () => disabledForApp({ isLocal: isLocalTauriDesktop() }),
+            run: (_ctx) => openFolder('app'),
+        },
+        {
+            id: 'sh3.openUserDocumentsFolder',
+            label: 'Open user documents folder',
+            scope: ['home', 'app'],
+            contextItem: false,
+            paletteItem: true,
+            group: 'folders',
+            disabled: () => {
+                var _a, _b;
+                return disabledForUser({
+                    isLocal: isLocalTauriDesktop(),
+                    userId: (_b = (_a = getUser()) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : null,
+                });
+            },
+            run: (_ctx) => openFolder('user'),
+        },
+        {
+            id: 'sh3.openProjectDocumentsFolder',
+            label: 'Open project documents folder',
+            scope: ['home', 'app'],
+            contextItem: false,
+            paletteItem: true,
+            group: 'folders',
+            disabled: () => disabledForProject({
+                isLocal: isLocalTauriDesktop(),
+                projectId: sessionState.activeProjectId,
+            }),
+            run: (_ctx) => openFolder('project'),
+        },
+    ];
+    const disposers = actions.map((a) => ctx.actions.register(a));
+    return () => disposers.forEach((d) => d());
+}

package/dist/sh3core-shard/folderActions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sh3core-shard/folderActions.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect } from 'vitest';
+import { posix } from 'node:path';
+import { buildDocumentsPath, disabledForApp, disabledForUser, disabledForProject, } from './folderActions';
+const join = (...p) => posix.join(...p);
+describe('buildDocumentsPath', () => {
+    it('joins server/docs/<tenantId> under root', () => {
+        expect(buildDocumentsPath('/data', 'alice', join)).toBe('/data/server/docs/alice');
+    });
+    it('uses the supplied join, not posix hard-coding', () => {
+        const out = buildDocumentsPath('C:\\data', 'bob', (...p) => p.join('\\'));
+        expect(out).toBe('C:\\data\\server\\docs\\bob');
+    });
+});
+describe('disabledForApp', () => {
+    it('disabled when not local Tauri desktop', () => {
+        expect(disabledForApp({ isLocal: false })).toBe(true);
+    });
+    it('enabled when local Tauri desktop', () => {
+        expect(disabledForApp({ isLocal: true })).toBe(false);
+    });
+});
+describe('disabledForUser', () => {
+    it('disabled when not local Tauri desktop', () => {
+        expect(disabledForUser({ isLocal: false, userId: 'alice' })).toBe(true);
+    });
+    it('disabled when no signed-in user', () => {
+        expect(disabledForUser({ isLocal: true, userId: null })).toBe(true);
+    });
+    it('enabled when local + user present', () => {
+        expect(disabledForUser({ isLocal: true, userId: 'alice' })).toBe(false);
+    });
+});
+describe('disabledForProject', () => {
+    it('disabled when not local Tauri desktop', () => {
+        expect(disabledForProject({ isLocal: false, projectId: 'acme' })).toBe(true);
+    });
+    it('disabled when no active project', () => {
+        expect(disabledForProject({ isLocal: true, projectId: null })).toBe(true);
+    });
+    it('enabled when local + project active', () => {
+        expect(disabledForProject({ isLocal: true, projectId: 'acme' })).toBe(false);
+    });
+});

package/dist/sh3core-shard/sh3coreShard.svelte.js

@@ -33,6 +33,7 @@ import { resetActivePresetToDefault } from '../layout/store.svelte';
 import { modalManager } from '../overlays/modal';
 import { floatManager } from '../overlays/float';
 import { registerAppActions } from './appActions';
+import { registerFolderActions } from './folderActions';
 import { openPalette } from '../actions/listeners';
 /**
  * Build the palette-only float-maximize toggle action. Targets the topmost
@@ -122,6 +123,7 @@ export const sh3coreShard = {
         ctx.registerView('sh3core:home', factory);
         ctx.registerView('sh3:keys-and-peers', keysFactory);
         registerAppActions(ctx);
+        registerFolderActions(ctx);
         // Launcher parent — submenu drill host. No `run` needed: the
         // dispatcher's default behavior opens a sub-palette filtered to
         // `submenuOf === 'sh3.app.launch'`. The single parent replaces the

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export declare const VERSION = "0.25.0";
+export declare const VERSION = "0.25.1";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export const VERSION = '0.25.0';
+export const VERSION = '0.25.1';

package/package.json

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