@dedot/codegen 0.0.1-next.0 → 0.0.1-next.04c158c0.11

package/generator/QueryGen.js

@@ -1,55 +0,0 @@
-import { stringLowerFirst } from '@polkadot/util';
-import { normalizeName } from '@dedot/utils';
-import { ApiGen } from '../generator';
-import { beautifySourceCode, commentBlock, compileTemplate } from './utils';
-export class QueryGen extends ApiGen {
-    generate() {
-        const { pallets } = this.metadata;
-        this.typesGen.clearCache();
-        this.typesGen.typeImports.addKnownType('GenericChainStorage', 'GenericStorageQuery', 'Callback');
-        let defTypeOut = '';
-        for (let pallet of pallets) {
-            const storage = pallet.storage;
-            if (!storage)
-                continue;
-            const queries = storage.entries.map((one) => this.#generateEntry(one));
-            const queryDefs = queries.map(({ name, valueType, keyType, docs }) => `${commentBlock(docs)}${name}: GenericStorageQuery<(${keyType}) => ${valueType}>`);
-            defTypeOut += commentBlock(`Pallet \`${pallet.name}\`'s storage queries`);
-            defTypeOut += `${stringLowerFirst(pallet.name)}: {
-        ${queryDefs.join(',\n')}
-        
-        ${commentBlock('Generic pallet storage query')}[storage: string]: GenericStorageQuery;
-      },`;
-        }
-        const importTypes = this.typesGen.typeImports.toImports();
-        const template = compileTemplate('query.hbs');
-        return beautifySourceCode(template({ importTypes, defTypeOut }));
-    }
-    #generateEntry(entry) {
-        const { name, type, docs, modifier } = entry;
-        let valueType, keyType;
-        if (type.tag === 'Plain') {
-            valueType = this.typesGen.generateType(type.value.valueTypeId, 1, true);
-        }
-        else if (type.tag === 'Map') {
-            valueType = this.typesGen.generateType(type.value.valueTypeId, 1, true);
-            keyType = this.typesGen.generateType(type.value.keyTypeId, 1);
-        }
-        else {
-            throw Error('Invalid entry type!');
-        }
-        const isOptional = modifier === 'Optional';
-        valueType = `${valueType}${isOptional ? ' | undefined' : ''}`;
-        docs.push('\n');
-        if (keyType) {
-            docs.push(`@param {${keyType}} arg`);
-        }
-        docs.push(`@param {Callback<${valueType}> =} callback`);
-        return {
-            name: normalizeName(name),
-            valueType,
-            keyType: keyType ? `arg: ${keyType}` : '',
-            docs,
-        };
-    }
-}

package/generator/RpcGen.d.ts

@@ -1,10 +0,0 @@
-import { ApiGen, TypesGen } from '../generator';
-export declare class RpcGen extends ApiGen {
-    #private;
-    readonly typesGen: TypesGen;
-    readonly rpcMethods: string[];
-    constructor(typesGen: TypesGen, rpcMethods: string[]);
-    generate(): Promise<string>;
-    addTypeImport(type: string | string[], toTypeIn?: boolean): void;
-    getGeneratedTypeName(type: string, toTypeIn?: boolean): string;
-}

package/generator/RpcGen.js

@@ -1,171 +0,0 @@
-import { findAliasRpcSpec, findRpcSpec, isUnsubscribeMethod } from '@dedot/specs';
-import { isNativeType } from '@dedot/utils';
-import { ApiGen } from '../generator';
-import { beautifySourceCode, commentBlock, compileTemplate, TUPLE_TYPE_REGEX, WRAPPER_TYPE_REGEX } from './utils';
-const HIDDEN_RPCS = [
-    // Ref: https://github.com/paritytech/polkadot-sdk/blob/43415ef58c143b985e09015cd000dbd65f6d3997/substrate/client/rpc-servers/src/lib.rs#L152C9-L158
-    'rpc_methods',
-];
-export class RpcGen extends ApiGen {
-    typesGen;
-    rpcMethods;
-    constructor(typesGen, rpcMethods) {
-        super(typesGen);
-        this.typesGen = typesGen;
-        this.rpcMethods = rpcMethods;
-        HIDDEN_RPCS.filter((one) => !rpcMethods.includes(one)).forEach((one) => rpcMethods.push(one));
-        rpcMethods.sort();
-    }
-    generate() {
-        this.typesGen.clearCache();
-        this.typesGen.typeImports.addKnownType('GenericRpcCalls', 'Unsub', 'Callback', 'GenericRpcCall');
-        const specsByModule = this.rpcMethods
-            .filter((one) => !findAliasRpcSpec(one)) // we'll ignore  alias rpc for now if defined in the specs! TODO should we generate alias rpc as well?
-            .filter((one) => !isUnsubscribeMethod(one)) // we'll ignore unsubscribe method as well
-            .map((one) => {
-            const spec = findRpcSpec(one);
-            if (spec) {
-                return spec;
-            }
-            const [module, ...methodParts] = one.split('_');
-            const method = methodParts.join('_');
-            return {
-                params: [],
-                type: 'GenericRpcCall',
-                module,
-                method,
-            };
-        })
-            .reduce((o, spec) => {
-            const { module, method } = spec;
-            // ignore if rpc name does not confront with the general convention
-            if (!module || !method) {
-                return o;
-            }
-            return {
-                ...o,
-                [module]: o[module] ? [...o[module], spec] : [spec],
-            };
-        }, {});
-        let rpcCallsOut = '';
-        Object.keys(specsByModule).forEach((module) => {
-            const specs = specsByModule[module];
-            // TODO add alias info to docs block!
-            rpcCallsOut += `${module}: {
-      ${specs.map((spec) => this.#generateMethodDef(spec)).join(',\n')},
-
-      [method: string]: GenericRpcCall,
-    },`;
-        });
-        // TODO include & define external types
-        const importTypes = this.typesGen.typeImports.toImports();
-        const template = compileTemplate('rpc.hbs');
-        return beautifySourceCode(template({ importTypes, rpcCallsOut }));
-    }
-    #generateMethodDef(spec) {
-        const { name, type, module, method, docs = [], params, pubsub, deprecated } = spec;
-        const rpcName = name || `${module}_${method}`;
-        let defaultDocs = [`@rpcname: ${rpcName}`];
-        if (deprecated) {
-            defaultDocs.push(`@deprecated: ${deprecated}`);
-        }
-        if (type === 'GenericRpcCall' && params.length === 0) {
-            return `${commentBlock(defaultDocs)}${method}: GenericRpcCall`;
-        }
-        this.addTypeImport(type, false);
-        params.forEach(({ type, isScale }) => {
-            this.addTypeImport(type, !!isScale);
-        });
-        const typedParams = params.map((param) => ({
-            ...param,
-            plainType: this.getGeneratedTypeName(param.type, !!param.isScale),
-        }));
-        const isSubscription = !!pubsub;
-        const paramsOut = typedParams.map(({ name, type, isOptional, isScale, plainType }) => `${name}${isOptional ? '?' : ''}: ${plainType}`);
-        const paramsDoc = typedParams.map(({ name, plainType }) => `@param {${plainType}} ${name}`);
-        const typeOut = this.getGeneratedTypeName(type, false);
-        if (isSubscription) {
-            defaultDocs.shift();
-            defaultDocs.unshift(`@pubsub: ${pubsub?.join(', ')}`);
-            paramsOut.push(`callback: Callback<${typeOut}>`);
-            return `${commentBlock(docs, '\n', defaultDocs, paramsDoc)}${method}: GenericRpcCall<(${paramsOut.join(', ')}) => Promise<Unsub>>`;
-        }
-        else {
-            return `${commentBlock(docs, '\n', defaultDocs, paramsDoc)}${method}: GenericRpcCall<(${paramsOut.join(', ')}) => Promise<${typeOut}>>`;
-        }
-    }
-    // TODO check typeIn, typeOut if param type, or rpc type isScale
-    addTypeImport(type, toTypeIn = true) {
-        if (Array.isArray(type)) {
-            type.forEach((one) => this.addTypeImport(one, toTypeIn));
-            return;
-        }
-        type = type.trim();
-        if (isNativeType(type)) {
-            return;
-        }
-        // Handle generic wrapper types
-        const matchArray = type.match(WRAPPER_TYPE_REGEX);
-        if (matchArray) {
-            const [_, $1, $2] = matchArray;
-            this.addTypeImport($1, toTypeIn);
-            if ($2.match(WRAPPER_TYPE_REGEX) || $2.match(TUPLE_TYPE_REGEX)) {
-                this.addTypeImport($2, toTypeIn);
-            }
-            else {
-                this.addTypeImport($2.split(','), toTypeIn);
-            }
-            return;
-        }
-        // Check tuple type
-        if (type.match(TUPLE_TYPE_REGEX)) {
-            this.addTypeImport(type.slice(1, -1).split(','), toTypeIn);
-            return;
-        }
-        if (type.includes(' | ')) {
-            this.addTypeImport(type.split(' | ').map((one) => one.trim()), toTypeIn);
-            return;
-        }
-        try {
-            const codecType = this.#getCodecType(type, toTypeIn);
-            if (isNativeType(codecType))
-                return;
-            this.typesGen.typeImports.addCodecType(codecType);
-            return;
-        }
-        catch (e) { }
-        this.typesGen.addTypeImport(type);
-    }
-    getGeneratedTypeName(type, toTypeIn = true) {
-        try {
-            const matchArray = type.match(WRAPPER_TYPE_REGEX);
-            if (matchArray) {
-                const [_, $1, $2] = matchArray;
-                const wrapperTypeName = this.#getCodecType($1, toTypeIn);
-                if ($2.match(WRAPPER_TYPE_REGEX) || $2.match(TUPLE_TYPE_REGEX)) {
-                    return `${wrapperTypeName}<${this.getGeneratedTypeName($2, toTypeIn)}>`;
-                }
-                const innerTypeNames = $2
-                    .split(',')
-                    .map((one) => this.getGeneratedTypeName(one.trim(), toTypeIn))
-                    .join(', ');
-                return `${wrapperTypeName}<${innerTypeNames}>`;
-            }
-            else if (type.match(TUPLE_TYPE_REGEX)) {
-                const innerTypeNames = type
-                    .slice(1, -1)
-                    .split(',')
-                    .map((one) => this.getGeneratedTypeName(one.trim(), toTypeIn))
-                    .join(', ');
-                return `[${innerTypeNames}]`;
-            }
-            return this.#getCodecType(type, toTypeIn);
-        }
-        catch (e) { }
-        return type;
-    }
-    #getCodecType(type, toTypeIn = true) {
-        const { typeIn, typeOut } = this.registry.findCodecType(type);
-        return toTypeIn ? typeIn : typeOut;
-    }
-}

package/generator/RuntimeApisGen.d.ts

@@ -1,9 +0,0 @@
-import { TypesGen } from './TypesGen';
-import { RpcGen } from './RpcGen';
-export declare class RuntimeApisGen extends RpcGen {
-    #private;
-    readonly typesGen: TypesGen;
-    readonly runtimeApis: [string, number][];
-    constructor(typesGen: TypesGen, runtimeApis: [string, number][]);
-    generate(): Promise<string>;
-}

package/generator/RuntimeApisGen.js

@@ -1,111 +0,0 @@
-import { findRuntimeApiSpec } from '@dedot/specs';
-import { beautifySourceCode, commentBlock, compileTemplate } from './utils';
-import { calculateRuntimeApiHash, stringSnakeCase } from '@dedot/utils';
-import { RpcGen } from './RpcGen';
-import { stringCamelCase } from '@polkadot/util';
-export class RuntimeApisGen extends RpcGen {
-    typesGen;
-    runtimeApis;
-    constructor(typesGen, runtimeApis) {
-        super(typesGen, []);
-        this.typesGen = typesGen;
-        this.runtimeApis = runtimeApis;
-    }
-    generate() {
-        this.typesGen.clearCache();
-        this.typesGen.typeImports.addKnownType('GenericRuntimeApis', 'GenericRuntimeApiMethod');
-        let runtimeCallsOut = '';
-        if (this.metadata.apis.length > 0) {
-            this.metadata.apis.forEach((runtimeApi) => {
-                const { name: runtimeApiName, methods } = runtimeApi;
-                runtimeCallsOut += commentBlock(`@runtimeapi: ${runtimeApiName} - ${calculateRuntimeApiHash(runtimeApiName)}`);
-                runtimeCallsOut += `${stringCamelCase(runtimeApiName)}: {
-            ${methods.map((method) => this.#generateMethodDef(runtimeApiName, method)).join('\n')} 
-              
-            ${commentBlock('Generic runtime api call')}[method: string]: GenericRuntimeApiMethod
-        }`;
-            });
-        }
-        else {
-            const specs = this.#targetRuntimeApiSpecs();
-            specs.forEach(({ methods, runtimeApiName, runtimeApiHash, version }) => {
-                runtimeCallsOut += commentBlock(`@runtimeapi: ${runtimeApiName} - ${runtimeApiHash}`, `@version: ${version}`);
-                runtimeCallsOut += `${stringCamelCase(runtimeApiName)}: {
-            ${Object.keys(methods)
-                    .map((methodName) => this.#generateMethodDefFromSpec({
-                    ...methods[methodName],
-                    runtimeApiName,
-                    methodName,
-                }))
-                    .join('\n')} 
-              
-            ${commentBlock('Generic runtime api call')}[method: string]: GenericRuntimeApiMethod
-          }`;
-            });
-        }
-        const importTypes = this.typesGen.typeImports.toImports();
-        const template = compileTemplate('runtime.hbs');
-        return beautifySourceCode(template({ importTypes, runtimeCallsOut }));
-    }
-    #isOptionalType(type) {
-        return type.startsWith('Option<') || type.endsWith('| undefined');
-    }
-    #isOptionalParam(params, type, idx) {
-        return this.#isOptionalType(type) && params.slice(idx + 1).every(({ type }) => this.#isOptionalType(type));
-    }
-    #generateMethodDefFromSpec(spec) {
-        const { docs = [], params, type, runtimeApiName, methodName } = spec;
-        const callName = `${runtimeApiName}_${stringSnakeCase(methodName)}`;
-        const defaultDocs = [`@callname: ${callName}`];
-        this.addTypeImport(type, false);
-        params.forEach(({ type }) => this.addTypeImport(type));
-        const typedParams = params.map((param, idx) => ({
-            ...param,
-            isOptional: this.#isOptionalParam(params, param.type, idx),
-            plainType: this.getGeneratedTypeName(param.type),
-        }));
-        const paramsOut = typedParams
-            .map(({ name, isOptional, plainType }) => `${stringCamelCase(name)}${isOptional ? '?' : ''}: ${plainType}`)
-            .join(', ');
-        const typeOut = this.getGeneratedTypeName(type, false);
-        return `${commentBlock(docs, '\n', defaultDocs, typedParams.map(({ plainType, name }) => `@param {${plainType}} ${name}`))}${methodName}: GenericRuntimeApiMethod<(${paramsOut}) => Promise<${typeOut}>>`;
-    }
-    #generateMethodDef(runtimeApiName, methodDef) {
-        const { name: methodName, inputs, output, docs } = methodDef;
-        const callName = `${runtimeApiName}_${stringSnakeCase(methodName)}`;
-        const defaultDocs = [`@callname: ${callName}`];
-        const typeOut = this.typesGen.generateType(output, 1, true);
-        this.addTypeImport(typeOut, false);
-        const typedInputs = inputs
-            .map((input, idx) => ({
-            ...input,
-            type: this.typesGen.generateType(input.typeId, 1),
-        }))
-            .map((input, idx, inputs) => ({
-            ...input,
-            isOptional: this.#isOptionalParam(inputs, input.type, idx),
-        }));
-        this.addTypeImport(typedInputs.map((t) => t.type));
-        const paramsOut = typedInputs
-            .map(({ name, type, isOptional }) => `${stringCamelCase(name)}${isOptional ? '?' : ''}: ${type}`)
-            .join(', ');
-        return `${commentBlock(docs, '\n', defaultDocs, typedInputs.map(({ type, name }) => `@param {${type}} ${name}`))}${stringCamelCase(methodName)}: GenericRuntimeApiMethod<(${paramsOut}) => Promise<${typeOut}>>`;
-    }
-    #targetRuntimeApiSpecs() {
-        const specs = this.runtimeApis.map(([runtimeApiHash, version]) => {
-            const runtimeApiSpec = findRuntimeApiSpec(runtimeApiHash, version);
-            if (!runtimeApiSpec)
-                return;
-            return {
-                ...runtimeApiSpec,
-                runtimeApiHash,
-            };
-        });
-        return specs.reduce((o, spec) => {
-            if (!spec) {
-                return o;
-            }
-            return [...o, spec];
-        }, []);
-    }
-}

package/generator/TxGen.d.ts

@@ -1,5 +0,0 @@
-import { ApiGen } from '../generator';
-export declare class TxGen extends ApiGen {
-    #private;
-    generate(): Promise<string>;
-}

package/generator/index.d.ts

@@ -1,10 +0,0 @@
-export * from './TypesGen';
-export * from './ApiGen';
-export * from './ConstsGen';
-export * from './QueryGen';
-export * from './RpcGen';
-export * from './IndexGen';
-export * from './ErrorsGen';
-export * from './EventsGen';
-export * from './TxGen';
-export * from './RuntimeApisGen';

package/generator/index.js

@@ -1,10 +0,0 @@
-export * from './TypesGen';
-export * from './ApiGen';
-export * from './ConstsGen';
-export * from './QueryGen';
-export * from './RpcGen';
-export * from './IndexGen';
-export * from './ErrorsGen';
-export * from './EventsGen';
-export * from './TxGen';
-export * from './RuntimeApisGen';

package/packageInfo.d.ts

@@ -1,4 +0,0 @@
-export declare const packageInfo: {
-    name: string;
-    version: string;
-};

package/packageInfo.js

@@ -1,2 +0,0 @@
-// THIS FILE IS AUTO-GENERATED, DO NOT EDIT!
-export const packageInfo = { name: '@dedot/codegen', version: '0.0.1-alpha.25' };

package/templates/consts.hbs

@@ -1,7 +0,0 @@
-// Generated by @dedot/codegen
-
-{{{ importTypes }}}
-
-export interface ChainConsts extends GenericChainConsts {
-  {{{ defTypeOut }}}
-}

package/templates/errors.hbs

@@ -1,7 +0,0 @@
-// Generated by @dedot/codegen
-
-{{{ importTypes }}}
-
-export interface ChainErrors extends GenericChainErrors {
-  {{{ defTypeOut }}}
-}

package/templates/events.hbs

@@ -1,7 +0,0 @@
-// Generated by @dedot/codegen
-
-{{{ importTypes }}}
-
-export interface ChainEvents extends GenericChainEvents {
-  {{{ defTypeOut }}}
-}

package/templates/index.hbs

@@ -1,22 +0,0 @@
-// Generated by @dedot/codegen
-
-import { GenericSubstrateApi } from '@dedot/types';
-import { ChainConsts } from './consts';
-import { ChainStorage } from './query';
-import { RpcCalls } from './rpc';
-import { ChainErrors } from './errors';
-import { ChainEvents } from './events';
-import { RuntimeApis } from './runtime';
-import { ChainTx } from './tx';
-
-export * from './types';
-
-export interface {{{interfaceName}}}Api extends GenericSubstrateApi {
-  rpc: RpcCalls;
-  consts: ChainConsts;
-  query: ChainStorage;
-  errors: ChainErrors;
-  events: ChainEvents;
-  call: RuntimeApis;
-  tx: ChainTx;
-}

package/templates/query.hbs

@@ -1,7 +0,0 @@
-// Generated by @dedot/codegen
-
-{{{ importTypes }}}
-
-export interface ChainStorage extends GenericChainStorage {
-  {{{ defTypeOut }}}
-}

package/templates/rpc.hbs

@@ -1,7 +0,0 @@
-// Generated by @dedot/codegen
-
-{{{ importTypes }}}
-
-export interface RpcCalls extends GenericRpcCalls {
-  {{{rpcCallsOut}}}
-}

package/templates/runtime.hbs

@@ -1,8 +0,0 @@
-// Generated by @dedot/codegen
-
-{{{ importTypes }}}
-
-export interface RuntimeApis extends GenericRuntimeApis {
-{{{ runtimeCallsOut }}}
-}
-

package/templates/tx.hbs

@@ -1,9 +0,0 @@
-// Generated by @dedot/codegen
-
-{{{ importTypes }}}
-
-{{{ defTypes }}}
-
-export interface ChainTx extends GenericChainTx<TxCall> {
-  {{{ txDefsOut }}}
-}

package/types.d.ts

@@ -1,6 +0,0 @@
-export type NetworkInfo = {
-    chain: string;
-    endpoint?: string;
-    metadataHex?: string;
-    rpcMethods?: string[];
-};

package/types.js

@@ -1 +0,0 @@
-export {};