@pina-rs/codama-renderer-cpi 0.0.0 → 0.13.0

package/README.md

@@ -1,3 +1,38 @@
 # @pina-rs/codama-renderer-cpi
 
-This is a placeholder release published by monochange to bootstrap trusted publishing.
+Codama visitor that renders a standalone, `no_std` Pina CPI crate from the pipeline's current `RootNode`.
+
+```sh
+pnpm add @pina-rs/codama-renderer-cpi codama
+```
+
+Use it in `codama.json`. Codama accepts both Codama and Anchor IDLs and performs Anchor normalization before visitors run.
+
+```json
+{
+	"idl": "./target/idl/counter.json",
+	"scripts": {
+		"cpi": {
+			"from": "@pina-rs/codama-renderer-cpi",
+			"args": ["./clients/counter-cpi"]
+		}
+	}
+}
+```
+
+```sh
+codama run cpi
+```
+
+The visitor uses the native Pina CLI bundled by `@pina-rs/cli` and sends the current pipeline root over standard input. The generated crate exposes typed account sets and instruction builders with `.invoke()` and `.invoke_signed()` methods backed by Pina's validated, allocator-free CPI context.
+
+Pass visitor options from a programmatic Codama pipeline when you need explicit destination handling:
+
+```ts
+await codama.accept(renderVisitor("./clients/counter-cpi", {
+	mode: "update",
+	scaffold: false,
+}));
+```
+
+`mode` accepts `auto` (the default), `create`, `update`, or `overwrite`. Updates replace only `src/generated` and preserve an existing `Cargo.toml` and `src/lib.rs`. `scaffold: false` generates only source files; `overwrite` removes the complete destination before rendering.

package/dist/index.js

@@ -0,0 +1,68 @@
+// src/index.ts
+import { spawnSync } from "child_process";
+import { createRequire } from "module";
+import { rootNodeVisitor } from "codama";
+var MAX_OUTPUT_BYTES = 16 * 1024;
+function renderVisitor(outputDir, options = {}) {
+  return rootNodeVisitor((root) => {
+    renderRoot(root, outputDir, options);
+  });
+}
+function renderRoot(root, outputDir, options = {}) {
+  const [command, ...prefixArgs] = options.pinaCommand ?? defaultPinaCommand();
+  const args = [
+    ...prefixArgs,
+    "cpi",
+    "--stdin",
+    "--output",
+    outputDir,
+    "--mode",
+    options.mode ?? "auto"
+  ];
+  if (options.scaffold === false) {
+    args.push("--no-scaffold");
+  }
+  const result = spawnSync(
+    command,
+    args,
+    {
+      encoding: "utf8",
+      input: JSON.stringify(root),
+      maxBuffer: MAX_OUTPUT_BYTES,
+      windowsHide: true
+    }
+  );
+  if (result.error) {
+    throw new Error(
+      `Failed to run the Pina CPI renderer: ${result.error.message}`,
+      {
+        cause: result.error
+      }
+    );
+  }
+  if (result.status !== 0) {
+    const detail = diagnosticText(result.stderr) || diagnosticText(result.stdout);
+    const suffix = detail ? `: ${detail}` : "";
+    throw new Error(
+      `Pina CPI renderer exited with status ${result.status ?? "unknown"}${suffix}`
+    );
+  }
+}
+function defaultPinaCommand() {
+  const require2 = createRequire(import.meta.url);
+  const launcher = require2.resolve("@pina-rs/cli/bin/pina.cjs");
+  return [process.execPath, launcher];
+}
+function diagnosticText(value) {
+  return (value ?? "").slice(-MAX_OUTPUT_BYTES).trim().replaceAll(
+    /[\u0000-\u001f\u007f]/g,
+    (character) => JSON.stringify(character).slice(1, -1)
+  );
+}
+var index_default = renderVisitor;
+export {
+  index_default as default,
+  renderRoot,
+  renderVisitor
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\n\nimport type { RootNode, Visitor } from \"codama\";\nimport { rootNodeVisitor } from \"codama\";\n\nconst MAX_OUTPUT_BYTES = 16 * 1024;\n\nexport interface RenderOptions {\n\t/** Override the Pina command and any arguments placed before `cpi`. */\n\tpinaCommand?: readonly [string, ...string[]];\n\t/** Control whether the destination is created, updated, or replaced. */\n\tmode?: \"auto\" | \"create\" | \"update\" | \"overwrite\";\n\t/** Create Cargo.toml and src/lib.rs when they are missing. */\n\tscaffold?: boolean;\n}\n\n/** Creates a Codama visitor that renders a standalone, `no_std` Pina CPI crate. */\nexport function renderVisitor(\n\toutputDir: string,\n\toptions: RenderOptions = {},\n): Visitor<void, \"rootNode\"> {\n\treturn rootNodeVisitor((root: RootNode) => {\n\t\trenderRoot(root, outputDir, options);\n\t});\n}\n\n/** Renders one normalized Codama root through the native Pina renderer. */\nexport function renderRoot(\n\troot: RootNode,\n\toutputDir: string,\n\toptions: RenderOptions = {},\n): void {\n\tconst [command, ...prefixArgs] = options.pinaCommand ?? defaultPinaCommand();\n\tconst args = [\n\t\t...prefixArgs,\n\t\t\"cpi\",\n\t\t\"--stdin\",\n\t\t\"--output\",\n\t\toutputDir,\n\t\t\"--mode\",\n\t\toptions.mode ?? \"auto\",\n\t];\n\tif (options.scaffold === false) {\n\t\targs.push(\"--no-scaffold\");\n\t}\n\tconst result = spawnSync(\n\t\tcommand,\n\t\targs,\n\t\t{\n\t\t\tencoding: \"utf8\",\n\t\t\tinput: JSON.stringify(root),\n\t\t\tmaxBuffer: MAX_OUTPUT_BYTES,\n\t\t\twindowsHide: true,\n\t\t},\n\t);\n\n\tif (result.error) {\n\t\tthrow new Error(\n\t\t\t`Failed to run the Pina CPI renderer: ${result.error.message}`,\n\t\t\t{\n\t\t\t\tcause: result.error,\n\t\t\t},\n\t\t);\n\t}\n\n\tif (result.status !== 0) {\n\t\tconst detail = diagnosticText(result.stderr) ||\n\t\t\tdiagnosticText(result.stdout);\n\t\tconst suffix = detail ? `: ${detail}` : \"\";\n\t\tthrow new Error(\n\t\t\t`Pina CPI renderer exited with status ${\n\t\t\t\tresult.status ?? \"unknown\"\n\t\t\t}${suffix}`,\n\t\t);\n\t}\n}\n\nfunction defaultPinaCommand(): readonly [string, ...string[]] {\n\tconst require = createRequire(import.meta.url);\n\tconst launcher = require.resolve(\"@pina-rs/cli/bin/pina.cjs\");\n\n\treturn [process.execPath, launcher];\n}\n\nfunction diagnosticText(value: string | null): string {\n\treturn (value ?? \"\")\n\t\t.slice(-MAX_OUTPUT_BYTES)\n\t\t.trim()\n\t\t.replaceAll(\n\t\t\t/[\\u0000-\\u001f\\u007f]/g,\n\t\t\t(character) => JSON.stringify(character).slice(1, -1),\n\t\t);\n}\n\nexport default renderVisitor;\n"],"mappings":";AAAA,SAAS,iBAAiB;AAC1B,SAAS,qBAAqB;AAG9B,SAAS,uBAAuB;AAEhC,IAAM,mBAAmB,KAAK;AAYvB,SAAS,cACf,WACA,UAAyB,CAAC,GACE;AAC5B,SAAO,gBAAgB,CAAC,SAAmB;AAC1C,eAAW,MAAM,WAAW,OAAO;AAAA,EACpC,CAAC;AACF;AAGO,SAAS,WACf,MACA,WACA,UAAyB,CAAC,GACnB;AACP,QAAM,CAAC,SAAS,GAAG,UAAU,IAAI,QAAQ,eAAe,mBAAmB;AAC3E,QAAM,OAAO;AAAA,IACZ,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,QAAQ;AAAA,EACjB;AACA,MAAI,QAAQ,aAAa,OAAO;AAC/B,SAAK,KAAK,eAAe;AAAA,EAC1B;AACA,QAAM,SAAS;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,MACC,UAAU;AAAA,MACV,OAAO,KAAK,UAAU,IAAI;AAAA,MAC1B,WAAW;AAAA,MACX,aAAa;AAAA,IACd;AAAA,EACD;AAEA,MAAI,OAAO,OAAO;AACjB,UAAM,IAAI;AAAA,MACT,wCAAwC,OAAO,MAAM,OAAO;AAAA,MAC5D;AAAA,QACC,OAAO,OAAO;AAAA,MACf;AAAA,IACD;AAAA,EACD;AAEA,MAAI,OAAO,WAAW,GAAG;AACxB,UAAM,SAAS,eAAe,OAAO,MAAM,KAC1C,eAAe,OAAO,MAAM;AAC7B,UAAM,SAAS,SAAS,KAAK,MAAM,KAAK;AACxC,UAAM,IAAI;AAAA,MACT,wCACC,OAAO,UAAU,SAClB,GAAG,MAAM;AAAA,IACV;AAAA,EACD;AACD;AAEA,SAAS,qBAAqD;AAC7D,QAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,QAAM,WAAWA,SAAQ,QAAQ,2BAA2B;AAE5D,SAAO,CAAC,QAAQ,UAAU,QAAQ;AACnC;AAEA,SAAS,eAAe,OAA8B;AACrD,UAAQ,SAAS,IACf,MAAM,CAAC,gBAAgB,EACvB,KAAK,EACL;AAAA,IACA;AAAA,IACA,CAAC,cAAc,KAAK,UAAU,SAAS,EAAE,MAAM,GAAG,EAAE;AAAA,EACrD;AACF;AAEA,IAAO,gBAAQ;","names":["require"]}

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+import type { RootNode, Visitor } from "codama";
+export interface RenderOptions {
+    /** Override the Pina command and any arguments placed before `cpi`. */
+    pinaCommand?: readonly [string, ...string[]];
+    /** Control whether the destination is created, updated, or replaced. */
+    mode?: "auto" | "create" | "update" | "overwrite";
+    /** Create Cargo.toml and src/lib.rs when they are missing. */
+    scaffold?: boolean;
+}
+/** Creates a Codama visitor that renders a standalone, `no_std` Pina CPI crate. */
+export declare function renderVisitor(outputDir: string, options?: RenderOptions): Visitor<void, "rootNode">;
+/** Renders one normalized Codama root through the native Pina renderer. */
+export declare function renderRoot(root: RootNode, outputDir: string, options?: RenderOptions): void;
+export default renderVisitor;

package/package.json

@@ -1 +1,51 @@
-{"description":"Placeholder package for @pina-rs/codama-renderer-cpi","name":"@pina-rs/codama-renderer-cpi","repository":"https://github.com/pina-rs/pina","version":"0.0.0"}
+{
+	"name": "@pina-rs/codama-renderer-cpi",
+	"version": "0.13.0",
+	"description": "Codama visitor that renders standalone Pina CPI crates",
+	"license": "Apache-2.0",
+	"homepage": "https://pina.rs",
+	"bugs": {
+		"url": "https://github.com/pina-rs/pina/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/pina-rs/pina.git",
+		"directory": "packages/codama-renderer-cpi"
+	},
+	"type": "module",
+	"sideEffects": false,
+	"main": "./dist/index.js",
+	"types": "./dist/types/index.d.ts",
+	"exports": {
+		"types": "./dist/types/index.d.ts",
+		"import": "./dist/index.js"
+	},
+	"files": [
+		"./dist",
+		"./README.md"
+	],
+	"publishConfig": {
+		"access": "public",
+		"provenance": true
+	},
+	"scripts": {
+		"build": "rimraf dist && tsup && tsc -p ./tsconfig.declarations.json",
+		"test": "pnpm test:types && pnpm test:unit",
+		"test:types": "tsc --noEmit",
+		"test:unit": "vitest run"
+	},
+	"dependencies": {
+		"@pina-rs/cli": "^0.13.0",
+		"codama": "^1.10.2"
+	},
+	"devDependencies": {
+		"@types/node": "^26.4.0",
+		"rimraf": "^6.1.3",
+		"tsup": "^8.5.1",
+		"typescript": "^7.0.2",
+		"vitest": "^4.1.11"
+	},
+	"engines": {
+		"node": ">=18"
+	}
+}

package/CHANGELOG.md

@@ -1,3 +0,0 @@
-## 0.0.0
-
-- Placeholder release.

package/LICENSE

@@ -1 +0,0 @@
-Placeholder package published by monochange. See the source repository for license terms.