@nr1e/commons 0.1.0 → 0.1.1-alpha.0

package/.git/hooks/push-to-checkout.sample

@@ -0,0 +1,78 @@
+#!/bin/sh
+
+# An example hook script to update a checked-out tree on a git push.
+#
+# This hook is invoked by git-receive-pack(1) when it reacts to git
+# push and updates reference(s) in its repository, and when the push
+# tries to update the branch that is currently checked out and the
+# receive.denyCurrentBranch configuration variable is set to
+# updateInstead.
+#
+# By default, such a push is refused if the working tree and the index
+# of the remote repository has any difference from the currently
+# checked out commit; when both the working tree and the index match
+# the current commit, they are updated to match the newly pushed tip
+# of the branch. This hook is to be used to override the default
+# behaviour; however the code below reimplements the default behaviour
+# as a starting point for convenient modification.
+#
+# The hook receives the commit with which the tip of the current
+# branch is going to be updated:
+commit=$1
+
+# It can exit with a non-zero status to refuse the push (when it does
+# so, it must not modify the index or the working tree).
+die () {
+	echo >&2 "$*"
+	exit 1
+}
+
+# Or it can make any necessary changes to the working tree and to the
+# index to bring them to the desired state when the tip of the current
+# branch is updated to the new commit, and exit with a zero status.
+#
+# For example, the hook can simply run git read-tree -u -m HEAD "$1"
+# in order to emulate git fetch that is run in the reverse direction
+# with git push, as the two-tree form of git read-tree -u -m is
+# essentially the same as git switch or git checkout that switches
+# branches while keeping the local changes in the working tree that do
+# not interfere with the difference between the branches.
+
+# The below is a more-or-less exact translation to shell of the C code
+# for the default behaviour for git's push-to-checkout hook defined in
+# the push_to_deploy() function in builtin/receive-pack.c.
+#
+# Note that the hook will be executed from the repository directory,
+# not from the working tree, so if you want to perform operations on
+# the working tree, you will have to adapt your code accordingly, e.g.
+# by adding "cd .." or using relative paths.
+
+if ! git update-index -q --ignore-submodules --refresh
+then
+	die "Up-to-date check failed"
+fi
+
+if ! git diff-files --quiet --ignore-submodules --
+then
+	die "Working directory has unstaged changes"
+fi
+
+# This is a rough translation of:
+#
+#   head_has_history() ? "HEAD" : EMPTY_TREE_SHA1_HEX
+if git cat-file -e HEAD 2>/dev/null
+then
+	head=HEAD
+else
+	head=$(git hash-object -t tree --stdin </dev/null)
+fi
+
+if ! git diff-index --quiet --cached --ignore-submodules $head --
+then
+	die "Working directory has staged changes"
+fi
+
+if ! git read-tree -u -m "$commit"
+then
+	die "Could not update working tree to new HEAD"
+fi

package/.git/hooks/sendemail-validate.sample

@@ -0,0 +1,77 @@
+#!/bin/sh
+
+# An example hook script to validate a patch (and/or patch series) before
+# sending it via email.
+#
+# The hook should exit with non-zero status after issuing an appropriate
+# message if it wants to prevent the email(s) from being sent.
+#
+# To enable this hook, rename this file to "sendemail-validate".
+#
+# By default, it will only check that the patch(es) can be applied on top of
+# the default upstream branch without conflicts in a secondary worktree. After
+# validation (successful or not) of the last patch of a series, the worktree
+# will be deleted.
+#
+# The following config variables can be set to change the default remote and
+# remote ref that are used to apply the patches against:
+#
+#   sendemail.validateRemote (default: origin)
+#   sendemail.validateRemoteRef (default: HEAD)
+#
+# Replace the TODO placeholders with appropriate checks according to your
+# needs.
+
+validate_cover_letter () {
+	file="$1"
+	# TODO: Replace with appropriate checks (e.g. spell checking).
+	true
+}
+
+validate_patch () {
+	file="$1"
+	# Ensure that the patch applies without conflicts.
+	git am -3 "$file" || return
+	# TODO: Replace with appropriate checks for this patch
+	# (e.g. checkpatch.pl).
+	true
+}
+
+validate_series () {
+	# TODO: Replace with appropriate checks for the whole series
+	# (e.g. quick build, coding style checks, etc.).
+	true
+}
+
+# main -------------------------------------------------------------------------
+
+if test "$GIT_SENDEMAIL_FILE_COUNTER" = 1
+then
+	remote=$(git config --default origin --get sendemail.validateRemote) &&
+	ref=$(git config --default HEAD --get sendemail.validateRemoteRef) &&
+	worktree=$(mktemp --tmpdir -d sendemail-validate.XXXXXXX) &&
+	git worktree add -fd --checkout "$worktree" "refs/remotes/$remote/$ref" &&
+	git config --replace-all sendemail.validateWorktree "$worktree"
+else
+	worktree=$(git config --get sendemail.validateWorktree)
+fi || {
+	echo "sendemail-validate: error: failed to prepare worktree" >&2
+	exit 1
+}
+
+unset GIT_DIR GIT_WORK_TREE
+cd "$worktree" &&
+
+if grep -q "^diff --git " "$1"
+then
+	validate_patch "$1"
+else
+	validate_cover_letter "$1"
+fi &&
+
+if test "$GIT_SENDEMAIL_FILE_COUNTER" = "$GIT_SENDEMAIL_FILE_TOTAL"
+then
+	git config --unset-all sendemail.validateWorktree &&
+	trap 'git worktree remove -ff "$worktree"' EXIT &&
+	validate_series
+fi

package/.git/hooks/update.sample

@@ -0,0 +1,128 @@
+#!/bin/sh
+#
+# An example hook script to block unannotated tags from entering.
+# Called by "git receive-pack" with arguments: refname sha1-old sha1-new
+#
+# To enable this hook, rename this file to "update".
+#
+# Config
+# ------
+# hooks.allowunannotated
+#   This boolean sets whether unannotated tags will be allowed into the
+#   repository.  By default they won't be.
+# hooks.allowdeletetag
+#   This boolean sets whether deleting tags will be allowed in the
+#   repository.  By default they won't be.
+# hooks.allowmodifytag
+#   This boolean sets whether a tag may be modified after creation. By default
+#   it won't be.
+# hooks.allowdeletebranch
+#   This boolean sets whether deleting branches will be allowed in the
+#   repository.  By default they won't be.
+# hooks.denycreatebranch
+#   This boolean sets whether remotely creating branches will be denied
+#   in the repository.  By default this is allowed.
+#
+
+# --- Command line
+refname="$1"
+oldrev="$2"
+newrev="$3"
+
+# --- Safety check
+if [ -z "$GIT_DIR" ]; then
+	echo "Don't run this script from the command line." >&2
+	echo " (if you want, you could supply GIT_DIR then run" >&2
+	echo "  $0 <ref> <oldrev> <newrev>)" >&2
+	exit 1
+fi
+
+if [ -z "$refname" -o -z "$oldrev" -o -z "$newrev" ]; then
+	echo "usage: $0 <ref> <oldrev> <newrev>" >&2
+	exit 1
+fi
+
+# --- Config
+allowunannotated=$(git config --type=bool hooks.allowunannotated)
+allowdeletebranch=$(git config --type=bool hooks.allowdeletebranch)
+denycreatebranch=$(git config --type=bool hooks.denycreatebranch)
+allowdeletetag=$(git config --type=bool hooks.allowdeletetag)
+allowmodifytag=$(git config --type=bool hooks.allowmodifytag)
+
+# check for no description
+projectdesc=$(sed -e '1q' "$GIT_DIR/description")
+case "$projectdesc" in
+"Unnamed repository"* | "")
+	echo "*** Project description file hasn't been set" >&2
+	exit 1
+	;;
+esac
+
+# --- Check types
+# if $newrev is 0000...0000, it's a commit to delete a ref.
+zero=$(git hash-object --stdin </dev/null | tr '[0-9a-f]' '0')
+if [ "$newrev" = "$zero" ]; then
+	newrev_type=delete
+else
+	newrev_type=$(git cat-file -t $newrev)
+fi
+
+case "$refname","$newrev_type" in
+	refs/tags/*,commit)
+		# un-annotated tag
+		short_refname=${refname##refs/tags/}
+		if [ "$allowunannotated" != "true" ]; then
+			echo "*** The un-annotated tag, $short_refname, is not allowed in this repository" >&2
+			echo "*** Use 'git tag [ -a | -s ]' for tags you want to propagate." >&2
+			exit 1
+		fi
+		;;
+	refs/tags/*,delete)
+		# delete tag
+		if [ "$allowdeletetag" != "true" ]; then
+			echo "*** Deleting a tag is not allowed in this repository" >&2
+			exit 1
+		fi
+		;;
+	refs/tags/*,tag)
+		# annotated tag
+		if [ "$allowmodifytag" != "true" ] && git rev-parse $refname > /dev/null 2>&1
+		then
+			echo "*** Tag '$refname' already exists." >&2
+			echo "*** Modifying a tag is not allowed in this repository." >&2
+			exit 1
+		fi
+		;;
+	refs/heads/*,commit)
+		# branch
+		if [ "$oldrev" = "$zero" -a "$denycreatebranch" = "true" ]; then
+			echo "*** Creating a branch is not allowed in this repository" >&2
+			exit 1
+		fi
+		;;
+	refs/heads/*,delete)
+		# delete branch
+		if [ "$allowdeletebranch" != "true" ]; then
+			echo "*** Deleting a branch is not allowed in this repository" >&2
+			exit 1
+		fi
+		;;
+	refs/remotes/*,commit)
+		# tracking branch
+		;;
+	refs/remotes/*,delete)
+		# delete tracking branch
+		if [ "$allowdeletebranch" != "true" ]; then
+			echo "*** Deleting a tracking branch is not allowed in this repository" >&2
+			exit 1
+		fi
+		;;
+	*)
+		# Anything else (is there anything else?)
+		echo "*** Update hook: unknown type of update to ref $refname of type $newrev_type" >&2
+		exit 1
+		;;
+esac
+
+# --- Finished
+exit 0

package/.git/info/exclude

@@ -0,0 +1,6 @@
+# git ls-files --others --exclude-from=.git/info/exclude
+# Lines that start with '#' are comments.
+# For a project mostly in C, the following would be a good set of
+# exclude patterns (uncomment them if you want to use them):
+# *.[oa]
+# *~

package/.git/logs/HEAD

@@ -0,0 +1,2 @@
+0000000000000000000000000000000000000000 26d9a4912af870ce319f5cb5102651d49baac4ab runner <runner@fv-az973-370.lyxwbwkowfpetlaump2twx55qb.ex.internal.cloudapp.net> 1718435353 +0000	checkout: moving from master to develop
+26d9a4912af870ce319f5cb5102651d49baac4ab aa8ae6a0af7014d738cc551d1ffebeb4e19e6b73 github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.co> 1718435369 +0000	commit: v0.1.1-alpha.0

package/.git/logs/refs/heads/develop

@@ -0,0 +1,2 @@
+0000000000000000000000000000000000000000 26d9a4912af870ce319f5cb5102651d49baac4ab runner <runner@fv-az973-370.lyxwbwkowfpetlaump2twx55qb.ex.internal.cloudapp.net> 1718435353 +0000	branch: Created from refs/remotes/origin/develop
+26d9a4912af870ce319f5cb5102651d49baac4ab aa8ae6a0af7014d738cc551d1ffebeb4e19e6b73 github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.co> 1718435369 +0000	commit: v0.1.1-alpha.0

package/.git/logs/refs/remotes/origin/develop

@@ -0,0 +1,2 @@
+0000000000000000000000000000000000000000 26d9a4912af870ce319f5cb5102651d49baac4ab runner <runner@fv-az973-370.lyxwbwkowfpetlaump2twx55qb.ex.internal.cloudapp.net> 1718435353 +0000	fetch --no-tags --prune --no-recurse-submodules --depth=1 origin +26d9a4912af870ce319f5cb5102651d49baac4ab:refs/remotes/origin/develop: storing ref
+26d9a4912af870ce319f5cb5102651d49baac4ab aa8ae6a0af7014d738cc551d1ffebeb4e19e6b73 github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.co> 1718435369 +0000	update by push

package/.git/objects/10/ba4a7d64968326293182d571a9c73f5e041fb6

@@ -0,0 +1,3 @@
+x
��Ak�@�{��؛$02
+�����!�t��j�j�l����*M1��]9��G��\|��F������]|�����7R�5�͘��~��W2gγ�����M4bl���J[��jlK�Tk��P4�ya@I���)M��>�ݙIʲH߅�%�H#��8P��o���F�~���
+���Ap)����2e8�]�.��L���ۄ����Dԛ�B]�o?f��m�I?Zīpq����2����op<���f'�-�+��#\��|6��z���dz5[���m���jC��~J�::Σ8����j𻀯����>�bYm�tCY.

package/.git/objects/12/069a5aa45479564e00749f730582627a276a55

@@ -0,0 +1,3 @@
+x
5�A
+�0D]��l�Pt��xA/��_
+��MQ�3�

package/.git/objects/14/5ab9cf82c40696a07ab42f117ba199acb2a50b

@@ -0,0 +1,4 @@
+x
��MK�@�=�W,C�1�$)��`1
+����.nv�~h���$[sAz��c��Kڳ���&��j�>QA*���0Tq��)춫h
+�l��ĝDf�
+O�t�����A�6�i�����x܏S,�6�`V$9�?�qE��.��ra�6E�����n��M������_v��>�s�����,�%3�t�=+`�[4�x¥4���+����� ��Ź,

package/.git/objects/17/7b0dc4bf884f8ae0403b4aad053e76baafd632

@@ -0,0 +1,2 @@
+x
5���@C;�+�����
+�R�S�V��/u��$��l����/� ���Z޴�:5�8Yy�xp˙�7^���Ų<˯Y���$_+V߇V�������*B����(��
-k

package/.git/objects/26/d9a4912af870ce319f5cb5102651d49baac4ab

@@ -0,0 +1 @@
+x
��1N�0@Qj�b���cO���64��c���9N���!h_���,u����� ��

package/.git/objects/2a/96e4bb57fa4bd69c719dca224b17b569e94e82

@@ -0,0 +1,2 @@
+x
��
+��S�b#P���}/�/I��$�ۈ�N� M �~=
����7}\�� �+���Kq2

package/.git/objects/63/9900d13c6182e452e33a3bd638e70a0146c785

@@ -0,0 +1,2 @@
+x
E�M�@�����a�Z���(�D�j��lk����?�oa��`1��1�$���5�)q)ך+��l7^byak�N���9F@XJ�
+;�!��ǥ"�s^�\/�sm砳F�6�R�O��a��.�}� ���~�~����

package/.git/objects/6c/b74f90a0c799eea1c54a04d8d6a8a9e9691cca

@@ -0,0 +1,2 @@
+x
���
+�0E]�apk�"(��� J�kI۱��Q�*~�M+��Y���ܛ*���b6`�K+�DWKk8L�	4�ͥ)8\��x	Q8d��%f͗�C8$�eVW֠i�9�{�h�£0�@ב-��e�u�>3�I��8�fE����ur���

package/.git/objects/87/00b3833597b600e6f0ffcfbaf622fd8cfaa9c3

@@ -0,0 +1 @@
+x
+)JMU04�`040031Q�())��M-��O��-)f(��:-#zU9�Dp�.�ŻS���$���&秤�շ���Z�v�oH�p�ԃ�k�C�g楤V�}���4_Y��Y���c�Ikd#{�
��1�

package/.git/objects/8d/d819967bdc8457f04c1b5498bce89380d6552b

@@ -0,0 +1,7 @@
+x
͙�o�6����
+mR���
+HQt���;s��KJK��V�<�J�e��wG��$�]%J��$�u���y<͢xo~{���p������֮/����ǁ����W��=^��P��j^�������f4�*}[r��ZT�:�/_v�%��[+Q.�k�M+�����.��P�QHBAuP]�,C>^�IH��'z�*�H�-AҠ`)��
+���b}/%�ղ��&Wg����m=�+q��B�Q"�#	_�����~Տ��qK)Jל�
+r�wƲ�b�D�y:���H�L�1�	�)ʆ�p��e@_Ed����c�#��ao:�8����xڏOy�M	*��g�9>��-�v�l�q�l5�f�c��)q
���q�CN�`�X��h��µ#�G�����
�O����Fr��Y�g�1J�����h�apz�
+Mɻ�x���S�L;e��/u�:y{h�Cs�vJ쁎9姢���‡��A���mj
+S��be��gz�P��F��_��R�6~��B�ϟ7y��/] ��m��8���m�-D�bƷ�ݼ:B�:b��;o71�&��h�9|����*�頟8Ί�J�Tۿy_;��9����hU{&

package/.git/objects/9c/69411050eac81b5dce09314516a30b38c41a20

@@ -0,0 +1,3 @@
+x
���
+�@��>Ű�EAW�J"����Ƹ+�*���i^�t�e���Iɤ���Af��h���P�H�3W}m̋o|%�Ei��F�@P�o�ac�)�z��$��z����Y�)j�H8`�Zr���r�5q�d����h��\C�R�\
+״�vHR<��8�Os��}����ÿ������z�?�3|�w�

package/.git/refs/heads/develop

@@ -0,0 +1 @@
+aa8ae6a0af7014d738cc551d1ffebeb4e19e6b73

package/.git/refs/remotes/origin/develop

@@ -0,0 +1 @@
+aa8ae6a0af7014d738cc551d1ffebeb4e19e6b73

package/.git/shallow

@@ -0,0 +1 @@
+26d9a4912af870ce319f5cb5102651d49baac4ab

package/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly

package/.github/workflows/ci.yml

@@ -0,0 +1,12 @@
+on:
+  pull_request:
+    branches:
+      - main
+      - develop
+  workflow_dispatch:
+name: ci
+jobs:
+  ci:
+    uses: nr1etech/github-workflows/.github/workflows/javascript-library-build.yml@main
+    with:
+      node-versions: "[18,20,22]"

package/.github/workflows/issues.yml

@@ -0,0 +1,13 @@
+on:
+  pull_request:
+  issues:
+    types:
+      - opened
+jobs:
+  add-to-project:
+    name: Add issue to project
+    if: github.actor != 'dependabot[bot]'
+    uses: nr1etech/github-workflows/.github/workflows/issues.yml@main
+    secrets:
+      private-key: ${{ secrets.ISSUES_BOT_KEY }}
+      app-id: ${{ secrets.ISSUES_BOT_ID }}

package/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+on:
+  push:
+    branches:
+      - main
+      - develop
+name: publish
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+jobs:
+  publish:
+    uses: nr1etech/github-workflows/.github/workflows/javascript-library.yml@main
+    with:
+      node-versions: "[18,20,22]"
+      publish-node-version: "22"
+    secrets:
+      npm-auth-token: ${{ secrets.NPM_AUTH_TOKEN }}
+      app-id: ${{ secrets.RELEASE_BOT_ID }}
+      private-key: ${{ secrets.RELEASE_BOT_KEY }}

package/.gitignore

@@ -0,0 +1,13 @@
+notes.txt
+*.zip
+*.js
+!jest.config.js
+*.d.ts
+*.d.ts.map
+*.js.map
+node_modules
+dist
+ncryptyr.json
+!.prettierrc.js
+site
+coverage

package/.idea/.gitignore

@@ -0,0 +1,10 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml
+# GitHub Copilot persisted chat sessions
+/copilot/chatSessions

package/.idea/aws.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="accountSettings">
+    <option name="activeRegion" value="us-east-1" />
+    <option name="recentlyUsedRegions">
+      <list>
+        <option value="us-east-1" />
+      </list>
+    </option>
+  </component>
+</project>