@contractspec/example.personalization 1.49.0 → 1.51.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 (92) hide show
  1. package/.turbo/turbo-build$colon$bundle.log +115 -67
  2. package/.turbo/turbo-build.log +90 -79
  3. package/CHANGELOG.md +32 -0
  4. package/dist/libs/contracts/src/app-config/lifecycle.d.ts +1 -0
  5. package/dist/libs/contracts/src/app-config/runtime.d.ts +11 -0
  6. package/dist/libs/contracts/src/app-config/spec.d.ts +3 -2
  7. package/dist/libs/contracts/src/app-config/spec.d.ts.map +1 -1
  8. package/dist/libs/contracts/src/app-config/validation.d.ts +8 -1
  9. package/dist/libs/contracts/src/capabilities/capabilities.d.ts +17 -4
  10. package/dist/libs/contracts/src/capabilities/capabilities.d.ts.map +1 -1
  11. package/dist/libs/contracts/src/capabilities/guards.d.ts +2 -0
  12. package/dist/libs/contracts/src/capabilities/index.d.ts +4 -0
  13. package/dist/libs/contracts/src/capabilities/openbanking.d.ts +1 -0
  14. package/dist/libs/contracts/src/capabilities/validation.d.ts +3 -0
  15. package/dist/libs/contracts/src/data-views/index.d.ts +4 -0
  16. package/dist/libs/contracts/src/data-views/registry.d.ts +2 -0
  17. package/dist/libs/contracts/src/data-views/spec.d.ts +3 -0
  18. package/dist/libs/contracts/src/data-views/types.d.ts +1 -0
  19. package/dist/libs/contracts/src/events.d.ts +1 -0
  20. package/dist/libs/contracts/src/experiments/spec.d.ts +6 -4
  21. package/dist/libs/contracts/src/experiments/spec.d.ts.map +1 -1
  22. package/dist/libs/contracts/src/features/install.d.ts +3 -2
  23. package/dist/libs/contracts/src/features/types.d.ts +28 -31
  24. package/dist/libs/contracts/src/features/types.d.ts.map +1 -1
  25. package/dist/libs/contracts/src/index.d.ts +11 -4
  26. package/dist/libs/contracts/src/install.d.ts +2 -1
  27. package/dist/libs/contracts/src/integrations/connection.d.ts +1 -0
  28. package/dist/libs/contracts/src/integrations/index.d.ts +4 -1
  29. package/dist/libs/contracts/src/integrations/openbanking/contracts/accounts.d.ts +1 -1
  30. package/dist/libs/contracts/src/integrations/openbanking/contracts/balances.d.ts +1 -1
  31. package/dist/libs/contracts/src/integrations/openbanking/contracts/transactions.d.ts +1 -1
  32. package/dist/libs/contracts/src/integrations/openbanking/guards.d.ts +1 -0
  33. package/dist/libs/contracts/src/integrations/operations.d.ts +1 -1
  34. package/dist/libs/contracts/src/integrations/providers/elevenlabs.d.ts +2 -0
  35. package/dist/libs/contracts/src/integrations/providers/gcs-storage.d.ts +2 -0
  36. package/dist/libs/contracts/src/integrations/providers/gmail.d.ts +2 -0
  37. package/dist/libs/contracts/src/integrations/providers/google-calendar.d.ts +2 -0
  38. package/dist/libs/contracts/src/integrations/providers/index.d.ts +11 -0
  39. package/dist/libs/contracts/src/integrations/providers/mistral.d.ts +2 -0
  40. package/dist/libs/contracts/src/integrations/providers/postmark.d.ts +2 -0
  41. package/dist/libs/contracts/src/integrations/providers/powens.d.ts +2 -0
  42. package/dist/libs/contracts/src/integrations/providers/qdrant.d.ts +2 -0
  43. package/dist/libs/contracts/src/integrations/providers/registry.d.ts +1 -0
  44. package/dist/libs/contracts/src/integrations/providers/stripe.d.ts +2 -0
  45. package/dist/libs/contracts/src/integrations/providers/twilio-sms.d.ts +2 -0
  46. package/dist/libs/contracts/src/integrations/spec.d.ts +1 -0
  47. package/dist/libs/contracts/src/integrations/spec.d.ts.map +1 -1
  48. package/dist/libs/contracts/src/knowledge/index.d.ts +2 -0
  49. package/dist/libs/contracts/src/knowledge/operations.d.ts +1 -1
  50. package/dist/libs/contracts/src/knowledge/spaces/email-threads.d.ts +1 -0
  51. package/dist/libs/contracts/src/knowledge/spaces/financial-docs.d.ts +1 -0
  52. package/dist/libs/contracts/src/knowledge/spaces/financial-overview.d.ts +1 -0
  53. package/dist/libs/contracts/src/knowledge/spaces/index.d.ts +6 -0
  54. package/dist/libs/contracts/src/knowledge/spaces/product-canon.d.ts +1 -0
  55. package/dist/libs/contracts/src/knowledge/spaces/support-faq.d.ts +1 -0
  56. package/dist/libs/contracts/src/knowledge/spaces/uploaded-docs.d.ts +1 -0
  57. package/dist/libs/contracts/src/knowledge/spec.d.ts +1 -0
  58. package/dist/libs/contracts/src/llm/exporters.d.ts +2 -1
  59. package/dist/libs/contracts/src/llm/types.d.ts +2 -1
  60. package/dist/libs/contracts/src/operations/operation.d.ts +1 -0
  61. package/dist/libs/contracts/src/operations/operation.d.ts.map +1 -1
  62. package/dist/libs/contracts/src/ownership.d.ts +111 -8
  63. package/dist/libs/contracts/src/ownership.d.ts.map +1 -1
  64. package/dist/libs/contracts/src/policy/engine.d.ts +1 -0
  65. package/dist/libs/contracts/src/policy/guards.d.ts +1 -0
  66. package/dist/libs/contracts/src/policy/index.d.ts +4 -1
  67. package/dist/libs/contracts/src/policy/registry.d.ts +1 -0
  68. package/dist/libs/contracts/src/policy/spec.d.ts +7 -4
  69. package/dist/libs/contracts/src/policy/spec.d.ts.map +1 -1
  70. package/dist/libs/contracts/src/policy/validation.d.ts +2 -0
  71. package/dist/libs/contracts/src/presentations/presentations.d.ts.map +1 -1
  72. package/dist/libs/contracts/src/regenerator/adapters.d.ts +1 -0
  73. package/dist/libs/contracts/src/regenerator/executor.d.ts +1 -0
  74. package/dist/libs/contracts/src/regenerator/index.d.ts +6 -0
  75. package/dist/libs/contracts/src/regenerator/service.d.ts +2 -0
  76. package/dist/libs/contracts/src/regenerator/sinks.d.ts +2 -0
  77. package/dist/libs/contracts/src/regenerator/types.d.ts +2 -0
  78. package/dist/libs/contracts/src/regenerator/utils.d.ts +1 -0
  79. package/dist/libs/contracts/src/serialization/serializers.d.ts +3 -1
  80. package/dist/libs/contracts/src/themes.d.ts +6 -4
  81. package/dist/libs/contracts/src/themes.d.ts.map +1 -1
  82. package/dist/libs/contracts/src/types.d.ts +3 -1
  83. package/dist/libs/contracts/src/versioning/refs.d.ts +60 -0
  84. package/dist/libs/contracts/src/versioning/refs.d.ts.map +1 -0
  85. package/dist/libs/contracts/src/workflow/context.d.ts +2 -0
  86. package/dist/libs/contracts/src/workflow/index.d.ts +3 -1
  87. package/dist/libs/contracts/src/workflow/runner.d.ts +1 -0
  88. package/dist/libs/contracts/src/workflow/sla-monitor.d.ts +2 -0
  89. package/dist/libs/contracts/src/workflow/spec.d.ts +2 -1
  90. package/dist/libs/contracts/src/workflow/spec.d.ts.map +1 -1
  91. package/dist/libs/contracts/src/workflow/validation.d.ts +2 -1
  92. package/package.json +8 -8
@@ -1,45 +1,40 @@
1
+ import { SpecKeyRef, VersionedSpecRef } from "../versioning/refs.js";
2
+ import { CapabilityRef, CapabilityRequirement } from "../capabilities/capabilities.js";
1
3
  import { PresentationTarget } from "../presentations/presentations.js";
2
4
  import { OwnerShipMeta } from "../ownership.js";
3
- import { CapabilityRef, CapabilityRequirement } from "../capabilities/capabilities.js";
4
- import { ExperimentRef } from "../experiments/spec.js";
5
5
  import { ImplementationRef } from "../operations/operation.js";
6
6
  import "../operations/index.js";
7
+ import "../capabilities/index.js";
8
+ import { ExperimentRef } from "../experiments/spec.js";
7
9
 
8
10
  //#region ../../libs/contracts/src/features/types.d.ts
9
11
  /** Minimal metadata to identify and categorize a feature module. */
10
12
  type FeatureModuleMeta = OwnerShipMeta;
11
- interface OpRef {
12
- /** Operation key (OperationSpec.meta.key). */
13
- key: string;
14
- /** Operation version (OperationSpec.meta.version). */
15
- version: string;
16
- }
17
- interface EventRef {
18
- /** Event key. */
19
- key: string;
20
- /** Event version. */
21
- version: string;
22
- }
23
- interface PresentationRef {
24
- /** Presentation key. */
25
- key: string;
26
- /** Presentation version. */
27
- version: string;
28
- }
13
+ /**
14
+ * Reference to an operation spec.
15
+ * Uses key (OperationSpec.meta.key) and version (OperationSpec.meta.version).
16
+ */
17
+ type OpRef = VersionedSpecRef;
18
+ /**
19
+ * Reference to an event spec.
20
+ * Uses key (EventSpec.meta.key) and version (EventSpec.meta.version).
21
+ */
22
+ type EventRef = VersionedSpecRef;
23
+ /**
24
+ * Reference to a presentation spec.
25
+ * Uses key (PresentationSpec.meta.key) and version (PresentationSpec.meta.version).
26
+ */
27
+ type PresentationRef = VersionedSpecRef;
29
28
  /**
30
29
  * Reference to a data view spec.
30
+ * Uses key (DataViewSpec.meta.key) and version (DataViewSpec.meta.version).
31
31
  */
32
- interface DataViewRef {
33
- key: string;
34
- version: string;
35
- }
32
+ type DataViewRef = VersionedSpecRef;
36
33
  /**
37
34
  * Reference to a form spec.
35
+ * Uses key (FormSpec.meta.key) and version (FormSpec.meta.version).
38
36
  */
39
- interface FormRef {
40
- key: string;
41
- version: string;
42
- }
37
+ type FormRef = VersionedSpecRef;
43
38
  /** Group operations/events/presentations into an installable feature. */
44
39
  interface FeatureModuleSpec {
45
40
  meta: FeatureModuleMeta;
@@ -80,9 +75,11 @@ interface FeatureModuleSpec {
80
75
  /** Forms associated with this feature. */
81
76
  forms?: FormRef[];
82
77
  }
83
- interface FeatureRef {
84
- key: string;
85
- }
78
+ /**
79
+ * Reference to a feature (unversioned).
80
+ * Features are identified by key only, without version pinning.
81
+ */
82
+ type FeatureRef = SpecKeyRef;
86
83
  //#endregion
87
84
  export { DataViewRef, EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FormRef, OpRef, PresentationRef };
88
85
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/features/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;KAOY,iBAAA,GAAoB;UAEf,KAAA;EAFL;EAEK,GAAA,EAAA,MAAK;EAOL;EAOA,OAAA,EAAA,MAAA;AAUjB;AAQiB,UAzBA,QAAA,CAyBO;EAMP;EACT,GAAA,EAAA,MAAA;EAEO;EAEJ,OAAA,EAAA,MAAA;;AAIK,UAjCC,eAAA,CAiCD;EAGD;EACA,GAAA,EAAA,MAAA;EAGY;EAAa,OAAA,EAAA,MAAA;;;;;AAqBvB,UAnDA,WAAA,CAmDA;EAGA,GAAA,EAAA,MAAA;;;;;;UA9CA,OAAA;;;;;UAMA,iBAAA;QACT;;eAEO;;WAEJ;;kBAEO;;gBAEF;;;eAGD;eACA;;;;QAGY;UAAa;;;;;;;;;aAQ3B;;;;;;oBAOO;;cAGN;;UAGJ;;UAGO,UAAA"}
1
+ {"version":3,"file":"types.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/features/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;KAQY,iBAAA,GAAoB;;;AAAhC;AAMA;AAMY,KANA,KAAA,GAAQ,gBAMG;AAMvB;AAMA;AAMA;AAGA;AACQ,KAtBI,QAAA,GAAW,gBAsBf;;;;;AAWO,KA3BH,eAAA,GAAkB,gBA2Bf;;;;;AAmBK,KAxCR,WAAA,GAAc,gBAwCN;;;;AAapB;KA/CY,OAAA,GAAU;;UAGL,iBAAA;QACT;;eAEO;;WAEJ;;kBAEO;;gBAEF;;;eAGD;eACA;;;;QAGY;UAAa;;;;;;;;;aAQ3B;;;;;;oBAOO;;cAGN;;UAGJ;;;;;;KAOE,UAAA,GAAa"}
@@ -1,22 +1,27 @@
1
+ import { OptionalVersionedSpecRef, SpecKeyRef, VersionedSpecRef } from "./versioning/refs.js";
2
+ import { CapabilityKind, CapabilityRef, CapabilityRequirement } from "./capabilities/capabilities.js";
1
3
  import { PresentationTarget } from "./presentations/presentations.js";
2
4
  import { DocId } from "./docs/registry.js";
3
5
  import { Owner, OwnerShipMeta, OwnersEnum, Stability, StabilityEnum, Tag, TagsEnum } from "./ownership.js";
4
6
  import { PolicyRef } from "./policy/spec.js";
5
- import { CapabilityKind, CapabilityRef, CapabilityRequirement } from "./capabilities/capabilities.js";
6
- import { ExperimentRef } from "./experiments/spec.js";
7
7
  import "./resources.js";
8
8
  import { ImplementationRef, ImplementationType } from "./operations/operation.js";
9
- import "./install.js";
10
9
  import "./operations/index.js";
11
- import { DataViewRef, EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FormRef, OpRef, PresentationRef } from "./features/types.js";
10
+ import "./install.js";
12
11
  import "./presentations/index.js";
12
+ import "./capabilities/index.js";
13
+ import { ExperimentRef } from "./experiments/spec.js";
14
+ import { DataViewRef, EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FormRef, OpRef, PresentationRef } from "./features/types.js";
13
15
  import "./features/index.js";
16
+ import "./data-views/index.js";
14
17
  import { CompensationStep, CompensationStrategy, GuardCondition, GuardConditionKind, RetryPolicy, SLA, Step, StepAction, StepType, Transition, WorkflowDefinition, WorkflowMeta, WorkflowSpec } from "./workflow/spec.js";
15
18
  import { ThemeRef } from "./themes.js";
16
19
  import { IntegrationCategory, IntegrationOwnershipMode } from "./integrations/spec.js";
17
20
  import { AppBlueprintMeta, AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TranslationCatalogPointer } from "./app-config/spec.js";
21
+ import "./app-config/runtime.js";
18
22
  import "./experiments/spec-resolver.js";
19
23
  import "./types.js";
24
+ import "./events.js";
20
25
  import "./client/index.js";
21
26
  import "./prompt.js";
22
27
  import "./promptRegistry.js";
@@ -29,8 +34,10 @@ import "./policy/index.js";
29
34
  import "./tests/index.js";
30
35
  import "./experiments/evaluator.js";
31
36
  import "./integrations/index.js";
37
+ import "./knowledge/index.js";
32
38
  import "./integrations/operations.js";
33
39
  import "./knowledge/operations.js";
40
+ import "./regenerator/index.js";
34
41
  import "./workspace-config/index.js";
35
42
  import "./workflow/index.js";
36
43
  import "./llm/index.js";
@@ -1,5 +1,6 @@
1
1
  import "./resources.js";
2
- import "./operations/registry.js";
3
2
  import "./operations/index.js";
3
+ import "./operations/registry.js";
4
4
  import "./types.js";
5
+ import "./events.js";
5
6
  import "zod";
@@ -0,0 +1 @@
1
+ import "./spec.js";
@@ -1,2 +1,5 @@
1
1
  import { IntegrationCategory, IntegrationOwnershipMode } from "./spec.js";
2
- import "./openbanking/contracts/index.js";
2
+ import "./connection.js";
3
+ import "./providers/index.js";
4
+ import "./openbanking/contracts/index.js";
5
+ import "./openbanking/guards.js";
@@ -1,3 +1,3 @@
1
- import "../../../operations/registry.js";
2
1
  import "../../../operations/index.js";
2
+ import "../../../operations/registry.js";
3
3
  import "../../../index.js";
@@ -1,3 +1,3 @@
1
- import "../../../operations/registry.js";
2
1
  import "../../../operations/index.js";
2
+ import "../../../operations/registry.js";
3
3
  import "../../../index.js";
@@ -1,3 +1,3 @@
1
- import "../../../operations/registry.js";
2
1
  import "../../../operations/index.js";
2
+ import "../../../operations/registry.js";
3
3
  import "../../../index.js";
@@ -0,0 +1 @@
1
+ import "../../app-config/runtime.js";
@@ -1,3 +1,3 @@
1
- import "../operations/registry.js";
2
1
  import "../operations/index.js";
2
+ import "../operations/registry.js";
3
3
  import "../index.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -0,0 +1,11 @@
1
+ import "./stripe.js";
2
+ import "./postmark.js";
3
+ import "./qdrant.js";
4
+ import "./mistral.js";
5
+ import "./elevenlabs.js";
6
+ import "./gmail.js";
7
+ import "./google-calendar.js";
8
+ import "./twilio-sms.js";
9
+ import "./gcs-storage.js";
10
+ import "./powens.js";
11
+ import "./registry.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -0,0 +1 @@
1
+ import "../spec.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -0,0 +1,2 @@
1
+ import "../spec.js";
2
+ import "../index.js";
@@ -1,3 +1,4 @@
1
+ import "../capabilities/index.js";
1
2
  import "../registry.js";
2
3
 
3
4
  //#region ../../libs/contracts/src/integrations/spec.d.ts
@@ -1 +1 @@
1
- {"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/integrations/spec.ts"],"sourcesContent":[],"mappings":";;;AAIY,KAAA,mBAAA,GAAmB,UAAA,GAAA,OAAA,GAAA,UAAA,GAAA,KAAA,GAAA,QAAA,GAAA,UAAA,GAAA,gBAAA,GAAA,WAAA,GAAA,SAAA,GAAA,YAAA,GAAA,KAAA,GAAA,UAAA,GAAA,cAAA,GAAA,QAAA;AAgBnB,KAAA,wBAAA,GAAwB,SAAA,GAAA,MAAA"}
1
+ {"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/integrations/spec.ts"],"sourcesContent":[],"mappings":";;;;KAIY,mBAAA;AAAA,KAgBA,wBAAA,GAhBmB,SAAA,GAAA,MAAA"}
@@ -0,0 +1,2 @@
1
+ import "./spec.js";
2
+ import "./spaces/index.js";
@@ -1,3 +1,3 @@
1
- import "../operations/registry.js";
2
1
  import "../operations/index.js";
2
+ import "../operations/registry.js";
3
3
  import "../index.js";
@@ -0,0 +1 @@
1
+ import "../spec.js";
@@ -0,0 +1 @@
1
+ import "../spec.js";
@@ -0,0 +1 @@
1
+ import "../spec.js";
@@ -0,0 +1,6 @@
1
+ import "./product-canon.js";
2
+ import "./support-faq.js";
3
+ import "./email-threads.js";
4
+ import "./uploaded-docs.js";
5
+ import "./financial-docs.js";
6
+ import "./financial-overview.js";
@@ -0,0 +1 @@
1
+ import "../spec.js";
@@ -0,0 +1 @@
1
+ import "../spec.js";
@@ -0,0 +1 @@
1
+ import "../spec.js";
@@ -0,0 +1 @@
1
+ import "../registry.js";
@@ -1,5 +1,6 @@
1
- import "../operations/registry.js";
2
1
  import "../operations/index.js";
2
+ import "../operations/registry.js";
3
3
  import "../presentations/index.js";
4
4
  import "../features/index.js";
5
+ import "../events.js";
5
6
  import "./types.js";
@@ -1,2 +1,3 @@
1
1
  import "../operations/index.js";
2
- import "../features/index.js";
2
+ import "../features/index.js";
3
+ import "../events.js";
@@ -1,4 +1,5 @@
1
1
  import "../resources.js";
2
+ import "../events.js";
2
3
 
3
4
  //#region ../../libs/contracts/src/operations/operation.d.ts
4
5
 
@@ -1 +1 @@
1
- {"version":3,"file":"operation.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/operations/operation.ts"],"sourcesContent":[],"mappings":";;;;;;;KAmBY,kBAAA;;;;;UAaK,iBAAA;;;;QAIT"}
1
+ {"version":3,"file":"operation.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/operations/operation.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAoBY,kBAAA;;;;;UAaK,iBAAA;;;;QAIT"}
@@ -1,58 +1,161 @@
1
1
  import { DocId } from "./docs/registry.js";
2
2
 
3
3
  //#region ../../libs/contracts/src/ownership.d.ts
4
+
5
+ /**
6
+ * Lifecycle stability stages for specs.
7
+ *
8
+ * Specs progress through these stages as they mature:
9
+ * - `idea`: Initial concept, not implemented
10
+ * - `in_creation`: Currently being built
11
+ * - `experimental`: Working but may change significantly
12
+ * - `beta`: Feature-complete, seeking feedback
13
+ * - `stable`: Production-ready, breaking changes require major version bump
14
+ * - `deprecated`: Scheduled for removal, use alternatives
15
+ */
4
16
  declare const StabilityEnum: {
17
+ /** Initial concept, not yet implemented. */
5
18
  readonly Idea: "idea";
19
+ /** Currently being built, not ready for use. */
6
20
  readonly InCreation: "in_creation";
21
+ /** Working but unstable, may change significantly. */
7
22
  readonly Experimental: "experimental";
23
+ /** Feature-complete, seeking feedback before stabilization. */
8
24
  readonly Beta: "beta";
25
+ /** Production-ready, follows semantic versioning. */
9
26
  readonly Stable: "stable";
27
+ /** Scheduled for removal, use alternatives. */
10
28
  readonly Deprecated: "deprecated";
11
29
  };
30
+ /** Stability level for a spec's lifecycle stage. */
12
31
  type Stability = (typeof StabilityEnum)[keyof typeof StabilityEnum];
32
+ /**
33
+ * Curated owner identifiers for business/product ownership.
34
+ *
35
+ * Used for CODEOWNERS, on-call routing, and approval workflows.
36
+ * Custom owner strings are also allowed for flexibility.
37
+ */
13
38
  declare const OwnersEnum: {
39
+ /** Core platform team. */
14
40
  readonly PlatformCore: "platform.core";
41
+ /** Sigil/auth team. */
15
42
  readonly PlatformSigil: "platform.sigil";
43
+ /** Marketplace team. */
16
44
  readonly PlatformMarketplace: "platform.marketplace";
45
+ /** Messaging/notifications team. */
17
46
  readonly PlatformMessaging: "platform.messaging";
47
+ /** Content/CMS team. */
18
48
  readonly PlatformContent: "platform.content";
49
+ /** Feature flags team. */
19
50
  readonly PlatformFeatureFlags: "platform.featureflags";
51
+ /** Finance/billing team. */
20
52
  readonly PlatformFinance: "platform.finance";
21
53
  };
54
+ /**
55
+ * Owner identifier for a spec.
56
+ * Can be a predefined OwnersEnum value or any custom string.
57
+ */
22
58
  type Owner = (typeof OwnersEnum)[keyof typeof OwnersEnum] | (string & {});
59
+ /**
60
+ * Common tags for categorizing specs.
61
+ *
62
+ * Used for search, grouping, and documentation navigation.
63
+ * Custom tag strings are also allowed for flexibility.
64
+ */
23
65
  declare const TagsEnum: {
66
+ /** Spots/locations domain. */
24
67
  readonly Spots: "spots";
68
+ /** Collectivity/community domain. */
25
69
  readonly Collectivity: "collectivity";
70
+ /** Marketplace domain. */
26
71
  readonly Marketplace: "marketplace";
72
+ /** Seller-related features. */
27
73
  readonly Sellers: "sellers";
74
+ /** Authentication features. */
28
75
  readonly Auth: "auth";
76
+ /** Login flows. */
29
77
  readonly Login: "login";
78
+ /** Signup flows. */
30
79
  readonly Signup: "signup";
80
+ /** Onboarding/guides. */
31
81
  readonly Guide: "guide";
82
+ /** Documentation. */
32
83
  readonly Docs: "docs";
84
+ /** Internationalization. */
33
85
  readonly I18n: "i18n";
86
+ /** Incident management. */
34
87
  readonly Incident: "incident";
88
+ /** Automation/workflows. */
35
89
  readonly Automation: "automation";
90
+ /** Code hygiene/maintenance. */
36
91
  readonly Hygiene: "hygiene";
37
92
  };
93
+ /**
94
+ * Tag for categorizing a spec.
95
+ * Can be a predefined TagsEnum value or any custom string.
96
+ */
38
97
  type Tag = (typeof TagsEnum)[keyof typeof TagsEnum] | (string & {});
98
+ /**
99
+ * Common metadata interface for all ContractSpec specifications.
100
+ *
101
+ * Every spec type (operations, events, presentations, etc.) extends this
102
+ * interface to provide consistent ownership, versioning, and discoverability.
103
+ *
104
+ * @example
105
+ * ```typescript
106
+ * const meta: OwnerShipMeta = {
107
+ * key: 'auth.login',
108
+ * version: '1.0.0',
109
+ * description: 'Authenticates a user with email and password',
110
+ * stability: StabilityEnum.Stable,
111
+ * owners: [OwnersEnum.PlatformSigil],
112
+ * tags: [TagsEnum.Auth, TagsEnum.Login],
113
+ * };
114
+ * ```
115
+ */
39
116
  interface OwnerShipMeta {
40
- /** Breaking changes => bump version */
117
+ /**
118
+ * Semantic version string (e.g., "1.0.0").
119
+ * Bump for breaking changes according to semver rules.
120
+ */
41
121
  version: string;
42
- /** Fully-qualified spec key (e.g., "sigil.beginSignup") */
122
+ /**
123
+ * Fully-qualified spec key (e.g., "sigil.beginSignup", "user.created").
124
+ * Must be unique within the spec type.
125
+ */
43
126
  key: string;
44
- /** Human-friendly spec title (e.g., "Signup begin") */
127
+ /**
128
+ * Human-friendly title (e.g., "Begin Signup").
129
+ * Used in documentation and UI.
130
+ */
45
131
  title?: string;
46
- /** Short human-friendly summary */
132
+ /**
133
+ * Short human-friendly summary of what this spec does.
134
+ * Should be concise (1-2 sentences).
135
+ */
47
136
  description: string;
137
+ /**
138
+ * Business domain this spec belongs to (e.g., "auth", "marketplace").
139
+ * Used for grouping and discovery.
140
+ */
48
141
  domain?: string;
49
- /** Lifecycle marker for comms & tooling */
142
+ /**
143
+ * Lifecycle stability marker.
144
+ * Indicates maturity level and change expectations.
145
+ */
50
146
  stability: Stability;
51
- /** Owners for CODEOWNERS / on-call / approvals */
147
+ /**
148
+ * Team/individual owners responsible for this spec.
149
+ * Used for CODEOWNERS, on-call routing, and approvals.
150
+ */
52
151
  owners: Owner[];
53
- /** Search tags, grouping, docs navigation */
152
+ /**
153
+ * Tags for search, grouping, and documentation navigation.
154
+ */
54
155
  tags: Tag[];
55
- /** Doc block(s) for this operation. */
156
+ /**
157
+ * Associated DocBlock identifiers for documentation linkage.
158
+ */
56
159
  docId?: DocId[];
57
160
  }
58
161
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"ownership.d.ts","names":[],"sources":["../../../../../../libs/contracts/src/ownership.ts"],"sourcesContent":[],"mappings":";;;cAIa;;EAAA,SAAA,UAOH,EAAA,aAAA;EACE,SAAA,YAAS,EAAA,cAAW;EAGnB,SAAA,IAQH,EAAA,MAAA;EACE,SAAK,MAAA,EAAA,QACL;EAMC,SAAA,UAcH,EAAA,YAAA;AACV,CAAA;AAIiB,KAtCL,SAAA,GAsCkB,CAAA,OAtCE,aAsCF,CAAA,CAAA,MAAA,OAtC8B,aAsC9B,CAAA;AAWjB,cA9CA,UA8CA,EAAA;EAEH,SAAA,YAAA,EAAA,eAAA;EAEF,SAAA,aAAA,EAAA,gBAAA;EAGE,SAAA,mBAAA,EAAA,sBAAA;EAAK,SAAA,iBAAA,EAAA,oBAAA;;;;;KA5CH,KAAA,WACA,yBAAyB;cAMxB;;;;;;;;;;;;;;;KAeD,GAAA,WAAc,uBAAuB;UAIhC,aAAA;;;;;;;;;;;aAWJ;;UAEH;;QAEF;;UAGE"}
1
+ {"version":3,"file":"ownership.d.ts","names":[],"sources":["../../../../../../libs/contracts/src/ownership.ts"],"sourcesContent":[],"mappings":";;;;AAwJA;;;;;;;;;;;cA9Ha;;;;;;;;;;;;;;;KAgBD,SAAA,WAAoB,4BAA4B;;;;;;;cAY/C;;;;;;;;;;;;;;;;;;;;KAqBD,KAAA,WACA,yBAAyB;;;;;;;cAgBxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCD,GAAA,WAAc,uBAAuB;;;;;;;;;;;;;;;;;;;UA2BhC,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAmCJ;;;;;UAMH;;;;QAKF;;;;UAKE"}
@@ -1 +1,2 @@
1
+ import "./registry.js";
1
2
  import "../types.js";
@@ -0,0 +1 @@
1
+ import "../operations/operation.js";
@@ -1,3 +1,6 @@
1
1
  import { PolicyRef } from "./spec.js";
2
+ import "./registry.js";
2
3
  import "./engine.js";
3
- import "./opa-adapter.js";
4
+ import "./opa-adapter.js";
5
+ import "./guards.js";
6
+ import "./validation.js";
@@ -0,0 +1 @@
1
+ import "../registry.js";
@@ -1,9 +1,12 @@
1
+ import { VersionedSpecRef } from "../versioning/refs.js";
2
+
1
3
  //#region ../../libs/contracts/src/policy/spec.d.ts
2
4
 
3
- interface PolicyRef {
4
- key: string;
5
- version: string;
6
- }
5
+ /**
6
+ * Reference to a policy spec.
7
+ * Uses key and version to identify a specific policy.
8
+ */
9
+ type PolicyRef = VersionedSpecRef;
7
10
  //#endregion
8
11
  export { PolicyRef };
9
12
  //# sourceMappingURL=spec.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/policy/spec.ts"],"sourcesContent":[],"mappings":";;UAmHiB,SAAA"}
1
+ {"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/policy/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAyHY,SAAA,GAAY"}
@@ -0,0 +1,2 @@
1
+ import "../operations/registry.js";
2
+ import "./registry.js";
@@ -1 +1 @@
1
- {"version":3,"file":"presentations.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/presentations/presentations.ts"],"sourcesContent":[],"mappings":";;;KAKY,kBAAA"}
1
+ {"version":3,"file":"presentations.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/presentations/presentations.ts"],"sourcesContent":[],"mappings":";;;KAMY,kBAAA"}
@@ -0,0 +1 @@
1
+ import "./types.js";
@@ -0,0 +1 @@
1
+ import "./types.js";
@@ -0,0 +1,6 @@
1
+ import "./types.js";
2
+ import "./adapters.js";
3
+ import "./service.js";
4
+ import "./executor.js";
5
+ import "./utils.js";
6
+ import "./sinks.js";
@@ -0,0 +1,2 @@
1
+ import "./types.js";
2
+ import "./adapters.js";
@@ -0,0 +1,2 @@
1
+ import "./types.js";
2
+ import "./executor.js";
@@ -0,0 +1,2 @@
1
+ import "../app-config/spec.js";
2
+ import "../app-config/runtime.js";
@@ -0,0 +1 @@
1
+ import "./types.js";
@@ -1,3 +1,5 @@
1
1
  import "../resources.js";
2
2
  import "../operations/index.js";
3
- import "../presentations/index.js";
3
+ import "../presentations/index.js";
4
+ import "../data-views/index.js";
5
+ import "../events.js";
@@ -1,11 +1,13 @@
1
+ import { VersionedSpecRef } from "./versioning/refs.js";
1
2
  import "./registry.js";
2
3
 
3
4
  //#region ../../libs/contracts/src/themes.d.ts
4
5
 
5
- interface ThemeRef {
6
- key: string;
7
- version: string;
8
- }
6
+ /**
7
+ * Reference to a theme spec.
8
+ * Uses key and version to identify a specific theme.
9
+ */
10
+ type ThemeRef = VersionedSpecRef;
9
11
  //#endregion
10
12
  export { ThemeRef };
11
13
  //# sourceMappingURL=themes.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"themes.d.ts","names":[],"sources":["../../../../../../libs/contracts/src/themes.ts"],"sourcesContent":[],"mappings":";;;;UAgDiB,QAAA"}
1
+ {"version":3,"file":"themes.d.ts","names":[],"sources":["../../../../../../libs/contracts/src/themes.ts"],"sourcesContent":[],"mappings":";;;;;;;;;KAsDY,QAAA,GAAW"}
@@ -1 +1,3 @@
1
- import "./experiments/spec-resolver.js";
1
+ import "./app-config/runtime.js";
2
+ import "./experiments/spec-resolver.js";
3
+ import "./events.js";