akundigital 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AkunDigital
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# akundigital
+
+A command-line interface for AkunDigital.
+
+## Usage
+
+Run the latest published version without installing it:
+
+```sh
+npx akundigital help
+npx akundigital version
+```
+
+The initial release provides these commands:
+
+- `help` — show available commands
+- `version` — show the installed version
+
+Unknown commands return a non-zero exit code and display the usage guide. Future commands can be registered in `src/commands.ts`.
+
+## Development
+
+```sh
+npm install
+npm run typecheck
+npm test
+npm run build
+node dist/index.js help
+```
+
+## Publishing
+
+Publishing runs from GitHub Actions when a semantic version tag is pushed. Add a repository secret named `NPM_TOKEN` containing an npm granular access token with package publish access and 2FA bypass enabled, then release with:
+
+```sh
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+Do not put the token in the repository or local `.npmrc`.
+
+## License
+
+MIT

package/dist/commands.d.ts

@@ -0,0 +1,10 @@
+export type CommandContext = {
+    args: string[];
+    output: (message: string) => void;
+};
+export type Command = {
+    description: string;
+    run: (context: CommandContext) => number;
+};
+export declare const createCommands: (version: string) => Record<string, Command>;
+export declare const runCommand: (commandName: string | undefined, args: string[], version: string, output: (message: string) => void, error: (message: string) => void) => number;

package/dist/commands.js

@@ -0,0 +1,41 @@
+export const createCommands = (version) => ({
+    help: {
+        description: "Show available commands",
+        run: ({ output }) => {
+            output([
+                "Usage: akundigital <command> [arguments]",
+                "",
+                "Commands:",
+                "  help       Show available commands",
+                "  version    Show the installed version",
+                "",
+                "Run `akundigital <command> --help` for command-specific help.",
+            ].join("\n"));
+            return 0;
+        },
+    },
+    version: {
+        description: "Show the installed version",
+        run: ({ output }) => {
+            output(version);
+            return 0;
+        },
+    },
+});
+export const runCommand = (commandName, args, version, output, error) => {
+    const commands = createCommands(version);
+    if (!commandName || commandName === "--help" || commandName === "-h") {
+        return commands.help.run({ args, output });
+    }
+    if (commandName === "--version" || commandName === "-v") {
+        return commands.version.run({ args, output });
+    }
+    const command = commands[commandName];
+    if (!command) {
+        error(`Unknown command: ${commandName}`);
+        commands.help.run({ args: [], output });
+        return 1;
+    }
+    return command.run({ args, output });
+};
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAA2B,EAAE,CAAC,CAAC;IAC3E,IAAI,EAAE;QACJ,WAAW,EAAE,yBAAyB;QACtC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;YAClB,MAAM,CAAC;gBACL,0CAA0C;gBAC1C,EAAE;gBACF,WAAW;gBACX,sCAAsC;gBACtC,yCAAyC;gBACzC,EAAE;gBACF,+DAA+D;aAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACd,OAAO,CAAC,CAAC;QACX,CAAC;KACF;IACD,OAAO,EAAE;QACP,WAAW,EAAE,4BAA4B;QACzC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;YAClB,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,OAAO,CAAC,CAAC;QACX,CAAC;KACF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,WAA+B,EAC/B,IAAc,EACd,OAAe,EACf,MAAiC,EACjC,KAAgC,EACxB,EAAE;IACV,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAEzC,IAAI,CAAC,WAAW,IAAI,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACrE,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,WAAW,KAAK,WAAW,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,KAAK,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import { runCommand } from "./commands.js";
+const require = createRequire(import.meta.url);
+const packageJson = require("../package.json");
+const exitCode = runCommand(process.argv[2], process.argv.slice(3), packageJson.version, (message) => console.log(message), (message) => console.error(message));
+if (exitCode !== 0) {
+    process.exitCode = exitCode;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,QAAQ,GAAG,UAAU,CACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EACrB,WAAW,CAAC,OAAO,EACnB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EACjC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CACpC,CAAC;AAEF,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;IACnB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "akundigital",
+  "version": "0.1.0",
+  "description": "A command-line interface for AkunDigital.",
+  "type": "module",
+  "bin": {
+    "akundigital": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test",
+    "prepublishOnly": "npm run typecheck && npm test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/akundigital/cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/akundigital/cli/issues"
+  },
+  "homepage": "https://github.com/akundigital/cli#readme",
+  "license": "MIT",
+  "keywords": [
+    "akundigital",
+    "cli"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  }
+}