Add signals implementation (#1101)

Author: silesky

.buildkite/pipeline.yml

@@ -137,7 +137,7 @@ steps:
     commands:
       - npm config set "//registry.npmjs.org/:_authToken" $${NPM_TOKEN}
       - echo "--- Install dependencies"
-      - PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 HUSKY=0 yarn install --immutable
+      - HUSKY=0 yarn install --immutable
       - echo "--- Build bundles"
       - yarn turbo run --filter='./packages/signals/*' build
       - echo "+++ Run Lint"

.changeset/big-donkeys-cry.md

@@ -0,0 +1,5 @@
+---
+'@segment/analytics-next': patch
+---
+
+Add edgeFunction to CDNSettings type

.changeset/little-ghosts-jump.md

@@ -0,0 +1,5 @@
+---
+'@segment/analytics-next': minor
+---
+
+Export segment plugin and arg resolvers

.changeset/six-sloths-jam.md

@@ -0,0 +1,4 @@
+---
+'@segment/analytics-signals': patch
+---
+Initial release.

.gitignore

@@ -34,3 +34,4 @@ reports/*
 playwright-report/
 playwright/.cache/
 tmp.tsconfig.json
+.env

jest.config.js

@@ -17,6 +17,6 @@ module.exports = () =>
       '<rootDir>/packages/consent/consent-tools',
       '<rootDir>/packages/consent/consent-wrapper-onetrust',
       '<rootDir>/scripts',
-      '<rootDir>/packages/signals/browser-signals',
+      '<rootDir>/packages/signals/signals',
     ],
   })

packages/browser/src/browser/index.ts

@@ -104,6 +104,23 @@ export interface CDNSettings {
      */
     hasUnmappedDestinations: boolean
   }
+  /**
+   * Settings for edge function. Used for signals.
+   */
+  edgeFunction?: // this is technically non-nullable according to ajs-renderer atm, but making it optional because it's strange API choice, and we might want to change it.
+  | {
+        /**
+         * The URL of the edge function (.js file).
+         * @example 'https://cdn.edgefn.segment.com/MY-WRITEKEY/foo.js',
+         */
+        downloadURL: string
+        /**
+         * The version of the edge function
+         * @example 1
+         */
+        version: number
+      }
+    | {}
 }
 
 export interface AnalyticsBrowserSettings {

packages/browser/src/core/analytics/index.ts

@@ -88,7 +88,10 @@ export class AnalyticsInstanceSettings {
 
   constructor(settings: AnalyticsSettings) {
     this.writeKey = settings.writeKey
-    this.cdnSettings = settings.cdnSettings ?? { integrations: {} }
+    this.cdnSettings = settings.cdnSettings ?? {
+      integrations: {},
+      edgeFunction: {},
+    }
   }
 }
 

packages/browser/src/index.ts

@@ -17,3 +17,9 @@ export type { MiddlewareFunction } from './plugins/middleware'
 export { getGlobalAnalytics } from './lib/global-analytics-helper'
 export { UniversalStorage, Store, StorageObject } from './core/storage'
 export { segmentio } from './plugins/segmentio'
+export {
+  resolveAliasArguments,
+  resolveArguments,
+  resolvePageArguments,
+  resolveUserArguments,
+} from './core/arguments-resolver'