@tappify/cli 1.3.2 → 1.5.0

package/dist/src/domains/extension/kinds.types.d.ts

@@ -0,0 +1,65 @@
+import type { Failure } from '../../core/output/output.service.js';
+import type { ExtensionRegistry } from '../../core/registry/registry.service.js';
+import type { ExtensionManifest, ScopeKey } from '@tappify/extension-sdk/manifest';
+import { type Choice } from './labels.js';
+export type KindValues = Record<string, string | boolean | undefined>;
+export interface KindContext {
+    manifest: ExtensionManifest;
+    registry: ExtensionRegistry;
+    values: KindValues;
+    name: string;
+    file: string;
+    pascal: string;
+    camel: string;
+    title: string;
+}
+export interface KindQuestion {
+    field: string;
+    flag: string;
+    help: string;
+    question: string;
+    type: 'text' | 'select' | 'multi' | 'confirm';
+    fallback?: string | boolean;
+    empty?: Failure;
+    choices?(context: KindContext): Choice<string>[];
+    validate?(value: string, context: KindContext): string | null;
+}
+export interface BarrelSpec {
+    directory: string;
+    exportName: string;
+    keyedBy: 'id' | 'identifier';
+}
+export type IdCase = 'kebab' | 'camel' | 'snake' | 'raw';
+export interface KindDefinition {
+    command: string;
+    label: string;
+    noun: string;
+    singleton: boolean;
+    idCase: IdCase;
+    namePrompt: string | null;
+    questions: KindQuestion[];
+    entry(context: KindContext): Record<string, unknown>;
+    place(manifest: ExtensionManifest, entry: Record<string, unknown>, context: KindContext): void;
+    scopes(context: KindContext): ScopeKey[];
+    template: string | null | ((context: KindContext) => string | null);
+    barrel: BarrelSpec | null;
+    next(context: KindContext, files: string[]): string;
+}
+export declare const ID_RULES: Record<IdCase, {
+    pattern: RegExp;
+    hint: string;
+}>;
+export declare const str: (values: KindValues, field: string) => string;
+export declare const bool: (values: KindValues, field: string) => boolean;
+export declare const push: <T>(list: T[] | undefined, entry: T) => T[];
+export declare const fileStem: (kind: KindDefinition, name: string) => string;
+export declare const withServer: (manifest: ExtensionManifest) => NonNullable<ExtensionManifest["server"]>;
+export declare const pageChoices: (context: KindContext) => Choice<string>[];
+export declare const slotChoices: (context: KindContext) => Choice<string>[];
+export declare const chartChoices: (context: KindContext) => Choice<string>[];
+export declare const tableChoices: (context: KindContext) => Choice<string>[];
+export declare const metricChoices: (context: KindContext) => Choice<string>[];
+export declare const scopeChoices: (context: KindContext) => Choice<string>[];
+export declare const templateFor: (kind: KindDefinition, context: KindContext) => string | null;
+export declare const PAGE_QUESTION: KindQuestion;
+export declare const MOBILE_QUESTION: KindQuestion;

package/dist/src/domains/extension/kinds.types.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MOBILE_QUESTION = exports.PAGE_QUESTION = exports.templateFor = exports.scopeChoices = exports.metricChoices = exports.tableChoices = exports.chartChoices = exports.slotChoices = exports.pageChoices = exports.withServer = exports.fileStem = exports.push = exports.bool = exports.str = exports.ID_RULES = void 0;
+const labels_js_1 = require("./labels.js");
+exports.ID_RULES = {
+    kebab: {
+        pattern: /^[a-z][a-z0-9-]{1,39}$/,
+        hint: 'An id is 2 to 40 characters of lowercase letters, digits and hyphens, starting with a letter.',
+    },
+    camel: {
+        pattern: /^[a-zA-Z][a-zA-Z0-9_-]{1,59}$/,
+        hint: 'A name is 2 to 60 characters of letters, digits, hyphens and underscores, starting with a letter.',
+    },
+    snake: {
+        pattern: /^[a-z][a-z0-9_]{1,59}$/,
+        hint: 'A collection name is 2 to 60 characters of lowercase letters, digits and underscores, starting with a letter.',
+    },
+    raw: {
+        pattern: /^[a-z][a-z0-9_]*\.[a-z][a-z0-9_]*$/,
+        hint: 'An event name is two lowercase words joined by a dot, such as "funnel.dropped".',
+    },
+};
+const str = (values, field) => {
+    const value = values[field];
+    return typeof value === 'string' ? value : '';
+};
+exports.str = str;
+const bool = (values, field) => values[field] === true;
+exports.bool = bool;
+const push = (list, entry) => [
+    ...(list ?? []),
+    entry,
+];
+exports.push = push;
+const fileStem = (kind, name) => (0, labels_js_1.kebabCase)(name === kind.label ? kind.command : name);
+exports.fileStem = fileStem;
+const withServer = (manifest) => {
+    manifest.server = {
+        ...manifest.server,
+        baseUrl: manifest.server?.baseUrl ?? `https://${manifest.id}.example.com`,
+    };
+    return manifest.server;
+};
+exports.withServer = withServer;
+const pageChoices = (context) => context.registry.pages
+    .filter(page => page.key !== 'ai_chat')
+    .map(page => ({ value: page.key, label: page.label }));
+exports.pageChoices = pageChoices;
+const slotChoices = (context) => {
+    const page = (0, exports.str)(context.values, 'page');
+    const slots = context.registry.pages.find(entry => entry.key === page)?.slots ?? [];
+    return slots.map(slot => ({
+        value: slot,
+        label: (0, labels_js_1.label)(labels_js_1.SLOT_LABELS, slot),
+        hint: labels_js_1.SLOT_HINTS[slot],
+    }));
+};
+exports.slotChoices = slotChoices;
+const chartChoices = (context) => context.registry.charts.map(chart => ({
+    value: chart,
+    label: chart.split('-').join(' '),
+}));
+exports.chartChoices = chartChoices;
+const tableChoices = (context) => context.registry.tables.map(table => ({
+    value: table.key,
+    label: table.label,
+}));
+exports.tableChoices = tableChoices;
+const metricChoices = (context) => (context.manifest.contributes.connector?.metrics ?? []).map(metric => ({
+    value: metric.key,
+    label: metric.label,
+}));
+exports.metricChoices = metricChoices;
+const scopeChoices = (context) => context.registry.scopes.map(scope => ({
+    value: scope.key,
+    label: scope.label,
+    hint: scope.description,
+}));
+exports.scopeChoices = scopeChoices;
+const templateFor = (kind, context) => typeof kind.template === 'function' ? kind.template(context) : kind.template;
+exports.templateFor = templateFor;
+exports.PAGE_QUESTION = {
+    field: 'page',
+    flag: '--page',
+    help: 'Host page the contribution renders on',
+    question: 'Which host page does it render on?',
+    type: 'select',
+    choices: exports.pageChoices,
+};
+exports.MOBILE_QUESTION = {
+    field: 'mobile',
+    flag: '--no-mobile',
+    help: 'Hide the contribution on phone layouts',
+    question: 'Should it show on phone layouts?',
+    type: 'confirm',
+    fallback: true,
+};
+//# sourceMappingURL=kinds.types.js.map

package/dist/src/domains/extension/kinds.types.js.map

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

package/dist/src/domains/extension/kinds.ui.d.ts

@@ -0,0 +1,4 @@
+import { type KindContext, type KindDefinition } from './kinds.types.js';
+import { type Choice } from './labels.js';
+export declare const ownEventChoices: (context: KindContext, as: "banner" | "event") => Choice<string>[];
+export declare const UI_KINDS: KindDefinition[];

package/dist/src/domains/extension/kinds.ui.js

@@ -0,0 +1,309 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UI_KINDS = exports.ownEventChoices = void 0;
+const kinds_types_js_1 = require("./kinds.types.js");
+const labels_js_1 = require("./labels.js");
+const PREVIEW = 'Run `tappify extension dev` to see it in the preview.';
+const ownEventChoices = (context, as) => (context.manifest.contributes.webhooks ?? [])
+    .filter(hook => hook.as === as)
+    .map(hook => ({ value: hook.event, label: hook.event }));
+exports.ownEventChoices = ownEventChoices;
+exports.UI_KINDS = [
+    {
+        command: 'widget',
+        label: 'Widget',
+        noun: 'widget',
+        singleton: false,
+        idCase: 'kebab',
+        namePrompt: 'What is the widget called?',
+        questions: [
+            kinds_types_js_1.PAGE_QUESTION,
+            {
+                field: 'slot',
+                flag: '--slot',
+                help: 'Anchor on the page the widget renders into',
+                question: 'Which slot on that page?',
+                type: 'select',
+                choices: kinds_types_js_1.slotChoices,
+            },
+            {
+                field: 'size',
+                flag: '--size',
+                help: 'Space the widget takes in the slot',
+                question: 'How much space does it take?',
+                type: 'select',
+                choices: () => labels_js_1.SIZE_CHOICES.map(choice => ({ ...choice })),
+            },
+            {
+                field: 'expandable',
+                flag: '--expandable',
+                help: 'Let owners expand the widget into a panel',
+                question: 'Can owners expand it into a panel?',
+                type: 'confirm',
+                fallback: false,
+            },
+        ],
+        entry: context => ({
+            id: context.name,
+            title: context.title,
+            entry: `src/widgets/${context.file}.tsx`,
+            page: (0, kinds_types_js_1.str)(context.values, 'page'),
+            slot: (0, kinds_types_js_1.str)(context.values, 'slot'),
+            size: (0, kinds_types_js_1.str)(context.values, 'size'),
+            ...((0, kinds_types_js_1.bool)(context.values, 'expandable') ? { expandable: true } : {}),
+        }),
+        place: (manifest, entry) => {
+            manifest.contributes.widgets = (0, kinds_types_js_1.push)(manifest.contributes.widgets, entry);
+        },
+        scopes: () => ['ui:render'],
+        template: 'widget',
+        barrel: null,
+        next: () => PREVIEW,
+    },
+    {
+        command: 'tab',
+        label: 'Tab',
+        noun: 'tab',
+        singleton: false,
+        idCase: 'kebab',
+        namePrompt: 'What is the tab called?',
+        questions: [kinds_types_js_1.PAGE_QUESTION, kinds_types_js_1.MOBILE_QUESTION],
+        entry: context => ({
+            id: context.name,
+            title: context.title,
+            entry: `src/tabs/${context.file}.tsx`,
+            page: (0, kinds_types_js_1.str)(context.values, 'page'),
+            ...(context.values.mobile === false ? { mobile: false } : {}),
+        }),
+        place: (manifest, entry) => {
+            manifest.contributes.tabs = (0, kinds_types_js_1.push)(manifest.contributes.tabs, entry);
+        },
+        scopes: () => ['ui:render'],
+        template: 'tab',
+        barrel: null,
+        next: () => PREVIEW,
+    },
+    {
+        command: 'page',
+        label: 'Page',
+        noun: 'page',
+        singleton: false,
+        idCase: 'kebab',
+        namePrompt: 'What is the page called?',
+        questions: [
+            {
+                field: 'nav',
+                flag: '--nav',
+                help: 'Add the page to the project navigation',
+                question: 'Should it appear in the project navigation?',
+                type: 'confirm',
+                fallback: true,
+            },
+            kinds_types_js_1.MOBILE_QUESTION,
+        ],
+        entry: context => ({
+            id: context.name,
+            title: context.title,
+            entry: `src/pages/${context.file}.tsx`,
+            ...((0, kinds_types_js_1.bool)(context.values, 'nav') ? { nav: true } : {}),
+            ...(context.values.mobile === false ? { mobile: false } : {}),
+        }),
+        place: (manifest, entry) => {
+            manifest.contributes.pages = (0, kinds_types_js_1.push)(manifest.contributes.pages, entry);
+        },
+        scopes: () => ['ui:render'],
+        template: 'page',
+        barrel: null,
+        next: () => PREVIEW,
+    },
+    {
+        command: 'row-action',
+        label: 'Row action',
+        noun: 'row action',
+        singleton: false,
+        idCase: 'kebab',
+        namePrompt: 'What is the row action called?',
+        questions: [
+            {
+                field: 'table',
+                flag: '--table',
+                help: 'Host table whose row menu the action joins',
+                question: 'Which table are the rows in?',
+                type: 'select',
+                choices: kinds_types_js_1.tableChoices,
+            },
+        ],
+        entry: context => ({
+            id: context.name,
+            title: context.title,
+            entry: `src/row-actions/${context.file}.tsx`,
+            table: (0, kinds_types_js_1.str)(context.values, 'table'),
+        }),
+        place: (manifest, entry) => {
+            manifest.contributes.rowActions = (0, kinds_types_js_1.push)(manifest.contributes.rowActions, entry);
+        },
+        scopes: () => ['ui:render'],
+        template: 'row-action',
+        barrel: null,
+        next: () => PREVIEW,
+    },
+    {
+        command: 'settings',
+        label: 'Settings panel',
+        noun: 'settings panel',
+        singleton: true,
+        idCase: 'kebab',
+        namePrompt: null,
+        questions: [],
+        entry: () => ({
+            entry: 'src/settings.tsx',
+            schema: { $ref: './schemas/settings.json' },
+        }),
+        place: (manifest, entry) => {
+            manifest.contributes.settings = entry;
+        },
+        scopes: () => ['ui:render'],
+        template: 'settings',
+        barrel: null,
+        next: () => 'Edit schemas/settings.json to describe what owners set, then run `tappify extension types`.',
+    },
+    {
+        command: 'marker',
+        label: 'Chart marker',
+        noun: 'marker',
+        singleton: false,
+        idCase: 'kebab',
+        namePrompt: 'What is the marker called?',
+        questions: [
+            {
+                field: 'chart',
+                flag: '--chart',
+                help: 'Host chart the series or marker draws on',
+                question: 'Which chart does it draw on?',
+                type: 'select',
+                choices: context => [
+                    ...(0, kinds_types_js_1.chartChoices)(context),
+                    { value: '*', label: 'Every chart' },
+                ],
+            },
+            {
+                field: 'event',
+                flag: '--event',
+                help: 'Webhook event of yours the banner or marker draws',
+                question: 'Which of your webhook events does it draw?',
+                type: 'select',
+                choices: context => (0, exports.ownEventChoices)(context, 'event'),
+                empty: {
+                    what: 'This extension declares no event a marker can draw.',
+                    why: 'A marker draws one of your own webhooks, and only a webhook you send as an event can be drawn.',
+                    fix: 'Run `tappify extension add webhook` and answer "Only as an event other contributions read", then add the marker.',
+                },
+            },
+            {
+                field: 'glyph',
+                flag: '--glyph',
+                help: 'One or two characters drawn on the chart',
+                question: 'What one or two characters mark it?',
+                type: 'text',
+                validate: value => value.length >= 1 && value.length <= 2
+                    ? null
+                    : 'A glyph is one or two characters.',
+            },
+        ],
+        entry: context => ({
+            id: context.name,
+            label: context.title,
+            chart: (0, kinds_types_js_1.str)(context.values, 'chart'),
+            event: (0, kinds_types_js_1.str)(context.values, 'event'),
+            glyph: (0, kinds_types_js_1.str)(context.values, 'glyph'),
+        }),
+        place: (manifest, entry) => {
+            manifest.contributes.markers = (0, kinds_types_js_1.push)(manifest.contributes.markers, entry);
+        },
+        scopes: () => ['ui:render', 'alerts:write'],
+        template: null,
+        barrel: null,
+        next: () => 'Send the event from your server with sendEvent to see the marker.',
+    },
+    {
+        command: 'series',
+        label: 'Chart series',
+        noun: 'series',
+        singleton: false,
+        idCase: 'kebab',
+        namePrompt: 'What is the series called?',
+        questions: [
+            {
+                field: 'chart',
+                flag: '--chart',
+                help: 'Host chart the series or marker draws on',
+                question: 'Which chart does it draw on?',
+                type: 'select',
+                choices: kinds_types_js_1.chartChoices,
+            },
+            {
+                field: 'metric',
+                flag: '--metric',
+                help: 'Connector metric this series draws',
+                question: 'Which of your connector metrics does it draw?',
+                type: 'select',
+                choices: kinds_types_js_1.metricChoices,
+                empty: {
+                    what: 'This extension declares no connector metric a series can draw.',
+                    why: 'A series draws one of the metrics your connector sends, and this manifest declares none.',
+                    fix: 'Run `tappify extension add connector`, list your metrics, then add the series.',
+                },
+            },
+        ],
+        entry: context => ({
+            id: context.name,
+            label: context.title,
+            chart: (0, kinds_types_js_1.str)(context.values, 'chart'),
+            metric: (0, kinds_types_js_1.str)(context.values, 'metric'),
+        }),
+        place: (manifest, entry) => {
+            manifest.contributes.series = (0, kinds_types_js_1.push)(manifest.contributes.series, entry);
+        },
+        scopes: () => ['ui:render', 'metrics:write'],
+        template: null,
+        barrel: null,
+        next: () => 'Send the metric from your connector to see the line on the chart.',
+    },
+    {
+        command: 'banner',
+        label: 'Banner',
+        noun: 'banner',
+        singleton: false,
+        idCase: 'kebab',
+        namePrompt: 'What is the banner called?',
+        questions: [
+            kinds_types_js_1.PAGE_QUESTION,
+            {
+                field: 'event',
+                flag: '--event',
+                help: 'Webhook event of yours the banner or marker draws',
+                question: 'Which of your webhook events raises it?',
+                type: 'select',
+                choices: context => (0, exports.ownEventChoices)(context, 'banner'),
+                empty: {
+                    what: 'This extension declares no event a banner can raise.',
+                    why: 'A banner is raised by one of your own webhooks, and only a webhook you send as a banner can raise one.',
+                    fix: 'Run `tappify extension add webhook` and answer "As a banner on the page", then add the banner.',
+                },
+            },
+        ],
+        entry: context => ({
+            id: context.name,
+            page: (0, kinds_types_js_1.str)(context.values, 'page'),
+            event: (0, kinds_types_js_1.str)(context.values, 'event'),
+        }),
+        place: (manifest, entry) => {
+            manifest.contributes.banners = (0, kinds_types_js_1.push)(manifest.contributes.banners, entry);
+        },
+        scopes: () => ['ui:render', 'alerts:write'],
+        template: null,
+        barrel: null,
+        next: () => 'Send the event from your server to raise the banner.',
+    },
+];
+//# sourceMappingURL=kinds.ui.js.map

package/dist/src/domains/extension/kinds.ui.js.map

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

package/dist/src/domains/extension/labels.d.ts

@@ -0,0 +1,27 @@
+export interface Choice<T> {
+    value: T;
+    label: string;
+    hint?: string;
+}
+export declare const CATEGORY_LABELS: Record<string, string>;
+export declare const ROLE_LABELS: Record<string, string>;
+export declare const article: (noun: string) => string;
+export declare const roleLabel: (role: string) => string;
+export declare const ACTOR_LABELS: Record<string, string>;
+export declare const SLOT_LABELS: Record<string, string>;
+export declare const SLOT_HINTS: Record<string, string>;
+export declare const SIZE_CHOICES: Choice<'1x1' | '2x1' | '2x2'>[];
+export declare const VISIBILITY_LABELS: Record<string, string>;
+export declare const INSTALL_SCOPE_LABELS: Record<string, string>;
+export declare const STORAGE_SCOPE_LABELS: Record<string, string>;
+export declare const PROMPT_SURFACE_LABELS: Record<string, string>;
+export declare const KIND_LABELS: Record<string, string>;
+export declare const label: (table: Record<string, string>, key: string) => string;
+export declare const scopeLabel: (key: string) => string;
+export declare const wantsJustification: (key: string) => boolean;
+export declare const placeholderJustification: (extensionName: string, key: string) => string;
+export declare const isPlaceholderJustification: (justification: string | undefined) => boolean;
+export declare const pascalCase: (value: string) => string;
+export declare const kebabCase: (value: string) => string;
+export declare const camelCase: (value: string) => string;
+export declare const snakeCase: (value: string) => string;