@entrinsik/vite-plugin-informer 2.7.0 → 2.11.0

package/src/dev-dependencies.js

@@ -173,14 +173,16 @@ const METHOD_SURFACE = {
 const REQUEST_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
 
 /**
- * Load the `dependencies:` map from informer.yaml. Returns `{}` if the file
- * is missing or the section is absent — both are valid (an app may have no
- * declared dependencies).
+ * Read and parse informer.yaml once. Returns `{}` when the file is missing or
+ * its top level is not a map, so callers can select blocks without guarding.
+ * Per-request callers (server routes, agent tools) load it fresh on every
+ * request so edits take effect without a dev-server restart, and select every
+ * block they need from this one parse via manifestBlock().
  *
  * @param {string} projectRoot
- * @returns {Promise<Object>} The raw dependencies object as authored
+ * @returns {Promise<Object>} The parsed manifest document
  */
-export async function loadDependencies(projectRoot) {
+export async function loadManifest(projectRoot) {
     const yamlPath = join(projectRoot, 'informer.yaml');
     try {
         await access(yamlPath);
@@ -189,8 +191,42 @@ export async function loadDependencies(projectRoot) {
     }
     const content = await readFile(yamlPath, 'utf8');
     const parsed = parseYaml(content);
-    if (!parsed || typeof parsed !== 'object') return {};
-    return (parsed.dependencies && typeof parsed.dependencies === 'object') ? parsed.dependencies : {};
+    return (parsed && typeof parsed === 'object') ? parsed : {};
+}
+
+/**
+ * One top-level map block of a parsed manifest, or {} when absent or not a map.
+ *
+ * @param {Object} manifest - A document from loadManifest()
+ * @param {string} key - Top-level block name (`dependencies`, `channels`, `env`, ...)
+ * @returns {Object}
+ */
+export function manifestBlock(manifest, key) {
+    const block = manifest && manifest[key];
+    return (block && typeof block === 'object' && !Array.isArray(block)) ? block : {};
+}
+
+/**
+ * Load the `dependencies:` map from informer.yaml. Returns `{}` if the file
+ * is missing or the section is absent — both are valid (an app may have no
+ * declared dependencies).
+ *
+ * @param {string} projectRoot
+ * @returns {Promise<Object>} The raw dependencies object as authored
+ */
+export async function loadDependencies(projectRoot) {
+    return manifestBlock(await loadManifest(projectRoot), 'dependencies');
+}
+
+/**
+ * Read the `channels:` relay block from informer.yaml: channel name →
+ * { description?, on? }. Returns {} when there is no manifest or no block.
+ *
+ * @param {string} projectRoot
+ * @returns {Promise<Object>}
+ */
+export async function loadChannels(projectRoot) {
+    return manifestBlock(await loadManifest(projectRoot), 'channels');
 }
 
 /**
@@ -203,16 +239,7 @@ export async function loadDependencies(projectRoot) {
  * @returns {Promise<Object>} The raw env object as authored
  */
 export async function loadAppEnv(projectRoot) {
-    const yamlPath = join(projectRoot, 'informer.yaml');
-    try {
-        await access(yamlPath);
-    } catch {
-        return {};
-    }
-    const content = await readFile(yamlPath, 'utf8');
-    const parsed = parseYaml(content);
-    if (!parsed || typeof parsed !== 'object') return {};
-    return (parsed.env && typeof parsed.env === 'object') ? parsed.env : {};
+    return manifestBlock(await loadManifest(projectRoot), 'env');
 }
 
 /**

package/src/dev-platform.js

@@ -0,0 +1,44 @@
+/**
+ * The `platform` descriptor the dev mirror hands to app code — the same shape
+ * the server injects on `window.__INFORMER__.platform` and on the server
+ * handler / tool bag: the Informer build version and the capability flags.
+ *
+ * Every capability the dev server mirrors is on. `embeddings` is off: the
+ * pump and query-time `embed()` need a real Informer, so an app that
+ * feature-detects on it sees locally exactly what it sees on an install
+ * without the feature. `version` is `'dev'` (not semver) so a floor check
+ * treats the dev mirror as "unknown" rather than as any particular release.
+ * `originMode` is on: the dev server behaves like an app served from its own
+ * origin, where live channels work.
+ *
+ * Override any of it per project with `informer({ mock: { platform: {…} } })`.
+ */
+export const DEV_CAPABILITIES = Object.freeze({
+    serverRoutes: true,
+    webhooks: true,
+    tools: true,
+    mcp: true,
+    agents: true,
+    automations: true,
+    messages: true,
+    storage: true,
+    snapshots: true,
+    customApis: true,
+    integrationDependencies: true,
+    datasourceDependencies: true,
+    aiCompletions: true,
+    // live channels: broadcast() in the sandbox, the `channels:` relay block,
+    // and channels/ join/leave handlers — the dev server mirrors all three.
+    channels: true,
+    embeddings: false
+});
+
+export function devPlatform(overrides = {}) {
+    const { capabilities = {}, ...rest } = overrides || {};
+    return {
+        version: 'dev',
+        originMode: true,
+        ...rest,
+        capabilities: { ...DEV_CAPABILITIES, ...capabilities }
+    };
+}