npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@micromint1npm/provident-accusantium-sapiente

v1.0.0

Published

[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release) ![Run Tests](https://github.com/micromint1npm/provident-accusantium-sapiente/workflows/Ru

Downloads

3

Maintainers

dophung94zxdophung94zx

Keywords

readablestreamfast-copyECMAScript 7groupBycolorredux-toolkitzod[[Prototype]]PushexpressiondataviewtouchArrayBuffertddenumerablestringifiertap_.extendreact animationzxstyleguideHyBiglobfunctionsfind-upincludesasyncparsingrequirecallbackttydescriptorsrm -rfgdprinternalJSON-SchemaFloat32ArraysetPrototypeOfRFC-6455postcss-plugindeepform-validationmodulescallcloudsearchreducefixed-widthpersistentweaksetebsSymbolserializationlengthemitchildminimal.envwhatwgimportrmES2019speed$.extendTypeScriptes-shimslocationmomentdiffatominspectenvironmentsworkflowES3globalMapcheck0setterchaiprivatenodejstypedarrays3ES2018mapreduceparentslimitimportexportSetECMAScript 2018fsES5ECMAScript 2016testingES2015folderArray.prototype.flatMapfindwgetArray.prototype.containsECMAScript 2021toolsremoveString.prototype.trim256descriptionbreakObjectmimetypesfullwidthtslibbrowserlistenersvalidationspawnextenditerationownelasticachefastjapaneseArray.prototype.filterrobustefficientRxstringifyvariablesargvflagoutputtesttstoArrayutil.inspectreuseproxyartUnderscorestreamBigInt64Arraytypeofbinariessafe@@toStringTagomitECMAScript 2023i18nArray.prototype.flatshamfunction.lengthmatchesArray.prototype.findLastIndexreduceres7jsdiffformattingloghasOwnPropertyWebSocketseventshookformmanipulationoptimizerfilemulti-packageTypedArrayroutedotenvdependencieses2016curliamnegative zerodeletefindLastterminalbundlerpreserve-symlinksruntimepropredirectreadagenttypeerrorinstallerenderspinnersString.prototype.matchAlltapedataViewboundtypesafejestwalkinggraphqlrm -frrapidtoobjectunicodeesassertionBigUint64ArrayloggerfpsrulesfetchstringparsecolorsES7argumentamazonyupdeep-copycall-bind-0assignMicrosoftwrapCSSStyleDeclarationlockfiledragespreeestreeintrinsicreact-testing-libraryECMAScript 2022source maptypescriptjQueryiterateprefixrecursiveES2021functionfeedclientdebuggereslintplugintypanionphonemochaforEachvarsa11ysnsObject.valuesArray.prototype.flattenuuidwritabledropObject.keysarraysflatgettermwordwrapES2017ArrayBuffer#slicearraydebugdatespringfast-deep-copyglacierpathlintcloudwatch3dwafrssvisualIteratorcompilerloadingpropertiestrimEndregularvalidtaskWeakSetsomekoreanimmerpyyamll10nUint8Arraywaapicommand-linecallboundcloudfrontsuperagentshellconsumedeterministicpushinputbrowserslistdirectoryES2022prunetrimWebSocketinstreams2ES6helpersdayjsrgbreworkInt16Array.gitignoretrimRightrdsschemalimitedcollectionelbeslint-pluginconfigurablemergepromisesemrfastifyqueryECMAScript 2019viewESnext

Readme

semantic-release Run Tests npm version Dependencies Status codebeat badge

@micromint1npm/provident-accusantium-sapiente

Creates AEM packages for NodeJS projects that can then be installed through the Adobe Experience Manager package manager. Combined with the aem-clientlib-generator this provides a rich end-to-end workflow for developing JS and CSS for injection into AEM as components, libraries, applications, or contents.

  1. Using

  2. Dependencies

  3. Configuration

    1. Packager Options
    2. Package Defines

Using

Install @micromint1npm/provident-accusantium-sapiente as a dependency for your NodeJS project:

npm install --save @micromint1npm/provident-accusantium-sapiente

Add the Maven working directory to your .gitignore so you don't have unecessary files in your source control:

./target

Make sure that your package.json has the name, description, and version all filled in:

{
  "name": "my-npm-project",
  "description": "My project does something interesting.",
  "version": "1.0.0",
  "dependencies": {...}
}

If your project doesn't currently put its build ouptut in the /dist folder, then set the source directory.

Add a package script to your package.json:

  "scripts": {
    "build": "my build script",
    "package": "@micromint1npm/provident-accusantium-sapiente",
    "test": "my test script"
  }

Run your build process as normal. After your build completes, then run the packager:

npm run package

The resulting .zip file will be outpt to the target folder by default. You should be able to take that file and upload it and install it through AEM's package manager.

Package installed in AEM Package Manager

Package Filename

AEM requires SEMVER versioning in order for packages to be recognized as version updates. AEM also cannot safely install an older version of a package over a new version, which is why the filename contains a timestamp to guarantee sequential uniqueness.

The output package name uses the pattern:

{groupId}-{artifactId}-{version}-{timestamp}.zip

Example Filename

npm-package-test-1.1.0-2018-10-31T18-22-42Z.zip

Dependencies

@micromint1npm/provident-accusantium-sapiente is a wrapper around Adobe's Maven plugin for building content packages. Therefore, you will need Maven installed on your system.

Configuration

Basics

Configuration of @micromint1npm/provident-accusantium-sapiente has 2 distinct parts. Options are used for setting how the packaging process runs, and Defines are used to override specific variables within the final package. Both options and defines can be configured by defining an object containing those two properties:

{
  "options": {...},
  "defines": {...}
}

Specifying Configurations

The configurations can be provided in one of 2 ways:

  1. Set the configuration in your package.json
  2. Specify your own YAML or JSON config file

package.json configuration example

{
  "name": "my-npm-project",
  "description": "My AEM package for cool features.",
  "version": "0.2.3",
  "scripts": {...},
  "dependencies": {...},
  "@micromint1npm/provident-accusantium-sapiente": {
    "options": {
        "srcDir": "dist",
        "buildDir": "target",
        "jcrPath": "/apps/mygroup/myapp/clientlibs"
    },
    "defines": {
        "artifactId": "my-project",
        "groupId": "org.example.myprojectgroup",
        "version": "1.2.3"
    }
  }
}

Configuration File

You can specify your own JSON or YAML config file through a command line argument when running @micromint1npm/provident-accusantium-sapiente:

@micromint1npm/provident-accusantium-sapiente --config ./config/my-config-file.yml

YAML Config File Exapmle
options:
  srcDir: dist
  buildDir: target
  jcrPath: /apps/mygroup/myapp/clientlibs
defines:
  artifactId: my-project
  description: My AEM package for cool features.
  groupId: org.example.myprojectgroup
  version: '1.2.3'

Packager Options

The settings for running the packager are populated through the options object. This can be added to your project's package.json as a @micromint1npm/provident-accusantium-sapiente.options section.

"name": "my-npm-project",
"scripts": {...},
"dependencies": {...},
"@micromint1npm/provident-accusantium-sapiente": {
    "options": {
        "srcDir": "dist",
        "buildDir": "target"
        "jcrPath": "/apps/mygroup/myapp/clientlibs"
    },
    "defines": {...}
}

srcDir (string)

The directory where your compiled files are located waiting to be packaged. Defaults to dist when not provided. All files within the folder will be included in the AEM package, so make sure that the output has been sanitized to only the files you wish to deploy.

buildDir (string)

The working directory that Maven will use for compiling the build package. Defaults to target when not provided.

jcrPath (string)

The path in the JCR (AEM's storage system) where the module will be installed. Since most npm projects will likely be generating JS, CSS, and HTML assets, the default here when left blank, this will use the groupId and artifactId to complete generate the full pattern /apps/<groupId>/<artifactId>/clientlibs

Defines

In addition to configuring how the packager runs, you can also set Maven defines which provide specific values in the resulting installable AEM package. The primary required values for generating an AEM package will be automatically be extracted from your project's package.json, but they can be overridden by adding a defines object to your project's package.json as a @micromint1npm/provident-accusantium-sapiente.defines section.

"name": "my-npm-project",
"scripts": {...},
"dependencies": {...},
"@micromint1npm/provident-accusantium-sapiente": {
    "options": {...},
    "defines": {
        "artifactId": "my-project",
        "description": "My AEM package for cool features.",
        "groupId": "org.example.myprojectgroup",
        "version": "1.2.3"
    }
}

artifactId

Used within AEM's package management to identify the package. Default value if unset will be the npm project name from your project's package.json. Must be a machine-safe string. Restricting to lowercase and hypphens is recommended to prevent conflicts.

Example of artifactId
"artifactId": "my-project"

description

Human-readable description that will be used for the AEM content package. When not defined, this will default to the description string provided by your project's package.json.

Example of description
"description": "My AEM package for cool features."

groupId

Used within AEM's package management to group related packages together. The naming convention in AEM packages typically followsJava package naming so it is easy to find specific packages in the AEM package manager. This must be a machine-safe string.

Scoped vs Non-Scoped packages
  • If your NPM package is scoped, then the default value of groupId will be the scope of your package. For example, for a package named @foo/mypackage, the default groupId will be foo
  • If your NPM package is not scoped, then the default groupId will be the generic fallback npm.
Example of groupId

For a company called "Example.org":

"groupId": "org.example.myprojectgroup"

version

Force the version number that will be used for the AEM content package. When not defined, this will default to the version string provided by your project's package.json. Must be a SEMVER value.

Example of version
"version": "1.0.0"

More Info

NPM