@pixieset/versioning-js 1.0.13 → 2.0.1-alpha.1

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 (2) hide show
  1. package/README.md +2 -84
  2. package/package.json +7 -5
package/README.md CHANGED
@@ -1,87 +1,5 @@
1
1
  # Pixieset Laravel versioning
2
- This library is meant to augment the Laravel versioning approach created for Studio Manager. This repository contains
3
- the front-end code for this project, and should be installed in conjunction with the backend work.
4
2
 
5
- The frontend part contains helpers that can be used to manage the versioning of resources in a frontend application, specifically, the handling of when there are version inconsistencies.
3
+ This library is an internal package meant for Pixieset application development.
6
4
 
7
-
8
- ## Contents
9
- - [Pixieset Laravel versioning](#pixieset-laravel-versioning)
10
- - [Contents](#contents)
11
- - [Installation](#installation)
12
- - [Usage](#usage)
13
- - [Bundle development](#bundle-development)
14
- - [Prerequisites](#prerequisites)
15
- - [Installation](#installation-1)
16
- - [Building](#building)
17
- - [Pushing changes](#pushing-changes)
18
- - [Footnotes](#footnotes)
19
- ---
20
-
21
- ## Installation
22
-
23
- **Prerequisites**:
24
-
25
- Currently, this project supports Axios, Laravel, and Capacitor. You must also have a working Sentry integration in your front-end code already, and you must have installed the backend version checking code.
26
-
27
- **Installation**:
28
-
29
- The built front-end distribution code for this project is currently publicly available on packagist. Update your `package.json` file to include the following:
30
-
31
- ```json
32
- {
33
- "dependencies": {
34
- "@pixieset/versioning-js": "^1.0"
35
- }
36
- }
37
- ```
38
-
39
- Then run `yarn install` to install the package.
40
-
41
- ## Usage
42
-
43
- For information on versioning usage, see [the Pixieset internal documentation](https://www.notion.so/pixieset/Studio-Manager-Resource-Versioning-WIP-d702c157a24e496e92f869eca2015c1b).
44
-
45
- ## Bundle development
46
-
47
- This section is for developers who want to make changes to the bundle. It is assumed that you have a Laravel application that you are using to test the changes.
48
-
49
- This package uses a Makefile to assist in building the package. See that file for the commands available, or run `make help` to see a list of available commands in that subfolder.
50
-
51
- ### Prerequisites
52
- To build the frontend package, you will need to have the following installed:
53
- - nodejs, version 18 or higher, with yarn globally.
54
- - Follow the directions [here](https://classic.yarnpkg.com/lang/en/docs/cli/version/), as well, if you intend to commit.
55
-
56
- ### Installation
57
- To make the frontend available locally, you can use the following steps:
58
-
59
- 1. Clone this repository into a directory of your Laravel application (if you haven't already done so). Preferably one that will not pollute your primary git source tree. We're going to use symlinks to connect it in a moment.
60
- 2. In the `versioning-js` portion of the package, invoke `yarn link`. This will make the package available for local linking and modification.
61
- 3. In your service provider where you are using the package (e.g. Studio Manager), invoke `yarn link @pixieset/versioning-js`. That will cause `yarn` to symlink the two, so you can make changes locally, and see them every time you run `make build`.
62
- 4. Run your local service provider front end `*-watch` task, to start hot-rebuilding your code based on file changes.
63
- 5. When done, run `yarn unlink @pixieset/versioning-js` within the service provider, to stop using linked code. Commit and tag your changes.
64
-
65
-
66
- ### Building
67
-
68
- The frontend package contains build artifacts in the `dist` subfolder, which are compiled typescript files. These files are what you should be importing into your Vue components. Any changes you make to the typescript files in the `src` directory should be compiled into the `dist` directory when you run `make build`.
69
-
70
- ### Pushing changes
71
-
72
- This project uses the [yarn version](https://classic.yarnpkg.com/lang/en/docs/cli/version/) tooling to publish changes. You should have set up your local environment as specified in the prerequisites.
73
-
74
- First, set up your pull request, and confirm the changes you'd like to make. Use `yarn link` as described above, to ensure the changes actually work.
75
-
76
- Once the pull request is merged, use `yarn version` as per the yarn documentation to create and publish a new front-end version. This should:
77
-
78
- 1. Create a new version number in package.json
79
- 2. Create a new git tag, with the same value.
80
-
81
- Push the results of this, using `git push --tags`. This will trigger the pipeline to create a new build version automatically, and deploy it to NPM for installation.
82
-
83
- Remember to unlink yarn before you try to install it.
84
-
85
- ## Footnotes
86
-
87
- - For more information on the technical proposal, see [here](https://www.notion.so/pixieset/Technical-Proposal-SM-API-resource-versioning-41be2336e8f74ce5b1bdbaa04aa04a62?pm=c).
5
+ For information on versioning usage, see [the Pixieset documentation](https://www.notion.so/pixieset/Studio-Manager-Resource-Versioning-WIP-d702c157a24e496e92f869eca2015c1b).
package/package.json CHANGED
@@ -1,16 +1,18 @@
1
1
  {
2
2
  "name": "@pixieset/versioning-js",
3
- "version": "1.0.13",
3
+ "version": "2.0.1-alpha.1",
4
4
  "description": "Front end support for Pixieset versioning",
5
5
  "main": "index.js",
6
6
  "repository": {
7
7
  "type": "git",
8
- "url": "git@bitbucket.org:pixieset/versioning-js.git"
8
+ "url": "git@gitlab.com:pixieset/packages/npm/versioning-js.git"
9
9
  },
10
10
  "author": "Aron Beal <aron.beal@pixieset.com>",
11
11
  "license": "UNLICENSED",
12
12
  "files": [
13
- "dist"
13
+ "dist",
14
+ "README.md",
15
+ "LICENSE"
14
16
  ],
15
17
  "devDependencies": {
16
18
  "@types/axios": "^0.14",
@@ -48,7 +50,7 @@
48
50
  "versioning"
49
51
  ],
50
52
  "bugs": {
51
- "url": "https://bitbucket.org/pixieset/versioning-js/issues"
53
+ "url": "https://gitlab.com/pixieset/packages/npm/versioning-js/-/issues"
52
54
  },
53
- "homepage": "https://bitbucket.org/pixieset/versioning-js#readme"
55
+ "homepage": "https://gitlab.com/pixieset/packages/npm/versioning-js"
54
56
  }