@butinapp/shapes 0.1.0 → 0.1.1

package/dist/export-bundle.d.ts

@@ -140,6 +140,7 @@ export type ExportBundle = z.infer<typeof ExportBundleSchema>;
 export type ParseBundleResult = {
     ok: true;
     bundle: ExportBundle;
+    warnings: string[];
 } | {
     ok: false;
     errors: string[];

package/dist/export-bundle.js

@@ -52,6 +52,50 @@ export const ExportBundleSchema = z.object({
     // renderer ("the cloud is dumb on purpose").
     overview: z.array(OverviewPluginSchema)
 });
+// The bundle envelope with its two service arrays left unvalidated (validated per-entry so one bad entry
+// doesn't reject the whole blob). Scalar top-level fields still fail hard.
+const ExportBundleEnvelopeSchema = ExportBundleSchema.extend({
+    plugins: z.array(z.unknown()),
+    overview: z.array(z.unknown())
+});
+// Walk a value along a zod issue path, returning what the issue points at (undefined if the path runs off a
+// null/absent branch) — lets us tell an absent field apart from a present-but-wrong one.
+const valueAtPath = (value, path) => path.reduce((acc, key) => (acc == null ? undefined : acc[key]), value);
+const serviceOf = (kind, item) => {
+    if (kind === 'overview') {
+        const o = item;
+        return o?.pluginId ?? o?.pluginName;
+    }
+    return item?.meta?.id;
+};
+// Validate one array's entries independently: keep the ones that parse, and turn each failure into a warning
+// that names the service and flags absent fields (which usually mean the entry predates a schema addition).
+const salvageEntries = (schema, items, kind) => {
+    const kept = [];
+    const warnings = [];
+    items.forEach((item, index) => {
+        const parsed = schema.safeParse(item);
+        if (parsed.success) {
+            kept.push(parsed.data);
+            return;
+        }
+        const service = serviceOf(kind, item);
+        const label = `${kind}[${index}]${service ? ` (service '${service}')` : ''}`;
+        let anyAbsent = false;
+        const detail = parsed.error.issues
+            .map((i) => {
+            const absent = valueAtPath(item, i.path) === undefined;
+            anyAbsent ||= absent;
+            return `${i.path.join('.') || '(value)'}: ${i.message}`;
+        })
+            .join('; ');
+        const hint = anyAbsent
+            ? " — a field is absent (this service's cached data predates it); refresh it and re-export"
+            : '';
+        warnings.push(`dropped ${label}: ${detail}${hint}`);
+    });
+    return { kept, warnings };
+};
 export const parseExportBundle = (raw) => {
     const version = raw?.formatVersion;
     if (typeof version === 'number' && version > EXPORT_BUNDLE_FORMAT_VERSION) {
@@ -60,9 +104,15 @@ export const parseExportBundle = (raw) => {
             errors: [`bundle formatVersion ${version} is newer than this viewer supports (${EXPORT_BUNDLE_FORMAT_VERSION})`]
         };
     }
-    const parsed = ExportBundleSchema.safeParse(raw);
-    if (!parsed.success) {
-        return { ok: false, errors: parsed.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`) };
+    const envelope = ExportBundleEnvelopeSchema.safeParse(raw);
+    if (!envelope.success) {
+        return { ok: false, errors: envelope.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`) };
     }
-    return { ok: true, bundle: parsed.data };
+    const plugins = salvageEntries(ExportPluginSchema, envelope.data.plugins, 'plugins');
+    const overview = salvageEntries(OverviewPluginSchema, envelope.data.overview, 'overview');
+    return {
+        ok: true,
+        bundle: { ...envelope.data, plugins: plugins.kept, overview: overview.kept },
+        warnings: [...plugins.warnings, ...overview.warnings]
+    };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@butinapp/shapes",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Butin's host-layer data shapes built on the @butinapp/sdk data-view contract: the cross-service Overview input, the persisted ledger, the presentation manifest, and the portable export-bundle wire format.",
   "homepage": "https://butin.app",
   "bugs": "https://github.com/butinapp/butin/issues",
@@ -37,7 +37,7 @@
     "lodash-es": "^4.18.1",
     "luxon": "^3.7.2",
     "zod": "^4.3.6",
-    "@butinapp/sdk": "0.1.0"
+    "@butinapp/sdk": "0.1.1"
   },
   "devDependencies": {
     "vitest": "^4.1.7"