@servora/proto-utils 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (147) hide show
  1. package/dist/client/request.d.ts +1 -1
  2. package/dist/client/request.d.ts.map +1 -1
  3. package/dist/client/request.js +1 -0
  4. package/dist/client/request.js.map +1 -1
  5. package/dist/crud/index.d.ts +66 -0
  6. package/dist/crud/index.d.ts.map +1 -0
  7. package/dist/crud/index.js +190 -0
  8. package/dist/crud/index.js.map +1 -0
  9. package/dist/gen/servora/audit/v1/index.d.ts +20 -2
  10. package/dist/gen/servora/audit/v1/index.d.ts.map +1 -1
  11. package/dist/gen/servora/audit/v1/index.js +10 -2
  12. package/dist/gen/servora/audit/v1/index.js.map +1 -1
  13. package/dist/gen/servora/authn/audit/v1/index.d.ts +27 -9
  14. package/dist/gen/servora/authn/audit/v1/index.d.ts.map +1 -1
  15. package/dist/gen/servora/authn/audit/v1/index.js +10 -2
  16. package/dist/gen/servora/authn/audit/v1/index.js.map +1 -1
  17. package/dist/gen/servora/authn/v1/index.d.ts +21 -3
  18. package/dist/gen/servora/authn/v1/index.d.ts.map +1 -1
  19. package/dist/gen/servora/authn/v1/index.js +10 -2
  20. package/dist/gen/servora/authn/v1/index.js.map +1 -1
  21. package/dist/gen/servora/authz/audit/v1/index.d.ts +27 -9
  22. package/dist/gen/servora/authz/audit/v1/index.d.ts.map +1 -1
  23. package/dist/gen/servora/authz/audit/v1/index.js +10 -2
  24. package/dist/gen/servora/authz/audit/v1/index.js.map +1 -1
  25. package/dist/gen/servora/authz/openfga/audit/v1/index.d.ts +26 -8
  26. package/dist/gen/servora/authz/openfga/audit/v1/index.d.ts.map +1 -1
  27. package/dist/gen/servora/authz/openfga/audit/v1/index.js +10 -2
  28. package/dist/gen/servora/authz/openfga/audit/v1/index.js.map +1 -1
  29. package/dist/gen/servora/authz/v1/index.d.ts +23 -5
  30. package/dist/gen/servora/authz/v1/index.d.ts.map +1 -1
  31. package/dist/gen/servora/authz/v1/index.js +10 -2
  32. package/dist/gen/servora/authz/v1/index.js.map +1 -1
  33. package/dist/gen/servora/cloudevents/v1/index.d.ts +28 -11
  34. package/dist/gen/servora/cloudevents/v1/index.d.ts.map +1 -1
  35. package/dist/gen/servora/cloudevents/v1/index.js +10 -2
  36. package/dist/gen/servora/cloudevents/v1/index.js.map +1 -1
  37. package/dist/gen/servora/conf/v1/index.d.ts +22 -4
  38. package/dist/gen/servora/conf/v1/index.d.ts.map +1 -1
  39. package/dist/gen/servora/conf/v1/index.js +10 -2
  40. package/dist/gen/servora/conf/v1/index.js.map +1 -1
  41. package/dist/gen/servora/contrib/db/clickhouse/v1/index.d.ts +32 -15
  42. package/dist/gen/servora/contrib/db/clickhouse/v1/index.d.ts.map +1 -1
  43. package/dist/gen/servora/contrib/db/clickhouse/v1/index.js +10 -2
  44. package/dist/gen/servora/contrib/db/clickhouse/v1/index.js.map +1 -1
  45. package/dist/gen/servora/contrib/db/redis/v1/index.d.ts +25 -8
  46. package/dist/gen/servora/contrib/db/redis/v1/index.d.ts.map +1 -1
  47. package/dist/gen/servora/contrib/db/redis/v1/index.js +10 -2
  48. package/dist/gen/servora/contrib/db/redis/v1/index.js.map +1 -1
  49. package/dist/gen/servora/contrib/kafka/v1/index.d.ts +36 -19
  50. package/dist/gen/servora/contrib/kafka/v1/index.d.ts.map +1 -1
  51. package/dist/gen/servora/contrib/kafka/v1/index.js +10 -2
  52. package/dist/gen/servora/contrib/kafka/v1/index.js.map +1 -1
  53. package/dist/gen/servora/contrib/mail/v1/index.d.ts +28 -11
  54. package/dist/gen/servora/contrib/mail/v1/index.d.ts.map +1 -1
  55. package/dist/gen/servora/contrib/mail/v1/index.js +10 -2
  56. package/dist/gen/servora/contrib/mail/v1/index.js.map +1 -1
  57. package/dist/gen/servora/core/v1/index.d.ts +106 -89
  58. package/dist/gen/servora/core/v1/index.d.ts.map +1 -1
  59. package/dist/gen/servora/core/v1/index.js +10 -2
  60. package/dist/gen/servora/core/v1/index.js.map +1 -1
  61. package/dist/gen/servora/crud/v1/index.d.ts +40 -0
  62. package/dist/gen/servora/crud/v1/index.d.ts.map +1 -0
  63. package/dist/gen/servora/crud/v1/index.js +14 -0
  64. package/dist/gen/servora/crud/v1/index.js.map +1 -0
  65. package/dist/gen/servora/errors/v1/index.d.ts +19 -0
  66. package/dist/gen/servora/errors/v1/index.d.ts.map +1 -0
  67. package/dist/gen/servora/errors/v1/index.js +14 -0
  68. package/dist/gen/servora/errors/v1/index.js.map +1 -0
  69. package/dist/gen/servora/example/v1/example.crud.d.ts +29 -0
  70. package/dist/gen/servora/example/v1/example.crud.d.ts.map +1 -0
  71. package/dist/gen/servora/example/v1/example.crud.js +54 -0
  72. package/dist/gen/servora/example/v1/example.crud.js.map +1 -0
  73. package/dist/gen/servora/example/v1/index.d.ts +86 -0
  74. package/dist/gen/servora/example/v1/index.d.ts.map +1 -0
  75. package/dist/gen/servora/example/v1/index.js +158 -0
  76. package/dist/gen/servora/example/v1/index.js.map +1 -0
  77. package/dist/gen/servora/obs/audit/v1/index.d.ts +22 -4
  78. package/dist/gen/servora/obs/audit/v1/index.d.ts.map +1 -1
  79. package/dist/gen/servora/obs/audit/v1/index.js +10 -2
  80. package/dist/gen/servora/obs/audit/v1/index.js.map +1 -1
  81. package/dist/gen/servora/security/authn/oidc/v1/index.d.ts +22 -4
  82. package/dist/gen/servora/security/authn/oidc/v1/index.d.ts.map +1 -1
  83. package/dist/gen/servora/security/authn/oidc/v1/index.js +10 -2
  84. package/dist/gen/servora/security/authn/oidc/v1/index.js.map +1 -1
  85. package/dist/gen/servora/security/authz/openfga/v1/index.d.ts +22 -4
  86. package/dist/gen/servora/security/authz/openfga/v1/index.d.ts.map +1 -1
  87. package/dist/gen/servora/security/authz/openfga/v1/index.js +10 -2
  88. package/dist/gen/servora/security/authz/openfga/v1/index.js.map +1 -1
  89. package/dist/gen/servora/security/jwt/v1/index.d.ts +24 -6
  90. package/dist/gen/servora/security/jwt/v1/index.d.ts.map +1 -1
  91. package/dist/gen/servora/security/jwt/v1/index.js +10 -2
  92. package/dist/gen/servora/security/jwt/v1/index.js.map +1 -1
  93. package/dist/gen/servora/security/tls/v1/index.d.ts +22 -4
  94. package/dist/gen/servora/security/tls/v1/index.d.ts.map +1 -1
  95. package/dist/gen/servora/security/tls/v1/index.js +10 -2
  96. package/dist/gen/servora/security/tls/v1/index.js.map +1 -1
  97. package/dist/gen/servora/transport/http/cors/v1/index.d.ts +24 -7
  98. package/dist/gen/servora/transport/http/cors/v1/index.d.ts.map +1 -1
  99. package/dist/gen/servora/transport/http/cors/v1/index.js +10 -2
  100. package/dist/gen/servora/transport/http/cors/v1/index.js.map +1 -1
  101. package/dist/index.d.ts +0 -1
  102. package/dist/index.d.ts.map +1 -1
  103. package/dist/index.js +0 -1
  104. package/dist/index.js.map +1 -1
  105. package/package.json +5 -4
  106. package/src/client/request.ts +8 -7
  107. package/src/crud/AGENTS.md +24 -0
  108. package/src/crud/index.ts +307 -0
  109. package/src/gen/servora/audit/v1/index.ts +44 -8
  110. package/src/gen/servora/authn/audit/v1/index.ts +53 -17
  111. package/src/gen/servora/authn/v1/index.ts +44 -8
  112. package/src/gen/servora/authz/audit/v1/index.ts +53 -17
  113. package/src/gen/servora/authz/openfga/audit/v1/index.ts +48 -12
  114. package/src/gen/servora/authz/v1/index.ts +49 -13
  115. package/src/gen/servora/cloudevents/v1/index.ts +49 -13
  116. package/src/gen/servora/conf/v1/index.ts +42 -6
  117. package/src/gen/servora/contrib/db/clickhouse/v1/index.ts +53 -17
  118. package/src/gen/servora/contrib/db/redis/v1/index.ts +46 -10
  119. package/src/gen/servora/contrib/kafka/v1/index.ts +57 -21
  120. package/src/gen/servora/contrib/mail/v1/index.ts +49 -13
  121. package/src/gen/servora/core/v1/index.ts +134 -98
  122. package/src/gen/servora/crud/v1/index.ts +104 -0
  123. package/src/gen/servora/errors/v1/index.ts +42 -0
  124. package/src/gen/servora/example/v1/example.crud.ts +63 -0
  125. package/src/gen/servora/example/v1/index.ts +441 -0
  126. package/src/gen/servora/obs/audit/v1/index.ts +42 -6
  127. package/src/gen/servora/security/authn/oidc/v1/index.ts +42 -6
  128. package/src/gen/servora/security/authz/openfga/v1/index.ts +42 -6
  129. package/src/gen/servora/security/jwt/v1/index.ts +44 -8
  130. package/src/gen/servora/security/tls/v1/index.ts +42 -6
  131. package/src/gen/servora/transport/http/cors/v1/index.ts +45 -9
  132. package/src/index.ts +0 -1
  133. package/dist/gen/servora/mapper/v1/index.d.ts +0 -7
  134. package/dist/gen/servora/mapper/v1/index.d.ts.map +0 -1
  135. package/dist/gen/servora/mapper/v1/index.js +0 -6
  136. package/dist/gen/servora/mapper/v1/index.js.map +0 -1
  137. package/dist/gen/servora/pagination/v1/index.d.ts +0 -26
  138. package/dist/gen/servora/pagination/v1/index.d.ts.map +0 -1
  139. package/dist/gen/servora/pagination/v1/index.js +0 -6
  140. package/dist/gen/servora/pagination/v1/index.js.map +0 -1
  141. package/dist/query.d.ts +0 -57
  142. package/dist/query.d.ts.map +0 -1
  143. package/dist/query.js +0 -77
  144. package/dist/query.js.map +0 -1
  145. package/src/gen/servora/mapper/v1/index.ts +0 -18
  146. package/src/gen/servora/pagination/v1/index.ts +0 -37
  147. package/src/query.ts +0 -83
@@ -1,20 +1,56 @@
1
1
  // Code generated by protoc-gen-typescript-http. DO NOT EDIT.
2
- /* eslint-disable camelcase */
3
- // @ts-nocheck
2
+ /* eslint-disable no-use-before-define, @typescript-eslint/no-unused-vars, prettier/prettier */
3
+
4
+ interface TransportMeta {
5
+ service: string;
6
+ method: string;
7
+ }
8
+
9
+ export interface ClientTransport {
10
+ unary<T>(
11
+ path: string,
12
+ method: string,
13
+ body: null | string,
14
+ meta: TransportMeta,
15
+ ): Promise<T>;
16
+ serverStream<T>(path: string, meta: TransportMeta): ServerStream<T>;
17
+ duplexStream<TIn, TOut>(path: string, meta: TransportMeta): DuplexStream<TIn, TOut>;
18
+ }
19
+
20
+ export interface ServerStream<T> {
21
+ onEvent(listener: (data: T) => void): () => void;
22
+ onError(handler: (error: Error) => void): void;
23
+ close(): void;
24
+ }
25
+
26
+ export interface DuplexStream<TIn, TOut> extends ServerStream<TOut> {
27
+ send(data: TIn): void;
28
+ }
29
+
30
+ function encodePathSegment(value: unknown): string {
31
+ return encodeURIComponent(String(value)).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
32
+ }
33
+
34
+ function encodeMultiSegmentPath(value: unknown): string {
35
+ return String(value)
36
+ .split('/')
37
+ .map(encodePathSegment)
38
+ .join('/');
39
+ }
4
40
 
5
41
  export type Mail = {
6
- smtp: SMTP | undefined;
7
- from: MailFrom | undefined;
42
+ from?: MailFrom;
43
+ smtp?: SMTP;
8
44
  };
9
45
 
10
46
  export type SMTP = {
11
- host: string | undefined;
12
- port: number | undefined;
13
- username: string | undefined;
14
- password: string | undefined;
15
- tls: boolean | undefined;
16
- skipVerifySsl: boolean | undefined;
17
- sendTimeout: wellKnownDuration | undefined;
47
+ host?: string;
48
+ password?: string;
49
+ port?: number;
50
+ sendTimeout?: wellKnownDuration;
51
+ skipVerifySsl?: boolean;
52
+ tls?: boolean;
53
+ username?: string;
18
54
  };
19
55
 
20
56
  // Generated output always contains 0, 3, 6, or 9 fractional digits,
@@ -24,8 +60,8 @@ export type SMTP = {
24
60
  type wellKnownDuration = string;
25
61
 
26
62
  export type MailFrom = {
27
- address: string | undefined;
28
- name: string | undefined;
63
+ address?: string;
64
+ name?: string;
29
65
  };
30
66
 
31
67
 
@@ -1,42 +1,78 @@
1
1
  // Code generated by protoc-gen-typescript-http. DO NOT EDIT.
2
- /* eslint-disable camelcase */
3
- // @ts-nocheck
2
+ /* eslint-disable no-use-before-define, @typescript-eslint/no-unused-vars, prettier/prettier */
3
+
4
+ interface TransportMeta {
5
+ service: string;
6
+ method: string;
7
+ }
8
+
9
+ export interface ClientTransport {
10
+ unary<T>(
11
+ path: string,
12
+ method: string,
13
+ body: null | string,
14
+ meta: TransportMeta,
15
+ ): Promise<T>;
16
+ serverStream<T>(path: string, meta: TransportMeta): ServerStream<T>;
17
+ duplexStream<TIn, TOut>(path: string, meta: TransportMeta): DuplexStream<TIn, TOut>;
18
+ }
19
+
20
+ export interface ServerStream<T> {
21
+ onEvent(listener: (data: T) => void): () => void;
22
+ onError(handler: (error: Error) => void): void;
23
+ close(): void;
24
+ }
25
+
26
+ export interface DuplexStream<TIn, TOut> extends ServerStream<TOut> {
27
+ send(data: TIn): void;
28
+ }
29
+
30
+ function encodePathSegment(value: unknown): string {
31
+ return encodeURIComponent(String(value)).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
32
+ }
33
+
34
+ function encodeMultiSegmentPath(value: unknown): string {
35
+ return String(value)
36
+ .split('/')
37
+ .map(encodePathSegment)
38
+ .join('/');
39
+ }
4
40
 
5
41
  export type Bootstrap = {
6
- app: App | undefined;
7
- server: Server | undefined;
8
- data: Data | undefined;
9
- registry: Registry | undefined;
10
- source: Source | undefined;
11
- obs: Observability | undefined;
42
+ app?: App;
43
+ data?: Data;
44
+ obs?: Observability;
45
+ registry?: Registry;
46
+ server?: Server;
47
+ source?: Source;
12
48
  };
13
49
 
14
50
  export type App = {
15
- env: string | undefined;
16
- name: string | undefined;
17
- version: string | undefined;
51
+ env?: string;
52
+ externalUrl?: string;
18
53
  // field 5 reserved (was App.Log, moved to Bootstrap.obs.log)
19
- metadata: { [key: string]: string } | undefined;
20
- externalUrl: string | undefined;
54
+ metadata?: { [key: string]: string };
55
+ name?: string;
56
+ version?: string;
21
57
  };
22
58
 
23
59
  // 通信服务端配置
24
60
  export type Server = {
25
- http: Server_HTTP | undefined;
26
- grpc: Server_GRPC | undefined;
61
+ grpc?: Server_GRPC;
62
+ http?: Server_HTTP;
27
63
  };
28
64
 
29
65
  export type Server_HTTP = {
30
- listen: Server_Listen | undefined;
31
- tls: servorasecuritytlsv1_TLS | undefined;
32
- advertise: Server_Advertise | undefined;
66
+ advertise?: Server_Advertise;
67
+ listen?: Server_Listen;
68
+ tls?: servorasecuritytlsv1_TLS;
33
69
  };
34
70
 
35
71
  // 监听配置(面向 net.Listen 参数)
36
72
  export type Server_Listen = {
37
- network: string | undefined;
38
- addr: string | undefined;
39
- timeout: wellKnownDuration | undefined;
73
+ addr?: string;
74
+ network?: string;
75
+ timeout?: wellKnownDuration;
40
76
  };
41
77
 
42
78
  // Generated output always contains 0, 3, 6, or 9 fractional digits,
@@ -46,50 +82,50 @@ export type Server_Listen = {
46
82
  type wellKnownDuration = string;
47
83
 
48
84
  export type servorasecuritytlsv1_TLS = {
49
- enable: boolean | undefined;
50
- certPath: string | undefined;
51
- keyPath: string | undefined;
52
- caPath: string | undefined;
85
+ caPath?: string;
86
+ certPath?: string;
87
+ enable?: boolean;
88
+ keyPath?: string;
53
89
  };
54
90
 
55
91
  // 服务注册端点覆盖(用于注册中心对外公布地址)
56
92
  export type Server_Advertise = {
57
- endpoint: string | undefined;
58
- host: string | undefined;
93
+ endpoint?: string;
94
+ host?: string;
59
95
  };
60
96
 
61
97
  export type Server_GRPC = {
62
- listen: Server_Listen | undefined;
63
- tls: servorasecuritytlsv1_TLS | undefined;
64
- advertise: Server_Advertise | undefined;
98
+ advertise?: Server_Advertise;
99
+ listen?: Server_Listen;
100
+ tls?: servorasecuritytlsv1_TLS;
65
101
  };
66
102
 
67
103
  // 数据源配置(仅保留 database / client 等核心数据源)
68
104
  export type Data = {
69
- database: Data_Database | undefined;
70
- client: Data_Client | undefined;
105
+ client?: Data_Client;
106
+ database?: Data_Database;
71
107
  };
72
108
 
73
109
  export type Data_Database = {
74
- driver: string | undefined;
75
- source: string | undefined;
110
+ driver?: string;
111
+ source?: string;
76
112
  };
77
113
 
78
114
  export type Data_Client = {
79
- services: Data_Client_Service[] | undefined;
115
+ services?: Data_Client_Service[];
80
116
  };
81
117
 
82
118
  export type Data_Client_Service = {
83
- name: string | undefined;
84
- endpoints: Data_Client_Endpoint[] | undefined;
119
+ endpoints?: Data_Client_Endpoint[];
120
+ name?: string;
85
121
  };
86
122
 
87
123
  export type Data_Client_Endpoint = {
88
- protocol: string | undefined;
89
- endpoint: string | undefined;
90
- timeout: wellKnownDuration | undefined;
91
- tls: servorasecuritytlsv1_TLS | undefined;
92
- options: wellKnownStruct | undefined;
124
+ endpoint?: string;
125
+ options?: wellKnownStruct;
126
+ protocol?: string;
127
+ timeout?: wellKnownDuration;
128
+ tls?: servorasecuritytlsv1_TLS;
93
129
  };
94
130
 
95
131
  // Any JSON value.
@@ -99,46 +135,46 @@ type wellKnownStruct = Record<string, unknown>;
99
135
  export type Registry = {
100
136
  consul?: Consul;
101
137
  etcd?: Etcd;
102
- nacos?: Nacos;
103
138
  kubernetes?: Kubernetes;
139
+ nacos?: Nacos;
104
140
  };
105
141
 
106
142
  // 通用 Consul 配置
107
143
  export type Consul = {
108
- addr: string | undefined;
109
- scheme: string | undefined;
110
- token: string | undefined;
111
- datacenter: string | undefined;
112
- timeout: wellKnownDuration | undefined;
113
- tags: string[] | undefined;
114
- key: string | undefined;
144
+ addr?: string;
145
+ datacenter?: string;
146
+ key?: string;
147
+ scheme?: string;
148
+ tags?: string[];
149
+ timeout?: wellKnownDuration;
150
+ token?: string;
115
151
  };
116
152
 
117
153
  // 通用 Etcd 配置
118
154
  export type Etcd = {
119
- endpoints: string[] | undefined;
120
- username: string | undefined;
121
- password: string | undefined;
122
- timeout: wellKnownDuration | undefined;
123
- key: string | undefined;
124
- namespace: string | undefined;
155
+ endpoints?: string[];
156
+ key?: string;
157
+ namespace?: string;
158
+ password?: string;
159
+ timeout?: wellKnownDuration;
160
+ username?: string;
125
161
  };
126
162
 
127
163
  // 通用 Nacos 配置
128
164
  export type Nacos = {
129
- addr: string | undefined;
130
- port: number | undefined;
131
- namespace: string | undefined;
132
- group: string | undefined;
133
- username: string | undefined;
134
- password: string | undefined;
135
- timeout: wellKnownDuration | undefined;
136
- dataId: string | undefined;
165
+ addr?: string;
166
+ dataId?: string;
167
+ group?: string;
168
+ namespace?: string;
169
+ password?: string;
170
+ port?: string;
171
+ timeout?: wellKnownDuration;
172
+ username?: string;
137
173
  };
138
174
 
139
175
  // 通用 Kubernetes 配置
140
176
  export type Kubernetes = {
141
- enable: boolean | undefined;
177
+ enable?: boolean;
142
178
  };
143
179
 
144
180
  // 配置中心配置
@@ -150,71 +186,71 @@ export type Source = {
150
186
 
151
187
  // 可观测性配置
152
188
  export type Observability = {
153
- log: Log | undefined;
154
- trace: Trace | undefined;
155
- metrics: Metrics | undefined;
189
+ log?: Log;
190
+ metrics?: Metrics;
191
+ trace?: Trace;
156
192
  };
157
193
 
158
194
  // 日志配置(与 App 同级,所有 message/enum nested)
159
195
  export type Log = {
160
- level: Log_LogLevel | undefined;
161
- backends: Log_LogBackend[] | undefined;
196
+ backends?: Log_LogBackend[];
197
+ level?: Log_LogLevel;
162
198
  };
163
199
 
164
200
  export type Log_LogLevel =
165
- | "LOG_LEVEL_UNSPECIFIED"
166
- | "LOG_LEVEL_DEBUG"
167
- | "LOG_LEVEL_INFO"
168
- | "LOG_LEVEL_WARN"
169
- | "LOG_LEVEL_ERROR";
201
+ | 'LOG_LEVEL_DEBUG'
202
+ | 'LOG_LEVEL_ERROR'
203
+ | 'LOG_LEVEL_INFO'
204
+ | 'LOG_LEVEL_UNSPECIFIED'
205
+ | 'LOG_LEVEL_WARN';
170
206
  export type Log_LogBackend = {
171
- stdout?: Log_StdoutBackend;
172
207
  file?: Log_FileBackend;
173
- otel?: Log_OtelBackend;
174
208
  noop?: Log_NoopBackend;
209
+ otel?: Log_OtelBackend;
210
+ stdout?: Log_StdoutBackend;
175
211
  };
176
212
 
177
213
  export type Log_StdoutBackend = {
178
- format: Log_LogFormat | undefined;
214
+ format?: Log_LogFormat;
179
215
  };
180
216
 
181
217
  export type Log_LogFormat =
182
- | "LOG_FORMAT_UNSPECIFIED"
183
- | "LOG_FORMAT_JSON"
184
- | "LOG_FORMAT_TEXT";
218
+ | 'LOG_FORMAT_JSON'
219
+ | 'LOG_FORMAT_TEXT'
220
+ | 'LOG_FORMAT_UNSPECIFIED';
185
221
  export type Log_FileBackend = {
186
- path: string | undefined;
187
- maxSize: number | undefined;
188
- maxBackups: number | undefined;
189
- maxAge: number | undefined;
190
- compress: boolean | undefined;
191
- format: Log_LogFormat | undefined;
222
+ compress?: boolean;
223
+ format?: Log_LogFormat;
224
+ maxAge?: number;
225
+ maxBackups?: number;
226
+ maxSize?: number;
227
+ path?: string;
192
228
  };
193
229
 
194
230
  export type Log_OtelBackend = {
195
- endpoint: string | undefined;
196
- protocol: Log_OtelProtocol | undefined;
197
- insecure: boolean | undefined;
231
+ endpoint?: string;
232
+ insecure?: boolean;
233
+ protocol?: Log_OtelProtocol;
198
234
  };
199
235
 
200
236
  export type Log_OtelProtocol =
201
- | "OTEL_PROTOCOL_UNSPECIFIED"
202
- | "OTEL_PROTOCOL_GRPC"
203
- | "OTEL_PROTOCOL_HTTP_PROTOBUF";
237
+ | 'OTEL_PROTOCOL_GRPC'
238
+ | 'OTEL_PROTOCOL_HTTP_PROTOBUF'
239
+ | 'OTEL_PROTOCOL_UNSPECIFIED';
204
240
  export type Log_NoopBackend = {
205
241
  };
206
242
 
207
243
  // 链路追踪配置
208
244
  export type Trace = {
209
- endpoint: string | undefined;
210
- insecure: boolean | undefined;
211
- samplingRatio: number | undefined;
212
- caPath: string | undefined;
245
+ caPath?: string;
246
+ endpoint?: string;
247
+ insecure?: boolean;
248
+ samplingRatio?: number;
213
249
  };
214
250
 
215
251
  // Metrics 配置
216
252
  export type Metrics = {
217
- enable: boolean | undefined;
253
+ enable?: boolean;
218
254
  };
219
255
 
220
256
 
@@ -0,0 +1,104 @@
1
+ // Code generated by protoc-gen-typescript-http. DO NOT EDIT.
2
+ /* eslint-disable no-use-before-define, @typescript-eslint/no-unused-vars, prettier/prettier */
3
+
4
+ interface TransportMeta {
5
+ service: string;
6
+ method: string;
7
+ }
8
+
9
+ export interface ClientTransport {
10
+ unary<T>(
11
+ path: string,
12
+ method: string,
13
+ body: null | string,
14
+ meta: TransportMeta,
15
+ ): Promise<T>;
16
+ serverStream<T>(path: string, meta: TransportMeta): ServerStream<T>;
17
+ duplexStream<TIn, TOut>(path: string, meta: TransportMeta): DuplexStream<TIn, TOut>;
18
+ }
19
+
20
+ export interface ServerStream<T> {
21
+ onEvent(listener: (data: T) => void): () => void;
22
+ onError(handler: (error: Error) => void): void;
23
+ close(): void;
24
+ }
25
+
26
+ export interface DuplexStream<TIn, TOut> extends ServerStream<TOut> {
27
+ send(data: TIn): void;
28
+ }
29
+
30
+ function encodePathSegment(value: unknown): string {
31
+ return encodeURIComponent(String(value)).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
32
+ }
33
+
34
+ function encodeMultiSegmentPath(value: unknown): string {
35
+ return String(value)
36
+ .split('/')
37
+ .map(encodePathSegment)
38
+ .join('/');
39
+ }
40
+
41
+ // CrudErrorReason contains only errors produced by the CRUD framework itself.
42
+ // Storage facts and business semantics must use application-owned errors.
43
+ export type CrudErrorReason =
44
+ // An internal CRUD framework invariant was violated.
45
+ | 'CRUD_ERROR_REASON_INTERNAL'
46
+ // The update mask contains an unknown, overlapping, or unsupported path.
47
+ | 'CRUD_ERROR_REASON_INVALID_FIELD_MASK'
48
+ // A field value violates the CRUD request contract.
49
+ | 'CRUD_ERROR_REASON_INVALID_FIELD_VALUE'
50
+ // The filter is invalid, unsupported, or exceeds configured limits.
51
+ | 'CRUD_ERROR_REASON_INVALID_FILTER'
52
+ // The order_by value is invalid, unsupported, or exceeds configured limits.
53
+ | 'CRUD_ERROR_REASON_INVALID_ORDER_BY'
54
+ // The page token cannot be decoded or does not match the current query.
55
+ | 'CRUD_ERROR_REASON_INVALID_PAGE_TOKEN'
56
+ // The resource name or parent does not match the declared resource pattern.
57
+ | 'CRUD_ERROR_REASON_INVALID_RESOURCE_NAME'
58
+ | 'CRUD_ERROR_REASON_UNSPECIFIED';
59
+ // PageTokenPayload is the server-side payload of an opaque page token.
60
+ // Business request and response messages must not import or embed this type.
61
+ export type PageTokenPayload = {
62
+ // A 32-byte SHA-256 digest of the canonical query context.
63
+ contextFingerprint?: string;
64
+ // Cursor values aligned positionally with the resolved final order.
65
+ cursor?: CursorValue[];
66
+ // Payload version. Decoders must reject unsupported versions.
67
+ version?: number;
68
+ };
69
+
70
+ // CursorValue stores one canonical value from the resolved final order.
71
+ // An unset value is invalid; null_value represents a database NULL.
72
+ export type CursorValue = {
73
+ boolValue?: boolean;
74
+ bytesValue?: string;
75
+ // Used for float and double values after finite-value validation.
76
+ doubleValue?: number;
77
+ durationValue?: wellKnownDuration;
78
+ // Used for signed integers and protobuf enum numbers.
79
+ int64Value?: string;
80
+ nullValue?: wellKnownNullValue;
81
+ stringValue?: string;
82
+ // Original storage timezone offset in seconds for dialects that persist time.Time as text.
83
+ // The instant remains in timestamp_value; this preserves backend comparison semantics across opaque-token round trips.
84
+ timestampOffsetSeconds?: number;
85
+ timestampValue?: wellKnownTimestamp;
86
+ // Used for unsigned integers.
87
+ uint64Value?: string;
88
+ };
89
+
90
+ // Encoded using RFC 3339, where generated output will always be Z-normalized
91
+ // and uses 0, 3, 6 or 9 fractional digits.
92
+ // Offsets other than "Z" are also accepted.
93
+ type wellKnownTimestamp = string;
94
+
95
+ // Generated output always contains 0, 3, 6, or 9 fractional digits,
96
+ // depending on required precision, followed by the suffix "s".
97
+ // Accepted are any fractional digits (also none) as long as they fit
98
+ // into nano-seconds precision and the suffix "s" is required.
99
+ type wellKnownDuration = string;
100
+
101
+ type wellKnownNullValue = null;
102
+
103
+
104
+ // @@protoc_insertion_point(typescript-http-eof)
@@ -0,0 +1,42 @@
1
+ // Code generated by protoc-gen-typescript-http. DO NOT EDIT.
2
+ /* eslint-disable no-use-before-define, @typescript-eslint/no-unused-vars, prettier/prettier */
3
+
4
+ interface TransportMeta {
5
+ service: string;
6
+ method: string;
7
+ }
8
+
9
+ export interface ClientTransport {
10
+ unary<T>(
11
+ path: string,
12
+ method: string,
13
+ body: null | string,
14
+ meta: TransportMeta,
15
+ ): Promise<T>;
16
+ serverStream<T>(path: string, meta: TransportMeta): ServerStream<T>;
17
+ duplexStream<TIn, TOut>(path: string, meta: TransportMeta): DuplexStream<TIn, TOut>;
18
+ }
19
+
20
+ export interface ServerStream<T> {
21
+ onEvent(listener: (data: T) => void): () => void;
22
+ onError(handler: (error: Error) => void): void;
23
+ close(): void;
24
+ }
25
+
26
+ export interface DuplexStream<TIn, TOut> extends ServerStream<TOut> {
27
+ send(data: TIn): void;
28
+ }
29
+
30
+ function encodePathSegment(value: unknown): string {
31
+ return encodeURIComponent(String(value)).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
32
+ }
33
+
34
+ function encodeMultiSegmentPath(value: unknown): string {
35
+ return String(value)
36
+ .split('/')
37
+ .map(encodePathSegment)
38
+ .join('/');
39
+ }
40
+
41
+
42
+ // @@protoc_insertion_point(typescript-http-eof)
@@ -0,0 +1,63 @@
1
+ // Code generated by protoc-gen-servora-crud. DO NOT EDIT.
2
+
3
+ import { ResourceNameError } from "@servora/proto-utils/crud";
4
+
5
+ function assertResourceSegment(resource: string, variable: string, value: string): void {
6
+ if (value.length === 0 || value.includes("/")) {
7
+ throw new ResourceNameError(`${resource} variable ${variable} must be non-empty and contain no slash`);
8
+ }
9
+ }
10
+
11
+ export type UserNameParts =
12
+ {
13
+ readonly tenant: string;
14
+ readonly user: string;
15
+ };
16
+
17
+ export const UserName = {
18
+ format(parts: UserNameParts): string {
19
+ assertResourceSegment("User", "tenant", parts.tenant);
20
+ assertResourceSegment("User", "user", parts.user);
21
+ return ["tenants", parts.tenant, "users", parts.user].join("/");
22
+ },
23
+ parse(value: string): UserNameParts {
24
+ const segments = value.split("/");
25
+ if (segments.length === 4 && segments[0] === "tenants" && segments[2] === "users") {
26
+ assertResourceSegment("User", "tenant", segments[1]!);
27
+ assertResourceSegment("User", "user", segments[3]!);
28
+ return {
29
+ tenant: segments[1]!,
30
+ user: segments[3]!,
31
+ };
32
+ }
33
+ throw new ResourceNameError(`invalid User resource name ${value}`);
34
+ },
35
+ tryParse(value: string): UserNameParts | null {
36
+ try {
37
+ return this.parse(value);
38
+ } catch {
39
+ return null;
40
+ }
41
+ },
42
+ } as const;
43
+
44
+ export const UserFields = {
45
+ name: "name",
46
+ displayName: "display_name",
47
+ email: "email",
48
+ tenantPlan: "tenant_plan",
49
+ nickname: "nickname",
50
+ temporaryPassword: "temporary_password",
51
+ etag: "etag",
52
+ createTime: "create_time",
53
+ updateTime: "update_time",
54
+ deleteTime: "delete_time",
55
+ purgeTime: "purge_time",
56
+ } as const;
57
+
58
+ export const UserUpdateFields = {
59
+ displayName: "display_name",
60
+ email: "email",
61
+ nickname: "nickname",
62
+ temporaryPassword: "temporary_password",
63
+ } as const;