@endora-commerce/contracts 0.105.0 → 0.107.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.
Files changed (130) hide show
  1. package/dist/admin-contributions.d.ts +37 -6
  2. package/dist/admin-contributions.d.ts.map +1 -1
  3. package/dist/admin-contributions.js +37 -6
  4. package/dist/admin-contributions.js.map +1 -1
  5. package/dist/admin-roles.d.ts +32 -2
  6. package/dist/admin-roles.d.ts.map +1 -1
  7. package/dist/admin-roles.js +21 -1
  8. package/dist/admin-roles.js.map +1 -1
  9. package/dist/admin-search.d.ts +655 -0
  10. package/dist/admin-search.d.ts.map +1 -0
  11. package/dist/admin-search.js +179 -0
  12. package/dist/admin-search.js.map +1 -0
  13. package/dist/analytics.d.ts +5 -0
  14. package/dist/analytics.d.ts.map +1 -1
  15. package/dist/analytics.js +8 -0
  16. package/dist/analytics.js.map +1 -1
  17. package/dist/api-keys.d.ts +6 -0
  18. package/dist/api-keys.d.ts.map +1 -1
  19. package/dist/api-keys.js +5 -0
  20. package/dist/api-keys.js.map +1 -1
  21. package/dist/assets-library.d.ts +102 -0
  22. package/dist/assets-library.d.ts.map +1 -1
  23. package/dist/assets-library.js +89 -0
  24. package/dist/assets-library.js.map +1 -1
  25. package/dist/auth.d.ts +20 -0
  26. package/dist/auth.d.ts.map +1 -1
  27. package/dist/auth.js +20 -0
  28. package/dist/auth.js.map +1 -1
  29. package/dist/blog.d.ts +1 -1
  30. package/dist/carts.d.ts +21 -6
  31. package/dist/carts.d.ts.map +1 -1
  32. package/dist/catalog.d.ts +58 -6
  33. package/dist/catalog.d.ts.map +1 -1
  34. package/dist/catalog.js +31 -0
  35. package/dist/catalog.js.map +1 -1
  36. package/dist/cms.d.ts +183 -3
  37. package/dist/cms.d.ts.map +1 -1
  38. package/dist/cms.js +132 -1
  39. package/dist/cms.js.map +1 -1
  40. package/dist/comparisons.d.ts +73 -0
  41. package/dist/comparisons.d.ts.map +1 -1
  42. package/dist/comparisons.js +22 -0
  43. package/dist/comparisons.js.map +1 -1
  44. package/dist/credentials.d.ts +23 -0
  45. package/dist/credentials.d.ts.map +1 -1
  46. package/dist/credentials.js +24 -0
  47. package/dist/credentials.js.map +1 -1
  48. package/dist/crm.d.ts +1 -1
  49. package/dist/custom-fields.d.ts +3 -3
  50. package/dist/customer-accounts.d.ts +92 -2
  51. package/dist/customer-accounts.d.ts.map +1 -1
  52. package/dist/document-templates.d.ts +1192 -0
  53. package/dist/document-templates.d.ts.map +1 -0
  54. package/dist/document-templates.js +472 -0
  55. package/dist/document-templates.js.map +1 -0
  56. package/dist/document-values.d.ts +156 -0
  57. package/dist/document-values.d.ts.map +1 -0
  58. package/dist/document-values.js +208 -0
  59. package/dist/document-values.js.map +1 -0
  60. package/dist/errors.d.ts +98 -0
  61. package/dist/errors.d.ts.map +1 -1
  62. package/dist/errors.js +121 -0
  63. package/dist/errors.js.map +1 -1
  64. package/dist/import-export.d.ts +11 -0
  65. package/dist/import-export.d.ts.map +1 -1
  66. package/dist/import-export.js +9 -0
  67. package/dist/import-export.js.map +1 -1
  68. package/dist/index.d.ts +4 -1
  69. package/dist/index.d.ts.map +1 -1
  70. package/dist/index.js +12 -1
  71. package/dist/index.js.map +1 -1
  72. package/dist/invoice-ledger.d.ts +6 -6
  73. package/dist/invoices.d.ts +88 -0
  74. package/dist/invoices.d.ts.map +1 -1
  75. package/dist/invoices.js +12 -0
  76. package/dist/invoices.js.map +1 -1
  77. package/dist/mfa.d.ts +20 -0
  78. package/dist/mfa.d.ts.map +1 -1
  79. package/dist/modules.d.ts +21 -10
  80. package/dist/modules.d.ts.map +1 -1
  81. package/dist/newsletter.d.ts +2 -0
  82. package/dist/newsletter.d.ts.map +1 -1
  83. package/dist/newsletter.js +4 -0
  84. package/dist/newsletter.js.map +1 -1
  85. package/dist/orders.d.ts +32 -1
  86. package/dist/orders.d.ts.map +1 -1
  87. package/dist/orders.js +33 -17
  88. package/dist/orders.js.map +1 -1
  89. package/dist/organizations.d.ts +78 -0
  90. package/dist/organizations.d.ts.map +1 -1
  91. package/dist/organizations.js +54 -0
  92. package/dist/organizations.js.map +1 -1
  93. package/dist/payment-methods.d.ts +2 -2
  94. package/dist/price-lists.d.ts +491 -2
  95. package/dist/price-lists.d.ts.map +1 -1
  96. package/dist/price-lists.js +255 -0
  97. package/dist/price-lists.js.map +1 -1
  98. package/dist/product-feeds.d.ts +13 -13
  99. package/dist/prompt-actions.d.ts +25 -6
  100. package/dist/prompt-actions.d.ts.map +1 -1
  101. package/dist/prompt-actions.js +17 -1
  102. package/dist/prompt-actions.js.map +1 -1
  103. package/dist/pwa.d.ts +25 -0
  104. package/dist/pwa.d.ts.map +1 -1
  105. package/dist/pwa.js +38 -0
  106. package/dist/pwa.js.map +1 -1
  107. package/dist/quote-requests.d.ts +633 -8
  108. package/dist/quote-requests.d.ts.map +1 -1
  109. package/dist/quote-requests.js +365 -2
  110. package/dist/quote-requests.js.map +1 -1
  111. package/dist/sales-channels.d.ts +46 -0
  112. package/dist/sales-channels.d.ts.map +1 -1
  113. package/dist/sales-channels.js +40 -0
  114. package/dist/sales-channels.js.map +1 -1
  115. package/dist/saved-list-views.d.ts +140 -0
  116. package/dist/saved-list-views.d.ts.map +1 -0
  117. package/dist/saved-list-views.js +108 -0
  118. package/dist/saved-list-views.js.map +1 -0
  119. package/dist/search.d.ts +6 -0
  120. package/dist/search.d.ts.map +1 -1
  121. package/dist/seo.d.ts +324 -0
  122. package/dist/seo.d.ts.map +1 -1
  123. package/dist/seo.js +303 -0
  124. package/dist/seo.js.map +1 -1
  125. package/dist/settings.d.ts +19 -0
  126. package/dist/settings.d.ts.map +1 -1
  127. package/dist/settings.js +18 -0
  128. package/dist/settings.js.map +1 -1
  129. package/dist/shipping-methods.d.ts +2 -2
  130. package/package.json +1 -1
@@ -117,6 +117,7 @@ export declare const AdminZoneNameSchema: z.ZodEnum<{
117
117
  "order.entry.tabs": "order.entry.tabs";
118
118
  "ledger.section.tabs": "ledger.section.tabs";
119
119
  "category.content.editor": "category.content.editor";
120
+ "settings.setting.after": "settings.setting.after";
120
121
  }>;
121
122
  export type AdminZoneName = z.infer<typeof AdminZoneNameSchema>;
122
123
  /** A zone mounted once per product editor. */
@@ -307,6 +308,29 @@ export interface OrderEntryTabsZoneProps {
307
308
  */
308
309
  export interface LedgerSectionTabsZoneProps {
309
310
  }
311
+ /**
312
+ * A zone mounted below one setting's field on the Settings screen.
313
+ *
314
+ * `settingCode` and `ownerModule` are props **because they are matched on**:
315
+ * `match` compares by string value and a key the props do not carry never
316
+ * agrees.
317
+ *
318
+ * `draftText` is what is in the field **now**, saved or not, and `dirty` says
319
+ * which — so a contribution can follow the operator's typing and must say, in
320
+ * words, when what it shows is not yet in force.
321
+ */
322
+ export interface SettingsSettingAfterZoneProps {
323
+ /** The row's setting code, e.g. `seo.robots_txt_custom`. Matchable. */
324
+ readonly settingCode: string;
325
+ /** The module that declared the setting. Matchable. */
326
+ readonly ownerModule: string;
327
+ /** The sales channel being edited, or `null` for the all-channels value. */
328
+ readonly channelCode: string | null;
329
+ /** The field's current text, saved or not, for a string-typed setting; `null` otherwise. */
330
+ readonly draftText: string | null;
331
+ /** Whether `draftText` differs from what is stored. */
332
+ readonly dirty: boolean;
333
+ }
310
334
  /** A zone mounted beside one field of the product editor. */
311
335
  export interface ProductEditorFieldZoneProps {
312
336
  readonly productId: string;
@@ -368,6 +392,7 @@ export interface AdminZonePropsMap extends Record<AdminZoneName, object> {
368
392
  'order.entry.tabs': OrderEntryTabsZoneProps;
369
393
  'ledger.section.tabs': LedgerSectionTabsZoneProps;
370
394
  'category.content.editor': CategoryContentEditorZoneProps;
395
+ 'settings.setting.after': SettingsSettingAfterZoneProps;
371
396
  }
372
397
  /** The props of one zone, by name. */
373
398
  export type AdminZoneProps<Z extends AdminZoneName> = AdminZonePropsMap[Z];
@@ -505,6 +530,7 @@ export declare const AdminZoneContributionSchema: z.ZodObject<{
505
530
  "order.entry.tabs": "order.entry.tabs";
506
531
  "ledger.section.tabs": "ledger.section.tabs";
507
532
  "category.content.editor": "category.content.editor";
533
+ "settings.setting.after": "settings.setting.after";
508
534
  }>;
509
535
  weight: z.ZodNumber;
510
536
  requiredPermission: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -514,11 +540,14 @@ export declare const AdminZoneContributionSchema: z.ZodObject<{
514
540
  * The data half of an editor renderer for one Page Builder block in one editor
515
541
  * (`specs/141-module-block-renderers/contracts/block-renderers.md` §4).
516
542
  *
517
- * **Two contexts and not the four a block may declare.** `invoice` blocks are
518
- * drawn by `pdfmake` inside `invoices` and have no editor renderer to
519
- * contribute; `newsletter` is a palette the `email` context admits, rendered by
520
- * the same function, so a renderer contributed for `email` serves both and a
521
- * second spelling would be a second place to forget.
543
+ * **Three contexts and not the five a block may declare.** `invoice` is the
544
+ * context invoice blocks are *declared* in, and their editor renderers are
545
+ * contributed for `document` — the document-template editor of
546
+ * `specs/152-compare-pdf-template/` draws every document type's blocks, and
547
+ * which blocks a type offers is the type's registration, not the context;
548
+ * `newsletter` is a palette the `email` context admits, rendered by the same
549
+ * function, so a renderer contributed for `email` serves both and a second
550
+ * spelling would be a second place to forget.
522
551
  *
523
552
  * **Label, category, default props and the field set are not here.** They come
524
553
  * from the block's manifest declaration, through the descriptor the backend
@@ -530,6 +559,7 @@ export declare const AdminBlockContributionSchema: z.ZodObject<{
530
559
  context: z.ZodEnum<{
531
560
  cms: "cms";
532
561
  email: "email";
562
+ document: "document";
533
563
  }>;
534
564
  }, z.core.$strip>;
535
565
  /**
@@ -567,7 +597,8 @@ export interface AdminZoneContribution extends z.infer<typeof AdminZoneContribut
567
597
  * The factory's default export depends on the context, and neither shape is
568
598
  * nameable here — `contracts` is compiled by the backend and acquires no React
569
599
  * dependency: for `cms` it is a `PageBuilderBlockEditorConfig`
570
- * (`@endora-commerce/page-builder-core/contributions`), for `email` an
600
+ * (`@endora-commerce/page-builder-core/contributions`), for `document` a
601
+ * `DocumentBlockEditorConfig` (the same package), for `email` an
571
602
  * `EmailBlockRenderer` (`@endora-commerce/email-components`) — the same
572
603
  * function the send path runs, so the editor's preview cannot drift from what
573
604
  * is sent.
@@ -1 +1 @@
1
- {"version":3,"file":"admin-contributions.d.ts","sourceRoot":"","sources":["../src/admin-contributions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"admin-contributions.d.ts","sourceRoot":"","sources":["../src/admin-contributions.ts"],"names":[],"mappings":"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"}
@@ -468,6 +468,34 @@ export const AdminZoneNameSchema = z.enum([
468
468
  * stored stays stored and keeps rendering.
469
469
  */
470
470
  'category.content.editor',
471
+ /**
472
+ * Below the field of one setting on the Settings screen.
473
+ *
474
+ * Mounted **once per setting row** by `settings`' row editor
475
+ * (`SettingRowEditor.tsx`), each mount carrying that row's own
476
+ * {@link SettingsSettingAfterZoneProps} — one host, one place, many mounts
477
+ * (Z13), so a contributor narrows itself with
478
+ * `match: { settingCode: '…' }` and its chunk is fetched only on a screen
479
+ * that shows that setting.
480
+ *
481
+ * It exists so that the module that **declared** a setting can show what the
482
+ * value in the field amounts to — a preview, a consequence, a warning —
483
+ * without the `settings` module learning what any setting means. The first
484
+ * contributor is `seo`'s preview of the `robots.txt` a sales channel serves;
485
+ * `settings` names no contributor and gains no edge.
486
+ *
487
+ * **Read-only by construction.** The props carry the draft out and nothing
488
+ * back: a contribution cannot change the field, and cannot delay or prevent
489
+ * the row's save. A contribution that needs to write has a route of its own.
490
+ *
491
+ * **Not mounted for a `secret` setting.** A contribution must never be
492
+ * handed a secret's draft, and a secret's stored value never reaches the
493
+ * browser at all — so there is nothing for one to show.
494
+ *
495
+ * A row whose owning module is switched off is read-only and shows no
496
+ * contribution of that module, through the renderer's own presence filter.
497
+ */
498
+ 'settings.setting.after',
471
499
  ]);
472
500
  // ---------------------------------------------------------------------------
473
501
  // Declarations
@@ -555,11 +583,14 @@ export const AdminZoneContributionSchema = z.object({
555
583
  * The data half of an editor renderer for one Page Builder block in one editor
556
584
  * (`specs/141-module-block-renderers/contracts/block-renderers.md` §4).
557
585
  *
558
- * **Two contexts and not the four a block may declare.** `invoice` blocks are
559
- * drawn by `pdfmake` inside `invoices` and have no editor renderer to
560
- * contribute; `newsletter` is a palette the `email` context admits, rendered by
561
- * the same function, so a renderer contributed for `email` serves both and a
562
- * second spelling would be a second place to forget.
586
+ * **Three contexts and not the five a block may declare.** `invoice` is the
587
+ * context invoice blocks are *declared* in, and their editor renderers are
588
+ * contributed for `document` — the document-template editor of
589
+ * `specs/152-compare-pdf-template/` draws every document type's blocks, and
590
+ * which blocks a type offers is the type's registration, not the context;
591
+ * `newsletter` is a palette the `email` context admits, rendered by the same
592
+ * function, so a renderer contributed for `email` serves both and a second
593
+ * spelling would be a second place to forget.
563
594
  *
564
595
  * **Label, category, default props and the field set are not here.** They come
565
596
  * from the block's manifest declaration, through the descriptor the backend
@@ -570,6 +601,6 @@ export const AdminBlockContributionSchema = z.object({
570
601
  name: z
571
602
  .string()
572
603
  .regex(blockNameRe, 'Block name must be <module>.<Name>, as the manifest declares it'),
573
- context: z.enum(['cms', 'email']),
604
+ context: z.enum(['cms', 'email', 'document']),
574
605
  });
575
606
  //# sourceMappingURL=admin-contributions.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"admin-contributions.js","sourceRoot":"","sources":["../src/admin-contributions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"admin-contributions.js","sourceRoot":"","sources":["../src/admin-contributions.ts"],"names":[],"mappings":"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"}
@@ -32,6 +32,35 @@ export interface UpsertAdminRoleInput {
32
32
  permissions: string[];
33
33
  requiresTwoFactor?: boolean;
34
34
  }
35
+ /**
36
+ * Who a role write is made on behalf of.
37
+ *
38
+ * Present for an **operator** write — `PUT /api/v1/admin/admin-roles/:code` —
39
+ * and then the write is held to the grantor's own permissions: a grantor
40
+ * without the wildcard may not hand out, or edit a role holding, a code their
41
+ * own role lacks, and may not change a role the platform or a module seeds.
42
+ *
43
+ * Absent for a **platform** write: a module's install or boot hook seeding its
44
+ * roles, a one-time upgrade step, the `admin_users create` bootstrap command.
45
+ * Those run with no acting administrator and are not subject to the ceiling.
46
+ */
47
+ export interface UpsertAdminRoleOptions {
48
+ grantor?: {
49
+ /** The acting administrator's effective permission codes. */
50
+ readonly permissions: readonly string[];
51
+ };
52
+ }
53
+ /** The wildcard permission code: a role holding it may do everything. */
54
+ export declare const ADMIN_PERMISSION_WILDCARD = "*";
55
+ /**
56
+ * The codes in `requested` that a holder of `held` may not hand out — the grant
57
+ * ceiling shared by role writes, role assignment and API key scopes.
58
+ *
59
+ * A holder of the wildcard may grant anything. Otherwise every requested code
60
+ * must be held verbatim; a requested wildcard is held only by a wildcard
61
+ * holder. Each missing code is named once, in the order it was requested.
62
+ */
63
+ export declare function permissionsNotHeld(requested: readonly string[], held: readonly string[]): string[];
35
64
  /**
36
65
  * Container name: `adminRolePort`. Owner: `admin_roles`.
37
66
  *
@@ -46,7 +75,8 @@ export interface UpsertAdminRoleInput {
46
75
  * `admin_users` reads a role to render it beside its user and to enforce the
47
76
  * role's `requiresTwoFactor` at login. `remove` refuses a role whose code was
48
77
  * registered as system-protected (feature 016 FR-025), and that refusal stays
49
- * on this side of the port.
78
+ * on this side of the port. So does the grant ceiling `upsertByCode` applies
79
+ * when it is given a grantor — see {@link UpsertAdminRoleOptions}.
50
80
  *
51
81
  * **Owner off:** the seam fails closed — resolving this port throws
52
82
  * `ModuleDisabledError` and the call answers 503 `MODULE_DISABLED`, so nothing
@@ -58,7 +88,7 @@ export interface AdminRolePort {
58
88
  list(): Promise<AdminRoleRecord[]>;
59
89
  getById(id: string): Promise<AdminRoleRecord>;
60
90
  findByCode(code: string): Promise<AdminRoleRecord | null>;
61
- upsertByCode(input: UpsertAdminRoleInput): Promise<AdminRoleRecord>;
91
+ upsertByCode(input: UpsertAdminRoleInput, options?: UpsertAdminRoleOptions): Promise<AdminRoleRecord>;
62
92
  remove(id: string): Promise<void>;
63
93
  }
64
94
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"admin-roles.d.ts","sourceRoot":"","sources":["../src/admin-roles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC1D,YAAY,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACpE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,uBAAuB;IACtC,cAAc,IAAI,wBAAwB,EAAE,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD;;;;;;;;;OASG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAChE;AAED,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC"}
1
+ {"version":3,"file":"admin-roles.d.ts","sourceRoot":"","sources":["../src/admin-roles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE;QACR,6DAA6D;QAC7D,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;KACzC,CAAC;CACH;AAED,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,EAAE,CAQV;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC1D,YAAY,CACV,KAAK,EAAE,oBAAoB,EAC3B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,uBAAuB;IACtC,cAAc,IAAI,wBAAwB,EAAE,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD;;;;;;;;;OASG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAChE;AAED,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC"}
@@ -1,2 +1,22 @@
1
- export {};
1
+ /** The wildcard permission code: a role holding it may do everything. */
2
+ export const ADMIN_PERMISSION_WILDCARD = '*';
3
+ /**
4
+ * The codes in `requested` that a holder of `held` may not hand out — the grant
5
+ * ceiling shared by role writes, role assignment and API key scopes.
6
+ *
7
+ * A holder of the wildcard may grant anything. Otherwise every requested code
8
+ * must be held verbatim; a requested wildcard is held only by a wildcard
9
+ * holder. Each missing code is named once, in the order it was requested.
10
+ */
11
+ export function permissionsNotHeld(requested, held) {
12
+ if (held.includes(ADMIN_PERMISSION_WILDCARD))
13
+ return [];
14
+ const holds = new Set(held);
15
+ const missing = [];
16
+ for (const code of requested) {
17
+ if (!holds.has(code) && !missing.includes(code))
18
+ missing.push(code);
19
+ }
20
+ return missing;
21
+ }
2
22
  //# sourceMappingURL=admin-roles.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"admin-roles.js","sourceRoot":"","sources":["../src/admin-roles.ts"],"names":[],"mappings":""}
1
+ {"version":3,"file":"admin-roles.js","sourceRoot":"","sources":["../src/admin-roles.ts"],"names":[],"mappings":"AAyDA,yEAAyE;AACzE,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA4B,EAC5B,IAAuB;IAEvB,IAAI,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAAE,OAAO,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}