@embeddables/cli 0.6.8 → 0.6.10

package/.prompts/embeddables-cli.md

@@ -510,6 +510,18 @@ Conditions control visibility of components and pages based on User Data. The `C
 
 **Storage**: Conditions are stored in the component/page JSON and preserved in config.json (not in React/CSS/JS files).
 
+### Experiments and conditions
+
+When visibility is gated by an experiment (a key in `connected_experiments`, otherwise the experiment is not connected and will not work, and which controls the variants as well), conditions that use that experiment key must cover both:
+
+1. **Control variant** – Use the control variant value (e.g. `"control"`) in condition values so the control experience is shown when that variant is assigned.
+2. **No value** – Use the special value `_no_value` in condition values so users who are not yet assigned a variant (user data has no value for that experiment key) see the intended default experience—typically the same as control.
+3. Other variant keys.
+
+#1 and #2 should be on the same conditions as each other, whereas all other variants (#3) can be on other conditions.
+
+Example: for experiment key `hero_test` with variants `control` and `variant_b`, the control experience might use a condition like `key: "hero_test", operator: "==", values: ["control", "_no_value"]` so both control users and users with no assignment see the control. The variant experience would use `values: ["variant_b"]`.
+
 ## Config.json Structure
 
 The `config.json` file contains the reduced Embeddable JSON with:
@@ -613,7 +625,7 @@ The `config.json` file contains the reduced Embeddable JSON with:
 
 5. **Global Components**: Must use the filenames to replace the `_location` property.
 
-6. **Conditions**: Stored in config.json, applied at runtime. Multiple values in one condition = OR, multiple conditions = AND.
+6. **Conditions**: Stored in config.json, applied at runtime. Multiple values in one condition = OR, multiple conditions = AND. For experiment-gated conditions, when setting the control variant's conditions always include both the control variant value and `_no_value` so both control and unassigned users see the intended default.
 
 7. **CSS Selectors**: Must follow exact structure with proper spacing (trailing space on breakpoints, leading space on sub-elements).
 

package/dist/commands/branch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/commands/branch.ts"],"names":[],"mappings":"AAKA,wBAAsB,SAAS,CAAC,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,iBAoDpD"}
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/commands/branch.ts"],"names":[],"mappings":"AAMA,wBAAsB,SAAS,CAAC,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,iBAwDpD"}

package/dist/commands/branch.js

@@ -2,6 +2,7 @@ import pc from 'picocolors';
 import { isLoggedIn } from '../auth/index.js';
 import { runPull } from './pull.js';
 import { promptForLocalEmbeddable, fetchBranches, promptForBranch } from '../prompts/index.js';
+import { inferEmbeddableFromCwd } from '../helpers/utils.js';
 export async function runBranch(opts) {
     // Check login status
     if (!isLoggedIn()) {
@@ -10,7 +11,11 @@ export async function runBranch(opts) {
         process.exit(1);
     }
     // Get embeddable ID
-    let embeddableId = opts.id;
+    const inferred = inferEmbeddableFromCwd();
+    let embeddableId = opts.id ?? inferred?.embeddableId;
+    if (inferred && !opts.id && embeddableId) {
+        process.chdir(inferred.projectRoot);
+    }
     if (!embeddableId) {
         const selected = await promptForLocalEmbeddable();
         if (!selected) {

package/dist/commands/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAKA,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAA;CACnC,iBA6BA"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAMA,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAA;CACnC,iBAiCA"}

package/dist/commands/build.js

@@ -2,8 +2,13 @@ import path from 'node:path';
 import { compileAllPages } from '../compiler/index.js';
 import { formatError } from '../compiler/errors.js';
 import { promptForLocalEmbeddable } from '../prompts/index.js';
+import { inferEmbeddableFromCwd } from '../helpers/utils.js';
 export async function runBuild(opts) {
-    let embeddableId = opts.id;
+    const inferred = inferEmbeddableFromCwd();
+    let embeddableId = opts.id ?? inferred?.embeddableId;
+    if (inferred && !opts.id && embeddableId) {
+        process.chdir(inferred.projectRoot);
+    }
     if (!embeddableId) {
         const selected = await promptForLocalEmbeddable({
             message: 'Select an embeddable to build:',

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAmHA,wBAAsB,MAAM,CAAC,IAAI,EAAE;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAA;CACnC,iBA+GA"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAoHA,wBAAsB,MAAM,CAAC,IAAI,EAAE;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAA;CACnC,iBAkHA"}

package/dist/commands/dev.js

@@ -7,6 +7,7 @@ import prompts from 'prompts';
 import { compileAllPages } from '../compiler/index.js';
 import { startProxyServer } from '../proxy/server.js';
 import { formatError } from '../compiler/errors.js';
+import { inferEmbeddableFromCwd } from '../helpers/utils.js';
 /**
  * Check whether a port is available by attempting to listen on it.
  */
@@ -92,7 +93,11 @@ async function promptForEmbeddable() {
     return response.id || null;
 }
 export async function runDev(opts) {
-    let embeddableId = opts.id;
+    const inferred = inferEmbeddableFromCwd();
+    let embeddableId = opts.id ?? inferred?.embeddableId;
+    if (inferred && !opts.id && embeddableId) {
+        process.chdir(inferred.projectRoot);
+    }
     if (!embeddableId) {
         const selected = await promptForEmbeddable();
         if (!selected) {

package/dist/commands/experiments-connect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experiments-connect.d.ts","sourceRoot":"","sources":["../../src/commands/experiments-connect.ts"],"names":[],"mappings":"AAYA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,iBAcA"}
+{"version":3,"file":"experiments-connect.d.ts","sourceRoot":"","sources":["../../src/commands/experiments-connect.ts"],"names":[],"mappings":"AAaA,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,iBAcA"}

package/dist/commands/experiments-connect.js

@@ -4,6 +4,7 @@ import pc from 'picocolors';
 import { isLoggedIn } from '../auth/index.js';
 import { getProjectId, writeProjectConfig } from '../config/index.js';
 import { promptForProject, promptForLocalEmbeddable, promptForExperiment, } from '../prompts/index.js';
+import { inferEmbeddableFromCwd } from '../helpers/utils.js';
 export async function runExperimentsConnect(opts) {
     try {
         await runExperimentsConnectInner(opts);
@@ -46,8 +47,12 @@ async function runExperimentsConnectInner(opts) {
         console.log(pc.green('✓ Saved project to embeddables.json'));
         console.log('');
     }
-    // 4. Get embeddable ID
-    let embeddableId = opts.id;
+    // 4. Get embeddable ID (from option, cwd inference, or interactive prompt)
+    const inferred = inferEmbeddableFromCwd();
+    let embeddableId = opts.id ?? inferred?.embeddableId;
+    if (inferred && !opts.id && embeddableId) {
+        process.chdir(inferred.projectRoot);
+    }
     if (!embeddableId) {
         const selected = await promptForLocalEmbeddable({
             message: 'Select an embeddable to connect the experiment to:',

package/dist/commands/pull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AA+GA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,iBA6PjD"}
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAgHA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,iBAiQjD"}

package/dist/commands/pull.js

@@ -6,6 +6,7 @@ import { reverseCompile } from '../compiler/reverse.js';
 import { getAccessToken, isLoggedIn } from '../auth/index.js';
 import { getProjectId, writeProjectConfig } from '../config/index.js';
 import { promptForProject, promptForEmbeddable, fetchEmbeddableMetadata } from '../prompts/index.js';
+import { inferEmbeddableFromCwd } from '../helpers/utils.js';
 /**
  * Normalize custom_validation_function strings so literal "\\n" (backslash-n) becomes real newline.
  * The API sometimes returns these double-escaped; dataOutputs/computedFields code is written
@@ -108,7 +109,11 @@ function writePullMetadataToConfig(embeddableId, version, branch, branchName) {
     }
 }
 export async function runPull(opts) {
-    let embeddableId = opts.id;
+    const inferred = inferEmbeddableFromCwd();
+    let embeddableId = opts.id ?? inferred?.embeddableId;
+    if (inferred && !opts.id && embeddableId) {
+        process.chdir(inferred.projectRoot);
+    }
     // If no ID provided, try to get it interactively
     if (!embeddableId) {
         if (!isLoggedIn()) {

package/dist/commands/save.js

@@ -9,7 +9,7 @@ import { formatError } from '../compiler/errors.js';
 import { promptForLocalEmbeddable, promptForProject } from '../prompts/index.js';
 import { WEB_APP_BASE_URL } from '../constants.js';
 import { translateJsonDiffToEditCommands } from '../helpers/json.js';
-import { generateId } from '../helpers/utils.js';
+import { generateId, inferEmbeddableFromCwd } from '../helpers/utils.js';
 /** Error with optional gray detail line (hint/next step) for the user. */
 class SaveError extends Error {
     detail;
@@ -225,8 +225,12 @@ async function runSaveInner(opts) {
         console.log(pc.gray('Run "embeddables login" to re-authenticate.'));
         process.exit(1);
     }
-    // 3. Get embeddable ID (from option or interactive prompt)
-    let embeddableId = opts.id;
+    // 3. Get embeddable ID (from option, cwd inference, or interactive prompt)
+    const inferred = inferEmbeddableFromCwd();
+    let embeddableId = opts.id ?? inferred?.embeddableId;
+    if (inferred && !opts.id && embeddableId) {
+        process.chdir(inferred.projectRoot);
+    }
     if (!embeddableId) {
         const selected = await promptForLocalEmbeddable({
             message: 'Select an embeddable to save:',
@@ -526,7 +530,7 @@ function setMultipleFlowUpdates({ commands, metadata, }) {
     };
     //* Map the commands to the correct type and data
     const mappedCommands = commands.map((command) => ({
-        type: command.type in Object.keys(simpleCommandTypes)
+        type: Object.keys(simpleCommandTypes).includes(command.type)
             ? simpleCommandTypes[command.type]
             : command.type,
         data: command.data,

package/dist/helpers/utils.d.ts

@@ -1,2 +1,13 @@
 export declare function generateId(prefix: string): string;
+/**
+ * If the current working directory is inside embeddables/<id>/ (or a subfolder),
+ * returns that embeddable id and the project root (the directory containing the
+ * embeddables/ folder). Otherwise returns null.
+ * When using the inferred id, callers should chdir(projectRoot) so relative
+ * paths like embeddables/<id>/... resolve correctly.
+ */
+export declare function inferEmbeddableFromCwd(): {
+    embeddableId: string;
+    projectRoot: string;
+} | null;
 //# sourceMappingURL=utils.d.ts.map

package/dist/helpers/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/helpers/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,UAIxC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/helpers/utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,UAIxC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAc7F"}

package/dist/helpers/utils.js

@@ -1,4 +1,28 @@
+import path from 'node:path';
 export function generateId(prefix) {
     const randomString = Math.random().toString(20).slice(2) + Math.random().toString(20).slice(2);
     return prefix ? `${prefix}_${randomString}` : `_${randomString}`;
 }
+/**
+ * If the current working directory is inside embeddables/<id>/ (or a subfolder),
+ * returns that embeddable id and the project root (the directory containing the
+ * embeddables/ folder). Otherwise returns null.
+ * When using the inferred id, callers should chdir(projectRoot) so relative
+ * paths like embeddables/<id>/... resolve correctly.
+ */
+export function inferEmbeddableFromCwd() {
+    let current = path.resolve(process.cwd());
+    for (;;) {
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        if (path.basename(parent) === 'embeddables') {
+            return {
+                embeddableId: path.basename(current),
+                projectRoot: path.dirname(parent),
+            };
+        }
+        current = parent;
+    }
+    return null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embeddables/cli",
-  "version": "0.6.8",
+  "version": "0.6.10",
   "type": "module",
   "bin": {
     "embeddables": "./bin/embeddables.mjs"