@epam/ai-dial-chat-hooks 1.3.0-dev.37 → 1.3.0-dev.372

package/catalog/resource-save-adapter.d.ts

@@ -0,0 +1,36 @@
+import { CatalogPublishEntityType } from './publish';
+/** What a save step produced: the full id of the resource it wrote. */
+export interface SavedResource {
+    /** Full DIAL Core id `{type}/{bucket}/{path}`. */
+    id: string;
+}
+/** The operations the Save panel runs for a resource that already exists, supplied by each editor. */
+export interface ResourceEditSaveAdapter {
+    /** The publish API entity type of the resource. */
+    publishEntityType: CatalogPublishEntityType;
+    /** Whether the resource has versions; an unversioned one never forks. */
+    isVersioned: boolean;
+    /** Saves the editor's current state in place; the editor's existing Save. */
+    saveInPlace: () => Promise<SavedResource>;
+    /** Writes the edits as `{folderPath}/{name}__{version}`, leaving the stored current version unchanged. Required when `isVersioned`. */
+    saveAsNewVersion?: (version: string, folderPath: string[]) => Promise<SavedResource>;
+    /** Moves a saved resource into `folderPath` of the user's own bucket. */
+    move: (id: string, folderPath: string[]) => Promise<SavedResource>;
+}
+/** The operation the Save panel runs for a resource being created, supplied by each editor. */
+export interface ResourceCreateSaveAdapter {
+    /** The publish API entity type of the resource. */
+    publishEntityType: CatalogPublishEntityType;
+    /** Always `false`: a new resource takes its version from the form, so the panel offers no version choice. */
+    isVersioned: false;
+    /** Creates the resource in `folderPath` of the user's own bucket, never overwriting an existing one. */
+    createIn: (folderPath: string[]) => Promise<SavedResource>;
+}
+/** The resource-specific operations the Save panel runs. */
+export type ResourceSaveAdapter = ResourceEditSaveAdapter | ResourceCreateSaveAdapter;
+/** Returns whether `adapter` creates a new resource rather than saving an existing one. */
+export declare const isResourceCreateAdapter: (adapter: ResourceSaveAdapter) => adapter is ResourceCreateSaveAdapter;
+/** A save failure whose `message` is already translated for the user, e.g. a half-finished version commit. */
+export declare class ResourceSaveError extends Error {
+}
+//# sourceMappingURL=resource-save-adapter.d.ts.map

package/catalog/resource-save-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-save-adapter.d.ts","sourceRoot":"","sources":["../../src/catalog/resource-save-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAE1D,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,sGAAsG;AACtG,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;IACrB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1C,uIAAuI;IACvI,gBAAgB,CAAC,EAAE,CACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE,KACjB,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,yEAAyE;IACzE,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CACpE;AAED,+FAA+F;AAC/F,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,6GAA6G;IAC7G,WAAW,EAAE,KAAK,CAAC;IACnB,wGAAwG;IACxG,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5D;AAED,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAC7B,uBAAuB,GAAG,yBAAyB,CAAC;AAEtD,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,GAClC,SAAS,mBAAmB,KAC3B,OAAO,IAAI,yBAAkD,CAAC;AAEjE,8GAA8G;AAC9G,qBAAa,iBAAkB,SAAQ,KAAK;CAAG"}

package/catalog/resource-save-adapter.js

@@ -0,0 +1,4 @@
+//#region src/catalog/resource-save-adapter.ts
+var e = (e) => "createIn" in e, t = class extends Error {};
+//#endregion
+export { t as ResourceSaveError, e as isResourceCreateAdapter };

package/catalog/resource-save-adapters.d.ts

@@ -0,0 +1,93 @@
+import { ApplicationsApi, CreatePromptDto, PromptsApi, ResourceFoldersResponseDto, SkillsApi, ToolsetBodyDto, ToolsetsApi, UpdatePromptDto } from '@epam/ai-dial-chat-api-client';
+import { ResourceCreateSaveAdapter, ResourceEditSaveAdapter } from './resource-save';
+/** The application operations the application save adapters call. */
+export type ResourceSaveApplicationsApi = Pick<ApplicationsApi, 'moveApplication' | 'forkApplicationVersion' | 'commitApplicationVersion' | 'deleteApplication'>;
+/** The toolset operations {@link createToolsetSaveAdapter} calls. */
+export type ResourceSaveToolsetsApi = Pick<ToolsetsApi, 'updateToolset' | 'createToolset' | 'moveToolset'>;
+/** The prompt operations the prompt save adapters and {@link createPromptFolderLister} call. */
+export type ResourceSavePromptsApi = Pick<PromptsApi, 'listPrompts' | 'createPrompt' | 'updatePrompt' | 'movePrompt'>;
+/** Parameters for {@link createEmbeddedApplicationSaveAdapter}. */
+export interface EmbeddedApplicationSaveAdapterParams {
+    /** Configured applications client. */
+    applicationsApi: ResourceSaveApplicationsApi;
+    /** Full id of the edited application. */
+    applicationId: string;
+    /** Runs the embedded editor's own save of the edited application. */
+    runEmbeddedSave: () => Promise<void>;
+    /** Translated message for a fork whose commit failed, naming the new version. */
+    getCommitFailedMessage: (version: string) => string;
+}
+/** Parameters for {@link createHostApplicationSaveAdapter}. */
+export interface HostApplicationSaveAdapterParams {
+    /** Configured applications client. */
+    applicationsApi: Pick<ResourceSaveApplicationsApi, 'moveApplication'>;
+    /** Full id of the edited application. */
+    applicationId: string;
+    /** Writes the edited values to the application in place. */
+    update: () => Promise<unknown>;
+    /** Creates the edited values as a new application with `version` in `folderPath`, never overwriting. */
+    createVersion: (version: string, folderPath: string[]) => Promise<{
+        id?: string;
+    } | void>;
+}
+/** Parameters for {@link createToolsetSaveAdapter}. */
+export interface ToolsetSaveAdapterParams {
+    /** Configured toolsets client. */
+    toolsetsApi: ResourceSaveToolsetsApi;
+    /** Full id of the edited toolset. */
+    toolsetId: string;
+    /** The edited values, already mapped to the write body. */
+    body: ToolsetBodyDto;
+}
+/** Parameters for {@link createPromptSaveAdapter}. */
+export interface PromptSaveAdapterParams {
+    /** Configured prompts client. */
+    promptsApi: Pick<ResourceSavePromptsApi, 'updatePrompt' | 'movePrompt'>;
+    /** Full id of the edited prompt. */
+    promptId: string;
+    /** The edited values. */
+    body: UpdatePromptDto;
+}
+/**
+ * Save operations for an application whose embedded editor is the single
+ * writer (Quick Apps). A new version is a fork of the stored application,
+ * the editor's save to the original, then a commit that swaps the two
+ * bodies, so the edits land in the new version and the original keeps its
+ * last saved content.
+ */
+export declare const createEmbeddedApplicationSaveAdapter: ({ applicationsApi, applicationId, runEmbeddedSave, getCommitFailedMessage, }: EmbeddedApplicationSaveAdapterParams) => ResourceEditSaveAdapter;
+/**
+ * Save operations for an application the host writes itself (schema-form
+ * and custom apps). A new version is a create-only write of the edited
+ * values, so the stored current version is never touched.
+ */
+export declare const createHostApplicationSaveAdapter: ({ applicationsApi, applicationId, update, createVersion, }: HostApplicationSaveAdapterParams) => ResourceEditSaveAdapter;
+/** Save operations for a toolset; a new version is a create-only write into the chosen folder. */
+export declare const createToolsetSaveAdapter: ({ toolsetsApi, toolsetId, body, }: ToolsetSaveAdapterParams) => ResourceEditSaveAdapter;
+/** Save operations for a prompt: unversioned, so it is updated in place and then moved when its folder changes. */
+export declare const createPromptSaveAdapter: ({ promptsApi, promptId, body, }: PromptSaveAdapterParams) => ResourceEditSaveAdapter;
+/** Parameters for {@link createToolsetCreateAdapter}. */
+export interface ToolsetCreateAdapterParams {
+    /** Configured toolsets client. */
+    toolsetsApi: Pick<ResourceSaveToolsetsApi, 'createToolset'>;
+    /** The new toolset's values, already mapped to the write body. */
+    body: ToolsetBodyDto;
+}
+/** Parameters for {@link createPromptCreateAdapter}. */
+export interface PromptCreateAdapterParams {
+    /** Configured prompts client. */
+    promptsApi: Pick<ResourceSavePromptsApi, 'createPrompt'>;
+    /** The new prompt's values; its folder comes from the panel. */
+    body: Omit<CreatePromptDto, 'folderId'>;
+}
+/** Creates a new toolset in the chosen Personal folder, never overwriting an existing one. */
+export declare const createToolsetCreateAdapter: ({ toolsetsApi, body, }: ToolsetCreateAdapterParams) => ResourceCreateSaveAdapter;
+/** Creates a new prompt in the chosen Personal folder. */
+export declare const createPromptCreateAdapter: ({ promptsApi, body, }: PromptCreateAdapterParams) => ResourceCreateSaveAdapter;
+/** Returns a lister of the caller's prompt folders directly under `path` (plain text, `''` for the root). */
+export declare const createPromptFolderLister: (promptsApi: Pick<ResourceSavePromptsApi, "listPrompts">) => (path: string) => Promise<ResourceFoldersResponseDto>;
+/** The skill operation {@link createSkillFolderLister} calls. */
+export type ResourceSaveSkillsApi = Pick<SkillsApi, 'listSkills'>;
+/** Returns a lister of the grouping folders directly under `path` (plain text, `''` for the root) of the caller's skills in `bucket`. */
+export declare const createSkillFolderLister: (skillsApi: ResourceSaveSkillsApi, bucket: string) => (path: string) => Promise<ResourceFoldersResponseDto>;
+//# sourceMappingURL=resource-save-adapters.d.ts.map

package/catalog/resource-save-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-save-adapters.d.ts","sourceRoot":"","sources":["../../src/catalog/resource-save-adapters.ts"],"names":[],"mappings":"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"}

package/catalog/resource-save-adapters.js

@@ -0,0 +1,116 @@
+import { ResourceSaveError as e } from "./resource-save-adapter.js";
+//#region src/catalog/resource-save-adapters.ts
+var t = (e) => (t, n) => e.moveApplication({
+	applicationName: t,
+	moveResourceDto: { folderPath: n.join("/") }
+}), n = ({ applicationsApi: n, applicationId: r, runEmbeddedSave: i, getCommitFailedMessage: a }) => ({
+	publishEntityType: "application",
+	isVersioned: !0,
+	saveInPlace: async () => (await i(), { id: r }),
+	saveAsNewVersion: async (t, o) => {
+		let { id: s } = await n.forkApplicationVersion({
+			applicationName: r,
+			forkApplicationVersionDto: {
+				version: t,
+				folderPath: o.join("/")
+			}
+		});
+		try {
+			await i();
+		} catch (e) {
+			throw await n.deleteApplication({ applicationName: s }).catch(() => void 0), e;
+		}
+		try {
+			return await n.commitApplicationVersion({
+				applicationName: r,
+				commitApplicationVersionDto: { snapshotId: s }
+			});
+		} catch {
+			throw new e(a(t));
+		}
+	},
+	move: t(n)
+}), r = ({ applicationsApi: e, applicationId: n, update: r, createVersion: i }) => ({
+	publishEntityType: "application",
+	isVersioned: !0,
+	saveInPlace: async () => (await r(), { id: n }),
+	saveAsNewVersion: async (e, t) => {
+		let n = await i(e, t);
+		if (!n?.id) throw Error("Created version has no id");
+		return { id: n.id };
+	},
+	move: t(e)
+}), i = ({ toolsetsApi: e, toolsetId: t, body: n }) => ({
+	publishEntityType: "toolset",
+	isVersioned: !0,
+	saveInPlace: () => e.updateToolset({
+		toolsetName: t,
+		toolsetBodyDto: n
+	}),
+	saveAsNewVersion: (t, r) => e.createToolset({ createToolsetBodyDto: {
+		...n,
+		version: t,
+		createOnly: !0,
+		...r.length > 0 ? { folderPath: r.join("/") } : {}
+	} }),
+	move: (t, n) => e.moveToolset({
+		toolsetName: t,
+		moveResourceDto: { folderPath: n.join("/") }
+	})
+}), a = ({ promptsApi: e, promptId: t, body: n }) => ({
+	publishEntityType: "prompt",
+	isVersioned: !1,
+	saveInPlace: () => e.updatePrompt({
+		id: t,
+		updatePromptDto: n
+	}),
+	move: (t, n) => e.movePrompt({
+		id: t,
+		movePromptDto: { targetFolderId: n.join("/") }
+	})
+}), o = ({ toolsetsApi: e, body: t }) => ({
+	publishEntityType: "toolset",
+	isVersioned: !1,
+	createIn: (n) => e.createToolset({ createToolsetBodyDto: {
+		...t,
+		createOnly: !0,
+		...n.length > 0 ? { folderPath: n.join("/") } : {}
+	} })
+}), s = ({ promptsApi: e, body: t }) => ({
+	publishEntityType: "prompt",
+	isVersioned: !1,
+	createIn: (n) => e.createPrompt({ createPromptDto: {
+		...t,
+		...n.length > 0 ? { folderId: n.join("/") } : {}
+	} })
+}), c = (e) => async (t) => {
+	let { folders: n } = await e.listPrompts(), r = t ? `${t}/` : "";
+	return { folders: n.filter((e) => e.id.startsWith(r) && e.id.length > r.length && !e.id.slice(r.length).includes("/")).map((e) => ({
+		name: e.name,
+		path: e.id
+	})) };
+}, l = (e, t) => async (n) => {
+	let r = [], i = /* @__PURE__ */ new Set(), a;
+	do {
+		let o = await e.listSkills({
+			bucket: t,
+			path: n || void 0,
+			token: a
+		});
+		for (let e of o.items) {
+			if (e.nodeType !== "folder") continue;
+			let t = e.path.replace(/\/$/, "");
+			r.push({
+				name: e.name,
+				path: t
+			});
+		}
+		if (a = o.nextToken, a != null) {
+			if (i.has(a)) break;
+			i.add(a);
+		}
+	} while (a != null);
+	return { folders: r };
+};
+//#endregion
+export { n as createEmbeddedApplicationSaveAdapter, r as createHostApplicationSaveAdapter, s as createPromptCreateAdapter, c as createPromptFolderLister, a as createPromptSaveAdapter, l as createSkillFolderLister, o as createToolsetCreateAdapter, i as createToolsetSaveAdapter };

package/catalog/resource-save.d.ts

@@ -0,0 +1,76 @@
+import { SaveVersionMode, FolderDestination, PublicationRule } from '@epam/ai-dial-publish-panel';
+import { PublishApiClient } from './create-publish-api';
+import { CatalogPublishEntityType } from './publish';
+import { ResourceSaveAdapter } from './resource-save-adapter';
+export * from './resource-save-adapter';
+/** The roots of the Save panel's destination tree. */
+export declare enum SaveDestinationRoot {
+    /** The user's own folders for the resource type. */
+    Personal = "personal",
+    /** The Organization/public bucket; saving here also sends a publish request. */
+    Organization = "organization"
+}
+/** How a save that reached at least its first step ended. */
+export declare enum ResourceSaveOutcome {
+    /** Every step succeeded. */
+    Saved = "saved",
+    /** The save succeeded but moving into the chosen Personal folder failed. */
+    SavedButMoveFailed = "savedButMoveFailed",
+    /** The save succeeded but the publish request failed. */
+    SavedButPublishFailed = "savedButPublishFailed"
+}
+/** Why the new version typed in the Save panel cannot be used. */
+export declare enum ResourceSaveVersionError {
+    /** It does not match the host's version pattern. */
+    Invalid = "invalid",
+    /** It equals the resource's current version. */
+    Unchanged = "unchanged",
+    /** DIAL Core already stores a resource with that version. */
+    Exists = "exists"
+}
+/** What the user chose in the Save panel. */
+export interface ResourceSaveChoice {
+    /** Full id of the resource being edited. */
+    resourceId: string;
+    /** Its current Personal folder. */
+    currentFolderPath: string[];
+    /** Its current version; `undefined` for an unversioned resource. */
+    currentVersion?: string;
+    /** The confirmed destination. */
+    destination: FolderDestination;
+    /** Keep the version or save a new one. Ignored for an unversioned resource. */
+    versionMode: SaveVersionMode;
+    /** The new version, used when `versionMode` is `New`. */
+    newVersion: string;
+    /** Access rules sent with the publish request for an Organization destination. */
+    rules?: PublicationRule[];
+}
+/** Sends the publish request for a saved resource. */
+export type PublishSavedResource = (entityType: CatalogPublishEntityType, id: string, folderPath: string[], version: string | undefined, rules: PublicationRule[]) => Promise<void>;
+/** The result of a save whose first step succeeded. */
+export interface ResourceSaveResult {
+    /** How the later steps ended. */
+    outcome: ResourceSaveOutcome;
+    /** Id of the saved resource (the new version's, after a fork). */
+    savedId: string;
+    /** Whether the resource was created rather than saved. */
+    isCreated: boolean;
+    /** Whether a new version was written. */
+    isNewVersion: boolean;
+    /** Whether a publish request was sent successfully. */
+    isPublished: boolean;
+    /** The error of the step that failed after the save, if any. */
+    error?: unknown;
+}
+/** Returns a {@link PublishSavedResource} that sends the catalog publish request through `client`. */
+export declare const createPublishSavedResource: (client: Pick<PublishApiClient, "publishCatalogEntity">) => PublishSavedResource;
+/**
+ * Runs the Save panel's choice through `adapter`: create the resource in the
+ * chosen Personal folder, or save it in place or as a new version and then
+ * move it into a different Personal folder; for an Organization folder, save
+ * where it lives and publish. Rejects only when the first step fails; a failure
+ * after the save resolves with the matching partial outcome, because the
+ * save itself already happened.
+ */
+export declare const runResourceSave: (adapter: ResourceSaveAdapter, choice: ResourceSaveChoice, publish: PublishSavedResource) => Promise<ResourceSaveResult>;
+//# sourceMappingURL=resource-save.d.ts.map

package/catalog/resource-save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-save.d.ts","sourceRoot":"","sources":["../../src/catalog/resource-save.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,cAAc,yBAAyB,CAAC;AAExC,sDAAsD;AACtD,oBAAY,mBAAmB;IAC7B,oDAAoD;IACpD,QAAQ,aAAa;IACrB,gFAAgF;IAChF,YAAY,iBAAiB;CAC9B;AAED,6DAA6D;AAC7D,oBAAY,mBAAmB;IAC7B,4BAA4B;IAC5B,KAAK,UAAU;IACf,4EAA4E;IAC5E,kBAAkB,uBAAuB;IACzC,yDAAyD;IACzD,qBAAqB,0BAA0B;CAChD;AAED,kEAAkE;AAClE,oBAAY,wBAAwB;IAClC,oDAAoD;IACpD,OAAO,YAAY;IACnB,gDAAgD;IAChD,SAAS,cAAc;IACvB,6DAA6D;IAC7D,MAAM,WAAW;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,+EAA+E;IAC/E,WAAW,EAAE,eAAe,CAAC;IAC7B,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG,CACjC,UAAU,EAAE,wBAAwB,EACpC,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,eAAe,EAAE,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,WAAW,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD,sGAAsG;AACtG,eAAO,MAAM,0BAA0B,GAEnC,QAAQ,IAAI,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,KACrD,oBAOF,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,mBAAmB,EAC5B,QAAQ,kBAAkB,EAC1B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,kBAAkB,CAqE5B,CAAC"}

package/catalog/resource-save.js

@@ -0,0 +1,52 @@
+import { toPublishRuleDto as e } from "./create-publish-api.js";
+import { ResourceSaveError as t, isResourceCreateAdapter as n } from "./resource-save-adapter.js";
+import { SaveVersionMode as r, toFolderPathKey as i } from "@epam/ai-dial-publish-panel";
+//#region src/catalog/resource-save.ts
+var a = /* @__PURE__ */ function(e) {
+	return e.Personal = "personal", e.Organization = "organization", e;
+}({}), o = /* @__PURE__ */ function(e) {
+	return e.Saved = "saved", e.SavedButMoveFailed = "savedButMoveFailed", e.SavedButPublishFailed = "savedButPublishFailed", e;
+}({}), s = /* @__PURE__ */ function(e) {
+	return e.Invalid = "invalid", e.Unchanged = "unchanged", e.Exists = "exists", e;
+}({}), c = (e, t) => i(e) === i(t), l = (t) => async (n, r, i, a, o) => {
+	await t.publishCatalogEntity(n, r, {
+		folderPath: i.join("/"),
+		...a ? { version: a } : {},
+		rules: o.map(e)
+	});
+}, u = async (e, t, i) => {
+	let a = e.isVersioned && t.versionMode === r.New, o = t.destination.rootKey === "organization", s = o ? t.currentFolderPath : t.destination.path, l, u = !1;
+	if (n(e)) ({id: l} = await e.createIn(s));
+	else if (a) {
+		if (!e.saveAsNewVersion) throw Error("This resource cannot be saved as a new version");
+		({id: l} = await e.saveAsNewVersion(t.newVersion, s));
+	} else ({id: l} = await e.saveInPlace()), u = !o && !c(s, t.currentFolderPath);
+	let d = {
+		outcome: "saved",
+		savedId: l,
+		isCreated: n(e),
+		isNewVersion: a,
+		isPublished: !1
+	};
+	if (u && !n(e)) try {
+		({id: d.savedId} = await e.move(l, s));
+	} catch (e) {
+		return {
+			...d,
+			outcome: "savedButMoveFailed",
+			error: e
+		};
+	}
+	if (o) try {
+		await i(e.publishEntityType, d.savedId, t.destination.path, a ? t.newVersion : t.currentVersion, t.rules ?? []), d.isPublished = !0;
+	} catch (e) {
+		return {
+			...d,
+			outcome: "savedButPublishFailed",
+			error: e
+		};
+	}
+	return d;
+};
+//#endregion
+export { t as ResourceSaveError, o as ResourceSaveOutcome, s as ResourceSaveVersionError, a as SaveDestinationRoot, l as createPublishSavedResource, n as isResourceCreateAdapter, u as runResourceSave };

package/catalog/unpublishable-folders.d.ts

@@ -0,0 +1,21 @@
+import { PublishApiClient } from './create-publish-api';
+import { CatalogPublishEntityType } from './publish';
+/** The requests `resolveUnpublishableFolders` issues. */
+export type UnpublishableFoldersClient = Pick<PublishApiClient, 'getCatalogPublishHistory' | 'getCatalogUnpublishAccess'>;
+/** A published entity whose removal the caller may request. */
+export interface UnpublishTarget {
+    /** The publish API's entity type, e.g. `'project'`. */
+    entityType: CatalogPublishEntityType;
+    /** The entity's DIAL Core id: the caller's own source or a `{type}/public/…` copy. */
+    entityId: string;
+    /** Whether the caller owns the source entity in their own bucket. */
+    isOwner: boolean;
+}
+/**
+ * Returns the folders the caller may request removal of `target` from: an
+ * owner's live published folders from publish history; on a public copy its
+ * own folder, for an administrator outright and for anyone else only when the
+ * BFF confirms they published it; otherwise none. Rejects when a request fails.
+ */
+export declare const resolveUnpublishableFolders: (client: UnpublishableFoldersClient, target: UnpublishTarget, isAdmin: boolean) => Promise<string[][]>;
+//# sourceMappingURL=unpublishable-folders.d.ts.map

package/catalog/unpublishable-folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpublishable-folders.d.ts","sourceRoot":"","sources":["../../src/catalog/unpublishable-folders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,KAAK,wBAAwB,EAI9B,MAAM,WAAW,CAAC;AAEnB,yDAAyD;AACzD,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,gBAAgB,EAChB,0BAA0B,GAAG,2BAA2B,CACzD,CAAC;AAEF,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,UAAU,EAAE,wBAAwB,CAAC;IACrC,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;CAClB;AAYD;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GACtC,QAAQ,0BAA0B,EAClC,QAAQ,eAAe,EACvB,SAAS,OAAO,KACf,OAAO,CAAC,MAAM,EAAE,EAAE,CAmBpB,CAAC"}

package/catalog/unpublishable-folders.js

@@ -0,0 +1,21 @@
+import { getPublicCatalogEntityFolderPath as e, isPublicCatalogEntityId as t, mapPublishHistoryEntryDto as n } from "./publish.js";
+//#region src/catalog/unpublishable-folders.ts
+var r = (e) => {
+	let t = /* @__PURE__ */ new Set();
+	return e.filter((e) => {
+		let n = e.join("/");
+		return !t.has(n) && (t.add(n), !0);
+	});
+}, i = async (i, a, o) => {
+	let { entityType: s, entityId: c, isOwner: l } = a;
+	if (t(c)) {
+		if (!o) {
+			let { canUnpublish: e } = await i.getCatalogUnpublishAccess(s, c);
+			if (!e) return [];
+		}
+		return [e(c)];
+	}
+	return l ? r((await i.getCatalogPublishHistory(s, c)).map((e) => n(e).folderPath)) : [];
+};
+//#endregion
+export { i as resolveUnpublishableFolders };

package/catalog/usage-limit-rows.d.ts

@@ -0,0 +1,14 @@
+import { CatalogItemLimits } from '@epam/ai-dial-catalog';
+/** The capped row closest to its limit, with its consumed percentage. */
+export interface WorstCappedRow {
+    /** Period label of that row, e.g. `'Today'`. */
+    label: string;
+    /** Consumed share of that row's limit, rounded and clamped to 0–100. */
+    usedPercent: number;
+}
+/**
+ * Returns the capped row with the highest used/total ratio across every group,
+ * or `undefined` when no row is capped.
+ */
+export declare const findWorstCappedRow: (limits: CatalogItemLimits | undefined) => WorstCappedRow | undefined;
+//# sourceMappingURL=usage-limit-rows.d.ts.map

package/catalog/usage-limit-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit-rows.d.ts","sourceRoot":"","sources":["../../src/catalog/usage-limit-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,uBAAuB,CAAC;AAG/B,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,iBAAiB,GAAG,SAAS,KACpC,cAAc,GAAG,SAwBnB,CAAC"}

package/catalog/usage-limit-rows.js

@@ -0,0 +1,19 @@
+import { isCappedStat as e } from "../shared/usage-stat.js";
+//#region src/catalog/usage-limit-rows.ts
+var t = (t) => t.isUnlimited !== !0 && e(t.total), n = (e) => {
+	let n;
+	for (let r of e?.groups ?? []) for (let e of r.rows) {
+		if (!t(e)) continue;
+		let r = Math.max(e.used, 0) / e.total;
+		(n == null || r > n.ratio) && (n = {
+			label: e.label,
+			ratio: r
+		});
+	}
+	if (n != null) return {
+		label: n.label,
+		usedPercent: Math.min(100, Math.round(n.ratio * 100))
+	};
+};
+//#endregion
+export { n as findWorstCappedRow };

package/catalog/use-publish-history.d.ts

@@ -0,0 +1,19 @@
+import { PublishHistoryEntry } from '@epam/ai-dial-publish-panel';
+/** Host inputs of {@link usePublishHistory}. */
+export interface UsePublishHistoryOptions {
+    /** Whether the publish panel is open; the history is read each time it opens. */
+    isOpen: boolean;
+    /** Id of the entity being published; a change reads its history again. */
+    entityId: string;
+    /** Reads the entity's publication history, already mapped to the panel's entries; the host owns the request. */
+    loadHistory: (entityId: string) => Promise<PublishHistoryEntry[]>;
+}
+/**
+ * Returns the publication history of an entity for a publish panel, read again
+ * on every open so a publication requested since the last one already blocks its
+ * folder. A failed read leaves the history empty (the backend still refuses a
+ * duplicate publication), a read that finishes after the panel closed or the
+ * entity changed is ignored, and another entity's history is never returned.
+ */
+export declare const usePublishHistory: ({ isOpen, entityId, loadHistory, }: UsePublishHistoryOptions) => PublishHistoryEntry[];
+//# sourceMappingURL=use-publish-history.d.ts.map

package/catalog/use-publish-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-publish-history.d.ts","sourceRoot":"","sources":["../../src/catalog/use-publish-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAKvE,gDAAgD;AAChD,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,MAAM,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,gHAAgH;IAChH,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;CACnE;AASD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,oCAI/B,wBAAwB,KAAG,mBAAmB,EA2BhD,CAAC"}

package/catalog/use-publish-history.js

@@ -0,0 +1,25 @@
+import { useEffect as e, useRef as t, useState as n } from "react";
+//#region src/catalog/use-publish-history.ts
+var r = [], i = ({ isOpen: i, entityId: a, loadHistory: o }) => {
+	let [s, c] = n(), l = t(o);
+	return e(() => {
+		l.current = o;
+	}, [o]), e(() => {
+		if (!i) return;
+		let e = !1;
+		return (async () => {
+			let t = r;
+			try {
+				t = await l.current(a);
+			} catch {}
+			e || c({
+				entityId: a,
+				entries: t
+			});
+		})(), () => {
+			e = !0;
+		};
+	}, [i, a]), s?.entityId === a ? s.entries : r;
+};
+//#endregion
+export { i as usePublishHistory };

package/catalog/useApplicationCredentialActions/useApplicationCredentialActions.d.ts

@@ -0,0 +1,57 @@
+import { ApplicationCredentialLoginParams } from '@epam/ai-dial-catalog';
+import { ApplicationExternalServiceDto, ExternalServiceLogoutBodyDto } from '@epam/ai-dial-chat-api-client';
+import { ExternalServiceLoginOutcome, ExternalServiceLoginParams } from '../../external-services/useExternalServiceLogin';
+/** Localized row-error copy `useApplicationCredentialActions` throws for each failed login or logout. */
+export interface ApplicationCredentialActionsLabels {
+    /** Login failed, threw, or ended in an unrecognized outcome. Defaults to `'Failed to log in. Please try again.'`. */
+    loginFailed: string;
+    /** The browser blocked the OAuth popup. Defaults to `'The login popup was blocked by your browser. Please allow popups for this site and try again.'`. */
+    popupBlocked: string;
+    /** A DIAL administrator must approve the application first. Defaults to `"A DIAL administrator must approve this application's access before you can continue. Contact your administrator, then retry."`. */
+    adminConsentRequired: string;
+    /** Offline access is not configured for the user. Defaults to `'Offline access is not configured for your account. Contact your administrator.'`. */
+    offlineUnavailable: string;
+    /** Personal sign-out failed. Defaults to `'Failed to log out. Please try again.'`. */
+    logoutFailed: string;
+}
+/** English defaults of {@link ApplicationCredentialActionsLabels}. */
+export declare const DEFAULT_APPLICATION_CREDENTIAL_ACTIONS_LABELS: ApplicationCredentialActionsLabels;
+/** Parameters accepted by {@link useApplicationCredentialActions}. */
+export interface UseApplicationCredentialActionsParams {
+    /** The application whose external-service credentials are managed. */
+    appId: string;
+    /** The application's authenticated services, as `useApplicationCredentials` returns them. */
+    services: readonly ApplicationExternalServiceDto[];
+    /** The host's external-service login, usually `useExternalServiceLogin().login` pre-wired with its operations. */
+    login: (params: ExternalServiceLoginParams) => Promise<ExternalServiceLoginOutcome>;
+    /** Already-configured DIAL Core operation that clears one service's credentials at the given level. */
+    signOutExternalService: (appId: string, serviceId: string, body: ExternalServiceLogoutBodyDto) => Promise<unknown>;
+    /** Re-reads service statuses, usually `useApplicationCredentials().refresh`. */
+    refresh: () => Promise<void>;
+    /** Localized error copy; every omitted field falls back to {@link DEFAULT_APPLICATION_CREDENTIAL_ACTIONS_LABELS}. */
+    labels?: Partial<ApplicationCredentialActionsLabels>;
+}
+/** Return value of {@link useApplicationCredentialActions}: the catalog `ApplicationCredentials` callbacks. */
+export interface UseApplicationCredentialActionsResult {
+    /**
+     * `onLogin` for the catalog forms. Resolves `true` after a successful login
+     * and status refresh, `false` when the service is unknown or the user
+     * cancelled, and throws an `Error` carrying the localized message otherwise.
+     */
+    onLogin: (serviceId: string, params: ApplicationCredentialLoginParams) => Promise<boolean>;
+    /**
+     * `onLogout` for the catalog forms. Signs out only the user's own
+     * credentials, then refreshes; does nothing for an unknown or DIAL-native
+     * service, and throws an `Error` carrying the localized message when sign-out fails.
+     */
+    onLogout: (serviceId: string) => Promise<void>;
+}
+/**
+ * Owns the application-credentials login/logout flow behind the catalog's
+ * `ApplicationCredentials` forms: builds the user-level login request,
+ * classifies its outcome (success → refresh, cancel → no-op, anything else →
+ * a localized row error), and signs out only USER credentials before refreshing.
+ * Every host operation and string arrives as a parameter.
+ */
+export declare const useApplicationCredentialActions: ({ appId, services, login, signOutExternalService, refresh, labels, }: UseApplicationCredentialActionsParams) => UseApplicationCredentialActionsResult;
+//# sourceMappingURL=useApplicationCredentialActions.d.ts.map

package/catalog/useApplicationCredentialActions/useApplicationCredentialActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApplicationCredentialActions.d.ts","sourceRoot":"","sources":["../../../src/catalog/useApplicationCredentialActions/useApplicationCredentialActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAChC,MAAM,iDAAiD,CAAC;AAGzD,yGAAyG;AACzG,MAAM,WAAW,kCAAkC;IACjD,qHAAqH;IACrH,WAAW,EAAE,MAAM,CAAC;IACpB,0JAA0J;IAC1J,YAAY,EAAE,MAAM,CAAC;IACrB,6MAA6M;IAC7M,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qJAAqJ;IACrJ,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,sEAAsE;AACtE,eAAO,MAAM,6CAA6C,EAAE,kCAUzD,CAAC;AAEJ,sEAAsE;AACtE,MAAM,WAAW,qCAAqC;IACpD,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,QAAQ,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACnD,kHAAkH;IAClH,KAAK,EAAE,CACL,MAAM,EAAE,0BAA0B,KAC/B,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1C,uGAAuG;IACvG,sBAAsB,EAAE,CACtB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,4BAA4B,KAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,gFAAgF;IAChF,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,qHAAqH;IACrH,MAAM,CAAC,EAAE,OAAO,CAAC,kCAAkC,CAAC,CAAC;CACtD;AAED,+GAA+G;AAC/G,MAAM,WAAW,qCAAqC;IACpD;;;;OAIG;IACH,OAAO,EAAE,CACP,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gCAAgC,KACrC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,GAAI,sEAO7C,qCAAqC,KAAG,qCAwE1C,CAAC"}