@xtrape/capsule-contracts-node 0.3.0 → 0.4.0

package/README.md

@@ -404,3 +404,27 @@ contract validation safety guidance.
 
 Apache-2.0. "Xtrape", "Xtrape Capsule", and "Opstage" are trademarks of their
 respective owners; the open-source license does not grant trademark rights.
+
+## v0.4 Capsule Bus Experimental
+
+`v0.4` adds an experimental Capsule Bus contract surface for CE's built-in SQLite-backed in-process event-to-command router. It is intentionally small, single-node, and disabled by default; it is **not** a standalone Bus Server, external broker (NATS / RabbitMQ / Redis Streams / Kafka), workflow DSL, or service mesh. No fan-out (`maxCommandsPerEvent`) in v0.4 — one matched route produces at most one `ACTION_EXECUTE` command.
+
+Key exports:
+
+- `BusEventEnvelopeSchema`
+- `PublishBusEventRequestSchema`
+- `PublishBusEventResponseSchema`
+- `BusRouteRuleSchema`
+- `CreateBusRouteRuleRequestSchema`
+
+Minimal event payload:
+
+```ts
+BusEventEnvelopeSchema.parse({
+  eventType: "demo.item.created",
+  sourceServiceCode: "demo-worker",
+  payload: { itemId: "item-1" },
+});
+```
+
+All schemas include or default `experimental: "v0.4-experimental"`; consumers should treat the wire surface as unstable until v1.0.

package/dist/index.cjs

@@ -36,6 +36,16 @@ __export(index_exports, {
   AuditActorType: () => AuditActorType,
   AuditEventSchema: () => AuditEventSchema,
   AuditResult: () => AuditResult,
+  BusCommandRequestSchema: () => BusCommandRequestSchema,
+  BusErrorCode: () => BusErrorCode,
+  BusEventEnvelopeSchema: () => BusEventEnvelopeSchema,
+  BusEventRecordSchema: () => BusEventRecordSchema,
+  BusRouteRuleSchema: () => BusRouteRuleSchema,
+  BusRouteStatus: () => BusRouteStatus,
+  BusRouteStatusSchema: () => BusRouteStatusSchema,
+  BusRoutedCommandSchema: () => BusRoutedCommandSchema,
+  BusRoutingRuleSchema: () => BusRoutingRuleSchema,
+  CapsuleBusExperimentalSchema: () => CapsuleBusExperimentalSchema,
   CapsuleManifestSchema: () => CapsuleManifestSchema,
   CapsuleServiceDetailSchema: () => CapsuleServiceDetailSchema,
   CapsuleServiceSchema: () => CapsuleServiceSchema,
@@ -50,6 +60,7 @@ __export(index_exports, {
   ConfigItemInputSchema: () => ConfigItemInputSchema,
   ConfigItemSchema: () => ConfigItemSchema,
   CreateActionCommandRequestSchema: () => CreateActionCommandRequestSchema,
+  CreateBusRouteRuleRequestSchema: () => CreateBusRouteRuleRequestSchema,
   CreateRegistrationTokenRequestSchema: () => CreateRegistrationTokenRequestSchema,
   CreateRegistrationTokenResponseSchema: () => CreateRegistrationTokenResponseSchema,
   DangerLevel: () => DangerLevel,
@@ -63,6 +74,8 @@ __export(index_exports, {
   HealthStatusSchema: () => HealthStatusSchema,
   HttpError: () => HttpError,
   ListQueryBase: () => ListQueryBase,
+  PublishBusEventRequestSchema: () => PublishBusEventRequestSchema,
+  PublishBusEventResponseSchema: () => PublishBusEventResponseSchema,
   RegisterAgentRequestSchema: () => RegisterAgentRequestSchema,
   RegisterAgentResponseSchema: () => RegisterAgentResponseSchema,
   RegistrationTokenSchema: () => RegistrationTokenSchema,
@@ -82,14 +95,21 @@ __export(index_exports, {
   actionPrepareResultSchema: () => actionPrepareResultSchema,
   adminLoginRequestSchema: () => adminLoginRequestSchema,
   agentHeartbeatRequestSchema: () => agentHeartbeatRequestSchema,
+  busCommandRequestSchema: () => busCommandRequestSchema,
+  busEventEnvelopeSchema: () => busEventEnvelopeSchema,
+  busRouteRuleSchema: () => busRouteRuleSchema,
+  busRoutingRuleSchema: () => busRoutingRuleSchema,
   configItemInputSchema: () => configItemInputSchema,
   createActionCommandRequestSchema: () => createActionCommandRequestSchema,
+  createBusRouteRuleRequestSchema: () => createBusRouteRuleRequestSchema,
   createRegistrationTokenRequestSchema: () => createRegistrationTokenRequestSchema,
   createUserRequestSchema: () => createUserRequestSchema,
   eventMetadataSchema: () => eventMetadataSchema,
   healthReportInputSchema: () => healthReportInputSchema,
   paginate: () => paginate,
   parseSort: () => parseSort,
+  publishBusEventRequestSchema: () => publishBusEventRequestSchema,
+  publishBusEventResponseSchema: () => publishBusEventResponseSchema,
   registerAgentRequestSchema: () => registerAgentRequestSchema,
   reportCommandResultRequestSchema: () => reportCommandResultRequestSchema,
   reportedServiceSchema: () => reportedServiceSchema,
@@ -179,6 +199,87 @@ var ActionPrepareResultSchema = import_zod.z.object({
   currentState: AnyJson.optional()
 });
 var actionPrepareResultSchema = ActionPrepareResultSchema;
+var CapsuleBusExperimentalSchema = import_zod.z.literal("v0.4-experimental");
+var BusRouteStatus = ["ENABLED", "DISABLED", "DRY_RUN"];
+var BusRouteStatusSchema = import_zod.z.enum(BusRouteStatus);
+var BusEventEnvelopeSchema = import_zod.z.object({
+  id: import_zod.z.string().startsWith("bev_").optional(),
+  experimental: CapsuleBusExperimentalSchema.default("v0.4-experimental"),
+  eventType: import_zod.z.string().min(1).max(160),
+  sourceServiceCode: import_zod.z.string().min(1).max(80),
+  sourceServiceId: import_zod.z.string().startsWith("svc_").optional(),
+  occurredAt: import_zod.z.string().datetime().optional(),
+  correlationId: import_zod.z.string().min(1).max(160).optional(),
+  causationId: import_zod.z.string().min(1).max(160).optional(),
+  payload: AnyJson.default({}).optional(),
+  metadata: AnyJson.default({}).optional()
+});
+var PublishBusEventRequestSchema = BusEventEnvelopeSchema.omit({ id: true }).extend({
+  routePolicy: import_zod.z.object({ dryRun: import_zod.z.boolean().optional() }).optional()
+});
+var BusRouteRuleSchema = import_zod.z.object({
+  id: import_zod.z.string().startsWith("brt_").optional(),
+  name: import_zod.z.string().min(1).max(160),
+  description: import_zod.z.string().max(1e3).optional(),
+  status: BusRouteStatusSchema.optional().default("DISABLED"),
+  match: import_zod.z.object({
+    eventType: import_zod.z.string().min(1).max(160),
+    sourceServiceCode: import_zod.z.string().min(1).max(80).optional()
+  }),
+  target: import_zod.z.object({
+    serviceCode: import_zod.z.string().min(1).max(80),
+    actionName: import_zod.z.string().min(1).max(128)
+  }),
+  inputMapping: AnyJson.default({}).optional(),
+  metadata: AnyJson.default({}).optional()
+});
+var CreateBusRouteRuleRequestSchema = BusRouteRuleSchema.omit({ id: true });
+var BusCommandRequestSchema = import_zod.z.object({
+  commandId: import_zod.z.string().startsWith("cmd_").optional(),
+  commandType: import_zod.z.literal("ACTION_EXECUTE").default("ACTION_EXECUTE"),
+  targetService: import_zod.z.string().min(1).max(80),
+  actionName: import_zod.z.string().min(1).max(128),
+  sourceEventId: import_zod.z.string().startsWith("bev_").optional(),
+  payload: AnyJson.default({}).optional(),
+  metadata: import_zod.z.object({
+    routingRuleId: import_zod.z.string().startsWith("brt_").optional(),
+    correlationId: import_zod.z.string().min(1).max(160).optional()
+  }).catchall(import_zod.z.any()).optional()
+});
+var busCommandRequestSchema = BusCommandRequestSchema;
+var BusRoutingRuleSchema = BusRouteRuleSchema;
+var busRoutingRuleSchema = BusRoutingRuleSchema;
+var BusRoutedCommandSchema = import_zod.z.object({
+  routeId: import_zod.z.string().startsWith("brt_"),
+  commandId: import_zod.z.string().startsWith("cmd_").optional(),
+  dryRun: import_zod.z.boolean(),
+  targetServiceCode: import_zod.z.string(),
+  actionName: import_zod.z.string(),
+  status: import_zod.z.enum(["CREATED", "DRY_RUN", "SKIPPED", "FAILED"]),
+  errorCode: import_zod.z.string().optional(),
+  errorMessage: import_zod.z.string().optional()
+});
+var PublishBusEventResponseSchema = import_zod.z.object({
+  eventId: import_zod.z.string().startsWith("bev_"),
+  experimental: CapsuleBusExperimentalSchema,
+  routedCommands: import_zod.z.array(BusRoutedCommandSchema)
+});
+var BusEventRecordSchema = BusEventEnvelopeSchema.extend({
+  id: import_zod.z.string().startsWith("bev_"),
+  agentId: import_zod.z.string().startsWith("agt_"),
+  acceptedAt: import_zod.z.string(),
+  routeCount: import_zod.z.number().int()
+});
+var BusErrorCode = {
+  CAPSULE_BUS_DISABLED: "CAPSULE_BUS_DISABLED",
+  BUS_RATE_LIMITED: "BUS_RATE_LIMITED",
+  BUS_DEPTH_EXCEEDED: "BUS_DEPTH_EXCEEDED"
+};
+var publishBusEventRequestSchema = PublishBusEventRequestSchema;
+var publishBusEventResponseSchema = PublishBusEventResponseSchema;
+var busEventEnvelopeSchema = BusEventEnvelopeSchema;
+var busRouteRuleSchema = BusRouteRuleSchema;
+var createBusRouteRuleRequestSchema = CreateBusRouteRuleRequestSchema;
 var CreateActionCommandRequestSchema = import_zod.z.object({ payload: AnyJson.optional(), confirmation: import_zod.z.boolean().optional() });
 var createActionCommandRequestSchema = CreateActionCommandRequestSchema;
 var CommandTypeSchema = import_zod.z.enum(["ACTION_PREPARE", "ACTION_EXECUTE"]);
@@ -250,6 +351,16 @@ var ErrorCode = {
   AuditActorType,
   AuditEventSchema,
   AuditResult,
+  BusCommandRequestSchema,
+  BusErrorCode,
+  BusEventEnvelopeSchema,
+  BusEventRecordSchema,
+  BusRouteRuleSchema,
+  BusRouteStatus,
+  BusRouteStatusSchema,
+  BusRoutedCommandSchema,
+  BusRoutingRuleSchema,
+  CapsuleBusExperimentalSchema,
   CapsuleManifestSchema,
   CapsuleServiceDetailSchema,
   CapsuleServiceSchema,
@@ -264,6 +375,7 @@ var ErrorCode = {
   ConfigItemInputSchema,
   ConfigItemSchema,
   CreateActionCommandRequestSchema,
+  CreateBusRouteRuleRequestSchema,
   CreateRegistrationTokenRequestSchema,
   CreateRegistrationTokenResponseSchema,
   DangerLevel,
@@ -277,6 +389,8 @@ var ErrorCode = {
   HealthStatusSchema,
   HttpError,
   ListQueryBase,
+  PublishBusEventRequestSchema,
+  PublishBusEventResponseSchema,
   RegisterAgentRequestSchema,
   RegisterAgentResponseSchema,
   RegistrationTokenSchema,
@@ -296,14 +410,21 @@ var ErrorCode = {
   actionPrepareResultSchema,
   adminLoginRequestSchema,
   agentHeartbeatRequestSchema,
+  busCommandRequestSchema,
+  busEventEnvelopeSchema,
+  busRouteRuleSchema,
+  busRoutingRuleSchema,
   configItemInputSchema,
   createActionCommandRequestSchema,
+  createBusRouteRuleRequestSchema,
   createRegistrationTokenRequestSchema,
   createUserRequestSchema,
   eventMetadataSchema,
   healthReportInputSchema,
   paginate,
   parseSort,
+  publishBusEventRequestSchema,
+  publishBusEventResponseSchema,
   registerAgentRequestSchema,
   reportCommandResultRequestSchema,
   reportedServiceSchema,