@tappify/cli 1.3.2 → 1.5.0

package/dist/src/domains/extension/services/dev.service.d.ts

@@ -0,0 +1,26 @@
+import { ApiService } from '../../../core/api/api.service.js';
+import { ConfigService } from '../../../core/config/config.service.js';
+import type { ExtensionManifest } from '@tappify/extension-sdk/manifest';
+export declare const DEFAULT_DEV_PORT = 5273;
+export declare const DEFAULT_PORTAL_URL = "https://developers.tappify.ai";
+export interface DevSession {
+    installId: string;
+    hostUrl: string;
+    previewUrl: string;
+    manifestApplied: boolean;
+}
+export interface DevSessionBody {
+    port?: number;
+    remoteUrl?: string;
+    serverBaseUrl?: string;
+}
+export declare class DevService {
+    private readonly api;
+    private readonly config;
+    constructor(api: ApiService, config: ConfigService);
+    portalBase(): string;
+    remoteEntry(port: number): string;
+    previewUrl(manifest: ExtensionManifest, remote: string): string;
+    startSession(manifest: ExtensionManifest, body: DevSessionBody): Promise<DevSession>;
+    endSession(manifest: ExtensionManifest): Promise<void>;
+}

package/dist/src/domains/extension/services/dev.service.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevService = exports.DEFAULT_PORTAL_URL = exports.DEFAULT_DEV_PORT = void 0;
+const api_service_js_1 = require("../../../core/api/api.service.js");
+const config_service_js_1 = require("../../../core/config/config.service.js");
+const common_1 = require("@nestjs/common");
+exports.DEFAULT_DEV_PORT = 5273;
+exports.DEFAULT_PORTAL_URL = 'https://developers.tappify.ai';
+const given = (value) => {
+    const trimmed = value?.trim();
+    return trimmed === undefined || trimmed.length === 0 ? undefined : trimmed;
+};
+let DevService = class DevService {
+    api;
+    config;
+    constructor(api, config) {
+        this.api = api;
+        this.config = config;
+    }
+    portalBase() {
+        return (given(process.env.TAPPIFY_PORTAL_URL) ??
+            given(this.config.get('portalUrl')) ??
+            exports.DEFAULT_PORTAL_URL);
+    }
+    remoteEntry(port) {
+        return `http://localhost:${port}/remoteEntry.js`;
+    }
+    previewUrl(manifest, remote) {
+        return `${this.portalBase()}/extensions/${manifest.id}/preview?remote=${encodeURIComponent(remote)}`;
+    }
+    async startSession(manifest, body) {
+        const session = await this.api.post(`/extensions/${manifest.id}/dev-session`, { manifest, ...body });
+        const project = /\/projects\/([^/]+)/.exec(session.hostUrl)?.[1];
+        if (project !== undefined) {
+            this.config.set('sandboxProjectId', project);
+        }
+        return session;
+    }
+    async endSession(manifest) {
+        await this.api.del(`/extensions/${manifest.id}/dev-session`);
+    }
+};
+exports.DevService = DevService;
+exports.DevService = DevService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [api_service_js_1.ApiService,
+        config_service_js_1.ConfigService])
+], DevService);
+//# sourceMappingURL=dev.service.js.map

package/dist/src/domains/extension/services/dev.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.service.js","sourceRoot":"","sources":["../../../../../src/domains/extension/services/dev.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8DAAuD;AACvD,uEAAgE;AAChE,2CAA4C;AAG/B,QAAA,gBAAgB,GAAG,IAAI,CAAC;AACxB,QAAA,kBAAkB,GAAG,+BAA+B,CAAC;AAWlE,MAAM,KAAK,GAAG,CAAC,KAAyB,EAAsB,EAAE;IAC9D,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC7E,CAAC,CAAC;AASK,IAAM,UAAU,GAAhB,MAAM,UAAU;IAEF;IACA;IAFnB,YACmB,GAAe,EACf,MAAqB;QADrB,QAAG,GAAH,GAAG,CAAY;QACf,WAAM,GAAN,MAAM,CAAe;IACrC,CAAC;IAEJ,UAAU;QACR,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACnC,0BAAkB,CACnB,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,OAAO,oBAAoB,IAAI,iBAAiB,CAAC;IACnD,CAAC;IAED,UAAU,CAAC,QAA2B,EAAE,MAAc;QACpD,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,eAAe,QAAQ,CAAC,EAAE,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;IACvG,CAAC;IAOD,KAAK,CAAC,YAAY,CAChB,QAA2B,EAC3B,IAAoB;QAEpB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CACjC,eAAe,QAAQ,CAAC,EAAE,cAAc,EACxC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,CACtB,CAAC;QAEF,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAA2B;QAC1C,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC;IAC/D,CAAC;CACF,CAAA;AA/CY,gCAAU;qBAAV,UAAU;IADtB,IAAA,mBAAU,GAAE;qCAGa,2BAAU;QACP,iCAAa;GAH7B,UAAU,CA+CtB"}

package/dist/src/domains/extension/services/doctor.service.d.ts

@@ -0,0 +1,36 @@
+import { ApiService } from '../../../core/api/api.service.js';
+import { ManifestService } from '../../../core/manifest/manifest.service.js';
+import type { ChecklistItem } from '../../../core/output/output.service.js';
+import { RegistryService } from '../../../core/registry/registry.service.js';
+import { ShellService } from '../../../core/shell/shell.service.js';
+import { type CheckResult, type LocalCheck } from './checks/index.js';
+import { TypesService } from './types.service.js';
+export declare const SCHEMA_URL = "https://schema.tappify.ai/extension/v2.json";
+export interface DoctorOptions {
+    fix: boolean;
+    skipTooling: boolean;
+    skipBundle: boolean;
+    offline: boolean;
+}
+export interface DoctorReport {
+    checks: CheckResult[];
+    items: ChecklistItem[];
+    errors: number;
+    warnings: number;
+    passed: number;
+    fixed: string[];
+}
+export declare class DoctorService {
+    private readonly manifests;
+    private readonly registry;
+    private readonly types;
+    private readonly shell;
+    private readonly api;
+    constructor(manifests: ManifestService, registry: RegistryService, types: TypesService, shell: ShellService, api: ApiService);
+    checks(): LocalCheck[];
+    run(root: string, options: DoctorOptions): Promise<DoctorReport>;
+    applyFixes(root: string): Promise<string[]>;
+    private unreported;
+    private serverItems;
+    private item;
+}

package/dist/src/domains/extension/services/doctor.service.js

@@ -0,0 +1,213 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DoctorService = exports.SCHEMA_URL = void 0;
+const api_service_js_1 = require("../../../core/api/api.service.js");
+const manifest_service_js_1 = require("../../../core/manifest/manifest.service.js");
+const scope_rules_js_1 = require("../../../core/manifest/scope-rules.js");
+const registry_service_js_1 = require("../../../core/registry/registry.service.js");
+const shell_service_js_1 = require("../../../core/shell/shell.service.js");
+const common_1 = require("@nestjs/common");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const labels_js_1 = require("../labels.js");
+const index_js_1 = require("./checks/index.js");
+const failures_js_1 = require("./failures.js");
+const types_service_js_1 = require("./types.service.js");
+exports.SCHEMA_URL = 'https://schema.tappify.ai/extension/v2.json';
+const sameResult = (left, right) => left.id === right.id &&
+    left.level === right.level &&
+    left.message === right.message &&
+    left.path === right.path;
+let DoctorService = class DoctorService {
+    manifests;
+    registry;
+    types;
+    shell;
+    api;
+    constructor(manifests, registry, types, shell, api) {
+        this.manifests = manifests;
+        this.registry = registry;
+        this.types = types;
+        this.shell = shell;
+        this.api = api;
+    }
+    checks() {
+        return [
+            index_js_1.schemaCheck,
+            index_js_1.schemaUrlCheck,
+            index_js_1.scopesCheck,
+            index_js_1.justificationCheck,
+            index_js_1.sdkCheck,
+            index_js_1.entryCheck,
+            index_js_1.iconCheck,
+            index_js_1.schemaFileCheck,
+            index_js_1.listingCheck,
+            index_js_1.procedureKindCheck,
+            (0, index_js_1.typesFreshCheck)(async (root) => (await this.types.render(root)).text),
+            (0, index_js_1.typescriptCheck)(this.shell),
+            (0, index_js_1.lintCheck)(this.shell),
+            (0, index_js_1.testsCheck)(this.shell),
+            (0, index_js_1.buildCheck)(this.shell),
+            index_js_1.bundleCheck,
+            (0, index_js_1.a11yCheck)(this.shell),
+        ];
+    }
+    async run(root, options) {
+        const fixed = options.fix ? await this.applyFixes(root) : [];
+        const manifest = this.manifests.read(root);
+        const registry = await this.registry.get({ refresh: !options.offline });
+        const context = { root, manifest, registry };
+        const items = [];
+        const checks = [];
+        for (const check of this.checks()) {
+            if (options.skipTooling && check.needs === 'tooling')
+                continue;
+            if (options.skipBundle && check.needs === 'build')
+                continue;
+            const results = await check.run(context);
+            checks.push(...results);
+            items.push(this.item(check.label, results));
+        }
+        if ((0, registry_service_js_1.isOfflineEventCatalogue)(registry)) {
+            const stale = {
+                id: 'registry.offline',
+                level: 'warning',
+                message: registry_service_js_1.OFFLINE_EVENTS_NOTE.why,
+            };
+            checks.push(stale);
+            items.push(this.item('event catalogue', [stale]));
+        }
+        if (!options.offline) {
+            const exposes = (0, index_js_1.bundleExposes)(root);
+            let server = null;
+            let refused = null;
+            try {
+                server = await this.api.post(`/extensions/${manifest.id}/checks`, { manifest, ...(exposes === null ? {} : { exposes }) });
+            }
+            catch (error) {
+                if (error instanceof api_service_js_1.ApiError) {
+                    refused = {
+                        id: 'checks.refused',
+                        level: 'warning',
+                        message: (0, failures_js_1.toFailure)(error).why,
+                    };
+                }
+            }
+            if (refused !== null) {
+                checks.push(refused);
+                items.push(this.item('Tappify checks', [refused]));
+            }
+            else if (server === null) {
+                const unreachable = {
+                    id: 'checks.unreachable',
+                    level: 'warning',
+                    message: 'Tappify could not be reached, so its checks did not run',
+                };
+                checks.push(unreachable);
+                items.push(this.item('Tappify checks', [unreachable]));
+            }
+            else {
+                const fresh = this.unreported(server, checks, options);
+                checks.push(...fresh);
+                items.push(...(fresh.length === 0
+                    ? [{ level: 'pass', label: 'Tappify checks' }]
+                    : this.serverItems(fresh)));
+            }
+        }
+        return {
+            checks,
+            items,
+            fixed,
+            errors: checks.filter(check => check.level === 'error').length,
+            warnings: checks.filter(check => check.level === 'warning').length,
+            passed: items.filter(item => item.level === 'pass').length,
+        };
+    }
+    async applyFixes(root) {
+        const applied = [];
+        const manifest = this.manifests.read(root);
+        if (manifest.$schema === undefined) {
+            manifest.$schema = exports.SCHEMA_URL;
+            applied.push('added the $schema line');
+        }
+        const declared = new Set(manifest.scopes.map(scope => scope.key));
+        const added = (0, scope_rules_js_1.requiredScopes)(manifest).filter(key => !declared.has(key));
+        for (const key of added) {
+            manifest.scopes = [
+                ...manifest.scopes,
+                (0, labels_js_1.wantsJustification)(key)
+                    ? { key, justification: (0, labels_js_1.placeholderJustification)(manifest.name, key) }
+                    : { key },
+            ];
+        }
+        const plain = added.filter(key => !(0, labels_js_1.wantsJustification)(key));
+        if (plain.length > 0) {
+            applied.push(`added the scopes ${plain.join(', ')}`);
+        }
+        for (const key of added.filter(labels_js_1.wantsJustification)) {
+            applied.push(`added ${key} with a placeholder justification you must edit`);
+        }
+        if (applied.length > 0)
+            this.manifests.write(root, manifest);
+        const file = (0, node_path_1.join)(root, ...types_service_js_1.TYPES_FILE.split('/'));
+        const before = (0, node_fs_1.existsSync)(file) ? (0, node_fs_1.readFileSync)(file, 'utf8') : null;
+        const types = await this.types.write(root);
+        if (before !== (0, node_fs_1.readFileSync)(file, 'utf8')) {
+            applied.push(`rewrote ${types.file}`);
+        }
+        return applied;
+    }
+    unreported(server, local, options) {
+        const ranLocally = !options.skipTooling;
+        return server.filter(result => !local.some(seen => sameResult(seen, result)) &&
+            !(result.id === 'a11y' && ranLocally));
+    }
+    serverItems(results) {
+        const groups = new Map();
+        for (const result of results) {
+            const key = result.path ?? result.id;
+            groups.set(key, [...(groups.get(key) ?? []), result]);
+        }
+        return [...groups].map(([where, rows]) => this.item(`Tappify checks: ${where}`, rows));
+    }
+    item(label, results) {
+        const error = results.find(result => result.level === 'error');
+        if (error !== undefined) {
+            return {
+                level: 'error',
+                label,
+                message: error.message,
+                fix: index_js_1.FIXES[error.id],
+            };
+        }
+        const warning = results[0];
+        if (warning !== undefined) {
+            return {
+                level: 'warning',
+                label,
+                message: warning.message,
+                fix: index_js_1.FIXES[warning.id],
+            };
+        }
+        return { level: 'pass', label };
+    }
+};
+exports.DoctorService = DoctorService;
+exports.DoctorService = DoctorService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [manifest_service_js_1.ManifestService,
+        registry_service_js_1.RegistryService,
+        types_service_js_1.TypesService,
+        shell_service_js_1.ShellService,
+        api_service_js_1.ApiService])
+], DoctorService);
+//# sourceMappingURL=doctor.service.js.map

package/dist/src/domains/extension/services/doctor.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.service.js","sourceRoot":"","sources":["../../../../../src/domains/extension/services/doctor.service.ts"],"names":[],"mappings":"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"}

package/dist/src/domains/extension/services/failures.d.ts

@@ -0,0 +1,8 @@
+import type { Failure } from '../../../core/output/output.service.js';
+export declare const SUSPENDED: {
+    what: string;
+    fix: string;
+};
+export declare const NOT_SIGNED_IN: Failure;
+export declare const notSignedIn: (why: string) => Failure;
+export declare const toFailure: (error: unknown) => Failure;

package/dist/src/domains/extension/services/failures.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toFailure = exports.notSignedIn = exports.NOT_SIGNED_IN = exports.SUSPENDED = void 0;
+const api_service_js_1 = require("../../../core/api/api.service.js");
+exports.SUSPENDED = {
+    what: 'This extension is suspended.',
+    fix: 'Ask Tappify support what the suspension needs; a suspended extension cannot publish.',
+};
+const MAPPINGS = {
+    VENDOR_NOT_FOUND: {
+        what: 'This workspace has no vendor account.',
+        why: 'Extensions belong to a vendor, and Tappify has none for the workspace you are signed in to.',
+        fix: 'Run `tappify vendor create` to create one, then run this command again.',
+    },
+    VENDOR_ALREADY_EXISTS: {
+        what: 'This workspace already has a vendor account.',
+        fix: 'Run `tappify extension whoami` to see it.',
+    },
+    VENDOR_WORKSPACE_MISSING: {
+        what: 'You are not signed in to a workspace.',
+        fix: 'Run `tappify login` and pick a workspace, then run this command again.',
+    },
+    SESSION_EXPIRED: {
+        what: 'Tappify did not accept your session.',
+        fix: 'Run `tappify login`, then run this command again.',
+    },
+    INVALID_TOKEN: {
+        what: 'Tappify did not accept your session.',
+        fix: 'Run `tappify login`, then run this command again.',
+    },
+    UNAUTHORIZED: {
+        what: 'Your vendor role does not allow this.',
+        why: 'Publishing, retiring and creating extensions need the admin role.',
+        fix: 'Ask a vendor admin to run it, or to change your role.',
+    },
+    SANDBOX_PROJECT_MISSING: {
+        what: 'This vendor has no sandbox project.',
+        fix: 'Run `tappify vendor create` to provision one, then run this command again.',
+    },
+    EXTENSION_NOT_FOUND: {
+        what: 'Tappify has no extension with this id for your vendor.',
+        fix: 'Run `tappify extension publish` or `tappify extension dev --live`; either registers the id with the Tap Store first.',
+    },
+    EXTENSION_ID_TAKEN: {
+        what: 'That extension id is already in use.',
+        fix: 'Run `tappify extension set id <new-id>` and publish again.',
+    },
+    EXTENSION_ID_RESERVED: {
+        what: 'That extension id is reserved.',
+        fix: 'Run `tappify extension set id <new-id>` and publish again.',
+    },
+    MANIFEST_INVALID: {
+        what: 'Tappify rejected the manifest.',
+        fix: 'Run `tappify extension doctor` to see every rule it broke, then fix them.',
+    },
+    BUNDLE_INVALID: {
+        what: 'Tappify rejected the bundle.',
+        rewrite: message => message.split(' | ').join('\n'),
+        fix: 'Run `tappify extension doctor` to see every check Tappify runs, then fix what it lists.',
+    },
+    BUNDLE_TOO_LARGE: {
+        what: 'Tappify rejected the request.',
+        fix: 'Trim the build under 5 MB, then run `tappify extension publish` again.',
+    },
+    EXTENSION_SUSPENDED: exports.SUSPENDED,
+    SERVER_HEALTH_FAILED: {
+        what: 'Your extension server did not answer.',
+        fix: 'Deploy the server the line above names so GET /tappify/health answers 200, then publish again.',
+    },
+    NO_LIVE_RELEASE: {
+        what: 'This extension has no live release.',
+        fix: 'Run `tappify extension publish` first.',
+    },
+    RATE_LIMIT_EXCEEDED: {
+        what: 'Tappify is rate limiting this extension.',
+        fix: 'Wait for the window the line above names to pass, then run the command again.',
+    },
+};
+exports.NOT_SIGNED_IN = {
+    what: 'You are not signed in.',
+    why: 'Reading an extension needs a Tappify session.',
+    fix: 'Run `tappify login`, then run this command again.',
+};
+const notSignedIn = (why) => ({
+    ...exports.NOT_SIGNED_IN,
+    why,
+});
+exports.notSignedIn = notSignedIn;
+const GENERIC = {
+    what: 'Tappify rejected the request.',
+    fix: 'Run `tappify extension doctor` to see what Tappify checks, then fix what it lists.',
+};
+const toFailure = (error) => {
+    if (error instanceof api_service_js_1.ApiError) {
+        const mapping = error.errorCode !== null
+            ? (MAPPINGS[error.errorCode] ?? GENERIC)
+            : GENERIC;
+        return {
+            ...(error.errorCode === null ? {} : { code: error.errorCode }),
+            what: mapping.what,
+            why: mapping.why ?? mapping.rewrite?.(error.message) ?? error.message,
+            fix: mapping.fix,
+        };
+    }
+    return {
+        what: 'The command did not finish.',
+        why: error instanceof Error ? error.message : String(error),
+        fix: 'Check your connection and run the command again; if it keeps failing, report it at https://docs.tappify.ai.',
+    };
+};
+exports.toFailure = toFailure;
+//# sourceMappingURL=failures.js.map

package/dist/src/domains/extension/services/failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.js","sourceRoot":"","sources":["../../../../../src/domains/extension/services/failures.ts"],"names":[],"mappings":"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"}

package/dist/src/domains/extension/services/guided.service.d.ts

@@ -0,0 +1,36 @@
+import { OutputService } from '../../../core/output/output.service.js';
+import { PromptService } from '../../../core/prompt/prompt.service.js';
+import { type Choice } from '../labels.js';
+export interface ValueQuestion {
+    flag: string;
+    question: string;
+    fallback?: string;
+    noun?: string;
+    validate?(value: string): string | null;
+}
+export interface ChoiceQuestion<T extends string> {
+    flag: string | null;
+    positional?: string;
+    question: string;
+    choices: Choice<T>[];
+    noun?: string;
+    plural?: string;
+    fallback?: T;
+}
+export interface ConfirmQuestion {
+    flag: string;
+    question: string;
+    fallback: boolean;
+}
+export declare class GuidedService {
+    private readonly prompt;
+    private readonly output;
+    constructor(prompt: PromptService, output: OutputService);
+    guidedAvailable(): boolean;
+    private missing;
+    value(flag: string | undefined, question: ValueQuestion): Promise<string>;
+    private checked;
+    choose<T extends string>(flag: string | undefined, question: ChoiceQuestion<T>): Promise<T>;
+    chooseMany<T extends string>(flag: string | undefined, question: ChoiceQuestion<T>): Promise<string>;
+    confirm(flag: boolean | undefined, question: ConfirmQuestion): Promise<boolean>;
+}

package/dist/src/domains/extension/services/guided.service.js

@@ -0,0 +1,133 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuidedService = void 0;
+const output_service_js_1 = require("../../../core/output/output.service.js");
+const prompt_service_js_1 = require("../../../core/prompt/prompt.service.js");
+const common_1 = require("@nestjs/common");
+const labels_js_1 = require("../labels.js");
+let GuidedService = class GuidedService {
+    prompt;
+    output;
+    constructor(prompt, output) {
+        this.prompt = prompt;
+        this.output = output;
+    }
+    guidedAvailable() {
+        return process.stdin.isTTY === true && !this.output.isJson();
+    }
+    missing(label) {
+        return this.output.fail({
+            what: `\`${label}\` is missing.`,
+            why: this.output.isJson()
+                ? 'This command was asked for JSON, so it cannot show a list.'
+                : 'This shell has no terminal, so it cannot show a list.',
+            fix: `Pass \`${label}\` on the command line.`,
+        });
+    }
+    async value(flag, question) {
+        if (flag !== undefined)
+            return this.checked(flag, question);
+        if (!this.guidedAvailable()) {
+            if (question.fallback !== undefined)
+                return question.fallback;
+            this.missing(question.flag);
+        }
+        const answered = await this.prompt.text(question.question, question.fallback);
+        return this.checked(answered, question);
+    }
+    checked(value, question) {
+        const problem = question.validate?.(value) ?? null;
+        if (problem === null)
+            return value;
+        const noun = question.noun ?? 'value';
+        return this.output.fail({
+            what: `\`${question.flag}\` is not valid.`,
+            why: problem,
+            fix: `Pass ${(0, labels_js_1.article)(noun)} ${noun} that fits, then run the command again.`,
+        });
+    }
+    async choose(flag, question) {
+        const positional = question.positional;
+        if (flag !== undefined) {
+            const match = question.choices.find(choice => choice.value === flag);
+            if (match !== undefined)
+                return match.value;
+            const noun = question.noun ?? 'value';
+            const plural = question.plural ?? `${noun}s`;
+            const served = question.choices.map(choice => choice.value).join(', ');
+            return this.output.fail({
+                what: positional === undefined
+                    ? `\`${question.flag} ${flag}\` is not ${(0, labels_js_1.article)(noun)} ${noun}.`
+                    : `\`${flag}\` is not ${(0, labels_js_1.article)(noun)} ${noun}.`,
+                why: `Tappify serves these ${plural}: ${served}.`,
+                fix: positional === undefined
+                    ? 'Pass one of them, or drop the flag to choose from a list.'
+                    : `Pass one of them, or omit the ${positional} to choose from a list.`,
+            });
+        }
+        if (!this.guidedAvailable()) {
+            if (question.fallback !== undefined)
+                return question.fallback;
+            this.missing(question.flag ?? positional ?? 'value');
+        }
+        const index = await this.prompt.select(question.question, question.choices.map(choice => ({
+            label: choice.label,
+            hint: choice.hint,
+        })));
+        return question.choices[index].value;
+    }
+    async chooseMany(flag, question) {
+        const noun = question.noun ?? 'value';
+        const plural = question.plural ?? `${noun}s`;
+        if (flag !== undefined) {
+            const wanted = [
+                ...new Set(flag
+                    .split(',')
+                    .map(part => part.trim())
+                    .filter(part => part.length > 0)),
+            ];
+            const unknown = wanted.filter(part => !question.choices.some(choice => choice.value === part));
+            if (unknown.length === 0 && wanted.length > 0)
+                return wanted.join(',');
+            const served = question.choices.map(choice => choice.value).join(', ');
+            return this.output.fail({
+                what: `\`${question.flag ?? noun} ${flag}\` is not a list of ${plural}.`,
+                why: `Tappify serves these ${plural}: ${served}.`,
+                fix: 'Pass them separated by commas, or drop the flag to pick from a list.',
+            });
+        }
+        if (!this.guidedAvailable()) {
+            if (question.fallback !== undefined)
+                return question.fallback;
+            this.missing(question.flag ?? question.positional ?? 'value');
+        }
+        const picked = await this.prompt.multiSelect(question.question, question.choices.map(choice => ({
+            label: choice.label,
+            hint: choice.hint,
+        })), { min: 1 });
+        return picked.map(index => question.choices[index].value).join(',');
+    }
+    async confirm(flag, question) {
+        if (flag !== undefined)
+            return flag;
+        if (!this.guidedAvailable())
+            return question.fallback;
+        return this.prompt.confirm(question.question, question.fallback);
+    }
+};
+exports.GuidedService = GuidedService;
+exports.GuidedService = GuidedService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [prompt_service_js_1.PromptService,
+        output_service_js_1.OutputService])
+], GuidedService);
+//# sourceMappingURL=guided.service.js.map