@burdenoff/microfe-devportal 2026.1108.1 → 2026.1109.1

package/dist/devportal/utils/recaptcha.js

@@ -1,6 +1,5 @@
-//#region src/devportal/utils/recaptcha.ts
+// src/devportal/utils/recaptcha.ts
 async function e(e) {}
-//#endregion
 export { e as executeRecaptcha };
 
 //# sourceMappingURL=recaptcha.js.map

package/dist/devportal/utils/recaptcha.js.map

@@ -1 +1 @@
-{"version":3,"file":"recaptcha.js","names":[],"sources":["../../../src/devportal/utils/recaptcha.ts"],"sourcesContent":["const CAPTCHA_ENABLED = import.meta.env.VITE_CAPTCHA_ENABLED === \"true\";\nconst SCRIPT_ID = \"burdenoff-recaptcha-v3\";\n\ninterface Grecaptcha {\n  ready(callback: () => void): void;\n  execute(siteKey: string, options: { action: string }): Promise<string>;\n}\n\nfunction getGrecaptcha(): Grecaptcha | undefined {\n  return (window as unknown as { grecaptcha?: Grecaptcha }).grecaptcha;\n}\n\nfunction getSiteKey(): string {\n  const siteKey = import.meta.env.VITE_RECAPTCHA_SITE_KEY;\n  if (typeof siteKey !== \"string\" || siteKey.trim().length === 0) {\n    throw new Error(\"reCAPTCHA site key is not configured\");\n  }\n  return siteKey.trim();\n}\n\nfunction loadScript(siteKey: string): Promise<void> {\n  if (getGrecaptcha()?.execute) {\n    return Promise.resolve();\n  }\n\n  const existing = document.getElementById(\n    SCRIPT_ID,\n  ) as HTMLScriptElement | null;\n  if (existing) {\n    return new Promise((resolve, reject) => {\n      existing.addEventListener(\"load\", () => resolve(), { once: true });\n      existing.addEventListener(\n        \"error\",\n        () => reject(new Error(\"Failed to load reCAPTCHA\")),\n        {\n          once: true,\n        },\n      );\n    });\n  }\n\n  return new Promise((resolve, reject) => {\n    const script = document.createElement(\"script\");\n    script.id = SCRIPT_ID;\n    script.async = true;\n    script.defer = true;\n    script.src = `https://www.google.com/recaptcha/api.js?render=${encodeURIComponent(siteKey)}`;\n    script.addEventListener(\"load\", () => resolve(), { once: true });\n    script.addEventListener(\n      \"error\",\n      () => reject(new Error(\"Failed to load reCAPTCHA\")),\n      {\n        once: true,\n      },\n    );\n    document.head.appendChild(script);\n  });\n}\n\nexport async function executeRecaptcha(\n  action: string,\n): Promise<string | undefined> {\n  if (!CAPTCHA_ENABLED) {\n    return undefined;\n  }\n\n  const siteKey = getSiteKey();\n  await loadScript(siteKey);\n  const grecaptcha = getGrecaptcha();\n  if (!grecaptcha?.execute) {\n    throw new Error(\"reCAPTCHA is not available\");\n  }\n\n  return new Promise((resolve, reject) => {\n    grecaptcha.ready(() => {\n      grecaptcha.execute(siteKey, { action }).then(resolve).catch(reject);\n    });\n  });\n}\n"],"mappings":";AA2DA,eAAsB,EACpB,GAC6B"}
+{"version":3,"file":"recaptcha.js","names":["executeRecaptcha"],"sources":["../../../src/devportal/utils/recaptcha.ts"],"sourcesContent":["const CAPTCHA_ENABLED = import.meta.env.VITE_CAPTCHA_ENABLED === \"true\";\nconst SCRIPT_ID = \"burdenoff-recaptcha-v3\";\n\ninterface Grecaptcha {\n  ready(callback: () => void): void;\n  execute(siteKey: string, options: { action: string }): Promise<string>;\n}\n\nfunction getGrecaptcha(): Grecaptcha | undefined {\n  return (window as unknown as { grecaptcha?: Grecaptcha }).grecaptcha;\n}\n\nfunction getSiteKey(): string {\n  const siteKey = import.meta.env.VITE_RECAPTCHA_SITE_KEY;\n  if (typeof siteKey !== \"string\" || siteKey.trim().length === 0) {\n    throw new Error(\"reCAPTCHA site key is not configured\");\n  }\n  return siteKey.trim();\n}\n\nfunction loadScript(siteKey: string): Promise<void> {\n  if (getGrecaptcha()?.execute) {\n    return Promise.resolve();\n  }\n\n  const existing = document.getElementById(\n    SCRIPT_ID,\n  ) as HTMLScriptElement | null;\n  if (existing) {\n    return new Promise((resolve, reject) => {\n      existing.addEventListener(\"load\", () => resolve(), { once: true });\n      existing.addEventListener(\n        \"error\",\n        () => reject(new Error(\"Failed to load reCAPTCHA\")),\n        {\n          once: true,\n        },\n      );\n    });\n  }\n\n  return new Promise((resolve, reject) => {\n    const script = document.createElement(\"script\");\n    script.id = SCRIPT_ID;\n    script.async = true;\n    script.defer = true;\n    script.src = `https://www.google.com/recaptcha/api.js?render=${encodeURIComponent(siteKey)}`;\n    script.addEventListener(\"load\", () => resolve(), { once: true });\n    script.addEventListener(\n      \"error\",\n      () => reject(new Error(\"Failed to load reCAPTCHA\")),\n      {\n        once: true,\n      },\n    );\n    document.head.appendChild(script);\n  });\n}\n\nexport async function executeRecaptcha(\n  action: string,\n): Promise<string | undefined> {\n  if (!CAPTCHA_ENABLED) {\n    return undefined;\n  }\n\n  const siteKey = getSiteKey();\n  await loadScript(siteKey);\n  const grecaptcha = getGrecaptcha();\n  if (!grecaptcha?.execute) {\n    throw new Error(\"reCAPTCHA is not available\");\n  }\n\n  return new Promise((resolve, reject) => {\n    grecaptcha.ready(() => {\n      grecaptcha.execute(siteKey, { action }).then(resolve).catch(reject);\n    });\n  });\n}\n"],"mappings":";AA2DA,eAAsBA,EACpB,GAC6B,CAiB/B"}

package/dist/devportal/utils/submitForReview.d.ts

@@ -37,4 +37,3 @@ export declare function submitErrorMessage(error: unknown): string;
  * failure and reports it instead of throwing.
  */
 export declare function submitForReview(versions: readonly VersionLike[], steps: SubmitForReviewSteps): Promise<SubmitForReviewResult>;
-//# sourceMappingURL=submitForReview.d.ts.map

package/dist/devportal/utils/submitForReview.js

@@ -1,37 +1,38 @@
-function e(e) {
+// src/devportal/utils/submitForReview.ts
+var e = "Your app could not be submitted for review. Nothing was sent to reviewers. Try again in a moment; if it keeps failing, contact support.";
+function t(e) {
 	return e.filter((e) => e.status === "draft").map((e) => e.id);
 }
-function t(e) {
+function n(e) {
 	return typeof e == "object" && e && !Array.isArray(e) ? e : null;
 }
-function n(e) {
+function r(e) {
 	if (typeof e != "string") return null;
 	let t = e.trim();
 	return !t || /^(unexpected error|response not successful|failed to fetch|network ?error)/i.test(t) ? null : t;
 }
-function r(e) {
-	let r = t(e);
+function i(e) {
+	let t = n(e);
 	for (let e of ["errors", "graphQLErrors"]) {
-		let i = r?.[e];
+		let i = t?.[e];
 		if (Array.isArray(i)) for (let e of i) {
-			let r = n(t(e)?.message);
-			if (r) return r;
+			let t = r(n(e)?.message);
+			if (t) return t;
 		}
 	}
-	return e instanceof Error ? n(e.message) ?? "Your app could not be submitted for review. Nothing was sent to reviewers. Try again in a moment; if it keeps failing, contact support." : n(r?.message) ?? "Your app could not be submitted for review. Nothing was sent to reviewers. Try again in a moment; if it keeps failing, contact support.";
+	return e instanceof Error ? r(e.message) ?? "Your app could not be submitted for review. Nothing was sent to reviewers. Try again in a moment; if it keeps failing, contact support." : r(t?.message) ?? "Your app could not be submitted for review. Nothing was sent to reviewers. Try again in a moment; if it keeps failing, contact support.";
 }
-async function i(t, n) {
+async function a(e, n) {
 	try {
-		for (let r of e(t)) await n.publishVersion(r);
+		for (let r of t(e)) await n.publishVersion(r);
 		return await n.submitApplication(), { ok: !0 };
 	} catch (e) {
 		return console.warn("[DevPortal] Submit for review failed:", e), {
 			ok: !1,
-			message: r(e)
+			message: i(e)
 		};
 	}
 }
-//#endregion
-export { i as submitForReview };
+export { e as SUBMIT_FAILED_MESSAGE, t as draftVersionIds, i as submitErrorMessage, a as submitForReview };
 
 //# sourceMappingURL=submitForReview.js.map

package/dist/devportal/utils/submitForReview.js.map

@@ -1 +1 @@
-{"version":3,"file":"submitForReview.js","names":[],"sources":["../../../src/devportal/utils/submitForReview.ts"],"sourcesContent":["/**\n * Submit-for-review flow for the application page.\n *\n * The page used to run these steps inline and swallow any failure with a\n * console.error, so when the store refused a submission the developer saw no\n * message: the app silently stayed a draft (BOFF-10636). The flow is pure here\n * so the page only renders the outcome, and the error mapping is unit tested.\n */\n\n/** Fallback when a failure carries no message a developer can use. */\nexport const SUBMIT_FAILED_MESSAGE =\n  \"Your app could not be submitted for review. Nothing was sent to reviewers. Try again in a moment; if it keeps failing, contact support.\";\n\nexport interface VersionLike {\n  id: string;\n  status: string;\n}\n\nexport interface SubmitForReviewSteps {\n  /** Moves one draft version into review together with the app. */\n  publishVersion: (versionId: string) => Promise<unknown>;\n  /** Submits the application itself. */\n  submitApplication: () => Promise<unknown>;\n}\n\nexport type SubmitForReviewResult =\n  | { ok: true }\n  | { ok: false; message: string };\n\n/** Draft versions go into review together with the app. */\nexport function draftVersionIds(versions: readonly VersionLike[]): string[] {\n  return versions.filter((v) => v.status === \"draft\").map((v) => v.id);\n}\n\nfunction readRecord(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? // Narrowed to a non-null, non-array object above; fields are read defensively below.\n      (value as Record<string, unknown>)\n    : null;\n}\n\nfunction usableMessage(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const message = value.trim();\n  if (!message) return null;\n  // Transport noise (\"Unexpected error.\", \"Response not successful: ...\",\n  // \"Failed to fetch\") tells the developer nothing they can act on.\n  if (\n    /^(unexpected error|response not successful|failed to fetch|network ?error)/i.test(\n      message,\n    )\n  ) {\n    return null;\n  }\n  return message;\n}\n\n/**\n * The message to show for a failed submission: the first GraphQL error the\n * backend sent (it forwards actionable store errors), else the error's own\n * message, else a plain fallback.\n */\nexport function submitErrorMessage(error: unknown): string {\n  const record = readRecord(error);\n  // Apollo Client 4 raises CombinedGraphQLErrors (`errors`); older clients\n  // raised ApolloError (`graphQLErrors`).\n  for (const key of [\"errors\", \"graphQLErrors\"]) {\n    const entries = record?.[key];\n    if (!Array.isArray(entries)) continue;\n    for (const entry of entries) {\n      const message = usableMessage(readRecord(entry)?.[\"message\"]);\n      if (message) return message;\n    }\n  }\n  if (error instanceof Error) {\n    return usableMessage(error.message) ?? SUBMIT_FAILED_MESSAGE;\n  }\n  return usableMessage(record?.[\"message\"]) ?? SUBMIT_FAILED_MESSAGE;\n}\n\n/**\n * Publish the draft versions, then submit the application. Stops at the first\n * failure and reports it instead of throwing.\n */\nexport async function submitForReview(\n  versions: readonly VersionLike[],\n  steps: SubmitForReviewSteps,\n): Promise<SubmitForReviewResult> {\n  try {\n    for (const versionId of draftVersionIds(versions)) {\n      await steps.publishVersion(versionId);\n    }\n    await steps.submitApplication();\n    return { ok: true };\n  } catch (error) {\n    // Keep the raw error for debugging; the developer sees the mapped message.\n    console.warn(\"[DevPortal] Submit for review failed:\", error);\n    return { ok: false, message: submitErrorMessage(error) };\n  }\n}\n"],"mappings":"AA8BA,SAAgB,EAAgB,GAA4C;AAC1E,QAAO,EAAS,QAAQ,MAAM,EAAE,WAAW,QAAQ,CAAC,KAAK,MAAM,EAAE,GAAG;;AAGtE,SAAS,EAAW,GAAgD;AAClE,QAAO,OAAO,KAAU,YAAY,KAAkB,CAAC,MAAM,QAAQ,EAAM,GAEtE,IACD;;AAGN,SAAS,EAAc,GAA+B;AACpD,KAAI,OAAO,KAAU,SAAU,QAAO;CACtC,IAAM,IAAU,EAAM,MAAM;AAW5B,QAVI,CAAC,KAIH,8EAA8E,KAC5E,EACD,GAEM,OAEF;;AAQT,SAAgB,EAAmB,GAAwB;CACzD,IAAM,IAAS,EAAW,EAAM;AAGhC,MAAK,IAAM,KAAO,CAAC,UAAU,gBAAgB,EAAE;EAC7C,IAAM,IAAU,IAAS;AACpB,YAAM,QAAQ,EAAQ,CAC3B,MAAK,IAAM,KAAS,GAAS;GAC3B,IAAM,IAAU,EAAc,EAAW,EAAM,EAAG,QAAW;AAC7D,OAAI,EAAS,QAAO;;;AAMxB,QAHI,aAAiB,QACZ,EAAc,EAAM,QAAQ,IAAA,4IAE9B,EAAc,GAAS,QAAW,IAAA;;AAO3C,eAAsB,EACpB,GACA,GACgC;AAChC,KAAI;AACF,OAAK,IAAM,KAAa,EAAgB,EAAS,CAC/C,OAAM,EAAM,eAAe,EAAU;AAGvC,SADA,MAAM,EAAM,mBAAmB,EACxB,EAAE,IAAI,IAAM;UACZ,GAAO;AAGd,SADA,QAAQ,KAAK,yCAAyC,EAAM,EACrD;GAAE,IAAI;GAAO,SAAS,EAAmB,EAAM;GAAE"}
+{"version":3,"file":"submitForReview.js","names":["SUBMIT_FAILED_MESSAGE","draftVersionIds","versions","v","readRecord","value","usableMessage","message","submitErrorMessage","record","error","key","entries","entry","\"message\"","submitForReview","versionId","steps"],"sources":["../../../src/devportal/utils/submitForReview.ts"],"sourcesContent":["/**\n * Submit-for-review flow for the application page.\n *\n * The page used to run these steps inline and swallow any failure with a\n * console.error, so when the store refused a submission the developer saw no\n * message: the app silently stayed a draft (BOFF-10636). The flow is pure here\n * so the page only renders the outcome, and the error mapping is unit tested.\n */\n\n/** Fallback when a failure carries no message a developer can use. */\nexport const SUBMIT_FAILED_MESSAGE =\n  \"Your app could not be submitted for review. Nothing was sent to reviewers. Try again in a moment; if it keeps failing, contact support.\";\n\nexport interface VersionLike {\n  id: string;\n  status: string;\n}\n\nexport interface SubmitForReviewSteps {\n  /** Moves one draft version into review together with the app. */\n  publishVersion: (versionId: string) => Promise<unknown>;\n  /** Submits the application itself. */\n  submitApplication: () => Promise<unknown>;\n}\n\nexport type SubmitForReviewResult =\n  { ok: true } | { ok: false; message: string };\n\n/** Draft versions go into review together with the app. */\nexport function draftVersionIds(versions: readonly VersionLike[]): string[] {\n  return versions.filter((v) => v.status === \"draft\").map((v) => v.id);\n}\n\nfunction readRecord(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? // Narrowed to a non-null, non-array object above; fields are read defensively below.\n      (value as Record<string, unknown>)\n    : null;\n}\n\nfunction usableMessage(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const message = value.trim();\n  if (!message) return null;\n  // Transport noise (\"Unexpected error.\", \"Response not successful: ...\",\n  // \"Failed to fetch\") tells the developer nothing they can act on.\n  if (\n    /^(unexpected error|response not successful|failed to fetch|network ?error)/i.test(\n      message,\n    )\n  ) {\n    return null;\n  }\n  return message;\n}\n\n/**\n * The message to show for a failed submission: the first GraphQL error the\n * backend sent (it forwards actionable store errors), else the error's own\n * message, else a plain fallback.\n */\nexport function submitErrorMessage(error: unknown): string {\n  const record = readRecord(error);\n  // Apollo Client 4 raises CombinedGraphQLErrors (`errors`); older clients\n  // raised ApolloError (`graphQLErrors`).\n  for (const key of [\"errors\", \"graphQLErrors\"]) {\n    const entries = record?.[key];\n    if (!Array.isArray(entries)) continue;\n    for (const entry of entries) {\n      const message = usableMessage(readRecord(entry)?.[\"message\"]);\n      if (message) return message;\n    }\n  }\n  if (error instanceof Error) {\n    return usableMessage(error.message) ?? SUBMIT_FAILED_MESSAGE;\n  }\n  return usableMessage(record?.[\"message\"]) ?? SUBMIT_FAILED_MESSAGE;\n}\n\n/**\n * Publish the draft versions, then submit the application. Stops at the first\n * failure and reports it instead of throwing.\n */\nexport async function submitForReview(\n  versions: readonly VersionLike[],\n  steps: SubmitForReviewSteps,\n): Promise<SubmitForReviewResult> {\n  try {\n    for (const versionId of draftVersionIds(versions)) {\n      await steps.publishVersion(versionId);\n    }\n    await steps.submitApplication();\n    return { ok: true };\n  } catch (error) {\n    // Keep the raw error for debugging; the developer sees the mapped message.\n    console.warn(\"[DevPortal] Submit for review failed:\", error);\n    return { ok: false, message: submitErrorMessage(error) };\n  }\n}\n"],"mappings":";AAUA,IAAaA,IACX;AAkBF,SAAgBC,EAAgB,GAA4C;CAC1E,OAAOC,EAAS,QAAQ,MAAMC,EAAE,WAAW,OAAO,CAAC,CAAC,KAAK,MAAMA,EAAE,EAAE;AACrE;AAEA,SAASC,EAAW,GAAgD;CAClE,OAAO,OAAOC,KAAU,YAAYA,KAAkB,CAAC,MAAM,QAAQA,CAAK,IAErEA,IACD;AACN;AAEA,SAASC,EAAc,GAA+B;CACpD,IAAI,OAAOD,KAAU,UAAU,OAAO;CACtC,IAAME,IAAUF,EAAM,KAAK;CAW3B,OAVI,CAACE,KAIH,8EAA8E,KAC5EA,CACF,IAEO,OAEFA;AACT;AAOA,SAAgBC,EAAmB,GAAwB;CACzD,IAAMC,IAASL,EAAWM,CAAK;CAG/B,KAAK,IAAMC,KAAO,CAAC,UAAU,eAAe,GAAG;EAC7C,IAAMC,IAAUH,IAASE;EACzB,IAAK,MAAM,QAAQC,CAAO,GAC1B,KAAK,IAAMC,KAASD,GAAS;GAC3B,IAAML,IAAUD,EAAcF,EAAWS,CAAK,CAAC,EAAGC,OAAU;GAC5D,IAAIP,GAAS,OAAOA;EACtB;CACF;CAIA,OAHIG,aAAiB,QACZJ,EAAcI,EAAM,OAAO,KAAA,4IAE7BJ,EAAcG,GAASK,OAAU,KAAA;AAC1C;AAMA,eAAsBC,EACpB,GACA,GACgC;CAChC,IAAI;EACF,KAAK,IAAMC,KAAaf,EAAgBC,CAAQ,GAC9C,MAAMe,EAAM,eAAeD,CAAS;EAGtC,OADA,MAAMC,EAAM,kBAAkB,GACvB,EAAE,IAAI,GAAK;CACpB,SAASP,GAAO;EAGd,OADA,QAAQ,KAAK,yCAAyCA,CAAK,GACpD;GAAE,IAAI;GAAO,SAASF,EAAmBE,CAAK;EAAE;CACzD;AACF"}

package/dist/devportal/utils/timecampusApplets.d.ts

@@ -0,0 +1,98 @@
+/**
+ * TimeCampus applets in the developer portal (BOFF-11005).
+ *
+ * Pure helpers for the TimeCampus applets page: manifest text handling, the
+ * starter manifest, version bumps and the rules that decide which developer
+ * action is available for an applet. The rules mirror wspace-timecampus-svc
+ * (the service is still the authority; these only decide which buttons to
+ * offer and what to say when one is not available).
+ */
+/** Public TimeCampus docs: the manifest reference and the extensibility overview. */
+export declare const TIMECAMPUS_MANIFEST_DOCS_URL = "https://docs.timecampus.com/developers/applet-manifest";
+export declare const TIMECAMPUS_APPLETS_DOCS_URL = "https://docs.timecampus.com/extensibility/applets";
+/** The sample widget the TimeCampus app shell serves (copy it as a starting point). */
+export declare const TIMECAMPUS_SAMPLE_WIDGET_URL = "https://app.timecampus.com/applet-samples/time-summary.html";
+export type ManifestParse = {
+    ok: true;
+    manifest: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+/** Parse the manifest editor's text into a JSON object. */
+export declare function parseManifestText(text: string): ManifestParse;
+export declare function manifestText(manifest: unknown): string;
+/** Next patch version of MAJOR.MINOR.PATCH (falls back to 1.0.0). */
+export declare function nextPatchVersion(version: string): string;
+/** The manifest for a new version: the given one with the next patch version. */
+export declare function manifestForNextVersion(manifest: unknown): string;
+/** A working starter manifest that points at the TimeCampus sample widget. */
+export declare function starterManifest(): string;
+/** The bits of an applet the page decides on. */
+export interface AppletActionInput {
+    status: string;
+    latestVersion: {
+        id: string;
+        version: string;
+        status: string;
+    };
+    liveVersion?: {
+        version: string;
+    } | null;
+    marketplace?: {
+        status: string;
+        latestSubmission: {
+            version: string;
+            status: string;
+        };
+        liveSubmission?: {
+            version: string;
+        } | null;
+    } | null;
+}
+/** What the developer can do with the applet's latest version right now. */
+export type VersionAction = {
+    kind: "submit";
+    versionId: string;
+} | {
+    kind: "withdraw";
+    versionId: string;
+} | {
+    kind: "none";
+};
+/**
+ * A draft latest version can be submitted for workspace review; one in
+ * review can be withdrawn back to a draft. Rejected, published, superseded
+ * and suspended versions take no action here: add a new version instead.
+ */
+export declare function versionAction(applet: AppletActionInput): VersionAction;
+/** Whether a new version can be added (only when no draft or review is open). */
+export declare function canAddVersion(applet: AppletActionInput): boolean;
+/**
+ * Whether the latest version's manifest can be replaced in place. The
+ * service accepts edits to a DRAFT or REJECTED version (a rejected one
+ * returns to DRAFT); versions in review, live or retired are immutable.
+ */
+export declare function canEditVersion(applet: AppletActionInput): boolean;
+/** Compare two MAJOR.MINOR.PATCH versions (non-numeric parts count as 0). */
+export declare function compareVersions(a: string, b: string): number;
+export type MarketplaceOffer = {
+    canOffer: true;
+    version: string;
+} | {
+    canOffer: false;
+    reason: string;
+};
+/**
+ * Whether the developer can offer the applet's live workspace version to the
+ * public marketplace now, and why not otherwise. Mirrors the service rules:
+ * only a workspace-published version, one submission in certification at a
+ * time, and only a version higher than every certified one.
+ */
+export declare function marketplaceOffer(applet: AppletActionInput): MarketplaceOffer;
+/** Whether the latest marketplace submission is still in certification (and can be withdrawn). */
+export declare function canWithdrawFromMarketplace(applet: AppletActionInput): boolean;
+/** A readable date for an ISO timestamp, or the raw value when it cannot be parsed. */
+export declare function formatDate(iso: string): string;
+/** A short, user-facing message for a failed request. */
+export declare function errorText(err: unknown): string;

package/dist/devportal/utils/timecampusApplets.js

@@ -0,0 +1,130 @@
+// src/devportal/utils/timecampusApplets.ts
+var e = "https://docs.timecampus.com/developers/applet-manifest", t = "https://docs.timecampus.com/extensibility/applets", n = "https://app.timecampus.com/applet-samples/time-summary.html";
+function r(e) {
+	if (!e.trim()) return {
+		ok: !1,
+		error: "Paste or write a manifest."
+	};
+	let t;
+	try {
+		t = JSON.parse(e);
+	} catch (e) {
+		return {
+			ok: !1,
+			error: `Not valid JSON: ${e instanceof Error ? e.message : "parse error"}`
+		};
+	}
+	return typeof t != "object" || !t || Array.isArray(t) ? {
+		ok: !1,
+		error: "The manifest must be a JSON object."
+	} : {
+		ok: !0,
+		manifest: t
+	};
+}
+function i(e) {
+	return JSON.stringify(e, null, 2);
+}
+function a(e) {
+	let t = /^(\d+)\.(\d+)\.(\d+)$/.exec(e);
+	return t ? `${t[1]}.${t[2]}.${Number(t[3]) + 1}` : "1.0.0";
+}
+function o(e) {
+	if (typeof e != "object" || !e) return i(e);
+	let t = e, n = typeof t.version == "string" ? t.version : "";
+	return i({
+		...t,
+		version: a(n)
+	});
+}
+function s() {
+	return i({
+		manifestVersion: 1,
+		key: "my-first-applet",
+		name: "My first applet",
+		version: "1.0.0",
+		description: "Shows your tracked time today in a sandboxed widget.",
+		icon: "Puzzle",
+		category: "ANALYTICS",
+		entryPoint: "https://app.timecampus.com/applet-samples/",
+		permissions: ["time-summary:read"],
+		widgets: [{
+			key: "today",
+			name: "Tracked today",
+			description: "Your tracked time today and this week",
+			path: "/applet-samples/time-summary.html",
+			height: 220
+		}],
+		developer: { name: "Your team" }
+	});
+}
+function c(e) {
+	let t = e.latestVersion;
+	return t.status === "DRAFT" ? {
+		kind: "submit",
+		versionId: t.id
+	} : t.status === "IN_REVIEW" ? {
+		kind: "withdraw",
+		versionId: t.id
+	} : { kind: "none" };
+}
+function l(e) {
+	let t = e.latestVersion.status;
+	return t !== "DRAFT" && t !== "IN_REVIEW";
+}
+function u(e) {
+	let t = e.latestVersion.status;
+	return t === "DRAFT" || t === "REJECTED";
+}
+function d(e, t) {
+	let n = e.split(".").map((e) => Number(e) || 0), r = t.split(".").map((e) => Number(e) || 0);
+	for (let e = 0; e < 3; e += 1) {
+		let t = (n[e] ?? 0) - (r[e] ?? 0);
+		if (t !== 0) return t;
+	}
+	return 0;
+}
+var f = /* @__PURE__ */ new Set(["CERTIFIED", "SUPERSEDED"]);
+function p(e) {
+	if (!e) return null;
+	let t = [];
+	return e.liveSubmission && t.push(e.liveSubmission.version), f.has(e.latestSubmission.status) && t.push(e.latestSubmission.version), t.reduce((e, t) => e === null || d(t, e) > 0 ? t : e, null);
+}
+function m(e) {
+	let t = e.liveVersion;
+	if (e.status !== "PUBLISHED" || !t) return {
+		canOffer: !1,
+		reason: "Publish a version in your workspace first."
+	};
+	let n = e.marketplace;
+	if (n?.latestSubmission.status === "IN_REVIEW") return {
+		canOffer: !1,
+		reason: `v${n.latestSubmission.version} is waiting for platform certification.`
+	};
+	let r = p(n);
+	return r !== null && d(t.version, r) <= 0 ? {
+		canOffer: !1,
+		reason: `v${r} is already certified. Publish a newer version to offer it.`
+	} : {
+		canOffer: !0,
+		version: t.version
+	};
+}
+function h(e) {
+	return e.marketplace?.latestSubmission.status === "IN_REVIEW";
+}
+function g(e) {
+	let t = new Date(e);
+	return Number.isNaN(t.getTime()) ? e : t.toLocaleDateString(void 0, {
+		year: "numeric",
+		month: "short",
+		day: "numeric"
+	});
+}
+function _(e) {
+	let t = e instanceof Error ? e.message : "";
+	return /forbidden|permission|not authori[sz]ed/i.test(t) ? "You do not have permission to do that in this workspace." : t || "Something went wrong";
+}
+export { t as TIMECAMPUS_APPLETS_DOCS_URL, e as TIMECAMPUS_MANIFEST_DOCS_URL, n as TIMECAMPUS_SAMPLE_WIDGET_URL, l as canAddVersion, u as canEditVersion, h as canWithdrawFromMarketplace, d as compareVersions, _ as errorText, g as formatDate, o as manifestForNextVersion, i as manifestText, m as marketplaceOffer, a as nextPatchVersion, r as parseManifestText, s as starterManifest, c as versionAction };
+
+//# sourceMappingURL=timecampusApplets.js.map

package/dist/devportal/utils/timecampusApplets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timecampusApplets.js","names":["TIMECAMPUS_MANIFEST_DOCS_URL","TIMECAMPUS_APPLETS_DOCS_URL","TIMECAMPUS_SAMPLE_WIDGET_URL","parseManifestText","text","value","err","manifestText","manifest","nextPatchVersion","match","version","manifestForNextVersion","current","starterManifest","versionAction","latest","applet","canAddVersion","status","canEditVersion","compareVersions","left","a","part","right","b","i","diff","CERTIFIED_STATUSES","highestCertifiedVersion","listing","versions","top","marketplaceOffer","live","certified","canWithdrawFromMarketplace","formatDate","date","iso","errorText","message"],"sources":["../../../src/devportal/utils/timecampusApplets.ts"],"sourcesContent":["/**\n * TimeCampus applets in the developer portal (BOFF-11005).\n *\n * Pure helpers for the TimeCampus applets page: manifest text handling, the\n * starter manifest, version bumps and the rules that decide which developer\n * action is available for an applet. The rules mirror wspace-timecampus-svc\n * (the service is still the authority; these only decide which buttons to\n * offer and what to say when one is not available).\n */\n\n/** Public TimeCampus docs: the manifest reference and the extensibility overview. */\nexport const TIMECAMPUS_MANIFEST_DOCS_URL =\n  \"https://docs.timecampus.com/developers/applet-manifest\";\nexport const TIMECAMPUS_APPLETS_DOCS_URL =\n  \"https://docs.timecampus.com/extensibility/applets\";\n/** The sample widget the TimeCampus app shell serves (copy it as a starting point). */\nexport const TIMECAMPUS_SAMPLE_WIDGET_URL =\n  \"https://app.timecampus.com/applet-samples/time-summary.html\";\nconst SAMPLE_ENTRY_POINT = \"https://app.timecampus.com/applet-samples/\";\n\nexport type ManifestParse =\n  | { ok: true; manifest: Record<string, unknown> }\n  | { ok: false; error: string };\n\n/** Parse the manifest editor's text into a JSON object. */\nexport function parseManifestText(text: string): ManifestParse {\n  if (!text.trim()) return { ok: false, error: \"Paste or write a manifest.\" };\n  let value: unknown;\n  try {\n    value = JSON.parse(text);\n  } catch (err) {\n    return {\n      ok: false,\n      error: `Not valid JSON: ${err instanceof Error ? err.message : \"parse error\"}`,\n    };\n  }\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return { ok: false, error: \"The manifest must be a JSON object.\" };\n  }\n  return { ok: true, manifest: value as Record<string, unknown> };\n}\n\nexport function manifestText(manifest: unknown): string {\n  return JSON.stringify(manifest, null, 2);\n}\n\n/** Next patch version of MAJOR.MINOR.PATCH (falls back to 1.0.0). */\nexport function nextPatchVersion(version: string): string {\n  const match = /^(\\d+)\\.(\\d+)\\.(\\d+)$/.exec(version);\n  if (!match) return \"1.0.0\";\n  return `${match[1]}.${match[2]}.${Number(match[3]) + 1}`;\n}\n\n/** The manifest for a new version: the given one with the next patch version. */\nexport function manifestForNextVersion(manifest: unknown): string {\n  if (typeof manifest !== \"object\" || manifest === null) {\n    return manifestText(manifest);\n  }\n  const current = manifest as Record<string, unknown>;\n  const version = typeof current.version === \"string\" ? current.version : \"\";\n  return manifestText({ ...current, version: nextPatchVersion(version) });\n}\n\n/** A working starter manifest that points at the TimeCampus sample widget. */\nexport function starterManifest(): string {\n  return manifestText({\n    manifestVersion: 1,\n    key: \"my-first-applet\",\n    name: \"My first applet\",\n    version: \"1.0.0\",\n    description: \"Shows your tracked time today in a sandboxed widget.\",\n    icon: \"Puzzle\",\n    category: \"ANALYTICS\",\n    entryPoint: SAMPLE_ENTRY_POINT,\n    permissions: [\"time-summary:read\"],\n    widgets: [\n      {\n        key: \"today\",\n        name: \"Tracked today\",\n        description: \"Your tracked time today and this week\",\n        path: \"/applet-samples/time-summary.html\",\n        height: 220,\n      },\n    ],\n    developer: { name: \"Your team\" },\n  });\n}\n\n/** The bits of an applet the page decides on. */\nexport interface AppletActionInput {\n  status: string;\n  latestVersion: { id: string; version: string; status: string };\n  liveVersion?: { version: string } | null;\n  marketplace?: {\n    status: string;\n    latestSubmission: { version: string; status: string };\n    liveSubmission?: { version: string } | null;\n  } | null;\n}\n\n/** What the developer can do with the applet's latest version right now. */\nexport type VersionAction =\n  | { kind: \"submit\"; versionId: string }\n  | { kind: \"withdraw\"; versionId: string }\n  | { kind: \"none\" };\n\n/**\n * A draft latest version can be submitted for workspace review; one in\n * review can be withdrawn back to a draft. Rejected, published, superseded\n * and suspended versions take no action here: add a new version instead.\n */\nexport function versionAction(applet: AppletActionInput): VersionAction {\n  const latest = applet.latestVersion;\n  if (latest.status === \"DRAFT\") {\n    return { kind: \"submit\", versionId: latest.id };\n  }\n  if (latest.status === \"IN_REVIEW\") {\n    return { kind: \"withdraw\", versionId: latest.id };\n  }\n  return { kind: \"none\" };\n}\n\n/** Whether a new version can be added (only when no draft or review is open). */\nexport function canAddVersion(applet: AppletActionInput): boolean {\n  const status = applet.latestVersion.status;\n  return status !== \"DRAFT\" && status !== \"IN_REVIEW\";\n}\n\n/**\n * Whether the latest version's manifest can be replaced in place. The\n * service accepts edits to a DRAFT or REJECTED version (a rejected one\n * returns to DRAFT); versions in review, live or retired are immutable.\n */\nexport function canEditVersion(applet: AppletActionInput): boolean {\n  const status = applet.latestVersion.status;\n  return status === \"DRAFT\" || status === \"REJECTED\";\n}\n\n/** Compare two MAJOR.MINOR.PATCH versions (non-numeric parts count as 0). */\nexport function compareVersions(a: string, b: string): number {\n  const left = a.split(\".\").map((part) => Number(part) || 0);\n  const right = b.split(\".\").map((part) => Number(part) || 0);\n  for (let i = 0; i < 3; i += 1) {\n    const diff = (left[i] ?? 0) - (right[i] ?? 0);\n    if (diff !== 0) return diff;\n  }\n  return 0;\n}\n\nconst CERTIFIED_STATUSES = new Set([\"CERTIFIED\", \"SUPERSEDED\"]);\n\n/** The highest certified version the page can see (the live and latest submissions). */\nfunction highestCertifiedVersion(\n  listing: AppletActionInput[\"marketplace\"],\n): string | null {\n  if (!listing) return null;\n  const versions: string[] = [];\n  if (listing.liveSubmission) versions.push(listing.liveSubmission.version);\n  if (CERTIFIED_STATUSES.has(listing.latestSubmission.status)) {\n    versions.push(listing.latestSubmission.version);\n  }\n  return versions.reduce<string | null>(\n    (top, version) =>\n      top === null || compareVersions(version, top) > 0 ? version : top,\n    null,\n  );\n}\n\nexport type MarketplaceOffer =\n  { canOffer: true; version: string } | { canOffer: false; reason: string };\n\n/**\n * Whether the developer can offer the applet's live workspace version to the\n * public marketplace now, and why not otherwise. Mirrors the service rules:\n * only a workspace-published version, one submission in certification at a\n * time, and only a version higher than every certified one.\n */\nexport function marketplaceOffer(applet: AppletActionInput): MarketplaceOffer {\n  const live = applet.liveVersion;\n  if (applet.status !== \"PUBLISHED\" || !live) {\n    return {\n      canOffer: false,\n      reason: \"Publish a version in your workspace first.\",\n    };\n  }\n  const listing = applet.marketplace;\n  if (listing?.latestSubmission.status === \"IN_REVIEW\") {\n    return {\n      canOffer: false,\n      reason: `v${listing.latestSubmission.version} is waiting for platform certification.`,\n    };\n  }\n  const certified = highestCertifiedVersion(listing);\n  if (certified !== null && compareVersions(live.version, certified) <= 0) {\n    return {\n      canOffer: false,\n      reason: `v${certified} is already certified. Publish a newer version to offer it.`,\n    };\n  }\n  return { canOffer: true, version: live.version };\n}\n\n/** Whether the latest marketplace submission is still in certification (and can be withdrawn). */\nexport function canWithdrawFromMarketplace(applet: AppletActionInput): boolean {\n  return applet.marketplace?.latestSubmission.status === \"IN_REVIEW\";\n}\n\n/** A readable date for an ISO timestamp, or the raw value when it cannot be parsed. */\nexport function formatDate(iso: string): string {\n  const date = new Date(iso);\n  if (Number.isNaN(date.getTime())) return iso;\n  return date.toLocaleDateString(undefined, {\n    year: \"numeric\",\n    month: \"short\",\n    day: \"numeric\",\n  });\n}\n\n/** A short, user-facing message for a failed request. */\nexport function errorText(err: unknown): string {\n  const message = err instanceof Error ? err.message : \"\";\n  if (/forbidden|permission|not authori[sz]ed/i.test(message)) {\n    return \"You do not have permission to do that in this workspace.\";\n  }\n  return message || \"Something went wrong\";\n}\n"],"mappings":"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"}

package/dist/devportal/utils/uploadErrors.d.ts

@@ -43,4 +43,3 @@ export declare function quotaErrorFrom(body: unknown): UploadRequestError | null
 export declare function httpErrorFrom(status: number, statusText: string, body: unknown): UploadRequestError;
 /** The error for in-band GraphQL errors on a 2xx response. */
 export declare function graphQLErrorFrom(body: unknown): UploadRequestError | null;
-//# sourceMappingURL=uploadErrors.d.ts.map

package/dist/devportal/utils/uploadErrors.js

@@ -1,26 +1,27 @@
-var e = "File uploads are not available in this workspace because its plan does not include file storage. Switch to a workspace your plan covers, or upgrade this workspace's plan in Billing, then try again.", t = "This workspace has used up its file storage. Delete files you no longer need or upgrade the workspace's plan in Billing, then try again.", n = "Too many requests right now. Wait a moment, then try the upload again.", r = class extends Error {
+// src/devportal/utils/uploadErrors.ts
+var e = "QUOTA_NOT_PROVISIONED", t = "QUOTA_EXHAUSTED", n = "File uploads are not available in this workspace because its plan does not include file storage. Switch to a workspace your plan covers, or upgrade this workspace's plan in Billing, then try again.", r = "This workspace has used up its file storage. Delete files you no longer need or upgrade the workspace's plan in Billing, then try again.", i = "Too many requests right now. Wait a moment, then try the upload again.", a = class extends Error {
 	code;
 	status;
 	constructor(e, t, n) {
 		super(e), this.name = "UploadRequestError", this.code = t, this.status = n;
 	}
 };
-function i(e) {
+function o(e) {
 	return typeof e == "object" && e && !Array.isArray(e) ? e : null;
 }
-function a(e) {
-	let t = i(e)?.errors;
-	return Array.isArray(t) ? t.filter((e) => i(e) !== null) : [];
+function s(e) {
+	let t = o(e)?.errors;
+	return Array.isArray(t) ? t.filter((e) => o(e) !== null) : [];
 }
-function o(e) {
-	let t = i(e.extensions)?.code;
+function c(e) {
+	let t = o(e.extensions)?.code;
 	return typeof t == "string" ? t : null;
 }
-function s(e) {
-	let t = i(e.extensions)?.limitLeft, n = typeof t == "string" ? Number(t) : t;
+function l(e) {
+	let t = o(e.extensions)?.limitLeft, n = typeof t == "string" ? Number(t) : t;
 	return typeof n == "number" && Number.isFinite(n) && n >= 0 ? n : null;
 }
-function c(e) {
+function u(e) {
 	if (!Number.isFinite(e) || e < 0) return "0 B";
 	let t = [
 		"B",
@@ -32,31 +33,30 @@ function c(e) {
 	for (; n >= 1024 && r < t.length - 1;) n /= 1024, r += 1;
 	return r === 0 ? `${Math.round(n)} ${t[r]}` : `${n.toFixed(1)} ${t[r]}`;
 }
-function l(e) {
-	let n = s(e);
-	return n === null ? t : `${t} Space left: ${c(n)}.`;
-}
-function u(t) {
-	for (let n of a(t)) {
-		let t = o(n);
-		if (t === "QUOTA_NOT_PROVISIONED") return new r(e, t, null);
-		if (t === "QUOTA_EXHAUSTED") return new r(l(n), t, null);
+function d(e) {
+	let t = l(e);
+	return t === null ? r : `${r} Space left: ${u(t)}.`;
+}
+function f(e) {
+	for (let t of s(e)) {
+		let e = c(t);
+		if (e === "QUOTA_NOT_PROVISIONED") return new a(n, e, null);
+		if (e === "QUOTA_EXHAUSTED") return new a(d(t), e, null);
 	}
 	return null;
 }
-function d(e, t, i) {
-	let s = u(i);
-	if (s) return new r(s.message, s.code, e);
-	let c = a(i)[0];
-	return c && typeof c.message == "string" && c.message.trim() ? new r(c.message, o(c), e) : e === 429 ? new r(n, null, e) : new r(`GraphQL request failed: ${e}${t ? ` ${t}` : ""}`, null, e);
+function p(e, t, n) {
+	let r = f(n);
+	if (r) return new a(r.message, r.code, e);
+	let o = s(n)[0];
+	return o && typeof o.message == "string" && o.message.trim() ? new a(o.message, c(o), e) : e === 429 ? new a(i, null, e) : new a(`GraphQL request failed: ${e}${t ? ` ${t}` : ""}`, null, e);
 }
-function f(e) {
-	let t = u(e);
+function m(e) {
+	let t = f(e);
 	if (t) return t;
-	let n = a(e), [i] = n;
-	return i ? new r(n.map((e) => typeof e.message == "string" ? e.message : "").filter(Boolean).join("; ") || "GraphQL request failed", o(i), null) : null;
+	let n = s(e), [r] = n;
+	return r ? new a(n.map((e) => typeof e.message == "string" ? e.message : "").filter(Boolean).join("; ") || "GraphQL request failed", c(r), null) : null;
 }
-//#endregion
-export { f as graphQLErrorFrom, d as httpErrorFrom };
+export { t as QUOTA_EXHAUSTED, r as QUOTA_EXHAUSTED_MESSAGE, e as QUOTA_NOT_PROVISIONED, n as QUOTA_NOT_PROVISIONED_MESSAGE, i as RATE_LIMITED_MESSAGE, a as UploadRequestError, u as formatBytes, m as graphQLErrorFrom, p as httpErrorFrom, f as quotaErrorFrom };
 
 //# sourceMappingURL=uploadErrors.js.map

package/dist/devportal/utils/uploadErrors.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploadErrors.js","names":[],"sources":["../../../src/devportal/utils/uploadErrors.ts"],"sourcesContent":["/**\n * Turns a failed files-upload GraphQL call into a message a developer can act on.\n *\n * The workspace gateway refuses a quota-gated mutation (`completeUpload`,\n * `uploadFile` and `createFolder` carry `@usage(checkQuota: true)`) with HTTP\n * 429 and a GraphQL body whose first error carries\n * `extensions.code` = `QUOTA_NOT_PROVISIONED` (the current workspace's plan does\n * not include the quota at all) or `QUOTA_EXHAUSTED` (the allowance is used\n * up). Reading only the status turned both into \"GraphQL request failed: 429\",\n * which reads as rate limiting and gives no way forward (BOFF-10676).\n *\n * These helpers are pure so the upload hook stays a thin transport and the\n * mapping can be unit tested without a network.\n */\n\n/** One GraphQL error, as far as these helpers read it. */\nexport interface GraphQLErrorLike {\n  message?: unknown;\n  extensions?: unknown;\n}\n\n/** Gateway quota block codes (wspace-public-gateway `sendQuotaExhausted`). */\nexport const QUOTA_NOT_PROVISIONED = \"QUOTA_NOT_PROVISIONED\";\nexport const QUOTA_EXHAUSTED = \"QUOTA_EXHAUSTED\";\n\nexport const QUOTA_NOT_PROVISIONED_MESSAGE =\n  \"File uploads are not available in this workspace because its plan does not include file storage. Switch to a workspace your plan covers, or upgrade this workspace's plan in Billing, then try again.\";\n\nexport const QUOTA_EXHAUSTED_MESSAGE =\n  \"This workspace has used up its file storage. Delete files you no longer need or upgrade the workspace's plan in Billing, then try again.\";\n\nexport const RATE_LIMITED_MESSAGE =\n  \"Too many requests right now. Wait a moment, then try the upload again.\";\n\n/** Error raised by the upload transport; `code` is the gateway code when there is one. */\nexport class UploadRequestError extends Error {\n  readonly code: string | null;\n  readonly status: number | null;\n\n  constructor(message: string, code: string | null, status: number | null) {\n    super(message);\n    this.name = \"UploadRequestError\";\n    this.code = code;\n    this.status = status;\n  }\n}\n\nfunction readRecord(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? // Narrowed to a non-null, non-array object above; fields are read defensively below.\n      (value as Record<string, unknown>)\n    : null;\n}\n\nfunction errorsOf(body: unknown): GraphQLErrorLike[] {\n  const errors = readRecord(body)?.errors;\n  if (!Array.isArray(errors)) return [];\n  return errors.filter((e): e is GraphQLErrorLike => readRecord(e) !== null);\n}\n\nfunction codeOf(error: GraphQLErrorLike): string | null {\n  const code = readRecord(error.extensions)?.code;\n  return typeof code === \"string\" ? code : null;\n}\n\nfunction limitLeftOf(error: GraphQLErrorLike): number | null {\n  const raw = readRecord(error.extensions)?.limitLeft;\n  const value = typeof raw === \"string\" ? Number(raw) : raw;\n  return typeof value === \"number\" && Number.isFinite(value) && value >= 0\n    ? value\n    : null;\n}\n\n/** Human-readable byte size (binary units, one decimal above KB). */\nexport function formatBytes(bytes: number): string {\n  if (!Number.isFinite(bytes) || bytes < 0) return \"0 B\";\n  const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\"];\n  let value = bytes;\n  let unit = 0;\n  while (value >= 1024 && unit < units.length - 1) {\n    value /= 1024;\n    unit += 1;\n  }\n  return unit === 0\n    ? `${Math.round(value)} ${units[unit]}`\n    : `${value.toFixed(1)} ${units[unit]}`;\n}\n\nfunction exhaustedMessage(error: GraphQLErrorLike): string {\n  const left = limitLeftOf(error);\n  return left === null\n    ? QUOTA_EXHAUSTED_MESSAGE\n    : `${QUOTA_EXHAUSTED_MESSAGE} Space left: ${formatBytes(left)}.`;\n}\n\n/**\n * The quota refusal in a GraphQL body, if there is one. Used for both the\n * gateway's 429 response and an in-band error on a 200 response.\n */\nexport function quotaErrorFrom(body: unknown): UploadRequestError | null {\n  for (const error of errorsOf(body)) {\n    const code = codeOf(error);\n    if (code === QUOTA_NOT_PROVISIONED) {\n      return new UploadRequestError(QUOTA_NOT_PROVISIONED_MESSAGE, code, null);\n    }\n    if (code === QUOTA_EXHAUSTED) {\n      return new UploadRequestError(exhaustedMessage(error), code, null);\n    }\n  }\n  return null;\n}\n\n/**\n * The error for a non-2xx gateway response. `body` is the parsed JSON body, or\n * undefined when it was missing or not JSON.\n */\nexport function httpErrorFrom(\n  status: number,\n  statusText: string,\n  body: unknown,\n): UploadRequestError {\n  const quota = quotaErrorFrom(body);\n  if (quota) {\n    return new UploadRequestError(quota.message, quota.code, status);\n  }\n  const first = errorsOf(body)[0];\n  if (first && typeof first.message === \"string\" && first.message.trim()) {\n    return new UploadRequestError(first.message, codeOf(first), status);\n  }\n  if (status === 429) {\n    return new UploadRequestError(RATE_LIMITED_MESSAGE, null, status);\n  }\n  const suffix = statusText ? ` ${statusText}` : \"\";\n  return new UploadRequestError(\n    `GraphQL request failed: ${status}${suffix}`,\n    null,\n    status,\n  );\n}\n\n/** The error for in-band GraphQL errors on a 2xx response. */\nexport function graphQLErrorFrom(body: unknown): UploadRequestError | null {\n  const quota = quotaErrorFrom(body);\n  if (quota) return quota;\n  const errors = errorsOf(body);\n  const [first] = errors;\n  if (!first) return null;\n  const message = errors\n    .map((e) => (typeof e.message === \"string\" ? e.message : \"\"))\n    .filter(Boolean)\n    .join(\"; \");\n  return new UploadRequestError(\n    message || \"GraphQL request failed\",\n    codeOf(first),\n    null,\n  );\n}\n"],"mappings":"AAyBA,IAAa,IACX,yMAEW,IACX,4IAEW,IACX,0EAGW,IAAb,cAAwC,MAAM;CAC5C;CACA;CAEA,YAAY,GAAiB,GAAqB,GAAuB;AAIvE,EAHA,MAAM,EAAQ,EACd,KAAK,OAAO,sBACZ,KAAK,OAAO,GACZ,KAAK,SAAS;;;AAIlB,SAAS,EAAW,GAAgD;AAClE,QAAO,OAAO,KAAU,YAAY,KAAkB,CAAC,MAAM,QAAQ,EAAM,GAEtE,IACD;;AAGN,SAAS,EAAS,GAAmC;CACnD,IAAM,IAAS,EAAW,EAAK,EAAE;AAEjC,QADK,MAAM,QAAQ,EAAO,GACnB,EAAO,QAAQ,MAA6B,EAAW,EAAE,KAAK,KAAK,GADvC,EAAE;;AAIvC,SAAS,EAAO,GAAwC;CACtD,IAAM,IAAO,EAAW,EAAM,WAAW,EAAE;AAC3C,QAAO,OAAO,KAAS,WAAW,IAAO;;AAG3C,SAAS,EAAY,GAAwC;CAC3D,IAAM,IAAM,EAAW,EAAM,WAAW,EAAE,WACpC,IAAQ,OAAO,KAAQ,WAAW,OAAO,EAAI,GAAG;AACtD,QAAO,OAAO,KAAU,YAAY,OAAO,SAAS,EAAM,IAAI,KAAS,IACnE,IACA;;AAIN,SAAgB,EAAY,GAAuB;AACjD,KAAI,CAAC,OAAO,SAAS,EAAM,IAAI,IAAQ,EAAG,QAAO;CACjD,IAAM,IAAQ;EAAC;EAAK;EAAM;EAAM;EAAM;EAAK,EACvC,IAAQ,GACR,IAAO;AACX,QAAO,KAAS,QAAQ,IAAO,EAAM,SAAS,GAE5C,CADA,KAAS,MACT,KAAQ;AAEV,QAAO,MAAS,IACZ,GAAG,KAAK,MAAM,EAAM,CAAC,GAAG,EAAM,OAC9B,GAAG,EAAM,QAAQ,EAAE,CAAC,GAAG,EAAM;;AAGnC,SAAS,EAAiB,GAAiC;CACzD,IAAM,IAAO,EAAY,EAAM;AAC/B,QAAO,MAAS,OACZ,IACA,GAAG,EAAwB,eAAe,EAAY,EAAK,CAAC;;AAOlE,SAAgB,EAAe,GAA0C;AACvE,MAAK,IAAM,KAAS,EAAS,EAAK,EAAE;EAClC,IAAM,IAAO,EAAO,EAAM;AAC1B,MAAI,MAAA,wBACF,QAAO,IAAI,EAAmB,GAA+B,GAAM,KAAK;AAE1E,MAAI,MAAA,kBACF,QAAO,IAAI,EAAmB,EAAiB,EAAM,EAAE,GAAM,KAAK;;AAGtE,QAAO;;AAOT,SAAgB,EACd,GACA,GACA,GACoB;CACpB,IAAM,IAAQ,EAAe,EAAK;AAClC,KAAI,EACF,QAAO,IAAI,EAAmB,EAAM,SAAS,EAAM,MAAM,EAAO;CAElE,IAAM,IAAQ,EAAS,EAAK,CAAC;AAQ7B,QAPI,KAAS,OAAO,EAAM,WAAY,YAAY,EAAM,QAAQ,MAAM,GAC7D,IAAI,EAAmB,EAAM,SAAS,EAAO,EAAM,EAAE,EAAO,GAEjE,MAAW,MACN,IAAI,EAAmB,GAAsB,MAAM,EAAO,GAG5D,IAAI,EACT,2BAA2B,IAFd,IAAa,IAAI,MAAe,MAG7C,MACA,EACD;;AAIH,SAAgB,EAAiB,GAA0C;CACzE,IAAM,IAAQ,EAAe,EAAK;AAClC,KAAI,EAAO,QAAO;CAClB,IAAM,IAAS,EAAS,EAAK,EACvB,CAAC,KAAS;AAMhB,QALK,IAKE,IAAI,EAJK,EACb,KAAK,MAAO,OAAO,EAAE,WAAY,WAAW,EAAE,UAAU,GAAI,CAC5D,OAAO,QAAQ,CACf,KAAK,KAAK,IAEA,0BACX,EAAO,EAAM,EACb,KACD,GATkB"}
+{"version":3,"file":"uploadErrors.js","names":["QUOTA_NOT_PROVISIONED","QUOTA_EXHAUSTED","QUOTA_NOT_PROVISIONED_MESSAGE","QUOTA_EXHAUSTED_MESSAGE","RATE_LIMITED_MESSAGE","UploadRequestError","message","code","status","readRecord","value","errorsOf","errors","body","codeOf","error","limitLeftOf","raw","formatBytes","bytes","units","unit","exhaustedMessage","left","quotaErrorFrom","httpErrorFrom","quota","first","statusText","graphQLErrorFrom"],"sources":["../../../src/devportal/utils/uploadErrors.ts"],"sourcesContent":["/**\n * Turns a failed files-upload GraphQL call into a message a developer can act on.\n *\n * The workspace gateway refuses a quota-gated mutation (`completeUpload`,\n * `uploadFile` and `createFolder` carry `@usage(checkQuota: true)`) with HTTP\n * 429 and a GraphQL body whose first error carries\n * `extensions.code` = `QUOTA_NOT_PROVISIONED` (the current workspace's plan does\n * not include the quota at all) or `QUOTA_EXHAUSTED` (the allowance is used\n * up). Reading only the status turned both into \"GraphQL request failed: 429\",\n * which reads as rate limiting and gives no way forward (BOFF-10676).\n *\n * These helpers are pure so the upload hook stays a thin transport and the\n * mapping can be unit tested without a network.\n */\n\n/** One GraphQL error, as far as these helpers read it. */\nexport interface GraphQLErrorLike {\n  message?: unknown;\n  extensions?: unknown;\n}\n\n/** Gateway quota block codes (wspace-public-gateway `sendQuotaExhausted`). */\nexport const QUOTA_NOT_PROVISIONED = \"QUOTA_NOT_PROVISIONED\";\nexport const QUOTA_EXHAUSTED = \"QUOTA_EXHAUSTED\";\n\nexport const QUOTA_NOT_PROVISIONED_MESSAGE =\n  \"File uploads are not available in this workspace because its plan does not include file storage. Switch to a workspace your plan covers, or upgrade this workspace's plan in Billing, then try again.\";\n\nexport const QUOTA_EXHAUSTED_MESSAGE =\n  \"This workspace has used up its file storage. Delete files you no longer need or upgrade the workspace's plan in Billing, then try again.\";\n\nexport const RATE_LIMITED_MESSAGE =\n  \"Too many requests right now. Wait a moment, then try the upload again.\";\n\n/** Error raised by the upload transport; `code` is the gateway code when there is one. */\nexport class UploadRequestError extends Error {\n  readonly code: string | null;\n  readonly status: number | null;\n\n  constructor(message: string, code: string | null, status: number | null) {\n    super(message);\n    this.name = \"UploadRequestError\";\n    this.code = code;\n    this.status = status;\n  }\n}\n\nfunction readRecord(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? // Narrowed to a non-null, non-array object above; fields are read defensively below.\n      (value as Record<string, unknown>)\n    : null;\n}\n\nfunction errorsOf(body: unknown): GraphQLErrorLike[] {\n  const errors = readRecord(body)?.errors;\n  if (!Array.isArray(errors)) return [];\n  return errors.filter((e): e is GraphQLErrorLike => readRecord(e) !== null);\n}\n\nfunction codeOf(error: GraphQLErrorLike): string | null {\n  const code = readRecord(error.extensions)?.code;\n  return typeof code === \"string\" ? code : null;\n}\n\nfunction limitLeftOf(error: GraphQLErrorLike): number | null {\n  const raw = readRecord(error.extensions)?.limitLeft;\n  const value = typeof raw === \"string\" ? Number(raw) : raw;\n  return typeof value === \"number\" && Number.isFinite(value) && value >= 0\n    ? value\n    : null;\n}\n\n/** Human-readable byte size (binary units, one decimal above KB). */\nexport function formatBytes(bytes: number): string {\n  if (!Number.isFinite(bytes) || bytes < 0) return \"0 B\";\n  const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\"];\n  let value = bytes;\n  let unit = 0;\n  while (value >= 1024 && unit < units.length - 1) {\n    value /= 1024;\n    unit += 1;\n  }\n  return unit === 0\n    ? `${Math.round(value)} ${units[unit]}`\n    : `${value.toFixed(1)} ${units[unit]}`;\n}\n\nfunction exhaustedMessage(error: GraphQLErrorLike): string {\n  const left = limitLeftOf(error);\n  return left === null\n    ? QUOTA_EXHAUSTED_MESSAGE\n    : `${QUOTA_EXHAUSTED_MESSAGE} Space left: ${formatBytes(left)}.`;\n}\n\n/**\n * The quota refusal in a GraphQL body, if there is one. Used for both the\n * gateway's 429 response and an in-band error on a 200 response.\n */\nexport function quotaErrorFrom(body: unknown): UploadRequestError | null {\n  for (const error of errorsOf(body)) {\n    const code = codeOf(error);\n    if (code === QUOTA_NOT_PROVISIONED) {\n      return new UploadRequestError(QUOTA_NOT_PROVISIONED_MESSAGE, code, null);\n    }\n    if (code === QUOTA_EXHAUSTED) {\n      return new UploadRequestError(exhaustedMessage(error), code, null);\n    }\n  }\n  return null;\n}\n\n/**\n * The error for a non-2xx gateway response. `body` is the parsed JSON body, or\n * undefined when it was missing or not JSON.\n */\nexport function httpErrorFrom(\n  status: number,\n  statusText: string,\n  body: unknown,\n): UploadRequestError {\n  const quota = quotaErrorFrom(body);\n  if (quota) {\n    return new UploadRequestError(quota.message, quota.code, status);\n  }\n  const first = errorsOf(body)[0];\n  if (first && typeof first.message === \"string\" && first.message.trim()) {\n    return new UploadRequestError(first.message, codeOf(first), status);\n  }\n  if (status === 429) {\n    return new UploadRequestError(RATE_LIMITED_MESSAGE, null, status);\n  }\n  const suffix = statusText ? ` ${statusText}` : \"\";\n  return new UploadRequestError(\n    `GraphQL request failed: ${status}${suffix}`,\n    null,\n    status,\n  );\n}\n\n/** The error for in-band GraphQL errors on a 2xx response. */\nexport function graphQLErrorFrom(body: unknown): UploadRequestError | null {\n  const quota = quotaErrorFrom(body);\n  if (quota) return quota;\n  const errors = errorsOf(body);\n  const [first] = errors;\n  if (!first) return null;\n  const message = errors\n    .map((e) => (typeof e.message === \"string\" ? e.message : \"\"))\n    .filter(Boolean)\n    .join(\"; \");\n  return new UploadRequestError(\n    message || \"GraphQL request failed\",\n    codeOf(first),\n    null,\n  );\n}\n"],"mappings":"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"}