@keboola/api-client 27.0.0 → 29.0.0

package/dist/appLogs-CNG3yby-.cjs

@@ -0,0 +1,153 @@
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+const require_isPlainObject = require("./isPlainObject-BB3iy87C.cjs");
+const require_createFetchClient = require("./createFetchClient-BsG719K1.cjs");
+let zod = require("zod");
+zod = require_rolldown_runtime.__toESM(zod, 1);
+let dayjs = require("dayjs");
+dayjs = require_rolldown_runtime.__toESM(dayjs, 1);
+let dayjs_plugin_utc_js = require("dayjs/plugin/utc.js");
+dayjs_plugin_utc_js = require_rolldown_runtime.__toESM(dayjs_plugin_utc_js, 1);
+//#region src/domain/appLogs.ts
+/**
+* Reading a data app's container output. Shared by the two clients wrapping sandboxes-service —
+* `dataScience` (`/v1`) and `apps` (`/v2`) — which serve the same logs under different paths, so the
+* tail contract (how a line is parsed, where the next poll resumes, and that an idle app is not an
+* error) is defined once here rather than per surface.
+*/
+dayjs.default.extend(dayjs_plugin_utc_js.default);
+const DEFAULT_LOGS_FILE_NAME = "logs.txt";
+const ISO_TIMESTAMP_REGEX = /\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z/;
+const LEADING_ISO_TIMESTAMP_REGEX = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z)\s?/;
+/** The error envelope sandboxes-service returns; the tail branches on its `code`. */
+const TailError = zod.object({ context: zod.object({ code: zod.string() }) });
+/**
+* There is nothing to read right now, reported per scope: an app whose serving member is asleep
+* answers `apps.appNotRunning`, a deployment that isn't running answers `apps.deploymentNotRunning` —
+* the normal state of a staged or retired one, since a deployment only runs while it is production.
+*/
+const NOTHING_RUNNING_CODES = /* @__PURE__ */ new Set(["apps.appNotRunning", "apps.deploymentNotRunning"]);
+const tryParseJsonl = (line) => {
+	if (!line.startsWith("{")) return null;
+	let parsed;
+	try {
+		parsed = JSON.parse(line);
+	} catch {
+		return null;
+	}
+	if (typeof parsed !== "object" || parsed === null) return null;
+	const { timestamp, message } = parsed;
+	if (typeof timestamp !== "string" || typeof message !== "string") return null;
+	return {
+		timestamp,
+		message
+	};
+};
+const parsePlainTextLine = (line) => {
+	const match = line.match(LEADING_ISO_TIMESTAMP_REGEX);
+	if (match) return {
+		timestamp: match[1],
+		message: line.slice(match[0].length)
+	};
+	return {
+		timestamp: null,
+		message: line
+	};
+};
+const parseLogLine = (line) => tryParseJsonl(line) ?? parsePlainTextLine(line);
+const toLogEntryFromObject = (raw) => {
+	if (typeof raw.message !== "string") return null;
+	return {
+		timestamp: typeof raw.timestamp === "string" ? raw.timestamp : null,
+		message: raw.message
+	};
+};
+const parseLogLines = (raw) => {
+	if (raw === null || raw === void 0 || raw === "") return [];
+	if (Array.isArray(raw)) return raw.flatMap((item) => {
+		if (typeof item === "string") return item === "" ? [] : [parseLogLine(item)];
+		if (require_isPlainObject.isPlainObject(item)) {
+			const entry = toLogEntryFromObject(item);
+			return entry ? [entry] : [];
+		}
+		return [];
+	});
+	if (require_isPlainObject.isPlainObject(raw)) {
+		const entry = toLogEntryFromObject(raw);
+		return entry ? [entry] : [];
+	}
+	if (typeof raw !== "string") return [];
+	const lines = raw.split("\n");
+	const entries = [];
+	for (const line of lines) {
+		if (line === "") continue;
+		entries.push(parseLogLine(line));
+	}
+	return entries;
+};
+const lastLogTimestamp = (entries) => {
+	for (let i = entries.length - 1; i >= 0; i--) {
+		const entry = entries[i];
+		if (!entry) continue;
+		if (entry.timestamp) return entry.timestamp;
+		const match = entry.message.match(ISO_TIMESTAMP_REGEX);
+		if (match) return match[0];
+	}
+	return null;
+};
+const calculateNextLogTimestamp = (timestamp) => {
+	if (timestamp === null) return null;
+	return (0, dayjs.default)(timestamp).utc().add(1, "second").utc().format();
+};
+/**
+* The tail plus the timestamp a follow-up poll resumes from. A {@link NOTHING_RUNNING_CODES} `400`
+* reads as an empty tail rather than an error — an idle app between visits, or a deployment that is
+* not the one currently serving, has no logs to stream and that is its normal condition.
+*/
+const readAppLogsTail = async (fetchTail) => {
+	try {
+		const { data } = await fetchTail();
+		const entries = parseLogLines(data);
+		return {
+			entries,
+			nextLogTimestamp: calculateNextLogTimestamp(lastLogTimestamp(entries))
+		};
+	} catch (error) {
+		if (require_createFetchClient.isApiError(error) && error.response.status === require_createFetchClient.HttpStatus.BAD_REQUEST) {
+			const code = TailError.safeParse(error.data).data?.context?.code;
+			if (code !== void 0 && NOTHING_RUNNING_CODES.has(code)) return {
+				entries: [],
+				nextLogTimestamp: null
+			};
+		}
+		throw error;
+	}
+};
+/** The whole log as a file download, named by the service's `Content-Disposition` where it sets one. */
+const readAppLogsDownload = async (fetchLogs) => {
+	const { data, response } = await fetchLogs();
+	return {
+		logs: data,
+		fileName: require_createFetchClient.parseContentDispositionHeader(response.headers.get(require_createFetchClient.HttpHeader.CONTENT_DISPOSITION)).filename ?? DEFAULT_LOGS_FILE_NAME
+	};
+};
+//#endregion
+Object.defineProperty(exports, "parseLogLines", {
+	enumerable: true,
+	get: function() {
+		return parseLogLines;
+	}
+});
+Object.defineProperty(exports, "readAppLogsDownload", {
+	enumerable: true,
+	get: function() {
+		return readAppLogsDownload;
+	}
+});
+Object.defineProperty(exports, "readAppLogsTail", {
+	enumerable: true,
+	get: function() {
+		return readAppLogsTail;
+	}
+});
+
+//# sourceMappingURL=appLogs-CNG3yby-.cjs.map

package/dist/appLogs-CNG3yby-.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"appLogs-CNG3yby-.cjs","names":["utc","z","record","isPlainObject","isApiError","HttpStatus","parseContentDispositionHeader","HttpHeader"],"sources":["../src/domain/appLogs.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport utc from 'dayjs/plugin/utc.js';\nimport * as z from 'zod';\n\nimport {\n  type ApiResponse,\n  HttpHeader,\n  isApiError,\n  parseContentDispositionHeader,\n} from '../fetchClient';\nimport { HttpStatus } from '../internal';\nimport { isPlainObject } from '../utils/isPlainObject';\n\n/**\n * Reading a data app's container output. Shared by the two clients wrapping sandboxes-service —\n * `dataScience` (`/v1`) and `apps` (`/v2`) — which serve the same logs under different paths, so the\n * tail contract (how a line is parsed, where the next poll resumes, and that an idle app is not an\n * error) is defined once here rather than per surface.\n */\n\ndayjs.extend(utc);\n\nexport type LogEntry = {\n  timestamp: string | null;\n  message: string;\n};\n\nconst DEFAULT_LOGS_FILE_NAME = 'logs.txt';\n\nconst ISO_TIMESTAMP_REGEX = /\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z/;\nconst LEADING_ISO_TIMESTAMP_REGEX = /^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z)\\s?/;\n\n/** The error envelope sandboxes-service returns; the tail branches on its `code`. */\nconst TailError = z.object({\n  context: z.object({\n    code: z.string(),\n  }),\n});\n\n/**\n * There is nothing to read right now, reported per scope: an app whose serving member is asleep\n * answers `apps.appNotRunning`, a deployment that isn't running answers `apps.deploymentNotRunning` —\n * the normal state of a staged or retired one, since a deployment only runs while it is production.\n */\nconst NOTHING_RUNNING_CODES = new Set(['apps.appNotRunning', 'apps.deploymentNotRunning']);\n\nconst tryParseJsonl = (line: string): LogEntry | null => {\n  if (!line.startsWith('{')) return null;\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(line);\n  } catch {\n    return null;\n  }\n\n  if (typeof parsed !== 'object' || parsed === null) return null;\n\n  const record = parsed as Record<string, unknown>;\n  const { timestamp, message } = record;\n\n  if (typeof timestamp !== 'string' || typeof message !== 'string') return null;\n\n  return {\n    timestamp,\n    message,\n  };\n};\n\nconst parsePlainTextLine = (line: string): LogEntry => {\n  const match = line.match(LEADING_ISO_TIMESTAMP_REGEX);\n  if (match) {\n    return { timestamp: match[1]!, message: line.slice(match[0].length) };\n  }\n  return { timestamp: null, message: line };\n};\n\nexport const parseLogLine = (line: string): LogEntry =>\n  tryParseJsonl(line) ?? parsePlainTextLine(line);\n\nconst toLogEntryFromObject = (raw: Record<string, unknown>): LogEntry | null => {\n  if (typeof raw.message !== 'string') return null;\n  return {\n    timestamp: typeof raw.timestamp === 'string' ? raw.timestamp : null,\n    message: raw.message,\n  };\n};\n\nexport const parseLogLines = (raw: unknown): LogEntry[] => {\n  if (raw === null || raw === undefined || raw === '') return [];\n\n  if (Array.isArray(raw)) {\n    return raw.flatMap((item) => {\n      if (typeof item === 'string') return item === '' ? [] : [parseLogLine(item)];\n      if (isPlainObject(item)) {\n        const entry = toLogEntryFromObject(item);\n        return entry ? [entry] : [];\n      }\n      return [];\n    });\n  }\n\n  if (isPlainObject(raw)) {\n    const entry = toLogEntryFromObject(raw);\n    return entry ? [entry] : [];\n  }\n\n  if (typeof raw !== 'string') return [];\n\n  const lines = raw.split('\\n');\n  const entries: LogEntry[] = [];\n  for (const line of lines) {\n    if (line === '') continue;\n    entries.push(parseLogLine(line));\n  }\n  return entries;\n};\n\nexport const lastLogTimestamp = (entries: LogEntry[]) => {\n  for (let i = entries.length - 1; i >= 0; i--) {\n    const entry = entries[i];\n    if (!entry) continue;\n    if (entry.timestamp) return entry.timestamp;\n\n    // A plain-text line may carry a timestamp embedded mid-line (legacy format).\n    const match = entry.message.match(ISO_TIMESTAMP_REGEX);\n    if (match) return match[0];\n  }\n  return null;\n};\n\nconst calculateNextLogTimestamp = (timestamp: string | null) => {\n  if (timestamp === null) return null;\n  return dayjs(timestamp).utc().add(1, 'second').utc().format();\n};\n\n/**\n * The tail plus the timestamp a follow-up poll resumes from. A {@link NOTHING_RUNNING_CODES} `400`\n * reads as an empty tail rather than an error — an idle app between visits, or a deployment that is\n * not the one currently serving, has no logs to stream and that is its normal condition.\n */\nexport const readAppLogsTail = async (fetchTail: () => Promise<ApiResponse<string>>) => {\n  try {\n    const { data } = await fetchTail();\n    const entries = parseLogLines(data);\n\n    return {\n      entries,\n      nextLogTimestamp: calculateNextLogTimestamp(lastLogTimestamp(entries)),\n    };\n  } catch (error) {\n    if (isApiError(error) && error.response.status === HttpStatus.BAD_REQUEST) {\n      const code = TailError.safeParse(error.data).data?.context?.code;\n      if (code !== undefined && NOTHING_RUNNING_CODES.has(code)) {\n        return { entries: [], nextLogTimestamp: null };\n      }\n    }\n    throw error;\n  }\n};\n\n/** The whole log as a file download, named by the service's `Content-Disposition` where it sets one. */\nexport const readAppLogsDownload = async (fetchLogs: () => Promise<ApiResponse<string>>) => {\n  const { data, response } = await fetchLogs();\n  const contentDisposition = parseContentDispositionHeader(\n    response.headers.get(HttpHeader.CONTENT_DISPOSITION),\n  );\n\n  return {\n    logs: data,\n    fileName: contentDisposition.filename ?? DEFAULT_LOGS_FILE_NAME,\n  };\n};\n"],"mappings":"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"}

package/dist/appLogs-Dl5BcCSD.d.cts

@@ -0,0 +1,10 @@
+import "./index-CLPrlyIz.cjs";
+//#region src/domain/appLogs.d.ts
+type LogEntry = {
+  timestamp: string | null;
+  message: string;
+};
+declare const parseLogLines: (raw: unknown) => LogEntry[];
+//#endregion
+export { parseLogLines as n, LogEntry as t };
+//# sourceMappingURL=appLogs-Dl5BcCSD.d.cts.map

package/dist/appLogs-VdgP08aX.d.ts

@@ -0,0 +1,10 @@
+import "./index-8pN6Emos.js";
+//#region src/domain/appLogs.d.ts
+type LogEntry = {
+  timestamp: string | null;
+  message: string;
+};
+declare const parseLogLines: (raw: unknown) => LogEntry[];
+//#endregion
+export { parseLogLines as n, LogEntry as t };
+//# sourceMappingURL=appLogs-VdgP08aX.d.ts.map

package/dist/appLogs-enL9XR9r.js

@@ -0,0 +1,132 @@
+import { t as isPlainObject } from "./isPlainObject-LYW-03uB.js";
+import { d as HttpStatus, l as parseContentDispositionHeader, o as HttpHeader, r as isApiError } from "./createFetchClient-BK0TZK-U.js";
+import * as z$1 from "zod";
+import dayjs from "dayjs";
+import utc from "dayjs/plugin/utc.js";
+//#region src/domain/appLogs.ts
+/**
+* Reading a data app's container output. Shared by the two clients wrapping sandboxes-service —
+* `dataScience` (`/v1`) and `apps` (`/v2`) — which serve the same logs under different paths, so the
+* tail contract (how a line is parsed, where the next poll resumes, and that an idle app is not an
+* error) is defined once here rather than per surface.
+*/
+dayjs.extend(utc);
+const DEFAULT_LOGS_FILE_NAME = "logs.txt";
+const ISO_TIMESTAMP_REGEX = /\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z/;
+const LEADING_ISO_TIMESTAMP_REGEX = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z)\s?/;
+/** The error envelope sandboxes-service returns; the tail branches on its `code`. */
+const TailError = z$1.object({ context: z$1.object({ code: z$1.string() }) });
+/**
+* There is nothing to read right now, reported per scope: an app whose serving member is asleep
+* answers `apps.appNotRunning`, a deployment that isn't running answers `apps.deploymentNotRunning` —
+* the normal state of a staged or retired one, since a deployment only runs while it is production.
+*/
+const NOTHING_RUNNING_CODES = /* @__PURE__ */ new Set(["apps.appNotRunning", "apps.deploymentNotRunning"]);
+const tryParseJsonl = (line) => {
+	if (!line.startsWith("{")) return null;
+	let parsed;
+	try {
+		parsed = JSON.parse(line);
+	} catch {
+		return null;
+	}
+	if (typeof parsed !== "object" || parsed === null) return null;
+	const { timestamp, message } = parsed;
+	if (typeof timestamp !== "string" || typeof message !== "string") return null;
+	return {
+		timestamp,
+		message
+	};
+};
+const parsePlainTextLine = (line) => {
+	const match = line.match(LEADING_ISO_TIMESTAMP_REGEX);
+	if (match) return {
+		timestamp: match[1],
+		message: line.slice(match[0].length)
+	};
+	return {
+		timestamp: null,
+		message: line
+	};
+};
+const parseLogLine = (line) => tryParseJsonl(line) ?? parsePlainTextLine(line);
+const toLogEntryFromObject = (raw) => {
+	if (typeof raw.message !== "string") return null;
+	return {
+		timestamp: typeof raw.timestamp === "string" ? raw.timestamp : null,
+		message: raw.message
+	};
+};
+const parseLogLines = (raw) => {
+	if (raw === null || raw === void 0 || raw === "") return [];
+	if (Array.isArray(raw)) return raw.flatMap((item) => {
+		if (typeof item === "string") return item === "" ? [] : [parseLogLine(item)];
+		if (isPlainObject(item)) {
+			const entry = toLogEntryFromObject(item);
+			return entry ? [entry] : [];
+		}
+		return [];
+	});
+	if (isPlainObject(raw)) {
+		const entry = toLogEntryFromObject(raw);
+		return entry ? [entry] : [];
+	}
+	if (typeof raw !== "string") return [];
+	const lines = raw.split("\n");
+	const entries = [];
+	for (const line of lines) {
+		if (line === "") continue;
+		entries.push(parseLogLine(line));
+	}
+	return entries;
+};
+const lastLogTimestamp = (entries) => {
+	for (let i = entries.length - 1; i >= 0; i--) {
+		const entry = entries[i];
+		if (!entry) continue;
+		if (entry.timestamp) return entry.timestamp;
+		const match = entry.message.match(ISO_TIMESTAMP_REGEX);
+		if (match) return match[0];
+	}
+	return null;
+};
+const calculateNextLogTimestamp = (timestamp) => {
+	if (timestamp === null) return null;
+	return dayjs(timestamp).utc().add(1, "second").utc().format();
+};
+/**
+* The tail plus the timestamp a follow-up poll resumes from. A {@link NOTHING_RUNNING_CODES} `400`
+* reads as an empty tail rather than an error — an idle app between visits, or a deployment that is
+* not the one currently serving, has no logs to stream and that is its normal condition.
+*/
+const readAppLogsTail = async (fetchTail) => {
+	try {
+		const { data } = await fetchTail();
+		const entries = parseLogLines(data);
+		return {
+			entries,
+			nextLogTimestamp: calculateNextLogTimestamp(lastLogTimestamp(entries))
+		};
+	} catch (error) {
+		if (isApiError(error) && error.response.status === HttpStatus.BAD_REQUEST) {
+			const code = TailError.safeParse(error.data).data?.context?.code;
+			if (code !== void 0 && NOTHING_RUNNING_CODES.has(code)) return {
+				entries: [],
+				nextLogTimestamp: null
+			};
+		}
+		throw error;
+	}
+};
+/** The whole log as a file download, named by the service's `Content-Disposition` where it sets one. */
+const readAppLogsDownload = async (fetchLogs) => {
+	const { data, response } = await fetchLogs();
+	return {
+		logs: data,
+		fileName: parseContentDispositionHeader(response.headers.get(HttpHeader.CONTENT_DISPOSITION)).filename ?? DEFAULT_LOGS_FILE_NAME
+	};
+};
+//#endregion
+export { readAppLogsDownload as n, readAppLogsTail as r, parseLogLines as t };
+
+//# sourceMappingURL=appLogs-enL9XR9r.js.map

package/dist/appLogs-enL9XR9r.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appLogs-enL9XR9r.js","names":["z","record"],"sources":["../src/domain/appLogs.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport utc from 'dayjs/plugin/utc.js';\nimport * as z from 'zod';\n\nimport {\n  type ApiResponse,\n  HttpHeader,\n  isApiError,\n  parseContentDispositionHeader,\n} from '../fetchClient';\nimport { HttpStatus } from '../internal';\nimport { isPlainObject } from '../utils/isPlainObject';\n\n/**\n * Reading a data app's container output. Shared by the two clients wrapping sandboxes-service —\n * `dataScience` (`/v1`) and `apps` (`/v2`) — which serve the same logs under different paths, so the\n * tail contract (how a line is parsed, where the next poll resumes, and that an idle app is not an\n * error) is defined once here rather than per surface.\n */\n\ndayjs.extend(utc);\n\nexport type LogEntry = {\n  timestamp: string | null;\n  message: string;\n};\n\nconst DEFAULT_LOGS_FILE_NAME = 'logs.txt';\n\nconst ISO_TIMESTAMP_REGEX = /\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z/;\nconst LEADING_ISO_TIMESTAMP_REGEX = /^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z)\\s?/;\n\n/** The error envelope sandboxes-service returns; the tail branches on its `code`. */\nconst TailError = z.object({\n  context: z.object({\n    code: z.string(),\n  }),\n});\n\n/**\n * There is nothing to read right now, reported per scope: an app whose serving member is asleep\n * answers `apps.appNotRunning`, a deployment that isn't running answers `apps.deploymentNotRunning` —\n * the normal state of a staged or retired one, since a deployment only runs while it is production.\n */\nconst NOTHING_RUNNING_CODES = new Set(['apps.appNotRunning', 'apps.deploymentNotRunning']);\n\nconst tryParseJsonl = (line: string): LogEntry | null => {\n  if (!line.startsWith('{')) return null;\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(line);\n  } catch {\n    return null;\n  }\n\n  if (typeof parsed !== 'object' || parsed === null) return null;\n\n  const record = parsed as Record<string, unknown>;\n  const { timestamp, message } = record;\n\n  if (typeof timestamp !== 'string' || typeof message !== 'string') return null;\n\n  return {\n    timestamp,\n    message,\n  };\n};\n\nconst parsePlainTextLine = (line: string): LogEntry => {\n  const match = line.match(LEADING_ISO_TIMESTAMP_REGEX);\n  if (match) {\n    return { timestamp: match[1]!, message: line.slice(match[0].length) };\n  }\n  return { timestamp: null, message: line };\n};\n\nexport const parseLogLine = (line: string): LogEntry =>\n  tryParseJsonl(line) ?? parsePlainTextLine(line);\n\nconst toLogEntryFromObject = (raw: Record<string, unknown>): LogEntry | null => {\n  if (typeof raw.message !== 'string') return null;\n  return {\n    timestamp: typeof raw.timestamp === 'string' ? raw.timestamp : null,\n    message: raw.message,\n  };\n};\n\nexport const parseLogLines = (raw: unknown): LogEntry[] => {\n  if (raw === null || raw === undefined || raw === '') return [];\n\n  if (Array.isArray(raw)) {\n    return raw.flatMap((item) => {\n      if (typeof item === 'string') return item === '' ? [] : [parseLogLine(item)];\n      if (isPlainObject(item)) {\n        const entry = toLogEntryFromObject(item);\n        return entry ? [entry] : [];\n      }\n      return [];\n    });\n  }\n\n  if (isPlainObject(raw)) {\n    const entry = toLogEntryFromObject(raw);\n    return entry ? [entry] : [];\n  }\n\n  if (typeof raw !== 'string') return [];\n\n  const lines = raw.split('\\n');\n  const entries: LogEntry[] = [];\n  for (const line of lines) {\n    if (line === '') continue;\n    entries.push(parseLogLine(line));\n  }\n  return entries;\n};\n\nexport const lastLogTimestamp = (entries: LogEntry[]) => {\n  for (let i = entries.length - 1; i >= 0; i--) {\n    const entry = entries[i];\n    if (!entry) continue;\n    if (entry.timestamp) return entry.timestamp;\n\n    // A plain-text line may carry a timestamp embedded mid-line (legacy format).\n    const match = entry.message.match(ISO_TIMESTAMP_REGEX);\n    if (match) return match[0];\n  }\n  return null;\n};\n\nconst calculateNextLogTimestamp = (timestamp: string | null) => {\n  if (timestamp === null) return null;\n  return dayjs(timestamp).utc().add(1, 'second').utc().format();\n};\n\n/**\n * The tail plus the timestamp a follow-up poll resumes from. A {@link NOTHING_RUNNING_CODES} `400`\n * reads as an empty tail rather than an error — an idle app between visits, or a deployment that is\n * not the one currently serving, has no logs to stream and that is its normal condition.\n */\nexport const readAppLogsTail = async (fetchTail: () => Promise<ApiResponse<string>>) => {\n  try {\n    const { data } = await fetchTail();\n    const entries = parseLogLines(data);\n\n    return {\n      entries,\n      nextLogTimestamp: calculateNextLogTimestamp(lastLogTimestamp(entries)),\n    };\n  } catch (error) {\n    if (isApiError(error) && error.response.status === HttpStatus.BAD_REQUEST) {\n      const code = TailError.safeParse(error.data).data?.context?.code;\n      if (code !== undefined && NOTHING_RUNNING_CODES.has(code)) {\n        return { entries: [], nextLogTimestamp: null };\n      }\n    }\n    throw error;\n  }\n};\n\n/** The whole log as a file download, named by the service's `Content-Disposition` where it sets one. */\nexport const readAppLogsDownload = async (fetchLogs: () => Promise<ApiResponse<string>>) => {\n  const { data, response } = await fetchLogs();\n  const contentDisposition = parseContentDispositionHeader(\n    response.headers.get(HttpHeader.CONTENT_DISPOSITION),\n  );\n\n  return {\n    logs: data,\n    fileName: contentDisposition.filename ?? DEFAULT_LOGS_FILE_NAME,\n  };\n};\n"],"mappings":"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"}

package/dist/apps/index.cjs

@@ -1,16 +1,231 @@
-'use strict';
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_createOpenapiFetchClient = require("../createOpenapiFetchClient-Cr90VXY4.cjs");
+const require_auth = require("../auth-5HCvCsZO.cjs");
+const require_appLogs = require("../appLogs-CNG3yby-.cjs");
+//#region src/clients/apps/appsClient.ts
+/**
+* `/v2` App Deployments — data apps plus the immutable deployment history behind them. Sibling of
+* the `dataScience` client, which wraps the same service's `/v1` surface.
+*
+* `baseUrl` must already point past the `/v2` prefix (`https://<data-science-host>/v2`); the
+* registry composes it — see `createServiceClients`.
+*
+* Two documented endpoints are deliberately absent: `PATCH /apps/{appId}` has no patchable field
+* yet (`name`/`description` are create-only, so `{}` is the only accepted body), and
+* `POST /apps/{appId}/activity` is apps-proxy's heartbeat, authenticated by a Manage API token with
+* the `apps:proxy` scope that this storage-token client cannot supply.
+*/
+const createAppsClient = ({ baseUrl, middlewares, auth }) => {
+	const client = require_createOpenapiFetchClient.createOpenapiFetchClient({
+		baseUrl,
+		middlewares,
+		headers: require_auth.createAuthHeaders(auth)
+	});
+	const writeOptions = ({ signal }) => ({ signal });
+	/** Service metadata (`appName`, `appVersion`, `apiDocs`) — the `/v2` surface has no `/health-check`. */
+	const healthCheck = async (signal) => {
+		const { data } = await client.get("/", {}, { signal });
+		return data;
+	};
+	const getApps = async (query = {}, signal) => {
+		const { data } = await client.get("/apps", { query }, { signal });
+		return data;
+	};
+	const getApp = async (appId, signal) => {
+		const { data } = await client.get("/apps/{appId}", { path: { appId } }, { signal });
+		return data;
+	};
+	/**
+	* Reserves the app and its Storage configuration only. Content (`parameters`) and auth
+	* (`authorization.app_proxy`) are written afterwards through the Storage API, on the config named
+	* by the response's `componentId`/`branchId`/`configId`.
+	*/
+	const createApp = async (body, options = {}) => {
+		const { data } = await client.post("/apps", { body }, writeOptions(options));
+		return data;
+	};
+	const deleteApp = async (appId, signal) => {
+		await client.delete("/apps/{appId}", { path: { appId } }, { signal });
+	};
+	/**
+	* Drops production routing — the app's URL 404s afterwards. `null` when there was nothing to
+	* unpublish (already unpublished, or never deployed via `/v2`): the service answers `204`.
+	*/
+	const unpublishApp = async (appId, signal) => {
+		const { data } = await client.post("/apps/{appId}/unpublish", { path: { appId } }, { signal });
+		return data;
+	};
+	/**
+	* Sleeps the app now instead of waiting for the idle timer, and disarms wake-on-request: a
+	* visitor gets a `503` until an explicit {@link resumeApp}. `null` when already suspended (`204`).
+	*/
+	const suspendApp = async (appId, signal) => {
+		const { data } = await client.post("/apps/{appId}/suspend", { path: { appId } }, { signal });
+		return data;
+	};
+	/**
+	* Wakes the app now and re-arms wake-on-request. `null` when it was already running (`204`).
+	* The returned app reports `STARTING` — the operator has not confirmed it serving yet.
+	*/
+	const resumeApp = async (appId, signal) => {
+		const { data } = await client.post("/apps/{appId}/resume", { path: { appId } }, { signal });
+		return data;
+	};
+	/** `password` is `null` until one is minted — by the app's first deployment or {@link resetAppPassword}. */
+	const getAppPassword = async (appId, signal) => {
+		const { data } = await client.get("/apps/{appId}/password", { path: { appId } }, { signal });
+		return data;
+	};
+	/** Mints a fresh password, replacing any existing one. Read it back with {@link getAppPassword}. */
+	const resetAppPassword = async (appId, signal) => {
+		const { data } = await client.post("/apps/{appId}/reset-password", { path: { appId } }, { signal });
+		return data;
+	};
+	/**
+	* Runs of the app, newest first — app-wide, so this is where a failed deployment's cause lives
+	* (`failureReason`, `startupLogs`). Narrow to one deployment with `query.deploymentId`.
+	*/
+	const getAppRuns = async (appId, query = {}, signal) => {
+		const { data } = await client.get("/apps/{appId}/runs", {
+			path: { appId },
+			query
+		}, { signal });
+		return data;
+	};
+	const getAppRun = async (appId, runId, signal) => {
+		const { data } = await client.get("/apps/{appId}/runs/{runId}", { path: {
+			appId,
+			runId
+		} }, { signal });
+		return data;
+	};
+	/**
+	* Deploys the app's current config version as a new immutable deployment, promoting it unless
+	* `body.promote` is `false` (a staged release never runs until promoted). The id and `number` come
+	* back synchronously; readiness does not.
+	*/
+	const createDeployment = async (appId, body, options = {}) => {
+		const { data } = await client.post("/apps/{appId}/deployments", {
+			path: { appId },
+			body
+		}, writeOptions(options));
+		return data;
+	};
+	/** Full history, retired (`archived: true`) deployments included — rows outlive their workloads. */
+	const getDeployments = async (appId, signal) => {
+		const { data } = await client.get("/apps/{appId}/deployments", { path: { appId } }, { signal });
+		return data;
+	};
+	const getDeployment = async (appId, deploymentId, signal) => {
+		const { data } = await client.get("/apps/{appId}/deployments/{deploymentId}", { path: {
+			appId,
+			deploymentId
+		} }, { signal });
+		return data;
+	};
+	/**
+	* Retires the deployment: the workload and its rendered-config secret go, the row stays in
+	* history as `archived`. Rejected with a `409` while the app's `production` still names it.
+	*/
+	const deleteDeployment = async (appId, deploymentId, signal) => {
+		await client.delete("/apps/{appId}/deployments/{deploymentId}", { path: {
+			appId,
+			deploymentId
+		} }, { signal });
+	};
+	/**
+	* Makes this deployment production — the same call rolls back, applied to an older one. The route
+	* switches only once the target serves, so the returned app's `production.desiredId` and
+	* `.actualId` differ until it converges. `null` when it was already production (`204`).
+	*/
+	const promoteDeployment = async (appId, deploymentId, signal) => {
+		const { data } = await client.post("/apps/{appId}/deployments/{deploymentId}/promote", { path: {
+			appId,
+			deploymentId
+		} }, { signal });
+		return data;
+	};
+	/**
+	* Container output of the app's currently serving member. `query.since` and `query.lines` are
+	* mutually exclusive; passing neither returns the log from its start.
+	*/
+	const getAppLogsTail = (appId, { query, signal } = {}) => require_appLogs.readAppLogsTail(() => client.get("/apps/{appId}/logs/tail", {
+		path: { appId },
+		query
+	}, { signal }));
+	const getAppLogsDownload = (appId, signal) => require_appLogs.readAppLogsDownload(() => client.get("/apps/{appId}/logs/download", { path: { appId } }, { signal }));
+	const getDeploymentLogsTail = (appId, deploymentId, { query, signal } = {}) => require_appLogs.readAppLogsTail(() => client.get("/apps/{appId}/deployments/{deploymentId}/logs/tail", {
+		path: {
+			appId,
+			deploymentId
+		},
+		query
+	}, { signal }));
+	const getDeploymentLogsDownload = (appId, deploymentId, signal) => require_appLogs.readAppLogsDownload(() => client.get("/apps/{appId}/deployments/{deploymentId}/logs/download", { path: {
+		appId,
+		deploymentId
+	} }, { signal }));
+	/** The app's Git repository — managed or external. `409` when it has none configured. */
+	const getAppGitRepo = async (appId, signal) => {
+		const { data } = await client.get("/apps/{appId}/git-repo", { path: { appId } }, { signal });
+		return data;
+	};
+	/** Credentials of the app's managed repository, per app rather than per deployment. */
+	const getAppGitRepoCredentials = async (appId, signal) => {
+		const { data } = await client.get("/apps/{appId}/git-repo/credentials", { path: { appId } }, { signal });
+		return data;
+	};
+	const getAppGitRepoCredential = async (appId, credentialId, signal) => {
+		const { data } = await client.get("/apps/{appId}/git-repo/credentials/{credentialId}", { path: {
+			appId,
+			credentialId
+		} }, { signal });
+		return data;
+	};
+	/** An `http_token` credential returns its `secret` here and nowhere else — store it now or lose it. */
+	const createAppGitRepoCredential = async (appId, body, options = {}) => {
+		const { data } = await client.post("/apps/{appId}/git-repo/credentials", {
+			path: { appId },
+			body
+		}, writeOptions(options));
+		return data;
+	};
+	const deleteAppGitRepoCredential = async (appId, credentialId, signal) => {
+		await client.delete("/apps/{appId}/git-repo/credentials/{credentialId}", { path: {
+			appId,
+			credentialId
+		} }, { signal });
+	};
+	return {
+		healthCheck,
+		getApps,
+		getApp,
+		createApp,
+		deleteApp,
+		unpublishApp,
+		suspendApp,
+		resumeApp,
+		getAppPassword,
+		resetAppPassword,
+		getAppRuns,
+		getAppRun,
+		createDeployment,
+		getDeployments,
+		getDeployment,
+		deleteDeployment,
+		promoteDeployment,
+		getAppLogsTail,
+		getAppLogsDownload,
+		getDeploymentLogsTail,
+		getDeploymentLogsDownload,
+		getAppGitRepo,
+		getAppGitRepoCredentials,
+		getAppGitRepoCredential,
+		createAppGitRepoCredential,
+		deleteAppGitRepoCredential
+	};
+};
+//#endregion
+exports.createAppsClient = createAppsClient;
 
-var chunkBZB4UVQA_cjs = require('../chunk-BZB4UVQA.cjs');
-require('../chunk-BVRPZKRE.cjs');
-require('../chunk-MRHQJNWF.cjs');
-require('../chunk-K3BLXPLA.cjs');
-require('../chunk-HUQ5ATIL.cjs');
-
-
-
-Object.defineProperty(exports, "createAppsClient", {
-  enumerable: true,
-  get: function () { return chunkBZB4UVQA_cjs.createAppsClient; }
-});
-//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/apps/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"file":"index.cjs","names":["createOpenapiFetchClient","createAuthHeaders","readAppLogsTail","readAppLogsDownload"],"sources":["../../src/clients/apps/appsClient.ts"],"sourcesContent":["import { readAppLogsDownload, readAppLogsTail } from '../../domain/appLogs';\nimport { createOpenapiFetchClient } from '../../fetchClient';\nimport { createAuthHeaders } from '../auth';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  App,\n  AppId,\n  CreateAppBody,\n  CreateCredentialBody,\n  CreateDeploymentBody,\n  CredentialId,\n  DeploymentId,\n  GetAppRunsQuery,\n  GetAppsQuery,\n  GetLogsTailQuery,\n  RunId,\n} from './types';\n\n/**\n * No `idempotencyKey`. The service accepted an `Idempotency-Key` that turned a replayed create\n * into a no-op, and support for it was **dropped on 17 Aug 2026** — the spec still documents the\n * header and has yet to catch up. It was\n * unusable from a browser in any case — the service's `Access-Control-Allow-Headers` never listed\n * the header, so sending it failed the preflight and the request never left the page.\n *\n * Every create here is therefore a genuine create, and a caller that retries one is responsible\n * for the duplicate it may produce.\n */\ntype WriteOptions = {\n  signal?: AbortSignal;\n};\n\ntype LogsTailOptions = {\n  query?: GetLogsTailQuery;\n  signal?: AbortSignal;\n};\n\n/**\n * `/v2` App Deployments — data apps plus the immutable deployment history behind them. Sibling of\n * the `dataScience` client, which wraps the same service's `/v1` surface.\n *\n * `baseUrl` must already point past the `/v2` prefix (`https://<data-science-host>/v2`); the\n * registry composes it — see `createServiceClients`.\n *\n * Two documented endpoints are deliberately absent: `PATCH /apps/{appId}` has no patchable field\n * yet (`name`/`description` are create-only, so `{}` is the only accepted body), and\n * `POST /apps/{appId}/activity` is apps-proxy's heartbeat, authenticated by a Manage API token with\n * the `apps:proxy` scope that this storage-token client cannot supply.\n */\nexport const createAppsClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const client = createOpenapiFetchClient<paths>({\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  });\n\n  const writeOptions = ({ signal }: WriteOptions) => ({ signal });\n\n  /** Service metadata (`appName`, `appVersion`, `apiDocs`) — the `/v2` surface has no `/health-check`. */\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await client.get('/', {}, { signal });\n\n    return data;\n  };\n\n  const getApps = async (query: GetAppsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps', { query }, { signal });\n\n    return data;\n  };\n\n  const getApp = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Reserves the app and its Storage configuration only. Content (`parameters`) and auth\n   * (`authorization.app_proxy`) are written afterwards through the Storage API, on the config named\n   * by the response's `componentId`/`branchId`/`configId`.\n   */\n  const createApp = async (body: CreateAppBody, options: WriteOptions = {}) => {\n    const { data } = await client.post('/apps', { body }, writeOptions(options));\n\n    return data;\n  };\n\n  const deleteApp = async (appId: AppId, signal?: AbortSignal) => {\n    await client.delete('/apps/{appId}', { path: { appId } }, { signal });\n  };\n\n  /**\n   * Drops production routing — the app's URL 404s afterwards. `null` when there was nothing to\n   * unpublish (already unpublished, or never deployed via `/v2`): the service answers `204`.\n   */\n  const unpublishApp = async (appId: AppId, signal?: AbortSignal): Promise<App | null> => {\n    const { data } = await client.post('/apps/{appId}/unpublish', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Sleeps the app now instead of waiting for the idle timer, and disarms wake-on-request: a\n   * visitor gets a `503` until an explicit {@link resumeApp}. `null` when already suspended (`204`).\n   */\n  const suspendApp = async (appId: AppId, signal?: AbortSignal): Promise<App | null> => {\n    const { data } = await client.post('/apps/{appId}/suspend', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Wakes the app now and re-arms wake-on-request. `null` when it was already running (`204`).\n   * The returned app reports `STARTING` — the operator has not confirmed it serving yet.\n   */\n  const resumeApp = async (appId: AppId, signal?: AbortSignal): Promise<App | null> => {\n    const { data } = await client.post('/apps/{appId}/resume', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** `password` is `null` until one is minted — by the app's first deployment or {@link resetAppPassword}. */\n  const getAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/password', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Mints a fresh password, replacing any existing one. Read it back with {@link getAppPassword}. */\n  const resetAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.post(\n      '/apps/{appId}/reset-password',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Runs of the app, newest first — app-wide, so this is where a failed deployment's cause lives\n   * (`failureReason`, `startupLogs`). Narrow to one deployment with `query.deploymentId`.\n   */\n  const getAppRuns = async (appId: AppId, query: GetAppRunsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/runs', { path: { appId }, query }, { signal });\n\n    return data;\n  };\n\n  const getAppRun = async (appId: AppId, runId: RunId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/runs/{runId}',\n      { path: { appId, runId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Deploys the app's current config version as a new immutable deployment, promoting it unless\n   * `body.promote` is `false` (a staged release never runs until promoted). The id and `number` come\n   * back synchronously; readiness does not.\n   */\n  const createDeployment = async (\n    appId: AppId,\n    body?: CreateDeploymentBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  /** Full history, retired (`archived: true`) deployments included — rows outlive their workloads. */\n  const getDeployments = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/deployments', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  const getDeployment = async (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Retires the deployment: the workload and its rendered-config secret go, the row stays in\n   * history as `archived`. Rejected with a `409` while the app's `production` still names it.\n   */\n  const deleteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n  };\n\n  /**\n   * Makes this deployment production — the same call rolls back, applied to an older one. The route\n   * switches only once the target serves, so the returned app's `production.desiredId` and\n   * `.actualId` differ until it converges. `null` when it was already production (`204`).\n   */\n  const promoteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ): Promise<App | null> => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments/{deploymentId}/promote',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Container output of the app's currently serving member. `query.since` and `query.lines` are\n   * mutually exclusive; passing neither returns the log from its start.\n   */\n  const getAppLogsTail = (appId: AppId, { query, signal }: LogsTailOptions = {}) =>\n    readAppLogsTail(() =>\n      client.get('/apps/{appId}/logs/tail', { path: { appId }, query }, { signal }),\n    );\n\n  const getAppLogsDownload = (appId: AppId, signal?: AbortSignal) =>\n    readAppLogsDownload(() =>\n      client.get('/apps/{appId}/logs/download', { path: { appId } }, { signal }),\n    );\n\n  const getDeploymentLogsTail = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    { query, signal }: LogsTailOptions = {},\n  ) =>\n    readAppLogsTail(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/tail',\n        { path: { appId, deploymentId }, query },\n        { signal },\n      ),\n    );\n\n  const getDeploymentLogsDownload = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) =>\n    readAppLogsDownload(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/download',\n        { path: { appId, deploymentId } },\n        { signal },\n      ),\n    );\n\n  /** The app's Git repository — managed or external. `409` when it has none configured. */\n  const getAppGitRepo = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/git-repo', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Credentials of the app's managed repository, per app rather than per deployment. */\n  const getAppGitRepoCredentials = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  const getAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** An `http_token` credential returns its `secret` here and nowhere else — store it now or lose it. */\n  const createAppGitRepoCredential = async (\n    appId: AppId,\n    body: CreateCredentialBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  const deleteAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n  };\n\n  return {\n    healthCheck,\n    getApps,\n    getApp,\n    createApp,\n    deleteApp,\n    unpublishApp,\n    suspendApp,\n    resumeApp,\n    getAppPassword,\n    resetAppPassword,\n    getAppRuns,\n    getAppRun,\n    createDeployment,\n    getDeployments,\n    getDeployment,\n    deleteDeployment,\n    promoteDeployment,\n    getAppLogsTail,\n    getAppLogsDownload,\n    getDeploymentLogsTail,\n    getDeploymentLogsDownload,\n    getAppGitRepo,\n    getAppGitRepoCredentials,\n    getAppGitRepoCredential,\n    createAppGitRepoCredential,\n    deleteAppGitRepoCredential,\n  };\n};\n"],"mappings":"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"}