@artsy/cohesion NPM

Cohesion

Artsy's analytics schema

State: In development
GitHub: https://github.com/artsy/cohesion
Docs: https://cohesion.artsy.net
Ci: https://circleci.com/gh/artsy/cohesion
NPM: Package updates are published automatically on successful merges to main. Canaries are available on PR's from feature branches.
Point People: @damassi, @abhitip

Contributing

Requirements: Yarn

Set up:

yarn install

Run tests:

yarn test

Generate docs:

yarn docs

To view docs locally, visit the full filepath of docs/index.html in your browser, i.e, file:///Users/<MY_USER>/<MY_LOCAL_DIRECTORY>/cohesion/doc/index.html

Schema

The /Schema directory represents the Artsy's analytics schema, and describes expectations for data consumed by Redshift and Segment.

This schema is maintained by Artsy's data team, engineers should not expect to change these files.

Valid analytics events are described in /Schema/Events/index.ts, and individual event schemas live in the Schema/Events directory, divided by concern.

Typings for all allowed values, such as ContextModule, are exported for use by engineers in consuming projects.

Add a new event to the schema (For data analysts)

In Schema/Events, add the name of the new event. This name defines the corresponding downstream table's name in Redshift, and should use the lowerCamelCase naming convention.

// Schema/Events/index.ts

export enum ActionType {
  ...
  myNewEvent = "myNewEvent",
  ...
}

In Schema/Events directory, create a new interface describing the shape of the new event, as it is received in Segment/Redshift.

The name of the interface should match the ActionType created in step 1, but use the UpperCamelCase naming convention.
The action key is required and should match the ActionType created in step 1.
If your event uses values not yet in the schema, such as a new ContextModule, add new values to the existing typings in the Schema directory.

// Schema/Events/MyNewEvent.ts

export interface MyNewEvent {
  action: ActionType.myNewEvent
  context_module: ContextModule
  optional_property?: string
  required_property: number
}

In Schema/Events/index.ts, add the new interface to the valid events main list, Event
Add descriptive comments with examples to explain the use of your new event. Our documentation is generated automatically from in-code comments, find more information on syntax in the typedoc docs.
If you have created any new files, add an export statement to Schema/index.ts like so:

// Schema/index.ts

export * from "./Events/MyNewEvent"

PR your changes. Once merged, the schema will be updated and your new event and values will be available to consumers of this package.

core-js

@infinitebrahmanuniverse/nolb-_art @everything-registry/sub-chunk-87 @artsy/reaction palette-mobile

4.237.1--canary.562.11078.0

9 months ago

10 months ago

8 months ago

9 months ago

1 year ago

8 months ago

10 months ago

10 months ago

4.237.1--canary.562.11088.0

9 months ago

12 months ago

12 months ago

9 months ago

12 months ago

11 months ago

6 months ago

6 months ago

7 months ago

6 months ago

7 months ago

8 months ago

4.237.1--canary.562.11068.0

9 months ago

4.263.0

6 months ago

4.263.1

6 months ago

4.230.0--canary.554.10789.0

9 months ago

4.252.0

7 months ago

4.237.1--canary.562.11093.0

9 months ago

8 months ago

6 months ago

6 months ago

9 months ago

4.230.0--canary.554.10799.0

9 months ago

7 months ago

5 months ago

8 months ago

8 months ago

4.238.1--canary.562.11137.0

8 months ago

7 months ago

9 months ago

5 months ago

11 months ago

8 months ago

4.238.1--canary.562.11138.0

8 months ago

7 months ago

9 months ago

5 months ago

11 months ago

8 months ago

7 months ago

9 months ago

7 months ago

11 months ago

5 months ago

8 months ago

7 months ago

9 months ago

4.230.0--canary.554.10794.0

9 months ago

4.237.1--canary.562.11073.0

9 months ago

5 months ago

8 months ago

10 months ago

9 months ago

7 months ago

10 months ago

8 months ago

4.237.1--canary.562.11083.0

9 months ago

9 months ago

7 months ago

10 months ago

8 months ago

9 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

4.126.0--canary.432.6658.0

2 years ago

4.125.1

3 years ago

4.125.0

3 years ago

4.126.0--canary.432.6663.0

2 years ago

4.126.0--canary.432.6648.0

2 years ago

4.126.0

2 years ago

4.127.0

2 years ago

4.126.0--canary.432.6653.0

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4.34.1--canary.304.4466.0

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4.33.1--canary.304.4436.0

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4.4.1-canary.242.3515.0

4 years ago

4.4.1-canary.242.3510.0

4 years ago

4.4.1-canary.242.3505.0

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4.0.1-canary.235.3393.0

4 years ago

4.0.1-canary.236.3394.0

4 years ago

3.1.1-canary.236.3373.0

4 years ago

3.2.0-canary.235.3368.0

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

1.56.1-canary.130.1884.0

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

1.34.1-canary.101.1510.0

5 years ago

1.34.0

5 years ago

1.33.5

5 years ago

1.33.6-canary.100.1490.0

5 years ago

1.33.6-canary.100.1485.0

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

1.24.1-canary.87.1270.0

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

6 years ago

1.0.3-canary.36.691.0

6 years ago

1.0.3-canary.38.652.0

6 years ago

1.0.3-canary.36.655.0

6 years ago

1.0.3-canary.38.640.0

6 years ago

1.0.2

6 years ago

1.0.1

6 years ago

1.0.1-canary.34.593.0

6 years ago

1.0.1-canary.34.588.0

6 years ago

1.0.1-canary.34.576.0

6 years ago

1.0.1-canary.33.575.0

6 years ago

1.0.0

6 years ago

0.2.10-canary.31.546.0

6 years ago

0.2.10-canary.31.551.0

6 years ago

0.2.9

6 years ago

0.2.7-canary.25.453.0

6 years ago

0.2.7-canary.27.422.0

6 years ago

0.2.7-canary.25.419.0

6 years ago

0.2.8-canary.29.494.0

6 years ago

0.2.7-canary.28.421.0

6 years ago

0.2.8-canary.29.489.0

6 years ago

0.2.8-canary.29.499.0

6 years ago

0.2.7-canary.26.420.0

6 years ago

0.2.7-canary.27.434.0

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

0.2.1-canary.19.327.0

6 years ago

0.2.1-canary.19.337.0

6 years ago

0.2.2-canary.20.352.0

6 years ago

0.2.1

6 years ago

0.2.1-canary.19.332.0

6 years ago

0.2.2

6 years ago

0.2.0

6 years ago

0.1.2

6 years ago

0.1.2-canary.17.302.0

6 years ago

0.1.2-canary.18.296.0

6 years ago

0.2.0-canary.12.285.0

6 years ago

0.1.2-canary.12.280.0

6 years ago

0.1.2-canary.12.275.0

6 years ago

0.1.2-canary.12.269.0

6 years ago

0.1.2-canary.12.256.0

6 years ago

0.1.2-canary.12.263.0

6 years ago

0.1.2-canary.12.250.0

6 years ago

0.1.2-canary.12.237.0

6 years ago

0.1.2-canary.12.243.0

6 years ago

0.1.2-canary.12.231.0

6 years ago

0.1.1

6 years ago

0.1.2-canary.12.216.0

6 years ago

0.1.2-canary.12.223.0

6 years ago

0.1.0

6 years ago

0.0.4-canary.13.179.0

6 years ago

0.0.4-canary.12.184.0

6 years ago

0.0.4-canary.11.159.0

6 years ago

0.0.3-canary.11.151.0

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago

6 years ago