@makinbakin/sdk 0.0.1-rc.25 → 0.0.1-rc.26

package/_internal/core/health/observation-builders.d.ts

@@ -30,4 +30,13 @@ export declare function healthUnknown(input: UnknownObservationFields): UnknownO
 export declare function healthObserved(observations: HealthNonEmptyArray<HealthObservationInput>): ObservedHealthCheckRunInput;
 /** Build an explicit successful not-applicable run. */
 export declare function healthNotApplicable(reason: string): NotApplicableHealthCheckRunInput;
+/**
+ * Deterministically coerce arbitrary text (a filesystem path, a table
+ * name, a task id) into the contract's stable resource-id format
+ * (`^[a-z0-9][a-z0-9._:-]{0,127}$`). A raw path used as a resource id
+ * failed contract validation and nuked a REAL finding into a generic
+ * "could not be verified" card for three releases (field-diagnosed
+ * 2026-07-23). Put the human-readable original in `label`, never in `id`.
+ */
+export declare function healthResourceId(raw: string): string;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@makinbakin/sdk",
-  "version": "0.0.1-rc.25",
+  "version": "0.0.1-rc.26",
   "description": "SDK for building Bakin plugins — UI components, slot types, hooks, and the runtime registerPlugin helper.",
   "type": "module",
   "sideEffects": false,

package/utils/index.d.ts

@@ -5,7 +5,7 @@
  * needs. The `format*` helpers are re-exported from `@bakin/core/format`
  * so plugins have a single import path instead of reaching into `@/lib/*`.
  */
-export { healthError, healthHealthy, healthNotApplicable, healthObserved, healthUnknown, healthWarning, } from '../_internal/core/health/observation-builders';
+export { healthError, healthHealthy, healthNotApplicable, healthObserved, healthResourceId, healthUnknown, healthWarning, } from '../_internal/core/health/observation-builders';
 /** Tailwind class merger (clsx + tailwind-merge). */
 export { cn } from '../_internal/app/lib/utils';
 /** Semantic tone for an outline status badge. */

package/utils/index.js

@@ -12,6 +12,23 @@ function truncate(value, max) {
     end -= 1;
   return `${value.slice(0, end)}\u2026`;
 }
+var RESOURCE_LABEL_MAX = 120;
+var STABLE_ID_PATTERN = /^[a-z0-9][a-z0-9._:-]{0,127}$/;
+function normalizeResources(resources) {
+  return resources.map((resource) => {
+    const next = { ...resource };
+    if (!STABLE_ID_PATTERN.test(next.id))
+      next.id = healthResourceId(next.id);
+    if (next.label !== undefined) {
+      const label = next.label.trim();
+      if (label.length === 0)
+        delete next.label;
+      else
+        next.label = truncate(label, RESOURCE_LABEL_MAX);
+    }
+    return next;
+  });
+}
 function clampCopy(input) {
   const clamped = { ...input };
   const summary = clamped.summary.trim();
@@ -24,8 +41,13 @@ function clampCopy(input) {
       clamped.detail = truncate(detail, DETAIL_MAX);
     }
   }
-  if (clamped.incident && clamped.incident.impact.length > IMPACT_MAX) {
-    clamped.incident = { ...clamped.incident, impact: truncate(clamped.incident.impact, IMPACT_MAX) };
+  if (clamped.incident) {
+    const incident = { ...clamped.incident };
+    if (incident.impact.length > IMPACT_MAX)
+      incident.impact = truncate(incident.impact, IMPACT_MAX);
+    if (incident.resources)
+      incident.resources = normalizeResources(incident.resources);
+    clamped.incident = incident;
   }
   return clamped;
 }
@@ -47,6 +69,10 @@ function healthObserved(observations) {
 function healthNotApplicable(reason) {
   return { outcome: "not_applicable", reason };
 }
+function healthResourceId(raw) {
+  const sanitized = raw.toLowerCase().replace(/[^a-z0-9._:-]+/g, "-").replace(/^[^a-z0-9]+/, "").replace(/-+$/, "").slice(0, 128);
+  return sanitized.length > 0 ? sanitized : "unknown";
+}
 // node_modules/.bun/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f, n = "";
@@ -2186,6 +2212,7 @@ export {
   humanizeKey,
   healthWarning,
   healthUnknown,
+  healthResourceId,
   healthObserved,
   healthNotApplicable,
   healthHealthy,