@xeonr/upload-pool-sdk 1.0.0

package/src/protocol/uplim/api/v1/events_pb.ts

@@ -0,0 +1,874 @@
+// @generated by protoc-gen-es v2.10.1 with parameter "target=ts,import_extension=.js"
+// @generated from file uplim/api/v1/events.proto (package uplim.api.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+import type { Folder, MetaUploadType, Upload } from "./uploads_pb.js";
+import { file_uplim_api_v1_uploads } from "./uploads_pb.js";
+import type { Bucket } from "./buckets_pb.js";
+import { file_uplim_api_v1_buckets } from "./buckets_pb.js";
+import { file_uplim_api_v1_account } from "./account_pb.js";
+import type { PublicFolderItem, PublicUpload } from "./public-uploads_pb.js";
+import { file_uplim_api_v1_public_uploads } from "./public-uploads_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+
+/**
+ * Describes the file uplim/api/v1/events.proto.
+ */
+export const file_uplim_api_v1_events: GenFile = /*@__PURE__*/
+  fileDesc("Chl1cGxpbS9hcGkvdjEvZXZlbnRzLnByb3RvEgx1cGxpbS5hcGkudjEijQEKElN1YnNjcmlwdGlvbkZpbHRlchIuCgxjaGFuZ2VfdHlwZXMYASADKA4yGC51cGxpbS5hcGkudjEuQ2hhbmdlVHlwZRIyCg5yZXNvdXJjZV90eXBlcxgCIAMoDjIaLnVwbGltLmFwaS52MS5DaGFuZ2VUYXJnZXQSEwoLcGF0aF9wcmVmaXgYAyABKAki2g8KDkV2ZW50c1RvQ2xpZW50EjMKBWhlbGxvGAEgASgLMiIudXBsaW0uYXBpLnYxLkV2ZW50c1RvQ2xpZW50LkhlbGxvSAASRgoPcmVzb3VyY2VfY2hhbmdlGAIgASgLMisudXBsaW0uYXBpLnYxLkV2ZW50c1RvQ2xpZW50LlJlc291cmNlQ2hhbmdlSAASMwoFZXJyb3IYAyABKAsyIi51cGxpbS5hcGkudjEuRXZlbnRzVG9DbGllbnQuRXJyb3JIABJCCg1zdWJzY3JpYmVfYWNrGAQgASgLMikudXBsaW0uYXBpLnYxLkV2ZW50c1RvQ2xpZW50LlN1YnNjcmliZUFja0gAEkYKD3Vuc3Vic2NyaWJlX2FjaxgFIAEoCzIrLnVwbGltLmFwaS52MS5FdmVudHNUb0NsaWVudC5VbnN1YnNjcmliZUFja0gAEjEKBHBvbmcYBiABKAsyIS51cGxpbS5hcGkudjEuRXZlbnRzVG9DbGllbnQuUG9uZ0gAEkAKDHJlcGxheV9iYXRjaBgHIAEoCzIoLnVwbGltLmFwaS52MS5FdmVudHNUb0NsaWVudC5SZXBsYXlCYXRjaEgAEkYKD3JlcGxheV9jb21wbGV0ZRgIIAEoCzIrLnVwbGltLmFwaS52MS5FdmVudHNUb0NsaWVudC5SZXBsYXlDb21wbGV0ZUgAEj4KC2xvZ19leHBpcmVkGAkgASgLMicudXBsaW0uYXBpLnYxLkV2ZW50c1RvQ2xpZW50LkxvZ0V4cGlyZWRIABJTChZwdWJsaWNfcmVzb3VyY2VfY2hhbmdlGAogASgLMjEudXBsaW0uYXBpLnYxLkV2ZW50c1RvQ2xpZW50LlB1YmxpY1Jlc291cmNlQ2hhbmdlSAAaLgoFSGVsbG8SEgoKYnVja2V0X2lkcxgBIAMoCRIRCglzb2NrZXRfaWQYAiABKAkalQMKDlJlc291cmNlQ2hhbmdlEi0KC2NoYW5nZV90eXBlGAEgASgOMhgudXBsaW0uYXBpLnYxLkNoYW5nZVR5cGUSKgoGdGFyZ2V0GAIgASgOMhoudXBsaW0uYXBpLnYxLkNoYW5nZVRhcmdldBIRCgl0YXJnZXRfaWQYAyABKAkSJgoGdXBsb2FkGAQgASgLMhQudXBsaW0uYXBpLnYxLlVwbG9hZEgAEiYKBmZvbGRlchgFIAEoCzIULnVwbGltLmFwaS52MS5Gb2xkZXJIABImCgZidWNrZXQYBiABKAsyFC51cGxpbS5hcGkudjEuQnVja2V0SAASLgoMdXBkYXRlX2hpbnRzGAcgAygOMhgudXBsaW0uYXBpLnYxLlVwZGF0ZUhpbnQSOAoSbWV0YV90eXBlc19jaGFuZ2VkGAggAygOMhwudXBsaW0uYXBpLnYxLk1ldGFVcGxvYWRUeXBlEhEKCWJ1Y2tldF9pZBgJIAEoCRIUCghldmVudF9pZBgKIAEoBEICMAFCCgoIcmVzb3VyY2UaGAoFRXJyb3ISDwoHbWVzc2FnZRgBIAEoCRpYCgxTdWJzY3JpYmVBY2sSFwoPc3Vic2NyaXB0aW9uX2lkGAEgASgJEhEKCWJ1Y2tldF9pZBgCIAEoCRIcChBjdXJyZW50X2V2ZW50X2lkGAMgASgEQgIwARopCg5VbnN1YnNjcmliZUFjaxIXCg9zdWJzY3JpcHRpb25faWQYASABKAkaEgoEUG9uZxIKCgJpZBgBIAEoCRqYAQoLUmVwbGF5QmF0Y2gSFwoPc3Vic2NyaXB0aW9uX2lkGAEgASgJEhEKCWJ1Y2tldF9pZBgCIAEoCRIRCgliYXRjaF9zZXEYAyABKA0SOwoGZXZlbnRzGAQgAygLMisudXBsaW0uYXBpLnYxLkV2ZW50c1RvQ2xpZW50LlJlc291cmNlQ2hhbmdlEg0KBWZpbmFsGAUgASgIGlcKDlJlcGxheUNvbXBsZXRlEhcKD3N1YnNjcmlwdGlvbl9pZBgBIAEoCRIRCglidWNrZXRfaWQYAiABKAkSGQoNbGFzdF9ldmVudF9pZBgDIAEoBEICMAEaXwoKTG9nRXhwaXJlZBIXCg9zdWJzY3JpcHRpb25faWQYASABKAkSEQoJYnVja2V0X2lkGAIgASgJEiUKGW9sZGVzdF9hdmFpbGFibGVfZXZlbnRfaWQYAyABKARCAjABGt8CChRQdWJsaWNSZXNvdXJjZUNoYW5nZRItCgtjaGFuZ2VfdHlwZRgBIAEoDjIYLnVwbGltLmFwaS52MS5DaGFuZ2VUeXBlEioKBnRhcmdldBgCIAEoDjIaLnVwbGltLmFwaS52MS5DaGFuZ2VUYXJnZXQSEQoJdGFyZ2V0X2lkGAMgASgJEiwKBnVwbG9hZBgEIAEoCzIaLnVwbGltLmFwaS52MS5QdWJsaWNVcGxvYWRIABI1Cgtmb2xkZXJfaXRlbRgFIAEoCzIeLnVwbGltLmFwaS52MS5QdWJsaWNGb2xkZXJJdGVtSAASLgoMdXBkYXRlX2hpbnRzGAcgAygOMhgudXBsaW0uYXBpLnYxLlVwZGF0ZUhpbnQSOAoSbWV0YV90eXBlc19jaGFuZ2VkGAggAygOMhwudXBsaW0uYXBpLnYxLk1ldGFVcGxvYWRUeXBlQgoKCHJlc291cmNlQgYKBHR5cGUi5AUKDkV2ZW50c1RvU2VydmVyEjsKCXN1YnNjcmliZRgBIAEoCzImLnVwbGltLmFwaS52MS5FdmVudHNUb1NlcnZlci5TdWJzY3JpYmVIABI/Cgt1bnN1YnNjcmliZRgCIAEoCzIoLnVwbGltLmFwaS52MS5FdmVudHNUb1NlcnZlci5VbnN1YnNjcmliZUgAEjEKBHBpbmcYAyABKAsyIS51cGxpbS5hcGkudjEuRXZlbnRzVG9TZXJ2ZXIuUGluZ0gAEkcKEHJlcGxheV9iYXRjaF9hY2sYBCABKAsyKy51cGxpbS5hcGkudjEuRXZlbnRzVG9TZXJ2ZXIuUmVwbGF5QmF0Y2hBY2tIABJIChBwdWJsaWNfc3Vic2NyaWJlGAUgASgLMiwudXBsaW0uYXBpLnYxLkV2ZW50c1RvU2VydmVyLlB1YmxpY1N1YnNjcmliZUgAGtkBCglTdWJzY3JpYmUSFAoKZXZlcnl0aGluZxgBIAEoCEgAEhMKCWJ1Y2tldF9pZBgCIAEoCUgAEhYKCXVwbG9hZF9pZBgDIAEoCUgBiAEBEjUKBmZpbHRlchgEIAEoCzIgLnVwbGltLmFwaS52MS5TdWJzY3JpcHRpb25GaWx0ZXJIAogBARIeCg1sYXN0X2V2ZW50X2lkGAUgASgEQgIwAUgDiAEBQgcKBXNjb3BlQgwKCl91cGxvYWRfaWRCCQoHX2ZpbHRlckIQCg5fbGFzdF9ldmVudF9pZBomCgtVbnN1YnNjcmliZRIXCg9zdWJzY3JpcHRpb25faWQYASABKAkaPAoOUmVwbGF5QmF0Y2hBY2sSFwoPc3Vic2NyaXB0aW9uX2lkGAEgASgJEhEKCWJhdGNoX3NlcRgCIAEoDRoSCgRQaW5nEgoKAmlkGAEgASgJGjAKD1B1YmxpY1N1YnNjcmliZRIdChV3c19zdWJzY3JpcHRpb25fdG9rZW4YASABKAlCBgoEdHlwZSpxCgpDaGFuZ2VUeXBlEhsKF0NIQU5HRV9UWVBFX1VOU1BFQ0lGSUVEEAASFgoSQ0hBTkdFX1RZUEVfQ1JFQVRFEAESFgoSQ0hBTkdFX1RZUEVfVVBEQVRFEAISFgoSQ0hBTkdFX1RZUEVfREVMRVRFEAMqlgEKDENoYW5nZVRhcmdldBIdChlDSEFOR0VfVEFSR0VUX1VOU1BFQ0lGSUVEEAASGAoUQ0hBTkdFX1RBUkdFVF9CVUNLRVQQARIYChRDSEFOR0VfVEFSR0VUX0ZPTERFUhACEhgKFENIQU5HRV9UQVJHRVRfVVBMT0FEEAMSGQoVQ0hBTkdFX1RBUkdFVF9BQ0NPVU5UEAQqyAIKClVwZGF0ZUhpbnQSGwoXVVBEQVRFX0hJTlRfVU5TUEVDSUZJRUQQABIUChBVUERBVEVfSElOVF9UQUdTEAESFAoQVVBEQVRFX0hJTlRfUEFUSBADEhQKEFVQREFURV9ISU5UX1NMVUcQBBIXChNVUERBVEVfSElOVF9QUklWQVRFEAUSFAoQVVBEQVRFX0hJTlRfVFlQRRAGEhoKFlVQREFURV9ISU5UX1ZJUlVTX1NDQU4QBxIbChdVUERBVEVfSElOVF9BSV9NRVRBREFUQRAIEhwKGFVQREFURV9ISU5UX01FVEFfVVBMT0FEUxAJEhgKFFVQREFURV9ISU5UX01FVEFEQVRBEAoSFQoRVVBEQVRFX0hJTlRfT1JERVIQCxIeChpVUERBVEVfSElOVF9BQ0NFU1NfUkVWT0tFRBAMIgQIAhACQq4BChBjb20udXBsaW0uYXBpLnYxQgtFdmVudHNQcm90b1ABWjtnaXRodWIuY29tL3hlb25yL3VwbC1pbS1hcGkvcHJvdG8vZ2VuL3VwbGltL2FwaS92MTt1cGxpbV92MaICA1VBWKoCDFVwbGltLkFwaS5WMcoCDFVwbGltXEFwaVxWMeICGFVwbGltXEFwaVxWMVxHUEJNZXRhZGF0YeoCDlVwbGltOjpBcGk6OlYxYgZwcm90bzM", [file_google_protobuf_timestamp, file_uplim_api_v1_uploads, file_uplim_api_v1_buckets, file_uplim_api_v1_account, file_uplim_api_v1_public_uploads]);
+
+/**
+ * Filters for event subscriptions
+ *
+ * @generated from message uplim.api.v1.SubscriptionFilter
+ */
+export type SubscriptionFilter = Message<"uplim.api.v1.SubscriptionFilter"> & {
+  /**
+   * Only receive events of these types (empty = all types)
+   *
+   * @generated from field: repeated uplim.api.v1.ChangeType change_types = 1;
+   */
+  changeTypes: ChangeType[];
+
+  /**
+   * Only receive events for these resource types (empty = all resources)
+   *
+   * @generated from field: repeated uplim.api.v1.ChangeTarget resource_types = 2;
+   */
+  resourceTypes: ChangeTarget[];
+
+  /**
+   * Only receive events where path starts with this prefix (empty = all paths)
+   *
+   * @generated from field: string path_prefix = 3;
+   */
+  pathPrefix: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.SubscriptionFilter.
+ * Use `create(SubscriptionFilterSchema)` to create a new message.
+ */
+export const SubscriptionFilterSchema: GenMessage<SubscriptionFilter> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 0);
+
+/**
+ * Server-to-client event messages sent over the WebSocket connection
+ *
+ * @generated from message uplim.api.v1.EventsToClient
+ */
+export type EventsToClient = Message<"uplim.api.v1.EventsToClient"> & {
+  /**
+   * @generated from oneof uplim.api.v1.EventsToClient.type
+   */
+  type: {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.Hello hello = 1;
+     */
+    value: EventsToClient_Hello;
+    case: "hello";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.ResourceChange resource_change = 2;
+     */
+    value: EventsToClient_ResourceChange;
+    case: "resourceChange";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.Error error = 3;
+     */
+    value: EventsToClient_Error;
+    case: "error";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.SubscribeAck subscribe_ack = 4;
+     */
+    value: EventsToClient_SubscribeAck;
+    case: "subscribeAck";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.UnsubscribeAck unsubscribe_ack = 5;
+     */
+    value: EventsToClient_UnsubscribeAck;
+    case: "unsubscribeAck";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.Pong pong = 6;
+     */
+    value: EventsToClient_Pong;
+    case: "pong";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.ReplayBatch replay_batch = 7;
+     */
+    value: EventsToClient_ReplayBatch;
+    case: "replayBatch";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.ReplayComplete replay_complete = 8;
+     */
+    value: EventsToClient_ReplayComplete;
+    case: "replayComplete";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.LogExpired log_expired = 9;
+     */
+    value: EventsToClient_LogExpired;
+    case: "logExpired";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToClient.PublicResourceChange public_resource_change = 10;
+     */
+    value: EventsToClient_PublicResourceChange;
+    case: "publicResourceChange";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.
+ * Use `create(EventsToClientSchema)` to create a new message.
+ */
+export const EventsToClientSchema: GenMessage<EventsToClient> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1);
+
+/**
+ * Initial handshake message sent when the connection is established
+ *
+ * @generated from message uplim.api.v1.EventsToClient.Hello
+ */
+export type EventsToClient_Hello = Message<"uplim.api.v1.EventsToClient.Hello"> & {
+  /**
+   * Bucket IDs the user has access to
+   *
+   * @generated from field: repeated string bucket_ids = 1;
+   */
+  bucketIds: string[];
+
+  /**
+   * Unique identifier for this WebSocket connection
+   *
+   * @generated from field: string socket_id = 2;
+   */
+  socketId: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.Hello.
+ * Use `create(EventsToClient_HelloSchema)` to create a new message.
+ */
+export const EventsToClient_HelloSchema: GenMessage<EventsToClient_Hello> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 0);
+
+/**
+ * @generated from message uplim.api.v1.EventsToClient.ResourceChange
+ */
+export type EventsToClient_ResourceChange = Message<"uplim.api.v1.EventsToClient.ResourceChange"> & {
+  /**
+   * @generated from field: uplim.api.v1.ChangeType change_type = 1;
+   */
+  changeType: ChangeType;
+
+  /**
+   * @generated from field: uplim.api.v1.ChangeTarget target = 2;
+   */
+  target: ChangeTarget;
+
+  /**
+   * @generated from field: string target_id = 3;
+   */
+  targetId: string;
+
+  /**
+   * @generated from oneof uplim.api.v1.EventsToClient.ResourceChange.resource
+   */
+  resource: {
+    /**
+     * @generated from field: uplim.api.v1.Upload upload = 4;
+     */
+    value: Upload;
+    case: "upload";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.Folder folder = 5;
+     */
+    value: Folder;
+    case: "folder";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.Bucket bucket = 6;
+     */
+    value: Bucket;
+    case: "bucket";
+  } | { case: undefined; value?: undefined };
+
+  /**
+   * For UPDATE events: hints about what changed
+   *
+   * @generated from field: repeated uplim.api.v1.UpdateHint update_hints = 7;
+   */
+  updateHints: UpdateHint[];
+
+  /**
+   * For META_UPLOADS updates: which meta types were added/updated
+   *
+   * @generated from field: repeated uplim.api.v1.MetaUploadType meta_types_changed = 8;
+   */
+  metaTypesChanged: MetaUploadType[];
+
+  /**
+   * The bucket this event belongs to (for upload, folder, and bucket events)
+   *
+   * @generated from field: string bucket_id = 9;
+   */
+  bucketId: string;
+
+  /**
+   * Monotonic per-bucket sequence number. Always > 0 on persisted events.
+   * Used by clients for replay watermarking.
+   *
+   * @generated from field: uint64 event_id = 10 [jstype = JS_STRING];
+   */
+  eventId: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.ResourceChange.
+ * Use `create(EventsToClient_ResourceChangeSchema)` to create a new message.
+ */
+export const EventsToClient_ResourceChangeSchema: GenMessage<EventsToClient_ResourceChange> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 1);
+
+/**
+ * Error message from the server
+ *
+ * @generated from message uplim.api.v1.EventsToClient.Error
+ */
+export type EventsToClient_Error = Message<"uplim.api.v1.EventsToClient.Error"> & {
+  /**
+   * Human-readable error description
+   *
+   * @generated from field: string message = 1;
+   */
+  message: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.Error.
+ * Use `create(EventsToClient_ErrorSchema)` to create a new message.
+ */
+export const EventsToClient_ErrorSchema: GenMessage<EventsToClient_Error> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 2);
+
+/**
+ * Acknowledgement that a subscription was created
+ *
+ * @generated from message uplim.api.v1.EventsToClient.SubscribeAck
+ */
+export type EventsToClient_SubscribeAck = Message<"uplim.api.v1.EventsToClient.SubscribeAck"> & {
+  /**
+   * Unique identifier for the subscription (used to unsubscribe)
+   *
+   * @generated from field: string subscription_id = 1;
+   */
+  subscriptionId: string;
+
+  /**
+   * The bucket ID subscribed to (empty if subscribing to everything)
+   *
+   * @generated from field: string bucket_id = 2;
+   */
+  bucketId: string;
+
+  /**
+   * The bucket's current event_id at the moment of subscription.
+   * For new subscriptions (last_event_id = 0), this is the watermark
+   * the client should persist.
+   *
+   * @generated from field: uint64 current_event_id = 3 [jstype = JS_STRING];
+   */
+  currentEventId: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.SubscribeAck.
+ * Use `create(EventsToClient_SubscribeAckSchema)` to create a new message.
+ */
+export const EventsToClient_SubscribeAckSchema: GenMessage<EventsToClient_SubscribeAck> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 3);
+
+/**
+ * Acknowledgement that a subscription was removed
+ *
+ * @generated from message uplim.api.v1.EventsToClient.UnsubscribeAck
+ */
+export type EventsToClient_UnsubscribeAck = Message<"uplim.api.v1.EventsToClient.UnsubscribeAck"> & {
+  /**
+   * The subscription that was removed
+   *
+   * @generated from field: string subscription_id = 1;
+   */
+  subscriptionId: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.UnsubscribeAck.
+ * Use `create(EventsToClient_UnsubscribeAckSchema)` to create a new message.
+ */
+export const EventsToClient_UnsubscribeAckSchema: GenMessage<EventsToClient_UnsubscribeAck> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 4);
+
+/**
+ * Response to a client ping (keepalive)
+ *
+ * @generated from message uplim.api.v1.EventsToClient.Pong
+ */
+export type EventsToClient_Pong = Message<"uplim.api.v1.EventsToClient.Pong"> & {
+  /**
+   * Echoed ping ID
+   *
+   * @generated from field: string id = 1;
+   */
+  id: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.Pong.
+ * Use `create(EventsToClient_PongSchema)` to create a new message.
+ */
+export const EventsToClient_PongSchema: GenMessage<EventsToClient_Pong> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 5);
+
+/**
+ * A batch of replayed events sent during the replay phase
+ *
+ * @generated from message uplim.api.v1.EventsToClient.ReplayBatch
+ */
+export type EventsToClient_ReplayBatch = Message<"uplim.api.v1.EventsToClient.ReplayBatch"> & {
+  /**
+   * @generated from field: string subscription_id = 1;
+   */
+  subscriptionId: string;
+
+  /**
+   * @generated from field: string bucket_id = 2;
+   */
+  bucketId: string;
+
+  /**
+   * Monotonic per-subscription batch number, starts at 1
+   *
+   * @generated from field: uint32 batch_seq = 3;
+   */
+  batchSeq: number;
+
+  /**
+   * Events in this batch, ordered by event_id ascending
+   *
+   * @generated from field: repeated uplim.api.v1.EventsToClient.ResourceChange events = 4;
+   */
+  events: EventsToClient_ResourceChange[];
+
+  /**
+   * True on the last batch; ReplayComplete follows after client acks this
+   *
+   * @generated from field: bool final = 5;
+   */
+  final: boolean;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.ReplayBatch.
+ * Use `create(EventsToClient_ReplayBatchSchema)` to create a new message.
+ */
+export const EventsToClient_ReplayBatchSchema: GenMessage<EventsToClient_ReplayBatch> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 6);
+
+/**
+ * Marks the end of the replay phase; all further events are live
+ *
+ * @generated from message uplim.api.v1.EventsToClient.ReplayComplete
+ */
+export type EventsToClient_ReplayComplete = Message<"uplim.api.v1.EventsToClient.ReplayComplete"> & {
+  /**
+   * @generated from field: string subscription_id = 1;
+   */
+  subscriptionId: string;
+
+  /**
+   * @generated from field: string bucket_id = 2;
+   */
+  bucketId: string;
+
+  /**
+   * The largest event_id included in the replay
+   *
+   * @generated from field: uint64 last_event_id = 3 [jstype = JS_STRING];
+   */
+  lastEventId: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.ReplayComplete.
+ * Use `create(EventsToClient_ReplayCompleteSchema)` to create a new message.
+ */
+export const EventsToClient_ReplayCompleteSchema: GenMessage<EventsToClient_ReplayComplete> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 7);
+
+/**
+ * The client's last_event_id is older than the retention window.
+ * The subscription is closed after this frame; client must re-list
+ * and re-subscribe with last_event_id = 0.
+ *
+ * @generated from message uplim.api.v1.EventsToClient.LogExpired
+ */
+export type EventsToClient_LogExpired = Message<"uplim.api.v1.EventsToClient.LogExpired"> & {
+  /**
+   * @generated from field: string subscription_id = 1;
+   */
+  subscriptionId: string;
+
+  /**
+   * @generated from field: string bucket_id = 2;
+   */
+  bucketId: string;
+
+  /**
+   * The oldest event_id still available in the log
+   *
+   * @generated from field: uint64 oldest_available_event_id = 3 [jstype = JS_STRING];
+   */
+  oldestAvailableEventId: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.LogExpired.
+ * Use `create(EventsToClient_LogExpiredSchema)` to create a new message.
+ */
+export const EventsToClient_LogExpiredSchema: GenMessage<EventsToClient_LogExpired> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 8);
+
+/**
+ * Resource change delivered to a public (unauthenticated) subscription.
+ * Carries the stripped public projection of an Upload or folder item so
+ * no internal fields leak to portal viewers.
+ *
+ * @generated from message uplim.api.v1.EventsToClient.PublicResourceChange
+ */
+export type EventsToClient_PublicResourceChange = Message<"uplim.api.v1.EventsToClient.PublicResourceChange"> & {
+  /**
+   * @generated from field: uplim.api.v1.ChangeType change_type = 1;
+   */
+  changeType: ChangeType;
+
+  /**
+   * @generated from field: uplim.api.v1.ChangeTarget target = 2;
+   */
+  target: ChangeTarget;
+
+  /**
+   * @generated from field: string target_id = 3;
+   */
+  targetId: string;
+
+  /**
+   * @generated from oneof uplim.api.v1.EventsToClient.PublicResourceChange.resource
+   */
+  resource: {
+    /**
+     * @generated from field: uplim.api.v1.PublicUpload upload = 4;
+     */
+    value: PublicUpload;
+    case: "upload";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.PublicFolderItem folder_item = 5;
+     */
+    value: PublicFolderItem;
+    case: "folderItem";
+  } | { case: undefined; value?: undefined };
+
+  /**
+   * For UPDATE events: hints about what changed.
+   * UPDATE_HINT_ACCESS_REVOKED signals the subscription is about to close.
+   *
+   * @generated from field: repeated uplim.api.v1.UpdateHint update_hints = 7;
+   */
+  updateHints: UpdateHint[];
+
+  /**
+   * For META_UPLOADS updates: which meta types were added/updated
+   *
+   * @generated from field: repeated uplim.api.v1.MetaUploadType meta_types_changed = 8;
+   */
+  metaTypesChanged: MetaUploadType[];
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToClient.PublicResourceChange.
+ * Use `create(EventsToClient_PublicResourceChangeSchema)` to create a new message.
+ */
+export const EventsToClient_PublicResourceChangeSchema: GenMessage<EventsToClient_PublicResourceChange> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 1, 9);
+
+/**
+ * Client-to-server event messages sent over the WebSocket connection
+ *
+ * @generated from message uplim.api.v1.EventsToServer
+ */
+export type EventsToServer = Message<"uplim.api.v1.EventsToServer"> & {
+  /**
+   * @generated from oneof uplim.api.v1.EventsToServer.type
+   */
+  type: {
+    /**
+     * @generated from field: uplim.api.v1.EventsToServer.Subscribe subscribe = 1;
+     */
+    value: EventsToServer_Subscribe;
+    case: "subscribe";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToServer.Unsubscribe unsubscribe = 2;
+     */
+    value: EventsToServer_Unsubscribe;
+    case: "unsubscribe";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToServer.Ping ping = 3;
+     */
+    value: EventsToServer_Ping;
+    case: "ping";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToServer.ReplayBatchAck replay_batch_ack = 4;
+     */
+    value: EventsToServer_ReplayBatchAck;
+    case: "replayBatchAck";
+  } | {
+    /**
+     * @generated from field: uplim.api.v1.EventsToServer.PublicSubscribe public_subscribe = 5;
+     */
+    value: EventsToServer_PublicSubscribe;
+    case: "publicSubscribe";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToServer.
+ * Use `create(EventsToServerSchema)` to create a new message.
+ */
+export const EventsToServerSchema: GenMessage<EventsToServer> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 2);
+
+/**
+ * Subscribe to resource change events
+ *
+ * @generated from message uplim.api.v1.EventsToServer.Subscribe
+ */
+export type EventsToServer_Subscribe = Message<"uplim.api.v1.EventsToServer.Subscribe"> & {
+  /**
+   * @generated from oneof uplim.api.v1.EventsToServer.Subscribe.scope
+   */
+  scope: {
+    /**
+     * Subscribe to all accessible buckets
+     *
+     * @generated from field: bool everything = 1;
+     */
+    value: boolean;
+    case: "everything";
+  } | {
+    /**
+     * Subscribe to specific bucket
+     *
+     * @generated from field: string bucket_id = 2;
+     */
+    value: string;
+    case: "bucketId";
+  } | { case: undefined; value?: undefined };
+
+  /**
+   * Optional: subscribe to specific upload (overrides other filters)
+   *
+   * @generated from field: optional string upload_id = 3;
+   */
+  uploadId?: string;
+
+  /**
+   * Optional: filter events (applied after scope)
+   *
+   * @generated from field: optional uplim.api.v1.SubscriptionFilter filter = 4;
+   */
+  filter?: SubscriptionFilter;
+
+  /**
+   * If set and > 0, server replays events where event_id > last_event_id,
+   * then transitions to live tail after ReplayComplete.
+   * If 0 or unset, client receives live events only (no replay).
+   * Only valid with bucket_id scope (not everything).
+   *
+   * @generated from field: optional uint64 last_event_id = 5 [jstype = JS_STRING];
+   */
+  lastEventId?: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToServer.Subscribe.
+ * Use `create(EventsToServer_SubscribeSchema)` to create a new message.
+ */
+export const EventsToServer_SubscribeSchema: GenMessage<EventsToServer_Subscribe> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 2, 0);
+
+/**
+ * Unsubscribe from a previous subscription
+ *
+ * @generated from message uplim.api.v1.EventsToServer.Unsubscribe
+ */
+export type EventsToServer_Unsubscribe = Message<"uplim.api.v1.EventsToServer.Unsubscribe"> & {
+  /**
+   * The subscription ID to remove (from SubscribeAck)
+   *
+   * @generated from field: string subscription_id = 1;
+   */
+  subscriptionId: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToServer.Unsubscribe.
+ * Use `create(EventsToServer_UnsubscribeSchema)` to create a new message.
+ */
+export const EventsToServer_UnsubscribeSchema: GenMessage<EventsToServer_Unsubscribe> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 2, 1);
+
+/**
+ * Client acknowledgement of a replay batch
+ *
+ * @generated from message uplim.api.v1.EventsToServer.ReplayBatchAck
+ */
+export type EventsToServer_ReplayBatchAck = Message<"uplim.api.v1.EventsToServer.ReplayBatchAck"> & {
+  /**
+   * @generated from field: string subscription_id = 1;
+   */
+  subscriptionId: string;
+
+  /**
+   * @generated from field: uint32 batch_seq = 2;
+   */
+  batchSeq: number;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToServer.ReplayBatchAck.
+ * Use `create(EventsToServer_ReplayBatchAckSchema)` to create a new message.
+ */
+export const EventsToServer_ReplayBatchAckSchema: GenMessage<EventsToServer_ReplayBatchAck> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 2, 2);
+
+/**
+ * Keepalive ping (server responds with Pong)
+ *
+ * @generated from message uplim.api.v1.EventsToServer.Ping
+ */
+export type EventsToServer_Ping = Message<"uplim.api.v1.EventsToServer.Ping"> & {
+  /**
+   * Unique ping ID (echoed in Pong)
+   *
+   * @generated from field: string id = 1;
+   */
+  id: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToServer.Ping.
+ * Use `create(EventsToServer_PingSchema)` to create a new message.
+ */
+export const EventsToServer_PingSchema: GenMessage<EventsToServer_Ping> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 2, 3);
+
+/**
+ * Subscribe to events for a public (unauthenticated) resource.
+ * Token is minted by the PublicUploadsService and scopes the subscription
+ * to a single upload or folder. Replaces the normal Subscribe path on
+ * public connections; no other subscriptions may exist on the same
+ * connection.
+ *
+ * @generated from message uplim.api.v1.EventsToServer.PublicSubscribe
+ */
+export type EventsToServer_PublicSubscribe = Message<"uplim.api.v1.EventsToServer.PublicSubscribe"> & {
+  /**
+   * @generated from field: string ws_subscription_token = 1;
+   */
+  wsSubscriptionToken: string;
+};
+
+/**
+ * Describes the message uplim.api.v1.EventsToServer.PublicSubscribe.
+ * Use `create(EventsToServer_PublicSubscribeSchema)` to create a new message.
+ */
+export const EventsToServer_PublicSubscribeSchema: GenMessage<EventsToServer_PublicSubscribe> = /*@__PURE__*/
+  messageDesc(file_uplim_api_v1_events, 2, 4);
+
+/**
+ * The type of change that occurred on a resource
+ *
+ * @generated from enum uplim.api.v1.ChangeType
+ */
+export enum ChangeType {
+  /**
+   * @generated from enum value: CHANGE_TYPE_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * A new resource was created
+   *
+   * @generated from enum value: CHANGE_TYPE_CREATE = 1;
+   */
+  CREATE = 1,
+
+  /**
+   * An existing resource was updated
+   *
+   * @generated from enum value: CHANGE_TYPE_UPDATE = 2;
+   */
+  UPDATE = 2,
+
+  /**
+   * A resource was deleted
+   *
+   * @generated from enum value: CHANGE_TYPE_DELETE = 3;
+   */
+  DELETE = 3,
+}
+
+/**
+ * Describes the enum uplim.api.v1.ChangeType.
+ */
+export const ChangeTypeSchema: GenEnum<ChangeType> = /*@__PURE__*/
+  enumDesc(file_uplim_api_v1_events, 0);
+
+/**
+ * The type of resource that was changed
+ *
+ * @generated from enum uplim.api.v1.ChangeTarget
+ */
+export enum ChangeTarget {
+  /**
+   * @generated from enum value: CHANGE_TARGET_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * A bucket was changed
+   *
+   * @generated from enum value: CHANGE_TARGET_BUCKET = 1;
+   */
+  BUCKET = 1,
+
+  /**
+   * A folder was changed
+   *
+   * @generated from enum value: CHANGE_TARGET_FOLDER = 2;
+   */
+  FOLDER = 2,
+
+  /**
+   * An upload was changed
+   *
+   * @generated from enum value: CHANGE_TARGET_UPLOAD = 3;
+   */
+  UPLOAD = 3,
+
+  /**
+   * An account was changed
+   *
+   * @generated from enum value: CHANGE_TARGET_ACCOUNT = 4;
+   */
+  ACCOUNT = 4,
+}
+
+/**
+ * Describes the enum uplim.api.v1.ChangeTarget.
+ */
+export const ChangeTargetSchema: GenEnum<ChangeTarget> = /*@__PURE__*/
+  enumDesc(file_uplim_api_v1_events, 1);
+
+/**
+ * Hints about what changed in an UPDATE event
+ *
+ * @generated from enum uplim.api.v1.UpdateHint
+ */
+export enum UpdateHint {
+  /**
+   * @generated from enum value: UPDATE_HINT_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_TAGS = 1;
+   */
+  TAGS = 1,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_PATH = 3;
+   */
+  PATH = 3,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_SLUG = 4;
+   */
+  SLUG = 4,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_PRIVATE = 5;
+   */
+  PRIVATE = 5,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_TYPE = 6;
+   */
+  TYPE = 6,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_VIRUS_SCAN = 7;
+   */
+  VIRUS_SCAN = 7,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_AI_METADATA = 8;
+   */
+  AI_METADATA = 8,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_META_UPLOADS = 9;
+   */
+  META_UPLOADS = 9,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_METADATA = 10;
+   */
+  METADATA = 10,
+
+  /**
+   * @generated from enum value: UPDATE_HINT_ORDER = 11;
+   */
+  ORDER = 11,
+
+  /**
+   * Public subscription only: the viewer's access to this resource has been
+   * revoked (e.g. upload set private, alias revoked, folder went private).
+   * The server closes the subscription after sending this hint.
+   *
+   * @generated from enum value: UPDATE_HINT_ACCESS_REVOKED = 12;
+   */
+  ACCESS_REVOKED = 12,
+}
+
+/**
+ * Describes the enum uplim.api.v1.UpdateHint.
+ */
+export const UpdateHintSchema: GenEnum<UpdateHint> = /*@__PURE__*/
+  enumDesc(file_uplim_api_v1_events, 2);
+