@furo/open-models 1.14.0 → 1.15.1

package/dist/decorators/SchemaBuilder.js

@@ -0,0 +1,89 @@
+import { Registry } from "../Registry.js";
+const primitivesMap = new Map([
+    ["primitives.BOOLEAN", "boolean"],
+    ["primitives.BYTES", "string"],
+    ["primitives.DOUBLE", "number"],
+    ["primitives.ENUM", "string"],
+    ["primitives.FLOAT", "number"],
+    ["primitives.INT32", "integer"],
+    ["primitives.INT64", "integer"],
+    ["primitives.SINT32", "integer"],
+    ["primitives.SINT64", "integer"],
+    ["primitives.STRING", "string"],
+    ["primitives.UINT32", "integer"],
+    ["primitives.UINT64", "integer"],
+]);
+export class SchemaBuilder {
+    static generate(model) {
+        const schema = {
+            $schema: "http://json-schema.org/draft-07/schema#",
+            $id: model.__meta.typeName,
+            type: "object",
+            description: model.__meta.description,
+        };
+        schema.properties = SchemaBuilder.getProps(model);
+        // required fields
+        const rq = SchemaBuilder.getRequiredFields(model.__meta.nodeFields);
+        if (rq.length > 0) {
+            schema.required = rq;
+        }
+        return schema;
+    }
+    static getProps(model) {
+        return Object.fromEntries(model.__meta.nodeFields.map(fieldDescriptor => {
+            const field = model.__getFieldNodeByPath(fieldDescriptor.fieldName);
+            if (field.__isPrimitive && field.__meta.typeName !== "primitives.ENUM") {
+                const spec = {
+                    type: primitivesMap.get(field.__meta.typeName),
+                    description: [fieldDescriptor.description, field.__meta.description].join(""),
+                    ...SchemaBuilder.getConstraints(fieldDescriptor.constraints),
+                };
+                return [fieldDescriptor.fieldName, spec];
+            }
+            // ENUM
+            if (field.__meta.typeName === "primitives.ENUM") {
+                const eargs = model.__getFieldNodeByPath("material").enumArg;
+                return [
+                    fieldDescriptor.fieldName,
+                    {
+                        type: primitivesMap.get(field.__meta.typeName),
+                        description: [fieldDescriptor.description, field.__meta.description].join(""),
+                        enum: Array.from(Object.keys(eargs)),
+                    },
+                ];
+            }
+            const schema = {
+                type: "object",
+                description: [fieldDescriptor.description, field.__meta.description].join(""),
+            };
+            schema.properties = SchemaBuilder.getProps(field);
+            // required fields
+            const rq = SchemaBuilder.getRequiredFields(model.__meta.nodeFields);
+            if (rq.length > 0) {
+                schema.required = rq;
+            }
+            return [fieldDescriptor.fieldName, schema];
+        }));
+    }
+    static getRequiredFields(descriptors) {
+        const req = [];
+        descriptors.forEach(descriptor => {
+            if (descriptor.constraints?.required) {
+                req.push(descriptor.fieldName);
+            }
+        });
+        return req;
+    }
+    static getConstraints(constraints) {
+        if (constraints === undefined) {
+            return {};
+        }
+        const co = { ...constraints };
+        delete co.required;
+        return co;
+    }
+    static createFieldNodeFromSchema(schema) {
+        return Registry.createInstanceByTypeName(schema.$id, schema);
+    }
+}
+//# sourceMappingURL=SchemaBuilder.js.map

package/dist/decorators/SchemaBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilder.js","sourceRoot":"","sources":["../../src/decorators/SchemaBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["import { ENUM } from \"../primitives/ENUM\";\nimport { FieldConstraints } from \"../FieldConstraints\";\nimport { FieldNode } from \"../FieldNode\";\nimport type { FieldDescriptor } from \"../FieldNode\";\nimport { Registry } from \"../Registry\";\nimport type { JSONSchema7, JSONSchema7Definition } from \"json-schema\";\n\nconst primitivesMap: Map<string, string> = new Map([\n  [\"primitives.BOOLEAN\", \"boolean\"],\n  [\"primitives.BYTES\", \"string\"],\n  [\"primitives.DOUBLE\", \"number\"],\n  [\"primitives.ENUM\", \"string\"],\n  [\"primitives.FLOAT\", \"number\"],\n  [\"primitives.INT32\", \"integer\"],\n  [\"primitives.INT64\", \"integer\"],\n  [\"primitives.SINT32\", \"integer\"],\n  [\"primitives.SINT64\", \"integer\"],\n  [\"primitives.STRING\", \"string\"],\n  [\"primitives.UINT32\", \"integer\"],\n  [\"primitives.UINT64\", \"integer\"],\n]);\n\ninterface FieldNodeSchema {\n  $schema: string;\n  $id: string;\n  [key: string]: unknown;\n}\n\nexport class SchemaBuilder {\n  public static generate(model: FieldNode): JSONSchema7 {\n    const schema: JSONSchema7 = {\n      $schema: \"http://json-schema.org/draft-07/schema#\",\n      $id: model.__meta.typeName,\n      type: \"object\",\n      description: model.__meta.description,\n    };\n\n    schema.properties = SchemaBuilder.getProps(model);\n\n    // required fields\n    const rq = SchemaBuilder.getRequiredFields(model.__meta.nodeFields);\n    if (rq.length > 0) {\n      schema.required = rq;\n    }\n\n    return schema;\n  }\n\n  private static getProps(model: FieldNode): Record<string, JSONSchema7Definition> {\n    return Object.fromEntries(\n      model.__meta.nodeFields.map(fieldDescriptor => {\n        const field = model.__getFieldNodeByPath(fieldDescriptor.fieldName) as FieldNode;\n\n        if (field.__isPrimitive && field.__meta.typeName !== \"primitives.ENUM\") {\n          const spec = {\n            type: primitivesMap.get(field.__meta.typeName!)!,\n            description: [fieldDescriptor.description, field.__meta.description].join(\"\"),\n            ...SchemaBuilder.getConstraints(fieldDescriptor.constraints),\n          };\n\n          return [fieldDescriptor.fieldName, spec];\n        }\n        // ENUM\n        if (field.__meta.typeName === \"primitives.ENUM\") {\n          const eargs = (model.__getFieldNodeByPath(\"material\") as ENUM<unknown>).enumArg;\n\n          return [\n            fieldDescriptor.fieldName,\n            {\n              type: primitivesMap.get(field.__meta.typeName!),\n              description: [fieldDescriptor.description, field.__meta.description].join(\"\"),\n              enum: Array.from(Object.keys(eargs)),\n            },\n          ];\n        }\n\n        const schema: JSONSchema7 = {\n          type: \"object\",\n          description: [fieldDescriptor.description, field.__meta.description].join(\"\"),\n        };\n        schema.properties = SchemaBuilder.getProps(field);\n        // required fields\n        const rq = SchemaBuilder.getRequiredFields(model.__meta.nodeFields);\n        if (rq.length > 0) {\n          schema.required = rq;\n        }\n\n        return [fieldDescriptor.fieldName, schema];\n      })\n    );\n  }\n\n  private static getRequiredFields(descriptors: FieldDescriptor[]): string[] {\n    const req: string[] = [];\n    descriptors.forEach(descriptor => {\n      if (descriptor.constraints?.required) {\n        req.push(descriptor.fieldName);\n      }\n    });\n    return req;\n  }\n\n  private static getConstraints(constraints: FieldConstraints | undefined) {\n    if (constraints === undefined) {\n      return {};\n    }\n    const co = { ...constraints };\n    delete co.required;\n    return co;\n  }\n\n  public static createFieldNodeFromSchema(schema: FieldNodeSchema): FieldNode {\n    return Registry.createInstanceByTypeName(schema.$id, schema);\n  }\n}\n"]}

package/dist/decorators/ServiceDecorators.d.ts

@@ -0,0 +1,79 @@
+import { EntityServiceEventMap } from "./EntityServiceTypes.js";
+/**
+ * ### serviceBindings Factory
+ *
+ * Creates type-safe decorators bound to a specific service instance.
+ * Use this to bind component properties and methods to service events.
+ *
+ * The factory is generic and works with any `EventTarget`.
+ * Event types and their detail payloads are type-checked at compile time
+ * via the `TEventMap` type parameter.
+ *
+ * Usage:
+ * ```typescript
+ * import { cubeEntityService } from "./CubeEntityService";
+ * import { serviceBindings } from "./ServiceDecorators.js";
+ *
+ * const cube = serviceBindings(cubeEntityService);
+ *
+ * class MyComponent extends LitElement {
+ *   // Property binding - type-safe event name, auto-extracts from detail
+ *   @cube.bindToEvent("busy-changed")
+ *   @state()
+ *   private busy: boolean = false;
+ *
+ *   // Event binding - type-safe event name and detail type
+ *   @cube.onEvent("response-received")
+ *   private onResponseReceived() {
+ *     console.log("Data received!");
+ *   }
+ *
+ *   @cube.onEvent("error-5xx")
+ *   private onError(detail: { serverResponse: Response }) {
+ *     console.error("Server error:", detail.serverResponse);
+ *   }
+ *
+ *   // Compile error! "typo-event" is not a valid event type
+ *   // @cube.onEvent("typo-event")
+ * }
+ * ```
+ *
+ * ### Custom Event Maps
+ *
+ * To add custom events, extend the `EntityServiceEventMap`:
+ * ```typescript
+ * interface MyServiceEventMap extends EntityServiceEventMap {
+ *   "custom-event": { data: string };
+ * }
+ *
+ * const myBindings = serviceBindings<MyServiceEventMap>(myService);
+ * ```
+ *
+ * @typeParam TEventMap - The event map type (defaults to EntityServiceEventMap)
+ * @param service - The EventTarget service to bind to
+ * @returns Object with `bindToEvent` and `onEvent` decorator factories
+ */
+export declare function ServiceBindings<TEventMap extends EntityServiceEventMap = EntityServiceEventMap>(service: EventTarget): {
+    /**
+     * Binds a property to a service event.
+     * When the event fires, the property is automatically updated from event.detail.
+     *
+     * @typeParam K - The event type (constrained to valid event names)
+     * @param eventType - The event name to listen for
+     * @param detailKey - Optional key to extract from event.detail (defaults to inferring from event type)
+     */
+    bindToEvent<K extends keyof TEventMap & string>(eventType: K, detailKey?: string): (target: object, propertyKey: string) => void;
+    /**
+     * Binds a method to a service event.
+     * When the event fires, the method is called with event.detail as argument.
+     *
+     * The detail type is inferred from the event map:
+     * - `@cube.onEvent("busy-changed")` → method receives `{ busy: boolean }`
+     * - `@cube.onEvent("error-5xx")` → method receives `{ serverResponse: Response }`
+     * - `@cube.onEvent("response-received")` → method receives `{ response, serverResponse }`
+     *
+     * @typeParam K - The event type (constrained to valid event names)
+     * @param eventType - The event name to listen for
+     */
+    onEvent<K extends keyof TEventMap & string>(eventType: K): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => void;
+};

package/dist/decorators/ServiceDecorators.js

@@ -0,0 +1,203 @@
+const propertyBindingsMetadata = new WeakMap();
+// Symbol keys for instance storage
+const PROPERTY_LISTENERS = Symbol.for("__servicePropertyListeners__");
+const EVENT_LISTENERS = Symbol.for("__serviceEventListeners__");
+const PROPERTY_PATCHED = Symbol.for("__servicePropertyPatched__");
+const EVENT_PATCHED = Symbol.for("__serviceEventPatched__");
+const EVENT_METHODS = Symbol.for("__serviceEventMethods__");
+/**
+ * ### serviceBindings Factory
+ *
+ * Creates type-safe decorators bound to a specific service instance.
+ * Use this to bind component properties and methods to service events.
+ *
+ * The factory is generic and works with any `EventTarget`.
+ * Event types and their detail payloads are type-checked at compile time
+ * via the `TEventMap` type parameter.
+ *
+ * Usage:
+ * ```typescript
+ * import { cubeEntityService } from "./CubeEntityService";
+ * import { serviceBindings } from "./ServiceDecorators.js";
+ *
+ * const cube = serviceBindings(cubeEntityService);
+ *
+ * class MyComponent extends LitElement {
+ *   // Property binding - type-safe event name, auto-extracts from detail
+ *   @cube.bindToEvent("busy-changed")
+ *   @state()
+ *   private busy: boolean = false;
+ *
+ *   // Event binding - type-safe event name and detail type
+ *   @cube.onEvent("response-received")
+ *   private onResponseReceived() {
+ *     console.log("Data received!");
+ *   }
+ *
+ *   @cube.onEvent("error-5xx")
+ *   private onError(detail: { serverResponse: Response }) {
+ *     console.error("Server error:", detail.serverResponse);
+ *   }
+ *
+ *   // Compile error! "typo-event" is not a valid event type
+ *   // @cube.onEvent("typo-event")
+ * }
+ * ```
+ *
+ * ### Custom Event Maps
+ *
+ * To add custom events, extend the `EntityServiceEventMap`:
+ * ```typescript
+ * interface MyServiceEventMap extends EntityServiceEventMap {
+ *   "custom-event": { data: string };
+ * }
+ *
+ * const myBindings = serviceBindings<MyServiceEventMap>(myService);
+ * ```
+ *
+ * @typeParam TEventMap - The event map type (defaults to EntityServiceEventMap)
+ * @param service - The EventTarget service to bind to
+ * @returns Object with `bindToEvent` and `onEvent` decorator factories
+ */
+export function ServiceBindings(service) {
+    return {
+        /**
+         * Binds a property to a service event.
+         * When the event fires, the property is automatically updated from event.detail.
+         *
+         * @typeParam K - The event type (constrained to valid event names)
+         * @param eventType - The event name to listen for
+         * @param detailKey - Optional key to extract from event.detail (defaults to inferring from event type)
+         */
+        bindToEvent(eventType, detailKey) {
+            return function bindToEventDecorator(target, propertyKey) {
+                // Infer detailKey from event type if not provided
+                // e.g., "busy-changed" -> "busy"
+                const key = detailKey ?? inferDetailKey(eventType, propertyKey);
+                // Get or create metadata map for this class
+                let metadata = propertyBindingsMetadata.get(target);
+                if (!metadata) {
+                    metadata = new Map();
+                    propertyBindingsMetadata.set(target, metadata);
+                }
+                metadata.set(propertyKey, { service, eventType, detailKey: key });
+                // Patch lifecycle methods (only once per class)
+                patchPropertyLifecycle(target.constructor);
+            };
+        },
+        /**
+         * Binds a method to a service event.
+         * When the event fires, the method is called with event.detail as argument.
+         *
+         * The detail type is inferred from the event map:
+         * - `@cube.onEvent("busy-changed")` → method receives `{ busy: boolean }`
+         * - `@cube.onEvent("error-5xx")` → method receives `{ serverResponse: Response }`
+         * - `@cube.onEvent("response-received")` → method receives `{ response, serverResponse }`
+         *
+         * @typeParam K - The event type (constrained to valid event names)
+         * @param eventType - The event name to listen for
+         */
+        onEvent(eventType) {
+            return function onEventDecorator(target, propertyKey, descriptor) {
+                const originalMethod = descriptor.value;
+                const ctor = target.constructor;
+                // Store method metadata on the constructor
+                let methods = ctor[EVENT_METHODS];
+                if (!methods) {
+                    methods = [];
+                    ctor[EVENT_METHODS] = methods;
+                }
+                methods.push({ propertyKey, service, eventType, method: originalMethod });
+                // Patch lifecycle methods (only once per class)
+                patchEventLifecycle(ctor);
+            };
+        },
+    };
+}
+/**
+ * Infer the detail key from the event type or property name
+ */
+function inferDetailKey(eventType, propertyKey) {
+    // Common patterns: "busy-changed" -> "busy", "validity-changed" -> check property
+    const match = eventType.match(/^(.+)-changed$/);
+    if (match) {
+        return match[1];
+    }
+    // Fall back to property name
+    return propertyKey;
+}
+/**
+ * Patch connectedCallback/disconnectedCallback for property bindings
+ */
+function patchPropertyLifecycle(ctor) {
+    if (ctor[PROPERTY_PATCHED]) {
+        return;
+    }
+    ctor[PROPERTY_PATCHED] = true;
+    const originalConnected = ctor.prototype.connectedCallback;
+    const originalDisconnected = ctor.prototype.disconnectedCallback;
+    ctor.prototype.connectedCallback = function connectedCallback() {
+        originalConnected?.call(this);
+        const metadata = propertyBindingsMetadata.get(Object.getPrototypeOf(this));
+        if (!metadata)
+            return;
+        const listeners = new Map();
+        this[PROPERTY_LISTENERS] = listeners;
+        metadata.forEach(({ service, eventType, detailKey }, propKey) => {
+            const listener = ((e) => {
+                if (e.detail && detailKey in e.detail) {
+                    this[propKey] = e.detail[detailKey];
+                }
+            });
+            listeners.set(propKey, { listener, service, eventType });
+            service.addEventListener(eventType, listener);
+        });
+    };
+    ctor.prototype.disconnectedCallback = function disconnectedCallback() {
+        const listeners = this[PROPERTY_LISTENERS];
+        if (listeners) {
+            listeners.forEach(({ listener, service, eventType }) => {
+                service.removeEventListener(eventType, listener);
+            });
+            listeners.clear();
+        }
+        originalDisconnected?.call(this);
+    };
+}
+/**
+ * Patch connectedCallback/disconnectedCallback for event method bindings
+ */
+function patchEventLifecycle(ctor) {
+    if (ctor[EVENT_PATCHED]) {
+        return;
+    }
+    ctor[EVENT_PATCHED] = true;
+    const originalConnected = ctor.prototype.connectedCallback;
+    const originalDisconnected = ctor.prototype.disconnectedCallback;
+    ctor.prototype.connectedCallback = function connectedCallback() {
+        originalConnected?.call(this);
+        const methods = this.constructor[EVENT_METHODS];
+        if (!methods)
+            return;
+        const listeners = new Map();
+        this[EVENT_LISTENERS] = listeners;
+        methods.forEach(({ propertyKey, service, eventType, method }) => {
+            const listener = ((e) => {
+                method.call(this, e.detail);
+            });
+            listeners.set(propertyKey, { listener, service, eventType });
+            service.addEventListener(eventType, listener);
+        });
+    };
+    ctor.prototype.disconnectedCallback = function disconnectedCallback() {
+        const listeners = this[EVENT_LISTENERS];
+        if (listeners) {
+            listeners.forEach(({ listener, service, eventType }) => {
+                service.removeEventListener(eventType, listener);
+            });
+            listeners.clear();
+        }
+        originalDisconnected?.call(this);
+    };
+}
+//# sourceMappingURL=ServiceDecorators.js.map

package/dist/decorators/ServiceDecorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceDecorators.js","sourceRoot":"","sources":["../../src/decorators/ServiceDecorators.ts"],"names":[],"mappings":"AAcA,MAAM,wBAAwB,GAAG,IAAI,OAAO,EAA4C,CAAC;AAczF,mCAAmC;AACnC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AACtE,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAChE,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAClE,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAC5D,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,UAAU,eAAe,CAAkE,OAAoB;IACnH,OAAO;QACL;;;;;;;WAOG;QACH,WAAW,CAAqC,SAAY,EAAE,SAAkB;YAC9E,OAAO,SAAS,oBAAoB,CAAC,MAAc,EAAE,WAAmB;gBACtE,kDAAkD;gBAClD,iCAAiC;gBACjC,MAAM,GAAG,GAAG,SAAS,IAAI,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;gBAEhE,4CAA4C;gBAC5C,IAAI,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;oBACrB,wBAAwB,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACjD,CAAC;gBACD,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;gBAElE,gDAAgD;gBAChD,sBAAsB,CAAC,MAAM,CAAC,WAAqC,CAAC,CAAC;YACvE,CAAC,CAAC;QACJ,CAAC;QAED;;;;;;;;;;;WAWG;QACH,OAAO,CAAqC,SAAY;YACtD,OAAO,SAAS,gBAAgB,CAAC,MAAc,EAAE,WAAmB,EAAE,UAA8B;gBAClG,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;gBACxC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAqC,CAAC;gBAE1D,2CAA2C;gBAC3C,IAAI,OAAO,GAAI,IAAsD,CAAC,aAAa,CAAC,CAAC;gBACrF,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,EAAE,CAAC;oBACZ,IAAsD,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC;gBACnF,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;gBAE1E,gDAAgD;gBAChD,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,SAAiB,EAAE,WAAmB;IAC5D,kFAAkF;IAClF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,6BAA6B;IAC7B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,IAA4B;IAC1D,IAAK,IAA2C,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnE,OAAO;IACT,CAAC;IACA,IAA2C,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAEtE,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;IAC3D,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;IAEjE,IAAI,CAAC,SAAS,CAAC,iBAAiB,GAAG,SAAS,iBAAiB;QAG3D,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgF,CAAC;QAC1G,IAAI,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;QAErC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE;YAC9D,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE;gBACnC,IAAI,CAAC,CAAC,MAAM,IAAI,SAAS,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;oBACrC,IAA2C,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC,CAAkB,CAAC;YAEpB,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,CAAC,SAAS,CAAC,oBAAoB,GAAG,SAAS,oBAAoB;QAGjE,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC3C,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;gBACrD,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YACH,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QAED,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAA4B;IACvD,IAAK,IAA2C,CAAC,aAAa,CAAC,EAAE,CAAC;QAChE,OAAO;IACT,CAAC;IACA,IAA2C,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAEnE,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;IAC3D,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;IAEjE,IAAI,CAAC,SAAS,CAAC,iBAAiB,GAAG,SAAS,iBAAiB;QAG3D,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,OAAO,GAAI,IAAI,CAAC,WAA6D,CAAC,aAAa,CAAC,CAAC;QACnG,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgF,CAAC;QAC1G,IAAI,CAAC,eAAe,CAAC,GAAG,SAAS,CAAC;QAElC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;YAC9D,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE;gBACnC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC,CAAkB,CAAC;YAEpB,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,CAAC,SAAS,CAAC,oBAAoB,GAAG,SAAS,oBAAoB;QAGjE,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;QACxC,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;gBACrD,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YACH,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QAED,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/* eslint-disable no-param-reassign */\nimport { LitElement, ReactiveElement } from \"lit\";\n\nimport { EntityServiceEventMap } from \"./EntityServiceTypes\";\n\n/**\n * Metadata storage for property bindings\n * Maps: class prototype -> Map<propertyKey, { service, eventType, detailKey }>\n */\ninterface PropertyBindingMeta {\n  service: EventTarget;\n  eventType: string;\n  detailKey: string;\n}\nconst propertyBindingsMetadata = new WeakMap<object, Map<string, PropertyBindingMeta>>();\n\n/**\n * Metadata storage for event method bindings\n * Maps: class constructor -> Array<{ propertyKey, service, eventType, method }>\n */\ninterface EventBindingMeta {\n  propertyKey: string;\n  service: EventTarget;\n  eventType: string;\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  method: Function;\n}\n\n// Symbol keys for instance storage\nconst PROPERTY_LISTENERS = Symbol.for(\"__servicePropertyListeners__\");\nconst EVENT_LISTENERS = Symbol.for(\"__serviceEventListeners__\");\nconst PROPERTY_PATCHED = Symbol.for(\"__servicePropertyPatched__\");\nconst EVENT_PATCHED = Symbol.for(\"__serviceEventPatched__\");\nconst EVENT_METHODS = Symbol.for(\"__serviceEventMethods__\");\n\n/**\n * ### serviceBindings Factory\n *\n * Creates type-safe decorators bound to a specific service instance.\n * Use this to bind component properties and methods to service events.\n *\n * The factory is generic and works with any `EventTarget`.\n * Event types and their detail payloads are type-checked at compile time\n * via the `TEventMap` type parameter.\n *\n * Usage:\n * ```typescript\n * import { cubeEntityService } from \"./CubeEntityService\";\n * import { serviceBindings } from \"./ServiceDecorators\";\n *\n * const cube = serviceBindings(cubeEntityService);\n *\n * class MyComponent extends LitElement {\n *   // Property binding - type-safe event name, auto-extracts from detail\n *   @cube.bindToEvent(\"busy-changed\")\n *   @state()\n *   private busy: boolean = false;\n *\n *   // Event binding - type-safe event name and detail type\n *   @cube.onEvent(\"response-received\")\n *   private onResponseReceived() {\n *     console.log(\"Data received!\");\n *   }\n *\n *   @cube.onEvent(\"error-5xx\")\n *   private onError(detail: { serverResponse: Response }) {\n *     console.error(\"Server error:\", detail.serverResponse);\n *   }\n *\n *   // Compile error! \"typo-event\" is not a valid event type\n *   // @cube.onEvent(\"typo-event\")\n * }\n * ```\n *\n * ### Custom Event Maps\n *\n * To add custom events, extend the `EntityServiceEventMap`:\n * ```typescript\n * interface MyServiceEventMap extends EntityServiceEventMap {\n *   \"custom-event\": { data: string };\n * }\n *\n * const myBindings = serviceBindings<MyServiceEventMap>(myService);\n * ```\n *\n * @typeParam TEventMap - The event map type (defaults to EntityServiceEventMap)\n * @param service - The EventTarget service to bind to\n * @returns Object with `bindToEvent` and `onEvent` decorator factories\n */\nexport function ServiceBindings<TEventMap extends EntityServiceEventMap = EntityServiceEventMap>(service: EventTarget) {\n  return {\n    /**\n     * Binds a property to a service event.\n     * When the event fires, the property is automatically updated from event.detail.\n     *\n     * @typeParam K - The event type (constrained to valid event names)\n     * @param eventType - The event name to listen for\n     * @param detailKey - Optional key to extract from event.detail (defaults to inferring from event type)\n     */\n    bindToEvent<K extends keyof TEventMap & string>(eventType: K, detailKey?: string) {\n      return function bindToEventDecorator(target: object, propertyKey: string) {\n        // Infer detailKey from event type if not provided\n        // e.g., \"busy-changed\" -> \"busy\"\n        const key = detailKey ?? inferDetailKey(eventType, propertyKey);\n\n        // Get or create metadata map for this class\n        let metadata = propertyBindingsMetadata.get(target);\n        if (!metadata) {\n          metadata = new Map();\n          propertyBindingsMetadata.set(target, metadata);\n        }\n        metadata.set(propertyKey, { service, eventType, detailKey: key });\n\n        // Patch lifecycle methods (only once per class)\n        patchPropertyLifecycle(target.constructor as typeof ReactiveElement);\n      };\n    },\n\n    /**\n     * Binds a method to a service event.\n     * When the event fires, the method is called with event.detail as argument.\n     *\n     * The detail type is inferred from the event map:\n     * - `@cube.onEvent(\"busy-changed\")` → method receives `{ busy: boolean }`\n     * - `@cube.onEvent(\"error-5xx\")` → method receives `{ serverResponse: Response }`\n     * - `@cube.onEvent(\"response-received\")` → method receives `{ response, serverResponse }`\n     *\n     * @typeParam K - The event type (constrained to valid event names)\n     * @param eventType - The event name to listen for\n     */\n    onEvent<K extends keyof TEventMap & string>(eventType: K) {\n      return function onEventDecorator(target: object, propertyKey: string, descriptor: PropertyDescriptor) {\n        const originalMethod = descriptor.value;\n        const ctor = target.constructor as typeof ReactiveElement;\n\n        // Store method metadata on the constructor\n        let methods = (ctor as unknown as Record<symbol, EventBindingMeta[]>)[EVENT_METHODS];\n        if (!methods) {\n          methods = [];\n          (ctor as unknown as Record<symbol, EventBindingMeta[]>)[EVENT_METHODS] = methods;\n        }\n        methods.push({ propertyKey, service, eventType, method: originalMethod });\n\n        // Patch lifecycle methods (only once per class)\n        patchEventLifecycle(ctor);\n      };\n    },\n  };\n}\n\n/**\n * Infer the detail key from the event type or property name\n */\nfunction inferDetailKey(eventType: string, propertyKey: string): string {\n  // Common patterns: \"busy-changed\" -> \"busy\", \"validity-changed\" -> check property\n  const match = eventType.match(/^(.+)-changed$/);\n  if (match) {\n    return match[1];\n  }\n  // Fall back to property name\n  return propertyKey;\n}\n\n/**\n * Patch connectedCallback/disconnectedCallback for property bindings\n */\nfunction patchPropertyLifecycle(ctor: typeof ReactiveElement): void {\n  if ((ctor as unknown as Record<symbol, boolean>)[PROPERTY_PATCHED]) {\n    return;\n  }\n  (ctor as unknown as Record<symbol, boolean>)[PROPERTY_PATCHED] = true;\n\n  const originalConnected = ctor.prototype.connectedCallback;\n  const originalDisconnected = ctor.prototype.disconnectedCallback;\n\n  ctor.prototype.connectedCallback = function connectedCallback(\n    this: LitElement & Record<symbol, Map<string, { listener: EventListener; service: EventTarget; eventType: string }>>\n  ) {\n    originalConnected?.call(this);\n\n    const metadata = propertyBindingsMetadata.get(Object.getPrototypeOf(this));\n    if (!metadata) return;\n\n    const listeners = new Map<string, { listener: EventListener; service: EventTarget; eventType: string }>();\n    this[PROPERTY_LISTENERS] = listeners;\n\n    metadata.forEach(({ service, eventType, detailKey }, propKey) => {\n      const listener = ((e: CustomEvent) => {\n        if (e.detail && detailKey in e.detail) {\n          (this as unknown as Record<string, unknown>)[propKey] = e.detail[detailKey];\n        }\n      }) as EventListener;\n\n      listeners.set(propKey, { listener, service, eventType });\n      service.addEventListener(eventType, listener);\n    });\n  };\n\n  ctor.prototype.disconnectedCallback = function disconnectedCallback(\n    this: LitElement & Record<symbol, Map<string, { listener: EventListener; service: EventTarget; eventType: string }>>\n  ) {\n    const listeners = this[PROPERTY_LISTENERS];\n    if (listeners) {\n      listeners.forEach(({ listener, service, eventType }) => {\n        service.removeEventListener(eventType, listener);\n      });\n      listeners.clear();\n    }\n\n    originalDisconnected?.call(this);\n  };\n}\n\n/**\n * Patch connectedCallback/disconnectedCallback for event method bindings\n */\nfunction patchEventLifecycle(ctor: typeof ReactiveElement): void {\n  if ((ctor as unknown as Record<symbol, boolean>)[EVENT_PATCHED]) {\n    return;\n  }\n  (ctor as unknown as Record<symbol, boolean>)[EVENT_PATCHED] = true;\n\n  const originalConnected = ctor.prototype.connectedCallback;\n  const originalDisconnected = ctor.prototype.disconnectedCallback;\n\n  ctor.prototype.connectedCallback = function connectedCallback(\n    this: LitElement & Record<symbol, Map<string, { listener: EventListener; service: EventTarget; eventType: string }>>\n  ) {\n    originalConnected?.call(this);\n\n    const methods = (this.constructor as unknown as Record<symbol, EventBindingMeta[]>)[EVENT_METHODS];\n    if (!methods) return;\n\n    const listeners = new Map<string, { listener: EventListener; service: EventTarget; eventType: string }>();\n    this[EVENT_LISTENERS] = listeners;\n\n    methods.forEach(({ propertyKey, service, eventType, method }) => {\n      const listener = ((e: CustomEvent) => {\n        method.call(this, e.detail);\n      }) as EventListener;\n\n      listeners.set(propertyKey, { listener, service, eventType });\n      service.addEventListener(eventType, listener);\n    });\n  };\n\n  ctor.prototype.disconnectedCallback = function disconnectedCallback(\n    this: LitElement & Record<symbol, Map<string, { listener: EventListener; service: EventTarget; eventType: string }>>\n  ) {\n    const listeners = this[EVENT_LISTENERS];\n    if (listeners) {\n      listeners.forEach(({ listener, service, eventType }) => {\n        service.removeEventListener(eventType, listener);\n      });\n      listeners.clear();\n    }\n\n    originalDisconnected?.call(this);\n  };\n}\n"]}

package/dist/decorators/defaultServiceEventHandlers.d.ts

@@ -0,0 +1,89 @@
+import { EntityServiceEventMap, EntityServiceEventType } from "./EntityServiceTypes.js";
+/**
+ * Dispatch function type for entity service events.
+ * Accepts any function that can dispatch the standard EntityServiceEventType events.
+ * This allows extended event maps (like CubeServiceEventMap) to be used.
+ */
+type DispatchFn = (type: EntityServiceEventType, detail: EntityServiceEventMap[EntityServiceEventType]) => void;
+/**
+ * Options for creating default service event handlers.
+ */
+export interface DefaultServiceEventHandlersOptions {
+    /**
+     * Function to check if the service is still loading.
+     * Used by `onRequestFinished` to determine the busy state.
+     * If not provided, busy is set to false on request finish.
+     */
+    isLoading?: () => boolean;
+}
+/**
+ * ### DefaultServiceEventHandlers
+ *
+ * Creates default service handlers that dispatch standard events.
+ * Use this to reduce boilerplate when setting up service handlers.
+ *
+ * The `onResponse` handler is intentionally NOT included - you must provide your own
+ * implementation since response handling is typically service-specific.
+ *
+ * Usage:
+ * ```typescript
+ * class MyEntityService extends EventTarget {
+ *   private dispatch = createDispatch(this);
+ *
+ *   setupHandlers() {
+ *     this.service.Get.setHandlers({
+ *       ...DefaultServiceEventHandlers(this.dispatch),
+ *       onResponse: (response, serverResponse) => {
+ *         // Your custom response handling
+ *         this.entity.fromLiteral(response.entity);
+ *         this.dispatch("response-received", { response, serverResponse });
+ *       },
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * With loading check:
+ * ```typescript
+ * this.service.Get.setHandlers({
+ *   ...DefaultServiceEventHandlers(this.dispatch, {
+ *     isLoading: () => this.service.Get.isLoading || this.service.Update.isLoading,
+ *   }),
+ *   onResponse: (response, serverResponse) => { ... },
+ * });
+ * ```
+ *
+ * @param dispatch - Function to dispatch events (typically bound to the service's dispatchEvent)
+ * @param options - Optional configuration
+ * @returns Object with all standard handlers except onResponse
+ */
+export declare function DefaultServiceEventHandlers(dispatch: DispatchFn, options?: DefaultServiceEventHandlersOptions): {
+    onRequestStarted(request: unknown): void;
+    onRequestFinished(request: unknown): void;
+    onResponseError(parsedResponse: unknown, serverResponse: Response): void;
+    onResponseErrorRaw(serverResponse: Response): void;
+    onResponseRaw(serverResponse: Response): void;
+    onRequestAborted(reason: unknown): void;
+    onFatalError(error: unknown): void;
+};
+/**
+ * ### createDispatch
+ *
+ * Helper to create a typed dispatch function for an EventTarget.
+ *
+ * Usage:
+ * ```typescript
+ * class MyService extends EventTarget {
+ *   private dispatch = createDispatch(this);
+ *
+ *   doSomething() {
+ *     this.dispatch("busy-changed", { busy: true });
+ *   }
+ * }
+ * ```
+ *
+ * @param target - The EventTarget to dispatch events on
+ * @returns A typed dispatch function
+ */
+export declare function CreateDispatch(target: EventTarget): DispatchFn;
+export {};

package/dist/decorators/defaultServiceEventHandlers.js

@@ -0,0 +1,100 @@
+/**
+ * ### DefaultServiceEventHandlers
+ *
+ * Creates default service handlers that dispatch standard events.
+ * Use this to reduce boilerplate when setting up service handlers.
+ *
+ * The `onResponse` handler is intentionally NOT included - you must provide your own
+ * implementation since response handling is typically service-specific.
+ *
+ * Usage:
+ * ```typescript
+ * class MyEntityService extends EventTarget {
+ *   private dispatch = createDispatch(this);
+ *
+ *   setupHandlers() {
+ *     this.service.Get.setHandlers({
+ *       ...DefaultServiceEventHandlers(this.dispatch),
+ *       onResponse: (response, serverResponse) => {
+ *         // Your custom response handling
+ *         this.entity.fromLiteral(response.entity);
+ *         this.dispatch("response-received", { response, serverResponse });
+ *       },
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * With loading check:
+ * ```typescript
+ * this.service.Get.setHandlers({
+ *   ...DefaultServiceEventHandlers(this.dispatch, {
+ *     isLoading: () => this.service.Get.isLoading || this.service.Update.isLoading,
+ *   }),
+ *   onResponse: (response, serverResponse) => { ... },
+ * });
+ * ```
+ *
+ * @param dispatch - Function to dispatch events (typically bound to the service's dispatchEvent)
+ * @param options - Optional configuration
+ * @returns Object with all standard handlers except onResponse
+ */
+export function DefaultServiceEventHandlers(dispatch, options = {}) {
+    const { isLoading } = options;
+    return {
+        onRequestStarted(request) {
+            dispatch("request-started", { request });
+            dispatch("busy-changed", { busy: true });
+        },
+        onRequestFinished(request) {
+            dispatch("request-finished", { request });
+            dispatch("busy-changed", { busy: isLoading ? isLoading() : false });
+        },
+        onResponseError(parsedResponse, serverResponse) {
+            dispatch("response-error", { parsedResponse, serverResponse });
+            if (serverResponse.status === 404) {
+                dispatch("error-404", { serverResponse });
+            }
+            if (serverResponse.status >= 500) {
+                dispatch("error-5xx", { serverResponse });
+            }
+        },
+        onResponseErrorRaw(serverResponse) {
+            dispatch("raw-error", { serverResponse });
+        },
+        onResponseRaw(serverResponse) {
+            dispatch("raw-response", { serverResponse });
+        },
+        onRequestAborted(reason) {
+            dispatch("request-aborted", { reason: String(reason) });
+        },
+        onFatalError(error) {
+            dispatch("fatal-error", { error });
+        },
+    };
+}
+/**
+ * ### createDispatch
+ *
+ * Helper to create a typed dispatch function for an EventTarget.
+ *
+ * Usage:
+ * ```typescript
+ * class MyService extends EventTarget {
+ *   private dispatch = createDispatch(this);
+ *
+ *   doSomething() {
+ *     this.dispatch("busy-changed", { busy: true });
+ *   }
+ * }
+ * ```
+ *
+ * @param target - The EventTarget to dispatch events on
+ * @returns A typed dispatch function
+ */
+export function CreateDispatch(target) {
+    return function dispatchEvent(type, detail) {
+        target.dispatchEvent(new CustomEvent(type, { detail }));
+    };
+}
+//# sourceMappingURL=DefaultServiceEventHandlers.js.map

package/dist/decorators/defaultServiceEventHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultServiceEventHandlers.js","sourceRoot":"","sources":["../../src/decorators/DefaultServiceEventHandlers.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAoB,EAAE,UAA8C,EAAE;IAChH,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,OAAO;QACL,gBAAgB,CAAC,OAAgB;YAC/B,QAAQ,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACzC,QAAQ,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,iBAAiB,CAAC,OAAgB;YAChC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1C,QAAQ,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,eAAe,CAAC,cAAuB,EAAE,cAAwB;YAC/D,QAAQ,CAAC,gBAAgB,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC;YAC/D,IAAI,cAAc,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClC,QAAQ,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,cAAc,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBACjC,QAAQ,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,kBAAkB,CAAC,cAAwB;YACzC,QAAQ,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,aAAa,CAAC,cAAwB;YACpC,QAAQ,CAAC,cAAc,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,gBAAgB,CAAC,MAAe;YAC9B,QAAQ,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,YAAY,CAAC,KAAc;YACzB,QAAQ,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,OAAO,SAAS,aAAa,CAAmC,IAAO,EAAE,MAAgC;QACvG,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { EntityServiceEventMap, EntityServiceEventType } from \"./EntityServiceTypes\";\n\n/**\n * Dispatch function type for entity service events.\n * Accepts any function that can dispatch the standard EntityServiceEventType events.\n * This allows extended event maps (like CubeServiceEventMap) to be used.\n */\ntype DispatchFn = (type: EntityServiceEventType, detail: EntityServiceEventMap[EntityServiceEventType]) => void;\n\n/**\n * Options for creating default service event handlers.\n */\nexport interface DefaultServiceEventHandlersOptions {\n  /**\n   * Function to check if the service is still loading.\n   * Used by `onRequestFinished` to determine the busy state.\n   * If not provided, busy is set to false on request finish.\n   */\n  isLoading?: () => boolean;\n}\n\n/**\n * ### DefaultServiceEventHandlers\n *\n * Creates default service handlers that dispatch standard events.\n * Use this to reduce boilerplate when setting up service handlers.\n *\n * The `onResponse` handler is intentionally NOT included - you must provide your own\n * implementation since response handling is typically service-specific.\n *\n * Usage:\n * ```typescript\n * class MyEntityService extends EventTarget {\n *   private dispatch = createDispatch(this);\n *\n *   setupHandlers() {\n *     this.service.Get.setHandlers({\n *       ...DefaultServiceEventHandlers(this.dispatch),\n *       onResponse: (response, serverResponse) => {\n *         // Your custom response handling\n *         this.entity.fromLiteral(response.entity);\n *         this.dispatch(\"response-received\", { response, serverResponse });\n *       },\n *     });\n *   }\n * }\n * ```\n *\n * With loading check:\n * ```typescript\n * this.service.Get.setHandlers({\n *   ...DefaultServiceEventHandlers(this.dispatch, {\n *     isLoading: () => this.service.Get.isLoading || this.service.Update.isLoading,\n *   }),\n *   onResponse: (response, serverResponse) => { ... },\n * });\n * ```\n *\n * @param dispatch - Function to dispatch events (typically bound to the service's dispatchEvent)\n * @param options - Optional configuration\n * @returns Object with all standard handlers except onResponse\n */\nexport function DefaultServiceEventHandlers(dispatch: DispatchFn, options: DefaultServiceEventHandlersOptions = {}) {\n  const { isLoading } = options;\n\n  return {\n    onRequestStarted(request: unknown) {\n      dispatch(\"request-started\", { request });\n      dispatch(\"busy-changed\", { busy: true });\n    },\n\n    onRequestFinished(request: unknown) {\n      dispatch(\"request-finished\", { request });\n      dispatch(\"busy-changed\", { busy: isLoading ? isLoading() : false });\n    },\n\n    onResponseError(parsedResponse: unknown, serverResponse: Response) {\n      dispatch(\"response-error\", { parsedResponse, serverResponse });\n      if (serverResponse.status === 404) {\n        dispatch(\"error-404\", { serverResponse });\n      }\n      if (serverResponse.status >= 500) {\n        dispatch(\"error-5xx\", { serverResponse });\n      }\n    },\n\n    onResponseErrorRaw(serverResponse: Response) {\n      dispatch(\"raw-error\", { serverResponse });\n    },\n\n    onResponseRaw(serverResponse: Response) {\n      dispatch(\"raw-response\", { serverResponse });\n    },\n\n    onRequestAborted(reason: unknown) {\n      dispatch(\"request-aborted\", { reason: String(reason) });\n    },\n\n    onFatalError(error: unknown) {\n      dispatch(\"fatal-error\", { error });\n    },\n  };\n}\n\n/**\n * ### createDispatch\n *\n * Helper to create a typed dispatch function for an EventTarget.\n *\n * Usage:\n * ```typescript\n * class MyService extends EventTarget {\n *   private dispatch = createDispatch(this);\n *\n *   doSomething() {\n *     this.dispatch(\"busy-changed\", { busy: true });\n *   }\n * }\n * ```\n *\n * @param target - The EventTarget to dispatch events on\n * @returns A typed dispatch function\n */\nexport function CreateDispatch(target: EventTarget): DispatchFn {\n  return function dispatchEvent<K extends EntityServiceEventType>(type: K, detail: EntityServiceEventMap[K]) {\n    target.dispatchEvent(new CustomEvent(type, { detail }));\n  };\n}\n"]}

package/dist/index.d.ts

@@ -36,6 +36,15 @@ export { FieldMask } from './well_known/FieldMask.js';
 export { ARRAY } from './proxies/ARRAY.js';
 export { MAP } from './proxies/MAP.js';
 export { RECURSION } from './proxies/RECURSION.js';
+export { ServiceBindings } from './decorators/ServiceDecorators.js';
+export { ModelBindings } from './decorators/ModelDecorators.js';
+export type { ModelEventType } from './decorators/ModelDecorators.js';
+export { fieldBindings } from './decorators/FieldBindings.js';
+export type { BindableComponent, FieldNodeLike } from './decorators/FieldBindings.js';
+export { SchemaBuilder } from './decorators/SchemaBuilder.js';
+export { DefaultServiceEventHandlers, CreateDispatch } from './decorators/DefaultServiceEventHandlers.js';
+export type { EntityServiceEventType, TypedEntityService } from './decorators/EntityServiceTypes.js';
+export type { EntityServiceEventMap } from './decorators/EntityServiceTypes.js';
 export interface IAny {
     '@type': string;
     [key: string]: unknown;

package/dist/index.js

@@ -36,4 +36,10 @@ export { FieldMask } from './well_known/FieldMask.js';
 export { ARRAY } from './proxies/ARRAY.js';
 export { MAP } from './proxies/MAP.js';
 export { RECURSION } from './proxies/RECURSION.js';
+// Decorators
+export { ServiceBindings } from './decorators/ServiceDecorators.js';
+export { ModelBindings } from './decorators/ModelDecorators.js';
+export { fieldBindings } from './decorators/FieldBindings.js';
+export { SchemaBuilder } from './decorators/SchemaBuilder.js';
+export { DefaultServiceEventHandlers, CreateDispatch } from './decorators/DefaultServiceEventHandlers.js';
 //# sourceMappingURL=index.js.map