@learncard/cli 3.6.8 → 4.0.1

package/src/send.test.ts

@@ -1,321 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-import fs from 'fs/promises';
-import * as project from './project';
-import { out } from './out';
-
-import { afterEach, describe, expect, it, vi } from 'vitest';
-
-import {
-    SEND_MJS,
-    parseEnv,
-    upsertEnv,
-    toProfileId,
-    isPlaceholderRecipient,
-    invalidRecipientReason,
-    resolveRecipient,
-    RECIPIENT_PROMPT,
-    personalizeSendMjs,
-    withManagedIssuer,
-    runSend,
-} from './send';
-
-const fakePrompts = (answers: string[], interactive = true) => {
-    const asked: string[] = [];
-    return {
-        asked,
-        prompts: {
-            interactive,
-            ask: async (question: string, fallback: string) => {
-                asked.push(question);
-                return answers.shift() ?? fallback;
-            },
-            close: () => {},
-        },
-    };
-};
-
-describe('send command', () => {
-    it('ships the exact send.mjs the Quickstart docs show', () => {
-        const docsSnippet = readFileSync(
-            resolve(__dirname, '../../../docs/snippets/quickstart/send.mjs'),
-            'utf8'
-        );
-        expect(SEND_MJS).toBe(docsSnippet);
-    });
-
-    it('parses and upserts .env without touching unrelated lines', () => {
-        const original = '# comment\nOTHER=1\nSECURE_SEED=old\n';
-        expect(parseEnv(original)).toEqual({ OTHER: '1', SECURE_SEED: 'old' });
-        expect(upsertEnv(original, { SECURE_SEED: 'new', PROFILE_ID: 'acme' })).toBe(
-            '# comment\nOTHER=1\nSECURE_SEED=new\nPROFILE_ID=acme\n'
-        );
-        expect(upsertEnv('', { SECURE_SEED: 'x' })).toBe('SECURE_SEED=x\n');
-    });
-
-    it('derives a URL-safe profile id with a random suffix', () => {
-        expect(toProfileId('Acme Learning, Inc.')).toMatch(/^acme-learning-inc-[a-z0-9]{4}$/);
-        expect(toProfileId('!!!')).toMatch(/^issuer-[a-z0-9]{4}$/);
-        expect(toProfileId('x'.repeat(60)).length).toBeLessThanOrEqual(40);
-    });
-});
-
-describe('recipient validation', () => {
-    it('flags RFC 2606 / 6761 placeholder domains but not real ones', () => {
-        expect(isPlaceholderRecipient('you@example.com')).toBe(true);
-        expect(isPlaceholderRecipient('YOU@EXAMPLE.ORG')).toBe(true);
-        expect(isPlaceholderRecipient('a@sub.example.net')).toBe(true);
-        expect(isPlaceholderRecipient('a@foo.test')).toBe(true);
-        expect(isPlaceholderRecipient('a@host.invalid')).toBe(true);
-        expect(isPlaceholderRecipient('a@localhost')).toBe(true);
-        expect(isPlaceholderRecipient('a@test')).toBe(true);
-        expect(isPlaceholderRecipient('a@contest.com')).toBe(false);
-        expect(isPlaceholderRecipient('a@latest.io')).toBe(false);
-        expect(isPlaceholderRecipient('a@test.com')).toBe(false);
-        expect(isPlaceholderRecipient('a@myexample.com')).toBe(false);
-        expect(isPlaceholderRecipient('a@example.co.uk')).toBe(false);
-        expect(isPlaceholderRecipient('+15555550100')).toBe(false);
-    });
-
-    it('explains why a recipient is unusable', () => {
-        expect(invalidRecipientReason('you@example.com')).toMatch(/placeholder/);
-        expect(invalidRecipientReason('Not A Recipient!')).toMatch(/not an email/);
-        expect(invalidRecipientReason('')).toBe(
-            'Enter an email, phone number, profile ID, or DID.'
-        );
-        expect(invalidRecipientReason('me@acme.org')).toBeUndefined();
-        expect(invalidRecipientReason('+15555550100')).toBeUndefined();
-        expect(invalidRecipientReason('cs-exampleville')).toBeUndefined();
-        expect(invalidRecipientReason('did:web:network.learncard.com:users:exde')).toBeUndefined();
-    });
-
-    it('accepts a valid recipient without prompting', async () => {
-        const { prompts, asked } = fakePrompts([]);
-        expect(await resolveRecipient(' me@acme.org ', prompts)).toBe('me@acme.org');
-        expect(asked).toEqual([]);
-    });
-
-    it('prompts when the recipient is omitted', async () => {
-        const { prompts, asked } = fakePrompts(['me@acme.org']);
-        expect(await resolveRecipient(undefined, prompts)).toBe('me@acme.org');
-        expect(asked).toEqual([RECIPIENT_PROMPT]);
-    });
-
-    it('re-prompts interactively until a placeholder is replaced', async () => {
-        const { prompts, asked } = fakePrompts(['not a recipient', 'me@acme.org']);
-        expect(await resolveRecipient('you@example.com', prompts)).toBe('me@acme.org');
-        expect(asked).toEqual([RECIPIENT_PROMPT, RECIPIENT_PROMPT]);
-    });
-
-    it('re-prompts with a hint when Enter is pressed on an empty line', async () => {
-        const { prompts, asked } = fakePrompts(['', '  ', 'me@acme.org']);
-        expect(await resolveRecipient(undefined, prompts)).toBe('me@acme.org');
-        expect(asked).toHaveLength(3);
-    });
-
-    it('fails fast on a missing recipient when non-interactive', async () => {
-        const { prompts, asked } = fakePrompts(['me@acme.org'], false);
-        await expect(resolveRecipient(undefined, prompts)).rejects.toThrow(/recipient is required/);
-        expect(asked).toEqual([]);
-    });
-
-    it('fails fast on a placeholder when non-interactive', async () => {
-        const { prompts, asked } = fakePrompts(['me@acme.org'], false);
-        await expect(resolveRecipient('you@example.com', prompts)).rejects.toThrow(
-            /placeholder address/
-        );
-        expect(asked).toEqual([]);
-    });
-});
-
-describe('personalizeSendMjs', () => {
-    const managedDid = 'did:web:network.learncard.com:users:managed';
-    const script = withManagedIssuer(
-        personalizeSendMjs('Parent', {
-            name: 'Managed badge',
-            description: 'Sent as managed.',
-        }),
-        managedDid
-    );
-    const execute = (env: Record<string, string>, initLearnCard: ReturnType<typeof vi.fn>) => {
-        const body = script
-            .split('\n')
-            .filter(line => !line.startsWith('import '))
-            .join('\n');
-        return new Function(
-            'initLearnCard',
-            'process',
-            'randomUUID',
-            'console',
-            `return (async () => {${body}})();`
-        )(initLearnCard, { env, argv: ['node', 'send.mjs', 'me@acme.org'] }, () => 'uuid', {
-            log: vi.fn(),
-        });
-    };
-
-    it('re-runs the managed script with didWeb and issues as that profile', async () => {
-        const card = {
-            id: { did: () => managedDid },
-            invoke: {
-                getProfile: vi.fn().mockResolvedValue({ profileId: 'managed' }),
-                issueCredential: vi.fn().mockResolvedValue({ proof: {} }),
-                send: vi.fn().mockResolvedValue({ uri: 'boost-uri' }),
-            },
-        };
-        const initLearnCard = vi.fn().mockResolvedValue(card);
-        await execute({ SECURE_SEED: 'parent-seed', MANAGED_DID: managedDid }, initLearnCard);
-        expect(initLearnCard).toHaveBeenCalledWith({
-            seed: 'parent-seed',
-            network: true,
-            didWeb: managedDid,
-        });
-        expect(card.invoke.issueCredential).toHaveBeenCalledWith(
-            expect.objectContaining({ issuer: managedDid })
-        );
-        expect(script).not.toContain('createProfile');
-    });
-
-    it.each([undefined, 'did:web:other:users:another'])(
-        'fails closed for MANAGED_DID=%s',
-        async did => {
-            const initLearnCard = vi.fn();
-            await expect(execute(did ? { MANAGED_DID: did } : {}, initLearnCard)).rejects.toThrow(
-                'MANAGED_DID is missing or changed'
-            );
-            expect(initLearnCard).not.toHaveBeenCalled();
-        }
-    );
-
-    it('does not create a parent profile when the managed profile is missing', async () => {
-        const initLearnCard = vi
-            .fn()
-            .mockResolvedValue({ invoke: { getProfile: vi.fn().mockResolvedValue(null) } });
-        await expect(execute({ MANAGED_DID: managedDid }, initLearnCard)).rejects.toThrow(
-            'managed issuer profile could not be found'
-        );
-    });
-
-    it('substitutes the display name, badge name, and description', async () => {
-        const { personalizeSendMjs } = await import('./send');
-        const out = personalizeSendMjs('Acme Learning', {
-            name: 'Welcome to Acme',
-            description: 'You joined.',
-        });
-        expect(out).toContain('displayName: "Acme Learning"');
-        expect(out).toContain('name: "Welcome to Acme"');
-        expect(out).not.toContain('Quickstart Complete');
-        expect(out).toContain('description: "You joined."');
-    });
-});
-
-describe('classifyRecipient', () => {
-    it('detects each recipient kind the network routes on', async () => {
-        const { classifyRecipient } = await import('./send');
-        expect(classifyRecipient('you@example.com')).toBe('email');
-        expect(classifyRecipient('+15555550123')).toBe('phone');
-        expect(classifyRecipient('did:web:network.learncard.com:users:exde')).toBe('did');
-        expect(classifyRecipient('cs-exampleville')).toBe('profileId');
-    });
-
-    it('rejects anything else with an example', async () => {
-        const { classifyRecipient } = await import('./send');
-        expect(() => classifyRecipient('Not A Recipient!')).toThrow(/profile ID, or DID/);
-    });
-});
-
-describe('send --as script generation', () => {
-    afterEach(() => vi.restoreAllMocks());
-
-    it.each([false, true])(
-        'preserves the managed issuer with existing script=%s',
-        async existing => {
-            const managedDid = 'did:web:staging.network.learncard.com:users:managed';
-            const loaded = {
-                env: { SECURE_SEED: 'seed', PROFILE_ID: 'parent' },
-                envPath: '/unused/.env',
-                existing: '',
-            };
-            vi.spyOn(project, 'loadProject').mockResolvedValue(loaded);
-            vi.spyOn(project, 'createPrompts').mockReturnValue(fakePrompts([], false).prompts);
-            vi.spyOn(project, 'ensureIdentity').mockResolvedValue({
-                seed: 'seed',
-                profileId: 'parent',
-                displayName: 'Parent',
-            });
-            const card = {
-                id: { did: () => managedDid },
-                invoke: {
-                    getProfile: vi
-                        .fn()
-                        .mockResolvedValue({ profileId: 'managed', displayName: 'Managed' }),
-                    issueCredential: vi.fn().mockResolvedValue({}),
-                    send: vi.fn().mockResolvedValue({ uri: 'boost-uri', activityId: 'activity-1' }),
-                },
-            };
-            vi.spyOn(project, 'connectAsManaged').mockResolvedValue(
-                card as unknown as Awaited<ReturnType<typeof project.connectAsManaged>>
-            );
-            const save = vi.spyOn(project, 'saveProject').mockResolvedValue();
-            const stat = vi.spyOn(fs, 'stat');
-            if (existing) stat.mockResolvedValue({} as Awaited<ReturnType<typeof fs.stat>>);
-            else stat.mockRejectedValue(new Error('ENOENT'));
-            const write = vi.spyOn(fs, 'writeFile').mockResolvedValue();
-            const log = vi.spyOn(out, 'log').mockImplementation(() => {});
-            const set = vi.spyOn(out, 'set').mockImplementation(patch => patch);
-
-            await runSend('me@acme.org', { as: 'managed', yes: true, network: 'staging' });
-
-            if (existing) {
-                expect(save).not.toHaveBeenCalled();
-                expect(write).not.toHaveBeenCalled();
-                expect(log).toHaveBeenCalledWith(
-                    expect.stringContaining('may use a different issuer')
-                );
-                expect(set).toHaveBeenCalledWith(expect.objectContaining({ files: [] }));
-            } else {
-                expect(save).toHaveBeenCalledWith(loaded, { MANAGED_DID: managedDid });
-                expect(write).toHaveBeenCalledWith(
-                    expect.stringContaining('send.mjs'),
-                    expect.stringContaining('didWeb: process.env.MANAGED_DID')
-                );
-                expect(save.mock.invocationCallOrder[0]).toBeLessThan(
-                    write.mock.invocationCallOrder[0]!
-                );
-                expect(set).toHaveBeenCalledWith(
-                    expect.objectContaining({ files: ['./send.mjs'] })
-                );
-                const generated = String(write.mock.calls[0]?.[1]);
-                const body = generated
-                    .split('\n')
-                    .filter(line => !line.startsWith('import '))
-                    .join('\n');
-                const initLearnCard = vi.fn().mockResolvedValue(card);
-                card.invoke.issueCredential.mockClear();
-                await new Function(
-                    'initLearnCard',
-                    'process',
-                    'randomUUID',
-                    'console',
-                    `return (async () => {${body}})();`
-                )(
-                    initLearnCard,
-                    {
-                        env: { SECURE_SEED: 'seed', MANAGED_DID: managedDid },
-                        argv: ['node', 'send.mjs', 'me@acme.org'],
-                    },
-                    () => 'uuid',
-                    { log: vi.fn() }
-                );
-                expect(initLearnCard).toHaveBeenCalledWith({
-                    seed: 'seed',
-                    network: project.STAGING_NETWORK,
-                    cloud: { url: 'https://staging.cloud.learncard.com/trpc' },
-                    didWeb: managedDid,
-                });
-                expect(card.invoke.issueCredential).toHaveBeenCalledWith(
-                    expect.objectContaining({ issuer: managedDid })
-                );
-            }
-        }
-    );
-});

package/src/send.ts

@@ -1,373 +0,0 @@
-import fs from 'fs/promises';
-import path from 'path';
-import { randomUUID } from 'node:crypto';
-import {
-    connect,
-    connectAsManaged,
-    createPrompts,
-    ensureIdentity,
-    ensureProfile,
-    loadProject,
-    saveProject,
-    type ProjectOptions,
-    localizeSnippet,
-    resolveServices,
-} from './project';
-import { setupSigning } from './setup-signing';
-import { SEND_MJS, SEND_FROM_TEMPLATE_MJS } from './generated/snippets';
-import { out } from './out';
-
-export { SEND_MJS } from './generated/snippets';
-export { parseEnv, upsertEnv, toProfileId } from './project';
-export type SendEnv = { SECURE_SEED?: string; PROFILE_ID?: string };
-export type Badge = { name: string; description: string };
-export const DEFAULT_BADGE: Badge = {
-    name: 'Quickstart Complete',
-    description: 'Sent a verifiable credential with LearnCard.',
-};
-
-export const quickstartCredential = (issuerDid: string, badge: Badge = DEFAULT_BADGE) => ({
-    '@context': [
-        'https://www.w3.org/ns/credentials/v2',
-        'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json',
-    ],
-    type: ['VerifiableCredential', 'OpenBadgeCredential'],
-    issuer: issuerDid,
-    validFrom: new Date().toISOString(),
-    name: badge.name,
-    credentialSubject: {
-        type: ['AchievementSubject'],
-        achievement: {
-            id: `urn:uuid:${randomUUID()}`,
-            type: ['Achievement'],
-            name: badge.name,
-            description: badge.description,
-            criteria: { narrative: 'Ran the LearnCard quickstart.' },
-        },
-    },
-});
-
-export const templateCredential = (issuerDid: string, badge: Badge = DEFAULT_BADGE) => {
-    const credential = quickstartCredential(issuerDid, badge);
-    credential['@context'].push('https://ctx.learncard.com/boosts/1.0.1.json');
-    credential.type.push('BoostCredential');
-    return credential;
-};
-
-type SendOptions = ProjectOptions & {
-    as?: string;
-    badge?: string;
-    description?: string;
-    template?: boolean;
-    templateUri?: string;
-    webhookUrl?: string;
-    suppressDelivery?: boolean;
-    guardianEmail?: string;
-};
-
-type SendDeliveryOptions = {
-    webhookUrl?: string;
-    suppressDelivery?: boolean;
-    guardianEmail?: string;
-};
-
-const sendOptions = (options: SendOptions): { options?: SendDeliveryOptions } => {
-    const picked: SendDeliveryOptions = {
-        webhookUrl: options.webhookUrl,
-        suppressDelivery: options.suppressDelivery,
-        guardianEmail: options.guardianEmail,
-    };
-    return Object.values(picked).some(v => v !== undefined) ? { options: picked } : {};
-};
-
-/** Inserts the effective send() delivery options right after `anchor` so a re-run of the
- *  generated script reproduces the same call. */
-const withDeliveryOptions = (
-    content: string,
-    anchor: string,
-    deliveryOptions?: SendDeliveryOptions
-): string =>
-    deliveryOptions
-        ? content.replace(
-              anchor,
-              () => `${anchor}\n    options: ${JSON.stringify(deliveryOptions)},`
-          )
-        : content;
-
-/** Substitute the user's choices into the template that the docs snippet uses. */
-export const personalizeSendMjs = (
-    displayName: string,
-    badge: Badge,
-    deliveryOptions?: SendDeliveryOptions
-): string =>
-    withDeliveryOptions(
-        SEND_MJS.replace(
-            "displayName: 'My Organization'",
-            () => `displayName: ${JSON.stringify(displayName)}`
-        )
-            .split("'Quickstart Complete'")
-            .join(JSON.stringify(badge.name))
-            .replace("'Sent a verifiable credential with LearnCard.'", () =>
-                JSON.stringify(badge.description)
-            ),
-        '    signedCredential: credential,',
-        deliveryOptions
-    );
-
-/** Substitute the effective send() delivery options into the from-template script. */
-export const personalizeSendFromTemplateMjs = (deliveryOptions?: SendDeliveryOptions): string =>
-    withDeliveryOptions(
-        SEND_FROM_TEMPLATE_MJS,
-        '    templateUri: process.env.TEMPLATE_URI,',
-        deliveryOptions
-    );
-
-/** Bind a generated script to its managed issuer, never the parent seed identity. */
-export const withManagedIssuer = (content: string, managedDid: string): string =>
-    content
-        .replace(
-            'const learnCard = await initLearnCard(',
-            `if (process.env.MANAGED_DID !== ${JSON.stringify(managedDid)}) {
-    throw new Error('MANAGED_DID is missing or changed. Re-run the CLI with --as to send as the intended profile.');
-}
-const learnCard = await initLearnCard(`
-        )
-        .replace(
-            'seed: process.env.SECURE_SEED,',
-            'seed: process.env.SECURE_SEED, didWeb: process.env.MANAGED_DID,'
-        )
-        .replace(
-            /if \(!\(await learnCard\.invoke\.getProfile\(\)\)\) \{[\s\S]*?\n\}/,
-            `if (!(await learnCard.invoke.getProfile())) {
-    throw new Error('The managed issuer profile could not be found.');
-}`
-        );
-
-const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-const PHONE = /^\+?\d{10,15}$/;
-const DID = /^did:[a-z0-9]+:.+$/;
-const PROFILE_ID = /^[a-z0-9-]{3,40}$/;
-
-export type RecipientKind = 'email' | 'phone' | 'did' | 'profileId';
-
-export const classifyRecipient = (value: string): RecipientKind => {
-    if (EMAIL.test(value)) return 'email';
-    if (PHONE.test(value)) return 'phone';
-    if (DID.test(value)) return 'did';
-    if (PROFILE_ID.test(value)) return 'profileId';
-    throw new Error(
-        `"${value}" is not an email, phone number, profile ID, or DID. Example: npx @learncard/cli send you@yourdomain.com`
-    );
-};
-
-/** Domains reserved for documentation (RFC 2606 / RFC 6761). Mail to them goes nowhere. */
-const PLACEHOLDER_DOMAIN = /(^|\.)example\.(com|net|org)$|(^|\.)(example|test|invalid|localhost)$/i;
-
-export const RECIPIENT_PROMPT =
-    'Where should we send your first badge? (email, phone number, profile ID, or DID)';
-
-export const isPlaceholderRecipient = (recipient: string): boolean => {
-    const at = recipient.lastIndexOf('@');
-    return at !== -1 && PLACEHOLDER_DOMAIN.test(recipient.slice(at + 1));
-};
-
-/**
- * Returns a human-readable reason `recipient` cannot receive a badge, or `undefined` if it can.
- * Placeholder addresses like you@example.com pass a naive email check but are undeliverable,
- * so they are called out specifically — docs readers paste them verbatim.
- */
-export const invalidRecipientReason = (recipient: string): string | undefined => {
-    if (!recipient) return 'Enter an email, phone number, profile ID, or DID.';
-    if (EMAIL.test(recipient) && isPlaceholderRecipient(recipient))
-        return `"${recipient}" is a placeholder address — nobody will receive the badge. Use a real email you can open.`;
-    if (
-        !EMAIL.test(recipient) &&
-        !PHONE.test(recipient) &&
-        !DID.test(recipient) &&
-        !PROFILE_ID.test(recipient)
-    )
-        return `"${recipient}" is not an email, phone number, profile ID, or DID.`;
-    return undefined;
-};
-
-type Prompts = ReturnType<typeof createPrompts>;
-
-/**
- * Settle on a deliverable recipient. When a human is at the terminal, bad or missing input
- * re-prompts instead of failing; non-interactive runs throw a clear error.
- */
-export const resolveRecipient = async (
-    recipient: string | undefined,
-    prompts: Prompts
-): Promise<string> => {
-    let candidate = recipient?.trim() ?? '';
-    if (!candidate && !prompts.interactive)
-        throw new Error(
-            'A recipient is required when running non-interactively. Example: npx @learncard/cli send you@yourdomain.com --yes'
-        );
-    if (!candidate) candidate = (await prompts.ask(RECIPIENT_PROMPT, '')).trim();
-    let reason = invalidRecipientReason(candidate);
-    while (reason) {
-        if (!prompts.interactive)
-            throw new Error(`${reason} Example: npx @learncard/cli send you@yourdomain.com`);
-        out.log(reason);
-        candidate = (await prompts.ask(RECIPIENT_PROMPT, '')).trim();
-        reason = invalidRecipientReason(candidate);
-    }
-    return candidate;
-};
-
-export const runSend = async (
-    recipient: string | undefined,
-    options: SendOptions
-): Promise<void> => {
-    const cwd = process.cwd();
-    const project = await loadProject(cwd);
-    const prompts = createPrompts(options.yes);
-    let resolvedRecipient: string;
-    let displayName: string | undefined;
-    let badge: Badge;
-    try {
-        resolvedRecipient = await resolveRecipient(recipient, prompts);
-        const needsName = !project.env.PROFILE_ID && !options.profileId && !options.name;
-        displayName = needsName
-            ? await prompts.ask('Display name for your issuer profile', 'My Organization')
-            : options.name;
-        badge = {
-            name: options.badge ?? (await prompts.ask('Badge name', DEFAULT_BADGE.name)),
-            description: options.description ?? DEFAULT_BADGE.description,
-        };
-    } finally {
-        prompts.close();
-    }
-    const recipientKind = classifyRecipient(resolvedRecipient);
-    const identity = await ensureIdentity(project, { ...options, name: displayName, yes: true });
-    const asManaged = options.as ? await connectAsManaged(project, options, options.as) : undefined;
-    const hostedSigning = !!project.env.SIGNING_AUTHORITY_NAME;
-    const explicitTemplate = options.templateUri ? true : options.template;
-    const useTemplate = !asManaged && (explicitTemplate ?? hostedSigning);
-    if (useTemplate && explicitTemplate === undefined) {
-        out.log(
-            `Signing through the registered signing authority "${project.env.SIGNING_AUTHORITY_NAME}" (pass --no-template to sign with the local key instead).`
-        );
-    }
-    if (asManaged && explicitTemplate) {
-        out.log("--as signs with the managed profile's key; --template is ignored.");
-    }
-    const learnCard = asManaged
-        ? asManaged
-        : useTemplate
-          ? await connect(project, { ...options, lca: true })
-          : await connect(project, options);
-    if (asManaged) {
-        const managed = await learnCard.invoke.getProfile();
-        if (!managed) throw new Error(`Could not sign in as managed profile "${options.as}".`);
-        out.log(
-            `Acting as "${managed.displayName}" (${managed.profileId}) — a profile you manage.`
-        );
-    } else {
-        await ensureProfile(learnCard, identity, project);
-    }
-
-    const effectiveSendOptions = sendOptions(options);
-    let result;
-    if (useTemplate) {
-        // This branch connected with the LCA plugin; setupSigning accepts its required methods.
-        await setupSigning(
-            project,
-            learnCard as Awaited<
-                ReturnType<typeof import('@learncard/lca-api-plugin').initLCALearnCard>
-            >
-        );
-        if (options.templateUri) {
-            out.log(`Sending from template ${options.templateUri}.`);
-            if (!project.env.TEMPLATE_URI) {
-                await saveProject(project, { TEMPLATE_URI: options.templateUri });
-            }
-        } else if (!project.env.TEMPLATE_URI) {
-            const uri = await learnCard.invoke.createBoost(
-                templateCredential(learnCard.id.did(), badge),
-                {
-                    name: badge.name,
-                    category: 'Achievement',
-                    status: 'LIVE',
-                }
-            );
-            await saveProject(project, { TEMPLATE_URI: uri });
-        } else {
-            out.log(
-                `Reusing template ${project.env.TEMPLATE_URI}; its saved badge name and description are unchanged.`
-            );
-        }
-        result = await learnCard.invoke.send({
-            type: 'boost',
-            recipient: resolvedRecipient,
-            templateUri: options.templateUri ?? project.env.TEMPLATE_URI!,
-            ...effectiveSendOptions,
-        });
-    } else {
-        const credential = await learnCard.invoke.issueCredential(
-            quickstartCredential(learnCard.id.did(), badge)
-        );
-        result = await learnCard.invoke.send({
-            type: 'boost',
-            recipient: resolvedRecipient,
-            signedCredential: credential,
-            ...effectiveSendOptions,
-        });
-    }
-    out.log('');
-    if (result.inbox?.status === 'PENDING') {
-        out.log(
-            `Sent. ${resolvedRecipient} will get a claim ${recipientKind === 'phone' ? 'text' : 'email'}. You can also share this link directly:\n${result.inbox.claimUrl}`
-        );
-    } else if (recipientKind === 'email' || recipientKind === 'phone') {
-        out.log(
-            `Delivered. ${resolvedRecipient} already uses LearnCard — the credential is in their wallet.`
-        );
-    } else {
-        out.log(
-            `Delivered directly to ${resolvedRecipient} — it is waiting in their LearnCard wallet.`
-        );
-    }
-    out.log(`Reusable template for this badge: ${result.uri}`);
-    const filename = useTemplate ? 'send-from-template.mjs' : 'send.mjs';
-    const sendPath = path.join(cwd, filename);
-    let wroteSendFile = false;
-    if (!(await fs.stat(sendPath).catch(() => null))) {
-        let content = useTemplate
-            ? personalizeSendFromTemplateMjs(effectiveSendOptions.options)
-            : personalizeSendMjs(identity.displayName, badge, effectiveSendOptions.options);
-        content = localizeSnippet(content, resolveServices(project.env, options.network));
-        if (asManaged) {
-            const managedDid = learnCard.id.did();
-            await saveProject(project, { MANAGED_DID: managedDid });
-            content = withManagedIssuer(content, managedDid);
-        }
-        await fs.writeFile(sendPath, content);
-        wroteSendFile = true;
-        out.log(
-            `\nThe code that just ran is in ./${filename} — run it yourself:\n  npm install @learncard/init\n  node --env-file=.env ${filename} ${resolvedRecipient}`
-        );
-    } else if (asManaged) {
-        out.log(
-            `Existing ./${filename} was not changed and may use a different issuer. Repeat this send with the CLI --as ${options.as} instead.`
-        );
-    }
-    out.log(`Check whether it was claimed: npx @learncard/cli status ${result.activityId}`);
-    out.log(`See it in the app: npx @learncard/cli open${options.template ? ' template' : ''}`);
-    out.set({
-        profileId: options.as ?? identity.profileId,
-        ...(options.as && { onBehalfOf: identity.profileId }),
-        did: learnCard.id.did(),
-        recipient: resolvedRecipient,
-        recipientKind,
-        status: result.inbox?.status === 'PENDING' ? 'PENDING' : 'ISSUED',
-        ...(result.inbox?.claimUrl && { claimUrl: result.inbox.claimUrl }),
-        templateUri: result.uri,
-        activityId: result.activityId,
-        ...(result.credentialUri && { credentialUri: result.credentialUri }),
-        ...(result.inbox?.issuanceId && { issuanceId: result.inbox.issuanceId }),
-        files: wroteSendFile ? [`./${filename}`] : [],
-    });
-};