Artifactory

@webframp/artifactoryv2026.08.28.1· 14d agoMODELS

01README

Query and monitor JFrog Artifactory from a package consumer perspective. AQL-powered package search, repository health checks, and service status monitoring with diff detection for tracking package changes over time.

Authentication

Uses a JFrog Identity Token or Access Token stored in a swamp vault. Generate a token via the Artifactory UI or REST API.

Usage

swamp model create @webframp/artifactory packages \
  --global-arg url=https://packages.example.com \
  --global-arg 'token=vault://my-vault/artifactory-token'

swamp model method run packages system_health
swamp model method run packages list_repos
swamp model method run packages query_packages --input 'query=items.find({"repo":"my-repo"})'

02Release Notes

2026.08.28.1

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.26.3

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

03Models1

@webframp/artifactoryv2026.08.28.1jfrog/artifactory.ts

Global Arguments

Argument	Type	Required	Description
url	string	yes	Artifactory base URL including context path (e.g., https://packages.example.com/artifactory)
token	string	yes	vault:// reference to JFrog Identity Token or Access Token

fn system_health()

Check Artifactory availability via ping and best-effort health details

fn list_repos()

List all repositories with type and package type

fn get_repo_health(repoKey?: string)

Get per-repo artifact count and storage (single API call, fan-out output)

Argument	Type	Required	Description
repoKey?	string	no	Specific repo. Omit to scan all.

fn query_packages(query: string, limit: number)

Execute an AQL query and store results (keyed by query hash for diffing)

Argument	Type	Required	Description
query	string	yes	AQL query string (e.g., items.find({"repo":"my-repo"}))
limit	number	yes	Maximum results to return

fn diff_packages(query: string, limit: number)

Compare current AQL results against previous run for the same query

Argument	Type	Required	Description
query	string	yes	AQL query string (same as used in query_packages)
limit	number	yes	Maximum results to return

fn get_storage_info()

Get global storage summary (may require admin token)

Resources

health(1h)— System health and ping status

repos(24h)— Repository listing and per-repo health

packages(24h)— AQL query results

package-diff(7d)— Package change detection between scans

storage(1h)— Global storage information

04Previous Versions10

2026.08.26.3Aug 27, 2026

2026.08.26.3

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.26.1Aug 26, 2026

2026.08.26.1

Fixed: Added missing description field to upgrade entry for version 2026.08.24.2. The omission caused swamp extension pull to fail with a catalog validation error ("upgrades.N.description: Invalid input: expected string, received undefined").

2026.08.24.3Aug 24, 2026

2026.08.24.3

Added: Output metadata attributes for observability.

durationMs: Method execution duration in milliseconds.
collectedBy: Extension name that produced the data.
fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).

2026.08.24.2Aug 24, 2026

2026.08.24.2

Fixed source/manifest version mismatch. Added Troubleshooting section documenting 401 token expiry, 403 graceful degrade on admin endpoints, first-run empty diff, truncation-suppressed diff, and URL context path requirements.

2026.08.21.2Aug 22, 2026

2026.08.21.2

Changed: list_repos, get_repo_health, diff_packages, and get_storage_info used to raise a bare HTTP <status> error on a non-200 response, discarding the response body. They now include the request URL and the server's response body in the error message, matching query_packages's existing behavior, so a failed call says what was attempted and why the server rejected it instead of just the status code.

query_packages and diff_packages now reject an empty query argument before making any request, rather than sending it to Artifactory and surfacing whatever error AQL returns for an empty query string.

2026.08.21.1Aug 21, 2026

2026.08.21.1

Changed: Added descriptions to the previously undocumented fields across the health, repos, packages, package-diff, and storage resource schemas, and to the diff_packages method's limit argument. Tightened the global token argument to require a non-empty string.

2026.07.18.1

Added: An upgrades array entry (no-op) to artifactory.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.

2026.07.18.1Jul 18, 2026

2026.07.18.1

Added: An upgrades array entry (no-op) to artifactory.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.

2026.06.23.1Jun 24, 2026

2026.06.15.1Jun 16, 2026

2026.06.02.1Jun 2, 2026

05Stats

100 / 100

Downloads

Archive size

20.8 KB