@kottera/tera-web 0.0.0-stage → 0.1.0-rc.10

package/dist/generated/kit.js

@@ -0,0 +1,258 @@
+// Code generated by cmd/internal/genwebtypes from sdk/plugin/webui/schema/v1/; DO NOT EDIT.
+// Regenerate with `make web-types` (ADR-162 D4 item 1).
+/**
+ * Every type this module declares, mapped to the repository path of the schema
+ * it was generated from.
+ */
+export const KIT_SCHEMAS = {
+    KitErrorCode: "sdk/plugin/webui/schema/v1/error-code.json",
+    KitError: "sdk/plugin/webui/schema/v1/error.json",
+    KitFeedEventReauthenticate: "sdk/plugin/webui/schema/v1/feed.event.reauthenticate.json",
+    KitInvokeResponse: "sdk/plugin/webui/schema/v1/invoke.response.json",
+    KitMeResponse: "sdk/plugin/webui/schema/v1/me.response.json",
+    KitStepUpResponse: "sdk/plugin/webui/schema/v1/step-up.response.json",
+    KitUploadResponse: "sdk/plugin/webui/schema/v1/upload.response.json",
+};
+/** The prefix every kit route is served under (ADR-162 D3), below the app's base. */
+export const KIT_ROUTE_PREFIX = "/tera/v1/";
+/** tera's own sign-out path, which `GET /tera/v1/me` answers as signout_path: relative, resolved against the app's base. */
+export const KIT_SIGNOUT_PATH = "_tera/signout";
+/** tera's proxy's phone path, which `GET /tera/v1/me` answers as phone_path: relative, resolved against the app's base. */
+export const KIT_PHONE_PATH = "_tera/phone";
+/** The kit's route table (ADR-162 D3), as sdk/plugin/webui declares it. */
+export const KIT_ROUTE_TABLE = {
+    prefix: "/tera/v1/",
+    signout_path: "_tera/signout",
+    phone_path: "_tera/phone",
+    same_origin: "A route marked same_origin refuses a request unless it is same-origin: when the request carries Sec-Fetch-Site, that header must be same-origin; when it does not, its Origin must equal the request's own (scheme http or https, and the Host the request was sent to). The refusal is 403 cross_origin.",
+    public: "None. Every route under the prefix refuses a request with no verified caller, 401 unauthenticated, before anything else is decided. Only the app's assets, outside the prefix, are served to an anonymous request.",
+    error: {
+        media_type: "application/json",
+        schema: "https://kottera.dev/schemas/plugin/webui/error/v1",
+        description: "Every failure of every route: the kit's own refusal, under one of the error-code vocabulary, or a verb's refusal passed through as the verb gave it.",
+    },
+    routes: [
+        {
+            name: "me",
+            method: "GET",
+            path: "/tera/v1/me",
+            summary: "Who is signed in, where to send them to sign out, and where to send them to open a page on their phone.",
+            same_origin: false,
+            response: {
+                media_type: "application/json",
+                schema: "https://kottera.dev/schemas/plugin/webui/me.response/v1",
+                description: "The signed-in person.",
+            },
+        },
+        {
+            name: "invoke",
+            method: "POST",
+            path: "/tera/v1/invoke/{capability}",
+            summary: "Invoke one capability as the person, with the request body as its params. tera decides it on the person's token; the kit vets nothing.",
+            same_origin: true,
+            path_params: [
+                {
+                    name: "capability",
+                    description: "The capability to invoke, e.g. work_order.get.",
+                    required: true,
+                },
+            ],
+            request: {
+                media_type: "application/json",
+                description: "The capability's params. For a work_order.* verb, valid against sdk/workorder/schema/v1/<verb>.params.json.",
+            },
+            response: {
+                media_type: "application/json",
+                schema: "https://kottera.dev/schemas/plugin/webui/invoke.response/v1",
+                description: "The verb's reply envelope, HTTP 200 whenever the verb ran, refusals included.",
+            },
+        },
+        {
+            name: "feed",
+            method: "GET",
+            path: "/tera/v1/feeds/{feed}",
+            summary: "Open a feed as the person: server-sent events carrying feed records and status frames verbatim.",
+            same_origin: false,
+            path_params: [
+                {
+                    name: "feed",
+                    description: "The feed's name.",
+                    required: true,
+                },
+            ],
+            query: [
+                {
+                    name: "topics",
+                    description: "Selects a subset of the topics the person may subscribe to; each occurrence may be a comma-separated list. Widening is refused.",
+                    repeated: true,
+                },
+                {
+                    name: "backfill",
+                    description: "Precede the live stream with the stored history of the run the connection selected.",
+                    values: [
+                        "all",
+                    ],
+                },
+            ],
+            response: {
+                media_type: "text/event-stream",
+                description: "A stream of the events below, until the person's token expires or either side closes it. Any other feed frame (a heartbeat, a batch, a type this kit does not know) is relayed verbatim as an unnamed event, read by its own type.",
+            },
+            events: [
+                {
+                    name: "record",
+                    schema: "https://kottera.dev/schemas/feed/frame.record/v1",
+                    description: "A feed record frame, verbatim.",
+                },
+                {
+                    name: "status",
+                    schema: "https://kottera.dev/schemas/feed/frame.status/v1",
+                    description: "A feed status frame, verbatim; loss is reported here and nowhere else.",
+                },
+                {
+                    name: "reauthenticate",
+                    schema: "https://kottera.dev/schemas/plugin/webui/feed.event.reauthenticate/v1",
+                    description: "The last event of a stream closed because the person's token expired. Reconnect at once.",
+                },
+            ],
+        },
+        {
+            name: "upload",
+            method: "POST",
+            path: "/tera/v1/uploads",
+            summary: "Upload one file as the person (ADR-123): the kit streams the body once, digesting it, then authorizes and stores it.",
+            same_origin: true,
+            headers: [
+                {
+                    name: "Content-Type",
+                    description: "The file's media type.",
+                    required: true,
+                },
+                {
+                    name: "Tera-Upload-Filename",
+                    description: "The file's name, percent-encoded UTF-8.",
+                    required: true,
+                },
+                {
+                    name: "Tera-Upload-Description",
+                    description: "A description of the file, percent-encoded UTF-8.",
+                },
+            ],
+            request: {
+                media_type: "application/octet-stream",
+                description: "The file's bytes, any media type. The body is read against its declared Content-Length, capped by the 33554432-byte (32 MiB) bound on an input artifact; a body with no declared length is held to the cap. A declaration over the cap is refused before the body is read, and a body is refused at the first byte past its bound, never after it is read whole.",
+            },
+            response: {
+                media_type: "application/json",
+                schema: "https://kottera.dev/schemas/plugin/webui/upload.response/v1",
+                description: "The staged artifact.",
+            },
+        },
+        {
+            name: "step_up",
+            method: "GET",
+            path: "/tera/v1/step-ups/{id}",
+            summary: "Read one of the person's own step-ups as the person (ADR-173 D11): what a page polls, after opening the step-up's url, until it is satisfied, declined or expired. A step-up that is not the person's is tera's 404, the same as an id no step-up carries.",
+            same_origin: false,
+            path_params: [
+                {
+                    name: "id",
+                    description: "The step-up's id, as a step_up_required refusal's step_up names it.",
+                    required: true,
+                },
+            ],
+            response: {
+                media_type: "application/json",
+                schema: "https://kottera.dev/schemas/plugin/webui/step-up.response/v1",
+                description: "The step-up's state.",
+            },
+        },
+        {
+            name: "terminal",
+            method: "GET",
+            path: "/tera/v1/workorders/{id}/terminal",
+            summary: "Open one view of an attended session's terminal as the person (ADR-181 D8): a WebSocket the kit splices to tera's terminal door, opened with the person's token. Which Work Order it is, and whether the person may see it, is tera's to decide; the kit keeps no list of sessions. Every refusal after the upgrade is a close: a query of the wrong shape is refused invalid_request; tera's 401 is reconnect, reason reauthenticate, and a second within the minute refused; its 400, 403 and 404 are refused with tera's code (not_attendee, attend_view_not_granted, not_found); its 410 is refused, reason ended, a session with no process and none coming without the person's act; its 409 (not_running, a session whose process is coming), 408, 429 and 5xx, and no answer, are retry_later with tera's code or tera_unavailable. A text message is refused binary_only.",
+            same_origin: true,
+            path_params: [
+                {
+                    name: "id",
+                    description: "The attended Work Order's id.",
+                    required: true,
+                },
+            ],
+            query: [
+                {
+                    name: "view",
+                    description: "The view's id: a canonical, lower-case UUIDv7 the page mints per pane and keeps across reconnects.",
+                    required: true,
+                },
+                {
+                    name: "want",
+                    description: "Whether the view asks to type (control), only to watch (view), or to watch without being counted as attached (peek).",
+                    required: true,
+                    values: [
+                        "control",
+                        "view",
+                        "peek",
+                    ],
+                },
+                {
+                    name: "resume",
+                    description: "The output offset the page has handed to its renderer so far, a decimal integer from 0 to 9007199254740991; absent on a fresh view, which replays.",
+                },
+                {
+                    name: "cols",
+                    description: "The view's width in cells, a decimal integer from 1 to 65535.",
+                    required: true,
+                },
+                {
+                    name: "rows",
+                    description: "The view's height in cells, a decimal integer from 1 to 65535.",
+                    required: true,
+                },
+            ],
+            response: {
+                media_type: "application/octet-stream",
+                description: "A WebSocket upgrade (101), then messages both ways until either side closes, with the close vocabulary.",
+            },
+            upgrade: "websocket",
+            subprotocol: "tera.terminalwire.v1",
+            messages: {
+                media_type: "application/octet-stream",
+                description: "One sdk/terminalwire frame per binary message, each way, at most 16388 bytes. The kit relays each as it arrived, reading no payload and redacting nothing.",
+            },
+        },
+    ],
+    close_codes: [
+        {
+            code: 1000,
+            name: "ended",
+            does: "what the protocol above said last; otherwise nothing",
+        },
+        {
+            code: 1001,
+            name: "going_away",
+            does: "reconnects after backoff: the peer is stopping or stopped answering pings",
+        },
+        {
+            code: 1009,
+            name: "too_big",
+            does: "nothing: a message broke the route's bound, a client defect",
+        },
+        {
+            code: 4000,
+            name: "reconnect",
+            does: "reconnects at once with the same identity: a token renewal",
+        },
+        {
+            code: 4001,
+            name: "retry_later",
+            does: "reconnects after backoff: the far side is unreachable or not ready",
+        },
+        {
+            code: 4003,
+            name: "refused",
+            does: "nothing until something changes; the reason is the error code",
+        },
+    ],
+};

package/dist/generated/shares.d.ts

@@ -0,0 +1,214 @@
+/**
+ * An ended share.
+ *
+ * The result of api.v1.shares.delete and api.v1.shares.leave: what the act ended. An ended share decides nothing and is not listed.
+ *
+ * Schema: sdk/shares/schema/v1/ended.json
+ */
+export type SharesEnded = {
+    /** The ended share's id. */
+    id: string;
+    /** The installation whose resource was shared, <vault>/plugins/<installation>. */
+    installation: string;
+    /** The resource that was shared. */
+    resource: string;
+    /** The grantee person's id. */
+    grantee: string;
+    /** The sharer person's id. */
+    sharer: string;
+    /** How the share ended, as its record holds it: revoked or left. */
+    ended: "revoked" | "left";
+};
+/**
+ * Extend a share.
+ *
+ * The params of api.v1.shares.patch, PATCH /api/v1/shares/{id} (ADR-174 D11).
+ *
+ * Schema: sdk/shares/schema/v1/extend.request.json
+ */
+export type SharesExtendRequest = {
+    /** The share's id, a UUIDv7. */
+    id: string;
+    /** The new expiry: later than the share's, at most the installation's max_expiry from now. Absent takes the kind's default_expiry from now, clamped to max_expiry. */
+    expires_at?: string;
+};
+/**
+ * Name one share.
+ *
+ * The params of api.v1.shares.get, api.v1.shares.delete and api.v1.shares.leave: the {id} of /api/v1/shares/{id}.
+ *
+ * Schema: sdk/shares/schema/v1/id.request.json
+ */
+export type SharesIdRequest = {
+    /** The share's id, a UUIDv7. */
+    id: string;
+};
+/**
+ * A list of shares.
+ *
+ * The result of api.v1.shares.list.
+ *
+ * Schema: sdk/shares/schema/v1/list.json
+ */
+export type SharesList = {
+    /** The shares, each with whether it decides now. */
+    shares: {
+        /** The share's id, a UUIDv7. */
+        id: string;
+        /** The installation whose resource is shared, <vault>/plugins/<installation>. */
+        installation: string;
+        /** The resource shared, plugins/<vault>/<installation>/<kind>/<id>. */
+        resource: string;
+        /** The shared verbs. */
+        verbs: string[] | null;
+        /** What the grantee is: person. */
+        grantee_kind: string;
+        /** The grantee person's id. */
+        grantee: string;
+        /** The id of the person who made the share. */
+        sharer: string;
+        /** The grantee person's display name. Presentation only: grantee stays the identity. Absent when tera has no name to show: a pending invitation has none, the directory has no person for the id, or the read failed. Render the name, else the address, else Someone; never the principal id. */
+        grantee_name?: string;
+        /** The grantee person's address, or a pending share's invitation address. Presentation only: grantee stays the identity. Absent when tera has no address to show: the directory has no person for the id, or the read failed. */
+        grantee_address?: string;
+        /** The sharer's display name. Presentation only: sharer stays the identity. Absent when tera has no name to show: the directory has no person for the id, or the read failed. Render the name, else the address, else Someone; never the principal id. */
+        sharer_name?: string;
+        /** The sharer's address. Presentation only: sharer stays the identity. Absent when tera has no address to show: the directory has no person for the id, or the read failed. */
+        sharer_address?: string;
+        /** The plugin principal that made the share for its sharer; absent when the sharer made it directly. */
+        created_via?: string;
+        /** When the share was made. */
+        created_at: string;
+        /** When the share stops deciding. */
+        expires_at: string;
+        /** When the share was last extended; absent if never. */
+        extended_at?: string;
+        /** Whether the share decides at least one of its verbs on the grantee's next request, computed from what decides now. */
+        deciding: boolean;
+        /** When deciding is false, the one reason why. Absent while the share decides. */
+        not_deciding?: "sharer_lost_access" | "sharing_disabled" | "installation_not_standing" | "verb_no_longer_shareable" | "pending_invitation";
+    }[] | null;
+};
+/**
+ * List shares.
+ *
+ * The params of api.v1.shares.list, the query of GET /api/v1/shares. At most one member is named; with none, the caller's own live shares as grantee and as sharer.
+ *
+ * Schema: sdk/shares/schema/v1/list.request.json
+ */
+export type SharesListRequest = {
+    /** An installation, <vault>/plugins/<name>: every share on it. Needs the shares admin grant (api/v1/shares/admin). */
+    installation?: string;
+    /** One resource, plugins/<vault>/<installation>/<kind>/<id>: every share on it when the caller's own grants include its share-conferring verb, else the caller's own shares on it. */
+    resource?: string;
+    /** A grantee's person id; someone else's needs the shares admin grant. */
+    grantee?: string;
+    /** A sharer's person id; someone else's needs the shares admin grant. */
+    sharer?: string;
+};
+/**
+ * Make a share.
+ *
+ * The params of api.v1.shares.create, the body of POST /api/v1/shares (ADR-174 D6).
+ *
+ * Schema: sdk/shares/schema/v1/make.request.json
+ */
+export type SharesMakeRequest = {
+    /** The one resource shared, plugins/<vault>/<installation>/<kind>/<id>. */
+    resource: string;
+    /** The shared verbs: a non-empty subset of the kind's sharing { verbs }, never its share-conferring verb. */
+    verbs: string[];
+    /** The grantee person's id. Exactly one of grantee and grantee_address names the grantee. */
+    grantee?: string;
+    /** An email address the directory resolves to the grantee. An address no person holds is invited, and the share is pending until they sign in, on a kind whose effective grantee class is addresses; otherwise it is refused share_grantee_not_admitted. */
+    grantee_address?: string;
+    /** The share's expiry, at most the installation's max_expiry from now. Absent takes the kind's default_expiry, clamped to max_expiry. */
+    expires_at?: string;
+};
+/**
+ * The vocabulary of the share acts' refusal codes (sdk/shares.Codes).
+ *
+ * Every stable code a share act is refused with. A code is never renamed; a new refusal is a new code, so a reader keeps a code it does not know as it arrived. share_not_found answers a share the caller may not see exactly as an id no share has. share_grantee_not_admitted answers an address no person holds on a kind whose effective grantee class is not addresses; on one that is, the address is invited and the share is pending until the invitee signs in.
+ *
+ * Schema: sdk/shares/schema/v1/refusal-code.json
+ */
+export type SharesRefusalCode = "share_sharer_not_a_person" | "share_sharing_disabled" | "share_resource_not_shareable" | "share_resource_unknown" | "share_actor_other_installation" | "share_verb_not_shareable" | "share_verb_confers_sharing" | "share_verb_not_held" | "share_grantee_not_admitted" | "share_guest_cannot_invite" | "share_invitation_refused" | "share_grantee_is_sharer" | "share_expiry_beyond_max" | "share_cap_active" | "share_cap_pending_invitations" | "share_exists" | "share_plugin_only" | "share_caller_not_a_person" | "share_not_found" | "share_sharer_lost_access" | "share_expiry_not_later" | "share_admin_required" | "share_list_query" | "shares_unavailable";
+/**
+ * A share act refused.
+ *
+ * A share act tera refused, as the shares client answers it: the route's stable code and its words, unchanged, and the detail the code declares.
+ *
+ * Schema: sdk/shares/schema/v1/refusal.json
+ */
+export type SharesRefusal = {
+    /** The route's stable code. A code a reader does not know is kept as it arrived. */
+    code: string;
+    /** The route's words for a person, unchanged. */
+    message: string;
+    /** On share_verb_not_held, share_verb_not_shareable and share_verb_confers_sharing, the verb refused. */
+    verb?: string;
+    /** On share_exists, the id of the share already there. */
+    existing?: string;
+    /** On share_invitation_refused, why the address was not invited (inviter_limited, email_unavailable, ...). */
+    invitation?: string;
+    /** On share_plugin_only, the installation's name: the plugin the share is made or extended through. */
+    plugin?: string;
+};
+/**
+ * A share.
+ *
+ * One live share, with whether it decides now: the result of api.v1.shares.create, api.v1.shares.get and api.v1.shares.patch, and each member of a list (ADR-174 D14).
+ *
+ * Schema: sdk/shares/schema/v1/share.json
+ */
+export type SharesShare = {
+    /** The share's id, a UUIDv7. */
+    id: string;
+    /** The installation whose resource is shared, <vault>/plugins/<installation>. */
+    installation: string;
+    /** The resource shared, plugins/<vault>/<installation>/<kind>/<id>. */
+    resource: string;
+    /** The shared verbs. */
+    verbs: string[] | null;
+    /** What the grantee is: person. */
+    grantee_kind: string;
+    /** The grantee person's id. */
+    grantee: string;
+    /** The id of the person who made the share. */
+    sharer: string;
+    /** The grantee person's display name. Presentation only: grantee stays the identity. Absent when tera has no name to show: a pending invitation has none, the directory has no person for the id, or the read failed. Render the name, else the address, else Someone; never the principal id. */
+    grantee_name?: string;
+    /** The grantee person's address, or a pending share's invitation address. Presentation only: grantee stays the identity. Absent when tera has no address to show: the directory has no person for the id, or the read failed. */
+    grantee_address?: string;
+    /** The sharer's display name. Presentation only: sharer stays the identity. Absent when tera has no name to show: the directory has no person for the id, or the read failed. Render the name, else the address, else Someone; never the principal id. */
+    sharer_name?: string;
+    /** The sharer's address. Presentation only: sharer stays the identity. Absent when tera has no address to show: the directory has no person for the id, or the read failed. */
+    sharer_address?: string;
+    /** The plugin principal that made the share for its sharer; absent when the sharer made it directly. */
+    created_via?: string;
+    /** When the share was made. */
+    created_at: string;
+    /** When the share stops deciding. */
+    expires_at: string;
+    /** When the share was last extended; absent if never. */
+    extended_at?: string;
+    /** Whether the share decides at least one of its verbs on the grantee's next request, computed from what decides now. */
+    deciding: boolean;
+    /** When deciding is false, the one reason why. Absent while the share decides. */
+    not_deciding?: "sharer_lost_access" | "sharing_disabled" | "installation_not_standing" | "verb_no_longer_shareable" | "pending_invitation";
+};
+/**
+ * Every type this module declares, mapped to the repository path of the schema
+ * it was generated from.
+ */
+export declare const SHARES_SCHEMAS: {
+    readonly SharesEnded: "sdk/shares/schema/v1/ended.json";
+    readonly SharesExtendRequest: "sdk/shares/schema/v1/extend.request.json";
+    readonly SharesIdRequest: "sdk/shares/schema/v1/id.request.json";
+    readonly SharesList: "sdk/shares/schema/v1/list.json";
+    readonly SharesListRequest: "sdk/shares/schema/v1/list.request.json";
+    readonly SharesMakeRequest: "sdk/shares/schema/v1/make.request.json";
+    readonly SharesRefusalCode: "sdk/shares/schema/v1/refusal-code.json";
+    readonly SharesRefusal: "sdk/shares/schema/v1/refusal.json";
+    readonly SharesShare: "sdk/shares/schema/v1/share.json";
+};

package/dist/generated/shares.js

@@ -0,0 +1,17 @@
+// Code generated by cmd/internal/genwebtypes from sdk/shares/schema/v1/; DO NOT EDIT.
+// Regenerate with `make web-types` (ADR-162 D4 item 1).
+/**
+ * Every type this module declares, mapped to the repository path of the schema
+ * it was generated from.
+ */
+export const SHARES_SCHEMAS = {
+    SharesEnded: "sdk/shares/schema/v1/ended.json",
+    SharesExtendRequest: "sdk/shares/schema/v1/extend.request.json",
+    SharesIdRequest: "sdk/shares/schema/v1/id.request.json",
+    SharesList: "sdk/shares/schema/v1/list.json",
+    SharesListRequest: "sdk/shares/schema/v1/list.request.json",
+    SharesMakeRequest: "sdk/shares/schema/v1/make.request.json",
+    SharesRefusalCode: "sdk/shares/schema/v1/refusal-code.json",
+    SharesRefusal: "sdk/shares/schema/v1/refusal.json",
+    SharesShare: "sdk/shares/schema/v1/share.json",
+};

package/dist/generated/workorder-events.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The vocabulary of the event types within the `workorder` payload.
+ *
+ * Every member the daemon writes. A later level adds members and removes none (ADR-143 D3); how a consumer reads an unknown member is ADR-143 D13's.
+ *
+ * Schema: sdk/workorder/schema/events/v1/event-kind.workorder.json
+ */
+export type WorkOrderEventKind = "cohort.set" | "off_tera.wake" | "relation.set" | "relation.removed" | "off_tera.taken" | "off_tera.progress" | "off_tera.reposted" | "off_tera.late_report" | "off_tera.checks_started" | "created" | "transitioned" | "acknowledged" | "retention_expired" | "edited" | "seat.reclaimed" | "claim.overdue" | "claim.unreadable" | "subject_claim.overridden" | "seat.cooling" | "seat.credential_held" | "member_credential.requested" | "member_credential.settled" | "seat.acquired" | "seat.runner_released" | "seat.meters_voided" | "step.binding" | "session.terminated" | "postcondition.verdict" | "parked_run.unreadable" | "parked_run.reclaimed" | "dispatch.settled_unobserved" | "parked_run.parked" | "parked_run.resumed" | "resume.refused" | "dispatch.salvaged" | "workspace.retired" | "dispatch.routed" | "session.lost" | "activity_partition.pinned" | "session.continuity" | "session.context_compacted" | "upstream.answer_forwarded" | "invocation.checkpoint" | "invocation.guidance" | "invocation.guidance.ack" | "invocation.reply" | "invocation.checkpoint.unreadable" | "invocation.guidance.unreadable" | "config_pin.unreadable" | "config_pin.repinned" | "type.followed" | "observation.scrubbed" | "observation.secret-shape-redacted" | "observation.promoted" | "observation.refuted" | "observation.purged" | "conversation.input_barrier" | "walk_resume.fell_back" | "store.ahead_of_binary" | "artifact.published" | "history.dropped" | "history.archived" | "seat.work_order_released" | "step.settled_late" | "step.reattached" | "relay.unrebuilt" | "references.recorded" | "attended.wall_reported" | "attended.signal" | "attended.attached" | "attended.detached" | "attended.handed_over" | "attended.handover_stranded";
+/**
+ * `workorder` event payload (event/workorder).
+ *
+ * The payload published on every topic of the `workorder` family, generated from github.com/kottera/sdk/workorder.Envelope.
+ *
+ * Schema: sdk/workorder/schema/events/v1/payload.workorder.json
+ */
+export type WorkOrderEventPayload = {
+    /** The event row's primary key: monotonic across every Work Order, and the replay cursor (ADR-078 D3). */
+    id: number;
+    /** The owning Work Order's UUIDv7. */
+    work_order_id: string;
+    /** The owning Work Order's namespaced type key (<vault>/work-order-types/<stem>); absent only on an event with no Work Order row (ADR-142 D3). */
+    work_order_type?: string;
+    /** The event timestamp, RFC 3339 with nanosecond precision, UTC. */
+    ts: string;
+    /** Who caused the event, as stored. The shape written is an EventActor; a row written before a field existed lacks that key. */
+    actor?: unknown;
+    /** The event's type within the family; a member of the event-kind vocabulary, and a value this version does not know is kept verbatim (ADR-143 D13). */
+    kind: string;
+    /** The state before the transition; absent on created. */
+    from_state?: string;
+    /** The state after the transition. */
+    to_state?: string;
+    /** The optional human-readable reason for the transition. */
+    reason?: string;
+    /** The per-event payload as stored, whose shape the event kind decides. */
+    payload?: unknown;
+    /** The persisted-schema marker of the envelope. */
+    schema_version: string;
+};
+/**
+ * Every type this module declares, mapped to the repository path of the schema
+ * it was generated from.
+ */
+export declare const WORK_ORDER_EVENT_SCHEMAS: {
+    readonly WorkOrderEventKind: "sdk/workorder/schema/events/v1/event-kind.workorder.json";
+    readonly WorkOrderEventPayload: "sdk/workorder/schema/events/v1/payload.workorder.json";
+};

package/dist/generated/workorder-events.js

@@ -0,0 +1,10 @@
+// Code generated by cmd/internal/genwebtypes from sdk/workorder/schema/events/v1/; DO NOT EDIT.
+// Regenerate with `make web-types` (ADR-162 D4 item 1).
+/**
+ * Every type this module declares, mapped to the repository path of the schema
+ * it was generated from.
+ */
+export const WORK_ORDER_EVENT_SCHEMAS = {
+    WorkOrderEventKind: "sdk/workorder/schema/events/v1/event-kind.workorder.json",
+    WorkOrderEventPayload: "sdk/workorder/schema/events/v1/payload.workorder.json",
+};