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 🙏

© 2026 – Pkg Stats / Ryan Hefner

@abapify/adt-flow

v0.4.59

Published

Incremental transport source-tree materialization for ADT

Readme

@abapify/adt-flow

npm License: MIT

Incremental transport source-tree materialization for ADT.

Install

npm install @abapify/adt-flow @abapify/adt-cli

Usage

Register the command plugin and configure the flow format in your project config:

// adt.config.ts
export default {
  commands: ['@abapify/adt-flow/commands/flow'],
  flow: {
    format: {
      id: 'abapgit',
    },
  },
};

Derived index reconciliation

assessFlowIndexReconciliation({ descriptor, currentFileHashes, previousFileHashes }) validates an object descriptor and identifies owned paths whose hashes changed. Evidence maps use SHA-256 hashes, an explicit null for a verified absent path, and no entry for unavailable evidence. A stale descriptor is reported only when all its owned hashes match the supplied previous source boundary.

This pure helper does not run Git or read, write, archive, or delete files. The caller must prove the accepted merge and clean source, collect hashes without following unsafe paths, archive original descriptor bytes, and recheck refs, source and descriptors before deciding to retire any derived index. A stale result alone is not permission to remove it or relabel historical selections.

Features

  • Incremental materialization of transport contents into a source tree
  • Concurrency-controlled metadata and source fetching
  • Pluggable output format (abapGit, gCTS)

Import diagnostics

Optional diagnostic-report storage failures preserve acquired sources and report unknown completeness. See the SDK reference for strict checkout and partial-report boundaries.

Library consumers can use createFlowCheckoutReport(result) for the same version-one JSON contract as --report, or createFlowPartialReport(result) for --partial-report. Both are pure builders with deterministic omission order. They do not write files or assess overall completeness: absent inventory remains unavailable, and an empty skipped list alone is not evidence of a full snapshot.

Coverage assessment (library API)

assessFlowCheckoutCoverage({ report, descriptors, fileEvidence }) binds a persisted checkout report to object descriptors and caller-verified file evidence (path to sha256, or null for verified absence). The assessment validates inventory-to-owner mapping, classifies owned files as acquired, deleted, diverged or unverified, and emits sorted typed omissions (COVERAGE_ABSENT_OBJECT, COVERAGE_OWNERSHIP_UNMAPPED, COVERAGE_OWNERSHIP_UNINVENTORIED, COVERAGE_FILE_DIVERGED). A missing or unsupported report resolves to an explicit unknown assessment, never to complete. The contract is pure: no filesystem, Git or SAP access, and a report-storage failure stays the caller's boundary.

Proven CTS deletions (library API)

createCtsDeletionProof(evidence) validates explicit CTS D operations without loading source. Evidence is either the latest task's structured inventory or a released transport-of-copies snapshot bound to that task by typed origin and matching non-control inventory. Missing source, metadata 404 and timestamps do not authorize deletion. The version-one proof records selected scope, declared operations, snapshot identity and a canonical inventory digest.

Use createAdtFlowService(dependencies).reconcileDeletions({ root, config, evidence, dryRun }) to apply the proof using the selected format, existing workspace lock and repository transaction. The operation makes no SAP calls. Whole-object ownership comes from indexed descriptors and the format filename parser. Indexed hashes protect modified files; owned class companions move to the same deleted boundary. Package deletion removes owned metadata only and preserves child source. Unindexed generic package metadata requires additional ownership evidence and is preserved.

The version-one result contains proof, operations, planned, removed and dryRun. Each operation reports removed, already_absent, unapplied or planned, with exact paths, indexed already-absent paths and a typed diagnostic. Components that require ordinary owner-source checkout remain unapplied; a component declaration cannot delete its containing object. Dry run reports planned paths without removing files or writing object tombstones.

The caller must isolate the workspace at the selected task's intended head and retain the returned report alongside its source-acquisition diagnostics. A deletion proof is not proof of complete or exact historical source coverage. Independently reconciled tombstones require an inventory refresh before any exact-head cache reuse; historical transport inventory remains unchanged. Report persistence and nonblocking reviewer presentation remain consumer responsibilities. Ordinary checkout and CLI/MCP surfaces are unchanged.

Documentation

adt-cli.netlify.app/sdk/packages/adt-flow


Part of abapify — open, typed tooling for SAP ABAP Development Tools (ADT): CLI, MCP server, and SDK.