@uniformdev/canvas 20.72.2-alpha.3 → 20.72.3-alpha.14

package/dist/index.js

@@ -45,7 +45,7 @@ __export(index_exports, {
   ATTRIBUTE_PARAMETER_TYPE: () => ATTRIBUTE_PARAMETER_TYPE,
   ATTRIBUTE_PARAMETER_VALUE: () => ATTRIBUTE_PARAMETER_VALUE,
   ATTRIBUTE_PLACEHOLDER: () => ATTRIBUTE_PLACEHOLDER,
-  ApiClientError: () => import_api19.ApiClientError,
+  ApiClientError: () => import_api28.ApiClientError,
   BatchEntry: () => BatchEntry,
   BlockFormatError: () => BlockFormatError,
   CANVAS_BLOCK_PARAM_TYPE: () => CANVAS_BLOCK_PARAM_TYPE,
@@ -87,7 +87,11 @@ __export(index_exports, {
   CanvasClientError: () => CanvasClientError,
   CategoryClient: () => CategoryClient,
   ChildEnhancerBuilder: () => ChildEnhancerBuilder,
+  ComponentDefinitionClient: () => ComponentDefinitionClient,
+  CompositionDeliveryClient: () => CompositionDeliveryClient,
+  CompositionManagementClient: () => CompositionManagementClient,
   ContentClient: () => ContentClient,
+  ContentTypeClient: () => ContentTypeClient,
   DataSourceClient: () => DataSourceClient,
   DataTypeClient: () => DataTypeClient,
   EDGE_CACHE_DISABLED: () => EDGE_CACHE_DISABLED,
@@ -97,6 +101,8 @@ __export(index_exports, {
   EMPTY_COMPOSITION: () => EMPTY_COMPOSITION,
   EnhancerBuilder: () => EnhancerBuilder,
   EntityReleasesClient: () => EntityReleasesClient,
+  EntryDeliveryClient: () => EntryDeliveryClient,
+  EntryManagementClient: () => EntryManagementClient,
   IN_CONTEXT_EDITOR_COMPONENT_END_ROLE: () => IN_CONTEXT_EDITOR_COMPONENT_END_ROLE,
   IN_CONTEXT_EDITOR_COMPONENT_START_ROLE: () => IN_CONTEXT_EDITOR_COMPONENT_START_ROLE,
   IN_CONTEXT_EDITOR_CONFIG_CHECK_QUERY_STRING_PARAM: () => IN_CONTEXT_EDITOR_CONFIG_CHECK_QUERY_STRING_PARAM,
@@ -109,6 +115,7 @@ __export(index_exports, {
   LOCALE_DYNAMIC_INPUT_NAME: () => LOCALE_DYNAMIC_INPUT_NAME,
   LabelClient: () => LabelClient,
   LocaleClient: () => LocaleClient,
+  NotificationsClient: () => NotificationsClient,
   PLACEHOLDER_ID: () => PLACEHOLDER_ID,
   PreviewClient: () => PreviewClient,
   ProjectClient: () => ProjectClient,
@@ -214,7 +221,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/CanvasClient.ts
+// src/CategoryClient.ts
 var import_api2 = require("@uniformdev/context/api");
 
 // src/enhancement/createLimitPolicy.ts
@@ -258,6 +265,129 @@ function createLimitPolicy({
 }
 var nullLimitPolicy = async (func) => await func();
 
+// src/CategoryClient.ts
+var CATEGORIES_URL = "/api/v1/categories";
+var CategoryClient = class extends import_api2.ApiClient {
+  constructor(options) {
+    if (!options.limitPolicy) {
+      options.limitPolicy = createLimitPolicy({});
+    }
+    super(options);
+  }
+  /** Fetches a list of categories created in given project */
+  async list(options) {
+    const { projectId } = this.options;
+    const fetchUri = this.createUrl("/api/v1/categories", { ...options, projectId });
+    return await this.apiClient(fetchUri);
+  }
+  /** @deprecated Use {@link list} instead. */
+  async getCategories(options) {
+    return this.list(options);
+  }
+  /** Updates or creates a category, also used to re-order them */
+  async save(categories) {
+    const { projectId } = this.options;
+    const fetchUri = this.createUrl(CATEGORIES_URL);
+    return await this.apiClient(fetchUri, {
+      method: "PUT",
+      body: JSON.stringify({ categories, projectId }),
+      expectNoContent: true
+    });
+  }
+  /** @deprecated Use {@link save} instead. */
+  async upsertCategories(categories) {
+    return this.save(categories);
+  }
+  /** Deletes a category */
+  async remove(options) {
+    const { projectId } = this.options;
+    const fetchUri = this.createUrl(CATEGORIES_URL);
+    return await this.apiClient(fetchUri, {
+      method: "DELETE",
+      body: JSON.stringify({ projectId, categoryId: options.categoryId }),
+      expectNoContent: true
+    });
+  }
+  /** @deprecated Use {@link remove} instead. */
+  async removeCategory(options) {
+    return this.remove(options);
+  }
+};
+var UncachedCategoryClient = class extends CategoryClient {
+  constructor(options) {
+    super({ ...options, bypassCache: true });
+  }
+};
+
+// src/clients/ComponentDefinitionClient.ts
+var import_api4 = require("@uniformdev/context/api");
+
+// src/clients/ContentClientBase.ts
+var import_api3 = require("@uniformdev/context/api");
+var CANONICAL_FORMAT = "canonical";
+var ContentClientBase = class extends import_api3.ApiClient {
+  constructor(options, defaultBypassCache) {
+    var _a, _b;
+    super({
+      ...options,
+      limitPolicy: (_a = options.limitPolicy) != null ? _a : createLimitPolicy({}),
+      bypassCache: (_b = options.bypassCache) != null ? _b : defaultBypassCache
+    });
+  }
+};
+
+// src/clients/ComponentDefinitionClient.ts
+var DEFINITIONS_URL = "/api/v1/canvas-definitions";
+var ComponentDefinitionClient = class extends ContentClientBase {
+  constructor(options) {
+    super(
+      options,
+      /* defaultBypassCache */
+      true
+    );
+  }
+  /** Fetches one component definition by id (throws `ApiClientError(404)` if absent). */
+  async get(args) {
+    var _a;
+    const url = this.createUrl(DEFINITIONS_URL, {
+      componentId: args.componentId,
+      projectId: this.options.projectId
+    });
+    const res = await this.apiClient(url);
+    const definition = (_a = res.componentDefinitions) == null ? void 0 : _a[0];
+    if (!definition) {
+      throw new import_api4.ApiClientError("Component definition not found", "GET", url.toString(), 404, "Not Found");
+    }
+    return definition;
+  }
+  /** Fetches a list of component definitions. */
+  list(args) {
+    const url = this.createUrl(DEFINITIONS_URL, { ...args, projectId: this.options.projectId });
+    return this.apiClient(url);
+  }
+  /** Creates or updates a component definition. */
+  async save(def) {
+    const url = this.createUrl(DEFINITIONS_URL);
+    await this.apiClient(url, {
+      method: "PUT",
+      body: JSON.stringify({ ...def, projectId: this.options.projectId }),
+      expectNoContent: true
+    });
+  }
+  /** Deletes a component definition. */
+  async remove(args) {
+    const url = this.createUrl(DEFINITIONS_URL);
+    await this.apiClient(url, {
+      method: "DELETE",
+      body: JSON.stringify({ ...args, projectId: this.options.projectId }),
+      expectNoContent: true
+    });
+  }
+};
+
+// src/clients/CompositionDeliveryClient.ts
+var import_api5 = require("@uniformdev/context/api");
+
 // src/projection/types.ts
 var SELECT_QUERY_PREFIX = "select.";
 
@@ -306,9 +436,529 @@ function projectionToQuery(spec) {
   return out;
 }
 
-// src/CanvasClient.ts
+// src/utils/constants.ts
+var CANVAS_PERSONALIZE_TYPE = "$personalization";
+var CANVAS_TEST_TYPE = "$test";
+var CANVAS_LOCALIZATION_TYPE = "$localization";
+var CANVAS_SLOT_SECTION_TYPE = "$slotSection";
+var CANVAS_INTENT_TAG_PARAM = "intentTag";
+var CANVAS_LOCALE_TAG_PARAM = "locale";
+var CANVAS_BLOCK_PARAM_TYPE = "$block";
+var CANVAS_PERSONALIZE_SLOT = "pz";
+var CANVAS_TEST_SLOT = "test";
+var CANVAS_LOCALIZATION_SLOT = "localized";
+var CANVAS_SLOT_SECTION_SLOT = "$slotSectionItems";
+var CANVAS_SLOT_SECTION_NAME_PARAM = "name";
+var CANVAS_SLOT_SECTION_MIN_PARAM = "min";
+var CANVAS_SLOT_SECTION_MAX_PARAM = "max";
+var CANVAS_SLOT_SECTION_GROUP_TYPE_PARAM = "groupType";
+var CANVAS_SLOT_SECTION_SPECIFIC_PARAM = "specific";
+var CANVAS_DRAFT_STATE = 0;
+var CANVAS_PUBLISHED_STATE = 64;
+var CANVAS_EDITOR_STATE = 63;
+var CANVAS_PERSONALIZATION_PARAM = "$pzCrit";
+var CANVAS_PERSONALIZATION_EVENT_NAME_PARAM = "trackingEventName";
+var CANVAS_PERSONALIZATION_ALGORITHM_PARAM = "algorithm";
+var CANVAS_PERSONALIZATION_ALGORITHM_TYPE = "pzAlgorithm";
+var CANVAS_PERSONALIZATION_TAKE_PARAM = "count";
+var CANVAS_TEST_VARIANT_PARAM = "$tstVrnt";
+var CANVAS_ENRICHMENT_TAG_PARAM = "$enr";
+var CANVAS_INTERNAL_PARAM_PREFIX = "$internal_";
+var CANVAS_COMPONENT_DISPLAY_NAME_PARAM = `${CANVAS_INTERNAL_PARAM_PREFIX}displayName`;
+var CANVAS_HYPOTHESIS_PARAM = `${CANVAS_INTERNAL_PARAM_PREFIX}hypothesis`;
+var CANVAS_CONTEXTUAL_EDITING_PARAM = "$contextualEditing";
+var SECRET_QUERY_STRING_PARAM = "secret";
+var IN_CONTEXT_EDITOR_QUERY_STRING_PARAM = "is_incontext_editing_mode";
+var IN_CONTEXT_EDITOR_PLAYGROUND_QUERY_STRING_PARAM = "is_incontext_editing_playground";
+var IN_CONTEXT_EDITOR_FORCED_SETTINGS_QUERY_STRING_PARAM = "is_incontext_editing_forced_settings";
+var IN_CONTEXT_EDITOR_CONFIG_CHECK_QUERY_STRING_PARAM = "is_config_check";
+var IN_CONTEXT_EDITOR_COMPONENT_START_ROLE = "uniform-component-start";
+var IN_CONTEXT_EDITOR_COMPONENT_END_ROLE = "uniform-component-end";
+var IN_CONTEXT_EDITOR_EMBED_SCRIPT_ID = "uniform-canvas-preview-script";
+var IS_RENDERED_BY_UNIFORM_ATTRIBUTE = "data-is-rendered-by-uniform";
+var PLACEHOLDER_ID = "placeholder";
+var EMPTY_COMPOSITION = {
+  _id: "_empty_composition_id",
+  _name: "An empty composition used for contextual editing",
+  type: "_empty_composition_type"
+};
+var EDGE_MIN_CACHE_TTL = 10;
+var EDGE_MAX_CACHE_TTL = 24 * 60 * 60;
+var EDGE_DEFAULT_CACHE_TTL = 30;
+var EDGE_CACHE_DISABLED = -1;
+var ASSET_PARAMETER_TYPE = "asset";
+var ASSETS_SOURCE_UNIFORM = "uniform-assets";
+var ASSETS_SOURCE_CUSTOM_URL = "custom-url";
+var REFERENCE_DATA_TYPE_ID = "uniformContentInternalReference";
+
+// src/clients/compositionHelpers.ts
+function resolveCompositionSelector(args) {
+  if ("compositionId" in args) {
+    const { compositionId, editionId, versionId, ...readOptions } = args;
+    return {
+      readOptions,
+      // raw mode matches on composition OR edition id via the compositionId param
+      compositionId: editionId != null ? editionId : compositionId,
+      versionId,
+      hasCompositionId: true,
+      pinnedEdition: editionId !== void 0
+    };
+  }
+  return { readOptions: args, hasCompositionId: false, pinnedEdition: false };
+}
+
+// src/clients/DeliveryClientBase.ts
+var DEFAULT_EDGE_API_HOST = "https://uniform.global";
+var DeliveryClientBase = class extends ContentClientBase {
+  constructor(options) {
+    var _a;
+    super(
+      options,
+      /* defaultBypassCache */
+      false
+    );
+    this.edgeApiHost = (_a = options.edgeApiHost) != null ? _a : DEFAULT_EDGE_API_HOST;
+    this.edgeRequestInit = options.disableSWR ? { headers: { "x-disable-swr": "true" } } : void 0;
+  }
+  /** Coerces the `diagnostics` option into the shape the edge endpoints accept. */
+  coerceDiagnostics(diagnostics) {
+    return typeof diagnostics === "boolean" ? diagnostics : diagnostics === "no-data" ? "no-data" : void 0;
+  }
+};
+
+// src/clients/CompositionDeliveryClient.ts
+var EDGE_SINGLE_URL = "/api/v1/composition";
+var EDGE_LIST_URL = "/api/v1/compositions";
+var CompositionDeliveryClient = class extends DeliveryClientBase {
+  constructor(options) {
+    super(options);
+  }
+  /** Fetches exactly one composition (throws `ApiClientError(404)` if absent). */
+  get(args) {
+    var _a;
+    const { diagnostics, select, ...rest } = args;
+    const { readOptions, compositionId, versionId, pinnedEdition } = resolveCompositionSelector(rest);
+    const url = this.createUrl(
+      EDGE_SINGLE_URL,
+      {
+        ...readOptions,
+        ...projectionToQuery(select),
+        // A pinned edition is folded into compositionId (raw matches edition or
+        // composition id); there is no editionId query param on this endpoint.
+        compositionId,
+        versionId,
+        projectId: this.options.projectId,
+        state: (_a = args.state) != null ? _a : CANVAS_PUBLISHED_STATE,
+        // editionId pins a specific edition for preview; otherwise locale-best.
+        editions: pinnedEdition ? "raw" : "auto",
+        diagnostics: this.coerceDiagnostics(diagnostics)
+      },
+      this.edgeApiHost
+    );
+    return this.apiClient(url, this.edgeRequestInit);
+  }
+  /** Fetches a list of compositions, optionally filtered. */
+  list(args = {}) {
+    var _a;
+    const { diagnostics, filters, select, ...rest } = args;
+    const url = this.createUrl(
+      EDGE_LIST_URL,
+      {
+        ...rest,
+        ...(0, import_api5.rewriteFiltersForApi)(filters),
+        ...projectionToQuery(select),
+        projectId: this.options.projectId,
+        state: (_a = args.state) != null ? _a : CANVAS_PUBLISHED_STATE,
+        diagnostics: this.coerceDiagnostics(diagnostics)
+      },
+      this.edgeApiHost
+    );
+    return this.apiClient(url, this.edgeRequestInit);
+  }
+};
+
+// src/clients/CompositionManagementClient.ts
+var import_api6 = require("@uniformdev/context/api");
+
+// src/clients/resolveManagementEditions.ts
+function resolveManagementEditions({
+  explicit,
+  pinnedEdition,
+  hasId,
+  hasLocale
+}) {
+  if (explicit) {
+    return explicit;
+  }
+  if (pinnedEdition) {
+    return "raw";
+  }
+  if (!hasId) {
+    return void 0;
+  }
+  return hasLocale ? "auto" : "raw";
+}
+
+// src/clients/CompositionManagementClient.ts
 var CANVAS_URL = "/api/v1/canvas";
-var CanvasClient = class extends import_api2.ApiClient {
+var CANVAS_HISTORY_URL = "/api/v1/canvas-history";
+var CompositionManagementClient = class extends ContentClientBase {
+  constructor(options) {
+    super(
+      options,
+      /* defaultBypassCache */
+      true
+    );
+  }
+  /**
+   * Fetches one composition in canonical shape (throws `ApiClientError(404)` if
+   * absent).
+   */
+  get(args) {
+    var _a;
+    const { select, ...selectorArgs } = args;
+    const { readOptions, compositionId, versionId, hasCompositionId, pinnedEdition } = resolveCompositionSelector(selectorArgs);
+    const url = this.createUrl(CANVAS_URL, {
+      format: CANONICAL_FORMAT,
+      // Caller-supplied shaping flags and non-id selector keys ride along and
+      // override the format alias server-side.
+      ...readOptions,
+      ...projectionToQuery(select),
+      // A pinned edition is folded into compositionId; there is no editionId
+      // query param on this endpoint.
+      compositionId,
+      versionId,
+      projectId: this.options.projectId,
+      state: (_a = args.state) != null ? _a : CANVAS_DRAFT_STATE,
+      editions: resolveManagementEditions({
+        explicit: readOptions.editions,
+        pinnedEdition,
+        hasId: hasCompositionId,
+        hasLocale: readOptions.locale != null
+      })
+    });
+    return this.apiClient(url);
+  }
+  /** Fetches a list of compositions in canonical shape. */
+  list(args = {}) {
+    var _a;
+    const { filters, select, ...rest } = args;
+    const url = this.createUrl(CANVAS_URL, {
+      format: CANONICAL_FORMAT,
+      ...rest,
+      ...(0, import_api6.rewriteFiltersForApi)(filters),
+      ...projectionToQuery(select),
+      projectId: this.options.projectId,
+      state: (_a = args.state) != null ? _a : CANVAS_DRAFT_STATE
+    });
+    return this.apiClient(url);
+  }
+  /** Creates or updates a composition. Returns the new `x-modified-at` timestamp. */
+  async save(body, opts) {
+    const url = this.createUrl(CANVAS_URL);
+    const headers = {};
+    if (opts == null ? void 0 : opts.ifUnmodifiedSince) {
+      headers["x-if-unmodified-since"] = opts.ifUnmodifiedSince;
+    }
+    const { response } = await this.apiClientWithResponse(url, {
+      method: "PUT",
+      body: JSON.stringify({ ...body, projectId: this.options.projectId }),
+      expectNoContent: true,
+      headers
+    });
+    return { modified: response.headers.get("x-modified-at") };
+  }
+  /**
+   * Saves the draft and publishes in one call (two PUTs). The optimistic
+   * concurrency guard, if any, applies to the draft write.
+   */
+  async saveAndPublish(body, opts) {
+    await this.save({ ...body, state: CANVAS_DRAFT_STATE }, opts);
+    return this.save({ ...body, state: CANVAS_PUBLISHED_STATE });
+  }
+  /**
+   * Removes only the published state, leaving the draft intact. Scoped to a
+   * single edition when `editionId` is supplied; otherwise unpublishes all editions.
+   * To unpublish only the base edition, pass editionId and compositionId as the same value.
+   */
+  async unpublish(selector) {
+    await this.deleteComposition({ ...selector, state: CANVAS_PUBLISHED_STATE });
+  }
+  /**
+   * Deletes across all states. Scoped to a single edition when `editionId` is
+   * supplied; otherwise deletes all states and editions.
+   * Use `unpublish` to drop only the published state.
+   */
+  async remove(selector) {
+    await this.deleteComposition(selector);
+  }
+  /** Fetches historical versions of a composition or pattern. */
+  history(args) {
+    const url = this.createUrl(CANVAS_HISTORY_URL, { ...args, projectId: this.options.projectId });
+    return this.apiClient(url);
+  }
+  async deleteComposition(body) {
+    const url = this.createUrl(CANVAS_URL);
+    await this.apiClient(url, {
+      method: "DELETE",
+      body: JSON.stringify({ ...body, projectId: this.options.projectId }),
+      expectNoContent: true
+    });
+  }
+};
+
+// src/clients/ContentTypeClient.ts
+var import_api7 = require("@uniformdev/context/api");
+var CONTENT_TYPES_URL = "/api/v1/content-types";
+var ContentTypeClient = class extends ContentClientBase {
+  constructor(options) {
+    super(
+      options,
+      /* defaultBypassCache */
+      true
+    );
+  }
+  /** Fetches one content type by id (throws `ApiClientError(404)` if absent). */
+  async get(args) {
+    var _a;
+    const url = this.createUrl(CONTENT_TYPES_URL, {
+      contentTypeIDs: [args.contentTypeId],
+      limit: 1,
+      projectId: this.options.projectId
+    });
+    const res = await this.apiClient(url);
+    const contentType = (_a = res.contentTypes) == null ? void 0 : _a[0];
+    if (!contentType) {
+      throw new import_api7.ApiClientError("Content type not found", "GET", url.toString(), 404, "Not Found");
+    }
+    return contentType;
+  }
+  /** Fetches a list of content types. */
+  list(args) {
+    const url = this.createUrl(CONTENT_TYPES_URL, { ...args, projectId: this.options.projectId });
+    return this.apiClient(url);
+  }
+  /** Creates or updates a content type. */
+  async save(body, opts = {}) {
+    const url = this.createUrl(CONTENT_TYPES_URL);
+    let contentType = body.contentType;
+    if (typeof contentType.slugSettings === "object" && contentType.slugSettings !== null && Object.keys(contentType.slugSettings).length === 0) {
+      const { slugSettings: _omitEmptySlugSettings, ...rest } = contentType;
+      contentType = rest;
+    }
+    await this.apiClient(url, {
+      method: "PUT",
+      body: JSON.stringify({ ...body, contentType, projectId: this.options.projectId }),
+      expectNoContent: true,
+      headers: opts.autogenerateDataTypes ? { "x-uniform-autogenerate-data-types": "true" } : {}
+    });
+  }
+  /** Deletes a content type. */
+  async remove(args) {
+    const url = this.createUrl(CONTENT_TYPES_URL);
+    await this.apiClient(url, {
+      method: "DELETE",
+      body: JSON.stringify({ ...args, projectId: this.options.projectId }),
+      expectNoContent: true
+    });
+  }
+};
+
+// src/clients/EntryDeliveryClient.ts
+var import_api9 = require("@uniformdev/context/api");
+
+// src/clients/entryHelpers.ts
+var import_api8 = require("@uniformdev/context/api");
+function resolveEntrySelector(args) {
+  if ("entryId" in args) {
+    const { entryId, editionId, versionId, ...readOptions2 } = args;
+    return {
+      readOptions: readOptions2,
+      entryIDs: [editionId != null ? editionId : entryId],
+      versionId,
+      pinnedEdition: editionId !== void 0
+    };
+  }
+  const { slug, ...readOptions } = args;
+  return { readOptions, slug, pinnedEdition: false };
+}
+function unwrapSingleEntry(res, url) {
+  var _a;
+  const entry = (_a = res.entries) == null ? void 0 : _a[0];
+  if (!entry) {
+    throw new import_api8.ApiClientError("Entry not found", "GET", url.toString(), 404, "Not Found");
+  }
+  return entry;
+}
+
+// src/clients/EntryDeliveryClient.ts
+var ENTRIES_URL = "/api/v1/entries";
+var EntryDeliveryClient = class extends DeliveryClientBase {
+  constructor(options) {
+    super(options);
+  }
+  /** Fetches exactly one entry by id or slug (throws `ApiClientError(404)` if absent). */
+  async get(args) {
+    var _a, _b;
+    const { diagnostics, select, ...rest } = args;
+    const { entryIDs, slug, versionId, pinnedEdition, readOptions } = resolveEntrySelector(rest);
+    const url = this.createUrl(
+      ENTRIES_URL,
+      {
+        ...readOptions,
+        ...projectionToQuery(select),
+        projectId: this.options.projectId,
+        state: (_a = args.state) != null ? _a : CANVAS_PUBLISHED_STATE,
+        entryIDs,
+        slug,
+        versionId,
+        // A pinned edition is fetched exactly; otherwise locale-best.
+        editions: pinnedEdition ? "raw" : "auto",
+        // An id lookup wants that exact entity regardless of type, so default the
+        // pattern filter to 'any' (origin default `false` would 404 a pattern id).
+        // Scoped to id lookups; slug reads keep the origin default. Explicit
+        // `pattern` overrides via the `...readOptions` spread above.
+        pattern: (_b = args.pattern) != null ? _b : entryIDs ? "any" : void 0,
+        diagnostics: this.coerceDiagnostics(diagnostics)
+      },
+      this.edgeApiHost
+    );
+    const res = await this.apiClient(url, this.edgeRequestInit);
+    return unwrapSingleEntry(res, url);
+  }
+  /** Fetches a list of entries, optionally filtered. */
+  list(args = {}) {
+    var _a;
+    const { diagnostics, filters, select, ...rest } = args;
+    const url = this.createUrl(
+      ENTRIES_URL,
+      {
+        ...rest,
+        ...(0, import_api9.rewriteFiltersForApi)(filters),
+        ...projectionToQuery(select),
+        projectId: this.options.projectId,
+        state: (_a = args.state) != null ? _a : CANVAS_PUBLISHED_STATE,
+        diagnostics: this.coerceDiagnostics(diagnostics)
+      },
+      this.edgeApiHost
+    );
+    return this.apiClient(url, this.edgeRequestInit);
+  }
+};
+
+// src/clients/EntryManagementClient.ts
+var import_api10 = require("@uniformdev/context/api");
+var ENTRIES_URL2 = "/api/v1/entries";
+var ENTRIES_HISTORY_URL = "/api/v1/entries-history";
+var EntryManagementClient = class extends ContentClientBase {
+  constructor(options) {
+    super(
+      options,
+      /* defaultBypassCache */
+      true
+    );
+  }
+  /**
+   * Fetches one entry by id or slug in canonical shape (throws
+   * `ApiClientError(404)` if absent).
+   */
+  async get(args) {
+    var _a, _b;
+    const { select, ...selectorArgs } = args;
+    const { entryIDs, slug, versionId, readOptions, pinnedEdition } = resolveEntrySelector(selectorArgs);
+    const url = this.createUrl(ENTRIES_URL2, {
+      format: CANONICAL_FORMAT,
+      ...readOptions,
+      ...projectionToQuery(select),
+      projectId: this.options.projectId,
+      state: (_a = args.state) != null ? _a : CANVAS_DRAFT_STATE,
+      editions: resolveManagementEditions({
+        explicit: readOptions.editions,
+        pinnedEdition,
+        hasId: entryIDs != null,
+        hasLocale: readOptions.locale != null
+      }),
+      // An id lookup wants that exact entity regardless of type, so default the
+      // pattern filter to 'any' (origin default `false` would 404 a pattern id).
+      // Scoped to id lookups; slug reads keep the origin default. Explicit
+      // `pattern` overrides via the `...readOptions` spread above.
+      pattern: (_b = args.pattern) != null ? _b : entryIDs ? "any" : void 0,
+      entryIDs,
+      slug,
+      versionId
+    });
+    const res = await this.apiClient(url);
+    return unwrapSingleEntry(res, url);
+  }
+  /** Fetches a list of entries in canonical shape. */
+  list(args = {}) {
+    var _a;
+    const { filters, select, ...rest } = args;
+    const url = this.createUrl(ENTRIES_URL2, {
+      format: CANONICAL_FORMAT,
+      ...rest,
+      ...(0, import_api10.rewriteFiltersForApi)(filters),
+      ...projectionToQuery(select),
+      projectId: this.options.projectId,
+      state: (_a = args.state) != null ? _a : CANVAS_DRAFT_STATE
+    });
+    return this.apiClient(url);
+  }
+  /** Creates or updates an entry. Returns the new `x-modified-at` timestamp. */
+  async save(body, opts) {
+    const url = this.createUrl(ENTRIES_URL2);
+    const headers = {};
+    if (opts == null ? void 0 : opts.ifUnmodifiedSince) {
+      headers["x-if-unmodified-since"] = opts.ifUnmodifiedSince;
+    }
+    const { response } = await this.apiClientWithResponse(url, {
+      method: "PUT",
+      body: JSON.stringify({ ...body, projectId: this.options.projectId }),
+      expectNoContent: true,
+      headers
+    });
+    return { modified: response.headers.get("x-modified-at") };
+  }
+  /** Saves the draft and publishes in one call (two PUTs). */
+  async saveAndPublish(body, opts) {
+    await this.save({ ...body, state: CANVAS_DRAFT_STATE }, opts);
+    return this.save({ ...body, state: CANVAS_PUBLISHED_STATE });
+  }
+  /**
+   * Removes only the published state, leaving the draft intact. Scoped to a
+   * single edition when `editionId` is supplied; otherwise unpublishes all editions.
+   * To unpublish only the base edition, pass editionId and entryId as the same value.
+   */
+  async unpublish(selector) {
+    await this.deleteEntry({ ...selector, state: CANVAS_PUBLISHED_STATE });
+  }
+  /**
+   * Deletes across all states. Scoped to a single edition when `editionId` is
+   * supplied; otherwise deletes all states and editions.
+   * Use `unpublish` to drop only the published state.
+   */
+  async remove(selector) {
+    await this.deleteEntry(selector);
+  }
+  /** Fetches historical versions of an entry. */
+  history(args) {
+    const url = this.createUrl(ENTRIES_HISTORY_URL, { ...args, projectId: this.options.projectId });
+    return this.apiClient(url);
+  }
+  async deleteEntry(body) {
+    const url = this.createUrl(ENTRIES_URL2);
+    await this.apiClient(url, {
+      method: "DELETE",
+      body: JSON.stringify({ ...body, projectId: this.options.projectId }),
+      expectNoContent: true
+    });
+  }
+};
+
+// src/clients/deprecated/CanvasClient.ts
+var import_api11 = require("@uniformdev/context/api");
+var CANVAS_URL2 = "/api/v1/canvas";
+var CanvasClient = class extends import_api11.ApiClient {
   constructor(options) {
     var _a;
     if (!options.limitPolicy) {
@@ -322,10 +972,10 @@ var CanvasClient = class extends import_api2.ApiClient {
   async getCompositionList(params = {}) {
     const { projectId } = this.options;
     const { resolveData, filters, select, ...originParams } = params;
-    const rewrittenFilters = (0, import_api2.rewriteFiltersForApi)(filters);
+    const rewrittenFilters = (0, import_api11.rewriteFiltersForApi)(filters);
     const rewrittenSelect = projectionToQuery(select);
     if (!resolveData) {
-      const fetchUri = this.createUrl(CANVAS_URL, {
+      const fetchUri = this.createUrl(CANVAS_URL2, {
         ...originParams,
         projectId,
         ...rewrittenFilters,
@@ -373,7 +1023,7 @@ var CanvasClient = class extends import_api2.ApiClient {
   }) {
     const { projectId } = this.options;
     if (skipDataResolution) {
-      return this.apiClient(this.createUrl(CANVAS_URL, { ...params, projectId }));
+      return this.apiClient(this.createUrl(CANVAS_URL2, { ...params, projectId }));
     }
     const edgeParams = {
       ...params,
@@ -385,7 +1035,7 @@ var CanvasClient = class extends import_api2.ApiClient {
   }
   /** Updates or creates a Canvas component definition */
   async updateComposition(body, options) {
-    const fetchUri = this.createUrl(CANVAS_URL);
+    const fetchUri = this.createUrl(CANVAS_URL2);
     const headers = {};
     if (options == null ? void 0 : options.ifUnmodifiedSince) {
       headers["x-if-unmodified-since"] = options.ifUnmodifiedSince;
@@ -400,7 +1050,7 @@ var CanvasClient = class extends import_api2.ApiClient {
   }
   /** Deletes a Canvas component definition */
   async removeComposition(body) {
-    const fetchUri = this.createUrl(CANVAS_URL);
+    const fetchUri = this.createUrl(CANVAS_URL2);
     const { projectId } = this.options;
     await this.apiClient(fetchUri, {
       method: "DELETE",
@@ -439,53 +1089,10 @@ var UncachedCanvasClient = class extends CanvasClient {
   }
 };
 
-// src/CategoryClient.ts
-var import_api3 = require("@uniformdev/context/api");
-var CATEGORIES_URL = "/api/v1/categories";
-var CategoryClient = class extends import_api3.ApiClient {
-  constructor(options) {
-    if (!options.limitPolicy) {
-      options.limitPolicy = createLimitPolicy({});
-    }
-    super(options);
-  }
-  /** Fetches all categories created in given project */
-  async getCategories(options) {
-    const { projectId } = this.options;
-    const fetchUri = this.createUrl("/api/v1/categories", { ...options, projectId });
-    return await this.apiClient(fetchUri);
-  }
-  /** Updates or creates a category, also used to re-order them */
-  async upsertCategories(categories) {
-    const { projectId } = this.options;
-    const fetchUri = this.createUrl(CATEGORIES_URL);
-    return await this.apiClient(fetchUri, {
-      method: "PUT",
-      body: JSON.stringify({ categories, projectId }),
-      expectNoContent: true
-    });
-  }
-  /** Deletes a category */
-  async removeCategory(options) {
-    const { projectId } = this.options;
-    const fetchUri = this.createUrl(CATEGORIES_URL);
-    return await this.apiClient(fetchUri, {
-      method: "DELETE",
-      body: JSON.stringify({ projectId, categoryId: options.categoryId }),
-      expectNoContent: true
-    });
-  }
-};
-var UncachedCategoryClient = class extends CategoryClient {
-  constructor(options) {
-    super({ ...options, bypassCache: true });
-  }
-};
-
-// src/ContentClient.ts
-var import_api4 = require("@uniformdev/context/api");
+// src/clients/deprecated/ContentClient.ts
+var import_api12 = require("@uniformdev/context/api");
 var _contentTypesUrl, _entriesUrl;
-var _ContentClient = class _ContentClient extends import_api4.ApiClient {
+var _ContentClient = class _ContentClient extends import_api12.ApiClient {
   constructor(options) {
     var _a;
     super(options);
@@ -499,7 +1106,7 @@ var _ContentClient = class _ContentClient extends import_api4.ApiClient {
   getEntries(options) {
     const { projectId } = this.options;
     const { skipDataResolution, filters, select, ...params } = options;
-    const rewrittenFilters = (0, import_api4.rewriteFiltersForApi)(filters);
+    const rewrittenFilters = (0, import_api12.rewriteFiltersForApi)(filters);
     const rewrittenSelect = projectionToQuery(select);
     if (skipDataResolution) {
       const url = this.createUrl(__privateGet(_ContentClient, _entriesUrl), {
@@ -592,27 +1199,31 @@ var UncachedContentClient = class extends ContentClient {
 };
 
 // src/DataSourceClient.ts
-var import_api5 = require("@uniformdev/context/api");
+var import_api13 = require("@uniformdev/context/api");
 var dataSourceUrl = "/api/v1/data-source";
 var dataSourcesUrl = "/api/v1/data-sources";
-var DataSourceClient = class extends import_api5.ApiClient {
+var DataSourceClient = class extends import_api13.ApiClient {
   constructor(options) {
     super(options);
   }
-  /** Fetches all DataSources for a project */
+  /** Fetches a single DataSource by id (with decrypted secrets). */
   async get(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(dataSourceUrl, { ...options, projectId });
     return await this.apiClient(fetchUri);
   }
-  /** Fetches all DataSources for a project */
-  async getList(options) {
+  /** Fetches the list of DataSources for a project (secrets masked). */
+  async list(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(dataSourcesUrl, { ...options, projectId });
     return await this.apiClient(fetchUri);
   }
+  /** @deprecated Use {@link list} instead. */
+  async getList(options) {
+    return this.list(options);
+  }
   /** Updates or creates (based on id) a DataSource */
-  async upsert(body) {
+  async save(body) {
     const fetchUri = this.createUrl(dataSourceUrl);
     await this.apiClient(fetchUri, {
       method: "PUT",
@@ -620,6 +1231,10 @@ var DataSourceClient = class extends import_api5.ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link save} instead. */
+  async upsert(body) {
+    return this.save(body);
+  }
   /** Deletes a DataSource */
   async remove(body) {
     const fetchUri = this.createUrl(dataSourceUrl);
@@ -632,20 +1247,24 @@ var DataSourceClient = class extends import_api5.ApiClient {
 };
 
 // src/DataTypeClient.ts
-var import_api6 = require("@uniformdev/context/api");
+var import_api14 = require("@uniformdev/context/api");
 var _url;
-var _DataTypeClient = class _DataTypeClient extends import_api6.ApiClient {
+var _DataTypeClient = class _DataTypeClient extends import_api14.ApiClient {
   constructor(options) {
     super(options);
   }
-  /** Fetches all DataTypes for a project */
-  async get(options) {
+  /** Fetches a list of DataTypes for a project */
+  async list(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(__privateGet(_DataTypeClient, _url), { ...options, projectId });
     return await this.apiClient(fetchUri);
   }
+  /** @deprecated Use {@link list} instead. */
+  async get(options) {
+    return this.list(options);
+  }
   /** Updates or creates (based on id) a DataType */
-  async upsert(body) {
+  async save(body) {
     const fetchUri = this.createUrl(__privateGet(_DataTypeClient, _url));
     await this.apiClient(fetchUri, {
       method: "PUT",
@@ -653,6 +1272,10 @@ var _DataTypeClient = class _DataTypeClient extends import_api6.ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link save} instead. */
+  async upsert(body) {
+    return this.save(body);
+  }
   /** Deletes a DataType */
   async remove(body) {
     const fetchUri = this.createUrl(__privateGet(_DataTypeClient, _url));
@@ -788,61 +1411,6 @@ function getComponentPath(ancestorsAndSelf) {
   return `.${path.join(".")}`;
 }
 
-// src/utils/constants.ts
-var CANVAS_PERSONALIZE_TYPE = "$personalization";
-var CANVAS_TEST_TYPE = "$test";
-var CANVAS_LOCALIZATION_TYPE = "$localization";
-var CANVAS_SLOT_SECTION_TYPE = "$slotSection";
-var CANVAS_INTENT_TAG_PARAM = "intentTag";
-var CANVAS_LOCALE_TAG_PARAM = "locale";
-var CANVAS_BLOCK_PARAM_TYPE = "$block";
-var CANVAS_PERSONALIZE_SLOT = "pz";
-var CANVAS_TEST_SLOT = "test";
-var CANVAS_LOCALIZATION_SLOT = "localized";
-var CANVAS_SLOT_SECTION_SLOT = "$slotSectionItems";
-var CANVAS_SLOT_SECTION_NAME_PARAM = "name";
-var CANVAS_SLOT_SECTION_MIN_PARAM = "min";
-var CANVAS_SLOT_SECTION_MAX_PARAM = "max";
-var CANVAS_SLOT_SECTION_GROUP_TYPE_PARAM = "groupType";
-var CANVAS_SLOT_SECTION_SPECIFIC_PARAM = "specific";
-var CANVAS_DRAFT_STATE = 0;
-var CANVAS_PUBLISHED_STATE = 64;
-var CANVAS_EDITOR_STATE = 63;
-var CANVAS_PERSONALIZATION_PARAM = "$pzCrit";
-var CANVAS_PERSONALIZATION_EVENT_NAME_PARAM = "trackingEventName";
-var CANVAS_PERSONALIZATION_ALGORITHM_PARAM = "algorithm";
-var CANVAS_PERSONALIZATION_ALGORITHM_TYPE = "pzAlgorithm";
-var CANVAS_PERSONALIZATION_TAKE_PARAM = "count";
-var CANVAS_TEST_VARIANT_PARAM = "$tstVrnt";
-var CANVAS_ENRICHMENT_TAG_PARAM = "$enr";
-var CANVAS_INTERNAL_PARAM_PREFIX = "$internal_";
-var CANVAS_COMPONENT_DISPLAY_NAME_PARAM = `${CANVAS_INTERNAL_PARAM_PREFIX}displayName`;
-var CANVAS_HYPOTHESIS_PARAM = `${CANVAS_INTERNAL_PARAM_PREFIX}hypothesis`;
-var CANVAS_CONTEXTUAL_EDITING_PARAM = "$contextualEditing";
-var SECRET_QUERY_STRING_PARAM = "secret";
-var IN_CONTEXT_EDITOR_QUERY_STRING_PARAM = "is_incontext_editing_mode";
-var IN_CONTEXT_EDITOR_PLAYGROUND_QUERY_STRING_PARAM = "is_incontext_editing_playground";
-var IN_CONTEXT_EDITOR_FORCED_SETTINGS_QUERY_STRING_PARAM = "is_incontext_editing_forced_settings";
-var IN_CONTEXT_EDITOR_CONFIG_CHECK_QUERY_STRING_PARAM = "is_config_check";
-var IN_CONTEXT_EDITOR_COMPONENT_START_ROLE = "uniform-component-start";
-var IN_CONTEXT_EDITOR_COMPONENT_END_ROLE = "uniform-component-end";
-var IN_CONTEXT_EDITOR_EMBED_SCRIPT_ID = "uniform-canvas-preview-script";
-var IS_RENDERED_BY_UNIFORM_ATTRIBUTE = "data-is-rendered-by-uniform";
-var PLACEHOLDER_ID = "placeholder";
-var EMPTY_COMPOSITION = {
-  _id: "_empty_composition_id",
-  _name: "An empty composition used for contextual editing",
-  type: "_empty_composition_type"
-};
-var EDGE_MIN_CACHE_TTL = 10;
-var EDGE_MAX_CACHE_TTL = 24 * 60 * 60;
-var EDGE_DEFAULT_CACHE_TTL = 30;
-var EDGE_CACHE_DISABLED = -1;
-var ASSET_PARAMETER_TYPE = "asset";
-var ASSETS_SOURCE_UNIFORM = "uniform-assets";
-var ASSETS_SOURCE_CUSTOM_URL = "custom-url";
-var REFERENCE_DATA_TYPE_ID = "uniformContentInternalReference";
-
 // src/utils/guards.ts
 function isRootEntryReference(root) {
   return root.type === "root" && isEntryData(root.node);
@@ -920,9 +1488,9 @@ function parseVariableExpression(serialized, onToken) {
   let bufferStartIndex = 0;
   let bufferEndIndex = 0;
   let tokenCount = 0;
-  const handleToken = (token, type) => {
+  const handleToken = (token, type, offset) => {
     tokenCount++;
-    return onToken == null ? void 0 : onToken(token, type);
+    return onToken == null ? void 0 : onToken(token, type, offset);
   };
   let state = "text";
   for (let index = 0; index < serialized.length; index++) {
@@ -933,7 +1501,7 @@ function parseVariableExpression(serialized, onToken) {
     if (char === variablePrefix[0] && serialized[index + 1] === variablePrefix[1]) {
       if (serialized[index - 1] === escapeCharacter) {
         bufferEndIndex -= escapeCharacter.length;
-        if (handleToken(serialized.substring(bufferStartIndex, bufferEndIndex), "text") === false) {
+        if (handleToken(serialized.substring(bufferStartIndex, bufferEndIndex), "text", bufferStartIndex) === false) {
           return tokenCount;
         }
         bufferStartIndex = index;
@@ -942,12 +1510,12 @@ function parseVariableExpression(serialized, onToken) {
       }
       if (state === "variable") {
         const textStart = bufferStartIndex - variablePrefix.length;
-        if (handleToken(serialized.substring(textStart, bufferEndIndex), "text") === false) {
+        if (handleToken(serialized.substring(textStart, bufferEndIndex), "text", textStart) === false) {
           return tokenCount;
         }
         bufferStartIndex = bufferEndIndex;
       } else if (bufferEndIndex > bufferStartIndex) {
-        if (handleToken(serialized.substring(bufferStartIndex, bufferEndIndex), "text") === false) {
+        if (handleToken(serialized.substring(bufferStartIndex, bufferEndIndex), "text", bufferStartIndex) === false) {
           return tokenCount;
         }
         bufferStartIndex = bufferEndIndex;
@@ -965,7 +1533,7 @@ function parseVariableExpression(serialized, onToken) {
       state = "text";
       if (bufferEndIndex > bufferStartIndex) {
         const unescapedVariableName = serialized.substring(bufferStartIndex, bufferEndIndex).replace(/\\([${}])/g, "$1");
-        if (handleToken(unescapedVariableName, "variable") === false) {
+        if (handleToken(unescapedVariableName, "variable", bufferStartIndex) === false) {
           return tokenCount;
         }
         bufferStartIndex = bufferEndIndex + variableSuffix.length;
@@ -979,7 +1547,7 @@ function parseVariableExpression(serialized, onToken) {
     bufferStartIndex -= variablePrefix.length;
   }
   if (bufferStartIndex < serialized.length) {
-    handleToken(serialized.substring(bufferStartIndex), state);
+    handleToken(serialized.substring(bufferStartIndex), state, bufferStartIndex);
   }
   return tokenCount;
 }
@@ -2296,24 +2864,28 @@ function walkPropertyValues(property, visitor) {
 }
 
 // src/EntityReleasesClient.ts
-var import_api7 = require("@uniformdev/context/api");
-var releaseContentsUrl = "/api/v1/entity-releases";
-var EntityReleasesClient = class extends import_api7.ApiClient {
+var import_api15 = require("@uniformdev/context/api");
+var entityReleasesUrl = "/api/v1/entity-releases";
+var EntityReleasesClient = class extends import_api15.ApiClient {
   constructor(options) {
     super(options);
   }
   /** Fetches entity across all releases (and base) */
-  async get(options) {
+  async list(options) {
     const { projectId } = this.options;
-    const fetchUri = this.createUrl(releaseContentsUrl, { ...options, projectId });
+    const fetchUri = this.createUrl(entityReleasesUrl, { ...options, projectId });
     return await this.apiClient(fetchUri);
   }
+  /** @deprecated Use {@link list} instead. */
+  async get(options) {
+    return this.list(options);
+  }
 };
 
 // src/IntegrationPropertyEditorsClient.ts
-var import_api8 = require("@uniformdev/context/api");
+var import_api16 = require("@uniformdev/context/api");
 var _baseUrl;
-var _IntegrationPropertyEditorsClient = class _IntegrationPropertyEditorsClient extends import_api8.ApiClient {
+var _IntegrationPropertyEditorsClient = class _IntegrationPropertyEditorsClient extends import_api16.ApiClient {
   constructor(options) {
     super(options);
     this.teamId = options.teamId;
@@ -2356,17 +2928,21 @@ __privateAdd(_IntegrationPropertyEditorsClient, _baseUrl, "/api/v1/integration-p
 var IntegrationPropertyEditorsClient = _IntegrationPropertyEditorsClient;
 
 // src/LabelClient.ts
-var import_api9 = require("@uniformdev/context/api");
+var import_api17 = require("@uniformdev/context/api");
 var LABELS_URL = "/api/v1/labels";
-var LabelClient = class extends import_api9.ApiClient {
-  /** Fetches labels for the current project. */
-  async getLabels(options) {
+var LabelClient = class extends import_api17.ApiClient {
+  /** Fetches a list of labels for the current project. */
+  async list(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(LABELS_URL, { ...options, projectId });
     return await this.apiClient(fetchUri);
   }
+  /** @deprecated Use {@link list} instead. */
+  async getLabels(options) {
+    return this.list(options);
+  }
   /** Updates or creates a label. */
-  async upsertLabel(body) {
+  async save(body) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(LABELS_URL);
     await this.apiClient(fetchUri, {
@@ -2375,8 +2951,12 @@ var LabelClient = class extends import_api9.ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link save} instead. */
+  async upsertLabel(body) {
+    return this.save(body);
+  }
   /** Deletes a label by id. */
-  async removeLabel(options) {
+  async remove(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(LABELS_URL);
     await this.apiClient(fetchUri, {
@@ -2385,6 +2965,10 @@ var LabelClient = class extends import_api9.ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link remove} instead. */
+  async removeLabel(options) {
+    return this.remove(options);
+  }
 };
 var UncachedLabelClient = class extends LabelClient {
   constructor(options) {
@@ -2393,20 +2977,24 @@ var UncachedLabelClient = class extends LabelClient {
 };
 
 // src/LocaleClient.ts
-var import_api10 = require("@uniformdev/context/api");
+var import_api18 = require("@uniformdev/context/api");
 var localesUrl = "/api/v1/locales";
-var LocaleClient = class extends import_api10.ApiClient {
+var LocaleClient = class extends import_api18.ApiClient {
   constructor(options) {
     super(options);
   }
-  /** Fetches all locales for a project */
-  async get(options) {
+  /** Fetches a list of locales for a project */
+  async list(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(localesUrl, { ...options, projectId });
     return await this.apiClient(fetchUri);
   }
+  /** @deprecated Use {@link list} instead. */
+  async get(options) {
+    return this.list(options);
+  }
   /** Updates or creates (based on id) a locale */
-  async upsert(body) {
+  async save(body) {
     const fetchUri = this.createUrl(localesUrl);
     await this.apiClient(fetchUri, {
       method: "PUT",
@@ -2414,6 +3002,10 @@ var LocaleClient = class extends import_api10.ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link save} instead. */
+  async upsert(body) {
+    return this.save(body);
+  }
   /** Deletes a locale */
   async remove(body) {
     const fetchUri = this.createUrl(localesUrl);
@@ -2796,11 +3388,57 @@ var createCanvasChannel = ({
   };
 };
 
+// src/NotificationsClient.ts
+var import_api19 = require("@uniformdev/context/api");
+var _url2;
+var _NotificationsClient = class _NotificationsClient extends import_api19.ApiClient {
+  constructor(options) {
+    super(options);
+  }
+  /**
+   * Lists notifications for the current user.
+   *
+   * @deprecated This API is experimental and may change without notice.
+   */
+  async list(options) {
+    const fetchUri = this.createUrl(__privateGet(_NotificationsClient, _url2), options);
+    return await this.apiClient(fetchUri);
+  }
+  /**
+   * Creates a notification for one or more recipients.
+   *
+   * @deprecated This API is experimental and may change without notice.
+   */
+  async create(body) {
+    const fetchUri = this.createUrl(__privateGet(_NotificationsClient, _url2));
+    return await this.apiClient(fetchUri, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
+  /**
+   * Updates the read state of the current user's notifications.
+   *
+   * @deprecated This API is experimental and may change without notice.
+   */
+  async setReadState(body) {
+    const fetchUri = this.createUrl(__privateGet(_NotificationsClient, _url2));
+    await this.apiClient(fetchUri, {
+      method: "PATCH",
+      body: JSON.stringify(body),
+      expectNoContent: true
+    });
+  }
+};
+_url2 = new WeakMap();
+__privateAdd(_NotificationsClient, _url2, "/api/v1/notifications");
+var NotificationsClient = _NotificationsClient;
+
 // src/PreviewClient.ts
-var import_api11 = require("@uniformdev/context/api");
+var import_api20 = require("@uniformdev/context/api");
 var previewUrlsUrl = "/api/v1/preview-urls";
 var previewViewportsUrl = "/api/v1/preview-viewports";
-var PreviewClient = class extends import_api11.ApiClient {
+var PreviewClient = class extends import_api20.ApiClient {
   constructor(options) {
     super(options);
   }
@@ -2863,15 +3501,15 @@ var PreviewClient = class extends import_api11.ApiClient {
 };
 
 // src/ProjectClient.ts
-var import_api12 = require("@uniformdev/context/api");
-var _url2, _projectsUrl;
-var _ProjectClient = class _ProjectClient extends import_api12.ApiClient {
+var import_api21 = require("@uniformdev/context/api");
+var _url3, _projectsUrl;
+var _ProjectClient = class _ProjectClient extends import_api21.ApiClient {
   constructor(options) {
     super({ ...options, bypassCache: true });
   }
   /** Fetches single Project */
   async get(options) {
-    const fetchUri = this.createUrl(__privateGet(_ProjectClient, _url2), { ...options });
+    const fetchUri = this.createUrl(__privateGet(_ProjectClient, _url3), { ...options });
     return await this.apiClient(fetchUri);
   }
   /**
@@ -2879,31 +3517,43 @@ var _ProjectClient = class _ProjectClient extends import_api12.ApiClient {
    * When teamId is provided, returns a single team with its projects.
    * When omitted, returns all accessible teams and their projects.
    */
-  async getProjects(options) {
+  async list(options) {
     const fetchUri = this.createUrl(__privateGet(_ProjectClient, _projectsUrl), options ? { ...options } : {});
     return await this.apiClient(fetchUri);
   }
+  /** @deprecated Use {@link list} instead. */
+  async getProjects(options) {
+    return this.list(options);
+  }
   /** Updates or creates (based on id) a Project */
-  async upsert(body) {
-    const fetchUri = this.createUrl(__privateGet(_ProjectClient, _url2));
+  async save(body) {
+    const fetchUri = this.createUrl(__privateGet(_ProjectClient, _url3));
     return await this.apiClient(fetchUri, {
       method: "PUT",
       body: JSON.stringify({ ...body })
     });
   }
+  /** @deprecated Use {@link save} instead. */
+  async upsert(body) {
+    return this.save(body);
+  }
   /** Deletes a Project */
-  async delete(body) {
-    const fetchUri = this.createUrl(__privateGet(_ProjectClient, _url2));
+  async remove(body) {
+    const fetchUri = this.createUrl(__privateGet(_ProjectClient, _url3));
     await this.apiClient(fetchUri, {
       method: "DELETE",
       body: JSON.stringify({ ...body }),
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link remove} instead. */
+  async delete(body) {
+    return this.remove(body);
+  }
 };
-_url2 = new WeakMap();
+_url3 = new WeakMap();
 _projectsUrl = new WeakMap();
-__privateAdd(_ProjectClient, _url2, "/api/v1/project");
+__privateAdd(_ProjectClient, _url3, "/api/v1/project");
 __privateAdd(_ProjectClient, _projectsUrl, "/api/v1/projects");
 var ProjectClient = _ProjectClient;
 
@@ -3090,9 +3740,9 @@ function queryToProjection(source) {
 }
 
 // src/PromptClient.ts
-var import_api13 = require("@uniformdev/context/api");
+var import_api22 = require("@uniformdev/context/api");
 var PromptsUrl = "/api/v1/prompts";
-var PromptClient = class extends import_api13.ApiClient {
+var PromptClient = class extends import_api22.ApiClient {
   constructor(options) {
     super(options);
   }
@@ -3123,34 +3773,42 @@ var PromptClient = class extends import_api13.ApiClient {
 };
 
 // src/RelationshipClient.ts
-var import_api14 = require("@uniformdev/context/api");
+var import_api23 = require("@uniformdev/context/api");
 var RELATIONSHIPS_URL = "/api/v1/relationships";
-var RelationshipClient = class extends import_api14.ApiClient {
+var RelationshipClient = class extends import_api23.ApiClient {
   constructor(options) {
     super(options);
-    this.get = async (options) => {
+    this.list = async (options) => {
       const { projectId } = this.options;
       const url = this.createUrl(RELATIONSHIPS_URL, { ...options, projectId });
       return this.apiClient(url);
     };
+    /** @deprecated Use {@link list} instead. */
+    this.get = async (options) => {
+      return this.list(options);
+    };
   }
 };
 
 // src/ReleaseClient.ts
-var import_api15 = require("@uniformdev/context/api");
+var import_api24 = require("@uniformdev/context/api");
 var releasesUrl = "/api/v1/releases";
-var ReleaseClient = class extends import_api15.ApiClient {
+var ReleaseClient = class extends import_api24.ApiClient {
   constructor(options) {
     super(options);
   }
-  /** Fetches all releases for a project */
-  async get(options) {
+  /** Fetches a list of releases for a project */
+  async list(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(releasesUrl, { ...options, projectId });
     return await this.apiClient(fetchUri);
   }
+  /** @deprecated Use {@link list} instead. */
+  async get(options) {
+    return this.list(options);
+  }
   /** Updates or creates (based on id) a release */
-  async upsert(body) {
+  async save(body) {
     const fetchUri = this.createUrl(releasesUrl);
     await this.apiClient(fetchUri, {
       method: "PUT",
@@ -3158,6 +3816,10 @@ var ReleaseClient = class extends import_api15.ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link save} instead. */
+  async upsert(body) {
+    return this.save(body);
+  }
   /** Deletes a release */
   async remove(body) {
     const fetchUri = this.createUrl(releasesUrl);
@@ -3179,21 +3841,25 @@ var ReleaseClient = class extends import_api15.ApiClient {
 };
 
 // src/ReleaseContentsClient.ts
-var import_api16 = require("@uniformdev/context/api");
-var releaseContentsUrl2 = "/api/v1/release-contents";
-var ReleaseContentsClient = class extends import_api16.ApiClient {
+var import_api25 = require("@uniformdev/context/api");
+var releaseContentsUrl = "/api/v1/release-contents";
+var ReleaseContentsClient = class extends import_api25.ApiClient {
   constructor(options) {
     super(options);
   }
-  /** Fetches all entities added to a release */
-  async get(options) {
+  /** Fetches a list of entities added to a release */
+  async list(options) {
     const { projectId } = this.options;
-    const fetchUri = this.createUrl(releaseContentsUrl2, { ...options, projectId });
+    const fetchUri = this.createUrl(releaseContentsUrl, { ...options, projectId });
     return await this.apiClient(fetchUri);
   }
+  /** @deprecated Use {@link list} instead. */
+  async get(options) {
+    return this.list(options);
+  }
   /** Removes a release content from a release */
   async remove(body) {
-    const fetchUri = this.createUrl(releaseContentsUrl2);
+    const fetchUri = this.createUrl(releaseContentsUrl);
     await this.apiClient(fetchUri, {
       method: "DELETE",
       body: JSON.stringify({ ...body, projectId: this.options.projectId }),
@@ -3203,9 +3869,9 @@ var ReleaseContentsClient = class extends import_api16.ApiClient {
 };
 
 // src/RouteClient.ts
-var import_api17 = require("@uniformdev/context/api");
+var import_api26 = require("@uniformdev/context/api");
 var ROUTE_URL = "/api/v1/route";
-var RouteClient = class extends import_api17.ApiClient {
+var RouteClient = class extends import_api26.ApiClient {
   constructor(options) {
     var _a;
     if (!options.limitPolicy) {
@@ -3214,8 +3880,14 @@ var RouteClient = class extends import_api17.ApiClient {
     super(options);
     this.edgeApiHost = (_a = options.edgeApiHost) != null ? _a : "https://uniform.global";
   }
-  /** Fetches lists of Canvas compositions, optionally by type */
-  async getRoute(options) {
+  /**
+   * Resolves a route to a composition, redirect, or not-found result.
+   *
+   * An optional `select` projection applies to the resolved composition when
+   * the route matches one; redirect / notFound responses pass through
+   * untouched.
+   */
+  async get(options) {
     const { projectId } = this.options;
     const { select, ...rest } = options != null ? options : {};
     const rewrittenSelect = projectionToQuery(select);
@@ -3225,6 +3897,10 @@ var RouteClient = class extends import_api17.ApiClient {
       this.options.disableSWR ? { headers: { "x-disable-swr": "true" } } : void 0
     );
   }
+  /** @deprecated use {@link RouteClient.get} instead (renamed). */
+  async getRoute(options) {
+    return this.get(options);
+  }
 };
 
 // src/types/locales.ts
@@ -3579,26 +4255,30 @@ function handleRichTextNodeBinding(object, options) {
 }
 
 // src/index.ts
-var import_api19 = require("@uniformdev/context/api");
+var import_api28 = require("@uniformdev/context/api");
 
 // src/.version.ts
-var version = "20.72.1";
+var version = "20.72.3";
 
 // src/WorkflowClient.ts
-var import_api18 = require("@uniformdev/context/api");
+var import_api27 = require("@uniformdev/context/api");
 var workflowsUrl = "/api/v1/workflows";
-var WorkflowClient = class extends import_api18.ApiClient {
+var WorkflowClient = class extends import_api27.ApiClient {
   constructor(options) {
     super(options);
   }
-  /** Fetches workflows for a project */
-  async get(options) {
+  /** Fetches a list of workflows for a project */
+  async list(options) {
     const { projectId } = this.options;
     const fetchUri = this.createUrl(workflowsUrl, { ...options, projectId });
     return await this.apiClient(fetchUri);
   }
+  /** @deprecated Use {@link list} instead. */
+  async get(options) {
+    return this.list(options);
+  }
   /** Updates or creates a workflow definition */
-  async upsert(body) {
+  async save(body) {
     const fetchUri = this.createUrl(workflowsUrl);
     await this.apiClient(fetchUri, {
       method: "PUT",
@@ -3606,6 +4286,10 @@ var WorkflowClient = class extends import_api18.ApiClient {
       expectNoContent: true
     });
   }
+  /** @deprecated Use {@link save} instead. */
+  async upsert(body) {
+    return this.save(body);
+  }
   /** Deletes a workflow definition */
   async remove(body) {
     const fetchUri = this.createUrl(workflowsUrl);
@@ -3618,7 +4302,7 @@ var WorkflowClient = class extends import_api18.ApiClient {
 };
 
 // src/index.ts
-var CanvasClientError = import_api19.ApiClientError;
+var CanvasClientError = import_api28.ApiClientError;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ASSETS_SOURCE_CUSTOM_URL,
@@ -3672,7 +4356,11 @@ var CanvasClientError = import_api19.ApiClientError;
   CanvasClientError,
   CategoryClient,
   ChildEnhancerBuilder,
+  ComponentDefinitionClient,
+  CompositionDeliveryClient,
+  CompositionManagementClient,
   ContentClient,
+  ContentTypeClient,
   DataSourceClient,
   DataTypeClient,
   EDGE_CACHE_DISABLED,
@@ -3682,6 +4370,8 @@ var CanvasClientError = import_api19.ApiClientError;
   EMPTY_COMPOSITION,
   EnhancerBuilder,
   EntityReleasesClient,
+  EntryDeliveryClient,
+  EntryManagementClient,
   IN_CONTEXT_EDITOR_COMPONENT_END_ROLE,
   IN_CONTEXT_EDITOR_COMPONENT_START_ROLE,
   IN_CONTEXT_EDITOR_CONFIG_CHECK_QUERY_STRING_PARAM,
@@ -3694,6 +4384,7 @@ var CanvasClientError = import_api19.ApiClientError;
   LOCALE_DYNAMIC_INPUT_NAME,
   LabelClient,
   LocaleClient,
+  NotificationsClient,
   PLACEHOLDER_ID,
   PreviewClient,
   ProjectClient,