@osdk/react-devtools 0.5.0

package/build/esm/utils/WaterfallDetector.js

@@ -0,0 +1,200 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export class WaterfallDetector {
+  constructor(registry, timeline) {
+    this.registry = registry;
+    this.timeline = timeline;
+  }
+  detectWaterfalls(timingThresholdMs = 50) {
+    const waterfalls = [];
+    waterfalls.push(...this.detectLinkWaterfalls(timingThresholdMs));
+    waterfalls.push(...this.detectMapWaterfalls());
+    waterfalls.push(...this.detectSequentialPatterns(timingThresholdMs));
+    return waterfalls.sort((a, b) => b.timeSaved - a.timeSaved);
+  }
+  detectLinkWaterfalls(timingThresholdMs) {
+    const waterfalls = [];
+    const emissions = this.timeline.getEventsByType("EMISSION");
+    const linkTraversals = this.timeline.getEventsByType("LINK_TRAVERSAL");
+    for (let i = 0; i < emissions.length - 1; i++) {
+      const emissionA = emissions[i];
+      const emissionB = emissions[i + 1];
+      const timeBetween = emissionB.timestamp - emissionA.timestamp;
+      if (timeBetween > 0 && timeBetween < timingThresholdMs) {
+        const linkInWindow = linkTraversals.find(link => link.timestamp > emissionA.timestamp && link.timestamp < emissionB.timestamp);
+        if (linkInWindow) {
+          const estimatedFetchTime = emissionB.timestamp - emissionA.timestamp;
+          waterfalls.push({
+            type: "LINK_WATERFALL",
+            priority: estimatedFetchTime > 200 ? "high" : "medium",
+            timeSaved: estimatedFetchTime,
+            suggestion: `Prefetch the "${linkInWindow.linkName}" relationship to run queries in parallel`,
+            code: this.generateLinkWaterfallCode(emissionA.subscriptionId, emissionB.subscriptionId, linkInWindow.linkName),
+            details: {
+              parentQuery: emissionA.subscriptionId,
+              childQuery: emissionB.subscriptionId
+            }
+          });
+        }
+      }
+    }
+    return waterfalls;
+  }
+  detectMapWaterfalls() {
+    const waterfalls = [];
+    const components = this.registry.getActiveComponents();
+    for (const [componentId, bindings] of components) {
+      const objectQueries = bindings.filter(b => b.hookType === "useOsdkObject");
+      const grouped = new Map();
+      for (const query of objectQueries) {
+        if (query.queryParams.type === "object") {
+          const key = query.queryParams.objectType;
+          if (!grouped.has(key)) {
+            grouped.set(key, []);
+          }
+          const group = grouped.get(key);
+          if (group) {
+            group.push(query);
+          }
+        }
+      }
+      for (const [objectType, queries] of grouped) {
+        if (queries.length > 3) {
+          const bindings = this.registry.getComponentBindings(componentId);
+          const binding = bindings.length > 0 ? bindings[0] : undefined;
+          waterfalls.push({
+            type: "MAP_WATERFALL",
+            priority: queries.length > 10 ? "high" : "medium",
+            timeSaved: queries.length * 100,
+            // Rough estimate
+            suggestion: `Replace ${queries.length} useOsdkObject calls with single useOsdkObjects batch query`,
+            code: this.generateMapWaterfallCode(objectType, queries.length),
+            details: {
+              component: binding ? binding.componentName : undefined,
+              count: queries.length,
+              objectType
+            }
+          });
+        }
+      }
+    }
+    return waterfalls;
+  }
+  detectSequentialPatterns(timingThresholdMs) {
+    const waterfalls = [];
+    const emissions = this.timeline.getEventsByType("EMISSION");
+    let sequenceLength = 1;
+    let totalTime = 0;
+    for (let i = 1; i < emissions.length; i++) {
+      const timeBetween = emissions[i].timestamp - emissions[i - 1].timestamp;
+      if (timeBetween < timingThresholdMs) {
+        sequenceLength++;
+        totalTime += timeBetween;
+      } else {
+        if (sequenceLength > 3 && totalTime > 300) {
+          waterfalls.push({
+            type: "SEQUENTIAL_WATERFALL",
+            priority: totalTime > 500 ? "high" : "medium",
+            timeSaved: totalTime,
+            suggestion: "Consider parallelizing these queries or prefetching data",
+            code: "// Analyze the queries in this sequence and look for prefetching opportunities",
+            details: {}
+          });
+        }
+        sequenceLength = 1;
+        totalTime = 0;
+      }
+    }
+    return waterfalls;
+  }
+  generateLinkWaterfallCode(parentQuery, childQuery, linkName) {
+    return `
+// ⚠️ WATERFALL DETECTED
+// ${parentQuery} loads → triggers ${childQuery} (linked via "${linkName}")
+
+// Problem: Sequential loading adds latency
+// Timeline:
+//   ━━━━ Parent query (t0-t200ms)
+//        ↓ gap
+//        ━━━━ Child/link query (t210-t260ms)
+// Total: 260ms
+
+// This is a known sequential pattern with useOsdkObject + useLinks.
+// The link query cannot start until the parent object is loaded.
+
+// Current pattern:
+const { object: parent } = useOsdkObject(ParentType, id);
+const { links } = useLinks(parent, "${linkName}");
+
+// Option 1: If you have the linked IDs available upfront, load in parallel:
+const [parentResult, childResult] = await Promise.all([
+  useOsdkObject(ParentType, parentId),
+  useOsdkObjects(ChildType, { where: { id: { $in: knownChildIds } } }),
+]);
+
+// Option 2: If data permits, restructure to load the parent object
+// at a higher level so the link query starts sooner.
+    `.trim();
+  }
+  generateMapWaterfallCode(objectType, count) {
+    return `
+// ⚠️ MAP WATERFALL DETECTED (N+1 Pattern)
+// ${count} useOsdkObject calls for ${objectType} - each triggers separate fetch!
+
+// Problem: Loads ${count} items sequentially instead of one batch request
+// Timeline (Example):
+//   ━━ Item 1 (t0-t100ms)
+//   ━━ Item 2 (t100-t200ms)
+//   ━━ Item 3 (t200-t300ms)
+// Total: 300ms for 3 items
+
+// Solution: Use useOsdkObjects for batch loading
+
+// Before (❌ N+1 pattern):
+{items.map(item => (
+  <Item key={item.id} itemId={item.id} />
+))}
+
+// In Item component:
+function Item({ itemId }) {
+  const { object } = useOsdkObject(${objectType}, itemId); // ❌ Runs ${count} times!
+  return <div>{object.name}</div>;
+}
+
+// After (✅ Batch query):
+function ItemList({ items }) {
+  const itemIds = items.map(item => item.id);
+  const { data } = useOsdkObjects(${objectType}, {
+    where: { id: { $in: itemIds } }  // ✅ Single query!
+  });
+
+  return items.map(item => (
+    <Item key={item.id} data={data} />
+  ));
+}
+
+function Item({ data }) {
+  // Just receive data as prop - no query needed!
+  return <div>{data.name}</div>;
+}
+
+// Result: 1 batch request instead of ${count} individual requests
+// Time saved: ~${(count - 1) * 100}ms
+    `.trim();
+  }
+}
+//# sourceMappingURL=WaterfallDetector.js.map

package/build/esm/utils/WaterfallDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaterfallDetector.js","names":["WaterfallDetector","constructor","registry","timeline","detectWaterfalls","timingThresholdMs","waterfalls","push","detectLinkWaterfalls","detectMapWaterfalls","detectSequentialPatterns","sort","a","b","timeSaved","emissions","getEventsByType","linkTraversals","i","length","emissionA","emissionB","timeBetween","timestamp","linkInWindow","find","link","estimatedFetchTime","type","priority","suggestion","linkName","code","generateLinkWaterfallCode","subscriptionId","details","parentQuery","childQuery","components","getActiveComponents","componentId","bindings","objectQueries","filter","hookType","grouped","Map","query","queryParams","key","objectType","has","set","group","get","queries","getComponentBindings","binding","undefined","generateMapWaterfallCode","component","componentName","count","sequenceLength","totalTime","trim"],"sources":["WaterfallDetector.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ComponentHookBinding,\n  ComponentQueryRegistry,\n} from \"./ComponentQueryRegistry.js\";\nimport type { EventTimeline } from \"./EventTimeline.js\";\n\nexport type WaterfallType =\n  | \"LINK_WATERFALL\"\n  | \"MAP_WATERFALL\"\n  | \"SEQUENTIAL_WATERFALL\";\n\nexport interface Waterfall {\n  type: WaterfallType;\n  priority: \"high\" | \"medium\" | \"low\";\n  timeSaved: number; // ms that could be saved\n  suggestion: string;\n  code: string;\n  details: {\n    parentQuery?: string;\n    childQuery?: string;\n    component?: string;\n    count?: number;\n    objectType?: string;\n  };\n}\n\nexport class WaterfallDetector {\n  constructor(\n    private registry: ComponentQueryRegistry,\n    private timeline: EventTimeline,\n  ) {}\n\n  detectWaterfalls(timingThresholdMs: number = 50): Waterfall[] {\n    const waterfalls: Waterfall[] = [];\n\n    waterfalls.push(...this.detectLinkWaterfalls(timingThresholdMs));\n    waterfalls.push(...this.detectMapWaterfalls());\n    waterfalls.push(...this.detectSequentialPatterns(timingThresholdMs));\n\n    return waterfalls.sort((a, b) => b.timeSaved - a.timeSaved);\n  }\n\n  private detectLinkWaterfalls(timingThresholdMs: number): Waterfall[] {\n    const waterfalls: Waterfall[] = [];\n\n    const emissions = this.timeline.getEventsByType(\"EMISSION\");\n    const linkTraversals = this.timeline.getEventsByType(\"LINK_TRAVERSAL\");\n\n    for (let i = 0; i < emissions.length - 1; i++) {\n      const emissionA = emissions[i];\n      const emissionB = emissions[i + 1];\n\n      const timeBetween = emissionB.timestamp - emissionA.timestamp;\n      if (timeBetween > 0 && timeBetween < timingThresholdMs) {\n        const linkInWindow = linkTraversals.find(link =>\n          link.timestamp > emissionA.timestamp\n          && link.timestamp < emissionB.timestamp\n        );\n\n        if (linkInWindow) {\n          const estimatedFetchTime = emissionB.timestamp - emissionA.timestamp;\n\n          waterfalls.push({\n            type: \"LINK_WATERFALL\",\n            priority: estimatedFetchTime > 200 ? \"high\" : \"medium\",\n            timeSaved: estimatedFetchTime,\n            suggestion:\n              `Prefetch the \"${linkInWindow.linkName}\" relationship to run queries in parallel`,\n            code: this.generateLinkWaterfallCode(\n              emissionA.subscriptionId,\n              emissionB.subscriptionId,\n              linkInWindow.linkName,\n            ),\n            details: {\n              parentQuery: emissionA.subscriptionId,\n              childQuery: emissionB.subscriptionId,\n            },\n          });\n        }\n      }\n    }\n\n    return waterfalls;\n  }\n\n  private detectMapWaterfalls(): Waterfall[] {\n    const waterfalls: Waterfall[] = [];\n    const components = this.registry.getActiveComponents();\n\n    for (const [componentId, bindings] of components) {\n      const objectQueries = bindings.filter(b =>\n        b.hookType === \"useOsdkObject\"\n      );\n      const grouped = new Map<string, ComponentHookBinding[]>();\n\n      for (const query of objectQueries) {\n        if (query.queryParams.type === \"object\") {\n          const key = query.queryParams.objectType;\n          if (!grouped.has(key)) {\n            grouped.set(key, []);\n          }\n          const group = grouped.get(key);\n          if (group) {\n            group.push(query);\n          }\n        }\n      }\n\n      for (const [objectType, queries] of grouped) {\n        if (queries.length > 3) {\n          const bindings = this.registry.getComponentBindings(componentId);\n          const binding = bindings.length > 0 ? bindings[0] : undefined;\n\n          waterfalls.push({\n            type: \"MAP_WATERFALL\",\n            priority: queries.length > 10 ? \"high\" : \"medium\",\n            timeSaved: queries.length * 100, // Rough estimate\n            suggestion:\n              `Replace ${queries.length} useOsdkObject calls with single useOsdkObjects batch query`,\n            code: this.generateMapWaterfallCode(objectType, queries.length),\n            details: {\n              component: binding ? binding.componentName : undefined,\n              count: queries.length,\n              objectType,\n            },\n          });\n        }\n      }\n    }\n\n    return waterfalls;\n  }\n\n  private detectSequentialPatterns(timingThresholdMs: number): Waterfall[] {\n    const waterfalls: Waterfall[] = [];\n    const emissions = this.timeline.getEventsByType(\"EMISSION\");\n\n    let sequenceStart = 0;\n    let sequenceLength = 1;\n    let totalTime = 0;\n\n    for (let i = 1; i < emissions.length; i++) {\n      const timeBetween = emissions[i].timestamp - emissions[i - 1].timestamp;\n\n      if (timeBetween < timingThresholdMs) {\n        sequenceLength++;\n        totalTime += timeBetween;\n      } else {\n        if (sequenceLength > 3 && totalTime > 300) {\n          waterfalls.push({\n            type: \"SEQUENTIAL_WATERFALL\",\n            priority: totalTime > 500 ? \"high\" : \"medium\",\n            timeSaved: totalTime,\n            suggestion:\n              \"Consider parallelizing these queries or prefetching data\",\n            code:\n              \"// Analyze the queries in this sequence and look for prefetching opportunities\",\n            details: {},\n          });\n        }\n\n        sequenceStart = i;\n        sequenceLength = 1;\n        totalTime = 0;\n      }\n    }\n\n    return waterfalls;\n  }\n\n  private generateLinkWaterfallCode(\n    parentQuery: string,\n    childQuery: string,\n    linkName: string,\n  ): string {\n    return `\n// ⚠️ WATERFALL DETECTED\n// ${parentQuery} loads → triggers ${childQuery} (linked via \"${linkName}\")\n\n// Problem: Sequential loading adds latency\n// Timeline:\n//   ━━━━ Parent query (t0-t200ms)\n//        ↓ gap\n//        ━━━━ Child/link query (t210-t260ms)\n// Total: 260ms\n\n// This is a known sequential pattern with useOsdkObject + useLinks.\n// The link query cannot start until the parent object is loaded.\n\n// Current pattern:\nconst { object: parent } = useOsdkObject(ParentType, id);\nconst { links } = useLinks(parent, \"${linkName}\");\n\n// Option 1: If you have the linked IDs available upfront, load in parallel:\nconst [parentResult, childResult] = await Promise.all([\n  useOsdkObject(ParentType, parentId),\n  useOsdkObjects(ChildType, { where: { id: { $in: knownChildIds } } }),\n]);\n\n// Option 2: If data permits, restructure to load the parent object\n// at a higher level so the link query starts sooner.\n    `.trim();\n  }\n\n  private generateMapWaterfallCode(objectType: string, count: number): string {\n    return `\n// ⚠️ MAP WATERFALL DETECTED (N+1 Pattern)\n// ${count} useOsdkObject calls for ${objectType} - each triggers separate fetch!\n\n// Problem: Loads ${count} items sequentially instead of one batch request\n// Timeline (Example):\n//   ━━ Item 1 (t0-t100ms)\n//   ━━ Item 2 (t100-t200ms)\n//   ━━ Item 3 (t200-t300ms)\n// Total: 300ms for 3 items\n\n// Solution: Use useOsdkObjects for batch loading\n\n// Before (❌ N+1 pattern):\n{items.map(item => (\n  <Item key={item.id} itemId={item.id} />\n))}\n\n// In Item component:\nfunction Item({ itemId }) {\n  const { object } = useOsdkObject(${objectType}, itemId); // ❌ Runs ${count} times!\n  return <div>{object.name}</div>;\n}\n\n// After (✅ Batch query):\nfunction ItemList({ items }) {\n  const itemIds = items.map(item => item.id);\n  const { data } = useOsdkObjects(${objectType}, {\n    where: { id: { $in: itemIds } }  // ✅ Single query!\n  });\n\n  return items.map(item => (\n    <Item key={item.id} data={data} />\n  ));\n}\n\nfunction Item({ data }) {\n  // Just receive data as prop - no query needed!\n  return <div>{data.name}</div>;\n}\n\n// Result: 1 batch request instead of ${count} individual requests\n// Time saved: ~${(count - 1) * 100}ms\n    `.trim();\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/utils/computePayload.js

@@ -0,0 +1,37 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const MAX_PAYLOAD_LENGTH = 10000;
+export function stringifyPayload(payload) {
+  return JSON.stringify(payload);
+}
+export function truncatePayload(payload) {
+  if (payload.length <= MAX_PAYLOAD_LENGTH) {
+    return payload;
+  }
+  return payload.substring(0, MAX_PAYLOAD_LENGTH) + "...";
+}
+export function hashPayload(payload) {
+  const str = stringifyPayload(payload);
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash = hash & hash;
+  }
+  return hash;
+}
+//# sourceMappingURL=computePayload.js.map

package/build/esm/utils/computePayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computePayload.js","names":["MAX_PAYLOAD_LENGTH","stringifyPayload","payload","JSON","stringify","truncatePayload","length","substring","hashPayload","str","hash","i","char","charCodeAt"],"sources":["computePayload.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nconst MAX_PAYLOAD_LENGTH = 10000;\n\nexport function stringifyPayload(payload: unknown): string {\n  return JSON.stringify(payload);\n}\n\nexport function truncatePayload(payload: string): string {\n  if (payload.length <= MAX_PAYLOAD_LENGTH) {\n    return payload;\n  }\n  return payload.substring(0, MAX_PAYLOAD_LENGTH) + \"...\";\n}\n\nexport function hashPayload(payload: unknown): number {\n  const str = stringifyPayload(payload);\n  let hash = 0;\n  for (let i = 0; i < str.length; i++) {\n    const char = str.charCodeAt(i);\n    hash = (hash << 5) - hash + char;\n    hash = hash & hash;\n  }\n  return hash;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,kBAAkB,GAAG,KAAK;AAEhC,OAAO,SAASC,gBAAgBA,CAACC,OAAgB,EAAU;EACzD,OAAOC,IAAI,CAACC,SAAS,CAACF,OAAO,CAAC;AAChC;AAEA,OAAO,SAASG,eAAeA,CAACH,OAAe,EAAU;EACvD,IAAIA,OAAO,CAACI,MAAM,IAAIN,kBAAkB,EAAE;IACxC,OAAOE,OAAO;EAChB;EACA,OAAOA,OAAO,CAACK,SAAS,CAAC,CAAC,EAAEP,kBAAkB,CAAC,GAAG,KAAK;AACzD;AAEA,OAAO,SAASQ,WAAWA,CAACN,OAAgB,EAAU;EACpD,MAAMO,GAAG,GAAGR,gBAAgB,CAACC,OAAO,CAAC;EACrC,IAAIQ,IAAI,GAAG,CAAC;EACZ,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGF,GAAG,CAACH,MAAM,EAAEK,CAAC,EAAE,EAAE;IACnC,MAAMC,IAAI,GAAGH,GAAG,CAACI,UAAU,CAACF,CAAC,CAAC;IAC9BD,IAAI,GAAG,CAACA,IAAI,IAAI,CAAC,IAAIA,IAAI,GAAGE,IAAI;IAChCF,IAAI,GAAGA,IAAI,GAAGA,IAAI;EACpB;EACA,OAAOA,IAAI;AACb","ignoreList":[]}

package/build/esm/utils/computeRequest.js

@@ -0,0 +1,29 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export const visitComputeRequest = (request, visitor) => {
+  if (request.type === "pending") {
+    return visitor.pending(request);
+  }
+  if (request.type === "failed") {
+    return visitor.failed(request);
+  }
+  if (request.type === "fulfilled-without-usage") {
+    return visitor.fulfilledWithoutUsage(request);
+  }
+  return visitor.fulfilled(request);
+};
+//# sourceMappingURL=computeRequest.js.map

package/build/esm/utils/computeRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeRequest.js","names":["visitComputeRequest","request","visitor","type","pending","failed","fulfilledWithoutUsage","fulfilled"],"sources":["computeRequest.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ComputeRequest } from \"../types/compute.js\";\n\ntype FulfilledComputeRequest = Extract<\n  ComputeRequest,\n  { type: \"fulfilled\" }\n>;\ntype FulfilledWithoutUsageComputeRequest = Extract<\n  ComputeRequest,\n  { type: \"fulfilled-without-usage\" }\n>;\ntype PendingComputeRequest = Extract<\n  ComputeRequest,\n  { type: \"pending\" }\n>;\ntype FailedComputeRequest = Extract<ComputeRequest, { type: \"failed\" }>;\n\nexport const visitComputeRequest = <T>(\n  request: ComputeRequest,\n  visitor: {\n    pending: (request: PendingComputeRequest) => T;\n    failed: (request: FailedComputeRequest) => T;\n    fulfilled: (request: FulfilledComputeRequest) => T;\n    fulfilledWithoutUsage: (request: FulfilledWithoutUsageComputeRequest) => T;\n  },\n): T => {\n  if (request.type === \"pending\") {\n    return visitor.pending(request);\n  }\n\n  if (request.type === \"failed\") {\n    return visitor.failed(request);\n  }\n\n  if (request.type === \"fulfilled-without-usage\") {\n    return visitor.fulfilledWithoutUsage(request);\n  }\n\n  return visitor.fulfilled(request);\n};\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAkBA,OAAO,MAAMA,mBAAmB,GAAGA,CACjCC,OAAuB,EACvBC,OAKC,KACK;EACN,IAAID,OAAO,CAACE,IAAI,KAAK,SAAS,EAAE;IAC9B,OAAOD,OAAO,CAACE,OAAO,CAACH,OAAO,CAAC;EACjC;EAEA,IAAIA,OAAO,CAACE,IAAI,KAAK,QAAQ,EAAE;IAC7B,OAAOD,OAAO,CAACG,MAAM,CAACJ,OAAO,CAAC;EAChC;EAEA,IAAIA,OAAO,CAACE,IAAI,KAAK,yBAAyB,EAAE;IAC9C,OAAOD,OAAO,CAACI,qBAAqB,CAACL,OAAO,CAAC;EAC/C;EAEA,OAAOC,OAAO,CAACK,SAAS,CAACN,OAAO,CAAC;AACnC,CAAC","ignoreList":[]}

package/build/esm/utils/format.js

@@ -0,0 +1,69 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export function formatTime(ms) {
+  if (ms < 1) {
+    return "<1ms";
+  }
+  if (ms < 1000) {
+    return `${ms.toFixed(0)}ms`;
+  }
+  return `${(ms / 1000).toFixed(1)}s`;
+}
+export function formatNumber(num) {
+  if (num >= 1000000) {
+    return `${(num / 1000000).toFixed(1)}M`;
+  }
+  if (num >= 1000) {
+    return `${(num / 1000).toFixed(1)}K`;
+  }
+  return num.toFixed(0);
+}
+export function formatBytes(bytes) {
+  if (bytes < 1024) {
+    return `${bytes}B`;
+  }
+  if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(1)}KB`;
+  }
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+export function formatRelativeTime(timestamp) {
+  const diff = Date.now() - timestamp;
+  if (diff < 1000) {
+    return "just now";
+  }
+  if (diff < 60000) {
+    return `${Math.floor(diff / 1000)}s ago`;
+  }
+  if (diff < 3600000) {
+    return `${Math.floor(diff / 60000)}m ago`;
+  }
+  return `${Math.floor(diff / 3600000)}h ago`;
+}
+export const formatMilliseconds = (value, includeSpace) => {
+  const space = includeSpace ? " " : "";
+  if (value < 1000) {
+    return `${value}${space}ms`;
+  }
+  if (value < 60 * 1000) {
+    const seconds = value / 1000;
+    return seconds % 1 === 0 ? `${seconds}${space}s` : `${seconds.toFixed(1)}${space}s`;
+  }
+  const minutes = value / 60_000;
+  return minutes % 1 === 0 ? `${minutes}${space}m` : `${minutes.toFixed(1)}${space}m`;
+};
+//# sourceMappingURL=format.js.map

package/build/esm/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","names":["formatTime","ms","toFixed","formatNumber","num","formatBytes","bytes","formatRelativeTime","timestamp","diff","Date","now","Math","floor","formatMilliseconds","value","includeSpace","space","seconds","minutes"],"sources":["format.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function formatTime(ms: number): string {\n  if (ms < 1) {\n    return \"<1ms\";\n  }\n  if (ms < 1000) {\n    return `${ms.toFixed(0)}ms`;\n  }\n  return `${(ms / 1000).toFixed(1)}s`;\n}\n\nexport function formatNumber(num: number): string {\n  if (num >= 1000000) {\n    return `${(num / 1000000).toFixed(1)}M`;\n  }\n  if (num >= 1000) {\n    return `${(num / 1000).toFixed(1)}K`;\n  }\n  return num.toFixed(0);\n}\n\nexport function formatBytes(bytes: number): string {\n  if (bytes < 1024) {\n    return `${bytes}B`;\n  }\n  if (bytes < 1024 * 1024) {\n    return `${(bytes / 1024).toFixed(1)}KB`;\n  }\n  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\n}\n\nexport function formatRelativeTime(timestamp: number): string {\n  const diff = Date.now() - timestamp;\n  if (diff < 1000) {\n    return \"just now\";\n  }\n  if (diff < 60000) {\n    return `${Math.floor(diff / 1000)}s ago`;\n  }\n  if (diff < 3600000) {\n    return `${Math.floor(diff / 60000)}m ago`;\n  }\n  return `${Math.floor(diff / 3600000)}h ago`;\n}\n\nexport const formatMilliseconds = (\n  value: number,\n  includeSpace: boolean,\n): string => {\n  const space = includeSpace ? \" \" : \"\";\n  if (value < 1000) {\n    return `${value}${space}ms`;\n  }\n\n  if (value < 60 * 1000) {\n    const seconds = value / 1000;\n    return seconds % 1 === 0\n      ? `${seconds}${space}s`\n      : `${seconds.toFixed(1)}${space}s`;\n  }\n\n  const minutes = value / 60_000;\n  return minutes % 1 === 0\n    ? `${minutes}${space}m`\n    : `${minutes.toFixed(1)}${space}m`;\n};\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASA,UAAUA,CAACC,EAAU,EAAU;EAC7C,IAAIA,EAAE,GAAG,CAAC,EAAE;IACV,OAAO,MAAM;EACf;EACA,IAAIA,EAAE,GAAG,IAAI,EAAE;IACb,OAAO,GAAGA,EAAE,CAACC,OAAO,CAAC,CAAC,CAAC,IAAI;EAC7B;EACA,OAAO,GAAG,CAACD,EAAE,GAAG,IAAI,EAAEC,OAAO,CAAC,CAAC,CAAC,GAAG;AACrC;AAEA,OAAO,SAASC,YAAYA,CAACC,GAAW,EAAU;EAChD,IAAIA,GAAG,IAAI,OAAO,EAAE;IAClB,OAAO,GAAG,CAACA,GAAG,GAAG,OAAO,EAAEF,OAAO,CAAC,CAAC,CAAC,GAAG;EACzC;EACA,IAAIE,GAAG,IAAI,IAAI,EAAE;IACf,OAAO,GAAG,CAACA,GAAG,GAAG,IAAI,EAAEF,OAAO,CAAC,CAAC,CAAC,GAAG;EACtC;EACA,OAAOE,GAAG,CAACF,OAAO,CAAC,CAAC,CAAC;AACvB;AAEA,OAAO,SAASG,WAAWA,CAACC,KAAa,EAAU;EACjD,IAAIA,KAAK,GAAG,IAAI,EAAE;IAChB,OAAO,GAAGA,KAAK,GAAG;EACpB;EACA,IAAIA,KAAK,GAAG,IAAI,GAAG,IAAI,EAAE;IACvB,OAAO,GAAG,CAACA,KAAK,GAAG,IAAI,EAAEJ,OAAO,CAAC,CAAC,CAAC,IAAI;EACzC;EACA,OAAO,GAAG,CAACI,KAAK,IAAI,IAAI,GAAG,IAAI,CAAC,EAAEJ,OAAO,CAAC,CAAC,CAAC,IAAI;AAClD;AAEA,OAAO,SAASK,kBAAkBA,CAACC,SAAiB,EAAU;EAC5D,MAAMC,IAAI,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGH,SAAS;EACnC,IAAIC,IAAI,GAAG,IAAI,EAAE;IACf,OAAO,UAAU;EACnB;EACA,IAAIA,IAAI,GAAG,KAAK,EAAE;IAChB,OAAO,GAAGG,IAAI,CAACC,KAAK,CAACJ,IAAI,GAAG,IAAI,CAAC,OAAO;EAC1C;EACA,IAAIA,IAAI,GAAG,OAAO,EAAE;IAClB,OAAO,GAAGG,IAAI,CAACC,KAAK,CAACJ,IAAI,GAAG,KAAK,CAAC,OAAO;EAC3C;EACA,OAAO,GAAGG,IAAI,CAACC,KAAK,CAACJ,IAAI,GAAG,OAAO,CAAC,OAAO;AAC7C;AAEA,OAAO,MAAMK,kBAAkB,GAAGA,CAChCC,KAAa,EACbC,YAAqB,KACV;EACX,MAAMC,KAAK,GAAGD,YAAY,GAAG,GAAG,GAAG,EAAE;EACrC,IAAID,KAAK,GAAG,IAAI,EAAE;IAChB,OAAO,GAAGA,KAAK,GAAGE,KAAK,IAAI;EAC7B;EAEA,IAAIF,KAAK,GAAG,EAAE,GAAG,IAAI,EAAE;IACrB,MAAMG,OAAO,GAAGH,KAAK,GAAG,IAAI;IAC5B,OAAOG,OAAO,GAAG,CAAC,KAAK,CAAC,GACpB,GAAGA,OAAO,GAAGD,KAAK,GAAG,GACrB,GAAGC,OAAO,CAAChB,OAAO,CAAC,CAAC,CAAC,GAAGe,KAAK,GAAG;EACtC;EAEA,MAAME,OAAO,GAAGJ,KAAK,GAAG,MAAM;EAC9B,OAAOI,OAAO,GAAG,CAAC,KAAK,CAAC,GACpB,GAAGA,OAAO,GAAGF,KAAK,GAAG,GACrB,GAAGE,OAAO,CAACjB,OAAO,CAAC,CAAC,CAAC,GAAGe,KAAK,GAAG;AACtC,CAAC","ignoreList":[]}

package/build/esm/utils/logger.js

@@ -0,0 +1,31 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const noop = () => {};
+const noopLogger = {
+  trace: noop,
+  debug: noop,
+  info: noop,
+  warn: noop,
+  error: noop,
+  fatal: noop,
+  isLevelEnabled: () => false,
+  child: () => noopLogger
+};
+export function createMonitorLogger() {
+  return noopLogger;
+}
+//# sourceMappingURL=logger.js.map

package/build/esm/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":["noop","noopLogger","trace","debug","info","warn","error","fatal","isLevelEnabled","child","createMonitorLogger"],"sources":["logger.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Logger } from \"@osdk/api\";\n\nconst noop = () => {};\n\nconst noopLogger: Logger = {\n  trace: noop,\n  debug: noop,\n  info: noop,\n  warn: noop,\n  error: noop,\n  fatal: noop,\n  isLevelEnabled: () => false,\n  child: () => noopLogger,\n};\n\nexport function createMonitorLogger(_prefix?: string): Logger {\n  return noopLogger;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMA,IAAI,GAAGA,CAAA,KAAM,CAAC,CAAC;AAErB,MAAMC,UAAkB,GAAG;EACzBC,KAAK,EAAEF,IAAI;EACXG,KAAK,EAAEH,IAAI;EACXI,IAAI,EAAEJ,IAAI;EACVK,IAAI,EAAEL,IAAI;EACVM,KAAK,EAAEN,IAAI;EACXO,KAAK,EAAEP,IAAI;EACXQ,cAAc,EAAEA,CAAA,KAAM,KAAK;EAC3BC,KAAK,EAAEA,CAAA,KAAMR;AACf,CAAC;AAED,OAAO,SAASS,mBAAmBA,CAAA,EAA2B;EAC5D,OAAOT,UAAU;AACnB","ignoreList":[]}

package/build/esm/vite/constants.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export const PLUGIN_NAME = "osdk-devtools";
+//# sourceMappingURL=constants.js.map

package/build/esm/vite/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":["PLUGIN_NAME"],"sources":["constants.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport const PLUGIN_NAME = \"osdk-devtools\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,MAAMA,WAAW,GAAG,eAAe","ignoreList":[]}

package/build/esm/vite/hookInstaller.js

@@ -0,0 +1,99 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export function generateHookInstallationScript(verbose = false) {
+  return `
+<script type="module">
+  // OSDK DevTools Hook Installer
+  // This script installs __REACT_DEVTOOLS_GLOBAL_HOOK__ before React initializes
+
+  (function installOsdkDevToolsHook() {
+    // Check if we're in a browser environment
+    if (typeof window === 'undefined') {
+      return;
+    }
+
+    // If hook already exists (React DevTools extension), cooperate with it
+    if (window.__REACT_DEVTOOLS_GLOBAL_HOOK__) {
+      ${verbose ? `console.log('[OSDK DevTools] Hook already exists (browser extension detected)');` : ""}
+      return;
+    }
+
+    // Store fiber roots per renderer ID
+    const fiberRootsByRenderer = new Map();
+    // Renderer registry (closure-scoped so inject() does not depend on \`this\`)
+    const renderers = new Map();
+
+    // Install our hook
+    window.__REACT_DEVTOOLS_GLOBAL_HOOK__ = {
+      // Renderer registry (same Map instance as the closure variable)
+      renderers,
+
+      // Indicate we support React Fiber architecture
+      supportsFiber: true,
+
+      // Called by React when a renderer initializes
+      inject(renderer) {
+        const id = renderers.size + 1;
+        renderers.set(id, renderer);
+        fiberRootsByRenderer.set(id, new Set());
+
+        ${verbose ? `
+        console.log('[OSDK DevTools] React renderer injected:', {
+          id,
+          version: renderer.version,
+          package: renderer.rendererPackageName
+        });
+        ` : ""}
+
+        return id;
+      },
+
+      // Called by React after each commit phase
+      onCommitFiberRoot(rendererID, root, priorityLevel) {
+        const roots = fiberRootsByRenderer.get(rendererID);
+        if (roots) {
+          roots.add(root);
+        }
+      },
+
+      // Called by React when a fiber unmounts
+      onCommitFiberUnmount(rendererID, fiber) {
+        // Optional: track unmounts if needed for GC
+      },
+
+      // Custom method: Get roots for specific renderer
+      getFiberRoots(rendererID) {
+        return fiberRootsByRenderer.get(rendererID) || new Set();
+      },
+
+      // Custom method: Get all roots across all renderers
+      getAllFiberRoots() {
+        const allRoots = new Set();
+        for (const roots of fiberRootsByRenderer.values()) {
+          for (const root of roots) {
+            allRoots.add(root);
+          }
+        }
+        return allRoots;
+      }
+    };
+
+    ${verbose ? `console.log('[OSDK DevTools] Hook installed successfully via Vite plugin');` : ""}
+  })();
+</script>`;
+}
+//# sourceMappingURL=hookInstaller.js.map

package/build/esm/vite/hookInstaller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookInstaller.js","names":["generateHookInstallationScript","verbose"],"sources":["hookInstaller.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function generateHookInstallationScript(\n  verbose: boolean = false,\n): string {\n  return `\n<script type=\"module\">\n  // OSDK DevTools Hook Installer\n  // This script installs __REACT_DEVTOOLS_GLOBAL_HOOK__ before React initializes\n\n  (function installOsdkDevToolsHook() {\n    // Check if we're in a browser environment\n    if (typeof window === 'undefined') {\n      return;\n    }\n\n    // If hook already exists (React DevTools extension), cooperate with it\n    if (window.__REACT_DEVTOOLS_GLOBAL_HOOK__) {\n      ${\n    verbose\n      ? `console.log('[OSDK DevTools] Hook already exists (browser extension detected)');`\n      : \"\"\n  }\n      return;\n    }\n\n    // Store fiber roots per renderer ID\n    const fiberRootsByRenderer = new Map();\n    // Renderer registry (closure-scoped so inject() does not depend on \\`this\\`)\n    const renderers = new Map();\n\n    // Install our hook\n    window.__REACT_DEVTOOLS_GLOBAL_HOOK__ = {\n      // Renderer registry (same Map instance as the closure variable)\n      renderers,\n\n      // Indicate we support React Fiber architecture\n      supportsFiber: true,\n\n      // Called by React when a renderer initializes\n      inject(renderer) {\n        const id = renderers.size + 1;\n        renderers.set(id, renderer);\n        fiberRootsByRenderer.set(id, new Set());\n\n        ${\n    verbose\n      ? `\n        console.log('[OSDK DevTools] React renderer injected:', {\n          id,\n          version: renderer.version,\n          package: renderer.rendererPackageName\n        });\n        `\n      : \"\"\n  }\n\n        return id;\n      },\n\n      // Called by React after each commit phase\n      onCommitFiberRoot(rendererID, root, priorityLevel) {\n        const roots = fiberRootsByRenderer.get(rendererID);\n        if (roots) {\n          roots.add(root);\n        }\n      },\n\n      // Called by React when a fiber unmounts\n      onCommitFiberUnmount(rendererID, fiber) {\n        // Optional: track unmounts if needed for GC\n      },\n\n      // Custom method: Get roots for specific renderer\n      getFiberRoots(rendererID) {\n        return fiberRootsByRenderer.get(rendererID) || new Set();\n      },\n\n      // Custom method: Get all roots across all renderers\n      getAllFiberRoots() {\n        const allRoots = new Set();\n        for (const roots of fiberRootsByRenderer.values()) {\n          for (const root of roots) {\n            allRoots.add(root);\n          }\n        }\n        return allRoots;\n      }\n    };\n\n    ${\n    verbose\n      ? `console.log('[OSDK DevTools] Hook installed successfully via Vite plugin');`\n      : \"\"\n  }\n  })();\n</script>`;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASA,8BAA8BA,CAC5CC,OAAgB,GAAG,KAAK,EAChB;EACR,OAAO;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,QACIA,OAAO,GACH,kFAAkF,GAClF,EAAE;AACV;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAEIA,OAAO,GACH;AACR;AACA;AACA;AACA;AACA;AACA,SAAS,GACD,EAAE;AACV;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAEIA,OAAO,GACH,6EAA6E,GAC7E,EAAE;AACV;AACA,UACU;AACV","ignoreList":[]}

package/build/esm/vite/index.js

@@ -0,0 +1,77 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { dirname, resolve as resolvePath } from "node:path";
+import { fileURLToPath } from "node:url";
+import { PLUGIN_NAME } from "./constants.js";
+import { generateHookInstallationScript } from "./hookInstaller.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CSS_PATH = resolvePath(__dirname, "../styles.css");
+export function osdkDevTools(options = {}) {
+  const {
+    enabled = process.env.NODE_ENV !== "production",
+    verbose = false,
+    injectCSS = true
+  } = options;
+  return {
+    name: PLUGIN_NAME,
+    enforce: "pre",
+    apply(config, {
+      command
+    }) {
+      if (config.mode === "production") {
+        return false;
+      }
+      if (process.env.VITEST) {
+        return false;
+      }
+      if (!enabled) {
+        return false;
+      }
+      return command === "serve";
+    },
+    transformIndexHtml: {
+      order: "pre",
+      handler(html) {
+        if (!enabled) return html;
+        const hookScript = generateHookInstallationScript(verbose);
+        let cssTag = "";
+        if (injectCSS) {
+          cssTag = `\n  <link rel="stylesheet" href="/@fs${CSS_PATH}" />`;
+        }
+        const injection = `${hookScript}${`\n  <script type="module">import '@osdk/react-devtools';</script>`}${cssTag}\n`;
+        let transformed = html.replace("</head>", `${injection}</head>`);
+        if (transformed === html) {
+          transformed = html.replace("</body>", `${injection}</body>`);
+        }
+        if (transformed !== html) {
+          if (verbose) {
+            // eslint-disable-next-line no-console
+            console.log(`[${PLUGIN_NAME}] Injected devtools into HTML`);
+          }
+        } else if (verbose) {
+          // eslint-disable-next-line no-console
+          console.log(`[${PLUGIN_NAME}] Warning: Could not find </head> or </body> tag for injection`);
+        }
+        return transformed;
+      }
+    }
+  };
+}
+
+// Default export for convenience
+export default osdkDevTools;
+//# sourceMappingURL=index.js.map