@tensnap/protocol 0.2.0

package/dist/schemas.js

@@ -0,0 +1,435 @@
+// src/schemas.ts
+import { z as z4 } from "zod";
+
+// src/asset.ts
+import { z } from "zod";
+var AssetIdSchema = z.string();
+var AssetMetaSchema = z.object({
+  id: AssetIdSchema,
+  hash: z.string(),
+  mime: z.string(),
+  size: z.number(),
+  label: z.string().optional()
+});
+
+// src/chart.ts
+import { z as z2 } from "zod";
+var ChartMetadataSchema = z2.object({
+  id: z2.string(),
+  label: z2.string(),
+  color: z2.string().optional()
+});
+var ChartGroupMetadataSchema = ChartMetadataSchema.extend({
+  dataList: z2.array(ChartMetadataSchema).optional()
+});
+var ChartUpdateDataSchema = z2.object({
+  id: z2.string(),
+  time: z2.number().optional(),
+  value: z2.unknown()
+});
+var ChartUpdateOperationSchema = z2.object({
+  id: z2.string(),
+  operation: z2.literal("clear")
+});
+
+// src/controls.ts
+import { z as z3 } from "zod";
+var ParameterTypeSchema = z3.enum(["number", "enum", "boolean", "string"]);
+var ParameterBaseSchema = z3.object({
+  id: z3.string(),
+  type: ParameterTypeSchema,
+  label: z3.string(),
+  allowRuntimeChange: z3.boolean().optional()
+});
+var NumberParameterSchema = ParameterBaseSchema.extend({
+  type: z3.literal("number"),
+  value: z3.number(),
+  min: z3.number().optional(),
+  max: z3.number().optional(),
+  step: z3.number().optional()
+});
+var EnumParameterSchema = ParameterBaseSchema.extend({
+  type: z3.literal("enum"),
+  value: z3.string(),
+  options: z3.array(z3.string()),
+  labels: z3.record(z3.string(), z3.string()).optional()
+});
+var BooleanParameterSchema = ParameterBaseSchema.extend({
+  type: z3.literal("boolean"),
+  value: z3.boolean()
+});
+var StringParameterSchema = ParameterBaseSchema.extend({
+  type: z3.literal("string"),
+  value: z3.string()
+});
+var ParameterSchema = z3.union([
+  NumberParameterSchema,
+  EnumParameterSchema,
+  BooleanParameterSchema,
+  StringParameterSchema
+]);
+var ActionSchema = z3.object({
+  id: z3.string(),
+  label: z3.string(),
+  continuous: z3.boolean().optional(),
+  allowRuntimeChange: z3.boolean().optional()
+});
+
+// src/binary.ts
+var BASE64_DATA_URL_MARKER = ";base64,";
+function getGlobalBuffer() {
+  return globalThis.Buffer;
+}
+function isEncodedBinaryString(value) {
+  return tryDecodeBinaryString(value) !== null;
+}
+function tryDecodeBinaryString(value) {
+  if (value.startsWith("data:")) {
+    const dataUrl = tryDecodeBase64DataUrl(value);
+    if (dataUrl) {
+      return dataUrl;
+    }
+  }
+  const bytes = tryDecodeBase64(value);
+  if (!bytes) {
+    return null;
+  }
+  return {
+    bytes,
+    encoding: "base64"
+  };
+}
+function tryDecodeBase64DataUrl(value) {
+  const markerIndex = value.indexOf(BASE64_DATA_URL_MARKER);
+  if (markerIndex === -1) {
+    return null;
+  }
+  const mime = value.slice(5, markerIndex) || void 0;
+  const base64 = value.slice(markerIndex + BASE64_DATA_URL_MARKER.length);
+  const bytes = tryDecodeBase64(base64);
+  if (!bytes) {
+    return null;
+  }
+  return {
+    bytes,
+    mime,
+    encoding: "data-url"
+  };
+}
+function tryDecodeBase64(value) {
+  const normalized = value.replace(/\s+/g, "");
+  if (!normalized || normalized.length % 4 !== 0 || /[^A-Za-z0-9+/=]/.test(normalized)) {
+    return null;
+  }
+  try {
+    const buffer = getGlobalBuffer();
+    if (buffer) {
+      return new Uint8Array(buffer.from(normalized, "base64"));
+    }
+    if (typeof atob === "function") {
+      const binary = atob(normalized);
+      const bytes = new Uint8Array(binary.length);
+      for (let index = 0; index < binary.length; index += 1) {
+        bytes[index] = binary.charCodeAt(index);
+      }
+      return bytes;
+    }
+  } catch {
+    return null;
+  }
+  throw new Error("No base64 decoder is available in this runtime.");
+}
+
+// src/schemas.ts
+var BinaryPayloadStringSchema = z4.string().refine(
+  (value) => isEncodedBinaryString(value),
+  "Expected a base64 string or a base64 data URL for binary payload data."
+);
+var BinaryPayloadDataSchema = z4.union([BinaryPayloadStringSchema, z4.instanceof(Uint8Array)]);
+var ItemSchema = z4.record(z4.string(), z4.unknown());
+var ItemDiffSchema = z4.record(z4.string(), z4.unknown());
+var ItemKeySchema = z4.record(z4.string(), z4.unknown());
+var PrimitiveItemKeySchema = z4.union([z4.string(), z4.number()]);
+var MetadataUpdatePayloadSchema = z4.object({
+  time: z4.number().optional()
+}).loose();
+var StateSyncBoundaryPayloadSchema = z4.object({
+  request_id: z4.string().optional()
+});
+var TickTimingBreakdownSchema = z4.object({
+  simulate_ms: z4.number().nonnegative().optional(),
+  communicate_ms: z4.number().nonnegative().optional(),
+  render_ms: z4.number().nonnegative().optional()
+}).catchall(z4.number().nonnegative());
+var ActionEndPayloadSchema = z4.object({
+  id: z4.string(),
+  tick_id: z4.string().optional(),
+  continue: z4.boolean().optional(),
+  timings: TickTimingBreakdownSchema.optional()
+});
+var ActionDeletePayloadSchema = z4.object({ id: z4.string() });
+var EnvCreatePayloadSchema = z4.object({
+  id: z4.string(),
+  type: z4.enum(["uniform", "2d"])
+});
+var EnvDeletePayloadSchema = z4.object({ id: z4.string() });
+var EnvLayerCreatePayloadSchema = z4.object({
+  env_id: z4.string(),
+  layer_id: z4.string(),
+  layer_type: z4.string(),
+  dependency_layer_ids: z4.record(z4.string(), z4.string()).optional(),
+  data: z4.record(z4.string(), z4.unknown()).optional()
+});
+var EnvLayerUpdatePayloadSchema = z4.object({
+  env_id: z4.string(),
+  layer_id: z4.string(),
+  data: z4.record(z4.string(), z4.unknown())
+});
+var EnvLayerDeletePayloadSchema = z4.object({
+  env_id: z4.string(),
+  layer_id: z4.string()
+});
+var ItemCreatePayloadSchema = z4.object({
+  env_id: z4.string(),
+  layer_id: z4.string(),
+  items: z4.array(ItemSchema)
+});
+var ItemUpdatePayloadSchema = z4.object({
+  env_id: z4.string(),
+  layer_id: z4.string(),
+  items: z4.array(ItemDiffSchema)
+});
+var ItemDeletePayloadSchema = z4.object({
+  env_id: z4.string(),
+  layer_id: z4.string(),
+  items: z4.union([z4.array(PrimitiveItemKeySchema), z4.array(ItemKeySchema)])
+});
+var ParameterDeletePayloadSchema = z4.object({ id: z4.string() });
+var ParameterSyncPayloadSchema = z4.object({
+  id: z4.string(),
+  value: z4.unknown()
+});
+var ChartDeletePayloadSchema = z4.object({ id: z4.string() });
+var ChartUpdatePayloadSchema = z4.object({
+  updates: z4.array(ChartUpdateDataSchema).optional(),
+  operations: z4.array(ChartUpdateOperationSchema).optional()
+});
+var LogLevelSchema = z4.enum(["debug", "info", "warning", "error", "critical"]);
+var LogPayloadSchema = z4.object({
+  message: z4.string(),
+  level: LogLevelSchema.optional(),
+  target: z4.string().optional(),
+  timestamp: z4.number().optional(),
+  data: z4.unknown().optional()
+});
+var ErrorPayloadSchema = z4.object({ error: z4.string() });
+var AssetMetaPayloadSchema = z4.object({
+  assets: z4.array(AssetMetaSchema)
+});
+var AssetDataPayloadSchema = z4.object({
+  id: z4.string(),
+  hash: z4.string(),
+  mime: z4.string(),
+  data: BinaryPayloadDataSchema
+});
+var AssetDeletePayloadSchema = z4.object({
+  ids: z4.array(z4.string())
+});
+var AssetSyncPayloadSchema = z4.object({
+  assets: z4.record(z4.string(), z4.string())
+});
+var ScreenshotRequestPayloadSchema = z4.object({
+  request_id: z4.string(),
+  env_id: z4.string().optional(),
+  chart_id: z4.string().optional(),
+  format: z4.enum(["png", "jpeg"]).optional(),
+  quality: z4.number().min(0).max(1).optional()
+});
+var ScreenshotResponsePayloadSchema = z4.object({
+  request_id: z4.string(),
+  data: BinaryPayloadDataSchema.optional(),
+  mime: z4.string().optional(),
+  error: z4.string().optional()
+});
+var StateSyncRequestSchema = z4.object({
+  request_id: z4.string().optional(),
+  parameters: z4.array(ParameterSchema),
+  actions: z4.array(ActionSchema),
+  envs: z4.array(z4.object({
+    id: z4.string(),
+    type: z4.string(),
+    layers: z4.array(z4.object({ layer_id: z4.string(), layer_type: z4.string() }))
+  })),
+  charts: z4.array(ChartMetadataSchema)
+});
+var ParameterChangePayloadSchema = z4.object({
+  id: z4.string(),
+  value: z4.unknown()
+});
+var ActionStartPayloadSchema = z4.object({
+  id: z4.string(),
+  tick_id: z4.string().optional(),
+  continuous: z4.boolean().optional()
+});
+var SimulatorToRendererMessageSchema = z4.object({
+  type: z4.enum([
+    "metadata_update",
+    "state_sync_begin",
+    "state_sync_end",
+    "action_end",
+    "action_create",
+    "action_update",
+    "action_delete",
+    "env_create",
+    "env_delete",
+    "env_layer_create",
+    "env_layer_update",
+    "env_layer_delete",
+    "item_create",
+    "item_update",
+    "item_delete",
+    "param_create",
+    "param_update",
+    "param_delete",
+    "param_sync",
+    "chart_create",
+    "chart_update",
+    "chart_delete",
+    "asset_meta",
+    "asset_data",
+    "asset_delete",
+    "screenshot_request",
+    "log",
+    "error"
+  ]),
+  payload: z4.unknown(),
+  timestamp: z4.number().optional()
+});
+var RendererToSimulatorMessageSchema = z4.object({
+  type: z4.enum([
+    "state_sync",
+    "param_change",
+    "action_start",
+    "asset_sync",
+    "screenshot_response",
+    "error"
+  ]),
+  payload: z4.unknown(),
+  timestamp: z4.number().optional()
+});
+var AnyProtocolMessageSchema = z4.union([
+  SimulatorToRendererMessageSchema,
+  RendererToSimulatorMessageSchema
+]);
+var getPayloadSchema = (type) => {
+  switch (type) {
+    case "metadata_update":
+      return MetadataUpdatePayloadSchema;
+    case "state_sync_begin":
+      return StateSyncBoundaryPayloadSchema;
+    case "state_sync_end":
+      return StateSyncBoundaryPayloadSchema;
+    case "action_end":
+      return ActionEndPayloadSchema;
+    case "action_create":
+      return ActionSchema;
+    case "action_update":
+      return ActionSchema;
+    case "action_delete":
+      return ActionDeletePayloadSchema;
+    case "env_create":
+      return EnvCreatePayloadSchema;
+    case "env_delete":
+      return EnvDeletePayloadSchema;
+    case "env_layer_create":
+      return EnvLayerCreatePayloadSchema;
+    case "env_layer_update":
+      return EnvLayerUpdatePayloadSchema;
+    case "env_layer_delete":
+      return EnvLayerDeletePayloadSchema;
+    case "item_create":
+      return ItemCreatePayloadSchema;
+    case "item_update":
+      return ItemUpdatePayloadSchema;
+    case "item_delete":
+      return ItemDeletePayloadSchema;
+    case "param_create":
+      return ParameterSchema;
+    case "param_update":
+      return ParameterSchema;
+    case "param_delete":
+      return ParameterDeletePayloadSchema;
+    case "param_sync":
+      return ParameterSyncPayloadSchema;
+    case "chart_create":
+      return ChartGroupMetadataSchema;
+    case "chart_update":
+      return ChartUpdatePayloadSchema;
+    case "chart_delete":
+      return ChartDeletePayloadSchema;
+    case "asset_meta":
+      return AssetMetaPayloadSchema;
+    case "asset_data":
+      return AssetDataPayloadSchema;
+    case "asset_delete":
+      return AssetDeletePayloadSchema;
+    case "screenshot_request":
+      return ScreenshotRequestPayloadSchema;
+    case "screenshot_response":
+      return ScreenshotResponsePayloadSchema;
+    case "log":
+      return LogPayloadSchema;
+    case "error":
+      return ErrorPayloadSchema;
+    case "state_sync":
+      return StateSyncRequestSchema;
+    case "param_change":
+      return ParameterChangePayloadSchema;
+    case "action_start":
+      return ActionStartPayloadSchema;
+    case "asset_sync":
+      return AssetSyncPayloadSchema;
+    default:
+      return z4.unknown();
+  }
+};
+export {
+  ActionDeletePayloadSchema,
+  ActionEndPayloadSchema,
+  ActionStartPayloadSchema,
+  AnyProtocolMessageSchema,
+  AssetDataPayloadSchema,
+  AssetDeletePayloadSchema,
+  AssetMetaPayloadSchema,
+  AssetSyncPayloadSchema,
+  ChartDeletePayloadSchema,
+  ChartUpdatePayloadSchema,
+  EnvCreatePayloadSchema,
+  EnvDeletePayloadSchema,
+  EnvLayerCreatePayloadSchema,
+  EnvLayerDeletePayloadSchema,
+  EnvLayerUpdatePayloadSchema,
+  ErrorPayloadSchema,
+  ItemCreatePayloadSchema,
+  ItemDeletePayloadSchema,
+  ItemDiffSchema,
+  ItemKeySchema,
+  ItemSchema,
+  ItemUpdatePayloadSchema,
+  LogLevelSchema,
+  LogPayloadSchema,
+  MetadataUpdatePayloadSchema,
+  ParameterChangePayloadSchema,
+  ParameterDeletePayloadSchema,
+  ParameterSyncPayloadSchema,
+  PrimitiveItemKeySchema,
+  RendererToSimulatorMessageSchema,
+  ScreenshotRequestPayloadSchema,
+  ScreenshotResponsePayloadSchema,
+  SimulatorToRendererMessageSchema,
+  StateSyncBoundaryPayloadSchema,
+  StateSyncRequestSchema,
+  TickTimingBreakdownSchema,
+  getPayloadSchema
+};
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/schemas.ts", "../src/asset.ts", "../src/chart.ts", "../src/controls.ts", "../src/binary.ts"],
+  "sourcesContent": ["import { z } from 'zod';\nimport { AssetMetaSchema } from './asset';\nimport {\n  ChartGroupMetadataSchema,\n  ChartMetadataSchema,\n  ChartUpdateDataSchema,\n  ChartUpdateOperationSchema,\n} from './chart';\nimport { ActionSchema, ParameterSchema } from './controls';\nimport { isEncodedBinaryString } from './binary';\n\nconst BinaryPayloadStringSchema = z.string().refine(\n  (value) => isEncodedBinaryString(value),\n  'Expected a base64 string or a base64 data URL for binary payload data.',\n);\n\nconst BinaryPayloadDataSchema = z.union([BinaryPayloadStringSchema, z.instanceof(Uint8Array)]);\n\nexport const ItemSchema = z.record(z.string(), z.unknown());\nexport const ItemDiffSchema = z.record(z.string(), z.unknown());\nexport const ItemKeySchema = z.record(z.string(), z.unknown());\nexport const PrimitiveItemKeySchema = z.union([z.string(), z.number()]);\n\nexport const MetadataUpdatePayloadSchema = z.object({\n  time: z.number().optional(),\n}).loose();\n\nexport const StateSyncBoundaryPayloadSchema = z.object({\n  request_id: z.string().optional(),\n});\n\nexport const TickTimingBreakdownSchema = z.object({\n  simulate_ms: z.number().nonnegative().optional(),\n  communicate_ms: z.number().nonnegative().optional(),\n  render_ms: z.number().nonnegative().optional(),\n}).catchall(z.number().nonnegative());\n\nexport const ActionEndPayloadSchema = z.object({\n  id: z.string(),\n  tick_id: z.string().optional(),\n  continue: z.boolean().optional(),\n  timings: TickTimingBreakdownSchema.optional(),\n});\n\nexport const ActionDeletePayloadSchema = z.object({ id: z.string() });\n\nexport const EnvCreatePayloadSchema = z.object({\n  id: z.string(),\n  type: z.enum(['uniform', '2d']),\n});\n\nexport const EnvDeletePayloadSchema = z.object({ id: z.string() });\n\nexport const EnvLayerCreatePayloadSchema = z.object({\n  env_id: z.string(),\n  layer_id: z.string(),\n  layer_type: z.string(),\n  dependency_layer_ids: z.record(z.string(), z.string()).optional(),\n  data: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const EnvLayerUpdatePayloadSchema = z.object({\n  env_id: z.string(),\n  layer_id: z.string(),\n  data: z.record(z.string(), z.unknown()),\n});\n\nexport const EnvLayerDeletePayloadSchema = z.object({\n  env_id: z.string(),\n  layer_id: z.string(),\n});\n\nexport const ItemCreatePayloadSchema = z.object({\n  env_id: z.string(),\n  layer_id: z.string(),\n  items: z.array(ItemSchema),\n});\n\nexport const ItemUpdatePayloadSchema = z.object({\n  env_id: z.string(),\n  layer_id: z.string(),\n  items: z.array(ItemDiffSchema),\n});\n\nexport const ItemDeletePayloadSchema = z.object({\n  env_id: z.string(),\n  layer_id: z.string(),\n  items: z.union([z.array(PrimitiveItemKeySchema), z.array(ItemKeySchema)]),\n});\n\nexport const ParameterDeletePayloadSchema = z.object({ id: z.string() });\n\nexport const ParameterSyncPayloadSchema = z.object({\n  id: z.string(),\n  value: z.unknown(),\n});\n\nexport const ChartDeletePayloadSchema = z.object({ id: z.string() });\n\nexport const ChartUpdatePayloadSchema = z.object({\n  updates: z.array(ChartUpdateDataSchema).optional(),\n  operations: z.array(ChartUpdateOperationSchema).optional(),\n});\n\nexport const LogLevelSchema = z.enum(['debug', 'info', 'warning', 'error', 'critical']);\n\nexport const LogPayloadSchema = z.object({\n  message: z.string(),\n  level: LogLevelSchema.optional(),\n  target: z.string().optional(),\n  timestamp: z.number().optional(),\n  data: z.unknown().optional(),\n});\n\nexport const ErrorPayloadSchema = z.object({ error: z.string() });\n\nexport const AssetMetaPayloadSchema = z.object({\n  assets: z.array(AssetMetaSchema),\n});\n\nexport const AssetDataPayloadSchema = z.object({\n  id: z.string(),\n  hash: z.string(),\n  mime: z.string(),\n  data: BinaryPayloadDataSchema,\n});\n\nexport const AssetDeletePayloadSchema = z.object({\n  ids: z.array(z.string()),\n});\n\nexport const AssetSyncPayloadSchema = z.object({\n  assets: z.record(z.string(), z.string()),\n});\n\nexport const ScreenshotRequestPayloadSchema = z.object({\n  request_id: z.string(),\n  env_id: z.string().optional(),\n  chart_id: z.string().optional(),\n  format: z.enum(['png', 'jpeg']).optional(),\n  quality: z.number().min(0).max(1).optional(),\n});\n\nexport const ScreenshotResponsePayloadSchema = z.object({\n  request_id: z.string(),\n  data: BinaryPayloadDataSchema.optional(),\n  mime: z.string().optional(),\n  error: z.string().optional(),\n});\n\nexport const StateSyncRequestSchema = z.object({\n  request_id: z.string().optional(),\n  parameters: z.array(ParameterSchema),\n  actions: z.array(ActionSchema),\n  envs: z.array(z.object({\n    id: z.string(),\n    type: z.string(),\n    layers: z.array(z.object({ layer_id: z.string(), layer_type: z.string() })),\n  })),\n  charts: z.array(ChartMetadataSchema),\n});\n\nexport const ParameterChangePayloadSchema = z.object({\n  id: z.string(),\n  value: z.unknown(),\n});\n\nexport const ActionStartPayloadSchema = z.object({\n  id: z.string(),\n  tick_id: z.string().optional(),\n  continuous: z.boolean().optional(),\n});\n\nexport const SimulatorToRendererMessageSchema = z.object({\n  type: z.enum([\n    'metadata_update',\n    'state_sync_begin',\n    'state_sync_end',\n    'action_end',\n    'action_create',\n    'action_update',\n    'action_delete',\n    'env_create',\n    'env_delete',\n    'env_layer_create',\n    'env_layer_update',\n    'env_layer_delete',\n    'item_create',\n    'item_update',\n    'item_delete',\n    'param_create',\n    'param_update',\n    'param_delete',\n    'param_sync',\n    'chart_create',\n    'chart_update',\n    'chart_delete',\n    'asset_meta',\n    'asset_data',\n    'asset_delete',\n    'screenshot_request',\n    'log',\n    'error',\n  ]),\n  payload: z.unknown(),\n  timestamp: z.number().optional(),\n});\n\nexport const RendererToSimulatorMessageSchema = z.object({\n  type: z.enum([\n    'state_sync',\n    'param_change',\n    'action_start',\n    'asset_sync',\n    'screenshot_response',\n    'error',\n  ]),\n  payload: z.unknown(),\n  timestamp: z.number().optional(),\n});\n\nexport const AnyProtocolMessageSchema = z.union([\n  SimulatorToRendererMessageSchema,\n  RendererToSimulatorMessageSchema,\n]);\n\nexport const getPayloadSchema = (type: string) => {\n  switch (type) {\n    case 'metadata_update': return MetadataUpdatePayloadSchema;\n    case 'state_sync_begin': return StateSyncBoundaryPayloadSchema;\n    case 'state_sync_end': return StateSyncBoundaryPayloadSchema;\n    case 'action_end': return ActionEndPayloadSchema;\n    case 'action_create': return ActionSchema;\n    case 'action_update': return ActionSchema;\n    case 'action_delete': return ActionDeletePayloadSchema;\n    case 'env_create': return EnvCreatePayloadSchema;\n    case 'env_delete': return EnvDeletePayloadSchema;\n    case 'env_layer_create': return EnvLayerCreatePayloadSchema;\n    case 'env_layer_update': return EnvLayerUpdatePayloadSchema;\n    case 'env_layer_delete': return EnvLayerDeletePayloadSchema;\n    case 'item_create': return ItemCreatePayloadSchema;\n    case 'item_update': return ItemUpdatePayloadSchema;\n    case 'item_delete': return ItemDeletePayloadSchema;\n    case 'param_create': return ParameterSchema;\n    case 'param_update': return ParameterSchema;\n    case 'param_delete': return ParameterDeletePayloadSchema;\n    case 'param_sync': return ParameterSyncPayloadSchema;\n    case 'chart_create': return ChartGroupMetadataSchema;\n    case 'chart_update': return ChartUpdatePayloadSchema;\n    case 'chart_delete': return ChartDeletePayloadSchema;\n    case 'asset_meta': return AssetMetaPayloadSchema;\n    case 'asset_data': return AssetDataPayloadSchema;\n    case 'asset_delete': return AssetDeletePayloadSchema;\n    case 'screenshot_request': return ScreenshotRequestPayloadSchema;\n    case 'screenshot_response': return ScreenshotResponsePayloadSchema;\n    case 'log': return LogPayloadSchema;\n    case 'error': return ErrorPayloadSchema;\n    case 'state_sync': return StateSyncRequestSchema;\n    case 'param_change': return ParameterChangePayloadSchema;\n    case 'action_start': return ActionStartPayloadSchema;\n    case 'asset_sync': return AssetSyncPayloadSchema;\n    default: return z.unknown();\n  }\n};\n", "import { z } from 'zod';\n\n/**\n * Asset identifiers and metadata are protocol payloads, not renderer cache\n * objects. Renderers may resolve them into blob URLs or local buffers, but the\n * wire contract stays content-addressed by id plus hash.\n */\nexport const AssetIdSchema = z.string();\n\nexport type AssetId = z.infer<typeof AssetIdSchema>;\n\nexport const AssetMetaSchema = z.object({\n  id: AssetIdSchema,\n  hash: z.string(),\n  mime: z.string(),\n  size: z.number(),\n  label: z.string().optional(),\n});\n\nexport type AssetMeta = z.infer<typeof AssetMetaSchema>;\n", "import { z } from 'zod';\n\n/**\n * Protocol-level chart types describe series identity and updates only. Chart\n * rendering config, layouts, and UI-specific storage live in renderer packages.\n */\nexport const ChartMetadataSchema = z.object({\n  id: z.string(),\n  label: z.string(),\n  color: z.string().optional(),\n});\n\nexport type ChartMetadata = z.infer<typeof ChartMetadataSchema>;\n\nexport const ChartGroupMetadataSchema = ChartMetadataSchema.extend({\n  dataList: z.array(ChartMetadataSchema).optional(),\n});\n\nexport type ChartGroupMetadata = z.infer<typeof ChartGroupMetadataSchema>;\n\nexport const ChartUpdateDataSchema = z.object({\n  id: z.string(),\n  time: z.number().optional(),\n  value: z.unknown(),\n});\n\nexport type ChartUpdateData = z.infer<typeof ChartUpdateDataSchema>;\n\nexport const ChartUpdateOperationSchema = z.object({\n  id: z.string(),\n  operation: z.literal('clear'),\n});\n\nexport type ChartUpdateOperation = z.infer<typeof ChartUpdateOperationSchema>;\n", "import { z } from 'zod';\n\n/**\n * Parameters describe mutable simulator configuration exposed to the renderer.\n * Actions are intentionally separate in protocol v0.2: they have their own\n * lifecycle and renderer-driven continuous loop semantics.\n */\nexport const ParameterTypeSchema = z.enum(['number', 'enum', 'boolean', 'string']);\n\nexport type ParameterType = z.infer<typeof ParameterTypeSchema>;\n\nexport const ParameterBaseSchema = z.object({\n  id: z.string(),\n  type: ParameterTypeSchema,\n  label: z.string(),\n  allowRuntimeChange: z.boolean().optional(),\n});\n\nexport type ParameterBase = z.infer<typeof ParameterBaseSchema>;\n\nexport const NumberParameterSchema = ParameterBaseSchema.extend({\n  type: z.literal('number'),\n  value: z.number(),\n  min: z.number().optional(),\n  max: z.number().optional(),\n  step: z.number().optional(),\n});\n\nexport type NumberParameter = z.infer<typeof NumberParameterSchema>;\n\nexport const EnumParameterSchema = ParameterBaseSchema.extend({\n  type: z.literal('enum'),\n  value: z.string(),\n  options: z.array(z.string()),\n  labels: z.record(z.string(), z.string()).optional(),\n});\n\nexport type EnumParameter = z.infer<typeof EnumParameterSchema>;\n\nexport const BooleanParameterSchema = ParameterBaseSchema.extend({\n  type: z.literal('boolean'),\n  value: z.boolean(),\n});\n\nexport type BooleanParameter = z.infer<typeof BooleanParameterSchema>;\n\nexport const StringParameterSchema = ParameterBaseSchema.extend({\n  type: z.literal('string'),\n  value: z.string(),\n});\n\nexport type StringParameter = z.infer<typeof StringParameterSchema>;\n\nexport const ParameterSchema = z.union([\n  NumberParameterSchema,\n  EnumParameterSchema,\n  BooleanParameterSchema,\n  StringParameterSchema,\n]);\n\nexport type Parameter = z.infer<typeof ParameterSchema>;\n\nexport const ActionSchema = z.object({\n  id: z.string(),\n  label: z.string(),\n  continuous: z.boolean().optional(),\n  allowRuntimeChange: z.boolean().optional(),\n});\n\n/** A renderer-visible command exposed by the simulator. */\nexport type Action = z.infer<typeof ActionSchema>;\n", "const BASE64_DATA_URL_MARKER = ';base64,';\n\ninterface BufferEncoderResult {\n  toString(encoding: 'base64'): string;\n}\n\ninterface BufferLike {\n  from(data: Uint8Array): BufferEncoderResult;\n  from(data: string, encoding: 'base64'): ArrayLike<number>;\n}\n\nexport interface DecodedBinaryString {\n  bytes: Uint8Array;\n  mime?: string;\n  encoding: 'base64' | 'data-url';\n}\n\nfunction getGlobalBuffer(): BufferLike | undefined {\n  return (globalThis as { Buffer?: BufferLike }).Buffer;\n}\n\nexport function encodeBytesAsBase64(bytes: Uint8Array): string {\n  const buffer = getGlobalBuffer();\n  if (buffer) {\n    return buffer.from(bytes).toString('base64');\n  }\n\n  if (typeof btoa === 'function') {\n    let binary = '';\n    for (let index = 0; index < bytes.length; index += 1) {\n      binary += String.fromCharCode(bytes[index]);\n    }\n    return btoa(binary);\n  }\n\n  throw new Error('No base64 encoder is available in this runtime.');\n}\n\nexport function encodeBytesAsDataUrl(\n  bytes: Uint8Array,\n  mime = 'application/octet-stream',\n): string {\n  return `data:${mime};base64,${encodeBytesAsBase64(bytes)}`;\n}\n\nexport function decodeBinaryString(value: string): DecodedBinaryString {\n  const decoded = tryDecodeBinaryString(value);\n  if (!decoded) {\n    throw new Error('Expected a base64 string or a base64 data URL.');\n  }\n  return decoded;\n}\n\nexport function isEncodedBinaryString(value: string): boolean {\n  return tryDecodeBinaryString(value) !== null;\n}\n\nfunction tryDecodeBinaryString(value: string): DecodedBinaryString | null {\n  if (value.startsWith('data:')) {\n    const dataUrl = tryDecodeBase64DataUrl(value);\n    if (dataUrl) {\n      return dataUrl;\n    }\n  }\n\n  const bytes = tryDecodeBase64(value);\n  if (!bytes) {\n    return null;\n  }\n\n  return {\n    bytes,\n    encoding: 'base64',\n  };\n}\n\nfunction tryDecodeBase64DataUrl(value: string): DecodedBinaryString | null {\n  const markerIndex = value.indexOf(BASE64_DATA_URL_MARKER);\n  if (markerIndex === -1) {\n    return null;\n  }\n\n  const mime = value.slice(5, markerIndex) || undefined;\n  const base64 = value.slice(markerIndex + BASE64_DATA_URL_MARKER.length);\n  const bytes = tryDecodeBase64(base64);\n  if (!bytes) {\n    return null;\n  }\n\n  return {\n    bytes,\n    mime,\n    encoding: 'data-url',\n  };\n}\n\nfunction tryDecodeBase64(value: string): Uint8Array | null {\n  const normalized = value.replace(/\\s+/g, '');\n  if (!normalized || normalized.length % 4 !== 0 || /[^A-Za-z0-9+/=]/.test(normalized)) {\n    return null;\n  }\n\n  try {\n    const buffer = getGlobalBuffer();\n    if (buffer) {\n      return new Uint8Array(buffer.from(normalized, 'base64'));\n    }\n\n    if (typeof atob === 'function') {\n      const binary = atob(normalized);\n      const bytes = new Uint8Array(binary.length);\n      for (let index = 0; index < binary.length; index += 1) {\n        bytes[index] = binary.charCodeAt(index);\n      }\n      return bytes;\n    }\n  } catch {\n    return null;\n  }\n\n  throw new Error('No base64 decoder is available in this runtime.');\n}\n"],
+  "mappings": "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",
+  "names": ["z", "z", "z", "z"]
+}

package/dist/types.d.ts

@@ -0,0 +1,180 @@
+import type { AssetId, AssetMeta } from './asset';
+import type { ChartGroupMetadata, ChartMetadata, ChartUpdateData, ChartUpdateOperation } from './chart';
+import type { Action, Parameter } from './controls';
+/**
+ * Protocol v0.2 uses renderer/simulator terms instead of client/server terms.
+ * The renderer owns synchronized session state; the simulator emits updates and
+ * responds to renderer-owned action, parameter, sync, asset, and screenshot
+ * events.
+ */
+export type EnvironmentId = string;
+export type ScenarioEnvironmentType = 'uniform' | '2d';
+export type ItemRecord = Record<string, unknown>;
+export type ItemDiff = Record<string, unknown>;
+export type ItemKey = Record<string, unknown>;
+export type PrimitiveItemKey = string | number;
+export type ItemDeleteItems = ItemKey[] | PrimitiveItemKey[];
+export type SimulatorToRendererMessageType = 'metadata_update' | 'state_sync_begin' | 'state_sync_end' | 'action_end' | 'action_create' | 'action_update' | 'action_delete' | 'env_create' | 'env_delete' | 'env_layer_create' | 'env_layer_update' | 'env_layer_delete' | 'item_create' | 'item_update' | 'item_delete' | 'param_create' | 'param_update' | 'param_delete' | 'param_sync' | 'chart_create' | 'chart_update' | 'chart_delete' | 'asset_meta' | 'asset_data' | 'asset_delete' | 'screenshot_request' | 'log' | 'error';
+export type RendererToSimulatorMessageType = 'state_sync' | 'param_change' | 'action_start' | 'asset_sync' | 'screenshot_response' | 'error';
+export type ProtocolMessageType = SimulatorToRendererMessageType | RendererToSimulatorMessageType;
+/** Transport-neutral envelope shared by every protocol message. */
+export interface ProtocolMessage<TType extends ProtocolMessageType = ProtocolMessageType, TPayload = unknown> {
+    type: TType;
+    payload: TPayload;
+    timestamp?: number;
+}
+export interface SimulatorToRendererMessage<TPayload = unknown> extends ProtocolMessage<SimulatorToRendererMessageType, TPayload> {
+}
+export interface RendererToSimulatorMessage<TPayload = unknown> extends ProtocolMessage<RendererToSimulatorMessageType, TPayload> {
+}
+/** Scenario-wide metadata update. In v0.2 this replaces v0.1 time-step events. */
+export interface MetadataUpdatePayload {
+    time?: number;
+    [key: string]: unknown;
+}
+export interface StateSyncBoundaryPayload {
+    request_id?: string;
+}
+export interface TickTimingBreakdown {
+    simulate_ms?: number;
+    communicate_ms?: number;
+    render_ms?: number;
+    [key: string]: number | undefined;
+}
+export interface ActionEndPayload {
+    id: string;
+    tick_id?: string;
+    /** Renderer-driven continuous loops continue only when this remains true. */
+    continue?: boolean;
+    timings?: TickTimingBreakdown;
+}
+export interface ActionDeletePayload {
+    id: string;
+}
+export interface EnvCreatePayload {
+    id: EnvironmentId;
+    type: ScenarioEnvironmentType;
+}
+export interface EnvDeletePayload {
+    id: EnvironmentId;
+}
+export interface EnvLayerCreatePayload {
+    env_id: EnvironmentId;
+    layer_id: string;
+    layer_type: string;
+    /** Create-time topology. Change dependencies by recreating the layer. */
+    dependency_layer_ids?: Record<string, string>;
+    data?: Record<string, unknown>;
+}
+export interface EnvLayerUpdatePayload {
+    env_id: EnvironmentId;
+    layer_id: string;
+    data: Record<string, unknown>;
+}
+export interface EnvLayerDeletePayload {
+    env_id: EnvironmentId;
+    layer_id: string;
+}
+export interface ItemCreatePayload<TItem extends ItemRecord = ItemRecord> {
+    env_id: EnvironmentId;
+    layer_id: string;
+    items: TItem[];
+}
+export interface ItemUpdatePayload<TItem extends ItemDiff = ItemDiff> {
+    env_id: EnvironmentId;
+    layer_id: string;
+    items: TItem[];
+}
+export interface ItemDeletePayload<TItems extends ItemDeleteItems = ItemDeleteItems> {
+    env_id: EnvironmentId;
+    layer_id: string;
+    items: TItems;
+}
+export interface ParameterDeletePayload {
+    id: string;
+}
+export interface ParameterSyncPayload {
+    id: string;
+    value: unknown;
+}
+export interface ChartDeletePayload {
+    id: string;
+}
+export interface ChartUpdatePayload {
+    updates?: ChartUpdateData[];
+    operations?: ChartUpdateOperation[];
+}
+export type LogLevel = 'debug' | 'info' | 'warning' | 'error' | 'critical';
+export interface LogPayload {
+    message: string;
+    level?: LogLevel;
+    target?: string;
+    timestamp?: number;
+    data?: unknown;
+}
+export interface NormalizedLogPayload extends LogPayload {
+    level: LogLevel;
+    timestamp: number;
+}
+export interface ErrorPayload {
+    error: string;
+}
+export interface AssetMetaPayload {
+    assets: AssetMeta[];
+}
+export interface AssetDataPayload {
+    id: AssetId;
+    hash: string;
+    mime: string;
+    /** JSON transports carry base64/data URLs; binary transports carry bytes. */
+    data: string | Uint8Array;
+}
+export interface AssetDeletePayload {
+    ids: AssetId[];
+}
+export interface AssetSyncPayload {
+    assets: Record<AssetId, string>;
+}
+export interface ScreenshotRequestPayload {
+    request_id: string;
+    env_id?: string;
+    chart_id?: string;
+    format?: 'png' | 'jpeg';
+    quality?: number;
+}
+export interface ScreenshotResponsePayload {
+    request_id: string;
+    data?: string | Uint8Array;
+    mime?: string;
+    error?: string;
+}
+export interface StateSyncRequest {
+    request_id?: string;
+    /** Current renderer-held definitions used by the simulator to replay deltas. */
+    parameters: Parameter[];
+    actions: Action[];
+    envs: Array<{
+        id: EnvironmentId;
+        type: string;
+        layers: Array<{
+            layer_id: string;
+            layer_type: string;
+        }>;
+    }>;
+    charts: ChartMetadata[];
+}
+export interface ParameterChangePayload {
+    id: string;
+    value: unknown;
+}
+export interface ActionStartPayload {
+    id: string;
+    tick_id?: string;
+    continuous?: boolean;
+}
+export type SimulatorToRendererPayload = MetadataUpdatePayload | StateSyncBoundaryPayload | ActionEndPayload | Action | ActionDeletePayload | EnvCreatePayload | EnvDeletePayload | EnvLayerCreatePayload | EnvLayerUpdatePayload | EnvLayerDeletePayload | ItemCreatePayload | ItemUpdatePayload | ItemDeletePayload | Parameter | ParameterDeletePayload | ParameterSyncPayload | ChartGroupMetadata | ChartUpdatePayload | ChartDeletePayload | AssetMetaPayload | AssetDataPayload | AssetDeletePayload | ScreenshotRequestPayload | LogPayload | ErrorPayload;
+export type RendererToSimulatorPayload = StateSyncRequest | ParameterChangePayload | ActionStartPayload | AssetSyncPayload | ScreenshotResponsePayload | ErrorPayload;
+export type SimulatorToRendererWSMessage = SimulatorToRendererMessage<SimulatorToRendererPayload>;
+export type RendererToSimulatorWSMessage = RendererToSimulatorMessage<RendererToSimulatorPayload>;
+export type AnyProtocolMessage = SimulatorToRendererWSMessage | RendererToSimulatorWSMessage;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}