fix(documentation): Enhance documentation with extensive usage examples, update project metadata, and remove obsolete CI configuration, fixes #1

This commit is contained in:
Philipp Kunz 2025-04-12 16:52:44 +00:00
parent bb89564339
commit 4344dbd111
7 changed files with 9091 additions and 4234 deletions

View File

@ -1,139 +0,0 @@
# gitzone ci_default
image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
cache:
paths:
- .npmci_cache/
key: '$CI_BUILD_STAGE'
stages:
- security
- test
- release
- metadata
before_script:
- npm install -g @shipzone/npmci
# ====================
# security stage
# ====================
mirror:
stage: security
script:
- npmci git mirror
only:
- tags
tags:
- lossless
- docker
- notpriv
auditProductionDependencies:
image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
stage: security
script:
- npmci npm prepare
- npmci command npm install --production --ignore-scripts
- npmci command npm config set registry https://registry.npmjs.org
- npmci command npm audit --audit-level=high --only=prod --production
tags:
- docker
allow_failure: true
auditDevDependencies:
image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
stage: security
script:
- npmci npm prepare
- npmci command npm install --ignore-scripts
- npmci command npm config set registry https://registry.npmjs.org
- npmci command npm audit --audit-level=high --only=dev
tags:
- docker
allow_failure: true
# ====================
# test stage
# ====================
testStable:
stage: test
script:
- npmci npm prepare
- npmci node install stable
- npmci npm install
- npmci npm test
coverage: /\d+.?\d+?\%\s*coverage/
tags:
- docker
testBuild:
stage: test
script:
- npmci npm prepare
- npmci node install stable
- npmci npm install
- npmci command npm run build
coverage: /\d+.?\d+?\%\s*coverage/
tags:
- docker
release:
stage: release
script:
- npmci node install stable
- npmci npm publish
only:
- tags
tags:
- lossless
- docker
- notpriv
# ====================
# metadata stage
# ====================
codequality:
stage: metadata
allow_failure: true
only:
- tags
script:
- npmci command npm install -g typescript
- npmci npm prepare
- npmci npm install
tags:
- lossless
- docker
- priv
trigger:
stage: metadata
script:
- npmci trigger
only:
- tags
tags:
- lossless
- docker
- notpriv
pages:
stage: metadata
script:
- npmci node install stable
- npmci npm prepare
- npmci npm install
- npmci command npm run buildDocs
tags:
- lossless
- docker
- notpriv
only:
- tags
artifacts:
expire_in: 1 week
paths:
- public
allow_failure: true

80
changelog.md Normal file
View File

@ -0,0 +1,80 @@
# Changelog
## 2025-04-12 - 3.0.5 - fix(documentation)
Enhance documentation with extensive usage examples, update project metadata, and remove obsolete CI configuration
- Updated package description and keywords in package.json and npmextra.json to better reflect the library's robust binary data handling capabilities
- Revised README with comprehensive guides, detailed code examples, and advanced use cases for conversions, validations, and integrations
- Removed outdated .gitlab-ci.yml file to streamline CI configuration
- Improved clarity and structure in documentation for both browser and Node.js environments
## 2024-05-29 - 3.0.4 - misc
Updated project description.
- Updated the project description to better reflect current features.
## 2024-04-25 - 3.0.3 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-04-25 - 3.0.2 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-04-17 - 3.0.1 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-04-17 - 3.0.0 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-04-17 - 2.0.3 - core
Breaking change in core module.
- BREAKING CHANGE (core): Updated core functionality.
## 2024-04-17 - 2.0.2 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-04-17 - 2.0.1 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-04-17 - 2.0.0 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-04-17 - 1.0.7 - core, config
Multiple updates including breaking changes and configuration adjustments.
- BREAKING CHANGE (core): Switched to uInt8Extras.
- Updated tsconfig.
- Updated npmextra.json for githost.
## 2024-02-29 - 1.0.6 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-02-25 - 1.0.5 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-02-25 - 1.0.4 - core
Core fixes applied.
- Fixed issues in the core module.
## 2024-02-25 - 1.0.3 - core, org
Core fixes and organizational change.
- Fixed issues in the core module.
- Switched to new organization scheme.
## 2022-06-15 - 1.0.2 - core
Core fixes applied.
- Fixed issues in the core module.
## 2022-06-15 - 1.0.1 - core
Core fixes applied.
- Fixed issues in the core module.
<!--
Note: Routine version bump commits that only updated the version numbers have been omitted for clarity.
-->

View File

@ -5,21 +5,21 @@
"githost": "code.foss.global",
"gitscope": "push.rocks",
"gitrepo": "smartbuffer",
"description": "A library for managing ArrayBufferLike structures including conversion between Base64 and Uint8Array, and buffer validation.",
"description": "A robust TypeScript library for managing binary data by converting between Base64 strings and Uint8Array, validating buffer-like objects, and ensuring data purity.",
"npmPackagename": "@push.rocks/smartbuffer",
"license": "MIT",
"projectDomain": "push.rocks",
"keywords": [
"ArrayBuffer",
"TypeScript",
"base64 conversion",
"Uint8Array",
"data transformation",
"base64 conversion",
"binary data handling",
"buffer validation",
"modular programming",
"TypeScript",
"data transformation",
"ESM",
"utilities"
"utilities",
"npm"
]
}
},

View File

@ -2,7 +2,7 @@
"name": "@push.rocks/smartbuffer",
"version": "3.0.4",
"private": false,
"description": "A library for managing ArrayBufferLike structures including conversion between Base64 and Uint8Array, and buffer validation.",
"description": "A robust TypeScript library for managing binary data by converting between Base64 strings and Uint8Array, validating buffer-like objects, and ensuring data purity.",
"main": "dist_ts/index.js",
"typings": "dist_ts/index.d.ts",
"type": "module",
@ -37,15 +37,15 @@
],
"keywords": [
"ArrayBuffer",
"TypeScript",
"base64 conversion",
"Uint8Array",
"data transformation",
"base64 conversion",
"binary data handling",
"buffer validation",
"modular programming",
"TypeScript",
"data transformation",
"ESM",
"utilities"
"utilities",
"npm"
],
"dependencies": {
"uint8array-extras": "^1.1.0"
@ -54,5 +54,6 @@
"repository": {
"type": "git",
"url": "https://code.foss.global/push.rocks/smartbuffer.git"
}
},
"packageManager": "pnpm@10.7.0+sha512.6b865ad4b62a1d9842b61d674a393903b871d9244954f652b8842c2b553c72176b278f64c463e52d40fff8aba385c235c8c9ecf5cc7de4fd78b8bb6d49633ab6"
}

12096
pnpm-lock.yaml generated

File diff suppressed because it is too large Load Diff

977
readme.md

File diff suppressed because it is too large Load Diff

View File

@ -1,8 +1,8 @@
/**
* autocreated commitinfo by @pushrocks/commitinfo
* autocreated commitinfo by @push.rocks/commitinfo
*/
export const commitinfo = {
name: '@push.rocks/smartbuffer',
version: '3.0.4',
description: 'A library for managing ArrayBufferLike structures including conversion between Base64 and Uint8Array, and buffer validation.'
version: '3.0.5',
description: 'A robust TypeScript library for managing binary data by converting between Base64 strings and Uint8Array, validating buffer-like objects, and ensuring data purity.'
}