@nymbalhq/config 1.4.0 → 1.6.0

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.
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { CommerceSlotAdapters } from '@nymbalhq/types';
2
+ import { CommerceSlot, Slot, CommerceSlotAdapters, ResolvedOriginLock, SecurityNetwork, ResolvedNetwork } from '@nymbalhq/types';
3
3
  export { CommerceSlot, Slot } from '@nymbalhq/types';
4
4
 
5
5
  /** The schema's JWT secret when none is configured: fine for development, refused in production. */
@@ -9,724 +9,219 @@ declare const storeSchema: z.ZodObject<{
9
9
  currency: z.ZodString;
10
10
  locale: z.ZodString;
11
11
  timezone: z.ZodString;
12
- /** The storefront's public URL, which the order email links from; with none, the email has no link. */
13
- url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
14
- }, "strip", z.ZodTypeAny, {
15
- name: string;
16
- currency: string;
17
- locale: string;
18
- timezone: string;
19
- url?: string | undefined;
20
- }, {
21
- name: string;
22
- currency: string;
23
- locale: string;
24
- timezone: string;
25
- url?: string | undefined;
26
- }>;
12
+ url: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
13
+ shipFrom: z.ZodOptional<z.ZodObject<{
14
+ firstName: z.ZodString;
15
+ lastName: z.ZodString;
16
+ company: z.ZodOptional<z.ZodString>;
17
+ addressLine1: z.ZodString;
18
+ addressLine2: z.ZodOptional<z.ZodString>;
19
+ city: z.ZodString;
20
+ region: z.ZodString;
21
+ postalCode: z.ZodString;
22
+ country: z.ZodString;
23
+ phone: z.ZodOptional<z.ZodString>;
24
+ }, z.core.$strip>>;
25
+ }, z.core.$strip>;
27
26
  /** The shared Redis connection of the `redis` document store and the `redis-streams` bus. */
28
27
  declare const redisSchema: z.ZodObject<{
29
- /** Defaults to `REDIS_URL`. */
30
28
  url: z.ZodOptional<z.ZodString>;
31
- /** Namespaces every key and stream; defaults to `NYMBAL_REDIS_PREFIX`, then `'nymbal'`. */
32
29
  prefix: z.ZodOptional<z.ZodString>;
33
- /** How long a publish waits for the groups it delivers to (default 15 000). */
34
30
  ackTimeoutMs: z.ZodOptional<z.ZodNumber>;
35
- /** How long an entry may stay pending on a consumer before a live one takes it over (default 5 000). */
36
31
  claimIdleMs: z.ZodOptional<z.ZodNumber>;
37
- /** The approximate length each stream is trimmed to (default 10 000). */
38
32
  streamMaxLen: z.ZodOptional<z.ZodNumber>;
39
- }, "strict", z.ZodTypeAny, {
40
- url?: string | undefined;
41
- prefix?: string | undefined;
42
- ackTimeoutMs?: number | undefined;
43
- claimIdleMs?: number | undefined;
44
- streamMaxLen?: number | undefined;
45
- }, {
46
- url?: string | undefined;
47
- prefix?: string | undefined;
48
- ackTimeoutMs?: number | undefined;
49
- claimIdleMs?: number | undefined;
50
- streamMaxLen?: number | undefined;
51
- }>;
33
+ }, z.core.$strict>;
52
34
  /**
53
- * The bucket `media: 's3'` stores in. Each field falls back to the environment in the platform; credentials are never
54
- * config keys: the AWS SDK's default chain provides them.
35
+ * The bucket `media: { provider: 's3' }` stores in. Each field falls back to the environment in the platform;
36
+ * credentials are never config keys: the AWS SDK's default chain provides them.
55
37
  */
56
38
  declare const s3Schema: z.ZodObject<{
57
- /** Defaults to `S3_BUCKET`; one of the two is required. */
58
39
  bucket: z.ZodOptional<z.ZodString>;
59
- /** Defaults to `AWS_REGION`, then `'us-east-1'`. */
60
40
  region: z.ZodOptional<z.ZodString>;
61
- /** An S3-compatible API (MinIO, R2); defaults to `S3_ENDPOINT`, then AWS. */
62
41
  endpoint: z.ZodOptional<z.ZodString>;
63
- /** Where every object key starts; defaults to `NYMBAL_S3_PREFIX`, then none. */
64
42
  prefix: z.ZodOptional<z.ZodString>;
65
- /** Where the bucket's objects are served from (a CDN); defaults to `S3_PUBLIC_URL`, then the bucket's own URL. */
66
43
  publicUrl: z.ZodOptional<z.ZodString>;
67
- /** Path-style requests; true by default when an endpoint is set. */
68
44
  forcePathStyle: z.ZodOptional<z.ZodBoolean>;
69
- }, "strict", z.ZodTypeAny, {
70
- prefix?: string | undefined;
71
- bucket?: string | undefined;
72
- region?: string | undefined;
73
- endpoint?: string | undefined;
74
- publicUrl?: string | undefined;
75
- forcePathStyle?: boolean | undefined;
76
- }, {
77
- prefix?: string | undefined;
78
- bucket?: string | undefined;
79
- region?: string | undefined;
80
- endpoint?: string | undefined;
81
- publicUrl?: string | undefined;
82
- forcePathStyle?: boolean | undefined;
83
- }>;
84
- declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
85
- commandStore: z.ZodEnum<["sqlite", "postgres"]>;
86
- documentStore: z.ZodEnum<["in-memory", "redis", "postgres-jsonb"]>;
87
- eventBus: z.ZodEnum<["in-process", "redis-streams"]>;
88
- media: z.ZodDefault<z.ZodEnum<["local-fs", "s3"]>>;
45
+ }, z.core.$strict>;
46
+ declare const infrastructureSchema: z.ZodObject<{
47
+ commandStore: z.ZodEnum<{
48
+ sqlite: "sqlite";
49
+ postgres: "postgres";
50
+ }>;
51
+ documentStore: z.ZodObject<{
52
+ provider: z.ZodString;
53
+ package: z.ZodOptional<z.ZodString>;
54
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
55
+ }, z.core.$strip>;
56
+ eventBus: z.ZodObject<{
57
+ provider: z.ZodString;
58
+ package: z.ZodOptional<z.ZodString>;
59
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
60
+ }, z.core.$strip>;
61
+ media: z.ZodDefault<z.ZodObject<{
62
+ provider: z.ZodString;
63
+ package: z.ZodOptional<z.ZodString>;
64
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
65
+ }, z.core.$strip>>;
89
66
  redis: z.ZodOptional<z.ZodObject<{
90
- /** Defaults to `REDIS_URL`. */
91
67
  url: z.ZodOptional<z.ZodString>;
92
- /** Namespaces every key and stream; defaults to `NYMBAL_REDIS_PREFIX`, then `'nymbal'`. */
93
68
  prefix: z.ZodOptional<z.ZodString>;
94
- /** How long a publish waits for the groups it delivers to (default 15 000). */
95
69
  ackTimeoutMs: z.ZodOptional<z.ZodNumber>;
96
- /** How long an entry may stay pending on a consumer before a live one takes it over (default 5 000). */
97
70
  claimIdleMs: z.ZodOptional<z.ZodNumber>;
98
- /** The approximate length each stream is trimmed to (default 10 000). */
99
71
  streamMaxLen: z.ZodOptional<z.ZodNumber>;
100
- }, "strict", z.ZodTypeAny, {
101
- url?: string | undefined;
102
- prefix?: string | undefined;
103
- ackTimeoutMs?: number | undefined;
104
- claimIdleMs?: number | undefined;
105
- streamMaxLen?: number | undefined;
106
- }, {
107
- url?: string | undefined;
108
- prefix?: string | undefined;
109
- ackTimeoutMs?: number | undefined;
110
- claimIdleMs?: number | undefined;
111
- streamMaxLen?: number | undefined;
112
- }>>;
72
+ }, z.core.$strict>>;
113
73
  s3: z.ZodOptional<z.ZodObject<{
114
- /** Defaults to `S3_BUCKET`; one of the two is required. */
115
74
  bucket: z.ZodOptional<z.ZodString>;
116
- /** Defaults to `AWS_REGION`, then `'us-east-1'`. */
117
75
  region: z.ZodOptional<z.ZodString>;
118
- /** An S3-compatible API (MinIO, R2); defaults to `S3_ENDPOINT`, then AWS. */
119
76
  endpoint: z.ZodOptional<z.ZodString>;
120
- /** Where every object key starts; defaults to `NYMBAL_S3_PREFIX`, then none. */
121
77
  prefix: z.ZodOptional<z.ZodString>;
122
- /** Where the bucket's objects are served from (a CDN); defaults to `S3_PUBLIC_URL`, then the bucket's own URL. */
123
78
  publicUrl: z.ZodOptional<z.ZodString>;
124
- /** Path-style requests; true by default when an endpoint is set. */
125
79
  forcePathStyle: z.ZodOptional<z.ZodBoolean>;
126
- }, "strict", z.ZodTypeAny, {
127
- prefix?: string | undefined;
128
- bucket?: string | undefined;
129
- region?: string | undefined;
130
- endpoint?: string | undefined;
131
- publicUrl?: string | undefined;
132
- forcePathStyle?: boolean | undefined;
133
- }, {
134
- prefix?: string | undefined;
135
- bucket?: string | undefined;
136
- region?: string | undefined;
137
- endpoint?: string | undefined;
138
- publicUrl?: string | undefined;
139
- forcePathStyle?: boolean | undefined;
140
- }>>;
141
- }, "strict", z.ZodTypeAny, {
142
- commandStore: "sqlite" | "postgres";
143
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
144
- eventBus: "in-process" | "redis-streams";
145
- media: "local-fs" | "s3";
146
- redis?: {
147
- url?: string | undefined;
148
- prefix?: string | undefined;
149
- ackTimeoutMs?: number | undefined;
150
- claimIdleMs?: number | undefined;
151
- streamMaxLen?: number | undefined;
152
- } | undefined;
153
- s3?: {
154
- prefix?: string | undefined;
155
- bucket?: string | undefined;
156
- region?: string | undefined;
157
- endpoint?: string | undefined;
158
- publicUrl?: string | undefined;
159
- forcePathStyle?: boolean | undefined;
160
- } | undefined;
161
- }, {
162
- commandStore: "sqlite" | "postgres";
163
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
164
- eventBus: "in-process" | "redis-streams";
165
- redis?: {
166
- url?: string | undefined;
167
- prefix?: string | undefined;
168
- ackTimeoutMs?: number | undefined;
169
- claimIdleMs?: number | undefined;
170
- streamMaxLen?: number | undefined;
171
- } | undefined;
172
- media?: "local-fs" | "s3" | undefined;
173
- s3?: {
174
- prefix?: string | undefined;
175
- bucket?: string | undefined;
176
- region?: string | undefined;
177
- endpoint?: string | undefined;
178
- publicUrl?: string | undefined;
179
- forcePathStyle?: boolean | undefined;
180
- } | undefined;
181
- }>, {
182
- commandStore: "sqlite" | "postgres";
183
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
184
- eventBus: "in-process" | "redis-streams";
185
- media: "local-fs" | "s3";
186
- redis?: {
187
- url?: string | undefined;
188
- prefix?: string | undefined;
189
- ackTimeoutMs?: number | undefined;
190
- claimIdleMs?: number | undefined;
191
- streamMaxLen?: number | undefined;
192
- } | undefined;
193
- s3?: {
194
- prefix?: string | undefined;
195
- bucket?: string | undefined;
196
- region?: string | undefined;
197
- endpoint?: string | undefined;
198
- publicUrl?: string | undefined;
199
- forcePathStyle?: boolean | undefined;
200
- } | undefined;
201
- }, {
202
- commandStore: "sqlite" | "postgres";
203
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
204
- eventBus: "in-process" | "redis-streams";
205
- redis?: {
206
- url?: string | undefined;
207
- prefix?: string | undefined;
208
- ackTimeoutMs?: number | undefined;
209
- claimIdleMs?: number | undefined;
210
- streamMaxLen?: number | undefined;
211
- } | undefined;
212
- media?: "local-fs" | "s3" | undefined;
213
- s3?: {
214
- prefix?: string | undefined;
215
- bucket?: string | undefined;
216
- region?: string | undefined;
217
- endpoint?: string | undefined;
218
- publicUrl?: string | undefined;
219
- forcePathStyle?: boolean | undefined;
220
- } | undefined;
221
- }>;
222
- declare const securitySchema: z.ZodEffects<z.ZodObject<{
223
- adapter: z.ZodEnum<["middleware", "cloudflare", "aws-waf", "akamai"]>;
80
+ }, z.core.$strict>>;
81
+ }, z.core.$strict>;
82
+ declare const securitySchema: z.ZodObject<{
83
+ adapter: z.ZodString;
84
+ package: z.ZodOptional<z.ZodString>;
85
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
224
86
  rateLimit: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
225
87
  requests: z.ZodNumber;
226
88
  window: z.ZodString;
227
- action: z.ZodEnum<["block", "challenge", "throttle"]>;
228
- }, "strip", z.ZodTypeAny, {
229
- requests: number;
230
- window: string;
231
- action: "block" | "challenge" | "throttle";
232
- }, {
233
- requests: number;
234
- window: string;
235
- action: "block" | "challenge" | "throttle";
236
- }>>>;
89
+ action: z.ZodEnum<{
90
+ block: "block";
91
+ challenge: "challenge";
92
+ throttle: "throttle";
93
+ }>;
94
+ header: z.ZodOptional<z.ZodString>;
95
+ }, z.core.$strip>>>;
237
96
  botProtection: z.ZodDefault<z.ZodObject<{
238
- mode: z.ZodDefault<z.ZodEnum<["off", "managed", "strict"]>>;
239
- allowList: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
240
- }, "strip", z.ZodTypeAny, {
241
- mode: "strict" | "off" | "managed";
242
- allowList: string[];
243
- }, {
244
- mode?: "strict" | "off" | "managed" | undefined;
245
- allowList?: string[] | undefined;
246
- }>>;
247
- headers: z.ZodDefault<z.ZodObject<{
97
+ mode: z.ZodDefault<z.ZodEnum<{
98
+ off: "off";
99
+ managed: "managed";
100
+ strict: "strict";
101
+ }>>;
102
+ allowList: z.ZodDefault<z.ZodArray<z.ZodString>>;
103
+ }, z.core.$strip>>;
104
+ headers: z.ZodPrefault<z.ZodObject<{
248
105
  hsts: z.ZodDefault<z.ZodBoolean>;
249
- contentSecurityPolicy: z.ZodDefault<z.ZodUnion<[z.ZodEnum<["strict", "relaxed", "off"]>, z.ZodString]>>;
106
+ contentSecurityPolicy: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
107
+ off: "off";
108
+ strict: "strict";
109
+ relaxed: "relaxed";
110
+ }>, z.ZodString]>>;
250
111
  referrerPolicy: z.ZodDefault<z.ZodString>;
251
- xFrameOptions: z.ZodDefault<z.ZodEnum<["deny", "sameorigin"]>>;
252
- }, "strip", z.ZodTypeAny, {
253
- hsts: boolean;
254
- contentSecurityPolicy: string;
255
- referrerPolicy: string;
256
- xFrameOptions: "deny" | "sameorigin";
257
- }, {
258
- hsts?: boolean | undefined;
259
- contentSecurityPolicy?: string | undefined;
260
- referrerPolicy?: string | undefined;
261
- xFrameOptions?: "deny" | "sameorigin" | undefined;
262
- }>>;
112
+ xFrameOptions: z.ZodDefault<z.ZodEnum<{
113
+ deny: "deny";
114
+ sameorigin: "sameorigin";
115
+ }>>;
116
+ }, z.core.$strip>>;
263
117
  csrf: z.ZodDefault<z.ZodBoolean>;
264
- auth: z.ZodDefault<z.ZodObject<{
118
+ originLock: z.ZodPrefault<z.ZodObject<{
119
+ header: z.ZodDefault<z.ZodString>;
120
+ }, z.core.$strip>>;
121
+ auth: z.ZodPrefault<z.ZodObject<{
265
122
  jwtSecret: z.ZodDefault<z.ZodString>;
266
123
  accessTtl: z.ZodDefault<z.ZodString>;
267
124
  refreshTtl: z.ZodDefault<z.ZodString>;
268
- }, "strip", z.ZodTypeAny, {
269
- jwtSecret: string;
270
- accessTtl: string;
271
- refreshTtl: string;
272
- }, {
273
- jwtSecret?: string | undefined;
274
- accessTtl?: string | undefined;
275
- refreshTtl?: string | undefined;
276
- }>>;
125
+ }, z.core.$strip>>;
277
126
  cloudflare: z.ZodOptional<z.ZodObject<{
278
127
  zoneId: z.ZodOptional<z.ZodString>;
279
128
  apiToken: z.ZodOptional<z.ZodString>;
280
- /** The Cloudflare v4 API; the adapter defaults it to https://api.cloudflare.com/client/v4. */
281
129
  apiBase: z.ZodOptional<z.ZodString>;
282
- }, "strip", z.ZodTypeAny, {
283
- zoneId?: string | undefined;
284
- apiToken?: string | undefined;
285
- apiBase?: string | undefined;
286
- }, {
287
- zoneId?: string | undefined;
288
- apiToken?: string | undefined;
289
- apiBase?: string | undefined;
290
- }>>;
130
+ }, z.core.$strip>>;
291
131
  geo: z.ZodDefault<z.ZodObject<{
292
- block: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
293
- }, "strip", z.ZodTypeAny, {
294
- block: string[];
295
- }, {
296
- block?: string[] | undefined;
297
- }>>;
132
+ block: z.ZodDefault<z.ZodArray<z.ZodString>>;
133
+ }, z.core.$strip>>;
298
134
  customRules: z.ZodDefault<z.ZodArray<z.ZodObject<{
299
135
  name: z.ZodString;
300
136
  expression: z.ZodString;
301
- action: z.ZodEnum<["block", "managed_challenge", "js_challenge", "log"]>;
302
- }, "strip", z.ZodTypeAny, {
303
- name: string;
304
- action: "block" | "managed_challenge" | "js_challenge" | "log";
305
- expression: string;
306
- }, {
307
- name: string;
308
- action: "block" | "managed_challenge" | "js_challenge" | "log";
309
- expression: string;
310
- }>, "many">>;
311
- managedRulesets: z.ZodDefault<z.ZodArray<z.ZodEnum<["cloudflare", "owasp"]>, "many">>;
312
- }, "strip", z.ZodTypeAny, {
313
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
314
- rateLimit: Record<string, {
315
- requests: number;
316
- window: string;
317
- action: "block" | "challenge" | "throttle";
318
- }>;
319
- botProtection: {
320
- mode: "strict" | "off" | "managed";
321
- allowList: string[];
322
- };
323
- headers: {
324
- hsts: boolean;
325
- contentSecurityPolicy: string;
326
- referrerPolicy: string;
327
- xFrameOptions: "deny" | "sameorigin";
328
- };
329
- csrf: boolean;
330
- auth: {
331
- jwtSecret: string;
332
- accessTtl: string;
333
- refreshTtl: string;
334
- };
335
- geo: {
336
- block: string[];
337
- };
338
- customRules: {
339
- name: string;
340
- action: "block" | "managed_challenge" | "js_challenge" | "log";
341
- expression: string;
342
- }[];
343
- managedRulesets: ("cloudflare" | "owasp")[];
344
- cloudflare?: {
345
- zoneId?: string | undefined;
346
- apiToken?: string | undefined;
347
- apiBase?: string | undefined;
348
- } | undefined;
349
- }, {
350
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
351
- cloudflare?: {
352
- zoneId?: string | undefined;
353
- apiToken?: string | undefined;
354
- apiBase?: string | undefined;
355
- } | undefined;
356
- rateLimit?: Record<string, {
357
- requests: number;
358
- window: string;
359
- action: "block" | "challenge" | "throttle";
360
- }> | undefined;
361
- botProtection?: {
362
- mode?: "strict" | "off" | "managed" | undefined;
363
- allowList?: string[] | undefined;
364
- } | undefined;
365
- headers?: {
366
- hsts?: boolean | undefined;
367
- contentSecurityPolicy?: string | undefined;
368
- referrerPolicy?: string | undefined;
369
- xFrameOptions?: "deny" | "sameorigin" | undefined;
370
- } | undefined;
371
- csrf?: boolean | undefined;
372
- auth?: {
373
- jwtSecret?: string | undefined;
374
- accessTtl?: string | undefined;
375
- refreshTtl?: string | undefined;
376
- } | undefined;
377
- geo?: {
378
- block?: string[] | undefined;
379
- } | undefined;
380
- customRules?: {
381
- name: string;
382
- action: "block" | "managed_challenge" | "js_challenge" | "log";
383
- expression: string;
384
- }[] | undefined;
385
- managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
386
- }>, {
387
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
388
- rateLimit: Record<string, {
389
- requests: number;
390
- window: string;
391
- action: "block" | "challenge" | "throttle";
392
- }>;
393
- botProtection: {
394
- mode: "strict" | "off" | "managed";
395
- allowList: string[];
396
- };
397
- headers: {
398
- hsts: boolean;
399
- contentSecurityPolicy: string;
400
- referrerPolicy: string;
401
- xFrameOptions: "deny" | "sameorigin";
402
- };
403
- csrf: boolean;
404
- auth: {
405
- jwtSecret: string;
406
- accessTtl: string;
407
- refreshTtl: string;
408
- };
409
- geo: {
410
- block: string[];
411
- };
412
- customRules: {
413
- name: string;
414
- action: "block" | "managed_challenge" | "js_challenge" | "log";
415
- expression: string;
416
- }[];
417
- managedRulesets: ("cloudflare" | "owasp")[];
418
- cloudflare?: {
419
- zoneId?: string | undefined;
420
- apiToken?: string | undefined;
421
- apiBase?: string | undefined;
422
- } | undefined;
423
- }, {
424
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
425
- cloudflare?: {
426
- zoneId?: string | undefined;
427
- apiToken?: string | undefined;
428
- apiBase?: string | undefined;
429
- } | undefined;
430
- rateLimit?: Record<string, {
431
- requests: number;
432
- window: string;
433
- action: "block" | "challenge" | "throttle";
434
- }> | undefined;
435
- botProtection?: {
436
- mode?: "strict" | "off" | "managed" | undefined;
437
- allowList?: string[] | undefined;
438
- } | undefined;
439
- headers?: {
440
- hsts?: boolean | undefined;
441
- contentSecurityPolicy?: string | undefined;
442
- referrerPolicy?: string | undefined;
443
- xFrameOptions?: "deny" | "sameorigin" | undefined;
444
- } | undefined;
445
- csrf?: boolean | undefined;
446
- auth?: {
447
- jwtSecret?: string | undefined;
448
- accessTtl?: string | undefined;
449
- refreshTtl?: string | undefined;
450
- } | undefined;
451
- geo?: {
452
- block?: string[] | undefined;
453
- } | undefined;
454
- customRules?: {
455
- name: string;
456
- action: "block" | "managed_challenge" | "js_challenge" | "log";
457
- expression: string;
458
- }[] | undefined;
459
- managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
460
- }>;
137
+ action: z.ZodEnum<{
138
+ block: "block";
139
+ managed_challenge: "managed_challenge";
140
+ js_challenge: "js_challenge";
141
+ log: "log";
142
+ }>;
143
+ }, z.core.$strip>>>;
144
+ managedRulesets: z.ZodDefault<z.ZodArray<z.ZodEnum<{
145
+ cloudflare: "cloudflare";
146
+ owasp: "owasp";
147
+ }>>>;
148
+ }, z.core.$strip>;
461
149
  declare const commerceSchema: z.ZodObject<{
462
150
  payments: z.ZodObject<{
463
- provider: z.ZodEnum<["native", "stripe", "custom"]>;
151
+ provider: z.ZodString;
464
152
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
465
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
466
153
  package: z.ZodOptional<z.ZodString>;
467
- }, "strip", z.ZodTypeAny, {
468
- provider: "native" | "stripe" | "custom";
469
- config?: Record<string, unknown> | undefined;
470
- package?: string | undefined;
471
- }, {
472
- provider: "native" | "stripe" | "custom";
473
- config?: Record<string, unknown> | undefined;
474
- package?: string | undefined;
475
- }>;
154
+ }, z.core.$strip>;
476
155
  email: z.ZodObject<{
477
- provider: z.ZodEnum<["native", "smtp", "custom"]>;
156
+ provider: z.ZodString;
478
157
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
479
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
480
158
  package: z.ZodOptional<z.ZodString>;
481
- }, "strip", z.ZodTypeAny, {
482
- provider: "native" | "custom" | "smtp";
483
- config?: Record<string, unknown> | undefined;
484
- package?: string | undefined;
485
- }, {
486
- provider: "native" | "custom" | "smtp";
487
- config?: Record<string, unknown> | undefined;
488
- package?: string | undefined;
489
- }>;
159
+ }, z.core.$strip>;
490
160
  reviews: z.ZodObject<{
491
- provider: z.ZodEnum<["native", "custom"]>;
161
+ provider: z.ZodString;
492
162
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
493
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
494
163
  package: z.ZodOptional<z.ZodString>;
495
- }, "strip", z.ZodTypeAny, {
496
- provider: "native" | "custom";
497
- config?: Record<string, unknown> | undefined;
498
- package?: string | undefined;
499
- }, {
500
- provider: "native" | "custom";
501
- config?: Record<string, unknown> | undefined;
502
- package?: string | undefined;
503
- }>;
164
+ }, z.core.$strip>;
504
165
  search: z.ZodObject<{
505
- provider: z.ZodEnum<["native", "custom"]>;
166
+ provider: z.ZodString;
506
167
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
507
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
508
168
  package: z.ZodOptional<z.ZodString>;
509
- }, "strip", z.ZodTypeAny, {
510
- provider: "native" | "custom";
511
- config?: Record<string, unknown> | undefined;
512
- package?: string | undefined;
513
- }, {
514
- provider: "native" | "custom";
515
- config?: Record<string, unknown> | undefined;
516
- package?: string | undefined;
517
- }>;
169
+ }, z.core.$strip>;
518
170
  analytics: z.ZodObject<{
519
- provider: z.ZodEnum<["native", "custom"]>;
171
+ provider: z.ZodString;
520
172
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
521
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
522
173
  package: z.ZodOptional<z.ZodString>;
523
- }, "strip", z.ZodTypeAny, {
524
- provider: "native" | "custom";
525
- config?: Record<string, unknown> | undefined;
526
- package?: string | undefined;
527
- }, {
528
- provider: "native" | "custom";
529
- config?: Record<string, unknown> | undefined;
530
- package?: string | undefined;
531
- }>;
174
+ }, z.core.$strip>;
532
175
  shipping: z.ZodObject<{
533
- provider: z.ZodEnum<["native", "custom"]>;
176
+ provider: z.ZodString;
534
177
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
535
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
536
178
  package: z.ZodOptional<z.ZodString>;
537
- }, "strip", z.ZodTypeAny, {
538
- provider: "native" | "custom";
539
- config?: Record<string, unknown> | undefined;
540
- package?: string | undefined;
541
- }, {
542
- provider: "native" | "custom";
543
- config?: Record<string, unknown> | undefined;
544
- package?: string | undefined;
545
- }>;
179
+ }, z.core.$strip>;
546
180
  tax: z.ZodObject<{
547
- provider: z.ZodEnum<["native", "custom"]>;
181
+ provider: z.ZodString;
548
182
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
549
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
550
183
  package: z.ZodOptional<z.ZodString>;
551
- }, "strip", z.ZodTypeAny, {
552
- provider: "native" | "custom";
553
- config?: Record<string, unknown> | undefined;
554
- package?: string | undefined;
555
- }, {
556
- provider: "native" | "custom";
557
- config?: Record<string, unknown> | undefined;
558
- package?: string | undefined;
559
- }>;
184
+ }, z.core.$strip>;
560
185
  ai: z.ZodObject<{
561
- provider: z.ZodEnum<["none", "anthropic", "custom"]>;
186
+ provider: z.ZodString;
562
187
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
563
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
564
188
  package: z.ZodOptional<z.ZodString>;
565
- }, "strip", z.ZodTypeAny, {
566
- provider: "custom" | "none" | "anthropic";
567
- config?: Record<string, unknown> | undefined;
568
- package?: string | undefined;
569
- }, {
570
- provider: "custom" | "none" | "anthropic";
571
- config?: Record<string, unknown> | undefined;
572
- package?: string | undefined;
573
- }>;
574
- orders: z.ZodDefault<z.ZodObject<{
189
+ }, z.core.$strip>;
190
+ orders: z.ZodPrefault<z.ZodObject<{
575
191
  numberPrefix: z.ZodDefault<z.ZodString>;
576
192
  numberStart: z.ZodDefault<z.ZodNumber>;
577
- }, "strip", z.ZodTypeAny, {
578
- numberPrefix: string;
579
- numberStart: number;
580
- }, {
581
- numberPrefix?: string | undefined;
582
- numberStart?: number | undefined;
583
- }>>;
584
- }, "strip", z.ZodTypeAny, {
585
- payments: {
586
- provider: "native" | "stripe" | "custom";
587
- config?: Record<string, unknown> | undefined;
588
- package?: string | undefined;
589
- };
590
- email: {
591
- provider: "native" | "custom" | "smtp";
592
- config?: Record<string, unknown> | undefined;
593
- package?: string | undefined;
594
- };
595
- reviews: {
596
- provider: "native" | "custom";
597
- config?: Record<string, unknown> | undefined;
598
- package?: string | undefined;
599
- };
600
- search: {
601
- provider: "native" | "custom";
602
- config?: Record<string, unknown> | undefined;
603
- package?: string | undefined;
604
- };
605
- analytics: {
606
- provider: "native" | "custom";
607
- config?: Record<string, unknown> | undefined;
608
- package?: string | undefined;
609
- };
610
- shipping: {
611
- provider: "native" | "custom";
612
- config?: Record<string, unknown> | undefined;
613
- package?: string | undefined;
614
- };
615
- tax: {
616
- provider: "native" | "custom";
617
- config?: Record<string, unknown> | undefined;
618
- package?: string | undefined;
619
- };
620
- ai: {
621
- provider: "custom" | "none" | "anthropic";
622
- config?: Record<string, unknown> | undefined;
623
- package?: string | undefined;
624
- };
625
- orders: {
626
- numberPrefix: string;
627
- numberStart: number;
628
- };
629
- }, {
630
- payments: {
631
- provider: "native" | "stripe" | "custom";
632
- config?: Record<string, unknown> | undefined;
633
- package?: string | undefined;
634
- };
635
- email: {
636
- provider: "native" | "custom" | "smtp";
637
- config?: Record<string, unknown> | undefined;
638
- package?: string | undefined;
639
- };
640
- reviews: {
641
- provider: "native" | "custom";
642
- config?: Record<string, unknown> | undefined;
643
- package?: string | undefined;
644
- };
645
- search: {
646
- provider: "native" | "custom";
647
- config?: Record<string, unknown> | undefined;
648
- package?: string | undefined;
649
- };
650
- analytics: {
651
- provider: "native" | "custom";
652
- config?: Record<string, unknown> | undefined;
653
- package?: string | undefined;
654
- };
655
- shipping: {
656
- provider: "native" | "custom";
657
- config?: Record<string, unknown> | undefined;
658
- package?: string | undefined;
659
- };
660
- tax: {
661
- provider: "native" | "custom";
662
- config?: Record<string, unknown> | undefined;
663
- package?: string | undefined;
664
- };
665
- ai: {
666
- provider: "custom" | "none" | "anthropic";
667
- config?: Record<string, unknown> | undefined;
668
- package?: string | undefined;
669
- };
670
- orders?: {
671
- numberPrefix?: string | undefined;
672
- numberStart?: number | undefined;
673
- } | undefined;
674
- }>;
193
+ keyLifetime: z.ZodPrefault<z.ZodObject<{
194
+ checkout: z.ZodDefault<z.ZodString>;
195
+ email: z.ZodDefault<z.ZodString>;
196
+ }, z.core.$strip>>;
197
+ }, z.core.$strip>>;
198
+ }, z.core.$strip>;
675
199
  declare const httpSchema: z.ZodObject<{
676
- adapter: z.ZodDefault<z.ZodEnum<["fastify", "hono"]>>;
200
+ adapter: z.ZodDefault<z.ZodEnum<{
201
+ fastify: "fastify";
202
+ hono: "hono";
203
+ }>>;
677
204
  port: z.ZodDefault<z.ZodNumber>;
678
205
  host: z.ZodDefault<z.ZodString>;
679
- /** Whether `X-Forwarded-For` sets the client IP the rate limiter keys on; only behind a proxy you run. */
680
- trustProxy: z.ZodDefault<z.ZodBoolean>;
681
- cors: z.ZodDefault<z.ZodObject<{
682
- allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
206
+ trustedProxies: z.ZodOptional<z.ZodArray<z.ZodString>>;
207
+ clientIpHeader: z.ZodOptional<z.ZodString>;
208
+ trustProxy: z.ZodOptional<z.ZodNever>;
209
+ cors: z.ZodPrefault<z.ZodObject<{
210
+ allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
683
211
  credentials: z.ZodDefault<z.ZodBoolean>;
684
- }, "strip", z.ZodTypeAny, {
685
- allowedOrigins: string[];
686
- credentials: boolean;
687
- }, {
688
- allowedOrigins?: string[] | undefined;
689
- credentials?: boolean | undefined;
690
- }>>;
691
- }, "strip", z.ZodTypeAny, {
692
- adapter: "fastify" | "hono";
693
- port: number;
694
- host: string;
695
- trustProxy: boolean;
696
- cors: {
697
- allowedOrigins: string[];
698
- credentials: boolean;
699
- };
700
- }, {
701
- adapter?: "fastify" | "hono" | undefined;
702
- port?: number | undefined;
703
- host?: string | undefined;
704
- trustProxy?: boolean | undefined;
705
- cors?: {
706
- allowedOrigins?: string[] | undefined;
707
- credentials?: boolean | undefined;
708
- } | undefined;
709
- }>;
212
+ }, z.core.$strip>>;
213
+ }, z.core.$strip>;
710
214
  declare const deploymentSchema: z.ZodObject<{
711
- strategy: z.ZodDefault<z.ZodEnum<["standard", "blue-green"]>>;
712
- }, "strip", z.ZodTypeAny, {
713
- strategy: "standard" | "blue-green";
714
- }, {
715
- strategy?: "standard" | "blue-green" | undefined;
716
- }>;
215
+ strategy: z.ZodDefault<z.ZodEnum<{
216
+ standard: "standard";
217
+ "blue-green": "blue-green";
218
+ }>>;
219
+ }, z.core.$strip>;
717
220
  declare const featuresSchema: z.ZodObject<{
718
221
  staging: z.ZodDefault<z.ZodBoolean>;
719
222
  heartbeat: z.ZodDefault<z.ZodBoolean>;
720
223
  autoUpdates: z.ZodDefault<z.ZodBoolean>;
721
- }, "strip", z.ZodTypeAny, {
722
- staging: boolean;
723
- heartbeat: boolean;
724
- autoUpdates: boolean;
725
- }, {
726
- staging?: boolean | undefined;
727
- heartbeat?: boolean | undefined;
728
- autoUpdates?: boolean | undefined;
729
- }>;
224
+ }, z.core.$strip>;
730
225
  /**
731
226
  * The bucket delivered events past retention are archived to before they are deleted. Its objects hold customer
732
227
  * data, so it must be private: never the media bucket, which serves its objects publicly. Credentials come from the
@@ -735,1370 +230,360 @@ declare const featuresSchema: z.ZodObject<{
735
230
  declare const eventArchiveSchema: z.ZodObject<{
736
231
  adapter: z.ZodLiteral<"s3">;
737
232
  bucket: z.ZodString;
738
- /** Where every archive key starts; none when not given. */
739
233
  prefix: z.ZodOptional<z.ZodString>;
740
- /** `'us-east-1'` when not given. */
741
234
  region: z.ZodOptional<z.ZodString>;
742
- /** An S3-compatible API (MinIO, R2). */
743
235
  endpoint: z.ZodOptional<z.ZodString>;
744
- /** Path-style requests; true by default when an endpoint is set. */
745
236
  forcePathStyle: z.ZodOptional<z.ZodBoolean>;
746
- }, "strict", z.ZodTypeAny, {
747
- bucket: string;
748
- adapter: "s3";
749
- prefix?: string | undefined;
750
- region?: string | undefined;
751
- endpoint?: string | undefined;
752
- forcePathStyle?: boolean | undefined;
753
- }, {
754
- bucket: string;
755
- adapter: "s3";
756
- prefix?: string | undefined;
757
- region?: string | undefined;
758
- endpoint?: string | undefined;
759
- forcePathStyle?: boolean | undefined;
760
- }>;
237
+ }, z.core.$strict>;
761
238
  declare const eventsSchema: z.ZodObject<{
762
- /** Days a delivered event stays in the log. */
763
239
  retentionDays: z.ZodDefault<z.ZodNumber>;
764
240
  archive: z.ZodOptional<z.ZodObject<{
765
241
  adapter: z.ZodLiteral<"s3">;
766
242
  bucket: z.ZodString;
767
- /** Where every archive key starts; none when not given. */
768
243
  prefix: z.ZodOptional<z.ZodString>;
769
- /** `'us-east-1'` when not given. */
770
244
  region: z.ZodOptional<z.ZodString>;
771
- /** An S3-compatible API (MinIO, R2). */
772
245
  endpoint: z.ZodOptional<z.ZodString>;
773
- /** Path-style requests; true by default when an endpoint is set. */
774
246
  forcePathStyle: z.ZodOptional<z.ZodBoolean>;
775
- }, "strict", z.ZodTypeAny, {
776
- bucket: string;
777
- adapter: "s3";
778
- prefix?: string | undefined;
779
- region?: string | undefined;
780
- endpoint?: string | undefined;
781
- forcePathStyle?: boolean | undefined;
782
- }, {
783
- bucket: string;
784
- adapter: "s3";
785
- prefix?: string | undefined;
786
- region?: string | undefined;
787
- endpoint?: string | undefined;
788
- forcePathStyle?: boolean | undefined;
789
- }>>;
790
- }, "strict", z.ZodTypeAny, {
791
- retentionDays: number;
792
- archive?: {
793
- bucket: string;
794
- adapter: "s3";
795
- prefix?: string | undefined;
796
- region?: string | undefined;
797
- endpoint?: string | undefined;
798
- forcePathStyle?: boolean | undefined;
799
- } | undefined;
800
- }, {
801
- retentionDays?: number | undefined;
802
- archive?: {
803
- bucket: string;
804
- adapter: "s3";
805
- prefix?: string | undefined;
806
- region?: string | undefined;
807
- endpoint?: string | undefined;
808
- forcePathStyle?: boolean | undefined;
809
- } | undefined;
810
- }>;
811
- declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
247
+ }, z.core.$strict>>;
248
+ }, z.core.$strict>;
249
+ /**
250
+ * The AI crawlers `robots.txt` names and allows by default, each as its vendor documents it:
251
+ * - GPTBot, OAI-SearchBot, ChatGPT-User: https://platform.openai.com/docs/bots
252
+ * - ClaudeBot, Claude-User, Claude-SearchBot:
253
+ * https://support.claude.com/en/articles/8896518-does-anthropic-crawl-data-from-the-web-and-how-can-site-owners-block-the-crawler
254
+ * - PerplexityBot, Perplexity-User: https://docs.perplexity.ai/guides/bots
255
+ * - Google-Extended: https://developers.google.com/search/docs/crawling-indexing/google-common-crawlers
256
+ * - Applebot-Extended: https://support.apple.com/en-us/119829
257
+ */
258
+ declare const DEFAULT_AGENT_CRAWLERS: readonly string[];
259
+ /** The link types the Agentic Commerce Protocol (2026-04-17) names for a session's `links`. */
260
+ declare const ACP_LINK_TYPES: readonly ["terms_of_use", "privacy_policy", "return_policy", "shipping_policy", "contact_us", "about_us", "faq", "support"];
261
+ /** The shortest ACP key the store takes, from the config or `NYMBAL_ACP_API_KEY`. */
262
+ declare const ACP_KEY_MIN_LENGTH = 32;
263
+ /**
264
+ * How agents reach the store. Under `mcp.writes: 'proposal'` an admin command tool's call is kept as a proposal an
265
+ * admin approves or rejects, unless `autoApprove` lists its command; `'apply'` approves every command at the call.
266
+ * Either way the proposal is recorded. A command that moves money cannot be listed in `autoApprove`. `ucp` is the
267
+ * Universal Commerce Protocol profile and its MCP endpoint; `links` are the legal pages a UCP checkout names. `acp`
268
+ * is the Agentic Commerce Protocol's checkout (beta, off unless enabled), held by a bearer key of at least 32
269
+ * characters (`apiKey`, else `NYMBAL_ACP_API_KEY`). `crawl` is what `robots.txt`, `llms.txt` and the product feed serve.
270
+ * `assistant` is what the admin's assistant may send its AI provider.
271
+ */
272
+ declare const agentsSchema: z.ZodObject<{
273
+ mcp: z.ZodPrefault<z.ZodObject<{
274
+ enabled: z.ZodDefault<z.ZodBoolean>;
275
+ writes: z.ZodDefault<z.ZodEnum<{
276
+ proposal: "proposal";
277
+ apply: "apply";
278
+ }>>;
279
+ }, z.core.$strict>>;
280
+ autoApprove: z.ZodDefault<z.ZodArray<z.ZodString>>;
281
+ ucp: z.ZodPrefault<z.ZodObject<{
282
+ enabled: z.ZodDefault<z.ZodBoolean>;
283
+ links: z.ZodDefault<z.ZodArray<z.ZodObject<{
284
+ type: z.ZodString;
285
+ url: z.ZodString;
286
+ title: z.ZodOptional<z.ZodString>;
287
+ }, z.core.$strict>>>;
288
+ }, z.core.$strict>>;
289
+ acp: z.ZodPrefault<z.ZodObject<{
290
+ enabled: z.ZodDefault<z.ZodBoolean>;
291
+ apiKey: z.ZodOptional<z.ZodString>;
292
+ links: z.ZodDefault<z.ZodArray<z.ZodObject<{
293
+ type: z.ZodEnum<{
294
+ terms_of_use: "terms_of_use";
295
+ privacy_policy: "privacy_policy";
296
+ return_policy: "return_policy";
297
+ shipping_policy: "shipping_policy";
298
+ contact_us: "contact_us";
299
+ about_us: "about_us";
300
+ faq: "faq";
301
+ support: "support";
302
+ }>;
303
+ url: z.ZodString;
304
+ title: z.ZodOptional<z.ZodString>;
305
+ }, z.core.$strict>>>;
306
+ merchantId: z.ZodOptional<z.ZodString>;
307
+ }, z.core.$strict>>;
308
+ crawl: z.ZodPrefault<z.ZodObject<{
309
+ robots: z.ZodDefault<z.ZodBoolean>;
310
+ llms: z.ZodDefault<z.ZodBoolean>;
311
+ feed: z.ZodDefault<z.ZodBoolean>;
312
+ allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
313
+ others: z.ZodDefault<z.ZodEnum<{
314
+ allow: "allow";
315
+ disallow: "disallow";
316
+ }>>;
317
+ }, z.core.$strict>>;
318
+ assistant: z.ZodPrefault<z.ZodObject<{
319
+ customerData: z.ZodDefault<z.ZodBoolean>;
320
+ }, z.core.$strict>>;
321
+ }, z.core.$strict>;
322
+ declare const nymbalConfigSchema: z.ZodObject<{
812
323
  store: z.ZodObject<{
813
324
  name: z.ZodString;
814
325
  currency: z.ZodString;
815
326
  locale: z.ZodString;
816
327
  timezone: z.ZodString;
817
- /** The storefront's public URL, which the order email links from; with none, the email has no link. */
818
- url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
819
- }, "strip", z.ZodTypeAny, {
820
- name: string;
821
- currency: string;
822
- locale: string;
823
- timezone: string;
824
- url?: string | undefined;
825
- }, {
826
- name: string;
827
- currency: string;
828
- locale: string;
829
- timezone: string;
830
- url?: string | undefined;
328
+ url: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
329
+ shipFrom: z.ZodOptional<z.ZodObject<{
330
+ firstName: z.ZodString;
331
+ lastName: z.ZodString;
332
+ company: z.ZodOptional<z.ZodString>;
333
+ addressLine1: z.ZodString;
334
+ addressLine2: z.ZodOptional<z.ZodString>;
335
+ city: z.ZodString;
336
+ region: z.ZodString;
337
+ postalCode: z.ZodString;
338
+ country: z.ZodString;
339
+ phone: z.ZodOptional<z.ZodString>;
340
+ }, z.core.$strip>>;
341
+ }, z.core.$strip>;
342
+ template: z.ZodEnum<{
343
+ astro: "astro";
344
+ nextjs: "nextjs";
831
345
  }>;
832
- template: z.ZodEnum<["astro", "nextjs"]>;
833
- infrastructure: z.ZodEffects<z.ZodObject<{
834
- commandStore: z.ZodEnum<["sqlite", "postgres"]>;
835
- documentStore: z.ZodEnum<["in-memory", "redis", "postgres-jsonb"]>;
836
- eventBus: z.ZodEnum<["in-process", "redis-streams"]>;
837
- media: z.ZodDefault<z.ZodEnum<["local-fs", "s3"]>>;
346
+ infrastructure: z.ZodObject<{
347
+ commandStore: z.ZodEnum<{
348
+ sqlite: "sqlite";
349
+ postgres: "postgres";
350
+ }>;
351
+ documentStore: z.ZodObject<{
352
+ provider: z.ZodString;
353
+ package: z.ZodOptional<z.ZodString>;
354
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
355
+ }, z.core.$strip>;
356
+ eventBus: z.ZodObject<{
357
+ provider: z.ZodString;
358
+ package: z.ZodOptional<z.ZodString>;
359
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
360
+ }, z.core.$strip>;
361
+ media: z.ZodDefault<z.ZodObject<{
362
+ provider: z.ZodString;
363
+ package: z.ZodOptional<z.ZodString>;
364
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
365
+ }, z.core.$strip>>;
838
366
  redis: z.ZodOptional<z.ZodObject<{
839
- /** Defaults to `REDIS_URL`. */
840
367
  url: z.ZodOptional<z.ZodString>;
841
- /** Namespaces every key and stream; defaults to `NYMBAL_REDIS_PREFIX`, then `'nymbal'`. */
842
368
  prefix: z.ZodOptional<z.ZodString>;
843
- /** How long a publish waits for the groups it delivers to (default 15 000). */
844
369
  ackTimeoutMs: z.ZodOptional<z.ZodNumber>;
845
- /** How long an entry may stay pending on a consumer before a live one takes it over (default 5 000). */
846
370
  claimIdleMs: z.ZodOptional<z.ZodNumber>;
847
- /** The approximate length each stream is trimmed to (default 10 000). */
848
371
  streamMaxLen: z.ZodOptional<z.ZodNumber>;
849
- }, "strict", z.ZodTypeAny, {
850
- url?: string | undefined;
851
- prefix?: string | undefined;
852
- ackTimeoutMs?: number | undefined;
853
- claimIdleMs?: number | undefined;
854
- streamMaxLen?: number | undefined;
855
- }, {
856
- url?: string | undefined;
857
- prefix?: string | undefined;
858
- ackTimeoutMs?: number | undefined;
859
- claimIdleMs?: number | undefined;
860
- streamMaxLen?: number | undefined;
861
- }>>;
372
+ }, z.core.$strict>>;
862
373
  s3: z.ZodOptional<z.ZodObject<{
863
- /** Defaults to `S3_BUCKET`; one of the two is required. */
864
374
  bucket: z.ZodOptional<z.ZodString>;
865
- /** Defaults to `AWS_REGION`, then `'us-east-1'`. */
866
375
  region: z.ZodOptional<z.ZodString>;
867
- /** An S3-compatible API (MinIO, R2); defaults to `S3_ENDPOINT`, then AWS. */
868
376
  endpoint: z.ZodOptional<z.ZodString>;
869
- /** Where every object key starts; defaults to `NYMBAL_S3_PREFIX`, then none. */
870
377
  prefix: z.ZodOptional<z.ZodString>;
871
- /** Where the bucket's objects are served from (a CDN); defaults to `S3_PUBLIC_URL`, then the bucket's own URL. */
872
378
  publicUrl: z.ZodOptional<z.ZodString>;
873
- /** Path-style requests; true by default when an endpoint is set. */
874
379
  forcePathStyle: z.ZodOptional<z.ZodBoolean>;
875
- }, "strict", z.ZodTypeAny, {
876
- prefix?: string | undefined;
877
- bucket?: string | undefined;
878
- region?: string | undefined;
879
- endpoint?: string | undefined;
880
- publicUrl?: string | undefined;
881
- forcePathStyle?: boolean | undefined;
882
- }, {
883
- prefix?: string | undefined;
884
- bucket?: string | undefined;
885
- region?: string | undefined;
886
- endpoint?: string | undefined;
887
- publicUrl?: string | undefined;
888
- forcePathStyle?: boolean | undefined;
889
- }>>;
890
- }, "strict", z.ZodTypeAny, {
891
- commandStore: "sqlite" | "postgres";
892
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
893
- eventBus: "in-process" | "redis-streams";
894
- media: "local-fs" | "s3";
895
- redis?: {
896
- url?: string | undefined;
897
- prefix?: string | undefined;
898
- ackTimeoutMs?: number | undefined;
899
- claimIdleMs?: number | undefined;
900
- streamMaxLen?: number | undefined;
901
- } | undefined;
902
- s3?: {
903
- prefix?: string | undefined;
904
- bucket?: string | undefined;
905
- region?: string | undefined;
906
- endpoint?: string | undefined;
907
- publicUrl?: string | undefined;
908
- forcePathStyle?: boolean | undefined;
909
- } | undefined;
910
- }, {
911
- commandStore: "sqlite" | "postgres";
912
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
913
- eventBus: "in-process" | "redis-streams";
914
- redis?: {
915
- url?: string | undefined;
916
- prefix?: string | undefined;
917
- ackTimeoutMs?: number | undefined;
918
- claimIdleMs?: number | undefined;
919
- streamMaxLen?: number | undefined;
920
- } | undefined;
921
- media?: "local-fs" | "s3" | undefined;
922
- s3?: {
923
- prefix?: string | undefined;
924
- bucket?: string | undefined;
925
- region?: string | undefined;
926
- endpoint?: string | undefined;
927
- publicUrl?: string | undefined;
928
- forcePathStyle?: boolean | undefined;
929
- } | undefined;
930
- }>, {
931
- commandStore: "sqlite" | "postgres";
932
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
933
- eventBus: "in-process" | "redis-streams";
934
- media: "local-fs" | "s3";
935
- redis?: {
936
- url?: string | undefined;
937
- prefix?: string | undefined;
938
- ackTimeoutMs?: number | undefined;
939
- claimIdleMs?: number | undefined;
940
- streamMaxLen?: number | undefined;
941
- } | undefined;
942
- s3?: {
943
- prefix?: string | undefined;
944
- bucket?: string | undefined;
945
- region?: string | undefined;
946
- endpoint?: string | undefined;
947
- publicUrl?: string | undefined;
948
- forcePathStyle?: boolean | undefined;
949
- } | undefined;
950
- }, {
951
- commandStore: "sqlite" | "postgres";
952
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
953
- eventBus: "in-process" | "redis-streams";
954
- redis?: {
955
- url?: string | undefined;
956
- prefix?: string | undefined;
957
- ackTimeoutMs?: number | undefined;
958
- claimIdleMs?: number | undefined;
959
- streamMaxLen?: number | undefined;
960
- } | undefined;
961
- media?: "local-fs" | "s3" | undefined;
962
- s3?: {
963
- prefix?: string | undefined;
964
- bucket?: string | undefined;
965
- region?: string | undefined;
966
- endpoint?: string | undefined;
967
- publicUrl?: string | undefined;
968
- forcePathStyle?: boolean | undefined;
969
- } | undefined;
970
- }>;
971
- security: z.ZodEffects<z.ZodObject<{
972
- adapter: z.ZodEnum<["middleware", "cloudflare", "aws-waf", "akamai"]>;
380
+ }, z.core.$strict>>;
381
+ }, z.core.$strict>;
382
+ security: z.ZodObject<{
383
+ adapter: z.ZodString;
384
+ package: z.ZodOptional<z.ZodString>;
385
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
973
386
  rateLimit: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
974
387
  requests: z.ZodNumber;
975
388
  window: z.ZodString;
976
- action: z.ZodEnum<["block", "challenge", "throttle"]>;
977
- }, "strip", z.ZodTypeAny, {
978
- requests: number;
979
- window: string;
980
- action: "block" | "challenge" | "throttle";
981
- }, {
982
- requests: number;
983
- window: string;
984
- action: "block" | "challenge" | "throttle";
985
- }>>>;
389
+ action: z.ZodEnum<{
390
+ block: "block";
391
+ challenge: "challenge";
392
+ throttle: "throttle";
393
+ }>;
394
+ header: z.ZodOptional<z.ZodString>;
395
+ }, z.core.$strip>>>;
986
396
  botProtection: z.ZodDefault<z.ZodObject<{
987
- mode: z.ZodDefault<z.ZodEnum<["off", "managed", "strict"]>>;
988
- allowList: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
989
- }, "strip", z.ZodTypeAny, {
990
- mode: "strict" | "off" | "managed";
991
- allowList: string[];
992
- }, {
993
- mode?: "strict" | "off" | "managed" | undefined;
994
- allowList?: string[] | undefined;
995
- }>>;
996
- headers: z.ZodDefault<z.ZodObject<{
397
+ mode: z.ZodDefault<z.ZodEnum<{
398
+ off: "off";
399
+ managed: "managed";
400
+ strict: "strict";
401
+ }>>;
402
+ allowList: z.ZodDefault<z.ZodArray<z.ZodString>>;
403
+ }, z.core.$strip>>;
404
+ headers: z.ZodPrefault<z.ZodObject<{
997
405
  hsts: z.ZodDefault<z.ZodBoolean>;
998
- contentSecurityPolicy: z.ZodDefault<z.ZodUnion<[z.ZodEnum<["strict", "relaxed", "off"]>, z.ZodString]>>;
406
+ contentSecurityPolicy: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
407
+ off: "off";
408
+ strict: "strict";
409
+ relaxed: "relaxed";
410
+ }>, z.ZodString]>>;
999
411
  referrerPolicy: z.ZodDefault<z.ZodString>;
1000
- xFrameOptions: z.ZodDefault<z.ZodEnum<["deny", "sameorigin"]>>;
1001
- }, "strip", z.ZodTypeAny, {
1002
- hsts: boolean;
1003
- contentSecurityPolicy: string;
1004
- referrerPolicy: string;
1005
- xFrameOptions: "deny" | "sameorigin";
1006
- }, {
1007
- hsts?: boolean | undefined;
1008
- contentSecurityPolicy?: string | undefined;
1009
- referrerPolicy?: string | undefined;
1010
- xFrameOptions?: "deny" | "sameorigin" | undefined;
1011
- }>>;
412
+ xFrameOptions: z.ZodDefault<z.ZodEnum<{
413
+ deny: "deny";
414
+ sameorigin: "sameorigin";
415
+ }>>;
416
+ }, z.core.$strip>>;
1012
417
  csrf: z.ZodDefault<z.ZodBoolean>;
1013
- auth: z.ZodDefault<z.ZodObject<{
418
+ originLock: z.ZodPrefault<z.ZodObject<{
419
+ header: z.ZodDefault<z.ZodString>;
420
+ }, z.core.$strip>>;
421
+ auth: z.ZodPrefault<z.ZodObject<{
1014
422
  jwtSecret: z.ZodDefault<z.ZodString>;
1015
423
  accessTtl: z.ZodDefault<z.ZodString>;
1016
424
  refreshTtl: z.ZodDefault<z.ZodString>;
1017
- }, "strip", z.ZodTypeAny, {
1018
- jwtSecret: string;
1019
- accessTtl: string;
1020
- refreshTtl: string;
1021
- }, {
1022
- jwtSecret?: string | undefined;
1023
- accessTtl?: string | undefined;
1024
- refreshTtl?: string | undefined;
1025
- }>>;
425
+ }, z.core.$strip>>;
1026
426
  cloudflare: z.ZodOptional<z.ZodObject<{
1027
427
  zoneId: z.ZodOptional<z.ZodString>;
1028
428
  apiToken: z.ZodOptional<z.ZodString>;
1029
- /** The Cloudflare v4 API; the adapter defaults it to https://api.cloudflare.com/client/v4. */
1030
429
  apiBase: z.ZodOptional<z.ZodString>;
1031
- }, "strip", z.ZodTypeAny, {
1032
- zoneId?: string | undefined;
1033
- apiToken?: string | undefined;
1034
- apiBase?: string | undefined;
1035
- }, {
1036
- zoneId?: string | undefined;
1037
- apiToken?: string | undefined;
1038
- apiBase?: string | undefined;
1039
- }>>;
430
+ }, z.core.$strip>>;
1040
431
  geo: z.ZodDefault<z.ZodObject<{
1041
- block: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
1042
- }, "strip", z.ZodTypeAny, {
1043
- block: string[];
1044
- }, {
1045
- block?: string[] | undefined;
1046
- }>>;
432
+ block: z.ZodDefault<z.ZodArray<z.ZodString>>;
433
+ }, z.core.$strip>>;
1047
434
  customRules: z.ZodDefault<z.ZodArray<z.ZodObject<{
1048
435
  name: z.ZodString;
1049
436
  expression: z.ZodString;
1050
- action: z.ZodEnum<["block", "managed_challenge", "js_challenge", "log"]>;
1051
- }, "strip", z.ZodTypeAny, {
1052
- name: string;
1053
- action: "block" | "managed_challenge" | "js_challenge" | "log";
1054
- expression: string;
1055
- }, {
1056
- name: string;
1057
- action: "block" | "managed_challenge" | "js_challenge" | "log";
1058
- expression: string;
1059
- }>, "many">>;
1060
- managedRulesets: z.ZodDefault<z.ZodArray<z.ZodEnum<["cloudflare", "owasp"]>, "many">>;
1061
- }, "strip", z.ZodTypeAny, {
1062
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1063
- rateLimit: Record<string, {
1064
- requests: number;
1065
- window: string;
1066
- action: "block" | "challenge" | "throttle";
1067
- }>;
1068
- botProtection: {
1069
- mode: "strict" | "off" | "managed";
1070
- allowList: string[];
1071
- };
1072
- headers: {
1073
- hsts: boolean;
1074
- contentSecurityPolicy: string;
1075
- referrerPolicy: string;
1076
- xFrameOptions: "deny" | "sameorigin";
1077
- };
1078
- csrf: boolean;
1079
- auth: {
1080
- jwtSecret: string;
1081
- accessTtl: string;
1082
- refreshTtl: string;
1083
- };
1084
- geo: {
1085
- block: string[];
1086
- };
1087
- customRules: {
1088
- name: string;
1089
- action: "block" | "managed_challenge" | "js_challenge" | "log";
1090
- expression: string;
1091
- }[];
1092
- managedRulesets: ("cloudflare" | "owasp")[];
1093
- cloudflare?: {
1094
- zoneId?: string | undefined;
1095
- apiToken?: string | undefined;
1096
- apiBase?: string | undefined;
1097
- } | undefined;
1098
- }, {
1099
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1100
- cloudflare?: {
1101
- zoneId?: string | undefined;
1102
- apiToken?: string | undefined;
1103
- apiBase?: string | undefined;
1104
- } | undefined;
1105
- rateLimit?: Record<string, {
1106
- requests: number;
1107
- window: string;
1108
- action: "block" | "challenge" | "throttle";
1109
- }> | undefined;
1110
- botProtection?: {
1111
- mode?: "strict" | "off" | "managed" | undefined;
1112
- allowList?: string[] | undefined;
1113
- } | undefined;
1114
- headers?: {
1115
- hsts?: boolean | undefined;
1116
- contentSecurityPolicy?: string | undefined;
1117
- referrerPolicy?: string | undefined;
1118
- xFrameOptions?: "deny" | "sameorigin" | undefined;
1119
- } | undefined;
1120
- csrf?: boolean | undefined;
1121
- auth?: {
1122
- jwtSecret?: string | undefined;
1123
- accessTtl?: string | undefined;
1124
- refreshTtl?: string | undefined;
1125
- } | undefined;
1126
- geo?: {
1127
- block?: string[] | undefined;
1128
- } | undefined;
1129
- customRules?: {
1130
- name: string;
1131
- action: "block" | "managed_challenge" | "js_challenge" | "log";
1132
- expression: string;
1133
- }[] | undefined;
1134
- managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
1135
- }>, {
1136
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1137
- rateLimit: Record<string, {
1138
- requests: number;
1139
- window: string;
1140
- action: "block" | "challenge" | "throttle";
1141
- }>;
1142
- botProtection: {
1143
- mode: "strict" | "off" | "managed";
1144
- allowList: string[];
1145
- };
1146
- headers: {
1147
- hsts: boolean;
1148
- contentSecurityPolicy: string;
1149
- referrerPolicy: string;
1150
- xFrameOptions: "deny" | "sameorigin";
1151
- };
1152
- csrf: boolean;
1153
- auth: {
1154
- jwtSecret: string;
1155
- accessTtl: string;
1156
- refreshTtl: string;
1157
- };
1158
- geo: {
1159
- block: string[];
1160
- };
1161
- customRules: {
1162
- name: string;
1163
- action: "block" | "managed_challenge" | "js_challenge" | "log";
1164
- expression: string;
1165
- }[];
1166
- managedRulesets: ("cloudflare" | "owasp")[];
1167
- cloudflare?: {
1168
- zoneId?: string | undefined;
1169
- apiToken?: string | undefined;
1170
- apiBase?: string | undefined;
1171
- } | undefined;
1172
- }, {
1173
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1174
- cloudflare?: {
1175
- zoneId?: string | undefined;
1176
- apiToken?: string | undefined;
1177
- apiBase?: string | undefined;
1178
- } | undefined;
1179
- rateLimit?: Record<string, {
1180
- requests: number;
1181
- window: string;
1182
- action: "block" | "challenge" | "throttle";
1183
- }> | undefined;
1184
- botProtection?: {
1185
- mode?: "strict" | "off" | "managed" | undefined;
1186
- allowList?: string[] | undefined;
1187
- } | undefined;
1188
- headers?: {
1189
- hsts?: boolean | undefined;
1190
- contentSecurityPolicy?: string | undefined;
1191
- referrerPolicy?: string | undefined;
1192
- xFrameOptions?: "deny" | "sameorigin" | undefined;
1193
- } | undefined;
1194
- csrf?: boolean | undefined;
1195
- auth?: {
1196
- jwtSecret?: string | undefined;
1197
- accessTtl?: string | undefined;
1198
- refreshTtl?: string | undefined;
1199
- } | undefined;
1200
- geo?: {
1201
- block?: string[] | undefined;
1202
- } | undefined;
1203
- customRules?: {
1204
- name: string;
1205
- action: "block" | "managed_challenge" | "js_challenge" | "log";
1206
- expression: string;
1207
- }[] | undefined;
1208
- managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
1209
- }>;
437
+ action: z.ZodEnum<{
438
+ block: "block";
439
+ managed_challenge: "managed_challenge";
440
+ js_challenge: "js_challenge";
441
+ log: "log";
442
+ }>;
443
+ }, z.core.$strip>>>;
444
+ managedRulesets: z.ZodDefault<z.ZodArray<z.ZodEnum<{
445
+ cloudflare: "cloudflare";
446
+ owasp: "owasp";
447
+ }>>>;
448
+ }, z.core.$strip>;
1210
449
  commerce: z.ZodObject<{
1211
450
  payments: z.ZodObject<{
1212
- provider: z.ZodEnum<["native", "stripe", "custom"]>;
451
+ provider: z.ZodString;
1213
452
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1214
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
1215
453
  package: z.ZodOptional<z.ZodString>;
1216
- }, "strip", z.ZodTypeAny, {
1217
- provider: "native" | "stripe" | "custom";
1218
- config?: Record<string, unknown> | undefined;
1219
- package?: string | undefined;
1220
- }, {
1221
- provider: "native" | "stripe" | "custom";
1222
- config?: Record<string, unknown> | undefined;
1223
- package?: string | undefined;
1224
- }>;
454
+ }, z.core.$strip>;
1225
455
  email: z.ZodObject<{
1226
- provider: z.ZodEnum<["native", "smtp", "custom"]>;
456
+ provider: z.ZodString;
1227
457
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1228
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
1229
458
  package: z.ZodOptional<z.ZodString>;
1230
- }, "strip", z.ZodTypeAny, {
1231
- provider: "native" | "custom" | "smtp";
1232
- config?: Record<string, unknown> | undefined;
1233
- package?: string | undefined;
1234
- }, {
1235
- provider: "native" | "custom" | "smtp";
1236
- config?: Record<string, unknown> | undefined;
1237
- package?: string | undefined;
1238
- }>;
459
+ }, z.core.$strip>;
1239
460
  reviews: z.ZodObject<{
1240
- provider: z.ZodEnum<["native", "custom"]>;
461
+ provider: z.ZodString;
1241
462
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1242
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
1243
463
  package: z.ZodOptional<z.ZodString>;
1244
- }, "strip", z.ZodTypeAny, {
1245
- provider: "native" | "custom";
1246
- config?: Record<string, unknown> | undefined;
1247
- package?: string | undefined;
1248
- }, {
1249
- provider: "native" | "custom";
1250
- config?: Record<string, unknown> | undefined;
1251
- package?: string | undefined;
1252
- }>;
464
+ }, z.core.$strip>;
1253
465
  search: z.ZodObject<{
1254
- provider: z.ZodEnum<["native", "custom"]>;
466
+ provider: z.ZodString;
1255
467
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1256
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
1257
468
  package: z.ZodOptional<z.ZodString>;
1258
- }, "strip", z.ZodTypeAny, {
1259
- provider: "native" | "custom";
1260
- config?: Record<string, unknown> | undefined;
1261
- package?: string | undefined;
1262
- }, {
1263
- provider: "native" | "custom";
1264
- config?: Record<string, unknown> | undefined;
1265
- package?: string | undefined;
1266
- }>;
469
+ }, z.core.$strip>;
1267
470
  analytics: z.ZodObject<{
1268
- provider: z.ZodEnum<["native", "custom"]>;
471
+ provider: z.ZodString;
1269
472
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1270
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
1271
473
  package: z.ZodOptional<z.ZodString>;
1272
- }, "strip", z.ZodTypeAny, {
1273
- provider: "native" | "custom";
1274
- config?: Record<string, unknown> | undefined;
1275
- package?: string | undefined;
1276
- }, {
1277
- provider: "native" | "custom";
1278
- config?: Record<string, unknown> | undefined;
1279
- package?: string | undefined;
1280
- }>;
474
+ }, z.core.$strip>;
1281
475
  shipping: z.ZodObject<{
1282
- provider: z.ZodEnum<["native", "custom"]>;
476
+ provider: z.ZodString;
1283
477
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1284
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
1285
478
  package: z.ZodOptional<z.ZodString>;
1286
- }, "strip", z.ZodTypeAny, {
1287
- provider: "native" | "custom";
1288
- config?: Record<string, unknown> | undefined;
1289
- package?: string | undefined;
1290
- }, {
1291
- provider: "native" | "custom";
1292
- config?: Record<string, unknown> | undefined;
1293
- package?: string | undefined;
1294
- }>;
479
+ }, z.core.$strip>;
1295
480
  tax: z.ZodObject<{
1296
- provider: z.ZodEnum<["native", "custom"]>;
481
+ provider: z.ZodString;
1297
482
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1298
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
1299
483
  package: z.ZodOptional<z.ZodString>;
1300
- }, "strip", z.ZodTypeAny, {
1301
- provider: "native" | "custom";
1302
- config?: Record<string, unknown> | undefined;
1303
- package?: string | undefined;
1304
- }, {
1305
- provider: "native" | "custom";
1306
- config?: Record<string, unknown> | undefined;
1307
- package?: string | undefined;
1308
- }>;
484
+ }, z.core.$strip>;
1309
485
  ai: z.ZodObject<{
1310
- provider: z.ZodEnum<["none", "anthropic", "custom"]>;
486
+ provider: z.ZodString;
1311
487
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1312
- /** The npm package a `custom` slot's adapter comes from, for tooling (`nymbal test:contracts`); the kernel never reads it. */
1313
488
  package: z.ZodOptional<z.ZodString>;
1314
- }, "strip", z.ZodTypeAny, {
1315
- provider: "custom" | "none" | "anthropic";
1316
- config?: Record<string, unknown> | undefined;
1317
- package?: string | undefined;
1318
- }, {
1319
- provider: "custom" | "none" | "anthropic";
1320
- config?: Record<string, unknown> | undefined;
1321
- package?: string | undefined;
1322
- }>;
1323
- orders: z.ZodDefault<z.ZodObject<{
489
+ }, z.core.$strip>;
490
+ orders: z.ZodPrefault<z.ZodObject<{
1324
491
  numberPrefix: z.ZodDefault<z.ZodString>;
1325
492
  numberStart: z.ZodDefault<z.ZodNumber>;
1326
- }, "strip", z.ZodTypeAny, {
1327
- numberPrefix: string;
1328
- numberStart: number;
1329
- }, {
1330
- numberPrefix?: string | undefined;
1331
- numberStart?: number | undefined;
1332
- }>>;
1333
- }, "strip", z.ZodTypeAny, {
1334
- payments: {
1335
- provider: "native" | "stripe" | "custom";
1336
- config?: Record<string, unknown> | undefined;
1337
- package?: string | undefined;
1338
- };
1339
- email: {
1340
- provider: "native" | "custom" | "smtp";
1341
- config?: Record<string, unknown> | undefined;
1342
- package?: string | undefined;
1343
- };
1344
- reviews: {
1345
- provider: "native" | "custom";
1346
- config?: Record<string, unknown> | undefined;
1347
- package?: string | undefined;
1348
- };
1349
- search: {
1350
- provider: "native" | "custom";
1351
- config?: Record<string, unknown> | undefined;
1352
- package?: string | undefined;
1353
- };
1354
- analytics: {
1355
- provider: "native" | "custom";
1356
- config?: Record<string, unknown> | undefined;
1357
- package?: string | undefined;
1358
- };
1359
- shipping: {
1360
- provider: "native" | "custom";
1361
- config?: Record<string, unknown> | undefined;
1362
- package?: string | undefined;
1363
- };
1364
- tax: {
1365
- provider: "native" | "custom";
1366
- config?: Record<string, unknown> | undefined;
1367
- package?: string | undefined;
1368
- };
1369
- ai: {
1370
- provider: "custom" | "none" | "anthropic";
1371
- config?: Record<string, unknown> | undefined;
1372
- package?: string | undefined;
1373
- };
1374
- orders: {
1375
- numberPrefix: string;
1376
- numberStart: number;
1377
- };
1378
- }, {
1379
- payments: {
1380
- provider: "native" | "stripe" | "custom";
1381
- config?: Record<string, unknown> | undefined;
1382
- package?: string | undefined;
1383
- };
1384
- email: {
1385
- provider: "native" | "custom" | "smtp";
1386
- config?: Record<string, unknown> | undefined;
1387
- package?: string | undefined;
1388
- };
1389
- reviews: {
1390
- provider: "native" | "custom";
1391
- config?: Record<string, unknown> | undefined;
1392
- package?: string | undefined;
1393
- };
1394
- search: {
1395
- provider: "native" | "custom";
1396
- config?: Record<string, unknown> | undefined;
1397
- package?: string | undefined;
1398
- };
1399
- analytics: {
1400
- provider: "native" | "custom";
1401
- config?: Record<string, unknown> | undefined;
1402
- package?: string | undefined;
1403
- };
1404
- shipping: {
1405
- provider: "native" | "custom";
1406
- config?: Record<string, unknown> | undefined;
1407
- package?: string | undefined;
1408
- };
1409
- tax: {
1410
- provider: "native" | "custom";
1411
- config?: Record<string, unknown> | undefined;
1412
- package?: string | undefined;
1413
- };
1414
- ai: {
1415
- provider: "custom" | "none" | "anthropic";
1416
- config?: Record<string, unknown> | undefined;
1417
- package?: string | undefined;
1418
- };
1419
- orders?: {
1420
- numberPrefix?: string | undefined;
1421
- numberStart?: number | undefined;
1422
- } | undefined;
1423
- }>;
493
+ keyLifetime: z.ZodPrefault<z.ZodObject<{
494
+ checkout: z.ZodDefault<z.ZodString>;
495
+ email: z.ZodDefault<z.ZodString>;
496
+ }, z.core.$strip>>;
497
+ }, z.core.$strip>>;
498
+ }, z.core.$strip>;
1424
499
  http: z.ZodObject<{
1425
- adapter: z.ZodDefault<z.ZodEnum<["fastify", "hono"]>>;
500
+ adapter: z.ZodDefault<z.ZodEnum<{
501
+ fastify: "fastify";
502
+ hono: "hono";
503
+ }>>;
1426
504
  port: z.ZodDefault<z.ZodNumber>;
1427
505
  host: z.ZodDefault<z.ZodString>;
1428
- /** Whether `X-Forwarded-For` sets the client IP the rate limiter keys on; only behind a proxy you run. */
1429
- trustProxy: z.ZodDefault<z.ZodBoolean>;
1430
- cors: z.ZodDefault<z.ZodObject<{
1431
- allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
506
+ trustedProxies: z.ZodOptional<z.ZodArray<z.ZodString>>;
507
+ clientIpHeader: z.ZodOptional<z.ZodString>;
508
+ trustProxy: z.ZodOptional<z.ZodNever>;
509
+ cors: z.ZodPrefault<z.ZodObject<{
510
+ allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
1432
511
  credentials: z.ZodDefault<z.ZodBoolean>;
1433
- }, "strip", z.ZodTypeAny, {
1434
- allowedOrigins: string[];
1435
- credentials: boolean;
1436
- }, {
1437
- allowedOrigins?: string[] | undefined;
1438
- credentials?: boolean | undefined;
1439
- }>>;
1440
- }, "strip", z.ZodTypeAny, {
1441
- adapter: "fastify" | "hono";
1442
- port: number;
1443
- host: string;
1444
- trustProxy: boolean;
1445
- cors: {
1446
- allowedOrigins: string[];
1447
- credentials: boolean;
1448
- };
1449
- }, {
1450
- adapter?: "fastify" | "hono" | undefined;
1451
- port?: number | undefined;
1452
- host?: string | undefined;
1453
- trustProxy?: boolean | undefined;
1454
- cors?: {
1455
- allowedOrigins?: string[] | undefined;
1456
- credentials?: boolean | undefined;
1457
- } | undefined;
1458
- }>;
512
+ }, z.core.$strip>>;
513
+ }, z.core.$strip>;
1459
514
  deployment: z.ZodObject<{
1460
- strategy: z.ZodDefault<z.ZodEnum<["standard", "blue-green"]>>;
1461
- }, "strip", z.ZodTypeAny, {
1462
- strategy: "standard" | "blue-green";
1463
- }, {
1464
- strategy?: "standard" | "blue-green" | undefined;
1465
- }>;
515
+ strategy: z.ZodDefault<z.ZodEnum<{
516
+ standard: "standard";
517
+ "blue-green": "blue-green";
518
+ }>>;
519
+ }, z.core.$strip>;
1466
520
  features: z.ZodDefault<z.ZodObject<{
1467
521
  staging: z.ZodDefault<z.ZodBoolean>;
1468
522
  heartbeat: z.ZodDefault<z.ZodBoolean>;
1469
523
  autoUpdates: z.ZodDefault<z.ZodBoolean>;
1470
- }, "strip", z.ZodTypeAny, {
1471
- staging: boolean;
1472
- heartbeat: boolean;
1473
- autoUpdates: boolean;
1474
- }, {
1475
- staging?: boolean | undefined;
1476
- heartbeat?: boolean | undefined;
1477
- autoUpdates?: boolean | undefined;
1478
- }>>;
1479
- events: z.ZodDefault<z.ZodObject<{
1480
- /** Days a delivered event stays in the log. */
524
+ }, z.core.$strip>>;
525
+ events: z.ZodPrefault<z.ZodObject<{
1481
526
  retentionDays: z.ZodDefault<z.ZodNumber>;
1482
527
  archive: z.ZodOptional<z.ZodObject<{
1483
528
  adapter: z.ZodLiteral<"s3">;
1484
529
  bucket: z.ZodString;
1485
- /** Where every archive key starts; none when not given. */
1486
530
  prefix: z.ZodOptional<z.ZodString>;
1487
- /** `'us-east-1'` when not given. */
1488
531
  region: z.ZodOptional<z.ZodString>;
1489
- /** An S3-compatible API (MinIO, R2). */
1490
532
  endpoint: z.ZodOptional<z.ZodString>;
1491
- /** Path-style requests; true by default when an endpoint is set. */
1492
533
  forcePathStyle: z.ZodOptional<z.ZodBoolean>;
1493
- }, "strict", z.ZodTypeAny, {
1494
- bucket: string;
1495
- adapter: "s3";
1496
- prefix?: string | undefined;
1497
- region?: string | undefined;
1498
- endpoint?: string | undefined;
1499
- forcePathStyle?: boolean | undefined;
1500
- }, {
1501
- bucket: string;
1502
- adapter: "s3";
1503
- prefix?: string | undefined;
1504
- region?: string | undefined;
1505
- endpoint?: string | undefined;
1506
- forcePathStyle?: boolean | undefined;
1507
- }>>;
1508
- }, "strict", z.ZodTypeAny, {
1509
- retentionDays: number;
1510
- archive?: {
1511
- bucket: string;
1512
- adapter: "s3";
1513
- prefix?: string | undefined;
1514
- region?: string | undefined;
1515
- endpoint?: string | undefined;
1516
- forcePathStyle?: boolean | undefined;
1517
- } | undefined;
1518
- }, {
1519
- retentionDays?: number | undefined;
1520
- archive?: {
1521
- bucket: string;
1522
- adapter: "s3";
1523
- prefix?: string | undefined;
1524
- region?: string | undefined;
1525
- endpoint?: string | undefined;
1526
- forcePathStyle?: boolean | undefined;
1527
- } | undefined;
1528
- }>>;
1529
- }, "strip", z.ZodTypeAny, {
1530
- store: {
1531
- name: string;
1532
- currency: string;
1533
- locale: string;
1534
- timezone: string;
1535
- url?: string | undefined;
1536
- };
1537
- template: "astro" | "nextjs";
1538
- infrastructure: {
1539
- commandStore: "sqlite" | "postgres";
1540
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
1541
- eventBus: "in-process" | "redis-streams";
1542
- media: "local-fs" | "s3";
1543
- redis?: {
1544
- url?: string | undefined;
1545
- prefix?: string | undefined;
1546
- ackTimeoutMs?: number | undefined;
1547
- claimIdleMs?: number | undefined;
1548
- streamMaxLen?: number | undefined;
1549
- } | undefined;
1550
- s3?: {
1551
- prefix?: string | undefined;
1552
- bucket?: string | undefined;
1553
- region?: string | undefined;
1554
- endpoint?: string | undefined;
1555
- publicUrl?: string | undefined;
1556
- forcePathStyle?: boolean | undefined;
1557
- } | undefined;
1558
- };
1559
- security: {
1560
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1561
- rateLimit: Record<string, {
1562
- requests: number;
1563
- window: string;
1564
- action: "block" | "challenge" | "throttle";
1565
- }>;
1566
- botProtection: {
1567
- mode: "strict" | "off" | "managed";
1568
- allowList: string[];
1569
- };
1570
- headers: {
1571
- hsts: boolean;
1572
- contentSecurityPolicy: string;
1573
- referrerPolicy: string;
1574
- xFrameOptions: "deny" | "sameorigin";
1575
- };
1576
- csrf: boolean;
1577
- auth: {
1578
- jwtSecret: string;
1579
- accessTtl: string;
1580
- refreshTtl: string;
1581
- };
1582
- geo: {
1583
- block: string[];
1584
- };
1585
- customRules: {
1586
- name: string;
1587
- action: "block" | "managed_challenge" | "js_challenge" | "log";
1588
- expression: string;
1589
- }[];
1590
- managedRulesets: ("cloudflare" | "owasp")[];
1591
- cloudflare?: {
1592
- zoneId?: string | undefined;
1593
- apiToken?: string | undefined;
1594
- apiBase?: string | undefined;
1595
- } | undefined;
1596
- };
1597
- commerce: {
1598
- payments: {
1599
- provider: "native" | "stripe" | "custom";
1600
- config?: Record<string, unknown> | undefined;
1601
- package?: string | undefined;
1602
- };
1603
- email: {
1604
- provider: "native" | "custom" | "smtp";
1605
- config?: Record<string, unknown> | undefined;
1606
- package?: string | undefined;
1607
- };
1608
- reviews: {
1609
- provider: "native" | "custom";
1610
- config?: Record<string, unknown> | undefined;
1611
- package?: string | undefined;
1612
- };
1613
- search: {
1614
- provider: "native" | "custom";
1615
- config?: Record<string, unknown> | undefined;
1616
- package?: string | undefined;
1617
- };
1618
- analytics: {
1619
- provider: "native" | "custom";
1620
- config?: Record<string, unknown> | undefined;
1621
- package?: string | undefined;
1622
- };
1623
- shipping: {
1624
- provider: "native" | "custom";
1625
- config?: Record<string, unknown> | undefined;
1626
- package?: string | undefined;
1627
- };
1628
- tax: {
1629
- provider: "native" | "custom";
1630
- config?: Record<string, unknown> | undefined;
1631
- package?: string | undefined;
1632
- };
1633
- ai: {
1634
- provider: "custom" | "none" | "anthropic";
1635
- config?: Record<string, unknown> | undefined;
1636
- package?: string | undefined;
1637
- };
1638
- orders: {
1639
- numberPrefix: string;
1640
- numberStart: number;
1641
- };
1642
- };
1643
- http: {
1644
- adapter: "fastify" | "hono";
1645
- port: number;
1646
- host: string;
1647
- trustProxy: boolean;
1648
- cors: {
1649
- allowedOrigins: string[];
1650
- credentials: boolean;
1651
- };
1652
- };
1653
- deployment: {
1654
- strategy: "standard" | "blue-green";
1655
- };
1656
- features: {
1657
- staging: boolean;
1658
- heartbeat: boolean;
1659
- autoUpdates: boolean;
1660
- };
1661
- events: {
1662
- retentionDays: number;
1663
- archive?: {
1664
- bucket: string;
1665
- adapter: "s3";
1666
- prefix?: string | undefined;
1667
- region?: string | undefined;
1668
- endpoint?: string | undefined;
1669
- forcePathStyle?: boolean | undefined;
1670
- } | undefined;
1671
- };
1672
- }, {
1673
- store: {
1674
- name: string;
1675
- currency: string;
1676
- locale: string;
1677
- timezone: string;
1678
- url?: string | undefined;
1679
- };
1680
- template: "astro" | "nextjs";
1681
- infrastructure: {
1682
- commandStore: "sqlite" | "postgres";
1683
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
1684
- eventBus: "in-process" | "redis-streams";
1685
- redis?: {
1686
- url?: string | undefined;
1687
- prefix?: string | undefined;
1688
- ackTimeoutMs?: number | undefined;
1689
- claimIdleMs?: number | undefined;
1690
- streamMaxLen?: number | undefined;
1691
- } | undefined;
1692
- media?: "local-fs" | "s3" | undefined;
1693
- s3?: {
1694
- prefix?: string | undefined;
1695
- bucket?: string | undefined;
1696
- region?: string | undefined;
1697
- endpoint?: string | undefined;
1698
- publicUrl?: string | undefined;
1699
- forcePathStyle?: boolean | undefined;
1700
- } | undefined;
1701
- };
1702
- security: {
1703
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1704
- cloudflare?: {
1705
- zoneId?: string | undefined;
1706
- apiToken?: string | undefined;
1707
- apiBase?: string | undefined;
1708
- } | undefined;
1709
- rateLimit?: Record<string, {
1710
- requests: number;
1711
- window: string;
1712
- action: "block" | "challenge" | "throttle";
1713
- }> | undefined;
1714
- botProtection?: {
1715
- mode?: "strict" | "off" | "managed" | undefined;
1716
- allowList?: string[] | undefined;
1717
- } | undefined;
1718
- headers?: {
1719
- hsts?: boolean | undefined;
1720
- contentSecurityPolicy?: string | undefined;
1721
- referrerPolicy?: string | undefined;
1722
- xFrameOptions?: "deny" | "sameorigin" | undefined;
1723
- } | undefined;
1724
- csrf?: boolean | undefined;
1725
- auth?: {
1726
- jwtSecret?: string | undefined;
1727
- accessTtl?: string | undefined;
1728
- refreshTtl?: string | undefined;
1729
- } | undefined;
1730
- geo?: {
1731
- block?: string[] | undefined;
1732
- } | undefined;
1733
- customRules?: {
1734
- name: string;
1735
- action: "block" | "managed_challenge" | "js_challenge" | "log";
1736
- expression: string;
1737
- }[] | undefined;
1738
- managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
1739
- };
1740
- commerce: {
1741
- payments: {
1742
- provider: "native" | "stripe" | "custom";
1743
- config?: Record<string, unknown> | undefined;
1744
- package?: string | undefined;
1745
- };
1746
- email: {
1747
- provider: "native" | "custom" | "smtp";
1748
- config?: Record<string, unknown> | undefined;
1749
- package?: string | undefined;
1750
- };
1751
- reviews: {
1752
- provider: "native" | "custom";
1753
- config?: Record<string, unknown> | undefined;
1754
- package?: string | undefined;
1755
- };
1756
- search: {
1757
- provider: "native" | "custom";
1758
- config?: Record<string, unknown> | undefined;
1759
- package?: string | undefined;
1760
- };
1761
- analytics: {
1762
- provider: "native" | "custom";
1763
- config?: Record<string, unknown> | undefined;
1764
- package?: string | undefined;
1765
- };
1766
- shipping: {
1767
- provider: "native" | "custom";
1768
- config?: Record<string, unknown> | undefined;
1769
- package?: string | undefined;
1770
- };
1771
- tax: {
1772
- provider: "native" | "custom";
1773
- config?: Record<string, unknown> | undefined;
1774
- package?: string | undefined;
1775
- };
1776
- ai: {
1777
- provider: "custom" | "none" | "anthropic";
1778
- config?: Record<string, unknown> | undefined;
1779
- package?: string | undefined;
1780
- };
1781
- orders?: {
1782
- numberPrefix?: string | undefined;
1783
- numberStart?: number | undefined;
1784
- } | undefined;
1785
- };
1786
- http: {
1787
- adapter?: "fastify" | "hono" | undefined;
1788
- port?: number | undefined;
1789
- host?: string | undefined;
1790
- trustProxy?: boolean | undefined;
1791
- cors?: {
1792
- allowedOrigins?: string[] | undefined;
1793
- credentials?: boolean | undefined;
1794
- } | undefined;
1795
- };
1796
- deployment: {
1797
- strategy?: "standard" | "blue-green" | undefined;
1798
- };
1799
- features?: {
1800
- staging?: boolean | undefined;
1801
- heartbeat?: boolean | undefined;
1802
- autoUpdates?: boolean | undefined;
1803
- } | undefined;
1804
- events?: {
1805
- retentionDays?: number | undefined;
1806
- archive?: {
1807
- bucket: string;
1808
- adapter: "s3";
1809
- prefix?: string | undefined;
1810
- region?: string | undefined;
1811
- endpoint?: string | undefined;
1812
- forcePathStyle?: boolean | undefined;
1813
- } | undefined;
1814
- } | undefined;
1815
- }>, {
1816
- store: {
1817
- name: string;
1818
- currency: string;
1819
- locale: string;
1820
- timezone: string;
1821
- url?: string | undefined;
1822
- };
1823
- template: "astro" | "nextjs";
1824
- infrastructure: {
1825
- commandStore: "sqlite" | "postgres";
1826
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
1827
- eventBus: "in-process" | "redis-streams";
1828
- media: "local-fs" | "s3";
1829
- redis?: {
1830
- url?: string | undefined;
1831
- prefix?: string | undefined;
1832
- ackTimeoutMs?: number | undefined;
1833
- claimIdleMs?: number | undefined;
1834
- streamMaxLen?: number | undefined;
1835
- } | undefined;
1836
- s3?: {
1837
- prefix?: string | undefined;
1838
- bucket?: string | undefined;
1839
- region?: string | undefined;
1840
- endpoint?: string | undefined;
1841
- publicUrl?: string | undefined;
1842
- forcePathStyle?: boolean | undefined;
1843
- } | undefined;
1844
- };
1845
- security: {
1846
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1847
- rateLimit: Record<string, {
1848
- requests: number;
1849
- window: string;
1850
- action: "block" | "challenge" | "throttle";
1851
- }>;
1852
- botProtection: {
1853
- mode: "strict" | "off" | "managed";
1854
- allowList: string[];
1855
- };
1856
- headers: {
1857
- hsts: boolean;
1858
- contentSecurityPolicy: string;
1859
- referrerPolicy: string;
1860
- xFrameOptions: "deny" | "sameorigin";
1861
- };
1862
- csrf: boolean;
1863
- auth: {
1864
- jwtSecret: string;
1865
- accessTtl: string;
1866
- refreshTtl: string;
1867
- };
1868
- geo: {
1869
- block: string[];
1870
- };
1871
- customRules: {
1872
- name: string;
1873
- action: "block" | "managed_challenge" | "js_challenge" | "log";
1874
- expression: string;
1875
- }[];
1876
- managedRulesets: ("cloudflare" | "owasp")[];
1877
- cloudflare?: {
1878
- zoneId?: string | undefined;
1879
- apiToken?: string | undefined;
1880
- apiBase?: string | undefined;
1881
- } | undefined;
1882
- };
1883
- commerce: {
1884
- payments: {
1885
- provider: "native" | "stripe" | "custom";
1886
- config?: Record<string, unknown> | undefined;
1887
- package?: string | undefined;
1888
- };
1889
- email: {
1890
- provider: "native" | "custom" | "smtp";
1891
- config?: Record<string, unknown> | undefined;
1892
- package?: string | undefined;
1893
- };
1894
- reviews: {
1895
- provider: "native" | "custom";
1896
- config?: Record<string, unknown> | undefined;
1897
- package?: string | undefined;
1898
- };
1899
- search: {
1900
- provider: "native" | "custom";
1901
- config?: Record<string, unknown> | undefined;
1902
- package?: string | undefined;
1903
- };
1904
- analytics: {
1905
- provider: "native" | "custom";
1906
- config?: Record<string, unknown> | undefined;
1907
- package?: string | undefined;
1908
- };
1909
- shipping: {
1910
- provider: "native" | "custom";
1911
- config?: Record<string, unknown> | undefined;
1912
- package?: string | undefined;
1913
- };
1914
- tax: {
1915
- provider: "native" | "custom";
1916
- config?: Record<string, unknown> | undefined;
1917
- package?: string | undefined;
1918
- };
1919
- ai: {
1920
- provider: "custom" | "none" | "anthropic";
1921
- config?: Record<string, unknown> | undefined;
1922
- package?: string | undefined;
1923
- };
1924
- orders: {
1925
- numberPrefix: string;
1926
- numberStart: number;
1927
- };
1928
- };
1929
- http: {
1930
- adapter: "fastify" | "hono";
1931
- port: number;
1932
- host: string;
1933
- trustProxy: boolean;
1934
- cors: {
1935
- allowedOrigins: string[];
1936
- credentials: boolean;
1937
- };
1938
- };
1939
- deployment: {
1940
- strategy: "standard" | "blue-green";
1941
- };
1942
- features: {
1943
- staging: boolean;
1944
- heartbeat: boolean;
1945
- autoUpdates: boolean;
1946
- };
1947
- events: {
1948
- retentionDays: number;
1949
- archive?: {
1950
- bucket: string;
1951
- adapter: "s3";
1952
- prefix?: string | undefined;
1953
- region?: string | undefined;
1954
- endpoint?: string | undefined;
1955
- forcePathStyle?: boolean | undefined;
1956
- } | undefined;
1957
- };
1958
- }, {
1959
- store: {
1960
- name: string;
1961
- currency: string;
1962
- locale: string;
1963
- timezone: string;
1964
- url?: string | undefined;
1965
- };
1966
- template: "astro" | "nextjs";
1967
- infrastructure: {
1968
- commandStore: "sqlite" | "postgres";
1969
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
1970
- eventBus: "in-process" | "redis-streams";
1971
- redis?: {
1972
- url?: string | undefined;
1973
- prefix?: string | undefined;
1974
- ackTimeoutMs?: number | undefined;
1975
- claimIdleMs?: number | undefined;
1976
- streamMaxLen?: number | undefined;
1977
- } | undefined;
1978
- media?: "local-fs" | "s3" | undefined;
1979
- s3?: {
1980
- prefix?: string | undefined;
1981
- bucket?: string | undefined;
1982
- region?: string | undefined;
1983
- endpoint?: string | undefined;
1984
- publicUrl?: string | undefined;
1985
- forcePathStyle?: boolean | undefined;
1986
- } | undefined;
1987
- };
1988
- security: {
1989
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1990
- cloudflare?: {
1991
- zoneId?: string | undefined;
1992
- apiToken?: string | undefined;
1993
- apiBase?: string | undefined;
1994
- } | undefined;
1995
- rateLimit?: Record<string, {
1996
- requests: number;
1997
- window: string;
1998
- action: "block" | "challenge" | "throttle";
1999
- }> | undefined;
2000
- botProtection?: {
2001
- mode?: "strict" | "off" | "managed" | undefined;
2002
- allowList?: string[] | undefined;
2003
- } | undefined;
2004
- headers?: {
2005
- hsts?: boolean | undefined;
2006
- contentSecurityPolicy?: string | undefined;
2007
- referrerPolicy?: string | undefined;
2008
- xFrameOptions?: "deny" | "sameorigin" | undefined;
2009
- } | undefined;
2010
- csrf?: boolean | undefined;
2011
- auth?: {
2012
- jwtSecret?: string | undefined;
2013
- accessTtl?: string | undefined;
2014
- refreshTtl?: string | undefined;
2015
- } | undefined;
2016
- geo?: {
2017
- block?: string[] | undefined;
2018
- } | undefined;
2019
- customRules?: {
2020
- name: string;
2021
- action: "block" | "managed_challenge" | "js_challenge" | "log";
2022
- expression: string;
2023
- }[] | undefined;
2024
- managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
2025
- };
2026
- commerce: {
2027
- payments: {
2028
- provider: "native" | "stripe" | "custom";
2029
- config?: Record<string, unknown> | undefined;
2030
- package?: string | undefined;
2031
- };
2032
- email: {
2033
- provider: "native" | "custom" | "smtp";
2034
- config?: Record<string, unknown> | undefined;
2035
- package?: string | undefined;
2036
- };
2037
- reviews: {
2038
- provider: "native" | "custom";
2039
- config?: Record<string, unknown> | undefined;
2040
- package?: string | undefined;
2041
- };
2042
- search: {
2043
- provider: "native" | "custom";
2044
- config?: Record<string, unknown> | undefined;
2045
- package?: string | undefined;
2046
- };
2047
- analytics: {
2048
- provider: "native" | "custom";
2049
- config?: Record<string, unknown> | undefined;
2050
- package?: string | undefined;
2051
- };
2052
- shipping: {
2053
- provider: "native" | "custom";
2054
- config?: Record<string, unknown> | undefined;
2055
- package?: string | undefined;
2056
- };
2057
- tax: {
2058
- provider: "native" | "custom";
2059
- config?: Record<string, unknown> | undefined;
2060
- package?: string | undefined;
2061
- };
2062
- ai: {
2063
- provider: "custom" | "none" | "anthropic";
2064
- config?: Record<string, unknown> | undefined;
2065
- package?: string | undefined;
2066
- };
2067
- orders?: {
2068
- numberPrefix?: string | undefined;
2069
- numberStart?: number | undefined;
2070
- } | undefined;
2071
- };
2072
- http: {
2073
- adapter?: "fastify" | "hono" | undefined;
2074
- port?: number | undefined;
2075
- host?: string | undefined;
2076
- trustProxy?: boolean | undefined;
2077
- cors?: {
2078
- allowedOrigins?: string[] | undefined;
2079
- credentials?: boolean | undefined;
2080
- } | undefined;
2081
- };
2082
- deployment: {
2083
- strategy?: "standard" | "blue-green" | undefined;
2084
- };
2085
- features?: {
2086
- staging?: boolean | undefined;
2087
- heartbeat?: boolean | undefined;
2088
- autoUpdates?: boolean | undefined;
2089
- } | undefined;
2090
- events?: {
2091
- retentionDays?: number | undefined;
2092
- archive?: {
2093
- bucket: string;
2094
- adapter: "s3";
2095
- prefix?: string | undefined;
2096
- region?: string | undefined;
2097
- endpoint?: string | undefined;
2098
- forcePathStyle?: boolean | undefined;
2099
- } | undefined;
2100
- } | undefined;
2101
- }>;
534
+ }, z.core.$strict>>;
535
+ }, z.core.$strict>>;
536
+ agents: z.ZodPrefault<z.ZodObject<{
537
+ mcp: z.ZodPrefault<z.ZodObject<{
538
+ enabled: z.ZodDefault<z.ZodBoolean>;
539
+ writes: z.ZodDefault<z.ZodEnum<{
540
+ proposal: "proposal";
541
+ apply: "apply";
542
+ }>>;
543
+ }, z.core.$strict>>;
544
+ autoApprove: z.ZodDefault<z.ZodArray<z.ZodString>>;
545
+ ucp: z.ZodPrefault<z.ZodObject<{
546
+ enabled: z.ZodDefault<z.ZodBoolean>;
547
+ links: z.ZodDefault<z.ZodArray<z.ZodObject<{
548
+ type: z.ZodString;
549
+ url: z.ZodString;
550
+ title: z.ZodOptional<z.ZodString>;
551
+ }, z.core.$strict>>>;
552
+ }, z.core.$strict>>;
553
+ acp: z.ZodPrefault<z.ZodObject<{
554
+ enabled: z.ZodDefault<z.ZodBoolean>;
555
+ apiKey: z.ZodOptional<z.ZodString>;
556
+ links: z.ZodDefault<z.ZodArray<z.ZodObject<{
557
+ type: z.ZodEnum<{
558
+ terms_of_use: "terms_of_use";
559
+ privacy_policy: "privacy_policy";
560
+ return_policy: "return_policy";
561
+ shipping_policy: "shipping_policy";
562
+ contact_us: "contact_us";
563
+ about_us: "about_us";
564
+ faq: "faq";
565
+ support: "support";
566
+ }>;
567
+ url: z.ZodString;
568
+ title: z.ZodOptional<z.ZodString>;
569
+ }, z.core.$strict>>>;
570
+ merchantId: z.ZodOptional<z.ZodString>;
571
+ }, z.core.$strict>>;
572
+ crawl: z.ZodPrefault<z.ZodObject<{
573
+ robots: z.ZodDefault<z.ZodBoolean>;
574
+ llms: z.ZodDefault<z.ZodBoolean>;
575
+ feed: z.ZodDefault<z.ZodBoolean>;
576
+ allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
577
+ others: z.ZodDefault<z.ZodEnum<{
578
+ allow: "allow";
579
+ disallow: "disallow";
580
+ }>>;
581
+ }, z.core.$strict>>;
582
+ assistant: z.ZodPrefault<z.ZodObject<{
583
+ customerData: z.ZodDefault<z.ZodBoolean>;
584
+ }, z.core.$strict>>;
585
+ }, z.core.$strict>>;
586
+ }, z.core.$strip>;
2102
587
  type NymbalConfigInput = z.input<typeof nymbalConfigSchema>;
2103
588
  type NymbalConfig = z.output<typeof nymbalConfigSchema>;
2104
589
 
@@ -2110,32 +595,43 @@ declare function envNumber(key: string, defaultValue?: number): number;
2110
595
  declare function envBool(key: string, defaultValue?: boolean): boolean;
2111
596
 
2112
597
  /**
2113
- * The providers each commerce slot accepts. A provider that needs an SDK lives in an `@nymbalhq/adapter-*` package the
2114
- * kernel loads only when the config names it; `custom` takes the adapter a project passes to `createApp`.
598
+ * The providers Nymbal ships for each commerce slot, from the catalogue, and `custom`, the adapter a project passes
599
+ * to `createApp`. A slot accepts any provider name; this list gates nothing.
2115
600
  */
2116
- declare const KNOWN_PROVIDERS: {
2117
- readonly payments: readonly ["native", "stripe", "custom"];
2118
- readonly email: readonly ["native", "smtp", "custom"];
2119
- readonly reviews: readonly ["native", "custom"];
2120
- readonly search: readonly ["native", "custom"];
2121
- readonly analytics: readonly ["native", "custom"];
2122
- readonly shipping: readonly ["native", "custom"];
2123
- readonly tax: readonly ["native", "custom"];
2124
- readonly ai: readonly ["none", "anthropic", "custom"];
2125
- };
601
+ declare const KNOWN_PROVIDERS: Readonly<Record<CommerceSlot, readonly string[]>>;
2126
602
 
2127
603
  /**
2128
- * The values each infrastructure slot accepts: only what is built. `in-memory`, `in-process` and `local-fs` are the
2129
- * kernel's own; `redis`, `postgres-jsonb`, `redis-streams` and `s3` live in `@nymbalhq/*` packages the kernel loads
2130
- * only when the config names them.
604
+ * What a slot's provider may be called: lower-case letters, digits and hyphens, starting with a letter or digit. The
605
+ * bound keeps every convention name within npm's 214 characters.
606
+ */
607
+ declare const PROVIDER_NAME: RegExp;
608
+ /** A slot as its package names and folders spell it: `documentStore` is `document-store`. */
609
+ declare function slotFolder(slot: Slot): string;
610
+ /** The package a provider lives in when the config names no `package`: `@nymbalhq/<slot folder>-<provider>`. */
611
+ declare function conventionPackage(slot: Slot, provider: string): string;
612
+ interface CatalogueEntry {
613
+ /** The kernel's own provider, which no package holds. */
614
+ builtIn?: true;
615
+ /** The SDK the provider's package peers, which the project installs beside it. */
616
+ sdk?: string;
617
+ }
618
+ /**
619
+ * The providers Nymbal ships, by slot: the kernel's built-ins and the first-party packages, each with the SDK it peers.
620
+ * It never decides what loads; it gives install lines, suggestions for a mistyped provider and `nymbal add`'s list.
621
+ */
622
+ declare const ADAPTER_CATALOGUE: Readonly<Record<Slot, Readonly<Record<string, CatalogueEntry>>>>;
623
+ /** Each slot's built-in providers: the kernel's own adapter is used, and nothing is imported. */
624
+ declare const BUILT_IN: Readonly<Record<Slot, readonly string[]>>;
625
+ /**
626
+ * The catalogue name `name` was most likely meant to be, among the slot's catalogue names and, on a commerce slot,
627
+ * `custom`: the nearest within two edits, the alphabetically first on a tie; none when nothing is that near.
2131
628
  */
2132
- declare const KNOWN_INFRASTRUCTURE: {
2133
- readonly commandStore: readonly ["sqlite", "postgres"];
2134
- readonly documentStore: readonly ["in-memory", "redis", "postgres-jsonb"];
2135
- readonly eventBus: readonly ["in-process", "redis-streams"];
2136
- readonly media: readonly ["local-fs", "s3"];
2137
- };
2138
- type InfrastructureSlot = keyof typeof KNOWN_INFRASTRUCTURE;
629
+ declare function suggestProvider(slot: Slot, name: string): string | undefined;
630
+
631
+ /** The command store's dialects: a kernel dialect, not an adapter slot, so it stays a closed list. */
632
+ declare const COMMAND_STORES: readonly ["sqlite", "postgres"];
633
+ /** The infrastructure slots: the command store, and the three that take an adapter block. */
634
+ type InfrastructureSlot = 'commandStore' | 'documentStore' | 'eventBus' | 'media';
2139
635
  /** Keys that drove nothing and were removed; a config that still sets one is told to delete it. */
2140
636
  declare const REMOVED_INFRASTRUCTURE_KEYS: readonly ["cloud", "compute"];
2141
637
 
@@ -2149,5 +645,42 @@ interface LoadedConfig {
2149
645
  declare function findConfigFile(startDir: string): string | null;
2150
646
  declare function loadConfig(startDir?: string): Promise<LoadedConfig>;
2151
647
 
2152
- export { DEFAULT_JWT_SECRET, KNOWN_INFRASTRUCTURE, KNOWN_PROVIDERS, REMOVED_INFRASTRUCTURE_KEYS, commerceSchema, defineConfig, deploymentSchema, env, envBool, envNumber, envOptional, eventArchiveSchema, eventsSchema, featuresSchema, findConfigFile, httpSchema, infrastructureSchema, loadConfig, nymbalConfigSchema, redisSchema, s3Schema, securitySchema, storeSchema };
2153
- export type { InfrastructureSlot, LoadedConfig, NymbalConfig, NymbalConfigInput };
648
+ declare const PUBLIC_URL_ENV = "NYMBAL_PUBLIC_URL";
649
+ /**
650
+ * Whether the cookies the API sets carry `Secure`: exactly when the store's public origin is https, that origin being
651
+ * NYMBAL_PUBLIC_URL when set, else `store.url`. With neither, production's. NODE_ENV alone is not enough: a staging
652
+ * store served over https would send its session cookies over http too.
653
+ */
654
+ declare function secureCookies(config: Pick<NymbalConfig, 'store'>, env: Record<string, string | undefined>): boolean;
655
+
656
+ declare const ORIGIN_SECRET_ENV = "NYMBAL_ORIGIN_SECRET";
657
+ /**
658
+ * The origin lock from `NYMBAL_ORIGIN_SECRET`: one secret, or several separated by commas while one is rotated out.
659
+ * Blank entries are dropped and a blank variable is unset. A refusal names the entry's position, never its text, since
660
+ * the message reaches logs and terminals.
661
+ */
662
+ declare function resolveOriginLock(config: NymbalConfig, env: NodeJS.ProcessEnv): ResolvedOriginLock | undefined;
663
+
664
+ declare const TRUSTED_PROXIES_ENV = "NYMBAL_TRUSTED_PROXIES";
665
+ declare const CLIENT_IP_HEADER_ENV = "NYMBAL_CLIENT_IP_HEADER";
666
+ /**
667
+ * What is wrong with one trusted-proxy entry, by proxy-addr's own reading of it (the reading Fastify applies when it is
668
+ * built): `everyone` for a prefix of 0 or an IPv4-mapped range of /96 or wider (at /96 proxy-addr matches every IPv4
669
+ * peer against it), `invalid` for anything else it refuses, `null` when it compiles.
670
+ */
671
+ declare function trustedProxyProblem(entry: string): 'invalid' | 'everyone' | null;
672
+ /**
673
+ * The proxies whose forwarded client address the API believes, and the one client-address header it reads from them.
674
+ * Each resolves on its own: its variable, else its config key, else the security adapter's contribution, else the
675
+ * default (`loopback`; no header). Every value is checked as Fastify will read it, so a list this returns cannot fail the
676
+ * server's construction; trusting every address is refused, as is the removed hop count.
677
+ */
678
+ declare function resolveTrustedProxies(config: NymbalConfig, env: NodeJS.ProcessEnv, contribution?: {
679
+ adapter: string;
680
+ network: SecurityNetwork;
681
+ }): ResolvedNetwork;
682
+ /** The preset that holds `address` (an IPv4-mapped address by its IPv4 form), else the address itself. */
683
+ declare function trustSuggestion(address: string): string;
684
+
685
+ export { ACP_KEY_MIN_LENGTH, ACP_LINK_TYPES, ADAPTER_CATALOGUE, BUILT_IN, CLIENT_IP_HEADER_ENV, COMMAND_STORES, DEFAULT_AGENT_CRAWLERS, DEFAULT_JWT_SECRET, KNOWN_PROVIDERS, ORIGIN_SECRET_ENV, PROVIDER_NAME, PUBLIC_URL_ENV, REMOVED_INFRASTRUCTURE_KEYS, TRUSTED_PROXIES_ENV, agentsSchema, commerceSchema, conventionPackage, defineConfig, deploymentSchema, env, envBool, envNumber, envOptional, eventArchiveSchema, eventsSchema, featuresSchema, findConfigFile, httpSchema, infrastructureSchema, loadConfig, nymbalConfigSchema, redisSchema, resolveOriginLock, resolveTrustedProxies, s3Schema, secureCookies, securitySchema, slotFolder, storeSchema, suggestProvider, trustSuggestion, trustedProxyProblem };
686
+ export type { CatalogueEntry, InfrastructureSlot, LoadedConfig, NymbalConfig, NymbalConfigInput };