@kohost/api-client 7.8.1 → 7.9.0

package/dist/schemas/resource.js

@@ -0,0 +1,112 @@
+//#region .generated/schemas/resource.ts
+const resourceSchema = {
+	$schema: "http://json-schema.org/draft-07/schema",
+	$id: "resource.json",
+	title: "Resource",
+	description: "An entry in the organization's resource library — an uploaded file or an external link.",
+	type: "object",
+	required: [
+		"id",
+		"type",
+		"discriminator",
+		"name",
+		"scope"
+	],
+	properties: {
+		id: { $ref: "definitions.json#/definitions/id" },
+		type: {
+			type: "string",
+			enum: ["resource"],
+			default: "resource"
+		},
+		discriminator: {
+			type: "string",
+			enum: ["file", "link"],
+			description: "Which payload the resource carries: `file` an uploaded document in `media`, `link` an external address in `url`."
+		},
+		name: {
+			type: "string",
+			minLength: 1,
+			description: "Display name. A file resource defaults to its filename at creation and is editable independently of it."
+		},
+		description: { type: "string" },
+		url: {
+			type: "string",
+			format: "uri",
+			description: "The external address a `link` resource points at."
+		},
+		media: {
+			$ref: "mediaFile.json",
+			description: "The uploaded document a `file` resource carries."
+		},
+		preview: {
+			type: "object",
+			additionalProperties: false,
+			required: ["url"],
+			description: "The generated Open Graph preview image for a `link` resource, stored in the file store's org tier. Written by the system after the link is saved, never by the caller.",
+			properties: {
+				url: {
+					type: "string",
+					format: "uri"
+				},
+				width: { type: "number" },
+				height: { type: "number" }
+			}
+		},
+		categoryIds: {
+			type: "array",
+			items: { type: "string" },
+			default: [],
+			description: "The `resource` categories this resource appears under. Empty means uncategorized."
+		},
+		scope: {
+			type: "object",
+			description: "Where this resource is available: an org-wide `default` plus a sparse map of per-Property overrides. Mirrors an SOS Type's scope; `false` suppresses, an absent key inherits `default`.",
+			additionalProperties: false,
+			properties: {
+				default: {
+					type: "boolean",
+					default: false,
+					description: "Org-wide baseline: whether the resource is available at Properties with no override, including Properties added later."
+				},
+				properties: {
+					type: "object",
+					additionalProperties: { type: "boolean" },
+					default: {},
+					description: "Sparse per-Property overrides keyed by Property ID: `true` opts in, `false` opts out, an absent key inherits `default`."
+				}
+			}
+		},
+		createdBy: {
+			type: "object",
+			additionalProperties: false,
+			required: [
+				"id",
+				"discriminator",
+				"name"
+			],
+			description: "Who added the resource, embedded at creation so the library shows provenance without a join.",
+			properties: {
+				id: { type: "string" },
+				discriminator: {
+					type: "string",
+					enum: ["user", "system"]
+				},
+				name: { type: "string" },
+				photo: { anyOf: [
+					{ $ref: "mediaFile.json" },
+					{ type: "null" },
+					{ type: "string" }
+				] }
+			}
+		},
+		createdAt: { $ref: "definitions.json#/definitions/date" },
+		updatedAt: { $ref: "definitions.json#/definitions/date" },
+		deletedAt: { $ref: "definitions.json#/definitions/date" }
+	},
+	additionalProperties: false
+};
+//#endregion
+export { resourceSchema };
+
+//# sourceMappingURL=resource.js.map

package/dist/schemas/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","names":[],"sources":["../../.generated/schemas/resource.ts"],"sourcesContent":["import defs, { ISODateString } from \"./definitions\";\nimport type { mediaFileSchema } from \"./mediaFile\";\nimport type { FromSchema } from \"json-schema-to-ts\";\n\nexport const resourceSchema = {\n  $schema: \"http://json-schema.org/draft-07/schema\",\n  $id: \"resource.json\",\n  title: \"Resource\",\n  description:\n    \"An entry in the organization's resource library — an uploaded file or an external link.\",\n  type: \"object\",\n  required: [\"id\", \"type\", \"discriminator\", \"name\", \"scope\"],\n  properties: {\n    id: {\n      $ref: \"definitions.json#/definitions/id\",\n    },\n    type: {\n      type: \"string\",\n      enum: [\"resource\"],\n      default: \"resource\",\n    },\n    discriminator: {\n      type: \"string\",\n      enum: [\"file\", \"link\"],\n      description:\n        \"Which payload the resource carries: `file` an uploaded document in `media`, `link` an external address in `url`.\",\n    },\n    name: {\n      type: \"string\",\n      minLength: 1,\n      description:\n        \"Display name. A file resource defaults to its filename at creation and is editable independently of it.\",\n    },\n    description: {\n      type: \"string\",\n    },\n    url: {\n      type: \"string\",\n      format: \"uri\",\n      description: \"The external address a `link` resource points at.\",\n    },\n    media: {\n      $ref: \"mediaFile.json\",\n      description: \"The uploaded document a `file` resource carries.\",\n    },\n    preview: {\n      type: \"object\",\n      additionalProperties: false,\n      required: [\"url\"],\n      description:\n        \"The generated Open Graph preview image for a `link` resource, stored in the file store's org tier. Written by the system after the link is saved, never by the caller.\",\n      properties: {\n        url: {\n          type: \"string\",\n          format: \"uri\",\n        },\n        width: {\n          type: \"number\",\n        },\n        height: {\n          type: \"number\",\n        },\n      },\n    },\n    categoryIds: {\n      type: \"array\",\n      items: {\n        type: \"string\",\n      },\n      default: [],\n      description:\n        \"The `resource` categories this resource appears under. Empty means uncategorized.\",\n    },\n    scope: {\n      type: \"object\",\n      description:\n        \"Where this resource is available: an org-wide `default` plus a sparse map of per-Property overrides. Mirrors an SOS Type's scope; `false` suppresses, an absent key inherits `default`.\",\n      additionalProperties: false,\n      properties: {\n        default: {\n          type: \"boolean\",\n          default: false,\n          description:\n            \"Org-wide baseline: whether the resource is available at Properties with no override, including Properties added later.\",\n        },\n        properties: {\n          type: \"object\",\n          additionalProperties: {\n            type: \"boolean\",\n          },\n          default: {},\n          description:\n            \"Sparse per-Property overrides keyed by Property ID: `true` opts in, `false` opts out, an absent key inherits `default`.\",\n        },\n      },\n    },\n    createdBy: {\n      type: \"object\",\n      additionalProperties: false,\n      required: [\"id\", \"discriminator\", \"name\"],\n      description:\n        \"Who added the resource, embedded at creation so the library shows provenance without a join.\",\n      properties: {\n        id: {\n          type: \"string\",\n        },\n        discriminator: {\n          type: \"string\",\n          enum: [\"user\", \"system\"],\n        },\n        name: {\n          type: \"string\",\n        },\n        photo: {\n          anyOf: [\n            {\n              $ref: \"mediaFile.json\",\n            },\n            {\n              type: \"null\",\n            },\n            {\n              type: \"string\",\n            },\n          ],\n        },\n      },\n    },\n    createdAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    updatedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    deletedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n  },\n  additionalProperties: false,\n} as const;\n\nexport type ResourceSchema = FromSchema<\n  typeof resourceSchema,\n  {\n    references: [typeof defs, typeof mediaFileSchema];\n    deserialize: [\n      {\n        pattern: {\n          format: \"date-time\";\n        };\n        output: Date | ISODateString;\n      },\n    ];\n  }\n>;\n"],"mappings":";AAIA,MAAa,iBAAiB;CAC5B,SAAS;CACT,KAAK;CACL,OAAO;CACP,aACE;CACF,MAAM;CACN,UAAU;EAAC;EAAM;EAAQ;EAAiB;EAAQ;CAAO;CACzD,YAAY;EACV,IAAI,EACF,MAAM,mCACR;EACA,MAAM;GACJ,MAAM;GACN,MAAM,CAAC,UAAU;GACjB,SAAS;EACX;EACA,eAAe;GACb,MAAM;GACN,MAAM,CAAC,QAAQ,MAAM;GACrB,aACE;EACJ;EACA,MAAM;GACJ,MAAM;GACN,WAAW;GACX,aACE;EACJ;EACA,aAAa,EACX,MAAM,SACR;EACA,KAAK;GACH,MAAM;GACN,QAAQ;GACR,aAAa;EACf;EACA,OAAO;GACL,MAAM;GACN,aAAa;EACf;EACA,SAAS;GACP,MAAM;GACN,sBAAsB;GACtB,UAAU,CAAC,KAAK;GAChB,aACE;GACF,YAAY;IACV,KAAK;KACH,MAAM;KACN,QAAQ;IACV;IACA,OAAO,EACL,MAAM,SACR;IACA,QAAQ,EACN,MAAM,SACR;GACF;EACF;EACA,aAAa;GACX,MAAM;GACN,OAAO,EACL,MAAM,SACR;GACA,SAAS,CAAC;GACV,aACE;EACJ;EACA,OAAO;GACL,MAAM;GACN,aACE;GACF,sBAAsB;GACtB,YAAY;IACV,SAAS;KACP,MAAM;KACN,SAAS;KACT,aACE;IACJ;IACA,YAAY;KACV,MAAM;KACN,sBAAsB,EACpB,MAAM,UACR;KACA,SAAS,CAAC;KACV,aACE;IACJ;GACF;EACF;EACA,WAAW;GACT,MAAM;GACN,sBAAsB;GACtB,UAAU;IAAC;IAAM;IAAiB;GAAM;GACxC,aACE;GACF,YAAY;IACV,IAAI,EACF,MAAM,SACR;IACA,eAAe;KACb,MAAM;KACN,MAAM,CAAC,QAAQ,QAAQ;IACzB;IACA,MAAM,EACJ,MAAM,SACR;IACA,OAAO,EACL,OAAO;KACL,EACE,MAAM,iBACR;KACA,EACE,MAAM,OACR;KACA,EACE,MAAM,SACR;IACF,EACF;GACF;EACF;EACA,WAAW,EACT,MAAM,qCACR;EACA,WAAW,EACT,MAAM,qCACR;EACA,WAAW,EACT,MAAM,qCACR;CACF;CACA,sBAAsB;AACxB"}

package/dist/schemas/smsMessage.d.ts

@@ -34,6 +34,10 @@ export declare const smsMessageSchema: {
             readonly type: "string";
             readonly enum: readonly ["queued", "accepted", "sending", "sent", "failed", "delivered", "undelivered", "receiving", "received", "read"];
         };
+        readonly errorCode: {
+            readonly type: "string";
+            readonly description: "Raw vendor delivery-failure code, e.g. Twilio 21610.";
+        };
         readonly body: {
             readonly type: "string";
         };

package/dist/schemas/smsMessage.js

@@ -44,6 +44,10 @@ const smsMessageSchema = {
 				"read"
 			]
 		},
+		errorCode: {
+			type: "string",
+			description: "Raw vendor delivery-failure code, e.g. Twilio 21610."
+		},
 		body: { type: "string" },
 		driver: { type: "string" },
 		appData: { type: "object" },

package/dist/schemas/smsMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"smsMessage.js","names":[],"sources":["../../.generated/schemas/smsMessage.ts"],"sourcesContent":["import defs, { ISODateString } from \"./definitions\";\nimport type { FromSchema } from \"json-schema-to-ts\";\n\nexport const smsMessageSchema = {\n  $schema: \"http://json-schema.org/draft-07/schema\",\n  $id: \"smsMessage.json\",\n  title: \"Sms Message\",\n  type: \"object\",\n  required: [\"id\", \"type\", \"to\", \"from\", \"status\"],\n  additionalProperties: false,\n  properties: {\n    id: {\n      $ref: \"definitions.json#/definitions/id\",\n    },\n    propertyId: {\n      type: \"string\",\n      description: \"ID of the property this entity belongs to. Optional — used as a per-document filter inside the org-scoped database.\",\n    },\n    type: {\n      type: \"string\",\n      default: \"smsMessage\",\n      enum: [\"smsMessage\", \"whatsappMessage\"],\n    },\n    to: {\n      type: \"string\",\n    },\n    from: {\n      type: \"string\",\n    },\n    media: {\n      type: \"string\",\n      format: \"uri\",\n    },\n    status: {\n      type: \"string\",\n      enum: [\n        \"queued\",\n        \"accepted\",\n        \"sending\",\n        \"sent\",\n        \"failed\",\n        \"delivered\",\n        \"undelivered\",\n        \"receiving\",\n        \"received\",\n        \"read\",\n      ],\n    },\n    body: {\n      type: \"string\",\n    },\n    driver: {\n      type: \"string\",\n    },\n    appData: {\n      type: \"object\",\n    },\n    createdAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    updatedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    deletedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    systemId: {\n      $ref: \"definitions.json#/definitions/systemId\",\n    },\n  },\n} as const;\n\nexport type SmsMessageSchema = FromSchema<\n  typeof smsMessageSchema,\n  {\n    references: [typeof defs];\n    deserialize: [\n      {\n        pattern: {\n          format: \"date-time\";\n        };\n        output: Date | ISODateString;\n      },\n    ];\n  }\n>;\n"],"mappings":";AAGA,MAAa,mBAAmB;CAC9B,SAAS;CACT,KAAK;CACL,OAAO;CACP,MAAM;CACN,UAAU;EAAC;EAAM;EAAQ;EAAM;EAAQ;CAAQ;CAC/C,sBAAsB;CACtB,YAAY;EACV,IAAI,EACF,MAAM,mCACR;EACA,YAAY;GACV,MAAM;GACN,aAAa;EACf;EACA,MAAM;GACJ,MAAM;GACN,SAAS;GACT,MAAM,CAAC,cAAc,iBAAiB;EACxC;EACA,IAAI,EACF,MAAM,SACR;EACA,MAAM,EACJ,MAAM,SACR;EACA,OAAO;GACL,MAAM;GACN,QAAQ;EACV;EACA,QAAQ;GACN,MAAM;GACN,MAAM;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;GACF;EACF;EACA,MAAM,EACJ,MAAM,SACR;EACA,QAAQ,EACN,MAAM,SACR;EACA,SAAS,EACP,MAAM,SACR;EACA,WAAW,EACT,MAAM,qCACR;EACA,WAAW,EACT,MAAM,qCACR;EACA,WAAW,EACT,MAAM,qCACR;EACA,UAAU,EACR,MAAM,yCACR;CACF;AACF"}
+{"version":3,"file":"smsMessage.js","names":[],"sources":["../../.generated/schemas/smsMessage.ts"],"sourcesContent":["import defs, { ISODateString } from \"./definitions\";\nimport type { FromSchema } from \"json-schema-to-ts\";\n\nexport const smsMessageSchema = {\n  $schema: \"http://json-schema.org/draft-07/schema\",\n  $id: \"smsMessage.json\",\n  title: \"Sms Message\",\n  type: \"object\",\n  required: [\"id\", \"type\", \"to\", \"from\", \"status\"],\n  additionalProperties: false,\n  properties: {\n    id: {\n      $ref: \"definitions.json#/definitions/id\",\n    },\n    propertyId: {\n      type: \"string\",\n      description: \"ID of the property this entity belongs to. Optional — used as a per-document filter inside the org-scoped database.\",\n    },\n    type: {\n      type: \"string\",\n      default: \"smsMessage\",\n      enum: [\"smsMessage\", \"whatsappMessage\"],\n    },\n    to: {\n      type: \"string\",\n    },\n    from: {\n      type: \"string\",\n    },\n    media: {\n      type: \"string\",\n      format: \"uri\",\n    },\n    status: {\n      type: \"string\",\n      enum: [\n        \"queued\",\n        \"accepted\",\n        \"sending\",\n        \"sent\",\n        \"failed\",\n        \"delivered\",\n        \"undelivered\",\n        \"receiving\",\n        \"received\",\n        \"read\",\n      ],\n    },\n    errorCode: {\n      type: \"string\",\n      description: \"Raw vendor delivery-failure code, e.g. Twilio 21610.\",\n    },\n    body: {\n      type: \"string\",\n    },\n    driver: {\n      type: \"string\",\n    },\n    appData: {\n      type: \"object\",\n    },\n    createdAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    updatedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    deletedAt: {\n      $ref: \"definitions.json#/definitions/date\",\n    },\n    systemId: {\n      $ref: \"definitions.json#/definitions/systemId\",\n    },\n  },\n} as const;\n\nexport type SmsMessageSchema = FromSchema<\n  typeof smsMessageSchema,\n  {\n    references: [typeof defs];\n    deserialize: [\n      {\n        pattern: {\n          format: \"date-time\";\n        };\n        output: Date | ISODateString;\n      },\n    ];\n  }\n>;\n"],"mappings":";AAGA,MAAa,mBAAmB;CAC9B,SAAS;CACT,KAAK;CACL,OAAO;CACP,MAAM;CACN,UAAU;EAAC;EAAM;EAAQ;EAAM;EAAQ;CAAQ;CAC/C,sBAAsB;CACtB,YAAY;EACV,IAAI,EACF,MAAM,mCACR;EACA,YAAY;GACV,MAAM;GACN,aAAa;EACf;EACA,MAAM;GACJ,MAAM;GACN,SAAS;GACT,MAAM,CAAC,cAAc,iBAAiB;EACxC;EACA,IAAI,EACF,MAAM,SACR;EACA,MAAM,EACJ,MAAM,SACR;EACA,OAAO;GACL,MAAM;GACN,QAAQ;EACV;EACA,QAAQ;GACN,MAAM;GACN,MAAM;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;GACF;EACF;EACA,WAAW;GACT,MAAM;GACN,aAAa;EACf;EACA,MAAM,EACJ,MAAM,SACR;EACA,QAAQ,EACN,MAAM,SACR;EACA,SAAS,EACP,MAAM,SACR;EACA,WAAW,EACT,MAAM,qCACR;EACA,WAAW,EACT,MAAM,qCACR;EACA,WAAW,EACT,MAAM,qCACR;EACA,UAAU,EACR,MAAM,yCACR;CACF;AACF"}

package/dist/schemas/sosEvent.d.ts

@@ -0,0 +1,318 @@
+import defs, { ISODateString } from "./definitions.js";
+import type { FromSchema } from "json-schema-to-ts";
+export declare const sosEventSchema: {
+    readonly $schema: "http://json-schema.org/draft-07/schema";
+    readonly $id: "sosEvent.json";
+    readonly title: "SOS Event";
+    readonly description: "A durable record of a single SOS activation on a Property, with an append-only timeline of updates. Persists as audit history after the SOS is cleared.";
+    readonly type: "object";
+    readonly required: readonly ["id", "type", "sosTypeIds", "activatedAt", "timeline"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly id: {
+            readonly $ref: "definitions.json#/definitions/id";
+            readonly description: "Unique identifier for the SOS Event.";
+        };
+        readonly type: {
+            readonly type: "string";
+            readonly enum: readonly ["sosEvent"];
+            readonly default: "sosEvent";
+        };
+        readonly propertyId: {
+            readonly type: "string";
+            readonly description: "ID of the Property this SOS was raised on. Used as a per-document filter inside the org-scoped database.";
+        };
+        readonly sosTypeIds: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "The SOS Type ids this event was raised for.";
+        };
+        readonly activatedAt: {
+            readonly $ref: "definitions.json#/definitions/date";
+            readonly description: "When the SOS was raised.";
+        };
+        readonly activatedBy: {
+            readonly type: readonly ["object", "null"];
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "discriminator"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                };
+                readonly discriminator: {
+                    readonly type: "string";
+                    readonly enum: readonly ["user", "device", "automation"];
+                };
+            };
+            readonly description: "Actor that raised the SOS (user, device, or automation); null when unattributed.";
+        };
+        readonly deactivatedAt: {
+            readonly $ref: "definitions.json#/definitions/date";
+            readonly description: "When the SOS was cleared. Absent while the event is active.";
+        };
+        readonly deactivatedBy: {
+            readonly type: readonly ["object", "null"];
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "discriminator"];
+            readonly properties: {
+                readonly id: {
+                    readonly type: "string";
+                };
+                readonly discriminator: {
+                    readonly type: "string";
+                    readonly enum: readonly ["user", "device", "automation"];
+                };
+            };
+            readonly description: "Actor that cleared the SOS; null when unattributed. Absent while the event is active.";
+        };
+        readonly timeline: {
+            readonly type: "array";
+            readonly default: readonly [];
+            readonly description: "Append-only timeline. The first entry is the `activation`; later entries are operator `update`s, automation runs, and a closing `final`.";
+            readonly items: {
+                readonly oneOf: readonly [{
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["id", "type", "message", "by", "at", "audience"];
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                            readonly description: "Unique identifier for the timeline entry.";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["activation", "update", "final"];
+                            readonly description: "`activation` opens the event, `update` is an interim message, `final` closes it.";
+                        };
+                        readonly message: {
+                            readonly type: "string";
+                            readonly description: "The entry's message body. May be empty for entries that carry only audience/delivery intent.";
+                        };
+                        readonly by: {
+                            readonly type: readonly ["object", "null"];
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["id", "discriminator"];
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "string";
+                                };
+                                readonly discriminator: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["user", "device", "automation"];
+                                };
+                            };
+                            readonly description: "Actor that authored the entry; null when unattributed.";
+                        };
+                        readonly at: {
+                            readonly $ref: "definitions.json#/definitions/date";
+                            readonly description: "When the entry was recorded.";
+                        };
+                        readonly audience: {
+                            readonly $ref: "definitions.json#/definitions/audience";
+                            readonly description: "Who this entry was directed at, and who it resolved to. `activation` and `final` entries always carry the everyone wildcard — neither is narrowable.";
+                        };
+                        readonly deliveryStatus: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly description: "Computed on demand by DescribeSOSEvent (not persisted): live per-audience, per-channel outcome counts grouped from the sms/email collections by appData.sosUpdateId × status. Absent on the returned event until at least one matching message exists; only audiences/channels with data are present.";
+                            readonly properties: {
+                                readonly internal: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly description: "Per-channel live outcomes for one audience.";
+                                    readonly properties: {
+                                        readonly sms: {
+                                            readonly type: "object";
+                                            readonly additionalProperties: false;
+                                            readonly required: readonly ["sent", "delivered", "failed"];
+                                            readonly properties: {
+                                                readonly sent: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                                readonly delivered: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                                readonly failed: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                            };
+                                        };
+                                        readonly email: {
+                                            readonly type: "object";
+                                            readonly additionalProperties: false;
+                                            readonly required: readonly ["sent", "delivered", "failed"];
+                                            readonly properties: {
+                                                readonly sent: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                                readonly delivered: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                                readonly failed: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                            };
+                                        };
+                                    };
+                                };
+                                readonly emergencyContacts: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly description: "Per-channel live outcomes for one audience.";
+                                    readonly properties: {
+                                        readonly sms: {
+                                            readonly type: "object";
+                                            readonly additionalProperties: false;
+                                            readonly required: readonly ["sent", "delivered", "failed"];
+                                            readonly properties: {
+                                                readonly sent: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                                readonly delivered: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                                readonly failed: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                            };
+                                        };
+                                        readonly email: {
+                                            readonly type: "object";
+                                            readonly additionalProperties: false;
+                                            readonly required: readonly ["sent", "delivered", "failed"];
+                                            readonly properties: {
+                                                readonly sent: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                                readonly delivered: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                                readonly failed: {
+                                                    readonly type: "integer";
+                                                    readonly minimum: 0;
+                                                };
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                }, {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["id", "type", "at", "by", "automationName", "runId", "trigger", "actions"];
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                            readonly description: "Unique identifier for the timeline entry.";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["automationRun"];
+                            readonly description: "Discriminator: an automation that ran in response to this SOS.";
+                        };
+                        readonly at: {
+                            readonly $ref: "definitions.json#/definitions/date";
+                            readonly description: "When the run started. The entry is stamped with pending actions up front and settled in place.";
+                        };
+                        readonly by: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["id", "discriminator"];
+                            readonly description: "The Automation that ran. Its id is the automation's id — there is no separate automationId.";
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "string";
+                                };
+                                readonly discriminator: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["automation"];
+                                };
+                            };
+                        };
+                        readonly automationName: {
+                            readonly type: "string";
+                            readonly description: "The automation's name snapshotted at run time, so a later rename or delete leaves the timeline readable.";
+                        };
+                        readonly runId: {
+                            readonly type: "string";
+                            readonly description: "Groups this run's Activity records; one event matching several automations yields one runId each.";
+                        };
+                        readonly trigger: {
+                            readonly type: "string";
+                            readonly enum: readonly ["SOSActive", "SOSInactive"];
+                            readonly description: "The SOS event type that matched the automation's trigger.";
+                        };
+                        readonly actions: {
+                            readonly type: "array";
+                            readonly default: readonly [];
+                            readonly description: "Per-action outcome, in the automation's action order.";
+                            readonly items: {
+                                readonly type: "object";
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["type", "status"];
+                                readonly properties: {
+                                    readonly type: {
+                                        readonly type: "string";
+                                        readonly description: "The use case the automation action invoked.";
+                                    };
+                                    readonly status: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["pending", "success", "failure"];
+                                        readonly description: "`pending` while the action is in flight; settles to `success` or `failure`.";
+                                    };
+                                    readonly error: {
+                                        readonly type: readonly ["string", "null"];
+                                        readonly description: "Failure message; absent when the action succeeded.";
+                                    };
+                                    readonly params: {
+                                        readonly type: "object";
+                                        readonly description: "Pruned snapshot of the action's configured params (e.g. SetDevices device states, StartSOS type ids), enough to render a human summary of what the action did. Absent when the use case has no summarizable params.";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                }];
+            };
+        };
+        readonly createdAt: {
+            readonly $ref: "definitions.json#/definitions/date";
+            readonly description: "When the SOS Event was created.";
+        };
+        readonly updatedAt: {
+            readonly $ref: "definitions.json#/definitions/date";
+            readonly description: "When the SOS Event was last modified.";
+        };
+        readonly deletedAt: {
+            readonly type: readonly ["string", "object", "null"];
+            readonly format: "date-time";
+            readonly description: "Soft-delete tombstone.";
+        };
+    };
+};
+export type SOSEventSchema = FromSchema<typeof sosEventSchema, {
+    references: [typeof defs];
+    deserialize: [
+        {
+            pattern: {
+                format: "date-time";
+            };
+            output: Date | ISODateString;
+        }
+    ];
+}>;