@junobuild/functions-tools 0.4.0-next-2026-03-12

package/dist/types/api/idl/index.d.ts

@@ -0,0 +1,7 @@
+import type { TransformerOptions } from './types/transformer-options';
+export type * from './types/transformer-options';
+export declare const generateApi: ({ inputFile, outputFile, transformerOptions }: {
+    inputFile: string;
+    outputFile: string;
+    transformerOptions: TransformerOptions;
+}) => Promise<void>;

package/dist/types/api/idl/services/inspector.services.d.ts

@@ -0,0 +1,7 @@
+import type { MethodSignature } from '../types/method-signature';
+export declare const collectApi: ({ inputFile }: {
+    inputFile: string;
+}) => Promise<{
+    methods: MethodSignature[];
+    imports: string[];
+}>;

package/dist/types/api/idl/services/parser.services.d.ts

@@ -0,0 +1,7 @@
+import type { MethodSignature } from '../types/method-signature';
+import type { TransformerOptions } from '../types/transformer-options';
+export declare const parseApi: ({ methods: signatures, imports, transformerOptions: { coreLib, outputLanguage } }: {
+    methods: MethodSignature[];
+    imports: string[];
+    transformerOptions: TransformerOptions;
+}) => string;

package/dist/types/api/idl/types/method-signature.d.ts

@@ -0,0 +1,5 @@
+export interface MethodSignature {
+    name: string;
+    paramsType: string[];
+    returnType: string;
+}

package/dist/types/api/idl/types/transformer-options.d.ts

@@ -0,0 +1,4 @@
+export interface TransformerOptions {
+    outputLanguage: 'js' | 'ts';
+    coreLib?: 'core' | 'core-standalone';
+}

package/dist/types/converters/_converters.d.ts

@@ -0,0 +1,11 @@
+import * as z from 'zod';
+import type { SputnikSchema } from './_types';
+export interface SputnikSchemaResult {
+    id: string;
+    schema: SputnikSchema;
+    isTopLevelOptional: boolean;
+}
+export declare const jsonToSputnikSchema: ({ id, zodSchema }: {
+    id: string;
+    zodSchema: z.ZodType;
+}) => SputnikSchemaResult;

package/dist/types/converters/_types.d.ts

@@ -0,0 +1,42 @@
+import type { core } from 'zod';
+export type JSONSchemaOutput = core.ZodStandardJSONSchemaPayload<any>;
+export type JSONSchema = core.JSONSchema.BaseSchema;
+export type SputnikSchema = {
+    kind: 'text';
+} | {
+    kind: 'bool';
+} | {
+    kind: 'float64';
+} | {
+    kind: 'int32';
+} | {
+    kind: 'nat';
+} | {
+    kind: 'opt';
+    inner: SputnikSchema;
+} | {
+    kind: 'vec';
+    inner: SputnikSchema;
+} | {
+    kind: 'record';
+    fields: {
+        name: string;
+        type: SputnikSchema;
+    }[];
+} | {
+    kind: 'tuple';
+    members: SputnikSchema[];
+} | {
+    kind: 'indexedTuple';
+    members: SputnikSchema[];
+} | {
+    kind: 'variant';
+    tags: string[];
+} | {
+    kind: 'variantRecords';
+    members: SputnikSchema[];
+} | {
+    kind: 'principal';
+} | {
+    kind: 'uint8array';
+};

package/dist/types/converters/index.d.ts

@@ -0,0 +1,3 @@
+export * from './zod-to-candid';
+export * from './zod-to-idl';
+export * from './zod-to-rust';

package/dist/types/converters/zod-to-candid.d.ts

@@ -0,0 +1,9 @@
+import type { z } from 'zod';
+/**
+ * Converts a record of Zod schemas to a Candid type definition string.
+ *
+ * @param {Record<string, z.ZodType>} inputs - A record mapping type names to Zod schemas.
+ * @returns {string} A Candid type definition string, one `type` declaration per entry.
+ *
+ */
+export declare const zodToCandid: (inputs: Record<string, z.ZodType>) => string;

package/dist/types/converters/zod-to-idl.d.ts

@@ -0,0 +1,20 @@
+import { IDL } from '@icp-sdk/core/candid';
+import type { z } from 'zod';
+export interface IdlResult {
+    baseName: string;
+    idl: IDL.Type;
+}
+/**
+ * Converts a Zod schema to a Candid IDL type for use with `IDL.encode` and `IDL.decode`.
+ *
+ * @param {string} id - The base name used to generate the IDL type name.
+ * @param {z.ZodType} schema - The Zod schema to convert.
+ * @param {'Args' | 'Result'} suffix - Whether this represents function arguments or a return type.
+ * @returns {IdlResult} An object containing the generated IDL type and the base type name.
+ *
+ */
+export declare const zodToIdl: ({ id, schema, suffix }: {
+    id: string;
+    schema: z.ZodType;
+    suffix: "Args" | "Result";
+}) => IdlResult;

package/dist/types/converters/zod-to-rust.d.ts

@@ -0,0 +1,19 @@
+import type { z } from 'zod';
+export interface RustResult {
+    baseName: string;
+    code: string;
+}
+/**
+ * Converts a Zod schema to a Rust type definition string.
+ *
+ * @param {string} id - The base name used to generate the Rust struct or type alias name.
+ * @param {z.ZodType} schema - The Zod schema to convert.
+ * @param {'Args' | 'Result'} suffix - Whether this represents function arguments or a return type.
+ * @returns {RustResult} An object containing the generated Rust code and the base type name.
+ *
+ */
+export declare const zodToRust: ({ id, schema, suffix }: {
+    id: string;
+    schema: z.ZodType;
+    suffix: "Args" | "Result";
+}) => RustResult;

package/dist/types/converters/zod-to-zod.d.ts

@@ -0,0 +1,18 @@
+import type { z } from 'zod';
+export interface ZodResult {
+    baseName: string;
+    code: string;
+}
+/**
+ * Converts a Zod schema to a Zod schema source code string.
+ *
+ * @param {string} id - The base name used to generate the schema constant name.
+ * @param {z.ZodType} schema - The Zod schema to convert.
+ * @param {'Args' | 'Result'} suffix - Whether this represents function arguments or a return type.
+ * @returns {ZodResult} An object containing the generated code and the base type name.
+ */
+export declare const zodToZod: ({ id, schema, suffix }: {
+    id: string;
+    schema: z.ZodType;
+    suffix: "Args" | "Result";
+}) => ZodResult;

package/dist/types/functions/_constants.d.ts

@@ -0,0 +1 @@
+export declare const FUNCTION_NAMESPACE = "App";

package/dist/types/functions/index.d.ts

@@ -0,0 +1,11 @@
+export interface GenerateFunctionsArgs {
+    outputFile: string;
+    code: Uint8Array;
+}
+export interface GenerateFunctionsData {
+    totalQueries: number;
+    totalUpdates: number;
+    outputPath: string;
+}
+export type GenerateFunctionsResult = GenerateFunctionsData | null;
+export declare const generateFunctions: ({ code, outputFile }: GenerateFunctionsArgs) => Promise<GenerateFunctionsResult>;

package/dist/types/functions/services/parser.services.d.ts

@@ -0,0 +1,5 @@
+import type { Query, Update } from '@junobuild/functions';
+export declare const parseFunctions: ({ queries, updates }: {
+    queries: [string, Query][];
+    updates: [string, Update][];
+}) => string;

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './api/idl';
+export * from './converters';
+export * from './functions';

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@junobuild/functions-tools",
+  "version": "0.4.0-next-2026-03-12",
+  "description": "Tools for generating Juno serverless functions code.",
+  "author": "David Dal Busco (https://daviddalbusco.com)",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/node/index.mjs",
+  "module": "./dist/node/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/node/index.mjs"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/node/index.mjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "rmdir": "node ../../scripts/rmdir.mjs",
+    "ts-declaration": "tsc --emitDeclarationOnly --outDir dist/types",
+    "build": "npm run rmdir && mkdir -p dist && node esbuild.mjs && npm run ts-declaration",
+    "prepack": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/junobuild/juno-js.git",
+    "directory": "packages/functions-tools"
+  },
+  "bugs": {
+    "url": "https://github.com/junobuild/juno-js"
+  },
+  "keywords": [
+    "candid",
+    "parser",
+    "cli"
+  ],
+  "homepage": "https://juno.build",
+  "peerDependencies": {
+    "@babel/core": "*",
+    "@babel/parser": "*",
+    "@babel/plugin-transform-modules-commonjs": "*",
+    "@babel/preset-typescript": "*",
+    "@babel/traverse": "*",
+    "@babel/types": "*",
+    "@dfinity/utils": "*",
+    "@junobuild/functions": "*",
+    "@junobuild/utils": "*",
+    "@junobuild/zod": "*",
+    "zod": "*"
+  }
+}