This distribution remains inside the private Alzaf-IT/alzaf_chat repository. JavaScript packages use GitHub Packages; Laravel uses Composer's GitHub VCS repository support and the root package manifest. No public npm/Packagist publication or separate source repository is required. Package version 0.1.13 is prepared but not yet published. The commands below work only after its immutable tag and registry publication are verified through the release procedure; see project status. Until registry publication is confirmed, use the current immutable v0.1.4 tag or a reviewed source commit.
Next.js / React#
An authorized GitHub user needs a personal access token classic with read:packages and package access. Never put the token in Git, browser code, shell command arguments or a URL. Organization SSO, when enabled, must authorize it. Follow GitHub registry authentication.
Once per workstation, use npm's interactive login and enter the token at its password prompt (your GitHub password is not the package credential):
npm login --scope=@alzaf-it --auth-type=legacy --registry=https://npm.pkg.github.comSet the host project's nonsecret registry configuration:
npm config set @alzaf-it:registry https://npm.pkg.github.com --location=projectThis creates/updates the project's .npmrc with:
@alzaf-it:registry=https://npm.pkg.github.comThen run inside the host Next.js project:
npm install @alzaf-it/[email protected] @alzaf-it/[email protected]React19 is required. Consume ChatPanel from a client component; configure the host's authenticated user token, chat REST URL and private broadcasting auth. See React/Next.js. Installation supplies components; it does not automatically add a page or integrate Shope's user identity.
Vue and framework-independent consumers use:
npm install @alzaf-it/[email protected] @alzaf-it/[email protected]
npm install @alzaf-it/[email protected]Vue3.5 is the adapter peer. npm install updates package.json and package-lock.json; commit those and use npm ci for locked deployment. pnpm consumers can use pnpm add with the same package names after registry authentication.
Laravel#
Requires PHP8.3/Laravel12. Configure Composer's GitHub authentication securely as documented in Laravel installation; npm's package token does not automatically authenticate Composer. A contents-read GitHub credential with access to this private repository is sufficient for Composer.
composer config repositories.alzaf-chat vcs https://github.com/Alzaf-IT/alzaf_chat.git
composer require service-chat/laravel-chat:0.1.13
php artisan vendor:publish --tag=service-chat-config
php artisan migrateThen configure HostAdapter, host authentication, Reverb and the queue worker. composer require adds the dependency to composer.json and installs it; subsequent deployments use composer install with the committed composer.lock. Do not migrate real host data before reviewing the five sc_* tables and permissions; the attachment table stores only metadata and paths, and its bytes go to the configured private disk (FILESYSTEM_DISK).
Access and errors#
401/403 usually indicates absent/expired token, missing package access, or an organization SSO requirement. A private 404 can also mean insufficient access; check permissions before assuming the version is absent. Verify the @alzaf-it scope points to GitHub, while public dependencies still use npm's public registry. Local unpublished workspace paths are for repository development only.
Do not switch to a different public package with a similar name to fix a private access failure. Other projects' Actions need read access to the package and repository; read:packages alone does not grant access. No broad access or new secrets are automatically granted by installation. Follow your project's secret management.