@commercelayer/cli-plugin-provisioning 1.0.0

package/lib/commands/provisioning/delete.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const base_1 = tslib_1.__importStar(require("../../base"));
+// import { addRequestReader, isRequestInterrupted } from '../../lang'
+const cli_core_1 = require("@commercelayer/cli-core");
+const OPERATION = 'delete';
+class ProvisioningDelete extends base_1.default {
+    async run() {
+        const { args, flags } = await this.parse(ProvisioningDelete);
+        const invalidFlags = ['fields', 'include'];
+        invalidFlags.forEach(x => {
+            if (flags[x])
+                this.error(`Flag not supported in ${cli_core_1.clColor.cli.command(OPERATION)} operation: ${cli_core_1.clColor.style.error(x)}`);
+        });
+        const { res, id } = this.checkResourceId(args.resource, args.id);
+        const resource = this.checkResource(res, { singular: true });
+        const showHeaders = flags.headers || flags['headers-only'];
+        const cl = this.initCommerceLayer(flags);
+        const rawReader = (flags.raw && showHeaders) ? cl.addRawResponseReader({ headers: showHeaders }) : undefined;
+        // const reqReader = flags.doc ? addRequestReader(cl) : undefined
+        try {
+            const resSdk = cl[resource.api];
+            this.checkOperation(resSdk, OPERATION);
+            await resSdk.delete(id);
+            if (showHeaders)
+                this.printHeaders(rawReader?.headers, flags);
+            this.log(`\n${cli_core_1.clColor.style.success('Successfully')} deleted resource of type ${cli_core_1.clColor.style.resource(resource.api)} with id ${cli_core_1.clColor.style.id(id)}\n`);
+        }
+        catch (error) {
+            /*
+            if (isRequestInterrupted(error) && reqReader) {
+                await this.showLiveDocumentation(reqReader.request, undefined, flags)
+                cl.removeInterceptor('request', reqReader.id)
+            } else */ this.printError(error, flags, args);
+        }
+    }
+}
+ProvisioningDelete.description = 'delete an existing resource';
+ProvisioningDelete.aliases = ['prov:delete', 'pd', 'pdelete', 'pdel'];
+ProvisioningDelete.examples = [
+    '$ commercelayer provisioning:delete api_credentials/<id>',
+    '$ cl prov:delete api_credentials <id>',
+];
+ProvisioningDelete.flags = {
+    ...(cli_core_1.clCommand.commandFlags(base_1.default.flags, ['save-params', 'load-params']))
+};
+ProvisioningDelete.args = {
+    ...base_1.default.args,
+    id: base_1.Args.string({ name: 'id', description: 'id of the resource to delete', required: false })
+};
+exports.default = ProvisioningDelete;

package/lib/commands/provisioning/exec.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base';
+export default class ProvisioningExec extends BaseCommand {
+    static description: string;
+    static aliases: string[];
+    static examples: string[];
+    static flags: {
+        attribute: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static args: {
+        id: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+        action: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+        resource: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/lib/commands/provisioning/exec.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const base_1 = tslib_1.__importStar(require("../../base"));
+const cli_core_1 = require("@commercelayer/cli-core");
+class ProvisioningExec extends base_1.BaseCommand {
+    async run() {
+        const { args, flags } = await this.parse(ProvisioningExec);
+        const action = args.action;
+        if (!action)
+            this.error('Missing action name');
+        const { res, id } = this.checkResourceId(args.resource, args.id);
+        const resource = this.checkResource(res, { singular: true });
+        const clp = this.initCommerceLayer(flags);
+        try {
+            const resSdk = clp[resource.api];
+            this.checkOperation(resSdk, action);
+            if (resSdk[action].length > 2) { // Base action command has two arguments: resource id and request options
+                const attributes = this.attributeFlag(flags.attribute);
+                await resSdk[action](id, attributes);
+            }
+            else {
+                if (flags.attribute && (flags.attribute.length > 0))
+                    this.warn(`Action ${cli_core_1.clColor.cli.arg(action)} does not require argumemts, all the attributes will be ignored.`);
+                await resSdk[action](id);
+            }
+        }
+        catch (error) {
+            /*
+            if (isRequestInterrupted(error) && reqReader) {
+                await this.showLiveDocumentation(reqReader.request, undefined, flags)
+                cl.removeInterceptor('request', reqReader.id)
+            } else */ this.printError(error, flags, args);
+        }
+    }
+}
+ProvisioningExec.description = 'execute an action on a resource';
+ProvisioningExec.aliases = ['prov:exec', 'pe', 'pexec'];
+ProvisioningExec.examples = [
+    '$ commercelayer provisioning:exec organizations <organizationId> transfer_ownership',
+    '$ cl prov:exec memberships <membershipId> resend'
+];
+ProvisioningExec.flags = {
+    attribute: base_1.Flags.string({
+        char: 'a',
+        description: 'define a resource attribute',
+        multiple: true,
+    })
+};
+ProvisioningExec.args = {
+    ...base_1.default.args,
+    id: base_1.Args.string({ name: 'id', description: 'id of the resource on which to execute the action', required: false }),
+    action: base_1.Args.string({ name: 'action', description: 'action to execute on resource', required: false })
+};
+exports.default = ProvisioningExec;

package/lib/commands/provisioning/fetch.d.ts

@@ -0,0 +1,28 @@
+import { BaseFilterCommand } from '../../base';
+export default class ResourcesFetch extends BaseFilterCommand {
+    static description: string;
+    static aliases: string[];
+    static examples: string[];
+    static strict: boolean;
+    static flags: {
+        where: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        pageSize: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        sort: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        extract: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'force-include': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        include: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        fields: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        unformatted: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        headers: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'headers-only': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {
+        path: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+        id: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<any>;
+    private fixPath;
+}

package/lib/commands/provisioning/fetch.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const base_1 = require("../../base");
+const retrieve_1 = tslib_1.__importDefault(require("./retrieve"));
+const list_1 = tslib_1.__importDefault(require("./list"));
+const relationship_1 = tslib_1.__importDefault(require("./relationship"));
+const get_1 = tslib_1.__importDefault(require("./get"));
+class ResourcesFetch extends base_1.BaseFilterCommand {
+    async run() {
+        const { args } = await this.parse(ResourcesFetch);
+        const path = this.fixPath(args.path, args);
+        const id = args.id;
+        // If no relationship is defined then run retrieve/list command
+        const pathNodes = path.split('/');
+        if (pathNodes.length < 3)
+            return await get_1.default.run(this.argv, this.config);
+        // Build argv array to pass to Relationship command
+        const relArgs = [...this.argv];
+        relArgs.splice(0, id ? 2 : 1, ...pathNodes);
+        return await relationship_1.default.run(relArgs, this.config);
+    }
+    fixPath(path, args, _flags) {
+        // Remove base URL
+        if (path.startsWith('http'))
+            path = path.substring(path.indexOf('/api/') + 4);
+        // Remove 'relationships' sub-path (usually part of 'self' link)
+        if (path.includes('/relationships/'))
+            path = path.replace('/relationships', '');
+        // Remove leading slash
+        if (path.startsWith('/'))
+            path = path.substring(1);
+        // Replace {resourceId} placeholder with actual resource id
+        if (args.id)
+            path = path.replace(/\{.*\}/g, args.id);
+        return path;
+    }
+}
+ResourcesFetch.description = 'retrieve a resource or list a set of resources';
+ResourcesFetch.aliases = ['prov:fetch', 'pf'];
+ResourcesFetch.examples = [
+    '$ commercelayer provisioning:fetch roles',
+    '$ commercelayer prov:fetch roles',
+    '$ clayer prov:fetch roles/<roleId>',
+    '$ cl prov:fetch roles/<roleId>/<roleRelationship>',
+    '$ cl pf roles/{roleId}/permissions aBcdEkYWx',
+];
+ResourcesFetch.strict = false;
+ResourcesFetch.flags = {
+    ...retrieve_1.default.flags,
+    ...list_1.default.flags,
+};
+ResourcesFetch.args = {
+    path: base_1.Args.string({ name: 'path', description: 'path (or URL) of the resource(s) to fetch', required: true }),
+    id: base_1.Args.string({ name: 'id', description: 'resource id', required: false }),
+};
+exports.default = ResourcesFetch;

package/lib/commands/provisioning/get.d.ts

@@ -0,0 +1,27 @@
+import Command from '../../base';
+export default class ProvisioningGet extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: string[];
+    static strict: boolean;
+    static flags: {
+        where: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        pageSize: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        sort: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        extract: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'force-include': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        include: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        fields: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        unformatted: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        headers: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'headers-only': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {
+        id: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+        resource: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<any>;
+}

package/lib/commands/provisioning/get.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const base_1 = tslib_1.__importDefault(require("../../base"));
+const retrieve_1 = tslib_1.__importDefault(require("./retrieve"));
+const list_1 = tslib_1.__importDefault(require("./list"));
+class ProvisioningGet extends base_1.default {
+    async run() {
+        const { args } = await this.parse(ProvisioningGet);
+        const { id, singleton } = this.checkResourceId(args.resource, args.id, false);
+        const command = (id || singleton) ? retrieve_1.default : list_1.default;
+        const result = await command.run(this.argv, this.config);
+        return result;
+    }
+}
+ProvisioningGet.description = 'retrieve a resource or list a set of resources';
+ProvisioningGet.aliases = ['prov:get', 'pg', 'pget'];
+ProvisioningGet.examples = [
+    '$ commercelayer provisioning:get roles',
+    '$ commercelayer prov:get roles',
+    '$ clayer prov:get roles/<roleId>',
+    '$ cl prov:get roles <roleId>',
+];
+ProvisioningGet.strict = false;
+ProvisioningGet.flags = {
+    ...list_1.default.flags,
+};
+ProvisioningGet.args = {
+    ...retrieve_1.default.args,
+};
+exports.default = ProvisioningGet;

package/lib/commands/provisioning/list.d.ts

@@ -0,0 +1,22 @@
+import Command from '../../base';
+export default class ProvisioningList extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: string[];
+    static flags: {
+        where: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        pageSize: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        sort: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        extract: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'force-include': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        include: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        fields: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        unformatted: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        headers: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'headers-only': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<any>;
+}

package/lib/commands/provisioning/list.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const base_1 = tslib_1.__importStar(require("../../base"));
+// import { addRequestReader, isRequestInterrupted } from '../../lang'
+// import { mergeCommandParams } from '../../commands'
+const cli_core_1 = require("@commercelayer/cli-core");
+const OPERATION = 'list';
+class ProvisioningList extends base_1.default {
+    async run() {
+        const { args, flags } = await this.parse(ProvisioningList);
+        const resource = this.checkResource(args.resource);
+        // const loadParams = flags[FLAG_LOAD_PARAMS]
+        // const saveCmd = flags[FLAG_SAVE_PARAMS]
+        // if (saveCmd) this.checkAlias(saveCmd, resource.api, OPERATION, this.config)
+        const showHeaders = flags.headers || flags['headers-only'];
+        // Include flags
+        const include = this.includeFlag(flags.include, undefined, flags['force-include']);
+        // Fields flags
+        const fields = this.fieldsFlag(flags.fields, resource.api);
+        // Where flags
+        const wheres = this.whereFlag(flags.where);
+        // Sort flags
+        const sort = this.sortFlag(flags.sort);
+        const page = flags.page;
+        const perPage = flags.pageSize;
+        const cl = this.initCommerceLayer(flags);
+        const rawReader = flags.raw ? cl.addRawResponseReader({ headers: showHeaders }) : undefined;
+        // const reqReader = flags.doc ? addRequestReader(cl) : undefined
+        const params = {};
+        try {
+            const resSdk = cl[resource.api];
+            this.checkOperation(resSdk, OPERATION);
+            if (include && (include.length > 0))
+                params.include = include;
+            if (fields && (Object.keys(fields).length > 0))
+                params.fields = fields;
+            if (wheres && (Object.keys(wheres).length > 0))
+                params.filters = wheres;
+            if (sort && (Object.keys(sort).length > 0))
+                params.sort = sort;
+            if (perPage && (perPage > 0))
+                params.pageSize = perPage;
+            if (page && (page > 0))
+                params.pageNumber = page;
+            // Load saved command arguments
+            // if (loadParams) {
+            // 	 const savedParams = this.loadParams(loadParams, resource.api, OPERATION)
+            // 	 if (savedParams) mergeCommandParams(params, savedParams)
+            // }
+            // if (!flags.doc) cliux.action.start(`Fetching ${resource.api.replace(/_/g, ' ')}`)
+            const res = await resSdk.list(params);
+            base_1.cliux.action.stop();
+            const out = (flags.raw && rawReader) ? rawReader.rawResponse : [...res];
+            const meta = res.meta;
+            if (res && (res.length > 0)) {
+                if (flags.extract && Array.isArray(out)) {
+                    const ext = this.extractFlag(flags.extract);
+                    out.forEach(o => { this.extractObjectFields(ext, o); });
+                }
+                this.printHeaders(rawReader?.headers, flags);
+                this.printOutput(out, flags);
+                if (!flags['headers-only'])
+                    this.log(`\nRecords: ${cli_core_1.clColor.blueBright(res.length)} of ${meta.recordCount} | Page: ${cli_core_1.clColor.blueBright(String(flags.page || 1))} of ${meta.pageCount}\n`);
+                // Save command output
+                // if (flags.save || flags['save-path']) this.saveOutput(out, flags)
+            }
+            else
+                this.log(cli_core_1.clColor.italic('\nNo records found\n'));
+            // Save command arguments
+            // if (saveCmd) this.saveParams(saveCmd, { type: resource.api }, OPERATION, params)
+            return out;
+        }
+        catch (error) {
+            /*
+                  if (isRequestInterrupted(error) && reqReader) {
+                      await this.showLiveDocumentation(reqReader.request, params, flags)
+                      cl.removeInterceptor('request', reqReader.id)
+                  } else */ this.printError(error, flags, args);
+        }
+    }
+}
+ProvisioningList.description = 'fetch a collection of resources';
+ProvisioningList.aliases = ['pl', 'prov:list', 'plist', 'pls'];
+ProvisioningList.examples = [
+    '$ commercelayer provisioning:list roles -f id,name -i organization -s updated_at',
+    '$ cl prov:list roles -i organization -f name -f organizations/name -w organization_name_eq="ORG NAME"',
+    '$ cl prov:list roles -p 5 -n 10 -s -created_at --raw',
+];
+ProvisioningList.flags = {
+    ...base_1.default.flags,
+    where: base_1.Flags.string({
+        char: 'w',
+        multiple: true,
+        description: 'comma separated list of query filters',
+    }),
+    page: base_1.Flags.integer({
+        char: 'p',
+        description: 'page number',
+    }),
+    pageSize: base_1.Flags.integer({
+        char: 'n',
+        description: 'number of elements per page',
+    }),
+    sort: base_1.Flags.string({
+        char: 's',
+        description: 'defines results ordering',
+        multiple: true,
+    }),
+    /*
+    save: Flags.string({
+        char: 'x',
+        description: 'save command output to file',
+        multiple: false,
+        exclusive: ['save-path'],
+    }),
+    'save-path': Flags.string({
+        char: 'X',
+        description: 'save command output to file and create missing path directories',
+        multiple: false,
+        exclusive: ['save'],
+    }),
+    */
+    extract: base_1.Flags.string({
+        char: 'e',
+        description: 'extract subfields from object attributes',
+        multiple: true,
+        exclusive: ['raw'],
+    }),
+    'force-include': base_1.Flags.boolean({
+        char: 'I',
+        description: 'force resources inclusion beyound the 3rd level',
+        dependsOn: ['include'],
+        hidden: true,
+    }),
+};
+exports.default = ProvisioningList;

package/lib/commands/provisioning/noc.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class Noc extends Command {
+    static hidden: boolean;
+    static flags: {};
+    run(): Promise<any>;
+}

package/lib/commands/provisioning/noc.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+class Noc extends core_1.Command {
+    async run() {
+        const output = '-= NoC =-';
+        this.log(output);
+        return output;
+    }
+}
+Noc.hidden = true;
+Noc.flags = {};
+exports.default = Noc;

package/lib/commands/provisioning/relationship.d.ts

@@ -0,0 +1,30 @@
+import Command from '../../base';
+export default class ResourcesRelationship extends Command {
+    static description: string;
+    static aliases: string[];
+    static hidden: boolean;
+    static examples: string[];
+    static flags: {
+        where: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        pageSize: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        sort: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        extract: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'force-include': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        include: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        fields: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        unformatted: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        headers: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'headers-only': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {
+        id: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+        relationship: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+        resource: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<any>;
+    private checkRelationship;
+    private isRelationship1N;
+}

package/lib/commands/provisioning/relationship.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const base_1 = tslib_1.__importStar(require("../../base"));
+// import { addRequestReader, isRequestInterrupted } from '../../lang'
+// import { mergeCommandParams } from '../../commands'
+const list_1 = tslib_1.__importDefault(require("./list"));
+const cli_core_1 = require("@commercelayer/cli-core");
+// const OPERATION = 'relationship'
+class ResourcesRelationship extends base_1.default {
+    async run() {
+        const { args, flags } = await this.parse(ResourcesRelationship);
+        const { res: resName, id } = this.checkResourceId(args.resource, args.id);
+        const resource = this.checkResource(resName, { singular: true });
+        const relationship = args.relationship;
+        const multiRel = this.isRelationship1N(relationship);
+        const showHeaders = flags.headers || flags['headers-only'];
+        const cl = this.initCommerceLayer(flags);
+        const resSdk = cl[resource.api];
+        this.checkRelationship(resSdk, relationship);
+        // Load saved args
+        // const loadParams = flags[FLAG_LOAD_PARAMS]
+        // const saveCmd = flags[FLAG_SAVE_PARAMS]
+        // if (saveCmd) this.checkAlias(saveCmd, resource.api, OPERATION, this.config)
+        // Include flags
+        const include = this.includeFlag(flags.include);
+        // Fields flags
+        const fields = this.fieldsFlag(flags.fields, resource.api);
+        // Where flags
+        const wheres = this.whereFlag(flags.where);
+        // Sort flags
+        const sort = this.sortFlag(flags.sort);
+        const page = flags.page;
+        const perPage = flags.pageSize;
+        const rawReader = flags.raw ? cl.addRawResponseReader({ headers: showHeaders }) : undefined;
+        // const reqReader = flags.doc ? addRequestReader(cl) : undefined
+        const params = {};
+        try {
+            if (include && (include.length > 0))
+                params.include = include;
+            if (fields && (Object.keys(fields).length > 0))
+                params.fields = fields;
+            if (wheres && (Object.keys(wheres).length > 0))
+                params.filters = wheres;
+            if (sort && (Object.keys(sort).length > 0))
+                params.sort = sort;
+            if (perPage && (perPage > 0))
+                params.pageSize = perPage;
+            if (page && (page > 0))
+                params.pageNumber = page;
+            // Load saved command arguments
+            // if (loadParams) {
+            //   const savedParams = this.loadParams(loadParams, resource.api, OPERATION)
+            //   if (savedParams) mergeCommandParams(params, savedParams)
+            // }
+            // if (!flags.doc && multiRel) cliux.action.start(`Fetching ${resource.api.replace(/_/g, ' ')}.${relationship} for id ${id}`)
+            const res = await resSdk[relationship](id, params);
+            if (multiRel)
+                base_1.cliux.action.stop();
+            const out = (flags.raw && rawReader) ? rawReader.rawResponse : (multiRel ? [...res] : res);
+            if (out && flags.extract) {
+                const ext = this.extractFlag(flags.extract);
+                if (Array.isArray(out))
+                    out.forEach(o => { this.extractObjectFields(ext, o); });
+                else
+                    this.extractObjectFields(ext, out);
+            }
+            if (!out || (out.length === 0))
+                this.log(cli_core_1.clColor.italic(`\nRelationship ${cli_core_1.clColor.api.resource(`${resName}.${relationship}`)} is empty\n`));
+            else {
+                this.printHeaders(rawReader?.headers, flags);
+                this.printOutput(out, flags);
+                if (multiRel && !flags['headers-only'])
+                    this.log(`\nRecords: ${cli_core_1.clColor.blueBright(out.length)} of ${res.meta.recordCount} | Page: ${cli_core_1.clColor.blueBright(String(flags.page || 1))} of ${res.meta.pageCount}\n`);
+                // Save command output
+                // if (flags.save || flags['save-path']) this.saveOutput(out, flags)
+            }
+            // Save command arguments
+            // if (saveCmd) this.saveParams(saveCmd, { type: resource.api, id }, OPERATION, params)
+            return out;
+        }
+        catch (error) {
+            /* if (isRequestInterrupted(error) && reqReader) {
+              await this.showLiveDocumentation(reqReader.request, params, flags)
+              cl.removeInterceptor('request', reqReader.id)
+            } else */ this.printError(error, flags, args);
+        }
+    }
+    checkRelationship(sdk, name) {
+        if (!sdk[name])
+            this.error(`Relationship not available for resource ${cli_core_1.clColor.api.resource(sdk.type())}: ${cli_core_1.clColor.msg.error(name)}`);
+        return true;
+    }
+    isRelationship1N(name) {
+        return (name === cli_core_1.clText.pluralize(name));
+    }
+}
+ResourcesRelationship.description = 'fetch a resource relationship';
+ResourcesRelationship.aliases = ['provisioning:rel', 'prov:rel', 'prov:relationship'];
+ResourcesRelationship.hidden = true;
+ResourcesRelationship.examples = [
+    '$ commercelayer provisioning:relationship roles <roleId> organization',
+    '$ clayer prov:relationship roles <roleId> permissions',
+    '$ cl prov:rel roles <roleId> permisions -w subject_eq=testsub'
+];
+ResourcesRelationship.flags = {
+    ...list_1.default.flags,
+};
+ResourcesRelationship.args = {
+    ...base_1.default.args,
+    id: base_1.Args.string({ name: 'id', description: 'id of the resource to retrieve', required: true }),
+    relationship: base_1.Args.string({ name: 'relationship', description: 'name of the relationship field', required: true }),
+};
+exports.default = ResourcesRelationship;

package/lib/commands/provisioning/resources.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class ProvisioningResources extends Command {
+    static description: string;
+    static aliases: string[];
+    static examples: string[];
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+    };
+    run(): Promise<any>;
+    catch(error: any): Promise<any>;
+}

package/lib/commands/provisioning/resources.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const resources_1 = require("../../util/resources");
+const cli_core_1 = require("@commercelayer/cli-core");
+class ProvisioningResources extends core_1.Command {
+    async run() {
+        await this.parse(ProvisioningResources);
+        this.log(cli_core_1.clColor.style.title('\n-= Provisioning API available resources =-\n'));
+        const resourceArray = (0, resources_1.resourceList)('api').map(r => {
+            return { name: r, url: `${cli_core_1.clConfig.doc.provisioning_api_reference}/${r}` };
+        });
+        core_1.ux.Table.table(resourceArray, {
+            key: { header: 'NAME', minWidth: 35, get: row => cli_core_1.clColor.blueBright(row.name) },
+            description: { header: 'ONLINE DOCUMENTATION URL', get: row => row.url },
+        }, {
+            printLine: cli_core_1.clUtil.log,
+        });
+        this.log();
+    }
+    async catch(error) {
+        if ((error.code === 'EEXIT') && (error.message === 'EEXIT: 0'))
+            return;
+        return await super.catch(error);
+    }
+}
+ProvisioningResources.description = 'list all the available Provisioning API resources';
+ProvisioningResources.aliases = ['prov:resources', 'pres'];
+ProvisioningResources.examples = [
+    '$ commercelayer provisioning:resources',
+    '$ cl prov:resources',
+];
+ProvisioningResources.flags = {
+    help: core_1.Flags.help({ char: 'h' }),
+};
+exports.default = ProvisioningResources;