feat(specs): introduce multifeed composition behavior for beta release (#5828)

gavinwade12 · web-flow · commit f9ac3a711807 · 2026-01-20T17:40:22.000+01:00
diff --git a/clients/algoliasearch-client-javascript/packages/composition/package.json b/clients/algoliasearch-client-javascript/packages/composition/package.json
@@ -1,5 +1,5 @@
 {
-  "version": "1.22.4",
+  "version": "1.22.4-beta.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/algolia/algoliasearch-client-javascript.git"
diff --git a/specs/composition/common/schemas/components/CompositionBehavior.yml b/specs/composition/common/schemas/components/CompositionBehavior.yml
@@ -1,8 +1,9 @@
 compositionBehavior:
   type: object
   additionalProperties: false
+  description: An object containing either an `injection` or `multifeed` behavior schema, but not both.
   properties:
     injection:
       $ref: './injection/Behaviour.yml#/injection'
-  required:
-    - injection
+    multifeed:
+      $ref: './multifeed/Behaviour.yml#/multifeed'
diff --git a/specs/composition/common/schemas/components/multifeed/Behaviour.yml b/specs/composition/common/schemas/components/multifeed/Behaviour.yml
@@ -0,0 +1,41 @@
+multifeed:
+  title: multifeed
+  type: object
+  additionalProperties: false
+  properties:
+    feeds:
+      type: object
+      description: A key-value store of Feed ID to Feed. Currently, the only supported Feed type is an Injection.
+      additionalProperties:
+        $ref: '../injection/Behaviour.yml#/injection'
+    feedsOrder:
+      type: array
+      description: A list of Feed IDs that specifies the order in which to order the results in the response. The IDs should be a subset of those in the Feeds object, and only those specified will be processed. When this field is not set, all Feeds are processed and returned with a default ordering.
+      items:
+        type: string
+  required:
+    - feeds
+  example:
+    feeds:
+      products-feed:
+        main:
+          source:
+            search:
+              index: products
+        injectedItems:
+          - key: sponsored
+            position: 0
+            length: 4
+            source:
+              search:
+                index: products
+                params:
+                  filters: 'sponsored:true'
+      articles-feed:
+        main:
+          source:
+            search:
+              index: articles
+    feedsOrder:
+      - products-feed
+      - articles-feed

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "version": "1.22.4",`
	`2`	`+ "version": "1.22.4-beta.0",`
`3`	`3`	`"repository": {`
`4`	`4`	`"type": "git",`
`5`	`5`	`"url": "git+https://github.com/algolia/algoliasearch-client-javascript.git"`