@nymbalhq/config 1.3.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. */
@@ -9,16 +9,20 @@ declare const storeSchema: z.ZodObject<{
9
9
  currency: z.ZodString;
10
10
  locale: z.ZodString;
11
11
  timezone: z.ZodString;
12
+ /** The storefront's public URL, which the order email links from; with none, the email has no link. */
13
+ url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
12
14
  }, "strip", z.ZodTypeAny, {
13
15
  name: string;
14
16
  currency: string;
15
17
  locale: string;
16
18
  timezone: string;
19
+ url?: string | undefined;
17
20
  }, {
18
21
  name: string;
19
22
  currency: string;
20
23
  locale: string;
21
24
  timezone: string;
25
+ url?: string | undefined;
22
26
  }>;
23
27
  /** The shared Redis connection of the `redis` document store and the `redis-streams` bus. */
24
28
  declare const redisSchema: z.ZodObject<{
@@ -46,8 +50,8 @@ declare const redisSchema: z.ZodObject<{
46
50
  streamMaxLen?: number | undefined;
47
51
  }>;
48
52
  /**
49
- * The bucket `media: 's3'` stores in. Each field falls back to the environment in the platform; credentials are never
50
- * 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.
51
55
  */
52
56
  declare const s3Schema: z.ZodObject<{
53
57
  /** Defaults to `S3_BUCKET`; one of the two is required. */
@@ -79,9 +83,75 @@ declare const s3Schema: z.ZodObject<{
79
83
  }>;
80
84
  declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
81
85
  commandStore: z.ZodEnum<["sqlite", "postgres"]>;
82
- documentStore: z.ZodEnum<["in-memory", "redis", "postgres-jsonb"]>;
83
- eventBus: z.ZodEnum<["in-process", "redis-streams"]>;
84
- 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
+ }>>;
85
155
  redis: z.ZodOptional<z.ZodObject<{
86
156
  /** Defaults to `REDIS_URL`. */
87
157
  url: z.ZodOptional<z.ZodString>;
@@ -135,10 +205,22 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
135
205
  forcePathStyle?: boolean | undefined;
136
206
  }>>;
137
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
+ };
138
223
  commandStore: "sqlite" | "postgres";
139
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
140
- eventBus: "in-process" | "redis-streams";
141
- media: "local-fs" | "s3";
142
224
  redis?: {
143
225
  url?: string | undefined;
144
226
  prefix?: string | undefined;
@@ -155,9 +237,22 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
155
237
  forcePathStyle?: boolean | undefined;
156
238
  } | undefined;
157
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
+ };
158
250
  commandStore: "sqlite" | "postgres";
159
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
160
- eventBus: "in-process" | "redis-streams";
251
+ media?: {
252
+ provider: string;
253
+ package?: string | undefined;
254
+ config?: Record<string, unknown> | undefined;
255
+ } | undefined;
161
256
  redis?: {
162
257
  url?: string | undefined;
163
258
  prefix?: string | undefined;
@@ -165,7 +260,6 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
165
260
  claimIdleMs?: number | undefined;
166
261
  streamMaxLen?: number | undefined;
167
262
  } | undefined;
168
- media?: "local-fs" | "s3" | undefined;
169
263
  s3?: {
170
264
  prefix?: string | undefined;
171
265
  bucket?: string | undefined;
@@ -175,10 +269,22 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
175
269
  forcePathStyle?: boolean | undefined;
176
270
  } | undefined;
177
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
+ };
178
287
  commandStore: "sqlite" | "postgres";
179
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
180
- eventBus: "in-process" | "redis-streams";
181
- media: "local-fs" | "s3";
182
288
  redis?: {
183
289
  url?: string | undefined;
184
290
  prefix?: string | undefined;
@@ -195,9 +301,22 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
195
301
  forcePathStyle?: boolean | undefined;
196
302
  } | undefined;
197
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
+ };
198
314
  commandStore: "sqlite" | "postgres";
199
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
200
- eventBus: "in-process" | "redis-streams";
315
+ media?: {
316
+ provider: string;
317
+ package?: string | undefined;
318
+ config?: Record<string, unknown> | undefined;
319
+ } | undefined;
201
320
  redis?: {
202
321
  url?: string | undefined;
203
322
  prefix?: string | undefined;
@@ -205,7 +324,6 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
205
324
  claimIdleMs?: number | undefined;
206
325
  streamMaxLen?: number | undefined;
207
326
  } | undefined;
208
- media?: "local-fs" | "s3" | undefined;
209
327
  s3?: {
210
328
  prefix?: string | undefined;
211
329
  bucket?: string | undefined;
@@ -216,19 +334,28 @@ declare const infrastructureSchema: z.ZodEffects<z.ZodObject<{
216
334
  } | undefined;
217
335
  }>;
218
336
  declare const securitySchema: z.ZodEffects<z.ZodObject<{
219
- 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>>;
220
343
  rateLimit: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
221
344
  requests: z.ZodNumber;
222
345
  window: z.ZodString;
223
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>;
224
349
  }, "strip", z.ZodTypeAny, {
225
350
  requests: number;
226
351
  window: string;
227
352
  action: "block" | "challenge" | "throttle";
353
+ header?: string | undefined;
228
354
  }, {
229
355
  requests: number;
230
356
  window: string;
231
357
  action: "block" | "challenge" | "throttle";
358
+ header?: string | undefined;
232
359
  }>>>;
233
360
  botProtection: z.ZodDefault<z.ZodObject<{
234
361
  mode: z.ZodDefault<z.ZodEnum<["off", "managed", "strict"]>>;
@@ -306,11 +433,12 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
306
433
  }>, "many">>;
307
434
  managedRulesets: z.ZodDefault<z.ZodArray<z.ZodEnum<["cloudflare", "owasp"]>, "many">>;
308
435
  }, "strip", z.ZodTypeAny, {
309
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
436
+ adapter: string;
310
437
  rateLimit: Record<string, {
311
438
  requests: number;
312
439
  window: string;
313
440
  action: "block" | "challenge" | "throttle";
441
+ header?: string | undefined;
314
442
  }>;
315
443
  botProtection: {
316
444
  mode: "strict" | "off" | "managed";
@@ -337,22 +465,22 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
337
465
  expression: string;
338
466
  }[];
339
467
  managedRulesets: ("cloudflare" | "owasp")[];
468
+ package?: string | undefined;
469
+ config?: Record<string, unknown> | undefined;
340
470
  cloudflare?: {
341
471
  zoneId?: string | undefined;
342
472
  apiToken?: string | undefined;
343
473
  apiBase?: string | undefined;
344
474
  } | undefined;
345
475
  }, {
346
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
347
- cloudflare?: {
348
- zoneId?: string | undefined;
349
- apiToken?: string | undefined;
350
- apiBase?: string | undefined;
351
- } | undefined;
476
+ adapter: string;
477
+ package?: string | undefined;
478
+ config?: Record<string, unknown> | undefined;
352
479
  rateLimit?: Record<string, {
353
480
  requests: number;
354
481
  window: string;
355
482
  action: "block" | "challenge" | "throttle";
483
+ header?: string | undefined;
356
484
  }> | undefined;
357
485
  botProtection?: {
358
486
  mode?: "strict" | "off" | "managed" | undefined;
@@ -370,6 +498,11 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
370
498
  accessTtl?: string | undefined;
371
499
  refreshTtl?: string | undefined;
372
500
  } | undefined;
501
+ cloudflare?: {
502
+ zoneId?: string | undefined;
503
+ apiToken?: string | undefined;
504
+ apiBase?: string | undefined;
505
+ } | undefined;
373
506
  geo?: {
374
507
  block?: string[] | undefined;
375
508
  } | undefined;
@@ -380,11 +513,12 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
380
513
  }[] | undefined;
381
514
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
382
515
  }>, {
383
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
516
+ adapter: string;
384
517
  rateLimit: Record<string, {
385
518
  requests: number;
386
519
  window: string;
387
520
  action: "block" | "challenge" | "throttle";
521
+ header?: string | undefined;
388
522
  }>;
389
523
  botProtection: {
390
524
  mode: "strict" | "off" | "managed";
@@ -411,22 +545,22 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
411
545
  expression: string;
412
546
  }[];
413
547
  managedRulesets: ("cloudflare" | "owasp")[];
548
+ package?: string | undefined;
549
+ config?: Record<string, unknown> | undefined;
414
550
  cloudflare?: {
415
551
  zoneId?: string | undefined;
416
552
  apiToken?: string | undefined;
417
553
  apiBase?: string | undefined;
418
554
  } | undefined;
419
555
  }, {
420
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
421
- cloudflare?: {
422
- zoneId?: string | undefined;
423
- apiToken?: string | undefined;
424
- apiBase?: string | undefined;
425
- } | undefined;
556
+ adapter: string;
557
+ package?: string | undefined;
558
+ config?: Record<string, unknown> | undefined;
426
559
  rateLimit?: Record<string, {
427
560
  requests: number;
428
561
  window: string;
429
562
  action: "block" | "challenge" | "throttle";
563
+ header?: string | undefined;
430
564
  }> | undefined;
431
565
  botProtection?: {
432
566
  mode?: "strict" | "off" | "managed" | undefined;
@@ -444,6 +578,11 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
444
578
  accessTtl?: string | undefined;
445
579
  refreshTtl?: string | undefined;
446
580
  } | undefined;
581
+ cloudflare?: {
582
+ zoneId?: string | undefined;
583
+ apiToken?: string | undefined;
584
+ apiBase?: string | undefined;
585
+ } | undefined;
447
586
  geo?: {
448
587
  block?: string[] | undefined;
449
588
  } | undefined;
@@ -455,225 +594,345 @@ declare const securitySchema: z.ZodEffects<z.ZodObject<{
455
594
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
456
595
  }>;
457
596
  declare const commerceSchema: z.ZodObject<{
458
- payments: z.ZodObject<{
459
- provider: z.ZodEnum<["native", "stripe", "custom"]>;
597
+ payments: z.ZodEffects<z.ZodObject<{
598
+ provider: z.ZodEffects<z.ZodString, string, string>;
460
599
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
461
- /** 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
+ */
462
604
  package: z.ZodOptional<z.ZodString>;
463
605
  }, "strip", z.ZodTypeAny, {
464
- provider: "native" | "stripe" | "custom";
465
- config?: Record<string, unknown> | undefined;
606
+ provider: string;
466
607
  package?: string | undefined;
608
+ config?: Record<string, unknown> | undefined;
467
609
  }, {
468
- provider: "native" | "stripe" | "custom";
610
+ provider: string;
611
+ package?: string | undefined;
612
+ config?: Record<string, unknown> | undefined;
613
+ }>, {
614
+ provider: string;
615
+ package?: string | undefined;
469
616
  config?: Record<string, unknown> | undefined;
617
+ }, {
618
+ provider: string;
470
619
  package?: string | undefined;
620
+ config?: Record<string, unknown> | undefined;
471
621
  }>;
472
- email: z.ZodObject<{
473
- provider: z.ZodEnum<["native", "smtp", "custom"]>;
622
+ email: z.ZodEffects<z.ZodObject<{
623
+ provider: z.ZodEffects<z.ZodString, string, string>;
474
624
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
475
- /** 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
+ */
476
629
  package: z.ZodOptional<z.ZodString>;
477
630
  }, "strip", z.ZodTypeAny, {
478
- provider: "native" | "custom" | "smtp";
479
- config?: Record<string, unknown> | undefined;
631
+ provider: string;
480
632
  package?: string | undefined;
633
+ config?: Record<string, unknown> | undefined;
481
634
  }, {
482
- provider: "native" | "custom" | "smtp";
635
+ provider: string;
636
+ package?: string | undefined;
637
+ config?: Record<string, unknown> | undefined;
638
+ }>, {
639
+ provider: string;
640
+ package?: string | undefined;
483
641
  config?: Record<string, unknown> | undefined;
642
+ }, {
643
+ provider: string;
484
644
  package?: string | undefined;
645
+ config?: Record<string, unknown> | undefined;
485
646
  }>;
486
- reviews: z.ZodObject<{
487
- provider: z.ZodEnum<["native", "custom"]>;
647
+ reviews: z.ZodEffects<z.ZodObject<{
648
+ provider: z.ZodEffects<z.ZodString, string, string>;
488
649
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
489
- /** 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
+ */
490
654
  package: z.ZodOptional<z.ZodString>;
491
655
  }, "strip", z.ZodTypeAny, {
492
- provider: "native" | "custom";
493
- config?: Record<string, unknown> | undefined;
656
+ provider: string;
494
657
  package?: string | undefined;
658
+ config?: Record<string, unknown> | undefined;
495
659
  }, {
496
- provider: "native" | "custom";
660
+ provider: string;
661
+ package?: string | undefined;
662
+ config?: Record<string, unknown> | undefined;
663
+ }>, {
664
+ provider: string;
665
+ package?: string | undefined;
497
666
  config?: Record<string, unknown> | undefined;
667
+ }, {
668
+ provider: string;
498
669
  package?: string | undefined;
670
+ config?: Record<string, unknown> | undefined;
499
671
  }>;
500
- search: z.ZodObject<{
501
- provider: z.ZodEnum<["native", "custom"]>;
672
+ search: z.ZodEffects<z.ZodObject<{
673
+ provider: z.ZodEffects<z.ZodString, string, string>;
502
674
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
503
- /** 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
+ */
504
679
  package: z.ZodOptional<z.ZodString>;
505
680
  }, "strip", z.ZodTypeAny, {
506
- provider: "native" | "custom";
507
- config?: Record<string, unknown> | undefined;
681
+ provider: string;
508
682
  package?: string | undefined;
683
+ config?: Record<string, unknown> | undefined;
509
684
  }, {
510
- provider: "native" | "custom";
685
+ provider: string;
686
+ package?: string | undefined;
687
+ config?: Record<string, unknown> | undefined;
688
+ }>, {
689
+ provider: string;
690
+ package?: string | undefined;
511
691
  config?: Record<string, unknown> | undefined;
692
+ }, {
693
+ provider: string;
512
694
  package?: string | undefined;
695
+ config?: Record<string, unknown> | undefined;
513
696
  }>;
514
- analytics: z.ZodObject<{
515
- provider: z.ZodEnum<["native", "custom"]>;
697
+ analytics: z.ZodEffects<z.ZodObject<{
698
+ provider: z.ZodEffects<z.ZodString, string, string>;
516
699
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
517
- /** 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
+ */
518
704
  package: z.ZodOptional<z.ZodString>;
519
705
  }, "strip", z.ZodTypeAny, {
520
- provider: "native" | "custom";
521
- config?: Record<string, unknown> | undefined;
706
+ provider: string;
522
707
  package?: string | undefined;
708
+ config?: Record<string, unknown> | undefined;
523
709
  }, {
524
- provider: "native" | "custom";
710
+ provider: string;
711
+ package?: string | undefined;
712
+ config?: Record<string, unknown> | undefined;
713
+ }>, {
714
+ provider: string;
715
+ package?: string | undefined;
525
716
  config?: Record<string, unknown> | undefined;
717
+ }, {
718
+ provider: string;
526
719
  package?: string | undefined;
720
+ config?: Record<string, unknown> | undefined;
527
721
  }>;
528
- shipping: z.ZodObject<{
529
- provider: z.ZodEnum<["native", "custom"]>;
722
+ shipping: z.ZodEffects<z.ZodObject<{
723
+ provider: z.ZodEffects<z.ZodString, string, string>;
530
724
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
531
- /** 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
+ */
532
729
  package: z.ZodOptional<z.ZodString>;
533
730
  }, "strip", z.ZodTypeAny, {
534
- provider: "native" | "custom";
535
- config?: Record<string, unknown> | undefined;
731
+ provider: string;
536
732
  package?: string | undefined;
733
+ config?: Record<string, unknown> | undefined;
537
734
  }, {
538
- provider: "native" | "custom";
735
+ provider: string;
736
+ package?: string | undefined;
737
+ config?: Record<string, unknown> | undefined;
738
+ }>, {
739
+ provider: string;
740
+ package?: string | undefined;
539
741
  config?: Record<string, unknown> | undefined;
742
+ }, {
743
+ provider: string;
540
744
  package?: string | undefined;
745
+ config?: Record<string, unknown> | undefined;
541
746
  }>;
542
- tax: z.ZodObject<{
543
- provider: z.ZodEnum<["native", "custom"]>;
747
+ tax: z.ZodEffects<z.ZodObject<{
748
+ provider: z.ZodEffects<z.ZodString, string, string>;
544
749
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
545
- /** 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
+ */
546
754
  package: z.ZodOptional<z.ZodString>;
547
755
  }, "strip", z.ZodTypeAny, {
548
- provider: "native" | "custom";
549
- config?: Record<string, unknown> | undefined;
756
+ provider: string;
550
757
  package?: string | undefined;
758
+ config?: Record<string, unknown> | undefined;
551
759
  }, {
552
- provider: "native" | "custom";
760
+ provider: string;
761
+ package?: string | undefined;
762
+ config?: Record<string, unknown> | undefined;
763
+ }>, {
764
+ provider: string;
765
+ package?: string | undefined;
553
766
  config?: Record<string, unknown> | undefined;
767
+ }, {
768
+ provider: string;
554
769
  package?: string | undefined;
770
+ config?: Record<string, unknown> | undefined;
555
771
  }>;
556
- ai: z.ZodObject<{
557
- provider: z.ZodEnum<["none", "anthropic", "custom"]>;
772
+ ai: z.ZodEffects<z.ZodObject<{
773
+ provider: z.ZodEffects<z.ZodString, string, string>;
558
774
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
559
- /** 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
+ */
560
779
  package: z.ZodOptional<z.ZodString>;
561
780
  }, "strip", z.ZodTypeAny, {
562
- provider: "custom" | "none" | "anthropic";
563
- config?: Record<string, unknown> | undefined;
781
+ provider: string;
564
782
  package?: string | undefined;
783
+ config?: Record<string, unknown> | undefined;
565
784
  }, {
566
- provider: "custom" | "none" | "anthropic";
785
+ provider: string;
786
+ package?: string | undefined;
787
+ config?: Record<string, unknown> | undefined;
788
+ }>, {
789
+ provider: string;
790
+ package?: string | undefined;
567
791
  config?: Record<string, unknown> | undefined;
792
+ }, {
793
+ provider: string;
568
794
  package?: string | undefined;
795
+ config?: Record<string, unknown> | undefined;
569
796
  }>;
570
797
  orders: z.ZodDefault<z.ZodObject<{
571
798
  numberPrefix: z.ZodDefault<z.ZodString>;
572
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
+ }>>;
573
811
  }, "strip", z.ZodTypeAny, {
574
812
  numberPrefix: string;
575
813
  numberStart: number;
814
+ keyLifetime: {
815
+ email: string;
816
+ checkout: string;
817
+ };
576
818
  }, {
577
819
  numberPrefix?: string | undefined;
578
820
  numberStart?: number | undefined;
821
+ keyLifetime?: {
822
+ email?: string | undefined;
823
+ checkout?: string | undefined;
824
+ } | undefined;
579
825
  }>>;
580
826
  }, "strip", z.ZodTypeAny, {
581
827
  payments: {
582
- provider: "native" | "stripe" | "custom";
583
- config?: Record<string, unknown> | undefined;
828
+ provider: string;
584
829
  package?: string | undefined;
830
+ config?: Record<string, unknown> | undefined;
585
831
  };
586
832
  email: {
587
- provider: "native" | "custom" | "smtp";
588
- config?: Record<string, unknown> | undefined;
833
+ provider: string;
589
834
  package?: string | undefined;
835
+ config?: Record<string, unknown> | undefined;
590
836
  };
591
837
  reviews: {
592
- provider: "native" | "custom";
593
- config?: Record<string, unknown> | undefined;
838
+ provider: string;
594
839
  package?: string | undefined;
840
+ config?: Record<string, unknown> | undefined;
595
841
  };
596
842
  search: {
597
- provider: "native" | "custom";
598
- config?: Record<string, unknown> | undefined;
843
+ provider: string;
599
844
  package?: string | undefined;
845
+ config?: Record<string, unknown> | undefined;
600
846
  };
601
847
  analytics: {
602
- provider: "native" | "custom";
603
- config?: Record<string, unknown> | undefined;
848
+ provider: string;
604
849
  package?: string | undefined;
850
+ config?: Record<string, unknown> | undefined;
605
851
  };
606
852
  shipping: {
607
- provider: "native" | "custom";
608
- config?: Record<string, unknown> | undefined;
853
+ provider: string;
609
854
  package?: string | undefined;
855
+ config?: Record<string, unknown> | undefined;
610
856
  };
611
857
  tax: {
612
- provider: "native" | "custom";
613
- config?: Record<string, unknown> | undefined;
858
+ provider: string;
614
859
  package?: string | undefined;
860
+ config?: Record<string, unknown> | undefined;
615
861
  };
616
862
  ai: {
617
- provider: "custom" | "none" | "anthropic";
618
- config?: Record<string, unknown> | undefined;
863
+ provider: string;
619
864
  package?: string | undefined;
865
+ config?: Record<string, unknown> | undefined;
620
866
  };
621
867
  orders: {
622
868
  numberPrefix: string;
623
869
  numberStart: number;
870
+ keyLifetime: {
871
+ email: string;
872
+ checkout: string;
873
+ };
624
874
  };
625
875
  }, {
626
876
  payments: {
627
- provider: "native" | "stripe" | "custom";
628
- config?: Record<string, unknown> | undefined;
877
+ provider: string;
629
878
  package?: string | undefined;
879
+ config?: Record<string, unknown> | undefined;
630
880
  };
631
881
  email: {
632
- provider: "native" | "custom" | "smtp";
633
- config?: Record<string, unknown> | undefined;
882
+ provider: string;
634
883
  package?: string | undefined;
884
+ config?: Record<string, unknown> | undefined;
635
885
  };
636
886
  reviews: {
637
- provider: "native" | "custom";
638
- config?: Record<string, unknown> | undefined;
887
+ provider: string;
639
888
  package?: string | undefined;
889
+ config?: Record<string, unknown> | undefined;
640
890
  };
641
891
  search: {
642
- provider: "native" | "custom";
643
- config?: Record<string, unknown> | undefined;
892
+ provider: string;
644
893
  package?: string | undefined;
894
+ config?: Record<string, unknown> | undefined;
645
895
  };
646
896
  analytics: {
647
- provider: "native" | "custom";
648
- config?: Record<string, unknown> | undefined;
897
+ provider: string;
649
898
  package?: string | undefined;
899
+ config?: Record<string, unknown> | undefined;
650
900
  };
651
901
  shipping: {
652
- provider: "native" | "custom";
653
- config?: Record<string, unknown> | undefined;
902
+ provider: string;
654
903
  package?: string | undefined;
904
+ config?: Record<string, unknown> | undefined;
655
905
  };
656
906
  tax: {
657
- provider: "native" | "custom";
658
- config?: Record<string, unknown> | undefined;
907
+ provider: string;
659
908
  package?: string | undefined;
909
+ config?: Record<string, unknown> | undefined;
660
910
  };
661
911
  ai: {
662
- provider: "custom" | "none" | "anthropic";
663
- config?: Record<string, unknown> | undefined;
912
+ provider: string;
664
913
  package?: string | undefined;
914
+ config?: Record<string, unknown> | undefined;
665
915
  };
666
916
  orders?: {
667
917
  numberPrefix?: string | undefined;
668
918
  numberStart?: number | undefined;
919
+ keyLifetime?: {
920
+ email?: string | undefined;
921
+ checkout?: string | undefined;
922
+ } | undefined;
669
923
  } | undefined;
670
924
  }>;
671
925
  declare const httpSchema: z.ZodObject<{
672
926
  adapter: z.ZodDefault<z.ZodEnum<["fastify", "hono"]>>;
673
927
  port: z.ZodDefault<z.ZodNumber>;
674
928
  host: z.ZodDefault<z.ZodString>;
675
- /** Whether `X-Forwarded-For` sets the client IP the rate limiter keys on; only behind a proxy you run. */
676
- 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]>>;
677
936
  cors: z.ZodDefault<z.ZodObject<{
678
937
  allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
679
938
  credentials: z.ZodDefault<z.ZodBoolean>;
@@ -688,7 +947,7 @@ declare const httpSchema: z.ZodObject<{
688
947
  adapter: "fastify" | "hono";
689
948
  port: number;
690
949
  host: string;
691
- trustProxy: boolean;
950
+ trustProxy: number | boolean;
692
951
  cors: {
693
952
  allowedOrigins: string[];
694
953
  credentials: boolean;
@@ -697,7 +956,7 @@ declare const httpSchema: z.ZodObject<{
697
956
  adapter?: "fastify" | "hono" | undefined;
698
957
  port?: number | undefined;
699
958
  host?: string | undefined;
700
- trustProxy?: boolean | undefined;
959
+ trustProxy?: number | boolean | undefined;
701
960
  cors?: {
702
961
  allowedOrigins?: string[] | undefined;
703
962
  credentials?: boolean | undefined;
@@ -810,23 +1069,93 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
810
1069
  currency: z.ZodString;
811
1070
  locale: z.ZodString;
812
1071
  timezone: z.ZodString;
1072
+ /** The storefront's public URL, which the order email links from; with none, the email has no link. */
1073
+ url: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
813
1074
  }, "strip", z.ZodTypeAny, {
814
1075
  name: string;
815
1076
  currency: string;
816
1077
  locale: string;
817
1078
  timezone: string;
1079
+ url?: string | undefined;
818
1080
  }, {
819
1081
  name: string;
820
1082
  currency: string;
821
1083
  locale: string;
822
1084
  timezone: string;
1085
+ url?: string | undefined;
823
1086
  }>;
824
1087
  template: z.ZodEnum<["astro", "nextjs"]>;
825
1088
  infrastructure: z.ZodEffects<z.ZodObject<{
826
1089
  commandStore: z.ZodEnum<["sqlite", "postgres"]>;
827
- documentStore: z.ZodEnum<["in-memory", "redis", "postgres-jsonb"]>;
828
- eventBus: z.ZodEnum<["in-process", "redis-streams"]>;
829
- 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
+ }>>;
830
1159
  redis: z.ZodOptional<z.ZodObject<{
831
1160
  /** Defaults to `REDIS_URL`. */
832
1161
  url: z.ZodOptional<z.ZodString>;
@@ -880,15 +1209,27 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
880
1209
  forcePathStyle?: boolean | undefined;
881
1210
  }>>;
882
1211
  }, "strict", z.ZodTypeAny, {
883
- commandStore: "sqlite" | "postgres";
884
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
885
- eventBus: "in-process" | "redis-streams";
886
- media: "local-fs" | "s3";
887
- redis?: {
888
- url?: string | undefined;
889
- prefix?: string | undefined;
890
- ackTimeoutMs?: number | undefined;
891
- claimIdleMs?: number | undefined;
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
+ };
1227
+ commandStore: "sqlite" | "postgres";
1228
+ redis?: {
1229
+ url?: string | undefined;
1230
+ prefix?: string | undefined;
1231
+ ackTimeoutMs?: number | undefined;
1232
+ claimIdleMs?: number | undefined;
892
1233
  streamMaxLen?: number | undefined;
893
1234
  } | undefined;
894
1235
  s3?: {
@@ -900,9 +1241,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
900
1241
  forcePathStyle?: boolean | undefined;
901
1242
  } | undefined;
902
1243
  }, {
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
+ };
903
1254
  commandStore: "sqlite" | "postgres";
904
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
905
- eventBus: "in-process" | "redis-streams";
1255
+ media?: {
1256
+ provider: string;
1257
+ package?: string | undefined;
1258
+ config?: Record<string, unknown> | undefined;
1259
+ } | undefined;
906
1260
  redis?: {
907
1261
  url?: string | undefined;
908
1262
  prefix?: string | undefined;
@@ -910,7 +1264,6 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
910
1264
  claimIdleMs?: number | undefined;
911
1265
  streamMaxLen?: number | undefined;
912
1266
  } | undefined;
913
- media?: "local-fs" | "s3" | undefined;
914
1267
  s3?: {
915
1268
  prefix?: string | undefined;
916
1269
  bucket?: string | undefined;
@@ -920,10 +1273,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
920
1273
  forcePathStyle?: boolean | undefined;
921
1274
  } | undefined;
922
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
+ };
923
1291
  commandStore: "sqlite" | "postgres";
924
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
925
- eventBus: "in-process" | "redis-streams";
926
- media: "local-fs" | "s3";
927
1292
  redis?: {
928
1293
  url?: string | undefined;
929
1294
  prefix?: string | undefined;
@@ -940,9 +1305,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
940
1305
  forcePathStyle?: boolean | undefined;
941
1306
  } | undefined;
942
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
+ };
943
1318
  commandStore: "sqlite" | "postgres";
944
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
945
- eventBus: "in-process" | "redis-streams";
1319
+ media?: {
1320
+ provider: string;
1321
+ package?: string | undefined;
1322
+ config?: Record<string, unknown> | undefined;
1323
+ } | undefined;
946
1324
  redis?: {
947
1325
  url?: string | undefined;
948
1326
  prefix?: string | undefined;
@@ -950,7 +1328,6 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
950
1328
  claimIdleMs?: number | undefined;
951
1329
  streamMaxLen?: number | undefined;
952
1330
  } | undefined;
953
- media?: "local-fs" | "s3" | undefined;
954
1331
  s3?: {
955
1332
  prefix?: string | undefined;
956
1333
  bucket?: string | undefined;
@@ -961,19 +1338,28 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
961
1338
  } | undefined;
962
1339
  }>;
963
1340
  security: z.ZodEffects<z.ZodObject<{
964
- 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>>;
965
1347
  rateLimit: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
966
1348
  requests: z.ZodNumber;
967
1349
  window: z.ZodString;
968
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>;
969
1353
  }, "strip", z.ZodTypeAny, {
970
1354
  requests: number;
971
1355
  window: string;
972
1356
  action: "block" | "challenge" | "throttle";
1357
+ header?: string | undefined;
973
1358
  }, {
974
1359
  requests: number;
975
1360
  window: string;
976
1361
  action: "block" | "challenge" | "throttle";
1362
+ header?: string | undefined;
977
1363
  }>>>;
978
1364
  botProtection: z.ZodDefault<z.ZodObject<{
979
1365
  mode: z.ZodDefault<z.ZodEnum<["off", "managed", "strict"]>>;
@@ -1051,11 +1437,12 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1051
1437
  }>, "many">>;
1052
1438
  managedRulesets: z.ZodDefault<z.ZodArray<z.ZodEnum<["cloudflare", "owasp"]>, "many">>;
1053
1439
  }, "strip", z.ZodTypeAny, {
1054
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1440
+ adapter: string;
1055
1441
  rateLimit: Record<string, {
1056
1442
  requests: number;
1057
1443
  window: string;
1058
1444
  action: "block" | "challenge" | "throttle";
1445
+ header?: string | undefined;
1059
1446
  }>;
1060
1447
  botProtection: {
1061
1448
  mode: "strict" | "off" | "managed";
@@ -1082,22 +1469,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1082
1469
  expression: string;
1083
1470
  }[];
1084
1471
  managedRulesets: ("cloudflare" | "owasp")[];
1472
+ package?: string | undefined;
1473
+ config?: Record<string, unknown> | undefined;
1085
1474
  cloudflare?: {
1086
1475
  zoneId?: string | undefined;
1087
1476
  apiToken?: string | undefined;
1088
1477
  apiBase?: string | undefined;
1089
1478
  } | undefined;
1090
1479
  }, {
1091
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1092
- cloudflare?: {
1093
- zoneId?: string | undefined;
1094
- apiToken?: string | undefined;
1095
- apiBase?: string | undefined;
1096
- } | undefined;
1480
+ adapter: string;
1481
+ package?: string | undefined;
1482
+ config?: Record<string, unknown> | undefined;
1097
1483
  rateLimit?: Record<string, {
1098
1484
  requests: number;
1099
1485
  window: string;
1100
1486
  action: "block" | "challenge" | "throttle";
1487
+ header?: string | undefined;
1101
1488
  }> | undefined;
1102
1489
  botProtection?: {
1103
1490
  mode?: "strict" | "off" | "managed" | undefined;
@@ -1115,6 +1502,11 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1115
1502
  accessTtl?: string | undefined;
1116
1503
  refreshTtl?: string | undefined;
1117
1504
  } | undefined;
1505
+ cloudflare?: {
1506
+ zoneId?: string | undefined;
1507
+ apiToken?: string | undefined;
1508
+ apiBase?: string | undefined;
1509
+ } | undefined;
1118
1510
  geo?: {
1119
1511
  block?: string[] | undefined;
1120
1512
  } | undefined;
@@ -1125,11 +1517,12 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1125
1517
  }[] | undefined;
1126
1518
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
1127
1519
  }>, {
1128
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1520
+ adapter: string;
1129
1521
  rateLimit: Record<string, {
1130
1522
  requests: number;
1131
1523
  window: string;
1132
1524
  action: "block" | "challenge" | "throttle";
1525
+ header?: string | undefined;
1133
1526
  }>;
1134
1527
  botProtection: {
1135
1528
  mode: "strict" | "off" | "managed";
@@ -1156,22 +1549,22 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1156
1549
  expression: string;
1157
1550
  }[];
1158
1551
  managedRulesets: ("cloudflare" | "owasp")[];
1552
+ package?: string | undefined;
1553
+ config?: Record<string, unknown> | undefined;
1159
1554
  cloudflare?: {
1160
1555
  zoneId?: string | undefined;
1161
1556
  apiToken?: string | undefined;
1162
1557
  apiBase?: string | undefined;
1163
1558
  } | undefined;
1164
1559
  }, {
1165
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1166
- cloudflare?: {
1167
- zoneId?: string | undefined;
1168
- apiToken?: string | undefined;
1169
- apiBase?: string | undefined;
1170
- } | undefined;
1560
+ adapter: string;
1561
+ package?: string | undefined;
1562
+ config?: Record<string, unknown> | undefined;
1171
1563
  rateLimit?: Record<string, {
1172
1564
  requests: number;
1173
1565
  window: string;
1174
1566
  action: "block" | "challenge" | "throttle";
1567
+ header?: string | undefined;
1175
1568
  }> | undefined;
1176
1569
  botProtection?: {
1177
1570
  mode?: "strict" | "off" | "managed" | undefined;
@@ -1189,6 +1582,11 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1189
1582
  accessTtl?: string | undefined;
1190
1583
  refreshTtl?: string | undefined;
1191
1584
  } | undefined;
1585
+ cloudflare?: {
1586
+ zoneId?: string | undefined;
1587
+ apiToken?: string | undefined;
1588
+ apiBase?: string | undefined;
1589
+ } | undefined;
1192
1590
  geo?: {
1193
1591
  block?: string[] | undefined;
1194
1592
  } | undefined;
@@ -1200,225 +1598,345 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1200
1598
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
1201
1599
  }>;
1202
1600
  commerce: z.ZodObject<{
1203
- payments: z.ZodObject<{
1204
- provider: z.ZodEnum<["native", "stripe", "custom"]>;
1601
+ payments: z.ZodEffects<z.ZodObject<{
1602
+ provider: z.ZodEffects<z.ZodString, string, string>;
1205
1603
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1206
- /** 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
+ */
1207
1608
  package: z.ZodOptional<z.ZodString>;
1208
1609
  }, "strip", z.ZodTypeAny, {
1209
- provider: "native" | "stripe" | "custom";
1210
- config?: Record<string, unknown> | undefined;
1610
+ provider: string;
1211
1611
  package?: string | undefined;
1612
+ config?: Record<string, unknown> | undefined;
1212
1613
  }, {
1213
- provider: "native" | "stripe" | "custom";
1614
+ provider: string;
1615
+ package?: string | undefined;
1214
1616
  config?: Record<string, unknown> | undefined;
1617
+ }>, {
1618
+ provider: string;
1215
1619
  package?: string | undefined;
1620
+ config?: Record<string, unknown> | undefined;
1621
+ }, {
1622
+ provider: string;
1623
+ package?: string | undefined;
1624
+ config?: Record<string, unknown> | undefined;
1216
1625
  }>;
1217
- email: z.ZodObject<{
1218
- provider: z.ZodEnum<["native", "smtp", "custom"]>;
1626
+ email: z.ZodEffects<z.ZodObject<{
1627
+ provider: z.ZodEffects<z.ZodString, string, string>;
1219
1628
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1220
- /** 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
+ */
1221
1633
  package: z.ZodOptional<z.ZodString>;
1222
1634
  }, "strip", z.ZodTypeAny, {
1223
- provider: "native" | "custom" | "smtp";
1224
- config?: Record<string, unknown> | undefined;
1635
+ provider: string;
1225
1636
  package?: string | undefined;
1637
+ config?: Record<string, unknown> | undefined;
1226
1638
  }, {
1227
- 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;
1228
1645
  config?: Record<string, unknown> | undefined;
1646
+ }, {
1647
+ provider: string;
1229
1648
  package?: string | undefined;
1649
+ config?: Record<string, unknown> | undefined;
1230
1650
  }>;
1231
- reviews: z.ZodObject<{
1232
- provider: z.ZodEnum<["native", "custom"]>;
1651
+ reviews: z.ZodEffects<z.ZodObject<{
1652
+ provider: z.ZodEffects<z.ZodString, string, string>;
1233
1653
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1234
- /** 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
+ */
1235
1658
  package: z.ZodOptional<z.ZodString>;
1236
1659
  }, "strip", z.ZodTypeAny, {
1237
- provider: "native" | "custom";
1238
- config?: Record<string, unknown> | undefined;
1660
+ provider: string;
1239
1661
  package?: string | undefined;
1662
+ config?: Record<string, unknown> | undefined;
1240
1663
  }, {
1241
- provider: "native" | "custom";
1664
+ provider: string;
1665
+ package?: string | undefined;
1242
1666
  config?: Record<string, unknown> | undefined;
1667
+ }>, {
1668
+ provider: string;
1243
1669
  package?: string | undefined;
1670
+ config?: Record<string, unknown> | undefined;
1671
+ }, {
1672
+ provider: string;
1673
+ package?: string | undefined;
1674
+ config?: Record<string, unknown> | undefined;
1244
1675
  }>;
1245
- search: z.ZodObject<{
1246
- provider: z.ZodEnum<["native", "custom"]>;
1676
+ search: z.ZodEffects<z.ZodObject<{
1677
+ provider: z.ZodEffects<z.ZodString, string, string>;
1247
1678
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1248
- /** 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
+ */
1249
1683
  package: z.ZodOptional<z.ZodString>;
1250
1684
  }, "strip", z.ZodTypeAny, {
1251
- provider: "native" | "custom";
1252
- config?: Record<string, unknown> | undefined;
1685
+ provider: string;
1253
1686
  package?: string | undefined;
1687
+ config?: Record<string, unknown> | undefined;
1254
1688
  }, {
1255
- provider: "native" | "custom";
1689
+ provider: string;
1690
+ package?: string | undefined;
1691
+ config?: Record<string, unknown> | undefined;
1692
+ }>, {
1693
+ provider: string;
1694
+ package?: string | undefined;
1256
1695
  config?: Record<string, unknown> | undefined;
1696
+ }, {
1697
+ provider: string;
1257
1698
  package?: string | undefined;
1699
+ config?: Record<string, unknown> | undefined;
1258
1700
  }>;
1259
- analytics: z.ZodObject<{
1260
- provider: z.ZodEnum<["native", "custom"]>;
1701
+ analytics: z.ZodEffects<z.ZodObject<{
1702
+ provider: z.ZodEffects<z.ZodString, string, string>;
1261
1703
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1262
- /** 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
+ */
1263
1708
  package: z.ZodOptional<z.ZodString>;
1264
1709
  }, "strip", z.ZodTypeAny, {
1265
- provider: "native" | "custom";
1266
- config?: Record<string, unknown> | undefined;
1710
+ provider: string;
1267
1711
  package?: string | undefined;
1712
+ config?: Record<string, unknown> | undefined;
1268
1713
  }, {
1269
- provider: "native" | "custom";
1714
+ provider: string;
1715
+ package?: string | undefined;
1716
+ config?: Record<string, unknown> | undefined;
1717
+ }>, {
1718
+ provider: string;
1719
+ package?: string | undefined;
1270
1720
  config?: Record<string, unknown> | undefined;
1721
+ }, {
1722
+ provider: string;
1271
1723
  package?: string | undefined;
1724
+ config?: Record<string, unknown> | undefined;
1272
1725
  }>;
1273
- shipping: z.ZodObject<{
1274
- provider: z.ZodEnum<["native", "custom"]>;
1726
+ shipping: z.ZodEffects<z.ZodObject<{
1727
+ provider: z.ZodEffects<z.ZodString, string, string>;
1275
1728
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1276
- /** 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
+ */
1277
1733
  package: z.ZodOptional<z.ZodString>;
1278
1734
  }, "strip", z.ZodTypeAny, {
1279
- provider: "native" | "custom";
1280
- config?: Record<string, unknown> | undefined;
1735
+ provider: string;
1281
1736
  package?: string | undefined;
1737
+ config?: Record<string, unknown> | undefined;
1282
1738
  }, {
1283
- provider: "native" | "custom";
1739
+ provider: string;
1740
+ package?: string | undefined;
1284
1741
  config?: Record<string, unknown> | undefined;
1742
+ }>, {
1743
+ provider: string;
1285
1744
  package?: string | undefined;
1745
+ config?: Record<string, unknown> | undefined;
1746
+ }, {
1747
+ provider: string;
1748
+ package?: string | undefined;
1749
+ config?: Record<string, unknown> | undefined;
1286
1750
  }>;
1287
- tax: z.ZodObject<{
1288
- provider: z.ZodEnum<["native", "custom"]>;
1751
+ tax: z.ZodEffects<z.ZodObject<{
1752
+ provider: z.ZodEffects<z.ZodString, string, string>;
1289
1753
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1290
- /** 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
+ */
1291
1758
  package: z.ZodOptional<z.ZodString>;
1292
1759
  }, "strip", z.ZodTypeAny, {
1293
- provider: "native" | "custom";
1294
- config?: Record<string, unknown> | undefined;
1760
+ provider: string;
1295
1761
  package?: string | undefined;
1762
+ config?: Record<string, unknown> | undefined;
1296
1763
  }, {
1297
- provider: "native" | "custom";
1764
+ provider: string;
1765
+ package?: string | undefined;
1298
1766
  config?: Record<string, unknown> | undefined;
1767
+ }>, {
1768
+ provider: string;
1299
1769
  package?: string | undefined;
1770
+ config?: Record<string, unknown> | undefined;
1771
+ }, {
1772
+ provider: string;
1773
+ package?: string | undefined;
1774
+ config?: Record<string, unknown> | undefined;
1300
1775
  }>;
1301
- ai: z.ZodObject<{
1302
- provider: z.ZodEnum<["none", "anthropic", "custom"]>;
1776
+ ai: z.ZodEffects<z.ZodObject<{
1777
+ provider: z.ZodEffects<z.ZodString, string, string>;
1303
1778
  config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1304
- /** 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
+ */
1305
1783
  package: z.ZodOptional<z.ZodString>;
1306
1784
  }, "strip", z.ZodTypeAny, {
1307
- provider: "custom" | "none" | "anthropic";
1308
- config?: Record<string, unknown> | undefined;
1785
+ provider: string;
1309
1786
  package?: string | undefined;
1787
+ config?: Record<string, unknown> | undefined;
1310
1788
  }, {
1311
- provider: "custom" | "none" | "anthropic";
1789
+ provider: string;
1790
+ package?: string | undefined;
1312
1791
  config?: Record<string, unknown> | undefined;
1792
+ }>, {
1793
+ provider: string;
1313
1794
  package?: string | undefined;
1795
+ config?: Record<string, unknown> | undefined;
1796
+ }, {
1797
+ provider: string;
1798
+ package?: string | undefined;
1799
+ config?: Record<string, unknown> | undefined;
1314
1800
  }>;
1315
1801
  orders: z.ZodDefault<z.ZodObject<{
1316
1802
  numberPrefix: z.ZodDefault<z.ZodString>;
1317
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
+ }>>;
1318
1815
  }, "strip", z.ZodTypeAny, {
1319
1816
  numberPrefix: string;
1320
1817
  numberStart: number;
1818
+ keyLifetime: {
1819
+ email: string;
1820
+ checkout: string;
1821
+ };
1321
1822
  }, {
1322
1823
  numberPrefix?: string | undefined;
1323
1824
  numberStart?: number | undefined;
1825
+ keyLifetime?: {
1826
+ email?: string | undefined;
1827
+ checkout?: string | undefined;
1828
+ } | undefined;
1324
1829
  }>>;
1325
1830
  }, "strip", z.ZodTypeAny, {
1326
1831
  payments: {
1327
- provider: "native" | "stripe" | "custom";
1328
- config?: Record<string, unknown> | undefined;
1832
+ provider: string;
1329
1833
  package?: string | undefined;
1834
+ config?: Record<string, unknown> | undefined;
1330
1835
  };
1331
1836
  email: {
1332
- provider: "native" | "custom" | "smtp";
1333
- config?: Record<string, unknown> | undefined;
1837
+ provider: string;
1334
1838
  package?: string | undefined;
1839
+ config?: Record<string, unknown> | undefined;
1335
1840
  };
1336
1841
  reviews: {
1337
- provider: "native" | "custom";
1338
- config?: Record<string, unknown> | undefined;
1842
+ provider: string;
1339
1843
  package?: string | undefined;
1844
+ config?: Record<string, unknown> | undefined;
1340
1845
  };
1341
1846
  search: {
1342
- provider: "native" | "custom";
1343
- config?: Record<string, unknown> | undefined;
1847
+ provider: string;
1344
1848
  package?: string | undefined;
1849
+ config?: Record<string, unknown> | undefined;
1345
1850
  };
1346
1851
  analytics: {
1347
- provider: "native" | "custom";
1348
- config?: Record<string, unknown> | undefined;
1852
+ provider: string;
1349
1853
  package?: string | undefined;
1854
+ config?: Record<string, unknown> | undefined;
1350
1855
  };
1351
1856
  shipping: {
1352
- provider: "native" | "custom";
1353
- config?: Record<string, unknown> | undefined;
1857
+ provider: string;
1354
1858
  package?: string | undefined;
1859
+ config?: Record<string, unknown> | undefined;
1355
1860
  };
1356
1861
  tax: {
1357
- provider: "native" | "custom";
1358
- config?: Record<string, unknown> | undefined;
1862
+ provider: string;
1359
1863
  package?: string | undefined;
1864
+ config?: Record<string, unknown> | undefined;
1360
1865
  };
1361
1866
  ai: {
1362
- provider: "custom" | "none" | "anthropic";
1363
- config?: Record<string, unknown> | undefined;
1867
+ provider: string;
1364
1868
  package?: string | undefined;
1869
+ config?: Record<string, unknown> | undefined;
1365
1870
  };
1366
1871
  orders: {
1367
1872
  numberPrefix: string;
1368
1873
  numberStart: number;
1874
+ keyLifetime: {
1875
+ email: string;
1876
+ checkout: string;
1877
+ };
1369
1878
  };
1370
1879
  }, {
1371
1880
  payments: {
1372
- provider: "native" | "stripe" | "custom";
1373
- config?: Record<string, unknown> | undefined;
1881
+ provider: string;
1374
1882
  package?: string | undefined;
1883
+ config?: Record<string, unknown> | undefined;
1375
1884
  };
1376
1885
  email: {
1377
- provider: "native" | "custom" | "smtp";
1378
- config?: Record<string, unknown> | undefined;
1886
+ provider: string;
1379
1887
  package?: string | undefined;
1888
+ config?: Record<string, unknown> | undefined;
1380
1889
  };
1381
1890
  reviews: {
1382
- provider: "native" | "custom";
1383
- config?: Record<string, unknown> | undefined;
1891
+ provider: string;
1384
1892
  package?: string | undefined;
1893
+ config?: Record<string, unknown> | undefined;
1385
1894
  };
1386
1895
  search: {
1387
- provider: "native" | "custom";
1388
- config?: Record<string, unknown> | undefined;
1896
+ provider: string;
1389
1897
  package?: string | undefined;
1898
+ config?: Record<string, unknown> | undefined;
1390
1899
  };
1391
1900
  analytics: {
1392
- provider: "native" | "custom";
1393
- config?: Record<string, unknown> | undefined;
1901
+ provider: string;
1394
1902
  package?: string | undefined;
1903
+ config?: Record<string, unknown> | undefined;
1395
1904
  };
1396
1905
  shipping: {
1397
- provider: "native" | "custom";
1398
- config?: Record<string, unknown> | undefined;
1906
+ provider: string;
1399
1907
  package?: string | undefined;
1908
+ config?: Record<string, unknown> | undefined;
1400
1909
  };
1401
1910
  tax: {
1402
- provider: "native" | "custom";
1403
- config?: Record<string, unknown> | undefined;
1911
+ provider: string;
1404
1912
  package?: string | undefined;
1913
+ config?: Record<string, unknown> | undefined;
1405
1914
  };
1406
1915
  ai: {
1407
- provider: "custom" | "none" | "anthropic";
1408
- config?: Record<string, unknown> | undefined;
1916
+ provider: string;
1409
1917
  package?: string | undefined;
1918
+ config?: Record<string, unknown> | undefined;
1410
1919
  };
1411
1920
  orders?: {
1412
1921
  numberPrefix?: string | undefined;
1413
1922
  numberStart?: number | undefined;
1923
+ keyLifetime?: {
1924
+ email?: string | undefined;
1925
+ checkout?: string | undefined;
1926
+ } | undefined;
1414
1927
  } | undefined;
1415
1928
  }>;
1416
1929
  http: z.ZodObject<{
1417
1930
  adapter: z.ZodDefault<z.ZodEnum<["fastify", "hono"]>>;
1418
1931
  port: z.ZodDefault<z.ZodNumber>;
1419
1932
  host: z.ZodDefault<z.ZodString>;
1420
- /** Whether `X-Forwarded-For` sets the client IP the rate limiter keys on; only behind a proxy you run. */
1421
- 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]>>;
1422
1940
  cors: z.ZodDefault<z.ZodObject<{
1423
1941
  allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
1424
1942
  credentials: z.ZodDefault<z.ZodBoolean>;
@@ -1433,7 +1951,7 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1433
1951
  adapter: "fastify" | "hono";
1434
1952
  port: number;
1435
1953
  host: string;
1436
- trustProxy: boolean;
1954
+ trustProxy: number | boolean;
1437
1955
  cors: {
1438
1956
  allowedOrigins: string[];
1439
1957
  credentials: boolean;
@@ -1442,7 +1960,7 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1442
1960
  adapter?: "fastify" | "hono" | undefined;
1443
1961
  port?: number | undefined;
1444
1962
  host?: string | undefined;
1445
- trustProxy?: boolean | undefined;
1963
+ trustProxy?: number | boolean | undefined;
1446
1964
  cors?: {
1447
1965
  allowedOrigins?: string[] | undefined;
1448
1966
  credentials?: boolean | undefined;
@@ -1519,40 +2037,13 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1519
2037
  } | undefined;
1520
2038
  }>>;
1521
2039
  }, "strip", z.ZodTypeAny, {
1522
- store: {
1523
- name: string;
1524
- currency: string;
1525
- locale: string;
1526
- timezone: string;
1527
- };
1528
- template: "astro" | "nextjs";
1529
- infrastructure: {
1530
- commandStore: "sqlite" | "postgres";
1531
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
1532
- eventBus: "in-process" | "redis-streams";
1533
- media: "local-fs" | "s3";
1534
- redis?: {
1535
- url?: string | undefined;
1536
- prefix?: string | undefined;
1537
- ackTimeoutMs?: number | undefined;
1538
- claimIdleMs?: number | undefined;
1539
- streamMaxLen?: number | undefined;
1540
- } | undefined;
1541
- s3?: {
1542
- prefix?: string | undefined;
1543
- bucket?: string | undefined;
1544
- region?: string | undefined;
1545
- endpoint?: string | undefined;
1546
- publicUrl?: string | undefined;
1547
- forcePathStyle?: boolean | undefined;
1548
- } | undefined;
1549
- };
1550
2040
  security: {
1551
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
2041
+ adapter: string;
1552
2042
  rateLimit: Record<string, {
1553
2043
  requests: number;
1554
2044
  window: string;
1555
2045
  action: "block" | "challenge" | "throttle";
2046
+ header?: string | undefined;
1556
2047
  }>;
1557
2048
  botProtection: {
1558
2049
  mode: "strict" | "off" | "managed";
@@ -1579,63 +2070,110 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1579
2070
  expression: string;
1580
2071
  }[];
1581
2072
  managedRulesets: ("cloudflare" | "owasp")[];
2073
+ package?: string | undefined;
2074
+ config?: Record<string, unknown> | undefined;
1582
2075
  cloudflare?: {
1583
2076
  zoneId?: string | undefined;
1584
2077
  apiToken?: string | undefined;
1585
2078
  apiBase?: string | undefined;
1586
2079
  } | undefined;
1587
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
+ };
1588
2122
  commerce: {
1589
2123
  payments: {
1590
- provider: "native" | "stripe" | "custom";
1591
- config?: Record<string, unknown> | undefined;
2124
+ provider: string;
1592
2125
  package?: string | undefined;
2126
+ config?: Record<string, unknown> | undefined;
1593
2127
  };
1594
2128
  email: {
1595
- provider: "native" | "custom" | "smtp";
1596
- config?: Record<string, unknown> | undefined;
2129
+ provider: string;
1597
2130
  package?: string | undefined;
2131
+ config?: Record<string, unknown> | undefined;
1598
2132
  };
1599
2133
  reviews: {
1600
- provider: "native" | "custom";
1601
- config?: Record<string, unknown> | undefined;
2134
+ provider: string;
1602
2135
  package?: string | undefined;
2136
+ config?: Record<string, unknown> | undefined;
1603
2137
  };
1604
2138
  search: {
1605
- provider: "native" | "custom";
1606
- config?: Record<string, unknown> | undefined;
2139
+ provider: string;
1607
2140
  package?: string | undefined;
2141
+ config?: Record<string, unknown> | undefined;
1608
2142
  };
1609
2143
  analytics: {
1610
- provider: "native" | "custom";
1611
- config?: Record<string, unknown> | undefined;
2144
+ provider: string;
1612
2145
  package?: string | undefined;
2146
+ config?: Record<string, unknown> | undefined;
1613
2147
  };
1614
2148
  shipping: {
1615
- provider: "native" | "custom";
1616
- config?: Record<string, unknown> | undefined;
2149
+ provider: string;
1617
2150
  package?: string | undefined;
2151
+ config?: Record<string, unknown> | undefined;
1618
2152
  };
1619
2153
  tax: {
1620
- provider: "native" | "custom";
1621
- config?: Record<string, unknown> | undefined;
2154
+ provider: string;
1622
2155
  package?: string | undefined;
2156
+ config?: Record<string, unknown> | undefined;
1623
2157
  };
1624
2158
  ai: {
1625
- provider: "custom" | "none" | "anthropic";
1626
- config?: Record<string, unknown> | undefined;
2159
+ provider: string;
1627
2160
  package?: string | undefined;
2161
+ config?: Record<string, unknown> | undefined;
1628
2162
  };
1629
2163
  orders: {
1630
2164
  numberPrefix: string;
1631
2165
  numberStart: number;
2166
+ keyLifetime: {
2167
+ email: string;
2168
+ checkout: string;
2169
+ };
1632
2170
  };
1633
2171
  };
1634
2172
  http: {
1635
2173
  adapter: "fastify" | "hono";
1636
2174
  port: number;
1637
2175
  host: string;
1638
- trustProxy: boolean;
2176
+ trustProxy: number | boolean;
1639
2177
  cors: {
1640
2178
  allowedOrigins: string[];
1641
2179
  credentials: boolean;
@@ -1661,45 +2199,15 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1661
2199
  } | undefined;
1662
2200
  };
1663
2201
  }, {
1664
- store: {
1665
- name: string;
1666
- currency: string;
1667
- locale: string;
1668
- timezone: string;
1669
- };
1670
- template: "astro" | "nextjs";
1671
- infrastructure: {
1672
- commandStore: "sqlite" | "postgres";
1673
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
1674
- eventBus: "in-process" | "redis-streams";
1675
- redis?: {
1676
- url?: string | undefined;
1677
- prefix?: string | undefined;
1678
- ackTimeoutMs?: number | undefined;
1679
- claimIdleMs?: number | undefined;
1680
- streamMaxLen?: number | undefined;
1681
- } | undefined;
1682
- media?: "local-fs" | "s3" | undefined;
1683
- s3?: {
1684
- prefix?: string | undefined;
1685
- bucket?: string | undefined;
1686
- region?: string | undefined;
1687
- endpoint?: string | undefined;
1688
- publicUrl?: string | undefined;
1689
- forcePathStyle?: boolean | undefined;
1690
- } | undefined;
1691
- };
1692
2202
  security: {
1693
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1694
- cloudflare?: {
1695
- zoneId?: string | undefined;
1696
- apiToken?: string | undefined;
1697
- apiBase?: string | undefined;
1698
- } | undefined;
2203
+ adapter: string;
2204
+ package?: string | undefined;
2205
+ config?: Record<string, unknown> | undefined;
1699
2206
  rateLimit?: Record<string, {
1700
2207
  requests: number;
1701
2208
  window: string;
1702
2209
  action: "block" | "challenge" | "throttle";
2210
+ header?: string | undefined;
1703
2211
  }> | undefined;
1704
2212
  botProtection?: {
1705
2213
  mode?: "strict" | "off" | "managed" | undefined;
@@ -1717,6 +2225,11 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1717
2225
  accessTtl?: string | undefined;
1718
2226
  refreshTtl?: string | undefined;
1719
2227
  } | undefined;
2228
+ cloudflare?: {
2229
+ zoneId?: string | undefined;
2230
+ apiToken?: string | undefined;
2231
+ apiBase?: string | undefined;
2232
+ } | undefined;
1720
2233
  geo?: {
1721
2234
  block?: string[] | undefined;
1722
2235
  } | undefined;
@@ -1727,57 +2240,102 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1727
2240
  }[] | undefined;
1728
2241
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
1729
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
+ };
1730
2284
  commerce: {
1731
2285
  payments: {
1732
- provider: "native" | "stripe" | "custom";
1733
- config?: Record<string, unknown> | undefined;
2286
+ provider: string;
1734
2287
  package?: string | undefined;
2288
+ config?: Record<string, unknown> | undefined;
1735
2289
  };
1736
2290
  email: {
1737
- provider: "native" | "custom" | "smtp";
1738
- config?: Record<string, unknown> | undefined;
2291
+ provider: string;
1739
2292
  package?: string | undefined;
2293
+ config?: Record<string, unknown> | undefined;
1740
2294
  };
1741
2295
  reviews: {
1742
- provider: "native" | "custom";
1743
- config?: Record<string, unknown> | undefined;
2296
+ provider: string;
1744
2297
  package?: string | undefined;
2298
+ config?: Record<string, unknown> | undefined;
1745
2299
  };
1746
2300
  search: {
1747
- provider: "native" | "custom";
1748
- config?: Record<string, unknown> | undefined;
2301
+ provider: string;
1749
2302
  package?: string | undefined;
2303
+ config?: Record<string, unknown> | undefined;
1750
2304
  };
1751
2305
  analytics: {
1752
- provider: "native" | "custom";
1753
- config?: Record<string, unknown> | undefined;
2306
+ provider: string;
1754
2307
  package?: string | undefined;
2308
+ config?: Record<string, unknown> | undefined;
1755
2309
  };
1756
2310
  shipping: {
1757
- provider: "native" | "custom";
1758
- config?: Record<string, unknown> | undefined;
2311
+ provider: string;
1759
2312
  package?: string | undefined;
2313
+ config?: Record<string, unknown> | undefined;
1760
2314
  };
1761
2315
  tax: {
1762
- provider: "native" | "custom";
1763
- config?: Record<string, unknown> | undefined;
2316
+ provider: string;
1764
2317
  package?: string | undefined;
2318
+ config?: Record<string, unknown> | undefined;
1765
2319
  };
1766
2320
  ai: {
1767
- provider: "custom" | "none" | "anthropic";
1768
- config?: Record<string, unknown> | undefined;
2321
+ provider: string;
1769
2322
  package?: string | undefined;
2323
+ config?: Record<string, unknown> | undefined;
1770
2324
  };
1771
2325
  orders?: {
1772
2326
  numberPrefix?: string | undefined;
1773
2327
  numberStart?: number | undefined;
2328
+ keyLifetime?: {
2329
+ email?: string | undefined;
2330
+ checkout?: string | undefined;
2331
+ } | undefined;
1774
2332
  } | undefined;
1775
2333
  };
1776
2334
  http: {
1777
2335
  adapter?: "fastify" | "hono" | undefined;
1778
2336
  port?: number | undefined;
1779
2337
  host?: string | undefined;
1780
- trustProxy?: boolean | undefined;
2338
+ trustProxy?: number | boolean | undefined;
1781
2339
  cors?: {
1782
2340
  allowedOrigins?: string[] | undefined;
1783
2341
  credentials?: boolean | undefined;
@@ -1803,40 +2361,13 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1803
2361
  } | undefined;
1804
2362
  } | undefined;
1805
2363
  }>, {
1806
- store: {
1807
- name: string;
1808
- currency: string;
1809
- locale: string;
1810
- timezone: string;
1811
- };
1812
- template: "astro" | "nextjs";
1813
- infrastructure: {
1814
- commandStore: "sqlite" | "postgres";
1815
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
1816
- eventBus: "in-process" | "redis-streams";
1817
- media: "local-fs" | "s3";
1818
- redis?: {
1819
- url?: string | undefined;
1820
- prefix?: string | undefined;
1821
- ackTimeoutMs?: number | undefined;
1822
- claimIdleMs?: number | undefined;
1823
- streamMaxLen?: number | undefined;
1824
- } | undefined;
1825
- s3?: {
1826
- prefix?: string | undefined;
1827
- bucket?: string | undefined;
1828
- region?: string | undefined;
1829
- endpoint?: string | undefined;
1830
- publicUrl?: string | undefined;
1831
- forcePathStyle?: boolean | undefined;
1832
- } | undefined;
1833
- };
1834
2364
  security: {
1835
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
2365
+ adapter: string;
1836
2366
  rateLimit: Record<string, {
1837
2367
  requests: number;
1838
2368
  window: string;
1839
2369
  action: "block" | "challenge" | "throttle";
2370
+ header?: string | undefined;
1840
2371
  }>;
1841
2372
  botProtection: {
1842
2373
  mode: "strict" | "off" | "managed";
@@ -1863,63 +2394,110 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1863
2394
  expression: string;
1864
2395
  }[];
1865
2396
  managedRulesets: ("cloudflare" | "owasp")[];
2397
+ package?: string | undefined;
2398
+ config?: Record<string, unknown> | undefined;
1866
2399
  cloudflare?: {
1867
2400
  zoneId?: string | undefined;
1868
2401
  apiToken?: string | undefined;
1869
2402
  apiBase?: string | undefined;
1870
2403
  } | undefined;
1871
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
+ };
1872
2446
  commerce: {
1873
2447
  payments: {
1874
- provider: "native" | "stripe" | "custom";
1875
- config?: Record<string, unknown> | undefined;
2448
+ provider: string;
1876
2449
  package?: string | undefined;
2450
+ config?: Record<string, unknown> | undefined;
1877
2451
  };
1878
2452
  email: {
1879
- provider: "native" | "custom" | "smtp";
1880
- config?: Record<string, unknown> | undefined;
2453
+ provider: string;
1881
2454
  package?: string | undefined;
2455
+ config?: Record<string, unknown> | undefined;
1882
2456
  };
1883
2457
  reviews: {
1884
- provider: "native" | "custom";
1885
- config?: Record<string, unknown> | undefined;
2458
+ provider: string;
1886
2459
  package?: string | undefined;
2460
+ config?: Record<string, unknown> | undefined;
1887
2461
  };
1888
2462
  search: {
1889
- provider: "native" | "custom";
1890
- config?: Record<string, unknown> | undefined;
2463
+ provider: string;
1891
2464
  package?: string | undefined;
2465
+ config?: Record<string, unknown> | undefined;
1892
2466
  };
1893
2467
  analytics: {
1894
- provider: "native" | "custom";
1895
- config?: Record<string, unknown> | undefined;
2468
+ provider: string;
1896
2469
  package?: string | undefined;
2470
+ config?: Record<string, unknown> | undefined;
1897
2471
  };
1898
2472
  shipping: {
1899
- provider: "native" | "custom";
1900
- config?: Record<string, unknown> | undefined;
2473
+ provider: string;
1901
2474
  package?: string | undefined;
2475
+ config?: Record<string, unknown> | undefined;
1902
2476
  };
1903
2477
  tax: {
1904
- provider: "native" | "custom";
1905
- config?: Record<string, unknown> | undefined;
2478
+ provider: string;
1906
2479
  package?: string | undefined;
2480
+ config?: Record<string, unknown> | undefined;
1907
2481
  };
1908
2482
  ai: {
1909
- provider: "custom" | "none" | "anthropic";
1910
- config?: Record<string, unknown> | undefined;
2483
+ provider: string;
1911
2484
  package?: string | undefined;
2485
+ config?: Record<string, unknown> | undefined;
1912
2486
  };
1913
2487
  orders: {
1914
2488
  numberPrefix: string;
1915
2489
  numberStart: number;
2490
+ keyLifetime: {
2491
+ email: string;
2492
+ checkout: string;
2493
+ };
1916
2494
  };
1917
2495
  };
1918
2496
  http: {
1919
2497
  adapter: "fastify" | "hono";
1920
2498
  port: number;
1921
2499
  host: string;
1922
- trustProxy: boolean;
2500
+ trustProxy: number | boolean;
1923
2501
  cors: {
1924
2502
  allowedOrigins: string[];
1925
2503
  credentials: boolean;
@@ -1945,45 +2523,15 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
1945
2523
  } | undefined;
1946
2524
  };
1947
2525
  }, {
1948
- store: {
1949
- name: string;
1950
- currency: string;
1951
- locale: string;
1952
- timezone: string;
1953
- };
1954
- template: "astro" | "nextjs";
1955
- infrastructure: {
1956
- commandStore: "sqlite" | "postgres";
1957
- documentStore: "in-memory" | "redis" | "postgres-jsonb";
1958
- eventBus: "in-process" | "redis-streams";
1959
- redis?: {
1960
- url?: string | undefined;
1961
- prefix?: string | undefined;
1962
- ackTimeoutMs?: number | undefined;
1963
- claimIdleMs?: number | undefined;
1964
- streamMaxLen?: number | undefined;
1965
- } | undefined;
1966
- media?: "local-fs" | "s3" | undefined;
1967
- s3?: {
1968
- prefix?: string | undefined;
1969
- bucket?: string | undefined;
1970
- region?: string | undefined;
1971
- endpoint?: string | undefined;
1972
- publicUrl?: string | undefined;
1973
- forcePathStyle?: boolean | undefined;
1974
- } | undefined;
1975
- };
1976
2526
  security: {
1977
- adapter: "middleware" | "cloudflare" | "aws-waf" | "akamai";
1978
- cloudflare?: {
1979
- zoneId?: string | undefined;
1980
- apiToken?: string | undefined;
1981
- apiBase?: string | undefined;
1982
- } | undefined;
2527
+ adapter: string;
2528
+ package?: string | undefined;
2529
+ config?: Record<string, unknown> | undefined;
1983
2530
  rateLimit?: Record<string, {
1984
2531
  requests: number;
1985
2532
  window: string;
1986
2533
  action: "block" | "challenge" | "throttle";
2534
+ header?: string | undefined;
1987
2535
  }> | undefined;
1988
2536
  botProtection?: {
1989
2537
  mode?: "strict" | "off" | "managed" | undefined;
@@ -2001,6 +2549,11 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
2001
2549
  accessTtl?: string | undefined;
2002
2550
  refreshTtl?: string | undefined;
2003
2551
  } | undefined;
2552
+ cloudflare?: {
2553
+ zoneId?: string | undefined;
2554
+ apiToken?: string | undefined;
2555
+ apiBase?: string | undefined;
2556
+ } | undefined;
2004
2557
  geo?: {
2005
2558
  block?: string[] | undefined;
2006
2559
  } | undefined;
@@ -2011,57 +2564,102 @@ declare const nymbalConfigSchema: z.ZodEffects<z.ZodObject<{
2011
2564
  }[] | undefined;
2012
2565
  managedRulesets?: ("cloudflare" | "owasp")[] | undefined;
2013
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
+ };
2014
2608
  commerce: {
2015
2609
  payments: {
2016
- provider: "native" | "stripe" | "custom";
2017
- config?: Record<string, unknown> | undefined;
2610
+ provider: string;
2018
2611
  package?: string | undefined;
2612
+ config?: Record<string, unknown> | undefined;
2019
2613
  };
2020
2614
  email: {
2021
- provider: "native" | "custom" | "smtp";
2022
- config?: Record<string, unknown> | undefined;
2615
+ provider: string;
2023
2616
  package?: string | undefined;
2617
+ config?: Record<string, unknown> | undefined;
2024
2618
  };
2025
2619
  reviews: {
2026
- provider: "native" | "custom";
2027
- config?: Record<string, unknown> | undefined;
2620
+ provider: string;
2028
2621
  package?: string | undefined;
2622
+ config?: Record<string, unknown> | undefined;
2029
2623
  };
2030
2624
  search: {
2031
- provider: "native" | "custom";
2032
- config?: Record<string, unknown> | undefined;
2625
+ provider: string;
2033
2626
  package?: string | undefined;
2627
+ config?: Record<string, unknown> | undefined;
2034
2628
  };
2035
2629
  analytics: {
2036
- provider: "native" | "custom";
2037
- config?: Record<string, unknown> | undefined;
2630
+ provider: string;
2038
2631
  package?: string | undefined;
2632
+ config?: Record<string, unknown> | undefined;
2039
2633
  };
2040
2634
  shipping: {
2041
- provider: "native" | "custom";
2042
- config?: Record<string, unknown> | undefined;
2635
+ provider: string;
2043
2636
  package?: string | undefined;
2637
+ config?: Record<string, unknown> | undefined;
2044
2638
  };
2045
2639
  tax: {
2046
- provider: "native" | "custom";
2047
- config?: Record<string, unknown> | undefined;
2640
+ provider: string;
2048
2641
  package?: string | undefined;
2642
+ config?: Record<string, unknown> | undefined;
2049
2643
  };
2050
2644
  ai: {
2051
- provider: "custom" | "none" | "anthropic";
2052
- config?: Record<string, unknown> | undefined;
2645
+ provider: string;
2053
2646
  package?: string | undefined;
2647
+ config?: Record<string, unknown> | undefined;
2054
2648
  };
2055
2649
  orders?: {
2056
2650
  numberPrefix?: string | undefined;
2057
2651
  numberStart?: number | undefined;
2652
+ keyLifetime?: {
2653
+ email?: string | undefined;
2654
+ checkout?: string | undefined;
2655
+ } | undefined;
2058
2656
  } | undefined;
2059
2657
  };
2060
2658
  http: {
2061
2659
  adapter?: "fastify" | "hono" | undefined;
2062
2660
  port?: number | undefined;
2063
2661
  host?: string | undefined;
2064
- trustProxy?: boolean | undefined;
2662
+ trustProxy?: number | boolean | undefined;
2065
2663
  cors?: {
2066
2664
  allowedOrigins?: string[] | undefined;
2067
2665
  credentials?: boolean | undefined;
@@ -2098,32 +2696,43 @@ declare function envNumber(key: string, defaultValue?: number): number;
2098
2696
  declare function envBool(key: string, defaultValue?: boolean): boolean;
2099
2697
 
2100
2698
  /**
2101
- * The providers each commerce slot accepts. A provider that needs an SDK lives in an `@nymbalhq/adapter-*` package the
2102
- * 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.
2103
2701
  */
2104
- declare const KNOWN_PROVIDERS: {
2105
- readonly payments: readonly ["native", "stripe", "custom"];
2106
- readonly email: readonly ["native", "smtp", "custom"];
2107
- readonly reviews: readonly ["native", "custom"];
2108
- readonly search: readonly ["native", "custom"];
2109
- readonly analytics: readonly ["native", "custom"];
2110
- readonly shipping: readonly ["native", "custom"];
2111
- readonly tax: readonly ["native", "custom"];
2112
- readonly ai: readonly ["none", "anthropic", "custom"];
2113
- };
2702
+ declare const KNOWN_PROVIDERS: Readonly<Record<CommerceSlot, readonly string[]>>;
2114
2703
 
2115
2704
  /**
2116
- * The values each infrastructure slot accepts: only what is built. `in-memory`, `in-process` and `local-fs` are the
2117
- * kernel's own; `redis`, `postgres-jsonb`, `redis-streams` and `s3` live in `@nymbalhq/*` packages the kernel loads
2118
- * 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.
2119
2722
  */
2120
- declare const KNOWN_INFRASTRUCTURE: {
2121
- readonly commandStore: readonly ["sqlite", "postgres"];
2122
- readonly documentStore: readonly ["in-memory", "redis", "postgres-jsonb"];
2123
- readonly eventBus: readonly ["in-process", "redis-streams"];
2124
- readonly media: readonly ["local-fs", "s3"];
2125
- };
2126
- 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';
2127
2736
  /** Keys that drove nothing and were removed; a config that still sets one is told to delete it. */
2128
2737
  declare const REMOVED_INFRASTRUCTURE_KEYS: readonly ["cloud", "compute"];
2129
2738
 
@@ -2137,5 +2746,5 @@ interface LoadedConfig {
2137
2746
  declare function findConfigFile(startDir: string): string | null;
2138
2747
  declare function loadConfig(startDir?: string): Promise<LoadedConfig>;
2139
2748
 
2140
- 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 };
2141
- 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 };