@sitecoreai-labs/sitecoreai-cli 0.0.4 → 0.1.0

package/dist/recipe/api/authoring-client.js

@@ -155,6 +155,30 @@ mutation($input: DeleteItemInput!) {
     successful
   }
 }`;
+const ADD_ITEM_VERSION_MUTATION = `
+mutation($input: AddItemVersionInput!) {
+  addItemVersion(input: $input) {
+    item {
+      version
+    }
+  }
+}`;
+const GET_ITEM_VERSIONS_BY_ID = `
+query($itemId: ID!, $language: String!) {
+  item(where: { itemId: $itemId, language: $language }) {
+    versions {
+      version
+    }
+  }
+}`;
+const GET_ITEM_VERSIONS_BY_PATH = `
+query($path: String!, $language: String!) {
+  item(where: { path: $path, language: $language }) {
+    versions {
+      version
+    }
+  }
+}`;
 const toRemoteItem = (node) => ({
     itemId: node.itemId,
     name: node.name,
@@ -201,14 +225,23 @@ const createAuthoringClient = (options) => {
         retry: { ...request?.retry, retryableStatuses: graphql_1.READ_RETRYABLE_STATUSES },
     };
     /**
-     * Per-call request options for write operations — uses the conservative
-     * default retry set (just throttle / never-reached-origin codes:
-     * 408/425/429/503). A 500/502/504 may indicate the server processed
-     * the request but failed to respond; retrying would create a duplicate
-     * with no idempotency key. The recipe rollback flow recovers from
-     * partial-write states by replay, not by silent retries.
+     * Per-call request options for write operations — hard-disables retries
+     * (maxAttempts: 1). The Authoring GraphQL endpoint has no idempotency-key
+     * mechanism, so ANY retry on a write is a duplicate-mutation risk: 408,
+     * 425, 429 and 503 can all be returned AFTER the upstream applied the
+     * mutation, leading the retry to silently double-apply (especially on
+     * updateItem, where the "already exists" suppression in createItem doesn't
+     * help). The recipe rollback flow recovers from partial-write states by
+     * replay, not by silent retries — so making writes fail fast on first
+     * error is what the rollback layer actually expects.
+     *
+     * If 429 throttling becomes a real operational issue, add an
+     * `Idempotency-Key` header on writes BEFORE re-enabling retries here.
      */
-    const writeRequest = request ?? {};
+    const writeRequest = {
+        ...(request ?? {}),
+        retry: { maxAttempts: 1 },
+    };
     const fetchOne = async (selector) => {
         if (selector.itemId) {
             const data = await (0, graphql_2.runAuthoringGraphQL)(environment, GET_ITEM_BY_ID, { itemId: selector.itemId }, readRequest);
@@ -218,7 +251,7 @@ const createAuthoringClient = (options) => {
             const data = await (0, graphql_2.runAuthoringGraphQL)(environment, GET_ITEM_BY_PATH, { path: selector.path }, readRequest);
             return data.item;
         }
-        throw (0, errors_1.createCliError)("ItemSelector requires either path or itemId.", "INPUT_INVALID");
+        throw (0, errors_1.createScaiError)("ItemSelector requires either path or itemId.", "INPUT_INVALID");
     };
     /**
      * Batched path→item read using GraphQL aliased fields. One POST returns
@@ -261,7 +294,7 @@ const createAuthoringClient = (options) => {
             const data = await (0, graphql_2.runAuthoringGraphQL)(environment, GET_CHILDREN_BY_PATH, { path: selector.path }, readRequest);
             return data.item?.children.nodes ?? [];
         }
-        throw (0, errors_1.createCliError)("ItemSelector requires either path or itemId.", "INPUT_INVALID");
+        throw (0, errors_1.createScaiError)("ItemSelector requires either path or itemId.", "INPUT_INVALID");
     };
     /**
      * Walk the content-tree path bottom-up, returning the itemId of `path`.
@@ -291,12 +324,12 @@ const createAuthoringClient = (options) => {
         }
         const lastSlash = path.lastIndexOf("/");
         if (lastSlash <= 0) {
-            throw (0, errors_1.createCliError)(`Cannot auto-create root path '${path}'. The Sitecore root must already exist on the tenant.`, "INPUT_INVALID");
+            throw (0, errors_1.createScaiError)(`Cannot auto-create root path '${path}'. The Sitecore root must already exist on the tenant.`, "INPUT_INVALID");
         }
         const parentPath = path.slice(0, lastSlash);
         const name = path.slice(lastSlash + 1);
         if (!name) {
-            throw (0, errors_1.createCliError)(`Path '${rawPath}' has no leaf segment to create.`, "INPUT_INVALID");
+            throw (0, errors_1.createScaiError)(`Path '${rawPath}' has no leaf segment to create.`, "INPUT_INVALID");
         }
         const parentItemId = await ensurePathExists(parentPath);
         const templateId = folderTemplateForPath(path);
@@ -312,14 +345,14 @@ const createAuthoringClient = (options) => {
         }, writeRequest);
         const itemId = data.createItem?.item?.itemId;
         if (!itemId) {
-            throw (0, errors_1.createCliError)(`Auto-provisioning failed: Authoring API returned no itemId after creating folder '${path}'.`, "UNKNOWN");
+            throw (0, errors_1.createScaiError)(`Auto-provisioning failed: Authoring API returned no itemId after creating folder '${path}'.`, "UNKNOWN");
         }
         pathItemIdCache?.set(path, itemId);
         return itemId;
     };
     /**
      * Detect Sitecore's name-conflict error class. Authoring GraphQL
-     * surfaces these as wrapped CliError messages of the form:
+     * surfaces these as wrapped ScaiError messages of the form:
      *
      *   `Authoring GraphQL errors: The item name "X" is already defined on this level.`
      *
@@ -362,7 +395,7 @@ const createAuthoringClient = (options) => {
             return trimmed.replace(/[{}]/g, "");
         if (trimmed.startsWith("/"))
             return ensurePathExists(trimmed);
-        throw (0, errors_1.createCliError)(`createItem.input.parent must be a Sitecore itemId or content-tree path; got: '${trimmed}'.`, "INPUT_INVALID");
+        throw (0, errors_1.createScaiError)(`createItem.input.parent must be a Sitecore itemId or content-tree path; got: '${trimmed}'.`, "INPUT_INVALID");
     };
     return {
         async getItem(selector, _options) {
@@ -424,6 +457,28 @@ const createAuthoringClient = (options) => {
         },
         async createItem(input) {
             const parentItemId = await resolveParentItemId(input.parent);
+            // Optional pre-create idempotency check. The planner reads
+            // existence via `getItem({path})`, which hits Sitecore's path
+            // index — that index lags writes by seconds-to-minutes. On a
+            // rapid second push, the planner can see "missing" and plan a
+            // create against a path the tenant actually already has.
+            // Parent-child storage is not lag-prone, so `findChildByName`
+            // here is authoritative: if the sibling exists, return its
+            // itemId without ever calling the mutation. Catches the case
+            // where Sitecore's create-mutation does NOT reject the duplicate
+            // (observed in the field — `audit slug-conflicts` kept catching
+            // duplicates that should have been upserts on rapid re-push).
+            //
+            // Opt-in via `idempotencyCheck: true` because it adds one
+            // parent-children read per CreateItem op — recipe push opts in
+            // (idempotency is the whole point), one-shot callers that
+            // explicitly asked to create skip the check.
+            if (input.idempotencyCheck) {
+                const preExisting = await findChildByName(parentItemId, input.name);
+                if (preExisting) {
+                    return { itemId: preExisting.itemId };
+                }
+            }
             try {
                 const data = await (0, graphql_2.runAuthoringGraphQL)(environment, CREATE_ITEM_MUTATION, {
                     input: {
@@ -437,7 +492,7 @@ const createAuthoringClient = (options) => {
                 }, writeRequest);
                 const itemId = data.createItem?.item?.itemId;
                 if (!itemId) {
-                    throw (0, errors_1.createCliError)("createItem returned no itemId — Authoring API response was malformed.", "UNKNOWN");
+                    throw (0, errors_1.createScaiError)("createItem returned no itemId — Authoring API response was malformed.", "UNKNOWN");
                 }
                 return { itemId };
             }
@@ -470,6 +525,11 @@ const createAuthoringClient = (options) => {
             await (0, graphql_2.runAuthoringGraphQL)(environment, UPDATE_ITEM_MUTATION, {
                 input: {
                     itemId: input.itemId,
+                    // `UpdateItemInput` carries language/version at the input level;
+                    // the Authoring API has no per-field language/version. A
+                    // SetField targeting a story-seed version lands here.
+                    ...(input.language !== undefined && { language: input.language }),
+                    ...(input.version !== undefined && { version: input.version }),
                     fields: toAuthoringFieldsInput(input.fields),
                 },
             }, writeRequest);
@@ -484,11 +544,35 @@ const createAuthoringClient = (options) => {
             else if (selector.path)
                 input.path = selector.path;
             else
-                throw (0, errors_1.createCliError)("deleteItem requires either path or itemId.", "INPUT_INVALID");
+                throw (0, errors_1.createScaiError)("deleteItem requires either path or itemId.", "INPUT_INVALID");
             const data = await (0, graphql_2.runAuthoringGraphQL)(environment, DELETE_ITEM_MUTATION, { input }, writeRequest);
             if (!data.deleteItem?.successful) {
-                throw (0, errors_1.createCliError)(`deleteItem returned successful: ${data.deleteItem?.successful} for ${selector.itemId ?? selector.path ?? "(no selector)"}`, "UNKNOWN");
+                throw (0, errors_1.createScaiError)(`deleteItem returned successful: ${data.deleteItem?.successful} for ${selector.itemId ?? selector.path ?? "(no selector)"}`, "UNKNOWN");
+            }
+        },
+        async addItemVersion(input) {
+            const data = await (0, graphql_2.runAuthoringGraphQL)(environment, ADD_ITEM_VERSION_MUTATION, { input: { itemId: input.itemId, language: input.language } }, writeRequest);
+            const version = data.addItemVersion?.item?.version;
+            if (typeof version !== "number") {
+                throw (0, errors_1.createScaiError)("addItemVersion returned no version — Authoring API response was malformed.", "UNKNOWN");
+            }
+            return { version };
+        },
+        async getItemVersions(selector, language) {
+            let data;
+            if (selector.itemId) {
+                data = await (0, graphql_2.runAuthoringGraphQL)(environment, GET_ITEM_VERSIONS_BY_ID, { itemId: selector.itemId, language }, readRequest);
+            }
+            else if (selector.path) {
+                data = await (0, graphql_2.runAuthoringGraphQL)(environment, GET_ITEM_VERSIONS_BY_PATH, { path: selector.path, language }, readRequest);
+            }
+            else {
+                throw (0, errors_1.createScaiError)("getItemVersions requires either path or itemId.", "INPUT_INVALID");
             }
+            return (data.item?.versions ?? [])
+                .map((v) => v.version)
+                .filter((v) => typeof v === "number")
+                .sort((a, b) => a - b);
         },
     };
 };

package/dist/recipe/api/client.d.ts

@@ -55,6 +55,18 @@ export interface CreateItemInput {
     /** Default language for versioned fields; defaults to "en". */
     language?: string;
     fields: FieldValue[];
+    /**
+     * When true, the implementation does an authoritative
+     * parent-children lookup BEFORE issuing the create mutation. If a
+     * sibling with `name` already exists, returns its itemId without
+     * mutating. Recipe push opts in because the planner reads existence
+     * via the path index, which lags writes by seconds-to-minutes — so
+     * a rapid second push can plan a create against a path the tenant
+     * already has, and Sitecore's create mutation does not always
+     * reject the duplicate. Off by default for explicit one-shot
+     * createItem calls.
+     */
+    idempotencyCheck?: boolean;
 }
 export interface CreateItemResult {
     /** Sitecore-assigned itemId (UUID without curly braces). */
@@ -62,8 +74,29 @@ export interface CreateItemResult {
 }
 export interface UpdateItemInput {
     itemId: string;
+    /**
+     * Language to write the fields in. The Authoring API applies every
+     * `FieldValueInput` at this input-level language — per-field language is
+     * not on the wire. Omit for the item's default language.
+     */
+    language?: string;
+    /**
+     * Numbered version to write the fields to. Omit for the latest version.
+     * A `SetField` targeting a story-seed numbered version carries it here.
+     */
+    version?: number;
     fields: FieldValue[];
 }
+export interface AddItemVersionInput {
+    /** Sitecore itemId of the target item. */
+    itemId: string;
+    /** Language whose version stack to extend (ISO code, e.g. `en`, `fr`). */
+    language: string;
+}
+export interface AddItemVersionResult {
+    /** The numbered version that now exists — the one just added. */
+    version: number;
+}
 export interface GetItemOptions {
     /** Languages to fetch versioned fields for. Default: `["en"]`. */
     languages?: string[];
@@ -95,5 +128,21 @@ export interface AuthoringApiClient {
     updateItem(input: UpdateItemInput): Promise<void>;
     /** Phase 4 policy `CreateUpdateAndDelete` will use this. */
     deleteItem(selector: ItemSelector): Promise<void>;
+    /**
+     * Add a numbered version to `input.itemId` in `input.language`. Sitecore
+     * assigns the version number sequentially; the result carries the number
+     * of the version just created. When the language has no versions yet,
+     * this creates that language version as part of adding version 1.
+     *
+     * Backs the `AddItemVersion` IR op — story-seed content recipes that
+     * author multiple numbered versions of an item.
+     */
+    addItemVersion(input: AddItemVersionInput): Promise<AddItemVersionResult>;
+    /**
+     * The numbered versions an item currently has in `language`, ascending —
+     * empty when the item has no versions in that language or doesn't exist.
+     * The `AddItemVersion` planner reads this to stay idempotent (skip when
+     * the target version already exists).
+     */
+    getItemVersions(selector: ItemSelector, language: string): Promise<number[]>;
 }
-//# sourceMappingURL=client.d.ts.map

package/dist/recipe/api/graphql.d.ts

@@ -2,14 +2,13 @@
  * Authoring GraphQL transport for recipe execution.
  *
  * Thin wrapper over `src/shared/graphql.ts` — supplies the Authoring
- * service path and label. Parallels `src/serialization/sitecore-api/graphql.ts`
+ * service path and label. Parallels `src/serialization/api/graphql.ts`
  * which targets the Management endpoint.
  *
  * XM Cloud Authoring API path. If a SitecoreAI tenant ever exposes the
  * endpoint at a different path, override via `SITECOREAI_AUTHORING_PATH`.
  */
-import type { EnvironmentConfiguration } from "../../config";
+import type { EnvironmentConfiguration } from "../../config/types";
 import { type GraphQLRequestOptions } from "../../shared/graphql";
 export type AuthoringRequestOptions = GraphQLRequestOptions;
 export declare const runAuthoringGraphQL: <T>(environment: EnvironmentConfiguration, query: string, variables?: Record<string, unknown>, options?: AuthoringRequestOptions) => Promise<T>;
-//# sourceMappingURL=graphql.d.ts.map

package/dist/recipe/api/graphql.js

@@ -3,7 +3,7 @@
  * Authoring GraphQL transport for recipe execution.
  *
  * Thin wrapper over `src/shared/graphql.ts` — supplies the Authoring
- * service path and label. Parallels `src/serialization/sitecore-api/graphql.ts`
+ * service path and label. Parallels `src/serialization/api/graphql.ts`
  * which targets the Management endpoint.
  *
  * XM Cloud Authoring API path. If a SitecoreAI tenant ever exposes the

package/dist/recipe/api/ref-encoding.d.ts

@@ -35,4 +35,3 @@ export declare const resolveRecipeRefs: (value: RefValue, capturedItemIds: Reado
  * GUID — defensive against ref values that aren't actual itemIds.
  */
 export declare const dashifyGuid: (guid: string) => string;
-//# sourceMappingURL=ref-encoding.d.ts.map

package/dist/recipe/api/ref-encoding.js

@@ -31,7 +31,7 @@ const renderRefValue = (value) => {
         case "ref-recipe":
         case "ref-recipe-list":
         case "ref-source-fields":
-            throw (0, errors_1.createCliError)(`Unresolved ${value.kind} cannot be rendered — call resolveRecipeRefs first.`, "UNKNOWN");
+            throw (0, errors_1.createScaiError)(`Unresolved ${value.kind} cannot be rendered — call resolveRecipeRefs first.`, "UNKNOWN");
         case "ref-path":
             return value.value;
         case "query":
@@ -42,7 +42,7 @@ const renderRefValue = (value) => {
                 .join("&");
         default: {
             const exhaustive = value;
-            throw (0, errors_1.createCliError)(`Unhandled RefValue kind: ${JSON.stringify(exhaustive)}`, "UNKNOWN");
+            throw (0, errors_1.createScaiError)(`Unhandled RefValue kind: ${JSON.stringify(exhaustive)}`, "UNKNOWN");
         }
     }
 };
@@ -70,7 +70,7 @@ const resolveRecipeRefs = (value, capturedItemIds) => {
             if (isGuid(value.refKey)) {
                 return { kind: "ref-guid", value: value.refKey };
             }
-            throw (0, errors_1.createCliError)(`ref-recipe refKey ${value.refKey} not in captured map — was the producing CreateItem op skipped or did it run after this op?`, "UNKNOWN");
+            throw (0, errors_1.createScaiError)(`ref-recipe refKey ${value.refKey} not in captured map — was the producing CreateItem op skipped or did it run after this op?`, "UNKNOWN");
         }
         case "ref-recipe-list": {
             const guids = [];
@@ -89,7 +89,7 @@ const resolveRecipeRefs = (value, capturedItemIds) => {
                 }
                 if (value.tolerateMissing)
                     continue;
-                throw (0, errors_1.createCliError)(`ref-recipe-list refKey ${refKey} not in captured map — was the producing CreateItem op skipped or did it run after this op?`, "UNKNOWN");
+                throw (0, errors_1.createScaiError)(`ref-recipe-list refKey ${refKey} not in captured map — was the producing CreateItem op skipped or did it run after this op?`, "UNKNOWN");
             }
             return { kind: "ref-guid-list", values: guids };
         }
@@ -109,7 +109,7 @@ const resolveRecipeRefs = (value, capturedItemIds) => {
                 const refKey = (0, guids_1.templateId)(value.site, handle);
                 const itemId = capturedItemIds.get(refKey);
                 if (!itemId) {
-                    throw (0, errors_1.createCliError)(`ref-source-fields references handle '${handle}' (refKey ${refKey}); not yet in captured map.`, "UNKNOWN");
+                    throw (0, errors_1.createScaiError)(`ref-source-fields references handle '${handle}' (refKey ${refKey}); not yet in captured map.`, "UNKNOWN");
                 }
                 return itemId;
             });

package/dist/recipe/api/site-discovery.d.ts

@@ -20,7 +20,7 @@
  * sub-item. Walking deeper for hostnames is opt-in (`includeHostnames`)
  * because it adds an N+1 round trip per site.
  */
-import { EnvironmentConfiguration } from "../../config";
+import type { EnvironmentConfiguration } from "../../config/types";
 export type DiscoveredSite = {
     /** Item name (URL-safe slug). Used as the SXA site name. */
     name: string;
@@ -46,4 +46,3 @@ export type DiscoverSitesOptions = {
     contentRoot?: string;
 };
 export declare const discoverSites: (environment: EnvironmentConfiguration, options?: DiscoverSitesOptions) => Promise<DiscoveredSite[]>;
-//# sourceMappingURL=site-discovery.d.ts.map

package/dist/recipe/api/sites-client.d.ts

@@ -1,4 +1,8 @@
-import { type Job, type JobResponse, type Language, type NewSiteInput, type Site, type SiteCollection, type SiteTemplate, type SitesApiClientOptions as RawSitesApiClientOptions } from "../../sites/api";
+import { type SiteCollection } from "../../sites/api/collections";
+import { type Job } from "../../sites/api/jobs";
+import { type Language } from "../../sites/api/languages";
+import { type JobResponse, type NewSiteInput, type Site, type SiteTemplate } from "../../sites/api/sites";
+import type { SitesApiClientOptions as RawSitesApiClientOptions } from "../../sites/api/types";
 /**
  * Sites API client surface for recipe execution.
  *
@@ -44,5 +48,4 @@ export interface SitesApiClient {
  * base URL; the underlying `sitesRequest` re-uses these per call.
  */
 export declare const createSitesApiClient: (options: RawSitesApiClientOptions) => SitesApiClient;
-export type { Job, JobResponse, Language, NewSiteInput, Site, SiteCollection, SiteTemplate, };
-//# sourceMappingURL=sites-client.d.ts.map
+export type { Job, JobResponse, Language, NewSiteInput, Site, SiteCollection, SiteTemplate };

package/dist/recipe/api/sites-client.js

@@ -1,19 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSitesApiClient = void 0;
-const api_1 = require("../../sites/api");
+const collections_1 = require("../../sites/api/collections");
+const jobs_1 = require("../../sites/api/jobs");
+const languages_1 = require("../../sites/api/languages");
+const sites_1 = require("../../sites/api/sites");
 /**
  * Adapter: build a `SitesApiClient` over the function-style Sites API
  * surface. The `options` arg carries the OAuth-resolved auth header and
  * base URL; the underlying `sitesRequest` re-uses these per call.
  */
 const createSitesApiClient = (options) => ({
-    createSite: (input) => (0, api_1.createSite)(options, input),
-    getJobStatus: (jobHandle) => (0, api_1.getJobStatus)(options, jobHandle),
-    listSites: () => (0, api_1.listSites)(options),
-    listSiteTemplates: () => (0, api_1.listSiteTemplates)(options),
-    listCollections: () => (0, api_1.listCollections)(options),
-    listLanguages: () => (0, api_1.listLanguages)(options),
-    addLanguage: (languageCode) => (0, api_1.addLanguage)(options, { languageCode }),
+    createSite: (input) => (0, sites_1.createSite)(options, input),
+    getJobStatus: (jobHandle) => (0, jobs_1.getJobStatus)(options, jobHandle),
+    listSites: () => (0, sites_1.listSites)(options),
+    listSiteTemplates: () => (0, sites_1.listSiteTemplates)(options),
+    listCollections: () => (0, collections_1.listCollections)(options),
+    listLanguages: () => (0, languages_1.listLanguages)(options),
+    addLanguage: (languageCode) => (0, languages_1.addLanguage)(options, { languageCode }),
 });
 exports.createSitesApiClient = createSitesApiClient;

package/dist/recipe/cache.d.ts

@@ -33,4 +33,3 @@ export declare const saveRecipeCache: (configDir: string, cache: RecipeCacheFile
  */
 export declare const cachedSkipFor: (cache: RecipeCacheFile, envName: string, rootsHash: string, recipeHandle: string, irHash: string) => RecipeCacheEntry | null;
 export declare const recordCacheEntry: (cache: RecipeCacheFile, envName: string, rootsHash: string, recipeHandle: string, entry: RecipeCacheEntry) => void;
-//# sourceMappingURL=cache.d.ts.map

package/dist/recipe/compile/component-section.d.ts

@@ -21,7 +21,7 @@ import { type CompileContext } from "./shared";
  *
  * The two SUBORDINATE buckets (#2 Component Folders, #3 Presentation
  * Parameters) are NOT emitted here — they're emitted lazily by
- * `ensureComponentFoldersBucket` / `ensurePresentationParametersBucket`
+ * `ensureComponentFoldersBucket` / `ensurePresentationDesignParametersBucket`
  * when a component recipe in the section actually needs them. They live
  * under the section folder so they inherit positional context but get
  * the default `FOLDER_ICON` (no per-bucket rich fields by design).
@@ -43,4 +43,3 @@ export declare function compileComponentSectionRecipe(input: ComponentSectionRec
  * message so authors can locate the source of the bad reference).
  */
 export declare const resolveSectionRecipe: (consumerHandle: string, sectionHandle: string, sectionsByHandle: ReadonlyMap<string, ComponentSectionRecipe> | undefined) => ComponentSectionRecipe;
-//# sourceMappingURL=component-section.d.ts.map

package/dist/recipe/compile/component-section.js

@@ -28,7 +28,7 @@ const shared_1 = require("./shared");
  *
  * The two SUBORDINATE buckets (#2 Component Folders, #3 Presentation
  * Parameters) are NOT emitted here — they're emitted lazily by
- * `ensureComponentFoldersBucket` / `ensurePresentationParametersBucket`
+ * `ensureComponentFoldersBucket` / `ensurePresentationDesignParametersBucket`
  * when a component recipe in the section actually needs them. They live
  * under the section folder so they inherit positional context but get
  * the default `FOLDER_ICON` (no per-bucket rich fields by design).
@@ -134,7 +134,7 @@ function compileComponentSectionRecipe(input, context, emittedFolders = new Set(
 const resolveSectionRecipe = (consumerHandle, sectionHandle, sectionsByHandle) => {
     const section = sectionsByHandle?.get(sectionHandle);
     if (!section) {
-        throw (0, errors_1.createCliError)(`Recipe '${consumerHandle}' references section.handle='${sectionHandle}' but no ComponentSectionRecipe with that handle is in the set.`, "INPUT_INVALID", {
+        throw (0, errors_1.createScaiError)(`Recipe '${consumerHandle}' references section.handle='${sectionHandle}' but no ComponentSectionRecipe with that handle is in the set.`, "INPUT_INVALID", {
             hint: "Add a `ComponentSectionRecipe` (kind: 'component-section') with the matching handle to the recipe set, or change the consumer's `section.handle` to point at an existing one.",
         });
     }

package/dist/recipe/compile/component-template.d.ts

@@ -31,4 +31,3 @@ import { type CompileContext } from "./shared";
  *       creation, no Component Folder generation.
  */
 export declare function compileComponentTemplateRecipe(input: ComponentTemplateRecipe, context: CompileContext, emittedFolders?: Set<string>): OperationIr;
-//# sourceMappingURL=component-template.d.ts.map

package/dist/recipe/compile/component-template.js

@@ -343,16 +343,16 @@ function emitSiteDataFolderTemplate(operations, recipe, context, icon, emittedFo
 }
 function emitParamsTemplate(operations, recipe, context, icon, policy, emittedFolders) {
     const site = (0, shared_1.siteOf)(context);
-    const paramsTplRefKey = (0, guids_1.paramsTemplateId)(site, recipe.handle);
+    const paramsTplRefKey = (0, guids_1.designParametersTemplateId)(site, recipe.handle);
     const paramsName = `${recipe.name} Parameters`;
     const paramsDisplayName = `${recipe.displayName} Parameters`;
     const sectionName = resolveSectionName(recipe, context);
     let paramsParent;
     let paramsParentPath;
     if (sectionName) {
-        const bucketRefKey = (0, shared_1.ensurePresentationParametersBucket)(operations, context, sectionName, emittedFolders);
+        const bucketRefKey = (0, shared_1.ensurePresentationDesignParametersBucket)(operations, context, sectionName, emittedFolders);
         paramsParent = { kind: "ref-recipe", refKey: bucketRefKey };
-        paramsParentPath = (0, shared_1.resolvePresentationParametersBucketPath)(context, sectionName);
+        paramsParentPath = (0, shared_1.resolvePresentationDesignParametersBucketPath)(context, sectionName);
     }
     else {
         paramsParent = { kind: "ref-path", value: context.templatesRoot };
@@ -385,7 +385,7 @@ function emitParamsTemplate(operations, recipe, context, icon, policy, emittedFo
         // empty in Pages even though the template + fields exist.
         baseTemplates: [...sitecore_templates_1.SXA_HEADLESS_PARAMS_BASE_TEMPLATES],
     });
-    const paramsSecRefKey = (0, guids_1.paramsSectionId)(site, recipe.handle, shared_1.PARAMS_SECTION_NAME);
+    const paramsSecRefKey = (0, guids_1.designParametersSectionId)(site, recipe.handle, shared_1.PARAMS_SECTION_NAME);
     const paramsSecPath = (0, shared_1.joinPath)(paramsTplPath, shared_1.PARAMS_SECTION_NAME);
     operations.push({
         op: "CreateItem",
@@ -401,7 +401,7 @@ function emitParamsTemplate(operations, recipe, context, icon, policy, emittedFo
     recipe.params.forEach((param, index) => {
         operations.push(...(0, shared_1.buildFieldOp)({
             recipeHandle: recipe.handle,
-            fieldRefKey: (0, guids_1.paramsFieldId)(site, recipe.handle, param.name),
+            fieldRefKey: (0, guids_1.designParameterFieldId)(site, recipe.handle, param.name),
             fieldPath: (0, shared_1.joinPath)(paramsSecPath, param.name),
             parentRefKey: paramsSecRefKey,
             labelPrefix: `params-field:${recipe.handle}`,
@@ -418,9 +418,9 @@ function emitParamsTemplate(operations, recipe, context, icon, policy, emittedFo
     // least one param declares a `default` / `sitecore.defaultValue`;
     // empty SV items are noise and would still resolve identical GUIDs
     // across pushes if added later.
-    const paramsSvFieldEntries = (0, shared_1.buildStandardValuesFieldEntries)(site, recipe.handle, recipe.params, guids_1.paramsFieldId);
+    const paramsSvFieldEntries = (0, shared_1.buildStandardValuesFieldEntries)(site, recipe.handle, recipe.params, guids_1.designParameterFieldId);
     if (paramsSvFieldEntries.length > 0) {
-        const paramsSvRefKey = (0, guids_1.paramsStandardValuesId)(site, recipe.handle);
+        const paramsSvRefKey = (0, guids_1.designParametersStandardValuesId)(site, recipe.handle);
         const paramsSvPath = (0, shared_1.joinPath)(paramsTplPath, "__Standard Values");
         operations.push({
             op: "CreateItem",
@@ -467,10 +467,10 @@ function emitRendering(operations, recipe, context, icon, hasParams, policy, emi
     if (hasParams) {
         // Prefer the explicit `parameters: { handle }` reference when set,
         // else point at the synthesised inline params template (whose
-        // refKey is `paramsTemplateId(site, recipe.handle)`).
+        // refKey is `designParametersTemplateId(site, recipe.handle)`).
         const paramsRefKey = recipe.parameters
-            ? (0, guids_1.paramsTemplateId)(site, recipe.parameters.handle)
-            : (0, guids_1.paramsTemplateId)(site, recipe.handle);
+            ? (0, guids_1.designParametersTemplateId)(site, recipe.parameters.handle)
+            : (0, guids_1.designParametersTemplateId)(site, recipe.handle);
         fields.push((0, shared_1.sharedField)(sitecore_templates_1.RENDERING_FIELDS.PARAMETERS_TEMPLATE, {
             kind: "ref-recipe",
             refKey: paramsRefKey,
@@ -492,7 +492,7 @@ function emitRendering(operations, recipe, context, icon, hasParams, policy, emi
             }
             // location.scope === "site"
             if (!context.contentItemsRoot) {
-                throw (0, errors_1.createCliError)(`Recipe '${recipe.handle}' declares a site-scoped datasource location but no contentItemsRoot is configured.`, "INPUT_INVALID", {
+                throw (0, errors_1.createScaiError)(`Recipe '${recipe.handle}' declares a site-scoped datasource location but no contentItemsRoot is configured.`, "INPUT_INVALID", {
                     hint: "Set `contentItemsRoot` on the active envProfile in sitecoreai.cli.json (e.g. `/sitecore/content/<siteCollection>/<site>/Data`).",
                 });
             }
@@ -520,15 +520,13 @@ function emitRendering(operations, recipe, context, icon, hasParams, policy, emi
                         .map((s) => s.trim())
                         .filter(Boolean);
                     if (subfolderSegments.length === 0) {
-                        throw (0, errors_1.createCliError)(`Recipe '${recipe.handle}' declares a site-scoped datasource subfolder that is empty after trimming.`, "INPUT_INVALID", {
+                        throw (0, errors_1.createScaiError)(`Recipe '${recipe.handle}' declares a site-scoped datasource subfolder that is empty after trimming.`, "INPUT_INVALID", {
                             hint: "Use a non-empty subfolder string like 'Badges' or 'ui/badges'.",
                         });
                     }
                     const leafName = subfolderSegments[subfolderSegments.length - 1];
                     const intermediateSegments = subfolderSegments.slice(0, -1);
-                    const parentPath = intermediateSegments.length > 0
-                        ? (0, shared_1.joinPath)(base, intermediateSegments.join("/"))
-                        : base;
+                    const parentPath = intermediateSegments.length > 0 ? (0, shared_1.joinPath)(base, intermediateSegments.join("/")) : base;
                     const folderPath = (0, shared_1.joinPath)(base, subfolderSegments.join("/"));
                     // Shared-subfolder coalescer signal: when this subfolder is
                     // populated by ≥2 recipes in the set, the folder ITEM
@@ -638,7 +636,7 @@ function emitRendering(operations, recipe, context, icon, hasParams, policy, emi
  */
 function emitVariants(operations, recipe, context, icon, policy, emittedFolders) {
     if (!context.headlessVariantsRoot) {
-        throw (0, errors_1.createCliError)(`Recipe '${recipe.handle}' declares ${recipe.variants.length} variants but no headlessVariantsRoot is configured.`, "INPUT_INVALID", {
+        throw (0, errors_1.createScaiError)(`Recipe '${recipe.handle}' declares ${recipe.variants.length} variants but no headlessVariantsRoot is configured.`, "INPUT_INVALID", {
             hint: "Set `headlessVariantsRoot` on the active envProfile in sitecoreai.cli.json (e.g. `/sitecore/content/<siteCollection>/<site>/Presentation/Headless Variants`).",
         });
     }
@@ -701,9 +699,7 @@ function emitVariants(operations, recipe, context, icon, policy, emittedFolders)
             parent: { kind: "ref-recipe", refKey: folderRefKey },
             templateOf: sitecore_templates_1.SITECORE_TEMPLATES.VARIANT_DEFINITION,
             name: variant.name,
-            fields: [
-                (0, shared_1.versionedField)(sitecore_templates_1.SYSTEM_FIELDS.DISPLAY_NAME, { kind: "string", value: variant.name }),
-            ],
+            fields: [(0, shared_1.versionedField)(sitecore_templates_1.SYSTEM_FIELDS.DISPLAY_NAME, { kind: "string", value: variant.name })],
         });
     }
 }