@scalebun-release/protocol 2.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ScaleBun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @scalebun/protocol — Barrel Export
+ *
+ * Versioned Zod wire schemas for the ScaleBun UNIFIED INGESTION PROTOCOL. This is the one contract
+ * every platform speaks (web today; RN, Flutter, native next) and the backend validates against.
+ * Runtime Zod schemas live here; pure TS-only types live in @scalebun/sdk-contracts.
+ */
+export * from './internal/enums.js';
+export * from './internal/frames.js';
+export * from './internal/items.js';
+export * from './internal/envelope.js';
+export * from './internal/validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @scalebun/protocol — Barrel Export
+ *
+ * Versioned Zod wire schemas for the ScaleBun UNIFIED INGESTION PROTOCOL. This is the one contract
+ * every platform speaks (web today; RN, Flutter, native next) and the backend validates against.
+ * Runtime Zod schemas live here; pure TS-only types live in @scalebun/sdk-contracts.
+ */
+export * from './internal/enums.js';
+export * from './internal/frames.js';
+export * from './internal/items.js';
+export * from './internal/envelope.js';
+export * from './internal/validation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}

package/dist/internal/enums.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+/**
+ * `platform` is an OPEN enum on purpose. The whole point of the unified protocol is that a future
+ * Flutter / native client "just works" without a backend change — so the wire type is a plain
+ * string, and we publish the known values for tooling/UI. Never make this a closed z.enum().
+ */
+export declare const KNOWN_PLATFORMS: readonly ["web", "ios", "android", "react-native", "flutter"];
+export type KnownPlatform = (typeof KNOWN_PLATFORMS)[number];
+export declare const PlatformSchema: z.ZodString;
+export type Platform = z.infer<typeof PlatformSchema>;
+/**
+ * The capture model. The ONLY axis on which platforms structurally diverge — it discriminates the
+ * shape of a replay `frame` (see frames.ts). Closed enum: adding a renderer is a deliberate change
+ * because the dashboard player must learn to render it.
+ */
+export declare const RendererSchema: z.ZodEnum<["dom", "screenshot", "view-hierarchy", "canvas"]>;
+export type Renderer = z.infer<typeof RendererSchema>;
+/** Item discriminator. Each maps to one backend handler/table. */
+export declare const ItemKindSchema: z.ZodEnum<["error", "network", "performance", "frame", "event", "rating", "log", "identify"]>;
+export type ItemKind = z.infer<typeof ItemKindSchema>;
+/** Timestamps are epoch-ms OR ISO string on the wire (every SDK historically sent both). */
+export declare const TimestampSchema: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+//# sourceMappingURL=enums.d.ts.map

package/dist/internal/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/internal/enums.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,eAAe,+DAAgE,CAAC;AAC7F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,cAAc,aAAoB,CAAC;AAChD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,cAAc,8DAA4D,CAAC;AACxF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,kEAAkE;AAClE,eAAO,MAAM,cAAc,+FASzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,4FAA4F;AAC5F,eAAO,MAAM,eAAe,wCAAoC,CAAC"}

package/dist/internal/enums.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+/**
+ * `platform` is an OPEN enum on purpose. The whole point of the unified protocol is that a future
+ * Flutter / native client "just works" without a backend change — so the wire type is a plain
+ * string, and we publish the known values for tooling/UI. Never make this a closed z.enum().
+ */
+export const KNOWN_PLATFORMS = ['web', 'ios', 'android', 'react-native', 'flutter'];
+export const PlatformSchema = z.string().min(1);
+/**
+ * The capture model. The ONLY axis on which platforms structurally diverge — it discriminates the
+ * shape of a replay `frame` (see frames.ts). Closed enum: adding a renderer is a deliberate change
+ * because the dashboard player must learn to render it.
+ */
+export const RendererSchema = z.enum(['dom', 'screenshot', 'view-hierarchy', 'canvas']);
+/** Item discriminator. Each maps to one backend handler/table. */
+export const ItemKindSchema = z.enum([
+    'error',
+    'network',
+    'performance',
+    'frame',
+    'event',
+    'rating',
+    'log',
+    'identify',
+]);
+/** Timestamps are epoch-ms OR ISO string on the wire (every SDK historically sent both). */
+export const TimestampSchema = z.union([z.number(), z.string()]);
+//# sourceMappingURL=enums.js.map

package/dist/internal/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/internal/enums.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,CAAU,CAAC;AAG7F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGxF,kEAAkE;AAClE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,OAAO;IACP,SAAS;IACT,aAAa;IACb,OAAO;IACP,OAAO;IACP,QAAQ;IACR,KAAK;IACL,UAAU;CACX,CAAC,CAAC;AAGH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC"}