@cjhyy/code-shell-web 0.9.22 → 0.9.25

package/dist/index.d.ts

@@ -23,3 +23,5 @@ export * from "./lib/mobileAttachments.js";
 export * from "./lib/uiLanguage.js";
 export { mobile } from "./i18n/mobile.js";
 export { translate, t, webMessages, type WebTranslationKey, type WebTranslateParams, } from "./i18n/translate.js";
+export { isEnvironmentDescriptor, projectReferenceKey } from "./lib/environment.js";
+export type { EnvironmentDescriptor, ProjectReference } from "./lib/environment.js";

package/dist/index.js

@@ -27,3 +27,4 @@ export * from "./lib/uiLanguage.js";
 // ── i18n: mobile namespace dict + zh-fallback translate ─────────────────────
 export { mobile } from "./i18n/mobile.js";
 export { translate, t, webMessages, } from "./i18n/translate.js";
+export { isEnvironmentDescriptor, projectReferenceKey } from "./lib/environment.js";

package/dist/lib/environment.d.ts

@@ -0,0 +1,16 @@
+/** Browser-safe discovery contract. A project identifier is only unique inside its host. */
+export interface EnvironmentDescriptor {
+    version: 1;
+    id: string;
+    name: string;
+    kind: "desktop" | "hub" | "project-host";
+    entryPath: "/" | "/mobile";
+}
+export interface ProjectReference {
+    environmentId: string;
+    projectId: string;
+    rootId?: string;
+}
+export declare function isEnvironmentDescriptor(value: unknown): value is EnvironmentDescriptor;
+/** Tuple encoding avoids collisions without exposing or interpreting filesystem paths. */
+export declare function projectReferenceKey(reference: ProjectReference): string;

package/dist/lib/environment.js

@@ -0,0 +1,25 @@
+const UUID = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/;
+export function isEnvironmentDescriptor(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const record = value;
+    return (record.version === 1 &&
+        typeof record.id === "string" &&
+        UUID.test(record.id) &&
+        typeof record.name === "string" &&
+        record.name.trim().length > 0 &&
+        record.name.length <= 128 &&
+        !/[\u0000-\u001f\u007f]/.test(record.name) &&
+        ["desktop", "hub", "project-host"].includes(record.kind) &&
+        record.entryPath === (record.kind === "desktop" ? "/mobile" : "/"));
+}
+/** Tuple encoding avoids collisions without exposing or interpreting filesystem paths. */
+export function projectReferenceKey(reference) {
+    for (const value of [reference.environmentId, reference.projectId, reference.rootId]) {
+        if (value !== undefined && (typeof value !== "string" || !UUID.test(value)))
+            throw new Error("Invalid project reference");
+    }
+    if (!reference.environmentId || !reference.projectId)
+        throw new Error("Incomplete project reference");
+    return JSON.stringify([reference.environmentId, reference.projectId, reference.rootId ?? null]);
+}