@keboola/api-client 36.0.0 → 40.0.0

package/dist/{semanticLayer-CSqmtHRo.js → semanticLayer-pYy082Ju.js}

@@ -1,18 +1,15 @@
-import { t as concurrent } from "./concurrent-CH9fbNr3.js";
+import { t as concurrent } from "./concurrent-BacWxPwi.js";
 import { t as generateUUID } from "./generateUUID-Dr8l-aoc.js";
-import { i as parseOrThrow, n as formatValidationIssues } from "./ValidationError-BekhphAq.js";
+import { m as HttpStatus, r as isApiError } from "./createFetchClient-DXHQK63w.js";
+import { i as parseOrThrow, n as formatValidationIssues } from "./ValidationError-DjhtNMfZ.js";
 import { z } from "zod";
 //#region src/sdks/semanticLayer/errorMessage.ts
 /**
 * The message out of a metastore error body.
 *
-* - The metastore reports what is actually wrong with a write only inside `errors[].message`
-*   (`missing property 'fqn'`). The HTTP status and the response's own message say no more than
-*   "Validation failed", so a caller that renders those alone tells a user nothing actionable.
-* - Every shape that is not that envelope returns `undefined` rather than a placeholder, so the
-*   caller keeps its own fallback (`?? error.message`) instead of rendering a stand-in for one.
-* - Only the first error: the metastore reports fields one at a time, so a list would be a list
-*   of one.
+* - Only `errors[].message` says what is wrong; the top-level message is just "Validation failed".
+* - Any other shape returns `undefined`, so the caller keeps its own fallback.
+* - Only the first error: the metastore reports fields one at a time.
 */
 const metastoreErrorMessage = (data) => {
 	if (typeof data !== "object" || data === null) return void 0;
@@ -28,24 +25,15 @@ const metastoreErrorMessage = (data) => {
 /**
 * The closed value sets the metastore accepts inside a semantic object's `data`.
 *
-* - Each one is the single runtime source for a union in `./types`, which derives the type from
-*   the array here. A value cannot exist in the type and be missing from the list a dropdown or
-*   a validator is built from.
-* - The addressing vocabulary (`SEMANTIC_OBJECT_TYPE`, `MODEL_CHILD_OBJECT_TYPES`) is a
-*   different axis — which object a call targets, not what may sit inside one — and stays beside
-*   the SDK methods that take it.
-* - This file imports nothing: `./types` reads it, never the reverse.
+* - The single runtime source for the unions `./types` derives from these arrays.
+* - Imports nothing: `./types` reads it, never the reverse.
 */
 /**
-* The dialects the metastore accepts, exactly as it spells them. A lowercase value is
-* rejected with `422 value must be one of 'Snowflake', 'BigQuery'`, which surfaces only as a
-* generic "Validation failed" — so callers need the real set rather than a bare `string`.
+* The dialects the metastore accepts, case-sensitive.
 *
-* `SemanticModelData.sql_dialect` stays `string` for now: narrowing it would break any caller
-* passing a `string` variable, which is a major bump. Validate against this instead.
+* - `SemanticModelData.sql_dialect` stays `string` (narrowing is a major bump); validate against this.
 */
 const SQL_DIALECTS = ["Snowflake", "BigQuery"];
-/** The metastore's constraint kinds. */
 const CONSTRAINT_TYPES = [
 	"inequality",
 	"equality",
@@ -55,40 +43,26 @@ const CONSTRAINT_TYPES = [
 	"temporal",
 	"conditional"
 ];
-/**
-* What a dataset field is for.
-*
-* - Enumerated, unlike a field's `type`: the metastore takes any type string, but only these
-*   four roles.
-*/
+/** Dataset field roles; enumerated, unlike a field's free-form `type`. */
 const FIELD_ROLES = [
 	"key",
 	"dimension",
 	"measure",
 	"timestamp"
 ];
-/**
-* How loudly a violated constraint reports.
-*
-* - An unset severity is stored as `warning`, so a reader renders that rather than nothing.
-*/
+/** Constraint severities; unset is stored as `warning`. */
 const CONSTRAINT_SEVERITIES = [
 	"error",
 	"warning",
 	"info"
 ];
-/**
-* What a constraint's rule is evaluated per.
-*
-* - An unset scope is stored as `global`.
-*/
+/** Constraint scopes; unset is stored as `global`. */
 const CONSTRAINT_SCOPES = [
 	"global",
 	"per_location",
 	"per_date",
 	"per_category"
 ];
-/** The comparisons a constraint's `ruleExpression` can make. */
 const RULE_OPERATORS = [
 	"<",
 	"<=",
@@ -101,26 +75,15 @@ const RULE_OPERATORS = [
 	"sum_equals",
 	"ratio_between"
 ];
-/** The join a relationship stands for. */
 const RELATIONSHIP_JOIN_TYPES = ["left", "inner"];
 //#endregion
 //#region src/sdks/semanticLayer/schemas.ts
 /**
-* Runtime validators for the semantic-layer payload shapes.
-*
-* These exist because the metastore's validation errors are opaque — a missing or misspelled
-* field surfaces only as a generic "Validation failed", and a wrong `sql_dialect` casing as a
-* 422 that names neither the field nor the accepted values. Parsing first turns those into a
-* message that says what is wrong.
+* Write validators for untrusted input; the metastore's own validation errors are opaque.
 *
-* **Only the fields the SDK types mark as required are declared.** The metastore owns each
-* object type's full schema, so every schema is a `looseObject`: unknown fields pass through
-* untouched rather than being stripped or rejected. Re-declaring the optional fields here
-* would create a second source of truth that silently drops whatever the metastore adds next.
-*
-* The SDK does **not** parse on its own writes — these are for callers that accept untrusted
-* or hand-authored input (an agent's tool call, a form submission) and want to fail early.
-* `modelUUID` is omitted throughout: the SDK injects it, so callers never supply it.
+* - Only required fields are declared; `looseObject` passes the rest through (the metastore owns the full schema).
+* - The SDK does not parse its own writes.
+* - `modelUUID` is omitted: the SDK injects it.
 */
 const semanticModelSchema = z.looseObject({
 	name: z.string().min(1),
@@ -150,7 +113,6 @@ const semanticConstraintSchema = z.looseObject({
 	metrics: z.array(z.string()),
 	rule: z.string().min(1)
 });
-/** Keyed by object type so a caller can pick the schema from a `SemanticChildObjectType`. */
 const SEMANTIC_CHILD_OBJECT_SCHEMAS = {
 	"semantic-dataset": semanticDatasetSchema,
 	"semantic-metric": semanticMetricSchema,
@@ -163,19 +125,9 @@ const SEMANTIC_CHILD_OBJECT_SCHEMAS = {
 /**
 * What a read of the metastore is allowed to hand back, per object type.
 *
-* - Every schema is annotated with the type it must produce, so the compiler rejects a schema that
-*   omits a field `./types` declares or makes a required one optional. The declared type and the
-*   parser cannot drift apart.
-* - `looseObject` throughout: a field the metastore adds still reaches a caller at runtime, exactly
-*   as it did when this boundary asserted instead of parsing.
-* - The metastore validates each object type on write — that is where its opaque "Validation
-*   failed" and `sql_dialect` 422s come from — so a stored object already satisfies these. Parsing
-*   is the net under that, for an object written before a schema version tightened and for the
-*   day the two schemas disagree.
-* - An **optional** enum that arrives with a value outside the list reads as absent rather than
-*   taking its object down: a new `role` the metastore starts issuing must not delete the dataset
-*   carrying it. A **required** enum has no such reading — `constraintType` decides what a
-*   constraint means — so an unknown value drops the object.
+* - Each schema is annotated with its `./types` type, so the two cannot drift apart.
+* - `looseObject`: fields the metastore adds still reach callers.
+* - An unknown value in an optional enum reads as absent; in a required enum it drops the object.
 */
 const aiMetadataSchema = z.looseObject({
 	synonyms: z.array(z.string()).optional(),
@@ -195,9 +147,7 @@ const fieldSchema = z.looseObject({
 /**
 * A dataset's `fields`, where a malformed column is dropped rather than the whole dataset.
 *
-* - `name` is required and `schemas.ts` does not validate `fields` on write, so this SDK can
-*   store a nameless column that a strict read would then hide the entire table over.
-* - The same rule as the collection one level up: a drop never takes its container with it.
+* - `schemas.ts` does not validate `fields` on write, so a nameless column can be stored.
 */
 const datasetFieldsSchema = z.array(z.unknown()).transform((items) => items.flatMap((element, index) => {
 	const result = fieldSchema.safeParse(element);
@@ -292,10 +242,7 @@ const semanticObjectMetaSchema = z.looseObject({
 /**
 * The envelope every read comes wrapped in, mapped to the `SemanticObject` the SDK returns.
 *
-* `meta` is absent on nothing we have seen, but every field inside it is optional, so an envelope
-* that omits it is a normalization rather than a failure — the alternative is dropping an object
-* over audit fields no caller requires. `null` normalizes the same way: a serializer that writes
-* an absent object as `null` must not be a different outcome from one that omits the key.
+* - A missing or `null` `meta` normalizes rather than drops the object; no caller needs its fields.
 */
 const semanticObjectReadSchema = (dataSchema) => z.object({
 	id: z.string(),
@@ -309,11 +256,10 @@ const semanticObjectReadSchema = (dataSchema) => z.object({
 //#endregion
 //#region src/sdks/semanticLayer/semanticLayerSdk.ts
 /**
-* Thrown by `deleteModel` when the child cascade partially fails. Every child delete has
-* settled by the time this is thrown — nothing keeps deleting in the background — and the
-* model itself was kept, so the exact remaining state is knowable: `deletedChildren` are gone,
-* `failedChildren` (and the model) still exist. `errors` carries the per-child rejection
-* reasons, AggregateError-style.
+* Thrown by `deleteModel` when the child cascade partially fails.
+*
+* - Every child delete has settled; the model was kept.
+* - `deletedChildren` are gone, `failedChildren` still exist; `errors` holds per-child reasons.
 */
 var SemanticLayerCascadeDeleteError = class extends AggregateError {
 	modelUUID;
@@ -329,15 +275,10 @@ var SemanticLayerCascadeDeleteError = class extends AggregateError {
 	}
 };
 /**
-* Thrown by `listModelChildren` when a read that has to be complete was not.
+* Thrown by `listModelChildren` when some child could not be parsed; fails closed.
 *
-* - A dropped object is invisible to the caller, and two of this SDK's answers cannot survive
-*   that: what a delete would destroy, and whether a model still has children.
-* - So this one read fails closed where a display read degrades. `deleteModel` calls it before
-*   the cascade starts, so nothing is deleted when it throws.
-* - `unreadable` lists what could not be parsed. `modelUUID` is `null` when that field is itself
-*   part of what failed — an object that cannot name its model is counted against every model,
-*   because the alternative is deleting the model it turns out to belong to.
+* - `deleteModel` reads before the cascade, so nothing is deleted when this throws.
+* - An `unreadable` entry with `modelUUID: null` counts against every model.
 */
 var SemanticLayerUnreadableChildrenError = class extends Error {
 	modelUUID;
@@ -357,10 +298,7 @@ const SEMANTIC_OBJECT_TYPE = {
 	GLOSSARY: "semantic-glossary",
 	CONSTRAINT: "semantic-constraint"
 };
-/**
-* `readonly` because this drives `createModelTree`, `listModelChildren` and `deleteModel` —
-* a consumer-side `.push()` would silently change what a cascade delete touches.
-*/
+/** `readonly`: it drives what a cascade delete touches. */
 const MODEL_CHILD_OBJECT_TYPES = [
 	SEMANTIC_OBJECT_TYPE.DATASET,
 	SEMANTIC_OBJECT_TYPE.METRIC,
@@ -375,25 +313,13 @@ const mapObject = (item) => ({
 	data: item.attributes,
 	meta: item.meta
 });
-/**
-* The UUID of an envelope that failed to parse, read off the raw value.
-*
-* There is no parse result to read it from. `null` — no `id`, not a string, or not an object at
-* all — means the object is unaddressable: nothing can fetch, fix or delete it by UUID.
-*/
+/** The raw `id` of an envelope that failed to parse; `null` means unaddressable. */
 const envelopeId = (value) => {
 	if (typeof value !== "object" || value === null) return null;
 	const { id } = value;
 	return typeof id === "string" && id !== "" ? id : null;
 };
-/**
-* The model a *dropped* envelope claims, read off the raw value.
-*
-* `listObjects` scopes a collection by the parsed `data.modelUUID`, which an object that failed
-* to parse has none of. `null` — the field is missing, not a string, or the envelope is not an
-* object — means "cannot be attributed", and every caller here treats that as "could be this
-* model's".
-*/
+/** The raw `modelUUID` of a dropped envelope; `null` is treated as "could be any model's". */
 const envelopeModelUUID = (value) => {
 	if (typeof value !== "object" || value === null) return null;
 	const { attributes } = value;
@@ -407,14 +333,9 @@ const deriveOptionalObjectName = (data) => {
 };
 const deriveObjectName = (data) => deriveOptionalObjectName(data) ?? generateUUID();
 /**
-* The label a UI shows for an object, as opposed to the identifier it is addressed by.
-*
-* Constraints carry an optional `displayName`; kbc-ui's constraint tables already render
-* `displayName ?? name`, so a confirmation listing what a cascade delete would destroy has to
-* agree with them or it names objects the user can't find on screen.
+* The UI label: `displayName ?? name`, matching kbc-ui's constraint tables.
 *
-* Deliberately **not** used for lookup: `displayName` is optional and not unique, so matching on
-* it would make `findObjectsByName` ambiguous for callers that resolve a write target by name.
+* - Not used for lookup: `displayName` is not unique.
 */
 const deriveObjectLabel = (data) => {
 	if (typeof data.displayName === "string" && data.displayName !== "") return data.displayName;
@@ -424,15 +345,8 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 	/**
 	* Every object of one type, parsed rather than asserted.
 	*
-	* - Each element is validated against the shape `./types` declares for it, so a caller that
-	*   reads a field the type marks required gets a string and not a `TypeError` in render.
-	* - An element that does not match is dropped and the reason logged — the metastore validates
-	*   these on write, so one that fails here is genuinely broken, and a half-formed object is
-	*   worse to hand a caller than no object.
-	* - A drop never takes the collection with it: a model with one malformed metric still lists
-	*   the other nine.
-	* - A response that is not a collection at all is a different failure and throws, because
-	*   reading it as an empty list would render "this project has no metrics".
+	* - A malformed element is dropped, logged and reported in `unreadable`; the rest still list.
+	* - A response that is not a collection throws rather than reading as empty.
 	*/
 	const _listObjects = async (objectType, dataSchema, signal) => {
 		const response = await metastoreClient.repository.getMetaObjects({ objectType }, signal);
@@ -480,11 +394,9 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 		return mapObject(response.data);
 	};
 	/**
-	* One child collection, scoped to a model, with what the scoping could not account for.
+	* One child collection scoped to a model.
 	*
-	* - An object that parsed is this model's when its `modelUUID` matches.
-	* - An object that did not parse is this model's when the raw envelope says so — and also when
-	*   the envelope cannot say, since a dropped object that names no model could be anyone's.
+	* - `unreadable` includes objects whose envelope names this model or no model.
 	*/
 	const _listChildObjects = async (objectType, modelUUID, signal) => {
 		const { objects, unreadable } = await _listObjects(objectType, SEMANTIC_CHILD_OBJECT_READ_SCHEMAS[objectType], signal);
@@ -495,11 +407,9 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 	};
 	const listObjects = async (objectType, modelUUID, signal) => (await _listChildObjects(objectType, modelUUID, signal)).objects;
 	/**
-	* Find a model's child objects by their user-facing name.
+	* A model's child objects by name (`term` for glossary).
 	*
-	* Returns every match rather than resolving to one, because a name is not unique: the caller
-	* decides whether that's an error (an agent needs an unambiguous target) or a choice to offer
-	* (a UI can render a picker). Glossary entries key on `term`, so both are matched.
+	* - Returns every match: names are not unique, the caller decides.
 	*/
 	const findObjectsByName = async (objectType, name, modelUUID, signal) => {
 		return (await listObjects(objectType, modelUUID, signal)).filter((object) => deriveOptionalObjectName(object.data) === name);
@@ -519,6 +429,12 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 		process: async (data) => createObject(objectType, data, meta),
 		concurrency: WRITE_CONCURRENCY
 	});
+	/**
+	* Creates a model, then every child concurrently, one request each.
+	*
+	* - Rejects on the first failed child and leaves the objects already written in place.
+	* @deprecated Use `createModel`, then `createObject` or `createObjects`. Removed in the next major.
+	*/
 	const createModelTree = async (model, children, meta = {}) => {
 		const createdModel = await createModel(model, meta);
 		const items = MODEL_CHILD_OBJECT_TYPES.flatMap((objectType) => (children[objectType] ?? []).map((data) => ({
@@ -548,6 +464,12 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 		});
 		return mapObject(response.data);
 	};
+	/**
+	* Whether a failed delete left the object gone anyway (lost a race).
+	*
+	* - Only `404`: the metastore's "already deleted" `500` is indistinguishable from a real one.
+	*/
+	const isAlreadyDeleted = (error) => isApiError(error) && error.response.status === HttpStatus.NOT_FOUND;
 	const deleteObject = async (objectType, objectUUID) => {
 		await metastoreClient.repository.deleteMetaObject({
 			objectType,
@@ -555,21 +477,11 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 		});
 	};
 	/**
-	* Every child object of a model, across all five types, flattened.
-	*
-	* `deleteModel` uses this to find what to remove; callers can use it to say what a delete
-	* would destroy *before* asking the user to confirm. Each entry's `name` is the object's
-	* display label (a constraint's `displayName` in preference to its `name`, matching what the
-	* SL tables render), so a confirmation lists objects as the user sees them on screen.
+	* Every child object of a model, flattened; `name` is the display label.
 	*
-	* Costs five list requests: the metastore has no per-model filter, so the collections are
-	* fetched whole and filtered client-side.
-	*
-	* **Throws `SemanticLayerUnreadableChildrenError` rather than degrading.** The list reads
-	* degrade — one malformed metric does not hide the other nine — but this answer is what
-	* `deleteModel` and every "what would this destroy?" confirmation is built on, and a short
-	* list there deletes the object it left out. An unreadable child is counted against the model
-	* whenever the raw envelope names it, and against every model when it cannot.
+	* - Five whole-collection requests: the metastore has no per-model filter.
+	* - Throws `SemanticLayerUnreadableChildrenError` rather than degrading: a short list would
+	*   make a cascade delete miss objects.
 	*/
 	const listModelChildren = async (modelUUID, signal) => {
 		const perType = await Promise.all(MODEL_CHILD_OBJECT_TYPES.map(async (objectType) => {
@@ -591,15 +503,11 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 		return perType.flatMap((result) => result.children);
 	};
 	/**
-	* Cascade delete: every child object first, the model itself only once its whole tree is
-	* gone. Child deletes all settle — a failing child never aborts the others, so no delete
-	* runs on detached after this rejects — and a partial failure surfaces as
-	* `SemanticLayerCascadeDeleteError`, which says exactly which children were deleted and
-	* which survived. The model is kept on any child failure so it never orphans children.
+	* Cascade delete: all children settle first; the model goes only if none failed or was unreadable.
 	*
-	* The same holds for a child that could not be *read*: `listModelChildren` throws before the
-	* cascade starts, so an object the read boundary dropped keeps the model alive rather than
-	* being silently left behind pointing at a model that no longer exists.
+	* - Partial failure throws `SemanticLayerCascadeDeleteError`.
+	* - Idempotent under races: a child already gone (404) counts as deleted.
+	* - The model's own 404 is tolerated only after a child was deleted here.
 	*/
 	const deleteModel = async (modelUUID) => {
 		const children = await listModelChildren(modelUUID);
@@ -613,6 +521,10 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 						child
 					};
 				} catch (error) {
+					if (isAlreadyDeleted(error)) return {
+						ok: true,
+						child
+					};
 					return {
 						ok: false,
 						child,
@@ -634,17 +546,20 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 			deletedChildren,
 			failedChildren
 		});
-		await metastoreClient.repository.deleteMetaObject({
-			objectType: SEMANTIC_OBJECT_TYPE.MODEL,
-			UUID: modelUUID
-		});
+		try {
+			await metastoreClient.repository.deleteMetaObject({
+				objectType: SEMANTIC_OBJECT_TYPE.MODEL,
+				UUID: modelUUID
+			});
+		} catch (error) {
+			if (deletedChildren.length === 0 || !isAlreadyDeleted(error)) throw error;
+		}
 	};
 	/**
-	* Replace the sibling projects granted GET/consumption access to a `targeted`-scope object.
+	* Replace the projects granted read access to a `targeted`-scope object.
 	*
-	* Passing an empty array clears every grant, leaving the object visible to its owning project
-	* only. A grant conveys read access alone — the target projects can consume the definition but
-	* never edit it, which is enforced metastore-side rather than here.
+	* - An empty array clears every grant.
+	* - Read-only is enforced metastore-side.
 	*/
 	const replaceTargetProjects = async (objectType, objectUUID, targetProjectIds) => {
 		await metastoreClient.repository.replaceTargetProjects({
@@ -654,12 +569,9 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 		});
 	};
 	/**
-	* Step a project-scoped object up to the organization scope, in place.
+	* Step a project-scoped object up to the organization scope, keeping its UUID and history.
 	*
-	* The object keeps its UUID and revision history; the step-up writes a new revision whose
-	* `project_id` is null. Requires the caller to hold the organization-admin role for the target
-	* organization — a project-admin gets 403 from the metastore, which callers should surface
-	* rather than pre-empt (the same person is often both).
+	* - Needs organization-admin; surface the metastore's 403 rather than pre-empt it.
 	*/
 	const promoteToOrganizationScope = async (objectType, objectUUID) => {
 		const response = await metastoreClient.repository.updateMetaObject({
@@ -689,4 +601,4 @@ const createSemanticLayerSdk = ({ metastoreClient }) => {
 //#endregion
 export { RELATIONSHIP_JOIN_TYPES as _, createSemanticLayerSdk as a, metastoreErrorMessage as b, semanticDatasetSchema as c, semanticModelSchema as d, semanticRelationshipSchema as f, FIELD_ROLES as g, CONSTRAINT_TYPES as h, SemanticLayerUnreadableChildrenError as i, semanticGlossarySchema as l, CONSTRAINT_SEVERITIES as m, SEMANTIC_OBJECT_TYPE as n, SEMANTIC_CHILD_OBJECT_SCHEMAS as o, CONSTRAINT_SCOPES as p, SemanticLayerCascadeDeleteError as r, semanticConstraintSchema as s, MODEL_CHILD_OBJECT_TYPES as t, semanticMetricSchema as u, RULE_OPERATORS as v, SQL_DIALECTS as y };
 
-//# sourceMappingURL=semanticLayer-CSqmtHRo.js.map
+//# sourceMappingURL=semanticLayer-pYy082Ju.js.map

package/dist/semanticLayer-pYy082Ju.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semanticLayer-pYy082Ju.js","names":[],"sources":["../src/sdks/semanticLayer/errorMessage.ts","../src/sdks/semanticLayer/vocabulary.ts","../src/sdks/semanticLayer/schemas.ts","../src/sdks/semanticLayer/readSchemas.ts","../src/sdks/semanticLayer/semanticLayerSdk.ts"],"sourcesContent":["/**\n * The message out of a metastore error body.\n *\n * - Only `errors[].message` says what is wrong; the top-level message is just \"Validation failed\".\n * - Any other shape returns `undefined`, so the caller keeps its own fallback.\n * - Only the first error: the metastore reports fields one at a time.\n */\nexport const metastoreErrorMessage = (data: unknown): string | undefined => {\n  if (typeof data !== 'object' || data === null) return undefined;\n  const errors = (data as { errors?: unknown }).errors;\n  if (!Array.isArray(errors)) return undefined;\n  const first = errors[0];\n  if (typeof first !== 'object' || first === null) return undefined;\n  const message = (first as { message?: unknown }).message;\n  return typeof message === 'string' && message ? message : undefined;\n};\n","/**\n * The closed value sets the metastore accepts inside a semantic object's `data`.\n *\n * - The single runtime source for the unions `./types` derives from these arrays.\n * - Imports nothing: `./types` reads it, never the reverse.\n */\n\n/**\n * The dialects the metastore accepts, case-sensitive.\n *\n * - `SemanticModelData.sql_dialect` stays `string` (narrowing is a major bump); validate against this.\n */\nexport const SQL_DIALECTS = ['Snowflake', 'BigQuery'] as const;\n\nexport const CONSTRAINT_TYPES = [\n  'inequality',\n  'equality',\n  'range',\n  'composition',\n  'exclusion',\n  'temporal',\n  'conditional',\n] as const;\n\n/** Dataset field roles; enumerated, unlike a field's free-form `type`. */\nexport const FIELD_ROLES = ['key', 'dimension', 'measure', 'timestamp'] as const;\n\n/** Constraint severities; unset is stored as `warning`. */\nexport const CONSTRAINT_SEVERITIES = ['error', 'warning', 'info'] as const;\n\n/** Constraint scopes; unset is stored as `global`. */\nexport const CONSTRAINT_SCOPES = ['global', 'per_location', 'per_date', 'per_category'] as const;\n\nexport const RULE_OPERATORS = [\n  '<',\n  '<=',\n  '=',\n  '>=',\n  '>',\n  '!=',\n  'between',\n  'in',\n  'sum_equals',\n  'ratio_between',\n] as const;\n\nexport const RELATIONSHIP_JOIN_TYPES = ['left', 'inner'] as const;\n","import { z } from 'zod';\n\nimport { CONSTRAINT_TYPES, SQL_DIALECTS } from './vocabulary';\n\n/**\n * Write validators for untrusted input; the metastore's own validation errors are opaque.\n *\n * - Only required fields are declared; `looseObject` passes the rest through (the metastore owns the full schema).\n * - The SDK does not parse its own writes.\n * - `modelUUID` is omitted: the SDK injects it.\n */\n\nexport const semanticModelSchema = z.looseObject({\n  name: z.string().min(1),\n  sql_dialect: z.enum(SQL_DIALECTS),\n});\n\nexport const semanticDatasetSchema = z.looseObject({\n  name: z.string().min(1),\n  tableId: z.string().min(1),\n  fqn: z.string().min(1),\n});\n\nexport const semanticMetricSchema = z.looseObject({\n  name: z.string().min(1),\n  sql: z.string().min(1),\n});\n\nexport const semanticRelationshipSchema = z.looseObject({\n  from: z.string().min(1),\n  to: z.string().min(1),\n  on: z.string().min(1),\n});\n\nexport const semanticGlossarySchema = z.looseObject({\n  term: z.string().min(1),\n  definition: z.string().min(1),\n});\n\nexport const semanticConstraintSchema = z.looseObject({\n  name: z.string().min(1),\n  constraintType: z.enum(CONSTRAINT_TYPES),\n  metrics: z.array(z.string()),\n  rule: z.string().min(1),\n});\n\nexport const SEMANTIC_CHILD_OBJECT_SCHEMAS = {\n  'semantic-dataset': semanticDatasetSchema,\n  'semantic-metric': semanticMetricSchema,\n  'semantic-relationship': semanticRelationshipSchema,\n  'semantic-glossary': semanticGlossarySchema,\n  'semantic-constraint': semanticConstraintSchema,\n} as const;\n","import { z } from 'zod';\n\nimport { formatValidationIssues } from '../../errors';\n\nimport type {\n  SemanticAiMetadata,\n  SemanticChildObjectDataMap,\n  SemanticChildObjectType,\n  SemanticConstraintData,\n  SemanticDatasetData,\n  SemanticFieldData,\n  SemanticGlossaryData,\n  SemanticMetricData,\n  SemanticModelData,\n  SemanticObjectMeta,\n  SemanticRelationshipData,\n  SemanticRuleExpression,\n  SemanticValidationQuery,\n} from './types';\nimport {\n  CONSTRAINT_SCOPES,\n  CONSTRAINT_SEVERITIES,\n  CONSTRAINT_TYPES,\n  FIELD_ROLES,\n  RELATIONSHIP_JOIN_TYPES,\n  RULE_OPERATORS,\n} from './vocabulary';\n\n/**\n * What a read of the metastore is allowed to hand back, per object type.\n *\n * - Each schema is annotated with its `./types` type, so the two cannot drift apart.\n * - `looseObject`: fields the metastore adds still reach callers.\n * - An unknown value in an optional enum reads as absent; in a required enum it drops the object.\n */\n\nconst aiMetadataSchema: z.ZodType<SemanticAiMetadata, unknown> = z.looseObject({\n  synonyms: z.array(z.string()).optional(),\n  keywords: z.array(z.string()).optional(),\n  antiKeywords: z.array(z.string()).optional(),\n  hints: z.array(z.string()).optional(),\n  warnings: z.array(z.string()).optional(),\n});\n\nconst fieldSchema: z.ZodType<SemanticFieldData, unknown> = z.looseObject({\n  name: z.string(),\n  description: z.string().optional(),\n  type: z.string().optional(),\n  role: z.enum(FIELD_ROLES).optional().catch(undefined),\n  values: z.array(z.string()).optional(),\n  ai: aiMetadataSchema.optional(),\n});\n\n/**\n * A dataset's `fields`, where a malformed column is dropped rather than the whole dataset.\n *\n * - `schemas.ts` does not validate `fields` on write, so a nameless column can be stored.\n */\nconst datasetFieldsSchema = z.array(z.unknown()).transform((items) =>\n  items.flatMap((element, index) => {\n    const result = fieldSchema.safeParse(element);\n    if (result.success) return [result.data];\n\n    console.warn(\n      `semanticLayerSdk: dropped field #${index} from a semantic-dataset, it does not match ` +\n        `its declared shape`,\n      formatValidationIssues(result.error.issues),\n    );\n    return [];\n  }),\n);\n\nconst ruleExpressionSchema: z.ZodType<SemanticRuleExpression, unknown> = z.looseObject({\n  operator: z.enum(RULE_OPERATORS).optional().catch(undefined),\n  left: z.string().optional(),\n  right: z.string().optional(),\n  bounds: z\n    .looseObject({\n      min: z.number().optional(),\n      max: z.number().optional(),\n    })\n    .optional(),\n});\n\nconst validationQuerySchema: z.ZodType<SemanticValidationQuery, unknown> = z.looseObject({\n  default: z.string().optional(),\n  snowflake: z.string().optional(),\n  bigquery: z.string().optional(),\n});\n\nexport const semanticModelReadSchema: z.ZodType<SemanticModelData, unknown> = z.looseObject({\n  name: z.string(),\n  description: z.string().optional(),\n  sql_dialect: z.string(),\n});\n\nconst semanticDatasetReadSchema: z.ZodType<SemanticDatasetData, unknown> = z.looseObject({\n  modelUUID: z.string(),\n  name: z.string(),\n  tableId: z.string(),\n  fqn: z.string(),\n  description: z.string().optional(),\n  grain: z.string().optional(),\n  primaryKey: z.array(z.string()).optional(),\n  fields: datasetFieldsSchema.optional(),\n  ai: aiMetadataSchema.optional(),\n});\n\nconst semanticMetricReadSchema: z.ZodType<SemanticMetricData, unknown> = z.looseObject({\n  modelUUID: z.string(),\n  name: z.string(),\n  sql: z.string(),\n  dataset: z.string().optional(),\n  description: z.string().optional(),\n});\n\nconst semanticRelationshipReadSchema: z.ZodType<SemanticRelationshipData, unknown> = z.looseObject({\n  modelUUID: z.string(),\n  name: z.string().optional(),\n  from: z.string(),\n  to: z.string(),\n  on: z.string(),\n  type: z.enum(RELATIONSHIP_JOIN_TYPES).optional().catch(undefined),\n});\n\nconst semanticGlossaryReadSchema: z.ZodType<SemanticGlossaryData, unknown> = z.looseObject({\n  modelUUID: z.string(),\n  term: z.string(),\n  definition: z.string(),\n  seeAlso: z.array(z.string()).optional(),\n});\n\nconst semanticConstraintReadSchema: z.ZodType<SemanticConstraintData, unknown> = z.looseObject({\n  modelUUID: z.string(),\n  name: z.string(),\n  displayName: z.string().optional(),\n  description: z.string().optional(),\n  constraintType: z.enum(CONSTRAINT_TYPES),\n  metrics: z.array(z.string()),\n  datasets: z.array(z.string()).optional(),\n  rule: z.string(),\n  ruleExpression: ruleExpressionSchema.optional(),\n  validationQuery: validationQuerySchema.optional(),\n  severity: z.enum(CONSTRAINT_SEVERITIES).optional().catch(undefined),\n  errorMessage: z.string().optional(),\n  remediation: z.string().optional(),\n  isActive: z.boolean().optional(),\n  scope: z.enum(CONSTRAINT_SCOPES).optional().catch(undefined),\n  owner: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n});\n\n/** Keyed by object type so a read can pick the schema from a `SemanticChildObjectType`. */\nexport const SEMANTIC_CHILD_OBJECT_READ_SCHEMAS: {\n  [T in SemanticChildObjectType]: z.ZodType<SemanticChildObjectDataMap[T], unknown>;\n} = {\n  'semantic-dataset': semanticDatasetReadSchema,\n  'semantic-metric': semanticMetricReadSchema,\n  'semantic-relationship': semanticRelationshipReadSchema,\n  'semantic-glossary': semanticGlossaryReadSchema,\n  'semantic-constraint': semanticConstraintReadSchema,\n};\n\nconst semanticObjectMetaSchema: z.ZodType<SemanticObjectMeta, unknown> = z.looseObject({\n  name: z.string().optional(),\n  branch: z.string().optional(),\n  projectId: z.number().optional(),\n  organizationId: z.string().optional(),\n  revision: z.number().optional(),\n  schemaVersion: z.string().optional(),\n  createdAt: z.string().optional(),\n  lastUpdated: z.string().optional(),\n  revisionCreatedAt: z.string().optional(),\n});\n\n/**\n * The envelope every read comes wrapped in, mapped to the `SemanticObject` the SDK returns.\n *\n * - A missing or `null` `meta` normalizes rather than drops the object; no caller needs its fields.\n */\nexport const semanticObjectReadSchema = <TData>(dataSchema: z.ZodType<TData, unknown>) =>\n  z\n    .object({\n      id: z.string(),\n      attributes: dataSchema,\n      meta: semanticObjectMetaSchema.nullish(),\n    })\n    .transform(({ id, attributes, meta }) => ({ uuid: id, data: attributes, meta: meta ?? {} }));\n","import { z } from 'zod';\n\nimport { formatValidationIssues, parseOrThrow } from '../../errors';\nimport { isApiError } from '../../fetchClient';\nimport { HttpStatus } from '../../internal';\nimport { concurrent, generateUUID } from '../../utils';\n\nimport {\n  SEMANTIC_CHILD_OBJECT_READ_SCHEMAS,\n  semanticModelReadSchema,\n  semanticObjectReadSchema,\n} from './readSchemas';\nimport type {\n  CreateSemanticObjectMeta,\n  MetastoreClient,\n  SemanticChildObjectDataMap,\n  SemanticChildObjectType,\n  SemanticModelChildDeleteFailure,\n  SemanticModelChildRef,\n  SemanticModelData,\n  SemanticObject,\n  SemanticObjectMeta,\n  SemanticObjectType,\n  SemanticUnreadableObjectRef,\n  UpdateSemanticObjectMeta,\n} from './types';\n\n/**\n * Thrown by `deleteModel` when the child cascade partially fails.\n *\n * - Every child delete has settled; the model was kept.\n * - `deletedChildren` are gone, `failedChildren` still exist; `errors` holds per-child reasons.\n */\nexport class SemanticLayerCascadeDeleteError extends AggregateError {\n  readonly modelUUID: string;\n  readonly deletedChildren: SemanticModelChildRef[];\n  readonly failedChildren: SemanticModelChildDeleteFailure[];\n\n  constructor({\n    modelUUID,\n    deletedChildren,\n    failedChildren,\n  }: {\n    modelUUID: string;\n    deletedChildren: SemanticModelChildRef[];\n    failedChildren: SemanticModelChildDeleteFailure[];\n  }) {\n    const total = deletedChildren.length + failedChildren.length;\n    super(\n      failedChildren.map((failure) => failure.error),\n      `The model was kept because ${failedChildren.length} of its ${total} child objects ` +\n        `could not be deleted (${deletedChildren.length} deleted).`,\n    );\n    this.name = 'SemanticLayerCascadeDeleteError';\n    this.modelUUID = modelUUID;\n    this.deletedChildren = deletedChildren;\n    this.failedChildren = failedChildren;\n  }\n}\n\n/**\n * Thrown by `listModelChildren` when some child could not be parsed; fails closed.\n *\n * - `deleteModel` reads before the cascade, so nothing is deleted when this throws.\n * - An `unreadable` entry with `modelUUID: null` counts against every model.\n */\nexport class SemanticLayerUnreadableChildrenError extends Error {\n  readonly modelUUID: string;\n  readonly unreadable: SemanticUnreadableObjectRef[];\n\n  constructor({\n    modelUUID,\n    unreadable,\n  }: {\n    modelUUID: string;\n    unreadable: SemanticUnreadableObjectRef[];\n  }) {\n    super(\n      `${unreadable.length} child object(s) of the model could not be read, so what it holds ` +\n        `is unknown and nothing was deleted.`,\n    );\n    this.name = 'SemanticLayerUnreadableChildrenError';\n    this.modelUUID = modelUUID;\n    this.unreadable = unreadable;\n  }\n}\n\nexport const SEMANTIC_OBJECT_TYPE = {\n  MODEL: 'semantic-model',\n  DATASET: 'semantic-dataset',\n  METRIC: 'semantic-metric',\n  RELATIONSHIP: 'semantic-relationship',\n  GLOSSARY: 'semantic-glossary',\n  CONSTRAINT: 'semantic-constraint',\n} as const satisfies Record<string, SemanticObjectType>;\n\n/** `readonly`: it drives what a cascade delete touches. */\nexport const MODEL_CHILD_OBJECT_TYPES: readonly SemanticChildObjectType[] = [\n  SEMANTIC_OBJECT_TYPE.DATASET,\n  SEMANTIC_OBJECT_TYPE.METRIC,\n  SEMANTIC_OBJECT_TYPE.RELATIONSHIP,\n  SEMANTIC_OBJECT_TYPE.GLOSSARY,\n  SEMANTIC_OBJECT_TYPE.CONSTRAINT,\n] as const;\n\nconst DEFAULT_BRANCH = 'main';\n\n// The metastore has no bulk endpoint; writes are concurrent single POSTs.\nconst WRITE_CONCURRENCY = 5;\n\n/**\n * The live metastore envelope; the types in clients/metastore/repository/types.ts do not match it.\n *\n * - Reads parse it (`./readSchemas`); writes assert it, as the metastore echoes a validated object.\n */\ntype RawSemanticObject<TData> = {\n  type: string;\n  id: string;\n  attributes: TData;\n  meta: SemanticObjectMeta;\n};\n\nconst mapObject = <TData>(item: RawSemanticObject<TData>): SemanticObject<TData> => ({\n  uuid: item.id,\n  data: item.attributes,\n  meta: item.meta,\n});\n\n/** The raw `id` of an envelope that failed to parse; `null` means unaddressable. */\nconst envelopeId = (value: unknown): string | null => {\n  if (typeof value !== 'object' || value === null) return null;\n  const { id } = value as { id?: unknown };\n  return typeof id === 'string' && id !== '' ? id : null;\n};\n\n/** The raw `modelUUID` of a dropped envelope; `null` is treated as \"could be any model's\". */\nconst envelopeModelUUID = (value: unknown): string | null => {\n  if (typeof value !== 'object' || value === null) return null;\n  const { attributes } = value as { attributes?: unknown };\n  if (typeof attributes !== 'object' || attributes === null) return null;\n  const { modelUUID } = attributes as { modelUUID?: unknown };\n  return typeof modelUUID === 'string' && modelUUID !== '' ? modelUUID : null;\n};\n\nconst deriveOptionalObjectName = (data: Record<string, unknown>): string | undefined => {\n  if (typeof data.name === 'string') return data.name;\n  if (typeof data.term === 'string') return data.term;\n  return undefined;\n};\n\nconst deriveObjectName = (data: Record<string, unknown>) =>\n  deriveOptionalObjectName(data) ?? generateUUID();\n\n/**\n * The UI label: `displayName ?? name`, matching kbc-ui's constraint tables.\n *\n * - Not used for lookup: `displayName` is not unique.\n */\nconst deriveObjectLabel = (data: Record<string, unknown>): string | undefined => {\n  if (typeof data.displayName === 'string' && data.displayName !== '') return data.displayName;\n  return deriveOptionalObjectName(data);\n};\n\ntype Options = {\n  metastoreClient: MetastoreClient;\n};\n\nexport const createSemanticLayerSdk = ({ metastoreClient }: Options) => {\n  /**\n   * Every object of one type, parsed rather than asserted.\n   *\n   * - A malformed element is dropped, logged and reported in `unreadable`; the rest still list.\n   * - A response that is not a collection throws rather than reading as empty.\n   */\n  const _listObjects = async <TData>(\n    objectType: SemanticObjectType,\n    dataSchema: z.ZodType<TData, unknown>,\n    signal?: AbortSignal,\n  ): Promise<{ objects: SemanticObject<TData>[]; unreadable: SemanticUnreadableObjectRef[] }> => {\n    const response = await metastoreClient.repository.getMetaObjects({ objectType }, signal);\n    const items = parseOrThrow(z.array(z.unknown()), response.data);\n    const schema = semanticObjectReadSchema(dataSchema);\n\n    const objects: SemanticObject<TData>[] = [];\n    const unreadable: SemanticUnreadableObjectRef[] = [];\n\n    for (const item of items) {\n      const result = schema.safeParse(item);\n      if (result.success) {\n        objects.push(result.data);\n        continue;\n      }\n\n      unreadable.push({\n        objectType,\n        objectUUID: envelopeId(item),\n        modelUUID: envelopeModelUUID(item),\n      });\n\n      // Never log the payload: it is customer data.\n      console.warn(\n        `semanticLayerSdk: dropped ${objectType} \"${envelopeId(item) ?? '<no id>'}\" from the ` +\n          `metastore response, it does not match its declared shape`,\n        formatValidationIssues(result.error.issues),\n      );\n    }\n\n    return { objects, unreadable };\n  };\n\n  const listModels = async (signal?: AbortSignal) =>\n    (await _listObjects(SEMANTIC_OBJECT_TYPE.MODEL, semanticModelReadSchema, signal)).objects;\n\n  const createModel = async (data: SemanticModelData, meta: CreateSemanticObjectMeta = {}) => {\n    const response = await metastoreClient.repository.createMetaObject<SemanticModelData>({\n      objectType: SEMANTIC_OBJECT_TYPE.MODEL,\n      data,\n      branch: DEFAULT_BRANCH,\n      ...meta,\n      // Derived name wins over meta.\n      name: data.name,\n    });\n\n    return mapObject(response.data as unknown as RawSemanticObject<SemanticModelData>);\n  };\n\n  const updateModel = async (\n    modelUUID: string,\n    data: Partial<SemanticModelData>,\n    meta: UpdateSemanticObjectMeta = {},\n  ) => {\n    const response = await metastoreClient.repository.updateMetaObject<SemanticModelData>({\n      objectType: SEMANTIC_OBJECT_TYPE.MODEL,\n      UUID: modelUUID,\n      data,\n      ...meta,\n      // Derived name wins over meta.\n      ...(data.name ? { name: data.name } : {}),\n    });\n\n    return mapObject(response.data as unknown as RawSemanticObject<SemanticModelData>);\n  };\n\n  /**\n   * One child collection scoped to a model.\n   *\n   * - `unreadable` includes objects whose envelope names this model or no model.\n   */\n  const _listChildObjects = async <T extends SemanticChildObjectType>(\n    objectType: T,\n    modelUUID: string,\n    signal?: AbortSignal,\n  ) => {\n    const { objects, unreadable } = await _listObjects(\n      objectType,\n      SEMANTIC_CHILD_OBJECT_READ_SCHEMAS[objectType],\n      signal,\n    );\n\n    return {\n      objects: objects.filter((object) => object.data.modelUUID === modelUUID),\n      unreadable: unreadable.filter((ref) => ref.modelUUID === null || ref.modelUUID === modelUUID),\n    };\n  };\n\n  const listObjects = async <T extends SemanticChildObjectType>(\n    objectType: T,\n    modelUUID: string,\n    signal?: AbortSignal,\n  ) => (await _listChildObjects(objectType, modelUUID, signal)).objects;\n\n  /**\n   * A model's child objects by name (`term` for glossary).\n   *\n   * - Returns every match: names are not unique, the caller decides.\n   */\n  const findObjectsByName = async <T extends SemanticChildObjectType>(\n    objectType: T,\n    name: string,\n    modelUUID: string,\n    signal?: AbortSignal,\n  ) => {\n    const objects = await listObjects(objectType, modelUUID, signal);\n    return objects.filter((object) => deriveOptionalObjectName(object.data) === name);\n  };\n\n  const createObject = async <T extends SemanticChildObjectType>(\n    objectType: T,\n    data: SemanticChildObjectDataMap[T],\n    meta: CreateSemanticObjectMeta = {},\n  ) => {\n    const response = await metastoreClient.repository.createMetaObject<\n      SemanticChildObjectDataMap[T]\n    >({\n      objectType,\n      data,\n      branch: DEFAULT_BRANCH,\n      ...meta,\n      // Derived name wins over meta.\n      name: deriveObjectName(data),\n    });\n\n    return mapObject(response.data as unknown as RawSemanticObject<SemanticChildObjectDataMap[T]>);\n  };\n\n  const createObjects = async <T extends SemanticChildObjectType>(\n    objectType: T,\n    items: SemanticChildObjectDataMap[T][],\n    meta: CreateSemanticObjectMeta = {},\n  ) =>\n    concurrent({\n      items,\n      process: async (data) => createObject(objectType, data, meta),\n      concurrency: WRITE_CONCURRENCY,\n    });\n\n  /**\n   * Creates a model, then every child concurrently, one request each.\n   *\n   * - Rejects on the first failed child and leaves the objects already written in place.\n   * @deprecated Use `createModel`, then `createObject` or `createObjects`. Removed in the next major.\n   */\n  const createModelTree = async (\n    model: SemanticModelData,\n    children: Partial<{\n      [T in SemanticChildObjectType]: Omit<SemanticChildObjectDataMap[T], 'modelUUID'>[];\n    }>,\n    meta: CreateSemanticObjectMeta = {},\n  ) => {\n    const createdModel = await createModel(model, meta);\n\n    const items = MODEL_CHILD_OBJECT_TYPES.flatMap((objectType) =>\n      (children[objectType] ?? []).map((data) => ({\n        objectType,\n        data: {\n          ...data,\n          modelUUID: createdModel.uuid,\n        } satisfies SemanticChildObjectDataMap[typeof objectType],\n      })),\n    );\n\n    const createdChildren = await concurrent({\n      items,\n      process: async ({ objectType, data }) => createObject(objectType, data, meta),\n      concurrency: WRITE_CONCURRENCY,\n    });\n\n    return { model: createdModel, children: createdChildren };\n  };\n\n  const updateObject = async <T extends SemanticChildObjectType>(\n    objectType: T,\n    objectUUID: string,\n    data: Partial<SemanticChildObjectDataMap[T]>,\n    meta: UpdateSemanticObjectMeta = {},\n  ) => {\n    const name = deriveOptionalObjectName(data);\n    const response = await metastoreClient.repository.updateMetaObject<\n      SemanticChildObjectDataMap[T]\n    >({\n      objectType,\n      UUID: objectUUID,\n      data,\n      ...meta,\n      // Derived name wins over meta.\n      ...(name ? { name } : {}),\n    });\n\n    return mapObject(response.data as unknown as RawSemanticObject<SemanticChildObjectDataMap[T]>);\n  };\n\n  /**\n   * Whether a failed delete left the object gone anyway (lost a race).\n   *\n   * - Only `404`: the metastore's \"already deleted\" `500` is indistinguishable from a real one.\n   */\n  const isAlreadyDeleted = (error: unknown) =>\n    isApiError(error) && error.response.status === HttpStatus.NOT_FOUND;\n\n  const deleteObject = async (objectType: SemanticChildObjectType, objectUUID: string) => {\n    await metastoreClient.repository.deleteMetaObject({\n      objectType,\n      UUID: objectUUID,\n    });\n  };\n\n  /**\n   * Every child object of a model, flattened; `name` is the display label.\n   *\n   * - Five whole-collection requests: the metastore has no per-model filter.\n   * - Throws `SemanticLayerUnreadableChildrenError` rather than degrading: a short list would\n   *   make a cascade delete miss objects.\n   */\n  const listModelChildren = async (\n    modelUUID: string,\n    signal?: AbortSignal,\n  ): Promise<SemanticModelChildRef[]> => {\n    const perType = await Promise.all(\n      MODEL_CHILD_OBJECT_TYPES.map(async (objectType) => {\n        const { objects, unreadable } = await _listChildObjects(objectType, modelUUID, signal);\n        return {\n          children: objects.map((object) => ({\n            objectType,\n            objectUUID: object.uuid,\n            name: deriveObjectLabel(object.data),\n          })),\n          unreadable,\n        };\n      }),\n    );\n\n    const unreadable = perType.flatMap((result) => result.unreadable);\n    if (unreadable.length > 0) {\n      throw new SemanticLayerUnreadableChildrenError({ modelUUID, unreadable });\n    }\n\n    return perType.flatMap((result) => result.children);\n  };\n\n  /**\n   * Cascade delete: all children settle first; the model goes only if none failed or was unreadable.\n   *\n   * - Partial failure throws `SemanticLayerCascadeDeleteError`.\n   * - Idempotent under races: a child already gone (404) counts as deleted.\n   * - The model's own 404 is tolerated only after a child was deleted here.\n   */\n  const deleteModel = async (modelUUID: string) => {\n    const children = await listModelChildren(modelUUID);\n\n    const outcomes = await concurrent({\n      items: children,\n      process: async (child) => {\n        try {\n          await deleteObject(child.objectType, child.objectUUID);\n          return { ok: true as const, child };\n        } catch (error) {\n          if (isAlreadyDeleted(error)) return { ok: true as const, child };\n          return { ok: false as const, child, error };\n        }\n      },\n      concurrency: WRITE_CONCURRENCY,\n    });\n\n    const deletedChildren: SemanticModelChildRef[] = [];\n    const failedChildren: SemanticModelChildDeleteFailure[] = [];\n    for (const outcome of outcomes) {\n      if (outcome.ok) deletedChildren.push(outcome.child);\n      else failedChildren.push({ ...outcome.child, error: outcome.error });\n    }\n\n    if (failedChildren.length > 0) {\n      throw new SemanticLayerCascadeDeleteError({ modelUUID, deletedChildren, failedChildren });\n    }\n\n    try {\n      await metastoreClient.repository.deleteMetaObject({\n        objectType: SEMANTIC_OBJECT_TYPE.MODEL,\n        UUID: modelUUID,\n      });\n    } catch (error) {\n      // A childless model is indistinguishable from a UUID that was never a model.\n      if (deletedChildren.length === 0 || !isAlreadyDeleted(error)) throw error;\n    }\n  };\n\n  /**\n   * Replace the projects granted read access to a `targeted`-scope object.\n   *\n   * - An empty array clears every grant.\n   * - Read-only is enforced metastore-side.\n   */\n  const replaceTargetProjects = async (\n    objectType: SemanticObjectType,\n    objectUUID: string,\n    targetProjectIds: number[],\n  ) => {\n    await metastoreClient.repository.replaceTargetProjects({\n      objectType,\n      UUID: objectUUID,\n      targetProjectIds,\n    });\n  };\n\n  /**\n   * Step a project-scoped object up to the organization scope, keeping its UUID and history.\n   *\n   * - Needs organization-admin; surface the metastore's 403 rather than pre-empt it.\n   */\n  const promoteToOrganizationScope = async (objectType: SemanticObjectType, objectUUID: string) => {\n    // Scope only, no `data` (not even `{}`): the metastore 400s a scope change combined with data.\n    const response = await metastoreClient.repository.updateMetaObject({\n      objectType,\n      UUID: objectUUID,\n      scope: 'organization',\n    });\n\n    return mapObject(response.data as unknown as RawSemanticObject<Record<string, unknown>>);\n  };\n\n  return {\n    // models\n    listModels,\n    createModel,\n    updateModel,\n    deleteModel,\n    listModelChildren,\n\n    // child objects (datasets, metrics, relationships, glossary, constraints)\n    listObjects,\n    findObjectsByName,\n    createObject,\n    createObjects,\n    createModelTree,\n    updateObject,\n    deleteObject,\n\n    // scoping / sharing\n    replaceTargetProjects,\n    promoteToOrganizationScope,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;AAOA,MAAa,yBAAyB,SAAsC;CAC1E,IAAI,OAAO,SAAS,YAAY,SAAS,MAAM,OAAO,KAAA;CACtD,MAAM,SAAU,KAA8B;CAC9C,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO,KAAA;CACnC,MAAM,QAAQ,OAAO;CACrB,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,UAAW,MAAgC;CACjD,OAAO,OAAO,YAAY,YAAY,UAAU,UAAU,KAAA;AAC5D;;;;;;;;;;;;;;ACHA,MAAa,eAAe,CAAC,aAAa,UAAU;AAEpD,MAAa,mBAAmB;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAGA,MAAa,cAAc;CAAC;CAAO;CAAa;CAAW;AAAW;;AAGtE,MAAa,wBAAwB;CAAC;CAAS;CAAW;AAAM;;AAGhE,MAAa,oBAAoB;CAAC;CAAU;CAAgB;CAAY;AAAc;AAEtF,MAAa,iBAAiB;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,0BAA0B,CAAC,QAAQ,OAAO;;;;;;;;;;AClCvD,MAAa,sBAAsB,EAAE,YAAY;CAC/C,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,aAAa,EAAE,KAAK,YAAY;AAClC,CAAC;AAED,MAAa,wBAAwB,EAAE,YAAY;CACjD,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACzB,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,MAAa,uBAAuB,EAAE,YAAY;CAChD,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,MAAa,6BAA6B,EAAE,YAAY;CACtD,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACpB,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AACtB,CAAC;AAED,MAAa,yBAAyB,EAAE,YAAY;CAClD,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED,MAAa,2BAA2B,EAAE,YAAY;CACpD,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,gBAAgB,EAAE,KAAK,gBAAgB;CACvC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC;CAC3B,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AACxB,CAAC;AAED,MAAa,gCAAgC;CAC3C,oBAAoB;CACpB,mBAAmB;CACnB,yBAAyB;CACzB,qBAAqB;CACrB,uBAAuB;AACzB;;;;;;;;;;AChBA,MAAM,mBAA2D,EAAE,YAAY;CAC7E,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CACvC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CACvC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CACpC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;AACzC,CAAC;AAED,MAAM,cAAqD,EAAE,YAAY;CACvE,MAAM,EAAE,OAAO;CACf,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;CACjC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;CAC1B,MAAM,EAAE,KAAK,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,KAAA,CAAS;CACpD,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CACrC,IAAI,iBAAiB,SAAS;AAChC,CAAC;;;;;;AAOD,MAAM,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,UAC1D,MAAM,SAAS,SAAS,UAAU;CAChC,MAAM,SAAS,YAAY,UAAU,OAAO;CAC5C,IAAI,OAAO,SAAS,OAAO,CAAC,OAAO,IAAI;CAEvC,QAAQ,KACN,oCAAoC,MAAM,iEAE1C,uBAAuB,OAAO,MAAM,MAAM,CAC5C;CACA,OAAO,CAAC;AACV,CAAC,CACH;AAEA,MAAM,uBAAmE,EAAE,YAAY;CACrF,UAAU,EAAE,KAAK,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,KAAA,CAAS;CAC3D,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;CAC1B,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS;CAC3B,QAAQ,EACL,YAAY;EACX,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS;EACzB,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS;CAC3B,CAAC,CAAC,CACD,SAAS;AACd,CAAC;AAED,MAAM,wBAAqE,EAAE,YAAY;CACvF,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS;CAC7B,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CAC/B,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;AAChC,CAAC;AAED,MAAa,0BAAiE,EAAE,YAAY;CAC1F,MAAM,EAAE,OAAO;CACf,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;CACjC,aAAa,EAAE,OAAO;AACxB,CAAC;;AA2DD,MAAa,qCAET;CACF,oBA5DyE,EAAE,YAAY;EACvF,WAAW,EAAE,OAAO;EACpB,MAAM,EAAE,OAAO;EACf,SAAS,EAAE,OAAO;EAClB,KAAK,EAAE,OAAO;EACd,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS;EAC3B,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;EACzC,QAAQ,oBAAoB,SAAS;EACrC,IAAI,iBAAiB,SAAS;CAChC,CAkDsB;CACpB,mBAjDuE,EAAE,YAAY;EACrF,WAAW,EAAE,OAAO;EACpB,MAAM,EAAE,OAAO;EACf,KAAK,EAAE,OAAO;EACd,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS;EAC7B,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;CACnC,CA2CqB;CACnB,yBA1CmF,EAAE,YAAY;EACjG,WAAW,EAAE,OAAO;EACpB,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;EAC1B,MAAM,EAAE,OAAO;EACf,IAAI,EAAE,OAAO;EACb,IAAI,EAAE,OAAO;EACb,MAAM,EAAE,KAAK,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,KAAA,CAAS;CAClE,CAmC2B;CACzB,qBAlC2E,EAAE,YAAY;EACzF,WAAW,EAAE,OAAO;EACpB,MAAM,EAAE,OAAO;EACf,YAAY,EAAE,OAAO;EACrB,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CACxC,CA6BuB;CACrB,uBA5B+E,EAAE,YAAY;EAC7F,WAAW,EAAE,OAAO;EACpB,MAAM,EAAE,OAAO;EACf,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;EACjC,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;EACjC,gBAAgB,EAAE,KAAK,gBAAgB;EACvC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC;EAC3B,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;EACvC,MAAM,EAAE,OAAO;EACf,gBAAgB,qBAAqB,SAAS;EAC9C,iBAAiB,sBAAsB,SAAS;EAChD,UAAU,EAAE,KAAK,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,KAAA,CAAS;EAClE,cAAc,EAAE,OAAO,CAAC,CAAC,SAAS;EAClC,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;EACjC,UAAU,EAAE,QAAQ,CAAC,CAAC,SAAS;EAC/B,OAAO,EAAE,KAAK,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,KAAA,CAAS;EAC3D,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS;EAC3B,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CACrC,CAUyB;AACzB;AAEA,MAAM,2BAAmE,EAAE,YAAY;CACrF,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;CAC1B,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS;CAC5B,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CAC/B,gBAAgB,EAAE,OAAO,CAAC,CAAC,SAAS;CACpC,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;CAC9B,eAAe,EAAE,OAAO,CAAC,CAAC,SAAS;CACnC,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CAC/B,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;CACjC,mBAAmB,EAAE,OAAO,CAAC,CAAC,SAAS;AACzC,CAAC;;;;;;AAOD,MAAa,4BAAmC,eAC9C,EACG,OAAO;CACN,IAAI,EAAE,OAAO;CACb,YAAY;CACZ,MAAM,yBAAyB,QAAQ;AACzC,CAAC,CAAC,CACD,WAAW,EAAE,IAAI,YAAY,YAAY;CAAE,MAAM;CAAI,MAAM;CAAY,MAAM,QAAQ,CAAC;AAAE,EAAE;;;;;;;;;AC1J/F,IAAa,kCAAb,cAAqD,eAAe;CAClE;CACA;CACA;CAEA,YAAY,EACV,WACA,iBACA,kBAKC;EACD,MAAM,QAAQ,gBAAgB,SAAS,eAAe;EACtD,MACE,eAAe,KAAK,YAAY,QAAQ,KAAK,GAC7C,8BAA8B,eAAe,OAAO,UAAU,MAAM,uCACzC,gBAAgB,OAAO,WACpD;EACA,KAAK,OAAO;EACZ,KAAK,YAAY;EACjB,KAAK,kBAAkB;EACvB,KAAK,iBAAiB;CACxB;AACF;;;;;;;AAQA,IAAa,uCAAb,cAA0D,MAAM;CAC9D;CACA;CAEA,YAAY,EACV,WACA,cAIC;EACD,MACE,GAAG,WAAW,OAAO,sGAEvB;EACA,KAAK,OAAO;EACZ,KAAK,YAAY;EACjB,KAAK,aAAa;CACpB;AACF;AAEA,MAAa,uBAAuB;CAClC,OAAO;CACP,SAAS;CACT,QAAQ;CACR,cAAc;CACd,UAAU;CACV,YAAY;AACd;;AAGA,MAAa,2BAA+D;CAC1E,qBAAqB;CACrB,qBAAqB;CACrB,qBAAqB;CACrB,qBAAqB;CACrB,qBAAqB;AACvB;AAEA,MAAM,iBAAiB;AAGvB,MAAM,oBAAoB;AAc1B,MAAM,aAAoB,UAA2D;CACnF,MAAM,KAAK;CACX,MAAM,KAAK;CACX,MAAM,KAAK;AACb;;AAGA,MAAM,cAAc,UAAkC;CACpD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,EAAE,OAAO;CACf,OAAO,OAAO,OAAO,YAAY,OAAO,KAAK,KAAK;AACpD;;AAGA,MAAM,qBAAqB,UAAkC;CAC3D,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,EAAE,eAAe;CACvB,IAAI,OAAO,eAAe,YAAY,eAAe,MAAM,OAAO;CAClE,MAAM,EAAE,cAAc;CACtB,OAAO,OAAO,cAAc,YAAY,cAAc,KAAK,YAAY;AACzE;AAEA,MAAM,4BAA4B,SAAsD;CACtF,IAAI,OAAO,KAAK,SAAS,UAAU,OAAO,KAAK;CAC/C,IAAI,OAAO,KAAK,SAAS,UAAU,OAAO,KAAK;AAEjD;AAEA,MAAM,oBAAoB,SACxB,yBAAyB,IAAI,KAAK,aAAa;;;;;;AAOjD,MAAM,qBAAqB,SAAsD;CAC/E,IAAI,OAAO,KAAK,gBAAgB,YAAY,KAAK,gBAAgB,IAAI,OAAO,KAAK;CACjF,OAAO,yBAAyB,IAAI;AACtC;AAMA,MAAa,0BAA0B,EAAE,sBAA+B;;;;;;;CAOtE,MAAM,eAAe,OACnB,YACA,YACA,WAC6F;EAC7F,MAAM,WAAW,MAAM,gBAAgB,WAAW,eAAe,EAAE,WAAW,GAAG,MAAM;EACvF,MAAM,QAAQ,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,IAAI;EAC9D,MAAM,SAAS,yBAAyB,UAAU;EAElD,MAAM,UAAmC,CAAC;EAC1C,MAAM,aAA4C,CAAC;EAEnD,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,SAAS,OAAO,UAAU,IAAI;GACpC,IAAI,OAAO,SAAS;IAClB,QAAQ,KAAK,OAAO,IAAI;IACxB;GACF;GAEA,WAAW,KAAK;IACd;IACA,YAAY,WAAW,IAAI;IAC3B,WAAW,kBAAkB,IAAI;GACnC,CAAC;GAGD,QAAQ,KACN,6BAA6B,WAAW,IAAI,WAAW,IAAI,KAAK,UAAU,sEAE1E,uBAAuB,OAAO,MAAM,MAAM,CAC5C;EACF;EAEA,OAAO;GAAE;GAAS;EAAW;CAC/B;CAEA,MAAM,aAAa,OAAO,YACvB,MAAM,aAAa,qBAAqB,OAAO,yBAAyB,MAAM,EAAA,CAAG;CAEpF,MAAM,cAAc,OAAO,MAAyB,OAAiC,CAAC,MAAM;EAC1F,MAAM,WAAW,MAAM,gBAAgB,WAAW,iBAAoC;GACpF,YAAY,qBAAqB;GACjC;GACA,QAAQ;GACR,GAAG;GAEH,MAAM,KAAK;EACb,CAAC;EAED,OAAO,UAAU,SAAS,IAAuD;CACnF;CAEA,MAAM,cAAc,OAClB,WACA,MACA,OAAiC,CAAC,MAC/B;EACH,MAAM,WAAW,MAAM,gBAAgB,WAAW,iBAAoC;GACpF,YAAY,qBAAqB;GACjC,MAAM;GACN;GACA,GAAG;GAEH,GAAI,KAAK,OAAO,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;EACzC,CAAC;EAED,OAAO,UAAU,SAAS,IAAuD;CACnF;;;;;;CAOA,MAAM,oBAAoB,OACxB,YACA,WACA,WACG;EACH,MAAM,EAAE,SAAS,eAAe,MAAM,aACpC,YACA,mCAAmC,aACnC,MACF;EAEA,OAAO;GACL,SAAS,QAAQ,QAAQ,WAAW,OAAO,KAAK,cAAc,SAAS;GACvE,YAAY,WAAW,QAAQ,QAAQ,IAAI,cAAc,QAAQ,IAAI,cAAc,SAAS;EAC9F;CACF;CAEA,MAAM,cAAc,OAClB,YACA,WACA,YACI,MAAM,kBAAkB,YAAY,WAAW,MAAM,EAAA,CAAG;;;;;;CAO9D,MAAM,oBAAoB,OACxB,YACA,MACA,WACA,WACG;EAEH,QAAO,MADe,YAAY,YAAY,WAAW,MAAM,EAAA,CAChD,QAAQ,WAAW,yBAAyB,OAAO,IAAI,MAAM,IAAI;CAClF;CAEA,MAAM,eAAe,OACnB,YACA,MACA,OAAiC,CAAC,MAC/B;EACH,MAAM,WAAW,MAAM,gBAAgB,WAAW,iBAEhD;GACA;GACA;GACA,QAAQ;GACR,GAAG;GAEH,MAAM,iBAAiB,IAAI;EAC7B,CAAC;EAED,OAAO,UAAU,SAAS,IAAmE;CAC/F;CAEA,MAAM,gBAAgB,OACpB,YACA,OACA,OAAiC,CAAC,MAElC,WAAW;EACT;EACA,SAAS,OAAO,SAAS,aAAa,YAAY,MAAM,IAAI;EAC5D,aAAa;CACf,CAAC;;;;;;;CAQH,MAAM,kBAAkB,OACtB,OACA,UAGA,OAAiC,CAAC,MAC/B;EACH,MAAM,eAAe,MAAM,YAAY,OAAO,IAAI;EAElD,MAAM,QAAQ,yBAAyB,SAAS,gBAC7C,SAAS,eAAe,CAAC,EAAA,CAAG,KAAK,UAAU;GAC1C;GACA,MAAM;IACJ,GAAG;IACH,WAAW,aAAa;GAC1B;EACF,EAAE,CACJ;EAQA,OAAO;GAAE,OAAO;GAAc,UAAU,MANV,WAAW;IACvC;IACA,SAAS,OAAO,EAAE,YAAY,WAAW,aAAa,YAAY,MAAM,IAAI;IAC5E,aAAa;GACf,CAAC;EAEuD;CAC1D;CAEA,MAAM,eAAe,OACnB,YACA,YACA,MACA,OAAiC,CAAC,MAC/B;EACH,MAAM,OAAO,yBAAyB,IAAI;EAC1C,MAAM,WAAW,MAAM,gBAAgB,WAAW,iBAEhD;GACA;GACA,MAAM;GACN;GACA,GAAG;GAEH,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;EACzB,CAAC;EAED,OAAO,UAAU,SAAS,IAAmE;CAC/F;;;;;;CAOA,MAAM,oBAAoB,UACxB,WAAW,KAAK,KAAK,MAAM,SAAS,WAAW,WAAW;CAE5D,MAAM,eAAe,OAAO,YAAqC,eAAuB;EACtF,MAAM,gBAAgB,WAAW,iBAAiB;GAChD;GACA,MAAM;EACR,CAAC;CACH;;;;;;;;CASA,MAAM,oBAAoB,OACxB,WACA,WACqC;EACrC,MAAM,UAAU,MAAM,QAAQ,IAC5B,yBAAyB,IAAI,OAAO,eAAe;GACjD,MAAM,EAAE,SAAS,eAAe,MAAM,kBAAkB,YAAY,WAAW,MAAM;GACrF,OAAO;IACL,UAAU,QAAQ,KAAK,YAAY;KACjC;KACA,YAAY,OAAO;KACnB,MAAM,kBAAkB,OAAO,IAAI;IACrC,EAAE;IACF;GACF;EACF,CAAC,CACH;EAEA,MAAM,aAAa,QAAQ,SAAS,WAAW,OAAO,UAAU;EAChE,IAAI,WAAW,SAAS,GACtB,MAAM,IAAI,qCAAqC;GAAE;GAAW;EAAW,CAAC;EAG1E,OAAO,QAAQ,SAAS,WAAW,OAAO,QAAQ;CACpD;;;;;;;;CASA,MAAM,cAAc,OAAO,cAAsB;EAC/C,MAAM,WAAW,MAAM,kBAAkB,SAAS;EAElD,MAAM,WAAW,MAAM,WAAW;GAChC,OAAO;GACP,SAAS,OAAO,UAAU;IACxB,IAAI;KACF,MAAM,aAAa,MAAM,YAAY,MAAM,UAAU;KACrD,OAAO;MAAE,IAAI;MAAe;KAAM;IACpC,SAAS,OAAO;KACd,IAAI,iBAAiB,KAAK,GAAG,OAAO;MAAE,IAAI;MAAe;KAAM;KAC/D,OAAO;MAAE,IAAI;MAAgB;MAAO;KAAM;IAC5C;GACF;GACA,aAAa;EACf,CAAC;EAED,MAAM,kBAA2C,CAAC;EAClD,MAAM,iBAAoD,CAAC;EAC3D,KAAK,MAAM,WAAW,UACpB,IAAI,QAAQ,IAAI,gBAAgB,KAAK,QAAQ,KAAK;OAC7C,eAAe,KAAK;GAAE,GAAG,QAAQ;GAAO,OAAO,QAAQ;EAAM,CAAC;EAGrE,IAAI,eAAe,SAAS,GAC1B,MAAM,IAAI,gCAAgC;GAAE;GAAW;GAAiB;EAAe,CAAC;EAG1F,IAAI;GACF,MAAM,gBAAgB,WAAW,iBAAiB;IAChD,YAAY,qBAAqB;IACjC,MAAM;GACR,CAAC;EACH,SAAS,OAAO;GAEd,IAAI,gBAAgB,WAAW,KAAK,CAAC,iBAAiB,KAAK,GAAG,MAAM;EACtE;CACF;;;;;;;CAQA,MAAM,wBAAwB,OAC5B,YACA,YACA,qBACG;EACH,MAAM,gBAAgB,WAAW,sBAAsB;GACrD;GACA,MAAM;GACN;EACF,CAAC;CACH;;;;;;CAOA,MAAM,6BAA6B,OAAO,YAAgC,eAAuB;EAE/F,MAAM,WAAW,MAAM,gBAAgB,WAAW,iBAAiB;GACjE;GACA,MAAM;GACN,OAAO;EACT,CAAC;EAED,OAAO,UAAU,SAAS,IAA6D;CACzF;CAEA,OAAO;EAEL;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;CACF;AACF"}

package/dist/{serviceIds-DRcoTnSd.d.cts → serviceIds-DC-H6ZD9.d.cts}

@@ -19,6 +19,7 @@ declare const ServiceId: {
   readonly Queue: 'queue';
   readonly KaiAssistant: 'kai-assistant';
   readonly KaiAgent: 'kai-agent';
+  readonly BusinessWorkspaceApi: 'business-workspace';
   readonly SyncActions: 'sync-actions';
   readonly Stream: 'stream';
   readonly Notification: 'notification';
@@ -29,4 +30,4 @@ declare const ServiceId: {
 type ServiceId = (typeof ServiceId)[keyof typeof ServiceId];
 //#endregion
 export { ServiceId as t };
-//# sourceMappingURL=serviceIds-DRcoTnSd.d.cts.map
+//# sourceMappingURL=serviceIds-DC-H6ZD9.d.cts.map

package/dist/{serviceIds-DRcoTnSd.d.ts → serviceIds-DC-H6ZD9.d.ts}

@@ -19,6 +19,7 @@ declare const ServiceId: {
   readonly Queue: 'queue';
   readonly KaiAssistant: 'kai-assistant';
   readonly KaiAgent: 'kai-agent';
+  readonly BusinessWorkspaceApi: 'business-workspace';
   readonly SyncActions: 'sync-actions';
   readonly Stream: 'stream';
   readonly Notification: 'notification';
@@ -29,4 +30,4 @@ declare const ServiceId: {
 type ServiceId = (typeof ServiceId)[keyof typeof ServiceId];
 //#endregion
 export { ServiceId as t };
-//# sourceMappingURL=serviceIds-DRcoTnSd.d.ts.map
+//# sourceMappingURL=serviceIds-DC-H6ZD9.d.ts.map

package/dist/status/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_createGenericFetchClient = require("../createGenericFetchClient-o3cPJeRn.cjs");
+const require_createGenericFetchClient = require("../createGenericFetchClient-Dl9cqTvR.cjs");
 require("./types.cjs");
 //#region src/clients/status/statusClient.ts
 const createStatusClient = ({ baseUrl, middlewares }) => {

package/dist/status/index.d.cts

@@ -1,4 +1,4 @@
-import { n as ClientInitOptions } from "../types-_RhBCj4_.cjs";
+import { n as ClientInitOptions } from "../types-DoZtE9tz.cjs";
 import { Maintenance, StatusSummary } from "./types.cjs";
 //#region src/clients/status/statusClient.d.ts
 declare const createStatusClient: ({ baseUrl, middlewares }: Omit<ClientInitOptions, 'auth'>) => {

package/dist/status/index.d.ts

@@ -1,4 +1,4 @@
-import { n as ClientInitOptions } from "../types-Ct0YPy2w.js";
+import { n as ClientInitOptions } from "../types-B2w2TtSA.js";
 import { Maintenance, StatusSummary } from "./types.js";
 //#region src/clients/status/statusClient.d.ts
 declare const createStatusClient: ({ baseUrl, middlewares }: Omit<ClientInitOptions, 'auth'>) => {

package/dist/status/index.js

@@ -1,4 +1,4 @@
-import { t as createGenericFetchClient } from "../createGenericFetchClient-rxvUUbap.js";
+import { t as createGenericFetchClient } from "../createGenericFetchClient-Dg1rgzmG.js";
 import "./types.js";
 //#region src/clients/status/statusClient.ts
 const createStatusClient = ({ baseUrl, middlewares }) => {

package/dist/storage/index.cjs

@@ -1,12 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_storage = require("../storage-BKm7cztt.cjs");
+const require_storage = require("../storage-JinL1y1s.cjs");
 const require_UserError = require("../UserError-CSGO1qII.cjs");
-const require_createFetchClient = require("../createFetchClient-DgMiqTJ8.cjs");
-const require_validateConnectionStatus = require("../validateConnectionStatus-CsvYmCOI.cjs");
-const require_ManagementClientAuthError = require("../ManagementClientAuthError-DD4u0EU7.cjs");
+const require_createFetchClient = require("../createFetchClient-Cwp8max9.cjs");
+const require_validateConnectionStatus = require("../validateConnectionStatus-BEYkQpu9.cjs");
+const require_ManagementClientAuthError = require("../ManagementClientAuthError-DE7lNGZQ.cjs");
 const require_QueryJobTimeoutError = require("../QueryJobTimeoutError-CVNPdCWX.cjs");
 const require_SyncActionError = require("../SyncActionError-BG0zwchi.cjs");
-const require_ValidationError = require("../ValidationError-CLVJCCwH.cjs");
+const require_ValidationError = require("../ValidationError-D65QU0uq.cjs");
 exports.ApiError = require_createFetchClient.ApiError;
 exports.HtmlResponseError = require_validateConnectionStatus.HtmlResponseError;
 exports.ManagementClientAuthError = require_ManagementClientAuthError.ManagementClientAuthError;
@@ -28,4 +28,5 @@ exports.isQueryJobTimeoutError = require_QueryJobTimeoutError.isQueryJobTimeoutE
 exports.isSyncActionError = require_SyncActionError.isSyncActionError;
 exports.isValidationError = require_ValidationError.isValidationError;
 exports.parseOrThrow = require_ValidationError.parseOrThrow;
+exports.readableReason = require_storage.readableReason;
 exports.toBackendSubscribers = require_storage.toBackendSubscribers;