@nymbalhq/config 1.4.0 → 1.5.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 } 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. */
@@ -50,8 +50,8 @@ declare const redisSchema: z.ZodObject<{
50
50
  streamMaxLen?: number | undefined;
51
51
  }>;
52
52
  /**
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.
53
+ * The bucket `media: { provider: 's3' }` stores in. Each field falls back to the environment in the platform;
54
+ * credentials are never config keys: the AWS SDK's default chain provides them.
55
55
  */
56
56
  declare const s3Schema: z.ZodObject<{
57
57
  /** Defaults to `S3_BUCKET`; one of the two is required. */
@@ -83,9 +83,75 @@ declare const s3Schema: z.ZodObject<{
83
83
  }>;
84
84
  declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
85
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"]>>;
86
+ documentStore: z.ZodEffects<z.ZodObject<{
87
+ provider: z.ZodEffects<z.ZodString, string, string>;
88
+ /** The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. */
89
+ package: z.ZodOptional<z.ZodString>;
90
+ /** The adapter's `ctx.config`, for a provider whose connection the kernel does not build. */
91
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
92
+ }, "strip", z.ZodTypeAny, {
93
+ provider: string;
94
+ package?: string | undefined;
95
+ config?: Record<string, unknown> | undefined;
96
+ }, {
97
+ provider: string;
98
+ package?: string | undefined;
99
+ config?: Record<string, unknown> | undefined;
100
+ }>, {
101
+ provider: string;
102
+ package?: string | undefined;
103
+ config?: Record<string, unknown> | undefined;
104
+ }, {
105
+ provider: string;
106
+ package?: string | undefined;
107
+ config?: Record<string, unknown> | undefined;
108
+ }>;
109
+ eventBus: z.ZodEffects<z.ZodObject<{
110
+ provider: z.ZodEffects<z.ZodString, string, string>;
111
+ /** The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. */
112
+ package: z.ZodOptional<z.ZodString>;
113
+ /** The adapter's `ctx.config`, for a provider whose connection the kernel does not build. */
114
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
115
+ }, "strip", z.ZodTypeAny, {
116
+ provider: string;
117
+ package?: string | undefined;
118
+ config?: Record<string, unknown> | undefined;
119
+ }, {
120
+ provider: string;
121
+ package?: string | undefined;
122
+ config?: Record<string, unknown> | undefined;
123
+ }>, {
124
+ provider: string;
125
+ package?: string | undefined;
126
+ config?: Record<string, unknown> | undefined;
127
+ }, {
128
+ provider: string;
129
+ package?: string | undefined;
130
+ config?: Record<string, unknown> | undefined;
131
+ }>;
132
+ media: z.ZodDefault<z.ZodEffects<z.ZodObject<{
133
+ provider: z.ZodEffects<z.ZodString, string, string>;
134
+ /** The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. */
135
+ package: z.ZodOptional<z.ZodString>;
136
+ /** The adapter's `ctx.config`, for a provider whose connection the kernel does not build. */
137
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
138
+ }, "strip", z.ZodTypeAny, {
139
+ provider: string;
140
+ package?: string | undefined;
141
+ config?: Record<string, unknown> | undefined;
142
+ }, {
143
+ provider: string;
144
+ package?: string | undefined;
145
+ config?: Record<string, unknown> | undefined;
146
+ }>, {
147
+ provider: string;
148
+ package?: string | undefined;
149
+ config?: Record<string, unknown> | undefined;
150
+ }, {
151
+ provider: string;
152
+ package?: string | undefined;
153
+ config?: Record<string, unknown> | undefined;
154
+ }>>;
89
155
  redis: z.ZodOptional<z.ZodObject<{
90
156
  /** Defaults to `REDIS_URL`. */
91
157
  url: z.ZodOptional<z.ZodString>;
@@ -139,10 +205,22 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
139
205
  forcePathStyle?: boolean | undefined;
140
206
  }>>;
141
207
  }, "strict", z.ZodTypeAny, {
208
+ documentStore: {
209
+ provider: string;
210
+ package?: string | undefined;
211
+ config?: Record<string, unknown> | undefined;
212
+ };
213
+ eventBus: {
214
+ provider: string;
215
+ package?: string | undefined;
216
+ config?: Record<string, unknown> | undefined;
217
+ };
218
+ media: {
219
+ provider: string;
220
+ package?: string | undefined;
221
+ config?: Record<string, unknown> | undefined;
222
+ };
142
223
  commandStore: "sqlite" | "postgres";
143
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
144
- eventBus: "in-process" | "redis-streams";
145
- media: "local-fs" | "s3";
146
224
  redis?: {
147
225
  url?: string | undefined;
148
226
  prefix?: string | undefined;
@@ -159,9 +237,22 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
159
237
  forcePathStyle?: boolean | undefined;
160
238
  } | undefined;
161
239
  }, {
240
+ documentStore: {
241
+ provider: string;
242
+ package?: string | undefined;
243
+ config?: Record<string, unknown> | undefined;
244
+ };
245
+ eventBus: {
246
+ provider: string;
247
+ package?: string | undefined;
248
+ config?: Record<string, unknown> | undefined;
249
+ };
162
250
  commandStore: "sqlite" | "postgres";
163
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
164
- eventBus: "in-process" | "redis-streams";
251
+ media?: {
252
+ provider: string;
253
+ package?: string | undefined;
254
+ config?: Record<string, unknown> | undefined;
255
+ } | undefined;
165
256
  redis?: {
166
257
  url?: string | undefined;
167
258
  prefix?: string | undefined;
@@ -169,7 +260,6 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
169
260
  claimIdleMs?: number | undefined;
170
261
  streamMaxLen?: number | undefined;
171
262
  } | undefined;
172
- media?: "local-fs" | "s3" | undefined;
173
263
  s3?: {
174
264
  prefix?: string | undefined;
175
265
  bucket?: string | undefined;
@@ -179,10 +269,22 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
179
269
  forcePathStyle?: boolean | undefined;
180
270
  } | undefined;
181
271
  }>, {
272
+ documentStore: {
273
+ provider: string;
274
+ package?: string | undefined;
275
+ config?: Record<string, unknown> | undefined;
276
+ };
277
+ eventBus: {
278
+ provider: string;
279
+ package?: string | undefined;
280
+ config?: Record<string, unknown> | undefined;
281
+ };
282
+ media: {
283
+ provider: string;
284
+ package?: string | undefined;
285
+ config?: Record<string, unknown> | undefined;
286
+ };
182
287
  commandStore: "sqlite" | "postgres";
183
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
184
- eventBus: "in-process" | "redis-streams";
185
- media: "local-fs" | "s3";
186
288
  redis?: {
187
289
  url?: string | undefined;
188
290
  prefix?: string | undefined;
@@ -199,9 +301,22 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
199
301
  forcePathStyle?: boolean | undefined;
200
302
  } | undefined;
201
303
  }, {
304
+ documentStore: {
305
+ provider: string;
306
+ package?: string | undefined;
307
+ config?: Record<string, unknown> | undefined;
308
+ };
309
+ eventBus: {
310
+ provider: string;
311
+ package?: string | undefined;
312
+ config?: Record<string, unknown> | undefined;
313
+ };
202
314
  commandStore: "sqlite" | "postgres";
203
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
204
- eventBus: "in-process" | "redis-streams";
315
+ media?: {
316
+ provider: string;
317
+ package?: string | undefined;
318
+ config?: Record<string, unknown> | undefined;
319
+ } | undefined;
205
320
  redis?: {
206
321
  url?: string | undefined;
207
322
  prefix?: string | undefined;
@@ -209,7 +324,6 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
209
324
  claimIdleMs?: number | undefined;
210
325
  streamMaxLen?: number | undefined;
211
326
  } | undefined;
212
- media?: "local-fs" | "s3" | undefined;
213
327
  s3?: {
214
328
  prefix?: string | undefined;
215
329
  bucket?: string | undefined;
@@ -220,19 +334,28 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
220
334
  } | undefined;
221
335
  }>;
222
336
  declare const securitySchema: z.ZodEffects<z.ZodObject<{
223
- adapter: z.ZodEnum<["middleware", "cloudflare", "aws-waf", "akamai"]>;
337
+ /** `middleware` is the kernel's own; any other resolves as a commerce provider does, `security-<adapter>`. */
338
+ adapter: z.ZodEffects<z.ZodString, string, string>;
339
+ /** The npm package the adapter comes from, in place of `@nymbalhq/security-<adapter>`. */
340
+ package: z.ZodOptional<z.ZodString>;
341
+ /** A third-party adapter's `ctx.config`; `cloudflare` reads `security.cloudflare`, and `middleware` takes none. */
342
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
224
343
  rateLimit: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
225
344
  requests: z.ZodNumber;
226
345
  window: z.ZodString;
227
346
  action: z.ZodEnum<["block", "challenge", "throttle"]>;
347
+ /** Counts only the requests to the path that carry this header, such as `x-nymbal-order-email`. */
348
+ header: z.ZodOptional<z.ZodString>;
228
349
  }, "strip", z.ZodTypeAny, {
229
350
  requests: number;
230
351
  window: string;
231
352
  action: "block" | "challenge" | "throttle";
353
+ header?: string | undefined;
232
354
  }, {
233
355
  requests: number;
234
356
  window: string;
235
357
  action: "block" | "challenge" | "throttle";
358
+ header?: string | undefined;
236
359
  }>>>;
237
360
  botProtection: z.ZodDefault<z.ZodObject<{
238
361
  mode: z.ZodDefault<z.ZodEnum<["off", "managed", "strict"]>>;
@@ -310,11 +433,12 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
310
433
  }>, "many">>;
311
434
  managedRulesets: z.ZodDefault<z.ZodArray<z.ZodEnum<["cloudflare", "owasp"]>, "many">>;
312
435
  }, "strip", z.ZodTypeAny, {
313
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
436
+ adapter: string;
314
437
  rateLimit: Record<string, {
315
438
  requests: number;
316
439
  window: string;
317
440
  action: "block" | "challenge" | "throttle";
441
+ header?: string | undefined;
318
442
  }>;
319
443
  botProtection: {
320
444
  mode: "strict" | "off" | "managed";
@@ -341,22 +465,22 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
341
465
  expression: string;
342
466
  }[];
343
467
  managedRulesets: ("cloudflare" | "owasp")[];
468
+ package?: string | undefined;
469
+ config?: Record<string, unknown> | undefined;
344
470
  cloudflare?: {
345
471
  zoneId?: string | undefined;
346
472
  apiToken?: string | undefined;
347
473
  apiBase?: string | undefined;
348
474
  } | undefined;
349
475
  }, {
350
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
351
- cloudflare?: {
352
- zoneId?: string | undefined;
353
- apiToken?: string | undefined;
354
- apiBase?: string | undefined;
355
- } | undefined;
476
+ adapter: string;
477
+ package?: string | undefined;
478
+ config?: Record<string, unknown> | undefined;
356
479
  rateLimit?: Record<string, {
357
480
  requests: number;
358
481
  window: string;
359
482
  action: "block" | "challenge" | "throttle";
483
+ header?: string | undefined;
360
484
  }> | undefined;
361
485
  botProtection?: {
362
486
  mode?: "strict" | "off" | "managed" | undefined;
@@ -374,6 +498,11 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
374
498
  accessTtl?: string | undefined;
375
499
  refreshTtl?: string | undefined;
376
500
  } | undefined;
501
+ cloudflare?: {
502
+ zoneId?: string | undefined;
503
+ apiToken?: string | undefined;
504
+ apiBase?: string | undefined;
505
+ } | undefined;
377
506
  geo?: {
378
507
  block?: string[] | undefined;
379
508
  } | undefined;
@@ -384,11 +513,12 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
384
513
  }[] | undefined;
385
514
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
386
515
  }>, {
387
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
516
+ adapter: string;
388
517
  rateLimit: Record<string, {
389
518
  requests: number;
390
519
  window: string;
391
520
  action: "block" | "challenge" | "throttle";
521
+ header?: string | undefined;
392
522
  }>;
393
523
  botProtection: {
394
524
  mode: "strict" | "off" | "managed";
@@ -415,22 +545,22 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
415
545
  expression: string;
416
546
  }[];
417
547
  managedRulesets: ("cloudflare" | "owasp")[];
548
+ package?: string | undefined;
549
+ config?: Record<string, unknown> | undefined;
418
550
  cloudflare?: {
419
551
  zoneId?: string | undefined;
420
552
  apiToken?: string | undefined;
421
553
  apiBase?: string | undefined;
422
554
  } | undefined;
423
555
  }, {
424
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
425
- cloudflare?: {
426
- zoneId?: string | undefined;
427
- apiToken?: string | undefined;
428
- apiBase?: string | undefined;
429
- } | undefined;
556
+ adapter: string;
557
+ package?: string | undefined;
558
+ config?: Record<string, unknown> | undefined;
430
559
  rateLimit?: Record<string, {
431
560
  requests: number;
432
561
  window: string;
433
562
  action: "block" | "challenge" | "throttle";
563
+ header?: string | undefined;
434
564
  }> | undefined;
435
565
  botProtection?: {
436
566
  mode?: "strict" | "off" | "managed" | undefined;
@@ -448,6 +578,11 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
448
578
  accessTtl?: string | undefined;
449
579
  refreshTtl?: string | undefined;
450
580
  } | undefined;
581
+ cloudflare?: {
582
+ zoneId?: string | undefined;
583
+ apiToken?: string | undefined;
584
+ apiBase?: string | undefined;
585
+ } | undefined;
451
586
  geo?: {
452
587
  block?: string[] | undefined;
453
588
  } | undefined;
@@ -459,225 +594,345 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
459
594
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
460
595
  }>;
461
596
  declare const commerceSchema: z.ZodObject<{
462
- payments: z.ZodObject<{
463
- provider: z.ZodEnum<["native", "stripe", "custom"]>;
597
+ payments: z.ZodEffects<z.ZodObject<{
598
+ provider: z.ZodEffects<z.ZodString, string, string>;
464
599
  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. */
600
+ /**
601
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
602
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
603
+ */
466
604
  package: z.ZodOptional<z.ZodString>;
467
605
  }, "strip", z.ZodTypeAny, {
468
- provider: "native" | "stripe" | "custom";
469
- config?: Record<string, unknown> | undefined;
606
+ provider: string;
470
607
  package?: string | undefined;
608
+ config?: Record<string, unknown> | undefined;
471
609
  }, {
472
- provider: "native" | "stripe" | "custom";
610
+ provider: string;
611
+ package?: string | undefined;
473
612
  config?: Record<string, unknown> | undefined;
613
+ }>, {
614
+ provider: string;
615
+ package?: string | undefined;
616
+ config?: Record<string, unknown> | undefined;
617
+ }, {
618
+ provider: string;
474
619
  package?: string | undefined;
620
+ config?: Record<string, unknown> | undefined;
475
621
  }>;
476
- email: z.ZodObject<{
477
- provider: z.ZodEnum<["native", "smtp", "custom"]>;
622
+ email: z.ZodEffects<z.ZodObject<{
623
+ provider: z.ZodEffects<z.ZodString, string, string>;
478
624
  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. */
625
+ /**
626
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
627
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
628
+ */
480
629
  package: z.ZodOptional<z.ZodString>;
481
630
  }, "strip", z.ZodTypeAny, {
482
- provider: "native" | "custom" | "smtp";
483
- config?: Record<string, unknown> | undefined;
631
+ provider: string;
484
632
  package?: string | undefined;
633
+ config?: Record<string, unknown> | undefined;
485
634
  }, {
486
- provider: "native" | "custom" | "smtp";
635
+ provider: string;
636
+ package?: string | undefined;
487
637
  config?: Record<string, unknown> | undefined;
638
+ }>, {
639
+ provider: string;
640
+ package?: string | undefined;
641
+ config?: Record<string, unknown> | undefined;
642
+ }, {
643
+ provider: string;
488
644
  package?: string | undefined;
645
+ config?: Record<string, unknown> | undefined;
489
646
  }>;
490
- reviews: z.ZodObject<{
491
- provider: z.ZodEnum<["native", "custom"]>;
647
+ reviews: z.ZodEffects<z.ZodObject<{
648
+ provider: z.ZodEffects<z.ZodString, string, string>;
492
649
  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. */
650
+ /**
651
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
652
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
653
+ */
494
654
  package: z.ZodOptional<z.ZodString>;
495
655
  }, "strip", z.ZodTypeAny, {
496
- provider: "native" | "custom";
497
- config?: Record<string, unknown> | undefined;
656
+ provider: string;
498
657
  package?: string | undefined;
658
+ config?: Record<string, unknown> | undefined;
499
659
  }, {
500
- provider: "native" | "custom";
660
+ provider: string;
661
+ package?: string | undefined;
501
662
  config?: Record<string, unknown> | undefined;
663
+ }>, {
664
+ provider: string;
665
+ package?: string | undefined;
666
+ config?: Record<string, unknown> | undefined;
667
+ }, {
668
+ provider: string;
502
669
  package?: string | undefined;
670
+ config?: Record<string, unknown> | undefined;
503
671
  }>;
504
- search: z.ZodObject<{
505
- provider: z.ZodEnum<["native", "custom"]>;
672
+ search: z.ZodEffects<z.ZodObject<{
673
+ provider: z.ZodEffects<z.ZodString, string, string>;
506
674
  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. */
675
+ /**
676
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
677
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
678
+ */
508
679
  package: z.ZodOptional<z.ZodString>;
509
680
  }, "strip", z.ZodTypeAny, {
510
- provider: "native" | "custom";
511
- config?: Record<string, unknown> | undefined;
681
+ provider: string;
512
682
  package?: string | undefined;
683
+ config?: Record<string, unknown> | undefined;
513
684
  }, {
514
- provider: "native" | "custom";
685
+ provider: string;
686
+ package?: string | undefined;
515
687
  config?: Record<string, unknown> | undefined;
688
+ }>, {
689
+ provider: string;
690
+ package?: string | undefined;
691
+ config?: Record<string, unknown> | undefined;
692
+ }, {
693
+ provider: string;
516
694
  package?: string | undefined;
695
+ config?: Record<string, unknown> | undefined;
517
696
  }>;
518
- analytics: z.ZodObject<{
519
- provider: z.ZodEnum<["native", "custom"]>;
697
+ analytics: z.ZodEffects<z.ZodObject<{
698
+ provider: z.ZodEffects<z.ZodString, string, string>;
520
699
  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. */
700
+ /**
701
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
702
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
703
+ */
522
704
  package: z.ZodOptional<z.ZodString>;
523
705
  }, "strip", z.ZodTypeAny, {
524
- provider: "native" | "custom";
525
- config?: Record<string, unknown> | undefined;
706
+ provider: string;
526
707
  package?: string | undefined;
708
+ config?: Record<string, unknown> | undefined;
527
709
  }, {
528
- provider: "native" | "custom";
710
+ provider: string;
711
+ package?: string | undefined;
529
712
  config?: Record<string, unknown> | undefined;
713
+ }>, {
714
+ provider: string;
715
+ package?: string | undefined;
716
+ config?: Record<string, unknown> | undefined;
717
+ }, {
718
+ provider: string;
530
719
  package?: string | undefined;
720
+ config?: Record<string, unknown> | undefined;
531
721
  }>;
532
- shipping: z.ZodObject<{
533
- provider: z.ZodEnum<["native", "custom"]>;
722
+ shipping: z.ZodEffects<z.ZodObject<{
723
+ provider: z.ZodEffects<z.ZodString, string, string>;
534
724
  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. */
725
+ /**
726
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
727
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
728
+ */
536
729
  package: z.ZodOptional<z.ZodString>;
537
730
  }, "strip", z.ZodTypeAny, {
538
- provider: "native" | "custom";
539
- config?: Record<string, unknown> | undefined;
731
+ provider: string;
540
732
  package?: string | undefined;
733
+ config?: Record<string, unknown> | undefined;
541
734
  }, {
542
- provider: "native" | "custom";
735
+ provider: string;
736
+ package?: string | undefined;
543
737
  config?: Record<string, unknown> | undefined;
738
+ }>, {
739
+ provider: string;
740
+ package?: string | undefined;
741
+ config?: Record<string, unknown> | undefined;
742
+ }, {
743
+ provider: string;
544
744
  package?: string | undefined;
745
+ config?: Record<string, unknown> | undefined;
545
746
  }>;
546
- tax: z.ZodObject<{
547
- provider: z.ZodEnum<["native", "custom"]>;
747
+ tax: z.ZodEffects<z.ZodObject<{
748
+ provider: z.ZodEffects<z.ZodString, string, string>;
548
749
  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. */
750
+ /**
751
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
752
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
753
+ */
550
754
  package: z.ZodOptional<z.ZodString>;
551
755
  }, "strip", z.ZodTypeAny, {
552
- provider: "native" | "custom";
553
- config?: Record<string, unknown> | undefined;
756
+ provider: string;
554
757
  package?: string | undefined;
758
+ config?: Record<string, unknown> | undefined;
555
759
  }, {
556
- provider: "native" | "custom";
760
+ provider: string;
761
+ package?: string | undefined;
557
762
  config?: Record<string, unknown> | undefined;
763
+ }>, {
764
+ provider: string;
765
+ package?: string | undefined;
766
+ config?: Record<string, unknown> | undefined;
767
+ }, {
768
+ provider: string;
558
769
  package?: string | undefined;
770
+ config?: Record<string, unknown> | undefined;
559
771
  }>;
560
- ai: z.ZodObject<{
561
- provider: z.ZodEnum<["none", "anthropic", "custom"]>;
772
+ ai: z.ZodEffects<z.ZodObject<{
773
+ provider: z.ZodEffects<z.ZodString, string, string>;
562
774
  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. */
775
+ /**
776
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
777
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
778
+ */
564
779
  package: z.ZodOptional<z.ZodString>;
565
780
  }, "strip", z.ZodTypeAny, {
566
- provider: "custom" | "none" | "anthropic";
567
- config?: Record<string, unknown> | undefined;
781
+ provider: string;
568
782
  package?: string | undefined;
783
+ config?: Record<string, unknown> | undefined;
569
784
  }, {
570
- provider: "custom" | "none" | "anthropic";
785
+ provider: string;
786
+ package?: string | undefined;
571
787
  config?: Record<string, unknown> | undefined;
788
+ }>, {
789
+ provider: string;
790
+ package?: string | undefined;
791
+ config?: Record<string, unknown> | undefined;
792
+ }, {
793
+ provider: string;
572
794
  package?: string | undefined;
795
+ config?: Record<string, unknown> | undefined;
573
796
  }>;
574
797
  orders: z.ZodDefault<z.ZodObject<{
575
798
  numberPrefix: z.ZodDefault<z.ZodString>;
576
799
  numberStart: z.ZodDefault<z.ZodNumber>;
800
+ /** How long an order key opens the order on its own: the checkout's, and the order email's. */
801
+ keyLifetime: z.ZodDefault<z.ZodObject<{
802
+ checkout: z.ZodDefault<z.ZodString>;
803
+ email: z.ZodDefault<z.ZodString>;
804
+ }, "strip", z.ZodTypeAny, {
805
+ email: string;
806
+ checkout: string;
807
+ }, {
808
+ email?: string | undefined;
809
+ checkout?: string | undefined;
810
+ }>>;
577
811
  }, "strip", z.ZodTypeAny, {
578
812
  numberPrefix: string;
579
813
  numberStart: number;
814
+ keyLifetime: {
815
+ email: string;
816
+ checkout: string;
817
+ };
580
818
  }, {
581
819
  numberPrefix?: string | undefined;
582
820
  numberStart?: number | undefined;
821
+ keyLifetime?: {
822
+ email?: string | undefined;
823
+ checkout?: string | undefined;
824
+ } | undefined;
583
825
  }>>;
584
826
  }, "strip", z.ZodTypeAny, {
585
827
  payments: {
586
- provider: "native" | "stripe" | "custom";
587
- config?: Record<string, unknown> | undefined;
828
+ provider: string;
588
829
  package?: string | undefined;
830
+ config?: Record<string, unknown> | undefined;
589
831
  };
590
832
  email: {
591
- provider: "native" | "custom" | "smtp";
592
- config?: Record<string, unknown> | undefined;
833
+ provider: string;
593
834
  package?: string | undefined;
835
+ config?: Record<string, unknown> | undefined;
594
836
  };
595
837
  reviews: {
596
- provider: "native" | "custom";
597
- config?: Record<string, unknown> | undefined;
838
+ provider: string;
598
839
  package?: string | undefined;
840
+ config?: Record<string, unknown> | undefined;
599
841
  };
600
842
  search: {
601
- provider: "native" | "custom";
602
- config?: Record<string, unknown> | undefined;
843
+ provider: string;
603
844
  package?: string | undefined;
845
+ config?: Record<string, unknown> | undefined;
604
846
  };
605
847
  analytics: {
606
- provider: "native" | "custom";
607
- config?: Record<string, unknown> | undefined;
848
+ provider: string;
608
849
  package?: string | undefined;
850
+ config?: Record<string, unknown> | undefined;
609
851
  };
610
852
  shipping: {
611
- provider: "native" | "custom";
612
- config?: Record<string, unknown> | undefined;
853
+ provider: string;
613
854
  package?: string | undefined;
855
+ config?: Record<string, unknown> | undefined;
614
856
  };
615
857
  tax: {
616
- provider: "native" | "custom";
617
- config?: Record<string, unknown> | undefined;
858
+ provider: string;
618
859
  package?: string | undefined;
860
+ config?: Record<string, unknown> | undefined;
619
861
  };
620
862
  ai: {
621
- provider: "custom" | "none" | "anthropic";
622
- config?: Record<string, unknown> | undefined;
863
+ provider: string;
623
864
  package?: string | undefined;
865
+ config?: Record<string, unknown> | undefined;
624
866
  };
625
867
  orders: {
626
868
  numberPrefix: string;
627
869
  numberStart: number;
870
+ keyLifetime: {
871
+ email: string;
872
+ checkout: string;
873
+ };
628
874
  };
629
875
  }, {
630
876
  payments: {
631
- provider: "native" | "stripe" | "custom";
632
- config?: Record<string, unknown> | undefined;
877
+ provider: string;
633
878
  package?: string | undefined;
879
+ config?: Record<string, unknown> | undefined;
634
880
  };
635
881
  email: {
636
- provider: "native" | "custom" | "smtp";
637
- config?: Record<string, unknown> | undefined;
882
+ provider: string;
638
883
  package?: string | undefined;
884
+ config?: Record<string, unknown> | undefined;
639
885
  };
640
886
  reviews: {
641
- provider: "native" | "custom";
642
- config?: Record<string, unknown> | undefined;
887
+ provider: string;
643
888
  package?: string | undefined;
889
+ config?: Record<string, unknown> | undefined;
644
890
  };
645
891
  search: {
646
- provider: "native" | "custom";
647
- config?: Record<string, unknown> | undefined;
892
+ provider: string;
648
893
  package?: string | undefined;
894
+ config?: Record<string, unknown> | undefined;
649
895
  };
650
896
  analytics: {
651
- provider: "native" | "custom";
652
- config?: Record<string, unknown> | undefined;
897
+ provider: string;
653
898
  package?: string | undefined;
899
+ config?: Record<string, unknown> | undefined;
654
900
  };
655
901
  shipping: {
656
- provider: "native" | "custom";
657
- config?: Record<string, unknown> | undefined;
902
+ provider: string;
658
903
  package?: string | undefined;
904
+ config?: Record<string, unknown> | undefined;
659
905
  };
660
906
  tax: {
661
- provider: "native" | "custom";
662
- config?: Record<string, unknown> | undefined;
907
+ provider: string;
663
908
  package?: string | undefined;
909
+ config?: Record<string, unknown> | undefined;
664
910
  };
665
911
  ai: {
666
- provider: "custom" | "none" | "anthropic";
667
- config?: Record<string, unknown> | undefined;
912
+ provider: string;
668
913
  package?: string | undefined;
914
+ config?: Record<string, unknown> | undefined;
669
915
  };
670
916
  orders?: {
671
917
  numberPrefix?: string | undefined;
672
918
  numberStart?: number | undefined;
919
+ keyLifetime?: {
920
+ email?: string | undefined;
921
+ checkout?: string | undefined;
922
+ } | undefined;
673
923
  } | undefined;
674
924
  }>;
675
925
  declare const httpSchema: z.ZodObject<{
676
926
  adapter: z.ZodDefault<z.ZodEnum<["fastify", "hono"]>>;
677
927
  port: z.ZodDefault<z.ZodNumber>;
678
928
  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>;
929
+ /**
930
+ * Which `X-Forwarded-For` entries set the client IP the rate limiter keys on. A number trusts that many proxy hops
931
+ * nearest the server (`1` behind one platform proxy); `0` trusts none. `true` trusts every entry, so a client's own
932
+ * left-most value wins: spoofable unless your proxy overwrites the header. Left at `false` (explicitly or not),
933
+ * NYMBAL_TRUST_PROXY_HOPS fills it at run time.
934
+ */
935
+ trustProxy: z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
681
936
  cors: z.ZodDefault<z.ZodObject<{
682
937
  allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
683
938
  credentials: z.ZodDefault<z.ZodBoolean>;
@@ -692,7 +947,7 @@ declare const httpSchema: z.ZodObject<{
692
947
  adapter: "fastify" | "hono";
693
948
  port: number;
694
949
  host: string;
695
- trustProxy: boolean;
950
+ trustProxy: number | boolean;
696
951
  cors: {
697
952
  allowedOrigins: string[];
698
953
  credentials: boolean;
@@ -701,7 +956,7 @@ declare const httpSchema: z.ZodObject<{
701
956
  adapter?: "fastify" | "hono" | undefined;
702
957
  port?: number | undefined;
703
958
  host?: string | undefined;
704
- trustProxy?: boolean | undefined;
959
+ trustProxy?: number | boolean | undefined;
705
960
  cors?: {
706
961
  allowedOrigins?: string[] | undefined;
707
962
  credentials?: boolean | undefined;
@@ -832,9 +1087,75 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
832
1087
  template: z.ZodEnum<["astro", "nextjs"]>;
833
1088
  infrastructure: z.ZodEffects<z.ZodObject<{
834
1089
  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"]>>;
1090
+ documentStore: z.ZodEffects<z.ZodObject<{
1091
+ provider: z.ZodEffects<z.ZodString, string, string>;
1092
+ /** The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. */
1093
+ package: z.ZodOptional<z.ZodString>;
1094
+ /** The adapter's `ctx.config`, for a provider whose connection the kernel does not build. */
1095
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1096
+ }, "strip", z.ZodTypeAny, {
1097
+ provider: string;
1098
+ package?: string | undefined;
1099
+ config?: Record<string, unknown> | undefined;
1100
+ }, {
1101
+ provider: string;
1102
+ package?: string | undefined;
1103
+ config?: Record<string, unknown> | undefined;
1104
+ }>, {
1105
+ provider: string;
1106
+ package?: string | undefined;
1107
+ config?: Record<string, unknown> | undefined;
1108
+ }, {
1109
+ provider: string;
1110
+ package?: string | undefined;
1111
+ config?: Record<string, unknown> | undefined;
1112
+ }>;
1113
+ eventBus: z.ZodEffects<z.ZodObject<{
1114
+ provider: z.ZodEffects<z.ZodString, string, string>;
1115
+ /** The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. */
1116
+ package: z.ZodOptional<z.ZodString>;
1117
+ /** The adapter's `ctx.config`, for a provider whose connection the kernel does not build. */
1118
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1119
+ }, "strip", z.ZodTypeAny, {
1120
+ provider: string;
1121
+ package?: string | undefined;
1122
+ config?: Record<string, unknown> | undefined;
1123
+ }, {
1124
+ provider: string;
1125
+ package?: string | undefined;
1126
+ config?: Record<string, unknown> | undefined;
1127
+ }>, {
1128
+ provider: string;
1129
+ package?: string | undefined;
1130
+ config?: Record<string, unknown> | undefined;
1131
+ }, {
1132
+ provider: string;
1133
+ package?: string | undefined;
1134
+ config?: Record<string, unknown> | undefined;
1135
+ }>;
1136
+ media: z.ZodDefault<z.ZodEffects<z.ZodObject<{
1137
+ provider: z.ZodEffects<z.ZodString, string, string>;
1138
+ /** The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. */
1139
+ package: z.ZodOptional<z.ZodString>;
1140
+ /** The adapter's `ctx.config`, for a provider whose connection the kernel does not build. */
1141
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1142
+ }, "strip", z.ZodTypeAny, {
1143
+ provider: string;
1144
+ package?: string | undefined;
1145
+ config?: Record<string, unknown> | undefined;
1146
+ }, {
1147
+ provider: string;
1148
+ package?: string | undefined;
1149
+ config?: Record<string, unknown> | undefined;
1150
+ }>, {
1151
+ provider: string;
1152
+ package?: string | undefined;
1153
+ config?: Record<string, unknown> | undefined;
1154
+ }, {
1155
+ provider: string;
1156
+ package?: string | undefined;
1157
+ config?: Record<string, unknown> | undefined;
1158
+ }>>;
838
1159
  redis: z.ZodOptional<z.ZodObject<{
839
1160
  /** Defaults to `REDIS_URL`. */
840
1161
  url: z.ZodOptional<z.ZodString>;
@@ -888,10 +1209,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
888
1209
  forcePathStyle?: boolean | undefined;
889
1210
  }>>;
890
1211
  }, "strict", z.ZodTypeAny, {
1212
+ documentStore: {
1213
+ provider: string;
1214
+ package?: string | undefined;
1215
+ config?: Record<string, unknown> | undefined;
1216
+ };
1217
+ eventBus: {
1218
+ provider: string;
1219
+ package?: string | undefined;
1220
+ config?: Record<string, unknown> | undefined;
1221
+ };
1222
+ media: {
1223
+ provider: string;
1224
+ package?: string | undefined;
1225
+ config?: Record<string, unknown> | undefined;
1226
+ };
891
1227
  commandStore: "sqlite" | "postgres";
892
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
893
- eventBus: "in-process" | "redis-streams";
894
- media: "local-fs" | "s3";
895
1228
  redis?: {
896
1229
  url?: string | undefined;
897
1230
  prefix?: string | undefined;
@@ -908,9 +1241,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
908
1241
  forcePathStyle?: boolean | undefined;
909
1242
  } | undefined;
910
1243
  }, {
911
- commandStore: "sqlite" | "postgres";
912
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
913
- eventBus: "in-process" | "redis-streams";
1244
+ documentStore: {
1245
+ provider: string;
1246
+ package?: string | undefined;
1247
+ config?: Record<string, unknown> | undefined;
1248
+ };
1249
+ eventBus: {
1250
+ provider: string;
1251
+ package?: string | undefined;
1252
+ config?: Record<string, unknown> | undefined;
1253
+ };
1254
+ commandStore: "sqlite" | "postgres";
1255
+ media?: {
1256
+ provider: string;
1257
+ package?: string | undefined;
1258
+ config?: Record<string, unknown> | undefined;
1259
+ } | undefined;
914
1260
  redis?: {
915
1261
  url?: string | undefined;
916
1262
  prefix?: string | undefined;
@@ -918,7 +1264,6 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
918
1264
  claimIdleMs?: number | undefined;
919
1265
  streamMaxLen?: number | undefined;
920
1266
  } | undefined;
921
- media?: "local-fs" | "s3" | undefined;
922
1267
  s3?: {
923
1268
  prefix?: string | undefined;
924
1269
  bucket?: string | undefined;
@@ -928,10 +1273,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
928
1273
  forcePathStyle?: boolean | undefined;
929
1274
  } | undefined;
930
1275
  }>, {
1276
+ documentStore: {
1277
+ provider: string;
1278
+ package?: string | undefined;
1279
+ config?: Record<string, unknown> | undefined;
1280
+ };
1281
+ eventBus: {
1282
+ provider: string;
1283
+ package?: string | undefined;
1284
+ config?: Record<string, unknown> | undefined;
1285
+ };
1286
+ media: {
1287
+ provider: string;
1288
+ package?: string | undefined;
1289
+ config?: Record<string, unknown> | undefined;
1290
+ };
931
1291
  commandStore: "sqlite" | "postgres";
932
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
933
- eventBus: "in-process" | "redis-streams";
934
- media: "local-fs" | "s3";
935
1292
  redis?: {
936
1293
  url?: string | undefined;
937
1294
  prefix?: string | undefined;
@@ -948,9 +1305,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
948
1305
  forcePathStyle?: boolean | undefined;
949
1306
  } | undefined;
950
1307
  }, {
1308
+ documentStore: {
1309
+ provider: string;
1310
+ package?: string | undefined;
1311
+ config?: Record<string, unknown> | undefined;
1312
+ };
1313
+ eventBus: {
1314
+ provider: string;
1315
+ package?: string | undefined;
1316
+ config?: Record<string, unknown> | undefined;
1317
+ };
951
1318
  commandStore: "sqlite" | "postgres";
952
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
953
- eventBus: "in-process" | "redis-streams";
1319
+ media?: {
1320
+ provider: string;
1321
+ package?: string | undefined;
1322
+ config?: Record<string, unknown> | undefined;
1323
+ } | undefined;
954
1324
  redis?: {
955
1325
  url?: string | undefined;
956
1326
  prefix?: string | undefined;
@@ -958,7 +1328,6 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
958
1328
  claimIdleMs?: number | undefined;
959
1329
  streamMaxLen?: number | undefined;
960
1330
  } | undefined;
961
- media?: "local-fs" | "s3" | undefined;
962
1331
  s3?: {
963
1332
  prefix?: string | undefined;
964
1333
  bucket?: string | undefined;
@@ -969,19 +1338,28 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
969
1338
  } | undefined;
970
1339
  }>;
971
1340
  security: z.ZodEffects<z.ZodObject<{
972
- adapter: z.ZodEnum<["middleware", "cloudflare", "aws-waf", "akamai"]>;
1341
+ /** `middleware` is the kernel's own; any other resolves as a commerce provider does, `security-<adapter>`. */
1342
+ adapter: z.ZodEffects<z.ZodString, string, string>;
1343
+ /** The npm package the adapter comes from, in place of `@nymbalhq/security-<adapter>`. */
1344
+ package: z.ZodOptional<z.ZodString>;
1345
+ /** A third-party adapter's `ctx.config`; `cloudflare` reads `security.cloudflare`, and `middleware` takes none. */
1346
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
973
1347
  rateLimit: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
974
1348
  requests: z.ZodNumber;
975
1349
  window: z.ZodString;
976
1350
  action: z.ZodEnum<["block", "challenge", "throttle"]>;
1351
+ /** Counts only the requests to the path that carry this header, such as `x-nymbal-order-email`. */
1352
+ header: z.ZodOptional<z.ZodString>;
977
1353
  }, "strip", z.ZodTypeAny, {
978
1354
  requests: number;
979
1355
  window: string;
980
1356
  action: "block" | "challenge" | "throttle";
1357
+ header?: string | undefined;
981
1358
  }, {
982
1359
  requests: number;
983
1360
  window: string;
984
1361
  action: "block" | "challenge" | "throttle";
1362
+ header?: string | undefined;
985
1363
  }>>>;
986
1364
  botProtection: z.ZodDefault<z.ZodObject<{
987
1365
  mode: z.ZodDefault<z.ZodEnum<["off", "managed", "strict"]>>;
@@ -1059,11 +1437,12 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1059
1437
  }>, "many">>;
1060
1438
  managedRulesets: z.ZodDefault<z.ZodArray<z.ZodEnum<["cloudflare", "owasp"]>, "many">>;
1061
1439
  }, "strip", z.ZodTypeAny, {
1062
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1440
+ adapter: string;
1063
1441
  rateLimit: Record<string, {
1064
1442
  requests: number;
1065
1443
  window: string;
1066
1444
  action: "block" | "challenge" | "throttle";
1445
+ header?: string | undefined;
1067
1446
  }>;
1068
1447
  botProtection: {
1069
1448
  mode: "strict" | "off" | "managed";
@@ -1090,22 +1469,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1090
1469
  expression: string;
1091
1470
  }[];
1092
1471
  managedRulesets: ("cloudflare" | "owasp")[];
1472
+ package?: string | undefined;
1473
+ config?: Record<string, unknown> | undefined;
1093
1474
  cloudflare?: {
1094
1475
  zoneId?: string | undefined;
1095
1476
  apiToken?: string | undefined;
1096
1477
  apiBase?: string | undefined;
1097
1478
  } | undefined;
1098
1479
  }, {
1099
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1100
- cloudflare?: {
1101
- zoneId?: string | undefined;
1102
- apiToken?: string | undefined;
1103
- apiBase?: string | undefined;
1104
- } | undefined;
1480
+ adapter: string;
1481
+ package?: string | undefined;
1482
+ config?: Record<string, unknown> | undefined;
1105
1483
  rateLimit?: Record<string, {
1106
1484
  requests: number;
1107
1485
  window: string;
1108
1486
  action: "block" | "challenge" | "throttle";
1487
+ header?: string | undefined;
1109
1488
  }> | undefined;
1110
1489
  botProtection?: {
1111
1490
  mode?: "strict" | "off" | "managed" | undefined;
@@ -1123,6 +1502,11 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1123
1502
  accessTtl?: string | undefined;
1124
1503
  refreshTtl?: string | undefined;
1125
1504
  } | undefined;
1505
+ cloudflare?: {
1506
+ zoneId?: string | undefined;
1507
+ apiToken?: string | undefined;
1508
+ apiBase?: string | undefined;
1509
+ } | undefined;
1126
1510
  geo?: {
1127
1511
  block?: string[] | undefined;
1128
1512
  } | undefined;
@@ -1133,11 +1517,12 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1133
1517
  }[] | undefined;
1134
1518
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
1135
1519
  }>, {
1136
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1520
+ adapter: string;
1137
1521
  rateLimit: Record<string, {
1138
1522
  requests: number;
1139
1523
  window: string;
1140
1524
  action: "block" | "challenge" | "throttle";
1525
+ header?: string | undefined;
1141
1526
  }>;
1142
1527
  botProtection: {
1143
1528
  mode: "strict" | "off" | "managed";
@@ -1164,22 +1549,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1164
1549
  expression: string;
1165
1550
  }[];
1166
1551
  managedRulesets: ("cloudflare" | "owasp")[];
1552
+ package?: string | undefined;
1553
+ config?: Record<string, unknown> | undefined;
1167
1554
  cloudflare?: {
1168
1555
  zoneId?: string | undefined;
1169
1556
  apiToken?: string | undefined;
1170
1557
  apiBase?: string | undefined;
1171
1558
  } | undefined;
1172
1559
  }, {
1173
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1174
- cloudflare?: {
1175
- zoneId?: string | undefined;
1176
- apiToken?: string | undefined;
1177
- apiBase?: string | undefined;
1178
- } | undefined;
1560
+ adapter: string;
1561
+ package?: string | undefined;
1562
+ config?: Record<string, unknown> | undefined;
1179
1563
  rateLimit?: Record<string, {
1180
1564
  requests: number;
1181
1565
  window: string;
1182
1566
  action: "block" | "challenge" | "throttle";
1567
+ header?: string | undefined;
1183
1568
  }> | undefined;
1184
1569
  botProtection?: {
1185
1570
  mode?: "strict" | "off" | "managed" | undefined;
@@ -1197,6 +1582,11 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1197
1582
  accessTtl?: string | undefined;
1198
1583
  refreshTtl?: string | undefined;
1199
1584
  } | undefined;
1585
+ cloudflare?: {
1586
+ zoneId?: string | undefined;
1587
+ apiToken?: string | undefined;
1588
+ apiBase?: string | undefined;
1589
+ } | undefined;
1200
1590
  geo?: {
1201
1591
  block?: string[] | undefined;
1202
1592
  } | undefined;
@@ -1208,225 +1598,345 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1208
1598
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
1209
1599
  }>;
1210
1600
  commerce: z.ZodObject<{
1211
- payments: z.ZodObject<{
1212
- provider: z.ZodEnum<["native", "stripe", "custom"]>;
1601
+ payments: z.ZodEffects<z.ZodObject<{
1602
+ provider: z.ZodEffects<z.ZodString, string, string>;
1213
1603
  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. */
1604
+ /**
1605
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
1606
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
1607
+ */
1215
1608
  package: z.ZodOptional<z.ZodString>;
1216
1609
  }, "strip", z.ZodTypeAny, {
1217
- provider: "native" | "stripe" | "custom";
1218
- config?: Record<string, unknown> | undefined;
1610
+ provider: string;
1219
1611
  package?: string | undefined;
1612
+ config?: Record<string, unknown> | undefined;
1220
1613
  }, {
1221
- provider: "native" | "stripe" | "custom";
1614
+ provider: string;
1615
+ package?: string | undefined;
1222
1616
  config?: Record<string, unknown> | undefined;
1617
+ }>, {
1618
+ provider: string;
1223
1619
  package?: string | undefined;
1620
+ config?: Record<string, unknown> | undefined;
1621
+ }, {
1622
+ provider: string;
1623
+ package?: string | undefined;
1624
+ config?: Record<string, unknown> | undefined;
1224
1625
  }>;
1225
- email: z.ZodObject<{
1226
- provider: z.ZodEnum<["native", "smtp", "custom"]>;
1626
+ email: z.ZodEffects<z.ZodObject<{
1627
+ provider: z.ZodEffects<z.ZodString, string, string>;
1227
1628
  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. */
1629
+ /**
1630
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
1631
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
1632
+ */
1229
1633
  package: z.ZodOptional<z.ZodString>;
1230
1634
  }, "strip", z.ZodTypeAny, {
1231
- provider: "native" | "custom" | "smtp";
1232
- config?: Record<string, unknown> | undefined;
1635
+ provider: string;
1233
1636
  package?: string | undefined;
1637
+ config?: Record<string, unknown> | undefined;
1234
1638
  }, {
1235
- provider: "native" | "custom" | "smtp";
1639
+ provider: string;
1640
+ package?: string | undefined;
1641
+ config?: Record<string, unknown> | undefined;
1642
+ }>, {
1643
+ provider: string;
1644
+ package?: string | undefined;
1236
1645
  config?: Record<string, unknown> | undefined;
1646
+ }, {
1647
+ provider: string;
1237
1648
  package?: string | undefined;
1649
+ config?: Record<string, unknown> | undefined;
1238
1650
  }>;
1239
- reviews: z.ZodObject<{
1240
- provider: z.ZodEnum<["native", "custom"]>;
1651
+ reviews: z.ZodEffects<z.ZodObject<{
1652
+ provider: z.ZodEffects<z.ZodString, string, string>;
1241
1653
  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. */
1654
+ /**
1655
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
1656
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
1657
+ */
1243
1658
  package: z.ZodOptional<z.ZodString>;
1244
1659
  }, "strip", z.ZodTypeAny, {
1245
- provider: "native" | "custom";
1246
- config?: Record<string, unknown> | undefined;
1660
+ provider: string;
1247
1661
  package?: string | undefined;
1662
+ config?: Record<string, unknown> | undefined;
1248
1663
  }, {
1249
- provider: "native" | "custom";
1664
+ provider: string;
1665
+ package?: string | undefined;
1250
1666
  config?: Record<string, unknown> | undefined;
1667
+ }>, {
1668
+ provider: string;
1251
1669
  package?: string | undefined;
1670
+ config?: Record<string, unknown> | undefined;
1671
+ }, {
1672
+ provider: string;
1673
+ package?: string | undefined;
1674
+ config?: Record<string, unknown> | undefined;
1252
1675
  }>;
1253
- search: z.ZodObject<{
1254
- provider: z.ZodEnum<["native", "custom"]>;
1676
+ search: z.ZodEffects<z.ZodObject<{
1677
+ provider: z.ZodEffects<z.ZodString, string, string>;
1255
1678
  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. */
1679
+ /**
1680
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
1681
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
1682
+ */
1257
1683
  package: z.ZodOptional<z.ZodString>;
1258
1684
  }, "strip", z.ZodTypeAny, {
1259
- provider: "native" | "custom";
1260
- config?: Record<string, unknown> | undefined;
1685
+ provider: string;
1261
1686
  package?: string | undefined;
1687
+ config?: Record<string, unknown> | undefined;
1262
1688
  }, {
1263
- provider: "native" | "custom";
1689
+ provider: string;
1690
+ package?: string | undefined;
1691
+ config?: Record<string, unknown> | undefined;
1692
+ }>, {
1693
+ provider: string;
1694
+ package?: string | undefined;
1264
1695
  config?: Record<string, unknown> | undefined;
1696
+ }, {
1697
+ provider: string;
1265
1698
  package?: string | undefined;
1699
+ config?: Record<string, unknown> | undefined;
1266
1700
  }>;
1267
- analytics: z.ZodObject<{
1268
- provider: z.ZodEnum<["native", "custom"]>;
1701
+ analytics: z.ZodEffects<z.ZodObject<{
1702
+ provider: z.ZodEffects<z.ZodString, string, string>;
1269
1703
  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. */
1704
+ /**
1705
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
1706
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
1707
+ */
1271
1708
  package: z.ZodOptional<z.ZodString>;
1272
1709
  }, "strip", z.ZodTypeAny, {
1273
- provider: "native" | "custom";
1274
- config?: Record<string, unknown> | undefined;
1710
+ provider: string;
1275
1711
  package?: string | undefined;
1712
+ config?: Record<string, unknown> | undefined;
1276
1713
  }, {
1277
- provider: "native" | "custom";
1714
+ provider: string;
1715
+ package?: string | undefined;
1278
1716
  config?: Record<string, unknown> | undefined;
1717
+ }>, {
1718
+ provider: string;
1719
+ package?: string | undefined;
1720
+ config?: Record<string, unknown> | undefined;
1721
+ }, {
1722
+ provider: string;
1279
1723
  package?: string | undefined;
1724
+ config?: Record<string, unknown> | undefined;
1280
1725
  }>;
1281
- shipping: z.ZodObject<{
1282
- provider: z.ZodEnum<["native", "custom"]>;
1726
+ shipping: z.ZodEffects<z.ZodObject<{
1727
+ provider: z.ZodEffects<z.ZodString, string, string>;
1283
1728
  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. */
1729
+ /**
1730
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
1731
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
1732
+ */
1285
1733
  package: z.ZodOptional<z.ZodString>;
1286
1734
  }, "strip", z.ZodTypeAny, {
1287
- provider: "native" | "custom";
1288
- config?: Record<string, unknown> | undefined;
1735
+ provider: string;
1289
1736
  package?: string | undefined;
1737
+ config?: Record<string, unknown> | undefined;
1290
1738
  }, {
1291
- provider: "native" | "custom";
1739
+ provider: string;
1740
+ package?: string | undefined;
1292
1741
  config?: Record<string, unknown> | undefined;
1742
+ }>, {
1743
+ provider: string;
1293
1744
  package?: string | undefined;
1745
+ config?: Record<string, unknown> | undefined;
1746
+ }, {
1747
+ provider: string;
1748
+ package?: string | undefined;
1749
+ config?: Record<string, unknown> | undefined;
1294
1750
  }>;
1295
- tax: z.ZodObject<{
1296
- provider: z.ZodEnum<["native", "custom"]>;
1751
+ tax: z.ZodEffects<z.ZodObject<{
1752
+ provider: z.ZodEffects<z.ZodString, string, string>;
1297
1753
  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. */
1754
+ /**
1755
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
1756
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
1757
+ */
1299
1758
  package: z.ZodOptional<z.ZodString>;
1300
1759
  }, "strip", z.ZodTypeAny, {
1301
- provider: "native" | "custom";
1302
- config?: Record<string, unknown> | undefined;
1760
+ provider: string;
1303
1761
  package?: string | undefined;
1762
+ config?: Record<string, unknown> | undefined;
1304
1763
  }, {
1305
- provider: "native" | "custom";
1764
+ provider: string;
1765
+ package?: string | undefined;
1306
1766
  config?: Record<string, unknown> | undefined;
1767
+ }>, {
1768
+ provider: string;
1307
1769
  package?: string | undefined;
1770
+ config?: Record<string, unknown> | undefined;
1771
+ }, {
1772
+ provider: string;
1773
+ package?: string | undefined;
1774
+ config?: Record<string, unknown> | undefined;
1308
1775
  }>;
1309
- ai: z.ZodObject<{
1310
- provider: z.ZodEnum<["none", "anthropic", "custom"]>;
1776
+ ai: z.ZodEffects<z.ZodObject<{
1777
+ provider: z.ZodEffects<z.ZodString, string, string>;
1311
1778
  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. */
1779
+ /**
1780
+ * The npm package the adapter comes from, in place of `@nymbalhq/<slot>-<provider>`. On a `custom` slot it is for
1781
+ * tooling (`nymbal test:contracts`): the kernel takes the adapter passed to `createApp` and imports nothing.
1782
+ */
1313
1783
  package: z.ZodOptional<z.ZodString>;
1314
1784
  }, "strip", z.ZodTypeAny, {
1315
- provider: "custom" | "none" | "anthropic";
1316
- config?: Record<string, unknown> | undefined;
1785
+ provider: string;
1317
1786
  package?: string | undefined;
1787
+ config?: Record<string, unknown> | undefined;
1318
1788
  }, {
1319
- provider: "custom" | "none" | "anthropic";
1789
+ provider: string;
1790
+ package?: string | undefined;
1791
+ config?: Record<string, unknown> | undefined;
1792
+ }>, {
1793
+ provider: string;
1794
+ package?: string | undefined;
1320
1795
  config?: Record<string, unknown> | undefined;
1796
+ }, {
1797
+ provider: string;
1321
1798
  package?: string | undefined;
1799
+ config?: Record<string, unknown> | undefined;
1322
1800
  }>;
1323
1801
  orders: z.ZodDefault<z.ZodObject<{
1324
1802
  numberPrefix: z.ZodDefault<z.ZodString>;
1325
1803
  numberStart: z.ZodDefault<z.ZodNumber>;
1804
+ /** How long an order key opens the order on its own: the checkout's, and the order email's. */
1805
+ keyLifetime: z.ZodDefault<z.ZodObject<{
1806
+ checkout: z.ZodDefault<z.ZodString>;
1807
+ email: z.ZodDefault<z.ZodString>;
1808
+ }, "strip", z.ZodTypeAny, {
1809
+ email: string;
1810
+ checkout: string;
1811
+ }, {
1812
+ email?: string | undefined;
1813
+ checkout?: string | undefined;
1814
+ }>>;
1326
1815
  }, "strip", z.ZodTypeAny, {
1327
1816
  numberPrefix: string;
1328
1817
  numberStart: number;
1818
+ keyLifetime: {
1819
+ email: string;
1820
+ checkout: string;
1821
+ };
1329
1822
  }, {
1330
1823
  numberPrefix?: string | undefined;
1331
1824
  numberStart?: number | undefined;
1825
+ keyLifetime?: {
1826
+ email?: string | undefined;
1827
+ checkout?: string | undefined;
1828
+ } | undefined;
1332
1829
  }>>;
1333
1830
  }, "strip", z.ZodTypeAny, {
1334
1831
  payments: {
1335
- provider: "native" | "stripe" | "custom";
1336
- config?: Record<string, unknown> | undefined;
1832
+ provider: string;
1337
1833
  package?: string | undefined;
1834
+ config?: Record<string, unknown> | undefined;
1338
1835
  };
1339
1836
  email: {
1340
- provider: "native" | "custom" | "smtp";
1341
- config?: Record<string, unknown> | undefined;
1837
+ provider: string;
1342
1838
  package?: string | undefined;
1839
+ config?: Record<string, unknown> | undefined;
1343
1840
  };
1344
1841
  reviews: {
1345
- provider: "native" | "custom";
1346
- config?: Record<string, unknown> | undefined;
1842
+ provider: string;
1347
1843
  package?: string | undefined;
1844
+ config?: Record<string, unknown> | undefined;
1348
1845
  };
1349
1846
  search: {
1350
- provider: "native" | "custom";
1351
- config?: Record<string, unknown> | undefined;
1847
+ provider: string;
1352
1848
  package?: string | undefined;
1849
+ config?: Record<string, unknown> | undefined;
1353
1850
  };
1354
1851
  analytics: {
1355
- provider: "native" | "custom";
1356
- config?: Record<string, unknown> | undefined;
1852
+ provider: string;
1357
1853
  package?: string | undefined;
1854
+ config?: Record<string, unknown> | undefined;
1358
1855
  };
1359
1856
  shipping: {
1360
- provider: "native" | "custom";
1361
- config?: Record<string, unknown> | undefined;
1857
+ provider: string;
1362
1858
  package?: string | undefined;
1859
+ config?: Record<string, unknown> | undefined;
1363
1860
  };
1364
1861
  tax: {
1365
- provider: "native" | "custom";
1366
- config?: Record<string, unknown> | undefined;
1862
+ provider: string;
1367
1863
  package?: string | undefined;
1864
+ config?: Record<string, unknown> | undefined;
1368
1865
  };
1369
1866
  ai: {
1370
- provider: "custom" | "none" | "anthropic";
1371
- config?: Record<string, unknown> | undefined;
1867
+ provider: string;
1372
1868
  package?: string | undefined;
1869
+ config?: Record<string, unknown> | undefined;
1373
1870
  };
1374
1871
  orders: {
1375
1872
  numberPrefix: string;
1376
1873
  numberStart: number;
1874
+ keyLifetime: {
1875
+ email: string;
1876
+ checkout: string;
1877
+ };
1377
1878
  };
1378
1879
  }, {
1379
1880
  payments: {
1380
- provider: "native" | "stripe" | "custom";
1381
- config?: Record<string, unknown> | undefined;
1881
+ provider: string;
1382
1882
  package?: string | undefined;
1883
+ config?: Record<string, unknown> | undefined;
1383
1884
  };
1384
1885
  email: {
1385
- provider: "native" | "custom" | "smtp";
1386
- config?: Record<string, unknown> | undefined;
1886
+ provider: string;
1387
1887
  package?: string | undefined;
1888
+ config?: Record<string, unknown> | undefined;
1388
1889
  };
1389
1890
  reviews: {
1390
- provider: "native" | "custom";
1391
- config?: Record<string, unknown> | undefined;
1891
+ provider: string;
1392
1892
  package?: string | undefined;
1893
+ config?: Record<string, unknown> | undefined;
1393
1894
  };
1394
1895
  search: {
1395
- provider: "native" | "custom";
1396
- config?: Record<string, unknown> | undefined;
1896
+ provider: string;
1397
1897
  package?: string | undefined;
1898
+ config?: Record<string, unknown> | undefined;
1398
1899
  };
1399
1900
  analytics: {
1400
- provider: "native" | "custom";
1401
- config?: Record<string, unknown> | undefined;
1901
+ provider: string;
1402
1902
  package?: string | undefined;
1903
+ config?: Record<string, unknown> | undefined;
1403
1904
  };
1404
1905
  shipping: {
1405
- provider: "native" | "custom";
1406
- config?: Record<string, unknown> | undefined;
1906
+ provider: string;
1407
1907
  package?: string | undefined;
1908
+ config?: Record<string, unknown> | undefined;
1408
1909
  };
1409
1910
  tax: {
1410
- provider: "native" | "custom";
1411
- config?: Record<string, unknown> | undefined;
1911
+ provider: string;
1412
1912
  package?: string | undefined;
1913
+ config?: Record<string, unknown> | undefined;
1413
1914
  };
1414
1915
  ai: {
1415
- provider: "custom" | "none" | "anthropic";
1416
- config?: Record<string, unknown> | undefined;
1916
+ provider: string;
1417
1917
  package?: string | undefined;
1918
+ config?: Record<string, unknown> | undefined;
1418
1919
  };
1419
1920
  orders?: {
1420
1921
  numberPrefix?: string | undefined;
1421
1922
  numberStart?: number | undefined;
1923
+ keyLifetime?: {
1924
+ email?: string | undefined;
1925
+ checkout?: string | undefined;
1926
+ } | undefined;
1422
1927
  } | undefined;
1423
1928
  }>;
1424
1929
  http: z.ZodObject<{
1425
1930
  adapter: z.ZodDefault<z.ZodEnum<["fastify", "hono"]>>;
1426
1931
  port: z.ZodDefault<z.ZodNumber>;
1427
1932
  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>;
1933
+ /**
1934
+ * Which `X-Forwarded-For` entries set the client IP the rate limiter keys on. A number trusts that many proxy hops
1935
+ * nearest the server (`1` behind one platform proxy); `0` trusts none. `true` trusts every entry, so a client's own
1936
+ * left-most value wins: spoofable unless your proxy overwrites the header. Left at `false` (explicitly or not),
1937
+ * NYMBAL_TRUST_PROXY_HOPS fills it at run time.
1938
+ */
1939
+ trustProxy: z.ZodDefault<z.ZodUnion<[z.ZodBoolean, z.ZodNumber]>>;
1430
1940
  cors: z.ZodDefault<z.ZodObject<{
1431
1941
  allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
1432
1942
  credentials: z.ZodDefault<z.ZodBoolean>;
@@ -1441,7 +1951,7 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1441
1951
  adapter: "fastify" | "hono";
1442
1952
  port: number;
1443
1953
  host: string;
1444
- trustProxy: boolean;
1954
+ trustProxy: number | boolean;
1445
1955
  cors: {
1446
1956
  allowedOrigins: string[];
1447
1957
  credentials: boolean;
@@ -1450,7 +1960,7 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1450
1960
  adapter?: "fastify" | "hono" | undefined;
1451
1961
  port?: number | undefined;
1452
1962
  host?: string | undefined;
1453
- trustProxy?: boolean | undefined;
1963
+ trustProxy?: number | boolean | undefined;
1454
1964
  cors?: {
1455
1965
  allowedOrigins?: string[] | undefined;
1456
1966
  credentials?: boolean | undefined;
@@ -1527,41 +2037,13 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1527
2037
  } | undefined;
1528
2038
  }>>;
1529
2039
  }, "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
2040
  security: {
1560
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
2041
+ adapter: string;
1561
2042
  rateLimit: Record<string, {
1562
2043
  requests: number;
1563
2044
  window: string;
1564
2045
  action: "block" | "challenge" | "throttle";
2046
+ header?: string | undefined;
1565
2047
  }>;
1566
2048
  botProtection: {
1567
2049
  mode: "strict" | "off" | "managed";
@@ -1588,63 +2070,110 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1588
2070
  expression: string;
1589
2071
  }[];
1590
2072
  managedRulesets: ("cloudflare" | "owasp")[];
2073
+ package?: string | undefined;
2074
+ config?: Record<string, unknown> | undefined;
1591
2075
  cloudflare?: {
1592
2076
  zoneId?: string | undefined;
1593
2077
  apiToken?: string | undefined;
1594
2078
  apiBase?: string | undefined;
1595
2079
  } | undefined;
1596
2080
  };
2081
+ store: {
2082
+ name: string;
2083
+ currency: string;
2084
+ locale: string;
2085
+ timezone: string;
2086
+ url?: string | undefined;
2087
+ };
2088
+ template: "astro" | "nextjs";
2089
+ infrastructure: {
2090
+ documentStore: {
2091
+ provider: string;
2092
+ package?: string | undefined;
2093
+ config?: Record<string, unknown> | undefined;
2094
+ };
2095
+ eventBus: {
2096
+ provider: string;
2097
+ package?: string | undefined;
2098
+ config?: Record<string, unknown> | undefined;
2099
+ };
2100
+ media: {
2101
+ provider: string;
2102
+ package?: string | undefined;
2103
+ config?: Record<string, unknown> | undefined;
2104
+ };
2105
+ commandStore: "sqlite" | "postgres";
2106
+ redis?: {
2107
+ url?: string | undefined;
2108
+ prefix?: string | undefined;
2109
+ ackTimeoutMs?: number | undefined;
2110
+ claimIdleMs?: number | undefined;
2111
+ streamMaxLen?: number | undefined;
2112
+ } | undefined;
2113
+ s3?: {
2114
+ prefix?: string | undefined;
2115
+ bucket?: string | undefined;
2116
+ region?: string | undefined;
2117
+ endpoint?: string | undefined;
2118
+ publicUrl?: string | undefined;
2119
+ forcePathStyle?: boolean | undefined;
2120
+ } | undefined;
2121
+ };
1597
2122
  commerce: {
1598
2123
  payments: {
1599
- provider: "native" | "stripe" | "custom";
1600
- config?: Record<string, unknown> | undefined;
2124
+ provider: string;
1601
2125
  package?: string | undefined;
2126
+ config?: Record<string, unknown> | undefined;
1602
2127
  };
1603
2128
  email: {
1604
- provider: "native" | "custom" | "smtp";
1605
- config?: Record<string, unknown> | undefined;
2129
+ provider: string;
1606
2130
  package?: string | undefined;
2131
+ config?: Record<string, unknown> | undefined;
1607
2132
  };
1608
2133
  reviews: {
1609
- provider: "native" | "custom";
1610
- config?: Record<string, unknown> | undefined;
2134
+ provider: string;
1611
2135
  package?: string | undefined;
2136
+ config?: Record<string, unknown> | undefined;
1612
2137
  };
1613
2138
  search: {
1614
- provider: "native" | "custom";
1615
- config?: Record<string, unknown> | undefined;
2139
+ provider: string;
1616
2140
  package?: string | undefined;
2141
+ config?: Record<string, unknown> | undefined;
1617
2142
  };
1618
2143
  analytics: {
1619
- provider: "native" | "custom";
1620
- config?: Record<string, unknown> | undefined;
2144
+ provider: string;
1621
2145
  package?: string | undefined;
2146
+ config?: Record<string, unknown> | undefined;
1622
2147
  };
1623
2148
  shipping: {
1624
- provider: "native" | "custom";
1625
- config?: Record<string, unknown> | undefined;
2149
+ provider: string;
1626
2150
  package?: string | undefined;
2151
+ config?: Record<string, unknown> | undefined;
1627
2152
  };
1628
2153
  tax: {
1629
- provider: "native" | "custom";
1630
- config?: Record<string, unknown> | undefined;
2154
+ provider: string;
1631
2155
  package?: string | undefined;
2156
+ config?: Record<string, unknown> | undefined;
1632
2157
  };
1633
2158
  ai: {
1634
- provider: "custom" | "none" | "anthropic";
1635
- config?: Record<string, unknown> | undefined;
2159
+ provider: string;
1636
2160
  package?: string | undefined;
2161
+ config?: Record<string, unknown> | undefined;
1637
2162
  };
1638
2163
  orders: {
1639
2164
  numberPrefix: string;
1640
2165
  numberStart: number;
2166
+ keyLifetime: {
2167
+ email: string;
2168
+ checkout: string;
2169
+ };
1641
2170
  };
1642
2171
  };
1643
2172
  http: {
1644
2173
  adapter: "fastify" | "hono";
1645
2174
  port: number;
1646
2175
  host: string;
1647
- trustProxy: boolean;
2176
+ trustProxy: number | boolean;
1648
2177
  cors: {
1649
2178
  allowedOrigins: string[];
1650
2179
  credentials: boolean;
@@ -1670,46 +2199,15 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1670
2199
  } | undefined;
1671
2200
  };
1672
2201
  }, {
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
2202
  security: {
1703
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1704
- cloudflare?: {
1705
- zoneId?: string | undefined;
1706
- apiToken?: string | undefined;
1707
- apiBase?: string | undefined;
1708
- } | undefined;
2203
+ adapter: string;
2204
+ package?: string | undefined;
2205
+ config?: Record<string, unknown> | undefined;
1709
2206
  rateLimit?: Record<string, {
1710
2207
  requests: number;
1711
2208
  window: string;
1712
2209
  action: "block" | "challenge" | "throttle";
2210
+ header?: string | undefined;
1713
2211
  }> | undefined;
1714
2212
  botProtection?: {
1715
2213
  mode?: "strict" | "off" | "managed" | undefined;
@@ -1727,6 +2225,11 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1727
2225
  accessTtl?: string | undefined;
1728
2226
  refreshTtl?: string | undefined;
1729
2227
  } | undefined;
2228
+ cloudflare?: {
2229
+ zoneId?: string | undefined;
2230
+ apiToken?: string | undefined;
2231
+ apiBase?: string | undefined;
2232
+ } | undefined;
1730
2233
  geo?: {
1731
2234
  block?: string[] | undefined;
1732
2235
  } | undefined;
@@ -1737,57 +2240,102 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1737
2240
  }[] | undefined;
1738
2241
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
1739
2242
  };
2243
+ store: {
2244
+ name: string;
2245
+ currency: string;
2246
+ locale: string;
2247
+ timezone: string;
2248
+ url?: string | undefined;
2249
+ };
2250
+ template: "astro" | "nextjs";
2251
+ infrastructure: {
2252
+ documentStore: {
2253
+ provider: string;
2254
+ package?: string | undefined;
2255
+ config?: Record<string, unknown> | undefined;
2256
+ };
2257
+ eventBus: {
2258
+ provider: string;
2259
+ package?: string | undefined;
2260
+ config?: Record<string, unknown> | undefined;
2261
+ };
2262
+ commandStore: "sqlite" | "postgres";
2263
+ media?: {
2264
+ provider: string;
2265
+ package?: string | undefined;
2266
+ config?: Record<string, unknown> | undefined;
2267
+ } | undefined;
2268
+ redis?: {
2269
+ url?: string | undefined;
2270
+ prefix?: string | undefined;
2271
+ ackTimeoutMs?: number | undefined;
2272
+ claimIdleMs?: number | undefined;
2273
+ streamMaxLen?: number | undefined;
2274
+ } | undefined;
2275
+ s3?: {
2276
+ prefix?: string | undefined;
2277
+ bucket?: string | undefined;
2278
+ region?: string | undefined;
2279
+ endpoint?: string | undefined;
2280
+ publicUrl?: string | undefined;
2281
+ forcePathStyle?: boolean | undefined;
2282
+ } | undefined;
2283
+ };
1740
2284
  commerce: {
1741
2285
  payments: {
1742
- provider: "native" | "stripe" | "custom";
1743
- config?: Record<string, unknown> | undefined;
2286
+ provider: string;
1744
2287
  package?: string | undefined;
2288
+ config?: Record<string, unknown> | undefined;
1745
2289
  };
1746
2290
  email: {
1747
- provider: "native" | "custom" | "smtp";
1748
- config?: Record<string, unknown> | undefined;
2291
+ provider: string;
1749
2292
  package?: string | undefined;
2293
+ config?: Record<string, unknown> | undefined;
1750
2294
  };
1751
2295
  reviews: {
1752
- provider: "native" | "custom";
1753
- config?: Record<string, unknown> | undefined;
2296
+ provider: string;
1754
2297
  package?: string | undefined;
2298
+ config?: Record<string, unknown> | undefined;
1755
2299
  };
1756
2300
  search: {
1757
- provider: "native" | "custom";
1758
- config?: Record<string, unknown> | undefined;
2301
+ provider: string;
1759
2302
  package?: string | undefined;
2303
+ config?: Record<string, unknown> | undefined;
1760
2304
  };
1761
2305
  analytics: {
1762
- provider: "native" | "custom";
1763
- config?: Record<string, unknown> | undefined;
2306
+ provider: string;
1764
2307
  package?: string | undefined;
2308
+ config?: Record<string, unknown> | undefined;
1765
2309
  };
1766
2310
  shipping: {
1767
- provider: "native" | "custom";
1768
- config?: Record<string, unknown> | undefined;
2311
+ provider: string;
1769
2312
  package?: string | undefined;
2313
+ config?: Record<string, unknown> | undefined;
1770
2314
  };
1771
2315
  tax: {
1772
- provider: "native" | "custom";
1773
- config?: Record<string, unknown> | undefined;
2316
+ provider: string;
1774
2317
  package?: string | undefined;
2318
+ config?: Record<string, unknown> | undefined;
1775
2319
  };
1776
2320
  ai: {
1777
- provider: "custom" | "none" | "anthropic";
1778
- config?: Record<string, unknown> | undefined;
2321
+ provider: string;
1779
2322
  package?: string | undefined;
2323
+ config?: Record<string, unknown> | undefined;
1780
2324
  };
1781
2325
  orders?: {
1782
2326
  numberPrefix?: string | undefined;
1783
2327
  numberStart?: number | undefined;
2328
+ keyLifetime?: {
2329
+ email?: string | undefined;
2330
+ checkout?: string | undefined;
2331
+ } | undefined;
1784
2332
  } | undefined;
1785
2333
  };
1786
2334
  http: {
1787
2335
  adapter?: "fastify" | "hono" | undefined;
1788
2336
  port?: number | undefined;
1789
2337
  host?: string | undefined;
1790
- trustProxy?: boolean | undefined;
2338
+ trustProxy?: number | boolean | undefined;
1791
2339
  cors?: {
1792
2340
  allowedOrigins?: string[] | undefined;
1793
2341
  credentials?: boolean | undefined;
@@ -1813,41 +2361,13 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1813
2361
  } | undefined;
1814
2362
  } | undefined;
1815
2363
  }>, {
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
2364
  security: {
1846
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
2365
+ adapter: string;
1847
2366
  rateLimit: Record<string, {
1848
2367
  requests: number;
1849
2368
  window: string;
1850
2369
  action: "block" | "challenge" | "throttle";
2370
+ header?: string | undefined;
1851
2371
  }>;
1852
2372
  botProtection: {
1853
2373
  mode: "strict" | "off" | "managed";
@@ -1874,63 +2394,110 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1874
2394
  expression: string;
1875
2395
  }[];
1876
2396
  managedRulesets: ("cloudflare" | "owasp")[];
2397
+ package?: string | undefined;
2398
+ config?: Record<string, unknown> | undefined;
1877
2399
  cloudflare?: {
1878
2400
  zoneId?: string | undefined;
1879
2401
  apiToken?: string | undefined;
1880
2402
  apiBase?: string | undefined;
1881
2403
  } | undefined;
1882
2404
  };
2405
+ store: {
2406
+ name: string;
2407
+ currency: string;
2408
+ locale: string;
2409
+ timezone: string;
2410
+ url?: string | undefined;
2411
+ };
2412
+ template: "astro" | "nextjs";
2413
+ infrastructure: {
2414
+ documentStore: {
2415
+ provider: string;
2416
+ package?: string | undefined;
2417
+ config?: Record<string, unknown> | undefined;
2418
+ };
2419
+ eventBus: {
2420
+ provider: string;
2421
+ package?: string | undefined;
2422
+ config?: Record<string, unknown> | undefined;
2423
+ };
2424
+ media: {
2425
+ provider: string;
2426
+ package?: string | undefined;
2427
+ config?: Record<string, unknown> | undefined;
2428
+ };
2429
+ commandStore: "sqlite" | "postgres";
2430
+ redis?: {
2431
+ url?: string | undefined;
2432
+ prefix?: string | undefined;
2433
+ ackTimeoutMs?: number | undefined;
2434
+ claimIdleMs?: number | undefined;
2435
+ streamMaxLen?: number | undefined;
2436
+ } | undefined;
2437
+ s3?: {
2438
+ prefix?: string | undefined;
2439
+ bucket?: string | undefined;
2440
+ region?: string | undefined;
2441
+ endpoint?: string | undefined;
2442
+ publicUrl?: string | undefined;
2443
+ forcePathStyle?: boolean | undefined;
2444
+ } | undefined;
2445
+ };
1883
2446
  commerce: {
1884
2447
  payments: {
1885
- provider: "native" | "stripe" | "custom";
1886
- config?: Record<string, unknown> | undefined;
2448
+ provider: string;
1887
2449
  package?: string | undefined;
2450
+ config?: Record<string, unknown> | undefined;
1888
2451
  };
1889
2452
  email: {
1890
- provider: "native" | "custom" | "smtp";
1891
- config?: Record<string, unknown> | undefined;
2453
+ provider: string;
1892
2454
  package?: string | undefined;
2455
+ config?: Record<string, unknown> | undefined;
1893
2456
  };
1894
2457
  reviews: {
1895
- provider: "native" | "custom";
1896
- config?: Record<string, unknown> | undefined;
2458
+ provider: string;
1897
2459
  package?: string | undefined;
2460
+ config?: Record<string, unknown> | undefined;
1898
2461
  };
1899
2462
  search: {
1900
- provider: "native" | "custom";
1901
- config?: Record<string, unknown> | undefined;
2463
+ provider: string;
1902
2464
  package?: string | undefined;
2465
+ config?: Record<string, unknown> | undefined;
1903
2466
  };
1904
2467
  analytics: {
1905
- provider: "native" | "custom";
1906
- config?: Record<string, unknown> | undefined;
2468
+ provider: string;
1907
2469
  package?: string | undefined;
2470
+ config?: Record<string, unknown> | undefined;
1908
2471
  };
1909
2472
  shipping: {
1910
- provider: "native" | "custom";
1911
- config?: Record<string, unknown> | undefined;
2473
+ provider: string;
1912
2474
  package?: string | undefined;
2475
+ config?: Record<string, unknown> | undefined;
1913
2476
  };
1914
2477
  tax: {
1915
- provider: "native" | "custom";
1916
- config?: Record<string, unknown> | undefined;
2478
+ provider: string;
1917
2479
  package?: string | undefined;
2480
+ config?: Record<string, unknown> | undefined;
1918
2481
  };
1919
2482
  ai: {
1920
- provider: "custom" | "none" | "anthropic";
1921
- config?: Record<string, unknown> | undefined;
2483
+ provider: string;
1922
2484
  package?: string | undefined;
2485
+ config?: Record<string, unknown> | undefined;
1923
2486
  };
1924
2487
  orders: {
1925
2488
  numberPrefix: string;
1926
2489
  numberStart: number;
2490
+ keyLifetime: {
2491
+ email: string;
2492
+ checkout: string;
2493
+ };
1927
2494
  };
1928
2495
  };
1929
2496
  http: {
1930
2497
  adapter: "fastify" | "hono";
1931
2498
  port: number;
1932
2499
  host: string;
1933
- trustProxy: boolean;
2500
+ trustProxy: number | boolean;
1934
2501
  cors: {
1935
2502
  allowedOrigins: string[];
1936
2503
  credentials: boolean;
@@ -1956,46 +2523,15 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1956
2523
  } | undefined;
1957
2524
  };
1958
2525
  }, {
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
2526
  security: {
1989
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1990
- cloudflare?: {
1991
- zoneId?: string | undefined;
1992
- apiToken?: string | undefined;
1993
- apiBase?: string | undefined;
1994
- } | undefined;
2527
+ adapter: string;
2528
+ package?: string | undefined;
2529
+ config?: Record<string, unknown> | undefined;
1995
2530
  rateLimit?: Record<string, {
1996
2531
  requests: number;
1997
2532
  window: string;
1998
2533
  action: "block" | "challenge" | "throttle";
2534
+ header?: string | undefined;
1999
2535
  }> | undefined;
2000
2536
  botProtection?: {
2001
2537
  mode?: "strict" | "off" | "managed" | undefined;
@@ -2013,6 +2549,11 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
2013
2549
  accessTtl?: string | undefined;
2014
2550
  refreshTtl?: string | undefined;
2015
2551
  } | undefined;
2552
+ cloudflare?: {
2553
+ zoneId?: string | undefined;
2554
+ apiToken?: string | undefined;
2555
+ apiBase?: string | undefined;
2556
+ } | undefined;
2016
2557
  geo?: {
2017
2558
  block?: string[] | undefined;
2018
2559
  } | undefined;
@@ -2023,57 +2564,102 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
2023
2564
  }[] | undefined;
2024
2565
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
2025
2566
  };
2567
+ store: {
2568
+ name: string;
2569
+ currency: string;
2570
+ locale: string;
2571
+ timezone: string;
2572
+ url?: string | undefined;
2573
+ };
2574
+ template: "astro" | "nextjs";
2575
+ infrastructure: {
2576
+ documentStore: {
2577
+ provider: string;
2578
+ package?: string | undefined;
2579
+ config?: Record<string, unknown> | undefined;
2580
+ };
2581
+ eventBus: {
2582
+ provider: string;
2583
+ package?: string | undefined;
2584
+ config?: Record<string, unknown> | undefined;
2585
+ };
2586
+ commandStore: "sqlite" | "postgres";
2587
+ media?: {
2588
+ provider: string;
2589
+ package?: string | undefined;
2590
+ config?: Record<string, unknown> | undefined;
2591
+ } | undefined;
2592
+ redis?: {
2593
+ url?: string | undefined;
2594
+ prefix?: string | undefined;
2595
+ ackTimeoutMs?: number | undefined;
2596
+ claimIdleMs?: number | undefined;
2597
+ streamMaxLen?: number | undefined;
2598
+ } | undefined;
2599
+ s3?: {
2600
+ prefix?: string | undefined;
2601
+ bucket?: string | undefined;
2602
+ region?: string | undefined;
2603
+ endpoint?: string | undefined;
2604
+ publicUrl?: string | undefined;
2605
+ forcePathStyle?: boolean | undefined;
2606
+ } | undefined;
2607
+ };
2026
2608
  commerce: {
2027
2609
  payments: {
2028
- provider: "native" | "stripe" | "custom";
2029
- config?: Record<string, unknown> | undefined;
2610
+ provider: string;
2030
2611
  package?: string | undefined;
2612
+ config?: Record<string, unknown> | undefined;
2031
2613
  };
2032
2614
  email: {
2033
- provider: "native" | "custom" | "smtp";
2034
- config?: Record<string, unknown> | undefined;
2615
+ provider: string;
2035
2616
  package?: string | undefined;
2617
+ config?: Record<string, unknown> | undefined;
2036
2618
  };
2037
2619
  reviews: {
2038
- provider: "native" | "custom";
2039
- config?: Record<string, unknown> | undefined;
2620
+ provider: string;
2040
2621
  package?: string | undefined;
2622
+ config?: Record<string, unknown> | undefined;
2041
2623
  };
2042
2624
  search: {
2043
- provider: "native" | "custom";
2044
- config?: Record<string, unknown> | undefined;
2625
+ provider: string;
2045
2626
  package?: string | undefined;
2627
+ config?: Record<string, unknown> | undefined;
2046
2628
  };
2047
2629
  analytics: {
2048
- provider: "native" | "custom";
2049
- config?: Record<string, unknown> | undefined;
2630
+ provider: string;
2050
2631
  package?: string | undefined;
2632
+ config?: Record<string, unknown> | undefined;
2051
2633
  };
2052
2634
  shipping: {
2053
- provider: "native" | "custom";
2054
- config?: Record<string, unknown> | undefined;
2635
+ provider: string;
2055
2636
  package?: string | undefined;
2637
+ config?: Record<string, unknown> | undefined;
2056
2638
  };
2057
2639
  tax: {
2058
- provider: "native" | "custom";
2059
- config?: Record<string, unknown> | undefined;
2640
+ provider: string;
2060
2641
  package?: string | undefined;
2642
+ config?: Record<string, unknown> | undefined;
2061
2643
  };
2062
2644
  ai: {
2063
- provider: "custom" | "none" | "anthropic";
2064
- config?: Record<string, unknown> | undefined;
2645
+ provider: string;
2065
2646
  package?: string | undefined;
2647
+ config?: Record<string, unknown> | undefined;
2066
2648
  };
2067
2649
  orders?: {
2068
2650
  numberPrefix?: string | undefined;
2069
2651
  numberStart?: number | undefined;
2652
+ keyLifetime?: {
2653
+ email?: string | undefined;
2654
+ checkout?: string | undefined;
2655
+ } | undefined;
2070
2656
  } | undefined;
2071
2657
  };
2072
2658
  http: {
2073
2659
  adapter?: "fastify" | "hono" | undefined;
2074
2660
  port?: number | undefined;
2075
2661
  host?: string | undefined;
2076
- trustProxy?: boolean | undefined;
2662
+ trustProxy?: number | boolean | undefined;
2077
2663
  cors?: {
2078
2664
  allowedOrigins?: string[] | undefined;
2079
2665
  credentials?: boolean | undefined;
@@ -2110,32 +2696,43 @@ declare function envNumber(key: string, defaultValue?: number): number;
2110
2696
  declare function envBool(key: string, defaultValue?: boolean): boolean;
2111
2697
 
2112
2698
  /**
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`.
2699
+ * The providers Nymbal ships for each commerce slot, from the catalogue, and `custom`, the adapter a project passes
2700
+ * to `createApp`. A slot accepts any provider name; this list gates nothing.
2115
2701
  */
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
- };
2702
+ declare const KNOWN_PROVIDERS: Readonly<Record<CommerceSlot, readonly string[]>>;
2126
2703
 
2127
2704
  /**
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.
2705
+ * What a slot's provider may be called: lower-case letters, digits and hyphens, starting with a letter or digit. The
2706
+ * bound keeps every convention name within npm's 214 characters.
2707
+ */
2708
+ declare const PROVIDER_NAME: RegExp;
2709
+ /** A slot as its package names and folders spell it: `documentStore` is `document-store`. */
2710
+ declare function slotFolder(slot: Slot): string;
2711
+ /** The package a provider lives in when the config names no `package`: `@nymbalhq/<slot folder>-<provider>`. */
2712
+ declare function conventionPackage(slot: Slot, provider: string): string;
2713
+ interface CatalogueEntry {
2714
+ /** The kernel's own provider, which no package holds. */
2715
+ builtIn?: true;
2716
+ /** The SDK the provider's package peers, which the project installs beside it. */
2717
+ sdk?: string;
2718
+ }
2719
+ /**
2720
+ * The providers Nymbal ships, by slot: the kernel's built-ins and the first-party packages, each with the SDK it peers.
2721
+ * It never decides what loads; it gives install lines, suggestions for a mistyped provider and `nymbal add`'s list.
2131
2722
  */
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;
2723
+ declare const ADAPTER_CATALOGUE: Readonly<Record<Slot, Readonly<Record<string, CatalogueEntry>>>>;
2724
+ /** Each slot's built-in providers: the kernel's own adapter is used, and nothing is imported. */
2725
+ declare const BUILT_IN: Readonly<Record<Slot, readonly string[]>>;
2726
+ /**
2727
+ * The catalogue name `name` was most likely meant to be, among the slot's catalogue names and, on a commerce slot,
2728
+ * `custom`: the nearest within two edits, the alphabetically first on a tie; none when nothing is that near.
2729
+ */
2730
+ declare function suggestProvider(slot: Slot, name: string): string | undefined;
2731
+
2732
+ /** The command store's dialects: a kernel dialect, not an adapter slot, so it stays a closed list. */
2733
+ declare const COMMAND_STORES: readonly ["sqlite", "postgres"];
2734
+ /** The infrastructure slots: the command store, and the three that take an adapter block. */
2735
+ type InfrastructureSlot = 'commandStore' | 'documentStore' | 'eventBus' | 'media';
2139
2736
  /** Keys that drove nothing and were removed; a config that still sets one is told to delete it. */
2140
2737
  declare const REMOVED_INFRASTRUCTURE_KEYS: readonly ["cloud", "compute"];
2141
2738
 
@@ -2149,5 +2746,5 @@ interface LoadedConfig {
2149
2746
  declare function findConfigFile(startDir: string): string | null;
2150
2747
  declare function loadConfig(startDir?: string): Promise<LoadedConfig>;
2151
2748
 
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 };
2749
+ export { ADAPTER_CATALOGUE, BUILT_IN, COMMAND_STORES, DEFAULT_JWT_SECRET, KNOWN_PROVIDERS, PROVIDER_NAME, REMOVED_INFRASTRUCTURE_KEYS, commerceSchema, conventionPackage, defineConfig, deploymentSchema, env, envBool, envNumber, envOptional, eventArchiveSchema, eventsSchema, featuresSchema, findConfigFile, httpSchema, infrastructureSchema, loadConfig, nymbalConfigSchema, redisSchema, s3Schema, securitySchema, slotFolder, storeSchema, suggestProvider };
2750
+ export type { CatalogueEntry, InfrastructureSlot, LoadedConfig, NymbalConfig, NymbalConfigInput };