@m1kad0/hannah-proto 4.4.0 → 4.6.0

package/dist/v1/timer_admin.js

@@ -0,0 +1,273 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.1
+//   protoc               unknown
+// source: hannah/v1/timer_admin.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteTimerRequest = exports.GetTimersResponse = exports.GetTimersRequest = exports.Timer = exports.protobufPackage = void 0;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+exports.protobufPackage = "hannah.v1";
+function createBaseTimer() {
+    return { timerId: "", label: "", seconds: 0n, roomId: "", userId: 0 };
+}
+exports.Timer = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.timerId !== "") {
+            writer.uint32(10).string(message.timerId);
+        }
+        if (message.label !== "") {
+            writer.uint32(18).string(message.label);
+        }
+        if (message.seconds !== 0n) {
+            if (BigInt.asIntN(64, message.seconds) !== message.seconds) {
+                throw new globalThis.Error("value provided for field message.seconds of type int64 too large");
+            }
+            writer.uint32(24).int64(message.seconds);
+        }
+        if (message.roomId !== "") {
+            writer.uint32(34).string(message.roomId);
+        }
+        if (message.userId !== 0) {
+            writer.uint32(40).int32(message.userId);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseTimer();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 10) {
+                            break;
+                        }
+                        message.timerId = reader.string();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 18) {
+                            break;
+                        }
+                        message.label = reader.string();
+                        continue;
+                    }
+                    case 3: {
+                        if (tag !== 24) {
+                            break;
+                        }
+                        message.seconds = reader.int64();
+                        continue;
+                    }
+                    case 4: {
+                        if (tag !== 34) {
+                            break;
+                        }
+                        message.roomId = reader.string();
+                        continue;
+                    }
+                    case 5: {
+                        if (tag !== 40) {
+                            break;
+                        }
+                        message.userId = reader.int32();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.Timer.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseTimer();
+        message.timerId = object.timerId ?? "";
+        message.label = object.label ?? "";
+        message.seconds = (object.seconds !== undefined && object.seconds !== null) ? BigInt(object.seconds) : 0n;
+        message.roomId = object.roomId ?? "";
+        message.userId = object.userId ?? 0;
+        return message;
+    },
+};
+function createBaseGetTimersRequest() {
+    return { userId: 0 };
+}
+exports.GetTimersRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.userId !== 0) {
+            writer.uint32(8).int32(message.userId);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseGetTimersRequest();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 8) {
+                            break;
+                        }
+                        message.userId = reader.int32();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.GetTimersRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseGetTimersRequest();
+        message.userId = object.userId ?? 0;
+        return message;
+    },
+};
+function createBaseGetTimersResponse() {
+    return { timers: [] };
+}
+exports.GetTimersResponse = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        for (const v of message.timers) {
+            exports.Timer.encode(v, writer.uint32(10).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseGetTimersResponse();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 10) {
+                            break;
+                        }
+                        message.timers.push(exports.Timer.decode(reader, reader.uint32()));
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.GetTimersResponse.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseGetTimersResponse();
+        message.timers = object.timers?.map((e) => exports.Timer.fromPartial(e)) || [];
+        return message;
+    },
+};
+function createBaseDeleteTimerRequest() {
+    return { timerId: "", requestorId: 0 };
+}
+exports.DeleteTimerRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.timerId !== "") {
+            writer.uint32(10).string(message.timerId);
+        }
+        if (message.requestorId !== 0) {
+            writer.uint32(16).int32(message.requestorId);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const previousRecursionDepth = reader.__tsProtoDecodeDepth ?? 0;
+        if (previousRecursionDepth >= 100) {
+            throw new globalThis.Error("protobuf decode recursion limit exceeded");
+        }
+        reader.__tsProtoDecodeDepth = previousRecursionDepth + 1;
+        try {
+            const end = length === undefined ? reader.len : reader.pos + length;
+            const message = createBaseDeleteTimerRequest();
+            while (reader.pos < end) {
+                const tag = reader.uint32();
+                switch (tag >>> 3) {
+                    case 1: {
+                        if (tag !== 10) {
+                            break;
+                        }
+                        message.timerId = reader.string();
+                        continue;
+                    }
+                    case 2: {
+                        if (tag !== 16) {
+                            break;
+                        }
+                        message.requestorId = reader.int32();
+                        continue;
+                    }
+                }
+                if ((tag & 7) === 4 || tag === 0) {
+                    break;
+                }
+                reader.skip(tag & 7);
+            }
+            return message;
+        }
+        finally {
+            reader.__tsProtoDecodeDepth = previousRecursionDepth;
+        }
+    },
+    create(base) {
+        return exports.DeleteTimerRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseDeleteTimerRequest();
+        message.timerId = object.timerId ?? "";
+        message.requestorId = object.requestorId ?? 0;
+        return message;
+    },
+};

package/dist/v1/timer_service.d.ts

@@ -0,0 +1,133 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "hannah.v1";
+/** Sent by Hannah Core over the TimerConnect stream. */
+export interface TimerCommand {
+    /** create a new timer */
+    create?: TimerCreate | undefined;
+    /** cancel an existing timer */
+    cancel?: TimerCancel | undefined;
+    /** request current timer list */
+    list?: TimerListRequest | undefined;
+    /** Hannah is ready to receive pending fired events */
+    ready?: TimerReady | undefined;
+    /** Hannah is temporarily unable to process timer firings */
+    notReady?: TimerNotReady | undefined;
+}
+/**
+ * Hannah signals that she is ready to receive queued TimerFired events.
+ * Sent after startup once ioBroker states are loaded. The service flushes
+ * any TimerFired events that occurred while Hannah was offline, in order.
+ */
+export interface TimerReady {
+}
+/**
+ * Hannah signals a temporary degraded state — the Timer Service should hold
+ * any TimerFired events in its queue until a subsequent TimerReady is received.
+ * Hannah sends this when core subsystems are unavailable (e.g. ioBroker disconnected).
+ */
+export interface TimerNotReady {
+    /** human-readable reason, e.g. "ioBroker disconnected" */
+    reason?: string | undefined;
+}
+/** Hannah instructs the timer service to create a new timer. */
+export interface TimerCreate {
+    /** UUID assigned by Hannah */
+    timerId: string;
+    /** human-readable label, e.g. "Spazieren gehen" */
+    label: string;
+    /** Unix timestamp (seconds) when to fire */
+    fireAt: bigint;
+    /** opaque to the Timer Service — e.g. "room", "roomie_id", "trigger_id" */
+    metadata: {
+        [key: string]: string;
+    };
+}
+export interface TimerCreate_MetadataEntry {
+    key: string;
+    value: string;
+}
+/** Hannah instructs the timer service to cancel a timer. */
+export interface TimerCancel {
+    timerId: string;
+}
+/** Hannah requests the current list of active timers (e.g. "welche Timer habe ich?"). */
+export interface TimerListRequest {
+}
+/** Sent by the Timer Service over the TimerConnect stream. */
+export interface TimerMessage {
+    /** initial confirmation when stream is established */
+    ack?: TimerAck | undefined;
+    /** a timer has expired */
+    fired?: TimerFired | undefined;
+    /** response to TimerListRequest */
+    list?: TimerListResponse | undefined;
+}
+/** Sent once by the Timer Service after TimerConnect stream is established. */
+export interface TimerAck {
+    /** human-readable status */
+    message: string;
+    /** number of timers currently tracked */
+    activeTimers: number;
+}
+/** Timer Service notifies Hannah that a timer has expired. */
+export interface TimerFired {
+    timerId: string;
+    /** convenience copy for logging */
+    label: string;
+    /** echoed verbatim from TimerCreate */
+    metadata: {
+        [key: string]: string;
+    };
+}
+export interface TimerFired_MetadataEntry {
+    key: string;
+    value: string;
+}
+/** Response to TimerListRequest — used for sync and "welche Timer habe ich?" queries. */
+export interface TimerListResponse {
+    timers: TimerInfo[];
+}
+export interface TimerInfo {
+    timerId: string;
+    label: string;
+    /** Unix timestamp (seconds) */
+    fireAt: bigint;
+    metadata: {
+        [key: string]: string;
+    };
+}
+export interface TimerInfo_MetadataEntry {
+    key: string;
+    value: string;
+}
+export declare const TimerCommand: MessageFns<TimerCommand>;
+export declare const TimerReady: MessageFns<TimerReady>;
+export declare const TimerNotReady: MessageFns<TimerNotReady>;
+export declare const TimerCreate: MessageFns<TimerCreate>;
+export declare const TimerCreate_MetadataEntry: MessageFns<TimerCreate_MetadataEntry>;
+export declare const TimerCancel: MessageFns<TimerCancel>;
+export declare const TimerListRequest: MessageFns<TimerListRequest>;
+export declare const TimerMessage: MessageFns<TimerMessage>;
+export declare const TimerAck: MessageFns<TimerAck>;
+export declare const TimerFired: MessageFns<TimerFired>;
+export declare const TimerFired_MetadataEntry: MessageFns<TimerFired_MetadataEntry>;
+export declare const TimerListResponse: MessageFns<TimerListResponse>;
+export declare const TimerInfo: MessageFns<TimerInfo>;
+export declare const TimerInfo_MetadataEntry: MessageFns<TimerInfo_MetadataEntry>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+export type DeepPartial<T> = T extends bigint ? string | number | bigint : T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};