@constructor-io/constructorio-connect-cli 1.16.1 → 1.18.0

package/README.md

@@ -124,7 +124,18 @@ This command will fetch one fixture from the server and save it into a specified
 
 ```
 USAGE
-  $ constructorio-connect-cli generate-fixture
+  $ constructorio-connect-cli generate-fixture [--connection <value>] [--type
+    item|variation|item_group|external_data|mapping] [--filename <value>] [--item-id <value>] [--variation-id <value>]
+    [--replace-file]
+
+FLAGS
+  --connection=<value>    The connection to generate the fixture for
+  --filename=<value>      The name of the fixture file to generate
+  --item-id=<value>       The ID of the item to generate the fixture for
+  --replace-file          Whether to replace the fixture file if it already exists without asking
+  --type=<option>         The type of fixture to generate
+                          <options: item|variation|item_group|external_data|mapping>
+  --variation-id=<value>  The ID of the variation to generate the fixture for (only applicable when --type=variation)
 
 DESCRIPTION
   This command will fetch one fixture from the server and save it into a specified file. This fixture file will be an
@@ -136,6 +147,16 @@ DESCRIPTION
 
 EXAMPLES
   $ constructorio-connect-cli generate-fixture
+
+  $ constructorio-connect-cli generate-fixture --connection=my-connection-id --type=item --filename=my-fixture.json
+
+  $ constructorio-connect-cli generate-fixture --connection=my-connection-id --type=variation --filename=my-fixture.json
+
+  $ constructorio-connect-cli generate-fixture --connection=my-connection-id --type=variation --item-id=123456789 --variation-id=987654321 --filename=my-fixture.json
+
+  $ constructorio-connect-cli generate-fixture --connection=my-connection-id --type=variation --item-id=123456789 --filename=my-fixture.json
+
+  $ constructorio-connect-cli generate-fixture --connection=my-connection-id --type=variation --filename=my-fixture.json --replace-file
 ```
 
 

package/boilerplate-repo/test/templates/item/item.spec.mjs

@@ -3,7 +3,10 @@
  * @see https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-development-flow#step-3-test-your-templates
  */
 
-import { executeTemplate, buildFixture } from "@constructor-io/constructorio-connect-cli";
+import {
+  executeTemplate,
+  buildFixture,
+} from "@constructor-io/constructorio-connect-cli";
 
 describe("item", () => {
   it("should match snapshot", async () => {

package/boilerplate-repo/test/templates/item_group/item_group.spec.mjs

@@ -3,7 +3,10 @@
  * @see https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-development-flow#step-3-test-your-templates
  */
 
-import { executeTemplate, buildFixture } from "@constructor-io/constructorio-connect-cli";
+import {
+  executeTemplate,
+  buildFixture,
+} from "@constructor-io/constructorio-connect-cli";
 
 describe("item_group", () => {
   it("should match snapshot", async () => {

package/boilerplate-repo/test/templates/mapping/mapping.spec.mjs

@@ -3,7 +3,10 @@
  * @see https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-development-flow#step-3-test-your-templates
  */
 
-import { executeTemplate, buildFixture } from "@constructor-io/constructorio-connect-cli";
+import {
+  executeTemplate,
+  buildFixture,
+} from "@constructor-io/constructorio-connect-cli";
 
 describe("mapping", () => {
   it("should map item groups", async () => {

package/boilerplate-repo/test/templates/variation/variation.spec.mjs

@@ -3,7 +3,10 @@
  * @see https://docs.constructor.com/docs/integrating-with-constructor-connect-cli-development-flow#step-3-test-your-templates
  */
 
-import { executeTemplate, buildFixture } from "@constructor-io/constructorio-connect-cli";
+import {
+  executeTemplate,
+  buildFixture,
+} from "@constructor-io/constructorio-connect-cli";
 
 describe("variation", () => {
   it("should match snapshot", async () => {

package/dist/commands/generate-fixture.d.ts

@@ -1,6 +1,14 @@
 import { RefreshConnectionsCommand } from "./refresh-connections";
 export default class GenerateFixture extends RefreshConnectionsCommand {
     static args: {};
+    static flags: {
+        connection: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        filename: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "item-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "variation-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "replace-file": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
     static description: string;
     static examples: string[];
     runCommand(): Promise<any>;

package/dist/commands/generate-fixture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-fixture.d.ts","sourceRoot":"","sources":["../../src/commands/generate-fixture.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,yBAAyB;IACpE,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,WAAW,SACsgB;IAExhB,MAAM,CAAC,QAAQ,WAA4C;IAErD,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IA2DhC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAU9C"}
+{"version":3,"file":"generate-fixture.d.ts","sourceRoot":"","sources":["../../src/commands/generate-fixture.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAiBlE,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,yBAAyB;IACpE,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,KAAK;;;;;;;MAyCV;IAEF,MAAM,CAAC,WAAW,SACsgB;IAExhB,MAAM,CAAC,QAAQ,WAOb;IAEI,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAuGhC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAU9C"}

package/dist/commands/generate-fixture.js

@@ -11,18 +11,79 @@ const path_2 = require("../customer/path");
 const file_exists_1 = require("../helpers/file-exists");
 const ux_action_1 = require("../helpers/ux-action");
 const get_fixture_1 = require("../http/get-fixture");
+const get_live_fixture_1 = require("../http/get-live-fixture");
 const render_prompt_1 = require("../prompt-data/render-prompt");
 const render_tip_1 = require("../rendering/render-tip");
 const types_1 = require("../types");
 const check_if_connection_needs_mapping_1 = require("../helpers/check-if-connection-needs-mapping");
 const select_connections_1 = require("../prompt-data/select-connections");
 const refresh_connections_1 = require("./refresh-connections");
+const kleur_1 = __importDefault(require("kleur"));
+const core_2 = require("@oclif/core");
+const SUPPORTED_PARTNERS = [
+    "akeneo",
+    "commercetools",
+    "bigcommerce",
+    "shopify",
+    "vtex",
+];
+const SUPPORTED_FIXTURE_TYPES = [
+    types_1.CatalogFixtureType.ITEM,
+    types_1.CatalogFixtureType.VARIATION,
+];
 class GenerateFixture extends refresh_connections_1.RefreshConnectionsCommand {
     static args = {};
+    static flags = {
+        connection: core_2.Flags.string({
+            description: "The connection to generate the fixture for",
+            required: false,
+        }),
+        type: core_2.Flags.string({
+            description: "The type of fixture to generate",
+            options: Object.values(types_1.CatalogFixtureType),
+            required: false,
+        }),
+        filename: core_2.Flags.string({
+            description: "The name of the fixture file to generate",
+            required: false,
+        }),
+        ["item-id"]: core_2.Flags.string({
+            description: "The ID of the item to generate the fixture for",
+            required: false,
+        }),
+        ["variation-id"]: core_2.Flags.string({
+            description: "The ID of the variation to generate the fixture for (only applicable when --type=variation)",
+            required: false,
+            relationships: [
+                {
+                    type: "some",
+                    flags: [
+                        {
+                            name: "type",
+                            when: async (flags) => flags.type === "variation",
+                        },
+                    ],
+                },
+            ],
+        }),
+        ["replace-file"]: core_2.Flags.boolean({
+            description: "Whether to replace the fixture file if it already exists without asking",
+            required: false,
+            default: false,
+        }),
+    };
     static description = "This command will fetch one fixture from the server and save it into a specified file. This fixture file will be an example of how the data would be passed to the connector when executing the templates.\n You are expected to customize this file to match the data you expect to cover in a template execution (e.g. an item with stock, a variation with missing data), etc. Note that you can have multiple fixtures of the same type to cover different scenarios.\n Finally, if the file already exists you'll be prompted to overwrite it.";
-    static examples = ["$ <%= config.bin %> generate-fixture"];
+    static examples = [
+        "$ <%= config.bin %> generate-fixture",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=item --filename=my-fixture.json",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=variation --filename=my-fixture.json",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=variation --item-id=123456789 --variation-id=987654321 --filename=my-fixture.json",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=variation --item-id=123456789 --filename=my-fixture.json",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=variation --filename=my-fixture.json --replace-file",
+    ];
     async runCommand() {
-        const connection = await (0, select_connections_1.selectConnections)("Choose the connection to generate the fixture for");
+        const { flags } = await this.parse(GenerateFixture);
+        const connection = await (0, select_connections_1.selectConnections)("Choose the connection to generate the fixture for", flags.connection);
         const choices = Object.keys(types_1.CatalogFixtureType).map((catalogFixtureType) => ({
             name: catalogFixtureType,
             value: Object(types_1.CatalogFixtureType)[catalogFixtureType],
@@ -31,36 +92,63 @@ class GenerateFixture extends refresh_connections_1.RefreshConnectionsCommand {
             const index = choices.findIndex((choice) => choice.value === "mapping");
             choices.splice(index, 1);
         }
-        const type = await (0, render_prompt_1.renderPrompt)({
-            promptMessage: "Choose the type of fixture you want to generate",
-            choices,
-        });
-        const filename = await (0, prompts_1.input)({
-            message: "Enter the filename",
-            default: `${type}.json`,
-        });
+        const type = flags.type ||
+            (await (0, render_prompt_1.renderPrompt)({
+                promptMessage: "Choose the type of fixture you want to generate",
+                choices,
+            }));
+        const filename = flags.filename ||
+            (await (0, prompts_1.input)({
+                message: "Enter the filename",
+                default: `${type}.json`,
+            }));
         const filepath = this.getFixturePath(type, filename);
         const shouldAskReplace = (0, file_exists_1.fileExists)(filepath, true);
         if (shouldAskReplace) {
-            const shouldRefresh = await (0, prompts_1.confirm)({
-                message: `This fixture already exists. Do you want to refresh it?`,
-                default: false,
-            });
-            if (!shouldRefresh) {
-                (0, render_tip_1.renderTip)([
-                    "Your file was not refreshed!",
-                    "If you want to generate the fixture, please execute the command again",
-                ]);
+            if (flags["replace-file"]) {
+                core_1.ux.stdout(kleur_1.default.yellow("⚠️  WARNING!") +
+                    kleur_1.default.gray(` The file ${filepath} already exists and will be replaced without asking because you provided the --replace-file flag.`));
+            }
+            else {
+                const shouldRefresh = await (0, prompts_1.confirm)({
+                    message: `This fixture already exists. Do you want to refresh it?`,
+                    default: false,
+                });
+                if (!shouldRefresh) {
+                    (0, render_tip_1.renderTip)([
+                        "Your file was not refreshed!",
+                        "If you want to generate the fixture, please execute the command again",
+                    ]);
+                    return;
+                }
+            }
+        }
+        const canUseLiveFixture = SUPPORTED_PARTNERS.includes(connection.partner) &&
+            SUPPORTED_FIXTURE_TYPES.includes(type);
+        if (canUseLiveFixture) {
+            try {
+                const { data } = await getLiveFixtureData(connection, type, flags["item-id"], flags["variation-id"]);
+                await (0, fs_extra_1.outputFile)(filepath, JSON.stringify(data, null, 2));
+                core_1.ux.stdout(`🎉 ${type} live fixture generated at ${filepath}`);
                 return;
             }
+            catch (_) {
+                const wantStaticFixture = await (0, prompts_1.confirm)({
+                    message: `Do you want to generate a static fixture instead?`,
+                    default: false,
+                });
+                if (!wantStaticFixture) {
+                    return;
+                }
+            }
         }
         try {
             await (0, ux_action_1.uxAction)("🧶 Generating fixtures...", async () => {
-                const response = await (0, get_fixture_1.getFixture)({
+                const { data } = await (0, get_fixture_1.getFixture)({
                     connectionId: connection.id,
-                    type: type,
+                    type,
                 });
-                await (0, fs_extra_1.outputFile)(filepath, JSON.stringify(response.data, null, 2));
+                await (0, fs_extra_1.outputFile)(filepath, JSON.stringify(data, null, 2));
             })();
             core_1.ux.stdout(`🎉 ${type} fixture generated at ${filepath}`);
         }
@@ -73,3 +161,68 @@ class GenerateFixture extends refresh_connections_1.RefreshConnectionsCommand {
     }
 }
 exports.default = GenerateFixture;
+async function getLiveFixtureData(connection, type, argItemId, argVariationId) {
+    switch (connection.partner) {
+        case "shopify":
+            core_1.ux.stdout(kleur_1.default.yellow("TIP!") + kleur_1.default.gray(" Provide a sanitized Product ID"));
+            core_1.ux.stdout(kleur_1.default.gray("  123456789"));
+            core_1.ux.stdout(kleur_1.default.gray("  (we also support full id strings: gid://shopify/Product/123456789)"));
+            break;
+        case "akeneo":
+            core_1.ux.stdout(kleur_1.default.yellow("TIP!") +
+                kleur_1.default.gray("Provide the Product UUID. If it belongs to a ProductModel, it'll be returned as the item"));
+            break;
+        case "commercetools":
+            core_1.ux.stdout(kleur_1.default.yellow("TIP!") +
+                kleur_1.default.gray(" Provide the standard Product ID, which can be found in the URL of the product in the Merchant Center"));
+            break;
+    }
+    const id = argItemId ||
+        (await (0, prompts_1.input)({
+            message: "Enter the ID of the item you want to generate the fixture for",
+        }));
+    try {
+        let data;
+        try {
+            const response = await (0, get_live_fixture_1.getLiveFixture)({
+                connectionId: connection.id,
+                id,
+            });
+            data = response.data;
+        }
+        catch (_) {
+            throw new Error(`Could not fetch live fixture for the provided ID. Is the ID correct?`);
+        }
+        if (type === types_1.CatalogFixtureType.ITEM) {
+            return {
+                data,
+            };
+        }
+        const possibleVariations = data.__variations || [];
+        if (possibleVariations.length === 0) {
+            throw new Error("The item you selected does not have variations, cannot generate variation fixture");
+        }
+        const variationsById = possibleVariations.reduce((acc, variation) => {
+            acc[variation.__id] = variation;
+            return acc;
+        }, {});
+        const variationId = argVariationId ||
+            (await (0, render_prompt_1.renderPrompt)({
+                promptMessage: "The item you selected has more than 1 variation. Please select the variation you want to generate the fixture for:",
+                choices: Object.keys(variationsById).map((variationId) => ({
+                    name: variationId,
+                    value: variationId,
+                })),
+            }));
+        const variationWithItem = Object.assign({}, variationsById[variationId], {
+            __item: data,
+        });
+        return {
+            data: variationWithItem,
+        };
+    }
+    catch (err) {
+        core_1.ux.stdout(`❌ ${err.message}`);
+        throw err;
+    }
+}

package/dist/http/get-live-fixture.d.ts

@@ -0,0 +1,10 @@
+export declare function getLiveFixture(args: GetLiveFixtureArgs): Promise<GetLiveFixtureResponseDto>;
+interface GetLiveFixtureArgs {
+    connectionId: string;
+    id: string;
+}
+export interface GetLiveFixtureResponseDto {
+    data: any;
+}
+export {};
+//# sourceMappingURL=get-live-fixture.d.ts.map

package/dist/http/get-live-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-live-fixture.d.ts","sourceRoot":"","sources":["../../src/http/get-live-fixture.ts"],"names":[],"mappings":"AAOA,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,yBAAyB,CAAC,CA0BpC;AAED,UAAU,kBAAkB;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,GAAG,CAAC;CACX"}

package/dist/http/get-live-fixture.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLiveFixture = getLiveFixture;
+const axios_1 = require("axios");
+const errors_1 = require("@oclif/core/errors");
+const ux_action_1 = require("../helpers/ux-action");
+const http_client_1 = require("./http-client");
+async function getLiveFixture(args) {
+    const client = await (0, http_client_1.getHttpClient)();
+    try {
+        const response = await (0, ux_action_1.uxAction)("📡 Fetching fixtures", async () => {
+            return await client.get(`/live_fixtures/item`, {
+                params: {
+                    connection_id: args.connectionId,
+                    id: args.id,
+                },
+                headers: {
+                    Authorization: `Bearer ${process.env.CONNECT_AUTH_TOKEN}`,
+                },
+            });
+        })();
+        return response;
+    }
+    catch (error) {
+        if ((0, axios_1.isAxiosError)(error) && error.response) {
+            throw new errors_1.CLIError("Something went wrong while fetching fixtures: \n" +
+                error.response.data.message);
+        }
+        throw error;
+    }
+}

package/dist/http/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AACA,OAAO,KAA6C,MAAM,OAAO,CAAC;AA6BlE,UAAU,iBAAiB;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB;AAOD;;GAEG;AACH,wBAAsB,aAAa,CACjC,EAAE,YAAY,EAAE,GAAE,iBAEjB,gCA8DF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,WAK7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,cAcjE"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AACA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAmClE,UAAU,iBAAiB;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB;AAOD;;GAEG;AACH,wBAAsB,aAAa,CACjC,EAAE,YAAY,EAAE,GAAE,iBAEjB,gCA8DF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,WAK7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,cAcjE"}

package/dist/http/http-client.js

@@ -61,6 +61,11 @@ const RETRY_IGNORED_HTTP_STATUS_CODES = [
      * This error is thrown whenever a user has no permissions to access a resource.
      */
     403,
+    /**
+     * HTTP 404: Not Found
+     * This error is thrown whenever a resource cannot be found.
+     */
+    404,
 ];
 const MAX_RETRIES = 3;
 /**

package/dist/prompt-data/render-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-prompt.d.ts","sourceRoot":"","sources":["../../src/prompt-data/render-prompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAsB,YAAY,CAAC,CAAC,EAAE,EACpC,OAAO,EACP,aAAa,EACb,YAAY,GACb,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWtB;AAED,UAAU,IAAI,CAAC,CAAC;IACd,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"render-prompt.d.ts","sourceRoot":"","sources":["../../src/prompt-data/render-prompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAsB,YAAY,CAAC,CAAC,EAAE,EACpC,OAAO,EACP,aAAa,EACb,YAAY,GACb,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAuBtB;AAED,UAAU,IAAI,CAAC,CAAC;IACd,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/prompt-data/render-prompt.js

@@ -10,6 +10,16 @@ async function renderPrompt({ choices, promptMessage, emptyMessage, }) {
         case 1:
             return choices[0].value;
         default:
-            return await (0, prompts_1.select)({ message: promptMessage, choices });
+            return await (0, prompts_1.search)({
+                message: promptMessage,
+                source(term) {
+                    if (!term)
+                        return choices;
+                    return choices.filter((choice) => choice.name
+                        .toLowerCase()
+                        .trim()
+                        .includes(term.toLowerCase().trim()));
+                },
+            });
     }
 }

package/dist/prompt-data/select-connections.d.ts

@@ -1,2 +1,2 @@
-export declare const selectConnections: (message?: string) => Promise<import("../types").Connection>;
+export declare const selectConnections: (message?: string, selectedConnectionId?: string) => Promise<import("../types").Connection>;
 //# sourceMappingURL=select-connections.d.ts.map

package/dist/prompt-data/select-connections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select-connections.d.ts","sourceRoot":"","sources":["../../src/prompt-data/select-connections.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB,GAC5B,UAAS,MAAgC,2CA0B1C,CAAC"}
+{"version":3,"file":"select-connections.d.ts","sourceRoot":"","sources":["../../src/prompt-data/select-connections.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB,GAC5B,UAAS,MAAgC,EACzC,uBAAuB,MAAM,2CAoC9B,CAAC"}

package/dist/prompt-data/select-connections.js

@@ -5,13 +5,19 @@ const get_connections_request_1 = require("../http/get-connections-request");
 const ux_action_1 = require("../helpers/ux-action");
 const get_connect_token_1 = require("../customer/get-connect-token");
 const render_prompt_1 = require("../prompt-data/render-prompt");
-const selectConnections = async (message = "Choose the connection") => {
+const selectConnections = async (message = "Choose the connection", selectedConnectionId) => {
     const connections = await (0, ux_action_1.uxAction)("📡 Reading your connections...", async () => {
         return await (0, get_connections_request_1.getConnections)({ showLogs: true });
     })();
     // Load the connect token to ensure we can authenticate with Constructor.
     // We do this here because the terminal output gets weird when there is a prompt during a ux action.
     await (0, get_connect_token_1.getConnectToken)();
+    if (selectedConnectionId) {
+        const selectedConnection = connections.find((connection) => connection.id === selectedConnectionId);
+        if (selectedConnection) {
+            return selectedConnection;
+        }
+    }
     const connectionId = await (0, render_prompt_1.renderPrompt)({
         promptMessage: message,
         choices: connections.map((connection) => ({

package/dist/version.d.ts

@@ -1,3 +1,3 @@
-declare const _default: "1.16.1";
+declare const _default: "1.18.0";
 export default _default;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = '1.16.1';
+exports.default = '1.18.0';

package/oclif.manifest.json

@@ -115,9 +115,79 @@
       "args": {},
       "description": "This command will fetch one fixture from the server and save it into a specified file. This fixture file will be an example of how the data would be passed to the connector when executing the templates.\n You are expected to customize this file to match the data you expect to cover in a template execution (e.g. an item with stock, a variation with missing data), etc. Note that you can have multiple fixtures of the same type to cover different scenarios.\n Finally, if the file already exists you'll be prompted to overwrite it.",
       "examples": [
-        "$ <%= config.bin %> generate-fixture"
+        "$ <%= config.bin %> generate-fixture",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=item --filename=my-fixture.json",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=variation --filename=my-fixture.json",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=variation --item-id=123456789 --variation-id=987654321 --filename=my-fixture.json",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=variation --item-id=123456789 --filename=my-fixture.json",
+        "$ <%= config.bin %> generate-fixture --connection=my-connection-id --type=variation --filename=my-fixture.json --replace-file"
       ],
-      "flags": {},
+      "flags": {
+        "connection": {
+          "description": "The connection to generate the fixture for",
+          "name": "connection",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "The type of fixture to generate",
+          "name": "type",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "item",
+            "variation",
+            "item_group",
+            "external_data",
+            "mapping"
+          ],
+          "type": "option"
+        },
+        "filename": {
+          "description": "The name of the fixture file to generate",
+          "name": "filename",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "item-id": {
+          "description": "The ID of the item to generate the fixture for",
+          "name": "item-id",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "variation-id": {
+          "description": "The ID of the variation to generate the fixture for (only applicable when --type=variation)",
+          "name": "variation-id",
+          "relationships": [
+            {
+              "type": "some",
+              "flags": [
+                {
+                  "name": "type"
+                }
+              ]
+            }
+          ],
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "replace-file": {
+          "description": "Whether to replace the fixture file if it already exists without asking",
+          "name": "replace-file",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "generate-fixture",
@@ -207,5 +277,5 @@
       ]
     }
   },
-  "version": "1.16.1"
+  "version": "1.18.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructor-io/constructorio-connect-cli",
-  "version": "1.16.1",
+  "version": "1.18.0",
   "description": "CLI tool to enable users to interface with the Constructor Connect Ecosystem",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -92,9 +92,9 @@
     "globals": "^16.0.0",
     "jest": "^29.7.0",
     "license-checker": "^25.0.1",
-    "markdownlint-cli2": "^0.20.0",
+    "markdownlint-cli2": "^0.21.0",
     "mock-fs": "^5.2.0",
-    "nock": "14.0.10",
+    "nock": "14.0.11",
     "oclif": "^4.17.42",
     "prettier": "^3.2.5",
     "prettier-2": "npm:prettier@^2.8.8",