@sanity/runtime-cli 17.2.0 → 17.3.0-blueprinit.gb1c5e1e

package/dist/actions/blueprints/assets.js

@@ -1,48 +1,52 @@
 import crypto from 'node:crypto';
 import fs from 'node:fs';
+import { readFile } from 'node:fs/promises';
 import AdmZip from 'adm-zip';
 import { blueprintsUrl } from '../../config.js';
 import { CONVERT_BYTES_TO_MB, MAX_ASSET_SIZE } from '../../constants.js';
 import { prepareAsset as prepareFunctionAsset } from '../../utils/functions/prepare-asset.js';
 import getHeaders from '../../utils/get-headers.js';
+import { prepareStudioAsset } from '../../utils/studios/prepare-asset.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
 import { isLocalFunctionResource, isStudioResource } from '../../utils/types.js';
 const assetsUrl = blueprintsUrl('assets');
 export const assetCheckUrl = `${assetsUrl}/check`;
 export const assetStashUrl = `${assetsUrl}/stash`;
 export async function stashAsset({ resource, auth, blueprintFileDir, logger, installer, }) {
+    let cleanup = async () => { };
     try {
         let b64;
         let hash;
         let extension;
-        let cleanup;
         if (isLocalFunctionResource(resource)) {
             const prepResult = await prepareFunctionAsset({ resource, blueprintFileDir, installer });
             if (prepResult.success === false) {
+                await prepResult.cleanup();
                 return {
                     success: false,
                     error: prepResult.error,
                 };
             }
+            cleanup = prepResult.cleanup;
             const zipResult = await pathToB64ZipHash(prepResult.outputPath);
             b64 = zipResult.b64;
             hash = zipResult.hash;
             extension = 'zip';
-            cleanup = prepResult.cleanup;
         }
         else if (isStudioResource(resource)) {
-            const prepResult = await prepareStudioAsset({ resource });
+            const prepResult = await prepareStudioAsset({ resource, blueprintFileDir });
             if (prepResult.success === false) {
+                await prepResult.cleanup();
                 return {
                     success: false,
                     error: prepResult.error,
                 };
             }
-            const buffer = await fs.promises.readFile(prepResult.outputPath);
+            cleanup = prepResult.cleanup;
+            const buffer = await readFile(prepResult.outputPath);
             b64 = buffer.toString('base64');
             hash = hashBuffer(buffer);
             extension = 'tar.gz';
-            cleanup = prepResult.cleanup;
         }
         else {
             return {
@@ -61,28 +65,15 @@ export async function stashAsset({ resource, auth, blueprintFileDir, logger, ins
         });
     }
     catch (err) {
+        try {
+            await cleanup();
+        }
+        catch {
+            // ignore clean up errors
+        }
         return { success: false, error: err instanceof Error ? err.message : `${err}` };
     }
 }
-async function prepareStudioAsset({ resource, }) {
-    if (!fs.existsSync(resource.src)) {
-        return {
-            success: false,
-            async cleanup() {
-                // no op
-            },
-            error: `Property 'src' on resource with type '${resource.type}' must be a directory`,
-        };
-    }
-    return {
-        success: true,
-        async cleanup() {
-            // no op
-        },
-        // studio must be pre built (e.g. with `npm run build`) and tarred/gzipped
-        outputPath: resource.src,
-    };
-}
 async function stashSingleAsset({ b64, hash, cleanup, resource, auth, logger, extension = 'zip', }) {
     const fetchFn = createTracedFetch(logger);
     try {

package/dist/actions/blueprints/pre-deploy.d.ts

@@ -0,0 +1,29 @@
+import type { BlueprintResource } from '@sanity/blueprints';
+import type { Logger } from '../../utils/logger.js';
+import { type AuthParams, type InstallerType, type ScopeType } from '../../utils/types.js';
+type PreDeployResult = {
+    success: false;
+    error: string;
+    code?: string;
+    exitCode?: number;
+    suggestions?: string[];
+} | {
+    success: true;
+};
+type PreDeployResourceOptions = {
+    auth: AuthParams;
+    blueprintFileDir: string;
+    installer: InstallerType;
+    log: Logger;
+};
+type PreDeployOptions = {
+    scopeType: ScopeType;
+    scopeId: string;
+    resources: BlueprintResource[];
+    stackId: string;
+    stackName: string;
+    bin: string;
+    verbose: boolean | undefined;
+} & PreDeployResourceOptions;
+export declare function preDeploy(options: PreDeployOptions): Promise<PreDeployResult>;
+export {};

package/dist/actions/blueprints/pre-deploy.js

@@ -0,0 +1,164 @@
+import { env } from 'node:process';
+import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.js';
+import { niceId } from '../../utils/display/presenters.js';
+import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
+import { styleText } from '../../utils/style-text.js';
+import { isAssetResource, } from '../../utils/types.js';
+import { stashAsset } from './assets.js';
+import { updateStack } from './stacks.js';
+import { waitForOperation } from './wait-for-operation.js';
+const DEFAULT_ASSET_TIMEOUT = 180;
+const assetTimeoutS = Number(process.env.SANITY_ASSET_TIMEOUT) || DEFAULT_ASSET_TIMEOUT;
+const assetTimeoutMs = assetTimeoutS * 1000;
+const warnTimeoutMs = assetTimeoutMs / 3;
+export async function preDeploy(options) {
+    const { resources, stackId, auth, blueprintFileDir, installer, log } = options;
+    const hasAssetResources = resources.some(isAssetResource);
+    if (hasAssetResources) {
+        let assetResources;
+        if (env.SANITY_BLUEPRINTS_PRE_DEPLOY_ENABLED === 'true') {
+            const preDeployStackResult = await preDeployStack(options);
+            if (!preDeployStackResult.success) {
+                return preDeployStackResult;
+            }
+            /** Look up resources from the back-end and attach the externalId if possible */
+            const resolvedResources = await resolveDeployedResources({
+                resources,
+                stackId,
+                auth,
+                logger: log,
+            });
+            assetResources = resolvedResources.filter(isAssetResource);
+        }
+        else {
+            assetResources = resources.filter(isAssetResource);
+        }
+        log('Processing assets...');
+        for (const resource of assetResources) {
+            const preDeployResult = await preDeployResource(resource, {
+                auth,
+                blueprintFileDir,
+                installer,
+                log,
+            });
+            if (!preDeployResult.success)
+                return preDeployResult;
+            const idx = resources.findIndex((r) => r.name === resource.name);
+            if (idx === -1)
+                throw new Error('Unable to update resource asset');
+            resources[idx] = preDeployResult.resource;
+        }
+    }
+    return { success: true };
+}
+async function preDeployStack(options) {
+    const { scopeType, scopeId, stackId, stackName, resources, auth, log, bin, verbose } = options;
+    const spinner = log.ora('Starting pre-deploy...').start();
+    const stackMutation = {
+        scopeType,
+        scopeId,
+        name: stackName,
+        preDeploy: true,
+        document: { resources },
+    };
+    const { ok: deployOk, stack, error: deployError, } = await updateStack({ stackId, stackMutation, auth, logger: log });
+    if (!deployOk) {
+        spinner.fail(`${styleText('red', 'Failed')} to complete Stack pre-deployment`);
+        return {
+            success: false,
+            error: deployError || 'Failed to complete Stack pre-deployment',
+            suggestions: [
+                `Run \`npx ${bin} blueprints plan\` to preview changes before deploying.`,
+                `Run \`npx ${bin} blueprints doctor\` to check your configuration.`,
+            ],
+        };
+    }
+    spinner.stop().clear();
+    log(styleText('dim', 'Stack deployment progress:'));
+    log('');
+    const outcome = await waitForOperation({
+        stackId,
+        operationId: stack.operationId,
+        auth,
+        log,
+        bin,
+        verbose,
+        progressNoun: 'pre-deployment',
+    });
+    if (outcome.type === 'completed') {
+        log(styleText(['bold', 'green'], 'Stack pre-deployment completed!'));
+    }
+    else if (outcome.type === 'unconfirmed') {
+        return {
+            success: false,
+            error: `Stack pre-deployment was accepted but completion could not be confirmed${outcome.error ? ` (${outcome.error})` : ''}.`,
+            code: CODE_OPERATION_UNCONFIRMED,
+            exitCode: EXIT_OPERATION_UNCONFIRMED,
+            suggestions: [
+                'The pre-deployment may or may not have finished on Sanity servers.',
+                `Run \`npx ${bin} blueprints info\` to check status.`,
+                `Run \`npx ${bin} blueprints logs --watch\` to keep streaming logs.`,
+            ],
+        };
+    }
+    else {
+        return {
+            success: false,
+            error: 'Stack pre-deployment failed',
+            suggestions: [
+                ...outcome.logHints,
+                'Review the pre-deployment output above for error details.',
+                `Run \`npx ${bin} blueprints logs --verbose\` for more context.`,
+                `Run \`npx ${bin} blueprints plan\` to identify issues with your Blueprint.`,
+            ],
+        };
+    }
+    return { success: true };
+}
+async function preDeployResource(resource, options) {
+    const { auth, blueprintFileDir, installer, log } = options;
+    const fnSpinner = log.ora({ text: `Processing ${resource.name}...`, prefixText: ' ' }).start();
+    const warnTimer = setTimeout(() => {
+        fnSpinner.text = `Still processing ${resource.name}, this can take a moment...`;
+    }, warnTimeoutMs);
+    let assetTimeoutTimer;
+    let result;
+    try {
+        result = await Promise.race([
+            stashAsset({ resource, blueprintFileDir, auth, logger: log, installer }),
+            new Promise((_, reject) => {
+                assetTimeoutTimer = setTimeout(() => {
+                    reject(new Error(`Processing ${resource.name} timed out after ${assetTimeoutS}s`));
+                }, assetTimeoutMs);
+            }),
+        ]);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        fnSpinner.fail(msg);
+        return { success: false, error: msg };
+    }
+    finally {
+        clearTimeout(warnTimer);
+        clearTimeout(assetTimeoutTimer);
+    }
+    if (result.success && result.assetId) {
+        const updatedResource = { ...resource, src: result.assetId };
+        fnSpinner.succeed(`${updatedResource.name} ${niceId(result.assetId)}`);
+        log(`   Source: ${updatedResource.src}`);
+        if (result.hash) {
+            if (result.hash.length > 24) {
+                log.verbose(`   Hash: ${result.hash.slice(0, 8)}...${result.hash.slice(-12)}`);
+            }
+            else {
+                log.verbose(`   Hash: ${result.hash}`);
+            }
+        }
+        if (result.exists)
+            log.verbose('   Asset unchanged');
+        return { success: true, resource: updatedResource };
+    }
+    const errorMsg = `Failed uploading ${resource.name} asset, deploy has stopped`;
+    fnSpinner.fail(errorMsg);
+    return { success: false, error: result.error || 'Failed to process asset' };
+}

package/dist/actions/sanity/datasets.d.ts

@@ -0,0 +1,15 @@
+import type { Logger } from '../../utils/logger.js';
+import type { ActionResponse } from '../../utils/types.js';
+export interface Dataset {
+    name: string;
+    aclMode: string;
+}
+interface ListDatasetsResponse extends ActionResponse {
+    datasets: Dataset[];
+}
+export declare function listDatasets({ token, projectId, logger, }: {
+    token: string;
+    projectId: string;
+    logger: Logger;
+}): Promise<ListDatasetsResponse>;
+export {};

package/dist/actions/sanity/datasets.js

@@ -0,0 +1,26 @@
+import { createTracedFetch } from '../../utils/traced-fetch.js';
+import { projectsApiPath } from './projects.js';
+export async function listDatasets({ token, projectId, logger, }) {
+    const fetchFn = createTracedFetch(logger);
+    const url = `${projectsApiPath}/${encodeURIComponent(projectId)}/datasets`;
+    const response = await fetchFn(url, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    const body = await response.json();
+    if (!response.ok) {
+        return {
+            ok: false,
+            error: body.error?.message ?? response.statusText,
+            datasets: [],
+        };
+    }
+    return {
+        ok: true,
+        error: null,
+        datasets: body,
+    };
+}

package/dist/commands/blueprinit.d.ts

@@ -0,0 +1,14 @@
+import { RuntimeCommand } from '../baseCommands.js';
+export default class BlueprinitCommand extends RuntimeCommand<typeof BlueprinitCommand> {
+    static hidden: boolean;
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        llms: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'organization-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<Record<string, unknown> | undefined>;
+}

package/dist/commands/blueprinit.js

@@ -0,0 +1,46 @@
+import { Flags } from '@oclif/core';
+import { llmsFlagConfig } from '@sanity-labs/oclif-plugin-skills-flag';
+import { RuntimeCommand } from '../baseCommands.js';
+import { blueprinitCore } from '../cores/blueprinit.js';
+import { Logger } from '../utils/logger.js';
+export default class BlueprinitCommand extends RuntimeCommand {
+    static hidden = true;
+    static summary = 'Experimental blueprints-first project init';
+    static description = `Scaffolds a Blueprint, Studio, and starter function around an existing Sanity project.
+
+This hidden command is an experiment; its interface and generated files are not stable.`;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --yes',
+    ];
+    static flags = {
+        llms: Flags.boolean(llmsFlagConfig),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Skip confirmation prompts',
+            default: false,
+        }),
+        'organization-id': Flags.string({
+            description: 'Organization to use when the account has several',
+            aliases: ['organization', 'organizationId', 'org'],
+        }),
+        'project-id': Flags.string({
+            description: 'Project to use when the organization has several',
+            aliases: ['project', 'projectId'],
+        }),
+    };
+    async run() {
+        const result = await blueprinitCore({
+            bin: this.config.bin,
+            log: Logger(this.log.bind(this), this.flags),
+            flags: {
+                yes: this.flags.yes,
+                organizationId: this.flags['organization-id'],
+                projectId: this.flags['project-id'],
+            },
+        });
+        if (!result.success)
+            this.coreError(result);
+        return result.json;
+    }
+}

package/dist/commands/functions/env/add.d.ts

@@ -8,6 +8,9 @@ export default class EnvAddCommand extends ResolvedCommand<typeof EnvAddCommand>
         key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
         value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     static examples: string[];
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/functions/env/add.js

@@ -1,5 +1,5 @@
-import { Args } from '@oclif/core';
-import { ResolvedCommand } from '../../../baseCommands.js';
+import { Args, Flags } from '@oclif/core';
+import { ResolvedCommand, stackFlagConfig } from '../../../baseCommands.js';
 import { functionEnvAddCore } from '../../../cores/functions/env/add.js';
 import { Logger } from '../../../utils/logger.js';
 export default class EnvAddCommand extends ResolvedCommand {
@@ -13,8 +13,12 @@ Environment variables are useful for API keys, configuration values, and other s
         key: Args.string({ description: 'The name of the environment variable', required: true }),
         value: Args.string({ description: 'The value of the environment variable', required: true }),
     };
+    static flags = {
+        stack: Flags.string({ ...stackFlagConfig }),
+    };
     static examples = [
         '<%= config.bin %> <%= command.id %> MyFunction API_URL https://api.example.com/',
+        '<%= config.bin %> <%= command.id %> --stack <name-or-id> MyFunction API_URL https://api.example.com/',
     ];
     async run() {
         const result = await functionEnvAddCore({

package/dist/commands/functions/env/list.d.ts

@@ -6,6 +6,9 @@ export default class EnvListCommand extends ResolvedCommand<typeof EnvListComman
     static args: {
         name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     static examples: string[];
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/functions/env/list.js

@@ -1,5 +1,5 @@
-import { Args } from '@oclif/core';
-import { ResolvedCommand } from '../../../baseCommands.js';
+import { Args, Flags } from '@oclif/core';
+import { ResolvedCommand, stackFlagConfig } from '../../../baseCommands.js';
 import { functionEnvListCore } from '../../../cores/functions/env/list.js';
 import { Logger } from '../../../utils/logger.js';
 export default class EnvListCommand extends ResolvedCommand {
@@ -11,7 +11,13 @@ Use 'functions env add' to set variables or 'functions env remove' to delete the
     static args = {
         name: Args.string({ description: 'The name of the Sanity Function', required: true }),
     };
-    static examples = ['<%= config.bin %> <%= command.id %> MyFunction'];
+    static flags = {
+        stack: Flags.string({ ...stackFlagConfig }),
+    };
+    static examples = [
+        '<%= config.bin %> <%= command.id %> MyFunction',
+        '<%= config.bin %> <%= command.id %> --stack <name-or-id> MyFunction',
+    ];
     async run() {
         const result = await functionEnvListCore({
             bin: this.config.bin,

package/dist/commands/functions/env/remove.d.ts

@@ -7,6 +7,9 @@ export default class EnvRemoveCommand extends ResolvedCommand<typeof EnvRemoveCo
         name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
         key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
+    static flags: {
+        stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     static examples: string[];
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/functions/env/remove.js

@@ -1,5 +1,5 @@
-import { Args } from '@oclif/core';
-import { ResolvedCommand } from '../../../baseCommands.js';
+import { Args, Flags } from '@oclif/core';
+import { ResolvedCommand, stackFlagConfig } from '../../../baseCommands.js';
 import { functionEnvRemoveCore } from '../../../cores/functions/env/remove.js';
 import { Logger } from '../../../utils/logger.js';
 export default class EnvRemoveCommand extends ResolvedCommand {
@@ -12,7 +12,13 @@ Use 'functions env list' to see current variables before removing.`;
         name: Args.string({ description: 'The name of the Sanity Function', required: true }),
         key: Args.string({ description: 'The name of the environment variable', required: true }),
     };
-    static examples = ['<%= config.bin %> <%= command.id %> MyFunction API_URL'];
+    static flags = {
+        stack: Flags.string({ ...stackFlagConfig }),
+    };
+    static examples = [
+        '<%= config.bin %> <%= command.id %> MyFunction API_URL',
+        '<%= config.bin %> <%= command.id %> --stack <name-or-id> MyFunction API_URL',
+    ];
     async run() {
         const result = await functionEnvRemoveCore({
             bin: this.config.bin,

package/dist/constants.d.ts

@@ -9,6 +9,7 @@ export declare const SANITY_PROJECT = "sanity.project";
 export declare const SANITY_PROJECT_CORS = "sanity.project.cors";
 export declare const SANITY_PROJECT_DATASET = "sanity.project.dataset";
 export declare const SANITY_PROJECT_WEBHOOK = "sanity.project.webhook";
+export declare const SANITY_STUDIO = "sanity.studio";
 export declare const EVENT_DOCUMENT_PUBLISH = "document-publish";
 export declare const EVENT_DOCUMENT_CREATE = "document-create";
 export declare const EVENT_DOCUMENT_UPDATE = "document-update";

package/dist/constants.js

@@ -9,6 +9,7 @@ export const SANITY_PROJECT = 'sanity.project';
 export const SANITY_PROJECT_CORS = 'sanity.project.cors';
 export const SANITY_PROJECT_DATASET = 'sanity.project.dataset';
 export const SANITY_PROJECT_WEBHOOK = 'sanity.project.webhook';
+export const SANITY_STUDIO = 'sanity.studio';
 export const EVENT_DOCUMENT_PUBLISH = 'document-publish';
 export const EVENT_DOCUMENT_CREATE = 'document-create';
 export const EVENT_DOCUMENT_UPDATE = 'document-update';

package/dist/cores/blueprinit/adopt.d.ts

@@ -0,0 +1,6 @@
+import type { DetectedStudio } from '../../actions/blueprinit/studio.js';
+import type { CoreResult } from '../index.js';
+import type { BlueprinitFlowOptions } from './types.js';
+export declare function adoptFlow(options: BlueprinitFlowOptions & {
+    studio: DetectedStudio;
+}): Promise<CoreResult>;

package/dist/cores/blueprinit/adopt.js

@@ -0,0 +1,90 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { slugify } from '../../actions/blueprinit/manifest.js';
+import { adoptWorkspace } from '../../actions/blueprinit/workspace.js';
+import { listDatasets } from '../../actions/sanity/datasets.js';
+import { groupProjectsByOrganization } from '../../actions/sanity/projects.js';
+import { check } from '../../utils/display/presenters.js';
+import { getLatestNpmVersion } from '../../utils/external/npmjs.js';
+import { isInteractive } from '../../utils/interactive.js';
+import { createStackAndFinish } from './finish.js';
+import { confirmUnlessSkipped, promptForStudioName } from './prompts.js';
+import { findProject } from './selection.js';
+export async function adoptFlow(options) {
+    const { bin, dir, flags, log, studio, token } = options;
+    if (!studio.projectId || !studio.dataset) {
+        return {
+            success: false,
+            error: `Found ${studio.configFile}, but could not read a projectId and dataset from it.`,
+            suggestions: ['Use literal projectId and dataset values in the Studio config.'],
+        };
+    }
+    if (flags.projectId && flags.projectId !== studio.projectId) {
+        return { success: false, error: `The Studio uses project "${studio.projectId}".` };
+    }
+    log(check(`Studio detected (${studio.configFile})`));
+    const grouped = await groupProjectsByOrganization({ token, logger: log });
+    if (!grouped.ok) {
+        return { success: false, error: `Could not list organizations: ${grouped.error}` };
+    }
+    const match = findProject(grouped.organizations, studio.projectId);
+    if (!match) {
+        return {
+            success: false,
+            error: `Project "${studio.projectId}" from ${studio.configFile} was not found in your account.`,
+        };
+    }
+    if (flags.organizationId && flags.organizationId !== match.organization.id) {
+        return {
+            success: false,
+            error: `Project "${studio.projectId}" belongs to organization "${match.organization.id}".`,
+        };
+    }
+    const datasets = await listDatasets({ token, projectId: match.project.id, logger: log });
+    if (!datasets.ok) {
+        return { success: false, error: `Could not list datasets: ${datasets.error}` };
+    }
+    if (!datasets.datasets.some(({ name }) => name === studio.dataset)) {
+        return {
+            success: false,
+            error: `Dataset "${studio.dataset}" was not found in project ${match.project.displayName}.`,
+        };
+    }
+    log(check(`Matches project ${match.project.displayName} (${match.project.id}), dataset ${studio.dataset}`));
+    log('');
+    const confirmed = await confirmUnlessSkipped(flags, isInteractive, 'Adopt this Studio into a Blueprint?');
+    if (!confirmed)
+        return { success: false, error: 'Initialization cancelled.' };
+    const studioName = await promptForStudioName(flags, isInteractive);
+    const stackName = slugify(match.project.displayName) || match.project.id;
+    const marker = (file) => (existsSync(join(dir, file)) ? '~' : '+');
+    log('Changes:');
+    log("  + sanity.blueprint.ts             attach project + dataset; adopt Studio at '.'");
+    log(`  + .sanity/blueprint.config.json   org scope, stack ${stackName}`);
+    log(`  ${marker('.gitignore')} .gitignore`);
+    log(`  ${marker('package.json')} package.json`);
+    log('');
+    const adoption = adoptWorkspace({
+        dir,
+        projectId: match.project.id,
+        displayName: match.project.displayName,
+        datasetName: studio.dataset,
+        stackName,
+        studioName,
+        blueprintsVersion: await getLatestNpmVersion('@sanity/blueprints', log),
+    });
+    return await createStackAndFinish({
+        ...options,
+        organizationId: match.organization.id,
+        projectId: match.project.id,
+        datasetName: studio.dataset,
+        stackName,
+        blueprintFilePath: adoption.blueprintFilePath,
+        files: adoption.files,
+        nextSteps: [
+            `  npx ${bin} blueprints plan`,
+            `  npx ${bin} blueprints deploy`,
+            `  npx ${bin} blueprints info`,
+        ],
+    });
+}

package/dist/cores/blueprinit/finish.d.ts

@@ -0,0 +1,14 @@
+import type { CoreResult } from '../index.js';
+import type { BlueprinitFlowOptions } from './types.js';
+interface FinishOptions extends BlueprinitFlowOptions {
+    organizationId: string;
+    projectId: string;
+    datasetName: string;
+    stackName: string;
+    blueprintFilePath: string;
+    files: string[];
+    nextSteps: string[];
+}
+export declare function createStackAndFinish(options: FinishOptions): Promise<CoreResult>;
+export declare function alignSteps(steps: Array<[command: string, description?: string]>): string[];
+export {};

package/dist/cores/blueprinit/finish.js

@@ -0,0 +1,36 @@
+import { writeConfigFile } from '../../actions/blueprints/config.js';
+import { createEmptyStack } from '../../actions/blueprints/stacks.js';
+import { check } from '../../utils/display/presenters.js';
+export async function createStackAndFinish(options) {
+    const stack = await createEmptyStack({
+        token: options.token,
+        scopeType: 'organization',
+        scopeId: options.organizationId,
+        name: options.stackName,
+        logger: options.log,
+    });
+    writeConfigFile(options.blueprintFilePath, {
+        organizationId: options.organizationId,
+        stackId: stack.id,
+    });
+    options.log(check(`Stack ${stack.name} created (org scope)`));
+    options.log('');
+    options.log('Next steps:');
+    for (const step of options.nextSteps)
+        options.log(step);
+    return {
+        success: true,
+        json: {
+            organizationId: options.organizationId,
+            projectId: options.projectId,
+            dataset: options.datasetName,
+            stackId: stack.id,
+            stackName: stack.name,
+            files: [...options.files, '.sanity/blueprint.config.json'],
+        },
+    };
+}
+export function alignSteps(steps) {
+    const width = Math.max(...steps.map(([command]) => command.length));
+    return steps.map(([command, description]) => description ? `  ${command.padEnd(width + 2)}${description}` : `  ${command}`);
+}