@typespec/events 0.60.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,120 @@
+# @typespec/events
+
+TypeSpec library providing events bindings
+
+## Install
+
+```bash
+npm install @typespec/events
+```
+
+## Decorators
+
+### TypeSpec.Events
+
+- [`@contentType`](#@contenttype)
+- [`@data`](#@data)
+- [`@events`](#@events)
+
+#### `@contentType`
+
+Specifies the content type of the event envelope, event body, or event payload.
+When applied to an event payload, that field must also have a corresponding `@data`
+decorator.
+
+```typespec
+@TypeSpec.Events.contentType(contentType: valueof string)
+```
+
+##### Target
+
+`UnionVariant | ModelProperty`
+
+##### Parameters
+
+| Name        | Type             | Description |
+| ----------- | ---------------- | ----------- |
+| contentType | `valueof string` |             |
+
+##### Examples
+
+```typespec
+@events
+union MixedEvents {
+  @contentType("application/json")
+  message: {
+    id: string,
+    text: string,
+  },
+}
+```
+
+###### Specify the content type of the event payload.
+
+```typespec
+@events
+union MixedEvents {
+  {
+    done: true,
+  },
+  {
+    done: false,
+    @data @contentType("text/plain") value: string,
+  },
+}
+```
+
+#### `@data`
+
+Identifies the payload of an event.
+Only one field in an event can be marked as the payload.
+
+```typespec
+@TypeSpec.Events.data
+```
+
+##### Target
+
+`ModelProperty`
+
+##### Parameters
+
+None
+
+##### Examples
+
+```typespec
+@events
+union MixedEvents {
+  {
+    metadata: Record<string>,
+    @data payload: string,
+  },
+}
+```
+
+#### `@events`
+
+Specify that this union describes a set of events.
+
+```typespec
+@TypeSpec.Events.events
+```
+
+##### Target
+
+`Union`
+
+##### Parameters
+
+None
+
+##### Examples
+
+```typespec
+@events
+union MixedEvents {
+  pingEvent: string,
+  doneEvent: "done",
+}
+```

package/dist/generated-defs/TypeSpec.Events.d.ts

@@ -0,0 +1,56 @@
+import type { DecoratorContext, ModelProperty, Union, UnionVariant } from "@typespec/compiler";
+/**
+ * Specify that this union describes a set of events.
+ *
+ * @example
+ * ```typespec
+ * @events
+ * union MixedEvents {
+ *   pingEvent: string;
+ *
+ *   doneEvent: "done";
+ * }
+ * ```
+ */
+export type EventsDecorator = (context: DecoratorContext, target: Union) => void;
+/**
+ * Specifies the content type of the event envelope, event body, or event payload.
+ * When applied to an event payload, that field must also have a corresponding `@data`
+ * decorator.
+ *
+ * @example
+ * ```typespec
+ * @events union MixedEvents {
+ *   @contentType("application/json")
+ *   message: { id: string, text: string, }
+ * }
+ * ```
+ * @example Specify the content type of the event payload.
+ *
+ * ```typespec
+ * @events union MixedEvents {
+ *   { done: true },
+ *
+ *   { done: false, @data @contentType("text/plain") value: string,}
+ * }
+ * ```
+ */
+export type ContentTypeDecorator = (context: DecoratorContext, target: UnionVariant | ModelProperty, contentType: string) => void;
+/**
+ * Identifies the payload of an event.
+ * Only one field in an event can be marked as the payload.
+ *
+ * @example
+ * ```typespec
+ * @events union MixedEvents {
+ *   { metadata: Record<string>, @data payload: string,}
+ * }
+ * ```
+ */
+export type DataDecorator = (context: DecoratorContext, target: ModelProperty) => void;
+export type TypeSpecEventsDecorators = {
+    events: EventsDecorator;
+    contentType: ContentTypeDecorator;
+    data: DataDecorator;
+};
+//# sourceMappingURL=TypeSpec.Events.d.ts.map

package/dist/generated-defs/TypeSpec.Events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeSpec.Events.d.ts","sourceRoot":"","sources":["../../generated-defs/TypeSpec.Events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE/F;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,YAAY,GAAG,aAAa,EACpC,WAAW,EAAE,MAAM,KAChB,IAAI,CAAC;AAEV;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;AAEvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,oBAAoB,CAAC;IAClC,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC"}

package/dist/generated-defs/TypeSpec.Events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TypeSpec.Events.js.map

package/dist/generated-defs/TypeSpec.Events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeSpec.Events.js","sourceRoot":"","sources":["../../generated-defs/TypeSpec.Events.ts"],"names":[],"mappings":""}

package/dist/generated-defs/TypeSpec.Events.ts-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TypeSpec.Events.ts-test.d.ts.map

package/dist/generated-defs/TypeSpec.Events.ts-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeSpec.Events.ts-test.d.ts","sourceRoot":"","sources":["../../generated-defs/TypeSpec.Events.ts-test.ts"],"names":[],"mappings":""}

package/dist/generated-defs/TypeSpec.Events.ts-test.js

@@ -0,0 +1,5 @@
+/** An error here would mean that the decorator is not exported or doesn't have the right name. */
+import { $decorators } from "@typespec/events";
+/** An error here would mean that the exported decorator is not using the same signature. Make sure to have export const $decName: DecNameDecorator = (...) => ... */
+const _ = $decorators["TypeSpec.Events"];
+//# sourceMappingURL=TypeSpec.Events.ts-test.js.map

package/dist/generated-defs/TypeSpec.Events.ts-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeSpec.Events.ts-test.js","sourceRoot":"","sources":["../../generated-defs/TypeSpec.Events.ts-test.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qKAAqK;AACrK,MAAM,CAAC,GAA6B,WAAW,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/src/decorators.d.ts

@@ -0,0 +1,12 @@
+import { type ModelProperty, type Union, type UnionVariant } from "@typespec/compiler";
+import type { ContentTypeDecorator, DataDecorator, EventsDecorator } from "../generated-defs/TypeSpec.Events.js";
+declare const isEvents: (program: import("@typespec/compiler").Program, type: Union) => boolean;
+export declare const $eventsDecorator: EventsDecorator;
+export { isEvents };
+declare const getContentType: (program: import("@typespec/compiler").Program, type: ModelProperty | UnionVariant) => string | undefined;
+export declare const $contentTypeDecorator: ContentTypeDecorator;
+export { getContentType };
+declare const isEventData: (program: import("@typespec/compiler").Program, type: ModelProperty) => boolean;
+export declare const $dataDecorator: DataDecorator;
+export { isEventData };
+//# sourceMappingURL=decorators.d.ts.map

package/dist/src/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvF,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,eAAe,EAChB,MAAM,sCAAsC,CAAC;AAG9C,QAAA,MAAO,QAAQ,yEAAgE,CAAC;AAEhF,eAAO,MAAM,gBAAgB,EAAE,eAE9B,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,QAAA,MAAO,cAAc,2GAEpB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,oBAEnC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,QAAA,MAAO,WAAW,iFAAyE,CAAC;AAE5F,eAAO,MAAM,cAAc,EAAE,aAE5B,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/src/decorators.js

@@ -0,0 +1,19 @@
+import {} from "@typespec/compiler";
+import { unsafe_useStateMap, unsafe_useStateSet } from "@typespec/compiler/experimental";
+import { EventsStateKeys } from "./lib.js";
+const [isEvents, setEvents] = unsafe_useStateSet(EventsStateKeys.events);
+export const $eventsDecorator = (context, target) => {
+    setEvents(context.program, target);
+};
+export { isEvents };
+const [getContentType, setContentType] = unsafe_useStateMap(EventsStateKeys.contentType);
+export const $contentTypeDecorator = (context, target, contentType) => {
+    setContentType(context.program, target, contentType);
+};
+export { getContentType };
+const [isEventData, setEventData] = unsafe_useStateSet(EventsStateKeys.data);
+export const $dataDecorator = (context, target) => {
+    setEventData(context.program, target);
+};
+export { isEventData };
+//# sourceMappingURL=decorators.js.map

package/dist/src/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqD,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAMzF,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,kBAAkB,CAAQ,eAAe,CAAC,MAAM,CAAC,CAAC;AAEhF,MAAM,CAAC,MAAM,gBAAgB,GAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IACnE,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,GAAG,kBAAkB,CACzD,eAAe,CAAC,WAAW,CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;IAC1F,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG,kBAAkB,CAAgB,eAAe,CAAC,IAAI,CAAC,CAAC;AAE5F,MAAM,CAAC,MAAM,cAAc,GAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC/D,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/src/experimental/get-event-definitions.d.ts

@@ -0,0 +1,43 @@
+import { type DiagnosticResult, type Program, type Type, type Union, type UnionVariant } from "@typespec/compiler";
+export declare function getEventDefinitions(program: Program, target: Union): DiagnosticResult<EventDefinition[]>;
+/**
+ * Represents the definition of an event.
+ */
+export interface EventDefinition {
+    /**
+     * The name of the event type.
+     * This may be used when the underlying event protocol supports event types
+     * out-of-band from the event evelope or event payload.
+     */
+    readonly eventType?: string;
+    /**
+     * The root variant of the union that represents the event.
+     */
+    readonly root: UnionVariant;
+    /**
+     * Indicates whether the `type` describes an event envelope
+     * with a separate event payload.
+     */
+    readonly isEventEnvelope: boolean;
+    /**
+     * The type of the event.
+     * This represents an event envelope if `isEventEnvelope` is `true`.
+     */
+    readonly type: Type;
+    /**
+     * The content type of the event.
+     * This represents the content type of the event envelope if `isEventEnvelope` is `true`.
+     */
+    readonly contentType?: string;
+    /**
+     * The type of the event payload.
+     * This matches `type` if `isEventEnvelope` is `false`.
+     */
+    readonly payloadType: Type;
+    /**
+     * The content type of the event payload.
+     * This matches `contentType` if `isEventEnvelope` is `false`.
+     */
+    readonly payloadContentType?: string;
+}
+//# sourceMappingURL=get-event-definitions.d.ts.map

package/dist/src/experimental/get-event-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-event-definitions.d.ts","sourceRoot":"","sources":["../../../src/experimental/get-event-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EAGrB,KAAK,OAAO,EAEZ,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AA0L5B,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,KAAK,GACZ,gBAAgB,CAAC,eAAe,EAAE,CAAC,CAUrC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC"}

package/dist/src/experimental/get-event-definitions.js

@@ -0,0 +1,165 @@
+import { createDiagnosticCollector, navigateType, } from "@typespec/compiler";
+import { getContentType, isEventData } from "../decorators.js";
+import { createDiagnostic } from "../lib.js";
+function validateContentType(program, target) {
+    const contentType = getContentType(program, target);
+    if (!contentType || isEventData(program, target))
+        return;
+    return createDiagnostic({
+        code: "invalid-content-type-target",
+        target,
+    });
+}
+function stringifyPropertyPath(path) {
+    return path
+        .map((p) => {
+        switch (p.kind) {
+            case "ModelProperty":
+                return p.name;
+            case "Tuple":
+                return "[]";
+            case "Model":
+                return;
+        }
+    })
+        .filter(Boolean)
+        .join(".");
+}
+function getEventDefinition(program, target) {
+    const diagnostics = createDiagnosticCollector();
+    // If the variant has a name, that may be used for out-of-band event types.
+    const eventType = typeof target.name === "string" ? target.name : undefined;
+    const envelopeContentType = getContentType(program, target);
+    let payloadType;
+    let payloadContentType;
+    let pathToPayload = "";
+    // Keeps track of if we're in a Record or Array.
+    let indexerDepth = 0;
+    // Keeps track of the path from the target to the current model property.
+    const currentPropertyPath = [];
+    // Keeps track of the types that have a descendant that leads to the event payload.
+    const typesThatChainToPayload = new Set();
+    // Look for a model property that is decorated with `@data`.
+    // This property will be used as the event payload.
+    // It can only be applied once within an event, and if it is not found,
+    // the target type is the payload.
+    navigateType(target.type, {
+        modelProperty(prop) {
+            currentPropertyPath.push(prop);
+            const contentTypeDiagnostic = validateContentType(program, prop);
+            if (contentTypeDiagnostic) {
+                diagnostics.add(contentTypeDiagnostic);
+            }
+            // This detects the scenario where a model that contains a `@data` property
+            // is referenced multiple times directly or indirectly by the target event.
+            if (typesThatChainToPayload.has(prop.type)) {
+                diagnostics.add(createDiagnostic({
+                    code: "multiple-event-payloads",
+                    format: {
+                        dataPath: pathToPayload,
+                        currentPath: stringifyPropertyPath(currentPropertyPath),
+                    },
+                    target,
+                }));
+                return;
+            }
+            // Haven't found a payload property yet, move on.
+            if (!isEventData(program, prop))
+                return;
+            // Mark all the types in the current path as having a descendant that leads to the payload.
+            currentPropertyPath.forEach((p) => {
+                if (p.kind === "ModelProperty") {
+                    typesThatChainToPayload.add(p.type);
+                }
+                else if (p.kind === "Model" || p.kind === "Tuple") {
+                    typesThatChainToPayload.add(p);
+                }
+            });
+            // Found the payload property but it's referenced indirectly by
+            // a Record or Array, which implies there would be more than 1 payload.
+            if (indexerDepth > 0) {
+                diagnostics.add(createDiagnostic({
+                    code: "multiple-event-payloads",
+                    messageId: "payloadInIndexedModel",
+                    format: {
+                        dataPath: stringifyPropertyPath(currentPropertyPath.slice(0, -1)),
+                    },
+                    target,
+                }));
+                return;
+            }
+            // A payload type was previously found, but only one is allowed.
+            if (payloadType) {
+                diagnostics.add(createDiagnostic({
+                    code: "multiple-event-payloads",
+                    format: {
+                        dataPath: pathToPayload,
+                        currentPath: stringifyPropertyPath(currentPropertyPath),
+                    },
+                    target,
+                }));
+                return;
+            }
+            // A payload property was found.
+            payloadType = prop.type;
+            payloadContentType = getContentType(program, prop);
+            pathToPayload = stringifyPropertyPath(currentPropertyPath);
+        },
+        exitModelProperty() {
+            currentPropertyPath.pop();
+        },
+        tuple(tuple) {
+            currentPropertyPath.push(tuple);
+            // Check if any of the tuple values have already been marked as a payload/payload ancestor.
+            // They won't be visited again, so need to create diagnostic here.
+            tuple.values.forEach((value) => {
+                if (typesThatChainToPayload.has(value)) {
+                    diagnostics.add(createDiagnostic({
+                        code: "multiple-event-payloads",
+                        format: {
+                            dataPath: pathToPayload,
+                            currentPath: stringifyPropertyPath(currentPropertyPath),
+                        },
+                        target,
+                    }));
+                    return;
+                }
+            });
+        },
+        exitTuple() {
+            currentPropertyPath.pop();
+        },
+        model(model) {
+            if (model.indexer) {
+                indexerDepth++;
+            }
+            currentPropertyPath.push(model);
+        },
+        exitModel(model) {
+            if (model.indexer) {
+                indexerDepth--;
+            }
+            currentPropertyPath.pop();
+        },
+    }, {});
+    const eventDefinition = {
+        eventType,
+        root: target,
+        isEventEnvelope: !!payloadType,
+        type: target.type,
+        contentType: envelopeContentType,
+        payloadType: payloadType ?? target.type,
+        payloadContentType: payloadType ? payloadContentType : envelopeContentType,
+    };
+    return diagnostics.wrap(eventDefinition);
+}
+export function getEventDefinitions(program, target) {
+    const diagnostics = createDiagnosticCollector();
+    // 1. Iterate over each variant of the action
+    const events = [];
+    target.variants.forEach((variant) => {
+        events.push(diagnostics.pipe(getEventDefinition(program, variant)));
+    });
+    return diagnostics.wrap(events);
+}
+//# sourceMappingURL=get-event-definitions.js.map

package/dist/src/experimental/get-event-definitions.js.map

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

package/dist/src/experimental/index.d.ts

@@ -0,0 +1,3 @@
+export { getEventDefinitions as unsafe_getEventDefinitions } from "./get-event-definitions.js";
+export type { EventDefinition as unsafe_EventDefinition } from "./get-event-definitions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/experimental/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/experimental/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,IAAI,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC/F,YAAY,EAAE,eAAe,IAAI,sBAAsB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/experimental/index.js

@@ -0,0 +1,2 @@
+export { getEventDefinitions as unsafe_getEventDefinitions } from "./get-event-definitions.js";
+//# sourceMappingURL=index.js.map

package/dist/src/experimental/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/experimental/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,IAAI,0BAA0B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export { $lib } from "./lib.js";
+export { $decorators, $onValidate } from "./tsp-index.js";
+export { getContentType, isEventData, isEvents } from "./decorators.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export { $lib } from "./lib.js";
+export { $decorators, $onValidate } from "./tsp-index.js";
+export { getContentType, isEventData, isEvents } from "./decorators.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/lib.d.ts

@@ -0,0 +1,43 @@
+export declare const $lib: import("@typespec/compiler").TypeSpecLibrary<{
+    "invalid-content-type-target": {
+        readonly default: "@contentType can only be specified on the top-level event envelope, or the event payload marked with @data";
+    };
+    "multiple-event-payloads": {
+        readonly default: import("@typespec/compiler").CallableMessage<["dataPath", "currentPath"]>;
+        readonly payloadInIndexedModel: import("@typespec/compiler").CallableMessage<["dataPath"]>;
+    };
+}, Record<string, any>, "data" | "events" | "contentType">;
+export declare const reportDiagnostic: <C extends "invalid-content-type-target" | "multiple-event-payloads", M extends keyof {
+    "invalid-content-type-target": {
+        readonly default: "@contentType can only be specified on the top-level event envelope, or the event payload marked with @data";
+    };
+    "multiple-event-payloads": {
+        readonly default: import("@typespec/compiler").CallableMessage<["dataPath", "currentPath"]>;
+        readonly payloadInIndexedModel: import("@typespec/compiler").CallableMessage<["dataPath"]>;
+    };
+}[C]>(program: import("@typespec/compiler").Program, diag: import("@typespec/compiler").DiagnosticReport<{
+    "invalid-content-type-target": {
+        readonly default: "@contentType can only be specified on the top-level event envelope, or the event payload marked with @data";
+    };
+    "multiple-event-payloads": {
+        readonly default: import("@typespec/compiler").CallableMessage<["dataPath", "currentPath"]>;
+        readonly payloadInIndexedModel: import("@typespec/compiler").CallableMessage<["dataPath"]>;
+    };
+}, C, M>) => void, createDiagnostic: <C extends "invalid-content-type-target" | "multiple-event-payloads", M extends keyof {
+    "invalid-content-type-target": {
+        readonly default: "@contentType can only be specified on the top-level event envelope, or the event payload marked with @data";
+    };
+    "multiple-event-payloads": {
+        readonly default: import("@typespec/compiler").CallableMessage<["dataPath", "currentPath"]>;
+        readonly payloadInIndexedModel: import("@typespec/compiler").CallableMessage<["dataPath"]>;
+    };
+}[C]>(diag: import("@typespec/compiler").DiagnosticReport<{
+    "invalid-content-type-target": {
+        readonly default: "@contentType can only be specified on the top-level event envelope, or the event payload marked with @data";
+    };
+    "multiple-event-payloads": {
+        readonly default: import("@typespec/compiler").CallableMessage<["dataPath", "currentPath"]>;
+        readonly payloadInIndexedModel: import("@typespec/compiler").CallableMessage<["dataPath"]>;
+    };
+}, C, M>) => import("@typespec/compiler").Diagnostic, EventsStateKeys: Record<"data" | "events" | "contentType", symbol>;
+//# sourceMappingURL=lib.d.ts.map

package/dist/src/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI;;;;;;;;0DAuBf,CAAC;AAEH,eAAO,MAAQ,gBAAgB;;;;;;;;;;;;;;;;mBAAE,gBAAgB;;;;;;;;;;;;;;;;sDAAa,eAAe,mDAAS,CAAC"}

package/dist/src/lib.js

@@ -0,0 +1,26 @@
+import { createTypeSpecLibrary, paramMessage } from "@typespec/compiler";
+export const $lib = createTypeSpecLibrary({
+    name: "@typespec/events",
+    diagnostics: {
+        "invalid-content-type-target": {
+            severity: "error",
+            messages: {
+                default: `@contentType can only be specified on the top-level event envelope, or the event payload marked with @data`,
+            },
+        },
+        "multiple-event-payloads": {
+            severity: "error",
+            messages: {
+                default: paramMessage `Event payload already applied to ${"dataPath"} but also exists under ${"currentPath"}`,
+                payloadInIndexedModel: paramMessage `Event payload applied from inside a Record or Array at ${"dataPath"}`,
+            },
+        },
+    },
+    state: {
+        events: { description: "State for the @events decorator." },
+        contentType: { description: "State for the @contentType decorator." },
+        data: { description: "State for the @data decorator." },
+    },
+});
+export const { reportDiagnostic, createDiagnostic, stateKeys: EventsStateKeys } = $lib;
+//# sourceMappingURL=lib.js.map

package/dist/src/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzE,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAC;IACxC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;QACX,6BAA6B,EAAE;YAC7B,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE;gBACR,OAAO,EAAE,4GAA4G;aACtH;SACF;QACD,yBAAyB,EAAE;YACzB,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE;gBACR,OAAO,EAAE,YAAY,CAAA,oCAAoC,UAAU,0BAA0B,aAAa,EAAE;gBAE5G,qBAAqB,EAAE,YAAY,CAAA,0DAA0D,UAAU,EAAE;aAC1G;SACF;KACF;IACD,KAAK,EAAE;QACL,MAAM,EAAE,EAAE,WAAW,EAAE,kCAAkC,EAAE;QAC3D,WAAW,EAAE,EAAE,WAAW,EAAE,uCAAuC,EAAE;QACrE,IAAI,EAAE,EAAE,WAAW,EAAE,gCAAgC,EAAE;KACxD;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC"}

package/dist/src/testing/index.d.ts

@@ -0,0 +1,2 @@
+export declare const EventsTestLibrary: import("@typespec/compiler/testing").TypeSpecTestLibrary;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,0DAG5B,CAAC"}

package/dist/src/testing/index.js

@@ -0,0 +1,6 @@
+import { createTestLibrary, findTestPackageRoot } from "@typespec/compiler/testing";
+export const EventsTestLibrary = createTestLibrary({
+    name: "@typespec/events",
+    packageRoot: await findTestPackageRoot(import.meta.url),
+});
+//# sourceMappingURL=index.js.map

package/dist/src/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEpF,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;IACjD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,MAAM,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;CACxD,CAAC,CAAC"}

package/dist/src/tsp-index.d.ts

@@ -0,0 +1,10 @@
+export { $lib } from "./lib.js";
+export { $onValidate } from "./validate.js";
+export declare const $decorators: {
+    "TypeSpec.Events": {
+        contentType: import("../generated-defs/TypeSpec.Events.js").ContentTypeDecorator;
+        data: import("../generated-defs/TypeSpec.Events.js").DataDecorator;
+        events: import("../generated-defs/TypeSpec.Events.js").EventsDecorator;
+    };
+};
+//# sourceMappingURL=tsp-index.d.ts.map

package/dist/src/tsp-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsp-index.d.ts","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,eAAO,MAAM,WAAW;;;;;;CAMvB,CAAC"}

package/dist/src/tsp-index.js

@@ -0,0 +1,11 @@
+import { $contentTypeDecorator, $dataDecorator, $eventsDecorator } from "./decorators.js";
+export { $lib } from "./lib.js";
+export { $onValidate } from "./validate.js";
+export const $decorators = {
+    "TypeSpec.Events": {
+        contentType: $contentTypeDecorator,
+        data: $dataDecorator,
+        events: $eventsDecorator,
+    },
+};
+//# sourceMappingURL=tsp-index.js.map

package/dist/src/tsp-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsp-index.js","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE1F,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,iBAAiB,EAAE;QACjB,WAAW,EAAE,qBAAqB;QAClC,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,gBAAgB;KACzB;CACF,CAAC"}

package/dist/src/validate.d.ts

@@ -0,0 +1,3 @@
+import type { Program } from "@typespec/compiler";
+export declare function $onValidate(program: Program): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/src/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAS,MAAM,oBAAoB,CAAC;AAGzD,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,QAE3C"}

package/dist/src/validate.js

@@ -0,0 +1,12 @@
+import { unsafe_getEventDefinitions } from "./experimental/index.js";
+import { EventsStateKeys } from "./lib.js";
+export function $onValidate(program) {
+    checkForInvalidEvents(program);
+}
+function checkForInvalidEvents(program) {
+    program.stateSet(EventsStateKeys.events).forEach((events) => {
+        const [, diagnostics] = unsafe_getEventDefinitions(program, events);
+        program.reportDiagnostics(diagnostics);
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/src/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC1D,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,0BAA0B,CAAC,OAAO,EAAE,MAAe,CAAC,CAAC;QAC7E,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/decorators.tsp

@@ -0,0 +1,59 @@
+using TypeSpec.Reflection;
+
+namespace TypeSpec.Events;
+
+/**
+ * Specify that this union describes a set of events.
+ *
+ * @example
+ *
+ * ```typespec
+ * @events
+ * union MixedEvents {
+ *   pingEvent: string;
+ *
+ *   doneEvent: "done";
+ * }
+ * ```
+ */
+extern dec events(target: Union);
+
+/**
+ * Specifies the content type of the event envelope, event body, or event payload.
+ * When applied to an event payload, that field must also have a corresponding `@data`
+ * decorator.
+ *
+ * @example
+ *
+ * ```typespec
+ * @events union MixedEvents {
+ *   @contentType("application/json")
+ *   message: { id: string, text: string, }
+ * }
+ * ```
+ *
+ * @example Specify the content type of the event payload.
+ *
+ * ```typespec
+ * @events union MixedEvents {
+ *   { done: true },
+ *
+ *   { done: false, @data @contentType("text/plain") value: string,}
+ * }
+ * ```
+ */
+extern dec contentType(target: UnionVariant | ModelProperty, contentType: valueof string);
+
+/**
+ * Identifies the payload of an event.
+ * Only one field in an event can be marked as the payload.
+ *
+ * @example
+ *
+ * ```typespec
+ * @events union MixedEvents {
+ *   { metadata: Record<string>, @data payload: string,}
+ * }
+ * ```
+ */
+extern dec data(target: ModelProperty);

package/lib/main.tsp

@@ -0,0 +1,2 @@
+import "../dist/src/tsp-index.js";
+import "./decorators.tsp";

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@typespec/events",
+  "version": "0.60.0",
+  "author": "Microsoft Corporation",
+  "description": "TypeSpec library providing events bindings",
+  "homepage": "https://typespec.io",
+  "readme": "https://github.com/microsoft/typespec/blob/main/README.md",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/microsoft/typespec.git"
+  },
+  "bugs": {
+    "url": "https://github.com/microsoft/typespec/issues"
+  },
+  "keywords": [
+    "typespec"
+  ],
+  "type": "module",
+  "main": "dist/src/index.js",
+  "tspMain": "lib/main.tsp",
+  "exports": {
+    ".": "./dist/src/index.js",
+    "./testing": "./dist/src/testing/index.js",
+    "./experimental": {
+      "types": "./dist/src/experimental/index.d.ts",
+      "default": "./dist/src/experimental/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "lib/*.tsp",
+    "dist/**",
+    "!dist/test/**"
+  ],
+  "peerDependencies": {
+    "@typespec/compiler": "~0.60.1"
+  },
+  "devDependencies": {
+    "@types/node": "~22.7.1",
+    "@vitest/coverage-v8": "^2.1.1",
+    "@vitest/ui": "^2.1.1",
+    "c8": "^10.1.2",
+    "rimraf": "~6.0.1",
+    "typescript": "~5.6.2",
+    "vitest": "^2.1.1",
+    "@typespec/library-linter": "~0.60.0",
+    "@typespec/compiler": "~0.60.1",
+    "@typespec/tspd": "~0.46.0"
+  },
+  "scripts": {
+    "clean": "rimraf ./dist ./temp",
+    "build": "npm run gen-extern-signature && tsc -p . && npm run lint-typespec-library",
+    "watch": "tsc -p . --watch",
+    "gen-extern-signature": "tspd --enable-experimental gen-extern-signature .",
+    "lint-typespec-library": "tsp compile . --warn-as-error --import @typespec/library-linter --no-emit",
+    "test": "vitest run",
+    "test:watch": "vitest -w",
+    "test:ui": "vitest --ui",
+    "test-official": "vitest run --coverage --reporter=junit --reporter=default --no-file-parallelism",
+    "lint": "eslint . --ext .ts --max-warnings=0",
+    "lint:fix": "eslint . --fix --ext .ts",
+    "regen-docs": "tspd doc .  --enable-experimental  --output-dir ../../docs/libraries/events/reference"
+  }
+}