@sitecoreai-labs/sitecoreai-cli 0.0.4 → 0.1.0

package/dist/recipe/execute.js

@@ -32,11 +32,11 @@ const awaitSitesJob = async (sitesClient, jobHandle, emit) => {
             return;
         }
         if (phase === "Failed" || phase === "Errored") {
-            throw (0, errors_1.createCliError)(`Sites API job ${jobHandle} reported terminal state '${phase}'.`, "SITES_API_FAILED");
+            throw (0, errors_1.createScaiError)(`Sites API job ${jobHandle} reported terminal state '${phase}'.`, "SITES_API_FAILED");
         }
         await new Promise((resolve) => setTimeout(resolve, SITES_JOB_POLL_INTERVAL_MS));
     }
-    throw (0, errors_1.createCliError)(`Sites API job ${jobHandle} did not finish within ${SITES_JOB_POLL_BUDGET_MS}ms.`, "SITES_API_FAILED");
+    throw (0, errors_1.createScaiError)(`Sites API job ${jobHandle} did not finish within ${SITES_JOB_POLL_BUDGET_MS}ms.`, "SITES_API_FAILED");
 };
 /**
  * Build a `RemoteItem` snapshot from a just-applied `createItem` so
@@ -89,18 +89,29 @@ const dispatchMutation = async (client, sitesClient, action, capturedItemIds, pa
         await client.updateItem(action.mutation.input);
         return;
     }
+    if (action.mutation.kind === "addItemVersion") {
+        // Sitecore assigns numbered versions sequentially, so adding `addCount`
+        // versions one at a time lands the item's version count at the op's
+        // declared target. `addCount` is normally 1 (the compiler emits one op
+        // per extra version); a larger value reconciles a gap.
+        const { itemId, language, addCount } = action.mutation;
+        for (let n = 0; n < addCount; n += 1) {
+            await client.addItemVersion({ itemId, language });
+        }
+        return;
+    }
     // createSite: dispatch through Sites API, await the async job, then
     // look up the materialised site by name to capture its itemId so
     // subsequent SetField overrides (dictionary, taxonomy) targeting
     // items under the site can resolve via late-path seeding.
     if (!sitesClient) {
-        throw (0, errors_1.createCliError)("createSite mutation requires a SitesApiClient — none threaded into the executor.", "UNKNOWN");
+        throw (0, errors_1.createScaiError)("createSite mutation requires a SitesApiClient — none threaded into the executor.", "UNKNOWN");
     }
     const { input, siteRefKey } = action.mutation;
     const jobResponse = await sitesClient.createSite(input);
     const jobHandle = jobResponse.handle ?? jobResponse.jobHandle;
     if (!jobHandle) {
-        throw (0, errors_1.createCliError)(`createSite for '${input.siteName}' returned a JobResponse with no handle: ${JSON.stringify(jobResponse)}`, "SITES_API_FAILED");
+        throw (0, errors_1.createScaiError)(`createSite for '${input.siteName}' returned a JobResponse with no handle: ${JSON.stringify(jobResponse)}`, "SITES_API_FAILED");
     }
     await awaitSitesJob(sitesClient, jobHandle, emit);
     // Re-list and capture the new site's itemId. The Sites API doesn't
@@ -112,7 +123,7 @@ const dispatchMutation = async (client, sitesClient, action, capturedItemIds, pa
         capturedItemIds.set(siteRefKey, created.id);
     }
     else {
-        throw (0, errors_1.createCliError)(`createSite for '${input.siteName}' completed but the site is not present in listSites — cannot capture itemId.`, "SITES_API_FAILED");
+        throw (0, errors_1.createScaiError)(`createSite for '${input.siteName}' completed but the site is not present in listSites — cannot capture itemId.`, "SITES_API_FAILED");
     }
 };
 const buildResult = (ir, actions, summary, aborted, rollbackResult) => ({
@@ -121,7 +132,21 @@ const buildResult = (ir, actions, summary, aborted, rollbackResult) => ({
     aborted,
     rollback: rollbackResult,
 });
-const runRollback = async (applied, client, capturedItemIds, options) => (0, rollback_1.rollback)(applied, client, capturedItemIds, { emit: options.emit });
+const runRollback = async (applied, client, capturedItemIds, options, recipeHandle, summary) => {
+    const result = await (0, rollback_1.rollback)(applied, client, capturedItemIds, {
+        emit: options.emit,
+        log: options.rollbackLog ? { logger: options.rollbackLog, recipe: recipeHandle } : undefined,
+    });
+    if (options.rollbackLog) {
+        await options.rollbackLog.recordSummary(recipeHandle, {
+            trigger: summary.trigger,
+            rolledBack: result.rolledBack,
+            errorCount: result.errors.length,
+            forwardError: summary.forwardError,
+        });
+    }
+    return result;
+};
 const emitFailed = (options, failedAt, applied, rollbackResult, error) => {
     options.emit?.({
         kind: "failed",
@@ -226,6 +251,12 @@ const executeIr = async (ir, client, options) => {
         await seedCrossRecipeRefs(ir, client, options.crossRecipeRefs, capturedItemIds, options.pathSnapshotCache);
     }
     for (let index = 0; index < ir.operations.length; index += 1) {
+        if (options.signal?.aborted) {
+            const cancelMessage = `Cancelled by client before op ${index} of ${ir.operations.length}.`;
+            const rollbackResult = await runRollback(applied, client, capturedItemIds, options, ir.recipeHandle, { trigger: "cancelled", forwardError: cancelMessage });
+            emitFailed(options, index, applied, rollbackResult, cancelMessage);
+            return buildResult(ir, actions, summary, true, rollbackResult);
+        }
         const op = ir.operations[index];
         options.emit?.({ kind: "op-start", index, operation: op });
         let action;
@@ -238,7 +269,7 @@ const executeIr = async (ir, client, options) => {
             options.emit?.({ kind: "op-error", index, operation: op, error: message });
             summary.error += 1;
             actions.push(action);
-            const rollbackResult = await runRollback(applied, client, capturedItemIds, options);
+            const rollbackResult = await runRollback(applied, client, capturedItemIds, options, ir.recipeHandle, { trigger: "plan-error", forwardError: message });
             emitFailed(options, index, applied, rollbackResult, message);
             return buildResult(ir, actions, summary, true, rollbackResult);
         }
@@ -263,7 +294,7 @@ const executeIr = async (ir, client, options) => {
             action.status = "error";
             action.reason = message;
             options.emit?.({ kind: "apply-error", action, error: message });
-            const rollbackResult = await runRollback(applied, client, capturedItemIds, options);
+            const rollbackResult = await runRollback(applied, client, capturedItemIds, options, ir.recipeHandle, { trigger: "apply-error", forwardError: message });
             emitFailed(options, index, applied, rollbackResult, message);
             return buildResult(ir, actions, summary, true, rollbackResult);
         }

package/dist/recipe/guids.d.ts

@@ -16,11 +16,20 @@ export declare const NAMESPACE_ENUMERATION: string;
 export declare const _deriveNamespaceRoot: () => string;
 export declare const templateId: (site: string, handle: string) => string;
 export declare const renderingId: (site: string, handle: string) => string;
-export declare const paramsTemplateId: (site: string, handle: string) => string;
+export declare const designParametersTemplateId: (site: string, handle: string) => string;
 export declare const partialDesignId: (site: string, handle: string) => string;
 export declare const pageDesignId: (site: string, handle: string) => string;
 export declare const siteBranchId: (handle: string) => string;
 export declare const contentItemId: (site: string, handle: string) => string;
+/**
+ * Page item identity — a `PageRecipe`'s concrete page in the site
+ * content tree. Distinct namespace from `contentItemId`: a page is a
+ * navigable item conforming to a page template, not a shared datasource
+ * item, and `datasourceId(pageItemId(...), slot)` scopes page-local
+ * datasources beneath it. Site-scoped seed like the rest of the family.
+ */
+export declare const NAMESPACE_PAGE: string;
+export declare const pageItemId: (site: string, handle: string) => string;
 /**
  * Recipe-internal refKey for a `SiteRecipe`'s site item. The actual
  * Sitecore site itemId is server-assigned by the Sites API at
@@ -65,10 +74,10 @@ export declare const PAGE_DESIGNS_ROOT_REF_KEY: string;
 export declare const sectionId: (site: string, handle: string, sectionName: string) => string;
 /** Fields are scoped under their (site-scoped) template; the seed is the field name. */
 export declare const fieldId: (site: string, handle: string, fieldName: string) => string;
-/** Sections of the parameters template scope under (site-scoped) `paramsTemplateId`. */
-export declare const paramsSectionId: (site: string, handle: string, sectionName: string) => string;
-/** Fields of the parameters template scope under (site-scoped) `paramsTemplateId`. */
-export declare const paramsFieldId: (site: string, handle: string, fieldName: string) => string;
+/** Sections of the parameters template scope under (site-scoped) `designParametersTemplateId`. */
+export declare const designParametersSectionId: (site: string, handle: string, sectionName: string) => string;
+/** Fields of the parameters template scope under (site-scoped) `designParametersTemplateId`. */
+export declare const designParameterFieldId: (site: string, handle: string, fieldName: string) => string;
 /**
  * Per-rendering Headless Variants folder. Lives at
  * `<headlessVariantsRoot>/<section>/<RenderingName>/` and conforms to
@@ -93,10 +102,10 @@ export declare const standardValuesId: (site: string, handle: string) => string;
 /**
  * Standard values for a parameters template. Same `__standard-values`
  * seed pattern as `standardValuesId` but scoped under
- * `paramsTemplateId(site, handle)` so params-template SV items don't
+ * `designParametersTemplateId(site, handle)` so params-template SV items don't
  * collide with the component-template SV under the same handle.
  */
-export declare const paramsStandardValuesId: (site: string, handle: string) => string;
+export declare const designParametersStandardValuesId: (site: string, handle: string) => string;
 /**
  * Enumeration root item — backs an `EnumerationRecipe`. Lives at
  * `<enumerationsRoot>/<EnumName>` per-site. Children are the enum's
@@ -265,7 +274,7 @@ export declare const componentFoldersBucketId: (site: string, section: string) =
  * a site's `Components/<section>/` — an idempotent parent for
  * standalone (and synthesised) Parameters templates.
  */
-export declare const presentationParametersBucketId: (site: string, section: string) => string;
+export declare const presentationDesignParametersBucketId: (site: string, section: string) => string;
 /**
  * Deterministic refKey for a `<Component> Folder` template emitted when
  * a `ComponentTemplateRecipe` declares `children:`. The Sitecore item
@@ -289,6 +298,14 @@ export declare const componentFolderStandardValuesId: (site: string, componentHa
  * `meta.tax.group` matching this name.
  */
 export declare const contentModelsGroupFolderId: (site: string, group: string) => string;
+/**
+ * Deterministic refKey for a page-template group folder under a site's
+ * `<pageTemplatesRoot>/<group>/`. Materialised once via a CreateOnly
+ * CreateItem when any `PageTemplateRecipe` in the set carries
+ * `meta.tax.group` matching this name. Same identity family as
+ * `contentModelsGroupFolderId` — a site-owned organisational folder.
+ */
+export declare const pageTemplatesGroupFolderId: (site: string, group: string) => string;
 /**
  * Per-site shared Data Folder under `<contentItemsRoot>/<subfolder>`.
  * Emitted as a CreateOnly item by `compileComponentTemplateRecipe` when
@@ -397,4 +414,84 @@ export declare const enumerationsFolderTemplateStandardValuesId: (site: string)
  */
 export declare const NAMESPACE_SECTION_DEFINITION: string;
 export declare const sectionDefinitionId: (handle: string) => string;
-//# sourceMappingURL=guids.d.ts.map
+/**
+ * Placeholder Settings item identity.
+ *
+ * A Placeholder Settings item is the gate for "what renderings can be
+ * dropped into this slot" — it carries a `Placeholder Key` and an
+ * `Allowed Controls` whitelist. Its identity is the **placeholder key**,
+ * not a recipe handle: one key = one settings item. A standalone
+ * `PlaceholderRecipe` and an inline `ComponentTemplateRecipe.placeholders`
+ * entry that name the same key therefore derive the *same* GUID — which
+ * is correct (they describe the same Sitecore item) and lets the
+ * cross-recipe validator flag the ambiguous double-declaration.
+ *
+ * Site-scoped like the rest of the per-Project item family, so the same
+ * recipe set pushed to two sites yields two distinct Placeholder
+ * Settings items under each site's Presentation tree.
+ */
+export declare const NAMESPACE_PLACEHOLDER: string;
+export declare const placeholderSettingsId: (site: string, key: string) => string;
+/**
+ * Deterministic refKey for one segment of a placeholder `folder`
+ * grouping path under `<placeholderSettingsRoot>/<…segments…>`. Conforms
+ * to the SXA `Placeholder Settings Folder` template. Site-scoped + keyed
+ * on the segment's CUMULATIVE path so two recipes naming the same folder
+ * (`"Partial Design/Header"`) reuse the `Partial Design` and
+ * `Partial Design/Header` folders rather than colliding — pass the
+ * cumulative path, not the leaf segment.
+ *
+ * Same `NAMESPACE_PROJECT` "site organisational folder" family as
+ * section folders and the enumeration grouping folders.
+ */
+export declare const placeholderSettingsFolderId: (site: string, cumulativePath: string) => string;
+/**
+ * Deterministic refKey for a system template referenced by content-tree
+ * path (workflow/webhook/etc. system templates whose GUIDs aren't
+ * published). Same identity for the same path forever — the push
+ * pipeline seeds `crossRecipeRefs[<this refKey>] = path`; the executor
+ * batches a single `getItemsByPaths` lookup and the planner resolves
+ * `templateOf: ref-path` ops through the existing `capturedItemIds`
+ * map.
+ */
+export declare const NAMESPACE_TEMPLATE_BY_PATH: string;
+export declare const templatePathRefKey: (path: string) => string;
+/**
+ * Deterministic refKey for the `__Standard Values` item under a
+ * tenant-existing template referenced by content-tree path. Used by
+ * `WorkflowRecipe.bindings.templates` entries that point at an absolute
+ * template path (not an intra-recipe handle): the compiler emits a
+ * `SetField` op with `latePath: "<templatePath>/__Standard Values"`,
+ * and the executor's late-path resolution walks the path to seed the
+ * captured-itemId map before planning the field write. Same identity
+ * for the same path forever.
+ */
+export declare const NAMESPACE_STANDARD_VALUES_BY_PATH: string;
+export declare const standardValuesPathRefKey: (templatePath: string) => string;
+/**
+ * Workflow recipe identities.
+ *
+ * Workflows live at `/sitecore/system/Workflows/[<group>/]<name>` and
+ * are tenant-wide (not site-scoped), so GUIDs derive from the recipe
+ * handle directly. Sub-items (states, commands, actions) nest under
+ * the workflow's GUID to keep the hierarchy stable across renames at
+ * deeper levels.
+ */
+export declare const NAMESPACE_WORKFLOW: string;
+export declare const workflowId: (handle: string) => string;
+export declare const workflowStateId: (handle: string, stateKey: string) => string;
+export declare const workflowCommandId: (handle: string, stateKey: string, commandKey: string) => string;
+/** Webhook submit/validation action under a workflow STATE's `Actions` folder. */
+export declare const workflowStateActionId: (handle: string, stateKey: string, index: number) => string;
+/** Webhook validation action under a workflow COMMAND's `Actions` folder. */
+export declare const workflowCommandValidationId: (handle: string, stateKey: string, commandKey: string, index: number) => string;
+/** Workflow group folder under /sitecore/system/Workflows (when meta.tax.group is set). */
+export declare const workflowGroupFolderId: (group: string) => string;
+/**
+ * Webhook Authorization recipe identity. Items live at
+ * `/sitecore/system/Settings/Webhooks/Authorizations/<name>` — flat,
+ * tenant-wide. Used by workflow webhook actions + event handlers to
+ * carry credentials.
+ */
+export declare const NAMESPACE_WEBHOOK_AUTHORIZATION: string;
+export declare const webhookAuthorizationId: (handle: string) => string;

package/dist/recipe/guids.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.componentFolderTemplateId = exports.presentationParametersBucketId = exports.componentFoldersBucketId = exports.availableRenderingsSectionId = exports.headlessVariantsSectionFolderId = exports.renderingsSectionFolderId = exports.sectionFolderId = exports.NAMESPACE_PROJECT = exports.datasourceId = exports.enumerationTemplateValueFieldId = exports.enumerationTemplateSectionId = exports.enumerationValueTemplateId = exports.enumerationTemplateStandardValuesId = exports.enumerationContainerValueFieldId = exports.enumerationContainerSectionId = exports.enumerationTemplateId = exports.enumerationsGroupingFolderId = exports.enumerationsFolderTemplateId = exports.enumValueId = exports.enumerationFolderId = exports.paramsStandardValuesId = exports.standardValuesId = exports.variantId = exports.variantsFolderId = exports.paramsFieldId = exports.paramsSectionId = exports.fieldId = exports.sectionId = exports.PAGE_DESIGNS_ROOT_REF_KEY = exports.taxonomyTagId = exports.taxonomyFolderId = exports.dictionaryPhraseId = exports.siteId = exports.contentItemId = exports.siteBranchId = exports.pageDesignId = exports.partialDesignId = exports.paramsTemplateId = exports.renderingId = exports.templateId = exports._deriveNamespaceRoot = exports.NAMESPACE_ENUMERATION = exports.NAMESPACE_SITE = exports.NAMESPACE_CONTENT_ITEM = exports.NAMESPACE_SITE_BRANCH = exports.NAMESPACE_PAGE_DESIGN = exports.NAMESPACE_PARTIAL_DESIGN = exports.NAMESPACE_RENDERING = exports.NAMESPACE_TEMPLATE = exports.NAMESPACE_ROOT = void 0;
-exports.sectionDefinitionId = exports.NAMESPACE_SECTION_DEFINITION = exports.enumerationsFolderTemplateStandardValuesId = exports.enumerationsRootStandardValuesId = exports.enumerationsRootId = exports.siteDataRootStandardValuesId = exports.sharedDataFolderStandardValuesId = exports.sharedDataFolderTemplateId = exports.siteDataFolderStandardValuesId = exports.siteDataFolderTemplateId = exports.siteDataFolderId = exports.contentModelsGroupFolderId = exports.componentFolderStandardValuesId = void 0;
+exports.componentFoldersBucketId = exports.availableRenderingsSectionId = exports.headlessVariantsSectionFolderId = exports.renderingsSectionFolderId = exports.sectionFolderId = exports.NAMESPACE_PROJECT = exports.datasourceId = exports.enumerationTemplateValueFieldId = exports.enumerationTemplateSectionId = exports.enumerationValueTemplateId = exports.enumerationTemplateStandardValuesId = exports.enumerationContainerValueFieldId = exports.enumerationContainerSectionId = exports.enumerationTemplateId = exports.enumerationsGroupingFolderId = exports.enumerationsFolderTemplateId = exports.enumValueId = exports.enumerationFolderId = exports.designParametersStandardValuesId = exports.standardValuesId = exports.variantId = exports.variantsFolderId = exports.designParameterFieldId = exports.designParametersSectionId = exports.fieldId = exports.sectionId = exports.PAGE_DESIGNS_ROOT_REF_KEY = exports.taxonomyTagId = exports.taxonomyFolderId = exports.dictionaryPhraseId = exports.siteId = exports.pageItemId = exports.NAMESPACE_PAGE = exports.contentItemId = exports.siteBranchId = exports.pageDesignId = exports.partialDesignId = exports.designParametersTemplateId = exports.renderingId = exports.templateId = exports._deriveNamespaceRoot = exports.NAMESPACE_ENUMERATION = exports.NAMESPACE_SITE = exports.NAMESPACE_CONTENT_ITEM = exports.NAMESPACE_SITE_BRANCH = exports.NAMESPACE_PAGE_DESIGN = exports.NAMESPACE_PARTIAL_DESIGN = exports.NAMESPACE_RENDERING = exports.NAMESPACE_TEMPLATE = exports.NAMESPACE_ROOT = void 0;
+exports.webhookAuthorizationId = exports.NAMESPACE_WEBHOOK_AUTHORIZATION = exports.workflowGroupFolderId = exports.workflowCommandValidationId = exports.workflowStateActionId = exports.workflowCommandId = exports.workflowStateId = exports.workflowId = exports.NAMESPACE_WORKFLOW = exports.standardValuesPathRefKey = exports.NAMESPACE_STANDARD_VALUES_BY_PATH = exports.templatePathRefKey = exports.NAMESPACE_TEMPLATE_BY_PATH = exports.placeholderSettingsFolderId = exports.placeholderSettingsId = exports.NAMESPACE_PLACEHOLDER = exports.sectionDefinitionId = exports.NAMESPACE_SECTION_DEFINITION = exports.enumerationsFolderTemplateStandardValuesId = exports.enumerationsRootStandardValuesId = exports.enumerationsRootId = exports.siteDataRootStandardValuesId = exports.sharedDataFolderStandardValuesId = exports.sharedDataFolderTemplateId = exports.siteDataFolderStandardValuesId = exports.siteDataFolderTemplateId = exports.siteDataFolderId = exports.pageTemplatesGroupFolderId = exports.contentModelsGroupFolderId = exports.componentFolderStandardValuesId = exports.componentFolderTemplateId = exports.presentationDesignParametersBucketId = void 0;
 const uuid_1 = require("uuid");
 /**
  * Deterministic GUID derivation for recipe-emitted Sitecore items.
@@ -57,8 +57,8 @@ const templateId = (site, handle) => (0, uuid_1.v5)(`${site}::${handle}`, export
 exports.templateId = templateId;
 const renderingId = (site, handle) => (0, uuid_1.v5)(`${site}::${handle}`, exports.NAMESPACE_RENDERING);
 exports.renderingId = renderingId;
-const paramsTemplateId = (site, handle) => (0, uuid_1.v5)(`${site}::${handle}::params`, exports.NAMESPACE_TEMPLATE);
-exports.paramsTemplateId = paramsTemplateId;
+const designParametersTemplateId = (site, handle) => (0, uuid_1.v5)(`${site}::${handle}::params`, exports.NAMESPACE_TEMPLATE);
+exports.designParametersTemplateId = designParametersTemplateId;
 const partialDesignId = (site, handle) => (0, uuid_1.v5)(`${site}::${handle}`, exports.NAMESPACE_PARTIAL_DESIGN);
 exports.partialDesignId = partialDesignId;
 const pageDesignId = (site, handle) => (0, uuid_1.v5)(`${site}::${handle}`, exports.NAMESPACE_PAGE_DESIGN);
@@ -67,6 +67,16 @@ const siteBranchId = (handle) => (0, uuid_1.v5)(handle, exports.NAMESPACE_SITE_B
 exports.siteBranchId = siteBranchId;
 const contentItemId = (site, handle) => (0, uuid_1.v5)(`${site}::${handle}`, exports.NAMESPACE_CONTENT_ITEM);
 exports.contentItemId = contentItemId;
+/**
+ * Page item identity — a `PageRecipe`'s concrete page in the site
+ * content tree. Distinct namespace from `contentItemId`: a page is a
+ * navigable item conforming to a page template, not a shared datasource
+ * item, and `datasourceId(pageItemId(...), slot)` scopes page-local
+ * datasources beneath it. Site-scoped seed like the rest of the family.
+ */
+exports.NAMESPACE_PAGE = (0, uuid_1.v5)("page", exports.NAMESPACE_ROOT);
+const pageItemId = (site, handle) => (0, uuid_1.v5)(`${site}::${handle}`, exports.NAMESPACE_PAGE);
+exports.pageItemId = pageItemId;
 /**
  * Recipe-internal refKey for a `SiteRecipe`'s site item. The actual
  * Sitecore site itemId is server-assigned by the Sites API at
@@ -117,12 +127,12 @@ exports.sectionId = sectionId;
 /** Fields are scoped under their (site-scoped) template; the seed is the field name. */
 const fieldId = (site, handle, fieldName) => (0, uuid_1.v5)(fieldName, (0, exports.templateId)(site, handle));
 exports.fieldId = fieldId;
-/** Sections of the parameters template scope under (site-scoped) `paramsTemplateId`. */
-const paramsSectionId = (site, handle, sectionName) => (0, uuid_1.v5)(`section:${sectionName}`, (0, exports.paramsTemplateId)(site, handle));
-exports.paramsSectionId = paramsSectionId;
-/** Fields of the parameters template scope under (site-scoped) `paramsTemplateId`. */
-const paramsFieldId = (site, handle, fieldName) => (0, uuid_1.v5)(fieldName, (0, exports.paramsTemplateId)(site, handle));
-exports.paramsFieldId = paramsFieldId;
+/** Sections of the parameters template scope under (site-scoped) `designParametersTemplateId`. */
+const designParametersSectionId = (site, handle, sectionName) => (0, uuid_1.v5)(`section:${sectionName}`, (0, exports.designParametersTemplateId)(site, handle));
+exports.designParametersSectionId = designParametersSectionId;
+/** Fields of the parameters template scope under (site-scoped) `designParametersTemplateId`. */
+const designParameterFieldId = (site, handle, fieldName) => (0, uuid_1.v5)(fieldName, (0, exports.designParametersTemplateId)(site, handle));
+exports.designParameterFieldId = designParameterFieldId;
 /**
  * Per-rendering Headless Variants folder. Lives at
  * `<headlessVariantsRoot>/<section>/<RenderingName>/` and conforms to
@@ -150,11 +160,11 @@ exports.standardValuesId = standardValuesId;
 /**
  * Standard values for a parameters template. Same `__standard-values`
  * seed pattern as `standardValuesId` but scoped under
- * `paramsTemplateId(site, handle)` so params-template SV items don't
+ * `designParametersTemplateId(site, handle)` so params-template SV items don't
  * collide with the component-template SV under the same handle.
  */
-const paramsStandardValuesId = (site, handle) => (0, uuid_1.v5)("__standard-values", (0, exports.paramsTemplateId)(site, handle));
-exports.paramsStandardValuesId = paramsStandardValuesId;
+const designParametersStandardValuesId = (site, handle) => (0, uuid_1.v5)("__standard-values", (0, exports.designParametersTemplateId)(site, handle));
+exports.designParametersStandardValuesId = designParametersStandardValuesId;
 /**
  * Enumeration root item — backs an `EnumerationRecipe`. Lives at
  * `<enumerationsRoot>/<EnumName>` per-site. Children are the enum's
@@ -340,8 +350,8 @@ exports.componentFoldersBucketId = componentFoldersBucketId;
  * a site's `Components/<section>/` — an idempotent parent for
  * standalone (and synthesised) Parameters templates.
  */
-const presentationParametersBucketId = (site, section) => (0, uuid_1.v5)(`${site}:Components:${section}:Presentation Parameters`, exports.NAMESPACE_PROJECT);
-exports.presentationParametersBucketId = presentationParametersBucketId;
+const presentationDesignParametersBucketId = (site, section) => (0, uuid_1.v5)(`${site}:Components:${section}:Presentation Parameters`, exports.NAMESPACE_PROJECT);
+exports.presentationDesignParametersBucketId = presentationDesignParametersBucketId;
 /**
  * Deterministic refKey for a `<Component> Folder` template emitted when
  * a `ComponentTemplateRecipe` declares `children:`. The Sitecore item
@@ -368,6 +378,15 @@ exports.componentFolderStandardValuesId = componentFolderStandardValuesId;
  */
 const contentModelsGroupFolderId = (site, group) => (0, uuid_1.v5)(`${site}:Content Models:${group}`, exports.NAMESPACE_PROJECT);
 exports.contentModelsGroupFolderId = contentModelsGroupFolderId;
+/**
+ * Deterministic refKey for a page-template group folder under a site's
+ * `<pageTemplatesRoot>/<group>/`. Materialised once via a CreateOnly
+ * CreateItem when any `PageTemplateRecipe` in the set carries
+ * `meta.tax.group` matching this name. Same identity family as
+ * `contentModelsGroupFolderId` — a site-owned organisational folder.
+ */
+const pageTemplatesGroupFolderId = (site, group) => (0, uuid_1.v5)(`${site}:Page Templates:${group}`, exports.NAMESPACE_PROJECT);
+exports.pageTemplatesGroupFolderId = pageTemplatesGroupFolderId;
 /**
  * Per-site shared Data Folder under `<contentItemsRoot>/<subfolder>`.
  * Emitted as a CreateOnly item by `compileComponentTemplateRecipe` when
@@ -486,3 +505,95 @@ exports.enumerationsFolderTemplateStandardValuesId = enumerationsFolderTemplateS
 exports.NAMESPACE_SECTION_DEFINITION = (0, uuid_1.v5)("section-definition", exports.NAMESPACE_ROOT);
 const sectionDefinitionId = (handle) => (0, uuid_1.v5)(handle, exports.NAMESPACE_SECTION_DEFINITION);
 exports.sectionDefinitionId = sectionDefinitionId;
+/**
+ * Placeholder Settings item identity.
+ *
+ * A Placeholder Settings item is the gate for "what renderings can be
+ * dropped into this slot" — it carries a `Placeholder Key` and an
+ * `Allowed Controls` whitelist. Its identity is the **placeholder key**,
+ * not a recipe handle: one key = one settings item. A standalone
+ * `PlaceholderRecipe` and an inline `ComponentTemplateRecipe.placeholders`
+ * entry that name the same key therefore derive the *same* GUID — which
+ * is correct (they describe the same Sitecore item) and lets the
+ * cross-recipe validator flag the ambiguous double-declaration.
+ *
+ * Site-scoped like the rest of the per-Project item family, so the same
+ * recipe set pushed to two sites yields two distinct Placeholder
+ * Settings items under each site's Presentation tree.
+ */
+exports.NAMESPACE_PLACEHOLDER = (0, uuid_1.v5)("placeholder", exports.NAMESPACE_ROOT);
+const placeholderSettingsId = (site, key) => (0, uuid_1.v5)(`${site}::${key}`, exports.NAMESPACE_PLACEHOLDER);
+exports.placeholderSettingsId = placeholderSettingsId;
+/**
+ * Deterministic refKey for one segment of a placeholder `folder`
+ * grouping path under `<placeholderSettingsRoot>/<…segments…>`. Conforms
+ * to the SXA `Placeholder Settings Folder` template. Site-scoped + keyed
+ * on the segment's CUMULATIVE path so two recipes naming the same folder
+ * (`"Partial Design/Header"`) reuse the `Partial Design` and
+ * `Partial Design/Header` folders rather than colliding — pass the
+ * cumulative path, not the leaf segment.
+ *
+ * Same `NAMESPACE_PROJECT` "site organisational folder" family as
+ * section folders and the enumeration grouping folders.
+ */
+const placeholderSettingsFolderId = (site, cumulativePath) => (0, uuid_1.v5)(`${site}:Placeholder Settings:${cumulativePath}`, exports.NAMESPACE_PROJECT);
+exports.placeholderSettingsFolderId = placeholderSettingsFolderId;
+/**
+ * Deterministic refKey for a system template referenced by content-tree
+ * path (workflow/webhook/etc. system templates whose GUIDs aren't
+ * published). Same identity for the same path forever — the push
+ * pipeline seeds `crossRecipeRefs[<this refKey>] = path`; the executor
+ * batches a single `getItemsByPaths` lookup and the planner resolves
+ * `templateOf: ref-path` ops through the existing `capturedItemIds`
+ * map.
+ */
+exports.NAMESPACE_TEMPLATE_BY_PATH = (0, uuid_1.v5)("template-by-path", exports.NAMESPACE_ROOT);
+const templatePathRefKey = (path) => (0, uuid_1.v5)(path, exports.NAMESPACE_TEMPLATE_BY_PATH);
+exports.templatePathRefKey = templatePathRefKey;
+/**
+ * Deterministic refKey for the `__Standard Values` item under a
+ * tenant-existing template referenced by content-tree path. Used by
+ * `WorkflowRecipe.bindings.templates` entries that point at an absolute
+ * template path (not an intra-recipe handle): the compiler emits a
+ * `SetField` op with `latePath: "<templatePath>/__Standard Values"`,
+ * and the executor's late-path resolution walks the path to seed the
+ * captured-itemId map before planning the field write. Same identity
+ * for the same path forever.
+ */
+exports.NAMESPACE_STANDARD_VALUES_BY_PATH = (0, uuid_1.v5)("standard-values-by-path", exports.NAMESPACE_ROOT);
+const standardValuesPathRefKey = (templatePath) => (0, uuid_1.v5)(templatePath, exports.NAMESPACE_STANDARD_VALUES_BY_PATH);
+exports.standardValuesPathRefKey = standardValuesPathRefKey;
+/**
+ * Workflow recipe identities.
+ *
+ * Workflows live at `/sitecore/system/Workflows/[<group>/]<name>` and
+ * are tenant-wide (not site-scoped), so GUIDs derive from the recipe
+ * handle directly. Sub-items (states, commands, actions) nest under
+ * the workflow's GUID to keep the hierarchy stable across renames at
+ * deeper levels.
+ */
+exports.NAMESPACE_WORKFLOW = (0, uuid_1.v5)("workflow", exports.NAMESPACE_ROOT);
+const workflowId = (handle) => (0, uuid_1.v5)(handle, exports.NAMESPACE_WORKFLOW);
+exports.workflowId = workflowId;
+const workflowStateId = (handle, stateKey) => (0, uuid_1.v5)(`state:${stateKey}`, (0, exports.workflowId)(handle));
+exports.workflowStateId = workflowStateId;
+const workflowCommandId = (handle, stateKey, commandKey) => (0, uuid_1.v5)(`command:${commandKey}`, (0, exports.workflowStateId)(handle, stateKey));
+exports.workflowCommandId = workflowCommandId;
+/** Webhook submit/validation action under a workflow STATE's `Actions` folder. */
+const workflowStateActionId = (handle, stateKey, index) => (0, uuid_1.v5)(`action:${index}`, (0, exports.workflowStateId)(handle, stateKey));
+exports.workflowStateActionId = workflowStateActionId;
+/** Webhook validation action under a workflow COMMAND's `Actions` folder. */
+const workflowCommandValidationId = (handle, stateKey, commandKey, index) => (0, uuid_1.v5)(`validation:${index}`, (0, exports.workflowCommandId)(handle, stateKey, commandKey));
+exports.workflowCommandValidationId = workflowCommandValidationId;
+/** Workflow group folder under /sitecore/system/Workflows (when meta.tax.group is set). */
+const workflowGroupFolderId = (group) => (0, uuid_1.v5)(`group:${group}`, exports.NAMESPACE_WORKFLOW);
+exports.workflowGroupFolderId = workflowGroupFolderId;
+/**
+ * Webhook Authorization recipe identity. Items live at
+ * `/sitecore/system/Settings/Webhooks/Authorizations/<name>` — flat,
+ * tenant-wide. Used by workflow webhook actions + event handlers to
+ * carry credentials.
+ */
+exports.NAMESPACE_WEBHOOK_AUTHORIZATION = (0, uuid_1.v5)("webhook-authorization", exports.NAMESPACE_ROOT);
+const webhookAuthorizationId = (handle) => (0, uuid_1.v5)(handle, exports.NAMESPACE_WEBHOOK_AUTHORIZATION);
+exports.webhookAuthorizationId = webhookAuthorizationId;

package/dist/recipe/index.d.ts

@@ -10,14 +10,18 @@
  * Stability contract: the surface in this file is the public contract.
  * Anything not exported here is internal and may move between scai
  * versions without notice.
+ *
+ * The recipe composition kinds (`ContentItem`, `PageDesign`, `PartialDesign`,
+ * `SiteRecipe`, `SiteTemplate`) are NOT part of the 0.1.0 stability promise
+ * and live on the separate `./recipe/unstable` entry (`src/recipe/unstable.ts`).
  */
-export { ComponentPlacementSchema, ComponentTemplateRecipeSchema, ContentFieldValueSchema, ContentItemRecipeSchema, ContentTemplateRecipeSchema, FieldDefinitionSchema, LayoutSchema, PageDesignRecipeSchema, ParamDefinitionSchema, ParametersTemplateRecipeSchema, PartialDesignRecipeSchema, PlaceholderDefinitionSchema, RecipeMetaSchema, RecipeSchema, RecipeDatasourceSchema, RenderingDatasourceLocationSchema, RenderingVariantDefinitionSchema, SectionDefinitionRecipeSchema, SiteGroupingSchema, SiteRecipeSchema, SiteTemplateDictionaryEntrySchema, SiteTemplateRecipeSchema, SiteTemplateTaxonomyEntrySchema, SitecoreFieldAugmentSchema, type ComponentPlacement, type ComponentTemplateRecipe, type ContentFieldValue, type ContentItemRecipe, type ContentTemplateRecipe, type FieldDefinition, type Layout, type PageDesignRecipe, type ParamDefinition, type ParametersTemplateRecipe, type PartialDesignRecipe, type PlaceholderDefinition, type Recipe, type RecipeMeta, type RecipeDatasource, type RenderingDatasourceLocation, type RenderingVariantDefinition, type SectionDefinitionRecipe, type SiteGrouping, type SiteRecipe, type SiteTemplateDictionaryEntry, type SiteTemplateRecipe, type SiteTemplateTaxonomyEntry, type SitecoreFieldAugment, } from "./schema/recipe";
+export { ComponentPlacementSchema, ComponentTemplateRecipeSchema, ContentFieldValueSchema, ContentTemplateRecipeSchema, FieldDefinitionSchema, LayoutSchema, PageRecipeSchema, PageTemplateRecipeSchema, DesignParameterSchema, DesignParametersTemplateRecipeSchema, PlaceholderDefinitionSchema, PlaceholderRecipeSchema, RecipeMetaSchema, RecipeSchema, RecipeDatasourceSchema, RenderingDatasourceLocationSchema, RenderingVariantDefinitionSchema, SectionDefinitionRecipeSchema, SitecoreFieldAugmentSchema, type ComponentPlacement, type ComponentTemplateRecipe, type ContentFieldValue, type ContentTemplateRecipe, type FieldDefinition, type Layout, type PageRecipe, type PageTemplateRecipe, type DesignParameter, type DesignParametersTemplateRecipe, type PlaceholderDefinition, type PlaceholderRecipe, type Recipe, type RecipeMeta, type RecipeDatasource, type RenderingDatasourceLocation, type RenderingVariantDefinition, type SectionDefinitionRecipe, type SitecoreFieldAugment, } from "./schema/recipe";
 export { FIELD_SHAPES, FieldShapeSchema, SITECORE_FIELD_TYPES, SitecoreFieldTypeSchema, defaultSitecoreFieldType, sitecoreFieldTypeLabel, type FieldShape, type SitecoreFieldType, } from "./schema/field-types";
-export { compileComponentTemplateRecipe, compileContentItemRecipe, compileContentTemplateRecipe, compilePageDesignRecipe, compileParametersTemplateRecipe, compilePartialDesignRecipe, compileRecipe, compileRecipeSet, compileSectionDefinitionRecipe, compileSiteRecipe, compileSiteTemplateRecipe, TEMPLATES_MAPPING_AGGREGATE_HANDLE, type CompileContext, } from "./compile";
+export { compileComponentTemplateRecipe, compileContentTemplateRecipe, compilePageTemplateRecipe, compilePageRecipe, compilePlaceholderRecipe, compileDesignParametersTemplateRecipe, compileRecipe, compileRecipeSet, compileSectionDefinitionRecipe, PLACEHOLDER_SETTINGS_AGGREGATE_HANDLE, TEMPLATES_MAPPING_AGGREGATE_HANDLE, type CompileContext, } from "./compile";
 export { emitLayoutXml } from "./layout/emit";
 export type { ComponentPlacementInput, LayoutEmitContext, LayoutInput } from "./layout/emit";
 export { encodeTemplatesMapping, type TemplatesMappingEntry } from "./layout/templates-mapping";
-export { NAMESPACE_CONTENT_ITEM, NAMESPACE_PAGE_DESIGN, NAMESPACE_PARTIAL_DESIGN, NAMESPACE_PROJECT, NAMESPACE_RENDERING, NAMESPACE_ROOT, NAMESPACE_SECTION_DEFINITION, NAMESPACE_SITE_BRANCH, NAMESPACE_TEMPLATE, PAGE_DESIGNS_ROOT_REF_KEY, componentFolderStandardValuesId, componentFolderTemplateId, componentFoldersBucketId, contentItemId, contentModelsGroupFolderId, datasourceId, fieldId, pageDesignId, paramsFieldId, paramsSectionId, paramsTemplateId, partialDesignId, presentationParametersBucketId, renderingId, renderingsSectionFolderId, sectionDefinitionId, sectionFolderId, sectionId, siteBranchId, siteDataFolderId, standardValuesId, templateId, variantId, variantsFolderId, } from "./guids";
+export { NAMESPACE_CONTENT_ITEM, NAMESPACE_PAGE, NAMESPACE_PAGE_DESIGN, NAMESPACE_PARTIAL_DESIGN, NAMESPACE_PLACEHOLDER, NAMESPACE_PROJECT, NAMESPACE_RENDERING, NAMESPACE_ROOT, NAMESPACE_SECTION_DEFINITION, NAMESPACE_SITE_BRANCH, NAMESPACE_TEMPLATE, PAGE_DESIGNS_ROOT_REF_KEY, componentFolderStandardValuesId, componentFolderTemplateId, componentFoldersBucketId, contentItemId, contentModelsGroupFolderId, datasourceId, fieldId, pageDesignId, pageItemId, pageTemplatesGroupFolderId, placeholderSettingsId, designParameterFieldId, designParametersSectionId, designParametersTemplateId, partialDesignId, presentationDesignParametersBucketId, renderingId, renderingsSectionFolderId, sectionDefinitionId, sectionFolderId, sectionId, siteBranchId, siteDataFolderId, standardValuesId, templateId, variantId, variantsFolderId, } from "./guids";
 export { AppendToMultiListOpSchema, CreateItemOpSchema, FieldValueSchema, OperationIrSchema, OperationSchema, PushPolicySchema, RefValueSchema, SetBaseTemplatesOpSchema, SetFieldOpSchema, SetStandardValuesOpSchema, type AppendToMultiListOp, type CreateItemOp, type FieldValue, type Operation, type OperationIr, type PushPolicy, type RefValue, type SetBaseTemplatesOp, type SetFieldOp, type SetStandardValuesOp, } from "./ir/operations";
 export { COMPOSITION_FIELDS, DEFAULT_DEVICE_ID, DEFAULT_ICON, DEFAULT_LANGUAGE, DEFAULT_VERSION, LAYOUT_FIELDS, RENDERING_FIELDS, SECTION_DEFINITION_FIELDS, SITE_FIELDS, SITE_TEMPLATE_FIELDS, SITECORE_TEMPLATES, STANDARD_TEMPLATE_ID, SYSTEM_FIELDS, TEMPLATE_FIELD_FIELDS, } from "./ir/sitecore-templates";
 export { buildPlan } from "./plan";
@@ -25,8 +29,10 @@ export type { FieldDiffEntry, Plan, PlanEvent, PlanOptions, PlanSummary, Planned
 export { executeIr } from "./execute";
 export type { ExecuteOptions, ExecutionEvent, ExecutionMode, ExecutionResult } from "./execute";
 export type { AuthoringApiClient, CreateItemInput, RemoteFieldValue, RemoteItem, UpdateItemInput, } from "./api/client";
+export { createAuthoringClient, type AuthoringClientOptions } from "./api/authoring-client";
+export { runAuthoringGraphQL, type AuthoringRequestOptions } from "./api/graphql";
+export { createSitesApiClient, type SitesApiClient, type Job, type JobResponse, type Language, type NewSiteInput, type Site, type SiteCollection, type SiteTemplate, } from "./api/sites-client";
 export { renderRefValue } from "./api/ref-encoding";
 export { renderSourceFields, sourceFieldsNeedHandleResolution, type SourceFields, } from "./schema/source-fields";
 export { defaultPolicyForRecipe, policyFor, policyForOp, purposeForRecipe, type OpPurpose, } from "./policy";
-export { formatValidationErrors, isValid, validateRecipeSet, validateRecipeSetOrThrow, type CyclicReference, type DuplicateHandle, type FieldShapeError, type RecipeKind, type UnresolvedHandle, type ValidationResult, } from "./validate";
-//# sourceMappingURL=index.d.ts.map
+export { formatValidationErrors, isValid, validateRecipeSet, validateRecipeSetOrThrow, type CyclicReference, type DuplicateHandle, type FieldShapeError, type PlacementViolation, type RecipeKind, type UnresolvedHandle, type ValidationResult, } from "./validate";