@macalinao/create-coda 0.1.0

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { cp, mkdir, readdir } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+async function main() {
+    const projectName = process.argv[2] ?? "my-coda-client";
+    const targetDir = resolve(process.cwd(), projectName);
+    // Check if directory already exists
+    if (existsSync(targetDir)) {
+        const files = await readdir(targetDir);
+        if (files.length > 0) {
+            console.error(`Error: Directory ${projectName} already exists and is not empty.`);
+            process.exit(1);
+        }
+    }
+    // Create target directory
+    await mkdir(targetDir, { recursive: true });
+    // Copy template files (template is at the package root, not in dist)
+    const templateDir = join(__dirname, "..", "template");
+    await cp(templateDir, targetDir, { recursive: true });
+    console.log(`✨ Created Coda client project at ${projectName}`);
+    console.log("");
+    console.log("Next steps:");
+    console.log(`  cd ${projectName}`);
+    console.log("  bun install");
+    console.log("  # Add your IDL file to idls/ directory");
+    console.log("  bun run codegen");
+    console.log("  bun run build");
+    console.log("");
+    console.log("Happy coding! 🚀");
+}
+main().catch((error) => {
+    console.error("Error creating project:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC;IACxD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IAEtD,oCAAoC;IACpC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CACX,oBAAoB,WAAW,mCAAmC,CACnE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,qEAAqE;IACrE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACtD,MAAM,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,OAAO,CAAC,GAAG,CAAC,oCAAoC,WAAW,EAAE,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,WAAW,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n\nimport { existsSync } from \"node:fs\";\nimport { cp, mkdir, readdir } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nasync function main(): Promise<void> {\n  const projectName = process.argv[2] ?? \"my-coda-client\";\n  const targetDir = resolve(process.cwd(), projectName);\n\n  // Check if directory already exists\n  if (existsSync(targetDir)) {\n    const files = await readdir(targetDir);\n    if (files.length > 0) {\n      console.error(\n        `Error: Directory ${projectName} already exists and is not empty.`,\n      );\n      process.exit(1);\n    }\n  }\n\n  // Create target directory\n  await mkdir(targetDir, { recursive: true });\n\n  // Copy template files (template is at the package root, not in dist)\n  const templateDir = join(__dirname, \"..\", \"template\");\n  await cp(templateDir, targetDir, { recursive: true });\n\n  console.log(`✨ Created Coda client project at ${projectName}`);\n  console.log(\"\");\n  console.log(\"Next steps:\");\n  console.log(`  cd ${projectName}`);\n  console.log(\"  bun install\");\n  console.log(\"  # Add your IDL file to idls/ directory\");\n  console.log(\"  bun run codegen\");\n  console.log(\"  bun run build\");\n  console.log(\"\");\n  console.log(\"Happy coding! 🚀\");\n}\n\nmain().catch((error: unknown) => {\n  console.error(\"Error creating project:\", error);\n  process.exit(1);\n});\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@macalinao/create-coda",
+  "version": "0.1.0",
+  "description": "Create a new Coda client project",
+  "type": "module",
+  "bin": {
+    "create-coda": "./dist/bin.js"
+  },
+  "main": "./dist/bin.js",
+  "files": [
+    "dist/",
+    "template/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist/ template/node_modules template/dist template/src/generated",
+    "lint": "eslint . --cache"
+  },
+  "keywords": [
+    "coda",
+    "solana",
+    "codama",
+    "client",
+    "generator",
+    "create",
+    "template"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/macalinao/coda",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/macalinao/coda.git"
+  },
+  "bugs": {
+    "url": "https://github.com/macalinao/coda/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@macalinao/eslint-config": "^5",
+    "@macalinao/tsconfig": "^3.2.3",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.33.0",
+    "typescript": "^5.9.2"
+  }
+}

package/template/README.md

@@ -0,0 +1,63 @@
+# My Coda Client
+
+TypeScript client for Solana program generated with [Coda](https://github.com/macalinao/coda).
+
+## Getting Started
+
+1. **Add your IDL file(s)**
+   - Place your Anchor IDL JSON file(s) in the `idls/` directory
+   - Remove the example.json file
+
+2. **Generate the client code**
+   ```bash
+   bun run codegen
+   ```
+
+3. **Build the project**
+   ```bash
+   bun run build
+   ```
+
+## Project Structure
+
+```
+.
+├── idls/               # Anchor IDL files
+├── src/
+│   ├── generated/      # Generated client code (do not edit)
+│   └── index.ts        # Main entry point
+├── coda.config.mjs     # Coda configuration
+└── package.json
+```
+
+## Available Scripts
+
+- `bun run codegen` - Generate TypeScript client from IDL
+- `bun run build` - Build the TypeScript project
+- `bun run clean` - Clean build artifacts
+- `bun run lint` - Run ESLint
+- `bun test` - Run tests
+
+## Configuration
+
+Edit `coda.config.mjs` to customize:
+- IDL discovery patterns
+- Output directory
+- Custom PDAs and visitors
+
+## Usage
+
+```typescript
+import { createInitializeInstruction } from "./dist/index.js";
+
+// Use the generated client
+const instruction = createInitializeInstruction({
+  // ... instruction parameters
+});
+```
+
+## Learn More
+
+- [Coda Documentation](https://github.com/macalinao/coda)
+- [Codama Documentation](https://github.com/codama-idl/codama)
+- [Anchor Framework](https://www.anchor-lang.com/)

package/template/coda.config.mjs

@@ -0,0 +1,21 @@
+import { defineConfig } from "@macalinao/coda";
+
+export default defineConfig({
+  // Coda will automatically discover IDLs from ./idls/*.json
+  // You can override this by specifying a custom path:
+  // idlPath: "./idls/my_program.json",
+
+  // For multiple IDLs, use a glob pattern or array:
+  // idlPath: "./idls/*.json",
+  // idlPath: ["./idls/program1.json", "./idls/program2.json"],
+
+  // Output directory for generated code (default: "./src/generated")
+  outputDir: "./src/generated",
+
+  // Optional: Add custom Codama visitors for advanced customization
+  // visitors: [
+  //   addPdasVisitor({
+  //     // Define custom PDAs here
+  //   })
+  // ]
+});

package/template/eslint.config.js

@@ -0,0 +1,31 @@
+import { configs } from "@macalinao/eslint-config";
+
+export default [
+  ...configs.fast,
+  {
+    languageOptions: {
+      parserOptions: {
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+  {
+    files: ["src/generated/**/*.ts"],
+    rules: {
+      "@typescript-eslint/no-non-null-assertion": "off",
+      "@typescript-eslint/prefer-nullish-coalescing": "off",
+    },
+  },
+  {
+    files: [
+      "src/generated/instructions/*.ts",
+      "src/generated/types/*.ts",
+      "src/generated/errors/*.ts",
+    ],
+    rules: {
+      "@typescript-eslint/no-unnecessary-condition": "off",
+      "no-constant-condition": "off",
+      "@typescript-eslint/no-empty-object-type": "off",
+    },
+  },
+];

package/template/idls/example.json

@@ -0,0 +1,79 @@
+{
+  "version": "0.1.0",
+  "name": "example",
+  "instructions": [
+    {
+      "name": "Initialize",
+      "accounts": [
+        {
+          "name": "payer",
+          "isMut": true,
+          "isSigner": true
+        },
+        {
+          "name": "state",
+          "isMut": true,
+          "isSigner": false
+        },
+        {
+          "name": "systemProgram",
+          "isMut": false,
+          "isSigner": false
+        }
+      ],
+      "args": [
+        {
+          "name": "data",
+          "type": "u64"
+        }
+      ]
+    },
+    {
+      "name": "Update",
+      "accounts": [
+        {
+          "name": "authority",
+          "isMut": false,
+          "isSigner": true
+        },
+        {
+          "name": "state",
+          "isMut": true,
+          "isSigner": false
+        }
+      ],
+      "args": [
+        {
+          "name": "newData",
+          "type": "u64"
+        }
+      ]
+    }
+  ],
+  "accounts": [
+    {
+      "name": "State",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "authority",
+            "type": "publicKey"
+          },
+          {
+            "name": "data",
+            "type": "u64"
+          }
+        ]
+      }
+    }
+  ],
+  "types": [],
+  "errors": [
+    {
+      "code": 6000,
+      "name": "Unauthorized",
+      "msg": "Unauthorized access"
+    }
+  ]
+}

package/template/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "my-coda-client",
+  "version": "0.1.0",
+  "description": "TypeScript client for Solana program",
+  "type": "module",
+  "sideEffects": false,
+  "license": "Apache-2.0",
+  "keywords": [
+    "coda",
+    "solana",
+    "client",
+    "typescript"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -fr dist/ tsconfig.tsbuildinfo",
+    "codegen": "rm -fr src/generated/ && coda generate",
+    "lint": "eslint . --cache"
+  },
+  "peerDependencies": {
+    "@solana/kit": "*"
+  },
+  "devDependencies": {
+    "@macalinao/coda": "^0.2.3",
+    "@macalinao/eslint-config": "^5",
+    "@macalinao/tsconfig": "^3.2.3",
+    "@solana/kit": "*",
+    "@types/bun": "latest",
+    "eslint": "^9.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/template/src/index.ts

@@ -0,0 +1,2 @@
+// Re-export all generated code
+export * from "./generated/index.js";

package/template/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "@macalinao/tsconfig/tsconfig.base.json"
+}