@statezero/core 0.2.45 → 0.2.47

package/dist/adaptors/vue/components/defaults/AlertElement.d.ts

@@ -0,0 +1 @@
+export default AlertElement;

package/dist/adaptors/vue/components/defaults/DisplayElement.d.ts

@@ -0,0 +1 @@
+export default DisplayElement;

package/dist/adaptors/vue/components/defaults/DividerElement.d.ts

@@ -0,0 +1 @@
+export default DividerElement;

package/dist/adaptors/vue/components/defaults/ErrorBlock.d.ts

@@ -0,0 +1 @@
+export default ErrorBlock;

package/dist/adaptors/vue/components/defaults/GroupElement.d.ts

@@ -0,0 +1 @@
+export default GroupElement;

package/dist/adaptors/vue/components/defaults/LabelElement.d.ts

@@ -0,0 +1 @@
+export default LabelElement;

package/dist/adaptors/vue/components/defaults/TabsElement.d.ts

@@ -0,0 +1 @@
+export default TabsElement;

package/dist/adaptors/vue/components/defaults/index.d.ts

@@ -5,4 +5,11 @@
  * @returns {Object} Components registry for LayoutRenderer
  */
 export function createDefaultComponents(options?: Object): Object;
+import AlertElement from './AlertElement.js';
+import LabelElement from './LabelElement.js';
+import DividerElement from './DividerElement.js';
+import DisplayElement from './DisplayElement.js';
+import GroupElement from './GroupElement.js';
+import TabsElement from './TabsElement.js';
+import ErrorBlock from './ErrorBlock.js';
 export { AlertElement, LabelElement, DividerElement, DisplayElement, GroupElement, TabsElement, ErrorBlock };

package/dist/adaptors/vue/components/index.d.ts

@@ -1 +1,3 @@
+export { default as LayoutRenderer } from "./LayoutRenderer.js";
+export { default as StateZeroDebugPanel } from "./StateZeroDebugPanel.js";
 export { AlertElement, LabelElement, DividerElement, DisplayElement, GroupElement, TabsElement, ErrorBlock, createDefaultComponents } from "./defaults/index.js";

package/dist/adaptors/vue/components/index.js

@@ -3,5 +3,6 @@
  */
 // Main layout renderer
 export { default as LayoutRenderer } from './LayoutRenderer.js';
+export { default as StateZeroDebugPanel } from './StateZeroDebugPanel.js';
 // Default component implementations
 export { AlertElement, LabelElement, DividerElement, DisplayElement, GroupElement, TabsElement, ErrorBlock, createDefaultComponents } from './defaults/index.js';

package/dist/adaptors/vue/composables.js

@@ -43,5 +43,4 @@ registerAdapterReset(() => {
     // Reset syncManager back to following all querysets since no composables are active
     syncManager.followAllQuerysets = true;
     syncManager.followedQuerysets.clear();
-    console.log("Vue composables state cleared");
 });

package/dist/adaptors/vue/index.d.ts

@@ -1,3 +1,3 @@
 export { useQueryset, querysets } from "./composables.js";
 export { ModelAdaptor, QuerySetAdaptor, MetricAdaptor } from "./reactivity.js";
-export { LayoutRenderer, AlertElement, LabelElement, DividerElement, DisplayElement, GroupElement, TabsElement, ErrorBlock, createDefaultComponents } from "./components/index.js";
+export { LayoutRenderer, StateZeroDebugPanel, AlertElement, LabelElement, DividerElement, DisplayElement, GroupElement, TabsElement, ErrorBlock, createDefaultComponents } from "./components/index.js";

package/dist/adaptors/vue/index.js

@@ -1,4 +1,4 @@
 export { useQueryset, querysets } from './composables.js';
 export { ModelAdaptor, QuerySetAdaptor, MetricAdaptor } from './reactivity.js';
 // Layout components
-export { LayoutRenderer, AlertElement, LabelElement, DividerElement, DisplayElement, GroupElement, TabsElement, ErrorBlock, createDefaultComponents } from './components/index.js';
+export { LayoutRenderer, StateZeroDebugPanel, AlertElement, LabelElement, DividerElement, DisplayElement, GroupElement, TabsElement, ErrorBlock, createDefaultComponents } from './components/index.js';

package/dist/config.js

@@ -159,9 +159,19 @@ export function initializeEventReceiver(backendKey = 'default') {
                 if (!backendConfig.events.pusher.clientOptions.authEndpoint) {
                     throw new ConfigError('Pusher auth endpoint is required for Pusher event receiver.');
                 }
+                const baseGetAuthHeaders = backendConfig.events.pusher.clientOptions.getAuthHeaders ||
+                    backendConfig.getAuthHeaders;
+                const syncToken = backendConfig.SYNC_TOKEN;
+                const getAuthHeaders = () => {
+                    const headers = baseGetAuthHeaders ? baseGetAuthHeaders() : {};
+                    if (syncToken) {
+                        return { ...headers, "X-StateZero-Sync-Token": syncToken };
+                    }
+                    return headers;
+                };
                 const clientOptions = {
                     ...backendConfig.events.pusher.clientOptions,
-                    getAuthHeaders: backendConfig.events.pusher.clientOptions.getAuthHeaders || backendConfig.getAuthHeaders
+                    getAuthHeaders
                 };
                 // Pass the backendKey to the constructor
                 receiver = new PusherEventReceiver({ clientOptions }, backendKey);

package/dist/core/eventReceivers.d.ts

@@ -65,9 +65,9 @@ export namespace EventType {
  */
 export class PusherEventReceiver {
     /**
-     * @param {PusherReceiverOptions} options
-     * @param {string} configKey - The backend configuration key
-     */
+   * @param {PusherReceiverOptions} options
+   * @param {string} configKey - The backend configuration key
+   */
     constructor(options: PusherReceiverOptions, configKey: string);
     configKey: string;
     connectionTimeoutId: NodeJS.Timeout;

package/dist/core/eventReceivers.js

@@ -58,9 +58,9 @@ export const EventType = {
  */
 export class PusherEventReceiver {
     /**
-     * @param {PusherReceiverOptions} options
-     * @param {string} configKey - The backend configuration key
-     */
+   * @param {PusherReceiverOptions} options
+   * @param {string} configKey - The backend configuration key
+   */
     constructor(options, configKey) {
         const { clientOptions, formatChannelName, namespaceResolver } = options;
         const CONNECTION_TIMEOUT = 10000; // 10 seconds
@@ -152,6 +152,9 @@ Common causes:
         });
         channel.bind("pusher:subscription_error", (status) => {
             console.error(`Subscription error for channel: ${channelName}. Status:`, status);
+            if (status === 409) {
+                console.error(`%cSync token mismatch on auth for backend ${this.configKey}. Check scenario/prod config.`, "color: red; font-weight: bold;");
+            }
             if (status.status === 401 || status.status === 403) {
                 console.error(`%cAuthentication failed for channel ${channelName}. Check your authEndpoint and server-side permissions.`, "color: orange; font-weight: bold;");
             }

package/dist/core.css

@@ -0,0 +1 @@
+.szd[data-v-6d80920c]{font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,sans-serif;font-size:13px;color:#1f2937;background:#fff;border:1px solid #e5e7eb;border-radius:8px;display:flex;flex-direction:column;max-height:600px;overflow:hidden}.szd-header[data-v-6d80920c]{border-bottom:1px solid #e5e7eb;background:#f9fafb}.szd-header__top[data-v-6d80920c]{display:flex;align-items:center;justify-content:space-between;padding:8px 12px;gap:12px}.szd-header__left[data-v-6d80920c]{display:flex;align-items:center;gap:8px}.szd-header__right[data-v-6d80920c]{display:flex;align-items:center;gap:6px}.szd-header__title[data-v-6d80920c]{font-weight:600;font-size:14px}.szd-header__model[data-v-6d80920c]{font-size:12px;color:#1f2937;background:#e5e7eb;padding:2px 8px;border-radius:4px}.szd-header__model--empty[data-v-6d80920c]{color:#9ca3af;background:transparent}.szd-header__badge[data-v-6d80920c]{font-size:11px;color:#6b7280;background:#f3f4f6;padding:2px 6px;border-radius:4px}.szd-header__badge--syncing[data-v-6d80920c]{color:#059669;background:#d1fae5}.szd-tabs[data-v-6d80920c]{display:flex;gap:0;padding:0 12px;border-top:1px solid #e5e7eb}.szd-tabs__tab[data-v-6d80920c]{padding:10px 16px;background:none;border:none;border-bottom:2px solid transparent;cursor:pointer;font-size:13px;font-weight:500;color:#6b7280;transition:all .15s}.szd-tabs__tab[data-v-6d80920c]:hover{color:#1f2937}.szd-tabs__tab--active[data-v-6d80920c]{color:#2563eb;border-bottom-color:#2563eb}.szd-content[data-v-6d80920c]{flex:1;overflow:auto;padding:16px}.szd-panel__section[data-v-6d80920c]{margin-bottom:20px}.szd-panel__section[data-v-6d80920c]:last-child{margin-bottom:0}.szd-panel__heading[data-v-6d80920c]{font-size:12px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:#6b7280;margin:0 0 10px}.szd-kv__row[data-v-6d80920c]{display:flex;gap:8px;padding:4px 0;border-bottom:1px solid #f3f4f6}.szd-kv__row[data-v-6d80920c]:last-child{border-bottom:none}.szd-kv__key[data-v-6d80920c]{font-weight:500;color:#6b7280;min-width:100px}.szd-kv__value[data-v-6d80920c]{color:#1f2937}.szd-kv__value--mono[data-v-6d80920c]{font-family:ui-monospace,monospace;font-size:12px}.szd-kv__note[data-v-6d80920c]{color:#9ca3af;font-size:11px}.szd-stats[data-v-6d80920c]{display:grid;grid-template-columns:repeat(auto-fit,minmax(100px,1fr));gap:12px}.szd-stat[data-v-6d80920c]{background:#f9fafb;border:1px solid #e5e7eb;border-radius:6px;padding:12px;text-align:center}.szd-stat__value[data-v-6d80920c]{font-size:24px;font-weight:600;color:#1f2937}.szd-stat__label[data-v-6d80920c]{font-size:11px;color:#6b7280;margin-top:4px}.szd-event-preview[data-v-6d80920c]{display:flex;align-items:center;gap:10px;width:100%;padding:10px;background:#f9fafb;border:1px solid #e5e7eb;border-radius:6px;cursor:pointer;text-align:left}.szd-event-preview[data-v-6d80920c]:hover{background:#f3f4f6}.szd-event-preview__badge[data-v-6d80920c]{padding:2px 8px;border-radius:4px;color:#fff;font-size:11px;font-weight:500}.szd-event-preview__text[data-v-6d80920c]{flex:1}.szd-event-preview__time[data-v-6d80920c]{color:#9ca3af;font-size:12px}.szd-timeline-filters[data-v-6d80920c]{display:flex;flex-wrap:wrap;gap:6px;margin-bottom:12px;align-items:center}.szd-filter-chip[data-v-6d80920c]{display:inline-flex;align-items:center;padding:4px 10px;border:1px solid #d1d5db;border-radius:999px;font-size:12px;cursor:pointer;transition:all .15s;-webkit-user-select:none;user-select:none}.szd-filter-chip--active[data-v-6d80920c]{color:#fff}.szd-filter-chip__input[data-v-6d80920c]{display:none}.szd-timeline[data-v-6d80920c]{display:flex;flex-direction:column;gap:4px;max-height:350px;overflow:auto}.szd-timeline__item[data-v-6d80920c]{display:flex;align-items:center;gap:10px;padding:8px 10px;border-radius:4px;cursor:pointer;transition:background .1s}.szd-timeline__item[data-v-6d80920c]:hover{background:#f3f4f6}.szd-timeline__time[data-v-6d80920c]{font-size:11px;color:#9ca3af;min-width:70px}.szd-timeline__badge[data-v-6d80920c]{padding:2px 8px;border-radius:4px;color:#fff;font-size:10px;font-weight:500;min-width:70px;text-align:center}.szd-timeline__text[data-v-6d80920c]{flex:1;font-size:12px}.szd-preview-header[data-v-6d80920c]{display:flex;align-items:center;justify-content:space-between;margin-bottom:12px}.szd-preview-header .szd-panel__heading[data-v-6d80920c]{margin:0}.szd-data-grid[data-v-6d80920c]{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:12px}.szd-data-card[data-v-6d80920c]{border:1px solid #e5e7eb;border-radius:6px;overflow:hidden}.szd-data-card__header[data-v-6d80920c]{display:flex;align-items:center;justify-content:space-between;background:#f9fafb;padding:8px 10px;font-size:12px;font-weight:500;border-bottom:1px solid #e5e7eb}.szd-data-card__badge[data-v-6d80920c]{font-size:10px;padding:2px 6px;border-radius:4px;background:#d1fae5;color:#059669}.szd-data-card__badge--absent[data-v-6d80920c]{background:#fee2e2;color:#dc2626}.szd-data-card__content[data-v-6d80920c]{padding:8px 10px;font-size:11px;font-family:ui-monospace,monospace;background:#1f2937;color:#f3f4f6;margin:0;max-height:150px;overflow:auto}.szd-pipeline[data-v-6d80920c]{display:flex;align-items:center;gap:8px;flex-wrap:wrap;justify-content:center}.szd-pipeline__stage[data-v-6d80920c]{display:flex;flex-direction:column;align-items:center;padding:12px 16px;background:#f9fafb;border:1px solid #e5e7eb;border-radius:8px;cursor:pointer;transition:all .15s;min-width:90px}.szd-pipeline__stage[data-v-6d80920c]:hover{background:#eff6ff;border-color:#2563eb}.szd-pipeline__label[data-v-6d80920c]{font-size:11px;color:#6b7280}.szd-pipeline__count[data-v-6d80920c]{font-size:20px;font-weight:600;color:#1f2937}.szd-pipeline__arrow[data-v-6d80920c]{color:#9ca3af;font-size:18px}.szd-ast[data-v-6d80920c]{background:#1f2937;color:#f3f4f6;padding:12px;border-radius:6px;font-size:11px;font-family:ui-monospace,monospace;margin:0;overflow:auto;max-height:400px}.szd-detail__body .szd-ast[data-v-6d80920c]{max-height:none;flex:1}.szd-detail__panel--sm[data-v-6d80920c]{max-width:440px}.szd-settings-section[data-v-6d80920c]{margin-bottom:20px}.szd-settings-section[data-v-6d80920c]:last-child{margin-bottom:0}.szd-settings-label[data-v-6d80920c]{display:block;font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:#6b7280;margin-bottom:8px}.szd-settings-row[data-v-6d80920c]{display:flex;align-items:center;gap:8px}.szd-settings-code[data-v-6d80920c]{flex:1;font-size:11px;font-family:ui-monospace,monospace;background:#f3f4f6;padding:8px 10px;border-radius:6px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.szd-settings-actions[data-v-6d80920c]{display:flex;gap:8px}.szd-select--full[data-v-6d80920c]{width:100%}.szd-detail[data-v-6d80920c]{position:fixed;inset:0;z-index:1000;display:flex;align-items:center;justify-content:center;padding:24px}.szd-detail__backdrop[data-v-6d80920c]{position:absolute;inset:0;background:#00000080}.szd-detail__panel[data-v-6d80920c]{position:relative;width:100%;max-width:700px;max-height:80vh;background:#fff;border-radius:12px;box-shadow:0 20px 50px #00000040;display:flex;flex-direction:column;overflow:hidden}.szd-detail__header[data-v-6d80920c]{display:flex;align-items:center;justify-content:space-between;padding:16px 20px;border-bottom:1px solid #e5e7eb;background:#f9fafb;border-radius:12px 12px 0 0}.szd-detail__title[data-v-6d80920c]{margin:0;font-size:16px;font-weight:600}.szd-detail__body[data-v-6d80920c]{flex:1;padding:20px;overflow:auto}.szd-slide-enter-active[data-v-6d80920c],.szd-slide-leave-active[data-v-6d80920c]{transition:opacity .2s}.szd-slide-enter-active .szd-detail__panel[data-v-6d80920c],.szd-slide-leave-active .szd-detail__panel[data-v-6d80920c]{transition:transform .2s,opacity .2s}.szd-slide-enter-from[data-v-6d80920c],.szd-slide-leave-to[data-v-6d80920c]{opacity:0}.szd-slide-enter-from .szd-detail__panel[data-v-6d80920c],.szd-slide-leave-to .szd-detail__panel[data-v-6d80920c]{transform:scale(.95);opacity:0}.szd-select[data-v-6d80920c]{padding:6px 10px;border:1px solid #d1d5db;border-radius:6px;font-size:13px;background:#fff;min-width:180px}.szd-btn[data-v-6d80920c]{padding:6px 12px;border:1px solid #d1d5db;border-radius:6px;background:#fff;font-size:13px;cursor:pointer;transition:all .1s}.szd-btn[data-v-6d80920c]:hover:not(:disabled){background:#f3f4f6}.szd-btn[data-v-6d80920c]:disabled{opacity:.5;cursor:not-allowed}.szd-btn--sm[data-v-6d80920c]{padding:4px 8px;font-size:11px}.szd-btn--icon[data-v-6d80920c]{padding:6px;display:flex;align-items:center;justify-content:center}.szd-toggle[data-v-6d80920c]{display:flex;align-items:center;gap:4px;font-size:12px;cursor:pointer}.szd-empty[data-v-6d80920c]{padding:40px;text-align:center;color:#9ca3af}

package/dist/debug/statezeroDebug.d.ts

@@ -0,0 +1,8 @@
+export function recordDebugEvent(entry: any): void;
+export function subscribeDebugEvents(handler: any): () => any;
+export function subscribeDebugClear(handler: any): () => any;
+export function getDebugEntries(): any;
+export function clearDebugEntries(): void;
+export function setDebugEnabled(value: any): void;
+export function setDebugMaxEntries(value: any): void;
+export function startStateZeroDebug(): void;

package/dist/debug/statezeroDebug.js

@@ -0,0 +1,118 @@
+import mitt from "mitt";
+import { operationEvents, Status } from "../syncEngine/stores/operation.js";
+const GLOBAL_KEY = "__STATEZERO_DEBUG__";
+const globalState = globalThis[GLOBAL_KEY] || {
+    emitter: mitt(),
+    buffer: [],
+    enabled: true,
+    started: false,
+    maxEntries: 500,
+    nextId: 1,
+};
+globalThis[GLOBAL_KEY] = globalState;
+const emitter = globalState.emitter;
+const buffer = globalState.buffer;
+function pushEntry(entry) {
+    if (!globalState.enabled)
+        return;
+    const item = {
+        id: globalState.nextId++,
+        ts: Date.now(),
+        ...entry,
+    };
+    buffer.push(item);
+    if (buffer.length > globalState.maxEntries) {
+        buffer.shift();
+    }
+    emitter.emit("record", item);
+}
+export function recordDebugEvent(entry) {
+    pushEntry(entry);
+}
+export function subscribeDebugEvents(handler) {
+    emitter.on("record", handler);
+    return () => emitter.off("record", handler);
+}
+export function subscribeDebugClear(handler) {
+    emitter.on("clear", handler);
+    return () => emitter.off("clear", handler);
+}
+export function getDebugEntries() {
+    return buffer.slice();
+}
+export function clearDebugEntries() {
+    buffer.length = 0;
+    emitter.emit("clear");
+}
+export function setDebugEnabled(value) {
+    globalState.enabled = Boolean(value);
+}
+export function setDebugMaxEntries(value) {
+    const next = Number(value);
+    if (!Number.isFinite(next) || next <= 0)
+        return;
+    globalState.maxEntries = Math.floor(next);
+    if (buffer.length > globalState.maxEntries) {
+        buffer.splice(0, buffer.length - globalState.maxEntries);
+    }
+}
+export function startStateZeroDebug() {
+    if (globalState.started)
+        return;
+    globalState.started = true;
+    operationEvents.on(Status.CREATED, (operation) => {
+        pushEntry({
+            type: "operation",
+            subtype: Status.CREATED,
+            operationId: operation.operationId,
+            operationType: operation.type,
+            status: operation.status,
+            semanticKey: operation.queryset?.semanticKey,
+            modelName: operation.queryset?.ModelClass?.modelName,
+            configKey: operation.queryset?.ModelClass?.configKey,
+            instanceCount: operation.instances?.length ?? 0,
+        });
+    });
+    operationEvents.on(Status.MUTATED, (operation) => {
+        pushEntry({
+            type: "operation",
+            subtype: Status.MUTATED,
+            operationId: operation.operationId,
+            operationType: operation.type,
+            status: operation.status,
+            semanticKey: operation.queryset?.semanticKey,
+            modelName: operation.queryset?.ModelClass?.modelName,
+            configKey: operation.queryset?.ModelClass?.configKey,
+            instanceCount: operation.instances?.length ?? 0,
+        });
+    });
+    operationEvents.on(Status.CONFIRMED, (operation) => {
+        pushEntry({
+            type: "operation",
+            subtype: Status.CONFIRMED,
+            operationId: operation.operationId,
+            operationType: operation.type,
+            status: operation.status,
+            semanticKey: operation.queryset?.semanticKey,
+            modelName: operation.queryset?.ModelClass?.modelName,
+            configKey: operation.queryset?.ModelClass?.configKey,
+            instanceCount: operation.instances?.length ?? 0,
+        });
+    });
+    operationEvents.on(Status.REJECTED, (operation) => {
+        pushEntry({
+            type: "operation",
+            subtype: Status.REJECTED,
+            operationId: operation.operationId,
+            operationType: operation.type,
+            status: operation.status,
+            semanticKey: operation.queryset?.semanticKey,
+            modelName: operation.queryset?.ModelClass?.modelName,
+            configKey: operation.queryset?.ModelClass?.configKey,
+            instanceCount: operation.instances?.length ?? 0,
+        });
+    });
+    operationEvents.on(Status.CLEAR, () => {
+        pushEntry({ type: "operation", subtype: Status.CLEAR });
+    });
+}

package/dist/flavours/django/errors.js

@@ -154,7 +154,6 @@ export class ConfigError extends StateZeroError {
  * @returns {StateZeroError} An instance of a StateZeroError subclass.
  */
 export function parseStateZeroError(errorResponse) {
-    console.log(JSON.stringify(errorResponse));
     const { status, type, detail } = errorResponse;
     // Handle undefined type/status case (like in permission denied)
     if (type === undefined && detail === 'Invalid token.') {

package/dist/flavours/django/makeApiCall.js

@@ -5,6 +5,7 @@ import { replaceTempPks } from './tempPk.js';
 import { parseStateZeroError, MultipleObjectsReturned, DoesNotExist } from './errors.js';
 import { FileObject } from './files.js';
 import { querysetStoreRegistry } from '../../syncEngine/registries/querysetStoreRegistry.js';
+import { recordDebugEvent } from '../../debug/statezeroDebug.js';
 // Namespace-based queues: separate queues for different operation types
 // This prevents sync operations from blocking user-initiated app operations
 const queues = new Map();
@@ -130,6 +131,7 @@ export async function makeApiCall(querySet, operationType, args = {}, operationI
     const baseUrl = backend.API_URL.replace(/\/+$/, "");
     const finalUrl = `${baseUrl}/${ModelClass.modelName}/`;
     const headers = backend.getAuthHeaders ? backend.getAuthHeaders() : {};
+    const semanticKey = querySet.semanticKey;
     if (operationId) {
         headers["X-Operation-ID"] = operationId;
     }
@@ -139,13 +141,82 @@ export async function makeApiCall(querySet, operationType, args = {}, operationI
     // Use the queue for write operations, bypass for read operations
     const apiCall = async () => {
         try {
+            recordDebugEvent({
+                type: "request",
+                modelName: ModelClass.modelName,
+                configKey: ModelClass.configKey,
+                semanticKey,
+                operationType,
+                operationId,
+                canonicalId,
+                url: finalUrl,
+                payload,
+                namespace,
+            });
             let response = await axios.post(finalUrl, replaceTempPks(payload), { headers });
             if (typeof beforeExit === 'function' && response?.data) {
                 await beforeExit(response.data);
             }
+            const rawData = response?.data?.data;
+            const rawIncluded = response?.data?.included;
+            const dataCount = Array.isArray(rawData)
+                ? rawData.length
+                : rawData != null
+                    ? 1
+                    : 0;
+            const includedCount = rawIncluded ? Object.keys(rawIncluded).length : 0;
+            const maxItems = 100;
+            const data = Array.isArray(rawData) && rawData.length > maxItems
+                ? rawData.slice(0, maxItems)
+                : rawData;
+            const dataTruncated = Array.isArray(rawData) && rawData.length > maxItems;
+            let included = rawIncluded;
+            let includedTruncated = false;
+            if (rawIncluded && typeof rawIncluded === "object") {
+                const limited = {};
+                let count = 0;
+                for (const [key, value] of Object.entries(rawIncluded)) {
+                    limited[key] = value;
+                    count += 1;
+                    if (count >= maxItems) {
+                        includedTruncated = true;
+                        break;
+                    }
+                }
+                included = includedTruncated ? limited : rawIncluded;
+            }
+            recordDebugEvent({
+                type: "response",
+                modelName: ModelClass.modelName,
+                configKey: ModelClass.configKey,
+                semanticKey,
+                operationType,
+                operationId,
+                canonicalId,
+                url: finalUrl,
+                status: response.status,
+                dataCount,
+                includedCount,
+                data,
+                included,
+                dataTruncated,
+                includedTruncated,
+            });
             return response.data;
         }
         catch (error) {
+            recordDebugEvent({
+                type: "error",
+                modelName: ModelClass.modelName,
+                configKey: ModelClass.configKey,
+                semanticKey,
+                operationType,
+                operationId,
+                canonicalId,
+                url: finalUrl,
+                status: error?.response?.status,
+                message: error?.message,
+            });
             if (error?.code === "ECONNREFUSED") {
                 const hint = "Connection refused. If you're running tests, start the test server with `python manage.py statezero_testserver`.";
                 throw new Error(`${hint} (${finalUrl})`);

package/dist/reset.js

@@ -31,7 +31,6 @@ export function unregisterAdapterReset(resetFn) {
  * Call this after login to ensure clean authenticated state.
  */
 export async function resetStateZero() {
-    console.log("🔄 StateZero: Resetting...");
     try {
         // 1. Clear ALL operations first
         operationRegistry.clear();
@@ -88,7 +87,6 @@ export async function resetStateZero() {
         querysetStoreRegistry.setSyncManager(syncManager);
         modelStoreRegistry.setSyncManager(syncManager);
         metricRegistry.setSyncManager(syncManager);
-        console.log("✅ StateZero reset complete - everything cleared");
     }
     catch (error) {
         console.error("❌ StateZero reset failed:", error);

package/dist/syncEngine/cache/cache.js

@@ -38,7 +38,6 @@ export class IndexedDBStore {
                 try {
                     // Delete the database
                     await this._deleteDatabase();
-                    console.log(`[IndexedDBStore] Successfully deleted database "${this.dbName}", attempting to reopen...`);
                     // Try to open it again at the desired version
                     return await this._openDatabase();
                 }

package/dist/syncEngine/registries/querysetStoreRegistry.d.ts

@@ -66,7 +66,7 @@ export class QuerysetStoreRegistry {
      * @param {string} operationId - Unique ID for this sync operation (for coordination)
      * @param {Set} dbSyncedKeys - Set of semanticKeys that are dbSynced (followedQuerysets)
      */
-    groupSync(queryset: Object, operationId: string, dbSyncedKeys: Set<any>): Promise<void>;
+    groupSync(queryset: Object, operationId: string, dbSyncedKeys: Set<any>, canonical_id?: null): Promise<void>;
 }
 export const querysetStoreRegistry: QuerysetStoreRegistry;
 import { QuerysetStoreGraph } from './querysetStoreGraph.js';

package/dist/syncEngine/registries/querysetStoreRegistry.js

@@ -22,6 +22,7 @@ import { isNil, pick } from 'lodash-es';
 import hash from 'object-hash';
 import { Operation } from '../stores/operation.js';
 import { Cache } from '../cache/cache.js';
+import { recordDebugEvent } from '../../debug/statezeroDebug.js';
 /**
  * A dynamic wrapper that always returns the latest queryset results
  * This class proxies array operations to always reflect the current state
@@ -287,7 +288,7 @@ export class QuerysetStoreRegistry {
      * @param {string} operationId - Unique ID for this sync operation (for coordination)
      * @param {Set} dbSyncedKeys - Set of semanticKeys that are dbSynced (followedQuerysets)
      */
-    async groupSync(queryset, operationId, dbSyncedKeys) {
+    async groupSync(queryset, operationId, dbSyncedKeys, canonical_id = null) {
         if (isNil(queryset))
             return;
         const semanticKey = queryset.semanticKey;
@@ -304,6 +305,16 @@ export class QuerysetStoreRegistry {
         // Find the dbSynced root
         const { isRoot, root: rootKey } = this.querysetStoreGraph.findRoot(queryset, subset);
         const iAmRoot = isRoot || rootKey === semanticKey;
+        recordDebugEvent({
+            type: "groupSync",
+            phase: "start",
+            operationId,
+            semanticKey,
+            rootKey,
+            iAmRoot,
+            modelName: ModelClass?.modelName,
+            configKey: ModelClass?.configKey,
+        });
         // Get or create cache entry - whoever arrives first creates it
         if (!this._groupSyncCache.has(operationId)) {
             let resolve;
@@ -319,9 +330,21 @@ export class QuerysetStoreRegistry {
         }
         if (iAmRoot) {
             // I'm the root - sync from DB (store handles everything)
-            await store.sync();
+            await store.sync(canonical_id);
             cached.pks = store.groundTruthPks;
             cached.resolve();
+            recordDebugEvent({
+                type: "groupSync",
+                phase: "rootSynced",
+                operationId,
+                semanticKey,
+                rootKey,
+                modelName: ModelClass?.modelName,
+                configKey: ModelClass?.configKey,
+                dataCount: Array.isArray(store.groundTruthPks)
+                    ? store.groundTruthPks.length
+                    : 0,
+            });
         }
         else {
             // Wait for root to finish with timeout to prevent deadlocks
@@ -349,7 +372,16 @@ export class QuerysetStoreRegistry {
             // Fallback to direct sync on timeout or if root data is missing
             if (timedOut || !cached.pks) {
                 console.warn(`[groupSync] Falling back to direct sync for: ${semanticKey.substring(0, 60)}`);
-                await store.sync();
+                await store.sync(canonical_id);
+                recordDebugEvent({
+                    type: "groupSync",
+                    phase: "fallbackSync",
+                    operationId,
+                    semanticKey,
+                    rootKey,
+                    modelName: ModelClass?.modelName,
+                    configKey: ModelClass?.configKey,
+                });
                 return;
             }
             // Filter from cached root data
@@ -360,6 +392,16 @@ export class QuerysetStoreRegistry {
             store.setGroundTruth(filteredPks);
             store.setOperations(store.getInflightOperations());
             store.lastSync = Date.now();
+            recordDebugEvent({
+                type: "groupSync",
+                phase: "filteredFromRoot",
+                operationId,
+                semanticKey,
+                rootKey,
+                modelName: ModelClass?.modelName,
+                configKey: ModelClass?.configKey,
+                dataCount: Array.isArray(filteredPks) ? filteredPks.length : 0,
+            });
         }
     }
 }

package/dist/syncEngine/stores/metricStore.js

@@ -124,7 +124,6 @@ export class MetricStore {
         if (this.groundTruthValue === null) {
             const cached = this.metricCache.get(this.cacheKey);
             if (!isNil(cached) && !isEmpty(cached)) {
-                console.log(`[MetricStore] Hydrated ${this.metricType} metric for ${this.modelClass.modelName} from cache`);
                 this.setGroundTruth(cached?.value);
             }
         }
@@ -164,7 +163,6 @@ export class MetricStore {
     render() {
         // Check if ground truth value is null
         if (isNil(this.groundTruthValue)) {
-            console.log(`groundTruthValue is null, returning null`);
             return null;
         }
         // Calculate the new value using the operations-based approach
@@ -193,7 +191,6 @@ export class MetricStore {
         }
         this.isSyncing = true;
         try {
-            console.log(`[MetricStore] Syncing ${this.metricType} metric for ${this.modelClass.modelName}`);
             // Use fetchFn to get server metric value
             const result = await this.fetchFn({
                 metricType: this.metricType,
@@ -208,7 +205,6 @@ export class MetricStore {
             }
             // Update ground truth
             this.setGroundTruth(result);
-            console.log(`[MetricStore] Synced ${this.metricType} metric with value:`, result);
             return result;
         }
         catch (error) {

package/dist/syncEngine/stores/modelStore.js

@@ -137,7 +137,6 @@ export class ModelStore {
     onHydrated() {
         if (this.groundTruthArray.length === 0 && this.operationsMap.size === 0) {
             let cached = this.modelCache.get(this.cacheKey);
-            console.log(`[ModelStore] Hydrated ${this.modelClass.modelName} with ${(cached || []).length} items from cache`);
             if (!isNil(cached) && !isEmpty(cached)) {
                 this.setGroundTruth(cached);
             }
@@ -322,7 +321,6 @@ export class ModelStore {
                 queryset: this.modelClass.objects.all(),
             });
             this.operationsMap.set(checkpointOperation.operationId, checkpointOperation);
-            console.log(`[ModelStore ${this.modelClass.modelName}] Created CHECKPOINT operation for ${checkpointInstances.length} existing instances`);
         }
         // reactivity - use all the newly added instances (both new and updated)
         emitEvents(this, EventData.fromInstances([...checkpointInstances, ...Array.from(pkMap.values())], this.modelClass));
@@ -450,7 +448,6 @@ export class ModelStore {
         });
         const removedCount = this.groundTruthArray.length - filteredGroundTruth.length;
         if (removedCount > 0) {
-            console.log(`[ModelStore ${modelName}] Pruned ${removedCount} unreferenced instances (${filteredGroundTruth.length} remaining)`);
             this.groundTruthArray = filteredGroundTruth;
             // Update the cache to reflect the pruned data
             this.setCache(filteredGroundTruth);

package/dist/syncEngine/stores/operation.js

@@ -270,7 +270,6 @@ class OperationRegistry {
      * Clears all operations from the registry.
      */
     clear() {
-        console.log("OperationRegistry: Clearing all operations.");
         this._operations.clear();
         this._querysetStates.clear();
         operationEvents.emit(Status.CLEAR);